Upstream provenance — eawf telemetry subsystem
================================================

The Pydantic row models in `models.py` are retyped from an earlier
local telemetry prototype by the same author (a standalone CLI that
projected agent session logs into a cost + duration ledger), and the
`PRICING` snapshot in `pricing.py` descends from that prototype's
embedded `PRICING` dict.

Upstream project : earlier local telemetry prototype, v0.1.0
                   (shipped 2026-04-30)
Upstream module  : its models module (dataclasses + PRICING dict)

That prototype is retired. It has no successor as a separate tool: the
projection it performed lives here, and the operator-facing reporting
role it played is superseded by the reflection work under
`.ea/local/research/2026-07-27/reflection/`, which the v0.7 proposal
carries as the `/reflect` skill.

Vendoring deltas applied at eawf C09 vendor time
------------------------------------------------
- Dataclasses -> Pydantic v2 BaseModel with ConfigDict(extra="forbid").
- Free-string error_kind  -> closed ToolCallErrorKind enum.
- New eawf-specific rows: TelemetryRuntimeSwitch, TelemetryIncident.
- New eawf-specific fields: runtime, wave_id, attempt_id, has_eawf_state,
  and the EndMarker `runtime_switched` member (V5).
- float cost -> Decimal (total_cost_usd, all per-token rates).

PRICING snapshot re-sourcing
----------------------------
The upstream embedded PRICING dict was a stale "April 2026 snapshot"
(Opus 4.x over-billed 3x, Haiku 4.5 under-billed ~25%). The eawf snapshot
is RE-SOURCED, not vendored verbatim: canonical Anthropic published rates
fetched 2026-05-17 12:00:00 UTC from
https://platform.claude.com/docs/en/about-claude/pricing
(pricing_version="2026.05.17"), extended with the 5m/1h cache-write split
plus pricing_version + fetched_at metadata fields.

References (repo-relative / external URL)
-----------------------------------------
- .ea/local/research/long-term/2026-05-17-c09-blitz-pricing-currency.md
  (currency diff + verdict that drove the re-source)
- .ea/artifacts/research/long-term/2026-05-17-c09-quality-observability.md
  (C09 §5.9 telemetry subsystem spec — reference models + pricing block)
- .ea/local/research/2026-07-27/reflection/08-codex-pricing-provenance.md
  (cross-vendor pricing provenance for the successor reporting surface)
- https://platform.claude.com/docs/en/about-claude/pricing
  (canonical Anthropic pricing page, 2026-05-17 fetch)

Note: no upstream commit SHA is recorded here. The eawf vendor work
referenced the prototype's published v0.1.0 release artifact and the
re-sourced Anthropic pricing page rather than a pinned upstream git
commit, and the prototype is now retired, so no re-vendor sweep is
expected.
