muonroi-cli 1.2.3 → 1.3.1

package/dist/src/ops/doctor.js

@@ -0,0 +1,333 @@
+/**
+ * src/ops/doctor.ts
+ *
+ * Health check runner for muonroi-cli doctor command.
+ * Runs 7 named checks and returns pass/warn/fail results.
+ *
+ * Checks: bun_version, os, key_presence, ollama, ee, qdrant, error_rate
+ * Never throws — all checks handle errors gracefully (warn, not crash).
+ */
+import { readFile } from "fs/promises";
+import os from "os";
+import path from "path";
+import { healthDetailed } from "../ee/health.js";
+import { listStoredProviders } from "../providers/keychain.js";
+import { getDatabase } from "../storage/db.js";
+import { loadMcpServers, loadUserSettings } from "../utils/settings.js";
+function icon(status) {
+    return status === "pass" ? "[PASS]" : status === "warn" ? "[WARN]" : "[FAIL]";
+}
+export function formatDoctorReport(results, version) {
+    const lines = [];
+    lines.push(`  muonroi-cli v${version || "unknown"}`);
+    lines.push("");
+    for (const r of results) {
+        lines.push(`  ${icon(r.status)} ${r.name}: ${r.detail}`);
+    }
+    const passCount = results.filter((r) => r.status === "pass").length;
+    const warnCount = results.filter((r) => r.status === "warn").length;
+    const failCount = results.filter((r) => r.status === "fail").length;
+    lines.push("");
+    lines.push(`  Summary: ${passCount} pass, ${warnCount} warn, ${failCount} fail`);
+    lines.push("");
+    lines.push("  For managed Experience Engine: https://muonroi.com/cloud");
+    return lines.join("\n");
+}
+async function checkBunVersion() {
+    const bunVersion = process.versions.bun;
+    if (!bunVersion) {
+        return { name: "bun_version", status: "fail", detail: "Not running under Bun" };
+    }
+    // Compare semver: need >= 1.3.13
+    const [major, minor, patch] = bunVersion.split(".").map(Number);
+    const ok = major > 1 || (major === 1 && (minor > 3 || (minor === 3 && patch >= 13)));
+    return {
+        name: "bun_version",
+        status: ok ? "pass" : "fail",
+        detail: `Bun ${bunVersion}${ok ? "" : " (need >= 1.3.13)"}`,
+    };
+}
+async function checkOS() {
+    return {
+        name: "os",
+        status: "pass",
+        detail: `${os.platform()} ${os.release()} ${os.arch()}`,
+    };
+}
+async function checkKeyPresence() {
+    const envKey = process.env.MUONROI_API_KEY;
+    if (envKey && envKey.length > 0) {
+        return {
+            name: "key_presence",
+            status: "pass",
+            detail: "MUONROI_API_KEY set via env var",
+        };
+    }
+    try {
+        const stored = await listStoredProviders();
+        if (stored.length > 0) {
+            return {
+                name: "key_presence",
+                status: "pass",
+                detail: `API key(s) in OS keychain: ${stored.join(", ")}`,
+            };
+        }
+    }
+    catch {
+        /* keytar unavailable — fall through */
+    }
+    try {
+        const settings = loadUserSettings();
+        if (settings.apiKey && settings.apiKey.length > 0) {
+            return {
+                name: "key_presence",
+                status: "warn",
+                detail: "API key in plaintext user-settings.json — run 'muonroi-cli keys cleanup-settings' to migrate to OS keychain",
+            };
+        }
+    }
+    catch {
+        /* settings file unreadable — fall through */
+    }
+    return {
+        name: "key_presence",
+        status: "fail",
+        detail: "No API key found (run 'muonroi-cli keys set <provider>' or set MUONROI_API_KEY)",
+    };
+}
+async function checkOllamaHealth() {
+    try {
+        const ollamaUrl = process.env.OLLAMA_URL ?? "http://localhost:11434";
+        const resp = await fetch(`${ollamaUrl.replace(/\/+$/, "")}/api/tags`, {
+            signal: AbortSignal.timeout(2000),
+        });
+        return {
+            name: "ollama",
+            status: resp.ok ? "pass" : "warn",
+            detail: resp.ok ? `Ollama reachable (${ollamaUrl})` : `Ollama responded ${resp.status}`,
+        };
+    }
+    catch {
+        return { name: "ollama", status: "warn", detail: "Ollama not running (optional — needed for warm-path routing)" };
+    }
+}
+async function checkEEDetailed() {
+    try {
+        const result = await healthDetailed();
+        const serverOk = result.components.server.ok;
+        const gatesOk = result.components.gates?.ok ?? true; // null if local mode
+        const isHealthy = result.ok;
+        const parts = [
+            `mode=${result.mode}`,
+            `circuit=${result.circuit}`,
+            `server=${serverOk ? "ok" : `fail(${result.components.server.status})`}`,
+        ];
+        if (result.components.gates !== null) {
+            parts.push(`gates=${gatesOk ? "ok" : `fail(${result.components.gates.status})`}`);
+        }
+        if (!isHealthy) {
+            const hint = result.mode === "thin-client"
+                ? "Hint: check VPS 72.61.127.154:8082 is reachable; verify ~/.experience/config.json serverBaseUrl + serverReadAuthToken"
+                : "Hint: start EE locally or configure thin-client in ~/.experience/config.json";
+            return {
+                name: "ee.health",
+                status: "warn",
+                detail: `EE unreachable — ${parts.join(", ")}. ${hint}`,
+            };
+        }
+        return {
+            name: "ee.health",
+            status: "pass",
+            detail: parts.join(", "),
+        };
+    }
+    catch (err) {
+        return {
+            name: "ee.health",
+            status: "warn",
+            detail: `EE health probe failed: ${err.message} — optional, CLI works without EE`,
+        };
+    }
+}
+// Threshold: >= 50 consecutive no_match events → brain likely needs bootstrapping
+const BRAIN_EMPTY_THRESHOLD = 50;
+async function checkBrainEmptiness() {
+    try {
+        const db = getDatabase();
+        // Count ee_injection events with event_subtype='no_match' in last 30 days
+        const cutoff = new Date(Date.now() - 30 * 86_400_000).toISOString();
+        const row = db
+            .prepare(`SELECT COUNT(*) as cnt FROM interaction_logs
+         WHERE event_type = 'ee_injection'
+           AND event_subtype = 'no_match'
+           AND created_at >= ?`)
+            .get(cutoff);
+        const noMatchCount = row?.cnt ?? 0;
+        if (noMatchCount >= BRAIN_EMPTY_THRESHOLD) {
+            return {
+                name: "ee.brain",
+                status: "warn",
+                detail: [
+                    `${noMatchCount} no_match injection events in 30d — brain may need bootstrapping.`,
+                    `Run 'experience extract' over recent sessions to seed the brain,`,
+                    `then 'experience evolve' to abstract principles.`,
+                    `Or lower MUONROI_PIL_SCORE_FLOOR below 0.55 if matches exist but are filtered as noise.`,
+                ].join(" "),
+            };
+        }
+        if (noMatchCount > 0) {
+            return {
+                name: "ee.brain",
+                status: "pass",
+                detail: `${noMatchCount} no_match events in 30d (within normal range)`,
+            };
+        }
+        return {
+            name: "ee.brain",
+            status: "pass",
+            detail: "No no_match injection events in 30d",
+        };
+    }
+    catch {
+        // fail-open: DB may not be initialized yet
+        return { name: "ee.brain", status: "pass", detail: "brain check skipped (DB unavailable)" };
+    }
+}
+async function checkQdrant() {
+    try {
+        const qdrantUrl = process.env.QDRANT_URL ?? "http://localhost:6333";
+        const resp = await fetch(`${qdrantUrl.replace(/\/+$/, "")}/healthz`, {
+            signal: AbortSignal.timeout(1000),
+        });
+        return {
+            name: "qdrant",
+            status: resp.ok ? "pass" : "warn",
+            detail: resp.ok ? `Qdrant healthy (${qdrantUrl})` : `Qdrant responded ${resp.status}`,
+        };
+    }
+    catch {
+        return { name: "qdrant", status: "warn", detail: "Qdrant not running locally (OK if EE is remote)" };
+    }
+}
+async function checkRecentErrorRate() {
+    const errorLogPath = path.join(os.homedir(), ".muonroi-cli", "errors.log");
+    try {
+        const content = await readFile(errorLogPath, "utf-8");
+        const lines = content.split("\n").filter(Boolean);
+        const oneDayAgo = Date.now() - 86400000;
+        // Count lines with ISO timestamps in last 24h (best-effort)
+        const recentCount = lines.filter((l) => {
+            const match = l.match(/^(\d{4}-\d{2}-\d{2}T[\d:.]+Z?)/);
+            return match && new Date(match[1]).getTime() > oneDayAgo;
+        }).length;
+        if (recentCount > 50) {
+            return { name: "error_rate", status: "fail", detail: `${recentCount} errors in last 24h` };
+        }
+        if (recentCount > 10) {
+            return { name: "error_rate", status: "warn", detail: `${recentCount} errors in last 24h` };
+        }
+        return { name: "error_rate", status: "pass", detail: `${recentCount} errors in last 24h` };
+    }
+    catch {
+        return { name: "error_rate", status: "pass", detail: "No error log found (clean)" };
+    }
+}
+// CQ-23: threshold for qualifying council sessions to trigger MCP nudge
+const COUNCIL_MCP_NUDGE_THRESHOLD = 3;
+const RESEARCH_KEYWORDS = /research|find\s|look\s*up|search\s|investigate|what\s+is\s|latest|current\s+version|news\s|documentation|compare\s/i;
+async function checkCouncilMcpNudge() {
+    try {
+        // 1. Check if tavily or playwright is enabled in MCP config
+        const mcpServers = loadMcpServers();
+        // McpServerConfig has: id, label, enabled, transport, command?, ...
+        // Match tavily/playwright by id or label (case-insensitive)
+        const serverNames = mcpServers.map((s) => `${s.id ?? ""} ${s.label ?? ""} ${s.command ?? ""}`.toLowerCase());
+        const tavilyEnabled = serverNames.some((n) => n.includes("tavily"));
+        const playwrightEnabled = serverNames.some((n) => n.includes("playwright") || n.includes("chrome"));
+        if (tavilyEnabled && playwrightEnabled) {
+            return { name: "council.mcp", status: "pass", detail: "tavily + playwright enabled" };
+        }
+        if (tavilyEnabled || playwrightEnabled) {
+            const enabled = tavilyEnabled ? "tavily" : "playwright";
+            return {
+                name: "council.mcp",
+                status: "pass",
+                detail: `${enabled} enabled (partial MCP coverage)`,
+            };
+        }
+        // 2. Query DB for [Council Memory] records with URL or research topics
+        const db = getDatabase();
+        const rows = db
+            .prepare(`SELECT message_json FROM messages
+         WHERE role = 'system'
+           AND message_json LIKE '%[Council Memory]%'
+         ORDER BY created_at DESC
+         LIMIT 50`)
+            .all();
+        let qualifyingCount = 0;
+        for (const row of rows) {
+            try {
+                const content = (() => {
+                    try {
+                        const parsed = JSON.parse(row.message_json);
+                        return typeof parsed.content === "string" ? parsed.content : row.message_json;
+                    }
+                    catch {
+                        return row.message_json;
+                    }
+                })();
+                if (!content.startsWith("[Council Memory] "))
+                    continue;
+                const record = JSON.parse(content.slice("[Council Memory] ".length));
+                const topic = record.topic ?? "";
+                if (/https?:\/\//.test(topic) || RESEARCH_KEYWORDS.test(topic)) {
+                    qualifyingCount++;
+                }
+            }
+            catch {
+                /* skip malformed rows */
+            }
+        }
+        if (qualifyingCount >= COUNCIL_MCP_NUDGE_THRESHOLD) {
+            const missing = [!tavilyEnabled && "tavily", !playwrightEnabled && "playwright"].filter(Boolean).join(", ");
+            return {
+                name: "council.mcp",
+                status: "warn",
+                detail: [
+                    `${qualifyingCount} council session(s) ran URL/research topics without MCP enabled.`,
+                    `Missing: ${missing}.`,
+                    `Enable these in ~/.muonroi-cli/user-settings.json under "mcpServers"`,
+                    `to allow tavily internet search and playwright browser access during debates.`,
+                ].join(" "),
+            };
+        }
+        return {
+            name: "council.mcp",
+            status: "pass",
+            detail: qualifyingCount === 0
+                ? "No URL/research council sessions detected"
+                : `${qualifyingCount} URL/research session(s) (threshold ${COUNCIL_MCP_NUDGE_THRESHOLD} not reached)`,
+        };
+    }
+    catch {
+        return {
+            name: "council.mcp",
+            status: "pass",
+            detail: "council mcp check skipped (DB unavailable)",
+        };
+    }
+}
+export async function runDoctor() {
+    return Promise.all([
+        checkBunVersion(),
+        checkOS(),
+        checkKeyPresence(),
+        checkOllamaHealth(),
+        checkEEDetailed(), // replaces checkEE() — CQ-16c
+        checkBrainEmptiness(), // NEW — CQ-16d
+        checkQdrant(),
+        checkRecentErrorRate(),
+        checkCouncilMcpNudge(), // NEW — CQ-23
+    ]);
+}
+//# sourceMappingURL=doctor.js.map

package/dist/src/ops/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../../src/ops/doctor.ts"],"names":[],"mappings":"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"}

package/dist/src/ops/doctor.test.js

@@ -0,0 +1,96 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+// RED phase: import module under test (will fail until doctor.ts is created)
+import { formatDoctorReport, runDoctor } from "./doctor.js";
+describe("doctor — runDoctor returns 9 checks", () => {
+    beforeEach(() => {
+        // Mock fetch to avoid real network calls in tests
+        vi.stubGlobal("fetch", vi.fn().mockResolvedValue({ ok: false, status: 503 }));
+    });
+    afterEach(() => {
+        vi.unstubAllGlobals();
+        vi.restoreAllMocks();
+    });
+    it("returns exactly 9 CheckResult entries (council_mcp_nudge added in CQ-23)", async () => {
+        const results = await runDoctor();
+        expect(results).toHaveLength(9);
+    });
+    it("each CheckResult has valid name, status, and detail fields", async () => {
+        const results = await runDoctor();
+        const validStatuses = ["pass", "warn", "fail"];
+        for (const r of results) {
+            expect(typeof r.name).toBe("string");
+            expect(r.name.length).toBeGreaterThan(0);
+            expect(validStatuses).toContain(r.status);
+            expect(typeof r.detail).toBe("string");
+            expect(r.detail.length).toBeGreaterThan(0);
+        }
+    });
+    it("includes expected check names", async () => {
+        const results = await runDoctor();
+        const names = results.map((r) => r.name);
+        expect(names).toContain("bun_version");
+        expect(names).toContain("os");
+        expect(names).toContain("key_presence");
+        expect(names).toContain("ollama");
+        expect(names).toContain("ee.health");
+        expect(names).toContain("ee.brain");
+        expect(names).toContain("qdrant");
+        expect(names).toContain("error_rate");
+    });
+    it("unreachable services return warn (not fail or throw)", async () => {
+        vi.stubGlobal("fetch", vi.fn().mockRejectedValue(new Error("Network unreachable")));
+        const results = await runDoctor();
+        const ollamaCheck = results.find((r) => r.name === "ollama");
+        const eeCheck = results.find((r) => r.name === "ee.health");
+        const qdrantCheck = results.find((r) => r.name === "qdrant");
+        expect(ollamaCheck.status).toBe("warn");
+        expect(eeCheck.status).toBe("warn");
+        expect(qdrantCheck.status).toBe("warn");
+    });
+});
+describe("doctor — bun_version check", () => {
+    afterEach(() => {
+        vi.unstubAllGlobals();
+        vi.restoreAllMocks();
+    });
+    it("returns pass when bun version >= 1.3.13", async () => {
+        vi.stubGlobal("fetch", vi.fn().mockResolvedValue({ ok: false, status: 503 }));
+        // In test environment: process.versions.bun may or may not be set
+        // We just verify bun_version is one of the valid statuses
+        const results = await runDoctor();
+        const bunCheck = results.find((r) => r.name === "bun_version");
+        expect(["pass", "fail", "warn"]).toContain(bunCheck.status);
+        expect(bunCheck.detail).toMatch(/Bun|Not running/);
+    });
+});
+describe("doctor — formatDoctorReport", () => {
+    it("contains [PASS] icon for passing check", () => {
+        const results = [{ name: "os", status: "pass", detail: "linux 5.15" }];
+        const report = formatDoctorReport(results);
+        expect(report).toContain("[PASS]");
+        expect(report).toContain("os");
+    });
+    it("contains [WARN] icon for warn check", () => {
+        const results = [{ name: "ollama", status: "warn", detail: "Ollama VPS unreachable" }];
+        const report = formatDoctorReport(results);
+        expect(report).toContain("[WARN]");
+    });
+    it("contains [FAIL] icon for fail check", () => {
+        const results = [{ name: "bun_version", status: "fail", detail: "Not running under Bun" }];
+        const report = formatDoctorReport(results);
+        expect(report).toContain("[FAIL]");
+    });
+    it("includes summary line with counts", () => {
+        const results = [
+            { name: "os", status: "pass", detail: "linux" },
+            { name: "ollama", status: "warn", detail: "unreachable" },
+            { name: "bun_version", status: "fail", detail: "missing" },
+        ];
+        const report = formatDoctorReport(results);
+        expect(report).toContain("Summary:");
+        expect(report).toContain("1 pass");
+        expect(report).toContain("1 warn");
+        expect(report).toContain("1 fail");
+    });
+});
+//# sourceMappingURL=doctor.test.js.map

package/dist/src/ops/doctor.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.test.js","sourceRoot":"","sources":["../../../src/ops/doctor.test.ts"],"names":[],"mappings":"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"}

package/dist/src/orchestrator/__tests__/batch-turn-runner.test.js

@@ -0,0 +1,154 @@
+// Phase 12.5-03 — BatchTurnRunner unit tests.
+//
+// Focused smoke: confirms the DI surface (BatchTurnRunnerDeps) is wired
+// correctly and that the abort + retry invariants hold without exercising
+// the (stub) batch API. The Phase 0 batch stubs throw, so every successful
+// path through `run()` here goes via the catch-block — that's exactly what
+// we want to assert (transient retry + abort + recordUsage guard).
+import { describe, expect, it } from "vitest";
+import { BatchTurnRunner } from "../batch-turn-runner.js";
+function makeBashStub() {
+    return {
+        getCwd: () => process.cwd(),
+        getSandboxMode: () => "off",
+        getSandboxSettings: () => ({}),
+    };
+}
+function makeDeps(overrides = {}) {
+    const messages = [];
+    let compactedThisTurn = false;
+    const counters = {
+        appendCompletedTurn: 0,
+        discardAbortedTurn: 0,
+        recordUsage: 0,
+        compactedFlags: [],
+    };
+    const deps = {
+        messages,
+        bash: makeBashStub(),
+        mode: "agent",
+        maxToolRounds: 50,
+        maxTokens: 16_384,
+        schedules: {},
+        sendTelegramFile: null,
+        getSessionId: () => null,
+        getCompactedThisTurn: () => compactedThisTurn,
+        setCompactedThisTurn: (v) => {
+            compactedThisTurn = v;
+            counters.compactedFlags.push(v);
+        },
+        setLastProviderOptionsShape: () => { },
+        getBatchClientOptions: () => ({ apiKey: "test-key" }),
+        getCompactionSettings: (_cw) => ({
+            thresholdPct: 0.85,
+            keepRecentTokens: 4096,
+            reserveTokens: 16_384,
+        }),
+        compactForContext: async () => true,
+        postTurnCompact: async () => { },
+        createTools: () => ({}),
+        runTask: async () => ({ success: true, output: "" }),
+        runDelegation: async () => ({ success: true, output: "" }),
+        readDelegation: async () => ({ success: true, output: "" }),
+        listDelegations: async () => ({ success: true, output: "" }),
+        executeBatchToolCall: async (_tools, _call) => ({
+            input: {},
+            result: { success: true, output: "" },
+        }),
+        appendCompletedTurn: () => {
+            counters.appendCompletedTurn++;
+        },
+        discardAbortedTurn: () => {
+            counters.discardAbortedTurn++;
+        },
+        recordUsage: () => {
+            counters.recordUsage++;
+        },
+        ...overrides,
+    };
+    return { deps, counters };
+}
+function makeArgs(signal, providerStub) {
+    return {
+        userModelMessage: { role: "user", content: "hello" },
+        observer: undefined,
+        provider: (providerStub ?? {}),
+        subagents: [],
+        system: "",
+        runtime: {
+            modelId: "deepseek-ai/DeepSeek-V4-Flash",
+            modelInfo: { provider: "siliconflow", contextWindow: 131_072 },
+            model: {},
+            providerOptions: {},
+            unsupportedParams: [],
+        },
+        modelInfo: { contextWindow: 131_072 },
+        signal,
+    };
+}
+async function drain(gen) {
+    const out = [];
+    for await (const chunk of gen)
+        out.push(chunk);
+    return out;
+}
+describe("BatchTurnRunner DI invariants (12.5-03)", () => {
+    it("constructs with deps and exposes run()", () => {
+        const { deps } = makeDeps();
+        const runner = new BatchTurnRunner(deps);
+        expect(typeof runner.run).toBe("function");
+    });
+    it("yields [Cancelled] when signal is already aborted and calls discardAbortedTurn", async () => {
+        // Force compactForContext to throw a non-transient error fast so the
+        // catch-block runs without hitting the retry exponential-backoff sleep.
+        const { deps, counters } = makeDeps({
+            compactForContext: async () => {
+                throw new Error("synthetic compact failure (non-transient)");
+            },
+        });
+        const runner = new BatchTurnRunner(deps);
+        const ctrl = new AbortController();
+        ctrl.abort();
+        const chunks = await drain(runner.run(makeArgs(ctrl.signal)));
+        // catch sees signal.aborted → emits "[Cancelled]" and discards the turn.
+        expect(chunks.some((c) => c.content === "\n\n[Cancelled]")).toBe(true);
+        expect(counters.discardAbortedTurn).toBe(1);
+        expect(counters.appendCompletedTurn).toBe(0);
+    });
+    it("flips compactedThisTurn to false at the top of every turn", async () => {
+        const { deps, counters } = makeDeps({
+            compactForContext: async () => {
+                throw new Error("synthetic non-transient");
+            },
+        });
+        const runner = new BatchTurnRunner(deps);
+        const ctrl = new AbortController();
+        ctrl.abort(); // skip retry sleep
+        await drain(runner.run(makeArgs(ctrl.signal)));
+        expect(counters.compactedFlags[0]).toBe(false);
+    });
+    it("does NOT call recordUsage when totalUsage is empty (hasUsage guard)", async () => {
+        const { deps, counters } = makeDeps({
+            compactForContext: async () => {
+                throw new Error("synthetic non-transient");
+            },
+        });
+        const runner = new BatchTurnRunner(deps);
+        const ctrl = new AbortController();
+        // Pre-abort so we hit the catch's `signal.aborted` early-return: that
+        // path discards the turn (no appendCompletedTurn and no recordUsage).
+        ctrl.abort();
+        await drain(runner.run(makeArgs(ctrl.signal)));
+        expect(counters.recordUsage).toBe(0);
+        expect(counters.appendCompletedTurn).toBe(0);
+        expect(counters.discardAbortedTurn).toBe(1);
+    });
+    it("propagates messages array reference (deps.messages mutation visible)", () => {
+        const { deps } = makeDeps();
+        const newMsg = { role: "assistant", content: "test" };
+        deps.messages.push(newMsg);
+        expect(deps.messages.length).toBe(1);
+        expect(deps.messages[0]).toBe(newMsg);
+    });
+});
+//# sourceMappingURL=batch-turn-runner.test.js.map

package/dist/src/orchestrator/__tests__/batch-turn-runner.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-turn-runner.test.js","sourceRoot":"","sources":["../../../../src/orchestrator/__tests__/batch-turn-runner.test.ts"],"names":[],"mappings":"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"}