Skip to content

Commit 7d2f638

Browse files
committed
docs: add cubical tooling stance
1 parent 4a97f93 commit 7d2f638

5 files changed

Lines changed: 83 additions & 0 deletions

File tree

README.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -147,6 +147,13 @@ cd /var/mnt/eclipse/repos/echo-types
147147
agda -i proofs/agda proofs/agda/All.agda
148148
```
149149

150+
## Tooling Stance
151+
152+
- default development stays plain Agda with the standard library
153+
- optional exploratory work may use Agda's built-in `--cubical` mode plus the separate Cubical Agda library
154+
- adjacent cubical systems such as `RedPRL`, `redtt`, and `cooltt` are tracked as references, not as active proof infrastructure for this repo
155+
- see `roadmap.adoc` (`R2`) and `docs/adjacency/cubical-systems.adoc`
156+
150157
## Roadmap
151158

152159
Proof milestones and decision gates are in:

docs/adjacency/README.adoc

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,9 @@ survives the test — in which case the identity claim is retracted per
4242

4343
| link:provenance-semirings.adoc[Provenance semirings]
4444
| `K`-annotated tuples tracked through relational algebra.
45+
46+
| link:cubical-systems.adoc[Cubical systems]
47+
| Cubical Agda, `RedPRL`, `redtt`, `cooltt` as higher-dimensional equality frameworks.
4548
|===
4649

4750
== Reading order
Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
= Adjacency: Cubical Systems
2+
:toc: macro
3+
4+
toc::[]
5+
6+
== 1. Nearest existing constructions
7+
8+
The nearest cubical-side systems for this repository are:
9+
10+
* Cubical Agda: Agda's built-in `--cubical` mode plus the separate
11+
Cubical Agda library.
12+
* `RedPRL`: a tactic-oriented assistant for computational Cartesian
13+
cubical type theory.
14+
* `redtt` and `cooltt`: experimental cubical proof assistants /
15+
typecheckers.
16+
17+
For this repository, Cubical Agda is the closest operational neighbour:
18+
it preserves the Agda language and keeps the migration cost lower than a
19+
move to a different prover.
20+
21+
== 2. What do they add?
22+
23+
* First-class path/cubical equality and higher-dimensional structure.
24+
* Higher inductive and quotient-like reasoning that plain
25+
`--safe --without-K` Agda does not provide directly.
26+
* A plausible route for roadmap item `R2` in `roadmap.adoc`: treating
27+
indistinguishability with equivalence-aware identity rather than only
28+
propositional/set-level relations.
29+
30+
== 3. What do they _not_ add?
31+
32+
* No automatic reuse guarantee for the current Buchholz work. Moving to
33+
`RedPRL`, `redtt`, or `cooltt` is a prover migration, not a local
34+
refactor.
35+
* No evidence yet that the blocked direct same-binder route in plain
36+
Agda disappears automatically in a cubical setting.
37+
* No requirement for the current echo-types evidence base, which still
38+
compiles in plain Agda with the standard library.
39+
40+
== 4. Working decision
41+
42+
* Active repository tooling stays Agda-first.
43+
* Optional exploratory extension: Agda `--cubical` plus the Cubical
44+
Agda library.
45+
* `RedPRL`, `redtt`, and `cooltt` are tracked as adjacent references,
46+
not installed or required for normal builds.
47+
48+
== 5. Why this matters here
49+
50+
Cubical systems may matter later for quotient-like or
51+
equivalence-sensitive extensions of echo types, especially roadmap item
52+
`R2`. They are not part of the evidential base for the current identity
53+
claim. That claim still stands or falls on the plain-Agda development
54+
already in the repository.
55+
56+
== 6. References
57+
58+
* Cubical Agda library: `https://github.com/agda/cubical`
59+
* `RedPRL` family: `https://redprl.org/`

readme.adoc

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -163,6 +163,13 @@ cd /var/mnt/eclipse/repos/echo-types
163163
agda -i proofs/agda proofs/agda/All.agda
164164
----
165165

166+
== Tooling Stance
167+
168+
* default development stays plain Agda with the standard library
169+
* optional exploratory work may use Agda's built-in `--cubical` mode plus the separate Cubical Agda library
170+
* adjacent cubical systems such as `RedPRL`, `redtt`, and `cooltt` are tracked as references, not as active proof infrastructure for this repo
171+
* see `roadmap.adoc` (`R2`) and `docs/adjacency/cubical-systems.adoc`
172+
166173
== Roadmap
167174

168175
Proof milestones and decision gates are in:

roadmap.adoc

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -437,6 +437,13 @@ R2. Cubical or quotient treatment of indistinguishability
437437
constructions commute with equivalence-class semantics.
438438
* Difficulty: very hard. Parked: requires moving off plain
439439
`--safe --without-K` into cubical agda or a heavy quotient layer.
440+
* Current tooling stance (2026-04-23):
441+
** active development remains plain Agda with the standard library
442+
** if `R2` is activated, the first extension to try is Agda's
443+
`--cubical` mode plus the separate Cubical Agda library
444+
** `RedPRL`, `redtt`, and `cooltt` are tracked as adjacent cubical
445+
systems, not as primary tooling for this roadmap; see
446+
`docs/adjacency/cubical-systems.adoc`
440447

441448
R3. Probabilistic epistemic echoes
442449

0 commit comments

Comments
 (0)