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.
Files changed (554) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +26 -9
  3. package/dist/cache/cache-key.d.ts +86 -0
  4. package/dist/cache/cache-key.d.ts.map +1 -0
  5. package/dist/cache/cache-key.js +204 -0
  6. package/dist/cache/cache-key.js.map +1 -0
  7. package/dist/cache/cache.d.ts +104 -0
  8. package/dist/cache/cache.d.ts.map +1 -0
  9. package/dist/cache/cache.js +179 -0
  10. package/dist/cache/cache.js.map +1 -0
  11. package/{src/cache/index.ts → dist/cache/index.d.ts} +1 -1
  12. package/dist/cache/index.d.ts.map +1 -0
  13. package/dist/cache/index.js +6 -0
  14. package/dist/cache/index.js.map +1 -0
  15. package/dist/core/agent.d.ts +203 -0
  16. package/dist/core/agent.d.ts.map +1 -0
  17. package/dist/core/agent.js +833 -0
  18. package/dist/core/agent.js.map +1 -0
  19. package/{src/core/context.ts → dist/core/context.d.ts} +16 -67
  20. package/dist/core/context.d.ts.map +1 -0
  21. package/dist/core/context.js +80 -0
  22. package/dist/core/context.js.map +1 -0
  23. package/dist/core/event-tree.d.ts +72 -0
  24. package/dist/core/event-tree.d.ts.map +1 -0
  25. package/dist/core/event-tree.js +211 -0
  26. package/dist/core/event-tree.js.map +1 -0
  27. package/{src/core/factory.ts → dist/core/factory.d.ts} +6 -27
  28. package/dist/core/factory.d.ts.map +1 -0
  29. package/dist/core/factory.js +110 -0
  30. package/dist/core/factory.js.map +1 -0
  31. package/{src/core/index.ts → dist/core/index.d.ts} +2 -10
  32. package/dist/core/index.d.ts.map +1 -0
  33. package/dist/core/index.js +9 -0
  34. package/dist/core/index.js.map +1 -0
  35. package/dist/core/logger.d.ts +50 -0
  36. package/dist/core/logger.d.ts.map +1 -0
  37. package/dist/core/logger.js +91 -0
  38. package/dist/core/logger.js.map +1 -0
  39. package/dist/core/mcp-handler.d.ts +127 -0
  40. package/dist/core/mcp-handler.d.ts.map +1 -0
  41. package/dist/core/mcp-handler.js +323 -0
  42. package/dist/core/mcp-handler.js.map +1 -0
  43. package/dist/core/prompt.d.ts +80 -0
  44. package/dist/core/prompt.d.ts.map +1 -0
  45. package/dist/core/prompt.js +120 -0
  46. package/dist/core/prompt.js.map +1 -0
  47. package/dist/core/workflow-context.d.ts +61 -0
  48. package/dist/core/workflow-context.d.ts.map +1 -0
  49. package/dist/core/workflow-context.js +358 -0
  50. package/dist/core/workflow-context.js.map +1 -0
  51. package/dist/core/workflow.d.ts +543 -0
  52. package/dist/core/workflow.d.ts.map +1 -0
  53. package/dist/core/workflow.js +986 -0
  54. package/dist/core/workflow.js.map +1 -0
  55. package/dist/debugger/event-replayer.d.ts +422 -0
  56. package/dist/debugger/event-replayer.d.ts.map +1 -0
  57. package/dist/debugger/event-replayer.js +639 -0
  58. package/dist/debugger/event-replayer.js.map +1 -0
  59. package/dist/debugger/index.d.ts +2 -0
  60. package/dist/debugger/index.d.ts.map +1 -0
  61. package/{src/debugger/index.ts → dist/debugger/index.js} +1 -0
  62. package/dist/debugger/index.js.map +1 -0
  63. package/dist/debugger/tree-debugger.d.ts +240 -0
  64. package/dist/debugger/tree-debugger.d.ts.map +1 -0
  65. package/dist/debugger/tree-debugger.js +620 -0
  66. package/dist/debugger/tree-debugger.js.map +1 -0
  67. package/dist/decorators/index.d.ts +4 -0
  68. package/dist/decorators/index.d.ts.map +1 -0
  69. package/{src/decorators/index.ts → dist/decorators/index.js} +1 -0
  70. package/dist/decorators/index.js.map +1 -0
  71. package/dist/decorators/observed-state.d.ts +32 -0
  72. package/dist/decorators/observed-state.d.ts.map +1 -0
  73. package/dist/decorators/observed-state.js +79 -0
  74. package/dist/decorators/observed-state.js.map +1 -0
  75. package/dist/decorators/step.d.ts +15 -0
  76. package/dist/decorators/step.d.ts.map +1 -0
  77. package/dist/decorators/step.js +192 -0
  78. package/dist/decorators/step.js.map +1 -0
  79. package/dist/decorators/task.d.ts +50 -0
  80. package/dist/decorators/task.d.ts.map +1 -0
  81. package/dist/decorators/task.js +118 -0
  82. package/dist/decorators/task.js.map +1 -0
  83. package/dist/examples/index.d.ts +3 -0
  84. package/dist/examples/index.d.ts.map +1 -0
  85. package/{src/examples/index.ts → dist/examples/index.js} +1 -0
  86. package/dist/examples/index.js.map +1 -0
  87. package/dist/examples/tdd-orchestrator.d.ts +15 -0
  88. package/dist/examples/tdd-orchestrator.d.ts.map +1 -0
  89. package/dist/examples/tdd-orchestrator.js +121 -0
  90. package/dist/examples/tdd-orchestrator.js.map +1 -0
  91. package/dist/examples/test-cycle-workflow.d.ts +14 -0
  92. package/dist/examples/test-cycle-workflow.d.ts.map +1 -0
  93. package/dist/examples/test-cycle-workflow.js +116 -0
  94. package/dist/examples/test-cycle-workflow.js.map +1 -0
  95. package/dist/harnesses/claude-code-harness.d.ts +391 -0
  96. package/dist/harnesses/claude-code-harness.d.ts.map +1 -0
  97. package/dist/harnesses/claude-code-harness.js +1076 -0
  98. package/dist/harnesses/claude-code-harness.js.map +1 -0
  99. package/dist/harnesses/harness-registry.d.ts +440 -0
  100. package/dist/harnesses/harness-registry.d.ts.map +1 -0
  101. package/dist/harnesses/harness-registry.js +543 -0
  102. package/dist/harnesses/harness-registry.js.map +1 -0
  103. package/dist/harnesses/index.d.ts +12 -0
  104. package/dist/harnesses/index.d.ts.map +1 -0
  105. package/dist/harnesses/index.js +11 -0
  106. package/dist/harnesses/index.js.map +1 -0
  107. package/dist/harnesses/pi-harness.d.ts +219 -0
  108. package/dist/harnesses/pi-harness.d.ts.map +1 -0
  109. package/dist/harnesses/pi-harness.js +676 -0
  110. package/dist/harnesses/pi-harness.js.map +1 -0
  111. package/dist/harnesses/pi-schema-converter.d.ts +24 -0
  112. package/dist/harnesses/pi-schema-converter.d.ts.map +1 -0
  113. package/dist/harnesses/pi-schema-converter.js +81 -0
  114. package/dist/harnesses/pi-schema-converter.js.map +1 -0
  115. package/dist/harnesses/register-defaults.d.ts +24 -0
  116. package/dist/harnesses/register-defaults.d.ts.map +1 -0
  117. package/dist/harnesses/register-defaults.js +40 -0
  118. package/dist/harnesses/register-defaults.js.map +1 -0
  119. package/dist/harnesses/session-store.d.ts +201 -0
  120. package/dist/harnesses/session-store.d.ts.map +1 -0
  121. package/dist/harnesses/session-store.js +254 -0
  122. package/dist/harnesses/session-store.js.map +1 -0
  123. package/dist/index.d.ts +37 -0
  124. package/dist/index.d.ts.map +1 -0
  125. package/dist/index.js +57 -0
  126. package/dist/index.js.map +1 -0
  127. package/dist/reflection/index.d.ts +5 -0
  128. package/dist/reflection/index.d.ts.map +1 -0
  129. package/{src/reflection/index.ts → dist/reflection/index.js} +1 -1
  130. package/dist/reflection/index.js.map +1 -0
  131. package/dist/reflection/reflection.d.ts +84 -0
  132. package/dist/reflection/reflection.d.ts.map +1 -0
  133. package/dist/reflection/reflection.js +344 -0
  134. package/dist/reflection/reflection.js.map +1 -0
  135. package/dist/tools/index.d.ts +6 -0
  136. package/dist/tools/index.d.ts.map +1 -0
  137. package/dist/tools/index.js +11 -0
  138. package/dist/tools/index.js.map +1 -0
  139. package/dist/tools/introspection.d.ts +165 -0
  140. package/dist/tools/introspection.d.ts.map +1 -0
  141. package/dist/tools/introspection.js +324 -0
  142. package/dist/tools/introspection.js.map +1 -0
  143. package/dist/types/agent.d.ts +1317 -0
  144. package/dist/types/agent.d.ts.map +1 -0
  145. package/dist/types/agent.js +423 -0
  146. package/dist/types/agent.js.map +1 -0
  147. package/dist/types/decorators.d.ts +40 -0
  148. package/dist/types/decorators.d.ts.map +1 -0
  149. package/dist/types/decorators.js +2 -0
  150. package/dist/types/decorators.js.map +1 -0
  151. package/dist/types/error-strategy.d.ts +13 -0
  152. package/dist/types/error-strategy.d.ts.map +1 -0
  153. package/dist/types/error-strategy.js +2 -0
  154. package/dist/types/error-strategy.js.map +1 -0
  155. package/dist/types/error.d.ts +20 -0
  156. package/dist/types/error.d.ts.map +1 -0
  157. package/dist/types/error.js +2 -0
  158. package/dist/types/error.js.map +1 -0
  159. package/dist/types/events.d.ts +113 -0
  160. package/dist/types/events.d.ts.map +1 -0
  161. package/dist/types/events.js +2 -0
  162. package/dist/types/events.js.map +1 -0
  163. package/dist/types/harnesses.d.ts +474 -0
  164. package/dist/types/harnesses.d.ts.map +1 -0
  165. package/dist/types/harnesses.js +2 -0
  166. package/dist/types/harnesses.js.map +1 -0
  167. package/dist/types/index.d.ts +23 -0
  168. package/dist/types/index.d.ts.map +1 -0
  169. package/dist/types/index.js +8 -0
  170. package/dist/types/index.js.map +1 -0
  171. package/dist/types/logging.d.ts +24 -0
  172. package/dist/types/logging.d.ts.map +1 -0
  173. package/dist/types/logging.js +2 -0
  174. package/dist/types/logging.js.map +1 -0
  175. package/dist/types/observer.d.ts +18 -0
  176. package/dist/types/observer.d.ts.map +1 -0
  177. package/dist/types/observer.js +2 -0
  178. package/dist/types/observer.js.map +1 -0
  179. package/dist/types/prompt.d.ts +31 -0
  180. package/dist/types/prompt.d.ts.map +1 -0
  181. package/dist/types/prompt.js +6 -0
  182. package/dist/types/prompt.js.map +1 -0
  183. package/dist/types/providers.d.ts +691 -0
  184. package/dist/types/providers.d.ts.map +1 -0
  185. package/dist/types/providers.js +14 -0
  186. package/dist/types/providers.js.map +1 -0
  187. package/dist/types/reflection.d.ts +96 -0
  188. package/dist/types/reflection.d.ts.map +1 -0
  189. package/dist/types/reflection.js +24 -0
  190. package/dist/types/reflection.js.map +1 -0
  191. package/dist/types/restart.d.ts +132 -0
  192. package/dist/types/restart.d.ts.map +1 -0
  193. package/dist/types/restart.js +2 -0
  194. package/dist/types/restart.js.map +1 -0
  195. package/dist/types/sdk-primitives.d.ts +118 -0
  196. package/dist/types/sdk-primitives.d.ts.map +1 -0
  197. package/dist/types/sdk-primitives.js +6 -0
  198. package/dist/types/sdk-primitives.js.map +1 -0
  199. package/{src/types/snapshot.ts → dist/types/snapshot.d.ts} +5 -5
  200. package/dist/types/snapshot.d.ts.map +1 -0
  201. package/dist/types/snapshot.js +2 -0
  202. package/dist/types/snapshot.js.map +1 -0
  203. package/dist/types/streaming.d.ts +194 -0
  204. package/dist/types/streaming.d.ts.map +1 -0
  205. package/dist/types/streaming.js +67 -0
  206. package/dist/types/streaming.js.map +1 -0
  207. package/dist/types/workflow-context.d.ts +275 -0
  208. package/dist/types/workflow-context.d.ts.map +1 -0
  209. package/dist/types/workflow-context.js +8 -0
  210. package/dist/types/workflow-context.js.map +1 -0
  211. package/dist/types/workflow.d.ts +30 -0
  212. package/dist/types/workflow.d.ts.map +1 -0
  213. package/dist/types/workflow.js +2 -0
  214. package/dist/types/workflow.js.map +1 -0
  215. package/dist/utils/agent-validation.d.ts +88 -0
  216. package/dist/utils/agent-validation.d.ts.map +1 -0
  217. package/dist/utils/agent-validation.js +87 -0
  218. package/dist/utils/agent-validation.js.map +1 -0
  219. package/dist/utils/delay.d.ts +7 -0
  220. package/dist/utils/delay.d.ts.map +1 -0
  221. package/dist/utils/delay.js +9 -0
  222. package/dist/utils/delay.js.map +1 -0
  223. package/dist/utils/harness-config.d.ts +180 -0
  224. package/dist/utils/harness-config.d.ts.map +1 -0
  225. package/dist/utils/harness-config.js +311 -0
  226. package/dist/utils/harness-config.js.map +1 -0
  227. package/dist/utils/id.d.ts +6 -0
  228. package/dist/utils/id.d.ts.map +1 -0
  229. package/dist/utils/id.js +12 -0
  230. package/dist/utils/id.js.map +1 -0
  231. package/dist/utils/index.d.ts +13 -0
  232. package/dist/utils/index.d.ts.map +1 -0
  233. package/dist/utils/index.js +11 -0
  234. package/dist/utils/index.js.map +1 -0
  235. package/dist/utils/model-spec.d.ts +110 -0
  236. package/dist/utils/model-spec.d.ts.map +1 -0
  237. package/dist/utils/model-spec.js +149 -0
  238. package/dist/utils/model-spec.js.map +1 -0
  239. package/dist/utils/observable.d.ts +54 -0
  240. package/dist/utils/observable.d.ts.map +1 -0
  241. package/dist/utils/observable.js +82 -0
  242. package/dist/utils/observable.js.map +1 -0
  243. package/dist/utils/provider-config.d.ts +10 -0
  244. package/dist/utils/provider-config.d.ts.map +1 -0
  245. package/dist/utils/provider-config.js +10 -0
  246. package/dist/utils/provider-config.js.map +1 -0
  247. package/dist/utils/restart-analysis.d.ts +202 -0
  248. package/dist/utils/restart-analysis.d.ts.map +1 -0
  249. package/dist/utils/restart-analysis.js +426 -0
  250. package/dist/utils/restart-analysis.js.map +1 -0
  251. package/dist/utils/session-serialization.d.ts +118 -0
  252. package/dist/utils/session-serialization.d.ts.map +1 -0
  253. package/dist/utils/session-serialization.js +217 -0
  254. package/dist/utils/session-serialization.js.map +1 -0
  255. package/dist/utils/workflow-error-utils.d.ts +22 -0
  256. package/dist/utils/workflow-error-utils.d.ts.map +1 -0
  257. package/dist/utils/workflow-error-utils.js +45 -0
  258. package/dist/utils/workflow-error-utils.js.map +1 -0
  259. package/package.json +34 -5
  260. package/.claude/commands/subtask-planning/prp-base-create.md +0 -120
  261. package/.claude/commands/subtask-planning/prp-base-execute.md +0 -65
  262. package/.claude/commands/task-breakdown.md +0 -94
  263. package/.claude/settings.local.json +0 -9
  264. package/.claude/system_prompts/task-breakdown.md +0 -101
  265. package/CHANGELOG.md +0 -188
  266. package/PRD.md +0 -543
  267. package/PRPs/001-hierarchical-workflow-engine.md +0 -2438
  268. package/PRPs/PRDs/002-agent-prompt.md +0 -390
  269. package/PRPs/PRDs/003-agent-prompt.md +0 -943
  270. package/PRPs/PRDs/004-agent-prompt.md +0 -1136
  271. package/PRPs/PRDs/tasks-001.json +0 -492
  272. package/PRPs/README.md +0 -83
  273. package/PRPs/templates/prp_base.md +0 -222
  274. package/docs/agent.md +0 -422
  275. package/docs/prompt.md +0 -419
  276. package/docs/workflow.md +0 -600
  277. package/examples/README.md +0 -258
  278. package/examples/examples/01-basic-workflow.ts +0 -100
  279. package/examples/examples/02-decorator-options.ts +0 -217
  280. package/examples/examples/03-parent-child.ts +0 -241
  281. package/examples/examples/04-observers-debugger.ts +0 -340
  282. package/examples/examples/05-error-handling.ts +0 -387
  283. package/examples/examples/06-concurrent-tasks.ts +0 -352
  284. package/examples/examples/07-agent-loops.ts +0 -432
  285. package/examples/examples/08-sdk-features.ts +0 -667
  286. package/examples/examples/09-reflection.ts +0 -573
  287. package/examples/examples/10-introspection.ts +0 -550
  288. package/examples/examples/11-reparenting-workflows.ts +0 -269
  289. package/examples/index.ts +0 -147
  290. package/examples/utils/helpers.ts +0 -57
  291. package/package-lock.json +0 -2398
  292. package/plan/001_d3bb02af4886/TEST_RESULTS.md +0 -259
  293. package/plan/001_d3bb02af4886/backlog.json +0 -867
  294. package/plan/001_d3bb02af4886/bug_fix_tasks.json +0 -484
  295. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M1T1S1/PRP.md +0 -488
  296. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M1T1S2/PRP.md +0 -581
  297. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M1T1S3/PRP.md +0 -687
  298. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T1S1/PRP.md +0 -492
  299. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T1S3/PRP.md +0 -932
  300. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T1S3/research/concurrent_error_testing_patterns.md +0 -1109
  301. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T1S3/research/vitest_concurrent_testing.md +0 -802
  302. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T1S3/research/workflow_engine_test_references.md +0 -603
  303. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T2S1/PRP.md +0 -564
  304. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T2S3/PRP.md +0 -518
  305. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T2S4/PRP.md +0 -1252
  306. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T3S1/PRP.md +0 -364
  307. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T3S1/research/CODEBASE_INVENTORY.md +0 -114
  308. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T3S1/research/DECORATOR_DOCUMENTATION_PATTERNS.md +0 -205
  309. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T3S1/research/PRD_LOCATION_ANALYSIS.md +0 -199
  310. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T3S1/research/ULTRATHINK_PRP_PLAN.md +0 -134
  311. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T1S1/PRP.md +0 -495
  312. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T1S1/research/console_error_inventory.md +0 -435
  313. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T1S2/PRP.md +0 -506
  314. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T1S3/PRP.md +0 -612
  315. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T2S2/PRP.md +0 -558
  316. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T2S2/research/external_research.md +0 -788
  317. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T3S2/PRP.md +0 -460
  318. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T3S3/PRP.md +0 -454
  319. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T4S1/PRP.md +0 -520
  320. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T4S1/RECOMMENDATION.md +0 -417
  321. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T4S1/research/external_workflow_engines_research.md +0 -760
  322. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T4S1/research/security_implications_analysis.md +0 -245
  323. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T4S2/PRP.md +0 -792
  324. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M4T1S1/PRP.md +0 -535
  325. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M4T1S1/TEST_EXECUTION_REPORT.md +0 -190
  326. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M4T1S2/PRP.md +0 -654
  327. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M4T1S2/TEST_FIX_REPORT.md +0 -227
  328. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M4T1S2/research/KEY_FINDINGS.md +0 -345
  329. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M4T1S2/research/QUICK_REFERENCE.md +0 -193
  330. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M4T1S2/research/test_maintenance_research.md +0 -1323
  331. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M4T3S1/BREAKING_CHANGES_AUDIT.md +0 -1011
  332. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M4T3S1/PRP.md +0 -927
  333. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M4T3S2/PRP.md +0 -505
  334. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/architecture/logger_child_signature_analysis.md +0 -401
  335. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M1T1S3/child_implementation_research.md +0 -142
  336. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M1T1S3/test_patterns_research.md +0 -112
  337. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M1T1S3/vitest_patterns_research.md +0 -159
  338. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M1T1S4/PRP.md +0 -549
  339. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M1T1S4/VERIFICATION_REPORT.md +0 -368
  340. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M1T1S4/edge_case_analysis.md +0 -172
  341. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M1T1S4/usage_inventory.md +0 -175
  342. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T1S2/PRP.md +0 -696
  343. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T1S4/PRP.md +0 -860
  344. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/PRP.md +0 -1066
  345. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/01-testing-aggregated-errors.md +0 -1103
  346. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/01_typescript_error_aggregation_patterns.md +0 -789
  347. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/02-error-merge-strategy-testing-guide.md +0 -1098
  348. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/02_aggregate_error_patterns.md +0 -1037
  349. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/03-promise-allsettled-testing-patterns.md +0 -916
  350. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/03_error_merging_strategies.md +0 -1045
  351. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/04_github_stackoverflow_examples.md +0 -890
  352. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/05_comprehensive_summary.md +0 -822
  353. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/INDEX.md +0 -668
  354. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/QUICK_REFERENCE.md +0 -706
  355. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/README.md +0 -265
  356. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/RESEARCH_REPORT.md +0 -655
  357. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S4/research/vitest_testing_patterns.md +0 -1103
  358. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T3S2/PRP.md +0 -426
  359. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T1S2/PRP.md +0 -506
  360. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T1S2/research/QUICK_REFERENCE.md +0 -114
  361. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T1S2/research/RESEARCH_SUMMARY.md +0 -316
  362. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T1S2/research/vitest_observer_error_logging_best_practices.md +0 -754
  363. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T1S3/PRP.md +0 -612
  364. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T2S1/PRP.md +0 -719
  365. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T2S1/README.md +0 -215
  366. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T2S1/analysis.md +0 -765
  367. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T2S3/PRP.md +0 -718
  368. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T3S1/DECISION.md +0 -149
  369. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T3S1/PRP.md +0 -470
  370. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T3S1/research/ULTRATHINK_PLAN.md +0 -332
  371. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T3S1/research/codebase_workflow_name_analysis.md +0 -167
  372. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T3S1/research/external_best_practices.md +0 -265
  373. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T3S1/research/validation_patterns.md +0 -273
  374. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T4S1/workflow_engine_ancestry_api_research.md +0 -760
  375. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T4S3-PRP.md +0 -434
  376. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M4T2S1/PRP.md +0 -717
  377. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M4T2S2/PRP.md +0 -472
  378. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M4T2S2/VALIDATION_REPORT.md +0 -125
  379. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M4T2S2/research/ULTRATHINK_PRP_PLAN.md +0 -301
  380. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/error-logging-best-practices.md +0 -1170
  381. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/research_typescript_partial_and_overloads.md +0 -940
  382. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/vitest-quick-reference.md +0 -151
  383. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/vitest-research.md +0 -650
  384. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/prd_snapshot.md +0 -259
  385. package/plan/001_d3bb02af4886/bugfix/P1M1T1S1/PRP.md +0 -457
  386. package/plan/001_d3bb02af4886/bugfix/RESEARCH_SUMMARY.md +0 -346
  387. package/plan/001_d3bb02af4886/bugfix/architecture/codebase_structure.md +0 -311
  388. package/plan/001_d3bb02af4886/bugfix/architecture/concurrent_execution_best_practices.md +0 -1565
  389. package/plan/001_d3bb02af4886/bugfix/architecture/error_handling_patterns.md +0 -288
  390. package/plan/001_d3bb02af4886/bugfix/architecture/promise_all_analysis.md +0 -741
  391. package/plan/001_d3bb02af4886/docs/PRP/P1M1T1S4-functional-workflow-error-state-capture-test.md +0 -652
  392. package/plan/001_d3bb02af4886/docs/PRP/P1P2-PRP.md +0 -527
  393. package/plan/001_d3bb02af4886/docs/PRP/P3P4-PRP.md +0 -1388
  394. package/plan/001_d3bb02af4886/docs/PRP/P4P5-PRP.md +0 -1136
  395. package/plan/001_d3bb02af4886/docs/PRP/PRP.md +0 -527
  396. package/plan/001_d3bb02af4886/docs/PRP/bugfix/P1M1T2S1-PRP.md +0 -415
  397. package/plan/001_d3bb02af4886/docs/PRP/bugfix/P1M1T2S2-PRP.md +0 -378
  398. package/plan/001_d3bb02af4886/docs/PRP/bugfix/P1M1T2S4-PRP.md +0 -713
  399. package/plan/001_d3bb02af4886/docs/PRP/bugfix/P1M2T1S4-PRP.md +0 -370
  400. package/plan/001_d3bb02af4886/docs/PRP_P1M3T1S3.md +0 -499
  401. package/plan/001_d3bb02af4886/docs/TEST_RESULTS.md +0 -230
  402. package/plan/001_d3bb02af4886/docs/architecture/external_deps.md +0 -358
  403. package/plan/001_d3bb02af4886/docs/architecture/system_context.md +0 -242
  404. package/plan/001_d3bb02af4886/docs/bugfix/ANALYSIS_PRD_VS_IMPLEMENTATION.md +0 -1134
  405. package/plan/001_d3bb02af4886/docs/bugfix/GAP_ANALYSIS_SUMMARY.md +0 -179
  406. package/plan/001_d3bb02af4886/docs/bugfix/P1M4T2S1/PRP.md +0 -629
  407. package/plan/001_d3bb02af4886/docs/bugfix/P1M4T2S1/validation-report.md +0 -214
  408. package/plan/001_d3bb02af4886/docs/bugfix/PRP_P1M4T2S3.md +0 -629
  409. package/plan/001_d3bb02af4886/docs/bugfix/bugfix_PRP.md +0 -529
  410. package/plan/001_d3bb02af4886/docs/bugfix/bugfix_QUICK_REFERENCE.md +0 -142
  411. package/plan/001_d3bb02af4886/docs/bugfix/bugfix_README.md +0 -304
  412. package/plan/001_d3bb02af4886/docs/bugfix/bugfix_TEST_RESULTS.md +0 -558
  413. package/plan/001_d3bb02af4886/docs/bugfix/bugfix_VALIDATION_SUMMARY.md +0 -256
  414. package/plan/001_d3bb02af4886/docs/bugfix/system_context.md +0 -346
  415. package/plan/001_d3bb02af4886/docs/bugfix-architecture/bug_analysis.md +0 -415
  416. package/plan/001_d3bb02af4886/docs/bugfix-architecture/implementation_patterns.md +0 -489
  417. package/plan/001_d3bb02af4886/docs/bugfix-architecture/system_context.md +0 -218
  418. package/plan/001_d3bb02af4886/docs/bugfix_INITIATION_SUMMARY.md +0 -380
  419. package/plan/001_d3bb02af4886/docs/research/CYCLE_DETECTION_PATTERNS.md +0 -1923
  420. package/plan/001_d3bb02af4886/docs/research/CYCLE_DETECTION_QUICK_REF.md +0 -319
  421. package/plan/001_d3bb02af4886/docs/research/P1M1T2S1/codebase-context.md +0 -115
  422. package/plan/001_d3bb02af4886/docs/research/P1M1T2S1/cycle-detection-algorithms.md +0 -134
  423. package/plan/001_d3bb02af4886/docs/research/P1M1T2S1/test-patterns.md +0 -153
  424. package/plan/001_d3bb02af4886/docs/research/P1M1T2S1/workflow-class.md +0 -132
  425. package/plan/001_d3bb02af4886/docs/research/P1M2T1S4/DECORATOR_DOCUMENTATION_BEST_PRACTICES.md +0 -716
  426. package/plan/001_d3bb02af4886/docs/research/P1M2T1S4/DECORATOR_DOCUMENTATION_QUICK_REF.md +0 -186
  427. package/plan/001_d3bb02af4886/docs/research/P1M2T1S4/GROUNDSWELL_DECORATOR_EXAMPLES.md +0 -604
  428. package/plan/001_d3bb02af4886/docs/research/P1M2T1S4/INDEX.md +0 -213
  429. package/plan/001_d3bb02af4886/docs/research/P1M2T1S4/codebase_structure.md +0 -30
  430. package/plan/001_d3bb02af4886/docs/research/P1M2T1S4/existing_test_pattern.md +0 -56
  431. package/plan/001_d3bb02af4886/docs/research/P1M2T1S4/getRootObservers_implementation.md +0 -53
  432. package/plan/001_d3bb02af4886/docs/research/P1M2T1S4/test_conventions.md +0 -49
  433. package/plan/001_d3bb02af4886/docs/research/P1M3T1S4/PRP.md +0 -958
  434. package/plan/001_d3bb02af4886/docs/research/P1M3T1S4/QUICK_REFERENCE.md +0 -339
  435. package/plan/001_d3bb02af4886/docs/research/P1M3T1S4/README.md +0 -305
  436. package/plan/001_d3bb02af4886/docs/research/P1M3T1S4/SUMMARY.md +0 -433
  437. package/plan/001_d3bb02af4886/docs/research/P1M3T1S4/bidirectional-tree-consistency-testing.md +0 -1574
  438. package/plan/001_d3bb02af4886/docs/research/P1M3T1S4/test-pattern-examples.md +0 -1014
  439. package/plan/001_d3bb02af4886/docs/research/P1P2/LRU_CACHE_BEST_PRACTICES.md +0 -1929
  440. package/plan/001_d3bb02af4886/docs/research/P1P2/LRU_CACHE_CODE_PATTERNS.md +0 -857
  441. package/plan/001_d3bb02af4886/docs/research/P1P2/LRU_CACHE_INTEGRATION_GUIDE.md +0 -738
  442. package/plan/001_d3bb02af4886/docs/research/P1P2/LRU_CACHE_RESEARCH_INDEX.md +0 -424
  443. package/plan/001_d3bb02af4886/docs/research/P1P2/REFLECTION_INDEX.md +0 -291
  444. package/plan/001_d3bb02af4886/docs/research/P1P2/REFLECTION_RESEARCH_REPORT.md +0 -1342
  445. package/plan/001_d3bb02af4886/docs/research/P1P2/RESEARCH_SUMMARY.md +0 -342
  446. package/plan/001_d3bb02af4886/docs/research/P1P2/anthropic-sdk.md +0 -174
  447. package/plan/001_d3bb02af4886/docs/research/P1P2/async-local-storage.md +0 -200
  448. package/plan/001_d3bb02af4886/docs/research/P1P2/reflection-code-patterns.md +0 -1205
  449. package/plan/001_d3bb02af4886/docs/research/P1P2/reflection-decision-matrix.md +0 -421
  450. package/plan/001_d3bb02af4886/docs/research/P1P2/reflection-implementation-guide.md +0 -1341
  451. package/plan/001_d3bb02af4886/docs/research/P1P2/reflection-integration-guide.md +0 -834
  452. package/plan/001_d3bb02af4886/docs/research/P1P2/reflection-patterns.md +0 -1468
  453. package/plan/001_d3bb02af4886/docs/research/P1P2/reflection-quick-reference.md +0 -558
  454. package/plan/001_d3bb02af4886/docs/research/P1P2/zod-schema.md +0 -152
  455. package/plan/001_d3bb02af4886/docs/research/P3P4/caching-lru.md +0 -116
  456. package/plan/001_d3bb02af4886/docs/research/P3P4/introspection-tools.md +0 -177
  457. package/plan/001_d3bb02af4886/docs/research/P3P4/reflection-patterns.md +0 -117
  458. package/plan/001_d3bb02af4886/docs/research/P4P5/RESEARCH_SUMMARY.md +0 -151
  459. package/plan/001_d3bb02af4886/docs/research/PROMISE_ALLSETTLED_QUICK_REF.md +0 -376
  460. package/plan/001_d3bb02af4886/docs/research/PROMISE_ALLSETTLED_RESEARCH.md +0 -1507
  461. package/plan/001_d3bb02af4886/docs/research/bugfix_typescript_patterns.md +0 -949
  462. package/plan/001_d3bb02af4886/docs/research/error-testing-research.md +0 -619
  463. package/plan/001_d3bb02af4886/docs/research/error_handling_patterns.md +0 -723
  464. package/plan/001_d3bb02af4886/docs/research/general/INTROSPECTION_RESEARCH_SUMMARY.md +0 -378
  465. package/plan/001_d3bb02af4886/docs/research/general/README-INTROSPECTION.md +0 -352
  466. package/plan/001_d3bb02af4886/docs/research/general/agent-introspection-patterns.md +0 -1085
  467. package/plan/001_d3bb02af4886/docs/research/general/introspection-security-guide.md +0 -984
  468. package/plan/001_d3bb02af4886/docs/research/general/introspection-tool-examples.md +0 -875
  469. package/plan/001_d3bb02af4886/docs/research/incremental-tree-map-updates/PRP_TEMPLATE.md +0 -460
  470. package/plan/001_d3bb02af4886/docs/research/incremental-tree-map-updates/QUICK_REFERENCE.md +0 -324
  471. package/plan/001_d3bb02af4886/docs/research/incremental-tree-map-updates/README.md +0 -175
  472. package/plan/001_d3bb02af4886/docs/research/incremental-tree-map-updates/RESEARCH_REPORT.md +0 -499
  473. package/plan/001_d3bb02af4886/docs/research/incremental-tree-map-updates/SUMMARY.md +0 -163
  474. package/plan/001_d3bb02af4886/prd_snapshot.md +0 -543
  475. package/plan/bugfix/BUG_FIX_SUMMARY.md +0 -961
  476. package/scripts/generate-llms-full.ts +0 -206
  477. package/src/__tests__/adversarial/attachChild-performance.test.ts +0 -216
  478. package/src/__tests__/adversarial/circular-reference.test.ts +0 -101
  479. package/src/__tests__/adversarial/complex-circular-reference.test.ts +0 -139
  480. package/src/__tests__/adversarial/concurrent-task-failures.test.ts +0 -571
  481. package/src/__tests__/adversarial/deep-analysis.test.ts +0 -729
  482. package/src/__tests__/adversarial/deep-hierarchy-stress.test.ts +0 -213
  483. package/src/__tests__/adversarial/e2e-prd-validation.test.ts +0 -448
  484. package/src/__tests__/adversarial/edge-case.test.ts +0 -703
  485. package/src/__tests__/adversarial/error-merge-strategy.test.ts +0 -760
  486. package/src/__tests__/adversarial/incremental-performance.test.ts +0 -140
  487. package/src/__tests__/adversarial/node-map-update-benchmarks.test.ts +0 -457
  488. package/src/__tests__/adversarial/observer-propagation.test.ts +0 -487
  489. package/src/__tests__/adversarial/parent-validation.test.ts +0 -143
  490. package/src/__tests__/adversarial/prd-12-2-compliance.test.ts +0 -611
  491. package/src/__tests__/adversarial/prd-compliance.test.ts +0 -731
  492. package/src/__tests__/compatibility/backward-compatibility.test.ts +0 -1572
  493. package/src/__tests__/helpers/index.ts +0 -18
  494. package/src/__tests__/helpers/tree-verification.ts +0 -257
  495. package/src/__tests__/integration/agent-workflow.test.ts +0 -256
  496. package/src/__tests__/integration/bidirectional-consistency.test.ts +0 -847
  497. package/src/__tests__/integration/observer-logging.test.ts +0 -643
  498. package/src/__tests__/integration/tree-mirroring.test.ts +0 -151
  499. package/src/__tests__/integration/workflow-reparenting.test.ts +0 -303
  500. package/src/__tests__/unit/agent.test.ts +0 -169
  501. package/src/__tests__/unit/cache-key.test.ts +0 -182
  502. package/src/__tests__/unit/cache.test.ts +0 -172
  503. package/src/__tests__/unit/context.test.ts +0 -217
  504. package/src/__tests__/unit/decorators.test.ts +0 -100
  505. package/src/__tests__/unit/introspection-tools.test.ts +0 -277
  506. package/src/__tests__/unit/logger.test.ts +0 -293
  507. package/src/__tests__/unit/observable.test.ts +0 -321
  508. package/src/__tests__/unit/prompt.test.ts +0 -135
  509. package/src/__tests__/unit/reflection.test.ts +0 -210
  510. package/src/__tests__/unit/tree-debugger-incremental.test.ts +0 -170
  511. package/src/__tests__/unit/tree-debugger.test.ts +0 -85
  512. package/src/__tests__/unit/utils/workflow-error-utils.test.ts +0 -209
  513. package/src/__tests__/unit/workflow-detachChild.test.ts +0 -100
  514. package/src/__tests__/unit/workflow-emitEvent-childDetached.test.ts +0 -153
  515. package/src/__tests__/unit/workflow-isDescendantOf.test.ts +0 -180
  516. package/src/__tests__/unit/workflow.test.ts +0 -357
  517. package/src/cache/cache-key.ts +0 -244
  518. package/src/cache/cache.ts +0 -236
  519. package/src/core/agent.ts +0 -593
  520. package/src/core/event-tree.ts +0 -260
  521. package/src/core/logger.ts +0 -112
  522. package/src/core/mcp-handler.ts +0 -184
  523. package/src/core/prompt.ts +0 -150
  524. package/src/core/workflow-context.ts +0 -351
  525. package/src/core/workflow.ts +0 -540
  526. package/src/debugger/tree-debugger.ts +0 -255
  527. package/src/decorators/observed-state.ts +0 -95
  528. package/src/decorators/step.ts +0 -139
  529. package/src/decorators/task.ts +0 -159
  530. package/src/examples/tdd-orchestrator.ts +0 -65
  531. package/src/examples/test-cycle-workflow.ts +0 -64
  532. package/src/index.ts +0 -142
  533. package/src/reflection/reflection.ts +0 -407
  534. package/src/tools/index.ts +0 -36
  535. package/src/tools/introspection.ts +0 -464
  536. package/src/types/agent.ts +0 -90
  537. package/src/types/decorators.ts +0 -32
  538. package/src/types/error-strategy.ts +0 -13
  539. package/src/types/error.ts +0 -20
  540. package/src/types/events.ts +0 -75
  541. package/src/types/index.ts +0 -55
  542. package/src/types/logging.ts +0 -24
  543. package/src/types/observer.ts +0 -18
  544. package/src/types/prompt.ts +0 -40
  545. package/src/types/reflection.ts +0 -117
  546. package/src/types/sdk-primitives.ts +0 -128
  547. package/src/types/workflow-context.ts +0 -163
  548. package/src/types/workflow.ts +0 -37
  549. package/src/utils/id.ts +0 -11
  550. package/src/utils/index.ts +0 -4
  551. package/src/utils/observable.ts +0 -106
  552. package/src/utils/workflow-error-utils.ts +0 -56
  553. package/tsconfig.json +0 -22
  554. package/vitest.config.ts +0 -16
@@ -1,487 +0,0 @@
1
- /**
2
- * PRD Section 7: Observer Propagation Compliance Test
3
- *
4
- * Validates that observer propagation works correctly per PRD Section 7 requirements:
5
- * - Events from deeply nested children bubble up to root observers via getRoot()
6
- * - After reparenting, events propagate to new root's observer (not old root's)
7
- * - getRoot() correctly follows parent chain with cycle detection
8
- * - All observer callbacks (onEvent, onTreeChanged) are invoked
9
- *
10
- * Bug Context: The tree integrity bug (child in multiple parents) broke observer
11
- * propagation because getRoot() only followed child.parent chain. This test validates
12
- * the fix ensures events route to correct observers.
13
- *
14
- * References:
15
- * - Bug Analysis: plan/docs/bugfix-architecture/bug_analysis.md (lines 60-91)
16
- * - getRoot() implementation: src/core/workflow.ts (lines 174-189)
17
- * - getRootObservers() implementation: src/core/workflow.ts (lines 124-139)
18
- * - emitEvent() implementation: src/core/workflow.ts (lines 313-329)
19
- */
20
-
21
- import { describe, it, expect } from 'vitest';
22
- import {
23
- Workflow,
24
- WorkflowObserver,
25
- WorkflowEvent,
26
- } from '../../index.js';
27
-
28
- /**
29
- * SimpleWorkflow class for testing
30
- * Pattern from: src/__tests__/integration/workflow-reparenting.test.ts
31
- */
32
- class SimpleWorkflow extends Workflow {
33
- async run(): Promise<string> {
34
- this.setStatus('running');
35
- this.setStatus('completed');
36
- return 'done';
37
- }
38
- }
39
-
40
- /**
41
- * Observer creation helper
42
- * Pattern from: src/__tests__/integration/workflow-reparenting.test.ts:142-147
43
- */
44
- const createObserver = (eventsArray: WorkflowEvent[]): WorkflowObserver => ({
45
- onLog: () => {}, // Empty - not testing logs in this test suite
46
- onEvent: (e) => eventsArray.push(e), // Capture events for validation
47
- onStateUpdated: () => {}, // Empty - not testing state updates
48
- onTreeChanged: () => {}, // Empty - not testing tree changes
49
- });
50
-
51
- describe('PRD Section 7: Observer Propagation', () => {
52
- describe('Event Bubbling: Grandchild to Root Observer', () => {
53
- it('should propagate events from grandchild to root observer via getRoot()', () => {
54
- // ============================================================
55
- // PHASE 1: Setup - Create 3-level tree
56
- // ============================================================
57
- // ARRANGE: Create root, child, grandchild hierarchy
58
- const root = new SimpleWorkflow('Root');
59
- const child = new SimpleWorkflow('Child', root);
60
- const grandchild = new SimpleWorkflow('Grandchild', child);
61
-
62
- // ============================================================
63
- // PHASE 2: Add observer to root
64
- // ============================================================
65
- // ARRANGE: Create event capture array and observer
66
- const rootEvents: WorkflowEvent[] = [];
67
- root.addObserver(createObserver(rootEvents));
68
-
69
- // ============================================================
70
- // PHASE 3: Emit event from grandchild
71
- // ============================================================
72
- // ACT: Clear any construction events, then emit from grandchild
73
- // PRD Section 7: "Observers attach to root workflow and receive all events"
74
- rootEvents.length = 0; // Clear any construction events
75
- grandchild.setStatus('running');
76
-
77
- // ============================================================
78
- // PHASE 4: Verify root observer received event
79
- // ============================================================
80
- // ASSERT: Root observer should receive event via getRoot() traversal
81
- // getRoot() from grandchild returns root, then root.observers receive event
82
- const receivedEvent = rootEvents.find((e) => e.type === 'treeUpdated');
83
- expect(receivedEvent).toBeDefined();
84
-
85
- // Type guard for discriminated union
86
- if (receivedEvent?.type === 'treeUpdated') {
87
- expect(receivedEvent.root.id).toBe(root.id);
88
- }
89
- });
90
-
91
- it('should propagate events through multiple hierarchy levels', () => {
92
- // ============================================================
93
- // Test deeper hierarchy (4+ levels) to verify getRoot() traversal
94
- // ============================================================
95
- // ARRANGE: Create 5-level deep hierarchy
96
- const root = new SimpleWorkflow('Root');
97
- const level1 = new SimpleWorkflow('L1', root);
98
- const level2 = new SimpleWorkflow('L2', level1);
99
- const level3 = new SimpleWorkflow('L3', level2);
100
- const level4 = new SimpleWorkflow('L4', level3);
101
-
102
- const rootEvents: WorkflowEvent[] = [];
103
- root.addObserver(createObserver(rootEvents));
104
-
105
- // ACT: Emit event from deepest level
106
- rootEvents.length = 0;
107
- level4.setStatus('running');
108
-
109
- // ASSERT: Verify event bubbled through 4 levels to root
110
- // This validates getRoot() correctly traverses: level4 -> level3 -> level2 -> level1 -> root
111
- expect(rootEvents.some((e) => e.type === 'treeUpdated')).toBe(true);
112
-
113
- // Verify the event root is the original root workflow
114
- const treeUpdatedEvent = rootEvents.find((e) => e.type === 'treeUpdated');
115
- if (treeUpdatedEvent?.type === 'treeUpdated') {
116
- expect(treeUpdatedEvent.root.id).toBe(root.id);
117
- }
118
- });
119
- });
120
-
121
- describe('Observer Routing After Reparenting', () => {
122
- it('should route events to new root observer after reparenting', () => {
123
- // ============================================================
124
- // PHASE 1: Setup - Create parent1, parent2, grandchild with parent1
125
- // ============================================================
126
- // ARRANGE: Create initial tree structure
127
- const parent1 = new SimpleWorkflow('Parent1');
128
- const child1 = new SimpleWorkflow('Child1', parent1);
129
- const grandchild = new SimpleWorkflow('Grandchild', child1);
130
- const parent2 = new SimpleWorkflow('Parent2');
131
-
132
- // ============================================================
133
- // PHASE 2: Verify initial propagation to parent1 observer
134
- // ============================================================
135
- // ARRANGE: Create observer for parent1
136
- const parent1Events: WorkflowEvent[] = [];
137
- parent1.addObserver(createObserver(parent1Events));
138
-
139
- // ACT: Emit event from grandchild
140
- parent1Events.length = 0;
141
- grandchild.setStatus('running');
142
-
143
- // ASSERT: parent1 observer receives event (initial state)
144
- expect(parent1Events.some((e) => e.type === 'treeUpdated')).toBe(true);
145
-
146
- // ============================================================
147
- // PHASE 3: Reparent grandchild to different tree
148
- // ============================================================
149
- // ACT: First detach from child1, then attach to child2
150
- // Pattern: detachChild() -> attachChild() for proper reparenting
151
- const child2 = new SimpleWorkflow('Child2', parent2);
152
- child1.detachChild(grandchild);
153
- child2.attachChild(grandchild);
154
-
155
- // ============================================================
156
- // PHASE 4: Add observer to new root (parent2)
157
- // ============================================================
158
- // ARRANGE: Create observer for parent2
159
- const parent2Events: WorkflowEvent[] = [];
160
- parent2.addObserver(createObserver(parent2Events));
161
-
162
- // ============================================================
163
- // PHASE 5: Emit event from grandchild
164
- // ============================================================
165
- // ACT: Clear events to isolate post-reparenting behavior
166
- parent1Events.length = 0;
167
- parent2Events.length = 0;
168
- grandchild.setStatus('completed');
169
-
170
- // ============================================================
171
- // PHASE 6: Verify new root observer receives event
172
- // ============================================================
173
- // ASSERT: parent2 observer receives event (after reparenting)
174
- expect(parent2Events.some((e) => e.type === 'treeUpdated')).toBe(true);
175
- });
176
-
177
- it('should not route events to old root observer after reparenting', () => {
178
- // ============================================================
179
- // CRITICAL VALIDATION: This test validates the bug fix
180
- // ============================================================
181
- // Bug analysis (bug_analysis.md:60-91) showed:
182
- // - child.parent stayed pointing to old parent
183
- // - getRoot() returned wrong root
184
- // - Old parent's observers still received events after reparenting
185
- //
186
- // This test ensures that after the fix:
187
- // - child.parent is updated to new parent
188
- // - getRoot() returns correct root
189
- // - Old parent's observers do NOT receive events
190
-
191
- // ARRANGE: Create two separate trees with observers
192
- const parent1 = new SimpleWorkflow('Parent1');
193
- const child1 = new SimpleWorkflow('Child1', parent1);
194
- const grandchild = new SimpleWorkflow('Grandchild', child1);
195
- const parent2 = new SimpleWorkflow('Parent2');
196
- const child2 = new SimpleWorkflow('Child2', parent2);
197
-
198
- const parent1Events: WorkflowEvent[] = [];
199
- const parent2Events: WorkflowEvent[] = [];
200
-
201
- parent1.addObserver(createObserver(parent1Events));
202
- parent2.addObserver(createObserver(parent2Events));
203
-
204
- // ACT: Reparent grandchild from parent1 tree to parent2 tree
205
- // Pattern: detach from old parent, then attach to new parent
206
- child1.detachChild(grandchild);
207
- child2.attachChild(grandchild);
208
-
209
- // Clear events to isolate post-reparenting behavior
210
- parent1Events.length = 0;
211
- parent2Events.length = 0;
212
-
213
- // Emit event from grandchild
214
- grandchild.setStatus('running');
215
-
216
- // ASSERT: CRITICAL - Old root's observer must NOT receive event
217
- // This was the bug - old parent's observers still received events
218
- expect(parent1Events.some((e) => e.type === 'treeUpdated')).toBe(false);
219
- expect(parent1Events.length).toBe(0);
220
-
221
- // ASSERT: New root's observer MUST receive event
222
- expect(parent2Events.some((e) => e.type === 'treeUpdated')).toBe(true);
223
- });
224
- });
225
-
226
- describe('getRoot() Traversal Correctness', () => {
227
- it('should find root workflow via parent chain traversal', () => {
228
- // ============================================================
229
- // Verify getRoot() from grandchild returns root
230
- // ============================================================
231
- // This is called internally by getRootObservers()
232
- // ARRANGE: Create 3-level tree
233
- const root = new SimpleWorkflow('Root');
234
- const child = new SimpleWorkflow('Child', root);
235
- const grandchild = new SimpleWorkflow('Grandchild', child);
236
-
237
- // ACT: Call getRoot() on grandchild (protected method, access via cast)
238
- const foundRoot = (grandchild as any).getRoot();
239
-
240
- // ASSERT: getRoot() should return root workflow
241
- expect(foundRoot).toBe(root);
242
- expect(foundRoot).not.toBe(child);
243
- expect(foundRoot).not.toBe(grandchild);
244
- });
245
-
246
- it('should find root through deep parent chain', () => {
247
- // ============================================================
248
- // Verify getRoot() works correctly with deep hierarchies
249
- // ============================================================
250
- // ARRANGE: Create 10-level deep hierarchy
251
- const root = new SimpleWorkflow('Root');
252
- let current = root;
253
-
254
- for (let i = 0; i < 10; i++) {
255
- const nextChild = new SimpleWorkflow(`Level${i}`);
256
- current.attachChild(nextChild);
257
- current = nextChild;
258
- }
259
-
260
- // ACT: Call getRoot() on deepest child
261
- const foundRoot = (current as any).getRoot();
262
-
263
- // ASSERT: Deepest child's getRoot() returns original root
264
- expect(foundRoot).toBe(root);
265
- });
266
-
267
- it('should maintain correct root after multiple reparenting cycles', () => {
268
- // ============================================================
269
- // Test reparenting: A->B->C => X->Y->C => A->Z->C
270
- // ============================================================
271
- // ARRANGE: Create initial tree A->B->C
272
- const parentA = new SimpleWorkflow('ParentA');
273
- const parentB = new SimpleWorkflow('ParentB', parentA);
274
- const childC = new SimpleWorkflow('ChildC', parentB);
275
-
276
- // ASSERT: Initial - C's root should be A
277
- expect((childC as any).getRoot()).toBe(parentA);
278
-
279
- // ACT: Reparent to X->Y->C
280
- const parentX = new SimpleWorkflow('ParentX');
281
- const parentY = new SimpleWorkflow('ParentY', parentX);
282
- parentB.detachChild(childC);
283
- parentY.attachChild(childC);
284
-
285
- // ASSERT: After first reparenting, C's root should be X
286
- expect((childC as any).getRoot()).toBe(parentX);
287
-
288
- // ACT: Reparent again to A->Z->C
289
- const parentZ = new SimpleWorkflow('ParentZ', parentA);
290
- parentY.detachChild(childC);
291
- parentZ.attachChild(childC);
292
-
293
- // ASSERT: After second reparenting, C's root should be A again
294
- expect((childC as any).getRoot()).toBe(parentA);
295
- });
296
- });
297
-
298
- describe('Observer Callback Invocation', () => {
299
- it('should invoke onEvent() for all event types from children', () => {
300
- // ============================================================
301
- // Verify onEvent() callback is invoked
302
- // ============================================================
303
- // ARRANGE: Create 2-level tree with tracking observer
304
- const root = new SimpleWorkflow('Root');
305
- const child = new SimpleWorkflow('Child', root);
306
-
307
- let onEventCallCount = 0;
308
- let receivedEventType: string | undefined;
309
-
310
- const trackingObserver: WorkflowObserver = {
311
- onLog: () => {},
312
- onEvent: (e) => {
313
- onEventCallCount++;
314
- receivedEventType = e.type;
315
- },
316
- onStateUpdated: () => {},
317
- onTreeChanged: () => {},
318
- };
319
-
320
- root.addObserver(trackingObserver);
321
-
322
- // ACT: Emit event from child
323
- child.setStatus('running');
324
-
325
- // ASSERT: Verify onEvent was called
326
- expect(onEventCallCount).toBeGreaterThan(0);
327
- expect(receivedEventType).toBeDefined();
328
- });
329
-
330
- it('should invoke onTreeChanged() for tree update events', () => {
331
- // ============================================================
332
- // Verify onTreeChanged() callback is invoked
333
- // ============================================================
334
- // ARRANGE: Create 2-level tree with tracking observer
335
- const root = new SimpleWorkflow('Root');
336
- const child = new SimpleWorkflow('Child', root);
337
-
338
- let onTreeChangedCallCount = 0;
339
- let receivedRoot: any;
340
-
341
- const trackingObserver: WorkflowObserver = {
342
- onLog: () => {},
343
- onEvent: () => {},
344
- onStateUpdated: () => {},
345
- onTreeChanged: (rootNode) => {
346
- onTreeChangedCallCount++;
347
- receivedRoot = rootNode;
348
- },
349
- };
350
-
351
- root.addObserver(trackingObserver);
352
-
353
- // ACT: Emit tree update event (triggers both onEvent and onTreeChanged)
354
- // Note: setStatus() emits treeUpdated event which triggers onTreeChanged()
355
- child.setStatus('running');
356
-
357
- // ASSERT: Verify onTreeChanged was called with correct root
358
- expect(onTreeChangedCallCount).toBeGreaterThan(0);
359
- expect(receivedRoot).toBeDefined();
360
- expect(receivedRoot.id).toBe(root.id);
361
- });
362
-
363
- it('should invoke callbacks in correct order', () => {
364
- // ============================================================
365
- // Verify callback order: onEvent before onTreeChanged
366
- // ============================================================
367
- // ARRANGE: Create 2-level tree with order-tracking observer
368
- const root = new SimpleWorkflow('Root');
369
- const child = new SimpleWorkflow('Child', root);
370
-
371
- const callOrder: string[] = [];
372
-
373
- const orderTrackingObserver: WorkflowObserver = {
374
- onLog: () => callOrder.push('onLog'),
375
- onEvent: () => callOrder.push('onEvent'),
376
- onStateUpdated: () => callOrder.push('onStateUpdated'),
377
- onTreeChanged: () => callOrder.push('onTreeChanged'),
378
- };
379
-
380
- root.addObserver(orderTrackingObserver);
381
-
382
- // ACT: Emit tree update event
383
- callOrder.length = 0;
384
- child.setStatus('running');
385
-
386
- // ASSERT: Verify callback order
387
- // emitEvent() calls onEvent() first, then onTreeChanged()
388
- // See workflow.ts:318-324
389
- const eventIndex = callOrder.indexOf('onEvent');
390
- const treeChangedIndex = callOrder.indexOf('onTreeChanged');
391
-
392
- expect(eventIndex).toBeGreaterThanOrEqual(0);
393
- expect(treeChangedIndex).toBeGreaterThanOrEqual(0);
394
- expect(eventIndex).toBeLessThan(treeChangedIndex);
395
- });
396
- });
397
-
398
- describe('Edge Cases: Cycle Detection', () => {
399
- it('should still propagate events after cycle detection validation', () => {
400
- // ============================================================
401
- // Verify that cycle detection in getRoot() doesn't break normal propagation
402
- // ============================================================
403
- // getRoot() uses visited Set for cycle detection (workflow.ts:175-188)
404
- // This test ensures normal operation is not affected
405
-
406
- // ARRANGE: Create 3-level tree with no cycles
407
- const root = new SimpleWorkflow('Root');
408
- const child = new SimpleWorkflow('Child', root);
409
- const grandchild = new SimpleWorkflow('Grandchild', child);
410
-
411
- const rootEvents: WorkflowEvent[] = [];
412
- root.addObserver(createObserver(rootEvents));
413
-
414
- // ACT: Emit event from grandchild
415
- // This should work normally (no cycle exists)
416
- grandchild.setStatus('running');
417
-
418
- // ASSERT: Verify propagation still works
419
- expect(rootEvents.some((e) => e.type === 'treeUpdated')).toBe(true);
420
-
421
- // Verify getRoot() didn't throw cycle detection error
422
- const foundRoot = (grandchild as any).getRoot();
423
- expect(foundRoot).toBe(root);
424
- });
425
- });
426
-
427
- describe('Multiple Reparenting Cycles', () => {
428
- it('should handle multiple reparenting cycles correctly', () => {
429
- // ============================================================
430
- // Test: A->B->C => X->Y->C => A->Z->C => P->Q->C
431
- // ============================================================
432
- // ARRANGE: Create three potential parents
433
- const parentA = new SimpleWorkflow('ParentA');
434
- const parentB = new SimpleWorkflow('ParentB', parentA);
435
- const childC = new SimpleWorkflow('ChildC', parentB);
436
-
437
- const parentX = new SimpleWorkflow('ParentX');
438
- const parentY = new SimpleWorkflow('ParentY', parentX);
439
-
440
- const parentP = new SimpleWorkflow('ParentP');
441
- const parentQ = new SimpleWorkflow('ParentQ', parentP);
442
-
443
- const eventsA: WorkflowEvent[] = [];
444
- const eventsX: WorkflowEvent[] = [];
445
- const eventsP: WorkflowEvent[] = [];
446
-
447
- const createObserverWithTracking = (eventsArray: WorkflowEvent[]): WorkflowObserver => ({
448
- onLog: () => {},
449
- onEvent: (e) => eventsArray.push(e),
450
- onStateUpdated: () => {},
451
- onTreeChanged: () => {},
452
- });
453
-
454
- parentA.addObserver(createObserverWithTracking(eventsA));
455
- parentX.addObserver(createObserverWithTracking(eventsX));
456
- parentP.addObserver(createObserverWithTracking(eventsP));
457
-
458
- // ACT & ASSERT: Cycle 1 - Verify initial state A->B->C
459
- eventsA.length = 0;
460
- childC.setStatus('running');
461
- expect(eventsA.some((e) => e.type === 'treeUpdated')).toBe(true);
462
-
463
- // ACT & ASSERT: Cycle 2 - Reparent to X->Y->C
464
- parentB.detachChild(childC);
465
- parentY.attachChild(childC);
466
-
467
- eventsA.length = 0;
468
- eventsX.length = 0;
469
- childC.setStatus('completed');
470
- expect(eventsX.some((e) => e.type === 'treeUpdated')).toBe(true);
471
- expect(eventsA.some((e) => e.type === 'treeUpdated')).toBe(false);
472
-
473
- // ACT & ASSERT: Cycle 3 - Reparent to P->Q->C
474
- parentY.detachChild(childC);
475
- parentQ.attachChild(childC);
476
-
477
- eventsX.length = 0;
478
- eventsP.length = 0;
479
- childC.setStatus('running');
480
- expect(eventsP.some((e) => e.type === 'treeUpdated')).toBe(true);
481
- expect(eventsX.some((e) => e.type === 'treeUpdated')).toBe(false);
482
-
483
- // Final: Verify getRoot() returns correct root
484
- expect((childC as any).getRoot()).toBe(parentP);
485
- });
486
- });
487
- });
@@ -1,143 +0,0 @@
1
- /**
2
- * Parent Validation Tests (TDD Red Phase)
3
- *
4
- * These tests validate the attachChild() method properly prevents
5
- * attaching a child workflow that already has a different parent.
6
- *
7
- * This is the RED phase of TDD - tests are written to FAIL initially,
8
- * documenting the expected behavior before implementation.
9
- *
10
- * Related: plan/docs/bugfix-architecture/bug_analysis.md
11
- */
12
-
13
- import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
14
- import { Workflow } from '../../index.js';
15
-
16
- /**
17
- * SimpleWorkflow class for testing
18
- * Pattern from: src/__tests__/unit/workflow.test.ts:4-11
19
- */
20
- class SimpleWorkflow extends Workflow {
21
- async run(): Promise<string> {
22
- this.setStatus('running');
23
- this.setStatus('completed');
24
- return 'done';
25
- }
26
- }
27
-
28
- describe('Adversarial: Parent Validation', () => {
29
- /**
30
- * Setup: Mock console methods to capture error messages
31
- * Pattern from: research/console-mocking.md "Basic Spying Patterns"
32
- */
33
- beforeEach(() => {
34
- vi.spyOn(console, 'log').mockImplementation(() => {});
35
- vi.spyOn(console, 'error').mockImplementation(() => {});
36
- vi.spyOn(console, 'warn').mockImplementation(() => {});
37
- });
38
-
39
- /**
40
- * Teardown: Restore all mocks to prevent test pollution
41
- * CRITICAL: Always use vi.restoreAllMocks() in afterEach
42
- */
43
- afterEach(() => {
44
- vi.restoreAllMocks();
45
- });
46
-
47
- /**
48
- * Primary failing test for parent validation bug
49
- *
50
- * Bug: attachChild() only checks if child is already attached to THIS workflow
51
- * It does NOT check if child already has a different parent
52
- *
53
- * Expected: Error thrown with message containing 'already has a parent'
54
- * Actual: No error thrown, inconsistent tree state created
55
- *
56
- * Pattern from: research/error-assertions.md "Partial Message Matching"
57
- */
58
- it('should throw when attaching child that already has a different parent', () => {
59
- // ARRANGE: Create two parent workflows
60
- const parent1 = new SimpleWorkflow('Parent1');
61
- const parent2 = new SimpleWorkflow('Parent2');
62
-
63
- // ARRANGE: Create child with parent1 (constructor auto-attaches)
64
- // CRITICAL: Constructor calls parent.attachChild(this) at workflow.ts:113-116
65
- const child = new SimpleWorkflow('Child', parent1);
66
-
67
- // Verify initial state
68
- expect(child.parent).toBe(parent1);
69
- expect(parent1.children).toContain(child);
70
-
71
- // ACT & ASSERT: Attempting to attach child to parent2 should throw
72
- // This test FAILS because attachChild() doesn't check child.parent !== this
73
- expect(() => parent2.attachChild(child)).toThrow('already has a parent');
74
- });
75
-
76
- /**
77
- * Test: Manual Parent Mutation with 'as any'
78
- *
79
- * Scenario: Even if someone manually mutates child.parent using 'as any',
80
- * attachChild() should still validate and throw an error.
81
- *
82
- * This tests the defensive programming aspect - that the existing validation
83
- * checks catch inconsistent state even when TypeScript type safety is bypassed.
84
- *
85
- * The attachChild() method has two validation checks (in order):
86
- * 1. Line 217-219: children.includes(child) check
87
- * 2. Line 222-228: child.parent !== null && child.parent !== this check
88
- *
89
- * When we manually mutate (child as any).parent = parent2, the child is
90
- * still in parent1.children, so the first check throws first.
91
- *
92
- * Pattern from: plan/bugfix/P1M3T1S2/PRP.md "Manual Parent Mutation Test"
93
- */
94
- it('should throw when manually mutating parent with as any then calling attachChild', () => {
95
- // ARRANGE: Create two parent workflows
96
- const parent1 = new SimpleWorkflow('Parent1');
97
- const parent2 = new SimpleWorkflow('Parent2');
98
-
99
- // ARRANGE: Create child with parent1 (constructor auto-attaches)
100
- // CRITICAL: Constructor calls parent.attachChild(this) at workflow.ts:113-116
101
- const child = new SimpleWorkflow('Child', parent1);
102
-
103
- // Verify initial state - child should be attached to parent1
104
- expect(child.parent).toBe(parent1);
105
- expect(parent1.children).toContain(child);
106
-
107
- // ARRANGE: Manually mutate child.parent using 'as any' to bypass TypeScript
108
- // This simulates a developer bypassing the type system
109
- (child as any).parent = parent2;
110
-
111
- // Verify manual mutation worked
112
- expect(child.parent).toBe(parent2); // Now points to parent2
113
- expect(parent1.children).toContain(child); // But still in parent1's children array!
114
-
115
- // ACT & ASSERT: parent1.attachChild(child) should throw
116
- // The validation at workflow.ts:217-219 checks children.includes(child) first
117
- // Since child is still in parent1.children, it throws "Child already attached"
118
- // This is defensive programming - even manual mutation is caught
119
- expect(() => parent1.attachChild(child)).toThrow('Child already attached to this workflow');
120
- });
121
-
122
- /**
123
- * Verify console.error is called with helpful message
124
- *
125
- * Pattern from: research/console-mocking.md "Verifying Error Messages"
126
- */
127
- it('should log helpful error message to console when attaching child with existing parent', () => {
128
- // ARRANGE
129
- const parent1 = new SimpleWorkflow('Parent1');
130
- const parent2 = new SimpleWorkflow('Parent2');
131
- const child = new SimpleWorkflow('Child', parent1);
132
-
133
- // ACT: Attempt the invalid attachment
134
- try {
135
- parent2.attachChild(child);
136
- } catch (err) {
137
- // Expected error - test will fail because error isn't thrown yet
138
- }
139
-
140
- // ASSERT: Console.error should be called with helpful message
141
- expect(console.error).toHaveBeenCalled();
142
- });
143
- });