@puzzmo/cli 1.0.0

package/lib/lib/exec.d.ts

@@ -0,0 +1,15 @@
+type ExecOptions = {
+    cwd?: string;
+};
+/** Runs a shell command, printing output */
+export declare const runCommand: (cmd: string, opts?: ExecOptions) => void;
+/** Runs a command and returns stdout */
+export declare const runCommandOutput: (cmd: string, opts?: ExecOptions) => string;
+/** Creates a git commit */
+export declare const gitCommit: (message: string, opts?: ExecOptions) => void;
+/** Runs vite build and returns success/failure */
+export declare const verifyBuild: (cwd: string) => {
+    success: boolean;
+    error?: string;
+};
+export {};

package/lib/lib/exec.js

@@ -0,0 +1,34 @@
+import { execSync } from "node:child_process";
+/** Runs a shell command, printing output */
+export const runCommand = (cmd, opts = {}) => {
+    execSync(cmd, {
+        cwd: opts.cwd,
+        stdio: "inherit",
+        encoding: "utf-8",
+    });
+};
+/** Runs a command and returns stdout */
+export const runCommandOutput = (cmd, opts = {}) => {
+    return execSync(cmd, {
+        cwd: opts.cwd,
+        encoding: "utf-8",
+    }).trim();
+};
+/** Creates a git commit */
+export const gitCommit = (message, opts = {}) => {
+    execSync(`git commit -m "${message}"`, {
+        cwd: opts.cwd,
+        stdio: "inherit",
+    });
+};
+/** Runs vite build and returns success/failure */
+export const verifyBuild = (cwd) => {
+    try {
+        execSync("npx vite build", { cwd, encoding: "utf-8", stdio: "pipe" });
+        return { success: true };
+    }
+    catch (e) {
+        return { success: false, error: e.stderr || e.stdout || e.message };
+    }
+};
+//# sourceMappingURL=exec.js.map

package/lib/lib/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/lib/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAI7C,4CAA4C;AAC5C,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAW,EAAE,OAAoB,EAAE,EAAE,EAAE;IAChE,QAAQ,CAAC,GAAG,EAAE;QACZ,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,OAAO;KAClB,CAAC,CAAA;AACJ,CAAC,CAAA;AAED,wCAAwC;AACxC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,GAAW,EAAE,OAAoB,EAAE,EAAU,EAAE;IAC9E,OAAO,QAAQ,CAAC,GAAG,EAAE;QACnB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,QAAQ,EAAE,OAAO;KAClB,CAAC,CAAC,IAAI,EAAE,CAAA;AACX,CAAC,CAAA;AAED,2BAA2B;AAC3B,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,OAAe,EAAE,OAAoB,EAAE,EAAE,EAAE;IACnE,QAAQ,CAAC,kBAAkB,OAAO,GAAG,EAAE;QACrC,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,KAAK,EAAE,SAAS;KACjB,CAAC,CAAA;AACJ,CAAC,CAAA;AAED,kDAAkD;AAClD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAAW,EAAwC,EAAE;IAC/E,IAAI,CAAC;QACH,QAAQ,CAAC,gBAAgB,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;QACrE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAC1B,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,EAAE,CAAA;IACrE,CAAC;AACH,CAAC,CAAA"}

package/lib/lib/package-manager.d.ts

@@ -0,0 +1,2 @@
+/** Detects the user's package manager from env or lockfiles */
+export declare const detectPackageManager: () => "yarn" | "npm" | "pnpm";

package/lib/lib/package-manager.js

@@ -0,0 +1,15 @@
+import fs from "node:fs";
+/** Detects the user's package manager from env or lockfiles */
+export const detectPackageManager = () => {
+    const ua = process.env.npm_config_user_agent ?? "";
+    if (ua.startsWith("yarn"))
+        return "yarn";
+    if (ua.startsWith("pnpm"))
+        return "pnpm";
+    if (fs.existsSync("yarn.lock"))
+        return "yarn";
+    if (fs.existsSync("pnpm-lock.yaml"))
+        return "pnpm";
+    return "npm";
+};
+//# sourceMappingURL=package-manager.js.map

package/lib/lib/package-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager.js","sourceRoot":"","sources":["../../src/lib/package-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AAExB,+DAA+D;AAC/D,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAA4B,EAAE;IAChE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,EAAE,CAAA;IAClD,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAA;IACxC,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAA;IAExC,IAAI,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,MAAM,CAAA;IAC7C,IAAI,EAAE,CAAC,UAAU,CAAC,gBAAgB,CAAC;QAAE,OAAO,MAAM,CAAA;IAClD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA"}

package/lib/skills/registry.d.ts

@@ -0,0 +1,13 @@
+export type SkillDefinition = {
+    name: string;
+    optional: boolean;
+};
+/** Ordered list of skills for the migration pipeline */
+export declare const skillsPipeline: SkillDefinition[];
+/** Returns the skills directory for a given agent inside the game dir */
+export declare const agentSkillsDir: (agent: string) => string;
+/**
+ * Copies SKILL.md files from the bundled skills source into the game
+ * directory under the agent-specific skills path.
+ */
+export declare const installSkills: (agent: string, gameDir: string) => number;

package/lib/skills/registry.js

@@ -0,0 +1,49 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+/** Ordered list of skills for the migration pipeline */
+export const skillsPipeline = [
+    { name: "convert-to-vite", optional: false },
+    { name: "introduce-puzzmo-sdk", optional: false },
+    { name: "game-completion", optional: false },
+    { name: "puzzmo-theme", optional: true },
+    { name: "add-deeds", optional: false },
+    { name: "setup-augmentations", optional: false },
+    { name: "create-app-bundle", optional: false },
+    { name: "setup-deploy", optional: false },
+];
+/** Returns the skills directory for a given agent inside the game dir */
+export const agentSkillsDir = (agent) => {
+    if (agent === "claude")
+        return ".claude/skills";
+    if (agent === "codex")
+        return ".codex/skills";
+    if (agent === "gemini")
+        return ".gemini/skills";
+    return `.${agent}/skills`;
+};
+/**
+ * Copies SKILL.md files from the bundled skills source into the game
+ * directory under the agent-specific skills path.
+ */
+export const installSkills = (agent, gameDir) => {
+    const skillsRoot = agentSkillsDir(agent);
+    // Locate the bundled skills source (packages/skills/ relative to this file)
+    // This file is at packages/cli/src/skills/registry.ts (or lib/skills/registry.js when built)
+    const thisDir = path.dirname(fileURLToPath(import.meta.url));
+    // Walk up to packages/cli, then over to packages/skills
+    const packagesDir = path.resolve(thisDir, "..", "..", "..");
+    const skillsSrcDir = path.join(packagesDir, "skills");
+    let installed = 0;
+    for (const skill of skillsPipeline) {
+        const srcFile = path.join(skillsSrcDir, skill.name, "SKILL.md");
+        if (!fs.existsSync(srcFile))
+            continue;
+        const destDir = path.join(gameDir, skillsRoot, skill.name);
+        fs.mkdirSync(destDir, { recursive: true });
+        fs.copyFileSync(srcFile, path.join(destDir, "SKILL.md"));
+        installed++;
+    }
+    return installed;
+};
+//# sourceMappingURL=registry.js.map

package/lib/skills/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/skills/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAOxC,wDAAwD;AACxD,MAAM,CAAC,MAAM,cAAc,GAAsB;IAC/C,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC5C,EAAE,IAAI,EAAE,sBAAsB,EAAE,QAAQ,EAAE,KAAK,EAAE;IACjD,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC5C,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,IAAI,EAAE;IACxC,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE;IACtC,EAAE,IAAI,EAAE,qBAAqB,EAAE,QAAQ,EAAE,KAAK,EAAE;IAChD,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC9C,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,KAAK,EAAE;CAC1C,CAAA;AAED,yEAAyE;AACzE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAa,EAAU,EAAE;IACtD,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO,gBAAgB,CAAA;IAC/C,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,eAAe,CAAA;IAC7C,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO,gBAAgB,CAAA;IAC/C,OAAO,IAAI,KAAK,SAAS,CAAA;AAC3B,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAa,EAAE,OAAe,EAAU,EAAE;IACtE,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC,CAAA;IAExC,4EAA4E;IAC5E,6FAA6F;IAC7F,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IAC5D,wDAAwD;IACxD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;IAC3D,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;IAErD,IAAI,SAAS,GAAG,CAAC,CAAA;IAEjB,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;QAC/D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;YAAE,SAAQ;QAErC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;QAC1D,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC1C,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAA;QACxD,SAAS,EAAE,CAAA;IACb,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC,CAAA"}

package/lib/skills/runner.d.ts

@@ -0,0 +1,4 @@
+/** Runs the skills pipeline with plain console output (no TUI) */
+export declare const runSkillsPipeline: (agent: string, gameDir: string) => Promise<void>;
+/** Runs the skills pipeline with a split-pane TUI */
+export declare const runSkillsPipelineTUI: (agent: string, gameDir: string) => Promise<void>;

package/lib/skills/runner.js

@@ -0,0 +1,80 @@
+import { spawnSync } from "node:child_process";
+import { skillsPipeline, agentSkillsDir } from "./registry.js";
+import { verifyBuild, runCommand, gitCommit } from "../lib/exec.js";
+/** Builds the agent prompt for a given skill */
+const buildPrompt = (skillName, agent) => {
+    const skillDir = agentSkillsDir(agent);
+    return `Run the skill ${skillName}. Follow the instructions in ${skillDir}/${skillName}/SKILL.md. The game source is in the current directory.`;
+};
+/** Invokes an LLM agent with a prompt (plain mode, stdio inherited) */
+const invokeAgent = (agent, prompt, cwd) => {
+    const env = { ...process.env };
+    delete env.CLAUDECODE;
+    const result = spawnSync(agent, [prompt], {
+        cwd,
+        env,
+        stdio: ["inherit", "pipe", "pipe"],
+        encoding: "utf-8",
+        timeout: 300000, // 5 minute timeout per skill
+    });
+    const output = (result.stdout ?? "") + (result.stderr ?? "");
+    return {
+        success: result.status === 0,
+        output,
+    };
+};
+/** Runs the skills pipeline with plain console output (no TUI) */
+export const runSkillsPipeline = async (agent, gameDir) => {
+    const total = skillsPipeline.length;
+    for (let i = 0; i < total; i++) {
+        const skill = skillsPipeline[i];
+        const step = i + 1;
+        console.log(`[${step}/${total}] Running skill: ${skill.name}${skill.optional ? " (optional)" : ""}`);
+        const prompt = buildPrompt(skill.name, agent);
+        let result = invokeAgent(agent, prompt, gameDir);
+        if (!result.success) {
+            if (skill.optional) {
+                console.log(`  Skipped (optional skill failed)`);
+                continue;
+            }
+            console.log(`  Agent failed, retrying...`);
+            result = invokeAgent(agent, prompt, gameDir);
+            if (!result.success) {
+                console.error(`  Skill ${skill.name} failed after retry. Stopping pipeline.`);
+                process.exit(1);
+            }
+        }
+        // Verify build
+        const buildResult = verifyBuild(gameDir);
+        if (!buildResult.success) {
+            console.log(`  Build failed after ${skill.name}, asking agent to fix...`);
+            const fixPrompt = `The vite build failed after running skill ${skill.name}. Fix the build errors:\n\n${buildResult.error}`;
+            invokeAgent(agent, fixPrompt, gameDir);
+            const retryBuild = verifyBuild(gameDir);
+            if (!retryBuild.success) {
+                if (skill.optional) {
+                    console.log(`  Skipped (build still failing after fix attempt)`);
+                    continue;
+                }
+                console.error(`  Build still failing after fix attempt. Stopping.`);
+                process.exit(1);
+            }
+        }
+        // Commit
+        try {
+            runCommand("git add -A", { cwd: gameDir });
+            gitCommit(`skill: ${skill.name}`, { cwd: gameDir });
+            console.log(`  Committed.`);
+        }
+        catch {
+            console.log(`  No changes to commit.`);
+        }
+    }
+    console.log(`\nAll skills completed!`);
+};
+/** Runs the skills pipeline with a split-pane TUI */
+export const runSkillsPipelineTUI = async (agent, gameDir) => {
+    const { runPipelineTUI } = await import("../tui/pipeline.js");
+    await runPipelineTUI(agent, gameDir);
+};
+//# sourceMappingURL=runner.js.map

package/lib/skills/runner.js.map

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

package/lib/tui/pipeline.d.ts

@@ -0,0 +1,2 @@
+/** Render the pipeline TUI and wait for it to complete */
+export declare const runPipelineTUI: (agent: string, gameDir: string) => Promise<void>;

package/lib/tui/pipeline.js

@@ -0,0 +1,426 @@
+import { spawn } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { skillsPipeline, agentSkillsDir } from "../skills/registry.js";
+import { verifyBuild, runCommand, gitCommit } from "../lib/exec.js";
+// ANSI escape helpers
+const ESC = "\x1b";
+const CSI = `${ESC}[`;
+const moveTo = (row, col) => `${CSI}${row};${col}H`;
+const clearScreen = () => `${CSI}2J`;
+const hideCursor = () => `${CSI}?25l`;
+const showCursor = () => `${CSI}?25h`;
+const bold = (s) => `${CSI}1m${s}${CSI}0m`;
+const dim = (s) => `${CSI}2m${s}${CSI}0m`;
+const fg = (code, s) => `${CSI}${code}m${s}${CSI}0m`;
+const green = (s) => fg(32, s);
+const yellow = (s) => fg(33, s);
+const red = (s) => fg(31, s);
+const cyan = (s) => fg(36, s);
+const gray = (s) => dim(s);
+const magenta = (s) => fg(35, s);
+const stateIcon = {
+    pending: "○",
+    running: "●",
+    success: "✓",
+    failed: "✗",
+    skipped: "–",
+};
+const stateColor = {
+    pending: gray,
+    running: yellow,
+    success: green,
+    failed: red,
+    skipped: gray,
+};
+const phaseColor = {
+    agent: yellow,
+    build: cyan,
+    commit: magenta,
+    idle: gray,
+};
+/** Build agent-specific command for non-interactive mode */
+const buildAgentCmd = (agent, prompt) => {
+    if (agent === "claude")
+        return { cmd: "claude", args: ["-p", "--verbose", "--output-format", "stream-json", prompt] };
+    if (agent === "codex")
+        return { cmd: "codex", args: ["--quiet", prompt] };
+    return { cmd: agent, args: [prompt] };
+};
+const buildPrompt = (skillName, agent) => {
+    const skillDir = agentSkillsDir(agent);
+    return `Run the skill ${skillName}. Follow the instructions in ${skillDir}/${skillName}/SKILL.md. The game source is in the current directory.`;
+};
+class PipelineTUI {
+    agent;
+    gameDir;
+    states;
+    currentStep = 0;
+    outputLines = [];
+    phase = "idle";
+    done = false;
+    activeProc = null;
+    sidebarWidth = 30;
+    constructor(agent, gameDir) {
+        this.agent = agent;
+        this.gameDir = gameDir;
+        this.states = skillsPipeline.map(() => "pending");
+    }
+    get rows() {
+        return process.stdout.rows || 24;
+    }
+    get cols() {
+        return process.stdout.columns || 80;
+    }
+    get maxOutputLines() {
+        return Math.max(this.rows - 4, 8);
+    }
+    write(s) {
+        process.stdout.write(s);
+    }
+    /** Draw the entire screen */
+    render() {
+        const { rows, cols, sidebarWidth } = this;
+        const outputWidth = cols - sidebarWidth - 1;
+        let buf = "";
+        buf += clearScreen();
+        buf += moveTo(1, 1);
+        // Top border
+        buf += "╭" + "─".repeat(sidebarWidth - 2) + "┬" + "─".repeat(outputWidth - 1) + "╮";
+        // Sidebar header
+        buf += moveTo(2, 1);
+        buf += "│ " + bold("Migration Pipeline") + " ".repeat(Math.max(0, sidebarWidth - 21)) + "│";
+        // Output panel header
+        const headerLabel = this.done
+            ? "Done"
+            : `${skillsPipeline[this.currentStep]?.name ?? ""} ${dim(`(${this.phase})`)}`;
+        const headerColor = phaseColor[this.phase];
+        buf += " " + headerColor(bold(headerLabel));
+        buf += " ".repeat(Math.max(0, outputWidth - this.stripAnsi(headerLabel).length - 2)) + "│";
+        // Separator
+        buf += moveTo(3, 1);
+        buf += "├" + "─".repeat(sidebarWidth - 2) + "┼" + "─".repeat(outputWidth - 1) + "┤";
+        // Content rows
+        const contentRows = rows - 4; // top border + header + separator + bottom border
+        for (let row = 0; row < contentRows; row++) {
+            buf += moveTo(row + 4, 1);
+            // Sidebar column
+            const skillIndex = row;
+            if (skillIndex < skillsPipeline.length) {
+                const skill = skillsPipeline[skillIndex];
+                const state = this.states[skillIndex];
+                const isActive = skillIndex === this.currentStep && !this.done;
+                const icon = stateIcon[state];
+                const colorFn = stateColor[state];
+                const label = `${icon} ${skill.name}${skill.optional ? " *" : ""}`;
+                const styled = isActive ? bold(colorFn(label)) : colorFn(label);
+                const rawLen = this.stripAnsi(styled).length;
+                buf += "│ " + styled + " ".repeat(Math.max(0, sidebarWidth - rawLen - 3)) + "│";
+            }
+            else if (skillIndex === skillsPipeline.length + 1) {
+                // Status line
+                const completedCount = this.states.filter((s) => s === "success").length;
+                const failedCount = this.states.filter((s) => s === "failed").length;
+                const status = this.done
+                    ? failedCount > 0
+                        ? red(`${failedCount} failure(s)`)
+                        : green("All complete!")
+                    : dim(`${completedCount}/${skillsPipeline.length} done`);
+                const rawLen = this.stripAnsi(status).length;
+                buf += "│ " + status + " ".repeat(Math.max(0, sidebarWidth - rawLen - 3)) + "│";
+            }
+            else if (skillIndex === skillsPipeline.length + 2) {
+                buf += "│ " + dim("* = optional") + " ".repeat(Math.max(0, sidebarWidth - 15)) + "│";
+            }
+            else {
+                buf += "│" + " ".repeat(sidebarWidth - 2) + "│";
+            }
+            // Output column
+            const lineIndex = this.outputLines.length - contentRows + row;
+            const line = lineIndex >= 0 ? this.outputLines[lineIndex] ?? "" : "";
+            const truncated = this.truncateVisible(line, outputWidth - 2);
+            const visibleLen = this.stripAnsi(truncated).length;
+            buf += " " + truncated + " ".repeat(Math.max(0, outputWidth - visibleLen - 1)) + "│";
+        }
+        // Bottom border
+        buf += moveTo(rows, 1);
+        buf += "╰" + "─".repeat(sidebarWidth - 2) + "┴" + "─".repeat(outputWidth - 1) + "╯";
+        this.write(buf);
+    }
+    /** Strip ANSI escape codes for length calculation */
+    stripAnsi(s) {
+        // oxlint-disable-next-line no-control-regex
+        return s.replace(/\x1b\[[0-9;]*m/g, "");
+    }
+    /** Truncate a string to a visible width, preserving ANSI codes */
+    truncateVisible(s, maxWidth) {
+        let visible = 0;
+        let i = 0;
+        while (i < s.length && visible < maxWidth) {
+            if (s[i] === "\x1b" && s[i + 1] === "[") {
+                const end = s.indexOf("m", i);
+                if (end !== -1) {
+                    i = end + 1;
+                    continue;
+                }
+            }
+            visible++;
+            i++;
+        }
+        // Include any trailing ANSI sequences (like reset codes) right after the cut point
+        while (i < s.length && s[i] === "\x1b" && s[i + 1] === "[") {
+            const end = s.indexOf("m", i);
+            if (end !== -1) {
+                i = end + 1;
+            }
+            else
+                break;
+        }
+        return s.slice(0, i);
+    }
+    /** Parse stream-json output from claude, or plain text from other agents */
+    appendOutput(text) {
+        const rawLines = text.split("\n").filter((l) => l.trim());
+        for (const line of rawLines) {
+            const parsed = this.parseStreamLine(line);
+            if (parsed) {
+                // Split multi-line parsed output into separate display lines
+                for (const displayLine of parsed.split("\n")) {
+                    this.outputLines.push(displayLine);
+                }
+            }
+        }
+        // Keep buffer bounded
+        if (this.outputLines.length > 500) {
+            this.outputLines = this.outputLines.slice(-this.maxOutputLines);
+        }
+        this.render();
+    }
+    /** Format a tool use block into a display line */
+    formatToolUse(t) {
+        const name = t.name ?? "unknown";
+        if (name === "Edit")
+            return `${yellow("Edit")} ${t.input?.file_path ?? ""}`;
+        if (name === "Write")
+            return `${yellow("Write")} ${t.input?.file_path ?? ""}`;
+        if (name === "Read")
+            return `${yellow("Read")} ${t.input?.file_path ?? ""}`;
+        if (name === "Bash")
+            return `${yellow("Bash")} ${t.input?.command ?? ""}`;
+        if (name === "Glob")
+            return `${yellow("Glob")} ${t.input?.pattern ?? ""}`;
+        if (name === "Grep")
+            return `${yellow("Grep")} ${t.input?.pattern ?? ""}`;
+        return `${yellow(name)}`;
+    }
+    /** Extract human-readable text from a stream-json line, or pass through raw text */
+    parseStreamLine(line) {
+        try {
+            const obj = JSON.parse(line);
+            // Assistant messages - may contain text, tool_use, thinking, or a mix
+            if (obj.type === "assistant" && obj.message?.content) {
+                const content = obj.message.content;
+                const parts = [];
+                const texts = content.filter((c) => c.type === "text").map((c) => c.text);
+                if (texts.length > 0)
+                    parts.push(texts.join(""));
+                const toolUses = content.filter((c) => c.type === "tool_use");
+                if (toolUses.length > 0)
+                    parts.push(toolUses.map((t) => this.formatToolUse(t)).join("\n"));
+                // Thinking blocks - skip silently, they're just internal reasoning
+                if (parts.length > 0)
+                    return parts.join("\n");
+                if (content.some((c) => c.type === "thinking"))
+                    return null;
+                return null;
+            }
+            // Content block delta (streaming text chunks)
+            if (obj.type === "content_block_delta" && obj.delta?.text) {
+                return obj.delta.text;
+            }
+            // Standalone tool use event
+            if (obj.type === "tool_use") {
+                return this.formatToolUse(obj);
+            }
+            // User messages (tool results coming back)
+            if (obj.type === "user") {
+                const content = obj.message?.content;
+                if (!content)
+                    return null;
+                // Show file create/update results
+                const result = obj.tool_use_result;
+                if (result?.type === "create")
+                    return dim(`Created ${result.filePath}`);
+                if (result?.type === "update")
+                    return dim(`Updated ${result.filePath}`);
+                return null;
+            }
+            // Rate limit events - suppress
+            if (obj.type === "rate_limit_event")
+                return null;
+            // Tool results
+            if (obj.type === "result") {
+                const cost = obj.cost_usd ? ` ($${obj.cost_usd.toFixed(4)})` : "";
+                return green(`Done${cost}`);
+            }
+            // System messages
+            if (obj.type === "system") {
+                if (obj.subtype === "init")
+                    return dim(`Session started`);
+                if (obj.subtype === "hook_started")
+                    return null;
+                if (obj.subtype === "hook_response")
+                    return null;
+                return dim(`[system:${obj.subtype}]`);
+            }
+            // Show unrecognized types so we can add support
+            return dim(`[${obj.type}${obj.subtype ? ":" + obj.subtype : ""}]`);
+        }
+        catch {
+            // Not JSON - show as-is
+            return line;
+        }
+    }
+    /** Spawn agent and stream output */
+    runAgent(prompt) {
+        return new Promise((resolve) => {
+            const { cmd, args } = buildAgentCmd(this.agent, prompt);
+            const env = { ...process.env, FORCE_COLOR: "0", NO_COLOR: "1" };
+            // Remove env vars that prevent nested claude sessions
+            delete env.CLAUDECODE;
+            const proc = spawn(cmd, args, {
+                cwd: this.gameDir,
+                env,
+                stdio: ["ignore", "pipe", "pipe"],
+            });
+            this.activeProc = proc;
+            const debugLog = path.join(this.gameDir, "pipeline-debug.log");
+            proc.stdout?.on("data", (data) => {
+                fs.appendFileSync(debugLog, data.toString());
+                this.appendOutput(data.toString());
+            });
+            proc.stderr?.on("data", (data) => {
+                fs.appendFileSync(debugLog, `[stderr] ${data.toString()}`);
+                this.appendOutput(data.toString());
+            });
+            proc.on("close", (code) => {
+                fs.appendFileSync(debugLog, `\n[close] code=${code}\n`);
+                this.activeProc = null;
+                resolve(code === 0);
+            });
+            proc.on("error", (err) => {
+                this.appendOutput(`Error: ${err.message}`);
+                this.activeProc = null;
+                resolve(false);
+            });
+        });
+    }
+    /** Run one pipeline step */
+    async runStep(stepIndex) {
+        const skill = skillsPipeline[stepIndex];
+        this.states[stepIndex] = "running";
+        this.currentStep = stepIndex;
+        this.outputLines = [];
+        this.phase = "agent";
+        this.render();
+        const prompt = buildPrompt(skill.name, this.agent);
+        let success = await this.runAgent(prompt);
+        if (!success) {
+            if (skill.optional) {
+                this.states[stepIndex] = "skipped";
+                this.render();
+                return true;
+            }
+            this.appendOutput("\n--- Retrying ---\n");
+            success = await this.runAgent(prompt);
+            if (!success) {
+                this.states[stepIndex] = "failed";
+                this.render();
+                return false;
+            }
+        }
+        // Verify build
+        this.phase = "build";
+        this.render();
+        this.appendOutput("Verifying build...");
+        const buildResult = verifyBuild(this.gameDir);
+        if (!buildResult.success) {
+            this.appendOutput(`Build failed: ${buildResult.error}\nAsking agent to fix...`);
+            const fixPrompt = `The vite build failed after running skill ${skill.name}. Fix the build errors:\n\n${buildResult.error}`;
+            await this.runAgent(fixPrompt);
+            const retry = verifyBuild(this.gameDir);
+            if (!retry.success) {
+                if (skill.optional) {
+                    this.states[stepIndex] = "skipped";
+                    this.render();
+                    return true;
+                }
+                this.states[stepIndex] = "failed";
+                this.render();
+                return false;
+            }
+        }
+        // Commit
+        this.phase = "commit";
+        this.render();
+        try {
+            runCommand("git add -A", { cwd: this.gameDir });
+            gitCommit(`skill: ${skill.name}`, { cwd: this.gameDir });
+            this.appendOutput("Committed.");
+        }
+        catch {
+            this.appendOutput("No changes to commit.");
+        }
+        this.states[stepIndex] = "success";
+        this.render();
+        return true;
+    }
+    /** Set up keyboard handling (Ctrl+C to quit) */
+    setupInput() {
+        if (process.stdin.isTTY) {
+            process.stdin.setRawMode(true);
+        }
+        process.stdin.resume();
+        process.stdin.on("data", (data) => {
+            // Ctrl+C
+            if (data[0] === 3) {
+                if (this.activeProc)
+                    this.activeProc.kill();
+                this.cleanup();
+                process.exit(0);
+            }
+        });
+    }
+    cleanup() {
+        this.write(showCursor());
+        if (process.stdin.isTTY) {
+            process.stdin.setRawMode(false);
+        }
+        process.stdin.pause();
+    }
+    /** Run the full pipeline */
+    async run() {
+        this.write(hideCursor());
+        this.setupInput();
+        this.render();
+        // Redraw on terminal resize
+        process.stdout.on("resize", () => this.render());
+        for (let i = 0; i < skillsPipeline.length; i++) {
+            const ok = await this.runStep(i);
+            if (!ok) {
+                this.appendOutput("\nPipeline stopped due to failure.");
+                break;
+            }
+        }
+        this.phase = "idle";
+        this.done = true;
+        this.render();
+        this.cleanup();
+    }
+}
+/** Render the pipeline TUI and wait for it to complete */
+export const runPipelineTUI = async (agent, gameDir) => {
+    const tui = new PipelineTUI(agent, gameDir);
+    await tui.run();
+};
+//# sourceMappingURL=pipeline.js.map