muonroi-cli 1.4.0 → 1.5.0

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

@@ -7,10 +7,10 @@ declare const FieldOp: z.ZodObject<{
         state: "state";
     }>;
     op: z.ZodEnum<{
-        regex: "regex";
         eq: "eq";
         neq: "neq";
         contains: "contains";
+        regex: "regex";
     }>;
     rhs: z.ZodString;
 }, z.core.$strip>;

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

@@ -5,7 +5,7 @@
 import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
-import { stepCountIs, streamText, tool } from "ai";
+import { generateObject, stepCountIs, streamText, tool } from "ai";
 import { afterAll, describe, expect, it } from "vitest";
 import { z } from "zod";
 import { createMockModel, loadMockModelFromDir, textOnlyStream, toolCallStream } from "../mock-model.js";
@@ -84,6 +84,37 @@ describe("createMockModel", () => {
         await drainStream(r2);
         expect(handle.calls.length).toBe(1);
     });
+    it("doGenerate backs generateObject with the configured JSON (council debate-planner path)", async () => {
+        const handle = createMockModel({
+            stream: textOnlyStream("unused"),
+            generate: JSON.stringify({ name: "counter", count: 3 }),
+        });
+        const { object } = await generateObject({
+            model: handle.model,
+            schema: z.object({ name: z.string(), count: z.number() }),
+            prompt: "plan the build",
+        });
+        expect(object).toEqual({ name: "counter", count: 3 });
+    });
+    it("doGenerate sequences across calls and repeats the last entry when exhausted", async () => {
+        const handle = createMockModel({
+            stream: textOnlyStream("unused"),
+            generate: [JSON.stringify({ n: 1 }), JSON.stringify({ n: 2 })],
+        });
+        const schema = z.object({ n: z.number() });
+        const a = await generateObject({ model: handle.model, schema, prompt: "1" });
+        const b = await generateObject({ model: handle.model, schema, prompt: "2" });
+        const c = await generateObject({ model: handle.model, schema, prompt: "3" });
+        expect(a.object.n).toBe(1);
+        expect(b.object.n).toBe(2);
+        expect(c.object.n).toBe(2); // exhausted → last entry repeats
+    });
+    it("doGenerate defaults to {} when no generate fixture is supplied (caller retry/fallback runs)", async () => {
+        const handle = createMockModel({ stream: textOnlyStream("unused") });
+        // An empty object fails a required-field schema → generateObject rejects,
+        // which is exactly what lets debate-planner fall through to its retry path.
+        await expect(generateObject({ model: handle.model, schema: z.object({ required: z.string() }), prompt: "x" })).rejects.toBeTruthy();
+    });
     it("textOnlyStream emits a well-formed finish chunk", () => {
         const chunks = textOnlyStream("hi");
         const finish = chunks.find((c) => c.type === "finish");
@@ -141,6 +172,22 @@ describe("loadMockModelFromDir", () => {
         expect(handle).not.toBeNull();
         expect(handle?.defaultProviderOptions).toEqual({ openai: { store: false } });
     });
+    it("propagates generate (doGenerate JSON) from the fixture file for generateObject", async () => {
+        const dir = mkFixtureDir({
+            provider: "mock",
+            modelId: "mock-gpt",
+            stream: textOnlyStream("unused"),
+            generate: JSON.stringify({ ok: true, label: "built" }),
+        });
+        const handle = await loadMockModelFromDir(dir);
+        expect(handle).not.toBeNull();
+        const { object } = await generateObject({
+            model: handle.model,
+            schema: z.object({ ok: z.boolean(), label: z.string() }),
+            prompt: "go",
+        });
+        expect(object).toEqual({ ok: true, label: "built" });
+    });
     it("supports multi-round stream arrays from the fixture file", async () => {
         const dir = mkFixtureDir({
             provider: "mock",

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

@@ -33,6 +33,17 @@ export interface MockModelFixture {
      *   entry repeats (so multi-round loops don't crash if the fixture is short).
      */
     stream: StreamChunks | StreamChunks[];
+    /**
+     * JSON text returned per `doGenerate` call — the path `generateObject` uses
+     * (council `debate-planner` plans the debate via `generateObject`, research
+     * classifiers via `generateText`, etc.). Without this the mock's `doGenerate`
+     * returns `"{}"`, which `generateObject` schema-validates → throws → the
+     * caller's retry/fallback path runs. Supply the exact object JSON to exercise
+     * the happy path.
+     * - Single string → same JSON on every call.
+     * - Array → one entry consumed per call; last entry repeats when exhausted.
+     */
+    generate?: string | string[];
     /** Reported provider id. Default "mock". */
     provider?: string;
     /** Reported model id. Default "mock-model". */

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

@@ -38,7 +38,9 @@ function isNestedArray(v) {
  */
 export function createMockModel(fx) {
     const streams = isNestedArray(fx.stream) ? fx.stream : [fx.stream];
+    const generates = fx.generate === undefined ? [] : Array.isArray(fx.generate) ? fx.generate : [fx.generate];
     let callIdx = 0;
+    let genIdx = 0;
     const provider = fx.provider ?? "mock";
     const modelId = fx.modelId ?? "mock-model";
     const model = new MockLanguageModelV3({
@@ -60,6 +62,24 @@ export function createMockModel(fx) {
                 }),
             };
         },
+        // doGenerate backs `generateObject` / non-streaming `generateText`. The AI
+        // SDK reads the first text content part as the object JSON (generateObject)
+        // or the completion text (generateText). Default "{}" keeps the mock from
+        // throwing "Not implemented" — generateObject then schema-rejects it and the
+        // caller's retry/fallback runs. Supply `generate` to drive the happy path.
+        doGenerate: async () => {
+            const text = generates.length > 0 ? generates[Math.min(genIdx, generates.length - 1)] : "{}";
+            genIdx += 1;
+            if (process.env.MUONROI_DEBUG_MOCK_MODEL === "1") {
+                process.stderr.write(`[mock-model] doGenerate #${genIdx} → ${text.length} chars\n`);
+            }
+            return {
+                content: [{ type: "text", text }],
+                finishReason: { unified: "stop", raw: undefined },
+                usage: buildUsage(10, text.length),
+                warnings: [],
+            };
+        },
     });
     return {
         model,
@@ -69,6 +89,7 @@ export function createMockModel(fx) {
         reset() {
             model.doStreamCalls.length = 0;
             callIdx = 0;
+            genIdx = 0;
         },
     };
 }

package/dist/src/cli/cost-forensics.js

@@ -42,21 +42,21 @@ export function collectCostForensics(sessionId) {
     if (!session)
         throw new Error(`Session not found: ${sessionId}`);
     const rows = db
-        .prepare(`
-    SELECT id, source, model, message_seq, input_tokens, output_tokens,
-           cache_read_tokens, cache_creation_tokens, cost_micros, created_at,
-           provider_options_shape
-    FROM usage_events
-    WHERE session_id = ?
-    ORDER BY id ASC
+        .prepare(`
+    SELECT id, source, model, message_seq, input_tokens, output_tokens,
+           cache_read_tokens, cache_creation_tokens, cost_micros, created_at,
+           provider_options_shape
+    FROM usage_events
+    WHERE session_id = ?
+    ORDER BY id ASC
   `)
         .all(sessionId);
     const counts = db
-        .prepare(`
-    SELECT event_type, COUNT(*) AS c
-    FROM interaction_logs
-    WHERE session_id = ?
-    GROUP BY event_type
+        .prepare(`
+    SELECT event_type, COUNT(*) AS c
+    FROM interaction_logs
+    WHERE session_id = ?
+    GROUP BY event_type
   `)
         .all(sessionId);
     const countMap = new Map(counts.map((r) => [r.event_type, r.c]));

package/dist/src/council/__tests__/clarification-prompt.test.js

@@ -0,0 +1,51 @@
+import { describe, expect, it } from "vitest";
+import { buildClarificationPrompt, buildReadinessJudgePrompt } from "../prompts.js";
+// Guards the de-robotized askcard contract (2026-06-14). The council clarifier
+// used to (a) force "AT LEAST 2 questions" → rambling/over-asking, (b) tell the
+// model to OMIT a recommendation unless certain → unranked option lists, and
+// (c) carry no existing-repo grounding → generic greenfield questions on a
+// brownfield repo. These assertions lock in the fixed behaviour so a future
+// edit can't silently regress it.
+describe("buildClarificationPrompt — de-robotized askcard", () => {
+    const { system } = buildClarificationPrompt("Add a retry to the EE bridge call", "## Current Project\nmuonroi-cli — TypeScript CLI. Stack: bun, vitest.\n");
+    it("does NOT force a minimum question quota", () => {
+        expect(system).not.toMatch(/AT LEAST 2 questions/i);
+        expect(system).not.toMatch(/MUST ask AT LEAST/i);
+        expect(system).not.toMatch(/Minimum-question rule/i);
+    });
+    it("explicitly allows zero questions / returning []", () => {
+        expect(system).toMatch(/return \[\]/i);
+        expect(system).toMatch(/ZERO questions/i);
+    });
+    it("makes a recommendation MANDATORY (decisive), not optional", () => {
+        expect(system).toMatch(/ALWAYS include "recommended"/);
+        // The old "OMIT the field entirely" default must be gone.
+        expect(system).not.toMatch(/OMIT the field entirely/i);
+        expect(system).toMatch(/never face an unranked list/i);
+    });
+    it("grounds questions in the existing repo, not greenfield", () => {
+        expect(system).toMatch(/Current Project/);
+        expect(system).toMatch(/EXISTING repository/);
+        expect(system).toMatch(/do NOT ask generic greenfield/i);
+    });
+    it("still emits the structured JSON contract (question/suggestions/recommended)", () => {
+        expect(system).toMatch(/"suggestions"/);
+        expect(system).toMatch(/"recommended"/);
+        expect(system).toMatch(/Output ONLY a JSON array/);
+    });
+});
+describe("buildReadinessJudgePrompt — no JS string-concat leak", () => {
+    const { system } = buildReadinessJudgePrompt("Optimize queries", [], {
+        problemStatement: "p",
+        constraints: [],
+        successCriteria: ["c"],
+        scope: "s",
+    });
+    it("does not leak JS concatenation syntax into the prompt text", () => {
+        // Was: `...means "probably " +\n  "ready but some ambiguity remains"` — the
+        // `" +` and the leading `  "` leaked verbatim into the model-facing string.
+        expect(system).not.toContain('" +');
+        expect(system).toContain("probably ready but some ambiguity remains");
+    });
+});
+//# sourceMappingURL=clarification-prompt.test.js.map

package/dist/src/council/__tests__/clarifier-ready-gate.test.js

@@ -151,6 +151,38 @@ describe("P5 ready-gate: Test C — hard cap at MAX_CLARIFY_ROUNDS", () => {
     });
 });
 // ---------------------------------------------------------------------------
+// Test E: clarifier asks ZERO questions → spec.ready=true, judge NOT called
+// (de-robotized prompt now commonly returns [] — the gate must reflect that,
+//  not stay at its not-ready default, and must not pay for a judge LLM call.)
+// ---------------------------------------------------------------------------
+describe("P5 ready-gate: Test E — zero questions ⇒ ready without a judge call", () => {
+    it("marks spec.ready=true and skips the readiness judge when the clarifier asks nothing", async () => {
+        let callCount = 0;
+        const generate = vi.fn().mockImplementation(async () => {
+            callCount++;
+            if (callCount === 1)
+                return "[]"; // clarify round 0: nothing to ask
+            // spec synthesis (if reached) — no judge call should occur on this path
+            return JSON.stringify({
+                problemStatement: "Add a retry to the EE bridge",
+                constraints: [],
+                successCriteria: ["Retries once on transient failure"],
+                scope: "EE bridge only",
+            });
+        });
+        const mockLLM = { generate };
+        const gen = runClarification("Add a retry to the EE bridge", "leader-model", "## Current Project\nTypeScript CLI", alwaysAnswer, mockLLM);
+        const spec = await _drain(gen);
+        expect(spec.ready).toBe(true);
+        expect(spec.confidenceScore).toBe(1);
+        expect(spec.remainingGaps).toEqual([]);
+        expect(spec.clarifyHistory).toEqual([]);
+        // The readiness judge ("debate facilitator" system prompt) must NOT fire.
+        const judgeCalled = generate.mock.calls.some(([, system]) => typeof system === "string" && system.includes("debate facilitator"));
+        expect(judgeCalled).toBe(false);
+    });
+});
+// ---------------------------------------------------------------------------
 // Test D: judgeReadiness unit tests
 // ---------------------------------------------------------------------------
 describe("P5 ready-gate: Test D — judgeReadiness unit", () => {

package/dist/src/council/__tests__/decisions-lock.test.js

@@ -7,7 +7,7 @@ import * as fs from "node:fs";
 import * as os from "node:os";
 import * as path from "node:path";
 import { afterEach, beforeEach, describe, expect, it } from "vitest";
-import { buildStackLockSection, detectOutOfStackProposals, prependDecisionsLock, readDecisionsLock, renderDecisionsLock, writeDecisionsLock, } from "../decisions-lock.js";
+import { buildStackLockSection, detectOutOfStackProposals, extractStackFromSpec, prependDecisionsLock, readDecisionsLock, renderDecisionsLock, writeDecisionsLock, } from "../decisions-lock.js";
 import { buildFollowupPrompt, buildLeaderEvaluationPrompt, buildOpeningPrompt, buildResponsePrompt, } from "../prompts.js";
 // ── Fixtures ──────────────────────────────────────────────────────────────────
 function makeSpec(overrides = {}) {
@@ -72,6 +72,22 @@ describe("C1: buildStackLockSection", () => {
         expect(section).toBe("");
     });
 });
+// ── extractStackFromSpec: mediatr keyword (Cyrillic-char regression) ──────────
+describe("extractStackFromSpec — mediatr keyword", () => {
+    it("detects the BB/.NET backend from a 'MediatR' mention alone", () => {
+        // Pre-fix the keyword used a Cyrillic 'р' (U+0440), so ASCII "mediatr" could
+        // never match. A spec mentioning ONLY MediatR (no BaseTemplate / building-block)
+        // must still resolve the backend.
+        const spec = makeSpec({ problemStatement: "Wire up CQRS handlers with MediatR", constraints: [], scope: "" });
+        const stack = extractStackFromSpec(spec);
+        expect(stack).not.toBeNull();
+        expect(stack?.backend ?? "").toContain("MediatR");
+    });
+    it("returns null when no BB/.NET/Muonroi keyword is present", () => {
+        const spec = makeSpec({ problemStatement: "Build a plain Express API", constraints: [], scope: "" });
+        expect(extractStackFromSpec(spec)).toBeNull();
+    });
+});
 // ── C1: STACK LOCK injected into debate system prompts ────────────────────────
 describe("C1: STACK LOCK injected into debate system prompts", () => {
     const bbSpec = makeSpecWithBBStack();

package/dist/src/council/__tests__/oauth-reachable.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/council/__tests__/oauth-reachable.test.js

@@ -0,0 +1,31 @@
+import { beforeAll, describe, expect, it, vi } from "vitest";
+// F15 regression: council participant resolution must treat OAuth-authed
+// providers (no API key) as reachable. getConfiguredProviders() is the
+// authoritative cred check; the old loadKeyForProvider-only path threw for
+// OAuth-only providers → 0 participants → council bailed "No reachable
+// provider" even though the model (e.g. grok via xAI OAuth) answers fine.
+// xai is configured via OAuth only (present in getConfiguredProviders, but
+// loadKeyForProvider would have thrown — no API key).
+vi.mock("../../providers/keychain.js", () => ({
+    getConfiguredProviders: vi.fn(async () => ["xai"]),
+}));
+// Hermetic settings: no explicit role models, nothing disabled.
+vi.mock("../../utils/settings.js", () => ({
+    getRoleModels: () => ({}),
+    getRoleModel: () => undefined,
+    isProviderDisabled: () => false,
+}));
+import { loadCatalog } from "../../models/registry.js";
+import { resolveParticipants } from "../leader.js";
+describe("F15 — council reachability counts OAuth-only providers", () => {
+    beforeAll(async () => {
+        await loadCatalog();
+    });
+    it("resolves >=2 participants when the session provider is OAuth-only (xai, no API key)", async () => {
+        const participants = await resolveParticipants("grok-build-0.1", false);
+        // Pre-fix this returned [] (loadKeyForProvider('xai') threw) → council bailed.
+        expect(participants.length).toBeGreaterThanOrEqual(2);
+        expect(participants.every((p) => p.model.startsWith("grok"))).toBe(true);
+    });
+});
+//# sourceMappingURL=oauth-reachable.test.js.map

package/dist/src/council/__tests__/parse-outcome-fallback.test.js

@@ -99,5 +99,16 @@ describe("parseOutcome — raw log + shape-based fallback (CQ-20)", () => {
         expect(result?.outcome?.summary).toBe("We should go with option A because it is simpler.");
         expect(errorSpy).not.toHaveBeenCalled();
     });
+    it("Test 6: shape fallback EXTRACTS section content from markdown headings (regex regression)", async () => {
+        // Pre-fix the heading regex used a literal "s+" instead of "\\s+" (and
+        // replaced spaces with "s+"), so it never matched a real "## Heading" line —
+        // every section came back empty even when the synthesis clearly contained them.
+        const md = "Here is the evaluation summary line that is plenty long enough.\n\n" +
+            "## Strengths\n- Fast startup\n- Low cost\n\n" +
+            "## Summary\nThe approach is solid overall.";
+        const result = await runPlanningWith(md, sampleDebatePlan);
+        expect(result?.outcome?.sections?.strengths).toEqual(["- Fast startup", "- Low cost"]);
+        expect(result?.outcome?.sections?.summary_text).toContain("The approach is solid overall.");
+    });
 });
 //# sourceMappingURL=parse-outcome-fallback.test.js.map