projecta-rrr 1.16.1 → 1.16.3

package/CHANGELOG.md

@@ -4,8 +4,41 @@ All notable changes to RRR will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [1.16.3] - 2026-01-27
+
+### Changed
+- **Pushpa → Jarvis branding consolidation**
+  - All documentation, commands, and scripts renamed from Pushpa Mode to Jarvis
+  - `scripts/jarvis.sh` is now the unified overnight automation script
+  - `npm run jarvis` replaces `npm run pushpa`
+  - Install script removes deprecated `pushpa-mode.sh` and `pushpa-jarvis.sh` on update
+
+## [1.16.2] - 2026-01-27
+
+### Added
+- **jarvis.sh** - Unified autonomous runner combining pushpa-mode.sh and pushpa-jarvis.sh
+  - JSON config support with jq/sed fallback
+  - Lock file for concurrent run prevention
+  - Git branch safety with auto-commit after phase
+  - Error classification with intelligent retry
+  - Circuit breaker for fail-fast
+  - Checkpoint system for resume
+  - Context exhaustion handling
+  - Claude Code environment detection
+  - Morning review generation
+  - Verification ladder (unit, playwright, visual, browser_uat)
+
 ## [1.16.1] - 2026-01-27
 
+### Fixed
+- **Missing scripts in npm install** - All user-facing scripts now copied to target project
+  - Added: `pushpa-jarvis.sh`, `browser-uat.sh`, `scaffold-e2e.sh`, `chrome-visual-check.sh`, `index-sessions.sh`
+  - Added npm scripts: `pushpa:jarvis`, `browser:uat`, `scaffold:e2e`, `chrome:visual`, `sessions:index`
+  - Scripts copied alongside existing `pushpa-mode.sh`, `mcp-setup.sh`, `visual-proof.sh`
+- **pushpa-jarvis.sh bug fixes**
+  - Fixed `verify_phase()` using wrong variable (`$ph` instead of `$phase`)
+  - Fixed `phase_has_summary()` to search both active phases and milestone archives
+
 ### Fixed
 - **Missing scripts in npm install** - All user-facing scripts now copied to target project
   - Added: `pushpa-jarvis.sh`, `browser-uat.sh`, `scaffold-e2e.sh`, `chrome-visual-check.sh`, `index-sessions.sh`

package/bin/install.js

@@ -505,9 +505,9 @@ function installScripts(targetDir) {
 
   const installed = [];
   const skipped = [];
+  const removed = [];
   const scripts = [
-    'pushpa-mode.sh',
-    'pushpa-jarvis.sh',
+    'jarvis.sh',
     'mcp-setup.sh',
     'visual-proof.sh',
     'browser-uat.sh',
@@ -516,6 +516,10 @@ function installScripts(targetDir) {
     'index-sessions.sh'
   ];
 
+  // Scripts to remove (deprecated)
+  const deprecatedScripts = ['pushpa-mode.sh', 'pushpa-jarvis.sh'];
+
+  // Install new scripts
   for (const script of scripts) {
     const srcFile = path.join(srcScriptsDir, script);
     const destFile = path.join(scriptsDir, script);
@@ -540,7 +544,21 @@ function installScripts(targetDir) {
     }
   }
 
-  return { installed, skipped };
+  // Remove deprecated scripts
+  for (const script of deprecatedScripts) {
+    const destFile = path.join(scriptsDir, script);
+    if (fs.existsSync(destFile)) {
+      try {
+        fs.unlinkSync(destFile);
+        removed.push(script);
+        console.log(`  ${green}✓${reset} Removed deprecated scripts/${script}`);
+      } catch (e) {
+        console.log(`  ${yellow}⚠${reset} Could not remove scripts/${script}: ${e.message}`);
+      }
+    }
+  }
+
+  return { installed, skipped, removed };
 }
 
 /**
@@ -570,16 +588,27 @@ function addNpmScripts(targetDir, installedScripts, bashAvailable = true) {
 
   const added = [];
   const skipped = [];
+  const removed = [];
 
-  // Add pushpa script if pushpa-mode.sh was installed
-  if (installedScripts.includes('pushpa-mode.sh') || fs.existsSync(path.join(targetDir, 'scripts', 'pushpa-mode.sh'))) {
-    if (pkgJson.scripts.pushpa) {
-      skipped.push('pushpa');
-      console.log(`  ${yellow}⚠${reset} Skipped npm script "pushpa" (already exists)`);
+  // Add jarvis script if jarvis.sh was installed
+  if (installedScripts.includes('jarvis.sh') || fs.existsSync(path.join(targetDir, 'scripts', 'jarvis.sh'))) {
+    if (pkgJson.scripts.jarvis) {
+      skipped.push('jarvis');
+      console.log(`  ${yellow}⚠${reset} Skipped npm script "jarvis" (already exists)`);
     } else {
-      pkgJson.scripts.pushpa = 'bash scripts/pushpa-mode.sh';
-      added.push('pushpa');
-      console.log(`  ${green}✓${reset} Added npm script "pushpa"`);
+      pkgJson.scripts.jarvis = 'bash scripts/jarvis.sh';
+      added.push('jarvis');
+      console.log(`  ${green}✓${reset} Added npm script "jarvis"`);
+    }
+  }
+
+  // Remove deprecated pushpa npm scripts
+  const deprecatedNpmScripts = ['pushpa', 'pushpa:mode', 'pushpa:jarvis'];
+  for (const script of deprecatedNpmScripts) {
+    if (pkgJson.scripts[script]) {
+      delete pkgJson.scripts[script];
+      removed.push(script);
+      console.log(`  ${green}✓${reset} Removed deprecated npm script "${script}"`);
     }
   }
 
@@ -607,18 +636,6 @@ function addNpmScripts(targetDir, installedScripts, bashAvailable = true) {
     }
   }
 
-  // Add pushpa:jarvis script if pushpa-jarvis.sh was installed
-  if (installedScripts.includes('pushpa-jarvis.sh') || fs.existsSync(path.join(targetDir, 'scripts', 'pushpa-jarvis.sh'))) {
-    if (pkgJson.scripts['pushpa:jarvis']) {
-      skipped.push('pushpa:jarvis');
-      console.log(`  ${yellow}⚠${reset} Skipped npm script "pushpa:jarvis" (already exists)`);
-    } else {
-      pkgJson.scripts['pushpa:jarvis'] = 'bash scripts/pushpa-jarvis.sh';
-      added.push('pushpa:jarvis');
-      console.log(`  ${green}✓${reset} Added npm script "pushpa:jarvis"`);
-    }
-  }
-
   // Add browser:uat script if browser-uat.sh was installed
   if (installedScripts.includes('browser-uat.sh') || fs.existsSync(path.join(targetDir, 'scripts', 'browser-uat.sh'))) {
     if (pkgJson.scripts['browser:uat']) {
@@ -674,10 +691,10 @@ function addNpmScripts(targetDir, installedScripts, bashAvailable = true) {
 
   // Warn about bash requirement on Windows
   if (!bashAvailable && (added.length > 0 || skipped.length > 0)) {
-    console.log(`  ${yellow}⚠${reset} Note: npm scripts require bash (${dim}npm run pushpa${reset}, etc.)`);
+    console.log(`  ${yellow}⚠${reset} Note: npm scripts require bash (${dim}npm run jarvis${reset}, etc.)`);
   }
 
-  return { added, skipped };
+  return { added, skipped, removed };
 }
 
 /**

package/commands/rrr/help.md

@@ -28,7 +28,7 @@ Output ONLY the reference content below. Do NOT add:
 **Windows users:**
 - **Core commands work without bash** — `/rrr:new-project`, `/rrr:progress`, `/rrr:plan-phase` use cross-platform file detection
 - **Hooks need bash** — Statusline, notifications, update checks require Git Bash or WSL2
-- **npm scripts need bash** — `npm run pushpa`, `npm run e2e` require bash
+- **npm scripts need bash** — `npm run jarvis`, `npm run e2e` require bash
 - **Recommended setup:** Install [Git for Windows](https://git-scm.com/download/win) (includes Git Bash) OR run `wsl --install` in PowerShell for WSL2
 - **Verify:** Run `bash --version` in your terminal
 
@@ -53,8 +53,8 @@ Output ONLY the reference content below. Do NOT add:
 | Environment | What to run | Notes |
 |-------------|-------------|-------|
 | **Inside Claude Code** | `/rrr:*` slash commands | Interactive planning/execution |
-| **Outside Claude Code** | `bash scripts/pushpa-mode.sh` | Unattended overnight runs |
-| **npm scripts** | `npm run pushpa`, `npm run e2e` | Convenience wrappers |
+| **Outside Claude Code** | `bash scripts/jarvis-mode.sh` | Unattended overnight runs |
+| **npm scripts** | `npm run jarvis`, `npm run e2e` | Convenience wrappers |
 
 **After installing from inside Claude Code:** Exit and restart `claude` to load new commands.
 
@@ -582,7 +582,7 @@ Usage: `/rrr:mvp`
 Pushpa Mode guidance: preflight checks and run instructions.
 
 - Checks if project is initialized
-- Checks if `scripts/pushpa-mode.sh` exists (gives copy instructions if not)
+- Checks if `scripts/jarvis-mode.sh` exists (gives copy instructions if not)
 - Provides exact command to run in a normal terminal
 - Recommends running outside Claude Code interactive session
 
@@ -605,7 +605,7 @@ Usage: `/rrr:overnight`
 │   └── playwright/       # Playwright test output
 │       ├── report/       # HTML report
 │       └── test-results/ # Screenshots, traces, videos
-├── pushpa/               # Pushpa Mode state
+├── jarvis/               # Pushpa Mode state
 │   └── ledger.json       # Persistent run state
 ├── todos/                # Captured ideas and tasks
 │   ├── pending/          # Todos waiting to be worked on
@@ -700,9 +700,9 @@ If repo is broken, brownfield-audit creates a stabilization Phase 00:
 Run phases unattended while you sleep with token-safe budgets. After `npx projecta-rrr`:
 
 ```
-bash scripts/pushpa-mode.sh
+bash scripts/jarvis-mode.sh
 # or
-npm run pushpa
+npm run jarvis
 ```
 
 Prerequisites:
@@ -721,7 +721,7 @@ Pushpa Mode will:
 - Enforce budgets (max phases, time, calls)
 - Stop on repeated failures (prevents infinite loops)
 - Generate report at `.planning/PUSHPA_REPORT.md`
-- Persist state to `.planning/pushpa/ledger.json`
+- Persist state to `.planning/jarvis/ledger.json`
 
 **Budgets (override via env vars):**
 - `MAX_PHASES_PER_RUN=3` — phases per run

package/commands/rrr/overnight.md

@@ -1,13 +1,13 @@
 ---
 name: rrr:overnight
-description: Pushpa Mode guidance - preflight checks and safe run instructions
+description: Jarvis (overnight automation) guidance - preflight checks and safe run instructions
 ---
 
 <objective>
-Guide user to run Pushpa Mode safely and correctly.
+Guide user to run Jarvis safely and correctly.
 
 Perform preflight checks and provide exact instructions.
-Do NOT run Pushpa Mode directly from this command.
+Do NOT run Jarvis directly from this command.
 </objective>
 
 <behavior>
@@ -17,11 +17,11 @@ Run these checks in order:
 
 If `.planning/STATE.md` does NOT exist:
 ```
-## Pushpa Mode Preflight
+## Jarvis Preflight
 
 **Status:** NOT READY
 
-Your project is not initialized yet. Pushpa Mode requires RRR planning files.
+Your project is not initialized yet. Jarvis requires RRR planning files.
 
 **Fix:** Run `/rrr:new-project` first to:
 - Bootstrap your project (if empty folder)
@@ -32,32 +32,32 @@ Then come back and run `/rrr:overnight` again.
 ```
 STOP here if not initialized.
 
-## 2. Check pushpa-mode.sh exists
+## 2. Check jarvis.sh exists
 
-Check if `scripts/pushpa-mode.sh` exists in the user's project.
+Check if `scripts/jarvis.sh` exists in the user's project.
 
 If it does NOT exist:
 ```
-## Pushpa Mode Preflight
+## Jarvis Preflight
 
 **Status:** Script not found
 
-The Pushpa Mode script is not in your project yet.
+The Jarvis script is not in your project yet.
 
 **Fix:** Copy it from the RRR installation:
 
 If RRR installed globally:
 \`\`\`bash
 mkdir -p scripts
-cp ~/.claude/rrr/scripts/pushpa-mode.sh scripts/pushpa-mode.sh
-chmod +x scripts/pushpa-mode.sh
+cp ~/.claude/rrr/scripts/jarvis.sh scripts/jarvis.sh
+chmod +x scripts/jarvis.sh
 \`\`\`
 
 If RRR installed locally:
 \`\`\`bash
 mkdir -p scripts
-cp .claude/rrr/scripts/pushpa-mode.sh scripts/pushpa-mode.sh
-chmod +x scripts/pushpa-mode.sh
+cp .claude/rrr/scripts/jarvis.sh scripts/jarvis.sh
+chmod +x scripts/jarvis.sh
 \`\`\`
 
 Then run `/rrr:overnight` again.
@@ -67,7 +67,7 @@ STOP here if script missing.
 ## 3. All checks passed - provide run instructions
 
 ```
-## Pushpa Mode Ready
+## Jarvis Ready
 
 **Status:** READY
 
@@ -78,49 +78,49 @@ All preflight checks passed.
 **Recommended:** Open a separate terminal (outside Claude Code) and run:
 
 \`\`\`bash
-bash scripts/pushpa-mode.sh
+bash scripts/jarvis.sh
 \`\`\`
 
 Or if you added the npm script:
 \`\`\`bash
-npm run pushpa
+npm run jarvis
 \`\`\`
 
 ### Why run outside Claude Code?
 
-Running Pushpa Mode inside Claude Code interactive session can:
+Running Jarvis inside Claude Code interactive session can:
 - Trigger approval prompts that interrupt unattended execution
 - Not be truly "overnight" autonomous
 
 The script will detect if you run it inside Claude Code and prompt to confirm.
 
-### What Pushpa Mode does
+### What Jarvis does
 
 1. Plans any phases that don't have plans yet
 2. Executes phases automatically (skips HITL-marked phases)
 3. Runs visual proof (Playwright) after each phase
 4. Enforces budgets to prevent runaway token usage
-5. Generates report at `.planning/PUSHPA_REPORT.md`
+5. Generates report at `.planning/JARVIS_REPORT.md`
 
 ### Budgets (override via env vars)
 
 | Budget | Default | Env Var |
 |--------|---------|---------|
-| Max phases | 3 | `MAX_PHASES_PER_RUN` |
-| Max minutes | 180 | `MAX_TOTAL_MINUTES` |
-| Max RRR calls | 25 | `MAX_TOTAL_RRR_CALLS` |
+| Max phases | 10 | `MAX_PHASES_PER_RUN` |
+| Max minutes | 360 | `MAX_TOTAL_MINUTES` |
+| Max RRR calls | 100 | `MAX_TOTAL_RRR_CALLS` |
 
 ### Output locations
 
-- Report: `.planning/PUSHPA_REPORT.md`
-- Logs: `.planning/logs/pushpa_*.log`
-- Ledger: `.planning/pushpa/ledger.json`
+- Report: `.planning/JARVIS_REPORT.md`
+- Logs: `.planning/logs/jarvis_*.log`
+- Ledger: `.planning/jarvis/ledger.json`
 - Artifacts: `.planning/artifacts/playwright/`
 ```
 </behavior>
 
 <constraints>
-- Do NOT run pushpa-mode.sh from this command
+- Do NOT run jarvis.sh from this command
 - Only provide guidance and instructions
 - Always recommend running in a separate terminal
 </constraints>

package/docs/CHEATSHEET-BROWNFIELD.md

@@ -68,7 +68,7 @@ Run this weekly or when `/rrr:update` tells you there's a new version.
 ### Windows Notes
 - Core commands work without bash (Read, Glob, Grep)
 - Hooks (statusline, notifications) need Git Bash or WSL2
-- npm scripts (`npm run pushpa`, `npm run e2e`) require bash
+- npm scripts (`npm run jarvis`, `npm run e2e`) require bash
 
 ### Commands Not Working?
 
@@ -248,10 +248,10 @@ See: [MILESTONE-STRUCTURE.md](./MILESTONE-STRUCTURE.md#decision-tree-patches-vs-
 **Commands:**
 ```bash
 # Run in a SEPARATE terminal (not inside Claude Code)
-bash scripts/pushpa-mode.sh
+bash scripts/jarvis-mode.sh
 
 # Or via npm
-npm run pushpa
+npm run jarvis
 ```
 
 **Safety:**

package/docs/CHEATSHEET-GREENFIELD.md

@@ -68,7 +68,7 @@ Run this weekly or when `/rrr:update` tells you there's a new version.
 ### Windows Notes
 - Core commands work without bash (Read, Glob, Grep)
 - Hooks (statusline, notifications) need Git Bash or WSL2
-- npm scripts (`npm run pushpa`, `npm run e2e`) require bash
+- npm scripts (`npm run jarvis`, `npm run e2e`) require bash
 
 ### Commands Not Working?
 
@@ -224,10 +224,10 @@ See: [MILESTONE-STRUCTURE.md](./MILESTONE-STRUCTURE.md#decision-tree-patches-vs-
 **Commands:**
 ```bash
 # Run in a SEPARATE terminal (not inside Claude Code)
-bash scripts/pushpa-mode.sh
+bash scripts/jarvis-mode.sh
 
 # Or via npm
-npm run pushpa
+npm run jarvis
 ```
 
 **Safety:**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projecta-rrr",
-  "version": "1.16.1",
+  "version": "1.16.3",
   "description": "A meta-prompting, context engineering and spec-driven development system for Claude Code by Projecta.ai",
   "bin": {
     "projecta-rrr": "bin/install.js"
@@ -12,7 +12,7 @@
     "test:browser": "vitest --browser",
     "test:ui": "vitest --ui",
     "mcp:setup": "bash scripts/mcp-setup.sh",
-    "pushpa": "bash scripts/pushpa-mode.sh",
+    "jarvis": "bash scripts/jarvis.sh",
     "visual:proof": "bash scripts/visual-proof.sh",
     "test:e2e": "playwright test",
     "test:e2e:ui": "playwright test --ui",

package/rrr/lib/checkpoint.sh

@@ -15,7 +15,7 @@
 #   checkpoint_init "$PUSHPA_DIR/checkpoint.json"
 #
 #   # Record progress
-#   checkpoint_set_phase "30" "pushpa-circuit-breaker"
+#   checkpoint_set_phase "30" "jarvis-circuit-breaker"
 #   checkpoint_set_plan "02" "3"
 #   checkpoint_set_task "2" "Add unit tests" "completed"
 #
@@ -369,7 +369,7 @@ checkpoint_set_plan() {
 #
 # Arguments:
 #   $1 - phase_number: Phase number (e.g., "30")
-#   $2 - phase_name: Phase name (e.g., "pushpa-circuit-breaker")
+#   $2 - phase_name: Phase name (e.g., "jarvis-circuit-breaker")
 #
 # Returns:
 #   0 on success

package/rrr/lib/morning-review.sh

@@ -10,7 +10,7 @@
 #   source rrr/lib/morning-review.sh
 #   generate_morning_review "$PUSHPA_DIR"
 #
-# Environment Variables (set by pushpa-mode.sh):
+# Environment Variables (set by jarvis-mode.sh):
 #   PUSHPA_LEDGER_FILE  - Path to ledger.json
 #   PUSHPA_LOG_FILE     - Path to run log file
 #   PUSHPA_STOP_REASON  - Stop reason string
@@ -22,19 +22,19 @@
 # ═══════════════════════════════════════════════════════════════════════════════
 #
 # Arguments:
-#   $1 - output_dir: Directory to write review files (default: .planning/pushpa)
+#   $1 - output_dir: Directory to write review files (default: .planning/jarvis)
 #
 # Returns:
 #   Prints paths to created files:
-#     json:/path/to/pushpa-review-YYYYMMDD.json
-#     txt:/path/to/pushpa-review-YYYYMMDD.txt
+#     json:/path/to/jarvis-review-YYYYMMDD.json
+#     txt:/path/to/jarvis-review-YYYYMMDD.txt
 #
 generate_morning_review() {
-    local output_dir="${1:-.planning/pushpa}"
+    local output_dir="${1:-.planning/jarvis}"
     local date_stamp
     date_stamp=$(date +%Y%m%d)
-    local json_file="$output_dir/pushpa-review-${date_stamp}.json"
-    local txt_file="$output_dir/pushpa-review-${date_stamp}.txt"
+    local json_file="$output_dir/jarvis-review-${date_stamp}.json"
+    local txt_file="$output_dir/jarvis-review-${date_stamp}.txt"
 
     mkdir -p "$output_dir"
 
@@ -188,8 +188,8 @@ build_review_txt() {
     # File paths
     local date_stamp
     date_stamp=$(date +%Y%m%d)
-    local ledger_path="${PUSHPA_LEDGER_FILE:-.planning/pushpa/ledger.json}"
-    local log_path="${PUSHPA_LOG_FILE:-.planning/logs/pushpa.log}"
+    local ledger_path="${PUSHPA_LEDGER_FILE:-.planning/jarvis/ledger.json}"
+    local log_path="${PUSHPA_LOG_FILE:-.planning/logs/jarvis.log}"
 
     cat <<EOF
 ================================================================================
@@ -231,8 +231,8 @@ Stop Reason: $stop_reason
 --------------------------------------------------------------------------------
 
 Files:
-  JSON:   .planning/pushpa/pushpa-review-${date_stamp}.json
-  TXT:    .planning/pushpa/pushpa-review-${date_stamp}.txt
+  JSON:   .planning/jarvis/jarvis-review-${date_stamp}.json
+  TXT:    .planning/jarvis/jarvis-review-${date_stamp}.txt
   Ledger: $ledger_path
   Logs:   $log_path
 

package/rrr/lib/phase-paths.md

@@ -199,9 +199,9 @@ create_phase_dir() {
 
 **Example:**
 ```bash
-new_dir=$(create_phase_dir 29 "pushpa-retry")
+new_dir=$(create_phase_dir 29 "jarvis-retry")
 echo "Created: $new_dir"
-# Output: "Created: .planning/milestones/v1.11/phases/29-pushpa-retry"
+# Output: "Created: .planning/milestones/v1.11/phases/29-jarvis-retry"
 ```
 
 ---

package/rrr/references/shell-compat.md

@@ -132,7 +132,7 @@ For full RRR functionality on Windows, recommend one of:
 
 Without either, core RRR commands work but:
 - Hooks won't run (statusline, notifications)
-- npm scripts like `npm run pushpa` won't work
+- npm scripts like `npm run jarvis` won't work
 - Visual proof scripts require manual workarounds
 
 ## Example: Cross-Platform Preflight

package/rrr/skills/projecta/visual-proof/SKILL.md

@@ -92,8 +92,8 @@ bash scripts/visual-proof.sh
 bash scripts/visual-proof.sh --chrome
 
 # Pushpa mode (no interactive prompts)
-bash scripts/visual-proof.sh --pushpa
-bash scripts/visual-proof.sh --pushpa --chrome
+bash scripts/visual-proof.sh --jarvis
+bash scripts/visual-proof.sh --jarvis --chrome
 
 # Individual commands
 npm run e2e                    # Headless Playwright