projecta-rrr 1.18.5 → 1.18.7

package/CHANGELOG.md

@@ -4,6 +4,22 @@ 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.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
+
+- **plan-phase milestone research lookup** - Now checks milestone research folder first, falls back to project research
+- **create-roadmap milestone research lookup** - Now uses milestone-aware research context
+
 ## [1.18.5] - 2026-02-01
 
 ### Added

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/create-roadmap.md

@@ -46,7 +46,11 @@ Roadmaps define what work happens in what order. Phases map to requirements.
 @.planning/PROJECT.md
 @.planning/config.json
 @.planning/REQUIREMENTS.md
-@.planning/research/SUMMARY.md (if exists)
+@.planning/STATE.md (to detect active milestone)
+
+**Research context (checked in order):**
+1. `.planning/milestones/vX.Y/research/SUMMARY.md` (milestone-specific)
+2. `.planning/research/SUMMARY.md` (project-level fallback)
 </context>
 
 <process>

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)

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

@@ -39,22 +39,40 @@ Phase number: $ARGUMENTS (optional - auto-detects next unplanned phase if not pr
 - `--gaps` — Gap closure mode (reads VERIFICATION.md, skips research)
 - `--skip-verify` — Skip planner → checker verification loop
 
-**Research defaults:** If `.planning/research/SUMMARY.md` exists (from `/rrr:new-project`), research is skipped by default unless:
+**Research defaults:** If research SUMMARY.md exists (milestone or project level), research is skipped by default unless:
 - `--research` flag is set, OR
 - Phase involves risky domains (auth, payments, security, webhooks), OR
 - `.planning/codebase/` is missing for brownfield projects
 
+**Research location (checked in order):**
+1. `.planning/milestones/vX.Y/research/SUMMARY.md` (milestone-specific)
+2. `.planning/research/SUMMARY.md` (project-level fallback)
+
 Check for existing research and plans:
 
 **On macOS/Linux:**
 ```bash
+# Detect active milestone
+ACTIVE_MILESTONE=$(grep -oE "Milestone:\\s*v[0-9]+\\.[0-9]+" .planning/STATE.md 2>/dev/null | grep -oE "v[0-9]+\\.[0-9]+")
+
+# Check for research (milestone-specific first, then project-level)
+RESEARCH_DIR=""
+if [ -n "$ACTIVE_MILESTONE" ] && [ -f ".planning/milestones/${ACTIVE_MILESTONE}/research/SUMMARY.md" ]; then
+  RESEARCH_DIR=".planning/milestones/${ACTIVE_MILESTONE}/research"
+  echo "HAS_MILESTONE_RESEARCH: $ACTIVE_MILESTONE"
+elif [ -f .planning/research/SUMMARY.md ]; then
+  RESEARCH_DIR=".planning/research"
+  echo "HAS_PROJECT_RESEARCH"
+else
+  echo "NO_RESEARCH"
+fi
+
 # Use library to find phase directory first (searches both old and new structures)
 PHASE_DIR=$(find_phase_dir "$PHASE")
 if [ -n "$PHASE_DIR" ]; then
   ls "${PHASE_DIR}"/*-RESEARCH.md 2>/dev/null
   ls "${PHASE_DIR}"/*-PLAN.md 2>/dev/null
 fi
-ls .planning/research/SUMMARY.md 2>/dev/null
 ```
 
 **On Windows (Platform: win32):**
@@ -65,18 +83,18 @@ Use Glob tool with both structures:
 - Then search within found directory:
   - `Glob pattern: "{PHASE_DIR}/*-RESEARCH.md"`
   - `Glob pattern: "{PHASE_DIR}/*-PLAN.md"`
-- `Glob pattern: ".planning/research/SUMMARY.md"`
+- Check research (milestone first, then project):
+  - `Glob pattern: ".planning/milestones/v*/research/SUMMARY.md"`
+  - `Glob pattern: ".planning/research/SUMMARY.md"`
 
 </context>
 
 <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)
 
@@ -490,16 +508,19 @@ fi
 
 **Smart research guardrails (default behavior):**
 
-Check for project-level research:
+Check for research (milestone-specific first, then project-level):
 
 **On macOS/Linux:**
 ```bash
-ls .planning/research/SUMMARY.md 2>/dev/null
+# Detect active milestone and find research (already set in context step)
+# RESEARCH_DIR is set to milestone research or project research path
+ls "${RESEARCH_DIR}/SUMMARY.md" 2>/dev/null
 ls "${PHASE_DIR}"/*-RESEARCH.md 2>/dev/null
 ```
 
 **On Windows:**
-- `Glob pattern: ".planning/research/SUMMARY.md"`
+- `Glob pattern: ".planning/milestones/v*/research/SUMMARY.md"` (milestone first)
+- `Glob pattern: ".planning/research/SUMMARY.md"` (project fallback)
 - `Glob pattern: "${PHASE_DIR}/*-RESEARCH.md"`
 
 **Research Decision Matrix:**
@@ -508,8 +529,9 @@ ls "${PHASE_DIR}"/*-RESEARCH.md 2>/dev/null
 |-----------|--------|
 | `--research` flag set | Force research (override all) |
 | Phase-level RESEARCH.md exists | Use existing, skip to step 6 |
+| Milestone-level SUMMARY.md exists AND phase is NOT risky | Skip research, display: `Using milestone research from /rrr:new-milestone` |
 | Project-level SUMMARY.md exists AND phase is NOT risky | Skip research, display: `Using project research from /rrr:new-project` |
-| Project-level SUMMARY.md exists AND phase IS risky | Run research (risky domains need phase-specific research) |
+| Research SUMMARY.md exists AND phase IS risky | Run research (risky domains need phase-specific research) |
 | Neither research exists | Run research |
 
 **Risky domain detection:** Phase name or description contains: `auth`, `payment`, `security`, `webhook`, `oauth`, `stripe`, `bank`, `credential`, `encryption`, `api-key`.

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/package.json

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

package/scripts/prepublish-check.js

@@ -76,7 +76,6 @@ const criticalFiles = [
 // PATCH-01 critical files
 const patch01Files = [
   'rrr/lib/memory-store.js',
-  'scripts/rrr-hud.js',
   'scripts/rrr-memory/state-detector.js',
   'scripts/handoff-preflight.js'
 ];

package/scripts/test-install-smoke.js

@@ -36,7 +36,6 @@ const CRITICAL_SKILLS = [
 const PATCH01_FILES = [
   'rrr/lib/memory-store.js',
   'rrr/scripts/handoff-preflight.js',
-  'rrr/scripts/rrr-hud.js',
   'rrr/scripts/rrr-memory/state-detector.js'
 ];