381b6d3521
Shadow run (ROADMAP M5, phase-1 acceptance form): SHADOW runtime mode records
bids without submitting them, simulates the market answer from the actual
day-ahead clearing price, dispatches to the simulation gateway, runs the D+1
review, and scores every day shadow-vs-human-vs-hindsight (ShadowDayRecord)
with a lineage-completeness audit. KpiReport regenerated after every day per
docs/12 §4 definitions (C1/C2 placeholders as named config).
Kill switches (docs/13 §8): BreakerService with L0 permit revocation, L1
envelope suspension, L2 loss breaker (mark-to-market, reduce-only bids),
L3 channel breaker (bids fall back to the file channel, dispatch BLOCKED),
L4 AI-off (templates run, no Proposal created); abnormal-day protocol on
EXTREME situations; per-level authority (B8 placeholder); auditable drill.
Runtime: shadow-close workflow, shadow schedule entries, live-data ingestion
through the quality gate, human-bid ingestion, breaker/KPI/shadow endpoints
and insight cards, replay CLI (npm run shadow). Ledger, time series and
streak counters are file-backed so a multi-week run survives restarts.
Domain: HumanBidRecord, ShadowDayRecord, KpiReport, BreakerRecord, SHADOW
receipt channel; contracts, fixtures and pydantic models regenerated.
Services: L2 metrics moved from evals so the shadow run and the harness
share one implementation.
Fixes: envelope/permit validity compared ISO timestamps as strings
('…00Z' vs '…00.000Z'); L2 baseline was stale since M4 (skill_versions only,
metrics unchanged) — rewritten from the live service.
Docs: docs/14 shadow-run runbook (timeline, breaker trigger/authority/
recovery, KPI definitions as implemented); README and CLAUDE.md status.
Tests: 21 consecutive shadow days with complete lineage, KPI report, WIDEN
recommendation produced but not acted on; restart durability; drill; L2/L3/L4
and abnormal-day paths; API.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017wrZgPL9LoKaD69BpEQU4v
66 lines
1.5 KiB
Python
66 lines
1.5 KiB
Python
# generated by datamodel-codegen:
|
|
# filename: insight_card.json
|
|
|
|
from __future__ import annotations
|
|
|
|
from enum import StrEnum
|
|
|
|
from pydantic import AwareDatetime, BaseModel, ConfigDict, constr
|
|
|
|
|
|
class Page(StrEnum):
|
|
TRADING_DESK = 'TRADING_DESK'
|
|
RESOURCE_POOL = 'RESOURCE_POOL'
|
|
OPERATIONS_DASHBOARD = 'OPERATIONS_DASHBOARD'
|
|
|
|
|
|
class Ref(BaseModel):
|
|
model_config = ConfigDict(
|
|
extra='forbid',
|
|
)
|
|
tool_call_id: constr(min_length=1)
|
|
path: constr(min_length=1)
|
|
|
|
|
|
class Metric(BaseModel):
|
|
model_config = ConfigDict(
|
|
extra='forbid',
|
|
)
|
|
name: constr(min_length=1)
|
|
value: constr(pattern=r'^-?\d+(\.\d+)?$')
|
|
unit: constr(min_length=1)
|
|
ref: Ref | None
|
|
|
|
|
|
class Kind(StrEnum):
|
|
SITUATION_REPORT = 'SITUATION_REPORT'
|
|
REVIEW_FINDING = 'REVIEW_FINDING'
|
|
DECISION_CASE = 'DECISION_CASE'
|
|
POTENTIAL_ASSESSMENT = 'POTENTIAL_ASSESSMENT'
|
|
KPI_REPORT = 'KPI_REPORT'
|
|
SHADOW_DAY = 'SHADOW_DAY'
|
|
BREAKER = 'BREAKER'
|
|
|
|
|
|
class Source(BaseModel):
|
|
model_config = ConfigDict(
|
|
extra='forbid',
|
|
)
|
|
kind: Kind
|
|
id: constr(min_length=1)
|
|
ref: constr(pattern=r'^[0-9a-f]{64}$') | None
|
|
|
|
|
|
class InsightCard(BaseModel):
|
|
model_config = ConfigDict(
|
|
extra='forbid',
|
|
)
|
|
id: constr(min_length=1)
|
|
page: Page
|
|
market_date: constr(pattern=r'^\d{4}-\d{2}-\d{2}$')
|
|
title: constr(min_length=1)
|
|
headline: constr(min_length=1)
|
|
metrics: list[Metric]
|
|
source: Source
|
|
generated_at: AwareDatetime
|