groundswell 0.0.2 → 1.0.0
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/LICENSE +21 -0
- package/README.md +26 -9
- package/dist/cache/cache-key.d.ts +86 -0
- package/dist/cache/cache-key.d.ts.map +1 -0
- package/dist/cache/cache-key.js +204 -0
- package/dist/cache/cache-key.js.map +1 -0
- package/dist/cache/cache.d.ts +104 -0
- package/dist/cache/cache.d.ts.map +1 -0
- package/dist/cache/cache.js +179 -0
- package/dist/cache/cache.js.map +1 -0
- package/{src/cache/index.ts → dist/cache/index.d.ts} +1 -1
- package/dist/cache/index.d.ts.map +1 -0
- package/dist/cache/index.js +6 -0
- package/dist/cache/index.js.map +1 -0
- package/dist/core/agent.d.ts +203 -0
- package/dist/core/agent.d.ts.map +1 -0
- package/dist/core/agent.js +833 -0
- package/dist/core/agent.js.map +1 -0
- package/{src/core/context.ts → dist/core/context.d.ts} +16 -67
- package/dist/core/context.d.ts.map +1 -0
- package/dist/core/context.js +80 -0
- package/dist/core/context.js.map +1 -0
- package/dist/core/event-tree.d.ts +72 -0
- package/dist/core/event-tree.d.ts.map +1 -0
- package/dist/core/event-tree.js +211 -0
- package/dist/core/event-tree.js.map +1 -0
- package/{src/core/factory.ts → dist/core/factory.d.ts} +6 -27
- package/dist/core/factory.d.ts.map +1 -0
- package/dist/core/factory.js +110 -0
- package/dist/core/factory.js.map +1 -0
- package/{src/core/index.ts → dist/core/index.d.ts} +2 -10
- package/dist/core/index.d.ts.map +1 -0
- package/dist/core/index.js +9 -0
- package/dist/core/index.js.map +1 -0
- package/dist/core/logger.d.ts +50 -0
- package/dist/core/logger.d.ts.map +1 -0
- package/dist/core/logger.js +91 -0
- package/dist/core/logger.js.map +1 -0
- package/dist/core/mcp-handler.d.ts +127 -0
- package/dist/core/mcp-handler.d.ts.map +1 -0
- package/dist/core/mcp-handler.js +323 -0
- package/dist/core/mcp-handler.js.map +1 -0
- package/dist/core/prompt.d.ts +80 -0
- package/dist/core/prompt.d.ts.map +1 -0
- package/dist/core/prompt.js +120 -0
- package/dist/core/prompt.js.map +1 -0
- package/dist/core/workflow-context.d.ts +61 -0
- package/dist/core/workflow-context.d.ts.map +1 -0
- package/dist/core/workflow-context.js +358 -0
- package/dist/core/workflow-context.js.map +1 -0
- package/dist/core/workflow.d.ts +543 -0
- package/dist/core/workflow.d.ts.map +1 -0
- package/dist/core/workflow.js +986 -0
- package/dist/core/workflow.js.map +1 -0
- package/dist/debugger/event-replayer.d.ts +422 -0
- package/dist/debugger/event-replayer.d.ts.map +1 -0
- package/dist/debugger/event-replayer.js +639 -0
- package/dist/debugger/event-replayer.js.map +1 -0
- package/dist/debugger/index.d.ts +2 -0
- package/dist/debugger/index.d.ts.map +1 -0
- package/{src/debugger/index.ts → dist/debugger/index.js} +1 -0
- package/dist/debugger/index.js.map +1 -0
- package/dist/debugger/tree-debugger.d.ts +240 -0
- package/dist/debugger/tree-debugger.d.ts.map +1 -0
- package/dist/debugger/tree-debugger.js +620 -0
- package/dist/debugger/tree-debugger.js.map +1 -0
- package/dist/decorators/index.d.ts +4 -0
- package/dist/decorators/index.d.ts.map +1 -0
- package/{src/decorators/index.ts → dist/decorators/index.js} +1 -0
- package/dist/decorators/index.js.map +1 -0
- package/dist/decorators/observed-state.d.ts +32 -0
- package/dist/decorators/observed-state.d.ts.map +1 -0
- package/dist/decorators/observed-state.js +79 -0
- package/dist/decorators/observed-state.js.map +1 -0
- package/dist/decorators/step.d.ts +15 -0
- package/dist/decorators/step.d.ts.map +1 -0
- package/dist/decorators/step.js +192 -0
- package/dist/decorators/step.js.map +1 -0
- package/dist/decorators/task.d.ts +50 -0
- package/dist/decorators/task.d.ts.map +1 -0
- package/dist/decorators/task.js +118 -0
- package/dist/decorators/task.js.map +1 -0
- package/dist/examples/index.d.ts +3 -0
- package/dist/examples/index.d.ts.map +1 -0
- package/{src/examples/index.ts → dist/examples/index.js} +1 -0
- package/dist/examples/index.js.map +1 -0
- package/dist/examples/tdd-orchestrator.d.ts +15 -0
- package/dist/examples/tdd-orchestrator.d.ts.map +1 -0
- package/dist/examples/tdd-orchestrator.js +121 -0
- package/dist/examples/tdd-orchestrator.js.map +1 -0
- package/dist/examples/test-cycle-workflow.d.ts +14 -0
- package/dist/examples/test-cycle-workflow.d.ts.map +1 -0
- package/dist/examples/test-cycle-workflow.js +116 -0
- package/dist/examples/test-cycle-workflow.js.map +1 -0
- package/dist/harnesses/claude-code-harness.d.ts +391 -0
- package/dist/harnesses/claude-code-harness.d.ts.map +1 -0
- package/dist/harnesses/claude-code-harness.js +1076 -0
- package/dist/harnesses/claude-code-harness.js.map +1 -0
- package/dist/harnesses/harness-registry.d.ts +440 -0
- package/dist/harnesses/harness-registry.d.ts.map +1 -0
- package/dist/harnesses/harness-registry.js +543 -0
- package/dist/harnesses/harness-registry.js.map +1 -0
- package/dist/harnesses/index.d.ts +12 -0
- package/dist/harnesses/index.d.ts.map +1 -0
- package/dist/harnesses/index.js +11 -0
- package/dist/harnesses/index.js.map +1 -0
- package/dist/harnesses/pi-harness.d.ts +219 -0
- package/dist/harnesses/pi-harness.d.ts.map +1 -0
- package/dist/harnesses/pi-harness.js +676 -0
- package/dist/harnesses/pi-harness.js.map +1 -0
- package/dist/harnesses/pi-schema-converter.d.ts +24 -0
- package/dist/harnesses/pi-schema-converter.d.ts.map +1 -0
- package/dist/harnesses/pi-schema-converter.js +81 -0
- package/dist/harnesses/pi-schema-converter.js.map +1 -0
- package/dist/harnesses/register-defaults.d.ts +24 -0
- package/dist/harnesses/register-defaults.d.ts.map +1 -0
- package/dist/harnesses/register-defaults.js +40 -0
- package/dist/harnesses/register-defaults.js.map +1 -0
- package/dist/harnesses/session-store.d.ts +201 -0
- package/dist/harnesses/session-store.d.ts.map +1 -0
- package/dist/harnesses/session-store.js +254 -0
- package/dist/harnesses/session-store.js.map +1 -0
- package/dist/index.d.ts +37 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +57 -0
- package/dist/index.js.map +1 -0
- package/dist/reflection/index.d.ts +5 -0
- package/dist/reflection/index.d.ts.map +1 -0
- package/{src/reflection/index.ts → dist/reflection/index.js} +1 -1
- package/dist/reflection/index.js.map +1 -0
- package/dist/reflection/reflection.d.ts +84 -0
- package/dist/reflection/reflection.d.ts.map +1 -0
- package/dist/reflection/reflection.js +344 -0
- package/dist/reflection/reflection.js.map +1 -0
- package/dist/tools/index.d.ts +6 -0
- package/dist/tools/index.d.ts.map +1 -0
- package/dist/tools/index.js +11 -0
- package/dist/tools/index.js.map +1 -0
- package/dist/tools/introspection.d.ts +165 -0
- package/dist/tools/introspection.d.ts.map +1 -0
- package/dist/tools/introspection.js +324 -0
- package/dist/tools/introspection.js.map +1 -0
- package/dist/types/agent.d.ts +1317 -0
- package/dist/types/agent.d.ts.map +1 -0
- package/dist/types/agent.js +423 -0
- package/dist/types/agent.js.map +1 -0
- package/dist/types/decorators.d.ts +40 -0
- package/dist/types/decorators.d.ts.map +1 -0
- package/dist/types/decorators.js +2 -0
- package/dist/types/decorators.js.map +1 -0
- package/dist/types/error-strategy.d.ts +13 -0
- package/dist/types/error-strategy.d.ts.map +1 -0
- package/dist/types/error-strategy.js +2 -0
- package/dist/types/error-strategy.js.map +1 -0
- package/dist/types/error.d.ts +20 -0
- package/dist/types/error.d.ts.map +1 -0
- package/dist/types/error.js +2 -0
- package/dist/types/error.js.map +1 -0
- package/dist/types/events.d.ts +113 -0
- package/dist/types/events.d.ts.map +1 -0
- package/dist/types/events.js +2 -0
- package/dist/types/events.js.map +1 -0
- package/dist/types/harnesses.d.ts +474 -0
- package/dist/types/harnesses.d.ts.map +1 -0
- package/dist/types/harnesses.js +2 -0
- package/dist/types/harnesses.js.map +1 -0
- package/dist/types/index.d.ts +23 -0
- package/dist/types/index.d.ts.map +1 -0
- package/dist/types/index.js +8 -0
- package/dist/types/index.js.map +1 -0
- package/dist/types/logging.d.ts +24 -0
- package/dist/types/logging.d.ts.map +1 -0
- package/dist/types/logging.js +2 -0
- package/dist/types/logging.js.map +1 -0
- package/dist/types/observer.d.ts +18 -0
- package/dist/types/observer.d.ts.map +1 -0
- package/dist/types/observer.js +2 -0
- package/dist/types/observer.js.map +1 -0
- package/dist/types/prompt.d.ts +31 -0
- package/dist/types/prompt.d.ts.map +1 -0
- package/dist/types/prompt.js +6 -0
- package/dist/types/prompt.js.map +1 -0
- package/dist/types/providers.d.ts +691 -0
- package/dist/types/providers.d.ts.map +1 -0
- package/dist/types/providers.js +14 -0
- package/dist/types/providers.js.map +1 -0
- package/dist/types/reflection.d.ts +96 -0
- package/dist/types/reflection.d.ts.map +1 -0
- package/dist/types/reflection.js +24 -0
- package/dist/types/reflection.js.map +1 -0
- package/dist/types/restart.d.ts +132 -0
- package/dist/types/restart.d.ts.map +1 -0
- package/dist/types/restart.js +2 -0
- package/dist/types/restart.js.map +1 -0
- package/dist/types/sdk-primitives.d.ts +118 -0
- package/dist/types/sdk-primitives.d.ts.map +1 -0
- package/dist/types/sdk-primitives.js +6 -0
- package/dist/types/sdk-primitives.js.map +1 -0
- package/{src/types/snapshot.ts → dist/types/snapshot.d.ts} +5 -5
- package/dist/types/snapshot.d.ts.map +1 -0
- package/dist/types/snapshot.js +2 -0
- package/dist/types/snapshot.js.map +1 -0
- package/dist/types/streaming.d.ts +194 -0
- package/dist/types/streaming.d.ts.map +1 -0
- package/dist/types/streaming.js +67 -0
- package/dist/types/streaming.js.map +1 -0
- package/dist/types/workflow-context.d.ts +275 -0
- package/dist/types/workflow-context.d.ts.map +1 -0
- package/dist/types/workflow-context.js +8 -0
- package/dist/types/workflow-context.js.map +1 -0
- package/dist/types/workflow.d.ts +30 -0
- package/dist/types/workflow.d.ts.map +1 -0
- package/dist/types/workflow.js +2 -0
- package/dist/types/workflow.js.map +1 -0
- package/dist/utils/agent-validation.d.ts +88 -0
- package/dist/utils/agent-validation.d.ts.map +1 -0
- package/dist/utils/agent-validation.js +87 -0
- package/dist/utils/agent-validation.js.map +1 -0
- package/dist/utils/delay.d.ts +7 -0
- package/dist/utils/delay.d.ts.map +1 -0
- package/dist/utils/delay.js +9 -0
- package/dist/utils/delay.js.map +1 -0
- package/dist/utils/harness-config.d.ts +180 -0
- package/dist/utils/harness-config.d.ts.map +1 -0
- package/dist/utils/harness-config.js +311 -0
- package/dist/utils/harness-config.js.map +1 -0
- package/dist/utils/id.d.ts +6 -0
- package/dist/utils/id.d.ts.map +1 -0
- package/dist/utils/id.js +12 -0
- package/dist/utils/id.js.map +1 -0
- package/dist/utils/index.d.ts +13 -0
- package/dist/utils/index.d.ts.map +1 -0
- package/dist/utils/index.js +11 -0
- package/dist/utils/index.js.map +1 -0
- package/dist/utils/model-spec.d.ts +110 -0
- package/dist/utils/model-spec.d.ts.map +1 -0
- package/dist/utils/model-spec.js +149 -0
- package/dist/utils/model-spec.js.map +1 -0
- package/dist/utils/observable.d.ts +54 -0
- package/dist/utils/observable.d.ts.map +1 -0
- package/dist/utils/observable.js +82 -0
- package/dist/utils/observable.js.map +1 -0
- package/dist/utils/provider-config.d.ts +10 -0
- package/dist/utils/provider-config.d.ts.map +1 -0
- package/dist/utils/provider-config.js +10 -0
- package/dist/utils/provider-config.js.map +1 -0
- package/dist/utils/restart-analysis.d.ts +202 -0
- package/dist/utils/restart-analysis.d.ts.map +1 -0
- package/dist/utils/restart-analysis.js +426 -0
- package/dist/utils/restart-analysis.js.map +1 -0
- package/dist/utils/session-serialization.d.ts +118 -0
- package/dist/utils/session-serialization.d.ts.map +1 -0
- package/dist/utils/session-serialization.js +217 -0
- package/dist/utils/session-serialization.js.map +1 -0
- package/dist/utils/workflow-error-utils.d.ts +22 -0
- package/dist/utils/workflow-error-utils.d.ts.map +1 -0
- package/dist/utils/workflow-error-utils.js +45 -0
- package/dist/utils/workflow-error-utils.js.map +1 -0
- package/package.json +34 -5
- package/.claude/commands/subtask-planning/prp-base-create.md +0 -120
- package/.claude/commands/subtask-planning/prp-base-execute.md +0 -65
- package/.claude/commands/task-breakdown.md +0 -94
- package/.claude/settings.local.json +0 -9
- package/.claude/system_prompts/task-breakdown.md +0 -101
- package/CHANGELOG.md +0 -188
- package/PRD.md +0 -543
- package/PRPs/001-hierarchical-workflow-engine.md +0 -2438
- package/PRPs/PRDs/002-agent-prompt.md +0 -390
- package/PRPs/PRDs/003-agent-prompt.md +0 -943
- package/PRPs/PRDs/004-agent-prompt.md +0 -1136
- package/PRPs/PRDs/tasks-001.json +0 -492
- package/PRPs/README.md +0 -83
- package/PRPs/templates/prp_base.md +0 -222
- package/docs/agent.md +0 -422
- package/docs/prompt.md +0 -419
- package/docs/workflow.md +0 -600
- package/examples/README.md +0 -258
- package/examples/examples/01-basic-workflow.ts +0 -100
- package/examples/examples/02-decorator-options.ts +0 -217
- package/examples/examples/03-parent-child.ts +0 -241
- package/examples/examples/04-observers-debugger.ts +0 -340
- package/examples/examples/05-error-handling.ts +0 -387
- package/examples/examples/06-concurrent-tasks.ts +0 -352
- package/examples/examples/07-agent-loops.ts +0 -432
- package/examples/examples/08-sdk-features.ts +0 -667
- package/examples/examples/09-reflection.ts +0 -573
- package/examples/examples/10-introspection.ts +0 -550
- package/examples/examples/11-reparenting-workflows.ts +0 -269
- package/examples/index.ts +0 -147
- package/examples/utils/helpers.ts +0 -57
- package/package-lock.json +0 -2398
- package/plan/001_d3bb02af4886/TEST_RESULTS.md +0 -259
- package/plan/001_d3bb02af4886/backlog.json +0 -867
- package/plan/001_d3bb02af4886/bug_fix_tasks.json +0 -484
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M1T1S1/PRP.md +0 -488
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M1T1S2/PRP.md +0 -581
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M1T1S3/PRP.md +0 -687
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T1S1/PRP.md +0 -492
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T1S3/PRP.md +0 -932
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T1S3/research/concurrent_error_testing_patterns.md +0 -1109
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T1S3/research/vitest_concurrent_testing.md +0 -802
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T1S3/research/workflow_engine_test_references.md +0 -603
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T2S1/PRP.md +0 -564
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T2S3/PRP.md +0 -518
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T2S4/PRP.md +0 -1252
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T3S1/PRP.md +0 -364
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T3S1/research/CODEBASE_INVENTORY.md +0 -114
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T3S1/research/DECORATOR_DOCUMENTATION_PATTERNS.md +0 -205
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T3S1/research/PRD_LOCATION_ANALYSIS.md +0 -199
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T3S1/research/ULTRATHINK_PRP_PLAN.md +0 -134
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T1S1/PRP.md +0 -495
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T1S1/research/console_error_inventory.md +0 -435
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T1S2/PRP.md +0 -506
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T1S3/PRP.md +0 -612
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T2S2/PRP.md +0 -558
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T2S2/research/external_research.md +0 -788
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T3S2/PRP.md +0 -460
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T3S3/PRP.md +0 -454
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T4S1/PRP.md +0 -520
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T4S1/RECOMMENDATION.md +0 -417
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T4S1/research/external_workflow_engines_research.md +0 -760
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T4S1/research/security_implications_analysis.md +0 -245
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T4S2/PRP.md +0 -792
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M4T1S1/PRP.md +0 -535
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M4T1S1/TEST_EXECUTION_REPORT.md +0 -190
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M4T1S2/PRP.md +0 -654
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M4T1S2/TEST_FIX_REPORT.md +0 -227
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M4T1S2/research/KEY_FINDINGS.md +0 -345
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M4T1S2/research/QUICK_REFERENCE.md +0 -193
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M4T1S2/research/test_maintenance_research.md +0 -1323
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M4T3S1/BREAKING_CHANGES_AUDIT.md +0 -1011
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M4T3S1/PRP.md +0 -927
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M4T3S2/PRP.md +0 -505
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/architecture/logger_child_signature_analysis.md +0 -401
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M1T1S3/child_implementation_research.md +0 -142
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M1T1S3/test_patterns_research.md +0 -112
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M1T1S3/vitest_patterns_research.md +0 -159
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M1T1S4/PRP.md +0 -549
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M1T1S4/VERIFICATION_REPORT.md +0 -368
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M1T1S4/edge_case_analysis.md +0 -172
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M1T1S4/usage_inventory.md +0 -175
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T1S2/PRP.md +0 -696
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T1S4/PRP.md +0 -860
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/PRP.md +0 -1066
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/01-testing-aggregated-errors.md +0 -1103
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/01_typescript_error_aggregation_patterns.md +0 -789
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/02-error-merge-strategy-testing-guide.md +0 -1098
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/02_aggregate_error_patterns.md +0 -1037
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/03-promise-allsettled-testing-patterns.md +0 -916
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/03_error_merging_strategies.md +0 -1045
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/04_github_stackoverflow_examples.md +0 -890
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/05_comprehensive_summary.md +0 -822
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/INDEX.md +0 -668
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/QUICK_REFERENCE.md +0 -706
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/README.md +0 -265
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/RESEARCH_REPORT.md +0 -655
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S4/research/vitest_testing_patterns.md +0 -1103
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T3S2/PRP.md +0 -426
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T1S2/PRP.md +0 -506
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T1S2/research/QUICK_REFERENCE.md +0 -114
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T1S2/research/RESEARCH_SUMMARY.md +0 -316
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T1S2/research/vitest_observer_error_logging_best_practices.md +0 -754
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T1S3/PRP.md +0 -612
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T2S1/PRP.md +0 -719
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T2S1/README.md +0 -215
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T2S1/analysis.md +0 -765
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T2S3/PRP.md +0 -718
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T3S1/DECISION.md +0 -149
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T3S1/PRP.md +0 -470
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T3S1/research/ULTRATHINK_PLAN.md +0 -332
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T3S1/research/codebase_workflow_name_analysis.md +0 -167
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T3S1/research/external_best_practices.md +0 -265
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T3S1/research/validation_patterns.md +0 -273
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T4S1/workflow_engine_ancestry_api_research.md +0 -760
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T4S3-PRP.md +0 -434
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M4T2S1/PRP.md +0 -717
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M4T2S2/PRP.md +0 -472
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M4T2S2/VALIDATION_REPORT.md +0 -125
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M4T2S2/research/ULTRATHINK_PRP_PLAN.md +0 -301
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/error-logging-best-practices.md +0 -1170
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/research_typescript_partial_and_overloads.md +0 -940
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/vitest-quick-reference.md +0 -151
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/vitest-research.md +0 -650
- package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/prd_snapshot.md +0 -259
- package/plan/001_d3bb02af4886/bugfix/P1M1T1S1/PRP.md +0 -457
- package/plan/001_d3bb02af4886/bugfix/RESEARCH_SUMMARY.md +0 -346
- package/plan/001_d3bb02af4886/bugfix/architecture/codebase_structure.md +0 -311
- package/plan/001_d3bb02af4886/bugfix/architecture/concurrent_execution_best_practices.md +0 -1565
- package/plan/001_d3bb02af4886/bugfix/architecture/error_handling_patterns.md +0 -288
- package/plan/001_d3bb02af4886/bugfix/architecture/promise_all_analysis.md +0 -741
- package/plan/001_d3bb02af4886/docs/PRP/P1M1T1S4-functional-workflow-error-state-capture-test.md +0 -652
- package/plan/001_d3bb02af4886/docs/PRP/P1P2-PRP.md +0 -527
- package/plan/001_d3bb02af4886/docs/PRP/P3P4-PRP.md +0 -1388
- package/plan/001_d3bb02af4886/docs/PRP/P4P5-PRP.md +0 -1136
- package/plan/001_d3bb02af4886/docs/PRP/PRP.md +0 -527
- package/plan/001_d3bb02af4886/docs/PRP/bugfix/P1M1T2S1-PRP.md +0 -415
- package/plan/001_d3bb02af4886/docs/PRP/bugfix/P1M1T2S2-PRP.md +0 -378
- package/plan/001_d3bb02af4886/docs/PRP/bugfix/P1M1T2S4-PRP.md +0 -713
- package/plan/001_d3bb02af4886/docs/PRP/bugfix/P1M2T1S4-PRP.md +0 -370
- package/plan/001_d3bb02af4886/docs/PRP_P1M3T1S3.md +0 -499
- package/plan/001_d3bb02af4886/docs/TEST_RESULTS.md +0 -230
- package/plan/001_d3bb02af4886/docs/architecture/external_deps.md +0 -358
- package/plan/001_d3bb02af4886/docs/architecture/system_context.md +0 -242
- package/plan/001_d3bb02af4886/docs/bugfix/ANALYSIS_PRD_VS_IMPLEMENTATION.md +0 -1134
- package/plan/001_d3bb02af4886/docs/bugfix/GAP_ANALYSIS_SUMMARY.md +0 -179
- package/plan/001_d3bb02af4886/docs/bugfix/P1M4T2S1/PRP.md +0 -629
- package/plan/001_d3bb02af4886/docs/bugfix/P1M4T2S1/validation-report.md +0 -214
- package/plan/001_d3bb02af4886/docs/bugfix/PRP_P1M4T2S3.md +0 -629
- package/plan/001_d3bb02af4886/docs/bugfix/bugfix_PRP.md +0 -529
- package/plan/001_d3bb02af4886/docs/bugfix/bugfix_QUICK_REFERENCE.md +0 -142
- package/plan/001_d3bb02af4886/docs/bugfix/bugfix_README.md +0 -304
- package/plan/001_d3bb02af4886/docs/bugfix/bugfix_TEST_RESULTS.md +0 -558
- package/plan/001_d3bb02af4886/docs/bugfix/bugfix_VALIDATION_SUMMARY.md +0 -256
- package/plan/001_d3bb02af4886/docs/bugfix/system_context.md +0 -346
- package/plan/001_d3bb02af4886/docs/bugfix-architecture/bug_analysis.md +0 -415
- package/plan/001_d3bb02af4886/docs/bugfix-architecture/implementation_patterns.md +0 -489
- package/plan/001_d3bb02af4886/docs/bugfix-architecture/system_context.md +0 -218
- package/plan/001_d3bb02af4886/docs/bugfix_INITIATION_SUMMARY.md +0 -380
- package/plan/001_d3bb02af4886/docs/research/CYCLE_DETECTION_PATTERNS.md +0 -1923
- package/plan/001_d3bb02af4886/docs/research/CYCLE_DETECTION_QUICK_REF.md +0 -319
- package/plan/001_d3bb02af4886/docs/research/P1M1T2S1/codebase-context.md +0 -115
- package/plan/001_d3bb02af4886/docs/research/P1M1T2S1/cycle-detection-algorithms.md +0 -134
- package/plan/001_d3bb02af4886/docs/research/P1M1T2S1/test-patterns.md +0 -153
- package/plan/001_d3bb02af4886/docs/research/P1M1T2S1/workflow-class.md +0 -132
- package/plan/001_d3bb02af4886/docs/research/P1M2T1S4/DECORATOR_DOCUMENTATION_BEST_PRACTICES.md +0 -716
- package/plan/001_d3bb02af4886/docs/research/P1M2T1S4/DECORATOR_DOCUMENTATION_QUICK_REF.md +0 -186
- package/plan/001_d3bb02af4886/docs/research/P1M2T1S4/GROUNDSWELL_DECORATOR_EXAMPLES.md +0 -604
- package/plan/001_d3bb02af4886/docs/research/P1M2T1S4/INDEX.md +0 -213
- package/plan/001_d3bb02af4886/docs/research/P1M2T1S4/codebase_structure.md +0 -30
- package/plan/001_d3bb02af4886/docs/research/P1M2T1S4/existing_test_pattern.md +0 -56
- package/plan/001_d3bb02af4886/docs/research/P1M2T1S4/getRootObservers_implementation.md +0 -53
- package/plan/001_d3bb02af4886/docs/research/P1M2T1S4/test_conventions.md +0 -49
- package/plan/001_d3bb02af4886/docs/research/P1M3T1S4/PRP.md +0 -958
- package/plan/001_d3bb02af4886/docs/research/P1M3T1S4/QUICK_REFERENCE.md +0 -339
- package/plan/001_d3bb02af4886/docs/research/P1M3T1S4/README.md +0 -305
- package/plan/001_d3bb02af4886/docs/research/P1M3T1S4/SUMMARY.md +0 -433
- package/plan/001_d3bb02af4886/docs/research/P1M3T1S4/bidirectional-tree-consistency-testing.md +0 -1574
- package/plan/001_d3bb02af4886/docs/research/P1M3T1S4/test-pattern-examples.md +0 -1014
- package/plan/001_d3bb02af4886/docs/research/P1P2/LRU_CACHE_BEST_PRACTICES.md +0 -1929
- package/plan/001_d3bb02af4886/docs/research/P1P2/LRU_CACHE_CODE_PATTERNS.md +0 -857
- package/plan/001_d3bb02af4886/docs/research/P1P2/LRU_CACHE_INTEGRATION_GUIDE.md +0 -738
- package/plan/001_d3bb02af4886/docs/research/P1P2/LRU_CACHE_RESEARCH_INDEX.md +0 -424
- package/plan/001_d3bb02af4886/docs/research/P1P2/REFLECTION_INDEX.md +0 -291
- package/plan/001_d3bb02af4886/docs/research/P1P2/REFLECTION_RESEARCH_REPORT.md +0 -1342
- package/plan/001_d3bb02af4886/docs/research/P1P2/RESEARCH_SUMMARY.md +0 -342
- package/plan/001_d3bb02af4886/docs/research/P1P2/anthropic-sdk.md +0 -174
- package/plan/001_d3bb02af4886/docs/research/P1P2/async-local-storage.md +0 -200
- package/plan/001_d3bb02af4886/docs/research/P1P2/reflection-code-patterns.md +0 -1205
- package/plan/001_d3bb02af4886/docs/research/P1P2/reflection-decision-matrix.md +0 -421
- package/plan/001_d3bb02af4886/docs/research/P1P2/reflection-implementation-guide.md +0 -1341
- package/plan/001_d3bb02af4886/docs/research/P1P2/reflection-integration-guide.md +0 -834
- package/plan/001_d3bb02af4886/docs/research/P1P2/reflection-patterns.md +0 -1468
- package/plan/001_d3bb02af4886/docs/research/P1P2/reflection-quick-reference.md +0 -558
- package/plan/001_d3bb02af4886/docs/research/P1P2/zod-schema.md +0 -152
- package/plan/001_d3bb02af4886/docs/research/P3P4/caching-lru.md +0 -116
- package/plan/001_d3bb02af4886/docs/research/P3P4/introspection-tools.md +0 -177
- package/plan/001_d3bb02af4886/docs/research/P3P4/reflection-patterns.md +0 -117
- package/plan/001_d3bb02af4886/docs/research/P4P5/RESEARCH_SUMMARY.md +0 -151
- package/plan/001_d3bb02af4886/docs/research/PROMISE_ALLSETTLED_QUICK_REF.md +0 -376
- package/plan/001_d3bb02af4886/docs/research/PROMISE_ALLSETTLED_RESEARCH.md +0 -1507
- package/plan/001_d3bb02af4886/docs/research/bugfix_typescript_patterns.md +0 -949
- package/plan/001_d3bb02af4886/docs/research/error-testing-research.md +0 -619
- package/plan/001_d3bb02af4886/docs/research/error_handling_patterns.md +0 -723
- package/plan/001_d3bb02af4886/docs/research/general/INTROSPECTION_RESEARCH_SUMMARY.md +0 -378
- package/plan/001_d3bb02af4886/docs/research/general/README-INTROSPECTION.md +0 -352
- package/plan/001_d3bb02af4886/docs/research/general/agent-introspection-patterns.md +0 -1085
- package/plan/001_d3bb02af4886/docs/research/general/introspection-security-guide.md +0 -984
- package/plan/001_d3bb02af4886/docs/research/general/introspection-tool-examples.md +0 -875
- package/plan/001_d3bb02af4886/docs/research/incremental-tree-map-updates/PRP_TEMPLATE.md +0 -460
- package/plan/001_d3bb02af4886/docs/research/incremental-tree-map-updates/QUICK_REFERENCE.md +0 -324
- package/plan/001_d3bb02af4886/docs/research/incremental-tree-map-updates/README.md +0 -175
- package/plan/001_d3bb02af4886/docs/research/incremental-tree-map-updates/RESEARCH_REPORT.md +0 -499
- package/plan/001_d3bb02af4886/docs/research/incremental-tree-map-updates/SUMMARY.md +0 -163
- package/plan/001_d3bb02af4886/prd_snapshot.md +0 -543
- package/plan/bugfix/BUG_FIX_SUMMARY.md +0 -961
- package/scripts/generate-llms-full.ts +0 -206
- package/src/__tests__/adversarial/attachChild-performance.test.ts +0 -216
- package/src/__tests__/adversarial/circular-reference.test.ts +0 -101
- package/src/__tests__/adversarial/complex-circular-reference.test.ts +0 -139
- package/src/__tests__/adversarial/concurrent-task-failures.test.ts +0 -571
- package/src/__tests__/adversarial/deep-analysis.test.ts +0 -729
- package/src/__tests__/adversarial/deep-hierarchy-stress.test.ts +0 -213
- package/src/__tests__/adversarial/e2e-prd-validation.test.ts +0 -448
- package/src/__tests__/adversarial/edge-case.test.ts +0 -703
- package/src/__tests__/adversarial/error-merge-strategy.test.ts +0 -760
- package/src/__tests__/adversarial/incremental-performance.test.ts +0 -140
- package/src/__tests__/adversarial/node-map-update-benchmarks.test.ts +0 -457
- package/src/__tests__/adversarial/observer-propagation.test.ts +0 -487
- package/src/__tests__/adversarial/parent-validation.test.ts +0 -143
- package/src/__tests__/adversarial/prd-12-2-compliance.test.ts +0 -611
- package/src/__tests__/adversarial/prd-compliance.test.ts +0 -731
- package/src/__tests__/compatibility/backward-compatibility.test.ts +0 -1572
- package/src/__tests__/helpers/index.ts +0 -18
- package/src/__tests__/helpers/tree-verification.ts +0 -257
- package/src/__tests__/integration/agent-workflow.test.ts +0 -256
- package/src/__tests__/integration/bidirectional-consistency.test.ts +0 -847
- package/src/__tests__/integration/observer-logging.test.ts +0 -643
- package/src/__tests__/integration/tree-mirroring.test.ts +0 -151
- package/src/__tests__/integration/workflow-reparenting.test.ts +0 -303
- package/src/__tests__/unit/agent.test.ts +0 -169
- package/src/__tests__/unit/cache-key.test.ts +0 -182
- package/src/__tests__/unit/cache.test.ts +0 -172
- package/src/__tests__/unit/context.test.ts +0 -217
- package/src/__tests__/unit/decorators.test.ts +0 -100
- package/src/__tests__/unit/introspection-tools.test.ts +0 -277
- package/src/__tests__/unit/logger.test.ts +0 -293
- package/src/__tests__/unit/observable.test.ts +0 -321
- package/src/__tests__/unit/prompt.test.ts +0 -135
- package/src/__tests__/unit/reflection.test.ts +0 -210
- package/src/__tests__/unit/tree-debugger-incremental.test.ts +0 -170
- package/src/__tests__/unit/tree-debugger.test.ts +0 -85
- package/src/__tests__/unit/utils/workflow-error-utils.test.ts +0 -209
- package/src/__tests__/unit/workflow-detachChild.test.ts +0 -100
- package/src/__tests__/unit/workflow-emitEvent-childDetached.test.ts +0 -153
- package/src/__tests__/unit/workflow-isDescendantOf.test.ts +0 -180
- package/src/__tests__/unit/workflow.test.ts +0 -357
- package/src/cache/cache-key.ts +0 -244
- package/src/cache/cache.ts +0 -236
- package/src/core/agent.ts +0 -593
- package/src/core/event-tree.ts +0 -260
- package/src/core/logger.ts +0 -112
- package/src/core/mcp-handler.ts +0 -184
- package/src/core/prompt.ts +0 -150
- package/src/core/workflow-context.ts +0 -351
- package/src/core/workflow.ts +0 -540
- package/src/debugger/tree-debugger.ts +0 -255
- package/src/decorators/observed-state.ts +0 -95
- package/src/decorators/step.ts +0 -139
- package/src/decorators/task.ts +0 -159
- package/src/examples/tdd-orchestrator.ts +0 -65
- package/src/examples/test-cycle-workflow.ts +0 -64
- package/src/index.ts +0 -142
- package/src/reflection/reflection.ts +0 -407
- package/src/tools/index.ts +0 -36
- package/src/tools/introspection.ts +0 -464
- package/src/types/agent.ts +0 -90
- package/src/types/decorators.ts +0 -32
- package/src/types/error-strategy.ts +0 -13
- package/src/types/error.ts +0 -20
- package/src/types/events.ts +0 -75
- package/src/types/index.ts +0 -55
- package/src/types/logging.ts +0 -24
- package/src/types/observer.ts +0 -18
- package/src/types/prompt.ts +0 -40
- package/src/types/reflection.ts +0 -117
- package/src/types/sdk-primitives.ts +0 -128
- package/src/types/workflow-context.ts +0 -163
- package/src/types/workflow.ts +0 -37
- package/src/utils/id.ts +0 -11
- package/src/utils/index.ts +0 -4
- package/src/utils/observable.ts +0 -106
- package/src/utils/workflow-error-utils.ts +0 -56
- package/tsconfig.json +0 -22
- package/vitest.config.ts +0 -16
|
@@ -1,140 +0,0 @@
|
|
|
1
|
-
import { describe, it, expect } from 'vitest';
|
|
2
|
-
import { Workflow, WorkflowTreeDebugger } from '../../index.js';
|
|
3
|
-
|
|
4
|
-
class BenchmarkWorkflow extends Workflow {
|
|
5
|
-
async run() { this.setStatus('completed'); }
|
|
6
|
-
}
|
|
7
|
-
|
|
8
|
-
describe('Incremental Node Map Update Performance', () => {
|
|
9
|
-
it('detach from large tree is O(k) not O(n)', () => {
|
|
10
|
-
// Build large tree (1000 nodes)
|
|
11
|
-
const root = new BenchmarkWorkflow('Root');
|
|
12
|
-
let current = root;
|
|
13
|
-
for (let i = 0; i < 999; i++) {
|
|
14
|
-
const child = new BenchmarkWorkflow(`Node${i}`, current);
|
|
15
|
-
current = child;
|
|
16
|
-
}
|
|
17
|
-
|
|
18
|
-
const treeDebugger = new WorkflowTreeDebugger(root);
|
|
19
|
-
expect(treeDebugger.getStats().totalNodes).toBe(1000);
|
|
20
|
-
|
|
21
|
-
// Benchmark: Detach single node (should be O(1) vs O(1000))
|
|
22
|
-
const start = performance.now();
|
|
23
|
-
const leaf = current; // Last node in chain
|
|
24
|
-
const parent = leaf.parent!;
|
|
25
|
-
parent.detachChild(leaf);
|
|
26
|
-
const duration = performance.now() - start;
|
|
27
|
-
|
|
28
|
-
console.log(`Detach duration: ${duration.toFixed(3)}ms`);
|
|
29
|
-
console.log(`Expected: < 1ms for incremental, ~10ms for full rebuild`);
|
|
30
|
-
|
|
31
|
-
// Verify correct behavior
|
|
32
|
-
const stats = treeDebugger.getStats();
|
|
33
|
-
expect(stats.totalNodes).toBe(999);
|
|
34
|
-
expect(treeDebugger.getNode(leaf.id)).toBeUndefined();
|
|
35
|
-
|
|
36
|
-
// Performance assertion: Should be significantly faster than O(n) rebuild
|
|
37
|
-
// For 1000 nodes, full rebuild would take ~10ms, incremental should be <1ms
|
|
38
|
-
expect(duration).toBeLessThan(5); // Generous threshold for CI environments
|
|
39
|
-
});
|
|
40
|
-
|
|
41
|
-
it('attach to large tree is O(k)', () => {
|
|
42
|
-
// Build large tree (100 nodes - smaller for attach test)
|
|
43
|
-
const root = new BenchmarkWorkflow('Root');
|
|
44
|
-
for (let i = 0; i < 99; i++) {
|
|
45
|
-
new BenchmarkWorkflow(`Node${i}`, root);
|
|
46
|
-
}
|
|
47
|
-
|
|
48
|
-
const treeDebugger = new WorkflowTreeDebugger(root);
|
|
49
|
-
expect(treeDebugger.getStats().totalNodes).toBe(100);
|
|
50
|
-
|
|
51
|
-
// Benchmark: Attach subtree with 10 nodes
|
|
52
|
-
const start = performance.now();
|
|
53
|
-
const newChild = new BenchmarkWorkflow('NewChild', root);
|
|
54
|
-
for (let i = 0; i < 9; i++) {
|
|
55
|
-
new BenchmarkWorkflow(`Descendant${i}`, newChild);
|
|
56
|
-
}
|
|
57
|
-
const duration = performance.now() - start;
|
|
58
|
-
|
|
59
|
-
console.log(`Attach 10-node subtree duration: ${duration.toFixed(3)}ms`);
|
|
60
|
-
|
|
61
|
-
// Verify correct behavior
|
|
62
|
-
expect(treeDebugger.getStats().totalNodes).toBe(110);
|
|
63
|
-
expect(treeDebugger.getNode(newChild.id)).toBeDefined();
|
|
64
|
-
|
|
65
|
-
// Performance assertion: Should be fast for subtree addition
|
|
66
|
-
expect(duration).toBeLessThan(10);
|
|
67
|
-
});
|
|
68
|
-
|
|
69
|
-
it('detach large subtree is O(k)', () => {
|
|
70
|
-
// Build tree with one large subtree
|
|
71
|
-
const root = new BenchmarkWorkflow('Root');
|
|
72
|
-
const branch = new BenchmarkWorkflow('Branch', root);
|
|
73
|
-
|
|
74
|
-
// Add 100 nodes to branch
|
|
75
|
-
for (let i = 0; i < 100; i++) {
|
|
76
|
-
new BenchmarkWorkflow(`BranchNode${i}`, branch);
|
|
77
|
-
}
|
|
78
|
-
|
|
79
|
-
// Add 900 nodes to root
|
|
80
|
-
for (let i = 0; i < 900; i++) {
|
|
81
|
-
new BenchmarkWorkflow(`RootNode${i}`, root);
|
|
82
|
-
}
|
|
83
|
-
|
|
84
|
-
const treeDebugger = new WorkflowTreeDebugger(root);
|
|
85
|
-
expect(treeDebugger.getStats().totalNodes).toBe(1002); // 1 root + 1 branch + 100 + 900
|
|
86
|
-
|
|
87
|
-
// Benchmark: Detach entire branch (should process 101 nodes, not 1002)
|
|
88
|
-
const start = performance.now();
|
|
89
|
-
root.detachChild(branch);
|
|
90
|
-
const duration = performance.now() - start;
|
|
91
|
-
|
|
92
|
-
console.log(`Detach 101-node subtree from 1002-node tree: ${duration.toFixed(3)}ms`);
|
|
93
|
-
console.log(`Would be ~10ms for full rebuild, should be ~1ms for incremental`);
|
|
94
|
-
|
|
95
|
-
// Verify correct behavior
|
|
96
|
-
const stats = treeDebugger.getStats();
|
|
97
|
-
expect(stats.totalNodes).toBe(901); // 1 root + 900 root children
|
|
98
|
-
expect(treeDebugger.getNode(branch.id)).toBeUndefined();
|
|
99
|
-
|
|
100
|
-
// Performance assertion: Should scale with subtree size (k=101), not tree size (n=1002)
|
|
101
|
-
expect(duration).toBeLessThan(10);
|
|
102
|
-
});
|
|
103
|
-
|
|
104
|
-
it('multiple operations show cumulative benefit', () => {
|
|
105
|
-
// Build tree with 10 branches
|
|
106
|
-
const root = new BenchmarkWorkflow('Root');
|
|
107
|
-
const branches: BenchmarkWorkflow[] = [];
|
|
108
|
-
|
|
109
|
-
for (let i = 0; i < 10; i++) {
|
|
110
|
-
const branch = new BenchmarkWorkflow(`Branch${i}`, root);
|
|
111
|
-
branches.push(branch);
|
|
112
|
-
for (let j = 0; j < 10; j++) {
|
|
113
|
-
new BenchmarkWorkflow(`Node${i}_${j}`, branch);
|
|
114
|
-
}
|
|
115
|
-
}
|
|
116
|
-
|
|
117
|
-
const treeDebugger = new WorkflowTreeDebugger(root);
|
|
118
|
-
expect(treeDebugger.getStats().totalNodes).toBe(111); // 1 root + 10 branches + 100 leaf nodes
|
|
119
|
-
|
|
120
|
-
// Benchmark: Detach all 10 branches one by one
|
|
121
|
-
const start = performance.now();
|
|
122
|
-
for (const branch of branches) {
|
|
123
|
-
root.detachChild(branch);
|
|
124
|
-
}
|
|
125
|
-
const totalDuration = performance.now() - start;
|
|
126
|
-
|
|
127
|
-
console.log(`Detached 10 branches of 11 nodes each from 111-node tree: ${totalDuration.toFixed(3)}ms`);
|
|
128
|
-
console.log(`Average per detach: ${(totalDuration / 10).toFixed(3)}ms`);
|
|
129
|
-
|
|
130
|
-
// Verify correct behavior - only root remains
|
|
131
|
-
const stats = treeDebugger.getStats();
|
|
132
|
-
expect(stats.totalNodes).toBe(1);
|
|
133
|
-
expect(treeDebugger.getNode(root.id)).toBeDefined();
|
|
134
|
-
|
|
135
|
-
// Performance assertion: Total should be much less than 10 × O(n) rebuilds
|
|
136
|
-
// Full rebuild approach would be ~10 × 10ms = 100ms
|
|
137
|
-
// Incremental should be ~10 × 1ms = 10ms
|
|
138
|
-
expect(totalDuration).toBeLessThan(50);
|
|
139
|
-
});
|
|
140
|
-
});
|
|
@@ -1,457 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Node Map Update Performance Benchmarks
|
|
3
|
-
*
|
|
4
|
-
* Validates that the incremental node map update optimization (P1M3T2S2)
|
|
5
|
-
* provides measurable performance improvement over the previous full rebuild approach.
|
|
6
|
-
*
|
|
7
|
-
* Expected Performance Improvements:
|
|
8
|
-
* - Single node attach/detach: 10-100× faster (O(1) vs O(n))
|
|
9
|
-
* - Subtree operations: 10-100× faster (O(k) vs O(n))
|
|
10
|
-
* - Multiple operations: Cumulative benefit
|
|
11
|
-
*
|
|
12
|
-
* Performance Thresholds (CI-friendly with 2-3× buffer):
|
|
13
|
-
* - Single operation: < 5ms (expected < 1ms)
|
|
14
|
-
* - Subtree operation (100 nodes): < 10ms (expected < 2ms)
|
|
15
|
-
* - Multiple operations (10×): < 50ms (expected < 10ms)
|
|
16
|
-
* - Deep tree (2000 levels): < 100ms
|
|
17
|
-
* - Wide tree (100 children): < 100ms total, < 1ms average
|
|
18
|
-
*
|
|
19
|
-
* Related: plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T2S2/PRP.md
|
|
20
|
-
*/
|
|
21
|
-
|
|
22
|
-
import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
|
|
23
|
-
import { Workflow, WorkflowTreeDebugger } from '../../index.js';
|
|
24
|
-
|
|
25
|
-
/**
|
|
26
|
-
* BenchmarkWorkflow class for performance testing
|
|
27
|
-
* Pattern from: src/__tests__/adversarial/incremental-performance.test.ts:4-6
|
|
28
|
-
*/
|
|
29
|
-
class BenchmarkWorkflow extends Workflow {
|
|
30
|
-
async run() {
|
|
31
|
-
this.setStatus('completed');
|
|
32
|
-
}
|
|
33
|
-
}
|
|
34
|
-
|
|
35
|
-
describe('Node Map Update Performance Benchmarks', () => {
|
|
36
|
-
/**
|
|
37
|
-
* Setup: Mock console methods to prevent test output pollution
|
|
38
|
-
* Pattern from: src/__tests__/adversarial/deep-hierarchy-stress.test.ts:33-37
|
|
39
|
-
*/
|
|
40
|
-
beforeEach(() => {
|
|
41
|
-
vi.spyOn(console, 'log').mockImplementation(() => {});
|
|
42
|
-
vi.spyOn(console, 'error').mockImplementation(() => {});
|
|
43
|
-
vi.spyOn(console, 'warn').mockImplementation(() => {});
|
|
44
|
-
});
|
|
45
|
-
|
|
46
|
-
/**
|
|
47
|
-
* Teardown: Restore all mocks to prevent test pollution
|
|
48
|
-
* CRITICAL: Always use vi.restoreAllMocks() in afterEach
|
|
49
|
-
*/
|
|
50
|
-
afterEach(() => {
|
|
51
|
-
vi.restoreAllMocks();
|
|
52
|
-
});
|
|
53
|
-
|
|
54
|
-
/**
|
|
55
|
-
* Test 1: Single Node Detach from Large Tree (1000+ nodes)
|
|
56
|
-
*
|
|
57
|
-
* Validates that single node detach is O(1) vs old O(n) full rebuild.
|
|
58
|
-
* The incremental update only removes the single node from nodeMap,
|
|
59
|
-
* while the old approach would rebuild the entire map.
|
|
60
|
-
*
|
|
61
|
-
* Pattern from: src/__tests__/adversarial/incremental-performance.test.ts:9-39
|
|
62
|
-
*/
|
|
63
|
-
it('should detach single node from large tree in O(1) time', () => {
|
|
64
|
-
// ARRANGE: Build large tree (1000 nodes)
|
|
65
|
-
const root = new BenchmarkWorkflow('Root');
|
|
66
|
-
let current: any = root;
|
|
67
|
-
for (let i = 0; i < 999; i++) {
|
|
68
|
-
const child = new BenchmarkWorkflow(`Node${i}`, current);
|
|
69
|
-
current = child;
|
|
70
|
-
}
|
|
71
|
-
|
|
72
|
-
const treeDebugger = new WorkflowTreeDebugger(root);
|
|
73
|
-
expect(treeDebugger.getStats().totalNodes).toBe(1000);
|
|
74
|
-
|
|
75
|
-
// ACT: Benchmark detach single node (should be O(1) vs O(1000))
|
|
76
|
-
const start = performance.now();
|
|
77
|
-
const leaf = current; // Last node in chain
|
|
78
|
-
const parent = leaf.parent!;
|
|
79
|
-
parent.detachChild(leaf);
|
|
80
|
-
const duration = performance.now() - start;
|
|
81
|
-
|
|
82
|
-
console.log(`Detach duration: ${duration.toFixed(3)}ms`);
|
|
83
|
-
console.log(`Expected: < 1ms for incremental, ~10ms for full rebuild`);
|
|
84
|
-
|
|
85
|
-
// ASSERT: Verify functional correctness FIRST
|
|
86
|
-
const stats = treeDebugger.getStats();
|
|
87
|
-
expect(stats.totalNodes).toBe(999);
|
|
88
|
-
expect(treeDebugger.getNode(leaf.id)).toBeUndefined();
|
|
89
|
-
|
|
90
|
-
// ASSERT: Performance threshold (generous for CI)
|
|
91
|
-
expect(duration).toBeLessThan(5);
|
|
92
|
-
});
|
|
93
|
-
|
|
94
|
-
/**
|
|
95
|
-
* Test 2: Single Node Attach
|
|
96
|
-
*
|
|
97
|
-
* Validates that single node attach is O(k) where k = subtree size.
|
|
98
|
-
* The incremental update only adds the new subtree to nodeMap.
|
|
99
|
-
*
|
|
100
|
-
* Pattern from: src/__tests__/adversarial/incremental-performance.test.ts:41-67
|
|
101
|
-
*/
|
|
102
|
-
it('should attach single node in O(k) time where k = subtree size', () => {
|
|
103
|
-
// ARRANGE: Build large tree (100 nodes - smaller for attach test)
|
|
104
|
-
const root = new BenchmarkWorkflow('Root');
|
|
105
|
-
for (let i = 0; i < 99; i++) {
|
|
106
|
-
new BenchmarkWorkflow(`Node${i}`, root);
|
|
107
|
-
}
|
|
108
|
-
|
|
109
|
-
const treeDebugger = new WorkflowTreeDebugger(root);
|
|
110
|
-
expect(treeDebugger.getStats().totalNodes).toBe(100);
|
|
111
|
-
|
|
112
|
-
// ACT: Benchmark attach subtree with 10 nodes
|
|
113
|
-
const start = performance.now();
|
|
114
|
-
const newChild = new BenchmarkWorkflow('NewChild', root);
|
|
115
|
-
for (let i = 0; i < 9; i++) {
|
|
116
|
-
new BenchmarkWorkflow(`Descendant${i}`, newChild);
|
|
117
|
-
}
|
|
118
|
-
const duration = performance.now() - start;
|
|
119
|
-
|
|
120
|
-
console.log(`Attach 10-node subtree duration: ${duration.toFixed(3)}ms`);
|
|
121
|
-
console.log(`Expected: < 2ms for incremental, ~20ms for full rebuild`);
|
|
122
|
-
|
|
123
|
-
// ASSERT: Verify functional correctness
|
|
124
|
-
expect(treeDebugger.getStats().totalNodes).toBe(110);
|
|
125
|
-
expect(treeDebugger.getNode(newChild.id)).toBeDefined();
|
|
126
|
-
|
|
127
|
-
// ASSERT: Performance threshold
|
|
128
|
-
expect(duration).toBeLessThan(10);
|
|
129
|
-
});
|
|
130
|
-
|
|
131
|
-
/**
|
|
132
|
-
* Test 3: Subtree Detach with Varying Sizes
|
|
133
|
-
*
|
|
134
|
-
* Validates that subtree detach scales with subtree size (k), not tree size (n).
|
|
135
|
-
* Uses BFS-based removeSubtreeNodes() which is O(k) where k = subtree nodes.
|
|
136
|
-
*
|
|
137
|
-
* Pattern from: src/__tests__/adversarial/incremental-performance.test.ts:69-102
|
|
138
|
-
*/
|
|
139
|
-
it('should detach subtree in O(k) time where k = subtree size', () => {
|
|
140
|
-
// ARRANGE: Build tree with one large branch
|
|
141
|
-
const root = new BenchmarkWorkflow('Root');
|
|
142
|
-
const branch = new BenchmarkWorkflow('Branch', root);
|
|
143
|
-
|
|
144
|
-
// Add 100 nodes to branch
|
|
145
|
-
for (let i = 0; i < 100; i++) {
|
|
146
|
-
new BenchmarkWorkflow(`BranchNode${i}`, branch);
|
|
147
|
-
}
|
|
148
|
-
|
|
149
|
-
// Add 900 nodes to root
|
|
150
|
-
for (let i = 0; i < 900; i++) {
|
|
151
|
-
new BenchmarkWorkflow(`RootNode${i}`, root);
|
|
152
|
-
}
|
|
153
|
-
|
|
154
|
-
const treeDebugger = new WorkflowTreeDebugger(root);
|
|
155
|
-
expect(treeDebugger.getStats().totalNodes).toBe(1002); // 1 root + 1 branch + 100 + 900
|
|
156
|
-
|
|
157
|
-
// ACT: Detach entire branch (process 101 nodes, not 1002)
|
|
158
|
-
const start = performance.now();
|
|
159
|
-
root.detachChild(branch);
|
|
160
|
-
const duration = performance.now() - start;
|
|
161
|
-
|
|
162
|
-
console.log(`Detach 101-node subtree from 1002-node tree: ${duration.toFixed(3)}ms`);
|
|
163
|
-
console.log(`Processing 101 nodes (subtree size), not 1002 (tree size)`);
|
|
164
|
-
console.log(`Expected: < 2ms for incremental, ~100ms for full rebuild`);
|
|
165
|
-
|
|
166
|
-
// ASSERT: Verify functional correctness
|
|
167
|
-
const stats = treeDebugger.getStats();
|
|
168
|
-
expect(stats.totalNodes).toBe(901); // 1 root + 900 root children
|
|
169
|
-
expect(treeDebugger.getNode(branch.id)).toBeUndefined();
|
|
170
|
-
|
|
171
|
-
// ASSERT: Should scale with subtree size (k=101), not tree size (n=1002)
|
|
172
|
-
expect(duration).toBeLessThan(10);
|
|
173
|
-
});
|
|
174
|
-
|
|
175
|
-
/**
|
|
176
|
-
* Test 4: Cumulative Operations Benchmark
|
|
177
|
-
*
|
|
178
|
-
* Validates that multiple operations show cumulative benefit from incremental updates.
|
|
179
|
-
* Each operation is O(k) instead of O(n), so total time is much better.
|
|
180
|
-
*
|
|
181
|
-
* Pattern from: src/__tests__/adversarial/incremental-performance.test.ts:104-139
|
|
182
|
-
*/
|
|
183
|
-
it('should complete multiple operations efficiently', () => {
|
|
184
|
-
// ARRANGE: Build tree with 10 branches
|
|
185
|
-
const root = new BenchmarkWorkflow('Root');
|
|
186
|
-
const branches: BenchmarkWorkflow[] = [];
|
|
187
|
-
|
|
188
|
-
for (let i = 0; i < 10; i++) {
|
|
189
|
-
const branch = new BenchmarkWorkflow(`Branch${i}`, root);
|
|
190
|
-
branches.push(branch);
|
|
191
|
-
for (let j = 0; j < 10; j++) {
|
|
192
|
-
new BenchmarkWorkflow(`Node${i}_${j}`, branch);
|
|
193
|
-
}
|
|
194
|
-
}
|
|
195
|
-
|
|
196
|
-
const treeDebugger = new WorkflowTreeDebugger(root);
|
|
197
|
-
expect(treeDebugger.getStats().totalNodes).toBe(111); // 1 root + 10 branches + 100 leaf nodes
|
|
198
|
-
|
|
199
|
-
// ACT: Detach all 10 branches
|
|
200
|
-
const start = performance.now();
|
|
201
|
-
for (const branch of branches) {
|
|
202
|
-
root.detachChild(branch);
|
|
203
|
-
}
|
|
204
|
-
const totalDuration = performance.now() - start;
|
|
205
|
-
|
|
206
|
-
console.log(`Detached 10 branches of 11 nodes each from 111-node tree: ${totalDuration.toFixed(3)}ms`);
|
|
207
|
-
console.log(`Average per detach: ${(totalDuration / 10).toFixed(3)}ms`);
|
|
208
|
-
console.log(`Expected: < 10ms total for incremental, ~100ms for full rebuild`);
|
|
209
|
-
|
|
210
|
-
// ASSERT: Verify correct behavior - only root remains
|
|
211
|
-
const stats = treeDebugger.getStats();
|
|
212
|
-
expect(stats.totalNodes).toBe(1);
|
|
213
|
-
expect(treeDebugger.getNode(root.id)).toBeDefined();
|
|
214
|
-
|
|
215
|
-
// ASSERT: Total should be much less than 10 × O(n) rebuilds
|
|
216
|
-
expect(totalDuration).toBeLessThan(50);
|
|
217
|
-
});
|
|
218
|
-
|
|
219
|
-
/**
|
|
220
|
-
* Test 5: Deep Tree Stress Test (2000 levels)
|
|
221
|
-
*
|
|
222
|
-
* Validates that deep tree operations don't cause stack overflow
|
|
223
|
-
* and maintain efficient performance. The BFS-based removeSubtreeNodes()
|
|
224
|
-
* uses iteration, not recursion, to avoid stack overflow.
|
|
225
|
-
*
|
|
226
|
-
* Pattern from: src/__tests__/adversarial/deep-hierarchy-stress.test.ts:196-212
|
|
227
|
-
*/
|
|
228
|
-
it('should handle deep tree (2000 levels) efficiently', () => {
|
|
229
|
-
// ARRANGE: Build 2000-node deep linear chain
|
|
230
|
-
const DEPTH = 2000;
|
|
231
|
-
const root = new BenchmarkWorkflow('Root');
|
|
232
|
-
let current: any = root;
|
|
233
|
-
|
|
234
|
-
for (let i = 0; i < DEPTH; i++) {
|
|
235
|
-
const child = new BenchmarkWorkflow(`Child-${i}`, current);
|
|
236
|
-
current = child;
|
|
237
|
-
}
|
|
238
|
-
|
|
239
|
-
const treeDebugger = new WorkflowTreeDebugger(root);
|
|
240
|
-
expect(treeDebugger.getStats().totalNodes).toBe(2001); // root + 2000 children
|
|
241
|
-
|
|
242
|
-
// ACT: Benchmark attach node at depth 2000
|
|
243
|
-
const attachStart = performance.now();
|
|
244
|
-
const newChild = new BenchmarkWorkflow('NewChild', current);
|
|
245
|
-
const attachDuration = performance.now() - attachStart;
|
|
246
|
-
|
|
247
|
-
console.log(`Attach at depth 2000: ${attachDuration.toFixed(3)}ms`);
|
|
248
|
-
|
|
249
|
-
// ASSERT: Verify attach functional correctness
|
|
250
|
-
expect(treeDebugger.getStats().totalNodes).toBe(2002);
|
|
251
|
-
expect(treeDebugger.getNode(newChild.id)).toBeDefined();
|
|
252
|
-
expect(attachDuration).toBeLessThan(100);
|
|
253
|
-
|
|
254
|
-
// ACT: Benchmark detach node from depth 2000
|
|
255
|
-
const detachStart = performance.now();
|
|
256
|
-
current.detachChild(newChild);
|
|
257
|
-
const detachDuration = performance.now() - detachStart;
|
|
258
|
-
|
|
259
|
-
console.log(`Detach from depth 2000: ${detachDuration.toFixed(3)}ms`);
|
|
260
|
-
console.log(`Total deep tree operations: ${(attachDuration + detachDuration).toFixed(3)}ms`);
|
|
261
|
-
|
|
262
|
-
// ASSERT: Verify detach functional correctness
|
|
263
|
-
expect(treeDebugger.getStats().totalNodes).toBe(2001);
|
|
264
|
-
expect(treeDebugger.getNode(newChild.id)).toBeUndefined();
|
|
265
|
-
expect(detachDuration).toBeLessThan(100);
|
|
266
|
-
|
|
267
|
-
// ASSERT: No stack overflow occurred (test would have failed)
|
|
268
|
-
// ASSERT: Total operations should complete efficiently
|
|
269
|
-
expect(attachDuration + detachDuration).toBeLessThan(200);
|
|
270
|
-
});
|
|
271
|
-
|
|
272
|
-
/**
|
|
273
|
-
* Test 6: Wide Tree Benchmark
|
|
274
|
-
*
|
|
275
|
-
* Validates that wide tree operations scale efficiently.
|
|
276
|
-
* Each child attach/detach is independent O(1) operation.
|
|
277
|
-
*
|
|
278
|
-
* Pattern from: src/__tests__/adversarial/attachChild-performance.test.ts:161-183
|
|
279
|
-
*/
|
|
280
|
-
it('should handle wide tree efficiently', () => {
|
|
281
|
-
// ARRANGE: Create parent
|
|
282
|
-
const root = new BenchmarkWorkflow('Root');
|
|
283
|
-
const NUM_CHILDREN = 100;
|
|
284
|
-
|
|
285
|
-
// ACT: Measure time to attach all children
|
|
286
|
-
const startTime = performance.now();
|
|
287
|
-
const children: BenchmarkWorkflow[] = [];
|
|
288
|
-
for (let i = 0; i < NUM_CHILDREN; i++) {
|
|
289
|
-
const child = new BenchmarkWorkflow(`Child-${i}`, root);
|
|
290
|
-
children.push(child);
|
|
291
|
-
}
|
|
292
|
-
const totalDuration = performance.now() - startTime;
|
|
293
|
-
|
|
294
|
-
const treeDebugger = new WorkflowTreeDebugger(root);
|
|
295
|
-
|
|
296
|
-
// ASSERT: Verify functional correctness
|
|
297
|
-
expect(root.children).toHaveLength(NUM_CHILDREN);
|
|
298
|
-
expect(treeDebugger.getStats().totalNodes).toBe(101); // root + 100 children
|
|
299
|
-
|
|
300
|
-
// ASSERT: All children in nodeMap
|
|
301
|
-
for (const child of children) {
|
|
302
|
-
expect(treeDebugger.getNode(child.id)).toBeDefined();
|
|
303
|
-
}
|
|
304
|
-
|
|
305
|
-
// ASSERT: Performance (< 100ms total, < 1ms average)
|
|
306
|
-
expect(totalDuration).toBeLessThan(100);
|
|
307
|
-
const avgTime = totalDuration / NUM_CHILDREN;
|
|
308
|
-
expect(avgTime).toBeLessThan(1); // < 1ms per attachment
|
|
309
|
-
|
|
310
|
-
console.log(`Wide tree attach: ${totalDuration.toFixed(3)}ms total, ${avgTime.toFixed(3)}ms average`);
|
|
311
|
-
|
|
312
|
-
// ACT: Benchmark detach all children
|
|
313
|
-
const detachStart = performance.now();
|
|
314
|
-
for (const child of children) {
|
|
315
|
-
root.detachChild(child);
|
|
316
|
-
}
|
|
317
|
-
const detachDuration = performance.now() - detachStart;
|
|
318
|
-
|
|
319
|
-
console.log(`Wide tree detach: ${detachDuration.toFixed(3)}ms total`);
|
|
320
|
-
|
|
321
|
-
// ASSERT: Verify all children removed
|
|
322
|
-
expect(treeDebugger.getStats().totalNodes).toBe(1); // Only root remains
|
|
323
|
-
expect(detachDuration).toBeLessThan(100);
|
|
324
|
-
});
|
|
325
|
-
|
|
326
|
-
/**
|
|
327
|
-
* Test 7: Large Subtree Performance Validation
|
|
328
|
-
*
|
|
329
|
-
* Validates that subtree operations scale correctly with varying subtree sizes.
|
|
330
|
-
* Tests small (10 nodes), medium (100 nodes), and large (500 nodes) subtrees.
|
|
331
|
-
*/
|
|
332
|
-
it('should scale performance with subtree size not tree size', () => {
|
|
333
|
-
// ARRANGE: Create tree with different branch sizes
|
|
334
|
-
const root = new BenchmarkWorkflow('Root');
|
|
335
|
-
|
|
336
|
-
// Small branch (10 nodes)
|
|
337
|
-
const smallBranch = new BenchmarkWorkflow('SmallBranch', root);
|
|
338
|
-
for (let i = 0; i < 9; i++) {
|
|
339
|
-
new BenchmarkWorkflow(`SmallNode${i}`, smallBranch);
|
|
340
|
-
}
|
|
341
|
-
|
|
342
|
-
// Medium branch (100 nodes)
|
|
343
|
-
const mediumBranch = new BenchmarkWorkflow('MediumBranch', root);
|
|
344
|
-
for (let i = 0; i < 99; i++) {
|
|
345
|
-
new BenchmarkWorkflow(`MediumNode${i}`, mediumBranch);
|
|
346
|
-
}
|
|
347
|
-
|
|
348
|
-
// Large branch (500 nodes)
|
|
349
|
-
const largeBranch = new BenchmarkWorkflow('LargeBranch', root);
|
|
350
|
-
for (let i = 0; i < 499; i++) {
|
|
351
|
-
new BenchmarkWorkflow(`LargeNode${i}`, largeBranch);
|
|
352
|
-
}
|
|
353
|
-
|
|
354
|
-
// Add many nodes to root to make tree size >> subtree size
|
|
355
|
-
for (let i = 0; i < 1000; i++) {
|
|
356
|
-
new BenchmarkWorkflow(`RootNode${i}`, root);
|
|
357
|
-
}
|
|
358
|
-
|
|
359
|
-
const treeDebugger = new WorkflowTreeDebugger(root);
|
|
360
|
-
const initialTotal = treeDebugger.getStats().totalNodes;
|
|
361
|
-
// 1 root + 3 branches + 9 + 99 + 499 + 1000 = 1611
|
|
362
|
-
expect(initialTotal).toBe(1611);
|
|
363
|
-
|
|
364
|
-
// ACT: Benchmark detach small subtree (10 nodes: branch + 9 children)
|
|
365
|
-
const smallStart = performance.now();
|
|
366
|
-
root.detachChild(smallBranch);
|
|
367
|
-
const smallDuration = performance.now() - smallStart;
|
|
368
|
-
|
|
369
|
-
console.log(`Small subtree (10 nodes) detach: ${smallDuration.toFixed(3)}ms`);
|
|
370
|
-
expect(treeDebugger.getStats().totalNodes).toBe(1601); // 1611 - 10
|
|
371
|
-
expect(smallDuration).toBeLessThan(5);
|
|
372
|
-
|
|
373
|
-
// ACT: Benchmark detach medium subtree (100 nodes: branch + 99 children)
|
|
374
|
-
const mediumStart = performance.now();
|
|
375
|
-
root.detachChild(mediumBranch);
|
|
376
|
-
const mediumDuration = performance.now() - mediumStart;
|
|
377
|
-
|
|
378
|
-
console.log(`Medium subtree (100 nodes) detach: ${mediumDuration.toFixed(3)}ms`);
|
|
379
|
-
expect(treeDebugger.getStats().totalNodes).toBe(1501); // 1601 - 100
|
|
380
|
-
expect(mediumDuration).toBeLessThan(10);
|
|
381
|
-
|
|
382
|
-
// ACT: Benchmark detach large subtree (500 nodes: branch + 499 children)
|
|
383
|
-
const largeStart = performance.now();
|
|
384
|
-
root.detachChild(largeBranch);
|
|
385
|
-
const largeDuration = performance.now() - largeStart;
|
|
386
|
-
|
|
387
|
-
console.log(`Large subtree (500 nodes) detach: ${largeDuration.toFixed(3)}ms`);
|
|
388
|
-
expect(treeDebugger.getStats().totalNodes).toBe(1001); // 1501 - 500
|
|
389
|
-
expect(largeDuration).toBeLessThan(50);
|
|
390
|
-
|
|
391
|
-
// ASSERT: Performance scales with subtree size, not tree size
|
|
392
|
-
// Each subtree operation should be proportional to subtree nodes, not total nodes
|
|
393
|
-
console.log(`Scaling check - Small: ${smallDuration.toFixed(3)}ms, Medium: ${mediumDuration.toFixed(3)}ms, Large: ${largeDuration.toFixed(3)}ms`);
|
|
394
|
-
expect(smallDuration).toBeLessThan(mediumDuration);
|
|
395
|
-
expect(mediumDuration).toBeLessThan(largeDuration);
|
|
396
|
-
});
|
|
397
|
-
|
|
398
|
-
/**
|
|
399
|
-
* Test 8: Incremental Update Correctness Validation
|
|
400
|
-
*
|
|
401
|
-
* Validates that incremental updates maintain functional correctness
|
|
402
|
-
* alongside performance improvements. Tests various edge cases.
|
|
403
|
-
*/
|
|
404
|
-
it('should maintain correctness with incremental updates', () => {
|
|
405
|
-
// ARRANGE: Build complex tree structure
|
|
406
|
-
const root = new BenchmarkWorkflow('Root');
|
|
407
|
-
|
|
408
|
-
// Create first branch
|
|
409
|
-
const branch1 = new BenchmarkWorkflow('Branch1', root);
|
|
410
|
-
const branch1Child1 = new BenchmarkWorkflow('Branch1Child1', branch1);
|
|
411
|
-
const branch1Child2 = new BenchmarkWorkflow('Branch1Child2', branch1);
|
|
412
|
-
|
|
413
|
-
// Create second branch
|
|
414
|
-
const branch2 = new BenchmarkWorkflow('Branch2', root);
|
|
415
|
-
const branch2Child1 = new BenchmarkWorkflow('Branch2Child1', branch2);
|
|
416
|
-
|
|
417
|
-
const treeDebugger = new WorkflowTreeDebugger(root);
|
|
418
|
-
const initialStats = treeDebugger.getStats();
|
|
419
|
-
|
|
420
|
-
// ASSERT: Verify initial state (root + 2 branches + 3 grandchildren = 6 nodes)
|
|
421
|
-
expect(initialStats.totalNodes).toBe(6);
|
|
422
|
-
expect(treeDebugger.getNode(root.id)).toBeDefined();
|
|
423
|
-
expect(treeDebugger.getNode(branch1.id)).toBeDefined();
|
|
424
|
-
expect(treeDebugger.getNode(branch2.id)).toBeDefined();
|
|
425
|
-
expect(treeDebugger.getNode(branch1Child1.id)).toBeDefined();
|
|
426
|
-
expect(treeDebugger.getNode(branch1Child2.id)).toBeDefined();
|
|
427
|
-
expect(treeDebugger.getNode(branch2Child1.id)).toBeDefined();
|
|
428
|
-
|
|
429
|
-
// ACT: Detach first branch (removes 3 nodes: branch1 + 2 children)
|
|
430
|
-
root.detachChild(branch1);
|
|
431
|
-
|
|
432
|
-
// ASSERT: Verify branch1 and its children removed
|
|
433
|
-
expect(treeDebugger.getStats().totalNodes).toBe(3); // root + branch2 + 1 child
|
|
434
|
-
expect(treeDebugger.getNode(branch1.id)).toBeUndefined();
|
|
435
|
-
expect(treeDebugger.getNode(branch1Child1.id)).toBeUndefined();
|
|
436
|
-
expect(treeDebugger.getNode(branch1Child2.id)).toBeUndefined();
|
|
437
|
-
|
|
438
|
-
// ASSERT: Verify branch2 unaffected
|
|
439
|
-
expect(treeDebugger.getNode(branch2.id)).toBeDefined();
|
|
440
|
-
expect(treeDebugger.getNode(branch2Child1.id)).toBeDefined();
|
|
441
|
-
|
|
442
|
-
// ACT: Reattach branch1 with new children
|
|
443
|
-
const newBranch1 = new BenchmarkWorkflow('NewBranch1', root);
|
|
444
|
-
const newChild1 = new BenchmarkWorkflow('NewChild1', newBranch1);
|
|
445
|
-
const newChild2 = new BenchmarkWorkflow('NewChild2', newBranch1);
|
|
446
|
-
|
|
447
|
-
// ASSERT: Verify new nodes added correctly
|
|
448
|
-
expect(treeDebugger.getStats().totalNodes).toBe(6); // Back to 6 nodes (root + branch2 + newBranch1 + 2 children)
|
|
449
|
-
expect(treeDebugger.getNode(newBranch1.id)).toBeDefined();
|
|
450
|
-
expect(treeDebugger.getNode(newChild1.id)).toBeDefined();
|
|
451
|
-
expect(treeDebugger.getNode(newChild2.id)).toBeDefined();
|
|
452
|
-
|
|
453
|
-
// ASSERT: Verify original branch2 still present
|
|
454
|
-
expect(treeDebugger.getNode(branch2.id)).toBeDefined();
|
|
455
|
-
expect(treeDebugger.getNode(branch2Child1.id)).toBeDefined();
|
|
456
|
-
});
|
|
457
|
-
});
|