@ironbee-ai/cli 0.5.2 → 0.6.0

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

package/dist/queue/registry.d.ts

@@ -0,0 +1,42 @@
+/**
+ * IronBee CLI — Queue Handler Registry
+ *
+ * Handlers are registered per job `type`. The worker captures a snapshot of
+ * the registry at the top of processFile() (§5.3 "Handler registry" note) so
+ * mid-run registration changes cannot confuse dispatch.
+ */
+import { Job } from "./types";
+export interface Handler<TData = unknown> {
+    /**
+     * Batch dispatch. Must throw:
+     *   - TransientError        on retriable failures (5xx, network)
+     *   - AuthError             on auth failures (401/403)
+     *   - BadRequestBatchError  when the batch was rejected but the specific
+     *                           offending line is unknown (worker will fall back
+     *                           to per-job dispatchSingle)
+     * Other thrown errors bubble up as `unexpected:` and per-job-dead-letter
+     * via the fallback path.
+     */
+    dispatch(jobs: Job<TData>[]): Promise<void> | void;
+    /**
+     * Per-job fallback. Must throw:
+     *   - BadRequestError  for a permanent per-job failure (worker dead-letters
+     *                      this job and continues with the next)
+     *   - TransientError   to bail out of the fallback and leave the snapshot
+     *                      for a full-file retry
+     *   - AuthError        same as transient but signals auth needs fixing
+     */
+    dispatchSingle(job: Job<TData>): Promise<void> | void;
+}
+export type HandlerRegistry = Map<string, Handler>;
+export declare function register<TData>(type: string, handler: Handler<TData>): void;
+export declare function unregister(type: string): void;
+export declare function get(type: string): Handler | undefined;
+export declare function clear(): void;
+/**
+ * Return an immutable snapshot of the registry. Callers should capture this
+ * once per processFile() invocation and use it for the entire pass — see
+ * §7.18 (registry snapshot consistency).
+ */
+export declare function snapshotRegistry(): HandlerRegistry;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/queue/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAE9B,MAAM,WAAW,OAAO,CAAC,KAAK,GAAG,OAAO;IACpC;;;;;;;;;OASG;IACH,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAEnD;;;;;;;OAOG;IACH,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACzD;AAED,MAAM,MAAM,eAAe,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAInD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAE3E;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAErD;AAED,wBAAgB,KAAK,IAAI,IAAI,CAE5B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,eAAe,CAElD"}

package/dist/queue/registry.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * IronBee CLI — Queue Handler Registry
+ *
+ * Handlers are registered per job `type`. The worker captures a snapshot of
+ * the registry at the top of processFile() (§5.3 "Handler registry" note) so
+ * mid-run registration changes cannot confuse dispatch.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.register = register;
+exports.unregister = unregister;
+exports.get = get;
+exports.clear = clear;
+exports.snapshotRegistry = snapshotRegistry;
+const globalRegistry = new Map();
+function register(type, handler) {
+    globalRegistry.set(type, handler);
+}
+function unregister(type) {
+    globalRegistry.delete(type);
+}
+function get(type) {
+    return globalRegistry.get(type);
+}
+function clear() {
+    globalRegistry.clear();
+}
+/**
+ * Return an immutable snapshot of the registry. Callers should capture this
+ * once per processFile() invocation and use it for the entire pass — see
+ * §7.18 (registry snapshot consistency).
+ */
+function snapshotRegistry() {
+    return new Map(globalRegistry);
+}
+//# sourceMappingURL=registry.js.map

package/dist/queue/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/queue/registry.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAgCH,4BAEC;AAED,gCAEC;AAED,kBAEC;AAED,sBAEC;AAOD,4CAEC;AAzBD,MAAM,cAAc,GAAoB,IAAI,GAAG,EAAmB,CAAC;AAEnE,SAAgB,QAAQ,CAAQ,IAAY,EAAE,OAAuB;IACjE,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,OAAkB,CAAC,CAAC;AACjD,CAAC;AAED,SAAgB,UAAU,CAAC,IAAY;IACnC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AAED,SAAgB,GAAG,CAAC,IAAY;IAC5B,OAAO,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,SAAgB,KAAK;IACjB,cAAc,CAAC,KAAK,EAAE,CAAC;AAC3B,CAAC;AAED;;;;GAIG;AACH,SAAgB,gBAAgB;IAC5B,OAAO,IAAI,GAAG,CAAkB,cAAc,CAAC,CAAC;AACpD,CAAC"}

package/dist/queue/snapshot.d.ts

@@ -0,0 +1,16 @@
+/**
+ * IronBee CLI — Queue snapshot()
+ *
+ * See docs/job-queue.md §5.2.
+ */
+/**
+ * Atomically freeze the live queue file into a snapshot.
+ *   Success → returns absolute snapshot path
+ *   Live file missing (ENOENT) → returns null
+ *
+ * Throws:
+ *   - InvalidSessionIdError  if sessionId fails validation
+ *   - IOError                on filesystem errors other than ENOENT
+ */
+export declare function snapshot(projectDir: string, sessionId: string): string | null;
+//# sourceMappingURL=snapshot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/queue/snapshot.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiB7E"}

package/dist/queue/snapshot.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * IronBee CLI — Queue snapshot()
+ *
+ * See docs/job-queue.md §5.2.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.snapshot = snapshot;
+const fs_1 = require("fs");
+const crypto_1 = require("crypto");
+const types_1 = require("./types");
+const paths_1 = require("./paths");
+/**
+ * Atomically freeze the live queue file into a snapshot.
+ *   Success → returns absolute snapshot path
+ *   Live file missing (ENOENT) → returns null
+ *
+ * Throws:
+ *   - InvalidSessionIdError  if sessionId fails validation
+ *   - IOError                on filesystem errors other than ENOENT
+ */
+function snapshot(projectDir, sessionId) {
+    (0, paths_1.validateSessionId)(sessionId);
+    const snapshotId = (0, crypto_1.randomUUID)();
+    const src = (0, paths_1.liveQueueFile)(projectDir, sessionId);
+    const dst = (0, paths_1.snapshotFile)(projectDir, sessionId, snapshotId);
+    try {
+        (0, fs_1.renameSync)(src, dst);
+        return dst;
+    }
+    catch (e) {
+        const err = e;
+        if (err.code === "ENOENT") {
+            return null;
+        }
+        throw new types_1.IOError(`failed to rename ${src} -> ${dst}`, e);
+    }
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/queue/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/queue/snapshot.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAgBH,4BAiBC;AA/BD,2BAAgC;AAChC,mCAAoC;AACpC,mCAAkC;AAClC,mCAAyE;AAEzE;;;;;;;;GAQG;AACH,SAAgB,QAAQ,CAAC,UAAkB,EAAE,SAAiB;IAC1D,IAAA,yBAAiB,EAAC,SAAS,CAAC,CAAC;IAE7B,MAAM,UAAU,GAAW,IAAA,mBAAU,GAAE,CAAC;IACxC,MAAM,GAAG,GAAW,IAAA,qBAAa,EAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IACzD,MAAM,GAAG,GAAW,IAAA,oBAAY,EAAC,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAEpE,IAAI,CAAC;QACD,IAAA,eAAU,EAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACrB,OAAO,GAAG,CAAC;IACf,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QAClB,MAAM,GAAG,GAA0B,CAA0B,CAAC;QAC9D,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,MAAM,IAAI,eAAO,CAAC,oBAAoB,GAAG,OAAO,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;IAC9D,CAAC;AACL,CAAC"}

package/dist/queue/spawn.d.ts

@@ -0,0 +1,15 @@
+/**
+ * IronBee CLI — Detached Worker Spawn
+ *
+ * See docs/job-queue.md §5.6 (when to use), §9.1 (platform primitives).
+ *
+ * Callers on the active-use path use this helper to fire-and-forget a worker
+ * on a freshly-minted snapshot. The trigger returns in <10 ms; the worker
+ * survives the trigger's exit.
+ */
+/**
+ * Spawn a detached worker on the given snapshot path. Returns immediately.
+ * The parent process may exit without killing the child.
+ */
+export declare function spawnDetachedWorker(snapshotPath: string): void;
+//# sourceMappingURL=spawn.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../src/queue/spawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAsBH;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAU9D"}

package/dist/queue/spawn.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * IronBee CLI — Detached Worker Spawn
+ *
+ * See docs/job-queue.md §5.6 (when to use), §9.1 (platform primitives).
+ *
+ * Callers on the active-use path use this helper to fire-and-forget a worker
+ * on a freshly-minted snapshot. The trigger returns in <10 ms; the worker
+ * survives the trigger's exit.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.spawnDetachedWorker = spawnDetachedWorker;
+const child_process_1 = require("child_process");
+/**
+ * Resolve the `ironbee` binary to invoke. Falls back to `node <currentEntry>`
+ * if the CLI was launched via `node dist/index.js` (common in tests / dev).
+ */
+function resolveInvocation() {
+    const override = process.env.IRONBEE_BIN;
+    if (override) {
+        return { command: override, args: [] };
+    }
+    const argv0 = process.argv[0];
+    const argv1 = process.argv[1] ?? "";
+    // when launched via `ironbee` bin, argv[1] is the dist/index.js path — re-run it via node
+    if (argv1.endsWith("index.js") || argv1.endsWith("index.ts")) {
+        return { command: argv0, args: [argv1] };
+    }
+    return { command: "ironbee", args: [] };
+}
+/**
+ * Spawn a detached worker on the given snapshot path. Returns immediately.
+ * The parent process may exit without killing the child.
+ */
+function spawnDetachedWorker(snapshotPath) {
+    const { command, args } = resolveInvocation();
+    const fullArgs = [...args, "process-job-file", snapshotPath];
+    const child = (0, child_process_1.spawn)(command, fullArgs, {
+        detached: true,
+        stdio: "ignore",
+        env: process.env,
+    });
+    child.unref();
+}
+//# sourceMappingURL=spawn.js.map

package/dist/queue/spawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.js","sourceRoot":"","sources":["../../src/queue/spawn.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AA0BH,kDAUC;AAlCD,iDAAoD;AAEpD;;;GAGG;AACH,SAAS,iBAAiB;IACtB,MAAM,QAAQ,GAAuB,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IAC7D,IAAI,QAAQ,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAC3C,CAAC;IACD,MAAM,KAAK,GAAW,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtC,MAAM,KAAK,GAAW,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5C,0FAA0F;IAC1F,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;IAC7C,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,YAAoB;IACpD,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,iBAAiB,EAAE,CAAC;IAC9C,MAAM,QAAQ,GAAa,CAAC,GAAG,IAAI,EAAE,kBAAkB,EAAE,YAAY,CAAC,CAAC;IAEvE,MAAM,KAAK,GAAiB,IAAA,qBAAK,EAAC,OAAO,EAAE,QAAQ,EAAE;QACjD,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,QAAQ;QACf,GAAG,EAAE,OAAO,CAAC,GAAG;KACnB,CAAC,CAAC;IACH,KAAK,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC"}

package/dist/queue/submit.d.ts

@@ -0,0 +1,19 @@
+/**
+ * IronBee CLI — Queue submit()
+ *
+ * See docs/job-queue.md §5.1.
+ */
+export interface SubmitOptions {
+    id?: string;
+}
+/**
+ * Append a job to `<projectDir>/.ironbee/sessions/<sessionId>/queue/jobs.jsonl`
+ * via a single O_APPEND write. Returns the job id.
+ *
+ * Throws:
+ *   - InvalidSessionIdError  if sessionId fails validation
+ *   - JobTooLargeError       if serialized line > 4 KB
+ *   - IOError                on filesystem errors (including short write)
+ */
+export declare function submit<TData>(projectDir: string, sessionId: string, type: string, data: TData, opts?: SubmitOptions): string;
+//# sourceMappingURL=submit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"submit.d.ts","sourceRoot":"","sources":["../../src/queue/submit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAeH,MAAM,WAAW,aAAa;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,KAAK,EACxB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,KAAK,EACX,IAAI,CAAC,EAAE,aAAa,GACrB,MAAM,CAwER"}