48 lines
2.2 KiB
Markdown
48 lines
2.2 KiB
Markdown
|
# 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.
|