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,317 @@
1
+ import { readFileSync, renameSync, writeFileSync } from "node:fs";
2
+ import { dirname, join, relative, sep } from "node:path";
3
+ import { ensureDir, safeSlug } from "./exec-shared.js";
4
+ import { gitOutput } from "./exec-worktree.js";
5
+ const MAX_LOG_BYTES = 64 * 1024;
6
+ const MAX_CHANGE_FILES = 1_000;
7
+ const MAX_FINAL_MESSAGE_LENGTH = 4_000;
8
+ const MAX_DIFF_SUMMARY_LENGTH = 4_000;
9
+ const MAX_VALIDATIONS = 50;
10
+ const MAX_VALIDATION_COMMAND_LENGTH = 500;
11
+ const MAX_VALIDATION_SUMMARY_LENGTH = 1_000;
12
+ const REPORT_PATTERN = /<specdojo_executor_evidence>\s*([\s\S]*?)\s*<\/specdojo_executor_evidence>/giu;
13
+ function truncate(value, limit) {
14
+ if (value.length <= limit)
15
+ return value;
16
+ return `${value.slice(0, Math.max(0, limit - 1))}…`;
17
+ }
18
+ function boundedLog(value) {
19
+ const redacted = redactSensitiveText(value);
20
+ const buffer = Buffer.from(redacted, "utf8");
21
+ if (buffer.byteLength <= MAX_LOG_BYTES) {
22
+ return { content: redacted, truncated: false };
23
+ }
24
+ let end = MAX_LOG_BYTES;
25
+ while (end > 0 && (buffer[end] & 0xc0) === 0x80)
26
+ end--;
27
+ return {
28
+ content: buffer.subarray(0, end).toString("utf8"),
29
+ truncated: true,
30
+ };
31
+ }
32
+ /** Redacts common credential forms before agent output is persisted as evidence or a log excerpt. */
33
+ export function redactSensitiveText(value) {
34
+ return value
35
+ .replace(/\bBearer\s+[A-Za-z0-9._~+/=-]+/giu, "Bearer [REDACTED]")
36
+ .replace(/\b(sk-(?:proj-)?[A-Za-z0-9_-]{8,}|gh[opsu]_[A-Za-z0-9_]{8,})\b/gu, "[REDACTED]")
37
+ .replace(/\b(api[_-]?key|access[_-]?token|auth(?:orization)?|password|passwd|secret)\b(\s*[:=]\s*)([^\s,;]+)/giu, "$1$2[REDACTED]");
38
+ }
39
+ function boundedText(value, limit) {
40
+ return truncate(redactSensitiveText(typeof value === "string" ? value.trim() : ""), limit);
41
+ }
42
+ export function parseExecutorReport(stdout) {
43
+ const matches = [...stdout.matchAll(REPORT_PATTERN)];
44
+ const raw = matches.at(-1)?.[1];
45
+ let report = {};
46
+ if (raw) {
47
+ try {
48
+ const parsed = JSON.parse(raw);
49
+ if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
50
+ report = parsed;
51
+ }
52
+ }
53
+ catch {
54
+ // A malformed optional report must not discard the executor's process outcome.
55
+ }
56
+ }
57
+ const validations = [];
58
+ if (Array.isArray(report.validations)) {
59
+ for (const item of report.validations.slice(0, MAX_VALIDATIONS)) {
60
+ if (!item || typeof item !== "object" || Array.isArray(item))
61
+ continue;
62
+ const candidate = item;
63
+ const command = boundedText(candidate.command, MAX_VALIDATION_COMMAND_LENGTH);
64
+ const status = candidate.status;
65
+ if (!command || (status !== "passed" && status !== "failed" && status !== "not_run")) {
66
+ continue;
67
+ }
68
+ validations.push({
69
+ source: "executor",
70
+ command,
71
+ status,
72
+ summary: boundedText(candidate.summary, MAX_VALIDATION_SUMMARY_LENGTH),
73
+ });
74
+ }
75
+ }
76
+ const fallback = stdout.replace(REPORT_PATTERN, "").trim();
77
+ return {
78
+ finalMessage: boundedText(report.final_message ?? fallback, MAX_FINAL_MESSAGE_LENGTH),
79
+ validations,
80
+ };
81
+ }
82
+ function parseStatusPaths(worktreePath) {
83
+ const output = gitOutput(worktreePath, [
84
+ "status",
85
+ "--porcelain=v1",
86
+ "-z",
87
+ "--untracked-files=all",
88
+ ]);
89
+ const records = output.split("\0").filter(Boolean);
90
+ const changes = [];
91
+ for (let index = 0; index < records.length; index++) {
92
+ const record = records[index];
93
+ if (record.length < 4)
94
+ continue;
95
+ const status = record.slice(0, 2).trim() || "modified";
96
+ let path = record.slice(3);
97
+ if ((status.includes("R") || status.includes("C")) && records[index + 1]) {
98
+ path = `${records[++index]} -> ${path}`;
99
+ }
100
+ changes.push({ path: path.split(sep).join("/"), status });
101
+ }
102
+ return changes;
103
+ }
104
+ function repoRelative(repoRoot, path) {
105
+ return relative(repoRoot, path).split(sep).join("/");
106
+ }
107
+ export function buildExecutorEvidence(input) {
108
+ const report = parseExecutorReport(input.stdout);
109
+ const parentValidations = input.parentValidations ?? [];
110
+ const validations = [
111
+ ...report.validations.slice(0, Math.max(0, MAX_VALIDATIONS - parentValidations.length)),
112
+ ...parentValidations.slice(0, MAX_VALIDATIONS),
113
+ ].slice(0, MAX_VALIDATIONS);
114
+ const changes = input.changes.slice(0, MAX_CHANGE_FILES).map((change) => ({
115
+ path: boundedText(change.path, 1_000),
116
+ status: boundedText(change.status, 40),
117
+ }));
118
+ const output = `${input.stdout}\n${input.stderr}`.trim();
119
+ const boundedOutput = boundedLog(output);
120
+ const logExcerpt = boundedOutput.content;
121
+ return {
122
+ logExcerpt,
123
+ evidence: {
124
+ schema_version: 1,
125
+ task_id: input.taskId,
126
+ run_id: input.runId,
127
+ stage: {
128
+ role: "executor",
129
+ actor: input.actor,
130
+ status: input.status,
131
+ started_at: input.startedAt,
132
+ completed_at: input.completedAt,
133
+ exit_code: input.exitCode,
134
+ attempts: input.attempts,
135
+ },
136
+ changes,
137
+ diff_summary: {
138
+ files_changed: changes.length,
139
+ summary: truncate(redactSensitiveText(input.diffStat.trim()), MAX_DIFF_SUMMARY_LENGTH),
140
+ },
141
+ validations,
142
+ final_message: report.finalMessage,
143
+ log_refs: [
144
+ {
145
+ kind: "agent-output-excerpt",
146
+ path: input.logRefPath,
147
+ bytes: Buffer.byteLength(logExcerpt, "utf8"),
148
+ truncated: boundedOutput.truncated,
149
+ },
150
+ ],
151
+ },
152
+ };
153
+ }
154
+ export function recordExecutorEvidence(input) {
155
+ const executionRel = repoRelative(input.repoRoot, input.executionPath);
156
+ const runnerManagedPrefixes = [
157
+ `${executionRel}/exec/plans/`,
158
+ `${executionRel}/exec/results/`,
159
+ `${executionRel}/exec/events/`,
160
+ `${executionRel}/exec/evidence/`,
161
+ `${executionRel}/generated/`,
162
+ ];
163
+ const changesBeforeEvidence = parseStatusPaths(input.worktreePath).filter((change) => runnerManagedPrefixes.every((prefix) => !change.path.startsWith(prefix)));
164
+ const diffStat = gitOutput(input.worktreePath, ["diff", "--stat", "HEAD", "--"]);
165
+ const executionInWorktree = join(input.worktreePath, executionRel);
166
+ const evidenceDir = join(executionInWorktree, "exec", "evidence", safeSlug(input.taskId), safeSlug(input.runId));
167
+ ensureDir(evidenceDir);
168
+ const logPath = join(evidenceDir, "executor.log");
169
+ const evidencePath = join(evidenceDir, "evidence.json");
170
+ const { evidence, logExcerpt } = buildExecutorEvidence({
171
+ taskId: input.taskId,
172
+ runId: input.runId,
173
+ actor: input.actor,
174
+ status: input.status,
175
+ startedAt: input.startedAt,
176
+ completedAt: input.completedAt,
177
+ exitCode: input.exitCode,
178
+ attempts: input.attempts,
179
+ stdout: input.stdout,
180
+ stderr: input.stderr,
181
+ changes: changesBeforeEvidence,
182
+ diffStat,
183
+ logRefPath: repoRelative(input.worktreePath, logPath),
184
+ parentValidations: input.parentValidations,
185
+ });
186
+ writeFileSync(logPath, logExcerpt, "utf8");
187
+ writeFileSync(evidencePath, `${JSON.stringify(evidence, null, 2)}\n`, "utf8");
188
+ return { evidence, evidencePath };
189
+ }
190
+ /** Records a runner-executed Job command with distinct, bounded stdout and stderr logs. */
191
+ export function recordCommandEvidence(input) {
192
+ const executionRel = repoRelative(input.repoRoot, input.executionPath);
193
+ const runnerManagedPrefixes = [
194
+ `${executionRel}/exec/plans/`,
195
+ `${executionRel}/exec/results/`,
196
+ `${executionRel}/exec/events/`,
197
+ `${executionRel}/exec/evidence/`,
198
+ `${executionRel}/generated/`,
199
+ ];
200
+ const changes = parseStatusPaths(input.worktreePath)
201
+ .filter((change) => runnerManagedPrefixes.every((prefix) => !change.path.startsWith(prefix)))
202
+ .slice(0, MAX_CHANGE_FILES)
203
+ .map((change) => ({
204
+ path: boundedText(change.path, 1_000),
205
+ status: boundedText(change.status, 40),
206
+ }));
207
+ const diffStat = gitOutput(input.worktreePath, ["diff", "--stat", "HEAD", "--"]);
208
+ const evidenceDir = join(input.worktreePath, executionRel, "exec", "evidence", safeSlug(input.taskId), safeSlug(input.runId));
209
+ ensureDir(evidenceDir);
210
+ const stdoutPath = join(evidenceDir, "command.stdout.log");
211
+ const stderrPath = join(evidenceDir, "command.stderr.log");
212
+ const evidencePath = join(evidenceDir, "evidence.json");
213
+ const boundedStdout = boundedLog(input.stdout);
214
+ const boundedStderr = boundedLog(input.stderr);
215
+ writeFileSync(stdoutPath, boundedStdout.content, "utf8");
216
+ writeFileSync(stderrPath, boundedStderr.content, "utf8");
217
+ const stdoutRef = repoRelative(input.worktreePath, stdoutPath);
218
+ const stderrRef = repoRelative(input.worktreePath, stderrPath);
219
+ const succeeded = input.exitCode === 0 && !input.error;
220
+ const safeCommand = boundedText(input.command, 16_000);
221
+ const summary = input.error
222
+ ? `spawn failed: ${boundedText(input.error, MAX_VALIDATION_SUMMARY_LENGTH)}`
223
+ : `exit ${input.exitCode ?? "unknown"}`;
224
+ const evidence = {
225
+ schema_version: 1,
226
+ task_id: input.taskId,
227
+ run_id: input.runId,
228
+ stage: {
229
+ role: "executor",
230
+ actor: input.actor,
231
+ status: succeeded ? "succeeded" : "failed",
232
+ started_at: input.startedAt,
233
+ completed_at: input.completedAt,
234
+ exit_code: input.exitCode,
235
+ attempts: 1,
236
+ },
237
+ changes,
238
+ diff_summary: {
239
+ files_changed: changes.length,
240
+ summary: truncate(redactSensitiveText(diffStat.trim()), MAX_DIFF_SUMMARY_LENGTH),
241
+ },
242
+ validations: [
243
+ {
244
+ id: "job-command",
245
+ source: "runner",
246
+ command: boundedText(input.command, MAX_VALIDATION_COMMAND_LENGTH),
247
+ status: succeeded ? "passed" : "failed",
248
+ summary,
249
+ },
250
+ ],
251
+ final_message: `Runner command ${summary}.`,
252
+ command: {
253
+ shell: input.shell,
254
+ value: safeCommand,
255
+ exit_code: input.exitCode,
256
+ stdout_ref: stdoutRef,
257
+ stderr_ref: stderrRef,
258
+ stdout: boundedStdout.content,
259
+ stderr: boundedStderr.content,
260
+ },
261
+ log_refs: [
262
+ {
263
+ kind: "command-stdout",
264
+ path: stdoutRef,
265
+ bytes: Buffer.byteLength(boundedStdout.content, "utf8"),
266
+ truncated: !!input.stdoutTruncated || boundedStdout.truncated,
267
+ },
268
+ {
269
+ kind: "command-stderr",
270
+ path: stderrRef,
271
+ bytes: Buffer.byteLength(boundedStderr.content, "utf8"),
272
+ truncated: !!input.stderrTruncated || boundedStderr.truncated,
273
+ },
274
+ ],
275
+ };
276
+ writeFileSync(evidencePath, `${JSON.stringify(evidence, null, 2)}\n`, "utf8");
277
+ return { evidence, evidencePath };
278
+ }
279
+ export function readExecutorEvidence(path) {
280
+ return JSON.parse(readFileSync(path, "utf8"));
281
+ }
282
+ /** Persists runner-refreshed evidence without exposing a partially written JSON checkpoint. */
283
+ export function writeExecutorEvidence(path, evidence) {
284
+ const temporaryPath = `${path}.tmp`;
285
+ writeFileSync(temporaryPath, `${JSON.stringify(evidence, null, 2)}\n`, "utf8");
286
+ renameSync(temporaryPath, path);
287
+ }
288
+ /**
289
+ * Persists the latest failed reporter invocation streams beside executor evidence.
290
+ * Each stream is independently redacted and bounded so stdout/stderr remain distinguishable.
291
+ */
292
+ export function recordReporterFailureOutput(input) {
293
+ const evidenceDir = dirname(input.evidencePath);
294
+ ensureDir(evidenceDir);
295
+ const retainedRefs = input.evidence.log_refs.filter((ref) => !/^reporter-attempt-\d+\.(?:stdout|stderr)\.log$/u.test(ref.path.split("/").at(-1) ?? ""));
296
+ const reporterRefs = [];
297
+ input.invocationOutputs.forEach((output, index) => {
298
+ const attempt = index + 1;
299
+ for (const stream of ["stdout", "stderr"]) {
300
+ const logPath = join(evidenceDir, `reporter-attempt-${attempt}.${stream}.log`);
301
+ const boundedOutput = boundedLog(output[stream]);
302
+ writeFileSync(logPath, boundedOutput.content, "utf8");
303
+ reporterRefs.push({
304
+ kind: "agent-output-excerpt",
305
+ path: repoRelative(input.worktreePath, logPath),
306
+ bytes: Buffer.byteLength(boundedOutput.content, "utf8"),
307
+ truncated: boundedOutput.truncated,
308
+ });
309
+ }
310
+ });
311
+ const evidence = {
312
+ ...input.evidence,
313
+ log_refs: [...retainedRefs, ...reporterRefs],
314
+ };
315
+ writeExecutorEvidence(input.evidencePath, evidence);
316
+ return evidence;
317
+ }
@@ -0,0 +1,54 @@
1
+ import { existsSync } from "node:fs";
2
+ import { readFile, writeFile } from "node:fs/promises";
3
+ import path from "node:path";
4
+ import { format, getFileInfo, resolveConfig } from "prettier";
5
+ // 対象ファイルから上位へ辿り、最も近い .prettierignore を返す。Prettier CLI は cwd の
6
+ // .prettierignore を使うが、API の format は ignore を参照しないため、runner 側で探索する。
7
+ export function findPrettierIgnorePath(filePath) {
8
+ let directory = path.dirname(path.resolve(filePath));
9
+ for (;;) {
10
+ const candidate = path.join(directory, ".prettierignore");
11
+ if (existsSync(candidate))
12
+ return candidate;
13
+ const parent = path.dirname(directory);
14
+ if (parent === directory)
15
+ return undefined;
16
+ directory = parent;
17
+ }
18
+ }
19
+ // .prettierignore で除外されたファイル(exec の plan / result 履歴など)は、commit hook と
20
+ // 同様に runner の描画時にも整形しない。整形すると `_` を含む識別子と `_TODO_` の同居を
21
+ // 強調と解釈して本文を書き換える(PJR-19HX)。
22
+ export async function isPrettierIgnored(filePath) {
23
+ const ignorePath = findPrettierIgnorePath(filePath);
24
+ if (!ignorePath)
25
+ return false;
26
+ const info = await getFileInfo(path.resolve(filePath), { ignorePath });
27
+ return info.ignored;
28
+ }
29
+ function normalizeTrailingNewline(source) {
30
+ return `${source.replace(/[\r\n]+$/u, "")}\n`;
31
+ }
32
+ export async function formatMarkdownFile(filePath) {
33
+ try {
34
+ const source = await readFile(filePath, "utf8");
35
+ const normalized = normalizeTrailingNewline(source);
36
+ // exec の plan / result は本文保護のため Prettier 対象外だが、runner が生成する
37
+ // Markdown として末尾改行だけは同じ書き出し経路で必ず正規化する。
38
+ if (await isPrettierIgnored(filePath)) {
39
+ if (normalized !== source)
40
+ await writeFile(filePath, normalized, "utf8");
41
+ return;
42
+ }
43
+ const config = await resolveConfig(filePath);
44
+ const formatted = await format(normalized, {
45
+ ...(config ?? {}),
46
+ filepath: filePath,
47
+ });
48
+ await writeFile(filePath, normalizeTrailingNewline(formatted), "utf8");
49
+ }
50
+ catch (error) {
51
+ const cause = error instanceof Error ? `: ${error.message}` : "";
52
+ throw new Error(`Failed to format Markdown with Prettier: ${filePath}${cause}`);
53
+ }
54
+ }
@@ -0,0 +1,202 @@
1
+ const RAW_MESSAGE_MAX_LENGTH = 500;
2
+ function limitKind(output) {
3
+ const lower = output.toLowerCase();
4
+ if (/\b(weekly|monthly|usage)\s+limit\b/.test(lower) ||
5
+ lower.includes("quota exhausted") ||
6
+ lower.includes("quota exceeded") ||
7
+ lower.includes("premium request")) {
8
+ return "quota_exhausted";
9
+ }
10
+ if (lower.includes("session limit") || lower.includes("5-hour limit"))
11
+ return "session_limit";
12
+ if (lower.includes("overloaded") || lower.includes("over capacity"))
13
+ return "overloaded";
14
+ if (lower.includes("timeout") || lower.includes("timed out"))
15
+ return "timeout";
16
+ if (lower.includes("out of memory") || /\boom\b/.test(lower))
17
+ return "oom";
18
+ return "rate_limit";
19
+ }
20
+ function diagnosticLine(output, kind) {
21
+ const patterns = {
22
+ rate_limit: /rate limit|too many requests|\b429\b|retry.after/i,
23
+ session_limit: /session limit|5-hour limit/i,
24
+ quota_exhausted: /weekly limit|monthly limit|usage limit|quota|premium request/i,
25
+ overloaded: /overloaded|over capacity/i,
26
+ timeout: /timeout|timed out/i,
27
+ oom: /out of memory|\boom\b/i,
28
+ };
29
+ const lines = output
30
+ .split(/\r?\n/)
31
+ .map((line) => line.trim())
32
+ .filter(Boolean);
33
+ const matched = lines.find((line) => patterns[kind].test(line)) ?? lines.at(-1) ?? "limit reached";
34
+ return matched.length > RAW_MESSAGE_MAX_LENGTH
35
+ ? `${matched.slice(0, RAW_MESSAGE_MAX_LENGTH)}…`
36
+ : matched;
37
+ }
38
+ function timezoneOffsetMinutes(token) {
39
+ if (!token)
40
+ return undefined;
41
+ const normalized = token.trim().toUpperCase();
42
+ if (normalized === "UTC" || normalized === "GMT" || normalized === "Z")
43
+ return 0;
44
+ if (normalized === "JST")
45
+ return 9 * 60;
46
+ const match = normalized.match(/^(?:UTC|GMT)?([+-])(\d{1,2})(?::?(\d{2}))?$/);
47
+ if (!match)
48
+ return undefined;
49
+ const hours = Number.parseInt(match[2], 10);
50
+ const minutes = Number.parseInt(match[3] ?? "0", 10);
51
+ if (hours > 23 || minutes > 59)
52
+ return undefined;
53
+ const sign = match[1] === "+" ? 1 : -1;
54
+ return sign * (hours * 60 + minutes);
55
+ }
56
+ function nextTimeOfDayUtc(observedAt, hour, minute, offsetMinutes) {
57
+ const localNow = new Date(observedAt.getTime() + offsetMinutes * 60_000);
58
+ let candidateMs = Date.UTC(localNow.getUTCFullYear(), localNow.getUTCMonth(), localNow.getUTCDate(), hour, minute) -
59
+ offsetMinutes * 60_000;
60
+ if (candidateMs <= observedAt.getTime())
61
+ candidateMs += 24 * 60 * 60_000;
62
+ return new Date(candidateMs);
63
+ }
64
+ function parseRetryAfter(output, observedAt) {
65
+ const seconds = output.match(/retry-after\s*[:=]\s*(\d+(?:\.\d+)?)\s*(?:seconds?|secs?|s)?\b/i);
66
+ if (seconds) {
67
+ return new Date(observedAt.getTime() + Number.parseFloat(seconds[1]) * 1000);
68
+ }
69
+ const duration = output.match(/(?:retry|try)\s+again\s+(?:after|in)\s+(\d+(?:\.\d+)?)\s*(seconds?|secs?|s|minutes?|mins?|m|hours?|hrs?|h)\b/i);
70
+ if (duration) {
71
+ const value = Number.parseFloat(duration[1]);
72
+ const unit = duration[2].toLowerCase();
73
+ const multiplier = unit.startsWith("h") ? 3_600_000 : unit.startsWith("m") ? 60_000 : 1000;
74
+ return new Date(observedAt.getTime() + value * multiplier);
75
+ }
76
+ const httpDate = output.match(/retry-after\s*[:=]\s*([^\r\n]+)/i)?.[1]?.trim();
77
+ if (httpDate) {
78
+ const parsed = new Date(httpDate);
79
+ if (!Number.isNaN(parsed.getTime()) && parsed > observedAt)
80
+ return parsed;
81
+ }
82
+ return undefined;
83
+ }
84
+ function parseProviderReset(output, observedAt) {
85
+ const explicit = output.match(/(?:resets?|reset(?:s)?\s+at)\s+((?:20\d{2}-\d{2}-\d{2})[t\s]\d{1,2}:\d{2}(?::\d{2})?(?:\.\d+)?(?:z|[+-]\d{2}:?\d{2}|\s+(?:utc|gmt|jst)))\b/i);
86
+ if (explicit) {
87
+ const text = explicit[1].replace(/\s+(UTC|GMT)$/i, "Z").replace(/\s+JST$/i, "+09:00");
88
+ const parsed = new Date(text);
89
+ if (!Number.isNaN(parsed.getTime()) && parsed > observedAt)
90
+ return parsed;
91
+ }
92
+ const timeOnly = output.match(/resets?(?:\s+at)?\s+(\d{1,2}):(\d{2})\s*(am|pm)?(?:\s*\(([^)]+)\)|\s+(UTC|GMT|JST|(?:UTC|GMT)?[+-]\d{1,2}(?::?\d{2})?))?/i);
93
+ if (!timeOnly)
94
+ return undefined;
95
+ const offset = timezoneOffsetMinutes(timeOnly[4] ?? timeOnly[5]);
96
+ if (offset === undefined)
97
+ return undefined;
98
+ let hour = Number.parseInt(timeOnly[1], 10);
99
+ const minute = Number.parseInt(timeOnly[2], 10);
100
+ const meridiem = timeOnly[3]?.toLowerCase();
101
+ if (minute > 59 || hour > (meridiem ? 12 : 23) || hour < (meridiem ? 1 : 0))
102
+ return undefined;
103
+ if (meridiem) {
104
+ if (hour === 12)
105
+ hour = 0;
106
+ if (meridiem === "pm")
107
+ hour += 12;
108
+ }
109
+ return nextTimeOfDayUtc(observedAt, hour, minute, offset);
110
+ }
111
+ export function normalizeAgentLimit(input) {
112
+ const observedAt = input.observedAt ?? new Date();
113
+ const kind = limitKind(input.output);
114
+ const retryableKind = kind !== "quota_exhausted";
115
+ const retryAfter = retryableKind ? parseRetryAfter(input.output, observedAt) : undefined;
116
+ const providerReset = retryableKind ? parseProviderReset(input.output, observedAt) : undefined;
117
+ const configuredCooldown = input.cooldownSeconds?.[kind];
118
+ const cooldown = retryableKind &&
119
+ configuredCooldown !== undefined &&
120
+ Number.isFinite(configuredCooldown) &&
121
+ configuredCooldown > 0
122
+ ? new Date(observedAt.getTime() + configuredCooldown * 1000)
123
+ : undefined;
124
+ const resumeAt = retryAfter ?? providerReset ?? cooldown;
125
+ const resumeSource = retryAfter
126
+ ? "retry_after"
127
+ : providerReset
128
+ ? "provider_reset"
129
+ : cooldown
130
+ ? "cooldown_policy"
131
+ : undefined;
132
+ return {
133
+ availability_state: kind === "overloaded" || kind === "timeout" || kind === "oom"
134
+ ? "transient_failure"
135
+ : "limited",
136
+ retryable: retryableKind,
137
+ auto_resume: retryableKind && resumeAt !== undefined,
138
+ ...(input.provider ? { provider: input.provider } : {}),
139
+ kind,
140
+ raw_message: diagnosticLine(input.output, kind),
141
+ observed_at: observedAt.toISOString(),
142
+ ...(resumeAt ? { resume_at: resumeAt.toISOString() } : {}),
143
+ ...(resumeSource ? { resume_source: resumeSource } : {}),
144
+ };
145
+ }
146
+ function metaString(meta, key) {
147
+ const value = meta?.[key];
148
+ return typeof value === "string" ? value : undefined;
149
+ }
150
+ function deferredTask(taskId, state, now) {
151
+ const autoResume = metaString(state.meta, "limit_auto_resume");
152
+ const retryable = metaString(state.meta, "limit_retryable");
153
+ const resumeAtText = metaString(state.meta, "limit_resume_at");
154
+ const kind = metaString(state.meta, "limit_kind");
155
+ if (state.state !== "blocked" ||
156
+ autoResume !== "true" ||
157
+ retryable !== "true" ||
158
+ !resumeAtText ||
159
+ !kind) {
160
+ return undefined;
161
+ }
162
+ const resumeAt = new Date(resumeAtText);
163
+ if (Number.isNaN(resumeAt.getTime()) || resumeAt > now)
164
+ return undefined;
165
+ const attemptsText = metaString(state.meta, "limit_attempts");
166
+ const attempts = attemptsText && /^\d+$/.test(attemptsText) ? Number.parseInt(attemptsText, 10) : 0;
167
+ return {
168
+ taskId,
169
+ actor: state.last_by ?? "",
170
+ kind,
171
+ resumeAt: resumeAt.toISOString(),
172
+ attempts,
173
+ ...(metaString(state.meta, "limit_provider")
174
+ ? { provider: metaString(state.meta, "limit_provider") }
175
+ : {}),
176
+ ...(metaString(state.meta, "limit_worktree")
177
+ ? { worktree: metaString(state.meta, "limit_worktree") }
178
+ : {}),
179
+ };
180
+ }
181
+ export function selectDueDeferredLimitTasks(snapshot, now = new Date()) {
182
+ return Object.entries(snapshot.tasks)
183
+ .map(([taskId, state]) => deferredTask(taskId, state, now))
184
+ .filter((task) => task !== undefined)
185
+ .sort((a, b) => a.resumeAt.localeCompare(b.resumeAt) || a.taskId.localeCompare(b.taskId));
186
+ }
187
+ export function limitEventMeta(signal, input) {
188
+ return {
189
+ limit_deferred: signal.auto_resume ? "true" : "false",
190
+ limit_availability_state: signal.availability_state,
191
+ limit_retryable: String(signal.retryable),
192
+ limit_auto_resume: String(signal.auto_resume),
193
+ limit_kind: signal.kind,
194
+ limit_provider: signal.provider ?? "unknown",
195
+ limit_observed_at: signal.observed_at,
196
+ limit_raw_message: signal.raw_message,
197
+ limit_attempts: String(input.attempts),
198
+ limit_worktree: input.worktree,
199
+ ...(signal.resume_at ? { limit_resume_at: signal.resume_at } : {}),
200
+ ...(signal.resume_source ? { limit_resume_source: signal.resume_source } : {}),
201
+ };
202
+ }