coulomb/fin-hub
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Advance resource cost evidence contract

Browse source
This commit is contained in:
tegwick 2026-08-11 15:49:16 +02:00
parent d1528944c3
commit 49519a715a
7 changed files with 631 additions and 21 deletions
Download patch file Download diff file Expand all files Collapse all files

18
docs/fin-resource-authority-contract-v0.1.md
View file

@ -160,6 +160,24 @@ Delivery is idempotent on `record_id`; revisions are append-only and must
reference the current record of the same type. Fin-hub stores these in
`planning_evidence`, never in its booked-cost ledger.
## Fin-hub → resource-control: bounded financial constraints
`FinancialConstraintSignal` exposes only the financial context needed to rank
a procurement or optimization case: applicable budget ceiling, active
commitment amount, budget utilization, and runway pressure. Each signal has a
stable content-derived ID, exact currency and effective period, optional
resource/service/environment scope, non-secret provenance, and generation
time.
Budget ceilings and active commitments are labelled `policy_constraint`.
Budget utilization and runway are labelled `informational` or
`informational_warning` according to the current threshold. Consumers must not
turn an informational signal into an approval gate, nor reproduce fin-hub's
budget, burn, or runway calculations. Missing authoritative values produce no
signal rather than a synthetic zero. The projection carries no payment
credentials, private invoice data, unrelated ledger rows, or procurement
authority.
## Reconciliation invariants
1. Each booked financial fact has exactly one authoritative fin-hub record.