@peasant-labs/fairtrade 0.0.36 → 0.0.38

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

@@ -5,11 +5,17 @@
  * @param {object} props
  * @param {string} props.command - the literal shell command (case preserved — never lowercased).
  * @param {string} [props.label] - an accessible name for the copy button; defaults to the command.
+ * @param {boolean} [props.wrap=false] - wrap a long command at spaces (and break a long URL anywhere)
+ *        instead of scrolling it sideways. Copying is unaffected: the command is copied whole.
+ * @param {boolean} [props.compact=false] - an icon-only copy button (its name stays "copy <command>"),
+ *        for a narrow column.
  * @param {string} [props.className] - extra classes appended to the root.
  */
-export function CommandBlock({ command, label, className, ...rest }: {
+export function CommandBlock({ command, label, wrap, compact, className, ...rest }: {
     command: string;
     label?: string;
+    wrap?: boolean;
+    compact?: boolean;
     className?: string;
 }): import("react").JSX.Element;
 /**

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

@@ -108,16 +108,19 @@ export function CollectivePicker({ suggestions, onAdd, query: queryProp, onQuery
  * @param {string} props.title - the session title, kept in its case.
  * @param {'publish'|'update'} [props.mode='publish']
  * @param {PublishDialogState} props.state - one of PUBLISH_DIALOG_STATES.
- * @param {{ matches?: import('./Redaction.jsx').RedactionMatch[], matchCount?: number, total?: number, failure?: string }} [props.scan] - the host's scan result. `matchCount` is the full occurrence count when `matches` contains only examples. Until it carries a
+ * @param {{ matches?: import('./Redaction.jsx').RedactionMatch[], matchCount?: number, total?: number, failure?: string, failureDetail?: string, failureAction?: { label: string, onSelect: () => void, busy?: boolean } }} [props.scan] - the host's scan result. `failure` is one plain line; `failureAction` is a button in the failure box (the one action that fixes it); `failureDetail`, the actionable detail (what, why, where, the fix), shows as pre-wrapped mono text behind a "details" disclosure in the failure box. `matchCount` is the full occurrence count when `matches` contains only examples. Until it carries a
  *        `matches` list, the popup says the transcript is not scanned and keeps publish off. A match with `kept: true` leaves un-redacted, and the
  *        popup says so and opens the matches.
  * @param {() => void} [props.onRescan]
+ * @param {{ stage: string, note?: string, progress?: { done: number, total: number } }} [props.checking] - while state is
+ *        'checking': the step being done (replaces "checking for sensitive content"), a quiet note on why publish waits
+ *        when a step runs long, and a determinate count ("120 of 468"). All of it sits in the status region.
  * @param {{ summary: string }} [props.changes] - update mode: what changed since the last publish.
  * @param {AccessItem[]} [props.access] - who can read it after this publish.
  * @param {(id: string) => void} [props.onRemove]
  * @param {(id: string) => void} [props.onRestore]
  * @param {object} [props.picker] - CollectivePicker props (suggestions, onAdd, query, onQueryChange).
- * @param {{ checked: boolean, onChange: (checked: boolean) => void, hint?: string }} [props.autoPublish] - hint replaces only the unchecked line; checked consent is always component-owned.
+ * @param {{ checked: boolean, onChange: (checked: boolean) => void, hint?: string }} [props.autoPublish] - hint is the unchecked line, shown only when given; checked consent is always component-owned.
  * @param {string} [props.accessSummary] - update mode: the access change in words ("adds ML Reading Group, removes nothing").
  * @param {string} [props.primaryLabel] - replaces the derived primary label.
  * @param {() => void} [props.onPublish]
@@ -128,7 +131,7 @@ export function CollectivePicker({ suggestions, onAdd, query: queryProp, onQuery
  * @param {() => void} [props.onRetry] - stopped-state actual publication retry; requires a valid review and audience. Mutually exclusive with onRecover.
  * @param {{ url: string, collectives: string[], pending?: string[], pullRequest?: { number: number, branch: string, href?: string } }} [props.done]
  */
-export function PublishDialog({ open, onClose, title, mode, state, scan, onRescan, changes, access, onRemove, onRestore, picker, autoPublish, accessSummary, primaryLabel, onPublish, onConnect, joinHref, stoppedAt, onRecover, onRetry, done, }: {
+export function PublishDialog({ open, onClose, title, mode, state, scan, onRescan, checking, changes, access, onRemove, onRestore, picker, autoPublish, accessSummary, primaryLabel, onPublish, onConnect, joinHref, stoppedAt, onRecover, onRetry, done, }: {
     open: boolean;
     onClose: () => void;
     title: string;
@@ -139,8 +142,22 @@ export function PublishDialog({ open, onClose, title, mode, state, scan, onResca
         matchCount?: number;
         total?: number;
         failure?: string;
+        failureDetail?: string;
+        failureAction?: {
+            label: string;
+            onSelect: () => void;
+            busy?: boolean;
+        };
     };
     onRescan?: () => void;
+    checking?: {
+        stage: string;
+        note?: string;
+        progress?: {
+            done: number;
+            total: number;
+        };
+    };
     changes?: {
         summary: string;
     };

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

@@ -17,9 +17,11 @@ export function SettingStatus({ children }: {
  * @param {(next: boolean|string) => Promise<void>|void} props.onCommit - the one write; reject to fail.
  * @param {string} [props.tag] - a note on the row, shown on a Chip ("not in peasant config").
  * @param {boolean} [props.disabled]
+ * @param {boolean} [props.stack] - put the value under the label (at its left edge) instead of beside
+ *        it. Defaults to on for a text value longer than one short line (a description).
  * @param {string} [props.className]
  */
-export function SettingRow({ label, help, control, value, options, onCommit, tag, disabled, className, ...rest }: {
+export function SettingRow({ label, help, control, value, options, onCommit, tag, disabled, stack, className, ...rest }: {
     label: import("react").ReactNode;
     help?: import("react").ReactNode;
     control: "switch" | "select" | "checkbox" | "text";
@@ -32,6 +34,7 @@ export function SettingRow({ label, help, control, value, options, onCommit, tag
     onCommit: (next: boolean | string) => Promise<void> | void;
     tag?: string;
     disabled?: boolean;
+    stack?: boolean;
     className?: string;
 }): import("react").JSX.Element;
 /**

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

@@ -1,4 +1,4 @@
-/** Human-readable ms duration: "4.2s", "42s", "2m 14s", "1.5h". Tabular-friendly, no leading zeros. */
+/** Human-readable ms duration in the one transcript format: "820ms", "4.2s", "2m 14s", "1h 12m"; zero or unknown reads as nothing. */
 export function formatDuration(ms: any): string;
 /**
  * @typedef {object} Task

package/dist/lib/types/graph/ChangeDetail.d.ts

@@ -13,8 +13,9 @@
  * @param {() => void} [props.onShare]      the "share … conversations" exit (host owns share UX)
  * @param {() => void} [props.onCopyRecap]  the "copy recap" exit (host owns the clipboard recap)
  * @param {Record<string, boolean>} [props.initialOpenFiles]  files open on first render (path → open?)
+ * @param {import('react').ReactNode} [props.headerActions]  the host's own controls for the head row, at the crumb's end (a docs link, say)
  */
-export default function ChangeDetail({ payload, getDiff, title, annotation, onSaveAnnotation, onRemoveAnnotation, onOpenMap, onShare, onCopyRecap, initialOpenFiles, }: {
+export default function ChangeDetail({ payload, getDiff, title, annotation, onSaveAnnotation, onRemoveAnnotation, onOpenMap, onShare, onCopyRecap, initialOpenFiles, headerActions, }: {
     payload: import("./types.js").ChangeDetailPayload;
     getDiff?: (file: import("./types.js").FileChangePayload) => import("./types.js").ChangeDiffPayload | null | undefined;
     title?: string;
@@ -25,4 +26,5 @@ export default function ChangeDetail({ payload, getDiff, title, annotation, onSa
     onShare?: () => void;
     onCopyRecap?: () => void;
     initialOpenFiles?: Record<string, boolean>;
+    headerActions?: import("react").ReactNode;
 }): import("react").JSX.Element;

package/dist/lib/types/graph/Changes.d.ts

@@ -10,8 +10,9 @@
  * @param {() => void} [props.onShowOlder]  deprecated legacy pagination callback; use onNavigate.
  * @param {(sessionId: string) => void} [props.onOpenSession] deprecated legacy session callback; use onNavigate.
  * @param {number} [props.nowMs]  pins relative-time humanisation (default Date.now()); the harness fixes it for byte-stable captures
+ * @param {import('react').ReactNode} [props.headerActions]  the host's own controls for the head row, beside "open the map" (a docs link, say)
  */
-export default function Changes({ payload, projectLabel, selectedId, onNavigate, onSelectChange, onOpenMap, hasMore, onShowOlder, onOpenSession, nowMs, }: {
+export default function Changes({ payload, projectLabel, selectedId, onNavigate, onSelectChange, onOpenMap, hasMore, onShowOlder, onOpenSession, nowMs, headerActions, }: {
     payload: import("./types.js").ChangesPayload;
     projectLabel?: string;
     selectedId?: string;
@@ -22,4 +23,5 @@ export default function Changes({ payload, projectLabel, selectedId, onNavigate,
     onShowOlder?: () => void;
     onOpenSession?: (sessionId: string) => void;
     nowMs?: number;
+    headerActions?: import("react").ReactNode;
 }): import("react").JSX.Element;

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.

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 { formatRelative, formatDurationMins, formatDurationMs, formatDurationSeconds, formatDateLong, isKnownTime } from "./time.js";
 export { summarizePrompt, composeSessionTitle, projectLabel } 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.
  *