@indigoai-us/hq-cli 5.183.0 → 5.184.0

package/dist/lib/doctor/fix/refresh-sync-outcome.js

@@ -0,0 +1,25 @@
+/** Classify process/HTTP results without retaining their free-text details. */
+export function classifyRefreshSyncOutcome(observation) {
+    const details = String(observation.stdout ?? "") + "\n" + String(observation.stderr ?? "");
+    const errorCode = observation.errorCode ??
+        /\b(ETIMEDOUT|ETIME|EAI_AGAIN|ENOTFOUND|ECONNRESET|ECONNREFUSED|EHOSTUNREACH|ENETUNREACH|EPIPE|ECONNABORTED)\b/.exec(details)?.[1];
+    if (errorCode === "ETIMEDOUT" ||
+        errorCode === "ETIME" ||
+        observation.signal === "SIGTERM") {
+        return "pull-timeout";
+    }
+    if (!errorCode && observation.status === 0) {
+        return "pull-succeeded";
+    }
+    const httpStatus = /(?:HTTP(?:\/\d(?:\.\d)?)?\s+|status(?:\s+code)?\s*[=: ]\s*)([45]\d\d)\b/i.exec(details)?.[1] ?? "";
+    if (httpStatus.startsWith("4"))
+        return "pull-failed:4xx";
+    if (httpStatus.startsWith("5"))
+        return "pull-failed:5xx";
+    if (errorCode &&
+        /^(?:EAI_AGAIN|ENOTFOUND|ECONNRESET|ECONNREFUSED|EHOSTUNREACH|ENETUNREACH|EPIPE|ECONNABORTED)$/.test(errorCode)) {
+        return "pull-failed:network";
+    }
+    return "pull-failed:other";
+}
+//# sourceMappingURL=refresh-sync-outcome.js.map

package/dist/lib/doctor/json-output.d.ts

@@ -18,7 +18,7 @@
  * per-item result shape where both are optional.
  */
 import { type DoctorPlatform, type StatusCounts } from "./report.js";
-import type { DoctorStatus, FamilyRun } from "./types.js";
+import type { DoctorStatus, FamilyRun, SyncReasonCode } from "./types.js";
 /**
  * The `--json` schema version. Bump on any breaking change to the document
  * shape; the snapshot test in report.test.ts fails until the bump is
@@ -50,6 +50,10 @@ export interface DoctorJsonResult {
     family: string;
     /** Stable machine id for the check, e.g. `hooks.settings-present`. */
     checkId: string;
+    /** Stable classification for the sync family; contains no customer data. */
+    reasonCode?: SyncReasonCode;
+    /** Present only when this result's company opted in through hq-flags. */
+    clientHealthReasonCodesEnabled?: true;
     /** What was inspected. Present only when the result carries one. */
     target?: string;
     /** Human-readable explanation. */
@@ -92,6 +96,8 @@ export interface BuildDoctorJsonInput {
     platform?: DoctorPlatform;
     /** Families this run was restricted to. Omitted on a full run. */
     scope?: readonly string[];
+    /** Check ids whose own company enabled diagnostic reason codes in hq-flags. */
+    clientHealthReasonCodesEnabledCheckIds?: ReadonlySet<string>;
 }
 /** Assemble the machine-readable document from a completed run. */
 export declare function buildDoctorJson(input: BuildDoctorJsonInput): DoctorJsonDocument;

package/dist/lib/doctor/json-output.js

@@ -34,7 +34,7 @@ export function buildDoctorJson(input) {
     const results = [];
     for (const run of input.families) {
         for (const result of run.results) {
-            results.push(toJsonResult(run.family.id, result));
+            results.push(toJsonResult(run.family.id, result, input.clientHealthReasonCodesEnabledCheckIds));
         }
     }
     return {
@@ -48,12 +48,16 @@ export function buildDoctorJson(input) {
     };
 }
 /** Convert one {@link CheckResult} into its JSON form, omitting empty optionals. */
-function toJsonResult(familyId, result) {
+function toJsonResult(familyId, result, clientHealthReasonCodesEnabledCheckIds) {
     const remediation = deriveRemediation(result);
     return {
         status: result.status,
         family: familyId,
         checkId: result.checkId,
+        ...(result.reasonCode !== undefined ? { reasonCode: result.reasonCode } : {}),
+        ...(clientHealthReasonCodesEnabledCheckIds?.has(result.checkId)
+            ? { clientHealthReasonCodesEnabled: true }
+            : {}),
         ...(result.target !== undefined ? { target: result.target } : {}),
         message: result.message,
         ...(result.remediation !== undefined

package/dist/lib/doctor/types.d.ts

@@ -18,6 +18,9 @@ export declare const DOCTOR_STATUSES: readonly ["PASS", "FAIL", "WARN", "UNTESTE
  * the type system rejects any other string at every call site.
  */
 export type DoctorStatus = (typeof DOCTOR_STATUSES)[number];
+/** Stable, privacy-safe diagnostics emitted by the sync health family. */
+export declare const SYNC_REASON_CODES: readonly ["core-version-unavailable", "core-update-available", "no-local-tree", "never-synced", "invalid-last-sync", "stale-threshold", "manifest-unavailable", "manifest-state-unavailable", "no-manifest-scopes", "never-uploaded", "invalid-upload-time", "unresolved-company-uid"];
+export type SyncReasonCode = (typeof SYNC_REASON_CODES)[number];
 /** Runtime type guard: true only for a member of the fixed vocabulary. */
 export declare function isDoctorStatus(value: unknown): value is DoctorStatus;
 /** A single per-item result produced by a check family. */
@@ -26,6 +29,8 @@ export interface CheckResult {
     status: DoctorStatus;
     /** Stable machine id for this item, e.g. `hooks.settings-present`. */
     checkId: string;
+    /** Closed diagnostic enum; never contains paths, company slugs, or prose. */
+    reasonCode?: SyncReasonCode;
     /** What was inspected — a path, hook id, etc. Optional. */
     target?: string;
     /** Human-readable one-line explanation of the result. */

package/dist/lib/doctor/types.js

@@ -21,6 +21,21 @@ export const DOCTOR_STATUSES = [
     "UNKNOWN",
     "KNOWN-DEFECT",
 ];
+/** Stable, privacy-safe diagnostics emitted by the sync health family. */
+export const SYNC_REASON_CODES = [
+    "core-version-unavailable",
+    "core-update-available",
+    "no-local-tree",
+    "never-synced",
+    "invalid-last-sync",
+    "stale-threshold",
+    "manifest-unavailable",
+    "manifest-state-unavailable",
+    "no-manifest-scopes",
+    "never-uploaded",
+    "invalid-upload-time",
+    "unresolved-company-uid",
+];
 /** Runtime type guard: true only for a member of the fixed vocabulary. */
 export function isDoctorStatus(value) {
     return (typeof value === "string" &&

package/dist/lib/mesh/live/daemon/index.d.ts

@@ -22,6 +22,6 @@ export type { DaemonDoctorDeps, DaemonDoctorReport } from "./doctor.js";
 export { scopeBundleToAgentIdentity, } from "./credentials.js";
 export { FLUSH_INTERVAL_MS, DAEMON_VERSION_DRIFT_EXIT_CODE, SPOOL_DEBOUNCE_MS, runMeshDaemon, } from "./run.js";
 export type { DaemonHandle, DaemonRunDeps } from "./run.js";
-export { TRANSCRIPT_ADAPTER_VERSION, TRANSCRIPT_EVENT_SOURCE, TRANSCRIPT_FRESH_MS, TRANSCRIPT_HOOK_COVER_MS, TRANSCRIPT_MARKER, TRANSCRIPT_SESSION_END_MS, TRANSCRIPT_TURN_QUIET_MS, TRANSCRIPT_WATCH_BACKOFF_DURATION_MS, TRANSCRIPT_WATCH_BACKOFF_ENTRIES, TRANSCRIPT_WATCH_ENTRY_CAP, TRANSCRIPT_WATCH_INTERVAL_MAX_MS, TRANSCRIPT_WATCH_INTERVAL_MS, TRANSCRIPT_WATCH_REVALIDATE_MS, TranscriptWatcher, createTranscriptDiscoverCache, decodeClaudeProjectDirName, defaultTranscriptFs, discoverTranscripts, discoverTranscriptsWithMeta, isTranscriptHookCovered, nextTranscriptWatchIntervalMs, noteHookSessionsFromSpoolFile, resolveTranscriptRegistration, sessionIdFromClaudeTranscriptPath, sessionIdFromCodexTranscriptPath, sortDiscoveries, } from "./transcript-watch.js";
+export { TRANSCRIPT_ADAPTER_VERSION, TRANSCRIPT_EVENT_SOURCE, TRANSCRIPT_FRESH_MS, TRANSCRIPT_HOOK_COVER_MS, TRANSCRIPT_MARKER, TRANSCRIPT_SESSION_END_MS, TRANSCRIPT_HOOK_QUIET_ADOPT_MS, TRANSCRIPT_TURN_QUIET_MS, TRANSCRIPT_WATCH_BACKOFF_DURATION_MS, TRANSCRIPT_WATCH_BACKOFF_ENTRIES, TRANSCRIPT_WATCH_ENTRY_CAP, TRANSCRIPT_WATCH_INTERVAL_MAX_MS, TRANSCRIPT_WATCH_INTERVAL_MS, TRANSCRIPT_WATCH_REVALIDATE_MS, TranscriptWatcher, createTranscriptDiscoverCache, decodeClaudeProjectDirName, defaultTranscriptFs, discoverTranscripts, discoverTranscriptsWithMeta, isTranscriptHookCovered, nextTranscriptWatchIntervalMs, noteHookSessionsFromSpoolFile, resolveTranscriptRegistration, sessionIdFromClaudeTranscriptPath, sessionIdFromCodexTranscriptPath, sortDiscoveries, } from "./transcript-watch.js";
 export type { DiscoveredTranscript, DiscoverScanMeta, DiscoverTranscriptsResult, TranscriptDiscoverCache, TranscriptFs, TranscriptKind, TranscriptWatchDeps, TranscriptWatchTickResult, } from "./transcript-watch.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/mesh/live/daemon/index.js

@@ -11,5 +11,5 @@ export { daemonConfigPath, findAncestorHqRoot, isInstallableHqRoot, readDaemonCo
 export { UNHEALTHY_SPOOL_AGE_MS, collectDaemonDoctor, formatCliIdentityLines, formatCliMismatchLine, formatDaemonDoctor, listHqBinariesOnPath, } from "./doctor.js";
 export { scopeBundleToAgentIdentity, } from "./credentials.js";
 export { FLUSH_INTERVAL_MS, DAEMON_VERSION_DRIFT_EXIT_CODE, SPOOL_DEBOUNCE_MS, runMeshDaemon, } from "./run.js";
-export { TRANSCRIPT_ADAPTER_VERSION, TRANSCRIPT_EVENT_SOURCE, TRANSCRIPT_FRESH_MS, TRANSCRIPT_HOOK_COVER_MS, TRANSCRIPT_MARKER, TRANSCRIPT_SESSION_END_MS, TRANSCRIPT_TURN_QUIET_MS, TRANSCRIPT_WATCH_BACKOFF_DURATION_MS, TRANSCRIPT_WATCH_BACKOFF_ENTRIES, TRANSCRIPT_WATCH_ENTRY_CAP, TRANSCRIPT_WATCH_INTERVAL_MAX_MS, TRANSCRIPT_WATCH_INTERVAL_MS, TRANSCRIPT_WATCH_REVALIDATE_MS, TranscriptWatcher, createTranscriptDiscoverCache, decodeClaudeProjectDirName, defaultTranscriptFs, discoverTranscripts, discoverTranscriptsWithMeta, isTranscriptHookCovered, nextTranscriptWatchIntervalMs, noteHookSessionsFromSpoolFile, resolveTranscriptRegistration, sessionIdFromClaudeTranscriptPath, sessionIdFromCodexTranscriptPath, sortDiscoveries, } from "./transcript-watch.js";
+export { TRANSCRIPT_ADAPTER_VERSION, TRANSCRIPT_EVENT_SOURCE, TRANSCRIPT_FRESH_MS, TRANSCRIPT_HOOK_COVER_MS, TRANSCRIPT_MARKER, TRANSCRIPT_SESSION_END_MS, TRANSCRIPT_HOOK_QUIET_ADOPT_MS, TRANSCRIPT_TURN_QUIET_MS, TRANSCRIPT_WATCH_BACKOFF_DURATION_MS, TRANSCRIPT_WATCH_BACKOFF_ENTRIES, TRANSCRIPT_WATCH_ENTRY_CAP, TRANSCRIPT_WATCH_INTERVAL_MAX_MS, TRANSCRIPT_WATCH_INTERVAL_MS, TRANSCRIPT_WATCH_REVALIDATE_MS, TranscriptWatcher, createTranscriptDiscoverCache, decodeClaudeProjectDirName, defaultTranscriptFs, discoverTranscripts, discoverTranscriptsWithMeta, isTranscriptHookCovered, nextTranscriptWatchIntervalMs, noteHookSessionsFromSpoolFile, resolveTranscriptRegistration, sessionIdFromClaudeTranscriptPath, sessionIdFromCodexTranscriptPath, sortDiscoveries, } from "./transcript-watch.js";
 //# sourceMappingURL=index.js.map

package/dist/lib/mesh/live/daemon/transcript-watch.d.ts

@@ -62,6 +62,13 @@ export declare const TRANSCRIPT_START_RETRY_BASE_MS = 30000;
 export declare const TRANSCRIPT_START_RETRY_MAX_MS = 120000;
 /** Ignore cold transcripts whose mtime is older than this on first sight. */
 export declare const TRANSCRIPT_FRESH_MS: number;
+/**
+ * Hook-covered sessions skipped as "stale" on first sight never got a quiet
+ * session_end (live: skippedHook=411, ended=0). Adopt them for this long after
+ * last activity so a 10–120 min quiet window still reports after a daemon
+ * restart or a missed track. Older than this stays silent (the 6h reaper).
+ */
+export declare const TRANSCRIPT_HOOK_QUIET_ADOPT_MS: number;
 export declare const TRANSCRIPT_MARKER: "from transcript";
 export declare const TRANSCRIPT_ADAPTER_VERSION: string;
 /** Network `source` stamped on every synthesized event (AMEND-001). */

package/dist/lib/mesh/live/daemon/transcript-watch.js

@@ -67,6 +67,13 @@ export const TRANSCRIPT_START_RETRY_BASE_MS = 30_000;
 export const TRANSCRIPT_START_RETRY_MAX_MS = 120_000;
 /** Ignore cold transcripts whose mtime is older than this on first sight. */
 export const TRANSCRIPT_FRESH_MS = TRANSCRIPT_SESSION_END_MS;
+/**
+ * Hook-covered sessions skipped as "stale" on first sight never got a quiet
+ * session_end (live: skippedHook=411, ended=0). Adopt them for this long after
+ * last activity so a 10–120 min quiet window still reports after a daemon
+ * restart or a missed track. Older than this stays silent (the 6h reaper).
+ */
+export const TRANSCRIPT_HOOK_QUIET_ADOPT_MS = 2 * 60 * 60 * 1000;
 export const TRANSCRIPT_MARKER = "from transcript";
 export const TRANSCRIPT_ADAPTER_VERSION = CLI_VERSION;
 /** Network `source` stamped on every synthesized event (AMEND-001). */
@@ -521,13 +528,24 @@ export function noteHookSessionsFromSpoolFile(spoolPath, lastHookEventAt, atMs,
         if (!line.trim())
             continue;
         try {
-            const ev = JSON.parse(line);
+            const raw = JSON.parse(line);
+            const ev = raw.event && typeof raw.event === "object" ? raw.event : raw;
             if (typeof ev.sessionId !== "string" || !ev.sessionId)
                 continue;
             // Synthesized transcript events carry source=transcript — not hooks.
             if (ev.source === TRANSCRIPT_EVENT_SOURCE)
                 continue;
-            lastHookEventAt.set(ev.sessionId, atMs);
+            let eventAt = atMs;
+            const atRaw = typeof ev.at === "string" ? ev.at : undefined;
+            if (atRaw) {
+                const parsed = Date.parse(atRaw);
+                if (Number.isFinite(parsed))
+                    eventAt = parsed;
+            }
+            const prev = lastHookEventAt.get(ev.sessionId);
+            if (prev === undefined || eventAt > prev) {
+                lastHookEventAt.set(ev.sessionId, eventAt);
+            }
             noted.push(ev.sessionId);
         }
         catch {
@@ -739,7 +757,10 @@ export class TranscriptWatcher {
         const lastActivity = Math.max(d.mtimeMs, hookAt ?? 0);
         let track = this.tracked.get(d.path);
         if (!track) {
-            if (nowMs - lastActivity > TRANSCRIPT_FRESH_MS)
+            // Cold transcripts stay silent. Hook-covered sessions that already sat
+            // quiet past TRANSCRIPT_SESSION_END_MS still need one session_end — the
+            // live skip path returned here and never tracked them (US-051).
+            if (nowMs - lastActivity > TRANSCRIPT_HOOK_QUIET_ADOPT_MS)
                 return;
             track = {
                 path: d.path,
@@ -857,6 +878,7 @@ export class TranscriptWatcher {
             root: this.deps.workMeshRoot,
             env: this.deps.env,
             now: () => new Date(nowMs),
+            ...(kind === "session_end" ? { transcriptPath: track.path } : {}),
         };
         this.enqueueFn(opts);
     }

package/dist/lib/mesh/live/emit-client.d.ts

@@ -74,6 +74,9 @@ export interface MeshEmitEvent {
     status?: "queued" | "in_progress" | "review" | "done";
     reason?: string;
     summary?: string;
+    repo?: string;
+    gitBranch?: string;
+    prUrls?: string[];
     evidence?: EmitEvidence;
 }
 export interface BuildMeshEmitEventInput {
@@ -90,6 +93,9 @@ export interface BuildMeshEmitEventInput {
     status?: "queued" | "in_progress" | "review" | "done";
     reason?: string;
     summary?: string;
+    repo?: string;
+    gitBranch?: string;
+    prUrls?: string[];
     evidence?: EmitEvidence;
 }
 /**

package/dist/lib/mesh/live/emit-client.js

@@ -192,6 +192,14 @@ export function buildMeshEmitEvent(input) {
     const summary = keep(input.summary);
     if (summary)
         event.summary = summary;
+    const repo = keep(input.repo);
+    if (repo)
+        event.repo = repo;
+    const gitBranch = keep(input.gitBranch);
+    if (gitBranch)
+        event.gitBranch = gitBranch;
+    if (input.prUrls && input.prUrls.length > 0)
+        event.prUrls = input.prUrls;
     if (input.evidence && Object.keys(input.evidence).length > 0) {
         event.evidence = input.evidence;
     }

package/dist/lib/mesh/live/enqueue.d.ts

@@ -23,6 +23,11 @@ export interface EnqueueOptions {
     status?: "queued" | "in_progress" | "review" | "done";
     reason?: string;
     summary?: string;
+    repo?: string;
+    gitBranch?: string;
+    prUrls?: string[];
+    /** Local only: used to build a session_end summary; never written to the spool. */
+    transcriptPath?: string;
     cwd?: string;
     hqRoot?: string;
     companySlug?: string;

package/dist/lib/mesh/live/enqueue.js

@@ -2,6 +2,7 @@
  * Local session-event enqueue (US-008): validate + append one spool line.
  * No network. Shared line format with work-mesh-enqueue.sh.
  */
+import { enrichSessionEndEvent } from "./report-summary.js";
 import { validateSessionEvent } from "./validate-session-event.js";
 import { formatSpoolLine, } from "./format-spool-line.js";
 import { generateUlid } from "./ulid.js";
@@ -65,6 +66,12 @@ export function enqueueSessionEvent(opts) {
         event.reason = opts.reason;
     if (opts.summary)
         event.summary = opts.summary;
+    if (opts.repo)
+        event.repo = opts.repo;
+    if (opts.gitBranch)
+        event.gitBranch = opts.gitBranch;
+    if (opts.prUrls && opts.prUrls.length > 0)
+        event.prUrls = opts.prUrls;
     if (opts.cwd)
         event.cwd = opts.cwd;
     if (opts.hqRoot)
@@ -77,6 +84,18 @@ export function enqueueSessionEvent(opts) {
         event.task = opts.task;
     if (opts.toolWrites !== undefined)
         event.toolWrites = opts.toolWrites;
+    if (event.kind === "session_end") {
+        const enriched = enrichSessionEndEvent(event, { transcriptPath: opts.transcriptPath });
+        if (typeof enriched.summary === "string")
+            event.summary = enriched.summary;
+        if (typeof enriched.repo === "string")
+            event.repo = enriched.repo;
+        if (typeof enriched.gitBranch === "string")
+            event.gitBranch = enriched.gitBranch;
+        if (Array.isArray(enriched.prUrls) && enriched.prUrls.length > 0) {
+            event.prUrls = enriched.prUrls;
+        }
+    }
     const candidate = {
         ...event,
         v: 1,

package/dist/lib/mesh/live/flush.js

@@ -20,6 +20,7 @@ import { repairAckedRegisterStates } from "../../work-context/outbox.js";
 import { workContextRoot } from "../../work-context/paths.js";
 import { defaultSleep, FLUSH_MAX_ATTEMPTS, fullJitterDelayMs, } from "./backoff.js";
 import { LOCAL_ONLY_FIELDS, stripLocalOnlyFields } from "./format-spool-line.js";
+import { enrichSessionEndEvent } from "./report-summary.js";
 import { SESSION_EVENTS_BATCH_MAX, WRITABLE_CONTEXT_STATUSES, parseSessionEventsBatchAck, } from "./session-events-client.js";
 import { appendDeadLetterLine, appendDroppedReceipt, appendHeldLine, appendSpoolLine, claimHeld, claimSpool, countJsonlLines, ensureSpoolFile, recoverOrphanClaims, removeClaimFile, } from "./spool.js";
 import { workMeshHeldPath, workMeshRoot } from "./paths.js";
@@ -316,7 +317,7 @@ export async function flushSessionEvents(deps) {
             // presence-leave). Untouched events stay in pendingRestore and are put
             // back on the spool below.
             const flushItems = remainingItems.slice(0, SESSION_EVENTS_MAX_PER_SESSION_PER_FLUSH);
-            const stripped = flushItems.map((item) => stripLocalOnlyFields(item.event));
+            const stripped = flushItems.map((item) => stripLocalOnlyFields(enrichSessionEndEvent(item.event)));
             for (let i = 0; i < stripped.length; i += SESSION_EVENTS_BATCH_MAX) {
                 const chunk = stripped.slice(i, i + SESSION_EVENTS_BATCH_MAX);
                 const originalChunk = flushItems.slice(i, i + SESSION_EVENTS_BATCH_MAX);
@@ -608,7 +609,7 @@ function synthesizeSessionEnd(sessionId, sample, seq, at) {
     const harness = harnessRaw && SESSION_EVENT_HARNESSES.has(harnessRaw)
         ? harnessRaw
         : "claude-code";
-    return stripLocalOnlyFields({
+    return stripLocalOnlyFields(enrichSessionEndEvent({
         v: 1,
         eventId: generateUlid(),
         kind: "session_end",
@@ -617,7 +618,8 @@ function synthesizeSessionEnd(sessionId, sample, seq, at) {
         adapterVersion: eventText(sample, "adapterVersion") || "1.0.0",
         at,
         seq,
-    });
+        cwd: eventText(sample, "cwd"),
+    }));
 }
 async function postPresenceLeaveIfNeeded(input) {
     const leave = input.state?.presenceLeave;

package/dist/lib/mesh/live/format-spool-line.d.ts

@@ -5,7 +5,7 @@
 export declare const LOCAL_ONLY_FIELDS: readonly ["cwd", "hqRoot", "companySlug", "project", "task", "toolWrites"];
 export type LocalOnlyField = (typeof LOCAL_ONLY_FIELDS)[number];
 /** Network + local key order matching work-mesh-enqueue.sh. */
-export declare const SPOOL_KEY_ORDER: readonly ["v", "eventId", "kind", "sessionId", "harness", "adapterVersion", "runtimeVersion", "source", "at", "seq", "taskId", "status", "reason", "summary", "cwd", "hqRoot", "companySlug", "project", "task", "toolWrites"];
+export declare const SPOOL_KEY_ORDER: readonly ["v", "eventId", "kind", "sessionId", "harness", "adapterVersion", "runtimeVersion", "source", "at", "seq", "taskId", "status", "reason", "summary", "repo", "gitBranch", "prUrls", "cwd", "hqRoot", "companySlug", "project", "task", "toolWrites"];
 export type SessionEventKind = "session_start" | "turn_start" | "turn_end" | "session_end" | "task_status" | "blocked" | "note";
 export type SessionEventHarness = "claude-code" | "claude-desktop" | "codex" | "grok" | "hq-sessions" | "agent-box" | "agents-v2";
 export type SessionEventSource = "hooks" | "transcript";
@@ -24,6 +24,9 @@ export interface SpoolEventInput {
     status?: "queued" | "in_progress" | "review" | "done";
     reason?: string;
     summary?: string;
+    repo?: string;
+    gitBranch?: string;
+    prUrls?: string[];
     cwd?: string;
     hqRoot?: string;
     companySlug?: string;
@@ -35,7 +38,7 @@ export interface SpoolEventInput {
  * Build a compact JSON object in SPOOL_KEY_ORDER, omitting absent optional
  * strings. `toolWrites` is included when it is a finite number >= 0 (including 0).
  */
-export declare function buildOrderedSpoolObject(input: SpoolEventInput): Record<string, string | number>;
+export declare function buildOrderedSpoolObject(input: SpoolEventInput): Record<string, string | number | string[]>;
 /** Compact JSON line body (no trailing newline). */
 export declare function formatSpoolLine(input: SpoolEventInput): string;
 export declare function stripLocalOnlyFields(event: Record<string, unknown>): Record<string, unknown>;

package/dist/lib/mesh/live/format-spool-line.js

@@ -26,6 +26,9 @@ export const SPOOL_KEY_ORDER = [
     "status",
     "reason",
     "summary",
+    "repo",
+    "gitBranch",
+    "prUrls",
     "cwd",
     "hqRoot",
     "companySlug",
@@ -63,6 +66,13 @@ export function buildOrderedSpoolObject(input) {
         out.reason = input.reason;
     if (includeString(input.summary))
         out.summary = input.summary;
+    if (includeString(input.repo))
+        out.repo = input.repo;
+    if (includeString(input.gitBranch))
+        out.gitBranch = input.gitBranch;
+    if (Array.isArray(input.prUrls) && input.prUrls.length > 0) {
+        out.prUrls = input.prUrls.filter(includeString).slice(0, 5);
+    }
     if (includeString(input.cwd))
         out.cwd = input.cwd;
     if (includeString(input.hqRoot))

package/dist/lib/mesh/live/report-summary.d.ts

@@ -0,0 +1,45 @@
+/**
+ * US-051 — one-sentence quiet-report fields for session_end.
+ *
+ * Built locally at the quiet trigger / SessionEnd flush. Never includes file
+ * contents. Tokens, secret-looking strings, and secrets-file paths are redacted.
+ */
+export declare const REPORT_SUMMARY_MAX_CHARS = 140;
+export declare const REPORT_SUMMARY_SCHEMA_MAX = 280;
+export declare const REPORT_TRANSCRIPT_TAIL_BYTES: number;
+export interface SessionEndReportFields {
+    summary?: string;
+    repo?: string;
+    gitBranch?: string;
+    prUrls?: string[];
+}
+export interface BuildSessionEndReportFieldsInput {
+    sessionId?: string;
+    cwd?: string;
+    transcriptPath?: string;
+    home?: string;
+    /** Injectable git runner (tests). */
+    git?: (cwd: string, args: string[]) => string | undefined;
+    /** Injectable transcript reader (tests). */
+    readTranscript?: (p: string) => string | undefined;
+}
+export declare function redactReportSummary(text: string): string;
+export declare function firstSentence(text: string, max?: number): string;
+export declare function extractLastAssistantText(jsonl: string): string | undefined;
+export declare function readTranscriptTail(transcriptPath: string, maxBytes?: number): string | undefined;
+export declare function collectGitContext(cwd: string, git?: (cwd: string, args: string[]) => string | undefined): {
+    repo?: string;
+    gitBranch?: string;
+};
+export declare function extractPrUrls(text: string, max?: number): string[];
+export declare function claudeTranscriptPathFor(sessionId: string, cwd: string, home?: string): string;
+export declare function resolveTranscriptPath(input: {
+    transcriptPath?: string;
+    sessionId?: string;
+    cwd?: string;
+    home?: string;
+}): string | undefined;
+export declare function buildSessionEndReportFields(input: BuildSessionEndReportFieldsInput): SessionEndReportFields;
+/** Merge report fields onto a session_end event object (no-op for other kinds). */
+export declare function enrichSessionEndEvent(event: Record<string, unknown>, extra?: Pick<BuildSessionEndReportFieldsInput, "transcriptPath" | "home" | "git" | "readTranscript">): Record<string, unknown>;
+//# sourceMappingURL=report-summary.d.ts.map