claude-mem 2.1.2 → 3.0.2

package/hooks/hook-utils.js

@@ -1,318 +0,0 @@
-/**
- * Shared utilities for Claude Code hooks
- * 
- * This module provides common functionality for all hook files to eliminate
- * duplicated code patterns across pre-compact.js, session-start.js, etc.
- */
-
-import { spawn } from 'child_process';
-import { readFileSync, existsSync } from 'fs';
-import { join } from 'path';
-import { homedir } from 'os';
-
-// Import constants - note: hooks are JavaScript, not TypeScript
-const PACKAGE_NAME = 'claude-mem';
-const CLAUDE_MEM_BASE = '.claude-mem';
-
-// =============================================================================
-// HOOK CONFIGURATION LOADING
-// =============================================================================
-
-/**
- * Load hook configuration from settings (eliminates ~33 lines per hook)
- */
-export function loadHookConfig() {
-  const settingsPath = join(homedir(), CLAUDE_MEM_BASE, 'settings.json');
-  
-  if (!existsSync(settingsPath)) {
-    return {};
-  }
-  
-  try {
-    const content = readFileSync(settingsPath, 'utf8');
-    return JSON.parse(content);
-  } catch (error) {
-    console.warn(`Warning: Could not load hook config: ${error.message}`);
-    return {};
-  }
-}
-
-// =============================================================================
-// STDIN JSON READING
-// =============================================================================
-
-/**
- * Read and parse JSON from stdin (removes 30+ duplicate lines)
- * Returns a Promise that resolves with the parsed JSON data
- */
-export function readStdinJson() {
-  return new Promise((resolve, reject) => {
-    let input = '';
-    
-    process.stdin.on('data', chunk => {
-      input += chunk;
-    });
-    
-    process.stdin.on('end', () => {
-      try {
-        const data = JSON.parse(input);
-        resolve(data);
-      } catch (error) {
-        reject(new Error(`Invalid JSON input: ${error.message}`));
-      }
-    });
-    
-    process.stdin.on('error', error => {
-      reject(new Error(`Stdin error: ${error.message}`));
-    });
-  });
-}
-
-// =============================================================================
-// HOOK RESPONSE HELPERS
-// =============================================================================
-
-/**
- * Standard hook response objects (matches constants.ts HOOK_RESPONSES pattern)
- */
-export const HookResponse = {
-  /**
-   * Success response with optional message (matches HOOK_RESPONSES.SUCCESS pattern)
-   */
-  success(hookEventName, message) {
-    return {
-      hookSpecificOutput: {
-        hookEventName,
-        status: "success",
-        message
-      },
-      suppressOutput: true
-    };
-  },
-
-  /**
-   * Skipped response (matches HOOK_RESPONSES.SKIPPED pattern)
-   */
-  skipped(hookEventName, message) {
-    return {
-      hookSpecificOutput: {
-        hookEventName,
-        status: "skipped",
-        message
-      },
-      suppressOutput: true
-    };
-  },
-
-  /**
-   * Error response (matches HOOK_RESPONSES.ERROR pattern)
-   */
-  error(hookEventName, message) {
-    return {
-      continue: false,
-      stopReason: message,
-      suppressOutput: true,
-      hookSpecificOutput: {
-        hookEventName,
-        status: "error",
-        message
-      }
-    };
-  },
-
-  /**
-   * Permission response for tool use
-   */
-  permission(decision, reason = '') {
-    return {
-      continue: true,
-      permissionDecision: decision, // 'allow' or 'deny'
-      permissionDecisionReason: reason
-    };
-  }
-};
-
-// =============================================================================
-// CLI SPAWNING UTILITIES
-// =============================================================================
-
-/**
- * Spawn CLI command (consolidates 90+ lines of spawn logic)
- */
-export function spawnCLI(command, args = [], options = {}) {
-  return new Promise((resolve, reject) => {
-    const defaultOptions = {
-      stdio: ['pipe', 'pipe', 'pipe'],
-      env: process.env,
-      timeout: 30000, // 30 second default timeout
-      ...options
-    };
-
-    // Find CLI executable
-    const possibleCommands = [
-      PACKAGE_NAME,
-      `npx ${PACKAGE_NAME}`,
-      join(process.cwd(), 'node_modules', '.bin', PACKAGE_NAME),
-      join(homedir(), '.npm-global', 'bin', PACKAGE_NAME)
-    ];
-
-    let claudeMemCmd = command;
-    if (!claudeMemCmd) {
-      // Try to find the best command
-      claudeMemCmd = PACKAGE_NAME; // Default fallback
-    }
-
-    const child = spawn(claudeMemCmd, args, defaultOptions);
-    
-    let stdout = '';
-    let stderr = '';
-    
-    child.stdout?.on('data', (data) => {
-      stdout += data.toString();
-    });
-    
-    child.stderr?.on('data', (data) => {
-      stderr += data.toString();
-    });
-    
-    child.on('close', (code) => {
-      if (code === 0) {
-        resolve({
-          code,
-          stdout: stdout.trim(),
-          stderr: stderr.trim()
-        });
-      } else {
-        reject(new Error(`Command failed with code ${code}: ${stderr.trim()}`));
-      }
-    });
-    
-    child.on('error', (error) => {
-      reject(new Error(`Failed to spawn command: ${error.message}`));
-    });
-
-    // Handle timeout
-    if (defaultOptions.timeout) {
-      setTimeout(() => {
-        child.kill('SIGTERM');
-        reject(new Error(`Command timed out after ${defaultOptions.timeout}ms`));
-      }, defaultOptions.timeout);
-    }
-  });
-}
-
-/**
- * Run CLI command with specific subcommand and arguments
- */
-export async function runClaudeMemCommand(subcommand, args = [], options = {}) {
-  const fullArgs = [subcommand, ...args];
-  return spawnCLI(PACKAGE_NAME, fullArgs, options);
-}
-
-// =============================================================================
-// PROJECT NAME EXTRACTION
-// =============================================================================
-
-/**
- * Extract project name from transcript path
- * Consolidates the 3 different implementations found in the codebase
- */
-export function extractProjectName(transcriptPath) {
-  if (!transcriptPath) {
-    return 'unknown';
-  }
-  
-  // Standard pattern: Scripts/[project-name]/...
-  const match = transcriptPath.match(/Scripts[\\/\\]([^\\/\\]+)/);
-  if (match) {
-    return match[1];
-  }
-  
-  // Fallback: try to extract from directory structure
-  const parts = transcriptPath.split(/[\\/]/);
-  for (let i = 0; i < parts.length - 1; i++) {
-    if (parts[i] === 'Scripts' && parts[i + 1]) {
-      return parts[i + 1];
-    }
-  }
-  
-  return 'unknown';
-}
-
-// =============================================================================
-// UTILITY HELPERS
-// =============================================================================
-
-/**
- * Safe JSON output for hook responses
- */
-export function outputJSON(data) {
-  try {
-    console.log(JSON.stringify(data, null, 2));
-  } catch (error) {
-    console.error(JSON.stringify({
-      continue: false,
-      stopReason: `Failed to serialize response: ${error.message}`
-    }));
-  }
-}
-
-/**
- * Debug logging helper
- */
-export function debugLog(message) {
-  if (process.env.CLAUDE_MEM_DEBUG) {
-    console.error(`[DEBUG] ${message}`);
-  }
-}
-
-/**
- * Validate hook payload structure
- */
-export function validateHookPayload(payload, requiredFields = []) {
-  const errors = [];
-  
-  if (!payload || typeof payload !== 'object') {
-    errors.push('Payload must be an object');
-    return errors;
-  }
-  
-  requiredFields.forEach(field => {
-    if (!(field in payload)) {
-      errors.push(`Missing required field: ${field}`);
-    }
-  });
-  
-  return errors;
-}
-
-/**
- * Create hook execution context
- */
-export function createHookContext(payload) {
-  return {
-    sessionId: payload.session_id || 'unknown',
-    transcriptPath: payload.transcript_path || null,
-    hookEventName: payload.hook_event_name || 'unknown',
-    source: payload.source || 'unknown', // For SessionStart hooks
-    timestamp: new Date().toISOString(),
-    projectName: payload.transcript_path ? extractProjectName(payload.transcript_path) : null
-  };
-}
-
-// =============================================================================
-// EXPORT ALL UTILITIES
-// =============================================================================
-
-export default {
-  loadHookConfig,
-  readStdinJson,
-  HookResponse,
-  spawnCLI,
-  runClaudeMemCommand,
-  extractProjectName,
-  outputJSON,
-  debugLog,
-  validateHookPayload,
-  createHookContext
-};