ralphy-spec 0.1.1 → 0.3.0

package/dist/cli/checkpoint.js

@@ -0,0 +1,23 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCheckpointCommand = registerCheckpointCommand;
+const node_path_1 = __importDefault(require("node:path"));
+const patch_mode_1 = require("../core/workspace/patch-mode");
+function registerCheckpointCommand(program) {
+    program
+        .command("checkpoint")
+        .description("Create a manual checkpoint commit (patch-mode only)")
+        .requiredOption("--task <taskId>", "Task id")
+        .requiredOption("--message <message>", "Checkpoint message")
+        .action(async (opts) => {
+        const repoRoot = process.cwd();
+        const ws = new patch_mode_1.PatchModeWorkspace(node_path_1.default.resolve(repoRoot));
+        await ws.prepare(opts.task);
+        const ref = await ws.checkpoint(opts.task, opts.message);
+        process.stdout.write(`Checkpoint ${ref.ref}\n`);
+    });
+}
+//# sourceMappingURL=checkpoint.js.map

package/dist/cli/checkpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.js","sourceRoot":"","sources":["../../src/cli/checkpoint.ts"],"names":[],"mappings":";;;;;AAIA,8DAaC;AAhBD,0DAA6B;AAC7B,6DAAkE;AAElE,SAAgB,yBAAyB,CAAC,OAAgB;IACxD,OAAO;SACJ,OAAO,CAAC,YAAY,CAAC;SACrB,WAAW,CAAC,qDAAqD,CAAC;SAClE,cAAc,CAAC,iBAAiB,EAAE,SAAS,CAAC;SAC5C,cAAc,CAAC,qBAAqB,EAAE,oBAAoB,CAAC;SAC3D,MAAM,CAAC,KAAK,EAAE,IAAuC,EAAE,EAAE;QACxD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC/B,MAAM,EAAE,GAAG,IAAI,+BAAkB,CAAC,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC1D,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACzD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/init.d.ts

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

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

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

package/dist/cli/init.js

@@ -0,0 +1,72 @@
+"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");
+const folders_1 = require("../core/folders");
+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 });
+        await (0, folders_1.ensureRalphyFolders)(options.dir);
+        process.stdout.write(`Initialized Ralph-OpenSpec in ${options.dir}\nConfigured tools: ${tools.join(", ")}\n`);
+        process.stdout.write(`\nArtifact folder created: ${(0, folders_1.getRalphyRoot)(options.dir)}\n` +
+            `\n.gitignore suggestions:\n` +
+            `- Commit: ${(0, folders_1.getRalphyRoot)(options.dir)}/STATUS.md, ${(0, folders_1.getRalphyRoot)(options.dir)}/TASKS.md, ${(0, folders_1.getRalphyRoot)(options.dir)}/BUDGET.md\n` +
+            `- Ignore: ${(0, folders_1.getRalphyRoot)(options.dir)}/state.db, ${(0, folders_1.getRalphyRoot)(options.dir)}/runs/, ${(0, folders_1.getRalphyRoot)(options.dir)}/logs/, ${(0, folders_1.getRalphyRoot)(options.dir)}/worktrees/\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;AA4BzC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiGzD"}

package/dist/cli/run.js

@@ -0,0 +1,112 @@
+"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 claude_code_1 = require("../core/backends/claude-code");
+const cursor_1 = require("../core/backends/cursor");
+const noop_1 = require("../core/backends/noop");
+const opencode_1 = require("../core/backends/opencode");
+const patch_mode_1 = require("../core/workspace/patch-mode");
+const worktree_mode_1 = require("../core/workspace/worktree-mode");
+const loop_1 = require("../core/engine/loop");
+function createBackend(id) {
+    switch (id) {
+        case "cursor":
+            return new cursor_1.CursorBackend();
+        case "opencode":
+            return new opencode_1.OpenCodeBackend();
+        case "claude-code":
+            return new claude_code_1.ClaudeCodeBackend();
+        case "noop":
+            return new noop_1.NoopBackend("noop");
+        default:
+            // Fallback: treat as noop for unknown ids (but retain id for diagnostics).
+            return new noop_1.NoopBackend(id);
+    }
+}
+function registerRunCommand(program) {
+    program
+        .command("run")
+        .description("Execute the ralphy-spec engine loop")
+        .option("--backend <id>", "Backend id: cursor|opencode|claude-code|noop")
+        .option("--workspace <mode>", "Workspace mode: worktree|patch")
+        .option("--artifact-dir <dir>", "Override artifact root directory (enables artifacts)")
+        .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)
+        .addHelpText("after", `\nConcepts:\n` +
+        `- Budget tiers: optimal -> warning -> hard. WARNING enables degrade behaviors; HARD blocks the task.\n` +
+        `- Sprint sizing: XS/S/M/L/XL (optional per task via sprint.size).\n` +
+        `- Sprint intent: fix|feature|refactor|infra (optional per task via sprint.intent).\n`)
+        .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;
+        }
+        if (opts.artifactDir) {
+            spec = {
+                ...spec,
+                artifacts: {
+                    ...(spec.artifacts ?? {}),
+                    enabled: true,
+                    rootDir: opts.artifactDir,
+                },
+            };
+        }
+        // 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;
+        }
+        const backendId = opts.backend ?? spec.defaults.backend ?? "cursor";
+        const workspaceMode = opts.workspace ?? spec.defaults.workspaceMode ?? "patch";
+        const backend = createBackend(backendId);
+        const workspace = workspaceMode === "worktree"
+            ? new worktree_mode_1.WorktreeModeWorkspace(node_path_1.default.resolve(repoRoot))
+            : 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;AAQzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2E5D"}

package/dist/cli/status.js

@@ -0,0 +1,76 @@
+"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 promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const cli_table3_1 = __importDefault(require("cli-table3"));
+const persistence_1 = require("../core/memory/persistence");
+const folders_1 = require("../core/folders");
+const loader_1 = require("../core/spec/loader");
+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();
+        // Artifact-first: if STATUS.md exists, display it as primary source of truth.
+        const candidateRoots = [];
+        try {
+            const spec = await new loader_1.SpecLoader(repoRoot).loadProjectSpec();
+            if (spec.artifacts?.rootDir)
+                candidateRoots.push(spec.artifacts.rootDir);
+        }
+        catch {
+            // ignore spec load failures
+        }
+        candidateRoots.push(undefined); // default
+        for (const rootDir of candidateRoots) {
+            const statusPath = node_path_1.default.join((0, folders_1.getRalphyRoot)(repoRoot, rootDir), folders_1.FILES.status);
+            try {
+                const statusMd = await promises_1.default.readFile(statusPath, "utf8");
+                if (opts.json) {
+                    process.stdout.write(JSON.stringify({ ok: true, source: "artifact", statusPath, statusMarkdown: statusMd }, null, 2) + "\n");
+                }
+                else {
+                    process.stdout.write(statusMd.trimEnd() + "\n");
+                }
+                return;
+            }
+            catch {
+                // try next candidate
+            }
+        }
+        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":"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"}

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