moflo 4.8.31 → 4.8.32

package/src/@claude-flow/shared/dist/hooks/executor.d.ts

@@ -1,100 +0,0 @@
-/**
- * V3 Hooks System - Hook Executor
- *
- * Executes hooks in priority order with timeout handling and error recovery.
- * Integrates with event bus for coordination and monitoring.
- *
- * @module v3/shared/hooks/executor
- */
-import type { IEventBus } from '../core/interfaces/event.interface.js';
-import { HookRegistry } from './registry.js';
-import { HookEvent, HookContext, HookResult, HookExecutionOptions } from './types.js';
-/**
- * Hook execution result aggregation
- */
-export interface AggregatedHookResult {
-    /** Whether all hooks succeeded */
-    success: boolean;
-    /** Individual hook results */
-    results: HookResult[];
-    /** Total execution time in ms */
-    totalExecutionTime: number;
-    /** Number of hooks executed */
-    hooksExecuted: number;
-    /** Number of hooks failed */
-    hooksFailed: number;
-    /** Whether operation was aborted */
-    aborted: boolean;
-    /** Final merged context (from all hooks) */
-    finalContext?: Partial<HookContext>;
-}
-/**
- * Hook executor implementation
- */
-export declare class HookExecutor {
-    private registry;
-    private eventBus?;
-    constructor(registry: HookRegistry, eventBus?: IEventBus);
-    /**
-     * Execute all hooks for an event
-     *
-     * @param event - Hook event type
-     * @param context - Hook context
-     * @param options - Execution options
-     * @returns Aggregated results
-     */
-    execute(event: HookEvent, context: HookContext, options?: HookExecutionOptions): Promise<AggregatedHookResult>;
-    /**
-     * Execute hooks with timeout
-     *
-     * @param event - Hook event type
-     * @param context - Hook context
-     * @param timeout - Timeout in ms
-     * @returns Aggregated results
-     */
-    executeWithTimeout(event: HookEvent, context: HookContext, timeout: number): Promise<AggregatedHookResult>;
-    /**
-     * Execute a single hook with timeout and error handling
-     *
-     * @param handler - Hook handler function
-     * @param context - Hook context
-     * @param timeout - Optional timeout in ms
-     * @returns Hook result
-     */
-    private executeSingleHook;
-    /**
-     * Execute multiple hooks in parallel
-     *
-     * @param events - Array of hook events
-     * @param contexts - Array of contexts (matched by index)
-     * @param options - Execution options
-     * @returns Array of aggregated results
-     */
-    executeParallel(events: HookEvent[], contexts: HookContext[], options?: HookExecutionOptions): Promise<AggregatedHookResult[]>;
-    /**
-     * Execute hooks sequentially with context chaining
-     *
-     * @param events - Array of hook events
-     * @param initialContext - Initial context
-     * @param options - Execution options
-     * @returns Final aggregated result with chained context
-     */
-    executeSequential(events: HookEvent[], initialContext: HookContext, options?: HookExecutionOptions): Promise<AggregatedHookResult>;
-    /**
-     * Wrap a promise with timeout
-     */
-    private withTimeout;
-    /**
-     * Set event bus for coordination
-     */
-    setEventBus(eventBus: IEventBus): void;
-    /**
-     * Get hook registry
-     */
-    getRegistry(): HookRegistry;
-}
-/**
- * Create a new hook executor
- */
-export declare function createHookExecutor(registry: HookRegistry, eventBus?: IEventBus): HookExecutor;
-//# sourceMappingURL=executor.d.ts.map

package/src/@claude-flow/shared/dist/hooks/hooks.test.d.ts

@@ -1,9 +0,0 @@
-/**
- * V3 Hooks System - Tests
- *
- * Comprehensive tests for hook registry and executor.
- *
- * @module v3/shared/hooks/hooks.test
- */
-export {};
-//# sourceMappingURL=hooks.test.d.ts.map

package/src/@claude-flow/shared/dist/hooks/index.d.ts

@@ -1,52 +0,0 @@
-/**
- * V3 Hooks System - Main Export
- *
- * Provides extensible hook points for tool execution, file operations,
- * and session lifecycle events. Integrates with event bus for coordination.
- *
- * Example usage:
- *
- * ```typescript
- * import { createHookRegistry, createHookExecutor, HookEvent, HookPriority } from '@claude-flow/shared/hooks';
- *
- * const registry = createHookRegistry();
- * const executor = createHookExecutor(registry, eventBus);
- *
- * // Register a hook
- * const hookId = registry.register(
- *   HookEvent.PreToolUse,
- *   async (context) => {
- *     console.log('Before tool use:', context.tool?.name);
- *     return { success: true };
- *   },
- *   HookPriority.High
- * );
- *
- * // Execute hooks
- * const result = await executor.execute(
- *   HookEvent.PreToolUse,
- *   {
- *     event: HookEvent.PreToolUse,
- *     timestamp: new Date(),
- *     tool: { name: 'Read', parameters: { path: 'file.ts' } }
- *   }
- * );
- *
- * // Unregister hook
- * registry.unregister(hookId);
- * ```
- *
- * @module v3/shared/hooks
- */
-export type { HookContext, HookResult, HookHandler, HookDefinition, HookStats, HookExecutionOptions, ToolInfo, CommandInfo, FileOperationInfo, SessionInfo, AgentInfo, TaskInfo, MemoryInfo, ErrorInfo, } from './types.js';
-export { HookEvent, HookPriority, } from './types.js';
-export { HookRegistry, createHookRegistry, } from './registry.js';
-export type { AggregatedHookResult, } from './executor.js';
-export { HookExecutor, createHookExecutor, } from './executor.js';
-export { TaskHooksManager, createTaskHooksManager, } from './task-hooks.js';
-export type { PreTaskHookResult, PostTaskHookResult, AgentSuggestion, TaskPattern, TaskOutcome, LearningUpdate, } from './task-hooks.js';
-export { SessionHooksManager, createSessionHooksManager, InMemorySessionStorage, } from './session-hooks.js';
-export type { SessionState, SessionEndHookResult, SessionRestoreHookResult, SessionSummary, SessionStorage, } from './session-hooks.js';
-export { BashSafetyHook, createBashSafetyHook, FileOrganizationHook, createFileOrganizationHook, GitCommitHook, createGitCommitHook, } from './safety/index.js';
-export type { BashSafetyResult, CommandRisk, FileOrganizationResult, FormatterRecommendation, LinterRecommendation, OrganizationIssue, GitCommitResult, CommitType, CommitValidationIssue, } from './safety/index.js';
-//# sourceMappingURL=index.d.ts.map

package/src/@claude-flow/shared/dist/hooks/registry.d.ts

@@ -1,133 +0,0 @@
-/**
- * V3 Hooks System - Hook Registry
- *
- * Central registry for managing hook definitions and lifecycle.
- * Provides registration, unregistration, and discovery of hooks.
- *
- * @module v3/shared/hooks/registry
- */
-import { HookEvent, HookPriority, HookHandler, HookDefinition, HookStats } from './types.js';
-/**
- * Hook registry implementation
- */
-export declare class HookRegistry {
-    private hooks;
-    private hooksById;
-    private hookIdCounter;
-    private stats;
-    /**
-     * Register a new hook
-     *
-     * @param event - Hook event type
-     * @param handler - Hook handler function
-     * @param priority - Hook priority (default: Normal)
-     * @param options - Additional hook options
-     * @returns Hook ID for later unregistration
-     */
-    register(event: HookEvent, handler: HookHandler, priority?: HookPriority, options?: {
-        name?: string;
-        timeout?: number;
-        enabled?: boolean;
-        metadata?: Record<string, unknown>;
-    }): string;
-    /**
-     * Unregister a hook by ID
-     *
-     * @param hookId - Hook ID to unregister
-     * @returns Whether hook was found and removed
-     */
-    unregister(hookId: string): boolean;
-    /**
-     * Unregister all hooks for an event
-     *
-     * @param event - Event type to clear hooks for
-     * @returns Number of hooks removed
-     */
-    unregisterAll(event?: HookEvent): number;
-    /**
-     * Get all hooks for a specific event (sorted by priority)
-     *
-     * @param event - Event type
-     * @param includeDisabled - Whether to include disabled hooks
-     * @returns Array of hook definitions
-     */
-    getHandlers(event: HookEvent, includeDisabled?: boolean): HookDefinition[];
-    /**
-     * Get a hook by ID
-     *
-     * @param hookId - Hook ID
-     * @returns Hook definition or undefined
-     */
-    getHook(hookId: string): HookDefinition | undefined;
-    /**
-     * Enable a hook
-     *
-     * @param hookId - Hook ID
-     * @returns Whether hook was found and enabled
-     */
-    enable(hookId: string): boolean;
-    /**
-     * Disable a hook
-     *
-     * @param hookId - Hook ID
-     * @returns Whether hook was found and disabled
-     */
-    disable(hookId: string): boolean;
-    /**
-     * List all registered hooks
-     *
-     * @param filter - Optional filter options
-     * @returns Array of hook definitions
-     */
-    listHooks(filter?: {
-        event?: HookEvent;
-        enabled?: boolean;
-        minPriority?: HookPriority;
-    }): HookDefinition[];
-    /**
-     * Get all event types with registered hooks
-     *
-     * @returns Array of event types
-     */
-    getEventTypes(): HookEvent[];
-    /**
-     * Get count of hooks for an event
-     *
-     * @param event - Event type (optional)
-     * @returns Hook count
-     */
-    count(event?: HookEvent): number;
-    /**
-     * Record hook execution statistics
-     *
-     * @param success - Whether execution succeeded
-     * @param executionTime - Execution time in ms
-     */
-    recordExecution(success: boolean, executionTime: number): void;
-    /**
-     * Get hook statistics
-     *
-     * @returns Hook statistics
-     */
-    getStats(): HookStats;
-    /**
-     * Reset statistics
-     */
-    resetStats(): void;
-    /**
-     * Check if a hook exists
-     *
-     * @param hookId - Hook ID
-     * @returns Whether hook exists
-     */
-    has(hookId: string): boolean;
-    /**
-     * Clear all hooks and reset state
-     */
-    clear(): void;
-}
-/**
- * Create a new hook registry
- */
-export declare function createHookRegistry(): HookRegistry;
-//# sourceMappingURL=registry.d.ts.map

package/src/@claude-flow/shared/dist/hooks/safety/bash-safety.d.ts

@@ -1,105 +0,0 @@
-/**
- * V3 Bash Safety Hook
- *
- * TypeScript conversion of V2 bash-hook.sh.
- * Provides command safety analysis, dangerous command detection,
- * secret detection, and safe alternatives.
- *
- * @module v3/shared/hooks/safety/bash-safety
- */
-import { HookContext, HookResult } from '../types.js';
-import { HookRegistry } from '../registry.js';
-/**
- * Bash safety hook result
- */
-export interface BashSafetyResult extends HookResult {
-    /** Risk level assessment */
-    riskLevel: 'low' | 'medium' | 'high' | 'critical';
-    /** Whether the command should be blocked */
-    blocked: boolean;
-    /** Reason for blocking (if blocked) */
-    blockReason?: string;
-    /** Modified command (if applicable) */
-    modifiedCommand?: string;
-    /** Detected risks */
-    risks: CommandRisk[];
-    /** Safe alternatives */
-    safeAlternatives?: string[];
-    /** Warnings (non-blocking) */
-    warnings?: string[];
-    /** Missing dependencies detected */
-    missingDependencies?: string[];
-    /** Redacted command (secrets removed) */
-    redactedCommand?: string;
-}
-/**
- * Command risk definition
- */
-export interface CommandRisk {
-    /** Risk type */
-    type: 'dangerous' | 'destructive' | 'secret' | 'privilege' | 'network' | 'resource';
-    /** Risk severity */
-    severity: 'low' | 'medium' | 'high' | 'critical';
-    /** Risk description */
-    description: string;
-    /** Pattern that matched */
-    pattern?: string;
-}
-/**
- * Bash Safety Hook Manager
- */
-export declare class BashSafetyHook {
-    private registry;
-    private blockedCommands;
-    private availableDependencies;
-    constructor(registry: HookRegistry);
-    /**
-     * Register bash safety hooks
-     */
-    private registerHooks;
-    /**
-     * Detect available dependencies
-     */
-    private detectAvailableDependencies;
-    /**
-     * Analyze a command for safety
-     */
-    analyzeCommand(context: HookContext): Promise<BashSafetyResult>;
-    /**
-     * Detect secrets in command
-     */
-    private detectSecrets;
-    /**
-     * Check for missing dependencies
-     */
-    private checkDependencies;
-    /**
-     * Calculate overall risk level
-     */
-    private calculateRiskLevel;
-    /**
-     * Create a result object
-     */
-    private createResult;
-    /**
-     * Manually analyze a command
-     */
-    analyze(command: string): Promise<BashSafetyResult>;
-    /**
-     * Add a custom dangerous pattern
-     */
-    addDangerousPattern(pattern: RegExp, type: CommandRisk['type'], severity: CommandRisk['severity'], description: string, block?: boolean): void;
-    /**
-     * Mark a dependency as available
-     */
-    markDependencyAvailable(dependency: string): void;
-    /**
-     * Check if a command would be blocked
-     */
-    wouldBlock(command: string): boolean;
-}
-/**
- * Create bash safety hook
- */
-export declare function createBashSafetyHook(registry: HookRegistry): BashSafetyHook;
-//# sourceMappingURL=bash-safety.d.ts.map

package/src/@claude-flow/shared/dist/hooks/safety/file-organization.d.ts

@@ -1,144 +0,0 @@
-/**
- * V3 File Organization Hook
- *
- * TypeScript conversion of V2 file-hook.sh.
- * Enforces file organization, blocks writes to root folder,
- * suggests proper directories, and recommends formatters.
- *
- * @module v3/shared/hooks/safety/file-organization
- */
-import { HookContext, HookResult } from '../types.js';
-import { HookRegistry } from '../registry.js';
-/**
- * File organization hook result
- */
-export interface FileOrganizationResult extends HookResult {
-    /** Whether the file operation should be blocked */
-    blocked: boolean;
-    /** Reason for blocking */
-    blockReason?: string;
-    /** Suggested new path */
-    suggestedPath?: string;
-    /** Suggested directory */
-    suggestedDirectory?: string;
-    /** Formatter recommendation */
-    formatter?: FormatterRecommendation;
-    /** Linter recommendation */
-    linter?: LinterRecommendation;
-    /** File type detected */
-    fileType?: string;
-    /** Warnings */
-    warnings?: string[];
-    /** Organization issues detected */
-    issues?: OrganizationIssue[];
-}
-/**
- * Formatter recommendation
- */
-export interface FormatterRecommendation {
-    /** Formatter name */
-    name: string;
-    /** Command to run */
-    command: string;
-    /** Config file to check for */
-    configFile?: string;
-    /** Whether config exists */
-    configExists?: boolean;
-}
-/**
- * Linter recommendation
- */
-export interface LinterRecommendation {
-    /** Linter name */
-    name: string;
-    /** Command to run */
-    command: string;
-    /** Config file to check for */
-    configFile?: string;
-}
-/**
- * Organization issue
- */
-export interface OrganizationIssue {
-    /** Issue type */
-    type: 'wrong-directory' | 'naming-convention' | 'missing-config' | 'root-write';
-    /** Issue severity */
-    severity: 'info' | 'warning' | 'error';
-    /** Issue description */
-    description: string;
-    /** Suggested fix */
-    suggestedFix?: string;
-}
-/**
- * File Organization Hook Manager
- */
-export declare class FileOrganizationHook {
-    private registry;
-    private projectRoot;
-    constructor(registry: HookRegistry);
-    /**
-     * Register file organization hooks
-     */
-    private registerHooks;
-    /**
-     * Analyze file operation for organization issues
-     */
-    analyzeFileOperation(context: HookContext): Promise<FileOrganizationResult>;
-    /**
-     * Check if directory is root
-     */
-    private isRootDirectory;
-    /**
-     * Normalize path for comparison
-     */
-    private normalizePath;
-    /**
-     * Get file type information
-     */
-    private getFileTypeInfo;
-    /**
-     * Check naming convention
-     */
-    private checkNamingConvention;
-    /**
-     * Get formatter recommendation
-     */
-    private getFormatterRecommendation;
-    /**
-     * Get linter recommendation
-     */
-    private getLinterRecommendation;
-    /**
-     * Create result object
-     */
-    private createResult;
-    /**
-     * Manually analyze a file path
-     */
-    analyze(filePath: string): Promise<FileOrganizationResult>;
-    /**
-     * Get suggested directory for a file
-     */
-    getSuggestedDirectory(fileName: string): string | null;
-    /**
-     * Check if a file path would be blocked
-     */
-    wouldBlock(filePath: string): boolean;
-    /**
-     * Set project root directory
-     */
-    setProjectRoot(root: string): void;
-    /**
-     * Get all formatter recommendations
-     */
-    getAllFormatters(): Record<string, FormatterRecommendation>;
-    /**
-     * Get all linter recommendations
-     */
-    getAllLinters(): Record<string, LinterRecommendation>;
-}
-/**
- * Create file organization hook
- */
-export declare function createFileOrganizationHook(registry: HookRegistry): FileOrganizationHook;
-//# sourceMappingURL=file-organization.d.ts.map

package/src/@claude-flow/shared/dist/hooks/safety/git-commit.d.ts

@@ -1,158 +0,0 @@
-/**
- * V3 Git Commit Hook
- *
- * TypeScript conversion of V2 git-commit-hook.sh.
- * Provides conventional commit formatting, JIRA ticket extraction,
- * co-author addition, and commit message validation.
- *
- * @module v3/shared/hooks/safety/git-commit
- */
-import { HookContext, HookResult } from '../types.js';
-import { HookRegistry } from '../registry.js';
-/**
- * Git commit hook result
- */
-export interface GitCommitResult extends HookResult {
-    /** Original commit message */
-    originalMessage: string;
-    /** Modified commit message */
-    modifiedMessage: string;
-    /** Detected commit type */
-    commitType?: CommitType;
-    /** Extracted ticket reference */
-    ticketReference?: string;
-    /** Whether co-author was added */
-    coAuthorAdded: boolean;
-    /** Validation issues */
-    validationIssues?: CommitValidationIssue[];
-    /** Suggestions for improvement */
-    suggestions?: string[];
-}
-/**
- * Commit type definition
- */
-export type CommitType = 'feat' | 'fix' | 'docs' | 'style' | 'refactor' | 'perf' | 'test' | 'build' | 'ci' | 'chore' | 'revert';
-/**
- * Commit validation issue
- */
-export interface CommitValidationIssue {
-    /** Issue type */
-    type: 'format' | 'length' | 'scope' | 'body' | 'breaking';
-    /** Issue severity */
-    severity: 'info' | 'warning' | 'error';
-    /** Issue description */
-    description: string;
-    /** Suggested fix */
-    suggestedFix?: string;
-}
-/**
- * Co-author configuration
- */
-interface CoAuthor {
-    name: string;
-    email: string;
-}
-/**
- * Commit message configuration
- */
-interface CommitConfig {
-    /** Maximum subject line length */
-    maxSubjectLength: number;
-    /** Maximum body line length */
-    maxBodyLength: number;
-    /** Require conventional commit format */
-    requireConventional: boolean;
-    /** Add co-author by default */
-    addCoAuthor: boolean;
-    /** Co-author to add */
-    coAuthor: CoAuthor;
-    /** Add Claude Code reference */
-    addClaudeReference: boolean;
-    /** Allowed scopes */
-    allowedScopes?: string[];
-}
-/**
- * Git Commit Hook Manager
- */
-export declare class GitCommitHook {
-    private registry;
-    private config;
-    constructor(registry: HookRegistry, config?: Partial<CommitConfig>);
-    /**
-     * Register git commit hooks
-     */
-    private registerHooks;
-    /**
-     * Handle pre-commit (when a git commit command is detected)
-     */
-    handlePreCommit(context: HookContext): Promise<HookResult>;
-    /**
-     * Process commit message
-     */
-    processCommitMessage(message: string, branchName?: string): Promise<GitCommitResult>;
-    /**
-     * Parse commit message into parts
-     */
-    private parseMessage;
-    /**
-     * Detect commit type from message
-     */
-    private detectCommitType;
-    /**
-     * Check if message has conventional commit prefix
-     */
-    private hasConventionalPrefix;
-    /**
-     * Lowercase first letter of a string
-     */
-    private lowercaseFirstLetter;
-    /**
-     * Extract ticket reference from branch name
-     */
-    private extractTicket;
-    /**
-     * Add ticket reference to message
-     */
-    private addTicketReference;
-    /**
-     * Validate conventional commit format
-     */
-    private validateConventional;
-    /**
-     * Process commit message manually
-     */
-    process(message: string, branchName?: string): Promise<GitCommitResult>;
-    /**
-     * Format a commit message with heredoc-style for git
-     */
-    formatForGit(message: string): string;
-    /**
-     * Generate a commit command with formatted message
-     */
-    generateCommitCommand(message: string): string;
-    /**
-     * Get commit type description
-     */
-    getCommitTypeDescription(type: CommitType): string;
-    /**
-     * Get all available commit types
-     */
-    getAllCommitTypes(): Array<{
-        type: CommitType;
-        description: string;
-    }>;
-    /**
-     * Update configuration
-     */
-    setConfig(config: Partial<CommitConfig>): void;
-    /**
-     * Get current configuration
-     */
-    getConfig(): CommitConfig;
-}
-/**
- * Create git commit hook
- */
-export declare function createGitCommitHook(registry: HookRegistry, config?: Partial<CommitConfig>): GitCommitHook;
-export {};
-//# sourceMappingURL=git-commit.d.ts.map