ralph-prd 1.0.9 → 1.0.12

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/install.sh

@@ -95,20 +95,17 @@ if [ -f "$SOURCE_DIR/package.json" ]; then
   info "Stamped version: $VERSION"
 fi
 
-# Only add to .gitignore on first install — if .claude/ already existed,
-# the user may be sharing it via git intentionally.
-if [ "$IS_FIRST_INSTALL" = true ]; then
-  GITIGNORE="$PROJECT_ROOT/.gitignore"
-  for entry in ".claude/ralph/" ".claude/skills/"; do
-    if [ ! -f "$GITIGNORE" ] || ! grep -qxF "$entry" "$GITIGNORE"; then
-      if [ ! -f "$GITIGNORE" ] || ! grep -qF "# ralph-prd" "$GITIGNORE"; then
-        printf '\n# ralph-prd (installed via install.sh)\n' >> "$GITIGNORE"
-      fi
-      echo "$entry" >> "$GITIGNORE"
-      ok "Added $entry to .gitignore"
+# Add required entries to .gitignore (idempotent — skips entries already present).
+GITIGNORE="$PROJECT_ROOT/.gitignore"
+for entry in ".claude/ralph/" ".claude/skills/" "logs/"; do
+  if [ ! -f "$GITIGNORE" ] || ! grep -qxF "$entry" "$GITIGNORE"; then
+    if [ ! -f "$GITIGNORE" ] || ! grep -qF "# ralph-prd" "$GITIGNORE"; then
+      printf '\n# ralph-prd (installed via install.sh)\n' >> "$GITIGNORE"
     fi
-  done
-fi
+    echo "$entry" >> "$GITIGNORE"
+    ok "Added $entry to .gitignore"
+  fi
+done
 
 # Summary
 echo ""

package/package.json

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

package/ralph/ralph-claude.mjs

@@ -363,7 +363,7 @@ async function main() {
   // Derive branch name and log directory
   const branch = deriveBranchName(planPath);
   const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
-  const logsBaseDir = resolve(__dirname, 'logs');
+  const logsBaseDir = resolve(__dirname, '../..', 'logs');
   let logsDir;
   if (isDryRun) {
     // Dry runs always get a fresh folder

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