@claude-transcripts/cli 0.6.0 → 0.6.1

package/dist/{app-h6q0k2rz.js → app-zjbeac0e.js}

@@ -7,7 +7,7 @@ import {
   cliArgLabel,
   CLI_SPEC,
   COMMANDS
-} from "./cli-tspndnr8.js";
+} from "./cli-3frjxyqc.js";
 import {
   __toESM,
   __commonJS,

package/dist/{cli-tspndnr8.js → cli-3frjxyqc.js}

@@ -1,4 +1,91 @@
 // @bun
+// packages/shared/src/blueprint/actions.ts
+var ACTIONS = [
+  {
+    key: "write-event-marker",
+    summary: "Append a light append-only event marker doc",
+    implemented: true
+  },
+  {
+    key: "update-counts",
+    summary: "Bump per-session counters (events/prompts/errors/tools)",
+    implemented: true
+  },
+  {
+    key: "flush-transcript-chunk",
+    summary: "Tail the transcript \u2192 append chunk docs",
+    implemented: true
+  },
+  { key: "write-summary", summary: "Write summary:<id> at session end", implemented: true },
+  {
+    key: "upload-blobs",
+    summary: "Upload summary.json + transcript.jsonl to S3",
+    implemented: true
+  },
+  {
+    key: "seed-session-start",
+    summary: "Reset counters + seed the chunk offset at start",
+    implemented: true
+  },
+  {
+    key: "announce-recording",
+    summary: "Tell the user, in the transcript, whether and where this session is recorded",
+    implemented: true
+  },
+  {
+    key: "inject-recall-policy",
+    summary: "Prime the session with the recall policy + how much history this cwd has",
+    implemented: true
+  },
+  { key: "enrich-metadata", summary: "Post additional session metadata", implemented: false },
+  {
+    key: "extract-feature",
+    summary: "Map-reduce feature extraction (urls/repos/PRs/\u2026)",
+    implemented: false
+  },
+  { key: "detect-memory-write", summary: "Flag Edit/Write to memory paths", implemented: false },
+  { key: "app-log", summary: "Emit an operational log record (app-logs DB)", implemented: false },
+  {
+    key: "index-for-search",
+    summary: "Push derived content to the search backend",
+    implemented: false
+  },
+  {
+    key: "reconcile-session",
+    summary: "Finalize a stale running session from chunks/S3",
+    implemented: false
+  }
+];
+var BINDINGS = [
+  {
+    event: "SessionStart",
+    actions: [
+      "seed-session-start",
+      "write-event-marker",
+      "announce-recording",
+      "inject-recall-policy"
+    ]
+  },
+  {
+    event: "UserPromptSubmit",
+    actions: ["write-event-marker", "update-counts", "flush-transcript-chunk"]
+  },
+  {
+    event: "PostToolUse",
+    actions: ["write-event-marker", "update-counts", "flush-transcript-chunk"]
+  },
+  {
+    event: "PostToolUseFailure",
+    actions: ["write-event-marker", "update-counts", "flush-transcript-chunk"]
+  },
+  { event: "Stop", actions: ["write-event-marker", "flush-transcript-chunk"] },
+  { event: "SubagentStart", actions: ["write-event-marker", "update-counts"] },
+  { event: "SubagentStop", actions: ["write-event-marker", "update-counts"] },
+  { event: "StopFailure", actions: ["write-event-marker", "update-counts"] },
+  { event: "PreCompact", actions: ["write-event-marker"] },
+  { event: "PostCompact", actions: ["write-event-marker"] },
+  { event: "SessionEnd", actions: ["flush-transcript-chunk", "write-summary", "upload-blobs"] }
+];
 // packages/shared/src/blueprint/cli-project.ts
 var isFlag = (a) => a.name.startsWith("--");
 function cliArgType(a) {
@@ -673,14 +760,20 @@ var CLI_SPEC = {
       args: [
         {
           name: "action",
-          choices: ["run", "install", "uninstall", "status"],
+          choices: ["run", "upload", "install", "uninstall", "status"],
           default: "status",
-          description: "`run` reads one event payload from stdin (Claude Code calls this)"
+          description: "`run` reads one event payload from stdin (Claude Code calls this); `upload` " + "ships one transcript to S3 (SessionEnd starts it detached)"
         },
         { name: "--dry-run", description: "with `install`: show the change without writing" },
         {
           name: "--force",
           description: "with `install`: register even if the plugin already does"
+        },
+        { name: "--session", type: "string", description: "with `upload`: the session id" },
+        {
+          name: "--transcript",
+          type: "string",
+          description: "with `upload`: the transcript file to ship"
         }
       ],
       examples: ["hook status", "hook install --dry-run"]
@@ -717,93 +810,6 @@ var CLI_SPEC = {
   ]
 };
 
-// packages/shared/src/blueprint/actions.ts
-var ACTIONS = [
-  {
-    key: "write-event-marker",
-    summary: "Append a light append-only event marker doc",
-    implemented: true
-  },
-  {
-    key: "update-counts",
-    summary: "Bump per-session counters (events/prompts/errors/tools)",
-    implemented: true
-  },
-  {
-    key: "flush-transcript-chunk",
-    summary: "Tail the transcript \u2192 append chunk docs",
-    implemented: true
-  },
-  { key: "write-summary", summary: "Write summary:<id> at session end", implemented: true },
-  {
-    key: "upload-blobs",
-    summary: "Upload summary.json + transcript.jsonl to S3",
-    implemented: true
-  },
-  {
-    key: "seed-session-start",
-    summary: "Reset counters + seed the chunk offset at start",
-    implemented: true
-  },
-  {
-    key: "announce-recording",
-    summary: "Tell the user, in the transcript, whether and where this session is recorded",
-    implemented: true
-  },
-  {
-    key: "inject-recall-policy",
-    summary: "Prime the session with the recall policy + how much history this cwd has",
-    implemented: true
-  },
-  { key: "enrich-metadata", summary: "Post additional session metadata", implemented: false },
-  {
-    key: "extract-feature",
-    summary: "Map-reduce feature extraction (urls/repos/PRs/\u2026)",
-    implemented: false
-  },
-  { key: "detect-memory-write", summary: "Flag Edit/Write to memory paths", implemented: false },
-  { key: "app-log", summary: "Emit an operational log record (app-logs DB)", implemented: false },
-  {
-    key: "index-for-search",
-    summary: "Push derived content to the search backend",
-    implemented: false
-  },
-  {
-    key: "reconcile-session",
-    summary: "Finalize a stale running session from chunks/S3",
-    implemented: false
-  }
-];
-var BINDINGS = [
-  {
-    event: "SessionStart",
-    actions: [
-      "seed-session-start",
-      "write-event-marker",
-      "announce-recording",
-      "inject-recall-policy"
-    ]
-  },
-  {
-    event: "UserPromptSubmit",
-    actions: ["write-event-marker", "update-counts", "flush-transcript-chunk"]
-  },
-  {
-    event: "PostToolUse",
-    actions: ["write-event-marker", "update-counts", "flush-transcript-chunk"]
-  },
-  {
-    event: "PostToolUseFailure",
-    actions: ["write-event-marker", "update-counts", "flush-transcript-chunk"]
-  },
-  { event: "Stop", actions: ["write-event-marker", "flush-transcript-chunk"] },
-  { event: "SubagentStart", actions: ["write-event-marker", "update-counts"] },
-  { event: "SubagentStop", actions: ["write-event-marker", "update-counts"] },
-  { event: "StopFailure", actions: ["write-event-marker", "update-counts"] },
-  { event: "PreCompact", actions: ["write-event-marker"] },
-  { event: "PostCompact", actions: ["write-event-marker"] },
-  { event: "SessionEnd", actions: ["flush-transcript-chunk", "write-summary", "upload-blobs"] }
-];
 // packages/shared/src/blueprint/env.ts
 var ENV_VARS = [
   {
@@ -2416,43 +2422,6 @@ function buildChunkEntries(jsonl) {
   return out;
 }
 
-// packages/cli/src/lib/args.ts
-function parseFlags(argv) {
-  const positionals = [];
-  const options = {};
-  for (let i = 0;i < argv.length; i++) {
-    const a = argv[i];
-    if (a === undefined)
-      continue;
-    if (a.startsWith("--")) {
-      const body = a.slice(2);
-      const eq = body.indexOf("=");
-      if (eq >= 0) {
-        options[body.slice(0, eq)] = body.slice(eq + 1);
-      } else {
-        const next = argv[i + 1];
-        if (next !== undefined && !next.startsWith("--")) {
-          options[body] = next;
-          i++;
-        } else {
-          options[body] = true;
-        }
-      }
-    } else {
-      positionals.push(a);
-    }
-  }
-  return { positionals, options };
-}
-function strOpt(opts, key) {
-  const v = opts[key];
-  return typeof v === "string" ? v : undefined;
-}
-
-// packages/cli/src/lib/version.ts
-var DEV_VERSION = "0.0.0-dev";
-var VERSION = process.env.CT_VERSION ?? DEV_VERSION;
-
 // packages/cli/src/commands/backfill.ts
 import { hostname } from "os";
 
@@ -2616,6 +2585,39 @@ async function putRaw(path, body, contentType) {
   }
 }
 
+// packages/cli/src/lib/args.ts
+function parseFlags(argv) {
+  const positionals = [];
+  const options = {};
+  for (let i = 0;i < argv.length; i++) {
+    const a = argv[i];
+    if (a === undefined)
+      continue;
+    if (a.startsWith("--")) {
+      const body = a.slice(2);
+      const eq = body.indexOf("=");
+      if (eq >= 0) {
+        options[body.slice(0, eq)] = body.slice(eq + 1);
+      } else {
+        const next = argv[i + 1];
+        if (next !== undefined && !next.startsWith("--")) {
+          options[body] = next;
+          i++;
+        } else {
+          options[body] = true;
+        }
+      }
+    } else {
+      positionals.push(a);
+    }
+  }
+  return { positionals, options };
+}
+function strOpt(opts, key) {
+  const v = opts[key];
+  return typeof v === "string" ? v : undefined;
+}
+
 // packages/cli/src/lib/claude-fs.ts
 import { readdir, readFile } from "fs/promises";
 import { homedir as homedir2 } from "os";
@@ -4162,6 +4164,12 @@ import { dirname as dirname2 } from "path";
 
 // packages/cli/src/lib/statusline.ts
 import { statSync } from "fs";
+
+// packages/cli/src/lib/version.ts
+var DEV_VERSION = "0.0.0-dev";
+var VERSION = process.env.CT_VERSION ?? DEV_VERSION;
+
+// packages/cli/src/lib/statusline.ts
 var STALL_AFTER_MS = 60000;
 var HOOK_SILENT_AFTER_MS = 5 * 60000;
 function transcriptMtimeMs(path) {
@@ -4349,6 +4357,31 @@ import {
 import { hostname as hostname4 } from "os";
 var {S3Client } = globalThis.Bun;
 
+// packages/cli/src/hook/detach.ts
+import { spawn } from "child_process";
+function cliArgv() {
+  const exec = process.execPath;
+  if (!/\/bun$/.test(exec))
+    return [exec];
+  return [exec, "run", Bun.main];
+}
+function spawnDetached(argv) {
+  const [cmd, ...args] = argv;
+  if (!cmd)
+    return false;
+  try {
+    const child = spawn(cmd, args, { detached: true, stdio: "ignore", cwd: "/" });
+    child.on("error", () => {});
+    child.unref();
+    return child.pid !== undefined;
+  } catch {
+    return false;
+  }
+}
+function uploadArgv(sessionId, transcriptPath) {
+  return [...cliArgv(), "hook", "upload", "--session", sessionId, "--transcript", transcriptPath];
+}
+
 // packages/cli/src/hook/mirror.ts
 var DEFAULT_TIMEOUT_MS = 2000;
 var DEFAULT_BLOB_TIMEOUT_MS = 60000;
@@ -4806,7 +4839,8 @@ function buildContext(payload, config) {
     counts: makeCounts(sessionId),
     targets,
     sessionsDb,
-    sessionsBucket: config.blob?.buckets.sessions
+    sessionsBucket: config.blob?.buckets.sessions,
+    detachUpload: (sid, path) => spawnDetached(uploadArgv(sid, path))
   };
 }
 function commonFields(ctx) {
@@ -5097,16 +5131,21 @@ var writeSummary = async (ctx) => {
   }
   ctx.targets.clear();
 };
-var uploadBlobs = async (ctx) => {
-  if (!ctx.blob.enabled || !ctx.sessionsBucket || !ctx.transcriptPath)
-    return;
+async function uploadTranscript(blob, bucket, sessionId, transcriptPath) {
   let data;
   try {
-    data = readFileSync5(ctx.transcriptPath, "utf8");
+    data = readFileSync5(transcriptPath, "utf8");
   } catch {
     return;
   }
-  await ctx.blob.put(ctx.sessionsBucket, `${ctx.sessionId}/transcript.jsonl`, data, "application/x-ndjson");
+  await blob.put(bucket, `${sessionId}/transcript.jsonl`, data, "application/x-ndjson");
+}
+var uploadBlobs = async (ctx) => {
+  if (!ctx.blob.enabled || !ctx.sessionsBucket || !ctx.transcriptPath)
+    return;
+  if (ctx.detachUpload(ctx.sessionId, ctx.transcriptPath))
+    return;
+  await uploadTranscript(ctx.blob, ctx.sessionsBucket, ctx.sessionId, ctx.transcriptPath);
 };
 var HANDLERS = {
   "seed-session-start": seedSessionStart,
@@ -5127,9 +5166,9 @@ function hookBindings() {
     out[b.event] = b.actions;
   return out;
 }
-var LONG_TIMEOUT_EVENTS = new Set(["SessionStart", "SessionEnd"]);
+var TIMEOUTS = { SessionStart: 180, SessionEnd: 60 };
 function hookTimeout(event) {
-  return LONG_TIMEOUT_EVENTS.has(event) ? 180 : 5;
+  return TIMEOUTS[event] ?? 5;
 }
 var SYNCHRONOUS_EVENTS = new Set(["SessionStart", "SessionEnd", "UserPromptSubmit"]);
 function hookAsync(event) {
@@ -5238,11 +5277,8 @@ function hookCommand() {
   return hookLaunch(`${cliInvocation()} hook run`);
 }
 function cliInvocation() {
-  const exec = process.execPath;
-  const isCompiled = !/\/bun$/.test(exec);
-  if (isCompiled)
-    return `"${exec}"`;
-  return `"${exec}" run "${Bun.main}"`;
+  const [exec, , entry] = cliArgv();
+  return entry ? `"${exec}" run "${entry}"` : `"${exec}"`;
 }
 function isOurCommand(command) {
   if (!command?.includes("hook run"))
@@ -5421,11 +5457,34 @@ async function run() {
   }
   return 0;
 }
+var UPLOAD_DEADLINE_MS = 10 * 60000;
+async function upload(argv) {
+  setTimeout(() => process.exit(0), UPLOAD_DEADLINE_MS).unref();
+  const { options } = parseFlags(argv);
+  const sessionId = strOpt(options, "session");
+  const transcriptPath = strOpt(options, "transcript");
+  if (!sessionId || !transcriptPath) {
+    console.error("hook: upload needs --session <id> --transcript <path>");
+    return 0;
+  }
+  try {
+    const config = loadHookConfig(installPaths().hookConfig);
+    const bucket = config?.blob?.buckets.sessions;
+    if (!config || !bucket)
+      return 0;
+    await uploadTranscript(makeBlob(config), bucket, sessionId, transcriptPath);
+  } catch (err) {
+    console.error("[hook] upload failed (ignored):", err);
+  }
+  return 0;
+}
 async function runHook(argv) {
   const [sub = "status", ...rest] = argv;
   switch (sub) {
     case "run":
       return run();
+    case "upload":
+      return upload(rest);
     case "install":
       return install(rest);
     case "uninstall":
@@ -5433,7 +5492,7 @@ async function runHook(argv) {
     case "status":
       return status();
     default:
-      console.error(`hook: unknown subcommand "${sub}" (run | install | uninstall | status)`);
+      console.error(`hook: unknown subcommand "${sub}" (run | upload | install | uninstall | status)`);
       return 2;
   }
 }

package/dist/cli.js

@@ -7,13 +7,13 @@ import {
   parseFlags,
   VERSION,
   COMMANDS
-} from "./cli-tspndnr8.js";
+} from "./cli-3frjxyqc.js";
 
 // packages/cli/src/cli.tsx
 var [, , first, ...rest] = process.argv;
 var USAGE_ERROR = 2;
 async function showHelp(props, stream = process.stdout) {
-  const { renderHelp } = await import("./app-h6q0k2rz.js");
+  const { renderHelp } = await import("./app-zjbeac0e.js");
   renderHelp(props, stream);
 }
 var argv = first === undefined ? [] : [first, ...rest];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claude-transcripts/cli",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "type": "module",
   "description": "Claude Transcripts CLI — browse, search, back up, and administer your self-hosted Claude Code session history.",
   "keywords": [