muonroi-cli 1.3.4 → 1.4.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 muonroi
-
-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:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of 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.
+MIT License
+
+Copyright (c) 2026 muonroi
+
+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:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of 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

@@ -1,122 +1,122 @@
-<p align="center">
-  <h1 align="center">muonroi-cli</h1>
-  <p align="center">
-    <em>An AI coding agent where models argue with each other before answering.</em>
-  </p>
-  <p align="center">
-    <a href="https://github.com/muonroi/muonroi-cli/actions/workflows/ci-matrix.yml"><img alt="CI" src="https://github.com/muonroi/muonroi-cli/actions/workflows/ci-matrix.yml/badge.svg"></a>
-    <a href="https://www.npmjs.com/package/muonroi-cli"><img alt="npm" src="https://img.shields.io/npm/v/muonroi-cli.svg"></a>
-    <img alt="Providers" src="https://img.shields.io/badge/providers-7%20supported-blue">
-    <img alt="License" src="https://img.shields.io/badge/license-MIT-yellow">
-    <img alt="Runtime" src="https://img.shields.io/badge/runtime-Bun%201.3%2B-orange">
-  </p>
-</p>
-
----
-
-> Routes each task to the optimal model, runs adversarial multi-model debates for high-stakes decisions, and persists behavioral memory across sessions. Bring your own API keys. Total cost: ~$5/month.
-
-<p align="center">
-  <img src="https://raw.githubusercontent.com/muonroi/muonroi-cli/master/docs/demo.gif" alt="Council debate — REST vs gRPC decision" width="840" />
-</p>
-
-## Quick Start
-
-### Install
-
-**Recommended — prebuilt standalone binary (zero runtime deps, no prereqs):**
-
-Linux / macOS:
-```bash
-curl -fsSL https://raw.githubusercontent.com/muonroi/muonroi-cli/master/install.sh | bash
-```
-
-Windows PowerShell:
-```powershell
-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:
-1. Lists supported providers (currently **DeepSeek** and **SiliconFlow**).
-2. Offers four ways to add credentials: paste an API key, import an encrypted bundle (`keys export`/`keys import`), sync from Bitwarden, or skip and add later via `/providers` inside the TUI.
-
-After setup, role routing auto-balances across enabled providers:
-
-```json
-// ~/.muonroi-cli/user-settings.json (generated by the wizard — edit if needed)
-{
-  "defaultProvider": "deepseek",
-  "providers": {
-    "deepseek":    { "enabled": true },
-    "siliconflow": { "enabled": true }
-  },
-  "roleModels": {
-    "leader":    "deepseek-v4-pro",
-    "implement": "deepseek-v4-flash",
-    "verify":    "deepseek-v4-pro",
-    "research":  "deepseek-v4-flash"
-  }
-}
-```
-
-### Moving keys between devices
-
-```bash
-# Source device — encrypts every stored key into one passphrase-protected file
-muonroi-cli keys export ~/muonroi-keys.json
-
-# Move the file via any channel (USB, Drive, AirDrop, email...)
-
-# Target device — same passphrase rehydrates the OS keychain
-muonroi-cli keys import ~/muonroi-keys.json
-```
-
-Inside the TUI press `/providers` then `B` to sync directly from a Bitwarden vault instead.
-
-### Updates
-
-The CLI checks npm once per day on startup and prompts when a newer version is available. Set `autoUpdate: true` in `user-settings.json` to skip the prompt and update silently. Manual: `muonroi-cli update`.
-
-## Documentation
-
-Full documentation at **[docs.muonroi.com/docs/cli](https://docs.muonroi.com/docs/cli/overview)**
-
-| Topic | Link |
-|---|---|
-| Overview & architecture | [CLI Overview](https://docs.muonroi.com/docs/cli/overview) |
-| Multi-Model Council | [Council Debate Guide](https://docs.muonroi.com/docs/cli/guides/council-debate) |
-| Prompt Intelligence Layer | [PIL Pipeline Guide](https://docs.muonroi.com/docs/cli/guides/pil-pipeline) |
-| Experience Engine | [Experience Engine Guide](https://docs.muonroi.com/docs/cli/guides/experience-engine) |
-| Agent Harness | [Agent Harness Guide](https://docs.muonroi.com/docs/cli/guides/agent-harness) |
-| Settings reference | [CLI Settings Reference](https://docs.muonroi.com/docs/cli/reference/cli-settings-reference) |
-| Commands reference | [Commands Reference](https://docs.muonroi.com/docs/cli/reference/commands-reference) |
-| Providers reference | [Providers Reference](https://docs.muonroi.com/docs/cli/reference/providers-reference) |
-
-## Development
-
-```bash
-git clone https://github.com/muonroi/muonroi-cli.git
-cd muonroi-cli && bun install
-
-bun run dev           # run from source
-bun run typecheck     # type check
-bun run test          # vitest
-bun run lint          # biome check
-bun run build:binary  # standalone binary
-```
-
-## License
-
-MIT
+<p align="center">
+  <h1 align="center">muonroi-cli</h1>
+  <p align="center">
+    <em>An AI coding agent where models argue with each other before answering.</em>
+  </p>
+  <p align="center">
+    <a href="https://github.com/muonroi/muonroi-cli/actions/workflows/ci-matrix.yml"><img alt="CI" src="https://github.com/muonroi/muonroi-cli/actions/workflows/ci-matrix.yml/badge.svg"></a>
+    <a href="https://www.npmjs.com/package/muonroi-cli"><img alt="npm" src="https://img.shields.io/npm/v/muonroi-cli.svg"></a>
+    <img alt="Providers" src="https://img.shields.io/badge/providers-7%20supported-blue">
+    <img alt="License" src="https://img.shields.io/badge/license-MIT-yellow">
+    <img alt="Runtime" src="https://img.shields.io/badge/runtime-Bun%201.3%2B-orange">
+  </p>
+</p>
+
+---
+
+> Routes each task to the optimal model, runs adversarial multi-model debates for high-stakes decisions, and persists behavioral memory across sessions. Bring your own API keys. Total cost: ~$5/month.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/muonroi/muonroi-cli/master/docs/demo.gif" alt="Council debate — REST vs gRPC decision" width="840" />
+</p>
+
+## Quick Start
+
+### Install
+
+**Recommended — prebuilt standalone binary (zero runtime deps, no prereqs):**
+
+Linux / macOS:
+```bash
+curl -fsSL https://raw.githubusercontent.com/muonroi/muonroi-cli/master/install.sh | bash
+```
+
+Windows PowerShell:
+```powershell
+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:
+1. Lists supported providers (currently **DeepSeek** and **SiliconFlow**).
+2. Offers four ways to add credentials: paste an API key, import an encrypted bundle (`keys export`/`keys import`), sync from Bitwarden, or skip and add later via `/providers` inside the TUI.
+
+After setup, role routing auto-balances across enabled providers:
+
+```json
+// ~/.muonroi-cli/user-settings.json (generated by the wizard — edit if needed)
+{
+  "defaultProvider": "deepseek",
+  "providers": {
+    "deepseek":    { "enabled": true },
+    "siliconflow": { "enabled": true }
+  },
+  "roleModels": {
+    "leader":    "deepseek-v4-pro",
+    "implement": "deepseek-v4-flash",
+    "verify":    "deepseek-v4-pro",
+    "research":  "deepseek-v4-flash"
+  }
+}
+```
+
+### Moving keys between devices
+
+```bash
+# Source device — encrypts every stored key into one passphrase-protected file
+muonroi-cli keys export ~/muonroi-keys.json
+
+# Move the file via any channel (USB, Drive, AirDrop, email...)
+
+# Target device — same passphrase rehydrates the OS keychain
+muonroi-cli keys import ~/muonroi-keys.json
+```
+
+Inside the TUI press `/providers` then `B` to sync directly from a Bitwarden vault instead.
+
+### Updates
+
+The CLI checks npm once per day on startup and prompts when a newer version is available. Set `autoUpdate: true` in `user-settings.json` to skip the prompt and update silently. Manual: `muonroi-cli update`.
+
+## Documentation
+
+Full documentation at **[docs.muonroi.com/docs/cli](https://docs.muonroi.com/docs/cli/overview)**
+
+| Topic | Link |
+|---|---|
+| Overview & architecture | [CLI Overview](https://docs.muonroi.com/docs/cli/overview) |
+| Multi-Model Council | [Council Debate Guide](https://docs.muonroi.com/docs/cli/guides/council-debate) |
+| Prompt Intelligence Layer | [PIL Pipeline Guide](https://docs.muonroi.com/docs/cli/guides/pil-pipeline) |
+| Experience Engine | [Experience Engine Guide](https://docs.muonroi.com/docs/cli/guides/experience-engine) |
+| Agent Harness | [Agent Harness Guide](https://docs.muonroi.com/docs/cli/guides/agent-harness) |
+| Settings reference | [CLI Settings Reference](https://docs.muonroi.com/docs/cli/reference/cli-settings-reference) |
+| Commands reference | [Commands Reference](https://docs.muonroi.com/docs/cli/reference/commands-reference) |
+| Providers reference | [Providers Reference](https://docs.muonroi.com/docs/cli/reference/providers-reference) |
+
+## Development
+
+```bash
+git clone https://github.com/muonroi/muonroi-cli.git
+cd muonroi-cli && bun install
+
+bun run dev           # run from source
+bun run typecheck     # type check
+bun run test          # vitest
+bun run lint          # biome check
+bun run build:binary  # standalone binary
+```
+
+## License
+
+MIT

package/dist/packages/agent-harness-core/src/predicate.d.ts

@@ -2,15 +2,15 @@ import { z } from "zod";
 import type { UINode } from "./protocol.js";
 declare const FieldOp: z.ZodObject<{
     field: z.ZodEnum<{
-        value: "value";
         name: "name";
+        value: "value";
         state: "state";
     }>;
     op: z.ZodEnum<{
+        regex: "regex";
         eq: "eq";
         neq: "neq";
         contains: "contains";
-        regex: "regex";
     }>;
     rhs: z.ZodString;
 }, z.core.$strip>;

package/dist/packages/agent-harness-core/src/protocol.d.ts

@@ -169,6 +169,14 @@ export type LiveEvent = {
     errorName: string;
     errorMessage: string;
     nextDelayMs: number;
+} | {
+    t: "event";
+    kind: "grounding-flag";
+    /** The unverified claim texts, e.g. ["67 tests", "app.tsx:836"]. */
+    claims: string[];
+    /** Total number of unverified claims in this turn. */
+    count: number;
+    ts: number;
 } | {
     t: "idle";
 };

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

@@ -0,0 +1,22 @@
+/**
+ * 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

@@ -0,0 +1,55 @@
+/**
+ * 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/agent-harness/index.js

@@ -1,4 +1,4 @@
-// Backwards-compat shim. Internal callers may still import from "./agent-harness".
+// Backwards-compat shim. Internal callers may still import from @muonroi/agent-harness.
 // Phase 2.3+ will convert these to direct imports from "@muonroi/agent-harness-opentui".
 //
 // External consumers must NOT import this shim — they must use the published

package/dist/src/agent-harness/mock-model.d.ts

@@ -121,6 +121,11 @@ export interface MockInstallOptions {
      * the OpenAI Codex backend injects `{store: false, instructions: ...}`).
      */
     defaultProviderOptions?: Record<string, unknown>;
+    /**
+     * Synthetic ModelInfo for non-catalog models. Set `reasoning: true` for
+     * reasoning models so `shouldDropParam("temperature")` works correctly.
+     */
+    modelInfo?: Record<string, unknown>;
 }
 export interface InstalledMockHandle extends MockModelHandle {
     /** Remove the mock from globalThis. Idempotent. */

package/dist/src/agent-harness/mock-model.js

@@ -187,33 +187,76 @@ function normalizeStreamChunks(chunks) {
     });
 }
 export async function loadMockModelFromDir(dir) {
-    const { readdirSync, readFileSync } = await import("node:fs");
+    // Diagnostic logging path. Without these messages, every failure mode
+    // (directory missing, no .json files, malformed JSON, no `model` block)
+    // returns `null` silently — and the caller in src/index.ts used to swallow
+    // it, leaving the orchestrator to fall back to the real provider with a
+    // fake API key. Result: dump file contains `[]`, cost-leak specs fail
+    // with "expected 0 to be greater than or equal to 3" with no clue why.
+    // (Evidence: harness CI run 26431994835.)
+    const log = (msg) => {
+        process.stderr.write(`[mock-model] ${msg}\n`);
+    };
+    const { readdirSync, readFileSync, existsSync } = await import("node:fs");
     const { join } = await import("node:path");
-    const files = readdirSync(dir).filter((f) => f.endsWith(".json"));
+    if (!existsSync(dir)) {
+        log(`loadMockModelFromDir: dir does not exist: ${dir}`);
+        return null;
+    }
+    let files;
+    try {
+        files = readdirSync(dir).filter((f) => f.endsWith(".json"));
+    }
+    catch (err) {
+        log(`loadMockModelFromDir: readdirSync(${dir}) failed: ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+    if (files.length === 0) {
+        log(`loadMockModelFromDir: no .json files in ${dir}`);
+        return null;
+    }
     for (const f of files) {
-        const raw = JSON.parse(readFileSync(join(dir, f), "utf8"));
-        if (raw.model !== undefined) {
-            // Wrap plain-string `error` payloads in Error instances before passing
-            // to createMockModel, so the AI SDK stream-loop and orchestrator see a
-            // consistent Error shape regardless of fixture serialization.
-            const normalized = {
-                ...raw.model,
-                stream: isNestedArray(raw.model.stream)
-                    ? raw.model.stream.map(normalizeStreamChunks)
-                    : normalizeStreamChunks(raw.model.stream),
-            };
-            const base = createMockModel(normalized);
-            return {
-                model: base.model,
-                get calls() {
-                    return base.calls;
-                },
-                reset: base.reset,
-                unsupportedParams: raw.model.unsupportedParams,
-                defaultProviderOptions: raw.model.defaultProviderOptions,
-            };
+        const full = join(dir, f);
+        let raw;
+        try {
+            raw = JSON.parse(readFileSync(full, "utf8"));
+        }
+        catch (err) {
+            log(`loadMockModelFromDir: JSON parse failed for ${full}: ${err instanceof Error ? err.message : String(err)}`);
+            continue;
+        }
+        if (raw.model === undefined) {
+            // Not fatal — caller iterates further. But log so the test author
+            // knows why their fixture was ignored.
+            log(`loadMockModelFromDir: ${full} has no "model" top-level key — skipping`);
+            continue;
+        }
+        if (raw.model.stream === undefined) {
+            log(`loadMockModelFromDir: ${full} has "model" but no "stream" — skipping`);
+            continue;
         }
+        // Wrap plain-string `error` payloads in Error instances before passing
+        // to createMockModel, so the AI SDK stream-loop and orchestrator see a
+        // consistent Error shape regardless of fixture serialization.
+        const normalized = {
+            ...raw.model,
+            stream: isNestedArray(raw.model.stream)
+                ? raw.model.stream.map(normalizeStreamChunks)
+                : normalizeStreamChunks(raw.model.stream),
+        };
+        const base = createMockModel(normalized);
+        log(`loadMockModelFromDir: installed mock from ${full} (provider=${raw.model.provider ?? "mock"}, modelId=${raw.model.modelId ?? "mock-model"})`);
+        return {
+            model: base.model,
+            get calls() {
+                return base.calls;
+            },
+            reset: base.reset,
+            unsupportedParams: raw.model.unsupportedParams,
+            defaultProviderOptions: raw.model.defaultProviderOptions,
+        };
     }
+    log(`loadMockModelFromDir: scanned ${files.length} file(s) in ${dir} but none declared a {model:...} block`);
     return null;
 }
 /**
@@ -272,6 +315,7 @@ export function installMockModel(opts) {
     g.__muonroiMockModel = handle.model;
     g.__muonroiMockUnsupportedParams = opts.unsupportedParams;
     g.__muonroiMockDefaultProviderOptions = opts.defaultProviderOptions;
+    g.__muonroiMockModelInfo = opts.modelInfo;
     return {
         ...handle,
         get calls() {
@@ -284,6 +328,7 @@ export function installMockModel(opts) {
                 delete cur.__muonroiMockModel;
                 delete cur.__muonroiMockUnsupportedParams;
                 delete cur.__muonroiMockDefaultProviderOptions;
+                delete cur.__muonroiMockModelInfo;
             }
         },
     };

package/dist/src/agent-harness/test-spawn.d.ts

@@ -28,7 +28,13 @@ export type SpawnResult = {
 type SpawnOptions = {
     /** Extra spawn options forwarded to child_process.spawn (env, etc.). */
     spawnOpts?: Omit<Parameters<typeof spawn>[2], "stdio">;
-    /** Handshake timeout on Windows. Default: 5000 ms. */
+    /**
+     * Handshake timeout on Windows. Default: 15000 ms. Override via
+     * MUONROI_HARNESS_HANDSHAKE_TIMEOUT env var (millis). The default was
+     * bumped from 5s to 15s because cold-start spawns under MCP server load
+     * routinely exceeded 5s and produced confusing `client did not connect`
+     * errors that surfaced as transient flakes in agent-driven E2E flows.
+     */
     handshakeTimeoutMs?: number;
 };
 /**

package/dist/src/agent-harness/test-spawn.js

@@ -56,7 +56,7 @@ async function waitForHandshake(socket, timeoutMs) {
             socket.off("data", onData);
             try {
                 const msg = JSON.parse(line);
-                if (msg["t"] === "handshake" && msg["ok"] === true) {
+                if (msg.t === "handshake" && msg.ok === true) {
                     resolve();
                 }
                 else {
@@ -75,8 +75,23 @@ async function waitForHandshake(socket, timeoutMs) {
         });
     });
 }
+function resolveHandshakeTimeoutMs(opts) {
+    if (typeof opts.handshakeTimeoutMs === "number" && opts.handshakeTimeoutMs > 0) {
+        return opts.handshakeTimeoutMs;
+    }
+    const envOverride = Number.parseInt(process.env["MUONROI_HARNESS_HANDSHAKE_TIMEOUT"] ?? "", 10);
+    if (Number.isFinite(envOverride) && envOverride > 0)
+        return envOverride;
+    // Bumped 5s → 15s → 90s. Cold child boot is a full `bun run src/index.ts`
+    // import of the whole CLI, which on heavy/resource-constrained hosts measures
+    // ~40s (smoke-boot) before the named pipe is even opened — and agent-mode boot
+    // under MCP-server load runs longer — so 15s surfaced as a confusing
+    // "client did not connect" on the first tui.start. 90s gives comfortable margin;
+    // override via MUONROI_HARNESS_HANDSHAKE_TIMEOUT for slower hosts/prebuilt runs.
+    return 90_000;
+}
 async function spawnWindows(args, opts) {
-    const timeoutMs = opts.handshakeTimeoutMs ?? 5_000;
+    const timeoutMs = resolveHandshakeTimeoutMs(opts);
     const inPipeName = makePipeName("in");
     const outPipeName = makePipeName("out");
     // Create both servers BEFORE spawning the child so the pipe names are
@@ -95,8 +110,8 @@ async function spawnWindows(args, opts) {
         outServer.listen(outPipeName, onListen);
     });
     const baseEnv = { ...(opts.spawnOpts?.env ?? process.env) };
-    baseEnv["MUONROI_HARNESS_IN_PIPE"] = inPipeName;
-    baseEnv["MUONROI_HARNESS_OUT_PIPE"] = outPipeName;
+    baseEnv.MUONROI_HARNESS_IN_PIPE = inPipeName;
+    baseEnv.MUONROI_HARNESS_OUT_PIPE = outPipeName;
     const mergedOpts = {
         ...opts.spawnOpts,
         env: baseEnv,

package/dist/src/chat/__tests__/broadcast-bus.test.js

@@ -26,7 +26,7 @@ describe("publish", () => {
         expect(client.postMessage).not.toHaveBeenCalled();
     });
     it("splits content over budget at newline boundary", async () => {
-        const long = "para1\n\n" + "x".repeat(DISCORD_CONTENT_BUDGET) + "\n\npara3";
+        const long = `para1\n\n${"x".repeat(DISCORD_CONTENT_BUDGET)}\n\npara3`;
         const client = makeClient({
             postMessage: vi
                 .fn()
@@ -37,7 +37,7 @@ describe("publish", () => {
         const out = await publish({ client, channelId: "c1", type: "phase-event", content: long });
         const calls = client.postMessage.mock.calls;
         expect(calls.length).toBeGreaterThanOrEqual(2);
-        expect(out?.messageId).toBe("m" + calls.length);
+        expect(out?.messageId).toBe(`m${calls.length}`);
         for (const [, msg] of calls) {
             expect(msg.length).toBeLessThanOrEqual(DISCORD_CONTENT_BUDGET + 30);
         }

package/dist/src/chat/__tests__/client.test.js

@@ -14,7 +14,7 @@ describe("DiscordChatProvider", () => {
         const fetch = mockFetch(async (url, init) => {
             expect(url).toBe("https://discord.com/api/v10/guilds/g1/channels");
             expect(init.method).toBe("POST");
-            expect(init.headers["Authorization"]).toBe("Bot tok");
+            expect(init.headers.Authorization).toBe("Bot tok");
             const body = JSON.parse(init.body);
             expect(body.name).toBe("muonroi-test");
             return jsonResponse({ id: "c1" });

package/dist/src/chat/broadcast-bus.js

@@ -21,9 +21,9 @@ function splitContent(content) {
     return parts.map((p, i) => {
         let s = p;
         if (i > 0)
-            s = "(continued) … " + s;
+            s = `(continued) … ${s}`;
         if (i < parts.length - 1)
-            s = s + " … (continued)";
+            s = `${s} … (continued)`;
         return s;
     });
 }