claude-flow-novice 1.6.4 → 1.6.6
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/commands/parse-epic.js +180 -0
- package/.claude/settings.local.json +2 -1
- package/.claude-flow-novice/dist/mcp/mcp-server-novice.js +37 -2
- package/.claude-flow-novice/dist/mcp/mcp-server-sdk.js +45 -0
- package/.claude-flow-novice/dist/mcp/transports/base.js +5 -0
- package/.claude-flow-novice/dist/mcp/transports/base.js.map +1 -0
- package/.claude-flow-novice/dist/mcp/transports/http.js +414 -0
- package/.claude-flow-novice/dist/mcp/transports/http.js.map +1 -0
- package/.claude-flow-novice/dist/mcp/transports/stdio.js +217 -0
- package/.claude-flow-novice/dist/mcp/transports/stdio.js.map +1 -0
- package/.claude-flow-novice/dist/src/cli/commands/parse-epic.js +129 -0
- package/.claude-flow-novice/dist/src/cli/commands/parse-epic.js.map +1 -0
- package/.claude-flow-novice/dist/src/cli/index.js +3 -0
- package/.claude-flow-novice/dist/src/cli/index.js.map +1 -1
- package/.claude-flow-novice/dist/src/cli/utils/epic-parser.js +266 -0
- package/.claude-flow-novice/dist/src/cli/utils/epic-parser.js.map +1 -0
- package/.claude-flow-novice/dist/src/communication/message-bus.js +105 -2
- package/.claude-flow-novice/dist/src/communication/message-bus.js.map +1 -1
- package/.claude-flow-novice/dist/src/coordination/adapters/v1-coordinator-adapter.js +1 -1
- package/.claude-flow-novice/dist/src/coordination/adapters/v1-coordinator-adapter.js.map +1 -1
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/cache/artifact-cache-optimizer.js +632 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/cache/artifact-cache-optimizer.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/cache/index.js +11 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/cache/index.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/checkpoints/checkpoint-compressor.js +318 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/checkpoints/checkpoint-compressor.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/completion/completion-detector.js +234 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/completion/completion-detector.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/completion/hierarchical-detector.js +347 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/completion/hierarchical-detector.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/completion/index.js +13 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/completion/index.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/completion/lamport-clock.js +173 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/completion/lamport-clock.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/completion/mesh-detector.js +526 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/completion/mesh-detector.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/completion/sdk-completion-detector.js +443 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/completion/sdk-completion-detector.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/completion/swarm-shutdown.js +366 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/completion/swarm-shutdown.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/coordinator-factory.js +287 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/coordinator-factory.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/coordinators/cascading-shutdown.example.js +364 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/coordinators/cascading-shutdown.example.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/coordinators/cascading-shutdown.js +492 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/coordinators/cascading-shutdown.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/coordinators/hierarchical-coordinator.js +786 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/coordinators/hierarchical-coordinator.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/coordinators/index.js +16 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/coordinators/index.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/coordinators/parent-child-manager.js +342 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/coordinators/parent-child-manager.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/coordinators/swarm-coordinator-v2.js +601 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/coordinators/swarm-coordinator-v2.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/agent-state.js +9 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/agent-state.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/dead-letter-queue.js +413 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/dead-letter-queue.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/dependency-graph.js +471 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/dependency-graph.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/dependency-node.js +379 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/dependency-node.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/dependency-resolver.js +335 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/dependency-resolver.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/help-request-metrics.js +211 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/help-request-metrics.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/index.js +33 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/index.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/message-broker.js +920 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/message-broker.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/message-router.js +385 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/message-router.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/message.js +138 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/message.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/resource-manager-safe.js +478 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/resource-manager-safe.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/state-machine-config.js +358 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/state-machine-config.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/state-machine.js +588 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/state-machine.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/state-transition.js +153 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/state-transition.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/task-scheduler.js +360 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/task-scheduler.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/topic-manager.js +337 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/core/topic-manager.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/deadlock/deadlock-detector.js +424 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/deadlock/deadlock-detector.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/deadlock/index.js +9 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/deadlock/index.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/deadlock/resource-manager.js +669 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/deadlock/resource-manager.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/dependency/artifact-storage.js +451 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/dependency/artifact-storage.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/dependency/cycle-detector.js +271 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/dependency/cycle-detector.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/dependency/dependency-graph.js +335 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/dependency/dependency-graph.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/dependency/dependency-manager.js +439 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/dependency/dependency-manager.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/dependency/dependency-request.js +92 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/dependency/dependency-request.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/dependency/index.js +21 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/dependency/index.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/dependency/topological-sort.js +223 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/dependency/topological-sort.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/help-system/help-coordinator.js +436 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/help-system/help-coordinator.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/help-system/help-matcher.js +278 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/help-system/help-matcher.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/help-system/help-request-handler.js +317 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/help-system/help-request-handler.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/help-system/help-request.js +273 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/help-system/help-request.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/help-system/index.js +15 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/help-system/index.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/help-system/waiting-agent-pool.js +512 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/help-system/waiting-agent-pool.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/index.js +67 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/index.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/integration/help-deadlock-integration.js +557 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/integration/help-deadlock-integration.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/integration/index.js +14 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/integration/index.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/integration/message-bus-completion-integration.example.js +212 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/integration/message-bus-completion-integration.example.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/integration/message-bus-completion-integration.js +552 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/integration/message-bus-completion-integration.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/integration/state-machine-integration.js +635 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/integration/state-machine-integration.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/interfaces/IArtifactStorage.js +28 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/interfaces/IArtifactStorage.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/interfaces/ICoordinator.js +9 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/interfaces/ICoordinator.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/interfaces/ISessionStore.js +25 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/interfaces/ISessionStore.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/interfaces/index.js +14 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/interfaces/index.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/memory/artifact-adapter.js +308 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/memory/artifact-adapter.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/memory/completion-storage.js +439 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/memory/completion-storage.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/memory/dependency-graph-storage.js +540 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/memory/dependency-graph-storage.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/memory/dependency-storage.js +367 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/memory/dependency-storage.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/memory/index.js +14 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/memory/index.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/memory/message-storage.js +518 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/memory/message-storage.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/memory/state-storage.js +377 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/memory/state-storage.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/messaging/channel.js +371 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/messaging/channel.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/messaging/channels/dependency-channel.js +355 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/messaging/channels/dependency-channel.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/messaging/channels/help-channel.js +424 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/messaging/channels/help-channel.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/messaging/channels/index.js +16 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/messaging/channels/index.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/messaging/channels/state-channel.js +295 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/messaging/channels/state-channel.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/messaging/channels/task-channel.js +411 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/messaging/channels/task-channel.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/messaging/index.js +14 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/messaging/index.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/messaging/message-bus.js +387 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/messaging/message-bus.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/messaging/message-persistence.js +589 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/messaging/message-persistence.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/messaging/message-router.js +444 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/messaging/message-router.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/sdk/artifact-storage.js +560 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/sdk/artifact-storage.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/sdk/background-orchestrator.js +335 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/sdk/background-orchestrator.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/sdk/bash-output-monitor.js +104 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/sdk/bash-output-monitor.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/sdk/checkpoint-manager.js +847 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/sdk/checkpoint-manager.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/sdk/help-coordinator.js +470 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/sdk/help-coordinator.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/sdk/hierarchical-background-integration.js +450 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/sdk/hierarchical-background-integration.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/sdk/index.js +13 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/sdk/index.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/sdk/message-bus-integration.js +625 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/sdk/message-bus-integration.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/sdk/multi-level-control.js +545 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/sdk/multi-level-control.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/sdk/query-controller.js +740 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/sdk/query-controller.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/sdk/query-message-integration.js +415 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/sdk/query-message-integration.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/sdk/session-pool-optimizer.js +615 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/sdk/session-pool-optimizer.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/sdk/state-machine-integration.js +547 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/sdk/state-machine-integration.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/sdk/state-sdk-integration.js +342 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/sdk/state-sdk-integration.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/security/payload-validator.js +259 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/security/payload-validator.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/truth/framework-registry.js +273 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/truth/framework-registry.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/truth/index.js +8 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/truth/index.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/truth/truth-config-manager.js +310 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/truth/truth-config-manager.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/truth/truth-validator.js +218 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/truth/truth-validator.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/types/sdk.js +9 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/types/sdk.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/utils/index.js +6 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/utils/index.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/utils/priority-queue.js +145 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/utils/priority-queue.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/utils/sdk-helpers.js +122 -0
- package/.claude-flow-novice/dist/src/coordination/archives/v2-sdk-typescript/v2/utils/sdk-helpers.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/config-translator.js +17 -43
- package/.claude-flow-novice/dist/src/coordination/config-translator.js.map +1 -1
- package/.claude-flow-novice/dist/src/coordination/coordination-toggle.js +34 -76
- package/.claude-flow-novice/dist/src/coordination/coordination-toggle.js.map +1 -1
- package/.claude-flow-novice/dist/src/coordination/shared/core/agent-state.js +172 -0
- package/.claude-flow-novice/dist/src/coordination/shared/core/agent-state.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/shared/core/index.js +7 -0
- package/.claude-flow-novice/dist/src/coordination/shared/core/index.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/shared/index.js +19 -0
- package/.claude-flow-novice/dist/src/coordination/shared/index.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/shared/interfaces/ICoordinator.js +24 -0
- package/.claude-flow-novice/dist/src/coordination/shared/interfaces/ICoordinator.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/shared/interfaces/index.js +7 -0
- package/.claude-flow-novice/dist/src/coordination/shared/interfaces/index.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/shared/message-broker.js +920 -0
- package/.claude-flow-novice/dist/src/coordination/shared/message-broker.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/shared/message.js +138 -0
- package/.claude-flow-novice/dist/src/coordination/shared/message.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/shared/security/payload-validator.js +259 -0
- package/.claude-flow-novice/dist/src/coordination/shared/security/payload-validator.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/shared/transparency/index.js +17 -0
- package/.claude-flow-novice/dist/src/coordination/shared/transparency/index.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/shared/transparency/interfaces/transparency-system.js +19 -0
- package/.claude-flow-novice/dist/src/coordination/shared/transparency/interfaces/transparency-system.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/shared/transparency/transparency-integration.js +357 -0
- package/.claude-flow-novice/dist/src/coordination/shared/transparency/transparency-integration.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/shared/transparency/transparency-system.js +679 -0
- package/.claude-flow-novice/dist/src/coordination/shared/transparency/transparency-system.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/shared/types/index.js +7 -0
- package/.claude-flow-novice/dist/src/coordination/shared/types/index.js.map +1 -0
- package/.claude-flow-novice/dist/src/coordination/shared/types/sdk.js +10 -0
- package/.claude-flow-novice/dist/src/coordination/shared/types/sdk.js.map +1 -0
- package/.claude-flow-novice/dist/src/feature-flags/core/FeatureFlagManager.js +52 -2
- package/.claude-flow-novice/dist/src/feature-flags/core/FeatureFlagManager.js.map +1 -1
- package/.claude-flow-novice/dist/src/mcp/mcp-server-novice.js +37 -2
- package/.claude-flow-novice/dist/src/mcp/session-manager.js +3 -1
- package/.claude-flow-novice/dist/src/mcp/session-manager.js.map +1 -1
- package/.claude-flow-novice/dist/src/providers/provider-manager.js +36 -3
- package/.claude-flow-novice/dist/src/providers/provider-manager.js.map +1 -1
- package/.claude-flow-novice/dist/src/utils/markdown-sanitizer.js +65 -41
- package/.claude-flow-novice/dist/src/utils/markdown-sanitizer.js.map +1 -1
- package/.claude-flow-novice/dist/src/web/api/server.js +1 -1
- package/.claude-flow-novice/dist/src/web/api/server.js.map +1 -1
- package/.claude-flow-novice/dist/src/workflows/progressive-rollout-manager.js +30 -0
- package/.claude-flow-novice/dist/src/workflows/progressive-rollout-manager.js.map +1 -1
- package/.claude-flow-novice/metrics.db-shm +0 -0
- package/.claude-flow-novice/metrics.db-wal +0 -0
- package/config/.env.example +178 -0
- package/config/DEPLOYMENT_GUIDE.md +692 -0
- package/config/README-CONFIG.md +331 -0
- package/config/coordination-config.sh +327 -0
- package/config/docker/env.development +53 -0
- package/config/docker/env.production +83 -0
- package/config/docker/env.staging +70 -0
- package/config/k8s/configmap-development.yaml +60 -0
- package/config/k8s/configmap-production.yaml +85 -0
- package/config/k8s/configmap-staging.yaml +76 -0
- package/config/k8s/secret-production.yaml +62 -0
- package/config/k8s/secret-staging.yaml +36 -0
- package/package.json +2 -2
- package/scripts/monitoring/alert-monitor.sh +220 -0
- package/scripts/monitoring/dashboards/rate-limiting-dashboard.json +211 -0
- package/scripts/monitoring/quick-test-alerting.sh +118 -0
- package/scripts/monitoring/quick-test-rate-limiting.sh +206 -0
- package/scripts/monitoring/rate-limiting-monitor.sh +380 -0
- package/scripts/monitoring/view-alerts.sh +307 -0
- package/scripts/test-zai-api.cjs +2 -2
- package/src/slash-commands/parse-epic.js +1 -1
|
@@ -0,0 +1,358 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Agent Coordination V2 - State Machine Configuration
|
|
3
|
+
*
|
|
4
|
+
* Defines the state transition matrix, validation rules, and configuration
|
|
5
|
+
* for the agent coordination state machine. Provides runtime validation
|
|
6
|
+
* and integration with SDK session events.
|
|
7
|
+
*
|
|
8
|
+
* @module coordination/v2/core/state-machine-config
|
|
9
|
+
*/ import { AgentState, isAgentState } from './agent-state.js';
|
|
10
|
+
import { TransitionEventType } from './state-transition.js';
|
|
11
|
+
/**
|
|
12
|
+
* State transition matrix defining allowed state changes.
|
|
13
|
+
*
|
|
14
|
+
* Each state maps to an array of valid next states.
|
|
15
|
+
* Empty array indicates terminal state (no further transitions).
|
|
16
|
+
*
|
|
17
|
+
* @example
|
|
18
|
+
* ```typescript
|
|
19
|
+
* STATE_TRANSITIONS[AgentState.IDLE] // [AgentState.WORKING, AgentState.HELPING]
|
|
20
|
+
* STATE_TRANSITIONS[AgentState.COMPLETED] // []
|
|
21
|
+
* ```
|
|
22
|
+
*/ export const STATE_TRANSITIONS = {
|
|
23
|
+
[AgentState.IDLE]: [
|
|
24
|
+
AgentState.WORKING,
|
|
25
|
+
AgentState.HELPING
|
|
26
|
+
],
|
|
27
|
+
[AgentState.WORKING]: [
|
|
28
|
+
AgentState.WAITING,
|
|
29
|
+
AgentState.HELPING,
|
|
30
|
+
AgentState.PAUSED,
|
|
31
|
+
AgentState.BLOCKED,
|
|
32
|
+
AgentState.COMPLETED,
|
|
33
|
+
AgentState.TERMINATED,
|
|
34
|
+
AgentState.ERROR
|
|
35
|
+
],
|
|
36
|
+
[AgentState.WAITING]: [
|
|
37
|
+
AgentState.WORKING,
|
|
38
|
+
AgentState.HELPING,
|
|
39
|
+
AgentState.BLOCKED,
|
|
40
|
+
AgentState.PAUSED,
|
|
41
|
+
AgentState.TERMINATED,
|
|
42
|
+
AgentState.ERROR
|
|
43
|
+
],
|
|
44
|
+
[AgentState.HELPING]: [
|
|
45
|
+
AgentState.WORKING,
|
|
46
|
+
AgentState.IDLE,
|
|
47
|
+
AgentState.ERROR
|
|
48
|
+
],
|
|
49
|
+
[AgentState.PAUSED]: [
|
|
50
|
+
AgentState.WORKING,
|
|
51
|
+
AgentState.IDLE,
|
|
52
|
+
AgentState.TERMINATED
|
|
53
|
+
],
|
|
54
|
+
[AgentState.BLOCKED]: [
|
|
55
|
+
AgentState.WORKING,
|
|
56
|
+
AgentState.PAUSED,
|
|
57
|
+
AgentState.TERMINATED,
|
|
58
|
+
AgentState.ERROR
|
|
59
|
+
],
|
|
60
|
+
[AgentState.COMPLETED]: [],
|
|
61
|
+
[AgentState.TERMINATED]: [],
|
|
62
|
+
[AgentState.ERROR]: [
|
|
63
|
+
AgentState.IDLE
|
|
64
|
+
]
|
|
65
|
+
};
|
|
66
|
+
/**
|
|
67
|
+
* Event type to state transition mapping.
|
|
68
|
+
*
|
|
69
|
+
* Maps each transition event type to the expected state change.
|
|
70
|
+
* Used to automatically determine target state from event type.
|
|
71
|
+
*/ export const EVENT_STATE_MAPPING = {
|
|
72
|
+
[TransitionEventType.TASK_ASSIGNED]: {
|
|
73
|
+
from: [
|
|
74
|
+
AgentState.IDLE
|
|
75
|
+
],
|
|
76
|
+
to: AgentState.WORKING
|
|
77
|
+
},
|
|
78
|
+
[TransitionEventType.EXECUTION_STARTED]: {
|
|
79
|
+
from: [
|
|
80
|
+
AgentState.IDLE,
|
|
81
|
+
AgentState.WAITING,
|
|
82
|
+
AgentState.BLOCKED
|
|
83
|
+
],
|
|
84
|
+
to: AgentState.WORKING
|
|
85
|
+
},
|
|
86
|
+
[TransitionEventType.EXECUTION_COMPLETED]: {
|
|
87
|
+
from: [
|
|
88
|
+
AgentState.WORKING
|
|
89
|
+
],
|
|
90
|
+
to: AgentState.COMPLETED
|
|
91
|
+
},
|
|
92
|
+
[TransitionEventType.EXECUTION_FAILED]: {
|
|
93
|
+
from: [
|
|
94
|
+
AgentState.WORKING,
|
|
95
|
+
AgentState.WAITING,
|
|
96
|
+
AgentState.HELPING
|
|
97
|
+
],
|
|
98
|
+
to: AgentState.ERROR
|
|
99
|
+
},
|
|
100
|
+
[TransitionEventType.DEPENDENCY_BLOCKED]: {
|
|
101
|
+
from: [
|
|
102
|
+
AgentState.WORKING
|
|
103
|
+
],
|
|
104
|
+
to: AgentState.WAITING
|
|
105
|
+
},
|
|
106
|
+
[TransitionEventType.DEPENDENCY_RESOLVED]: {
|
|
107
|
+
from: [
|
|
108
|
+
AgentState.WAITING
|
|
109
|
+
],
|
|
110
|
+
to: AgentState.WORKING
|
|
111
|
+
},
|
|
112
|
+
[TransitionEventType.HELP_REQUESTED]: {
|
|
113
|
+
from: [
|
|
114
|
+
AgentState.IDLE,
|
|
115
|
+
AgentState.WORKING
|
|
116
|
+
],
|
|
117
|
+
to: AgentState.HELPING
|
|
118
|
+
},
|
|
119
|
+
[TransitionEventType.HELP_COMPLETED]: {
|
|
120
|
+
from: [
|
|
121
|
+
AgentState.HELPING
|
|
122
|
+
],
|
|
123
|
+
to: AgentState.WORKING
|
|
124
|
+
},
|
|
125
|
+
[TransitionEventType.DEADLOCK_DETECTED]: {
|
|
126
|
+
from: [
|
|
127
|
+
AgentState.WAITING
|
|
128
|
+
],
|
|
129
|
+
to: AgentState.BLOCKED
|
|
130
|
+
},
|
|
131
|
+
[TransitionEventType.ERROR_RECOVERED]: {
|
|
132
|
+
from: [
|
|
133
|
+
AgentState.ERROR
|
|
134
|
+
],
|
|
135
|
+
to: AgentState.IDLE
|
|
136
|
+
}
|
|
137
|
+
};
|
|
138
|
+
/**
|
|
139
|
+
* Default state machine configuration.
|
|
140
|
+
*/ export const DEFAULT_STATE_MACHINE_CONFIG = {
|
|
141
|
+
strictValidation: true,
|
|
142
|
+
enableLogging: false,
|
|
143
|
+
enablePerformanceTracking: true,
|
|
144
|
+
maxValidationTime: 1,
|
|
145
|
+
enableAutoRecovery: true,
|
|
146
|
+
maxRetryAttempts: 3
|
|
147
|
+
};
|
|
148
|
+
/**
|
|
149
|
+
* Validates the state transition matrix for completeness and correctness.
|
|
150
|
+
*
|
|
151
|
+
* Ensures:
|
|
152
|
+
* - All states have entries in the transition map
|
|
153
|
+
* - All target states are valid AgentState values
|
|
154
|
+
* - Terminal states have empty transition arrays
|
|
155
|
+
* - No circular references in terminal states
|
|
156
|
+
*
|
|
157
|
+
* @param transitions - State transition matrix to validate
|
|
158
|
+
* @returns Validation result with details
|
|
159
|
+
*
|
|
160
|
+
* @example
|
|
161
|
+
* ```typescript
|
|
162
|
+
* const result = validateTransitionMatrix(STATE_TRANSITIONS);
|
|
163
|
+
* if (!result.isValid) {
|
|
164
|
+
* console.error(result.errors);
|
|
165
|
+
* }
|
|
166
|
+
* ```
|
|
167
|
+
*/ export function validateTransitionMatrix(transitions) {
|
|
168
|
+
const errors = [];
|
|
169
|
+
// Validate all states have entries
|
|
170
|
+
const allStates = Object.values(AgentState);
|
|
171
|
+
for (const state of allStates){
|
|
172
|
+
if (!(state in transitions)) {
|
|
173
|
+
errors.push(`Missing transition entry for state: ${state}`);
|
|
174
|
+
}
|
|
175
|
+
}
|
|
176
|
+
// Validate all target states are valid
|
|
177
|
+
for (const [sourceState, targetStates] of Object.entries(transitions)){
|
|
178
|
+
if (!isAgentState(sourceState)) {
|
|
179
|
+
errors.push(`Invalid source state: ${sourceState}`);
|
|
180
|
+
continue;
|
|
181
|
+
}
|
|
182
|
+
for (const targetState of targetStates){
|
|
183
|
+
if (!isAgentState(targetState)) {
|
|
184
|
+
errors.push(`Invalid target state from ${sourceState}: ${targetState}`);
|
|
185
|
+
}
|
|
186
|
+
}
|
|
187
|
+
// Validate terminal states
|
|
188
|
+
if (sourceState === AgentState.COMPLETED || sourceState === AgentState.TERMINATED || sourceState === AgentState.ERROR) {
|
|
189
|
+
// ERROR can transition to IDLE for recovery, but COMPLETED and TERMINATED should be terminal
|
|
190
|
+
if ((sourceState === AgentState.COMPLETED || sourceState === AgentState.TERMINATED) && targetStates.length > 0) {
|
|
191
|
+
errors.push(`Terminal state ${sourceState} should have no transitions`);
|
|
192
|
+
}
|
|
193
|
+
}
|
|
194
|
+
}
|
|
195
|
+
return {
|
|
196
|
+
isValid: errors.length === 0,
|
|
197
|
+
errors
|
|
198
|
+
};
|
|
199
|
+
}
|
|
200
|
+
/**
|
|
201
|
+
* Validates event-to-state mapping for completeness.
|
|
202
|
+
*
|
|
203
|
+
* Ensures all event types have corresponding state mappings
|
|
204
|
+
* and that mapped states are valid.
|
|
205
|
+
*
|
|
206
|
+
* @param mapping - Event state mapping to validate
|
|
207
|
+
* @returns Validation result with details
|
|
208
|
+
*
|
|
209
|
+
* @example
|
|
210
|
+
* ```typescript
|
|
211
|
+
* const result = validateEventMapping(EVENT_STATE_MAPPING);
|
|
212
|
+
* if (!result.isValid) {
|
|
213
|
+
* console.error(result.errors);
|
|
214
|
+
* }
|
|
215
|
+
* ```
|
|
216
|
+
*/ export function validateEventMapping(mapping) {
|
|
217
|
+
const errors = [];
|
|
218
|
+
// Validate all event types have mappings
|
|
219
|
+
const allEventTypes = Object.values(TransitionEventType);
|
|
220
|
+
for (const eventType of allEventTypes){
|
|
221
|
+
if (!(eventType in mapping)) {
|
|
222
|
+
errors.push(`Missing event mapping for: ${eventType}`);
|
|
223
|
+
continue;
|
|
224
|
+
}
|
|
225
|
+
const eventMapping = mapping[eventType];
|
|
226
|
+
// Validate from states
|
|
227
|
+
if (!eventMapping.from || eventMapping.from.length === 0) {
|
|
228
|
+
errors.push(`Event ${eventType} has no source states`);
|
|
229
|
+
} else {
|
|
230
|
+
for (const fromState of eventMapping.from){
|
|
231
|
+
if (!isAgentState(fromState)) {
|
|
232
|
+
errors.push(`Invalid from state for ${eventType}: ${fromState}`);
|
|
233
|
+
}
|
|
234
|
+
}
|
|
235
|
+
}
|
|
236
|
+
// Validate to state
|
|
237
|
+
if (!isAgentState(eventMapping.to)) {
|
|
238
|
+
errors.push(`Invalid to state for ${eventType}: ${eventMapping.to}`);
|
|
239
|
+
}
|
|
240
|
+
}
|
|
241
|
+
return {
|
|
242
|
+
isValid: errors.length === 0,
|
|
243
|
+
errors
|
|
244
|
+
};
|
|
245
|
+
}
|
|
246
|
+
/**
|
|
247
|
+
* Gets all valid next states for a given current state.
|
|
248
|
+
*
|
|
249
|
+
* @param currentState - Current agent state
|
|
250
|
+
* @returns Array of valid next states
|
|
251
|
+
* @throws Error if current state is invalid
|
|
252
|
+
*
|
|
253
|
+
* @example
|
|
254
|
+
* ```typescript
|
|
255
|
+
* const nextStates = getValidNextStates(AgentState.WORKING);
|
|
256
|
+
* // [AgentState.WAITING, AgentState.HELPING, AgentState.COMPLETED, AgentState.ERROR]
|
|
257
|
+
* ```
|
|
258
|
+
*/ export function getValidNextStates(currentState) {
|
|
259
|
+
const transitions = STATE_TRANSITIONS[currentState];
|
|
260
|
+
if (!transitions) {
|
|
261
|
+
throw new Error(`Invalid current state: ${currentState}`);
|
|
262
|
+
}
|
|
263
|
+
return [
|
|
264
|
+
...transitions
|
|
265
|
+
]; // Return copy to prevent mutation
|
|
266
|
+
}
|
|
267
|
+
/**
|
|
268
|
+
* Checks if a specific state transition is valid.
|
|
269
|
+
*
|
|
270
|
+
* @param fromState - Current state
|
|
271
|
+
* @param toState - Target state
|
|
272
|
+
* @returns True if transition is valid
|
|
273
|
+
*
|
|
274
|
+
* @example
|
|
275
|
+
* ```typescript
|
|
276
|
+
* if (isValidTransition(AgentState.IDLE, AgentState.WORKING)) {
|
|
277
|
+
* // Proceed with transition
|
|
278
|
+
* }
|
|
279
|
+
* ```
|
|
280
|
+
*/ export function isValidTransition(fromState, toState) {
|
|
281
|
+
const validStates = STATE_TRANSITIONS[fromState];
|
|
282
|
+
return validStates ? validStates.includes(toState) : false;
|
|
283
|
+
}
|
|
284
|
+
/**
|
|
285
|
+
* Gets the expected state transition for a given event type.
|
|
286
|
+
*
|
|
287
|
+
* @param eventType - Transition event type
|
|
288
|
+
* @param currentState - Current agent state
|
|
289
|
+
* @returns Expected target state, or null if transition not applicable
|
|
290
|
+
*
|
|
291
|
+
* @example
|
|
292
|
+
* ```typescript
|
|
293
|
+
* const nextState = getExpectedStateForEvent(
|
|
294
|
+
* TransitionEventType.TASK_ASSIGNED,
|
|
295
|
+
* AgentState.IDLE
|
|
296
|
+
* );
|
|
297
|
+
* // AgentState.WORKING
|
|
298
|
+
* ```
|
|
299
|
+
*/ export function getExpectedStateForEvent(eventType, currentState) {
|
|
300
|
+
const mapping = EVENT_STATE_MAPPING[eventType];
|
|
301
|
+
if (!mapping) {
|
|
302
|
+
return null;
|
|
303
|
+
}
|
|
304
|
+
// Check if current state is valid for this event
|
|
305
|
+
if (!mapping.from.includes(currentState)) {
|
|
306
|
+
return null;
|
|
307
|
+
}
|
|
308
|
+
return mapping.to;
|
|
309
|
+
}
|
|
310
|
+
/**
|
|
311
|
+
* Self-validation of the state machine configuration.
|
|
312
|
+
* Should be called during initialization to ensure configuration integrity.
|
|
313
|
+
*
|
|
314
|
+
* @returns Validation result with detailed error report
|
|
315
|
+
*
|
|
316
|
+
* @example
|
|
317
|
+
* ```typescript
|
|
318
|
+
* const validation = validateStateMachineConfig();
|
|
319
|
+
* if (!validation.isValid) {
|
|
320
|
+
* console.error('State machine configuration invalid:', validation.errors);
|
|
321
|
+
* throw new Error('Invalid state machine configuration');
|
|
322
|
+
* }
|
|
323
|
+
* ```
|
|
324
|
+
*/ export function validateStateMachineConfig() {
|
|
325
|
+
const errors = [];
|
|
326
|
+
// Validate transition matrix
|
|
327
|
+
const matrixValidation = validateTransitionMatrix(STATE_TRANSITIONS);
|
|
328
|
+
if (!matrixValidation.isValid) {
|
|
329
|
+
errors.push(...matrixValidation.errors);
|
|
330
|
+
}
|
|
331
|
+
// Validate event mapping
|
|
332
|
+
const eventValidation = validateEventMapping(EVENT_STATE_MAPPING);
|
|
333
|
+
if (!eventValidation.isValid) {
|
|
334
|
+
errors.push(...eventValidation.errors);
|
|
335
|
+
}
|
|
336
|
+
// Validate that event mappings align with transition matrix
|
|
337
|
+
for (const [eventType, mapping] of Object.entries(EVENT_STATE_MAPPING)){
|
|
338
|
+
for (const fromState of mapping.from){
|
|
339
|
+
if (!isValidTransition(fromState, mapping.to)) {
|
|
340
|
+
errors.push(`Event mapping ${eventType} conflicts with transition matrix: ` + `${fromState} -> ${mapping.to} is not allowed`);
|
|
341
|
+
}
|
|
342
|
+
}
|
|
343
|
+
}
|
|
344
|
+
return {
|
|
345
|
+
isValid: errors.length === 0,
|
|
346
|
+
errors
|
|
347
|
+
};
|
|
348
|
+
}
|
|
349
|
+
// Run self-validation on module load (development safety check)
|
|
350
|
+
if (process.env.NODE_ENV !== 'production') {
|
|
351
|
+
const validation = validateStateMachineConfig();
|
|
352
|
+
if (!validation.isValid) {
|
|
353
|
+
console.error('State machine configuration validation failed:');
|
|
354
|
+
validation.errors.forEach((err)=>console.error(` - ${err}`));
|
|
355
|
+
}
|
|
356
|
+
}
|
|
357
|
+
|
|
358
|
+
//# sourceMappingURL=state-machine-config.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../../../../../../../../src/coordination/archives/v2-sdk-typescript/v2/core/state-machine-config.ts"],"names":["AgentState","isAgentState","TransitionEventType","STATE_TRANSITIONS","IDLE","WORKING","HELPING","WAITING","PAUSED","BLOCKED","COMPLETED","TERMINATED","ERROR","EVENT_STATE_MAPPING","TASK_ASSIGNED","from","to","EXECUTION_STARTED","EXECUTION_COMPLETED","EXECUTION_FAILED","DEPENDENCY_BLOCKED","DEPENDENCY_RESOLVED","HELP_REQUESTED","HELP_COMPLETED","DEADLOCK_DETECTED","ERROR_RECOVERED","DEFAULT_STATE_MACHINE_CONFIG","strictValidation","enableLogging","enablePerformanceTracking","maxValidationTime","enableAutoRecovery","maxRetryAttempts","validateTransitionMatrix","transitions","errors","allStates","Object","values","state","push","sourceState","targetStates","entries","targetState","length","isValid","validateEventMapping","mapping","allEventTypes","eventType","eventMapping","fromState","getValidNextStates","currentState","Error","isValidTransition","toState","validStates","includes","getExpectedStateForEvent","validateStateMachineConfig","matrixValidation","eventValidation","process","env","NODE_ENV","validation","console","error","forEach","err"],"mappings":"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"}
|