@automagik/genie 0.260202.530 → 0.260202.1833

package/src/genie-commands/hooks.ts

@@ -1,317 +0,0 @@
-/**
- * Genie Hooks Commands
- *
- * Commands to install, uninstall, and test hooks in Claude Code.
- * Bridges the gap between genie config and Claude Code settings.
- */
-
-import {
-  loadClaudeSettings,
-  saveClaudeSettings,
-  isGenieHookInstalled,
-  addGenieHook,
-  removeGenieHook,
-  getClaudeSettingsPath,
-  contractClaudePath,
-} from '../lib/claude-settings.js';
-import {
-  hookScriptExists,
-  writeHookScript,
-  removeHookScript,
-  testHookScript,
-  getHookScriptDisplayPath,
-} from '../lib/hook-script.js';
-import {
-  loadGenieConfig,
-  getGenieConfigPath,
-} from '../lib/genie-config.js';
-import { describeEnabledHooks, hasEnabledHooks } from '../lib/hooks/index.js';
-import { checkCommand } from '../lib/system-detect.js';
-
-/**
- * Print a boxed success message
- */
-function printSuccessBox(lines: string[]): void {
-  const maxLen = Math.max(...lines.map((l) => l.length));
-  const width = maxLen + 4;
-
-  console.log();
-  console.log('\x1b[32m' + '+' + '-'.repeat(width) + '+' + '\x1b[0m');
-  for (const line of lines) {
-    const padding = ' '.repeat(maxLen - line.length);
-    console.log('\x1b[32m' + '|  ' + '\x1b[0m' + line + padding + '\x1b[32m  |' + '\x1b[0m');
-  }
-  console.log('\x1b[32m' + '+' + '-'.repeat(width) + '+' + '\x1b[0m');
-  console.log();
-}
-
-/**
- * Check required dependencies
- */
-async function checkDependencies(): Promise<{
-  jq: boolean;
-  tmux: boolean;
-  term: boolean;
-  errors: string[];
-}> {
-  const errors: string[] = [];
-
-  const jqCheck = await checkCommand('jq');
-  const tmuxCheck = await checkCommand('tmux');
-  const termCheck = await checkCommand('term');
-
-  if (!jqCheck.exists) {
-    errors.push('jq is required but not installed. Install with: brew install jq (or apt install jq)');
-  }
-
-  return {
-    jq: jqCheck.exists,
-    tmux: tmuxCheck.exists,
-    term: termCheck.exists,
-    errors,
-  };
-}
-
-/**
- * Install hooks into Claude Code
- */
-export async function installHooksCommand(options: { force?: boolean } = {}): Promise<void> {
-  console.log();
-  console.log('\x1b[1m Installing Genie Hooks\x1b[0m');
-  console.log();
-
-  // Step 1: Check dependencies
-  console.log('\x1b[2mChecking dependencies...\x1b[0m');
-  const deps = await checkDependencies();
-
-  if (deps.jq) {
-    console.log('  \x1b[32m+\x1b[0m jq');
-  } else {
-    console.log('  \x1b[31m-\x1b[0m jq (required)');
-  }
-
-  if (deps.tmux) {
-    console.log('  \x1b[32m+\x1b[0m tmux');
-  } else {
-    console.log('  \x1b[33m-\x1b[0m tmux (recommended for collaborative mode)');
-  }
-
-  if (deps.term) {
-    console.log('  \x1b[32m+\x1b[0m term');
-  } else {
-    console.log('  \x1b[33m-\x1b[0m term (required for collaborative mode)');
-  }
-
-  if (deps.errors.length > 0) {
-    console.log();
-    for (const error of deps.errors) {
-      console.log('\x1b[31mError:\x1b[0m ' + error);
-    }
-    process.exit(1);
-  }
-
-  console.log();
-
-  // Step 2: Load genie config and check presets
-  console.log('\x1b[2mLoading configuration...\x1b[0m');
-  const config = await loadGenieConfig();
-
-  if (!hasEnabledHooks(config)) {
-    console.log();
-    console.log('\x1b[33mNo hook presets are enabled.\x1b[0m');
-    console.log('Run \x1b[36mgenie setup\x1b[0m to configure hook presets first.');
-    console.log();
-    process.exit(1);
-  }
-
-  const descriptions = describeEnabledHooks(config);
-  console.log('  \x1b[32m+\x1b[0m Enabled presets: ' + config.hooks.enabled.join(', '));
-  console.log();
-
-  // Step 3: Check if collaborative preset needs tmux
-  if (config.hooks.enabled.includes('collaborative')) {
-    if (!deps.tmux) {
-      console.log('\x1b[33mWarning:\x1b[0m Collaborative mode enabled but tmux not found.');
-      console.log('Install tmux for the best experience: brew install tmux (or apt install tmux)');
-      console.log();
-    }
-    if (!deps.term) {
-      console.log('\x1b[33mWarning:\x1b[0m Collaborative mode enabled but term not found.');
-      console.log('The term command is required for collaborative mode to work.');
-      console.log();
-    }
-  }
-
-  // Step 4: Check if already installed
-  const settings = await loadClaudeSettings();
-  if (isGenieHookInstalled(settings) && !options.force) {
-    console.log('\x1b[33mGenie hooks are already installed.\x1b[0m');
-    console.log('Use \x1b[36m--force\x1b[0m to reinstall.');
-    console.log();
-    return;
-  }
-
-  // Step 5: Write the hook script
-  console.log('\x1b[2mWriting hook script...\x1b[0m');
-  await writeHookScript();
-  console.log('  \x1b[32m+\x1b[0m ' + getHookScriptDisplayPath());
-  console.log();
-
-  // Step 6: Update Claude settings
-  console.log('\x1b[2mUpdating Claude Code settings...\x1b[0m');
-  const updatedSettings = addGenieHook(settings);
-  await saveClaudeSettings(updatedSettings);
-  console.log('  \x1b[32m+\x1b[0m Hook registered in ' + contractClaudePath(getClaudeSettingsPath()));
-  console.log();
-
-  // Step 7: Print success
-  const sessionName = config.hooks.collaborative?.sessionName || 'genie';
-  printSuccessBox([
-    '\x1b[32m+\x1b[0m Installation complete!',
-    '',
-    'Restart Claude Code for changes to take effect.',
-    '',
-    'After restart, all Bash commands will run in tmux.',
-    `Watch with: tmux attach -t ${sessionName}`,
-  ]);
-}
-
-/**
- * Uninstall hooks from Claude Code
- */
-export async function uninstallHooksCommand(options: { keepScript?: boolean } = {}): Promise<void> {
-  console.log();
-  console.log('\x1b[1m Uninstalling Genie Hooks\x1b[0m');
-  console.log();
-
-  // Step 1: Remove from Claude settings
-  console.log('\x1b[2mRemoving from Claude Code settings...\x1b[0m');
-  const settings = await loadClaudeSettings();
-
-  if (!isGenieHookInstalled(settings)) {
-    console.log('  \x1b[33m-\x1b[0m No genie hooks found in settings');
-  } else {
-    const updatedSettings = removeGenieHook(settings);
-    await saveClaudeSettings(updatedSettings);
-    console.log('  \x1b[32m+\x1b[0m Hook removed from ' + contractClaudePath(getClaudeSettingsPath()));
-  }
-  console.log();
-
-  // Step 2: Remove hook script (unless --keep-script)
-  if (!options.keepScript) {
-    console.log('\x1b[2mRemoving hook script...\x1b[0m');
-    if (hookScriptExists()) {
-      removeHookScript();
-      console.log('  \x1b[32m+\x1b[0m Deleted ' + getHookScriptDisplayPath());
-    } else {
-      console.log('  \x1b[33m-\x1b[0m Hook script not found');
-    }
-    console.log();
-  } else {
-    console.log('\x1b[2mKeeping hook script (--keep-script)\x1b[0m');
-    console.log();
-  }
-
-  // Step 3: Print success
-  printSuccessBox([
-    '\x1b[32m+\x1b[0m Uninstallation complete!',
-    '',
-    'Restart Claude Code for changes to take effect.',
-  ]);
-}
-
-/**
- * Test the hook script
- */
-export async function testHooksCommand(): Promise<void> {
-  console.log();
-  console.log('\x1b[1m Testing Genie Hooks\x1b[0m');
-  console.log();
-
-  // Check if script exists
-  if (!hookScriptExists()) {
-    console.log('\x1b[31mError:\x1b[0m Hook script not found.');
-    console.log('Run \x1b[36mgenie hooks install\x1b[0m first.');
-    console.log();
-    process.exit(1);
-  }
-
-  console.log('Script location: ' + getHookScriptDisplayPath());
-  console.log();
-
-  // Run test
-  console.log('\x1b[2mTesting with sample Bash input...\x1b[0m');
-  const result = await testHookScript();
-
-  if (result.success) {
-    console.log('\x1b[32m+\x1b[0m Hook script works correctly!');
-    console.log();
-    console.log('\x1b[2mSample output:\x1b[0m');
-    try {
-      const parsed = JSON.parse(result.output || '{}');
-      console.log(JSON.stringify(parsed, null, 2));
-    } catch {
-      console.log(result.output);
-    }
-  } else {
-    console.log('\x1b[31m-\x1b[0m Hook script test failed!');
-    console.log();
-    console.log('\x1b[31mError:\x1b[0m ' + result.error);
-    if (result.output) {
-      console.log();
-      console.log('\x1b[2mOutput:\x1b[0m');
-      console.log(result.output);
-    }
-    process.exit(1);
-  }
-
-  console.log();
-}
-
-/**
- * Show current hook configuration (moved from setup.ts)
- */
-export async function showHooksCommand(): Promise<void> {
-  const config = await loadGenieConfig();
-  const descriptions = describeEnabledHooks(config);
-
-  console.log();
-  console.log('\x1b[1m Current Hook Configuration\x1b[0m');
-  console.log(`   Genie config: ${contractClaudePath(getGenieConfigPath())}`);
-  console.log(`   Claude settings: ${contractClaudePath(getClaudeSettingsPath())}`);
-  console.log();
-
-  // Show enabled presets
-  if (descriptions.length === 0) {
-    console.log('\x1b[33m   No hook presets enabled.\x1b[0m');
-    console.log('   Run \x1b[36mgenie setup\x1b[0m to configure hooks.');
-  } else {
-    console.log('\x1b[2m   Enabled presets:\x1b[0m');
-    for (const desc of descriptions) {
-      console.log(`   \x1b[32m+\x1b[0m ${desc}`);
-    }
-  }
-  console.log();
-
-  // Show installation status
-  const settings = await loadClaudeSettings();
-  const installed = isGenieHookInstalled(settings);
-  const scriptExists = hookScriptExists();
-
-  console.log('\x1b[2m   Installation status:\x1b[0m');
-  if (installed && scriptExists) {
-    console.log('   \x1b[32m+\x1b[0m Hooks installed in Claude Code');
-    console.log('   \x1b[32m+\x1b[0m Hook script exists');
-  } else if (installed && !scriptExists) {
-    console.log('   \x1b[33m!\x1b[0m Hook registered but script missing');
-    console.log('   Run \x1b[36mgenie hooks install --force\x1b[0m to fix');
-  } else if (!installed && scriptExists) {
-    console.log('   \x1b[33m!\x1b[0m Script exists but hook not registered');
-    console.log('   Run \x1b[36mgenie hooks install\x1b[0m to register');
-  } else {
-    console.log('   \x1b[33m-\x1b[0m Hooks not installed');
-    console.log('   Run \x1b[36mgenie hooks install\x1b[0m to install');
-  }
-
-  console.log();
-}

package/src/lib/hook-script.ts

@@ -1,263 +0,0 @@
-/**
- * Hook Script Manager
- *
- * Generates and manages the bash hook script at ~/.claude/hooks/genie-bash-hook.sh
- * This script intercepts Bash tool calls and rewrites them to go through term exec.
- */
-
-import { existsSync, unlinkSync, writeFileSync, chmodSync } from 'fs';
-import {
-  ensureClaudeHooksDir,
-  getGenieHookScriptPath,
-  contractClaudePath,
-} from './claude-settings.js';
-import { loadGenieConfig } from './genie-config.js';
-
-/**
- * Check if the hook script exists
- */
-export function hookScriptExists(): boolean {
-  return existsSync(getGenieHookScriptPath());
-}
-
-/**
- * Get the hook script path (re-export for convenience)
- */
-export function getHookScriptPath(): string {
-  return getGenieHookScriptPath();
-}
-
-/**
- * Get the hook script path for display (with ~ for home)
- */
-export function getHookScriptDisplayPath(): string {
-  return contractClaudePath(getGenieHookScriptPath());
-}
-
-/**
- * Generate the hook script content
- *
- * The script:
- * 1. Reads JSON from stdin (Claude Code sends hook event)
- * 2. Extracts the command from the Bash tool input
- * 3. Wraps the command in `term exec genie:shell '...'`
- * 4. Outputs JSON in Claude Code's expected format
- */
-export async function generateHookScript(): Promise<string> {
-  // Load config to get session/window names
-  const config = await loadGenieConfig();
-  const sessionName = config.hooks.collaborative?.sessionName || 'genie';
-  const windowName = config.hooks.collaborative?.windowName || 'shell';
-  const target = `${sessionName}:${windowName}`;
-
-  // The bash script that will be executed by Claude Code
-  // Uses jq to parse and transform the JSON
-  const script = `#!/bin/bash
-#
-# Genie Bash Hook for Claude Code
-#
-# This hook intercepts Bash tool calls and rewrites them to execute
-# through tmux via 'term exec', making all terminal operations visible
-# in a shared tmux session.
-#
-# Generated by: genie hooks install
-# Target session: ${target}
-#
-
-# Read the entire input from stdin
-INPUT=$(cat)
-
-# Extract the tool name to verify this is a Bash call
-TOOL_NAME=$(echo "$INPUT" | jq -r '.tool_name // empty')
-
-# If not a Bash tool call, allow it to proceed unchanged
-if [ "$TOOL_NAME" != "Bash" ]; then
-  echo '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"allow"}}'
-  exit 0
-fi
-
-# Extract the command from the tool input
-COMMAND=$(echo "$INPUT" | jq -r '.tool_input.command // empty')
-
-# If no command, allow it (shouldn't happen but be safe)
-if [ -z "$COMMAND" ]; then
-  echo '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"allow"}}'
-  exit 0
-fi
-
-# Don't wrap commands that are already term exec calls (avoid infinite recursion)
-if [[ "$COMMAND" == *"term exec "* ]] || [[ "$COMMAND" == *"/term.js exec"* ]] || [[ "$COMMAND" == *".local/bin/term "* ]] || [[ "$COMMAND" == *".genie/bin/term"* ]]; then
-  echo '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"allow"}}'
-  exit 0
-fi
-
-# Escape single quotes in the command for safe shell embedding
-# Replace ' with '\\'\\''
-ESCAPED_COMMAND=$(echo "$COMMAND" | sed "s/'/'\\\\'\\\\''/" )
-
-# Build the wrapped command that goes through term exec
-# Uses full path since Claude's subprocess may not have full PATH
-WRAPPED_COMMAND="\$HOME/.local/bin/term exec ${sessionName}:\\\${CLAUDIO_SESSION:-claude} '\${ESCAPED_COMMAND}'"
-
-# Extract other fields from the original input to preserve them
-TIMEOUT=$(echo "$INPUT" | jq -r '.tool_input.timeout // empty')
-DESCRIPTION=$(echo "$INPUT" | jq -r '.tool_input.description // empty')
-RUN_IN_BACKGROUND=$(echo "$INPUT" | jq -r '.tool_input.run_in_background // empty')
-
-# Build the updated input object
-UPDATED_INPUT=$(jq -n \\
-  --arg cmd "$WRAPPED_COMMAND" \\
-  --arg timeout "$TIMEOUT" \\
-  --arg desc "$DESCRIPTION" \\
-  --arg background "$RUN_IN_BACKGROUND" \\
-  '{
-    command: $cmd,
-    timeout: (if $timeout != "" then ($timeout | tonumber) else null end),
-    description: (if $desc != "" then ("[term] " + $desc) else null end),
-    run_in_background: (if $background == "true" then true elif $background == "false" then false else null end)
-  } | with_entries(select(.value != null))')
-
-# Output the hook response in the correct format
-jq -n \\
-  --argjson updatedInput "$UPDATED_INPUT" \\
-  '{
-    "hookSpecificOutput": {
-      "hookEventName": "PreToolUse",
-      "permissionDecision": "allow",
-      "updatedInput": $updatedInput,
-      "additionalContext": "Human can observe: tmux attach -t ${sessionName}"
-    }
-  }'
-`;
-
-  return script;
-}
-
-/**
- * Write the hook script to disk
- */
-export async function writeHookScript(): Promise<void> {
-  ensureClaudeHooksDir();
-
-  const scriptPath = getGenieHookScriptPath();
-  const scriptContent = await generateHookScript();
-
-  writeFileSync(scriptPath, scriptContent, 'utf-8');
-
-  // Make the script executable
-  chmodSync(scriptPath, 0o755);
-}
-
-/**
- * Remove the hook script from disk
- */
-export function removeHookScript(): void {
-  const scriptPath = getGenieHookScriptPath();
-  if (existsSync(scriptPath)) {
-    unlinkSync(scriptPath);
-  }
-}
-
-/**
- * Test the hook script with sample input
- * Returns { success: boolean, output?: string, error?: string }
- */
-export async function testHookScript(): Promise<{
-  success: boolean;
-  output?: string;
-  error?: string;
-}> {
-  const scriptPath = getGenieHookScriptPath();
-
-  if (!existsSync(scriptPath)) {
-    return {
-      success: false,
-      error: 'Hook script not found. Run "genie hooks install" first.',
-    };
-  }
-
-  // Sample input that mimics what Claude Code sends
-  const sampleInput = JSON.stringify({
-    hook_event_name: 'PreToolUse',
-    tool_name: 'Bash',
-    tool_input: {
-      command: 'echo "Hello, World!"',
-      description: 'Test command',
-    },
-  });
-
-  try {
-    const { $ } = await import('bun');
-
-    // Run the script with sample input
-    const result = await $`echo ${sampleInput} | ${scriptPath}`.quiet();
-
-    if (result.exitCode !== 0) {
-      return {
-        success: false,
-        error: `Script exited with code ${result.exitCode}`,
-        output: result.stderr.toString(),
-      };
-    }
-
-    const output = result.stdout.toString().trim();
-
-    // Try to parse the output as JSON
-    try {
-      const parsed = JSON.parse(output);
-
-      // Validate the structure
-      if (!parsed.hookSpecificOutput) {
-        return {
-          success: false,
-          error: 'Output missing hookSpecificOutput field',
-          output,
-        };
-      }
-
-      if (parsed.hookSpecificOutput.hookEventName !== 'PreToolUse') {
-        return {
-          success: false,
-          error: 'Output has wrong hookEventName',
-          output,
-        };
-      }
-
-      if (!['allow', 'deny', 'ask'].includes(parsed.hookSpecificOutput.permissionDecision)) {
-        return {
-          success: false,
-          error: 'Output has invalid permissionDecision',
-          output,
-        };
-      }
-
-      // Check that the command was wrapped
-      if (parsed.hookSpecificOutput.updatedInput?.command) {
-        const cmd = parsed.hookSpecificOutput.updatedInput.command;
-        if (!cmd.includes('term exec')) {
-          return {
-            success: false,
-            error: 'Command was not wrapped with term exec',
-            output,
-          };
-        }
-      }
-
-      return {
-        success: true,
-        output,
-      };
-    } catch (parseError: any) {
-      return {
-        success: false,
-        error: `Output is not valid JSON: ${parseError.message}`,
-        output,
-      };
-    }
-  } catch (error: any) {
-    return {
-      success: false,
-      error: `Failed to run hook script: ${error.message}`,
-    };
-  }
-}

package/src/lib/hooks/compose.ts

@@ -1,72 +0,0 @@
-/**
- * Hook Composition Utilities
- *
- * Functions for merging multiple hook configurations together.
- */
-
-import type { HookConfig } from './presets/collaborative.js';
-
-/**
- * Deep merge two hook configurations
- *
- * Hooks are composed by concatenating their hook arrays.
- * This means all hooks from both configs will run in order.
- */
-export function mergeHooks(base: HookConfig, override: HookConfig): HookConfig {
-  const result: HookConfig = { ...base };
-
-  // Merge PreToolUse hooks
-  if (override.PreToolUse) {
-    result.PreToolUse = [...(base.PreToolUse || []), ...override.PreToolUse];
-  }
-
-  // Merge PostToolUse hooks
-  if (override.PostToolUse) {
-    result.PostToolUse = [...(base.PostToolUse || []), ...override.PostToolUse];
-  }
-
-  // Merge PermissionRequest hooks
-  if (override.PermissionRequest) {
-    result.PermissionRequest = [...(base.PermissionRequest || []), ...override.PermissionRequest];
-  }
-
-  return result;
-}
-
-/**
- * Compose multiple hook configurations into one
- *
- * Hooks are executed in the order they appear in the array.
- * First preset's hooks run first.
- */
-export function composeHooks(...configs: HookConfig[]): HookConfig {
-  return configs.reduce((acc, config) => mergeHooks(acc, config), {});
-}
-
-/**
- * Check if a hook config is empty (no hooks defined)
- */
-export function isEmptyHookConfig(config: HookConfig): boolean {
-  return (
-    (!config.PreToolUse || config.PreToolUse.length === 0) &&
-    (!config.PostToolUse || config.PostToolUse.length === 0) &&
-    (!config.PermissionRequest || config.PermissionRequest.length === 0)
-  );
-}
-
-/**
- * Count total number of hooks in a config
- */
-export function countHooks(config: HookConfig): number {
-  let count = 0;
-  if (config.PreToolUse) {
-    count += config.PreToolUse.reduce((sum, entry) => sum + entry.hooks.length, 0);
-  }
-  if (config.PostToolUse) {
-    count += config.PostToolUse.reduce((sum, entry) => sum + entry.hooks.length, 0);
-  }
-  if (config.PermissionRequest) {
-    count += config.PermissionRequest.reduce((sum, entry) => sum + entry.hooks.length, 0);
-  }
-  return count;
-}