vpp-ai-platform/skills-py/vpp_contracts/envelope.py
stewart hu f681e134cc M1: domain schemas, contracts pipeline, ledger and snapshot services
- packages/domain: zod schemas for the 07-scenario object set with a
  schemaRegistry driving schema export, fixture generation, and Python
  module naming; decimal-string/sha256/curve primitives enforce the
  docs/11 §3.3 representation rules at the type layer
- contracts/: 12 JSON Schemas (draft 2020-12), 12 golden fixtures, 3
  invalid fixtures crafted to fail on both sides (float money, bad
  digest, missing concurrency version)
- skills-py: generated pydantic models (committed, never hand-edited),
  regeneration script, mirror pytest using JSON-mode validation —
  dual-side contract tests agree on all 15 fixtures
- packages/services: content-addressed immutable snapshot store
  (memory + fs, rejects floats), LedgerService v1 with optimistic
  concurrency and the P7 constraint cascade (monthly position bounds
  day-ahead bids; no-anchor bids rejected), quality-gate stub
- cascade band shape is an OPEN-QUESTION A5 placeholder (pro-rata
  daily share ±band) — see ledger.ts checkCascade

All green: tsc typecheck, 41 TS tests, 15 Python tests.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019u5SLNweVio6ozJX7yfxQr

🔮 View transcript: https://logs.lojong.info/s/e8u90k3t33w590r7b5y7yzqh
2026-09-01 21:50:22 -04:00

94 lines
1.8 KiB
Python

# generated by datamodel-codegen:
# filename: envelope.json
from __future__ import annotations
from enum import StrEnum
from pydantic import (
AwareDatetime,
BaseModel,
ConfigDict,
Field,
RootModel,
conint,
constr,
)
class ProposalType(StrEnum):
BID = 'BID'
INVITATION = 'INVITATION'
CONTROL_PLAN = 'CONTROL_PLAN'
DISPATCH_PLAN = 'DISPATCH_PLAN'
class Timescale(StrEnum):
ANNUAL = 'ANNUAL'
MONTHLY = 'MONTHLY'
DAY_AHEAD = 'DAY_AHEAD'
INTRADAY = 'INTRADAY'
REALTIME = 'REALTIME'
class Scope(BaseModel):
model_config = ConfigDict(
extra='forbid',
)
proposal_type: ProposalType
timescales: list[Timescale] = Field(..., min_length=1)
resource_set: constr(min_length=1)
class Validity(BaseModel):
model_config = ConfigDict(
extra='forbid',
)
from_: AwareDatetime = Field(..., alias='from')
to: AwareDatetime
class Level(StrEnum):
L1 = 'L1'
L2 = 'L2'
L3 = 'L3'
class ApprovedByItem(RootModel[constr(min_length=1)]):
root: constr(min_length=1)
class Approval(BaseModel):
model_config = ConfigDict(
extra='forbid',
)
level: Level
approved_by: list[ApprovedByItem] = Field(..., min_length=1)
class Escalation(BaseModel):
model_config = ConfigDict(
extra='forbid',
)
max_consecutive_deviations: conint(le=9007199254740991, gt=0)
deviation_threshold_pct: constr(pattern=r'^-?\d+(\.\d+)?$')
class Status(StrEnum):
ACTIVE = 'ACTIVE'
SUSPENDED = 'SUSPENDED'
EXPIRED = 'EXPIRED'
class Envelope(BaseModel):
model_config = ConfigDict(
extra='forbid',
)
id: constr(min_length=1)
scope: Scope
bounds: dict[str, constr(pattern=r'^-?\d+(\.\d+)?$')]
validity: Validity
approval: Approval
escalation: Escalation
status: Status