muonroi-cli 1.2.0

package/dist/ee/offline-queue.test.js

@@ -0,0 +1,246 @@
+/**
+ * Unit + integration tests for offline-queue module.
+ *
+ * Tests cover all 10 behaviors:
+ *  1. enqueue() creates queue directory lazily
+ *  2. enqueue() writes correct JSON content
+ *  3. enqueue() enforces 100-entry cap by deleting oldest
+ *  4. getQueueDir() returns correct path
+ *  5. drainQueue() replays entries in FIFO order
+ *  6. drainQueue() stops on failure, leaves remaining entries
+ *  7. drainQueue() handles non-existent queue directory
+ *  8. drainQueue() discards corrupt JSON files
+ *  9. Filename format matches /^\d+-[a-z0-9]{4}\.json$/
+ * 10. drainQueue() is fire-and-forget (returns void)
+ */
+import { mkdir, readdir, rm, writeFile } from "node:fs/promises";
+import * as os from "node:os";
+import * as path from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { startStubEEServer } from "../__test-stubs__/ee-server.js";
+import { drainQueue, drainQueueAsync, enqueue, getQueueDir, } from "./offline-queue.js";
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+let tmpDir;
+beforeEach(async () => {
+    // Create isolated temp directory for each test
+    const base = path.join(os.tmpdir(), "queue-test-");
+    // Use a unique timestamp+random suffix
+    const suffix = `${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;
+    tmpDir = base + suffix;
+    await mkdir(tmpDir, { recursive: true });
+});
+afterEach(async () => {
+    await rm(tmpDir, { recursive: true, force: true });
+});
+/**
+ * Helper: get the ee-offline-queue dir inside tmpDir.
+ */
+function queueDir() {
+    return getQueueDir(tmpDir);
+}
+/**
+ * Helper: write N pre-populated queue files with sequential timestamps.
+ */
+async function populateQueue(count, startTs = 1000) {
+    const dir = queueDir();
+    await mkdir(dir, { recursive: true });
+    const filenames = [];
+    for (let i = 0; i < count; i++) {
+        const ts = startTs + i;
+        const filename = `${ts}-test.json`;
+        const entry = {
+            endpoint: "/api/feedback",
+            body: { i },
+            enqueuedAt: ts,
+        };
+        await writeFile(path.join(dir, filename), JSON.stringify(entry), "utf8");
+        filenames.push(filename);
+    }
+    return filenames;
+}
+// ─── Test 1: enqueue() creates queue directory lazily ─────────────────────────
+describe("enqueue()", () => {
+    it("creates the queue directory lazily on first call", async () => {
+        // Queue dir should NOT exist before enqueue
+        const dir = queueDir();
+        const files = await readdir(dir).catch(() => null);
+        expect(files).toBeNull(); // dir does not exist yet
+        // Call enqueue — should create dir
+        await enqueue({ endpoint: "/api/feedback", body: { test: 1 }, enqueuedAt: 1000 }, tmpDir);
+        // Dir should now exist
+        const filesAfter = await readdir(dir);
+        expect(Array.isArray(filesAfter)).toBe(true);
+    });
+    // ─── Test 9: Filename format ───────────────────────────────────────────────
+    it("creates exactly 1 file with correct filename pattern after one enqueue", async () => {
+        await enqueue({ endpoint: "/api/feedback", body: { test: 1 }, enqueuedAt: 1000 }, tmpDir);
+        const files = await readdir(queueDir());
+        expect(files).toHaveLength(1);
+        expect(files[0]).toMatch(/^\d+-[a-z0-9]{4}\.json$/);
+    });
+    // ─── Test 2: enqueue() writes correct JSON content ────────────────────────
+    it("writes correct JSON content matching the input entry", async () => {
+        const entry = {
+            endpoint: "/api/feedback",
+            body: { test: 1 },
+            enqueuedAt: 1000,
+        };
+        await enqueue(entry, tmpDir);
+        const dir = queueDir();
+        const files = await readdir(dir);
+        const raw = await import("node:fs/promises").then((fs) => fs.readFile(path.join(dir, files[0]), "utf8"));
+        const parsed = JSON.parse(raw);
+        expect(parsed).toEqual(entry);
+    });
+    // ─── Test 3: enqueue() enforces 100-entry cap ─────────────────────────────
+    it("enforces 100-entry cap: deletes oldest when queue is at capacity", async () => {
+        // Pre-populate with exactly 100 files
+        const existing = await populateQueue(100, 1000);
+        const oldestFile = existing[0]; // timestamp 1000-test.json
+        // Enqueue one more entry
+        await enqueue({
+            endpoint: "/api/feedback",
+            body: { new: true },
+            enqueuedAt: 99999,
+        }, tmpDir);
+        const files = await readdir(queueDir());
+        // Should still have exactly 100 files
+        expect(files).toHaveLength(100);
+        // Oldest file should be gone
+        expect(files).not.toContain(oldestFile);
+        // New file should exist (it has a fresh timestamp prefix via makeFilename())
+        const newFiles = files.filter((f) => !existing.includes(f));
+        expect(newFiles).toHaveLength(1);
+    });
+});
+// ─── Test 4: getQueueDir() returns correct path ───────────────────────────────
+describe("getQueueDir()", () => {
+    it("returns path under os.homedir() when no override given", () => {
+        const result = getQueueDir();
+        expect(result).toBe(path.join(os.homedir(), ".muonroi-cli", "ee-offline-queue"));
+    });
+    it("returns path under homeOverride when provided", () => {
+        const result = getQueueDir("/tmp/test");
+        expect(result).toBe(path.join("/tmp/test", ".muonroi-cli", "ee-offline-queue"));
+    });
+});
+// ─── Test 5: drainQueue() replays entries in FIFO order ───────────────────────
+describe("drainQueueAsync()", () => {
+    it("replays entries in FIFO order and deletes them after success", async () => {
+        // Pre-populate 3 entries with distinct timestamps
+        await populateQueue(3, 1000);
+        const stub = await startStubEEServer({ feedback: () => { } });
+        try {
+            await drainQueueAsync(fetch, { "Content-Type": "application/json" }, `http://127.0.0.1:${stub.port}`, tmpDir);
+            // 3 requests received in order
+            expect(stub.calls.feedback).toHaveLength(3);
+            expect(stub.calls.feedback[0].enqueuedAt ?? stub.calls.feedback[0].i).toBeDefined();
+            // FIFO: first enqueued (ts=1000) should come first
+            const receivedEnqueuedAts = stub.calls.feedback.map((b) => b.enqueuedAt ?? b.i);
+            expect(receivedEnqueuedAts[0]).toBeLessThan(receivedEnqueuedAts[1]);
+            expect(receivedEnqueuedAts[1]).toBeLessThan(receivedEnqueuedAts[2]);
+            // All files deleted after successful replay
+            const remainingFiles = await readdir(queueDir()).catch(() => []);
+            expect(remainingFiles).toHaveLength(0);
+        }
+        finally {
+            await stub.stop();
+        }
+    });
+    // ─── Test 6: drainQueue() stops on failure, leaves remaining ──────────────
+    it("stops on 2nd entry failure and leaves 2nd + 3rd entries on disk", async () => {
+        await populateQueue(3, 1000);
+        let callCount = 0;
+        const stub = await startStubEEServer({
+            feedback: () => {
+                callCount++;
+            },
+        });
+        // Override the server to return 500 on 2nd call
+        // We'll track calls and use a custom stub that serves 500 on 2nd request
+        await stub.stop();
+        // Build a minimal stub that returns 500 on 2nd POST to /api/feedback
+        const { createServer } = await import("node:http");
+        let reqCount = 0;
+        const customServer = createServer((req, res) => {
+            if (req.url === "/api/feedback" && req.method === "POST") {
+                reqCount++;
+                const chunks = [];
+                req.on("data", (c) => chunks.push(c));
+                req.on("end", () => {
+                    if (reqCount === 2) {
+                        res.writeHead(500);
+                        res.end("error");
+                    }
+                    else {
+                        res.writeHead(200);
+                        res.end("ok");
+                    }
+                });
+            }
+            else {
+                res.writeHead(404);
+                res.end();
+            }
+        });
+        await new Promise((resolve) => customServer.listen(0, "127.0.0.1", () => resolve()));
+        const addr = customServer.address();
+        const port = typeof addr === "object" && addr ? addr.port : 0;
+        try {
+            await drainQueueAsync(fetch, { "Content-Type": "application/json" }, `http://127.0.0.1:${port}`, tmpDir);
+            // 1st success, 2nd failure → should have made 2 requests total
+            expect(reqCount).toBe(2);
+            // 2nd and 3rd files remain on disk (1st was deleted on success)
+            const remainingFiles = await readdir(queueDir());
+            expect(remainingFiles).toHaveLength(2);
+        }
+        finally {
+            await new Promise((resolve) => customServer.close(() => resolve()));
+        }
+    });
+    // ─── Test 7: drainQueue() handles non-existent queue directory ────────────
+    it("returns cleanly when queue directory does not exist", async () => {
+        // No queue dir created — just call drainQueueAsync with a fresh tmpDir
+        await expect(drainQueueAsync(fetch, { "Content-Type": "application/json" }, "http://127.0.0.1:9999", tmpDir)).resolves.toBeUndefined();
+    });
+    // ─── Test 8: drainQueue() discards corrupt JSON files ─────────────────────
+    it("discards corrupt JSON files and replays valid entries after them", async () => {
+        const dir = queueDir();
+        await mkdir(dir, { recursive: true });
+        // Write corrupt file first (older timestamp)
+        const corruptFile = "1000-bad1.json";
+        await writeFile(path.join(dir, corruptFile), "NOT VALID JSON {{{{", "utf8");
+        // Write valid entry after (newer timestamp)
+        const validEntry = {
+            endpoint: "/api/feedback",
+            body: { valid: true },
+            enqueuedAt: 2000,
+        };
+        await writeFile(path.join(dir, "2000-good.json"), JSON.stringify(validEntry), "utf8");
+        const stub = await startStubEEServer({ feedback: () => { } });
+        try {
+            await drainQueueAsync(fetch, { "Content-Type": "application/json" }, `http://127.0.0.1:${stub.port}`, tmpDir);
+            // Corrupt file should be deleted
+            const remaining = await readdir(dir);
+            expect(remaining).not.toContain(corruptFile);
+            // Valid entry should have been replayed
+            expect(stub.calls.feedback).toHaveLength(1);
+            expect(stub.calls.feedback[0]).toEqual(validEntry.body);
+            // Valid file should be deleted after replay
+            expect(remaining).toHaveLength(0);
+        }
+        finally {
+            await stub.stop();
+        }
+    });
+});
+// ─── Test 10: drainQueue() is fire-and-forget ─────────────────────────────────
+describe("drainQueue() fire-and-forget wrapper", () => {
+    it("returns void (undefined), not a Promise", () => {
+        // Call drainQueue (the fire-and-forget wrapper) — should return undefined immediately
+        const result = drainQueue(fetch, { "Content-Type": "application/json" }, "http://127.0.0.1:9999", tmpDir);
+        // drainQueue() must return void (undefined), not a Promise
+        expect(result).toBeUndefined();
+    });
+});
+//# sourceMappingURL=offline-queue.test.js.map

package/dist/ee/offline-queue.test.js.map

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

package/dist/ee/posttool.d.ts

@@ -0,0 +1,11 @@
+import { type JudgeContext } from "./judge.js";
+import type { PostToolPayload } from "./types.js";
+/**
+ * Call the EE posttool endpoint using the default client.
+ * Returns Promise<void> — awaitable by the PostToolUse hook handler.
+ * Errors are swallowed (fire-and-forget semantics preserved inside client).
+ *
+ * When judgeCtx is provided, also fires deterministic feedback (EE-09)
+ * and touch on FOLLOWED matches (EE-10). fireFeedback stays synchronous (B-4 preserved).
+ */
+export declare function posttool(payload: PostToolPayload, judgeCtx?: JudgeContext): Promise<void>;

package/dist/ee/posttool.js

@@ -0,0 +1,16 @@
+import { getDefaultEEClient } from "./intercept.js";
+import { fireFeedback } from "./judge.js";
+/**
+ * Call the EE posttool endpoint using the default client.
+ * Returns Promise<void> — awaitable by the PostToolUse hook handler.
+ * Errors are swallowed (fire-and-forget semantics preserved inside client).
+ *
+ * When judgeCtx is provided, also fires deterministic feedback (EE-09)
+ * and touch on FOLLOWED matches (EE-10). fireFeedback stays synchronous (B-4 preserved).
+ */
+export async function posttool(payload, judgeCtx) {
+    await getDefaultEEClient().posttool(payload);
+    if (judgeCtx)
+        fireFeedback(judgeCtx);
+}
+//# sourceMappingURL=posttool.js.map

package/dist/ee/posttool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"posttool.js","sourceRoot":"","sources":["../../src/ee/posttool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAqB,MAAM,YAAY,CAAC;AAG7D;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAwB,EAAE,QAAuB;IAC9E,MAAM,kBAAkB,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC7C,IAAI,QAAQ;QAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;AACvC,CAAC"}

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

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

package/dist/ee/posttool.test.js

@@ -0,0 +1,70 @@
+import { describe, expect, it, vi } from "vitest";
+// Mock both intercept and judge modules
+// posttool is now async — mock must return a Promise so await works correctly
+const mockPosttool = vi.fn().mockResolvedValue(undefined);
+vi.mock("./intercept.js", () => ({
+    getDefaultEEClient: () => ({
+        posttool: mockPosttool,
+    }),
+}));
+vi.mock("./judge.js", async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        fireFeedback: vi.fn(),
+    };
+});
+const mockPayload = {
+    toolName: "bash",
+    toolInput: { command: "ls" },
+    outcome: { success: true, exitCode: 0, durationMs: 10 },
+    cwd: "/tmp",
+    tenantId: "local",
+    scope: { kind: "global" },
+};
+describe("posttool() wrapper", () => {
+    it("calls client.posttool with payload", async () => {
+        mockPosttool.mockClear();
+        const { posttool } = await import("./posttool.js");
+        await posttool(mockPayload);
+        expect(mockPosttool).toHaveBeenCalledOnce();
+        expect(mockPosttool).toHaveBeenCalledWith(mockPayload);
+    });
+    it("calls fireFeedback when judgeCtx provided", async () => {
+        mockPosttool.mockClear();
+        const { posttool } = await import("./posttool.js");
+        const { fireFeedback } = await import("./judge.js");
+        const mockFF = fireFeedback;
+        mockFF.mockClear();
+        const ctx = {
+            warningResponse: { decision: "allow", matches: [] },
+            toolName: "bash",
+            outcome: { success: true, durationMs: 10 },
+            cwdMatchedAtPretool: true,
+            diffPresent: false,
+            tenantId: "local",
+        };
+        await posttool(mockPayload, ctx);
+        expect(mockPosttool).toHaveBeenCalledOnce();
+        expect(mockFF).toHaveBeenCalledOnce();
+        expect(mockFF).toHaveBeenCalledWith(ctx);
+    });
+    it("does not call fireFeedback when judgeCtx is undefined", async () => {
+        mockPosttool.mockClear();
+        const { posttool } = await import("./posttool.js");
+        const { fireFeedback } = await import("./judge.js");
+        const mockFF = fireFeedback;
+        mockFF.mockClear();
+        await posttool(mockPayload);
+        expect(mockPosttool).toHaveBeenCalledOnce();
+        expect(mockFF).not.toHaveBeenCalled();
+    });
+    it("returns Promise<void> (async — awaitable by PostToolUse handler)", async () => {
+        mockPosttool.mockClear();
+        const { posttool } = await import("./posttool.js");
+        const result = posttool(mockPayload);
+        expect(result).toBeInstanceOf(Promise);
+        await result; // resolves to undefined
+    });
+});
+//# sourceMappingURL=posttool.test.js.map

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

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

package/dist/ee/prompt-stale.d.ts

@@ -0,0 +1,20 @@
+/**
+ * src/ee/prompt-stale.ts
+ *
+ * Per-turn prompt-stale reconciliation. Called fire-and-forget from PostToolUse
+ * hook to report surfaced EE suggestions that the agent did not explicitly
+ * acknowledge via feedback(). Uses "auto-compact" trigger to avoid cross-repo
+ * server dependency (see 10-RESEARCH.md Pitfall 3).
+ *
+ * STALE-02: calls /api/prompt-stale for surfaced IDs
+ * STALE-03: fire-and-forget — returns void, never blocks
+ */
+/**
+ * Fire-and-forget prompt-stale reconciliation.
+ * Called from PostToolUse hook after each tool-use turn.
+ *
+ * Returns void — caller must NOT await (B-4 budget constraint).
+ * Resets surfaced state BEFORE dispatching the async HTTP call
+ * to prevent double-reporting on rapid sequential PostToolUse events.
+ */
+export declare function reconcilePromptStale(cwd: string, tenantId?: string): void;

package/dist/ee/prompt-stale.js

@@ -0,0 +1,37 @@
+/**
+ * src/ee/prompt-stale.ts
+ *
+ * Per-turn prompt-stale reconciliation. Called fire-and-forget from PostToolUse
+ * hook to report surfaced EE suggestions that the agent did not explicitly
+ * acknowledge via feedback(). Uses "auto-compact" trigger to avoid cross-repo
+ * server dependency (see 10-RESEARCH.md Pitfall 3).
+ *
+ * STALE-02: calls /api/prompt-stale for surfaced IDs
+ * STALE-03: fire-and-forget — returns void, never blocks
+ */
+import { getDefaultEEClient, getLastSurfacedState, resetLastSurfacedState } from "./intercept.js";
+import { getTenantId } from "./tenant.js";
+/**
+ * Fire-and-forget prompt-stale reconciliation.
+ * Called from PostToolUse hook after each tool-use turn.
+ *
+ * Returns void — caller must NOT await (B-4 budget constraint).
+ * Resets surfaced state BEFORE dispatching the async HTTP call
+ * to prevent double-reporting on rapid sequential PostToolUse events.
+ */
+export function reconcilePromptStale(cwd, tenantId = getTenantId()) {
+    const { surfacedIds, timestamp } = getLastSurfacedState();
+    if (surfacedIds.length === 0)
+        return;
+    // Reset before async dispatch to avoid double-report (see 10-RESEARCH.md Pitfall 2)
+    resetLastSurfacedState();
+    getDefaultEEClient()
+        .promptStale({
+        state: { surfacedIds, timestamp },
+        nextPromptMeta: { trigger: "auto-compact", cwd, tenantId },
+    })
+        .catch(() => {
+        // Errors swallowed — fire-and-forget (B-4)
+    });
+}
+//# sourceMappingURL=prompt-stale.js.map

package/dist/ee/prompt-stale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-stale.js","sourceRoot":"","sources":["../../src/ee/prompt-stale.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAClG,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW,EAAE,QAAQ,GAAG,WAAW,EAAE;IACxE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,oBAAoB,EAAE,CAAC;IAC1D,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAErC,oFAAoF;IACpF,sBAAsB,EAAE,CAAC;IAEzB,kBAAkB,EAAE;SACjB,WAAW,CAAC;QACX,KAAK,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE;QACjC,cAAc,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,QAAQ,EAAE;KAC3D,CAAC;SACD,KAAK,CAAC,GAAG,EAAE;QACV,2CAA2C;IAC7C,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/ee/prompt-stale.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * src/ee/prompt-stale.test.ts
+ *
+ * Unit tests for reconcilePromptStale() fire-and-forget module.
+ * Tests use vi.mock for getDefaultEEClient to inject mockPromptStale,
+ * while using real updateLastSurfacedState/resetLastSurfacedState from intercept.ts.
+ */
+export {};

package/dist/ee/prompt-stale.test.js

@@ -0,0 +1,76 @@
+/**
+ * src/ee/prompt-stale.test.ts
+ *
+ * Unit tests for reconcilePromptStale() fire-and-forget module.
+ * Tests use vi.mock for getDefaultEEClient to inject mockPromptStale,
+ * while using real updateLastSurfacedState/resetLastSurfacedState from intercept.ts.
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+// Mock getDefaultEEClient to inject a controllable mockPromptStale
+vi.mock("./intercept.js", async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        getDefaultEEClient: vi.fn(),
+    };
+});
+import { getDefaultEEClient, getLastSurfacedState, resetLastSurfacedState, updateLastSurfacedState } from "./intercept.js";
+import { reconcilePromptStale } from "./prompt-stale.js";
+describe("reconcilePromptStale", () => {
+    let mockPromptStale;
+    beforeEach(() => {
+        mockPromptStale = vi.fn().mockResolvedValue({ ok: true, unused: [], irrelevant: [], expired: [] });
+        vi.mocked(getDefaultEEClient).mockReturnValue({
+            promptStale: mockPromptStale,
+        });
+    });
+    afterEach(() => {
+        resetLastSurfacedState();
+        vi.clearAllMocks();
+    });
+    it("is a no-op when no surfaced IDs exist (does not call promptStale)", async () => {
+        // No call to updateLastSurfacedState — surfacedIds should be []
+        const result = reconcilePromptStale("/tmp");
+        // Flush microtasks
+        await new Promise((r) => setTimeout(r, 0));
+        expect(result).toBeUndefined();
+        expect(mockPromptStale).not.toHaveBeenCalled();
+    });
+    it("calls promptStale with correct payload when IDs are surfaced", async () => {
+        updateLastSurfacedState(["id-1", "id-2"]);
+        reconcilePromptStale("/tmp");
+        // Flush microtasks
+        await new Promise((r) => setTimeout(r, 0));
+        expect(mockPromptStale).toHaveBeenCalledTimes(1);
+        const [req] = mockPromptStale.mock.calls[0];
+        expect(req.state.surfacedIds).toEqual(["id-1", "id-2"]);
+        expect(typeof req.state.timestamp).toBe("string");
+        expect(req.nextPromptMeta.trigger).toBe("auto-compact");
+        expect(req.nextPromptMeta.cwd).toBe("/tmp");
+        expect(req.nextPromptMeta.tenantId).toBe("local");
+    });
+    it("returns undefined (void, not a Promise)", () => {
+        updateLastSurfacedState(["id-1"]);
+        const result = reconcilePromptStale("/tmp");
+        expect(result).toBeUndefined();
+    });
+    it("resets surfaced state BEFORE dispatching async HTTP call", async () => {
+        updateLastSurfacedState(["id-1", "id-2"]);
+        reconcilePromptStale("/tmp");
+        // Surfaced state should be reset synchronously before async dispatch
+        expect(getLastSurfacedState().surfacedIds).toEqual([]);
+        // HTTP call still dispatched (can verify via flush)
+        await new Promise((r) => setTimeout(r, 0));
+        expect(mockPromptStale).toHaveBeenCalledTimes(1);
+    });
+    it("swallows errors from rejected promptStale promise (fire-and-forget)", async () => {
+        mockPromptStale.mockRejectedValue(new Error("network error"));
+        updateLastSurfacedState(["id-1"]);
+        // Should not throw
+        expect(() => reconcilePromptStale("/tmp")).not.toThrow();
+        // Allow the rejected promise to settle — should not produce unhandled rejection
+        await new Promise((r) => setTimeout(r, 10));
+        expect(mockPromptStale).toHaveBeenCalledTimes(1);
+    });
+});
+//# sourceMappingURL=prompt-stale.test.js.map

package/dist/ee/prompt-stale.test.js.map

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

package/dist/ee/render.d.ts

@@ -0,0 +1,20 @@
+/**
+ * EE PreToolUse inline warning renderer.
+ *
+ * EE-02: decision='allow' with matches[] emits ⚠ [Experience] lines
+ * via a pluggable render sink (default: console.warn).
+ *
+ * Format per match (5 lines with visual border):
+ *   ┌─ ⚠ Experience Warning ──────────────────────┐
+ *   │ [{confidence}] {message}
+ *   │ Why: {why}
+ *   │ Scope: {scope_label}
+ *   └──────────────────────────────────────────────┘
+ */
+import type { InterceptMatch } from "./types.js";
+type RenderSink = (line: string) => void;
+export declare function setRenderSink(fn: RenderSink): void;
+export declare function getRenderSink(): RenderSink;
+export declare function renderInterceptWarning(m: InterceptMatch): string;
+export declare function emitMatches(matches: InterceptMatch[] | undefined): void;
+export {};

package/dist/ee/render.js

@@ -0,0 +1,30 @@
+const BORDER_WIDTH = 46;
+const TOP_BORDER = `┌─ ⚠ Experience Warning ${"─".repeat(BORDER_WIDTH - 22)}┐`;
+const BOTTOM_BORDER = `└${"─".repeat(BORDER_WIDTH - 1)}┘`;
+let _sink = (line) => {
+    console.warn(line);
+};
+export function setRenderSink(fn) {
+    _sink = fn;
+}
+export function getRenderSink() {
+    return _sink;
+}
+export function renderInterceptWarning(m) {
+    const conf = (m.confidence * 100).toFixed(0);
+    const lines = [
+        TOP_BORDER,
+        `│ [${conf}%] ${m.message}`,
+        `│ Why:   ${m.why}`,
+        `│ Scope: ${m.scope_label}`,
+        BOTTOM_BORDER,
+    ];
+    return lines.join("\n");
+}
+export function emitMatches(matches) {
+    if (!matches?.length)
+        return;
+    for (const m of matches)
+        _sink(renderInterceptWarning(m));
+}
+//# sourceMappingURL=render.js.map

package/dist/ee/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/ee/render.ts"],"names":[],"mappings":"AAeA,MAAM,YAAY,GAAG,EAAE,CAAC;AACxB,MAAM,UAAU,GAAG,2BAA2B,GAAG,CAAC,MAAM,CAAC,YAAY,GAAG,EAAE,CAAC,GAAG,CAAC;AAC/E,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC,GAAG,CAAC;AAG1D,IAAI,KAAK,GAAe,CAAC,IAAI,EAAE,EAAE;IAC/B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,EAAc;IAC1C,KAAK,GAAG,EAAE,CAAC;AACb,CAAC;AACD,MAAM,UAAU,aAAa;IAC3B,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,CAAiB;IACtD,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG;QACZ,UAAU;QACV,MAAM,IAAI,MAAM,CAAC,CAAC,OAAO,EAAE;QAC3B,YAAY,CAAC,CAAC,GAAG,EAAE;QACnB,YAAY,CAAC,CAAC,WAAW,EAAE;QAC3B,aAAa;KACd,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAqC;IAC/D,IAAI,CAAC,OAAO,EAAE,MAAM;QAAE,OAAO;IAC7B,KAAK,MAAM,CAAC,IAAI,OAAO;QAAE,KAAK,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5D,CAAC"}

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

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