# fin-hub ↔ resource-control contract v0.1 — resource-control ratification

Status: authority and schema boundary accepted on 2026-08-11
Fin-hub implementation reviewed: commit `0034330`
Workplans: `RESOURCE-WP-0003-T02`, `FIN-WP-0004`

The jointly reviewed contract is maintained in fin-hub at
`docs/fin-resource-authority-contract-v0.1.md`. This record is the
resource-control-side ratification and identifies the artifacts for which this
repository is authoritative.

## Authority

- fin-hub owns booked financial facts and corrections, tax and currency
  treatment, budgets, commitments, burn, runway, and viability signals.
- resource-control owns resource identity and lifecycle, technical usage,
  allocation evidence, demand and cost forecasts, and optimization evidence.
- workload and platform repositories remain authoritative for native workload
  identity, service requirements, provisioning, operation, and source
  telemetry.
- neither repository approves contracts, executes payment, or turns planning
  evidence into booked spend.

## Artifacts

- `schemas/planning-evidence.schema.json` is the authoritative
  resource-control outbound schema.
- `tools/financial_exchange.py forecast` converts the existing immutable
  monthly backup forecast into canonical `ForecastEvidence` records.
- `tools/financial_exchange.py reconcile` validates fin-hub booked-cost
  projections and compares attributable infrastructure cost by accounting
  period. Booked facts are referenced projections here, never a second ledger.
- `schemas/monthly-resource-observation.schema.json` uses
  `usage_observation` for technical observations. “Booked actual” is reserved
  for fin-hub facts.

Fin-hub owns its outbound `BookedCostEvidence` executable schema. This
repository validates the contract fields and arithmetic it consumes, but does
not redefine financial authority.

## Acceptance boundary

The 12-row `platform:audit-storage` forecast can complete an idempotent
planning-evidence preflight before procurement. `FIN-WP-0004-T05` and the
operational round trip remain open until an attributable provider charge or
credit exists. Fixture or synthetic money may test the seam but cannot satisfy
that evidence gate.