Skip to content

Commit 680474c

Browse files
committed
Document KitchenSpeak trusted-base postulates (governance: trusted-base policy)
Annotate every Agda postulate with a leading AXIOM: comment and enumerate them in PROOF-NEEDS.md, satisfying the trusted-base reduction policy. These postulates are deliberate trust boundaries (postulated sensor oracles + the GENTLE controller spec), not undocumented escape hatches.
1 parent 2633bd4 commit 680474c

3 files changed

Lines changed: 33 additions & 3 deletions

File tree

PROOF-NEEDS.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,21 @@
2121
| Tangle Lean proofs | Extend Tangle.lean coverage | Existing Lean proofs are partial |
2222
| Oblibeny ABI | Extend Interface.idr with full package proofs | Current ABI is minimal |
2323

24+
## KitchenSpeak Trusted Base (Agda postulates)
25+
26+
KitchenSpeak's proofs are deliberately built on a small, explicit trusted
27+
base: the *postulated echo-oracles* (sensors) and the GENTLE *controller
28+
spec*. These are not soundness gaps to close but documented trust
29+
boundaries (see each proof's final section and `COMMENTARY.adoc §Echo`).
30+
A production lowering replaces each with a verified HAL binding.
31+
32+
| Postulate | File | What it trusts | Production replacement |
33+
|-----------|------|----------------|------------------------|
34+
| `viscosity-at` | `kitchenspeak/proofs/agda/Dough.agda` | Torque sensor stream | Verified HAL torque binding |
35+
| `temp-at` | `kitchenspeak/proofs/agda/PoachedEgg.agda` | Hob thermometer stream | Verified HAL thermal binding |
36+
| `white-set-at` | `kitchenspeak/proofs/agda/PoachedEgg.agda` | Visual albumen classifier | Verified/empirically-bounded classifier |
37+
| `gentle-bounded` | `kitchenspeak/proofs/agda/PoachedEgg.agda` | GENTLE controller never overshoots target cap | Integrator bound on the slope |
38+
2439
## Recommended Prover
2540

2641
**Coq** for Ephapax (existing proof infrastructure). **Lean4** for Tangle (existing). **Idris2** for ABI layers. **OCaml** extraction from Coq for AffineScript type checker verification.

kitchenspeak/proofs/agda/Dough.agda

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -175,7 +175,12 @@ bind-dough _ _ = mkDough KNEADABLE
175175
-- *assumes* its values exist and discharges the surrounding control
176176
-- flow. See COMMENTARY.adoc §Echo for the discussion of postulated
177177
-- oracles and the proven/postulated boundary.
178-
178+
--
179+
-- AXIOM: postulated echo-oracle (the torque sensor stream) — the
180+
-- physical world, not a derivable term. The proof trusts the sensor
181+
-- and discharges the surrounding control flow; a production lowering
182+
-- replaces it with a verified HAL binding (§8(a)). Trusted base
183+
-- contribution: 1 sensor postulate.
179184
postulate
180185
viscosity-at : Minutes Torque-dNm
181186

kitchenspeak/proofs/agda/PoachedEgg.agda

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -163,7 +163,13 @@ record Vinegar : Set where
163163
-- temp-at — the hob thermometer, in °C, sampled per minute.
164164
-- white-set-at — the visual albumen-coagulation classifier; reports
165165
-- a coagulation score, "set" once it crosses 1.
166-
166+
--
167+
-- AXIOM: these are postulated echo-oracle sensor streams — the physical
168+
-- world, not derivable terms. The proof trusts the classifier pipeline
169+
-- and discharges the surrounding control flow; a production lowering
170+
-- replaces each with a verified HAL binding. This is the deliberate
171+
-- proven/postulated trusted-base boundary (COMMENTARY.adoc §Echo; §9(a)
172+
-- below). Trusted base contribution: 2 sensor postulates.
167173
postulate
168174
temp-at : Minutes Celsius
169175
white-set-at : Minutes
@@ -234,7 +240,11 @@ poach e v (suc n) t with white-set-at t ≥? set-threshold
234240
-- analogue of the sensor postulate — it is the controller's contract,
235241
-- supplied by the HAL, not derived here. A production lowering proves
236242
-- it from an integrator bound on the slope.
237-
243+
--
244+
-- AXIOM: the GENTLE controller's specification, supplied by the HAL and
245+
-- trusted here rather than derived. A production lowering discharges it
246+
-- from an integrator bound on the slope (§9(b)). Trusted base
247+
-- contribution: 1 controller postulate.
238248
postulate
239249
gentle-bounded : (t : Minutes) temp-at t ≤ target-cap
240250

0 commit comments

Comments
 (0)