archbyte 0.2.0 → 0.2.2

package/bin/archbyte.js

@@ -27,7 +27,7 @@ const program = new Command();
 program
   .name('archbyte')
   .description('ArchByte - See what agents build. As they build it.')
-  .version('0.2.0')
+  .version('0.2.2')
   .addHelpText('after', `
   Quick start:
     $ archbyte login       Sign in
@@ -79,6 +79,7 @@ program
   .option('--api-key <key>', 'Model API key (overrides config)')
   .option('-p, --port <number>', 'UI server port (default: 3847)', parseInt)
   .option('-v, --verbose', 'Show detailed output')
+  .option('--force', 'Force full re-scan (skip incremental detection)')
   .option('--dry-run', 'Preview without running')
   .action(async (options) => {
     await requireLicense('analyze');
@@ -94,7 +95,7 @@ program
   .option('--api-key <key>', 'Model API key (overrides config)')
   .option('--static', 'Static-only analysis (no model, free)')
   .option('--skip-llm', 'Alias for --static')
-  .option('--full', 'Force full re-scan (skip incremental detection)')
+  .option('--force', 'Force full re-scan (skip incremental detection)')
   .option('--dry-run', 'Preview without running')
   .action(async (options) => {
     await requireLicense('analyze');

package/dist/agents/llm/index.js

@@ -15,7 +15,7 @@ export async function enhanceWithLLM(analysis, provider, config, projectRoot, on
         if (analysis.gaps.length > 0) {
             onProgress?.(`Including ${analysis.gaps.length} gap(s) for LLM resolution`);
         }
-        const model = resolveModel(config.provider, "standard", config.modelOverrides);
+        const model = resolveModel(config.provider, "standard", config.modelOverrides, config.model);
         onProgress?.(`Calling ${model} for enhancement...`);
         const response = await provider.chat({
             model,

package/dist/agents/pipeline/index.js

@@ -100,7 +100,7 @@ const MAX_TOKENS = {
 };
 async function runAgent(agent, ctx, provider, config, priorResults, onProgress) {
     const start = Date.now();
-    const model = resolveModel(config.provider, agent.modelTier, config.modelOverrides);
+    const model = resolveModel(config.provider, agent.modelTier, config.modelOverrides, config.model);
     const { system, user } = agent.buildPrompt(ctx, priorResults);
     onProgress?.(`  ${agent.name}: calling ${model}...`);
     const maxTokens = MAX_TOKENS[agent.id] ?? 4096;

package/dist/agents/providers/ollama.js

@@ -10,7 +10,7 @@ export class OllamaProvider {
             ...params.messages.map((m) => this.toOllamaMessage(m)),
         ];
         const body = {
-            model: params.model ?? "llama3.3",
+            model: params.model,
             messages,
             stream: false,
         };
@@ -65,7 +65,7 @@ export class OllamaProvider {
             ...params.messages.map((m) => this.toOllamaMessage(m)),
         ];
         const body = {
-            model: params.model ?? "llama3.3",
+            model: params.model,
             messages,
             stream: true,
         };

package/dist/agents/runtime/orchestrator.js

@@ -90,7 +90,7 @@ export class Orchestrator {
         return false;
     }
     async runAgent(agent, priorResults, onProgress) {
-        const model = resolveModel(this.config.provider, agent.modelTier, this.config.modelOverrides);
+        const model = resolveModel(this.config.provider, agent.modelTier, this.config.modelOverrides, this.config.model);
         // Create a model-routed provider wrapper
         const routedProvider = {
             name: this.provider.name,

package/dist/agents/runtime/types.d.ts

@@ -101,6 +101,7 @@ export type ProviderName = "anthropic" | "openai" | "google" | "ollama";
 export interface ArchByteConfig {
     provider: ProviderName;
     apiKey: string;
+    model?: string;
     modelOverrides?: Partial<Record<ModelTier, string>>;
     ollamaBaseUrl?: string;
 }
@@ -114,4 +115,4 @@ export interface PipelineResult {
     }>;
 }
 export declare const MODEL_MAP: Record<ProviderName, Record<ModelTier, string>>;
-export declare function resolveModel(provider: ProviderName, tier: ModelTier, overrides?: Partial<Record<ModelTier, string>>): string;
+export declare function resolveModel(provider: ProviderName, tier: ModelTier, overrides?: Partial<Record<ModelTier, string>>, model?: string): string;

package/dist/agents/runtime/types.js

@@ -17,13 +17,15 @@ export const MODEL_MAP = {
         advanced: "gemini-2.5-pro",
     },
     ollama: {
-        fast: "llama3.2",
-        standard: "llama3.3",
-        advanced: "llama3.3",
+        fast: "qwen2.5-coder",
+        standard: "qwen2.5-coder",
+        advanced: "qwen2.5-coder",
     },
 };
-export function resolveModel(provider, tier, overrides) {
+export function resolveModel(provider, tier, overrides, model) {
     if (overrides?.[tier])
         return overrides[tier];
+    if (model)
+        return model;
     return MODEL_MAP[provider][tier];
 }

package/dist/cli/analyze.d.ts

@@ -7,7 +7,7 @@ interface AnalyzeOptions {
     static?: boolean;
     skipLlm?: boolean;
     dryRun?: boolean;
-    full?: boolean;
+    force?: boolean;
 }
 export declare function handleAnalyze(options: AnalyzeOptions): Promise<void>;
 /**

package/dist/cli/analyze.js

@@ -6,6 +6,7 @@ import { resolveConfig } from "./config.js";
 import { recordUsage } from "./license-gate.js";
 import { staticResultToSpec, writeSpec, writeMetadata, loadSpec, loadMetadata } from "./yaml-io.js";
 import { getChangedFiles, mapFilesToComponents, shouldRunAgents, isGitAvailable } from "./incremental.js";
+import { progressBar } from "./ui.js";
 export async function handleAnalyze(options) {
     const rootDir = process.cwd();
     const isStaticOnly = options.static || options.skipLlm;
@@ -40,13 +41,13 @@ export async function handleAnalyze(options) {
     // ─── Static-only mode (--static / --skip-llm) ───
     if (isStaticOnly) {
         const startTime = Date.now();
-        console.log(chalk.bold("Running static analysis (no model)..."));
-        console.log();
+        const progress = progressBar(3);
+        progress.update(0, "Running static analysis...");
         const { runStaticAnalysis } = await import("../agents/static/index.js");
         const result = await runStaticAnalysis(rootDir, (msg) => {
-            const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
-            console.log(chalk.gray(`  [${elapsed}s] ${msg}`));
+            progress.update(0, `Static analysis: ${msg}`);
         });
+        progress.update(1, "Building analysis...");
         const analysis = buildAnalysisFromStatic(result, rootDir);
         const duration = Date.now() - startTime;
         // Stamp scan metadata on analysis.json (backward compat)
@@ -59,8 +60,9 @@ export async function handleAnalyze(options) {
         const spec = staticResultToSpec(result, rootDir, existingSpec?.rules);
         writeSpec(rootDir, spec);
         writeScanMetadata(rootDir, duration, "static");
-        console.log(chalk.green(`Saved spec to: .archbyte/archbyte.yaml`));
+        progress.update(2, "Generating diagram...");
         await autoGenerate(rootDir, options);
+        progress.done("Analysis complete");
         printSummary(analysis, duration, "static");
         return;
     }
@@ -113,16 +115,16 @@ export async function handleAnalyze(options) {
     let incrementalContext;
     const priorSpec = loadSpec(rootDir);
     const priorMeta = loadMetadata(rootDir);
-    if (priorSpec && !options.full && isGitAvailable(rootDir) && priorMeta?.lastCommit) {
+    if (priorSpec && !options.force && isGitAvailable(rootDir) && priorMeta?.lastCommit) {
         const changedFiles = getChangedFiles(rootDir, priorMeta.lastCommit);
         if (changedFiles.length === 0) {
-            console.log(chalk.green("No changes detected since last scan. Use --full to force re-scan."));
+            console.log(chalk.green("No changes detected since last scan. Use --force to re-scan."));
             console.log();
             return;
         }
         const { affected, unmapped } = mapFilesToComponents(changedFiles, priorSpec);
         if (!shouldRunAgents(affected, unmapped)) {
-            console.log(chalk.green("Only config changes detected — no re-scan needed. Use --full to force."));
+            console.log(chalk.green("Only config changes detected — no re-scan needed. Use --force to re-scan."));
             console.log();
             return;
         }
@@ -140,11 +142,11 @@ export async function handleAnalyze(options) {
         console.log();
     }
     // 4. Run static context collection → LLM pipeline
-    console.log(chalk.bold("Phase 1: Collecting static context..."));
+    const progress = progressBar(7);
+    progress.update(0, "Collecting static context...");
     const { runStaticContextCollection } = await import("../agents/static/index.js");
     const ctx = await runStaticContextCollection(rootDir, (msg) => {
-        const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
-        console.log(chalk.gray(`  [${elapsed}s] ${msg}`));
+        progress.update(0, `Static context: ${msg}`);
     });
     // Save static context for debugging / re-runs
     const ctxPath = path.join(rootDir, ".archbyte", "static-context.json");
@@ -152,15 +154,41 @@ export async function handleAnalyze(options) {
         fs.mkdirSync(path.dirname(ctxPath), { recursive: true });
     }
     fs.writeFileSync(ctxPath, JSON.stringify(ctx, null, 2), "utf-8");
-    console.log(chalk.gray(`  Saved static context to: .archbyte/static-context.json`));
-    console.log();
-    console.log(chalk.bold(`Phase 2: Running model pipeline${incrementalContext ? " (incremental)" : ""} (3 parallel + 2 sequential)...`));
+    progress.update(1, "Static context collected");
+    progress.update(1, `Running 3 agents in parallel${incrementalContext ? " (incremental)" : ""}...`);
     const { runPipeline } = await import("../agents/pipeline/index.js");
     let result;
+    let pipelineStep = 1;
     try {
         result = await runPipeline(ctx, provider, config, (msg) => {
-            const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
-            console.log(chalk.gray(`  [${elapsed}s] ${msg}`));
+            // Map pipeline progress messages to bar steps
+            if (msg.startsWith("Phase 1:")) {
+                pipelineStep = 1;
+                progress.update(1, "Running 3 agents in parallel...");
+            }
+            else if (msg.startsWith("Phase 2:")) {
+                pipelineStep = 3;
+            }
+            else if (msg.includes(": done") && pipelineStep < 3) {
+                // A parallel agent finished
+                pipelineStep = Math.min(pipelineStep + 0.5, 2);
+                progress.update(pipelineStep, `Running agents in parallel... (${msg.trim()})`);
+            }
+            else if (msg.includes("Connection Mapper") || msg.includes("connection-mapper")) {
+                progress.update(3, "Running connection-mapper...");
+            }
+            else if (msg.includes("Validator") || msg.includes("validator")) {
+                progress.update(4, "Running validator...");
+            }
+            else if (msg.startsWith("Merging")) {
+                progress.update(5, "Merging results...");
+            }
+            else if (msg.startsWith("Token usage")) {
+                progress.update(5, msg.trim());
+            }
+            else {
+                progress.update(pipelineStep, msg.trim());
+            }
         }, incrementalContext);
     }
     catch (err) {
@@ -196,8 +224,8 @@ export async function handleAnalyze(options) {
         }
         return;
     }
-    console.log();
     // 4. Convert to analysis.json format and write
+    progress.update(5, "Merging results...");
     const analysis = buildAnalysisFromStatic(result, rootDir);
     const duration = Date.now() - startTime;
     // Stamp scan metadata on analysis.json (backward compat)
@@ -215,8 +243,9 @@ export async function handleAnalyze(options) {
     const spec = staticResultToSpec(result, rootDir, existingSpec?.rules);
     writeSpec(rootDir, spec);
     writeScanMetadata(rootDir, duration, "pipeline", ctx.fileTree.totalFiles, result.tokenUsage);
-    console.log(chalk.green(`Saved spec to: .archbyte/archbyte.yaml`));
+    progress.update(6, "Generating diagram...");
     await autoGenerate(rootDir, options);
+    progress.done("Analysis complete");
     // Record usage (best-effort, non-blocking)
     recordUsage({
         projectName: path.basename(rootDir),
@@ -269,8 +298,6 @@ function writeScanMetadata(rootDir, durationMs, mode, filesScanned, tokenUsage)
     writeMetadata(rootDir, meta);
 }
 async function autoGenerate(rootDir, options) {
-    console.log();
-    console.log(chalk.gray("Generating architecture diagram..."));
     const analysisPath = path.join(rootDir, ".archbyte", "analysis.json");
     try {
         const { handleGenerate } = await import("./generate.js");

package/dist/cli/auth.js

@@ -51,8 +51,8 @@ export async function handleLogin(provider) {
         console.error(chalk.red(`Login failed: ${err instanceof Error ? err.message : "Unknown error"}`));
         console.log();
         console.log(chalk.gray("You can also log in manually:"));
-        console.log(chalk.gray(`  1. Visit ${API_BASE.replace("api.", "")}/auth`));
-        console.log(chalk.gray("  2. Copy your token"));
+        console.log(chalk.gray("  1. Visit https://archbyte.heartbyte.io"));
+        console.log(chalk.gray("  2. Sign in and copy your token from the dashboard"));
         console.log(chalk.gray("  3. Run: archbyte login --token <your-token>"));
         process.exit(1);
     }
@@ -326,7 +326,11 @@ function startOAuthFlow(provider = "github") {
         const server = http.createServer(async (req, res) => {
             const url = new URL(req.url ?? "/", `http://localhost:${CLI_CALLBACK_PORT}`);
             if (url.pathname === "/callback") {
-                const token = url.searchParams.get("token");
+                // Extract token from raw query string, not URLSearchParams
+                // (URLSearchParams decodes '+' as space per x-www-form-urlencoded, corrupting JWT signatures)
+                const rawQuery = (req.url ?? "").split("?")[1] ?? "";
+                const tokenMatch = rawQuery.match(/(?:^|&)token=([^&]+)/);
+                const token = tokenMatch ? decodeURIComponent(tokenMatch[1]) : null;
                 if (!token) {
                     res.writeHead(400, { "Content-Type": "text/html" });
                     res.end("<h1>Login failed</h1><p>No token received. Close this window and try again.</p>");
@@ -342,7 +346,8 @@ function startOAuthFlow(provider = "github") {
                         headers: { Authorization: `Bearer ${token}` },
                     });
                     if (!meRes.ok) {
-                        reject(new Error("Failed to fetch user info"));
+                        const errBody = await meRes.text().catch(() => "");
+                        reject(new Error(`Failed to fetch user info (${meRes.status}: ${errBody})`));
                         return;
                     }
                     const { user } = (await meRes.json());

package/dist/cli/config.js

@@ -73,6 +73,9 @@ function showConfig() {
     }
     console.log(`  ${chalk.bold("provider")}: ${config.provider ?? chalk.gray("not set")}`);
     console.log(`  ${chalk.bold("api-key")}:  ${config.apiKey ? maskKey(config.apiKey) : chalk.gray("not set")}`);
+    if (config.model) {
+        console.log(`  ${chalk.bold("model")}:    ${config.model}`);
+    }
     if (config.ollamaBaseUrl) {
         console.log(`  ${chalk.bold("ollama-url")}: ${config.ollamaBaseUrl}`);
     }
@@ -86,7 +89,13 @@ function setConfig(key, value) {
                 console.error(chalk.red(`Invalid provider: ${value}. Must be: ${VALID_PROVIDERS.join(", ")}`));
                 process.exit(1);
             }
+            const oldProvider = config.provider;
             config.provider = value;
+            // Clear model override when switching providers — model names are provider-specific
+            if (oldProvider && oldProvider !== value && config.model) {
+                delete config.model;
+                console.log(chalk.yellow(`Cleared model override (was for ${oldProvider})`));
+            }
             break;
         }
         case "api-key":
@@ -94,13 +103,22 @@ function setConfig(key, value) {
         case "key":
             config.apiKey = value;
             break;
+        case "model":
+            if (value === "" || value === "default") {
+                delete config.model;
+                saveConfig(config);
+                console.log(chalk.green("Cleared model override (will use provider defaults)"));
+                return;
+            }
+            config.model = value;
+            break;
         case "ollama-url":
         case "ollamaUrl":
             config.ollamaBaseUrl = value;
             break;
         default:
             console.error(chalk.red(`Unknown config key: ${key}`));
-            console.error(chalk.gray("  Valid keys: provider, api-key, ollama-url"));
+            console.error(chalk.gray("  Valid keys: provider, api-key, model, ollama-url"));
             process.exit(1);
     }
     saveConfig(config);
@@ -117,6 +135,9 @@ function getConfig(key) {
         case "key":
             console.log(config.apiKey ?? "");
             break;
+        case "model":
+            console.log(config.model ?? "");
+            break;
         case "ollama-url":
         case "ollamaUrl":
             console.log(config.ollamaBaseUrl ?? "");
@@ -162,6 +183,7 @@ export function resolveConfig() {
         return {
             provider: "ollama",
             apiKey: "",
+            model: process.env.ARCHBYTE_MODEL ?? config.model,
             ollamaBaseUrl: process.env.OLLAMA_BASE_URL ??
                 config.ollamaBaseUrl ??
                 "http://localhost:11434",
@@ -172,6 +194,7 @@ export function resolveConfig() {
     return {
         provider,
         apiKey,
+        model: process.env.ARCHBYTE_MODEL ?? config.model,
         ollamaBaseUrl: config.ollamaBaseUrl,
     };
 }

package/dist/cli/generate.js

@@ -3,6 +3,7 @@ import * as fs from "fs";
 import chalk from "chalk";
 import { generateArchitecture } from "../server/src/generator/index.js";
 import { loadSpec, specToAnalysis } from "./yaml-io.js";
+import { spinner } from "./ui.js";
 /**
  * Generate excalidraw diagram from analysis JSON
  */
@@ -117,6 +118,7 @@ export async function handleGenerate(options) {
             },
         };
         // Generate diagram
+        const sp = spinner("Generating diagram");
         const diagram = generateArchitecture(project);
         // Determine output path
         const outputPath = options.output || path.join(rootDir, ".archbyte", "architecture.json");
@@ -213,7 +215,7 @@ export async function handleGenerate(options) {
         }
         // Write diagram
         fs.writeFileSync(outputPath, JSON.stringify(diagram, null, 2), "utf-8");
-        console.log(chalk.green("✓ Diagram generated successfully!"));
+        sp.stop("done");
         console.log();
         console.log(chalk.bold("Summary:"));
         console.log(chalk.gray(`  Components: ${analysis.components.length}`));

package/dist/cli/run.d.ts

@@ -5,6 +5,7 @@ interface RunOptions {
     apiKey?: string;
     port?: number;
     verbose?: boolean;
+    force?: boolean;
     dryRun?: boolean;
 }
 export declare function handleRun(options: RunOptions): Promise<void>;

package/dist/cli/run.js

@@ -13,6 +13,7 @@ export async function handleRun(options) {
         skipLlm: options.skipLlm,
         provider: options.provider,
         apiKey: options.apiKey,
+        force: options.force,
         dryRun: options.dryRun,
     });
     if (options.dryRun)

package/dist/cli/setup.js

@@ -2,7 +2,7 @@ import * as fs from "fs";
 import * as path from "path";
 import { fileURLToPath } from "url";
 import chalk from "chalk";
-import { resolveModel, MODEL_MAP } from "../agents/runtime/types.js";
+import { resolveModel } from "../agents/runtime/types.js";
 import { createProvider } from "../agents/providers/router.js";
 import { select, spinner, confirm } from "./ui.js";
 const __filename = fileURLToPath(import.meta.url);
@@ -75,6 +75,21 @@ function askHidden(prompt) {
         stdin.on("data", onData);
     });
 }
+async function fetchOllamaModels(baseUrl) {
+    try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 5000);
+        const res = await fetch(`${baseUrl}/api/tags`, { signal: controller.signal });
+        clearTimeout(timeout);
+        if (!res.ok)
+            return [];
+        const data = await res.json();
+        return (data.models ?? []).map((m) => m.name);
+    }
+    catch {
+        return [];
+    }
+}
 async function validateProviderSilent(providerName, apiKey, ollamaBaseUrl) {
     try {
         if (providerName === "ollama") {
@@ -86,30 +101,7 @@ async function validateProviderSilent(providerName, apiKey, ollamaBaseUrl) {
                 clearTimeout(timeout);
                 if (!res.ok)
                     return false;
-                // Check installed models
-                try {
-                    const tagsController = new AbortController();
-                    const tagsTimeout = setTimeout(() => tagsController.abort(), 5000);
-                    const tagsRes = await fetch(`${url}/api/tags`, { signal: tagsController.signal });
-                    clearTimeout(tagsTimeout);
-                    if (tagsRes.ok) {
-                        const data = await tagsRes.json();
-                        const installedModels = (data.models ?? []).map((m) => m.name.split(":")[0]);
-                        const requiredModels = Object.values(MODEL_MAP.ollama);
-                        const uniqueRequired = [...new Set(requiredModels)];
-                        const compatible = uniqueRequired.filter((m) => installedModels.some((installed) => installed === m));
-                        if (compatible.length > 0) {
-                            console.log(chalk.gray(`  Compatible models: ${compatible.join(", ")}`));
-                        }
-                        else {
-                            console.log(chalk.yellow(`  Warning: no compatible models found.`));
-                            console.log(chalk.gray(`  Run: ollama pull ${uniqueRequired[0]}`));
-                        }
-                    }
-                }
-                catch {
-                    // Model check is best-effort
-                }
+                // Model listing happens in setup flow, not here
                 return true;
             }
             catch {
@@ -153,12 +145,27 @@ export async function handleSetup() {
     config.provider = provider;
     const selected = PROVIDERS[idx];
     console.log(chalk.green(`\n  ✓ Provider: ${selected.label}`));
-    // Step 2: API key (skip for Ollama)
+    // Step 2: API key / model selection
     if (provider === "ollama") {
         config.ollamaBaseUrl = config.ollamaBaseUrl ?? "http://localhost:11434";
         console.log(chalk.gray(`  Ollama URL: ${config.ollamaBaseUrl}`));
+        // Let user pick from installed models
+        const models = await fetchOllamaModels(config.ollamaBaseUrl);
+        if (models.length > 0) {
+            const modelIdx = await select("\n  Choose a model:", models.map((m) => m));
+            config.model = models[modelIdx];
+            console.log(chalk.green(`  ✓ Model: ${config.model}`));
+        }
+        else {
+            console.log(chalk.yellow(`  Warning: no models installed.`));
+            console.log(chalk.gray(`  Run: ollama pull <model-name>`));
+        }
     }
     else {
+        // Clear Ollama model override — model names are provider-specific
+        if (config.model) {
+            delete config.model;
+        }
         console.log();
         const apiKey = await askHidden(chalk.bold("  API key: "));
         if (!apiKey) {

package/dist/cli/ui.d.ts

@@ -10,6 +10,16 @@ export declare function spinner(label: string): Spinner;
  * Non-TTY fallback: returns 0 (first option).
  */
 export declare function select(prompt: string, options: string[]): Promise<number>;
+interface ProgressBar {
+    update(step: number, label: string): void;
+    done(label?: string): void;
+}
+/**
+ * Step-based progress bar with elapsed time.
+ * Renders: ▓▓▓▓▓▓▓▓░░░░░░░░░░░░ 45% │ Running agents... (12.3s)
+ * Falls back to simple log lines when not a TTY.
+ */
+export declare function progressBar(totalSteps: number): ProgressBar;
 /**
  * Y/n confirmation prompt. Returns true for y/Enter, false for n.
  * Non-TTY fallback: returns true.

package/dist/cli/ui.js

@@ -105,6 +105,50 @@ export function select(prompt, options) {
         stdin.on("data", onData);
     });
 }
+/**
+ * Step-based progress bar with elapsed time.
+ * Renders: ▓▓▓▓▓▓▓▓░░░░░░░░░░░░ 45% │ Running agents... (12.3s)
+ * Falls back to simple log lines when not a TTY.
+ */
+export function progressBar(totalSteps) {
+    const startTime = Date.now();
+    let lastLabel = "";
+    function elapsed() {
+        return ((Date.now() - startTime) / 1000).toFixed(1);
+    }
+    if (!process.stdout.isTTY) {
+        return {
+            update(_step, label) {
+                if (label !== lastLabel) {
+                    console.log(`  [${elapsed()}s] ${label}`);
+                    lastLabel = label;
+                }
+            },
+            done(label) {
+                console.log(`  [${elapsed()}s] ${label ?? "Done"}`);
+            },
+        };
+    }
+    const BAR_WIDTH = 20;
+    function render(step, label) {
+        const pct = Math.min(Math.round((step / totalSteps) * 100), 100);
+        const filled = Math.round((step / totalSteps) * BAR_WIDTH);
+        const empty = BAR_WIDTH - filled;
+        const bar = chalk.cyan("▓".repeat(filled)) + chalk.gray("░".repeat(empty));
+        const pctStr = `${pct}%`.padStart(4);
+        process.stdout.write(`\r\x1b[K  ${bar} ${chalk.white(pctStr)} ${chalk.gray("│")} ${label} ${chalk.gray(`(${elapsed()}s)`)}`);
+    }
+    return {
+        update(step, label) {
+            lastLabel = label;
+            render(step, label);
+        },
+        done(label) {
+            render(totalSteps, label ?? "Done");
+            process.stdout.write("\n");
+        },
+    };
+}
 /**
  * Y/n confirmation prompt. Returns true for y/Enter, false for n.
  * Non-TTY fallback: returns true.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "archbyte",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "ArchByte - See what agents build. As they build it.",
   "type": "module",
   "bin": {