8796faca63
- packages/domain: ForecastRequest, BidOptimizationRequest/Result,
ReportRequest, SkillReport (+ golden and invalid fixtures, exported to
contracts/ and regenerated as pydantic models).
- skills-py/vpp_skills: FastAPI service with versioned registry; load/PV/
price forecasts (same-day-type EWM point forecast, conformal residual
quantiles — coverage test as acceptance gate); bid-optimization MILP on
HiGHS (binary block participation, hard ledger energy bounds, exact
Decimal fit of the rounded curve inside the bounds, revenue distribution
over quantile paths); report generator whose every figure is a
{tool_call_id, path} reference, with a verifier. 48 tests incl. hypothesis
property test that bids respect ledger constraints.
- packages/services: LedgerService.dayAheadBounds (the P7 cascade band
handed to the optimizer); Decimal resolved once for CJS/ESM interop.
- packages/evals: L2 metrics (MAPE, nRMSE, coverage, direction accuracy,
naive/hindsight revenue baselines), HTTP skill client, rolling-origin
harness that pushes each bid through the real ledger, CLI with
--check/--write-baseline; committed baseline on the SYNTHETIC dataset
(no historical Hubei data yet — baselines measure the harness, not KPI).
- CI: evals job boots the skill service and fails on baseline digest drift.
- docs/open-questions: A6 (flexibility marginal cost = offer floor); A4/B6
wired as placeholders. README/CLAUDE.md status → M2 done, M3 next.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UoYoGYzHkFyv3ALenkRPhA
262 lines
6.7 KiB
JSON
262 lines
6.7 KiB
JSON
{
|
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
"type": "object",
|
|
"properties": {
|
|
"market_date": {
|
|
"type": "string",
|
|
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
|
|
},
|
|
"price_forecast": {
|
|
"type": "object",
|
|
"properties": {
|
|
"id": {
|
|
"type": "string",
|
|
"minLength": 1
|
|
},
|
|
"kind": {
|
|
"type": "string",
|
|
"enum": [
|
|
"LOAD",
|
|
"PV",
|
|
"PRICE"
|
|
]
|
|
},
|
|
"market_date": {
|
|
"type": "string",
|
|
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
|
|
},
|
|
"unit": {
|
|
"type": "string",
|
|
"enum": [
|
|
"mw",
|
|
"yuan_per_mwh"
|
|
]
|
|
},
|
|
"quantiles": {
|
|
"type": "object",
|
|
"properties": {
|
|
"p10": {
|
|
"type": "object",
|
|
"properties": {
|
|
"interval_minutes": {
|
|
"type": "number",
|
|
"const": 15
|
|
},
|
|
"date": {
|
|
"type": "string",
|
|
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
|
|
},
|
|
"values": {
|
|
"minItems": 96,
|
|
"maxItems": 96,
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string",
|
|
"pattern": "^-?\\d+(\\.\\d+)?$"
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"interval_minutes",
|
|
"date",
|
|
"values"
|
|
],
|
|
"additionalProperties": false
|
|
},
|
|
"p50": {
|
|
"type": "object",
|
|
"properties": {
|
|
"interval_minutes": {
|
|
"type": "number",
|
|
"const": 15
|
|
},
|
|
"date": {
|
|
"type": "string",
|
|
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
|
|
},
|
|
"values": {
|
|
"minItems": 96,
|
|
"maxItems": 96,
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string",
|
|
"pattern": "^-?\\d+(\\.\\d+)?$"
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"interval_minutes",
|
|
"date",
|
|
"values"
|
|
],
|
|
"additionalProperties": false
|
|
},
|
|
"p90": {
|
|
"type": "object",
|
|
"properties": {
|
|
"interval_minutes": {
|
|
"type": "number",
|
|
"const": 15
|
|
},
|
|
"date": {
|
|
"type": "string",
|
|
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
|
|
},
|
|
"values": {
|
|
"minItems": 96,
|
|
"maxItems": 96,
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string",
|
|
"pattern": "^-?\\d+(\\.\\d+)?$"
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"interval_minutes",
|
|
"date",
|
|
"values"
|
|
],
|
|
"additionalProperties": false
|
|
}
|
|
},
|
|
"required": [
|
|
"p10",
|
|
"p50",
|
|
"p90"
|
|
],
|
|
"additionalProperties": false
|
|
},
|
|
"model": {
|
|
"type": "object",
|
|
"properties": {
|
|
"name": {
|
|
"type": "string",
|
|
"minLength": 1
|
|
},
|
|
"version": {
|
|
"type": "string",
|
|
"minLength": 1
|
|
}
|
|
},
|
|
"required": [
|
|
"name",
|
|
"version"
|
|
],
|
|
"additionalProperties": false
|
|
},
|
|
"features_snapshot_ref": {
|
|
"type": "string",
|
|
"pattern": "^[0-9a-f]{64}$"
|
|
},
|
|
"generated_at": {
|
|
"type": "string",
|
|
"format": "date-time",
|
|
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
|
|
}
|
|
},
|
|
"required": [
|
|
"id",
|
|
"kind",
|
|
"market_date",
|
|
"unit",
|
|
"quantiles",
|
|
"model",
|
|
"features_snapshot_ref",
|
|
"generated_at"
|
|
],
|
|
"additionalProperties": false
|
|
},
|
|
"adjustable_capacity_mw": {
|
|
"type": "object",
|
|
"properties": {
|
|
"interval_minutes": {
|
|
"type": "number",
|
|
"const": 15
|
|
},
|
|
"date": {
|
|
"type": "string",
|
|
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
|
|
},
|
|
"values": {
|
|
"minItems": 96,
|
|
"maxItems": 96,
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string",
|
|
"pattern": "^-?\\d+(\\.\\d+)?$"
|
|
}
|
|
}
|
|
},
|
|
"required": [
|
|
"interval_minutes",
|
|
"date",
|
|
"values"
|
|
],
|
|
"additionalProperties": false
|
|
},
|
|
"position_bounds": {
|
|
"type": "object",
|
|
"properties": {
|
|
"ledger_version": {
|
|
"type": "integer",
|
|
"minimum": 0,
|
|
"maximum": 9007199254740991
|
|
},
|
|
"daily_energy_min_mwh": {
|
|
"type": "string",
|
|
"pattern": "^-?\\d+(\\.\\d+)?$"
|
|
},
|
|
"daily_energy_max_mwh": {
|
|
"type": "string",
|
|
"pattern": "^-?\\d+(\\.\\d+)?$"
|
|
}
|
|
},
|
|
"required": [
|
|
"ledger_version",
|
|
"daily_energy_min_mwh",
|
|
"daily_energy_max_mwh"
|
|
],
|
|
"additionalProperties": false
|
|
},
|
|
"risk": {
|
|
"type": "object",
|
|
"properties": {
|
|
"risk_aversion": {
|
|
"type": "string",
|
|
"pattern": "^-?\\d+(\\.\\d+)?$"
|
|
},
|
|
"commitment_buffer_k": {
|
|
"type": "string",
|
|
"pattern": "^-?\\d+(\\.\\d+)?$"
|
|
},
|
|
"min_block_mwh": {
|
|
"type": "string",
|
|
"pattern": "^-?\\d+(\\.\\d+)?$"
|
|
},
|
|
"marginal_cost_yuan_per_mwh": {
|
|
"type": "string",
|
|
"pattern": "^-?\\d+(\\.\\d+)?$"
|
|
}
|
|
},
|
|
"required": [
|
|
"risk_aversion",
|
|
"commitment_buffer_k",
|
|
"min_block_mwh",
|
|
"marginal_cost_yuan_per_mwh"
|
|
],
|
|
"additionalProperties": false
|
|
}
|
|
},
|
|
"required": [
|
|
"market_date",
|
|
"price_forecast",
|
|
"adjustable_capacity_mw",
|
|
"position_bounds",
|
|
"risk"
|
|
],
|
|
"additionalProperties": false,
|
|
"$id": "https://vpp-ai-platform/contracts/bid_optimization_request.json",
|
|
"title": "BidOptimizationRequest"
|
|
}
|