ExposureExplainer

gov.exposure_explainer

Governance & Ops planned Spec ready frozen

Produces a plain-English narrative of current portfolio exposure: which markets, which outcomes, how much pUSD is at risk, why each position was opene

What it does

Produces a plain-English narrative of current portfolio exposure: which markets, which outcomes, how much pUSD is at risk, why each position was opened (linked back to the originating strategy and OrderIntent). Read by the Admin UI, the daily ops digest, and any incident review.

Pipeline placement

runs after: exec.order_lifecycle_manager → ExposureExplainer → runs before: —

Applies to: Continuous

Why it matters

If this fails	Consequence
Opaque positions	A page of raw outcome IDs and notionals does not tell anyone whether the portfolio is balanced, concentrated, or running through resolution.
Audit trail	When something goes wrong, the first question is always 'why was that position open?' — without ExposureExplainer, the answer requires correlating five logs by hand.
Daily review fatigue	A narrative rendering compresses 200 line items into the 5 things a reviewer actually needs to read.

Inputs

Polymarket inputs

Input	Source	Required	Use
Resolved outcome positions	On-chain CTFExchangeV2 + PortfolioGuard	required	Quantities by token.
Market metadata	Polymarket REST	required	Friendly market names and outcome labels.

Internal inputs

Input	Source	Required	Use
Trade history	exec.order_lifecycle_manager	required	Originating intent_id and strategy_id per fill.
Strategy registry	Config	required	Maps strategy_id to friendly description.

Authority

What this bot is permitted to do

Explain

State

Readiness

Spec ready

Status

planned

Class

Governance Service

Default mode

shadow

Developer owner

Governance pod

Capital impact

Indirect

Reason codes emitted

Code	Severity	Meaning	Action
GOV_EXPOSURE_NARRATIVE	P3	Gov Exposure Narrative	See decision output and developer log for context.
GOV_EXPOSURE_CONCENTRATION_FLAG	P3	Gov Exposure Concentration Flag	See decision output and developer log for context.
GOV_EXPOSURE_FALLBACK	P3	Gov Exposure Fallback	See decision output and developer log for context.

Related bots in Governance & Ops

gov.api_degradation_monitor gov.attributionrevenuereporter gov.backtester

Used by

Reverse index — strategies that currently reference gov.exposure_explainer. If you change this bot's authority or reason codes, these strategies must re-pass shadow.

Strategy	State	Activity
BTC weekly — close-aware quotes	demo-wired	last triggered 28m ago
Fed Rates — surprise drift	frozen	last triggered 35m ago

Showing 2 of 2 · demo-wired ≠ production-live

Why this matters

Governance & Ops bots does NOT propose, approve, or block trades; only observes and reports. Understanding the authority boundary prevents misuse and makes promotion-gate reviews faster and more reliable. View raw spec JSON →

Polytraders Operator UX Mock · INTERNAL · demo-wired ≠ production-live · the plan · reason codes · shadow-mode pipeline