@accelerator-mzq/forge 1.4.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 (663) hide show
  1. package/LICENSE +21 -0
  2. package/LICENSE-THIRD-PARTY.md +50 -0
  3. package/README.md +159 -0
  4. package/dist/cli/commands/ack.d.ts +7 -0
  5. package/dist/cli/commands/ack.d.ts.map +1 -0
  6. package/dist/cli/commands/ack.js +223 -0
  7. package/dist/cli/commands/ack.js.map +1 -0
  8. package/dist/cli/commands/archive.d.ts +44 -0
  9. package/dist/cli/commands/archive.d.ts.map +1 -0
  10. package/dist/cli/commands/archive.js +689 -0
  11. package/dist/cli/commands/archive.js.map +1 -0
  12. package/dist/cli/commands/backlog.d.ts +3 -0
  13. package/dist/cli/commands/backlog.d.ts.map +1 -0
  14. package/dist/cli/commands/backlog.js +55 -0
  15. package/dist/cli/commands/backlog.js.map +1 -0
  16. package/dist/cli/commands/config.d.ts +3 -0
  17. package/dist/cli/commands/config.d.ts.map +1 -0
  18. package/dist/cli/commands/config.js +107 -0
  19. package/dist/cli/commands/config.js.map +1 -0
  20. package/dist/cli/commands/evidence.d.ts +7 -0
  21. package/dist/cli/commands/evidence.d.ts.map +1 -0
  22. package/dist/cli/commands/evidence.js +662 -0
  23. package/dist/cli/commands/evidence.js.map +1 -0
  24. package/dist/cli/commands/finding.d.ts +3 -0
  25. package/dist/cli/commands/finding.d.ts.map +1 -0
  26. package/dist/cli/commands/finding.js +93 -0
  27. package/dist/cli/commands/finding.js.map +1 -0
  28. package/dist/cli/commands/init.d.ts +3 -0
  29. package/dist/cli/commands/init.d.ts.map +1 -0
  30. package/dist/cli/commands/init.js +126 -0
  31. package/dist/cli/commands/init.js.map +1 -0
  32. package/dist/cli/commands/legacy-bridge.d.ts +11 -0
  33. package/dist/cli/commands/legacy-bridge.d.ts.map +1 -0
  34. package/dist/cli/commands/legacy-bridge.js +586 -0
  35. package/dist/cli/commands/legacy-bridge.js.map +1 -0
  36. package/dist/cli/commands/migrate.d.ts +3 -0
  37. package/dist/cli/commands/migrate.d.ts.map +1 -0
  38. package/dist/cli/commands/migrate.js +34 -0
  39. package/dist/cli/commands/migrate.js.map +1 -0
  40. package/dist/cli/commands/monitor.d.ts +3 -0
  41. package/dist/cli/commands/monitor.d.ts.map +1 -0
  42. package/dist/cli/commands/monitor.js +113 -0
  43. package/dist/cli/commands/monitor.js.map +1 -0
  44. package/dist/cli/commands/preflight.d.ts +7 -0
  45. package/dist/cli/commands/preflight.d.ts.map +1 -0
  46. package/dist/cli/commands/preflight.js +63 -0
  47. package/dist/cli/commands/preflight.js.map +1 -0
  48. package/dist/cli/commands/scope.d.ts +3 -0
  49. package/dist/cli/commands/scope.d.ts.map +1 -0
  50. package/dist/cli/commands/scope.js +32 -0
  51. package/dist/cli/commands/scope.js.map +1 -0
  52. package/dist/cli/commands/stage-extensions.d.ts +45 -0
  53. package/dist/cli/commands/stage-extensions.d.ts.map +1 -0
  54. package/dist/cli/commands/stage-extensions.js +590 -0
  55. package/dist/cli/commands/stage-extensions.js.map +1 -0
  56. package/dist/cli/commands/update.d.ts +3 -0
  57. package/dist/cli/commands/update.d.ts.map +1 -0
  58. package/dist/cli/commands/update.js +98 -0
  59. package/dist/cli/commands/update.js.map +1 -0
  60. package/dist/cli/commands/upgrade.d.ts +3 -0
  61. package/dist/cli/commands/upgrade.d.ts.map +1 -0
  62. package/dist/cli/commands/upgrade.js +277 -0
  63. package/dist/cli/commands/upgrade.js.map +1 -0
  64. package/dist/cli/commands/validate.d.ts +3 -0
  65. package/dist/cli/commands/validate.d.ts.map +1 -0
  66. package/dist/cli/commands/validate.js +66 -0
  67. package/dist/cli/commands/validate.js.map +1 -0
  68. package/dist/cli/index.d.ts +3 -0
  69. package/dist/cli/index.d.ts.map +1 -0
  70. package/dist/cli/index.js +69 -0
  71. package/dist/cli/index.js.map +1 -0
  72. package/dist/core/ack-log.d.ts +107 -0
  73. package/dist/core/ack-log.d.ts.map +1 -0
  74. package/dist/core/ack-log.js +197 -0
  75. package/dist/core/ack-log.js.map +1 -0
  76. package/dist/core/archive/ack-log-consistency.d.ts +15 -0
  77. package/dist/core/archive/ack-log-consistency.d.ts.map +1 -0
  78. package/dist/core/archive/ack-log-consistency.js +164 -0
  79. package/dist/core/archive/ack-log-consistency.js.map +1 -0
  80. package/dist/core/archive/fence.d.ts +66 -0
  81. package/dist/core/archive/fence.d.ts.map +1 -0
  82. package/dist/core/archive/fence.js +218 -0
  83. package/dist/core/archive/fence.js.map +1 -0
  84. package/dist/core/archive/index.d.ts +4 -0
  85. package/dist/core/archive/index.d.ts.map +1 -0
  86. package/dist/core/archive/index.js +6 -0
  87. package/dist/core/archive/index.js.map +1 -0
  88. package/dist/core/archive/legacy-exemption.d.ts +14 -0
  89. package/dist/core/archive/legacy-exemption.d.ts.map +1 -0
  90. package/dist/core/archive/legacy-exemption.js +82 -0
  91. package/dist/core/archive/legacy-exemption.js.map +1 -0
  92. package/dist/core/archive/lock.d.ts +46 -0
  93. package/dist/core/archive/lock.d.ts.map +1 -0
  94. package/dist/core/archive/lock.js +98 -0
  95. package/dist/core/archive/lock.js.map +1 -0
  96. package/dist/core/archive/pause-decisions-fence.d.ts +13 -0
  97. package/dist/core/archive/pause-decisions-fence.d.ts.map +1 -0
  98. package/dist/core/archive/pause-decisions-fence.js +384 -0
  99. package/dist/core/archive/pause-decisions-fence.js.map +1 -0
  100. package/dist/core/archive/process-evidence-fence.d.ts +110 -0
  101. package/dist/core/archive/process-evidence-fence.d.ts.map +1 -0
  102. package/dist/core/archive/process-evidence-fence.js +449 -0
  103. package/dist/core/archive/process-evidence-fence.js.map +1 -0
  104. package/dist/core/archive/process-evidence-rerun.d.ts +9 -0
  105. package/dist/core/archive/process-evidence-rerun.d.ts.map +1 -0
  106. package/dist/core/archive/process-evidence-rerun.js +238 -0
  107. package/dist/core/archive/process-evidence-rerun.js.map +1 -0
  108. package/dist/core/archive/recover-prompt.d.ts +10 -0
  109. package/dist/core/archive/recover-prompt.d.ts.map +1 -0
  110. package/dist/core/archive/recover-prompt.js +29 -0
  111. package/dist/core/archive/recover-prompt.js.map +1 -0
  112. package/dist/core/archive/recover.d.ts +83 -0
  113. package/dist/core/archive/recover.d.ts.map +1 -0
  114. package/dist/core/archive/recover.js +219 -0
  115. package/dist/core/archive/recover.js.map +1 -0
  116. package/dist/core/archive/resume-summary.d.ts +22 -0
  117. package/dist/core/archive/resume-summary.d.ts.map +1 -0
  118. package/dist/core/archive/resume-summary.js +82 -0
  119. package/dist/core/archive/resume-summary.js.map +1 -0
  120. package/dist/core/archive/summary-builder.d.ts +28 -0
  121. package/dist/core/archive/summary-builder.d.ts.map +1 -0
  122. package/dist/core/archive/summary-builder.js +287 -0
  123. package/dist/core/archive/summary-builder.js.map +1 -0
  124. package/dist/core/archive/summary-render.d.ts +8 -0
  125. package/dist/core/archive/summary-render.d.ts.map +1 -0
  126. package/dist/core/archive/summary-render.js +64 -0
  127. package/dist/core/archive/summary-render.js.map +1 -0
  128. package/dist/core/archive/three-level-fence.d.ts +10 -0
  129. package/dist/core/archive/three-level-fence.d.ts.map +1 -0
  130. package/dist/core/archive/three-level-fence.js +93 -0
  131. package/dist/core/archive/three-level-fence.js.map +1 -0
  132. package/dist/core/archive/transaction.d.ts +41 -0
  133. package/dist/core/archive/transaction.d.ts.map +1 -0
  134. package/dist/core/archive/transaction.js +184 -0
  135. package/dist/core/archive/transaction.js.map +1 -0
  136. package/dist/core/archive/verify-findings-fence.d.ts +11 -0
  137. package/dist/core/archive/verify-findings-fence.d.ts.map +1 -0
  138. package/dist/core/archive/verify-findings-fence.js +80 -0
  139. package/dist/core/archive/verify-findings-fence.js.map +1 -0
  140. package/dist/core/archive/version-retrograde-fence.d.ts +10 -0
  141. package/dist/core/archive/version-retrograde-fence.d.ts.map +1 -0
  142. package/dist/core/archive/version-retrograde-fence.js +103 -0
  143. package/dist/core/archive/version-retrograde-fence.js.map +1 -0
  144. package/dist/core/artifact-graph/builder.d.ts +16 -0
  145. package/dist/core/artifact-graph/builder.d.ts.map +1 -0
  146. package/dist/core/artifact-graph/builder.js +32 -0
  147. package/dist/core/artifact-graph/builder.js.map +1 -0
  148. package/dist/core/artifact-graph/index.d.ts +3 -0
  149. package/dist/core/artifact-graph/index.d.ts.map +1 -0
  150. package/dist/core/artifact-graph/index.js +4 -0
  151. package/dist/core/artifact-graph/index.js.map +1 -0
  152. package/dist/core/artifact-graph/types.d.ts +14 -0
  153. package/dist/core/artifact-graph/types.d.ts.map +1 -0
  154. package/dist/core/artifact-graph/types.js +2 -0
  155. package/dist/core/artifact-graph/types.js.map +1 -0
  156. package/dist/core/backlog/assets/backlog-readme.md +11 -0
  157. package/dist/core/backlog/index.d.ts +20 -0
  158. package/dist/core/backlog/index.d.ts.map +1 -0
  159. package/dist/core/backlog/index.js +60 -0
  160. package/dist/core/backlog/index.js.map +1 -0
  161. package/dist/core/backlog/render.d.ts +51 -0
  162. package/dist/core/backlog/render.d.ts.map +1 -0
  163. package/dist/core/backlog/render.js +196 -0
  164. package/dist/core/backlog/render.js.map +1 -0
  165. package/dist/core/bootstrap/index.d.ts +2 -0
  166. package/dist/core/bootstrap/index.d.ts.map +1 -0
  167. package/dist/core/bootstrap/index.js +5 -0
  168. package/dist/core/bootstrap/index.js.map +1 -0
  169. package/dist/core/canonical-json.d.ts +11 -0
  170. package/dist/core/canonical-json.d.ts.map +1 -0
  171. package/dist/core/canonical-json.js +43 -0
  172. package/dist/core/canonical-json.js.map +1 -0
  173. package/dist/core/git/utils.d.ts +27 -0
  174. package/dist/core/git/utils.d.ts.map +1 -0
  175. package/dist/core/git/utils.js +53 -0
  176. package/dist/core/git/utils.js.map +1 -0
  177. package/dist/core/harness-adapters/claude.d.ts +13 -0
  178. package/dist/core/harness-adapters/claude.d.ts.map +1 -0
  179. package/dist/core/harness-adapters/claude.js +53 -0
  180. package/dist/core/harness-adapters/claude.js.map +1 -0
  181. package/dist/core/harness-adapters/codex.d.ts +14 -0
  182. package/dist/core/harness-adapters/codex.d.ts.map +1 -0
  183. package/dist/core/harness-adapters/codex.js +60 -0
  184. package/dist/core/harness-adapters/codex.js.map +1 -0
  185. package/dist/core/harness-adapters/detector.d.ts +15 -0
  186. package/dist/core/harness-adapters/detector.d.ts.map +1 -0
  187. package/dist/core/harness-adapters/detector.js +45 -0
  188. package/dist/core/harness-adapters/detector.js.map +1 -0
  189. package/dist/core/harness-adapters/hash-compare.d.ts +21 -0
  190. package/dist/core/harness-adapters/hash-compare.d.ts.map +1 -0
  191. package/dist/core/harness-adapters/hash-compare.js +49 -0
  192. package/dist/core/harness-adapters/hash-compare.js.map +1 -0
  193. package/dist/core/harness-adapters/index.d.ts +8 -0
  194. package/dist/core/harness-adapters/index.d.ts.map +1 -0
  195. package/dist/core/harness-adapters/index.js +8 -0
  196. package/dist/core/harness-adapters/index.js.map +1 -0
  197. package/dist/core/harness-adapters/interface.d.ts +52 -0
  198. package/dist/core/harness-adapters/interface.d.ts.map +1 -0
  199. package/dist/core/harness-adapters/interface.js +3 -0
  200. package/dist/core/harness-adapters/interface.js.map +1 -0
  201. package/dist/core/harness-adapters/legacy-detector.d.ts +14 -0
  202. package/dist/core/harness-adapters/legacy-detector.d.ts.map +1 -0
  203. package/dist/core/harness-adapters/legacy-detector.js +83 -0
  204. package/dist/core/harness-adapters/legacy-detector.js.map +1 -0
  205. package/dist/core/harness-adapters/transaction.d.ts +12 -0
  206. package/dist/core/harness-adapters/transaction.d.ts.map +1 -0
  207. package/dist/core/harness-adapters/transaction.js +113 -0
  208. package/dist/core/harness-adapters/transaction.js.map +1 -0
  209. package/dist/core/harness-adapters/types.d.ts +45 -0
  210. package/dist/core/harness-adapters/types.d.ts.map +1 -0
  211. package/dist/core/harness-adapters/types.js +3 -0
  212. package/dist/core/harness-adapters/types.js.map +1 -0
  213. package/dist/core/hash/content.d.ts +10 -0
  214. package/dist/core/hash/content.d.ts.map +1 -0
  215. package/dist/core/hash/content.js +131 -0
  216. package/dist/core/hash/content.js.map +1 -0
  217. package/dist/core/hash/diff.d.ts +26 -0
  218. package/dist/core/hash/diff.d.ts.map +1 -0
  219. package/dist/core/hash/diff.js +40 -0
  220. package/dist/core/hash/diff.js.map +1 -0
  221. package/dist/core/hash/index.d.ts +6 -0
  222. package/dist/core/hash/index.d.ts.map +1 -0
  223. package/dist/core/hash/index.js +7 -0
  224. package/dist/core/hash/index.js.map +1 -0
  225. package/dist/core/hash/log.d.ts +7 -0
  226. package/dist/core/hash/log.d.ts.map +1 -0
  227. package/dist/core/hash/log.js +14 -0
  228. package/dist/core/hash/log.js.map +1 -0
  229. package/dist/core/hash/tasks.d.ts +9 -0
  230. package/dist/core/hash/tasks.d.ts.map +1 -0
  231. package/dist/core/hash/tasks.js +20 -0
  232. package/dist/core/hash/tasks.js.map +1 -0
  233. package/dist/core/legacy-bridge/ack.d.ts +30 -0
  234. package/dist/core/legacy-bridge/ack.d.ts.map +1 -0
  235. package/dist/core/legacy-bridge/ack.js +133 -0
  236. package/dist/core/legacy-bridge/ack.js.map +1 -0
  237. package/dist/core/legacy-bridge/anchors.d.ts +15 -0
  238. package/dist/core/legacy-bridge/anchors.d.ts.map +1 -0
  239. package/dist/core/legacy-bridge/anchors.js +119 -0
  240. package/dist/core/legacy-bridge/anchors.js.map +1 -0
  241. package/dist/core/legacy-bridge/budget.d.ts +39 -0
  242. package/dist/core/legacy-bridge/budget.d.ts.map +1 -0
  243. package/dist/core/legacy-bridge/budget.js +83 -0
  244. package/dist/core/legacy-bridge/budget.js.map +1 -0
  245. package/dist/core/legacy-bridge/conflict.d.ts +44 -0
  246. package/dist/core/legacy-bridge/conflict.d.ts.map +1 -0
  247. package/dist/core/legacy-bridge/conflict.js +105 -0
  248. package/dist/core/legacy-bridge/conflict.js.map +1 -0
  249. package/dist/core/legacy-bridge/diff-report.d.ts +14 -0
  250. package/dist/core/legacy-bridge/diff-report.d.ts.map +1 -0
  251. package/dist/core/legacy-bridge/diff-report.js +105 -0
  252. package/dist/core/legacy-bridge/diff-report.js.map +1 -0
  253. package/dist/core/legacy-bridge/encoding.d.ts +42 -0
  254. package/dist/core/legacy-bridge/encoding.d.ts.map +1 -0
  255. package/dist/core/legacy-bridge/encoding.js +104 -0
  256. package/dist/core/legacy-bridge/encoding.js.map +1 -0
  257. package/dist/core/legacy-bridge/excel.d.ts +32 -0
  258. package/dist/core/legacy-bridge/excel.d.ts.map +1 -0
  259. package/dist/core/legacy-bridge/excel.js +124 -0
  260. package/dist/core/legacy-bridge/excel.js.map +1 -0
  261. package/dist/core/legacy-bridge/hash-anchor.d.ts +23 -0
  262. package/dist/core/legacy-bridge/hash-anchor.d.ts.map +1 -0
  263. package/dist/core/legacy-bridge/hash-anchor.js +55 -0
  264. package/dist/core/legacy-bridge/hash-anchor.js.map +1 -0
  265. package/dist/core/legacy-bridge/indexer.d.ts +28 -0
  266. package/dist/core/legacy-bridge/indexer.d.ts.map +1 -0
  267. package/dist/core/legacy-bridge/indexer.js +145 -0
  268. package/dist/core/legacy-bridge/indexer.js.map +1 -0
  269. package/dist/core/legacy-bridge/mapper.d.ts +40 -0
  270. package/dist/core/legacy-bridge/mapper.d.ts.map +1 -0
  271. package/dist/core/legacy-bridge/mapper.js +241 -0
  272. package/dist/core/legacy-bridge/mapper.js.map +1 -0
  273. package/dist/core/legacy-bridge/quality-judge.d.ts +65 -0
  274. package/dist/core/legacy-bridge/quality-judge.d.ts.map +1 -0
  275. package/dist/core/legacy-bridge/quality-judge.js +277 -0
  276. package/dist/core/legacy-bridge/quality-judge.js.map +1 -0
  277. package/dist/core/legacy-bridge/redact.d.ts +28 -0
  278. package/dist/core/legacy-bridge/redact.d.ts.map +1 -0
  279. package/dist/core/legacy-bridge/redact.js +121 -0
  280. package/dist/core/legacy-bridge/redact.js.map +1 -0
  281. package/dist/core/legacy-bridge/regenerator.d.ts +50 -0
  282. package/dist/core/legacy-bridge/regenerator.d.ts.map +1 -0
  283. package/dist/core/legacy-bridge/regenerator.js +193 -0
  284. package/dist/core/legacy-bridge/regenerator.js.map +1 -0
  285. package/dist/core/legacy-bridge/resolve.d.ts +28 -0
  286. package/dist/core/legacy-bridge/resolve.d.ts.map +1 -0
  287. package/dist/core/legacy-bridge/resolve.js +75 -0
  288. package/dist/core/legacy-bridge/resolve.js.map +1 -0
  289. package/dist/core/legacy-bridge/sync-check.d.ts +47 -0
  290. package/dist/core/legacy-bridge/sync-check.d.ts.map +1 -0
  291. package/dist/core/legacy-bridge/sync-check.js +198 -0
  292. package/dist/core/legacy-bridge/sync-check.js.map +1 -0
  293. package/dist/core/legacy-bridge/types.d.ts +114 -0
  294. package/dist/core/legacy-bridge/types.d.ts.map +1 -0
  295. package/dist/core/legacy-bridge/types.js +4 -0
  296. package/dist/core/legacy-bridge/types.js.map +1 -0
  297. package/dist/core/markers/index.d.ts +3 -0
  298. package/dist/core/markers/index.d.ts.map +1 -0
  299. package/dist/core/markers/index.js +3 -0
  300. package/dist/core/markers/index.js.map +1 -0
  301. package/dist/core/markers/parse.d.ts +12 -0
  302. package/dist/core/markers/parse.d.ts.map +1 -0
  303. package/dist/core/markers/parse.js +31 -0
  304. package/dist/core/markers/parse.js.map +1 -0
  305. package/dist/core/markers/types.d.ts +142 -0
  306. package/dist/core/markers/types.d.ts.map +1 -0
  307. package/dist/core/markers/types.js +3 -0
  308. package/dist/core/markers/types.js.map +1 -0
  309. package/dist/core/migrate/ack.d.ts +13 -0
  310. package/dist/core/migrate/ack.d.ts.map +1 -0
  311. package/dist/core/migrate/ack.js +62 -0
  312. package/dist/core/migrate/ack.js.map +1 -0
  313. package/dist/core/migrate/archive-detect.d.ts +19 -0
  314. package/dist/core/migrate/archive-detect.d.ts.map +1 -0
  315. package/dist/core/migrate/archive-detect.js +89 -0
  316. package/dist/core/migrate/archive-detect.js.map +1 -0
  317. package/dist/core/migrate/budget.d.ts +7 -0
  318. package/dist/core/migrate/budget.d.ts.map +1 -0
  319. package/dist/core/migrate/budget.js +25 -0
  320. package/dist/core/migrate/budget.js.map +1 -0
  321. package/dist/core/migrate/conflict.d.ts +49 -0
  322. package/dist/core/migrate/conflict.d.ts.map +1 -0
  323. package/dist/core/migrate/conflict.js +99 -0
  324. package/dist/core/migrate/conflict.js.map +1 -0
  325. package/dist/core/migrate/index.d.ts +7 -0
  326. package/dist/core/migrate/index.d.ts.map +1 -0
  327. package/dist/core/migrate/index.js +389 -0
  328. package/dist/core/migrate/index.js.map +1 -0
  329. package/dist/core/migrate/markdown-aware.d.ts +27 -0
  330. package/dist/core/migrate/markdown-aware.d.ts.map +1 -0
  331. package/dist/core/migrate/markdown-aware.js +112 -0
  332. package/dist/core/migrate/markdown-aware.js.map +1 -0
  333. package/dist/core/migrate/quality.d.ts +66 -0
  334. package/dist/core/migrate/quality.d.ts.map +1 -0
  335. package/dist/core/migrate/quality.js +302 -0
  336. package/dist/core/migrate/quality.js.map +1 -0
  337. package/dist/core/migrate/regenerate.d.ts +24 -0
  338. package/dist/core/migrate/regenerate.d.ts.map +1 -0
  339. package/dist/core/migrate/regenerate.js +145 -0
  340. package/dist/core/migrate/regenerate.js.map +1 -0
  341. package/dist/core/migrate/report.d.ts +36 -0
  342. package/dist/core/migrate/report.d.ts.map +1 -0
  343. package/dist/core/migrate/report.js +154 -0
  344. package/dist/core/migrate/report.js.map +1 -0
  345. package/dist/core/migrate/sources/index.d.ts +4 -0
  346. package/dist/core/migrate/sources/index.d.ts.map +1 -0
  347. package/dist/core/migrate/sources/index.js +17 -0
  348. package/dist/core/migrate/sources/index.js.map +1 -0
  349. package/dist/core/migrate/sources/openspec.d.ts +14 -0
  350. package/dist/core/migrate/sources/openspec.d.ts.map +1 -0
  351. package/dist/core/migrate/sources/openspec.js +453 -0
  352. package/dist/core/migrate/sources/openspec.js.map +1 -0
  353. package/dist/core/migrate/sources/superpowers.d.ts +12 -0
  354. package/dist/core/migrate/sources/superpowers.d.ts.map +1 -0
  355. package/dist/core/migrate/sources/superpowers.js +310 -0
  356. package/dist/core/migrate/sources/superpowers.js.map +1 -0
  357. package/dist/core/migrate/types.d.ts +183 -0
  358. package/dist/core/migrate/types.d.ts.map +1 -0
  359. package/dist/core/migrate/types.js +5 -0
  360. package/dist/core/migrate/types.js.map +1 -0
  361. package/dist/core/migrate/utils.d.ts +2 -0
  362. package/dist/core/migrate/utils.d.ts.map +1 -0
  363. package/dist/core/migrate/utils.js +28 -0
  364. package/dist/core/migrate/utils.js.map +1 -0
  365. package/dist/core/monitor/artifact-observer.d.ts +9 -0
  366. package/dist/core/monitor/artifact-observer.d.ts.map +1 -0
  367. package/dist/core/monitor/artifact-observer.js +180 -0
  368. package/dist/core/monitor/artifact-observer.js.map +1 -0
  369. package/dist/core/monitor/config.d.ts +16 -0
  370. package/dist/core/monitor/config.d.ts.map +1 -0
  371. package/dist/core/monitor/config.js +48 -0
  372. package/dist/core/monitor/config.js.map +1 -0
  373. package/dist/core/monitor/divergence-map.d.ts +5 -0
  374. package/dist/core/monitor/divergence-map.d.ts.map +1 -0
  375. package/dist/core/monitor/divergence-map.js +92 -0
  376. package/dist/core/monitor/divergence-map.js.map +1 -0
  377. package/dist/core/monitor/exit-handler.d.ts +6 -0
  378. package/dist/core/monitor/exit-handler.d.ts.map +1 -0
  379. package/dist/core/monitor/exit-handler.js +27 -0
  380. package/dist/core/monitor/exit-handler.js.map +1 -0
  381. package/dist/core/monitor/health-verdict.d.ts +9 -0
  382. package/dist/core/monitor/health-verdict.d.ts.map +1 -0
  383. package/dist/core/monitor/health-verdict.js +55 -0
  384. package/dist/core/monitor/health-verdict.js.map +1 -0
  385. package/dist/core/monitor/report-renderer.d.ts +4 -0
  386. package/dist/core/monitor/report-renderer.d.ts.map +1 -0
  387. package/dist/core/monitor/report-renderer.js +82 -0
  388. package/dist/core/monitor/report-renderer.js.map +1 -0
  389. package/dist/core/monitor/trace-store.d.ts +39 -0
  390. package/dist/core/monitor/trace-store.d.ts.map +1 -0
  391. package/dist/core/monitor/trace-store.js +130 -0
  392. package/dist/core/monitor/trace-store.js.map +1 -0
  393. package/dist/core/monitor/types.d.ts +63 -0
  394. package/dist/core/monitor/types.d.ts.map +1 -0
  395. package/dist/core/monitor/types.js +26 -0
  396. package/dist/core/monitor/types.js.map +1 -0
  397. package/dist/core/parse/design.d.ts +14 -0
  398. package/dist/core/parse/design.d.ts.map +1 -0
  399. package/dist/core/parse/design.js +17 -0
  400. package/dist/core/parse/design.js.map +1 -0
  401. package/dist/core/parse/fenced-yaml.d.ts +18 -0
  402. package/dist/core/parse/fenced-yaml.d.ts.map +1 -0
  403. package/dist/core/parse/fenced-yaml.js +45 -0
  404. package/dist/core/parse/fenced-yaml.js.map +1 -0
  405. package/dist/core/parse/index.d.ts +7 -0
  406. package/dist/core/parse/index.d.ts.map +1 -0
  407. package/dist/core/parse/index.js +8 -0
  408. package/dist/core/parse/index.js.map +1 -0
  409. package/dist/core/parse/markdown.d.ts +30 -0
  410. package/dist/core/parse/markdown.d.ts.map +1 -0
  411. package/dist/core/parse/markdown.js +66 -0
  412. package/dist/core/parse/markdown.js.map +1 -0
  413. package/dist/core/parse/proposal.d.ts +18 -0
  414. package/dist/core/parse/proposal.d.ts.map +1 -0
  415. package/dist/core/parse/proposal.js +22 -0
  416. package/dist/core/parse/proposal.js.map +1 -0
  417. package/dist/core/parse/specs.d.ts +25 -0
  418. package/dist/core/parse/specs.d.ts.map +1 -0
  419. package/dist/core/parse/specs.js +58 -0
  420. package/dist/core/parse/specs.js.map +1 -0
  421. package/dist/core/parse/tasks.d.ts +33 -0
  422. package/dist/core/parse/tasks.d.ts.map +1 -0
  423. package/dist/core/parse/tasks.js +82 -0
  424. package/dist/core/parse/tasks.js.map +1 -0
  425. package/dist/core/parse/yaml.d.ts +13 -0
  426. package/dist/core/parse/yaml.d.ts.map +1 -0
  427. package/dist/core/parse/yaml.js +39 -0
  428. package/dist/core/parse/yaml.js.map +1 -0
  429. package/dist/core/process-evidence-freeze-warnings.d.ts +24 -0
  430. package/dist/core/process-evidence-freeze-warnings.d.ts.map +1 -0
  431. package/dist/core/process-evidence-freeze-warnings.js +153 -0
  432. package/dist/core/process-evidence-freeze-warnings.js.map +1 -0
  433. package/dist/core/schema/index.d.ts +5 -0
  434. package/dist/core/schema/index.d.ts.map +1 -0
  435. package/dist/core/schema/index.js +6 -0
  436. package/dist/core/schema/index.js.map +1 -0
  437. package/dist/core/schema/model-tiers-config.d.ts +41 -0
  438. package/dist/core/schema/model-tiers-config.d.ts.map +1 -0
  439. package/dist/core/schema/model-tiers-config.js +85 -0
  440. package/dist/core/schema/model-tiers-config.js.map +1 -0
  441. package/dist/core/schema/process-verification-config.d.ts +18 -0
  442. package/dist/core/schema/process-verification-config.d.ts.map +1 -0
  443. package/dist/core/schema/process-verification-config.js +74 -0
  444. package/dist/core/schema/process-verification-config.js.map +1 -0
  445. package/dist/core/schema/stage-extensions-config.d.ts +28 -0
  446. package/dist/core/schema/stage-extensions-config.d.ts.map +1 -0
  447. package/dist/core/schema/stage-extensions-config.js +228 -0
  448. package/dist/core/schema/stage-extensions-config.js.map +1 -0
  449. package/dist/core/schema/types.d.ts +262 -0
  450. package/dist/core/schema/types.d.ts.map +1 -0
  451. package/dist/core/schema/types.js +51 -0
  452. package/dist/core/schema/types.js.map +1 -0
  453. package/dist/core/schema/writing-plans-config.d.ts +11 -0
  454. package/dist/core/schema/writing-plans-config.d.ts.map +1 -0
  455. package/dist/core/schema/writing-plans-config.js +40 -0
  456. package/dist/core/schema/writing-plans-config.js.map +1 -0
  457. package/dist/core/schemas/archive-summary.d.ts +131 -0
  458. package/dist/core/schemas/archive-summary.d.ts.map +1 -0
  459. package/dist/core/schemas/archive-summary.js +31 -0
  460. package/dist/core/schemas/archive-summary.js.map +1 -0
  461. package/dist/core/schemas/process-evidence.d.ts +156 -0
  462. package/dist/core/schemas/process-evidence.d.ts.map +1 -0
  463. package/dist/core/schemas/process-evidence.js +12 -0
  464. package/dist/core/schemas/process-evidence.js.map +1 -0
  465. package/dist/core/schemas/scope-entries.d.ts +68 -0
  466. package/dist/core/schemas/scope-entries.d.ts.map +1 -0
  467. package/dist/core/schemas/scope-entries.js +47 -0
  468. package/dist/core/schemas/scope-entries.js.map +1 -0
  469. package/dist/core/schemas/severity.d.ts +58 -0
  470. package/dist/core/schemas/severity.d.ts.map +1 -0
  471. package/dist/core/schemas/severity.js +26 -0
  472. package/dist/core/schemas/severity.js.map +1 -0
  473. package/dist/core/scope/aggregator.d.ts +49 -0
  474. package/dist/core/scope/aggregator.d.ts.map +1 -0
  475. package/dist/core/scope/aggregator.js +141 -0
  476. package/dist/core/scope/aggregator.js.map +1 -0
  477. package/dist/core/scope/index.d.ts +2 -0
  478. package/dist/core/scope/index.d.ts.map +1 -0
  479. package/dist/core/scope/index.js +2 -0
  480. package/dist/core/scope/index.js.map +1 -0
  481. package/dist/core/specs-sync/apply.d.ts +8 -0
  482. package/dist/core/specs-sync/apply.d.ts.map +1 -0
  483. package/dist/core/specs-sync/apply.js +26 -0
  484. package/dist/core/specs-sync/apply.js.map +1 -0
  485. package/dist/core/specs-sync/deltas.d.ts +15 -0
  486. package/dist/core/specs-sync/deltas.d.ts.map +1 -0
  487. package/dist/core/specs-sync/deltas.js +27 -0
  488. package/dist/core/specs-sync/deltas.js.map +1 -0
  489. package/dist/core/specs-sync/index.d.ts +3 -0
  490. package/dist/core/specs-sync/index.d.ts.map +1 -0
  491. package/dist/core/specs-sync/index.js +4 -0
  492. package/dist/core/specs-sync/index.js.map +1 -0
  493. package/dist/core/stage-extensions/convergence-judge.d.ts +35 -0
  494. package/dist/core/stage-extensions/convergence-judge.d.ts.map +1 -0
  495. package/dist/core/stage-extensions/convergence-judge.js +47 -0
  496. package/dist/core/stage-extensions/convergence-judge.js.map +1 -0
  497. package/dist/core/stage-extensions/index.d.ts +13 -0
  498. package/dist/core/stage-extensions/index.d.ts.map +1 -0
  499. package/dist/core/stage-extensions/index.js +11 -0
  500. package/dist/core/stage-extensions/index.js.map +1 -0
  501. package/dist/core/stage-extensions/output-watcher.d.ts +93 -0
  502. package/dist/core/stage-extensions/output-watcher.d.ts.map +1 -0
  503. package/dist/core/stage-extensions/output-watcher.js +163 -0
  504. package/dist/core/stage-extensions/output-watcher.js.map +1 -0
  505. package/dist/core/stage-extensions/severity-mapper.d.ts +21 -0
  506. package/dist/core/stage-extensions/severity-mapper.d.ts.map +1 -0
  507. package/dist/core/stage-extensions/severity-mapper.js +26 -0
  508. package/dist/core/stage-extensions/severity-mapper.js.map +1 -0
  509. package/dist/core/stage-extensions/state-machine.d.ts +43 -0
  510. package/dist/core/stage-extensions/state-machine.d.ts.map +1 -0
  511. package/dist/core/stage-extensions/state-machine.js +19 -0
  512. package/dist/core/stage-extensions/state-machine.js.map +1 -0
  513. package/dist/core/stage-extensions/thread-map.d.ts +60 -0
  514. package/dist/core/stage-extensions/thread-map.d.ts.map +1 -0
  515. package/dist/core/stage-extensions/thread-map.js +107 -0
  516. package/dist/core/stage-extensions/thread-map.js.map +1 -0
  517. package/dist/core/stage-extensions/trend-analyzer.d.ts +29 -0
  518. package/dist/core/stage-extensions/trend-analyzer.d.ts.map +1 -0
  519. package/dist/core/stage-extensions/trend-analyzer.js +60 -0
  520. package/dist/core/stage-extensions/trend-analyzer.js.map +1 -0
  521. package/dist/core/stage-extensions/types.d.ts +39 -0
  522. package/dist/core/stage-extensions/types.d.ts.map +1 -0
  523. package/dist/core/stage-extensions/types.js +5 -0
  524. package/dist/core/stage-extensions/types.js.map +1 -0
  525. package/dist/core/staging-lock.d.ts +36 -0
  526. package/dist/core/staging-lock.d.ts.map +1 -0
  527. package/dist/core/staging-lock.js +122 -0
  528. package/dist/core/staging-lock.js.map +1 -0
  529. package/dist/core/templates/commands/ack-confirm.md +32 -0
  530. package/dist/core/templates/commands/apply.md +220 -0
  531. package/dist/core/templates/commands/archive.md +178 -0
  532. package/dist/core/templates/commands/brainstorm.md +58 -0
  533. package/dist/core/templates/commands/codex-adversarial.md +95 -0
  534. package/dist/core/templates/commands/explore.md +29 -0
  535. package/dist/core/templates/commands/index.d.ts +12 -0
  536. package/dist/core/templates/commands/index.d.ts.map +1 -0
  537. package/dist/core/templates/commands/index.js +26 -0
  538. package/dist/core/templates/commands/index.js.map +1 -0
  539. package/dist/core/templates/commands/propose.md +90 -0
  540. package/dist/core/templates/commands/review.md +105 -0
  541. package/dist/core/templates/commands/upgrade.md +58 -0
  542. package/dist/core/templates/commands/verify.md +186 -0
  543. package/dist/core/templates/index.d.ts +3 -0
  544. package/dist/core/templates/index.d.ts.map +1 -0
  545. package/dist/core/templates/index.js +5 -0
  546. package/dist/core/templates/index.js.map +1 -0
  547. package/dist/core/templates/skills/_shared/scope-category-guidance.md +40 -0
  548. package/dist/core/templates/skills/brainstorming.md +161 -0
  549. package/dist/core/templates/skills/dispatching-parallel-agents.md +209 -0
  550. package/dist/core/templates/skills/exploring.md +476 -0
  551. package/dist/core/templates/skills/finishing-a-development-branch.md +251 -0
  552. package/dist/core/templates/skills/index.d.ts +17 -0
  553. package/dist/core/templates/skills/index.d.ts.map +1 -0
  554. package/dist/core/templates/skills/index.js +53 -0
  555. package/dist/core/templates/skills/index.js.map +1 -0
  556. package/dist/core/templates/skills/process-evidence.md +146 -0
  557. package/dist/core/templates/skills/receiving-code-review.md +294 -0
  558. package/dist/core/templates/skills/requesting-code-review.md +108 -0
  559. package/dist/core/templates/skills/subagent-driven-development.md +405 -0
  560. package/dist/core/templates/skills/subagent-driven-discipline/references/codex-tools.md +72 -0
  561. package/dist/core/templates/skills/subagent-driven-discipline/references/opencode-tools.md +104 -0
  562. package/dist/core/templates/skills/subagent-driven-discipline.md +725 -0
  563. package/dist/core/templates/skills/systematic-debugging.md +297 -0
  564. package/dist/core/templates/skills/test-driven-development.md +402 -0
  565. package/dist/core/templates/skills/using-forge.md +163 -0
  566. package/dist/core/templates/skills/using-git-worktrees.md +229 -0
  567. package/dist/core/templates/skills/verification-before-completion.md +175 -0
  568. package/dist/core/templates/skills/verifying-three-dimensions.md +245 -0
  569. package/dist/core/templates/skills/writing-plans.md +259 -0
  570. package/dist/core/templates/skills/writing-skills.md +214 -0
  571. package/dist/core/test-reporters/index.d.ts +41 -0
  572. package/dist/core/test-reporters/index.d.ts.map +1 -0
  573. package/dist/core/test-reporters/index.js +39 -0
  574. package/dist/core/test-reporters/index.js.map +1 -0
  575. package/dist/core/test-reporters/junit.d.ts +8 -0
  576. package/dist/core/test-reporters/junit.d.ts.map +1 -0
  577. package/dist/core/test-reporters/junit.js +94 -0
  578. package/dist/core/test-reporters/junit.js.map +1 -0
  579. package/dist/core/test-reporters/tap.d.ts +18 -0
  580. package/dist/core/test-reporters/tap.d.ts.map +1 -0
  581. package/dist/core/test-reporters/tap.js +73 -0
  582. package/dist/core/test-reporters/tap.js.map +1 -0
  583. package/dist/core/test-reporters/vitest-json.d.ts +8 -0
  584. package/dist/core/test-reporters/vitest-json.d.ts.map +1 -0
  585. package/dist/core/test-reporters/vitest-json.js +56 -0
  586. package/dist/core/test-reporters/vitest-json.js.map +1 -0
  587. package/dist/core/upgrade/resign-markers.d.ts +14 -0
  588. package/dist/core/upgrade/resign-markers.d.ts.map +1 -0
  589. package/dist/core/upgrade/resign-markers.js +245 -0
  590. package/dist/core/upgrade/resign-markers.js.map +1 -0
  591. package/dist/core/validate/archive-summary-schema.d.ts +8 -0
  592. package/dist/core/validate/archive-summary-schema.d.ts.map +1 -0
  593. package/dist/core/validate/archive-summary-schema.js +186 -0
  594. package/dist/core/validate/archive-summary-schema.js.map +1 -0
  595. package/dist/core/validate/auto-findings.d.ts +36 -0
  596. package/dist/core/validate/auto-findings.d.ts.map +1 -0
  597. package/dist/core/validate/auto-findings.js +38 -0
  598. package/dist/core/validate/auto-findings.js.map +1 -0
  599. package/dist/core/validate/candidate-validators.d.ts +22 -0
  600. package/dist/core/validate/candidate-validators.d.ts.map +1 -0
  601. package/dist/core/validate/candidate-validators.js +46 -0
  602. package/dist/core/validate/candidate-validators.js.map +1 -0
  603. package/dist/core/validate/change.d.ts +3 -0
  604. package/dist/core/validate/change.d.ts.map +1 -0
  605. package/dist/core/validate/change.js +205 -0
  606. package/dist/core/validate/change.js.map +1 -0
  607. package/dist/core/validate/coverage-gap.d.ts +37 -0
  608. package/dist/core/validate/coverage-gap.d.ts.map +1 -0
  609. package/dist/core/validate/coverage-gap.js +181 -0
  610. package/dist/core/validate/coverage-gap.js.map +1 -0
  611. package/dist/core/validate/finding-hash.d.ts +14 -0
  612. package/dist/core/validate/finding-hash.d.ts.map +1 -0
  613. package/dist/core/validate/finding-hash.js +29 -0
  614. package/dist/core/validate/finding-hash.js.map +1 -0
  615. package/dist/core/validate/index.d.ts +15 -0
  616. package/dist/core/validate/index.d.ts.map +1 -0
  617. package/dist/core/validate/index.js +19 -0
  618. package/dist/core/validate/index.js.map +1 -0
  619. package/dist/core/validate/marker-integrity.d.ts +28 -0
  620. package/dist/core/validate/marker-integrity.d.ts.map +1 -0
  621. package/dist/core/validate/marker-integrity.js +170 -0
  622. package/dist/core/validate/marker-integrity.js.map +1 -0
  623. package/dist/core/validate/marker-schema.d.ts +10 -0
  624. package/dist/core/validate/marker-schema.d.ts.map +1 -0
  625. package/dist/core/validate/marker-schema.js +661 -0
  626. package/dist/core/validate/marker-schema.js.map +1 -0
  627. package/dist/core/validate/orphan-tmp.d.ts +13 -0
  628. package/dist/core/validate/orphan-tmp.d.ts.map +1 -0
  629. package/dist/core/validate/orphan-tmp.js +49 -0
  630. package/dist/core/validate/orphan-tmp.js.map +1 -0
  631. package/dist/core/validate/proposal.d.ts +4 -0
  632. package/dist/core/validate/proposal.d.ts.map +1 -0
  633. package/dist/core/validate/proposal.js +40 -0
  634. package/dist/core/validate/proposal.js.map +1 -0
  635. package/dist/core/validate/scope-entries.d.ts +23 -0
  636. package/dist/core/validate/scope-entries.d.ts.map +1 -0
  637. package/dist/core/validate/scope-entries.js +108 -0
  638. package/dist/core/validate/scope-entries.js.map +1 -0
  639. package/dist/core/validate/specs.d.ts +4 -0
  640. package/dist/core/validate/specs.d.ts.map +1 -0
  641. package/dist/core/validate/specs.js +74 -0
  642. package/dist/core/validate/specs.js.map +1 -0
  643. package/dist/core/validate/tasks.d.ts +4 -0
  644. package/dist/core/validate/tasks.d.ts.map +1 -0
  645. package/dist/core/validate/tasks.js +48 -0
  646. package/dist/core/validate/tasks.js.map +1 -0
  647. package/dist/core/validate/test-failure-stub.d.ts +23 -0
  648. package/dist/core/validate/test-failure-stub.d.ts.map +1 -0
  649. package/dist/core/validate/test-failure-stub.js +21 -0
  650. package/dist/core/validate/test-failure-stub.js.map +1 -0
  651. package/dist/core/validate/types.d.ts +33 -0
  652. package/dist/core/validate/types.d.ts.map +1 -0
  653. package/dist/core/validate/types.js +20 -0
  654. package/dist/core/validate/types.js.map +1 -0
  655. package/dist/core/worktree.d.ts +52 -0
  656. package/dist/core/worktree.d.ts.map +1 -0
  657. package/dist/core/worktree.js +145 -0
  658. package/dist/core/worktree.js.map +1 -0
  659. package/dist/index.d.ts +12 -0
  660. package/dist/index.d.ts.map +1 -0
  661. package/dist/index.js +14 -0
  662. package/dist/index.js.map +1 -0
  663. package/package.json +82 -0
@@ -0,0 +1,93 @@
1
+ import type { ChildProcess } from 'node:child_process';
2
+ import { EventEmitter } from 'node:events';
3
+ /**
4
+ * OutputWatcher — 监控子进程和输出文件。
5
+ *
6
+ * 事件:
7
+ * - 'done' :进程正常退出,参数 exitCode (number)
8
+ * - 'zombie' :超时且文件 mtime 停止更新(进程挂死)
9
+ * - 'timeout' :超时但文件 mtime 仍在推进(进程可能卡在无限循环)
10
+ * - 'progress':文件 mtime 有进展(不会 settle)
11
+ *
12
+ * 单次 settle:done/zombie/timeout 只会触发一次。
13
+ */
14
+ export declare class OutputWatcher extends EventEmitter {
15
+ private readonly proc;
16
+ private readonly filePath;
17
+ private readonly pollIntervalSec;
18
+ private readonly zombieThresholdSec;
19
+ private readonly timeoutSec;
20
+ private settled;
21
+ private intervalId;
22
+ private lastMtime;
23
+ private startTime;
24
+ /**
25
+ * close 事件 handler 引用。
26
+ * 保存引用以便 stop() 精确移除(避免误删 runner 自己挂的 close 监听器)。
27
+ */
28
+ private readonly closeHandler;
29
+ /** @param proc 被监控的子进程 */
30
+ /** @param filePath codex 输出文件路径 */
31
+ /** @param pollIntervalSec 轮询间隔(秒) */
32
+ /** @param zombieThresholdSec 判定 zombie 所需的 mtime 静止时长(秒) */
33
+ /** @param timeoutSec 整体超时时长(秒) */
34
+ constructor(proc: ChildProcess, filePath: string, pollIntervalSec: number, zombieThresholdSec: number, timeoutSec: number);
35
+ /**
36
+ * 启动监控。
37
+ * - 立即注册 proc.close 监听器
38
+ * - 启动定时轮询
39
+ */
40
+ start(): void;
41
+ /**
42
+ * 定时轮询逻辑。
43
+ * 若进程已退出,跳过(等待 close 事件处理)。
44
+ */
45
+ private poll;
46
+ /**
47
+ * 单次 settle:确保 done/zombie/timeout 只触发一次。
48
+ * settle 后自动调用 stop()。
49
+ */
50
+ private settle;
51
+ /**
52
+ * 停止监控:清除定时器和进程监听器。
53
+ */
54
+ stop(): void;
55
+ /**
56
+ * EventEmitter 类型重载,提供 per-event 类型安全的事件注册。
57
+ * - 'done' listener 收到 exitCode (number)
58
+ * - 'zombie' / 'timeout' / 'progress' listener 无参数
59
+ * - 'error' 保留 EventEmitter 标准 error 接口
60
+ */
61
+ on(event: 'done', listener: (exitCode: number) => void): this;
62
+ on(event: 'zombie' | 'timeout' | 'progress', listener: () => void): this;
63
+ on(event: 'error', listener: (err: Error) => void): this;
64
+ }
65
+ /**
66
+ * watchProcess 结果联合类型。
67
+ * progress 不作为结果(不 resolve Promise)。
68
+ */
69
+ export type WatchResult = {
70
+ kind: 'done';
71
+ exitCode: number;
72
+ } | {
73
+ kind: 'zombie';
74
+ jobId: string | null;
75
+ } | {
76
+ kind: 'timeout';
77
+ jobId: string | null;
78
+ };
79
+ /**
80
+ * 包装 OutputWatcher,返回 Promise — 仅在首个终态事件时 resolve。
81
+ * progress 事件不 resolve Promise。
82
+ * jobId 由 runner 附加,此处固定传 null。
83
+ *
84
+ * @param proc 被监控的子进程
85
+ * @param filePath codex 输出文件路径
86
+ * @param opts 轮询/超时参数
87
+ */
88
+ export declare function watchProcess(proc: ChildProcess, filePath: string, opts: {
89
+ poll_interval_sec: number;
90
+ zombie_threshold_sec: number;
91
+ timeout_sec: number;
92
+ }): Promise<WatchResult>;
93
+ //# sourceMappingURL=output-watcher.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"output-watcher.d.ts","sourceRoot":"","sources":["../../../src/core/stage-extensions/output-watcher.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;;;;;GAUG;AACH,qBAAa,aAAc,SAAQ,YAAY;IAqB3C,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAxB7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,SAAS,CAAK;IAEtB;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAG3B;IAEF,uCAAuC;IACvC,4CAA4C;IAC5C,uCAAuC;IACvC,6DAA6D;IAC7D,yCAAyC;gBAEtB,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,kBAAkB,EAAE,MAAM,EAC1B,UAAU,EAAE,MAAM;IAKrC;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAYb;;;OAGG;YACW,IAAI;IAgDlB;;;OAGG;IACH,OAAO,CAAC,MAAM;IAed;;OAEG;IACH,IAAI,IAAI,IAAI;IASZ;;;;;OAKG;IACM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAC7D,EAAE,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,UAAU,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IACxE,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;CAIlE;AAID;;;GAGG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAE9C;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;IACJ,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;CACrB,GACA,OAAO,CAAC,WAAW,CAAC,CA2BtB"}
@@ -0,0 +1,163 @@
1
+ // output-watcher.ts — 子进程输出文件监控
2
+ // plan-stage-extensions Task 2.5
3
+ // 监控两个信号:子进程退出(proc.close) 和输出文件 mtime 进展
4
+ // 单次 settle:done/zombie/timeout 三种结果只会 emit 一次
5
+ import { stat } from 'node:fs/promises';
6
+ import { EventEmitter } from 'node:events';
7
+ /**
8
+ * OutputWatcher — 监控子进程和输出文件。
9
+ *
10
+ * 事件:
11
+ * - 'done' :进程正常退出,参数 exitCode (number)
12
+ * - 'zombie' :超时且文件 mtime 停止更新(进程挂死)
13
+ * - 'timeout' :超时但文件 mtime 仍在推进(进程可能卡在无限循环)
14
+ * - 'progress':文件 mtime 有进展(不会 settle)
15
+ *
16
+ * 单次 settle:done/zombie/timeout 只会触发一次。
17
+ */
18
+ export class OutputWatcher extends EventEmitter {
19
+ proc;
20
+ filePath;
21
+ pollIntervalSec;
22
+ zombieThresholdSec;
23
+ timeoutSec;
24
+ settled = false;
25
+ intervalId = null;
26
+ lastMtime = 0;
27
+ startTime = 0;
28
+ /**
29
+ * close 事件 handler 引用。
30
+ * 保存引用以便 stop() 精确移除(避免误删 runner 自己挂的 close 监听器)。
31
+ */
32
+ closeHandler = (code) => {
33
+ // 进程退出,emit done(单次 settle)
34
+ this.settle('done', code ?? 0);
35
+ };
36
+ /** @param proc 被监控的子进程 */
37
+ /** @param filePath codex 输出文件路径 */
38
+ /** @param pollIntervalSec 轮询间隔(秒) */
39
+ /** @param zombieThresholdSec 判定 zombie 所需的 mtime 静止时长(秒) */
40
+ /** @param timeoutSec 整体超时时长(秒) */
41
+ constructor(proc, filePath, pollIntervalSec, zombieThresholdSec, timeoutSec) {
42
+ super();
43
+ this.proc = proc;
44
+ this.filePath = filePath;
45
+ this.pollIntervalSec = pollIntervalSec;
46
+ this.zombieThresholdSec = zombieThresholdSec;
47
+ this.timeoutSec = timeoutSec;
48
+ }
49
+ /**
50
+ * 启动监控。
51
+ * - 立即注册 proc.close 监听器
52
+ * - 启动定时轮询
53
+ */
54
+ start() {
55
+ this.startTime = Date.now();
56
+ // 监听进程退出:首选 settle 路径(用具名 handler 引用,stop 时精确移除)
57
+ this.proc.once('close', this.closeHandler);
58
+ // 定时轮询:检测 zombie / timeout / progress
59
+ this.intervalId = setInterval(() => {
60
+ void this.poll();
61
+ }, this.pollIntervalSec * 1000);
62
+ }
63
+ /**
64
+ * 定时轮询逻辑。
65
+ * 若进程已退出,跳过(等待 close 事件处理)。
66
+ */
67
+ async poll() {
68
+ // 进程已退出,交给 close handler 处理
69
+ if (this.proc.exitCode !== null || this.proc.signalCode !== null) {
70
+ return;
71
+ }
72
+ const now = Date.now();
73
+ const elapsed = (now - this.startTime) / 1000;
74
+ // 读取文件 mtime
75
+ let mtime = this.lastMtime;
76
+ try {
77
+ const s = await stat(this.filePath);
78
+ mtime = s.mtimeMs;
79
+ }
80
+ catch {
81
+ // 文件尚未创建,mtime 保持上次值
82
+ }
83
+ // await stat() 让出后,close handler 可能已 settle+stop,此时跳过后续 mtime 计算
84
+ if (this.settled) {
85
+ return;
86
+ }
87
+ const mtimeAge = (now - mtime) / 1000;
88
+ const mtimeAdvanced = mtime > this.lastMtime;
89
+ // 更新 lastMtime(仅在有进展时)
90
+ if (mtimeAdvanced) {
91
+ this.lastMtime = mtime;
92
+ }
93
+ if (elapsed >= this.timeoutSec) {
94
+ if (mtimeAge >= this.zombieThresholdSec) {
95
+ // 超时且 mtime 长时间未更新 → zombie
96
+ this.settle('zombie');
97
+ }
98
+ else {
99
+ // 超时但 mtime 还在更新 → timeout
100
+ this.settle('timeout');
101
+ }
102
+ return;
103
+ }
104
+ // 未超时,仅发出 progress 通知
105
+ if (mtimeAdvanced) {
106
+ this.emit('progress');
107
+ }
108
+ }
109
+ settle(kind, exitCode) {
110
+ if (this.settled)
111
+ return;
112
+ this.settled = true;
113
+ if (kind === 'done') {
114
+ this.emit('done', exitCode);
115
+ }
116
+ else {
117
+ this.emit(kind);
118
+ }
119
+ this.stop();
120
+ }
121
+ /**
122
+ * 停止监控:清除定时器和进程监听器。
123
+ */
124
+ stop() {
125
+ if (this.intervalId !== null) {
126
+ clearInterval(this.intervalId);
127
+ this.intervalId = null;
128
+ }
129
+ // 精确移除本 watcher 注册的 close 监听器(不影响 runner 自己挂的 close 监听器)
130
+ this.proc.removeListener('close', this.closeHandler);
131
+ }
132
+ on(event, listener) {
133
+ return super.on(event, listener);
134
+ }
135
+ }
136
+ /**
137
+ * 包装 OutputWatcher,返回 Promise — 仅在首个终态事件时 resolve。
138
+ * progress 事件不 resolve Promise。
139
+ * jobId 由 runner 附加,此处固定传 null。
140
+ *
141
+ * @param proc 被监控的子进程
142
+ * @param filePath codex 输出文件路径
143
+ * @param opts 轮询/超时参数
144
+ */
145
+ export function watchProcess(proc, filePath, opts) {
146
+ return new Promise((resolve) => {
147
+ const watcher = new OutputWatcher(proc, filePath, opts.poll_interval_sec, opts.zombie_threshold_sec, opts.timeout_sec);
148
+ // done:进程正常退出(per-event overload 保证 exitCode 为 number)
149
+ watcher.on('done', (exitCode) => {
150
+ resolve({ kind: 'done', exitCode });
151
+ });
152
+ // zombie:进程挂死
153
+ watcher.on('zombie', () => {
154
+ resolve({ kind: 'zombie', jobId: null });
155
+ });
156
+ // timeout:超时(mtime 仍更新)
157
+ watcher.on('timeout', () => {
158
+ resolve({ kind: 'timeout', jobId: null });
159
+ });
160
+ watcher.start();
161
+ });
162
+ }
163
+ //# sourceMappingURL=output-watcher.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"output-watcher.js","sourceRoot":"","sources":["../../../src/core/stage-extensions/output-watcher.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ import type { SeverityMap } from './types.js';
2
+ import type { StageExtensionsDefaults } from '../schema/types.js';
3
+ /**
4
+ * codex JSON severity → forge 显示 4 级。
5
+ * 查 severity_map 做 1:1 映射;map 来自 NormalizedStageExtensionsConfig。
6
+ *
7
+ * @param codexSeverity codex 输出的原始 severity
8
+ * @param severityMap 来自 normalized config 的映射表
9
+ * @returns forge 4 级 severity
10
+ */
11
+ export declare function mapCodexToForge(codexSeverity: 'critical' | 'high' | 'medium' | 'low', severityMap: SeverityMap): 'BLOCKER' | 'MAJOR' | 'MINOR' | 'NIT';
12
+ /**
13
+ * forge 4 级 → forge 3 级(handoff_to_backlog 时使用)。
14
+ * 查 severity_map_to_forge 做 1:1 映射。
15
+ *
16
+ * @param forgeSeverity forge 内部 4 级 severity
17
+ * @param severityMapToForge 来自 normalized config 的映射表
18
+ * @returns forge 3 级 severity(critical / warning / suggestion)
19
+ */
20
+ export declare function mapForgeToForgeTier(forgeSeverity: 'BLOCKER' | 'MAJOR' | 'MINOR' | 'NIT', severityMapToForge: StageExtensionsDefaults['severity_map_to_forge']): 'critical' | 'warning' | 'suggestion';
21
+ //# sourceMappingURL=severity-mapper.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"severity-mapper.d.ts","sourceRoot":"","sources":["../../../src/core/stage-extensions/severity-mapper.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAElE;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,aAAa,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,EACrD,WAAW,EAAE,WAAW,GACvB,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,CAEvC;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,EACpD,kBAAkB,EAAE,uBAAuB,CAAC,uBAAuB,CAAC,GACnE,UAAU,GAAG,SAAS,GAAG,YAAY,CAEvC"}
@@ -0,0 +1,26 @@
1
+ // severity-mapper.ts — severity 级别映射纯函数
2
+ // plan-stage-extensions Task 2.1
3
+ // 两个 map 查找:codex → forge 4级 / forge 4级 → forge 3级(handoff_to_backlog 用)
4
+ /**
5
+ * codex JSON severity → forge 显示 4 级。
6
+ * 查 severity_map 做 1:1 映射;map 来自 NormalizedStageExtensionsConfig。
7
+ *
8
+ * @param codexSeverity codex 输出的原始 severity
9
+ * @param severityMap 来自 normalized config 的映射表
10
+ * @returns forge 4 级 severity
11
+ */
12
+ export function mapCodexToForge(codexSeverity, severityMap) {
13
+ return severityMap[codexSeverity];
14
+ }
15
+ /**
16
+ * forge 4 级 → forge 3 级(handoff_to_backlog 时使用)。
17
+ * 查 severity_map_to_forge 做 1:1 映射。
18
+ *
19
+ * @param forgeSeverity forge 内部 4 级 severity
20
+ * @param severityMapToForge 来自 normalized config 的映射表
21
+ * @returns forge 3 级 severity(critical / warning / suggestion)
22
+ */
23
+ export function mapForgeToForgeTier(forgeSeverity, severityMapToForge) {
24
+ return severityMapToForge[forgeSeverity];
25
+ }
26
+ //# sourceMappingURL=severity-mapper.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"severity-mapper.js","sourceRoot":"","sources":["../../../src/core/stage-extensions/severity-mapper.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,iCAAiC;AACjC,yEAAyE;AAKzE;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,aAAqD,EACrD,WAAwB;IAExB,OAAO,WAAW,CAAC,aAAa,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,aAAoD,EACpD,kBAAoE;IAEpE,OAAO,kBAAkB,CAAC,aAAa,CAAC,CAAC;AAC3C,CAAC"}
@@ -0,0 +1,43 @@
1
+ import type { ConvergenceResult } from './convergence-judge.js';
2
+ /**
3
+ * 单轮 codex extension 执行结果。
4
+ *
5
+ * converged :block findings 为空,可继续 merge
6
+ * unconverged :block findings 非空,需再轮
7
+ * spawn_failed:子进程启动失败
8
+ * zombie :进程挂死(mtime 停止更新)
9
+ * timeout :整体超时(mtime 仍更新)
10
+ * invalid_output:codex 输出文件格式非法
11
+ * attempt_failed:重试次数耗尽或其他失败
12
+ */
13
+ export type RoundOutcome = {
14
+ kind: 'converged';
15
+ convergence: ConvergenceResult;
16
+ } | {
17
+ kind: 'unconverged';
18
+ convergence: ConvergenceResult;
19
+ } | {
20
+ kind: 'spawn_failed';
21
+ error: Error;
22
+ } | {
23
+ kind: 'zombie';
24
+ jobId: string | null;
25
+ } | {
26
+ kind: 'timeout';
27
+ jobId: string | null;
28
+ } | {
29
+ kind: 'invalid_output';
30
+ reason: string;
31
+ } | {
32
+ kind: 'attempt_failed';
33
+ reason: string;
34
+ };
35
+ /**
36
+ * 判断 RoundOutcome 是否为失败态。
37
+ * 失败态:spawn_failed / zombie / timeout / invalid_output / attempt_failed。
38
+ * converged / unconverged 不视为失败(unconverged 是正常的"需继续"状态)。
39
+ *
40
+ * @param o 单轮结果
41
+ */
42
+ export declare function isFailureOutcome(o: RoundOutcome): boolean;
43
+ //# sourceMappingURL=state-machine.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"state-machine.d.ts","sourceRoot":"","sources":["../../../src/core/stage-extensions/state-machine.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,WAAW,EAAE,iBAAiB,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,WAAW,EAAE,iBAAiB,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/C;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,YAAY,GAAG,OAAO,CAQzD"}
@@ -0,0 +1,19 @@
1
+ // state-machine.ts — 单轮收敛轮次结果类型 + 辅助函数
2
+ // plan-stage-extensions Task 2.6
3
+ // 定义 RoundOutcome 判别联合和 isFailureOutcome 辅助函数;
4
+ // 完整状态机由 runner (Task 5) 实现
5
+ /**
6
+ * 判断 RoundOutcome 是否为失败态。
7
+ * 失败态:spawn_failed / zombie / timeout / invalid_output / attempt_failed。
8
+ * converged / unconverged 不视为失败(unconverged 是正常的"需继续"状态)。
9
+ *
10
+ * @param o 单轮结果
11
+ */
12
+ export function isFailureOutcome(o) {
13
+ return (o.kind === 'spawn_failed' ||
14
+ o.kind === 'zombie' ||
15
+ o.kind === 'timeout' ||
16
+ o.kind === 'invalid_output' ||
17
+ o.kind === 'attempt_failed');
18
+ }
19
+ //# sourceMappingURL=state-machine.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"state-machine.js","sourceRoot":"","sources":["../../../src/core/stage-extensions/state-machine.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,iCAAiC;AACjC,+CAA+C;AAC/C,4BAA4B;AAwB5B;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,CAAe;IAC9C,OAAO,CACL,CAAC,CAAC,IAAI,KAAK,cAAc;QACzB,CAAC,CAAC,IAAI,KAAK,QAAQ;QACnB,CAAC,CAAC,IAAI,KAAK,SAAS;QACpB,CAAC,CAAC,IAAI,KAAK,gBAAgB;QAC3B,CAAC,CAAC,IAAI,KAAK,gBAAgB,CAC5B,CAAC;AACJ,CAAC"}
@@ -0,0 +1,60 @@
1
+ /** 单个 thread 记录 */
2
+ export interface ThreadMapEntry {
3
+ /** codex session thread id;首轮可能为 null(不传 --resume) */
4
+ thread_id: string | null;
5
+ /** 当前轮次编号 */
6
+ round: number;
7
+ /** 上一轮 verdict;首轮前为 null */
8
+ last_verdict: 'approve' | 'needs-attention' | null;
9
+ /** 上一轮 finding 总数 */
10
+ last_finding_count: number;
11
+ /** 上一轮完成时间(ISO 8601) */
12
+ last_round_at: string;
13
+ }
14
+ /**
15
+ * ThreadMap — 管理 codex thread id 与轮次记录。
16
+ * 文件路径:<forgeRoot>/changes/<changeId>/.codex-threads.yaml。
17
+ * load() 在文件不存在时返回空 map(不 throw)。
18
+ */
19
+ export declare class ThreadMap {
20
+ /** 内部存储:stage → extensionName → ThreadMapEntry */
21
+ private map;
22
+ /** YAML 文件绝对路径 */
23
+ private readonly filePath;
24
+ /**
25
+ * @param changeId change 目录名(如 'c1')
26
+ * @param forgeRoot forge 根目录;缺省为 'forge'(runner 传入 forgeRoot,测试传 tmpdir)
27
+ * 路径约定:<forgeRoot>/changes/<changeId>/.codex-threads.yaml
28
+ */
29
+ constructor(changeId: string, forgeRoot?: string);
30
+ /**
31
+ * 从磁盘加载 YAML 文件。
32
+ * 文件不存在 → 内部 map 清空(空 map,不 throw)。
33
+ * 文件存在但解析失败 → throw(保留异常)。
34
+ */
35
+ load(): Promise<void>;
36
+ /**
37
+ * 将内部 map 写回 YAML 文件。
38
+ * 若父目录不存在则自动创建。
39
+ * 采用 tmp 文件写 + rename atomic(POSIX + Windows NTFS 同卷),与 forge 其他 state 文件一致。
40
+ */
41
+ save(): Promise<void>;
42
+ /**
43
+ * 获取指定 stage + extensionName 的 thread id。
44
+ * 无记录时返回 null(caller 不传 --resume)。
45
+ */
46
+ getThreadId(stage: string, name: string): string | null;
47
+ /**
48
+ * 记录或更新一轮结果。
49
+ * @param stage stage 名称(如 'review')
50
+ * @param name extension name
51
+ * @param entry 本轮完整记录
52
+ */
53
+ recordRound(stage: string, name: string, entry: ThreadMapEntry): void;
54
+ /**
55
+ * 删除指定 stage 的全部记录。
56
+ * 跨 stage 切换时使用,确保新 stage 使用新 thread。
57
+ */
58
+ resetStage(stage: string): void;
59
+ }
60
+ //# sourceMappingURL=thread-map.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"thread-map.d.ts","sourceRoot":"","sources":["../../../src/core/stage-extensions/thread-map.ts"],"names":[],"mappings":"AAQA,mBAAmB;AACnB,MAAM,WAAW,cAAc;IAC7B,sDAAsD;IACtD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa;IACb,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,YAAY,EAAE,SAAS,GAAG,iBAAiB,GAAG,IAAI,CAAC;IACnD,qBAAqB;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,wBAAwB;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB;AAeD;;;;GAIG;AACH,qBAAa,SAAS;IACpB,kDAAkD;IAClD,OAAO,CAAC,GAAG,CAAuD;IAElE,kBAAkB;IAClB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC;;;;OAIG;gBACS,QAAQ,EAAE,MAAM,EAAE,SAAS,SAAU;IAIjD;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B3B;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB3B;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIvD;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI;IAOrE;;;OAGG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAGhC"}
@@ -0,0 +1,107 @@
1
+ // thread-map.ts — codex thread id 持久化 map
2
+ // plan-stage-extensions Task 2.3
3
+ // 读写 forge/changes/<changeId>/.codex-threads.yaml,管理每个 stage+extension 的 thread 状态
4
+ import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
5
+ import path from 'node:path';
6
+ import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
7
+ /**
8
+ * ThreadMap — 管理 codex thread id 与轮次记录。
9
+ * 文件路径:<forgeRoot>/changes/<changeId>/.codex-threads.yaml。
10
+ * load() 在文件不存在时返回空 map(不 throw)。
11
+ */
12
+ export class ThreadMap {
13
+ /** 内部存储:stage → extensionName → ThreadMapEntry */
14
+ map = new Map();
15
+ /** YAML 文件绝对路径 */
16
+ filePath;
17
+ /**
18
+ * @param changeId change 目录名(如 'c1')
19
+ * @param forgeRoot forge 根目录;缺省为 'forge'(runner 传入 forgeRoot,测试传 tmpdir)
20
+ * 路径约定:<forgeRoot>/changes/<changeId>/.codex-threads.yaml
21
+ */
22
+ constructor(changeId, forgeRoot = 'forge') {
23
+ this.filePath = path.join(forgeRoot, 'changes', changeId, '.codex-threads.yaml');
24
+ }
25
+ /**
26
+ * 从磁盘加载 YAML 文件。
27
+ * 文件不存在 → 内部 map 清空(空 map,不 throw)。
28
+ * 文件存在但解析失败 → throw(保留异常)。
29
+ */
30
+ async load() {
31
+ this.map = new Map();
32
+ // 直接 readFile + 捕获 ENOENT,避免 existsSync 的 TOCTOU 竞态
33
+ let raw;
34
+ try {
35
+ raw = await readFile(this.filePath, 'utf8');
36
+ }
37
+ catch (e) {
38
+ // 文件不存在是正常情况(首轮),返回空 map;其他错误(损坏/不可读)继续抛出
39
+ if (e.code === 'ENOENT') {
40
+ return;
41
+ }
42
+ throw e;
43
+ }
44
+ const parsed = parseYaml(raw);
45
+ if (!parsed?.threads) {
46
+ // 文件为空或无 threads 段 → 空 map
47
+ return;
48
+ }
49
+ // 将 YAML 对象转换为 Map
50
+ for (const [stage, byName] of Object.entries(parsed.threads)) {
51
+ const stageMap = new Map();
52
+ for (const [name, entry] of Object.entries(byName)) {
53
+ stageMap.set(name, entry);
54
+ }
55
+ this.map.set(stage, stageMap);
56
+ }
57
+ }
58
+ /**
59
+ * 将内部 map 写回 YAML 文件。
60
+ * 若父目录不存在则自动创建。
61
+ * 采用 tmp 文件写 + rename atomic(POSIX + Windows NTFS 同卷),与 forge 其他 state 文件一致。
62
+ */
63
+ async save() {
64
+ const dir = path.dirname(this.filePath);
65
+ await mkdir(dir, { recursive: true });
66
+ // 将 Map 转换为普通对象供 yaml.stringify
67
+ const threads = {};
68
+ for (const [stage, byName] of this.map.entries()) {
69
+ threads[stage] = {};
70
+ for (const [name, entry] of byName.entries()) {
71
+ threads[stage][name] = entry;
72
+ }
73
+ }
74
+ const content = stringifyYaml({ threads });
75
+ // tmp 文件写 + rename atomic(避免半写状态)
76
+ const tmpPath = `${this.filePath}.tmp.${process.pid}`;
77
+ await writeFile(tmpPath, content, 'utf8');
78
+ await rename(tmpPath, this.filePath);
79
+ }
80
+ /**
81
+ * 获取指定 stage + extensionName 的 thread id。
82
+ * 无记录时返回 null(caller 不传 --resume)。
83
+ */
84
+ getThreadId(stage, name) {
85
+ return this.map.get(stage)?.get(name)?.thread_id ?? null;
86
+ }
87
+ /**
88
+ * 记录或更新一轮结果。
89
+ * @param stage stage 名称(如 'review')
90
+ * @param name extension name
91
+ * @param entry 本轮完整记录
92
+ */
93
+ recordRound(stage, name, entry) {
94
+ if (!this.map.has(stage)) {
95
+ this.map.set(stage, new Map());
96
+ }
97
+ this.map.get(stage).set(name, entry);
98
+ }
99
+ /**
100
+ * 删除指定 stage 的全部记录。
101
+ * 跨 stage 切换时使用,确保新 stage 使用新 thread。
102
+ */
103
+ resetStage(stage) {
104
+ this.map.delete(stage);
105
+ }
106
+ }
107
+ //# sourceMappingURL=thread-map.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"thread-map.js","sourceRoot":"","sources":["../../../src/core/stage-extensions/thread-map.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,29 @@
1
+ /**
2
+ * 趋势分析结果。
3
+ * trend:数据不足 / 严格递减 / 停滞 / 上升 / 波动
4
+ * recommended_option:对应 AskUserQuestion 的默认推荐选项(1=继续/2=放弃/3=接受)
5
+ */
6
+ export interface TrendAdvice {
7
+ trend: 'data_insufficient' | 'strict_decrease' | 'stable' | 'increase' | 'fluctuate';
8
+ /** 中文建议文本 */
9
+ recommendation: string;
10
+ /** AskUserQuestion 默认推哪个选项(1/2/3) */
11
+ recommended_option: 1 | 2 | 3;
12
+ }
13
+ /**
14
+ * 分析收敛轮次历史,判断 finding 数量变化趋势。
15
+ *
16
+ * 规则(按优先级顺序):
17
+ * 1. 历史 < 3 轮 → data_insufficient,推选项 1
18
+ * 2. 最后 3 轮严格递减(a > b > c) → strict_decrease,推选项 1
19
+ * 3. 最后 3 轮近平(任意相邻差 ≤ 1) → stable,推选项 2
20
+ * 4. 最后 3 轮有上升(任意后轮 > 前轮) → increase,推选项 2
21
+ * 5. 其他(波动) → fluctuate,推选项 3
22
+ *
23
+ * @param roundHistory 按 round 升序排列的历史记录
24
+ */
25
+ export declare function analyzeTrend(roundHistory: Array<{
26
+ round: number;
27
+ block_count: number;
28
+ }>): TrendAdvice;
29
+ //# sourceMappingURL=trend-analyzer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"trend-analyzer.d.ts","sourceRoot":"","sources":["../../../src/core/stage-extensions/trend-analyzer.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,mBAAmB,GAAG,iBAAiB,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;IACrF,aAAa;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,kBAAkB,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CAC/B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,YAAY,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,GAC1D,WAAW,CAsDb"}