hail-hydra-cc 2.3.1 → 2.4.0

package/README.md

@@ -1,99 +1,99 @@
-# hail-hydra-cc
-
-> Multi-headed speculative execution framework for Claude Code.
-> Inspired by speculative decoding — same quality, 3x faster, ~50% cheaper.
-
-## Quick Install
-
-```bash
-npx hail-hydra-cc
-```
-
-Runs an interactive installer that deploys 10 Hydra agents into your Claude Code setup.
-
-## What is Hydra?
-
-Hydra makes Claude Code's Opus model an intelligent **orchestrator** instead of doing everything itself. It dispatches fast, cheap Haiku 4.5 and Sonnet 4.6 "heads" for routine tasks, reserving Opus-level reasoning only for genuinely hard problems.
-
-| Head | Model | Role |
-|------|-------|------|
-| `hydra-scout` | 🟢 Haiku 4.5 | Codebase exploration, file search |
-| `hydra-runner` | 🟢 Haiku 4.5 | Test execution, builds, linting |
-| `hydra-scribe` | 🟢 Haiku 4.5 | Documentation, READMEs, comments |
-| `hydra-guard` | 🟢 Haiku 4.5 | Security/quality gate after code changes |
-| `hydra-git` | 🟢 Haiku 4.5 | Git operations: commit, branch, diff |
-| `hydra-coder` | 🔵 Sonnet 4.6 | Code implementation, refactoring |
-| `hydra-analyst` | 🔵 Sonnet 4.6 | Code review, debugging, analysis |
-| `hydra-sentinel-scan` | 🟢 Haiku 4.5 | Fast integration sweep |
-| `hydra-sentinel` | 🔵 Sonnet 4.6 | Deep integration analysis |
-| `hydra-preflight` | 🟢 Haiku 4.5 | Environment detection, version probing, dep inventory |
-
-**Expected gains:** 2–3× faster tasks, ~50% lower API costs, zero quality loss.
-(Savings calculated against Opus 4.6 at $5/$25 per MTok — February 2026 pricing)
-
-## Usage
-
-```bash
-npx hail-hydra-cc                # Interactive install (recommended)
-npx hail-hydra-cc --global       # Install to ~/.claude/ — all projects
-npx hail-hydra-cc --local        # Install to ./.claude/ — this project
-npx hail-hydra-cc --both         # Install both locations
-npx hail-hydra-cc --status       # Show what's installed
-npx hail-hydra-cc --uninstall    # Remove all Hydra files
-npx hail-hydra-cc --help         # Show help
-```
-
-## What Gets Installed
-
-```
-~/.claude/                       (or ./.claude/ for local)
-├── agents/                      # 10 agent definitions
-│   ├── hydra-scout.md
-│   ├── hydra-runner.md
-│   ├── hydra-scribe.md
-│   ├── hydra-guard.md
-│   ├── hydra-git.md
-│   ├── hydra-sentinel-scan.md
-│   ├── hydra-preflight.md
-│   ├── hydra-coder.md
-│   ├── hydra-analyst.md
-│   └── hydra-sentinel.md
-├── commands/hydra/              # 10 slash commands
-│   ├── help.md                  # /hydra:help
-│   ├── status.md                # /hydra:status
-│   ├── update.md                # /hydra:update
-│   ├── config.md                # /hydra:config
-│   ├── guard.md                 # /hydra:guard
-│   ├── quiet.md                 # /hydra:quiet
-│   ├── verbose.md               # /hydra:verbose
-│   ├── report.md                # /hydra:report
-│   ├── map.md                   # /hydra:map
-│   └── preflight.md             # /hydra:preflight
-├── hooks/                       # 4 lifecycle hooks
-│   ├── hydra-check-update.js    # SessionStart — version check
-│   ├── hydra-statusline.js      # StatusLine — status bar
-│   ├── hydra-auto-guard.js      # PostToolUse — file tracker
-│   ├── hydra-notify.js          # Notification — task completion sound
-│   └── hydra-task-complete.wav  # Notification sound file
-└── skills/hydra/                # Skill (Claude Code discoverable via /skills)
-    ├── SKILL.md                 # Orchestrator instructions
-    ├── VERSION                  # Installed version
-    └── references/
-        ├── routing-guide.md
-        └── model-capabilities.md
-```
-
-All files are **bundled inside this package** — no network requests during installation.
-
-## Requirements
-
-- Node.js 16+
-- Claude Code
-
-## Full Documentation
-
-[github.com/AR6420/Hail_Hydra](https://github.com/AR6420/Hail_Hydra)
-
-## License
-
-MIT
+# hail-hydra-cc
+
+> Multi-headed speculative execution framework for Claude Code.
+> Inspired by speculative decoding — same quality, 3x faster, ~50% cheaper.
+
+## Quick Install
+
+```bash
+npx hail-hydra-cc
+```
+
+Runs an interactive installer that deploys 10 Hydra agents into your Claude Code setup.
+
+## What is Hydra?
+
+Hydra makes Claude Code's Opus model an intelligent **orchestrator** instead of doing everything itself. It dispatches fast, cheap Haiku 4.5 and Sonnet 4.6 "heads" for routine tasks, reserving Opus-level reasoning only for genuinely hard problems.
+
+| Head | Model | Role |
+|------|-------|------|
+| `hydra-scout` | 🟢 Haiku 4.5 | Codebase exploration, file search |
+| `hydra-runner` | 🟢 Haiku 4.5 | Test execution, builds, linting |
+| `hydra-scribe` | 🟢 Haiku 4.5 | Documentation, READMEs, comments |
+| `hydra-guard` | 🟢 Haiku 4.5 | Security/quality gate after code changes |
+| `hydra-git` | 🟢 Haiku 4.5 | Git operations: commit, branch, diff |
+| `hydra-coder` | 🔵 Sonnet 4.6 | Code implementation, refactoring |
+| `hydra-analyst` | 🔵 Sonnet 4.6 | Code review, debugging, analysis |
+| `hydra-sentinel-scan` | 🟢 Haiku 4.5 | Fast integration sweep |
+| `hydra-sentinel` | 🔵 Sonnet 4.6 | Deep integration analysis |
+| `hydra-preflight` | 🟢 Haiku 4.5 | Environment detection, version probing, dep inventory |
+
+**Expected gains:** 2–3× faster tasks, ~50% lower API costs, zero quality loss.
+(Savings calculated against Opus 4.6 at $5/$25 per MTok — February 2026 pricing)
+
+## Usage
+
+```bash
+npx hail-hydra-cc                # Interactive install (recommended)
+npx hail-hydra-cc --global       # Install to ~/.claude/ — all projects
+npx hail-hydra-cc --local        # Install to ./.claude/ — this project
+npx hail-hydra-cc --both         # Install both locations
+npx hail-hydra-cc --status       # Show what's installed
+npx hail-hydra-cc --uninstall    # Remove all Hydra files
+npx hail-hydra-cc --help         # Show help
+```
+
+## What Gets Installed
+
+```
+~/.claude/                       (or ./.claude/ for local)
+├── agents/                      # 10 agent definitions
+│   ├── hydra-scout.md
+│   ├── hydra-runner.md
+│   ├── hydra-scribe.md
+│   ├── hydra-guard.md
+│   ├── hydra-git.md
+│   ├── hydra-sentinel-scan.md
+│   ├── hydra-preflight.md
+│   ├── hydra-coder.md
+│   ├── hydra-analyst.md
+│   └── hydra-sentinel.md
+├── commands/hydra/              # 10 slash commands
+│   ├── help.md                  # /hydra:help
+│   ├── status.md                # /hydra:status
+│   ├── update.md                # /hydra:update
+│   ├── config.md                # /hydra:config
+│   ├── guard.md                 # /hydra:guard
+│   ├── quiet.md                 # /hydra:quiet
+│   ├── verbose.md               # /hydra:verbose
+│   ├── report.md                # /hydra:report
+│   ├── map.md                   # /hydra:map
+│   └── preflight.md             # /hydra:preflight
+├── hooks/                       # 4 lifecycle hooks
+│   ├── hydra-check-update.js    # SessionStart — version check
+│   ├── hydra-statusline.js      # StatusLine — status bar
+│   ├── hydra-auto-guard.js      # PostToolUse — file tracker
+│   ├── hydra-notify.js          # Notification — task completion sound
+│   └── hydra-task-complete.wav  # Notification sound file
+└── skills/hydra/                # Skill (Claude Code discoverable via /skills)
+    ├── SKILL.md                 # Orchestrator instructions
+    ├── VERSION                  # Installed version
+    └── references/
+        ├── routing-guide.md
+        └── model-capabilities.md
+```
+
+All files are **bundled inside this package** — no network requests during installation.
+
+## Requirements
+
+- Node.js 16+
+- Claude Code
+
+## Full Documentation
+
+[github.com/AR6420/Hail_Hydra](https://github.com/AR6420/Hail_Hydra)
+
+## License
+
+MIT

package/bin/cli.js

@@ -1,105 +1,105 @@
-#!/usr/bin/env node
-'use strict';
-
-// ── Node version guard ────────────────────────────────────────────────────────
-const nodeMajor = parseInt(process.version.slice(1).split('.')[0], 10);
-if (nodeMajor < 16) {
-  process.stderr.write(
-    `\nError: hail-hydra-cc requires Node.js 16 or higher.\n` +
-    `You have ${process.version}. Please upgrade: https://nodejs.org\n\n`
-  );
-  process.exit(1);
-}
-
-// ── Imports ───────────────────────────────────────────────────────────────────
-const { program }     = require('commander');
-const { showLogo }    = require('../src/display');
-const installer       = require('../src/installer');
-const { runPrompts }  = require('../src/prompts');
-const { VERSION }     = require('../src/display');
-
-// ── CLI definition ────────────────────────────────────────────────────────────
-program
-  .name('hail-hydra-cc')
-  .description('Multi-headed speculative execution framework for Claude Code')
-  .version(VERSION, '-v, --version', 'Output the current version')
-  .option('--global',    'Skip prompts, install to ~/.claude/ (all projects)')
-  .option('--local',     'Skip prompts, install to ./.claude/ (this project)')
-  .option('--both',      'Skip prompts, install to both locations')
-  .option('--uninstall', 'Remove all Hydra files from global and local locations')
-  .option('--status',    "Show what's currently installed and where")
-  .addHelpText('after', `
-Examples:
-  npx hail-hydra-cc              Interactive installation (recommended)
-  npx hail-hydra-cc --global     Install globally — no prompts
-  npx hail-hydra-cc --local      Install locally  — no prompts
-  npx hail-hydra-cc --both       Install both     — no prompts
-  npx hail-hydra-cc --status     Check installation status
-  npx hail-hydra-cc --uninstall  Remove all Hydra files
-
-What gets installed:
-  ~/.claude/agents/              9 Hydra agent .md files
-  ~/.claude/skills/hydra/SKILL.md       Core framework instructions
-  ~/.claude/skills/hydra/references/    Model capabilities & routing guides
-`);
-
-// ── Main action ───────────────────────────────────────────────────────────────
-program.action(async (options) => {
-  showLogo();
-
-  try {
-    if (options.status) {
-      await installer.showStatus();
-      return;
-    }
-
-    if (options.uninstall) {
-      await installer.runUninstall({ interactive: true });
-      return;
-    }
-
-    if (options.global) {
-      await installer.runInstall('global', { nonInteractive: true });
-      return;
-    }
-
-    if (options.local) {
-      await installer.runInstall('local', { nonInteractive: true });
-      return;
-    }
-
-    if (options.both) {
-      await installer.runInstall('both', { nonInteractive: true });
-      return;
-    }
-
-    // No flags — run interactive prompts
-    const scope = await runPrompts();
-    if (scope) {
-      await installer.runInstall(scope);
-    }
-  } catch (err) {
-    const chalk = require('chalk');
-
-    if (err.code === 'EACCES') {
-      console.error(
-        chalk.red('\n  ✖ Permission denied.') +
-        chalk.gray(' Try:\n') +
-        chalk.gray('    sudo npx hail-hydra-cc --global\n') +
-        chalk.gray('    npx hail-hydra-cc --local  (no sudo needed)\n')
-      );
-    } else if (
-      err.message &&
-      (err.message.includes('User force closed') || err.message.includes('canceled'))
-    ) {
-      console.log(chalk.gray('\n  Installation cancelled.\n'));
-    } else {
-      console.error(chalk.red(`\n  ✖ Error: ${err.message}\n`));
-      if (process.env.DEBUG) console.error(err.stack);
-    }
-
-    process.exit(1);
-  }
-});
-
-program.parseAsync(process.argv);
+#!/usr/bin/env node
+'use strict';
+
+// ── Node version guard ────────────────────────────────────────────────────────
+const nodeMajor = parseInt(process.version.slice(1).split('.')[0], 10);
+if (nodeMajor < 16) {
+  process.stderr.write(
+    `\nError: hail-hydra-cc requires Node.js 16 or higher.\n` +
+    `You have ${process.version}. Please upgrade: https://nodejs.org\n\n`
+  );
+  process.exit(1);
+}
+
+// ── Imports ───────────────────────────────────────────────────────────────────
+const { program }     = require('commander');
+const { showLogo }    = require('../src/display');
+const installer       = require('../src/installer');
+const { runPrompts }  = require('../src/prompts');
+const { VERSION }     = require('../src/display');
+
+// ── CLI definition ────────────────────────────────────────────────────────────
+program
+  .name('hail-hydra-cc')
+  .description('Multi-headed speculative execution framework for Claude Code')
+  .version(VERSION, '-v, --version', 'Output the current version')
+  .option('--global',    'Skip prompts, install to ~/.claude/ (all projects)')
+  .option('--local',     'Skip prompts, install to ./.claude/ (this project)')
+  .option('--both',      'Skip prompts, install to both locations')
+  .option('--uninstall', 'Remove all Hydra files from global and local locations')
+  .option('--status',    "Show what's currently installed and where")
+  .addHelpText('after', `
+Examples:
+  npx hail-hydra-cc              Interactive installation (recommended)
+  npx hail-hydra-cc --global     Install globally — no prompts
+  npx hail-hydra-cc --local      Install locally  — no prompts
+  npx hail-hydra-cc --both       Install both     — no prompts
+  npx hail-hydra-cc --status     Check installation status
+  npx hail-hydra-cc --uninstall  Remove all Hydra files
+
+What gets installed:
+  ~/.claude/agents/              9 Hydra agent .md files
+  ~/.claude/skills/hydra/SKILL.md       Core framework instructions
+  ~/.claude/skills/hydra/references/    Model capabilities & routing guides
+`);
+
+// ── Main action ───────────────────────────────────────────────────────────────
+program.action(async (options) => {
+  showLogo();
+
+  try {
+    if (options.status) {
+      await installer.showStatus();
+      return;
+    }
+
+    if (options.uninstall) {
+      await installer.runUninstall({ interactive: true });
+      return;
+    }
+
+    if (options.global) {
+      await installer.runInstall('global', { nonInteractive: true });
+      return;
+    }
+
+    if (options.local) {
+      await installer.runInstall('local', { nonInteractive: true });
+      return;
+    }
+
+    if (options.both) {
+      await installer.runInstall('both', { nonInteractive: true });
+      return;
+    }
+
+    // No flags — run interactive prompts
+    const scope = await runPrompts();
+    if (scope) {
+      await installer.runInstall(scope);
+    }
+  } catch (err) {
+    const chalk = require('chalk');
+
+    if (err.code === 'EACCES') {
+      console.error(
+        chalk.red('\n  ✖ Permission denied.') +
+        chalk.gray(' Try:\n') +
+        chalk.gray('    sudo npx hail-hydra-cc --global\n') +
+        chalk.gray('    npx hail-hydra-cc --local  (no sudo needed)\n')
+      );
+    } else if (
+      err.message &&
+      (err.message.includes('User force closed') || err.message.includes('canceled'))
+    ) {
+      console.log(chalk.gray('\n  Installation cancelled.\n'));
+    } else {
+      console.error(chalk.red(`\n  ✖ Error: ${err.message}\n`));
+      if (process.env.DEBUG) console.error(err.stack);
+    }
+
+    process.exit(1);
+  }
+});
+
+program.parseAsync(process.argv);