Skip to content

Commit 0ca8aba

Browse files
committed
docs(v3.9.1): publish the Critical Isolation documentation set + v3.10 CKN drafts; make v3.9.1 the current version
The v3.9.1 set (docs/v3.9/, 18 pages) is authored fresh against what shipped — grounded in the pgCK/cklib changelogs and the committed client specs — with 'a verb, not a query surface' as its spine, reinforced across affordances, grants, shapes, the-door, client, and critical-isolation. - Foundations: introduction, critical-isolation (the three-ring architecture), verb-vs-query-surface (the load-bearing distinction). - The kernel: concept-kernel, the-door (ckp.dispatch), seal-and-proof, shapes. - Capability & governance: affordances (the closed verb table), governance (propose → vote → apply), grants, epochs. - Naming & ontology, client (cklib), quickstart (hello-kernel), ecosystem, changelog (grounded, continuous v3.4 → v3.9.1 history). v3.10 CKN drafts (docs/v3.10/, 4 pages), each marked IN DESIGN: the notation, notation-in-construct-out, and the scoring loop. Switch-over: nav + version switcher default to v3.9.1 (current) with v3.10 'in design'; Ontology nav leads with the v3.8 runtime core; llms.txt lists the v3.9.1 set and the verb-vs-query-surface distinction; homepage refreshed to current versions (pgCK v0.4.17, 33 releases; fleet 58).
1 parent 417a54a commit 0ca8aba

26 files changed

Lines changed: 1884 additions & 14 deletions

docs/.vitepress/config.mts

Lines changed: 110 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,9 @@ export default withMermaid(defineConfig({
2424
{
2525
text: 'Docs',
2626
items: [
27-
{ text: 'v3.7 (Current)', link: '/v3.7/introduction' },
27+
{ text: 'v3.9.1 (Current)', link: '/v3.9/introduction' },
28+
{ text: 'v3.10 (In design) — CKN', link: '/v3.10/' },
29+
{ text: 'v3.7', link: '/v3.7/introduction' },
2830
{ text: 'v3.6 (Frozen)', link: '/v3.6/introduction' },
2931
{ text: 'v3.5-alpha6', link: '/v3.5-alpha6/introduction' },
3032
{ text: 'v3.5-alpha3', link: '/v3.5-alpha3/introduction' },
@@ -33,13 +35,13 @@ export default withMermaid(defineConfig({
3335
},
3436
{
3537
text: 'Ontology',
36-
link: '/ontology/v3.7/',
38+
link: '/ontology/v3.8/',
3739
items: [
3840
{ text: 'Browse Ontology', link: '/browse/index.html' },
39-
{ text: 'v3.7 (TTL) — Current', link: '/ontology/v3.7/' },
41+
{ text: 'v3.8 core (TTL) — Runtime', link: '/ontology/v3.8/' },
42+
{ text: 'v3.7 (TTL)', link: '/ontology/v3.7/' },
4043
{ text: 'v3.6 (TTL)', link: '/ontology/v3.6/' },
4144
{ text: 'v3.5-alpha6 (TTL)', link: '/ontology/v3.5-alpha6/' },
42-
{ text: 'v3.5-alpha3 (TTL)', link: '/ontology/v3.5-alpha3/' },
4345
{ text: 'v3.4 (TTL)', link: '/ontology/v3.4/' },
4446
]
4547
},
@@ -53,6 +55,110 @@ export default withMermaid(defineConfig({
5355
],
5456

5557
sidebar: {
58+
'/v3.9/': [
59+
{
60+
text: 'Part I: Foundations',
61+
items: [
62+
{ text: 'Introduction', link: '/v3.9/introduction' },
63+
{ text: 'Critical Isolation', link: '/v3.9/critical-isolation' },
64+
{ text: 'A Verb, Not a Query Surface', link: '/v3.9/verb-vs-query-surface' },
65+
]
66+
},
67+
{
68+
text: 'Part II: The Kernel',
69+
items: [
70+
{ text: 'What a Concept Kernel Is', link: '/v3.9/concept-kernel' },
71+
{ text: 'The One Door: ckp.dispatch', link: '/v3.9/the-door' },
72+
{ text: 'Seal, Ledger, Proof', link: '/v3.9/seal-and-proof' },
73+
{ text: 'Shapes (σ)', link: '/v3.9/shapes' },
74+
]
75+
},
76+
{
77+
text: 'Part III: Capability & Governance',
78+
items: [
79+
{ text: 'Affordances (α)', link: '/v3.9/affordances' },
80+
{ text: 'Governance', link: '/v3.9/governance' },
81+
{ text: 'Grants (γ)', link: '/v3.9/grants' },
82+
{ text: 'Epochs (ε)', link: '/v3.9/epochs' },
83+
]
84+
},
85+
{
86+
text: 'Part IV: Naming & Ontology',
87+
items: [
88+
{ text: 'Naming — the developer writes URN', link: '/v3.9/naming' },
89+
{ text: 'The Core Vocabulary', link: '/v3.9/ontology' },
90+
]
91+
},
92+
{
93+
text: 'Part V: Build',
94+
items: [
95+
{ text: 'The Client: cklib', link: '/v3.9/client' },
96+
{ text: 'Quickstart', link: '/v3.9/quickstart' },
97+
{ text: 'The Fleet', link: '/v3.9/ecosystem' },
98+
]
99+
},
100+
{
101+
text: 'Reference',
102+
collapsed: true,
103+
items: [
104+
{ text: 'Changelog', link: '/v3.9/changelog' },
105+
]
106+
},
107+
{
108+
text: 'Toward v3.10',
109+
items: [
110+
{ text: 'CKN — the notation', link: '/v3.10/' },
111+
]
112+
},
113+
{
114+
text: 'Ontology Files',
115+
items: [
116+
{ text: 'Browse Ontology', link: '/browse/index.html' },
117+
{ text: 'v3.8 core (Turtle)', link: '/ontology/v3.8/' },
118+
]
119+
},
120+
{
121+
text: 'Previous Versions',
122+
collapsed: true,
123+
items: [
124+
{ text: 'v3.7', link: '/v3.7/introduction' },
125+
{ text: 'v3.6 (Frozen)', link: '/v3.6/introduction' },
126+
{ text: 'v3.5-alpha6', link: '/v3.5-alpha6/introduction' },
127+
{ text: 'v3.4', link: '/v3.4/introduction' },
128+
]
129+
},
130+
{
131+
text: 'Community',
132+
items: [
133+
{ text: 'Discord', link: 'https://discord.gg/sTbfxV9xyU' },
134+
{ text: 'GitHub', link: 'https://github.com/ConceptKernel' },
135+
]
136+
}
137+
],
138+
'/v3.10/': [
139+
{
140+
text: 'CKN — Concept Kernel Notation',
141+
items: [
142+
{ text: 'Overview (in design)', link: '/v3.10/' },
143+
{ text: 'Concept Kernel Notation', link: '/v3.10/concept-kernel-notation' },
144+
{ text: 'Notation In, Construct Out', link: '/v3.10/assembled-constructs' },
145+
{ text: 'The Scoring Loop', link: '/v3.10/scoring-loop' },
146+
]
147+
},
148+
{
149+
text: 'Current runtime',
150+
items: [
151+
{ text: '← v3.9.1 (shipped)', link: '/v3.9/introduction' },
152+
]
153+
},
154+
{
155+
text: 'Community',
156+
items: [
157+
{ text: 'Discord', link: 'https://discord.gg/sTbfxV9xyU' },
158+
{ text: 'GitHub', link: 'https://github.com/ConceptKernel' },
159+
]
160+
}
161+
],
56162
'/v3.7/': [
57163
{
58164
text: 'Part I: Foundations',

docs/.vitepress/theme/VersionSwitcher.vue

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,9 @@ import { useRoute } from 'vitepress'
55
const route = useRoute()
66
77
const versions = [
8-
{ label: 'v3.7', prefix: '/v3.7/', badge: 'latest', color: '#3b82f6' },
8+
{ label: 'v3.9.1', prefix: '/v3.9/', badge: 'current', color: '#E8A832' },
9+
{ label: 'v3.10', prefix: '/v3.10/', badge: 'in design', color: '#C07840', entry: '' },
10+
{ label: 'v3.7', prefix: '/v3.7/', badge: 'frozen', color: '#3b82f6' },
911
{ label: 'v3.6', prefix: '/v3.6/', badge: 'frozen', color: '#8b5cf6' },
1012
{ label: 'v3.5-alpha6', prefix: '/v3.5-alpha6/', badge: 'stable', color: '#22c55e' },
1113
{ label: 'v3.5-alpha3', prefix: '/v3.5-alpha3/', badge: 'alpha', color: '#eab308' },
@@ -26,7 +28,7 @@ function switchTo(version) {
2628
// Always navigate to the version's introduction page to avoid 404s.
2729
// Different versions have different page structures, so trying to map
2830
// the current page path into a different version causes SPA 404 errors.
29-
window.location.href = version.prefix + 'introduction'
31+
window.location.href = version.prefix + (version.entry ?? 'introduction')
3032
}
3133
3234
function handleClickOutside(e) {

docs/public/index.html

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -398,7 +398,7 @@
398398
<nav id="site-nav">
399399
<a href="/" class="nav-brand">CONCEPT KERNEL</a>
400400
<div class="nav-links">
401-
<a href="/v3.7/introduction" class="nav-link">Docs</a>
401+
<a href="/v3.9/introduction" class="nav-link">Docs</a>
402402
<a href="#notation" class="nav-link">Notation</a>
403403
<a href="#epochs" class="nav-link">Epochs</a>
404404
<a href="/browse/index.html" class="nav-link">Browser</a>
@@ -652,7 +652,7 @@ <h2>The protocol measures<br>its own <em>becoming</em></h2>
652652
<div>
653653
<span class="ep-name"><em>Critical Isolation</em> — sovereignty on a proven engine</span>
654654
<p class="ep-what">The kernel takes root in <strong>pgRDF</strong> — RDF, SPARQL, SHACL and OWL-RL as a native PostgreSQL extension — adopting its proven discipline for storage and memory: an engine that ingested the <strong>8.2-billion-triple Wikidata</strong> dump into one instance, no sidecar store, no second service. On that engine the kernel raises a single typed door over NATS-WSS, and every landing runs validate → seal → HMAC-chained ledger → verifiable proof, in one transaction.</p>
655-
<span class="ep-stats"><b>8.2B</b> triples proven · <b>1</b> door · <b>12</b> invariants · <b>31</b> attested releases, v0.1.0 → v0.4.15</span>
655+
<span class="ep-stats"><b>8.2B</b> triples proven · <b>1</b> door · <b>12</b> invariants · <b>33</b> attested releases, v0.1.0 → v0.4.17</span>
656656
</div>
657657
</div>
658658
<div class="epoch">
@@ -677,9 +677,9 @@ <h2>The protocol measures<br>its own <em>becoming</em></h2>
677677
<div class="stat"><span class="stat-n">1</span><span class="stat-l">typed door<br>ckp.dispatch</span></div>
678678
<div class="stat"><span class="stat-n">17</span><span class="stat-l">verbs — the whole<br>client vocabulary</span></div>
679679
<div class="stat"><span class="stat-n">12</span><span class="stat-l">invariants<br>demonstrated</span></div>
680-
<div class="stat"><span class="stat-n">56</span><span class="stat-l">versioned releases<br>across the fleet</span></div>
680+
<div class="stat"><span class="stat-n">58</span><span class="stat-l">versioned releases<br>across the fleet</span></div>
681681
</div>
682-
<p style="font-family:'JetBrains Mono',monospace;font-size:.62rem;color:var(--text3);text-align:center;letter-spacing:.08em">runtime v0.1.0→v0.4.15 (31) · client v1.0.0→v1.5.3 (25) · CI-built, SLSA-attested heads, verified before publication</p>
682+
<p style="font-family:'JetBrains Mono',monospace;font-size:.62rem;color:var(--text3);text-align:center;letter-spacing:.08em">runtime v0.1.0→v0.4.17 (33) · client v1.0.0→v1.5.3 (25) · CI-built, SLSA-attested heads, verified before publication</p>
683683
</section>
684684

685685

@@ -740,7 +740,7 @@ <h2>The capability<br><em>shows itself</em></h2>
740740
<div class="choice">
741741
<span class="ch-key">the runtime</span>
742742
<span class="ch-title">pgCK — the kernel inside PostgreSQL</span>
743-
<p class="ch-desc"><a href="https://github.com/styk-tv/pgCK">styk-tv/pgCK</a> · extension v0.4.15 · PostgreSQL 14–17, both architectures · every release provenance-attested and verified before publication.</p>
743+
<p class="ch-desc"><a href="https://github.com/styk-tv/pgCK">styk-tv/pgCK</a> · extension v0.4.17 · PostgreSQL 14–17, both architectures · every release provenance-attested and verified before publication.</p>
744744
</div>
745745
<div class="choice">
746746
<span class="ch-key">the client</span>
@@ -783,7 +783,7 @@ <h2>The capability<br><em>shows itself</em></h2>
783783
<div class="cta-block">
784784
<span class="cta-quote">"<strong>Seal the gesture, derive the weight.</strong> The board is driven by the score, the score by sealed signal — and the rule that drives it evolves only by consensus."</span>
785785
<div class="cta-row">
786-
<a href="https://conceptkernel.org/v3.7/introduction" class="btn-p">Read the Specification</a>
786+
<a href="https://conceptkernel.org/v3.9/introduction" class="btn-p">Read the Specification</a>
787787
<a href="https://github.com/sporaxis-com/oci-germination/tree/main/examples/hello-kernel" class="btn-s">Run a Kernel</a>
788788
<a href="https://conceptkernel.org/browse/index.html" class="btn-s">Browse the Ontology</a>
789789
<a href="https://discord.gg/sTbfxV9xyU" class="btn-s">Join the Consensus</a>

docs/public/llms.txt

Lines changed: 30 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,35 @@
55
An open protocol for sovereign, semantic, self-governing state. Every kernel is a Material Entity (BFO:0000040) whose types are ontology (RDF/OWL/SHACL), whose every change is shape-gated, sealed, and proof-chained (validate → seal → HMAC-chained ledger → verifiable proof, in one transaction), and whose only interface is a single typed verb: ckp.dispatch(verb, urn, payload, identity) over NATS-WSS. A kernel changes its own types by consensus (propose → vote → apply); each applied change advances its epoch ε.
66

77
## Current version
8-
CKP v3.9.1 (Critical Isolation) is the current protocol epoch, implemented and shipped: the pgCK runtime (PostgreSQL extension, https://github.com/styk-tv/pgCK, extension v0.4.15, attested) and the dispatch-only client cklib (https://github.com/ConceptKernel/CK.Lib.Js, v1.5.3). The v3.7 set below is the last fully published narrative specification on this site; the v3.9.1 documentation set is in progress (tracked at https://github.com/ConceptKernel/conceptkernel.github.io/milestone/1). CKN — Concept Kernel Notation, CK(K) ≜ ⟪ χ · ρ · σ · α · γ · π · δ · φ ⟫ε — is the v3.10 design direction: https://conceptkernel.org/#notation
8+
CKP v3.9.1 (Critical Isolation) is the current protocol epoch, implemented and shipped: the pgCK runtime (PostgreSQL extension, https://github.com/styk-tv/pgCK, extension v0.4.17, attested) and the dispatch-only client cklib (https://github.com/ConceptKernel/CK.Lib.Js, v1.5.3). The v3.9.1 documentation set is published (key pages below); the v3.7 set remains browseable as a previous epoch. CKN — Concept Kernel Notation, CK(K) ≜ ⟪ χ · ρ · σ · α · γ · π · δ · φ ⟫ε — is the v3.10 design direction (in design): https://conceptkernel.org/v3.10/
9+
10+
## The distinction the protocol rests on
11+
A caller reaches a kernel through a VERB, not a query surface. A query surface (SQL/SPARQL/GraphQL/ORM) lets the caller author logic the engine runs — unbounded, unenumerable. A verb is a finite, named, pre-declared operation with a typed payload the engine knows before it runs. CKP ships a closed set of ~17 verbs and no query surface; even query-shaped verbs (instance.query, concept.match) bind typed parameters into logic sealed at germination. This is the precondition that makes grants enumerable and shapes unbypassable — the whole of Critical Isolation. https://conceptkernel.org/v3.9/verb-vs-query-surface
12+
13+
## Key pages (v3.9.1 — current set)
14+
- Introduction: https://conceptkernel.org/v3.9/introduction
15+
- A Verb, Not a Query Surface: https://conceptkernel.org/v3.9/verb-vs-query-surface
16+
- Critical Isolation (the three-ring architecture): https://conceptkernel.org/v3.9/critical-isolation
17+
- What a Concept Kernel Is: https://conceptkernel.org/v3.9/concept-kernel
18+
- The One Door (ckp.dispatch): https://conceptkernel.org/v3.9/the-door
19+
- Seal, Ledger, Proof: https://conceptkernel.org/v3.9/seal-and-proof
20+
- Shapes (σ): https://conceptkernel.org/v3.9/shapes
21+
- Affordances — the closed verb vocabulary (α): https://conceptkernel.org/v3.9/affordances
22+
- Governance (propose → vote → apply): https://conceptkernel.org/v3.9/governance
23+
- Grants (γ): https://conceptkernel.org/v3.9/grants
24+
- Epochs (ε): https://conceptkernel.org/v3.9/epochs
25+
- Naming — the developer writes URN: https://conceptkernel.org/v3.9/naming
26+
- The Core Vocabulary: https://conceptkernel.org/v3.9/ontology
27+
- The Client (cklib): https://conceptkernel.org/v3.9/client
28+
- Quickstart — zero to sealed state: https://conceptkernel.org/v3.9/quickstart
29+
- The Fleet (ecosystem): https://conceptkernel.org/v3.9/ecosystem
30+
- Changelog: https://conceptkernel.org/v3.9/changelog
31+
32+
## v3.10 — CKN (in design)
33+
- Overview: https://conceptkernel.org/v3.10/
34+
- Concept Kernel Notation: https://conceptkernel.org/v3.10/concept-kernel-notation
35+
- Notation In, Construct Out: https://conceptkernel.org/v3.10/assembled-constructs
36+
- The Scoring Loop: https://conceptkernel.org/v3.10/scoring-loop
937

1038
## Runtime core vocabulary (stable namespace, enforced at every sealed write)
1139
- Namespace: https://conceptkernel.org/ontology/v3.8/core#
@@ -20,7 +48,7 @@ CKP v3.9.1 (Critical Isolation) is the current protocol epoch, implemented and s
2048
- v3.6 (2026 Q2): 119 classes, 37 pages — the full specification
2149
- v3.7 (2026 Q2): 120 classes, 9 shapes, 31 pages, 20 checks, 5 edge predicates — the refined canon
2250
- v3.8: the core vocabulary's permanent namespace (see above)
23-
- v3.9 (2026 Q2): Critical Isolation — the kernel moves into PostgreSQL; 1 door; 31 attested runtime releases in 34 days (v0.1.0 → v0.4.15)
51+
- v3.9 (2026 Q2): Critical Isolation — the kernel takes root in pgRDF (native PostgreSQL extension), proven at the 8.2B-triple Wikidata scale; 1 door; 33 attested runtime releases (v0.1.0 → v0.4.17)
2452
- v3.9.1 (2026 Q2): the client meets the server — 17 verbs, 0 query surfaces, urn:ckp: naming proven live
2553
- v3.10 (in design): CKN, the notation; the scoring loop (signal.cast, concept.score) — tracked in public issues
2654

0 commit comments

Comments
 (0)