ralph-prd 3.0.4 → 3.1.1

package/bin/cli.mjs

@@ -17,10 +17,12 @@
 
 import { existsSync, readFileSync } from 'fs';
 import { resolve, dirname } from 'path';
-import { fileURLToPath } from 'url';
+import { fileURLToPath, pathToFileURL } from 'url';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const PKG_ROOT = resolve(__dirname, '..');
+const RUNNER_PATH = resolve(PKG_ROOT, 'ralph', 'ralph-claude.mjs');
+const RUNNER_URL = pathToFileURL(RUNNER_PATH).href;
 
 // ─── Version ─────────────────────────────────────────────────────────────────
 
@@ -50,9 +52,9 @@ if (subcommand === 'run') {
 
   // Import and run ralph-claude.mjs directly from the package
   // Override process.argv so ralph-claude.mjs sees the correct args
-  process.argv = [process.argv[0], resolve(PKG_ROOT, 'ralph', 'ralph-claude.mjs'), ...runArgs];
+  process.argv = [process.argv[0], RUNNER_PATH, ...runArgs];
 
-  await import(resolve(PKG_ROOT, 'ralph', 'ralph-claude.mjs'));
+  await import(RUNNER_URL);
 
 } else if (subcommand === 'init' || !subcommand) {
   // npx ralph-prd init  OR  npx ralph-prd (legacy: bare invocation = init)
@@ -61,12 +63,12 @@ if (subcommand === 'run') {
 
 } else if (subcommand === '--update-skills') {
   // npx ralph-prd --update-skills
-  process.argv = [process.argv[0], 'ralph-claude.mjs', '--update-skills'];
-  await import(resolve(PKG_ROOT, 'ralph', 'ralph-claude.mjs'));
+  process.argv = [process.argv[0], RUNNER_PATH, '--update-skills'];
+  await import(RUNNER_URL);
 
 } else {
   // Assume it's a plan file path (legacy: npx ralph-prd docs/feature/plan.md)
   // Treat bare arguments as plan files for backward compat
-  process.argv = [process.argv[0], resolve(PKG_ROOT, 'ralph', 'ralph-claude.mjs'), ...args];
-  await import(resolve(PKG_ROOT, 'ralph', 'ralph-claude.mjs'));
+  process.argv = [process.argv[0], RUNNER_PATH, ...args];
+  await import(RUNNER_URL);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ralph-prd",
-  "version": "3.0.4",
+  "version": "3.1.1",
   "type": "module",
   "description": "AI-powered phased implementation runner for Claude Code — from PRD to shipped code",
   "bin": {
@@ -8,7 +8,8 @@
   },
   "exports": {
     ".": "./ralph/index.mjs",
-    "./transport": "./ralph/lib/transport.mjs"
+    "./transport": "./ralph/lib/transport.mjs",
+    "./plan-validator": "./ralph/lib/plan-validator.mjs"
   },
   "keywords": [
     "claude",

package/ralph/index.mjs

@@ -8,3 +8,4 @@
 
 export { send, preflight, getCumulativeCost, TransportError } from './lib/transport.mjs';
 export { resolveRepos } from './lib/config.mjs';
+export { validatePlan, PlanValidationError } from './lib/plan-validator.mjs';

package/ralph/lib/transport.mjs

@@ -26,7 +26,7 @@ import { relative } from 'path';
 /** Timeout for the preflight check only — should always be fast. */
 const PREFLIGHT_TIMEOUT_MS = 30_000;
 
-/** Default timeout for send() — 20 minutes per CLI session. */
+/** Default timeout for send() — 20 minutes of inactivity per CLI session. */
 const SEND_TIMEOUT_MS = 20 * 60 * 1000;
 
 const CLI_FLAGS = [
@@ -371,16 +371,24 @@ export async function send(prompt, { onChunk, signal, timeoutMs } = {}) {
     const child = spawn(cliBin, CLI_FLAGS, { stdio: ['pipe', 'pipe', 'pipe'] });
 
     // ── Timeout: kills the CLI if no output arrives within the timeout window ──
-    const timer = setTimeout(() => {
+    // This is a no-activity timeout, not a hard cap — it resets on every stdout
+    // chunk so long-running tasks that keep producing output are never killed.
+    let timer = setTimeout(onTimeout, timeout);
+    function onTimeout() {
       child.kill();
       done(reject, new TransportError(
-        `\`claude\` CLI timed out after ${(timeout / 1000).toFixed(0)}s with no response. ` +
+        `\`claude\` CLI timed out after ${(timeout / 1000).toFixed(0)}s with no output. ` +
         'The session may have hung or lost connectivity.',
         'timeout'
       ));
-    }, timeout);
+    }
+    function resetTimer() {
+      clearTimeout(timer);
+      timer = setTimeout(onTimeout, timeout);
+    }
 
     child.stdout.on('data', (chunk) => {
+      resetTimer();
       lineBuffer += chunk.toString();
       const lines = lineBuffer.split('\n');
       lineBuffer = lines.pop() ?? '';