Skip to content

Commit 6373d1d

Browse files
hyperpolymathclaude
andcommitted
docs: consolidate 5 roadmaps into single canonical roadmap.adoc; promote Echo-vs-Σ skepticism into reviewer-facing answer
Roadmap consolidation - Delete 4 overlapping roadmap docs (docs/echo-types/roadmap.md, docs/PRIORITIZED_PROOF_ROADMAP.md, docs/ProofRoadmap.md, docs/WORK_PLAN.md). - Rewrite roadmap.adoc as the single canonical roadmap: 5-lane tracker with falsifiable close-out criteria audited at every rung consolidation, gates summary, pillar status, M1-M13 historical milestone log, R1-R4 deferred research preserved, lane discipline rules, retraction-watch lines per lane. - Lane 1 (load-bearing) = expeditious type-theoretic grounding alongside choreographic / linear / graded modal types. Lane 3 (Ordinal/Buchholz) explicitly parallel-independent: Echo Core does NOT depend on it. README + readme.adoc Status Snapshot restructure - Split into "Echo Core" and "Ordinal / Buchholz" as parallel- independent tracks with explicit non-dependency banner. Buchholz modules marked experimental until unbudgeted wf-<ᵇʳᶠ_ closure lands. Roadmap section points only at roadmap.adoc and its companion docs (roadmap-gates.adoc, establishment-plan.adoc, buchholz-plan.adoc, taxonomy.md, composition.md). Echo-vs-Σ identity claim (Track A) - Promote core/skepticisms/is-this-just-sigma-types.md from 14-line stub into canonical Echo-vs-Σ map. Five sections mirroring the sceptic demands: irreversibility-as-theorem-family, algebra of loss, categorical identity + bridges, abstraction barrier (consumer-side), canonical examples. Each section cross-links Agda lemmas + Smoke pins + adjacency notes. - Add docs/echo-types/sigma-distinctness-map.adoc as reviewer-facing AsciiDoc companion (same 5-section structure, heavier cross-refs to gates and pillars). - Add no-section family and degrade-laws aggregate rows to docs/theorem-index.md. - Cross-link from roadmap-gates.adoc Gate 2 and docs/characteristic.adoc §"Inherited spec". Cross-ref sweep - 17 files redirected from the 4 deleted roadmap docs to roadmap.adoc (or to more specific surviving docs where the original reference was content-specific). Covers CLAUDE.md, READMEs, MAP.adoc, decision docs, Agda module comments, bridge docs. Retraction discipline - All prose stays inside R-2026-05-18 narrowed claims: no full universal property (only funext-relative pointwise mediator), no graded comonad (only thin-poset reindexing modality), no model- independence (only carrier-parametricity over a fixed grade poset), no Reynolds parametricity (only consumer-side free theorem at the affine instance, planned in Track B). Net diffstat: +711 / -1937 across 25 files. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent f0b3482 commit 6373d1d

26 files changed

Lines changed: 900 additions & 1937 deletions

CLAUDE.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -176,7 +176,7 @@ work to `main` and refresh all documentation:
176176
dependency order. Resolve any conflicts (typically additive, in
177177
`Smoke.agda` and `All.agda`).
178178
3. **Update human docs.** `docs/echo-types/composition.md`,
179-
`docs/echo-types/roadmap.md`, `docs/echo-types/overview.md` and
179+
`roadmap.adoc`, `docs/echo-types/overview.md` and
180180
`cross-repo-bridge-status.md` get a sweep for stale `(Open)` /
181181
`[unblocked]` tags on anything that just landed. Honest labels:
182182
`(Landed)`, `(Partial)`, `(Open)`.
@@ -503,7 +503,8 @@ coeffects, lens/optic vs the witness-transport leg); (3) evaluation
503503
(proof-size/cost table; quantify common-upper-bound idiom vs naive
504504
`subst`); (4) ordinal consumer-evidence appendix — GATED on the
505505
ordinal track hitting Bachmann–Howard, keep firewalled per
506-
`roadmap.md`. THEN offline/author-driven only (venue+template,
506+
`roadmap.adoc` §Lane 3 (Ordinal track) and `docs/buchholz-plan.adoc`.
507+
THEN offline/author-driven only (venue+template,
507508
Zenodo DOI, library packaging, outreach) — flag to the user, do NOT
508509
auto-run. Strategy (user decision 2026-05-17): the paper was written
509510
now at full narrative strength while fresh; expand the tagged
@@ -590,7 +591,8 @@ tags as material becomes available, in this order:
590591
3. Evaluation — proof-size/cost table; quantify
591592
common-upper-bound-idiom vs naive `subst`.
592593
4. Ordinal consumer-evidence appendix — gated on that track hitting
593-
its Bachmann–Howard milestone (firewalled per roadmap.md).
594+
its Bachmann–Howard milestone (firewalled per `roadmap.adoc`
595+
§Lane 3 and `docs/buchholz-plan.adoc`).
594596
5. THEN offline/author-driven: venue+template, Zenodo DOI, library
595597
packaging, outreach — flag to user, do NOT auto-run.
596598

DOCUMENTATION_STATUS.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66

77
1. **Core Bridge Documentation**
88
- `docs/EchoJanusBridge.md` - Comprehensive explanation of echo types → JanusKey bridge
9-
- `docs/ProofRoadmap.md` - Strategic proof development roadmap
9+
- `roadmap.adoc` §"Deferred research track" - Strategic proof development roadmap (consolidated from former `docs/ProofRoadmap.md`)
1010
- `docs/COMPREHENSIVE_DOCUMENTATION.md` - Complete 3-2-1 structured documentation
1111

1212
2. **Formal Proofs**
@@ -84,7 +84,7 @@
8484
- [x] Create `EchoJanusBridge.agda` with core theorems
8585
- [x] Update `All.agda` to include new module
8686
- [x] Write `EchoJanusBridge.md` documentation
87-
- [x] Create `ProofRoadmap.md` for future work
87+
- [x] Consolidate `ProofRoadmap.md` into `roadmap.adoc` (single canonical roadmap)
8888
- [x] Develop `COMPREHENSIVE_DOCUMENTATION.md` (3-2-1 structure)
8989
- [x] Verify Agda proofs compile successfully
9090
- [ ] Add architecture diagrams

README.md

Lines changed: 41 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -79,16 +79,39 @@ Scope-broadening stages now include:
7979
- indexed/relational/categorical packaging (`EchoIndexed`, `EchoRelational`, `EchoCategorical`, `EchoScope`)
8080
- cross-ecosystem bridges (`EchoCNOBridge`, `EchoJanusBridge`, `DyadicEchoBridge`, `EchoOrdinal`)
8181

82-
## Current Status Snapshot (2026-04-23)
82+
## Current Status Snapshot
83+
84+
The repository runs **two parallel, independent tracks**. *Echo Core does
85+
NOT depend on the Ordinal / Buchholz track.* A reader interested only
86+
in echo types as a type-theoretic concept can ignore the Ordinal track
87+
entirely; it lives in `proofs/agda/Ordinal/` and is documented under
88+
`roadmap.adoc` §Lane 3.
89+
90+
### Echo Core (load-bearing for the identity claim)
8391

8492
On `main`, the following are true:
8593

8694
- full suite compiles: `agda -i proofs/agda proofs/agda/All.agda`
8795
- core echo/fiber laws are smoke-pinned (`echo-intro`, `map-over`, `map-over-id`, `map-over-comp`, `map-square`)
8896
- non-injectivity/no-section family is present (`collapse-non-injective`, `no-section-collapse`, `no-section-visible`, `no-section-collapse-to-residue`, `no-section-weaken`)
8997
- distinct-witness and retained-constraint exemplars are present (`echo-true≢echo-false`, `stateA≢stateB`, `visible-constraint`)
98+
- degrade-law family lands across decoration layers (graded, linear/affine, choreographic, access, cost, search); see `docs/theorem-index.md` for the aggregate
99+
- Pillars A–D of the establishment plan are LANDED (with R-2026-05-18 narrowings; see `docs/retractions.adoc`); Pillar E (paper) is in progress
100+
101+
Per-lane status, close-out criteria, and the identity-claim verdict
102+
per tag are in `roadmap.adoc`.
90103

91-
Ordinal/Buchholz track status:
104+
### Ordinal / Buchholz (parallel-independent, experimental)
105+
106+
> **Banner.** This track is a separate proof-theoretic research project
107+
> living in the same repository. Echo Core does not depend on it.
108+
> Modules under `proofs/agda/Ordinal/` are treated as **experimental**
109+
> until the unbudgeted `wf-<ᵇʳᶠ_` closure lands. See `roadmap.adoc`
110+
> §Lane 3 for status and close-out criterion; `docs/buchholz-plan.adoc`
111+
> for the full plan.
112+
113+
Current state (one-line summary; the full per-rung ledger lives in
114+
CLAUDE.md):
92115

93116
- `Ordinal.Buchholz.WellFounded` provides `wf-<ᵇ : WellFounded _<ᵇ_` for the currently admitted constructor core
94117
- top-marker `bplus` bridges are admitted and inverted: `<ᵇ-+ω`, `<ᵇ-+ψω`, `<ᵇ-inv-+Ωω`, `<ᵇ-inv-+ψω`
@@ -131,7 +154,7 @@ Cross-repo status:
131154
- Agda-side content-bridge `proofs/agda/EchoCNOBridge.agda` imports `IsCNO` directly from `absolute-zero/proofs/agda/CNO.agda` (the earlier scaffolded-adapter plan `EchoBridgeScaffold.agda` was superseded)
132155
- end-to-end conformance against upstream codebases is a separate track and is not yet fully machine-checked here
133156
- current bridge ledger: `docs/echo-types/cross-repo-bridge-status.md`
134-
- see `docs/echo-types/roadmap.md` for staged cross-repo verification gates
157+
- see `roadmap.adoc` (Lane 4) for staged cross-repo verification gates
135158

136159
## What Echo Types Are For
137160

@@ -187,16 +210,25 @@ agda -i proofs/agda proofs/agda/All.agda
187210

188211
## Roadmap
189212

190-
Proof milestones and decision gates are in:
213+
Single canonical roadmap with lane tracker, gates summary, pillar
214+
status, deferred-research track, and operating rules:
191215

192216
- `roadmap.adoc`
193-
- `docs/buchholz-plan.adoc`
194217

195-
Open/gated work and cross-repo follow-ups are tracked in:
218+
Companions (different kinds of doc, not roadmaps):
219+
220+
- `roadmap-gates.adoc` — identity-claim falsifier gates (Gate 1/2/3)
221+
- `docs/echo-types/establishment-plan.adoc` — five-pillar plan to
222+
recognised type-theoretic standing
223+
- `docs/buchholz-plan.adoc` — Ordinal track plan (parallel-independent
224+
lane; see roadmap.adoc §Lane 3)
225+
- `docs/echo-types/taxonomy.md`, `docs/echo-types/composition.md`
226+
topical reference
196227

197-
- `docs/echo-types/roadmap.md`
198-
- `docs/echo-types/taxonomy.md`
199-
- `docs/echo-types/composition.md`
228+
As of 2026-05-26 the four previously overlapping roadmap docs
229+
(`docs/echo-types/roadmap.md`, `docs/PRIORITIZED_PROOF_ROADMAP.md`,
230+
`docs/ProofRoadmap.md`, `docs/WORK_PLAN.md`) have been consolidated
231+
into `roadmap.adoc` and removed.
200232

201233
## Licensing
202234

Lines changed: 153 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,162 @@
11
# Is this just Sigma Types?
22

33
## The Skeptical Position
4-
Yes, at the lowest level of Agda code, this is `Σ (x : A) , (f x ≡ y)`. It relies entirely on the standard dependent pair type and propositional equality.
4+
Yes, at the lowest level of Agda code, this is `Σ (x : A) , (f x ≡ y)`.
5+
It relies entirely on the standard dependent pair type and propositional
6+
equality.
57

68
## The Burden of Proof
7-
Any claim of utility must show why working with the `Echo` wrapper is better than directly pattern-matching on the Sigma type. If every proof immediately unpacks the `Echo` and does standard Sigma-type manipulation, the abstraction is leaky and pointless.
9+
Any claim of utility must show why working with the `Echo` wrapper is
10+
better than directly pattern-matching on the Sigma type. If every proof
11+
immediately unpacks the `Echo` and does standard Sigma-type manipulation,
12+
the abstraction is leaky and pointless.
813

914
## Collapse Conditions
10-
If the `Echo` interface requires the user to manually manage the underlying `Σ` structure to accomplish basic composition or mapping tasks, the abstraction fails.
15+
If the `Echo` interface requires the user to manually manage the
16+
underlying `Σ` structure to accomplish basic composition or mapping
17+
tasks, the abstraction fails.
1118

1219
## Reinterpretation vs. Novelty
13-
The novelty must reside in the API and the categorical/compositional properties exposed by the wrapper, demonstrating that `Echo` behaves coherently under lossy operations in a way that bare Sigma types do not automatically communicate.
20+
The novelty must reside in the API and the categorical/compositional
21+
properties exposed by the wrapper, demonstrating that `Echo` behaves
22+
coherently under lossy operations in a way that bare Sigma types do not
23+
automatically communicate.
24+
25+
---
26+
27+
## Answer: the in-tree evidence
28+
29+
This section is the index reviewers can walk to confirm Echo is not
30+
"renamed Σ". It is organised under five demands a sceptic typically
31+
makes. Each item points at a machine-checked Agda artefact (pinned in
32+
`proofs/agda/Smoke.agda`), a doc, or both. Statements stay inside the
33+
*narrowed* claims of `docs/retractions.adoc` R-2026-05-18 — no "full
34+
universal property", no "graded comonad", no "model-independence".
35+
36+
### 1. Irreversibility is a theorem family, not a property
37+
38+
A raw `Σ (x : A) (f x ≡ y)` gives `proj₁` trivially; the user can
39+
always extract the original `x`. The Echo programme proves that *no*
40+
section exists once specific lossy interfaces are applied. The witness
41+
is a *family* across five separate decoration layers:
42+
43+
- `EchoCharacteristic.no-section-collapse` — no section of the
44+
`Bool → ⊤` collapse map.
45+
- `EchoCharacteristic.no-section-visible` — no section recovering the
46+
pre-image from a visible output alone.
47+
- `EchoResidue.no-section-collapse-to-residue` — weakening to a residue
48+
is provably one-way.
49+
- `EchoLinear.no-section-weaken` — the `linear → affine` mode shift is
50+
one-way (defined as the residue lemma).
51+
- `EchoOrdinal.no-section-ordinal-collapse` — ordinal collapse case.
52+
- `EchoEpistemicResidue.no-section-to-epistemic` — epistemic-residue
53+
case.
54+
55+
All six are pinned in `Smoke.agda`. The family is what carries the
56+
weight: each decoration *separately* refuses the section that a raw Σ
57+
would admit. See also `docs/theorem-index.md` and the prose write-up at
58+
`docs/characteristic.adoc`.
59+
60+
### 2. Loss is graded, and downgrades cannot be reversed
61+
62+
A raw Σ has no built-in notion of "degrading from strict to loose".
63+
Echo equips the fibre with a lattice of grades and a monotone reindexing
64+
along it. The two halves of the asymmetry are:
65+
66+
- *Down-step is admissible.* `EchoGraded.degrade-compose` and
67+
`EchoGraded.degrade-via-join` — the per-decoration composition law
68+
for the loss-grade order. Same recipe lands at:
69+
- `EchoLinear.degradeMode-compose` (linearity-mode order),
70+
- `EchoChoreo.applyChoreo-compose` (role/reachability order),
71+
- `EchoAccess` (graded access modality),
72+
- `EchoCost` (cost-indexed refinement),
73+
- `EchoSearch` (witness-search refinement).
74+
- *Up-step is not.* `no-section-weaken` (item 1) is the same
75+
statement on the other diagonal — once degraded, no inverse exists.
76+
77+
Honest framing: this is a *thin-poset reindexing modality*, not a
78+
graded comonad. The retraction at `docs/retractions.adoc#R-2026-05-18`
79+
narrowed an earlier "graded comonad" claim. The reindexing modality is
80+
the load-bearing structure and is the right answer to "is Σ enough?":
81+
Σ alone gives neither the monotone reindex nor the no-section dual.
82+
83+
### 3. Echo is the homotopy fibre; bridges from other "loss-tracker" frameworks exist
84+
85+
The categorical/identity claim is **deflationary** and owned in
86+
`docs/echo-types/establishment-plan.adoc`: `Echo f y` is *definitionally*
87+
the homotopy fibre `fib f y` (HoTT book Def. 4.2.4). The bridge is
88+
`EchoFiberBridge.echo↔fib`, both round-trips `refl` (Pillar A; pinned
89+
in `Smoke.agda`).
90+
91+
For the "is this just a pullback" question, `EchoPullback.echo-pullback-univ`
92+
exhibits `Echo f y` as the pullback of `f` along `y : ⊤ → B` with a
93+
*pointwise, funext-relative* mediator property. The retraction note in
94+
that module is loud: this is **not** a full categorical universal
95+
property in the absence of funext. Bridges from named neighbour
96+
frameworks land as separate modules:
97+
98+
- `EchoFiberBridge.agda` — homotopy fibre identity.
99+
- `EchoJanusBridge.agda` — Janus-style reversible debugger bridge.
100+
- `EchoTropical.agda` / `AntiEchoTropical.agda` — tropical
101+
semiring / argmin decomposition.
102+
- `EchoCNOBridge.agda` — categorical neighbour bridge.
103+
- `EchoFiberCount.agda` + `EchoThermodynamics*.agda` — finite-fibre
104+
Landauer / Bennett correspondence.
105+
106+
These are independent witnesses, not one universal theorem. The honest
107+
verdict is "Echo is *a* canonical target with concrete bridges in"
108+
rather than "Echo is *the* terminal residue tracker by unique mediator".
109+
110+
### 4. The abstraction barrier (consumer-side)
111+
112+
A raw `Σ A (λ x → f x ≡ y)` exposes `proj₁`, so a consumer can always
113+
distinguish two preimages of the same output. The Echo interface at the
114+
affine mode does not export that projection: the residue carrier is
115+
contractible (`EchoLinear.affine-canonical`, `affine-all-equal`), so
116+
any consumer assigns the same value to the weakened images of two
117+
known-distinct linear echoes.
118+
119+
**Status:** the consumer-side abstraction-barrier theorem is the one
120+
genuine gap relative to the five demands. It is planned as
121+
`proofs/agda/EchoAbstractionBarrier.agda` (Track B in the work plan).
122+
The model-side counterpart — *carrier-parametricity* over a fixed
123+
grade poset — already lands as `EchoRelModel` (Pillar D, narrowed per
124+
R-2026-05-18 from the original "model-independence" wording).
125+
126+
### 5. Canonical examples — what Σ would let through
127+
128+
The example modules exhibit echo as the explanatory unit on real
129+
artefacts:
130+
131+
- `EchoExampleParser``(())` vs `()()` are two distinct echoes at the
132+
same `parses ≡ true`.
133+
- `EchoExampleProvenance` — distinct Bool-provenance rows collapse to
134+
the same payload; the echo carries the lost annotation.
135+
- `EchoExampleAbsInt``{p1, p2}` collapse to `pos` under sign
136+
analysis; the echo retains which.
137+
- `EchoExampleSignAnalysis`, `EchoExampleTruncation` — further
138+
collapse-with-residue exhibits.
139+
- `EchoFiberCount` + `EchoThermodynamics*` — finite-fibre Landauer
140+
bound for the erasure cost.
141+
- `EchoEpistemicResidue` — observation-discipline residue.
142+
143+
Each is positive evidence. The matched *negative* — a small raw-Σ
144+
counter-program that would let the bug through — is planned as
145+
`proofs/agda/examples/EchoVsSigma.agda` (Track C). Until that lands,
146+
the "raw Σ would leak" claim is prose, not a checked artefact.
147+
148+
---
149+
150+
## Cross-references
151+
152+
- Gate 2 audit (closest reviewer touchpoint):
153+
`docs/characteristic.adoc`.
154+
- Theorem-by-theorem ledger: `docs/theorem-index.md`.
155+
- Adjacency notes (per neighbour framework): `docs/adjacency/`.
156+
- Honest scope of the establishment claim:
157+
`docs/echo-types/establishment-plan.adoc` and
158+
`docs/echo-types/paper.adoc` §"Reframing note".
159+
- AsciiDoc reviewer companion to this file:
160+
`docs/echo-types/sigma-distinctness-map.adoc`.
161+
- Companion skepticisms: `is-this-just-fibers.md`, `what-is-actually-new.md`,
162+
`failure-conditions.md`.

0 commit comments

Comments
 (0)