@ironbee-ai/cli 0.5.3 → 0.6.1

package/dist/queue/index.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * IronBee CLI — Queue Module
+ *
+ * File-backed, crash-safe, concurrency-safe background job queue.
+ * Canonical spec: docs/job-queue.md.
+ *
+ * Public API:
+ *   - submit(projectDir, sessionId, type, data, opts?)  → job_id
+ *   - snapshot(projectDir, sessionId)                   → snapshot_path | null
+ *   - processFile(path, opts?)                          → void
+ *   - drain(projectDir, sessionId, opts?)               → DrainResult
+ *   - register(type, handler) / unregister(type)
+ *   - spawnDetachedWorker(snapshotPath)
+ *
+ * Error classes:
+ *   InvalidSessionIdError, JobTooLargeError, IOError,
+ *   TransientError, AuthError, BadRequestError, BadRequestBatchError
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readDeadLetterEntries = exports.WORKER_LOG_ROTATED_REGEX = exports.DEAD_LETTER_ROTATED_REGEX = exports.SNAPSHOT_FILENAME_REGEX = exports.parseSnapshotPath = exports.workerLogFile = exports.deadLetterFile = exports.snapshotFile = exports.liveQueueFile = exports.queueDir = exports.sessionDir = exports.sessionsRoot = exports.validateSessionId = exports.resolveProjectDir = exports.MAX_LINE_BYTES = exports.BadRequestBatchError = exports.BadRequestError = exports.AuthError = exports.TransientError = exports.IOError = exports.JobTooLargeError = exports.InvalidSessionIdError = exports.snapshotRegistry = exports.getHandler = exports.clearRegistry = exports.unregister = exports.register = exports.SEND_EVENT_TYPE = exports.registerQueueHandlers = exports.DEFAULT_AUTO_FLUSH_SIZE_BYTES = exports.maybeAutoFlush = exports.flushSynchronously = exports.flushInBackground = exports.spawnDetachedWorker = exports.drain = exports.processFile = exports.snapshot = exports.submit = void 0;
+var submit_1 = require("./submit");
+Object.defineProperty(exports, "submit", { enumerable: true, get: function () { return submit_1.submit; } });
+var snapshot_1 = require("./snapshot");
+Object.defineProperty(exports, "snapshot", { enumerable: true, get: function () { return snapshot_1.snapshot; } });
+var process_file_1 = require("./process-file");
+Object.defineProperty(exports, "processFile", { enumerable: true, get: function () { return process_file_1.processFile; } });
+var drain_1 = require("./drain");
+Object.defineProperty(exports, "drain", { enumerable: true, get: function () { return drain_1.drain; } });
+var spawn_1 = require("./spawn");
+Object.defineProperty(exports, "spawnDetachedWorker", { enumerable: true, get: function () { return spawn_1.spawnDetachedWorker; } });
+var flush_1 = require("./flush");
+Object.defineProperty(exports, "flushInBackground", { enumerable: true, get: function () { return flush_1.flushInBackground; } });
+Object.defineProperty(exports, "flushSynchronously", { enumerable: true, get: function () { return flush_1.flushSynchronously; } });
+Object.defineProperty(exports, "maybeAutoFlush", { enumerable: true, get: function () { return flush_1.maybeAutoFlush; } });
+Object.defineProperty(exports, "DEFAULT_AUTO_FLUSH_SIZE_BYTES", { enumerable: true, get: function () { return flush_1.DEFAULT_AUTO_FLUSH_SIZE_BYTES; } });
+var register_handlers_1 = require("./register-handlers");
+Object.defineProperty(exports, "registerQueueHandlers", { enumerable: true, get: function () { return register_handlers_1.registerQueueHandlers; } });
+Object.defineProperty(exports, "SEND_EVENT_TYPE", { enumerable: true, get: function () { return register_handlers_1.SEND_EVENT_TYPE; } });
+var registry_1 = require("./registry");
+Object.defineProperty(exports, "register", { enumerable: true, get: function () { return registry_1.register; } });
+Object.defineProperty(exports, "unregister", { enumerable: true, get: function () { return registry_1.unregister; } });
+Object.defineProperty(exports, "clearRegistry", { enumerable: true, get: function () { return registry_1.clear; } });
+Object.defineProperty(exports, "getHandler", { enumerable: true, get: function () { return registry_1.get; } });
+Object.defineProperty(exports, "snapshotRegistry", { enumerable: true, get: function () { return registry_1.snapshotRegistry; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "InvalidSessionIdError", { enumerable: true, get: function () { return types_1.InvalidSessionIdError; } });
+Object.defineProperty(exports, "JobTooLargeError", { enumerable: true, get: function () { return types_1.JobTooLargeError; } });
+Object.defineProperty(exports, "IOError", { enumerable: true, get: function () { return types_1.IOError; } });
+Object.defineProperty(exports, "TransientError", { enumerable: true, get: function () { return types_1.TransientError; } });
+Object.defineProperty(exports, "AuthError", { enumerable: true, get: function () { return types_1.AuthError; } });
+Object.defineProperty(exports, "BadRequestError", { enumerable: true, get: function () { return types_1.BadRequestError; } });
+Object.defineProperty(exports, "BadRequestBatchError", { enumerable: true, get: function () { return types_1.BadRequestBatchError; } });
+Object.defineProperty(exports, "MAX_LINE_BYTES", { enumerable: true, get: function () { return types_1.MAX_LINE_BYTES; } });
+var paths_1 = require("./paths");
+Object.defineProperty(exports, "resolveProjectDir", { enumerable: true, get: function () { return paths_1.resolveProjectDir; } });
+Object.defineProperty(exports, "validateSessionId", { enumerable: true, get: function () { return paths_1.validateSessionId; } });
+Object.defineProperty(exports, "sessionsRoot", { enumerable: true, get: function () { return paths_1.sessionsRoot; } });
+Object.defineProperty(exports, "sessionDir", { enumerable: true, get: function () { return paths_1.sessionDir; } });
+Object.defineProperty(exports, "queueDir", { enumerable: true, get: function () { return paths_1.queueDir; } });
+Object.defineProperty(exports, "liveQueueFile", { enumerable: true, get: function () { return paths_1.liveQueueFile; } });
+Object.defineProperty(exports, "snapshotFile", { enumerable: true, get: function () { return paths_1.snapshotFile; } });
+Object.defineProperty(exports, "deadLetterFile", { enumerable: true, get: function () { return paths_1.deadLetterFile; } });
+Object.defineProperty(exports, "workerLogFile", { enumerable: true, get: function () { return paths_1.workerLogFile; } });
+Object.defineProperty(exports, "parseSnapshotPath", { enumerable: true, get: function () { return paths_1.parseSnapshotPath; } });
+Object.defineProperty(exports, "SNAPSHOT_FILENAME_REGEX", { enumerable: true, get: function () { return paths_1.SNAPSHOT_FILENAME_REGEX; } });
+Object.defineProperty(exports, "DEAD_LETTER_ROTATED_REGEX", { enumerable: true, get: function () { return paths_1.DEAD_LETTER_ROTATED_REGEX; } });
+Object.defineProperty(exports, "WORKER_LOG_ROTATED_REGEX", { enumerable: true, get: function () { return paths_1.WORKER_LOG_ROTATED_REGEX; } });
+var dead_letter_1 = require("./dead-letter");
+Object.defineProperty(exports, "readDeadLetterEntries", { enumerable: true, get: function () { return dead_letter_1.readDeadLetterEntries; } });
+//# sourceMappingURL=index.js.map

package/dist/queue/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/queue/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;AAEH,mCAAiD;AAAxC,gGAAA,MAAM,OAAA;AACf,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AACjB,+CAAiE;AAAxD,2GAAA,WAAW,OAAA;AACpB,iCAA2D;AAAlD,8FAAA,KAAK,OAAA;AACd,iCAA8C;AAArC,4GAAA,mBAAmB,OAAA;AAC5B,iCAA+G;AAAtG,0GAAA,iBAAiB,OAAA;AAAE,2GAAA,kBAAkB,OAAA;AAAE,uGAAA,cAAc,OAAA;AAAE,sHAAA,6BAA6B,OAAA;AAC7F,yDAA6E;AAApE,0HAAA,qBAAqB,OAAA;AAAE,oHAAA,eAAe,OAAA;AAC/C,uCAQoB;AALhB,oGAAA,QAAQ,OAAA;AACR,sGAAA,UAAU,OAAA;AACV,yGAAA,KAAK,OAAiB;AACtB,sGAAA,GAAG,OAAc;AACjB,4GAAA,gBAAgB,OAAA;AAEpB,iCAaiB;AAZb,8GAAA,qBAAqB,OAAA;AACrB,yGAAA,gBAAgB,OAAA;AAChB,gGAAA,OAAO,OAAA;AACP,uGAAA,cAAc,OAAA;AACd,kGAAA,SAAS,OAAA;AACT,wGAAA,eAAe,OAAA;AACf,6GAAA,oBAAoB,OAAA;AAKpB,uGAAA,cAAc,OAAA;AAElB,iCAciB;AAbb,0GAAA,iBAAiB,OAAA;AACjB,0GAAA,iBAAiB,OAAA;AACjB,qGAAA,YAAY,OAAA;AACZ,mGAAA,UAAU,OAAA;AACV,iGAAA,QAAQ,OAAA;AACR,sGAAA,aAAa,OAAA;AACb,qGAAA,YAAY,OAAA;AACZ,uGAAA,cAAc,OAAA;AACd,sGAAA,aAAa,OAAA;AACb,0GAAA,iBAAiB,OAAA;AACjB,gHAAA,uBAAuB,OAAA;AACvB,kHAAA,yBAAyB,OAAA;AACzB,iHAAA,wBAAwB,OAAA;AAE5B,6CAAsD;AAA7C,oHAAA,qBAAqB,OAAA"}

package/dist/queue/paths.d.ts

@@ -0,0 +1,40 @@
+/**
+ * IronBee CLI — Queue Path Resolution & Session Validation
+ *
+ * See docs/job-queue.md §2.1 (session dir), §5.1 step 1 (sessionId rules),
+ * §5.5 (snapshot filename regex), §9.4 (project dir resolution).
+ */
+export declare const SNAPSHOT_FILENAME_REGEX: RegExp;
+export declare const DEAD_LETTER_ROTATED_REGEX: RegExp;
+export declare const WORKER_LOG_ROTATED_REGEX: RegExp;
+export declare const SESSION_ID_MAX_LEN: number;
+/**
+ * Resolve the project directory using the same convention as the CLI's
+ * existing hooks: env-var overrides → cwd().
+ */
+export declare function resolveProjectDir(override?: string): string;
+/**
+ * Validate a session identifier per §5.1 step 1. Throws InvalidSessionIdError
+ * on any rule violation to prevent path-escape attacks.
+ */
+export declare function validateSessionId(sessionId: string): void;
+export declare function sessionsRoot(projectDir: string): string;
+export declare function sessionDir(projectDir: string, sessionId: string): string;
+export declare function queueDir(projectDir: string, sessionId: string): string;
+export declare function liveQueueFile(projectDir: string, sessionId: string): string;
+export declare function snapshotFile(projectDir: string, sessionId: string, snapshotId: string): string;
+export declare function deadLetterFile(projectDir: string, sessionId: string): string;
+export declare function workerLogFile(projectDir: string, sessionId: string): string;
+/**
+ * Given an absolute snapshot path, derive (projectDir, sessionId, filename).
+ * Path shape: `<projectDir>/.ironbee/sessions/<sessionId>/queue/jobs-<UUID>.jsonl`.
+ *
+ * Uses `path.dirname` so both POSIX ("/a/b") and Windows ("C:\a\b")
+ * separators round-trip cleanly without mangling into forward-slashes.
+ */
+export declare function parseSnapshotPath(snapshotPath: string): {
+    projectDir: string;
+    sessionId: string;
+    filename: string;
+};
+//# sourceMappingURL=paths.d.ts.map

package/dist/queue/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/queue/paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,eAAO,MAAM,uBAAuB,EAAE,MAA4F,CAAC;AACnI,eAAO,MAAM,yBAAyB,EAAE,MAAmG,CAAC;AAC5I,eAAO,MAAM,wBAAwB,EAAE,MAA4F,CAAC;AACpI,eAAO,MAAM,kBAAkB,EAAE,MAAY,CAAC;AAE9C;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAM3D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAmBzD;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAE9F;AAED,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAoBnH"}

package/dist/queue/paths.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * IronBee CLI — Queue Path Resolution & Session Validation
+ *
+ * See docs/job-queue.md §2.1 (session dir), §5.1 step 1 (sessionId rules),
+ * §5.5 (snapshot filename regex), §9.4 (project dir resolution).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SESSION_ID_MAX_LEN = exports.WORKER_LOG_ROTATED_REGEX = exports.DEAD_LETTER_ROTATED_REGEX = exports.SNAPSHOT_FILENAME_REGEX = void 0;
+exports.resolveProjectDir = resolveProjectDir;
+exports.validateSessionId = validateSessionId;
+exports.sessionsRoot = sessionsRoot;
+exports.sessionDir = sessionDir;
+exports.queueDir = queueDir;
+exports.liveQueueFile = liveQueueFile;
+exports.snapshotFile = snapshotFile;
+exports.deadLetterFile = deadLetterFile;
+exports.workerLogFile = workerLogFile;
+exports.parseSnapshotPath = parseSnapshotPath;
+const path_1 = require("path");
+const types_1 = require("./types");
+exports.SNAPSHOT_FILENAME_REGEX = /^jobs-[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}\.jsonl$/;
+exports.DEAD_LETTER_ROTATED_REGEX = /^dead-letter-[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}\.jsonl$/;
+exports.WORKER_LOG_ROTATED_REGEX = /^worker-[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}\.log$/;
+exports.SESSION_ID_MAX_LEN = 128;
+/**
+ * Resolve the project directory using the same convention as the CLI's
+ * existing hooks: env-var overrides → cwd().
+ */
+function resolveProjectDir(override) {
+    return override
+        ?? process.env.IRONBEE_PROJECT_DIR
+        ?? process.env.CLAUDE_PROJECT_DIR
+        ?? process.env.CURSOR_PROJECT_DIR
+        ?? process.cwd();
+}
+/**
+ * Validate a session identifier per §5.1 step 1. Throws InvalidSessionIdError
+ * on any rule violation to prevent path-escape attacks.
+ */
+function validateSessionId(sessionId) {
+    if (typeof sessionId !== "string" || sessionId.length === 0) {
+        throw new types_1.InvalidSessionIdError("session id is empty");
+    }
+    if (sessionId.length > exports.SESSION_ID_MAX_LEN) {
+        throw new types_1.InvalidSessionIdError(`session id exceeds ${exports.SESSION_ID_MAX_LEN} chars`);
+    }
+    if (sessionId === "." || sessionId === "..") {
+        throw new types_1.InvalidSessionIdError("session id is a reserved path component");
+    }
+    for (let i = 0; i < sessionId.length; i++) {
+        const code = sessionId.charCodeAt(i);
+        if (code < 0x20 || code === 0x7f) {
+            throw new types_1.InvalidSessionIdError("session id contains ASCII control character");
+        }
+    }
+    if (sessionId.includes("/") || sessionId.includes("\\") || sessionId.includes("\0")) {
+        throw new types_1.InvalidSessionIdError("session id contains path separator or null byte");
+    }
+}
+function sessionsRoot(projectDir) {
+    return (0, path_1.join)(projectDir, ".ironbee", "sessions");
+}
+function sessionDir(projectDir, sessionId) {
+    return (0, path_1.join)(sessionsRoot(projectDir), sessionId);
+}
+function queueDir(projectDir, sessionId) {
+    return (0, path_1.join)(sessionDir(projectDir, sessionId), "queue");
+}
+function liveQueueFile(projectDir, sessionId) {
+    return (0, path_1.join)(queueDir(projectDir, sessionId), "jobs.jsonl");
+}
+function snapshotFile(projectDir, sessionId, snapshotId) {
+    return (0, path_1.join)(queueDir(projectDir, sessionId), `jobs-${snapshotId}.jsonl`);
+}
+function deadLetterFile(projectDir, sessionId) {
+    return (0, path_1.join)(queueDir(projectDir, sessionId), "dead-letter.jsonl");
+}
+function workerLogFile(projectDir, sessionId) {
+    return (0, path_1.join)(queueDir(projectDir, sessionId), "worker.log");
+}
+/**
+ * Given an absolute snapshot path, derive (projectDir, sessionId, filename).
+ * Path shape: `<projectDir>/.ironbee/sessions/<sessionId>/queue/jobs-<UUID>.jsonl`.
+ *
+ * Uses `path.dirname` so both POSIX ("/a/b") and Windows ("C:\a\b")
+ * separators round-trip cleanly without mangling into forward-slashes.
+ */
+function parseSnapshotPath(snapshotPath) {
+    const filename = (0, path_1.basename)(snapshotPath);
+    const queueSegmentDir = (0, path_1.dirname)(snapshotPath);
+    const sessionSegmentDir = (0, path_1.dirname)(queueSegmentDir);
+    const sessionsSegmentDir = (0, path_1.dirname)(sessionSegmentDir);
+    const ironbeeSegmentDir = (0, path_1.dirname)(sessionsSegmentDir);
+    const projectDir = (0, path_1.dirname)(ironbeeSegmentDir);
+    if ((0, path_1.basename)(queueSegmentDir) !== "queue"
+        || (0, path_1.basename)(sessionsSegmentDir) !== "sessions"
+        || (0, path_1.basename)(ironbeeSegmentDir) !== ".ironbee") {
+        throw new Error(`snapshot path is not under a valid session queue dir: ${snapshotPath}`);
+    }
+    const sessionId = (0, path_1.basename)(sessionSegmentDir);
+    if (sessionId.length === 0 || sessionId === ".") {
+        throw new Error(`snapshot path is not under a valid session queue dir: ${snapshotPath}`);
+    }
+    return { projectDir, sessionId, filename };
+}
+//# sourceMappingURL=paths.js.map

package/dist/queue/paths.js.map

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

package/dist/queue/process-file.d.ts

@@ -0,0 +1,22 @@
+/**
+ * IronBee CLI — Queue processFile() worker
+ *
+ * See docs/job-queue.md §5.3.
+ */
+import { HandlerRegistry } from "./registry";
+export interface ProcessFileOptions {
+    /** Override the registry for tests. Falls back to the global snapshot. */
+    registry?: HandlerRegistry;
+}
+/**
+ * Process one snapshot file end-to-end.
+ *
+ * Deletes the file only when every line has reached a terminal state
+ * (delivered OR dead-lettered). On transient/auth failure or a transient
+ * during per-job fallback, the file is left on disk for later retry.
+ *
+ * Never throws — all errors are logged to worker.log and classified
+ * per §5.3.
+ */
+export declare function processFile(path: string, opts?: ProcessFileOptions): Promise<void>;
+//# sourceMappingURL=process-file.d.ts.map

package/dist/queue/process-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-file.d.ts","sourceRoot":"","sources":["../../src/queue/process-file.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,OAAO,EAAW,eAAe,EAAoB,MAAM,YAAY,CAAC;AASxE,MAAM,WAAW,kBAAkB;IAC/B,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC9B;AAED;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8JxF"}

package/dist/queue/process-file.js

@@ -0,0 +1,257 @@
+"use strict";
+/**
+ * IronBee CLI — Queue processFile() worker
+ *
+ * See docs/job-queue.md §5.3.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.processFile = processFile;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const readline_1 = require("readline");
+const types_1 = require("./types");
+const paths_1 = require("./paths");
+const registry_1 = require("./registry");
+const dead_letter_1 = require("./dead-letter");
+const worker_log_1 = require("./worker-log");
+/**
+ * Process one snapshot file end-to-end.
+ *
+ * Deletes the file only when every line has reached a terminal state
+ * (delivered OR dead-lettered). On transient/auth failure or a transient
+ * during per-job fallback, the file is left on disk for later retry.
+ *
+ * Never throws — all errors are logged to worker.log and classified
+ * per §5.3.
+ */
+async function processFile(path, opts) {
+    if (!(0, fs_1.existsSync)(path)) {
+        return;
+    }
+    const { projectDir, sessionId } = (0, paths_1.parseSnapshotPath)(path);
+    const log = new worker_log_1.WorkerLog(projectDir, sessionId);
+    const registry = opts?.registry ?? (0, registry_1.snapshotRegistry)();
+    // Phase 1: streaming read + parse
+    const parsed = [];
+    const parseErrors = [];
+    try {
+        await readLinesStreaming(path, (line) => {
+            if (line.length === 0) {
+                return;
+            }
+            try {
+                const obj = JSON.parse(line);
+                if (!isJob(obj)) {
+                    parseErrors.push({ raw: line, message: "not a valid job envelope" });
+                    return;
+                }
+                parsed.push(obj);
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
+                parseErrors.push({ raw: line, message: msg });
+            }
+        });
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        log.error(`failed to read ${path}: ${msg}; leaving file`);
+        return;
+    }
+    log.info(`START path=${path} lines=${parsed.length + parseErrors.length} parse_errors=${parseErrors.length}`);
+    // Empty registry + non-empty snapshot is almost always a wiring bug (the
+    // CLI entry point forgot to call registerQueueHandlers). Every job is
+    // about to be dead-lettered as `no-handler-registered:<type>`. Surface a
+    // loud warning so it's not mistaken for a silent success. This matches
+    // spec §7.9 (no-handler dead-letters are a legitimate path for obsolete
+    // types) but flags the common mistake path.
+    if (registry.size === 0 && parsed.length > 0) {
+        const msg = `registry is empty but snapshot has ${parsed.length} job(s) — every job will be dead-lettered. Did registerQueueHandlers() fail to wire handlers?`;
+        log.warn(msg);
+        try {
+            process.stderr.write(`ironbee queue WARN: ${msg}\n`);
+        }
+        catch {
+            // ignore — worker.log already has it
+        }
+    }
+    // Phase 2: flush parse errors to dead-letter
+    for (const err of parseErrors) {
+        try {
+            (0, dead_letter_1.deadLetterParseError)({ projectDir, sessionId, sourceFile: path }, err.raw, `parse-error: ${err.message}`);
+            log.info(`DEAD_LETTER parse-error from=${(0, path_1.basename)(path)}`);
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            log.error(`failed to dead-letter parse-error: ${msg}; leaving file`);
+            return;
+        }
+    }
+    // Phase 3: group by type, iterate sorted for determinism
+    const groups = new Map();
+    for (const job of parsed) {
+        const existing = groups.get(job.type);
+        if (existing) {
+            existing.push(job);
+        }
+        else {
+            groups.set(job.type, [job]);
+        }
+    }
+    const types = [...groups.keys()].sort();
+    let deadCount = parseErrors.length;
+    let okCount = 0;
+    for (const type of types) {
+        const jobs = groups.get(type);
+        const handler = registry.get(type);
+        if (!handler) {
+            for (const job of jobs) {
+                try {
+                    (0, dead_letter_1.deadLetterParsed)({ projectDir, sessionId, sourceFile: path }, job, `no-handler-registered:${type}`);
+                    deadCount++;
+                }
+                catch (e) {
+                    const msg = e instanceof Error ? e.message : String(e);
+                    log.error(`failed to dead-letter unhandled job ${job.id}: ${msg}; leaving file`);
+                    return;
+                }
+            }
+            log.info(`NO_HANDLER type=${type} count=${jobs.length}`);
+            continue;
+        }
+        try {
+            await handler.dispatch(jobs);
+            okCount += jobs.length;
+            log.info(`BATCH_OK type=${type} count=${jobs.length}`);
+        }
+        catch (e) {
+            if (e instanceof types_1.TransientError) {
+                log.warn(`TRANSIENT type=${type}: ${e.message}; leaving file for retry`);
+                return;
+            }
+            if (e instanceof types_1.AuthError) {
+                log.error(`AUTH type=${type}: ${e.message}; leaving file; operator must fix credentials`);
+                return;
+            }
+            if (e instanceof types_1.BadRequestBatchError) {
+                log.warn(`BATCH_400 type=${type}: ${e.message}; falling back to per-job dispatch`);
+                const result = await fallbackPerJob(handler, jobs, path, projectDir, sessionId, log);
+                if (result.bailed) {
+                    return; // file left on disk
+                }
+                okCount += result.ok;
+                deadCount += result.dead;
+                continue;
+            }
+            // Unexpected batch-level error: dead-letter every job in the batch and keep going.
+            const msg = e instanceof Error ? e.message : String(e);
+            log.error(`BATCH_UNEXPECTED type=${type}: ${msg}`);
+            for (const job of jobs) {
+                try {
+                    (0, dead_letter_1.deadLetterParsed)({ projectDir, sessionId, sourceFile: path }, job, `unexpected:${msg}`);
+                    deadCount++;
+                }
+                catch (e2) {
+                    const msg2 = e2 instanceof Error ? e2.message : String(e2);
+                    log.error(`failed to dead-letter unexpected-batch job ${job.id}: ${msg2}; leaving file`);
+                    return;
+                }
+            }
+        }
+    }
+    // Phase 4: every line is terminal → delete the snapshot
+    try {
+        (0, fs_1.unlinkSync)(path);
+        log.info(`DONE path=${(0, path_1.basename)(path)} lines_ok=${okCount} lines_dead=${deadCount}`);
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        // §7.14 — next drain will re-process; downstream dedupes on id
+        log.warn(`UNLINK_FAILED path=${path}: ${msg}; leaving file for re-processing`);
+    }
+}
+async function fallbackPerJob(handler, jobs, sourcePath, projectDir, sessionId, log) {
+    let ok = 0;
+    let dead = 0;
+    for (const job of jobs) {
+        try {
+            await handler.dispatchSingle(job);
+            ok++;
+        }
+        catch (e) {
+            if (e instanceof types_1.BadRequestError) {
+                try {
+                    (0, dead_letter_1.deadLetterParsed)({ projectDir, sessionId, sourceFile: sourcePath }, job, e.message);
+                    dead++;
+                }
+                catch (e2) {
+                    const msg = e2 instanceof Error ? e2.message : String(e2);
+                    log.error(`failed to dead-letter bad-request job ${job.id}: ${msg}; leaving file`);
+                    return { ok, dead, bailed: true };
+                }
+                continue;
+            }
+            if (e instanceof types_1.TransientError) {
+                log.warn(`TRANSIENT_DURING_FALLBACK job=${job.id}: ${e.message}; leaving file`);
+                return { ok, dead, bailed: true };
+            }
+            if (e instanceof types_1.AuthError) {
+                log.error(`AUTH_DURING_FALLBACK job=${job.id}: ${e.message}; leaving file`);
+                return { ok, dead, bailed: true };
+            }
+            const msg = e instanceof Error ? e.message : String(e);
+            try {
+                (0, dead_letter_1.deadLetterParsed)({ projectDir, sessionId, sourceFile: sourcePath }, job, `unexpected:${msg}`);
+                dead++;
+            }
+            catch (e2) {
+                const msg2 = e2 instanceof Error ? e2.message : String(e2);
+                log.error(`failed to dead-letter unexpected job ${job.id}: ${msg2}; leaving file`);
+                return { ok, dead, bailed: true };
+            }
+        }
+    }
+    return { ok, dead, bailed: false };
+}
+function readLinesStreaming(path, onLine) {
+    return new Promise((resolve, reject) => {
+        const stream = (0, fs_1.createReadStream)(path, { encoding: "utf-8" });
+        const rl = (0, readline_1.createInterface)({ input: stream, crlfDelay: Infinity });
+        let inlineErr = null;
+        rl.on("line", (line) => {
+            if (inlineErr) {
+                return;
+            }
+            try {
+                onLine(line);
+            }
+            catch (e) {
+                inlineErr = e instanceof Error ? e : new Error(String(e));
+                rl.close();
+                stream.destroy();
+            }
+        });
+        rl.on("close", () => {
+            if (inlineErr) {
+                reject(inlineErr);
+            }
+            else {
+                resolve();
+            }
+        });
+        stream.on("error", (err) => {
+            reject(err);
+        });
+    });
+}
+function isJob(obj) {
+    if (typeof obj !== "object" || obj === null) {
+        return false;
+    }
+    const o = obj;
+    return typeof o.id === "string"
+        && typeof o.type === "string"
+        && typeof o.created_at === "string"
+        && "data" in o;
+}
+//# sourceMappingURL=process-file.js.map

package/dist/queue/process-file.js.map

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

package/dist/queue/register-handlers.d.ts

@@ -0,0 +1,26 @@
+/**
+ * IronBee CLI — Queue Handler Bootstrap
+ *
+ * Single wiring point for all queue job-type handlers. Imported and invoked
+ * by `src/index.ts` before `program.parse()` so that any CLI entry point
+ * (`ironbee queue drain`, `ironbee process-job-file`, or a hook-driven
+ * flushSynchronously) sees a fully-populated global registry.
+ *
+ * Currently empty — no concrete consumer exists yet. When a producer is
+ * added (e.g. a `send_event` producer on top of the tool_call hook), its
+ * handler MUST be registered here. Forgetting to do so means every job of
+ * that type will silently be written to dead-letter as
+ * `no-handler-registered:<type>` (§7.9).
+ *
+ * Why not register inside each producer module's top-level code?
+ *   - Side-effectful top-level imports are hard to reason about.
+ *   - A detached worker spawned via `spawnDetachedWorker` starts a fresh
+ *     Node process and imports the CLI entry point — it will only see
+ *     handlers registered via this bootstrap.
+ *
+ * Keep registrations idempotent — this function may be called more than
+ * once in tests.
+ */
+export declare const SEND_EVENT_TYPE: string;
+export declare function registerQueueHandlers(): void;
+//# sourceMappingURL=register-handlers.d.ts.map

package/dist/queue/register-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-handlers.d.ts","sourceRoot":"","sources":["../../src/queue/register-handlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,eAAO,MAAM,eAAe,EAAE,MAAqB,CAAC;AAEpD,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C"}

package/dist/queue/register-handlers.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * IronBee CLI — Queue Handler Bootstrap
+ *
+ * Single wiring point for all queue job-type handlers. Imported and invoked
+ * by `src/index.ts` before `program.parse()` so that any CLI entry point
+ * (`ironbee queue drain`, `ironbee process-job-file`, or a hook-driven
+ * flushSynchronously) sees a fully-populated global registry.
+ *
+ * Currently empty — no concrete consumer exists yet. When a producer is
+ * added (e.g. a `send_event` producer on top of the tool_call hook), its
+ * handler MUST be registered here. Forgetting to do so means every job of
+ * that type will silently be written to dead-letter as
+ * `no-handler-registered:<type>` (§7.9).
+ *
+ * Why not register inside each producer module's top-level code?
+ *   - Side-effectful top-level imports are hard to reason about.
+ *   - A detached worker spawned via `spawnDetachedWorker` starts a fresh
+ *     Node process and imports the CLI entry point — it will only see
+ *     handlers registered via this bootstrap.
+ *
+ * Keep registrations idempotent — this function may be called more than
+ * once in tests.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SEND_EVENT_TYPE = void 0;
+exports.registerQueueHandlers = registerQueueHandlers;
+const registry_1 = require("./registry");
+const send_event_1 = require("./handlers/send-event");
+exports.SEND_EVENT_TYPE = "send_event";
+function registerQueueHandlers() {
+    // send_event — POST event envelopes (tool_call, session_start, …) to
+    // the IronBee Collector. See src/queue/handlers/send-event.ts.
+    (0, registry_1.register)(exports.SEND_EVENT_TYPE, send_event_1.sendEventHandler);
+}
+//# sourceMappingURL=register-handlers.js.map

package/dist/queue/register-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-handlers.js","sourceRoot":"","sources":["../../src/queue/register-handlers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;AAOH,sDAIC;AATD,yCAAsC;AACtC,sDAAyD;AAE5C,QAAA,eAAe,GAAW,YAAY,CAAC;AAEpD,SAAgB,qBAAqB;IACjC,qEAAqE;IACrE,+DAA+D;IAC/D,IAAA,mBAAQ,EAAC,uBAAe,EAAE,6BAAgB,CAAC,CAAC;AAChD,CAAC"}