specdojo 0.1.0 → 0.2.1

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 (540) hide show
  1. package/LICENSE +22 -0
  2. package/README.md +142 -35
  3. package/dist/agent-response.js +27 -0
  4. package/dist/agent.js +124 -0
  5. package/dist/build-command.js +149 -0
  6. package/dist/build-if-stale.js +35 -0
  7. package/dist/catalog-build.js +1079 -0
  8. package/dist/catalog-generate.js +226 -0
  9. package/dist/catalog-paths.js +31 -0
  10. package/dist/catalog-plan-generate.js +301 -0
  11. package/dist/catalog-plan-prompt.js +73 -0
  12. package/dist/catalog-plan.js +471 -0
  13. package/dist/catalog-scaffold.js +255 -0
  14. package/dist/catalog-types.js +4 -0
  15. package/dist/catalog.js +606 -0
  16. package/dist/dashboard.js +990 -0
  17. package/dist/deliverable-trash.js +148 -0
  18. package/dist/deliverable.js +97 -0
  19. package/dist/dist-freshness.js +150 -0
  20. package/dist/doc-index.js +424 -0
  21. package/dist/exec-agent-config.js +172 -0
  22. package/dist/exec-agent-git-state.js +136 -0
  23. package/dist/exec-agent-protected-config.js +276 -0
  24. package/dist/exec-events.js +250 -112
  25. package/dist/exec-evidence.js +317 -0
  26. package/dist/exec-format.js +54 -0
  27. package/dist/exec-limit.js +202 -0
  28. package/dist/exec-parent-validation.js +169 -0
  29. package/dist/exec-pipeline-state.js +160 -0
  30. package/dist/exec-plans.js +1016 -0
  31. package/dist/exec-project.js +25 -11
  32. package/dist/exec-protection-handoff.js +169 -0
  33. package/dist/exec-provider-scaffold.js +99 -0
  34. package/dist/exec-register-resume.js +196 -0
  35. package/dist/exec-register.js +281 -0
  36. package/dist/exec-reporter.js +329 -0
  37. package/dist/exec-results.js +510 -0
  38. package/dist/exec-run-lock.js +149 -0
  39. package/dist/exec-run.js +4953 -0
  40. package/dist/exec-schedule-calendar.js +86 -9
  41. package/dist/exec-schedule-cpm.js +30 -12
  42. package/dist/exec-schedule-gantt-chart-render.js +428 -0
  43. package/dist/exec-schedule-gantt-chart-scope.js +111 -0
  44. package/dist/exec-schedule-gantt-chart.js +2 -0
  45. package/dist/exec-schedule-hash.js +34 -25
  46. package/dist/exec-schedule-index.js +200 -67
  47. package/dist/exec-schedule-initial.js +100 -0
  48. package/dist/exec-schedule-progress.js +51 -26
  49. package/dist/exec-schedule-ready.js +71 -27
  50. package/dist/exec-schedule.js +171 -93
  51. package/dist/exec-shared.js +146 -25
  52. package/dist/exec-strategy.js +547 -0
  53. package/dist/exec-task-view.js +64 -0
  54. package/dist/exec-trial.js +895 -0
  55. package/dist/exec-worktree-command.js +426 -0
  56. package/dist/exec-worktree-ops.js +847 -0
  57. package/dist/exec-worktree.js +359 -0
  58. package/dist/exec.js +744 -192
  59. package/dist/frontmatter-namespace.js +48 -0
  60. package/dist/git-environment.js +23 -0
  61. package/dist/grade-result.js +137 -0
  62. package/dist/grade.js +2456 -0
  63. package/dist/index-command.js +103 -0
  64. package/dist/job.js +1081 -0
  65. package/dist/kata-command.js +303 -0
  66. package/dist/kata.js +187 -0
  67. package/dist/package-paths.js +33 -0
  68. package/dist/practice-id.js +24 -0
  69. package/dist/register-date.js +122 -0
  70. package/dist/register-events.js +363 -0
  71. package/dist/register-history.js +323 -0
  72. package/dist/register-item.js +455 -0
  73. package/dist/register-migrate-timestamps.js +176 -0
  74. package/dist/register.js +2199 -0
  75. package/dist/review-plan.js +199 -0
  76. package/dist/review-types.js +1 -0
  77. package/dist/role-types.js +1 -0
  78. package/dist/routine.js +814 -0
  79. package/dist/schedule-approach.js +252 -0
  80. package/dist/schedule-build.js +552 -0
  81. package/dist/schedule-phase-sets.js +73 -0
  82. package/dist/schedule-strategy-generate.js +812 -0
  83. package/dist/schedule-strategy-profiles.js +276 -0
  84. package/dist/schedule.js +420 -0
  85. package/dist/spawn-self.js +28 -0
  86. package/dist/specdojo-config.js +133 -39
  87. package/dist/specdojo.js +56 -7
  88. package/dist/template-frontmatter.js +89 -0
  89. package/dist/template-resolution.js +92 -0
  90. package/dist/timeline-build.js +334 -0
  91. package/dist/timeline.js +107 -0
  92. package/dist/watch.js +313 -0
  93. package/dist/yaml-pages-command.js +28 -0
  94. package/dist/yaml-pages.js +180 -0
  95. package/dist/yaml-schema-modeline.js +49 -0
  96. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +600 -0
  97. package/docs/ja/specdojo/exec-templates/xep-bootstrap-template.md +120 -0
  98. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +37 -0
  99. package/docs/ja/specdojo/exec-templates/xep-cross-deliverable-dedup-template.md +51 -0
  100. package/docs/ja/specdojo/exec-templates/xep-freeform-template.md +74 -0
  101. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +109 -0
  102. package/docs/ja/specdojo/exec-templates/xep-job-template.md +43 -0
  103. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +82 -0
  104. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +86 -0
  105. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +42 -0
  106. package/docs/ja/specdojo/exec-templates/xep-register-template.md +49 -0
  107. package/docs/ja/specdojo/exec-templates/xep-retrofit-template.md +98 -0
  108. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +86 -0
  109. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +86 -0
  110. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +86 -0
  111. package/docs/ja/specdojo/exec-templates/xep-template.md +66 -0
  112. package/docs/ja/specdojo/exec-templates/xer-cross-deliverable-dedup-template.md +31 -0
  113. package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +40 -0
  114. package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +30 -0
  115. package/docs/ja/specdojo/exec-templates/xer-template.md +19 -0
  116. package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +70 -0
  117. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +97 -0
  118. package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +76 -0
  119. package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +73 -0
  120. package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +74 -0
  121. package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +74 -0
  122. package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +73 -0
  123. package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +73 -0
  124. package/docs/ja/specdojo/exec-templates/xrp-template.md +67 -0
  125. package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +7 -0
  126. package/docs/ja/specdojo/exec-templates/xrr-template.md +21 -0
  127. package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +7 -0
  128. package/docs/ja/specdojo/guides/branch-workflow-guide.md +354 -0
  129. package/docs/ja/specdojo/guides/docs-editing-guide.md +327 -0
  130. package/docs/ja/specdojo/guides/docs-structure-guide.md +519 -0
  131. package/docs/ja/specdojo/guides/exec-config-guide.md +589 -0
  132. package/docs/ja/specdojo/guides/exec-operation-guide.md +440 -0
  133. package/docs/ja/specdojo/guides/exec-worktree-guide.md +318 -0
  134. package/docs/ja/specdojo/guides/kata-guide.md +89 -0
  135. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +127 -0
  136. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +228 -0
  137. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +111 -0
  138. package/docs/ja/specdojo/guides/quick-start-guide.md +472 -0
  139. package/docs/ja/specdojo/guides/register-operation-guide.md +418 -0
  140. package/docs/ja/specdojo/guides/remote-host-development-guide.md +163 -0
  141. package/docs/ja/specdojo/guides/review-guide.md +428 -0
  142. package/docs/ja/specdojo/guides/routine-operation-guide.md +282 -0
  143. package/docs/ja/specdojo/guides/ryu-guide.md +230 -0
  144. package/docs/ja/specdojo/guides/schedule-design-guide.md +429 -0
  145. package/docs/ja/specdojo/guides/schedule-operation-guide.md +151 -0
  146. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +257 -0
  147. package/docs/ja/specdojo/guides/timeline-design-guide.md +160 -0
  148. package/docs/ja/specdojo/guides/track-design-guide.md +215 -0
  149. package/docs/ja/specdojo/guides/use-case-guide.md +133 -0
  150. package/docs/ja/specdojo/guides/waza-guide.md +224 -0
  151. package/docs/ja/specdojo/index.md +33 -0
  152. package/docs/ja/specdojo/philosophy/needs-to-implementation-philosophy.md +212 -0
  153. package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +242 -0
  154. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +198 -0
  155. package/docs/ja/specdojo/recipes/cdfd-recipe.md +218 -0
  156. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +198 -0
  157. package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +100 -0
  158. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +148 -0
  159. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +97 -0
  160. package/docs/ja/specdojo/recipes/pm-members-recipe.md +149 -0
  161. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +96 -0
  162. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +98 -0
  163. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +97 -0
  164. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +96 -0
  165. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +136 -0
  166. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +162 -0
  167. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +187 -0
  168. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +235 -0
  169. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +205 -0
  170. package/docs/ja/specdojo/recipes/prj-overview-recipe.md +289 -0
  171. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +201 -0
  172. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +168 -0
  173. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +179 -0
  174. package/docs/ja/specdojo/recipes/stsd-recipe.md +138 -0
  175. package/docs/ja/specdojo/references/command-reference.md +718 -0
  176. package/docs/ja/specdojo/references/deliverables-reference.md +407 -0
  177. package/docs/ja/specdojo/references/directory-layout-reference.md +280 -0
  178. package/docs/ja/specdojo/references/specdojo-config-reference.md +133 -0
  179. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +372 -0
  180. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +302 -0
  181. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +331 -0
  182. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +134 -0
  183. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +207 -0
  184. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +102 -0
  185. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +131 -0
  186. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +269 -0
  187. package/docs/ja/specdojo/rulebooks/br-rulebook.md +187 -0
  188. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +279 -0
  189. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +219 -0
  190. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +233 -0
  191. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +182 -0
  192. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +171 -0
  193. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +105 -0
  194. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +195 -0
  195. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +285 -0
  196. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +292 -0
  197. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +171 -0
  198. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +325 -0
  199. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +266 -0
  200. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +294 -0
  201. package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +21 -0
  202. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +401 -0
  203. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +311 -0
  204. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +158 -0
  205. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +287 -0
  206. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +62 -0
  207. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +100 -0
  208. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +298 -0
  209. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +379 -0
  210. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +310 -0
  211. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +86 -0
  212. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +297 -0
  213. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +79 -0
  214. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +213 -0
  215. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +311 -0
  216. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +94 -0
  217. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +81 -0
  218. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +117 -0
  219. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +118 -0
  220. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +116 -0
  221. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +116 -0
  222. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +116 -0
  223. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +421 -0
  224. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +307 -0
  225. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +312 -0
  226. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +63 -0
  227. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +353 -0
  228. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +184 -0
  229. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +179 -0
  230. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +184 -0
  231. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +183 -0
  232. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +185 -0
  233. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +185 -0
  234. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +186 -0
  235. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +186 -0
  236. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +184 -0
  237. package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +61 -0
  238. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +84 -0
  239. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +357 -0
  240. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +80 -0
  241. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +484 -0
  242. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +120 -0
  243. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +293 -0
  244. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +211 -0
  245. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +94 -0
  246. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +116 -0
  247. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +93 -0
  248. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +190 -0
  249. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +108 -0
  250. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +122 -0
  251. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +117 -0
  252. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +116 -0
  253. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +93 -0
  254. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +146 -0
  255. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +65 -0
  256. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +178 -0
  257. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +232 -0
  258. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +235 -0
  259. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +242 -0
  260. package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +187 -0
  261. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +201 -0
  262. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +165 -0
  263. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +165 -0
  264. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +202 -0
  265. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +139 -0
  266. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +63 -0
  267. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +93 -0
  268. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +93 -0
  269. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +329 -0
  270. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +297 -0
  271. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +132 -0
  272. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +215 -0
  273. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +376 -0
  274. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +313 -0
  275. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +246 -0
  276. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +119 -0
  277. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +188 -0
  278. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +114 -0
  279. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +117 -0
  280. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +101 -0
  281. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +103 -0
  282. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +396 -0
  283. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +207 -0
  284. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +387 -0
  285. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +303 -0
  286. package/docs/ja/specdojo/samples/atc-index-sample.md +38 -0
  287. package/docs/ja/specdojo/samples/atc-sample.md +41 -0
  288. package/docs/ja/specdojo/samples/bac-sample.md +38 -0
  289. package/docs/ja/specdojo/samples/bdd-sample.yaml +71 -0
  290. package/docs/ja/specdojo/samples/bds-sample.md +38 -0
  291. package/docs/ja/specdojo/samples/bes-index-sample.md +38 -0
  292. package/docs/ja/specdojo/samples/bes-sample.md +38 -0
  293. package/docs/ja/specdojo/samples/bps-sample.md +38 -0
  294. package/docs/ja/specdojo/samples/br-sample.md +40 -0
  295. package/docs/ja/specdojo/samples/ccd-sample.md +38 -0
  296. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +284 -0
  297. package/docs/ja/specdojo/samples/cdfd-sample.md +229 -0
  298. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +146 -0
  299. package/docs/ja/specdojo/samples/cdsd-sample.md +38 -0
  300. package/docs/ja/specdojo/samples/cld-sample.md +38 -0
  301. package/docs/ja/specdojo/samples/cnd-sample.md +38 -0
  302. package/docs/ja/specdojo/samples/cop-index-sample.md +38 -0
  303. package/docs/ja/specdojo/samples/cop-sample.md +38 -0
  304. package/docs/ja/specdojo/samples/cpd-sample.md +38 -0
  305. package/docs/ja/specdojo/samples/cstd-sample.md +11 -0
  306. package/docs/ja/specdojo/samples/cxd-sample.md +38 -0
  307. package/docs/ja/specdojo/samples/dct-index-sample.yaml +39 -0
  308. package/docs/ja/specdojo/samples/dct-sample.yaml +91 -0
  309. package/docs/ja/specdojo/samples/dec-sample.md +39 -0
  310. package/docs/ja/specdojo/samples/dmd-index-sample.md +50 -0
  311. package/docs/ja/specdojo/samples/dmd-sample.md +74 -0
  312. package/docs/ja/specdojo/samples/etc-index-sample.md +38 -0
  313. package/docs/ja/specdojo/samples/etc-sample.md +38 -0
  314. package/docs/ja/specdojo/samples/gl-sample.yaml +37 -0
  315. package/docs/ja/specdojo/samples/ifd-sample.md +38 -0
  316. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +102 -0
  317. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +107 -0
  318. package/docs/ja/specdojo/samples/ifx-file-sample.md +38 -0
  319. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +89 -0
  320. package/docs/ja/specdojo/samples/imp-business-sample.md +66 -0
  321. package/docs/ja/specdojo/samples/imp-data-sample.md +60 -0
  322. package/docs/ja/specdojo/samples/imp-interface-sample.md +60 -0
  323. package/docs/ja/specdojo/samples/imp-operations-sample.md +60 -0
  324. package/docs/ja/specdojo/samples/imp-test-sample.md +60 -0
  325. package/docs/ja/specdojo/samples/itc-index-sample.md +38 -0
  326. package/docs/ja/specdojo/samples/itc-sample.md +38 -0
  327. package/docs/ja/specdojo/samples/mip-index-sample.md +38 -0
  328. package/docs/ja/specdojo/samples/mm-sample.md +35 -0
  329. package/docs/ja/specdojo/samples/mtp-sample.md +38 -0
  330. package/docs/ja/specdojo/samples/nfr-availability-sample.md +38 -0
  331. package/docs/ja/specdojo/samples/nfr-index-sample.md +38 -0
  332. package/docs/ja/specdojo/samples/nfr-integrity-sample.md +38 -0
  333. package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +38 -0
  334. package/docs/ja/specdojo/samples/nfr-operations-sample.md +38 -0
  335. package/docs/ja/specdojo/samples/nfr-performance-sample.md +38 -0
  336. package/docs/ja/specdojo/samples/nfr-reliability-sample.md +38 -0
  337. package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +38 -0
  338. package/docs/ja/specdojo/samples/nfr-usability-sample.md +38 -0
  339. package/docs/ja/specdojo/samples/ntp-sample.md +38 -0
  340. package/docs/ja/specdojo/samples/opd-access-control-sample.md +29 -0
  341. package/docs/ja/specdojo/samples/opd-incident-management-sample.md +31 -0
  342. package/docs/ja/specdojo/samples/opd-index-sample.md +41 -0
  343. package/docs/ja/specdojo/samples/opd-monitoring-sample.md +32 -0
  344. package/docs/ja/specdojo/samples/opd-sample.md +38 -0
  345. package/docs/ja/specdojo/samples/opr-access-control-sample.md +24 -0
  346. package/docs/ja/specdojo/samples/opr-backup-restore-sample.md +27 -0
  347. package/docs/ja/specdojo/samples/opr-batch-sample.md +23 -0
  348. package/docs/ja/specdojo/samples/opr-change-sample.md +24 -0
  349. package/docs/ja/specdojo/samples/opr-incident-sample.md +38 -0
  350. package/docs/ja/specdojo/samples/opr-index-sample.md +43 -0
  351. package/docs/ja/specdojo/samples/opr-monitoring-sample.md +27 -0
  352. package/docs/ja/specdojo/samples/opr-sample.md +38 -0
  353. package/docs/ja/specdojo/samples/opr-support-sample.md +23 -0
  354. package/docs/ja/specdojo/samples/otp-index-sample.md +66 -0
  355. package/docs/ja/specdojo/samples/otp-sample.md +68 -0
  356. package/docs/ja/specdojo/samples/pm-change-request-log-sample.md +47 -0
  357. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +46 -0
  358. package/docs/ja/specdojo/samples/pm-issue-log-sample.md +45 -0
  359. package/docs/ja/specdojo/samples/pm-members-sample.yaml +103 -0
  360. package/docs/ja/specdojo/samples/pm-organization-sample.md +46 -0
  361. package/docs/ja/specdojo/samples/pm-plan-sample.md +57 -0
  362. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +52 -0
  363. package/docs/ja/specdojo/samples/pm-raci-sample.md +57 -0
  364. package/docs/ja/specdojo/samples/pm-risk-register-sample.md +43 -0
  365. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +41 -0
  366. package/docs/ja/specdojo/samples/pr-sample.md +39 -0
  367. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +57 -0
  368. package/docs/ja/specdojo/samples/prj-charter-sample.md +121 -0
  369. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +105 -0
  370. package/docs/ja/specdojo/samples/prj-issues-and-approach-sample.md +78 -0
  371. package/docs/ja/specdojo/samples/prj-overview-sample.md +95 -0
  372. package/docs/ja/specdojo/samples/prj-scope-sample.md +71 -0
  373. package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +60 -0
  374. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +62 -0
  375. package/docs/ja/specdojo/samples/sac-sample.md +38 -0
  376. package/docs/ja/specdojo/samples/sf-index-sample.md +38 -0
  377. package/docs/ja/specdojo/samples/sf-sample.md +38 -0
  378. package/docs/ja/specdojo/samples/sld-sample.md +38 -0
  379. package/docs/ja/specdojo/samples/stc-index-sample.md +38 -0
  380. package/docs/ja/specdojo/samples/stc-sample.md +38 -0
  381. package/docs/ja/specdojo/samples/stsd-sample.md +58 -0
  382. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +38 -0
  383. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +38 -0
  384. package/docs/ja/specdojo/samples/sysd-index-sample.md +38 -0
  385. package/docs/ja/specdojo/samples/trc-requirements-to-specs-sample.md +56 -0
  386. package/docs/ja/specdojo/samples/trc-requirements-to-tests-sample.md +56 -0
  387. package/docs/ja/specdojo/samples/tsd-index-sample.md +29 -0
  388. package/docs/ja/specdojo/samples/tsd-sample.md +38 -0
  389. package/docs/ja/specdojo/samples/tsp-index-sample.md +38 -0
  390. package/docs/ja/specdojo/samples/uis-sample.md +38 -0
  391. package/docs/ja/specdojo/samples/utc-index-sample.md +38 -0
  392. package/docs/ja/specdojo/samples/utc-sample.md +38 -0
  393. package/docs/ja/specdojo/schemas/v1/guide-content.schema.yaml +20 -0
  394. package/docs/ja/specdojo/schemas/v1/philosophy-content.schema.yaml +21 -0
  395. package/docs/ja/specdojo/schemas/v1/reference-content.schema.yaml +21 -0
  396. package/docs/ja/specdojo/standards/document-metadata-standard.md +323 -0
  397. package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +75 -0
  398. package/docs/ja/specdojo/standards/git-branching-standard.md +227 -0
  399. package/docs/ja/specdojo/standards/guide-authoring-standard.md +124 -0
  400. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +929 -0
  401. package/docs/ja/specdojo/standards/job-definition-standard.md +148 -0
  402. package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +431 -0
  403. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +113 -0
  404. package/docs/ja/specdojo/standards/recipe-authoring-standard.md +143 -0
  405. package/docs/ja/specdojo/standards/reference-authoring-standard.md +99 -0
  406. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +140 -0
  407. package/docs/ja/specdojo/standards/sample-authoring-standard.md +151 -0
  408. package/docs/ja/specdojo/standards/standard-authoring-standard.md +108 -0
  409. package/docs/ja/specdojo/standards/template-authoring-standard.md +101 -0
  410. package/docs/ja/specdojo/standards/test-document-scope-standard.md +176 -0
  411. package/docs/ja/specdojo/templates/cdfd-overview-template.md +199 -0
  412. package/docs/ja/specdojo/templates/cdfd-template.md +173 -0
  413. package/docs/ja/specdojo/templates/cdfd-uc-template.md +148 -0
  414. package/docs/ja/specdojo/templates/dct-architecture-template.yaml +136 -0
  415. package/docs/ja/specdojo/templates/dct-business-acceptance-criteria-template.yaml +34 -0
  416. package/docs/ja/specdojo/templates/dct-business-model-bes-template.yaml +75 -0
  417. package/docs/ja/specdojo/templates/dct-business-model-bps-template.yaml +49 -0
  418. package/docs/ja/specdojo/templates/dct-business-model-br-template.yaml +50 -0
  419. package/docs/ja/specdojo/templates/dct-data-flow-template.yaml +40 -0
  420. package/docs/ja/specdojo/templates/dct-data-model-bdd-template.yaml +46 -0
  421. package/docs/ja/specdojo/templates/dct-data-model-ccd-template.yaml +46 -0
  422. package/docs/ja/specdojo/templates/dct-data-model-cdsd-template.yaml +41 -0
  423. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +38 -0
  424. package/docs/ja/specdojo/templates/dct-data-model-sld-template.yaml +38 -0
  425. package/docs/ja/specdojo/templates/dct-data-model-stsd-template.yaml +46 -0
  426. package/docs/ja/specdojo/templates/dct-external-interface-specs-template.yaml +114 -0
  427. package/docs/ja/specdojo/templates/dct-glossary-template.yaml +35 -0
  428. package/docs/ja/specdojo/templates/dct-impact-analysis-template.yaml +138 -0
  429. package/docs/ja/specdojo/templates/dct-index-template.md +40 -0
  430. package/docs/ja/specdojo/templates/dct-migration-planning-template.yaml +148 -0
  431. package/docs/ja/specdojo/templates/dct-non-functional-requirements-template.yaml +222 -0
  432. package/docs/ja/specdojo/templates/dct-operations-template.yaml +108 -0
  433. package/docs/ja/specdojo/templates/dct-project-definition-template.yaml +210 -0
  434. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +423 -0
  435. package/docs/ja/specdojo/templates/dct-system-acceptance-criteria-template.yaml +37 -0
  436. package/docs/ja/specdojo/templates/dct-system-design-template.yaml +82 -0
  437. package/docs/ja/specdojo/templates/dct-system-functions-template.yaml +58 -0
  438. package/docs/ja/specdojo/templates/dct-test-specs-template.yaml +261 -0
  439. package/docs/ja/specdojo/templates/dct-user-interface-model-template.yaml +60 -0
  440. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +88 -0
  441. package/docs/ja/specdojo/templates/opr-template.md +85 -0
  442. package/docs/ja/specdojo/templates/pjr-change-request-template.md +60 -0
  443. package/docs/ja/specdojo/templates/pjr-decision-template.md +61 -0
  444. package/docs/ja/specdojo/templates/pjr-index-template.md +49 -0
  445. package/docs/ja/specdojo/templates/pjr-issue-template.md +50 -0
  446. package/docs/ja/specdojo/templates/pjr-note-template.md +35 -0
  447. package/docs/ja/specdojo/templates/pjr-question-template.md +53 -0
  448. package/docs/ja/specdojo/templates/pjr-risk-template.md +49 -0
  449. package/docs/ja/specdojo/templates/pjr-todo-template.md +41 -0
  450. package/docs/ja/specdojo/templates/pjr-views-by-owner-template.md +22 -0
  451. package/docs/ja/specdojo/templates/pjr-views-by-priority-template.md +22 -0
  452. package/docs/ja/specdojo/templates/pjr-views-by-status-template.md +22 -0
  453. package/docs/ja/specdojo/templates/pm-change-request-log-template.md +20 -0
  454. package/docs/ja/specdojo/templates/pm-communication-plan-template.md +46 -0
  455. package/docs/ja/specdojo/templates/pm-decision-log-template.md +20 -0
  456. package/docs/ja/specdojo/templates/pm-issue-log-template.md +20 -0
  457. package/docs/ja/specdojo/templates/pm-members-template.yaml +105 -0
  458. package/docs/ja/specdojo/templates/pm-organization-template.md +44 -0
  459. package/docs/ja/specdojo/templates/pm-plan-template.md +52 -0
  460. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +46 -0
  461. package/docs/ja/specdojo/templates/pm-raci-template.md +51 -0
  462. package/docs/ja/specdojo/templates/pm-risk-register-template.md +20 -0
  463. package/docs/ja/specdojo/templates/pm-roles-template.yaml +53 -0
  464. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +59 -0
  465. package/docs/ja/specdojo/templates/prj-charter-template.md +116 -0
  466. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +116 -0
  467. package/docs/ja/specdojo/templates/prj-issues-and-approach-template.md +89 -0
  468. package/docs/ja/specdojo/templates/prj-overview-template.md +85 -0
  469. package/docs/ja/specdojo/templates/prj-scope-template.md +75 -0
  470. package/docs/ja/specdojo/templates/prj-stakeholder-register-template.md +64 -0
  471. package/docs/ja/specdojo/templates/prj-success-criteria-and-acceptance-criteria-template.md +60 -0
  472. package/docs/ja/specdojo/templates/stsd-template.md +57 -0
  473. package/docs/specdojo/schemas/v1/bdd.schema.yaml +230 -0
  474. package/docs/specdojo/schemas/v1/common-frontmatter.schema.yaml +77 -0
  475. package/docs/specdojo/schemas/v1/dct-index.schema.yaml +85 -0
  476. package/docs/specdojo/schemas/v1/dct-plan.schema.yaml +324 -0
  477. package/docs/specdojo/schemas/v1/dct.schema.yaml +368 -0
  478. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +91 -0
  479. package/docs/specdojo/schemas/v1/esil.schema.yaml +142 -0
  480. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +101 -0
  481. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +272 -0
  482. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +162 -0
  483. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +126 -0
  484. package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +151 -0
  485. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +144 -0
  486. package/docs/specdojo/schemas/v1/grade-done-criteria.schema.yaml +79 -0
  487. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +60 -0
  488. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +118 -0
  489. package/docs/specdojo/schemas/v1/guide-frontmatter.schema.yaml +19 -0
  490. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +293 -0
  491. package/docs/specdojo/schemas/v1/job-run.schema.yaml +90 -0
  492. package/docs/specdojo/schemas/v1/job.schema.yaml +198 -0
  493. package/docs/specdojo/schemas/v1/philosophy-frontmatter.schema.yaml +19 -0
  494. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +56 -0
  495. package/docs/specdojo/schemas/v1/pm-members.schema.yaml +252 -0
  496. package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +387 -0
  497. package/docs/specdojo/schemas/v1/pm-roles.schema.yaml +106 -0
  498. package/docs/specdojo/schemas/v1/recipe-frontmatter.schema.yaml +27 -0
  499. package/docs/specdojo/schemas/v1/reference-frontmatter.schema.yaml +18 -0
  500. package/docs/specdojo/schemas/v1/register-events.schema.yaml +106 -0
  501. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +204 -0
  502. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +36 -0
  503. package/docs/specdojo/schemas/v1/routine.schema.yaml +87 -0
  504. package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +61 -0
  505. package/docs/specdojo/schemas/v1/sch-common.schema.yaml +258 -0
  506. package/docs/specdojo/schemas/v1/sch-defaults.schema.yaml +48 -0
  507. package/docs/specdojo/schemas/v1/sch-milestones.schema.yaml +64 -0
  508. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +772 -0
  509. package/docs/specdojo/schemas/v1/sch-track.schema.yaml +66 -0
  510. package/docs/specdojo/schemas/v1/standard-frontmatter.schema.yaml +18 -0
  511. package/docs/specdojo/schemas/v1/tml-index.schema.yaml +103 -0
  512. package/package.json +121 -24
  513. package/templates/antigravity/README.md +35 -0
  514. package/templates/antigravity/exec-defaults-snippet.yaml +38 -0
  515. package/templates/antigravity/orchestrator.md +146 -0
  516. package/templates/antigravity/pm-members-snippet.yaml +55 -0
  517. package/templates/claude/README.md +46 -0
  518. package/templates/claude/agents/claude-expert-review-executor.md +14 -0
  519. package/templates/claude/agents/claude-review-executor.md +14 -0
  520. package/templates/claude/agents/specdojo-orchestrator.md +153 -0
  521. package/templates/claude/settings.edit.json +6 -0
  522. package/templates/claude/settings.report.json +6 -0
  523. package/templates/claude/settings.review.json +7 -0
  524. package/templates/codex/README.md +61 -0
  525. package/templates/codex/agents/codex-executor.toml +12 -0
  526. package/templates/codex/agents/codex-expert-executor.toml +12 -0
  527. package/templates/codex/agents/codex-expert-review-executor.toml +10 -0
  528. package/templates/codex/agents/codex-review-executor.toml +10 -0
  529. package/templates/codex/agents/specdojo-orchestrator.toml +154 -0
  530. package/templates/codex/orchestrator.md +146 -0
  531. package/templates/copilot/README.md +41 -0
  532. package/templates/copilot/exec-defaults-snippet.yaml +28 -0
  533. package/templates/copilot/pm-members-snippet.yaml +44 -0
  534. package/templates/opencode/README.md +41 -0
  535. package/templates/opencode/agents/opencode-executor.md +59 -0
  536. package/templates/opencode/agents/opencode-reporter.md +26 -0
  537. package/templates/opencode/agents/opencode-review-executor.md +48 -0
  538. package/templates/opencode/agents/specdojo-orchestrator.md +193 -0
  539. package/dist/exec-schedule-timeline-render.js +0 -201
  540. package/dist/exec-schedule-timeline.js +0 -2
@@ -0,0 +1,281 @@
1
+ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
2
+ import { join, relative } from "node:path";
3
+ import { findRegisterItem, loadRegisterItems, PJR_ID_RE, resolveRegisterPaths, TERMINAL_STATUSES_SET, VALID_PRIORITIES, VALID_STATUSES, VALID_TYPES, } from "./register.js";
4
+ import { execTemplatePath, injectCommonConventions, MISSING, registerGradeFindingsText, } from "./exec-plans.js";
5
+ import { buildSpecdojoFrontmatter } from "./frontmatter-namespace.js";
6
+ import { escapeMarkdownInline, expandTemplate, inlineCodeAnglePlaceholders, stripTerminalControlSequences, } from "./exec-shared.js";
7
+ import { formatMarkdownFile } from "./exec-format.js";
8
+ import { specdojoRootDir } from "./specdojo-config.js";
9
+ const EDIT_TYPES = new Set(["todo", "issue", "change-request"]);
10
+ const INVESTIGATE_TYPES = new Set(["question", "risk"]);
11
+ export function registerItemCategory(itemType) {
12
+ if (EDIT_TYPES.has(itemType))
13
+ return "edit";
14
+ if (INVESTIGATE_TYPES.has(itemType))
15
+ return "investigate";
16
+ return null;
17
+ }
18
+ const DEFAULT_SELECTION_TYPES = VALID_TYPES.filter((type) => registerItemCategory(type) !== null);
19
+ function parseRegisterFilterList(value, name, allowed) {
20
+ if (value === undefined)
21
+ return undefined;
22
+ const values = value
23
+ .split(",")
24
+ .map((item) => item.trim())
25
+ .filter(Boolean);
26
+ if (values.length === 0)
27
+ throw new Error(`${name} must contain at least one value`);
28
+ for (const item of values) {
29
+ if (!allowed.includes(item)) {
30
+ throw new Error(`${name} contains unknown value "${item}". Allowed: ${allowed.join(", ")}`);
31
+ }
32
+ }
33
+ return [...new Set(values)];
34
+ }
35
+ export function parseRegisterSelectionFilter(opts) {
36
+ const types = parseRegisterFilterList(opts.types, "--register-types", VALID_TYPES);
37
+ const priorities = parseRegisterFilterList(opts.priorities, "--register-priorities", VALID_PRIORITIES);
38
+ const statuses = parseRegisterFilterList(opts.statuses, "--register-statuses", VALID_STATUSES);
39
+ let limit;
40
+ if (opts.limit !== undefined) {
41
+ if (!/^[1-9]\d*$/.test(opts.limit)) {
42
+ throw new Error(`--register-limit must be a positive integer: ${opts.limit}`);
43
+ }
44
+ limit = Number.parseInt(opts.limit, 10);
45
+ if (!Number.isSafeInteger(limit)) {
46
+ throw new Error(`--register-limit must be a positive integer: ${opts.limit}`);
47
+ }
48
+ }
49
+ return {
50
+ ...(types ? { types } : {}),
51
+ ...(priorities ? { priorities } : {}),
52
+ ...(statuses ? { statuses } : {}),
53
+ ...(limit !== undefined ? { limit } : {}),
54
+ };
55
+ }
56
+ export function selectRegisterItems(items, filter) {
57
+ const types = filter.types ?? DEFAULT_SELECTION_TYPES;
58
+ const statuses = filter.statuses ?? ["open"];
59
+ const selected = items
60
+ .filter((item) => registerItemCategory(item.type) !== null &&
61
+ types.includes(item.type) &&
62
+ statuses.includes(item.status) &&
63
+ (!filter.priorities || filter.priorities.includes(item.priority)))
64
+ .sort((a, b) => a.id.localeCompare(b.id));
65
+ return filter.limit === undefined ? selected : selected.slice(0, filter.limit);
66
+ }
67
+ // 実行可能な登録項目かを検証し、実行区分を返す。実行対象外の type と終端状態は
68
+ // 実行前に理由つきで拒否する(終端状態は `register reopen` での復帰を促す)。
69
+ export function requireRunnableRegisterItem(item) {
70
+ const category = registerItemCategory(item.type);
71
+ if (!category) {
72
+ throw new Error(`Register item ${item.id} has type "${item.type}", which is not executable. ` +
73
+ `Executable types: ${[...EDIT_TYPES, ...INVESTIGATE_TYPES].join(", ")}`);
74
+ }
75
+ if (TERMINAL_STATUSES_SET.has(item.status)) {
76
+ throw new Error(`Register item ${item.id} has terminal status "${item.status}". Use "register reopen" first.`);
77
+ }
78
+ return category;
79
+ }
80
+ // 全ID処理後にID別の成否・状態遷移・commit結果・理由を一覧表示するための整形。
81
+ export function formatRegisterRunSummary(summaries) {
82
+ const lines = ["Register run summary:"];
83
+ for (const summary of summaries) {
84
+ const parts = [
85
+ ` ${summary.id}`,
86
+ summary.outcome.padEnd(7),
87
+ `transition=${summary.transition}`,
88
+ `commit=${summary.commit}`,
89
+ ];
90
+ if (summary.reason)
91
+ parts.push(`reason=${summary.reason}`);
92
+ lines.push(parts.join(" "));
93
+ }
94
+ return lines.join("\n");
95
+ }
96
+ // いずれかのIDが failure なら異常終了(exit 1)とする。skipped は失敗とは扱わないが、
97
+ // 停止(stop)は先行する failure を伴うため結果的に exit 1 になる。
98
+ export function registerRunExitCode(summaries) {
99
+ return summaries.some((summary) => summary.outcome === "failure") ? 1 : 0;
100
+ }
101
+ // ---------------------------------------------------------------------------
102
+ // Item resolution
103
+ // ---------------------------------------------------------------------------
104
+ export function normalizePjrId(value) {
105
+ const id = value.trim().toUpperCase();
106
+ if (!PJR_ID_RE.test(id)) {
107
+ throw new Error(`Invalid register item ID: "${value}". Must match PJR-XXXX (e.g., PJR-0012)`);
108
+ }
109
+ return id;
110
+ }
111
+ export function isRegisterFailureMode(value) {
112
+ return value === "stop" || value === "continue";
113
+ }
114
+ // `--register` の入力(単一文字列・カンマ区切り・variadic 配列・その混在)を
115
+ // PJR-ID の実行順リストへ正規化する。各要素は normalizePjrId で検証し、指定順を
116
+ // 保持したまま重複は最初の出現のみ残す。除外した重複IDは duplicates に記録する。
117
+ export function parseRegisterIds(raw) {
118
+ const tokens = [];
119
+ const rawValues = raw === undefined ? [] : Array.isArray(raw) ? raw : [raw];
120
+ for (const value of rawValues) {
121
+ for (const part of value.split(",")) {
122
+ const trimmed = part.trim();
123
+ if (trimmed !== "")
124
+ tokens.push(trimmed);
125
+ }
126
+ }
127
+ if (tokens.length === 0) {
128
+ throw new Error("No register item ID specified. Provide at least one PJR-XXXX id.");
129
+ }
130
+ const ids = [];
131
+ const duplicates = [];
132
+ const seen = new Set();
133
+ for (const token of tokens) {
134
+ const id = normalizePjrId(token);
135
+ if (seen.has(id)) {
136
+ duplicates.push(id);
137
+ continue;
138
+ }
139
+ seen.add(id);
140
+ ids.push(id);
141
+ }
142
+ return { ids, duplicates };
143
+ }
144
+ // ID単位 commit の対象パスを算出する。項目実行の開始前スナップショット(preexisting)に
145
+ // 無く、実行後(current)に現れた変更パスを返す。ただし runnerManaged に明示された
146
+ // 登録簿・派生ビュー・当該 plan/result は、失敗試行などで開始前から dirty でも対象にする。
147
+ // これにより利用者の既存変更を保護しつつ、runner 自身の状態遷移は取りこぼさない。
148
+ // 戻り値は再現性のため重複除去してソートする。
149
+ export function selectRegisterCommitPaths(preexisting, current, runnerManaged = []) {
150
+ const before = new Set(preexisting);
151
+ const managed = new Set(runnerManaged);
152
+ const added = new Set();
153
+ for (const path of current) {
154
+ if (!before.has(path) || managed.has(path))
155
+ added.add(path);
156
+ }
157
+ return [...added].sort();
158
+ }
159
+ // 過去の register 実行が未commitのまま残した plan/result を抽出する。現在の実行が
160
+ // 生成する前のスナップショットへ適用し、別IDの履歴へ暗黙に混ぜず警告するために使う。
161
+ export function selectRegisterRunArtifactResidue(paths) {
162
+ const residue = new Set();
163
+ for (const path of paths) {
164
+ const normalized = path.replaceAll("\\", "/");
165
+ if (/(?:^|\/)exec\/(?:plans|results)\/pjr-\d{4}-\d{8}T\d{6}Z-[a-f0-9]+-(?:plan|result)\.md$/i.test(normalized)) {
166
+ residue.add(path);
167
+ }
168
+ }
169
+ return [...residue].sort();
170
+ }
171
+ export function resolveRegisterRunTarget(projectId, pjrId) {
172
+ const registerPaths = resolveRegisterPaths({ project: projectId });
173
+ if (!existsSync(registerPaths.projectRegisterPath)) {
174
+ throw new Error(`Project register directory not found: ${registerPaths.projectRegisterPath}\n` +
175
+ `Run: specdojo register scaffold --project ${projectId}`);
176
+ }
177
+ // 登録項目の正本は個票 frontmatter。個票が無い(未移行の)項目は pjr-index の行から読む。
178
+ const view = findRegisterItem(loadRegisterItems(registerPaths), pjrId);
179
+ if (!view) {
180
+ throw new Error(`Register item not found in ${registerPaths.projectRegisterPath}: ${pjrId}`);
181
+ }
182
+ return { registerPaths, item: view.item };
183
+ }
184
+ // 登録簿の個票列(`[label](./file.md)` 形式)から個票の絶対パスを取り出す。
185
+ // 個票なし(`-`)やリンク以外の値は null を返す。
186
+ export function ticketPathFromItem(item, projectRegisterPath) {
187
+ const match = item.ticket.match(/\]\(\.\/([^)]+)\)/);
188
+ if (!match)
189
+ return null;
190
+ return join(projectRegisterPath, match[1]);
191
+ }
192
+ // runner が register の結論列(Markdown 表セル)に書く失敗理由を安全な 1 行へ整形する。
193
+ // 失敗理由には subprocess の生出力が含まれうるため、まず ANSI エスケープシーケンスや
194
+ // 制御文字を除去する(lefthook 等の色付き出力が結論列を破壊するのを防ぐ)。そのうえで
195
+ // セル内の `|` と改行は表を壊すため置換し、読みやすさのため長さも制限する。
196
+ const MAX_CONCLUSION_LENGTH = 200;
197
+ export function sanitizeRegisterConclusion(reason) {
198
+ const singleLine = stripTerminalControlSequences(reason)
199
+ .replace(/\r?\n/g, " ")
200
+ .replace(/\|/g, "/")
201
+ .trim();
202
+ const truncated = singleLine.length <= MAX_CONCLUSION_LENGTH
203
+ ? singleLine
204
+ : `${singleLine.slice(0, MAX_CONCLUSION_LENGTH)}…`;
205
+ return inlineCodeAnglePlaceholders(truncated);
206
+ }
207
+ // ---------------------------------------------------------------------------
208
+ // Plan generation
209
+ // ---------------------------------------------------------------------------
210
+ const REGISTER_PLAN_TEMPLATES = {
211
+ edit: "xep-register-template.md",
212
+ investigate: "xep-register-investigate-template.md",
213
+ };
214
+ // Canonical repo-root-relative path (POSIX separators, no leading slash); mirrors the
215
+ // convention used by exec-plans for agent-consumed paths.
216
+ function repoRelativePath(absPath) {
217
+ return relative(specdojoRootDir(), absPath).replace(/\\/g, "/");
218
+ }
219
+ // register plan の frontmatter。exec-plan と同じ規約(specdojo 名前空間・xep doc id)に
220
+ // 合わせるが、task_id は schedule のタスクではなく登録項目 ID(PJR-XXXX)を指す。
221
+ // title は利用者入力で `:` などを含みうるため引用符で囲む。
222
+ function registerPlanFrontmatter(projectId, stem, item) {
223
+ const localId = `xep-${stem.toLowerCase()}`;
224
+ const docId = projectId ? `${projectId}:${localId}` : localId;
225
+ const inner = [
226
+ `id: ${docId}`,
227
+ `type: exec-plan`,
228
+ `rulebook: none`,
229
+ `task_id: ${item.id}`,
230
+ `name: "${escapeMarkdownInline(item.title).replace(/"/g, "'")}"`,
231
+ `mode: edit`,
232
+ `status: ready`,
233
+ `project_id: ${projectId}`,
234
+ // 登録簿項目は対象成果物を特定できないため targets を持たない。schedule 由来の
235
+ // タスクと区別できるよう出自を明示する(schema の targets 必須判定にも使う)。
236
+ `origin: register`,
237
+ ];
238
+ if (item.owner && item.owner !== "-" && item.owner !== "_TODO_") {
239
+ inner.push(`owner: ${item.owner}`);
240
+ }
241
+ return buildSpecdojoFrontmatter(inner);
242
+ }
243
+ export async function generateRegisterPlan(opts) {
244
+ const { item } = opts;
245
+ const category = requireRunnableRegisterItem(item);
246
+ const templatePath = execTemplatePath(REGISTER_PLAN_TEMPLATES[category]);
247
+ if (!existsSync(templatePath)) {
248
+ throw new Error(`Template not found: ${templatePath}`);
249
+ }
250
+ const template = readFileSync(templatePath, "utf8");
251
+ const plansDir = join(opts.executionPath, "exec", "plans");
252
+ mkdirSync(plansDir, { recursive: true });
253
+ const planPath = opts.outPath ?? join(plansDir, `${opts.stem}-plan.md`);
254
+ const resultRef = `${repoRelativePath(opts.executionPath)}/exec/results/${opts.stem}-result.md`;
255
+ const ticketPath = ticketPathFromItem(item, opts.registerPaths.projectRegisterPath);
256
+ const values = {
257
+ _FRONTMATTER_: registerPlanFrontmatter(opts.projectId, opts.stem, item),
258
+ _PJR_ID_: item.id,
259
+ // title / description は登録簿の自由記述列に由来し、山括弧プレースホルダや
260
+ // アンダースコア入り識別子、`_TODO_` などを含みうる。plan 本文(H1・説明文)へ
261
+ // そのまま埋め込むと HTML / 強調記号として誤解釈されるため、Markdown 用に保護する。
262
+ _PJR_TITLE_: escapeMarkdownInline(item.title),
263
+ _PJR_DESCRIPTION_: item.description && item.description !== "_TODO_"
264
+ ? escapeMarkdownInline(item.description)
265
+ : "-",
266
+ _PJR_TYPE_: item.type,
267
+ _PJR_PRIORITY_: item.priority,
268
+ _PJR_OWNER_: item.owner,
269
+ _PJR_DUE_: item.due,
270
+ _PJR_INDEX_PATH_: repoRelativePath(opts.registerPaths.pjrIndexPath),
271
+ _PJR_TICKET_REF_: ticketPath ? `\`${repoRelativePath(ticketPath)}\`` : "-",
272
+ _RESULT_REF_: resultRef,
273
+ _GRADE_FINDINGS_: ticketPath ? registerGradeFindingsText(opts.projectId, ticketPath) : "- なし",
274
+ };
275
+ const body = expandTemplate(template, values);
276
+ // register 項目は対象成果物の schema を特定できないため、schema 検査の項目は落とす。
277
+ const content = injectCommonConventions(body, MISSING, new Map());
278
+ writeFileSync(planPath, content, "utf8");
279
+ await formatMarkdownFile(planPath);
280
+ return { planPath, category };
281
+ }
@@ -0,0 +1,329 @@
1
+ import Ajv2020Module from "ajv/dist/2020.js";
2
+ import { extractJsonText } from "./agent-response.js";
3
+ const MAX_TEXT_LENGTH = 4_000;
4
+ const MAX_ITEMS = 1_000;
5
+ const REPORTER_FORMAT_ATTEMPTS = 3;
6
+ export const REPORTER_OUTPUT_SCHEMA = {
7
+ $schema: "https://json-schema.org/draft/2020-12/schema",
8
+ oneOf: [
9
+ {
10
+ type: "object",
11
+ additionalProperties: false,
12
+ required: [
13
+ "schema_version",
14
+ "mode",
15
+ "outcome",
16
+ "summary",
17
+ "changed_files",
18
+ "handoff",
19
+ "approach",
20
+ "block_reason",
21
+ ],
22
+ properties: {
23
+ schema_version: { const: 1 },
24
+ mode: { const: "edit" },
25
+ outcome: { enum: ["complete", "blocked"] },
26
+ summary: { type: "array", minItems: 1, maxItems: 100, items: { $ref: "#/$defs/text" } },
27
+ changed_files: {
28
+ type: "array",
29
+ maxItems: MAX_ITEMS,
30
+ items: {
31
+ type: "object",
32
+ additionalProperties: false,
33
+ required: ["path", "summary"],
34
+ properties: {
35
+ path: { type: "string", minLength: 1, maxLength: 1_000 },
36
+ summary: { $ref: "#/$defs/text" },
37
+ },
38
+ },
39
+ },
40
+ handoff: { type: "array", maxItems: 100, items: { $ref: "#/$defs/text" } },
41
+ approach: { $ref: "#/$defs/text" },
42
+ block_reason: { type: "string", maxLength: MAX_TEXT_LENGTH },
43
+ },
44
+ allOf: [
45
+ {
46
+ if: { properties: { outcome: { const: "blocked" } } },
47
+ then: { properties: { block_reason: { type: "string", pattern: "\\S" } } },
48
+ else: { properties: { block_reason: { type: "string", maxLength: 0 } } },
49
+ },
50
+ ],
51
+ },
52
+ {
53
+ type: "object",
54
+ additionalProperties: false,
55
+ required: [
56
+ "schema_version",
57
+ "mode",
58
+ "outcome",
59
+ "viewpoint_results",
60
+ "findings",
61
+ "approach",
62
+ "recommendation",
63
+ "block_reason",
64
+ ],
65
+ properties: {
66
+ schema_version: { const: 1 },
67
+ mode: { const: "review" },
68
+ outcome: { enum: ["complete", "blocked"] },
69
+ viewpoint_results: {
70
+ type: "array",
71
+ maxItems: 100,
72
+ items: {
73
+ type: "object",
74
+ additionalProperties: false,
75
+ required: ["id", "result", "evidence", "notes"],
76
+ properties: {
77
+ id: { type: "string", pattern: "^RVP-[0-9]{3}$" },
78
+ result: { enum: ["pass", "fail", "unclear"] },
79
+ evidence: {
80
+ type: "array",
81
+ minItems: 1,
82
+ maxItems: 100,
83
+ items: { $ref: "#/$defs/text" },
84
+ },
85
+ notes: { type: "string", maxLength: MAX_TEXT_LENGTH },
86
+ },
87
+ },
88
+ },
89
+ findings: { type: "array", maxItems: 100, items: { $ref: "#/$defs/text" } },
90
+ approach: { $ref: "#/$defs/text" },
91
+ recommendation: { enum: ["approve", "revise", "reject"] },
92
+ block_reason: { type: "string", maxLength: MAX_TEXT_LENGTH },
93
+ },
94
+ allOf: [
95
+ {
96
+ if: { properties: { outcome: { const: "blocked" } } },
97
+ then: { properties: { block_reason: { type: "string", pattern: "\\S" } } },
98
+ else: { properties: { block_reason: { type: "string", maxLength: 0 } } },
99
+ },
100
+ ],
101
+ },
102
+ ],
103
+ $defs: {
104
+ text: { type: "string", minLength: 1, maxLength: MAX_TEXT_LENGTH },
105
+ },
106
+ };
107
+ const Ajv2020 = Ajv2020Module.default;
108
+ const validateReporterSchema = new Ajv2020({ allErrors: true, strict: true }).compile(REPORTER_OUTPUT_SCHEMA);
109
+ function isRecord(value) {
110
+ return value !== null && typeof value === "object" && !Array.isArray(value);
111
+ }
112
+ function exactKeys(value, keys) {
113
+ const actual = Object.keys(value).sort();
114
+ const expected = [...keys].sort();
115
+ return actual.length === expected.length && actual.every((key, index) => key === expected[index]);
116
+ }
117
+ function isText(value, allowEmpty = false) {
118
+ return (typeof value === "string" &&
119
+ value.length <= MAX_TEXT_LENGTH &&
120
+ (allowEmpty || value.trim().length > 0));
121
+ }
122
+ function isTextArray(value, maxItems = 100, minItems = 0) {
123
+ return (Array.isArray(value) &&
124
+ value.length >= minItems &&
125
+ value.length <= maxItems &&
126
+ value.every((item) => isText(item)));
127
+ }
128
+ function validateCommon(value, mode) {
129
+ if (value.schema_version !== 1)
130
+ return "schema_version must equal 1";
131
+ if (value.mode !== mode)
132
+ return `mode must equal ${mode}`;
133
+ if (value.outcome !== "complete" && value.outcome !== "blocked") {
134
+ return "outcome must be complete or blocked";
135
+ }
136
+ if (!isText(value.block_reason, true))
137
+ return "block_reason must be a bounded string";
138
+ if (value.outcome === "blocked" && !String(value.block_reason).trim()) {
139
+ return "block_reason is required when outcome is blocked";
140
+ }
141
+ if (value.outcome === "complete" && String(value.block_reason).length > 0) {
142
+ return "block_reason must be empty when outcome is complete";
143
+ }
144
+ if (!isText(value.approach))
145
+ return "approach must be a non-empty bounded string";
146
+ return undefined;
147
+ }
148
+ function validateEdit(value) {
149
+ const keys = [
150
+ "schema_version",
151
+ "mode",
152
+ "outcome",
153
+ "summary",
154
+ "changed_files",
155
+ "handoff",
156
+ "approach",
157
+ "block_reason",
158
+ ];
159
+ if (!exactKeys(value, keys))
160
+ return "edit output has missing or additional properties";
161
+ const common = validateCommon(value, "edit");
162
+ if (common)
163
+ return common;
164
+ if (!isTextArray(value.summary, 100, 1))
165
+ return "summary must contain 1-100 bounded strings";
166
+ if (!isTextArray(value.handoff, 100))
167
+ return "handoff must contain at most 100 bounded strings";
168
+ if (!Array.isArray(value.changed_files) || value.changed_files.length > MAX_ITEMS) {
169
+ return "changed_files must be an array with at most 1000 items";
170
+ }
171
+ for (const file of value.changed_files) {
172
+ if (!isRecord(file) || !exactKeys(file, ["path", "summary"])) {
173
+ return "changed_files entries have missing or additional properties";
174
+ }
175
+ if (typeof file.path !== "string" || !file.path.trim() || file.path.length > 1_000) {
176
+ return "changed_files path must be a non-empty bounded string";
177
+ }
178
+ if (!isText(file.summary))
179
+ return "changed_files summary must be a non-empty bounded string";
180
+ }
181
+ return undefined;
182
+ }
183
+ function validateReview(value) {
184
+ const keys = [
185
+ "schema_version",
186
+ "mode",
187
+ "outcome",
188
+ "viewpoint_results",
189
+ "findings",
190
+ "approach",
191
+ "recommendation",
192
+ "block_reason",
193
+ ];
194
+ if (!exactKeys(value, keys))
195
+ return "review output has missing or additional properties";
196
+ const common = validateCommon(value, "review");
197
+ if (common)
198
+ return common;
199
+ if (!isTextArray(value.findings, 100))
200
+ return "findings must contain at most 100 bounded strings";
201
+ if (!Array.isArray(value.viewpoint_results) || value.viewpoint_results.length > 100) {
202
+ return "viewpoint_results must be an array with at most 100 items";
203
+ }
204
+ const ids = new Set();
205
+ for (const viewpoint of value.viewpoint_results) {
206
+ if (!isRecord(viewpoint) || !exactKeys(viewpoint, ["id", "result", "evidence", "notes"])) {
207
+ return "viewpoint_results entries have missing or additional properties";
208
+ }
209
+ if (typeof viewpoint.id !== "string" || !/^RVP-[0-9]{3}$/.test(viewpoint.id)) {
210
+ return "viewpoint id must match RVP-NNN";
211
+ }
212
+ if (ids.has(viewpoint.id))
213
+ return `duplicate viewpoint id: ${viewpoint.id}`;
214
+ ids.add(viewpoint.id);
215
+ if (viewpoint.result !== "pass" &&
216
+ viewpoint.result !== "fail" &&
217
+ viewpoint.result !== "unclear") {
218
+ return "viewpoint result must be pass, fail, or unclear";
219
+ }
220
+ if (!isTextArray(viewpoint.evidence, 100, 1)) {
221
+ return "viewpoint evidence must contain 1-100 bounded strings";
222
+ }
223
+ if (!isText(viewpoint.notes, true))
224
+ return "viewpoint notes must be a bounded string";
225
+ }
226
+ if (value.recommendation !== "approve" &&
227
+ value.recommendation !== "revise" &&
228
+ value.recommendation !== "reject") {
229
+ return "recommendation must be approve, revise, or reject";
230
+ }
231
+ return undefined;
232
+ }
233
+ export function parseReporterOutput(raw, mode) {
234
+ let value;
235
+ try {
236
+ value = JSON.parse(extractJsonText(raw));
237
+ }
238
+ catch (error) {
239
+ return {
240
+ error: `response is not a single JSON value: ${error instanceof Error ? error.message : String(error)}`,
241
+ };
242
+ }
243
+ if (!isRecord(value))
244
+ return { error: "response root must be an object" };
245
+ if (!validateReporterSchema(value)) {
246
+ const details = (validateReporterSchema.errors ?? [])
247
+ .slice(0, 5)
248
+ .map((error) => `${error.instancePath || "/"} ${error.keyword}: ${error.message ?? "invalid value"}`)
249
+ .join("; ");
250
+ return { error: `response does not match reporter JSON Schema: ${details}` };
251
+ }
252
+ const validationError = mode === "edit" ? validateEdit(value) : validateReview(value);
253
+ return validationError
254
+ ? { error: validationError }
255
+ : { output: value };
256
+ }
257
+ export function buildReporterPrompt(opts) {
258
+ const correction = opts.validationError
259
+ ? `\nThe previous response failed validation: ${opts.validationError}\nReturn a corrected JSON value.\n`
260
+ : "";
261
+ return `You are the reporter stage of a SpecDojo executor/reporter pipeline.
262
+ Use only the supplied plan and bounded executor evidence. Do not edit or inspect files. Do not
263
+ invent facts that are absent from evidence. Return exactly one JSON object matching the supplied
264
+ JSON Schema, without Markdown fences or commentary. Use outcome=blocked when the evidence cannot
265
+ support a complete result. The runner owns frontmatter and Markdown rendering: it writes your JSON
266
+ response, verbatim, into the plan's result file.
267
+
268
+ The runner renders your free-text JSON fields as Markdown. Wrap every identifier or field name
269
+ containing an underscore in inline code (for example, \`depends_on\`) so Markdown parsers do not
270
+ misread it as emphasis.
271
+
272
+ The plan below was written as generic instructions for a single agent that both edits the
273
+ deliverable and records its own result. In this pipeline, those two responsibilities are split:
274
+ the executor already completed the deliverable edit and intentionally left the result file
275
+ untouched (its evidence may say so explicitly) because writing the result is your job, not its.
276
+ Your JSON response IS the act of recording the result — returning a well-formed response with
277
+ outcome="complete" satisfies the plan's "record to result" and "result must not remain unfilled"
278
+ instructions; you do not need file access to fulfill them. Do not treat the executor's evidence
279
+ noting an untouched result file as a reason to block. Reserve outcome=blocked for cases where the
280
+ evidence itself shows the deliverable work is incomplete, incorrect, unverifiable, or otherwise
281
+ falls short of the plan's completion criteria for the edit itself. Validation entries with
282
+ source="runner" were executed by the SpecDojo parent process from a fixed allowlist and are
283
+ authoritative. If any runner validation is failed or not_run, return outcome="blocked" and cite
284
+ that validation; never replace or contradict its status.${correction}
285
+ <specdojo_plan>
286
+ ${opts.plan.trimEnd()}
287
+ </specdojo_plan>
288
+
289
+ <specdojo_executor_evidence>
290
+ ${JSON.stringify(opts.evidence, null, 2)}
291
+ </specdojo_executor_evidence>
292
+
293
+ <specdojo_reporter_output_schema mode="${opts.mode}">
294
+ ${JSON.stringify(REPORTER_OUTPUT_SCHEMA, null, 2)}
295
+ </specdojo_reporter_output_schema>
296
+ `;
297
+ }
298
+ export async function runReporterWithFormatRetry(opts) {
299
+ const maxAttempts = opts.maxFormatAttempts ?? REPORTER_FORMAT_ATTEMPTS;
300
+ let validationError;
301
+ const invocationOutputs = [];
302
+ for (let formatAttempts = 1; formatAttempts <= maxAttempts; formatAttempts++) {
303
+ const attempt = await opts.invoke(buildReporterPrompt({
304
+ plan: opts.plan,
305
+ evidence: opts.evidence,
306
+ mode: opts.mode,
307
+ ...(validationError ? { validationError } : {}),
308
+ }));
309
+ invocationOutputs.push({ stdout: attempt.stdout, stderr: attempt.stderr });
310
+ if (attempt.result !== "success") {
311
+ return {
312
+ result: attempt.result,
313
+ reason: attempt.stderr.trim() || `reporter exited with ${attempt.result}`,
314
+ formatAttempts,
315
+ invocationOutputs,
316
+ };
317
+ }
318
+ const parsed = parseReporterOutput(attempt.stdout, opts.mode);
319
+ if (parsed.output)
320
+ return { result: "success", output: parsed.output, formatAttempts };
321
+ validationError = parsed.error ?? "unknown schema validation error";
322
+ }
323
+ return {
324
+ result: "failure",
325
+ reason: `reporter output invalid after ${maxAttempts} format attempts: ${validationError ?? "unknown validation error"}`,
326
+ formatAttempts: maxAttempts,
327
+ invocationOutputs,
328
+ };
329
+ }