# carsonkoball/amon-hen architecture

> Architecture diagram of the GitHub repository carsonkoball/amon-hen, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/carsonkoball/amon-hen
- Repository: https://github.com/carsonkoball/amon-hen

## Overview

amon-hen is a collection of web monitors and parsers for investment research, with an optional browser UI. The user-facing flow is a browser request routed to a tool handler, which invokes a source-specific tracker or parser and returns structured results for display. Trackers additionally compare records and archive changes locally. The README documents each tool’s source and purpose; implementation excerpts are incomplete, so links to unsampled tool internals are limited to documented capabilities and SOURCE INDEX references.

Main entry points: [`ui/handlers`](https://github.com/carsonkoball/amon-hen/tree/main/ui/handlers) (Tool Handlers), [`src/amon_hen/common/http.py`](https://github.com/carsonkoball/amon-hen/blob/main/src/amon_hen/common/http.py) (HTTP Helpers), [`src/amon_hen/common/tracker.py`](https://github.com/carsonkoball/amon-hen/blob/main/src/amon_hen/common/tracker.py) (Change Tracker), [`src/amon_hen/tools/adp_tracker/adp_tracker.py`](https://github.com/carsonkoball/amon-hen/blob/main/src/amon_hen/tools/adp_tracker/adp_tracker.py) (ADP Tracker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Browser UI"]
  node_scripts_route["Script Route<br/>[scripts.py]"]
  node_ui_handlers["Tool Handlers"]
end

subgraph group_tools["Research Tools"]
  node_adp["ADP Tracker<br/>[adp_tracker.py]"]
  node_blue["Blue List Tracker"]
  node_pathway["DIU Pathway Tracker"]
  node_solution["DIU Solution Tracker"]
  node_dow["DoW Parser<br/>[dow_parser.py]"]
  node_fcc["FCC ELS Parser<br/>[fcc_els_parser.py]"]
  node_fedramp["FedRAMP Tracker<br/>[fedramp_tracker.py]"]
  node_ftc["FTC ETN Parser<br/>[ftc_etn_parser.py]"]
  node_navy["Navy SBIR/STTR Parser"]
end

subgraph group_shared["Shared Runtime"]
  node_http["HTTP Helpers<br/>[http.py]"]
  node_tracker["Change Tracker<br/>[tracker.py]"]
  node_filesystem["Filesystem Helpers<br/>[filesystem.py]"]
end

subgraph group_state["Local State"]
  node_archive[("Local Archives")]
end

node_researcher(("Researcher"))
node_external_sources["Public Data Sources"]

node_researcher -->|"opens tool page"| node_scripts_route
node_scripts_route -->|"dispatches to"| node_ui_handlers
node_ui_handlers -->|"runs parser"| node_dow
node_ui_handlers -->|"runs parser"| node_navy
node_ui_handlers -.->|"invokes tool"| node_adp
node_ui_handlers -.->|"invokes tool"| node_blue
node_ui_handlers -.->|"invokes tool"| node_pathway
node_ui_handlers -.->|"invokes tool"| node_solution
node_ui_handlers -.->|"invokes tool"| node_fcc
node_ui_handlers -.->|"invokes tool"| node_fedramp
node_ui_handlers -.->|"invokes tool"| node_ftc
node_adp -->|"fetches pages"| node_http
node_adp -->|"tracks records"| node_tracker
node_blue -->|"fetches pages"| node_http
node_blue -->|"tracks records"| node_tracker
node_pathway -->|"fetches pages"| node_http
node_pathway -->|"tracks records"| node_tracker
node_solution -->|"fetches pages"| node_http
node_solution -->|"tracks records"| node_tracker
node_fedramp -->|"fetches pages"| node_http
node_fedramp -->|"tracks records"| node_tracker
node_dow -->|"fetches announcements"| node_http
node_fcc -->|"searches applications"| node_http
node_ftc -->|"searches notices"| node_http
node_navy -->|"fetches listings"| node_http
node_tracker -->|"uses file helpers"| node_filesystem
node_filesystem -->|"creates local state"| node_archive
node_external_sources -->|"provides job listings"| node_adp
node_external_sources -->|"provides UAS lists"| node_blue
node_external_sources -->|"provides pathways"| node_pathway
node_external_sources -->|"provides catalog"| node_solution
node_external_sources -->|"provides announcements"| node_dow
node_external_sources -->|"provides applications"| node_fcc
node_external_sources -->|"provides marketplace"| node_fedramp
node_external_sources -->|"provides notices"| node_ftc
node_external_sources -->|"provides awards"| node_navy

click node_scripts_route "https://github.com/carsonkoball/amon-hen/blob/main/ui/routes/scripts.py"
click node_ui_handlers "https://github.com/carsonkoball/amon-hen/tree/main/ui/handlers"
click node_adp "https://github.com/carsonkoball/amon-hen/blob/main/src/amon_hen/tools/adp_tracker/adp_tracker.py"
click node_blue "https://github.com/carsonkoball/amon-hen/blob/main/src/amon_hen/tools/blue_list_tracker/blue_list_tracker.py"
click node_pathway "https://github.com/carsonkoball/amon-hen/blob/main/src/amon_hen/tools/diu_pathway_tracker/diu_pathway_tracker.py"
click node_solution "https://github.com/carsonkoball/amon-hen/blob/main/src/amon_hen/tools/diu_solution_tracker/diu_solution_tracker.py"
click node_dow "https://github.com/carsonkoball/amon-hen/blob/main/src/amon_hen/tools/dow_parser/dow_parser.py"
click node_fcc "https://github.com/carsonkoball/amon-hen/blob/main/src/amon_hen/tools/fcc_els_parser/fcc_els_parser.py"
click node_fedramp "https://github.com/carsonkoball/amon-hen/blob/main/src/amon_hen/tools/fedramp_tracker/fedramp_tracker.py"
click node_ftc "https://github.com/carsonkoball/amon-hen/blob/main/src/amon_hen/tools/ftc_etn_parser/ftc_etn_parser.py"
click node_navy "https://github.com/carsonkoball/amon-hen/blob/main/src/amon_hen/tools/navy_sbir_sttr_parser/navy_sbir_sttr_parser.py"
click node_http "https://github.com/carsonkoball/amon-hen/blob/main/src/amon_hen/common/http.py"
click node_tracker "https://github.com/carsonkoball/amon-hen/blob/main/src/amon_hen/common/tracker.py"
click node_filesystem "https://github.com/carsonkoball/amon-hen/blob/main/src/amon_hen/common/filesystem.py"

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_scripts_route,node_ui_handlers toneBlue
class node_adp,node_blue,node_pathway,node_solution,node_dow,node_fcc,node_fedramp,node_ftc,node_navy toneAmber
class node_http,node_tracker,node_filesystem toneMint
class node_archive toneRose
class node_researcher,node_external_sources toneIndigo
```

## Components

### Browser UI

- [Script Route](https://github.com/carsonkoball/amon-hen/blob/main/ui/routes/scripts.py): `ui/routes/scripts.py`
- [Tool Handlers](https://github.com/carsonkoball/amon-hen/tree/main/ui/handlers): `ui/handlers`

### Research Tools

- [ADP Tracker](https://github.com/carsonkoball/amon-hen/blob/main/src/amon_hen/tools/adp_tracker/adp_tracker.py): `src/amon_hen/tools/adp_tracker/adp_tracker.py`
- [Blue List Tracker](https://github.com/carsonkoball/amon-hen/blob/main/src/amon_hen/tools/blue_list_tracker/blue_list_tracker.py): `src/amon_hen/tools/blue_list_tracker/blue_list_tracker.py`
- [DIU Pathway Tracker](https://github.com/carsonkoball/amon-hen/blob/main/src/amon_hen/tools/diu_pathway_tracker/diu_pathway_tracker.py): `src/amon_hen/tools/diu_pathway_tracker/diu_pathway_tracker.py`
- [DIU Solution Tracker](https://github.com/carsonkoball/amon-hen/blob/main/src/amon_hen/tools/diu_solution_tracker/diu_solution_tracker.py): `src/amon_hen/tools/diu_solution_tracker/diu_solution_tracker.py`
- [DoW Parser](https://github.com/carsonkoball/amon-hen/blob/main/src/amon_hen/tools/dow_parser/dow_parser.py): `src/amon_hen/tools/dow_parser/dow_parser.py`
- [FCC ELS Parser](https://github.com/carsonkoball/amon-hen/blob/main/src/amon_hen/tools/fcc_els_parser/fcc_els_parser.py): `src/amon_hen/tools/fcc_els_parser/fcc_els_parser.py`
- [FedRAMP Tracker](https://github.com/carsonkoball/amon-hen/blob/main/src/amon_hen/tools/fedramp_tracker/fedramp_tracker.py): `src/amon_hen/tools/fedramp_tracker/fedramp_tracker.py`
- [FTC ETN Parser](https://github.com/carsonkoball/amon-hen/blob/main/src/amon_hen/tools/ftc_etn_parser/ftc_etn_parser.py): `src/amon_hen/tools/ftc_etn_parser/ftc_etn_parser.py`
- [Navy SBIR/STTR Parser](https://github.com/carsonkoball/amon-hen/blob/main/src/amon_hen/tools/navy_sbir_sttr_parser/navy_sbir_sttr_parser.py): `src/amon_hen/tools/navy_sbir_sttr_parser/navy_sbir_sttr_parser.py`

### Shared Runtime

- [HTTP Helpers](https://github.com/carsonkoball/amon-hen/blob/main/src/amon_hen/common/http.py): `src/amon_hen/common/http.py`
- [Change Tracker](https://github.com/carsonkoball/amon-hen/blob/main/src/amon_hen/common/tracker.py): `src/amon_hen/common/tracker.py`
- [Filesystem Helpers](https://github.com/carsonkoball/amon-hen/blob/main/src/amon_hen/common/filesystem.py): `src/amon_hen/common/filesystem.py`

### Local State

- **Local Archives**

### Other components

- **Researcher**
- **Public Data Sources**

## Connections

- Researcher → Script Route: opens tool page (evidence: `ui/routes/scripts.py`)
- Script Route → Tool Handlers: dispatches to (evidence: `ui/routes/scripts.py`)
- Tool Handlers → DoW Parser: runs parser (evidence: `ui/handlers/dow_parser.py`)
- Tool Handlers → Navy SBIR/STTR Parser: runs parser (evidence: `ui/handlers/navy_sbir_sttr_parser.py`)
- Tool Handlers → ADP Tracker: invokes tool
- Tool Handlers → Blue List Tracker: invokes tool
- Tool Handlers → DIU Pathway Tracker: invokes tool
- Tool Handlers → DIU Solution Tracker: invokes tool
- Tool Handlers → FCC ELS Parser: invokes tool
- Tool Handlers → FedRAMP Tracker: invokes tool
- Tool Handlers → FTC ETN Parser: invokes tool
- ADP Tracker → HTTP Helpers: fetches pages (evidence: `src/amon_hen/tools/adp_tracker/adp_tracker.py`)
- ADP Tracker → Change Tracker: tracks records (evidence: `src/amon_hen/tools/adp_tracker/adp_tracker.py`)
- Blue List Tracker → HTTP Helpers: fetches pages (evidence: `src/amon_hen/tools/blue_list_tracker/blue_list_tracker.py`)
- Blue List Tracker → Change Tracker: tracks records (evidence: `src/amon_hen/tools/blue_list_tracker/blue_list_tracker.py`)
- DIU Pathway Tracker → HTTP Helpers: fetches pages (evidence: `src/amon_hen/tools/diu_pathway_tracker/diu_pathway_tracker.py`)
- DIU Pathway Tracker → Change Tracker: tracks records (evidence: `src/amon_hen/tools/diu_pathway_tracker/diu_pathway_tracker.py`)
- DIU Solution Tracker → HTTP Helpers: fetches pages (evidence: `src/amon_hen/tools/diu_solution_tracker/diu_solution_tracker.py`)
- DIU Solution Tracker → Change Tracker: tracks records (evidence: `src/amon_hen/tools/diu_solution_tracker/diu_solution_tracker.py`)
- FedRAMP Tracker → HTTP Helpers: fetches pages (evidence: `src/amon_hen/tools/fedramp_tracker/fedramp_tracker.py`)
- FedRAMP Tracker → Change Tracker: tracks records (evidence: `src/amon_hen/tools/fedramp_tracker/fedramp_tracker.py`)
- DoW Parser → HTTP Helpers: fetches announcements (evidence: `src/amon_hen/tools/dow_parser/dow_parser.py`)
- FCC ELS Parser → HTTP Helpers: searches applications (evidence: `src/amon_hen/tools/fcc_els_parser/fcc_els_parser.py`)
- FTC ETN Parser → HTTP Helpers: searches notices (evidence: `src/amon_hen/tools/ftc_etn_parser/ftc_etn_parser.py`)
- Navy SBIR/STTR Parser → HTTP Helpers: fetches listings (evidence: `src/amon_hen/tools/navy_sbir_sttr_parser/navy_sbir_sttr_parser.py`)
- Change Tracker → Filesystem Helpers: uses file helpers (evidence: `src/amon_hen/common/tracker.py`)
- Filesystem Helpers → Local Archives: creates local state (evidence: `README.md`)
- Public Data Sources → ADP Tracker: provides job listings (evidence: `README.md`)
- Public Data Sources → Blue List Tracker: provides UAS lists (evidence: `README.md`)
- Public Data Sources → DIU Pathway Tracker: provides pathways (evidence: `README.md`)
- Public Data Sources → DIU Solution Tracker: provides catalog (evidence: `README.md`)
- Public Data Sources → DoW Parser: provides announcements (evidence: `README.md`)
- Public Data Sources → FCC ELS Parser: provides applications (evidence: `README.md`)
- Public Data Sources → FedRAMP Tracker: provides marketplace (evidence: `README.md`)
- Public Data Sources → FTC ETN Parser: provides notices (evidence: `README.md`)
- Public Data Sources → Navy SBIR/STTR Parser: provides awards (evidence: `README.md`)
