@cruxy/cli 0.10.0 → 0.12.0

package/dist/cli/program.js

@@ -1,8 +1,8 @@
 import { Command } from "commander";
-import pc from "picocolors";
 import { APP_NAME, APP_VERSION, APP_DESCRIPTION } from "../constants.js";
 import { logger } from "../utils/logger.js";
-import { usageError } from "../errors/index.js";
+import { shouldUseColor, usageError } from "../errors/index.js";
+import { themeForColor } from "../theme/index.js";
 import { runCommand } from "./commands/run.js";
 import { configCommand } from "./commands/config.js";
 import { indexCommand } from "./commands/index.js";
@@ -12,6 +12,7 @@ import { loginCommand } from "./commands/login.js";
 import { initCommand } from "./commands/init.js";
 import { checkpointCommand } from "./commands/checkpoint.js";
 import { rollbackCommand } from "./commands/rollback.js";
+import { testCommand } from "./commands/test.js";
 import { loadConfig } from "../config/index.js";
 import { maybeRunOnboarding } from "./onboard.js";
 export function buildProgram() {
@@ -40,6 +41,7 @@ export function buildProgram() {
     program.addCommand(initCommand());
     program.addCommand(checkpointCommand());
     program.addCommand(rollbackCommand());
+    program.addCommand(testCommand());
     // Default action: bare `cruxy` -> entrypoint. An unrecognized first operand
     // means an unknown command (Commander runs the default action with it as an
     // operand rather than erroring), so reject it as a usage error.
@@ -61,11 +63,12 @@ export function buildProgram() {
             await onboarding;
             return;
         }
-        logger.print(pc.cyan(`${APP_NAME} v${APP_VERSION}`));
-        logger.print(pc.dim("an agentic coding CLI\n"));
+        const t = themeForColor(shouldUseColor(process.stdout));
+        logger.print(t.accent(`${APP_NAME} v${APP_VERSION}`));
+        logger.print(t.muted("an agentic coding CLI\n"));
         logger.print("The interactive REPL lands in C.3 (terminal UI).");
-        logger.print(`For now try:  ${pc.bold('cruxy run "<task>"')}  or  ${pc.bold("cruxy config path")}`);
-        logger.print(`See all commands:  ${pc.bold("cruxy --help")}`);
+        logger.print(`For now try:  ${t.strong('cruxy run "<task>"')}  or  ${t.strong("cruxy config path")}`);
+        logger.print(`See all commands:  ${t.strong("cruxy --help")}`);
     });
     // Throw CommanderError instead of calling process.exit, and suppress
     // Commander's own "error:" line — so parse errors (unknown command/option,

package/dist/cli/repl.js

@@ -1,10 +1,12 @@
 import readline from "node:readline";
-import pc from "picocolors";
 import { makeReplCompleter } from "../components/index.js";
+import { themeForColor } from "../theme/index.js";
 import { formatError, fromUnknown, isVerbose, shouldUseColor, } from "../errors/index.js";
 import { createRenderer } from "../render/index.js";
 import { logger } from "../utils/logger.js";
-const PROMPT = `${pc.cyan("cruxy")} ${pc.dim("›")} `;
+/** The REPL prompts on stdout; its chrome resolves against stdout's color. */
+const theme = themeForColor(shouldUseColor(process.stdout));
+const PROMPT = `${theme.accent("cruxy")} ${theme.muted(theme.glyph.caret)} `;
 /**
  * The REPL's slash commands — the autocomplete candidate set (U.7). Keep in
  * sync with the dispatch below and the HELP text.
@@ -92,7 +94,7 @@ function printReplError(err) {
  * passes its own so the approval prompt's status-suspend hook shares it.
  */
 export async function runInteractive(session, io = defaultIO(), renderer = createRenderer(io.output, process.stderr), checkpoints) {
-    logger.print(pc.dim("interactive session — /help for commands, /exit or Ctrl+D to quit"));
+    logger.print(theme.muted("interactive session — /help for commands, /exit or Ctrl+D to quit"));
     try {
         await replLoop(session, io, renderer, checkpoints);
     }
@@ -105,25 +107,25 @@ async function replLoop(session, io, renderer, checkpoints) {
         const line = await readLine(io, PROMPT);
         // EOF / Ctrl+D.
         if (line === null) {
-            logger.print(pc.dim("\nbye"));
+            logger.print(theme.muted("\nbye"));
             return;
         }
         const trimmed = line.trim();
         if (trimmed === "")
             continue; // empty line → reprompt, no model call
         if (trimmed === "/exit" || trimmed === "/quit") {
-            logger.print(pc.dim("bye"));
+            logger.print(theme.muted("bye"));
             return;
         }
         if (trimmed === "/clear") {
             session.clear();
-            logger.print(pc.dim("history cleared"));
+            logger.print(theme.muted("history cleared"));
             continue;
         }
         if (trimmed === "/compact") {
             try {
                 const n = await session.compact();
-                logger.print(pc.dim(n ? `compacted ${n} older messages` : "nothing to compact yet"));
+                logger.print(theme.muted(n ? `compacted ${n} older messages` : "nothing to compact yet"));
             }
             catch (err) {
                 printReplError(err);
@@ -132,7 +134,7 @@ async function replLoop(session, io, renderer, checkpoints) {
         }
         if (trimmed === "/reload") {
             const loaded = session.reloadProjectInstructions();
-            logger.print(pc.dim(loaded
+            logger.print(theme.muted(loaded
                 ? "reloaded project instructions (CRUXY.md)"
                 : "no project instructions found"));
             continue;
@@ -140,7 +142,7 @@ async function replLoop(session, io, renderer, checkpoints) {
         if (trimmed === "/plan") {
             session.setPlanMode(!session.getPlanMode());
             const on = session.getPlanMode();
-            logger.print(pc.dim(on
+            logger.print(theme.muted(on
                 ? "plan mode on — the next prompt proposes a plan for approval"
                 : "plan mode off"));
             continue;

package/dist/cli/session-factory.js

@@ -67,10 +67,14 @@ export function withCheckpointGate(requestApproval, checkpoints, cwd) {
         if (request.tier === "read")
             return decision;
         await checkpoints.ensureCheckpoint();
-        if (action.kind === "shell")
+        // Shell AND test executions (C.13) can mutate files we can't attribute
+        // (scripts, snapshot writers) — record the lost attribution the same way.
+        if (action.kind === "shell" || action.kind === "test") {
             await checkpoints.recordShellMutation();
-        else
+        }
+        else {
             await checkpoints.recordTouched([...request.targets]);
+        }
         return decision;
     };
 }

package/dist/components/frame.js

@@ -1,3 +1,4 @@
+import { resolveTheme } from "../theme/index.js";
 /** Erase the current line and return the cursor to column 0 (same as U.2). */
 const CLEAR_LINE = "\r\x1b[2K";
 /** Move the cursor up one row. */
@@ -11,6 +12,7 @@ export function stripAnsi(text) {
 }
 export function createFrame(write, caps) {
     let drawn = 0;
+    const ellipsis = resolveTheme(caps).glyph.ellipsis;
     /**
      * Truncate to width-1 (cursor rests after the last cell; a full-width row
      * would auto-wrap on some terminals). Width is measured on VISIBLE
@@ -23,7 +25,7 @@ export function createFrame(write, caps) {
         const plain = stripAnsi(line);
         if (plain.length <= room)
             return line;
-        return plain.slice(0, room - 1) + "…";
+        return plain.slice(0, room - 1) + ellipsis;
     };
     const erase = () => {
         if (drawn === 0)

package/dist/components/fuzzy.d.ts

@@ -1,4 +1,4 @@
-import pc from "picocolors";
+import { type Theme } from "../theme/index.js";
 import { type ComponentIO, type InteractiveResult } from "./input.js";
 /**
  * Fuzzy finding (U.7): a deterministic, honest subsequence scorer (pure,
@@ -36,10 +36,10 @@ export interface RankedItem<T> {
  */
 export declare function rankItems<T>(items: readonly T[], toLabel: (item: T) => string, query: string): RankedItem<T>[];
 /**
- * Bold the matched characters of a label. With color off (NO_COLOR, pipe)
- * picocolors' disabled palette is the identity — plain text, zero ANSI.
+ * Bold the matched characters of a label via the theme's accent role. With
+ * color off (NO_COLOR, pipe) the roles are identity — plain text, zero ANSI.
  */
-export declare function highlightMatch(label: string, positions: readonly number[], colors: ReturnType<typeof pc.createColors>): string;
+export declare function highlightMatch(label: string, positions: readonly number[], theme: Theme): string;
 export interface FuzzyFindOptions<T> {
     /** Label an item filters/renders under. Required — items are opaque. */
     toLabel: (item: T) => string;

package/dist/components/fuzzy.js

@@ -1,4 +1,4 @@
-import pc from "picocolors";
+import { resolveTheme } from "../theme/index.js";
 import { createFrame } from "./frame.js";
 import { defaultComponentIO, resolveNonInteractive, } from "./input.js";
 /** Word-boundary characters that earn the boundary bonus for the NEXT char. */
@@ -69,16 +69,16 @@ export function rankItems(items, toLabel, query) {
     return ranked.map(({ item, label, match }) => ({ item, label, match }));
 }
 /**
- * Bold the matched characters of a label. With color off (NO_COLOR, pipe)
- * picocolors' disabled palette is the identity — plain text, zero ANSI.
+ * Bold the matched characters of a label via the theme's accent role. With
+ * color off (NO_COLOR, pipe) the roles are identity — plain text, zero ANSI.
  */
-export function highlightMatch(label, positions, colors) {
+export function highlightMatch(label, positions, theme) {
     if (positions.length === 0)
         return label;
     const matched = new Set(positions);
     let out = "";
     for (let i = 0; i < label.length; i++) {
-        out += matched.has(i) ? colors.bold(colors.cyan(label[i])) : label[i];
+        out += matched.has(i) ? theme.strong(theme.accent(label[i])) : label[i];
     }
     return out;
 }
@@ -94,7 +94,8 @@ export async function fuzzyFind(items, opts, io = defaultComponentIO()) {
         return fallback;
     if (items.length === 0)
         return { kind: "cancelled" };
-    const colors = pc.createColors(io.caps.color);
+    const t = resolveTheme(io.caps);
+    const g = t.glyph;
     const maxVisible = opts.maxVisible ?? 10;
     const frame = createFrame(io.write, io.caps);
     let query = "";
@@ -102,10 +103,10 @@ export async function fuzzyFind(items, opts, io = defaultComponentIO()) {
     const paint = (ranked) => {
         const lines = [];
         if (opts.title)
-            lines.push(colors.bold(opts.title));
-        lines.push(`${colors.cyan("›")} ${query}${colors.dim("▏")}`);
+            lines.push(t.heading(opts.title));
+        lines.push(`${t.accent(g.caret)} ${query}${t.muted(g.cursorBar)}`);
         if (ranked.length === 0) {
-            lines.push(colors.dim("  no results — backspace to widen"));
+            lines.push(t.muted("  no results — backspace to widen"));
         }
         else {
             // Keep the highlighted row inside the viewport.
@@ -113,13 +114,13 @@ export async function fuzzyFind(items, opts, io = defaultComponentIO()) {
             const visible = ranked.slice(top, top + maxVisible);
             for (const [i, row] of visible.entries()) {
                 const selected = top + i === cursor;
-                const marker = selected ? colors.cyan("❯") : " ";
-                const label = highlightMatch(row.label, row.match.positions, colors);
-                lines.push(`${marker} ${selected ? label : colors.dim(label)}`);
+                const marker = selected ? t.accent(g.pointer) : " ";
+                const label = highlightMatch(row.label, row.match.positions, t);
+                lines.push(`${marker} ${selected ? label : t.muted(label)}`);
             }
             const hidden = ranked.length - visible.length;
             if (hidden > 0)
-                lines.push(colors.dim(`  … ${hidden} more`));
+                lines.push(t.muted(`  ${g.ellipsis} ${hidden} more`));
         }
         frame.render(lines);
     };

package/dist/components/select.js

@@ -1,4 +1,4 @@
-import pc from "picocolors";
+import { resolveTheme } from "../theme/index.js";
 import { createFrame } from "./frame.js";
 import { defaultComponentIO, resolveNonInteractive, } from "./input.js";
 /**
@@ -15,26 +15,27 @@ export async function selectList(items, opts = {}, io = defaultComponentIO()) {
     if (items.length === 0)
         return { kind: "cancelled" };
     const toLabel = opts.toLabel ?? ((item) => String(item));
-    const colors = pc.createColors(io.caps.color);
+    const t = resolveTheme(io.caps);
+    const g = t.glyph;
     const maxVisible = opts.maxVisible ?? 10;
     const frame = createFrame(io.write, io.caps);
     let cursor = Math.min(Math.max(opts.initialIndex ?? 0, 0), items.length - 1);
     const paint = () => {
         const lines = [];
         if (opts.title)
-            lines.push(colors.bold(opts.title));
+            lines.push(t.heading(opts.title));
         const top = Math.min(Math.max(0, cursor - maxVisible + 1), Math.max(0, items.length - maxVisible));
         const visible = items.slice(top, top + maxVisible);
         for (const [i, item] of visible.entries()) {
             const selected = top + i === cursor;
-            const marker = selected ? colors.cyan("❯") : " ";
+            const marker = selected ? t.accent(g.pointer) : " ";
             const label = toLabel(item);
-            lines.push(`${marker} ${selected ? label : colors.dim(label)}`);
+            lines.push(`${marker} ${selected ? label : t.muted(label)}`);
         }
         const hidden = items.length - visible.length;
         if (hidden > 0)
-            lines.push(colors.dim(`  … ${hidden} more`));
-        lines.push(colors.dim("  ↑/↓ move · enter select · esc cancel"));
+            lines.push(t.muted(`  ${g.ellipsis} ${hidden} more`));
+        lines.push(t.muted(`  ${g.caretUp}/${g.caretDown} move ${g.sep} enter select ${g.sep} esc cancel`));
         frame.render(lines);
     };
     io.keys.begin();

package/dist/config/schema.d.ts

@@ -219,6 +219,27 @@ export declare const CheckpointConfigSchema: z.ZodObject<{
     enabled?: boolean | undefined;
     retention?: number | undefined;
 }>;
+/**
+ * Test-execution loop (C.13): how the agent runs the project's test suite and
+ * iterates on failures. The command is detected from package.json when unset;
+ * cruxy never invents one.
+ */
+export declare const TestConfigSchema: z.ZodObject<{
+    /** Explicit test command (overrides package.json detection). */
+    command: z.ZodOptional<z.ZodString>;
+    /** Consecutive failing runs before the edit→re-run loop trips its cap. */
+    maxIterations: z.ZodDefault<z.ZodNumber>;
+    /** Cap on captured test output bytes (tail-biased — failures come last). */
+    captureBytes: z.ZodDefault<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    maxIterations: number;
+    captureBytes: number;
+    command?: string | undefined;
+}, {
+    maxIterations?: number | undefined;
+    command?: string | undefined;
+    captureBytes?: number | undefined;
+}>;
 /**
  * Subagent orchestration (C.14): scoped child agents the main agent can spawn
  * for bounded subtasks. Every cap here is a hard bound — a subagent can narrow
@@ -514,6 +535,22 @@ export declare const CruxyConfigSchema: z.ZodObject<{
             timeoutMs?: number | undefined;
         } | undefined;
     }>>;
+    test: z.ZodDefault<z.ZodObject<{
+        /** Explicit test command (overrides package.json detection). */
+        command: z.ZodOptional<z.ZodString>;
+        /** Consecutive failing runs before the edit→re-run loop trips its cap. */
+        maxIterations: z.ZodDefault<z.ZodNumber>;
+        /** Cap on captured test output bytes (tail-biased — failures come last). */
+        captureBytes: z.ZodDefault<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        maxIterations: number;
+        captureBytes: number;
+        command?: string | undefined;
+    }, {
+        maxIterations?: number | undefined;
+        command?: string | undefined;
+        captureBytes?: number | undefined;
+    }>>;
     mcpServers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         command: z.ZodOptional<z.ZodString>;
         args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -592,6 +629,11 @@ export declare const CruxyConfigSchema: z.ZodObject<{
             timeoutMs?: number | undefined;
         };
     };
+    test: {
+        maxIterations: number;
+        captureBytes: number;
+        command?: string | undefined;
+    };
     mcpServers: Record<string, {
         command?: string | undefined;
         args?: string[] | undefined;
@@ -662,6 +704,11 @@ export declare const CruxyConfigSchema: z.ZodObject<{
             timeoutMs?: number | undefined;
         } | undefined;
     } | undefined;
+    test?: {
+        maxIterations?: number | undefined;
+        command?: string | undefined;
+        captureBytes?: number | undefined;
+    } | undefined;
     mcpServers?: Record<string, {
         command?: string | undefined;
         args?: string[] | undefined;

package/dist/config/schema.js

@@ -149,6 +149,25 @@ export const CheckpointConfigSchema = z
     retention: z.number().int().positive().default(10),
 })
     .strict();
+/**
+ * Test-execution loop (C.13): how the agent runs the project's test suite and
+ * iterates on failures. The command is detected from package.json when unset;
+ * cruxy never invents one.
+ */
+export const TestConfigSchema = z
+    .object({
+    /** Explicit test command (overrides package.json detection). */
+    command: z.string().min(1).optional(),
+    /** Consecutive failing runs before the edit→re-run loop trips its cap. */
+    maxIterations: z.number().int().positive().default(4),
+    /** Cap on captured test output bytes (tail-biased — failures come last). */
+    captureBytes: z
+        .number()
+        .int()
+        .positive()
+        .default(64 * 1024),
+})
+    .strict();
 /**
  * Subagent orchestration (C.14): scoped child agents the main agent can spawn
  * for bounded subtasks. Every cap here is a hard bound — a subagent can narrow
@@ -196,6 +215,7 @@ export const CruxyConfigSchema = z
     index: IndexConfigSchema.default({}),
     checkpoint: CheckpointConfigSchema.default({}),
     subagent: SubagentConfigSchema.default({}),
+    test: TestConfigSchema.default({}),
     mcpServers: z.record(z.string(), McpServerSchema).default({}),
     logLevel: z.enum(LOG_LEVELS).default("info"),
 })

package/dist/errors/constructors.d.ts

@@ -85,6 +85,11 @@ export declare function subagentDepthExceeded(depth: number, maxDepth: number):
  * reasons over; thrown only when the orchestrator itself cannot proceed.
  */
 export declare function subagentFailed(underlying?: unknown): CruxyError;
+/**
+ * No test command could be detected and none is configured (C.13). cruxy never
+ * invents a test command — the fix is always to declare one.
+ */
+export declare function testCommandNotFound(): CruxyError;
 export declare function internal(underlying?: unknown): CruxyError;
 /**
  * Map a known provider/transport error (from `@cruxy/sdk`) to a typed

package/dist/errors/constructors.js

@@ -436,6 +436,22 @@ export function subagentFailed(underlying) {
         underlying,
     });
 }
+// ── testing (exit 2) ──────────────────────────────────────────────────────────
+/**
+ * No test command could be detected and none is configured (C.13). cruxy never
+ * invents a test command — the fix is always to declare one.
+ */
+export function testCommandNotFound() {
+    return new CruxyError({
+        code: ErrorCode.TestCommandNotFound,
+        title: "no test command found for this project",
+        cause: "package.json has no usable `scripts.test` and `test.command` is not configured",
+        nextSteps: [
+            'set `test.command` in your cruxy config (e.g. `cruxy config set test.command "pnpm test"`)',
+            "or add a `test` script to package.json",
+        ],
+    });
+}
 // ── internal (exit 1) ─────────────────────────────────────────────────────────
 export function internal(underlying) {
     return new CruxyError({

package/dist/errors/format.js

@@ -1,4 +1,4 @@
-import pc from "picocolors";
+import { themeForColor } from "../theme/index.js";
 /**
  * Decide whether to colorize: honor `NO_COLOR` (disable) and `FORCE_COLOR`
  * (enable), otherwise color only when writing to a TTY.
@@ -13,27 +13,27 @@ export function shouldUseColor(stream = process.stderr, env = process.env) {
 /** The default terminal formatter: title, cause, next steps, code (+ verbose). */
 export class TerminalFormatter {
     format(err, opts) {
-        const c = pc.createColors(opts.color);
+        const t = themeForColor(opts.color);
         const lines = [];
         // 1. Title — one plain line, what failed.
-        lines.push(c.red(c.bold(err.title)));
+        lines.push(t.danger(t.strong(err.title)));
         // 2. Cause — the specific reason, when known.
         if (err.cause)
-            lines.push(`${c.dim("Cause:")} ${err.cause}`);
+            lines.push(`${t.muted("Cause:")} ${err.cause}`);
         // 3. Next step(s) — the concrete action(s) to take.
         if (err.nextSteps.length > 0) {
             lines.push("");
-            lines.push(c.bold("Next steps:"));
+            lines.push(t.heading("Next steps:"));
             for (const step of err.nextSteps)
-                lines.push(`  ${c.cyan("→")} ${step}`);
+                lines.push(`  ${t.accent(t.glyph.arrow)} ${step}`);
         }
         // 4. Code — the stable, greppable id.
         lines.push("");
-        lines.push(c.dim(`[${err.code}]`));
+        lines.push(t.muted(`[${err.code}]`));
         // Verbose-only: the preserved underlying error.
         if (opts.verbose && err.underlying !== undefined) {
             lines.push("");
-            lines.push(c.dim("Underlying error:"));
+            lines.push(t.muted("Underlying error:"));
             lines.push(indent(stackOf(err.underlying)));
         }
         return lines.join("\n");

package/dist/errors/types.d.ts

@@ -49,6 +49,9 @@ export declare const ErrorCode: {
     /** Carried inside a SubagentResult (informational) — never fatal by itself. */
     readonly SubagentBudget: "CRUXY_E_SUBAGENT_BUDGET";
     readonly SubagentFailed: "CRUXY_E_SUBAGENT_FAILED";
+    readonly TestCommandNotFound: "CRUXY_E_TEST_COMMAND_NOT_FOUND";
+    /** Carried inside a run_tests result (informational) — never fatal by itself. */
+    readonly TestIterationLimit: "CRUXY_E_TEST_ITERATION_LIMIT";
 };
 export type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];
 /** The process exit code for an error code (defaults to 1 for safety). */

package/dist/errors/types.js

@@ -60,6 +60,10 @@ export const ErrorCode = {
     /** Carried inside a SubagentResult (informational) — never fatal by itself. */
     SubagentBudget: "CRUXY_E_SUBAGENT_BUDGET",
     SubagentFailed: "CRUXY_E_SUBAGENT_FAILED",
+    // testing (exit 2 / 11)
+    TestCommandNotFound: "CRUXY_E_TEST_COMMAND_NOT_FOUND",
+    /** Carried inside a run_tests result (informational) — never fatal by itself. */
+    TestIterationLimit: "CRUXY_E_TEST_ITERATION_LIMIT",
 };
 /**
  * Category exit codes. Distinct per category so a caller (CI, a script) can
@@ -104,6 +108,10 @@ const EXIT_CODES = {
     [ErrorCode.SubagentDepthExceeded]: 2,
     [ErrorCode.SubagentBudget]: 11,
     [ErrorCode.SubagentFailed]: 11,
+    // No test command is a configuration gap (usage); the iteration limit
+    // surfaces inside a run_tests result and is never fatal by itself.
+    [ErrorCode.TestCommandNotFound]: 2,
+    [ErrorCode.TestIterationLimit]: 11,
 };
 /** The process exit code for an error code (defaults to 1 for safety). */
 export function exitCodeFor(code) {

package/dist/onboarding/flow.js

@@ -1,5 +1,5 @@
 import { AuthError, NetworkError, createProvider } from "@cruxy/sdk";
-import pc from "picocolors";
+import { themeForColor } from "../theme/index.js";
 import { resolveApiKey, writeCredential } from "../config/index.js";
 import { newOnboardingState, readOnboardingState, writeOnboardingState, } from "./detect.js";
 import { acquireKeyStep, firstWinStep, scaffoldStep } from "./steps.js";
@@ -11,8 +11,8 @@ import { acquireKeyStep, firstWinStep, scaffoldStep } from "./steps.js";
  */
 export async function runOnboarding(opts) {
     const { io, deps, provider } = opts;
-    const col = pc.createColors(io.color);
-    io.write(`${col.cyan(col.bold("Welcome to cruxy"))} — let's get you set up.\n`);
+    const t = themeForColor(io.color);
+    io.write(`${t.accent(t.strong("Welcome to cruxy"))} — let's get you set up.\n`);
     let state = deps.readState() ?? newOnboardingState();
     let apiKey = deps.resolveApiKey(provider);
     // ── key (mandatory; skipped if already resolvable unless forceKey) ─────────
@@ -24,7 +24,7 @@ export async function runOnboarding(opts) {
         if (result.status !== "ok") {
             // Failed (unreachable / rejected) — surface guidance, no marker.
             if (result.message)
-                io.write(`${col.dim(result.message)}\n`);
+                io.write(`${t.muted(result.message)}\n`);
             return { completed: false, aborted: false };
         }
         apiKey = result.apiKey;
@@ -32,7 +32,7 @@ export async function runOnboarding(opts) {
         deps.writeState(state);
     }
     else {
-        io.write(`${col.green("✓")} using your existing API key.\n`);
+        io.write(`${t.success(t.glyph.success)} using your existing API key.\n`);
         state = { ...state, keyConfigured: true };
     }
     // ── optional steps (Ctrl-C here just skips them; the key is already safe) ───
@@ -43,7 +43,7 @@ export async function runOnboarding(opts) {
     // ── complete ───────────────────────────────────────────────────────────────
     state = { ...state, completedAt: deps.now() };
     deps.writeState(state);
-    io.write(`${col.green(col.bold("✓ all set"))} — happy hacking.\n`);
+    io.write(`${t.success(t.strong(`${t.glyph.success} all set`))} — happy hacking.\n`);
     return { completed: true, aborted: false, apiKey };
 }
 /**

package/dist/onboarding/steps.js

@@ -1,6 +1,6 @@
 import { writeFileSync } from "node:fs";
 import { join } from "node:path";
-import pc from "picocolors";
+import { themeForColor } from "../theme/index.js";
 import { CREATE_KEY_URL } from "../constants.js";
 import { loadProjectInstructions } from "../config/index.js";
 /**
@@ -9,7 +9,7 @@ import { loadProjectInstructions } from "../config/index.js";
  * or logged. Rendering is gated on `io.color` so output respects NO_COLOR / pipes.
  */
 const MAX_KEY_ATTEMPTS = 3;
-const c = (io) => pc.createColors(io.color);
+const c = (io) => themeForColor(io.color);
 /**
  * Acquire and persist a provider key: print the create-key URL, read it masked,
  * validate it live, and **only then** write it to the credentials store. Loops on
@@ -17,23 +17,23 @@ const c = (io) => pc.createColors(io.color);
  */
 export async function acquireKeyStep(io, deps, provider) {
     const col = c(io);
-    io.write(`\nYou'll need a Cruxy API key. Create one at ${col.cyan(CREATE_KEY_URL)}\n`);
+    io.write(`\nYou'll need a Cruxy API key. Create one at ${col.accent(CREATE_KEY_URL)}\n`);
     for (let attempt = 1; attempt <= MAX_KEY_ATTEMPTS; attempt++) {
-        io.write(col.bold("Paste your API key: "));
+        io.write(col.strong("Paste your API key: "));
         const key = (await io.readSecret()).trim();
         if (key === "") {
             // Empty / Ctrl-C / EOF — treat as an abort of the mandatory step.
             return { status: "aborted" };
         }
-        io.write(col.dim("validating…\n"));
+        io.write(col.muted("validating…\n"));
         const outcome = await deps.validateKey(provider, key);
         if (outcome === "valid") {
             deps.writeCredential(provider, key);
-            io.write(`${col.green("✓")} key validated and saved to ~/.cruxy\n`);
+            io.write(`${col.success(col.glyph.success)} key validated and saved to ~/.cruxy\n`);
             return { status: "ok", apiKey: key };
         }
         if (outcome === "unreachable") {
-            io.write(`${col.red("✗")} couldn't reach the gateway to validate the key.\n`);
+            io.write(`${col.danger(col.glyph.failure)} couldn't reach the gateway to validate the key.\n`);
             return {
                 status: "failed",
                 message: "network unreachable — try again with `cruxy login`",
@@ -41,7 +41,7 @@ export async function acquireKeyStep(io, deps, provider) {
         }
         // invalid
         const left = MAX_KEY_ATTEMPTS - attempt;
-        io.write(`${col.red("✗")} that key was rejected${left > 0 ? ` (${left} ${left === 1 ? "try" : "tries"} left)` : ""}.\n`);
+        io.write(`${col.danger(col.glyph.failure)} that key was rejected${left > 0 ? ` (${left} ${left === 1 ? "try" : "tries"} left)` : ""}.\n`);
     }
     return { status: "failed", message: "key rejected after 3 attempts" };
 }
@@ -71,14 +71,14 @@ export async function scaffoldStep(io, cwd) {
     if (loadProjectInstructions(cwd) !== null) {
         return { status: "skipped" };
     }
-    io.write(`\nScaffold a ${col.bold("CRUXY.md")} to guide cruxy in this project? ${col.dim("[y/N]")} `);
+    io.write(`\nScaffold a ${col.strong("CRUXY.md")} to guide cruxy in this project? ${col.muted("[y/N]")} `);
     const key = (await io.readKey()).toLowerCase();
     io.write("\n");
     if (key !== "y")
         return { status: "skipped" };
     const file = join(cwd, "CRUXY.md");
     writeFileSync(file, CRUXY_MD_TEMPLATE, "utf8");
-    io.write(`${col.green("✓")} wrote ${col.bold("CRUXY.md")}\n`);
+    io.write(`${col.success(col.glyph.success)} wrote ${col.strong("CRUXY.md")}\n`);
     return { status: "ok" };
 }
 const FIRST_WIN_PROMPT = "Give me a concise 3-sentence summary of what this repository does, based on its README and structure.";
@@ -90,7 +90,7 @@ export async function firstWinStep(io, deps) {
     const col = c(io);
     if (!deps.runTask)
         return { status: "skipped" };
-    io.write(`\nRun a quick demo now — let cruxy summarize this repo? ${col.dim("[Y/n]")} `);
+    io.write(`\nRun a quick demo now — let cruxy summarize this repo? ${col.muted("[Y/n]")} `);
     const key = (await io.readKey()).toLowerCase();
     io.write("\n");
     if (key === "n")