ralphy-spec 0.1.0 → 0.2.0

package/dist/templates/shared/project-template.yml

@@ -0,0 +1,232 @@
+# ralphy-spec Project Configuration
+# Generated by: ralphy-spec init
+# Version: 2.1 (Budget Intelligence + Sprint Semantics)
+
+version: "1.1"
+
+project:
+  name: "my-project"
+  repoRoot: "."
+  language: "ts"
+  packageManager: "npm"          # user-defined: npm | pnpm | yarn | bun
+
+defaults:
+  backend: "cursor"
+  workspaceMode: "patch"       # "worktree" | "patch"
+  checkpointMode: "commit"     # "commit" | "patch"
+  validators:
+    - typecheck
+    - test
+    - lint
+
+# Artifacts (IDE-friendly human interface)
+# NOTE: These are defaults; users can override or disable.
+artifacts:
+  enabled: true
+  rootDir: "ralphy-spec"        # default; can be overridden via CLI: --artifact-dir
+  statusIcons: "emoji"          # "emoji" | "ascii" | "none"
+
+# Run-level budgets (hard limits for entire run)
+budgets:
+  run:
+    money_usd: 20              # Max USD per run
+    tokens: 2000000            # Max tokens per run
+    wall_time_minutes: 90      # Max wall clock time
+    max_iterations_total: 80   # Max total iterations across all tasks
+  
+  limits:
+    max_parallel_tasks: 1      # Concurrent tasks (v1: always 1)
+    max_parallel_validators: 2 # Concurrent validators
+    command_timeout_seconds: 900
+
+# Sprint size defaults (applied when task has sprint.size but no explicit budget)
+# Users can override per-task
+sprint_defaults:
+  XS:
+    optimal: { usd: 0.20, tokens: 15000, time_minutes: 3 }
+    warning: { usd: 0.35, tokens: 25000, time_minutes: 5 }
+    hard: { usd: 0.50, tokens: 40000, time_minutes: 8, max_iterations: 3 }
+  S:
+    optimal: { usd: 0.50, tokens: 40000, time_minutes: 5 }
+    warning: { usd: 0.80, tokens: 65000, time_minutes: 8 }
+    hard: { usd: 1.20, tokens: 100000, time_minutes: 12, max_iterations: 5 }
+  M:
+    optimal: { usd: 1.20, tokens: 80000, time_minutes: 10 }
+    warning: { usd: 2.00, tokens: 150000, time_minutes: 15 }
+    hard: { usd: 3.00, tokens: 250000, time_minutes: 20, max_iterations: 8 }
+  L:
+    optimal: { usd: 2.50, tokens: 150000, time_minutes: 20 }
+    warning: { usd: 4.00, tokens: 280000, time_minutes: 35 }
+    hard: { usd: 6.00, tokens: 450000, time_minutes: 50, max_iterations: 12 }
+  XL:
+    optimal: { usd: 5.00, tokens: 300000, time_minutes: 40 }
+    warning: { usd: 8.00, tokens: 550000, time_minutes: 70 }
+    hard: { usd: 12.00, tokens: 900000, time_minutes: 100, max_iterations: 20 }
+
+backends:
+  cursor:
+    command: "cursor"
+    modelTiers:
+      default: { hint: "balanced" }
+      cheap: { hint: "cheap" }
+      strong: { hint: "strong" }
+  opencode:
+    command: "opencode"
+    modelTiers:
+      default: {}
+      cheap: {}
+  claude_code:
+    command: "claude"
+    modelTiers:
+      default: {}
+
+validators:
+  - id: "typecheck"
+    # Avoid hard-coding package manager. Choose commands that match your repo.
+    run: "npm run typecheck"
+    timeout_seconds: 600
+    parser: "tsc"
+  - id: "test"
+    run: "npm test"
+    timeout_seconds: 900
+    parser: "jest"
+  - id: "lint"
+    run: "npm run lint"
+    timeout_seconds: 600
+    parser: "eslint"
+
+# Tasks - define your implementation tasks here
+tasks: []
+
+# ============================================================
+# TASK EXAMPLES (uncomment and modify as needed)
+# ============================================================
+
+# Example 1: Simple fix (XS sprint, uses defaults)
+# - id: "fix-typo-001"
+#   title: "Fix typo in error message"
+#   goal: "Correct spelling in validation error"
+#   
+#   sprint:
+#     size: XS                 # Uses XS defaults: $0.20 optimal, 3 max iter
+#     intent: "fix"            # No refactoring allowed
+#   
+#   files_contract:
+#     allowed: ["src/utils/validation.ts"]
+#     forbidden: []
+#     allow_new_files: false
+#   
+#   acceptance:
+#     - id: "acc-1"
+#       text: "Error message spelled correctly"
+#       type: "behavior"
+
+# Example 2: Feature (M sprint with custom budget)
+# - id: "auth-001"
+#   title: "JWT middleware"
+#   goal: "Add JWT auth middleware for API routes"
+#   
+#   sprint:
+#     size: M
+#     intent: "feature"        # Limited refactoring allowed
+#   
+#   budget:                    # Optional: override sprint defaults
+#     optimal:
+#       usd: 1.2
+#       tokens: 80000
+#       time_minutes: 10
+#     warning:
+#       usd: 2.0
+#       tokens: 150000
+#       time_minutes: 15
+#     hard:
+#       usd: 3.0
+#       tokens: 250000
+#       time_minutes: 20
+#       max_iterations: 8
+#   
+#   files_contract:
+#     allowed:
+#       - "src/middleware/**"
+#       - "src/api/**"
+#     forbidden:
+#       - "src/db/**"
+#     allow_new_files: true
+#   
+#   context:
+#     docs: ["README.md"]
+#     files: ["src/api/index.ts"]
+#   
+#   acceptance:
+#     - id: "acc-1"
+#       text: "Requests without token return 401"
+#       type: "behavior"
+#     - id: "acc-2"
+#       text: "Valid tokens allow access"
+#       type: "behavior"
+#     - id: "acc-3"
+#       text: "Unit tests added"
+#       type: "evidence"
+#       evidence:
+#         must_include_files: ["src/**/__tests__/**"]
+#   
+#   validators: ["typecheck", "test", "lint"]
+#   done_policy:
+#     require_all_validators_pass: true
+#     require_acceptance_evidence: true
+
+# Example 3: Large refactor (L sprint)
+# - id: "refactor-db-001"
+#   title: "Migrate to Prisma"
+#   goal: "Replace raw SQL with Prisma ORM"
+#   deps: ["auth-001"]         # Depends on auth task
+#   
+#   sprint:
+#     size: L
+#     intent: "refactor"       # Full refactoring allowed
+#   
+#   files_contract:
+#     allowed:
+#       - "src/db/**"
+#       - "prisma/**"
+#     forbidden:
+#       - "src/api/**"         # Don't touch API layer
+#     allow_new_files: true
+#   
+#   acceptance:
+#     - id: "acc-1"
+#       text: "All database queries use Prisma"
+#       type: "behavior"
+#     - id: "acc-2"
+#       text: "Existing tests pass"
+#       type: "evidence"
+
+# ============================================================
+# BUDGET TIERS EXPLAINED
+# ============================================================
+# 
+# OPTIMAL: Expected cost for correct completion
+#   - Agent operates normally with full context
+#   - All features enabled (self-review, planning)
+#
+# WARNING: Still acceptable but attention needed
+#   - Context shrink: fewer files, only failing tests
+#   - Repair-only mode: "fix only, no refactor"
+#   - Optional calls disabled
+#   - STATUS.md shows pressure signals
+#
+# HARD: Must stop immediately
+#   - Task marked as BLOCKED
+#   - Workspace preserved for debugging
+#   - Failure summary written
+#   - No silent retries
+#
+# ============================================================
+# SPRINT SIZES GUIDE
+# ============================================================
+#
+# XS: Single file fix, typo, simple config change
+# S:  Small function, add a test, minor refactor
+# M:  Feature slice, new endpoint, component
+# L:  Multi-file feature, significant change
+# XL: Infrastructure, major refactor, migration

package/dist/templates/shared/ralph-loop-prompt-template.md

@@ -0,0 +1,25 @@
+# Ralph Loop Prompt Template (OpenSpec task runner)
+
+Use this template when running an AI agent in a loop (Ralph methodology). The same prompt may be repeated until the completion promise is printed.
+
+## Context
+You are implementing OpenSpec change: `{{change_name}}`
+
+## Current Task
+{{current_task_from_tasks_md}}
+
+## Acceptance Criteria
+{{acceptance_criteria}}
+
+## Instructions
+1. Read the spec at `openspec/changes/{{change_name}}/` and the baseline specs in `openspec/specs/`.
+2. Implement the current task.
+3. Run tests to verify the acceptance criteria.
+4. If tests pass, mark the task complete and output `<promise>TASK_COMPLETE</promise>`.
+5. If tests fail, fix issues and continue iterating.
+
+## Important
+- Do NOT output the promise until tests pass.
+- Prefer small, incremental changes.
+- Keep tests aligned with OpenSpec scenarios.
+

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

@@ -1 +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"}
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../src/utils/installer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAiBvC,wBAAsB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsD9E;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

@@ -9,6 +9,7 @@ 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");
+const folders_1 = require("../core/folders");
 async function ensureDir(p) {
     await promises_1.default.mkdir(p, { recursive: true });
 }
@@ -26,6 +27,35 @@ async function ensureOpenSpecScaffold(projectDir) {
     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"));
+    // v2+ project spec (template)
+    const templatesRoot = (0, paths_1.getDistTemplatesDir)();
+    const projectTemplatePath = node_path_1.default.join(templatesRoot, "shared", "project-template.yml");
+    let projectTemplate = [
+        "# ralphy-spec Project Configuration",
+        "# Generated by: ralphy-spec init",
+        'version: "1.0"',
+        "",
+        "project:",
+        '  name: "my-project"',
+        '  repoRoot: "."',
+        "",
+        "defaults:",
+        '  backend: "cursor"',
+        '  workspaceMode: "patch"',
+        '  checkpointMode: "commit"',
+        "  validators: []",
+        "",
+        "validators: []",
+        "tasks: []",
+        "",
+    ].join("\n");
+    try {
+        projectTemplate = await promises_1.default.readFile(projectTemplatePath, "utf8");
+    }
+    catch {
+        // Fall back to embedded template.
+    }
+    await writeFileIfMissing(node_path_1.default.join(openspecDir, "project.yml"), projectTemplate);
     await writeFileIfMissing(node_path_1.default.join(openspecDir, "project.md"), [
         "# Project Context",
         "",
@@ -77,7 +107,7 @@ async function installToolTemplates(projectDir, tools, opts) {
         }
     }
     // Ralphy config/state
-    const ralphyDir = node_path_1.default.join(projectDir, ".ralphy");
+    const ralphyDir = node_path_1.default.join(projectDir, folders_1.DEFAULT_ROOT_DIR);
     await ensureDir(ralphyDir);
     await writeFileIfMissing(node_path_1.default.join(ralphyDir, "config.json"), JSON.stringify({
         testCommand: "npm test",

package/dist/utils/installer.js.map

@@ -1 +1 @@
-{"version":3,"file":"installer.js","sourceRoot":"","sources":["../../src/utils/installer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"installer.js","sourceRoot":"","sources":["../../src/utils/installer.ts"],"names":[],"mappings":";;;;;AAoBA,wDAsDC;AAED,oDAmEC;AA/ID,gEAAkC;AAClC,0DAA6B;AAC7B,wDAA2B;AAE3B,mCAA8C;AAC9C,6CAAmD;AAEnD,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,8BAA8B;IAC9B,MAAM,aAAa,GAAG,IAAA,2BAAmB,GAAE,CAAC;IAC5C,MAAM,mBAAmB,GAAG,mBAAI,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,EAAE,sBAAsB,CAAC,CAAC;IACvF,IAAI,eAAe,GAAG;QACpB,qCAAqC;QACrC,kCAAkC;QAClC,gBAAgB;QAChB,EAAE;QACF,UAAU;QACV,sBAAsB;QACtB,iBAAiB;QACjB,EAAE;QACF,WAAW;QACX,qBAAqB;QACrB,0BAA0B;QAC1B,4BAA4B;QAC5B,kBAAkB;QAClB,EAAE;QACF,gBAAgB;QAChB,WAAW;QACX,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,IAAI,CAAC;QACH,eAAe,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,kCAAkC;IACpC,CAAC;IACD,MAAM,kBAAkB,CAAC,mBAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,EAAE,eAAe,CAAC,CAAC;IAEjF,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,0BAAgB,CAAC,CAAC;IAC1D,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/validator.d.ts.map

@@ -1 +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"}
+{"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;AAYxD,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,eAAe,EAAE,CAAC,CAmD5B"}

package/dist/utils/validator.js

@@ -6,6 +6,7 @@ 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"));
+const folders_1 = require("../core/folders");
 async function exists(p) {
     try {
         await promises_1.default.access(p);
@@ -49,6 +50,15 @@ async function validateProject(projectDir, tools) {
             issues.push({ level: "warning", message: `Missing ${p}`, path: p });
         }
     }
+    const newRoot = node_path_1.default.join(projectDir, folders_1.DEFAULT_ROOT_DIR);
+    const legacyRoot = node_path_1.default.join(projectDir, folders_1.LEGACY_ROOT_DIR);
+    if (!(await exists(newRoot)) && (await exists(legacyRoot))) {
+        issues.push({
+            level: "warning",
+            message: `Legacy folder detected. Consider migrating ${folders_1.LEGACY_ROOT_DIR}/ to ${folders_1.DEFAULT_ROOT_DIR}/`,
+            path: folders_1.LEGACY_ROOT_DIR,
+        });
+    }
     return issues;
 }
 //# sourceMappingURL=validator.js.map

package/dist/utils/validator.js.map

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

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "ralphy-spec",
-  "version": "0.1.0",
+  "version": "0.2.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"
+    "url": "git+https://github.com/wenqingyu/ralphy-openspec.git"
   },
   "bugs": {
-    "url": "https://github.com/anthropics/ralphy-openspec/issues"
+    "url": "https://github.com/wenqingyu/ralphy-openspec/issues"
   },
   "keywords": [
     "openspec",
@@ -33,6 +33,9 @@
     "dist/",
     "scripts/",
     "README.md",
+    "README.zh.md",
+    "README.ko.md",
+    "README.ja.md",
     "LICENSE"
   ],
   "engines": {
@@ -50,13 +53,20 @@
   },
   "dependencies": {
     "chalk": "^5.4.1",
+    "cli-table3": "^0.6.5",
     "commander": "^14.0.0",
+    "execa": "^9.6.0",
+    "fast-glob": "^3.3.3",
     "fs-extra": "^11.3.0",
     "inquirer": "^12.6.3",
+    "minimatch": "^10.0.3",
     "ora": "^9.0.0",
-    "yaml": "^2.8.0"
+    "yaml": "^2.8.0",
+    "zod": "^4.1.5",
+    "better-sqlite3": "^12.2.0"
   },
   "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
     "@types/fs-extra": "^11.0.4",
     "@types/node": "^22.13.0",
     "typescript": "^5.7.3"

package/scripts/copy-templates.mjs

@@ -16,7 +16,8 @@ async function copyDir(srcDir, dstDir) {
   }
 }
 
-const root = path.resolve(new URL(".", import.meta.url).pathname, "..", "..");
+const scriptsDir = path.dirname(new URL(import.meta.url).pathname);
+const root = path.resolve(scriptsDir, "..");
 const srcTemplates = path.join(root, "src", "templates");
 const dstTemplates = path.join(root, "dist", "templates");