@ionivetech/mugiwara 0.5.4 → 0.6.0

package/dist/mugiwara.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import { existsSync as existsSync6, realpathSync, 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 { resolve } from "node:path";
-import { pathToFileURL } from "node:url";
+import { join as join8, resolve } from "node:path";
+import { fileURLToPath as fileURLToPath4 } from "node:url";
 
 // src/args.ts
 var VALUE_FLAGS = { "--project": "project", "--target": "target" };
@@ -15,6 +15,7 @@ var BOOL_FLAGS = {
   "--force": "force",
   "--dry-run": "dryRun",
   "--keep-logs": "keepLogs",
+  "--check": "check",
   "--help": "help",
   "-h": "help",
   "--version": "version",
@@ -80,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";
 
@@ -93,10 +94,10 @@ function parseFrontmatter(text) {
   for (const line of m[1].split(/\r?\n/)) {
     if (!line.trim())
       continue;
-    const i = line.indexOf(":");
+    const i = line.indexOf(": ");
     if (i === -1)
-      throw new Error(`Bad frontmatter line: ${line}`);
-    data[line.slice(0, i).trim()] = line.slice(i + 1).trim();
+      throw new Error(`Bad frontmatter line (missing ': ' separator): ${line}`);
+    data[line.slice(0, i).trim()] = line.slice(i + 2).trim();
   }
   return { data, body: text.slice(m[0].length) };
 }
@@ -112,10 +113,12 @@ ${body}`;
 // src/targets/claude.ts
 var here = dirname(fileURLToPath(import.meta.url));
 var HOOK_SRC = join(here, "..", "..", "hooks", "session-start.ts");
+var COMMANDS_SRC = join(here, "..", "..", ".claude", "commands");
 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") };
@@ -139,44 +142,81 @@ 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: [] };
+      chmodSync(hookFile, 493);
+      written.push(hookFile);
     }
-    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 { join as join2 } from "node:path";
+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_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(`
@@ -186,6 +226,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") };
@@ -197,7 +238,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}
 ---
@@ -206,6 +248,25 @@ ${body}` };
   refsDir({ scope, projectDir, home }, skillName) {
     const root = scope === "global" ? join2(home, ".config", "opencode") : join2(projectDir, ".opencode");
     return join2(root, "skills", skillName, "references");
+  },
+  postInstall({ scope, projectDir, home, dryRun }) {
+    const root = scope === "global" ? join2(home, ".config", "opencode") : join2(projectDir, ".opencode");
+    const dstDir = join2(root, "commands");
+    if (dryRun)
+      return { written: [], notes: [] };
+    if (!existsSync2(COMMANDS_SRC2))
+      return { written: [], notes: [] };
+    mkdirSync2(dstDir, { recursive: true });
+    const written = [];
+    for (const f of readdirSync2(COMMANDS_SRC2)) {
+      if (!f.endsWith(".md"))
+        continue;
+      const src = join2(COMMANDS_SRC2, f);
+      const dst = join2(dstDir, f);
+      copyFileSync2(src, dst);
+      written.push(dst);
+    }
+    return { written, notes: [] };
   }
 };
 
@@ -237,7 +298,7 @@ var target3 = {
 };
 
 // src/targets/generic.ts
-import { existsSync as existsSync2, writeFileSync } from "node:fs";
+import { existsSync as existsSync3, writeFileSync } from "node:fs";
 import { join as join4 } from "node:path";
 function makeGeneric(opts) {
   const { id, label, rulesDir, bootstrapFile, bootstrapPointer, tier = bootstrapPointer ? 2 : 3 } = opts;
@@ -289,7 +350,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}
@@ -320,7 +384,7 @@ ${body}` };
       const notes = [];
       const written = [];
       const file = join4(projectDir, bootstrapFile);
-      if (!existsSync2(file)) {
+      if (!existsSync3(file)) {
         if (!dryRun)
           writeFileSync(file, `${bootstrapPointer}
 `);
@@ -397,39 +461,49 @@ var targets = { claude: target, opencode: target2, copilot: target3, gemini: tar
 var TARGET_IDS = Object.keys(targets);
 
 // src/installer.ts
-import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync2, readdirSync, writeFileSync as writeFileSync2, copyFileSync as copyFileSync2, rmSync } from "node:fs";
-import { dirname as dirname2, join as join5 } from "node:path";
+import { existsSync as existsSync4, mkdirSync as mkdirSync3, readFileSync as readFileSync2, readdirSync as readdirSync3, writeFileSync as writeFileSync2, copyFileSync as copyFileSync3, rmSync } from "node:fs";
+import { dirname as dirname3, join as join5 } from "node:path";
 import { homedir } from "node:os";
-var CONTENT_DIR = join5(import.meta.dirname, "..", "content");
-var pkg = JSON.parse(readFileSync2(join5(import.meta.dirname, "..", "package.json"), "utf8"));
+import { fileURLToPath as fileURLToPath3 } from "node:url";
+var CONTENT_DIR = join5(dirname3(fileURLToPath3(import.meta.url)), "..", "content");
+var pkg = JSON.parse(readFileSync2(join5(dirname3(fileURLToPath3(import.meta.url)), "..", "package.json"), "utf8"));
 var VERSION = pkg.version;
 function collectContent() {
-  const skillNames = readdirSync(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 = readdirSync(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 (!existsSync3(refsDir))
+  if (!existsSync4(refsDir))
     return [];
-  return readdirSync(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: [] };
   const writeOne = (absPath, text) => {
-    if (existsSync3(absPath)) {
+    if (existsSync4(absPath)) {
       if (readFileSync2(absPath, "utf8") === text) {
         result.skipped.push(absPath);
         return;
@@ -440,27 +514,39 @@ function installTo(target10, opts) {
         return;
       }
       const ts = new Date().toISOString().replace(/[:.]/g, "-");
-      const backupFile = join5(backupRoot, "backup", ts, absPath.replace(/[^a-zA-Z0-9]+/g, "_"));
+      const fileName = absPath.replace(/[^a-zA-Z0-9]+/g, "_");
+      const backupDir = join5(backupRoot, "backup", `${ts}-${target10.id}`);
+      const backupFile = join5(backupDir, fileName);
       if (!dryRun) {
-        mkdirSync2(dirname2(backupFile), { recursive: true });
-        copyFileSync2(absPath, backupFile);
+        mkdirSync3(backupDir, { recursive: true });
+        copyFileSync3(absPath, backupFile);
       }
       result.backedUp.push(absPath);
     }
     if (!dryRun) {
-      mkdirSync2(dirname2(absPath), { recursive: true });
+      mkdirSync3(dirname3(absPath), { recursive: true });
       writeFileSync2(absPath, text);
     }
     result.written.push(absPath);
   };
   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);
@@ -469,7 +555,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) {
@@ -478,6 +564,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);
@@ -488,7 +579,7 @@ function installTo(target10, opts) {
 function removeInstalled(manifest, { dryRun = false } = {}) {
   const removed = [];
   for (const f of manifest.files) {
-    if (existsSync3(f)) {
+    if (existsSync4(f)) {
       if (!dryRun)
         rmSync(f);
       removed.push(f);
@@ -496,13 +587,12 @@ function removeInstalled(manifest, { dryRun = false } = {}) {
   }
   if (!dryRun) {
     for (const f of manifest.files) {
-      let d = dirname2(f);
-      while (existsSync3(d) && readdirSync(d).length === 0) {
-        rmSync(d, { recursive: true });
-        const parent = dirname2(d);
-        if (parent === d)
+      let d = dirname3(f);
+      while (existsSync4(d) && readdirSync3(d).length === 0) {
+        if (d.endsWith("/.mugiwara") || d === dirname3(d))
           break;
-        d = parent;
+        rmSync(d, { recursive: true, force: true });
+        d = dirname3(d);
       }
     }
   }
@@ -510,26 +600,26 @@ function removeInstalled(manifest, { dryRun = false } = {}) {
 }
 
 // src/manifest.ts
-import { existsSync as existsSync4, mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "node:fs";
-import { dirname as dirname3, join as join6 } from "node:path";
+import { existsSync as existsSync5, mkdirSync as mkdirSync4, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "node:fs";
+import { dirname as dirname4, join as join6 } from "node:path";
 function manifestPath({ scope, projectDir, home }) {
   return scope === "global" ? join6(home, ".mugiwara", "manifest.json") : join6(projectDir, ".mugiwara", "manifest.json");
 }
 function readManifest(file) {
-  return existsSync4(file) ? JSON.parse(readFileSync3(file, "utf8")) : null;
+  return existsSync5(file) ? JSON.parse(readFileSync3(file, "utf8")) : null;
 }
 function writeManifest(file, data) {
-  mkdirSync3(dirname3(file), { recursive: true });
+  mkdirSync4(dirname4(file), { recursive: true });
   writeFileSync3(file, JSON.stringify(data, null, 2) + `
 `);
 }
 
 // src/mission.ts
-import { existsSync as existsSync5, rmSync as rmSync2, readFileSync as readFileSync4 } from "node:fs";
+import { existsSync as existsSync6, rmSync as rmSync2, readFileSync as readFileSync4, readdirSync as readdirSync4 } from "node:fs";
 import { join as join7 } from "node:path";
 function activeActor(projectDir) {
   const stateFile = join7(projectDir, ".mugiwara", "state.json");
-  if (!existsSync5(stateFile))
+  if (!existsSync6(stateFile))
     return null;
   try {
     const state = JSON.parse(readFileSync4(stateFile, "utf8"));
@@ -540,7 +630,7 @@ function activeActor(projectDir) {
 }
 function resetMission(projectDir, keepLogs, force) {
   const root = join7(projectDir, ".mugiwara");
-  if (!existsSync5(root))
+  if (!existsSync6(root))
     return { removed: [], kept: [] };
   if (!force) {
     const actor = activeActor(projectDir);
@@ -552,29 +642,31 @@ function resetMission(projectDir, keepLogs, force) {
   const kept = [];
   for (const dir of ["spec", "plans", "results", "review", "issues", "reports"]) {
     const p = join7(root, dir);
-    if (existsSync5(p)) {
+    if (existsSync6(p)) {
       rmSync2(p, { recursive: true, force: true });
       removed.push(dir);
     }
   }
-  for (const f of ["state.json"]) {
-    const p = join7(root, f);
-    if (existsSync5(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) {
     const p = join7(root, "logs");
-    if (existsSync5(p)) {
+    if (existsSync6(p)) {
       rmSync2(p, { recursive: true, force: true });
       removed.push("logs");
     }
-  } else if (existsSync5(join7(root, "logs"))) {
+  } else if (existsSync6(join7(root, "logs"))) {
     kept.push("logs");
   }
   for (const f of ["config", "manifest.json", "backup"]) {
-    if (existsSync5(join7(root, f)))
+    if (existsSync6(join7(root, f)))
       kept.push(f);
   }
   return { removed, kept };
@@ -623,25 +715,31 @@ function resetCmd(flags) {
 }
 async function resolveOptions(flags) {
   const interactive = !flag(flags.yes);
+  if (interactive && !process.stdin.isTTY) {
+    throw new Error("Not a terminal. Run with --yes and --global or --project <dir> --target <ids|all>");
+  }
   const rl = interactive ? createRl() : null;
   try {
     let scope = flag(flags.global) ? "global" : str(flags.project) ? "project" : null;
     if (!scope) {
-      if (!interactive)
-        throw new Error("Specify --global or --project <dir> with --yes");
-      scope = await choose(rl, "Install scope?", ["global (user-wide)", "project (this repo)"]) === 0 ? "global" : "project";
+      if (!interactive) {
+        scope = "project";
+      } else
+        scope = await choose(rl, "Install scope?", ["global (user-wide)", "project (this repo)"]) === 0 ? "global" : "project";
     }
     const projectDir = resolve(str(flags.project) ?? process.cwd());
-    if (scope === "project" && !existsSync6(projectDir))
+    if (scope === "project" && !existsSync7(projectDir))
       throw new Error(`Project dir not found: ${projectDir}`);
     let targetIds = str(flags.target)?.split(",").map((s) => s.trim()) ?? null;
     if (targetIds && targetIds.includes("all"))
       targetIds = [...TARGET_IDS];
     if (!targetIds) {
-      if (!interactive)
-        throw new Error("Specify --target <ids|all> with --yes");
-      const idx = await multiChoose(rl, "Target AI agents?", ["all targets", ...TARGET_IDS]);
-      targetIds = idx.includes(0) ? [...TARGET_IDS] : idx.map((i) => TARGET_IDS[i - 1]);
+      if (!interactive) {
+        targetIds = [...TARGET_IDS];
+      } else {
+        const idx = await multiChoose(rl, "Target AI agents?", ["all targets", ...TARGET_IDS]);
+        targetIds = idx.includes(0) ? [...TARGET_IDS] : idx.map((i) => TARGET_IDS[i - 1]);
+      }
     }
     for (const id of targetIds) {
       if (!targets[id])
@@ -701,6 +799,14 @@ async function uninstall(flags) {
   const file = manifestPath({ scope, projectDir, home });
   const manifest = readManifest(file);
   if (!manifest) {
+    if (scope === "project") {
+      const globalFile = manifestPath({ scope: "global", projectDir, home });
+      if (existsSync7(globalFile)) {
+        console.log(`No project manifest found, but a global install exists. Try:
+  mugiwara uninstall --global`);
+        return;
+      }
+    }
     console.log("Nothing installed (no manifest found).");
     return;
   }
@@ -715,8 +821,20 @@ async function uninstall(flags) {
     }
   }
   const removed = removeInstalled(manifest, { dryRun: flag(flags.dryRun) });
-  if (!flag(flags.dryRun))
+  if (!flag(flags.dryRun)) {
     rmSync3(file);
+    const mugiDir = join8(scope === "global" ? home : projectDir, ".mugiwara");
+    if (existsSync7(mugiDir) && readdirSync5(mugiDir).length === 0) {
+      rmSync3(mugiDir, { recursive: true, force: true });
+    }
+    if (manifest.targets.includes("opencode")) {
+      const opencodeCache = join8(home, ".cache", "opencode", "packages", "@ionivetech");
+      if (existsSync7(opencodeCache)) {
+        rmSync3(opencodeCache, { recursive: true, force: true });
+        console.log("   cleared opencode npm cache (stale plugin versions)");
+      }
+    }
+  }
   console.log(`OK removed ${removed.length} files`);
 }
 function list(flags) {
@@ -731,7 +849,12 @@ function list(flags) {
     if (!m)
       continue;
     found = true;
-    console.log(`${label}: v${m.version} targets=${m.targets.join(",")} files=${m.files.length} installed=${m.installedAt}`);
+    if (flag(flags.check)) {
+      const missing = m.files.filter((f) => !existsSync7(f));
+      console.log(`${label}: v${m.version} targets=${m.targets.join(",")} files=${m.files.length} missing=${missing.length} installed=${m.installedAt}`);
+    } else {
+      console.log(`${label}: v${m.version} targets=${m.targets.join(",")} files=${m.files.length} installed=${m.installedAt}`);
+    }
   }
   if (!found)
     console.log("No mugiwara installation found.");
@@ -740,10 +863,11 @@ function help() {
   console.log(`mugiwara ${VERSION} — the Straw Hat crew for AI agents
 
 Usage:
-  mugiwara [install]     install the crew (default; wizard when flags missing)
+  mugiwara [install]     install the crew (wizard; with --yes uses project + all)
   mugiwara update        replace existing files (backs up differences first)
   mugiwara uninstall     remove installed files via manifest
   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 --help        this help
   mugiwara --version     print version
@@ -752,18 +876,13 @@ Flags:
   --global               user-wide install
   --project <dir>        project install (default: cwd)
   --target <ids|all>     comma-separated: ${TARGET_IDS.join(", ")}
-  --yes, -y              non-interactive (needs --global/--project, --target)
+  --yes, -y              non-interactive (defaults: project, all targets)
   --force                overwrite differing files (with backup)
   --dry-run              print actions without writing
+  --check                with list: report missing files (health check)
   --keep-logs            with reset: keep .mugiwara/logs (lessons ledger survives)`);
 }
-var entry = process.argv[1] !== undefined ? resolve(process.argv[1]) : undefined;
-if (entry !== undefined) {
-  try {
-    entry = realpathSync(entry);
-  } catch {}
-}
-var isMain = entry !== undefined && import.meta.url === pathToFileURL(entry).href;
+var isMain = process.argv[1] !== undefined && fileURLToPath4(import.meta.url) === resolve(process.argv[1]);
 if (isMain) {
   run(process.argv.slice(2)).catch((err) => {
     console.error(`mugiwara: ${err.message}`);

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "mugiwara",
-  "version": "0.5.4",
+  "version": "0.6.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/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.4",
+  "version": "0.6.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": {
+    "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,9 +57,10 @@
     "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",
-    "verify-pack": "npm pack --dry-run 2>&1 | grep -q 'ionivetech-mugiwara' && echo '✓ npm package clean' || (echo '✗ npm pack failed' && exit 1)",
+    "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"
   },
   "keywords": [