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
package/dist/job.js ADDED
@@ -0,0 +1,1081 @@
1
+ import { createHash } from "node:crypto";
2
+ import { spawn, spawnSync } from "node:child_process";
3
+ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
4
+ import { basename, join, relative, resolve } from "node:path";
5
+ import yaml from "js-yaml";
6
+ import { buildSpecdojoFrontmatter } from "./frontmatter-namespace.js";
7
+ import { formatMarkdownFile } from "./exec-format.js";
8
+ import { execTemplatePath, injectCommonConventions, MISSING } from "./exec-plans.js";
9
+ import { expandTemplate, listFilesRecursive, readJson, writeJson } from "./exec-shared.js";
10
+ import { gitEnvironment } from "./exec-worktree.js";
11
+ import { getProjectJobsPath, getProjectExecutionPath, loadConfig, loadEnv, specdojoRootDir, } from "./specdojo-config.js";
12
+ import { selfRunCommand } from "./spawn-self.js";
13
+ function isRecord(value) {
14
+ return typeof value === "object" && value !== null && !Array.isArray(value);
15
+ }
16
+ export function isJobCommandTask(task) {
17
+ return task.mode === "command";
18
+ }
19
+ export function isJobAgentTask(task) {
20
+ return task.mode === "edit" || task.mode === "review";
21
+ }
22
+ function validStringList(value) {
23
+ return (Array.isArray(value) &&
24
+ value.length > 0 &&
25
+ value.every((item) => typeof item === "string" && item.trim()));
26
+ }
27
+ // Same nickname shape as pm-members.schema.yaml. The roster is not loaded here, so a
28
+ // definition only guarantees the format; an unknown nickname fails when the Run resolves
29
+ // the agent command.
30
+ function isAgentNickname(value) {
31
+ return typeof value === "string" && /^[a-z0-9][a-z0-9_-]{0,62}$/.test(value.trim());
32
+ }
33
+ function isJobAgentDefinition(value) {
34
+ return (isRecord(value) &&
35
+ isAgentNickname(value.executor) &&
36
+ (value.reporter === undefined || isAgentNickname(value.reporter)));
37
+ }
38
+ // Parses task.agent and reports why it was rejected. Unknown keys are refused so a typo
39
+ // (for example `reporters`) cannot silently drop the reporter stage.
40
+ function parseJobAgent(value) {
41
+ if (!isRecord(value)) {
42
+ return { error: "task.agent must be a mapping with executor and optional reporter" };
43
+ }
44
+ const unknownKeys = Object.keys(value).filter((key) => key !== "executor" && key !== "reporter");
45
+ if (unknownKeys.length > 0) {
46
+ return { error: `task.agent has unknown key(s): ${unknownKeys.sort().join(", ")}` };
47
+ }
48
+ if (!isAgentNickname(value.executor)) {
49
+ return { error: "task.agent.executor must be an agent nickname from pm-members.yaml" };
50
+ }
51
+ if (value.reporter !== undefined && !isAgentNickname(value.reporter)) {
52
+ return { error: "task.agent.reporter must be an agent nickname from pm-members.yaml" };
53
+ }
54
+ return {
55
+ agent: {
56
+ executor: value.executor.trim(),
57
+ ...(isAgentNickname(value.reporter) ? { reporter: value.reporter.trim() } : {}),
58
+ },
59
+ };
60
+ }
61
+ function isJobRunState(value) {
62
+ return value === "running" || value === "succeeded" || value === "failed" || value === "noop";
63
+ }
64
+ function isJobTaskDefinition(value) {
65
+ if (!isRecord(value))
66
+ return false;
67
+ if (value.owner !== undefined && typeof value.owner !== "string")
68
+ return false;
69
+ if (!["targets", "paths"].every((field) => value[field] === undefined || validStringList(value[field])))
70
+ return false;
71
+ if (value.mode === "command") {
72
+ return (typeof value.command === "string" &&
73
+ (value.precondition === undefined ||
74
+ (isRecord(value.precondition) &&
75
+ typeof value.precondition.command === "string" &&
76
+ (value.precondition.skip_when === "empty-output" ||
77
+ (Number.isSafeInteger(value.precondition.skip_when) &&
78
+ Number(value.precondition.skip_when) >= 0 &&
79
+ Number(value.precondition.skip_when) <= 255)))) &&
80
+ (value.analysis === undefined ||
81
+ (isRecord(value.analysis) &&
82
+ isAgentNickname(value.analysis.agent) &&
83
+ typeof value.analysis.description === "string")));
84
+ }
85
+ if (value.mode !== "edit" && value.mode !== "review")
86
+ return false;
87
+ if (typeof value.description !== "string")
88
+ return false;
89
+ if (value.agent !== undefined && !isJobAgentDefinition(value.agent))
90
+ return false;
91
+ return ["capabilities"].every((field) => value[field] === undefined || validStringList(value[field]));
92
+ }
93
+ function isJobRunAttempt(value) {
94
+ return (isRecord(value) &&
95
+ typeof value.attempt === "number" &&
96
+ typeof value.started_at === "string" &&
97
+ isJobRunState(value.status) &&
98
+ (value.evidence_ref === undefined || typeof value.evidence_ref === "string") &&
99
+ (value.exit_code === undefined ||
100
+ value.exit_code === null ||
101
+ typeof value.exit_code === "number"));
102
+ }
103
+ function isJobRunRecord(value) {
104
+ if (!isRecord(value))
105
+ return false;
106
+ const stringFields = [
107
+ "run_id",
108
+ "job_id",
109
+ "idempotency_key",
110
+ "project_id",
111
+ "scheduled_at",
112
+ "created_at",
113
+ "updated_at",
114
+ "plan_ref",
115
+ "result_ref",
116
+ ];
117
+ return (value.version === 1 &&
118
+ stringFields.every((field) => typeof value[field] === "string") &&
119
+ (value.trigger === "manual" || value.trigger === "routine" || value.trigger === "ci") &&
120
+ isJobRunState(value.state) &&
121
+ isRecord(value.inputs) &&
122
+ isJobTaskDefinition(value.task) &&
123
+ isRecord(value.checkpoint_before) &&
124
+ (value.checkpoint_after === undefined || isRecord(value.checkpoint_after)) &&
125
+ Array.isArray(value.attempts) &&
126
+ value.attempts.every(isJobRunAttempt));
127
+ }
128
+ function readJobRunRecord(filePath) {
129
+ const raw = readJson(filePath);
130
+ if (!isJobRunRecord(raw))
131
+ throw new Error(`Invalid Job Run file: ${filePath}`);
132
+ return raw;
133
+ }
134
+ function validateJobInputValue(value, input, key) {
135
+ const values = input.type === "list" ? value : [value];
136
+ if (input.enum) {
137
+ for (const item of values) {
138
+ if (!input.enum.includes(item)) {
139
+ throw new Error(`Input ${key} must be one of: ${input.enum.join(", ")}`);
140
+ }
141
+ }
142
+ }
143
+ if (input.type === "integer") {
144
+ const integer = value;
145
+ if (input.minimum !== undefined && integer < input.minimum) {
146
+ throw new Error(`Input ${key} must be at least ${input.minimum}`);
147
+ }
148
+ if (input.maximum !== undefined && integer > input.maximum) {
149
+ throw new Error(`Input ${key} must be at most ${input.maximum}`);
150
+ }
151
+ }
152
+ }
153
+ export function parseJobDefinition(value, fileName) {
154
+ const errors = [];
155
+ if (!isRecord(value))
156
+ return { errors: [`${fileName}: job file must be a YAML mapping`] };
157
+ const expectedId = fileName.replace(/\.(yaml|yml)$/, "");
158
+ const id = typeof value.id === "string" ? value.id.trim() : "";
159
+ if (!/^job-[a-z0-9][a-z0-9-]*$/.test(id))
160
+ errors.push("id must match job-<slug>");
161
+ if (id && id !== expectedId)
162
+ errors.push(`id "${id}" must match the file name base "${expectedId}"`);
163
+ const name = typeof value.name === "string" ? value.name.trim() : "";
164
+ if (!name)
165
+ errors.push("name is required");
166
+ const inputDefinitions = {};
167
+ if (value.inputs !== undefined) {
168
+ if (!isRecord(value.inputs))
169
+ errors.push("inputs must be a mapping");
170
+ else {
171
+ for (const [key, raw] of Object.entries(value.inputs)) {
172
+ if (!/^[a-z][a-z0-9_]*$/.test(key)) {
173
+ errors.push(`inputs.${key} must use lowercase snake_case`);
174
+ continue;
175
+ }
176
+ if (!isRecord(raw)) {
177
+ errors.push(`inputs.${key} must be a mapping`);
178
+ continue;
179
+ }
180
+ const unknownInputKeys = Object.keys(raw).filter((field) => ![
181
+ "type",
182
+ "required",
183
+ "default",
184
+ "enum",
185
+ "minimum",
186
+ "maximum",
187
+ "from_checkpoint",
188
+ "resolve",
189
+ "git_revision",
190
+ ].includes(field));
191
+ if (unknownInputKeys.length > 0) {
192
+ errors.push(`inputs.${key} has unknown key(s): ${unknownInputKeys.sort().join(", ")}`);
193
+ }
194
+ const type = raw.type;
195
+ if (type !== "string" && type !== "integer" && type !== "boolean" && type !== "list") {
196
+ errors.push(`inputs.${key}.type must be string|integer|boolean|list`);
197
+ continue;
198
+ }
199
+ if (raw.required !== undefined && typeof raw.required !== "boolean") {
200
+ errors.push(`inputs.${key}.required must be a boolean`);
201
+ }
202
+ if (raw.from_checkpoint !== undefined && typeof raw.from_checkpoint !== "string") {
203
+ errors.push(`inputs.${key}.from_checkpoint must be a string`);
204
+ }
205
+ if (raw.resolve !== undefined && raw.resolve !== "git_head") {
206
+ errors.push(`inputs.${key}.resolve must be git_head`);
207
+ }
208
+ if (raw.git_revision !== undefined && typeof raw.git_revision !== "boolean") {
209
+ errors.push(`inputs.${key}.git_revision must be a boolean`);
210
+ }
211
+ const enumValues = raw.enum;
212
+ if (enumValues !== undefined &&
213
+ (!Array.isArray(enumValues) ||
214
+ enumValues.length === 0 ||
215
+ new Set(enumValues).size !== enumValues.length ||
216
+ enumValues.some((item) => type === "integer"
217
+ ? !Number.isSafeInteger(item)
218
+ : type === "boolean"
219
+ ? typeof item !== "boolean"
220
+ : typeof item !== "string"))) {
221
+ errors.push(`inputs.${key}.enum must be a non-empty unique list of ${type === "list" ? "string" : type} values`);
222
+ }
223
+ if (raw.minimum !== undefined &&
224
+ (type !== "integer" || !Number.isSafeInteger(raw.minimum))) {
225
+ errors.push(`inputs.${key}.minimum is only allowed as an integer constraint`);
226
+ }
227
+ if (raw.maximum !== undefined &&
228
+ (type !== "integer" || !Number.isSafeInteger(raw.maximum))) {
229
+ errors.push(`inputs.${key}.maximum is only allowed as an integer constraint`);
230
+ }
231
+ if (Number.isSafeInteger(raw.minimum) &&
232
+ Number.isSafeInteger(raw.maximum) &&
233
+ Number(raw.minimum) > Number(raw.maximum)) {
234
+ errors.push(`inputs.${key}.minimum must not exceed maximum`);
235
+ }
236
+ const definition = {
237
+ type,
238
+ ...(typeof raw.required === "boolean" ? { required: raw.required } : {}),
239
+ ...(raw.default !== undefined ? { default: raw.default } : {}),
240
+ ...(Array.isArray(enumValues)
241
+ ? { enum: enumValues }
242
+ : {}),
243
+ ...(Number.isSafeInteger(raw.minimum) ? { minimum: Number(raw.minimum) } : {}),
244
+ ...(Number.isSafeInteger(raw.maximum) ? { maximum: Number(raw.maximum) } : {}),
245
+ ...(typeof raw.from_checkpoint === "string"
246
+ ? { from_checkpoint: raw.from_checkpoint }
247
+ : {}),
248
+ ...(raw.resolve === "git_head" ? { resolve: "git_head" } : {}),
249
+ ...(typeof raw.git_revision === "boolean" ? { git_revision: raw.git_revision } : {}),
250
+ };
251
+ if (raw.default !== undefined) {
252
+ try {
253
+ const parsedDefault = parseInputValue(raw.default, type, key);
254
+ validateJobInputValue(parsedDefault, definition, key);
255
+ }
256
+ catch (error) {
257
+ errors.push(`inputs.${key}.default is invalid: ${error instanceof Error ? error.message : String(error)}`);
258
+ }
259
+ }
260
+ inputDefinitions[key] = definition;
261
+ }
262
+ }
263
+ }
264
+ let task;
265
+ if (!isRecord(value.task))
266
+ errors.push("task is required and must be a mapping");
267
+ else {
268
+ const mode = value.task.mode;
269
+ const targets = validStringList(value.task.targets) ? value.task.targets : undefined;
270
+ const paths = validStringList(value.task.paths) ? value.task.paths : undefined;
271
+ if (value.task.targets !== undefined && !targets)
272
+ errors.push("task.targets must be a non-empty string list");
273
+ if (value.task.paths !== undefined && !paths)
274
+ errors.push("task.paths must be a non-empty string list");
275
+ if (value.task.owner !== undefined && typeof value.task.owner !== "string")
276
+ errors.push("task.owner must be a string");
277
+ const common = {
278
+ ...(targets ? { targets: targets.map((target) => target.trim()) } : {}),
279
+ ...(paths ? { paths: paths.map((path) => path.trim()) } : {}),
280
+ ...(typeof value.task.owner === "string" ? { owner: value.task.owner.trim() } : {}),
281
+ };
282
+ if (mode === "command") {
283
+ const command = typeof value.task.command === "string" ? value.task.command.trim() : "";
284
+ if (!command)
285
+ errors.push("task.command is required for command mode");
286
+ let precondition;
287
+ if (value.task.precondition !== undefined) {
288
+ if (!isRecord(value.task.precondition)) {
289
+ errors.push("task.precondition must be a mapping with command and skip_when");
290
+ }
291
+ else {
292
+ const unknownPreconditionKeys = Object.keys(value.task.precondition).filter((key) => key !== "command" && key !== "skip_when");
293
+ if (unknownPreconditionKeys.length > 0) {
294
+ errors.push(`task.precondition has unknown key(s): ${unknownPreconditionKeys.sort().join(", ")}`);
295
+ }
296
+ const preconditionCommand = typeof value.task.precondition.command === "string"
297
+ ? value.task.precondition.command.trim()
298
+ : "";
299
+ if (!preconditionCommand)
300
+ errors.push("task.precondition.command is required");
301
+ const skipWhen = value.task.precondition.skip_when;
302
+ if (skipWhen !== "empty-output" &&
303
+ (!Number.isSafeInteger(skipWhen) || Number(skipWhen) < 0 || Number(skipWhen) > 255)) {
304
+ errors.push("task.precondition.skip_when must be empty-output or an exit code from 0 to 255");
305
+ }
306
+ if (preconditionCommand &&
307
+ (skipWhen === "empty-output" || Number.isSafeInteger(skipWhen))) {
308
+ precondition = {
309
+ command: preconditionCommand,
310
+ skip_when: skipWhen,
311
+ };
312
+ }
313
+ }
314
+ }
315
+ let analysis;
316
+ if (value.task.analysis !== undefined) {
317
+ if (!isRecord(value.task.analysis)) {
318
+ errors.push("task.analysis must be a mapping with agent and description");
319
+ }
320
+ else {
321
+ const unknownAnalysisKeys = Object.keys(value.task.analysis).filter((key) => key !== "agent" && key !== "description");
322
+ if (unknownAnalysisKeys.length > 0) {
323
+ errors.push(`task.analysis has unknown key(s): ${unknownAnalysisKeys.sort().join(", ")}`);
324
+ }
325
+ if (!isAgentNickname(value.task.analysis.agent)) {
326
+ errors.push("task.analysis.agent must be an agent nickname from pm-members.yaml");
327
+ }
328
+ const analysisDescription = typeof value.task.analysis.description === "string"
329
+ ? value.task.analysis.description.trim()
330
+ : "";
331
+ if (!analysisDescription)
332
+ errors.push("task.analysis.description is required");
333
+ if (isAgentNickname(value.task.analysis.agent) && analysisDescription) {
334
+ analysis = {
335
+ agent: value.task.analysis.agent.trim(),
336
+ description: analysisDescription,
337
+ };
338
+ }
339
+ }
340
+ }
341
+ if (value.task.agent !== undefined)
342
+ errors.push("task.agent is not allowed in command mode; use task.analysis.agent");
343
+ if (value.task.description !== undefined)
344
+ errors.push("task.description is not allowed in command mode; use task.analysis.description");
345
+ if (value.task.capabilities !== undefined || value.task.proficiency !== undefined) {
346
+ errors.push("task.capabilities and task.proficiency are not allowed in command mode");
347
+ }
348
+ if (command)
349
+ task = {
350
+ mode: "command",
351
+ ...(precondition ? { precondition } : {}),
352
+ command,
353
+ ...(analysis ? { analysis } : {}),
354
+ ...common,
355
+ };
356
+ }
357
+ else {
358
+ if (mode !== "edit" && mode !== "review") {
359
+ errors.push("task.mode must be edit, review, or command");
360
+ }
361
+ const description = typeof value.task.description === "string" ? value.task.description.trim() : "";
362
+ if (!description)
363
+ errors.push("task.description is required");
364
+ if (!targets && !paths)
365
+ errors.push("task.targets or task.paths must be a non-empty string list");
366
+ let agent;
367
+ if (value.task.agent !== undefined) {
368
+ const parsedAgent = parseJobAgent(value.task.agent);
369
+ if (parsedAgent.error)
370
+ errors.push(parsedAgent.error);
371
+ agent = parsedAgent.agent;
372
+ }
373
+ if (value.task.analysis !== undefined ||
374
+ value.task.command !== undefined ||
375
+ value.task.precondition !== undefined) {
376
+ errors.push("task.command, task.precondition, and task.analysis are only allowed in command mode");
377
+ }
378
+ if (value.task.capabilities !== undefined && !validStringList(value.task.capabilities)) {
379
+ errors.push("task.capabilities must be a non-empty string list");
380
+ }
381
+ const proficiency = value.task.proficiency;
382
+ if (proficiency !== undefined &&
383
+ !["low", "normal", "high", "expert"].includes(String(proficiency))) {
384
+ errors.push("task.proficiency must be low|normal|high|expert");
385
+ }
386
+ if ((mode === "edit" || mode === "review") && description && (targets || paths)) {
387
+ task = {
388
+ mode,
389
+ description,
390
+ ...common,
391
+ ...(agent ? { agent } : {}),
392
+ ...(validStringList(value.task.capabilities)
393
+ ? { capabilities: value.task.capabilities }
394
+ : {}),
395
+ ...(proficiency !== undefined ? { proficiency: proficiency } : {}),
396
+ };
397
+ }
398
+ }
399
+ }
400
+ const idempotencyKey = isRecord(value.run) && typeof value.run.idempotency_key === "string"
401
+ ? value.run.idempotency_key.trim()
402
+ : "";
403
+ if (!idempotencyKey)
404
+ errors.push("run.idempotency_key is required");
405
+ let checkpoint;
406
+ if (value.checkpoint !== undefined) {
407
+ if (!isRecord(value.checkpoint) || !isRecord(value.checkpoint.values)) {
408
+ errors.push("checkpoint.values must be a mapping");
409
+ }
410
+ else {
411
+ const values = {};
412
+ for (const [key, raw] of Object.entries(value.checkpoint.values)) {
413
+ if (!/^[a-z][a-z0-9_]*$/.test(key) || typeof raw !== "string") {
414
+ errors.push(`checkpoint.values.${key} must be a string with a lowercase snake_case key`);
415
+ }
416
+ else
417
+ values[key] = raw;
418
+ }
419
+ const advance = value.checkpoint.advance_on;
420
+ if (advance !== undefined &&
421
+ (!Array.isArray(advance) || advance.some((item) => item !== "succeeded" && item !== "noop"))) {
422
+ errors.push("checkpoint.advance_on must contain succeeded and/or noop");
423
+ }
424
+ checkpoint = {
425
+ values,
426
+ ...(Array.isArray(advance) ? { advance_on: advance } : {}),
427
+ };
428
+ }
429
+ }
430
+ if (errors.length > 0 || !task)
431
+ return { errors: errors.map((error) => `${fileName}: ${error}`) };
432
+ return {
433
+ job: {
434
+ id,
435
+ name,
436
+ ...(typeof value.description === "string" ? { description: value.description } : {}),
437
+ ...(Object.keys(inputDefinitions).length ? { inputs: inputDefinitions } : {}),
438
+ task,
439
+ run: { idempotency_key: idempotencyKey },
440
+ ...(checkpoint ? { checkpoint } : {}),
441
+ },
442
+ errors: [],
443
+ };
444
+ }
445
+ function configProject(projectId) {
446
+ loadEnv();
447
+ const { config, configPath } = loadConfig();
448
+ if (!config)
449
+ throw new Error(`job commands require specdojo.config.json: ${configPath}`);
450
+ const id = projectId?.trim() || process.env.SPECDOJO_PROJECT?.trim() || config.current_project;
451
+ if (!id)
452
+ throw new Error("Project id is required. Use --project or set current_project.");
453
+ const project = config.projects[id];
454
+ if (!project)
455
+ throw new Error(`Unknown project: ${id}`);
456
+ return { id, project };
457
+ }
458
+ export function resolveJobPaths(projectId) {
459
+ const { id, project } = configProject(projectId);
460
+ const jobsPath = getProjectJobsPath(project);
461
+ if (!jobsPath)
462
+ throw new Error(`jobs_path not set for project '${id}' in specdojo.config.json`);
463
+ const root = specdojoRootDir();
464
+ const executionPath = resolve(root, getProjectExecutionPath(project));
465
+ const absoluteJobsPath = resolve(root, jobsPath);
466
+ return {
467
+ projectId: id,
468
+ jobsPath: absoluteJobsPath,
469
+ executionPath,
470
+ runsPath: join(executionPath, "jobs", "runs"),
471
+ statePath: join(executionPath, "jobs", "generated", "job-state.json"),
472
+ };
473
+ }
474
+ export function loadJobDefinition(paths, jobId) {
475
+ const normalized = jobId.trim();
476
+ if (!/^job-[a-z0-9][a-z0-9-]*$/.test(normalized))
477
+ throw new Error(`Invalid job id: ${jobId}`);
478
+ const candidates = [
479
+ join(paths.jobsPath, `${normalized}.yaml`),
480
+ join(paths.jobsPath, `${normalized}.yml`),
481
+ ];
482
+ const filePath = candidates.find(existsSync);
483
+ if (!filePath)
484
+ throw new Error(`Job not found: ${normalized} (in ${paths.jobsPath})`);
485
+ const parsed = parseJobDefinition(yaml.load(readFileSync(filePath, "utf8")), basename(filePath));
486
+ if (!parsed.job)
487
+ throw new Error(parsed.errors.join("\n"));
488
+ return parsed.job;
489
+ }
490
+ export function loadAllJobs(jobsPath) {
491
+ if (!existsSync(jobsPath))
492
+ return { jobs: [], errors: [] };
493
+ const jobs = [];
494
+ const errors = [];
495
+ for (const filePath of listFilesRecursive(jobsPath)
496
+ .filter((path) => /(?:^|\/)job-[^/]+\.ya?ml$/.test(path))
497
+ .sort()) {
498
+ try {
499
+ const parsed = parseJobDefinition(yaml.load(readFileSync(filePath, "utf8")), basename(filePath));
500
+ errors.push(...parsed.errors);
501
+ if (parsed.job)
502
+ jobs.push(parsed.job);
503
+ }
504
+ catch (error) {
505
+ errors.push(`${basename(filePath)}: ${error instanceof Error ? error.message : String(error)}`);
506
+ }
507
+ }
508
+ return { jobs, errors };
509
+ }
510
+ export function parseJobInputs(raw) {
511
+ const result = {};
512
+ for (const token of raw === undefined ? [] : Array.isArray(raw) ? raw : [raw]) {
513
+ const index = token.indexOf("=");
514
+ if (index <= 0)
515
+ throw new Error(`Invalid --input value: ${token}. Use key=value.`);
516
+ const key = token.slice(0, index).trim();
517
+ if (!/^[a-z][a-z0-9_]*$/.test(key))
518
+ throw new Error(`Invalid input key: ${key}`);
519
+ if (Object.hasOwn(result, key))
520
+ throw new Error(`Duplicate input: ${key}`);
521
+ result[key] = token.slice(index + 1);
522
+ }
523
+ return result;
524
+ }
525
+ function parseInputValue(value, type, key) {
526
+ if (type === "string")
527
+ return String(value);
528
+ if (type === "integer") {
529
+ const parsed = typeof value === "number" ? value : Number(value);
530
+ if (!Number.isSafeInteger(parsed))
531
+ throw new Error(`Input ${key} must be an integer`);
532
+ return parsed;
533
+ }
534
+ if (type === "boolean") {
535
+ if (value === true || value === "true")
536
+ return true;
537
+ if (value === false || value === "false")
538
+ return false;
539
+ throw new Error(`Input ${key} must be true or false`);
540
+ }
541
+ if (Array.isArray(value))
542
+ return value.map(String);
543
+ return String(value)
544
+ .split(",")
545
+ .map((item) => item.trim())
546
+ .filter(Boolean);
547
+ }
548
+ function getPath(source, path) {
549
+ let current = source;
550
+ for (const part of path.split(".")) {
551
+ if (!isRecord(current) || !Object.hasOwn(current, part))
552
+ return undefined;
553
+ current = current[part];
554
+ }
555
+ return current;
556
+ }
557
+ function templateValue(value) {
558
+ return Array.isArray(value) ? value.join(",") : String(value ?? "");
559
+ }
560
+ export function renderJobTemplate(template, context) {
561
+ return template.replace(/\{\{\s*([a-z_][a-z0-9_.]*)\s*\}\}/gi, (_match, path) => {
562
+ if (path === "job_id")
563
+ return context.job_id;
564
+ if (path === "job_run_id") {
565
+ if (!context.job_run_id) {
566
+ throw new Error("Job template value job_run_id is unavailable before Run identity exists");
567
+ }
568
+ return context.job_run_id;
569
+ }
570
+ if (path === "project_id")
571
+ return context.project_id;
572
+ if (path === "specdojo")
573
+ return context.specdojo;
574
+ if (path === "scheduled_at")
575
+ return context.scheduled_at;
576
+ if (path.startsWith("inputs."))
577
+ return templateValue(getPath(context.inputs, path.slice(7)));
578
+ if (path.startsWith("checkpoint."))
579
+ return templateValue(getPath(context.checkpoint, path.slice(11)));
580
+ throw new Error(`Unknown job template value: ${path}`);
581
+ });
582
+ }
583
+ export function jobCheckpoint(paths, jobId) {
584
+ return deriveJobState(paths).jobs[jobId]?.checkpoint ?? {};
585
+ }
586
+ export function deriveJobState(paths) {
587
+ const state = { version: 1, jobs: {} };
588
+ if (!existsSync(paths.runsPath))
589
+ return state;
590
+ for (const filePath of listFilesRecursive(paths.runsPath)
591
+ .filter((path) => path.endsWith(".json"))
592
+ .sort()) {
593
+ try {
594
+ const run = readJobRunRecord(filePath);
595
+ if (!run.checkpoint_after || (run.state !== "succeeded" && run.state !== "noop"))
596
+ continue;
597
+ const current = state.jobs[run.job_id];
598
+ if (!current || current.updated_at < run.updated_at) {
599
+ state.jobs[run.job_id] = {
600
+ checkpoint: run.checkpoint_after,
601
+ last_run_id: run.run_id,
602
+ updated_at: run.updated_at,
603
+ };
604
+ }
605
+ }
606
+ catch {
607
+ // Invalid Run files are reported by schema validation; a broken file must not erase
608
+ // checkpoints that can still be derived from other valid history entries.
609
+ }
610
+ }
611
+ return state;
612
+ }
613
+ function resolveInputs(definition, raw, checkpoint) {
614
+ const definitions = definition.inputs ?? {};
615
+ for (const key of Object.keys(raw)) {
616
+ if (!definitions[key])
617
+ throw new Error(`Unknown input for ${definition.id}: ${key}`);
618
+ }
619
+ const values = {};
620
+ for (const [key, input] of Object.entries(definitions)) {
621
+ let value = raw[key];
622
+ if (value === undefined && input.from_checkpoint)
623
+ value = getPath(checkpoint, input.from_checkpoint);
624
+ if (value === undefined && input.resolve === "git_head") {
625
+ const result = spawnSync("git", ["rev-parse", "HEAD"], {
626
+ cwd: specdojoRootDir(),
627
+ encoding: "utf8",
628
+ env: gitEnvironment(),
629
+ });
630
+ if (result.status !== 0)
631
+ throw new Error(`Unable to resolve git HEAD for input ${key}`);
632
+ value = result.stdout.trim();
633
+ }
634
+ if (value === undefined && input.default !== undefined)
635
+ value = input.default;
636
+ if (value === undefined) {
637
+ if (input.required)
638
+ throw new Error(`Missing required input for ${definition.id}: ${key}`);
639
+ continue;
640
+ }
641
+ const parsed = parseInputValue(value, input.type, key);
642
+ validateJobInputValue(parsed, input, key);
643
+ if (input.git_revision) {
644
+ if (input.type !== "string")
645
+ throw new Error(`Input ${key} with git_revision must be a string`);
646
+ const result = spawnSync("git", ["rev-parse", String(parsed)], {
647
+ cwd: specdojoRootDir(),
648
+ encoding: "utf8",
649
+ env: gitEnvironment(),
650
+ });
651
+ if (result.status !== 0)
652
+ throw new Error(`Unable to resolve git revision for input ${key}: ${parsed}`);
653
+ values[key] = result.stdout.trim();
654
+ }
655
+ else {
656
+ values[key] = parsed;
657
+ }
658
+ }
659
+ return values;
660
+ }
661
+ function qualifyTargets(projectId, targets) {
662
+ return targets.map((target) => (target.includes(":") ? target : `${projectId}:${target}`));
663
+ }
664
+ function runIdFor(definition, idempotencyKey) {
665
+ const slug = definition.id.slice(4);
666
+ const digest = createHash("sha256").update(idempotencyKey).digest("hex").slice(0, 12);
667
+ return `JBR-${slug}-${digest}`;
668
+ }
669
+ function repoRelative(absPath) {
670
+ return relative(specdojoRootDir(), absPath).replaceAll("\\", "/");
671
+ }
672
+ const MAX_COMMAND_OUTPUT_BYTES = 64 * 1024;
673
+ function appendCommandOutput(chunks, chunk, capturedBytes) {
674
+ if (capturedBytes >= MAX_COMMAND_OUTPUT_BYTES) {
675
+ return { capturedBytes, truncated: chunk.length > 0 };
676
+ }
677
+ const remaining = MAX_COMMAND_OUTPUT_BYTES - capturedBytes;
678
+ chunks.push(chunk.subarray(0, remaining));
679
+ return {
680
+ capturedBytes: capturedBytes + Math.min(chunk.length, remaining),
681
+ truncated: chunk.length > remaining,
682
+ };
683
+ }
684
+ function commandOutputText(chunks, truncated) {
685
+ const text = Buffer.concat(chunks).toString("utf8");
686
+ return truncated ? text.replace(/\uFFFD$/u, "") : text;
687
+ }
688
+ /** Executes a materialized Job command directly in the runner process, never through an agent. */
689
+ export async function executeJobCommand(command, cwd) {
690
+ const startedAt = new Date().toISOString();
691
+ return await new Promise((resolveResult) => {
692
+ const stdoutChunks = [];
693
+ const stderrChunks = [];
694
+ let stdoutBytes = 0;
695
+ let stderrBytes = 0;
696
+ let stdoutTruncated = false;
697
+ let stderrTruncated = false;
698
+ let settled = false;
699
+ const executable = process.platform === "win32" ? process.env.ComSpec || "cmd.exe" : "/bin/sh";
700
+ const args = process.platform === "win32" ? ["/d", "/s", "/c", command] : ["-eu", "-c", command];
701
+ const child = spawn(executable, args, {
702
+ cwd,
703
+ env: gitEnvironment(),
704
+ shell: false,
705
+ stdio: ["ignore", "pipe", "pipe"],
706
+ windowsHide: true,
707
+ });
708
+ child.stdout.on("data", (chunk) => {
709
+ process.stdout.write(chunk);
710
+ const appended = appendCommandOutput(stdoutChunks, chunk, stdoutBytes);
711
+ stdoutBytes = appended.capturedBytes;
712
+ stdoutTruncated ||= appended.truncated;
713
+ });
714
+ child.stderr.on("data", (chunk) => {
715
+ process.stderr.write(chunk);
716
+ const appended = appendCommandOutput(stderrChunks, chunk, stderrBytes);
717
+ stderrBytes = appended.capturedBytes;
718
+ stderrTruncated ||= appended.truncated;
719
+ });
720
+ const finish = (exitCode, error) => {
721
+ if (settled)
722
+ return;
723
+ settled = true;
724
+ resolveResult({
725
+ command,
726
+ startedAt,
727
+ completedAt: new Date().toISOString(),
728
+ exitCode,
729
+ stdout: commandOutputText(stdoutChunks, stdoutTruncated),
730
+ stderr: commandOutputText(stderrChunks, stderrTruncated),
731
+ stdoutTruncated,
732
+ stderrTruncated,
733
+ ...(error ? { error } : {}),
734
+ });
735
+ };
736
+ child.once("error", (error) => finish(null, error.message));
737
+ child.once("close", (code) => finish(code));
738
+ });
739
+ }
740
+ export async function executeJobPrecondition(precondition, cwd) {
741
+ const result = await executeJobCommand(precondition.command, cwd);
742
+ if (result.error) {
743
+ throw new Error(`Job precondition spawn failed: ${result.error}`);
744
+ }
745
+ if (typeof precondition.skip_when === "number") {
746
+ if (result.exitCode === precondition.skip_when) {
747
+ return {
748
+ result,
749
+ skipped: true,
750
+ reason: `precondition exited with code ${precondition.skip_when}`,
751
+ };
752
+ }
753
+ if (result.exitCode !== 0) {
754
+ throw new Error(`Job precondition exited with code ${result.exitCode ?? "unknown"}`);
755
+ }
756
+ return { result, skipped: false };
757
+ }
758
+ if (result.exitCode !== 0) {
759
+ throw new Error(`Job precondition exited with code ${result.exitCode ?? "unknown"}`);
760
+ }
761
+ if (!result.stdout.trim()) {
762
+ return { result, skipped: true, reason: "empty selection" };
763
+ }
764
+ return { result, skipped: false };
765
+ }
766
+ function jobPlanFrontmatter(projectId, definition, record) {
767
+ const localId = `xep-${record.run_id.toLowerCase()}`;
768
+ const inner = [
769
+ `id: ${projectId}:${localId}`,
770
+ "type: exec-plan",
771
+ "rulebook: none",
772
+ `task_id: ${record.run_id}`,
773
+ `name: "${definition.name.replaceAll('"', "'")}"`,
774
+ // A command Run's plan is consumed only by the optional analysis reporter. Exec result
775
+ // frontmatter intentionally keeps the existing edit/review vocabulary for compatibility.
776
+ `mode: ${isJobCommandTask(record.task) ? "edit" : record.task.mode}`,
777
+ "status: ready",
778
+ `project_id: ${projectId}`,
779
+ "origin: job",
780
+ `job_id: ${definition.id}`,
781
+ `run_id: ${record.run_id}`,
782
+ ];
783
+ if (record.task.owner)
784
+ inner.push(`owner: ${record.task.owner}`);
785
+ if (record.task.targets) {
786
+ inner.push("targets:");
787
+ for (const target of record.task.targets)
788
+ inner.push(` - ${target}`);
789
+ }
790
+ if (record.task.paths) {
791
+ inner.push("paths:");
792
+ for (const path of record.task.paths)
793
+ inner.push(` - ${path}`);
794
+ }
795
+ return buildSpecdojoFrontmatter(inner);
796
+ }
797
+ export async function generateJobPlan(paths, definition, record) {
798
+ const templatePath = execTemplatePath("xep-job-template.md");
799
+ if (!existsSync(templatePath))
800
+ throw new Error(`Template not found: ${templatePath}`);
801
+ const planPath = join(paths.executionPath, "exec", "plans", `${record.run_id}-plan.md`);
802
+ mkdirSync(resolve(planPath, ".."), { recursive: true });
803
+ const commandTask = isJobCommandTask(record.task) ? record.task : undefined;
804
+ const values = {
805
+ _FRONTMATTER_: jobPlanFrontmatter(paths.projectId, definition, record),
806
+ _JOB_ID_: definition.id,
807
+ _JOB_NAME_: definition.name,
808
+ _RUN_ID_: record.run_id,
809
+ _SCHEDULED_AT_: record.scheduled_at,
810
+ _JOB_DESCRIPTION_: commandTask?.analysis?.description ??
811
+ (commandTask
812
+ ? "コマンドの終了結果を evidence として記録する。agent による判断は行わない。"
813
+ : isJobAgentTask(record.task)
814
+ ? record.task.description
815
+ : ""),
816
+ _JOB_EXECUTION_: commandTask
817
+ ? [
818
+ "### 3.1. 決定論的コマンド",
819
+ "",
820
+ "runner が次の解決済みコマンドを agent の sandbox 外で直接実行する。",
821
+ "",
822
+ "```sh",
823
+ commandTask.command,
824
+ "```",
825
+ "",
826
+ commandTask.analysis
827
+ ? "コマンドが成功した場合だけ、上記の判断を reporter agent が evidence に基づいて行う。"
828
+ : "コマンドの終了コードから Run の成否を直接決定する。",
829
+ ].join("\n")
830
+ : "",
831
+ _JOB_INPUTS_: JSON.stringify(record.inputs, null, 2),
832
+ _JOB_TARGETS_: record.task.targets?.map((target) => `- [[${target}]]`).join("\n") ?? "- -",
833
+ _JOB_PATHS_: record.task.paths?.map((path) => `- \`${path}\``).join("\n") ?? "- -",
834
+ _RESULT_REF_: repoRelative(join(paths.executionPath, "exec", "results", `${record.run_id}-result.md`)),
835
+ };
836
+ const body = expandTemplate(readFileSync(templatePath, "utf8"), values);
837
+ const content = injectCommonConventions(body, MISSING, new Map());
838
+ writeFileSync(planPath, content, "utf8");
839
+ await formatMarkdownFile(planPath);
840
+ return planPath;
841
+ }
842
+ export async function materializeJobRun(opts) {
843
+ const paths = resolveJobPaths(opts.projectId);
844
+ const definition = loadJobDefinition(paths, opts.jobId);
845
+ const checkpoint = jobCheckpoint(paths, definition.id);
846
+ const scheduledAt = opts.scheduledAt
847
+ ? new Date(opts.scheduledAt).toISOString()
848
+ : new Date().toISOString();
849
+ const inputs = resolveInputs(definition, parseJobInputs(opts.inputs), checkpoint);
850
+ const identityContext = {
851
+ job_id: definition.id,
852
+ project_id: paths.projectId,
853
+ specdojo: selfRunCommand(),
854
+ scheduled_at: scheduledAt,
855
+ inputs,
856
+ checkpoint,
857
+ };
858
+ const idempotencyKey = renderJobTemplate(definition.run.idempotency_key, identityContext);
859
+ if (!idempotencyKey.trim())
860
+ throw new Error(`Resolved idempotency key is empty: ${definition.id}`);
861
+ const runId = runIdFor(definition, idempotencyKey);
862
+ const context = { ...identityContext, job_run_id: runId };
863
+ const runPath = join(paths.runsPath, `${runId}.json`);
864
+ const targets = definition.task.targets
865
+ ? qualifyTargets(paths.projectId, definition.task.targets)
866
+ : undefined;
867
+ const task = {
868
+ ...definition.task,
869
+ ...(targets ? { targets } : {}),
870
+ };
871
+ if (isJobCommandTask(task)) {
872
+ if (task.precondition) {
873
+ task.precondition = {
874
+ ...task.precondition,
875
+ command: renderJobTemplate(task.precondition.command, context),
876
+ };
877
+ }
878
+ task.command = renderJobTemplate(task.command, context);
879
+ if (task.analysis) {
880
+ task.analysis = {
881
+ ...task.analysis,
882
+ description: renderJobTemplate(task.analysis.description, context),
883
+ };
884
+ }
885
+ }
886
+ else {
887
+ task.description = renderJobTemplate(task.description, context);
888
+ }
889
+ const now = new Date().toISOString();
890
+ const existingRun = existsSync(runPath);
891
+ let record;
892
+ if (existingRun) {
893
+ record = readJobRunRecord(runPath);
894
+ if (record.idempotency_key !== idempotencyKey || record.job_id !== definition.id) {
895
+ throw new Error(`Job Run identity collision: ${runId}`);
896
+ }
897
+ if (record.state === "succeeded" || record.state === "noop") {
898
+ return {
899
+ definition,
900
+ record,
901
+ runPath,
902
+ planPath: join(paths.executionPath, record.plan_ref),
903
+ duplicateComplete: true,
904
+ };
905
+ }
906
+ }
907
+ else {
908
+ record = {
909
+ version: 1,
910
+ run_id: runId,
911
+ job_id: definition.id,
912
+ idempotency_key: idempotencyKey,
913
+ project_id: paths.projectId,
914
+ trigger: opts.trigger ?? "manual",
915
+ scheduled_at: scheduledAt,
916
+ created_at: now,
917
+ updated_at: now,
918
+ state: "running",
919
+ inputs,
920
+ task,
921
+ checkpoint_before: checkpoint,
922
+ plan_ref: `exec/plans/${runId}-plan.md`,
923
+ result_ref: `exec/results/${runId}-result.md`,
924
+ attempts: [],
925
+ };
926
+ }
927
+ if (!existingRun && !opts.dryRun && isJobCommandTask(task) && task.precondition) {
928
+ const precondition = await executeJobPrecondition(task.precondition, specdojoRootDir());
929
+ if (precondition.skipped) {
930
+ return {
931
+ definition,
932
+ record,
933
+ runPath,
934
+ planPath: join(paths.executionPath, record.plan_ref),
935
+ duplicateComplete: false,
936
+ preconditionSkipped: true,
937
+ preconditionReason: precondition.reason,
938
+ preconditionResult: precondition.result,
939
+ };
940
+ }
941
+ }
942
+ const attempt = {
943
+ attempt: record.attempts.length + 1,
944
+ started_at: now,
945
+ status: "running",
946
+ };
947
+ record = {
948
+ ...record,
949
+ updated_at: now,
950
+ state: "running",
951
+ attempts: [...record.attempts, attempt],
952
+ };
953
+ if (!opts.dryRun) {
954
+ mkdirSync(paths.runsPath, { recursive: true });
955
+ writeJson(runPath, record);
956
+ }
957
+ const planPath = opts.dryRun
958
+ ? join(paths.executionPath, record.plan_ref)
959
+ : await generateJobPlan(paths, definition, record);
960
+ return { definition, record, runPath, planPath, duplicateComplete: false };
961
+ }
962
+ export function completeJobRun(opts) {
963
+ const paths = resolveJobPaths(opts.projectId);
964
+ const record = readJobRunRecord(opts.runPath);
965
+ const definition = loadJobDefinition(paths, record.job_id);
966
+ const completedAt = new Date().toISOString();
967
+ const attempts = [...record.attempts];
968
+ const current = attempts.at(-1);
969
+ if (!current)
970
+ throw new Error(`Job Run has no attempt: ${record.run_id}`);
971
+ attempts[attempts.length - 1] = {
972
+ ...current,
973
+ completed_at: completedAt,
974
+ status: opts.status,
975
+ result_ref: record.result_ref,
976
+ ...(opts.evidenceRef ? { evidence_ref: opts.evidenceRef } : {}),
977
+ ...(opts.exitCode !== undefined ? { exit_code: opts.exitCode } : {}),
978
+ ...(opts.reason ? { reason: opts.reason } : {}),
979
+ };
980
+ let checkpointAfter;
981
+ const advanceOn = definition.checkpoint?.advance_on ?? ["succeeded", "noop"];
982
+ if (definition.checkpoint && advanceOn.includes(opts.status)) {
983
+ const context = {
984
+ job_id: definition.id,
985
+ job_run_id: record.run_id,
986
+ project_id: record.project_id,
987
+ specdojo: selfRunCommand(),
988
+ scheduled_at: record.scheduled_at,
989
+ inputs: record.inputs,
990
+ checkpoint: record.checkpoint_before,
991
+ };
992
+ checkpointAfter = Object.fromEntries(Object.entries(definition.checkpoint.values).map(([key, value]) => [
993
+ key,
994
+ renderJobTemplate(value, context),
995
+ ]));
996
+ }
997
+ const updated = {
998
+ ...record,
999
+ updated_at: completedAt,
1000
+ state: opts.status,
1001
+ attempts,
1002
+ ...(checkpointAfter ? { checkpoint_after: checkpointAfter } : {}),
1003
+ };
1004
+ writeJson(opts.runPath, updated);
1005
+ if (checkpointAfter) {
1006
+ const state = deriveJobState(paths);
1007
+ state.jobs[record.job_id] = {
1008
+ checkpoint: checkpointAfter,
1009
+ last_run_id: record.run_id,
1010
+ updated_at: completedAt,
1011
+ };
1012
+ mkdirSync(resolve(paths.statePath, ".."), { recursive: true });
1013
+ writeJson(paths.statePath, state);
1014
+ }
1015
+ return updated;
1016
+ }
1017
+ export function jobRunRelativePath(runPath) {
1018
+ return repoRelative(runPath);
1019
+ }
1020
+ export function registerJobCommands(program) {
1021
+ const command = program.command("job").description("Reusable Job Definition and Run helpers");
1022
+ command
1023
+ .command("where")
1024
+ .description("Print resolved Job paths")
1025
+ .option("--project <projectId>", "Project id")
1026
+ .action((opts) => {
1027
+ try {
1028
+ const paths = resolveJobPaths(opts.project);
1029
+ process.stdout.write(`project: ${paths.projectId}\n`);
1030
+ process.stdout.write(`jobs: ${paths.jobsPath}\n`);
1031
+ process.stdout.write(`runs: ${paths.runsPath}\n`);
1032
+ process.stdout.write(`state: ${paths.statePath}\n`);
1033
+ }
1034
+ catch (error) {
1035
+ process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
1036
+ process.exitCode = 1;
1037
+ }
1038
+ });
1039
+ command
1040
+ .command("validate")
1041
+ .description("Validate job-*.yaml definitions")
1042
+ .option("--project <projectId>", "Project id")
1043
+ .action((opts) => {
1044
+ try {
1045
+ const paths = resolveJobPaths(opts.project);
1046
+ const { jobs, errors } = loadAllJobs(paths.jobsPath);
1047
+ for (const error of errors)
1048
+ process.stderr.write(`ERROR: ${error}\n`);
1049
+ process.stdout.write(`Validated: ${jobs.length} job(s), ${errors.length} error(s)\n`);
1050
+ if (errors.length)
1051
+ process.exitCode = 1;
1052
+ }
1053
+ catch (error) {
1054
+ process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
1055
+ process.exitCode = 1;
1056
+ }
1057
+ });
1058
+ command
1059
+ .command("list")
1060
+ .description("List Job Definitions and latest checkpoint")
1061
+ .option("--project <projectId>", "Project id")
1062
+ .action((opts) => {
1063
+ try {
1064
+ const paths = resolveJobPaths(opts.project);
1065
+ const { jobs, errors } = loadAllJobs(paths.jobsPath);
1066
+ const state = deriveJobState(paths);
1067
+ for (const job of jobs) {
1068
+ const latest = state.jobs[job.id];
1069
+ process.stdout.write(`${job.id}\t${latest?.last_run_id ?? "-"}\t${job.name}\n`);
1070
+ }
1071
+ for (const error of errors)
1072
+ process.stderr.write(`ERROR: ${error}\n`);
1073
+ if (errors.length)
1074
+ process.exitCode = 1;
1075
+ }
1076
+ catch (error) {
1077
+ process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
1078
+ process.exitCode = 1;
1079
+ }
1080
+ });
1081
+ }