myshell-tools 1.0.0 → 2.0.0

package/dist/providers/errors.js

@@ -0,0 +1,189 @@
+/**
+ * errors.ts — Error types, classification, backoff calculation, and message
+ * formatting for provider CLI operations.
+ *
+ * Pure module: no child_process, no fs, no console.log. All functions return
+ * data; callers decide how to display or act on it.
+ */
+/**
+ * Calculate how long to wait before the next retry attempt.
+ *
+ * Returns a value in milliseconds. With jitter the actual value will be within
+ * `[(1 - jitter) * delay, (1 + jitter) * delay]` where `delay` is the pure
+ * exponential value capped at `maxMs`.
+ *
+ * @param attempt - Zero-based attempt index (0 = first retry).
+ */
+export function calculateBackoff(attempt, opts) {
+    const baseMs = opts?.baseMs ?? 1000;
+    const multiplier = opts?.multiplier ?? 2;
+    const maxMs = opts?.maxMs ?? 30_000;
+    const jitter = opts?.jitter ?? 0.15;
+    const exponential = Math.min(baseMs * multiplier ** attempt, maxMs);
+    const spread = exponential * jitter;
+    // Random value in [-spread, +spread]
+    const noise = (Math.random() * 2 - 1) * spread;
+    return Math.round(Math.max(0, exponential + noise));
+}
+// ---------------------------------------------------------------------------
+// Internal pattern helpers
+// ---------------------------------------------------------------------------
+function includesAny(text, patterns) {
+    return patterns.some((p) => text.includes(p));
+}
+function isAuthStderr(lower) {
+    // token-related matches require a companion word to avoid false positives
+    const tokenExpired = lower.includes('token') && (lower.includes('expired') || lower.includes('invalid'));
+    return (tokenExpired ||
+        includesAny(lower, [
+            'authentication',
+            'unauthorized',
+            '401',
+            'invalid credentials',
+            'login required',
+        ]));
+}
+function isRateLimitStderr(lower) {
+    const quotaExceeded = lower.includes('quota') && lower.includes('exceeded');
+    return (quotaExceeded || includesAny(lower, ['rate limit', '429', 'too many requests']));
+}
+function isTimeoutStderr(lower) {
+    // Exclude HTTP gateway codes (502/503/504) — those are network errors even
+    // though '504 Gateway Timeout' contains the word 'timeout'.
+    if (includesAny(lower, ['502', '503', '504']))
+        return false;
+    return includesAny(lower, ['timeout', 'timed out', 'deadline exceeded']);
+}
+function isNetworkStderr(lower) {
+    return includesAny(lower, [
+        'network',
+        'enotfound',
+        'econnreset',
+        'econnrefused',
+        'enetunreach',
+        '502',
+        '503',
+        '504',
+        'internal server error',
+    ]);
+}
+function isModelStderr(lower) {
+    return includesAny(lower, [
+        'model not found',
+        'model does not exist',
+        'unsupported model',
+        'invalid model',
+        'context length',
+        'context window',
+    ]);
+}
+function isPermissionStderr(lower, exitCode) {
+    return (exitCode === 126 ||
+        includesAny(lower, [
+            'permission denied',
+            'access denied',
+            'forbidden',
+            '403',
+        ]));
+}
+// ---------------------------------------------------------------------------
+// Per-category error descriptors
+// ---------------------------------------------------------------------------
+const CATEGORY_DESCRIPTORS = {
+    auth: {
+        recoverable: false,
+        message: 'Authentication failed.',
+        suggestion: 'Re-authenticate with the CLI (e.g. `claude auth login` or `codex login`) and try again.',
+    },
+    'rate-limit': {
+        recoverable: true,
+        message: 'Rate limit or quota exceeded.',
+        suggestion: 'Wait before retrying. Consider using a different model tier or reducing request frequency.',
+    },
+    timeout: {
+        recoverable: true,
+        message: 'The request timed out.',
+        suggestion: 'Simplify the request or increase the timeout threshold and retry.',
+    },
+    network: {
+        recoverable: true,
+        message: 'A network or server connectivity error occurred.',
+        suggestion: 'Check your internet connection. The server may be temporarily unavailable.',
+    },
+    model: {
+        recoverable: false,
+        message: 'The requested model is unavailable or the context limit was exceeded.',
+        suggestion: 'Verify the model name is correct, or shorten the input to fit within the context window.',
+    },
+    permission: {
+        recoverable: false,
+        message: 'Permission or access denied.',
+        suggestion: 'Verify your account has access to the requested resource or operation.',
+    },
+    unknown: {
+        recoverable: false,
+        message: 'An unexpected error occurred.',
+        suggestion: 'Review the stderr output for details. If the problem persists, report it with the full error text.',
+    },
+};
+// ---------------------------------------------------------------------------
+// Public classification function
+// ---------------------------------------------------------------------------
+/**
+ * Classify a CLI failure into a structured {@link CliError}.
+ *
+ * @param stderr   - The stderr output from the CLI process (may be empty).
+ * @param exitCode - The numeric exit code of the process.
+ */
+export function classifyError(stderr, exitCode) {
+    const lower = stderr.toLowerCase();
+    let category;
+    if (isAuthStderr(lower)) {
+        category = 'auth';
+    }
+    else if (isRateLimitStderr(lower)) {
+        category = 'rate-limit';
+    }
+    else if (isTimeoutStderr(lower)) {
+        category = 'timeout';
+    }
+    else if (isNetworkStderr(lower)) {
+        category = 'network';
+    }
+    else if (isModelStderr(lower)) {
+        category = 'model';
+    }
+    else if (isPermissionStderr(lower, exitCode)) {
+        category = 'permission';
+    }
+    else {
+        category = 'unknown';
+    }
+    const descriptor = CATEGORY_DESCRIPTORS[category];
+    return {
+        category,
+        recoverable: descriptor.recoverable,
+        message: descriptor.message,
+        suggestion: descriptor.suggestion,
+    };
+}
+// ---------------------------------------------------------------------------
+// Friendly message formatting
+// ---------------------------------------------------------------------------
+/**
+ * Format a {@link CliError} into a human-readable string suitable for display.
+ * Does not include ANSI codes so it works in any context.
+ *
+ * @param error    - A classified CLI error.
+ * @param provider - Optional provider name for contextual detail (e.g. `'claude'`).
+ */
+export function formatErrorMessage(error, provider) {
+    const label = provider ? provider.toUpperCase() : 'CLI';
+    const lines = [`${label} Error [${error.category}]: ${error.message}`];
+    lines.push(`Suggestion: ${error.suggestion}`);
+    if (error.recoverable) {
+        lines.push('This error may be transient. Retrying with backoff is appropriate.');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=errors.js.map

package/dist/providers/errors.js.map

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

package/dist/providers/index.d.ts

@@ -0,0 +1,9 @@
+export { classifyError, calculateBackoff, formatErrorMessage } from './errors.js';
+export type { CliError, ErrorCategory, BackoffOptions } from './errors.js';
+export { detectProvider, detectEnvironment, getInstallCommand } from './detect.js';
+export type { ProviderStatus, EnvironmentStatus } from './detect.js';
+export type { Provider, ProviderEvent, ProviderRequest, Usage, SandboxLevel, ProviderId, } from './port.js';
+export { createClaudeProvider, toClaudeModelArg } from './claude.js';
+export { parseClaudeLine } from './claude-parse.js';
+export { createCodexProvider, toSandboxArg } from './codex.js';
+export { createCodexParser } from './codex-parse.js';

package/dist/providers/index.js

@@ -0,0 +1,7 @@
+export { classifyError, calculateBackoff, formatErrorMessage } from './errors.js';
+export { detectProvider, detectEnvironment, getInstallCommand } from './detect.js';
+export { createClaudeProvider, toClaudeModelArg } from './claude.js';
+export { parseClaudeLine } from './claude-parse.js';
+export { createCodexProvider, toSandboxArg } from './codex.js';
+export { createCodexParser } from './codex-parse.js';
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAElF,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAUnF,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/providers/port.d.ts

@@ -0,0 +1,74 @@
+/**
+ * src/providers/port.ts — the Provider port (the keystone interface).
+ *
+ * The orchestration core talks to this interface and nothing vendor-specific.
+ * Claude and Codex each ship an adapter that implements `Provider`.
+ *
+ * Design contract:
+ *  - `run()` returns an AsyncIterable so the UI can stream real tokens/tools as
+ *    they arrive and the core can compute real cost from the `usage` event.
+ *  - The prompt in `ProviderRequest` is delivered to the child process via STDIN
+ *    (never as a shell argument) — see spawn.ts.
+ *  - `model` is always a concrete model id (resolved from an alias before this
+ *    layer), never a tier name or alias.
+ */
+import type { CliError } from './errors.js';
+import type { ProviderStatus } from './detect.js';
+export type { CliError } from './errors.js';
+/** Privilege ladder mapped onto each CLI's sandbox flags. Default is workspace-write. */
+export type SandboxLevel = 'read-only' | 'workspace-write' | 'full-access';
+export type ProviderId = 'claude' | 'codex';
+export interface Usage {
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly cachedInputTokens?: number;
+}
+export interface ProviderRequest {
+    /** Concrete model id, e.g. 'claude-sonnet-4-6' (never an alias at this layer). */
+    readonly model: string;
+    /** The full prompt; delivered via STDIN, not argv. */
+    readonly prompt: string;
+    /** Working directory the model operates in. */
+    readonly cwd: string;
+    /** Privilege level for model-initiated actions. */
+    readonly sandbox: SandboxLevel;
+    /** Hard wall-clock timeout for the run. */
+    readonly timeoutMs: number;
+}
+/**
+ * Streaming events emitted by a provider run. Discriminated on `type`.
+ * The terminal event is exactly one of `done` or `error`.
+ */
+export type ProviderEvent = {
+    readonly type: 'text';
+    readonly delta: string;
+} | {
+    readonly type: 'reasoning';
+    readonly delta: string;
+} | {
+    readonly type: 'tool';
+    readonly name: string;
+    readonly phase: 'start' | 'end';
+    readonly detail?: string;
+} | {
+    readonly type: 'usage';
+    readonly usage: Usage;
+} | {
+    readonly type: 'done';
+    readonly text: string;
+    readonly usage?: Usage;
+    /** Cost in USD as reported by the provider CLI, when available (preferred
+     *  over estimating from the pricing table — it accounts for caching etc.). */
+    readonly costUsd?: number;
+    readonly raw: unknown;
+} | {
+    readonly type: 'error';
+    readonly error: CliError;
+};
+export interface Provider {
+    readonly id: ProviderId;
+    /** Probe install/auth/version/models. Cheap and cached by the adapter. */
+    detect(): Promise<ProviderStatus>;
+    /** Execute one request, streaming events until a terminal `done`/`error`. */
+    run(req: ProviderRequest, signal: AbortSignal): AsyncIterable<ProviderEvent>;
+}

package/dist/providers/port.js

@@ -0,0 +1,16 @@
+/**
+ * src/providers/port.ts — the Provider port (the keystone interface).
+ *
+ * The orchestration core talks to this interface and nothing vendor-specific.
+ * Claude and Codex each ship an adapter that implements `Provider`.
+ *
+ * Design contract:
+ *  - `run()` returns an AsyncIterable so the UI can stream real tokens/tools as
+ *    they arrive and the core can compute real cost from the `usage` event.
+ *  - The prompt in `ProviderRequest` is delivered to the child process via STDIN
+ *    (never as a shell argument) — see spawn.ts.
+ *  - `model` is always a concrete model id (resolved from an alias before this
+ *    layer), never a tier name or alias.
+ */
+export {};
+//# sourceMappingURL=port.js.map

package/dist/providers/port.js.map

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

package/dist/providers/registry.d.ts

@@ -0,0 +1,21 @@
+/**
+ * src/providers/registry.ts — provider registry for the CLI.
+ *
+ * Builds the Partial<Record<ProviderId, Provider>> map consumed by
+ * OrchestrateDeps. Each provider registers when `installed` is true — we gate
+ * on `installed`, NOT `authenticated`, because auth is only truly known at
+ * call time and errors render honestly via classifyError().
+ *
+ * With both Claude and Codex installed, `deps.providers` will have entries for
+ * both — which automatically activates cross-vendor review in the orchestrator.
+ */
+import type { Provider, ProviderId } from './port.js';
+/**
+ * Discover which providers are available in the current environment and build
+ * the provider map for OrchestrateDeps.
+ *
+ * @param _cwd - Working directory (used by real adapters to locate project-
+ *               level config; may be forwarded to adapters in a future phase).
+ * @returns     A (possibly empty) map of available providers.
+ */
+export declare function buildProviders(_cwd: string): Promise<Partial<Record<ProviderId, Provider>>>;

package/dist/providers/registry.js

@@ -0,0 +1,34 @@
+/**
+ * src/providers/registry.ts — provider registry for the CLI.
+ *
+ * Builds the Partial<Record<ProviderId, Provider>> map consumed by
+ * OrchestrateDeps. Each provider registers when `installed` is true — we gate
+ * on `installed`, NOT `authenticated`, because auth is only truly known at
+ * call time and errors render honestly via classifyError().
+ *
+ * With both Claude and Codex installed, `deps.providers` will have entries for
+ * both — which automatically activates cross-vendor review in the orchestrator.
+ */
+import { detectEnvironment } from './detect.js';
+import { createClaudeProvider } from './claude.js';
+import { createCodexProvider } from './codex.js';
+/**
+ * Discover which providers are available in the current environment and build
+ * the provider map for OrchestrateDeps.
+ *
+ * @param _cwd - Working directory (used by real adapters to locate project-
+ *               level config; may be forwarded to adapters in a future phase).
+ * @returns     A (possibly empty) map of available providers.
+ */
+export async function buildProviders(_cwd) {
+    const env = await detectEnvironment();
+    const providers = {};
+    if (env.claude.installed) {
+        providers.claude = createClaudeProvider();
+    }
+    if (env.codex.installed) {
+        providers.codex = createCodexProvider();
+    }
+    return providers;
+}
+//# sourceMappingURL=registry.js.map

package/dist/providers/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAY;IAEZ,MAAM,GAAG,GAAG,MAAM,iBAAiB,EAAE,CAAC;IACtC,MAAM,SAAS,GAA0C,EAAE,CAAC;IAE5D,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACzB,SAAS,CAAC,MAAM,GAAG,oBAAoB,EAAE,CAAC;IAC5C,CAAC;IAED,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QACxB,SAAS,CAAC,KAAK,GAAG,mBAAmB,EAAE,CAAC;IAC1C,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/ui/banner.d.ts

@@ -0,0 +1,19 @@
+/**
+ * src/ui/banner.ts — Compact product banner for myshell-tools-sh.
+ *
+ * Renders a tasteful multi-line banner showing the product name, real version,
+ * and a one-line tagline. The version is always supplied by the caller (no
+ * hardcoded value). No fake stats, no fabricated figures.
+ *
+ * Honesty Contract: this file contains no hardcoded percentages, no fabricated
+ * figures, and no mock phrases.
+ */
+/**
+ * Build a compact product banner string.
+ *
+ * @param version - The real semver string for this release (e.g. '1.2.3').
+ * @param color   - When false, no ANSI escape codes are emitted.
+ * @returns A multi-line banner string (does not end with a newline beyond the
+ *          last line so the caller controls spacing).
+ */
+export declare function banner(version: string, color: boolean): string;

package/dist/ui/banner.js

@@ -0,0 +1,32 @@
+/**
+ * src/ui/banner.ts — Compact product banner for myshell-tools-sh.
+ *
+ * Renders a tasteful multi-line banner showing the product name, real version,
+ * and a one-line tagline. The version is always supplied by the caller (no
+ * hardcoded value). No fake stats, no fabricated figures.
+ *
+ * Honesty Contract: this file contains no hardcoded percentages, no fabricated
+ * figures, and no mock phrases.
+ */
+import { bold, cyan, dim } from './theme.js';
+// ---------------------------------------------------------------------------
+// Banner
+// ---------------------------------------------------------------------------
+/**
+ * Build a compact product banner string.
+ *
+ * @param version - The real semver string for this release (e.g. '1.2.3').
+ * @param color   - When false, no ANSI escape codes are emitted.
+ * @returns A multi-line banner string (does not end with a newline beyond the
+ *          last line so the caller controls spacing).
+ */
+export function banner(version, color) {
+    const name = bold(cyan('myshell-tools', color), color);
+    const ver = dim(`v${version}`, color);
+    const tag = dim('AI task orchestrator — honest, tier-aware, streaming', color);
+    return [
+        `${name} ${ver}`,
+        tag,
+    ].join('\n');
+}
+//# sourceMappingURL=banner.js.map

package/dist/ui/banner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.js","sourceRoot":"","sources":["../../src/ui/banner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAE7C,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,UAAU,MAAM,CAAC,OAAe,EAAE,KAAc;IACpD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;IACvD,MAAM,GAAG,GAAI,GAAG,CAAC,IAAI,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC;IACvC,MAAM,GAAG,GAAI,GAAG,CAAC,sDAAsD,EAAE,KAAK,CAAC,CAAC;IAEhF,OAAO;QACL,GAAG,IAAI,IAAI,GAAG,EAAE;QAChB,GAAG;KACJ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/ui/spinner.d.ts

@@ -0,0 +1,27 @@
+/**
+ * src/ui/spinner.ts — Honest, indeterminate working indicator.
+ *
+ * Animates a braille-spinner frame while waiting for the first real output.
+ * No percentages, no fake progress — purely a "working" indicator.
+ * Frame cycling is deterministic (index-based); Math.random is never used.
+ *
+ * Honesty Contract: this file contains no hardcoded percentages, no fabricated
+ * figures, and no mock phrases.
+ */
+import type { OutputSink } from '../interface/render.js';
+/** A minimal working-indicator that can be started and stopped. */
+export interface Spinner {
+    /** Display the spinner with the given text. */
+    start(text: string): void;
+    /** Stop the spinner and clear the line (TTY) or do nothing (non-TTY). */
+    stop(): void;
+}
+/**
+ * Create a spinner bound to the given OutputSink.
+ *
+ * - When `out.isTty` is true: animates braille frames + text on the current
+ *   line using `\r`, driven by `setInterval`.
+ * - When `out.isTty` is false: prints the text once (static) and does nothing
+ *   on stop — safe for CI / pipe output.
+ */
+export declare function createSpinner(out: OutputSink): Spinner;

package/dist/ui/spinner.js

@@ -0,0 +1,67 @@
+/**
+ * src/ui/spinner.ts — Honest, indeterminate working indicator.
+ *
+ * Animates a braille-spinner frame while waiting for the first real output.
+ * No percentages, no fake progress — purely a "working" indicator.
+ * Frame cycling is deterministic (index-based); Math.random is never used.
+ *
+ * Honesty Contract: this file contains no hardcoded percentages, no fabricated
+ * figures, and no mock phrases.
+ */
+// ---------------------------------------------------------------------------
+// Frame set (braille dots — deterministic cycle, no Math.random)
+// ---------------------------------------------------------------------------
+const FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+const FRAME_INTERVAL_MS = 80;
+/**
+ * Create a spinner bound to the given OutputSink.
+ *
+ * - When `out.isTty` is true: animates braille frames + text on the current
+ *   line using `\r`, driven by `setInterval`.
+ * - When `out.isTty` is false: prints the text once (static) and does nothing
+ *   on stop — safe for CI / pipe output.
+ */
+export function createSpinner(out) {
+    let frameIndex = 0;
+    let timer = null;
+    let active = false;
+    /** Exposed for deterministic testing: advance one frame and write it. */
+    function tick(text) {
+        frameIndex = (frameIndex + 1) % FRAMES.length;
+        const frame = FRAMES[frameIndex] ?? FRAMES[0] ?? '⠋';
+        out.write(`\r${frame} ${text}`);
+    }
+    return {
+        start(text) {
+            if (active)
+                return;
+            active = true;
+            if (out.isTty) {
+                // Write the first frame immediately so there is no blank gap.
+                const frame = FRAMES[frameIndex] ?? FRAMES[0] ?? '⠋';
+                out.write(`\r${frame} ${text}`);
+                timer = setInterval(() => {
+                    tick(text);
+                }, FRAME_INTERVAL_MS);
+            }
+            else {
+                // Non-TTY: print once, no animation.
+                out.write(`${text}\n`);
+            }
+        },
+        stop() {
+            if (!active)
+                return;
+            active = false;
+            if (timer !== null) {
+                clearInterval(timer);
+                timer = null;
+            }
+            if (out.isTty) {
+                // Clear the spinner line so the real output follows cleanly.
+                out.write('\r\x1b[K');
+            }
+        },
+    };
+}
+//# sourceMappingURL=spinner.js.map

package/dist/ui/spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../src/ui/spinner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,8EAA8E;AAC9E,iEAAiE;AACjE,8EAA8E;AAE9E,MAAM,MAAM,GAAsB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AACrF,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAc7B;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,GAAe;IAC3C,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,KAAK,GAA0C,IAAI,CAAC;IACxD,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,yEAAyE;IACzE,SAAS,IAAI,CAAC,IAAY;QACxB,UAAU,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;QAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;QACrD,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,IAAI,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,OAAO;QACL,KAAK,CAAC,IAAY;YAChB,IAAI,MAAM;gBAAE,OAAO;YACnB,MAAM,GAAG,IAAI,CAAC;YAEd,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;gBACd,8DAA8D;gBAC9D,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;gBACrD,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,IAAI,EAAE,CAAC,CAAC;gBAEhC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;oBACvB,IAAI,CAAC,IAAI,CAAC,CAAC;gBACb,CAAC,EAAE,iBAAiB,CAAC,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACN,qCAAqC;gBACrC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QAED,IAAI;YACF,IAAI,CAAC,MAAM;gBAAE,OAAO;YACpB,MAAM,GAAG,KAAK,CAAC;YAEf,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACnB,aAAa,CAAC,KAAK,CAAC,CAAC;gBACrB,KAAK,GAAG,IAAI,CAAC;YACf,CAAC;YAED,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;gBACd,6DAA6D;gBAC7D,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/ui/theme.d.ts

@@ -0,0 +1,32 @@
+/**
+ * src/ui/theme.ts — Centralised ANSI colour / format helpers.
+ *
+ * Every helper accepts a `color` boolean flag. When false the text is returned
+ * unchanged, which honours NO_COLOR and non-TTY contexts. No other module in
+ * the project should hardcode ANSI escape codes.
+ *
+ * Honesty contract: this file contains no hardcoded percentages, no fabricated
+ * figures, and no mock phrases.
+ */
+/** Dim / faint text. */
+export declare function dim(text: string, color: boolean): string;
+/** Bold text. */
+export declare function bold(text: string, color: boolean): string;
+/** Green text (success / ok). */
+export declare function green(text: string, color: boolean): string;
+/** Red text (failure / error). */
+export declare function red(text: string, color: boolean): string;
+/** Yellow text (warning / caution). */
+export declare function yellow(text: string, color: boolean): string;
+/** Cyan text (informational accent). */
+export declare function cyan(text: string, color: boolean): string;
+/**
+ * Render a labelled key in a key/value pair.
+ * e.g. `label('Status', true)` → bold cyan "Status"
+ */
+export declare function label(text: string, color: boolean): string;
+/**
+ * Return a horizontal rule of the given width (default 40).
+ * The divider is dim when colour is enabled.
+ */
+export declare function divider(color: boolean, width?: number): string;

package/dist/ui/theme.js

@@ -0,0 +1,56 @@
+/**
+ * src/ui/theme.ts — Centralised ANSI colour / format helpers.
+ *
+ * Every helper accepts a `color` boolean flag. When false the text is returned
+ * unchanged, which honours NO_COLOR and non-TTY contexts. No other module in
+ * the project should hardcode ANSI escape codes.
+ *
+ * Honesty contract: this file contains no hardcoded percentages, no fabricated
+ * figures, and no mock phrases.
+ */
+// ---------------------------------------------------------------------------
+// Primitive colour helpers
+// ---------------------------------------------------------------------------
+/** Dim / faint text. */
+export function dim(text, color) {
+    return color ? `\x1b[2m${text}\x1b[0m` : text;
+}
+/** Bold text. */
+export function bold(text, color) {
+    return color ? `\x1b[1m${text}\x1b[0m` : text;
+}
+/** Green text (success / ok). */
+export function green(text, color) {
+    return color ? `\x1b[32m${text}\x1b[0m` : text;
+}
+/** Red text (failure / error). */
+export function red(text, color) {
+    return color ? `\x1b[31m${text}\x1b[0m` : text;
+}
+/** Yellow text (warning / caution). */
+export function yellow(text, color) {
+    return color ? `\x1b[33m${text}\x1b[0m` : text;
+}
+/** Cyan text (informational accent). */
+export function cyan(text, color) {
+    return color ? `\x1b[36m${text}\x1b[0m` : text;
+}
+// ---------------------------------------------------------------------------
+// Composite helpers
+// ---------------------------------------------------------------------------
+/**
+ * Render a labelled key in a key/value pair.
+ * e.g. `label('Status', true)` → bold cyan "Status"
+ */
+export function label(text, color) {
+    return bold(cyan(text, color), color);
+}
+/**
+ * Return a horizontal rule of the given width (default 40).
+ * The divider is dim when colour is enabled.
+ */
+export function divider(color, width = 40) {
+    const line = '─'.repeat(width);
+    return dim(line, color);
+}
+//# sourceMappingURL=theme.js.map

package/dist/ui/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/ui/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E,wBAAwB;AACxB,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,KAAc;IAC9C,OAAO,KAAK,CAAC,CAAC,CAAC,UAAU,IAAI,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;AAChD,CAAC;AAED,iBAAiB;AACjB,MAAM,UAAU,IAAI,CAAC,IAAY,EAAE,KAAc;IAC/C,OAAO,KAAK,CAAC,CAAC,CAAC,UAAU,IAAI,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;AAChD,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,KAAK,CAAC,IAAY,EAAE,KAAc;IAChD,OAAO,KAAK,CAAC,CAAC,CAAC,WAAW,IAAI,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC;AAED,kCAAkC;AAClC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,KAAc;IAC9C,OAAO,KAAK,CAAC,CAAC,CAAC,WAAW,IAAI,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,KAAc;IACjD,OAAO,KAAK,CAAC,CAAC,CAAC,WAAW,IAAI,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,IAAI,CAAC,IAAY,EAAE,KAAc;IAC/C,OAAO,KAAK,CAAC,CAAC,CAAC,WAAW,IAAI,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC;AAED,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAC,IAAY,EAAE,KAAc;IAChD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,KAAc,EAAE,KAAK,GAAG,EAAE;IAChD,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,OAAO,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC1B,CAAC"}