moflo 4.8.17 → 4.8.20
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/guidance/shipped/moflo.md +45 -0
- package/.claude/helpers/statusline.cjs +1 -1
- package/.claude/workflow-state.json +9 -0
- package/bin/generate-code-map.mjs +91 -12
- package/package.json +2 -2
- package/src/@claude-flow/cli/bin/cli.js +5 -0
- package/src/@claude-flow/cli/dist/src/init/moflo-init.js +9 -0
- package/src/@claude-flow/cli/dist/src/init/statusline-generator.js +1 -1
- package/src/@claude-flow/cli/dist/src/services/agentic-flow-bridge.js +8 -0
- package/src/@claude-flow/cli/package.json +1 -1
- package/src/@claude-flow/memory/dist/agent-memory-scope.d.ts +131 -0
- package/src/@claude-flow/memory/dist/agent-memory-scope.js +223 -0
- package/src/@claude-flow/memory/dist/agent-memory-scope.test.d.ts +8 -0
- package/src/@claude-flow/memory/dist/agent-memory-scope.test.js +466 -0
- package/src/@claude-flow/memory/dist/agentdb-adapter.d.ts +165 -0
- package/src/@claude-flow/memory/dist/agentdb-adapter.js +806 -0
- package/src/@claude-flow/memory/dist/agentdb-backend.d.ts +212 -0
- package/src/@claude-flow/memory/dist/agentdb-backend.js +842 -0
- package/src/@claude-flow/memory/dist/agentdb-backend.test.d.ts +7 -0
- package/src/@claude-flow/memory/dist/agentdb-backend.test.js +258 -0
- package/src/@claude-flow/memory/dist/application/commands/delete-memory.command.d.ts +65 -0
- package/src/@claude-flow/memory/dist/application/commands/delete-memory.command.js +129 -0
- package/src/@claude-flow/memory/dist/application/commands/store-memory.command.d.ts +48 -0
- package/src/@claude-flow/memory/dist/application/commands/store-memory.command.js +72 -0
- package/src/@claude-flow/memory/dist/application/index.d.ts +12 -0
- package/src/@claude-flow/memory/dist/application/index.js +15 -0
- package/src/@claude-flow/memory/dist/application/queries/search-memory.query.d.ts +72 -0
- package/src/@claude-flow/memory/dist/application/queries/search-memory.query.js +143 -0
- package/src/@claude-flow/memory/dist/application/services/memory-application-service.d.ts +121 -0
- package/src/@claude-flow/memory/dist/application/services/memory-application-service.js +190 -0
- package/src/@claude-flow/memory/dist/auto-memory-bridge.d.ts +226 -0
- package/src/@claude-flow/memory/dist/auto-memory-bridge.js +709 -0
- package/src/@claude-flow/memory/dist/auto-memory-bridge.test.d.ts +8 -0
- package/src/@claude-flow/memory/dist/auto-memory-bridge.test.js +757 -0
- package/src/@claude-flow/memory/dist/benchmark.test.d.ts +2 -0
- package/src/@claude-flow/memory/dist/benchmark.test.js +277 -0
- package/src/@claude-flow/memory/dist/cache-manager.d.ts +134 -0
- package/src/@claude-flow/memory/dist/cache-manager.js +407 -0
- package/src/@claude-flow/memory/dist/controller-registry.d.ts +216 -0
- package/src/@claude-flow/memory/dist/controller-registry.js +893 -0
- package/src/@claude-flow/memory/dist/controller-registry.test.d.ts +14 -0
- package/src/@claude-flow/memory/dist/controller-registry.test.js +593 -0
- package/src/@claude-flow/memory/dist/database-provider.d.ts +87 -0
- package/src/@claude-flow/memory/dist/database-provider.js +372 -0
- package/src/@claude-flow/memory/dist/database-provider.test.d.ts +7 -0
- package/src/@claude-flow/memory/dist/database-provider.test.js +287 -0
- package/src/@claude-flow/memory/dist/domain/entities/memory-entry.d.ts +143 -0
- package/src/@claude-flow/memory/dist/domain/entities/memory-entry.js +226 -0
- package/src/@claude-flow/memory/dist/domain/index.d.ts +11 -0
- package/src/@claude-flow/memory/dist/domain/index.js +12 -0
- package/src/@claude-flow/memory/dist/domain/repositories/memory-repository.interface.d.ts +102 -0
- package/src/@claude-flow/memory/dist/domain/repositories/memory-repository.interface.js +11 -0
- package/src/@claude-flow/memory/dist/domain/services/memory-domain-service.d.ts +105 -0
- package/src/@claude-flow/memory/dist/domain/services/memory-domain-service.js +297 -0
- package/src/@claude-flow/memory/dist/hnsw-index.d.ts +111 -0
- package/src/@claude-flow/memory/dist/hnsw-index.js +781 -0
- package/src/@claude-flow/memory/dist/hnsw-lite.d.ts +23 -0
- package/src/@claude-flow/memory/dist/hnsw-lite.js +168 -0
- package/src/@claude-flow/memory/dist/index.d.ts +204 -0
- package/src/@claude-flow/memory/dist/index.js +358 -0
- package/src/@claude-flow/memory/dist/infrastructure/index.d.ts +17 -0
- package/src/@claude-flow/memory/dist/infrastructure/index.js +16 -0
- package/src/@claude-flow/memory/dist/infrastructure/repositories/hybrid-memory-repository.d.ts +66 -0
- package/src/@claude-flow/memory/dist/infrastructure/repositories/hybrid-memory-repository.js +409 -0
- package/src/@claude-flow/memory/dist/learning-bridge.d.ts +137 -0
- package/src/@claude-flow/memory/dist/learning-bridge.js +335 -0
- package/src/@claude-flow/memory/dist/learning-bridge.test.d.ts +8 -0
- package/src/@claude-flow/memory/dist/learning-bridge.test.js +578 -0
- package/src/@claude-flow/memory/dist/memory-graph.d.ts +100 -0
- package/src/@claude-flow/memory/dist/memory-graph.js +333 -0
- package/src/@claude-flow/memory/dist/memory-graph.test.d.ts +8 -0
- package/src/@claude-flow/memory/dist/memory-graph.test.js +609 -0
- package/src/@claude-flow/memory/dist/migration.d.ts +68 -0
- package/src/@claude-flow/memory/dist/migration.js +513 -0
- package/src/@claude-flow/memory/dist/persistent-sona.d.ts +144 -0
- package/src/@claude-flow/memory/dist/persistent-sona.js +332 -0
- package/src/@claude-flow/memory/dist/query-builder.d.ts +211 -0
- package/src/@claude-flow/memory/dist/query-builder.js +438 -0
- package/src/@claude-flow/memory/dist/rvf-backend.d.ts +51 -0
- package/src/@claude-flow/memory/dist/rvf-backend.js +481 -0
- package/src/@claude-flow/memory/dist/rvf-learning-store.d.ts +139 -0
- package/src/@claude-flow/memory/dist/rvf-learning-store.js +295 -0
- package/src/@claude-flow/memory/dist/rvf-migration.d.ts +45 -0
- package/src/@claude-flow/memory/dist/rvf-migration.js +234 -0
- package/src/@claude-flow/memory/dist/sqljs-backend.d.ts +127 -0
- package/src/@claude-flow/memory/dist/sqljs-backend.js +600 -0
- package/src/@claude-flow/memory/dist/types.d.ts +484 -0
- package/src/@claude-flow/memory/dist/types.js +58 -0
- package/src/@claude-flow/shared/dist/core/config/defaults.d.ts +41 -0
- package/src/@claude-flow/shared/dist/core/config/defaults.js +186 -0
- package/src/@claude-flow/shared/dist/core/config/index.d.ts +8 -0
- package/src/@claude-flow/shared/dist/core/config/index.js +12 -0
- package/src/@claude-flow/shared/dist/core/config/loader.d.ts +45 -0
- package/src/@claude-flow/shared/dist/core/config/loader.js +222 -0
- package/src/@claude-flow/shared/dist/core/config/schema.d.ts +1134 -0
- package/src/@claude-flow/shared/dist/core/config/schema.js +158 -0
- package/src/@claude-flow/shared/dist/core/config/validator.d.ts +92 -0
- package/src/@claude-flow/shared/dist/core/config/validator.js +147 -0
- package/src/@claude-flow/shared/dist/core/event-bus.d.ts +31 -0
- package/src/@claude-flow/shared/dist/core/event-bus.js +197 -0
- package/src/@claude-flow/shared/dist/core/index.d.ts +15 -0
- package/src/@claude-flow/shared/dist/core/index.js +19 -0
- package/src/@claude-flow/shared/dist/core/interfaces/agent.interface.d.ts +200 -0
- package/src/@claude-flow/shared/dist/core/interfaces/agent.interface.js +6 -0
- package/src/@claude-flow/shared/dist/core/interfaces/coordinator.interface.d.ts +310 -0
- package/src/@claude-flow/shared/dist/core/interfaces/coordinator.interface.js +7 -0
- package/src/@claude-flow/shared/dist/core/interfaces/event.interface.d.ts +224 -0
- package/src/@claude-flow/shared/dist/core/interfaces/event.interface.js +46 -0
- package/src/@claude-flow/shared/dist/core/interfaces/index.d.ts +10 -0
- package/src/@claude-flow/shared/dist/core/interfaces/index.js +15 -0
- package/src/@claude-flow/shared/dist/core/interfaces/memory.interface.d.ts +298 -0
- package/src/@claude-flow/shared/dist/core/interfaces/memory.interface.js +7 -0
- package/src/@claude-flow/shared/dist/core/interfaces/task.interface.d.ts +185 -0
- package/src/@claude-flow/shared/dist/core/interfaces/task.interface.js +6 -0
- package/src/@claude-flow/shared/dist/core/orchestrator/event-coordinator.d.ts +35 -0
- package/src/@claude-flow/shared/dist/core/orchestrator/event-coordinator.js +101 -0
- package/src/@claude-flow/shared/dist/core/orchestrator/health-monitor.d.ts +60 -0
- package/src/@claude-flow/shared/dist/core/orchestrator/health-monitor.js +166 -0
- package/src/@claude-flow/shared/dist/core/orchestrator/index.d.ts +46 -0
- package/src/@claude-flow/shared/dist/core/orchestrator/index.js +64 -0
- package/src/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.d.ts +56 -0
- package/src/@claude-flow/shared/dist/core/orchestrator/lifecycle-manager.js +195 -0
- package/src/@claude-flow/shared/dist/core/orchestrator/session-manager.d.ts +83 -0
- package/src/@claude-flow/shared/dist/core/orchestrator/session-manager.js +193 -0
- package/src/@claude-flow/shared/dist/core/orchestrator/task-manager.d.ts +49 -0
- package/src/@claude-flow/shared/dist/core/orchestrator/task-manager.js +253 -0
- package/src/@claude-flow/shared/dist/events/domain-events.d.ts +282 -0
- package/src/@claude-flow/shared/dist/events/domain-events.js +165 -0
- package/src/@claude-flow/shared/dist/events/event-store.d.ts +126 -0
- package/src/@claude-flow/shared/dist/events/event-store.js +432 -0
- package/src/@claude-flow/shared/dist/events/event-store.test.d.ts +8 -0
- package/src/@claude-flow/shared/dist/events/event-store.test.js +297 -0
- package/src/@claude-flow/shared/dist/events/example-usage.d.ts +10 -0
- package/src/@claude-flow/shared/dist/events/example-usage.js +193 -0
- package/src/@claude-flow/shared/dist/events/index.d.ts +21 -0
- package/src/@claude-flow/shared/dist/events/index.js +22 -0
- package/src/@claude-flow/shared/dist/events/projections.d.ts +177 -0
- package/src/@claude-flow/shared/dist/events/projections.js +421 -0
- package/src/@claude-flow/shared/dist/events/rvf-event-log.d.ts +82 -0
- package/src/@claude-flow/shared/dist/events/rvf-event-log.js +340 -0
- package/src/@claude-flow/shared/dist/events/state-reconstructor.d.ts +101 -0
- package/src/@claude-flow/shared/dist/events/state-reconstructor.js +263 -0
- package/src/@claude-flow/shared/dist/events.d.ts +80 -0
- package/src/@claude-flow/shared/dist/events.js +249 -0
- package/src/@claude-flow/shared/dist/hooks/example-usage.d.ts +42 -0
- package/src/@claude-flow/shared/dist/hooks/example-usage.js +351 -0
- package/src/@claude-flow/shared/dist/hooks/executor.d.ts +100 -0
- package/src/@claude-flow/shared/dist/hooks/executor.js +267 -0
- package/src/@claude-flow/shared/dist/hooks/hooks.test.d.ts +9 -0
- package/src/@claude-flow/shared/dist/hooks/hooks.test.js +322 -0
- package/src/@claude-flow/shared/dist/hooks/index.d.ts +52 -0
- package/src/@claude-flow/shared/dist/hooks/index.js +51 -0
- package/src/@claude-flow/shared/dist/hooks/registry.d.ts +133 -0
- package/src/@claude-flow/shared/dist/hooks/registry.js +277 -0
- package/src/@claude-flow/shared/dist/hooks/safety/bash-safety.d.ts +105 -0
- package/src/@claude-flow/shared/dist/hooks/safety/bash-safety.js +481 -0
- package/src/@claude-flow/shared/dist/hooks/safety/file-organization.d.ts +144 -0
- package/src/@claude-flow/shared/dist/hooks/safety/file-organization.js +328 -0
- package/src/@claude-flow/shared/dist/hooks/safety/git-commit.d.ts +158 -0
- package/src/@claude-flow/shared/dist/hooks/safety/git-commit.js +450 -0
- package/src/@claude-flow/shared/dist/hooks/safety/index.d.ts +17 -0
- package/src/@claude-flow/shared/dist/hooks/safety/index.js +17 -0
- package/src/@claude-flow/shared/dist/hooks/session-hooks.d.ts +234 -0
- package/src/@claude-flow/shared/dist/hooks/session-hooks.js +334 -0
- package/src/@claude-flow/shared/dist/hooks/task-hooks.d.ts +163 -0
- package/src/@claude-flow/shared/dist/hooks/task-hooks.js +326 -0
- package/src/@claude-flow/shared/dist/hooks/types.d.ts +267 -0
- package/src/@claude-flow/shared/dist/hooks/types.js +62 -0
- package/src/@claude-flow/shared/dist/hooks/verify-exports.test.d.ts +9 -0
- package/src/@claude-flow/shared/dist/hooks/verify-exports.test.js +93 -0
- package/src/@claude-flow/shared/dist/index.d.ts +20 -0
- package/src/@claude-flow/shared/dist/index.js +50 -0
- package/src/@claude-flow/shared/dist/mcp/connection-pool.d.ts +98 -0
- package/src/@claude-flow/shared/dist/mcp/connection-pool.js +364 -0
- package/src/@claude-flow/shared/dist/mcp/index.d.ts +69 -0
- package/src/@claude-flow/shared/dist/mcp/index.js +84 -0
- package/src/@claude-flow/shared/dist/mcp/server.d.ts +166 -0
- package/src/@claude-flow/shared/dist/mcp/server.js +593 -0
- package/src/@claude-flow/shared/dist/mcp/session-manager.d.ts +136 -0
- package/src/@claude-flow/shared/dist/mcp/session-manager.js +335 -0
- package/src/@claude-flow/shared/dist/mcp/tool-registry.d.ts +178 -0
- package/src/@claude-flow/shared/dist/mcp/tool-registry.js +439 -0
- package/src/@claude-flow/shared/dist/mcp/transport/http.d.ts +104 -0
- package/src/@claude-flow/shared/dist/mcp/transport/http.js +476 -0
- package/src/@claude-flow/shared/dist/mcp/transport/index.d.ts +102 -0
- package/src/@claude-flow/shared/dist/mcp/transport/index.js +238 -0
- package/src/@claude-flow/shared/dist/mcp/transport/stdio.d.ts +104 -0
- package/src/@claude-flow/shared/dist/mcp/transport/stdio.js +263 -0
- package/src/@claude-flow/shared/dist/mcp/transport/websocket.d.ts +133 -0
- package/src/@claude-flow/shared/dist/mcp/transport/websocket.js +396 -0
- package/src/@claude-flow/shared/dist/mcp/types.d.ts +438 -0
- package/src/@claude-flow/shared/dist/mcp/types.js +54 -0
- package/src/@claude-flow/shared/dist/plugin-interface.d.ts +544 -0
- package/src/@claude-flow/shared/dist/plugin-interface.js +23 -0
- package/src/@claude-flow/shared/dist/plugin-loader.d.ts +139 -0
- package/src/@claude-flow/shared/dist/plugin-loader.js +434 -0
- package/src/@claude-flow/shared/dist/plugin-registry.d.ts +183 -0
- package/src/@claude-flow/shared/dist/plugin-registry.js +457 -0
- package/src/@claude-flow/shared/dist/plugins/index.d.ts +10 -0
- package/src/@claude-flow/shared/dist/plugins/index.js +10 -0
- package/src/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.d.ts +106 -0
- package/src/@claude-flow/shared/dist/plugins/official/hive-mind-plugin.js +241 -0
- package/src/@claude-flow/shared/dist/plugins/official/index.d.ts +10 -0
- package/src/@claude-flow/shared/dist/plugins/official/index.js +10 -0
- package/src/@claude-flow/shared/dist/plugins/official/maestro-plugin.d.ts +121 -0
- package/src/@claude-flow/shared/dist/plugins/official/maestro-plugin.js +355 -0
- package/src/@claude-flow/shared/dist/plugins/types.d.ts +93 -0
- package/src/@claude-flow/shared/dist/plugins/types.js +9 -0
- package/src/@claude-flow/shared/dist/resilience/bulkhead.d.ts +105 -0
- package/src/@claude-flow/shared/dist/resilience/bulkhead.js +206 -0
- package/src/@claude-flow/shared/dist/resilience/circuit-breaker.d.ts +132 -0
- package/src/@claude-flow/shared/dist/resilience/circuit-breaker.js +233 -0
- package/src/@claude-flow/shared/dist/resilience/index.d.ts +19 -0
- package/src/@claude-flow/shared/dist/resilience/index.js +19 -0
- package/src/@claude-flow/shared/dist/resilience/rate-limiter.d.ts +168 -0
- package/src/@claude-flow/shared/dist/resilience/rate-limiter.js +314 -0
- package/src/@claude-flow/shared/dist/resilience/retry.d.ts +91 -0
- package/src/@claude-flow/shared/dist/resilience/retry.js +159 -0
- package/src/@claude-flow/shared/dist/security/index.d.ts +10 -0
- package/src/@claude-flow/shared/dist/security/index.js +12 -0
- package/src/@claude-flow/shared/dist/security/input-validation.d.ts +73 -0
- package/src/@claude-flow/shared/dist/security/input-validation.js +201 -0
- package/src/@claude-flow/shared/dist/security/secure-random.d.ts +92 -0
- package/src/@claude-flow/shared/dist/security/secure-random.js +142 -0
- package/src/@claude-flow/shared/dist/services/index.d.ts +7 -0
- package/src/@claude-flow/shared/dist/services/index.js +7 -0
- package/src/@claude-flow/shared/dist/services/v3-progress.service.d.ts +124 -0
- package/src/@claude-flow/shared/dist/services/v3-progress.service.js +402 -0
- package/src/@claude-flow/shared/dist/types/agent.types.d.ts +137 -0
- package/src/@claude-flow/shared/dist/types/agent.types.js +6 -0
- package/src/@claude-flow/shared/dist/types/index.d.ts +11 -0
- package/src/@claude-flow/shared/dist/types/index.js +17 -0
- package/src/@claude-flow/shared/dist/types/mcp.types.d.ts +266 -0
- package/src/@claude-flow/shared/dist/types/mcp.types.js +7 -0
- package/src/@claude-flow/shared/dist/types/memory.types.d.ts +236 -0
- package/src/@claude-flow/shared/dist/types/memory.types.js +7 -0
- package/src/@claude-flow/shared/dist/types/swarm.types.d.ts +186 -0
- package/src/@claude-flow/shared/dist/types/swarm.types.js +65 -0
- package/src/@claude-flow/shared/dist/types/task.types.d.ts +178 -0
- package/src/@claude-flow/shared/dist/types/task.types.js +32 -0
- package/src/@claude-flow/shared/dist/types.d.ts +197 -0
- package/src/@claude-flow/shared/dist/types.js +21 -0
- package/src/@claude-flow/shared/dist/utils/secure-logger.d.ts +69 -0
- package/src/@claude-flow/shared/dist/utils/secure-logger.js +208 -0
|
@@ -0,0 +1,267 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* V3 Hooks System - Hook Executor
|
|
3
|
+
*
|
|
4
|
+
* Executes hooks in priority order with timeout handling and error recovery.
|
|
5
|
+
* Integrates with event bus for coordination and monitoring.
|
|
6
|
+
*
|
|
7
|
+
* @module v3/shared/hooks/executor
|
|
8
|
+
*/
|
|
9
|
+
/**
|
|
10
|
+
* Hook executor implementation
|
|
11
|
+
*/
|
|
12
|
+
export class HookExecutor {
|
|
13
|
+
registry;
|
|
14
|
+
eventBus;
|
|
15
|
+
constructor(registry, eventBus) {
|
|
16
|
+
this.registry = registry;
|
|
17
|
+
this.eventBus = eventBus;
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* Execute all hooks for an event
|
|
21
|
+
*
|
|
22
|
+
* @param event - Hook event type
|
|
23
|
+
* @param context - Hook context
|
|
24
|
+
* @param options - Execution options
|
|
25
|
+
* @returns Aggregated results
|
|
26
|
+
*/
|
|
27
|
+
async execute(event, context, options = {}) {
|
|
28
|
+
const startTime = Date.now();
|
|
29
|
+
const results = [];
|
|
30
|
+
let aborted = false;
|
|
31
|
+
let finalContext = {};
|
|
32
|
+
// Get enabled hooks for this event
|
|
33
|
+
const hooks = this.registry.getHandlers(event, false);
|
|
34
|
+
// Emit pre-execution event
|
|
35
|
+
this.eventBus?.emit('hooks:pre-execute', {
|
|
36
|
+
event,
|
|
37
|
+
hookCount: hooks.length,
|
|
38
|
+
context,
|
|
39
|
+
});
|
|
40
|
+
// Execute hooks in priority order
|
|
41
|
+
for (const hook of hooks) {
|
|
42
|
+
if (aborted) {
|
|
43
|
+
break;
|
|
44
|
+
}
|
|
45
|
+
try {
|
|
46
|
+
const result = await this.executeSingleHook(hook.handler, context, hook.timeout || options.timeout);
|
|
47
|
+
results.push(result);
|
|
48
|
+
// Record execution statistics
|
|
49
|
+
this.registry.recordExecution(result.success, result.executionTime || 0);
|
|
50
|
+
// Merge context modifications
|
|
51
|
+
if (result.data) {
|
|
52
|
+
finalContext = { ...finalContext, ...result.data };
|
|
53
|
+
// Update context for next hooks
|
|
54
|
+
Object.assign(context, result.data);
|
|
55
|
+
}
|
|
56
|
+
// Check if we should abort
|
|
57
|
+
if (result.abort) {
|
|
58
|
+
aborted = true;
|
|
59
|
+
break;
|
|
60
|
+
}
|
|
61
|
+
// Check if we should stop the chain
|
|
62
|
+
if (result.continueChain === false) {
|
|
63
|
+
break;
|
|
64
|
+
}
|
|
65
|
+
// Check if we should stop on error
|
|
66
|
+
if (!result.success && !options.continueOnError) {
|
|
67
|
+
aborted = true;
|
|
68
|
+
break;
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
catch (error) {
|
|
72
|
+
const errorResult = {
|
|
73
|
+
success: false,
|
|
74
|
+
error: error instanceof Error ? error : new Error(String(error)),
|
|
75
|
+
continueChain: options.continueOnError,
|
|
76
|
+
};
|
|
77
|
+
results.push(errorResult);
|
|
78
|
+
this.registry.recordExecution(false, 0);
|
|
79
|
+
// Emit error event
|
|
80
|
+
this.eventBus?.emit('hooks:error', {
|
|
81
|
+
event,
|
|
82
|
+
hookId: hook.id,
|
|
83
|
+
error,
|
|
84
|
+
});
|
|
85
|
+
if (!options.continueOnError) {
|
|
86
|
+
aborted = true;
|
|
87
|
+
break;
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
const totalExecutionTime = Date.now() - startTime;
|
|
92
|
+
const hooksFailed = results.filter(r => !r.success).length;
|
|
93
|
+
// Build aggregated result
|
|
94
|
+
const aggregatedResult = {
|
|
95
|
+
success: hooksFailed === 0 && !aborted,
|
|
96
|
+
results: options.collectResults ? results : [],
|
|
97
|
+
totalExecutionTime,
|
|
98
|
+
hooksExecuted: results.length,
|
|
99
|
+
hooksFailed,
|
|
100
|
+
aborted,
|
|
101
|
+
finalContext,
|
|
102
|
+
};
|
|
103
|
+
// Emit post-execution event
|
|
104
|
+
this.eventBus?.emit('hooks:post-execute', {
|
|
105
|
+
event,
|
|
106
|
+
...aggregatedResult,
|
|
107
|
+
});
|
|
108
|
+
return aggregatedResult;
|
|
109
|
+
}
|
|
110
|
+
/**
|
|
111
|
+
* Execute hooks with timeout
|
|
112
|
+
*
|
|
113
|
+
* @param event - Hook event type
|
|
114
|
+
* @param context - Hook context
|
|
115
|
+
* @param timeout - Timeout in ms
|
|
116
|
+
* @returns Aggregated results
|
|
117
|
+
*/
|
|
118
|
+
async executeWithTimeout(event, context, timeout) {
|
|
119
|
+
return this.withTimeout(this.execute(event, context, { timeout }), timeout);
|
|
120
|
+
}
|
|
121
|
+
/**
|
|
122
|
+
* Execute a single hook with timeout and error handling
|
|
123
|
+
*
|
|
124
|
+
* @param handler - Hook handler function
|
|
125
|
+
* @param context - Hook context
|
|
126
|
+
* @param timeout - Optional timeout in ms
|
|
127
|
+
* @returns Hook result
|
|
128
|
+
*/
|
|
129
|
+
async executeSingleHook(handler, context, timeout) {
|
|
130
|
+
const startTime = Date.now();
|
|
131
|
+
try {
|
|
132
|
+
let resultPromise = Promise.resolve(handler(context));
|
|
133
|
+
// Apply timeout if specified
|
|
134
|
+
if (timeout && timeout > 0) {
|
|
135
|
+
resultPromise = this.withTimeout(resultPromise, timeout);
|
|
136
|
+
}
|
|
137
|
+
const result = await resultPromise;
|
|
138
|
+
const executionTime = Date.now() - startTime;
|
|
139
|
+
return {
|
|
140
|
+
...result,
|
|
141
|
+
executionTime,
|
|
142
|
+
};
|
|
143
|
+
}
|
|
144
|
+
catch (error) {
|
|
145
|
+
const executionTime = Date.now() - startTime;
|
|
146
|
+
return {
|
|
147
|
+
success: false,
|
|
148
|
+
error: error instanceof Error ? error : new Error(String(error)),
|
|
149
|
+
executionTime,
|
|
150
|
+
};
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
/**
|
|
154
|
+
* Execute multiple hooks in parallel
|
|
155
|
+
*
|
|
156
|
+
* @param events - Array of hook events
|
|
157
|
+
* @param contexts - Array of contexts (matched by index)
|
|
158
|
+
* @param options - Execution options
|
|
159
|
+
* @returns Array of aggregated results
|
|
160
|
+
*/
|
|
161
|
+
async executeParallel(events, contexts, options = {}) {
|
|
162
|
+
if (events.length !== contexts.length) {
|
|
163
|
+
throw new Error('Events and contexts arrays must have same length');
|
|
164
|
+
}
|
|
165
|
+
const maxParallel = options.maxParallel || events.length;
|
|
166
|
+
const results = [];
|
|
167
|
+
// Execute in batches
|
|
168
|
+
for (let i = 0; i < events.length; i += maxParallel) {
|
|
169
|
+
const batch = events.slice(i, i + maxParallel);
|
|
170
|
+
const batchContexts = contexts.slice(i, i + maxParallel);
|
|
171
|
+
const batchResults = await Promise.allSettled(batch.map((event, index) => this.execute(event, batchContexts[index], options)));
|
|
172
|
+
for (const result of batchResults) {
|
|
173
|
+
if (result.status === 'fulfilled') {
|
|
174
|
+
results.push(result.value);
|
|
175
|
+
}
|
|
176
|
+
else {
|
|
177
|
+
// Create error result for rejected promises
|
|
178
|
+
results.push({
|
|
179
|
+
success: false,
|
|
180
|
+
results: [{
|
|
181
|
+
success: false,
|
|
182
|
+
error: result.reason instanceof Error
|
|
183
|
+
? result.reason
|
|
184
|
+
: new Error(String(result.reason)),
|
|
185
|
+
}],
|
|
186
|
+
totalExecutionTime: 0,
|
|
187
|
+
hooksExecuted: 0,
|
|
188
|
+
hooksFailed: 1,
|
|
189
|
+
aborted: true,
|
|
190
|
+
});
|
|
191
|
+
}
|
|
192
|
+
}
|
|
193
|
+
}
|
|
194
|
+
return results;
|
|
195
|
+
}
|
|
196
|
+
/**
|
|
197
|
+
* Execute hooks sequentially with context chaining
|
|
198
|
+
*
|
|
199
|
+
* @param events - Array of hook events
|
|
200
|
+
* @param initialContext - Initial context
|
|
201
|
+
* @param options - Execution options
|
|
202
|
+
* @returns Final aggregated result with chained context
|
|
203
|
+
*/
|
|
204
|
+
async executeSequential(events, initialContext, options = {}) {
|
|
205
|
+
const results = [];
|
|
206
|
+
let currentContext = { ...initialContext };
|
|
207
|
+
let totalExecutionTime = 0;
|
|
208
|
+
let totalHooksExecuted = 0;
|
|
209
|
+
let totalHooksFailed = 0;
|
|
210
|
+
let aborted = false;
|
|
211
|
+
for (const event of events) {
|
|
212
|
+
if (aborted) {
|
|
213
|
+
break;
|
|
214
|
+
}
|
|
215
|
+
const result = await this.execute(event, currentContext, options);
|
|
216
|
+
results.push(...result.results);
|
|
217
|
+
totalExecutionTime += result.totalExecutionTime;
|
|
218
|
+
totalHooksExecuted += result.hooksExecuted;
|
|
219
|
+
totalHooksFailed += result.hooksFailed;
|
|
220
|
+
// Merge context for next event
|
|
221
|
+
if (result.finalContext) {
|
|
222
|
+
currentContext = { ...currentContext, ...result.finalContext };
|
|
223
|
+
}
|
|
224
|
+
if (result.aborted || !result.success) {
|
|
225
|
+
aborted = true;
|
|
226
|
+
break;
|
|
227
|
+
}
|
|
228
|
+
}
|
|
229
|
+
return {
|
|
230
|
+
success: totalHooksFailed === 0 && !aborted,
|
|
231
|
+
results: options.collectResults ? results : [],
|
|
232
|
+
totalExecutionTime,
|
|
233
|
+
hooksExecuted: totalHooksExecuted,
|
|
234
|
+
hooksFailed: totalHooksFailed,
|
|
235
|
+
aborted,
|
|
236
|
+
finalContext: currentContext,
|
|
237
|
+
};
|
|
238
|
+
}
|
|
239
|
+
/**
|
|
240
|
+
* Wrap a promise with timeout
|
|
241
|
+
*/
|
|
242
|
+
async withTimeout(promise, timeout) {
|
|
243
|
+
return Promise.race([
|
|
244
|
+
promise,
|
|
245
|
+
new Promise((_, reject) => setTimeout(() => reject(new Error(`Hook execution timeout after ${timeout}ms`)), timeout)),
|
|
246
|
+
]);
|
|
247
|
+
}
|
|
248
|
+
/**
|
|
249
|
+
* Set event bus for coordination
|
|
250
|
+
*/
|
|
251
|
+
setEventBus(eventBus) {
|
|
252
|
+
this.eventBus = eventBus;
|
|
253
|
+
}
|
|
254
|
+
/**
|
|
255
|
+
* Get hook registry
|
|
256
|
+
*/
|
|
257
|
+
getRegistry() {
|
|
258
|
+
return this.registry;
|
|
259
|
+
}
|
|
260
|
+
}
|
|
261
|
+
/**
|
|
262
|
+
* Create a new hook executor
|
|
263
|
+
*/
|
|
264
|
+
export function createHookExecutor(registry, eventBus) {
|
|
265
|
+
return new HookExecutor(registry, eventBus);
|
|
266
|
+
}
|
|
267
|
+
//# sourceMappingURL=executor.js.map
|
|
@@ -0,0 +1,322 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* V3 Hooks System - Tests
|
|
3
|
+
*
|
|
4
|
+
* Comprehensive tests for hook registry and executor.
|
|
5
|
+
*
|
|
6
|
+
* @module v3/shared/hooks/hooks.test
|
|
7
|
+
*/
|
|
8
|
+
import { describe, it, expect, beforeEach, vi } from 'vitest';
|
|
9
|
+
import { createHookRegistry } from './registry.js';
|
|
10
|
+
import { createHookExecutor } from './executor.js';
|
|
11
|
+
import { HookEvent, HookPriority } from './types.js';
|
|
12
|
+
import { createEventBus } from '../core/event-bus.js';
|
|
13
|
+
describe('HookRegistry', () => {
|
|
14
|
+
let registry;
|
|
15
|
+
beforeEach(() => {
|
|
16
|
+
registry = createHookRegistry();
|
|
17
|
+
});
|
|
18
|
+
it('should register a hook', () => {
|
|
19
|
+
const handler = vi.fn();
|
|
20
|
+
const id = registry.register(HookEvent.PreToolUse, handler);
|
|
21
|
+
expect(id).toBeDefined();
|
|
22
|
+
expect(registry.has(id)).toBe(true);
|
|
23
|
+
expect(registry.count()).toBe(1);
|
|
24
|
+
});
|
|
25
|
+
it('should unregister a hook', () => {
|
|
26
|
+
const handler = vi.fn();
|
|
27
|
+
const id = registry.register(HookEvent.PreToolUse, handler);
|
|
28
|
+
const result = registry.unregister(id);
|
|
29
|
+
expect(result).toBe(true);
|
|
30
|
+
expect(registry.has(id)).toBe(false);
|
|
31
|
+
expect(registry.count()).toBe(0);
|
|
32
|
+
});
|
|
33
|
+
it('should return false when unregistering non-existent hook', () => {
|
|
34
|
+
const result = registry.unregister('non-existent');
|
|
35
|
+
expect(result).toBe(false);
|
|
36
|
+
});
|
|
37
|
+
it('should get handlers sorted by priority', () => {
|
|
38
|
+
const handler1 = vi.fn();
|
|
39
|
+
const handler2 = vi.fn();
|
|
40
|
+
const handler3 = vi.fn();
|
|
41
|
+
registry.register(HookEvent.PreToolUse, handler1, HookPriority.Normal);
|
|
42
|
+
registry.register(HookEvent.PreToolUse, handler2, HookPriority.High);
|
|
43
|
+
registry.register(HookEvent.PreToolUse, handler3, HookPriority.Low);
|
|
44
|
+
const handlers = registry.getHandlers(HookEvent.PreToolUse);
|
|
45
|
+
expect(handlers).toHaveLength(3);
|
|
46
|
+
expect(handlers[0].handler).toBe(handler2); // High priority first
|
|
47
|
+
expect(handlers[1].handler).toBe(handler1); // Normal priority second
|
|
48
|
+
expect(handlers[2].handler).toBe(handler3); // Low priority last
|
|
49
|
+
});
|
|
50
|
+
it('should filter disabled hooks', () => {
|
|
51
|
+
const handler = vi.fn();
|
|
52
|
+
const id = registry.register(HookEvent.PreToolUse, handler, HookPriority.Normal, {
|
|
53
|
+
enabled: false,
|
|
54
|
+
});
|
|
55
|
+
const handlers = registry.getHandlers(HookEvent.PreToolUse);
|
|
56
|
+
const allHandlers = registry.getHandlers(HookEvent.PreToolUse, true);
|
|
57
|
+
expect(handlers).toHaveLength(0);
|
|
58
|
+
expect(allHandlers).toHaveLength(1);
|
|
59
|
+
});
|
|
60
|
+
it('should enable and disable hooks', () => {
|
|
61
|
+
const handler = vi.fn();
|
|
62
|
+
const id = registry.register(HookEvent.PreToolUse, handler);
|
|
63
|
+
registry.disable(id);
|
|
64
|
+
expect(registry.getHandlers(HookEvent.PreToolUse)).toHaveLength(0);
|
|
65
|
+
registry.enable(id);
|
|
66
|
+
expect(registry.getHandlers(HookEvent.PreToolUse)).toHaveLength(1);
|
|
67
|
+
});
|
|
68
|
+
it('should list hooks with filters', () => {
|
|
69
|
+
registry.register(HookEvent.PreToolUse, vi.fn(), HookPriority.High);
|
|
70
|
+
registry.register(HookEvent.PostToolUse, vi.fn(), HookPriority.Normal);
|
|
71
|
+
registry.register(HookEvent.PreEdit, vi.fn(), HookPriority.Low);
|
|
72
|
+
const allHooks = registry.listHooks();
|
|
73
|
+
expect(allHooks).toHaveLength(3);
|
|
74
|
+
const preToolHooks = registry.listHooks({ event: HookEvent.PreToolUse });
|
|
75
|
+
expect(preToolHooks).toHaveLength(1);
|
|
76
|
+
const highPriorityHooks = registry.listHooks({ minPriority: HookPriority.Normal });
|
|
77
|
+
expect(highPriorityHooks).toHaveLength(2);
|
|
78
|
+
});
|
|
79
|
+
it('should get event types', () => {
|
|
80
|
+
registry.register(HookEvent.PreToolUse, vi.fn());
|
|
81
|
+
registry.register(HookEvent.PostToolUse, vi.fn());
|
|
82
|
+
registry.register(HookEvent.PreEdit, vi.fn());
|
|
83
|
+
const eventTypes = registry.getEventTypes();
|
|
84
|
+
expect(eventTypes).toContain(HookEvent.PreToolUse);
|
|
85
|
+
expect(eventTypes).toContain(HookEvent.PostToolUse);
|
|
86
|
+
expect(eventTypes).toContain(HookEvent.PreEdit);
|
|
87
|
+
});
|
|
88
|
+
it('should track statistics', () => {
|
|
89
|
+
registry.register(HookEvent.PreToolUse, vi.fn());
|
|
90
|
+
registry.register(HookEvent.PostToolUse, vi.fn());
|
|
91
|
+
registry.recordExecution(true, 10);
|
|
92
|
+
registry.recordExecution(true, 20);
|
|
93
|
+
registry.recordExecution(false, 5);
|
|
94
|
+
const stats = registry.getStats();
|
|
95
|
+
expect(stats.totalHooks).toBe(2);
|
|
96
|
+
expect(stats.totalExecutions).toBe(3);
|
|
97
|
+
expect(stats.totalFailures).toBe(1);
|
|
98
|
+
expect(stats.avgExecutionTime).toBe((10 + 20 + 5) / 3);
|
|
99
|
+
});
|
|
100
|
+
it('should reset statistics', () => {
|
|
101
|
+
registry.recordExecution(true, 10);
|
|
102
|
+
registry.resetStats();
|
|
103
|
+
const stats = registry.getStats();
|
|
104
|
+
expect(stats.totalExecutions).toBe(0);
|
|
105
|
+
expect(stats.totalFailures).toBe(0);
|
|
106
|
+
});
|
|
107
|
+
it('should clear all hooks', () => {
|
|
108
|
+
registry.register(HookEvent.PreToolUse, vi.fn());
|
|
109
|
+
registry.register(HookEvent.PostToolUse, vi.fn());
|
|
110
|
+
registry.clear();
|
|
111
|
+
expect(registry.count()).toBe(0);
|
|
112
|
+
expect(registry.getEventTypes()).toHaveLength(0);
|
|
113
|
+
});
|
|
114
|
+
});
|
|
115
|
+
describe('HookExecutor', () => {
|
|
116
|
+
let registry;
|
|
117
|
+
let executor;
|
|
118
|
+
let eventBus;
|
|
119
|
+
beforeEach(() => {
|
|
120
|
+
registry = createHookRegistry();
|
|
121
|
+
eventBus = createEventBus();
|
|
122
|
+
executor = createHookExecutor(registry, eventBus);
|
|
123
|
+
});
|
|
124
|
+
it('should execute single hook successfully', async () => {
|
|
125
|
+
const handler = vi.fn(async () => ({ success: true }));
|
|
126
|
+
registry.register(HookEvent.PreToolUse, handler);
|
|
127
|
+
const context = {
|
|
128
|
+
event: HookEvent.PreToolUse,
|
|
129
|
+
timestamp: new Date(),
|
|
130
|
+
tool: { name: 'Read', parameters: { path: 'file.ts' } },
|
|
131
|
+
};
|
|
132
|
+
const result = await executor.execute(HookEvent.PreToolUse, context);
|
|
133
|
+
expect(result.success).toBe(true);
|
|
134
|
+
expect(result.hooksExecuted).toBe(1);
|
|
135
|
+
expect(result.hooksFailed).toBe(0);
|
|
136
|
+
expect(handler).toHaveBeenCalledWith(context);
|
|
137
|
+
});
|
|
138
|
+
it('should execute multiple hooks in priority order', async () => {
|
|
139
|
+
const executionOrder = [];
|
|
140
|
+
const handler1 = vi.fn(async () => {
|
|
141
|
+
executionOrder.push(1);
|
|
142
|
+
return { success: true };
|
|
143
|
+
});
|
|
144
|
+
const handler2 = vi.fn(async () => {
|
|
145
|
+
executionOrder.push(2);
|
|
146
|
+
return { success: true };
|
|
147
|
+
});
|
|
148
|
+
const handler3 = vi.fn(async () => {
|
|
149
|
+
executionOrder.push(3);
|
|
150
|
+
return { success: true };
|
|
151
|
+
});
|
|
152
|
+
registry.register(HookEvent.PreToolUse, handler1, HookPriority.Normal);
|
|
153
|
+
registry.register(HookEvent.PreToolUse, handler2, HookPriority.High);
|
|
154
|
+
registry.register(HookEvent.PreToolUse, handler3, HookPriority.Low);
|
|
155
|
+
const context = {
|
|
156
|
+
event: HookEvent.PreToolUse,
|
|
157
|
+
timestamp: new Date(),
|
|
158
|
+
};
|
|
159
|
+
await executor.execute(HookEvent.PreToolUse, context);
|
|
160
|
+
expect(executionOrder).toEqual([2, 1, 3]); // High, Normal, Low
|
|
161
|
+
});
|
|
162
|
+
it('should handle hook errors gracefully', async () => {
|
|
163
|
+
const handler1 = vi.fn(async () => ({ success: true }));
|
|
164
|
+
const handler2 = vi.fn(async () => {
|
|
165
|
+
throw new Error('Hook failed');
|
|
166
|
+
});
|
|
167
|
+
const handler3 = vi.fn(async () => ({ success: true }));
|
|
168
|
+
registry.register(HookEvent.PreToolUse, handler1, HookPriority.High);
|
|
169
|
+
registry.register(HookEvent.PreToolUse, handler2, HookPriority.Normal);
|
|
170
|
+
registry.register(HookEvent.PreToolUse, handler3, HookPriority.Low);
|
|
171
|
+
const context = {
|
|
172
|
+
event: HookEvent.PreToolUse,
|
|
173
|
+
timestamp: new Date(),
|
|
174
|
+
};
|
|
175
|
+
const result = await executor.execute(HookEvent.PreToolUse, context, {
|
|
176
|
+
continueOnError: true,
|
|
177
|
+
});
|
|
178
|
+
expect(result.hooksExecuted).toBe(3);
|
|
179
|
+
expect(result.hooksFailed).toBe(1);
|
|
180
|
+
expect(handler3).toHaveBeenCalled(); // Should continue despite error
|
|
181
|
+
});
|
|
182
|
+
it('should abort on error when continueOnError is false', async () => {
|
|
183
|
+
const handler1 = vi.fn(async () => ({ success: true }));
|
|
184
|
+
const handler2 = vi.fn(async () => {
|
|
185
|
+
throw new Error('Hook failed');
|
|
186
|
+
});
|
|
187
|
+
const handler3 = vi.fn(async () => ({ success: true }));
|
|
188
|
+
registry.register(HookEvent.PreToolUse, handler1, HookPriority.High);
|
|
189
|
+
registry.register(HookEvent.PreToolUse, handler2, HookPriority.Normal);
|
|
190
|
+
registry.register(HookEvent.PreToolUse, handler3, HookPriority.Low);
|
|
191
|
+
const context = {
|
|
192
|
+
event: HookEvent.PreToolUse,
|
|
193
|
+
timestamp: new Date(),
|
|
194
|
+
};
|
|
195
|
+
const result = await executor.execute(HookEvent.PreToolUse, context);
|
|
196
|
+
expect(result.aborted).toBe(true);
|
|
197
|
+
expect(result.hooksExecuted).toBe(2);
|
|
198
|
+
expect(handler3).not.toHaveBeenCalled(); // Should not execute after error
|
|
199
|
+
});
|
|
200
|
+
it('should abort when hook returns abort flag', async () => {
|
|
201
|
+
const handler1 = vi.fn(async () => ({ success: true }));
|
|
202
|
+
const handler2 = vi.fn(async () => ({ success: true, abort: true }));
|
|
203
|
+
const handler3 = vi.fn(async () => ({ success: true }));
|
|
204
|
+
registry.register(HookEvent.PreToolUse, handler1, HookPriority.High);
|
|
205
|
+
registry.register(HookEvent.PreToolUse, handler2, HookPriority.Normal);
|
|
206
|
+
registry.register(HookEvent.PreToolUse, handler3, HookPriority.Low);
|
|
207
|
+
const context = {
|
|
208
|
+
event: HookEvent.PreToolUse,
|
|
209
|
+
timestamp: new Date(),
|
|
210
|
+
};
|
|
211
|
+
const result = await executor.execute(HookEvent.PreToolUse, context);
|
|
212
|
+
expect(result.aborted).toBe(true);
|
|
213
|
+
expect(result.hooksExecuted).toBe(2);
|
|
214
|
+
expect(handler3).not.toHaveBeenCalled();
|
|
215
|
+
});
|
|
216
|
+
it('should merge context modifications', async () => {
|
|
217
|
+
const handler1 = vi.fn(async () => ({
|
|
218
|
+
success: true,
|
|
219
|
+
data: { metadata: { modified: true } },
|
|
220
|
+
}));
|
|
221
|
+
const handler2 = vi.fn(async (context) => {
|
|
222
|
+
expect(context.metadata?.modified).toBe(true);
|
|
223
|
+
return { success: true };
|
|
224
|
+
});
|
|
225
|
+
registry.register(HookEvent.PreToolUse, handler1, HookPriority.High);
|
|
226
|
+
registry.register(HookEvent.PreToolUse, handler2, HookPriority.Normal);
|
|
227
|
+
const context = {
|
|
228
|
+
event: HookEvent.PreToolUse,
|
|
229
|
+
timestamp: new Date(),
|
|
230
|
+
};
|
|
231
|
+
const result = await executor.execute(HookEvent.PreToolUse, context);
|
|
232
|
+
expect(result.finalContext?.metadata).toEqual({ modified: true });
|
|
233
|
+
});
|
|
234
|
+
it('should handle timeout', async () => {
|
|
235
|
+
const handler = vi.fn(async () => {
|
|
236
|
+
await new Promise(resolve => setTimeout(resolve, 200));
|
|
237
|
+
return { success: true };
|
|
238
|
+
});
|
|
239
|
+
registry.register(HookEvent.PreToolUse, handler);
|
|
240
|
+
const context = {
|
|
241
|
+
event: HookEvent.PreToolUse,
|
|
242
|
+
timestamp: new Date(),
|
|
243
|
+
};
|
|
244
|
+
const result = await executor.executeWithTimeout(HookEvent.PreToolUse, context, 100);
|
|
245
|
+
expect(result.success).toBe(false);
|
|
246
|
+
expect(result.hooksFailed).toBe(1);
|
|
247
|
+
});
|
|
248
|
+
it('should execute hooks in parallel', async () => {
|
|
249
|
+
const handler1 = vi.fn(async () => ({ success: true }));
|
|
250
|
+
const handler2 = vi.fn(async () => ({ success: true }));
|
|
251
|
+
registry.register(HookEvent.PreToolUse, handler1);
|
|
252
|
+
registry.register(HookEvent.PostToolUse, handler2);
|
|
253
|
+
const contexts = [
|
|
254
|
+
{ event: HookEvent.PreToolUse, timestamp: new Date() },
|
|
255
|
+
{ event: HookEvent.PostToolUse, timestamp: new Date() },
|
|
256
|
+
];
|
|
257
|
+
const results = await executor.executeParallel([HookEvent.PreToolUse, HookEvent.PostToolUse], contexts);
|
|
258
|
+
expect(results).toHaveLength(2);
|
|
259
|
+
expect(results[0].success).toBe(true);
|
|
260
|
+
expect(results[1].success).toBe(true);
|
|
261
|
+
});
|
|
262
|
+
it('should execute hooks sequentially with context chaining', async () => {
|
|
263
|
+
const handler1 = vi.fn(async () => ({
|
|
264
|
+
success: true,
|
|
265
|
+
data: { metadata: { step: 1 } },
|
|
266
|
+
}));
|
|
267
|
+
const handler2 = vi.fn(async () => ({
|
|
268
|
+
success: true,
|
|
269
|
+
data: { metadata: { step: 2 } },
|
|
270
|
+
}));
|
|
271
|
+
registry.register(HookEvent.PreToolUse, handler1);
|
|
272
|
+
registry.register(HookEvent.PostToolUse, handler2);
|
|
273
|
+
const initialContext = {
|
|
274
|
+
event: HookEvent.PreToolUse,
|
|
275
|
+
timestamp: new Date(),
|
|
276
|
+
};
|
|
277
|
+
const result = await executor.executeSequential([HookEvent.PreToolUse, HookEvent.PostToolUse], initialContext);
|
|
278
|
+
expect(result.success).toBe(true);
|
|
279
|
+
expect(result.hooksExecuted).toBe(2);
|
|
280
|
+
});
|
|
281
|
+
it('should emit events to event bus', async () => {
|
|
282
|
+
const preExecuteHandler = vi.fn();
|
|
283
|
+
const postExecuteHandler = vi.fn();
|
|
284
|
+
eventBus.on('hooks:pre-execute', preExecuteHandler);
|
|
285
|
+
eventBus.on('hooks:post-execute', postExecuteHandler);
|
|
286
|
+
const handler = vi.fn(async () => ({ success: true }));
|
|
287
|
+
registry.register(HookEvent.PreToolUse, handler);
|
|
288
|
+
const context = {
|
|
289
|
+
event: HookEvent.PreToolUse,
|
|
290
|
+
timestamp: new Date(),
|
|
291
|
+
};
|
|
292
|
+
await executor.execute(HookEvent.PreToolUse, context);
|
|
293
|
+
expect(preExecuteHandler).toHaveBeenCalled();
|
|
294
|
+
expect(postExecuteHandler).toHaveBeenCalled();
|
|
295
|
+
});
|
|
296
|
+
it('should skip disabled hooks', async () => {
|
|
297
|
+
const handler = vi.fn(async () => ({ success: true }));
|
|
298
|
+
const id = registry.register(HookEvent.PreToolUse, handler, HookPriority.Normal, {
|
|
299
|
+
enabled: false,
|
|
300
|
+
});
|
|
301
|
+
const context = {
|
|
302
|
+
event: HookEvent.PreToolUse,
|
|
303
|
+
timestamp: new Date(),
|
|
304
|
+
};
|
|
305
|
+
const result = await executor.execute(HookEvent.PreToolUse, context);
|
|
306
|
+
expect(result.hooksExecuted).toBe(0);
|
|
307
|
+
expect(handler).not.toHaveBeenCalled();
|
|
308
|
+
});
|
|
309
|
+
it('should record execution statistics', async () => {
|
|
310
|
+
const handler = vi.fn(async () => ({ success: true }));
|
|
311
|
+
registry.register(HookEvent.PreToolUse, handler);
|
|
312
|
+
const context = {
|
|
313
|
+
event: HookEvent.PreToolUse,
|
|
314
|
+
timestamp: new Date(),
|
|
315
|
+
};
|
|
316
|
+
await executor.execute(HookEvent.PreToolUse, context);
|
|
317
|
+
const stats = registry.getStats();
|
|
318
|
+
expect(stats.totalExecutions).toBe(1);
|
|
319
|
+
expect(stats.totalFailures).toBe(0);
|
|
320
|
+
});
|
|
321
|
+
});
|
|
322
|
+
//# sourceMappingURL=hooks.test.js.map
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* V3 Hooks System - Main Export
|
|
3
|
+
*
|
|
4
|
+
* Provides extensible hook points for tool execution, file operations,
|
|
5
|
+
* and session lifecycle events. Integrates with event bus for coordination.
|
|
6
|
+
*
|
|
7
|
+
* Example usage:
|
|
8
|
+
*
|
|
9
|
+
* ```typescript
|
|
10
|
+
* import { createHookRegistry, createHookExecutor, HookEvent, HookPriority } from '@claude-flow/shared/hooks';
|
|
11
|
+
*
|
|
12
|
+
* const registry = createHookRegistry();
|
|
13
|
+
* const executor = createHookExecutor(registry, eventBus);
|
|
14
|
+
*
|
|
15
|
+
* // Register a hook
|
|
16
|
+
* const hookId = registry.register(
|
|
17
|
+
* HookEvent.PreToolUse,
|
|
18
|
+
* async (context) => {
|
|
19
|
+
* console.log('Before tool use:', context.tool?.name);
|
|
20
|
+
* return { success: true };
|
|
21
|
+
* },
|
|
22
|
+
* HookPriority.High
|
|
23
|
+
* );
|
|
24
|
+
*
|
|
25
|
+
* // Execute hooks
|
|
26
|
+
* const result = await executor.execute(
|
|
27
|
+
* HookEvent.PreToolUse,
|
|
28
|
+
* {
|
|
29
|
+
* event: HookEvent.PreToolUse,
|
|
30
|
+
* timestamp: new Date(),
|
|
31
|
+
* tool: { name: 'Read', parameters: { path: 'file.ts' } }
|
|
32
|
+
* }
|
|
33
|
+
* );
|
|
34
|
+
*
|
|
35
|
+
* // Unregister hook
|
|
36
|
+
* registry.unregister(hookId);
|
|
37
|
+
* ```
|
|
38
|
+
*
|
|
39
|
+
* @module v3/shared/hooks
|
|
40
|
+
*/
|
|
41
|
+
export type { HookContext, HookResult, HookHandler, HookDefinition, HookStats, HookExecutionOptions, ToolInfo, CommandInfo, FileOperationInfo, SessionInfo, AgentInfo, TaskInfo, MemoryInfo, ErrorInfo, } from './types.js';
|
|
42
|
+
export { HookEvent, HookPriority, } from './types.js';
|
|
43
|
+
export { HookRegistry, createHookRegistry, } from './registry.js';
|
|
44
|
+
export type { AggregatedHookResult, } from './executor.js';
|
|
45
|
+
export { HookExecutor, createHookExecutor, } from './executor.js';
|
|
46
|
+
export { TaskHooksManager, createTaskHooksManager, } from './task-hooks.js';
|
|
47
|
+
export type { PreTaskHookResult, PostTaskHookResult, AgentSuggestion, TaskPattern, TaskOutcome, LearningUpdate, } from './task-hooks.js';
|
|
48
|
+
export { SessionHooksManager, createSessionHooksManager, InMemorySessionStorage, } from './session-hooks.js';
|
|
49
|
+
export type { SessionState, SessionEndHookResult, SessionRestoreHookResult, SessionSummary, SessionStorage, } from './session-hooks.js';
|
|
50
|
+
export { BashSafetyHook, createBashSafetyHook, FileOrganizationHook, createFileOrganizationHook, GitCommitHook, createGitCommitHook, } from './safety/index.js';
|
|
51
|
+
export type { BashSafetyResult, CommandRisk, FileOrganizationResult, FormatterRecommendation, LinterRecommendation, OrganizationIssue, GitCommitResult, CommitType, CommitValidationIssue, } from './safety/index.js';
|
|
52
|
+
//# sourceMappingURL=index.d.ts.map
|