23fdf49ff2
- packages/domain: AwardNotice, DISPATCH_PLAN proposal payload, ExecutionReport, MeteringRecord, potential-assessment and dispatch-optimization contracts, ReviewFinding (+ typed writebacks), SemanticMemoryEntry, EnvelopeChangeRequest, InsightCard — exported with fixtures on both sides. - skills-py: potential-assessment (certified × rolling fulfilment, evidence days) and dispatch-optimization (per-interval LP on HiGHS, shortfall reported) skills + routes + tests. - packages/services: dispatch rules in the policy pack (over-allocation, award anchor, lineage integrity for allocations); PowerBalanceSimulator; SimulationGateway (permit-only, idempotent, seeded execute → ExecutionReports); envelope deviation-streak suspension + apply(); ReviewService (attribution, reliability EWMA writeback, semantic memory, envelope recommendations as change requests); dispatch assembler; skill client methods. - packages/runtime: resource agent; award-decomposition, review and envelope-review workflows; lifecycle selects simulator/gateway by proposal type; trigger hooks for awards, execution reports, metering; decide() resumes either lifecycle or envelope-review runs; insight cards API. - Tests: docs/07 D-1 16:00 and D+1 end to end; reliability score 0.9 → 0.880 and the next assessment de-rates capacity; envelope suspension on a seeded 3-day streak; WIDEN request applied only by a human. 184 TS + 80 Python. - docs/open-questions: B10 (reliability/potential parameters). README and CLAUDE.md status → M4 done, M5 next. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01UoYoGYzHkFyv3ALenkRPhA
657 lines
20 KiB
TypeScript
657 lines
20 KiB
TypeScript
/**
|
||
* Generates golden fixtures into contracts/fixtures/<name>/*.json and invalid
|
||
* fixtures into contracts/fixtures-invalid/<name>/*.json. Run once and commit;
|
||
* fixtures are reviewed via diff. Invalid cases are crafted to fail on BOTH the
|
||
* zod and pydantic sides (dual-side contract test, docs/11 §3.2).
|
||
*/
|
||
import { mkdirSync, writeFileSync } from 'node:fs'
|
||
import { fileURLToPath } from 'node:url'
|
||
import { schemaRegistry } from '../src/index.js'
|
||
|
||
const root = fileURLToPath(new URL('../../../contracts/', import.meta.url))
|
||
|
||
const REF_A = 'a'.repeat(64)
|
||
const REF_B = 'b'.repeat(64)
|
||
const REF_C = 'c'.repeat(64)
|
||
const DATE = '2026-03-15'
|
||
const T0 = '2026-03-14T06:00:00Z'
|
||
const T1 = '2026-03-14T08:30:00Z'
|
||
const T2 = '2026-03-15T23:59:59Z'
|
||
|
||
const curve = (v: string, date = DATE) => ({
|
||
interval_minutes: 15,
|
||
date,
|
||
values: Array.from({ length: 96 }, () => v),
|
||
})
|
||
|
||
const valid: Record<string, Record<string, unknown>> = {
|
||
proposal: {
|
||
'bid-basic': {
|
||
id: 'prop-001',
|
||
type: 'BID',
|
||
timescale: 'DAY_AHEAD',
|
||
originator: { agent: 'trading-agent', trigger: 'SCHEDULED', task_id: 'task-001' },
|
||
payload: {
|
||
kind: 'BID',
|
||
market_date: DATE,
|
||
prices_yuan_per_mwh: curve('425.50'),
|
||
quantities_mwh: curve('12.5'),
|
||
expected_revenue_yuan: '510600.00',
|
||
},
|
||
lineage: {
|
||
tool_calls: [
|
||
{
|
||
tool_call_id: 'tc-001',
|
||
tool: 'bid-optimization-milp',
|
||
version: '1.0.0',
|
||
inputs_ref: REF_A,
|
||
outputs_ref: REF_B,
|
||
},
|
||
],
|
||
data_refs: [REF_C],
|
||
ledger_version: 42,
|
||
policy_pack_version: '2026.03',
|
||
},
|
||
envelope_ref: 'env-bid-001',
|
||
digest: REF_B,
|
||
status: 'DRAFT',
|
||
created_at: T1,
|
||
},
|
||
'dispatch-plan': {
|
||
id: 'prop-002',
|
||
type: 'DISPATCH_PLAN',
|
||
timescale: 'DAY_AHEAD',
|
||
originator: { agent: 'resource-agent', trigger: 'EVENT', task_id: 'task-002' },
|
||
payload: {
|
||
kind: 'DISPATCH_PLAN',
|
||
market_date: DATE,
|
||
award_ref: 'award-2026-03-15',
|
||
total_target_mw: curve('48.0'),
|
||
allocations: [{ unit_id: 'agg-unit-wuhan-01', target_mw: curve('48.0') }],
|
||
},
|
||
lineage: {
|
||
tool_calls: [
|
||
{ tool_call_id: 'tc-002', tool: 'dispatch-optimization', version: '1.0.0', inputs_ref: REF_A, outputs_ref: REF_C },
|
||
],
|
||
data_refs: [REF_C],
|
||
ledger_version: 43,
|
||
policy_pack_version: '2026.03',
|
||
},
|
||
envelope_ref: null,
|
||
digest: REF_C,
|
||
status: 'DRAFT',
|
||
created_at: T1,
|
||
},
|
||
},
|
||
approval: {
|
||
approve: {
|
||
id: 'appr-001',
|
||
proposal_digest: REF_B,
|
||
decision: 'APPROVE',
|
||
approver: { id: 'user-trader-01', role: 'senior-trader' },
|
||
scope: { effect_type: 'BID', limits: { max_energy_mwh: '1500.0' } },
|
||
validity: { from: T1, to: T2 },
|
||
evidence_versions: {
|
||
policy_pack_version: '2026.03',
|
||
ledger_version: 42,
|
||
data_snapshot_refs: [REF_C],
|
||
},
|
||
comment: 'within monthly position band',
|
||
decided_at: T1,
|
||
},
|
||
},
|
||
execution_permit: {
|
||
active: {
|
||
id: 'permit-001',
|
||
proposal_digest: REF_B,
|
||
issued_at: T1,
|
||
expires_at: T2,
|
||
effect_limits: { max_energy_mwh: '1500.0' },
|
||
revoked_at: null,
|
||
issuer: 'authority-service',
|
||
},
|
||
},
|
||
envelope: {
|
||
'bid-envelope': {
|
||
id: 'env-bid-001',
|
||
scope: { proposal_type: 'BID', timescales: ['DAY_AHEAD'], resource_set: 'pool-hubei-01' },
|
||
bounds: { price_deviation_pct: '5.0', max_energy_mwh: '1500.0' },
|
||
validity: { from: T0, to: T2 },
|
||
approval: { level: 'L2', approved_by: ['user-ops-lead', 'user-risk-officer'] },
|
||
escalation: { max_consecutive_deviations: 3, deviation_threshold_pct: '10.0' },
|
||
status: 'ACTIVE',
|
||
},
|
||
},
|
||
flexibility_envelope: {
|
||
'da-aggregation-unit': {
|
||
id: 'flex-001',
|
||
provider: { unit_id: 'agg-unit-wuhan-01', level: 'AGGREGATION_UNIT' },
|
||
market_date: DATE,
|
||
up_mw: curve('8.5'),
|
||
down_mw: curve('6.0'),
|
||
valid_until: T2,
|
||
schema_version: '1.0.0',
|
||
signature: null,
|
||
},
|
||
},
|
||
position_update: {
|
||
'award-da': {
|
||
id: 'pos-001',
|
||
timescale: 'DAY_AHEAD',
|
||
period: DATE,
|
||
kind: 'AWARD',
|
||
energy_mwh: '1180.0',
|
||
curve: curve('12.3'),
|
||
source_ref: REF_B,
|
||
expected_version: 42,
|
||
},
|
||
},
|
||
ledger_view: {
|
||
basic: {
|
||
version: 43,
|
||
entries: [
|
||
{
|
||
id: 'pos-000',
|
||
timescale: 'MONTHLY',
|
||
period: '2026-03',
|
||
kind: 'CONTRACT',
|
||
energy_mwh: '36000.0',
|
||
curve: null,
|
||
source_ref: 'contract-2026-03-001',
|
||
recorded_at: T0,
|
||
},
|
||
],
|
||
},
|
||
},
|
||
forecast_bundle: {
|
||
'load-da': {
|
||
id: 'fc-001',
|
||
kind: 'LOAD',
|
||
market_date: DATE,
|
||
unit: 'mw',
|
||
quantiles: { p10: curve('40.1'), p50: curve('45.7'), p90: curve('52.3') },
|
||
model: { name: 'load-forecast', version: '1.2.0' },
|
||
features_snapshot_ref: REF_A,
|
||
generated_at: T0,
|
||
},
|
||
},
|
||
forecast_request: {
|
||
'price-da': {
|
||
kind: 'PRICE',
|
||
market_date: DATE,
|
||
unit: 'yuan_per_mwh',
|
||
history: [curve('398.20', '2026-03-13'), curve('410.75', '2026-03-14')],
|
||
exogenous: {},
|
||
features_snapshot_ref: REF_A,
|
||
},
|
||
},
|
||
bid_optimization_request: {
|
||
'da-basic': {
|
||
market_date: DATE,
|
||
price_forecast: {
|
||
id: 'fc-price-001',
|
||
kind: 'PRICE',
|
||
market_date: DATE,
|
||
unit: 'yuan_per_mwh',
|
||
quantiles: { p10: curve('360.00'), p50: curve('425.50'), p90: curve('490.00') },
|
||
model: { name: 'price-forecast', version: '1.0.0' },
|
||
features_snapshot_ref: REF_A,
|
||
generated_at: T0,
|
||
},
|
||
adjustable_capacity_mw: curve('60.0'),
|
||
position_bounds: {
|
||
ledger_version: 42,
|
||
daily_energy_min_mwh: '1140.0',
|
||
daily_energy_max_mwh: '1260.0',
|
||
},
|
||
risk: {
|
||
risk_aversion: '0.3',
|
||
commitment_buffer_k: '0.9',
|
||
min_block_mwh: '1.0',
|
||
marginal_cost_yuan_per_mwh: '0',
|
||
},
|
||
},
|
||
},
|
||
bid_optimization_result: {
|
||
'da-basic': {
|
||
market_date: DATE,
|
||
prices_yuan_per_mwh: curve('0.00'),
|
||
quantities_mwh: curve('12.5'),
|
||
daily_energy_mwh: '1200.0',
|
||
expected_revenue_yuan: '510600.00',
|
||
revenue_distribution_yuan: { p10: '432000.00', p50: '510600.00', p90: '588000.00' },
|
||
position_bounds: {
|
||
ledger_version: 42,
|
||
daily_energy_min_mwh: '1140.0',
|
||
daily_energy_max_mwh: '1260.0',
|
||
},
|
||
solver: {
|
||
name: 'highs',
|
||
version: '1.7.0',
|
||
status: 'OPTIMAL',
|
||
objective_value: '487020.00',
|
||
wall_time_ms: 12,
|
||
},
|
||
binding_constraints: ['daily_energy_max'],
|
||
skill_version: '1.0.0',
|
||
},
|
||
},
|
||
report_request: {
|
||
'da-bid-summary': {
|
||
kind: 'DAY_AHEAD_BID_SUMMARY',
|
||
market_date: DATE,
|
||
sources: [
|
||
{
|
||
tool_call_id: 'tc-001',
|
||
tool: 'bid-optimization-milp',
|
||
version: '1.0.0',
|
||
output: { expected_revenue_yuan: '510600.00', daily_energy_mwh: '1200.0' },
|
||
},
|
||
],
|
||
},
|
||
},
|
||
skill_report: {
|
||
'da-bid-summary': {
|
||
id: 'rep-001',
|
||
kind: 'DAY_AHEAD_BID_SUMMARY',
|
||
market_date: DATE,
|
||
sections: [
|
||
{
|
||
title: 'Bid summary',
|
||
metrics: [
|
||
{
|
||
name: 'expected_revenue',
|
||
value: '510600.00',
|
||
unit: 'yuan',
|
||
ref: { tool_call_id: 'tc-001', path: 'expected_revenue_yuan' },
|
||
},
|
||
],
|
||
notes: ['all figures reference solver output tc-001'],
|
||
},
|
||
],
|
||
skill_version: '1.0.0',
|
||
generated_at: T1,
|
||
},
|
||
},
|
||
validation_result: {
|
||
pass: {
|
||
proposal_digest: REF_B,
|
||
policy_pack: { id: 'hubei-spot-bidding', version: '2026.03' },
|
||
ok: true,
|
||
violations: [],
|
||
rules_evaluated: ['bid-format', 'price-limits', 'ledger-consistency', 'lineage-integrity'],
|
||
checked_at: T1,
|
||
},
|
||
'reject-price': {
|
||
proposal_digest: REF_B,
|
||
policy_pack: { id: 'hubei-spot-bidding', version: '2026.03' },
|
||
ok: false,
|
||
violations: [{ rule_id: 'price-limits', severity: 'REJECT', message: 'price 1500.00 above cap' }],
|
||
rules_evaluated: ['bid-format', 'price-limits'],
|
||
checked_at: T1,
|
||
},
|
||
},
|
||
simulation_result: {
|
||
'revenue-ok': {
|
||
proposal_digest: REF_B,
|
||
kind: 'REVENUE_SCENARIOS',
|
||
alert: false,
|
||
alerts: [],
|
||
metrics: { revenue_p05_yuan: '410200.00', revenue_p50_yuan: '510600.00', worst_loss_yuan: '0.00' },
|
||
scenario_count: 1000,
|
||
simulator: { name: 'revenue-scenarios', version: '1.0.0', seed: 20260315 },
|
||
simulated_at: T1,
|
||
},
|
||
},
|
||
envelope_match: {
|
||
within: {
|
||
proposal_digest: REF_B,
|
||
within: true,
|
||
envelope_id: 'env-bid-001',
|
||
required_level: 'L1',
|
||
reasons: [],
|
||
checked_at: T1,
|
||
},
|
||
outside: {
|
||
proposal_digest: REF_B,
|
||
within: false,
|
||
envelope_id: null,
|
||
required_level: 'L2',
|
||
reasons: ['no ACTIVE envelope covers BID/DAY_AHEAD for pool-hubei-01'],
|
||
checked_at: T1,
|
||
},
|
||
},
|
||
stale_denial: {
|
||
'ledger-moved': {
|
||
proposal_digest: REF_B,
|
||
reasons: ['ledger version 42 at approval, now 43'],
|
||
checked_at: T2,
|
||
},
|
||
},
|
||
execution_receipt: {
|
||
'file-export': {
|
||
receipt_id: 'rcpt-001',
|
||
proposal_digest: REF_B,
|
||
permit_id: 'permit-001',
|
||
channel: 'FILE_EXPORT',
|
||
idempotency_key: `${REF_B}:permit-001`,
|
||
artifact_ref: 'exports/bid-2026-03-15-prop-001.json',
|
||
accepted_at: T1,
|
||
},
|
||
},
|
||
bid_proposal_draft: {
|
||
basic: {
|
||
market_date: DATE,
|
||
prices_ref: { tool_call_id: 'tc-001', path: 'prices_yuan_per_mwh' },
|
||
quantities_ref: { tool_call_id: 'tc-001', path: 'quantities_mwh' },
|
||
expected_revenue_ref: { tool_call_id: 'tc-001', path: 'expected_revenue_yuan' },
|
||
rationale: 'Evening peak priced above P50; allocate bounded energy to 18:00–20:00.',
|
||
},
|
||
},
|
||
router_decision: {
|
||
'day-ahead-bid': {
|
||
workflow_id: 'day-ahead-bid',
|
||
params: { market_date: DATE },
|
||
confidence: 'HIGH',
|
||
},
|
||
},
|
||
bid_export_file: {
|
||
basic: {
|
||
format_version: '1.0.0',
|
||
proposal_id: 'prop-001',
|
||
proposal_digest: REF_B,
|
||
permit_id: 'permit-001',
|
||
proposal_type: 'BID',
|
||
market_date: DATE,
|
||
prices_yuan_per_mwh: curve('0.00'),
|
||
quantities_mwh: curve('12.5'),
|
||
exported_at: T1,
|
||
},
|
||
},
|
||
award_notice: {
|
||
'da-award': {
|
||
id: 'award-2026-03-15',
|
||
market_date: DATE,
|
||
bid_proposal_digest: REF_B,
|
||
awarded_mwh: curve('12.0'),
|
||
clearing_price_yuan_per_mwh: curve('418.30'),
|
||
received_at: '2026-03-14T08:00:00Z',
|
||
},
|
||
},
|
||
dispatch_proposal_draft: {
|
||
basic: {
|
||
market_date: DATE,
|
||
total_target_ref: { tool_call_id: 'tc-002', path: 'total_target_mw' },
|
||
allocations_ref: { tool_call_id: 'tc-002', path: 'allocations' },
|
||
rationale: 'Storage covers the evening block; industrial load takes the midday share.',
|
||
},
|
||
},
|
||
execution_report: {
|
||
'unit-01': {
|
||
id: 'exec-2026-03-15-agg-unit-wuhan-01',
|
||
market_date: DATE,
|
||
unit_id: 'agg-unit-wuhan-01',
|
||
dispatch_proposal_digest: REF_B,
|
||
planned_mw: curve('48.0'),
|
||
actual_mw: curve('45.6'),
|
||
deviation_mwh: '57.600',
|
||
fulfillment_ratio: '0.950',
|
||
reported_at: '2026-03-16T01:00:00Z',
|
||
},
|
||
},
|
||
metering_record: {
|
||
'da-metering': {
|
||
id: 'meter-2026-03-15',
|
||
market_date: DATE,
|
||
metered_mw: curve('45.6'),
|
||
actual_price_yuan_per_mwh: curve('421.00'),
|
||
received_at: '2026-03-16T02:00:00Z',
|
||
},
|
||
},
|
||
potential_assessment_request: {
|
||
basic: {
|
||
market_date: DATE,
|
||
resources: [
|
||
{
|
||
profile: {
|
||
resource_id: 'res-storage-01',
|
||
name: 'Wuhan industrial park storage #1',
|
||
type: 'STORAGE',
|
||
rated_power_mw: '10.0',
|
||
certified_adjustable_mw: '8.0',
|
||
confidence: '0.92',
|
||
reliability_score: '0.88',
|
||
constraints: { min_duration_min: 60, recovery_rate_mw_per_min: '0.5' },
|
||
evidence_refs: [REF_C],
|
||
updated_at: T0,
|
||
},
|
||
fulfillment: [
|
||
{ market_date: '2026-03-13', planned_mwh: '40.0', delivered_mwh: '38.0' },
|
||
{ market_date: '2026-03-14', planned_mwh: '40.0', delivered_mwh: '39.0' },
|
||
],
|
||
},
|
||
],
|
||
features_snapshot_ref: REF_A,
|
||
},
|
||
},
|
||
potential_assessment_result: {
|
||
basic: {
|
||
market_date: DATE,
|
||
assessments: [
|
||
{ resource_id: 'res-storage-01', adjustable_mw: curve('7.700'), confidence: '0.90', fulfillment_rate: '0.9625', evidence_days: 2 },
|
||
],
|
||
total_adjustable_mw: curve('7.700'),
|
||
skill_version: '1.0.0',
|
||
},
|
||
},
|
||
dispatch_optimization_request: {
|
||
basic: {
|
||
market_date: DATE,
|
||
target_mw: curve('48.0'),
|
||
units: [
|
||
{ unit_id: 'agg-unit-wuhan-01', available_mw: curve('30.0'), cost_weight: '1.0' },
|
||
{ unit_id: 'agg-unit-wuhan-02', available_mw: curve('30.0'), cost_weight: '1.2' },
|
||
],
|
||
},
|
||
},
|
||
dispatch_optimization_result: {
|
||
basic: {
|
||
market_date: DATE,
|
||
total_target_mw: curve('48.0'),
|
||
allocations: [
|
||
{ unit_id: 'agg-unit-wuhan-01', target_mw: curve('30.000') },
|
||
{ unit_id: 'agg-unit-wuhan-02', target_mw: curve('18.000') },
|
||
],
|
||
shortfall_mwh: '0.000',
|
||
solver: { name: 'highs', version: 'scipy-1.17.1', status: 'OPTIMAL', wall_time_ms: 4 },
|
||
skill_version: '1.0.0',
|
||
},
|
||
},
|
||
review_finding: {
|
||
'd-plus-1': {
|
||
id: 'rf-2026-03-15-response',
|
||
market_date: DATE,
|
||
kind: 'RESPONSE',
|
||
summary: 'Unit agg-unit-wuhan-01 delivered 95.0% of plan; reliability score adjusted.',
|
||
attribution: {
|
||
trading_mwh: '48.000',
|
||
control_mwh: '0.000',
|
||
response_mwh: '57.600',
|
||
forecast_load_mape: '0.041',
|
||
forecast_price_mape: '0.017',
|
||
net_deviation_mwh: '57.600',
|
||
},
|
||
writebacks: [
|
||
{ target: 'SEMANTIC_MEMORY', topic: 'response:agg-unit-wuhan-01', lesson: 'Evening block under-delivery on 2026-03-15.' },
|
||
{ target: 'RESOURCE_PROFILE', resource_id: 'res-storage-01', previous_reliability_score: '0.88', new_reliability_score: '0.894', fulfillment_ratio: '0.950' },
|
||
{ target: 'ENVELOPE_RECOMMENDATION', envelope_id: 'env-bid-001', action: 'WIDEN', bound: 'price_deviation_pct', current_value: '5.0', recommended_value: '6.0', basis: '26/26 within-envelope days under threshold' },
|
||
],
|
||
evidence_refs: [REF_A, REF_C],
|
||
lineage_refs: [{ tool_call_id: 'tc-review-001', path: 'attribution' }],
|
||
generated_at: '2026-03-16T03:00:00Z',
|
||
},
|
||
},
|
||
semantic_memory_entry: {
|
||
basic: {
|
||
id: 'mem-001',
|
||
topic: 'forecast:load:hot-day',
|
||
lesson: 'Hot-day HVAC load systematically under-forecast; feature-engineering candidate.',
|
||
source_finding_id: 'rf-2026-03-15-response',
|
||
evidence_refs: [REF_A],
|
||
created_at: '2026-03-16T03:00:00Z',
|
||
},
|
||
},
|
||
envelope_change_request: {
|
||
widen: {
|
||
id: 'ecr-001',
|
||
envelope_id: 'env-bid-001',
|
||
action: 'WIDEN',
|
||
bounds: { price_deviation_pct: '6.0', max_energy_mwh: '1500.0' },
|
||
basis: 'ReviewFinding rf-2026-03-15-response: 26/26 within-envelope days under threshold',
|
||
source_finding_id: 'rf-2026-03-15-response',
|
||
requested_at: '2026-03-16T03:00:00Z',
|
||
},
|
||
},
|
||
insight_card: {
|
||
'trading-desk': {
|
||
id: 'card-001',
|
||
page: 'TRADING_DESK',
|
||
market_date: DATE,
|
||
title: 'Day-ahead situation',
|
||
headline: 'Risk LOW; P50 peak price 425.50 yuan/MWh',
|
||
metrics: [{ name: 'peak_price_p50', value: '425.50', unit: 'yuan_per_mwh', ref: { tool_call_id: 'tc-001', path: 'quantiles.p50.values.76' } }],
|
||
source: { kind: 'SITUATION_REPORT', id: 'sit-001', ref: REF_A },
|
||
generated_at: T0,
|
||
},
|
||
},
|
||
situation_report: {
|
||
'normal-day': {
|
||
id: 'sit-001',
|
||
market_date: DATE,
|
||
risk_level: 'LOW',
|
||
findings: [
|
||
{ kind: 'TREND', summary: 'mild temperatures, load near seasonal norm', refs: [REF_A] },
|
||
],
|
||
forecast_refs: ['fc-001'],
|
||
generated_at: T0,
|
||
},
|
||
},
|
||
resource_profile: {
|
||
storage: {
|
||
resource_id: 'res-storage-01',
|
||
name: 'Wuhan industrial park storage #1',
|
||
type: 'STORAGE',
|
||
rated_power_mw: '10.0',
|
||
certified_adjustable_mw: '8.0',
|
||
confidence: '0.92',
|
||
reliability_score: '0.88',
|
||
constraints: { min_duration_min: 60, recovery_rate_mw_per_min: '0.5' },
|
||
evidence_refs: [REF_C],
|
||
updated_at: T0,
|
||
},
|
||
},
|
||
decision_case: {
|
||
'da-bid': {
|
||
id: 'case-001',
|
||
kind: 'DAY_AHEAD_BID',
|
||
objective: 'Complete day-ahead bid for 2026-03-15',
|
||
owner: 'user-trader-01',
|
||
deadline: '2026-03-14T10:00:00Z',
|
||
status: 'AWAITING_APPROVAL',
|
||
refs: {
|
||
evidence: ['sit-001', 'fc-001'],
|
||
proposals: ['prop-001'],
|
||
approvals: [],
|
||
permits: [],
|
||
scenarios: [],
|
||
outcome: null,
|
||
},
|
||
opened_at: T0,
|
||
closed_at: null,
|
||
},
|
||
},
|
||
event_envelope: {
|
||
'situation-published': {
|
||
event_id: 'evt-001',
|
||
event_type: 'SituationReportPublished',
|
||
schema_version: '1.0.0',
|
||
occurred_at: T0,
|
||
causation_id: 'task-001',
|
||
correlation_id: 'case-001',
|
||
payload: { situation_report_id: 'sit-001' },
|
||
},
|
||
},
|
||
}
|
||
|
||
// Each invalid case breaks exactly one rule and must fail on both sides.
|
||
const invalid: Record<string, Record<string, unknown>> = {
|
||
proposal: {
|
||
// money as JSON float — the forbidden representation (docs/11 §3.3)
|
||
'bid-float-money': structuredClone(valid['proposal']!['bid-basic']!),
|
||
},
|
||
approval: {
|
||
// digest not sha256 hex
|
||
'bad-digest': { ...(valid['approval']!['approve'] as object), proposal_digest: 'not-a-digest' },
|
||
},
|
||
skill_report: {
|
||
// a metric without a lineage reference — the one thing a report may never contain (I1)
|
||
'metric-without-ref': (() => {
|
||
const o = structuredClone(valid['skill_report']!['da-bid-summary']) as any
|
||
delete o.sections[0].metrics[0].ref
|
||
return o
|
||
})(),
|
||
},
|
||
bid_optimization_result: {
|
||
// solver status outside the enum
|
||
'bad-solver-status': (() => {
|
||
const o = structuredClone(valid['bid_optimization_result']!['da-basic']) as any
|
||
o.solver.status = 'SOLVED'
|
||
return o
|
||
})(),
|
||
},
|
||
bid_proposal_draft: {
|
||
// a literal number where only a lineage reference is allowed (I1/P2)
|
||
'literal-number': {
|
||
market_date: DATE,
|
||
prices_ref: { tool_call_id: 'tc-001', path: 'prices_yuan_per_mwh' },
|
||
quantities_ref: { tool_call_id: 'tc-001', path: 'quantities_mwh' },
|
||
expected_revenue_ref: '510600.00',
|
||
rationale: 'x',
|
||
},
|
||
},
|
||
router_decision: {
|
||
// a workflow id that is not a registered template
|
||
'unknown-template': { workflow_id: 'transfer-funds', params: { market_date: DATE }, confidence: 'HIGH' },
|
||
},
|
||
review_finding: {
|
||
// a writeback with an unknown target — findings may only write to the three sanctioned stores
|
||
'unknown-writeback': (() => {
|
||
const o = structuredClone(valid['review_finding']!['d-plus-1']) as any
|
||
o.writebacks = [{ target: 'LEDGER', note: 'nope' }]
|
||
return o
|
||
})(),
|
||
},
|
||
position_update: {
|
||
// missing optimistic-concurrency field
|
||
'missing-version': (() => {
|
||
const o = structuredClone(valid['position_update']!['award-da']) as Record<string, unknown>
|
||
delete o['expected_version']
|
||
return o
|
||
})(),
|
||
},
|
||
}
|
||
;(invalid['proposal']!['bid-float-money'] as any).payload.expected_revenue_yuan = 510600.0
|
||
|
||
const write = (dir: string, sets: Record<string, Record<string, unknown>>) => {
|
||
for (const [name, cases] of Object.entries(sets)) {
|
||
mkdirSync(`${root}${dir}/${name}`, { recursive: true })
|
||
for (const [caseName, obj] of Object.entries(cases)) {
|
||
writeFileSync(`${root}${dir}/${name}/${caseName}.json`, JSON.stringify(obj, null, 2) + '\n')
|
||
}
|
||
}
|
||
}
|
||
|
||
write('fixtures', valid)
|
||
write('fixtures-invalid', invalid)
|
||
console.log('fixtures written')
|