projecta-rrr 1.18.0 → 1.18.1

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.1] - 2026-01-30
+
+### Fixed
+
+- **Drift detection now updates HUD state** - PostToolUse hook was writing to `.planning/.drift-status.json` but statusline reads from `~/.claude/rrr/hud-state.json`. Now updates both.
+- **Cache stats hook missing from SessionStart** - Added `rrr-update-cache-stats.sh` to SessionStart hooks for IDX % refresh
+- **IDX showing file count instead of hit rate** - Changed to show cache hit rate percentage
+- **Index path detection** - Fixed to find LanceDB at actual location (`~/.claude/rrr/lib/search/.rrr/search/lancedb/`)
+
+### Added
+
+- **Scheduled indexing** (macOS) - Launchd agent runs semantic + session indexing every 4 hours
+- **Test results capture hook** - `rrr-capture-test-results.sh` updates HUD with test pass rate after `npm test`
+
 ## [1.18.0] - 2026-01-30
 
 ### Added

package/bin/install.js

@@ -1359,6 +1359,27 @@ function install(isGlobal) {
       });
       console.log(`  ${green}✓${reset} Configured HUD state sync hook`);
     }
+
+    // Add cache stats update hook (updates IDX % in statusline)
+    const cacheStatsCommand = isGlobal
+      ? '$HOME/.claude/hooks/rrr-update-cache-stats.sh'
+      : `${localDirName}/hooks/rrr-update-cache-stats.sh`;
+
+    const hasCacheStatsHook = settings.hooks.SessionStart.some(entry =>
+      entry.hooks && entry.hooks.some(h => h.command && h.command.includes('rrr-update-cache-stats'))
+    );
+
+    if (!hasCacheStatsHook && hookFileExists(claudeDir, 'rrr-update-cache-stats.sh')) {
+      settings.hooks.SessionStart.push({
+        hooks: [
+          {
+            type: 'command',
+            command: cacheStatsCommand
+          }
+        ]
+      });
+      console.log(`  ${green}✓${reset} Configured cache stats hook`);
+    }
   }
 
   // PATCH-01: Configure PostToolUse hook for drift detection
@@ -1590,6 +1611,86 @@ function install(isGlobal) {
 /**
  * Print doctor summary showing where hooks were installed and configured paths
  */
+/**
+ * Setup scheduled indexing via macOS launchd
+ * Runs semantic index and session indexing every 4 hours
+ */
+function setupScheduledIndexing() {
+  const launchAgentsDir = path.join(os.homedir(), 'Library', 'LaunchAgents');
+  const plistPath = path.join(launchAgentsDir, 'com.projecta.rrr-index.plist');
+
+  // Only setup if not already configured
+  if (fs.existsSync(plistPath)) {
+    return;
+  }
+
+  try {
+    // Ensure LaunchAgents directory exists
+    if (!fs.existsSync(launchAgentsDir)) {
+      fs.mkdirSync(launchAgentsDir, { recursive: true });
+    }
+
+    const plistContent = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>com.projecta.rrr-index</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>/bin/bash</string>
+        <string>-c</string>
+        <string>
+# Run semantic index if grepai available
+if command -v grepai &amp;>/dev/null; then
+    grepai index --quiet 2>/dev/null
+fi
+
+# Run session indexing (Datasphere)
+INSTALLED_RRR=$(npm root -g 2>/dev/null)/projecta-rrr
+if [[ -f "$INSTALLED_RRR/scripts/index-sessions.sh" ]]; then
+    bash "$INSTALLED_RRR/scripts/index-sessions.sh" --all --quiet 2>/dev/null
+fi
+
+# Update cache stats for HUD
+~/.claude/hooks/rrr-update-cache-stats.sh 2>/dev/null
+        </string>
+    </array>
+    <key>StartInterval</key>
+    <integer>14400</integer>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>StandardOutPath</key>
+    <string>/tmp/rrr-index.log</string>
+    <key>StandardErrorPath</key>
+    <string>/tmp/rrr-index.err</string>
+    <key>LowPriorityIO</key>
+    <true/>
+    <key>ProcessType</key>
+    <string>Background</string>
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>PATH</key>
+        <string>/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin</string>
+    </dict>
+</dict>
+</plist>`;
+
+    fs.writeFileSync(plistPath, plistContent);
+
+    // Load the agent
+    const { execSync } = require('child_process');
+    try {
+      execSync(`launchctl load "${plistPath}"`, { stdio: 'pipe' });
+      console.log(`  ${green}✓${reset} Configured scheduled indexing (every 4 hours)`);
+    } catch (e) {
+      // Agent might already be loaded
+    }
+  } catch (e) {
+    // Silent fail - scheduled indexing is optional
+  }
+}
+
 function printDoctorSummary(claudeDir, settings, localDirName, isGlobal) {
   console.log(`\n  ${cyan}Hook Configuration Summary:${reset}`);
 
@@ -1727,6 +1828,11 @@ function finishInstall(settingsPath, settings, statuslineCommand, notifyCommand,
     }
   }
 
+  // Setup scheduled indexing (macOS launchd) - runs every 4 hours
+  if (process.platform === 'darwin' && isGlobal) {
+    setupScheduledIndexing();
+  }
+
   console.log(`
   ${green}Done!${reset}
 

package/hooks/rrr-capture-test-results.sh

@@ -0,0 +1,44 @@
+#!/usr/bin/env bash
+#
+# rrr-capture-test-results.sh - Capture test results and update HUD
+#
+# Usage: npm test 2>&1 | tee /tmp/test-output.txt; rrr-capture-test-results.sh
+#
+
+set +e
+
+HUD_FILE="$HOME/.claude/rrr/hud-state.json"
+TEST_OUTPUT="${1:-/tmp/test-output.txt}"
+
+if [[ ! -f "$TEST_OUTPUT" ]]; then
+    exit 0
+fi
+
+# Parse Jest output
+if grep -q "Tests:" "$TEST_OUTPUT"; then
+    # Jest format: Tests: X failed, Y passed, Z total
+    passed=$(grep "Tests:" "$TEST_OUTPUT" | grep -oE '[0-9]+ passed' | grep -oE '[0-9]+' || echo "0")
+    failed=$(grep "Tests:" "$TEST_OUTPUT" | grep -oE '[0-9]+ failed' | grep -oE '[0-9]+' || echo "0")
+    total=$((passed + failed))
+    
+    if [[ "$total" -gt 0 ]]; then
+        pass_rate=$((passed * 100 / total))
+        
+        # Update HUD state
+        if [[ -f "$HUD_FILE" ]] && command -v jq &>/dev/null; then
+            jq --argjson passed "$passed" \
+               --argjson failed "$failed" \
+               --argjson total "$total" \
+               --argjson rate "$pass_rate" '
+                .tests.passed = $passed |
+                .tests.failed = $failed |
+                .tests.total = $total |
+                .tests.pass_rate = $rate
+            ' "$HUD_FILE" > "${HUD_FILE}.tmp" && mv "${HUD_FILE}.tmp" "$HUD_FILE"
+            
+            echo "Updated HUD: ${passed}/${total} tests passed (${pass_rate}%)"
+        fi
+    fi
+fi
+
+exit 0

package/hooks/rrr-detect-drift.sh

@@ -116,6 +116,21 @@ if [ -n "$DRIFT_RESULT" ]; then
     echo "$DRIFT_RESULT" > "$DRIFT_STATUS_FILE" 2>/dev/null
 fi
 
+# Update HUD state with drift info (so statusline can read it)
+HUD_STATE_FILE="${CLAUDE_DIR}/rrr/hud-state.json"
+if [ -f "$HUD_STATE_FILE" ] && command -v jq &>/dev/null; then
+    # Count changed files
+    FILE_COUNT=$(echo "$FILES" | tr ',' '\n' | wc -l | tr -d ' ')
+
+    # Update drift section in hud-state.json
+    jq --argjson count "$FILE_COUNT" --arg files "$FILES" '
+        .drift.detected = ($count > 0) |
+        .drift.files_changed = $count |
+        .drift.details = (if $files != "" then ($files | split(",")[0:5]) else [] end) |
+        .status = (if $count > 5 then "drifting" else .status end)
+    ' "$HUD_STATE_FILE" > "${HUD_STATE_FILE}.tmp" && mv "${HUD_STATE_FILE}.tmp" "$HUD_STATE_FILE"
+fi
+
 # ============================================================================
 # Episode Emission
 # ============================================================================

package/hooks/rrr-update-cache-stats.sh

@@ -21,11 +21,16 @@ if [[ -f "$MCP_SERVER" ]]; then
 const path = require('path');
 const fs = require('fs');
 
-// Find the index database
-const indexDir = path.join(process.env.HOME, '.claude', 'rrr', '.semantic-index');
-const dbPath = path.join(indexDir, 'rrr-search.lance');
+// Find the index database (check multiple locations)
+const possiblePaths = [
+    path.join(process.env.HOME, '.claude', 'rrr', 'lib', 'search', '.rrr', 'search', 'lancedb', 'file_index.lance'),
+    path.join(process.env.HOME, '.claude', 'rrr', '.semantic-index', 'rrr-search.lance'),
+    path.join(process.env.HOME, '.grepai', 'index.lance')
+];
+const dbPath = possiblePaths.find(p => fs.existsSync(p));
+const indexDir = dbPath ? path.dirname(dbPath) : null;
 
-if (!fs.existsSync(dbPath)) {
+if (!dbPath || !indexDir) {
     // No index yet
     console.log(JSON.stringify({
         fileCount: 0,
@@ -47,11 +52,27 @@ const lastUpdated = stats.mtime.toISOString();
 let fileCount = 0;
 let chunkCount = 0;
 try {
-    const manifestPath = path.join(indexDir, 'manifest.json');
-    if (fs.existsSync(manifestPath)) {
-        const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
-        fileCount = manifest.files ? Object.keys(manifest.files).length : 0;
-        chunkCount = manifest.totalChunks || fileCount * 5; // estimate
+    // Try manifest.json in various locations
+    const manifestPaths = [
+        path.join(indexDir, 'manifest.json'),
+        path.join(indexDir, '..', 'manifest.json'),
+        path.join(indexDir, '..', '..', 'manifest.json')
+    ];
+    for (const manifestPath of manifestPaths) {
+        if (fs.existsSync(manifestPath)) {
+            const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+            fileCount = manifest.files ? Object.keys(manifest.files).length : 0;
+            chunkCount = manifest.totalChunks || fileCount * 5;
+            break;
+        }
+    }
+    // Fallback: count .lance data files
+    if (fileCount === 0) {
+        const dataDir = path.join(dbPath, 'data');
+        if (fs.existsSync(dataDir)) {
+            fileCount = fs.readdirSync(dataDir).filter(f => f.endsWith('.lance')).length * 100; // estimate
+            chunkCount = fileCount * 5;
+        }
     }
 } catch (e) {}
 

package/hooks/statusline.sh

@@ -82,27 +82,18 @@ if [[ -f "$HUD_FILE" ]]; then
         fi
     fi
 
-    # Show index health: [IDX 2.2k OK] (ASCII only for Claude Code compatibility)
-    file_count=$(jq -r '.fileCount // 0' "$CACHE_FILE" 2>/dev/null)
+    # Show index health as hit rate percentage (ASCII only for Claude Code compatibility)
     healthy=$(jq -r '.healthy // false' "$CACHE_FILE" 2>/dev/null)
 
-    if [[ "$file_count" -gt 0 ]]; then
-        # Format file count nicely (2207 -> 2.2k)
-        if [[ "$file_count" -gt 1000 ]]; then
-            file_display=$(echo "scale=1; $file_count / 1000" | bc 2>/dev/null || echo "$file_count")
-            file_display="${file_display}k"
-        else
-            file_display="$file_count"
-        fi
-
-        # Show health indicator (ASCII)
+    if [[ "$cache_rate" -gt 0 ]]; then
+        # Show hit rate percentage
         if [[ "$healthy" == "true" ]]; then
-            brain="IDX:${file_display}"
+            brain="IDX:${cache_rate}%"
         else
-            brain="IDX:${file_display}!"
+            brain="IDX:${cache_rate}%!"
         fi
     else
-        brain="IDX:--"
+        brain="IDX:--%"
     fi
 
     # ────────────────────────────────────────────────────────

package/package.json

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