# auxin-io/muslim_policy_operating_system architecture

> Architecture diagram of the GitHub repository auxin-io/muslim_policy_operating_system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/auxin-io/muslim_policy_operating_system
- Repository: https://github.com/auxin-io/muslim_policy_operating_system

## Overview

MPOS here is a Chrome extension for proactive policy-page analysis. Its main workflow is page-load or tab-activation scanning, local eligibility filtering, Gemini analysis, cached results and alerts, then popup presentation with state scope and source verification. The popup also supports forced rescans and manual text/URL analysis; settings control Gemini and notifications. The README documents these capabilities, while excerpts only show selected implementation paths, so unsampled feature links are omitted unless documented.

Main entry points: [`background.js`](https://github.com/auxin-io/muslim_policy_operating_system/blob/main/background.js) (Scan coordinator), [`popup/popup.js`](https://github.com/auxin-io/muslim_policy_operating_system/blob/main/popup/popup.js) (Popup interface), [`options/options.js`](https://github.com/auxin-io/muslim_policy_operating_system/blob/main/options/options.js) (Settings page), [`data/usa-map-data.js`](https://github.com/auxin-io/muslim_policy_operating_system/blob/main/data/usa-map-data.js) (US state map geometry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_scan["Page Monitoring"]
  node_background["Scan coordinator<br/>[background.js]"]
  node_filter["Page eligibility filter<br/>[background.js]"]
  node_extract["Page text extraction<br/>[background.js]"]
  node_cache[("Result cache<br/>[background.js]")]
  node_alerts["Badge and notifications<br/>[background.js]"]
end

subgraph group_analysis["Policy Analysis"]
  node_gemini["Gemini API"]
  node_analysisresult["Bill impact analysis<br/>[background.js]"]
end

subgraph group_interface["Extension Interface"]
  node_popup["Popup interface<br/>[popup.js]"]
  node_mapdata["US state map geometry<br/>[usa-map-data.js]"]
  node_highlight["Source passage highlight<br/>[background.js]"]
end

subgraph group_settings["Local Settings"]
  node_settingsui["Settings page<br/>[options.js]"]
  node_localstorage[("Chrome local storage")]
end

node_user(("Extension user"))
node_browser["Chrome tabs"]

node_browser -->|"triggers scans"| node_background
node_background -->|"checks eligibility"| node_filter
node_background -->|"extracts text"| node_extract
node_background -->|"reads and writes"| node_cache
node_background -->|"analyzes text"| node_analysisresult
node_analysisresult -->|"requests analysis"| node_gemini
node_background -->|"updates alerts"| node_alerts
node_background -->|"serves analysis"| node_popup
node_user -->|"opens popup"| node_popup
node_popup -->|"requests scans"| node_background
node_popup -->|"renders map"| node_mapdata
node_popup -->|"requests highlight"| node_highlight
node_popup -->|"submits manual analysis"| node_background
node_settingsui -->|"saves preferences"| node_localstorage
node_background -->|"loads configuration"| node_localstorage

click node_background "https://github.com/auxin-io/muslim_policy_operating_system/blob/main/background.js"
click node_filter "https://github.com/auxin-io/muslim_policy_operating_system/blob/main/background.js"
click node_extract "https://github.com/auxin-io/muslim_policy_operating_system/blob/main/background.js"
click node_cache "https://github.com/auxin-io/muslim_policy_operating_system/blob/main/background.js"
click node_alerts "https://github.com/auxin-io/muslim_policy_operating_system/blob/main/background.js"
click node_analysisresult "https://github.com/auxin-io/muslim_policy_operating_system/blob/main/background.js"
click node_popup "https://github.com/auxin-io/muslim_policy_operating_system/blob/main/popup/popup.js"
click node_mapdata "https://github.com/auxin-io/muslim_policy_operating_system/blob/main/data/usa-map-data.js"
click node_highlight "https://github.com/auxin-io/muslim_policy_operating_system/blob/main/background.js"
click node_settingsui "https://github.com/auxin-io/muslim_policy_operating_system/blob/main/options/options.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_background,node_filter,node_extract,node_cache,node_alerts,node_user toneBlue
class node_gemini,node_analysisresult toneAmber
class node_popup,node_mapdata,node_highlight toneMint
class node_settingsui,node_localstorage toneRose
class node_browser toneIndigo
```

## Components

### Page Monitoring

- [Scan coordinator](https://github.com/auxin-io/muslim_policy_operating_system/blob/main/background.js): `background.js`
- [Page eligibility filter](https://github.com/auxin-io/muslim_policy_operating_system/blob/main/background.js): `background.js`
- [Page text extraction](https://github.com/auxin-io/muslim_policy_operating_system/blob/main/background.js): `background.js`
- [Result cache](https://github.com/auxin-io/muslim_policy_operating_system/blob/main/background.js): `background.js`
- [Badge and notifications](https://github.com/auxin-io/muslim_policy_operating_system/blob/main/background.js): `background.js`

### Policy Analysis

- **Gemini API**
- [Bill impact analysis](https://github.com/auxin-io/muslim_policy_operating_system/blob/main/background.js): `background.js`

### Extension Interface

- [Popup interface](https://github.com/auxin-io/muslim_policy_operating_system/blob/main/popup/popup.js): `popup/popup.js`
- [US state map geometry](https://github.com/auxin-io/muslim_policy_operating_system/blob/main/data/usa-map-data.js): `data/usa-map-data.js`
- [Source passage highlight](https://github.com/auxin-io/muslim_policy_operating_system/blob/main/background.js): `background.js`

### Local Settings

- [Settings page](https://github.com/auxin-io/muslim_policy_operating_system/blob/main/options/options.js): `options/options.js`
- **Chrome local storage**

### Other components

- **Extension user**
- **Chrome tabs**

## Connections

- Chrome tabs → Scan coordinator: triggers scans (evidence: `README.md`)
- Scan coordinator → Page eligibility filter: checks eligibility (evidence: `README.md`)
- Scan coordinator → Page text extraction: extracts text (evidence: `background.js`)
- Scan coordinator → Result cache: reads and writes (evidence: `background.js`)
- Scan coordinator → Bill impact analysis: analyzes text (evidence: `background.js`)
- Bill impact analysis → Gemini API: requests analysis (evidence: `background.js`)
- Scan coordinator → Badge and notifications: updates alerts (evidence: `README.md`)
- Scan coordinator → Popup interface: serves analysis (evidence: `popup/popup.js`)
- Extension user → Popup interface: opens popup (evidence: `README.md`)
- Popup interface → Scan coordinator: requests scans (evidence: `popup/popup.js`)
- Popup interface → US state map geometry: renders map (evidence: `popup/popup.js`)
- Popup interface → Source passage highlight: requests highlight (evidence: `popup/popup.js`)
- Popup interface → Scan coordinator: submits manual analysis (evidence: `popup/popup.js`)
- Settings page → Chrome local storage: saves preferences (evidence: `options/options.js`)
- Scan coordinator → Chrome local storage: loads configuration (evidence: `background.js`)
