ridgeline 0.7.21 → 0.8.2

package/dist/ui/dashboard/watcher.js

@@ -0,0 +1,238 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.watchAppend = exports.watchJson = void 0;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const watchFileByDirectory = (filePath, onChange) => {
+    try {
+        const dir = path.dirname(filePath);
+        const base = path.basename(filePath);
+        const w = fs.watch(dir, { persistent: false }, (_event, fname) => {
+            if (!fname)
+                return;
+            if (fname !== base)
+                return;
+            onChange();
+        });
+        w.on("error", () => { });
+        return w;
+    }
+    catch {
+        return null;
+    }
+};
+const watchJson = (filePath, onChange, debounceMs = 50) => {
+    let last = null;
+    let watcher = null;
+    let dirWatcher = null;
+    let timer = null;
+    const readFile = () => {
+        try {
+            const raw = fs.readFileSync(filePath, "utf-8");
+            return { raw, parsed: JSON.parse(raw) };
+        }
+        catch {
+            return null;
+        }
+    };
+    const flush = () => {
+        const result = readFile();
+        if (!result)
+            return;
+        if (result.raw === last)
+            return;
+        last = result.raw;
+        onChange(result.parsed);
+    };
+    const schedule = () => {
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(flush, debounceMs);
+    };
+    const attachFileWatcher = () => {
+        if (watcher)
+            return;
+        try {
+            watcher = fs.watch(filePath, { persistent: false }, () => schedule());
+            watcher.on("error", () => { detachFileWatcher(); });
+        }
+        catch {
+            // File doesn't exist yet — dir watcher will catch creation
+        }
+    };
+    const detachFileWatcher = () => {
+        if (!watcher)
+            return;
+        try {
+            watcher.close();
+        }
+        catch { /* ignore */ }
+        watcher = null;
+    };
+    return {
+        read: () => {
+            const r = readFile();
+            if (r)
+                last = r.raw;
+            return r ? r.parsed : null;
+        },
+        start: () => {
+            const initial = readFile();
+            if (initial)
+                last = initial.raw;
+            dirWatcher = watchFileByDirectory(filePath, () => {
+                attachFileWatcher();
+                schedule();
+            });
+            attachFileWatcher();
+        },
+        stop: () => {
+            if (timer) {
+                clearTimeout(timer);
+                timer = null;
+            }
+            detachFileWatcher();
+            if (dirWatcher) {
+                try {
+                    dirWatcher.close();
+                }
+                catch { /* ignore */ }
+                dirWatcher = null;
+            }
+        },
+    };
+};
+exports.watchJson = watchJson;
+const watchAppend = (filePath, onLines) => {
+    let offset = 0;
+    let watcher = null;
+    let dirWatcher = null;
+    const attachFileWatcher = () => {
+        if (watcher)
+            return;
+        try {
+            watcher = fs.watch(filePath, { persistent: false }, () => flush());
+            watcher.on("error", () => {
+                try {
+                    watcher?.close();
+                }
+                catch { /* ignore */ }
+                watcher = null;
+            });
+        }
+        catch {
+            // file doesn't exist yet
+        }
+    };
+    const readAppended = () => {
+        let stat;
+        try {
+            stat = fs.statSync(filePath);
+        }
+        catch {
+            return [];
+        }
+        if (stat.size < offset) {
+            // truncated — reset
+            offset = 0;
+        }
+        if (stat.size === offset)
+            return [];
+        let buf;
+        let fd;
+        try {
+            fd = fs.openSync(filePath, "r");
+        }
+        catch {
+            return [];
+        }
+        try {
+            const length = stat.size - offset;
+            buf = Buffer.alloc(length);
+            fs.readSync(fd, buf, 0, length, offset);
+        }
+        finally {
+            try {
+                fs.closeSync(fd);
+            }
+            catch { /* ignore */ }
+        }
+        offset = stat.size;
+        const text = buf.toString("utf-8");
+        return text.split("\n").filter((l) => l.length > 0);
+    };
+    const flush = () => {
+        const lines = readAppended();
+        if (lines.length > 0)
+            onLines(lines);
+    };
+    return {
+        start: () => {
+            try {
+                const stat = fs.statSync(filePath);
+                offset = stat.size;
+            }
+            catch {
+                offset = 0;
+            }
+            dirWatcher = watchFileByDirectory(filePath, () => {
+                attachFileWatcher();
+                flush();
+            });
+            attachFileWatcher();
+        },
+        stop: () => {
+            if (watcher) {
+                try {
+                    watcher.close();
+                }
+                catch { /* ignore */ }
+                watcher = null;
+            }
+            if (dirWatcher) {
+                try {
+                    dirWatcher.close();
+                }
+                catch { /* ignore */ }
+                dirWatcher = null;
+            }
+        },
+        offset: () => offset,
+        readAppended,
+    };
+};
+exports.watchAppend = watchAppend;
+//# sourceMappingURL=watcher.js.map

package/dist/ui/dashboard/watcher.js.map

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

package/dist/ui/output.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.printPhaseHeader = exports.printPhase = exports.printError = exports.printWarn = exports.printInfo = void 0;
 const logger_1 = require("./logger");
 const transcript_1 = require("./transcript");
+const color_1 = require("./color");
 const printInfo = (msg) => {
     const line = `[ridgeline] ${msg}`;
     console.log(line);
@@ -11,14 +12,14 @@ const printInfo = (msg) => {
 };
 exports.printInfo = printInfo;
 const printWarn = (msg) => {
-    const line = `[ridgeline] WARN: ${msg}`;
+    const line = `[ridgeline] ${(0, color_1.warning)("WARN:", { stream: "stderr" })} ${msg}`;
     console.error(line);
     (0, logger_1.log)("warn", msg);
     (0, transcript_1.appendTranscript)(line);
 };
 exports.printWarn = printWarn;
 const printError = (msg) => {
-    const line = `[ridgeline] ERROR: ${msg}`;
+    const line = `[ridgeline] ${(0, color_1.error)("ERROR:", { stream: "stderr" })} ${msg}`;
     console.error(line);
     (0, logger_1.log)("error", msg);
     (0, transcript_1.appendTranscript)(line);

package/dist/ui/output.js.map

@@ -1 +1 @@
-{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/ui/output.ts"],"names":[],"mappings":";;;AAAA,qCAA8B;AAC9B,6CAA+C;AAExC,MAAM,SAAS,GAAG,CAAC,GAAW,EAAQ,EAAE;IAC7C,MAAM,IAAI,GAAG,eAAe,GAAG,EAAE,CAAA;IACjC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACjB,IAAA,YAAG,EAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAChB,IAAA,6BAAgB,EAAC,IAAI,CAAC,CAAA;AACxB,CAAC,CAAA;AALY,QAAA,SAAS,aAKrB;AAEM,MAAM,SAAS,GAAG,CAAC,GAAW,EAAQ,EAAE;IAC7C,MAAM,IAAI,GAAG,qBAAqB,GAAG,EAAE,CAAA;IACvC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACnB,IAAA,YAAG,EAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAChB,IAAA,6BAAgB,EAAC,IAAI,CAAC,CAAA;AACxB,CAAC,CAAA;AALY,QAAA,SAAS,aAKrB;AAEM,MAAM,UAAU,GAAG,CAAC,GAAW,EAAQ,EAAE;IAC9C,MAAM,IAAI,GAAG,sBAAsB,GAAG,EAAE,CAAA;IACxC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACnB,IAAA,YAAG,EAAC,OAAO,EAAE,GAAG,CAAC,CAAA;IACjB,IAAA,6BAAgB,EAAC,IAAI,CAAC,CAAA;AACxB,CAAC,CAAA;AALY,QAAA,UAAU,cAKtB;AAEM,MAAM,UAAU,GAAG,CAAC,OAAe,EAAE,GAAW,EAAQ,EAAE;IAC/D,MAAM,IAAI,GAAG,gBAAgB,OAAO,KAAK,GAAG,EAAE,CAAA;IAC9C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACjB,IAAA,YAAG,EAAC,MAAM,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;IACpC,IAAA,6BAAgB,EAAC,IAAI,CAAC,CAAA;AACxB,CAAC,CAAA;AALY,QAAA,UAAU,cAKtB;AAEM,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAE,KAAa,EAAE,OAAe,EAAQ,EAAE;IACtF,MAAM,IAAI,GAAG,iBAAiB,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,KAAK,IAAI,KAAK,KAAK,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA;IAClG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACjB,IAAA,YAAG,EAAC,MAAM,EAAE,SAAS,KAAK,IAAI,KAAK,KAAK,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;IACtE,IAAA,6BAAgB,EAAC,IAAI,CAAC,CAAA;AACxB,CAAC,CAAA;AALY,QAAA,gBAAgB,oBAK5B"}
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/ui/output.ts"],"names":[],"mappings":";;;AAAA,qCAA8B;AAC9B,6CAA+C;AAC/C,mCAAwC;AAEjC,MAAM,SAAS,GAAG,CAAC,GAAW,EAAQ,EAAE;IAC7C,MAAM,IAAI,GAAG,eAAe,GAAG,EAAE,CAAA;IACjC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACjB,IAAA,YAAG,EAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAChB,IAAA,6BAAgB,EAAC,IAAI,CAAC,CAAA;AACxB,CAAC,CAAA;AALY,QAAA,SAAS,aAKrB;AAEM,MAAM,SAAS,GAAG,CAAC,GAAW,EAAQ,EAAE;IAC7C,MAAM,IAAI,GAAG,eAAe,IAAA,eAAO,EAAC,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,GAAG,EAAE,CAAA;IAC3E,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACnB,IAAA,YAAG,EAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAChB,IAAA,6BAAgB,EAAC,IAAI,CAAC,CAAA;AACxB,CAAC,CAAA;AALY,QAAA,SAAS,aAKrB;AAEM,MAAM,UAAU,GAAG,CAAC,GAAW,EAAQ,EAAE;IAC9C,MAAM,IAAI,GAAG,eAAe,IAAA,aAAK,EAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,GAAG,EAAE,CAAA;IAC1E,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACnB,IAAA,YAAG,EAAC,OAAO,EAAE,GAAG,CAAC,CAAA;IACjB,IAAA,6BAAgB,EAAC,IAAI,CAAC,CAAA;AACxB,CAAC,CAAA;AALY,QAAA,UAAU,cAKtB;AAEM,MAAM,UAAU,GAAG,CAAC,OAAe,EAAE,GAAW,EAAQ,EAAE;IAC/D,MAAM,IAAI,GAAG,gBAAgB,OAAO,KAAK,GAAG,EAAE,CAAA;IAC9C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACjB,IAAA,YAAG,EAAC,MAAM,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;IACpC,IAAA,6BAAgB,EAAC,IAAI,CAAC,CAAA;AACxB,CAAC,CAAA;AALY,QAAA,UAAU,cAKtB;AAEM,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAE,KAAa,EAAE,OAAe,EAAQ,EAAE;IACtF,MAAM,IAAI,GAAG,iBAAiB,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,KAAK,IAAI,KAAK,KAAK,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA;IAClG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACjB,IAAA,YAAG,EAAC,MAAM,EAAE,SAAS,KAAK,IAAI,KAAK,KAAK,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;IACtE,IAAA,6BAAgB,EAAC,IAAI,CAAC,CAAA;AACxB,CAAC,CAAA;AALY,QAAA,gBAAgB,oBAK5B"}

package/dist/ui/preflight.d.ts

@@ -0,0 +1,21 @@
+import type { DetectionReport } from "../engine/detect";
+export interface StablePromptInfo {
+    tokens: number;
+    model: string;
+}
+export interface PreflightOptions {
+    yes: boolean;
+    isTTY: boolean;
+    stream?: NodeJS.WritableStream;
+    input?: NodeJS.ReadableStream;
+    isPlaywrightResolvable?: () => boolean;
+    stablePromptInfo?: StablePromptInfo;
+}
+export declare const renderPreflight: (report: DetectionReport, opts: {
+    isTTY: boolean;
+    yes: boolean;
+    isStderrTTY?: boolean;
+    isPlaywrightResolvable?: () => boolean;
+    stablePromptInfo?: StablePromptInfo;
+}) => string;
+export declare const runPreflight: (report: DetectionReport, opts: PreflightOptions) => Promise<void>;

package/dist/ui/preflight.js

@@ -0,0 +1,159 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPreflight = exports.renderPreflight = void 0;
+const readline = __importStar(require("node:readline"));
+const color_1 = require("./color");
+const stable_prompt_1 = require("../engine/claude/stable.prompt");
+const PLAYWRIGHT_INSTALL_HINT = "npm install --save-dev playwright && npx playwright install chromium";
+const defaultIsPlaywrightResolvable = () => {
+    try {
+        require.resolve("playwright");
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const SENSOR_DISPLAY = {
+    playwright: "Playwright",
+    vision: "vision",
+    a11y: "pa11y",
+    contrast: "contrast",
+};
+const formatDetected = (report) => {
+    const parts = [];
+    for (const dep of report.detectedDeps)
+        parts.push(dep);
+    if (report.hasDesignMd)
+        parts.push("design.md");
+    if (report.hasAssetDir)
+        parts.push("assets");
+    return parts.length > 0 ? parts.join(", ") : "no project signals";
+};
+const formatEnabling = (report) => {
+    if (report.suggestedSensors.length === 0)
+        return "no sensors";
+    return report.suggestedSensors.map((s) => SENSOR_DISPLAY[s]).join(", ");
+};
+const renderPreflight = (report, opts) => {
+    const stream = "stdout";
+    const detected = formatDetected(report);
+    const enabling = formatEnabling(report);
+    const ensembleSize = report.suggestedEnsembleSize;
+    const ensembleHint = ensembleSize === 2 ? "   (use --thorough for 3)" : "";
+    const lines = [];
+    // Block 1: detection
+    lines.push([
+        (0, color_1.bold)("Detected", { stream }),
+        "   ",
+        (0, color_1.hint)(detected, { stream }),
+        "   ",
+        (0, color_1.dimInfo)("→", { stream }),
+        "   ",
+        (0, color_1.bold)("enabling", { stream }),
+        "   ",
+        (0, color_1.hint)(enabling, { stream }),
+    ].join(""));
+    // Blank separator
+    lines.push("");
+    // Block 2: ensemble + caching (labels padded so values align at column 11)
+    const ensembleLine = [
+        (0, color_1.bold)("Ensemble", { stream }),
+        "   ",
+        (0, color_1.hint)(`${ensembleSize} specialists`, { stream }),
+    ];
+    if (ensembleHint)
+        ensembleLine.push((0, color_1.hint)(ensembleHint, { stream }));
+    lines.push(ensembleLine.join(""));
+    lines.push([
+        (0, color_1.bold)("Caching", { stream }),
+        "    ",
+        (0, color_1.hint)("on", { stream }),
+    ].join(""));
+    const resolver = opts.isPlaywrightResolvable ?? defaultIsPlaywrightResolvable;
+    if (report.isVisualSurface && !resolver()) {
+        lines.push("");
+        lines.push([
+            (0, color_1.warning)("Playwright not installed", { stream }),
+            (0, color_1.hint)(" — visual surface detected; install with: ", { stream }),
+            PLAYWRIGHT_INSTALL_HINT,
+        ].join(""));
+    }
+    if (opts.stablePromptInfo) {
+        const threshold = (0, stable_prompt_1.minCacheableTokens)(opts.stablePromptInfo.model);
+        if (opts.stablePromptInfo.tokens < threshold) {
+            lines.push("");
+            lines.push([
+                (0, color_1.warning)("Caching skipped", { stream }),
+                (0, color_1.hint)(` — stable prompt ~${opts.stablePromptInfo.tokens} tokens under ${threshold}-token minimum; upstream will skip the cache`, { stream }),
+            ].join(""));
+        }
+    }
+    if (!opts.isTTY) {
+        lines.push((0, color_1.hint)("(auto-proceeding in CI)", { stream }));
+    }
+    else if (!opts.yes) {
+        lines.push((0, color_1.hint)("  Press Enter to continue, Ctrl+C to abort", { stream }));
+    }
+    return lines.join("\n") + "\n";
+};
+exports.renderPreflight = renderPreflight;
+const waitForEnter = (input) => new Promise((resolve) => {
+    const rl = readline.createInterface({ input, terminal: false });
+    rl.once("line", () => {
+        rl.close();
+        resolve();
+    });
+    rl.once("close", () => resolve());
+});
+const runPreflight = async (report, opts) => {
+    const stream = opts.stream ?? process.stdout;
+    const rendered = (0, exports.renderPreflight)(report, {
+        isTTY: opts.isTTY,
+        yes: opts.yes,
+        isPlaywrightResolvable: opts.isPlaywrightResolvable,
+        stablePromptInfo: opts.stablePromptInfo,
+    });
+    stream.write(rendered);
+    if (!opts.isTTY)
+        return;
+    if (opts.yes)
+        return;
+    const input = opts.input ?? process.stdin;
+    await waitForEnter(input);
+};
+exports.runPreflight = runPreflight;
+//# sourceMappingURL=preflight.js.map

package/dist/ui/preflight.js.map

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

package/dist/ui/spinner.d.ts

@@ -12,10 +12,4 @@ export interface Spinner {
 }
 export declare const pickVerb: () => string;
 export declare const formatElapsed: (ms: number) => string;
-/**
- * Start a bouncing-bar spinner on stderr with an optional verb label.
- *
- * The spinner writes to stderr so it never contaminates captured stdout.
- * Calling `stop()` clears the line and restores the cursor.
- */
 export declare const startSpinner: (verb?: string) => Spinner;

package/dist/ui/spinner.js

@@ -5,6 +5,7 @@
 //   [=   ] → [==  ] → … → [  ==] → [   =] → [  ==] → … → [=   ] (ping-pong)
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.startSpinner = exports.formatElapsed = exports.pickVerb = void 0;
+const color_1 = require("./color");
 const FRAMES = [
     "[=   ]",
     "[==  ]",
@@ -85,11 +86,30 @@ exports.formatElapsed = formatElapsed;
  * The spinner writes to stderr so it never contaminates captured stdout.
  * Calling `stop()` clears the line and restores the cursor.
  */
+// Only one live spinner per process at a time. Parallel-wave builds create
+// concurrent spinners that would otherwise fight for ownership of stderr.
+let spinnerActive = false;
+const noopSpinner = {
+    stop() { },
+    pause() { },
+    resume() { },
+    setDetail() { },
+    printAbove() { },
+};
 const startSpinner = (verb) => {
     // If stderr is not a TTY (e.g. piped to a file), skip animation entirely.
     if (!process.stderr.isTTY) {
-        return { stop() { }, pause() { }, resume() { }, setDetail() { }, printAbove() { } };
+        return noopSpinner;
+    }
+    // Explicit opt-out for debugging or CI.
+    if (process.env.RIDGELINE_NO_SPINNER === "1") {
+        return noopSpinner;
+    }
+    // Another spinner already owns stderr — silently yield so we don't trample it.
+    if (spinnerActive) {
+        return noopSpinner;
     }
+    spinnerActive = true;
     let frameIndex = 0;
     let direction = 1;
     let pauseFrames = 0;
@@ -101,9 +121,7 @@ const startSpinner = (verb) => {
         const frame = FRAMES[frameIndex];
         const elapsed = (0, exports.formatElapsed)(Date.now() - startTime);
         const suffix = detail ? ` [${detail}]` : "";
-        // \r moves cursor to start of line; the frame overwrites previous output.
-        // \x1b[K clears to end of line to avoid artifacts from longer previous lines.
-        process.stderr.write(`\r\x1b[K${frame} ${label}... (${elapsed})${suffix}`);
+        process.stderr.write(`${(0, color_1.clearLineSequence)()}${frame} ${label}... (${elapsed})${suffix}`);
         if (pauseFrames > 0) {
             pauseFrames--;
             return;
@@ -116,7 +134,7 @@ const startSpinner = (verb) => {
     };
     let timer = setInterval(tick, DEFAULT_INTERVAL_MS);
     const clearLine = () => {
-        process.stderr.write("\r\x1b[K");
+        process.stderr.write((0, color_1.clearLineSequence)());
     };
     return {
         stop() {
@@ -128,6 +146,7 @@ const startSpinner = (verb) => {
                 timer = null;
             }
             clearLine();
+            spinnerActive = false;
         },
         pause() {
             if (stopped || !timer)
@@ -148,7 +167,7 @@ const startSpinner = (verb) => {
             if (stopped || !timer)
                 return;
             clearLine();
-            process.stderr.write(`\x1b[90m${line}\x1b[0m\n`);
+            process.stderr.write(`${(0, color_1.hint)(line, { stream: "stderr" })}\n`);
             tick();
         },
     };

package/dist/ui/spinner.js.map

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

package/dist/ui/transcript.js

@@ -36,8 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.appendTranscript = exports.disableTranscript = exports.initTranscript = void 0;
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
-// eslint-disable-next-line no-control-regex
-const ANSI_PATTERN = /\x1b\[[0-9;]*m/g;
+const color_1 = require("./color");
 let transcriptFilePath = null;
 let isEnabled = true;
 /** Initialize the plain-text transcript. Call once when buildDir is known. */
@@ -58,7 +57,7 @@ exports.disableTranscript = disableTranscript;
 const appendTranscript = (text) => {
     if (!isEnabled || !transcriptFilePath)
         return;
-    const stripped = text.replace(ANSI_PATTERN, "");
+    const stripped = (0, color_1.stripAnsi)(text);
     const withNewline = stripped.endsWith("\n") ? stripped : stripped + "\n";
     try {
         fs.appendFileSync(transcriptFilePath, withNewline);

package/dist/ui/transcript.js.map

@@ -1 +1 @@
-{"version":3,"file":"transcript.js","sourceRoot":"","sources":["../../src/ui/transcript.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4CAA6B;AAC7B,gDAAiC;AAEjC,4CAA4C;AAC5C,MAAM,YAAY,GAAG,iBAAiB,CAAA;AAEtC,IAAI,kBAAkB,GAAkB,IAAI,CAAA;AAC5C,IAAI,SAAS,GAAG,IAAI,CAAA;AAEpB,8EAA8E;AACvE,MAAM,cAAc,GAAG,CAAC,QAAgB,EAAQ,EAAE;IACvD,kBAAkB,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAA;AAC5D,CAAC,CAAA;AAFY,QAAA,cAAc,kBAE1B;AAED,kCAAkC;AAC3B,MAAM,iBAAiB,GAAG,GAAS,EAAE;IAC1C,SAAS,GAAG,KAAK,CAAA;AACnB,CAAC,CAAA;AAFY,QAAA,iBAAiB,qBAE7B;AAED;;;;GAIG;AACI,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAQ,EAAE;IACrD,IAAI,CAAC,SAAS,IAAI,CAAC,kBAAkB;QAAE,OAAM;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAA;IAC/C,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAA;IACxE,IAAI,CAAC;QACH,EAAE,CAAC,cAAc,CAAC,kBAAkB,EAAE,WAAW,CAAC,CAAA;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,0DAA0D;IAC5D,CAAC;AACH,CAAC,CAAA;AATY,QAAA,gBAAgB,oBAS5B"}
+{"version":3,"file":"transcript.js","sourceRoot":"","sources":["../../src/ui/transcript.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4CAA6B;AAC7B,gDAAiC;AACjC,mCAAmC;AAEnC,IAAI,kBAAkB,GAAkB,IAAI,CAAA;AAC5C,IAAI,SAAS,GAAG,IAAI,CAAA;AAEpB,8EAA8E;AACvE,MAAM,cAAc,GAAG,CAAC,QAAgB,EAAQ,EAAE;IACvD,kBAAkB,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAA;AAC5D,CAAC,CAAA;AAFY,QAAA,cAAc,kBAE1B;AAED,kCAAkC;AAC3B,MAAM,iBAAiB,GAAG,GAAS,EAAE;IAC1C,SAAS,GAAG,KAAK,CAAA;AACnB,CAAC,CAAA;AAFY,QAAA,iBAAiB,qBAE7B;AAED;;;;GAIG;AACI,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAQ,EAAE;IACrD,IAAI,CAAC,SAAS,IAAI,CAAC,kBAAkB;QAAE,OAAM;IAC7C,MAAM,QAAQ,GAAG,IAAA,iBAAS,EAAC,IAAI,CAAC,CAAA;IAChC,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAA;IACxE,IAAI,CAAC;QACH,EAAE,CAAC,cAAc,CAAC,kBAAkB,EAAE,WAAW,CAAC,CAAA;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,0DAA0D;IAC5D,CAAC;AACH,CAAC,CAAA;AATY,QAAA,gBAAgB,oBAS5B"}

package/dist/utils/flavour-removed.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Detect the --flavour / --flavor flag in argv and return its value, or null
+ * if absent. Returns "" when --flavour appears with no following value.
+ */
+export declare const detectFlavourFlag: (argv: string[]) => string | null;
+export declare const flavourRemovedMessage: (flavourName: string) => string;
+/**
+ * Exit non-zero with a deprecation message when --flavour appears anywhere in
+ * argv. Wired at the top of cli.ts so every subcommand surfaces the same
+ * actionable error.
+ */
+export declare const enforceFlavourRemoved: (argv: string[]) => void;