@zigrivers/scaffold 3.25.1 → 3.26.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 (492) hide show
  1. package/README.md +118 -0
  2. package/dist/cli/commands/complete.d.ts.map +1 -1
  3. package/dist/cli/commands/complete.js +6 -13
  4. package/dist/cli/commands/complete.js.map +1 -1
  5. package/dist/cli/commands/complete.test.js +18 -0
  6. package/dist/cli/commands/complete.test.js.map +1 -1
  7. package/dist/cli/commands/knowledge.test.js +4 -4
  8. package/dist/cli/commands/knowledge.test.js.map +1 -1
  9. package/dist/cli/commands/observe.d.ts +58 -0
  10. package/dist/cli/commands/observe.d.ts.map +1 -0
  11. package/dist/cli/commands/observe.js +430 -0
  12. package/dist/cli/commands/observe.js.map +1 -0
  13. package/dist/cli/commands/observe.test.d.ts +2 -0
  14. package/dist/cli/commands/observe.test.d.ts.map +1 -0
  15. package/dist/cli/commands/observe.test.js +452 -0
  16. package/dist/cli/commands/observe.test.js.map +1 -0
  17. package/dist/cli/commands/run.js +3 -3
  18. package/dist/cli/commands/run.js.map +1 -1
  19. package/dist/cli/commands/run.test.js +1 -1
  20. package/dist/cli/commands/run.test.js.map +1 -1
  21. package/dist/cli/index.d.ts.map +1 -1
  22. package/dist/cli/index.js +2 -0
  23. package/dist/cli/index.js.map +1 -1
  24. package/dist/observability/adapters/audit-history.d.ts +17 -0
  25. package/dist/observability/adapters/audit-history.d.ts.map +1 -0
  26. package/dist/observability/adapters/audit-history.js +113 -0
  27. package/dist/observability/adapters/audit-history.js.map +1 -0
  28. package/dist/observability/adapters/audit-history.test.d.ts +2 -0
  29. package/dist/observability/adapters/audit-history.test.d.ts.map +1 -0
  30. package/dist/observability/adapters/audit-history.test.js +137 -0
  31. package/dist/observability/adapters/audit-history.test.js.map +1 -0
  32. package/dist/observability/adapters/beads.d.ts +9 -0
  33. package/dist/observability/adapters/beads.d.ts.map +1 -0
  34. package/dist/observability/adapters/beads.js +40 -0
  35. package/dist/observability/adapters/beads.js.map +1 -0
  36. package/dist/observability/adapters/beads.test.d.ts +2 -0
  37. package/dist/observability/adapters/beads.test.d.ts.map +1 -0
  38. package/dist/observability/adapters/beads.test.js +25 -0
  39. package/dist/observability/adapters/beads.test.js.map +1 -0
  40. package/dist/observability/adapters/gh.d.ts +27 -0
  41. package/dist/observability/adapters/gh.d.ts.map +1 -0
  42. package/dist/observability/adapters/gh.js +118 -0
  43. package/dist/observability/adapters/gh.js.map +1 -0
  44. package/dist/observability/adapters/gh.test.d.ts +2 -0
  45. package/dist/observability/adapters/gh.test.d.ts.map +1 -0
  46. package/dist/observability/adapters/gh.test.js +79 -0
  47. package/dist/observability/adapters/gh.test.js.map +1 -0
  48. package/dist/observability/adapters/git.d.ts +24 -0
  49. package/dist/observability/adapters/git.d.ts.map +1 -0
  50. package/dist/observability/adapters/git.js +110 -0
  51. package/dist/observability/adapters/git.js.map +1 -0
  52. package/dist/observability/adapters/git.test.d.ts +2 -0
  53. package/dist/observability/adapters/git.test.d.ts.map +1 -0
  54. package/dist/observability/adapters/git.test.js +66 -0
  55. package/dist/observability/adapters/git.test.js.map +1 -0
  56. package/dist/observability/adapters/mmr.d.ts +15 -0
  57. package/dist/observability/adapters/mmr.d.ts.map +1 -0
  58. package/dist/observability/adapters/mmr.js +85 -0
  59. package/dist/observability/adapters/mmr.js.map +1 -0
  60. package/dist/observability/adapters/mmr.test.d.ts +2 -0
  61. package/dist/observability/adapters/mmr.test.d.ts.map +1 -0
  62. package/dist/observability/adapters/mmr.test.js +55 -0
  63. package/dist/observability/adapters/mmr.test.js.map +1 -0
  64. package/dist/observability/adapters/pipeline-docs.d.ts +8 -0
  65. package/dist/observability/adapters/pipeline-docs.d.ts.map +1 -0
  66. package/dist/observability/adapters/pipeline-docs.js +68 -0
  67. package/dist/observability/adapters/pipeline-docs.js.map +1 -0
  68. package/dist/observability/adapters/pipeline-docs.test.d.ts +2 -0
  69. package/dist/observability/adapters/pipeline-docs.test.d.ts.map +1 -0
  70. package/dist/observability/adapters/pipeline-docs.test.js +58 -0
  71. package/dist/observability/adapters/pipeline-docs.test.js.map +1 -0
  72. package/dist/observability/adapters/state.d.ts +21 -0
  73. package/dist/observability/adapters/state.d.ts.map +1 -0
  74. package/dist/observability/adapters/state.js +87 -0
  75. package/dist/observability/adapters/state.js.map +1 -0
  76. package/dist/observability/adapters/state.test.d.ts +2 -0
  77. package/dist/observability/adapters/state.test.d.ts.map +1 -0
  78. package/dist/observability/adapters/state.test.js +92 -0
  79. package/dist/observability/adapters/state.test.js.map +1 -0
  80. package/dist/observability/adapters/tests.d.ts +20 -0
  81. package/dist/observability/adapters/tests.d.ts.map +1 -0
  82. package/dist/observability/adapters/tests.js +52 -0
  83. package/dist/observability/adapters/tests.js.map +1 -0
  84. package/dist/observability/adapters/tests.test.d.ts +2 -0
  85. package/dist/observability/adapters/tests.test.d.ts.map +1 -0
  86. package/dist/observability/adapters/tests.test.js +66 -0
  87. package/dist/observability/adapters/tests.test.js.map +1 -0
  88. package/dist/observability/adapters/types.d.ts +7 -0
  89. package/dist/observability/adapters/types.d.ts.map +1 -0
  90. package/dist/observability/adapters/types.js +2 -0
  91. package/dist/observability/adapters/types.js.map +1 -0
  92. package/dist/observability/checks/lens-a-tdd.d.ts +3 -0
  93. package/dist/observability/checks/lens-a-tdd.d.ts.map +1 -0
  94. package/dist/observability/checks/lens-a-tdd.js +34 -0
  95. package/dist/observability/checks/lens-a-tdd.js.map +1 -0
  96. package/dist/observability/checks/lens-a-tdd.test.d.ts +2 -0
  97. package/dist/observability/checks/lens-a-tdd.test.d.ts.map +1 -0
  98. package/dist/observability/checks/lens-a-tdd.test.js +62 -0
  99. package/dist/observability/checks/lens-a-tdd.test.js.map +1 -0
  100. package/dist/observability/checks/lens-b-ac-coverage.d.ts +3 -0
  101. package/dist/observability/checks/lens-b-ac-coverage.d.ts.map +1 -0
  102. package/dist/observability/checks/lens-b-ac-coverage.js +63 -0
  103. package/dist/observability/checks/lens-b-ac-coverage.js.map +1 -0
  104. package/dist/observability/checks/lens-b-ac-coverage.test.d.ts +2 -0
  105. package/dist/observability/checks/lens-b-ac-coverage.test.d.ts.map +1 -0
  106. package/dist/observability/checks/lens-b-ac-coverage.test.js +59 -0
  107. package/dist/observability/checks/lens-b-ac-coverage.test.js.map +1 -0
  108. package/dist/observability/checks/lens-c-standards.d.ts +3 -0
  109. package/dist/observability/checks/lens-c-standards.d.ts.map +1 -0
  110. package/dist/observability/checks/lens-c-standards.js +104 -0
  111. package/dist/observability/checks/lens-c-standards.js.map +1 -0
  112. package/dist/observability/checks/lens-c-standards.test.d.ts +2 -0
  113. package/dist/observability/checks/lens-c-standards.test.d.ts.map +1 -0
  114. package/dist/observability/checks/lens-c-standards.test.js +79 -0
  115. package/dist/observability/checks/lens-c-standards.test.js.map +1 -0
  116. package/dist/observability/checks/lens-d-stack.d.ts +3 -0
  117. package/dist/observability/checks/lens-d-stack.d.ts.map +1 -0
  118. package/dist/observability/checks/lens-d-stack.js +108 -0
  119. package/dist/observability/checks/lens-d-stack.js.map +1 -0
  120. package/dist/observability/checks/lens-d-stack.test.d.ts +2 -0
  121. package/dist/observability/checks/lens-d-stack.test.d.ts.map +1 -0
  122. package/dist/observability/checks/lens-d-stack.test.js +60 -0
  123. package/dist/observability/checks/lens-d-stack.test.js.map +1 -0
  124. package/dist/observability/checks/lens-e-design.d.ts +3 -0
  125. package/dist/observability/checks/lens-e-design.d.ts.map +1 -0
  126. package/dist/observability/checks/lens-e-design.js +76 -0
  127. package/dist/observability/checks/lens-e-design.js.map +1 -0
  128. package/dist/observability/checks/lens-e-design.test.d.ts +2 -0
  129. package/dist/observability/checks/lens-e-design.test.d.ts.map +1 -0
  130. package/dist/observability/checks/lens-e-design.test.js +85 -0
  131. package/dist/observability/checks/lens-e-design.test.js.map +1 -0
  132. package/dist/observability/checks/lens-f-scope.d.ts +3 -0
  133. package/dist/observability/checks/lens-f-scope.d.ts.map +1 -0
  134. package/dist/observability/checks/lens-f-scope.js +92 -0
  135. package/dist/observability/checks/lens-f-scope.js.map +1 -0
  136. package/dist/observability/checks/lens-f-scope.test.d.ts +2 -0
  137. package/dist/observability/checks/lens-f-scope.test.d.ts.map +1 -0
  138. package/dist/observability/checks/lens-f-scope.test.js +63 -0
  139. package/dist/observability/checks/lens-f-scope.test.js.map +1 -0
  140. package/dist/observability/checks/lens-g-decisions.d.ts +3 -0
  141. package/dist/observability/checks/lens-g-decisions.d.ts.map +1 -0
  142. package/dist/observability/checks/lens-g-decisions.js +139 -0
  143. package/dist/observability/checks/lens-g-decisions.js.map +1 -0
  144. package/dist/observability/checks/lens-g-decisions.test.d.ts +2 -0
  145. package/dist/observability/checks/lens-g-decisions.test.d.ts.map +1 -0
  146. package/dist/observability/checks/lens-g-decisions.test.js +118 -0
  147. package/dist/observability/checks/lens-g-decisions.test.js.map +1 -0
  148. package/dist/observability/checks/lens-h-cross-doc.d.ts +3 -0
  149. package/dist/observability/checks/lens-h-cross-doc.d.ts.map +1 -0
  150. package/dist/observability/checks/lens-h-cross-doc.js +322 -0
  151. package/dist/observability/checks/lens-h-cross-doc.js.map +1 -0
  152. package/dist/observability/checks/lens-h-cross-doc.test.d.ts +2 -0
  153. package/dist/observability/checks/lens-h-cross-doc.test.d.ts.map +1 -0
  154. package/dist/observability/checks/lens-h-cross-doc.test.js +174 -0
  155. package/dist/observability/checks/lens-h-cross-doc.test.js.map +1 -0
  156. package/dist/observability/engine/abort-snapshot.d.ts +10 -0
  157. package/dist/observability/engine/abort-snapshot.d.ts.map +1 -0
  158. package/dist/observability/engine/abort-snapshot.js +36 -0
  159. package/dist/observability/engine/abort-snapshot.js.map +1 -0
  160. package/dist/observability/engine/abort-snapshot.test.d.ts +2 -0
  161. package/dist/observability/engine/abort-snapshot.test.d.ts.map +1 -0
  162. package/dist/observability/engine/abort-snapshot.test.js +66 -0
  163. package/dist/observability/engine/abort-snapshot.test.js.map +1 -0
  164. package/dist/observability/engine/api.d.ts +24 -0
  165. package/dist/observability/engine/api.d.ts.map +1 -0
  166. package/dist/observability/engine/api.js +203 -0
  167. package/dist/observability/engine/api.js.map +1 -0
  168. package/dist/observability/engine/api.test.d.ts +2 -0
  169. package/dist/observability/engine/api.test.d.ts.map +1 -0
  170. package/dist/observability/engine/api.test.js +174 -0
  171. package/dist/observability/engine/api.test.js.map +1 -0
  172. package/dist/observability/engine/checks/findings-aggregator.d.ts +6 -0
  173. package/dist/observability/engine/checks/findings-aggregator.d.ts.map +1 -0
  174. package/dist/observability/engine/checks/findings-aggregator.js +56 -0
  175. package/dist/observability/engine/checks/findings-aggregator.js.map +1 -0
  176. package/dist/observability/engine/checks/findings-aggregator.test.d.ts +2 -0
  177. package/dist/observability/engine/checks/findings-aggregator.test.d.ts.map +1 -0
  178. package/dist/observability/engine/checks/findings-aggregator.test.js +63 -0
  179. package/dist/observability/engine/checks/findings-aggregator.test.js.map +1 -0
  180. package/dist/observability/engine/checks/fix-threshold.d.ts +3 -0
  181. package/dist/observability/engine/checks/fix-threshold.d.ts.map +1 -0
  182. package/dist/observability/engine/checks/fix-threshold.js +24 -0
  183. package/dist/observability/engine/checks/fix-threshold.js.map +1 -0
  184. package/dist/observability/engine/checks/fix-threshold.test.d.ts +2 -0
  185. package/dist/observability/engine/checks/fix-threshold.test.d.ts.map +1 -0
  186. package/dist/observability/engine/checks/fix-threshold.test.js +29 -0
  187. package/dist/observability/engine/checks/fix-threshold.test.js.map +1 -0
  188. package/dist/observability/engine/checks/observability-config.d.ts +64 -0
  189. package/dist/observability/engine/checks/observability-config.d.ts.map +1 -0
  190. package/dist/observability/engine/checks/observability-config.js +56 -0
  191. package/dist/observability/engine/checks/observability-config.js.map +1 -0
  192. package/dist/observability/engine/checks/observability-config.test.d.ts +2 -0
  193. package/dist/observability/engine/checks/observability-config.test.d.ts.map +1 -0
  194. package/dist/observability/engine/checks/observability-config.test.js +39 -0
  195. package/dist/observability/engine/checks/observability-config.test.js.map +1 -0
  196. package/dist/observability/engine/checks/registry.d.ts +19 -0
  197. package/dist/observability/engine/checks/registry.d.ts.map +1 -0
  198. package/dist/observability/engine/checks/registry.js +44 -0
  199. package/dist/observability/engine/checks/registry.js.map +1 -0
  200. package/dist/observability/engine/checks/registry.test.d.ts +2 -0
  201. package/dist/observability/engine/checks/registry.test.d.ts.map +1 -0
  202. package/dist/observability/engine/checks/registry.test.js +23 -0
  203. package/dist/observability/engine/checks/registry.test.js.map +1 -0
  204. package/dist/observability/engine/checks/runner.d.ts +23 -0
  205. package/dist/observability/engine/checks/runner.d.ts.map +1 -0
  206. package/dist/observability/engine/checks/runner.js +66 -0
  207. package/dist/observability/engine/checks/runner.js.map +1 -0
  208. package/dist/observability/engine/checks/runner.test.d.ts +2 -0
  209. package/dist/observability/engine/checks/runner.test.d.ts.map +1 -0
  210. package/dist/observability/engine/checks/runner.test.js +95 -0
  211. package/dist/observability/engine/checks/runner.test.js.map +1 -0
  212. package/dist/observability/engine/doc-graph/component-parser.d.ts +3 -0
  213. package/dist/observability/engine/doc-graph/component-parser.d.ts.map +1 -0
  214. package/dist/observability/engine/doc-graph/component-parser.js +42 -0
  215. package/dist/observability/engine/doc-graph/component-parser.js.map +1 -0
  216. package/dist/observability/engine/doc-graph/component-parser.test.d.ts +2 -0
  217. package/dist/observability/engine/doc-graph/component-parser.test.d.ts.map +1 -0
  218. package/dist/observability/engine/doc-graph/component-parser.test.js +40 -0
  219. package/dist/observability/engine/doc-graph/component-parser.test.js.map +1 -0
  220. package/dist/observability/engine/doc-graph/component-use-detector.d.ts +8 -0
  221. package/dist/observability/engine/doc-graph/component-use-detector.d.ts.map +1 -0
  222. package/dist/observability/engine/doc-graph/component-use-detector.js +62 -0
  223. package/dist/observability/engine/doc-graph/component-use-detector.js.map +1 -0
  224. package/dist/observability/engine/doc-graph/component-use-detector.test.d.ts +2 -0
  225. package/dist/observability/engine/doc-graph/component-use-detector.test.d.ts.map +1 -0
  226. package/dist/observability/engine/doc-graph/component-use-detector.test.js +38 -0
  227. package/dist/observability/engine/doc-graph/component-use-detector.test.js.map +1 -0
  228. package/dist/observability/engine/doc-graph/decision-parser.d.ts +3 -0
  229. package/dist/observability/engine/doc-graph/decision-parser.d.ts.map +1 -0
  230. package/dist/observability/engine/doc-graph/decision-parser.js +60 -0
  231. package/dist/observability/engine/doc-graph/decision-parser.js.map +1 -0
  232. package/dist/observability/engine/doc-graph/decision-parser.test.d.ts +2 -0
  233. package/dist/observability/engine/doc-graph/decision-parser.test.d.ts.map +1 -0
  234. package/dist/observability/engine/doc-graph/decision-parser.test.js +65 -0
  235. package/dist/observability/engine/doc-graph/decision-parser.test.js.map +1 -0
  236. package/dist/observability/engine/doc-graph/design-props.d.ts +9 -0
  237. package/dist/observability/engine/doc-graph/design-props.d.ts.map +1 -0
  238. package/dist/observability/engine/doc-graph/design-props.js +50 -0
  239. package/dist/observability/engine/doc-graph/design-props.js.map +1 -0
  240. package/dist/observability/engine/doc-graph/edge-builder.d.ts +28 -0
  241. package/dist/observability/engine/doc-graph/edge-builder.d.ts.map +1 -0
  242. package/dist/observability/engine/doc-graph/edge-builder.js +75 -0
  243. package/dist/observability/engine/doc-graph/edge-builder.js.map +1 -0
  244. package/dist/observability/engine/doc-graph/edge-builder.test.d.ts +2 -0
  245. package/dist/observability/engine/doc-graph/edge-builder.test.d.ts.map +1 -0
  246. package/dist/observability/engine/doc-graph/edge-builder.test.js +124 -0
  247. package/dist/observability/engine/doc-graph/edge-builder.test.js.map +1 -0
  248. package/dist/observability/engine/doc-graph/feature-parser.d.ts +3 -0
  249. package/dist/observability/engine/doc-graph/feature-parser.d.ts.map +1 -0
  250. package/dist/observability/engine/doc-graph/feature-parser.js +78 -0
  251. package/dist/observability/engine/doc-graph/feature-parser.js.map +1 -0
  252. package/dist/observability/engine/doc-graph/feature-parser.test.d.ts +2 -0
  253. package/dist/observability/engine/doc-graph/feature-parser.test.d.ts.map +1 -0
  254. package/dist/observability/engine/doc-graph/feature-parser.test.js +51 -0
  255. package/dist/observability/engine/doc-graph/feature-parser.test.js.map +1 -0
  256. package/dist/observability/engine/doc-graph/index.d.ts +3 -0
  257. package/dist/observability/engine/doc-graph/index.d.ts.map +1 -0
  258. package/dist/observability/engine/doc-graph/index.js +138 -0
  259. package/dist/observability/engine/doc-graph/index.js.map +1 -0
  260. package/dist/observability/engine/doc-graph/index.test.d.ts +2 -0
  261. package/dist/observability/engine/doc-graph/index.test.d.ts.map +1 -0
  262. package/dist/observability/engine/doc-graph/index.test.js +82 -0
  263. package/dist/observability/engine/doc-graph/index.test.js.map +1 -0
  264. package/dist/observability/engine/doc-graph/parse-markdown.d.ts +15 -0
  265. package/dist/observability/engine/doc-graph/parse-markdown.d.ts.map +1 -0
  266. package/dist/observability/engine/doc-graph/parse-markdown.js +79 -0
  267. package/dist/observability/engine/doc-graph/parse-markdown.js.map +1 -0
  268. package/dist/observability/engine/doc-graph/parse-markdown.test.d.ts +2 -0
  269. package/dist/observability/engine/doc-graph/parse-markdown.test.d.ts.map +1 -0
  270. package/dist/observability/engine/doc-graph/parse-markdown.test.js +50 -0
  271. package/dist/observability/engine/doc-graph/parse-markdown.test.js.map +1 -0
  272. package/dist/observability/engine/doc-graph/plan-task-parser.d.ts +3 -0
  273. package/dist/observability/engine/doc-graph/plan-task-parser.d.ts.map +1 -0
  274. package/dist/observability/engine/doc-graph/plan-task-parser.js +38 -0
  275. package/dist/observability/engine/doc-graph/plan-task-parser.js.map +1 -0
  276. package/dist/observability/engine/doc-graph/plan-task-parser.test.d.ts +2 -0
  277. package/dist/observability/engine/doc-graph/plan-task-parser.test.d.ts.map +1 -0
  278. package/dist/observability/engine/doc-graph/plan-task-parser.test.js +38 -0
  279. package/dist/observability/engine/doc-graph/plan-task-parser.test.js.map +1 -0
  280. package/dist/observability/engine/doc-graph/playbook-task-parser.d.ts +3 -0
  281. package/dist/observability/engine/doc-graph/playbook-task-parser.d.ts.map +1 -0
  282. package/dist/observability/engine/doc-graph/playbook-task-parser.js +40 -0
  283. package/dist/observability/engine/doc-graph/playbook-task-parser.js.map +1 -0
  284. package/dist/observability/engine/doc-graph/playbook-task-parser.test.d.ts +2 -0
  285. package/dist/observability/engine/doc-graph/playbook-task-parser.test.d.ts.map +1 -0
  286. package/dist/observability/engine/doc-graph/playbook-task-parser.test.js +31 -0
  287. package/dist/observability/engine/doc-graph/playbook-task-parser.test.js.map +1 -0
  288. package/dist/observability/engine/doc-graph/rule-parser.d.ts +3 -0
  289. package/dist/observability/engine/doc-graph/rule-parser.d.ts.map +1 -0
  290. package/dist/observability/engine/doc-graph/rule-parser.js +65 -0
  291. package/dist/observability/engine/doc-graph/rule-parser.js.map +1 -0
  292. package/dist/observability/engine/doc-graph/rule-parser.test.d.ts +2 -0
  293. package/dist/observability/engine/doc-graph/rule-parser.test.d.ts.map +1 -0
  294. package/dist/observability/engine/doc-graph/rule-parser.test.js +44 -0
  295. package/dist/observability/engine/doc-graph/rule-parser.test.js.map +1 -0
  296. package/dist/observability/engine/doc-graph/story-parser.d.ts +8 -0
  297. package/dist/observability/engine/doc-graph/story-parser.d.ts.map +1 -0
  298. package/dist/observability/engine/doc-graph/story-parser.js +109 -0
  299. package/dist/observability/engine/doc-graph/story-parser.js.map +1 -0
  300. package/dist/observability/engine/doc-graph/story-parser.test.d.ts +2 -0
  301. package/dist/observability/engine/doc-graph/story-parser.test.d.ts.map +1 -0
  302. package/dist/observability/engine/doc-graph/story-parser.test.js +66 -0
  303. package/dist/observability/engine/doc-graph/story-parser.test.js.map +1 -0
  304. package/dist/observability/engine/doc-graph/test-discovery.d.ts +3 -0
  305. package/dist/observability/engine/doc-graph/test-discovery.d.ts.map +1 -0
  306. package/dist/observability/engine/doc-graph/test-discovery.js +122 -0
  307. package/dist/observability/engine/doc-graph/test-discovery.js.map +1 -0
  308. package/dist/observability/engine/doc-graph/test-discovery.test.d.ts +2 -0
  309. package/dist/observability/engine/doc-graph/test-discovery.test.d.ts.map +1 -0
  310. package/dist/observability/engine/doc-graph/test-discovery.test.js +39 -0
  311. package/dist/observability/engine/doc-graph/test-discovery.test.js.map +1 -0
  312. package/dist/observability/engine/doc-graph/token-parser.d.ts +3 -0
  313. package/dist/observability/engine/doc-graph/token-parser.d.ts.map +1 -0
  314. package/dist/observability/engine/doc-graph/token-parser.js +67 -0
  315. package/dist/observability/engine/doc-graph/token-parser.js.map +1 -0
  316. package/dist/observability/engine/doc-graph/token-parser.test.d.ts +2 -0
  317. package/dist/observability/engine/doc-graph/token-parser.test.d.ts.map +1 -0
  318. package/dist/observability/engine/doc-graph/token-parser.test.js +39 -0
  319. package/dist/observability/engine/doc-graph/token-parser.test.js.map +1 -0
  320. package/dist/observability/engine/doc-graph/token-use-detector.d.ts +10 -0
  321. package/dist/observability/engine/doc-graph/token-use-detector.d.ts.map +1 -0
  322. package/dist/observability/engine/doc-graph/token-use-detector.js +105 -0
  323. package/dist/observability/engine/doc-graph/token-use-detector.js.map +1 -0
  324. package/dist/observability/engine/doc-graph/token-use-detector.test.d.ts +2 -0
  325. package/dist/observability/engine/doc-graph/token-use-detector.test.d.ts.map +1 -0
  326. package/dist/observability/engine/doc-graph/token-use-detector.test.js +60 -0
  327. package/dist/observability/engine/doc-graph/token-use-detector.test.js.map +1 -0
  328. package/dist/observability/engine/event-schemas.d.ts +12 -0
  329. package/dist/observability/engine/event-schemas.d.ts.map +1 -0
  330. package/dist/observability/engine/event-schemas.js +182 -0
  331. package/dist/observability/engine/event-schemas.js.map +1 -0
  332. package/dist/observability/engine/event-schemas.test.d.ts +2 -0
  333. package/dist/observability/engine/event-schemas.test.d.ts.map +1 -0
  334. package/dist/observability/engine/event-schemas.test.js +200 -0
  335. package/dist/observability/engine/event-schemas.test.js.map +1 -0
  336. package/dist/observability/engine/fix-agent-dispatcher.d.ts +19 -0
  337. package/dist/observability/engine/fix-agent-dispatcher.d.ts.map +1 -0
  338. package/dist/observability/engine/fix-agent-dispatcher.js +88 -0
  339. package/dist/observability/engine/fix-agent-dispatcher.js.map +1 -0
  340. package/dist/observability/engine/fix-agent-dispatcher.test.d.ts +2 -0
  341. package/dist/observability/engine/fix-agent-dispatcher.test.d.ts.map +1 -0
  342. package/dist/observability/engine/fix-agent-dispatcher.test.js +54 -0
  343. package/dist/observability/engine/fix-agent-dispatcher.test.js.map +1 -0
  344. package/dist/observability/engine/fix-flow.d.ts +30 -0
  345. package/dist/observability/engine/fix-flow.d.ts.map +1 -0
  346. package/dist/observability/engine/fix-flow.js +105 -0
  347. package/dist/observability/engine/fix-flow.js.map +1 -0
  348. package/dist/observability/engine/fix-flow.test.d.ts +2 -0
  349. package/dist/observability/engine/fix-flow.test.d.ts.map +1 -0
  350. package/dist/observability/engine/fix-flow.test.js +127 -0
  351. package/dist/observability/engine/fix-flow.test.js.map +1 -0
  352. package/dist/observability/engine/fix-plan.d.ts +3 -0
  353. package/dist/observability/engine/fix-plan.d.ts.map +1 -0
  354. package/dist/observability/engine/fix-plan.js +13 -0
  355. package/dist/observability/engine/fix-plan.js.map +1 -0
  356. package/dist/observability/engine/fix-plan.test.d.ts +2 -0
  357. package/dist/observability/engine/fix-plan.test.d.ts.map +1 -0
  358. package/dist/observability/engine/fix-plan.test.js +44 -0
  359. package/dist/observability/engine/fix-plan.test.js.map +1 -0
  360. package/dist/observability/engine/harvester.d.ts +16 -0
  361. package/dist/observability/engine/harvester.d.ts.map +1 -0
  362. package/dist/observability/engine/harvester.js +106 -0
  363. package/dist/observability/engine/harvester.js.map +1 -0
  364. package/dist/observability/engine/harvester.test.d.ts +2 -0
  365. package/dist/observability/engine/harvester.test.d.ts.map +1 -0
  366. package/dist/observability/engine/harvester.test.js +99 -0
  367. package/dist/observability/engine/harvester.test.js.map +1 -0
  368. package/dist/observability/engine/identity.d.ts +6 -0
  369. package/dist/observability/engine/identity.d.ts.map +1 -0
  370. package/dist/observability/engine/identity.js +50 -0
  371. package/dist/observability/engine/identity.js.map +1 -0
  372. package/dist/observability/engine/identity.test.d.ts +2 -0
  373. package/dist/observability/engine/identity.test.d.ts.map +1 -0
  374. package/dist/observability/engine/identity.test.js +29 -0
  375. package/dist/observability/engine/identity.test.js.map +1 -0
  376. package/dist/observability/engine/ledger-writer.d.ts +10 -0
  377. package/dist/observability/engine/ledger-writer.d.ts.map +1 -0
  378. package/dist/observability/engine/ledger-writer.js +50 -0
  379. package/dist/observability/engine/ledger-writer.js.map +1 -0
  380. package/dist/observability/engine/ledger-writer.test.d.ts +2 -0
  381. package/dist/observability/engine/ledger-writer.test.d.ts.map +1 -0
  382. package/dist/observability/engine/ledger-writer.test.js +72 -0
  383. package/dist/observability/engine/ledger-writer.test.js.map +1 -0
  384. package/dist/observability/engine/llm-dispatcher.d.ts +16 -0
  385. package/dist/observability/engine/llm-dispatcher.d.ts.map +1 -0
  386. package/dist/observability/engine/llm-dispatcher.js +183 -0
  387. package/dist/observability/engine/llm-dispatcher.js.map +1 -0
  388. package/dist/observability/engine/llm-dispatcher.test.d.ts +2 -0
  389. package/dist/observability/engine/llm-dispatcher.test.d.ts.map +1 -0
  390. package/dist/observability/engine/llm-dispatcher.test.js +109 -0
  391. package/dist/observability/engine/llm-dispatcher.test.js.map +1 -0
  392. package/dist/observability/engine/phase-audit.d.ts +22 -0
  393. package/dist/observability/engine/phase-audit.d.ts.map +1 -0
  394. package/dist/observability/engine/phase-audit.js +98 -0
  395. package/dist/observability/engine/phase-audit.js.map +1 -0
  396. package/dist/observability/engine/phase-audit.test.d.ts +2 -0
  397. package/dist/observability/engine/phase-audit.test.d.ts.map +1 -0
  398. package/dist/observability/engine/phase-audit.test.js +82 -0
  399. package/dist/observability/engine/phase-audit.test.js.map +1 -0
  400. package/dist/observability/engine/phase-subsets.d.ts +5 -0
  401. package/dist/observability/engine/phase-subsets.d.ts.map +1 -0
  402. package/dist/observability/engine/phase-subsets.js +23 -0
  403. package/dist/observability/engine/phase-subsets.js.map +1 -0
  404. package/dist/observability/engine/phase-subsets.test.d.ts +2 -0
  405. package/dist/observability/engine/phase-subsets.test.d.ts.map +1 -0
  406. package/dist/observability/engine/phase-subsets.test.js +24 -0
  407. package/dist/observability/engine/phase-subsets.test.js.map +1 -0
  408. package/dist/observability/engine/redact.d.ts +9 -0
  409. package/dist/observability/engine/redact.d.ts.map +1 -0
  410. package/dist/observability/engine/redact.js +134 -0
  411. package/dist/observability/engine/redact.js.map +1 -0
  412. package/dist/observability/engine/redact.test.d.ts +2 -0
  413. package/dist/observability/engine/redact.test.d.ts.map +1 -0
  414. package/dist/observability/engine/redact.test.js +244 -0
  415. package/dist/observability/engine/redact.test.js.map +1 -0
  416. package/dist/observability/engine/stall.d.ts +13 -0
  417. package/dist/observability/engine/stall.d.ts.map +1 -0
  418. package/dist/observability/engine/stall.js +167 -0
  419. package/dist/observability/engine/stall.js.map +1 -0
  420. package/dist/observability/engine/stall.test.d.ts +2 -0
  421. package/dist/observability/engine/stall.test.d.ts.map +1 -0
  422. package/dist/observability/engine/stall.test.js +148 -0
  423. package/dist/observability/engine/stall.test.js.map +1 -0
  424. package/dist/observability/engine/synthesizer.d.ts +35 -0
  425. package/dist/observability/engine/synthesizer.d.ts.map +1 -0
  426. package/dist/observability/engine/synthesizer.js +298 -0
  427. package/dist/observability/engine/synthesizer.js.map +1 -0
  428. package/dist/observability/engine/synthesizer.test.d.ts +2 -0
  429. package/dist/observability/engine/synthesizer.test.d.ts.map +1 -0
  430. package/dist/observability/engine/synthesizer.test.js +183 -0
  431. package/dist/observability/engine/synthesizer.test.js.map +1 -0
  432. package/dist/observability/engine/types.d.ts +422 -0
  433. package/dist/observability/engine/types.d.ts.map +1 -0
  434. package/dist/observability/engine/types.js +3 -0
  435. package/dist/observability/engine/types.js.map +1 -0
  436. package/dist/observability/engine/types.test.d.ts +2 -0
  437. package/dist/observability/engine/types.test.d.ts.map +1 -0
  438. package/dist/observability/engine/types.test.js +16 -0
  439. package/dist/observability/engine/types.test.js.map +1 -0
  440. package/dist/observability/renderers/_lib.d.ts +7 -0
  441. package/dist/observability/renderers/_lib.d.ts.map +1 -0
  442. package/dist/observability/renderers/_lib.js +28 -0
  443. package/dist/observability/renderers/_lib.js.map +1 -0
  444. package/dist/observability/renderers/dashboard.d.ts +5 -0
  445. package/dist/observability/renderers/dashboard.d.ts.map +1 -0
  446. package/dist/observability/renderers/dashboard.js +100 -0
  447. package/dist/observability/renderers/dashboard.js.map +1 -0
  448. package/dist/observability/renderers/dashboard.test.d.ts +2 -0
  449. package/dist/observability/renderers/dashboard.test.d.ts.map +1 -0
  450. package/dist/observability/renderers/dashboard.test.js +142 -0
  451. package/dist/observability/renderers/dashboard.test.js.map +1 -0
  452. package/dist/observability/renderers/markdown.d.ts +4 -0
  453. package/dist/observability/renderers/markdown.d.ts.map +1 -0
  454. package/dist/observability/renderers/markdown.js +225 -0
  455. package/dist/observability/renderers/markdown.js.map +1 -0
  456. package/dist/observability/renderers/markdown.test.d.ts +2 -0
  457. package/dist/observability/renderers/markdown.test.d.ts.map +1 -0
  458. package/dist/observability/renderers/markdown.test.js +169 -0
  459. package/dist/observability/renderers/markdown.test.js.map +1 -0
  460. package/dist/observability/renderers/mmr-findings.d.ts +10 -0
  461. package/dist/observability/renderers/mmr-findings.d.ts.map +1 -0
  462. package/dist/observability/renderers/mmr-findings.js +21 -0
  463. package/dist/observability/renderers/mmr-findings.js.map +1 -0
  464. package/dist/observability/renderers/mmr-findings.test.d.ts +2 -0
  465. package/dist/observability/renderers/mmr-findings.test.d.ts.map +1 -0
  466. package/dist/observability/renderers/mmr-findings.test.js +86 -0
  467. package/dist/observability/renderers/mmr-findings.test.js.map +1 -0
  468. package/dist/observability/renderers/sidecar.d.ts +5 -0
  469. package/dist/observability/renderers/sidecar.d.ts.map +1 -0
  470. package/dist/observability/renderers/sidecar.js +51 -0
  471. package/dist/observability/renderers/sidecar.js.map +1 -0
  472. package/dist/observability/renderers/sidecar.test.d.ts +2 -0
  473. package/dist/observability/renderers/sidecar.test.d.ts.map +1 -0
  474. package/dist/observability/renderers/sidecar.test.js +77 -0
  475. package/dist/observability/renderers/sidecar.test.js.map +1 -0
  476. package/dist/observability/renderers/terminal.d.ts +7 -0
  477. package/dist/observability/renderers/terminal.d.ts.map +1 -0
  478. package/dist/observability/renderers/terminal.js +96 -0
  479. package/dist/observability/renderers/terminal.js.map +1 -0
  480. package/dist/observability/renderers/terminal.test.d.ts +2 -0
  481. package/dist/observability/renderers/terminal.test.d.ts.map +1 -0
  482. package/dist/observability/renderers/terminal.test.js +163 -0
  483. package/dist/observability/renderers/terminal.test.js.map +1 -0
  484. package/dist/state/state-manager.d.ts +7 -2
  485. package/dist/state/state-manager.d.ts.map +1 -1
  486. package/dist/state/state-manager.js +31 -2
  487. package/dist/state/state-manager.js.map +1 -1
  488. package/dist/state/state-manager.test.js +88 -3
  489. package/dist/state/state-manager.test.js.map +1 -1
  490. package/dist/types/state.d.ts +2 -0
  491. package/dist/types/state.d.ts.map +1 -1
  492. package/package.json +16 -1
@@ -0,0 +1,85 @@
1
+ import { access, readFile, readdir, stat } from 'node:fs/promises';
2
+ import { join } from 'node:path';
3
+ const JOBS_DIR = '.mmr/jobs';
4
+ async function listResultFiles(cwd) {
5
+ const dir = join(cwd, JOBS_DIR);
6
+ try {
7
+ await access(dir);
8
+ }
9
+ catch {
10
+ return [];
11
+ }
12
+ const subs = await readdir(dir);
13
+ const results = await Promise.all(subs.map(async (sub) => {
14
+ const p = join(dir, sub, 'result.json');
15
+ try {
16
+ await access(p);
17
+ return p;
18
+ }
19
+ catch {
20
+ return null;
21
+ }
22
+ }));
23
+ return results.filter((p) => p !== null);
24
+ }
25
+ export const mmrAdapter = {
26
+ id: 'mmr',
27
+ async probe(cwd) {
28
+ const files = await listResultFiles(cwd);
29
+ if (files.length === 0)
30
+ return { status: 'unavailable', reason: 'no MMR jobs found in .mmr/jobs/' };
31
+ return { status: 'available', evidence_paths: files.slice(-1) };
32
+ },
33
+ async mostRecentJob(cwd) {
34
+ const files = await listResultFiles(cwd);
35
+ if (files.length === 0)
36
+ return null;
37
+ const withMtime = await Promise.all(files.map(async (f) => ({ f, mtime: (await stat(f)).mtimeMs })));
38
+ withMtime.sort((a, b) => b.mtime - a.mtime);
39
+ try {
40
+ return JSON.parse(await readFile(withMtime[0].f, 'utf8'));
41
+ }
42
+ catch {
43
+ return null;
44
+ }
45
+ },
46
+ async replayEvents(cwd, opts) {
47
+ const dir = join(cwd, JOBS_DIR);
48
+ try {
49
+ await access(dir);
50
+ }
51
+ catch {
52
+ return [];
53
+ }
54
+ const cutoff = new Date(Date.now() - opts.sinceHours * 3_600_000).toISOString();
55
+ const subs = await readdir(dir);
56
+ const out = [];
57
+ await Promise.all(subs.map(async (sub) => {
58
+ const p = join(dir, sub, 'result.json');
59
+ try {
60
+ await access(p);
61
+ }
62
+ catch {
63
+ return;
64
+ }
65
+ let job;
66
+ try {
67
+ job = JSON.parse(await readFile(p, 'utf8'));
68
+ }
69
+ catch {
70
+ return;
71
+ }
72
+ if (!job.completed_at || job.completed_at < cutoff)
73
+ return;
74
+ out.push({
75
+ sort_id: `mmr:${sub}`,
76
+ correlation_id: null,
77
+ ts: job.completed_at,
78
+ source: 'mmr', kind: 'job_completed',
79
+ summary: `MMR job ${sub} verdict=${job.verdict}`,
80
+ });
81
+ }));
82
+ return out;
83
+ },
84
+ };
85
+ //# sourceMappingURL=mmr.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mmr.js","sourceRoot":"","sources":["../../../src/observability/adapters/mmr.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=mmr.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mmr.test.d.ts","sourceRoot":"","sources":["../../../src/observability/adapters/mmr.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,55 @@
1
+ import { describe, it, expect, beforeEach, afterEach } from 'vitest';
2
+ import { mkdtempSync, rmSync, writeFileSync, mkdirSync } from 'node:fs';
3
+ import { tmpdir } from 'node:os';
4
+ import { join } from 'node:path';
5
+ import { mmrAdapter } from './mmr.js';
6
+ describe('mmr adapter', () => {
7
+ let dir;
8
+ beforeEach(() => { dir = mkdtempSync(join(tmpdir(), 'observe-mmr-')); });
9
+ afterEach(() => { rmSync(dir, { recursive: true, force: true }); });
10
+ it('probe returns unavailable when .mmr/jobs/ has no result.json files', async () => {
11
+ expect((await mmrAdapter.probe(dir)).status).toBe('unavailable');
12
+ });
13
+ it('probe returns available when at least one job result.json exists', async () => {
14
+ const job = join(dir, '.mmr/jobs/job-001');
15
+ mkdirSync(job, { recursive: true });
16
+ writeFileSync(join(job, 'result.json'), JSON.stringify({ verdict: 'pass', completed_at: '2026-04-30T00:00:00Z' }));
17
+ const s = await mmrAdapter.probe(dir);
18
+ expect(s.status).toBe('available');
19
+ });
20
+ it('mostRecentJob returns the newest result.json by mtime', async () => {
21
+ const a = join(dir, '.mmr/jobs/a');
22
+ mkdirSync(a, { recursive: true });
23
+ writeFileSync(join(a, 'result.json'), JSON.stringify({ verdict: 'pass', completed_at: '2026-04-29T00:00:00Z' }));
24
+ await new Promise((r) => setTimeout(r, 50));
25
+ const b = join(dir, '.mmr/jobs/b');
26
+ mkdirSync(b, { recursive: true });
27
+ writeFileSync(join(b, 'result.json'), JSON.stringify({ verdict: 'blocked', completed_at: '2026-04-30T00:00:00Z' }));
28
+ const j = await mmrAdapter.mostRecentJob(dir);
29
+ expect(j?.verdict).toBe('blocked');
30
+ });
31
+ });
32
+ describe('mmr adapter — replayEvents', () => {
33
+ let dir;
34
+ beforeEach(() => { dir = mkdtempSync(join(tmpdir(), 'observe-mmr-rep-')); });
35
+ afterEach(() => { rmSync(dir, { recursive: true, force: true }); });
36
+ it('returns ReplayEvent[] for completed MMR jobs', async () => {
37
+ const a = join(dir, '.mmr/jobs/job-a');
38
+ mkdirSync(a, { recursive: true });
39
+ const recentTs = new Date(Date.now() - 1 * 3_600_000).toISOString();
40
+ writeFileSync(join(a, 'result.json'), JSON.stringify({ verdict: 'pass', completed_at: recentTs, fix_threshold: 'P2' }));
41
+ const b = join(dir, '.mmr/jobs/job-b');
42
+ mkdirSync(b, { recursive: true });
43
+ writeFileSync(join(b, 'result.json'), JSON.stringify({ verdict: 'blocked', completed_at: recentTs }));
44
+ const events = await mmrAdapter.replayEvents(dir, { sinceHours: 24 });
45
+ expect(events).toHaveLength(2);
46
+ expect(events[0].source).toBe('mmr');
47
+ expect(events[0].kind).toBe('job_completed');
48
+ expect(events.find((e) => e.sort_id === 'mmr:job-a')?.summary).toContain('pass');
49
+ expect(events.find((e) => e.sort_id === 'mmr:job-b')?.summary).toContain('blocked');
50
+ });
51
+ it('returns [] when no jobs in window', async () => {
52
+ expect(await mmrAdapter.replayEvents(dir, { sinceHours: 24 })).toEqual([]);
53
+ });
54
+ });
55
+ //# sourceMappingURL=mmr.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mmr.test.js","sourceRoot":"","sources":["../../../src/observability/adapters/mmr.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ import type { BaseAdapter } from './types.js';
2
+ export type ArtifactKey = 'prd' | 'user_stories' | 'tech_stack' | 'coding_standards' | 'tdd_standards' | 'design_system' | 'implementation_plan' | 'implementation_playbook' | 'story_tests_map';
3
+ export declare const PIPELINE_ARTIFACTS: Record<ArtifactKey, string[]>;
4
+ export type ArtifactBundle = Record<ArtifactKey, string | null>;
5
+ export declare const pipelineDocsAdapter: BaseAdapter & {
6
+ readArtifacts(cwd: string): Promise<ArtifactBundle>;
7
+ };
8
+ //# sourceMappingURL=pipeline-docs.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pipeline-docs.d.ts","sourceRoot":"","sources":["../../../src/observability/adapters/pipeline-docs.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAiB,WAAW,EAAE,MAAM,YAAY,CAAA;AAE5D,MAAM,MAAM,WAAW,GACnB,KAAK,GAAG,cAAc,GAAG,YAAY,GAAG,kBAAkB,GAC1D,eAAe,GAAG,eAAe,GAAG,qBAAqB,GACzD,yBAAyB,GAAG,iBAAiB,CAAA;AAGjD,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,CAU5D,CAAA;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC,CAAA;AAkB/D,eAAO,MAAM,mBAAmB,EAAE,WAAW,GAAG;IAC9C,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;CAoCpD,CAAA"}
@@ -0,0 +1,68 @@
1
+ import { access, stat, readFile } from 'node:fs/promises';
2
+ import { join } from 'node:path';
3
+ // Each role resolves from multiple candidate paths; first match wins.
4
+ export const PIPELINE_ARTIFACTS = {
5
+ prd: ['docs/plan.md', 'docs/prd.md'],
6
+ user_stories: ['docs/user-stories.md'],
7
+ tech_stack: ['docs/tech-stack.md'],
8
+ coding_standards: ['docs/coding-standards.md'],
9
+ tdd_standards: ['docs/tdd-standards.md'],
10
+ design_system: ['docs/design-system.md'],
11
+ implementation_plan: ['docs/implementation-plan.md'],
12
+ implementation_playbook: ['docs/implementation-playbook.md'],
13
+ story_tests_map: ['docs/story-tests-map.md'],
14
+ };
15
+ const CANONICAL_REQUIRED = [
16
+ 'prd', 'user_stories', 'implementation_plan', 'tech_stack', 'coding_standards',
17
+ ];
18
+ async function firstExistingCandidate(cwd, candidates) {
19
+ for (const rel of candidates) {
20
+ const abs = join(cwd, rel);
21
+ try {
22
+ await access(abs);
23
+ const s = await stat(abs);
24
+ if (s.size > 0)
25
+ return rel;
26
+ }
27
+ catch { /* not found or empty */ }
28
+ }
29
+ return null;
30
+ }
31
+ export const pipelineDocsAdapter = {
32
+ id: 'pipeline_docs',
33
+ async probe(cwd) {
34
+ const entries = Object.entries(PIPELINE_ARTIFACTS);
35
+ const results = await Promise.all(entries.map(async ([k, candidates]) => ({
36
+ k,
37
+ found: await firstExistingCandidate(cwd, candidates),
38
+ })));
39
+ const present = [];
40
+ let canonicalCount = 0;
41
+ for (const { k, found } of results) {
42
+ if (found) {
43
+ present.push(found);
44
+ if (CANONICAL_REQUIRED.includes(k))
45
+ canonicalCount++;
46
+ }
47
+ }
48
+ if (present.length === 0)
49
+ return { status: 'unavailable', reason: 'no docs/*.md planning artifacts found' };
50
+ if (canonicalCount === CANONICAL_REQUIRED.length)
51
+ return { status: 'available', evidence_paths: present };
52
+ return {
53
+ status: 'degraded',
54
+ reason: `${canonicalCount}/${CANONICAL_REQUIRED.length} canonical artifacts present`,
55
+ evidence_paths: present,
56
+ };
57
+ },
58
+ async readArtifacts(cwd) {
59
+ const entries = Object.entries(PIPELINE_ARTIFACTS);
60
+ const results = await Promise.all(entries.map(async ([k, candidates]) => {
61
+ const found = await firstExistingCandidate(cwd, candidates);
62
+ const content = found ? await readFile(join(cwd, found), 'utf8').catch(() => null) : null;
63
+ return [k, content];
64
+ }));
65
+ return Object.fromEntries(results);
66
+ },
67
+ };
68
+ //# sourceMappingURL=pipeline-docs.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pipeline-docs.js","sourceRoot":"","sources":["../../../src/observability/adapters/pipeline-docs.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=pipeline-docs.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pipeline-docs.test.d.ts","sourceRoot":"","sources":["../../../src/observability/adapters/pipeline-docs.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,58 @@
1
+ import { describe, it, expect, beforeEach, afterEach } from 'vitest';
2
+ import { mkdtempSync, rmSync, writeFileSync, mkdirSync } from 'node:fs';
3
+ import { tmpdir } from 'node:os';
4
+ import { join } from 'node:path';
5
+ import { pipelineDocsAdapter } from './pipeline-docs.js';
6
+ describe('pipeline_docs adapter', () => {
7
+ let dir;
8
+ beforeEach(() => { dir = mkdtempSync(join(tmpdir(), 'observe-pd-')); });
9
+ afterEach(() => { rmSync(dir, { recursive: true, force: true }); });
10
+ it('probe returns unavailable when no planning docs exist', async () => {
11
+ const s = await pipelineDocsAdapter.probe(dir);
12
+ expect(s.status).toBe('unavailable');
13
+ });
14
+ it('probe returns degraded when only some artifacts exist (PRD at docs/plan.md)', async () => {
15
+ mkdirSync(join(dir, 'docs'), { recursive: true });
16
+ writeFileSync(join(dir, 'docs/plan.md'), '# PRD\n');
17
+ const s = await pipelineDocsAdapter.probe(dir);
18
+ expect(s.status).toBe('degraded');
19
+ expect(s.evidence_paths).toEqual(['docs/plan.md']);
20
+ });
21
+ it('probe accepts the legacy docs/prd.md as a back-compat fallback', async () => {
22
+ mkdirSync(join(dir, 'docs'), { recursive: true });
23
+ writeFileSync(join(dir, 'docs/prd.md'), '# PRD (legacy path)\n');
24
+ const s = await pipelineDocsAdapter.probe(dir);
25
+ expect(s.status).toBe('degraded');
26
+ expect(s.evidence_paths).toEqual(['docs/prd.md']);
27
+ });
28
+ it('probe returns available when the canonical artifact set is present', async () => {
29
+ mkdirSync(join(dir, 'docs'), { recursive: true });
30
+ const canonical = ['plan.md', 'user-stories.md', 'implementation-plan.md', 'tech-stack.md', 'coding-standards.md'];
31
+ for (const name of canonical) {
32
+ writeFileSync(join(dir, 'docs', name), `# ${name}\n`);
33
+ }
34
+ const s = await pipelineDocsAdapter.probe(dir);
35
+ expect(s.status).toBe('available');
36
+ });
37
+ it('readArtifacts returns prd from docs/plan.md when present', async () => {
38
+ mkdirSync(join(dir, 'docs'), { recursive: true });
39
+ writeFileSync(join(dir, 'docs/plan.md'), '# PRD body (canonical)\n');
40
+ const out = await pipelineDocsAdapter.readArtifacts(dir);
41
+ expect(out.prd).toBe('# PRD body (canonical)\n');
42
+ expect(out.user_stories).toBeNull();
43
+ });
44
+ it('readArtifacts falls back to docs/prd.md when docs/plan.md is absent', async () => {
45
+ mkdirSync(join(dir, 'docs'), { recursive: true });
46
+ writeFileSync(join(dir, 'docs/prd.md'), '# PRD body\n');
47
+ const out = await pipelineDocsAdapter.readArtifacts(dir);
48
+ expect(out.prd).toBe('# PRD body\n');
49
+ });
50
+ it('readArtifacts prefers docs/plan.md over docs/prd.md when both exist', async () => {
51
+ mkdirSync(join(dir, 'docs'), { recursive: true });
52
+ writeFileSync(join(dir, 'docs/plan.md'), '# canonical\n');
53
+ writeFileSync(join(dir, 'docs/prd.md'), '# legacy\n');
54
+ const out = await pipelineDocsAdapter.readArtifacts(dir);
55
+ expect(out.prd).toBe('# canonical\n');
56
+ });
57
+ });
58
+ //# sourceMappingURL=pipeline-docs.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pipeline-docs.test.js","sourceRoot":"","sources":["../../../src/observability/adapters/pipeline-docs.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ import type { BaseAdapter } from './types.js';
2
+ export interface StepEntry {
3
+ status: 'pending' | 'in_progress' | 'completed' | 'skipped';
4
+ source?: 'pipeline' | 'manual';
5
+ produces?: string[];
6
+ completed_at?: string;
7
+ in_progress_started_at?: string;
8
+ }
9
+ export interface MergedState {
10
+ version?: string;
11
+ methodology?: string;
12
+ steps: Record<string, StepEntry>;
13
+ }
14
+ import type { ReplayEvent } from '../engine/types.js';
15
+ export declare const stateAdapter: BaseAdapter & {
16
+ readMergedState(cwd: string): Promise<MergedState>;
17
+ replayEvents(cwd: string, opts: {
18
+ sinceHours: number;
19
+ }): Promise<ReplayEvent[]>;
20
+ };
21
+ //# sourceMappingURL=state.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/observability/adapters/state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAiB,WAAW,EAAE,MAAM,YAAY,CAAA;AAE5D,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAA;IAC3D,MAAM,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAA;IAC9B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAChC;AACD,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;CACjC;AAQD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAErD,eAAO,MAAM,YAAY,EAAE,WAAW,GAAG;IACvC,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;IAClD,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAA;CAqEhF,CAAA"}
@@ -0,0 +1,87 @@
1
+ import { access, readFile, readdir, stat } from 'node:fs/promises';
2
+ import { join } from 'node:path';
3
+ const ROOT_STATE = '.scaffold/state.json';
4
+ async function safeReadJson(path) {
5
+ try {
6
+ return JSON.parse(await readFile(path, 'utf8'));
7
+ }
8
+ catch {
9
+ return null;
10
+ }
11
+ }
12
+ export const stateAdapter = {
13
+ id: 'state',
14
+ async probe(cwd) {
15
+ try {
16
+ await access(join(cwd, ROOT_STATE));
17
+ }
18
+ catch {
19
+ return { status: 'unavailable', reason: 'no .scaffold/state.json' };
20
+ }
21
+ return { status: 'available', evidence_paths: [ROOT_STATE] };
22
+ },
23
+ async readMergedState(cwd) {
24
+ const merged = { steps: {} };
25
+ const root = await safeReadJson(join(cwd, ROOT_STATE));
26
+ if (root) {
27
+ if (root.version)
28
+ merged.version = root.version;
29
+ if (root.methodology)
30
+ merged.methodology = root.methodology;
31
+ Object.assign(merged.steps, root.steps ?? {});
32
+ }
33
+ const servicesDir = join(cwd, '.scaffold', 'services');
34
+ try {
35
+ const svcStat = await stat(servicesDir);
36
+ if (!svcStat.isDirectory())
37
+ return merged;
38
+ const svcs = await readdir(servicesDir);
39
+ await Promise.all(svcs.map(async (svc) => {
40
+ const svcPath = join(servicesDir, svc, 'state.json');
41
+ const svcState = await safeReadJson(svcPath);
42
+ if (!svcState?.steps)
43
+ return;
44
+ for (const [slug, entry] of Object.entries(svcState.steps)) {
45
+ merged.steps[`${slug}@${svc}`] = entry;
46
+ }
47
+ }));
48
+ }
49
+ catch {
50
+ // no services dir — fine
51
+ }
52
+ return merged;
53
+ },
54
+ async replayEvents(cwd, opts) {
55
+ const path = join(cwd, ROOT_STATE);
56
+ let fallbackTs;
57
+ try {
58
+ const s = await stat(path);
59
+ fallbackTs = s.mtime.toISOString();
60
+ }
61
+ catch {
62
+ return [];
63
+ }
64
+ const cutoff = new Date(Date.now() - opts.sinceHours * 3_600_000).toISOString();
65
+ const merged = await stateAdapter.readMergedState(cwd);
66
+ const out = [];
67
+ for (const [slug, entry] of Object.entries(merged.steps)) {
68
+ if (entry.status !== 'completed' && entry.status !== 'in_progress')
69
+ continue;
70
+ const ts = entry.status === 'completed'
71
+ ? (entry.completed_at ?? fallbackTs)
72
+ : (entry.in_progress_started_at ?? fallbackTs);
73
+ if (ts < cutoff)
74
+ continue;
75
+ const kind = entry.status === 'completed' ? 'step_completed' : 'step_in_progress';
76
+ out.push({
77
+ sort_id: `state:${slug}:${entry.status}`,
78
+ correlation_id: null,
79
+ ts,
80
+ source: 'state', kind,
81
+ summary: `pipeline step ${slug} → ${entry.status}`,
82
+ });
83
+ }
84
+ return out;
85
+ },
86
+ };
87
+ //# sourceMappingURL=state.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/observability/adapters/state.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=state.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"state.test.d.ts","sourceRoot":"","sources":["../../../src/observability/adapters/state.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,92 @@
1
+ import { describe, it, expect, beforeEach, afterEach } from 'vitest';
2
+ import { mkdtempSync, rmSync, writeFileSync, mkdirSync } from 'node:fs';
3
+ import { tmpdir } from 'node:os';
4
+ import { join } from 'node:path';
5
+ import { stateAdapter } from './state.js';
6
+ describe('state adapter', () => {
7
+ let dir;
8
+ beforeEach(() => { dir = mkdtempSync(join(tmpdir(), 'observe-s-')); });
9
+ afterEach(() => { rmSync(dir, { recursive: true, force: true }); });
10
+ it('probe returns unavailable when no state.json exists', async () => {
11
+ expect((await stateAdapter.probe(dir)).status).toBe('unavailable');
12
+ });
13
+ it('readMergedState returns root state when services dir is absent', async () => {
14
+ mkdirSync(join(dir, '.scaffold'), { recursive: true });
15
+ writeFileSync(join(dir, '.scaffold/state.json'), JSON.stringify({
16
+ version: '1.0',
17
+ methodology: 'deep',
18
+ steps: { 'user-stories': { status: 'completed', source: 'pipeline', produces: ['docs/user-stories.md'] } },
19
+ }));
20
+ const merged = await stateAdapter.readMergedState(dir);
21
+ expect(merged.steps['user-stories'].status).toBe('completed');
22
+ });
23
+ it('readMergedState merges service-scoped state under each service step', async () => {
24
+ mkdirSync(join(dir, '.scaffold/services/api'), { recursive: true });
25
+ const rootState = JSON.stringify({ steps: { 'tech-stack': { status: 'completed' } } });
26
+ writeFileSync(join(dir, '.scaffold/state.json'), rootState);
27
+ writeFileSync(join(dir, '.scaffold/services/api/state.json'), JSON.stringify({ steps: { 'coding-standards': { status: 'in_progress' } } }));
28
+ const merged = await stateAdapter.readMergedState(dir);
29
+ expect(merged.steps['tech-stack'].status).toBe('completed');
30
+ expect(merged.steps['coding-standards@api'].status).toBe('in_progress');
31
+ });
32
+ });
33
+ describe('state adapter — replayEvents', () => {
34
+ let dir;
35
+ beforeEach(() => { dir = mkdtempSync(join(tmpdir(), 'observe-st-rep-')); });
36
+ afterEach(() => { rmSync(dir, { recursive: true, force: true }); });
37
+ it('returns ReplayEvents for completed and in_progress steps using state.json mtime', async () => {
38
+ mkdirSync(join(dir, '.scaffold'), { recursive: true });
39
+ writeFileSync(join(dir, '.scaffold/state.json'), JSON.stringify({
40
+ version: '1.0', methodology: 'deep',
41
+ steps: {
42
+ 'user-stories': { status: 'completed', source: 'pipeline' },
43
+ 'tech-stack': { status: 'in_progress', source: 'pipeline' },
44
+ 'coding-standards': { status: 'pending', source: 'pipeline' },
45
+ },
46
+ }));
47
+ const events = await stateAdapter.replayEvents(dir, { sinceHours: 24 });
48
+ const slugs = events.map((e) => e.kind);
49
+ expect(slugs).toContain('step_completed');
50
+ expect(slugs).toContain('step_in_progress');
51
+ expect(slugs).not.toContain('step_pending');
52
+ expect(events[0].source).toBe('state');
53
+ expect(events.find((e) => e.kind === 'step_completed')?.sort_id).toBe('state:user-stories:completed');
54
+ });
55
+ it('returns [] when state.json does not exist', async () => {
56
+ expect(await stateAdapter.replayEvents(dir, { sinceHours: 24 })).toEqual([]);
57
+ });
58
+ });
59
+ describe('state adapter — replayEvents with real timestamps (Plan 6)', () => {
60
+ let dir;
61
+ beforeEach(() => { dir = mkdtempSync(join(tmpdir(), 'observe-st-rt-')); });
62
+ afterEach(() => { rmSync(dir, { recursive: true, force: true }); });
63
+ it('uses StepEntry.completed_at for step_completed events when available', async () => {
64
+ mkdirSync(join(dir, '.scaffold'), { recursive: true });
65
+ writeFileSync(join(dir, '.scaffold/state.json'), JSON.stringify({
66
+ version: '1.0', methodology: 'deep',
67
+ steps: {
68
+ 'user-stories': { status: 'completed', source: 'pipeline', completed_at: '2026-05-04T10:30:00.000Z' },
69
+ 'tech-stack': {
70
+ status: 'in_progress', source: 'pipeline', in_progress_started_at: '2026-05-04T13:45:00.000Z',
71
+ },
72
+ 'coding-standards': { status: 'pending', source: 'pipeline' },
73
+ },
74
+ }));
75
+ const events = await stateAdapter.replayEvents(dir, { sinceHours: 24 * 365 });
76
+ const completed = events.find((e) => e.kind === 'step_completed');
77
+ const inProgress = events.find((e) => e.kind === 'step_in_progress');
78
+ expect(completed?.ts).toBe('2026-05-04T10:30:00.000Z');
79
+ expect(inProgress?.ts).toBe('2026-05-04T13:45:00.000Z');
80
+ });
81
+ it('falls back to file mtime when timestamps are absent', async () => {
82
+ mkdirSync(join(dir, '.scaffold'), { recursive: true });
83
+ writeFileSync(join(dir, '.scaffold/state.json'), JSON.stringify({
84
+ version: '1.0', methodology: 'deep',
85
+ steps: { 'user-stories': { status: 'completed', source: 'pipeline' } },
86
+ }));
87
+ const events = await stateAdapter.replayEvents(dir, { sinceHours: 24 });
88
+ expect(events).toHaveLength(1);
89
+ expect(events[0].ts).toMatch(/^\d{4}-\d{2}-\d{2}T/);
90
+ });
91
+ });
92
+ //# sourceMappingURL=state.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"state.test.js","sourceRoot":"","sources":["../../../src/observability/adapters/state.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,20 @@
1
+ import type { BaseAdapter } from './types.js';
2
+ import type { ReplayEvent } from '../engine/types.js';
3
+ export interface TestResult {
4
+ name: string;
5
+ file_path: string;
6
+ status: 'passing' | 'failing' | 'skipped' | 'unknown';
7
+ }
8
+ export interface TestRun {
9
+ ran_at: string;
10
+ passed: number;
11
+ failed: number;
12
+ results: TestResult[];
13
+ }
14
+ export declare const testsAdapter: BaseAdapter & {
15
+ lastRun(cwd: string): Promise<TestRun | null>;
16
+ replayEvents(cwd: string, opts: {
17
+ sinceHours: number;
18
+ }): Promise<ReplayEvent[]>;
19
+ };
20
+ //# sourceMappingURL=tests.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tests.d.ts","sourceRoot":"","sources":["../../../src/observability/adapters/tests.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAiB,WAAW,EAAE,MAAM,YAAY,CAAA;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAErD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAA;CACtD;AAED,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,UAAU,EAAE,CAAA;CACtB;AAID,eAAO,MAAM,YAAY,EAAE,WAAW,GAAG;IACvC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAA;IAC7C,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAA;CA+ChF,CAAA"}