| --- |
| title: "Regional Intelligence" |
| description: "Per-region snapshot of regime, balance, actors, scenarios, transmission paths, and watchlist — backed by the Intelligence service's RegionalSnapshot." |
| --- |
|
|
| The **Regional Intelligence** panel (internal id `regional-intelligence`) renders a full regional-level intelligence board: regime, balance, key actors, scenarios, transmission paths, and an active watchlist. It answers "what does the current picture look like in this region?" in a format designed for analysts reading six structured blocks, not scrolling narrative. |
|
|
| ## What the panel shows |
|
|
| A region selector at the top and six structured blocks below, plus optional narrative sections: |
|
|
| ### Region selector |
|
|
| Choose one of seven canonical regions: |
|
|
| - Middle East & North Africa (`mena`, default) |
| - East Asia & Pacific (`east-asia`) |
| - Europe & Central Asia (`europe`) |
| - North America (`north-america`) |
| - South Asia (`south-asia`) |
| - Latin America & Caribbean (`latam`) |
| - Sub-Saharan Africa (`sub-saharan-africa`) |
|
|
| (Source: `BOARD_REGIONS` in `src/components/regional-intelligence-board-utils.ts:23`. Default is `DEFAULT_REGION_ID = 'mena'`.) |
|
|
| ### Six blocks |
|
|
| 1. **Regime** — current label, previous label, the driver behind the last transition. |
| 2. **Balance** — 7-axis balance-of-power bar chart with a net balance indicator. |
| 3. **Actors** — top 5 actors ranked by leverage score, with movement deltas. |
| 4. **Scenarios** — 3 horizons (24h / 7d / 30d) × 4 lanes with probability bars. |
| 5. **Transmission** — top 5 transmission paths that connect regional signals to downstream outcomes. |
| 6. **Watchlist** — active triggers plus narrative watch items from the seed's LLM layer. |
|
|
| ### Weekly Brief |
|
|
| After the six core blocks render, the panel can append a **Weekly Brief** block |
| with a situation recap, regime trajectory, up to five key developments, and a |
| risk outlook. It is generated by `scripts/seed-regional-briefs.mjs`, which is |
| designed for a weekly Railway cadence rather than the 6-hour regional snapshot |
| bundle. The prompt stance is neutral and analytical: it forbids dramatization, |
| policy prescriptions, and speculation beyond the snapshot/regime-history data. |
|
|
| ### Narrative sections |
|
|
| Optional inline blocks render above the six when the seed populates them: `situation`, `balance_assessment`, and per-horizon `outlook` (24h / 7d / 30d). Empty narrative fields are hidden rather than shown as placeholders. |
|
|
| Region changes trigger one immediate snapshot RPC (`get-regional-snapshot`). |
| After that snapshot paints, the panel starts two enrichment RPCs in parallel: |
| `get-regime-history` and `get-regional-brief`. A request-sequence arbitrator |
| guards against stale renders when the user rapidly switches regions. |
|
|
| Panel id is `regional-intelligence`; canonical component is `src/components/RegionalIntelligenceBoard.ts`. Title per `src/config/panels.ts:110`. |
|
|
| ## How you reach it |
|
|
| - **Cmd+K**: type *regional* or *intelligence board*. |
| - **Availability by variant**: registered in the **full/geopolitical** variant only, and **disabled by default** (`enabled: false, premium: 'locked'` at `src/config/panels.ts:110`). PRO users must opt into it. Not present in the tech, finance, commodity, or happy variants. |
|
|
| ## Data sources |
|
|
| - `GET /api/intelligence/v1/get-regional-snapshot` via the generated `IntelligenceServiceClient`. |
| - `GET /api/intelligence/v1/get-regime-history` for the recent transition block. |
| - `GET /api/intelligence/v1/get-regional-brief` for the Weekly Brief block. |
| - Gateway caching handles the per-region cache; the panel issues one snapshot call per region change, then the two enrichment calls after the first render. |
|
|
| For shared news/brief filtering, LLM grounding, and bias controls, see |
| [News Digest and Briefing Methodology](/methodology/news-digest-and-briefing). |
|
|
| ## Refresh cadence |
|
|
| The panel itself does not poll — it fetches on mount and on region change. The underlying seed refreshes regional snapshots on the intelligence cron. |
| The Weekly Brief is separate from snapshot refresh and is intended to be seeded |
| weekly on Railway. |
|
|
| ## Tier & gating |
|
|
| **PRO (hard-locked) and opt-in.** `enabled: false, premium: 'locked'` in `src/config/panels.ts:110`. `isPanelEntitled` unlocks it when **either** a valid `WORLDMONITOR_API_KEY` is present **or** `isPro` is true (`regional-intelligence` is in the `apiKeyPanels` allowlist at `src/config/panels.ts:973`). |
|
|
| ## API reference |
|
|
| - [Intelligence service](/api/IntelligenceService.openapi.yaml) — `GetRegionalSnapshot` and related RPCs. |
| - [News Digest and Briefing Methodology](/methodology/news-digest-and-briefing) — methodology for the adjacent digest/brief surfaces. |
|
|
