projecta-rrr 1.16.6 → 1.16.8

package/CHANGELOG.md

@@ -4,6 +4,70 @@ 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.8] - 2026-01-28
+
+### Added
+
+- **Install-Time Project Context** (`scripts/build-project-context.js`) - Builds comprehensive project memory at install/upgrade:
+  - Enumerates all milestones and phases with status
+  - Analyzes git history for project evolution narrative
+  - Stores context in `.planning/rrr-project-context.json`
+  - Auto-rebuilds on RRR upgrade
+
+- **Enhanced HUD with Drift Detection** (`scripts/rrr-hud.js`) - Bulletproof drift detection:
+  - Prominent red "DRIFT DETECTED" warning with stale plan counts
+  - Context signals (files changed without active plan)
+  - Changed file tracking with code file detection
+  - Actionable numbered guidance: verify-work, complete plans, or pause-work
+  - Robust error handling for all git/file operations
+
+- **HUD Integration** - Added visual HUD display to 9 commands:
+  - Tier 1: progress, execute-plan, verify-work, execute-phase, plan-phase
+  - Tier 2: complete-milestone, resume-work, check-todos
+  - Tier 3: debug, new-milestone, pause-work
+
+### Changed
+
+- **bin/install.js** - Runs context builder after install for any project with `.planning/`
+
+- **hooks/rrr-check-update.sh** - Rebuilds project context when RRR upgrade detected
+
+## [1.16.7] - 2026-01-28
+
+### Added
+- **Memory System** (`rrr/lib/memory-store.js`) - Central library for tracking:
+  - Command history with intent extraction
+  - Current user intent persistence
+  - Decision log with rationale
+  - Drift detection (context drift, stale plans, decision conflicts)
+
+- **Visual HUD** (`scripts/rrr-hud.js`) - ASCII progress display showing:
+  - Milestone progress bar with percentage
+  - Per-phase completion status
+  - Drift status (green/yellow/red)
+  - Current intent from memory
+
+- **Proactive Guidance** (`scripts/rrr-memory/state-detector.js`) - State-aware suggestions:
+  - 4D state analysis (project, milestone, phase, action)
+  - `guidanceFor(command)` for 17 command scenarios
+  - Orphan phase detection and migration guidance
+
+- **Memory-Enriched Preflight** (`scripts/handoff-preflight.js`) - Drift detection on handoff
+
+### Changed
+- **Phase path resolution** (`rrr/lib/phase-paths.md`) - Fixed bug where phases were created outside milestones when no `:construction:` marker existed. Now errors if `.planning/milestones/` exists but no active milestone detected.
+
+- **execute-plan** - Tracks intent before execution for drift detection
+
+- **verify-work** - Shows memory context during verification
+
+- **add-phase / insert-phase** - Validates no orphan phases exist before allowing new phase creation
+
+- **Duplicate prevention** (`bin/install.js`, `scripts/doctor-rrr.js`) - Auto-cleans old quarantine directories (>7 days) to prevent duplicate command scanning
+
+### Fixed
+- **Duplicate commands** - 282 command references reduced to 41 by cleaning old quarantines
+
 ## [1.16.6] - 2026-01-28
 
 ### Added

package/bin/install.js

@@ -11,7 +11,8 @@ const {
   detectAndQuarantineDuplicates,
   writeInstallInfo,
   getCurrentVersion,
-  getCanonicalRoots
+  getCanonicalRoots,
+  cleanOldQuarantines
 } = require('../rrr/lib/install-roots');
 
 /**
@@ -909,6 +910,49 @@ function install(isGlobal) {
     console.log(`  ${green}✓${reset} Installed rrr/scripts/test-install-smoke.js`);
   }
 
+  // PATCH-01: Copy handoff-preflight.js to ~/.claude/rrr/scripts/
+  // Memory-enriched preflight for drift detection
+  const handoffSrc = path.join(src, 'scripts', 'handoff-preflight.js');
+  if (fs.existsSync(handoffSrc)) {
+    const scriptsDestDir = path.join(claudeDir, 'rrr', 'scripts');
+    fs.mkdirSync(scriptsDestDir, { recursive: true });
+    const handoffDest = path.join(scriptsDestDir, 'handoff-preflight.js');
+    fs.copyFileSync(handoffSrc, handoffDest);
+    console.log(`  ${green}✓${reset} Installed rrr/scripts/handoff-preflight.js`);
+  }
+
+  // PATCH-01: Copy rrr-hud.js to ~/.claude/rrr/scripts/
+  // Visual HUD for project state display
+  const hudSrc = path.join(src, 'scripts', 'rrr-hud.js');
+  if (fs.existsSync(hudSrc)) {
+    const scriptsDestDir = path.join(claudeDir, 'rrr', 'scripts');
+    fs.mkdirSync(scriptsDestDir, { recursive: true });
+    const hudDest = path.join(scriptsDestDir, 'rrr-hud.js');
+    fs.copyFileSync(hudSrc, hudDest);
+    console.log(`  ${green}✓${reset} Installed rrr/scripts/rrr-hud.js`);
+  }
+
+  // PATCH-01: Copy rrr-memory/ directory to ~/.claude/rrr/scripts/
+  // Memory store and state detector for proactive guidance
+  const rrrMemorySrc = path.join(src, 'scripts', 'rrr-memory');
+  if (fs.existsSync(rrrMemorySrc)) {
+    const scriptsDestDir = path.join(claudeDir, 'rrr', 'scripts');
+    const rrrMemoryDest = path.join(scriptsDestDir, 'rrr-memory');
+    copyWithPathReplacement(rrrMemorySrc, rrrMemoryDest, pathPrefix);
+    console.log(`  ${green}✓${reset} Installed rrr/scripts/rrr-memory/`);
+  }
+
+  // PATCH-01: Copy build-project-context.js to ~/.claude/rrr/scripts/
+  // Builds project memory (milestones, phases, git history) at install/upgrade
+  const projectContextSrc = path.join(src, 'scripts', 'build-project-context.js');
+  if (fs.existsSync(projectContextSrc)) {
+    const scriptsDestDir = path.join(claudeDir, 'rrr', 'scripts');
+    fs.mkdirSync(scriptsDestDir, { recursive: true });
+    const projectContextDest = path.join(scriptsDestDir, 'build-project-context.js');
+    fs.copyFileSync(projectContextSrc, projectContextDest);
+    console.log(`  ${green}✓${reset} Installed rrr/scripts/build-project-context.js`);
+  }
+
   // Copy skills to ~/.claude/skills (skills system)
   const skillsSrc = path.join(src, 'rrr', 'skills');
   if (fs.existsSync(skillsSrc)) {
@@ -963,6 +1007,15 @@ function install(isGlobal) {
     if (quarantineResult.quarantined.length > 0) {
       console.log(`  ${green}✓${reset} Quarantined ${quarantineResult.quarantined.length} legacy/duplicate root(s)`);
     }
+
+    // Clean up old quarantine directories (>7 days) to prevent duplicate command scanning
+    console.log(`  ${green}✓${reset} Cleaning old quarantine directories...`);
+    const cleanupResult = cleanOldQuarantines({
+      configDir: explicitConfigDir || process.env.CLAUDE_CONFIG_DIR
+    });
+    if (cleanupResult.cleaned.length > 0) {
+      console.log(`  ${green}✓${reset} Cleaned ${cleanupResult.cleaned.length} old quarantine folder(s)`);
+    }
   }
 
   // Register rrr-search MCP server and run semantic migration
@@ -1205,6 +1258,27 @@ function install(isGlobal) {
         // Silent fail - cleanup is optional, don't block install
       }
     }
+
+    // PATCH-01: Build project context (milestones, phases, git history)
+    // This creates a persistent memory of project structure for HUD and decisions
+    // Runs once, AFTER all project-specific setup, for any project with .planning
+    const projectContextScript = path.join(src, 'scripts', 'build-project-context.js');
+    if (fs.existsSync(projectContextScript)) {
+      try {
+        const { buildProjectContext } = require(projectContextScript);
+        const planningDir = path.join(projectDir, '.planning');
+        if (fs.existsSync(planningDir)) {
+          const context = buildProjectContext();
+          if (context) {
+            console.log(`  ${green}✓${reset} Built project context (${context.stats.totalMilestones} milestones, ${context.stats.totalPlans} plans)`);
+          } else {
+            console.log(`  ${green}✓${reset} Project context up to date`);
+          }
+        }
+      } catch (e) {
+        // Silent fail - context building is optional
+      }
+    }
   }
 
   return { settingsPath, settings, statuslineCommand, notifyCommand, claudeDir, localDirName, isGlobal, bashAvailable: bashStatus.available };

package/commands/rrr/add-phase.md

@@ -33,6 +33,7 @@ Purpose: Add planned work discovered during execution that belongs at the end of
 @.planning/STATE.md
 @rrr/lib/phase-paths.md
 @rrr/lib/milestone-utils.md
+@rrr/lib/memory-store.js
 </execution_context>
 
 <process>
@@ -68,6 +69,50 @@ Example: /rrr:add-phase Add authentication system
 Exit.
 </step>
 
+<step name="check_orphan_phases_memory">
+**Check for orphan phases using state-detector (PATCH-01 enhancement)**
+
+Before creating phases, check if there are orphan phases that need migration:
+
+```bash
+# Check for orphan phases
+node -e "
+const { StateDetector } = require(process.env.HOME + '/.claude/rrr/scripts/rrr-memory/state-detector');
+const detector = new StateDetector();
+const state = detector.detectPhaseState('.planning');
+const milestone = detector.detectMilestoneState('.planning');
+
+if (milestone === 'NO_MILESTONE' && state !== 'NO_PHASES') {
+  console.log('HAS_ORPHAN_PHASES=true');
+  console.log('RUN: /rrr:new-milestone or /rrr:migrate-phases');
+}
+" 2>/dev/null
+```
+
+If `HAS_ORPHAN_PHASES=true` is output, show guidance and exit (unless --force).
+
+**If orphan phases detected:**
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+⚠ ORPHAN PHASES DETECTED
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Found phases not assigned to any milestone.
+New phases cannot be created until orphans are assigned.
+
+To migrate orphan phases:
+1. /rrr:new-milestone - Create milestone for orphan phases
+2. /rrr:migrate-phases - Assign phases to milestone
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+Exit command.
+
+**If no orphans or --force:** Continue to validate_milestone_first step.
+</step>
+
 <step name="validate_milestone_first">
 **MILESTONE-FIRST ENFORCEMENT (v1.11 breaking change)**
 

package/commands/rrr/check-todos.md

@@ -23,6 +23,11 @@ Enables reviewing captured ideas and deciding what to work on next.
 
 <process>
 
+**Show HUD (first)**
+```bash
+node ~/.claude/rrr/scripts/rrr-hud.js 2>/dev/null || echo "HUD skipped"
+```
+
 <step name="check_exist">
 ```bash
 TODO_COUNT=$(ls .planning/todos/pending/*.md 2>/dev/null | wc -l | tr -d ' ')

package/commands/rrr/complete-milestone.md

@@ -37,6 +37,11 @@ Output: Milestone archived (roadmap + requirements), PROJECT.md evolved, git tag
 
 <process>
 
+**Show HUD (first)**
+```bash
+node ~/.claude/rrr/scripts/rrr-hud.js 2>/dev/null || echo "HUD skipped"
+```
+
 **Follow complete-milestone.md workflow:**
 
 0. **Check for audit:**

package/commands/rrr/debug.md

@@ -28,6 +28,11 @@ ls .planning/debug/*.md 2>/dev/null | grep -v resolved | head -5
 
 <process>
 
+**Show HUD (first)**
+```bash
+node ~/.claude/rrr/scripts/rrr-hud.js 2>/dev/null || echo "HUD skipped"
+```
+
 ## 1. Check Active Sessions
 
 If active sessions exist AND no $ARGUMENTS:

package/commands/rrr/execute-phase.md

@@ -38,11 +38,12 @@ Phase: $ARGUMENTS
 
 <process>
 
-0. **Refresh Scope Cache (first)**
+0. **Show HUD and refresh cache (first)**
    ```bash
+   node ~/.claude/rrr/scripts/rrr-hud.js 2>/dev/null || echo "HUD skipped"
    node ~/.claude/rrr/scripts/refresh-scope-cache.js 2>/dev/null || echo "Cache refresh skipped"
    ```
-   Cross-platform: works in PowerShell on Windows. Path resolved to installed location.
+   Cross-platform: works in PowerShell on Windows. Shows visual project state before execution.
 
 1. **Validate phase exists**
    - Use `find_phase_dir()` from phase-paths library to locate phase directory:

package/commands/rrr/execute-plan.md

@@ -36,15 +36,54 @@ Plan path: $ARGUMENTS
 
 @.planning/STATE.md
 @.planning/config.json (if exists)
+@rrr/lib/memory-store.js
 </context>
 
 <process>
 
-0. **Refresh Scope Cache (first)**
+0. **Refresh Scope Cache and HUD (first)**
    ```bash
    node ~/.claude/rrr/scripts/refresh-scope-cache.js 2>/dev/null || echo "Cache refresh skipped"
+   node ~/.claude/rrr/scripts/rrr-hud.js 2>/dev/null || echo "HUD skipped"
    ```
    Cross-platform: works in PowerShell on Windows. Path resolved to installed location.
+   Shows visual project state before execution.
+
+0. **Track command in memory (before execution)**
+   Parse the plan to extract intent from frontmatter and context, then track this execution:
+
+   ```bash
+   # Extract plan ID and objective for intent tracking
+   PLAN_ID=$(basename "$ARGUMENTS" | sed 's/-PLAN\.md$//')
+   PLAN_DIR=$(dirname "$ARGUMENTS")
+   PHASE_DIR=$(basename "$PLAN_DIR")
+
+   # Get intent from plan frontmatter (try files_modified, then title)
+   INTENT=""
+   if [ -f "$ARGUMENTS" ]; then
+     INTENT=$(grep -E "^files_modified:" "$ARGUMENTS" 2>/dev/null | head -1 | sed 's/files_modified: *\[*\]*/Intent from plan/' || \
+              grep -E "^title:" "$ARGUMENTS" 2>/dev/null | head -1 | sed 's/title: *//' || \
+              echo "Executing plan $PLAN_ID")
+   fi
+
+   # Track in memory (if memory-store.js is available)
+   node -e "
+   const { initMemory, trackCommand } = require(process.env.HOME + '/.claude/rrr/lib/memory-store');
+   (async () => {
+     try {
+       const memory = await initMemory();
+       await trackCommand(memory, {
+         command: '/rrr:execute-plan',
+         target: '$PLAN_ID',
+         intent: '$INTENT',
+         files: []
+       });
+     } catch (e) {
+       // Memory tracking is optional
+     }
+   })();
+   " 2>/dev/null || echo "[MEMORY] Tracking skipped"
+   ```
 
 0.5. **Scope Check (validate plan is in scope)**
 

package/commands/rrr/insert-phase.md

@@ -23,6 +23,7 @@ Purpose: Handle urgent work discovered during execution without renumbering enti
 @.planning/STATE.md
 @rrr/lib/phase-paths.md
 @rrr/lib/milestone-utils.md
+@rrr/lib/memory-store.js
 </execution_context>
 
 <process>
@@ -74,6 +75,50 @@ fi
 
 </step>
 
+<step name="check_orphan_phases_memory">
+**Check for orphan phases using state-detector (PATCH-01 enhancement)**
+
+Same validation as add-phase - check for orphan phases before allowing new insert:
+
+```bash
+# Check for orphan phases
+node -e "
+const { StateDetector } = require(process.env.HOME + '/.claude/rrr/scripts/rrr-memory/state-detector');
+const detector = new StateDetector();
+const state = detector.detectPhaseState('.planning');
+const milestone = detector.detectMilestoneState('.planning');
+
+if (milestone === 'NO_MILESTONE' && state !== 'NO_PHASES') {
+  console.log('HAS_ORPHAN_PHASES=true');
+  console.log('RUN: /rrr:new-milestone or /rrr:migrate-phases');
+}
+" 2>/dev/null
+```
+
+If `HAS_ORPHAN_PHASES=true`, show guidance and exit (unless --force).
+
+**If orphan phases detected:**
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+⚠ ORPHAN PHASES DETECTED
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Found phases not assigned to any milestone.
+Inserting new phase not allowed until orphans are assigned.
+
+To migrate orphan phases:
+1. /rrr:new-milestone - Create milestone for orphan phases
+2. /rrr:migrate-phases - Assign phases to milestone
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+Exit command.
+
+**If no orphans or --force:** Continue to validate_milestone_first step.
+</step>
+
 <step name="validate_milestone_first">
 **MILESTONE-FIRST ENFORCEMENT (v1.11 breaking change)**
 

package/commands/rrr/new-milestone.md

@@ -37,6 +37,11 @@ Milestone name: $ARGUMENTS (optional - will prompt if not provided)
 
 <process>
 
+**Show HUD (first)**
+```bash
+node ~/.claude/rrr/scripts/rrr-hud.js 2>/dev/null || echo "HUD skipped"
+```
+
 1. **Load context:**
    - Read PROJECT.md (existing project, Validated requirements, decisions)
    - Read MILESTONES.md (what shipped previously)

package/commands/rrr/pause-work.md

@@ -19,6 +19,11 @@ Enables seamless resumption in fresh session with full context restoration.
 
 <process>
 
+**Show HUD (first)**
+```bash
+node ~/.claude/rrr/scripts/rrr-hud.js 2>/dev/null || echo "HUD skipped"
+```
+
 <step name="detect">
 Find current phase directory from most recently modified files.
 </step>

package/commands/rrr/plan-phase.md

@@ -71,6 +71,13 @@ Use Glob tool with both structures:
 
 <process>
 
+0. **Show HUD and refresh cache (first)**
+   ```bash
+   node ~/.claude/rrr/scripts/rrr-hud.js 2>/dev/null || echo "HUD skipped"
+   node ~/.claude/rrr/scripts/refresh-scope-cache.js 2>/dev/null || echo "Cache refresh skipped"
+   ```
+   Cross-platform: works in PowerShell on Windows. Shows visual context before planning.
+
 ## 1. Validate Environment (Cross-Platform)
 
 **Step 1: Check .planning/ exists via STATE.md**

package/commands/rrr/progress.md

@@ -24,19 +24,20 @@ Provides situational awareness before continuing work.
 <process>
 
 <step name="refresh_cache">
-**Refresh Scope Cache (first, before any reads):**
+**Refresh Scope Cache and HUD (first, before any reads):**
 
 **On macOS/Linux:**
 ```bash
 node ~/.claude/rrr/scripts/refresh-scope-cache.js 2>/dev/null || echo "Cache refresh skipped"
+node ~/.claude/rrr/scripts/rrr-hud.js 2>/dev/null || echo "HUD skipped"
 ```
 
 **On Windows (Platform: win32):**
-Same command works in PowerShell. If Node unavailable, skip silently.
+Same commands work in PowerShell. If Node unavailable, skip silently.
 
-**Note:** Path is resolved to installed location (e.g., `$HOME/.claude/` or `./.claude/`).
+**Note:** Paths resolve to installed location (e.g., `$HOME/.claude/` or `./.claude/`).
 
-This ensures SCOPE_CACHE.md is current before displaying status.
+This ensures SCOPE_CACHE.md is current and shows visual HUD before displaying status.
 </step>
 
 <step name="verify">

package/commands/rrr/resume-work.md

@@ -27,13 +27,14 @@ Routes to the resume-project workflow which handles:
 
 <process>
 
-**0. Refresh Scope Cache (first)**
+**0. Show HUD and refresh cache (first)**
 
 ```bash
+node ~/.claude/rrr/scripts/rrr-hud.js 2>/dev/null || echo "HUD skipped"
 node ~/.claude/rrr/scripts/refresh-scope-cache.js 2>/dev/null || echo "Cache refresh skipped"
 ```
 
-Cross-platform: works in PowerShell on Windows. Path resolved to installed location.
+Cross-platform: works in PowerShell on Windows. Shows visual project state on resume.
 
 **Follow the resume-project workflow** from `@~/.claude/rrr/workflows/resume-project.md`.
 

package/commands/rrr/verify-work.md

@@ -71,8 +71,20 @@ Validate built features through **audit mode by default**, or interactive UAT wi
 
 <execution_context>
 @rrr/lib/phase-paths.md
+@rrr/lib/memory-store.js
 </execution_context>
 
+<process>
+
+0. **Show HUD and refresh cache (first)**
+   ```bash
+   node ~/.claude/rrr/scripts/rrr-hud.js 2>/dev/null || echo "HUD skipped"
+   node ~/.claude/rrr/scripts/refresh-scope-cache.js 2>/dev/null || echo "Cache refresh skipped"
+   ```
+   Cross-platform: works in PowerShell on Windows. Shows visual project state and drift before verification.
+
+</process>
+
 <!-- ═══════════════════════════════════════════════════════════════════════════
      MODE SELECTION - MUST EXECUTE FIRST BEFORE ANY OTHER SECTION
      ═══════════════════════════════════════════════════════════════════════════ -->
@@ -140,6 +152,41 @@ For manual testing, use: /rrr:verify-work --uat [phase]
 
 ---
 
+### Step 0.5: Show Memory Context (PATCH-01 enhancement)
+
+Display current intent and recent commands to provide context during verification:
+
+```bash
+# Show memory context if available
+node -e "
+const { initMemory, getSummary } = require(process.env.HOME + '/.claude/rrr/lib/memory-store');
+(async () => {
+  try {
+    const memory = await initMemory();
+    const summary = await getSummary(memory);
+    console.log('');
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.log(' RRR ► MEMORY CONTEXT');
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.log('Intent:', summary.currentIntent || '(no intent tracked)');
+    console.log('Recent:', summary.recentCommands.slice(0, 2).map(c =>
+      c.cmd + (c.target ? '(' + c.target + ')' : '')
+    ).join(' → ') || 'none');
+    if (summary.drift && summary.drift.drifting) {
+      console.log('Drift:', summary.drift.message);
+    }
+    console.log('───────────────────────────────────────────────────────');
+  } catch (e) {
+    // Memory not available, skip silently
+  }
+})();
+" 2>/dev/null || true
+```
+
+This helps verify-work understand what the user was working on.
+
+---
+
 ### Step 1: Determine Scope
 
 **Parse target from arguments (with flags removed):**

package/hooks/rrr-check-update.sh

@@ -7,10 +7,14 @@
 # Graceful degradation: if npm is not available, exit silently
 command -v npm >/dev/null 2>&1 || exit 0
 
+# Graceful degradation: if jq is not available, exit silently
+command -v jq >/dev/null 2>&1 || exit 0
+
 # Catch any errors and exit gracefully (non-blocking hook)
 set +e
 
 CACHE_FILE="$HOME/.claude/cache/rrr-update-check.json"
+CONTEXT_FILE=".planning/rrr-project-context.json"
 mkdir -p "$HOME/.claude/cache"
 
 # Run check in background (non-blocking)
@@ -18,11 +22,22 @@ mkdir -p "$HOME/.claude/cache"
   installed=$(cat "$HOME/.claude/rrr/VERSION" 2>/dev/null || echo "0.0.0")
   latest=$(npm view projecta-rrr version 2>/dev/null)
 
+  update_available=false
   if [[ -n "$latest" && "$installed" != "$latest" ]]; then
+    update_available=true
+  fi
+
+  if [[ "$update_available" == "true" ]]; then
     echo "{\"update_available\":true,\"installed\":\"$installed\",\"latest\":\"$latest\",\"checked\":$(date +%s)}" > "$CACHE_FILE"
   else
     echo "{\"update_available\":false,\"installed\":\"$installed\",\"latest\":\"${latest:-unknown}\",\"checked\":$(date +%s)}" > "$CACHE_FILE"
   fi
+
+  # If upgrade available, rebuild project context in background
+  # This ensures new RRR capabilities get fresh context data
+  if [[ "$update_available" == "true" ]] && [[ -f "scripts/build-project-context.js" ]]; then
+    node scripts/build-project-context.js 2>/dev/null &
+  fi
 ) &
 
 exit 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projecta-rrr",
-  "version": "1.16.6",
+  "version": "1.16.8",
   "description": "A meta-prompting, context engineering and spec-driven development system for Claude Code by Projecta.ai",
   "bin": {
     "projecta-rrr": "bin/install.js"
@@ -22,7 +22,10 @@
     "sessions:index": "bash scripts/index-sessions.sh",
     "sessions:status": "bash scripts/index-sessions.sh --status",
     "semantic:verify": "bash scripts/verify-semantic-search.sh",
-    "prepublish:check": "node scripts/prepublish-check.js"
+    "prepublish:check": "node scripts/prepublish-check.js",
+    "browser:uat": "bash scripts/browser-uat.sh",
+    "scaffold:e2e": "bash scripts/scaffold-e2e.sh",
+    "chrome:visual": "bash scripts/chrome-visual-check.sh"
   },
   "files": [
     "bin",