11# DietCode Hermes Plugin
22
3- ** v1.9.4 — Sonic Kernel UX **
3+ ** v1.11.0 — Native mutation (LUMI strategy) **
44
55DietCode is a standalone Hermes Agent plugin: one installable directory that gives
66agents ** governed mutation** , ** repository intelligence** , and ** per-project
@@ -9,8 +9,8 @@ long-horizon steering** — without forcing a single runtime path.
99BroccoliDB indexes your repo. JoyZoning owns the mutation lifecycle.
1010JSDP plans bounded delivery loops. The ** roadmap** tool keeps ` ROADMAP.md ` as a
1111living steering surface unique to * your* project — not the plugin checkout.
12- An optional ** macOS kernel bridge ** adds coherent physical patch and verify when
13- you opt in .
12+ ** ` dietcode_kernel ` ** provides native governed patch/verify with coherence tokens
13+ (same strategy as codemarie-new / LUMI) .
1414
1515``` text
1616Point workspace at YOUR project → fingerprint → evidence → ROADMAP.md steering
@@ -25,12 +25,13 @@ DietCode separates three authorities that other setups often collapse:
2525
2626| Authority | Owner | Question it answers |
2727| --- | --- | --- |
28- | ** Physical mutation** | Kernel bridge (optional ) or raw Hermes tools | What changed on disk, with receipts? |
28+ | ** Physical mutation** | ` dietcode_kernel ` (native ) or raw Hermes tools | What changed on disk, with receipts? |
2929| ** Lifecycle & completion** | JoyZoning + convergence gates | Is this mutation reviewed, verified, converged? |
3030| ** Long-horizon steering** | Roadmap (` ROADMAP.md ` ) | What is the project becoming; what matters now? |
3131
32- Nothing auto-completes kanban. Raw writes stay allowed by default. The kernel
33- patch gate is ** closed until you enable it** . Roadmap gates can block
32+ Nothing auto-completes kanban. Raw Hermes writes remain allowed. Governed patches
33+ use ` dietcode_kernel(action='patch') ` with coherence tokens when ` task_id ` is set.
34+ Roadmap gates can block
3435` kanban_complete ` when the steering surface is stale, invalid, or unvalidated —
3536mirroring how production teams treat architecture docs and CI green before merge.
3637
@@ -57,15 +58,16 @@ as production-ready.
5758
5859** Deep reference:** [ docs/roadmap.md] ( docs/roadmap.md )
5960
60- ### Mutation loop (JoyZoning + optional kernel )
61+ ### Mutation loop (JoyZoning + native runtime )
6162
6263``` text
6364joyzoning(action='context') → scope, convergence, roadmap brief, next_actions
65+ dietcode_kernel(action='status') → coherence token when task_id set
6466begin → patch → verify → request_review → convergence → kanban_complete (if gates open)
6567```
6668
67- Kernel-enabled path adds governed RPC patch/verify with coherence receipts and
68- progress telemetry ( ` / dietcode kernel cockpit ` , watch, explain-gate ).
69+ Native path: governed patch/verify via ` dietcode_kernel ` with drift detection and
70+ ` . dietcode/mutation-state.json ` (codemarie-new / LUMI strategy ).
6971
7072---
7173
@@ -77,7 +79,7 @@ progress telemetry (`/dietcode kernel cockpit`, watch, explain-gate).
7779| ** BroccoliDB** | Knowledge graph, audit, refactor, structural analysis, hive sync |
7880| ** JoyZoning** | Mutation lifecycle, convergence, runtime journal |
7981| ** JSDP** | Rolling-horizon autonomous delivery helpers |
80- | ** Kernel bridge ** | Optional macOS ` dietcode_kernel ` patch/ verify + raw-write policy |
82+ | ** Native mutation ** | ` dietcode_kernel ` tool — patch, verify, coherence, drift detection |
8183| ** Hooks** | Session start, pre/post tool call, write transforms, gate enforcement |
8284
8385---
@@ -152,13 +154,11 @@ Prime directive: *did the latest work strengthen or weaken the project's center
152154
153155Decision tree when stuck : [docs/roadmap.md#decision-tree](docs/roadmap.md#decision-tree-which-call-next)
154156
155- # ## Kernel (optional, macOS)
157+ # ## Native mutation
156158
157159` ` ` text
158- /dietcode kernel cockpit State, gates, roadmap steering merge
159- /dietcode kernel watch --follow Live operation line
160- /dietcode kernel explain-gate Patch gate diagnostics
161- /dietcode kernel progress Human summary + phase hints
160+ /dietcode mutation status Workspace revision, drift, coherence state
161+ dietcode_kernel(action='status') Same via tool
162162` ` `
163163
164164# ## Everything else
@@ -178,11 +178,8 @@ Safe defaults are seeded by `install.py`:
178178
179179` ` ` yaml
180180dietcode:
181- kernel:
182- bridge:
183- enabled: true
184- mutations_enabled: false # opt in to open patch gate
185- raw_write_policy: warn
181+ workspace:
182+ workspace_root_source: hermes_project
186183 roadmap:
187184 enabled: true
188185 auto_install_skills: true
@@ -191,15 +188,6 @@ dietcode:
191188 stale_checkpoint_days: 7
192189` ` `
193190
194- Enable kernel mutation (macOS, after build + socket) :
195-
196- ` ` ` yaml
197- dietcode:
198- kernel:
199- bridge:
200- mutations_enabled: true
201- ` ` `
202-
203191Full keys : [docs/roadmap.md#configuration-reference](docs/roadmap.md#configuration-reference) · [docs/dietcode-plugin.md](docs/dietcode-plugin.md)
204192
205193---
@@ -212,20 +200,14 @@ Plugin checkout production gate:
212200make verify
213201` ` `
214202
215- Runs roadmap smoke, production audit, operator smoke, and 121 unit tests
216- (roadmap + kernel cockpit ).
203+ Runs roadmap smoke, production audit, operator smoke, and unit tests
204+ (roadmap + native mutation ).
217205
218206Inside Hermes after install :
219207
220208` ` ` text
221209/dietcode doctor
222- ` ` `
223-
224- Kernel integration (macOS) :
225-
226- ` ` ` bash
227- make -C kernel kernel && make -C kernel restart-agent-server-fast
228- python scripts/kernel_bridge_e2e.py
210+ /dietcode mutation status
229211` ` `
230212
231213BroccoliDB :
@@ -257,9 +239,8 @@ make deploy-fast # skip Hermes pip reinstall
257239- Hermes Agent with plugin support
258240- Python (Hermes runtime)
259241- Node.js 18+ and npm (`broccolidb/`)
260- - **Kernel bridge (optional):** macOS, built `kernel/build/dietcode-kernel`, socket at `~/.dietcode/control.sock`
261242
262- Linux : full BroccoliDB, JoyZoning, JSDP, and roadmap; kernel bridge degrades gracefully .
243+ Works on macOS and Linux — native mutation uses Python + git (no macOS binary) .
263244
264245---
265246
@@ -276,14 +257,15 @@ Linux: full BroccoliDB, JoyZoning, JSDP, and roadmap; kernel bridge degrades gra
276257│ ├── agent/
277258│ │ ├── roadmap/ Fingerprint, evidence, autofill, gates, cockpit
278259│ │ ├── joyzoning/ Lifecycle, convergence, JSDP
279- │ │ └── kernel_* Bridge client, progress, cockpit
280- │ ├── runtime/ roadmap_hooks, joyzoning_hooks, kernel_hooks
260+ │ │ ├── native_mutation.py Governed patch, verify, coherence tokens
261+ │ │ └── joyzoning/ Lifecycle, convergence, JSDP
262+ │ ├── workspace_root.py Project workspace resolution
263+ │ ├── runtime/ roadmap_hooks, joyzoning_hooks, mutation_hooks
281264│ └── tools/ roadmap, dietcode_kernel, broccolidb, joyzoning
282265├── optional-skills/dietcode/auto-rolling-roadmap/ ROADMAP skill (auto-installed)
283- ├── kernel/ Quarantined macOS kernel subtree
284266├── broccolidb/ Bundled TypeScript package
285- ├── scripts/ Deploy, audit, smoke, kernel e2e
286- ├── tests/ Roadmap + kernel cockpit unit tests
267+ ├── scripts/ Deploy, audit, smoke
268+ ├── tests/ Roadmap + native mutation unit tests
287269└── docs/ Operator and developer documentation
288270` ` `
289271
@@ -292,7 +274,8 @@ Workspace artifacts (in **your** project, not the plugin):
292274` ` ` text
293275/path/to/your/project/
294276├── ROADMAP.md Living steering surface (12-section contract)
295- └── .dietcode/roadmap-state.json Validate/checkpoint memory
277+ ├── .dietcode/roadmap-state.json Validate/checkpoint memory
278+ └── .dietcode/mutation-state.json Native mutation coherence state
296279` ` `
297280
298281---
@@ -304,12 +287,9 @@ Workspace artifacts (in **your** project, not the plugin):
304287| **Roadmap steering (read first for agents)** | [docs/roadmap.md](docs/roadmap.md) |
305288| Install, config, workflow | [docs/dietcode-plugin.md](docs/dietcode-plugin.md) |
306289| Hook wiring, authority split | [docs/architecture.md](docs/architecture.md) |
307- | Kernel bridge operations | [docs/kernel-bridge-operations.md](docs/kernel-bridge-operations.md) |
308290| Slash commands + tools | [docs/tools-reference.md](docs/tools-reference.md) |
309- | Kernel + roadmap operator UX | [docs/agent-ergonomics.md](docs/agent-ergonomics.md) |
310291| BroccoliDB runtime | [docs/broccolidb.md](docs/broccolidb.md) |
311292| Doc index | [docs/README.md](docs/README.md) |
312- | Kernel build + RPC | [kernel/README.md](kernel/README.md) |
313293| Release history | [CHANGELOG.md](CHANGELOG.md) |
314294
315295Agent skill (installed to workspace) :
0 commit comments