chief-helm 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+/**
+ * @file HELM CLI entry point.
+ *
+ * Responsibilities:
+ *   1. Startup checks — Node version ≥ 20, git in PATH — before any
+ *      command executes. Failures here produce clear errors and exit 1.
+ *   2. Commander program setup — version, description, global error handling.
+ *   3. Command registration — one call per command module.
+ *   4. Global error handler — catches HelmError and unexpected errors from
+ *      all command actions, formats them consistently, and exits 1.
+ *
+ * All command modules export a register[Name]Command(program) function
+ * and are responsible for their own subcommands, options, and actions.
+ *
+ * This file contains no business logic. It wires together the application.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;GAeG"}

package/dist/index.js

@@ -0,0 +1,163 @@
+#!/usr/bin/env node
+/**
+ * @file HELM CLI entry point.
+ *
+ * Responsibilities:
+ *   1. Startup checks — Node version ≥ 20, git in PATH — before any
+ *      command executes. Failures here produce clear errors and exit 1.
+ *   2. Commander program setup — version, description, global error handling.
+ *   3. Command registration — one call per command module.
+ *   4. Global error handler — catches HelmError and unexpected errors from
+ *      all command actions, formats them consistently, and exits 1.
+ *
+ * All command modules export a register[Name]Command(program) function
+ * and are responsible for their own subcommands, options, and actions.
+ *
+ * This file contains no business logic. It wires together the application.
+ */
+import { Command } from "commander";
+import chalk from "chalk";
+import { isGitAvailable } from "./core/git.js";
+import { HelmError, formatHelmError, formatUnexpectedError } from "./utils/errors.js";
+import { theme } from "./ui/theme.js";
+import { registerSetupCommand } from "./commands/setup.js";
+import { registerStatusCommand } from "./commands/status.js";
+import { registerSecretsCommand } from "./commands/secrets.js";
+import { registerSyncCommand } from "./commands/sync.js";
+import { registerPushCommand } from "./commands/push.js";
+import { registerInputsCommand } from "./commands/inputs.js";
+import { registerConfigCommand } from "./commands/config.js";
+// ─── Startup Checks ───────────────────────────────────────────────────────────
+/**
+ * Validates that the current Node.js runtime meets the minimum version
+ * requirement of v20. Exits with a clear error if it does not.
+ *
+ * Must be called before Commander parses any arguments so the check
+ * fires even on `helm --version` invocations on incompatible runtimes.
+ */
+function checkNodeVersion() {
+    const versionStr = process.versions.node;
+    const major = parseInt(versionStr.split(".")[0] ?? "0", 10);
+    if (major < 20) {
+        console.error(chalk.hex(theme.error)(`✗ Error: Node.js v${versionStr} is not supported.\n` +
+            `  → Install Node.js v20 or later from https://nodejs.org`));
+        process.exit(1);
+    }
+}
+/**
+ * Validates that `git` is available in PATH. Exits with a clear error
+ * if it is not found. Must complete before any command runs.
+ */
+async function checkGitAvailable() {
+    const available = await isGitAvailable();
+    if (!available) {
+        console.error(chalk.hex(theme.error)("✗ Error: git is not available in PATH.\n" +
+            "  → macOS: git is pre-installed, or install via Homebrew: brew install git\n" +
+            "  → Windows: download from https://git-scm.com"));
+        process.exit(1);
+    }
+}
+// ─── Error Handler ────────────────────────────────────────────────────────────
+/**
+ * Wraps an async command action so that HelmErrors and unexpected errors
+ * are both caught, formatted consistently, and cause a clean exit(1)
+ * rather than an unhandled promise rejection.
+ *
+ * All command actions must be wrapped with this function.
+ *
+ * @param fn - The async command action to wrap.
+ */
+function action(fn) {
+    return async (...args) => {
+        try {
+            await fn(...args);
+        }
+        catch (err) {
+            if (err instanceof HelmError) {
+                console.error(chalk.hex(theme.error)(formatHelmError(err)));
+            }
+            else {
+                console.error(chalk.hex(theme.error)(formatUnexpectedError(err)));
+            }
+            process.exit(1);
+        }
+    };
+}
+// ─── Program ──────────────────────────────────────────────────────────────────
+const program = new Command();
+program
+    .name("helm")
+    .description("CHIEF — Personal AI Operations System CLI")
+    .version("0.1.0", "-v, --version", "Print version number")
+    .helpOption("-h, --help", "Show help");
+// Commander does not propagate async action errors by default.
+// exitOverride turns Commander exceptions into thrown errors so our
+// try/catch in action() can handle them uniformly.
+program.exitOverride();
+// ─── Command Registration ─────────────────────────────────────────────────────
+registerSetupCommand(program);
+registerStatusCommand(program);
+registerSecretsCommand(program);
+registerSyncCommand(program);
+registerPushCommand(program);
+registerInputsCommand(program);
+registerConfigCommand(program);
+// ─── Placeholder Stubs for Phase 2 / 3 Commands ─────────────────────────────
+// These prevent "unknown command" errors if a user tries a Phase 2 command
+// and surface a clear "not yet available" message instead.
+for (const name of [
+    "run",
+    "sweep",
+    "block",
+    "agents",
+    "flows",
+    "triggers",
+    "docs",
+    "logs",
+    "outputs",
+    "tune",
+]) {
+    program
+        .command(name, { hidden: true })
+        .allowUnknownOption(true)
+        .action(() => {
+        console.log(chalk.hex(theme.muted)(`  helm ${name} is not available in this version (Phase 1).\n` +
+            `  It will be added in a future release.`));
+        process.exit(1);
+    });
+}
+// ─── Bootstrap ────────────────────────────────────────────────────────────────
+/**
+ * Main entry point. Runs startup checks then delegates to Commander.
+ */
+async function main() {
+    checkNodeVersion();
+    await checkGitAvailable();
+    try {
+        await program.parseAsync(process.argv);
+    }
+    catch (err) {
+        // Commander throws CommanderError on --help, --version, and exitOverride.
+        // These are normal control-flow exits — do not treat as failures.
+        if (err instanceof Error &&
+            "code" in err &&
+            typeof err.code === "string" &&
+            err.code.startsWith("commander.")) {
+            const code = err.code;
+            // commander.helpDisplayed and commander.version are clean exits.
+            if (code === "commander.helpDisplayed" || code === "commander.version") {
+                process.exit(0);
+            }
+            // commander.unknownCommand and others are user errors.
+            process.exit(1);
+        }
+        // Unhandled error outside a command action.
+        console.error(chalk.hex(theme.error)(formatUnexpectedError(err)));
+        process.exit(1);
+    }
+}
+main().catch((err) => {
+    console.error(chalk.hex(theme.error)(formatUnexpectedError(err)));
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -0,0 +1,210 @@
+/**
+ * @file Shared TypeScript types and interfaces for HELM.
+ *
+ * This is the single source of truth for all data shapes used across
+ * the CLI. Types map directly to the YAML schemas in the user's
+ * personal instance repo under /config/ and to local machine state
+ * at ~/.chief/config.json.
+ */
+/**
+ * A single external data source integration (Gmail, Todoist, etc.).
+ * Persisted in config/inputs.yaml in the instance repo.
+ */
+export interface Input {
+    /** Unique machine identifier, e.g. "gmail". */
+    id: string;
+    /** Human-readable display label. */
+    label: string;
+    /** Whether this input participates in flow runs. */
+    enabled: boolean;
+    /**
+     * Whether credentials have been stored and the last connectivity
+     * test passed. Set to true by HELM after a successful test.
+     */
+    configured: boolean;
+    /** OAuth scopes or permission strings required by this input. */
+    scope?: string[];
+    /** Short text shown during helm setup to guide credential collection. */
+    setup_guide: string;
+    /**
+     * Primary secret key name for this input (used as a human-readable
+     * reference only). All required key names are defined in
+     * INPUT_CREDENTIAL_KEYS in core/inputs.ts.
+     */
+    credentials_ref: string;
+}
+/**
+ * An AI agent definition.
+ * Persisted in config/agents.yaml in the instance repo.
+ */
+export interface Agent {
+    /** Unique machine identifier, e.g. "email_drafter". */
+    id: string;
+    /** Human-readable display label. */
+    label: string;
+    /** Whether this agent is active and will be invoked during flow runs. */
+    enabled: boolean;
+    /** Repo-relative path to the agent's instruction markdown file. */
+    instruction_file: string;
+    /** IDs of Input entries this agent depends on. */
+    inputs: string[];
+    /** Semantic keys describing what this agent produces. */
+    outputs: string[];
+    /** Context document keys to include in this agent's context package. */
+    context_keys: string[];
+    /**
+     * Non-overridable behavioural constraints for this agent.
+     * Values may be boolean flags or numeric limits.
+     */
+    hard_limits?: Record<string, boolean | number>;
+}
+/**
+ * A named process flow that orchestrates one or more agents.
+ * Persisted in config/flows.yaml in the instance repo.
+ */
+export interface Flow {
+    /** Unique machine identifier, e.g. "am-sweep". */
+    id: string;
+    /** Human-readable display label. */
+    label: string;
+    /** Whether this flow can be triggered. */
+    enabled: boolean;
+    /** Repo-relative path to the flow's instruction markdown file. */
+    instruction_file: string;
+    /** Ordered list of Agent IDs to run in this flow. */
+    agents: string[];
+    /** Input IDs that must be configured before this flow can run. */
+    inputs_required: string[];
+    /** Whether to pause for human review before dispatching agents. */
+    human_gate_before_agents: boolean;
+    /** Whether agents run concurrently rather than sequentially. */
+    parallel?: boolean;
+    /**
+     * Key used to prevent duplicate runs within a single calendar day.
+     * When set, HELM checks processed_ids.json before executing.
+     */
+    idempotency_key?: string;
+}
+/**
+ * A scheduled or manual invocation entry point for a flow.
+ * Persisted in config/triggers.yaml in the instance repo.
+ */
+export interface Trigger {
+    /** Unique machine identifier. */
+    id: string;
+    /** Human-readable display label. */
+    label: string;
+    /** Whether this trigger is active. */
+    enabled: boolean;
+    /** How this trigger fires. */
+    type: "scheduled" | "manual";
+    /** Cron expression (required when type is "scheduled"). */
+    schedule?: string;
+    /** Where the scheduled job runs. Railway schedules are managed externally. */
+    platform?: "railway" | "local";
+    /** CLI command or URL used to invoke this trigger externally. */
+    invocation?: string;
+    /** ID of the Flow this trigger activates. */
+    flow: string;
+    /** Whether a human approval gate is required before agents run. */
+    human_gate: boolean;
+}
+/**
+ * Top-level system settings.
+ * Persisted in config/system.yaml in the instance repo.
+ */
+export interface SystemConfig {
+    /** Schema version for this config file. */
+    version: string;
+    /** Username of the active user on this instance. */
+    active_user: string;
+}
+/**
+ * Orchestration engine configuration.
+ * Persisted in config/engine.yaml in the instance repo.
+ */
+export interface EngineConfig {
+    /**
+     * Engine implementation identifier.
+     * Only "claude-code" is supported in Phase 1.
+     */
+    engine: "claude-code" | "anthropic-api";
+    /** Shell command used to invoke the engine (e.g. "claude"). */
+    command: string;
+    /** Hard timeout in seconds before an agent run is killed. */
+    timeout_seconds: number;
+    /**
+     * Model identifier passed to the engine.
+     * Required when engine is "anthropic-api".
+     */
+    model?: string;
+}
+/**
+ * Machine-local configuration stored at ~/.chief/config.json.
+ * Never committed to git. Managed by the conf package.
+ */
+export interface LocalConfig {
+    /** Absolute path to the user's personal CHIEF instance repo. */
+    instance_repo_path: string;
+    /** Username active on this machine (matches /users/[username]/ in the repo). */
+    active_user: string;
+    /** Shell command used to open files in the user's preferred editor. */
+    editor: string;
+    /** True only after helm setup completes including a successful git push. */
+    setup_complete: boolean;
+    /** ISO 8601 timestamp of the last successful helm sync. */
+    last_sync: string;
+    /**
+     * List of secret key names stored in the OS keychain for this machine.
+     * Format: "[username]/[KEY_NAME]". Values are never stored here — only names.
+     * This manifest exists because the OS keychain API does not support enumeration.
+     */
+    secrets_manifest: string[];
+}
+/**
+ * A single flow's last execution record.
+ */
+export interface LastRunRecord {
+    /** ISO 8601 timestamp of the last execution. */
+    timestamp: string;
+    /** Terminal status of the last run. */
+    status: "success" | "failed";
+}
+/**
+ * Contents of state/[username]/last_run.json.
+ * Keys are flow IDs.
+ */
+export type LastRunState = Record<string, LastRunRecord>;
+/**
+ * Result of an input connectivity test.
+ */
+export interface InputTestResult {
+    /** Input ID that was tested. */
+    inputId: string;
+    /** Whether the test call succeeded. */
+    ok: boolean;
+    /**
+     * Human-readable detail returned by the test (e.g. email address, count).
+     * Only populated on success.
+     */
+    detail?: string;
+    /**
+     * Error description on failure.
+     * Never contains secret values.
+     */
+    error?: string;
+    /**
+     * Specific remediation instruction shown to the user on failure.
+     */
+    fix?: string;
+}
+/**
+ * Git repository status summary used by helm status and helm sync.
+ */
+export interface RepoStatus {
+    /** Whether the working tree has no uncommitted changes. */
+    clean: boolean;
+    /** Number of modified, added, or deleted files when not clean. */
+    fileCount: number;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/types/index.js

@@ -0,0 +1,10 @@
+/**
+ * @file Shared TypeScript types and interfaces for HELM.
+ *
+ * This is the single source of truth for all data shapes used across
+ * the CLI. Types map directly to the YAML schemas in the user's
+ * personal instance repo under /config/ and to local machine state
+ * at ~/.chief/config.json.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/ui/components/Header.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @file Header Ink component.
+ *
+ * Renders the top chrome bar used in all interactive HELM panels.
+ * Format: CHIEF  ·  [SCREEN]  ·  [username]  ·  [context]
+ *
+ * Context is optional. When omitted, the trailing separator and segment
+ * are not rendered so the header does not end with a dangling "·".
+ *
+ * Used in Phase 2 interactive views (HumanGate, AgentProgress).
+ * Phase 1 static commands (helm status) render equivalent chrome
+ * inline using chalk + box-drawing helpers.
+ */
+import React from "react";
+/** Props for the Header component. */
+export interface HeaderProps {
+    /** Screen name displayed in the second segment, e.g. "STATUS". */
+    screen: string;
+    /** Active username displayed in the third segment. */
+    username: string;
+    /** Optional contextual label for the fourth segment (flow id, date, etc.). */
+    context?: string;
+}
+/**
+ * Top-level header bar following the CHIEF visual design system.
+ *
+ * All text segments are separated by the design system bullet character.
+ * The "CHIEF" prefix is always bold. The screen name uses the accent
+ * colour to draw the eye. Username and context use the muted colour.
+ */
+export declare function Header({ screen, username, context }: HeaderProps): React.ReactElement;
+//# sourceMappingURL=Header.d.ts.map

package/dist/ui/components/Header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Header.d.ts","sourceRoot":"","sources":["../../../src/ui/components/Header.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,sCAAsC;AACtC,MAAM,WAAW,WAAW;IAC1B,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,WAAW,GAAG,KAAK,CAAC,YAAY,CAwBrF"}

package/dist/ui/components/Header.js

@@ -0,0 +1,15 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { theme, symbol } from "../theme.js";
+/**
+ * Top-level header bar following the CHIEF visual design system.
+ *
+ * All text segments are separated by the design system bullet character.
+ * The "CHIEF" prefix is always bold. The screen name uses the accent
+ * colour to draw the eye. Username and context use the muted colour.
+ */
+export function Header({ screen, username, context }) {
+    const sep = (_jsx(Text, { color: theme.border, children: "  " + symbol.bullet + "  " }));
+    return (_jsxs(Box, { children: [_jsx(Text, { bold: true, color: theme.text, children: "CHIEF" }), sep, _jsx(Text, { bold: true, color: theme.accent, children: screen }), sep, _jsx(Text, { color: theme.muted, children: username }), context !== undefined && (_jsxs(_Fragment, { children: [sep, _jsx(Text, { color: theme.muted, children: context })] }))] }));
+}
+//# sourceMappingURL=Header.js.map

package/dist/ui/components/Header.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Header.js","sourceRoot":"","sources":["../../../src/ui/components/Header.tsx"],"names":[],"mappings":";AAeA,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAY5C;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAe;IAC/D,MAAM,GAAG,GAAG,CACV,KAAC,IAAI,IAAC,KAAK,EAAE,KAAK,CAAC,MAAM,YAAG,IAAI,GAAG,MAAM,CAAC,MAAM,GAAG,IAAI,GAAQ,CAChE,CAAC;IAEF,OAAO,CACL,MAAC,GAAG,eACF,KAAC,IAAI,IAAC,IAAI,QAAC,KAAK,EAAE,KAAK,CAAC,IAAI,sBAErB,EACN,GAAG,EACJ,KAAC,IAAI,IAAC,IAAI,QAAC,KAAK,EAAE,KAAK,CAAC,MAAM,YAC3B,MAAM,GACF,EACN,GAAG,EACJ,KAAC,IAAI,IAAC,KAAK,EAAE,KAAK,CAAC,KAAK,YAAG,QAAQ,GAAQ,EAC1C,OAAO,KAAK,SAAS,IAAI,CACxB,8BACG,GAAG,EACJ,KAAC,IAAI,IAAC,KAAK,EAAE,KAAK,CAAC,KAAK,YAAG,OAAO,GAAQ,IACzC,CACJ,IACG,CACP,CAAC;AACJ,CAAC"}

package/dist/ui/components/Panel.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @file Panel Ink component.
+ *
+ * A bordered container that wraps content in the CHIEF single-border
+ * style. All interactive HELM views (HumanGate, AgentProgress,
+ * CompletionReport) are composed inside a Panel.
+ *
+ * Used in Phase 2 interactive views.
+ */
+import React from "react";
+/** Props for the Panel component. */
+export interface PanelProps {
+    /** Content to render inside the bordered container. */
+    children: React.ReactNode;
+    /**
+     * Total column width of the panel including borders.
+     * Defaults to 62 columns to match the Phase 1 static panel width.
+     */
+    width?: number;
+}
+/**
+ * Bordered panel container using the CHIEF border colour.
+ *
+ * Uses Ink's built-in borderStyle so that the single-line box
+ * characters are rendered correctly across all supported terminals.
+ * Horizontal padding of 1 column is applied inside the border on
+ * each side.
+ */
+export declare function Panel({ children, width }: PanelProps): React.ReactElement;
+//# sourceMappingURL=Panel.d.ts.map

package/dist/ui/components/Panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Panel.d.ts","sourceRoot":"","sources":["../../../src/ui/components/Panel.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,qCAAqC;AACrC,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,EAAE,QAAQ,EAAE,KAAU,EAAE,EAAE,UAAU,GAAG,KAAK,CAAC,YAAY,CAY9E"}

package/dist/ui/components/Panel.js

@@ -0,0 +1,15 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Box } from "ink";
+import { theme } from "../theme.js";
+/**
+ * Bordered panel container using the CHIEF border colour.
+ *
+ * Uses Ink's built-in borderStyle so that the single-line box
+ * characters are rendered correctly across all supported terminals.
+ * Horizontal padding of 1 column is applied inside the border on
+ * each side.
+ */
+export function Panel({ children, width = 62 }) {
+    return (_jsx(Box, { borderStyle: "single", borderColor: theme.border, width: width, flexDirection: "column", paddingX: 1, children: children }));
+}
+//# sourceMappingURL=Panel.js.map

package/dist/ui/components/Panel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Panel.js","sourceRoot":"","sources":["../../../src/ui/components/Panel.tsx"],"names":[],"mappings":";AAWA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAC1B,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAapC;;;;;;;GAOG;AACH,MAAM,UAAU,KAAK,CAAC,EAAE,QAAQ,EAAE,KAAK,GAAG,EAAE,EAAc;IACxD,OAAO,CACL,KAAC,GAAG,IACF,WAAW,EAAC,QAAQ,EACpB,WAAW,EAAE,KAAK,CAAC,MAAM,EACzB,KAAK,EAAE,KAAK,EACZ,aAAa,EAAC,QAAQ,EACtB,QAAQ,EAAE,CAAC,YAEV,QAAQ,GACL,CACP,CAAC;AACJ,CAAC"}

package/dist/ui/components/StatusRow.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @file StatusRow Ink component.
+ *
+ * A single horizontal row displaying a status symbol, a label, and an
+ * optional detail string. Used inside Panel to build list-style sections
+ * in interactive views (agent progress, completion reports).
+ *
+ * The four status variants map directly to the CHIEF design system
+ * symbol and colour conventions defined in theme.ts.
+ */
+import React from "react";
+/** The four supported visual states for a status row. */
+export type StatusVariant = "success" | "error" | "warning" | "disabled";
+/** Props for the StatusRow component. */
+export interface StatusRowProps {
+    /** Text label identifying the item (agent name, input name, etc.). */
+    label: string;
+    /** Visual variant that determines the symbol and colour. */
+    status: StatusVariant;
+    /**
+     * Optional secondary text shown after the label.
+     * Rendered in the muted colour (e.g. "connected", "12s", "drafting…").
+     */
+    detail?: string;
+    /**
+     * Fixed width for the label column in characters.
+     * Defaults to 22 to align detail text across rows in a list.
+     */
+    labelWidth?: number;
+}
+/**
+ * Renders a single status row with a leading symbol, a fixed-width
+ * label column, and an optional trailing detail string.
+ *
+ * Label padding is applied in the Text content rather than via Ink
+ * layout so the row renders correctly even in narrow terminals.
+ */
+export declare function StatusRow({ label, status, detail, labelWidth, }: StatusRowProps): React.ReactElement;
+//# sourceMappingURL=StatusRow.d.ts.map

package/dist/ui/components/StatusRow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatusRow.d.ts","sourceRoot":"","sources":["../../../src/ui/components/StatusRow.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,yDAAyD;AACzD,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;AAEzE,yCAAyC;AACzC,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,MAAM,EAAE,aAAa,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAgBD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,MAAM,EACN,MAAM,EACN,UAAe,GAChB,EAAE,cAAc,GAAG,KAAK,CAAC,YAAY,CAarC"}

package/dist/ui/components/StatusRow.js

@@ -0,0 +1,27 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { theme, symbol } from "../theme.js";
+const SYMBOLS = {
+    success: symbol.success,
+    error: symbol.error,
+    warning: symbol.warning,
+    disabled: symbol.disabled,
+};
+const COLORS = {
+    success: theme.success,
+    error: theme.error,
+    warning: theme.warning,
+    disabled: theme.skip,
+};
+/**
+ * Renders a single status row with a leading symbol, a fixed-width
+ * label column, and an optional trailing detail string.
+ *
+ * Label padding is applied in the Text content rather than via Ink
+ * layout so the row renders correctly even in narrow terminals.
+ */
+export function StatusRow({ label, status, detail, labelWidth = 22, }) {
+    const paddedLabel = label.padEnd(labelWidth);
+    return (_jsxs(Box, { children: [_jsx(Text, { color: COLORS[status], children: SYMBOLS[status] }), _jsx(Text, { children: " " }), _jsx(Text, { color: theme.text, children: paddedLabel }), detail !== undefined && (_jsx(Text, { color: theme.muted, children: detail }))] }));
+}
+//# sourceMappingURL=StatusRow.js.map

package/dist/ui/components/StatusRow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatusRow.js","sourceRoot":"","sources":["../../../src/ui/components/StatusRow.tsx"],"names":[],"mappings":";AAYA,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAuB5C,MAAM,OAAO,GAAkC;IAC7C,OAAO,EAAE,MAAM,CAAC,OAAO;IACvB,KAAK,EAAE,MAAM,CAAC,KAAK;IACnB,OAAO,EAAE,MAAM,CAAC,OAAO;IACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;CAC1B,CAAC;AAEF,MAAM,MAAM,GAAkC;IAC5C,OAAO,EAAE,KAAK,CAAC,OAAO;IACtB,KAAK,EAAE,KAAK,CAAC,KAAK;IAClB,OAAO,EAAE,KAAK,CAAC,OAAO;IACtB,QAAQ,EAAE,KAAK,CAAC,IAAI;CACrB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,EACxB,KAAK,EACL,MAAM,EACN,MAAM,EACN,UAAU,GAAG,EAAE,GACA;IACf,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAE7C,OAAO,CACL,MAAC,GAAG,eACF,KAAC,IAAI,IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,YAAG,OAAO,CAAC,MAAM,CAAC,GAAQ,EACrD,KAAC,IAAI,oBAAS,EACd,KAAC,IAAI,IAAC,KAAK,EAAE,KAAK,CAAC,IAAI,YAAG,WAAW,GAAQ,EAC5C,MAAM,KAAK,SAAS,IAAI,CACvB,KAAC,IAAI,IAAC,KAAK,EAAE,KAAK,CAAC,KAAK,YAAG,MAAM,GAAQ,CAC1C,IACG,CACP,CAAC;AACJ,CAAC"}