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
@@ -1,71 +1,103 @@
1
- import { extname, join, resolve } from 'node:path';
2
- import { mkdirSync, readFileSync, rmSync, statSync, writeFileSync } from 'node:fs';
3
- import { collectRepeatable, ensureDir, isUtcIsoSeconds, listFilesRecursive, nowUtcIsoSeconds, parseKeyValuePairs, randomHex, readJson, requireNonEmpty, safeSlug, sleepMs, toArtifactPath, tsForFilenameUtc, writeJson, } from './exec-shared.js';
4
- import { eventsDirForProject, executionRootForProject } from './exec-project.js';
1
+ import { extname, join, resolve } from "node:path";
2
+ import { mkdirSync, readFileSync, rmSync, statSync, writeFileSync } from "node:fs";
3
+ import { collectRepeatable, ensureDir, isUtcIsoSeconds, listFilesRecursive, nowUtcIsoSeconds, parseKeyValuePairs, randomHex, readJson, requireNonEmpty, safeSlug, sleepMs, toArtifactPath, tsForFilenameUtc, writeJson, } from "./exec-shared.js";
4
+ import { eventsDirForProject, executionRootForProject } from "./exec-project.js";
5
5
  export { collectRepeatable };
6
6
  export function validateEventShape(obj, source) {
7
7
  const errs = [];
8
8
  function err(msg) {
9
9
  errs.push(`${source}: ${msg}`);
10
10
  }
11
- if (!obj || typeof obj !== 'object') {
12
- err('not a JSON object');
11
+ if (!obj || typeof obj !== "object") {
12
+ err("not a JSON object");
13
13
  return errs;
14
14
  }
15
- if (obj.v !== 1)
16
- err('v must be 1');
17
- if (typeof obj.ts !== 'string' || !isUtcIsoSeconds(obj.ts)) {
18
- err('ts must be UTC ISO seconds like 2026-03-05T03:10:00Z');
15
+ const o = obj;
16
+ if (o.v !== 1)
17
+ err("v must be 1");
18
+ if (typeof o.ts !== "string" || !isUtcIsoSeconds(o.ts)) {
19
+ err("ts must be UTC ISO seconds like 2026-03-05T03:10:00Z");
19
20
  }
20
21
  const allowed = new Set([
21
- 'claim',
22
- 'note',
23
- 'block',
24
- 'unblock',
25
- 'complete',
26
- 'cancel',
27
- 'link',
28
- 'estimate',
22
+ "claim",
23
+ "note",
24
+ "block",
25
+ "unblock",
26
+ "complete",
27
+ "reopen",
28
+ "release",
29
+ "cancel",
30
+ "link",
31
+ "estimate",
29
32
  ]);
30
- if (typeof obj.type !== 'string' || !allowed.has(obj.type)) {
31
- err(`type must be one of ${Array.from(allowed).join(', ')}`);
33
+ if (typeof o.type !== "string" || !allowed.has(o.type)) {
34
+ err(`type must be one of ${Array.from(allowed).join(", ")}`);
32
35
  }
33
- if (typeof obj.task_id !== 'string' || obj.task_id.trim() === '') {
34
- err('task_id must be non-empty string');
36
+ if (typeof o.task_id !== "string" || o.task_id.trim() === "") {
37
+ err("task_id must be non-empty string");
35
38
  }
36
- if (typeof obj.by !== 'string' || obj.by.trim() === '')
37
- err('by must be non-empty string');
38
- if (typeof obj.msg !== 'string')
39
- err('msg must be string');
40
- if (obj.refs !== undefined &&
41
- (typeof obj.refs !== 'object' || obj.refs === null || Array.isArray(obj.refs))) {
42
- err('refs must be object if provided');
39
+ if (typeof o.by !== "string" || o.by.trim() === "")
40
+ err("by must be non-empty string");
41
+ if (typeof o.msg !== "string")
42
+ err("msg must be string");
43
+ if (o.refs !== undefined &&
44
+ (typeof o.refs !== "object" || o.refs === null || Array.isArray(o.refs))) {
45
+ err("refs must be object if provided");
43
46
  }
44
- if (obj.meta !== undefined &&
45
- (typeof obj.meta !== 'object' || obj.meta === null || Array.isArray(obj.meta))) {
46
- err('meta must be object if provided');
47
+ if (o.meta !== undefined &&
48
+ (typeof o.meta !== "object" || o.meta === null || Array.isArray(o.meta))) {
49
+ err("meta must be object if provided");
47
50
  }
48
51
  return errs;
49
52
  }
53
+ export function isExecEventV1(value, source) {
54
+ return validateEventShape(value, source).length === 0;
55
+ }
50
56
  export function readAllEventFiles(projectPath) {
51
57
  const dir = eventsDirForProject(projectPath);
52
- const files = listFilesRecursive(dir).filter(p => extname(p).toLowerCase() === '.json');
58
+ const files = listFilesRecursive(dir).filter((p) => extname(p).toLowerCase() === ".json");
53
59
  const items = [];
54
- for (const f of files)
55
- items.push({ path: f, event: readJson(f) });
60
+ for (const f of files) {
61
+ const raw = readJson(f);
62
+ // Events are the SSOT for task state. A malformed file must not be folded in
63
+ // silently as undefined fields; report it with the failing path instead.
64
+ if (!isExecEventV1(raw, f)) {
65
+ throw new Error(`Invalid exec event file: ${validateEventShape(raw, f).join("; ")}. ` +
66
+ `Run: specdojo exec validate`);
67
+ }
68
+ items.push({ path: f, event: raw });
69
+ }
70
+ // Within the same timestamp, order by logical event sequence to prevent
71
+ // e.g. 'cancel' (alphabetically before 'claim') from being processed first.
72
+ const typeOrder = {
73
+ claim: 1,
74
+ note: 2,
75
+ block: 3,
76
+ complete: 3,
77
+ estimate: 3,
78
+ link: 3,
79
+ unblock: 4,
80
+ reopen: 4,
81
+ release: 5,
82
+ cancel: 5,
83
+ };
56
84
  items.sort((a, b) => {
57
85
  if (a.event.ts < b.event.ts)
58
86
  return -1;
59
87
  if (a.event.ts > b.event.ts)
60
88
  return 1;
89
+ const orderA = typeOrder[a.event.type] ?? 99;
90
+ const orderB = typeOrder[b.event.type] ?? 99;
91
+ if (orderA !== orderB)
92
+ return orderA - orderB;
61
93
  return a.path.localeCompare(b.path);
62
94
  });
63
95
  return items;
64
96
  }
65
97
  export function buildEvent(type, o) {
66
- const task_id = requireNonEmpty('task', o.task);
67
- const by = requireNonEmpty('by', o.by);
68
- const msg = requireNonEmpty('msg', o.msg);
98
+ const task_id = requireNonEmpty("task", o.task);
99
+ const by = requireNonEmpty("by", o.by);
100
+ const msg = requireNonEmpty("msg", o.msg);
69
101
  const refs = parseKeyValuePairs(o.ref);
70
102
  const metaPairs = parseKeyValuePairs(o.meta);
71
103
  const meta = metaPairs
@@ -89,17 +121,19 @@ export function writeEventFile(projectPath, event) {
89
121
  const rand = randomHex(2);
90
122
  const filename = `${tsPart}_${byPart}_${idPart}_${event.type}_${rand}.json`;
91
123
  const fullpath = join(execDir, filename);
92
- writeFileSync(fullpath, JSON.stringify(event, null, 2) + '\n', 'utf8');
124
+ writeFileSync(fullpath, JSON.stringify(event, null, 2) + "\n", "utf8");
93
125
  return fullpath;
94
126
  }
95
- export function foldEventsToState(events, schedule, projectPath) {
96
- const tasks = {};
127
+ export function foldEventsToState(events, schedule, projectPath, initialTasks) {
128
+ const tasks = initialTasks ? { ...initialTasks } : {};
97
129
  function ensure(id) {
98
130
  if (!tasks[id])
99
- tasks[id] = { state: 'todo' };
131
+ tasks[id] = { state: "todo" };
100
132
  return tasks[id];
101
133
  }
102
134
  for (const { event } of events) {
135
+ if (!schedule.nodes.has(event.task_id))
136
+ continue;
103
137
  const cur = ensure(event.task_id);
104
138
  cur.last_ts = event.ts;
105
139
  cur.last_by = event.by;
@@ -109,16 +143,42 @@ export function foldEventsToState(events, schedule, projectPath) {
109
143
  cur.refs = event.refs;
110
144
  if (event.meta)
111
145
  cur.meta = event.meta;
112
- if (event.type === 'claim')
113
- cur.state = 'doing';
114
- else if (event.type === 'block')
115
- cur.state = 'blocked';
116
- else if (event.type === 'unblock')
117
- cur.state = 'todo';
118
- else if (event.type === 'complete')
119
- cur.state = 'done';
120
- else if (event.type === 'cancel')
121
- cur.state = 'cancelled';
146
+ if (event.type === "claim")
147
+ cur.state = "doing";
148
+ else if (event.type === "block")
149
+ cur.state = "blocked";
150
+ else if (event.type === "unblock")
151
+ cur.state = "doing"; // resume work; same actor continues
152
+ else if (event.type === "complete")
153
+ cur.state = "done";
154
+ else if (event.type === "reopen") {
155
+ // reopen corrects an erroneous completion without deleting the complete event.
156
+ // Other states are left untouched (the command guard prevents emitting them).
157
+ if (cur.state === "done")
158
+ cur.state = "todo";
159
+ }
160
+ else if (event.type === "release") {
161
+ // release returns an in-flight attempt to todo so the task can be re-executed.
162
+ // doing → todo (claim released)
163
+ // blocked → todo (blocked attempt abandoned)
164
+ // Other states are left untouched (the command guard prevents emitting them).
165
+ if (cur.state === "doing" || cur.state === "blocked")
166
+ cur.state = "todo";
167
+ }
168
+ else if (event.type === "cancel") {
169
+ // Legacy cancel is state-dependent, kept for backward compatibility with events written
170
+ // before `release` existed. New cancel commands run only from todo (→ cancelled); the
171
+ // doing/blocked → todo transitions are now recorded as `release` events.
172
+ // todo → cancelled (task permanently abandoned)
173
+ // doing → todo (legacy: claim released)
174
+ // blocked → todo (legacy: attempt abandoned)
175
+ if (cur.state === "todo")
176
+ cur.state = "cancelled";
177
+ else if (cur.state === "doing" || cur.state === "blocked")
178
+ cur.state = "todo";
179
+ else
180
+ cur.state = "cancelled";
181
+ }
122
182
  }
123
183
  for (const id of schedule.nodes.keys())
124
184
  ensure(id);
@@ -131,28 +191,28 @@ export function isDependencySatisfied(schedule, snapshot, nodeId, visiting = new
131
191
  const node = schedule.nodes.get(nodeId);
132
192
  if (!node)
133
193
  return false;
134
- if (node.kind === 'task') {
135
- return (snapshot.tasks[nodeId]?.state ?? 'todo') === 'done';
194
+ if (node.kind === "task") {
195
+ return (snapshot.tasks[nodeId]?.state ?? "todo") === "done";
136
196
  }
137
197
  if (visiting.has(nodeId))
138
198
  return false;
139
199
  visiting.add(nodeId);
140
- const ok = node.depends_on.every(dep => isDependencySatisfied(schedule, snapshot, dep, visiting));
200
+ const ok = node.depends_on.every((dep) => isDependencySatisfied(schedule, snapshot, dep, visiting));
141
201
  visiting.delete(nodeId);
142
202
  return ok;
143
203
  }
144
204
  export function computeReadyIds(schedule, snapshot) {
145
205
  function stateOf(id) {
146
- return snapshot.tasks[id]?.state ?? 'todo';
206
+ return snapshot.tasks[id]?.state ?? "todo";
147
207
  }
148
208
  const ready = [];
149
209
  for (const n of schedule.nodes.values()) {
150
- if (n.kind !== 'task')
210
+ if (n.kind !== "task")
151
211
  continue;
152
212
  const st = stateOf(n.id);
153
- if (st === 'done' || st === 'cancelled' || st === 'doing' || st === 'blocked')
213
+ if (st === "done" || st === "cancelled" || st === "doing" || st === "blocked")
154
214
  continue;
155
- if (n.depends_on.every(d => isDependencySatisfied(schedule, snapshot, d)))
215
+ if (n.depends_on.every((d) => isDependencySatisfied(schedule, snapshot, d)))
156
216
  ready.push(n.id);
157
217
  }
158
218
  ready.sort();
@@ -160,7 +220,7 @@ export function computeReadyIds(schedule, snapshot) {
160
220
  }
161
221
  export function findDoingTasksForActor(snapshot, actor) {
162
222
  return Object.entries(snapshot.tasks)
163
- .filter(([, st]) => st.state === 'doing' && st.last_by === actor)
223
+ .filter(([, st]) => st.state === "doing" && st.last_by === actor)
164
224
  .map(([taskId]) => taskId)
165
225
  .sort();
166
226
  }
@@ -168,24 +228,24 @@ export function canClaimTask(schedule, snapshot, taskId, actorOwner, allowOwnerM
168
228
  const node = schedule.nodes.get(taskId);
169
229
  if (!node)
170
230
  return { ok: false, reason: `task not found in schedule: ${taskId}` };
171
- if (node.kind !== 'task')
231
+ if (node.kind !== "task")
172
232
  return { ok: false, reason: `cannot claim non-task node: ${taskId}` };
173
- if (node.owner && !allowOwnerMismatch && actorOwner !== node.owner) {
233
+ if (node.owner && actorOwner && !allowOwnerMismatch && actorOwner !== node.owner) {
174
234
  return {
175
235
  ok: false,
176
- reason: `task assigned to owner ${node.owner}; acting owner is ${actorOwner ?? '(unspecified)'}. ` +
236
+ reason: `task assigned to owner ${node.owner}; acting owner is ${actorOwner ?? "(unspecified)"}. ` +
177
237
  `Use --owner ${node.owner}, SPECDOJO_OWNER=${node.owner}, or --allow-owner-mismatch.`,
178
238
  };
179
239
  }
180
240
  const cur = snapshot.tasks[taskId];
181
- const state = cur?.state ?? 'todo';
182
- if (state === 'doing')
241
+ const state = cur?.state ?? "todo";
242
+ if (state === "doing")
183
243
  return { ok: false, reason: `task already doing: ${taskId}` };
184
- if (state === 'done')
244
+ if (state === "done")
185
245
  return { ok: false, reason: `task already done: ${taskId}` };
186
- if (state === 'cancelled')
246
+ if (state === "cancelled")
187
247
  return { ok: false, reason: `task cancelled: ${taskId}` };
188
- if (state === 'blocked')
248
+ if (state === "blocked")
189
249
  return { ok: false, reason: `task blocked: ${taskId}` };
190
250
  for (const dep of node.depends_on) {
191
251
  if (!isDependencySatisfied(schedule, snapshot, dep)) {
@@ -194,55 +254,106 @@ export function canClaimTask(schedule, snapshot, taskId, actorOwner, allowOwnerM
194
254
  }
195
255
  return { ok: true };
196
256
  }
197
- export function canCompleteTask(schedule, snapshot, taskId, actor) {
257
+ function canOverrideCrossActor(override) {
258
+ return !!override?.isHuman && !!override?.force;
259
+ }
260
+ function crossActorReason(lastBy) {
261
+ return (`task is being worked on by another actor: ${lastBy ?? "(unknown)"}` +
262
+ ` (a human may override with --force)`);
263
+ }
264
+ export function canCompleteTask(schedule, snapshot, taskId, actor, override) {
198
265
  const node = schedule.nodes.get(taskId);
199
266
  if (!node)
200
267
  return { ok: false, reason: `task not found in schedule: ${taskId}` };
201
- if (node.kind !== 'task')
268
+ if (node.kind !== "task")
202
269
  return { ok: false, reason: `cannot complete non-task node: ${taskId}` };
203
270
  const cur = snapshot.tasks[taskId];
204
- const state = cur?.state ?? 'todo';
205
- if (state === 'todo')
271
+ const state = cur?.state ?? "todo";
272
+ if (state === "todo")
206
273
  return { ok: false, reason: `task not started: ${taskId}` };
207
- if (state === 'blocked')
274
+ if (state === "blocked")
208
275
  return { ok: false, reason: `task is blocked: ${taskId}` };
209
- if (state === 'done')
276
+ if (state === "done")
210
277
  return { ok: false, reason: `task already done: ${taskId}` };
211
- if (state === 'cancelled')
278
+ if (state === "cancelled")
212
279
  return { ok: false, reason: `task cancelled: ${taskId}` };
213
- if (state !== 'doing')
280
+ if (state !== "doing")
214
281
  return { ok: false, reason: `task is not doing: ${taskId}` };
215
- if (cur?.last_by !== actor) {
282
+ if (cur?.last_by !== actor && !canOverrideCrossActor(override)) {
283
+ return { ok: false, reason: crossActorReason(cur?.last_by) };
284
+ }
285
+ return { ok: true };
286
+ }
287
+ // Reopening reverses a terminal completion and can invalidate dependency decisions. It is therefore
288
+ // human-only and is rejected while any downstream task is already in-flight or complete. Traversal
289
+ // passes through milestone/gate nodes so transitive task dependencies are guarded as well.
290
+ export function canReopenTask(schedule, snapshot, taskId, isHuman) {
291
+ const node = schedule.nodes.get(taskId);
292
+ if (!node)
293
+ return { ok: false, reason: `task not found in schedule: ${taskId}` };
294
+ if (node.kind !== "task")
295
+ return { ok: false, reason: `cannot reopen non-task node: ${taskId}` };
296
+ if (!isHuman)
297
+ return { ok: false, reason: `reopen requires a human actor: ${taskId}` };
298
+ const state = snapshot.tasks[taskId]?.state ?? "todo";
299
+ if (state !== "done")
300
+ return { ok: false, reason: `task is not done: ${taskId} (${state})` };
301
+ const reverseDependencies = new Map();
302
+ for (const candidate of schedule.nodes.values()) {
303
+ for (const dependencyId of candidate.depends_on) {
304
+ const dependents = reverseDependencies.get(dependencyId) ?? [];
305
+ dependents.push(candidate.id);
306
+ reverseDependencies.set(dependencyId, dependents);
307
+ }
308
+ }
309
+ const visited = new Set([taskId]);
310
+ const queue = [...(reverseDependencies.get(taskId) ?? [])];
311
+ const conflicting = [];
312
+ while (queue.length > 0) {
313
+ const dependentId = queue.shift();
314
+ if (visited.has(dependentId))
315
+ continue;
316
+ visited.add(dependentId);
317
+ const dependent = schedule.nodes.get(dependentId);
318
+ if (!dependent)
319
+ continue;
320
+ if (dependent.kind === "task") {
321
+ const dependentState = snapshot.tasks[dependentId]?.state ?? "todo";
322
+ if (dependentState === "doing" || dependentState === "blocked" || dependentState === "done") {
323
+ conflicting.push(`${dependentId} (${dependentState})`);
324
+ }
325
+ }
326
+ queue.push(...(reverseDependencies.get(dependentId) ?? []));
327
+ }
328
+ if (conflicting.length > 0) {
329
+ conflicting.sort((a, b) => a.localeCompare(b));
216
330
  return {
217
331
  ok: false,
218
- reason: `task is being worked on by another actor: ${cur?.last_by ?? '(unknown)'}`,
332
+ reason: `downstream task(s) must be reopened or released first: ${conflicting.join(", ")}`,
219
333
  };
220
334
  }
221
335
  return { ok: true };
222
336
  }
223
- export function canBlockTask(schedule, snapshot, taskId, actor) {
337
+ export function canBlockTask(schedule, snapshot, taskId, actor, override) {
224
338
  const node = schedule.nodes.get(taskId);
225
339
  if (!node)
226
340
  return { ok: false, reason: `task not found in schedule: ${taskId}` };
227
- if (node.kind !== 'task')
341
+ if (node.kind !== "task")
228
342
  return { ok: false, reason: `cannot block non-task node: ${taskId}` };
229
343
  const cur = snapshot.tasks[taskId];
230
- const state = cur?.state ?? 'todo';
231
- if (state === 'todo')
344
+ const state = cur?.state ?? "todo";
345
+ if (state === "todo")
232
346
  return { ok: false, reason: `task not started: ${taskId}` };
233
- if (state === 'blocked')
347
+ if (state === "blocked")
234
348
  return { ok: false, reason: `task already blocked: ${taskId}` };
235
- if (state === 'done')
349
+ if (state === "done")
236
350
  return { ok: false, reason: `task already done: ${taskId}` };
237
- if (state === 'cancelled')
351
+ if (state === "cancelled")
238
352
  return { ok: false, reason: `task cancelled: ${taskId}` };
239
- if (state !== 'doing')
353
+ if (state !== "doing")
240
354
  return { ok: false, reason: `task is not doing: ${taskId}` };
241
- if (cur?.last_by !== actor) {
242
- return {
243
- ok: false,
244
- reason: `task is being worked on by another actor: ${cur?.last_by ?? '(unknown)'}`,
245
- };
355
+ if (cur?.last_by !== actor && !canOverrideCrossActor(override)) {
356
+ return { ok: false, reason: crossActorReason(cur?.last_by) };
246
357
  }
247
358
  return { ok: true };
248
359
  }
@@ -250,54 +361,81 @@ export function canUnblockTask(schedule, snapshot, taskId) {
250
361
  const node = schedule.nodes.get(taskId);
251
362
  if (!node)
252
363
  return { ok: false, reason: `task not found in schedule: ${taskId}` };
253
- if (node.kind !== 'task')
364
+ if (node.kind !== "task")
254
365
  return { ok: false, reason: `cannot unblock non-task node: ${taskId}` };
255
366
  const cur = snapshot.tasks[taskId];
256
- const state = cur?.state ?? 'todo';
257
- if (state === 'todo')
367
+ const state = cur?.state ?? "todo";
368
+ if (state === "todo")
258
369
  return { ok: false, reason: `task is not blocked: ${taskId}` };
259
- if (state === 'doing')
370
+ if (state === "doing")
260
371
  return { ok: false, reason: `task is not blocked: ${taskId}` };
261
- if (state === 'done')
372
+ if (state === "done")
262
373
  return { ok: false, reason: `task already done: ${taskId}` };
263
- if (state === 'cancelled')
374
+ if (state === "cancelled")
264
375
  return { ok: false, reason: `task cancelled: ${taskId}` };
265
- if (state !== 'blocked')
376
+ if (state !== "blocked")
266
377
  return { ok: false, reason: `task is not blocked: ${taskId}` };
267
378
  return { ok: true };
268
379
  }
269
- export function canCancelTask(schedule, snapshot, taskId, actor) {
380
+ // release returns a doing/blocked task to todo for re-execution. Only the claiming actor may
381
+ // release it (a human may override with --force), mirroring complete/block so an agent cannot
382
+ // reset another actor's in-flight work.
383
+ export function canReleaseTask(schedule, snapshot, taskId, actor, override) {
384
+ const node = schedule.nodes.get(taskId);
385
+ if (!node)
386
+ return { ok: false, reason: `task not found in schedule: ${taskId}` };
387
+ if (node.kind !== "task")
388
+ return { ok: false, reason: `cannot release non-task node: ${taskId}` };
389
+ const cur = snapshot.tasks[taskId];
390
+ const state = cur?.state ?? "todo";
391
+ if (state === "todo")
392
+ return { ok: false, reason: `task not started: ${taskId}` };
393
+ if (state === "done")
394
+ return { ok: false, reason: `task already done: ${taskId}` };
395
+ if (state === "cancelled")
396
+ return { ok: false, reason: `task cancelled: ${taskId}` };
397
+ if (state !== "doing" && state !== "blocked") {
398
+ return { ok: false, reason: `task is not doing or blocked: ${taskId}` };
399
+ }
400
+ if (cur?.last_by !== actor && !canOverrideCrossActor(override)) {
401
+ return { ok: false, reason: crossActorReason(cur?.last_by) };
402
+ }
403
+ return { ok: true };
404
+ }
405
+ // cancel permanently terminates a not-yet-started task (todo → cancelled). In-flight tasks
406
+ // (doing/blocked) are returned to todo with `release`, not cancel.
407
+ export function canCancelTask(schedule, snapshot, taskId) {
270
408
  const node = schedule.nodes.get(taskId);
271
409
  if (!node)
272
410
  return { ok: false, reason: `task not found in schedule: ${taskId}` };
273
- if (node.kind !== 'task')
411
+ if (node.kind !== "task")
274
412
  return { ok: false, reason: `cannot cancel non-task node: ${taskId}` };
275
413
  const cur = snapshot.tasks[taskId];
276
- const state = cur?.state ?? 'todo';
277
- if (state === 'done')
414
+ const state = cur?.state ?? "todo";
415
+ if (state === "done")
278
416
  return { ok: false, reason: `task already done: ${taskId}` };
279
- if (state === 'cancelled')
417
+ if (state === "cancelled")
280
418
  return { ok: false, reason: `task already cancelled: ${taskId}` };
281
- if (state === 'doing' && cur?.last_by !== actor) {
419
+ if (state === "doing" || state === "blocked") {
282
420
  return {
283
421
  ok: false,
284
- reason: `task is being worked on by another actor: ${cur?.last_by ?? '(unknown)'}`,
422
+ reason: `task is ${state}; use \`release\` to return it to todo: ${taskId}`,
285
423
  };
286
424
  }
287
425
  return { ok: true };
288
426
  }
289
427
  function schedulerLockDir(projectPath) {
290
- return join(executionRootForProject(projectPath), 'exec', '.locks', 'scheduler.lock');
428
+ return join(executionRootForProject(projectPath), "exec", ".locks", "scheduler.lock");
291
429
  }
292
430
  export function acquireSchedulerLock(projectPath, opts) {
293
431
  const lockDir = schedulerLockDir(projectPath);
294
- const lockParent = resolve(lockDir, '..');
432
+ const lockParent = resolve(lockDir, "..");
295
433
  ensureDir(lockParent);
296
434
  const start = Date.now();
297
435
  while (true) {
298
436
  try {
299
437
  mkdirSync(lockDir);
300
- writeJson(join(lockDir, 'owner.json'), {
438
+ writeJson(join(lockDir, "owner.json"), {
301
439
  actor: opts.actor,
302
440
  pid: process.pid,
303
441
  acquired_at_utc: nowUtcIsoSeconds(),
@@ -305,7 +443,7 @@ export function acquireSchedulerLock(projectPath, opts) {
305
443
  return lockDir;
306
444
  }
307
445
  catch (e) {
308
- if (e?.code !== 'EEXIST')
446
+ if (e?.code !== "EEXIST")
309
447
  throw e;
310
448
  try {
311
449
  const st = statSync(lockDir);
@@ -319,12 +457,12 @@ export function acquireSchedulerLock(projectPath, opts) {
319
457
  continue;
320
458
  }
321
459
  if (Date.now() - start > opts.lockTimeoutMs) {
322
- let ownerInfo = '';
460
+ let ownerInfo = "";
323
461
  try {
324
- ownerInfo = readFileSync(join(lockDir, 'owner.json'), 'utf8');
462
+ ownerInfo = readFileSync(join(lockDir, "owner.json"), "utf8");
325
463
  }
326
464
  catch {
327
- ownerInfo = '(owner metadata unavailable)';
465
+ ownerInfo = "(owner metadata unavailable)";
328
466
  }
329
467
  throw new Error(`Failed to acquire scheduler lock within ${opts.lockTimeoutMs} ms.\n` +
330
468
  `Lock: ${lockDir}\n` +