ralphy-spec 0.1.0 → 0.2.0

package/dist/cli/init.js

@@ -0,0 +1,66 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerInitCommand = registerInitCommand;
+const inquirer_1 = __importDefault(require("inquirer"));
+const detector_1 = require("../utils/detector");
+const installer_1 = require("../utils/installer");
+const paths_1 = require("../utils/paths");
+function parseToolsArg(arg) {
+    if (!arg)
+        return undefined;
+    const parts = arg
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+    const allowed = ["cursor", "claude-code", "opencode"];
+    const tools = [];
+    for (const p of parts) {
+        if (allowed.includes(p))
+            tools.push(p);
+    }
+    return tools.length ? tools : undefined;
+}
+async function promptForTools(defaultTools) {
+    const { tools } = await inquirer_1.default.prompt([
+        {
+            type: "checkbox",
+            name: "tools",
+            message: "Which AI tools do you want to configure?",
+            choices: [
+                { name: "Cursor", value: "cursor" },
+                { name: "Claude Code", value: "claude-code" },
+                { name: "OpenCode", value: "opencode" },
+            ],
+            default: defaultTools,
+        },
+    ]);
+    return tools;
+}
+function registerInitCommand(program) {
+    program
+        .command("init")
+        .description("Initialize Ralph + OpenSpec workflow files in a project")
+        .option("--dir <path>", "Target project directory (default: current directory)")
+        .option("--tools <list>", "Comma-separated list: cursor,claude-code,opencode")
+        .option("--force", "Overwrite existing files", false)
+        .action(async (opts) => {
+        const options = {
+            dir: (0, paths_1.resolveProjectDir)(opts.dir),
+            tools: parseToolsArg(opts.tools),
+            force: opts.force,
+        };
+        const detected = await (0, detector_1.detectExistingTools)(options.dir);
+        const defaultTools = options.tools ??
+            (detected.length
+                ? detected
+                : ["cursor", "claude-code", "opencode"]);
+        const tools = options.tools ?? (await promptForTools(defaultTools));
+        await (0, installer_1.ensureOpenSpecScaffold)(options.dir);
+        await (0, installer_1.installToolTemplates)(options.dir, tools, { force: options.force });
+        process.stdout.write(`Initialized Ralph-OpenSpec in ${options.dir}\nConfigured tools: ${tools.join(", ")}\n`);
+    });
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/init.js.map

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

package/dist/cli/report.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerReportCommand(program: Command): void;
+//# sourceMappingURL=report.d.ts.map

package/dist/cli/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/cli/report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgD5D"}

package/dist/cli/report.js

@@ -0,0 +1,53 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerReportCommand = registerReportCommand;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const persistence_1 = require("../core/memory/persistence");
+function registerReportCommand(program) {
+    program
+        .command("report")
+        .description("Generate a markdown report for the latest run")
+        .option("--out <filepath>", "Output markdown file", "ralphy-report.md")
+        .option("--json", "Machine-readable output", false)
+        .action(async (opts) => {
+        const repoRoot = process.cwd();
+        const persistence = await persistence_1.PersistenceLayer.openForRepo(repoRoot);
+        try {
+            const run = persistence.getLatestRun();
+            if (!run) {
+                process.stderr.write("No runs found.\n");
+                process.exitCode = 1;
+                return;
+            }
+            const ledger = persistence.listLedger({ runId: run.runId, limit: 500 });
+            const md = [
+                `# Ralphy Spec Report`,
+                ``,
+                `- Run ID: \`${run.runId}\``,
+                `- Status: \`${run.status}\``,
+                `- Started: \`${run.startedAt}\``,
+                ``,
+                `## Recent ledger`,
+                ``,
+                ...ledger.map((e) => `- ${e.ts} \`${e.kind}\`${e.taskId ? ` (\`${e.taskId}\`)` : ""}: ${e.message}`),
+                ``,
+            ].join("\n");
+            const outPath = node_path_1.default.resolve(repoRoot, opts.out);
+            await promises_1.default.writeFile(outPath, md, "utf8");
+            if (opts.json) {
+                process.stdout.write(JSON.stringify({ ok: true, runId: run.runId, out: outPath }, null, 2) + "\n");
+            }
+            else {
+                process.stdout.write(`Wrote ${outPath}\n`);
+            }
+        }
+        finally {
+            persistence.close();
+        }
+    });
+}
+//# sourceMappingURL=report.js.map

package/dist/cli/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/cli/report.ts"],"names":[],"mappings":";;;;;AAKA,sDAgDC;AApDD,gEAAkC;AAClC,0DAA6B;AAC7B,4DAA8D;AAE9D,SAAgB,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,+CAA+C,CAAC;SAC5D,MAAM,CAAC,kBAAkB,EAAE,sBAAsB,EAAE,kBAAkB,CAAC;SACtE,MAAM,CAAC,QAAQ,EAAE,yBAAyB,EAAE,KAAK,CAAC;SAClD,MAAM,CAAC,KAAK,EAAE,IAAoC,EAAE,EAAE;QACrD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC/B,MAAM,WAAW,GAAG,MAAM,8BAAgB,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACjE,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,WAAW,CAAC,YAAY,EAAE,CAAC;YACvC,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;gBACzC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;gBACrB,OAAO;YACT,CAAC;YAED,MAAM,MAAM,GAAG,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YACxE,MAAM,EAAE,GAAG;gBACT,sBAAsB;gBACtB,EAAE;gBACF,eAAe,GAAG,CAAC,KAAK,IAAI;gBAC5B,eAAe,GAAG,CAAC,MAAM,IAAI;gBAC7B,gBAAgB,GAAG,CAAC,SAAS,IAAI;gBACjC,EAAE;gBACF,kBAAkB;gBAClB,EAAE;gBACF,GAAG,MAAM,CAAC,GAAG,CACX,CAAC,CAAC,EAAE,EAAE,CACJ,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,OAAO,EAAE,CACjF;gBACD,EAAE;aACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEb,MAAM,OAAO,GAAG,mBAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;YACjD,MAAM,kBAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;YAExC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAC7E,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,OAAO,IAAI,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,WAAW,CAAC,KAAK,EAAE,CAAC;QACtB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/run.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerRunCommand(program: Command): void;
+//# sourceMappingURL=run.d.ts.map

package/dist/cli/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/cli/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQzC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+EzD"}

package/dist/cli/run.js

@@ -0,0 +1,79 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerRunCommand = registerRunCommand;
+const node_path_1 = __importDefault(require("node:path"));
+const loader_1 = require("../core/spec/loader");
+const dag_1 = require("../core/spec/dag");
+const noop_1 = require("../core/backends/noop");
+const patch_mode_1 = require("../core/workspace/patch-mode");
+const loop_1 = require("../core/engine/loop");
+function registerRunCommand(program) {
+    program
+        .command("run")
+        .description("Execute the ralphy-spec engine loop")
+        .option("--backend <id>", "Backend id: cursor|opencode|claude-code", "cursor")
+        .option("--workspace <mode>", "Workspace mode: worktree|patch", "patch")
+        .option("--task <taskId>", "Run a single task (skips dependency checks)")
+        .option("--dry-run", "Validate spec and print plan only", false)
+        .option("--json", "Machine-readable output", false)
+        .action(async (opts) => {
+        const repoRoot = process.cwd();
+        const loader = new loader_1.SpecLoader(repoRoot);
+        let spec;
+        try {
+            spec = await loader.loadProjectSpec();
+        }
+        catch (e) {
+            process.stderr.write(e?.message ? String(e.message) : String(e));
+            process.stderr.write("\n");
+            process.exitCode = 4;
+            return;
+        }
+        // Always build DAG in run/dry-run to validate deps/cycles unless --task is used.
+        try {
+            if (!opts.task)
+                (0, dag_1.buildTaskDAG)(spec.tasks ?? []);
+        }
+        catch (e) {
+            process.stderr.write(e?.message ? String(e.message) : String(e));
+            process.stderr.write("\n");
+            process.exitCode = 4;
+            return;
+        }
+        if (opts.dryRun) {
+            const dag = (0, dag_1.buildTaskDAG)(spec.tasks ?? []);
+            const plan = opts.task ? [opts.task] : dag.order;
+            const out = { ok: true, dryRun: true, plan };
+            process.stdout.write(opts.json ? JSON.stringify(out, null, 2) + "\n" : `${plan.join("\n")}\n`);
+            return;
+        }
+        if (opts.workspace === "worktree") {
+            process.stderr.write(`Workspace mode "worktree" is not implemented in this MVP. Use --workspace patch.\n`);
+            process.exitCode = 6;
+            return;
+        }
+        const backend = new noop_1.NoopBackend(opts.backend);
+        const workspace = new patch_mode_1.PatchModeWorkspace(node_path_1.default.resolve(repoRoot));
+        const engine = new loop_1.EngineLoop();
+        const outcome = await engine.run({
+            repoRoot,
+            spec,
+            backend,
+            workspace,
+            taskId: opts.task,
+            dryRun: false,
+            json: opts.json,
+        });
+        if (opts.json) {
+            process.stdout.write(JSON.stringify(outcome, null, 2) + "\n");
+        }
+        else {
+            process.stdout.write(outcome.ok ? `OK: ${outcome.runId}\n` : `STOP: ${outcome.runId} (${outcome.exitCode}) ${outcome.reason}\n`);
+        }
+        process.exitCode = outcome.ok ? 0 : outcome.exitCode;
+    });
+}
+//# sourceMappingURL=run.js.map

package/dist/cli/run.js.map

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

package/dist/cli/status.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerStatusCommand(program: Command): void;
+//# sourceMappingURL=status.d.ts.map

package/dist/cli/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/cli/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2C5D"}

package/dist/cli/status.js

@@ -0,0 +1,45 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerStatusCommand = registerStatusCommand;
+const cli_table3_1 = __importDefault(require("cli-table3"));
+const persistence_1 = require("../core/memory/persistence");
+function registerStatusCommand(program) {
+    program
+        .command("status")
+        .description("Show current/most recent run status")
+        .option("--json", "Machine-readable output", false)
+        .action(async (opts) => {
+        const repoRoot = process.cwd();
+        const persistence = await persistence_1.PersistenceLayer.openForRepo(repoRoot);
+        try {
+            const run = persistence.getLatestRun();
+            if (!run) {
+                process.stdout.write(opts.json ? JSON.stringify({ ok: true, run: null }) + "\n" : "No runs found.\n");
+                return;
+            }
+            const ledger = persistence.listLedger({ runId: run.runId, limit: 20 });
+            if (opts.json) {
+                process.stdout.write(JSON.stringify({
+                    ok: true,
+                    runSummary: run,
+                    recentLedger: ledger,
+                }, null, 2) + "\n");
+                return;
+            }
+            const table = new cli_table3_1.default({ head: ["Field", "Value"] });
+            table.push(["runId", run.runId], ["status", run.status], ["startedAt", run.startedAt]);
+            process.stdout.write(table.toString() + "\n\n");
+            process.stdout.write("Recent events:\n");
+            for (const ev of ledger) {
+                process.stdout.write(`- ${ev.ts} ${ev.kind}${ev.taskId ? ` [${ev.taskId}]` : ""}: ${ev.message}\n`);
+            }
+        }
+        finally {
+            persistence.close();
+        }
+    });
+}
+//# sourceMappingURL=status.js.map

package/dist/cli/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/cli/status.ts"],"names":[],"mappings":";;;;;AAIA,sDA2CC;AA9CD,4DAA+B;AAC/B,4DAA8D;AAE9D,SAAgB,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,qCAAqC,CAAC;SAClD,MAAM,CAAC,QAAQ,EAAE,yBAAyB,EAAE,KAAK,CAAC;SAClD,MAAM,CAAC,KAAK,EAAE,IAAuB,EAAE,EAAE;QACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC/B,MAAM,WAAW,GAAG,MAAM,8BAAgB,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACjE,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,WAAW,CAAC,YAAY,EAAE,CAAC;YACvC,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;gBACtG,OAAO;YACT,CAAC;YAED,MAAM,MAAM,GAAG,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;YAEvE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI,CAAC,SAAS,CACZ;oBACE,EAAE,EAAE,IAAI;oBACR,UAAU,EAAE,GAAG;oBACf,YAAY,EAAE,MAAM;iBACrB,EACD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI,CACT,CAAC;gBACF,OAAO;YACT,CAAC;YAED,MAAM,KAAK,GAAG,IAAI,oBAAK,CAAC,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;YACtD,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;YACvF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,MAAM,CAAC,CAAC;YAChD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;YACzC,KAAK,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;gBACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,OAAO,IAAI,CAAC,CAAC;YACtG,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,WAAW,CAAC,KAAK,EAAE,CAAC;QACtB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/tail.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerTailCommand(program: Command): void;
+//# sourceMappingURL=tail.d.ts.map

package/dist/cli/tail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tail.d.ts","sourceRoot":"","sources":["../../src/cli/tail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6C1D"}

package/dist/cli/tail.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerTailCommand = registerTailCommand;
+const persistence_1 = require("../core/memory/persistence");
+function registerTailCommand(program) {
+    program
+        .command("tail")
+        .description("Stream ledger events for the latest run (polling)")
+        .option("--interval-ms <n>", "Polling interval (ms)", "1000")
+        .action(async (opts) => {
+        const intervalMs = Number(opts.intervalMs);
+        const repoRoot = process.cwd();
+        const persistence = await persistence_1.PersistenceLayer.openForRepo(repoRoot);
+        const run = persistence.getLatestRun();
+        if (!run) {
+            persistence.close();
+            process.stderr.write("No runs found.\n");
+            process.exitCode = 1;
+            return;
+        }
+        process.stdout.write(`Tailing run ${run.runId}...\n`);
+        let lastCount = 0;
+        const timer = setInterval(() => {
+            try {
+                const ledger = persistence.listLedger({ runId: run.runId, limit: 200 });
+                const newEvents = ledger.slice(lastCount);
+                for (const ev of newEvents) {
+                    process.stdout.write(`${ev.ts} ${ev.kind}${ev.taskId ? ` [${ev.taskId}]` : ""}: ${ev.message}\n`);
+                }
+                lastCount = ledger.length;
+            }
+            catch (e) {
+                process.stderr.write(e?.message ? String(e.message) : String(e));
+                process.stderr.write("\n");
+            }
+        }, Number.isFinite(intervalMs) ? intervalMs : 1000);
+        const shutdown = () => {
+            clearInterval(timer);
+            persistence.close();
+            process.exit(0);
+        };
+        process.on("SIGINT", shutdown);
+        process.on("SIGTERM", shutdown);
+    });
+}
+//# sourceMappingURL=tail.js.map

package/dist/cli/tail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tail.js","sourceRoot":"","sources":["../../src/cli/tail.ts"],"names":[],"mappings":";;AAGA,kDA6CC;AA/CD,4DAA8D;AAE9D,SAAgB,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,mDAAmD,CAAC;SAChE,MAAM,CAAC,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,CAAC;SAC5D,MAAM,CAAC,KAAK,EAAE,IAA4B,EAAE,EAAE;QAC7C,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC/B,MAAM,WAAW,GAAG,MAAM,8BAAgB,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACjE,MAAM,GAAG,GAAG,WAAW,CAAC,YAAY,EAAE,CAAC;QACvC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,WAAW,CAAC,KAAK,EAAE,CAAC;YACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;YACzC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,GAAG,CAAC,KAAK,OAAO,CAAC,CAAC;QAEtD,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;YAC7B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;gBACxE,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBAC1C,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;oBAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,OAAO,IAAI,CAC5E,CAAC;gBACJ,CAAC;gBACD,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC;YAC5B,CAAC;YAAC,OAAO,CAAM,EAAE,CAAC;gBAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;gBACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAEpD,MAAM,QAAQ,GAAG,GAAG,EAAE;YACpB,aAAa,CAAC,KAAK,CAAC,CAAC;YACrB,WAAW,CAAC,KAAK,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC;QAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/update.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerUpdateCommand(program: Command): void;
+//# sourceMappingURL=update.d.ts.map

package/dist/cli/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/cli/update.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuCzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwB5D"}

package/dist/cli/update.js

@@ -0,0 +1,62 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerUpdateCommand = registerUpdateCommand;
+const inquirer_1 = __importDefault(require("inquirer"));
+const detector_1 = require("../utils/detector");
+const installer_1 = require("../utils/installer");
+const paths_1 = require("../utils/paths");
+function parseToolsArg(arg) {
+    if (!arg)
+        return undefined;
+    const parts = arg
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+    const allowed = ["cursor", "claude-code", "opencode"];
+    const tools = [];
+    for (const p of parts) {
+        if (allowed.includes(p))
+            tools.push(p);
+    }
+    return tools.length ? tools : undefined;
+}
+async function promptForTools(defaultTools) {
+    const { tools } = await inquirer_1.default.prompt([
+        {
+            type: "checkbox",
+            name: "tools",
+            message: "Which AI tools do you want to update templates for?",
+            choices: [
+                { name: "Cursor", value: "cursor" },
+                { name: "Claude Code", value: "claude-code" },
+                { name: "OpenCode", value: "opencode" },
+            ],
+            default: defaultTools,
+        },
+    ]);
+    return tools;
+}
+function registerUpdateCommand(program) {
+    program
+        .command("update")
+        .description("Update Ralph-OpenSpec templates in a project")
+        .option("--dir <path>", "Target project directory (default: current directory)")
+        .option("--tools <list>", "Comma-separated list: cursor,claude-code,opencode")
+        .option("--force", "Overwrite existing files", false)
+        .action(async (opts) => {
+        const dir = (0, paths_1.resolveProjectDir)(opts.dir);
+        const parsed = parseToolsArg(opts.tools);
+        const detected = await (0, detector_1.detectExistingTools)(dir);
+        const defaultTools = parsed ??
+            (detected.length
+                ? detected
+                : ["cursor", "claude-code", "opencode"]);
+        const tools = parsed ?? (await promptForTools(defaultTools));
+        await (0, installer_1.installToolTemplates)(dir, tools, { force: opts.force });
+        process.stdout.write(`Updated templates in ${dir}\nUpdated tools: ${tools.join(", ")}\n`);
+    });
+}
+//# sourceMappingURL=update.js.map

package/dist/cli/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/cli/update.ts"],"names":[],"mappings":";;;;;AAuCA,sDAwBC;AA9DD,wDAAgC;AAEhC,gDAAwD;AACxD,kDAA0D;AAC1D,0CAAmD;AAEnD,SAAS,aAAa,CAAC,GAAY;IACjC,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,MAAM,KAAK,GAAG,GAAG;SACd,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC,CAAC;IAEnB,MAAM,OAAO,GAAa,CAAC,QAAQ,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC;IAChE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAK,OAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,CAAW,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1C,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,YAAsB;IAClD,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,kBAAQ,CAAC,MAAM,CAAsB;QAC3D;YACE,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,qDAAqD;YAC9D,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAyB,EAAE;gBACpD,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,aAA8B,EAAE;gBAC9D,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAA2B,EAAE;aACzD;YACD,OAAO,EAAE,YAAY;SACtB;KACF,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAgB,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,8CAA8C,CAAC;SAC3D,MAAM,CAAC,cAAc,EAAE,uDAAuD,CAAC;SAC/E,MAAM,CAAC,gBAAgB,EAAE,mDAAmD,CAAC;SAC7E,MAAM,CAAC,SAAS,EAAE,0BAA0B,EAAE,KAAK,CAAC;SACpD,MAAM,CAAC,KAAK,EAAE,IAAsD,EAAE,EAAE;QACvE,MAAM,GAAG,GAAG,IAAA,yBAAiB,EAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,MAAM,IAAA,8BAAmB,EAAC,GAAG,CAAC,CAAC;QAChD,MAAM,YAAY,GAChB,MAAM;YACN,CAAC,QAAQ,CAAC,MAAM;gBACd,CAAC,CAAC,QAAQ;gBACV,CAAC,CAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,UAAU,CAAc,CAAC,CAAC;QAE3D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC;QAC7D,MAAM,IAAA,gCAAoB,EAAC,GAAG,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAE9D,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,wBAAwB,GAAG,oBAAoB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CACpE,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/validate.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerValidateCommand(program: Command): void;
+//# sourceMappingURL=validate.d.ts.map

package/dist/cli/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/cli/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuBzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsE9D"}

package/dist/cli/validate.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerValidateCommand = registerValidateCommand;
+const detector_1 = require("../utils/detector");
+const paths_1 = require("../utils/paths");
+const validator_1 = require("../utils/validator");
+const loader_1 = require("../core/spec/loader");
+const runner_1 = require("../core/validators/runner");
+function parseToolsArg(arg) {
+    if (!arg)
+        return undefined;
+    const parts = arg
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+    const allowed = ["cursor", "claude-code", "opencode"];
+    const tools = [];
+    for (const p of parts) {
+        if (allowed.includes(p))
+            tools.push(p);
+    }
+    return tools.length ? tools : undefined;
+}
+function registerValidateCommand(program) {
+    program
+        .command("validate")
+        .description("Validate that Ralph-OpenSpec setup is complete")
+        .option("--dir <path>", "Target project directory (default: current directory)")
+        .option("--task <taskId>", "Validate a specific task via validators (v2)")
+        .option("--tools <list>", "Comma-separated list: cursor,claude-code,opencode (default: detect)")
+        .action(async (opts) => {
+        const dir = (0, paths_1.resolveProjectDir)(opts.dir);
+        if (opts.task) {
+            try {
+                const loader = new loader_1.SpecLoader(dir);
+                const spec = await loader.loadProjectSpec();
+                const task = (spec.tasks ?? []).find((t) => t.id === opts.task);
+                if (!task) {
+                    process.stderr.write(`Unknown task id: ${opts.task}\n`);
+                    process.exitCode = 4;
+                    return;
+                }
+                const ids = task.validators ?? spec.defaults.validators ?? [];
+                const validators = (spec.validators ?? [])
+                    .filter((v) => ids.includes(v.id))
+                    .map((v) => ({
+                    id: v.id,
+                    run: v.run,
+                    timeoutMs: v.timeoutSeconds ? v.timeoutSeconds * 1000 : undefined,
+                    parser: v.parser,
+                })) ?? [];
+                const runner = new runner_1.ValidatorRunner({
+                    cwd: dir,
+                    commandTimeoutMs: (spec.budgets?.limits?.commandTimeoutSeconds ?? 900) * 1000,
+                });
+                const results = await runner.runAll(validators);
+                process.stdout.write(JSON.stringify({ ok: true, taskId: task.id, results }, null, 2) + "\n");
+                const hasErrors = Object.values(results).some((r) => !r.ok);
+                process.exitCode = hasErrors ? 1 : 0;
+                return;
+            }
+            catch (e) {
+                process.stderr.write(e?.message ? String(e.message) : String(e));
+                process.stderr.write("\n");
+                process.exitCode = 4;
+                return;
+            }
+        }
+        const tools = parseToolsArg(opts.tools) ?? (await (0, detector_1.detectExistingTools)(dir));
+        const issues = await (0, validator_1.validateProject)(dir, tools);
+        if (!issues.length) {
+            process.stdout.write("OK: Ralph-OpenSpec setup looks good.\n");
+            return;
+        }
+        for (const issue of issues) {
+            const prefix = issue.level === "error" ? "ERROR" : "WARN";
+            process.stdout.write(`${prefix}: ${issue.message}${issue.path ? ` (${issue.path})` : ""}\n`);
+        }
+        const hasErrors = issues.some((i) => i.level === "error");
+        process.exitCode = hasErrors ? 1 : 0;
+    });
+}
+//# sourceMappingURL=validate.js.map

package/dist/cli/validate.js.map

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

package/dist/core/backends/claude-code.d.ts

@@ -0,0 +1,17 @@
+import type { BackendEnv, CodingBackend, ImplementInput, ImplementOutput } from "./types";
+/**
+ * ClaudeCodeBackend shells out to the `claude` CLI for code implementation.
+ *
+ * Claude Code (Anthropic's coding assistant) supports headless operation
+ * via the claude CLI with --print or --output-format json flags.
+ */
+export declare class ClaudeCodeBackend implements CodingBackend {
+    private readonly opts;
+    readonly id = "claude-code";
+    constructor(opts?: {
+        timeoutMs?: number;
+    });
+    implement(env: BackendEnv, input: ImplementInput): Promise<ImplementOutput>;
+    private buildPrompt;
+}
+//# sourceMappingURL=claude-code.d.ts.map

package/dist/core/backends/claude-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../../src/core/backends/claude-code.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1F;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IAGzC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,QAAQ,CAAC,EAAE,iBAAiB;gBAEC,IAAI,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO;IAExD,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAgDjF,OAAO,CAAC,WAAW;CA0BpB"}

package/dist/core/backends/claude-code.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClaudeCodeBackend = void 0;
+const execa_1 = require("execa");
+/**
+ * ClaudeCodeBackend shells out to the `claude` CLI for code implementation.
+ *
+ * Claude Code (Anthropic's coding assistant) supports headless operation
+ * via the claude CLI with --print or --output-format json flags.
+ */
+class ClaudeCodeBackend {
+    opts;
+    id = "claude-code";
+    constructor(opts = {}) {
+        this.opts = opts;
+    }
+    async implement(env, input) {
+        const { task, iteration, repairNotes } = input;
+        // Build the prompt to send to Claude Code
+        const prompt = this.buildPrompt(task, iteration, repairNotes);
+        try {
+            // Claude CLI: `claude --print "prompt"` for headless operation
+            // The --print flag runs claude non-interactively
+            const result = await (0, execa_1.execa)("claude", ["--print", prompt], {
+                cwd: env.cwd,
+                timeout: this.opts.timeoutMs ?? 600_000, // 10 min default
+                reject: false,
+                stdio: "pipe",
+            });
+            if (result.exitCode === 0) {
+                return {
+                    ok: true,
+                    message: `Claude Code completed task "${task.id}" (iteration ${iteration})`,
+                };
+            }
+            // Non-zero exit code
+            return {
+                ok: false,
+                message: `Claude Code exited with code ${result.exitCode}: ${result.stderr || result.stdout}`.slice(0, 2000),
+            };
+        }
+        catch (err) {
+            // Handle cases where claude CLI is not available
+            if (err?.code === "ENOENT") {
+                return {
+                    ok: false,
+                    message: "Claude CLI not found. Please ensure Claude Code is installed and the CLI is in PATH.",
+                };
+            }
+            return {
+                ok: false,
+                message: err?.message ? String(err.message).slice(0, 2000) : "Unknown error",
+            };
+        }
+    }
+    buildPrompt(task, iteration, repairNotes) {
+        const lines = [];
+        lines.push(`# Task: ${task.title ?? task.id}`);
+        lines.push(``);
+        if (task.goal) {
+            lines.push(`## Goal`);
+            lines.push(task.goal);
+            lines.push(``);
+        }
+        if (repairNotes) {
+            lines.push(`## Repair Notes (iteration ${iteration})`);
+            lines.push(repairNotes);
+            lines.push(``);
+        }
+        lines.push(`Please implement this task and ensure all validators pass.`);
+        return lines.join("\n");
+    }
+}
+exports.ClaudeCodeBackend = ClaudeCodeBackend;
+//# sourceMappingURL=claude-code.js.map