@aragon-agent/cli 0.6.46 → 0.6.48

package/dist/ui/glyphs.d.ts

@@ -1,178 +0,0 @@
-/**
- * Glyphs — the SINGLE SOURCE OF TRUTH for every user-visible non-ASCII
- * character in `src/ui/**` (spec §4.1).
- *
- * `capabilities.ts` already decides whether the terminal can render Unicode, and
- * the theme already carried an `ASCII_SYMBOLS` table — but 16 files wrote their
- * glyphs as bare literals and bypassed the whole mechanism, so a legacy
- * `cmd.exe` showed mojibake for the prompt caret, the assistant marker, every
- * list bullet, the scroll indicator and all four overlay titles.
- *
- * The fix is structural rather than per-site: EVERY glyph lives in one of the
- * two tables below, components read them through `pickGlyphs(caps)`, and
- * `glyphs.test.ts` runs a static scan that fails the build if any other file
- * under the scanned tree grows a non-ASCII literal again.
- *
- * THIS FILE AND `Logo.tsx`'s art block are the only two files allowed to hold
- * non-ASCII literals under `src/ui/**` (plus the explicit `agent/headless.ts`
- * exemption). Adding a third exception means the guard rail stops guarding —
- * add a field here instead.
- */
-import type { TermCapabilities } from './capabilities.js';
-export interface Glyphs {
-    user: string;
-    assistant: string;
-    thinking: string;
-    toolPending: string;
-    toolRunning: string;
-    toolDone: string;
-    toolError: string;
-    info: string;
-    warn: string;
-    error: string;
-    bullet: string;
-    /** Static spinner glyph (reduced motion / no-Unicode fallback). */
-    spinnerStill: string;
-    gaugeFull: string;
-    gaugeEmpty: string;
-    keyOn: string;
-    keyOff: string;
-    /**
-     * Checkbox pair for a multi-select question (`allowMultiple`).
-     *
-     * Distinct from `keyOn` / `keyOff`, which are radios: a user looking at a list
-     * has to be able to tell "pick one" from "pick several" without reading the
-     * footer, and that distinction is exactly what the two shapes carry.
-     */
-    boxChecked: string;
-    boxEmpty: string;
-    wordmark: string;
-    ellipsis: string;
-    emDash: string;
-    midDot: string;
-    arrowUp: string;
-    arrowDown: string;
-    arrowLeft: string;
-    arrowRight: string;
-    check: string;
-    times: string;
-    caret: string;
-    steer: string;
-    enterKey: string;
-    /**
-     * The Shift+Enter CHORD, not the modifier alone.
-     *
-     * Concatenating a separate `shiftKey` + `enterKey` works in the Unicode tier
-     * but spells "ShiftEnter" in ASCII: the modifier symbol carries an implicit
-     * "+" that the word does not. One field per chord keeps both tiers readable.
-     */
-    shiftEnter: string;
-    /** Horizontal rule fill used by the markdown `---` block (§4.7). */
-    hrule: string;
-    railVertical: string;
-    railBranch: string;
-    railEnd: string;
-    /**
-     * Scroll-position indicator on the viewport's right edge (mouse-wheel §4.8).
-     *
-     * These are byte-for-byte identical to `railVertical` / `gaugeFull` in both
-     * tiers, and that is DELIBERATE (P2-2). This file's header mandates "add a
-     * field here instead" of a new exception, and semantic field names are what
-     * make the ASCII tier reviewable at a glance. Reusing `gaugeFull` would
-     * couple the scroll thumb to the context-window gauge, so that restyling one
-     * silently restyles the other — do not "deduplicate" them.
-     */
-    scrollTrack: string;
-    scrollThumb: string;
-    /** Redaction dot for `maskSecret` in the settings screen (§4.1 tier B). */
-    maskDot: string;
-    /**
-     * The Agents board's selection cursor (tui-subagent-panel D-14).
-     *
-     * BYTE-IDENTICAL to `todoActive`, and still a field of its own: the two carry
-     * different meanings - "the item the run is on" versus "the child this panel is
-     * showing" - and reusing the todo glyph would restyle the board the day someone
-     * redraws the TODO rail. `scrollTrack` / `scrollThumb` above are the same precedent.
-     */
-    cursor: string;
-    /**
-     * Team mode (team-subagents §6.1). The rail marker for a dispatch card and
-     * the prefix on the panel's incoming-message preview.
-     *
-     * They live HERE rather than in `TeamPanel` / `TeamCard` for the reason this
-     * file's header gives: a literal in a component bypasses `pickGlyphs` entirely
-     * and shows mojibake on a legacy console, whatever the capability probe said.
-     */
-    teamAgent: string;
-    teamMail: string;
-    /**
-     * Todo planning (todo-plan-execution §6.1). One marker per item state, plus
-     * the rail marker for the transcript card via `tool.todo_write`.
-     *
-     * THE ASCII TIER USES BRACKETED FORMS FOR THE TWO SETTLED STATES, because a
-     * bare single letter cannot distinguish "done" from "failed" on a monochrome
-     * terminal. The panel pads the marker cell to 3 columns, which is what makes
-     * the mixed widths line up without a per-tier branch.
-     */
-    todoPending: string;
-    todoActive: string;
-    todoDone: string;
-    /**
-     * The ONLY glyph this feature adds (todo-acceptance-criteria D-9): `passed` is a
-     * settled positive and reuses `todoDone`, while `failed` is a genuinely new
-     * meaning.
-     *
-     * The ASCII tier must still tell "done" from "failed", so `[!]` joins `[x]` - the
-     * same three columns, which is what keeps the mixed-width list aligned with no
-     * per-tier branch.
-     */
-    todoFail: string;
-    /**
-     * API retry (llm-api-retry-backoff §6.5). The rail marker on the retry card.
-     *
-     * HERE RATHER THAN IN `RetryCard`, for the reason this file's header gives: a
-     * literal in a component bypasses `pickGlyphs` entirely and shows mojibake on a
-     * legacy console whatever the capability probe said. `glyphs.test.ts`'s static
-     * scan fails the build if either spelling appears anywhere else.
-     */
-    retry: string;
-    /**
-     * A message queued behind a running turn (tui-shift-enter-copy-queue 5.4).
-     * The rail marker on the `Queue: ...` row.
-     *
-     * HERE rather than in `QueuedEntry`, for the reason this file's header
-     * gives: a literal in a component bypasses `pickGlyphs` entirely and
-     * shows mojibake on a legacy console whatever the capability probe said.
-     */
-    queued: string;
-    /**
-     * Context compaction (context-auto-compaction §6.3). The rail marker on the
-     * compaction card.
-     *
-     * HERE RATHER THAN IN `CompactionCard`, for the reason this file's header
-     * gives: a literal in a component bypasses `pickGlyphs` entirely and shows
-     * mojibake on a legacy console whatever the capability probe said.
-     * `glyphs.test.ts`'s static scan fails the build if either spelling appears
-     * anywhere else — and `src/compaction/**` is inside that scan's scope too.
-     */
-    compaction: string;
-    /**
-     * Ink `borderStyle` name for every boxed region (composer, completion popup,
-     * overlay frame).
-     *
-     * Not a glyph we spell ourselves, which is exactly why it was missed: Ink
-     * draws `round` borders from `cli-boxes`, and those are Unicode. Every one of
-     * our own literals could degrade perfectly and a legacy console would still
-     * show a frame of mojibake around the input. `classic` is the ASCII box.
-     */
-    boxStyle: 'round' | 'classic';
-    tool: Readonly<Record<string, string>>;
-    toolDefault: string;
-}
-/**
- * The glyph set for a terminal. Memoized on `caps.unicode` — the only input —
- * so the returned object is referentially stable and safe in `useMemo` deps.
- */
-export declare function pickGlyphs(caps: TermCapabilities): Glyphs;
-/** Per-tool icon with the shared fallback (formerly `ToolCard::toolGlyph`). */
-export declare function toolGlyph(glyphs: Glyphs, name: string): string;

package/dist/ui/glyphs.js

@@ -1,165 +0,0 @@
-/**
- * Glyphs — the SINGLE SOURCE OF TRUTH for every user-visible non-ASCII
- * character in `src/ui/**` (spec §4.1).
- *
- * `capabilities.ts` already decides whether the terminal can render Unicode, and
- * the theme already carried an `ASCII_SYMBOLS` table — but 16 files wrote their
- * glyphs as bare literals and bypassed the whole mechanism, so a legacy
- * `cmd.exe` showed mojibake for the prompt caret, the assistant marker, every
- * list bullet, the scroll indicator and all four overlay titles.
- *
- * The fix is structural rather than per-site: EVERY glyph lives in one of the
- * two tables below, components read them through `pickGlyphs(caps)`, and
- * `glyphs.test.ts` runs a static scan that fails the build if any other file
- * under the scanned tree grows a non-ASCII literal again.
- *
- * THIS FILE AND `Logo.tsx`'s art block are the only two files allowed to hold
- * non-ASCII literals under `src/ui/**` (plus the explicit `agent/headless.ts`
- * exemption). Adding a third exception means the guard rail stops guarding —
- * add a field here instead.
- */
-const UNICODE_GLYPHS = {
-    user: '›',
-    assistant: '●',
-    thinking: '✱',
-    toolPending: '◦',
-    toolRunning: '◍',
-    // U+2714 has conflicting emoji widths in Ink and string-width. U+2713 is
-    // consistently one cell, including beside the right-edge scrollbar.
-    toolDone: '✓',
-    toolError: '×',
-    info: 'ⓘ',
-    warn: '▲',
-    error: '×',
-    bullet: '•',
-    spinnerStill: '·',
-    gaugeFull: '█',
-    gaugeEmpty: '░',
-    keyOn: '●',
-    keyOff: '○',
-    boxChecked: '☒',
-    boxEmpty: '☐',
-    wordmark: '◇',
-    ellipsis: '…',
-    emDash: '—',
-    midDot: '·',
-    arrowUp: '↑',
-    arrowDown: '↓',
-    arrowLeft: '←',
-    arrowRight: '→',
-    check: '✓',
-    times: '×',
-    caret: '❯',
-    steer: '⇢',
-    enterKey: '⏎',
-    shiftEnter: '⇧⏎',
-    hrule: '─',
-    railVertical: '│',
-    railBranch: '├',
-    railEnd: '╰',
-    scrollTrack: '│',
-    scrollThumb: '█',
-    maskDot: '•',
-    cursor: '▸',
-    boxStyle: 'round',
-    teamAgent: '◆',
-    teamMail: '⇄',
-    todoPending: '○',
-    todoActive: '▸',
-    todoDone: '✓',
-    todoFail: '✗',
-    retry: '↻',
-    compaction: '⤓',
-    queued: '◷',
-    tool: {
-        read_file: '▤',
-        write_file: '✎',
-        edit_file: '✎',
-        bash: '❯',
-        glob: '⌕',
-        grep: '⌕',
-        list_dir: '▤',
-        ask_user: '?',
-        submit_plan: '◈',
-        task: '◆',
-        todo_write: '≡',
-    },
-    toolDefault: '•',
-};
-const ASCII_GLYPHS = {
-    user: '>',
-    assistant: '*',
-    thinking: '*',
-    toolPending: 'o',
-    toolRunning: '*',
-    toolDone: '[ok]',
-    toolError: '[x]',
-    info: 'i',
-    warn: '!',
-    error: 'x',
-    bullet: '-',
-    spinnerStill: '*',
-    gaugeFull: '#',
-    gaugeEmpty: '-',
-    keyOn: '*',
-    keyOff: 'o',
-    boxChecked: '[x]',
-    boxEmpty: '[ ]',
-    wordmark: '<>',
-    ellipsis: '...',
-    emDash: '--',
-    midDot: '-',
-    arrowUp: '^',
-    arrowDown: 'v',
-    arrowLeft: '<',
-    arrowRight: '->',
-    check: '*',
-    times: 'x',
-    caret: '>',
-    steer: '>>',
-    enterKey: 'Enter',
-    shiftEnter: 'Shift+Enter',
-    hrule: '-',
-    railVertical: '|',
-    railBranch: '|',
-    railEnd: '\\',
-    scrollTrack: '|',
-    scrollThumb: '#',
-    maskDot: '*',
-    cursor: '>',
-    boxStyle: 'classic',
-    teamAgent: '*',
-    teamMail: '@',
-    todoPending: '[ ]',
-    todoActive: '>',
-    todoDone: '[x]',
-    todoFail: '[!]',
-    retry: '[r]',
-    compaction: '[c]',
-    queued: '*',
-    tool: {
-        read_file: '=',
-        write_file: '+',
-        edit_file: '+',
-        bash: '>',
-        glob: '/',
-        grep: '/',
-        list_dir: '=',
-        ask_user: '?',
-        submit_plan: '#',
-        task: '*',
-        todo_write: '=',
-    },
-    toolDefault: '*',
-};
-/**
- * The glyph set for a terminal. Memoized on `caps.unicode` — the only input —
- * so the returned object is referentially stable and safe in `useMemo` deps.
- */
-export function pickGlyphs(caps) {
-    return caps.unicode ? UNICODE_GLYPHS : ASCII_GLYPHS;
-}
-/** Per-tool icon with the shared fallback (formerly `ToolCard::toolGlyph`). */
-export function toolGlyph(glyphs, name) {
-    return glyphs.tool[name] ?? glyphs.toolDefault;
-}

package/dist/ui/governance-copy.d.ts

@@ -1,69 +0,0 @@
-/**
- * Governance TUI copy: every user-visible English phrase of the legion panel, the chip,
- * the settlement card and the `/gov board` overlay (governance-mode section 10.6).
- *
- * ASCII ONLY (`src/ui/**` is glyph-scanned). Phrases that need a symbol take it as a
- * template parameter from `pickGlyphs(caps)` instead of spelling it.
- *
- * WHY THIS LIVES IN `ui/` AND NOT IN `governance/copy.ts`: the engine author owns that
- * file and it carries the model-facing and notice wording. This module holds the strings
- * only the TUI draws, so the two cannot collide while both are being written. When
- * `governance/copy.ts` lands, a phrase that appears in both belongs THERE and this file
- * re-exports it - the unit tests pin these strings, so the move is a compile error and
- * not a silent fork.
- */
-import type { GovAgentState, GovRole, PipelineStepKey } from '../governance/types.js';
-export declare const GOV_TITLE = "GOVERN";
-/** One word for each pipeline step, as printed in the step strip. */
-export declare const PIPELINE_LABEL: Readonly<Record<PipelineStepKey, string>>;
-/** The role word in the roster's role column. */
-export declare const ROLE_LABEL: Readonly<Record<GovRole, string>>;
-/** What a `working` agent is doing, by role: the row says WHAT, the marker says THAT. */
-export declare const WORKING_VERB: Readonly<Record<GovRole, string>>;
-/** The state column's word for every non-working state. */
-export declare const STATE_WORD: Readonly<Record<Exclude<GovAgentState, 'working'>, string>>;
-export declare const NOT_SCORED = "not scored";
-export declare const MORE_HINT = "(/gov board)";
-export declare const PANEL_LEDGER_LABEL = "ledger";
-export declare const PANEL_HEALTH_LABEL = "health";
-export declare const PANEL_TOKEN_UNIT = "tok";
-export declare const PANEL_BOARD_HINT = "/gov board";
-export declare const STATUS_WORD: {
-    readonly pausing: "pausing";
-    readonly paused: "paused";
-    readonly escalated: "escalated";
-    readonly abandoned: "abandoned";
-    readonly closed: "closed";
-};
-/** `pausing after REVIEW`: a `/gov pause` is waiting for the running stage to finish. */
-export declare function pausingText(stage: string): string;
-/** `replaced by dev2-r1` (the glyph in front comes from the roster marker). */
-export declare function replacedByText(successor: string | null): string;
-export declare function moreText(hidden: number): string;
-export declare function workingCountText(count: number): string;
-export declare function phaseText(phase: number, phaseCount: number): string;
-export declare function phaseLongText(phase: number, phaseCount: number): string;
-/** Board tab names, in tab order. */
-export declare const BOARD_TAB_LABEL: {
-    readonly roster: "Roster";
-    readonly work: "Work packages";
-    readonly ledger: "Ledger";
-    readonly claims: "Claims";
-};
-export declare const BOARD_TITLE = "Governance board";
-export declare const BOARD_EMPTY: {
-    readonly noRun: "No governed run yet. Use /gov or Shift+Tab to enter GOVERN.";
-    readonly roster: "No agents yet.";
-    readonly work: "No work packages recorded for this view.";
-    readonly ledger: "No ledger entries yet.";
-    readonly claims: "No claims or escalations.";
-};
-export declare const BOARD_COPIED = "Copied the board file path";
-export declare const BOARD_NO_PATH = "No board file path is available yet";
-export declare const CARD_TITLE = "Governance";
-export declare const CARD_COLUMNS: {
-    readonly id: "id";
-    readonly role: "role";
-    readonly confirmed: "confirmed";
-    readonly delta: "delta";
-};

package/dist/ui/governance-copy.js

@@ -1,104 +0,0 @@
-/**
- * Governance TUI copy: every user-visible English phrase of the legion panel, the chip,
- * the settlement card and the `/gov board` overlay (governance-mode section 10.6).
- *
- * ASCII ONLY (`src/ui/**` is glyph-scanned). Phrases that need a symbol take it as a
- * template parameter from `pickGlyphs(caps)` instead of spelling it.
- *
- * WHY THIS LIVES IN `ui/` AND NOT IN `governance/copy.ts`: the engine author owns that
- * file and it carries the model-facing and notice wording. This module holds the strings
- * only the TUI draws, so the two cannot collide while both are being written. When
- * `governance/copy.ts` lands, a phrase that appears in both belongs THERE and this file
- * re-exports it - the unit tests pin these strings, so the move is a compile error and
- * not a silent fork.
- */
-export const GOV_TITLE = 'GOVERN';
-/** One word for each pipeline step, as printed in the step strip. */
-export const PIPELINE_LABEL = {
-    intake: 'INTAKE',
-    dev: 'DEV',
-    review: 'REVIEW',
-    test: 'TEST',
-    settle: 'SETTLE',
-    integrate: 'INTEGRATE',
-    fix: 'FIX',
-};
-/** The role word in the roster's role column. */
-export const ROLE_LABEL = {
-    DEV: 'DEV',
-    REV: 'REV',
-    TEST: 'TEST',
-    INSP: 'INSP',
-};
-/** What a `working` agent is doing, by role: the row says WHAT, the marker says THAT. */
-export const WORKING_VERB = {
-    DEV: 'coding',
-    REV: 'reviewing',
-    TEST: 'testing',
-    INSP: 'checking',
-};
-/** The state column's word for every non-working state. */
-export const STATE_WORD = {
-    queued: 'queued',
-    submitted: 'submitted',
-    idle: 'idle',
-    failed: 'failed',
-    eliminated: 'replaced',
-};
-export const NOT_SCORED = 'not scored';
-export const MORE_HINT = '(/gov board)';
-export const PANEL_LEDGER_LABEL = 'ledger';
-export const PANEL_HEALTH_LABEL = 'health';
-export const PANEL_TOKEN_UNIT = 'tok';
-export const PANEL_BOARD_HINT = '/gov board';
-export const STATUS_WORD = {
-    pausing: 'pausing',
-    paused: 'paused',
-    escalated: 'escalated',
-    abandoned: 'abandoned',
-    closed: 'closed',
-};
-/** `pausing after REVIEW`: a `/gov pause` is waiting for the running stage to finish. */
-export function pausingText(stage) {
-    return stage === '' ? STATUS_WORD.pausing : `${STATUS_WORD.pausing} after ${stage}`;
-}
-/** `replaced by dev2-r1` (the glyph in front comes from the roster marker). */
-export function replacedByText(successor) {
-    return successor === null ? 'replaced' : `replaced by ${successor}`;
-}
-export function moreText(hidden) {
-    return `+${hidden} more ${MORE_HINT}`;
-}
-export function workingCountText(count) {
-    return `${count} working`;
-}
-export function phaseText(phase, phaseCount) {
-    return `p${phase}/${phaseCount}`;
-}
-export function phaseLongText(phase, phaseCount) {
-    return `phase ${phase}/${phaseCount}`;
-}
-/** Board tab names, in tab order. */
-export const BOARD_TAB_LABEL = {
-    roster: 'Roster',
-    work: 'Work packages',
-    ledger: 'Ledger',
-    claims: 'Claims',
-};
-export const BOARD_TITLE = 'Governance board';
-export const BOARD_EMPTY = {
-    noRun: 'No governed run yet. Use /gov or Shift+Tab to enter GOVERN.',
-    roster: 'No agents yet.',
-    work: 'No work packages recorded for this view.',
-    ledger: 'No ledger entries yet.',
-    claims: 'No claims or escalations.',
-};
-export const BOARD_COPIED = 'Copied the board file path';
-export const BOARD_NO_PATH = 'No board file path is available yet';
-export const CARD_TITLE = 'Governance';
-export const CARD_COLUMNS = {
-    id: 'id',
-    role: 'role',
-    confirmed: 'confirmed',
-    delta: 'delta',
-};

package/dist/ui/governance-status.d.ts

@@ -1,145 +0,0 @@
-/**
- * Governance status: snapshot -> display derivations (governance-mode section 10.3).
- *
- * Pure: no Ink, no clock (callers inject `now`), no I/O. ASCII ONLY.
- *
- * WHAT LIVES HERE AND WHAT DOES NOT. The panel, the chip, the card and the board each
- * need the same few JUDGEMENTS - which colour a score label gets, whether a score change
- * is still inside its emphasis window, which pipeline step is current, what an agent's
- * state looks like to `team-status.ts`. Putting each judgement here once is the same
- * discipline `team-status.ts` records: the roster, the card and the chip used to disagree
- * about what "running" looked like because nine files each answered it.
- *
- * COLOUR IS A SEMANTIC KEY, NOT A THEME FIELD. The layout modules emit `Tone` values and
- * the components resolve them through `toneColor`, so a layout test never needs a `Theme`
- * and a theme change never touches a layout.
- */
-import type { GovAgentState, GovernanceSnapshot, RosterRow, RunStatus, StageKind } from '../governance/types.js';
-import type { ChildStatus } from './team-status.js';
-import type { Theme } from './theme.js';
-/** Semantic colour slots shared by every governance surface. */
-export type Tone = 'text' | 'muted' | 'hint' | 'border' | 'primary' | 'govern' | 'ok' | 'warn' | 'error' | 'pending' | 'running';
-/** Resolve a tone against a theme. The ONLY place a `Tone` becomes a colour. */
-export declare function toneColor(tone: Tone, theme: Theme): string | undefined;
-/** A run of text in one tone: the unit every layout line is made of. */
-export interface Segment {
-    text: string;
-    tone: Tone;
-    bold?: boolean;
-}
-export declare function segment(text: string, tone: Tone, bold?: boolean): Segment;
-export declare function govChildStatus(state: GovAgentState): ChildStatus;
-export declare function statusTone(status: ChildStatus): Tone;
-/** How a standing label reads on screen. */
-export type ScoreTone = 'ok' | 'warn' | 'danger' | 'muted';
-export declare function scoreTone(label: RosterRow['label']): ScoreTone;
-export declare function scoreToneKey(label: RosterRow['label']): Tone;
-/** The short word for a label in the roster's tag column; `NORMAL` says nothing. */
-export declare function labelTag(label: RosterRow['label']): string;
-/** Scored agents start here; the gauge is full at this value. */
-export declare const GAUGE_FULL_SCORE: 100;
-export declare const GAUGE_CELLS = 10;
-/**
- * Filled cells of the 10-cell score gauge: `round(confirmed / 100 * 10)` clamped to
- * [0, 10] (spec 10.3). Non-finite input draws an empty bar rather than throwing - the
- * gauge is decoration over a number that is printed beside it.
- */
-export declare function gaugeFilledCells(confirmed: number): number;
-/** `115+` when the score is over the starting value, otherwise the plain number. */
-export declare function scoreText(confirmed: number): string;
-/** How long a score change stays emphasised on its row. */
-export declare const DELTA_EMPHASIS_MS = 4000;
-export interface DeltaCell {
-    /** `+10` / `-20`, or '' when the row has nothing to say. */
-    text: string;
-    tone: Tone;
-    bold: boolean;
-}
-/** Signed delta text; a provisional gain carries the `P` suffix (`+15P`). */
-export declare function signedDeltaText(delta: number, provisional: boolean): string;
-/**
- * The emphasised delta of a row.
- *
- * Motion allowed: bold + coloured for `DELTA_EMPHASIS_MS` after the change, then gone.
- * Reduced motion: nothing is time-windowed, so nothing flashes - the delta stays, plain,
- * until the engine replaces or clears `lastDelta` at the next phase (spec 10.3 "the
- * increment text is kept until the next phase"). A zero delta says nothing in either mode.
- */
-export declare function deltaCell(row: RosterRow, now: number, reducedMotion: boolean): DeltaCell;
-/** The display modes of the legion panel (spec 10.3 mount rules). */
-export type GovernancePanelMode = 'none' | 'run-strip' | 'panel';
-/**
- * Mount rule (D-17): a running stage -> the full panel (which REPLACES the team roster);
- * a live run between stages -> the two-line strip; no run, a closed run or an abandoned
- * run -> nothing at all (zero rows, zero layout shift).
- */
-export declare function governancePanelMode(snapshot: GovernanceSnapshot | null): GovernancePanelMode;
-/** Which component owns the bottom transient region's live roster. */
-export type LiveRosterSurface = 'governance' | 'team' | 'none';
-/**
- * EXACTLY ONE LIVE ROSTER (D-17 / AC-25). A running governed stage owns the region even
- * though the same children are also in `state.team` (the reducer still writes it for
- * `/agents`); between stages the two-line strip shows only when no dispatch is live; with
- * no live governed run the team roster behaves exactly as it always did.
- */
-export declare function liveRosterSurface(snapshot: GovernanceSnapshot | null, teamLive: boolean): LiveRosterSurface;
-export declare function isFinishedRun(status: RunStatus): boolean;
-/** Agents currently doing something: the minimal tier's "4 working". */
-export declare function workingCount(snapshot: GovernanceSnapshot): number;
-/** Display position in the pipeline: the active step's key, or the stage, or null. */
-export declare function activeStepKey(snapshot: GovernanceSnapshot): StageKind | null;
-/** Tokens spent by the governed team (spec 8.5: team tokens, never the session total). */
-export declare function teamTokens(snapshot: GovernanceSnapshot): number;
-/**
- * Budget readout for the chip's `$` hint: 'none' without a budget, 'warn' from 80%,
- * 'over' from 100% (spec 8.5). Only budgets > 0 are budgets.
- */
-export declare function budgetState(snapshot: GovernanceSnapshot): 'none' | 'ok' | 'warn' | 'over';
-/** Short run id for the header: the last five alphanumerics, so ids that share a prefix differ. */
-export declare function shortRunId(runId: string): string;
-/** Phase at which each eliminated id was FIRST seen eliminated. */
-export type EliminatedSince = Readonly<Record<string, number>>;
-/**
- * Fold a snapshot into the first-seen-eliminated map.
- *
- * WHY THE PANEL KEEPS THIS ITSELF: `RosterRow` carries no "eliminated in phase N" field,
- * and the board still needs the full roster from the same snapshot, so the engine cannot
- * simply drop the row. A member that disappears from the map's keys (never happens) or
- * that was never seen eliminated is treated as "eliminated now" by `isRetired`. Returns
- * the SAME object when nothing changed so React memo / ref comparisons stay cheap.
- */
-export declare function trackEliminated(previous: EliminatedSince, snapshot: GovernanceSnapshot): EliminatedSince;
-/**
- * True when an eliminated member's one visible phase is over: it was first seen in an
- * earlier phase than the one now displayed.
- */
-export declare function isRetired(row: RosterRow, phase: number, since: EliminatedSince): boolean;
-/**
- * Roster order: DEV -> REV -> TEST -> INSP, active members before eliminated ones, then
- * by generation and id so `dev2` precedes its successor `dev2-r1` and the order is total
- * (a stable roster does not reshuffle between snapshots).
- */
-export declare function sortRoster(roster: readonly RosterRow[]): RosterRow[];
-/**
- * `PLAN+GOVERN  interview round 2/2+` while rounds are still owed, and `... 2/2 OK` once
- * the minimum is met (governance-mode 10.6). The trailing `+` reads "at least this many":
- * the model may ask more rounds than the minimum.
- */
-export declare function interviewChipText(round: number, required: number): string;
-/**
- * A `/gov pause` is waiting for the running stage to finish (governance-mode-v1-1 6.4).
- * Only meaningful while the run is still `executing`: once it is `paused` the request has
- * been redeemed, and an `escalated` run drops it.
- */
-export declare function isPausePending(snapshot: GovernanceSnapshot): boolean;
-/** True for the two governed postures, given a mode OR posture value as a string. */
-export declare function isGovernedModeValue(value: string | null | undefined): boolean;
-/**
- * The status row's word for a mode OR a posture. `MODE_LABEL` answers for `build` /
- * `plan` (so the byte-identical pre-governance output is preserved); the two governed
- * postures are the only values that reach the second table.
- *
- * Short form: the first letter, except `plan_govern` which is `PG` - `P` is already PLAN
- * and a status row that cannot tell them apart has defeated the badge.
- */
-export declare function modeWord(value: string, full: boolean): string | undefined;