@ironbee-ai/cli 0.5.2 → 0.6.0

package/dist/queue/handlers/send-event.d.ts

@@ -0,0 +1,23 @@
+/**
+ * IronBee CLI — send_event Handler
+ *
+ * Queue handler for `type: "send_event"` jobs. Batches event payloads from
+ * `job.data` and POSTs them to the IronBee Collector via the shared
+ * transport + target resolver in `src/lib/collector.ts`.
+ *
+ * HTTP status → queue error classification (spec §6):
+ *   - 2xx           → success (jobs marked delivered)
+ *   - 401 / 403     → AuthError (worker leaves the file; operator fixes creds)
+ *   - 5xx / 429     → TransientError (worker leaves the file; next drain retries)
+ *   - timeout / net → TransientError
+ *   - 400 (batch)   → BadRequestBatchError (worker falls back to dispatchSingle)
+ *   - 400 (single)  → BadRequestError (worker dead-letters that one job)
+ *   - other 4xx     → BadRequestBatchError / BadRequestError (permanent)
+ *
+ * When no collector is configured (or `IRONBEE_COLLECTOR=false`), dispatch
+ * is a no-op — jobs are silently "delivered" so the queue doesn't accumulate
+ * indefinitely in local-only mode.
+ */
+import { Handler } from "../registry";
+export declare const sendEventHandler: Handler;
+//# sourceMappingURL=send-event.d.ts.map

package/dist/queue/handlers/send-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-event.d.ts","sourceRoot":"","sources":["../../../src/queue/handlers/send-event.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAoEtC,eAAO,MAAM,gBAAgB,EAAE,OAgD9B,CAAC"}

package/dist/queue/handlers/send-event.js

@@ -0,0 +1,131 @@
+"use strict";
+/**
+ * IronBee CLI — send_event Handler
+ *
+ * Queue handler for `type: "send_event"` jobs. Batches event payloads from
+ * `job.data` and POSTs them to the IronBee Collector via the shared
+ * transport + target resolver in `src/lib/collector.ts`.
+ *
+ * HTTP status → queue error classification (spec §6):
+ *   - 2xx           → success (jobs marked delivered)
+ *   - 401 / 403     → AuthError (worker leaves the file; operator fixes creds)
+ *   - 5xx / 429     → TransientError (worker leaves the file; next drain retries)
+ *   - timeout / net → TransientError
+ *   - 400 (batch)   → BadRequestBatchError (worker falls back to dispatchSingle)
+ *   - 400 (single)  → BadRequestError (worker dead-letters that one job)
+ *   - other 4xx     → BadRequestBatchError / BadRequestError (permanent)
+ *
+ * When no collector is configured (or `IRONBEE_COLLECTOR=false`), dispatch
+ * is a no-op — jobs are silently "delivered" so the queue doesn't accumulate
+ * indefinitely in local-only mode.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendEventHandler = void 0;
+const collector_1 = require("../../lib/collector");
+const logger_1 = require("../../lib/logger");
+const paths_1 = require("../paths");
+const types_1 = require("../types");
+const SEND_TIMEOUT_MS = 10000;
+/**
+ * Default max events per POST. Collectors sometimes reject bodies above ~1 MB
+ * (Spring Boot default). With tool_call envelopes capped at 4 KB each, 100
+ * events ≈ 400 KB worst case — comfortably under typical limits.
+ * Override via `collector.batchSize` in config.json.
+ */
+const DEFAULT_BATCH_SIZE = 100;
+function resolveBatchSize(target) {
+    if (typeof target.batchSize === "number" && target.batchSize >= 1) {
+        return Math.floor(target.batchSize);
+    }
+    return DEFAULT_BATCH_SIZE;
+}
+function classifyBatch(result) {
+    const { status, body } = result;
+    if (status >= 200 && status < 300) {
+        return;
+    }
+    if (status === 401 || status === 403) {
+        throw new types_1.AuthError(`collector auth failed: HTTP ${status} ${truncate(body, 200)}`);
+    }
+    if (status === 429 || status >= 500) {
+        throw new types_1.TransientError(`collector transient: HTTP ${status} ${truncate(body, 200)}`);
+    }
+    if (status === 400) {
+        throw new types_1.BadRequestBatchError(`collector rejected batch: HTTP 400 ${truncate(body, 200)}`);
+    }
+    // other 4xx — treat as permanent per-batch; fallback will dead-letter each
+    throw new types_1.BadRequestBatchError(`collector error: HTTP ${status} ${truncate(body, 200)}`);
+}
+function classifySingle(result) {
+    const { status, body } = result;
+    if (status >= 200 && status < 300) {
+        return;
+    }
+    if (status === 401 || status === 403) {
+        throw new types_1.AuthError(`collector auth failed: HTTP ${status} ${truncate(body, 200)}`);
+    }
+    if (status === 429 || status >= 500) {
+        throw new types_1.TransientError(`collector transient: HTTP ${status} ${truncate(body, 200)}`);
+    }
+    if (status === 400) {
+        throw new types_1.BadRequestError(`400: ${truncate(body, 200)}`);
+    }
+    throw new types_1.BadRequestError(`HTTP ${status}: ${truncate(body, 200)}`);
+}
+function truncate(s, max) {
+    if (s.length <= max) {
+        return s;
+    }
+    return s.slice(0, max) + "…";
+}
+exports.sendEventHandler = {
+    /**
+     * Chunk the jobs into `batchSize`-sized slices and POST each. The first
+     * failed chunk throws — if `TransientError`/`AuthError`, the worker
+     * leaves the snapshot for retry (which re-sends already-delivered chunks;
+     * downstream dedupes on `job.id`). A 400 throws `BadRequestBatchError`,
+     * triggering per-job fallback across the WHOLE snapshot (spec §5.3),
+     * again relying on id-dedup for chunks that already succeeded.
+     */
+    async dispatch(jobs) {
+        const target = (0, collector_1.getCollectorTarget)((0, paths_1.resolveProjectDir)());
+        if (!target) {
+            logger_1.logger.debug(`send_event: no collector configured, skipping ${jobs.length} job(s)`);
+            return;
+        }
+        if (jobs.length === 0) {
+            return;
+        }
+        const batchSize = resolveBatchSize(target);
+        const events = jobs.map((j) => j.data);
+        for (let i = 0; i < events.length; i += batchSize) {
+            const chunk = events.slice(i, i + batchSize);
+            let result;
+            try {
+                result = await (0, collector_1.postEventsBatch)(chunk, target, { timeoutMs: SEND_TIMEOUT_MS });
+            }
+            catch (e) {
+                throw new types_1.TransientError(`collector network error: ${e instanceof Error ? e.message : String(e)}`);
+            }
+            classifyBatch(result);
+        }
+        // Note: worker stdio is "ignore" + no setLogFile — `processFile` writes
+        // a `BATCH_OK type=send_event count=N` line to `worker.log` per spec
+        // §5.3 which already covers per-batch observability.
+    },
+    async dispatchSingle(job) {
+        const target = (0, collector_1.getCollectorTarget)((0, paths_1.resolveProjectDir)());
+        if (!target) {
+            return;
+        }
+        let result;
+        try {
+            result = await (0, collector_1.postEventsBatch)([job.data], target, { timeoutMs: SEND_TIMEOUT_MS });
+        }
+        catch (e) {
+            throw new types_1.TransientError(`collector network error: ${e instanceof Error ? e.message : String(e)}`);
+        }
+        classifySingle(result);
+    },
+};
+//# sourceMappingURL=send-event.js.map

package/dist/queue/handlers/send-event.js.map

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

package/dist/queue/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 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
+ */
+export { submit, SubmitOptions } from "./submit";
+export { snapshot } from "./snapshot";
+export { processFile, ProcessFileOptions } from "./process-file";
+export { drain, DrainOptions, DrainResult } from "./drain";
+export { spawnDetachedWorker } from "./spawn";
+export { flushInBackground, flushSynchronously, maybeAutoFlush, DEFAULT_AUTO_FLUSH_SIZE_BYTES } from "./flush";
+export { registerQueueHandlers, SEND_EVENT_TYPE } from "./register-handlers";
+export { Handler, HandlerRegistry, register, unregister, clear as clearRegistry, get as getHandler, snapshotRegistry, } from "./registry";
+export { InvalidSessionIdError, JobTooLargeError, IOError, TransientError, AuthError, BadRequestError, BadRequestBatchError, Job, DeadLetterEntry, DeadLetterParsed, DeadLetterParseError, MAX_LINE_BYTES, } from "./types";
+export { resolveProjectDir, validateSessionId, sessionsRoot, sessionDir, queueDir, liveQueueFile, snapshotFile, deadLetterFile, workerLogFile, parseSnapshotPath, SNAPSHOT_FILENAME_REGEX, DEAD_LETTER_ROTATED_REGEX, WORKER_LOG_ROTATED_REGEX, } from "./paths";
+export { readDeadLetterEntries } from "./dead-letter";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/queue/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,cAAc,EAAE,6BAA6B,EAAE,MAAM,SAAS,CAAC;AAC/G,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EACH,OAAO,EACP,eAAe,EACf,QAAQ,EACR,UAAU,EACV,KAAK,IAAI,aAAa,EACtB,GAAG,IAAI,UAAU,EACjB,gBAAgB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EACH,qBAAqB,EACrB,gBAAgB,EAChB,OAAO,EACP,cAAc,EACd,SAAS,EACT,eAAe,EACf,oBAAoB,EACpB,GAAG,EACH,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,GACjB,MAAM,SAAS,CAAC;AACjB,OAAO,EACH,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,uBAAuB,EACvB,yBAAyB,EACzB,wBAAwB,GAC3B,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}

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"}