@machina.ai/cell-cli-core 1.11.0-rc1 → 1.13.0-rc2

package/dist/src/hooks/hookPlanner.js

@@ -0,0 +1,108 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { debugLogger } from '../utils/debugLogger.js';
+/**
+ * Hook planner that selects matching hooks and creates execution plans
+ */
+export class HookPlanner {
+    hookRegistry;
+    constructor(hookRegistry) {
+        this.hookRegistry = hookRegistry;
+    }
+    /**
+     * Create execution plan for a hook event
+     */
+    createExecutionPlan(eventName, context) {
+        const hookEntries = this.hookRegistry.getHooksForEvent(eventName);
+        if (hookEntries.length === 0) {
+            return null;
+        }
+        // Filter hooks by matcher
+        const matchingEntries = hookEntries.filter((entry) => this.matchesContext(entry, context));
+        if (matchingEntries.length === 0) {
+            return null;
+        }
+        // Deduplicate identical hooks
+        const deduplicatedEntries = this.deduplicateHooks(matchingEntries);
+        // Extract hook configs
+        const hookConfigs = deduplicatedEntries.map((entry) => entry.config);
+        // Determine execution strategy - if ANY hook definition has sequential=true, run all sequentially
+        const sequential = deduplicatedEntries.some((entry) => entry.sequential === true);
+        const plan = {
+            eventName,
+            hookConfigs,
+            sequential,
+        };
+        debugLogger.debug(`Created execution plan for ${eventName}: ${hookConfigs.length} hook(s) to execute ${sequential ? 'sequentially' : 'in parallel'}`);
+        return plan;
+    }
+    /**
+     * Check if a hook entry matches the given context
+     */
+    matchesContext(entry, context) {
+        if (!entry.matcher || !context) {
+            return true; // No matcher means match all
+        }
+        const matcher = entry.matcher.trim();
+        if (matcher === '' || matcher === '*') {
+            return true; // Empty string or wildcard matches all
+        }
+        // For tool events, match against tool name
+        if (context.toolName) {
+            return this.matchesToolName(matcher, context.toolName);
+        }
+        // For other events, match against trigger/source
+        if (context.trigger) {
+            return this.matchesTrigger(matcher, context.trigger);
+        }
+        return true;
+    }
+    /**
+     * Match tool name against matcher pattern
+     */
+    matchesToolName(matcher, toolName) {
+        try {
+            // Attempt to treat the matcher as a regular expression.
+            const regex = new RegExp(matcher);
+            return regex.test(toolName);
+        }
+        catch {
+            // If it's not a valid regex, treat it as a literal string for an exact match.
+            return matcher === toolName;
+        }
+    }
+    /**
+     * Match trigger/source against matcher pattern
+     */
+    matchesTrigger(matcher, trigger) {
+        return matcher === trigger;
+    }
+    /**
+     * Deduplicate identical hook configurations
+     */
+    deduplicateHooks(entries) {
+        const seen = new Set();
+        const deduplicated = [];
+        for (const entry of entries) {
+            const key = this.getHookKey(entry);
+            if (!seen.has(key)) {
+                seen.add(key);
+                deduplicated.push(entry);
+            }
+            else {
+                debugLogger.debug(`Deduplicated hook: ${key}`);
+            }
+        }
+        return deduplicated;
+    }
+    /**
+     * Generate a unique key for a hook entry
+     */
+    getHookKey(entry) {
+        return `command:${entry.config.command}`;
+    }
+}
+//# sourceMappingURL=hookPlanner.js.map

package/dist/src/hooks/hookPlanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hookPlanner.js","sourceRoot":"","sources":["../../../src/hooks/hookPlanner.ts"],"names":[],"mappings":"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"}

package/dist/src/hooks/hookPlanner.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/hooks/hookPlanner.test.js

@@ -0,0 +1,255 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { HookPlanner } from './hookPlanner.js';
+import { HookEventName, HookType } from './types.js';
+import { ConfigSource } from './hookRegistry.js';
+// Mock debugLogger using vi.hoisted
+const mockDebugLogger = vi.hoisted(() => ({
+    log: vi.fn(),
+    warn: vi.fn(),
+    error: vi.fn(),
+    debug: vi.fn(),
+}));
+vi.mock('../utils/debugLogger.js', () => ({
+    debugLogger: mockDebugLogger,
+}));
+describe('HookPlanner', () => {
+    let hookPlanner;
+    let mockHookRegistry;
+    beforeEach(() => {
+        vi.resetAllMocks();
+        mockHookRegistry = {
+            getHooksForEvent: vi.fn(),
+        };
+        hookPlanner = new HookPlanner(mockHookRegistry);
+    });
+    describe('createExecutionPlan', () => {
+        it('should return empty plan when no hooks registered', () => {
+            vi.mocked(mockHookRegistry.getHooksForEvent).mockReturnValue([]);
+            const plan = hookPlanner.createExecutionPlan(HookEventName.BeforeTool);
+            expect(plan).toBeNull();
+        });
+        it('should create plan for hooks without matchers', () => {
+            const mockEntries = [
+                {
+                    config: { type: HookType.Command, command: './hook1.sh' },
+                    source: ConfigSource.Project,
+                    eventName: HookEventName.BeforeTool,
+                    enabled: true,
+                },
+                {
+                    config: {
+                        type: HookType.Command,
+                        command: './test-hook.sh',
+                    },
+                    source: ConfigSource.User,
+                    eventName: HookEventName.BeforeTool,
+                    enabled: true,
+                },
+            ];
+            vi.mocked(mockHookRegistry.getHooksForEvent).mockReturnValue(mockEntries);
+            const plan = hookPlanner.createExecutionPlan(HookEventName.BeforeTool);
+            expect(plan).not.toBeNull();
+            expect(plan.hookConfigs).toHaveLength(2);
+            expect(plan.hookConfigs[0].command).toBe('./hook1.sh');
+            expect(plan.hookConfigs[1].command).toBe('./test-hook.sh');
+        });
+        it('should filter hooks by tool name matcher', () => {
+            const mockEntries = [
+                {
+                    config: { type: HookType.Command, command: './edit_hook.sh' },
+                    source: ConfigSource.Project,
+                    eventName: HookEventName.BeforeTool,
+                    matcher: 'EditTool',
+                    enabled: true,
+                },
+                {
+                    config: { type: HookType.Command, command: './general_hook.sh' },
+                    source: ConfigSource.Project,
+                    eventName: HookEventName.BeforeTool,
+                    enabled: true,
+                },
+            ];
+            vi.mocked(mockHookRegistry.getHooksForEvent).mockReturnValue(mockEntries);
+            // Test with EditTool context
+            const plan = hookPlanner.createExecutionPlan(HookEventName.BeforeTool, {
+                toolName: 'EditTool',
+            });
+            expect(plan).not.toBeNull();
+            expect(plan.hookConfigs).toHaveLength(2); // Both should match (one specific, one general)
+        });
+        it('should filter hooks by regex matcher', () => {
+            const mockEntries = [
+                {
+                    config: { type: HookType.Command, command: './edit_hook.sh' },
+                    source: ConfigSource.Project,
+                    eventName: HookEventName.BeforeTool,
+                    matcher: 'Edit|Write',
+                    enabled: true,
+                },
+                {
+                    config: { type: HookType.Command, command: './read_hook.sh' },
+                    source: ConfigSource.Project,
+                    eventName: HookEventName.BeforeTool,
+                    matcher: 'ReadTool',
+                    enabled: true,
+                },
+            ];
+            vi.mocked(mockHookRegistry.getHooksForEvent).mockReturnValue(mockEntries);
+            // Test with EditTool - should match first hook
+            const editPlan = hookPlanner.createExecutionPlan(HookEventName.BeforeTool, { toolName: 'EditTool' });
+            expect(editPlan).not.toBeNull();
+            expect(editPlan.hookConfigs).toHaveLength(1);
+            expect(editPlan.hookConfigs[0].command).toBe('./edit_hook.sh');
+            // Test with WriteTool - should match first hook
+            const writePlan = hookPlanner.createExecutionPlan(HookEventName.BeforeTool, { toolName: 'WriteTool' });
+            expect(writePlan).not.toBeNull();
+            expect(writePlan.hookConfigs).toHaveLength(1);
+            expect(writePlan.hookConfigs[0].command).toBe('./edit_hook.sh');
+            // Test with ReadTool - should match second hook
+            const readPlan = hookPlanner.createExecutionPlan(HookEventName.BeforeTool, { toolName: 'ReadTool' });
+            expect(readPlan).not.toBeNull();
+            expect(readPlan.hookConfigs).toHaveLength(1);
+            expect(readPlan.hookConfigs[0].command).toBe('./read_hook.sh');
+            // Test with unmatched tool - should match no hooks
+            const otherPlan = hookPlanner.createExecutionPlan(HookEventName.BeforeTool, { toolName: 'OtherTool' });
+            expect(otherPlan).toBeNull();
+        });
+        it('should handle wildcard matcher', () => {
+            const mockEntries = [
+                {
+                    config: { type: HookType.Command, command: './wildcard_hook.sh' },
+                    source: ConfigSource.Project,
+                    eventName: HookEventName.BeforeTool,
+                    matcher: '*',
+                    enabled: true,
+                },
+            ];
+            vi.mocked(mockHookRegistry.getHooksForEvent).mockReturnValue(mockEntries);
+            const plan = hookPlanner.createExecutionPlan(HookEventName.BeforeTool, {
+                toolName: 'AnyTool',
+            });
+            expect(plan).not.toBeNull();
+            expect(plan.hookConfigs).toHaveLength(1);
+        });
+        it('should handle empty string matcher', () => {
+            const mockEntries = [
+                {
+                    config: {
+                        type: HookType.Command,
+                        command: './empty_matcher_hook.sh',
+                    },
+                    source: ConfigSource.Project,
+                    eventName: HookEventName.BeforeTool,
+                    matcher: '',
+                    enabled: true,
+                },
+            ];
+            vi.mocked(mockHookRegistry.getHooksForEvent).mockReturnValue(mockEntries);
+            const plan = hookPlanner.createExecutionPlan(HookEventName.BeforeTool, {
+                toolName: 'AnyTool',
+            });
+            expect(plan).not.toBeNull();
+            expect(plan.hookConfigs).toHaveLength(1);
+        });
+        it('should handle invalid regex matcher gracefully', () => {
+            const mockEntries = [
+                {
+                    config: {
+                        type: HookType.Command,
+                        command: './invalid_regex_hook.sh',
+                    },
+                    source: ConfigSource.Project,
+                    eventName: HookEventName.BeforeTool,
+                    matcher: '[invalid-regex',
+                    enabled: true,
+                },
+            ];
+            vi.mocked(mockHookRegistry.getHooksForEvent).mockReturnValue(mockEntries);
+            // Should match when toolName exactly equals the invalid regex pattern
+            const plan = hookPlanner.createExecutionPlan(HookEventName.BeforeTool, {
+                toolName: '[invalid-regex',
+            });
+            expect(plan).not.toBeNull();
+            expect(plan.hookConfigs).toHaveLength(1); // Should fall back to exact match
+            // Should not match when toolName doesn't exactly equal the pattern
+            const planNoMatch = hookPlanner.createExecutionPlan(HookEventName.BeforeTool, {
+                toolName: 'other-tool',
+            });
+            expect(planNoMatch).toBeNull();
+        });
+        it('should deduplicate identical hooks', () => {
+            const mockEntries = [
+                {
+                    config: { type: HookType.Command, command: './same_hook.sh' },
+                    source: ConfigSource.Project,
+                    eventName: HookEventName.BeforeTool,
+                    enabled: true,
+                },
+                {
+                    config: { type: HookType.Command, command: './same_hook.sh' },
+                    source: ConfigSource.User,
+                    eventName: HookEventName.BeforeTool,
+                    enabled: true,
+                },
+                {
+                    config: {
+                        type: HookType.Command,
+                        command: './test-hook.sh',
+                    },
+                    source: ConfigSource.Project,
+                    eventName: HookEventName.BeforeTool,
+                    enabled: true,
+                },
+                {
+                    config: {
+                        type: HookType.Command,
+                        command: './test-hook.sh',
+                    },
+                    source: ConfigSource.User,
+                    eventName: HookEventName.BeforeTool,
+                    enabled: true,
+                },
+            ];
+            vi.mocked(mockHookRegistry.getHooksForEvent).mockReturnValue(mockEntries);
+            const plan = hookPlanner.createExecutionPlan(HookEventName.BeforeTool);
+            expect(plan).not.toBeNull();
+            expect(plan.hookConfigs).toHaveLength(2); // Should be deduplicated to 2 unique hooks
+            expect(mockDebugLogger.debug).toHaveBeenCalledWith(expect.stringContaining('Deduplicated hook'));
+        });
+        it('should match trigger for session events', () => {
+            const mockEntries = [
+                {
+                    config: { type: HookType.Command, command: './startup_hook.sh' },
+                    source: ConfigSource.Project,
+                    eventName: HookEventName.SessionStart,
+                    matcher: 'startup',
+                    enabled: true,
+                },
+                {
+                    config: { type: HookType.Command, command: './resume_hook.sh' },
+                    source: ConfigSource.Project,
+                    eventName: HookEventName.SessionStart,
+                    matcher: 'resume',
+                    enabled: true,
+                },
+            ];
+            vi.mocked(mockHookRegistry.getHooksForEvent).mockReturnValue(mockEntries);
+            // Test startup trigger
+            const startupPlan = hookPlanner.createExecutionPlan(HookEventName.SessionStart, { trigger: 'startup' });
+            expect(startupPlan).not.toBeNull();
+            expect(startupPlan.hookConfigs).toHaveLength(1);
+            expect(startupPlan.hookConfigs[0].command).toBe('./startup_hook.sh');
+            // Test resume trigger
+            const resumePlan = hookPlanner.createExecutionPlan(HookEventName.SessionStart, { trigger: 'resume' });
+            expect(resumePlan).not.toBeNull();
+            expect(resumePlan.hookConfigs).toHaveLength(1);
+            expect(resumePlan.hookConfigs[0].command).toBe('./resume_hook.sh');
+        });
+    });
+});
+//# sourceMappingURL=hookPlanner.test.js.map

package/dist/src/hooks/hookPlanner.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hookPlanner.test.js","sourceRoot":"","sources":["../../../src/hooks/hookPlanner.test.ts"],"names":[],"mappings":"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"}

package/dist/src/hooks/hookRegistry.d.ts

@@ -0,0 +1,87 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '../config/config.js';
+import type { HookConfig } from './types.js';
+import { HookEventName } from './types.js';
+/**
+ * Error thrown when attempting to use HookRegistry before initialization
+ */
+export declare class HookRegistryNotInitializedError extends Error {
+    constructor(message?: string);
+}
+/**
+ * Configuration source levels in precedence order (highest to lowest)
+ */
+export declare enum ConfigSource {
+    Project = "project",
+    User = "user",
+    System = "system",
+    Extensions = "extensions"
+}
+/**
+ * Hook registry entry with source information
+ */
+export interface HookRegistryEntry {
+    config: HookConfig;
+    source: ConfigSource;
+    eventName: HookEventName;
+    matcher?: string;
+    sequential?: boolean;
+    enabled: boolean;
+}
+/**
+ * Hook registry that loads and validates hook definitions from multiple sources
+ */
+export declare class HookRegistry {
+    private readonly config;
+    private entries;
+    private initialized;
+    constructor(config: Config);
+    /**
+     * Initialize the registry by processing hooks from config
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get all hook entries for a specific event
+     */
+    getHooksForEvent(eventName: HookEventName): HookRegistryEntry[];
+    /**
+     * Get all registered hooks
+     */
+    getAllHooks(): HookRegistryEntry[];
+    /**
+     * Enable or disable a specific hook
+     */
+    setHookEnabled(hookName: string, enabled: boolean): void;
+    /**
+     * Get hook name for display purposes
+     */
+    private getHookName;
+    /**
+     * Process hooks from the config that was already loaded by the CLI
+     */
+    private processHooksFromConfig;
+    /**
+     * Process hooks configuration and add entries
+     */
+    private processHooksConfiguration;
+    /**
+     * Process a single hook definition
+     */
+    private processHookDefinition;
+    /**
+     * Validate a hook configuration
+     */
+    private validateHookConfig;
+    /**
+     * Check if an event name is valid
+     */
+    private isValidEventName;
+    /**
+     * Get source priority (lower number = higher priority)
+     */
+    private getSourcePriority;
+}

package/dist/src/hooks/hookRegistry.js

@@ -0,0 +1,198 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { HookEventName } from './types.js';
+import { debugLogger } from '../utils/debugLogger.js';
+/**
+ * Error thrown when attempting to use HookRegistry before initialization
+ */
+export class HookRegistryNotInitializedError extends Error {
+    constructor(message = 'Hook registry not initialized') {
+        super(message);
+        this.name = 'HookRegistryNotInitializedError';
+    }
+}
+/**
+ * Configuration source levels in precedence order (highest to lowest)
+ */
+export var ConfigSource;
+(function (ConfigSource) {
+    ConfigSource["Project"] = "project";
+    ConfigSource["User"] = "user";
+    ConfigSource["System"] = "system";
+    ConfigSource["Extensions"] = "extensions";
+})(ConfigSource || (ConfigSource = {}));
+/**
+ * Hook registry that loads and validates hook definitions from multiple sources
+ */
+export class HookRegistry {
+    config;
+    entries = [];
+    initialized = false;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Initialize the registry by processing hooks from config
+     */
+    async initialize() {
+        if (this.initialized) {
+            return;
+        }
+        this.entries = [];
+        this.processHooksFromConfig();
+        this.initialized = true;
+        debugLogger.log(`Hook registry initialized with ${this.entries.length} hook entries`);
+    }
+    /**
+     * Get all hook entries for a specific event
+     */
+    getHooksForEvent(eventName) {
+        if (!this.initialized) {
+            throw new HookRegistryNotInitializedError();
+        }
+        return this.entries
+            .filter((entry) => entry.eventName === eventName && entry.enabled)
+            .sort((a, b) => this.getSourcePriority(a.source) - this.getSourcePriority(b.source));
+    }
+    /**
+     * Get all registered hooks
+     */
+    getAllHooks() {
+        if (!this.initialized) {
+            throw new HookRegistryNotInitializedError();
+        }
+        return [...this.entries];
+    }
+    /**
+     * Enable or disable a specific hook
+     */
+    setHookEnabled(hookName, enabled) {
+        const updated = this.entries.filter((entry) => {
+            const name = this.getHookName(entry);
+            if (name === hookName) {
+                entry.enabled = enabled;
+                return true;
+            }
+            return false;
+        });
+        if (updated.length > 0) {
+            debugLogger.log(`${enabled ? 'Enabled' : 'Disabled'} ${updated.length} hook(s) matching "${hookName}"`);
+        }
+        else {
+            debugLogger.warn(`No hooks found matching "${hookName}"`);
+        }
+    }
+    /**
+     * Get hook name for display purposes
+     */
+    getHookName(entry) {
+        return entry.config.command || 'unknown-command';
+    }
+    /**
+     * Process hooks from the config that was already loaded by the CLI
+     */
+    processHooksFromConfig() {
+        // Get hooks from the main config (this comes from the merged settings)
+        const configHooks = this.config.getHooks();
+        if (configHooks) {
+            this.processHooksConfiguration(configHooks, ConfigSource.Project);
+        }
+        // Get hooks from extensions
+        const extensions = this.config.getExtensions() || [];
+        for (const extension of extensions) {
+            if (extension.isActive && extension.hooks) {
+                this.processHooksConfiguration(extension.hooks, ConfigSource.Extensions);
+            }
+        }
+    }
+    /**
+     * Process hooks configuration and add entries
+     */
+    processHooksConfiguration(hooksConfig, source) {
+        for (const [eventName, definitions] of Object.entries(hooksConfig)) {
+            if (!this.isValidEventName(eventName)) {
+                debugLogger.warn(`Invalid hook event name: ${eventName}`);
+                continue;
+            }
+            const typedEventName = eventName;
+            if (!Array.isArray(definitions)) {
+                debugLogger.warn(`Hook definitions for event "${eventName}" from source "${source}" is not an array. Skipping.`);
+                continue;
+            }
+            for (const definition of definitions) {
+                this.processHookDefinition(definition, typedEventName, source);
+            }
+        }
+    }
+    /**
+     * Process a single hook definition
+     */
+    processHookDefinition(definition, eventName, source) {
+        if (!definition ||
+            typeof definition !== 'object' ||
+            !Array.isArray(definition.hooks)) {
+            debugLogger.warn(`Discarding invalid hook definition for ${eventName} from ${source}:`, definition);
+            return;
+        }
+        for (const hookConfig of definition.hooks) {
+            if (hookConfig &&
+                typeof hookConfig === 'object' &&
+                this.validateHookConfig(hookConfig, eventName, source)) {
+                this.entries.push({
+                    config: hookConfig,
+                    source,
+                    eventName,
+                    matcher: definition.matcher,
+                    sequential: definition.sequential,
+                    enabled: true,
+                });
+            }
+            else {
+                // Invalid hooks are logged and discarded here, they won't reach HookRunner
+                debugLogger.warn(`Discarding invalid hook configuration for ${eventName} from ${source}:`, hookConfig);
+            }
+        }
+    }
+    /**
+     * Validate a hook configuration
+     */
+    validateHookConfig(config, eventName, source) {
+        if (!config.type || !['command', 'plugin'].includes(config.type)) {
+            debugLogger.warn(`Invalid hook ${eventName} from ${source} type: ${config.type}`);
+            return false;
+        }
+        if (config.type === 'command' && !config.command) {
+            debugLogger.warn(`Command hook ${eventName} from ${source} missing command field`);
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Check if an event name is valid
+     */
+    isValidEventName(eventName) {
+        const validEventNames = Object.values(HookEventName);
+        return validEventNames.includes(eventName);
+    }
+    /**
+     * Get source priority (lower number = higher priority)
+     */
+    getSourcePriority(source) {
+        switch (source) {
+            case ConfigSource.Project:
+                return 1;
+            case ConfigSource.User:
+                return 2;
+            case ConfigSource.System:
+                return 3;
+            case ConfigSource.Extensions:
+                return 4;
+            default:
+                return 999;
+        }
+    }
+}
+//# sourceMappingURL=hookRegistry.js.map