@peasant-labs/fairtrade 0.0.37 → 0.0.39

package/dist/lib/types/transcript/adapter.d.ts

@@ -1,3 +1,10 @@
+/**
+ * Is this wire turn one of Claude Code's session metadata records rather than conversation?
+ * @param {TurnDetail} turn
+ * @param {string | undefined} harness  the session's harness
+ * @returns {boolean}
+ */
+export function isSessionMetadataTurn(turn: TurnDetail, harness: string | undefined): boolean;
 /**
  * Default turn prefilter the adapter applies independently per partition:
  * preserve normalized evidence, including unknown provenance and folded refs.
@@ -8,16 +15,6 @@
  * @returns {TurnDetail[]}
  */
 export function prefilterTurns(turns: TurnDetail[]): TurnDetail[];
-/**
- * Dependency-free line diff (LCS) → cooked `DiffLineVM[]`. fairtrade ships no
- * `diff` package, so the adapter computes hunks itself. Line numbers are 1-based
- * within the supplied snippet (the wire carries the edit snippet, not the file
- * offset). Deterministic — no clock/randomness — so it is screenshot-stable.
- * @param {string} oldText
- * @param {string} newText
- * @returns {DiffLineVM[]}
- */
-export function diffLines(oldText: string, newText: string): DiffLineVM[];
 /**
  * Project the canonical wire payload (folded turns) into the cooked
  * `TranscriptViewModel` every dumb transcript component renders. The SOLE
@@ -30,6 +27,7 @@ export function diffLines(oldText: string, newText: string): DiffLineVM[];
  * @returns {TranscriptViewModel}
  */
 export function adaptTranscript(payload: TranscriptWireInput, annotations?: AnnotationSummary[], analytics?: TranscriptAnalyticsVM, options?: AdaptTranscriptOptions): TranscriptViewModel;
+export { diffLines };
 export type TranscriptWireInput = import("./wire-types.js").TranscriptWireInput;
 export type SessionDetailPayload = import("./wire-types.js").SessionDetailPayload;
 export type TurnDetail = import("./wire-types.js").TurnDetail;
@@ -44,6 +42,7 @@ export type SessionVM = import("./view-model.js").SessionVM;
 export type SessionGitVM = import("./view-model.js").SessionGitVM;
 export type CommitVM = import("./view-model.js").CommitVM;
 export type TurnVM = import("./view-model.js").TurnVM;
+export type TaskGroupVM = import("./view-model.js").TaskGroupVM;
 export type ToolCallVM = import("./view-model.js").ToolCallVM;
 export type ToolGroup = import("./view-model.js").ToolGroup;
 export type DiffLineVM = import("./view-model.js").DiffLineVM;
@@ -64,3 +63,4 @@ export type AdaptTranscriptOptions = {
      */
     relationshipNavigation?: import("@peasant-labs/schema").SessionRelationshipNavigation[];
 };
+import { diffLines } from './adapter.parse.js';

package/dist/lib/types/transcript/adapter.parse.d.ts

@@ -1,4 +1,5 @@
 /** @typedef {import('./wire-types.js').ToolCallDetail} ToolCallDetail */
+/** @typedef {import('./view-model.js').DiffLineVM} DiffLineVM */
 /**
  * The SOLE `JSON.parse` of a wire-encoded tool string in the lifted code. Every
  * other parse helper here, the adapter, and the analytics util route through it,
@@ -55,9 +56,35 @@ export function editPairs(call: ToolCallDetail): EditPair[];
  */
 export function writeContent(call: ToolCallDetail): string;
 /**
- * Lines inserted / removed for an edit-family or write tool call. Consolidates
- * the THREE duplicate `countDiff` definitions. Pure: depends only on the parsed
- * arguments, never a clock or the file system.
+ * Dependency-free line diff (LCS) → cooked `DiffLineVM[]`. fairtrade ships no
+ * `diff` package, so the adapter computes hunks itself. Line numbers are 1-based
+ * within the supplied snippet (the wire carries the edit snippet, not the file
+ * offset). Deterministic — no clock/randomness — so it is screenshot-stable.
+ * @param {string} oldText
+ * @param {string} newText
+ * @returns {DiffLineVM[]}
+ */
+export function diffLines(oldText: string, newText: string): DiffLineVM[];
+/**
+ * The cooked line diff of an edit-family or write tool call (one line list per replaced span) and
+ * its churn: the + and − lines of that same diff, so a rewrite of three lines counts +3 −3 and every
+ * count (the tool call, the diffs tab, a task's churn) agrees with the lines it heads. A span's
+ * trailing empty line is the newline artifact, not a line anyone wrote, so it is not counted, as the
+ * renderer does not show it. Undefined for any other kind, or an edit with no replacement. Memoised
+ * per call object, because the adapter and the analytics both ask and the line diff is quadratic in
+ * the span length.
+ * @param {ToolCallDetail} call
+ * @returns {{ spans: DiffLineVM[][], adds: number, dels: number } | undefined}
+ */
+export function callDiff(call: ToolCallDetail): {
+    spans: DiffLineVM[][];
+    adds: number;
+    dels: number;
+} | undefined;
+/**
+ * Lines inserted / removed for an edit-family or write tool call: the churn of `callDiff`, zero
+ * for any other kind. Consolidates the THREE duplicate `countDiff` definitions. Pure: depends only
+ * on the parsed arguments, never a clock or the file system.
  * @param {ToolCallDetail} call
  * @returns {{ adds: number, dels: number }}
  */
@@ -66,6 +93,7 @@ export function countDiff(call: ToolCallDetail): {
     dels: number;
 };
 export type ToolCallDetail = import("./wire-types.js").ToolCallDetail;
+export type DiffLineVM = import("./view-model.js").DiffLineVM;
 /**
  * One old→new replacement inside an Edit / MultiEdit / NotebookEdit call.
  */

package/dist/lib/types/transcript/index.d.ts

@@ -72,9 +72,9 @@ export type PhaseVM = import("./view-model.js").PhaseVM;
 export type ScorecardBandVM = import("./view-model.js").ScorecardBandVM;
 export type TranscriptAnalyticsVM = import("./view-model.js").TranscriptAnalyticsVM;
 export { ROLES, ENTRY_TYPES, TOOL_CALL_KINDS, STOP_REASONS, SESSION_OUTCOMES, HARNESSES } from "./wire-types.js";
-export { adaptTranscript, prefilterTurns, diffLines } from "./adapter.js";
+export { adaptTranscript, prefilterTurns, isSessionMetadataTurn, diffLines } from "./adapter.js";
 export { computeTasks, computeTurnLabels, buildTaskWaterfall, annotateTranscript, computePersonalMedians, detectPhases, assessScorecard, computeAnalytics, computeTaskGroups, phaseLabel } from "./analytics.js";
-export { formatRelative, formatDurationMins, formatDateLong } from "./time.js";
-export { summarizePrompt, composeSessionTitle, projectLabel } from "./title.js";
+export { formatRelative, formatDurationMins, formatDurationMs, formatDurationSeconds, formatDateLong, isKnownTime } from "./time.js";
+export { summarizePrompt, composeSessionTitle, projectLabel, cleanSessionTitle, unwrapUserQuery } from "./title.js";
 export { default as TranscriptDiffEntryCard, DiffHunks as TranscriptDiffHunks } from "./DiffEntryCard.jsx";
 export { advanceTranscriptInitialPositionConsumption, normalizeTranscriptInitialPosition, resolveTranscriptInitialPosition, shouldApplyTranscriptInitialPosition, transcriptInitialPositionReadiness, transcriptInitialPositionToken } from "./initial-position.js";

package/dist/lib/types/transcript/time.d.ts

@@ -1,5 +1,14 @@
 /**
- * Human-readable relative time: "3m ago", "2h ago", "4d ago", "Jan 12".
+ * Is this a real recorded time? A missing, unparseable, zero, epoch or Go zero-time value
+ * ("0001-01-01T00:00:00Z") is unknown: nothing may render it, and no "ago" math runs on it.
+ *
+ * @param {string | null | undefined} iso
+ * @returns {boolean}
+ */
+export function isKnownTime(iso: string | null | undefined): boolean;
+/**
+ * Human-readable relative time: "just now", "3m ago", "2h ago", "4d ago"; past a week it reads as
+ * a date ("oct 14", or "oct 14, 2025" in another year). An unknown time reads as nothing.
  *
  * @param {string} iso        an ISO 8601 timestamp
  * @param {number} [now]      reference "now" in epoch millis (defaults to `Date.now()`; pass explicitly for deterministic tests)
@@ -7,12 +16,28 @@
  */
 export function formatRelative(iso: string, now?: number): string;
 /**
- * A duration expressed in minutes → "1h 16m" / "9m" / "42s".
+ * The one duration format: human and short. "12s", "4m 30s", "4m", "1h 12m", "1h"; under a
+ * second "<1s"; zero, negative or unknown reads as nothing, so a caller hides the figure.
+ *
+ * @param {number | null | undefined} seconds
+ * @returns {string}
+ */
+export function formatDurationSeconds(seconds: number | null | undefined): string;
+/**
+ * A duration in minutes, in the one format: 4.5 -> "4m 30s", 76 -> "1h 16m", 0 -> "".
+ *
+ * @param {number | null | undefined} mins
+ * @returns {string}
+ */
+export function formatDurationMins(mins: number | null | undefined): string;
+/**
+ * A duration in milliseconds: a tool call reads "820ms" or "1.4s" while short, then the one
+ * format ("1m 15s"); zero or unknown reads as nothing.
  *
- * @param {number | undefined} mins
+ * @param {number | null | undefined} ms
  * @returns {string}
  */
-export function formatDurationMins(mins: number | undefined): string;
+export function formatDurationMs(ms: number | null | undefined): string;
 /**
  * "Jan 12, 4:23 PM" — long datetime for tooltips.
  *

package/dist/lib/types/transcript/title.d.ts

@@ -1,5 +1,20 @@
+/**
+ * The prompt without a harness's <user_query> wrapper: the user's own text, untouched otherwise.
+ * @param {string | undefined} text
+ * @returns {string}
+ */
+export function unwrapUserQuery(text: string | undefined): string;
+/**
+ * A stored session title, shown as written: the harness's <user_query> wrapper dropped and the
+ * whitespace collapsed, but every word, its case, its dots and an existing trailing "…" kept. For a
+ * title, never `summarizePrompt`, which cuts at the first sentence and recases.
+ * @param {string | undefined} text
+ * @returns {string}
+ */
+export function cleanSessionTitle(text: string | undefined): string;
 /**
  * Produce a short, human-readable summary of a raw prompt. Heuristic, in order:
+ *   0. Drop a harness's <user_query> wrapper (cleanSessionTitle's rule).
  *   1. Strip leading <system-reminder> blocks and leading fenced code blocks.
  *   2. Pull out a <command-name> (e.g. `/mcp`) if present, keep following prose.
  *   3. Strip remaining XML-ish tags, collapse whitespace, take the first sentence.

package/dist/lib/types/transcript/view-model.d.ts

@@ -308,9 +308,15 @@ export type TurnVM = {
      */
     label: string;
     /**
-     * markdown body (thinking already extracted)
+     * markdown body (thinking already extracted), as recorded
      */
     content: string;
+    /**
+     * the text the turn shows instead of `content`, present only
+     *       when they differ (a cursor prompt's `<user_query>` wrapper
+     *       removed); views render `displayContent ?? content`
+     */
+    displayContent?: string;
     /**
      * subagent nesting depth (0 = top level)
      */
@@ -463,6 +469,10 @@ export type TaskGroupVM = {
      * user content for the task (case preserved)
      */
     prompt: string;
+    /**
+     * the prompt as its turn shows it, present only when it differs
+     */
+    displayPrompt?: string;
     /**
      * turns belonging to this task
      */