hail-hydra-cc 2.3.1 → 2.3.2

package/files/commands/hydra/help.md

@@ -1,46 +1,47 @@
----
-description: Show all available Hydra commands, agents, and a quick reference guide
----
-
-# Hydra Help
-
-Display the following help reference directly — do NOT search files or run commands:
-
-```
-🐉 Hydra Framework — Quick Reference
-═══════════════════════════════════════
-COMMANDS
-  /hydra:help      Show this help screen
-  /hydra:status    Show installed agents, version, config
-  /hydra:update    Update Hydra to the latest version
-  /hydra:config    Show current configuration
-  /hydra:guard     Run security scan on files (usage: /hydra:guard src/auth.py)
-  /hydra:quiet     Suppress dispatch logs for this session
-  /hydra:map       View, rebuild, or query the codebase map
-  /hydra:verbose   Enable verbose dispatch logs with timing
-  /hydra:report    Report a bug, request a feature, or share feedback
-  /hydra:preflight Two-phase environment & compatibility check before new projects
-  /hydra:stats     Show real token usage and estimated savings (no AI estimation)
-
-AGENTS
-  🟢 hydra-scout    (Haiku 4.5)   — Explore codebase, find files, map structure
-  🟢 hydra-runner   (Haiku 4.5)   — Run tests, linters, build commands
-  🟢 hydra-scribe   (Haiku 4.5)   — Write docs, comments, READMEs
-  🟢 hydra-guard    (Haiku 4.5)   — Security scan, quality gate
-  🟢 hydra-git      (Haiku 4.5)   — Git operations, commits, branches
-  🟢 hydra-preflight (Haiku 4.5)  — Environment detection, version probing, dep inventory
-  🔵 hydra-coder    (Sonnet 4.6)  — Write and edit code
-  🔵 hydra-analyst  (Sonnet 4.6)  — Debug, diagnose, review
-
-HOW IT WORKS
-  The Opus 4.6 orchestrator automatically delegates tasks to cheaper,
-  faster agents (Haiku 4.5 and Sonnet 4.6) — saving ~50% on API costs
-  while maintaining Opus-level quality through verification.
-
-  You don't need to do anything. Just work normally.
-  Hydra operates invisibly unless you check the dispatch log.
-
-LINKS
-  GitHub:  https://github.com/AR6420/Hail_Hydra
-  npm:     https://www.npmjs.com/package/hail-hydra-cc
-```
+---
+description: Show all available Hydra commands, agents, and a quick reference guide
+---
+
+# Hydra Help
+
+Display the following help reference directly — do NOT search files or run commands:
+
+```
+🐉 Hydra Framework — Quick Reference
+═══════════════════════════════════════
+COMMANDS
+  /hydra:help      Show this help screen
+  /hydra:status    Show installed agents, version, config
+  /hydra:update    Update Hydra to the latest version
+  /hydra:config    Show current configuration
+  /hydra:guard     Run security scan on files (usage: /hydra:guard src/auth.py)
+  /hydra:quiet     Suppress dispatch logs for this session
+  /hydra:map       View, rebuild, or query the codebase map
+  /hydra:verbose   Enable verbose dispatch logs with timing
+  /hydra:report    Report a bug, request a feature, or share feedback
+  /hydra:preflight Two-phase environment & compatibility check before new projects
+  /hydra:stats     Show real token usage and estimated savings (no AI estimation)
+  /hydra:stfu      Silence intermediate prose from every dispatched subagent
+
+AGENTS
+  🟢 hydra-scout    (Haiku 4.5)   — Explore codebase, find files, map structure
+  🟢 hydra-runner   (Haiku 4.5)   — Run tests, linters, build commands
+  🟢 hydra-scribe   (Haiku 4.5)   — Write docs, comments, READMEs
+  🟢 hydra-guard    (Haiku 4.5)   — Security scan, quality gate
+  🟢 hydra-git      (Haiku 4.5)   — Git operations, commits, branches
+  🟢 hydra-preflight (Haiku 4.5)  — Environment detection, version probing, dep inventory
+  🔵 hydra-coder    (Sonnet 4.6)  — Write and edit code
+  🔵 hydra-analyst  (Sonnet 4.6)  — Debug, diagnose, review
+
+HOW IT WORKS
+  The Opus 4.6 orchestrator automatically delegates tasks to cheaper,
+  faster agents (Haiku 4.5 and Sonnet 4.6) — saving ~50% on API costs
+  while maintaining Opus-level quality through verification.
+
+  You don't need to do anything. Just work normally.
+  Hydra operates invisibly unless you check the dispatch log.
+
+LINKS
+  GitHub:  https://github.com/AR6420/Hail_Hydra
+  npm:     https://www.npmjs.com/package/hail-hydra-cc
+```

package/files/commands/hydra/quiet.md

@@ -1,16 +1,16 @@
----
-description: Suppress Hydra dispatch logs for the rest of this session
----
-
-# Hydra Quiet Mode
-
-Acknowledge this command and remember for the rest of this session:
-
-**Do NOT display the Hydra Dispatch Log footer after tasks.**
-
-Respond with:
-"🐉 Quiet mode enabled. Dispatch logs suppressed for this session. Use /hydra:verbose to re-enable."
-
-Continue operating Hydra normally (delegation, verification, auto-guard) — just don't show the dispatch log table.
-
-Also suppress the task completion notification sound for this session.
+---
+description: Suppress Hydra dispatch logs for the rest of this session
+---
+
+# Hydra Quiet Mode
+
+Acknowledge this command and remember for the rest of this session:
+
+**Do NOT display the Hydra Dispatch Log footer after tasks.**
+
+Respond with:
+"🐉 Quiet mode enabled. Dispatch logs suppressed for this session. Use /hydra:verbose to re-enable."
+
+Continue operating Hydra normally (delegation, verification, auto-guard) — just don't show the dispatch log table.
+
+Also suppress the task completion notification sound for this session.

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 (9): update, status, help, config, guard, quiet, verbose, report, map
-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/stfu.md

@@ -0,0 +1,21 @@
+---
+description: Activate STFU-Agents mode — silence intermediate prose from every dispatched subagent
+allowed-tools: Read
+---
+
+# Hydra STFU Mode
+
+Activate the STFU-Agents skill for this session.
+
+Acknowledge with:
+"🐉 STFU-Agents mode activated. All dispatched subagents will run with compressed internal thinking. Final outputs unchanged. Run `/skills` to deactivate or say 'verbose agents'."
+
+From this point in the session, when dispatching ANY subagent via the Task tool, prepend the internal-compression directive defined in `skills/stfu-agents/SKILL.md` to the task description.
+
+Applies until:
+- Session ends
+- User says "verbose agents" / "stop STFU"
+- A conflicting skill is invoked
+
+## Why
+Subagents generate intermediate prose that's billed by Anthropic but never read. Final summary is the only thing returned to Opus. STFU tells every dispatched subagent to skip narration — same final output, fewer billed tokens. Universal scope: any subagent in the session, regardless of source.

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,54 @@
-#!/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');
+    }
+
+  } catch (e) {
+    // Silently fail — NEVER block Claude Code
+  }
+  process.exit(0);
+});