@ironbee-ai/cli 0.6.2 → 0.7.1

package/dist/commands/import.js

@@ -0,0 +1,369 @@
+"use strict";
+/**
+ * IronBee CLI — `ironbee import` command
+ *
+ * Imports historical sessions (Claude Code transcripts in v1) into the
+ * IronBee Collector.
+ *
+ * Flow: argv → scope/time-range resolution → discovery → time-range filter
+ * → estimate (dry-run summary) → confirm prompt → per-session import
+ * (concurrency-bounded) → final summary.
+ */
+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.importCommand = void 0;
+exports.parseFlags = parseFlags;
+exports.promptYesNo = promptYesNo;
+const commander_1 = require("commander");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const readline = __importStar(require("readline"));
+const output_1 = require("../lib/output");
+const config_1 = require("../lib/config");
+const collector_1 = require("../lib/collector");
+const logger_1 = require("../lib/logger");
+const import_1 = require("../import");
+const DEFAULT_CONCURRENCY = 4;
+const MIN_CONCURRENCY = 1;
+const MAX_CONCURRENCY = 32;
+exports.importCommand = new commander_1.Command("import")
+    .description("Import historical Claude Code sessions to the IronBee Collector")
+    .option("--since <duration>", "import sessions started within the given duration (e.g. 30d, 2w, 6m, 12h)")
+    .option("--from <iso-date>", "explicit start date (e.g. 2025-04-01)")
+    .option("--to <iso-date>", "explicit end date (defaults to now)")
+    .option("--transcript <path>", "import a single transcript .jsonl file")
+    .option("--projects <paths>", "comma-separated absolute project paths")
+    .option("--all-projects", "import sessions from every project under ~/.claude/projects/")
+    .option("--dry-run", "print the summary and exit without sending events")
+    .option("--yes", "skip the interactive confirm prompt")
+    .option("--force", "do not skip sessions with existing .ironbee/sessions/<id>/ directories")
+    .option("--concurrency <n>", "number of sessions to import in parallel")
+    .option("--batch-size <n>", "events per collector POST (default: 100). Set to 1 to isolate which event a 400 rejects.")
+    .action(async (flags) => {
+    let opts;
+    try {
+        opts = parseFlags(flags);
+    }
+    catch (e) {
+        output_1.log.error(e instanceof Error ? e.message : String(e));
+        process.exit(1);
+    }
+    // Fail-fast collector check: import has no value when there's no
+    // place to send events. `getCollectorTarget` consolidates five
+    // requirements into one boolean — `collector` section present,
+    // `enable !== false`, non-empty `url`, non-empty `apiKey`, and
+    // `IRONBEE_COLLECTOR != "false"`. If any fail, we error here
+    // instead of running the full discovery / dry-run / per-session
+    // pipeline only to silently no-op every POST.
+    const collectorPreflight = (0, collector_1.getCollectorTarget)(process.cwd());
+    if (collectorPreflight === null) {
+        output_1.log.error("Collector is not configured. ironbee import has no destination to send events to.");
+        output_1.log.blank();
+        output_1.log.dim("To configure, add a collector section to ~/.ironbee/config.json (or your project's .ironbee/config.json):");
+        output_1.log.blank();
+        console.log(output_1.pc.dim("  {\n    \"collector\": {\n      \"url\": \"https://your-collector.example.com\",\n      \"apiKey\": \"your-api-key\"\n    }\n  }"));
+        output_1.log.blank();
+        output_1.log.dim("All of `url` (non-empty), `apiKey` (non-empty), and `enable !== false` are required. The IRONBEE_COLLECTOR=false env override also disables.");
+        process.exit(1);
+    }
+    // Discover candidate transcripts.
+    const allTargets = (0, import_1.findTranscripts)(opts.scope);
+    const filteredTargets = (0, import_1.applyTimeRange)(allTargets, opts.timeRange);
+    if (filteredTargets.length === 0) {
+        output_1.log.warn("No transcripts found matching the given scope and time range.");
+        process.exit(0);
+    }
+    // Estimate: walk every survivor through the analytics projection
+    // to produce exact event counts + cost. This is the costly part —
+    // visible to the user via the dry-run summary.
+    output_1.log.info(`Scanning ${filteredTargets.length} transcript(s)...`);
+    const summary = (0, import_1.estimateImport)({
+        targets: filteredTargets,
+        timeRange: opts.timeRange,
+        concurrency: opts.concurrency,
+        force: opts.force,
+    });
+    renderSummary(summary, opts.dryRun);
+    if (opts.dryRun) {
+        process.exit(0);
+    }
+    if (summary.toImportCount === 0) {
+        output_1.log.warn("Nothing to import (all sessions already tracked). Use --force to re-import.");
+        process.exit(0);
+    }
+    if (!opts.yes) {
+        const proceed = await promptYesNo("Proceed?");
+        if (!proceed) {
+            output_1.log.info("Aborted.");
+            process.exit(0);
+        }
+    }
+    // Per-session import with bounded concurrency.
+    const toImport = filteredTargets.filter((t) => {
+        // Re-evaluate skip rule to avoid race with operator state changes
+        // between estimate and run. Cheap (one fs.existsSync).
+        return !shouldSkipForRunner(t, opts.force);
+    });
+    const reporter = new import_1.ProgressReporter(toImport.length);
+    // Cancellation: SIGINT finishes the in-flight session, then exits.
+    let cancelled = false;
+    process.on("SIGINT", () => {
+        output_1.log.warn("\nReceived SIGINT — finishing in-flight sessions then exiting...");
+        cancelled = true;
+    });
+    const results = await (0, import_1.runConcurrentPool)({
+        items: toImport,
+        concurrency: opts.concurrency,
+        shouldCancel: () => cancelled,
+        onStart: (t, idx) => {
+            reporter.onSessionStart(t.sessionId, idx);
+        },
+        onComplete: (res, _t, idx) => {
+            reporter.onSessionComplete(res, idx);
+        },
+        process: async (t) => {
+            // importSession already returns a typed envelope on failure
+            // (status: "failed"); the outer try/catch is a defensive
+            // safety net for unexpected throws from future refactors.
+            try {
+                return await (0, import_1.importSession)({ target: t, force: opts.force, batchSize: opts.batchSize });
+            }
+            catch (e) {
+                return {
+                    sessionId: t.sessionId,
+                    status: "failed",
+                    eventsSent: (0, import_1.emptyEventCounts)(),
+                    reason: e instanceof Error ? e.message : String(e),
+                };
+            }
+        },
+    });
+    reporter.finalSummary();
+    const failed = results.filter((r) => r.status === "failed").length;
+    if (failed > 0) {
+        process.exit(1);
+    }
+});
+function parseFlags(flags) {
+    // Scope — mutually exclusive group.
+    const scopeFlags = [
+        flags.transcript !== undefined ? 1 : 0,
+        flags.projects !== undefined ? 1 : 0,
+        flags.allProjects === true ? 1 : 0,
+    ].reduce((a, b) => a + b, 0);
+    if (scopeFlags > 1) {
+        throw new Error("--transcript, --projects, and --all-projects are mutually exclusive");
+    }
+    let scope;
+    if (flags.transcript !== undefined) {
+        scope = { kind: "transcript", path: (0, path_1.resolve)(flags.transcript) };
+    }
+    else if (flags.projects !== undefined) {
+        // Trim + filter empty strings BEFORE `resolve()` — resolve("") returns
+        // process.cwd() and would silently turn a stray comma or empty
+        // --projects flag into "import everything in the current directory".
+        const paths = flags.projects
+            .split(",")
+            .map((p) => p.trim())
+            .filter((p) => p.length > 0)
+            .map((p) => (0, path_1.resolve)(p));
+        if (paths.length === 0) {
+            throw new Error("--projects must list at least one path");
+        }
+        scope = { kind: "projects", paths };
+    }
+    else if (flags.allProjects === true) {
+        scope = { kind: "all-projects" };
+    }
+    else {
+        scope = { kind: "current-project" };
+    }
+    // Time range — mutually exclusive sub-group.
+    if (flags.since !== undefined && flags.from !== undefined) {
+        throw new Error("--since and --from are mutually exclusive");
+    }
+    let timeRange = null;
+    const nowMs = Date.now();
+    if (flags.since !== undefined) {
+        const sinceMs = (0, import_1.parseSinceDuration)(flags.since);
+        if (sinceMs === null) {
+            throw new Error(`Invalid --since value: "${flags.since}". Expected forms: 30d, 2w, 6m, 12h.`);
+        }
+        timeRange = (0, import_1.buildTimeRange)({ sinceMs, nowMs });
+    }
+    else if (flags.from !== undefined) {
+        const fromMs = (0, import_1.parseIsoDate)(flags.from);
+        if (fromMs === null) {
+            throw new Error(`Invalid --from value: "${flags.from}". Expected ISO date (e.g. 2025-04-01).`);
+        }
+        let toMs;
+        if (flags.to !== undefined) {
+            const parsed = (0, import_1.parseIsoDate)(flags.to);
+            if (parsed === null) {
+                throw new Error(`Invalid --to value: "${flags.to}". Expected ISO date.`);
+            }
+            toMs = parsed;
+        }
+        timeRange = (0, import_1.buildTimeRange)({ fromMs, toMs, nowMs });
+    }
+    // Concurrency: flag > config > default.
+    const concurrency = resolveConcurrency(flags.concurrency);
+    // Batch size: flag only — null falls through to target.batchSize / default
+    // at the emitter level, so we don't compete with `collector.batchSize` config.
+    const batchSize = resolveBatchSize(flags.batchSize);
+    return {
+        scope,
+        timeRange,
+        dryRun: flags.dryRun === true,
+        yes: flags.yes === true,
+        force: flags.force === true,
+        concurrency,
+        batchSize,
+    };
+}
+function resolveBatchSize(flagValue) {
+    if (flagValue === undefined) {
+        return null;
+    }
+    const parsed = parseInt(flagValue, 10);
+    if (!Number.isFinite(parsed) || parsed < 1) {
+        throw new Error(`Invalid --batch-size value: "${flagValue}". Must be an integer >= 1.`);
+    }
+    return parsed;
+}
+function resolveConcurrency(flagValue) {
+    if (flagValue !== undefined) {
+        const parsed = parseInt(flagValue, 10);
+        if (!Number.isFinite(parsed)) {
+            throw new Error(`Invalid --concurrency value: "${flagValue}". Must be an integer.`);
+        }
+        return clamp(parsed);
+    }
+    // Merge global (`~/.ironbee/config.json`) with cwd's project config so
+    // `import.concurrency` set in the local project is honored when the
+    // operator runs `ironbee import` from inside that project.
+    const config = (0, config_1.loadConfig)(process.cwd());
+    const cfg = config.import?.concurrency;
+    if (typeof cfg === "number" && Number.isFinite(cfg)) {
+        return clamp(cfg);
+    }
+    return DEFAULT_CONCURRENCY;
+}
+function clamp(value) {
+    return Math.min(MAX_CONCURRENCY, Math.max(MIN_CONCURRENCY, Math.floor(value)));
+}
+function shouldSkipForRunner(t, force) {
+    if (force) {
+        return false;
+    }
+    const path = `${t.projectDir}/.ironbee/sessions/${t.sessionId}`;
+    try {
+        return (0, fs_1.existsSync)(path);
+    }
+    catch (e) {
+        logger_1.logger.debug(`import skip pre-check failed for ${path}: ${e instanceof Error ? e.message : e}`);
+        return false;
+    }
+}
+function renderSummary(summary, isDryRun) {
+    const heading = isDryRun ? "ironbee import — dry-run preview" : "ironbee import — preview";
+    output_1.log.blank();
+    console.log(output_1.pc.bold(heading));
+    output_1.log.blank();
+    const totalFound = summary.projects.reduce((acc, p) => acc + p.found, 0);
+    console.log(`Scope: ${output_1.pc.bold(String(summary.projects.length))} project(s), ${output_1.pc.bold(String(totalFound))} session(s) found`);
+    for (const p of summary.projects) {
+        console.log(`  ${output_1.pc.dim(p.projectDir.padEnd(50))} ${String(p.found).padStart(3)} sessions  ${output_1.pc.dim(`${p.skipped} skipped`)}`);
+    }
+    output_1.log.blank();
+    if (summary.timeRange !== null) {
+        const fromIso = new Date(summary.timeRange.fromMs).toISOString().slice(0, 10);
+        const toIso = new Date(summary.timeRange.toMs).toISOString().slice(0, 10);
+        console.log(`Time range: ${output_1.pc.bold(fromIso)} .. ${output_1.pc.bold(toIso)}`);
+    }
+    else {
+        console.log(`Time range: ${output_1.pc.dim("(no filter — every session)")}`);
+    }
+    output_1.log.blank();
+    console.log(`To import: ${output_1.pc.bold(String(summary.toImportCount))} session(s)`);
+    console.log("  Estimated events:");
+    console.log(`    session_start / session_end           ${formatNum(summary.estimatedEvents.session_start + summary.estimatedEvents.session_end)}`);
+    console.log(`    activity_start / activity_end         ${formatNum(summary.estimatedEvents.activity_start + summary.estimatedEvents.activity_end)}`);
+    console.log(`    tool_call                             ${formatNum(summary.estimatedEvents.tool_call)}`);
+    console.log(`    file_change                           ${formatNum(summary.estimatedEvents.file_change)}`);
+    console.log(`    api_request                           ${formatNum(summary.estimatedEvents.api_request)}`);
+    console.log(`    session_analytics                     ${formatNum(summary.estimatedEvents.session_analytics)}`);
+    console.log(`    session_turn_analytics                ${formatNum(summary.estimatedEvents.session_turn_analytics)}`);
+    console.log(`    session_turn_step_analytics           ${formatNum(summary.estimatedEvents.session_turn_step_analytics)}`);
+    output_1.log.blank();
+    console.log(`  Estimated total cost surfaced:        ${output_1.pc.bold(`$${summary.estimatedCostUsd.toFixed(2)}`)}`);
+    console.log(`  Estimated wire bytes:                 ${output_1.pc.dim(formatBytes(summary.estimatedWireBytes))}`);
+    console.log(`  Collector endpoint:                   ${summary.collectorUrl !== null ? output_1.pc.bold(summary.collectorUrl) : output_1.pc.red("(not configured)")}`);
+    console.log(`  Concurrency:                          ${output_1.pc.bold(String(summary.concurrency))} sessions in flight`);
+    output_1.log.blank();
+}
+function formatNum(n) {
+    return n.toLocaleString("en-US");
+}
+function formatBytes(n) {
+    if (n < 1024) {
+        return `${n} B`;
+    }
+    if (n < 1024 * 1024) {
+        return `${(n / 1024).toFixed(1)} KB`;
+    }
+    return `${(n / (1024 * 1024)).toFixed(1)} MB`;
+}
+async function promptYesNo(question, deps) {
+    const create = deps?.createInterface ?? readline.createInterface;
+    return new Promise((resolveFn) => {
+        const rl = create({ input: process.stdin, output: process.stdout });
+        // Default-yes on empty input — `[Y/n]` capital Y signals the default.
+        // Operator who's already past the dry-run summary is committing to
+        // ship; a single Enter should advance them rather than bounce back.
+        // Explicit "n" / "no" still aborts; anything else is treated as
+        // confirmation (matches default-yes ergonomics).
+        rl.question(`${question} [Y/n] `, (answer) => {
+            rl.close();
+            const normalized = answer.trim().toLowerCase();
+            if (normalized === "n" || normalized === "no") {
+                resolveFn(false);
+                return;
+            }
+            resolveFn(true);
+        });
+    });
+}
+//# sourceMappingURL=import.js.map

package/dist/commands/import.js.map

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

package/dist/commands/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAcpC,eAAO,MAAM,cAAc,EAAE,OA8CvB,CAAC"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,eAAO,MAAM,cAAc,EAAE,OA8CvB,CAAC"}

package/dist/commands/install.js

@@ -8,14 +8,10 @@ const registry_1 = require("../clients/registry");
 const claude_1 = require("../clients/claude");
 const output_1 = require("../lib/output");
 const telemetry_1 = require("../lib/telemetry");
-function clientNames() {
-    const names = registry_1.REGISTERED_CLIENTS.map((c) => c.name);
-    return names.join(", ");
-}
 exports.installCommand = new commander_1.Command("install")
     .description("Install IronBee hooks and guidance files into a project")
     .argument("[project-dir]", "target project directory", ".")
-    .option("--client <name>", `client to install for (${clientNames()}), or "all"`)
+    .option("--client <name>", `client to install for (${(0, registry_1.clientNames)()}), or "all"`)
     .action(async (dir, options) => {
     const projectDir = (0, path_1.resolve)(dir);
     if (!(0, fs_1.existsSync)(projectDir)) {
@@ -23,26 +19,25 @@ exports.installCommand = new commander_1.Command("install")
         process.exit(1);
     }
     let clients;
-    if (options.client === "all") {
-        clients = registry_1.REGISTERED_CLIENTS;
+    try {
+        clients = (0, registry_1.resolveTargetClients)(projectDir, options.client);
     }
-    else if (options.client) {
-        const found = (0, registry_1.findClient)(options.client);
-        if (!found) {
-            output_1.log.error(`Unknown client: "${options.client}". Available: ${clientNames()}`);
-            process.exit(1);
-        }
-        clients = [found];
+    catch (e) {
+        output_1.log.error(e instanceof Error ? e.message : String(e));
+        process.exit(1);
     }
-    else {
-        clients = (0, registry_1.detectClients)(projectDir);
-        if (clients.length === 0) {
+    // User-facing log mirrors the historical install.ts output:
+    // - explicit --client → no extra noise
+    // - autodetect with hits → list detected clients
+    // - autodetect with no hits → warn we're falling back to the first
+    if (options.client === undefined) {
+        const detected = (0, registry_1.detectClients)(projectDir);
+        if (detected.length === 0) {
             output_1.log.warn(`No client detected. Defaulting to: ${registry_1.REGISTERED_CLIENTS[0].name}`);
-            clients = [registry_1.REGISTERED_CLIENTS[0]];
         }
         else {
-            const detected = clients.map((c) => c.name).join(", ");
-            output_1.log.info(`Detected client(s): ${output_1.pc.bold(detected)}`);
+            const names = detected.map((c) => c.name).join(", ");
+            output_1.log.info(`Detected client(s): ${output_1.pc.bold(names)}`);
         }
     }
     output_1.log.blank();

package/dist/commands/install.js.map

@@ -1 +1 @@
-{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":";;;AAAA,yCAAoC;AACpC,2BAAgC;AAChC,+BAA+B;AAE/B,kDAA2G;AAC3G,8CAAsD;AACtD,0CAAwC;AACxC,gDAAgD;AAEnC,QAAA,cAAc,GAAY,IAAI,mBAAO,CAAC,SAAS,CAAC;KACxD,WAAW,CAAC,yDAAyD,CAAC;KACtE,QAAQ,CAAC,eAAe,EAAE,0BAA0B,EAAE,GAAG,CAAC;KAC1D,MAAM,CAAC,iBAAiB,EAAE,0BAA0B,IAAA,sBAAW,GAAE,aAAa,CAAC;KAC/E,MAAM,CAAC,KAAK,EAAE,GAAW,EAAE,OAA4B,EAAiB,EAAE;IACvE,MAAM,UAAU,GAAW,IAAA,cAAO,EAAC,GAAG,CAAC,CAAC;IAExC,IAAI,CAAC,IAAA,eAAU,EAAC,UAAU,CAAC,EAAE,CAAC;QAC1B,YAAG,CAAC,KAAK,CAAC,wBAAwB,UAAU,EAAE,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,IAAI,OAAkB,CAAC;IACvB,IAAI,CAAC;QACD,OAAO,GAAG,IAAA,+BAAoB,EAAC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QAClB,YAAG,CAAC,KAAK,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,4DAA4D;IAC5D,uCAAuC;IACvC,iDAAiD;IACjD,mEAAmE;IACnE,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAc,IAAA,wBAAa,EAAC,UAAU,CAAC,CAAC;QACtD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,YAAG,CAAC,IAAI,CAAC,sCAAsC,6BAAkB,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACjF,CAAC;aAAM,CAAC;YACJ,MAAM,KAAK,GAAW,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAU,EAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9E,YAAG,CAAC,IAAI,CAAC,uBAAuB,WAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACtD,CAAC;IACL,CAAC;IAED,YAAG,CAAC,KAAK,EAAE,CAAC;IACZ,IAAA,0BAAiB,EAAC,UAAU,CAAC,CAAC;IAE9B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/B,CAAC;IAED,YAAG,CAAC,KAAK,EAAE,CAAC;IACZ,YAAG,CAAC,KAAK,CAAC,SAAS,EAAE,WAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;IACzC,YAAG,CAAC,KAAK,EAAE,CAAC;IACZ,YAAG,CAAC,OAAO,CAAC,sBAAsB,WAAE,CAAC,GAAG,CAAC,sDAAsD,CAAC,EAAE,CAAC,CAAC;IACpG,MAAM,IAAA,wBAAY,EAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAU,EAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACpE,CAAC,CAAC,CAAC"}

package/dist/commands/process-analytics.d.ts

@@ -0,0 +1,18 @@
+/**
+ * IronBee CLI — `ironbee process-analytics ...`
+ *
+ * Detached-worker entry point for analytics projection on the Stop hook.
+ * Stop hooks fire-and-forget this worker (via `spawnDetachedAnalyticsWorker`)
+ * so the host hook returns in ~ms while the (now-ish heavy) projection +
+ * emit runs out-of-band. The worker calls `emitAnalytics` with the same
+ * inputs the in-hook path would have used.
+ *
+ * NOT used by SessionEnd — that path runs synchronously inline so the final
+ * `is_final: true` snapshot is queued before the process exits.
+ *
+ * Failures here log to the per-session `analytics.log` and exit gracefully;
+ * the parent hook is unaffected.
+ */
+import { Command } from "commander";
+export declare const processAnalyticsCommand: Command;
+//# sourceMappingURL=process-analytics.d.ts.map

package/dist/commands/process-analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-analytics.d.ts","sourceRoot":"","sources":["../../src/commands/process-analytics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAcpC,eAAO,MAAM,uBAAuB,EAAE,OAoChC,CAAC"}

package/dist/commands/process-analytics.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * IronBee CLI — `ironbee process-analytics ...`
+ *
+ * Detached-worker entry point for analytics projection on the Stop hook.
+ * Stop hooks fire-and-forget this worker (via `spawnDetachedAnalyticsWorker`)
+ * so the host hook returns in ~ms while the (now-ish heavy) projection +
+ * emit runs out-of-band. The worker calls `emitAnalytics` with the same
+ * inputs the in-hook path would have used.
+ *
+ * NOT used by SessionEnd — that path runs synchronously inline so the final
+ * `is_final: true` snapshot is queued before the process exits.
+ *
+ * Failures here log to the per-session `analytics.log` and exit gracefully;
+ * the parent hook is unaffected.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.processAnalyticsCommand = void 0;
+const commander_1 = require("commander");
+const logger_1 = require("../lib/logger");
+const emit_1 = require("../analytics/emit");
+const log_1 = require("../analytics/log");
+exports.processAnalyticsCommand = new commander_1.Command("process-analytics")
+    .description("Internal worker — project + emit a session_analytics snapshot for one trigger")
+    .requiredOption("--project <dir>", "project directory (where .ironbee/sessions/<sid>/ lives)")
+    .requiredOption("--session <id>", "session id")
+    .requiredOption("--trigger <type>", "Stop | SessionEnd")
+    .option("--end-reason <reason>", "SessionEnd reason (optional)")
+    .option("--transcript-source <src>", "claude-code | cursor | missing")
+    .action(async (opts) => {
+    const triggerType = opts.trigger === "SessionEnd" ? "SessionEnd" : "Stop";
+    const transcriptSource = opts.transcriptSource
+        ?? "claude-code";
+    // Mirror the hook's session.log path so debug lines from collector,
+    // queue, etc. follow the worker too.
+    (0, logger_1.setLogFile)(`${opts.project}/.ironbee/sessions/${opts.session}/session.log`);
+    const log = new log_1.AnalyticsLog(opts.project, opts.session);
+    log.info(`worker: process-analytics start (trigger=${triggerType} session=${opts.session}`
+        + `${opts.endReason ? ` end_reason=${opts.endReason}` : ""})`);
+    try {
+        const outcome = await (0, emit_1.emitAnalytics)({
+            projectDir: opts.project,
+            sessionId: opts.session,
+            triggerType,
+            endReason: opts.endReason,
+            transcriptSource,
+            log,
+        });
+        log.info(`worker: process-analytics done (status=${outcome.status} reason=${outcome.reason})`);
+    }
+    catch (e) {
+        // emitAnalytics has its own outer try/catch; this is belt-and-suspenders.
+        logger_1.logger.debug(`process-analytics: unexpected error: ${e instanceof Error ? e.message : e}`);
+        log.error(`worker: unexpected error: ${e instanceof Error ? e.message : e}`);
+    }
+});
+//# sourceMappingURL=process-analytics.js.map

package/dist/commands/process-analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-analytics.js","sourceRoot":"","sources":["../../src/commands/process-analytics.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAEH,yCAAoC;AACpC,0CAAmD;AACnD,4CAA4E;AAC5E,0CAAgD;AAWnC,QAAA,uBAAuB,GAAY,IAAI,mBAAO,CAAC,mBAAmB,CAAC;KAC3E,WAAW,CAAC,+EAA+E,CAAC;KAC5F,cAAc,CAAC,iBAAiB,EAAE,0DAA0D,CAAC;KAC7F,cAAc,CAAC,gBAAgB,EAAE,YAAY,CAAC;KAC9C,cAAc,CAAC,kBAAkB,EAAE,mBAAmB,CAAC;KACvD,MAAM,CAAC,uBAAuB,EAAE,8BAA8B,CAAC;KAC/D,MAAM,CAAC,2BAA2B,EAAE,gCAAgC,CAAC;KACrE,MAAM,CAAC,KAAK,EAAE,IAA6B,EAAiB,EAAE;IAC3D,MAAM,WAAW,GAAgB,IAAI,CAAC,OAAO,KAAK,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC;IACvF,MAAM,gBAAgB,GAAsB,IAAI,CAAC,gBAAiD;WAC3F,aAAa,CAAC;IAErB,oEAAoE;IACpE,qCAAqC;IACrC,IAAA,mBAAU,EAAC,GAAG,IAAI,CAAC,OAAO,sBAAsB,IAAI,CAAC,OAAO,cAAc,CAAC,CAAC;IAC5E,MAAM,GAAG,GAAiB,IAAI,kBAAY,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACvE,GAAG,CAAC,IAAI,CACJ,4CAA4C,WAAW,YAAY,IAAI,CAAC,OAAO,EAAE;UAC/E,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAChE,CAAC;IAEF,IAAI,CAAC;QACD,MAAM,OAAO,GAAgB,MAAM,IAAA,oBAAa,EAAC;YAC7C,UAAU,EAAE,IAAI,CAAC,OAAO;YACxB,SAAS,EAAE,IAAI,CAAC,OAAO;YACvB,WAAW;YACX,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,gBAAgB;YAChB,GAAG;SACN,CAAC,CAAC;QACH,GAAG,CAAC,IAAI,CAAC,0CAA0C,OAAO,CAAC,MAAM,WAAW,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IACnG,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QAClB,0EAA0E;QAC1E,eAAM,CAAC,KAAK,CAAC,wCAAwC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC3F,GAAG,CAAC,KAAK,CAAC,6BAA6B,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACjF,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/commands/queue.d.ts

@@ -1,9 +1,8 @@
 /**
  * IronBee CLI — `ironbee queue ...` subcommands
  *
- * See docs/job-queue.md §6.4, §8.2.
- *
- * All operator commands are scoped to the current project directory — they
+ * Operator-facing commands: status / drain / dead-letter (list, stats, retry,
+ * clear) / purge. All are scoped to the current project directory — they
  * aggregate across every session's queue/ subdir by default, or narrow to a
  * single session via `--session <id>`.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/commands/queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6HpC,eAAO,MAAM,YAAY,EAAE,OACqC,CAAC"}
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/commands/queue.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6HpC,eAAO,MAAM,YAAY,EAAE,OACqC,CAAC"}

package/dist/commands/queue.js

@@ -2,9 +2,8 @@
 /**
  * IronBee CLI — `ironbee queue ...` subcommands
  *
- * See docs/job-queue.md §6.4, §8.2.
- *
- * All operator commands are scoped to the current project directory — they
+ * Operator-facing commands: status / drain / dead-letter (list, stats, retry,
+ * clear) / purge. All are scoped to the current project directory — they
  * aggregate across every session's queue/ subdir by default, or narrow to a
  * single session via `--session <id>`.
  */