Open-source donations to the IES Accelerator track

The orchestration and contract layer between raw SLDC feeds and an IES-shaped consumer API. Apache 2.0. Dependency-light Python package; no Postgres, no Prometheus, no Docker required to import.

v0.4 §Adoption Strategy, p. 7 · §Programme Observability, pp. 26–28

• StateDemandRow Pydantic contract — refuses to serve null observed values, distinguishes observed from modeled / synthesized / derived / missing
• Canonical state-name normaliser collapsing 33+ SLDC variants (J&K vs Jammu and Kashmir, A&N vs Andaman, etc.) to one key
• IST-aligned canonical hour with publication-SLA settle window (IST at edge, UTC in DB)
• Lightweight {atlas_hour, source_health, data} freshness envelope, composable with the cryptographically-receipted IES envelope
• Pluggable Source registry with timeout-bounded async pull
• 60 unit tests, GitHub Actions CI matrix on Python 3.11 and 3.12, runnable end-to-end Delhi demo

$ git clone https://github.com/india-energy-atlas/ies-ingest
$ cd ies-ingest
$ make verify

Per-state SLDC collectors — the httpx / playwright / pdfplumber adapters that produce hourly rows for the 33+ state and UT feeds. Plugin pattern so external contributors can add a new state without touching core. The companion repository to ies-ingest.

v0.4 Annexure 3 §1.1 — IEC CIM alignment

• Wave-1 adapters at launch: Delhi, Maharashtra, Gujarat, Karnataka, Tamil Nadu
• Each adapter exposes async fetch(atlas_hour) → Iterable[RawRow] and async health() → bool
• Adapter outputs compose with ies_ingest.contract.finalize_state_demand_row() end-to-end
• Test fixtures captured against real upstream payloads — HTML / PDF / Excel snapshots, redacted of any contact info

Three CERC orders encoded as machine-readable, signed JSON policy packs. The policy-author seat that v0.4 Annexure 6 deliberately leaves open. Apache 2.0. Contestable per the architecture's §contestability requirement; deterministic evaluator; version-chained.

v0.4 Annexure 6, pp. 57–58

• Each order has source.pdf with provenance metadata, policy.json (JSON-LD with @type ies-preview:PolicyPack), tests/*.json (positive + edge cases), and policy.json.sig (Ed25519)
• policySignatory (the regulator) and policyAuthor (the encoding body) kept as two distinct fields per Annexure 6
• Top-level evaluator returning an IES-preview-conformant outcome+reason envelope
• Three orders chosen to exercise different building blocks — tariff (Identity + ERA), DR-eligibility (Credentials), open-access wheeling (all four)

Model Context Protocol server exposing IES-shaped data as agent-native tools. Each tool name follows the verb–noun grammar from v0.4 Annexure 2 (energymap_aggregate_state, energymap_discover_regulatory_orders). Agentic-ready by design.

v0.4 §AI-ready by design

• Backed exclusively by /v1/ies-preview/* calls — never reaches into upstream services directly
• Tools draw from §8 verb-noun grammar: discover, search, publish, notify, attest, aggregate, report, audit
• At least one third-party LLM integration demo at launch