You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
v3.7 versioning: add 'Two Root Conventions' section (cluster vs dev workstation)
Cluster root /ck/ is normative -- mounted into pods via the SeaweedFS
CSI driver, fixed by the deployment.
Dev workstation root ~/.config/conceptkernel/ck/ is the recommended
convention for the ck CLI and locally-running kernels, configurable
per developer preference. Same path shape under either root.
Paths in the rest of the page are shown with cluster roots (/ck/,
/ck-data/) for normative clarity; dev workstations apply the same
shapes under their configured root.
Copy file name to clipboardExpand all lines: docs/v3.7/versioning.md
+20-2Lines changed: 20 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,11 +7,29 @@ description: CKP uses per-kernel master clones plus per-project worktrees on the
7
7
8
8
CKP's three-loop model gives each kernel three independently-versioned concerns: CK (identity), TOOL (capability), and DATA (knowledge). v3.7's design:
9
9
10
-
-**Per-kernel master clones** on the SeaweedFS filer -- one regular (non-bare) clone per kernel-organ that tracks the registry's master.
11
-
-**Per-project worktrees** off each master clone, on `<project>/<version>` branches, materialised at version-keyed paths.
10
+
-**Per-kernel master clones** on the SeaweedFS filer (cluster) or the developer's filesystem (dev workstation) -- one regular (non-bare) clone per kernel-organ that tracks the registry's master.
11
+
-**Version-keyed materialisations** off each master clone, sibling to it under the kernel's directory.
12
12
-**Three sibling directories** (`ck/`, `tool/`, `data/`) inside the pod, mounted as independent PVs.
13
13
-**`.ckproject` manifest-driven materialisation** -- held in [CK.Project](./project)'s DATA organ, reflected onto the cluster as a `CKProject` CR.
14
14
15
+
## Two Root Conventions
16
+
17
+
The same path shape applies in two places, with two different roots:
18
+
19
+
| Context | CK + TOOL root | DATA root | Source |
20
+
|---------|----------------|-----------|--------|
21
+
|**Container / cluster**|`/ck/`|`/ck-data/`| SeaweedFS filer, mounted into pods via the SeaweedFS CSI driver. Normative. |
22
+
|**Dev workstation**|`~/.config/conceptkernel/ck/`|`~/.config/conceptkernel/ck-data/`| Recommended convention for the `ck` CLI and locally-running kernels; configurable per developer preference. |
23
+
24
+
Paths in this page (and elsewhere in the spec) are shown with the cluster `/ck/` and `/ck-data/` roots for normative clarity. On a developer workstation, the same path shapes apply under whichever root that workstation is configured for -- by convention `~/.config/conceptkernel/ck/` and `~/.config/conceptkernel/ck-data/`. For example, a CK organ materialised at:
~/.config/conceptkernel/ck/<Kernel>/<sha>/ck/ # dev workstation (default convention)
29
+
```
30
+
31
+
The `ck` CLI and CK.Operator share the same materialisation logic ([CK.Lib.Py](./project)`cklib.materialiser`); the only thing that differs between dev and cluster is which root the operations run against.
32
+
15
33
## Per-Kernel Master Clones
16
34
17
35
Each concept kernel has its own isolated git repository per organ on the SeaweedFS filer -- a regular clone of the registry's `<Kernel>/{ck,tool}.git` upstream, with `master` checked out:
0 commit comments