Skip to content

Commit dd39969

Browse files
committed
docs(grounding): align KRL ops + stack diagram to canonical spec
- KRL four-operation table reworded to the canonical verb glosses (construct/transform/resolve/retrieve) and KRL described as a resolution DSL, not merely a query language; add the Retrieve clause (Retrieve recovers resolution-relevant artefacts, not arbitrary querying). - Architecture diagram: replace the stale 'VerisimCore (categorical abstraction)' layer with 'Tangle core', matching this repo's own ECOSYSTEM.a2ml/ANCHOR.a2ml and the canonical stack (KRL -> TangleIR -> Tangle core -> QuandleDB + Skein.jl). Verisim/VCL is a distinct paradigm and does not belong inside the KRL stack diagram. Cross-refs krl docs/decisions/0002-query-language-deferred.adoc. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017TXizM5c1Yd9HWf7Y15YH2
1 parent d4bc456 commit dd39969

1 file changed

Lines changed: 15 additions & 10 deletions

File tree

README.adoc

Lines changed: 15 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,8 @@ This aligns with concepts from:
5050

5151
== KRL — Knot Resolution Language
5252

53-
KRL is the surface language used to interact with the system.
53+
KRL is the surface language used to interact with the system — a *resolution DSL*,
54+
*not merely* a query language.
5455

5556
It is organised around four fundamental operations:
5657

@@ -59,19 +60,23 @@ It is organised around four fundamental operations:
5960
|Operation |Role
6061

6162
|Construct
62-
|Build structured objects (tangles, compositions)
63+
|Create or declare presentations, structures, claims, datasets
6364

6465
|Transform
65-
|Rewrite structures (e.g. simplification, normalisation)
66+
|Rewrite, normalize, compose, concatenate, permute, mutate
6667

6768
|Resolve
68-
|Determine equivalence classes
69+
|Decide / disambiguate / evaluate equivalence or identity questions
6970

7071
|Retrieve
71-
|Query objects by invariants or structure
72+
|Inspect, fetch, project, explain, or return stored/computed results
7273
|===
7374

74-
KRL is not a general-purpose language; it is a *domain language for structured objects and their equivalence*.
75+
KRL is not a general-purpose language; it is a *domain language for structured
76+
objects and their equivalence*. *Retrieve* recovers resolution-relevant artefacts
77+
(presentations, invariants, witnesses, equivalence classes, prior resolutions,
78+
explanations, provenance) — it is *not* arbitrary database querying. See krl
79+
`docs/decisions/0002-query-language-deferred.adoc`.
7580

7681
---
7782

@@ -81,13 +86,13 @@ Tangle is part of a layered system:
8186

8287
---
8388

84-
KRL (surface language)
89+
KRL (surface language — resolution DSL, not merely a query language)
8590
86-
TangleIR (canonical representation)
91+
TangleIR (canonical interchange representation)
8792
88-
VerisimCore (categorical abstraction)
93+
Tangle core (this repo — proven type-safe small-step semantics)
8994
90-
Skein / QuandleDB (storage and equivalence)
95+
QuandleDB + Skein.jl (persistence + invariant/equivalence; computational engine)
9196
-------------------------------------------
9297
9398
* *TangleIR* is the central representation shared across layers

0 commit comments

Comments
 (0)