projecta-rrr 1.18.1 → 1.18.3

package/CHANGELOG.md

@@ -4,6 +4,20 @@ 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.3] - 2026-01-30
+
+### Fixed
+
+- **Launchd PATH for grepai** - Added `~/.local/bin` to scheduled indexing PATH so grepai (installed via pipx) is discoverable
+
+## [1.18.2] - 2026-01-30
+
+### Fixed
+
+- **Intent gate character threshold** - Lowered minimum message length from 15 to 8 characters to catch "work on a bug" (13 chars) and similar short work requests
+- **Intent gate not installed** - Added `rrr-intent-gate.sh` hook configuration to install.js (UserPromptSubmit)
+- **Statusline shows milestone when idle** - When between milestones, show last completed milestone version instead of empty
+
 ## [1.18.1] - 2026-01-30
 
 ### Fixed

package/bin/install.js

@@ -1443,6 +1443,27 @@ function install(isGlobal) {
       });
       console.log(`  ${green}✓${reset} Configured intent classification hook (UserPromptSubmit)`);
     }
+
+    // Configure UserPromptSubmit hook for intent gate (blocking work requests without plan)
+    const intentGateCommand = isGlobal
+      ? '$HOME/.claude/hooks/rrr-intent-gate.sh'
+      : `${localDirName}/hooks/rrr-intent-gate.sh`;
+
+    const hasIntentGateHook = settings.hooks.UserPromptSubmit.some(entry =>
+      entry.hooks && entry.hooks.some(h => h.command && h.command.includes('rrr-intent-gate'))
+    );
+
+    if (!hasIntentGateHook && hookFileExists(claudeDir, 'rrr-intent-gate.sh')) {
+      settings.hooks.UserPromptSubmit.push({
+        hooks: [
+          {
+            type: 'command',
+            command: intentGateCommand
+          }
+        ]
+      });
+      console.log(`  ${green}✓${reset} Configured intent gate hook (UserPromptSubmit)`);
+    }
   }
 
   // Install Pushpa Mode and MCP setup scripts to the project directory
@@ -1671,7 +1692,9 @@ fi
     <key>EnvironmentVariables</key>
     <dict>
         <key>PATH</key>
-        <string>/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin</string>
+        <string>${os.homedir()}/.local/bin:/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin</string>
+        <key>HOME</key>
+        <string>${os.homedir()}</string>
     </dict>
 </dict>
 </plist>`;

package/hooks/proto-b-blocking.sh

@@ -0,0 +1,51 @@
+#!/usr/bin/env bash
+#
+# PROTOTYPE B: Blocking hook
+# Exits non-zero when drifting, blocking Claude until user classifies intent
+#
+
+set +e
+
+INPUT=$(cat)
+USER_MESSAGE=""
+if command -v jq &>/dev/null; then
+    USER_MESSAGE=$(echo "$INPUT" | jq -r '.user_message // .prompt // .message // empty' 2>/dev/null)
+fi
+
+# Skip short messages, commands, confirmations
+[[ -z "$USER_MESSAGE" || ${#USER_MESSAGE} -lt 20 ]] && exit 0
+[[ "$USER_MESSAGE" == /* ]] && exit 0
+
+msg_lower=$(echo "$USER_MESSAGE" | tr '[:upper:]' '[:lower:]')
+echo "$msg_lower" | grep -qE "^(ok|yes|no|sure|thanks|got it|continue|proceed|[0-9]+)$" && exit 0
+
+# Check state
+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)
+
+# If idle/no-project and substantial request, BLOCK
+if [[ "$status" == "idle" || "$status" == "no-project" || -z "$plan" || "$plan" == "null" ]]; then
+    # Check for work patterns
+    if echo "$msg_lower" | grep -qiE "(fix|add|implement|create|build|update|change|modify|bug|feature|issue)"; then
+        echo ""
+        echo "=============================================="
+        echo "BLOCKED: Work request detected without active plan"
+        echo "=============================================="
+        echo ""
+        echo "Before I can help, please classify this work:"
+        echo ""
+        echo "  1. /rrr:plan-phase  - Track as new phase"
+        echo "  2. /rrr:add-todo    - Capture for later"
+        echo "  3. Type 'adhoc'     - Continue untracked"
+        echo ""
+        echo "Current state: Phase=${phase:-none}, Plan=${plan:-none}"
+        echo "=============================================="
+        exit 1  # NON-ZERO = BLOCK
+    fi
+fi
+
+exit 0

package/hooks/proto-c-forced-question.sh

@@ -0,0 +1,50 @@
+#!/usr/bin/env bash
+#
+# PROTOTYPE C: Forced Question Injection
+# Injects a mandatory question that Claude must answer
+# Uses special marker that CLAUDE.md instructs Claude to ALWAYS respond to
+#
+
+set +e
+
+INPUT=$(cat)
+USER_MESSAGE=""
+if command -v jq &>/dev/null; then
+    USER_MESSAGE=$(echo "$INPUT" | jq -r '.user_message // .prompt // .message // empty' 2>/dev/null)
+fi
+
+# Skip short messages, commands, confirmations
+[[ -z "$USER_MESSAGE" || ${#USER_MESSAGE} -lt 20 ]] && exit 0
+[[ "$USER_MESSAGE" == /* ]] && exit 0
+
+msg_lower=$(echo "$USER_MESSAGE" | tr '[:upper:]' '[:lower:]')
+echo "$msg_lower" | grep -qE "^(ok|yes|no|sure|thanks|got it|continue|proceed|adhoc|[0-9]+)$" && exit 0
+
+# Check state
+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)
+
+# If idle/no-project and substantial request, INJECT QUESTION
+if [[ "$status" == "idle" || "$status" == "no-project" || -z "$plan" || "$plan" == "null" ]]; then
+    # Check for work patterns
+    if echo "$msg_lower" | grep -qiE "(fix|add|implement|create|build|update|change|modify|bug|feature|issue)"; then
+        echo ""
+        echo "<MANDATORY-INTENT-GATE>"
+        echo "Work request detected without active plan."
+        echo ""
+        echo "CLAUDE: You MUST use AskUserQuestion to ask:"
+        echo "  Question: 'Where should this work be tracked?'"
+        echo "  Options:"
+        echo "    - 'New phase' (run /rrr:plan-phase after)"
+        echo "    - 'Add to backlog' (run /rrr:add-todo after)"
+        echo "    - 'Quick adhoc fix' (proceed without tracking)"
+        echo ""
+        echo "DO NOT proceed with any implementation until user answers."
+        echo "</MANDATORY-INTENT-GATE>"
+    fi
+fi
+
+exit 0

package/hooks/rrr-intent-gate.sh

@@ -0,0 +1,86 @@
+#!/usr/bin/env bash
+#
+# rrr-intent-gate.sh - HYBRID Intent Gate (Blocking + Friendly)
+#
+# BLOCKING: Exits non-zero when work request detected without active plan
+# FRIENDLY: Clear message with options, not harsh error
+#
+# Bypass: User types "adhoc", "continue", or runs /rrr:plan-phase first
+#
+
+set +e
+
+INPUT=$(cat)
+USER_MESSAGE=""
+if command -v jq &>/dev/null; then
+    USER_MESSAGE=$(echo "$INPUT" | jq -r '.user_message // .prompt // .message // empty' 2>/dev/null)
+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 slash commands (already intentional)
+[[ "$USER_MESSAGE" == /* ]] && exit 0
+
+msg_lower=$(echo "$USER_MESSAGE" | tr '[:upper:]' '[:lower:]')
+
+# Skip explicit bypass words
+echo "$msg_lower" | grep -qE "^(adhoc|ad-hoc|ad hoc|untracked|skip tracking)$" && exit 0
+
+# Skip confirmations and short responses
+echo "$msg_lower" | grep -qE "^(ok|okay|yes|no|y|n|sure|thanks|thank you|got it|understood|continue|proceed|go ahead|do it|[0-9]+)$" && exit 0
+
+# Skip questions (user is asking, not requesting work)
+echo "$msg_lower" | grep -qE "^(what|why|how|where|when|which|can you explain|explain|show me|tell me)" && exit 0
+echo "$msg_lower" | grep -qE "\?$" && exit 0
+
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# CHECK STATE - Only gate if no active plan
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+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)
+
+# If we have an active plan, let through
+[[ -n "$plan" && "$plan" != "null" ]] && exit 0
+
+# If status is active (working on something), let through
+[[ "$status" == "active" ]] && exit 0
+
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# DETECT WORK REQUESTS - Only gate substantial work
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+work_patterns="(fix|bug|issue|add|implement|create|build|update|change|modify|refactor|feature|integrate|setup|set up|migrate|develop|design|write|make)"
+
+if echo "$msg_lower" | grep -qiE "$work_patterns"; then
+    # This looks like a work request without an active plan - GATE IT
+    echo ""
+    echo "<MANDATORY-INTENT-GATE>"
+    echo ""
+    echo "I detected a work request but you have no active plan."
+    echo ""
+    echo "  Current: ${milestone:-no milestone} / ${phase:-no phase} / ${plan:-no plan}"
+    echo "  Status:  ${status:-unknown}"
+    echo ""
+    echo "Before I proceed, where should this work go?"
+    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 ""
+    echo "</MANDATORY-INTENT-GATE>"
+    exit 1  # BLOCK until user classifies
+fi
+
+# Not a work request - let through
+exit 0

package/hooks/statusline.sh

@@ -120,6 +120,16 @@ if [[ -f "$HUD_FILE" ]]; then
                 location="${location} (${plans_completed}/${plans_in_phase})"
             fi
         fi
+    elif [[ "$status" == "idle" ]]; then
+        # Between milestones - show ready state with milestone count if available
+        if [[ -n "$milestone" && "$milestone" != "null" ]]; then
+            location="${milestone}:done"
+        else
+            location="RRR:ready"
+        fi
+    elif [[ "$status" == "no-project" ]]; then
+        # Not in an RRR project - show minimal indicator
+        location=""
     fi
 
     # ────────────────────────────────────────────────────────
@@ -134,14 +144,19 @@ if [[ -f "$HUD_FILE" ]]; then
         drift_reason="off-topic"
     fi
 
-    # Condition 2: No active plan (ad-hoc coding)
-    if [[ (-z "$plan" || "$plan" == "null") && (-z "$phase" || "$phase" == "null") ]]; then
-        is_drifting=true
-        drift_reason="no plan"
+    # Condition 2: No active plan (ad-hoc coding) - only if we HAVE a milestone
+    # If milestone is null/empty, we're either not in RRR project or between milestones (valid states)
+    # If status is "idle" or "no-project", drift doesn't apply
+    if [[ "$status" != "idle" && "$status" != "no-project" && -n "$milestone" && "$milestone" != "null" ]]; then
+        if [[ (-z "$plan" || "$plan" == "null") && (-z "$phase" || "$phase" == "null") ]]; then
+            is_drifting=true
+            drift_reason="no plan"
+        fi
     fi
 
-    # Condition 3: Code changed outside plan scope
-    if [[ "$drift_detected" == "true" && "$drift_files" -gt 0 ]]; then
+    # Condition 3: Code changed outside plan scope (only if actively working on a milestone)
+    # When idle/between milestones or not in a project, changed files aren't "drift"
+    if [[ "$status" != "idle" && "$status" != "no-project" && "$drift_detected" == "true" && "$drift_files" -gt 0 ]]; then
         is_drifting=true
         drift_reason="${drift_files} files"
     fi

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projecta-rrr",
-  "version": "1.18.1",
+  "version": "1.18.3",
   "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/rrr-hud-dynamic.js

@@ -16,18 +16,31 @@ const { execSync } = require('child_process');
 const CLAUDE_DIR = path.join(process.env.HOME, '.claude');
 const STATE_FILE = path.join(CLAUDE_DIR, 'rrr', 'hud-state.json');
 
-// RRR project paths - look in cwd first, then home
+// RRR project paths - traverse up from cwd to find .planning, then check home
 function getPlanningDir() {
-  const cwdPlanning = path.join(process.cwd(), '.planning');
-  const homePlanning = path.join(process.env.HOME, '.planning');
-
-  if (fs.existsSync(cwdPlanning)) {
-    return cwdPlanning;
+  // First, traverse upward from cwd to find .planning (up to 5 levels)
+  let dir = process.cwd();
+  const root = path.parse(dir).root;
+  let depth = 0;
+  const maxDepth = 5;
+
+  while (depth < maxDepth && dir !== root) {
+    const planningDir = path.join(dir, '.planning');
+    if (fs.existsSync(planningDir)) {
+      return planningDir;
+    }
+    dir = path.dirname(dir);
+    depth++;
   }
+
+  // Fallback to home directory
+  const homePlanning = path.join(process.env.HOME, '.planning');
   if (fs.existsSync(homePlanning)) {
     return homePlanning;
   }
-  return cwdPlanning; // Return cwd even if not exists
+
+  // Return cwd even if not exists (for error handling downstream)
+  return path.join(process.cwd(), '.planning');
 }
 
 function getActiveMilestone() {
@@ -380,18 +393,21 @@ function syncState() {
       state.progress_percent = totalTasks > 0 ? Math.round((totalCompleted / totalTasks) * 100) : 0;
     }
 
-    // Update status based on project state
-    const stalePlans = getStalePlans();
-    if (stalePlans.length > 0) {
-      state.status = 'drifting';
-      state.drift.detected = true;
-      state.drift.files_changed = stalePlans.length;
-      state.drift.details = stalePlans.map(p => `${p.planId} (${p.age}h old)`);
-    } else {
-      state.status = 'active';
-      state.drift.detected = false;
-      state.drift.files_changed = 0;
-      state.drift.details = [];
+    // Update status based on project state (only if we have an active milestone)
+    // If between milestones, keep the 'idle' status set above
+    if (milestone) {
+      const stalePlans = getStalePlans();
+      if (stalePlans.length > 0) {
+        state.status = 'drifting';
+        state.drift.detected = true;
+        state.drift.files_changed = stalePlans.length;
+        state.drift.details = stalePlans.map(p => `${p.planId} (${p.age}h old)`);
+      } else {
+        state.status = 'active';
+        state.drift.detected = false;
+        state.drift.files_changed = 0;
+        state.drift.details = [];
+      }
     }
 
     // Update scope
@@ -417,6 +433,19 @@ function syncState() {
     if (!state.session_start) {
       state.session_start = new Date().toISOString();
     }
+  } else {
+    // Not in an RRR project - clear project-specific state
+    state.milestone = null;
+    state.phase = null;
+    state.plan = null;
+    state.tasks_completed = 0;
+    state.tasks_total = 0;
+    state.progress_percent = 0;
+    state.status = 'no-project';
+    state.drift.detected = false;
+    state.drift.files_changed = 0;
+    state.drift.details = [];
+    state.scope = { files: 0, phases: 0, plans: 0, milestones: 0, last_scan: null, cache_hit_rate: 0 };
   }
 
   writeState(state);