Commit 558f631
committed
docs: de-conflate Tangle from KRL; drop two dead Jekyll Pages workflows
Tangle, KRL and QuandleDB are three separate projects that share a subject
matter. Documentation here presented Tangle as the substrate of a KRL
compilation stack, which is not true in either direction.
README.adoc
* Retitled from "Tangle / KRL — Topological Programming Language" to
"Tangle — a general language for knot mathematics". Removed "Tangle (via
KRL — Knot Resolution Language) is ..." from the opening sentence and the
"Tangle/KRL" framing from the status and summary sections.
* Removed the architecture ladder KRL -> TangleIR -> Tangle core ->
QuandleDB + Skein.jl. `TangleIR` appears in NO source file in this
repository (0 hits across .rs, .zig and .lean) and in NO source file in the
KRL implementation. It existed only in prose, in both repositories.
* Removed the "== KRL — Knot Resolution Language" section, which restated
KRL's four operations as though KRL were this project's surface language.
Replaced with a "Relationship to KRL and QuandleDB" section stating the
three projects' actual boundaries. The relationship is left intact — what
is removed is a claimed architectural dependency that does not exist.
* Strengthened the formal-core section with a result rather than a claim: the
repository's own oracle, `cd proofs && lean Tangle.lean`, was executed on
2026-07-21 and exits 0. The proofs are self-contained (Tangle.lean has no
import lines, so no Mathlib) and contain 0 `sorry` and 0 `axiom` across
2,128 lines, with progress, preservation, determinism, type_safety,
infer_sound, infer_complete and infer_iff_hasType all carrying real proof
terms. "Builds" and "proved" coincide here, which is not automatic.
* Added an explicit note that only the Lean proofs are CI-gated: the OCaml
compiler, the Rust components and the Zig components are built by no
workflow.
AFFIRMATION.adoc
* Appended an erratum rather than editing the text. An affirmation is a dated
claim about a past state; amending it in place would falsify a record.
* Corrects the "maintainer-confirmed" stack KRL -> TangleIR -> VerisimCore ->
Skein/QuandleDB, and flags that the quotable one-line characterisation
should not be quoted while it describes Tangle as "the ... TangleIR of the
KRL stack".
* Discharges one of the affirmation's own acknowledged gaps. It recorded
"OCaml + Lean not run (absent)" and concluded "structure + the repo's proof
records are confirmed, not a fresh green build". The Lean half of that gap
is now closed, with the command and exit code recorded.
READINESS.md — grade C -> D
* Grade C means self-validated in the home context, and the D -> C trigger is
"dogfood it hard in the home context". The assessment cited exactly one
piece of dogfooding evidence: "Used internally as host for the KRL DSL".
That is false, so C is unsupported.
* "CI: Clean" was also false — main was failing Governance and both Jekyll
Pages workflows.
* The 8 OCaml test suites under compiler/test/ are real but are run by no
workflow, so their passing state is unverified by this repo's own CI.
* Recorded the verified Lean result as the evidence that does hold, and named
the cheapest uplift: add a workflow that runs `dune build && dune test`.
dialects/README.md
* Removed KRL from the dialect table. It was listed as a dialect that had
"graduated" to its own repo; it was never a Tangle dialect.
* Replaced the dead absolute path /var/mnt/eclipse/repos/krl with the GitHub
URL.
* Dropped "wire through to TangleIR" from the maturation pattern, and noted
that no dialect has yet made that journey, so there is no precedent.
* Softened the multi-DSL-host claim: the sketches set out what such a host
would cover, but nothing is implemented and nothing is built on Tangle, so
they do not yet evidence it.
Workflows
* Deleted .github/workflows/jekyll.yml and .github/workflows/jekyll-gh-pages.yml.
Both are GitHub's sample Jekyll workflows; this repository has no _config.yml
and no Gemfile, so there is no Jekyll site to build and both fail on every
push to main. pages.yml (Ddraig SSG, landed in #73) is the real one, and
three workflows were competing for the same Pages deployment.
NOTE: pages.yml will still fail at the deploy step. Its build succeeds and
certifies a11y, but GitHub Pages is not enabled for this repository —
/repos/hyperpolymath/tangle/pages returns 404, which surfaces as
"HttpError: Not Found / Creating Pages deployment failed". That is a repository
setting, not a code change, and is left for the owner.1 parent a89fd47 commit 558f631
6 files changed
Lines changed: 299 additions & 273 deletions
File tree
- .github/workflows
- dialects
This file was deleted.
This file was deleted.
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
220 | 220 | | |
221 | 221 | | |
222 | 222 | | |
| 223 | + | |
| 224 | + | |
| 225 | + | |
| 226 | + | |
| 227 | + | |
| 228 | + | |
| 229 | + | |
| 230 | + | |
| 231 | + | |
| 232 | + | |
| 233 | + | |
| 234 | + | |
| 235 | + | |
| 236 | + | |
| 237 | + | |
| 238 | + | |
| 239 | + | |
| 240 | + | |
| 241 | + | |
| 242 | + | |
| 243 | + | |
| 244 | + | |
| 245 | + | |
| 246 | + | |
| 247 | + | |
| 248 | + | |
| 249 | + | |
| 250 | + | |
| 251 | + | |
| 252 | + | |
| 253 | + | |
| 254 | + | |
| 255 | + | |
| 256 | + | |
| 257 | + | |
| 258 | + | |
| 259 | + | |
| 260 | + | |
| 261 | + | |
| 262 | + | |
| 263 | + | |
| 264 | + | |
| 265 | + | |
| 266 | + | |
| 267 | + | |
| 268 | + | |
| 269 | + | |
| 270 | + | |
| 271 | + | |
| 272 | + | |
| 273 | + | |
| 274 | + | |
| 275 | + | |
| 276 | + | |
| 277 | + | |
| 278 | + | |
| 279 | + | |
| 280 | + | |
| 281 | + | |
| 282 | + | |
| 283 | + | |
| 284 | + | |
| 285 | + | |
| 286 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
6 | 6 | | |
7 | 7 | | |
8 | 8 | | |
9 | | - | |
10 | | - | |
| 9 | + | |
| 10 | + | |
11 | 11 | | |
12 | 12 | | |
13 | | - | |
| 13 | + | |
14 | 14 | | |
15 | | - | |
16 | | - | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
17 | 18 | | |
18 | | - | |
| 19 | + | |
19 | 20 | | |
20 | | - | |
21 | | - | |
22 | | - | |
23 | | - | |
24 | | - | |
25 | | - | |
26 | | - | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
| 26 | + | |
| 27 | + | |
| 28 | + | |
| 29 | + | |
| 30 | + | |
| 31 | + | |
| 32 | + | |
| 33 | + | |
| 34 | + | |
| 35 | + | |
| 36 | + | |
| 37 | + | |
| 38 | + | |
| 39 | + | |
| 40 | + | |
| 41 | + | |
| 42 | + | |
| 43 | + | |
| 44 | + | |
| 45 | + | |
| 46 | + | |
| 47 | + | |
| 48 | + | |
| 49 | + | |
| 50 | + | |
| 51 | + | |
| 52 | + | |
| 53 | + | |
| 54 | + | |
| 55 | + | |
| 56 | + | |
| 57 | + | |
| 58 | + | |
| 59 | + | |
| 60 | + | |
| 61 | + | |
| 62 | + | |
| 63 | + | |
| 64 | + | |
| 65 | + | |
| 66 | + | |
| 67 | + | |
| 68 | + | |
| 69 | + | |
| 70 | + | |
| 71 | + | |
| 72 | + | |
| 73 | + | |
| 74 | + | |
| 75 | + | |
| 76 | + | |
| 77 | + | |
| 78 | + | |
| 79 | + | |
| 80 | + | |
| 81 | + | |
| 82 | + | |
27 | 83 | | |
28 | 84 | | |
29 | 85 | | |
| 86 | + | |
| 87 | + | |
| 88 | + | |
| 89 | + | |
| 90 | + | |
| 91 | + | |
| 92 | + | |
| 93 | + | |
| 94 | + | |
30 | 95 | | |
| 96 | + | |
31 | 97 | | |
32 | | - | |
33 | | - | |
34 | 98 | | |
35 | 99 | | |
36 | 100 | | |
37 | 101 | | |
| 102 | + | |
38 | 103 | | |
39 | 104 | | |
40 | | - | |
| 105 | + | |
| 106 | + | |
| 107 | + | |
41 | 108 | | |
42 | | - | |
43 | | - | |
44 | | - | |
45 | | - | |
46 | | - | |
| 109 | + | |
| 110 | + | |
| 111 | + | |
| 112 | + | |
| 113 | + | |
| 114 | + | |
| 115 | + | |
| 116 | + | |
| 117 | + | |
47 | 118 | | |
48 | 119 | | |
49 | 120 | | |
50 | | - | |
| 121 | + | |
0 commit comments