- 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
92 lines
2.4 KiB
Python
92 lines
2.4 KiB
Python
# generated by datamodel-codegen:
|
|
# filename: review_finding.json
|
|
|
|
from __future__ import annotations
|
|
|
|
from enum import StrEnum
|
|
from typing import Literal
|
|
|
|
from pydantic import AwareDatetime, BaseModel, ConfigDict, constr
|
|
|
|
|
|
class Kind(StrEnum):
|
|
FORECAST = 'FORECAST'
|
|
RESPONSE = 'RESPONSE'
|
|
TRADING = 'TRADING'
|
|
CONTROL = 'CONTROL'
|
|
|
|
|
|
class Attribution(BaseModel):
|
|
model_config = ConfigDict(
|
|
extra='forbid',
|
|
)
|
|
trading_mwh: constr(pattern=r'^-?\d+(\.\d+)?$')
|
|
control_mwh: constr(pattern=r'^-?\d+(\.\d+)?$')
|
|
response_mwh: constr(pattern=r'^-?\d+(\.\d+)?$')
|
|
forecast_load_mape: constr(pattern=r'^-?\d+(\.\d+)?$') | None
|
|
forecast_price_mape: constr(pattern=r'^-?\d+(\.\d+)?$') | None
|
|
net_deviation_mwh: constr(pattern=r'^-?\d+(\.\d+)?$')
|
|
|
|
|
|
class Writebacks(BaseModel):
|
|
model_config = ConfigDict(
|
|
extra='forbid',
|
|
)
|
|
target: Literal['SEMANTIC_MEMORY']
|
|
topic: constr(min_length=1)
|
|
lesson: constr(min_length=1)
|
|
|
|
|
|
class Writebacks1(BaseModel):
|
|
model_config = ConfigDict(
|
|
extra='forbid',
|
|
)
|
|
target: Literal['RESOURCE_PROFILE']
|
|
resource_id: constr(min_length=1)
|
|
previous_reliability_score: constr(pattern=r'^-?\d+(\.\d+)?$')
|
|
new_reliability_score: constr(pattern=r'^-?\d+(\.\d+)?$')
|
|
fulfillment_ratio: constr(pattern=r'^-?\d+(\.\d+)?$')
|
|
|
|
|
|
class Action(StrEnum):
|
|
WIDEN = 'WIDEN'
|
|
NARROW = 'NARROW'
|
|
SUSPEND = 'SUSPEND'
|
|
KEEP = 'KEEP'
|
|
|
|
|
|
class Writebacks2(BaseModel):
|
|
model_config = ConfigDict(
|
|
extra='forbid',
|
|
)
|
|
target: Literal['ENVELOPE_RECOMMENDATION']
|
|
envelope_id: constr(min_length=1)
|
|
action: Action
|
|
bound: constr(min_length=1)
|
|
current_value: constr(pattern=r'^-?\d+(\.\d+)?$')
|
|
recommended_value: constr(pattern=r'^-?\d+(\.\d+)?$')
|
|
basis: constr(min_length=1)
|
|
|
|
|
|
class LineageRef(BaseModel):
|
|
model_config = ConfigDict(
|
|
extra='forbid',
|
|
)
|
|
tool_call_id: constr(min_length=1)
|
|
path: constr(min_length=1)
|
|
|
|
|
|
class ReviewFinding(BaseModel):
|
|
model_config = ConfigDict(
|
|
extra='forbid',
|
|
)
|
|
id: constr(min_length=1)
|
|
market_date: constr(pattern=r'^\d{4}-\d{2}-\d{2}$')
|
|
kind: Kind
|
|
summary: constr(min_length=1)
|
|
attribution: Attribution
|
|
writebacks: list[Writebacks | Writebacks1 | Writebacks2]
|
|
evidence_refs: list[constr(pattern=r'^[0-9a-f]{64}$')]
|
|
lineage_refs: list[LineageRef]
|
|
generated_at: AwareDatetime
|