@peasant-labs/fairtrade 0.0.7 → 0.0.10

package/dist/lib/tokens.css

@@ -20,6 +20,10 @@
   --ic-lg: 18px;
   --bd: 1px solid var(--rule);
   --bd-strong: 1px solid var(--rule-strong);
+  --stroke-hairline: 1px;
+  --stroke-emphasis: 2px;
+  --focus-ring-width: 3px;
+  --ghost-node-size: 9px;
   --control-h: 36px;
   --control-h-sm: 28px;
   --nav-h: 56px;

package/dist/lib/tokens.json

@@ -570,6 +570,22 @@
       "$type": "other",
       "$value": "1px solid var(--rule-strong)"
     },
+    "stroke-hairline": {
+      "$type": "other",
+      "$value": "1px"
+    },
+    "stroke-emphasis": {
+      "$type": "other",
+      "$value": "2px"
+    },
+    "focus-ring-width": {
+      "$type": "other",
+      "$value": "3px"
+    },
+    "ghost-node-size": {
+      "$type": "other",
+      "$value": "9px"
+    },
     "dialog-w": {
       "$type": "other",
       "$value": "420px"

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

@@ -71,7 +71,7 @@ export function KbdChord({ label, children, className, ...rest }: {
  *
  * @param {object} props
  * @param {React.ReactNode} props.children - the tag label (sentence/case passed in is preserved; chrome is lowercased by CSS).
- * @param {string} [props.brand] - a provider/company name (claude, gemini, openai, cursor, opencode, or an alias).
+ * @param {string} [props.brand] - a provider/company name (claude, gemini, openai, cursor, opencode, strike, or an alias).
  *        When the tag names a company, pass this instead of `icon`: it leads with the real brand mark, never a generic glyph.
  * @param {React.ComponentType} [props.icon] - a lucide icon component reference rendered before the label (ignored when `brand` is set).
  * @param {string} [props.dot] - a color value for the leading swatch dot (set as --tag-c).

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

@@ -1,14 +1,14 @@
 /**
  * resolve any accepted name/alias to a canonical mark key, or null when unknown.
  * @param {string} name
- * @returns {('claude'|'gemini'|'openai'|'cursor'|'opencode')|null}
+ * @returns {('claude'|'gemini'|'openai'|'cursor'|'opencode'|'strike')|null}
  */
-export function resolveBrand(name: string): ("claude" | "gemini" | "openai" | "cursor" | "opencode") | null;
+export function resolveBrand(name: string): ("claude" | "gemini" | "openai" | "cursor" | "opencode" | "strike") | null;
 /**
  * BrandMark - a single-color, currentColor-tinted company/provider logo.
  *
  * @param {object} props
- * @param {'claude'|'gemini'|'openai'|'cursor'|'opencode'|'anthropic'|'google'|'codex'|string} props.name
+ * @param {'claude'|'gemini'|'openai'|'cursor'|'opencode'|'strike'|'anthropic'|'google'|'codex'|string} props.name
  *        the company/product; aliases resolve (anthropic->claude, google->gemini, codex->openai).
  * @param {number} [props.size] explicit px size; omit to inherit the contextual icon-token size
  *        from the `.brand` rules in src/index.css (so a mark in a chip/tag/button matches its neighbours).
@@ -18,7 +18,7 @@ export function resolveBrand(name: string): ("claude" | "gemini" | "openai" | "c
  * @returns {JSX.Element|null} null when `name` does not resolve to a known mark.
  */
 export default function BrandMark({ name, size, label, className, ...rest }: {
-    name: "claude" | "gemini" | "openai" | "cursor" | "opencode" | "anthropic" | "google" | "codex" | string;
+    name: "claude" | "gemini" | "openai" | "cursor" | "opencode" | "strike" | "anthropic" | "google" | "codex" | string;
     size?: number;
     label?: string;
     className?: string;

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

@@ -8,7 +8,7 @@
  * @param {object} props
  * @param {ChipTone} [props.tone] - semantic tone -> .chip-ok / .chip-warn / .chip-err (default: none)
  * @param {ChipSize} [props.size] - 'sm' -> .chip-sm dense box (default: none)
- * @param {string} [props.brand] - a provider/company name (claude, gemini, openai, cursor, opencode, or an alias).
+ * @param {string} [props.brand] - a provider/company name (claude, gemini, openai, cursor, opencode, strike, or an alias).
  *        When the chip names a company, pass this instead of `icon`: it leads with the real brand mark, never a generic glyph. (ignored when not resolvable)
  * @param {React.ElementType} [props.icon] - leading lucide icon component ref (e.g. icon={Hash}) (ignored when `brand` is set)
  * @param {boolean} [props.chrome=false] - mark this as a ui-chrome chip -> lowercases the label. Leave off for user content (ids, names, data values).

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

@@ -24,8 +24,22 @@
  * @param {() => void} [props.onShowOlder] - deprecated legacy pagination callback; use onNavigate.
  * @param {string} [props.label='commit history'] - accessible name for the list (lowercase chrome).
  * @param {string} [props.className] - extra classes appended to the root.
+ * @param {Array<{sessionId:string, title:string, harness?:import('@peasant-labs/schema').Harness}>} [props.sessionLanes] - the timeline's session spine gutter (the session spine gutter). Omit to keep the pre-timeline layout unchanged.
+ * @param {string|null} [props.hoveredSessionId] - drives the SessionLane hover state + secondary highlight weight.
+ * @param {string|null} [props.selectedSessionId] - drives the SessionLane selected state + primary highlight weight.
+ * @param {(sessionId: string|null) => void} [props.onHoverSession]
+ * @param {(sessionId: string) => void} [props.onSelectSession]
+ * @param {import('./graph/codeMapState.js').TimelineHighlight} [props.highlightSelected] - `deriveTimelineHighlight(...).selected` commit ids to render at primary (amber) weight.
+ * @param {import('./graph/codeMapState.js').TimelineHighlight} [props.highlightHovered] - `deriveTimelineHighlight(...).hovered` commit ids to render at secondary weight.
+ * @param {Record<string, Array<{ghostHash:string, subject?:string, resolution:string, method:string, confidence:string}>>} [props.ghostGroupsByCommit] - keyed by the successor commit id; each renders a `GhostGroup` row directly beneath it.
+ * @param {string[]|Set<string>} [props.expandedGhostGroups] - successor hashes with their ghost group open; controlled by the caller's `toggle-ghost-group` reducer state.
+ * @param {(successorHash: string) => void} [props.onToggleGhostGroup]
+ * @param {string[]|Set<string>} [props.expandedCommitSessions] - commit hashes with the `+N more` session disclosure open; controlled by the caller's `toggle-commit-sessions` reducer state.
+ * @param {(commitHash: string) => void} [props.onToggleCommitSessions]
+ * @param {Record<string, string[]>} [props.touchedFilesByCommit] - deterministically ordered file paths keyed by commit id.
+ * @param {(file: string) => void} [props.onOpenTouchedFile]
  */
-export default function CommitGraph({ commits, selectedId, onNavigate, onSelect, onOpenSession, hasMore, onShowOlder, label, className, ...rest }: {
+export default function CommitGraph({ commits, selectedId, onNavigate, onSelect, onOpenSession, hasMore, onShowOlder, label, className, sessionLanes, hoveredSessionId, selectedSessionId, onHoverSession, onSelectSession, highlightSelected, highlightHovered, ghostGroupsByCommit, expandedGhostGroups, onToggleGhostGroup, expandedCommitSessions, onToggleCommitSessions, touchedFilesByCommit, onOpenTouchedFile, ...rest }: {
     commits: Commit[];
     selectedId?: string;
     onNavigate?: (action: import("./graph/timelineNavigation.js").TimelineNavigationAction) => void;
@@ -35,6 +49,30 @@ export default function CommitGraph({ commits, selectedId, onNavigate, onSelect,
     onShowOlder?: () => void;
     label?: string;
     className?: string;
+    sessionLanes?: Array<{
+        sessionId: string;
+        title: string;
+        harness?: import("@peasant-labs/schema").Harness;
+    }>;
+    hoveredSessionId?: string | null;
+    selectedSessionId?: string | null;
+    onHoverSession?: (sessionId: string | null) => void;
+    onSelectSession?: (sessionId: string) => void;
+    highlightSelected?: import("./graph/codeMapState.js").TimelineHighlight;
+    highlightHovered?: import("./graph/codeMapState.js").TimelineHighlight;
+    ghostGroupsByCommit?: Record<string, Array<{
+        ghostHash: string;
+        subject?: string;
+        resolution: string;
+        method: string;
+        confidence: string;
+    }>>;
+    expandedGhostGroups?: string[] | Set<string>;
+    onToggleGhostGroup?: (successorHash: string) => void;
+    expandedCommitSessions?: string[] | Set<string>;
+    onToggleCommitSessions?: (commitHash: string) => void;
+    touchedFilesByCommit?: Record<string, string[]>;
+    onOpenTouchedFile?: (file: string) => void;
 }): any;
 export type Commit = {
     /**

package/dist/lib/types/commons/providers.d.ts

@@ -4,4 +4,4 @@
 export function formatProvider(provider: unknown): string;
 /** @param {import('@peasant-labs/schema').Harness} provider */
 export function providerLabel(provider: import("@peasant-labs/schema").Harness): string;
-export const PROVIDER_LABEL: Readonly<Record<"cursor" | "claude-code" | "gemini-cli" | "codex" | "opencode" | "antigravity", string>>;
+export const PROVIDER_LABEL: Readonly<Record<"strike" | "cursor" | "claude-code" | "gemini-cli" | "codex" | "opencode" | "antigravity", string>>;

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

@@ -0,0 +1,20 @@
+/**
+ * @param {object} props
+ * @param {string} props.ghostHash
+ * @param {string} [props.subject] - '' when unrecorded.
+ * @param {RewriteResolution} props.resolution
+ * @param {RewriteMethod} props.method
+ * @param {Confidence} props.confidence
+ * @param {string} [props.className]
+ */
+export default function GhostCommitNode({ ghostHash, subject, resolution, method, confidence, className, ...rest }: {
+    ghostHash: string;
+    subject?: string;
+    resolution: RewriteResolution;
+    method: RewriteMethod;
+    confidence: Confidence;
+    className?: string;
+}): any;
+export type RewriteResolution = "live" | "rewritten" | "unresolved";
+export type RewriteMethod = "hash" | "patch_id" | "author_identity" | "message_embedded" | "temporal" | "none";
+export type Confidence = "high" | "medium" | "low";

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

@@ -0,0 +1,21 @@
+/**
+ * @param {object} props
+ * @param {string} props.successorHash
+ * @param {Array<{ghostHash:string, subject?:string, resolution:string, method:string, confidence:string}>} props.ghosts
+ * @param {boolean} props.expanded
+ * @param {(successorHash: string) => void} props.onToggle
+ * @param {string} [props.className]
+ */
+export default function GhostGroup({ successorHash, ghosts, expanded, onToggle, className, ...rest }: {
+    successorHash: string;
+    ghosts: Array<{
+        ghostHash: string;
+        subject?: string;
+        resolution: string;
+        method: string;
+        confidence: string;
+    }>;
+    expanded: boolean;
+    onToggle: (successorHash: string) => void;
+    className?: string;
+}): any;

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

@@ -0,0 +1,16 @@
+/**
+ * @param {object} props
+ * @param {'primary'|'secondary'} props.weight - selection (primary) vs hover (secondary, subordinate to a lingering selection).
+ * @param {{x1:number, y1:number, x2:number, y2:number}} props.geometry
+ * @param {string} [props.className]
+ */
+export default function HighlightEdge({ weight, geometry, className, ...rest }: {
+    weight: "primary" | "secondary";
+    geometry: {
+        x1: number;
+        y1: number;
+        x2: number;
+        y2: number;
+    };
+    className?: string;
+}): any;

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

@@ -0,0 +1,25 @@
+/** @typedef {import('@peasant-labs/schema').InsightKind} InsightKind */
+/** @typedef {import('@peasant-labs/schema').InsightProvenance} InsightProvenance */
+/**
+ * @param {object} props
+ * @param {Array<{kind:InsightKind, provenance:InsightProvenance, title:string, summary?:string, evidence:Array<{sessionId:string, file?:string}>, onOpenEvidence?: Function}>} props.insights
+ * @param {(sessionId: string) => void} [props.onOpenEvidence]
+ * @param {string} [props.className]
+ */
+export default function InsightPanel({ insights, onOpenEvidence, className, ...rest }: {
+    insights: Array<{
+        kind: InsightKind;
+        provenance: InsightProvenance;
+        title: string;
+        summary?: string;
+        evidence: Array<{
+            sessionId: string;
+            file?: string;
+        }>;
+        onOpenEvidence?: Function;
+    }>;
+    onOpenEvidence?: (sessionId: string) => void;
+    className?: string;
+}): any;
+export type InsightKind = import("@peasant-labs/schema").InsightKind;
+export type InsightProvenance = import("@peasant-labs/schema").InsightProvenance;

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

@@ -0,0 +1,13 @@
+/**
+ * @param {object} props
+ * @param {'relevance'|'debt'|'churn'} props.rankMode
+ * @param {(rankMode: 'relevance'|'debt'|'churn') => void} props.onChange
+ * @param {string} [props.className]
+ */
+export default function RankModeControl({ rankMode, onChange, className, ...rest }: {
+    rankMode: "relevance" | "debt" | "churn";
+    onChange: (rankMode: "relevance" | "debt" | "churn") => void;
+    className?: string;
+}): any;
+export { MODES as RANK_MODE_CONTROL_MODES };
+declare const MODES: readonly ["relevance", "debt", "churn"];

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

@@ -0,0 +1,15 @@
+/**
+ * @param {object} props
+ * @param {import('./ranking.js').RankedRow} props.row
+ * @param {number} props.loc - lines of code, feeds the reused `MapNode` size class.
+ * @param {boolean} [props.selected]
+ * @param {(id: string) => void} [props.onSelect]
+ * @param {string} [props.className]
+ */
+export default function RankedRow({ row, loc, selected, onSelect, className, ...rest }: {
+    row: import("./ranking.js").RankedRow;
+    loc: number;
+    selected?: boolean;
+    onSelect?: (id: string) => void;
+    className?: string;
+}): any;

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

@@ -0,0 +1,15 @@
+/**
+ * @param {object} props
+ * @param {string} props.tag - a `SCENT_TAGS` member.
+ * @param {string} [props.hoverText] - the path-conditioned hover copy for `partial-read` rows.
+ * @param {boolean} [props.active] - when interactive, whether this tag is the active filter.
+ * @param {(tag: string|null) => void} [props.onToggle] - present -> renders as an interactive filter toggle; absent -> a plain decorative label.
+ * @param {string} [props.className]
+ */
+export default function ScentTag({ tag, hoverText, active, onToggle, className, ...rest }: {
+    tag: string;
+    hoverText?: string;
+    active?: boolean;
+    onToggle?: (tag: string | null) => void;
+    className?: string;
+}): any;

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

@@ -0,0 +1,29 @@
+/**
+ * @param {object} props
+ * @param {string} props.sessionId
+ * @param {string} props.title
+ * @param {import('@peasant-labs/schema').Harness} [props.harness]
+ * @param {boolean} [props.hovered]
+ * @param {boolean} [props.selected]
+ * @param {(sessionId: string|null) => void} props.onHover
+ * @param {(sessionId: string) => void} props.onSelect
+ * @param {Array<{ghostHash:string, subject?:string, resolution:string, method:string, confidence:string}>} [props.unresolvedGhosts]
+ * @param {string} [props.className]
+ */
+export default function SessionLane({ sessionId, title, harness, hovered, selected, onHover, onSelect, unresolvedGhosts, className, ...rest }: {
+    sessionId: string;
+    title: string;
+    harness?: import("@peasant-labs/schema").Harness;
+    hovered?: boolean;
+    selected?: boolean;
+    onHover: (sessionId: string | null) => void;
+    onSelect: (sessionId: string) => void;
+    unresolvedGhosts?: Array<{
+        ghostHash: string;
+        subject?: string;
+        resolution: string;
+        method: string;
+        confidence: string;
+    }>;
+    className?: string;
+}): any;

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

@@ -0,0 +1,23 @@
+/**
+ * @param {object} props
+ * @param {string} props.commitHash - or any owning-row id; used to key the reducer's `toggle-commit-sessions`.
+ * @param {Array<{sessionId:string, title:string, harness?:import('@peasant-labs/schema').Harness}>} props.overflow - the sessions beyond the inline-2.
+ * @param {boolean} props.expanded
+ * @param {(id: string) => void} props.onToggle
+ * @param {(sessionId: string) => void} [props.onSelect]
+ * @param {string} [props.itemLabel='sessions']
+ * @param {string} [props.className]
+ */
+export default function SessionOverflowDisclosure({ commitHash, overflow, expanded, onToggle, onSelect, itemLabel, className, ...rest }: {
+    commitHash: string;
+    overflow: Array<{
+        sessionId: string;
+        title: string;
+        harness?: import("@peasant-labs/schema").Harness;
+    }>;
+    expanded: boolean;
+    onToggle: (id: string) => void;
+    onSelect?: (sessionId: string) => void;
+    itemLabel?: string;
+    className?: string;
+}): any;

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

@@ -0,0 +1,17 @@
+/**
+ * @param {object} props
+ * @param {string} props.commitHash
+ * @param {string[]} props.files - already ordered by the caller (DOI intrinsic, or visit order when a session is selected).
+ * @param {boolean} props.expanded
+ * @param {(id: string) => void} props.onToggle
+ * @param {(file: string) => void} [props.onOpenDiff]
+ * @param {string} [props.className]
+ */
+export default function TouchedFileCluster({ commitHash, files, expanded, onToggle, onOpenDiff, className, ...rest }: {
+    commitHash: string;
+    files: string[];
+    expanded: boolean;
+    onToggle: (id: string) => void;
+    onOpenDiff?: (file: string) => void;
+    className?: string;
+}): any;

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

@@ -15,6 +15,40 @@ export function codeMapStatesEqual(left: CodeMapState, right: CodeMapState): boo
  * @returns {CodeMapState}
  */
 export function reduceCodeMapState(state: CodeMapState, action: CodeMapAction): CodeMapState;
+/**
+ * Pure derivation of the timeline's highlight state. Hover is
+ * subordinate to selection: both are returned independently so a caller can render
+ * selection at primary weight (amber fill) and hover as a secondary/additive
+ * layer (stroke width-step + glow) without one clearing the other. Escape
+ * clears hover, then selection; see `resolveEscapeAction`.
+ * @param {{edges: Array<{sessionId:string, commitHash:string, ghost?:boolean}>}|undefined|null} payload
+ * @param {CodeMapState} state
+ * @returns {{selected: TimelineHighlight, hovered: TimelineHighlight}}
+ */
+export function deriveTimelineHighlight(payload: {
+    edges: Array<{
+        sessionId: string;
+        commitHash: string;
+        ghost?: boolean;
+    }>;
+} | undefined | null, state: CodeMapState): {
+    selected: TimelineHighlight;
+    hovered: TimelineHighlight;
+};
+/**
+ * The Escape-key contract: "Escape clears hover then selection."
+ * Pure and reusable by every primitive that captures the key, so the two-step
+ * behavior lives in exactly one place. Returns null when there is nothing to clear.
+ * @param {CodeMapState} state
+ * @returns {{type:'hover-session', sessionId:null} | {type:'select-session', sessionId:null} | null}
+ */
+export function resolveEscapeAction(state: CodeMapState): {
+    type: "hover-session";
+    sessionId: null;
+} | {
+    type: "select-session";
+    sessionId: null;
+} | null;
 /**
  * Derives the complete navigator and canvas inputs from payload plus canonical state.
  * Returned nodes are plain public payload data; no private indexes or depths are attached.
@@ -24,7 +58,11 @@ export function reduceCodeMapState(state: CodeMapState, action: CodeMapAction):
  */
 export function deriveCodeMapView(payload: import("./types.js").CodeMapPayload | undefined | null, state: CodeMapState): CodeMapView;
 /** @typedef {import('./types.js').MapNodePayload} MapNodePayload */
-/** @typedef {{type:'replace'|'hydrate', state:Partial<CodeMapState>} | {type:'set-presentation', presentation:CodeMapPresentation} | {type:'select'|'toggle-expanded'|'open-in-map', id:string} | {type:'focus', id:string|null} | {type:'clear-selection'} | {type:'set-filter', filter:string} | {type:'set-expanded', ids:Iterable<string>} | {type:'set-grain', grain:CodeMapGrain} | {type:'set-viewport', viewport:CodeMapViewport|null} | {type:'reveal', id:string, grain:CodeMapGrain, expandedIds:Iterable<string>}} CodeMapAction */
+/**
+ * The COMPLETE public timeline/ranking action surface. Frozen here: names are
+ * consumed downstream (the timeline surface, the ranked entry list) and are never renamed.
+ * @typedef {{type:'replace'|'hydrate', state:Partial<CodeMapState>} | {type:'set-presentation', presentation:CodeMapPresentation} | {type:'select'|'toggle-expanded'|'open-in-map', id:string} | {type:'focus', id:string|null} | {type:'clear-selection'} | {type:'set-filter', filter:string} | {type:'set-expanded', ids:Iterable<string>} | {type:'set-grain', grain:CodeMapGrain} | {type:'set-viewport', viewport:CodeMapViewport|null} | {type:'reveal', id:string, grain:CodeMapGrain, expandedIds:Iterable<string>} | {type:'hover-session', sessionId:string|null} | {type:'select-session', sessionId:string|null} | {type:'toggle-commit-sessions', commitHash:string} | {type:'toggle-ghost-group', successorHash:string} | {type:'set-rank-mode', rankMode:CodeMapRankMode} | {type:'set-scent-filter', scentFilter:string|null} | {type:'set-rank-expanded', expanded:boolean}} CodeMapAction
+ */
 /**
  * @typedef {object} CodeMapState
  * @property {1} version
@@ -35,6 +73,12 @@ export function deriveCodeMapView(payload: import("./types.js").CodeMapPayload |
  * @property {string} navigatorFilter
  * @property {string|null} navigatorFocusedId
  * @property {CodeMapViewport|null} viewport
+ * @property {string|null} hoveredSessionId - transient; set/cleared by `hover-session`, never persisted to the route.
+ * @property {string|null} selectedSessionId - lingers after the pointer leaves; route-persisted (shareable deep link).
+ * @property {string[]} expandedCommitSessions - disclosure keys: commit hashes for sessions, `files:<hash>` for touched files, and `ranked:all` for the ranked-list cap.
+ * @property {string[]} expandedGhostGroups - successor commit hashes with their ghost group expanded.
+ * @property {CodeMapRankMode} rankMode - ranked-entry-list scoring mode.
+ * @property {string|null} scentFilter - one `SCENT_TAGS` member, or null for no filter.
  */
 /** @typedef {{node:import('./types.js').MapNodePayload, depth:number, parentId:string|null, childIds:string[], hasChildren:boolean, canExpand:boolean, forcedOpen:boolean, expanded:boolean}} CodeMapNavigatorRow */
 /** @typedef {{orderedIds:string[], rootIds:string[], childIdsByParent:Record<string,string[]>, depthById:Record<string,number>}} CodeMapHierarchy */
@@ -50,6 +94,16 @@ export const CODE_MAP_GRAIN_DEPTH: Readonly<{
     package: 1;
     file: 1;
 }>;
+export type TimelineHighlight = {
+    sessionId: string | null;
+    commitHashes: string[];
+    ghostHashes: string[];
+    edges: Array<{
+        sessionId: string;
+        commitHash: string;
+        ghost?: boolean;
+    }>;
+};
 export type CodeMapPresentation = "navigator" | "canvas";
 export type CodeMapGrain = "project" | "package" | "file";
 export type CodeMapViewport = {
@@ -57,7 +111,12 @@ export type CodeMapViewport = {
     panX: number;
     panY: number;
 };
+export type CodeMapRankMode = "relevance" | "debt" | "churn";
 export type MapNodePayload = import("./types.js").MapNodePayload;
+/**
+ * The COMPLETE public timeline/ranking action surface. Frozen here: names are
+ * consumed downstream (the timeline surface, the ranked entry list) and are never renamed.
+ */
 export type CodeMapAction = {
     type: "replace" | "hydrate";
     state: Partial<CodeMapState>;
@@ -89,6 +148,27 @@ export type CodeMapAction = {
     id: string;
     grain: CodeMapGrain;
     expandedIds: Iterable<string>;
+} | {
+    type: "hover-session";
+    sessionId: string | null;
+} | {
+    type: "select-session";
+    sessionId: string | null;
+} | {
+    type: "toggle-commit-sessions";
+    commitHash: string;
+} | {
+    type: "toggle-ghost-group";
+    successorHash: string;
+} | {
+    type: "set-rank-mode";
+    rankMode: CodeMapRankMode;
+} | {
+    type: "set-scent-filter";
+    scentFilter: string | null;
+} | {
+    type: "set-rank-expanded";
+    expanded: boolean;
 };
 export type CodeMapState = {
     version: 1;
@@ -99,6 +179,30 @@ export type CodeMapState = {
     navigatorFilter: string;
     navigatorFocusedId: string | null;
     viewport: CodeMapViewport | null;
+    /**
+     * - transient; set/cleared by `hover-session`, never persisted to the route.
+     */
+    hoveredSessionId: string | null;
+    /**
+     * - lingers after the pointer leaves; route-persisted (shareable deep link).
+     */
+    selectedSessionId: string | null;
+    /**
+     * - disclosure keys: commit hashes for sessions, `files:<hash>` for touched files, and `ranked:all` for the ranked-list cap.
+     */
+    expandedCommitSessions: string[];
+    /**
+     * - successor commit hashes with their ghost group expanded.
+     */
+    expandedGhostGroups: string[];
+    /**
+     * - ranked-entry-list scoring mode.
+     */
+    rankMode: CodeMapRankMode;
+    /**
+     * - one `SCENT_TAGS` member, or null for no filter.
+     */
+    scentFilter: string | null;
 };
 export type CodeMapNavigatorRow = {
     node: import("./types.js").MapNodePayload;

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

@@ -0,0 +1,24 @@
+/** @param {Array<{kind:string, provenance:string}>} insights */
+export function assertInsightContractValues(insights: Array<{
+    kind: string;
+    provenance: string;
+}>): void;
+/** @param {Array<{readAttribution:string, readState:string}>} nodes */
+export function assertRankingContractValues(nodes: Array<{
+    readAttribution: string;
+    readState: string;
+}>): void;
+/** @typedef {import('@peasant-labs/schema').InsightKind} InsightKind */
+/** @typedef {import('@peasant-labs/schema').InsightProvenance} InsightProvenance */
+/** @typedef {import('@peasant-labs/schema').ReadAttributionState} ReadAttributionState */
+/** @typedef {import('@peasant-labs/schema').ReadStateGrade} ReadStateGrade */
+/** @typedef {{markerClass:string}} InsightProvenancePresentation */
+export const INSIGHT_KIND_LABELS: Readonly<Readonly<Record<"unusual" | "decision" | "friction" | "retry_loop", string>>>;
+export const INSIGHT_PROVENANCE_PRESENTATIONS: Readonly<Readonly<Record<"mechanical" | "mined", InsightProvenancePresentation>>>;
+export type InsightKind = import("@peasant-labs/schema").InsightKind;
+export type InsightProvenance = import("@peasant-labs/schema").InsightProvenance;
+export type ReadAttributionState = import("@peasant-labs/schema").ReadAttributionState;
+export type ReadStateGrade = import("@peasant-labs/schema").ReadStateGrade;
+export type InsightProvenancePresentation = {
+    markerClass: string;
+};

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

@@ -2,11 +2,25 @@ export { default as Changes } from "./Changes.jsx";
 export { default as ChangeDetail } from "./ChangeDetail.jsx";
 export { default as CodeMapNavigator } from "./CodeMapNavigator.jsx";
 export { assertTimelineNavigationAction } from "./timelineNavigation.js";
+export { default as SessionLane } from "./SessionLane.jsx";
+export { default as GhostCommitNode } from "./GhostCommitNode.jsx";
+export { default as GhostGroup } from "./GhostGroup.jsx";
+export { default as HighlightEdge } from "./HighlightEdge.jsx";
+export { default as SessionOverflowDisclosure } from "./SessionOverflowDisclosure.jsx";
+export { default as RankedRow } from "./RankedRow.jsx";
+export { default as ScentTag } from "./ScentTag.jsx";
+export { default as RankModeControl } from "./RankModeControl.jsx";
+export { default as InsightPanel } from "./InsightPanel.jsx";
+export { default as TouchedFileCluster } from "./TouchedFileCluster.jsx";
 export type MapNodeKind = import("./types.js").MapNodeKind;
 export type ChangeBinding = import("./types.js").ChangeBinding;
 export type EdgeViolationKind = import("./types.js").EdgeViolationKind;
 export type FileChangeStatus = import("./types.js").FileChangeStatus;
 export type DiffLineKind = import("./types.js").DiffLineKind;
+export type InsightKind = import("@peasant-labs/schema").InsightKind;
+export type InsightProvenance = import("@peasant-labs/schema").InsightProvenance;
+export type ReadAttributionState = import("@peasant-labs/schema").ReadAttributionState;
+export type ReadStateGrade = import("@peasant-labs/schema").ReadStateGrade;
 export type CommitRefPayload = import("./types.js").CommitRefPayload;
 export type TimelineSessionPayload = import("./types.js").TimelineSessionPayload;
 export type MapEdgePayload = import("./types.js").MapEdgePayload;
@@ -35,10 +49,16 @@ export type CodeMapNavigatorRow = import("./codeMapState.js").CodeMapNavigatorRo
 export type CodeMapCanvasView = import("./codeMapState.js").CodeMapCanvasView;
 export type CodeMapView = import("./codeMapState.js").CodeMapView;
 export type TimelineNavigationAction = import("./timelineNavigation.js").TimelineNavigationAction;
+export type CodeMapRankMode = import("./codeMapState.js").CodeMapRankMode;
+export type TimelineHighlight = import("./codeMapState.js").TimelineHighlight;
+export type RankInputNode = import("./ranking.js").RankInputNode;
+export type RankedRowData = import("./ranking.js").RankedRow;
+export type DebtState = import("./ranking.js").DebtState;
 export { default as CodeMap, codeMapPayloadToMapData } from "./CodeMap.jsx";
 export { default as CodeMapComposition, DefaultMapLegend } from "./CodeMapComposition.jsx";
-export { CODE_MAP_STATE_VERSION, CODE_MAP_VIEWPORT_SCALE, isCodeMapViewportScale, codeMapStatesEqual, createCodeMapState, reduceCodeMapState, deriveCodeMapView } from "./codeMapState.js";
+export { CODE_MAP_STATE_VERSION, CODE_MAP_VIEWPORT_SCALE, isCodeMapViewportScale, codeMapStatesEqual, createCodeMapState, reduceCodeMapState, deriveCodeMapView, deriveTimelineHighlight, resolveEscapeAction } from "./codeMapState.js";
 export { GraphAppShell, GraphSectionNav, GRAPH_APP_SECTIONS } from "../inuse/InUseShell.jsx";
 export { buildChangesGraph, humanizeAge } from "./changeGraph.js";
+export { DOI_WEIGHTS, DEBT_VIEWED, COVERAGE_CAP, RECENCY_HALF_LIFE_DAYS, RANK_FLOOR, RANK_CAP, SCENT_TAGS, debtState, debt, coverage, hunkClears, partialReadHoverText, debtHoverText, scentTagsFor, rankMapNodesIntrinsic, deriveRankedRows, rankMapNodes, gateRankedRows } from "./ranking.js";
 export { assertChangeDetailPayloadEnums, assertChangeDiffPayloadEnums, assertCodeMapPayloadEnums, MAP_NODE_KINDS, CHANGE_BINDINGS, EDGE_VIOLATION_KINDS, FILE_CHANGE_STATUSES, DIFF_LINE_KINDS } from "./types.js";
-export { MapNodeKind, AllMapNodeKinds, isMapNodeKind, ChangeBinding, AllChangeBindings, isChangeBinding, EdgeViolationKind, AllEdgeViolationKinds, isEdgeViolationKind, FileChangeStatus, AllFileChangeStatuses, isFileChangeStatus, DiffLineKind, AllDiffLineKinds, isDiffLineKind } from "@peasant-labs/schema";
+export { MapNodeKind, AllMapNodeKinds, isMapNodeKind, ChangeBinding, AllChangeBindings, isChangeBinding, EdgeViolationKind, AllEdgeViolationKinds, isEdgeViolationKind, FileChangeStatus, AllFileChangeStatuses, isFileChangeStatus, DiffLineKind, AllDiffLineKinds, isDiffLineKind, InsightKind, AllInsightKinds, isInsightKind, InsightProvenance, AllInsightProvenances, isInsightProvenance, ReadAttributionState, AllReadAttributionStates, isReadAttributionState, ReadStateGrade, AllReadStateGrades, isReadStateGrade } from "@peasant-labs/schema";