projecta-rrr 1.18.6 → 1.18.8

package/CHANGELOG.md

@@ -4,6 +4,34 @@ All notable changes to RRR will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [1.18.8] - 2026-02-03
+
+### Fixed
+
+- **HUD scripts actually removed** - v1.18.7 said they were removed but files still existed
+  - Deleted `scripts/rrr-hud.js`, `scripts/rrr-hud-dynamic.js`, and `hooks/rrr-sync-hud-state.sh`
+  - These were stated as removed in v1.18.7 but only removed from being called, not physically deleted
+- **Intent gate now works without HUD** - Reads directly from `.planning/STATE.md` instead of `hud-state.json`
+  - Fixes drift detection after HUD removal
+  - No longer depends on removed `rrr-sync-hud-state.sh` sync script
+- **Version mismatch false positives** - Simplified version check in `/rrr:new-milestone`
+  - No longer compares package.json version (npm release) with milestone version (feature delivery)
+  - These are different things and don't need to match (0.1.0 working on v1.0 is valid)
+  - Only checks: does CHANGELOG match package.json?
+
+### Changed
+
+- **OhMyPosh docs deprecated** - Added warnings that automated sync no longer works
+
+## [1.18.7] - 2026-02-03
+
+### Removed
+
+- **HUD script** - Removed `rrr-hud.js` and `rrr-hud-dynamic.js` from all workflows and installation
+  - Was silently failing due to broken require path after install
+  - Inline status updates (from v1.18.4) provide equivalent feedback
+  - Removed from 11 workflow files, install.js, smoke test, prepublish check
+
 ## [1.18.6] - 2026-02-01
 
 ### Fixed

package/bin/install.js

@@ -1119,28 +1119,6 @@ function install(isGlobal) {
     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-hud-dynamic.js to ~/.claude/rrr/scripts/
-  // Dynamic HUD state sync from RRR project files
-  const hudDynamicSrc = path.join(src, 'scripts', 'rrr-hud-dynamic.js');
-  if (fs.existsSync(hudDynamicSrc)) {
-    const scriptsDestDir = path.join(claudeDir, 'rrr', 'scripts');
-    fs.mkdirSync(scriptsDestDir, { recursive: true });
-    const hudDynamicDest = path.join(scriptsDestDir, 'rrr-hud-dynamic.js');
-    fs.copyFileSync(hudDynamicSrc, hudDynamicDest);
-    console.log(`  ${green}✓${reset} Installed rrr/scripts/rrr-hud-dynamic.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');

package/commands/rrr/check-todos.md

@@ -23,11 +23,6 @@ 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,11 +37,6 @@ 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,11 +28,6 @@ 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,12 +38,10 @@ Phase: $ARGUMENTS
 
 <process>
 
-0. **Show HUD and refresh cache (first)**
+0. **Refresh scope 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 before execution.
 
 1. **Validate phase exists**
    - Use `find_phase_dir()` from phase-paths library to locate phase directory:

package/commands/rrr/execute-plan.md

@@ -48,13 +48,10 @@ Plan path: $ARGUMENTS
 
 <process>
 
-0. **Refresh Scope Cache and HUD (first)**
+0. **Refresh Scope Cache (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:

package/commands/rrr/new-milestone.md

@@ -37,11 +37,6 @@ 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)
@@ -113,83 +108,56 @@ node ~/.claude/rrr/scripts/rrr-hud.js 2>/dev/null || echo "HUD skipped"
    **If no patches (PATCH_COUNT = 0 or file doesn't exist):**
    - Skip silently, continue to step 1.5
 
-1.5. **Version consistency check (MANDATORY):**
+1.5. **Version consistency check (SIMPLIFIED):**
 
-   Before writing any milestone files, verify version consistency.
+   Verify CHANGELOG matches package.json (if CHANGELOG exists).
 
    **Important context:**
-   - `package.json` is the CANONICAL source of truth for the current version
-   - `/rrr:check-version` compares against npm registry (different concern — checks if release is published)
-   - Documentation version drift is normal after updates — auto-fix is almost always the right choice
+   - `package.json` version = npm release version (e.g., 0.1.0)
+   - Milestone version = feature delivery version (e.g., v1.0)
+   - These are DIFFERENT and don't need to match!
+   - Only check: does CHANGELOG match package.json?
 
    ```bash
-   # Read canonical version from package.json
-   CANONICAL_VERSION=$(node -p "require('./package.json').version" 2>/dev/null)
-   echo "Canonical version (package.json): $CANONICAL_VERSION"
-
-   # Read CHANGELOG version
-   CHANGELOG_VERSION=$(grep -E "^## \[[0-9]" CHANGELOG.md 2>/dev/null | head -1 | sed 's/## \[\([^]]*\)\].*/\1/')
-   echo "CHANGELOG version: $CHANGELOG_VERSION"
-
-   # Read planning doc versions
-   ROADMAP_VERSION=$(grep -oE "v[0-9]+\.[0-9]+(\.[0-9]+)?" .planning/ROADMAP.md 2>/dev/null | head -1)
-   STATE_VERSION=$(grep -oE "v[0-9]+\.[0-9]+(\.[0-9]+)?" .planning/STATE.md 2>/dev/null | head -1)
+   # Read package.json version
+   PKG_VERSION=$(node -p "require('./package.json').version" 2>/dev/null || echo "")
+
+   # Read CHANGELOG version (first entry)
+   if [ -f "CHANGELOG.md" ]; then
+     CHANGELOG_VERSION=$(grep -E "^## \[[0-9]" CHANGELOG.md 2>/dev/null | head -1 | sed 's/## \[\([^]]*\)\].*/\1/')
+
+     if [ -n "$CHANGELOG_VERSION" ] && [ "$PKG_VERSION" != "$CHANGELOG_VERSION" ]; then
+       echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+       echo "VERSION MISMATCH DETECTED"
+       echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+       echo "package.json: $PKG_VERSION"
+       echo "CHANGELOG.md: $CHANGELOG_VERSION"
+       echo ""
+       echo "CHANGELOG should match package.json for release tracking."
+       # Ask user if they want to fix this or continue
+     fi
+   else
+     echo "No CHANGELOG.md found - skipping version check"
+   fi
    ```
 
-   **Version mismatch detection:**
-
-   Extract major.minor from canonical version and compare:
-   - If CHANGELOG major.minor != canonical major.minor → MISMATCH
-   - If planning docs reference different milestone version → MISMATCH
-
    **If mismatch detected:**
 
-   ```
-   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-   VERSION SYNC NEEDED
-   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-   Canonical (package.json): {CANONICAL_VERSION}
-   CHANGELOG.md:             {CHANGELOG_VERSION}
-   Planning docs:            {ROADMAP_VERSION}
-
-   This is normal after updates. Auto-fix will sync docs to package.json.
-   ```
-
    Use AskUserQuestion:
    - header: "Version"
-   - question: "Documentation versions need sync. How would you like to proceed?"
+   - question: "CHANGELOG version doesn't match package.json. Fix this?"
    - options:
-     - "Auto-fix now (Recommended)" — Update docs to match package.json
-     - "Run /rrr:check-version" — Check npm registry status (different concern — won't fix doc drift)
-     - "Continue anyway" — Proceed with mismatched versions (documentation debt)
-     - "Abort" — Cancel milestone creation
-
-   **If "Auto-fix now (Recommended)":**
-   - Update CHANGELOG.md with [Unreleased] header if needed
-   - Update planning docs milestone references to match canonical
-   - Continue to step 2
-
-   **If "Run /rrr:check-version":**
-   ```
-   Note: /rrr:check-version compares package.json against the npm registry.
-   This is useful for checking publish status, but won't fix documentation drift.
-   You may still need to run "Auto-fix now" after.
+     - "Yes, update CHANGELOG (Recommended)" — Update CHANGELOG to match package.json
+     - "No, continue anyway" — Proceed with mismatch (can fix later with /rrr:check-version)
 
-   Run `/rrr:check-version` to check registry status, then return to `/rrr:new-milestone`
-   ```
-   Exit command.
-
-   **If "Continue anyway":**
-   ```
-   Continuing with version mismatch. This creates documentation debt.
-   Consider running `/rrr:new-milestone` again later with "Auto-fix now" to sync versions.
-   ```
-   Continue to step 2.
+   **If "Yes, update CHANGELOG":**
+   - Add/update CHANGELOG entry to match package.json version
+   - Continue to step 2
 
-   **If "Abort":** Exit command.
+   **If "No, continue anyway":**
+   - Continue to step 2 (user can fix later)
 
-   **If versions match:** Continue to step 2.
+   **If no mismatch:** Continue to step 2.
 
 2. **Gather milestone goals:**
 

package/commands/rrr/pause-work.md

@@ -19,11 +19,6 @@ 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

@@ -91,12 +91,10 @@ Use Glob tool with both structures:
 
 <process>
 
-0. **Show HUD and refresh cache (first)**
+0. **Refresh scope 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)
 

package/commands/rrr/progress.md

@@ -24,20 +24,13 @@ Provides situational awareness before continuing work.
 <process>
 
 <step name="refresh_cache">
-**Refresh Scope Cache and HUD (first, before any reads):**
+**Refresh Scope Cache (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 commands work in PowerShell. If Node unavailable, skip silently.
-
-**Note:** Paths resolve to installed location (e.g., `$HOME/.claude/` or `./.claude/`).
-
-This ensures SCOPE_CACHE.md is current and shows visual HUD before displaying status.
+Cross-platform: works in PowerShell on Windows. Ensures SCOPE_CACHE.md is current.
 </step>
 
 <step name="verify">

package/commands/rrr/resume-work.md

@@ -27,15 +27,12 @@ Routes to the resume-project workflow which handles:
 
 <process>
 
-**0. Show HUD and refresh cache (first)**
+**0. Refresh scope 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 on resume.
-
 **Follow the resume-project workflow** from `@~/.claude/rrr/workflows/resume-project.md`.
 
 The workflow handles all resumption logic including:

package/commands/rrr/verify-work.md

@@ -76,12 +76,10 @@ Validate built features through **audit mode by default**, or interactive UAT wi
 
 <process>
 
-0. **Show HUD and refresh cache (first)**
+0. **Refresh scope 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>
 

package/docs/OHMPOSH-SETUP.md

@@ -1,5 +1,9 @@
 # OhMyPosh HUD Setup Guide
 
+> **⚠️ DEPRECATED**: As of v1.18.7, the automated HUD sync scripts have been removed.
+> This integration requires manual state updates via `rrr-state-manager.js`.
+> Consider using inline status updates instead (built into RRR v1.18.4+).
+
 This guide explains how to set up the RRR HUD using OhMyPosh with **Kushal theme** styling (recommended) or Atomic theme.
 
 ## Theme Options

package/docs/ohmyposh-config.md

@@ -1,5 +1,8 @@
 # OhMyPosh Integration for RRR HUD
 
+> **⚠️ DEPRECATED**: As of v1.18.7, automated HUD sync scripts have been removed.
+> OhMyPosh integration requires manual state updates. Use RRR's inline status display instead.
+
 Display RRR context (intent, drift status, session duration) in your terminal prompt using OhMyPosh.
 
 ## Prerequisites

package/hooks/rrr-intent-gate.sh

@@ -20,8 +20,8 @@ fi
 # SKIP CONDITIONS - Let these through without gate
 # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-# Skip empty or very short messages (lowered from 15 to 8 to catch "fix a bug")
-[[ -z "$USER_MESSAGE" || ${#USER_MESSAGE} -lt 8 ]] && exit 0
+# Skip empty or very short messages (5 chars catches "add X", "fix Y", etc.)
+[[ -z "$USER_MESSAGE" || ${#USER_MESSAGE} -lt 5 ]] && exit 0
 
 # Skip slash commands (already intentional)
 [[ "$USER_MESSAGE" == /* ]] && exit 0
@@ -39,22 +39,44 @@ echo "$msg_lower" | grep -qE "^(what|why|how|where|when|which|can you explain|ex
 echo "$msg_lower" | grep -qE "\?$" && exit 0
 
 # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-# CHECK STATE - Only gate if no active plan
+# CHECK STATE - Read directly from .planning/ files
 # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-HUD_FILE="${HOME}/.claude/rrr/hud-state.json"
-[[ ! -f "$HUD_FILE" ]] && exit 0
-
-status=$(jq -r '.status // ""' "$HUD_FILE" 2>/dev/null)
-plan=$(jq -r '.plan // ""' "$HUD_FILE" 2>/dev/null)
-phase=$(jq -r '.phase // ""' "$HUD_FILE" 2>/dev/null)
-milestone=$(jq -r '.milestone // ""' "$HUD_FILE" 2>/dev/null)
+# Find RRR project root (look for .planning directory)
+RRR_PROJECT=""
+current_dir="$(pwd)"
+for i in 0 1 2 3 4 5; do
+    if [ -d ".planning" ]; then
+        RRR_PROJECT="$(pwd)"
+        break
+    fi
+    cd .. 2>/dev/null || break
+done
+cd "$current_dir" 2>/dev/null
+
+# Not in an RRR project - skip gate
+[[ -z "$RRR_PROJECT" ]] && exit 0
+
+# Check STATE.md for active work
+STATE_FILE="${RRR_PROJECT}/.planning/STATE.md"
+if [ -f "$STATE_FILE" ]; then
+    # Extract current position from STATE.md
+    milestone=$(grep -E "^Milestone:" "$STATE_FILE" 2>/dev/null | sed 's/Milestone:[[:space:]]*//' | tr -d '\r\n' || echo "")
+    phase=$(grep -E "^Phase:" "$STATE_FILE" 2>/dev/null | sed 's/Phase:[[:space:]]*//' | tr -d '\r\n' || echo "")
+    plan=$(grep -E "^Plan:" "$STATE_FILE" 2>/dev/null | sed 's/Plan:[[:space:]]*//' | tr -d '\r\n' || echo "")
+    status=$(grep -E "^Status:" "$STATE_FILE" 2>/dev/null | sed 's/Status:[[:space:]]*//' | tr -d '\r\n' || echo "")
+else
+    milestone=""
+    phase=""
+    plan=""
+    status=""
+fi
 
-# If we have an active plan, let through
-[[ -n "$plan" && "$plan" != "null" ]] && exit 0
+# If we have an active plan (not "—" or empty), let through
+[[ -n "$plan" && "$plan" != "—" && "$plan" != "null" ]] && exit 0
 
-# If status is active (working on something), let through
-[[ "$status" == "active" ]] && exit 0
+# If status contains "Executing", let through
+echo "$status" | grep -qi "executing" && exit 0
 
 # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 # DETECT WORK REQUESTS - Only gate substantial work
@@ -67,18 +89,19 @@ if echo "$msg_lower" | grep -qiE "$work_patterns"; then
     echo ""
     echo "<MANDATORY-INTENT-GATE>"
     echo ""
-    echo "I detected a work request but you have no active plan."
+    echo "⚠️  DRIFT DETECTED: Work request without active plan"
     echo ""
-    echo "  Current: ${milestone:-no milestone} / ${phase:-no phase} / ${plan:-no plan}"
-    echo "  Status:  ${status:-unknown}"
+    echo "  Current: ${milestone:-no milestone} / ${phase:-no phase} / ${plan:-—}"
+    echo "  Status:  ${status:-Defining requirements}"
     echo ""
-    echo "Before I proceed, where should this work go?"
+    echo "Where should this work be tracked?"
     echo ""
-    echo "  1) /rrr:plan-phase   - Create a tracked phase for this work"
-    echo "  2) /rrr:add-todo     - Save to backlog for later"
-    echo "  3) Type 'adhoc'      - Do it now without tracking"
+    echo "  1. /rrr:plan-phase   - Create a tracked phase"
+    echo "  2. /rrr:add-todo     - Save to backlog"
+    echo "  3. Type 'adhoc'      - Quick fix (untracked)"
     echo ""
     echo "</MANDATORY-INTENT-GATE>"
+    echo ""
     exit 1  # BLOCK until user classifies
 fi
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projecta-rrr",
-  "version": "1.18.6",
+  "version": "1.18.8",
   "description": "A meta-prompting, context engineering and spec-driven development system for Claude Code by Projecta.ai",
   "bin": {
     "projecta-rrr": "bin/install.js"