@ironbee-ai/cli 0.12.0 → 0.13.0

package/dist/tui/queue/area.js

@@ -0,0 +1,338 @@
+"use strict";
+/**
+ * IronBee — Queue area (read-only)
+ *
+ * Per-session view of the file-backed job queue: pending jobs (live + frozen
+ * snapshots) and dead-letter counts. Read-only operator view backed by the pure
+ * `listQueues` reader; draining / retrying stays on the `ironbee queue` CLI
+ * (those spawn workers / print, which would corrupt the screen).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.queueArea = void 0;
+const blessed = __importStar(require("blessed"));
+const fs_1 = require("fs");
+const path_1 = require("path");
+const queue_1 = require("../../queue");
+const util_1 = require("../shell/util");
+const import_1 = require("../../import");
+const read_1 = require("./read");
+const STATUS = " {bold}↑/↓{/bold} move   {bold}d{/bold} drain   {bold}D{/bold} drain-all   {bold}l{/bold} dead-letter   {bold}s{/bold} stats   {bold}c{/bold} clear   {bold}p{/bold} purge   "
+    + "{bold}r{/bold} refresh   {bold}Esc{/bold} back   {bold}q{/bold} quit";
+function mountQueueView(ctx) {
+    const projectDir = ctx.session.projectDir;
+    let queues = (0, read_1.listQueues)(projectDir);
+    let index = 0;
+    const list = blessed.list({
+        parent: ctx.container,
+        top: 0,
+        left: 0,
+        width: "62%",
+        height: "100%",
+        border: { type: "line" },
+        label: " Queue (per session) ",
+        tags: true,
+        keys: false,
+        mouse: false,
+        scrollbar: { ch: " " },
+        style: { selected: { bg: "blue", fg: "white" }, border: { fg: "cyan" } },
+        items: [],
+    });
+    const detail = blessed.box({
+        parent: ctx.container,
+        top: 0,
+        left: "62%",
+        width: "38%",
+        height: "100%",
+        border: { type: "line" },
+        label: " Detail ",
+        tags: true,
+        scrollable: true,
+        alwaysScroll: true,
+        scrollbar: { ch: " " },
+        style: { border: { fg: "cyan" } },
+        content: "",
+    });
+    function rowLabel(q) {
+        const shortId = q.sessionId.length > 16 ? q.sessionId.slice(0, 15) + "…" : q.sessionId.padEnd(16, " ");
+        const pend = q.pending > 0 ? `{yellow-fg}${q.pending} pending{/yellow-fg}` : "{gray-fg}0 pending{/gray-fg}";
+        const dl = q.deadLetter > 0 ? `  {red-fg}${q.deadLetter} dead{/red-fg}` : "";
+        return `${(0, util_1.escapeTags)(shortId)}  ${pend}${dl}`;
+    }
+    function buildDetail(q) {
+        if (q === undefined) {
+            return "{gray-fg}No queues for this project.{/gray-fg}";
+        }
+        const lines = [];
+        lines.push(`{bold}${(0, util_1.escapeTags)(q.sessionId)}{/bold}`);
+        lines.push("{gray-fg}" + "─".repeat(34) + "{/gray-fg}");
+        lines.push(`{gray-fg}pending jobs:{/gray-fg}   ${q.pending}`);
+        lines.push(`{gray-fg}snapshots:{/gray-fg}      ${q.snapshots}`);
+        lines.push(`{gray-fg}dead-letter:{/gray-fg}    ${q.deadLetter > 0 ? `{red-fg}${q.deadLetter}{/red-fg}` : "0"}`);
+        lines.push("");
+        lines.push("{gray-fg}d drain · l dead-letter (pick one to retry) · c clear dead-letter{/gray-fg}");
+        return lines.join("\n");
+    }
+    function render() {
+        if (queues.length === 0) {
+            list.setItems(["{gray-fg}(no queues){/gray-fg}"]);
+        }
+        else {
+            list.setItems(queues.map((q) => rowLabel(q)));
+            list.select((0, util_1.clamp)(index, 0, queues.length - 1));
+        }
+        const cur = queues.length === 0 ? undefined : queues[(0, util_1.clamp)(index, 0, queues.length - 1)];
+        detail.setContent(buildDetail(cur));
+        detail.setScroll(0);
+        ctx.screen.render();
+    }
+    function move(delta) {
+        if (queues.length === 0) {
+            return;
+        }
+        index = (0, util_1.clamp)(index + delta, 0, queues.length - 1);
+        render();
+    }
+    function current() {
+        return queues.length === 0 ? undefined : queues[(0, util_1.clamp)(index, 0, queues.length - 1)];
+    }
+    function refresh() {
+        queues = (0, read_1.listQueues)(projectDir);
+        index = (0, util_1.clamp)(index, 0, Math.max(0, queues.length - 1));
+        render();
+    }
+    async function drainSession() {
+        const q = current();
+        if (q === undefined) {
+            return;
+        }
+        await ctx.session.runWithOutput(`Drain ${q.sessionId}`, async () => {
+            const result = await (0, queue_1.drain)(projectDir, q.sessionId);
+            return `Drain result:\n${JSON.stringify(result, null, 2)}`;
+        });
+        refresh();
+    }
+    function entryLabel(e, i) {
+        if ("original" in e) {
+            return `#${i + 1}  ${e.original.id}  [${e.category}]  ${e.original.type}`;
+        }
+        return `#${i + 1}  (unparseable record)`;
+    }
+    function retryEntry(sessionId, entry) {
+        ctx.session.confirm(`Re-submit job ${entry.original.id} (${entry.original.type}) to the live queue?`, (yes) => {
+            if (!yes) {
+                return;
+            }
+            try {
+                if ((0, read_1.removeDeadLetterEntry)(projectDir, sessionId, entry.original.id)) {
+                    (0, queue_1.submit)(projectDir, sessionId, entry.original.type, entry.original.data, { id: entry.original.id });
+                    refresh();
+                    ctx.session.message(`Re-submitted ${entry.original.id}. It will ship on the next drain / flush.`);
+                }
+                else {
+                    ctx.session.message("Entry no longer present — refresh and try again.");
+                }
+            }
+            catch (e) {
+                ctx.session.message(`Retry failed: ${e instanceof Error ? e.message : String(e)}`);
+            }
+        });
+    }
+    function deadLetterManage() {
+        const q = current();
+        if (q === undefined) {
+            return;
+        }
+        const entries = (0, queue_1.readDeadLetterEntries)(projectDir, q.sessionId);
+        if (entries.length === 0) {
+            ctx.session.message(`No dead-letter entries for ${q.sessionId}.`);
+            return;
+        }
+        ctx.session.pick(`Dead-letter ${q.sessionId} — Enter to retry · Esc to close`, entries.map((e, i) => entryLabel(e, i)), (idx) => {
+            if (idx < 0 || idx >= entries.length) {
+                return;
+            }
+            const entry = entries[idx];
+            if (!("original" in entry)) {
+                ctx.session.message("That record couldn't be parsed — not retryable.");
+                return;
+            }
+            retryEntry(q.sessionId, entry);
+        });
+    }
+    function clearDeadLetter() {
+        const q = current();
+        if (q === undefined || q.deadLetter === 0) {
+            return;
+        }
+        ctx.session.confirm(`Clear ${q.deadLetter} dead-letter entr${q.deadLetter === 1 ? "y" : "ies"} for ${q.sessionId}?`, (yes) => {
+            if (!yes) {
+                return;
+            }
+            try {
+                const main = (0, queue_1.deadLetterFile)(projectDir, q.sessionId);
+                if ((0, fs_1.existsSync)(main)) {
+                    (0, fs_1.writeFileSync)(main, "");
+                }
+                const dir = (0, queue_1.queueDir)(projectDir, q.sessionId);
+                if ((0, fs_1.existsSync)(dir)) {
+                    for (const name of (0, fs_1.readdirSync)(dir)) {
+                        if (queue_1.DEAD_LETTER_ROTATED_REGEX.test(name)) {
+                            (0, fs_1.unlinkSync)((0, path_1.join)(dir, name));
+                        }
+                    }
+                }
+                refresh();
+            }
+            catch (e) {
+                ctx.session.message(`Clear failed: ${e instanceof Error ? e.message : String(e)}`);
+            }
+        });
+    }
+    list.key(["up", "k"], () => move(-1));
+    list.key(["down", "j"], () => move(1));
+    function deadLetterStatsView() {
+        const q = current();
+        if (q === undefined) {
+            return;
+        }
+        const entries = (0, queue_1.readDeadLetterEntries)(projectDir, q.sessionId);
+        if (entries.length === 0) {
+            ctx.session.message(`No dead-letter entries for ${q.sessionId}.`);
+            return;
+        }
+        const stats = (0, read_1.deadLetterStats)(entries);
+        const lines = [
+            `{bold}Dead-letter stats — ${(0, util_1.escapeTags)(q.sessionId)}{/bold}`,
+            "{gray-fg}" + "─".repeat(34) + "{/gray-fg}",
+            `total: {bold}${stats.total}{/bold}`,
+            "",
+        ];
+        for (const cat of Object.keys(stats.byCategory).sort()) {
+            lines.push(`  ${(0, util_1.escapeTags)(cat)}: {bold}${stats.byCategory[cat]}{/bold}`);
+        }
+        ctx.session.showPane(`Dead-letter stats — ${q.sessionId}`, lines.join("\n"));
+    }
+    async function drainAll() {
+        await ctx.session.runWithOutput("Drain — all sessions", async () => {
+            const all = (0, read_1.listQueues)(projectDir);
+            if (all.length === 0) {
+                return "No sessions to drain.";
+            }
+            for (const sq of all) {
+                const result = await (0, queue_1.drain)(projectDir, sq.sessionId);
+                console.log(`${sq.sessionId}: ${JSON.stringify(result)}`);
+            }
+            return `\nDrained ${all.length} session(s).`;
+        });
+        refresh();
+    }
+    function purgeSnapshotsFlow() {
+        ctx.session.confirm("Purge ALL pending queue snapshots for this project, WITHOUT processing them? (destructive)", (yes) => {
+            if (!yes) {
+                return;
+            }
+            try {
+                const n = (0, read_1.purgeSnapshots)(projectDir);
+                refresh();
+                ctx.session.message(`Purged ${n} snapshot file(s).`);
+            }
+            catch (e) {
+                ctx.session.message(`Purge failed: ${e instanceof Error ? e.message : String(e)}`);
+            }
+        });
+    }
+    function purgeOldSessionsFlow() {
+        ctx.session.prompt("Remove EMPTY session queues older than (e.g. 14d, 2w, 6m, 12h):", "14d", (raw) => {
+            if (raw === null || raw.trim().length === 0) {
+                return;
+            }
+            const ms = (0, import_1.parseSinceDuration)(raw.trim());
+            if (ms === null) {
+                ctx.session.message(`Invalid duration "${raw.trim()}". Use forms like 14d, 2w, 6m, 12h.`);
+                return;
+            }
+            ctx.session.confirm(`Remove empty session queue dirs older than ${raw.trim()}? (destructive)`, (yes) => {
+                if (!yes) {
+                    return;
+                }
+                try {
+                    const n = (0, read_1.purgeOldSessions)(projectDir, ms);
+                    refresh();
+                    ctx.session.message(`Removed ${n} old empty queue dir(s).`);
+                }
+                catch (e) {
+                    ctx.session.message(`Purge failed: ${e instanceof Error ? e.message : String(e)}`);
+                }
+            });
+        });
+    }
+    function purge() {
+        ctx.session.pick("Purge what?", ["Pending snapshots (all sessions, no processing)", "Old empty session queues (older-than…)"], (idx) => {
+            if (idx === 0) {
+                purgeSnapshotsFlow();
+            }
+            else if (idx === 1) {
+                purgeOldSessionsFlow();
+            }
+        });
+    }
+    list.key(["d"], () => { void drainSession(); });
+    list.key(["S-d"], () => { void drainAll(); });
+    list.key(["l"], () => deadLetterManage());
+    list.key(["s"], () => deadLetterStatsView());
+    list.key(["c"], () => clearDeadLetter());
+    list.key(["p"], () => purge());
+    list.key(["r"], () => refresh());
+    ctx.setStatus(STATUS);
+    render();
+    list.focus();
+    ctx.screen.render();
+    return {
+        unmount() {
+            list.destroy();
+            detail.destroy();
+        },
+    };
+}
+exports.queueArea = {
+    id: "queue",
+    title: "Queue",
+    summary: "Per-session job queue: drain · dead-letter view/retry/clear/stats · purge",
+    mount(ctx) {
+        return mountQueueView(ctx);
+    },
+};
+//# sourceMappingURL=area.js.map

package/dist/tui/queue/area.js.map

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

package/dist/tui/queue/read.d.ts

@@ -0,0 +1,49 @@
+/**
+ * IronBee — Queue area: pure reader
+ *
+ * Summarizes the file-backed job queue per session by counting lines in the
+ * queue artifacts under `<projectDir>/.ironbee/sessions/<id>/queue/`:
+ *   - pending   = live `jobs.jsonl` + frozen `jobs-<uuid>.jsonl` snapshots
+ *   - deadLetter = `dead-letter.jsonl` + rotated `dead-letter-<uuid>.jsonl`
+ * fs-only, no blessed; unit-tested independently.
+ */
+import { DeadLetterEntry } from "../../queue";
+/** One session's queue counts. */
+export interface QueueSummary {
+    sessionId: string;
+    pending: number;
+    snapshots: number;
+    deadLetter: number;
+}
+/**
+ * Summarize the queue for every session under a project. Returns `[]` when the
+ * project has no `.ironbee/sessions` directory. Sessions without a `queue/`
+ * subdir are included with zero counts.
+ */
+export declare function listQueues(projectDir: string): QueueSummary[];
+/**
+ * Remove the dead-letter entry whose `original.id === jobId` from the session's
+ * `dead-letter.jsonl` (atomic tmp+rename, keeping all other lines). Returns
+ * `true` when an entry was removed. Mirrors the `ironbee queue dead-letter
+ * retry` rewrite; the caller re-submits the job afterward. fs-only, unit-tested.
+ */
+export declare function removeDeadLetterEntry(projectDir: string, sessionId: string, jobId: string): boolean;
+/**
+ * Delete all frozen snapshot files (`jobs-<uuid>.jsonl`) across every session's
+ * queue dir WITHOUT processing them. Returns the number deleted. Mirrors
+ * `ironbee queue purge --snapshots` (destructive). fs-only, unit-tested.
+ */
+export declare function purgeSnapshots(projectDir: string): number;
+/**
+ * Remove queue/ subdirs that are BOTH empty (no pending jobs, no snapshots, no
+ * dead-letter) AND older than `olderThanMs`. Returns the number removed. Mirrors
+ * `ironbee queue purge --sessions older-than=<dur>` (the safety rule — never
+ * remove a dir with undelivered work). fs-only, unit-tested.
+ */
+export declare function purgeOldSessions(projectDir: string, olderThanMs: number): number;
+/** Histogram of dead-letter entries by category (the `dead-letter stats` view). */
+export declare function deadLetterStats(entries: DeadLetterEntry[]): {
+    total: number;
+    byCategory: Record<string, number>;
+};
+//# sourceMappingURL=read.d.ts.map

package/dist/tui/queue/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../src/tui/queue/read.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAkB,eAAe,EAA2B,MAAM,aAAa,CAAC;AAEvF,kCAAkC;AAClC,MAAM,WAAW,YAAY;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACtB;AA+CD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,EAAE,CAoB7D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAmDnG;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAqCzD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAyChF;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAOjH"}

package/dist/tui/queue/read.js

@@ -0,0 +1,261 @@
+"use strict";
+/**
+ * IronBee — Queue area: pure reader
+ *
+ * Summarizes the file-backed job queue per session by counting lines in the
+ * queue artifacts under `<projectDir>/.ironbee/sessions/<id>/queue/`:
+ *   - pending   = live `jobs.jsonl` + frozen `jobs-<uuid>.jsonl` snapshots
+ *   - deadLetter = `dead-letter.jsonl` + rotated `dead-letter-<uuid>.jsonl`
+ * fs-only, no blessed; unit-tested independently.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listQueues = listQueues;
+exports.removeDeadLetterEntry = removeDeadLetterEntry;
+exports.purgeSnapshots = purgeSnapshots;
+exports.purgeOldSessions = purgeOldSessions;
+exports.deadLetterStats = deadLetterStats;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const queue_1 = require("../../queue");
+function countLines(filePath) {
+    try {
+        const raw = (0, fs_1.readFileSync)(filePath, "utf-8");
+        return raw.split("\n").filter((l) => l.trim().length > 0).length;
+    }
+    catch {
+        return 0;
+    }
+}
+function isFile(filePath) {
+    try {
+        return (0, fs_1.statSync)(filePath).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/** Summarize one session's queue dir. */
+function readQueueDir(queueDir, sessionId) {
+    let pending = 0;
+    let snapshots = 0;
+    let deadLetter = 0;
+    let names = [];
+    try {
+        names = (0, fs_1.readdirSync)(queueDir);
+    }
+    catch {
+        names = [];
+    }
+    for (const name of names) {
+        const full = (0, path_1.join)(queueDir, name);
+        if (!isFile(full)) {
+            continue;
+        }
+        if (name === "jobs.jsonl") {
+            pending += countLines(full);
+        }
+        else if (/^jobs-.*\.jsonl$/.test(name)) {
+            snapshots += 1;
+            pending += countLines(full);
+        }
+        else if (name === "dead-letter.jsonl" || /^dead-letter-.*\.jsonl$/.test(name)) {
+            deadLetter += countLines(full);
+        }
+    }
+    return { sessionId, pending, snapshots, deadLetter };
+}
+/**
+ * Summarize the queue for every session under a project. Returns `[]` when the
+ * project has no `.ironbee/sessions` directory. Sessions without a `queue/`
+ * subdir are included with zero counts.
+ */
+function listQueues(projectDir) {
+    const sessionsDir = (0, path_1.join)(projectDir, ".ironbee", "sessions");
+    if (!(0, fs_1.existsSync)(sessionsDir)) {
+        return [];
+    }
+    let ids;
+    try {
+        ids = (0, fs_1.readdirSync)(sessionsDir, { withFileTypes: true })
+            .filter((d) => d.isDirectory())
+            .map((d) => d.name);
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const id of ids) {
+        const queueDir = (0, path_1.join)(sessionsDir, id, "queue");
+        out.push((0, fs_1.existsSync)(queueDir) ? readQueueDir(queueDir, id) : { sessionId: id, pending: 0, snapshots: 0, deadLetter: 0 });
+    }
+    return out;
+}
+/**
+ * Remove the dead-letter entry whose `original.id === jobId` from the session's
+ * `dead-letter.jsonl` (atomic tmp+rename, keeping all other lines). Returns
+ * `true` when an entry was removed. Mirrors the `ironbee queue dead-letter
+ * retry` rewrite; the caller re-submits the job afterward. fs-only, unit-tested.
+ */
+function removeDeadLetterEntry(projectDir, sessionId, jobId) {
+    const dlPath = (0, queue_1.deadLetterFile)(projectDir, sessionId);
+    if (!(0, fs_1.existsSync)(dlPath)) {
+        return false;
+    }
+    let content;
+    try {
+        content = (0, fs_1.readFileSync)(dlPath, "utf-8");
+    }
+    catch {
+        return false;
+    }
+    const kept = [];
+    let removed = false;
+    for (const line of content.split("\n")) {
+        if (line.length === 0) {
+            continue;
+        }
+        if (!removed) {
+            try {
+                const parsed = JSON.parse(line);
+                if (parsed !== null && typeof parsed === "object" && "original" in parsed) {
+                    const original = parsed.original;
+                    if (original !== null && typeof original === "object" && original.id === jobId) {
+                        removed = true;
+                        continue;
+                    }
+                }
+            }
+            catch {
+                // keep malformed lines — never risk data loss
+            }
+        }
+        kept.push(line);
+    }
+    if (!removed) {
+        return false;
+    }
+    const tmp = `${dlPath}.tmp-${process.pid}-${Date.now()}`;
+    try {
+        (0, fs_1.writeFileSync)(tmp, kept.length > 0 ? kept.join("\n") + "\n" : "");
+        (0, fs_1.renameSync)(tmp, dlPath);
+    }
+    catch {
+        try {
+            if ((0, fs_1.existsSync)(tmp)) {
+                (0, fs_1.unlinkSync)(tmp);
+            }
+        }
+        catch {
+            // best-effort cleanup
+        }
+        return false;
+    }
+    return true;
+}
+/**
+ * Delete all frozen snapshot files (`jobs-<uuid>.jsonl`) across every session's
+ * queue dir WITHOUT processing them. Returns the number deleted. Mirrors
+ * `ironbee queue purge --snapshots` (destructive). fs-only, unit-tested.
+ */
+function purgeSnapshots(projectDir) {
+    const sessionsDir = (0, path_1.join)(projectDir, ".ironbee", "sessions");
+    if (!(0, fs_1.existsSync)(sessionsDir)) {
+        return 0;
+    }
+    let ids;
+    try {
+        ids = (0, fs_1.readdirSync)(sessionsDir, { withFileTypes: true })
+            .filter((d) => d.isDirectory())
+            .map((d) => d.name);
+    }
+    catch {
+        return 0;
+    }
+    let removed = 0;
+    for (const id of ids) {
+        const qdir = (0, path_1.join)(sessionsDir, id, "queue");
+        if (!(0, fs_1.existsSync)(qdir)) {
+            continue;
+        }
+        let names;
+        try {
+            names = (0, fs_1.readdirSync)(qdir);
+        }
+        catch {
+            continue;
+        }
+        for (const name of names) {
+            if (queue_1.SNAPSHOT_FILENAME_REGEX.test(name)) {
+                try {
+                    (0, fs_1.unlinkSync)((0, path_1.join)(qdir, name));
+                    removed += 1;
+                }
+                catch {
+                    // best-effort
+                }
+            }
+        }
+    }
+    return removed;
+}
+/**
+ * Remove queue/ subdirs that are BOTH empty (no pending jobs, no snapshots, no
+ * dead-letter) AND older than `olderThanMs`. Returns the number removed. Mirrors
+ * `ironbee queue purge --sessions older-than=<dur>` (the safety rule — never
+ * remove a dir with undelivered work). fs-only, unit-tested.
+ */
+function purgeOldSessions(projectDir, olderThanMs) {
+    const cutoff = Date.now() - olderThanMs;
+    const sessionsDir = (0, path_1.join)(projectDir, ".ironbee", "sessions");
+    if (!(0, fs_1.existsSync)(sessionsDir)) {
+        return 0;
+    }
+    let ids;
+    try {
+        ids = (0, fs_1.readdirSync)(sessionsDir, { withFileTypes: true })
+            .filter((d) => d.isDirectory())
+            .map((d) => d.name);
+    }
+    catch {
+        return 0;
+    }
+    let removed = 0;
+    for (const id of ids) {
+        const qdir = (0, path_1.join)(sessionsDir, id, "queue");
+        if (!(0, fs_1.existsSync)(qdir)) {
+            continue;
+        }
+        const summary = readQueueDir(qdir, id);
+        if (summary.pending > 0 || summary.snapshots > 0 || summary.deadLetter > 0) {
+            continue;
+        }
+        let mtimeMs;
+        try {
+            mtimeMs = (0, fs_1.statSync)(qdir).mtimeMs;
+        }
+        catch {
+            continue;
+        }
+        if (mtimeMs > cutoff) {
+            continue;
+        }
+        try {
+            (0, fs_1.rmSync)(qdir, { recursive: true, force: true });
+            removed += 1;
+        }
+        catch {
+            // best-effort
+        }
+    }
+    return removed;
+}
+/** Histogram of dead-letter entries by category (the `dead-letter stats` view). */
+function deadLetterStats(entries) {
+    const byCategory = {};
+    for (const e of entries) {
+        const cat = "category" in e && typeof e.category === "string" ? e.category : "(unknown)";
+        byCategory[cat] = (byCategory[cat] ?? 0) + 1;
+    }
+    return { total: entries.length, byCategory };
+}
+//# sourceMappingURL=read.js.map