Skip to content

Commit 2d2a6fb

Browse files
committed
docs: add skepticisms, paper spine, proof obligations and rewrite README
This completes the conservative repository reorganisation. It adds the explicitly required skepticism documents, the proof obligations ledger, and the short paper spine. The README has been entirely rewritten to introduce the tiny mechanically checked core first, placing all exploratory, bridge, and retracted material under strictly labeled sections. The Justfile is updated to correctly test the new module paths.
1 parent 99864b5 commit 2d2a6fb

8 files changed

Lines changed: 161 additions & 173 deletions

File tree

Justfile

Lines changed: 7 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -3,16 +3,13 @@
33
# Build all echo type modules
44
build-echo:
55
@echo "Building echo type modules..."
6-
for f in proofs/agda/Echo*.agda; do \
7-
echo "Building $$f..." && \
8-
agda -i proofs/agda "$$f" || exit 1 \
9-
done
6+
agda -i proofs/agda proofs/agda/All.agda
107
@echo "✅ All echo modules built successfully"
118

129
# Build stability tests
1310
build-tests:
1411
@echo "Building stability tests..."
15-
agda -i proofs/agda proofs/agda/EchoStabilityTests.agda
12+
agda -i proofs/agda proofs/agda/Echo/Bridges/EchoStabilityTests.agda
1613
@echo "✅ Stability tests built successfully"
1714

1815
# Run comprehensive build
@@ -26,31 +23,31 @@ build-all:
2623

2724
test-core:
2825
@echo "Testing core echo type properties..."
29-
agda -i proofs/agda proofs/agda/Echo.agda
26+
agda -i proofs/agda proofs/agda/Echo/Core.agda
3027
@echo "✅ Core tests passed"
3128

3229
# Test CNO bridge
3330
test-cno:
3431
@echo "Testing CNO bridge..."
35-
agda -i proofs/agda proofs/agda/EchoCNOBridge.agda
32+
agda -i proofs/agda proofs/agda/Echo/Bridges/EchoCNOBridge.agda
3633
@echo "✅ CNO bridge tests passed"
3734

3835
# Test thermodynamic bridge
3936
test-thermo:
4037
@echo "Testing thermodynamic bridge..."
41-
agda -i proofs/agda proofs/agda/EchoThermodynamics.agda
38+
agda -i proofs/agda proofs/agda/Echo/Bridges/EchoThermodynamics.agda
4239
@echo "✅ Thermodynamic tests passed"
4340

4441
# Test categorical bridge
4542
test-cat:
4643
@echo "Testing categorical bridge..."
47-
agda -i proofs/agda proofs/agda/EchoCategory.agda
44+
agda -i proofs/agda proofs/agda/Echo/Bridges/EchoCategorical.agda
4845
@echo "✅ Categorical tests passed"
4946

5047
# Test stability suite
5148
test-stability:
5249
@echo "Testing stability suite..."
53-
agda -i proofs/agda proofs/agda/EchoStabilityTests.agda
50+
agda -i proofs/agda proofs/agda/Echo/Bridges/EchoStabilityTests.agda
5451
@echo "✅ Stability tests passed"
5552

5653
# Run all tests

README.md

Lines changed: 49 additions & 163 deletions
Large diffs are not rendered by default.
Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
# Failure Conditions
2+
3+
## The Skeptical Position
4+
Any formalism can be made to work on trivial examples. The true test of a theory is its boundary conditions and where it breaks down.
5+
6+
## Explicit Failure Modes
7+
8+
1. **Abstraction Leaks:** If users must constantly unwrap the `Echo` to perform standard proofs, the abstraction has failed.
9+
2. **Combinatorial Explosion:** If composing two lossy operations `f` and `g` results in an unmanageably complex nested `Echo`, the theory is not compositionally viable.
10+
3. **Triviality:** If the only provable theorems are isomorphic to `f x ≡ f x`, the theory lacks predictive power.
11+
4. **Lack of Separation:** If the "residue" cannot be meaningfully separated from the full "echo" in a proof-relevant way (e.g., if extracting the constraint requires keeping the entire original witness), then the claim of "partial recovery" is false.
12+
13+
## The Burden of Proof
14+
The repository must provide mechanically checked counter-examples to these failure modes, specifically demonstrating non-trivial composition, manageable complexity, and strict separation of residues.
Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
# Is this just Fibers?
2+
3+
## The Skeptical Position
4+
Yes, structurally, an `Echo` is just a standard homotopy fiber: `Σ A (λ x → f x ≡ y)`. There is no novel syntactic or type-theoretic construction here. If treated purely structurally, there is nothing new.
5+
6+
## The Burden of Proof
7+
The burden of proof lies in demonstrating that treating this specific fiber as a first-class object of study—specifically framing it as "structured loss" or a "retained constraint" over a projection—yields results that are practically obscured when treating it just as a generic pullback over a point.
8+
9+
## Collapse Conditions
10+
If the resulting theorems are identical in both form and usage to standard lemmas about HoTT fibers (e.g., contractibility of fibers for equivalences), then the "Echo" terminology is an unnecessary renaming and should be collapsed back to standard fiber theory.
11+
12+
## Reinterpretation vs. Novelty
13+
The claim is *not* mathematical novelty of the definition. The claim is that identifying this structure as a computational artifact of irreversible processes (rather than just a topological invariant) exposes a class of practically useful "residue" theorems that standard literature ignores.
Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
# Is this just Sigma Types?
2+
3+
## 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.
5+
6+
## 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.
8+
9+
## 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.
11+
12+
## 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.
Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
# What is actually new?
2+
3+
## The Skeptical Position
4+
Type theory has had fibers, sigma types, and pullbacks since its inception. Categorical logic has well-understood models for irreversibility.
5+
6+
## The Burden of Proof
7+
We must prove that "Echo Types" provide a formally verified vocabulary for *partial recovery* and *provenance* that is significantly more ergonomic or insightful than existing encodings.
8+
9+
## Collapse Conditions
10+
If the "Echo" approach does not scale to practical examples (like lossy boolean classification or quotienting) without degenerating into unreadable equality proofs, it is not a useful contribution. If it is exactly isomorphic to a known, established approach (e.g., standard refinement types) without offering new insights, it is redundant.
11+
12+
## Reinterpretation vs. Novelty
13+
The mathematical foundation is entirely standard. The potential novelty is the formalisation of "structured loss"—treating the irreversible destruction of information as a first-class object that leaves a proof-relevant, computable residue, rather than merely a forgotten input.

docs/paper-spine.md

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
# Paper Spine
2+
3+
## 1. Problem
4+
Standard formalisms prioritize reversible or perfectly linear systems where no information is lost, or simply discard lost information entirely in irreversible systems. There is no first-class treatment for *structured* loss where the fact of the loss and a constraint on what was lost are retained.
5+
6+
## 2. Observation
7+
When a non-injective function collapses distinct inputs to the same output, the fiber over that output contains the exact witness of the collapse. Treating this fiber not as a topological artifact but as a computational "echo" provides a formal vocabulary for partial recovery.
8+
9+
## 3. Definition
10+
Given `f : A → B`, the echo at `y : B` is defined as:
11+
`Echo f y := Σ (x : A) , (f x ≡ y)`
12+
13+
## 4. Why ordinary fibers are insufficient
14+
While structurally identical to homotopy fibers, ordinary fibers are rarely studied as carriers of programmatic provenance or computational residue. The "Echo" vocabulary shifts the focus from equivalence proofs to epistemic constraints and non-injective bounds.
15+
16+
## 5. Characteristic theorem candidates
17+
- `collapse-non-injective`: Explicit witnesses of irreversible collapse.
18+
- `no-section-visible`: It is impossible to fully reconstruct the input from the output alone.
19+
- `visible-constraint`: Projection-style structured loss retains a provable constraint on the original state.
20+
21+
## 6. Canonical example
22+
Lossy boolean classification (`true` and `false` collapsing to `unit`), demonstrating distinct echoes over the same visible value.
23+
24+
## 7. Failure conditions
25+
If the echo type requires constant manual unwrapping to the underlying sigma type, or if compositional complexity explodes, the abstraction fails.
26+
27+
## 8. Bridge roadmap
28+
Future exploratory work includes bridging this minimal core to thermodynamic costs, tropical semantics, and choreographic state tracking.

docs/proof-obligations.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
# Proof Obligation Ledger
2+
3+
## Foundational Core
4+
- **Echo Introduction:** PROVED (`echo-intro`)
5+
- **Map Over:** PROVED (`map-over`)
6+
- **Composition Law:** PROVED (`map-over-comp`)
7+
- **Identity Law:** PROVED (`map-over-id`)
8+
9+
## Characteristic Theorems
10+
- **Non-injectivity of collapse:** PROVED (`collapse-non-injective`)
11+
- **No-section for visible output:** PROVED (`no-section-visible`)
12+
- **No-section for weakened residue:** PROVED (`no-section-weaken`)
13+
- **Distinct echoes over same base:** PROVED (`echo-true≢echo-false`)
14+
- **Retained constraint for projection:** PROVED (`visible-constraint`)
15+
16+
## Bridges & Extensions (Speculative / Exploratory)
17+
- **Graded Comonad Framing:** RETRACTED (This is a thin-poset action, not a comonad. See `docs/retracted/retractions.adoc`)
18+
- **Universal Property / Terminal Cone:** RETRACTED (Requires funext, not natively constructible. See `docs/retracted/retractions.adoc`)
19+
- **Conservativity Claims:** RETRACTED
20+
- **Two-Models Framing:** RETRACTED
21+
- **CNO Bridge (Absolute Zero):** PARTIAL
22+
- **JanusKey Integration:** PARTIAL
23+
- **Tropical Semantics (Argmin residues):** PARTIAL
24+
- **Buchholz/Veblen Ordinal Representation:** BLOCKED (Well-foundedness of shared-binder cases blocked on self-lift)

0 commit comments

Comments
 (0)