muonroi-cli 1.2.0

package/dist/ops/bug-report.test.js

@@ -0,0 +1,148 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+// RED phase: import module under test (will fail until bug-report.ts is created)
+import { buildBugReport, formatBugReport } from "./bug-report.js";
+// Mock fs/promises for controlled test environment
+// bug-report.ts uses named import { readFile } from "fs/promises"
+vi.mock("fs/promises", () => {
+    const actual = require("fs/promises");
+    return {
+        ...actual,
+        readFile: vi.fn(),
+    };
+});
+// Mock runDoctor to avoid real network calls
+vi.mock("./doctor.js", () => ({
+    runDoctor: vi.fn().mockResolvedValue([
+        { name: "bun_version", status: "pass", detail: "Bun 1.3.13" },
+        { name: "os", status: "pass", detail: "linux 5.15" },
+        { name: "key_presence", status: "pass", detail: "API key in env" },
+        { name: "ollama", status: "warn", detail: "Ollama unreachable" },
+        { name: "ee", status: "warn", detail: "EE unreachable" },
+        { name: "qdrant", status: "warn", detail: "Qdrant unreachable" },
+        { name: "error_rate", status: "pass", detail: "0 errors in last 24h" },
+    ]),
+}));
+// Mock EE health to avoid real network calls
+vi.mock("../ee/health.js", () => ({
+    health: vi.fn().mockResolvedValue({ ok: false, status: 503 }),
+}));
+/** Helper to get the mocked readFile from the vi.mock above */
+async function getMockedReadFile() {
+    const mod = await import("fs/promises");
+    return mod.readFile;
+}
+describe("buildBugReport — required sections", () => {
+    beforeEach(async () => {
+        const readFile = await getMockedReadFile();
+        // Default: no config, no error log
+        readFile.mockRejectedValue(new Error("ENOENT: file not found"));
+    });
+    afterEach(() => {
+        vi.clearAllMocks();
+    });
+    it("returns all required sections", async () => {
+        const bundle = await buildBugReport();
+        expect(bundle).toHaveProperty("generated_at");
+        expect(bundle).toHaveProperty("bun_version");
+        expect(bundle).toHaveProperty("os");
+        expect(bundle).toHaveProperty("doctor");
+        expect(bundle).toHaveProperty("config_redacted");
+        expect(bundle).toHaveProperty("error_log_tail");
+        expect(bundle.os).toHaveProperty("platform");
+        expect(bundle.os).toHaveProperty("release");
+        expect(bundle.os).toHaveProperty("arch");
+    });
+    it("generated_at is a valid ISO 8601 timestamp", async () => {
+        const bundle = await buildBugReport();
+        expect(() => new Date(bundle.generated_at)).not.toThrow();
+        expect(new Date(bundle.generated_at).toISOString()).toBe(bundle.generated_at);
+    });
+    it("doctor results contain 7 entries from runDoctor()", async () => {
+        const bundle = await buildBugReport();
+        expect(bundle.doctor).toHaveLength(7);
+    });
+});
+describe("buildBugReport — config_redacted does NOT contain authToken", () => {
+    afterEach(() => {
+        vi.clearAllMocks();
+    });
+    it("config_redacted excludes ee.authToken and includes cap.monthly_usd", async () => {
+        const mockConfig = JSON.stringify({
+            ee: { authToken: "secret-token-123456" },
+            cap: { monthly_usd: 15 },
+            router: { confidence_threshold: 0.55 },
+        });
+        const readFile = await getMockedReadFile();
+        readFile.mockImplementation((filePath) => {
+            // Match by filename ending to avoid Windows/Unix path separator issues
+            if (String(filePath).endsWith("config.json"))
+                return Promise.resolve(mockConfig);
+            return Promise.reject(new Error("ENOENT: file not found"));
+        });
+        const bundle = await buildBugReport();
+        // Should include cap.monthly_usd
+        expect(bundle.config_redacted["cap.monthly_usd"]).toBe(15);
+        // Should NOT contain the auth token value anywhere in the bundle JSON
+        const bundleJson = JSON.stringify(bundle);
+        expect(bundleJson).not.toContain("secret-token-123456");
+        // Should NOT have authToken as a key
+        expect(Object.keys(bundle.config_redacted)).not.toContain("authToken");
+        expect(Object.keys(bundle.config_redacted)).not.toContain("ee.authToken");
+    });
+});
+describe("buildBugReport — error_log_tail scrubs API keys", () => {
+    afterEach(() => {
+        vi.clearAllMocks();
+    });
+    it("scrubs sk-ant-* keys from error log lines", async () => {
+        const errorLogContent = [
+            "2026-04-30T10:00:00Z Error calling sk-ant-abc123def456ghi789xyz at /api",
+            "2026-04-30T10:01:00Z Normal log line without secrets",
+        ].join("\n");
+        const readFile = await getMockedReadFile();
+        readFile.mockImplementation((filePath) => {
+            // Match by filename ending to avoid Windows/Unix path separator issues
+            if (String(filePath).endsWith("errors.log"))
+                return Promise.resolve(errorLogContent);
+            return Promise.reject(new Error("ENOENT: file not found"));
+        });
+        const bundle = await buildBugReport();
+        // The error log tail should not contain the original API key
+        expect(bundle.error_log_tail.join(" ")).not.toContain("sk-ant-abc123def456ghi789xyz");
+        // Should have 2 lines from the log
+        expect(bundle.error_log_tail).toHaveLength(2);
+        // First line should be redacted (contains ***REDACTED***)
+        expect(bundle.error_log_tail[0]).toContain("***REDACTED***");
+        // Normal line should be intact
+        expect(bundle.error_log_tail[1]).toContain("Normal log line without secrets");
+    });
+    it("limits error_log_tail to max 20 lines", async () => {
+        const manyLines = Array.from({ length: 30 }, (_, i) => `2026-04-30T10:00:0${String(i).padStart(2, "0")}Z Log line ${i}`).join("\n");
+        const readFile = await getMockedReadFile();
+        readFile.mockImplementation((filePath) => {
+            if (String(filePath).endsWith("errors.log"))
+                return Promise.resolve(manyLines);
+            return Promise.reject(new Error("ENOENT: file not found"));
+        });
+        const bundle = await buildBugReport();
+        expect(bundle.error_log_tail.length).toBeLessThanOrEqual(20);
+    });
+});
+describe("formatBugReport — produces valid JSON", () => {
+    it("formatBugReport produces valid JSON string", () => {
+        const bundle = {
+            generated_at: new Date().toISOString(),
+            bun_version: "1.3.13",
+            os: { platform: "linux", release: "5.15", arch: "x64" },
+            doctor: [{ name: "os", status: "pass", detail: "linux" }],
+            config_redacted: { "cap.monthly_usd": 15 },
+            error_log_tail: [],
+            ee_status: null,
+        };
+        const json = formatBugReport(bundle);
+        expect(() => JSON.parse(json)).not.toThrow();
+        const parsed = JSON.parse(json);
+        expect(parsed.bun_version).toBe("1.3.13");
+    });
+});
+//# sourceMappingURL=bug-report.test.js.map

package/dist/ops/bug-report.test.js.map

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

package/dist/ops/doctor.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 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).
+ */
+export interface CheckResult {
+    name: string;
+    status: "pass" | "warn" | "fail";
+    detail: string;
+}
+export declare function formatDoctorReport(results: CheckResult[], version?: string): string;
+export declare function runDoctor(): Promise<CheckResult[]>;

package/dist/ops/doctor.js

@@ -0,0 +1,162 @@
+/**
+ * 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 { health as eeHealth } from "../ee/health.js";
+import { 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 settings = loadUserSettings();
+        if (settings.apiKey && settings.apiKey.length > 0) {
+            return { name: "key_presence", status: "pass", detail: "API key found in user-settings.json" };
+        }
+    }
+    catch {
+        /* settings file unreadable — fall through */
+    }
+    return {
+        name: "key_presence",
+        status: "fail",
+        detail: "No API key found (set MUONROI_API_KEY or run muonroi-cli to configure)",
+    };
+}
+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 checkEE() {
+    try {
+        const result = await eeHealth();
+        if (result.ok)
+            return { name: "ee", status: "pass", detail: "Experience Engine healthy" };
+        return {
+            name: "ee",
+            status: "warn",
+            detail: result.status === 0
+                ? "Experience Engine not running (optional — CLI works without it)"
+                : `EE responded ${result.status} (optional)`,
+        };
+    }
+    catch {
+        return { name: "ee", status: "warn", detail: "Experience Engine not running (optional — CLI works without it)" };
+    }
+}
+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)" };
+    }
+}
+export async function runDoctor() {
+    return Promise.all([
+        checkBunVersion(),
+        checkOS(),
+        checkKeyPresence(),
+        checkOllamaHealth(),
+        checkEE(),
+        checkQdrant(),
+        checkRecentErrorRate(),
+    ]);
+}
+//# sourceMappingURL=doctor.js.map

package/dist/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/ops/doctor.test.d.ts

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

package/dist/ops/doctor.test.js

@@ -0,0 +1,95 @@
+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 7 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 7 CheckResult entries", async () => {
+        const results = await runDoctor();
+        expect(results).toHaveLength(7);
+    });
+    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");
+        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");
+        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/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/orchestrator/__tests__/flow-resume.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for flow-resume.ts — loadFlowResumeDigest reads .muonroi-flow/
+ * state before chat transcript on cold start.
+ */
+export {};

package/dist/orchestrator/__tests__/flow-resume.test.js

@@ -0,0 +1,61 @@
+/**
+ * Tests for flow-resume.ts — loadFlowResumeDigest reads .muonroi-flow/
+ * state before chat transcript on cold start.
+ */
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import * as path from "node:path";
+import { afterEach, describe, expect, it } from "vitest";
+import { parseSections } from "../../flow/parser.js";
+import { createRun, setActiveRunId, updateRunFile } from "../../flow/run-manager.js";
+import { ensureFlowDir } from "../../flow/scaffold.js";
+import { loadFlowResumeDigest } from "../flow-resume.js";
+let tempDirs = [];
+async function makeTempDir(prefix) {
+    const dir = await mkdtemp(path.join(tmpdir(), prefix));
+    tempDirs.push(dir);
+    return dir;
+}
+afterEach(async () => {
+    for (const d of tempDirs) {
+        await rm(d, { recursive: true, force: true }).catch(() => { });
+    }
+    tempDirs = [];
+});
+describe("loadFlowResumeDigest", () => {
+    it("returns Resume Digest content from active run state.md", async () => {
+        const cwd = await makeTempDir("resume-digest-");
+        const flowDir = await ensureFlowDir(cwd);
+        const run = await createRun(flowDir);
+        await setActiveRunId(flowDir, run.id);
+        // Write Resume Digest content
+        const stateMap = parseSections("");
+        stateMap.sections.set("Resume Digest", "Working on feature X. File: src/foo.ts modified.");
+        stateMap.sections.set("Experience Snapshot", "");
+        await updateRunFile(flowDir, run.id, "state.md", stateMap);
+        const digest = await loadFlowResumeDigest(cwd);
+        expect(digest).toBe("Working on feature X. File: src/foo.ts modified.");
+    });
+    it("returns null when .muonroi-flow/ does not exist", async () => {
+        const cwd = await makeTempDir("no-flow-");
+        const digest = await loadFlowResumeDigest(cwd);
+        expect(digest).toBeNull();
+    });
+    it("returns null when no active run is set", async () => {
+        const cwd = await makeTempDir("no-active-");
+        await ensureFlowDir(cwd);
+        // Don't set active run
+        const digest = await loadFlowResumeDigest(cwd);
+        expect(digest).toBeNull();
+    });
+    it("returns null when active run has empty Resume Digest", async () => {
+        const cwd = await makeTempDir("empty-digest-");
+        const flowDir = await ensureFlowDir(cwd);
+        const run = await createRun(flowDir);
+        await setActiveRunId(flowDir, run.id);
+        // createRun initializes state.md with empty Resume Digest — don't write content
+        const digest = await loadFlowResumeDigest(cwd);
+        expect(digest).toBeNull();
+    });
+});
+//# sourceMappingURL=flow-resume.test.js.map

package/dist/orchestrator/__tests__/flow-resume.test.js.map

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

package/dist/orchestrator/__tests__/route-feedback.test.d.ts

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

package/dist/orchestrator/__tests__/route-feedback.test.js

@@ -0,0 +1,47 @@
+// Test stubs for ROUTE-11 routeFeedback wiring in orchestrator
+import { describe, it, expect, vi, beforeEach } from "vitest";
+vi.mock("../../ee/bridge.js", () => ({
+    routeFeedback: vi.fn().mockResolvedValue(true),
+    routeModel: vi.fn().mockResolvedValue(null),
+    classifyViaBrain: vi.fn().mockResolvedValue(null),
+    searchCollection: vi.fn().mockResolvedValue([]),
+    getEmbeddingRaw: vi.fn().mockResolvedValue(null),
+    resetBridge: vi.fn(),
+}));
+vi.mock("../../pil/task-tier-map.js", () => ({
+    taskTypeToTier: vi.fn().mockReturnValue("balanced"),
+}));
+describe("routeFeedback wiring", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it("should import routeFeedback from bridge", async () => {
+        const bridge = await import("../../ee/bridge.js");
+        expect(bridge.routeFeedback).toBeDefined();
+    });
+    it("should import taskTypeToTier from task-tier-map", async () => {
+        const tierMap = await import("../../pil/task-tier-map.js");
+        expect(tierMap.taskTypeToTier).toBeDefined();
+    });
+    it("routeFeedback signature accepts required params", async () => {
+        const { routeFeedback } = await import("../../ee/bridge.js");
+        // Verify the function can be called with correct signature
+        await routeFeedback("hash123", "balanced", "claude-3", "success", 0, 1500);
+        expect(routeFeedback).toHaveBeenCalledWith("hash123", "balanced", "claude-3", "success", 0, 1500);
+    });
+    it("taskTypeToTier maps correctly for routeFeedback tier param", async () => {
+        const { taskTypeToTier } = await import("../../pil/task-tier-map.js");
+        expect(taskTypeToTier("debug")).toBe("balanced");
+    });
+    it("routeFeedback returns true when bridge is available", async () => {
+        const { routeFeedback } = await import("../../ee/bridge.js");
+        const result = await routeFeedback("hash456", "premium", "claude-opus", "fail", 0, 3000);
+        expect(result).toBe(true);
+    });
+    it("routeFeedback is called with 'cancelled' outcome for cancelled turns", async () => {
+        const { routeFeedback } = await import("../../ee/bridge.js");
+        await routeFeedback("hash789", "fast", "claude-haiku", "cancelled", 0, 500);
+        expect(routeFeedback).toHaveBeenCalledWith("hash789", "fast", "claude-haiku", "cancelled", 0, 500);
+    });
+});
+//# sourceMappingURL=route-feedback.test.js.map

package/dist/orchestrator/__tests__/route-feedback.test.js.map

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

package/dist/orchestrator/abort.d.ts

@@ -0,0 +1,29 @@
+/**
+ * AbortContext — single-owner AbortController wrapper for the orchestrator.
+ *
+ * Rules:
+ * - One AbortContext per user message turn (created fresh by the orchestrator).
+ * - The signal is threaded into streamText, tool runner, and EE intercept calls.
+ * - abort() is idempotent — safe to call from multiple signal paths (SIGINT,
+ *   EE timeout, etc.). First call wins; subsequent calls are no-ops.
+ *
+ * Mitigates: Pitfall 2 (orchestrator-level abort safely terminates all I/O).
+ * References: TUI-04, 00-CONTEXT.md decision — orchestrator owns controller.
+ */
+export interface AbortContext {
+    /** The underlying AbortSignal — thread this into every async I/O call. */
+    signal: AbortSignal;
+    /**
+     * Abort the context with an optional reason string.
+     * Safe to call multiple times — only the first call has effect.
+     */
+    abort(reason?: string): void;
+    /** Returns true once abort() has been called. */
+    isAborted(): boolean;
+    /** Returns the reason string passed to the first abort() call, or undefined. */
+    reason(): string | undefined;
+}
+/**
+ * Creates a fresh AbortContext.  Call once per user message turn.
+ */
+export declare function createAbortContext(): AbortContext;