specdojo 0.1.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (540) hide show
  1. package/LICENSE +22 -0
  2. package/README.md +142 -35
  3. package/dist/agent-response.js +27 -0
  4. package/dist/agent.js +124 -0
  5. package/dist/build-command.js +149 -0
  6. package/dist/build-if-stale.js +35 -0
  7. package/dist/catalog-build.js +1079 -0
  8. package/dist/catalog-generate.js +226 -0
  9. package/dist/catalog-paths.js +31 -0
  10. package/dist/catalog-plan-generate.js +301 -0
  11. package/dist/catalog-plan-prompt.js +73 -0
  12. package/dist/catalog-plan.js +471 -0
  13. package/dist/catalog-scaffold.js +255 -0
  14. package/dist/catalog-types.js +4 -0
  15. package/dist/catalog.js +606 -0
  16. package/dist/dashboard.js +990 -0
  17. package/dist/deliverable-trash.js +148 -0
  18. package/dist/deliverable.js +97 -0
  19. package/dist/dist-freshness.js +150 -0
  20. package/dist/doc-index.js +424 -0
  21. package/dist/exec-agent-config.js +172 -0
  22. package/dist/exec-agent-git-state.js +136 -0
  23. package/dist/exec-agent-protected-config.js +276 -0
  24. package/dist/exec-events.js +250 -112
  25. package/dist/exec-evidence.js +317 -0
  26. package/dist/exec-format.js +54 -0
  27. package/dist/exec-limit.js +202 -0
  28. package/dist/exec-parent-validation.js +169 -0
  29. package/dist/exec-pipeline-state.js +160 -0
  30. package/dist/exec-plans.js +1016 -0
  31. package/dist/exec-project.js +25 -11
  32. package/dist/exec-protection-handoff.js +169 -0
  33. package/dist/exec-provider-scaffold.js +99 -0
  34. package/dist/exec-register-resume.js +196 -0
  35. package/dist/exec-register.js +281 -0
  36. package/dist/exec-reporter.js +329 -0
  37. package/dist/exec-results.js +510 -0
  38. package/dist/exec-run-lock.js +149 -0
  39. package/dist/exec-run.js +4953 -0
  40. package/dist/exec-schedule-calendar.js +86 -9
  41. package/dist/exec-schedule-cpm.js +30 -12
  42. package/dist/exec-schedule-gantt-chart-render.js +428 -0
  43. package/dist/exec-schedule-gantt-chart-scope.js +111 -0
  44. package/dist/exec-schedule-gantt-chart.js +2 -0
  45. package/dist/exec-schedule-hash.js +34 -25
  46. package/dist/exec-schedule-index.js +200 -67
  47. package/dist/exec-schedule-initial.js +100 -0
  48. package/dist/exec-schedule-progress.js +51 -26
  49. package/dist/exec-schedule-ready.js +71 -27
  50. package/dist/exec-schedule.js +171 -93
  51. package/dist/exec-shared.js +146 -25
  52. package/dist/exec-strategy.js +547 -0
  53. package/dist/exec-task-view.js +64 -0
  54. package/dist/exec-trial.js +895 -0
  55. package/dist/exec-worktree-command.js +426 -0
  56. package/dist/exec-worktree-ops.js +847 -0
  57. package/dist/exec-worktree.js +359 -0
  58. package/dist/exec.js +744 -192
  59. package/dist/frontmatter-namespace.js +48 -0
  60. package/dist/git-environment.js +23 -0
  61. package/dist/grade-result.js +137 -0
  62. package/dist/grade.js +2456 -0
  63. package/dist/index-command.js +103 -0
  64. package/dist/job.js +1081 -0
  65. package/dist/kata-command.js +303 -0
  66. package/dist/kata.js +187 -0
  67. package/dist/package-paths.js +33 -0
  68. package/dist/practice-id.js +24 -0
  69. package/dist/register-date.js +122 -0
  70. package/dist/register-events.js +363 -0
  71. package/dist/register-history.js +323 -0
  72. package/dist/register-item.js +455 -0
  73. package/dist/register-migrate-timestamps.js +176 -0
  74. package/dist/register.js +2199 -0
  75. package/dist/review-plan.js +199 -0
  76. package/dist/review-types.js +1 -0
  77. package/dist/role-types.js +1 -0
  78. package/dist/routine.js +814 -0
  79. package/dist/schedule-approach.js +252 -0
  80. package/dist/schedule-build.js +552 -0
  81. package/dist/schedule-phase-sets.js +73 -0
  82. package/dist/schedule-strategy-generate.js +812 -0
  83. package/dist/schedule-strategy-profiles.js +276 -0
  84. package/dist/schedule.js +420 -0
  85. package/dist/spawn-self.js +28 -0
  86. package/dist/specdojo-config.js +133 -39
  87. package/dist/specdojo.js +56 -7
  88. package/dist/template-frontmatter.js +89 -0
  89. package/dist/template-resolution.js +92 -0
  90. package/dist/timeline-build.js +334 -0
  91. package/dist/timeline.js +107 -0
  92. package/dist/watch.js +313 -0
  93. package/dist/yaml-pages-command.js +28 -0
  94. package/dist/yaml-pages.js +180 -0
  95. package/dist/yaml-schema-modeline.js +49 -0
  96. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +600 -0
  97. package/docs/ja/specdojo/exec-templates/xep-bootstrap-template.md +120 -0
  98. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +37 -0
  99. package/docs/ja/specdojo/exec-templates/xep-cross-deliverable-dedup-template.md +51 -0
  100. package/docs/ja/specdojo/exec-templates/xep-freeform-template.md +74 -0
  101. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +109 -0
  102. package/docs/ja/specdojo/exec-templates/xep-job-template.md +43 -0
  103. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +82 -0
  104. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +86 -0
  105. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +42 -0
  106. package/docs/ja/specdojo/exec-templates/xep-register-template.md +49 -0
  107. package/docs/ja/specdojo/exec-templates/xep-retrofit-template.md +98 -0
  108. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +86 -0
  109. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +86 -0
  110. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +86 -0
  111. package/docs/ja/specdojo/exec-templates/xep-template.md +66 -0
  112. package/docs/ja/specdojo/exec-templates/xer-cross-deliverable-dedup-template.md +31 -0
  113. package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +40 -0
  114. package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +30 -0
  115. package/docs/ja/specdojo/exec-templates/xer-template.md +19 -0
  116. package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +70 -0
  117. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +97 -0
  118. package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +76 -0
  119. package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +73 -0
  120. package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +74 -0
  121. package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +74 -0
  122. package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +73 -0
  123. package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +73 -0
  124. package/docs/ja/specdojo/exec-templates/xrp-template.md +67 -0
  125. package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +7 -0
  126. package/docs/ja/specdojo/exec-templates/xrr-template.md +21 -0
  127. package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +7 -0
  128. package/docs/ja/specdojo/guides/branch-workflow-guide.md +354 -0
  129. package/docs/ja/specdojo/guides/docs-editing-guide.md +327 -0
  130. package/docs/ja/specdojo/guides/docs-structure-guide.md +519 -0
  131. package/docs/ja/specdojo/guides/exec-config-guide.md +589 -0
  132. package/docs/ja/specdojo/guides/exec-operation-guide.md +440 -0
  133. package/docs/ja/specdojo/guides/exec-worktree-guide.md +318 -0
  134. package/docs/ja/specdojo/guides/kata-guide.md +89 -0
  135. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +127 -0
  136. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +228 -0
  137. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +111 -0
  138. package/docs/ja/specdojo/guides/quick-start-guide.md +472 -0
  139. package/docs/ja/specdojo/guides/register-operation-guide.md +418 -0
  140. package/docs/ja/specdojo/guides/remote-host-development-guide.md +163 -0
  141. package/docs/ja/specdojo/guides/review-guide.md +428 -0
  142. package/docs/ja/specdojo/guides/routine-operation-guide.md +282 -0
  143. package/docs/ja/specdojo/guides/ryu-guide.md +230 -0
  144. package/docs/ja/specdojo/guides/schedule-design-guide.md +429 -0
  145. package/docs/ja/specdojo/guides/schedule-operation-guide.md +151 -0
  146. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +257 -0
  147. package/docs/ja/specdojo/guides/timeline-design-guide.md +160 -0
  148. package/docs/ja/specdojo/guides/track-design-guide.md +215 -0
  149. package/docs/ja/specdojo/guides/use-case-guide.md +133 -0
  150. package/docs/ja/specdojo/guides/waza-guide.md +224 -0
  151. package/docs/ja/specdojo/index.md +33 -0
  152. package/docs/ja/specdojo/philosophy/needs-to-implementation-philosophy.md +212 -0
  153. package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +242 -0
  154. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +198 -0
  155. package/docs/ja/specdojo/recipes/cdfd-recipe.md +218 -0
  156. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +198 -0
  157. package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +100 -0
  158. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +148 -0
  159. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +97 -0
  160. package/docs/ja/specdojo/recipes/pm-members-recipe.md +149 -0
  161. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +96 -0
  162. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +98 -0
  163. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +97 -0
  164. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +96 -0
  165. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +136 -0
  166. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +162 -0
  167. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +187 -0
  168. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +235 -0
  169. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +205 -0
  170. package/docs/ja/specdojo/recipes/prj-overview-recipe.md +289 -0
  171. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +201 -0
  172. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +168 -0
  173. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +179 -0
  174. package/docs/ja/specdojo/recipes/stsd-recipe.md +138 -0
  175. package/docs/ja/specdojo/references/command-reference.md +718 -0
  176. package/docs/ja/specdojo/references/deliverables-reference.md +407 -0
  177. package/docs/ja/specdojo/references/directory-layout-reference.md +280 -0
  178. package/docs/ja/specdojo/references/specdojo-config-reference.md +133 -0
  179. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +372 -0
  180. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +302 -0
  181. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +331 -0
  182. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +134 -0
  183. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +207 -0
  184. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +102 -0
  185. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +131 -0
  186. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +269 -0
  187. package/docs/ja/specdojo/rulebooks/br-rulebook.md +187 -0
  188. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +279 -0
  189. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +219 -0
  190. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +233 -0
  191. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +182 -0
  192. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +171 -0
  193. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +105 -0
  194. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +195 -0
  195. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +285 -0
  196. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +292 -0
  197. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +171 -0
  198. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +325 -0
  199. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +266 -0
  200. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +294 -0
  201. package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +21 -0
  202. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +401 -0
  203. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +311 -0
  204. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +158 -0
  205. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +287 -0
  206. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +62 -0
  207. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +100 -0
  208. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +298 -0
  209. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +379 -0
  210. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +310 -0
  211. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +86 -0
  212. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +297 -0
  213. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +79 -0
  214. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +213 -0
  215. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +311 -0
  216. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +94 -0
  217. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +81 -0
  218. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +117 -0
  219. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +118 -0
  220. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +116 -0
  221. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +116 -0
  222. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +116 -0
  223. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +421 -0
  224. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +307 -0
  225. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +312 -0
  226. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +63 -0
  227. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +353 -0
  228. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +184 -0
  229. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +179 -0
  230. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +184 -0
  231. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +183 -0
  232. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +185 -0
  233. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +185 -0
  234. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +186 -0
  235. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +186 -0
  236. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +184 -0
  237. package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +61 -0
  238. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +84 -0
  239. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +357 -0
  240. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +80 -0
  241. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +484 -0
  242. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +120 -0
  243. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +293 -0
  244. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +211 -0
  245. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +94 -0
  246. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +116 -0
  247. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +93 -0
  248. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +190 -0
  249. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +108 -0
  250. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +122 -0
  251. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +117 -0
  252. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +116 -0
  253. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +93 -0
  254. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +146 -0
  255. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +65 -0
  256. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +178 -0
  257. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +232 -0
  258. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +235 -0
  259. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +242 -0
  260. package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +187 -0
  261. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +201 -0
  262. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +165 -0
  263. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +165 -0
  264. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +202 -0
  265. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +139 -0
  266. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +63 -0
  267. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +93 -0
  268. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +93 -0
  269. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +329 -0
  270. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +297 -0
  271. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +132 -0
  272. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +215 -0
  273. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +376 -0
  274. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +313 -0
  275. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +246 -0
  276. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +119 -0
  277. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +188 -0
  278. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +114 -0
  279. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +117 -0
  280. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +101 -0
  281. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +103 -0
  282. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +396 -0
  283. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +207 -0
  284. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +387 -0
  285. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +303 -0
  286. package/docs/ja/specdojo/samples/atc-index-sample.md +38 -0
  287. package/docs/ja/specdojo/samples/atc-sample.md +41 -0
  288. package/docs/ja/specdojo/samples/bac-sample.md +38 -0
  289. package/docs/ja/specdojo/samples/bdd-sample.yaml +71 -0
  290. package/docs/ja/specdojo/samples/bds-sample.md +38 -0
  291. package/docs/ja/specdojo/samples/bes-index-sample.md +38 -0
  292. package/docs/ja/specdojo/samples/bes-sample.md +38 -0
  293. package/docs/ja/specdojo/samples/bps-sample.md +38 -0
  294. package/docs/ja/specdojo/samples/br-sample.md +40 -0
  295. package/docs/ja/specdojo/samples/ccd-sample.md +38 -0
  296. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +284 -0
  297. package/docs/ja/specdojo/samples/cdfd-sample.md +229 -0
  298. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +146 -0
  299. package/docs/ja/specdojo/samples/cdsd-sample.md +38 -0
  300. package/docs/ja/specdojo/samples/cld-sample.md +38 -0
  301. package/docs/ja/specdojo/samples/cnd-sample.md +38 -0
  302. package/docs/ja/specdojo/samples/cop-index-sample.md +38 -0
  303. package/docs/ja/specdojo/samples/cop-sample.md +38 -0
  304. package/docs/ja/specdojo/samples/cpd-sample.md +38 -0
  305. package/docs/ja/specdojo/samples/cstd-sample.md +11 -0
  306. package/docs/ja/specdojo/samples/cxd-sample.md +38 -0
  307. package/docs/ja/specdojo/samples/dct-index-sample.yaml +39 -0
  308. package/docs/ja/specdojo/samples/dct-sample.yaml +91 -0
  309. package/docs/ja/specdojo/samples/dec-sample.md +39 -0
  310. package/docs/ja/specdojo/samples/dmd-index-sample.md +50 -0
  311. package/docs/ja/specdojo/samples/dmd-sample.md +74 -0
  312. package/docs/ja/specdojo/samples/etc-index-sample.md +38 -0
  313. package/docs/ja/specdojo/samples/etc-sample.md +38 -0
  314. package/docs/ja/specdojo/samples/gl-sample.yaml +37 -0
  315. package/docs/ja/specdojo/samples/ifd-sample.md +38 -0
  316. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +102 -0
  317. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +107 -0
  318. package/docs/ja/specdojo/samples/ifx-file-sample.md +38 -0
  319. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +89 -0
  320. package/docs/ja/specdojo/samples/imp-business-sample.md +66 -0
  321. package/docs/ja/specdojo/samples/imp-data-sample.md +60 -0
  322. package/docs/ja/specdojo/samples/imp-interface-sample.md +60 -0
  323. package/docs/ja/specdojo/samples/imp-operations-sample.md +60 -0
  324. package/docs/ja/specdojo/samples/imp-test-sample.md +60 -0
  325. package/docs/ja/specdojo/samples/itc-index-sample.md +38 -0
  326. package/docs/ja/specdojo/samples/itc-sample.md +38 -0
  327. package/docs/ja/specdojo/samples/mip-index-sample.md +38 -0
  328. package/docs/ja/specdojo/samples/mm-sample.md +35 -0
  329. package/docs/ja/specdojo/samples/mtp-sample.md +38 -0
  330. package/docs/ja/specdojo/samples/nfr-availability-sample.md +38 -0
  331. package/docs/ja/specdojo/samples/nfr-index-sample.md +38 -0
  332. package/docs/ja/specdojo/samples/nfr-integrity-sample.md +38 -0
  333. package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +38 -0
  334. package/docs/ja/specdojo/samples/nfr-operations-sample.md +38 -0
  335. package/docs/ja/specdojo/samples/nfr-performance-sample.md +38 -0
  336. package/docs/ja/specdojo/samples/nfr-reliability-sample.md +38 -0
  337. package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +38 -0
  338. package/docs/ja/specdojo/samples/nfr-usability-sample.md +38 -0
  339. package/docs/ja/specdojo/samples/ntp-sample.md +38 -0
  340. package/docs/ja/specdojo/samples/opd-access-control-sample.md +29 -0
  341. package/docs/ja/specdojo/samples/opd-incident-management-sample.md +31 -0
  342. package/docs/ja/specdojo/samples/opd-index-sample.md +41 -0
  343. package/docs/ja/specdojo/samples/opd-monitoring-sample.md +32 -0
  344. package/docs/ja/specdojo/samples/opd-sample.md +38 -0
  345. package/docs/ja/specdojo/samples/opr-access-control-sample.md +24 -0
  346. package/docs/ja/specdojo/samples/opr-backup-restore-sample.md +27 -0
  347. package/docs/ja/specdojo/samples/opr-batch-sample.md +23 -0
  348. package/docs/ja/specdojo/samples/opr-change-sample.md +24 -0
  349. package/docs/ja/specdojo/samples/opr-incident-sample.md +38 -0
  350. package/docs/ja/specdojo/samples/opr-index-sample.md +43 -0
  351. package/docs/ja/specdojo/samples/opr-monitoring-sample.md +27 -0
  352. package/docs/ja/specdojo/samples/opr-sample.md +38 -0
  353. package/docs/ja/specdojo/samples/opr-support-sample.md +23 -0
  354. package/docs/ja/specdojo/samples/otp-index-sample.md +66 -0
  355. package/docs/ja/specdojo/samples/otp-sample.md +68 -0
  356. package/docs/ja/specdojo/samples/pm-change-request-log-sample.md +47 -0
  357. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +46 -0
  358. package/docs/ja/specdojo/samples/pm-issue-log-sample.md +45 -0
  359. package/docs/ja/specdojo/samples/pm-members-sample.yaml +103 -0
  360. package/docs/ja/specdojo/samples/pm-organization-sample.md +46 -0
  361. package/docs/ja/specdojo/samples/pm-plan-sample.md +57 -0
  362. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +52 -0
  363. package/docs/ja/specdojo/samples/pm-raci-sample.md +57 -0
  364. package/docs/ja/specdojo/samples/pm-risk-register-sample.md +43 -0
  365. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +41 -0
  366. package/docs/ja/specdojo/samples/pr-sample.md +39 -0
  367. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +57 -0
  368. package/docs/ja/specdojo/samples/prj-charter-sample.md +121 -0
  369. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +105 -0
  370. package/docs/ja/specdojo/samples/prj-issues-and-approach-sample.md +78 -0
  371. package/docs/ja/specdojo/samples/prj-overview-sample.md +95 -0
  372. package/docs/ja/specdojo/samples/prj-scope-sample.md +71 -0
  373. package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +60 -0
  374. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +62 -0
  375. package/docs/ja/specdojo/samples/sac-sample.md +38 -0
  376. package/docs/ja/specdojo/samples/sf-index-sample.md +38 -0
  377. package/docs/ja/specdojo/samples/sf-sample.md +38 -0
  378. package/docs/ja/specdojo/samples/sld-sample.md +38 -0
  379. package/docs/ja/specdojo/samples/stc-index-sample.md +38 -0
  380. package/docs/ja/specdojo/samples/stc-sample.md +38 -0
  381. package/docs/ja/specdojo/samples/stsd-sample.md +58 -0
  382. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +38 -0
  383. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +38 -0
  384. package/docs/ja/specdojo/samples/sysd-index-sample.md +38 -0
  385. package/docs/ja/specdojo/samples/trc-requirements-to-specs-sample.md +56 -0
  386. package/docs/ja/specdojo/samples/trc-requirements-to-tests-sample.md +56 -0
  387. package/docs/ja/specdojo/samples/tsd-index-sample.md +29 -0
  388. package/docs/ja/specdojo/samples/tsd-sample.md +38 -0
  389. package/docs/ja/specdojo/samples/tsp-index-sample.md +38 -0
  390. package/docs/ja/specdojo/samples/uis-sample.md +38 -0
  391. package/docs/ja/specdojo/samples/utc-index-sample.md +38 -0
  392. package/docs/ja/specdojo/samples/utc-sample.md +38 -0
  393. package/docs/ja/specdojo/schemas/v1/guide-content.schema.yaml +20 -0
  394. package/docs/ja/specdojo/schemas/v1/philosophy-content.schema.yaml +21 -0
  395. package/docs/ja/specdojo/schemas/v1/reference-content.schema.yaml +21 -0
  396. package/docs/ja/specdojo/standards/document-metadata-standard.md +323 -0
  397. package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +75 -0
  398. package/docs/ja/specdojo/standards/git-branching-standard.md +227 -0
  399. package/docs/ja/specdojo/standards/guide-authoring-standard.md +124 -0
  400. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +929 -0
  401. package/docs/ja/specdojo/standards/job-definition-standard.md +148 -0
  402. package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +431 -0
  403. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +113 -0
  404. package/docs/ja/specdojo/standards/recipe-authoring-standard.md +143 -0
  405. package/docs/ja/specdojo/standards/reference-authoring-standard.md +99 -0
  406. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +140 -0
  407. package/docs/ja/specdojo/standards/sample-authoring-standard.md +151 -0
  408. package/docs/ja/specdojo/standards/standard-authoring-standard.md +108 -0
  409. package/docs/ja/specdojo/standards/template-authoring-standard.md +101 -0
  410. package/docs/ja/specdojo/standards/test-document-scope-standard.md +176 -0
  411. package/docs/ja/specdojo/templates/cdfd-overview-template.md +199 -0
  412. package/docs/ja/specdojo/templates/cdfd-template.md +173 -0
  413. package/docs/ja/specdojo/templates/cdfd-uc-template.md +148 -0
  414. package/docs/ja/specdojo/templates/dct-architecture-template.yaml +136 -0
  415. package/docs/ja/specdojo/templates/dct-business-acceptance-criteria-template.yaml +34 -0
  416. package/docs/ja/specdojo/templates/dct-business-model-bes-template.yaml +75 -0
  417. package/docs/ja/specdojo/templates/dct-business-model-bps-template.yaml +49 -0
  418. package/docs/ja/specdojo/templates/dct-business-model-br-template.yaml +50 -0
  419. package/docs/ja/specdojo/templates/dct-data-flow-template.yaml +40 -0
  420. package/docs/ja/specdojo/templates/dct-data-model-bdd-template.yaml +46 -0
  421. package/docs/ja/specdojo/templates/dct-data-model-ccd-template.yaml +46 -0
  422. package/docs/ja/specdojo/templates/dct-data-model-cdsd-template.yaml +41 -0
  423. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +38 -0
  424. package/docs/ja/specdojo/templates/dct-data-model-sld-template.yaml +38 -0
  425. package/docs/ja/specdojo/templates/dct-data-model-stsd-template.yaml +46 -0
  426. package/docs/ja/specdojo/templates/dct-external-interface-specs-template.yaml +114 -0
  427. package/docs/ja/specdojo/templates/dct-glossary-template.yaml +35 -0
  428. package/docs/ja/specdojo/templates/dct-impact-analysis-template.yaml +138 -0
  429. package/docs/ja/specdojo/templates/dct-index-template.md +40 -0
  430. package/docs/ja/specdojo/templates/dct-migration-planning-template.yaml +148 -0
  431. package/docs/ja/specdojo/templates/dct-non-functional-requirements-template.yaml +222 -0
  432. package/docs/ja/specdojo/templates/dct-operations-template.yaml +108 -0
  433. package/docs/ja/specdojo/templates/dct-project-definition-template.yaml +210 -0
  434. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +423 -0
  435. package/docs/ja/specdojo/templates/dct-system-acceptance-criteria-template.yaml +37 -0
  436. package/docs/ja/specdojo/templates/dct-system-design-template.yaml +82 -0
  437. package/docs/ja/specdojo/templates/dct-system-functions-template.yaml +58 -0
  438. package/docs/ja/specdojo/templates/dct-test-specs-template.yaml +261 -0
  439. package/docs/ja/specdojo/templates/dct-user-interface-model-template.yaml +60 -0
  440. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +88 -0
  441. package/docs/ja/specdojo/templates/opr-template.md +85 -0
  442. package/docs/ja/specdojo/templates/pjr-change-request-template.md +60 -0
  443. package/docs/ja/specdojo/templates/pjr-decision-template.md +61 -0
  444. package/docs/ja/specdojo/templates/pjr-index-template.md +49 -0
  445. package/docs/ja/specdojo/templates/pjr-issue-template.md +50 -0
  446. package/docs/ja/specdojo/templates/pjr-note-template.md +35 -0
  447. package/docs/ja/specdojo/templates/pjr-question-template.md +53 -0
  448. package/docs/ja/specdojo/templates/pjr-risk-template.md +49 -0
  449. package/docs/ja/specdojo/templates/pjr-todo-template.md +41 -0
  450. package/docs/ja/specdojo/templates/pjr-views-by-owner-template.md +22 -0
  451. package/docs/ja/specdojo/templates/pjr-views-by-priority-template.md +22 -0
  452. package/docs/ja/specdojo/templates/pjr-views-by-status-template.md +22 -0
  453. package/docs/ja/specdojo/templates/pm-change-request-log-template.md +20 -0
  454. package/docs/ja/specdojo/templates/pm-communication-plan-template.md +46 -0
  455. package/docs/ja/specdojo/templates/pm-decision-log-template.md +20 -0
  456. package/docs/ja/specdojo/templates/pm-issue-log-template.md +20 -0
  457. package/docs/ja/specdojo/templates/pm-members-template.yaml +105 -0
  458. package/docs/ja/specdojo/templates/pm-organization-template.md +44 -0
  459. package/docs/ja/specdojo/templates/pm-plan-template.md +52 -0
  460. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +46 -0
  461. package/docs/ja/specdojo/templates/pm-raci-template.md +51 -0
  462. package/docs/ja/specdojo/templates/pm-risk-register-template.md +20 -0
  463. package/docs/ja/specdojo/templates/pm-roles-template.yaml +53 -0
  464. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +59 -0
  465. package/docs/ja/specdojo/templates/prj-charter-template.md +116 -0
  466. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +116 -0
  467. package/docs/ja/specdojo/templates/prj-issues-and-approach-template.md +89 -0
  468. package/docs/ja/specdojo/templates/prj-overview-template.md +85 -0
  469. package/docs/ja/specdojo/templates/prj-scope-template.md +75 -0
  470. package/docs/ja/specdojo/templates/prj-stakeholder-register-template.md +64 -0
  471. package/docs/ja/specdojo/templates/prj-success-criteria-and-acceptance-criteria-template.md +60 -0
  472. package/docs/ja/specdojo/templates/stsd-template.md +57 -0
  473. package/docs/specdojo/schemas/v1/bdd.schema.yaml +230 -0
  474. package/docs/specdojo/schemas/v1/common-frontmatter.schema.yaml +77 -0
  475. package/docs/specdojo/schemas/v1/dct-index.schema.yaml +85 -0
  476. package/docs/specdojo/schemas/v1/dct-plan.schema.yaml +324 -0
  477. package/docs/specdojo/schemas/v1/dct.schema.yaml +368 -0
  478. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +91 -0
  479. package/docs/specdojo/schemas/v1/esil.schema.yaml +142 -0
  480. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +101 -0
  481. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +272 -0
  482. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +162 -0
  483. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +126 -0
  484. package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +151 -0
  485. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +144 -0
  486. package/docs/specdojo/schemas/v1/grade-done-criteria.schema.yaml +79 -0
  487. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +60 -0
  488. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +118 -0
  489. package/docs/specdojo/schemas/v1/guide-frontmatter.schema.yaml +19 -0
  490. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +293 -0
  491. package/docs/specdojo/schemas/v1/job-run.schema.yaml +90 -0
  492. package/docs/specdojo/schemas/v1/job.schema.yaml +198 -0
  493. package/docs/specdojo/schemas/v1/philosophy-frontmatter.schema.yaml +19 -0
  494. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +56 -0
  495. package/docs/specdojo/schemas/v1/pm-members.schema.yaml +252 -0
  496. package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +387 -0
  497. package/docs/specdojo/schemas/v1/pm-roles.schema.yaml +106 -0
  498. package/docs/specdojo/schemas/v1/recipe-frontmatter.schema.yaml +27 -0
  499. package/docs/specdojo/schemas/v1/reference-frontmatter.schema.yaml +18 -0
  500. package/docs/specdojo/schemas/v1/register-events.schema.yaml +106 -0
  501. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +204 -0
  502. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +36 -0
  503. package/docs/specdojo/schemas/v1/routine.schema.yaml +87 -0
  504. package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +61 -0
  505. package/docs/specdojo/schemas/v1/sch-common.schema.yaml +258 -0
  506. package/docs/specdojo/schemas/v1/sch-defaults.schema.yaml +48 -0
  507. package/docs/specdojo/schemas/v1/sch-milestones.schema.yaml +64 -0
  508. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +772 -0
  509. package/docs/specdojo/schemas/v1/sch-track.schema.yaml +66 -0
  510. package/docs/specdojo/schemas/v1/standard-frontmatter.schema.yaml +18 -0
  511. package/docs/specdojo/schemas/v1/tml-index.schema.yaml +103 -0
  512. package/package.json +121 -24
  513. package/templates/antigravity/README.md +35 -0
  514. package/templates/antigravity/exec-defaults-snippet.yaml +38 -0
  515. package/templates/antigravity/orchestrator.md +146 -0
  516. package/templates/antigravity/pm-members-snippet.yaml +55 -0
  517. package/templates/claude/README.md +46 -0
  518. package/templates/claude/agents/claude-expert-review-executor.md +14 -0
  519. package/templates/claude/agents/claude-review-executor.md +14 -0
  520. package/templates/claude/agents/specdojo-orchestrator.md +153 -0
  521. package/templates/claude/settings.edit.json +6 -0
  522. package/templates/claude/settings.report.json +6 -0
  523. package/templates/claude/settings.review.json +7 -0
  524. package/templates/codex/README.md +61 -0
  525. package/templates/codex/agents/codex-executor.toml +12 -0
  526. package/templates/codex/agents/codex-expert-executor.toml +12 -0
  527. package/templates/codex/agents/codex-expert-review-executor.toml +10 -0
  528. package/templates/codex/agents/codex-review-executor.toml +10 -0
  529. package/templates/codex/agents/specdojo-orchestrator.toml +154 -0
  530. package/templates/codex/orchestrator.md +146 -0
  531. package/templates/copilot/README.md +41 -0
  532. package/templates/copilot/exec-defaults-snippet.yaml +28 -0
  533. package/templates/copilot/pm-members-snippet.yaml +44 -0
  534. package/templates/opencode/README.md +41 -0
  535. package/templates/opencode/agents/opencode-executor.md +59 -0
  536. package/templates/opencode/agents/opencode-reporter.md +26 -0
  537. package/templates/opencode/agents/opencode-review-executor.md +48 -0
  538. package/templates/opencode/agents/specdojo-orchestrator.md +193 -0
  539. package/dist/exec-schedule-timeline-render.js +0 -201
  540. package/dist/exec-schedule-timeline.js +0 -2
@@ -0,0 +1,814 @@
1
+ import { spawnSync } from "node:child_process";
2
+ import { appendFileSync, existsSync, mkdirSync, readdirSync, rmSync, statSync } from "node:fs";
3
+ import { basename, join, resolve } from "node:path";
4
+ import { fileURLToPath } from "node:url";
5
+ import { ensureFreshDistBuildForEntry } from "./dist-freshness.js";
6
+ import { selfRunArgs } from "./spawn-self.js";
7
+ import { getProjectRoutinesPath, loadConfig, loadEnv, specdojoRootDir } from "./specdojo-config.js";
8
+ import { ensureDir, listFilesRecursive, nowUtcIsoSeconds, padEndDisplay, readJson, readYaml, writeJson, } from "./exec-shared.js";
9
+ import { ROUTINE_BUSY_SKIP_EXIT_CODE, ROUTINE_EXEC_ENV } from "./exec-run-lock.js";
10
+ import { resolveJobPaths } from "./job.js";
11
+ export function routineActionKindLabel(action) {
12
+ const actions = Array.isArray(action) ? action : [action];
13
+ return actions.length > 0 ? actions.map((item) => item.kind).join(" -> ") : "-";
14
+ }
15
+ // ================================
16
+ // Interval / due
17
+ // ================================
18
+ const INTERVAL_UNIT_MS = {
19
+ m: 60_000,
20
+ h: 3_600_000,
21
+ d: 86_400_000,
22
+ w: 604_800_000,
23
+ };
24
+ // interval は `<正の整数><単位>` 形式(m: 分, h: 時間, d: 日, w: 週)。
25
+ export function parseIntervalMs(text) {
26
+ const match = text.trim().match(/^([1-9]\d*)(m|h|d|w)$/);
27
+ if (!match) {
28
+ throw new Error(`Invalid interval: "${text}". Use <positive integer><unit> with unit m|h|d|w (e.g. 30m, 6h, 1d, 1w)`);
29
+ }
30
+ return Number.parseInt(match[1], 10) * INTERVAL_UNIT_MS[match[2]];
31
+ }
32
+ // last_run が無い(未実行)または不正な場合は due とみなす。
33
+ export function isRoutineDue(doc, lastRun, now) {
34
+ if (!doc.interval)
35
+ return cronOccurrences(doc, lastRun, now).length > 0;
36
+ if (!lastRun)
37
+ return true;
38
+ const last = new Date(lastRun);
39
+ if (Number.isNaN(last.getTime()))
40
+ return true;
41
+ return now.getTime() - last.getTime() >= parseIntervalMs(doc.interval);
42
+ }
43
+ function parseCronField(text, min, max, label) {
44
+ const result = new Set();
45
+ for (const token of text.split(",")) {
46
+ const [base, stepText] = token.split("/");
47
+ const step = stepText === undefined ? 1 : Number(stepText);
48
+ if (!Number.isSafeInteger(step) || step < 1)
49
+ throw new Error(`Invalid cron ${label}: ${text}`);
50
+ let start;
51
+ let end;
52
+ if (base === "*") {
53
+ start = min;
54
+ end = max;
55
+ }
56
+ else if (base.includes("-")) {
57
+ const parts = base.split("-").map(Number);
58
+ if (parts.length !== 2)
59
+ throw new Error(`Invalid cron ${label}: ${text}`);
60
+ [start, end] = parts;
61
+ }
62
+ else {
63
+ start = Number(base);
64
+ end = start;
65
+ }
66
+ if (!Number.isSafeInteger(start) ||
67
+ !Number.isSafeInteger(end) ||
68
+ start < min ||
69
+ end > max ||
70
+ start > end) {
71
+ throw new Error(`Invalid cron ${label}: ${text}`);
72
+ }
73
+ for (let value = start; value <= end; value += step)
74
+ result.add(value);
75
+ }
76
+ return result;
77
+ }
78
+ export function parseCronExpression(expression) {
79
+ const fields = expression.trim().split(/\s+/);
80
+ if (fields.length !== 5)
81
+ throw new Error(`Invalid cron expression: "${expression}" (expected 5 fields)`);
82
+ return [
83
+ parseCronField(fields[0], 0, 59, "minute"),
84
+ parseCronField(fields[1], 0, 23, "hour"),
85
+ parseCronField(fields[2], 1, 31, "day-of-month"),
86
+ parseCronField(fields[3], 1, 12, "month"),
87
+ parseCronField(fields[4], 0, 6, "day-of-week"),
88
+ ];
89
+ }
90
+ function zonedParts(date, timezone) {
91
+ const parts = new Intl.DateTimeFormat("en-US", {
92
+ timeZone: timezone,
93
+ minute: "numeric",
94
+ hour: "numeric",
95
+ day: "numeric",
96
+ month: "numeric",
97
+ weekday: "short",
98
+ hourCycle: "h23",
99
+ }).formatToParts(date);
100
+ const value = (type) => parts.find((part) => part.type === type)?.value ?? "";
101
+ const weekday = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"].indexOf(value("weekday"));
102
+ return [
103
+ Number(value("minute")),
104
+ Number(value("hour")),
105
+ Number(value("day")),
106
+ Number(value("month")),
107
+ weekday,
108
+ ];
109
+ }
110
+ export function cronMatches(expression, timezone, date) {
111
+ const fields = parseCronExpression(expression);
112
+ const parts = zonedParts(date, timezone);
113
+ return fields.every((field, index) => field.has(parts[index]));
114
+ }
115
+ const MAX_CRON_LOOKBACK_MINUTES = 366 * 24 * 60;
116
+ export function cronOccurrences(doc, lastScheduledFor, now) {
117
+ if (!doc.trigger)
118
+ return [];
119
+ const nowMinute = new Date(Math.floor(now.getTime() / 60_000) * 60_000);
120
+ const parsedLast = lastScheduledFor ? new Date(lastScheduledFor) : null;
121
+ if (parsedLast && Number.isNaN(parsedLast.getTime()))
122
+ return cronOccurrences(doc, undefined, now);
123
+ if (doc.policy?.missed_run === "skip") {
124
+ const lastMinute = parsedLast
125
+ ? Math.floor(parsedLast.getTime() / 60_000) * 60_000
126
+ : Number.NEGATIVE_INFINITY;
127
+ return nowMinute.getTime() > lastMinute &&
128
+ cronMatches(doc.trigger.cron, doc.trigger.timezone, nowMinute)
129
+ ? [nowMinute]
130
+ : [];
131
+ }
132
+ if (!parsedLast) {
133
+ for (let offset = 0; offset <= MAX_CRON_LOOKBACK_MINUTES; offset++) {
134
+ const candidate = new Date(nowMinute.getTime() - offset * 60_000);
135
+ if (cronMatches(doc.trigger.cron, doc.trigger.timezone, candidate))
136
+ return [candidate];
137
+ }
138
+ return [];
139
+ }
140
+ const occurrences = [];
141
+ let cursor = Math.floor(parsedLast.getTime() / 60_000) * 60_000 + 60_000;
142
+ const maxStart = nowMinute.getTime() - MAX_CRON_LOOKBACK_MINUTES * 60_000;
143
+ if (cursor < maxStart)
144
+ cursor = maxStart;
145
+ for (; cursor <= nowMinute.getTime(); cursor += 60_000) {
146
+ const candidate = new Date(cursor);
147
+ if (cronMatches(doc.trigger.cron, doc.trigger.timezone, candidate))
148
+ occurrences.push(candidate);
149
+ if (occurrences.length > 1000)
150
+ throw new Error(`Too many missed cron occurrences for ${doc.id}`);
151
+ }
152
+ return doc.policy?.missed_run === "all" ? occurrences : occurrences.slice(-1);
153
+ }
154
+ export function isoWeek(date, timezone) {
155
+ const local = new Intl.DateTimeFormat("en-CA", {
156
+ timeZone: timezone,
157
+ year: "numeric",
158
+ month: "2-digit",
159
+ day: "2-digit",
160
+ }).format(date);
161
+ const [year, month, day] = local.split("-").map(Number);
162
+ const value = new Date(Date.UTC(year, month - 1, day));
163
+ const weekday = value.getUTCDay() || 7;
164
+ value.setUTCDate(value.getUTCDate() + 4 - weekday);
165
+ const weekYear = value.getUTCFullYear();
166
+ const first = new Date(Date.UTC(weekYear, 0, 1));
167
+ const week = Math.ceil(((value.getTime() - first.getTime()) / 86_400_000 + 1) / 7);
168
+ return `${weekYear}-W${String(week).padStart(2, "0")}`;
169
+ }
170
+ // ================================
171
+ // Validation
172
+ // ================================
173
+ function isRecord(value) {
174
+ return typeof value === "object" && value !== null && !Array.isArray(value);
175
+ }
176
+ function parseRoutineAction(value, fieldName, errors) {
177
+ if (!isRecord(value)) {
178
+ errors.push(`${fieldName} must be a mapping with kind`);
179
+ return undefined;
180
+ }
181
+ const kind = typeof value.kind === "string" ? value.kind : "";
182
+ if (kind === "specdojo") {
183
+ const unknownKeys = Object.keys(value).filter((key) => key !== "kind" && key !== "args");
184
+ if (unknownKeys.length > 0) {
185
+ errors.push(`${fieldName} has unknown key(s): ${unknownKeys.sort().join(", ")}`);
186
+ }
187
+ const args = value.args;
188
+ if (!Array.isArray(args) ||
189
+ args.length === 0 ||
190
+ args.some((item) => typeof item !== "string" || item.length === 0)) {
191
+ errors.push(`${fieldName}.args must be a non-empty list of strings`);
192
+ return undefined;
193
+ }
194
+ if (args.includes("exec") || args.includes("--project")) {
195
+ errors.push(`${fieldName}.args must not include exec or --project (project is appended)`);
196
+ return undefined;
197
+ }
198
+ return { kind: "specdojo", args: args };
199
+ }
200
+ const unknownKeys = Object.keys(value).filter((key) => key !== "kind" && key !== "job" && key !== "inputs");
201
+ if (unknownKeys.length > 0) {
202
+ errors.push(`${fieldName} has unknown key(s): ${unknownKeys.sort().join(", ")}`);
203
+ }
204
+ if (kind !== "job") {
205
+ errors.push(`${fieldName}.kind must be job or specdojo (got "${kind}")`);
206
+ }
207
+ if (typeof value.job !== "string" || !/^job-[a-z0-9][a-z0-9-]*$/.test(value.job)) {
208
+ errors.push(`${fieldName}.job must match job-<slug>`);
209
+ }
210
+ if (value.inputs !== undefined &&
211
+ (!isRecord(value.inputs) ||
212
+ Object.values(value.inputs).some((item) => typeof item !== "string"))) {
213
+ errors.push(`${fieldName}.inputs must be a mapping of string values`);
214
+ }
215
+ return {
216
+ kind: "job",
217
+ job: typeof value.job === "string" ? value.job : "",
218
+ ...(isRecord(value.inputs) ? { inputs: value.inputs } : {}),
219
+ };
220
+ }
221
+ // rtn-*.yaml 1 ファイルぶんを検証し、妥当なら RoutineDoc として返す。
222
+ // id はファイル名(拡張子なし)と一致させ、doc-index と同じ「ファイル名 = id」規約に揃える。
223
+ export function parseRoutineDoc(value, fileName) {
224
+ const errors = [];
225
+ if (!isRecord(value)) {
226
+ return { errors: [`${fileName}: routine file must be a YAML mapping`] };
227
+ }
228
+ const expectedId = fileName.replace(/\.(yaml|yml)$/, "");
229
+ const id = typeof value.id === "string" ? value.id.trim() : "";
230
+ if (!id) {
231
+ errors.push("id is required");
232
+ }
233
+ else {
234
+ if (!/^rtn-[a-z0-9][a-z0-9-]*$/.test(id)) {
235
+ errors.push(`id "${id}" must match rtn-<slug> (lowercase letters, digits, hyphens)`);
236
+ }
237
+ if (id !== expectedId) {
238
+ errors.push(`id "${id}" must match the file name base "${expectedId}"`);
239
+ }
240
+ }
241
+ if (value.enabled !== undefined && typeof value.enabled !== "boolean") {
242
+ errors.push("enabled must be a boolean");
243
+ }
244
+ const interval = typeof value.interval === "string" ? value.interval.trim() : "";
245
+ const trigger = isRecord(value.trigger) ? value.trigger : undefined;
246
+ if (!interval && !trigger) {
247
+ errors.push("interval or trigger is required");
248
+ }
249
+ if (interval && trigger)
250
+ errors.push("specify either interval or trigger, not both");
251
+ if (interval) {
252
+ try {
253
+ parseIntervalMs(interval);
254
+ }
255
+ catch (error) {
256
+ errors.push(error instanceof Error ? error.message : String(error));
257
+ }
258
+ }
259
+ let parsedTrigger;
260
+ if (trigger) {
261
+ const cron = typeof trigger.cron === "string" ? trigger.cron.trim() : "";
262
+ const timezone = typeof trigger.timezone === "string" ? trigger.timezone.trim() : "";
263
+ if (!cron)
264
+ errors.push("trigger.cron is required");
265
+ else {
266
+ try {
267
+ parseCronExpression(cron);
268
+ }
269
+ catch (error) {
270
+ errors.push(error instanceof Error ? error.message : String(error));
271
+ }
272
+ }
273
+ if (!timezone)
274
+ errors.push("trigger.timezone is required");
275
+ else {
276
+ try {
277
+ new Intl.DateTimeFormat("en-US", { timeZone: timezone }).format();
278
+ }
279
+ catch {
280
+ errors.push(`Invalid trigger.timezone: ${timezone}`);
281
+ }
282
+ }
283
+ if (cron && timezone)
284
+ parsedTrigger = { cron, timezone };
285
+ }
286
+ let policy;
287
+ if (value.policy !== undefined) {
288
+ if (!isRecord(value.policy))
289
+ errors.push("policy must be a mapping");
290
+ else {
291
+ const missed = value.policy.missed_run;
292
+ const overlap = value.policy.overlap;
293
+ if (missed !== undefined && missed !== "skip" && missed !== "latest" && missed !== "all") {
294
+ errors.push("policy.missed_run must be skip, latest, or all");
295
+ }
296
+ if (overlap !== undefined && overlap !== "skip")
297
+ errors.push("policy.overlap must be skip");
298
+ policy = {
299
+ ...(missed === "skip" || missed === "latest" || missed === "all"
300
+ ? { missed_run: missed }
301
+ : {}),
302
+ ...(overlap === "skip" ? { overlap } : {}),
303
+ };
304
+ }
305
+ }
306
+ let action;
307
+ if (Array.isArray(value.action)) {
308
+ if (value.action.length === 0)
309
+ errors.push("action must contain at least one action");
310
+ const parsed = value.action.map((item, index) => parseRoutineAction(item, `action[${index}]`, errors));
311
+ if (parsed.every((item) => item !== undefined))
312
+ action = parsed;
313
+ }
314
+ else {
315
+ action = parseRoutineAction(value.action, "action", errors);
316
+ }
317
+ if (errors.length > 0 || action === undefined) {
318
+ return { errors: errors.map((message) => `${fileName}: ${message}`) };
319
+ }
320
+ const doc = {
321
+ id,
322
+ ...(typeof value.name === "string" ? { name: value.name } : {}),
323
+ ...(typeof value.description === "string" ? { description: value.description } : {}),
324
+ ...(typeof value.enabled === "boolean" ? { enabled: value.enabled } : {}),
325
+ ...(interval ? { interval } : {}),
326
+ ...(parsedTrigger ? { trigger: parsedTrigger } : {}),
327
+ ...(policy ? { policy } : {}),
328
+ action,
329
+ };
330
+ return { doc, errors: [] };
331
+ }
332
+ // ================================
333
+ // Path resolution / loading
334
+ // ================================
335
+ export function resolveRoutinePaths(opts) {
336
+ loadEnv();
337
+ const { config, configPath } = loadConfig();
338
+ const baseDir = specdojoRootDir();
339
+ if (!config) {
340
+ throw new Error(`routine commands require specdojo.config.json.\nRun: specdojo config init`);
341
+ }
342
+ const projectId = opts.project?.trim() ||
343
+ process.env.SPECDOJO_PROJECT?.trim() ||
344
+ config.current_project?.trim() ||
345
+ Object.keys(config.projects)[0] ||
346
+ "";
347
+ if (!projectId) {
348
+ throw new Error(`No project specified. Use --project <id> or SPECDOJO_PROJECT.`);
349
+ }
350
+ const project = config.projects[projectId];
351
+ if (!project) {
352
+ throw new Error(`Unknown project: ${projectId} (check ${configPath})`);
353
+ }
354
+ const routinesPath = getProjectRoutinesPath(project);
355
+ if (!routinesPath) {
356
+ throw new Error(`routines_path not set for project '${projectId}' in ${configPath}.\n` +
357
+ `Add "routines_path": "<path>" to the project config.`);
358
+ }
359
+ const absRoutinesPath = resolve(baseDir, routinesPath);
360
+ const generatedPath = join(absRoutinesPath, "generated");
361
+ return {
362
+ projectId,
363
+ routinesPath: absRoutinesPath,
364
+ generatedPath,
365
+ statePath: join(generatedPath, "routine-state.json"),
366
+ runsPath: join(generatedPath, "routine-runs.jsonl"),
367
+ };
368
+ }
369
+ function isRoutineYamlFile(filePath) {
370
+ return /^rtn-.+\.(yaml|yml)$/.test(basename(filePath));
371
+ }
372
+ // routines ディレクトリ配下の rtn-*.yaml を読み込む。ファイル列挙順に依存しないよう
373
+ // ソートし、パース失敗・検証エラー・id 重複はファイル名つきで集約して返す。
374
+ export function loadRoutines(routinesPath) {
375
+ const routines = [];
376
+ const errors = [];
377
+ const seenIds = new Map();
378
+ const files = listFilesRecursive(routinesPath).filter(isRoutineYamlFile).sort();
379
+ for (const filePath of files) {
380
+ const fileName = basename(filePath);
381
+ let raw;
382
+ try {
383
+ raw = readYaml(filePath);
384
+ }
385
+ catch (error) {
386
+ const message = error instanceof Error ? error.message : String(error);
387
+ errors.push(`${fileName}: YAML parse error: ${message}`);
388
+ continue;
389
+ }
390
+ const parsed = parseRoutineDoc(raw, fileName);
391
+ if (!parsed.doc) {
392
+ errors.push(...parsed.errors);
393
+ continue;
394
+ }
395
+ const duplicatePath = seenIds.get(parsed.doc.id);
396
+ if (duplicatePath) {
397
+ errors.push(`${fileName}: duplicate routine id "${parsed.doc.id}" (also in ${duplicatePath})`);
398
+ continue;
399
+ }
400
+ seenIds.set(parsed.doc.id, fileName);
401
+ routines.push({ filePath, doc: parsed.doc });
402
+ }
403
+ return { routines, errors };
404
+ }
405
+ // ================================
406
+ // State
407
+ // ================================
408
+ function readRoutineState(statePath) {
409
+ if (!existsSync(statePath))
410
+ return { routines: {} };
411
+ try {
412
+ const raw = readJson(statePath);
413
+ if (isRecord(raw) && isRecord(raw.routines)) {
414
+ return raw;
415
+ }
416
+ }
417
+ catch {
418
+ // fall through: 壊れた state は空として扱い、次の書き込みで再生成する
419
+ }
420
+ return { routines: {} };
421
+ }
422
+ function writeRoutineState(paths, state) {
423
+ ensureDir(paths.generatedPath);
424
+ writeJson(paths.statePath, state);
425
+ }
426
+ export function appendRoutineRunHistory(runsPath, entry) {
427
+ ensureDir(resolve(runsPath, ".."));
428
+ appendFileSync(runsPath, `${JSON.stringify(entry)}\n`, "utf8");
429
+ }
430
+ // ================================
431
+ // Lock
432
+ // ================================
433
+ const ROUTINE_LOCK_STALE_MS = 60 * 60 * 1000;
434
+ // routine run の多重起動(外部スケジューラの重複発火)を防ぐ簡易 lock。
435
+ // 生存中の lock があれば即座に失敗し、stale(1 時間超)な lock は奪う。
436
+ function acquireRoutineLock(routinesPath) {
437
+ const lockDir = join(routinesPath, ".locks", "routine-run.lock");
438
+ ensureDir(resolve(lockDir, ".."));
439
+ try {
440
+ mkdirSync(lockDir);
441
+ return lockDir;
442
+ }
443
+ catch (error) {
444
+ if (error?.code !== "EEXIST")
445
+ throw error;
446
+ const ageMs = Date.now() - statSync(lockDir).mtimeMs;
447
+ if (ageMs > ROUTINE_LOCK_STALE_MS) {
448
+ rmSync(lockDir, { recursive: true, force: true });
449
+ mkdirSync(lockDir);
450
+ return lockDir;
451
+ }
452
+ throw new Error(`Another routine run is in progress (lock: ${lockDir}). ` +
453
+ `Remove the lock directory if no other run is active.`);
454
+ }
455
+ }
456
+ function releaseRoutineLock(lockDir) {
457
+ rmSync(lockDir, { recursive: true, force: true });
458
+ }
459
+ // ================================
460
+ // Execution
461
+ // ================================
462
+ /**
463
+ * routine は bin(dist/specdojo.js)を子プロセスとして起動するため、dist が古いと
464
+ * 子プロセスも古い挙動で動き、設定済みの検証が沈黙して省略される。routine 実行の
465
+ * 先頭で dist を最新化し、再ビルドに失敗した場合は実行を中止する。
466
+ * tsx で src を直接実行している場合と配布環境では no-op になる。
467
+ */
468
+ function ensureFreshDistForRoutineRun() {
469
+ const result = ensureFreshDistBuildForEntry(fileURLToPath(import.meta.url));
470
+ if (result.message) {
471
+ const stream = result.outcome === "rebuild-failed" ? process.stderr : process.stdout;
472
+ stream.write(`[routine] ${result.message}\n`);
473
+ }
474
+ return result.outcome !== "rebuild-failed";
475
+ }
476
+ function spawnSelf(args) {
477
+ const [exe, fullArgs] = selfRunArgs(args);
478
+ const result = spawnSync(exe, fullArgs, {
479
+ stdio: "inherit",
480
+ cwd: specdojoRootDir(),
481
+ env: { ...process.env, [ROUTINE_EXEC_ENV]: "1" },
482
+ });
483
+ if (result.status === ROUTINE_BUSY_SKIP_EXIT_CODE)
484
+ return "skipped";
485
+ return result.status === 0 ? "success" : "failure";
486
+ }
487
+ function renderRoutineInput(value, scheduledAt, timezone) {
488
+ return value.replace(/\{\{\s*scheduled_at(?:\s*\|\s*iso_week)?\s*\}\}/g, (match) => match.includes("iso_week") ? isoWeek(scheduledAt, timezone) : scheduledAt.toISOString());
489
+ }
490
+ export function buildJobRunArgs(action, projectId, scheduledAt, timezone = "UTC") {
491
+ if (!action.job)
492
+ throw new Error("job action requires action.job");
493
+ const args = [
494
+ "exec",
495
+ "run",
496
+ "--job",
497
+ action.job,
498
+ "--project",
499
+ projectId,
500
+ "--scheduled-at",
501
+ scheduledAt.toISOString(),
502
+ "--job-trigger",
503
+ "routine",
504
+ "--if-busy",
505
+ "skip",
506
+ ];
507
+ for (const [key, value] of Object.entries(action.inputs ?? {}).sort(([a], [b]) => a.localeCompare(b))) {
508
+ args.push("--input", `${key}=${renderRoutineInput(value, scheduledAt, timezone)}`);
509
+ }
510
+ return args;
511
+ }
512
+ export function aggregateRoutineActionResults(results) {
513
+ if (results.includes("failure"))
514
+ return "failure";
515
+ if (results.includes("skipped"))
516
+ return "skipped";
517
+ return "success";
518
+ }
519
+ export function executeRoutineActions(actions, execute) {
520
+ return actions.map((action, offset) => {
521
+ const index = offset + 1;
522
+ return { index, kind: action.kind, result: execute(action, index) };
523
+ });
524
+ }
525
+ // routine は時刻条件と Job への委譲だけを持つ。実行内容と入力検証は Job Definition が担う。
526
+ function executeRoutineAction(doc, action, projectId, dryRun, scheduledAt = new Date()) {
527
+ const args = action.kind === "specdojo"
528
+ ? buildSpecdojoActionArgs(action, projectId)
529
+ : buildJobRunArgs(action, projectId, scheduledAt, doc.trigger?.timezone ?? "UTC");
530
+ if (dryRun) {
531
+ process.stdout.write(` [dry-run] specdojo ${args.join(" ")}\n`);
532
+ return "success";
533
+ }
534
+ return spawnSelf(args);
535
+ }
536
+ // specdojo action は exec run を経由せず、指定したサブコマンドに --project を付けて起動する。
537
+ export function buildSpecdojoActionArgs(action, projectId) {
538
+ return [...action.args, "--project", projectId];
539
+ }
540
+ function findJobRunId(action, projectId, scheduledAt) {
541
+ if (action.kind !== "job")
542
+ return undefined;
543
+ const runsPath = resolveJobPaths(projectId).runsPath;
544
+ if (!existsSync(runsPath))
545
+ return undefined;
546
+ const scheduledFor = scheduledAt.toISOString();
547
+ for (const file of readdirSync(runsPath)
548
+ .filter((name) => name.endsWith(".json"))
549
+ .sort()) {
550
+ try {
551
+ const run = readJson(join(runsPath, file));
552
+ if (run.job_id === action.job &&
553
+ run.scheduled_at === scheduledFor &&
554
+ typeof run.run_id === "string") {
555
+ return run.run_id;
556
+ }
557
+ }
558
+ catch {
559
+ // Job Run の検証は job 側の責務。履歴追記では壊れた別 Run を無視する。
560
+ }
561
+ }
562
+ return undefined;
563
+ }
564
+ // action が配列なら、前段の結果にかかわらず先頭から全段を順次実行する。
565
+ // 段別結果を返し、全体結果は failure > skipped > success の順に集約する。
566
+ function executeRoutine(routine, projectId, dryRun, scheduledAt = new Date()) {
567
+ const { doc } = routine;
568
+ const actions = Array.isArray(doc.action) ? doc.action : [doc.action];
569
+ const label = doc.name ?? (actions.length === 1 ? actions[0].kind : `${actions.length} actions`);
570
+ process.stdout.write(`[routine] ${doc.id}: ${label}\n`);
571
+ if (!Array.isArray(doc.action)) {
572
+ const result = executeRoutineAction(doc, doc.action, projectId, dryRun, scheduledAt);
573
+ const jobRunId = dryRun ? undefined : findJobRunId(doc.action, projectId, scheduledAt);
574
+ return {
575
+ result,
576
+ jobRunIds: jobRunId ? [jobRunId] : [],
577
+ };
578
+ }
579
+ const actionResults = executeRoutineActions(actions, (action, index) => {
580
+ process.stdout.write(` action ${index}/${actions.length}: ${action.kind}\n`);
581
+ const result = executeRoutineAction(doc, action, projectId, dryRun, scheduledAt);
582
+ process.stdout.write(` action ${index}/${actions.length}: ${result}\n`);
583
+ return result;
584
+ });
585
+ const result = aggregateRoutineActionResults(actionResults.map((item) => item.result));
586
+ process.stdout.write(` action summary: ${actionResults.map((item) => `${item.index}:${item.result}`).join(", ")} => ${result}\n`);
587
+ const jobRunIds = dryRun
588
+ ? []
589
+ : doc.action.flatMap((action) => {
590
+ const runId = findJobRunId(action, projectId, scheduledAt);
591
+ return runId ? [runId] : [];
592
+ });
593
+ return { result, actionResults, jobRunIds };
594
+ }
595
+ // ================================
596
+ // Command registration
597
+ // ================================
598
+ function printCommandError(error) {
599
+ const message = error instanceof Error ? error.message : String(error);
600
+ process.stdout.write(message + "\n");
601
+ process.exitCode = 1;
602
+ }
603
+ function addProjectOption(cmd) {
604
+ return cmd.option("--project <projectId>", "Project id in specdojo.config.json");
605
+ }
606
+ export function formatRoutineLastRun(entry) {
607
+ if (!entry?.last_run)
608
+ return "-";
609
+ return entry.last_result ? `${entry.last_run} (${entry.last_result})` : entry.last_run;
610
+ }
611
+ export function registerRoutineCommands(program) {
612
+ const routine = program
613
+ .command("routine")
614
+ .description("Periodic task execution from rtn-*.yaml definitions");
615
+ // --- where ---
616
+ const whereCmd = routine.command("where").description("Print resolved routine paths and files");
617
+ addProjectOption(whereCmd);
618
+ whereCmd.action((opts) => {
619
+ try {
620
+ const paths = resolveRoutinePaths(opts);
621
+ process.stdout.write(`project: ${paths.projectId}\n`);
622
+ process.stdout.write(`routines: ${paths.routinesPath}\n`);
623
+ process.stdout.write(`state: ${paths.statePath}\n`);
624
+ process.stdout.write(`runs: ${paths.runsPath}\n`);
625
+ const files = listFilesRecursive(paths.routinesPath).filter(isRoutineYamlFile).sort();
626
+ for (const filePath of files) {
627
+ process.stdout.write(` ${filePath}\n`);
628
+ }
629
+ }
630
+ catch (error) {
631
+ printCommandError(error);
632
+ }
633
+ });
634
+ // --- validate ---
635
+ const validateCmd = routine.command("validate").description("Validate rtn-*.yaml definitions");
636
+ addProjectOption(validateCmd);
637
+ validateCmd.action((opts) => {
638
+ try {
639
+ const paths = resolveRoutinePaths(opts);
640
+ const { routines, errors } = loadRoutines(paths.routinesPath);
641
+ for (const message of errors) {
642
+ process.stderr.write(`ERROR: ${message}\n`);
643
+ }
644
+ process.stdout.write(`Validated: ${routines.length} routine(s), ${errors.length} error(s)\n`);
645
+ if (errors.length > 0)
646
+ process.exitCode = 1;
647
+ }
648
+ catch (error) {
649
+ printCommandError(error);
650
+ }
651
+ });
652
+ // --- list ---
653
+ const listCmd = routine
654
+ .command("list")
655
+ .description("List routines with due status and last run time");
656
+ addProjectOption(listCmd);
657
+ listCmd.action((opts) => {
658
+ try {
659
+ const paths = resolveRoutinePaths(opts);
660
+ const { routines, errors } = loadRoutines(paths.routinesPath);
661
+ for (const message of errors) {
662
+ process.stderr.write(`ERROR: ${message}\n`);
663
+ }
664
+ if (routines.length === 0) {
665
+ process.stdout.write(`No routines found in ${paths.routinesPath}\n`);
666
+ if (errors.length > 0)
667
+ process.exitCode = 1;
668
+ return;
669
+ }
670
+ const state = readRoutineState(paths.statePath);
671
+ const now = new Date();
672
+ const rows = routines.map(({ doc }) => ({
673
+ id: doc.id,
674
+ enabled: doc.enabled === false ? "disabled" : "enabled",
675
+ interval: doc.interval ?? doc.trigger?.cron ?? "-",
676
+ kind: routineActionKindLabel(doc.action),
677
+ lastRun: formatRoutineLastRun(state.routines[doc.id]),
678
+ due: doc.enabled === false
679
+ ? "-"
680
+ : doc.trigger
681
+ ? cronOccurrences(doc, state.routines[doc.id]?.last_scheduled_for, now).length > 0
682
+ ? "due"
683
+ : "-"
684
+ : isRoutineDue(doc, state.routines[doc.id]?.last_run, now)
685
+ ? "due"
686
+ : "-",
687
+ }));
688
+ const idWidth = Math.max(2, ...rows.map((row) => row.id.length));
689
+ for (const row of rows) {
690
+ process.stdout.write(`${padEndDisplay(row.id, idWidth)} ${padEndDisplay(row.enabled, 8)} ` +
691
+ `${padEndDisplay(row.interval, 8)} ${padEndDisplay(row.kind, 9)} ` +
692
+ `${padEndDisplay(row.due, 4)} ${row.lastRun}\n`);
693
+ }
694
+ if (errors.length > 0)
695
+ process.exitCode = 1;
696
+ }
697
+ catch (error) {
698
+ printCommandError(error);
699
+ }
700
+ });
701
+ // --- run ---
702
+ const runCmd = routine
703
+ .command("run")
704
+ .description("Run due routines (--due) or a specific routine (--id)");
705
+ addProjectOption(runCmd);
706
+ runCmd.option("--due", "Run every enabled routine whose interval has elapsed", false);
707
+ runCmd.option("--id <routineId>", "Run this routine now, regardless of due state");
708
+ runCmd.option("--dry-run", "Print planned commands without executing or recording", false);
709
+ runCmd.action((opts) => {
710
+ let lockDir = null;
711
+ try {
712
+ if (!opts.due && !opts.id) {
713
+ throw new Error("Specify --due or --id <routine-id>.");
714
+ }
715
+ if (opts.due && opts.id) {
716
+ throw new Error("Specify either --due or --id, not both.");
717
+ }
718
+ const paths = resolveRoutinePaths(opts);
719
+ const { routines, errors } = loadRoutines(paths.routinesPath);
720
+ for (const message of errors) {
721
+ process.stderr.write(`ERROR: ${message}\n`);
722
+ }
723
+ if (errors.length > 0)
724
+ process.exitCode = 1;
725
+ const state = readRoutineState(paths.statePath);
726
+ const now = new Date();
727
+ let selected;
728
+ if (opts.id) {
729
+ const routineId = opts.id.trim();
730
+ const found = routines.find((entry) => entry.doc.id === routineId);
731
+ if (!found) {
732
+ throw new Error(`Routine not found: ${routineId} (in ${paths.routinesPath})`);
733
+ }
734
+ selected = [{ entry: found, scheduledAt: now }];
735
+ }
736
+ else {
737
+ selected = routines.flatMap((entry) => {
738
+ if (entry.doc.enabled === false)
739
+ return [];
740
+ const stateEntry = state.routines[entry.doc.id];
741
+ if (entry.doc.trigger) {
742
+ return cronOccurrences(entry.doc, stateEntry?.last_scheduled_for, now).map((scheduledAt) => ({ entry, scheduledAt }));
743
+ }
744
+ return isRoutineDue(entry.doc, stateEntry?.last_run, now)
745
+ ? [{ entry, scheduledAt: now }]
746
+ : [];
747
+ });
748
+ }
749
+ if (selected.length === 0) {
750
+ process.stdout.write("[routine] no due routines — exit\n");
751
+ return;
752
+ }
753
+ const dryRun = !!opts.dryRun;
754
+ if (!dryRun) {
755
+ if (!ensureFreshDistForRoutineRun()) {
756
+ process.exitCode = 1;
757
+ return;
758
+ }
759
+ lockDir = acquireRoutineLock(paths.routinesPath);
760
+ }
761
+ let failed = 0;
762
+ let skipped = 0;
763
+ for (const selectedRun of selected) {
764
+ const { entry, scheduledAt } = selectedRun;
765
+ const startedAt = nowUtcIsoSeconds();
766
+ // 実行の試行自体を last_run として先に記録する。失敗した routine が次の
767
+ // 発火まで再試行されない代わりに、失敗が高頻度で連続発火することを防ぐ。
768
+ if (!dryRun) {
769
+ state.routines[entry.doc.id] = {
770
+ ...state.routines[entry.doc.id],
771
+ last_run: startedAt,
772
+ ...(entry.doc.trigger ? { last_scheduled_for: scheduledAt.toISOString() } : {}),
773
+ };
774
+ writeRoutineState(paths, state);
775
+ }
776
+ const execution = executeRoutine(entry, paths.projectId, dryRun, scheduledAt);
777
+ const { result } = execution;
778
+ if (result === "failure")
779
+ failed++;
780
+ if (result === "skipped") {
781
+ skipped++;
782
+ process.stdout.write(`[routine] skipped ${entry.doc.id}: job action skipped\n`);
783
+ }
784
+ if (!dryRun) {
785
+ state.routines[entry.doc.id] = {
786
+ ...state.routines[entry.doc.id],
787
+ last_result: result,
788
+ last_action_results: execution.actionResults,
789
+ };
790
+ writeRoutineState(paths, state);
791
+ appendRoutineRunHistory(paths.runsPath, {
792
+ version: 1,
793
+ routine_id: entry.doc.id,
794
+ scheduled_for: scheduledAt.toISOString(),
795
+ started_at: startedAt,
796
+ completed_at: nowUtcIsoSeconds(),
797
+ result,
798
+ job_run_ids: execution.jobRunIds,
799
+ });
800
+ }
801
+ }
802
+ process.stdout.write(`[routine] ${selected.length} routine(s) processed, ${skipped} skipped, ${failed} failed\n`);
803
+ if (failed > 0)
804
+ process.exitCode = 1;
805
+ }
806
+ catch (error) {
807
+ printCommandError(error);
808
+ }
809
+ finally {
810
+ if (lockDir)
811
+ releaseRoutineLock(lockDir);
812
+ }
813
+ });
814
+ }