@ionivetech/mugiwara 0.6.6 → 0.7.0

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "mugiwara",
-  "version": "0.6.6",
+  "version": "0.7.0",
   "description": "The Straw Hat crew of AI agents and skills: brainstorm, plan, execute, checkpoint, quality, gates, review, security, healing.",
   "contextFileName": "GEMINI.md"
 }

package/hooks/auto-savepoint.js

@@ -39,16 +39,22 @@ var root = join2(dirname2(fileURLToPath2(import.meta.url)), "..");
 var cwd = process.env.CLAUDE_PROJECT_DIR ?? process.cwd();
 var SAFE = /^[A-Za-z0-9._-]+$/;
 function bootstrapMission() {
-  for (const dir of ["plans", "spec", "logs"]) {
-    const d = join2(cwd, ".mugiwara", dir);
-    if (!existsSync2(d))
+  const base = join2(cwd, ".mugiwara", "missions");
+  if (!existsSync2(base))
+    return null;
+  for (const e of readdirSync2(base, { withFileTypes: true })) {
+    if (!e.isDirectory() || !SAFE.test(e.name) || /^\.+$/.test(e.name))
       continue;
-    const files = readdirSync2(d).filter((f) => f.endsWith(".md") && f !== "lessons.md").sort().reverse();
-    for (const f of files) {
-      const name = f.replace(/\.md$/, "").replace(/^\d{4}-\d{2}-\d{2}-/, "");
-      if (name && SAFE.test(name) && !/^\.+$/.test(name)) {
-        return { mission: name, member: "", wave: "0", mode: readMode(), updated: 0 };
-      }
+    const files = readdirSync2(join2(base, e.name));
+    const hasState = files.some((f) => {
+      if (!f.endsWith(".json"))
+        return false;
+      const stem = f.slice(0, -5);
+      return stem !== "continue" && !stem.startsWith("continue-");
+    });
+    const hasArtifacts = ["plan.md", "spec.md", "decisions.md"].some((f) => files.includes(f));
+    if (!hasState && hasArtifacts) {
+      return { mission: e.name, member: "", wave: "0", mode: readMode(), updated: 0 };
     }
   }
   return null;
@@ -65,7 +71,7 @@ function readMode() {
   return "guided";
 }
 function activeMission() {
-  const base = join2(cwd, ".mugiwara", "state");
+  const base = join2(cwd, ".mugiwara", "missions");
   if (!existsSync2(base))
     return bootstrapMission();
   let best = null;
@@ -76,6 +82,8 @@ function activeMission() {
       if (!f.endsWith(".json"))
         continue;
       const stem = f.slice(0, -5);
+      if (stem === "continue" || stem.startsWith("continue-"))
+        continue;
       const member = stem === "state" ? "" : stem;
       if (member && (!SAFE.test(member) || /^\.+$/.test(member)))
         continue;

package/hooks/auto-savepoint.ts

@@ -2,13 +2,13 @@
 // hooks/auto-savepoint.ts — Stop hook: refresh the active mission's savepoint.
 //
 // State used to depend on the model remembering the prose instruction "run
-// scripts/savepoint.sh". It forgot, so .mugiwara/state/ and .mugiwara/continue/
-// stayed empty and everything reading them (resume, heal_cycle cap, lane-rise
+// scripts/savepoint.sh". It forgot, so state.json and continue.json stayed
+// missing and everything reading them (resume, heal_cycle cap, lane-rise
 // detection, the SessionStart auto-resume) was dead. This makes the write
 // happen whether or not the crew remembers.
 //
-// Refreshes the CURRENT wave — it never advances one. Wave transitions stay an
-// explicit crew action; this only keeps tasks/lane/blockers honest.
+// Refreshes the CURRENT flow stage — it never advances one. Flow transitions
+// stay an explicit crew action; this only keeps tasks/lane/blockers honest.
 import { existsSync, readFileSync, readdirSync } from 'node:fs';
 import { spawnSync } from 'node:child_process';
 // Shared with `mugiwara run` — a second copy here drifted (it lacked the PATH
@@ -25,26 +25,24 @@ type Active = { mission: string; member: string; wave: string; mode: string; upd
 
 /**
  * Name the mission when no savepoint exists yet, so the first one can be
- * written. Ordered most- to least-authoritative; returns null when nothing
- * indicates a mission is underway, which keeps this hook silent on projects
- * that never engaged the crew.
+ * written. A missions/<name>/ dir holding plan/spec/decisions but no state
+ * json means Flow 0 produced artifacts without a savepoint — exactly the
+ * drift this hook exists to end.
  */
 function bootstrapMission(): Active | null {
-  // A plan, spec, or decision log means Flow 0 produced artifacts but no
-  // savepoint — exactly the drift this hook exists to end.
-  for (const dir of ['plans', 'spec', 'logs']) {
-    const d = join(cwd, '.mugiwara', dir);
-    if (!existsSync(d)) continue;
-    const files = readdirSync(d)
-      .filter((f) => f.endsWith('.md') && f !== 'lessons.md')
-      .sort()
-      .reverse();
-    for (const f of files) {
-      // strip the YYYY-MM-DD- prefix the crew writes; what remains is the mission
-      const name = f.replace(/\.md$/, '').replace(/^\d{4}-\d{2}-\d{2}-/, '');
-      if (name && SAFE.test(name) && !/^\.+$/.test(name)) {
-        return { mission: name, member: '', wave: '0', mode: readMode(), updated: 0 };
-      }
+  const base = join(cwd, '.mugiwara', 'missions');
+  if (!existsSync(base)) return null;
+  for (const e of readdirSync(base, { withFileTypes: true })) {
+    if (!e.isDirectory() || !SAFE.test(e.name) || /^\.+$/.test(e.name)) continue;
+    const files = readdirSync(join(base, e.name));
+    const hasState = files.some((f) => {
+      if (!f.endsWith('.json')) return false;
+      const stem = f.slice(0, -5);
+      return stem !== 'continue' && !stem.startsWith('continue-');
+    });
+    const hasArtifacts = ['plan.md', 'spec.md', 'decisions.md'].some((f) => files.includes(f));
+    if (!hasState && hasArtifacts) {
+      return { mission: e.name, member: '', wave: '0', mode: readMode(), updated: 0 };
     }
   }
   return null;
@@ -61,14 +59,16 @@ function readMode(): string {
 }
 
 function activeMission(): Active | null {
-  const base = join(cwd, '.mugiwara', 'state');
+  const base = join(cwd, '.mugiwara', 'missions');
   if (!existsSync(base)) return bootstrapMission();
   let best: Active | null = null;
   for (const e of readdirSync(base, { withFileTypes: true })) {
     if (!e.isDirectory() || !SAFE.test(e.name) || /^\.+$/.test(e.name)) continue;
     for (const f of readdirSync(join(base, e.name))) {
+      // state.json (solo) or <member>.json (team) — never continue*.json
       if (!f.endsWith('.json')) continue;
       const stem = f.slice(0, -5);
+      if (stem === 'continue' || stem.startsWith('continue-')) continue;
       const member = stem === 'state' ? '' : stem;
       if (member && (!SAFE.test(member) || /^\.+$/.test(member))) continue;
       try {

package/hooks/engagement-marker.js

@@ -22,7 +22,7 @@ async function main() {
     return;
   const dispatched = /zoro-execution|brook-healing|mugiwara-execution|mugiwara-healing|mugiwara-execute|mugiwara-heal/.test(agentField);
   const planned = /nami-planner|mugiwara-planning|mugiwara-plan/.test(agentField);
-  const dir = join(cwd, ".mugiwara", "state");
+  const dir = join(cwd, ".mugiwara");
   const file = join(dir, ".engaged");
   const sessionId = typeof payload.session_id === "string" ? payload.session_id : "";
   try {

package/hooks/engagement-marker.ts

@@ -49,7 +49,7 @@ async function main(): Promise<void> {
   // inline, which is escape #2: only Nami writes the plan.
   const planned = /nami-planner|mugiwara-planning|mugiwara-plan/.test(agentField);
 
-  const dir = join(cwd, '.mugiwara', 'state');
+  const dir = join(cwd, '.mugiwara');
   const file = join(dir, '.engaged');
   // session_id scopes the marker when the payload carries one. Its presence on
   // every hook event is NOT verified, so the guard also accepts a recent mtime

package/hooks/pipeline-guard.js

@@ -29,7 +29,7 @@ function readEnforce() {
   return "block";
 }
 function engaged(sessionId) {
-  const file = join(cwd, ".mugiwara", "state", ".engaged");
+  const file = join(cwd, ".mugiwara", ".engaged");
   if (!existsSync(file))
     return false;
   try {
@@ -51,7 +51,7 @@ function sourceChanged() {
   }
 }
 function newestMissionState() {
-  const base = join(cwd, ".mugiwara", "state");
+  const base = join(cwd, ".mugiwara", "missions");
   if (!existsSync(base))
     return null;
   let best = null;
@@ -61,7 +61,8 @@ function newestMissionState() {
       if (!e.isDirectory())
         continue;
       for (const f of readdirSync(join(base, e.name))) {
-        if (!f.endsWith(".json"))
+        const stem = f.replace(/\.json$/, "");
+        if (!f.endsWith(".json") || stem === "continue" || stem.startsWith("continue-"))
           continue;
         const p = join(base, e.name, f);
         try {
@@ -81,7 +82,7 @@ function newestMissionState() {
 }
 var LANE_RANK = { direct: 0, lean: 1, standard: 2, full: 3, spike: 4 };
 function executorDispatched(sessionId) {
-  const file = join(cwd, ".mugiwara", "state", ".engaged");
+  const file = join(cwd, ".mugiwara", ".engaged");
   if (!existsSync(file))
     return false;
   try {
@@ -97,7 +98,7 @@ function executorDispatched(sessionId) {
   }
 }
 function plannerDispatched(sessionId) {
-  const file = join(cwd, ".mugiwara", "state", ".engaged");
+  const file = join(cwd, ".mugiwara", ".engaged");
   if (!existsSync(file))
     return false;
   try {
@@ -113,10 +114,10 @@ function plannerDispatched(sessionId) {
   }
 }
 function planTouched() {
-  const plansDir = join(cwd, ".mugiwara", "plans");
-  if (!existsSync(plansDir))
+  const missionsDir = join(cwd, ".mugiwara", "missions");
+  if (!existsSync(missionsDir))
     return false;
-  const markerFile = join(cwd, ".mugiwara", "state", ".engaged");
+  const markerFile = join(cwd, ".mugiwara", ".engaged");
   if (!existsSync(markerFile))
     return false;
   let sessionStart = 0;
@@ -127,10 +128,13 @@ function planTouched() {
   if (!sessionStart)
     return false;
   try {
-    for (const e of readdirSync(plansDir)) {
-      if (!e.endsWith(".md"))
+    for (const e of readdirSync(missionsDir, { withFileTypes: true })) {
+      if (!e.isDirectory())
+        continue;
+      const plan = join(missionsDir, e.name, "plan.md");
+      if (!existsSync(plan))
         continue;
-      const at = lstatSync(join(plansDir, e)).mtimeMs;
+      const at = lstatSync(plan).mtimeMs;
       if (at >= sessionStart)
         return true;
     }
@@ -162,7 +166,7 @@ async function main() {
 `);
     }
     if (planTouched() && !plannerDispatched(sessionId)) {
-      process.stderr.write("\u26A0 Mugiwara: a plan doc under .mugiwara/plans/ was written this session, " + "but no planner (nami-planner / mugiwara-planning) was dispatched or embodied. " + "Only Nami writes the plan \u2014 dispatch nami-planner, or record the plan as a " + `deliberate exception in the decision log. Set enforce=off in .mugiwara/config to disable.
+      process.stderr.write("\u26A0 Mugiwara: a plan doc (missions/<mission>/plan.md) was written this session, " + "but no planner (nami-planner / mugiwara-planning) was dispatched or embodied. " + "Only Nami writes the plan \u2014 dispatch nami-planner, or record the plan as a " + `deliberate exception in the decision log. Set enforce=off in .mugiwara/config to disable.
 `);
     }
     return;

package/hooks/pipeline-guard.ts

@@ -51,7 +51,7 @@ function readEnforce(): Enforce {
 
 /** Engaged = a mugiwara agent or skill ran in this session. */
 function engaged(sessionId: string): boolean {
-  const file = join(cwd, '.mugiwara', 'state', '.engaged');
+  const file = join(cwd, '.mugiwara', '.engaged');
   if (!existsSync(file)) return false;
   try {
     const m = JSON.parse(readFileSync(file, 'utf8')) as { session_id?: string; touched_at?: string };
@@ -89,7 +89,7 @@ function sourceChanged(): boolean {
  * the write-boundary check (check 2).
  */
 function newestMissionState(): { mission: string; lane: string } | null {
-  const base = join(cwd, '.mugiwara', 'state');
+  const base = join(cwd, '.mugiwara', 'missions');
   if (!existsSync(base)) return null;
   let best: { mission: string; lane: string } | null = null;
   let bestAt = -1;
@@ -97,7 +97,9 @@ function newestMissionState(): { mission: string; lane: string } | null {
     for (const e of readdirSync(base, { withFileTypes: true })) {
       if (!e.isDirectory()) continue;
       for (const f of readdirSync(join(base, e.name))) {
-        if (!f.endsWith('.json')) continue;
+        // state.json (solo) or <member>.json (team) — never continue*.json
+        const stem = f.replace(/\.json$/, '');
+        if (!f.endsWith('.json') || stem === 'continue' || stem.startsWith('continue-')) continue;
         const p = join(base, e.name, f);
         try {
           const s = JSON.parse(readFileSync(p, 'utf8')) as { mission?: unknown; lane?: unknown };
@@ -121,7 +123,7 @@ const LANE_RANK: Record<string, number> = { direct: 0, lean: 1, standard: 2, ful
 
 /** An executor (Zoro/Brook) was dispatched or embodied in this session. */
 function executorDispatched(sessionId: string): boolean {
-  const file = join(cwd, '.mugiwara', 'state', '.engaged');
+  const file = join(cwd, '.mugiwara', '.engaged');
   if (!existsSync(file)) return false;
   try {
     const m = JSON.parse(readFileSync(file, 'utf8')) as { session_id?: string; executor_dispatched_at?: string };
@@ -136,7 +138,7 @@ function executorDispatched(sessionId: string): boolean {
 
 /** A planner (Nami) was dispatched or embodied in this session. */
 function plannerDispatched(sessionId: string): boolean {
-  const file = join(cwd, '.mugiwara', 'state', '.engaged');
+  const file = join(cwd, '.mugiwara', '.engaged');
   if (!existsSync(file)) return false;
   try {
     const m = JSON.parse(readFileSync(file, 'utf8')) as { session_id?: string; planner_dispatched_at?: string };
@@ -150,20 +152,19 @@ function plannerDispatched(sessionId: string): boolean {
 }
 
 /**
- * A plan doc under .mugiwara/plans/ was created or modified in this session.
- * .mugiwara/ is gitignored, so git status cannot see plan files — read the
- * filesystem directly and compare mtimes against the session's first-seen
- * marker. A plan written after the session engaged counts as "touched this
- * session". Only .mugiwara/plans/*.md counts — the plan doc is the artifact
- * only Nami may write.
+ * A plan doc (missions/<mission>/plan.md) was created or modified in this
+ * session. .mugiwara/ is gitignored, so git status cannot see plan files —
+ * read the filesystem directly and compare mtimes against the session's
+ * first-seen marker. Only a mission plan.md counts — the plan doc is the
+ * artifact only Nami may write.
  */
 function planTouched(): boolean {
-  const plansDir = join(cwd, '.mugiwara', 'plans');
-  if (!existsSync(plansDir)) return false;
+  const missionsDir = join(cwd, '.mugiwara', 'missions');
+  if (!existsSync(missionsDir)) return false;
   // session start = the marker's first_seen; anything newer is this session's work.
   // An ABSENT marker means the session never engaged — treat as untouched, never
   // as "every plan counts" (a 0 fallback would flag every pre-existing plan).
-  const markerFile = join(cwd, '.mugiwara', 'state', '.engaged');
+  const markerFile = join(cwd, '.mugiwara', '.engaged');
   if (!existsSync(markerFile)) return false;
   let sessionStart = 0;
   try {
@@ -172,11 +173,13 @@ function planTouched(): boolean {
   } catch { /* corrupt marker — treat as untouched */ }
   if (!sessionStart) return false;
   try {
-    for (const e of readdirSync(plansDir)) {
-      if (!e.endsWith('.md')) continue;
-      // lstat, not stat: a symlinked plan pointing outside .mugiwara/plans/
+    for (const e of readdirSync(missionsDir, { withFileTypes: true })) {
+      if (!e.isDirectory()) continue;
+      const plan = join(missionsDir, e.name, 'plan.md');
+      if (!existsSync(plan)) continue;
+      // lstat, not stat: a symlinked plan pointing outside .mugiwara/
       // must not count as a plan write.
-      const at = lstatSync(join(plansDir, e)).mtimeMs;
+      const at = lstatSync(plan).mtimeMs;
       if (at >= sessionStart) return true;
     }
   } catch { /* unreadable — treat as untouched */ }
@@ -232,7 +235,7 @@ async function main(): Promise<void> {
     // across harnesses.
     if (planTouched() && !plannerDispatched(sessionId)) {
       process.stderr.write(
-        '⚠ Mugiwara: a plan doc under .mugiwara/plans/ was written this session, ' +
+        '⚠ Mugiwara: a plan doc (missions/<mission>/plan.md) was written this session, ' +
         'but no planner (nami-planner / mugiwara-planning) was dispatched or embodied. ' +
         'Only Nami writes the plan — dispatch nami-planner, or record the plan as a ' +
         'deliberate exception in the decision log. Set enforce=off in .mugiwara/config to disable.\n',

package/hooks/session-start.js

@@ -50,13 +50,18 @@ var isNum = (s) => /^\d+$/.test(s);
 var isSafeKey = (s) => /^[A-Za-z0-9._-]+$/.test(s);
 var resumeContext = "";
 var actor = gitActor();
-var continueRoot = join(cwd, ".mugiwara", "continue");
+var missionsRoot = join(cwd, ".mugiwara", "missions");
 var active = [];
-if (existsSync(continueRoot)) {
-  const missions = readdirSync(continueRoot, { withFileTypes: true }).filter((e) => e.isDirectory() && isSafeKey(e.name)).map((e) => e.name);
+if (existsSync(missionsRoot)) {
+  const missions = readdirSync(missionsRoot, { withFileTypes: true }).filter((e) => e.isDirectory() && isSafeKey(e.name)).map((e) => e.name);
   for (const mission of missions) {
-    const dir = join(continueRoot, mission);
-    const files = readdirSync(dir).filter((f) => f.endsWith(".json"));
+    const dir = join(missionsRoot, mission);
+    const files = readdirSync(dir).filter((f) => {
+      if (!f.endsWith(".json"))
+        return false;
+      const stem = f.slice(0, -".json".length);
+      return stem === "continue" || stem.startsWith("continue-");
+    });
     for (const f of files) {
       const file = join(dir, f);
       if (!existsSync(file))
@@ -99,8 +104,6 @@ if (active.length === 1 && mode === "auto") {
 ${lines}
 ` + `Run /mugiwara continue <mission> [member] to resume one explicitly.`;
 }
-console.log(JSON.stringify({
-  additionalContext: "Mugiwara crew active by default. Say \\`mugiwara off\\` for a request and the crew stands down (Luffy acknowledges, records it in the decision log). Before ANY task \u2014 load \\`mugiwara-orchestration\\` skill as gatekeeper. NEVER execute, answer, or make changes without Flow 0 triage. Classification overhead <15 seconds \u2014 cheaper than an incorrect fix. Lane 0 for trivial work (single-file/<20 LOC) skips pipeline; Lane 1+ follows full pipeline. Mode: guided / semi / auto (see .mugiwara/config). Switch with \\`/mugiwara <mode>\\` \u2014 applies from the next flow stage. Every flow stage opens with a banner \\`===== \u2694\uFE0F FLOW N \u2014 CREW (ROLE) =====\\` and closes with a handoff \\`\u2192 Flow N+1 \u2014 Crew (Role)\\`; Zoro shows per-task progress \\`[task N/M]\\` with each task's evidence. See skills/mugiwara-workflow." + (resumeContext ? `
-
-` + resumeContext : "")
-}));
+if (resumeContext) {
+  console.log(JSON.stringify({ additionalContext: resumeContext }));
+}

package/hooks/session-start.ts

@@ -1,9 +1,12 @@
 #!/usr/bin/env bun
-// hooks/session-start.ts — SessionStart hook: reminds the agent the crew is
-// available, and surfaces in-flight missions for the current git actor from
-// the machine-written continue JSON (D10). Listing in-flight work runs in
-// every mode; auto-resume is auto-only. Never auto-resumes when multiple are
-// in-flight — ambiguous resumes are listed, not guessed.
+// hooks/session-start.ts — SessionStart hook: surfaces in-flight missions for
+// the current git actor from the machine-written continue JSON (D10).
+//
+// Deliberately SILENT otherwise: mugiwara must not announce itself or steer a
+// session that never engaged the crew. The only output is the in-flight
+// listing (every mode) and auto-resume (auto mode, single mission). Listing
+// never auto-resumes when multiple are in-flight — ambiguous resumes are
+// listed, not guessed.
 
 import { readFileSync, existsSync, readdirSync } from 'node:fs';
 import { execFileSync } from 'node:child_process';
@@ -63,23 +66,27 @@ const isSafeKey = (s: string): boolean => /^[A-Za-z0-9._-]+$/.test(s);
 
 let resumeContext = '';
 const actor = gitActor();
-const continueRoot = join(cwd, '.mugiwara', 'continue');
+const missionsRoot = join(cwd, '.mugiwara', 'missions');
 const active: { mission: string; member: string | null; flow: string; done: string; total: string }[] = [];
 
-  if (existsSync(continueRoot)) {
-    // continue/<mission>/*.json — scan every mission folder
-    const missions = readdirSync(continueRoot, { withFileTypes: true })
+  if (existsSync(missionsRoot)) {
+    // missions/<mission>/continue.json (solo) | continue-<member>.json (team)
+    const missions = readdirSync(missionsRoot, { withFileTypes: true })
       .filter((e) => e.isDirectory() && isSafeKey(e.name))
       .map((e) => e.name);
     for (const mission of missions) {
-      const dir = join(continueRoot, mission);
-      const files = readdirSync(dir).filter((f) => f.endsWith('.json'));
+      const dir = join(missionsRoot, mission);
+      const files = readdirSync(dir).filter((f) => {
+        if (!f.endsWith('.json')) return false;
+        const stem = f.slice(0, -'.json'.length);
+        return stem === 'continue' || stem.startsWith('continue-');
+      });
       for (const f of files) {
         const file = join(dir, f);
         if (!existsSync(file)) continue;
         try {
           const s = JSON.parse(readFileSync(file, 'utf8'));
-          // only this actor's states; solo (state.json) belongs to whoever
+          // only this actor's states; solo (continue.json) belongs to whoever
           // owns its actor field
           if (s.actor !== actor) continue;
           if (!isSafeKey(String(s.mission ?? ''))) continue;
@@ -122,10 +129,8 @@ if (active.length === 1 && mode === 'auto') {
     `Run /mugiwara continue <mission> [member] to resume one explicitly.`;
 }
 
-console.log(
-  JSON.stringify({
-    additionalContext:
-      "Mugiwara crew active by default. Say \\`mugiwara off\\` for a request and the crew stands down (Luffy acknowledges, records it in the decision log). Before ANY task — load \\`mugiwara-orchestration\\` skill as gatekeeper. NEVER execute, answer, or make changes without Flow 0 triage. Classification overhead <15 seconds — cheaper than an incorrect fix. Lane 0 for trivial work (single-file/<20 LOC) skips pipeline; Lane 1+ follows full pipeline. Mode: guided / semi / auto (see .mugiwara/config). Switch with \\`/mugiwara <mode>\\` — applies from the next flow stage. Every flow stage opens with a banner \\`===== ⚔️ FLOW N — CREW (ROLE) =====\\` and closes with a handoff \\`→ Flow N+1 — Crew (Role)\\`; Zoro shows per-task progress \\`[task N/M]\\` with each task's evidence. See skills/mugiwara-workflow." +
-      (resumeContext ? "\n\n" + resumeContext : "")
-  })
-);
+// Silent unless there is in-flight work: a session that never used mugiwara
+// gets zero injected context.
+if (resumeContext) {
+  console.log(JSON.stringify({ additionalContext: resumeContext }));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ionivetech/mugiwara",
-  "version": "0.6.6",
+  "version": "0.7.0",
   "description": "The Straw Hat crew of AI agents and skills: brainstorm, plan, execute, checkpoint, quality, gates, review, security, self-healing. Installs into Claude Code, opencode, Copilot, Gemini, Codex, Cursor, Kimi, pi, Windsurf, Cline, Kilo, Antigravity.",
   "homepage": "https://github.com/ionivetech/mugiwara#readme",
   "repository": {
@@ -63,7 +63,7 @@
     "sync-version": "bun scripts/sync-version.ts",
     "build-hooks": "bun scripts/build-hooks.ts",
     "build-hooks:check": "bun scripts/build-hooks.ts --check",
-    "gate": "bun run build-hooks:check && bun run typecheck && bun run test:coverage && bun run build && bun scripts/validate-content.ts --check-manifest --check-docs --check-doc-integrity && bun scripts/lane-base.ts && bun run verify-pack && bun scripts/run-evals.ts && bun scripts/retrieval-eval.ts && bun scripts/verify-install.ts && bun scripts/conformance.ts && bun run coverage-gate",
+    "gate": "bun run build-hooks:check && bun run typecheck && bun run test:coverage && bun run build && bun scripts/validate-content.ts --check-manifest --check-docs --check-doc-integrity && bun scripts/lane-base.ts && bun scripts/check-doc-links.ts && bun run verify-pack && bun scripts/run-evals.ts && bun scripts/retrieval-eval.ts && bun scripts/verify-install.ts && bun scripts/conformance.ts && bun run coverage-gate",
     "verify-pack": "npm pack --dry-run 2>&1 | node -e \"let s='';process.stdin.on('data',d=>s+=d);process.stdin.on('end',()=>{if(!s.includes('ionivetech-mugiwara')){console.error('npm pack failed');process.exit(1)};console.log('npm package clean')})\"",
     "prepack": "bun run build && bun run sync-version"
   },

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "mugiwara",
   "description": "The Straw Hat crew of AI agents and skills: brainstorm, plan, execute, checkpoint, quality, gates, review, security, healing.",
-  "version": "0.6.6",
+  "version": "0.7.0",
   "author": {
     "name": "ionivetech"
   },

package/references/complexity.md

@@ -40,11 +40,34 @@ path:line:functionName — CC 14 (threshold 10)
   branches: if x2, for x1, && x3, case x4, catch x1, ternary x3
 ```
 
-## Cognitive complexity (secondary)
+## Cognitive complexity — understandability (Sonar)
 
-Cyclomatic is the gate; cognitive complexity (nesting depth) supplements it.
-Flag functions nested >4 levels deep even when cyclomatic is low — deep
-nesting is a readability problem a branch count misses.
+Measures how hard a function is to READ, not how many paths it has. Nesting
+is penalized: a construct nested inside another adds its increment plus a
+nesting increment, so a three-level guard ladder outscores an eight-branch
+flat chain that has higher cyclomatic. The two metrics catch different
+functions — report both, flag on either.
+
+Count per function: +1 for every flow break (`if`, `else if`, `else`,
+`for`, `while`, `do`, `case`, `catch`, ternary, each `&&`/`||`/`??` beyond
+the first in its chain), plus +1 per nesting level entered for structures
+nested inside another flow-break structure. Sequences and flattenable
+patterns (`else if` chains, top-level `&&`) stay cheap — that is the point.
+
+| Cognitive | Verdict |
+|-----------|---------|
+| ≤15 | clean |
+| 16–25 | flag — flatten nesting or extract; minor/major by context |
+| >25 | major finding — restructure before merge |
+
+Evidence format mirrors cyclomatic: `path:line:functionName — COG 18
+(threshold 15)` plus the nesting sketch that produced it. A number without
+the sketch is an unproven claim.
+
+Tooling first: ESLint SonarJS `sonarjs/cognitive-complexity` (default max
+15), SonarScanner's `cognitive_complexity` metric, or the language's
+equivalent. The repo's tool is the source of truth; manual counting is the
+fallback. Never weaken a tool's threshold to make a function pass.
 
 ## Tooling
 

package/references/definition-of-done.md

@@ -12,7 +12,7 @@ Every mission wave must satisfy all five before it is Done:
 | **Quality** | Lint, format, and tests are clean. | Run project formatter → linter → unit suite. Zero errors. Configs unweakened. |
 | **Integration** | The work fits the existing system. | Build/typecheck exits 0 against full tree. No regression in existing tests. |
 | **Docs** | User-facing and internal docs match the change. | README, changelog, API docs, and in-code docstrings updated where the change requires it. |
-| **Ship-readiness** | No blockers left open. | Blocker ledger `.mugiwara/issues/YYYY-MM-DD-<mission>-blockers.md` has zero open rows. |
+| **Ship-readiness** | No blockers left open. | Blocker ledger `.mugiwara/missions/<mission>/blockers.md` has zero open rows. |
 
 ## Verdict
 

package/references/multi-actor.md

@@ -64,6 +64,3 @@ clobber each other's resume position.
 The session-start hook (auto mode) surfaces only the missions owned by your git
 actor — never another member's. If you hold several in-flight missions it lists
 them and asks, it never guesses.
-
-`mugiwara run mission-report.sh` follows the same convention (`MEMBER` env selects a
-team member's state).

package/references/prose-style.md

@@ -0,0 +1,54 @@
+# Prose Style — how mugiwara writes
+
+Applies to every sentence a human reads in the output: mission reports,
+review findings prose, PR descriptions, closure summaries, code comments.
+Findings keep their one-line format; this governs everything around them.
+
+## Openings
+
+- Start with the substance — the verdict, the number, the file. Never with a
+  warm-up.
+- Banned openers: "It's worth noting", "It should be noted", "It's important
+  to remember", "First of all", "In this report".
+- No meta-commentary: never describe the writing ("This section will cover…")
+  — just cover it.
+
+## Words
+
+- Cut hedges and intensifiers: very, quite, fairly, somewhat, rather,
+  extremely. The evidence carries the weight, not the adverb.
+- Prefer the plain verb: use over utilize/leverage, help over facilitate,
+  start over commence, show over demonstrate.
+- No inflation adjectives: robust, seamless, comprehensive, powerful,
+  cutting-edge, state-of-the-art. If a thing is robust, say what it survives.
+- Concrete over abstract: "3 tests fail on empty cart" beats "several issues
+  affect checkout stability".
+
+## Sentences
+
+- Active voice by default. Name the actor: "Zoro added pagination" not
+  "pagination was added".
+- One idea per sentence. Vary length deliberately; never settle into
+  uniform staccato or uniform sprawl.
+- No rhetorical setup-then-answer ("So what does this mean? It means…").
+  Ask nothing you then answer yourself.
+
+## Structure
+
+- Verdict first, evidence after, reasoning last. A reader who stops early
+  still has the conclusion.
+- No binary-contrast crutch: "not just X but Y", "it's not about X, it's
+  about Y". State X and Y plainly if both matter.
+- Lists carry items, not introductions. No "The following are some reasons
+  why:" before a list that explains itself.
+- No dramatic fragmentation for effect. Fragments are for pace where the
+  reader already has context, not for emphasis theater.
+
+## Honesty
+
+- Severity words follow the rubric only — "critical" means critical, never
+  emphasis. No marketing language in reports: a fix is merged, not shipped
+  with confidence.
+- Numbers beat adjectives everywhere both exist.
+- Before sending user-facing prose: delete every sentence that survives its
+  own removal. If nothing changes meaning, it was filler.