claude-mem 3.2.0 → 3.2.1

package/dist/prompts/templates/hooks/HookTemplates.js

@@ -1,394 +0,0 @@
-/**
- * Hook Templates for System Integration
- *
- * This module provides standardized templates for hook responses that integrate
- * with Claude Code's hook system. These templates ensure consistent formatting
- * and proper JSON structure for different hook events.
- *
- * Based on Claude Code Hook Documentation v2025
- */
-// =============================================================================
-// PRE-COMPACT HOOK TEMPLATES
-// =============================================================================
-/**
- * Creates a successful pre-compact response that allows compression to proceed
- * PreCompact hooks do NOT support hookSpecificOutput according to documentation
- */
-export function createPreCompactSuccessResponse() {
-    return {
-        continue: true,
-        suppressOutput: true
-    };
-}
-/**
- * Creates a blocked pre-compact response that prevents compression
- */
-export function createPreCompactBlockedResponse(reason) {
-    return {
-        continue: false,
-        stopReason: reason,
-        suppressOutput: true
-    };
-}
-/**
- * Creates a pre-compact response with approval decision
- */
-export function createPreCompactApprovalResponse(decision, reason) {
-    return {
-        decision,
-        reason,
-        continue: decision === 'approve',
-        suppressOutput: true
-    };
-}
-// =============================================================================
-// SESSION START HOOK TEMPLATES
-// =============================================================================
-/**
- * Creates a successful session start response with loaded context
- * SessionStart hooks DO support hookSpecificOutput
- */
-export function createSessionStartSuccessResponse(additionalContext) {
-    return {
-        continue: true,
-        suppressOutput: true,
-        hookSpecificOutput: {
-            hookEventName: 'SessionStart',
-            additionalContext
-        }
-    };
-}
-/**
- * Creates a session start response when no context is available
- */
-export function createSessionStartEmptyResponse() {
-    return {
-        continue: true,
-        suppressOutput: true,
-        hookSpecificOutput: {
-            hookEventName: 'SessionStart',
-            additionalContext: 'Starting fresh session - no previous context available'
-        }
-    };
-}
-/**
- * Creates a session start response with error information
- */
-export function createSessionStartErrorResponse(error) {
-    return {
-        continue: true, // Continue even if context loading fails
-        suppressOutput: true,
-        hookSpecificOutput: {
-            hookEventName: 'SessionStart',
-            additionalContext: `Context loading encountered an issue: ${error}. Starting without previous context.`
-        }
-    };
-}
-/**
- * Creates a rich session start response with memory summary
- */
-export function createSessionStartMemoryResponse(memoryData) {
-    const { projectName, memoryCount, lastSessionTime, recentComponents = [], recentDecisions = [] } = memoryData;
-    const timeInfo = lastSessionTime ? ` (last worked: ${lastSessionTime})` : '';
-    const contextParts = [];
-    contextParts.push(`🧠 Loaded ${memoryCount} memories from previous sessions for ${projectName}${timeInfo}`);
-    if (recentComponents.length > 0) {
-        contextParts.push(`\n🎯 Recent components: ${recentComponents.slice(0, 3).join(', ')}`);
-    }
-    if (recentDecisions.length > 0) {
-        contextParts.push(`\n🔄 Recent decisions: ${recentDecisions.slice(0, 2).join(', ')}`);
-    }
-    contextParts.push('\n💡 Use chroma_query_documents(["keywords"]) to find related work or chroma_get_documents(["document_id"]) to load specific content');
-    return {
-        continue: true,
-        suppressOutput: true,
-        hookSpecificOutput: {
-            hookEventName: 'SessionStart',
-            additionalContext: contextParts.join('')
-        }
-    };
-}
-// =============================================================================
-// PRE-TOOL USE HOOK TEMPLATES
-// =============================================================================
-/**
- * Creates a pre-tool use response that allows the tool to execute
- */
-export function createPreToolUseAllowResponse(reason) {
-    return {
-        continue: true,
-        suppressOutput: true,
-        permissionDecision: 'allow',
-        permissionDecisionReason: reason
-    };
-}
-/**
- * Creates a pre-tool use response that blocks the tool execution
- */
-export function createPreToolUseDenyResponse(reason) {
-    return {
-        continue: false,
-        stopReason: reason,
-        suppressOutput: true,
-        permissionDecision: 'deny',
-        permissionDecisionReason: reason
-    };
-}
-/**
- * Creates a pre-tool use response that asks for user confirmation
- */
-export function createPreToolUseAskResponse(reason) {
-    return {
-        continue: true,
-        suppressOutput: false, // Show output so user can see the question
-        permissionDecision: 'ask',
-        permissionDecisionReason: reason
-    };
-}
-// =============================================================================
-// GENERIC HOOK RESPONSE TEMPLATES
-// =============================================================================
-/**
- * Creates a basic success response for any hook type
- */
-export function createHookSuccessResponse(suppressOutput = true) {
-    return {
-        continue: true,
-        suppressOutput
-    };
-}
-/**
- * Creates a basic error response for any hook type
- */
-export function createHookErrorResponse(reason, suppressOutput = true) {
-    return {
-        continue: false,
-        stopReason: reason,
-        suppressOutput
-    };
-}
-/**
- * Creates a response with system message (warning/info for user)
- */
-export function createHookSystemMessageResponse(message, continueProcessing = true) {
-    return {
-        continue: continueProcessing,
-        suppressOutput: true,
-        systemMessage: message
-    };
-}
-// =============================================================================
-// OPERATION STATUS TEMPLATES
-// =============================================================================
-/**
- * Templates for different types of operation status messages
- */
-export const OPERATION_STATUS_TEMPLATES = {
-    // Compression operations
-    COMPRESSION_STARTED: 'Starting memory compression...',
-    COMPRESSION_ANALYZING: 'Analyzing transcript content...',
-    COMPRESSION_EXTRACTING: 'Extracting memories and connections...',
-    COMPRESSION_SAVING: 'Saving compressed memories...',
-    COMPRESSION_COMPLETE: (count, duration) => `Memory compression complete. Extracted ${count} memories${duration ? ` in ${Math.round(duration / 1000)}s` : ''}`,
-    // Context loading operations
-    CONTEXT_LOADING: 'Loading previous session context...',
-    CONTEXT_SEARCHING: 'Searching for relevant memories...',
-    CONTEXT_FORMATTING: 'Organizing context for display...',
-    CONTEXT_LOADED: (count) => `Context loaded successfully. Found ${count} relevant memories`,
-    CONTEXT_EMPTY: 'No previous context found. Starting fresh session',
-    // Tool operations
-    TOOL_CHECKING: (toolName) => `Checking permissions for ${toolName}...`,
-    TOOL_ALLOWED: (toolName) => `✅ ${toolName} execution approved`,
-    TOOL_BLOCKED: (toolName, reason) => `❌ ${toolName} blocked: ${reason}`,
-    // General operations
-    OPERATION_STARTING: (operation) => `Starting ${operation}...`,
-    OPERATION_PROGRESS: (operation, current, total) => `${operation}: ${current}/${total} (${Math.round((current / total) * 100)}%)`,
-    OPERATION_COMPLETE: (operation) => `✅ ${operation} completed successfully`,
-    OPERATION_FAILED: (operation, error) => `❌ ${operation} failed: ${error}`
-};
-/**
- * Creates a progress message for long-running operations
- */
-export function createProgressMessage(operation, progress) {
-    const { current, total, currentStep, estimatedRemaining } = progress;
-    const percentage = Math.round((current / total) * 100);
-    let message = `${operation}: ${current}/${total} (${percentage}%)`;
-    if (currentStep) {
-        message += ` - ${currentStep}`;
-    }
-    if (estimatedRemaining && estimatedRemaining > 1000) {
-        const seconds = Math.round(estimatedRemaining / 1000);
-        message += ` (${seconds}s remaining)`;
-    }
-    return message;
-}
-// =============================================================================
-// ERROR RESPONSE TEMPLATES
-// =============================================================================
-/**
- * Standard error messages for different failure scenarios
- */
-export const ERROR_RESPONSE_TEMPLATES = {
-    // File system errors
-    FILE_NOT_FOUND: (path) => `File not found: ${path}`,
-    FILE_READ_ERROR: (path, error) => `Failed to read ${path}: ${error}`,
-    FILE_WRITE_ERROR: (path, error) => `Failed to write ${path}: ${error}`,
-    // Network/connection errors
-    CONNECTION_FAILED: (service) => `Failed to connect to ${service}`,
-    CONNECTION_TIMEOUT: (service) => `Connection to ${service} timed out`,
-    // Validation errors
-    INVALID_PAYLOAD: (field) => `Invalid or missing field: ${field}`,
-    INVALID_FORMAT: (expected, received) => `Expected ${expected}, received ${received}`,
-    // Operation errors
-    OPERATION_TIMEOUT: (operation, timeout) => `${operation} timed out after ${timeout}ms`,
-    OPERATION_CANCELLED: (operation) => `${operation} was cancelled`,
-    INSUFFICIENT_PERMISSIONS: (operation) => `Insufficient permissions for ${operation}`,
-    // Memory system errors
-    MEMORY_SYSTEM_UNAVAILABLE: 'Memory system is not available',
-    MEMORY_CORRUPTION: 'Memory index appears to be corrupted',
-    MEMORY_SEARCH_FAILED: (query) => `Memory search failed for query: "${query}"`,
-    // Compression errors
-    COMPRESSION_FAILED: (stage) => `Compression failed during ${stage}`,
-    INVALID_TRANSCRIPT: 'Transcript file is invalid or corrupted',
-    // General errors
-    UNKNOWN_ERROR: (context) => `An unexpected error occurred during ${context}`,
-    SYSTEM_ERROR: (error) => `System error: ${error}`
-};
-/**
- * Creates a standardized error response with troubleshooting guidance
- */
-export function createDetailedErrorResponse(operation, error, troubleshootingSteps = []) {
-    const baseMessage = `${operation} failed: ${error}`;
-    const fullMessage = troubleshootingSteps.length > 0
-        ? `${baseMessage}\n\nTroubleshooting steps:\n${troubleshootingSteps.map(step => `• ${step}`).join('\n')}`
-        : baseMessage;
-    return {
-        continue: false,
-        stopReason: fullMessage,
-        suppressOutput: false // Show error details to user
-    };
-}
-// =============================================================================
-// HOOK RESPONSE VALIDATION
-// =============================================================================
-/**
- * Validates that a hook response conforms to Claude Code expectations
- */
-export function validateHookResponse(response, hookType) {
-    const errors = [];
-    // Check required fields
-    if (typeof response !== 'object' || response === null) {
-        errors.push('Response must be a valid JSON object');
-        return { isValid: false, errors };
-    }
-    // Validate continue field
-    if (response.continue !== undefined && typeof response.continue !== 'boolean') {
-        errors.push('continue field must be a boolean');
-    }
-    // Validate suppressOutput field
-    if (response.suppressOutput !== undefined && typeof response.suppressOutput !== 'boolean') {
-        errors.push('suppressOutput field must be a boolean');
-    }
-    // Validate stopReason field
-    if (response.stopReason !== undefined && typeof response.stopReason !== 'string') {
-        errors.push('stopReason field must be a string');
-    }
-    // Hook-specific validations
-    if (hookType === 'PreCompact') {
-        // PreCompact should not have hookSpecificOutput
-        if (response.hookSpecificOutput !== undefined) {
-            errors.push('PreCompact hooks do not support hookSpecificOutput');
-        }
-        // Validate decision field if present
-        if (response.decision !== undefined && !['approve', 'block'].includes(response.decision)) {
-            errors.push('decision field must be "approve" or "block"');
-        }
-    }
-    if (hookType === 'SessionStart') {
-        // Validate hookSpecificOutput structure
-        if (response.hookSpecificOutput) {
-            const hso = response.hookSpecificOutput;
-            if (hso.hookEventName !== 'SessionStart') {
-                errors.push('hookSpecificOutput.hookEventName must be "SessionStart"');
-            }
-            if (hso.additionalContext !== undefined && typeof hso.additionalContext !== 'string') {
-                errors.push('hookSpecificOutput.additionalContext must be a string');
-            }
-        }
-    }
-    if (hookType === 'PreToolUse') {
-        // Validate permissionDecision field
-        if (response.permissionDecision !== undefined) {
-            if (!['allow', 'deny', 'ask'].includes(response.permissionDecision)) {
-                errors.push('permissionDecision must be "allow", "deny", or "ask"');
-            }
-        }
-    }
-    return {
-        isValid: errors.length === 0,
-        errors
-    };
-}
-// =============================================================================
-// UTILITY FUNCTIONS
-// =============================================================================
-/**
- * Creates a hook response based on context and automatically handles hook-specific formatting
- */
-export function createContextualHookResponse(context) {
-    const { hookEventName, success, message, additionalData, duration, itemCount } = context;
-    // Base response
-    const response = {
-        continue: success,
-        suppressOutput: true
-    };
-    // Add failure reason if not successful
-    if (!success && message) {
-        response.stopReason = message;
-        response.suppressOutput = false; // Show error to user
-    }
-    // Handle hook-specific output
-    if (success && hookEventName === 'SessionStart' && message) {
-        return {
-            ...response,
-            hookSpecificOutput: {
-                hookEventName: 'SessionStart',
-                additionalContext: message
-            }
-        };
-    }
-    // Handle PreCompact approval
-    if (hookEventName === 'PreCompact') {
-        return {
-            ...response,
-            decision: success ? 'approve' : 'block',
-            reason: message
-        };
-    }
-    return response;
-}
-/**
- * Formats duration in milliseconds to human-readable format
- */
-export function formatDuration(milliseconds) {
-    if (milliseconds < 1000) {
-        return `${milliseconds}ms`;
-    }
-    const seconds = Math.round(milliseconds / 1000);
-    if (seconds < 60) {
-        return `${seconds}s`;
-    }
-    const minutes = Math.floor(seconds / 60);
-    const remainingSeconds = seconds % 60;
-    return remainingSeconds > 0 ? `${minutes}m ${remainingSeconds}s` : `${minutes}m`;
-}
-/**
- * Creates a summary line for operation completion
- */
-export function createOperationSummary(operation, success, duration, itemCount, details) {
-    const status = success ? '✅' : '❌';
-    const durationText = duration ? ` in ${formatDuration(duration)}` : '';
-    const itemText = itemCount ? ` (${itemCount} items)` : '';
-    const detailText = details ? ` - ${details}` : '';
-    return `${status} ${operation}${itemText}${durationText}${detailText}`;
-}

package/dist/prompts/templates/hooks/HookTemplates.test.d.ts

@@ -1,7 +0,0 @@
-/**
- * Hook Templates Test
- *
- * Basic validation tests for hook response templates to ensure they
- * generate valid responses that conform to Claude Code's hook system.
- */
-export {};

package/dist/prompts/templates/hooks/HookTemplates.test.js

@@ -1,127 +0,0 @@
-/**
- * Hook Templates Test
- *
- * Basic validation tests for hook response templates to ensure they
- * generate valid responses that conform to Claude Code's hook system.
- */
-import { createPreCompactSuccessResponse, createPreCompactBlockedResponse, createPreCompactApprovalResponse, createSessionStartSuccessResponse, createSessionStartEmptyResponse, createSessionStartErrorResponse, createSessionStartMemoryResponse, createPreToolUseAllowResponse, createPreToolUseDenyResponse, createPreToolUseAskResponse, createHookSuccessResponse, createHookErrorResponse, validateHookResponse, createContextualHookResponse, formatDuration, createOperationSummary, OPERATION_STATUS_TEMPLATES, ERROR_RESPONSE_TEMPLATES } from './HookTemplates.js';
-// =============================================================================
-// PRE-COMPACT HOOK TESTS
-// =============================================================================
-console.log('Testing Pre-Compact Hook Templates...');
-// Test successful pre-compact response
-const preCompactSuccess = createPreCompactSuccessResponse();
-console.log('✓ Pre-compact success:', JSON.stringify(preCompactSuccess, null, 2));
-// Test blocked pre-compact response
-const preCompactBlocked = createPreCompactBlockedResponse('User requested to skip compression');
-console.log('✓ Pre-compact blocked:', JSON.stringify(preCompactBlocked, null, 2));
-// Test approval response
-const preCompactApproval = createPreCompactApprovalResponse('approve', 'Compression approved by policy');
-console.log('✓ Pre-compact approval:', JSON.stringify(preCompactApproval, null, 2));
-// =============================================================================
-// SESSION START HOOK TESTS
-// =============================================================================
-console.log('\nTesting Session Start Hook Templates...');
-// Test successful session start with context
-const sessionStartSuccess = createSessionStartSuccessResponse('Loaded 5 memories from previous sessions');
-console.log('✓ Session start success:', JSON.stringify(sessionStartSuccess, null, 2));
-// Test empty session start
-const sessionStartEmpty = createSessionStartEmptyResponse();
-console.log('✓ Session start empty:', JSON.stringify(sessionStartEmpty, null, 2));
-// Test error session start
-const sessionStartError = createSessionStartErrorResponse('Memory index corrupted');
-console.log('✓ Session start error:', JSON.stringify(sessionStartError, null, 2));
-// Test rich memory response
-const sessionStartMemory = createSessionStartMemoryResponse({
-    projectName: 'claude-mem',
-    memoryCount: 12,
-    lastSessionTime: '2 hours ago',
-    recentComponents: ['PromptOrchestrator', 'HookTemplates', 'MCPClient'],
-    recentDecisions: ['Use TypeScript for type safety', 'Implement embedded Weaviate']
-});
-console.log('✓ Session start memory:', JSON.stringify(sessionStartMemory, null, 2));
-// =============================================================================
-// PRE-TOOL USE HOOK TESTS
-// =============================================================================
-console.log('\nTesting Pre-Tool Use Hook Templates...');
-// Test allow response
-const preToolAllow = createPreToolUseAllowResponse('Tool execution approved by security policy');
-console.log('✓ Pre-tool allow:', JSON.stringify(preToolAllow, null, 2));
-// Test deny response
-const preToolDeny = createPreToolUseDenyResponse('Bash commands disabled in restricted mode');
-console.log('✓ Pre-tool deny:', JSON.stringify(preToolDeny, null, 2));
-// Test ask response
-const preToolAsk = createPreToolUseAskResponse('File operation requires user confirmation');
-console.log('✓ Pre-tool ask:', JSON.stringify(preToolAsk, null, 2));
-// =============================================================================
-// GENERIC HOOK TESTS
-// =============================================================================
-console.log('\nTesting Generic Hook Templates...');
-// Test basic success
-const genericSuccess = createHookSuccessResponse(false);
-console.log('✓ Generic success:', JSON.stringify(genericSuccess, null, 2));
-// Test basic error
-const genericError = createHookErrorResponse('Operation failed due to network timeout', true);
-console.log('✓ Generic error:', JSON.stringify(genericError, null, 2));
-// =============================================================================
-// VALIDATION TESTS
-// =============================================================================
-console.log('\nTesting Hook Response Validation...');
-// Test valid PreCompact response
-const preCompactValidation = validateHookResponse(preCompactSuccess, 'PreCompact');
-console.log('✓ PreCompact validation:', preCompactValidation);
-// Test invalid PreCompact response (with hookSpecificOutput)
-const invalidPreCompact = {
-    continue: true,
-    hookSpecificOutput: { hookEventName: 'PreCompact' }
-};
-const preCompactInvalidValidation = validateHookResponse(invalidPreCompact, 'PreCompact');
-console.log('✓ PreCompact invalid validation:', preCompactInvalidValidation);
-// Test valid SessionStart response
-const sessionStartValidation = validateHookResponse(sessionStartSuccess, 'SessionStart');
-console.log('✓ SessionStart validation:', sessionStartValidation);
-// =============================================================================
-// CONTEXTUAL HOOK RESPONSE TESTS
-// =============================================================================
-console.log('\nTesting Contextual Hook Responses...');
-// Test successful session start context
-const contextualSessionStart = createContextualHookResponse({
-    hookEventName: 'SessionStart',
-    sessionId: 'test-123',
-    success: true,
-    message: 'Successfully loaded 8 memories from previous claude-mem sessions'
-});
-console.log('✓ Contextual SessionStart:', JSON.stringify(contextualSessionStart, null, 2));
-// Test failed PreCompact context
-const contextualPreCompactFail = createContextualHookResponse({
-    hookEventName: 'PreCompact',
-    sessionId: 'test-123',
-    success: false,
-    message: 'Compression blocked: insufficient disk space'
-});
-console.log('✓ Contextual PreCompact fail:', JSON.stringify(contextualPreCompactFail, null, 2));
-// =============================================================================
-// UTILITY FUNCTION TESTS
-// =============================================================================
-console.log('\nTesting Utility Functions...');
-// Test duration formatting
-console.log('✓ Duration 500ms:', formatDuration(500));
-console.log('✓ Duration 5s:', formatDuration(5000));
-console.log('✓ Duration 90s:', formatDuration(90000));
-console.log('✓ Duration 2m30s:', formatDuration(150000));
-// Test operation summary
-console.log('✓ Operation summary success:', createOperationSummary('Memory compression', true, 5000, 15, 'entities extracted'));
-console.log('✓ Operation summary failure:', createOperationSummary('Context loading', false, 2000, 0, 'connection timeout'));
-// =============================================================================
-// TEMPLATE CONSTANT TESTS
-// =============================================================================
-console.log('\nTesting Template Constants...');
-// Test operation status templates
-console.log('✓ Compression complete:', OPERATION_STATUS_TEMPLATES.COMPRESSION_COMPLETE(25, 5000));
-console.log('✓ Context loaded:', OPERATION_STATUS_TEMPLATES.CONTEXT_LOADED(8));
-console.log('✓ Tool allowed:', OPERATION_STATUS_TEMPLATES.TOOL_ALLOWED('Bash'));
-// Test error response templates
-console.log('✓ File not found:', ERROR_RESPONSE_TEMPLATES.FILE_NOT_FOUND('/path/to/transcript.txt'));
-console.log('✓ Connection failed:', ERROR_RESPONSE_TEMPLATES.CONNECTION_FAILED('MCP memory server'));
-console.log('✓ Operation timeout:', ERROR_RESPONSE_TEMPLATES.OPERATION_TIMEOUT('compression', 30000));
-console.log('\n✅ All hook template tests completed successfully!');

package/dist/shared/config.d.ts

@@ -1,4 +0,0 @@
-export declare const PACKAGE_NAME: string;
-export declare const PACKAGE_VERSION: string;
-export declare const PACKAGE_DESCRIPTION: string;
-export declare const CLI_NAME: string;

package/dist/shared/config.js

@@ -1,41 +0,0 @@
-import { readFileSync, existsSync } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-// <Block> 5.1 ====================================
-// Default values for compiled binaries
-const DEFAULT_PACKAGE_NAME = 'claude-mem';
-const DEFAULT_PACKAGE_VERSION = '3.1.5';
-const DEFAULT_PACKAGE_DESCRIPTION = 'Memory compression system for Claude Code - persist context across sessions';
-let packageName = DEFAULT_PACKAGE_NAME;
-let packageVersion = DEFAULT_PACKAGE_VERSION;
-let packageDescription = DEFAULT_PACKAGE_DESCRIPTION;
-// </Block> =======================================
-// Try to read package.json if it exists (for development)
-// <Block> 5.2 ====================================
-try {
-    const __filename = fileURLToPath(import.meta.url);
-    const __dirname = dirname(__filename);
-    const packageJsonPath = join(__dirname, '..', 'package.json');
-    // <Block> 5.2a ====================================
-    if (existsSync(packageJsonPath)) {
-        const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
-        // <Block> 5.2b ====================================
-        packageName = packageJson.name || DEFAULT_PACKAGE_NAME;
-        packageVersion = packageJson.version || DEFAULT_PACKAGE_VERSION;
-        packageDescription = packageJson.description || DEFAULT_PACKAGE_DESCRIPTION;
-        // </Block> =======================================
-    }
-    // </Block> =======================================
-}
-catch {
-    // Use defaults if package.json can't be read (compiled binary)
-}
-// </Block> =======================================
-// <Block> 5.3 ====================================
-// Export package configuration
-export const PACKAGE_NAME = packageName;
-export const PACKAGE_VERSION = packageVersion;
-export const PACKAGE_DESCRIPTION = packageDescription;
-// Export commonly used names
-export const CLI_NAME = PACKAGE_NAME; // The CLI command name
-// </Block> =======================================

package/dist/shared/error-handler.d.ts

@@ -1,22 +0,0 @@
-export declare class ErrorHandler {
-    private logger;
-    private logDir;
-    constructor(enableDebug?: boolean);
-    private ensureLogDirectory;
-    handleHookError(error: Error, hookType: string, payload?: unknown): never;
-    handleCompressionError(error: Error, transcriptPath: string, stage: string): never;
-    handleValidationError(message: string, context?: Record<string, unknown>): never;
-    logSuccess(operation: string, details?: Record<string, unknown>): void;
-    logWarning(message: string, details?: Record<string, unknown>): void;
-    logDebug(message: string, details?: Record<string, unknown>): void;
-}
-export declare function parseStdinJson<T = unknown>(input: string): T;
-export declare function safeExecute<T>(operation: () => Promise<T>, errorHandler: ErrorHandler, context: string): Promise<T>;
-export declare function validateFileExists(filePath: string, errorHandler: ErrorHandler): void;
-/**
- * Creates a standardized hook response using HookTemplates
- * @deprecated Use HookTemplates.createHookSuccessResponse or createHookErrorResponse instead
- * This function is maintained for backward compatibility but should be replaced with HookTemplates.
- */
-export declare function createHookResponse(success: boolean, data?: Record<string, unknown>): string;
-export declare const globalErrorHandler: ErrorHandler;