duocode 1.2.1 → 1.3.0

package/dist/ui/diff_panel.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Live inline diff panel — renders a compact unified diff to the terminal
+ * immediately after a write_file or edit_file tool call, before the next
+ * model turn begins.
+ *
+ * Shows:
+ *   ┌─ executor: edit  src/auth/login.ts  (+24 -3) ──────────────────┐
+ *   │  + const token = jwt.sign(payload, secret, { expiresIn: '1h' })│
+ *   │  - const token = createToken(payload)                           │
+ *   └────────────────────────────────────────────────────────────────┘
+ */
+import type { FileChange } from "../tools/tool_types.js";
+/**
+ * Render a diff panel for a single file change and write it to stdout.
+ * Called from the agent loop's onToolCall hook.
+ */
+export declare function renderFileDiff(change: FileChange): void;
+/**
+ * Render a compact single-line tool action notification for non-write tools
+ * (read, search, command). Keeps the user informed without a full diff panel.
+ */
+export declare function renderToolAction(tool: string, summary: string): void;

package/dist/ui/diff_panel.js

@@ -0,0 +1,171 @@
+import { R, B, DM, GRN, RED, CYN, YLW, stripAnsi } from "./colors.js";
+const MAX_PANEL_LINES = 18; // max diff lines shown per file change
+const MAX_CONTEXT = 2; // unchanged context lines around each hunk
+function computeDiff(oldText, newText) {
+    const oldLines = oldText.split("\n");
+    const newLines = newText.split("\n");
+    // Simple LCS-based diff (good enough for the size of edits we render)
+    const m = oldLines.length;
+    const n = newLines.length;
+    // Build LCS table
+    const dp = Array.from({ length: m + 1 }, () => new Array(n + 1).fill(0));
+    for (let i = m - 1; i >= 0; i--) {
+        for (let j = n - 1; j >= 0; j--) {
+            if (oldLines[i] === newLines[j]) {
+                dp[i][j] = dp[i + 1][j + 1] + 1;
+            }
+            else {
+                dp[i][j] = Math.max(dp[i + 1][j], dp[i][j + 1]);
+            }
+        }
+    }
+    const result = [];
+    let i = 0;
+    let j = 0;
+    while (i < m || j < n) {
+        if (i < m && j < n && oldLines[i] === newLines[j]) {
+            result.push({ type: "ctx", text: oldLines[i] });
+            i++;
+            j++;
+        }
+        else if (j < n && (i >= m || dp[i][j + 1] >= dp[i + 1][j])) {
+            result.push({ type: "add", text: newLines[j] });
+            j++;
+        }
+        else {
+            result.push({ type: "del", text: oldLines[i] });
+            i++;
+        }
+    }
+    return result;
+}
+function extractHunks(diff, context) {
+    // Find indices of changed lines
+    const changed = new Set();
+    diff.forEach((line, i) => {
+        if (line.type !== "ctx")
+            changed.add(i);
+    });
+    // Expand with context window
+    const include = new Set();
+    for (const idx of changed) {
+        for (let k = Math.max(0, idx - context); k <= Math.min(diff.length - 1, idx + context); k++) {
+            include.add(k);
+        }
+    }
+    const result = [];
+    let prev = -2;
+    for (const idx of [...include].sort((a, b) => a - b)) {
+        if (idx > prev + 1)
+            result.push({ type: "ctx", text: "..." });
+        result.push(diff[idx]);
+        prev = idx;
+    }
+    return result;
+}
+// ── Rendering ────────────────────────────────────────────────────
+function stats(diff) {
+    let added = 0;
+    let deleted = 0;
+    for (const line of diff) {
+        if (line.type === "add")
+            added++;
+        if (line.type === "del")
+            deleted++;
+    }
+    return { added, deleted };
+}
+function truncateText(text, max) {
+    if (text.length <= max)
+        return text;
+    return text.slice(0, max - 1) + "…";
+}
+function renderDiffLine(line, innerWidth) {
+    const text = truncateText(line.text, innerWidth - 2);
+    switch (line.type) {
+        case "add": return `${GRN}+${R} ${GRN}${text}${R}`;
+        case "del": return `${RED}-${R} ${RED}${text}${R}`;
+        case "ctx":
+            if (text === "...")
+                return `${DM}  ···${R}`;
+            return `${DM}  ${truncateText(text, innerWidth - 2)}${R}`;
+    }
+}
+/**
+ * Render a diff panel for a single file change and write it to stdout.
+ * Called from the agent loop's onToolCall hook.
+ */
+export function renderFileDiff(change) {
+    if (!process.stdout.isTTY)
+        return;
+    const cols = process.stdout.columns ?? 80;
+    const innerWidth = cols - 4; // 2 chars border + 2 padding each side
+    const typeLabel = change.type === "create" ? "create" : "edit  ";
+    const filePath = change.filePath;
+    const typeColor = change.type === "create" ? GRN : CYN;
+    // ── Compute diff ─────────────────────────────────────────────
+    let diffLines = [];
+    let addCount = 0;
+    let delCount = 0;
+    if (change.oldContent !== null && change.newContent !== null) {
+        const raw = computeDiff(change.oldContent, change.newContent);
+        const s = stats(raw);
+        addCount = s.added;
+        delCount = s.deleted;
+        diffLines = extractHunks(raw, MAX_CONTEXT);
+    }
+    else if (change.newContent !== null) {
+        // New file — show first few lines
+        const lines = change.newContent.split("\n");
+        addCount = lines.length;
+        diffLines = lines.slice(0, MAX_PANEL_LINES).map((t) => ({ type: "add", text: t }));
+        if (lines.length > MAX_PANEL_LINES) {
+            diffLines.push({ type: "ctx", text: `... +${lines.length - MAX_PANEL_LINES} more lines` });
+        }
+    }
+    // Trim to max panel lines
+    if (diffLines.length > MAX_PANEL_LINES) {
+        diffLines = diffLines.slice(0, MAX_PANEL_LINES);
+        diffLines.push({ type: "ctx", text: `... (diff truncated)` });
+    }
+    // ── Header ────────────────────────────────────────────────────
+    const statsStr = (addCount > 0 ? `${GRN}+${addCount}${R}` : "") +
+        (addCount > 0 && delCount > 0 ? " " : "") +
+        (delCount > 0 ? `${RED}-${delCount}${R}` : "");
+    const headerLabel = `${DM}executor: ${R}${typeColor}${B}${typeLabel}${R}  ${B}${filePath}${R}  ${statsStr}`;
+    const headerVisible = stripAnsi(headerLabel);
+    const dashCount = Math.max(0, cols - headerVisible.length - 5);
+    const header = `${DM}┌─${R} ${headerLabel} ${DM}${"─".repeat(dashCount)}┐${R}`;
+    // ── Body ──────────────────────────────────────────────────────
+    const bodyLines = diffLines.map((dl) => {
+        const rendered = renderDiffLine(dl, innerWidth);
+        const visible = stripAnsi(rendered);
+        const pad = Math.max(0, innerWidth - visible.length);
+        return `${DM}│${R} ${rendered}${" ".repeat(pad)} ${DM}│${R}`;
+    });
+    // ── Footer ────────────────────────────────────────────────────
+    const footer = `${DM}└${"─".repeat(cols - 2)}┘${R}`;
+    // ── Output ────────────────────────────────────────────────────
+    process.stdout.write("\n");
+    process.stdout.write(header + "\n");
+    for (const line of bodyLines) {
+        process.stdout.write(line + "\n");
+    }
+    process.stdout.write(footer + "\n\n");
+}
+/**
+ * Render a compact single-line tool action notification for non-write tools
+ * (read, search, command). Keeps the user informed without a full diff panel.
+ */
+export function renderToolAction(tool, summary) {
+    if (!process.stdout.isTTY)
+        return;
+    const icon = tool === "run_command" ? `${YLW}⚙${R}` :
+        tool === "read_file" ? `${DM}↳${R}` :
+            tool === "list_directory" ? `${DM}↳${R}` :
+                tool === "search_files" ? `${CYN}⌕${R}` :
+                    tool === "glob_files" ? `${CYN}⌕${R}` :
+                        `${DM}·${R}`;
+    process.stdout.write(`  ${icon} ${DM}${summary}${R}\n`);
+}
+//# sourceMappingURL=diff_panel.js.map

package/dist/ui/diff_panel.js.map

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

package/dist/ui/neural_knot.d.ts

@@ -0,0 +1 @@
+export declare function runNeuralKnotBoot(): Promise<void>;

package/dist/ui/neural_knot.js

@@ -0,0 +1,131 @@
+import chalk from "chalk";
+import { VERSION } from "./banner.js";
+import { stripAnsi } from "./colors.js";
+const HELIX_FRAMES = [
+    { top: "  ◉══╲    ╱══◉  ", mid: "    ╲  ╳  ╱    ", bot: "  ◉══╱    ╲══◉  ", flat: "◉══╲    ╱══◉" },
+    { top: "   ◉══╲  ╱══◉   ", mid: "     ╲╱  ╲╱     ", bot: "   ◉══╱  ╲══◉   ", flat: "◉═══╲  ╱═══◉" },
+    { top: "    ◉══╲╱══◉    ", mid: "      ╳  ╳      ", bot: "    ◉══╱╲══◉    ", flat: "◉════╲╱════◉" },
+    { top: "   ◉══╱  ╲══◉   ", mid: "     ╱╲  ╱╲     ", bot: "   ◉══╲  ╱══◉   ", flat: "◉═══╱  ╲═══◉" },
+    { top: "  ◉══╱    ╲══◉  ", mid: "    ╱  ╳  ╲    ", bot: "  ◉══╲    ╱══◉  ", flat: "◉══╱    ╲══◉" },
+    { top: "   ◉══╱  ╲══◉   ", mid: "     ╱╲  ╱╲     ", bot: "   ◉══╲  ╱══◉   ", flat: "◉═══╱  ╲═══◉" },
+    { top: "    ◉══╱╲══◉    ", mid: "      ╳  ╳      ", bot: "    ◉══╲╱══◉    ", flat: "◉════╱╲════◉" },
+    { top: "   ◉══╲  ╱══◉   ", mid: "     ╲╱  ╲╱     ", bot: "   ◉══╱  ╲══◉   ", flat: "◉═══╲  ╱═══◉" },
+];
+const cyan = chalk.hex("#00F2FF");
+const magenta = chalk.hex("#7000FF");
+const mid = chalk.hex("#5e5e7a");
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+class HelixSpinner {
+    plainMode;
+    intervalMs;
+    index = 0;
+    timer = null;
+    rendered = false;
+    lastPlainWidth = 0;
+    text = "";
+    constructor(plainMode, intervalMs) {
+        this.plainMode = plainMode;
+        this.intervalMs = intervalMs;
+    }
+    start(text) {
+        this.text = text;
+        if (!this.plainMode) {
+            process.stdout.write("\x1b[?25l");
+        }
+        this.render();
+        this.timer = setInterval(() => this.render(), this.intervalMs);
+    }
+    update(text) {
+        this.text = text;
+        this.render();
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        if (!this.plainMode) {
+            process.stdout.write("\x1b[?25h");
+        }
+    }
+    persistDone(message) {
+        if (this.plainMode) {
+            const line = `OK  ${message}`;
+            const visible = stripAnsi(line).length;
+            const pad = Math.max(0, this.lastPlainWidth - visible);
+            process.stdout.write(`\r${line}${" ".repeat(pad)}\n`);
+            return;
+        }
+        const doneLine = `${chalk.hex("#00F2FF")("✔")} ${chalk.bold.white(message)}`;
+        if (this.rendered) {
+            process.stdout.write("\x1b[4F");
+            for (let i = 0; i < 3; i += 1) {
+                process.stdout.write("\x1b[2K\n");
+            }
+            process.stdout.write(`\x1b[2K${doneLine}\n`);
+            return;
+        }
+        process.stdout.write(`${doneLine}\n`);
+    }
+    render() {
+        const frame = HELIX_FRAMES[this.index % HELIX_FRAMES.length];
+        this.index += 1;
+        if (this.plainMode) {
+            const line = `${frame.flat} ${this.text}`;
+            const visible = stripAnsi(line).length;
+            const pad = Math.max(0, this.lastPlainWidth - visible);
+            process.stdout.write(`\r${line}${" ".repeat(pad)}`);
+            this.lastPlainWidth = visible;
+            return;
+        }
+        const lines = [
+            cyan(frame.top),
+            mid(frame.mid),
+            magenta(frame.bot),
+            chalk.white(this.text),
+        ];
+        if (this.rendered) {
+            process.stdout.write("\x1b[4F");
+        }
+        for (const line of lines) {
+            process.stdout.write(`\x1b[2K${line}\n`);
+        }
+        this.rendered = true;
+    }
+}
+export async function runNeuralKnotBoot() {
+    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+        return;
+    }
+    if (process.env.DUOCODE_NO_ANIM === "1") {
+        return;
+    }
+    const plainMode = process.env.DUOCODE_PLAIN_ANIM === "1"
+        || process.env.NO_COLOR === "1"
+        || process.env.TERM === "dumb"
+        || chalk.level === 0;
+    const title = `DUOCODE\nv${VERSION}`;
+    const fastBoot = process.env.DUOCODE_FAST_BOOT === "1";
+    process.stdout.write("\n");
+    process.stdout.write(`  ${title}\n\n`);
+    await sleep(fastBoot ? 120 : 280);
+    const spinner = new HelixSpinner(plainMode, 95);
+    try {
+        spinner.start("Agents synthesizing...");
+        await sleep(fastBoot ? 260 : 1300);
+        spinner.update(plainMode
+            ? "Intent Planner -> Code Builder"
+            : `${chalk.cyan("Intent Planner")} ${chalk.dim("->")} ${chalk.magenta("Code Builder")}`);
+        await sleep(fastBoot ? 280 : 1400);
+        spinner.update(plainMode ? "Merging reasoning paths..." : chalk.italic.gray("Merging reasoning paths..."));
+        await sleep(fastBoot ? 240 : 1000);
+    }
+    finally {
+        spinner.stop();
+    }
+    spinner.persistDone("Synthesis Complete.");
+    process.stdout.write("\n");
+}
+//# sourceMappingURL=neural_knot.js.map

package/dist/ui/neural_knot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"neural_knot.js","sourceRoot":"","sources":["../../src/ui/neural_knot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AASxC,MAAM,YAAY,GAAiB;IACjC,EAAE,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,iBAAiB,EAAE,GAAG,EAAE,kBAAkB,EAAE,IAAI,EAAE,cAAc,EAAE;IAClG,EAAE,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,kBAAkB,EAAE,IAAI,EAAE,cAAc,EAAE;IACnG,EAAE,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,kBAAkB,EAAE,IAAI,EAAE,cAAc,EAAE;IACnG,EAAE,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,kBAAkB,EAAE,IAAI,EAAE,cAAc,EAAE;IACnG,EAAE,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,iBAAiB,EAAE,GAAG,EAAE,kBAAkB,EAAE,IAAI,EAAE,cAAc,EAAE;IAClG,EAAE,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,kBAAkB,EAAE,IAAI,EAAE,cAAc,EAAE;IACnG,EAAE,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,kBAAkB,EAAE,IAAI,EAAE,cAAc,EAAE;IACnG,EAAE,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,kBAAkB,EAAE,IAAI,EAAE,cAAc,EAAE;CACpG,CAAC;AACF,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AAClC,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AACrC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AAEjC,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,YAAY;IAQG;IACA;IARX,KAAK,GAAG,CAAC,CAAC;IACV,KAAK,GAA0C,IAAI,CAAC;IACpD,QAAQ,GAAG,KAAK,CAAC;IACjB,cAAc,GAAG,CAAC,CAAC;IACnB,IAAI,GAAG,EAAE,CAAC;IAElB,YACmB,SAAkB,EAClB,UAAkB;QADlB,cAAS,GAAT,SAAS,CAAS;QAClB,eAAU,GAAV,UAAU,CAAQ;IAClC,CAAC;IAEJ,KAAK,CAAC,IAAY;QAChB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACpC,CAAC;QACD,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,CAAC,IAAY;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,WAAW,CAAC,OAAe;QACzB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,IAAI,GAAG,OAAO,OAAO,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;YACvC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,CAAC;YACvD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACtD,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7E,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YACpC,CAAC;YACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,QAAQ,IAAI,CAAC,CAAC;YAC7C,OAAO;QACT,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,IAAI,CAAC,CAAC;IACxC,CAAC;IAEO,MAAM;QACZ,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QAC7D,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;QAEhB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,IAAI,GAAG,GAAG,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC1C,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;YACvC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,CAAC;YACvD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACpD,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;YAC9B,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG;YACZ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;YACf,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC;YACd,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC;YAClB,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;SACvB,CAAC;QAEF,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAClC,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;IACvB,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClD,OAAO;IACT,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,GAAG,EAAE,CAAC;QACxC,OAAO;IACT,CAAC;IAED,MAAM,SAAS,GACb,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,GAAG;WACnC,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,GAAG;WAC5B,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,MAAM;WAC3B,KAAK,CAAC,KAAK,KAAK,CAAC,CAAC;IAEvB,MAAM,KAAK,GAAG,aAAa,OAAO,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,GAAG,CAAC;IAEvD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC;IACvC,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAElC,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAChD,IAAI,CAAC;QACH,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAExC,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,CAAC,MAAM,CAAC,SAAS;YACtB,CAAC,CAAC,gCAAgC;YAClC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;QAE3F,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC,CAAC;QAE3G,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,IAAI,EAAE,CAAC;IACjB,CAAC;IACD,OAAO,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC;IAE3C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}

package/dist/ui/plan_viewer.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="node" resolution-mode="require"/>
+import type { Interface as ReadlineInterface } from "node:readline/promises";
+/**
+ * Render the architect plan as a collapsible section viewer.
+ * Prompts the user to expand sections or proceed.
+ *
+ * @returns the ReviewFeedback (same shape as architect review callback)
+ */
+export declare function renderPlanWithFolding(plan: string, rl: ReadlineInterface | null, autoConfirm: boolean, log: (s: string) => void): Promise<{
+    action: "approve" | "revise" | "abort" | "discuss";
+    feedback?: string;
+}>;

package/dist/ui/plan_viewer.js

@@ -0,0 +1,117 @@
+import { R, B, DM, CYN, BLU } from "./colors.js";
+function parseSections(plan) {
+    const lines = plan.split("\n");
+    const sections = [];
+    let current = null;
+    for (const line of lines) {
+        if (/^#{1,3} /.test(line)) {
+            if (current)
+                sections.push(current);
+            current = { heading: line.replace(/^#+\s*/, ""), body: "" };
+        }
+        else if (current) {
+            current.body += line + "\n";
+        }
+    }
+    if (current)
+        sections.push(current);
+    return sections;
+}
+// ── Rendering ────────────────────────────────────────────────────
+function renderSection(section, idx, expanded) {
+    const num = `${CYN}[${idx + 1}]${R}`;
+    const heading = `${B}${section.heading}${R}`;
+    const header = `  ${num} ${heading}`;
+    if (!expanded)
+        return header;
+    const bodyLines = section.body.trim().split("\n");
+    const body = bodyLines
+        .map((l) => `      ${DM}${l}${R}`)
+        .join("\n");
+    return `${header}\n${body}`;
+}
+function printSections(sections, expanded, log) {
+    log(`\n  ${BLU}${B}Architect Plan${R} ${DM}(${sections.length} section${sections.length === 1 ? "" : "s"})${R}\n\n`);
+    for (let i = 0; i < sections.length; i++) {
+        log(renderSection(sections[i], i, expanded.has(i)) + "\n");
+    }
+    log("\n");
+}
+// ── Interactive folding viewer ───────────────────────────────────
+/**
+ * Render the architect plan as a collapsible section viewer.
+ * Prompts the user to expand sections or proceed.
+ *
+ * @returns the ReviewFeedback (same shape as architect review callback)
+ */
+export async function renderPlanWithFolding(plan, rl, autoConfirm, log) {
+    const sections = parseSections(plan);
+    // If no sections were found (no markdown headings), just show plan and ask
+    if (sections.length < 2) {
+        log(`\n${BLU}${B}Architect plan complete.${R}\n`);
+        log(`${DM}Review the plan above before proceeding to executor.${R}\n\n`);
+        if (autoConfirm || !rl)
+            return { action: "approve" };
+        const ans = await rl.question(`${CYN}Proceed: [Y]es / [v]iew / [r]evise / [d]iscuss / [n]o?${R} `);
+        return parseReviewAnswer(ans, plan, rl);
+    }
+    if (autoConfirm || !rl) {
+        return { action: "approve" };
+    }
+    const expanded = new Set();
+    printSections(sections, expanded, log);
+    log(`  ${DM}Type a section number to expand it, or:${R}\n`);
+    log(`  ${CYN}[Y]${R}${DM}es proceed  ${CYN}[r]${R}${DM}evise  ${CYN}[d]${R}${DM}iscuss  ${CYN}[n]${R}${DM}o abort${R}\n\n`);
+    while (true) {
+        const ans = await rl.question(`${CYN}Section / action:${R} `);
+        const trimmed = ans.trim().toLowerCase();
+        // Expand section
+        const num = parseInt(trimmed, 10);
+        if (!isNaN(num) && num >= 1 && num <= sections.length) {
+            expanded.add(num - 1);
+            printSections(sections, expanded, log);
+            continue;
+        }
+        // Actions
+        if (trimmed === "" || trimmed === "y" || trimmed === "yes")
+            return { action: "approve" };
+        if (trimmed === "n" || trimmed === "no")
+            return { action: "abort" };
+        if (trimmed === "r" || trimmed === "revise") {
+            const fb = await rl.question(`${CYN}Revision feedback: ${R}`);
+            return { action: "revise", feedback: fb.trim() };
+        }
+        if (trimmed === "d" || trimmed === "discuss") {
+            const q = await rl.question(`${CYN}Your question: ${R}`);
+            return { action: "discuss", feedback: q.trim() };
+        }
+        if (trimmed === "all") {
+            for (let i = 0; i < sections.length; i++)
+                expanded.add(i);
+            printSections(sections, expanded, log);
+            continue;
+        }
+        log(`${DM}Unknown input — type a number (1-${sections.length}), Y, r, d, or n.${R}\n`);
+    }
+}
+async function parseReviewAnswer(ans, plan, rl) {
+    const trimmed = ans.trim().toLowerCase();
+    if (trimmed === "n" || trimmed === "no")
+        return { action: "abort" };
+    if (trimmed === "v" || trimmed === "view") {
+        // Just show the raw plan again
+        process.stdout.write(plan + "\n\n");
+        const ans2 = await rl.question(`${CYN}Proceed? [Y/r/n]${R} `);
+        return parseReviewAnswer(ans2, plan, rl);
+    }
+    if (trimmed === "r" || trimmed === "revise") {
+        const fb = await rl.question(`${CYN}Revision feedback: ${R}`);
+        return { action: "revise", feedback: fb.trim() };
+    }
+    if (trimmed === "d" || trimmed === "discuss") {
+        const q = await rl.question(`${CYN}Your question: ${R}`);
+        return { action: "discuss", feedback: q.trim() };
+    }
+    return { action: "approve" };
+}
+//# sourceMappingURL=plan_viewer.js.map

package/dist/ui/plan_viewer.js.map

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

package/dist/ui/progress.d.ts

@@ -8,8 +8,23 @@ export declare class Spinner {
     constructor(message: string);
     start(): void;
     update(message: string): void;
+    stopAndPersist(symbol: string, text: string): void;
     stop(finalMessage?: string): void;
 }
+export declare class NeuralKnotSpinner {
+    private readonly leftLabel;
+    private readonly rightLabel;
+    private intervalId;
+    private frameIndex;
+    private message;
+    private rendered;
+    constructor(message: string, leftLabel?: string, rightLabel?: string);
+    private draw;
+    start(): void;
+    update(message: string): void;
+    stopAndPersist(symbol: string, text: string): void;
+    stop(): void;
+}
 export declare function phaseBanner(phaseNumber: number, totalPhases: number, label: string): string;
 export declare function liveTokenCounter(tokens: number, costUsd: number): string;
 export declare function formatElapsed(ms: number): string;

package/dist/ui/progress.js

@@ -3,7 +3,14 @@
  */
 import { DM, R, B } from "./colors.js";
 // ── Spinner ─────────────────────────────────────────────────────
-const SPINNER_FRAMES = ["\u28CB", "\u28D9", "\u28F9", "\u28F8", "\u28FC", "\u28F4", "\u28E6", "\u28E7", "\u28C7", "\u28CF"];
+const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧"];
+function gradientChar(char, t) {
+    // Interpolate #00F2FF (cyan) → #7000FF (purple)
+    const r = Math.round(0x00 + t * (0x70 - 0x00));
+    const g = Math.round(0xF2 + t * (0x00 - 0xF2));
+    const b = 0xFF;
+    return `\x1b[38;2;${r};${g};${b}m${char}\x1b[0m`;
+}
 export class Spinner {
     intervalId = null;
     frameIndex = 0;
@@ -17,13 +24,22 @@ export class Spinner {
         this.frameIndex = 0;
         this.intervalId = setInterval(() => {
             const frame = SPINNER_FRAMES[this.frameIndex % SPINNER_FRAMES.length];
-            process.stdout.write(`\r\x1b[2K${DM}${frame} ${this.message}${R}`);
+            const t = (this.frameIndex % 20) / 20;
+            const colored = gradientChar(frame, t);
+            process.stdout.write(`\r\x1b[2K${colored} ${this.message}\x1b[0m`);
             this.frameIndex++;
         }, 80);
     }
     update(message) {
         this.message = message;
     }
+    stopAndPersist(symbol, text) {
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = null;
+        }
+        process.stdout.write(`\r\x1b[2K${symbol} ${text}\n`);
+    }
     stop(finalMessage) {
         if (this.intervalId) {
             clearInterval(this.intervalId);
@@ -35,6 +51,91 @@ export class Spinner {
         }
     }
 }
+// ── Neural Knot Spinner ─────────────────────────────────────────
+// Two colored strands weaving through each other — Architect (cyan)
+// and Executor (purple) — forming a DNA-like braid as they hand off.
+const NK_C = "\x1b[38;2;0;242;255m\x1b[1m"; // Architect strand: #00F2FF bold
+const NK_P = "\x1b[38;2;112;0;255m\x1b[1m"; // Executor strand:  #7000FF bold
+// 8-row braid period. Each row is 7 visible chars wide.
+// Reading top-to-bottom, the two strands cross twice per period.
+const NK_PATTERN = [
+    /* 0 C-left parallel  */ `${NK_C}│${R}     ${NK_P}│${R}`,
+    /* 1 C-left converge  */ ` ${NK_C}╲${R}   ${NK_P}╱${R} `,
+    /* 2 crossing C→P     */ `   ${NK_C}╳${R}   `,
+    /* 3 P-left diverge   */ ` ${NK_P}╱${R}   ${NK_C}╲${R} `,
+    /* 4 P-left parallel  */ `${NK_P}│${R}     ${NK_C}│${R}`,
+    /* 5 P-left converge  */ ` ${NK_P}╲${R}   ${NK_C}╱${R} `,
+    /* 6 crossing P→C     */ `   ${NK_P}╳${R}   `,
+    /* 7 C-left diverge   */ ` ${NK_C}╱${R}   ${NK_P}╲${R} `,
+];
+const NK_WINDOW = 5; // knot rows shown at once
+const NK_LINES = NK_WINDOW + 2; // + role-label line + message line
+export class NeuralKnotSpinner {
+    leftLabel;
+    rightLabel;
+    intervalId = null;
+    frameIndex = 0;
+    message;
+    rendered = false;
+    constructor(message, leftLabel = "Architect", rightLabel = "Executor") {
+        this.leftLabel = leftLabel;
+        this.rightLabel = rightLabel;
+        this.message = message;
+    }
+    draw() {
+        if (this.rendered) {
+            process.stdout.write(`\x1b[${NK_LINES}A`);
+        }
+        for (let i = 0; i < NK_WINDOW; i++) {
+            const row = NK_PATTERN[(this.frameIndex + i) % NK_PATTERN.length];
+            process.stdout.write(`\r\x1b[2K  ${row}\n`);
+        }
+        process.stdout.write(`\r\x1b[2K  ${NK_C}${this.leftLabel}${R} ${DM}↔${R} ${NK_P}${this.rightLabel}${R}\n`);
+        process.stdout.write(`\r\x1b[2K  ${DM}${this.message}${R}\n`);
+        this.rendered = true;
+    }
+    start() {
+        if (this.intervalId)
+            return;
+        this.frameIndex = 0;
+        this.rendered = false;
+        this.intervalId = setInterval(() => {
+            this.draw();
+            this.frameIndex++;
+        }, 100);
+    }
+    update(message) {
+        this.message = message;
+    }
+    stopAndPersist(symbol, text) {
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = null;
+        }
+        if (this.rendered) {
+            // Erase all knot lines then write a single persistent line
+            process.stdout.write(`\x1b[${NK_LINES}A`);
+            for (let i = 0; i < NK_LINES; i++) {
+                process.stdout.write(`\r\x1b[2K\n`);
+            }
+            process.stdout.write(`\x1b[${NK_LINES}A`);
+        }
+        process.stdout.write(`\r\x1b[2K  ${symbol} ${text}\n`);
+    }
+    stop() {
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = null;
+        }
+        if (this.rendered) {
+            process.stdout.write(`\x1b[${NK_LINES}A`);
+            for (let i = 0; i < NK_LINES; i++) {
+                process.stdout.write(`\r\x1b[2K\n`);
+            }
+            process.stdout.write(`\x1b[${NK_LINES}A\r\x1b[2K`);
+        }
+    }
+}
 // ── Phase Banners ───────────────────────────────────────────────
 export function phaseBanner(phaseNumber, totalPhases, label) {
     return `${DM}[${phaseNumber}/${totalPhases}]${R} ${B}${label}${R}`;