ralph-prd 1.0.9 → 1.0.11

package/README.md

@@ -94,8 +94,10 @@ Options:
   --i-did-this       Skip Claude self-commit; run separate commit step
   --send-it          Push branch + open PR when all phases complete
   --wait-for-it           Pause before each commit for review
-  --skip-ship-check       Skip the post-commit ship-check step
-  --skip-on-verify-fail   Skip verification and continue instead of hard-stopping when all repair attempts fail
+  --skip-ship-check            Skip the post-commit ship-check step entirely
+  --ship-check-retries=N       Retry ship-check up to N times per phase before giving up (default 1)
+  --skip-on-ship-check-fail    Log and continue when all ship-check retries fail instead of hard-stopping
+  --skip-on-verify-fail        Skip verification and continue instead of hard-stopping when all repair attempts fail
   --update-skills         Re-fetch skills from tahaJemmali/skills and exit
   --version, -v      Print installed version and exit
 ```
@@ -147,6 +149,9 @@ writableDirs:
 flags:
   maxRepairs: 3
   sendIt: false
+  skipShipCheck: false
+  shipCheckRetries: 1
+  skipOnShipCheckFail: true
   skipOnVerifyFail: false
 
 hooks:

package/bin/install.mjs

@@ -7,7 +7,7 @@
  * from the skills repo via `npx skills add tahaJemmali/skills`.
  */
 
-import { existsSync, mkdirSync, cpSync, rmSync, readFileSync, writeFileSync } from 'fs';
+import { existsSync, mkdirSync, cpSync, rmSync, readFileSync, writeFileSync, copyFileSync } from 'fs';
 import { resolve, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import { spawnSync } from 'child_process';
@@ -62,6 +62,14 @@ const pkg = JSON.parse(readFileSync(resolve(PKG_ROOT, 'package.json'), 'utf8'));
 writeFileSync(resolve(ralphDst, '.ralph-version'), pkg.version + '\n', 'utf8');
 ok(`Installed ralph runner v${pkg.version} -> .claude/ralph/`);
 
+// Create default ralph.config.yaml if it doesn't exist yet
+const configDst = resolve(ralphDst, 'ralph.config.yaml');
+const configSrc = resolve(ralphDst, 'ralph.config.sample.yaml');
+if (!existsSync(configDst) && existsSync(configSrc)) {
+  copyFileSync(configSrc, configDst);
+  ok('Created default ralph.config.yaml -> .claude/ralph/ralph.config.yaml');
+}
+
 // Install skills via skills.sh
 info('Installing skills from tahaJemmali/skills…');
 const REQUIRED_SKILLS = [
@@ -111,6 +119,7 @@ console.log('');
 info(`Installed to: ${claudeDir}`);
 info('');
 info('Quick start:');
+info('  0. Configure:      edit .claude/ralph/ralph.config.yaml');
 info('  1. Write a PRD:    claude then /write-a-prd');
 info('  2. Create a plan:  claude then /prd-to-plan');
 info('  3. Execute:        node .claude/ralph/ralph-claude.mjs docs/<feature>/plan.md');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ralph-prd",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "description": "AI-powered phased implementation runner for Claude Code — from PRD to shipped code",
   "bin": {
     "ralph-prd": "./bin/install.mjs"

package/ralph/ralph.config.sample.yaml

@@ -54,6 +54,16 @@ flags:
   # CLI equivalent: --skip-ship-check
   skipShipCheck: false
 
+  # Max ship-check attempts per phase before giving up. On final failure,
+  # behaviour is controlled by skipOnShipCheckFail below.
+  # CLI equivalent: --ship-check-retries=N
+  shipCheckRetries: 1
+
+  # When true, log and continue if ship-check fails after all retries instead
+  # of hard-stopping. Defaults to true.
+  # CLI equivalent: --skip-on-ship-check-fail
+  skipOnShipCheckFail: true
+
   # When all repair attempts are exhausted, skip verification and continue to
   # the commit step instead of hard-stopping. Useful when the acceptance
   # criteria require external credentials or manual steps that the agent cannot