@claude-transcripts/cli 0.2.0 → 0.3.1

package/dist/cli.js

@@ -39113,6 +39113,10 @@ async function errorDetail(res) {
     return "";
   }
 }
+async function exists(path) {
+  const res = await fetch(`${base2()}${path}`);
+  return res.ok;
+}
 async function getOrNull(path) {
   const res = await fetch(`${base2()}${path}`);
   if (!res.ok)
@@ -39327,6 +39331,9 @@ class DryRunSink {
   async existingSession() {
     return null;
   }
+  async hasTranscriptBlob() {
+    return true;
+  }
   async hasTurns() {
     return false;
   }
@@ -39360,6 +39367,9 @@ class WebapiSink {
     const res = await getOrNull(`/api/sessions/${encodeURIComponent(sessionId)}/turns?limit=1`);
     return (res?.turns?.length ?? 0) > 0;
   }
+  async hasTranscriptBlob(sessionId) {
+    return exists(`/api/s3/sessions/${encodeURIComponent(sessionId)}/transcript.jsonl`);
+  }
   async resetSession(sessionId) {
     const res = await resetSession(sessionId);
     return res.deleted;
@@ -39394,8 +39404,9 @@ function planReingest(existing, opts) {
   if (opts.repair) {
     if (existing.status === "running")
       return { action: "skip", reason: "running" };
-    if (opts.hasTurns)
-      return { action: "skip", reason: "has-turns" };
+    if (opts.hasTurns) {
+      return opts.hasBlob === false ? { action: "repair-blob" } : { action: "skip", reason: "has-turns" };
+    }
     return { action: "repair" };
   }
   if (!opts.force)
@@ -39463,7 +39474,8 @@ async function runBackfill(argv) {
       }
       const existing = dryRun ? null : await sink.existingSession(t.sessionId);
       const hasTurns = repair && existing ? await sink.hasTurns(t.sessionId) : false;
-      const plan = planReingest(existing, { force, replaceLive, repair, hasTurns });
+      const hasBlob = hasTurns ? await sink.hasTranscriptBlob(t.sessionId) : undefined;
+      const plan = planReingest(existing, { force, replaceLive, repair, hasTurns, hasBlob });
       if (plan.action === "skip") {
         if (plan.reason === "live-record") {
           console.warn(`  ! ${t.sessionId}: skipped \u2014 recorded live. --force would delete that record and ` + "rebuild it from the transcript, losing provenance only the hook had. Pass " + "--replace-live to do that deliberately.");
@@ -39473,11 +39485,18 @@ async function runBackfill(argv) {
           console.log(`  \xB7 ${t.sessionId}: skipped \u2014 still running`);
         }
         if (plan.reason === "has-turns") {
-          console.log(`  \xB7 ${t.sessionId}: skipped \u2014 already has turn content`);
+          console.log(`  \xB7 ${t.sessionId}: skipped \u2014 already has turn content and a transcript`);
         }
         skipped++;
         continue;
       }
+      if (plan.action === "repair-blob") {
+        const jsonl = await readTranscript(t.path);
+        await sink.putTranscript(t.sessionId, new TextEncoder().encode(jsonl));
+        console.log(`  + ${t.sessionId}: re-uploaded the transcript (chunks left alone)`);
+        repaired++;
+        continue;
+      }
       if (plan.action === "repair") {
         const jsonl = await readTranscript(t.path);
         const facts = deriveSessionFacts(jsonl, { hostname: host, sessionIdHint: t.sessionId });
@@ -40293,6 +40312,9 @@ function makeMirrorCouch(target, onWrite) {
     },
     async putDoc(_db, id, doc, timeoutMs) {
       await send({ ...doc, _id: id }, timeoutMs ?? fallback);
+    },
+    async upsertDoc(_db, id, doc, timeoutMs) {
+      await send({ ...doc, _id: id }, timeoutMs ?? fallback);
     }
   };
 }
@@ -40328,6 +40350,9 @@ function fanOutCouch(clients) {
     },
     async putDoc(db, id, doc, timeoutMs) {
       await Promise.allSettled(clients.map((c) => c.putDoc(db, id, doc, timeoutMs)));
+    },
+    async upsertDoc(db, id, doc, timeoutMs) {
+      await Promise.allSettled(clients.map((c) => c.upsertDoc(db, id, doc, timeoutMs)));
     }
   };
 }
@@ -40403,6 +40428,39 @@ function makeDirectCouch(config, onWrite) {
       } catch {
         onWrite?.(false);
       }
+    },
+    async upsertDoc(db, id, doc, timeoutMs = 5000) {
+      const url = `${root}/${db}/${encodeURIComponent(id)}`;
+      const put = (body) => fetch(url, {
+        method: "PUT",
+        headers,
+        body: JSON.stringify(body),
+        signal: AbortSignal.timeout(timeoutMs)
+      });
+      try {
+        const res = await put(doc);
+        if (res.status !== 409) {
+          onWrite?.(res.ok);
+          return;
+        }
+        const current = await fetch(url, {
+          headers,
+          signal: AbortSignal.timeout(timeoutMs)
+        });
+        if (!current.ok) {
+          onWrite?.(false);
+          return;
+        }
+        const { _rev } = await current.json();
+        if (!_rev) {
+          onWrite?.(false);
+          return;
+        }
+        const retry = await put({ ...doc, _rev });
+        onWrite?.(retry.ok);
+      } catch {
+        onWrite?.(false);
+      }
     }
   };
 }
@@ -40913,11 +40971,10 @@ var writeSummary = async (ctx) => {
     system_checks: {},
     source: "live"
   };
-  await ctx.couch.putDoc(ctx.sessionsDb, `summary:${ctx.sessionId}`, doc, 30000);
+  await ctx.couch.upsertDoc(ctx.sessionsDb, `summary:${ctx.sessionId}`, doc, 30000);
   if (ctx.blob.enabled && ctx.sessionsBucket) {
     await ctx.blob.put(ctx.sessionsBucket, `${ctx.sessionId}/summary.json`, JSON.stringify(doc), "application/json");
   }
-  ctx.counts.clear();
   ctx.targets.clear();
 };
 var uploadBlobs = async (ctx) => {
@@ -42121,6 +42178,9 @@ function ago(ms, now) {
     return `${m}m ago`;
   return `${Math.round(m / 60)}h ago`;
 }
+function versionLabel(version = VERSION) {
+  return `ct@${version === DEV_VERSION ? "dev" : version}`;
+}
 function whereLabel(t) {
   const host = t.couchUrl.replace(/^https?:\/\//, "").replace(/\/.*$/, "");
   return `${t.sessionsDb}@${host}`;
@@ -42131,11 +42191,12 @@ function storeState(s, now) {
   return s.lastWriteMs > 0 ? "healthy" : "idle";
 }
 function renderStatusline(state, now = Date.now()) {
+  const ct = versionLabel(state.version);
   if (!state.configured)
-    return "\u25CB ct off \xB7 no instance configured";
+    return `\u25CB ${ct} off \xB7 no instance configured`;
   const t = state.targets;
   if (!t)
-    return "\u25CB ct off \xB7 not recording this session";
+    return `\u25CB ${ct} off \xB7 not recording this session`;
   const c = state.counts;
   const toolCalls = c ? Object.values(c.tools).reduce((a, b) => a + b, 0) : 0;
   const counts = c ? `${c.events} ev \xB7 ${toolCalls} tools` : "0 ev";
@@ -42145,29 +42206,29 @@ function renderStatusline(state, now = Date.now()) {
     const failing = t.lastFailureMs > t.lastWriteMs && now - t.lastWriteMs > STALL_AFTER_MS;
     if (failing) {
       const last = written ? `last write ${ago(t.lastWriteMs, now)}` : "no write landed";
-      return `\u25D0 ct stalled \xB7 ${counts} \xB7 ${last} \u2192 ${whereLabel(t)}`;
+      return `\u25D0 ${ct} stalled \xB7 ${counts} \xB7 ${last} \u2192 ${whereLabel(t)}`;
     }
     if (!written)
-      return `\u25CC ct ready \xB7 ${counts} \xB7 no write yet \u2192 ${whereLabel(t)}`;
-    return `\u25CF ct rec \xB7 ${counts} \xB7 ${ago(t.lastWriteMs, now)} \u2192 ${whereLabel(t)}`;
+      return `\u25CC ${ct} ready \xB7 ${counts} \xB7 no write yet \u2192 ${whereLabel(t)}`;
+    return `\u25CF ${ct} rec \xB7 ${counts} \xB7 ${ago(t.lastWriteMs, now)} \u2192 ${whereLabel(t)}`;
   }
   const direct = stores.find((s) => s.kind === "direct") ?? stores[0];
   const headline = direct ?? { label: whereLabel(t), lastWriteMs: 0, lastFailureMs: 0 };
   if (direct && storeState(direct, now) === "healthy") {
-    return `\u25CF ct rec \xB7 ${counts} \xB7 ${ago(direct.lastWriteMs, now)} \u2192 ${direct.label}`;
+    return `\u25CF ${ct} rec \xB7 ${counts} \xB7 ${ago(direct.lastWriteMs, now)} \u2192 ${direct.label}`;
   }
   const healthyMirrors = stores.filter((s) => s !== direct && storeState(s, now) === "healthy");
   const first = healthyMirrors[0];
   if (first) {
     const more = healthyMirrors.length > 1 ? ` +${healthyMirrors.length - 1}` : "";
-    return `\u25CF ct rec (mirror) \xB7 ${counts} \xB7 ${ago(first.lastWriteMs, now)} \u2192 ${first.label}${more}`;
+    return `\u25CF ${ct} rec (mirror) \xB7 ${counts} \xB7 ${ago(first.lastWriteMs, now)} \u2192 ${first.label}${more}`;
   }
   if (stores.some((s) => storeState(s, now) === "failing")) {
     const best = Math.max(...stores.map((s) => s.lastWriteMs));
     const last = best > 0 ? `last write ${ago(best, now)}` : "no write landed";
-    return `\u25D0 ct stalled \xB7 ${counts} \xB7 ${last} \u2192 ${headline.label}`;
+    return `\u25D0 ${ct} stalled \xB7 ${counts} \xB7 ${last} \u2192 ${headline.label}`;
   }
-  return `\u25CC ct ready \xB7 ${counts} \xB7 no write yet \u2192 ${headline.label}`;
+  return `\u25CC ${ct} ready \xB7 ${counts} \xB7 no write yet \u2192 ${headline.label}`;
 }
 
 // packages/cli/src/commands/statusline.ts
@@ -42201,7 +42262,7 @@ async function render2() {
     process.stdout.write(`${line}
 `);
   } catch {
-    process.stdout.write(`\u25CB ct off
+    process.stdout.write(`\u25CB ${versionLabel()} off
 `);
   }
   return 0;
@@ -42775,7 +42836,7 @@ function tools(counts) {
 function summaryLine(s) {
   return row([
     [s.sessionId.slice(0, 8), 8],
-    [when(s.timestamp), 16],
+    [when(s.startTimestamp ?? s.timestamp), 16],
     [s.status, 10],
     [project2(s.cwd), 18],
     [num3(s.promptCount), 7],
@@ -42825,7 +42886,9 @@ async function showDetail(id, limit, json) {
     return 0;
   }
   console.log(`session ${s.sessionId}  [${s.status}]`);
-  console.log(`  started    ${s.timestamp ?? "\u2014"}`);
+  console.log(`  started    ${s.startTimestamp ?? s.timestamp ?? "\u2014"}`);
+  if (s.status === "ended")
+    console.log(`  ended      ${s.timestamp ?? "\u2014"}`);
   console.log(`  project    ${s.cwd || "\u2014"}`);
   console.log(`  model      ${s.model ?? "\u2014"}`);
   console.log(`  hostname   ${s.hostname || "\u2014"}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claude-transcripts/cli",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "type": "module",
   "description": "Claude Transcripts CLI — browse, search, back up, and administer your self-hosted Claude Code session history.",
   "keywords": [
@@ -34,7 +34,7 @@
     "LICENSE"
   ],
   "engines": {
-    "bun": ">=1.1.0"
+    "bun": ">=1.4.0"
   },
   "publishConfig": {
     "access": "public"