@ionivetech/mugiwara 0.5.5 → 0.6.1

package/dist/mugiwara.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import { existsSync as existsSync7, readdirSync as readdirSync3, rmSync as rmSync3 } from "node:fs";
+import { existsSync as existsSync7, readdirSync as readdirSync5, rmSync as rmSync3 } from "node:fs";
 import { homedir as homedir2 } from "node:os";
 import { join as join8, resolve } from "node:path";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
@@ -81,7 +81,7 @@ async function confirm(rl, question) {
 }
 
 // src/targets/claude.ts
-import { existsSync, mkdirSync, copyFileSync } from "node:fs";
+import { existsSync, mkdirSync, copyFileSync, chmodSync, readdirSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 
@@ -112,11 +112,18 @@ ${body}`;
 
 // src/targets/claude.ts
 var here = dirname(fileURLToPath(import.meta.url));
-var HOOK_SRC = join(here, "..", "..", "hooks", "session-start.ts");
+var HOOKS_SRC = join(here, "..", "..", "hooks");
+var COMMANDS_SRC = join(here, "..", "..", ".claude", "commands");
+function toolsFromScope(scope) {
+  if (scope === "artifacts")
+    return "Read, Grep, Glob, Write, Bash, WebFetch, WebSearch";
+  return;
+}
 var target = {
   id: "claude",
   label: "Claude Code",
   native: true,
+  refPointerPrefix: "../",
   paths({ scope, projectDir, home }) {
     const root = scope === "global" ? join(home, ".claude") : join(projectDir, ".claude");
     return { skillsDir: join(root, "skills"), agentsDir: join(root, "agents") };
@@ -131,6 +138,11 @@ var target = {
     const fm = { name: data.name, description: data.description };
     if (data.tools)
       fm.tools = data.tools;
+    else {
+      const generated = toolsFromScope(data["write-scope"]);
+      if (generated)
+        fm.tools = generated;
+    }
     return { relPath: `${data.name}.md`, text: stringifyFrontmatter(fm, body) };
   },
   refsDir({ scope, projectDir, home }, skillName) {
@@ -139,49 +151,88 @@ var target = {
   },
   postInstall({ scope, projectDir, home, dryRun }) {
     const root = scope === "global" ? join(home, ".claude") : join(projectDir, ".claude");
-    const hookFile = join(root, "hooks", "session-start.ts");
+    const written = [];
+    const notes = [];
     if (dryRun)
       return { written: [], notes: [] };
-    if (existsSync(HOOK_SRC) && !existsSync(hookFile)) {
-      mkdirSync(dirname(hookFile), { recursive: true });
-      copyFileSync(HOOK_SRC, hookFile);
-      return { written: [hookFile], notes: [] };
+    if (existsSync(HOOKS_SRC)) {
+      for (const f of readdirSync(HOOKS_SRC)) {
+        if (!f.endsWith(".ts"))
+          continue;
+        const dst = join(root, "hooks", f);
+        if (!existsSync(dst)) {
+          mkdirSync(dirname(dst), { recursive: true });
+          copyFileSync(join(HOOKS_SRC, f), dst);
+          chmodSync(dst, 493);
+          written.push(dst);
+        }
+      }
     }
-    return { written: [], notes: [] };
+    if (existsSync(COMMANDS_SRC)) {
+      const dstDir = join(root, "commands");
+      mkdirSync(dstDir, { recursive: true });
+      for (const f of readdirSync(COMMANDS_SRC)) {
+        if (!f.endsWith(".md"))
+          continue;
+        const src = join(COMMANDS_SRC, f);
+        const dst = join(dstDir, f);
+        if (!existsSync(dst)) {
+          copyFileSync(src, dst);
+          written.push(dst);
+        } else
+          notes.push(`existing command kept: ${dst}`);
+      }
+    }
+    return { written, notes };
   }
 };
 
 // src/targets/opencode.ts
-import { existsSync as existsSync2, readdirSync, copyFileSync as copyFileSync2, mkdirSync as mkdirSync2 } from "node:fs";
+import { existsSync as existsSync2, readdirSync as readdirSync2, copyFileSync as copyFileSync2, mkdirSync as mkdirSync2 } from "node:fs";
 import { dirname as dirname2, join as join2 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 var here2 = dirname2(fileURLToPath2(import.meta.url));
-var COMMANDS_SRC = join2(here2, "..", "..", ".opencode", "commands");
+var COMMANDS_SRC2 = join2(here2, "..", "..", ".opencode", "commands");
 var CREW = {
   "luffy-orchestrator": { color: "#ef4444", temperature: 0.2, steps: 15 },
   "usopp-brainstorm": { color: "#f59e0b", temperature: 0.6, steps: 15 },
   "nami-planner": { color: "#f97316", temperature: 0.2, steps: 15 },
   "zoro-execution": { color: "#22c55e", temperature: 0.1, steps: 30 },
-  "chopper-checkpoint": { color: "#3b82f6", temperature: 0.1, permission: { edit: "deny" }, steps: 15 },
-  "sanji-quality": { color: "#a855f7", temperature: 0.1, permission: { edit: "deny" }, steps: 10 },
-  "franky-gates": { color: "#06b6d4", temperature: 0.1, permission: { edit: "deny" }, steps: 10 },
-  "robin-reviewer": { color: "#8b5cf6", temperature: 0.2, permission: { edit: "deny" }, steps: 15 },
-  "jinbe-security": { color: "#6366f1", temperature: 0.2, permission: { edit: "deny" }, steps: 15 },
+  "chopper-checkpoint": { color: "#3b82f6", temperature: 0.1, steps: 15 },
+  "sanji-quality": { color: "#a855f7", temperature: 0.1, steps: 10 },
+  "franky-gates": { color: "#06b6d4", temperature: 0.1, steps: 10 },
+  "robin-reviewer": { color: "#8b5cf6", temperature: 0.2, steps: 15 },
+  "jinbe-security": { color: "#6366f1", temperature: 0.2, steps: 15 },
   "brook-healing": { color: "#ec4899", temperature: 0.1, steps: 20 },
-  "skeptic-verifier": { color: "#64748b", temperature: 0.1, permission: { edit: "deny" }, steps: 12 },
+  "skeptic-verifier": { color: "#64748b", temperature: 0.1, steps: 12 },
   "eval-runner": { color: "#14b8a6", temperature: 0.2, steps: 15 },
   "resume-coordinator": { color: "#d97706", temperature: 0.2, steps: 10 },
   "memory-keeper": { color: "#d946ef", temperature: 0.2, steps: 8 }
 };
-function agentFrontmatter(name, description) {
+function permissionFromScope(scope) {
+  if (scope === "source")
+    return { edit: "allow" };
+  if (scope === "artifacts")
+    return { edit: { "*": "deny", ".mugiwara/**": "allow" } };
+  return;
+}
+function agentFrontmatter(name, description, writeScope) {
   const crew = CREW[name];
   const lines = [`description: ${description}`, `mode: all`];
   if (crew) {
     lines.push(`color: '${crew.color}'`, `temperature: ${crew.temperature}`, `steps: ${crew.steps}`);
-    if (crew.permission) {
+    const perm = permissionFromScope(writeScope);
+    if (perm) {
       lines.push("permission:");
-      for (const [k, v] of Object.entries(crew.permission))
-        lines.push(`  ${k}: ${v}`);
+      for (const [k, v] of Object.entries(perm)) {
+        if (typeof v === "string") {
+          lines.push(`  ${k}: ${v}`);
+        } else {
+          lines.push(`  ${k}:`);
+          for (const [pk, pv] of Object.entries(v))
+            lines.push(`    "${pk}": ${pv}`);
+        }
+      }
     }
   }
   return lines.join(`
@@ -191,6 +242,7 @@ var target2 = {
   id: "opencode",
   label: "opencode",
   native: true,
+  refPointerPrefix: "../",
   paths({ scope, projectDir, home }) {
     const root = scope === "global" ? join2(home, ".config", "opencode") : join2(projectDir, ".opencode");
     return { skillsDir: join2(root, "skills"), agentsDir: join2(root, "agents") };
@@ -202,7 +254,8 @@ var target2 = {
     };
   },
   transformAgent(data, body) {
-    const fm = agentFrontmatter(data.name, data.description);
+    const desc = data["internal-agent"] === "true" ? `[INTERNAL] ${data.description}` : data.description;
+    const fm = agentFrontmatter(data.name, desc, data["write-scope"]);
     return { relPath: `${data.name}.md`, text: `---
 ${fm}
 ---
@@ -217,14 +270,14 @@ ${body}` };
     const dstDir = join2(root, "commands");
     if (dryRun)
       return { written: [], notes: [] };
-    if (!existsSync2(COMMANDS_SRC))
+    if (!existsSync2(COMMANDS_SRC2))
       return { written: [], notes: [] };
     mkdirSync2(dstDir, { recursive: true });
     const written = [];
-    for (const f of readdirSync(COMMANDS_SRC)) {
+    for (const f of readdirSync2(COMMANDS_SRC2)) {
       if (!f.endsWith(".md"))
         continue;
-      const src = join2(COMMANDS_SRC, f);
+      const src = join2(COMMANDS_SRC2, f);
       const dst = join2(dstDir, f);
       copyFileSync2(src, dst);
       written.push(dst);
@@ -313,7 +366,10 @@ ${body}` };
 
 > ${data.description}
 
-Skills: ${data.skills ?? ""}. Read \`.mugiwara/refs/${data.name}.md\` when embodying this role.`
+Skills: ${data.skills ?? ""}. Read \`.mugiwara/refs/${data.name}.md\` when embodying this role.
+
+Only zoro-execution and brook-healing may modify source code.
+Return your output to luffy-orchestrator; do not choose the next step.`
         };
       }
       return { relPath: `agent-${data.name}.md`, text: `# Agent: ${data.name}
@@ -421,7 +477,7 @@ var targets = { claude: target, opencode: target2, copilot: target3, gemini: tar
 var TARGET_IDS = Object.keys(targets);
 
 // src/installer.ts
-import { existsSync as existsSync4, mkdirSync as mkdirSync3, readFileSync as readFileSync2, readdirSync as readdirSync2, writeFileSync as writeFileSync2, copyFileSync as copyFileSync3, rmSync } from "node:fs";
+import { existsSync as existsSync4, mkdirSync as mkdirSync3, readFileSync as readFileSync2, readdirSync as readdirSync3, writeFileSync as writeFileSync2, copyFileSync as copyFileSync3, rmSync, lstatSync } from "node:fs";
 import { dirname as dirname3, join as join5 } from "node:path";
 import { homedir } from "node:os";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
@@ -429,27 +485,36 @@ var CONTENT_DIR = join5(dirname3(fileURLToPath3(import.meta.url)), "..", "conten
 var pkg = JSON.parse(readFileSync2(join5(dirname3(fileURLToPath3(import.meta.url)), "..", "package.json"), "utf8"));
 var VERSION = pkg.version;
 function collectContent() {
-  const skillNames = readdirSync2(join5(CONTENT_DIR, "skills"), { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name);
+  const skillNames = readdirSync3(join5(CONTENT_DIR, "skills"), { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name);
   const skills = skillNames.map((name) => {
     const { data, body } = parseFrontmatter(readFileSync2(join5(CONTENT_DIR, "skills", name, "SKILL.md"), "utf8"));
     return { name, data, body, refs: collectRefs(join5(CONTENT_DIR, "skills", name)) };
   });
-  const agents = readdirSync2(join5(CONTENT_DIR, "agents")).filter((f) => f.endsWith(".md")).map((f) => {
+  const agents = readdirSync3(join5(CONTENT_DIR, "agents")).filter((f) => f.endsWith(".md")).map((f) => {
     const { data, body } = parseFrontmatter(readFileSync2(join5(CONTENT_DIR, "agents", f), "utf8"));
-    return { name: f.replace(/\.md$/, ""), data, body, refs: [] };
+    return { name: f.replace(/\.md$/, ""), data, body, refs: [], internal: data.internal === "true" };
   });
-  return { skills, agents };
+  const sharedRefsDir = join5(dirname3(CONTENT_DIR), "references");
+  const sharedRefs = [];
+  if (existsSync4(sharedRefsDir)) {
+    for (const f of readdirSync3(sharedRefsDir)) {
+      if (!f.endsWith(".md"))
+        continue;
+      sharedRefs.push({ relPath: f, text: readFileSync2(join5(sharedRefsDir, f), "utf8") });
+    }
+  }
+  return { skills, agents, sharedRefs };
 }
 function collectRefs(skillDir) {
   const refsDir = join5(skillDir, "references");
   if (!existsSync4(refsDir))
     return [];
-  return readdirSync2(refsDir, { recursive: true }).map((f) => String(f)).filter((f) => f.endsWith(".md")).map((rel) => ({ relPath: rel, text: readFileSync2(join5(refsDir, rel), "utf8") }));
+  return readdirSync3(refsDir, { recursive: true }).map((f) => String(f)).filter((f) => f.endsWith(".md")).map((rel) => ({ relPath: rel, text: readFileSync2(join5(refsDir, rel), "utf8") }));
 }
 function installTo(target10, opts) {
   const { scope, projectDir, dryRun = false, force = false } = opts;
   const home = opts.home ?? homedir();
-  const { skills, agents } = collectContent();
+  const { skills, agents, sharedRefs } = collectContent();
   const dirs = target10.paths({ scope, projectDir, home });
   const backupRoot = join5(scope === "global" ? home : projectDir, ".mugiwara");
   const result = { written: [], skipped: [], backedUp: [], notes: [] };
@@ -482,12 +547,22 @@ function installTo(target10, opts) {
   };
   for (const s of skills) {
     const out = target10.transformSkill(s.data, s.body);
-    if (out)
-      writeOne(join5(dirs.skillsDir, out.relPath), out.text);
+    if (out) {
+      let text = out.text;
+      if (target10.refPointerPrefix !== undefined && target10.refPointerPrefix !== "") {
+        text = text.replace(/`_shared\/references\//g, "`" + target10.refPointerPrefix + "_shared/references/");
+      }
+      writeOne(join5(dirs.skillsDir, out.relPath), text);
+    }
     if (target10.transformSkillFull) {
       const full = target10.transformSkillFull(s.data, s.body);
-      if (full && target10.refsDir)
-        writeOne(join5(target10.refsDir({ scope, projectDir, home }, s.name), full.relPath), full.text);
+      if (full && target10.refsDir) {
+        let text = full.text;
+        if (target10.refPointerPrefix !== undefined && target10.refPointerPrefix !== "") {
+          text = text.replace(/`_shared\/references\//g, "`" + target10.refPointerPrefix + "_shared/references/");
+        }
+        writeOne(join5(target10.refsDir({ scope, projectDir, home }, s.name), full.relPath), text);
+      }
     }
     if (s.refs.length && target10.refsDir) {
       const refsRoot = target10.refsDir({ scope, projectDir, home }, s.name);
@@ -496,7 +571,7 @@ function installTo(target10, opts) {
     }
   }
   for (const a of agents) {
-    const out = target10.transformAgent(a.data, a.body);
+    const out = target10.transformAgent({ ...a.data, ...a.internal ? { "internal-agent": "true" } : {} }, a.body);
     if (out)
       writeOne(join5(dirs.agentsDir, out.relPath), out.text);
     if (target10.transformAgentFull) {
@@ -505,6 +580,11 @@ function installTo(target10, opts) {
         writeOne(join5(target10.refsDir({ scope, projectDir, home }, a.name), full.relPath), full.text);
     }
   }
+  if (sharedRefs.length) {
+    const sharedRoot = join5(dirs.skillsDir, "_shared", "references");
+    for (const r of sharedRefs)
+      writeOne(join5(sharedRoot, r.relPath), r.text);
+  }
   if (target10.postInstall) {
     const post = target10.postInstall({ scope, projectDir, home, dryRun, files: result.written });
     result.written.push(...post.written);
@@ -524,7 +604,7 @@ function removeInstalled(manifest, { dryRun = false } = {}) {
   if (!dryRun) {
     for (const f of manifest.files) {
       let d = dirname3(f);
-      while (existsSync4(d) && readdirSync2(d).length === 0) {
+      while (existsSync4(d) && readdirSync3(d).length === 0) {
         if (d.endsWith("/.mugiwara") || d === dirname3(d))
           break;
         rmSync(d, { recursive: true, force: true });
@@ -534,6 +614,44 @@ function removeInstalled(manifest, { dryRun = false } = {}) {
   }
   return removed;
 }
+function assertNotSymlink(file) {
+  if (!existsSync4(file))
+    return;
+  try {
+    if (lstatSync(file).isSymbolicLink())
+      throw new Error(`refusing to follow symlink: ${file}`);
+  } catch (e) {
+    if (e.code === "ENOENT")
+      return;
+    throw e;
+  }
+}
+var GITIGNORE_MARKER = "# mugiwara";
+var GITIGNORE_BLOCK = `# mugiwara — audit trail is the product: commit reports/, results/, logs/, spec/, plans/.
+# Ignore session state and regenerated files.
+.mugiwara/state.json
+.mugiwara/state-*.json
+.mugiwara/config
+.mugiwara/continue.md
+.mugiwara/refs/
+`;
+function ensureProjectGitignore(projectDir, opts = {}) {
+  const { dryRun = false } = opts;
+  const path = join5(projectDir, ".gitignore");
+  assertNotSymlink(path);
+  if (existsSync4(path) && readFileSync2(path, "utf8").includes(GITIGNORE_MARKER)) {
+    return { appended: false, notes: [] };
+  }
+  const existing = existsSync4(path) ? readFileSync2(path, "utf8") : "";
+  const separator = existing.length && !existing.endsWith(`
+`) ? `
+` : "";
+  if (!dryRun) {
+    mkdirSync3(dirname3(path), { recursive: true });
+    writeFileSync2(path, existing + separator + GITIGNORE_BLOCK);
+  }
+  return { appended: true, notes: [`.gitignore ${dryRun ? "would append" : "appended"} mugiwara audit-trail block`] };
+}
 
 // src/manifest.ts
 import { existsSync as existsSync5, mkdirSync as mkdirSync4, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "node:fs";
@@ -551,7 +669,7 @@ function writeManifest(file, data) {
 }
 
 // src/mission.ts
-import { existsSync as existsSync6, rmSync as rmSync2, readFileSync as readFileSync4 } from "node:fs";
+import { existsSync as existsSync6, rmSync as rmSync2, readFileSync as readFileSync4, readdirSync as readdirSync4, mkdirSync as mkdirSync5, appendFileSync } from "node:fs";
 import { join as join7 } from "node:path";
 function activeActor(projectDir) {
   const stateFile = join7(projectDir, ".mugiwara", "state.json");
@@ -583,11 +701,13 @@ function resetMission(projectDir, keepLogs, force) {
       removed.push(dir);
     }
   }
-  for (const f of ["state.json"]) {
-    const p = join7(root, f);
-    if (existsSync6(p)) {
-      rmSync2(p);
-      removed.push(f);
+  for (const f of readdirSync4(root)) {
+    if (/^state(-.+)?\.json$/.test(f)) {
+      const p = join7(root, f);
+      if (existsSync6(p)) {
+        rmSync2(p);
+        removed.push(f);
+      }
     }
   }
   if (!keepLogs) {
@@ -605,12 +725,114 @@ function resetMission(projectDir, keepLogs, force) {
   }
   return { removed, kept };
 }
+function archiveMission(projectDir, mission, opts = {}) {
+  const { dryRun = false } = opts;
+  const root = join7(projectDir, ".mugiwara");
+  if (!mission || /[^a-zA-Z0-9._-]/.test(mission) || /^\.+$/.test(mission))
+    throw new Error(`invalid mission name "${mission}" (allowlist: [a-zA-Z0-9._-], not a dot-path)`);
+  const removed = [];
+  const kept = [];
+  const belongs = (f) => {
+    const base = f.replace(/^\d{4}-\d{2}-\d{2}-/, "");
+    return base === `${mission}.md` || base.startsWith(`${mission}-`);
+  };
+  let report = null;
+  const reportsDir = join7(root, "reports");
+  if (existsSync6(reportsDir)) {
+    const f = readdirSync4(reportsDir).find((n) => {
+      const m = n.match(/^(\d{4}-\d{2}-\d{2})-(.+)\.md$/);
+      return !!m && m[2] === mission;
+    });
+    if (f)
+      report = join7("reports", f);
+  }
+  const resultsDir = join7(root, "results", mission);
+  if (existsSync6(resultsDir)) {
+    for (const f of readdirSync4(resultsDir)) {
+      if (f === "06-closure.md" || f === "07-pr-verdict.md") {
+        kept.push(join7("results", mission, f));
+        continue;
+      }
+      const p = join7(resultsDir, f);
+      if (!dryRun)
+        rmSync2(p, { recursive: true, force: true });
+      removed.push(join7("results", mission, f));
+    }
+  }
+  const specDir = join7(root, "spec");
+  if (existsSync6(specDir)) {
+    for (const f of readdirSync4(specDir)) {
+      if (!belongs(f))
+        continue;
+      const p = join7(specDir, f);
+      if (!dryRun)
+        rmSync2(p);
+      removed.push(join7("spec", f));
+    }
+  }
+  for (const dir of ["review", "issues"]) {
+    const d = join7(root, dir);
+    if (!existsSync6(d))
+      continue;
+    for (const f of readdirSync4(d)) {
+      if (!belongs(f))
+        continue;
+      const p = join7(d, f);
+      if (!dryRun)
+        rmSync2(p, { force: true });
+      removed.push(join7(dir, f));
+    }
+  }
+  const logsDir = join7(root, "logs");
+  if (existsSync6(logsDir)) {
+    for (const f of readdirSync4(logsDir)) {
+      if (!belongs(f))
+        continue;
+      const p = join7(logsDir, f);
+      if (!dryRun)
+        rmSync2(p);
+      removed.push(join7("logs", f));
+    }
+  }
+  const cont = join7(root, "continue.md");
+  if (existsSync6(cont)) {
+    try {
+      if (readFileSync4(cont, "utf8").includes(mission)) {
+        if (!dryRun)
+          rmSync2(cont);
+        removed.push("continue.md");
+      }
+    } catch {}
+  }
+  if (report)
+    kept.push(report);
+  for (const k of ["plans", "config", "state.json", join7("logs", "lessons.md")]) {
+    if (existsSync6(join7(root, k)))
+      kept.push(k);
+  }
+  let index;
+  const indexFile = join7(root, "reports", "index.md");
+  const line = `- ${mission} — ${new Date().toISOString().slice(0, 10)}${report ? ` → ${report}` : ""}
+`;
+  if (!dryRun) {
+    mkdirSync5(join7(root, "reports"), { recursive: true });
+    const existing = existsSync6(indexFile) ? readFileSync4(indexFile, "utf8") : "";
+    if (!existing.split(/\r?\n/).some((l) => l.startsWith(`- ${mission} —`))) {
+      const header = existing ? "" : `# Mission index
+
+`;
+      appendFileSync(indexFile, header + line);
+    }
+    index = join7("reports", "index.md");
+  }
+  return { report, removed, kept, index };
+}
 
 // src/cli.ts
 var str = (v) => typeof v === "string" ? v : undefined;
 var flag = (v) => v === true;
 async function run(argv) {
-  const { command, flags } = parseArgs(argv);
+  const { command, flags, _ } = parseArgs(argv);
   if (flag(flags.help) || command === "help")
     return help();
   if (flag(flags.version)) {
@@ -628,6 +850,8 @@ async function run(argv) {
       return list(flags);
     case "reset":
       return resetCmd(flags);
+    case "archive":
+      return archive(flags, _);
     default:
       throw new Error(`Unknown command: ${command}`);
   }
@@ -647,6 +871,23 @@ function resetCmd(flags) {
   if (result.kept.length)
     console.log(`kept: ${result.kept.join(", ")}`);
 }
+function archive(flags, positionals) {
+  const projectDir = resolve(str(flags.project) ?? process.cwd());
+  const mission = positionals[1];
+  if (!mission) {
+    console.error("usage: mugiwara archive <mission> [--project <dir>] [--dry-run]");
+    process.exit(1);
+  }
+  const result = archiveMission(projectDir, mission, { dryRun: flag(flags.dryRun) });
+  if (result.report)
+    console.log(`archive target: ${result.report}`);
+  if (result.removed.length)
+    console.log(`${flag(flags.dryRun) ? "would remove" : "removed"}: ${result.removed.join(", ")}`);
+  if (result.kept.length)
+    console.log(`kept: ${result.kept.join(", ")}`);
+  if (result.index)
+    console.log(`index updated: ${result.index}`);
+}
 async function resolveOptions(flags) {
   const interactive = !flag(flags.yes);
   if (interactive && !process.stdin.isTTY) {
@@ -707,6 +948,10 @@ async function install(flags) {
     allFiles.push(...r.written);
     allNotes.push(...r.notes);
   }
+  if (scope === "project") {
+    const gi = ensureProjectGitignore(projectDir, { dryRun: flag(flags.dryRun) });
+    allNotes.push(...gi.notes);
+  }
   if (flag(flags.dryRun)) {
     console.log(`
 Dry run — nothing written.`);
@@ -758,7 +1003,7 @@ async function uninstall(flags) {
   if (!flag(flags.dryRun)) {
     rmSync3(file);
     const mugiDir = join8(scope === "global" ? home : projectDir, ".mugiwara");
-    if (existsSync7(mugiDir) && readdirSync3(mugiDir).length === 0) {
+    if (existsSync7(mugiDir) && readdirSync5(mugiDir).length === 0) {
       rmSync3(mugiDir, { recursive: true, force: true });
     }
     if (manifest.targets.includes("opencode")) {
@@ -803,6 +1048,7 @@ Usage:
   mugiwara list          show installations
   mugiwara list --check  health check: show installations + missing files
   mugiwara reset         wipe mission state (spec/plans/results/review/issues[/logs])
+  mugiwara archive <m>    fold a closed mission's evidence into its report, then remove loose files
   mugiwara --help        this help
   mugiwara --version     print version
 

package/gemini-extension.json

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

package/hooks/session-start.ts

@@ -3,6 +3,6 @@
 console.log(
   JSON.stringify({
     additionalContext:
-      "Mugiwara crew available. The workflow auto-activates for non-trivial requests (no need to call `/using-mugiwara` at session start; it is optional and routes to the right crew member). The crew runs inline in the main thread — Never Task-dispatch a crew member. Subagents only for [PARALLEL] task batches, concurrent review/security, and independent re-run checks. Checkpoint reports at wave/stage boundaries. Mode: guided / semi / auto (see .mugiwara/config). Switch with `/mugiwara <mode>`. See skills/mugiwara-workflow."
+      "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 Wave 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 wave. See skills/mugiwara-workflow."
   })
 );

package/package.json

@@ -1,7 +1,15 @@
 {
   "name": "@ionivetech/mugiwara",
-  "version": "0.5.5",
+  "version": "0.6.1",
   "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": {
+    "type": "git",
+    "url": "git+https://github.com/ionivetech/mugiwara.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ionivetech/mugiwara/issues"
+  },
   "type": "module",
   "license": "MIT",
   "main": "./.opencode/plugins/mugiwara.mjs",
@@ -17,9 +25,7 @@
     "dist",
     "src",
     "content",
-    "docs",
     "references",
-    "evals",
     "scripts",
     ".opencode",
     ".claude-plugin",
@@ -51,8 +57,9 @@
     "validate": "bun scripts/validate-content.ts --check-manifest --check-docs",
     "evals": "bun scripts/run-evals.ts",
     "retrieval-eval": "bun scripts/retrieval-eval.ts",
+    "verify-install": "bun scripts/verify-install.ts",
     "sync-version": "bun scripts/sync-version.ts",
-    "gate": "bun run typecheck && bun run test && bun run build && bun scripts/validate-content.ts --check-manifest --check-docs && bun run verify-pack && bun scripts/run-evals.ts && bun scripts/retrieval-eval.ts",
+    "gate": "bun run typecheck && bun run test && bun run build && bun scripts/validate-content.ts --check-manifest --check-docs && bun run verify-pack && bun scripts/run-evals.ts && bun scripts/retrieval-eval.ts && bun scripts/verify-install.ts",
     "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.5.5",
+  "version": "0.6.1",
   "author": {
     "name": "ionivetech"
   },

package/references/multi-actor.md

@@ -37,7 +37,7 @@ All actors read and write to the same file. Append-only, never overwrite.
 `scripts/savepoint.sh` accepts `--branch <name>` to write per-branch state:
 
 ```bash
-scripts/savepoint.sh "2026-08-11-dark-mode" --branch "feature/dark-mode"
+scripts/savepoint.sh --branch "2026-08-11-dark-mode" "" "feature/dark-mode"
 # writes .mugiwara/state-feature-dark-mode.json
 ```