@ionivetech/mugiwara 0.5.2 → 0.5.3

package/docs/install-codex.md

@@ -0,0 +1,44 @@
+# Codex Install
+
+Mugiwara installs as a native Codex plugin.
+
+## Prerequisites
+
+- [Codex](https://github.com/openai/codex) CLI or app installed
+
+## Install
+
+```bash
+codex plugin marketplace add ionivetech/mugiwara && codex plugin add mugiwara@mugiwara
+```
+
+## How it works
+
+Codex reads `.codex-plugin/plugin.json` which references `content/skills/`.
+All 26 skills are auto-discovered. Agents come from `content/agents/` via the
+`agents/` symlink.
+
+## Verify
+
+Ask:
+
+```
+what mugiwara crew members are available?
+```
+
+## Update
+
+```bash
+codex plugin update mugiwara
+```
+
+## Uninstall
+
+```bash
+codex plugin remove mugiwara
+```
+
+## Configuration
+
+After install, configure mugiwara in `.mugiwara/config` (project) or
+`~/.mugiwara/config` (global). See [docs/config.md](config.md).

package/docs/install-copilot.md

@@ -0,0 +1,45 @@
+# GitHub Copilot Install
+
+Mugiwara installs as a Copilot plugin directly from the GitHub repo.
+
+## Prerequisites
+
+- [GitHub Copilot](https://docs.github.com/en/copilot) extension installed
+
+## Install
+
+```bash
+copilot plugin install https://github.com/ionivetech/mugiwara
+```
+
+## How it works
+
+Copilot clones the repo and auto-discovers skills from `content/skills/`
+and agents from `content/agents/`.
+
+## Verify
+
+Ask:
+
+```
+what mugiwara crew members are available?
+```
+
+## Update
+
+Reinstall with the same command:
+
+```bash
+copilot plugin install https://github.com/ionivetech/mugiwara
+```
+
+## Uninstall
+
+```bash
+copilot plugin uninstall mugiwara
+```
+
+## Configuration
+
+After install, configure mugiwara in `.mugiwara/config` (project) or
+`~/.mugiwara/config` (global). See [docs/config.md](config.md).

package/docs/install-cursor.md

@@ -0,0 +1,45 @@
+# Cursor Install
+
+Mugiwara installs through Cursor's plugin marketplace.
+
+## Prerequisites
+
+- [Cursor](https://cursor.com) installed
+
+## Install
+
+```
+/add-plugin mugiwara
+```
+
+## How it works
+
+Cursor reads `.cursor-plugin/plugin.json` and auto-discovers skills from
+`content/skills/`.
+
+## Verify
+
+Ask:
+
+```
+what mugiwara crew members are available?
+```
+
+## Update
+
+Re-run:
+
+```
+/add-plugin mugiwara
+```
+
+## Uninstall
+
+```
+/remove-plugin mugiwara
+```
+
+## Configuration
+
+After install, configure mugiwara in `.mugiwara/config` (project) or
+`~/.mugiwara/config` (global). See [docs/config.md](config.md).

package/docs/install-gemini.md

@@ -0,0 +1,44 @@
+# Gemini CLI Install
+
+Mugiwara installs as a Gemini CLI extension.
+
+## Prerequisites
+
+- [Gemini CLI](https://github.com/google-gemini/gemini-cli) installed
+
+## Install
+
+```bash
+gemini extensions install https://github.com/ionivetech/mugiwara
+```
+
+## How it works
+
+Gemini reads `gemini-extension.json` (which points to `GEMINI.md` as the
+context file) and auto-discovers skills from `content/skills/`. The
+`GEMINI.md` file describes the crew and workflow bootstrap.
+
+## Verify
+
+Ask:
+
+```
+what mugiwara crew members are available?
+```
+
+## Update
+
+```bash
+gemini extensions update mugiwara
+```
+
+## Uninstall
+
+```bash
+gemini extensions remove mugiwara
+```
+
+## Configuration
+
+After install, configure mugiwara in `.mugiwara/config` (project) or
+`~/.mugiwara/config` (global). See [docs/config.md](config.md).

package/docs/install-kimi.md

@@ -0,0 +1,45 @@
+# Kimi Code Install
+
+Mugiwara installs through Kimi Code's plugin system.
+
+## Prerequisites
+
+- [Kimi Code](https://kimi.moonshot.cn) installed
+
+## Install
+
+```
+/plugins install https://github.com/ionivetech/mugiwara
+```
+
+## How it works
+
+Kimi Code reads `.kimi-plugin/plugin.json` and auto-discovers skills from
+`content/skills/`.
+
+## Verify
+
+Ask:
+
+```
+what mugiwara crew members are available?
+```
+
+## Update
+
+Reinstall:
+
+```
+/plugins install https://github.com/ionivetech/mugiwara
+```
+
+## Uninstall
+
+```
+/plugins remove mugiwara
+```
+
+## Configuration
+
+After install, configure mugiwara in `.mugiwara/config` (project) or
+`~/.mugiwara/config` (global). See [docs/config.md](config.md).

package/docs/install-opencode.md

@@ -0,0 +1,129 @@
+# OpenCode Install
+
+Mugiwara installs through OpenCode's native npm plugin system.
+
+## Prerequisites
+
+- [OpenCode](https://opencode.ai) installed
+- Node.js >= 20.11
+
+## Install
+
+Add to `opencode.json` (global at `~/.config/opencode/opencode.json` or
+project-level at `.opencode/opencode.json`):
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["@ionivetech/mugiwara"]
+}
+```
+
+Restart OpenCode.
+
+### Pinning a version
+
+```json
+{ "plugin": ["@ionivetech/mugiwara@^0.5.0"] }
+```
+
+## How it works
+
+The plugin (`mugiwara.mjs`) does three things:
+
+1. **Config hook** — registers `content/skills/` as a skills path and
+   `content/agents/` as agents so OpenCode discovers the full crew
+   (26 skills + 14 agents) without any file copying.
+
+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
+   natural-language mode switches, writing `.mugiwara/config`.
+
+Skills are loaded on-demand via OpenCode's native `skill` tool. Agents appear
+as subagents with full config (color, temperature, permissions, step limits).
+
+## Verify
+
+Ask your agent:
+
+```
+what mugiwara crew members are available?
+```
+
+Or type `/mugiwara` to see the crew router.
+
+## Update
+
+```bash
+npm update @ionivetech/mugiwara
+```
+
+Or bump the version constraint in `opencode.json` and restart.
+
+## Uninstall
+
+Remove `"@ionivetech/mugiwara"` from the `plugin` array in `opencode.json`,
+then restart OpenCode.
+
+## Troubleshooting
+
+### Plugin not loading
+
+1. Check logs: `opencode --print-logs`
+2. Verify the plugin line in `opencode.json`
+3. Ensure you're on a recent OpenCode version
+
+### Server error on startup
+
+Fixed in v0.5.3. Ensure you're on the latest:
+
+```bash
+npm update @ionivetech/mugiwara
+```
+
+If it persists, file at https://github.com/ionivetech/mugiwara/issues.
+
+### Skills not found
+
+1. Use the `skill` tool to list available skills
+2. Check the plugin loaded (see "Plugin not loading")
+3. Each skill needs a `SKILL.md` with valid YAML frontmatter (`name`, `description`)
+
+### Windows
+
+Some Windows OpenCode builds have Bun path issues with npm packages. If the
+plugin won't install, try:
+
+```powershell
+npm install @ionivetech/mugiwara --prefix "$HOME\.config\opencode"
+```
+
+Then use the local path in `opencode.json`:
+
+```json
+{ "plugin": ["~/.config/opencode/node_modules/@ionivetech/mugiwara"] }
+```
+
+## Tool mapping
+
+Mugiwara skills reference general actions. On OpenCode these map to:
+
+| Action | OpenCode tool |
+|--------|---------------|
+| Create a todo | `todowrite` |
+| Dispatch a subagent | `task` with `subagent_type` |
+| Invoke a skill | `skill` |
+| Read a file | `read` |
+| Edit a file | `edit` or `write` |
+| Run a shell command | `bash` |
+| Search code | `grep`, `glob` |
+| Fetch a URL | `webfetch` |
+
+## 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`

package/docs/install-pi.md

@@ -0,0 +1,46 @@
+# Pi Install
+
+Mugiwara installs as a Pi package.
+
+## Prerequisites
+
+- [Pi](https://github.com/pi) CLI installed
+
+## Install
+
+```bash
+pi install git:github.com/ionivetech/mugiwara
+```
+
+## How it works
+
+Pi reads `package.json` `pi` field (`skills: ["./content/skills"]`) and
+loads all 26 skills. The Pi extension (`pi-extension/`) registers runtime
+hooks if present.
+
+## Verify
+
+Ask:
+
+```
+what mugiwara crew members are available?
+```
+
+## Update
+
+Reinstall with the same command:
+
+```bash
+pi install git:github.com/ionivetech/mugiwara
+```
+
+## Uninstall
+
+```bash
+pi remove mugiwara
+```
+
+## Configuration
+
+After install, configure mugiwara in `.mugiwara/config` (project) or
+`~/.mugiwara/config` (global). See [docs/config.md](config.md).

package/docs/install.md

@@ -0,0 +1,53 @@
+# Install Mugiwara
+
+Mugiwara installs as a native plugin on every supported platform. Pick your
+platform below for detailed instructions.
+
+Requires **Node.js >= 20.11** on the host machine.
+
+## Platforms
+
+| Platform | Install doc | Native plugin? |
+|----------|-------------|:---:|
+| Claude Code | [install-claude](install-claude.md) | ✅ |
+| OpenCode | [install-opencode](install-opencode.md) | ✅ |
+| Gemini CLI | [install-gemini](install-gemini.md) | ✅ |
+| Codex | [install-codex](install-codex.md) | ✅ |
+| GitHub Copilot | [install-copilot](install-copilot.md) | ✅ |
+| Cursor | [install-cursor](install-cursor.md) | ✅ |
+| Antigravity | [install-antigravity](install-antigravity.md) | ✅ |
+| Kimi Code | [install-kimi](install-kimi.md) | ✅ |
+| Pi | [install-pi](install-pi.md) | ✅ |
+| Windsurf / Cline / Kilo | [install-cli](install-cli.md) | CLI-based |
+
+## One-liner
+
+```bash
+# macOS / Linux
+curl -fsSL https://raw.githubusercontent.com/ionivetech/mugiwara/main/scripts/install.sh | bash
+# Windows
+irm https://raw.githubusercontent.com/ionivetech/mugiwara/main/scripts/install.ps1 | iex
+```
+
+## Global CLI
+
+```bash
+npm i -g @ionivetech/mugiwara
+mugiwara install --target all --yes
+```
+
+## Verify
+
+On any platform, ask:
+
+```
+what mugiwara crew members are available?
+```
+
+## Configuration
+
+See [docs/config.md](config.md) for all `.mugiwara/config` options.
+
+## Report issues
+
+https://github.com/ionivetech/mugiwara/issues

package/docs/opencode-setup.md

@@ -35,7 +35,7 @@ npx @ionivetech/mugiwara@latest --project ./my-app --target opencode --yes
 
 - 32 skills in `.opencode/skills/` (project) or `~/.config/opencode/skills/`
   (global).
-- 15 agents registered as subagents via the plugin.
+- 14 agents registered as subagents via the plugin.
 - The plugin announces the crew at session start and injects the inline
   execution model into the system prompt.
 

package/docs/skills.md

@@ -35,7 +35,7 @@ it embodies a role.
 
 | Skill | Teaches |
 |-------|---------|
-| `mugiwara-proof-order` | RED-GREEN-REFACTOR — proof value from WHEN the test runs, not that it exists |
+| `using-mugiwara` | Front-door router — explains the crew, classifies missions, routes to specialist |
 | `mugiwara-root-cause` | 4-phase: reproduce → localize → reduce → fix + guard; stop-the-line |
 | `mugiwara-contract-first` | Contract-first design, error semantics, boundary validation, backward compatibility |
 | `mugiwara-claim-audit` | Adversarial verification: CLAIM → EXTRACT → DOUBT → RECONCILE → STOP |

package/evals/cases/routing-claim-audit.json

@@ -5,7 +5,7 @@
     "positive": [
       { "prompt": "verify this claim before we proceed, it could be wrong", "top_k": 3 },
       { "prompt": "the agent says the fix is done but I want to double-check", "top_k": 3 },
-      { "prompt": "audit this in-flight decision before we commit to it", "top_k": 3 }
+      { "prompt": "skeptically verify this claim and doubt every assertion the model made", "top_k": 3 }
     ],
     "negative": [
       { "prompt": "run the test suite to make sure nothing is broken" },

package/evals/cases/routing-using-mugiwara.json

@@ -0,0 +1,25 @@
+{
+  "name": "routing-using-mugiwara",
+  "skill": "using-mugiwara",
+  "trigger": {
+    "positive": [
+      { "prompt": "how do I use mugiwara to accomplish a task?", "top_k": 3 },
+      { "prompt": "what crew members are available?", "top_k": 3 },
+      { "prompt": "route this task to the right specialist", "top_k": 3 }
+    ],
+    "negative": [
+      { "prompt": "what does git status do?" },
+      { "prompt": "run npm install for me" }
+    ]
+  },
+  "behavioral": [
+    {
+      "task": "Explain how mugiwara works and route a simple task.",
+      "rubric": [
+        "explains the crew structure",
+        "classifies the task correctly",
+        "routes to the right specialist"
+      ]
+    }
+  ]
+}

package/evals/floor.json

@@ -1,6 +1,6 @@
 {
   "rank1": 88.2,
-  "topk": 100,
+  "topk": 98.7,
   "negatives": 100,
   "updated": "2026-08-11"
 }

package/gemini-extension.json

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

package/hooks/hooks.json

@@ -10,6 +10,17 @@
           }
         ]
       }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"${CLAUDE_PLUGIN_ROOT}\"/hooks/mugiwara-mode-tracker.ts",
+            "timeout": 5
+          }
+        ]
+      }
     ]
   }
 }

package/hooks/mugiwara-mode-tracker.ts

@@ -0,0 +1,80 @@
+#!/usr/bin/env bun
+// hooks/mugiwara-mode-tracker.ts — UserPromptSubmit hook: intercepts
+// /mugiwara <mode> commands in Claude Code chat and writes .mugiwara/config.
+// Same logic as the OpenCode plugin's chat.message hook, standalone for
+// Claude Code's hook process model.
+//
+// Input:  JSON on stdin with { prompt: "..." }
+// Output: JSON on stdout with { prompt: "..." } (pass-through)
+
+const VALID_MODES = new Set(['guided', 'semi', 'auto']);
+
+function parseModeChange(promptRaw: string): string | null {
+  if (typeof promptRaw !== 'string') return null;
+  let prompt = promptRaw.trim();
+  const wrapped = /^(["'`])([\s\S]*)\1$/.exec(prompt);
+  if (wrapped) prompt = wrapped[2].trim();
+  prompt = prompt.toLowerCase();
+  if (!prompt) return null;
+
+  const tplSet = /^(?:set |)mugiwara mode:[ \t]*(\S*)/.exec(prompt);
+  if (tplSet && VALID_MODES.has(tplSet[1])) return tplSet[1];
+
+  const slashMode = /^\/(?:mugiwara[-\s]?)?mode[ \t]+(\S*)/.exec(prompt);
+  if (slashMode && VALID_MODES.has(slashMode[1])) return slashMode[1];
+
+  const slashMain = /^\/mugiwara[ \t]+(\S*)/.exec(prompt);
+  if (slashMain && VALID_MODES.has(slashMain[1])) return slashMain[1];
+
+  const natural = /^mugiwara mode[ \t]+(\S*)/.exec(prompt);
+  if (natural && VALID_MODES.has(natural[1])) return natural[1];
+
+  return null;
+}
+
+import { existsSync, mkdirSync, readFileSync, writeFileSync, renameSync } from 'node:fs';
+import { homedir, tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+
+function applyModeChange(mode: string) {
+  if (!VALID_MODES.has(mode)) return;
+  const cwd = process.env.CLAUDE_PROJECT_DIR ?? process.cwd();
+  const dir = join(cwd, '.mugiwara');
+  const file = join(dir, 'config');
+  mkdirSync(dir, { recursive: true });
+  const lines: string[] = [];
+  if (existsSync(file)) {
+    for (const line of readFileSync(file, 'utf8').split(/\r?\n/)) {
+      const t = line.trim();
+      if (t.startsWith('mode=')) continue;
+      lines.push(line);
+    }
+  }
+  lines.push(`mode=${mode}`);
+  const body = lines.filter((_l, i) => !(lines[i] === '' && (i === lines.length - 1 || i === 0))).join('\n') + '\n';
+  const tmp = join(tmpdir(), `mugiwara-config-${process.pid}-${Date.now()}.tmp`);
+  writeFileSync(tmp, body);
+  renameSync(tmp, file);
+}
+
+// main
+async function main() {
+  let input = '';
+  for await (const chunk of process.stdin) input += chunk;
+  if (!input.trim()) { process.stdout.write(JSON.stringify({ prompt: '' })); return; }
+
+  let parsed: { prompt?: string };
+  try { parsed = JSON.parse(input); } catch { parsed = { prompt: input }; }
+  const prompt = parsed.prompt ?? '';
+
+  const change = parseModeChange(prompt);
+  if (change) applyModeChange(change);
+
+  // pass-through — always return the prompt unchanged
+  process.stdout.write(JSON.stringify({ prompt }));
+}
+
+main().catch(() => {
+  // silent — hook must never block the conversation
+  process.stdout.write(JSON.stringify({ prompt: '' }));
+});

package/hooks/session-start.ts

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ionivetech/mugiwara",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "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",
@@ -22,7 +22,16 @@
     "evals",
     "scripts",
     ".opencode",
+    ".claude-plugin",
+    ".codex-plugin",
+    ".cursor-plugin",
+    ".kimi-plugin",
+    ".agents",
     "hooks",
+    "gemini-extension.json",
+    "GEMINI.md",
+    "AGENTS.md",
+    "plugin.json",
     "README.md",
     "LICENSE"
   ],
@@ -43,7 +52,8 @@
     "evals": "bun scripts/run-evals.ts",
     "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 scripts/run-evals.ts && bun scripts/retrieval-eval.ts",
+    "gate": "bun run typecheck && bun run test && bun run build && bun scripts/validate-content.ts --check-manifest --check-docs && bun run verify-pack && bun scripts/run-evals.ts && bun scripts/retrieval-eval.ts",
+    "verify-pack": "npm pack --dry-run 2>&1 | grep -q 'ionivetech-mugiwara' && echo '✓ npm package clean' || (echo '✗ npm pack failed' && exit 1)",
     "prepack": "bun run build && bun run sync-version"
   },
   "keywords": [
@@ -66,6 +76,7 @@
   ],
   "devDependencies": {
     "@types/node": "^26.2.0",
+    "@vitest/coverage-v8": "^4.1.10",
     "typescript": "^7.0.2",
     "vitest": "^4.1.10"
   }