muonroi-cli 1.8.1 → 1.8.4

package/LICENSE

@@ -1,21 +1,9 @@
-MIT License
+Copyright (c) 2026 muonroi. All rights reserved.
 
-Copyright (c) 2026 muonroi
+Commercial / Proprietary License
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+This software and associated documentation files (the "Software") are proprietary to muonroi.
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+Unauthorized copying, modification, distribution, transmission, performance, display or other use of this Software, via any medium, is strictly prohibited.
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+The Software is provided "as is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the Software.

package/README.md

@@ -24,28 +24,39 @@
 
 ### Install
 
-**Recommended — prebuilt standalone binary (zero runtime deps, no prereqs):**
+**Recommended — install globally via NPM (requires Node.js ≥ 20) or Bun (requires Bun ≥ 1.x):**
+
+Using NPM:
+```bash
+npm install -g muonroi-cli
+```
+
+Using Bun:
+```bash
+bun add -g muonroi-cli
+```
+
+Once installed, run:
+```bash
+muonroi-cli
+```
+
+**Alternative — Prebuilt standalone binary (requires access to the GitHub repository):**
 
 Linux / macOS:
 ```bash
+# Note: Requires github authorization if the repository is private
 curl -fsSL https://raw.githubusercontent.com/muonroi/muonroi-cli/master/install.sh | bash
 ```
 
 Windows PowerShell:
 ```powershell
+# Note: Requires github authorization if the repository is private
 irm https://raw.githubusercontent.com/muonroi/muonroi-cli/master/install.ps1 | iex
 ```
 
 The installers download a `bun --compile` binary from GitHub Releases — single executable, all native deps bundled, no Node/Bun/build tools required.
 
-**Bun runtime (requires Bun ≥ 1.x):**
-```bash
-bun add -g muonroi-cli
-muonroi-cli
-```
-
-> **⚠ Why no `npm install -g`?** The TUI engine (`@opentui/core`) uses Bun-only `import ... with { type: "file" }` for Tree-sitter syntax highlight queries (`.scm` files). Node ESM cannot load these, so running under bare Node throws `ERR_UNKNOWN_FILE_EXTENSION`. Use the standalone installer (above) or `bun add -g`.
-
 ### First run
 
 On first launch the CLI shows a wizard that:

package/dist/src/generated/version.d.ts

@@ -1,2 +1,2 @@
-export declare const PACKAGE_VERSION = "1.8.1";
+export declare const PACKAGE_VERSION = "1.8.4";
 export declare const PACKAGE_DESCRIPTION = "BYOK AI coding agent with multi-model council debate, role-based routing, and auto-compact.";

package/dist/src/generated/version.js

@@ -1,5 +1,5 @@
 // AUTO-GENERATED by scripts/sync-version.cjs. DO NOT EDIT BY HAND.
 // Sourced from package.json at build time so it survives bun --compile bundling.
-export const PACKAGE_VERSION = "1.8.1";
+export const PACKAGE_VERSION = "1.8.4";
 export const PACKAGE_DESCRIPTION = "BYOK AI coding agent with multi-model council debate, role-based routing, and auto-compact.";
 //# sourceMappingURL=version.js.map

package/dist/src/mcp/setup-guide-text.d.ts

@@ -6,4 +6,4 @@
  * and the muonroi-tools MCP server (src/mcp/tools-server.ts, for external agents).
  * Keeping it here avoids duplicating ~70 lines across the two.
  */
-export declare const SETUP_GUIDE_TEXT = "# muonroi-cli Setup Guide\n\n## Install (zero runtime deps \u2014 recommended)\nLinux / macOS:\n  curl -fsSL https://raw.githubusercontent.com/muonroi/muonroi-cli/master/install.sh | bash\n\nWindows PowerShell:\n  irm https://raw.githubusercontent.com/muonroi/muonroi-cli/master/install.ps1 | iex\n\nBun (requires Bun >= 1.3):\n  bun add -g muonroi-cli\n  # (npm install -g is NOT supported \u2014 TUI engine uses Bun-only ESM features)\n\nThe installers fetch a pre-compiled single binary from GitHub Releases.\n\n## First run\n- Wizard appears automatically.\n- Lists supported providers (DeepSeek + SiliconFlow ready; others via BYOK).\n- Four credential options: paste key, Bitwarden sync (B in /providers), keys export/import (encrypted bundle), or skip for later.\n- Keys land in OS keychain (keytar). Settings written to ~/.muonroi-cli/user-settings.json.\n- Role routing (leader/implement/verify/research) is configured for you.\n\nAfter setup: run `muonroi-cli doctor` to validate.\n\n## Essential commands\n- Interactive TUI: `muonroi-cli` (or `node dist/index.js` after build)\n- Headless one-shot: `muonroi-cli --prompt \"your task\" --max-tool-rounds 8`\n- Health + MCP nudge: `muonroi-cli doctor`\n- Update: `muonroi-cli update` (or set \"autoUpdate\": true in user-settings)\n- Keys move between machines: `muonroi-cli keys export file.json` then import on target\n- Native tools MCP (for external agents): `muonroi-cli tools-mcp` (stdio)\n- Harness driver MCP: `muonroi-cli mcp-driver`\n\n## MCP integration (for Claude Desktop, Cursor, other agents)\nAdd to your MCP client config:\n\n{\n  \"mcpServers\": {\n    \"muonroi-tools\": {\n      \"command\": \"bun\",\n      \"args\": [\"run\", \"/absolute/path/to/muonroi-cli/src/index.ts\", \"tools-mcp\"]\n    }\n  }\n}\n\n(Use absolute path. After `bun run build`: \"node\", \"dist/index.js\", \"tools-mcp\")\n\nThe CLI's OWN inner agent exposes these as NATIVE in-process tools (no MCP self-spawn):\n- setup_guide (this document)\n- ee_query / ee_health / ee_feedback \u2014 Experience Engine semantic recall + compaction checkpoints + feedback for learning\n- usage_forensics <id-prefix> \u2014 per-session cost/token forensics (peak input, cache hits, anomalies)\n- lsp_query \u2014 goToDefinition, findReferences, hover, symbols, call hierarchy etc.\n- selfverify_* \u2014 Tier-1 heuristic + Tier-2 agentic self-QA harness runs (start/poll/result/cancel/list)\n\nFor BB/.NET template recipes and package docs, also connect an external \"muonroi-docs\" MCP server if available (provides docs_search + setup_guide for the templates).\n\n## Development\ngit clone https://github.com/muonroi/muonroi-cli.git\ncd muonroi-cli && bun install\n\nbun run dev                 # run from source (TUI)\nbun run typecheck           # tsc --noEmit\nbun run test                # vitest (unit + headless)\nbunx vitest -c vitest.harness.config.ts run tests/harness/   # TUI E2E (named-pipes on Win, fd3/4 on POSIX)\nbun run build               # or build:binary for standalone exe\n\nSee AGENTS.md (quick ref + rules), CLAUDE.md (harness verification), README.md.\n\n## Verify\nmuonroi-cli doctor\n# Checks runtimes, catalog load, keychain, MCP servers enabled, council research MCP nudge, EE reachability, recent error rate.\n# Any \"warn\" entries tell you exactly what to enable (e.g. tavily for web research in council).\n\nFor BB-aware scaffolding (/ideal on a muonroi-building-block target): ensure dotnet SDK + the three Muonroi.*.Template packages are installed via NuGet; doctor surfaces missing feed/template cases.\n";
+export declare const SETUP_GUIDE_TEXT = "# muonroi-cli Setup Guide\n\n## Install (Recommended \u2014 NPM/Bun global install)\nNPM (requires Node >= 20):\n  npm install -g muonroi-cli\n\nBun (requires Bun >= 1.3):\n  bun add -g muonroi-cli\n\n## Install (Alternative \u2014 Prebuilt standalone binary, requires repo access)\nLinux / macOS:\n  curl -fsSL https://raw.githubusercontent.com/muonroi/muonroi-cli/master/install.sh | bash\n\nWindows PowerShell:\n  irm https://raw.githubusercontent.com/muonroi/muonroi-cli/master/install.ps1 | iex\n\nThe installers fetch a pre-compiled single binary from GitHub Releases.\n\n## First run\n- Wizard appears automatically.\n- Lists supported providers (DeepSeek + SiliconFlow ready; others via BYOK).\n- Four credential options: paste key, Bitwarden sync (B in /providers), keys export/import (encrypted bundle), or skip for later.\n- Keys land in OS keychain (keytar). Settings written to ~/.muonroi-cli/user-settings.json.\n- Role routing (leader/implement/verify/research) is configured for you.\n\nAfter setup: run `muonroi-cli doctor` to validate.\n\n## Essential commands\n- Interactive TUI: `muonroi-cli` (or `node dist/index.js` after build)\n- Headless one-shot: `muonroi-cli --prompt \"your task\" --max-tool-rounds 8`\n- Health + MCP nudge: `muonroi-cli doctor`\n- Update: `muonroi-cli update` (or set \"autoUpdate\": true in user-settings)\n- Keys move between machines: `muonroi-cli keys export file.json` then import on target\n- Native tools MCP (for external agents): `muonroi-cli tools-mcp` (stdio)\n- Harness driver MCP: `muonroi-cli mcp-driver`\n\n## MCP integration (for Claude Desktop, Cursor, other agents)\nAdd to your MCP client config:\n\n{\n  \"mcpServers\": {\n    \"muonroi-tools\": {\n      \"command\": \"bun\",\n      \"args\": [\"run\", \"/absolute/path/to/muonroi-cli/src/index.ts\", \"tools-mcp\"]\n    }\n  }\n}\n\n(Use absolute path. After `bun run build`: \"node\", \"dist/index.js\", \"tools-mcp\")\n\nThe CLI's OWN inner agent exposes these as NATIVE in-process tools (no MCP self-spawn):\n- setup_guide (this document)\n- ee_query / ee_health / ee_feedback \u2014 Experience Engine semantic recall + compaction checkpoints + feedback for learning\n- usage_forensics <id-prefix> \u2014 per-session cost/token forensics (peak input, cache hits, anomalies)\n- lsp_query \u2014 goToDefinition, findReferences, hover, symbols, call hierarchy etc.\n- selfverify_* \u2014 Tier-1 heuristic + Tier-2 agentic self-QA harness runs (start/poll/result/cancel/list)\n\nFor BB/.NET template recipes and package docs, also connect an external \"muonroi-docs\" MCP server if available (provides docs_search + setup_guide for the templates).\n\n## Development\ngit clone https://github.com/muonroi/muonroi-cli.git\ncd muonroi-cli && bun install\n\nbun run dev                 # run from source (TUI)\nbun run typecheck           # tsc --noEmit\nbun run test                # vitest (unit + headless)\nbunx vitest -c vitest.harness.config.ts run tests/harness/   # TUI E2E (named-pipes on Win, fd3/4 on POSIX)\nbun run build               # or build:binary for standalone exe\n\nSee AGENTS.md (quick ref + rules), CLAUDE.md (harness verification), README.md.\n\n## Verify\nmuonroi-cli doctor\n# Checks runtimes, catalog load, keychain, MCP servers enabled, council research MCP nudge, EE reachability, recent error rate.\n# Any \"warn\" entries tell you exactly what to enable (e.g. tavily for web research in council).\n\nFor BB-aware scaffolding (/ideal on a muonroi-building-block target): ensure dotnet SDK + the three Muonroi.*.Template packages are installed via NuGet; doctor surfaces missing feed/template cases.\n";

package/dist/src/mcp/setup-guide-text.js

@@ -8,17 +8,20 @@
  */
 export const SETUP_GUIDE_TEXT = `# muonroi-cli Setup Guide
 
-## Install (zero runtime deps — recommended)
+## Install (Recommended — NPM/Bun global install)
+NPM (requires Node >= 20):
+  npm install -g muonroi-cli
+
+Bun (requires Bun >= 1.3):
+  bun add -g muonroi-cli
+
+## Install (Alternative — Prebuilt standalone binary, requires repo access)
 Linux / macOS:
   curl -fsSL https://raw.githubusercontent.com/muonroi/muonroi-cli/master/install.sh | bash
 
 Windows PowerShell:
   irm https://raw.githubusercontent.com/muonroi/muonroi-cli/master/install.ps1 | iex
 
-Bun (requires Bun >= 1.3):
-  bun add -g muonroi-cli
-  # (npm install -g is NOT supported — TUI engine uses Bun-only ESM features)
-
 The installers fetch a pre-compiled single binary from GitHub Releases.
 
 ## First run

package/dist/src/orchestrator/orchestrator.js

@@ -2165,20 +2165,29 @@ export class Agent {
         logger.debug("orchestrator", "Checking silent session rotation threshold", { currentChars, threshold });
         // 1. Run classifier to decide execution route
         let routeAction = "DIRECT_ANSWER";
-        try {
-            const { classifySubSessionAction } = await import("../pil/llm-classify.js");
-            const routeResult = await classifySubSessionAction(this.requireProvider(), this.modelId, userMessage);
-            if (routeResult) {
-                routeAction = routeResult.action;
-                logger.info("orchestrator", "Routing action selected for user message", {
-                    action: routeAction,
-                    confidence: routeResult.confidence,
-                    reason: routeResult.reason,
-                });
-            }
+        const isMockMode = process.argv.includes("--mock-llm") ||
+            !!globalThis.__muonroiMockModel ||
+            process.env.NODE_ENV === "test";
+        const forceClassify = process.env.MUONROI_FORCE_ROUTING_CLASSIFY === "1";
+        if (isMockMode && !forceClassify) {
+            logger.debug("orchestrator", "Skipping sub-session routing classification in mock/test mode");
         }
-        catch (err) {
-            logger.error("orchestrator", "Routing classification failed, falling back to DIRECT_ANSWER", { error: err });
+        else {
+            try {
+                const { classifySubSessionAction } = await import("../pil/llm-classify.js");
+                const routeResult = await classifySubSessionAction(this.requireProvider(), this.modelId, userMessage);
+                if (routeResult) {
+                    routeAction = routeResult.action;
+                    logger.info("orchestrator", "Routing action selected for user message", {
+                        action: routeAction,
+                        confidence: routeResult.confidence,
+                        reason: routeResult.reason,
+                    });
+                }
+            }
+            catch (err) {
+                logger.error("orchestrator", "Routing classification failed, falling back to DIRECT_ANSWER", { error: err });
+            }
         }
         const shouldRotate = currentChars > threshold || routeAction === "ROTATE_SESSION";
         if (shouldRotate && this.session && this.sessionStore) {

package/dist/src/orchestrator/tool-engine.d.ts

@@ -147,6 +147,10 @@ export declare function rewriteSafetyApprovedToolResults<T extends {
     role: string;
     content?: any;
 }>(messages: T[]): T[];
+export declare class SimpleMutex {
+    private queue;
+    run<T>(fn: () => Promise<T> | T): Promise<T>;
+}
 export interface ToolEngineArgs {
     [key: string]: any;
 }

package/dist/src/orchestrator/tool-engine.js

@@ -193,6 +193,24 @@ export function rewriteSafetyApprovedToolResults(messages) {
         return changed ? { ...m, content: newContent } : m;
     });
 }
+export class SimpleMutex {
+    queue = Promise.resolve();
+    async run(fn) {
+        let resolveLock;
+        const lockPromise = new Promise((resolve) => {
+            resolveLock = resolve;
+        });
+        const previous = this.queue;
+        this.queue = lockPromise;
+        await previous;
+        try {
+            return await fn();
+        }
+        finally {
+            resolveLock();
+        }
+    }
+}
 import { stripDsmlMarkup } from "./message-processor.js";
 export async function* executeToolEngine(args) {
     let { deps, stepRouterPhase, phase2Runtime, runtime, modelInfo, _debugSteps, _ceilingHit, userMessage, pilCtx, turnModelId, turnProvider, _stepCeiling, userModelMessage, userEnrichedMessage, signal, observer, taskHash, provider, system, routerStore, attemptedOverflowRecovery, patternLoopForceHalt, userWriteAheadSeq, streamRetryCount, MAX_STREAM_RETRIES, subagents, systemParts, toolTurnSystem, playwrightGuidance, _hasResponseTools, _pilResponseTools, patternLoopInjectCount, agentLoopDecisionCount, MAX_AGENT_LOOP_DECISIONS, _naturalCeiling, _ceilingTaskType, _ceilingSize, textToolReSteerCount, MAX_TEXT_TOOL_RESTEER, turnStartMs, _debugOn, _debugTurnId, _pilEnrichmentDeltaSnapshot, isChitchat, } = args;
@@ -618,6 +636,37 @@ export async function* executeToolEngine(args) {
                 });
                 // Phase C3: layer cross-turn dedup on top of the top-level cap.
                 const tools = wrapToolSetWithReadBudget(wrapToolSetWithDedup(topLevelCap.tools, deps.crossTurnDedup), deps.readBudget);
+                // Wrap non-read-only tools in a turn-scoped mutex to prevent race conditions during parallel execution.
+                const writeMutex = new SimpleMutex();
+                const READ_ONLY_TOOLS = new Set([
+                    "read_file",
+                    "grep",
+                    "bash_output_get",
+                    "process_list",
+                    "delegation_read",
+                    "delegation_list",
+                    "ee_query",
+                    "ee_health",
+                    "usage_forensics",
+                    "lsp_query",
+                    "setup_guide",
+                    "selfverify_status",
+                    "selfverify_result",
+                    "selfverify_list",
+                    "list_vision_cache",
+                ]);
+                for (const name of Object.keys(tools)) {
+                    const tool = tools[name];
+                    if (tool &&
+                        typeof tool.execute === "function" &&
+                        !READ_ONLY_TOOLS.has(name) &&
+                        !name.startsWith("respond_")) {
+                        const originalExecute = tool.execute;
+                        tool.execute = async (input, context) => {
+                            return writeMutex.run(() => originalExecute(input, context));
+                        };
+                    }
+                }
                 captureToolSchemas(tools);
                 let responseToolCalled = false;
                 // A turn must surface exactly ONE final structured answer. Cheap

package/dist/src/utils/install-manager.d.ts

@@ -51,6 +51,7 @@ export declare function saveScriptInstallMetadata(metadata: ScriptInstallMetadat
 export declare function getScriptInstallContext(homeDir?: string): ScriptInstallContext | null;
 export declare function fetchLatestGitTag(gitDir: string): Promise<string | null>;
 export declare function fetchLatestReleaseVersion(): Promise<string | null>;
+export declare function fetchLatestNpmVersion(pkgName?: string): Promise<string | null>;
 export declare function parseChecksumsFile(contents: string): Map<string, string>;
 /**
  * How this muonroi-cli was installed. Drives which update path the built-in

package/dist/src/utils/install-manager.js

@@ -115,6 +115,27 @@ export async function fetchLatestReleaseVersion() {
     const release = await fetchReleaseJson(`${RELEASES_API}/latest`);
     return release ? normalizeReleaseVersion(release.tag_name) : null;
 }
+export async function fetchLatestNpmVersion(pkgName = "muonroi-cli") {
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+        const res = await fetch(`https://registry.npmjs.org/${pkgName}/latest`, {
+            signal: controller.signal,
+            headers: {
+                Accept: "application/json",
+                "User-Agent": "muonroi-cli",
+            },
+        });
+        clearTimeout(timer);
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        return data.version ? semverValid(data.version) : null;
+    }
+    catch {
+        return null;
+    }
+}
 export function parseChecksumsFile(contents) {
     const result = new Map();
     for (const rawLine of contents.split(/\r?\n/)) {
@@ -212,8 +233,14 @@ export async function runManagedUpdate(currentVersion) {
     if (method === "dev-link" && root) {
         latestVersion = await fetchLatestGitTag(root);
     }
+    else if (method === "bun-global" || method === "npm-global") {
+        latestVersion = await fetchLatestNpmVersion("muonroi-cli");
+    }
     else {
         latestVersion = await fetchLatestReleaseVersion();
+        if (!latestVersion) {
+            latestVersion = await fetchLatestNpmVersion("muonroi-cli");
+        }
     }
     const normalizedCurrent = semverValid(currentVersion);
     let statusHeader = "";
@@ -221,21 +248,23 @@ export async function runManagedUpdate(currentVersion) {
     if (latestVersion && normalizedCurrent) {
         hasUpdate = semverGt(latestVersion, normalizedCurrent);
         if (hasUpdate) {
-            statusHeader = `A new version of muonroi-cli is available!\n  Current version: v${normalizedCurrent}\n  Latest version: v${latestVersion}\n\n`;
+            statusHeader = `### 🔄 Update Available\n* **Current Version:** \`v${normalizedCurrent}\`\n* **Latest Version:** \`v${latestVersion}\`\n* **Status:** A new version of \`muonroi-cli\` is available!\n\n`;
+        }
+        else if (semverGt(normalizedCurrent, latestVersion)) {
+            statusHeader = `### 🚀 Ahead of Latest Release\n* **Current Version:** \`v${normalizedCurrent}\`\n* **Latest Version:** \`v${latestVersion}\`\n* **Status:** Your local installation is newer than the remote release tag.\n\n`;
         }
         else {
-            statusHeader = `You are already up to date!\n  Current version: v${normalizedCurrent}\n  Latest version: v${latestVersion}\n\n`;
+            statusHeader = `### ✅ Up to Date\n* **Current Version:** \`v${normalizedCurrent}\`\n* **Latest Version:** \`v${latestVersion}\`\n* **Status:** You are already up to date!\n\n`;
         }
     }
     else if (normalizedCurrent) {
-        statusHeader = `Current version: v${normalizedCurrent}\nUnable to check the latest version from GitHub.\n\n`;
+        statusHeader = `### ⚠️ Update Status\n* **Current Version:** \`v${normalizedCurrent}\`\n* **Status:** Unable to check the latest version from GitHub or NPM.\n\n`;
     }
     const cmd = getUpdateCommandForMethod(method);
     if (cmd) {
-        const pm = method === "bun-global" ? "bun" : "npm";
         const instruction = hasUpdate
-            ? `To update, run this in a fresh terminal:\n\n  ${cmd}\n\nThen restart muonroi-cli.`
-            : `If you want to reinstall, run this in a fresh terminal:\n\n  ${cmd}`;
+            ? `To update, run this in a fresh terminal:\n\`\`\`bash\n${cmd}\n\`\`\`\nThen restart \`muonroi-cli\`.`
+            : `If you want to reinstall, run this in a fresh terminal:\n\`\`\`bash\n${cmd}\n\`\`\``;
         return {
             success: true,
             output: `${statusHeader}${instruction}`,
@@ -245,8 +274,8 @@ export async function runManagedUpdate(currentVersion) {
         const target = getReleaseTargetForPlatform();
         const asset = target?.assetName ?? "the release asset for your platform";
         const instruction = hasUpdate
-            ? `Download the latest ${asset} from https://github.com/${GITHUB_REPO}/releases/latest and replace the current binary, or rebuild from source.`
-            : `If you want to reinstall, download the latest ${asset} from https://github.com/${GITHUB_REPO}/releases/latest and replace the current binary.`;
+            ? `Download the latest \`${asset}\` from [GitHub Releases](https://github.com/${GITHUB_REPO}/releases/latest) and replace the current binary, or rebuild from source.`
+            : `If you want to reinstall, download the latest \`${asset}\` from [GitHub Releases](https://github.com/${GITHUB_REPO}/releases/latest) and replace the current binary.`;
         return {
             success: true,
             output: `${statusHeader}${instruction}`,
@@ -255,8 +284,8 @@ export async function runManagedUpdate(currentVersion) {
     if (method === "dev-link") {
         const target = root ?? "the muonroi-cli checkout";
         const instruction = hasUpdate
-            ? `To update, pull the latest changes and rebuild:\n\n  git -C "${target}" pull && bun install && bun run build\n\nThen restart muonroi-cli. (If you also use the compiled muonroi-cli-dev binary, rebuild that separately.)`
-            : `To rebuild your local installation:\n\n  git -C "${target}" pull && bun install && bun run build\n\nThen restart muonroi-cli.`;
+            ? `To update, pull the latest changes and rebuild:\n\`\`\`bash\ngit -C "${target}" pull && bun install && bun run build\n\`\`\`\nThen restart \`muonroi-cli\`. (If you also use the compiled muonroi-cli-dev binary, rebuild that separately.)`
+            : `To rebuild your local installation:\n\`\`\`bash\ngit -C "${target}" pull && bun install && bun run build\n\`\`\`\nThen restart \`muonroi-cli\`.`;
         return {
             success: true,
             output: `${statusHeader}${instruction}`,
@@ -411,11 +440,13 @@ async function fetchReleaseJson(url) {
     try {
         const controller = new AbortController();
         const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+        const token = process.env.GITHUB_TOKEN || process.env.GH_TOKEN;
         const res = await fetch(url, {
             signal: controller.signal,
             headers: {
                 Accept: "application/vnd.github+json",
                 "User-Agent": "muonroi-cli",
+                ...(token ? { Authorization: `token ${token}` } : {}),
             },
         });
         clearTimeout(timer);

package/dist/src/utils/update-checker.js

@@ -1,9 +1,19 @@
 import semverGt from "semver/functions/gt.js";
 import semverValid from "semver/functions/valid.js";
-import { fetchLatestReleaseVersion, runManagedUpdate } from "./install-manager.js";
+import { detectInstallMethod, fetchLatestNpmVersion, fetchLatestReleaseVersion, runManagedUpdate, } from "./install-manager.js";
 export async function checkForUpdate(currentVersion) {
     try {
-        const latestVersion = await fetchLatestReleaseVersion();
+        const method = detectInstallMethod();
+        let latestVersion = null;
+        if (method === "bun-global" || method === "npm-global") {
+            latestVersion = await fetchLatestNpmVersion("muonroi-cli");
+        }
+        else {
+            latestVersion = await fetchLatestReleaseVersion();
+            if (!latestVersion) {
+                latestVersion = await fetchLatestNpmVersion("muonroi-cli");
+            }
+        }
         if (!latestVersion || !semverValid(latestVersion))
             return null;
         const normalizedCurrent = semverValid(currentVersion);

package/package.json

@@ -3,7 +3,7 @@
   "workspaces": [
     "packages/*"
   ],
-  "version": "1.8.1",
+  "version": "1.8.4",
   "description": "BYOK AI coding agent with multi-model council debate, role-based routing, and auto-compact.",
   "repository": {
     "type": "git",
@@ -59,6 +59,13 @@
     "dist/",
     "!dist/**/*.exe",
     "!dist/**/*.map",
+    "!dist/**/__tests__/**",
+    "!dist/**/__test-helpers__/**",
+    "!dist/**/__test-stubs__/**",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.spec.js",
+    "!dist/**/*.spec.d.ts",
     "scripts/postinstall.cjs"
   ],
   "keywords": [
@@ -70,7 +77,7 @@
     "opentui"
   ],
   "author": "muonroi",
-  "license": "MIT",
+  "license": "UNLICENSED",
   "dependencies": {
     "@ai-sdk/anthropic": "3.0.72",
     "@ai-sdk/google": "3.0.65",

package/dist/src/__test-helpers__/catalog-fixtures.d.ts

@@ -1,22 +0,0 @@
-/**
- * Test fixtures derived from catalog.json — zero hardcoded model/provider strings.
- *
- * Usage in tests:
- *   import { TEST_MODELS, TEST_PROVIDERS } from "../../__test-helpers__/catalog-fixtures.js";
- *   // then use TEST_MODELS.fast, TEST_MODELS.premium, TEST_PROVIDERS.default, etc.
- *
- * These resolve at import time from the loaded catalog. If catalog isn't loaded
- * yet, call `await loadCatalog()` in beforeAll.
- */
-export declare function getTestModels(): {
-    fast: string;
-    balanced: string;
-    premium: string;
-};
-export declare function getTestProviders(): {
-    default: string;
-    all: string[];
-};
-export declare function getTestModelForProvider(provider: string, tier?: "fast" | "balanced" | "premium"): string;
-export declare function getAnyTestModel(): string;
-export declare function getTestProviderForModel(modelId: string): string;

package/dist/src/__test-helpers__/catalog-fixtures.js

@@ -1,55 +0,0 @@
-/**
- * Test fixtures derived from catalog.json — zero hardcoded model/provider strings.
- *
- * Usage in tests:
- *   import { TEST_MODELS, TEST_PROVIDERS } from "../../__test-helpers__/catalog-fixtures.js";
- *   // then use TEST_MODELS.fast, TEST_MODELS.premium, TEST_PROVIDERS.default, etc.
- *
- * These resolve at import time from the loaded catalog. If catalog isn't loaded
- * yet, call `await loadCatalog()` in beforeAll.
- */
-import { getModelByTier, MODELS } from "../models/registry.js";
-import { getDefaultProvider } from "../utils/settings.js";
-function requireModel(tier, provider) {
-    const m = getModelByTier(tier, provider);
-    if (m)
-        return m.id;
-    throw new Error(`No ${tier} model in catalog${provider ? ` for provider ${provider}` : ""}. Load catalog first.`);
-}
-function requireProvider() {
-    const p = getDefaultProvider();
-    if (p)
-        return p;
-    const first = MODELS.find(() => true);
-    if (first?.provider)
-        return first.provider;
-    throw new Error("No provider available. Load catalog first.");
-}
-export function getTestModels() {
-    return {
-        fast: requireModel("fast"),
-        balanced: requireModel("balanced"),
-        premium: requireModel("premium"),
-    };
-}
-export function getTestProviders() {
-    return {
-        default: requireProvider(),
-        all: [...new Set(MODELS.map((m) => m.provider).filter(Boolean))],
-    };
-}
-export function getTestModelForProvider(provider, tier = "fast") {
-    return requireModel(tier, provider);
-}
-export function getAnyTestModel() {
-    if (MODELS.length === 0)
-        throw new Error("No models in catalog. Load catalog first.");
-    return MODELS[0 /* first available */].id;
-}
-export function getTestProviderForModel(modelId) {
-    const m = MODELS.find((m) => m.id === modelId);
-    if (m?.provider)
-        return m.provider;
-    throw new Error(`Model "${modelId}" not in catalog.`);
-}
-//# sourceMappingURL=catalog-fixtures.js.map

package/dist/src/__test-stubs__/ee-server.d.ts

@@ -1,27 +0,0 @@
-/**
- * Local HTTP stub server for Experience Engine endpoints.
- * Reused by plans 03/07/08 -- do not couple to a single test file.
- *
- * Uses Node http module for compatibility with vitest (runs under Node, not Bun).
- */
-import { type Server } from "node:http";
-export interface StubConfig {
-    port?: number;
-    routeModel?: (req: any) => any;
-    coldRoute?: (req: any) => any;
-    intercept?: (req: any) => any;
-    posttool?: (req: any) => void;
-    feedback?: (req: any) => void;
-    touch?: (id: string) => void;
-    extract?: (req: any) => any;
-    promptStale?: (req: any) => any;
-    health?: () => boolean;
-    latencyMs?: number;
-}
-export interface StubHandle {
-    server: Server;
-    port: number;
-    stop(): Promise<void>;
-    calls: Record<string, any[]>;
-}
-export declare function startStubEEServer(cfg?: StubConfig): Promise<StubHandle>;