@validation-os/dashboard 0.7.1 → 0.9.0

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { Collection, AnyRecord, Relation } from '@validation-os/core';
+import { Collection, AnyRecord, Result, Rung, MagnitudeBand, Relation, BarLine } from '@validation-os/core';
 import { PortfolioProgress, StageExperimentInput, MoveKind, NextMoveInput, BeliefStage, JourneyEvent, NextMove, JourneyEventKind, ConfSign, StageKey, Progress, MoverKind, TrajectoryPoint } from '@validation-os/core/derivation';
 export { StageKey } from '@validation-os/core/derivation';
 
@@ -243,7 +243,9 @@ interface GroupBucket {
  * risk band by severity, everything else first-appearance.
  */
 declare function groupRecords(records: AnyRecord[], axis: GroupByAxis): GroupBucket[];
-/** Case-insensitive substring filter over Title + Description. */
+/** Case-insensitive substring filter over Title + Description + Source. Source
+ * (a reading's generator — person / dataset / cohort) is searchable so a
+ * teammate can pull every reading from one source by typing its name. */
 declare function filterRecords(records: AnyRecord[], query: string): AnyRecord[];
 /** A stable sort by one key; numbers compare numerically, everything else by
  * locale string. Missing values sort last regardless of direction. */
@@ -384,6 +386,60 @@ interface SidebarNavProps {
  */
 declare function SidebarNav({ route, onNavigate, counts, needsHuman, registers, }: SidebarNavProps): react.JSX.Element;
 
+/**
+ * The "Connect Claude Code" command composer (OPS-1349). A person signed into
+ * the dashboard mints a personal token and gets back ONE ready-to-paste command
+ * that points their own Claude Code at this hosted register through the
+ * `remote-api` connector. Everything environmental — the API URL, the env-var
+ * name — is baked in here; the person supplies only their minted token.
+ *
+ * Pure and deterministic so it can be unit-tested exactly (prior art:
+ * `route.ts`). The config keys it writes (`api_base_url`, `token_env`) are the
+ * `remote-api` connector's contract, fixed by the spec — so this does not
+ * depend on the connector doc or the setup wizard shipping first.
+ */
+/** The env var the `remote-api` connector reads the bearer token from. */
+declare const DEFAULT_TOKEN_ENV = "VALIDATION_OS_TOKEN";
+interface ConnectCommandInput {
+    /** The personal bearer token the deployment minted for the signed-in user. */
+    token: string;
+    /** The hosted API root, baked in by the deployment. */
+    apiBaseUrl: string;
+    /** Override the token env-var name; defaults to {@link DEFAULT_TOKEN_ENV}. */
+    tokenEnv?: string;
+}
+/**
+ * Build the paste command: export the token into its env var, then write a
+ * `remote-api` `validation-os.config.yaml` at the workspace root. Running it
+ * leaves the workspace ready for `/setup-validation-os` to confirm, or for the
+ * skills to use directly.
+ */
+declare function composeConnectCommand(input: ConnectCommandInput): string;
+
+/**
+ * The "Connect Claude Code" page (OPS-1349). A person already signed into the
+ * dashboard mints a personal token and gets one ready-to-paste command that
+ * points their own Claude Code at this hosted register.
+ *
+ * Auth-vendor-free by construction: token minting is INJECTED (`mintToken`), so
+ * this package never imports Clerk — the deployment wires a mint function that
+ * creates the signed-in user's personal API key and hands back the token
+ * (mirrors how the API's `authenticate` is injected). The command itself is the
+ * pure `composeConnectCommand`; this component is only the chrome around it.
+ */
+interface ConnectClaudeCodeProps {
+    /** The hosted API root, baked into the emitted command. */
+    apiBaseUrl: string;
+    /** Override the token env-var name written into the config. */
+    tokenEnv?: string;
+    /**
+     * Mint a personal bearer token for the signed-in user. Injected by the
+     * deployment (e.g. create a Clerk API key whose subject is the user's ID).
+     */
+    mintToken: () => Promise<string>;
+}
+declare function ConnectClaudeCode({ apiBaseUrl, tokenEnv, mintToken, }: ConnectClaudeCodeProps): react.JSX.Element;
+
 interface RecordPageProps {
     /** The record being drilled into (`#record/<id>`). */
     recordId: string;
@@ -574,6 +630,75 @@ interface MovePresentation {
 /** The front-door copy + step-in modality for one act. */
 declare function movePresentation(kind: MoveKind): MovePresentation;
 
+/**
+ * The per-belief cycles view-model (OPS-1347) — the validation loop's rounds,
+ * not just the belief's flat dated event log (`journey.ts`) or the
+ * strongest-push-first attribution list (`understanding.ts`). Grounded
+ * directly in the registry model (`registry-schema.md`):
+ *
+ *  - a **cycle** is one round of the loop — an Experiment designed against
+ *    this belief, the (dated) Readings it produced, and the per-belief
+ *    bar-line verdict it settles at closure. That is literally
+ *    "experiment → readings → re-score", the round the operator asked to
+ *    see, and it is the only unit the data model pre-registers as a trial:
+ *    the bar line's `We're right if` / `We're wrong if` are written *before*
+ *    any Reading exists, so its verdict is a real round boundary, not one we
+ *    invent;
+ *  - readings with **no** Experiment (bare/found — a Market-rung commitment
+ *    or desk research dropped in directly) carry no pre-registered bar, so
+ *    they are not a "round" in that strict sense. They still move the
+ *    number, so they collect into one closing, kind-`"direct"` entry rather
+ *    than disappearing from the picture.
+ *
+ * Ordered chronologically (oldest first) — the point of this view is watching
+ * the belief move round by round, which `understanding.ts`'s magnitude-first
+ * ranking deliberately does not show.
+ *
+ * No new maths: each round's push on Confidence is read off
+ * `confidenceAttribution`'s per-experiment mover — the same decomposition
+ * `understanding.ts` shows, just regrouped by time instead of by size, so a
+ * cycle's push and the drawer's push always agree. Computed fresh on read,
+ * out of the OPS-1251 on-write recompute.
+ */
+
+/** The round's key: the experiment id, or `"direct"` for the bare-reading bucket. */
+declare const DIRECT_CYCLE_KEY = "direct";
+/** One reading's place inside a round, reduced to what the timeline draws. */
+interface CycleReadingView {
+    id: string;
+    date: string | null;
+    result: Result | null;
+}
+/** One round of the loop. */
+interface CycleView {
+    key: string;
+    kind: "experiment" | "direct";
+    /** The experiment's title; null for the direct bucket. */
+    title: string | null;
+    /** The experiment's lifecycle status; null for the direct bucket. */
+    status: string | null;
+    /** The round's anchor date: the experiment's own `Date`, or (falling back)
+     * its earliest reading's date. Null only when neither is known. */
+    date: string | null;
+    /** This belief's bar-line verdict, once judged; null pre-closure and always
+     * null for the direct bucket (it carries no bar line). */
+    barVerdict: Result | null;
+    /** The round's readings, oldest first. */
+    readings: CycleReadingView[];
+    /** Signed push on Confidence this round contributed (sums, across every
+     * round, to the belief's Confidence). */
+    contribution: number;
+    /** |contribution| — how hard this round moved the number. */
+    magnitude: number;
+}
+/**
+ * Build one belief's cycles from its readings and the Experiments register.
+ * Both arrays are the raw records (Title-cased fields) — the same shape
+ * `understanding.ts`/`journey.ts` take — so a caller loading the registers
+ * once can hand them straight through.
+ */
+declare function buildCycles(assumptionId: string, readings: AnyRecord[], experiments: AnyRecord[]): CycleView[];
+
 /** A journey event with its front-door copy attached. */
 interface JourneyEventView extends JourneyEvent {
     /** Plain-language label the story renders. */
@@ -587,6 +712,9 @@ interface JourneyView {
     stage: BeliefStage;
     /** The story: the belief's life, oldest first, `now` last. */
     events: JourneyEventView[];
+    /** The loop's rounds, oldest first (OPS-1347) — the same history the story
+     * tells, regrouped by Experiment run instead of by dated event. */
+    cycles: CycleView[];
     /** The ranked next move for this belief; null once it is resolved. */
     nextMove: NextMove | null;
     /** Killed (Invalidated) / moot / null — the drill-in's terminal state. */
@@ -626,7 +754,9 @@ declare function buildJourney(assumptionId: string, records: NextMoveRecords, no
  *    rail is pure status: nothing to act on there;
  *  - it **expands into the chronological story** through the record page's
  *    existing "Why?" reveal idiom — the dated event log (bet → score →
- *    experiment → readings → confidence-cross → now), ending in the ranked
+ *    experiment → readings → confidence-cross → now), the same history
+ *    regrouped into **rounds** (OPS-1347 — one card per Experiment run, plus
+ *    any bare/direct evidence, oldest first), and ending in the ranked
  *    next-move card (OPS-1292).
  *
  * **Step-in is story-only** (OPS-1297): the next-move card and the per-event
@@ -839,6 +969,10 @@ interface FieldEditor {
     options?: readonly string[];
     /** An empty input clears the field to `null` rather than "". */
     nullable?: boolean;
+    /** For `number`: the inclusive range a hand-scored value must sit in
+     * (e.g. Impact 0–100, `registry-schema.md`). Omitted = unbounded. */
+    min?: number;
+    max?: number;
 }
 /** The fields a register lets you edit, in render order. */
 declare function editableFields(register: Collection): FieldEditor[];
@@ -865,15 +999,21 @@ declare function hasEdits(register: Collection, original: AnyRecord, draft: Draf
  * surfaces editing one register should never drift into two different forms.
  * Derived numbers are never here — they are computed on write (OPS-1251).
  */
-declare function EditFields({ register, draft, onField, }: {
+declare function EditFields({ register, draft, errors, onField, }: {
     register: Collection;
     draft: Draft;
+    /** Per-field validation messages (keyed by field), e.g. Impact out of
+     * 0–100 — `edit.ts`'s `draftErrors`. Absent/empty = every field is valid. */
+    errors?: Record<string, string>;
     onField: (key: string, value: string) => void;
 }): react.JSX.Element;
 /** One editable field, as the control its `kind` calls for. */
-declare function FieldInput({ field, value, onChange, }: {
+declare function FieldInput({ field, value, error, onChange, }: {
     field: FieldEditor;
     value: string | undefined;
+    /** A validation message shown under the control, e.g. "Impact must be at
+     * most 100." — never blocks typing, only the Save the caller gates on it. */
+    error?: string;
     onChange: (value: string) => void;
 }): react.JSX.Element;
 
@@ -902,6 +1042,9 @@ interface RegisterTableProps {
     onRowClick?: (id: string) => void;
     /** The id of the currently-open record, highlighted in the list. */
     selectedId?: string | null;
+    /** Assumption id → title, so a reading row's belief chips read as titles
+     * rather than ids (OPS-1305). Omitted → chips fall back to the bare ids. */
+    assumptionTitles?: Map<string, string>;
 }
 /**
  * A list table for one register — a row per record, the register's key fields
@@ -911,7 +1054,139 @@ interface RegisterTableProps {
  * the treatment stays testable at the columns seam and this component stays a
  * dumb renderer. Presentational: the caller supplies the rows.
  */
-declare function RegisterTable({ register, records, onRowClick, selectedId, }: RegisterTableProps): react.JSX.Element;
+declare function RegisterTable({ register, records, onRowClick, selectedId, assumptionTitles, }: RegisterTableProps): react.JSX.Element;
+
+/**
+ * The record-page view-model (OPS-1286) — the pure join behind the canonical
+ * full record page. Given a record and the related registers, it computes the
+ * header lane/queue pills (all derived), the leading-score meters per register,
+ * the genuine human-input free-text remainder, and the backlink panels grouped
+ * by relation (each row carrying a glance-readable score chip, an empty relation
+ * kept as a "none yet" panel rather than dropped). DOM-free and unit-tested at
+ * this seam; `RecordPage` renders what it returns and the understanding layer
+ * supplies the "Why?" attribution unchanged.
+ */
+
+/** The registers a record page reads to resolve its relations. All optional —
+ * a panel whose register is absent simply resolves to "none yet". */
+interface RelatedSet {
+    assumptions?: AnyRecord[];
+    experiments?: AnyRecord[];
+    readings?: AnyRecord[];
+    decisions?: AnyRecord[];
+    glossary?: AnyRecord[];
+}
+interface RecordPageOptions {
+    /** ISO date "now" for the Overdue pill; omitted → nothing reads overdue. */
+    asOf?: string;
+}
+/** A header pill: a short derived label toned by meaning. */
+interface Pill {
+    label: string;
+    tone: Tone;
+}
+/**
+ * The derived lane/queue pills for a record header (story 2). Every register
+ * leads with its Status pill; assumptions add Moot / Kill lane / Testing,
+ * experiments add Concluded / Overdue, decisions mark Standing. All derived —
+ * none is a stored field.
+ */
+declare function headerPills(register: Collection, record: AnyRecord, related?: RelatedSet, options?: RecordPageOptions): Pill[];
+/** A leading-score meter. `bar`/`signed` carry a number in a min…max domain;
+ * `pill` carries a categorical value shown as a toned pill. */
+interface Meter {
+    key: string;
+    label: string;
+    kind: "bar" | "signed" | "pill";
+    /** Number (bar/signed) or category (pill); null when the record has no value. */
+    value: number | string | null;
+    tone: Tone;
+    /** For bar/signed: the domain the fill maps onto. */
+    min?: number;
+    max?: number;
+    /** True when a "Why?" attribution is available (Confidence only). */
+    hasWhy?: boolean;
+}
+/**
+ * The register's leading scores as meters (story 4). Reads only what the
+ * migrated schema actually stores — a derived number becomes a bar/signed meter,
+ * a categorical leading field becomes a pill; nothing is invented where the
+ * schema carries no number. Confidence is flagged `hasWhy` — the understanding
+ * layer decomposes it.
+ */
+declare function leadingMeters(register: Collection, record: AnyRecord): Meter[];
+/** The genuine human-input free-text remainder — clearly separated from what
+ * the system computed. Auto-linked against the glossary at render time. */
+interface HumanText {
+    key: string;
+    label: string;
+    text: string;
+}
+/** The human-input fields a register carries text for (empty ones dropped). */
+declare function humanInputFields(register: Collection, record: AnyRecord): HumanText[];
+/** One belief a reading grades, prepared for the reading detail's verdict list
+ * (OPS-1305). Modelled on the experiment bar-line view: the assumption resolved
+ * to a title + navigable id, plus this belief's own Rung / Result / derived
+ * Strength / magnitude band and the grading justification. */
+interface BeliefVerdict {
+    assumptionId: string;
+    /** The belief's title if it's in the loaded set, else its bare id. */
+    title: string;
+    /** True when the assumption resolved — drives whether the title links. */
+    linked: boolean;
+    rung: Rung | null;
+    result: Result | null;
+    /** Derived per-belief strength (signed −100…100). */
+    strength: number | null;
+    magnitudeBand: MagnitudeBand | null;
+    justification: string;
+}
+/** The per-belief verdicts a reading carries, in stored order — the reading
+ * detail's answer to "what did this artifact say about each belief?". Pure:
+ * resolves each belief-score against the loaded assumptions for its title. */
+declare function readingBeliefVerdicts(reading: AnyRecord, assumptions?: AnyRecord[]): BeliefVerdict[];
+/** A glance-readable score chip for a linked record (story 9). */
+interface ScoreChip {
+    label: string;
+    value: string;
+    tone: Tone;
+}
+interface BacklinkItem {
+    id: string;
+    register: Collection;
+    title: string;
+    chip: ScoreChip;
+}
+/** A relation panel — the inbound/outbound edges of one relation, grouped and
+ * labelled. Kept even when empty (story 10). */
+interface RelationPanel {
+    id: string;
+    label: string;
+    register: Collection;
+    items: BacklinkItem[];
+}
+/** The linked record's headline score, glance-readable (story 9). */
+declare function scoreChip(register: Collection, record: AnyRecord): ScoreChip;
+/** The backlink panels for a record, grouped by relation, each row carrying a
+ * score chip. Empty relations are kept (items: []) so a missing connection reads
+ * as "none yet", not an absent section (story 8/10). */
+declare function backlinkPanels(register: Collection, record: AnyRecord, related?: RelatedSet): RelationPanel[];
+type RecordTabId = "overview" | "evidence" | "connections" | "history";
+interface RecordPageModel {
+    register: Collection;
+    title: string;
+    pills: Pill[];
+    meters: Meter[];
+    humanText: HumanText[];
+    panels: RelationPanel[];
+    /** The tabs this record shows, in order (story 3 + 11). */
+    tabs: RecordTabId[];
+    /** True when the belief journey drill-in can mount here (story 13). */
+    hasJourney: boolean;
+}
+/** Assemble the whole record-page model. Pure: same record + related always
+ * gives the same page. */
+declare function buildRecordPage(register: Collection, record: AnyRecord, related?: RelatedSet, options?: RecordPageOptions): RecordPageModel;
 
 interface RecordDrawerProps {
     register: Collection;
@@ -931,6 +1206,17 @@ interface RecordDrawerProps {
     /** Open this record's canonical full page (story 12). When set, the header
      * shows a "Full page" link; the drawer stays the quick read/edit peek. */
     onOpenFull?: () => void;
+    /**
+     * Open *any* linked record's full page (OPS-1345) — the same navigation the
+     * canonical record page's Connections tab uses, reused here so a relation
+     * field or a bar line's assumption is a click, not inert text. Falls back
+     * to plain (unclickable) titles when omitted.
+     */
+    onOpenRecord?: (id: string) => void;
+    /** The other registers' rows, loaded so a relation field / bar line can
+     * resolve to a title instead of a raw id (OPS-1345). Omitted relations
+     * simply fall back to showing the id. */
+    related?: RelatedSet;
     /** Extra content below the fields in read mode — e.g. the relation editor. */
     children?: ReactNode;
 }
@@ -945,7 +1231,7 @@ interface RecordDrawerProps {
  * the relation editor (`children`). Chrome is shared via `DrawerShell`; styled
  * with the package's own token sheet, no host Tailwind.
  */
-declare function RecordDrawer({ register, record, loading, error, open, onClose, basePath, onChanged, onOpenFull, children, }: RecordDrawerProps): react.JSX.Element;
+declare function RecordDrawer({ register, record, loading, error, open, onClose, basePath, onChanged, onOpenFull, onOpenRecord, related, children, }: RecordDrawerProps): react.JSX.Element;
 
 interface RecordFormProps {
     register: Collection;
@@ -1003,7 +1289,10 @@ declare function UnderstandingPanel({ assumption, basePath, }: {
  * also moves the number, and the Confidence-over-time trajectory.
  *
  * The record → derivation-input mapping is `@validation-os/core`'s shared
- * `toReadingInput`, so a reading is read here exactly as it is server-side.
+ * `readingBeliefInputs`, which fans a reading row out into one input per belief;
+ * we keep this belief's inputs, so a reading is read here exactly as it is
+ * server-side. Archived experiments never surface here (OPS-1305) — the "Why?"
+ * only ever shows a live plan or direct evidence.
  */
 
 /** An experiment testing this assumption: how hard it moves Confidence, and
@@ -1277,6 +1566,14 @@ interface ColumnDef {
 }
 /** The columns to render for a register. */
 declare function columnsFor(register: Collection): ColumnDef[];
+/** A one-line, length-capped preview of a reading's free-text `body` (its
+ * quote), for the readings table. Collapses whitespace and ellipsises; a
+ * missing/empty body reads as the empty string (formatted to an em dash). */
+declare function bodyPreview(value: unknown, max?: number): string;
+/** The belief chips for a reading row — the assumptions it grades, resolved to
+ * titles when a lookup is given, else their bare ids. Disambiguates readings
+ * that share a Title by showing which belief(s) each one actually scored. */
+declare function readingAssumptionChips(record: AnyRecord, titleById?: Map<string, string>): string[];
 /** Read a column's raw value from a record (accessor, else `record[key]`). */
 declare function cellValue(column: ColumnDef, record: AnyRecord): unknown;
 /** Format any stored value for display; empty/missing reads as an em dash. */
@@ -1284,6 +1581,17 @@ declare function formatValue(value: unknown): string;
 /** The record's headline for a row/drawer: Title, else Name, else its id. */
 declare function primaryLabel(record: AnyRecord): string;
 
+/** Render Markdown `text` into the package's prose styling. Empty → nothing. */
+declare function Markdown({ text }: {
+    text: string;
+}): react.JSX.Element | null;
+
+declare function BeliefVerdicts({ reading, assumptions, onOpenRecord, }: {
+    reading: AnyRecord;
+    assumptions: AnyRecord[];
+    onOpenRecord?: (id: string) => void;
+}): react.JSX.Element;
+
 /**
  * The editable-field spec for the "new record" form, per register — kept as
  * pure data + functions (like `columns.ts`) so the create form is unit-testable
@@ -1418,115 +1726,62 @@ interface GlossaryTextProps {
 declare function GlossaryText({ text, terms, selfId, onOpenTerm, }: GlossaryTextProps): react.JSX.Element;
 
 /**
- * The record-page view-model (OPS-1286) — the pure join behind the canonical
- * full record page. Given a record and the related registers, it computes the
- * header lane/queue pills (all derived), the leading-score meters per register,
- * the genuine human-input free-text remainder, and the backlink panels grouped
- * by relation (each row carrying a glance-readable score chip, an empty relation
- * kept as a "none yet" panel rather than dropped). DOM-free and unit-tested at
- * this seam; `RecordPage` renders what it returns and the understanding layer
- * supplies the "Why?" attribution unchanged.
+ * The record drawer's generic field list (OPS-1345) — the pure view-model
+ * behind the "everything else" rows a record carries beyond its meters/
+ * human-text/panels. `RecordDrawer` iterates a record's own keys (skipping
+ * provenance/meta), and this module decides how each one reads: a relation
+ * id/id-list (`Depends on`, `Readings`, `Assumption`…) resolves to the linked
+ * record's title, `Owner`/`Agreed by` (stored as dashboard-user objects,
+ * `{id, name}` — `connectors/nosql-schema.md`) reads as name(s) only, and
+ * `barLines` (the embedded per-belief pre-registration on an experiment)
+ * reads as structured rows with a linked assumption title — never the raw
+ * stored JSON or an internal id, per this project's "explain visually, hide
+ * complexity" bias. Everything else still formats through `columns.ts`.
+ * DOM-free and unit-tested at this seam; `record-drawer.tsx` renders what it
+ * returns.
  */
 
-/** The registers a record page reads to resolve its relations. All optional —
- * a panel whose register is absent simply resolves to "none yet". */
-interface RelatedSet {
-    assumptions?: AnyRecord[];
-    experiments?: AnyRecord[];
-    readings?: AnyRecord[];
-    decisions?: AnyRecord[];
-    glossary?: AnyRecord[];
-}
-interface RecordPageOptions {
-    /** ISO date "now" for the Overdue pill; omitted → nothing reads overdue. */
-    asOf?: string;
-}
-/** A header pill: a short derived label toned by meaning. */
-interface Pill {
-    label: string;
-    tone: Tone;
-}
-/**
- * The derived lane/queue pills for a record header (story 2). Every register
- * leads with its Status pill; assumptions add Moot / Kill lane / Testing,
- * experiments add Concluded / Overdue, decisions mark Standing. All derived —
- * none is a stored field.
- */
-declare function headerPills(register: Collection, record: AnyRecord, related?: RelatedSet, options?: RecordPageOptions): Pill[];
-/** A leading-score meter. `bar`/`signed` carry a number in a min…max domain;
- * `pill` carries a categorical value shown as a toned pill. */
-interface Meter {
-    key: string;
-    label: string;
-    kind: "bar" | "signed" | "pill";
-    /** Number (bar/signed) or category (pill); null when the record has no value. */
-    value: number | string | null;
-    tone: Tone;
-    /** For bar/signed: the domain the fill maps onto. */
-    min?: number;
-    max?: number;
-    /** True when a "Why?" attribution is available (Confidence only). */
-    hasWhy?: boolean;
-}
-/**
- * The register's leading scores as meters (story 4). Reads only what the
- * migrated schema actually stores — a derived number becomes a bar/signed meter,
- * a categorical leading field becomes a pill; nothing is invented where the
- * schema carries no number. Confidence is flagged `hasWhy` — the understanding
- * layer decomposes it.
- */
-declare function leadingMeters(register: Collection, record: AnyRecord): Meter[];
-/** The genuine human-input free-text remainder — clearly separated from what
- * the system computed. Auto-linked against the glossary at render time. */
-interface HumanText {
-    key: string;
-    label: string;
-    text: string;
-}
-/** The human-input fields a register carries text for (empty ones dropped). */
-declare function humanInputFields(register: Collection, record: AnyRecord): HumanText[];
-/** A glance-readable score chip for a linked record (story 9). */
-interface ScoreChip {
-    label: string;
-    value: string;
-    tone: Tone;
-}
-interface BacklinkItem {
+type DetailRowKind = "text" | "relation" | "owner" | "bar-lines";
+/** One resolved relation target — a title to show, an id to navigate to. */
+interface DetailRelationItem {
     id: string;
     register: Collection;
     title: string;
-    chip: ScoreChip;
 }
-/** A relation panel — the inbound/outbound edges of one relation, grouped and
- * labelled. Kept even when empty (story 10). */
-interface RelationPanel {
-    id: string;
-    label: string;
-    register: Collection;
-    items: BacklinkItem[];
+/** One bar line, human-readable: the belief it tests resolved to a title. */
+interface ResolvedBarLine {
+    rightIf: string;
+    wrongIf: string | null;
+    plannedRung: string;
+    barVerdict: string | null;
+    assumption: DetailRelationItem | null;
 }
-/** The linked record's headline score, glance-readable (story 9). */
-declare function scoreChip(register: Collection, record: AnyRecord): ScoreChip;
-/** The backlink panels for a record, grouped by relation, each row carrying a
- * score chip. Empty relations are kept (items: []) so a missing connection reads
- * as "none yet", not an absent section (story 8/10). */
-declare function backlinkPanels(register: Collection, record: AnyRecord, related?: RelatedSet): RelationPanel[];
-type RecordTabId = "overview" | "evidence" | "connections" | "history";
-interface RecordPageModel {
-    register: Collection;
-    title: string;
-    pills: Pill[];
-    meters: Meter[];
-    humanText: HumanText[];
-    panels: RelationPanel[];
-    /** The tabs this record shows, in order (story 3 + 11). */
-    tabs: RecordTabId[];
-    /** True when the belief journey drill-in can mount here (story 13). */
-    hasJourney: boolean;
-}
-/** Assemble the whole record-page model. Pure: same record + related always
- * gives the same page. */
-declare function buildRecordPage(register: Collection, record: AnyRecord, related?: RelatedSet, options?: RecordPageOptions): RecordPageModel;
+interface DetailRow {
+    key: string;
+    label: string;
+    kind: DetailRowKind;
+    /** `kind: "text"` — the formatted display string. */
+    text?: string;
+    /** `kind: "relation"` — the resolved link targets, in stored order. */
+    items?: DetailRelationItem[];
+    /** `kind: "owner"` — the dashboard-user name(s), never the id/object. */
+    names?: string[];
+    /** `kind: "bar-lines"` — the embedded pre-registration, resolved. */
+    bars?: ResolvedBarLine[];
+}
+/** The dashboard-user name(s) off an `Owner`/`Agreed by` value — the stored
+ * shape is `{id, name}[]`; a bare string is tolerated as a fallback. */
+declare function ownerNames(value: unknown): string[];
+/** Bar lines resolved against the loaded assumptions — shared by the drawer's
+ * generic list and the record page's Evidence tab so the two never drift. */
+declare function resolveBarLines(bars: BarLine[], related: RelatedSet): ResolvedBarLine[];
+/**
+ * The record's own fields, beyond its meta/derived tuple, as rows a drawer
+ * can render directly — relation fields resolved to a title + navigate
+ * target, `Owner`/`Agreed by` to plain names, `barLines` to structured rows.
+ * Everything else still formats through `formatValue` (spec stories 1–3).
+ */
+declare function detailRows(register: Collection, record: AnyRecord, related?: RelatedSet): DetailRow[];
 
 /** Plain-language labels — the register is a surface a non-technical
  * teammate meets, so no jargon and no code-y plurals. */
@@ -1548,4 +1803,4 @@ declare const REGISTER_GROUPS: {
     registers: Collection[];
 }[];
 
-export { type BacklinkItem, BeliefJourney, type BeliefJourneyProps, CONFLICT_MESSAGE, type CellKind, type ColdStart, type ColumnDef, ConfidenceCell, type Counts, type DashboardConfig, type Draft, EditBeliefForm, type EditBeliefFormProps, EditFields, type ExperimentView, FIRST_RUN_LINE, type FieldEditor, FieldInput, type FieldKind, type FormField, type GlossaryTerm, GlossaryText, type GlossaryTextProps, type GroupBucket, type GroupByAxis, type HumanText, type JourneyColdState, type JourneyEventView, type JourneyView, type LinkArgs, type LinkChoice, type LinkifyNode, type LinkifyOptions, type Meter, type MeterKind, type MovePresentation, type NeedsHumanByRegister, type NeedsHumanCounts, type NeighbourChip, type NestedGroup, type NextColdStart, type NextMoveRecords, NextMoveSurface, type NextMoveSurfaceProps, type OtherMover, type Pill, type PipelineColdStart, type PipelineRow, PipelineSurface, type PipelineView, REGISTER_GROUPS, REGISTER_ICON, REGISTER_LABEL, REGISTER_ORDER, REGISTER_SINGULAR, REGISTER_SUBTITLE, RISK_CRIT, RISK_WARN, RecordDrawer, type RecordDrawerProps, RecordForm, type RecordFormProps, RecordPage, type RecordPageModel, type RecordPageProps, type RecordTabId, RegisterBrowser, type RegisterBrowserProps, type RegisterContext, RegisterCounts, type RegisterCountsProps, RegisterTable, type RegisterTableProps, type RelatedSet, RelationEditor, type RelationEditorProps, type RelationPanel, type ResolvedRow, type RiskBand, RiskBar, type Route, type SaveResult, type SavedView, type ScoreChip, ScoreImpactForm, type ScoreImpactFormProps, type ShapedRegister, SidebarNav, type SidebarNavProps, type SortSpec, Sparkline, type StageMeterInput, type StageMeterView, StatTile, StatusPill, type StepInForm, type StoryStepIn, SurfacePlaceholder, type SurfacePlaceholderProps, type TabDef, type TermPreview, type Tone, type Understanding, UnderstandingPanel, type UseCountsResult, type UseCreateResult, type UseLinkResult, type UseListResult, type UseNeedsHumanResult, type UseRecordResult, type UseSavedViewsResult, type UseUpdateResult, ValidationOSDashboard, type ValidationOSDashboardProps, type ViewDescriptor, WriteDecisionForm, type WriteDecisionFormProps, backlinkPanels, buildJourney, buildPatch, buildPipeline, buildRecordPage, buildUnderstanding, cellValue, coldStartFor, columnsFor, confidenceTone, configureRiskBands, defaultTabId, dontConfuseWith, draftFrom, editableFields, emptyDraft, eventStepIn, eventTone, filterRecords, formFieldsFor, formatCount, formatRoute, formatSigned, formatValue, groupByAxesFor, groupRecords, hasEdits, headerPills, humanInputFields, interpretSave, journeyColdState, leadingMeters, linkChoicesFrom, linkify, missingRequired, movePresentation, needsHumanCounts, nestReadingsByPlan, parseRoute, primaryLabel, riskBand, riskFraction, riskLevel, scoreChip, shapeRegister, sortRecords, sparklinePath, stageMeters, statusTone, tabsFor, toCreatePayload, toGlossaryTerms, toNextMoveInput, toStageExperimentInput, useCounts, useCreate, useLink, useList, useNeedsHuman, useRecord, useSavedViews, useUpdate, weekOverWeekDelta };
+export { type BacklinkItem, BeliefJourney, type BeliefJourneyProps, type BeliefVerdict, BeliefVerdicts, CONFLICT_MESSAGE, type CellKind, type ColdStart, type ColumnDef, ConfidenceCell, ConnectClaudeCode, type ConnectClaudeCodeProps, type ConnectCommandInput, type Counts, type CycleReadingView, type CycleView, DEFAULT_TOKEN_ENV, DIRECT_CYCLE_KEY, type DashboardConfig, type DetailRelationItem, type DetailRow, type DetailRowKind, type Draft, EditBeliefForm, type EditBeliefFormProps, EditFields, type ExperimentView, FIRST_RUN_LINE, type FieldEditor, FieldInput, type FieldKind, type FormField, type GlossaryTerm, GlossaryText, type GlossaryTextProps, type GroupBucket, type GroupByAxis, type HumanText, type JourneyColdState, type JourneyEventView, type JourneyView, type LinkArgs, type LinkChoice, type LinkifyNode, type LinkifyOptions, Markdown, type Meter, type MeterKind, type MovePresentation, type NeedsHumanByRegister, type NeedsHumanCounts, type NeighbourChip, type NestedGroup, type NextColdStart, type NextMoveRecords, NextMoveSurface, type NextMoveSurfaceProps, type OtherMover, type Pill, type PipelineColdStart, type PipelineRow, PipelineSurface, type PipelineView, REGISTER_GROUPS, REGISTER_ICON, REGISTER_LABEL, REGISTER_ORDER, REGISTER_SINGULAR, REGISTER_SUBTITLE, RISK_CRIT, RISK_WARN, RecordDrawer, type RecordDrawerProps, RecordForm, type RecordFormProps, RecordPage, type RecordPageModel, type RecordPageProps, type RecordTabId, RegisterBrowser, type RegisterBrowserProps, type RegisterContext, RegisterCounts, type RegisterCountsProps, RegisterTable, type RegisterTableProps, type RelatedSet, RelationEditor, type RelationEditorProps, type RelationPanel, type ResolvedBarLine, type ResolvedRow, type RiskBand, RiskBar, type Route, type SaveResult, type SavedView, type ScoreChip, ScoreImpactForm, type ScoreImpactFormProps, type ShapedRegister, SidebarNav, type SidebarNavProps, type SortSpec, Sparkline, type StageMeterInput, type StageMeterView, StatTile, StatusPill, type StepInForm, type StoryStepIn, SurfacePlaceholder, type SurfacePlaceholderProps, type TabDef, type TermPreview, type Tone, type Understanding, UnderstandingPanel, type UseCountsResult, type UseCreateResult, type UseLinkResult, type UseListResult, type UseNeedsHumanResult, type UseRecordResult, type UseSavedViewsResult, type UseUpdateResult, ValidationOSDashboard, type ValidationOSDashboardProps, type ViewDescriptor, WriteDecisionForm, type WriteDecisionFormProps, backlinkPanels, bodyPreview, buildCycles, buildJourney, buildPatch, buildPipeline, buildRecordPage, buildUnderstanding, cellValue, coldStartFor, columnsFor, composeConnectCommand, confidenceTone, configureRiskBands, defaultTabId, detailRows, dontConfuseWith, draftFrom, editableFields, emptyDraft, eventStepIn, eventTone, filterRecords, formFieldsFor, formatCount, formatRoute, formatSigned, formatValue, groupByAxesFor, groupRecords, hasEdits, headerPills, humanInputFields, interpretSave, journeyColdState, leadingMeters, linkChoicesFrom, linkify, missingRequired, movePresentation, needsHumanCounts, nestReadingsByPlan, ownerNames, parseRoute, primaryLabel, readingAssumptionChips, readingBeliefVerdicts, resolveBarLines, riskBand, riskFraction, riskLevel, scoreChip, shapeRegister, sortRecords, sparklinePath, stageMeters, statusTone, tabsFor, toCreatePayload, toGlossaryTerms, toNextMoveInput, toStageExperimentInput, useCounts, useCreate, useLink, useList, useNeedsHuman, useRecord, useSavedViews, useUpdate, weekOverWeekDelta };