groundswell 0.0.2 → 0.0.3

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 (633) hide show
  1. package/dist/__tests__/adversarial/attachChild-performance.test.d.ts +16 -0
  2. package/dist/__tests__/adversarial/attachChild-performance.test.d.ts.map +1 -0
  3. package/dist/__tests__/adversarial/attachChild-performance.test.js +187 -0
  4. package/dist/__tests__/adversarial/attachChild-performance.test.js.map +1 -0
  5. package/dist/__tests__/adversarial/circular-reference.test.d.ts +13 -0
  6. package/dist/__tests__/adversarial/circular-reference.test.d.ts.map +1 -0
  7. package/dist/__tests__/adversarial/circular-reference.test.js +92 -0
  8. package/dist/__tests__/adversarial/circular-reference.test.js.map +1 -0
  9. package/dist/__tests__/adversarial/complex-circular-reference.test.d.ts +16 -0
  10. package/dist/__tests__/adversarial/complex-circular-reference.test.d.ts.map +1 -0
  11. package/dist/__tests__/adversarial/complex-circular-reference.test.js +127 -0
  12. package/dist/__tests__/adversarial/complex-circular-reference.test.js.map +1 -0
  13. package/dist/__tests__/adversarial/concurrent-task-failures.test.d.ts +21 -0
  14. package/dist/__tests__/adversarial/concurrent-task-failures.test.d.ts.map +1 -0
  15. package/dist/__tests__/adversarial/concurrent-task-failures.test.js +667 -0
  16. package/dist/__tests__/adversarial/concurrent-task-failures.test.js.map +1 -0
  17. package/dist/__tests__/adversarial/deep-analysis.test.d.ts +6 -0
  18. package/dist/__tests__/adversarial/deep-analysis.test.d.ts.map +1 -0
  19. package/dist/__tests__/adversarial/deep-analysis.test.js +877 -0
  20. package/dist/__tests__/adversarial/deep-analysis.test.js.map +1 -0
  21. package/dist/__tests__/adversarial/deep-hierarchy-stress.test.d.ts +13 -0
  22. package/dist/__tests__/adversarial/deep-hierarchy-stress.test.d.ts.map +1 -0
  23. package/dist/__tests__/adversarial/deep-hierarchy-stress.test.js +186 -0
  24. package/dist/__tests__/adversarial/deep-hierarchy-stress.test.js.map +1 -0
  25. package/dist/__tests__/adversarial/e2e-prd-validation.test.d.ts +6 -0
  26. package/dist/__tests__/adversarial/e2e-prd-validation.test.d.ts.map +1 -0
  27. package/dist/__tests__/adversarial/e2e-prd-validation.test.js +626 -0
  28. package/dist/__tests__/adversarial/e2e-prd-validation.test.js.map +1 -0
  29. package/dist/__tests__/adversarial/edge-case.test.d.ts +6 -0
  30. package/dist/__tests__/adversarial/edge-case.test.d.ts.map +1 -0
  31. package/dist/__tests__/adversarial/edge-case.test.js +857 -0
  32. package/dist/__tests__/adversarial/edge-case.test.js.map +1 -0
  33. package/dist/__tests__/adversarial/error-merge-strategy.test.d.ts +20 -0
  34. package/dist/__tests__/adversarial/error-merge-strategy.test.d.ts.map +1 -0
  35. package/dist/__tests__/adversarial/error-merge-strategy.test.js +907 -0
  36. package/dist/__tests__/adversarial/error-merge-strategy.test.js.map +1 -0
  37. package/dist/__tests__/adversarial/incremental-performance.test.d.ts +2 -0
  38. package/dist/__tests__/adversarial/incremental-performance.test.d.ts.map +1 -0
  39. package/dist/__tests__/adversarial/incremental-performance.test.js +113 -0
  40. package/dist/__tests__/adversarial/incremental-performance.test.js.map +1 -0
  41. package/dist/__tests__/adversarial/node-map-update-benchmarks.test.d.ts +22 -0
  42. package/dist/__tests__/adversarial/node-map-update-benchmarks.test.d.ts.map +1 -0
  43. package/dist/__tests__/adversarial/node-map-update-benchmarks.test.js +383 -0
  44. package/dist/__tests__/adversarial/node-map-update-benchmarks.test.js.map +1 -0
  45. package/dist/__tests__/adversarial/observer-propagation.test.d.ts +21 -0
  46. package/dist/__tests__/adversarial/observer-propagation.test.d.ts.map +1 -0
  47. package/dist/__tests__/adversarial/observer-propagation.test.js +404 -0
  48. package/dist/__tests__/adversarial/observer-propagation.test.js.map +1 -0
  49. package/dist/__tests__/adversarial/parent-validation.test.d.ts +13 -0
  50. package/dist/__tests__/adversarial/parent-validation.test.d.ts.map +1 -0
  51. package/dist/__tests__/adversarial/parent-validation.test.js +128 -0
  52. package/dist/__tests__/adversarial/parent-validation.test.js.map +1 -0
  53. package/dist/__tests__/adversarial/prd-12-2-compliance.test.d.ts +20 -0
  54. package/dist/__tests__/adversarial/prd-12-2-compliance.test.d.ts.map +1 -0
  55. package/dist/__tests__/adversarial/prd-12-2-compliance.test.js +482 -0
  56. package/dist/__tests__/adversarial/prd-12-2-compliance.test.js.map +1 -0
  57. package/dist/__tests__/adversarial/prd-compliance.test.d.ts +6 -0
  58. package/dist/__tests__/adversarial/prd-compliance.test.d.ts.map +1 -0
  59. package/dist/__tests__/adversarial/prd-compliance.test.js +886 -0
  60. package/dist/__tests__/adversarial/prd-compliance.test.js.map +1 -0
  61. package/dist/__tests__/compatibility/backward-compatibility.test.d.ts +22 -0
  62. package/dist/__tests__/compatibility/backward-compatibility.test.d.ts.map +1 -0
  63. package/dist/__tests__/compatibility/backward-compatibility.test.js +1843 -0
  64. package/dist/__tests__/compatibility/backward-compatibility.test.js.map +1 -0
  65. package/dist/__tests__/helpers/index.d.ts +10 -0
  66. package/dist/__tests__/helpers/index.d.ts.map +1 -0
  67. package/{src/__tests__/helpers/index.ts → dist/__tests__/helpers/index.js} +2 -10
  68. package/dist/__tests__/helpers/index.js.map +1 -0
  69. package/dist/__tests__/helpers/tree-verification.d.ts +90 -0
  70. package/dist/__tests__/helpers/tree-verification.d.ts.map +1 -0
  71. package/dist/__tests__/helpers/tree-verification.js +202 -0
  72. package/dist/__tests__/helpers/tree-verification.js.map +1 -0
  73. package/dist/__tests__/integration/agent-workflow.test.d.ts +2 -0
  74. package/dist/__tests__/integration/agent-workflow.test.d.ts.map +1 -0
  75. package/dist/__tests__/integration/agent-workflow.test.js +256 -0
  76. package/dist/__tests__/integration/agent-workflow.test.js.map +1 -0
  77. package/dist/__tests__/integration/bidirectional-consistency.test.d.ts +14 -0
  78. package/dist/__tests__/integration/bidirectional-consistency.test.d.ts.map +1 -0
  79. package/dist/__tests__/integration/bidirectional-consistency.test.js +668 -0
  80. package/dist/__tests__/integration/bidirectional-consistency.test.js.map +1 -0
  81. package/dist/__tests__/integration/observer-logging.test.d.ts +2 -0
  82. package/dist/__tests__/integration/observer-logging.test.d.ts.map +1 -0
  83. package/dist/__tests__/integration/observer-logging.test.js +517 -0
  84. package/dist/__tests__/integration/observer-logging.test.js.map +1 -0
  85. package/dist/__tests__/integration/tree-mirroring.test.d.ts +2 -0
  86. package/dist/__tests__/integration/tree-mirroring.test.d.ts.map +1 -0
  87. package/dist/__tests__/integration/tree-mirroring.test.js +117 -0
  88. package/dist/__tests__/integration/tree-mirroring.test.js.map +1 -0
  89. package/dist/__tests__/integration/workflow-reparenting.test.d.ts +12 -0
  90. package/dist/__tests__/integration/workflow-reparenting.test.d.ts.map +1 -0
  91. package/dist/__tests__/integration/workflow-reparenting.test.js +239 -0
  92. package/dist/__tests__/integration/workflow-reparenting.test.js.map +1 -0
  93. package/dist/__tests__/unit/agent.test.d.ts +2 -0
  94. package/dist/__tests__/unit/agent.test.d.ts.map +1 -0
  95. package/dist/__tests__/unit/agent.test.js +143 -0
  96. package/dist/__tests__/unit/agent.test.js.map +1 -0
  97. package/dist/__tests__/unit/cache-key.test.d.ts +5 -0
  98. package/dist/__tests__/unit/cache-key.test.d.ts.map +1 -0
  99. package/dist/__tests__/unit/cache-key.test.js +145 -0
  100. package/dist/__tests__/unit/cache-key.test.js.map +1 -0
  101. package/dist/__tests__/unit/cache.test.d.ts +5 -0
  102. package/dist/__tests__/unit/cache.test.d.ts.map +1 -0
  103. package/dist/__tests__/unit/cache.test.js +132 -0
  104. package/dist/__tests__/unit/cache.test.js.map +1 -0
  105. package/dist/__tests__/unit/context.test.d.ts +2 -0
  106. package/dist/__tests__/unit/context.test.d.ts.map +1 -0
  107. package/dist/__tests__/unit/context.test.js +220 -0
  108. package/dist/__tests__/unit/context.test.js.map +1 -0
  109. package/dist/__tests__/unit/decorators.test.d.ts +2 -0
  110. package/dist/__tests__/unit/decorators.test.d.ts.map +1 -0
  111. package/dist/__tests__/unit/decorators.test.js +162 -0
  112. package/dist/__tests__/unit/decorators.test.js.map +1 -0
  113. package/dist/__tests__/unit/introspection-tools.test.d.ts +5 -0
  114. package/dist/__tests__/unit/introspection-tools.test.d.ts.map +1 -0
  115. package/dist/__tests__/unit/introspection-tools.test.js +191 -0
  116. package/dist/__tests__/unit/introspection-tools.test.js.map +1 -0
  117. package/dist/__tests__/unit/logger.test.d.ts +2 -0
  118. package/dist/__tests__/unit/logger.test.d.ts.map +1 -0
  119. package/dist/__tests__/unit/logger.test.js +241 -0
  120. package/dist/__tests__/unit/logger.test.js.map +1 -0
  121. package/dist/__tests__/unit/observable.test.d.ts +2 -0
  122. package/dist/__tests__/unit/observable.test.d.ts.map +1 -0
  123. package/dist/__tests__/unit/observable.test.js +251 -0
  124. package/dist/__tests__/unit/observable.test.js.map +1 -0
  125. package/dist/__tests__/unit/prompt.test.d.ts +2 -0
  126. package/dist/__tests__/unit/prompt.test.d.ts.map +1 -0
  127. package/dist/__tests__/unit/prompt.test.js +113 -0
  128. package/dist/__tests__/unit/prompt.test.js.map +1 -0
  129. package/dist/__tests__/unit/reflection.test.d.ts +5 -0
  130. package/dist/__tests__/unit/reflection.test.d.ts.map +1 -0
  131. package/dist/__tests__/unit/reflection.test.js +160 -0
  132. package/dist/__tests__/unit/reflection.test.js.map +1 -0
  133. package/dist/__tests__/unit/tree-debugger-incremental.test.d.ts +2 -0
  134. package/dist/__tests__/unit/tree-debugger-incremental.test.d.ts.map +1 -0
  135. package/dist/__tests__/unit/tree-debugger-incremental.test.js +136 -0
  136. package/dist/__tests__/unit/tree-debugger-incremental.test.js.map +1 -0
  137. package/dist/__tests__/unit/tree-debugger.test.d.ts +2 -0
  138. package/dist/__tests__/unit/tree-debugger.test.d.ts.map +1 -0
  139. package/dist/__tests__/unit/tree-debugger.test.js +69 -0
  140. package/dist/__tests__/unit/tree-debugger.test.js.map +1 -0
  141. package/dist/__tests__/unit/utils/workflow-error-utils.test.d.ts +2 -0
  142. package/dist/__tests__/unit/utils/workflow-error-utils.test.d.ts.map +1 -0
  143. package/dist/__tests__/unit/utils/workflow-error-utils.test.js +154 -0
  144. package/dist/__tests__/unit/utils/workflow-error-utils.test.js.map +1 -0
  145. package/dist/__tests__/unit/workflow-detachChild.test.d.ts +2 -0
  146. package/dist/__tests__/unit/workflow-detachChild.test.d.ts.map +1 -0
  147. package/dist/__tests__/unit/workflow-detachChild.test.js +76 -0
  148. package/dist/__tests__/unit/workflow-detachChild.test.js.map +1 -0
  149. package/dist/__tests__/unit/workflow-emitEvent-childDetached.test.d.ts +2 -0
  150. package/dist/__tests__/unit/workflow-emitEvent-childDetached.test.d.ts.map +1 -0
  151. package/dist/__tests__/unit/workflow-emitEvent-childDetached.test.js +122 -0
  152. package/dist/__tests__/unit/workflow-emitEvent-childDetached.test.js.map +1 -0
  153. package/dist/__tests__/unit/workflow-isDescendantOf.test.d.ts +2 -0
  154. package/dist/__tests__/unit/workflow-isDescendantOf.test.d.ts.map +1 -0
  155. package/dist/__tests__/unit/workflow-isDescendantOf.test.js +140 -0
  156. package/dist/__tests__/unit/workflow-isDescendantOf.test.js.map +1 -0
  157. package/dist/__tests__/unit/workflow.test.d.ts +2 -0
  158. package/dist/__tests__/unit/workflow.test.d.ts.map +1 -0
  159. package/dist/__tests__/unit/workflow.test.js +330 -0
  160. package/dist/__tests__/unit/workflow.test.js.map +1 -0
  161. package/dist/cache/cache-key.d.ts +66 -0
  162. package/dist/cache/cache-key.d.ts.map +1 -0
  163. package/dist/cache/cache-key.js +195 -0
  164. package/dist/cache/cache-key.js.map +1 -0
  165. package/dist/cache/cache.d.ts +104 -0
  166. package/dist/cache/cache.d.ts.map +1 -0
  167. package/dist/cache/cache.js +179 -0
  168. package/dist/cache/cache.js.map +1 -0
  169. package/{src/cache/index.ts → dist/cache/index.d.ts} +1 -1
  170. package/dist/cache/index.d.ts.map +1 -0
  171. package/dist/cache/index.js +6 -0
  172. package/dist/cache/index.js.map +1 -0
  173. package/dist/core/agent.d.ts +112 -0
  174. package/dist/core/agent.d.ts.map +1 -0
  175. package/dist/core/agent.js +426 -0
  176. package/dist/core/agent.js.map +1 -0
  177. package/{src/core/context.ts → dist/core/context.d.ts} +16 -67
  178. package/dist/core/context.d.ts.map +1 -0
  179. package/dist/core/context.js +80 -0
  180. package/dist/core/context.js.map +1 -0
  181. package/dist/core/event-tree.d.ts +72 -0
  182. package/dist/core/event-tree.d.ts.map +1 -0
  183. package/dist/core/event-tree.js +211 -0
  184. package/dist/core/event-tree.js.map +1 -0
  185. package/{src/core/factory.ts → dist/core/factory.d.ts} +6 -27
  186. package/dist/core/factory.d.ts.map +1 -0
  187. package/dist/core/factory.js +110 -0
  188. package/dist/core/factory.js.map +1 -0
  189. package/{src/core/index.ts → dist/core/index.d.ts} +2 -10
  190. package/dist/core/index.d.ts.map +1 -0
  191. package/dist/core/index.js +9 -0
  192. package/dist/core/index.js.map +1 -0
  193. package/dist/core/logger.d.ts +50 -0
  194. package/dist/core/logger.d.ts.map +1 -0
  195. package/dist/core/logger.js +91 -0
  196. package/dist/core/logger.js.map +1 -0
  197. package/dist/core/mcp-handler.d.ts +69 -0
  198. package/dist/core/mcp-handler.d.ts.map +1 -0
  199. package/dist/core/mcp-handler.js +143 -0
  200. package/dist/core/mcp-handler.js.map +1 -0
  201. package/dist/core/prompt.d.ts +80 -0
  202. package/dist/core/prompt.d.ts.map +1 -0
  203. package/dist/core/prompt.js +120 -0
  204. package/dist/core/prompt.js.map +1 -0
  205. package/dist/core/workflow-context.d.ts +57 -0
  206. package/dist/core/workflow-context.d.ts.map +1 -0
  207. package/dist/core/workflow-context.js +263 -0
  208. package/dist/core/workflow-context.js.map +1 -0
  209. package/dist/core/workflow.d.ts +241 -0
  210. package/dist/core/workflow.d.ts.map +1 -0
  211. package/dist/core/workflow.js +464 -0
  212. package/dist/core/workflow.js.map +1 -0
  213. package/dist/debugger/index.d.ts +2 -0
  214. package/dist/debugger/index.d.ts.map +1 -0
  215. package/{src/debugger/index.ts → dist/debugger/index.js} +1 -0
  216. package/dist/debugger/index.js.map +1 -0
  217. package/dist/debugger/tree-debugger.d.ts +71 -0
  218. package/dist/debugger/tree-debugger.d.ts.map +1 -0
  219. package/dist/debugger/tree-debugger.js +198 -0
  220. package/dist/debugger/tree-debugger.js.map +1 -0
  221. package/dist/decorators/index.d.ts +4 -0
  222. package/dist/decorators/index.d.ts.map +1 -0
  223. package/{src/decorators/index.ts → dist/decorators/index.js} +1 -0
  224. package/dist/decorators/index.js.map +1 -0
  225. package/dist/decorators/observed-state.d.ts +32 -0
  226. package/dist/decorators/observed-state.d.ts.map +1 -0
  227. package/dist/decorators/observed-state.js +79 -0
  228. package/dist/decorators/observed-state.js.map +1 -0
  229. package/dist/decorators/step.d.ts +15 -0
  230. package/dist/decorators/step.d.ts.map +1 -0
  231. package/dist/decorators/step.js +110 -0
  232. package/dist/decorators/step.js.map +1 -0
  233. package/dist/decorators/task.d.ts +50 -0
  234. package/dist/decorators/task.d.ts.map +1 -0
  235. package/dist/decorators/task.js +118 -0
  236. package/dist/decorators/task.js.map +1 -0
  237. package/dist/examples/index.d.ts +3 -0
  238. package/dist/examples/index.d.ts.map +1 -0
  239. package/{src/examples/index.ts → dist/examples/index.js} +1 -0
  240. package/dist/examples/index.js.map +1 -0
  241. package/dist/examples/tdd-orchestrator.d.ts +15 -0
  242. package/dist/examples/tdd-orchestrator.d.ts.map +1 -0
  243. package/dist/examples/tdd-orchestrator.js +121 -0
  244. package/dist/examples/tdd-orchestrator.js.map +1 -0
  245. package/dist/examples/test-cycle-workflow.d.ts +14 -0
  246. package/dist/examples/test-cycle-workflow.d.ts.map +1 -0
  247. package/dist/examples/test-cycle-workflow.js +116 -0
  248. package/dist/examples/test-cycle-workflow.js.map +1 -0
  249. package/dist/index.d.ts +27 -0
  250. package/dist/index.d.ts.map +1 -0
  251. package/dist/index.js +40 -0
  252. package/dist/index.js.map +1 -0
  253. package/dist/reflection/index.d.ts +5 -0
  254. package/dist/reflection/index.d.ts.map +1 -0
  255. package/{src/reflection/index.ts → dist/reflection/index.js} +1 -1
  256. package/dist/reflection/index.js.map +1 -0
  257. package/dist/reflection/reflection.d.ts +84 -0
  258. package/dist/reflection/reflection.d.ts.map +1 -0
  259. package/dist/reflection/reflection.js +329 -0
  260. package/dist/reflection/reflection.js.map +1 -0
  261. package/dist/tools/index.d.ts +6 -0
  262. package/dist/tools/index.d.ts.map +1 -0
  263. package/dist/tools/index.js +11 -0
  264. package/dist/tools/index.js.map +1 -0
  265. package/dist/tools/introspection.d.ts +165 -0
  266. package/dist/tools/introspection.d.ts.map +1 -0
  267. package/dist/tools/introspection.js +324 -0
  268. package/dist/tools/introspection.js.map +1 -0
  269. package/dist/types/agent.d.ts +66 -0
  270. package/dist/types/agent.d.ts.map +1 -0
  271. package/dist/types/agent.js +6 -0
  272. package/dist/types/agent.js.map +1 -0
  273. package/dist/types/decorators.d.ts +31 -0
  274. package/dist/types/decorators.d.ts.map +1 -0
  275. package/dist/types/decorators.js +2 -0
  276. package/dist/types/decorators.js.map +1 -0
  277. package/dist/types/error-strategy.d.ts +13 -0
  278. package/dist/types/error-strategy.d.ts.map +1 -0
  279. package/dist/types/error-strategy.js +2 -0
  280. package/dist/types/error-strategy.js.map +1 -0
  281. package/dist/types/error.d.ts +20 -0
  282. package/dist/types/error.d.ts.map +1 -0
  283. package/dist/types/error.js +2 -0
  284. package/dist/types/error.js.map +1 -0
  285. package/dist/types/events.d.ts +87 -0
  286. package/dist/types/events.d.ts.map +1 -0
  287. package/dist/types/events.js +2 -0
  288. package/dist/types/events.js.map +1 -0
  289. package/dist/types/index.d.ts +15 -0
  290. package/dist/types/index.d.ts.map +1 -0
  291. package/dist/types/index.js +2 -0
  292. package/dist/types/index.js.map +1 -0
  293. package/dist/types/logging.d.ts +24 -0
  294. package/dist/types/logging.d.ts.map +1 -0
  295. package/dist/types/logging.js +2 -0
  296. package/dist/types/logging.js.map +1 -0
  297. package/dist/types/observer.d.ts +18 -0
  298. package/dist/types/observer.d.ts.map +1 -0
  299. package/dist/types/observer.js +2 -0
  300. package/dist/types/observer.js.map +1 -0
  301. package/dist/types/prompt.d.ts +31 -0
  302. package/dist/types/prompt.d.ts.map +1 -0
  303. package/dist/types/prompt.js +6 -0
  304. package/dist/types/prompt.js.map +1 -0
  305. package/dist/types/reflection.d.ts +96 -0
  306. package/dist/types/reflection.d.ts.map +1 -0
  307. package/dist/types/reflection.js +24 -0
  308. package/dist/types/reflection.js.map +1 -0
  309. package/dist/types/sdk-primitives.d.ts +118 -0
  310. package/dist/types/sdk-primitives.d.ts.map +1 -0
  311. package/dist/types/sdk-primitives.js +6 -0
  312. package/dist/types/sdk-primitives.js.map +1 -0
  313. package/{src/types/snapshot.ts → dist/types/snapshot.d.ts} +5 -5
  314. package/dist/types/snapshot.d.ts.map +1 -0
  315. package/dist/types/snapshot.js +2 -0
  316. package/dist/types/snapshot.js.map +1 -0
  317. package/dist/types/workflow-context.d.ts +139 -0
  318. package/dist/types/workflow-context.d.ts.map +1 -0
  319. package/dist/types/workflow-context.js +8 -0
  320. package/dist/types/workflow-context.js.map +1 -0
  321. package/dist/types/workflow.d.ts +30 -0
  322. package/dist/types/workflow.d.ts.map +1 -0
  323. package/dist/types/workflow.js +2 -0
  324. package/dist/types/workflow.js.map +1 -0
  325. package/dist/utils/id.d.ts +6 -0
  326. package/dist/utils/id.d.ts.map +1 -0
  327. package/dist/utils/id.js +12 -0
  328. package/dist/utils/id.js.map +1 -0
  329. package/{src/utils/index.ts → dist/utils/index.d.ts} +1 -0
  330. package/dist/utils/index.d.ts.map +1 -0
  331. package/dist/utils/index.js +4 -0
  332. package/dist/utils/index.js.map +1 -0
  333. package/dist/utils/observable.d.ts +54 -0
  334. package/dist/utils/observable.d.ts.map +1 -0
  335. package/dist/utils/observable.js +82 -0
  336. package/dist/utils/observable.js.map +1 -0
  337. package/dist/utils/workflow-error-utils.d.ts +22 -0
  338. package/dist/utils/workflow-error-utils.d.ts.map +1 -0
  339. package/dist/utils/workflow-error-utils.js +45 -0
  340. package/dist/utils/workflow-error-utils.js.map +1 -0
  341. package/package.json +5 -2
  342. package/.claude/commands/subtask-planning/prp-base-create.md +0 -120
  343. package/.claude/commands/subtask-planning/prp-base-execute.md +0 -65
  344. package/.claude/commands/task-breakdown.md +0 -94
  345. package/.claude/settings.local.json +0 -9
  346. package/.claude/system_prompts/task-breakdown.md +0 -101
  347. package/PRD.md +0 -543
  348. package/PRPs/001-hierarchical-workflow-engine.md +0 -2438
  349. package/PRPs/PRDs/002-agent-prompt.md +0 -390
  350. package/PRPs/PRDs/003-agent-prompt.md +0 -943
  351. package/PRPs/PRDs/004-agent-prompt.md +0 -1136
  352. package/PRPs/PRDs/tasks-001.json +0 -492
  353. package/PRPs/README.md +0 -83
  354. package/PRPs/templates/prp_base.md +0 -222
  355. package/docs/agent.md +0 -422
  356. package/docs/prompt.md +0 -419
  357. package/docs/workflow.md +0 -600
  358. package/examples/README.md +0 -258
  359. package/examples/examples/01-basic-workflow.ts +0 -100
  360. package/examples/examples/02-decorator-options.ts +0 -217
  361. package/examples/examples/03-parent-child.ts +0 -241
  362. package/examples/examples/04-observers-debugger.ts +0 -340
  363. package/examples/examples/05-error-handling.ts +0 -387
  364. package/examples/examples/06-concurrent-tasks.ts +0 -352
  365. package/examples/examples/07-agent-loops.ts +0 -432
  366. package/examples/examples/08-sdk-features.ts +0 -667
  367. package/examples/examples/09-reflection.ts +0 -573
  368. package/examples/examples/10-introspection.ts +0 -550
  369. package/examples/examples/11-reparenting-workflows.ts +0 -269
  370. package/examples/index.ts +0 -147
  371. package/examples/utils/helpers.ts +0 -57
  372. package/package-lock.json +0 -2398
  373. package/plan/001_d3bb02af4886/TEST_RESULTS.md +0 -259
  374. package/plan/001_d3bb02af4886/backlog.json +0 -867
  375. package/plan/001_d3bb02af4886/bug_fix_tasks.json +0 -484
  376. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M1T1S1/PRP.md +0 -488
  377. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M1T1S2/PRP.md +0 -581
  378. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M1T1S3/PRP.md +0 -687
  379. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T1S1/PRP.md +0 -492
  380. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T1S3/PRP.md +0 -932
  381. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T1S3/research/concurrent_error_testing_patterns.md +0 -1109
  382. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T1S3/research/vitest_concurrent_testing.md +0 -802
  383. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T1S3/research/workflow_engine_test_references.md +0 -603
  384. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T2S1/PRP.md +0 -564
  385. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T2S3/PRP.md +0 -518
  386. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T2S4/PRP.md +0 -1252
  387. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T3S1/PRP.md +0 -364
  388. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T3S1/research/CODEBASE_INVENTORY.md +0 -114
  389. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T3S1/research/DECORATOR_DOCUMENTATION_PATTERNS.md +0 -205
  390. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T3S1/research/PRD_LOCATION_ANALYSIS.md +0 -199
  391. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M2T3S1/research/ULTRATHINK_PRP_PLAN.md +0 -134
  392. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T1S1/PRP.md +0 -495
  393. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T1S1/research/console_error_inventory.md +0 -435
  394. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T1S2/PRP.md +0 -506
  395. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T1S3/PRP.md +0 -612
  396. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T2S2/PRP.md +0 -558
  397. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T2S2/research/external_research.md +0 -788
  398. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T3S2/PRP.md +0 -460
  399. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T3S3/PRP.md +0 -454
  400. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T4S1/PRP.md +0 -520
  401. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T4S1/RECOMMENDATION.md +0 -417
  402. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T4S1/research/external_workflow_engines_research.md +0 -760
  403. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T4S1/research/security_implications_analysis.md +0 -245
  404. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M3T4S2/PRP.md +0 -792
  405. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M4T1S1/PRP.md +0 -535
  406. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M4T1S1/TEST_EXECUTION_REPORT.md +0 -190
  407. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M4T1S2/PRP.md +0 -654
  408. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M4T1S2/TEST_FIX_REPORT.md +0 -227
  409. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M4T1S2/research/KEY_FINDINGS.md +0 -345
  410. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M4T1S2/research/QUICK_REFERENCE.md +0 -193
  411. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M4T1S2/research/test_maintenance_research.md +0 -1323
  412. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M4T3S1/BREAKING_CHANGES_AUDIT.md +0 -1011
  413. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M4T3S1/PRP.md +0 -927
  414. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/P1M4T3S2/PRP.md +0 -505
  415. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/architecture/logger_child_signature_analysis.md +0 -401
  416. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M1T1S3/child_implementation_research.md +0 -142
  417. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M1T1S3/test_patterns_research.md +0 -112
  418. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M1T1S3/vitest_patterns_research.md +0 -159
  419. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M1T1S4/PRP.md +0 -549
  420. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M1T1S4/VERIFICATION_REPORT.md +0 -368
  421. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M1T1S4/edge_case_analysis.md +0 -172
  422. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M1T1S4/usage_inventory.md +0 -175
  423. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T1S2/PRP.md +0 -696
  424. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T1S4/PRP.md +0 -860
  425. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/PRP.md +0 -1066
  426. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/01-testing-aggregated-errors.md +0 -1103
  427. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/01_typescript_error_aggregation_patterns.md +0 -789
  428. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/02-error-merge-strategy-testing-guide.md +0 -1098
  429. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/02_aggregate_error_patterns.md +0 -1037
  430. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/03-promise-allsettled-testing-patterns.md +0 -916
  431. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/03_error_merging_strategies.md +0 -1045
  432. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/04_github_stackoverflow_examples.md +0 -890
  433. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/05_comprehensive_summary.md +0 -822
  434. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/INDEX.md +0 -668
  435. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/QUICK_REFERENCE.md +0 -706
  436. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/README.md +0 -265
  437. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S2/research/RESEARCH_REPORT.md +0 -655
  438. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T2S4/research/vitest_testing_patterns.md +0 -1103
  439. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M2T3S2/PRP.md +0 -426
  440. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T1S2/PRP.md +0 -506
  441. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T1S2/research/QUICK_REFERENCE.md +0 -114
  442. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T1S2/research/RESEARCH_SUMMARY.md +0 -316
  443. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T1S2/research/vitest_observer_error_logging_best_practices.md +0 -754
  444. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T1S3/PRP.md +0 -612
  445. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T2S1/PRP.md +0 -719
  446. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T2S1/README.md +0 -215
  447. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T2S1/analysis.md +0 -765
  448. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T2S3/PRP.md +0 -718
  449. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T3S1/DECISION.md +0 -149
  450. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T3S1/PRP.md +0 -470
  451. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T3S1/research/ULTRATHINK_PLAN.md +0 -332
  452. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T3S1/research/codebase_workflow_name_analysis.md +0 -167
  453. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T3S1/research/external_best_practices.md +0 -265
  454. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T3S1/research/validation_patterns.md +0 -273
  455. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T4S1/workflow_engine_ancestry_api_research.md +0 -760
  456. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M3T4S3-PRP.md +0 -434
  457. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M4T2S1/PRP.md +0 -717
  458. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M4T2S2/PRP.md +0 -472
  459. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M4T2S2/VALIDATION_REPORT.md +0 -125
  460. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/P1M4T2S2/research/ULTRATHINK_PRP_PLAN.md +0 -301
  461. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/error-logging-best-practices.md +0 -1170
  462. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/research_typescript_partial_and_overloads.md +0 -940
  463. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/vitest-quick-reference.md +0 -151
  464. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/docs/vitest-research.md +0 -650
  465. package/plan/001_d3bb02af4886/bugfix/001_e8e04329daf3/prd_snapshot.md +0 -259
  466. package/plan/001_d3bb02af4886/bugfix/P1M1T1S1/PRP.md +0 -457
  467. package/plan/001_d3bb02af4886/bugfix/RESEARCH_SUMMARY.md +0 -346
  468. package/plan/001_d3bb02af4886/bugfix/architecture/codebase_structure.md +0 -311
  469. package/plan/001_d3bb02af4886/bugfix/architecture/concurrent_execution_best_practices.md +0 -1565
  470. package/plan/001_d3bb02af4886/bugfix/architecture/error_handling_patterns.md +0 -288
  471. package/plan/001_d3bb02af4886/bugfix/architecture/promise_all_analysis.md +0 -741
  472. package/plan/001_d3bb02af4886/docs/PRP/P1M1T1S4-functional-workflow-error-state-capture-test.md +0 -652
  473. package/plan/001_d3bb02af4886/docs/PRP/P1P2-PRP.md +0 -527
  474. package/plan/001_d3bb02af4886/docs/PRP/P3P4-PRP.md +0 -1388
  475. package/plan/001_d3bb02af4886/docs/PRP/P4P5-PRP.md +0 -1136
  476. package/plan/001_d3bb02af4886/docs/PRP/PRP.md +0 -527
  477. package/plan/001_d3bb02af4886/docs/PRP/bugfix/P1M1T2S1-PRP.md +0 -415
  478. package/plan/001_d3bb02af4886/docs/PRP/bugfix/P1M1T2S2-PRP.md +0 -378
  479. package/plan/001_d3bb02af4886/docs/PRP/bugfix/P1M1T2S4-PRP.md +0 -713
  480. package/plan/001_d3bb02af4886/docs/PRP/bugfix/P1M2T1S4-PRP.md +0 -370
  481. package/plan/001_d3bb02af4886/docs/PRP_P1M3T1S3.md +0 -499
  482. package/plan/001_d3bb02af4886/docs/TEST_RESULTS.md +0 -230
  483. package/plan/001_d3bb02af4886/docs/architecture/external_deps.md +0 -358
  484. package/plan/001_d3bb02af4886/docs/architecture/system_context.md +0 -242
  485. package/plan/001_d3bb02af4886/docs/bugfix/ANALYSIS_PRD_VS_IMPLEMENTATION.md +0 -1134
  486. package/plan/001_d3bb02af4886/docs/bugfix/GAP_ANALYSIS_SUMMARY.md +0 -179
  487. package/plan/001_d3bb02af4886/docs/bugfix/P1M4T2S1/PRP.md +0 -629
  488. package/plan/001_d3bb02af4886/docs/bugfix/P1M4T2S1/validation-report.md +0 -214
  489. package/plan/001_d3bb02af4886/docs/bugfix/PRP_P1M4T2S3.md +0 -629
  490. package/plan/001_d3bb02af4886/docs/bugfix/bugfix_PRP.md +0 -529
  491. package/plan/001_d3bb02af4886/docs/bugfix/bugfix_QUICK_REFERENCE.md +0 -142
  492. package/plan/001_d3bb02af4886/docs/bugfix/bugfix_README.md +0 -304
  493. package/plan/001_d3bb02af4886/docs/bugfix/bugfix_TEST_RESULTS.md +0 -558
  494. package/plan/001_d3bb02af4886/docs/bugfix/bugfix_VALIDATION_SUMMARY.md +0 -256
  495. package/plan/001_d3bb02af4886/docs/bugfix/system_context.md +0 -346
  496. package/plan/001_d3bb02af4886/docs/bugfix-architecture/bug_analysis.md +0 -415
  497. package/plan/001_d3bb02af4886/docs/bugfix-architecture/implementation_patterns.md +0 -489
  498. package/plan/001_d3bb02af4886/docs/bugfix-architecture/system_context.md +0 -218
  499. package/plan/001_d3bb02af4886/docs/bugfix_INITIATION_SUMMARY.md +0 -380
  500. package/plan/001_d3bb02af4886/docs/research/CYCLE_DETECTION_PATTERNS.md +0 -1923
  501. package/plan/001_d3bb02af4886/docs/research/CYCLE_DETECTION_QUICK_REF.md +0 -319
  502. package/plan/001_d3bb02af4886/docs/research/P1M1T2S1/codebase-context.md +0 -115
  503. package/plan/001_d3bb02af4886/docs/research/P1M1T2S1/cycle-detection-algorithms.md +0 -134
  504. package/plan/001_d3bb02af4886/docs/research/P1M1T2S1/test-patterns.md +0 -153
  505. package/plan/001_d3bb02af4886/docs/research/P1M1T2S1/workflow-class.md +0 -132
  506. package/plan/001_d3bb02af4886/docs/research/P1M2T1S4/DECORATOR_DOCUMENTATION_BEST_PRACTICES.md +0 -716
  507. package/plan/001_d3bb02af4886/docs/research/P1M2T1S4/DECORATOR_DOCUMENTATION_QUICK_REF.md +0 -186
  508. package/plan/001_d3bb02af4886/docs/research/P1M2T1S4/GROUNDSWELL_DECORATOR_EXAMPLES.md +0 -604
  509. package/plan/001_d3bb02af4886/docs/research/P1M2T1S4/INDEX.md +0 -213
  510. package/plan/001_d3bb02af4886/docs/research/P1M2T1S4/codebase_structure.md +0 -30
  511. package/plan/001_d3bb02af4886/docs/research/P1M2T1S4/existing_test_pattern.md +0 -56
  512. package/plan/001_d3bb02af4886/docs/research/P1M2T1S4/getRootObservers_implementation.md +0 -53
  513. package/plan/001_d3bb02af4886/docs/research/P1M2T1S4/test_conventions.md +0 -49
  514. package/plan/001_d3bb02af4886/docs/research/P1M3T1S4/PRP.md +0 -958
  515. package/plan/001_d3bb02af4886/docs/research/P1M3T1S4/QUICK_REFERENCE.md +0 -339
  516. package/plan/001_d3bb02af4886/docs/research/P1M3T1S4/README.md +0 -305
  517. package/plan/001_d3bb02af4886/docs/research/P1M3T1S4/SUMMARY.md +0 -433
  518. package/plan/001_d3bb02af4886/docs/research/P1M3T1S4/bidirectional-tree-consistency-testing.md +0 -1574
  519. package/plan/001_d3bb02af4886/docs/research/P1M3T1S4/test-pattern-examples.md +0 -1014
  520. package/plan/001_d3bb02af4886/docs/research/P1P2/LRU_CACHE_BEST_PRACTICES.md +0 -1929
  521. package/plan/001_d3bb02af4886/docs/research/P1P2/LRU_CACHE_CODE_PATTERNS.md +0 -857
  522. package/plan/001_d3bb02af4886/docs/research/P1P2/LRU_CACHE_INTEGRATION_GUIDE.md +0 -738
  523. package/plan/001_d3bb02af4886/docs/research/P1P2/LRU_CACHE_RESEARCH_INDEX.md +0 -424
  524. package/plan/001_d3bb02af4886/docs/research/P1P2/REFLECTION_INDEX.md +0 -291
  525. package/plan/001_d3bb02af4886/docs/research/P1P2/REFLECTION_RESEARCH_REPORT.md +0 -1342
  526. package/plan/001_d3bb02af4886/docs/research/P1P2/RESEARCH_SUMMARY.md +0 -342
  527. package/plan/001_d3bb02af4886/docs/research/P1P2/anthropic-sdk.md +0 -174
  528. package/plan/001_d3bb02af4886/docs/research/P1P2/async-local-storage.md +0 -200
  529. package/plan/001_d3bb02af4886/docs/research/P1P2/reflection-code-patterns.md +0 -1205
  530. package/plan/001_d3bb02af4886/docs/research/P1P2/reflection-decision-matrix.md +0 -421
  531. package/plan/001_d3bb02af4886/docs/research/P1P2/reflection-implementation-guide.md +0 -1341
  532. package/plan/001_d3bb02af4886/docs/research/P1P2/reflection-integration-guide.md +0 -834
  533. package/plan/001_d3bb02af4886/docs/research/P1P2/reflection-patterns.md +0 -1468
  534. package/plan/001_d3bb02af4886/docs/research/P1P2/reflection-quick-reference.md +0 -558
  535. package/plan/001_d3bb02af4886/docs/research/P1P2/zod-schema.md +0 -152
  536. package/plan/001_d3bb02af4886/docs/research/P3P4/caching-lru.md +0 -116
  537. package/plan/001_d3bb02af4886/docs/research/P3P4/introspection-tools.md +0 -177
  538. package/plan/001_d3bb02af4886/docs/research/P3P4/reflection-patterns.md +0 -117
  539. package/plan/001_d3bb02af4886/docs/research/P4P5/RESEARCH_SUMMARY.md +0 -151
  540. package/plan/001_d3bb02af4886/docs/research/PROMISE_ALLSETTLED_QUICK_REF.md +0 -376
  541. package/plan/001_d3bb02af4886/docs/research/PROMISE_ALLSETTLED_RESEARCH.md +0 -1507
  542. package/plan/001_d3bb02af4886/docs/research/bugfix_typescript_patterns.md +0 -949
  543. package/plan/001_d3bb02af4886/docs/research/error-testing-research.md +0 -619
  544. package/plan/001_d3bb02af4886/docs/research/error_handling_patterns.md +0 -723
  545. package/plan/001_d3bb02af4886/docs/research/general/INTROSPECTION_RESEARCH_SUMMARY.md +0 -378
  546. package/plan/001_d3bb02af4886/docs/research/general/README-INTROSPECTION.md +0 -352
  547. package/plan/001_d3bb02af4886/docs/research/general/agent-introspection-patterns.md +0 -1085
  548. package/plan/001_d3bb02af4886/docs/research/general/introspection-security-guide.md +0 -984
  549. package/plan/001_d3bb02af4886/docs/research/general/introspection-tool-examples.md +0 -875
  550. package/plan/001_d3bb02af4886/docs/research/incremental-tree-map-updates/PRP_TEMPLATE.md +0 -460
  551. package/plan/001_d3bb02af4886/docs/research/incremental-tree-map-updates/QUICK_REFERENCE.md +0 -324
  552. package/plan/001_d3bb02af4886/docs/research/incremental-tree-map-updates/README.md +0 -175
  553. package/plan/001_d3bb02af4886/docs/research/incremental-tree-map-updates/RESEARCH_REPORT.md +0 -499
  554. package/plan/001_d3bb02af4886/docs/research/incremental-tree-map-updates/SUMMARY.md +0 -163
  555. package/plan/001_d3bb02af4886/prd_snapshot.md +0 -543
  556. package/plan/bugfix/BUG_FIX_SUMMARY.md +0 -961
  557. package/scripts/generate-llms-full.ts +0 -206
  558. package/src/__tests__/adversarial/attachChild-performance.test.ts +0 -216
  559. package/src/__tests__/adversarial/circular-reference.test.ts +0 -101
  560. package/src/__tests__/adversarial/complex-circular-reference.test.ts +0 -139
  561. package/src/__tests__/adversarial/concurrent-task-failures.test.ts +0 -571
  562. package/src/__tests__/adversarial/deep-analysis.test.ts +0 -729
  563. package/src/__tests__/adversarial/deep-hierarchy-stress.test.ts +0 -213
  564. package/src/__tests__/adversarial/e2e-prd-validation.test.ts +0 -448
  565. package/src/__tests__/adversarial/edge-case.test.ts +0 -703
  566. package/src/__tests__/adversarial/error-merge-strategy.test.ts +0 -760
  567. package/src/__tests__/adversarial/incremental-performance.test.ts +0 -140
  568. package/src/__tests__/adversarial/node-map-update-benchmarks.test.ts +0 -457
  569. package/src/__tests__/adversarial/observer-propagation.test.ts +0 -487
  570. package/src/__tests__/adversarial/parent-validation.test.ts +0 -143
  571. package/src/__tests__/adversarial/prd-12-2-compliance.test.ts +0 -611
  572. package/src/__tests__/adversarial/prd-compliance.test.ts +0 -731
  573. package/src/__tests__/compatibility/backward-compatibility.test.ts +0 -1572
  574. package/src/__tests__/helpers/tree-verification.ts +0 -257
  575. package/src/__tests__/integration/agent-workflow.test.ts +0 -256
  576. package/src/__tests__/integration/bidirectional-consistency.test.ts +0 -847
  577. package/src/__tests__/integration/observer-logging.test.ts +0 -643
  578. package/src/__tests__/integration/tree-mirroring.test.ts +0 -151
  579. package/src/__tests__/integration/workflow-reparenting.test.ts +0 -303
  580. package/src/__tests__/unit/agent.test.ts +0 -169
  581. package/src/__tests__/unit/cache-key.test.ts +0 -182
  582. package/src/__tests__/unit/cache.test.ts +0 -172
  583. package/src/__tests__/unit/context.test.ts +0 -217
  584. package/src/__tests__/unit/decorators.test.ts +0 -100
  585. package/src/__tests__/unit/introspection-tools.test.ts +0 -277
  586. package/src/__tests__/unit/logger.test.ts +0 -293
  587. package/src/__tests__/unit/observable.test.ts +0 -321
  588. package/src/__tests__/unit/prompt.test.ts +0 -135
  589. package/src/__tests__/unit/reflection.test.ts +0 -210
  590. package/src/__tests__/unit/tree-debugger-incremental.test.ts +0 -170
  591. package/src/__tests__/unit/tree-debugger.test.ts +0 -85
  592. package/src/__tests__/unit/utils/workflow-error-utils.test.ts +0 -209
  593. package/src/__tests__/unit/workflow-detachChild.test.ts +0 -100
  594. package/src/__tests__/unit/workflow-emitEvent-childDetached.test.ts +0 -153
  595. package/src/__tests__/unit/workflow-isDescendantOf.test.ts +0 -180
  596. package/src/__tests__/unit/workflow.test.ts +0 -357
  597. package/src/cache/cache-key.ts +0 -244
  598. package/src/cache/cache.ts +0 -236
  599. package/src/core/agent.ts +0 -593
  600. package/src/core/event-tree.ts +0 -260
  601. package/src/core/logger.ts +0 -112
  602. package/src/core/mcp-handler.ts +0 -184
  603. package/src/core/prompt.ts +0 -150
  604. package/src/core/workflow-context.ts +0 -351
  605. package/src/core/workflow.ts +0 -540
  606. package/src/debugger/tree-debugger.ts +0 -255
  607. package/src/decorators/observed-state.ts +0 -95
  608. package/src/decorators/step.ts +0 -139
  609. package/src/decorators/task.ts +0 -159
  610. package/src/examples/tdd-orchestrator.ts +0 -65
  611. package/src/examples/test-cycle-workflow.ts +0 -64
  612. package/src/index.ts +0 -142
  613. package/src/reflection/reflection.ts +0 -407
  614. package/src/tools/index.ts +0 -36
  615. package/src/tools/introspection.ts +0 -464
  616. package/src/types/agent.ts +0 -90
  617. package/src/types/decorators.ts +0 -32
  618. package/src/types/error-strategy.ts +0 -13
  619. package/src/types/error.ts +0 -20
  620. package/src/types/events.ts +0 -75
  621. package/src/types/index.ts +0 -55
  622. package/src/types/logging.ts +0 -24
  623. package/src/types/observer.ts +0 -18
  624. package/src/types/prompt.ts +0 -40
  625. package/src/types/reflection.ts +0 -117
  626. package/src/types/sdk-primitives.ts +0 -128
  627. package/src/types/workflow-context.ts +0 -163
  628. package/src/types/workflow.ts +0 -37
  629. package/src/utils/id.ts +0 -11
  630. package/src/utils/observable.ts +0 -106
  631. package/src/utils/workflow-error-utils.ts +0 -56
  632. package/tsconfig.json +0 -22
  633. 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
- });