ralphy-spec 0.1.0

package/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, Wenqing Yu
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,182 @@
+# ralphy-spec
+
+One-command setup for **Ralph loop + OpenSpec** workflows across:
+- Cursor
+- OpenCode
+- Claude Code
+
+**Website:** [https://ralphy-spec.org](https://ralphy-spec.org)
+
+## What is Ralphy-Spec?
+
+Ralphy-Spec combines two powerful AI development methodologies:
+
+### The Ralph Wiggum Loop
+
+The Ralph methodology (coined by [Geoffrey Huntley](https://ghuntley.com/ralph)) is a development approach where an AI agent receives the **same prompt repeatedly** until it completes a task. Each iteration, the AI sees its previous work in files and git history, creating a self-correction feedback loop.
+
+```
+while true; do
+  ai_agent "Build feature X. Output <promise>DONE</promise> when complete."
+  # AI sees previous work, fixes mistakes, continues progress
+done
+```
+
+### OpenSpec (Spec-Driven Development)
+
+[OpenSpec](https://github.com/Fission-AI/OpenSpec) brings structure to AI coding by requiring specs before code:
+- `openspec/specs/` - Source of truth specifications
+- `openspec/changes/` - Proposed changes with acceptance criteria
+- Archive workflow to merge completed changes back
+
+### Why Combine Them?
+
+| Problem | Solution |
+|---------|----------|
+| Vague requirements in chat history | OpenSpec locks intent in structured specs |
+| AI stops mid-task or makes mistakes | Ralph loop retries until completion |
+| No way to verify correctness | Acceptance criteria + tests validate output |
+| Tool-specific setup is tedious | One command sets up Cursor, OpenCode, Claude Code |
+
+## What it installs into your project
+
+- `openspec/` scaffold:
+  - `openspec/specs/` (source of truth)
+  - `openspec/changes/` (active changes)
+  - `openspec/archive/` (completed changes)
+  - `openspec/project.md` (project context)
+- Tool integrations:
+  - Cursor: `.cursor/prompts/ralphy-*.md`
+  - Claude Code: `.claude/commands/ralphy-*.md`
+  - OpenCode: `AGENTS.md`
+- Ralph loop state/config:
+  - `.ralphy/config.json`
+  - `.ralphy/ralph-loop.state.json`
+
+## Installation
+
+### npm (global)
+
+```bash
+npm install -g ralphy-spec
+```
+
+### npx (no install)
+
+```bash
+npx ralphy-spec init
+```
+
+### curl install script
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/anthropics/ralphy-openspec/main/scripts/install.sh | sh
+```
+
+## Usage
+
+### Initialize in a project
+
+```bash
+cd your-project
+ralphy-spec init
+```
+
+Non-interactive tool selection:
+
+```bash
+ralphy-spec init --tools cursor,claude-code,opencode
+```
+
+Overwrite existing files:
+
+```bash
+ralphy-spec init --force
+```
+
+### Validate setup
+
+```bash
+ralphy-spec validate
+```
+
+### Update templates
+
+```bash
+ralphy-spec update --force
+```
+
+## Workflow (PRD -> Ship)
+
+```
+PRD/Requirements --> OpenSpec (specs + tasks + acceptance criteria)
+                          |
+                          v
+                    Ralph Loop (iterate until tests pass)
+                          |
+                          v
+                    Archive (merge back to source specs)
+```
+
+### 1) Plan: PRD -> OpenSpec change
+
+Use your AI tool with `/ralphy:plan` (Cursor / Claude Code), or ask OpenCode to follow `AGENTS.md`.
+
+Expected output in your repo:
+
+```
+openspec/changes/<change-name>/
+  proposal.md
+  tasks.md
+  specs/
+    <domain>/
+      spec.md
+```
+
+### 2) Implement: iterate until done
+
+Use `/ralphy:implement` to implement tasks and add tests.
+
+If you run this via a Ralph loop runner, the agent should only output:
+
+```
+<promise>TASK_COMPLETE</promise>
+```
+
+when **all tasks are done and tests pass**.
+
+### 3) Validate: tests prove acceptance criteria
+
+Use `/ralphy:validate` to run tests and map passing tests back to OpenSpec scenarios.
+
+### 4) Archive: merge change back into specs
+
+Use `/ralphy:archive` and (if available) the OpenSpec CLI:
+
+```bash
+openspec archive <change-name> --yes
+```
+
+## Credits and Appreciation
+
+Ralphy-Spec stands on the shoulders of giants:
+
+- **Ralph Wiggum Methodology** - Conceived by [Geoffrey Huntley](https://ghuntley.com/ralph). The insight that AI agents can self-correct through iteration changed how we think about AI-assisted development.
+
+- **[opencode-ralph-wiggum](https://github.com/Th0rgal/opencode-ralph-wiggum)** by [@Th0rgal](https://github.com/Th0rgal) - A clean CLI implementation of the Ralph loop for OpenCode that inspired our integration approach.
+
+- **[OpenSpec](https://github.com/Fission-AI/OpenSpec)** by [Fission-AI](https://github.com/Fission-AI) - The spec-driven development framework that brings structure and predictability to AI coding. Their `specs/` + `changes/` model is elegant and practical.
+
+We are grateful to these projects and their maintainers for pioneering these approaches.
+
+## Development
+
+```bash
+npm install
+npm run build
+node bin/ralphy-spec.js --help
+```
+
+## License
+
+BSD-3-Clause

package/bin/ralphy-spec.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+
+/* eslint-disable @typescript-eslint/no-var-requires */
+require("../dist/index.js");

package/dist/commands/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/commands/init.d.ts.map

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

package/dist/commands/init.js

@@ -0,0 +1,63 @@
+"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/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":";;;;;AAuCA,kDA+BC;AArED,wDAAgC;AAEhC,gDAAwD;AACxD,kDAAkF;AAClF,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,0CAA0C;YACnD,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,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,yDAAyD,CAAC;SACtE,MAAM,CAAC,cAAc,EAAE,uDAAuD,CAAC;SAC/E,MAAM,CACL,gBAAgB,EAChB,mDAAmD,CACpD;SACA,MAAM,CAAC,SAAS,EAAE,0BAA0B,EAAE,KAAK,CAAC;SACpD,MAAM,CAAC,KAAK,EAAE,IAAsD,EAAE,EAAE;QACvE,MAAM,OAAO,GAAgB;YAC3B,GAAG,EAAE,IAAA,yBAAiB,EAAC,IAAI,CAAC,GAAG,CAAC;YAChC,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC;YAChC,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,IAAA,8BAAmB,EAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACxD,MAAM,YAAY,GAChB,OAAO,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,UAAU,CAAc,CAAC,CAAC;QACtG,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,MAAM,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC;QAEpE,MAAM,IAAA,kCAAsB,EAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,IAAA,gCAAoB,EAAC,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QAEzE,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,iCAAiC,OAAO,CAAC,GAAG,uBAAuB,KAAK,CAAC,IAAI,CAC3E,IAAI,CACL,IAAI,CACN,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/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/commands/update.d.ts.map

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

package/dist/commands/update.js

@@ -0,0 +1,59 @@
+"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/commands/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":";;;;;AAuCA,sDAqBC;AA3DD,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,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,UAAU,CAAc,CAAC,CAAC;QAE/F,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/commands/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/commands/validate.d.ts.map

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

package/dist/commands/validate.js

@@ -0,0 +1,44 @@
+"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");
+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("--tools <list>", "Comma-separated list: cursor,claude-code,opencode (default: detect)")
+        .action(async (opts) => {
+        const dir = (0, paths_1.resolveProjectDir)(opts.dir);
+        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/commands/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":";;AAqBA,0DA6BC;AAhDD,gDAAwD;AACxD,0CAAmD;AACnD,kDAAqD;AAErD,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,SAAgB,uBAAuB,CAAC,OAAgB;IACtD,OAAO;SACJ,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,gDAAgD,CAAC;SAC7D,MAAM,CAAC,cAAc,EAAE,uDAAuD,CAAC;SAC/E,MAAM,CACL,gBAAgB,EAChB,qEAAqE,CACtE;SACA,MAAM,CAAC,KAAK,EAAE,IAAsC,EAAE,EAAE;QACvD,MAAM,GAAG,GAAG,IAAA,yBAAiB,EAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,IAAA,8BAAmB,EAAC,GAAG,CAAC,CAAC,CAAC;QAC5E,MAAM,MAAM,GAAG,MAAM,IAAA,2BAAe,EAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAEjD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;YAC/D,OAAO;QACT,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;YAC1D,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,MAAM,KAAK,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CACvE,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC;QAC1D,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const init_1 = require("./commands/init");
+const validate_1 = require("./commands/validate");
+const update_1 = require("./commands/update");
+function buildProgram() {
+    const program = new commander_1.Command();
+    program
+        .name("ralphy-spec")
+        .description("One-command setup for Ralph loop + OpenSpec workflows across Cursor, OpenCode, and Claude Code.")
+        .version("0.1.0");
+    (0, init_1.registerInitCommand)(program);
+    (0, validate_1.registerValidateCommand)(program);
+    (0, update_1.registerUpdateCommand)(program);
+    return program;
+}
+async function main() {
+    const program = buildProgram();
+    await program.parseAsync(process.argv);
+}
+// eslint-disable-next-line @typescript-eslint/no-floating-promises
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAAA,yCAAoC;AACpC,0CAAsD;AACtD,kDAA8D;AAC9D,8CAA0D;AAE1D,SAAS,YAAY;IACnB,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,aAAa,CAAC;SACnB,WAAW,CACV,iGAAiG,CAClG;SACA,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB,IAAA,0BAAmB,EAAC,OAAO,CAAC,CAAC;IAC7B,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;IACjC,IAAA,8BAAqB,EAAC,OAAO,CAAC,CAAC;IAE/B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,YAAY,EAAE,CAAC;IAC/B,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,mEAAmE;AACnE,IAAI,EAAE,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,12 @@
+export type ToolId = "cursor" | "claude-code" | "opencode";
+export type InitOptions = {
+    dir: string;
+    tools?: ToolId[];
+    force: boolean;
+};
+export type ValidationIssue = {
+    level: "error" | "warning";
+    message: string;
+    path?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,GAAG,QAAQ,GAAG,aAAa,GAAG,UAAU,CAAC;AAE3D,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/detector.d.ts

@@ -0,0 +1,3 @@
+import type { ToolId } from "../types";
+export declare function detectExistingTools(projectDir: string): Promise<ToolId[]>;
+//# sourceMappingURL=detector.d.ts.map

package/dist/utils/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../src/utils/detector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAWvC,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAQ/E"}

package/dist/utils/detector.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectExistingTools = detectExistingTools;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+async function exists(p) {
+    try {
+        await promises_1.default.access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function detectExistingTools(projectDir) {
+    const found = new Set();
+    if (await exists(node_path_1.default.join(projectDir, ".cursor")))
+        found.add("cursor");
+    if (await exists(node_path_1.default.join(projectDir, ".claude")))
+        found.add("claude-code");
+    if (await exists(node_path_1.default.join(projectDir, "AGENTS.md")))
+        found.add("opencode");
+    return [...found];
+}
+//# sourceMappingURL=detector.js.map

package/dist/utils/detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.js","sourceRoot":"","sources":["../../src/utils/detector.ts"],"names":[],"mappings":";;;;;AAaA,kDAQC;AArBD,gEAAkC;AAClC,0DAA6B;AAG7B,KAAK,UAAU,MAAM,CAAC,CAAS;IAC7B,IAAI,CAAC;QACH,MAAM,kBAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,mBAAmB,CAAC,UAAkB;IAC1D,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhC,IAAI,MAAM,MAAM,CAAC,mBAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QAAE,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxE,IAAI,MAAM,MAAM,CAAC,mBAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QAAE,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC7E,IAAI,MAAM,MAAM,CAAC,mBAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QAAE,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAE5E,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;AACpB,CAAC"}

package/dist/utils/installer.d.ts

@@ -0,0 +1,6 @@
+import type { ToolId } from "../types";
+export declare function ensureOpenSpecScaffold(projectDir: string): Promise<void>;
+export declare function installToolTemplates(projectDir: string, tools: ToolId[], opts: {
+    force: boolean;
+}): Promise<void>;
+//# sourceMappingURL=installer.d.ts.map

package/dist/utils/installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../src/utils/installer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAgBvC,wBAAsB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB9E;AAED,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,EAAE;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,GACvB,OAAO,CAAC,IAAI,CAAC,CA+Df"}

package/dist/utils/installer.js

@@ -0,0 +1,93 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureOpenSpecScaffold = ensureOpenSpecScaffold;
+exports.installToolTemplates = installToolTemplates;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const paths_1 = require("./paths");
+async function ensureDir(p) {
+    await promises_1.default.mkdir(p, { recursive: true });
+}
+async function writeFileIfMissing(filePath, contents) {
+    try {
+        await promises_1.default.access(filePath);
+    }
+    catch {
+        await ensureDir(node_path_1.default.dirname(filePath));
+        await promises_1.default.writeFile(filePath, contents, "utf8");
+    }
+}
+async function ensureOpenSpecScaffold(projectDir) {
+    const openspecDir = node_path_1.default.join(projectDir, "openspec");
+    await ensureDir(node_path_1.default.join(openspecDir, "specs"));
+    await ensureDir(node_path_1.default.join(openspecDir, "changes"));
+    await ensureDir(node_path_1.default.join(openspecDir, "archive"));
+    await writeFileIfMissing(node_path_1.default.join(openspecDir, "project.md"), [
+        "# Project Context",
+        "",
+        "Describe your project's tech stack, conventions, and architecture here.",
+        "",
+        "## Stack",
+        "- Language:",
+        "- Framework:",
+        "- Package manager:",
+        "",
+        "## Conventions",
+        "- Code style:",
+        "- Testing:",
+        "- CI:",
+        "",
+    ].join("\n"));
+}
+async function installToolTemplates(projectDir, tools, opts) {
+    const templatesRoot = (0, paths_1.getDistTemplatesDir)();
+    // Cursor
+    if (tools.includes("cursor")) {
+        const src = node_path_1.default.join(templatesRoot, "cursor");
+        const dst = node_path_1.default.join(projectDir, ".cursor", "prompts");
+        await fs_extra_1.default.ensureDir(dst);
+        await fs_extra_1.default.copy(src, dst, { overwrite: opts.force, errorOnExist: false });
+    }
+    // Claude Code
+    if (tools.includes("claude-code")) {
+        const src = node_path_1.default.join(templatesRoot, "claude-code");
+        const dst = node_path_1.default.join(projectDir, ".claude", "commands");
+        await fs_extra_1.default.ensureDir(dst);
+        await fs_extra_1.default.copy(src, dst, { overwrite: opts.force, errorOnExist: false });
+    }
+    // OpenCode / AGENTS.md
+    if (tools.includes("opencode")) {
+        const srcAgents = node_path_1.default.join(templatesRoot, "opencode", "AGENTS.md");
+        const dstAgents = node_path_1.default.join(projectDir, "AGENTS.md");
+        if (opts.force) {
+            await fs_extra_1.default.copyFile(srcAgents, dstAgents);
+        }
+        else {
+            // Only write if missing
+            try {
+                await promises_1.default.access(dstAgents);
+            }
+            catch {
+                await fs_extra_1.default.copyFile(srcAgents, dstAgents);
+            }
+        }
+    }
+    // Ralphy config/state
+    const ralphyDir = node_path_1.default.join(projectDir, ".ralphy");
+    await ensureDir(ralphyDir);
+    await writeFileIfMissing(node_path_1.default.join(ralphyDir, "config.json"), JSON.stringify({
+        testCommand: "npm test",
+        completionPromise: "TASK_COMPLETE",
+    }, null, 2) + "\n");
+    await writeFileIfMissing(node_path_1.default.join(ralphyDir, "ralph-loop.state.json"), JSON.stringify({
+        active: false,
+        change: null,
+        task: null,
+        iteration: 0,
+    }, null, 2) + "\n");
+}
+//# sourceMappingURL=installer.js.map

package/dist/utils/installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.js","sourceRoot":"","sources":["../../src/utils/installer.ts"],"names":[],"mappings":";;;;;AAmBA,wDAyBC;AAED,oDAmEC;AAjHD,gEAAkC;AAClC,0DAA6B;AAC7B,wDAA2B;AAE3B,mCAA8C;AAE9C,KAAK,UAAU,SAAS,CAAC,CAAS;IAChC,MAAM,kBAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,QAAgB,EAAE,QAAgB;IAClE,IAAI,CAAC;QACH,MAAM,kBAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,SAAS,CAAC,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QACxC,MAAM,kBAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjD,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,sBAAsB,CAAC,UAAkB;IAC7D,MAAM,WAAW,GAAG,mBAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACtD,MAAM,SAAS,CAAC,mBAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IACjD,MAAM,SAAS,CAAC,mBAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;IACnD,MAAM,SAAS,CAAC,mBAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;IAEnD,MAAM,kBAAkB,CACtB,mBAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,EACpC;QACE,mBAAmB;QACnB,EAAE;QACF,yEAAyE;QACzE,EAAE;QACF,UAAU;QACV,aAAa;QACb,cAAc;QACd,oBAAoB;QACpB,EAAE;QACF,gBAAgB;QAChB,eAAe;QACf,YAAY;QACZ,OAAO;QACP,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;AACJ,CAAC;AAEM,KAAK,UAAU,oBAAoB,CACxC,UAAkB,EAClB,KAAe,EACf,IAAwB;IAExB,MAAM,aAAa,GAAG,IAAA,2BAAmB,GAAE,CAAC;IAE5C,SAAS;IACT,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,mBAAI,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;QAC/C,MAAM,GAAG,GAAG,mBAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QACxD,MAAM,kBAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACzB,MAAM,kBAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,cAAc;IACd,IAAI,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,mBAAI,CAAC,IAAI,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;QACpD,MAAM,GAAG,GAAG,mBAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QACzD,MAAM,kBAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACzB,MAAM,kBAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,uBAAuB;IACvB,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,MAAM,SAAS,GAAG,mBAAI,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;QACpE,MAAM,SAAS,GAAG,mBAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QAErD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,kBAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,wBAAwB;YACxB,IAAI,CAAC;gBACH,MAAM,kBAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC7B,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,kBAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,MAAM,SAAS,GAAG,mBAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IACnD,MAAM,SAAS,CAAC,SAAS,CAAC,CAAC;IAC3B,MAAM,kBAAkB,CACtB,mBAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,EACnC,IAAI,CAAC,SAAS,CACZ;QACE,WAAW,EAAE,UAAU;QACvB,iBAAiB,EAAE,eAAe;KACnC,EACD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI,CACT,CAAC;IACF,MAAM,kBAAkB,CACtB,mBAAI,CAAC,IAAI,CAAC,SAAS,EAAE,uBAAuB,CAAC,EAC7C,IAAI,CAAC,SAAS,CACZ;QACE,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE,IAAI;QACV,SAAS,EAAE,CAAC;KACb,EACD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI,CACT,CAAC;AACJ,CAAC"}

package/dist/utils/paths.d.ts

@@ -0,0 +1,3 @@
+export declare function getDistTemplatesDir(): string;
+export declare function resolveProjectDir(dirArg?: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAEA,wBAAgB,mBAAmB,IAAI,MAAM,CAG5C;AAED,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/dist/utils/paths.js

@@ -0,0 +1,16 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDistTemplatesDir = getDistTemplatesDir;
+exports.resolveProjectDir = resolveProjectDir;
+const node_path_1 = __importDefault(require("node:path"));
+function getDistTemplatesDir() {
+    // Compiled files live in dist/**. This resolves dist/templates.
+    return node_path_1.default.resolve(__dirname, "..", "templates");
+}
+function resolveProjectDir(dirArg) {
+    return node_path_1.default.resolve(process.cwd(), dirArg ?? ".");
+}
+//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":";;;;;AAEA,kDAGC;AAED,8CAEC;AATD,0DAA6B;AAE7B,SAAgB,mBAAmB;IACjC,gEAAgE;IAChE,OAAO,mBAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;AACpD,CAAC;AAED,SAAgB,iBAAiB,CAAC,MAAe;IAC/C,OAAO,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,IAAI,GAAG,CAAC,CAAC;AACpD,CAAC"}

package/dist/utils/validator.d.ts

@@ -0,0 +1,3 @@
+import type { ToolId, ValidationIssue } from "../types";
+export declare function validateProject(projectDir: string, tools: ToolId[]): Promise<ValidationIssue[]>;
+//# sourceMappingURL=validator.d.ts.map

package/dist/utils/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/utils/validator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAWxD,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,eAAe,EAAE,CAAC,CAyC5B"}

package/dist/utils/validator.js

@@ -0,0 +1,54 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateProject = validateProject;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+async function exists(p) {
+    try {
+        await promises_1.default.access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function validateProject(projectDir, tools) {
+    const issues = [];
+    const openspecDir = node_path_1.default.join(projectDir, "openspec");
+    if (!(await exists(openspecDir))) {
+        issues.push({
+            level: "error",
+            message: "Missing openspec directory. Run `ralphy-openspec init`.",
+            path: "openspec/",
+        });
+        return issues;
+    }
+    for (const p of ["openspec/specs", "openspec/changes", "openspec/project.md"]) {
+        if (!(await exists(node_path_1.default.join(projectDir, p)))) {
+            issues.push({ level: "error", message: `Missing ${p}`, path: p });
+        }
+    }
+    if (tools.includes("cursor")) {
+        const p = ".cursor/prompts/ralphy-plan.md";
+        if (!(await exists(node_path_1.default.join(projectDir, p)))) {
+            issues.push({ level: "warning", message: `Missing ${p}`, path: p });
+        }
+    }
+    if (tools.includes("claude-code")) {
+        const p = ".claude/commands/ralphy-plan.md";
+        if (!(await exists(node_path_1.default.join(projectDir, p)))) {
+            issues.push({ level: "warning", message: `Missing ${p}`, path: p });
+        }
+    }
+    if (tools.includes("opencode")) {
+        const p = "AGENTS.md";
+        if (!(await exists(node_path_1.default.join(projectDir, p)))) {
+            issues.push({ level: "warning", message: `Missing ${p}`, path: p });
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=validator.js.map

package/dist/utils/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../src/utils/validator.ts"],"names":[],"mappings":";;;;;AAaA,0CA4CC;AAzDD,gEAAkC;AAClC,0DAA6B;AAG7B,KAAK,UAAU,MAAM,CAAC,CAAS;IAC7B,IAAI,CAAC;QACH,MAAM,kBAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,eAAe,CACnC,UAAkB,EAClB,KAAe;IAEf,MAAM,MAAM,GAAsB,EAAE,CAAC;IAErC,MAAM,WAAW,GAAG,mBAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACtD,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC;YACV,KAAK,EAAE,OAAO;YACd,OAAO,EAAE,yDAAyD;YAClE,IAAI,EAAE,WAAW;SAClB,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,kBAAkB,EAAE,qBAAqB,CAAC,EAAE,CAAC;QAC9E,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,mBAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9C,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,gCAAgC,CAAC;QAC3C,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,mBAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9C,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,iCAAiC,CAAC;QAC5C,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,mBAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9C,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,MAAM,CAAC,GAAG,WAAW,CAAC;QACtB,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,mBAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9C,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "ralphy-spec",
+  "version": "0.1.0",
+  "description": "One-command setup for Ralph loop + OpenSpec workflows across Cursor, OpenCode, and Claude Code.",
+  "license": "BSD-3-Clause",
+  "author": "Wenqing Yu",
+  "homepage": "https://ralphy-spec.org",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/anthropics/ralphy-openspec.git"
+  },
+  "bugs": {
+    "url": "https://github.com/anthropics/ralphy-openspec/issues"
+  },
+  "keywords": [
+    "openspec",
+    "ralph",
+    "ralph-wiggum",
+    "ai",
+    "cursor",
+    "claude",
+    "claude-code",
+    "opencode",
+    "spec-driven",
+    "ai-coding",
+    "ai-assistant"
+  ],
+  "bin": {
+    "ralphy-spec": "bin/ralphy-spec.js"
+  },
+  "files": [
+    "bin/",
+    "dist/",
+    "scripts/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "scripts": {
+    "build": "npm run clean && tsc -p tsconfig.json && node scripts/copy-templates.mjs",
+    "clean": "node scripts/clean.mjs",
+    "dev": "node --enable-source-maps dist/index.js --help",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "commander": "^14.0.0",
+    "fs-extra": "^11.3.0",
+    "inquirer": "^12.6.3",
+    "ora": "^9.0.0",
+    "yaml": "^2.8.0"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^22.13.0",
+    "typescript": "^5.7.3"
+  }
+}

package/scripts/clean.mjs

@@ -0,0 +1,14 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+
+async function rmIfExists(p) {
+  try {
+    await fs.rm(p, { recursive: true, force: true });
+  } catch {
+    // ignore
+  }
+}
+
+const root = path.resolve(new URL(".", import.meta.url).pathname, "..", "..");
+await rmIfExists(path.join(root, "dist"));
+

package/scripts/copy-templates.mjs

@@ -0,0 +1,29 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+
+async function copyDir(srcDir, dstDir) {
+  await fs.mkdir(dstDir, { recursive: true });
+  const entries = await fs.readdir(srcDir, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path.join(srcDir, entry.name);
+    const dstPath = path.join(dstDir, entry.name);
+    if (entry.isDirectory()) {
+      await copyDir(srcPath, dstPath);
+    } else if (entry.isFile()) {
+      await fs.mkdir(path.dirname(dstPath), { recursive: true });
+      await fs.copyFile(srcPath, dstPath);
+    }
+  }
+}
+
+const root = path.resolve(new URL(".", import.meta.url).pathname, "..", "..");
+const srcTemplates = path.join(root, "src", "templates");
+const dstTemplates = path.join(root, "dist", "templates");
+
+try {
+  await fs.access(srcTemplates);
+  await copyDir(srcTemplates, dstTemplates);
+} catch {
+  // No templates yet; ignore.
+}
+

package/scripts/install.sh

@@ -0,0 +1,22 @@
+#!/usr/bin/env sh
+set -eu
+
+echo "Installing ralphy-spec via npm..."
+
+if ! command -v node >/dev/null 2>&1; then
+  echo "ERROR: node is not installed. Please install Node.js >= 20.19.0." >&2
+  exit 1
+fi
+
+if ! command -v npm >/dev/null 2>&1; then
+  echo "ERROR: npm is not installed. Please install npm (or a Node distribution that includes it)." >&2
+  exit 1
+fi
+
+NODE_VERSION="$(node --version | sed 's/^v//')"
+echo "Detected node v$NODE_VERSION"
+
+npm install -g ralphy-spec@latest
+
+echo "Done."
+echo "Try: ralphy-spec --help"