@peasant-labs/fairtrade 0.0.38 → 0.0.40

package/dist/lib/tokens.css

@@ -28,6 +28,7 @@
   --ghost-node-size: 9px;
   --control-h: 36px;
   --control-h-sm: 28px;
+  --chip-h: 28px;
   --nav-h: 56px;
   --maxw: 1040px;
   --gutter: var(--sp-6);

package/dist/lib/tokens.json

@@ -359,6 +359,10 @@
       "$type": "dimension",
       "$value": "28px"
     },
+    "chip-h": {
+      "$type": "dimension",
+      "$value": "28px"
+    },
     "nav-h": {
       "$type": "dimension",
       "$value": "56px"

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

@@ -1,3 +1,14 @@
+/**
+ * The words of a wrapped command and the spaces between them, as the line breaks them: a lone "|"
+ * keeps to the word after it, so a pipe never starts or ends a line on its own.
+ * @param {string} command
+ * @returns {Array<{ word: string } | { space: string }>}
+ */
+export function commandWords(command: string): Array<{
+    word: string;
+} | {
+    space: string;
+}>;
 /**
  * CommandBlock — a square `$ command` block: a mono command line with a leading dim `$`, and a copy
  * button that flips to an olive check + the word "copied" for ~1.5s.

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

@@ -6,12 +6,14 @@
  *
  *  redaction:  variant="redaction", pass `matches` = [{ category, confidence, original,
  *              replacement, oldNo, newNo }]. each match is a del→add pair with a category/
- *              confidence badge and a per-match keep/revert button.
+ *              confidence badge and a per-match keep/revert button. `category` is the engine's
+ *              (RedactionCategory: secrets, pii, paths, project) and shows as the engine's label;
+ *              an unknown category (a rule name, a display label) shows an alert and no match.
  *
  * @param {object} props
  * @param {string} props.file - the file path shown in the header (mono, not lowercased)
  * @param {Array<{header?:string, lines:Array<{type:'add'|'del'|'ctx', oldNo?:number|string, newNo?:number|string, text:string}>}>} [props.hunks] - structured hunks (default variant)
- * @param {Array<{category:string, confidence:number, original:string, replacement:string, oldNo?:number|string, newNo?:number|string}>} [props.matches] - redaction matches (redaction variant)
+ * @param {Array<{category:import('@peasant-labs/schema').RedactionCategory, confidence:number, original:string, replacement:string, oldNo?:number|string, newNo?:number|string}>} [props.matches] - redaction matches (redaction variant)
  * @param {'default'|'redaction'} [props.variant='default']
  * @param {string} [props.className]
  */
@@ -27,7 +29,7 @@ export default function DiffView({ file, hunks, matches, variant, className, ...
         }>;
     }>;
     matches?: Array<{
-        category: string;
+        category: import("@peasant-labs/schema").RedactionCategory;
         confidence: number;
         original: string;
         replacement: string;

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

@@ -4,15 +4,19 @@
  * @param {object} props
  * @param {PublishState} props.state
  * @param {number} [props.collectives] - how many collectives can read it (published, new-turns, publishing); left out of the words when omitted.
- * @param {number} [props.newTurns] - turns recorded since the last publish (new-turns).
+ * @param {number} [props.newTurns] - turns recorded since the last publish (new-turns); the label says "needs update".
  * @param {string} [props.collective] - the collective(s) the project's auto-publish rule targets (auto-publish).
+ * @param {'public'|'private'} [props.visibility] - published: who can find it beyond its collectives, as the host knows
+ *        it. "published, public" and "published, private" are said only from this; without it a transcript no
+ *        collective reads is just "published".
  * @param {string} [props.className]
  */
-export function PublishStateLabel({ state, collectives, newTurns, collective, className, ...rest }: {
+export function PublishStateLabel({ state, collectives, newTurns, collective, visibility, className, ...rest }: {
     state: PublishState;
     collectives?: number;
     newTurns?: number;
     collective?: string;
+    visibility?: "public" | "private";
     className?: string;
 }): import("react").JSX.Element;
 /**
@@ -25,16 +29,18 @@ export function PublishStateLabel({ state, collectives, newTurns, collective, cl
  * @param {number} [props.collectives]
  * @param {number} [props.newTurns]
  * @param {string} [props.collective]
+ * @param {'public'|'private'} [props.visibility]
  * @param {() => void} [props.onAction] - the one button. omit it and no button renders.
  * @param {string} [props.actionLabel] - replaces the state's default label.
  * @param {import('./Menu.jsx').MenuItem[]} [props.moreItems] - an optional overflow menu after the button.
  * @param {string} [props.className]
  */
-export function PublishBar({ state, collectives, newTurns, collective, onAction, actionLabel, moreItems, className, ...rest }: {
+export function PublishBar({ state, collectives, newTurns, collective, visibility, onAction, actionLabel, moreItems, className, ...rest }: {
     state: PublishState;
     collectives?: number;
     newTurns?: number;
     collective?: string;
+    visibility?: "public" | "private";
     onAction?: () => void;
     actionLabel?: string;
     moreItems?: import("./Menu.jsx").MenuItem[];
@@ -96,7 +102,7 @@ export function CollectivePicker({ suggestions, onAdd, query: queryProp, onQuery
  * checkbox, then the done state with the village link. The host drives `state`; the popup never
  * advances on its own.
  *
- * States: `connect` (this computer is not signed in to village), `waiting-github` (after continue
+ * States: `connect` (this computer is not signed in to peasant online), `waiting-github` (after continue
  * with github), `checking` (the redaction check is running), `scan-failed` (publish is off,
  * re-scan stays on), `no-collective` (signed in, in no collective), `ready`, `publishing`,
  * `stopped` (a named step failed; the host names any changes already applied), `done`, `waits-approval` (done, and
@@ -108,7 +114,7 @@ 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, 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
+ * @param {{ matches?: import('./Redaction.jsx').RedactionMatch[], matchCount?: number, total?: number, failure?: string, failureDetail?: string, failureAction?: { label: string, onSelect: () => void, busy?: boolean }, note?: { line: string, detail?: string } }} [props.scan] - the host's scan result. `note` is a quiet line under a finished scan's count (what the scanned copy leaves out, and why), with its detail behind a "details" disclosure; it is information, not an alert, and publishing stays on. `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]
@@ -125,13 +131,18 @@ export function CollectivePicker({ suggestions, onAdd, query: queryProp, onQuery
  * @param {string} [props.primaryLabel] - replaces the derived primary label.
  * @param {() => void} [props.onPublish]
  * @param {() => void} [props.onConnect] - `continue with github`.
- * @param {string} [props.joinHref] - `create or join one on village`.
+ * @param {string} [props.joinHref] - `create or join one on peasant online`.
  * @param {string} [props.stoppedAt] - the step that failed, in words ("setting who can read it").
+ * @param {string} [props.stoppedDetail] - stopped state: the host's actionable detail, pre-wrapped mono text behind a
+ *        "details" disclosure in the stopped box.
+ * @param {{ line: string, detail?: string, onRetry?: () => void, busy?: boolean }} [props.accessFailure] - the
+ *        collectives could not be read. "who can read it" shows the line, a retry for that read and the detail in
+ *        place of the access list and picker, and publishing stays off. The dialog's state stays the host's.
  * @param {() => void} [props.onRecover] - stopped-state prerequisite read/sign-in recovery only; may run before a scan or audience exists, but never with an explicitly refused review. Mutually exclusive with onRetry. Must not publish.
  * @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, checking, 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, stoppedDetail, accessFailure, onRecover, onRetry, done, }: {
     open: boolean;
     onClose: () => void;
     title: string;
@@ -148,6 +159,10 @@ export function PublishDialog({ open, onClose, title, mode, state, scan, onResca
             onSelect: () => void;
             busy?: boolean;
         };
+        note?: {
+            line: string;
+            detail?: string;
+        };
     };
     onRescan?: () => void;
     checking?: {
@@ -176,6 +191,13 @@ export function PublishDialog({ open, onClose, title, mode, state, scan, onResca
     onConnect?: () => void;
     joinHref?: string;
     stoppedAt?: string;
+    stoppedDetail?: string;
+    accessFailure?: {
+        line: string;
+        detail?: string;
+        onRetry?: () => void;
+        busy?: boolean;
+    };
     onRecover?: () => void;
     onRetry?: () => void;
     done?: {

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

@@ -11,11 +11,13 @@
  * @property {React.ComponentType<{size?: number}>} [stateIcon] override icon for the
  *           .sw-state marker; defaults to CircleCheck (on) / Circle (off).
  * @property {string} [id]              id for the control; links the label's `for`.
+ * @property {boolean} [stateMarker=true] show the on/off word beside the switch; off where the
+ *           host already says the state (a settings row).
  */
 /**
  * @param {SwitchProps} props
  */
-export default function Switch({ checked, defaultChecked, onChange, disabled, busy, label, onText, offText, stateIcon: StateIcon, id, }: SwitchProps): import("react").JSX.Element;
+export default function Switch({ checked, defaultChecked, onChange, disabled, busy, label, onText, offText, stateIcon: StateIcon, id, stateMarker, }: SwitchProps): import("react").JSX.Element;
 export type SwitchProps = {
     /**
      * controlled on/off state; pair with onChange.
@@ -60,4 +62,9 @@ export type SwitchProps = {
      * id for the control; links the label's `for`.
      */
     id?: string;
+    /**
+     * show the on/off word beside the switch; off where the
+     * host already says the state (a settings row).
+     */
+    stateMarker?: boolean;
 };

package/dist/lib/types/analytics/format.d.ts

@@ -1,5 +1,6 @@
 /**
- * Compact token count: 1234 → "1.2k", 62_000 → "62k", 1_234_567 → "1.23M".
+ * Compact token count, the library's one count format: 1234 → "1.2k", 62_000 → "62k",
+ * 1_234_567 → "1.2M", 66_731_500_000 → "66.7B". A negative count is not a count and reads "—".
  * @param {number | null | undefined} n
  * @returns {string}
  */

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

@@ -1,4 +1,35 @@
-/** Compact counts use one decimal place and lowercase magnitude suffixes. */
-export function formatCount(value: any): string;
-/** Calendar dates are stable across host locales; date-only inputs stay on their UTC day. */
-export function formatDate(value: any): string;
+/**
+ * Compact count, one decimal at most: 999 → "999", 1234 → "1.2k", 66_731_500_000 → "66.7B".
+ * @param {unknown} value
+ * @returns {string}
+ */
+export function formatCount(value: unknown): string;
+/**
+ * Exact grouped integer: 272000 → "272,000". A bigint or a string of digits stays exact past the
+ * JS-safe range; any other value is rounded.
+ * @param {unknown} value
+ * @returns {string}
+ */
+export function formatInteger(value: unknown): string;
+/**
+ * A cost in US dollars at cents: "$0.30", "$1,234.56", "$0.00" for zero, "<$0.01" for a positive
+ * amount under one cent. Accepts the recorded decimal string as it arrives.
+ * @param {unknown} value
+ * @returns {string}
+ */
+export function formatCost(value: unknown): string;
+/**
+ * A decimal at fixed places: 0.99 → "0.99", 0.5 with 2 places → "0.50".
+ * @param {unknown} value
+ * @param {number} places
+ * @returns {string}
+ */
+export function formatDecimal(value: unknown, places: number): string;
+/**
+ * Calendar dates are stable across host locales; date-only inputs stay on their UTC day.
+ * @param {string | number | Date} value
+ * @returns {string}
+ */
+export function formatDate(value: string | number | Date): string;
+/** What every formatter shows for a missing or unreadable value. */
+export const MISSING_NUMBER: "\u2014";

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

@@ -55,6 +55,7 @@ export { default as Breadcrumb, Steps } from "./Breadcrumb.jsx";
 export { default as Tooltip, Popover } from "./Tooltip.jsx";
 export { Avatar, AvatarGroup, Kbd, KbdChord, Tag } from "./Avatar.jsx";
 export { default as BrandMark, resolveBrand } from "./BrandMark.jsx";
+export { formatCount, formatInteger, formatCost, formatDecimal, MISSING_NUMBER } from "./format.js";
 export { providerAccent, providerDisplayName } from "./provider-policy.js";
 export { Skeleton, Progress, Spinner, Toast, FeedbackPanel } from "./Feedback.jsx";
 export { DataTableToolbar, DataTablePaginationControls } from "./DataTableControls.jsx";

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

@@ -15,16 +15,6 @@ export function isSessionMetadataTurn(turn: TurnDetail, harness: string | undefi
  * @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
@@ -37,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;
@@ -51,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;
@@ -71,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

@@ -75,6 +75,6 @@ export { ROLES, ENTRY_TYPES, TOOL_CALL_KINDS, STOP_REASONS, SESSION_OUTCOMES, HA
 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, formatDurationMs, formatDurationSeconds, formatDateLong, isKnownTime } from "./time.js";
-export { summarizePrompt, composeSessionTitle, projectLabel } from "./title.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/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
      */