@ionivetech/mugiwara 0.6.6 → 0.7.0

package/dist/mugiwara.js

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import { existsSync as existsSync10, readFileSync as readFileSync8, readdirSync as readdirSync7, rmSync as rmSync3 } from "node:fs";
-import { spawnSync as spawnSync2 } from "node:child_process";
-import { homedir as homedir2 } from "node:os";
-import { join as join11, resolve as resolve2 } from "node:path";
+import { existsSync as existsSync12, readdirSync as readdirSync9, readFileSync as readFileSync9, rmSync as rmSync3, writeFileSync as writeFileSync8 } from "node:fs";
+import { execFileSync as execFileSync6 } from "node:child_process";
+import { homedir as homedir4 } from "node:os";
+import { join as join15, resolve as resolve2 } from "node:path";
 import { fileURLToPath as fileURLToPath5 } from "node:url";
 
 // src/args.ts
-var VALUE_FLAGS = { "--project": "project", "--target": "target" };
+var VALUE_FLAGS = { "--project": "project", "--target": "target", "--before": "before" };
 var BOOL_FLAGS = {
   "--global": "global",
   "--yes": "yes",
@@ -18,6 +18,7 @@ var BOOL_FLAGS = {
   "--keep-logs": "keepLogs",
   "--check": "check",
   "--all": "all",
+  "--verify": "verify",
   "--help": "help",
   "-h": "help",
   "--version": "version",
@@ -130,7 +131,7 @@ function copyScripts(dstDir) {
     if (!existsSync(src))
       return;
     for (const f of readdirSync(src)) {
-      if (!f.endsWith(".sh") && f !== "initiative.ts" || f === "install.sh")
+      if (!f.endsWith(".sh") || f === "install.sh")
         continue;
       const to = join(dst, f);
       mkdirSync(dst, { recursive: true });
@@ -750,9 +751,11 @@ function installTo(target10, opts) {
         "coverage_modified=80",
         "review_depth=full",
         "quality_depth=full",
+        "verify_merged=off",
         "delegate_threshold=60",
         "heal_max_cycles=3",
-        "verbosity=normal"
+        "verbosity=normal",
+        "# context_budget_chars=150000  # optional: fail archive if trail exceeds this (measured in report Cost section)"
       ].join(`
 `) + `
 `;
@@ -761,7 +764,7 @@ function installTo(target10, opts) {
         writeFileSync3(configPath, body);
       }
       result.written.push(configPath);
-      result.notes.push(`default config written: ${configPath} (run \`mugiwara onboard\` to customise)`);
+      result.notes.push(`default config written: ${configPath} (edit it to customise)`);
     }
   }
   return result;
@@ -802,11 +805,11 @@ function assertNotSymlink(file) {
 }
 var GITIGNORE_BLOCK_START = "# >>> mugiwara >>>";
 var GITIGNORE_BLOCK_END = "# <<< mugiwara <<<";
-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/
-.mugiwara/continue/
+var GITIGNORE_LEGACY = [".mugiwara/state/", "# mugiwara"];
+var GITIGNORE_BLOCK = `# >>> mugiwara >>> — audit trail is the product: commit plan.md, flows/, review.md,
+# decisions.md, blockers.md, report.md under .mugiwara/missions/. Ignore session state.
+.mugiwara/missions/**/*.json
+.mugiwara/index.md
 .mugiwara/config
 .mugiwara/refs/
 # <<< mugiwara <<<
@@ -817,10 +820,10 @@ function ensureProjectGitignore(projectDir, opts = {}) {
   assertNotSymlink(path);
   let existing = existsSync4(path) ? readFileSync3(path, "utf8") : "";
   if (existing) {
-    if (existing.includes(GITIGNORE_BLOCK_START) && existing.includes(".mugiwara/state/")) {
+    if (existing.includes(GITIGNORE_BLOCK_START) && existing.includes(".mugiwara/missions/**/*.json")) {
       return { appended: false, notes: [] };
     }
-    const hadOld = existing.includes(GITIGNORE_MARKER) || existing.includes(GITIGNORE_BLOCK_START);
+    const hadOld = GITIGNORE_LEGACY.some((m) => existing.includes(m)) || existing.includes(GITIGNORE_BLOCK_START);
     if (hadOld) {
       const clean = removeProjectGitignore(projectDir, { dryRun });
       existing = clean.removed ? existsSync4(path) ? readFileSync3(path, "utf8") : "" : existing;
@@ -849,18 +852,20 @@ function removeProjectGitignore(projectDir, { dryRun = false } = {}) {
     if (end < start)
       return { removed: false, notes: ["delimiter mismatch — .gitignore left untouched"] };
     cleaned = current.slice(0, start) + current.slice(end + GITIGNORE_BLOCK_END.length);
-  } else if (current.includes(GITIGNORE_MARKER)) {
+  } else if (current.includes("# mugiwara")) {
     const LEGACY_LINES = new Set([
       ".mugiwara/state.json",
       ".mugiwara/state-*.json",
       ".mugiwara/config",
+      ".mugiwara/state/",
+      ".mugiwara/continue/",
       ".mugiwara/continue.md",
       ".mugiwara/refs/"
     ]);
     const lines = current.split(`
 `).filter((l) => {
       const t = l.trim();
-      if (t.startsWith(GITIGNORE_MARKER))
+      if (t.startsWith("# mugiwara"))
         return false;
       return !LEGACY_LINES.has(t);
     });
@@ -898,19 +903,436 @@ function writeManifest(file, data) {
 }
 
 // src/mission.ts
-import { existsSync as existsSync6, rmSync as rmSync2, readFileSync as readFileSync5, readdirSync as readdirSync4, mkdirSync as mkdirSync5, appendFileSync } from "node:fs";
-import { join as join7 } from "node:path";
+import { existsSync as existsSync8, rmSync as rmSync2, readFileSync as readFileSync7, readdirSync as readdirSync6, mkdirSync as mkdirSync5, writeFileSync as writeFileSync7, renameSync, openSync, writeSync, closeSync } from "node:fs";
+import { execFileSync as execFileSync3 } from "node:child_process";
+import { join as join11 } from "node:path";
+
+// src/integrity.ts
+import { existsSync as existsSync6, readdirSync as readdirSync4, readFileSync as readFileSync5 } from "node:fs";
+import { isAbsolute, join as join7, relative } from "node:path";
+var SECRET_PATTERNS = [
+  [/AKIA[0-9A-Z]{16}/, "AWS access key id"],
+  [/-----BEGIN [A-Z ]*PRIVATE KEY-----/, "private key block"],
+  [/gh[pousr]_[A-Za-z0-9]{20,}/, "GitHub token"],
+  [/xox[baprs]-[A-Za-z0-9-]{10,}/, "Slack token"],
+  [/sk-[A-Za-z0-9]{32,}/, "API key (sk-…)"],
+  [/eyJhbGciOi[A-Za-z0-9_.-]{20,}/, "JWT pasted verbatim"],
+  [/(api[_-]?key|secret|passwd|password)\s*[=:]\s*["'][^"'\s]{8,}["']/i, "credential assignment"]
+];
+var ALLOW_SECRET = "mugiwara:allow-secret";
+function findSecrets(body) {
+  const out = [];
+  for (const line of body.split(/\r?\n/)) {
+    if (line.includes(ALLOW_SECRET))
+      continue;
+    for (const [re, label] of SECRET_PATTERNS) {
+      const hit = line.match(re);
+      if (hit)
+        out.push({ label, hit: hit[0] });
+    }
+  }
+  return out;
+}
+var TRAIL_EXTS = new Set([".md", ".json", ".sh"]);
+function trailFiles(dir) {
+  const out = [];
+  const walk = (d) => {
+    for (const e of readdirSync4(d, { withFileTypes: true })) {
+      const p = join7(d, e.name);
+      if (e.isDirectory())
+        walk(p);
+      else if (TRAIL_EXTS.has(e.name.slice(e.name.lastIndexOf(".")) || ""))
+        out.push(p);
+    }
+  };
+  walk(dir);
+  return out;
+}
+function linkedPaths(md) {
+  const out = [];
+  for (const m of md.matchAll(/\]\(([^)\s]+)\)/g)) {
+    const t = m[1];
+    if (/^(https?:|mailto:|#|\/\/)/.test(t))
+      continue;
+    out.push(t.split("#")[0]);
+  }
+  return out.filter(Boolean);
+}
+function hasCommandOutputShape(body) {
+  return /`[^`]+`/.test(body) || /\b(exit\s+[01]|✓|✗|\bPASS\b|\bFAIL\b|passed|failed|\d+\s+(passed|failed))\b/i.test(body);
+}
+function collectPassCitedPaths(missionDir) {
+  const out = [];
+  for (const f of trailFiles(missionDir)) {
+    let body;
+    try {
+      body = readFileSync5(f, "utf8");
+    } catch {
+      continue;
+    }
+    for (const line of body.split(/\r?\n/)) {
+      if (!/\bPASS\b/.test(line))
+        continue;
+      for (const p of linkedPaths(line))
+        out.push(p);
+      for (const m of line.matchAll(/(?:^|[\s"'(])([a-zA-Z0-9._\/-]+\.(?:md|txt|log|json))\b/g)) {
+        const cand = m[1];
+        if (cand.includes("/"))
+          out.push(cand);
+      }
+    }
+  }
+  return [...new Set(out)];
+}
+function checkTrail(missionDir, projectRoot) {
+  const issues = [];
+  const files = trailFiles(missionDir);
+  for (const f of files) {
+    let body;
+    try {
+      body = readFileSync5(f, "utf8");
+    } catch {
+      continue;
+    }
+    for (const target10 of linkedPaths(body)) {
+      if (isAbsolute(target10))
+        continue;
+      const fromMission = join7(missionDir, target10);
+      const fromRoot = join7(projectRoot, target10);
+      if (!existsSync6(fromMission) && !existsSync6(fromRoot)) {
+        issues.push({
+          kind: "dangling-path",
+          detail: `${relative(projectRoot, f)} links "${target10}" — no such file (mission dir or repo root)`
+        });
+      }
+    }
+    for (const { label, hit } of findSecrets(body)) {
+      issues.push({
+        kind: "secret",
+        detail: `${relative(projectRoot, f)} matches ${label}: ${hit.slice(0, 12)}…`
+      });
+    }
+  }
+  const evidencePaths = [];
+  const evidenceFile = join7(missionDir, "state.json");
+  if (existsSync6(evidenceFile)) {
+    try {
+      const s = JSON.parse(readFileSync5(evidenceFile, "utf8"));
+      if (Array.isArray(s.evidence)) {
+        for (const e of s.evidence) {
+          if (typeof e !== "string" || !e.trim())
+            continue;
+          evidencePaths.push(e);
+          const cand = join7(projectRoot, e);
+          if (!isAbsolute(e) && !existsSync6(cand) && !existsSync6(join7(missionDir, e))) {
+            issues.push({ kind: "evidence", detail: `state.json evidence "${e}" does not exist` });
+          }
+        }
+      }
+    } catch {}
+  }
+  const passCited = collectPassCitedPaths(missionDir);
+  for (const e of passCited) {
+    if (!e.trim() || isAbsolute(e))
+      continue;
+    const candMission = join7(missionDir, e);
+    const candRoot = join7(projectRoot, e);
+    const resolved = existsSync6(candMission) ? candMission : existsSync6(candRoot) ? candRoot : null;
+    if (!resolved)
+      continue;
+    let body;
+    try {
+      body = readFileSync5(resolved, "utf8");
+    } catch {
+      continue;
+    }
+    if (!hasCommandOutputShape(body)) {
+      issues.push({ kind: "evidence-thin", detail: `evidence "${e}" exists but lacks command output (no backticked command or exit-status token)` });
+    }
+  }
+  return issues;
+}
+function formatIssues(issues) {
+  return issues.map((i) => `  ✗ [${i.kind}] ${i.detail}`).join(`
+`);
+}
+
+// src/rollback.ts
+import { execFileSync } from "node:child_process";
+import { writeFileSync as writeFileSync5 } from "node:fs";
+import { join as join8 } from "node:path";
+function git(cwd, args) {
+  return execFileSync("git", args, { cwd, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+}
+function buildRollback(input, commitsNewestFirst, filesTouched) {
+  const lines = [
+    "#!/usr/bin/env bash",
+    `# Rollback map for mission "${input.mission}" — generated at closure.`,
+    "# Human-executed. Review before running; mugiwara never runs this.",
+    `# Branch: ${input.branch}`,
+    `# Base:   ${input.baseSha}`,
+    "",
+    "set -euo pipefail",
+    ""
+  ];
+  if (!commitsNewestFirst.length && !filesTouched.length) {
+    lines.push("# No commits between base and HEAD on this branch — nothing to revert.", "");
+    return lines.join(`
+`);
+  }
+  if (!commitsNewestFirst.length) {
+    lines.push("# UNRESOLVED: squash-merged state detected.", `# git rev-list ${input.baseSha}..${input.branch} is empty, but the diff`, `# ${input.baseSha}..${input.branch} touches ${filesTouched.length} file(s):`, "# the mission's changes were collapsed into commit(s) already on the base", "# ref. No per-commit revert list can be derived automatically.", "# Locate the squash commit, review it, then revert it:", `#   git log --oneline ${input.baseSha}..HEAD --grep="${input.mission}"`, "#   git revert <squash-commit>", "# Files carrying the squashed changes (verify each after reverting):", ...filesTouched.map((f) => `#   ${f}`), "", 'echo "ROLLBACK INCOMPLETE: squash-merged state — locate and revert the squash commit manually" >&2', "exit 1", "");
+    return lines.join(`
+`);
+  }
+  lines.push("# Revert newest-first so earlier reverts never conflict with later ones.", "git revert --no-edit \\", commitsNewestFirst.map((c) => `  ${c}`).join(" \\\n"), "");
+  if (filesTouched.length) {
+    lines.push("# Files this mission touched (verify the working tree is clean afterwards):", ...filesTouched.map((f) => `#   ${f}`), "");
+  }
+  return lines.join(`
+`);
+}
+function generateRollback(projectDir, missionDir, input) {
+  try {
+    const range = `${input.baseSha}..${input.branch}`;
+    const revList = git(projectDir, ["rev-list", "--reverse", range]).split(/\r?\n/).filter(Boolean);
+    const commitsNewestFirst = [...revList].reverse();
+    const filesTouched = input.baseSha === "unknown" ? [] : git(projectDir, ["diff", "--name-only", input.baseSha, input.branch]).split(/\r?\n/).filter(Boolean);
+    const body = buildRollback(input, commitsNewestFirst, filesTouched);
+    const file = join8(missionDir, "rollback.sh");
+    writeFileSync5(file, body, { mode: 493 });
+    return { file: "rollback.sh", commits: commitsNewestFirst.length };
+  } catch {
+    return null;
+  }
+}
+
+// src/provenance.ts
+import { execFileSync as execFileSync2 } from "node:child_process";
+import { writeFileSync as writeFileSync6 } from "node:fs";
+import { join as join9 } from "node:path";
+function git2(cwd, args) {
+  return execFileSync2("git", args, { cwd, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+}
+function modelLabel() {
+  return process.env.MUGIWARA_MODEL?.trim() || process.env.ANTHROPIC_MODEL?.trim() || "model-unrecorded (set MUGIWARA_MODEL to attribute)";
+}
+function buildNote(s) {
+  const gates = s.evidence.length ? s.evidence.join(" · ") : "no evidence recorded";
+  const uniqModels = [...new Set((s.models ?? []).filter(Boolean))];
+  const modelPart = uniqModels.length ? `model(s): ${uniqModels.join(", ")}` : s.model ?? modelLabel();
+  return [
+    `mission: ${s.mission}`,
+    `agent: ${s.actor || "unknown"} · ${modelPart} · lane ${s.lane} · mode ${s.mode}`,
+    `tasks: ${s.tasks_done}/${s.tasks_total}`,
+    `gates/evidence: ${gates}`,
+    `branch: ${s.branch}`,
+    "human review: pending (PR review is the terminal gate)"
+  ].join(`
+`);
+}
+function renderProvenanceMd(note, sha) {
+  const lines = [
+    "# Provenance",
+    "",
+    "<!-- paste below into the PR description or a PR comment -->",
+    "",
+    "```",
+    note,
+    "```",
+    "",
+    sha ? `Commit: ${sha}` : "Commit: not recorded (no git head resolved at closure)",
+    "",
+    "Query locally after pushing notes:",
+    "`git fetch origin refs/notes/mugiwara:refs/notes/mugiwara` then `mugiwara blame <path>`."
+  ];
+  return lines.join(`
+`) + `
+`;
+}
+function attachGitNote(projectDir, branch, note) {
+  try {
+    let sha;
+    try {
+      sha = git2(projectDir, ["rev-parse", "--verify", branch]);
+    } catch {
+      sha = git2(projectDir, ["rev-parse", "HEAD"]);
+    }
+    git2(projectDir, ["notes", "--ref=mugiwara", "add", "-f", "-m", note, sha]);
+    return { sha };
+  } catch {
+    return null;
+  }
+}
+function blamePath(projectDir, path) {
+  let sha;
+  try {
+    sha = git2(projectDir, ["log", "-1", "--format=%H", "--", path]);
+  } catch {
+    return `blame: not a git repository (${projectDir})`;
+  }
+  if (!sha)
+    return `blame: no commit touches "${path}"`;
+  try {
+    const note = git2(projectDir, ["notes", "--ref=mugiwara", "show", sha]);
+    return `${path} @ ${sha.slice(0, 7)}
+${note}`;
+  } catch {
+    return `${path} @ ${sha.slice(0, 7)}
+(no mugiwara provenance note on this commit)`;
+  }
+}
+function writeProvenance(projectDir, missionDir, state) {
+  const note = buildNote(state);
+  const attached = attachGitNote(projectDir, state.branch, note);
+  writeFileSync6(join9(missionDir, "provenance.md"), renderProvenanceMd(note, attached ? attached.sha : null));
+}
+
+// src/routing.ts
+var DOC_PAT = /\.(md|txt|rst)$|^docs\/|^(CHANGELOG|LICENSE|README)/;
+var TEST_PAT = /\.(test|spec)\.[cm]?[jt]sx?$|(^|\/)(tests?|__tests__|specs?)\//;
+function scorePath(path, sensitivePaths, evidenceJoined) {
+  const reasons = [];
+  let score = 0;
+  const sensitiveHit = sensitivePaths.some((s) => s && (path === s || path.startsWith(s.replace(/\/?$/, "/")) || new RegExp(s.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*\*/g, ".*").replace(/\*/g, "[^/]*")).test(path)));
+  if (sensitiveHit) {
+    score += 100;
+    reasons.push("sensitive path");
+  }
+  if (!DOC_PAT.test(path) && !TEST_PAT.test(path)) {
+    score += 50;
+    reasons.push("production code");
+  } else if (TEST_PAT.test(path)) {
+    score += 10;
+    reasons.push("test scaffolding — skim unless behavior changed");
+  } else {
+    score += 5;
+    reasons.push("docs/config");
+  }
+  if (!evidenceJoined.includes(path)) {
+    score += 20;
+    reasons.push("not covered by recorded evidence");
+  }
+  return { score, reasons };
+}
+function rankFiles(paths, state) {
+  const sensitive = state.sensitive_paths ?? [];
+  const ev = state.evidence.join(" ");
+  return paths.map((path) => {
+    const { score, reasons } = scorePath(path, sensitive, ev);
+    return { path, score, reasons };
+  }).sort((a, b) => b.score - a.score || a.path.localeCompare(b.path));
+}
+function renderRouting(ranked, mission) {
+  if (!ranked.length)
+    return "";
+  const lines = [
+    "",
+    "## Review routing",
+    "",
+    `Ranked reading order for \`${mission}\` (heuristic ordering — it decides where to look first, never correctness):`,
+    ""
+  ];
+  ranked.forEach((r, i) => {
+    lines.push(`${i + 1}. \`${r.path}\` — ${r.reasons.join("; ")}`);
+  });
+  lines.push("");
+  return lines.join(`
+`);
+}
+
+// src/budget.ts
+import { existsSync as existsSync7, readdirSync as readdirSync5, readFileSync as readFileSync6, statSync } from "node:fs";
+import { homedir as homedir2 } from "node:os";
+import { join as join10 } from "node:path";
+function readBudgetConfig(projectDir) {
+  for (const base of [projectDir, homedir2()]) {
+    const file = join10(base, ".mugiwara", "config");
+    if (!existsSync7(file))
+      continue;
+    for (const line of readFileSync6(file, "utf8").split(/\r?\n/)) {
+      const t = line.trim();
+      if (!t || t.startsWith("#"))
+        continue;
+      const eq = t.indexOf("=");
+      if (eq === -1)
+        continue;
+      if (t.slice(0, eq).trim() !== "context_budget_chars")
+        continue;
+      const n = Number(t.slice(eq + 1).trim());
+      return Number.isFinite(n) && n > 0 ? n : 0;
+    }
+  }
+  return 0;
+}
+function measureContextChars(missionDir) {
+  let total = 0;
+  const add = (p) => {
+    try {
+      total += statSync(p).size;
+    } catch {}
+  };
+  for (const f of readdirSync5(missionDir)) {
+    if (/\.md$/.test(f))
+      add(join10(missionDir, f));
+  }
+  for (const sub of ["flows", "waves"]) {
+    const dir = join10(missionDir, sub);
+    if (existsSync7(dir)) {
+      for (const f of readdirSync5(dir))
+        add(join10(dir, f));
+    }
+  }
+  return total;
+}
+function formatFootprint(chars, budget) {
+  const base = `Context footprint: ${chars} chars`;
+  if (!budget)
+    return `${base} (no budget configured)`;
+  return chars > budget ? `${base} — OVER budget ${budget}` : `${base} (budget ${budget})`;
+}
+
+// src/mission.ts
+function isStateFile(f) {
+  const stem = f.replace(/\.json$/, "");
+  return f.endsWith(".json") && stem !== "continue" && !stem.startsWith("continue-");
+}
+function primaryState(dir, files) {
+  const name = files.includes("state.json") ? "state.json" : files.find((f) => f.endsWith(".json") && f !== "continue.json" && !f.startsWith("continue-"));
+  if (!name)
+    return null;
+  try {
+    return JSON.parse(readFileSync7(join11(dir, name), "utf8"));
+  } catch {
+    return null;
+  }
+}
+function changedFiles(projectDir, state) {
+  const base = typeof state?.base_sha === "string" ? state.base_sha : "";
+  const branch = typeof state?.branch === "string" ? state.branch : "";
+  if (!base || base === "unknown" || !branch)
+    return [];
+  try {
+    return execFileSync3("git", ["diff", "--name-only", base, branch], {
+      cwd: projectDir,
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"]
+    }).split(/\r?\n/).filter(Boolean);
+  } catch {
+    return [];
+  }
+}
 function activeActor(projectDir) {
-  const stateDir = join7(projectDir, ".mugiwara", "state");
-  if (!existsSync6(stateDir))
+  const missionsDir = join11(projectDir, ".mugiwara", "missions");
+  if (!existsSync8(missionsDir))
     return null;
-  const missions = readdirSync4(stateDir, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name);
+  const missions = readdirSync6(missionsDir, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name);
   let latest = null;
   for (const mission of missions) {
-    const d = join7(stateDir, mission);
-    for (const f of readdirSync4(d).filter((f2) => f2.endsWith(".json"))) {
+    const d = join11(missionsDir, mission);
+    for (const f of readdirSync6(d).filter(isStateFile)) {
       try {
-        const s = JSON.parse(readFileSync5(join7(d, f), "utf8"));
+        const s = JSON.parse(readFileSync7(join11(d, f), "utf8"));
         const t = Date.parse(s.updated_at || "") || 0;
         if (!latest || t > latest.updated)
           latest = { actor: s.actor || null, updated: t };
@@ -920,8 +1342,8 @@ function activeActor(projectDir) {
   return latest ? latest.actor : null;
 }
 function resetMission(projectDir, keepLogs, force) {
-  const root = join7(projectDir, ".mugiwara");
-  if (!existsSync6(root))
+  const root = join11(projectDir, ".mugiwara");
+  if (!existsSync8(root))
     return { removed: [], kept: [] };
   if (!force) {
     const actor = activeActor(projectDir);
@@ -931,361 +1353,249 @@ function resetMission(projectDir, keepLogs, force) {
   }
   const removed = [];
   const kept = [];
-  for (const dir of ["spec", "plans", "results", "review", "issues", "reports"]) {
-    const p = join7(root, dir);
-    if (existsSync6(p)) {
-      rmSync2(p, { recursive: true, force: true });
-      removed.push(dir);
-    }
-  }
-  for (const dir of ["state", "continue"]) {
-    const p = join7(root, dir);
-    if (existsSync6(p)) {
+  for (const dir of ["missions", "spec", "plans", "results", "review", "issues", "reports", "state", "continue"]) {
+    const p = join11(root, dir);
+    if (existsSync8(p)) {
       rmSync2(p, { recursive: true, force: true });
       removed.push(dir);
     }
   }
-  for (const f of readdirSync4(root)) {
+  for (const f of readdirSync6(root)) {
     if (/^state(-.+)?\.json$/.test(f)) {
-      const p = join7(root, f);
-      if (existsSync6(p)) {
+      const p = join11(root, f);
+      if (existsSync8(p)) {
         rmSync2(p);
         removed.push(f);
       }
     }
   }
   if (!keepLogs) {
-    const p = join7(root, "logs");
-    if (existsSync6(p)) {
-      rmSync2(p, { recursive: true, force: true });
-      removed.push("logs");
+    for (const p of [join11(root, "lessons.md"), join11(root, "logs")]) {
+      if (existsSync8(p)) {
+        rmSync2(p, { recursive: true, force: true });
+        removed.push(p.startsWith(join11(root, "logs")) ? "logs" : "lessons.md");
+      }
     }
-  } else if (existsSync6(join7(root, "logs"))) {
-    kept.push("logs");
+  } else {
+    if (existsSync8(join11(root, "lessons.md")))
+      kept.push("lessons.md");
+    else if (existsSync8(join11(root, join11("logs", "lessons.md"))))
+      kept.push(join11("logs", "lessons.md"));
   }
   for (const f of ["config", "manifest.json", "backup"]) {
-    if (existsSync6(join7(root, f)))
+    if (existsSync8(join11(root, f)))
       kept.push(f);
   }
   return { removed, kept };
 }
 function archiveMission(projectDir, mission, opts = {}) {
   const { dryRun = false } = opts;
-  const root = join7(projectDir, ".mugiwara");
+  const root = join11(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)) {
-      kept.push(join7("results", mission, f));
+  const dir = join11(root, "missions", mission);
+  if (!existsSync8(dir))
+    return { report: null, removed, kept };
+  if (!dryRun) {
+    const issues = checkTrail(dir, projectDir);
+    if (issues.length) {
+      throw new Error(`closure integrity gate failed — fix these before archiving:
+${formatIssues(issues)}`);
     }
   }
-  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));
+  const files = readdirSync6(dir);
+  const state = primaryState(dir, files);
+  const stageModels = [...new Set(files.filter(isStateFile).map((f) => {
+    try {
+      const s = JSON.parse(readFileSync7(join11(dir, f), "utf8"));
+      return typeof s.model === "string" ? s.model : "";
+    } catch {
+      return "";
     }
-  }
-  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));
+  }).filter(Boolean))];
+  let costSection = "";
+  if (!dryRun && state) {
+    const chars = measureContextChars(dir);
+    const budget = readBudgetConfig(projectDir);
+    const footprintLine = formatFootprint(chars, budget);
+    if (budget && chars > budget) {
+      throw new Error(`closure context budget failed — ${footprintLine}. Trim the trail or raise context_budget_chars.`);
     }
-  }
-  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 est = typeof state.tokens_est === "number" ? state.tokens_est : 0;
+    const src = typeof state.tokens_source === "string" ? state.tokens_source : "computed";
+    const lane = typeof state.lane === "string" ? state.lane : "unknown";
+    const laneBudget = lane === "lean" ? 12000 : lane === "standard" ? 25000 : lane === "full" ? 50000 : lane === "spike" ? 3000 : 0;
+    const effBudget = budget || laneBudget;
+    const pct = effBudget ? Math.round(est / effBudget * 100) : 0;
+    const delta = effBudget ? est <= effBudget ? `${(effBudget - est).toLocaleString()} under` : `${(est - effBudget).toLocaleString()} over` : "no budget configured";
+    const srcLabel = src === "reported" ? "provider-reported" : "estimator";
+    let reportedTotal = 0;
+    let hasReported = false;
+    for (const f of files.filter(isStateFile)) {
+      try {
+        const s = JSON.parse(readFileSync7(join11(dir, f), "utf8"));
+        if (s.tokens_source === "reported" && typeof s.tokens_est === "number") {
+          reportedTotal += s.tokens_est;
+          hasReported = true;
+        }
+      } catch {}
     }
+    if (!hasReported && src === "reported" && est > 0) {
+      reportedTotal = est;
+      hasReported = true;
+    }
+    costSection = [
+      "## Cost",
+      "",
+      "| Metric | Value |",
+      "|--------|-------|",
+      `| **Tokens used** | ${est.toLocaleString()} (${srcLabel}) |`,
+      `| **Lane** | ${lane} (budget ${effBudget ? effBudget.toLocaleString() : "—"} · warn ${effBudget ? Math.round(effBudget * 1.5).toLocaleString() : "—"} · stop ${effBudget ? (effBudget * 3).toLocaleString() : "—"}) |`,
+      `| **Budget status** | ${effBudget ? `${pct}% of budget · ${delta} · ${est >= effBudget * 3 ? "STOP" : est >= effBudget * 1.5 ? "WARN" : "OK"}` : "no lane budget"} |`,
+      `| **Context footprint** | ${chars.toLocaleString()} chars${budget ? ` (budget ${budget.toLocaleString()})` : " (no context budget configured)"} |`
+    ].join(`
+`);
+    if (hasReported) {
+      costSection += `
+| **Provider total** | ${reportedTotal.toLocaleString()} (provider-reported — sum of reported stages) |`;
+    }
+    costSection += `
+`;
   }
-  const contDir = join7(root, "continue", mission);
-  if (existsSync6(contDir)) {
-    if (!dryRun)
-      rmSync2(contDir, { recursive: true, force: true });
-    removed.push(join7("continue", mission));
-  }
-  const stateDir = join7(root, "state", mission);
-  if (existsSync6(stateDir)) {
-    if (!dryRun)
-      rmSync2(stateDir, { recursive: true, force: true });
-    removed.push(join7("state", mission));
-  }
-  if (report)
-    kept.push(report);
-  for (const k of ["plans", "config", join7("logs", "lessons.md")]) {
-    if (existsSync6(join7(root, k)))
-      kept.push(k);
-  }
+  const FOLD_TOP = ["decisions.md", "blockers.md", "review.md", "security.md", "spec.md"];
+  const fold = [];
+  for (const f of FOLD_TOP) {
+    if (files.includes(f))
+      fold.push(f);
+  }
+  const flowsDir = join11(dir, "flows");
+  const legacyWavesDir = join11(dir, "waves");
+  const artDir = existsSync8(flowsDir) ? flowsDir : existsSync8(legacyWavesDir) ? legacyWavesDir : flowsDir;
+  const artRel = artDir === legacyWavesDir ? "waves" : "flows";
+  if (existsSync8(artDir)) {
+    for (const f of readdirSync6(artDir).sort())
+      fold.push(join11(artRel, f));
+  }
+  let report = "";
+  const reportPath = join11(dir, "report.md");
+  if (files.includes("report.md"))
+    report = readFileSync7(reportPath, "utf8");
+  else if (existsSync8(join11(artDir, "06-closure.md")))
+    report = readFileSync7(join11(artDir, "06-closure.md"), "utf8");
+  if (!dryRun) {
+    mkdirSync5(dir, { recursive: true });
+    if (fold.length) {
+      const sections = fold.map((f) => {
+        const body = readFileSync7(join11(dir, f), "utf8").trim();
+        const name = f.includes("/") ? f.split("/").pop() ?? f : f;
+        return `
+
+## Archived: ${name}
+
+${body}`;
+      }).join("");
+      const tmp = `${reportPath}.tmp`;
+      const routingSection = state ? renderRouting(rankFiles(changedFiles(projectDir, state), {
+        mission,
+        evidence: Array.isArray(state.evidence) ? state.evidence : [],
+        sensitive_paths: Array.isArray(state.sensitive_paths) ? state.sensitive_paths : []
+      }), mission) : "";
+      writeFileSync7(tmp, report.trimEnd() + sections + (routingSection || "") + (costSection ? `
+${costSection}
+` : "") + `
+`);
+      renameSync(tmp, reportPath);
+    }
+    for (const f of fold) {
+      rmSync2(join11(dir, f), { force: true, recursive: true });
+      removed.push(join11("missions", mission, f));
+    }
+    for (const f of files.filter((f2) => f2.endsWith(".json")))
+      rmSync2(join11(dir, f), { force: true });
+    if (existsSync8(artDir) && readdirSync6(artDir).length === 0)
+      rmSync2(artDir, { recursive: true, force: true });
+    if (!existsSync8(reportPath)) {
+      writeFileSync7(reportPath, `# Mission: ${mission}
+
+Archived before closure — no wave artifacts were present.
+`);
+    }
+    if (state && typeof state.branch === "string") {
+      const rb = generateRollback(projectDir, dir, {
+        mission,
+        branch: state.branch,
+        baseSha: typeof state.base_sha === "string" ? state.base_sha : "unknown"
+      });
+      if (rb)
+        kept.push(join11("missions", mission, rb.file));
+      try {
+        writeProvenance(projectDir, dir, {
+          mission,
+          actor: typeof state.actor === "string" ? state.actor : "",
+          lane: typeof state.lane === "string" ? state.lane : "",
+          mode: typeof state.mode === "string" ? state.mode : "",
+          branch: state.branch,
+          tasks_done: Number(state.tasks_done) || 0,
+          tasks_total: Number(state.tasks_total) || 0,
+          evidence: Array.isArray(state.evidence) ? state.evidence : [],
+          models: stageModels
+        });
+        kept.push(join11("missions", mission, "provenance.md"));
+      } catch {}
+    }
+  } else {
+    for (const f of fold)
+      removed.push(join11("missions", mission, f));
+  }
+  removed.push(join11("missions", mission, "<session state>"));
+  if (files.includes("plan.md"))
+    kept.push(join11("missions", mission, "plan.md"));
+  if (files.includes("handoff.md"))
+    kept.push(join11("missions", mission, "handoff.md"));
+  kept.push(join11("missions", mission, "report.md"));
   let index;
-  const indexFile = join7(root, "reports", "index.md");
-  const line = `- ${mission} — ${new Date().toISOString().slice(0, 10)}${report ? ` → ${report}` : ""}
+  const indexFile = join11(root, "index.md");
+  const line = `- ${mission} — ${new Date().toISOString().slice(0, 10)}
 `;
   if (!dryRun) {
-    mkdirSync5(join7(root, "reports"), { recursive: true });
-    const existing = existsSync6(indexFile) ? readFileSync5(indexFile, "utf8") : "";
+    const existing = existsSync8(indexFile) ? readFileSync7(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/onboard.ts
-import { existsSync as existsSync7, lstatSync as lstatSync2, mkdirSync as mkdirSync6, readFileSync as readFileSync6, writeFileSync as writeFileSync5 } from "node:fs";
-import { join as join8 } from "node:path";
-var DEFAULT_ORDER = [
-  "mode",
-  "branch",
-  "commit",
-  "auto_commit",
-  "coverage_new",
-  "coverage_modified",
-  "review_depth",
-  "quality_depth",
-  "delegate_threshold",
-  "heal_max_cycles",
-  "verbosity"
-];
-var DEFAULTS = {
-  auto_commit: "on",
-  delegate_threshold: "60",
-  heal_max_cycles: "3",
-  verbosity: "normal"
-};
-var BRANCH_PRESETS = {
-  1: "feature/{type}-{issue}-{slug}",
-  2: "feature/{slug}",
-  3: "feat/{slug}"
-};
-var COMMIT_PRESETS = {
-  1: "conventional",
-  2: "gitmoji",
-  3: "plain"
-};
-function parseConfig(lines) {
-  const map = new Map;
-  for (const line of lines) {
-    const t = line.trim();
-    if (!t || t.startsWith("#"))
-      continue;
-    const eq = t.indexOf("=");
-    if (eq === -1)
-      continue;
-    const k = t.slice(0, eq).trim();
-    const v = t.slice(eq + 1).trim();
-    if (!map.has(k))
-      map.set(k, v);
-  }
-  return map;
-}
-function buildConfig(existing, updates) {
-  const merged = new Map(existing);
-  for (const [k, v] of Object.entries(updates))
-    merged.set(k, v);
-  const lines = [];
-  for (const k of DEFAULT_ORDER) {
-    const v = merged.get(k) ?? DEFAULTS[k];
-    if (v === undefined)
-      continue;
-    lines.push(`${k}=${v}`);
-    merged.delete(k);
-  }
-  for (const [k, v] of merged)
-    lines.push(`${k}=${v}`);
-  return lines.join(`
-`) + `
-`;
-}
-async function askFreeText(rl, prompt) {
-  for (;; ) {
-    const v = (await rl.question(prompt)).trim();
-    if (v)
-      return v;
-    console.log("  Cannot be empty.");
-  }
-}
-function assertNotSymlink2(file) {
-  if (!existsSync7(file))
-    return;
-  try {
-    if (lstatSync2(file).isSymbolicLink())
-      throw new Error(`refusing to follow symlink: ${file}`);
-  } catch (e) {
-    if (e.code === "ENOENT")
-      return;
-    throw e;
-  }
-}
-async function runOnboard(projectDir) {
-  if (!process.stdin.isTTY) {
-    throw new Error("Not a terminal. Run `mugiwara onboard` in a terminal, or edit .mugiwara/config directly.");
-  }
-  const mugiwaraDir = join8(projectDir, ".mugiwara");
-  const configPath = join8(mugiwaraDir, "config");
-  assertNotSymlink2(configPath);
-  const existing = parseConfig(existsSync7(configPath) ? readFileSync6(configPath, "utf8").split(/\r?\n/) : []);
-  const rl = createRl();
-  try {
-    console.log("");
-    console.log("╔══════════════════════════════════════╗");
-    console.log("║   Mugiwara Onboarding Wizard         ║");
-    console.log("╚══════════════════════════════════════╝");
-    console.log("");
-    if (existing.size > 0) {
-      const redo = await confirm(rl, "Existing .mugiwara/config found. Re-onboard?");
-      if (!redo) {
-        console.log("Onboarding cancelled. Config preserved.");
-        return;
+      const fd = openSync(indexFile, "a");
+      try {
+        writeSync(fd, header + line);
+      } finally {
+        closeSync(fd);
       }
-      console.log("");
-    }
-    const branchChoice = await choose(rl, "Q1 — Branch naming pattern:", [
-      "Trunk-based — feature/{type}-{issue}-{slug}",
-      "GitFlow — feature/{slug}",
-      "GitHub Flow — feat/{slug}",
-      "Custom — enter your own pattern"
-    ]);
-    let branch;
-    if (branchChoice === 3) {
-      branch = await askFreeText(rl, "  Branch pattern (placeholders: {type} {issue} {slug}, e.g. {issue}-{slug}): ");
-    } else {
-      branch = BRANCH_PRESETS[branchChoice + 1];
     }
-    const modeIdx = await choose(rl, "Q2 — Autonomy mode:", [
-      "guided — ask before every wave transition",
-      "semi — auto-advance through waves, pause on failures",
-      "auto — full auto-pilot"
-    ]);
-    const mode = ["guided", "semi", "auto"][modeIdx];
-    const reviewIdx = await choose(rl, "Q3 — Code review depth:", [
-      "full — breaking-change map, five-axis review, <=3 cycles",
-      "standard — five-axis review, 1 cycle",
-      "quick — diff-only, no caller-map"
-    ]);
-    const reviewDepth = ["full", "standard", "quick"][reviewIdx];
-    const qualityIdx = await choose(rl, "Q4 — Quality check depth:", [
-      "full — format, lint, typecheck, test, build",
-      "standard — lint, typecheck, test",
-      "quick — test only"
-    ]);
-    const qualityDepth = ["full", "standard", "quick"][qualityIdx];
-    const covIdx = await choose(rl, "Q5 — Test coverage threshold:", [
-      "90/80 — new code 90%, modified 80%",
-      "80/70 — new code 80%, modified 70%",
-      "custom — enter your own values",
-      "none — 0/0, no coverage enforcement"
-    ]);
-    let coverageNew = 90;
-    let coverageModified = 80;
-    if (covIdx === 1) {
-      coverageNew = 80;
-      coverageModified = 70;
-    } else if (covIdx === 2) {
-      coverageNew = Number.parseInt(await askFreeText(rl, "  Coverage for new code (%): "), 10) || 0;
-      coverageModified = Number.parseInt(await askFreeText(rl, "  Coverage for modified code (%): "), 10) || 0;
-    } else if (covIdx === 3) {
-      coverageNew = 0;
-      coverageModified = 0;
-    }
-    const commitChoice = await choose(rl, "Q6 — Commit style:", [
-      "Conventional Commits — feat:, fix:, chore:, docs:",
-      "Gitmoji — emoji-prefixed conventional",
-      "Plain — no prefix, imperative sentence",
-      "Custom template — enter your own (placeholders: {type} {issue} {title})"
-    ]);
-    let commit;
-    if (commitChoice === 3) {
-      commit = await askFreeText(rl, "  Commit template (e.g. {issue}: {title}): ");
-    } else {
-      commit = COMMIT_PRESETS[commitChoice + 1];
-    }
-    if (!existsSync7(mugiwaraDir))
-      mkdirSync6(mugiwaraDir, { recursive: true });
-    const body = buildConfig(existing, {
-      mode,
-      branch,
-      commit,
-      coverage_new: String(coverageNew),
-      coverage_modified: String(coverageModified),
-      review_depth: reviewDepth,
-      quality_depth: qualityDepth
-    });
-    writeFileSync5(configPath, `# .mugiwara/config — written by mugiwara onboard on ${new Date().toISOString().slice(0, 10)}
-${body}`);
-    console.log("╔══════════════════════════════════════╗");
-    console.log("║   Onboarding Complete                ║");
-    console.log("╚══════════════════════════════════════╝");
-    console.log("");
-    console.log(`  Branch pattern:   ${branch}`);
-    console.log(`  Autonomy mode:    ${mode}`);
-    console.log(`  Review depth:     ${reviewDepth}`);
-    console.log(`  Quality depth:    ${qualityDepth}`);
-    console.log(`  Coverage:         ${coverageNew}/${coverageModified}`);
-    console.log(`  Commit style:     ${commit}`);
-    console.log("");
-    console.log(`  Config written:   ${configPath}`);
-    console.log("");
-  } finally {
-    rl.close();
+    index = "index.md";
   }
+  return { report: join11("missions", mission, "report.md"), removed, kept, index };
 }
 
 // src/run.ts
-import { existsSync as existsSync8, readdirSync as readdirSync5 } from "node:fs";
+import { existsSync as existsSync9, readdirSync as readdirSync7 } from "node:fs";
 import { spawnSync } from "node:child_process";
-import { dirname as dirname5, join as join9, resolve } from "node:path";
+import { dirname as dirname5, join as join12, resolve } from "node:path";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
 var here3 = dirname5(fileURLToPath4(import.meta.url));
-var SCRIPTS_DIR = join9(here3, "..", "scripts");
-var RUNNABLE = ["savepoint.sh", "lane.sh", "evidence.sh", "mission-report.sh"];
+var SCRIPTS_DIR = join12(here3, "..", "scripts");
+var RUNNABLE = ["savepoint.sh", "lane.sh"];
 function findBash() {
   const explicit = process.env.MUGIWARA_BASH?.trim();
   if (explicit)
-    return existsSync8(explicit) ? explicit : null;
+    return existsSync9(explicit) ? explicit : null;
   const candidates = process.platform === "win32" ? [
     "C:\\Program Files\\Git\\bin\\bash.exe",
     "C:\\Program Files (x86)\\Git\\bin\\bash.exe",
-    join9(process.env.LOCALAPPDATA ?? "", "Programs", "Git", "bin", "bash.exe")
+    join12(process.env.LOCALAPPDATA ?? "", "Programs", "Git", "bin", "bash.exe")
   ] : ["/bin/bash", "/usr/bin/bash", "/usr/local/bin/bash", "/opt/homebrew/bin/bash"];
   for (const p of candidates) {
-    if (p && existsSync8(p))
+    if (p && existsSync9(p))
       return p;
   }
   const probe = spawnSync(process.platform === "win32" ? "where" : "which", ["bash"], {
@@ -1302,9 +1612,9 @@ function runScript(name, args, projectDir) {
   if (!/^[a-z0-9-]+\.sh$/.test(name)) {
     throw new Error(`invalid script name "${name}" (expected one of: ${RUNNABLE.join(", ")})`);
   }
-  const script = join9(SCRIPTS_DIR, name);
-  if (!existsSync8(script)) {
-    const have = existsSync8(SCRIPTS_DIR) ? readdirSync5(SCRIPTS_DIR).filter((f) => f.endsWith(".sh")) : [];
+  const script = join12(SCRIPTS_DIR, name);
+  if (!existsSync9(script)) {
+    const have = existsSync9(SCRIPTS_DIR) ? readdirSync7(SCRIPTS_DIR).filter((f) => f.endsWith(".sh")) : [];
     throw new Error(`script not found: ${name}${have.length ? ` (available: ${have.join(", ")})` : ""}`);
   }
   const bash = findBash();
@@ -1321,9 +1631,9 @@ function runScript(name, args, projectDir) {
 }
 
 // src/continue.ts
-import { existsSync as existsSync9, readFileSync as readFileSync7, readdirSync as readdirSync6 } from "node:fs";
-import { execFileSync } from "node:child_process";
-import { join as join10 } from "node:path";
+import { existsSync as existsSync10, readFileSync as readFileSync8, readdirSync as readdirSync8 } from "node:fs";
+import { execFileSync as execFileSync4 } from "node:child_process";
+import { join as join13 } from "node:path";
 var SAFE = /^[A-Za-z0-9._-]+$/;
 var isSafeKey = (s) => SAFE.test(s) && !/^\.+$/.test(s);
 var num = (v) => {
@@ -1338,34 +1648,46 @@ function gitActor(cwd) {
   const author = (process.env.GIT_AUTHOR_NAME ?? "").trim();
   if (author)
     return author;
-  const git = (args) => {
+  const git3 = (args) => {
     try {
-      return execFileSync("git", args, { cwd, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+      return execFileSync4("git", args, { cwd, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
     } catch {
       return "";
     }
   };
-  const name = git(["config", "user.name"]);
-  const email = git(["config", "user.email"]);
+  const name = git3(["config", "user.name"]);
+  const email = git3(["config", "user.email"]);
   if (name && email)
     return `${name} <${email}>`;
   return name || process.env.USER || process.env.USERNAME || "";
 }
-function scan(projectDir, root, map) {
-  const base = join10(projectDir, ".mugiwara", root);
-  if (!existsSync9(base))
+function scan(projectDir, kind, map) {
+  const base = join13(projectDir, ".mugiwara", "missions");
+  if (!existsSync10(base))
     return [];
   const out = [];
-  const missions = readdirSync6(base, { withFileTypes: true }).filter((e) => e.isDirectory() && isSafeKey(e.name)).map((e) => e.name).sort();
+  const missions = readdirSync8(base, { withFileTypes: true }).filter((e) => e.isDirectory() && isSafeKey(e.name)).map((e) => e.name).sort();
   for (const mission of missions) {
-    const dir = join10(base, mission);
-    for (const f of readdirSync6(dir).filter((n) => n.endsWith(".json")).sort()) {
+    const dir = join13(base, mission);
+    for (const f of readdirSync8(dir).filter((n) => n.endsWith(".json")).sort()) {
       const stem = f.slice(0, -".json".length);
-      const member = stem === "state" ? null : stem;
+      let member;
+      if (kind === "state") {
+        if (stem === "continue" || stem.startsWith("continue-"))
+          continue;
+        member = stem === "state" ? null : stem;
+      } else {
+        if (stem === "continue")
+          member = null;
+        else if (stem.startsWith("continue-"))
+          member = stem.slice("continue-".length);
+        else
+          continue;
+      }
       if (member !== null && !isSafeKey(member))
         continue;
       try {
-        const raw = JSON.parse(readFileSync7(join10(dir, f), "utf8"));
+        const raw = JSON.parse(readFileSync8(join13(dir, f), "utf8"));
         if (text(raw.mission) !== mission)
           continue;
         out.push(map(raw, member));
@@ -1407,8 +1729,10 @@ function readState(projectDir) {
       lane_rose: r.lane_rose === true,
       lane_prev: text(r.lane_prev),
       lane_peak: text(r.lane_peak),
-      next_action: "",
-      next_session_prompt: "",
+      base_sha: text(r.base_sha),
+      sensitive_paths: Array.isArray(r.sensitive_paths) ? r.sensitive_paths.map(text).filter(Boolean) : [],
+      next_action: text(r.next_action),
+      next_session_prompt: text(r.next_session_prompt),
       updated_at: text(r.updated_at),
       blockers_open: num(r.blockers_open),
       heal_cycle: num(r.heal_cycle),
@@ -1478,6 +1802,59 @@ 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/sign.ts
+import { execFileSync as execFileSync5 } from "node:child_process";
+import { existsSync as existsSync11 } from "node:fs";
+import { homedir as homedir3 } from "node:os";
+import { join as join14 } from "node:path";
+function signArgs(reportPath, secretKey) {
+  return ["-Sm", reportPath, "-s", secretKey];
+}
+function verifyArgs(reportPath, pubKey) {
+  return pubKey ? ["-Vm", reportPath, "-p", pubKey] : ["-Vm", reportPath];
+}
+function hasMinisign() {
+  try {
+    execFileSync5("minisign", ["-v"], { stdio: ["ignore", "pipe", "ignore"] });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function defaultKey(flag) {
+  return join14(homedir3(), ".mugiwara", flag === "secret" ? "minisign.key" : "minisign.pub");
+}
+function signReport(projectDir, missionDir) {
+  const report = join14(missionDir, "report.md");
+  if (!existsSync11(report))
+    return { ok: false, message: "no report.md to sign — archive first" };
+  if (!hasMinisign()) {
+    return { ok: false, message: "minisign not installed — signing skipped (install minisign to enable attestation)" };
+  }
+  const secretKey = process.env.MUGIWARA_SIGN_KEY?.trim() || defaultKey("secret");
+  try {
+    execFileSync5("minisign", signArgs(report, secretKey), { cwd: projectDir, stdio: "pipe", input: process.env.MUGIWARA_SIGN_PASSWORD ?? "" });
+    return { ok: true, message: `signed ${report}.minisig (key: ${secretKey})` };
+  } catch (e) {
+    return { ok: false, message: `signing failed: ${e.message}` };
+  }
+}
+function verifyReport(projectDir, missionDir) {
+  const report = join14(missionDir, "report.md");
+  const sig = `${report}.minisig`;
+  if (!existsSync11(sig))
+    return { ok: false, message: "not signed (no .minisig beside report.md)" };
+  if (!hasMinisign())
+    return { ok: false, message: "minisign not installed — cannot verify" };
+  const pubKey = existsSync11(defaultKey("public")) ? defaultKey("public") : null;
+  try {
+    execFileSync5("minisign", verifyArgs(report, pubKey), { cwd: projectDir, stdio: "pipe" });
+    return { ok: true, message: "signature verifies against report.md" };
+  } catch {
+    return { ok: false, message: "SIGNATURE INVALID — report.md changed after signing" };
+  }
+}
+
 // src/cli.ts
 var str = (v) => typeof v === "string" ? v : undefined;
 var flag = (v) => v === true;
@@ -1502,8 +1879,8 @@ async function run(argv) {
       return resetCmd(flags);
     case "archive":
       return archive(flags, _);
-    case "onboard":
-      return onboardCmd(flags);
+    case "clean":
+      return cleanCmd(flags);
     case "continue":
       return continueCmd(flags, _);
     case "status":
@@ -1512,10 +1889,12 @@ async function run(argv) {
       return runCmd(flags, _);
     case "savepoint":
       return runCmd(flags, ["run", "savepoint.sh", ..._.slice(1)]);
-    case "initiative":
-      return initiativeCmd(flags, _);
-    case "start":
-      return startCmd(flags, _);
+    case "blame":
+      return blameCmd(flags, _);
+    case "handoff":
+      return handoffCmd(flags, _);
+    case "sign":
+      return signCmd(flags, _);
     default:
       throw new Error(`Unknown command: ${command}`);
   }
@@ -1545,6 +1924,8 @@ function archive(flags, positionals) {
   const result = archiveMission(projectDir, mission, { dryRun: flag(flags.dryRun) });
   if (result.report)
     console.log(`archive target: ${result.report}`);
+  else
+    console.error(`no mission dir for "${mission}" under .mugiwara/missions/`);
   if (result.removed.length)
     console.log(`${flag(flags.dryRun) ? "would remove" : "removed"}: ${result.removed.join(", ")}`);
   if (result.kept.length)
@@ -1552,11 +1933,59 @@ function archive(flags, positionals) {
   if (result.index)
     console.log(`index updated: ${result.index}`);
 }
-async function onboardCmd(flags) {
+function cleanCmd(flags) {
   const projectDir = resolve2(str(flags.project) ?? process.cwd());
-  if (!existsSync10(projectDir))
-    throw new Error(`Project dir not found: ${projectDir}`);
-  await runOnboard(projectDir);
+  const dryRun = flag(flags.dryRun);
+  const root = join15(projectDir, ".mugiwara", "missions");
+  if (!existsSync12(root)) {
+    console.log("nothing to clean (.mugiwara/missions/ does not exist).");
+    return;
+  }
+  const before = str(flags.before);
+  const beforeMs = before ? Date.parse(before) : NaN;
+  if (before && !Number.isFinite(beforeMs)) {
+    console.error(`invalid --before date: ${before}`);
+    process.exit(1);
+  }
+  let candidates = readdirSync9(root, { withFileTypes: true }).filter((e) => e.isDirectory() && /^[A-Za-z0-9._-]+$/.test(e.name) && !/^\.+$/.test(e.name)).map((e) => e.name);
+  const stateFiles = (m) => readdirSync9(join15(root, m)).filter((f) => {
+    const stem = f.replace(/\.json$/, "");
+    return f.endsWith(".json") && stem !== "continue" && !stem.startsWith("continue-");
+  });
+  const hasLiveState = (m) => stateFiles(m).length > 0;
+  const staleBefore = (m) => {
+    if (!Number.isFinite(beforeMs))
+      return false;
+    for (const f of stateFiles(m)) {
+      try {
+        const ts = Date.parse(JSON.parse(readFileSync9(join15(root, m, f), "utf8")).updated_at ?? "") || 0;
+        if (ts === 0 || ts >= beforeMs)
+          return false;
+      } catch {
+        return false;
+      }
+    }
+    return true;
+  };
+  if (!flag(flags.all)) {
+    candidates = candidates.filter((m) => existsSync12(join15(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) {
+      console.error(`✗ in-flight mission(s): ${live.join(", ")}. Use --force to archive them anyway.`);
+      process.exit(1);
+    }
+  }
+  if (!candidates.length) {
+    console.log("nothing to clean.");
+    return;
+  }
+  for (const m of candidates) {
+    const r = archiveMission(projectDir, m, { dryRun });
+    console.log(`${dryRun ? "would clean" : "cleaned"} ${m}${r.report ? ` → ${r.report}` : ""}`);
+    if (r.index)
+      console.log(`index updated: ${r.index}`);
+  }
 }
 async function resolveOptions(flags) {
   const interactive = !flag(flags.yes);
@@ -1573,7 +2002,7 @@ async function resolveOptions(flags) {
         scope = await choose(rl, "Install scope?", ["global (user-wide)", "project (this repo)"]) === 0 ? "global" : "project";
     }
     const projectDir = resolve2(str(flags.project) ?? process.cwd());
-    if (scope === "project" && !existsSync10(projectDir))
+    if (scope === "project" && !existsSync12(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"))
@@ -1598,7 +2027,7 @@ async function resolveOptions(flags) {
 }
 async function install(flags) {
   const { scope, projectDir, targetIds } = await resolveOptions(flags);
-  const home = homedir2();
+  const home = homedir4();
   const allFiles = [];
   const allNotes = [];
   const installed = [];
@@ -1640,34 +2069,19 @@ Dry run — nothing written.`);
 OK mugiwara ${VERSION} installed (manifest: ${file})`);
   if (allNotes.length)
     console.log(`${allNotes.length} note(s) above may need attention.`);
-  if (scope === "project") {
-    const cfg = join11(projectDir, ".mugiwara", "config");
-    let mode = "guided", enforce = "block";
-    if (existsSync10(cfg)) {
-      for (const line of readFileSync8(cfg, "utf8").split(/\r?\n/)) {
-        const [k, v] = line.split("=").map((s) => s.trim());
-        if (k === "mode")
-          mode = v;
-        if (k === "enforce")
-          enforce = v;
-      }
-    }
-    console.log(`
-Next: run \`mugiwara onboard\` to customise (mode=${mode}, enforce=${enforce} now).`);
-  } else {
-    console.log("\nNext: run `mugiwara onboard` in a project to write its .mugiwara/config.");
-  }
+  console.log(`
+Next: edit .mugiwara/config to customise (mode, branch, coverage, depths).`);
 }
 async function uninstall(flags) {
   const scope = flag(flags.global) ? "global" : "project";
   const projectDir = resolve2(str(flags.project) ?? process.cwd());
-  const home = homedir2();
+  const home = homedir4();
   const file = manifestPath({ scope, projectDir, home });
   const manifest = readManifest(file);
   if (!manifest) {
     if (scope === "project") {
       const globalFile = manifestPath({ scope: "global", projectDir, home });
-      if (existsSync10(globalFile)) {
+      if (existsSync12(globalFile)) {
         console.log(`No project manifest found, but a global install exists. Try:
   mugiwara uninstall --global`);
         return;
@@ -1704,13 +2118,13 @@ async function uninstall(flags) {
         console.log(`   note: ${n}`);
     }
     rmSync3(file);
-    const mugiDir = join11(scope === "global" ? home : projectDir, ".mugiwara");
-    if (existsSync10(mugiDir) && readdirSync7(mugiDir).length === 0) {
+    const mugiDir = join15(scope === "global" ? home : projectDir, ".mugiwara");
+    if (existsSync12(mugiDir) && readdirSync9(mugiDir).length === 0) {
       rmSync3(mugiDir, { recursive: true, force: true });
     }
     if (manifest.targets.includes("opencode")) {
-      const opencodeCache = join11(home, ".cache", "opencode", "packages", "@ionivetech");
-      if (existsSync10(opencodeCache)) {
+      const opencodeCache = join15(home, ".cache", "opencode", "packages", "@ionivetech");
+      if (existsSync12(opencodeCache)) {
         rmSync3(opencodeCache, { recursive: true, force: true });
         console.log("   cleared opencode npm cache (stale plugin versions)");
       }
@@ -1719,7 +2133,7 @@ async function uninstall(flags) {
   console.log(`OK removed ${removed.length} files`);
 }
 function list(flags) {
-  const home = homedir2();
+  const home = homedir4();
   const projectDir = resolve2(str(flags.project) ?? process.cwd());
   let found = false;
   for (const [label, file] of [
@@ -1731,7 +2145,7 @@ function list(flags) {
       continue;
     found = true;
     if (flag(flags.check)) {
-      const missing = m.files.filter((f) => !existsSync10(f));
+      const missing = m.files.filter((f) => !existsSync12(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}`);
@@ -1753,6 +2167,10 @@ function continueCmd(flags, positionals) {
   const r = resolveContinue(entries, mission, member);
   if (r.kind === "resume") {
     console.log(formatResume(r.entry));
+    const st = readState(projectDir).find((s) => s.mission === r.entry.mission && s.member === r.entry.member);
+    const stale = st ? stalenessLine(projectDir, st.base_sha) : null;
+    if (stale)
+      console.log(stale);
     return;
   }
   if (r.kind === "none") {
@@ -1809,85 +2227,104 @@ function runCmd(flags, positionals) {
   if (code !== 0)
     process.exit(code);
 }
-function initiativeCmd(flags, positionals) {
+function blameCmd(flags, positionals) {
   const projectDir = resolve2(str(flags.project) ?? process.cwd());
-  const sub = positionals[1];
-  if (!sub) {
-    console.error("usage: mugiwara initiative <status|conflict-check|set-status> <plan-file> [--id <id> --status <s>]");
+  const path = positionals[1];
+  if (!path) {
+    console.error("usage: mugiwara blame <file-path>");
     process.exit(1);
   }
-  const script = join11(import.meta.dirname, "..", "scripts", "initiative.ts");
-  const bun = process.platform === "win32" ? "bun.exe" : "bun";
-  const r = spawnSync2(bun, [script, ...positionals.slice(1)], {
-    cwd: projectDir,
-    stdio: "inherit",
-    env: process.env
-  });
-  if (r.error)
-    throw r.error;
-  if (r.status)
-    process.exit(r.status);
+  console.log(blamePath(projectDir, path));
+}
+function stalenessLine(projectDir, baseSha) {
+  if (!baseSha || baseSha === "unknown")
+    return null;
+  const git3 = (args) => {
+    try {
+      return execFileSync6("git", args, { cwd: projectDir, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+    } catch {
+      return "";
+    }
+  };
+  let main = "";
+  for (const ref of ["main", "master"]) {
+    main = git3(["rev-parse", "--verify", ref]);
+    if (main)
+      break;
+  }
+  if (!main)
+    return null;
+  try {
+    const behind = Number(git3(["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;
+  }
 }
-function startCmd(flags, positionals) {
+function handoffCmd(flags, positionals) {
   const projectDir = resolve2(str(flags.project) ?? process.cwd());
   const mission = positionals[1];
   if (!mission) {
-    console.error("usage: mugiwara start <mission> [member]");
+    console.error("usage: mugiwara handoff <mission> [--project <dir>]");
     process.exit(1);
   }
-  const plansDir = join11(projectDir, ".mugiwara", "plans");
-  let planFile = "";
-  if (existsSync10(plansDir)) {
-    const bare = join11(plansDir, `${mission}.md`);
-    if (existsSync10(bare))
-      planFile = bare;
-    else {
-      const dated = readdirSync7(plansDir).filter((f) => f.endsWith(`-${mission}.md`)).sort().pop();
-      if (dated)
-        planFile = join11(plansDir, dated);
-    }
-  }
-  if (!planFile) {
-    console.error(`mugiwara start: no plan found for "${mission}" in ${plansDir}`);
+  const states = readState(projectDir).filter((s) => s.mission === mission);
+  if (!states.length) {
+    console.error(`no in-flight mission "${mission}"`);
     process.exit(1);
   }
-  const plan = readFileSync8(planFile, "utf8");
-  const subMatch = plan.match(/##\s*Sub-missions/i);
-  let member = positionals[2] ?? "";
-  if (subMatch && !member) {
-    const actor = gitActor(projectDir);
-    const name = actor.split("<")[0].trim();
-    const rowRe = /^\|\s*([\w.-]+)\s*\|\s*([^|]+?)\s*\|\s*([^|]+?)\s*\|/gm;
-    let m;
-    let found = "";
-    while (m = rowRe.exec(plan)) {
-      const assignee = m[3].trim();
-      if (assignee === name || assignee === actor) {
-        found = m[1].trim();
-        break;
-      }
-    }
-    if (!found) {
-      console.error(`mugiwara start: no sub-mission assigned to "${name}" in ${planFile}. Pass a member explicitly: mugiwara start ${mission} <member>`);
-      process.exit(1);
-    }
-    member = found;
+  const lines = [
+    `# Handoff: ${mission}`,
+    "",
+    `Generated ${new Date().toISOString()} by \`mugiwara handoff\`.`,
+    "",
+    "| | |",
+    "|---|---|"
+  ];
+  for (const s of states) {
+    const scope = s.member ? ` [${s.member}]` : "";
+    lines.push(`| Mission${scope} | flow ${s.flow}, tasks ${s.tasks_done}/${s.tasks_total}, lane ${s.lane}${s.lane_rose ? " (rose)" : ""}, mode ${s.mode} |`);
+    lines.push(`| Branch | \`${s.branch}\` |`);
+    lines.push(`| Actor | ${s.actor || "(unknown)"} |`);
+    if (s.next_action)
+      lines.push(`| Next action | ${s.next_action} |`);
+    if (s.blockers_open)
+      lines.push(`| Open blockers | ${s.blockers_open} |`);
+    if (s.heal_cycle)
+      lines.push(`| Heal cycles | ${s.heal_cycle}/${s.heal_max_cycles}${s.heal_halt ? " — HALTED" : ""} |`);
+    if (s.evidence.length)
+      lines.push(`| Evidence | ${s.evidence.join(", ")} |`);
+    const stale = stalenessLine(projectDir, s.base_sha);
+    if (stale)
+      lines.push(`| Staleness | ${stale.replace("⚠ stale base: ", "")} |`);
+  }
+  lines.push("", "## Resuming", "", `\`mugiwara continue ${mission}\` prints the exact resume point.`);
+  lines.push("Verify `next_action` against plan.md before executing — the table above is computed state, not judgement.");
+  const out = join15(".mugiwara", "missions", mission, "handoff.md");
+  writeFileSync8(resolve2(projectDir, out), lines.join(`
+`) + `
+`);
+  console.log(lines.join(`
+`));
+  console.log(`
+written: ${out}`);
+}
+function signCmd(flags, _) {
+  const projectDir = resolve2(str(flags.project) ?? process.cwd());
+  const mission = _[1];
+  if (!mission) {
+    console.error("usage: mugiwara sign <mission> [--verify] [--project <dir>]");
+    process.exit(1);
   }
-  const code = runScript("savepoint.sh", [mission, member, "0", "auto", "full"], projectDir);
-  if (code !== 0)
-    process.exit(code);
-  if (subMatch && member) {
-    const init = join11(import.meta.dirname, "..", "scripts", "initiative.ts");
-    const bun = process.platform === "win32" ? "bun.exe" : "bun";
-    const r = spawnSync2(bun, [init, "set-status", planFile, "--id", member, "--status", "in-progress"], {
-      cwd: projectDir,
-      stdio: "inherit",
-      env: process.env
-    });
-    if (r.status)
-      process.exit(r.status);
+  const missionDir = join15(projectDir, ".mugiwara", "missions", mission);
+  if (!existsSync12(missionDir)) {
+    console.error(`no mission dir: ${missionDir}`);
+    process.exit(1);
   }
-  console.log(`mugiwara start: ${mission}${member ? ` [${member}]` : ""} begun at Flow 0. Resume anytime with: mugiwara continue ${mission}${member ? ` ${member}` : ""}`);
+  const r = flag(flags.verify) ? verifyReport(projectDir, missionDir) : signReport(projectDir, missionDir);
+  console.log(`${r.ok ? "✓" : "✗"} ${r.message}`);
+  if (!r.ok)
+    process.exit(1);
 }
 function help() {
   console.log(`mugiwara ${VERSION} — the Straw Hat crew for AI agents
@@ -1898,21 +2335,23 @@ Usage:
   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 archive <m>    fold a closed mission's evidence into its report, then remove loose files
-  mugiwara onboard       run the zero-LLM onboarding wizard (writes .mugiwara/config)
+  mugiwara reset         wipe mission state (missions/ + legacy dirs)
+  mugiwara archive <m>   fold a closed mission's waves into its report, then remove loose files
+  mugiwara clean [--all] [--before <date>]
+                         batch-archive every closed mission (report.md present, no live state)
   mugiwara continue      list in-flight missions (exit 2 = pick one, nothing resumed)
   mugiwara continue <m> [member]
                          print the exact resume point for that mission/member
   mugiwara status        computed mission state: wave, tasks, lane, blockers, budget
+  mugiwara blame <path>  provenance note on the last commit touching <path>
+                         (fetch notes first: git fetch origin 'refs/notes/mugiwara:refs/notes/mugiwara')
+  mugiwara handoff <m>   write .mugiwara/missions/<m>/handoff.md — a report the next
+                         engineer can act on (computed state + staleness check)
+  mugiwara sign <m>      optional attestation: minisign-sign report.md (--verify to check)
   mugiwara run <script> [args...]
                          run a bundled harness script here (${RUNNABLE.join(", ")})
-  mugiwara savepoint <mission> [member] [wave] [mode]
+  mugiwara savepoint <mission> [member] [flow] [mode]
                          shorthand for: mugiwara run savepoint.sh ...
-  mugiwara initiative <status|conflict-check|set-status> <plan> [args]
-                         team sub-mission coordination (status / conflict-check / set-status)
-  mugiwara start <mission> [member]
-                         begin a mission from its plan (solo, or team sub-mission by git actor)
   mugiwara --help        this help
   mugiwara --version     print version
 
@@ -1924,8 +2363,10 @@ Flags:
   --force                overwrite differing files (with backup)
   --dry-run              print actions without writing
   --check                with list: report missing files (health check)
-  --all                  with continue/status: every actor, not just yours
-  --keep-logs            with reset: keep .mugiwara/logs (lessons ledger survives)`);
+   --all                  with continue/status: every actor; with clean: include in-flight missions
+   --force                with clean --all: archive in-flight missions anyway
+   --before <date>        with clean: also archive missions untouched since this date
+   --keep-logs            with reset: keep lessons.md (lessons ledger survives)`);
 }
 var isMain = process.argv[1] !== undefined && fileURLToPath5(import.meta.url) === resolve2(process.argv[1]);
 if (isMain) {
@@ -1935,5 +2376,6 @@ if (isMain) {
   });
 }
 export {
-  run
+  run,
+  stalenessLine
 };