hail-hydra-cc 2.3.2 → 2.4.1

package/files/commands/hydra/status.md

@@ -1,85 +1,85 @@
----
-description: Show Hydra framework status — installed agents, version, config, and update availability
-allowed-tools: Bash, Read, Glob
----
-
-# Hydra Status
-
-Show a comprehensive status report for the Hydra framework.
-
-## 1. Version Info
-```bash
-INSTALLED=$(cat ~/.claude/skills/hydra/VERSION 2>/dev/null || echo "unknown")
-echo "Installed: $INSTALLED"
-LATEST=$(npm view hail-hydra-cc version 2>/dev/null || echo "unknown")
-echo "Latest: $LATEST"
-```
-
-## 2. Installed Agents
-```bash
-echo "=== Global Agents ==="
-ls -1 ~/.claude/agents/hydra-*.md 2>/dev/null || echo "None found"
-echo "=== Local Agents ==="
-ls -1 .claude/agents/hydra-*.md 2>/dev/null || echo "None found"
-```
-
-## 3. Installed Commands
-```bash
-echo "=== Global Commands ==="
-ls -1 ~/.claude/commands/hydra/*.md 2>/dev/null || echo "None found"
-echo "=== Local Commands ==="
-ls -1 .claude/commands/hydra/*.md 2>/dev/null || echo "None found"
-```
-
-## 4. Hooks
-```bash
-ls -1 ~/.claude/hooks/hydra-*.js 2>/dev/null || echo "None found"
-```
-
-## 5. Configuration
-```bash
-cat ~/.claude/skills/hydra/config/hydra.config.md 2>/dev/null || \
-cat .claude/skills/hydra/config/hydra.config.md 2>/dev/null || \
-echo "No config file found (using defaults)"
-```
-
-## 6. Codebase Map
-```bash
-if [ -f ".claude/hydra/codebase-map.json" ]; then
-  echo "Map: ✅ Exists"
-  node -e "const m=JSON.parse(require('fs').readFileSync('.claude/hydra/codebase-map.json','utf8'));console.log('Files:',m._meta.file_count);console.log('Built:',m._meta.built_at);console.log('Hash:',m._meta.git_hash);"
-else
-  echo "Map: ❌ Not built yet (run /hydra:map rebuild)"
-fi
-```
-
-## Display Format
-
-Present results as a clean status card:
-
-```
-🐉 Hydra Framework Status
-──────────────────────────────
-Version:     1.0.0 (latest: 1.0.0 ✅)  OR  (update available: 1.1.0 ⚡)
-Install:     Global (~/.claude/)
-Agents (7):
-  🟢 hydra-scout    (Haiku 4.5)   ✅
-  🟢 hydra-runner   (Haiku 4.5)   ✅
-  🟢 hydra-scribe   (Haiku 4.5)   ✅
-  🟢 hydra-guard    (Haiku 4.5)   ✅
-  🟢 hydra-git      (Haiku 4.5)   ✅
-  🔵 hydra-coder    (Sonnet 4.6)  ✅
-  🔵 hydra-analyst  (Sonnet 4.6)  ✅
-Commands (12): update, status, help, config, guard, quiet, verbose, report, map, preflight, stats, stfu
-Hooks (4):    check-update ✅, statusline ✅, auto-guard ✅, notify ✅
-Map:          ✅ Current (487 files, built 2026-03-26)
-Config:       balanced mode, dispatch log on, auto-guard on
-──────────────────────────────
-```
-
-If an update is available, add:
-```
-⚡ Update available! Run /hydra:update to get the latest version.
-```
-
-For detailed token usage and savings, run: `/hydra:stats`
+---
+description: Show Hydra framework status — installed agents, version, config, and update availability
+allowed-tools: Bash, Read, Glob
+---
+
+# Hydra Status
+
+Show a comprehensive status report for the Hydra framework.
+
+## 1. Version Info
+```bash
+INSTALLED=$(cat ~/.claude/skills/hydra/VERSION 2>/dev/null || echo "unknown")
+echo "Installed: $INSTALLED"
+LATEST=$(npm view hail-hydra-cc version 2>/dev/null || echo "unknown")
+echo "Latest: $LATEST"
+```
+
+## 2. Installed Agents
+```bash
+echo "=== Global Agents ==="
+ls -1 ~/.claude/agents/hydra-*.md 2>/dev/null || echo "None found"
+echo "=== Local Agents ==="
+ls -1 .claude/agents/hydra-*.md 2>/dev/null || echo "None found"
+```
+
+## 3. Installed Commands
+```bash
+echo "=== Global Commands ==="
+ls -1 ~/.claude/commands/hydra/*.md 2>/dev/null || echo "None found"
+echo "=== Local Commands ==="
+ls -1 .claude/commands/hydra/*.md 2>/dev/null || echo "None found"
+```
+
+## 4. Hooks
+```bash
+ls -1 ~/.claude/hooks/hydra-*.js 2>/dev/null || echo "None found"
+```
+
+## 5. Configuration
+```bash
+cat ~/.claude/skills/hydra/config/hydra.config.md 2>/dev/null || \
+cat .claude/skills/hydra/config/hydra.config.md 2>/dev/null || \
+echo "No config file found (using defaults)"
+```
+
+## 6. Codebase Map
+```bash
+if [ -f ".claude/hydra/codebase-map.json" ]; then
+  echo "Map: ✅ Exists"
+  node -e "const m=JSON.parse(require('fs').readFileSync('.claude/hydra/codebase-map.json','utf8'));console.log('Files:',m._meta.file_count);console.log('Built:',m._meta.built_at);console.log('Hash:',m._meta.git_hash);"
+else
+  echo "Map: ❌ Not built yet (run /hydra:map rebuild)"
+fi
+```
+
+## Display Format
+
+Present results as a clean status card:
+
+```
+🐉 Hydra Framework Status
+──────────────────────────────
+Version:     1.0.0 (latest: 1.0.0 ✅)  OR  (update available: 1.1.0 ⚡)
+Install:     Global (~/.claude/)
+Agents (7):
+  🟢 hydra-scout    (Haiku 4.5)   ✅
+  🟢 hydra-runner   (Haiku 4.5)   ✅
+  🟢 hydra-scribe   (Haiku 4.5)   ✅
+  🟢 hydra-guard    (Haiku 4.5)   ✅
+  🟢 hydra-git      (Haiku 4.5)   ✅
+  🔵 hydra-coder    (Sonnet 4.6)  ✅
+  🔵 hydra-analyst  (Sonnet 4.6)  ✅
+Commands (12): update, status, help, config, guard, quiet, verbose, report, map, preflight, stats, stfu
+Hooks (4):    check-update ✅, statusline ✅, auto-guard ✅, notify ✅
+Map:          ✅ Current (487 files, built 2026-03-26)
+Config:       balanced mode, dispatch log on, auto-guard on
+──────────────────────────────
+```
+
+If an update is available, add:
+```
+⚡ Update available! Run /hydra:update to get the latest version.
+```
+
+For detailed token usage and savings, run: `/hydra:stats`

package/files/commands/hydra/verbose.md

@@ -1,29 +1,29 @@
----
-description: Enable verbose Hydra dispatch logs with timing and token estimates
----
-
-# Hydra Verbose Mode
-
-Acknowledge this command and remember for the rest of this session:
-
-**Display DETAILED Hydra Dispatch Logs after every task that involves delegation.**
-
-The verbose log includes extra columns for timing:
-
-```
-🐉 Hydra Dispatch Log (verbose)
-| Step | Agent               | Task                  | Time  | Verdict     |
-|------|---------------------|-----------------------|-------|-------------|
-| 1    | hydra-scout (Haiku 4.5)  | Explored auth module | 3.2s  | ✅ Accepted |
-| 2    | hydra-coder (Sonnet 4.6) | Fixed null check     | 8.1s  | ✅ Accepted |
-| 3    | hydra-guard (Haiku 4.5)  | Security scan        | 1.4s  | ✅ Passed   |
-| 4    | hydra-runner (Haiku 4.5) | Ran test suite       | 4.7s  | ✅ Accepted |
-
-Delegation: 4/4 (100%) | Accepted: 4 | Adjusted: 0 | Rejected: 0
-Total delegation time: 17.4s | Waves: 2
-```
-
-Respond with:
-"🐉 Verbose mode enabled. Dispatch logs will include timing details. Use /hydra:quiet to suppress."
-
-Re-enable the task completion notification sound.
+---
+description: Enable verbose Hydra dispatch logs with timing and token estimates
+---
+
+# Hydra Verbose Mode
+
+Acknowledge this command and remember for the rest of this session:
+
+**Display DETAILED Hydra Dispatch Logs after every task that involves delegation.**
+
+The verbose log includes extra columns for timing:
+
+```
+🐉 Hydra Dispatch Log (verbose)
+| Step | Agent               | Task                  | Time  | Verdict     |
+|------|---------------------|-----------------------|-------|-------------|
+| 1    | hydra-scout (Haiku 4.5)  | Explored auth module | 3.2s  | ✅ Accepted |
+| 2    | hydra-coder (Sonnet 4.6) | Fixed null check     | 8.1s  | ✅ Accepted |
+| 3    | hydra-guard (Haiku 4.5)  | Security scan        | 1.4s  | ✅ Passed   |
+| 4    | hydra-runner (Haiku 4.5) | Ran test suite       | 4.7s  | ✅ Accepted |
+
+Delegation: 4/4 (100%) | Accepted: 4 | Adjusted: 0 | Rejected: 0
+Total delegation time: 17.4s | Waves: 2
+```
+
+Respond with:
+"🐉 Verbose mode enabled. Dispatch logs will include timing details. Use /hydra:quiet to suppress."
+
+Re-enable the task completion notification sound.

package/files/hooks/hydra-auto-guard.js

@@ -1,54 +1,130 @@
-#!/usr/bin/env node
-
-// Hydra Auto-Guard Hook — PostToolUse (matcher: Write|Edit|MultiEdit)
-// Records changed file paths to a temp file for hydra-guard to scan later.
-// Does NOT run the scan itself — that would slow down every edit.
-// Overhead: <1ms per edit. Files deduped by path.
-
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-
-let input = '';
-process.stdin.on('data', (chunk) => (input += chunk));
-process.stdin.on('end', () => {
-  try {
-    const data = JSON.parse(input);
-
-    // Extract the file path from the tool input
-    const filePath = data.tool_input?.file_path ||
-                     data.tool_input?.path ||
-                     null;
-
-    if (!filePath) {
-      process.exit(0);
-    }
-
-    // Append to session-scoped changed files list
-    const sessionId = data.session_id || 'unknown';
-    const trackingDir = path.join(os.tmpdir(), 'hydra-guard');
-    const trackingFile = path.join(trackingDir, `${sessionId}.txt`);
-
-    // Ensure directory exists
-    if (!fs.existsSync(trackingDir)) {
-      fs.mkdirSync(trackingDir, { recursive: true });
-    }
-
-    // Read existing tracked files
-    let existing = '';
-    try {
-      existing = fs.readFileSync(trackingFile, 'utf8');
-    } catch (e) {
-      // File doesn't exist yet — that's fine
-    }
-
-    // Only append if not already tracked (dedup)
-    if (!existing.split('\n').includes(filePath)) {
-      fs.appendFileSync(trackingFile, filePath + '\n');
-    }
-
-  } catch (e) {
-    // Silently fail — NEVER block Claude Code
-  }
-  process.exit(0);
-});
+#!/usr/bin/env node
+
+// Hydra Auto-Guard Hook — PostToolUse (matcher: Write|Edit|MultiEdit)
+// Records changed file paths to a temp file for hydra-guard to scan later.
+// Does NOT run the scan itself — that would slow down every edit.
+// Overhead: <1ms per edit. Files deduped by path.
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+let input = '';
+process.stdin.on('data', (chunk) => (input += chunk));
+process.stdin.on('end', () => {
+  try {
+    const data = JSON.parse(input);
+
+    // Extract the file path from the tool input
+    const filePath = data.tool_input?.file_path ||
+                     data.tool_input?.path ||
+                     null;
+
+    if (!filePath) {
+      process.exit(0);
+    }
+
+    // Append to session-scoped changed files list
+    const sessionId = data.session_id || 'unknown';
+    const trackingDir = path.join(os.tmpdir(), 'hydra-guard');
+    const trackingFile = path.join(trackingDir, `${sessionId}.txt`);
+
+    // Ensure directory exists
+    if (!fs.existsSync(trackingDir)) {
+      fs.mkdirSync(trackingDir, { recursive: true });
+    }
+
+    // Read existing tracked files
+    let existing = '';
+    try {
+      existing = fs.readFileSync(trackingFile, 'utf8');
+    } catch (e) {
+      // File doesn't exist yet — that's fine
+    }
+
+    // Only append if not already tracked (dedup)
+    if (!existing.split('\n').includes(filePath)) {
+      fs.appendFileSync(trackingFile, filePath + '\n');
+    }
+
+    // === Sentinel Pending Flag ===
+    // Write a flag file that the statusline hook reads.
+    // This shows "⚠ Sentinel pending" in the status bar until cleared.
+    const sentinelDir = path.join(os.tmpdir(), 'hydra-sentinel');
+    const sentinelFlag = path.join(sentinelDir, `${sessionId}-pending.json`);
+
+    if (!fs.existsSync(sentinelDir)) {
+      fs.mkdirSync(sentinelDir, { recursive: true });
+    }
+
+    // Read existing pending data or create new
+    let pending = { files: [], created_at: Date.now() };
+    try {
+      pending = JSON.parse(fs.readFileSync(sentinelFlag, 'utf8'));
+    } catch (e) {
+      // New flag
+    }
+
+    // Add file to pending list (dedup)
+    if (!pending.files.includes(filePath)) {
+      pending.files.push(filePath);
+    }
+    pending.updated_at = Date.now();
+
+    fs.writeFileSync(sentinelFlag, JSON.stringify(pending));
+
+    // New edit invalidates any prior "clean" marker
+    try {
+      const scanMarker = path.join(sentinelDir, `${sessionId}-last-scan`);
+      if (fs.existsSync(scanMarker)) fs.unlinkSync(scanMarker);
+    } catch (_) { /* silent — never block */ }
+
+    // === Substantial-Edit Detection + Directive Injection (v2.4.0+) ===
+    // For Write, MultiEdit, or large Edits, inject a directive recommending
+    // hydra-sentinel-scan dispatch. Trivial edits stay silent.
+    const toolName = data.tool_name || '';
+    const isWrite = toolName === 'Write';
+    const isMultiEdit = toolName === 'MultiEdit';
+    const oldString = data.tool_input?.old_string || '';
+    const newString = data.tool_input?.new_string || '';
+
+    let isSubstantial = isWrite || isMultiEdit;
+    if (!isSubstantial) {
+      const oldLines = (oldString.match(/\n/g) || []).length;
+      const newLines = (newString.match(/\n/g) || []).length;
+      isSubstantial = oldLines > 5 || newLines > 5 ||
+                      oldString.length > 200 || newString.length > 200;
+    }
+
+    if (isSubstantial) {
+      // Best-effort codebase map risk lookup
+      let riskNote = '';
+      try {
+        const mapPath = path.join(process.cwd(), '.claude', 'hydra', 'codebase-map.json');
+        if (fs.existsSync(mapPath)) {
+          const map = JSON.parse(fs.readFileSync(mapPath, 'utf8'));
+          const relPath = path.relative(process.cwd(), filePath).split(path.sep).join('/');
+          const fileEntry = map.files && map.files[relPath];
+          if (fileEntry && fileEntry.risk) {
+            riskNote = ` Risk: ${fileEntry.risk} (${fileEntry.dependents_count || 0} dependents).`;
+          }
+        }
+      } catch (e) {
+        // Map missing or malformed — no risk note appended
+      }
+
+      const directive = {
+        hookSpecificOutput: {
+          hookEventName: 'PostToolUse',
+          additionalContext: `🐉 Hydra Auto-Guard: Substantial change to ${path.basename(filePath)}.${riskNote} Dispatch hydra-sentinel-scan to verify integration before presenting results to the user.`
+        }
+      };
+
+      process.stdout.write(JSON.stringify(directive));
+    }
+
+  } catch (e) {
+    // Silently fail — NEVER block Claude Code
+  }
+  process.exit(0);
+});

package/files/hooks/hydra-check-update.js

@@ -1,99 +1,99 @@
-#!/usr/bin/env node
-
-// Hydra Update Checker — SessionStart hook
-// Spawns a DETACHED background process to check npm for updates.
-// Writes result to ~/.claude/cache/hydra-update-check.json
-// The statusline hook reads this cache file.
-
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-const { spawn } = require('child_process');
-
-const homeDir = os.homedir();
-const cacheDir = path.join(homeDir, '.claude', 'cache');
-const cacheFile = path.join(cacheDir, 'hydra-update-check.json');
-
-// VERSION file locations (check project first, then global)
-const projectVersionFile = path.join(process.cwd(), '.claude', 'hydra', 'VERSION');
-const globalVersionFile = path.join(homeDir, '.claude', 'hydra', 'VERSION');
-
-// Ensure cache directory exists
-if (!fs.existsSync(cacheDir)) {
-  fs.mkdirSync(cacheDir, { recursive: true });
-}
-
-// Skip check if we checked within the last hour
-try {
-  const existing = JSON.parse(fs.readFileSync(cacheFile, 'utf8'));
-  const age = Date.now() - (existing.checked_at || 0);
-  if (age < 3600000) { // 1 hour
-    process.exit(0);
-  }
-} catch (e) {
-  // No cache or invalid — proceed with check
-}
-
-// Read stdin to prevent EPIPE (Claude Code pipes JSON to all hooks)
-let stdinData = '';
-process.stdin.on('data', (chunk) => (stdinData += chunk));
-process.stdin.on('end', () => {
-  // Spawn background process (MUST be detached to not block Claude Code)
-  const child = spawn(process.execPath, ['-e', `
-    const fs = require('fs');
-    const { execSync } = require('child_process');
-
-    const cacheFile = ${JSON.stringify(cacheFile)};
-    const projectVersionFile = ${JSON.stringify(projectVersionFile)};
-    const globalVersionFile = ${JSON.stringify(globalVersionFile)};
-
-    try {
-      // Read installed version
-      let installed = 'unknown';
-      try {
-        installed = fs.readFileSync(projectVersionFile, 'utf8').trim();
-      } catch (e) {
-        try {
-          installed = fs.readFileSync(globalVersionFile, 'utf8').trim();
-        } catch (e2) {}
-      }
-
-      // Fetch latest version from npm (with timeout)
-      const latest = execSync('npm view hail-hydra-cc version', {
-        encoding: 'utf8',
-        timeout: 10000,
-        windowsHide: true,
-        stdio: ['pipe', 'pipe', 'pipe']
-      }).trim();
-
-      // Compare and write cache
-      const updateAvailable = installed !== 'unknown' && latest !== installed;
-
-      const result = {
-        installed: installed,
-        latest: latest,
-        update_available: updateAvailable,
-        checked_at: Date.now()
-      };
-
-      fs.writeFileSync(cacheFile, JSON.stringify(result, null, 2));
-    } catch (e) {
-      // Network error or npm not available — write a "no check" result
-      const result = {
-        installed: 'unknown',
-        latest: 'unknown',
-        update_available: false,
-        checked_at: Date.now(),
-        error: e.message
-      };
-      fs.writeFileSync(cacheFile, JSON.stringify(result, null, 2));
-    }
-  `], {
-    stdio: 'ignore',
-    windowsHide: true,
-    detached: true  // CRITICAL: prevents blocking Claude Code input on Windows
-  });
-
-  child.unref();
-  process.exit(0);
-});
+#!/usr/bin/env node
+
+// Hydra Update Checker — SessionStart hook
+// Spawns a DETACHED background process to check npm for updates.
+// Writes result to ~/.claude/cache/hydra-update-check.json
+// The statusline hook reads this cache file.
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { spawn } = require('child_process');
+
+const homeDir = os.homedir();
+const cacheDir = path.join(homeDir, '.claude', 'cache');
+const cacheFile = path.join(cacheDir, 'hydra-update-check.json');
+
+// VERSION file locations (check project first, then global)
+const projectVersionFile = path.join(process.cwd(), '.claude', 'hydra', 'VERSION');
+const globalVersionFile = path.join(homeDir, '.claude', 'hydra', 'VERSION');
+
+// Ensure cache directory exists
+if (!fs.existsSync(cacheDir)) {
+  fs.mkdirSync(cacheDir, { recursive: true });
+}
+
+// Skip check if we checked within the last hour
+try {
+  const existing = JSON.parse(fs.readFileSync(cacheFile, 'utf8'));
+  const age = Date.now() - (existing.checked_at || 0);
+  if (age < 3600000) { // 1 hour
+    process.exit(0);
+  }
+} catch (e) {
+  // No cache or invalid — proceed with check
+}
+
+// Read stdin to prevent EPIPE (Claude Code pipes JSON to all hooks)
+let stdinData = '';
+process.stdin.on('data', (chunk) => (stdinData += chunk));
+process.stdin.on('end', () => {
+  // Spawn background process (MUST be detached to not block Claude Code)
+  const child = spawn(process.execPath, ['-e', `
+    const fs = require('fs');
+    const { execSync } = require('child_process');
+
+    const cacheFile = ${JSON.stringify(cacheFile)};
+    const projectVersionFile = ${JSON.stringify(projectVersionFile)};
+    const globalVersionFile = ${JSON.stringify(globalVersionFile)};
+
+    try {
+      // Read installed version
+      let installed = 'unknown';
+      try {
+        installed = fs.readFileSync(projectVersionFile, 'utf8').trim();
+      } catch (e) {
+        try {
+          installed = fs.readFileSync(globalVersionFile, 'utf8').trim();
+        } catch (e2) {}
+      }
+
+      // Fetch latest version from npm (with timeout)
+      const latest = execSync('npm view hail-hydra-cc version', {
+        encoding: 'utf8',
+        timeout: 10000,
+        windowsHide: true,
+        stdio: ['pipe', 'pipe', 'pipe']
+      }).trim();
+
+      // Compare and write cache
+      const updateAvailable = installed !== 'unknown' && latest !== installed;
+
+      const result = {
+        installed: installed,
+        latest: latest,
+        update_available: updateAvailable,
+        checked_at: Date.now()
+      };
+
+      fs.writeFileSync(cacheFile, JSON.stringify(result, null, 2));
+    } catch (e) {
+      // Network error or npm not available — write a "no check" result
+      const result = {
+        installed: 'unknown',
+        latest: 'unknown',
+        update_available: false,
+        checked_at: Date.now(),
+        error: e.message
+      };
+      fs.writeFileSync(cacheFile, JSON.stringify(result, null, 2));
+    }
+  `], {
+    stdio: 'ignore',
+    windowsHide: true,
+    detached: true  // CRITICAL: prevents blocking Claude Code input on Windows
+  });
+
+  child.unref();
+  process.exit(0);
+});