@ionivetech/mugiwara 0.9.0 → 0.9.1

package/dist/mugiwara.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import { existsSync as existsSync16, readdirSync as readdirSync10, readFileSync as readFileSync15, rmSync as rmSync3, writeFileSync as writeFileSync10, mkdirSync as mkdirSync10, renameSync as renameSync2 } from "node:fs";
+import { existsSync as existsSync17, readdirSync as readdirSync10, readFileSync as readFileSync16, rmSync as rmSync3, writeFileSync as writeFileSync10, mkdirSync as mkdirSync10, renameSync as renameSync2 } from "node:fs";
 import { execFileSync as execFileSync6 } from "node:child_process";
 import { homedir as homedir4 } from "node:os";
 import { dirname as dirname6, join as join21, resolve as resolve2 } from "node:path";
@@ -152,6 +152,7 @@ function wireSettings(root, hooksDir) {
   const events = {
     SessionStart: { file: "session-start.js", timeout: 10 },
     UserPromptSubmit: { file: "mugiwara-mode-tracker.js", timeout: 5 },
+    PreToolUse: { file: "pretool-guard.js", timeout: 10, matcher: "Bash" },
     Stop: { file: "auto-savepoint.js", timeout: 20 },
     SubagentStop: { file: "pipeline-guard.js", timeout: 15 },
     PostToolUse: { file: "engagement-marker.js", timeout: 5, matcher: "Task|Skill" }
@@ -647,7 +648,7 @@ var DEFAULT_CONFIG = [
   "# -- Git --------------------------------------------------",
   "branch=feature/{type}-{issue}-{slug}",
   "commit=conventional",
-  "auto_commit=on               # on | off — off hands you an uncommitted tree in guided/semi",
+  "auto_commit=off              # on | off — off hands you an uncommitted tree in guided/semi",
   "",
   "# -- Gates ------------------------------------------------",
   "coverage_new=85",
@@ -779,11 +780,11 @@ function collectRefs(skillDir) {
     return [];
   return readdirSync3(refsDir, { recursive: true }).map((f) => String(f)).filter((f) => f.endsWith(".md")).map((rel) => ({ relPath: rel, text: readFileSync4(join6(refsDir, rel), "utf8") }));
 }
-function installTo(target10, opts) {
+function installTo(target, opts) {
   const { scope, projectDir, dryRun = false, force = false } = opts;
   const home = opts.home ?? homedir2();
   const { skills, agents, sharedRefs } = collectContent();
-  const dirs = target10.paths({ scope, projectDir, home });
+  const dirs = target.paths({ scope, projectDir, home });
   const backupRoot = join6(scope === "global" ? home : projectDir, ".mugiwara");
   const result = { written: [], skipped: [], backedUp: [], notes: [] };
   const writeOne = (absPath, text, mode) => {
@@ -804,7 +805,7 @@ function installTo(target10, opts) {
       }
       const ts = new Date().toISOString().replace(/[:.]/g, "-");
       const fileName = absPath.replace(/[^a-zA-Z0-9]+/g, "_");
-      const backupDir = join6(backupRoot, "backup", `${ts}-${target10.id}`);
+      const backupDir = join6(backupRoot, "backup", `${ts}-${target.id}`);
       const backupFile = join6(backupDir, fileName);
       if (!dryRun) {
         mkdirSync4(backupDir, { recursive: true });
@@ -824,38 +825,38 @@ function installTo(target10, opts) {
     result.written.push(absPath);
   };
   for (const s of skills) {
-    const out = target10.transformSkill(s.data, s.body);
+    const out = target.transformSkill(s.data, s.body);
     if (out) {
       let text = out.text;
-      if (target10.refPointerPrefix !== undefined && target10.refPointerPrefix !== "") {
-        text = text.replace(/`_shared\/references\//g, "`" + target10.refPointerPrefix + "_shared/references/");
+      if (target.refPointerPrefix !== undefined && target.refPointerPrefix !== "") {
+        text = text.replace(/`_shared\/references\//g, "`" + target.refPointerPrefix + "_shared/references/");
       }
       writeOne(join6(dirs.skillsDir, out.relPath), text);
     }
-    if (target10.transformSkillFull) {
-      const full = target10.transformSkillFull(s.data, s.body);
-      if (full && target10.refsDir) {
+    if (target.transformSkillFull) {
+      const full = target.transformSkillFull(s.data, s.body);
+      if (full && target.refsDir) {
         let text = full.text;
-        if (target10.refPointerPrefix !== undefined && target10.refPointerPrefix !== "") {
-          text = text.replace(/`_shared\/references\//g, "`" + target10.refPointerPrefix + "_shared/references/");
+        if (target.refPointerPrefix !== undefined && target.refPointerPrefix !== "") {
+          text = text.replace(/`_shared\/references\//g, "`" + target.refPointerPrefix + "_shared/references/");
         }
-        writeOne(join6(target10.refsDir({ scope, projectDir, home }, s.name), full.relPath), text);
+        writeOne(join6(target.refsDir({ scope, projectDir, home }, s.name), full.relPath), text);
       }
     }
-    if (s.refs.length && target10.refsDir) {
-      const refsRoot = target10.refsDir({ scope, projectDir, home }, s.name);
+    if (s.refs.length && target.refsDir) {
+      const refsRoot = target.refsDir({ scope, projectDir, home }, s.name);
       for (const r of s.refs)
         writeOne(join6(refsRoot, r.relPath), r.text);
     }
   }
   for (const a of agents) {
-    const out = target10.transformAgent({ ...a.data, ...a.internal ? { "internal-agent": "true" } : {} }, a.body);
+    const out = target.transformAgent({ ...a.data, ...a.internal ? { "internal-agent": "true" } : {} }, a.body);
     if (out)
       writeOne(join6(dirs.agentsDir, out.relPath), out.text);
-    if (target10.transformAgentFull) {
-      const full = target10.transformAgentFull(a.data, a.body);
-      if (full && target10.refsDir)
-        writeOne(join6(target10.refsDir({ scope, projectDir, home }, a.name), full.relPath), full.text);
+    if (target.transformAgentFull) {
+      const full = target.transformAgentFull(a.data, a.body);
+      if (full && target.refsDir)
+        writeOne(join6(target.refsDir({ scope, projectDir, home }, a.name), full.relPath), full.text);
     }
   }
   if (sharedRefs.length) {
@@ -875,8 +876,8 @@ function installTo(target10, opts) {
       writeOne(dest, text, 493);
     }
   }
-  if (target10.postInstall) {
-    const post = target10.postInstall({ scope, projectDir, home, dryRun, files: result.written });
+  if (target.postInstall) {
+    const post = target.postInstall({ scope, projectDir, home, dryRun, files: result.written });
     result.written.push(...post.written);
     result.notes.push(...post.notes);
   }
@@ -1062,10 +1063,10 @@ function parsePolicyYaml(text) {
       stack.pop();
     const top = stack[stack.length - 1];
     if (top.pending && !line.startsWith("- ") && indent > top.pending.indent && !Array.isArray(top.obj[top.pending.key])) {
-      const { key: key2, indent: pIndent } = top.pending;
+      const { key, indent: pIndent } = top.pending;
       delete top.pending;
       const created = {};
-      top.obj[key2] = created;
+      top.obj[key] = created;
       stack.push({ keyIndent: pIndent, obj: created });
       return process2(i);
     }
@@ -1617,15 +1618,15 @@ function checkTrail(missionDir, projectRoot) {
     } catch {
       continue;
     }
-    for (const target10 of linkedPaths(body)) {
-      if (isAbsolute(target10))
+    for (const target of linkedPaths(body)) {
+      if (isAbsolute(target))
         continue;
-      const fromMission = join9(missionDir, target10);
-      const fromRoot = join9(projectRoot, target10);
+      const fromMission = join9(missionDir, target);
+      const fromRoot = join9(projectRoot, target);
       if (!existsSync8(fromMission) && !existsSync8(fromRoot)) {
         issues.push({
           kind: "dangling-path",
-          detail: `${relative(projectRoot, f)} links "${target10}" — no such file (mission dir or repo root)`
+          detail: `${relative(projectRoot, f)} links "${target}" — no such file (mission dir or repo root)`
         });
       }
     }
@@ -1852,18 +1853,18 @@ function attachGitNote(projectDir, branch, note, baseSha) {
       console.warn(`attachGitNote: range ${shas.length} >200, falling back to head-only`);
       shas = [];
     }
-    let targets2 = shas;
-    if (!targets2.length) {
+    let targets = shas;
+    if (!targets.length) {
       try {
-        targets2 = [git2(projectDir, ["rev-parse", "--verify", branch])];
+        targets = [git2(projectDir, ["rev-parse", "--verify", branch])];
       } catch {
-        targets2 = [git2(projectDir, ["rev-parse", "HEAD"])];
+        targets = [git2(projectDir, ["rev-parse", "HEAD"])];
       }
     }
-    for (const sha of targets2) {
+    for (const sha of targets) {
       git2(projectDir, ["notes", "--ref=mugiwara", "add", "-f", "-m", note, sha]);
     }
-    return { sha: targets2[0], count: targets2.length };
+    return { sha: targets[0], count: targets.length };
   } catch {
     return null;
   }
@@ -3150,9 +3151,9 @@ Provider total: ${reportedTotal.toLocaleString()} tokens (provider-reported).
     } catch {}
     if (shouldCompress(budget, chars)) {
       try {
-        const flowsDir2 = join18(dir, "flows");
+        const flowsDir = join18(dir, "flows");
         const wavesDir = join18(dir, "waves");
-        const targetDir = existsSync13(flowsDir2) ? flowsDir2 : existsSync13(wavesDir) ? wavesDir : null;
+        const targetDir = existsSync13(flowsDir) ? flowsDir : existsSync13(wavesDir) ? wavesDir : null;
         if (targetDir && existsSync13(targetDir)) {
           const flowFiles = readdirSync7(targetDir).filter((f) => f.endsWith(".md"));
           if (flowFiles.length) {
@@ -3339,7 +3340,7 @@ ${costSection}
       rmSync2(join18(dir, PR_VERDICT_SRC), { force: true });
       removed.push(join18("missions", mission, PR_VERDICT_SRC));
     }
-    for (const f of files.filter((f2) => f2.endsWith(".json")))
+    for (const f of files.filter((f) => f.endsWith(".json")))
       rmSync2(join18(dir, f), { force: true });
     if (existsSync13(artDir) && readdirSync7(artDir).length === 0)
       rmSync2(artDir, { recursive: true, force: true });
@@ -3502,15 +3503,15 @@ function gitActor(cwd) {
   const author = (process.env.GIT_AUTHOR_NAME ?? "").trim();
   if (author)
     return author;
-  const git3 = (args) => {
+  const git = (args) => {
     try {
       return execFileSync5("git", args, { cwd, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
     } catch {
       return "";
     }
   };
-  const name = git3(["config", "user.name"]);
-  const email = git3(["config", "user.email"]);
+  const name = git(["config", "user.name"]);
+  const email = git(["config", "user.email"]);
   if (name && email)
     return `${name} <${email}>`;
   return name || process.env.USER || process.env.USERNAME || "";
@@ -3665,6 +3666,144 @@ function formatResume(e) {
   return `Resumed: ${e.mission}${scope}, Flow ${e.flow}, ${e.tasks_done}/${e.tasks_total} tasks — next_action: ${e.next_action} — run: ${next}`;
 }
 
+// src/initiative.ts
+import { existsSync as existsSync16, readFileSync as readFileSync15 } from "node:fs";
+var SUB_MISSIONS_HEADER = "| ID | Name | Assignee | Branch | Status | Depends On | Touched Files |";
+function splitTouchedFiles(cell) {
+  return cell.split(/[,\s]+/).map((s) => s.trim().replace(/,+$/, "")).filter(Boolean);
+}
+function splitRow(line) {
+  let t = line.trim();
+  if (t.startsWith("|"))
+    t = t.slice(1);
+  if (t.endsWith("|"))
+    t = t.slice(0, -1);
+  return t.split("|").map((c) => c.trim());
+}
+function parseSubMissions(planText) {
+  const lines = planText.split(`
+`);
+  const sectionIdx = lines.findIndex((l) => /^##\s+sub-missions\s*$/i.test(l.trim()));
+  if (sectionIdx < 0)
+    return { hasSection: false, rows: [] };
+  const endIdx = lines.findIndex((l, i) => i > sectionIdx && /^##\s+\S/.test(l.trim()));
+  const body = lines.slice(sectionIdx + 1, endIdx < 0 ? undefined : endIdx);
+  const isTableLine = (l) => /^\s*\|.*\|\s*$/.test(l);
+  const isSeparator = (l) => /^\s*\|?[\s:|-]+\|?[\s:|.-]*$/.test(l) && /-/.test(l);
+  const table = body.filter((l) => isTableLine(l));
+  if (!table.length)
+    return { hasSection: true, rows: [] };
+  const header = splitRow(table[0]).map((c) => c.toLowerCase());
+  const idIdx = header.findIndex((c) => c === "id");
+  const nameIdx = header.findIndex((c) => c === "name");
+  if (idIdx < 0 || nameIdx < 0)
+    return { hasSection: true, rows: [] };
+  const col = (name, fallback) => {
+    const i = header.findIndex((c) => c === name);
+    return i < 0 ? fallback : i;
+  };
+  const touchedIdx = header.findIndex((c) => /touch/.test(c));
+  const dataStart = table.length > 1 && isSeparator(table[1]) ? 2 : 1;
+  const rows = [];
+  for (const line of table.slice(dataStart)) {
+    if (isSeparator(line))
+      continue;
+    const cells = splitRow(line);
+    const id = cells[idIdx] ?? "";
+    if (!id)
+      continue;
+    rows.push({
+      id,
+      name: cells[nameIdx] ?? "",
+      assignee: cells[col("assignee", 2)] ?? "",
+      branch: cells[col("branch", 3)] ?? "",
+      status: cells[col("status", 4)] ?? "",
+      dependsOn: cells[col("depends on", 5)] ?? "",
+      touchedFiles: touchedIdx < 0 ? [] : splitTouchedFiles(cells[touchedIdx] ?? "")
+    });
+  }
+  return { hasSection: true, rows };
+}
+var DONE = /(\[x\]|done|complete|merged|closed)/i;
+function blockedRows(rows) {
+  const statusOf = new Map(rows.map((r) => [r.id.toLowerCase(), r.status]));
+  const out = [];
+  for (const r of rows) {
+    const dep = r.dependsOn.trim();
+    if (!dep || dep === "-")
+      continue;
+    for (const part of dep.split(/[,\s]+/).filter(Boolean)) {
+      const st = statusOf.get(part.toLowerCase());
+      if (st !== undefined && !DONE.test(st)) {
+        out.push({ id: r.id, blockedBy: part });
+        break;
+      }
+      if (st === undefined && !DONE.test(dep)) {
+        out.push({ id: r.id, blockedBy: part });
+        break;
+      }
+    }
+  }
+  return out;
+}
+function findConflicts(rows) {
+  const owners = new Map;
+  for (const r of rows) {
+    for (const f of r.touchedFiles) {
+      const list = owners.get(f) ?? [];
+      if (!list.includes(r.id))
+        list.push(r.id);
+      owners.set(f, list);
+    }
+  }
+  return [...owners.entries()].filter(([, ids]) => ids.length > 1).map(([file, ids]) => ({ file, ids }));
+}
+function runInitiative(sub, planPath) {
+  if (!sub || sub !== "status" && sub !== "conflict-check") {
+    return { code: 1, output: `usage: mugiwara initiative <status|conflict-check> <plan>
+` };
+  }
+  if (!planPath) {
+    return { code: 1, output: `usage: mugiwara initiative ${sub} <plan>
+` };
+  }
+  if (!existsSync16(planPath)) {
+    return { code: 1, output: `mugiwara: plan not found: ${planPath}
+` };
+  }
+  const { hasSection, rows } = parseSubMissions(readFileSync15(planPath, "utf8"));
+  if (!hasSection) {
+    return { code: 0, output: `solo mission (no ## Sub-missions section)
+` };
+  }
+  if (!rows.length) {
+    return {
+      code: 1,
+      output: `mugiwara: ## Sub-missions section present but no rows parsed — expected header:
+${SUB_MISSIONS_HEADER}
+`
+    };
+  }
+  if (sub === "status") {
+    const blocked = new Map(blockedRows(rows).map((b) => [b.id, b.blockedBy]));
+    const lines = ["id | name | assignee | branch | status | blocked-by"];
+    for (const r of rows) {
+      lines.push(`${r.id} | ${r.name} | ${r.assignee} | ${r.branch} | ${r.status} | ${blocked.get(r.id) ?? "-"}`);
+    }
+    return { code: 0, output: lines.join(`
+`) + `
+` };
+  }
+  const conflicts = findConflicts(rows);
+  if (!conflicts.length)
+    return { code: 0, output: `no conflicts: no file is touched by two sub-missions
+` };
+  const lines = conflicts.map((c) => `conflict: ${c.file} touched by ${c.ids.join(", ")}`);
+  return { code: 1, output: lines.join(`
+`) + `
+` };
+}
+
 // src/cli.ts
 var str = (v) => typeof v === "string" ? v : undefined;
 var flag = (v) => v === true;
@@ -3738,6 +3877,8 @@ async function run(argv) {
       return migrateCmd(flags, _);
     case "lesson":
       return lessonCmd(flags, _);
+    case "initiative":
+      return initiativeCmd(flags, _);
     default:
       throw new Error(`Unknown command: ${command}`);
   }
@@ -3780,7 +3921,7 @@ function cleanCmd(flags) {
   const projectDir = resolveProjectDir(str(flags.project));
   const dryRun = flag(flags.dryRun);
   const root = join21(projectDir, ".mugiwara", "missions");
-  if (!existsSync16(root)) {
+  if (!existsSync17(root)) {
     console.log("nothing to clean (.mugiwara/missions/ does not exist).");
     return;
   }
@@ -3801,7 +3942,7 @@ function cleanCmd(flags) {
       return false;
     for (const f of stateFiles(m)) {
       try {
-        const ts = Date.parse(JSON.parse(readFileSync15(join21(root, m, f), "utf8")).updated_at ?? "") || 0;
+        const ts = Date.parse(JSON.parse(readFileSync16(join21(root, m, f), "utf8")).updated_at ?? "") || 0;
         if (ts === 0 || ts >= beforeMs)
           return false;
       } catch {
@@ -3811,7 +3952,7 @@ function cleanCmd(flags) {
     return true;
   };
   if (!flag(flags.all)) {
-    candidates = candidates.filter((m) => existsSync16(join21(root, m, "report.md")) && !hasLiveState(m) || staleBefore(m));
+    candidates = candidates.filter((m) => existsSync17(join21(root, m, "report.md")) && !hasLiveState(m) || staleBefore(m));
   } else if (!flag(flags.force)) {
     const live = candidates.filter((m) => hasLiveState(m) && !staleBefore(m));
     if (live.length) {
@@ -3845,7 +3986,7 @@ async function resolveOptions(flags) {
         scope = await choose(rl, "Install scope?", ["global (user-wide)", "project (this repo)"]) === 0 ? "global" : "project";
     }
     const projectDir = resolveProjectDir(str(flags.project));
-    if (scope === "project" && !existsSync16(projectDir))
+    if (scope === "project" && !existsSync17(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"))
@@ -3858,7 +3999,13 @@ async function resolveOptions(flags) {
         targetIds = idx.includes(0) ? [...TARGET_IDS] : idx.map((i) => TARGET_IDS[i - 1]);
       }
     }
+    const MARKETPLACE = new Set(["cursor", "kimi", "pi"]);
     for (const id of targetIds) {
+      if (MARKETPLACE.has(id)) {
+        console.error(`mugiwara: ${id} installs through its marketplace manifest, not --target.`);
+        console.error("  See docs/reference/harness-matrix.md — marketplace row.");
+        process.exit(1);
+      }
       if (!targets[id])
         throw new Error(`Unknown target: ${id} (valid: ${TARGET_IDS.join(", ")}, all)`);
     }
@@ -3926,7 +4073,7 @@ async function uninstall(flags) {
   if (!manifest) {
     if (scope === "project") {
       const globalFile = manifestPath({ scope: "global", projectDir, home });
-      if (existsSync16(globalFile)) {
+      if (existsSync17(globalFile)) {
         console.log(`No project manifest found, but a global install exists. Try:
   mugiwara uninstall --global`);
         return;
@@ -3964,12 +4111,12 @@ async function uninstall(flags) {
     }
     rmSync3(file);
     const mugiDir = join21(scope === "global" ? home : projectDir, ".mugiwara");
-    if (existsSync16(mugiDir) && readdirSync10(mugiDir).length === 0) {
+    if (existsSync17(mugiDir) && readdirSync10(mugiDir).length === 0) {
       rmSync3(mugiDir, { recursive: true, force: true });
     }
     if (manifest.targets.includes("opencode")) {
       const opencodeCache = join21(home, ".cache", "opencode", "packages", "@ionivetech");
-      if (existsSync16(opencodeCache)) {
+      if (existsSync17(opencodeCache)) {
         rmSync3(opencodeCache, { recursive: true, force: true });
         console.log("   cleared opencode npm cache (stale plugin versions)");
       }
@@ -4006,7 +4153,7 @@ function list(flags) {
       continue;
     found = true;
     if (flag(flags.check)) {
-      const missing = m.files.filter((f) => !existsSync16(f));
+      const missing = m.files.filter((f) => !existsSync17(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}`);
@@ -4024,9 +4171,9 @@ function continueCmd(flags, positionals) {
   if (mission) {
     readState(projectDir);
     const badState = unreadableStateFiles();
-    const target10 = member ? `${mission}/${member}.json` : `${mission}/state.json`;
-    if (badState.includes(target10)) {
-      console.error(`✗ mission "${mission}"${member ? ` member "${member}"` : ""} has unreadable state: ${target10}`);
+    const target = member ? `${mission}/${member}.json` : `${mission}/state.json`;
+    if (badState.includes(target)) {
+      console.error(`✗ mission "${mission}"${member ? ` member "${member}"` : ""} has unreadable state: ${target}`);
       process.exit(1);
     }
   }
@@ -4097,10 +4244,10 @@ function statusCmd(flags) {
 function costCmd(flags, positionals) {
   const projectDir = resolveProjectDir(str(flags.project));
   const mission = str(flags.mission) ?? positionals[1] ?? (() => {
-    const states2 = readState(projectDir);
-    if (states2.length === 1)
-      return states2[0].mission;
-    if (states2.length > 1) {
+    const states = readState(projectDir);
+    if (states.length === 1)
+      return states[0].mission;
+    if (states.length > 1) {
       console.error("multiple missions in flight — specify --mission <id>");
       process.exit(1);
     }
@@ -4111,7 +4258,7 @@ function costCmd(flags, positionals) {
     process.exit(1);
   }
   const missionDir = join21(projectDir, ".mugiwara", "missions", mission);
-  if (!existsSync16(missionDir)) {
+  if (!existsSync17(missionDir)) {
     console.error(`No cost ledger found for mission "${mission}"`);
     process.exit(1);
   }
@@ -4170,7 +4317,7 @@ function blameCmd(flags, positionals) {
 function stalenessLine(projectDir, baseSha) {
   if (!baseSha || baseSha === "unknown")
     return null;
-  const git3 = (args) => {
+  const git = (args) => {
     try {
       return execFileSync6("git", args, { cwd: projectDir, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
     } catch {
@@ -4179,14 +4326,14 @@ function stalenessLine(projectDir, baseSha) {
   };
   let main = "";
   for (const ref of ["main", "master"]) {
-    main = git3(["rev-parse", "--verify", ref]);
+    main = git(["rev-parse", "--verify", ref]);
     if (main)
       break;
   }
   if (!main)
     return null;
   try {
-    const behind = Number(git3(["rev-list", "--count", `${baseSha}..${main}`])) || 0;
+    const behind = Number(git(["rev-list", "--count", `${baseSha}..${main}`])) || 0;
     return behind > 0 ? `⚠ stale base: main is ${behind} commit(s) ahead of this mission's base ${baseSha.slice(0, 7)} — rebase check before continuing` : null;
   } catch {
     return null;
@@ -4247,20 +4394,20 @@ written: ${out}`);
 }
 function lessonCmd(flags, positionals) {
   const projectDir = resolveProjectDir(str(flags.project));
-  const text2 = positionals.slice(1).join(" ").trim();
-  if (!text2) {
+  const text = positionals.slice(1).join(" ").trim();
+  if (!text) {
     console.error('usage: mugiwara lesson "<text>" [--project <dir>]');
     process.exit(1);
   }
   const file = join21(projectDir, ".mugiwara", "lessons.md");
   const date = new Date().toISOString().slice(0, 10);
-  const sanitized = text2.replace(/\|/g, "/").replace(/\r?\n/g, " ").trim();
+  const sanitized = text.replace(/\|/g, "/").replace(/\r?\n/g, " ").trim();
   const line = `| ${date} | manual | general | ${sanitized} |`;
   const header = `| Date | Mission | Area | Lesson |
 |---|---|---|---|`;
   let existing = "";
   try {
-    existing = readFileSync15(file, "utf8");
+    existing = readFileSync16(file, "utf8");
   } catch {}
   if (!existing) {
     mkdirSync10(join21(projectDir, ".mugiwara"), { recursive: true });
@@ -4276,6 +4423,12 @@ function lessonCmd(flags, positionals) {
   }
   console.log(`lesson appended: ${line}`);
 }
+function initiativeCmd(_flags, positionals) {
+  const r = runInitiative(positionals[1], positionals[2]);
+  process.stdout.write(r.output);
+  if (r.code !== 0)
+    process.exit(r.code);
+}
 function migrateCmd(flags, positionals = []) {
   const projectDir = resolveProjectDir(str(flags.project));
   const dryRun = flag(flags.dryRun);
@@ -4294,7 +4447,7 @@ function migrateCmd(flags, positionals = []) {
     const missionsRootInner = join21(projectDir, ".mugiwara", "missions");
     let mission = str(flags.mission) ?? (positionals[1] ? String(positionals[1]) : null);
     const inferMission = () => {
-      if (!existsSync16(missionsRootInner))
+      if (!existsSync17(missionsRootInner))
         return null;
       const all = readdirSync10(missionsRootInner, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name);
       if (mission && all.includes(mission))
@@ -4302,7 +4455,7 @@ function migrateCmd(flags, positionals = []) {
       if (mission)
         return mission;
       if (toTeam) {
-        const candidates = all.filter((m) => existsSync16(join21(missionsRootInner, m, "state.json")));
+        const candidates = all.filter((m) => existsSync17(join21(missionsRootInner, m, "state.json")));
         if (candidates.length === 1)
           return candidates[0];
         if (candidates.length === 0) {
@@ -4312,7 +4465,7 @@ function migrateCmd(flags, positionals = []) {
         console.error(`multiple solo missions: ${candidates.join(", ")} — specify --mission <id>`);
         process.exit(1);
       } else {
-        const candidates = all.filter((m) => existsSync16(join21(missionsRootInner, m, `${member}.json`)));
+        const candidates = all.filter((m) => existsSync17(join21(missionsRootInner, m, `${member}.json`)));
         if (candidates.length === 1)
           return candidates[0];
         if (candidates.length === 0) {
@@ -4335,16 +4488,16 @@ function migrateCmd(flags, positionals = []) {
       const srcContinue = join21(dir, "continue.json");
       const destState = join21(dir, `${member}.json`);
       const destContinue = join21(dir, `continue-${member}.json`);
-      if (!existsSync16(srcState)) {
+      if (!existsSync17(srcState)) {
         console.error(`mission "${targetMission}" has no state.json — already team or not found`);
         process.exit(1);
       }
-      if (existsSync16(destState)) {
+      if (existsSync17(destState)) {
         console.error(`destination ${destState} already exists`);
         process.exit(1);
       }
       const toMove = [{ src: srcState, dest: destState }];
-      if (existsSync16(srcContinue))
+      if (existsSync17(srcContinue))
         toMove.push({ src: srcContinue, dest: destContinue });
       for (const m of toMove) {
         console.log(`${dryRun ? "would migrate" : "migrated"} ${m.src} → ${m.dest}`);
@@ -4354,7 +4507,7 @@ function migrateCmd(flags, positionals = []) {
             renameSync2(m.src, m.dest);
           } catch {
             try {
-              writeFileSync10(m.dest, readFileSync15(m.src));
+              writeFileSync10(m.dest, readFileSync16(m.src));
               rmSync3(m.src, { force: true });
             } catch {}
           }
@@ -4367,7 +4520,7 @@ function migrateCmd(flags, positionals = []) {
       const srcContinue = join21(dir, `continue-${member}.json`);
       const destState = join21(dir, "state.json");
       const destContinue = join21(dir, "continue.json");
-      if (!existsSync16(srcState)) {
+      if (!existsSync17(srcState)) {
         console.error(`mission "${targetMission}" has no ${member}.json`);
         process.exit(1);
       }
@@ -4380,12 +4533,12 @@ function migrateCmd(flags, positionals = []) {
         console.error(`mission "${targetMission}" has ${members.length} members (${members.join(", ")}) — refusing --to-solo (would orphan)`);
         process.exit(1);
       }
-      if (existsSync16(destState)) {
+      if (existsSync17(destState)) {
         console.error(`destination ${destState} already exists`);
         process.exit(1);
       }
       const toMove = [{ src: srcState, dest: destState }];
-      if (existsSync16(srcContinue))
+      if (existsSync17(srcContinue))
         toMove.push({ src: srcContinue, dest: destContinue });
       for (const m of toMove) {
         console.log(`${dryRun ? "would migrate" : "migrated"} ${m.src} → ${m.dest}`);
@@ -4395,7 +4548,7 @@ function migrateCmd(flags, positionals = []) {
             renameSync2(m.src, m.dest);
           } catch {
             try {
-              writeFileSync10(m.dest, readFileSync15(m.src));
+              writeFileSync10(m.dest, readFileSync16(m.src));
               rmSync3(m.src, { force: true });
             } catch {}
           }
@@ -4410,7 +4563,7 @@ function migrateCmd(flags, positionals = []) {
   const missionsRoot = join21(projectDir, ".mugiwara", "missions");
   const moves = [];
   const collect = (srcRoot, isContinue) => {
-    if (!existsSync16(srcRoot))
+    if (!existsSync17(srcRoot))
       return;
     const walk = (dir) => {
       for (const e of readdirSync10(dir, { withFileTypes: true })) {
@@ -4443,7 +4596,7 @@ function migrateCmd(flags, positionals = []) {
   collect(legacyState, false);
   collect(legacyContinue, true);
   if (!moves.length) {
-    if (!existsSync16(legacyState) && !existsSync16(legacyContinue)) {
+    if (!existsSync17(legacyState) && !existsSync17(legacyContinue)) {
       console.log("no legacy layout found (.mugiwara/state/ does not exist)");
     } else {
       console.log("no legacy state files to migrate");
@@ -4455,7 +4608,7 @@ function migrateCmd(flags, positionals = []) {
     if (!dryRun) {
       mkdirSync10(dirname6(m.dest), { recursive: true });
       try {
-        const raw = JSON.parse(readFileSync15(m.src, "utf8"));
+        const raw = JSON.parse(readFileSync16(m.src, "utf8"));
         raw.schema_version = CURRENT_SCHEMA_VERSION;
         writeFileSync10(m.dest, JSON.stringify(raw, null, 2) + `
 `);
@@ -4469,7 +4622,7 @@ function migrateCmd(flags, positionals = []) {
   }
   if (!dryRun) {
     const prune = (root) => {
-      if (!existsSync16(root))
+      if (!existsSync17(root))
         return;
       const walkPrune = (dir) => {
         for (const e of readdirSync10(dir, { withFileTypes: true })) {
@@ -4483,7 +4636,7 @@ function migrateCmd(flags, positionals = []) {
       };
       walkPrune(root);
       try {
-        if (existsSync16(root) && readdirSync10(root).length === 0)
+        if (existsSync17(root) && readdirSync10(root).length === 0)
           rmSync3(root, { recursive: true, force: true });
       } catch {}
     };
@@ -4521,7 +4674,7 @@ function signCmd(flags, _) {
     process.exit(1);
   }
   const missionDir = join21(projectDir, ".mugiwara", "missions", mission);
-  if (!existsSync16(missionDir)) {
+  if (!existsSync17(missionDir)) {
     console.error(`no mission dir: ${missionDir}`);
     process.exit(1);
   }