@vibe-commit/capture 0.9.0 → 0.11.0

package/dist/uploader_view.js

@@ -0,0 +1,106 @@
+/**
+ * WHAT `vibecommit status` SAYS ABOUT THE BACKGROUND UPLOADER — U7 (plan §3.8).
+ *
+ * ⛔ COMPUTED FROM FIRING LOGS AGAINST LEDGERS, NEVER FROM THE WORKER'S OWN CLAIM. A worker that died mid-step leaves a status file that says
+ * "running" forever; trusting it would show a dead uploader as healthy (memory: live-state-must-prove-it-is-current). So "how far behind" is the
+ * firings nobody has consumed (the hook's own record) measured against what the ledgers say was acknowledged, and "is it running" is the worker's
+ * LOCK being fresh (`uploaderAlive`, which dates the lock the way the hook does), with the status file consulted only for WHEN and HOW the last
+ * attempts went.
+ *
+ * `sessions_checked` is the denominator: how many firing logs were looked at. An empty scan (0 of 0) is a different answer than "checked 40, all caught up",
+ * and the JSON says which.
+ *
+ * Counts, classes and times only. No session id, path or body leaves this module.
+ */
+import { STATUS, relativeAge } from "./copy/index.js";
+import { firingSessions, readCursor, readFirings } from "./firing.js";
+import { uploaderAlive } from "./hooks/fire_lock.js";
+import { identityDigest } from "./identity.js";
+import { ingestUrl } from "./post.js";
+import { loadTargetRecord } from "./session_targets.js";
+import { fileState, loadSessionState } from "./state.js";
+import { labelled } from "./term.js";
+import { readUploaderStatus } from "./uploader_status.js";
+const DELIVERED = new Set(["done:delivered", "drain:delivered", "more"]);
+function problemOf(klass) {
+    if (klass === "later" || klass === "drain:later")
+        return "no_answer";
+    if (klass.startsWith("fatal:") || klass === "drain:fatal")
+        return "credential";
+    if (klass.startsWith("threw:") || klass === "escaped")
+        return "error";
+    return null;
+}
+export function uploaderView(home, env, nowMs) {
+    const stems = firingSessions(home);
+    let sessions = 0;
+    let bytes = 0;
+    for (const stem of stems) {
+        const cursor = readCursor(home, stem);
+        const owed = readFirings(home, stem, cursor.offset).firings;
+        if (owed.length === 0)
+            continue;
+        sessions += 1;
+        // What the NEWEST owed firing wants delivered, less what the slowest of the session's ledgers has acknowledged. A session the worker has not
+        // reached has no record yet: all of it is owed.
+        const last = owed[owed.length - 1].firing;
+        const record = loadTargetRecord(home, last.sid);
+        const acked = record === null || record.targets.length === 0
+            ? 0
+            : Math.min(...record.targets.map((target) => fileState(loadSessionState(home, { repoKey: target.ledgerKey, sessionId: last.sid }), "main").sentOffset));
+        bytes += Math.max(0, last.eof - acked);
+    }
+    const url = ingestUrl(env);
+    const identity = url === null ? null : identityDigest({ url, env });
+    const status = identity === null ? null : readUploaderStatus(home, identity);
+    const alive = identity !== null && uploaderAlive(home, identity, nowMs);
+    const outcomes = status?.outcomes ?? [];
+    const ack = [...outcomes].reverse().find((outcome) => DELIVERED.has(outcome.class)) ?? null;
+    const attempt = outcomes.length === 0 ? null : outcomes[outcomes.length - 1];
+    const problem = attempt === null ? null : problemOf(attempt.class);
+    let state;
+    if (sessions === 0)
+        state = "up_to_date";
+    else if (!alive)
+        state = "not_running";
+    else if (problem === "no_answer" && (ack === null || attempt === null || attempt.at >= ack.at))
+        state = "waiting_to_retry";
+    else
+        state = "sending";
+    return {
+        state,
+        heartbeatAgeMs: status === null ? null : Math.max(0, nowMs - status.heartbeatAt),
+        behind: { sessions, bytes, sessionsChecked: stems.length },
+        lastAckAtMs: ack === null ? null : ack.at,
+        lastAttempt: attempt === null ? null : { atMs: attempt.at, outcome: attempt.class, problem, elapsedMs: attempt.elapsedMs },
+    };
+}
+/** The `--json` `uploader` object (plan §3.8). `last_attempt.status` is `null`: the worker records the class of an attempt, not an HTTP status (a recorded deviation). */
+export function uploaderJson(view) {
+    return {
+        state: view.state,
+        heartbeat_age_ms: view.heartbeatAgeMs,
+        behind: { sessions: view.behind.sessions, bytes: view.behind.bytes, sessions_checked: view.behind.sessionsChecked },
+        last_ack_at_ms: view.lastAckAtMs,
+        last_attempt: view.lastAttempt === null ? null : { at_ms: view.lastAttempt.atMs, outcome: view.lastAttempt.outcome, status: null, elapsed_ms: view.lastAttempt.elapsedMs },
+    };
+}
+/** The screen rows: none until something has ever been recorded for upload (an empty scan says nothing, and the JSON still reports `sessions_checked: 0`). */
+export function uploaderRows(view, nowMs, indent) {
+    if (view.behind.sessionsChecked === 0)
+        return [];
+    const rows = [
+        labelled(indent, STATUS.uploadLabel, STATUS.uploadValue({
+            state: view.state,
+            sessions: view.behind.sessions,
+            bytes: view.behind.bytes,
+            ackAge: view.lastAckAtMs === null ? null : relativeAge(view.lastAckAtMs, nowMs),
+            attemptAge: view.lastAttempt === null ? null : relativeAge(view.lastAttempt.atMs, nowMs),
+            problem: view.lastAttempt?.problem ?? null,
+        })),
+    ];
+    if (view.state === "not_running")
+        rows.push(labelled(indent, "", STATUS.uploadNotRunning));
+    return rows;
+}
+//# sourceMappingURL=uploader_view.js.map

package/dist/uploader_view.js.map

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

package/dist/verbs.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The public verbs, in the order `--help` lists them.
+ *
+ * Its own module so `index.ts` can answer `isVerb` without importing a single verb: `index.ts` is the process a hook is, and
+ * it must stay free of the interactive half (`cli.ts`; `test/load-path.test.ts`). `renderHelp` iterates this list, so adding
+ * a verb here moves `test/help.golden.txt` on purpose. The hidden verbs (`hook`, `post-commit`, `post-rewrite`) are NOT here
+ * for exactly that reason.
+ */
+export declare const VERBS: readonly ["auth", "connect", "scan", "backfill", "status", "off", "why", "report", "finalize"];
+export type Verb = (typeof VERBS)[number];
+export declare function isVerb(value: string): value is Verb;

package/dist/verbs.js

@@ -0,0 +1,13 @@
+/**
+ * The public verbs, in the order `--help` lists them.
+ *
+ * Its own module so `index.ts` can answer `isVerb` without importing a single verb: `index.ts` is the process a hook is, and
+ * it must stay free of the interactive half (`cli.ts`; `test/load-path.test.ts`). `renderHelp` iterates this list, so adding
+ * a verb here moves `test/help.golden.txt` on purpose. The hidden verbs (`hook`, `post-commit`, `post-rewrite`) are NOT here
+ * for exactly that reason.
+ */
+export const VERBS = ["auth", "connect", "scan", "backfill", "status", "off", "why", "report", "finalize"];
+export function isVerb(value) {
+    return VERBS.includes(value);
+}
+//# sourceMappingURL=verbs.js.map

package/dist/verbs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verbs.js","sourceRoot":"","sources":["../src/verbs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,CAAU,CAAC;AAGpH,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,OAAQ,KAA2B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACtD,CAAC"}

package/dist/version.d.ts

@@ -11,6 +11,6 @@
  * fields on disk (D58 plan §ER5/§ER14). This constant plus the skew check is the
  * whole fix: one source, asserted equal to the manifest and to the release tag.
  */
-export declare const CLIENT_VERSION = "0.9.0";
+export declare const CLIENT_VERSION = "0.11.0";
 /** Header name for the wire contract. */
 export declare const CLIENT_VERSION_HEADER = "X-Client-Version";

package/dist/version.js

@@ -11,7 +11,7 @@
  * fields on disk (D58 plan §ER5/§ER14). This constant plus the skew check is the
  * whole fix: one source, asserted equal to the manifest and to the release tag.
  */
-export const CLIENT_VERSION = "0.9.0";
+export const CLIENT_VERSION = "0.11.0";
 /** Header name for the wire contract. */
 export const CLIENT_VERSION_HEADER = "X-Client-Version";
 //# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC,yCAAyC;AACzC,MAAM,CAAC,MAAM,qBAAqB,GAAG,kBAAkB,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC;AAEvC,yCAAyC;AACzC,MAAM,CAAC,MAAM,qBAAqB,GAAG,kBAAkB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-commit/capture",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "VibeCommit capture client \u2014 records Claude Code sessions against the commits they produced.",
   "license": "MIT",
   "type": "module",
@@ -43,5 +43,5 @@
     "tsx": "^4.19.2",
     "typescript": "^5.7.3"
   },
-  "gitHead": "51de4942744d9e8cd8c3c2e78331d340cdd596f6"
+  "gitHead": "7b05f0790d7c1bbcd3486e88b32e924a02e3ea49"
 }