muonroi-cli 1.2.0

package/dist/daemon/scheduler.js

@@ -0,0 +1,126 @@
+import { cronMatchesDate, getScheduleDaemonStatus, getScheduleRunLogPath, removeScheduleDaemonPid, ScheduleManager, startDetachedHeadlessRun, writeScheduleDaemonPid, } from "../tools/schedule";
+import { getDefaultEEClient } from "../ee/intercept.js";
+export class SchedulerDaemon {
+    schedules = new ScheduleManager();
+    tickTimer = null;
+    shuttingDown = false;
+    tickRunning = false;
+    signalHandlersInstalled = false;
+    tickCount = 0;
+    static EVOLVE_INTERVAL_TICKS = 360; // 6 hours at 60s/tick
+    async start() {
+        const status = await getScheduleDaemonStatus();
+        if (status.running && status.pid !== process.pid) {
+            throw new Error(`Schedule daemon is already running (pid ${status.pid}).`);
+        }
+        await writeScheduleDaemonPid(process.pid);
+        this.installSignalHandlers();
+        const allSchedules = await this.schedules.list();
+        const recurringCount = allSchedules.filter((schedule) => schedule.enabled && schedule.cron).length;
+        console.error(`Schedule daemon started (pid ${process.pid}). Watching ${recurringCount} recurring schedule(s).`);
+        await this.tick();
+        this.tickTimer = setInterval(() => {
+            void this.tick();
+        }, 60_000);
+    }
+    async stop() {
+        if (this.shuttingDown)
+            return;
+        this.shuttingDown = true;
+        if (this.tickTimer) {
+            clearInterval(this.tickTimer);
+            this.tickTimer = null;
+        }
+        await removeScheduleDaemonPid();
+    }
+    async getStatus() {
+        return getScheduleDaemonStatus();
+    }
+    installSignalHandlers() {
+        if (this.signalHandlersInstalled)
+            return;
+        this.signalHandlersInstalled = true;
+        const shutdown = (signal) => {
+            console.error(`Schedule daemon stopping (${signal}).`);
+            void this.stop().finally(() => {
+                process.exit(0);
+            });
+        };
+        process.on("SIGINT", shutdown);
+        process.on("SIGTERM", shutdown);
+    }
+    async tick() {
+        if (this.tickRunning || this.shuttingDown)
+            return;
+        this.tickRunning = true;
+        try {
+            this.tickCount++;
+            if (this.tickCount % SchedulerDaemon.EVOLVE_INTERVAL_TICKS === 0) {
+                getDefaultEEClient()
+                    .evolve("daemon-periodic")
+                    .then((res) => {
+                    if (res)
+                        console.error("Daemon evolve completed.");
+                })
+                    .catch((err) => {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    console.error(`Daemon evolve failed: ${msg}`);
+                });
+            }
+            const now = new Date();
+            const schedules = await this.schedules.list();
+            for (const schedule of schedules) {
+                if (!shouldRunScheduleNow(schedule, now)) {
+                    continue;
+                }
+                try {
+                    const pid = await startDetachedHeadlessRun({
+                        instruction: schedule.instruction,
+                        directory: schedule.directory,
+                        model: schedule.model,
+                        maxToolRounds: schedule.maxToolRounds,
+                        logPath: getScheduleRunLogPath(schedule.id),
+                    });
+                    await this.schedules.touchLastRunAt(schedule.id, now);
+                    const pidText = pid ? ` (pid ${pid})` : "";
+                    console.error(`Fired schedule ${schedule.id}${pidText}.`);
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    console.error(`Schedule ${schedule.id} failed: ${msg}`);
+                }
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(`Schedule daemon tick failed: ${message}`);
+        }
+        finally {
+            this.tickRunning = false;
+        }
+    }
+}
+function shouldRunScheduleNow(schedule, now) {
+    if (!schedule.enabled || !schedule.cron) {
+        return false;
+    }
+    if (!cronMatchesDate(schedule.cron, now)) {
+        return false;
+    }
+    if (!schedule.lastRunAt) {
+        return true;
+    }
+    const last = new Date(schedule.lastRunAt);
+    if (Number.isNaN(last.getTime())) {
+        return true;
+    }
+    return !isSameMinute(last, now);
+}
+function isSameMinute(a, b) {
+    return (a.getFullYear() === b.getFullYear() &&
+        a.getMonth() === b.getMonth() &&
+        a.getDate() === b.getDate() &&
+        a.getHours() === b.getHours() &&
+        a.getMinutes() === b.getMinutes());
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/daemon/scheduler.js.map

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

package/dist/daemon/scheduler.test.d.ts

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

package/dist/daemon/scheduler.test.js

@@ -0,0 +1,103 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+async function importSchedulerModule(mocks) {
+    vi.resetModules();
+    const startDetachedHeadlessRun = mocks.startDetachedHeadlessRun ?? vi.fn(async () => 9876);
+    const getScheduleDaemonStatus = mocks.getScheduleDaemonStatus ?? vi.fn(async () => ({ running: false, pid: null }));
+    const writeScheduleDaemonPid = mocks.writeScheduleDaemonPid ?? vi.fn(async () => { });
+    const removeScheduleDaemonPid = mocks.removeScheduleDaemonPid ?? vi.fn(async () => { });
+    const cronMatchesDate = mocks.cronMatchesDate ?? vi.fn(() => true);
+    vi.doMock("../tools/schedule", () => ({
+        ScheduleManager: class {
+            list = mocks.list;
+            touchLastRunAt = mocks.touchLastRunAt;
+        },
+        cronMatchesDate,
+        getScheduleDaemonStatus,
+        getScheduleRunLogPath: (id) => `/tmp/${id}.log`,
+        removeScheduleDaemonPid,
+        startDetachedHeadlessRun,
+        writeScheduleDaemonPid,
+    }));
+    const mod = await import("./scheduler");
+    return {
+        SchedulerDaemon: mod.SchedulerDaemon,
+        startDetachedHeadlessRun,
+        getScheduleDaemonStatus,
+        writeScheduleDaemonPid,
+        removeScheduleDaemonPid,
+        cronMatchesDate,
+    };
+}
+afterEach(() => {
+    vi.useRealTimers();
+    vi.restoreAllMocks();
+    vi.resetModules();
+});
+describe("SchedulerDaemon", () => {
+    it("fires matching recurring schedules and records lastRunAt", async () => {
+        vi.useFakeTimers();
+        vi.setSystemTime(new Date("2026-03-25T09:00:00"));
+        const list = vi.fn(async () => [
+            {
+                id: "daily-security-scan",
+                name: "Daily Security Scan",
+                instruction: "Scan the repo.",
+                cron: "0 9 * * 1-5",
+                model: "muonroi-test-model",
+                directory: "/repo",
+                enabled: true,
+                maxToolRounds: 400,
+                createdAt: "2026-03-25T08:00:00.000Z",
+                updatedAt: "2026-03-25T08:00:00.000Z",
+            },
+        ]);
+        const touchLastRunAt = vi.fn(async () => { });
+        const { SchedulerDaemon, startDetachedHeadlessRun, writeScheduleDaemonPid, removeScheduleDaemonPid } = await importSchedulerModule({
+            list,
+            touchLastRunAt,
+        });
+        const daemon = new SchedulerDaemon();
+        await daemon.start();
+        expect(writeScheduleDaemonPid).toHaveBeenCalledWith(process.pid);
+        expect(startDetachedHeadlessRun).toHaveBeenCalledWith({
+            instruction: "Scan the repo.",
+            directory: "/repo",
+            model: "muonroi-test-model",
+            maxToolRounds: 400,
+            logPath: "/tmp/daily-security-scan.log",
+        });
+        expect(touchLastRunAt).toHaveBeenCalledWith("daily-security-scan", expect.any(Date));
+        await daemon.stop();
+        expect(removeScheduleDaemonPid).toHaveBeenCalled();
+    });
+    it("does not refire a schedule that already ran in the same minute", async () => {
+        vi.useFakeTimers();
+        vi.setSystemTime(new Date("2026-03-25T09:00:30.000Z"));
+        const list = vi.fn(async () => [
+            {
+                id: "daily-security-scan",
+                name: "Daily Security Scan",
+                instruction: "Scan the repo.",
+                cron: "* * * * *",
+                model: "muonroi-test-model",
+                directory: "/repo",
+                enabled: true,
+                maxToolRounds: 400,
+                lastRunAt: "2026-03-25T09:00:00.000Z",
+                createdAt: "2026-03-25T08:00:00.000Z",
+                updatedAt: "2026-03-25T09:00:00.000Z",
+            },
+        ]);
+        const touchLastRunAt = vi.fn(async () => { });
+        const { SchedulerDaemon, startDetachedHeadlessRun } = await importSchedulerModule({
+            list,
+            touchLastRunAt,
+        });
+        const daemon = new SchedulerDaemon();
+        await daemon.start();
+        expect(startDetachedHeadlessRun).not.toHaveBeenCalled();
+        expect(touchLastRunAt).not.toHaveBeenCalled();
+        await daemon.stop();
+    });
+});
+//# sourceMappingURL=scheduler.test.js.map

package/dist/daemon/scheduler.test.js.map

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

package/dist/ee/__tests__/pipeline.integration.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * End-to-end pipeline integration test (ROUTE-12).
+ *
+ * Verifies all 5 events fire for a single tool invocation:
+ *   PreToolUse (intercept) -> PostToolUse (posttool) -> Judge -> Feedback -> Touch
+ *
+ * Uses real modules + stub HTTP server — no vi.mock.
+ * Anti-patterns avoided:
+ *   - No HTTP call ordering by array index (fire-and-forget lands non-deterministically)
+ *   - resetEEClientState() in beforeEach (circuit breaker + cache contamination)
+ *   - resetHookState() in beforeEach (_lastWarningResponse contamination between tests)
+ *   - No vi.mock — integration test uses real modules + stub
+ */
+export {};

package/dist/ee/__tests__/pipeline.integration.test.js

@@ -0,0 +1,151 @@
+/**
+ * End-to-end pipeline integration test (ROUTE-12).
+ *
+ * Verifies all 5 events fire for a single tool invocation:
+ *   PreToolUse (intercept) -> PostToolUse (posttool) -> Judge -> Feedback -> Touch
+ *
+ * Uses real modules + stub HTTP server — no vi.mock.
+ * Anti-patterns avoided:
+ *   - No HTTP call ordering by array index (fire-and-forget lands non-deterministically)
+ *   - resetEEClientState() in beforeEach (circuit breaker + cache contamination)
+ *   - resetHookState() in beforeEach (_lastWarningResponse contamination between tests)
+ *   - No vi.mock — integration test uses real modules + stub
+ */
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { startStubEEServer } from "../../__test-stubs__/ee-server.js";
+import { createEEClient, resetEEClientState } from "../client.js";
+import { setDefaultEEClient } from "../intercept.js";
+import { executeEventHooks, resetHookState } from "../../hooks/index.js";
+const sampleMatch = {
+    principle_uuid: "P1",
+    confidence: 0.9,
+    why: "test match",
+    message: "warning: test principle",
+    embedding_model_version: "v1",
+    scope_label: "global",
+    last_matched_at: new Date().toISOString(),
+};
+describe("EE full pipeline integration (ROUTE-12)", () => {
+    let stub;
+    beforeEach(async () => {
+        resetEEClientState();
+        resetHookState();
+    });
+    afterEach(async () => {
+        if (stub)
+            await stub.stop();
+        resetEEClientState();
+        resetHookState();
+    });
+    it("fires all 5 events for a single tool invocation (intercept -> posttool -> judge -> feedback -> touch)", async () => {
+        stub = await startStubEEServer({
+            intercept: () => ({
+                decision: "allow",
+                matches: [sampleMatch],
+            }),
+        });
+        const client = createEEClient({
+            baseUrl: `http://127.0.0.1:${stub.port}`,
+            timeoutMs: 2000,
+        });
+        setDefaultEEClient(client);
+        // Event 1: PreToolUse — fires intercept, stores warning in _lastWarningResponse
+        await executeEventHooks({
+            hook_event_name: "PreToolUse",
+            tool_name: "Edit",
+            tool_input: { path: "/tmp/x.ts" },
+            cwd: process.cwd(),
+        }, process.cwd());
+        // Event 2: PostToolUse — fires posttool + (judge -> feedback + touch via judgeCtx)
+        await executeEventHooks({
+            hook_event_name: "PostToolUse",
+            tool_name: "Edit",
+            tool_input: { path: "/tmp/x.ts" },
+            tool_output: { result: "ok" },
+            cwd: process.cwd(),
+        }, process.cwd());
+        // Allow fire-and-forget HTTP calls (feedback + touch) to settle
+        await new Promise((r) => setTimeout(r, 500));
+        // Assert all 5 pipeline stages fired
+        expect(stub.calls.intercept).toHaveLength(1); // Stage 1: PreToolUse
+        expect(stub.calls.posttool).toHaveLength(1); // Stage 2: PostToolUse
+        expect(stub.calls.feedback.length).toBeGreaterThanOrEqual(1); // Stage 3+4: Judge FOLLOWED -> Feedback
+        expect(stub.calls.touch.length).toBeGreaterThanOrEqual(1); // Stage 5: Touch (FOLLOWED path)
+        // Verify feedback classification
+        expect(stub.calls.feedback[0]).toMatchObject({
+            principle_uuid: "P1",
+            classification: "FOLLOWED",
+            tool_name: "Edit",
+        });
+    });
+    it("auto-judge classifies IRRELEVANT when no matches — feedback and touch not called", async () => {
+        stub = await startStubEEServer({
+            intercept: () => ({
+                decision: "allow",
+                matches: [], // empty matches => IRRELEVANT
+            }),
+        });
+        const client = createEEClient({
+            baseUrl: `http://127.0.0.1:${stub.port}`,
+            timeoutMs: 2000,
+        });
+        setDefaultEEClient(client);
+        await executeEventHooks({
+            hook_event_name: "PreToolUse",
+            tool_name: "Edit",
+            tool_input: { path: "/tmp/y.ts" },
+            cwd: process.cwd(),
+        }, process.cwd());
+        await executeEventHooks({
+            hook_event_name: "PostToolUse",
+            tool_name: "Edit",
+            tool_input: { path: "/tmp/y.ts" },
+            tool_output: { result: "ok" },
+            cwd: process.cwd(),
+        }, process.cwd());
+        await new Promise((r) => setTimeout(r, 150));
+        // intercept + posttool fire, but no feedback or touch (IRRELEVANT has no matches to report)
+        expect(stub.calls.intercept).toHaveLength(1);
+        expect(stub.calls.posttool).toHaveLength(1);
+        expect(stub.calls.feedback).toHaveLength(0); // IRRELEVANT: judge.ts line 33 — no feedback for empty matches
+        expect(stub.calls.touch).toHaveLength(0);
+    });
+    it("auto-judge classifies IGNORED when outcome fails — feedback called, touch not called", async () => {
+        stub = await startStubEEServer({
+            intercept: () => ({
+                decision: "allow",
+                matches: [sampleMatch],
+            }),
+        });
+        const client = createEEClient({
+            baseUrl: `http://127.0.0.1:${stub.port}`,
+            timeoutMs: 2000,
+        });
+        setDefaultEEClient(client);
+        // PreToolUse to populate _lastWarningResponse with matches
+        await executeEventHooks({
+            hook_event_name: "PreToolUse",
+            tool_name: "Bash",
+            tool_input: { command: "exit 1" },
+            cwd: process.cwd(),
+        }, process.cwd());
+        // PostToolUseFailure — outcome.success=false => IGNORED classification
+        await executeEventHooks({
+            hook_event_name: "PostToolUseFailure",
+            tool_name: "Bash",
+            tool_input: { command: "exit 1" },
+            error: "exit code 1",
+            cwd: process.cwd(),
+        }, process.cwd());
+        await new Promise((r) => setTimeout(r, 150));
+        expect(stub.calls.intercept).toHaveLength(1);
+        expect(stub.calls.posttool).toHaveLength(1);
+        expect(stub.calls.feedback).toHaveLength(1); // IGNORED: feedback fires
+        expect(stub.calls.touch).toHaveLength(0); // IGNORED: touch does NOT fire
+        expect(stub.calls.feedback[0]).toMatchObject({
+            principle_uuid: "P1",
+            classification: "IGNORED",
+        });
+    });
+});
+//# sourceMappingURL=pipeline.integration.test.js.map

package/dist/ee/__tests__/pipeline.integration.test.js.map

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

package/dist/ee/auth.d.ts

@@ -0,0 +1,19 @@
+export interface ExperienceConfig {
+    authToken?: string;
+    embeddingModelVersion?: string;
+    serverBaseUrl?: string;
+    serverAuthToken?: string;
+    server?: {
+        port?: number;
+        authToken?: string;
+    };
+}
+export declare function loadEEAuthToken(opts?: {
+    home?: string;
+}): Promise<string | null>;
+export declare function refreshAuthToken(opts?: {
+    home?: string;
+}): Promise<string | null>;
+export declare function getCachedAuthToken(): string | null;
+export declare function getEmbeddingModelVersion(): string;
+export declare function getCachedServerBaseUrl(): string | null;

package/dist/ee/auth.js

@@ -0,0 +1,48 @@
+/**
+ * EE auth token loader — reads ~/.experience/config.json at startup.
+ *
+ * EE-07: auth token from config; 401 triggers refreshAuthToken() + retry-once.
+ */
+import { promises as fs } from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { redactor } from "../utils/redactor.js";
+function configPath(homeOverride) {
+    return path.join(homeOverride ?? os.homedir(), ".experience", "config.json");
+}
+let _token = null;
+let _embeddingModelVersion = null;
+let _serverBaseUrl = null;
+export async function loadEEAuthToken(opts = {}) {
+    try {
+        const txt = await fs.readFile(configPath(opts.home), "utf8");
+        const cfg = JSON.parse(txt);
+        const token = cfg.serverAuthToken ?? cfg.server?.authToken ?? cfg.authToken;
+        if (token) {
+            redactor.enrollSecret(token);
+            _token = token;
+        }
+        if (cfg.embeddingModelVersion)
+            _embeddingModelVersion = cfg.embeddingModelVersion;
+        if (cfg.serverBaseUrl)
+            _serverBaseUrl = cfg.serverBaseUrl;
+        return _token;
+    }
+    catch {
+        return null;
+    }
+}
+export async function refreshAuthToken(opts = {}) {
+    _token = null;
+    return await loadEEAuthToken(opts);
+}
+export function getCachedAuthToken() {
+    return _token;
+}
+export function getEmbeddingModelVersion() {
+    return _embeddingModelVersion ?? "nomic-embed-text-v1.5";
+}
+export function getCachedServerBaseUrl() {
+    return _serverBaseUrl;
+}
+//# sourceMappingURL=auth.js.map

package/dist/ee/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/ee/auth.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAUhD,SAAS,UAAU,CAAC,YAAqB;IACvC,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;AAC/E,CAAC;AAED,IAAI,MAAM,GAAkB,IAAI,CAAC;AACjC,IAAI,sBAAsB,GAAkB,IAAI,CAAC;AACjD,IAAI,cAAc,GAAkB,IAAI,CAAC;AAEzC,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAA0B,EAAE;IAChE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAqB,CAAC;QAChD,MAAM,KAAK,GAAG,GAAG,CAAC,eAAe,IAAI,GAAG,CAAC,MAAM,EAAE,SAAS,IAAI,GAAG,CAAC,SAAS,CAAC;QAC5E,IAAI,KAAK,EAAE,CAAC;YACV,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YAC7B,MAAM,GAAG,KAAK,CAAC;QACjB,CAAC;QACD,IAAI,GAAG,CAAC,qBAAqB;YAAE,sBAAsB,GAAG,GAAG,CAAC,qBAAqB,CAAC;QAClF,IAAI,GAAG,CAAC,aAAa;YAAE,cAAc,GAAG,GAAG,CAAC,aAAa,CAAC;QAC1D,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAA0B,EAAE;IACjE,MAAM,GAAG,IAAI,CAAC;IACd,OAAO,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,OAAO,sBAAsB,IAAI,uBAAuB,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/dist/ee/auth.test.d.ts

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

package/dist/ee/auth.test.js

@@ -0,0 +1,59 @@
+import { promises 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 { getEmbeddingModelVersion, loadEEAuthToken, refreshAuthToken } from "./auth.js";
+describe("loadEEAuthToken", () => {
+    let tmpHome;
+    beforeEach(async () => {
+        tmpHome = await fs.mkdtemp(path.join(os.tmpdir(), "ee-auth-test-"));
+    });
+    afterEach(async () => {
+        await fs.rm(tmpHome, { recursive: true, force: true }).catch(() => { });
+    });
+    it("returns token when ~/.experience/config.json exists", async () => {
+        const dir = path.join(tmpHome, ".experience");
+        await fs.mkdir(dir, { recursive: true });
+        await fs.writeFile(path.join(dir, "config.json"), JSON.stringify({
+            authToken: "test-token-abc123",
+            embeddingModelVersion: "nomic-embed-text-v1.5",
+        }));
+        const token = await loadEEAuthToken({ home: tmpHome });
+        expect(token).toBe("test-token-abc123");
+    });
+    it("returns null when ~/.experience/config.json is absent (no throw)", async () => {
+        const token = await loadEEAuthToken({ home: tmpHome });
+        expect(token).toBeNull();
+    });
+    it("sets embeddingModelVersion from config", async () => {
+        const dir = path.join(tmpHome, ".experience");
+        await fs.mkdir(dir, { recursive: true });
+        await fs.writeFile(path.join(dir, "config.json"), JSON.stringify({
+            authToken: "tok",
+            embeddingModelVersion: "custom-v2",
+        }));
+        await loadEEAuthToken({ home: tmpHome });
+        expect(getEmbeddingModelVersion()).toBe("custom-v2");
+    });
+});
+describe("refreshAuthToken", () => {
+    let tmpHome;
+    beforeEach(async () => {
+        tmpHome = await fs.mkdtemp(path.join(os.tmpdir(), "ee-auth-ref-"));
+    });
+    afterEach(async () => {
+        await fs.rm(tmpHome, { recursive: true, force: true }).catch(() => { });
+    });
+    it("re-reads config.json and updates the cached value", async () => {
+        const dir = path.join(tmpHome, ".experience");
+        await fs.mkdir(dir, { recursive: true });
+        await fs.writeFile(path.join(dir, "config.json"), JSON.stringify({ authToken: "old-token" }));
+        const first = await loadEEAuthToken({ home: tmpHome });
+        expect(first).toBe("old-token");
+        // Write new token
+        await fs.writeFile(path.join(dir, "config.json"), JSON.stringify({ authToken: "new-token" }));
+        const second = await refreshAuthToken({ home: tmpHome });
+        expect(second).toBe("new-token");
+    });
+});
+//# sourceMappingURL=auth.test.js.map

package/dist/ee/auth.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.test.js","sourceRoot":"","sources":["../../src/ee/auth.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAErE,OAAO,EAAE,wBAAwB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAExF,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,IAAI,OAAe,CAAC;IAEpB,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,MAAM,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAC9C,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,EAC7B,IAAI,CAAC,SAAS,CAAC;YACb,SAAS,EAAE,mBAAmB;YAC9B,qBAAqB,EAAE,uBAAuB;SAC/C,CAAC,CACH,CAAC;QACF,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACvD,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACvD,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAC9C,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,EAC7B,IAAI,CAAC,SAAS,CAAC;YACb,SAAS,EAAE,KAAK;YAChB,qBAAqB,EAAE,WAAW;SACnC,CAAC,CACH,CAAC;QACF,MAAM,eAAe,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACzC,MAAM,CAAC,wBAAwB,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,IAAI,OAAe,CAAC;IAEpB,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,MAAM,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAC9C,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;QAC9F,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACvD,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAEhC,kBAAkB;QAClB,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;QAC9F,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACzD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/ee/bridge.d.ts

@@ -0,0 +1,68 @@
+interface EEPoint {
+    id: string | number;
+    score?: number;
+    payload?: Record<string, unknown>;
+}
+interface EERouteResult {
+    tier: string;
+    model: string;
+    reasoningEffort?: string;
+    confidence: number;
+    source: string;
+    reason: string;
+    taskHash: string | null;
+}
+interface EERouteTaskResult {
+    route: "qc-flow" | "qc-lock" | "direct" | null;
+    confidence: number;
+    source: string;
+    reason: string;
+    needs_disambiguation: boolean;
+    options: Array<{
+        id: string;
+        label: string;
+        route: string;
+        description: string;
+    }>;
+    taskHash: string | null;
+}
+export type { EEPoint, EERouteResult, EERouteTaskResult };
+/**
+ * Classify a prompt via the EE brain LLM (Ollama or SiliconFlow).
+ * Returns a classification string or null on timeout / core absent.
+ * timeoutMs is forwarded to experience-core.js — keep ≤5000ms on the CLI hot path.
+ */
+export declare function classifyViaBrain(prompt: string, timeoutMs?: number): Promise<string | null>;
+/**
+ * Search a named Qdrant collection by embedding vector.
+ * Falls back to FileStore inside experience-core.js if Qdrant is unavailable.
+ * Returns an empty array when core is absent or the search fails.
+ */
+export declare function searchCollection(name: string, vector: number[], topK: number, signal?: AbortSignal): Promise<EEPoint[]>;
+/**
+ * Route a task to a model tier based on EE brain + route history.
+ * Returns an EERouteResult (includes taskHash for routeFeedback) or null when core absent.
+ */
+export declare function routeModel(task: string, context: Record<string, unknown>, runtime: string): Promise<EERouteResult | null>;
+/**
+ * Feed a routing outcome back to EE for continuous learning.
+ * taskHash comes from the routeModel response.
+ * NOTE: always await posttool() before calling routeFeedback — see STATE.md Pitfall 5.
+ */
+export declare function routeFeedback(taskHash: string, tier: string, model: string, outcome: "success" | "fail" | "retry" | "cancelled", retryCount: number, duration: number | null): Promise<boolean>;
+/**
+ * Route a task to a workflow (qc-flow/qc-lock/direct) based on EE brain + history.
+ * Returns route decision or null when core absent.
+ */
+export declare function routeTask(task: string, context?: Record<string, unknown> | null, runtime?: string | null): Promise<EERouteTaskResult | null>;
+/**
+ * Get the raw embedding vector for a text string.
+ * Uses LRU cache (200 entries, 1h TTL) to avoid redundant SiliconFlow calls.
+ * Returns null when core is absent or embedding fails.
+ */
+export declare function getEmbeddingRaw(text: string, signal?: AbortSignal): Promise<number[] | null>;
+/**
+ * Reset the lazy singleton so bridge.test.ts can re-trigger load between tests.
+ * Do NOT call in production code.
+ */
+export declare function resetBridge(): void;