Canon 0.4.0: joinable consumer proof and EvidenceBasis
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / container-smoke (push) Successful in 1s

§10.3 now accepts a consumer record that validates against the live
catalog; resource-control's backup restatement is that proof. ITC-GOV
gains EvidenceBasis in tiers (invoiced and measured are peers) and
ITC-CAP requires it on every consumption row (CAP-R10).
This commit is contained in:
tegwick 2026-08-15 19:14:11 +02:00
parent ce17dc4d4d
commit f2d216af53
29 changed files with 605 additions and 127 deletions

View file

@ -1066,6 +1066,53 @@ meeting decision
audit sample
```
A quantity offered as evidence MUST declare an **EvidenceBasis** (§11.34a)
so a decision can be graded by the weakest thing it actually rests on.
---
## 11.34a EvidenceBasis
An **EvidenceBasis** is how a quantity was obtained. A counted object and an
assumed hourly rate are both numbers; they are not both knowledge.
The closed vocabulary is held in `models/governance/evidence-basis.yaml` and
is not restated as a second list here. Strength is a **tier**, not a total
order: `invoiced` and `measured` are peers. `invoiced`, `measured`, and
`quoted` are **evidenced**. Everything below that tier is inference.
Normative rules:
- A derived value is only as strong as its weakest input, compared by
tier. Members of the same tier do not rank against each other.
- Basis `unknown` carries no quantity and MUST name the gap and its owner.
Any other basis MUST carry a quantity. Zero means measured-and-none;
unknown means not measured.
- A derived value MUST record its inputs. Only a derived value may.
- `invoiced` names a booked financial fact owned by the financial counterpart
(`fin-hub`). This model does not originate booked costs.
Optional qualifiers: `proxy_for` (the value measures a different quantity
than the one being reasoned about) and `observed_at` (the measurement has an
age).
A set of load-bearing values has a **decision grade**: `evidenced`,
`projected`, `indicative`, or `insufficient`. The grade is no stronger than
the weakest resolved basis.
EvidenceBasis is not the intended/declared/applied/observed/assessed state
qualifier (assimilation OQ-3). Those name *which world* a claim is about.
This names *how a number* in that world was produced.
Imported by ITC-CAP `CapabilityConsumption` (CAP-R10). Reusable on any
measured or modelled quantity — actuals, thresholds, forecasts — without
those records becoming capability artifacts.
**Provenance.** Adapted from consumer demand `demand/EvidenceBasis.md`
(resource-control `docs/evidence-basis.md` / `tools/basis.py`), 2026-08-15.
The first application graded a provider comparison `indicative` that had
been stated to the cent.
---
## 11.35 Assertion