# koala73/worldmonitor architecture

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

- Interactive diagram: https://gitdiagram.com/koala73/worldmonitor
- Repository: https://github.com/koala73/worldmonitor

## Overview

World Monitor is a real-time global intelligence dashboard, with API and agent-facing interfaces as additional ways to access its data. The main user workflow is to explore news and geopolitical, economic, and infrastructure signals, then interpret their convergence in the dashboard and map. The README documents major capabilities including multilingual feeds, variant-specific panels, finance radar, local AI, and cross-stream correlation; the tree also shows broad domain RPC and MCP surfaces. Source excerpts are selective, so links between unsampled dashboard subsystems and data providers are intentionally omitted.

Main entry points: [`src`](https://github.com/koala73/worldmonitor/tree/main/src) (Situational dashboard), [`server/worldmonitor/supply-chain/v1/list-pipelines.ts`](https://github.com/koala73/worldmonitor/blob/main/server/worldmonitor/supply-chain/v1/list-pipelines.ts) (Pipeline listing), [`src/components/PipelineStatusPanel.ts`](https://github.com/koala73/worldmonitor/blob/main/src/components/PipelineStatusPanel.ts) (Pipeline status panel), [`src/components/search-engine.ts`](https://github.com/koala73/worldmonitor/blob/main/src/components/search-engine.ts) (Command search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dashboard["Dashboard experience"]
  node_dashboard["Situational dashboard"]
  node_feeds["News and feeds"]
  node_maps["Globe and flat maps"]
  node_panels["Variant panels"]
  node_search["Command search<br/>[search-engine.ts]"]
  node_finance["Finance radar"]
  node_localai["Local AI"]
  node_pipeline_panel["Pipeline status panel"]
end

subgraph group_intelligence["Intelligence processing"]
  node_correlation["Signal convergence<br/>[engine.ts]"]
  node_pipeline_registry["Pipeline registry<br/>[pipelines-data.ts]"]
  node_pipeline_badge["Evidence badge derivation"]
end

subgraph group_interfaces["Data interfaces"]
  node_rpc["Domain RPC endpoints<br/>[&#91;rpc&#93;.ts]"]
  node_mcp["MCP interface<br/>[mcp.ts]"]
  node_mcp_handler["MCP request handler<br/>[handler.ts]"]
  node_mcp_registry["MCP tool registry<br/>[index.ts]"]
  node_pipeline_endpoint["Pipeline listing<br/>[list-pipelines.ts]"]
end

subgraph group_state["User and runtime state"]
  node_local_state[("Browser preferences<br/>[safe-storage.ts]")]
  node_history_state[("Dashboard history<br/>[storage.ts]")]
  node_redis[("Redis cache")]
end

node_browser(("Dashboard user"))
node_agent(("Agent or script"))

node_browser -->|"explores"| node_dashboard
node_dashboard -->|"renders feeds"| node_feeds
node_dashboard -->|"renders maps"| node_maps
node_dashboard -->|"renders panels"| node_panels
node_dashboard -->|"shows radar"| node_finance
node_dashboard -.->|"uses local AI"| node_localai
node_dashboard -->|"queries"| node_search
node_correlation -->|"provides convergence"| node_dashboard
node_search -.->|"reads settings"| node_local_state
node_dashboard -->|"stores snapshots"| node_history_state
node_agent -->|"requests tools"| node_mcp
node_mcp -->|"dispatches request"| node_mcp_handler
node_mcp_handler -->|"dispatches tools"| node_mcp_registry
node_agent -->|"requests domain data"| node_rpc
node_pipeline_panel -->|"fetches registry"| node_pipeline_endpoint
node_pipeline_endpoint -->|"reads registries"| node_redis
node_pipeline_endpoint -->|"derives badges"| node_pipeline_badge
node_pipeline_panel -->|"uses bootstrap data"| node_pipeline_registry

click node_dashboard "https://github.com/koala73/worldmonitor/tree/main/src"
click node_feeds "https://github.com/koala73/worldmonitor/tree/main/src"
click node_maps "https://github.com/koala73/worldmonitor/tree/main/src"
click node_panels "https://github.com/koala73/worldmonitor/tree/main/src/components"
click node_search "https://github.com/koala73/worldmonitor/blob/main/src/components/search-engine.ts"
click node_finance "https://github.com/koala73/worldmonitor/tree/main/src"
click node_localai "https://github.com/koala73/worldmonitor/tree/main/src"
click node_correlation "https://github.com/koala73/worldmonitor/blob/main/src/services/correlation-engine/engine.ts"
click node_pipeline_registry "https://github.com/koala73/worldmonitor/blob/main/shared/pipelines-data.ts"
click node_pipeline_badge "https://github.com/koala73/worldmonitor/blob/main/src/shared/pipeline-evidence.ts"
click node_rpc "https://github.com/koala73/worldmonitor/blob/main/api/intelligence/v1/%5Brpc%5D.ts"
click node_mcp "https://github.com/koala73/worldmonitor/blob/main/api/mcp.ts"
click node_mcp_handler "https://github.com/koala73/worldmonitor/blob/main/api/mcp/handler.ts"
click node_mcp_registry "https://github.com/koala73/worldmonitor/blob/main/api/mcp/registry/index.ts"
click node_pipeline_endpoint "https://github.com/koala73/worldmonitor/blob/main/server/worldmonitor/supply-chain/v1/list-pipelines.ts"
click node_pipeline_panel "https://github.com/koala73/worldmonitor/blob/main/src/components/PipelineStatusPanel.ts"
click node_local_state "https://github.com/koala73/worldmonitor/blob/main/src/utils/safe-storage.ts"
click node_history_state "https://github.com/koala73/worldmonitor/blob/main/src/services/storage.ts"

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_dashboard,node_feeds,node_maps,node_panels,node_search,node_finance,node_localai,node_pipeline_panel,node_browser toneBlue
class node_correlation,node_pipeline_registry,node_pipeline_badge toneAmber
class node_rpc,node_mcp,node_mcp_handler,node_mcp_registry,node_pipeline_endpoint toneMint
class node_local_state,node_history_state,node_redis toneRose
class node_agent toneIndigo
```

## Components

### Dashboard experience

- [Situational dashboard](https://github.com/koala73/worldmonitor/tree/main/src): `src`
- [News and feeds](https://github.com/koala73/worldmonitor/tree/main/src): `src`
- [Globe and flat maps](https://github.com/koala73/worldmonitor/tree/main/src): `src`
- [Variant panels](https://github.com/koala73/worldmonitor/tree/main/src/components): `src/components`
- [Command search](https://github.com/koala73/worldmonitor/blob/main/src/components/search-engine.ts): `src/components/search-engine.ts`
- [Finance radar](https://github.com/koala73/worldmonitor/tree/main/src): `src`
- [Local AI](https://github.com/koala73/worldmonitor/tree/main/src): `src`
- [Pipeline status panel](https://github.com/koala73/worldmonitor/blob/main/src/components/PipelineStatusPanel.ts): `src/components/PipelineStatusPanel.ts`

### Intelligence processing

- [Signal convergence](https://github.com/koala73/worldmonitor/blob/main/src/services/correlation-engine/engine.ts): `src/services/correlation-engine/engine.ts`
- [Pipeline registry](https://github.com/koala73/worldmonitor/blob/main/shared/pipelines-data.ts): `shared/pipelines-data.ts`
- [Evidence badge derivation](https://github.com/koala73/worldmonitor/blob/main/src/shared/pipeline-evidence.ts): `src/shared/pipeline-evidence.ts`

### Data interfaces

- [Domain RPC endpoints](https://github.com/koala73/worldmonitor/blob/main/api/intelligence/v1/%5Brpc%5D.ts): `api/intelligence/v1/[rpc].ts`
- [MCP interface](https://github.com/koala73/worldmonitor/blob/main/api/mcp.ts): `api/mcp.ts`
- [MCP request handler](https://github.com/koala73/worldmonitor/blob/main/api/mcp/handler.ts): `api/mcp/handler.ts`
- [MCP tool registry](https://github.com/koala73/worldmonitor/blob/main/api/mcp/registry/index.ts): `api/mcp/registry/index.ts`
- [Pipeline listing](https://github.com/koala73/worldmonitor/blob/main/server/worldmonitor/supply-chain/v1/list-pipelines.ts): `server/worldmonitor/supply-chain/v1/list-pipelines.ts`

### User and runtime state

- [Browser preferences](https://github.com/koala73/worldmonitor/blob/main/src/utils/safe-storage.ts): `src/utils/safe-storage.ts`
- [Dashboard history](https://github.com/koala73/worldmonitor/blob/main/src/services/storage.ts): `src/services/storage.ts`
- **Redis cache**

### Other components

- **Dashboard user**
- **Agent or script**

## Connections

- Dashboard user → Situational dashboard: explores
- Situational dashboard → News and feeds: renders feeds
- Situational dashboard → Globe and flat maps: renders maps
- Situational dashboard → Variant panels: renders panels
- Situational dashboard → Finance radar: shows radar
- Situational dashboard → Local AI: uses local AI
- Situational dashboard → Command search: queries
- Signal convergence → Situational dashboard: provides convergence
- Command search → Browser preferences: reads settings
- Situational dashboard → Dashboard history: stores snapshots
- Agent or script → MCP interface: requests tools
- MCP interface → MCP request handler: dispatches request
- MCP request handler → MCP tool registry: dispatches tools
- Agent or script → Domain RPC endpoints: requests domain data
- Pipeline status panel → Pipeline listing: fetches registry
- Pipeline listing → Redis cache: reads registries
- Pipeline listing → Evidence badge derivation: derives badges
- Pipeline status panel → Pipeline registry: uses bootstrap data
