@ionivetech/mugiwara 0.5.3 → 0.5.5

package/docs/{install-kimi.md → install/kimi.md}

@@ -42,4 +42,4 @@ Reinstall:
 ## Configuration
 
 After install, configure mugiwara in `.mugiwara/config` (project) or
-`~/.mugiwara/config` (global). See [docs/config.md](config.md).
+`~/.mugiwara/config` (global). See [config.md](../concepts/config.md).

package/docs/{install-opencode.md → install/opencode.md}

@@ -29,7 +29,7 @@ Restart OpenCode.
 
 ## How it works
 
-The plugin (`mugiwara.mjs`) does three things:
+The plugin (`mugiwara.mjs`) does four things:
 
 1. **Config hook** — registers `content/skills/` as a skills path and
    `content/agents/` as agents so OpenCode discovers the full crew
@@ -38,12 +38,27 @@ The plugin (`mugiwara.mjs`) does three things:
 2. **System transform hook** — injects the crew announce header and active
    autonomy mode into every session's system prompt.
 
-3. **Chat message hook** — intercepts `/mugiwara-mode` commands and
+3. **Chat message hook** — intercepts `/mugiwara` commands and
    natural-language mode switches, writing `.mugiwara/config`.
 
+4. **Commands** — the file-based installer copies slash commands
+   (`/mugiwara`, `/using-mugiwara`, `/mugiwara-plan`, etc.) to
+   `.opencode/commands/`.
+
 Skills are loaded on-demand via OpenCode's native `skill` tool. Agents appear
 as subagents with full config (color, temperature, permissions, step limits).
 
+## Mode switching
+
+Switch autonomy mode at runtime:
+
+```
+/mugiwara guided    # human decides every GO
+/mugiwara semi      # auto branch + commit, plan needs GO
+/mugiwara auto      # hands-off except high-risk
+/mugiwara           # show current mode
+```
+
 ## Verify
 
 Ask your agent:
@@ -77,9 +92,10 @@ then restart OpenCode.
 
 ### Server error on startup
 
-Fixed in v0.5.3. Ensure you're on the latest:
+Clear stale plugin cache and reinstall:
 
 ```bash
+rm -rf ~/.cache/opencode/packages/@ionivetech
 npm update @ionivetech/mugiwara
 ```
 
@@ -124,6 +140,4 @@ Mugiwara skills reference general actions. On OpenCode these map to:
 ## Configuration
 
 After install, configure mugiwara in `.mugiwara/config` (project) or
-`~/.mugiwara/config` (global). See [docs/config.md](config.md).
-
-Switch autonomy mode at runtime: `/mugiwara-mode guided|semi|auto`
+`~/.mugiwara/config` (global). See [config.md](../concepts/config.md).

package/docs/{install-pi.md → install/pi.md}

@@ -43,4 +43,4 @@ pi remove mugiwara
 ## Configuration
 
 After install, configure mugiwara in `.mugiwara/config` (project) or
-`~/.mugiwara/config` (global). See [docs/config.md](config.md).
+`~/.mugiwara/config` (global). See [config.md](../concepts/config.md).

package/docs/{adoption-guide.md → reference/adoption-guide.md}

@@ -56,7 +56,7 @@ mid-wave.
 
 The crew runs **inline in your main conversation**; subagents are used only for
 independent `[PARALLEL]` task batches and background checks. You see every wave
-as it happens. See [execution-model.md](execution-model.md).
+as it happens. See [execution-model.md](../concepts/execution-model.md).
 
 ## What the crew will never do
 
@@ -69,4 +69,4 @@ as it happens. See [execution-model.md](execution-model.md).
 ## Going further
 
 - [Developer onboarding](developer-onboarding.md) if you want to contribute.
-- [Comparison](comparison.md) if you're weighing mugiwara against alternatives.
+- [Comparison](../concepts/comparison.md) if you're weighing mugiwara against alternatives.

package/docs/{harness-matrix.md → reference/harness-matrix.md}

@@ -35,7 +35,7 @@ What actually differs per harness tier. Every skill and agent file ships to ever
 
 ## What's the same everywhere
 
-- All 32 (→ 26) skill directories ship to every harness.
-- All 15 agent markdown files ship to every harness.
+- All 26 skill directories ship to every harness.
+- All 14 agent markdown files ship to every harness.
 - `references/` files are always copied.
 - The workflow, lane sizing, and evidence discipline are identical — the difference is in how the model loads them.

package/gemini-extension.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ionivetech/mugiwara",
-  "version": "0.5.3",
+  "version": "0.5.5",
   "description": "The Straw Hat crew of AI agents and skills: brainstorm, plan, execute, checkpoint, quality, gates, review, security, self-healing. Installs into Claude Code, opencode, Copilot, Gemini, Codex, Cursor, Kimi, pi, Windsurf, Cline, Kilo, Antigravity.",
   "type": "module",
   "license": "MIT",
@@ -53,7 +53,7 @@
     "retrieval-eval": "bun scripts/retrieval-eval.ts",
     "sync-version": "bun scripts/sync-version.ts",
     "gate": "bun run typecheck && bun run test && bun run build && bun scripts/validate-content.ts --check-manifest --check-docs && bun run verify-pack && bun scripts/run-evals.ts && bun scripts/retrieval-eval.ts",
-    "verify-pack": "npm pack --dry-run 2>&1 | grep -q 'ionivetech-mugiwara' && echo '✓ npm package clean' || (echo '✗ npm pack failed' && exit 1)",
+    "verify-pack": "npm pack --dry-run 2>&1 | node -e \"let s='';process.stdin.on('data',d=>s+=d);process.stdin.on('end',()=>{if(!s.includes('ionivetech-mugiwara')){console.error('npm pack failed');process.exit(1)};console.log('npm package clean')})\"",
     "prepack": "bun run build && bun run sync-version"
   },
   "keywords": [

package/plugin.json

@@ -1,9 +1,9 @@
 {
   "name": "mugiwara",
   "description": "The Straw Hat crew of AI agents and skills: brainstorm, plan, execute, checkpoint, quality, gates, review, security, healing.",
-  "version": "0.5.3",
+  "version": "0.5.5",
   "author": {
-    "name": "ionive"
+    "name": "ionivetech"
   },
   "license": "MIT",
   "repository": "https://github.com/ionivetech/mugiwara",

package/scripts/evidence.sh

@@ -15,7 +15,7 @@ RESULTS_DIR="$MUGIWARA_DIR/results"
 mkdir -p "$RESULTS_DIR"
 
 TIMESTAMP=$(date +%Y%m%d-%H%M%S)
-HASH=$(echo "${LABEL}-${TIMESTAMP}-$$-${RANDOM}" | shasum -a 256 | cut -c1-12 2>/dev/null || echo "${TIMESTAMP}")
+HASH=$(echo "${LABEL}-${TIMESTAMP}-$$-${RANDOM}" | (sha256sum 2>/dev/null || shasum -a 256 2>/dev/null || openssl sha256) | cut -c1-12 2>/dev/null || echo "${TIMESTAMP}")
 EVIDENCE_FILE="$RESULTS_DIR/${LABEL}-${HASH}.log"
 
 {

package/scripts/mission-report.sh

@@ -13,76 +13,63 @@ REPORT_FILE="$REPORT_DIR/${MISSION}.md"
 
 [ -f "$STATE_FILE" ] || { echo "mission-report: $STATE_FILE not found" >&2; exit 1; }
 
-python3 <<PY
-import json, os, sys
-from datetime import datetime
-
-state_file = "$STATE_FILE"
-report_file = "$REPORT_FILE"
-os.makedirs(os.path.dirname(report_file), exist_ok=True)
-
-with open(state_file) as f:
-    s = json.load(f)
-
-mission = s.get("mission", "$MISSION")
-actor = s.get("actor", "unknown")
-branch = s.get("branch", "unknown")
-lane = s.get("lane", "unknown")
-lane_reason = s.get("lane_reason", "")
-mode = s.get("mode", "guided")
-wave = s.get("wave", 0)
-files_touched = s.get("files_touched", 0)
-loc_delta = s.get("loc_delta", 0)
-sensitive = s.get("sensitive_paths", [])
-tasks = s.get("tasks", {})
-blockers = s.get("blockers_open", 0)
-heal_cycle = s.get("heal_cycle", 1)
-tokens = s.get("tokens_est", 0)
-budget = s.get("budget", 0)
-evidence = s.get("evidence", [])
-updated = s.get("updated_at", datetime.utcnow().isoformat() + "Z")
-
-now = datetime.utcnow().strftime("%Y-%m-%d")
-report = f"""# Mission: {mission} · {now}
-
-**Lane** {lane} · **Mode** {mode} · **Actor** {actor} · **Branch** {branch}
-
-## What changed
-
-{files_touched} files, +{loc_delta if loc_delta >= 0 else loc_delta} LOC"""
-
-if sensitive:
-    report += "\nSensitive paths: " + ", ".join(sensitive)
-
-report += f"""
-
-## Gates
-
-| Gate | Verdict | Evidence |
-|------|---------|----------|"""
-
-for e in evidence:
-    report += f"\n| — | PASS | {e} |"
-
-report += f"""
-
-## State
-
-| Field | Value |
-|-------|-------|
-| Wave | {wave} |
-| Tasks | {tasks.get('done', 0)}/{tasks.get('total', 0)} done |
-| Blockers open | {blockers} |
-| Heal cycles | {heal_cycle} |
-| Tokens used | {tokens:,} / {budget:,} |
-
-## Updated
-
-{updated}
-"""
-
-with open(report_file, 'w') as f:
-    f.write(report)
-
-print(f"✓ mission report: {report_file}")
-PY
+export STATE_FILE REPORT_DIR MISSION
+node << 'NODE'
+const fs = require('fs');
+const path = require('path');
+
+const stateFile = process.env.STATE_FILE || ".mugiwara/state.json";
+const reportDir = process.env.REPORT_DIR || ".mugiwara/reports";
+const mission = process.env.MISSION || "unknown";
+
+if (!fs.existsSync(stateFile)) {
+  console.error("mission-report: " + stateFile + " not found");
+  process.exit(1);
+}
+
+fs.mkdirSync(reportDir, { recursive: true });
+const s = JSON.parse(fs.readFileSync(stateFile, 'utf8'));
+
+const reportFile = path.join(reportDir, mission + ".md");
+const now = new Date().toISOString().slice(0, 10);
+const lane = s.lane || "unknown";
+const mode = s.mode || "guided";
+const actor = s.actor || "unknown";
+const branch = s.branch || "unknown";
+const wave = s.wave || 0;
+const filesTouched = s.files_touched || 0;
+const locDelta = s.loc_delta || 0;
+const sensitive = s.sensitive_paths || [];
+const tasks = s.tasks || {};
+const blockers = s.blockers_open || 0;
+const healCycle = s.heal_cycle || 1;
+const tokens = s.tokens_est || 0;
+const budget = s.budget || 0;
+const evidence = s.evidence || [];
+const updated = s.updated_at || new Date().toISOString();
+
+let report = "# Mission: " + mission + " . " + now + "\n\n";
+report += "**Lane** " + lane + " . **Mode** " + mode + " . **Actor** " + actor + " . **Branch** " + branch + "\n\n";
+report += "## What changed\n\n";
+report += filesTouched + " files, +" + locDelta + " LOC";
+
+if (sensitive.length) {
+  report += "\nSensitive paths: " + sensitive.join(", ");
+}
+
+report += "\n\n## Gates\n\n| Gate | Verdict | Evidence |\n|------|---------|----------|";
+for (const e of evidence) {
+  report += "\n| \u2014 | PASS | " + e + " |";
+}
+
+report += "\n\n## State\n\n| Field | Value |\n|-------|-------|\n";
+report += "| Wave | " + wave + " |\n";
+report += "| Tasks | " + (tasks.done || 0) + "/" + (tasks.total || 0) + " done |\n";
+report += "| Blockers open | " + blockers + " |\n";
+report += "| Heal cycles | " + healCycle + " |\n";
+report += "| Tokens used | " + tokens.toLocaleString() + " / " + budget.toLocaleString() + " |\n\n";
+report += "## Updated\n\n" + updated + "\n";
+
+fs.writeFileSync(reportFile, report);
+console.log("\u2713 mission report: " + reportFile);
+NODE

package/scripts/retrieval-eval.ts

@@ -3,7 +3,7 @@
 // Builds TF-IDF index over skill descriptions, scores prompts, reports rank-1 + top_k.
 // No model needed — pure string matching. Outputs JSON.
 
-import { readdirSync, readFileSync, existsSync, statSync } from 'node:fs';
+import { readdirSync, readFileSync, existsSync, statSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { parseFrontmatter } from '../src/frontmatter.ts';
 
@@ -256,6 +256,5 @@ if (ciArg !== -1) {
 }
 
 function writeJson(path: string, obj: object) {
-  const { writeFileSync } = require('node:fs');
   writeFileSync(path, JSON.stringify(obj, null, 2) + '\n');
 }

package/scripts/run-evals.ts

@@ -9,6 +9,7 @@
 // keyword match, then reports pass/fail per case and a rank-1 style score.
 // The command defaults to "claude -p" — override with MUGIWARA_EVAL_CMD.
 import { readdirSync, readFileSync, existsSync } from 'node:fs';
+import { execFileSync } from 'node:child_process';
 import { join } from 'node:path';
 
 const root = join(import.meta.dirname, '..');
@@ -136,7 +137,6 @@ async function runCases(env: { execFileSync: typeof import('node:child_process')
 
 const runArg = process.argv.indexOf('--run');
 if (runArg !== -1) {
-  const { execFileSync } = require('node:child_process');
   const cmd = process.env.MUGIWARA_EVAL_CMD ?? 'claude -p';
   const [bin, ...pre] = cmd.split(' ');
   runCases({ execFileSync, bin, pre });

package/scripts/savepoint.sh

@@ -100,7 +100,7 @@ EVIDENCE=$(ls "$MUGIWARA_DIR/results/" 2>/dev/null | grep "$MISSION" | sed 's|^|
 SKILL_VERSION="1"
 if [ -f package.json ]; then
   PKG_JSON="$MUGIWARA_DIR/../package.json"
-  [ -f "$PKG_JSON" ] && SKILL_VERSION=$(python3 -c "import json; v=json.load(open('$PKG_JSON')).get('version','1'); print(v.split('.')[0])" 2>/dev/null || echo "1")
+  [ -f "$PKG_JSON" ] && SKILL_VERSION=$(node -e "try{console.log(JSON.parse(require('fs').readFileSync('$PKG_JSON','utf8')).version.split('.')[0])}catch(e){console.log('1')}" 2>/dev/null || echo "1")
 fi
 
 # tokens from env var (harness exports estimated tokens consumed)

package/scripts/validate-content.ts

@@ -14,7 +14,7 @@ function checkFile(file: string, wantName: string, kind: 'skill' | 'agent'): Rec
   const { data, body } = parsed;
   if (data.name !== wantName) errors.push(`${kind} ${file}: name "${data.name}" != "${wantName}"`);
   const d = data.description ?? '';
-  if (kind === 'skill' && (d.length < 20 || d.length > 500)) errors.push(`skill ${file}: description must be 20-500 chars (got ${d.length})`);
+  if (kind === 'skill' && (d.length < 20 || d.length > 220)) errors.push(`skill ${file}: description must be 20-220 chars (got ${d.length})`);
   if (kind === 'agent' && d.length < 20) errors.push(`agent ${file}: description too short`);
   if (kind === 'skill' && body.replace(/\r?\n$/, '').split(/\r?\n/).length > 120) errors.push(`skill ${file}: body exceeds 120 lines`);
   if (kind === 'skill' && !body.includes('## Skip when')) errors.push(`skill ${file}: missing required "## Skip when" block (≤4 lines, numeric threshold)`);
@@ -188,20 +188,20 @@ if (totalDescChars > INDEX_BUDGET) {
 const docsArg = process.argv.indexOf('--check-docs');
 if (docsArg !== -1) {
   const docsDir = join(import.meta.dirname, '..', 'docs');
-  const skillsDoc = join(docsDir, 'skills.md');
-  const agentsDoc = join(docsDir, 'agents.md');
+const skillsDoc = join(docsDir, 'concepts', 'skills.md');
+const agentsDoc = join(docsDir, 'concepts', 'agents.md');
   let docErrors = 0;
 
   if (existsSync(skillsDoc)) {
     const content = readFileSync(skillsDoc, 'utf8');
     for (const dir of skillDirs) {
       if (!content.includes(dir)) {
-        errors.push(`docs/skills.md: missing skill "${dir}"`);
+        errors.push(`docs/concepts/skills.md: missing skill "${dir}"`);
         docErrors++;
       }
     }
   } else {
-    errors.push('docs/skills.md: file not found');
+    errors.push('docs/concepts/skills.md: file not found');
     docErrors++;
   }
 
@@ -210,12 +210,12 @@ if (docsArg !== -1) {
     for (const f of agentFiles) {
       const name = f.replace(/\.md$/, '');
       if (!content.includes(name)) {
-        errors.push(`docs/agents.md: missing agent "${name}"`);
+        errors.push(`docs/concepts/agents.md: missing agent "${name}"`);
         docErrors++;
       }
     }
   } else {
-    errors.push('docs/agents.md: file not found');
+    errors.push('docs/concepts/agents.md: file not found');
     docErrors++;
   }
 

package/src/args.ts

@@ -9,7 +9,7 @@ export type Args = {
 const VALUE_FLAGS: Record<string, string> = { '--project': 'project', '--target': 'target' };
 const BOOL_FLAGS: Record<string, string> = {
   '--global': 'global', '--yes': 'yes', '-y': 'yes', '--force': 'force',
-  '--dry-run': 'dryRun', '--keep-logs': 'keepLogs',
+  '--dry-run': 'dryRun', '--keep-logs': 'keepLogs', '--check': 'check',
   '--help': 'help', '-h': 'help', '--version': 'version', '-v': 'version',
 };
 

package/src/cli.ts

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 // src/cli.ts
-import { existsSync, readFileSync, realpathSync, rmSync } from 'node:fs';
+import { existsSync, readFileSync, readdirSync, rmSync } from 'node:fs';
 import { homedir } from 'node:os';
-import { resolve } from 'node:path';
-import { pathToFileURL } from 'node:url';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { parseArgs, type FlagValue, type Args } from './args.ts';
 import { createRl, choose, multiChoose, confirm } from './prompt.ts';
 import { targets, TARGET_IDS } from './targets/index.ts';
@@ -43,12 +43,15 @@ function resetCmd(flags: Args['flags']): void {
 
 async function resolveOptions(flags: Args['flags']): Promise<{ scope: Scope; projectDir: string; targetIds: string[] }> {
   const interactive = !flag(flags.yes);
+  if (interactive && !process.stdin.isTTY) {
+    throw new Error('Not a terminal. Run with --yes and --global or --project <dir> --target <ids|all>');
+  }
   const rl = interactive ? createRl() : null;
   try {
     let scope: Scope | null = flag(flags.global) ? 'global' : str(flags.project) ? 'project' : null;
     if (!scope) {
-      if (!interactive) throw new Error('Specify --global or --project <dir> with --yes');
-      scope = (await choose(rl!, 'Install scope?', ['global (user-wide)', 'project (this repo)'])) === 0 ? 'global' : 'project';
+      if (!interactive) { scope = 'project'; }
+      else scope = (await choose(rl!, 'Install scope?', ['global (user-wide)', 'project (this repo)'])) === 0 ? 'global' : 'project';
     }
     const projectDir = resolve(str(flags.project) ?? process.cwd());
     if (scope === 'project' && !existsSync(projectDir)) throw new Error(`Project dir not found: ${projectDir}`);
@@ -56,9 +59,11 @@ async function resolveOptions(flags: Args['flags']): Promise<{ scope: Scope; pro
     let targetIds = str(flags.target)?.split(',').map(s => s.trim()) ?? null;
     if (targetIds && targetIds.includes('all')) targetIds = [...TARGET_IDS];
     if (!targetIds) {
-      if (!interactive) throw new Error('Specify --target <ids|all> with --yes');
-      const idx = await multiChoose(rl!, 'Target AI agents?', ['all targets', ...TARGET_IDS]);
-      targetIds = idx.includes(0) ? [...TARGET_IDS] : idx.map(i => TARGET_IDS[i - 1]);
+      if (!interactive) { targetIds = [...TARGET_IDS]; }
+      else {
+        const idx = await multiChoose(rl!, 'Target AI agents?', ['all targets', ...TARGET_IDS]);
+        targetIds = idx.includes(0) ? [...TARGET_IDS] : idx.map(i => TARGET_IDS[i - 1]);
+      }
     }
     for (const id of targetIds) {
       if (!targets[id]) throw new Error(`Unknown target: ${id} (valid: ${TARGET_IDS.join(', ')}, all)`);
@@ -110,7 +115,17 @@ async function uninstall(flags: Args['flags']): Promise<void> {
   const home = homedir();
   const file = manifestPath({ scope, projectDir, home });
   const manifest = readManifest(file);
-  if (!manifest) { console.log('Nothing installed (no manifest found).'); return; }
+  if (!manifest) {
+    if (scope === 'project') {
+      const globalFile = manifestPath({ scope: 'global', projectDir, home });
+      if (existsSync(globalFile)) {
+        console.log('No project manifest found, but a global install exists. Try:\n  mugiwara uninstall --global');
+        return;
+      }
+    }
+    console.log('Nothing installed (no manifest found).');
+    return;
+  }
   console.log(`Will remove ${manifest.files.length} files (targets: ${manifest.targets.join(', ')}).`);
   if (!flag(flags.yes)) {
     const rl = createRl();
@@ -119,7 +134,20 @@ async function uninstall(flags: Args['flags']): Promise<void> {
     if (!ok) { console.log('Aborted.'); return; }
   }
   const removed = removeInstalled(manifest, { dryRun: flag(flags.dryRun) });
-  if (!flag(flags.dryRun)) rmSync(file);
+  if (!flag(flags.dryRun)) {
+    rmSync(file);
+    const mugiDir = join(scope === 'global' ? home : projectDir, '.mugiwara');
+    if (existsSync(mugiDir) && readdirSync(mugiDir).length === 0) {
+      rmSync(mugiDir, { recursive: true, force: true });
+    }
+    if (manifest.targets.includes('opencode')) {
+      const opencodeCache = join(home, '.cache', 'opencode', 'packages', '@ionivetech');
+      if (existsSync(opencodeCache)) {
+        rmSync(opencodeCache, { recursive: true, force: true });
+        console.log('   cleared opencode npm cache (stale plugin versions)');
+      }
+    }
+  }
   console.log(`OK removed ${removed.length} files`);
 }
 
@@ -134,7 +162,12 @@ function list(flags: Args['flags']): void {
     const m = readManifest(file);
     if (!m) continue;
     found = true;
-    console.log(`${label}: v${m.version} targets=${m.targets.join(',')} files=${m.files.length} installed=${m.installedAt}`);
+    if (flag(flags.check)) {
+      const missing = m.files.filter(f => !existsSync(f));
+      console.log(`${label}: v${m.version} targets=${m.targets.join(',')} files=${m.files.length} missing=${missing.length} installed=${m.installedAt}`);
+    } else {
+      console.log(`${label}: v${m.version} targets=${m.targets.join(',')} files=${m.files.length} installed=${m.installedAt}`);
+    }
   }
   if (!found) console.log('No mugiwara installation found.');
 }
@@ -143,10 +176,11 @@ function help(): void {
   console.log(`mugiwara ${VERSION} — the Straw Hat crew for AI agents
 
 Usage:
-  mugiwara [install]     install the crew (default; wizard when flags missing)
+  mugiwara [install]     install the crew (wizard; with --yes uses project + all)
   mugiwara update        replace existing files (backs up differences first)
   mugiwara uninstall     remove installed files via manifest
   mugiwara list          show installations
+  mugiwara list --check  health check: show installations + missing files
   mugiwara reset         wipe mission state (spec/plans/results/review/issues[/logs])
   mugiwara --help        this help
   mugiwara --version     print version
@@ -155,21 +189,14 @@ Flags:
   --global               user-wide install
   --project <dir>        project install (default: cwd)
   --target <ids|all>     comma-separated: ${TARGET_IDS.join(', ')}
-  --yes, -y              non-interactive (needs --global/--project, --target)
+  --yes, -y              non-interactive (defaults: project, all targets)
   --force                overwrite differing files (with backup)
   --dry-run              print actions without writing
+  --check                with list: report missing files (health check)
   --keep-logs            with reset: keep .mugiwara/logs (lessons ledger survives)`);
 }
 
-let entry = process.argv[1] !== undefined ? resolve(process.argv[1]) : undefined;
-if (entry !== undefined) {
-  try {
-    entry = realpathSync(entry);
-  } catch {
-    // ponytail: realpath can throw on a missing/odd path — fall back to the raw resolve
-  }
-}
-const isMain = entry !== undefined && import.meta.url === pathToFileURL(entry).href;
+const isMain = process.argv[1] !== undefined && fileURLToPath(import.meta.url) === resolve(process.argv[1]);
 if (isMain) {
   run(process.argv.slice(2)).catch(err => {
     console.error(`mugiwara: ${err.message}`);

package/src/frontmatter.ts

@@ -7,9 +7,9 @@ export function parseFrontmatter(text: string): { data: FrontmatterData; body: s
   const data: FrontmatterData = {};
   for (const line of m[1].split(/\r?\n/)) {
     if (!line.trim()) continue;
-    const i = line.indexOf(':');
-    if (i === -1) throw new Error(`Bad frontmatter line: ${line}`);
-    data[line.slice(0, i).trim()] = line.slice(i + 1).trim();
+    const i = line.indexOf(': ');
+    if (i === -1) throw new Error(`Bad frontmatter line (missing ': ' separator): ${line}`);
+    data[line.slice(0, i).trim()] = line.slice(i + 2).trim();
   }
   return { data, body: text.slice(m[0].length) };
 }

package/src/installer.ts

@@ -2,6 +2,7 @@
 import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync, copyFileSync, rmSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { homedir } from 'node:os';
+import { fileURLToPath } from 'node:url';
 import { parseFrontmatter, type FrontmatterData } from './frontmatter.ts';
 import type { Scope } from './manifest.ts';
 
@@ -43,8 +44,8 @@ export interface Target {
   postInstall?(opts: { scope: Scope; projectDir: string; home: string; dryRun: boolean; files: string[] }): { written: string[]; notes: string[] };
 }
 
-export const CONTENT_DIR = join(import.meta.dirname, '..', 'content');
-const pkg = JSON.parse(readFileSync(join(import.meta.dirname, '..', 'package.json'), 'utf8')) as { version: string };
+export const CONTENT_DIR = join(dirname(fileURLToPath(import.meta.url)), '..', 'content');
+const pkg = JSON.parse(readFileSync(join(dirname(fileURLToPath(import.meta.url)), '..', 'package.json'), 'utf8')) as { version: string };
 export const VERSION = pkg.version;
 
 export function collectContent(): { skills: ContentItem[]; agents: ContentItem[] } {
@@ -87,8 +88,10 @@ export function installTo(target: Target, opts: InstallOptions): InstallResult {
         return;
       }
       const ts = new Date().toISOString().replace(/[:.]/g, '-');
-      const backupFile = join(backupRoot, 'backup', ts, absPath.replace(/[^a-zA-Z0-9]+/g, '_'));
-      if (!dryRun) { mkdirSync(dirname(backupFile), { recursive: true }); copyFileSync(absPath, backupFile); }
+      const fileName = absPath.replace(/[^a-zA-Z0-9]+/g, '_');
+      const backupDir = join(backupRoot, 'backup', `${ts}-${target.id}`);
+      const backupFile = join(backupDir, fileName);
+      if (!dryRun) { mkdirSync(backupDir, { recursive: true }); copyFileSync(absPath, backupFile); }
       result.backedUp.push(absPath);
     }
     if (!dryRun) { mkdirSync(dirname(absPath), { recursive: true }); writeFileSync(absPath, text); }
@@ -133,10 +136,9 @@ export function removeInstalled(manifest: { files: string[] }, { dryRun = false
     for (const f of manifest.files) {
       let d = dirname(f);
       while (existsSync(d) && readdirSync(d).length === 0) {
-        rmSync(d, { recursive: true });
-        const parent = dirname(d);
-        if (parent === d) break;
-        d = parent;
+        if (d.endsWith('/.mugiwara') || d === dirname(d)) break;
+        rmSync(d, { recursive: true, force: true });
+        d = dirname(d);
       }
     }
   }

package/src/targets/opencode.ts

@@ -1,8 +1,13 @@
 // src/targets/opencode.ts
-import { join } from 'node:path';
+import { existsSync, readdirSync, copyFileSync, mkdirSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { stringifyFrontmatter, type FrontmatterData } from '../frontmatter.ts';
 import type { Target } from '../installer.ts';
 
+const here = dirname(fileURLToPath(import.meta.url));
+const COMMANDS_SRC = join(here, '..', '..', '.opencode', 'commands');
+
 type CrewConfig = {
   color: string;
   temperature: number;
@@ -62,4 +67,20 @@ export const target: Target = {
     const root = scope === 'global' ? join(home, '.config', 'opencode') : join(projectDir, '.opencode');
     return join(root, 'skills', skillName, 'references');
   },
+  postInstall({ scope, projectDir, home, dryRun }) {
+    const root = scope === 'global' ? join(home, '.config', 'opencode') : join(projectDir, '.opencode');
+    const dstDir = join(root, 'commands');
+    if (dryRun) return { written: [], notes: [] };
+    if (!existsSync(COMMANDS_SRC)) return { written: [], notes: [] };
+    mkdirSync(dstDir, { recursive: true });
+    const written: string[] = [];
+    for (const f of readdirSync(COMMANDS_SRC)) {
+      if (!f.endsWith('.md')) continue;
+      const src = join(COMMANDS_SRC, f);
+      const dst = join(dstDir, f);
+      copyFileSync(src, dst);
+      written.push(dst);
+    }
+    return { written, notes: [] };
+  },
 };