Skip to content

Commit 84817e4

Browse files
hyperpolymathclaude
andcommitted
docs: add docs/proof-debt.md to enumerate exploratory truncation postulates
Closes the recurring `governance / Trusted-base reduction policy` red check (consistently failing on echo-types since the policy was adopted estate-wide) without any code change. The repo's sole soundness-relevant escape hatch is the top-level `postulate` block in `proofs/agda/EchoImageFactorizationPropPostulated.agda` (four propositional-truncation primitives), already explicitly scoped as exploratory by: - the file's own preamble + `hypatia: allow code_safety/agda_postulate`, - `tools/check-guardrails.sh` allow-list (line ~exempt), - `docs/echo-types/echo-kernel-note.adoc` Tier-2 classification. This commit just satisfies the Trusted-Base Reduction Policy's documentation requirement by enumerating that single escape hatch under Disposition (c) NECESSARY AXIOM with the standard justification + citations. No new postulates, no code changes, no `.trusted-base-ignore` additions. Verified locally via `bash check-trusted-base.sh .`: [OK] All 1 escape hatch(es) are documented. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 3bb92f4 commit 84817e4

1 file changed

Lines changed: 49 additions & 0 deletions

File tree

docs/proof-debt.md

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
# Proof debt
2+
3+
Per the estate Trusted-Base Reduction Policy
4+
(hyperpolymath/standards `docs/TRUSTED-BASE-REDUCTION-POLICY.adoc`), every
5+
soundness-relevant escape hatch in this repository is enumerated below
6+
under one of (a) discharged / (b) budgeted / (c) necessary axiom / (d) debt.
7+
8+
## (a) Discharged in this repo
9+
10+
- (none — entries are removed here when proofs land)
11+
12+
## (b) Budgeted — tested with refutation budget
13+
14+
- (none)
15+
16+
## (c) Necessary axiom
17+
18+
- `proofs/agda/EchoImageFactorizationPropPostulated.agda:102` — top-level
19+
`postulate` introducing four propositional-truncation primitives
20+
(`Trunc-pos`, `∣_∣-pos`, `is-prop-pos`, `rec-pos`)
21+
- **Justification**: propositional truncation `∥_∥` cannot be
22+
constructed in plain `--safe --without-K` Agda without HITs /
23+
Cubical. The four postulates encode the standard `TruncInterface ℓ`
24+
record (existence + propositionality + propositional-recursion +
25+
introduction). The construction is **exploratory** — the base
26+
module `EchoImageFactorizationProp.agda` remains `--safe
27+
--without-K` with zero postulates; `…Postulated` exists solely
28+
to demonstrate the interface concretely.
29+
- **Citation**: see `docs/echo-types/echo-kernel-note.adoc` (Tier-2
30+
classification — "Exploratory / postulated"); HoTT Book §3.7
31+
(propositional truncation); agda-stdlib does not currently expose
32+
this in `--safe --without-K`.
33+
- **Guardrail status**: explicitly allow-listed in
34+
`tools/check-guardrails.sh` and in the inline `hypatia: allow`
35+
pragma at the head of the module.
36+
37+
## (d) DEBT — actively to be closed
38+
39+
- (none — the kernel is `--safe --without-K` clean; all
40+
`…Postulated` modules are intentionally scoped to (c).)
41+
42+
## Notes
43+
44+
The `EchoDecorationBridge.agda` module is tagged exploratory in the
45+
guardrail but contains no escape hatches; it is excluded from the
46+
guardrail's "no postulates" rule for naming convenience (the
47+
`-Postulated` suffix would be misleading there). The trusted-base
48+
script does not flag this module because it scans for actual
49+
`^[[:space:]]*postulate` lines.

0 commit comments

Comments
 (0)