specdojo 0.1.0 → 0.2.0

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 (531) hide show
  1. package/LICENSE +22 -0
  2. package/README.md +82 -38
  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 +980 -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 +45 -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 +15 -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 +55 -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 +473 -0
  139. package/docs/ja/specdojo/guides/register-operation-guide.md +418 -0
  140. package/docs/ja/specdojo/guides/review-guide.md +428 -0
  141. package/docs/ja/specdojo/guides/routine-operation-guide.md +282 -0
  142. package/docs/ja/specdojo/guides/ryu-guide.md +230 -0
  143. package/docs/ja/specdojo/guides/schedule-design-guide.md +429 -0
  144. package/docs/ja/specdojo/guides/schedule-operation-guide.md +151 -0
  145. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +257 -0
  146. package/docs/ja/specdojo/guides/timeline-design-guide.md +160 -0
  147. package/docs/ja/specdojo/guides/track-design-guide.md +215 -0
  148. package/docs/ja/specdojo/guides/use-case-guide.md +133 -0
  149. package/docs/ja/specdojo/guides/waza-guide.md +224 -0
  150. package/docs/ja/specdojo/index.md +33 -0
  151. package/docs/ja/specdojo/philosophy/needs-to-implementation-philosophy.md +212 -0
  152. package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +242 -0
  153. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +198 -0
  154. package/docs/ja/specdojo/recipes/cdfd-recipe.md +218 -0
  155. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +198 -0
  156. package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +100 -0
  157. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +148 -0
  158. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +97 -0
  159. package/docs/ja/specdojo/recipes/pm-members-recipe.md +149 -0
  160. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +96 -0
  161. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +98 -0
  162. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +97 -0
  163. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +96 -0
  164. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +136 -0
  165. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +162 -0
  166. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +187 -0
  167. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +235 -0
  168. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +205 -0
  169. package/docs/ja/specdojo/recipes/prj-overview-recipe.md +289 -0
  170. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +201 -0
  171. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +168 -0
  172. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +179 -0
  173. package/docs/ja/specdojo/recipes/stsd-recipe.md +138 -0
  174. package/docs/ja/specdojo/references/command-reference.md +718 -0
  175. package/docs/ja/specdojo/references/deliverables-reference.md +407 -0
  176. package/docs/ja/specdojo/references/directory-layout-reference.md +280 -0
  177. package/docs/ja/specdojo/references/specdojo-config-reference.md +133 -0
  178. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +372 -0
  179. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +302 -0
  180. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +331 -0
  181. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +134 -0
  182. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +207 -0
  183. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +102 -0
  184. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +131 -0
  185. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +269 -0
  186. package/docs/ja/specdojo/rulebooks/br-rulebook.md +187 -0
  187. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +279 -0
  188. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +219 -0
  189. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +233 -0
  190. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +182 -0
  191. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +171 -0
  192. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +105 -0
  193. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +195 -0
  194. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +285 -0
  195. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +292 -0
  196. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +171 -0
  197. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +325 -0
  198. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +266 -0
  199. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +294 -0
  200. package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +21 -0
  201. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +401 -0
  202. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +311 -0
  203. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +158 -0
  204. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +287 -0
  205. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +62 -0
  206. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +100 -0
  207. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +298 -0
  208. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +379 -0
  209. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +310 -0
  210. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +86 -0
  211. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +297 -0
  212. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +79 -0
  213. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +213 -0
  214. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +311 -0
  215. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +94 -0
  216. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +81 -0
  217. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +117 -0
  218. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +118 -0
  219. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +116 -0
  220. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +116 -0
  221. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +116 -0
  222. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +421 -0
  223. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +307 -0
  224. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +312 -0
  225. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +63 -0
  226. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +353 -0
  227. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +184 -0
  228. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +179 -0
  229. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +184 -0
  230. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +183 -0
  231. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +185 -0
  232. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +185 -0
  233. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +186 -0
  234. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +186 -0
  235. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +184 -0
  236. package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +61 -0
  237. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +84 -0
  238. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +357 -0
  239. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +80 -0
  240. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +484 -0
  241. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +120 -0
  242. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +293 -0
  243. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +211 -0
  244. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +94 -0
  245. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +116 -0
  246. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +93 -0
  247. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +190 -0
  248. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +108 -0
  249. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +122 -0
  250. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +117 -0
  251. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +116 -0
  252. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +93 -0
  253. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +146 -0
  254. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +65 -0
  255. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +178 -0
  256. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +232 -0
  257. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +235 -0
  258. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +242 -0
  259. package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +187 -0
  260. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +201 -0
  261. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +165 -0
  262. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +165 -0
  263. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +202 -0
  264. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +139 -0
  265. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +63 -0
  266. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +93 -0
  267. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +93 -0
  268. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +329 -0
  269. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +297 -0
  270. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +132 -0
  271. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +215 -0
  272. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +376 -0
  273. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +313 -0
  274. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +246 -0
  275. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +119 -0
  276. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +188 -0
  277. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +114 -0
  278. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +117 -0
  279. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +101 -0
  280. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +103 -0
  281. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +396 -0
  282. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +207 -0
  283. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +387 -0
  284. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +303 -0
  285. package/docs/ja/specdojo/samples/atc-index-sample.md +38 -0
  286. package/docs/ja/specdojo/samples/atc-sample.md +41 -0
  287. package/docs/ja/specdojo/samples/bac-sample.md +38 -0
  288. package/docs/ja/specdojo/samples/bdd-sample.yaml +71 -0
  289. package/docs/ja/specdojo/samples/bds-sample.md +38 -0
  290. package/docs/ja/specdojo/samples/bes-index-sample.md +38 -0
  291. package/docs/ja/specdojo/samples/bes-sample.md +38 -0
  292. package/docs/ja/specdojo/samples/bps-sample.md +38 -0
  293. package/docs/ja/specdojo/samples/br-sample.md +40 -0
  294. package/docs/ja/specdojo/samples/ccd-sample.md +38 -0
  295. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +284 -0
  296. package/docs/ja/specdojo/samples/cdfd-sample.md +229 -0
  297. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +146 -0
  298. package/docs/ja/specdojo/samples/cdsd-sample.md +38 -0
  299. package/docs/ja/specdojo/samples/cld-sample.md +38 -0
  300. package/docs/ja/specdojo/samples/cnd-sample.md +38 -0
  301. package/docs/ja/specdojo/samples/cop-index-sample.md +38 -0
  302. package/docs/ja/specdojo/samples/cop-sample.md +38 -0
  303. package/docs/ja/specdojo/samples/cpd-sample.md +38 -0
  304. package/docs/ja/specdojo/samples/cstd-sample.md +11 -0
  305. package/docs/ja/specdojo/samples/cxd-sample.md +38 -0
  306. package/docs/ja/specdojo/samples/dct-index-sample.yaml +39 -0
  307. package/docs/ja/specdojo/samples/dct-sample.yaml +91 -0
  308. package/docs/ja/specdojo/samples/dec-sample.md +39 -0
  309. package/docs/ja/specdojo/samples/dmd-index-sample.md +50 -0
  310. package/docs/ja/specdojo/samples/dmd-sample.md +74 -0
  311. package/docs/ja/specdojo/samples/etc-index-sample.md +38 -0
  312. package/docs/ja/specdojo/samples/etc-sample.md +38 -0
  313. package/docs/ja/specdojo/samples/gl-sample.yaml +37 -0
  314. package/docs/ja/specdojo/samples/ifd-sample.md +38 -0
  315. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +102 -0
  316. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +107 -0
  317. package/docs/ja/specdojo/samples/ifx-file-sample.md +38 -0
  318. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +89 -0
  319. package/docs/ja/specdojo/samples/imp-business-sample.md +66 -0
  320. package/docs/ja/specdojo/samples/imp-data-sample.md +60 -0
  321. package/docs/ja/specdojo/samples/imp-interface-sample.md +60 -0
  322. package/docs/ja/specdojo/samples/imp-operations-sample.md +60 -0
  323. package/docs/ja/specdojo/samples/imp-test-sample.md +60 -0
  324. package/docs/ja/specdojo/samples/itc-index-sample.md +38 -0
  325. package/docs/ja/specdojo/samples/itc-sample.md +38 -0
  326. package/docs/ja/specdojo/samples/mip-index-sample.md +38 -0
  327. package/docs/ja/specdojo/samples/mm-sample.md +35 -0
  328. package/docs/ja/specdojo/samples/mtp-sample.md +38 -0
  329. package/docs/ja/specdojo/samples/nfr-availability-sample.md +38 -0
  330. package/docs/ja/specdojo/samples/nfr-index-sample.md +38 -0
  331. package/docs/ja/specdojo/samples/nfr-integrity-sample.md +38 -0
  332. package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +38 -0
  333. package/docs/ja/specdojo/samples/nfr-operations-sample.md +38 -0
  334. package/docs/ja/specdojo/samples/nfr-performance-sample.md +38 -0
  335. package/docs/ja/specdojo/samples/nfr-reliability-sample.md +38 -0
  336. package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +38 -0
  337. package/docs/ja/specdojo/samples/nfr-usability-sample.md +38 -0
  338. package/docs/ja/specdojo/samples/ntp-sample.md +38 -0
  339. package/docs/ja/specdojo/samples/opd-access-control-sample.md +29 -0
  340. package/docs/ja/specdojo/samples/opd-incident-management-sample.md +31 -0
  341. package/docs/ja/specdojo/samples/opd-index-sample.md +41 -0
  342. package/docs/ja/specdojo/samples/opd-monitoring-sample.md +32 -0
  343. package/docs/ja/specdojo/samples/opd-sample.md +38 -0
  344. package/docs/ja/specdojo/samples/opr-access-control-sample.md +24 -0
  345. package/docs/ja/specdojo/samples/opr-backup-restore-sample.md +27 -0
  346. package/docs/ja/specdojo/samples/opr-batch-sample.md +23 -0
  347. package/docs/ja/specdojo/samples/opr-change-sample.md +24 -0
  348. package/docs/ja/specdojo/samples/opr-incident-sample.md +38 -0
  349. package/docs/ja/specdojo/samples/opr-index-sample.md +43 -0
  350. package/docs/ja/specdojo/samples/opr-monitoring-sample.md +27 -0
  351. package/docs/ja/specdojo/samples/opr-sample.md +38 -0
  352. package/docs/ja/specdojo/samples/opr-support-sample.md +23 -0
  353. package/docs/ja/specdojo/samples/otp-index-sample.md +66 -0
  354. package/docs/ja/specdojo/samples/otp-sample.md +68 -0
  355. package/docs/ja/specdojo/samples/pm-change-request-log-sample.md +47 -0
  356. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +46 -0
  357. package/docs/ja/specdojo/samples/pm-issue-log-sample.md +45 -0
  358. package/docs/ja/specdojo/samples/pm-members-sample.yaml +103 -0
  359. package/docs/ja/specdojo/samples/pm-organization-sample.md +46 -0
  360. package/docs/ja/specdojo/samples/pm-plan-sample.md +57 -0
  361. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +52 -0
  362. package/docs/ja/specdojo/samples/pm-raci-sample.md +57 -0
  363. package/docs/ja/specdojo/samples/pm-risk-register-sample.md +43 -0
  364. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +41 -0
  365. package/docs/ja/specdojo/samples/pr-sample.md +39 -0
  366. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +57 -0
  367. package/docs/ja/specdojo/samples/prj-charter-sample.md +121 -0
  368. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +105 -0
  369. package/docs/ja/specdojo/samples/prj-issues-and-approach-sample.md +78 -0
  370. package/docs/ja/specdojo/samples/prj-overview-sample.md +95 -0
  371. package/docs/ja/specdojo/samples/prj-scope-sample.md +71 -0
  372. package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +60 -0
  373. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +62 -0
  374. package/docs/ja/specdojo/samples/sac-sample.md +38 -0
  375. package/docs/ja/specdojo/samples/sf-index-sample.md +38 -0
  376. package/docs/ja/specdojo/samples/sf-sample.md +38 -0
  377. package/docs/ja/specdojo/samples/sld-sample.md +38 -0
  378. package/docs/ja/specdojo/samples/stc-index-sample.md +38 -0
  379. package/docs/ja/specdojo/samples/stc-sample.md +38 -0
  380. package/docs/ja/specdojo/samples/stsd-sample.md +58 -0
  381. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +38 -0
  382. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +38 -0
  383. package/docs/ja/specdojo/samples/sysd-index-sample.md +38 -0
  384. package/docs/ja/specdojo/samples/trc-requirements-to-specs-sample.md +56 -0
  385. package/docs/ja/specdojo/samples/trc-requirements-to-tests-sample.md +56 -0
  386. package/docs/ja/specdojo/samples/tsd-index-sample.md +29 -0
  387. package/docs/ja/specdojo/samples/tsd-sample.md +38 -0
  388. package/docs/ja/specdojo/samples/tsp-index-sample.md +38 -0
  389. package/docs/ja/specdojo/samples/uis-sample.md +38 -0
  390. package/docs/ja/specdojo/samples/utc-index-sample.md +38 -0
  391. package/docs/ja/specdojo/samples/utc-sample.md +38 -0
  392. package/docs/ja/specdojo/schemas/v1/guide-content.schema.yaml +20 -0
  393. package/docs/ja/specdojo/schemas/v1/philosophy-content.schema.yaml +21 -0
  394. package/docs/ja/specdojo/schemas/v1/reference-content.schema.yaml +21 -0
  395. package/docs/ja/specdojo/standards/document-metadata-standard.md +323 -0
  396. package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +75 -0
  397. package/docs/ja/specdojo/standards/git-branching-standard.md +227 -0
  398. package/docs/ja/specdojo/standards/guide-authoring-standard.md +124 -0
  399. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +929 -0
  400. package/docs/ja/specdojo/standards/job-definition-standard.md +148 -0
  401. package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +431 -0
  402. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +113 -0
  403. package/docs/ja/specdojo/standards/recipe-authoring-standard.md +143 -0
  404. package/docs/ja/specdojo/standards/reference-authoring-standard.md +99 -0
  405. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +140 -0
  406. package/docs/ja/specdojo/standards/sample-authoring-standard.md +151 -0
  407. package/docs/ja/specdojo/standards/standard-authoring-standard.md +108 -0
  408. package/docs/ja/specdojo/standards/template-authoring-standard.md +101 -0
  409. package/docs/ja/specdojo/standards/test-document-scope-standard.md +176 -0
  410. package/docs/ja/specdojo/templates/cdfd-overview-template.md +199 -0
  411. package/docs/ja/specdojo/templates/cdfd-template.md +173 -0
  412. package/docs/ja/specdojo/templates/cdfd-uc-template.md +148 -0
  413. package/docs/ja/specdojo/templates/dct-architecture-template.yaml +136 -0
  414. package/docs/ja/specdojo/templates/dct-business-acceptance-criteria-template.yaml +34 -0
  415. package/docs/ja/specdojo/templates/dct-business-model-bes-template.yaml +75 -0
  416. package/docs/ja/specdojo/templates/dct-business-model-bps-template.yaml +49 -0
  417. package/docs/ja/specdojo/templates/dct-business-model-br-template.yaml +50 -0
  418. package/docs/ja/specdojo/templates/dct-data-flow-template.yaml +40 -0
  419. package/docs/ja/specdojo/templates/dct-data-model-bdd-template.yaml +46 -0
  420. package/docs/ja/specdojo/templates/dct-data-model-ccd-template.yaml +46 -0
  421. package/docs/ja/specdojo/templates/dct-data-model-cdsd-template.yaml +41 -0
  422. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +38 -0
  423. package/docs/ja/specdojo/templates/dct-data-model-sld-template.yaml +38 -0
  424. package/docs/ja/specdojo/templates/dct-data-model-stsd-template.yaml +46 -0
  425. package/docs/ja/specdojo/templates/dct-external-interface-specs-template.yaml +114 -0
  426. package/docs/ja/specdojo/templates/dct-glossary-template.yaml +35 -0
  427. package/docs/ja/specdojo/templates/dct-impact-analysis-template.yaml +138 -0
  428. package/docs/ja/specdojo/templates/dct-index-template.md +40 -0
  429. package/docs/ja/specdojo/templates/dct-migration-planning-template.yaml +148 -0
  430. package/docs/ja/specdojo/templates/dct-non-functional-requirements-template.yaml +222 -0
  431. package/docs/ja/specdojo/templates/dct-operations-template.yaml +108 -0
  432. package/docs/ja/specdojo/templates/dct-project-definition-template.yaml +210 -0
  433. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +423 -0
  434. package/docs/ja/specdojo/templates/dct-system-acceptance-criteria-template.yaml +37 -0
  435. package/docs/ja/specdojo/templates/dct-system-design-template.yaml +82 -0
  436. package/docs/ja/specdojo/templates/dct-system-functions-template.yaml +58 -0
  437. package/docs/ja/specdojo/templates/dct-test-specs-template.yaml +261 -0
  438. package/docs/ja/specdojo/templates/dct-user-interface-model-template.yaml +60 -0
  439. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +88 -0
  440. package/docs/ja/specdojo/templates/opr-template.md +85 -0
  441. package/docs/ja/specdojo/templates/pjr-change-request-template.md +60 -0
  442. package/docs/ja/specdojo/templates/pjr-decision-template.md +61 -0
  443. package/docs/ja/specdojo/templates/pjr-index-template.md +49 -0
  444. package/docs/ja/specdojo/templates/pjr-issue-template.md +50 -0
  445. package/docs/ja/specdojo/templates/pjr-note-template.md +35 -0
  446. package/docs/ja/specdojo/templates/pjr-question-template.md +53 -0
  447. package/docs/ja/specdojo/templates/pjr-risk-template.md +49 -0
  448. package/docs/ja/specdojo/templates/pjr-todo-template.md +41 -0
  449. package/docs/ja/specdojo/templates/pjr-views-by-owner-template.md +22 -0
  450. package/docs/ja/specdojo/templates/pjr-views-by-priority-template.md +22 -0
  451. package/docs/ja/specdojo/templates/pjr-views-by-status-template.md +22 -0
  452. package/docs/ja/specdojo/templates/pm-change-request-log-template.md +20 -0
  453. package/docs/ja/specdojo/templates/pm-communication-plan-template.md +46 -0
  454. package/docs/ja/specdojo/templates/pm-decision-log-template.md +20 -0
  455. package/docs/ja/specdojo/templates/pm-issue-log-template.md +20 -0
  456. package/docs/ja/specdojo/templates/pm-members-template.yaml +105 -0
  457. package/docs/ja/specdojo/templates/pm-organization-template.md +44 -0
  458. package/docs/ja/specdojo/templates/pm-plan-template.md +52 -0
  459. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +46 -0
  460. package/docs/ja/specdojo/templates/pm-raci-template.md +51 -0
  461. package/docs/ja/specdojo/templates/pm-risk-register-template.md +20 -0
  462. package/docs/ja/specdojo/templates/pm-roles-template.yaml +53 -0
  463. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +59 -0
  464. package/docs/ja/specdojo/templates/prj-charter-template.md +116 -0
  465. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +116 -0
  466. package/docs/ja/specdojo/templates/prj-issues-and-approach-template.md +89 -0
  467. package/docs/ja/specdojo/templates/prj-overview-template.md +85 -0
  468. package/docs/ja/specdojo/templates/prj-scope-template.md +75 -0
  469. package/docs/ja/specdojo/templates/prj-stakeholder-register-template.md +64 -0
  470. package/docs/ja/specdojo/templates/prj-success-criteria-and-acceptance-criteria-template.md +60 -0
  471. package/docs/ja/specdojo/templates/stsd-template.md +57 -0
  472. package/docs/specdojo/schemas/v1/bdd.schema.yaml +230 -0
  473. package/docs/specdojo/schemas/v1/common-frontmatter.schema.yaml +77 -0
  474. package/docs/specdojo/schemas/v1/dct-index.schema.yaml +85 -0
  475. package/docs/specdojo/schemas/v1/dct-plan.schema.yaml +324 -0
  476. package/docs/specdojo/schemas/v1/dct.schema.yaml +368 -0
  477. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +91 -0
  478. package/docs/specdojo/schemas/v1/esil.schema.yaml +142 -0
  479. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +101 -0
  480. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +272 -0
  481. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +162 -0
  482. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +126 -0
  483. package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +151 -0
  484. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +144 -0
  485. package/docs/specdojo/schemas/v1/grade-done-criteria.schema.yaml +79 -0
  486. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +60 -0
  487. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +118 -0
  488. package/docs/specdojo/schemas/v1/guide-frontmatter.schema.yaml +19 -0
  489. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +293 -0
  490. package/docs/specdojo/schemas/v1/job-run.schema.yaml +90 -0
  491. package/docs/specdojo/schemas/v1/job.schema.yaml +198 -0
  492. package/docs/specdojo/schemas/v1/philosophy-frontmatter.schema.yaml +19 -0
  493. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +56 -0
  494. package/docs/specdojo/schemas/v1/pm-members.schema.yaml +252 -0
  495. package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +387 -0
  496. package/docs/specdojo/schemas/v1/pm-roles.schema.yaml +106 -0
  497. package/docs/specdojo/schemas/v1/recipe-frontmatter.schema.yaml +27 -0
  498. package/docs/specdojo/schemas/v1/reference-frontmatter.schema.yaml +18 -0
  499. package/docs/specdojo/schemas/v1/register-events.schema.yaml +106 -0
  500. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +204 -0
  501. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +36 -0
  502. package/docs/specdojo/schemas/v1/routine.schema.yaml +87 -0
  503. package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +61 -0
  504. package/docs/specdojo/schemas/v1/sch-common.schema.yaml +258 -0
  505. package/docs/specdojo/schemas/v1/sch-defaults.schema.yaml +48 -0
  506. package/docs/specdojo/schemas/v1/sch-milestones.schema.yaml +64 -0
  507. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +772 -0
  508. package/docs/specdojo/schemas/v1/sch-track.schema.yaml +66 -0
  509. package/docs/specdojo/schemas/v1/standard-frontmatter.schema.yaml +18 -0
  510. package/docs/specdojo/schemas/v1/tml-index.schema.yaml +103 -0
  511. package/package.json +120 -24
  512. package/templates/claude/README.md +46 -0
  513. package/templates/claude/agents/claude-expert-review-executor.md +14 -0
  514. package/templates/claude/agents/claude-review-executor.md +14 -0
  515. package/templates/claude/settings.edit.json +6 -0
  516. package/templates/claude/settings.report.json +6 -0
  517. package/templates/claude/settings.review.json +7 -0
  518. package/templates/codex/README.md +61 -0
  519. package/templates/codex/agents/codex-executor.toml +12 -0
  520. package/templates/codex/agents/codex-expert-executor.toml +12 -0
  521. package/templates/codex/agents/codex-expert-review-executor.toml +10 -0
  522. package/templates/codex/agents/codex-review-executor.toml +10 -0
  523. package/templates/copilot/README.md +41 -0
  524. package/templates/copilot/exec-defaults-snippet.yaml +28 -0
  525. package/templates/copilot/pm-members-snippet.yaml +44 -0
  526. package/templates/opencode/README.md +41 -0
  527. package/templates/opencode/agents/opencode-executor.md +59 -0
  528. package/templates/opencode/agents/opencode-reporter.md +26 -0
  529. package/templates/opencode/agents/opencode-review-executor.md +48 -0
  530. package/dist/exec-schedule-timeline-render.js +0 -201
  531. package/dist/exec-schedule-timeline.js +0 -2
@@ -1,13 +1,48 @@
1
- import { existsSync, writeFileSync } from 'node:fs';
2
- import { extname, join } from 'node:path';
3
- import { computeReadyIds, foldEventsToState, validateEventShape } from './exec-events.js';
4
- import { ensureDir, listFilesRecursive, nowUtcIsoSeconds, readJson, toArtifactPath, toScheduleFilePath, writeJson, } from './exec-shared.js';
5
- import { eventsDirForProject, executionRootForProject, generatedDirForProject, } from './exec-project.js';
6
- import { buildProgressSummaryLines, buildTimelineMarkdown, buildTimelineSvg, } from './exec-schedule-timeline.js';
7
- import { buildScheduleIndex } from './exec-schedule-index.js';
8
- import { computeCpm, topoSort } from './exec-schedule-cpm.js';
9
- import { buildReadySnapshot, orderReadyIds, writeReadyFiles, selectNextTask, } from './exec-schedule-ready.js';
10
- import { writeScheduleHashAndDiff } from './exec-schedule-hash.js';
1
+ import { existsSync, statSync, writeFileSync } from "node:fs";
2
+ import { basename, extname, join } from "node:path";
3
+ import { computeReadyIds, foldEventsToState, isExecEventV1, validateEventShape, } from "./exec-events.js";
4
+ import { ensureDir, formatDays, listFilesRecursive, readJson, toArtifactPath, toScheduleFilePath, writeJson, } from "./exec-shared.js";
5
+ import { eventsDirForProject, executionRootForProject, generatedDirForProject, } from "./exec-project.js";
6
+ import { buildGanttChartMarkdown, buildGanttChartSvg, buildProgressSummaryLines, } from "./exec-schedule-gantt-chart.js";
7
+ import { buildScheduleIndex } from "./exec-schedule-index.js";
8
+ import { buildGanttChartScopeSpecs, filterCpmNodes, scheduleTrackNames, } from "./exec-schedule-gantt-chart-scope.js";
9
+ import { computeCpm, topoSort } from "./exec-schedule-cpm.js";
10
+ import { buildReadySnapshot, orderReadyIds, writeReadyFiles, selectNextTask, } from "./exec-schedule-ready.js";
11
+ import { writeScheduleHashAndDiff } from "./exec-schedule-hash.js";
12
+ import { buildInitialStateFromStrategy } from "./exec-schedule-initial.js";
13
+ import { buildPhaseModeIndex, resolveAgentAssignment, resolveAgentPipeline, resolveApproach, resolveTaskCapabilities, resolveTaskExecution, resolveTaskMode, resolveTaskProficiency, } from "./exec-strategy.js";
14
+ export function findStaleGeneratedTracks(projectPath) {
15
+ const files = listFilesRecursive(projectPath);
16
+ const trackFiles = new Map();
17
+ for (const file of files) {
18
+ const match = basename(file).match(/^sch-track-(.+)\.yaml$/);
19
+ if (match)
20
+ trackFiles.set(match[1], file);
21
+ }
22
+ const staleTracks = [];
23
+ for (const strategyFile of files) {
24
+ const match = basename(strategyFile).match(/^sch-strategy-(.+)\.yaml$/);
25
+ if (!match)
26
+ continue;
27
+ const track = match[1];
28
+ const trackFile = trackFiles.get(track);
29
+ if (!trackFile) {
30
+ staleTracks.push({ track, strategyFile, reason: "missing" });
31
+ continue;
32
+ }
33
+ if (statSync(strategyFile).mtimeMs > statSync(trackFile).mtimeMs) {
34
+ staleTracks.push({ track, strategyFile, trackFile, reason: "outdated" });
35
+ }
36
+ }
37
+ return staleTracks.sort((a, b) => a.track.localeCompare(b.track));
38
+ }
39
+ export function findStaleGeneratedTrackWarnings(projectPath) {
40
+ return findStaleGeneratedTracks(projectPath).map((stale) => stale.reason === "missing"
41
+ ? `${basename(stale.strategyFile)} has no generated sch-track-${stale.track}.yaml. ` +
42
+ `Run: specdojo schedule build --track ${stale.track}`
43
+ : `${basename(stale.strategyFile)} is newer than ${basename(stale.trackFile)}. ` +
44
+ `Run: specdojo schedule build --track ${stale.track} --force before exec refresh.`);
45
+ }
11
46
  export function validateAll(projectPath) {
12
47
  const errors = [];
13
48
  const warnings = [];
@@ -16,6 +51,7 @@ export function validateAll(projectPath) {
16
51
  if (schedule.nodes.size === 0) {
17
52
  warnings.push(`No schedule nodes loaded from sch-*.yaml under: ${projectPath}`);
18
53
  }
54
+ warnings.push(...findStaleGeneratedTrackWarnings(projectPath));
19
55
  for (const node of schedule.nodes.values()) {
20
56
  for (const dep of node.depends_on) {
21
57
  if (!schedule.nodes.has(dep)) {
@@ -25,12 +61,12 @@ export function validateAll(projectPath) {
25
61
  }
26
62
  const topo = topoSort(schedule);
27
63
  if (topo.cycle && topo.cycle.length) {
28
- errors.push(`schedule dependency cycle detected (nodes involved): ${topo.cycle.join(', ')}`);
64
+ errors.push(`schedule dependency cycle detected (nodes involved): ${topo.cycle.join(", ")}`);
29
65
  }
30
66
  const eventsDir = eventsDirForProject(projectPath);
31
67
  if (!existsSync(eventsDir))
32
68
  warnings.push(`No exec/events directory: ${eventsDir}`);
33
- const files = listFilesRecursive(eventsDir).filter(p => extname(p).toLowerCase() === '.json');
69
+ const files = listFilesRecursive(eventsDir).filter((p) => extname(p).toLowerCase() === ".json");
34
70
  let parsedEvents = 0;
35
71
  for (const f of files) {
36
72
  let obj;
@@ -43,11 +79,12 @@ export function validateAll(projectPath) {
43
79
  }
44
80
  const shapeErrs = validateEventShape(obj, f);
45
81
  errors.push(...shapeErrs);
46
- if (shapeErrs.length === 0) {
82
+ if (isExecEventV1(obj, f)) {
47
83
  parsedEvents++;
48
84
  const ev = obj;
49
85
  if (!scheduleIds.has(ev.task_id))
50
- errors.push(`${f}: task_id ${ev.task_id} not found in sch-*.yaml`);
86
+ warnings.push(`${f}: task_id ${ev.task_id} not found in current sch-*.yaml; ` +
87
+ `the historical event will be ignored when building state`);
51
88
  }
52
89
  }
53
90
  return {
@@ -63,15 +100,15 @@ export function validateAll(projectPath) {
63
100
  };
64
101
  }
65
102
  export function printValidateResult(res) {
66
- process.stdout.write(res.ok ? 'OK: validation passed\n' : 'NG: validation failed\n');
103
+ process.stdout.write(res.ok ? "OK: validation passed\n" : "NG: validation failed\n");
67
104
  process.stdout.write(`stats: events=${res.stats.events}, event_files=${res.stats.event_files}, schedule_ids=${res.stats.schedule_ids}, schedule_files=${res.stats.schedule_files}\n`);
68
105
  if (res.warnings.length) {
69
- process.stdout.write('\nWarnings:\n');
106
+ process.stdout.write("\nWarnings:\n");
70
107
  for (const w of res.warnings)
71
108
  process.stdout.write(`- ${w}\n`);
72
109
  }
73
110
  if (res.errors.length) {
74
- process.stdout.write('\nErrors:\n');
111
+ process.stdout.write("\nErrors:\n");
75
112
  for (const e of res.errors)
76
113
  process.stdout.write(`- ${e}\n`);
77
114
  }
@@ -82,113 +119,154 @@ export function exitWithCode(ok) {
82
119
  export function writeCpmFiles(projectPath, cpm, stateSnapshot) {
83
120
  const genDir = generatedDirForProject(projectPath);
84
121
  ensureDir(genDir);
85
- writeJson(join(genDir, 'cpm.json'), cpm);
122
+ writeJson(join(genDir, "cpm.json"), cpm);
86
123
  const rows = Object.values(cpm.nodes).sort((a, b) => a.es - b.es || a.id.localeCompare(b.id));
87
124
  const lines = [];
88
125
  lines.push(`# CPM`);
89
- lines.push('');
90
- lines.push(`- project_duration_days: \`${cpm.project_duration_days}\``);
91
- lines.push('');
126
+ lines.push("");
127
+ lines.push(`- project_duration_days: \`${formatDays(cpm.project_duration_days)}\``);
128
+ lines.push("");
92
129
  lines.push(`| id | owner | kind | dur | ES | EF | LS | LF | slack | depends_on |`);
93
130
  lines.push(`|---|---|---:|---:|---:|---:|---:|---:|---:|---|`);
94
131
  for (const r of rows) {
95
- lines.push(`| \`${r.id}\` | ${r.owner ?? '-'} | ${r.kind} | ${r.duration_days} | ${r.es} | ${r.ef} | ${r.ls} | ${r.lf} | ${r.slack} | ${r.depends_on.join(', ')} |`);
132
+ lines.push(`| \`${r.id}\` | ${r.owner ?? "-"} | ${r.kind} | ${formatDays(r.duration_days)} | ${formatDays(r.es)} | ${formatDays(r.ef)} | ${formatDays(r.ls)} | ${formatDays(r.lf)} | ${formatDays(r.slack)} | ${r.depends_on.join(", ")} |`);
96
133
  }
97
- lines.push('');
98
- writeFileSync(join(genDir, 'cpm.md'), lines.join('\n'), 'utf8');
134
+ lines.push("");
135
+ writeFileSync(join(genDir, "cpm.md"), lines.join("\n"), "utf8");
99
136
  const cp = [];
100
137
  cp.push(`# Critical Path`);
101
- cp.push('');
102
- cp.push(`- project_duration_days: \`${cpm.project_duration_days}\``);
103
- cp.push('');
138
+ cp.push("");
139
+ cp.push(`- project_duration_days: \`${formatDays(cpm.project_duration_days)}\``);
140
+ cp.push("");
104
141
  if (!cpm.critical_path.length)
105
- cp.push('_No critical path computed._');
142
+ cp.push("_No critical path computed._");
106
143
  else {
107
144
  cp.push(`Critical path (one path, tie-broken):`);
108
- cp.push('');
145
+ cp.push("");
109
146
  for (const id of cpm.critical_path) {
110
147
  const n = cpm.nodes[id];
111
- cp.push(`- \`${id}\`${n.name ? ` — ${n.name}` : ''} (ES=${n.es}, EF=${n.ef})`);
148
+ cp.push(`- \`${id}\`${n.name ? ` — ${n.name}` : ""} (ES=${formatDays(n.es)}, EF=${formatDays(n.ef)})`);
112
149
  }
113
150
  }
114
- cp.push('');
115
- writeFileSync(join(genDir, 'critical-path.md'), cp.join('\n'), 'utf8');
151
+ cp.push("");
152
+ writeFileSync(join(genDir, "critical-path.md"), cp.join("\n"), "utf8");
116
153
  const schedule = buildScheduleIndex(projectPath);
117
- const criticalSet = new Set(cpm.critical_path);
118
- const taskRows = rows.filter(row => row.kind === 'task');
119
- const stateCounts = {
120
- todo: 0,
121
- doing: 0,
122
- blocked: 0,
123
- done: 0,
124
- cancelled: 0,
125
- };
126
- for (const row of taskRows) {
127
- const state = stateSnapshot?.tasks[row.id]?.state ?? 'todo';
128
- stateCounts[state] += 1;
129
- }
130
- const doneCount = stateCounts.done;
131
- const totalTaskCount = taskRows.length;
132
- const progressPercent = totalTaskCount > 0 ? ((doneCount / totalTaskCount) * 100).toFixed(1) : '0.0';
133
- const ready = computeReadyIds(schedule, {
154
+ const allTaskRows = rows.filter((row) => row.kind === "task");
155
+ const tasksState = stateSnapshot?.tasks ?? {};
156
+ const readyAll = computeReadyIds(schedule, {
134
157
  schedule_path: cpm.schedule_path,
135
- tasks: stateSnapshot?.tasks ?? {},
158
+ tasks: tasksState,
136
159
  });
137
- const readyOrdered = orderReadyIds(ready, cpm, 'critical-first');
138
- const criticalDoingCount = taskRows.filter(row => criticalSet.has(row.id) && (stateSnapshot?.tasks[row.id]?.state ?? 'todo') === 'doing').length;
139
- const progressSummaryLines = buildProgressSummaryLines({
140
- cpm,
141
- schedule,
142
- stateCounts,
143
- totalTaskCount,
144
- readyCount: ready.length,
145
- nextTaskId: readyOrdered[0] ?? null,
146
- criticalDoingCount,
147
- });
148
- writeFileSync(join(genDir, 'timeline.svg'), buildTimelineSvg(cpm, schedule, stateSnapshot), 'utf8');
149
- writeFileSync(join(genDir, 'timeline.md'), buildTimelineMarkdown(cpm, {
150
- criticalPathTaskCount: criticalSet.size,
151
- progressPercent,
152
- doneTasks: `${doneCount}/${totalTaskCount}`,
153
- taskStateCounts: `todo=${stateCounts.todo}, doing=${stateCounts.doing}, blocked=${stateCounts.blocked}, done=${stateCounts.done}, cancelled=${stateCounts.cancelled}`,
154
- progressSummaryLines,
155
- }), 'utf8');
160
+ const readyOrderedAll = orderReadyIds(readyAll, cpm, "critical-first");
161
+ const stateOf = (id) => stateSnapshot?.tasks[id]?.state ?? "todo";
162
+ for (const scope of buildGanttChartScopeSpecs(cpm)) {
163
+ // SVG: scope の描画対象ノードだけを持つ CpmResult(full は cpm そのまま)。
164
+ const renderCpm = scope.renderIds
165
+ ? filterCpmNodes(cpm, scope.renderIds, scope.keepCriticalPath)
166
+ : cpm;
167
+ // 進捗サマリー: scope の母集団(track なら track の task、full/milestones は全 task)。
168
+ const progressCpm = scope.progressIds
169
+ ? filterCpmNodes(cpm, scope.progressIds, scope.keepCriticalPath)
170
+ : cpm;
171
+ const progressTaskRows = scope.progressIds
172
+ ? allTaskRows.filter((row) => scope.progressIds.has(row.id))
173
+ : allTaskRows;
174
+ const stateCounts = {
175
+ todo: 0,
176
+ doing: 0,
177
+ blocked: 0,
178
+ done: 0,
179
+ cancelled: 0,
180
+ };
181
+ for (const row of progressTaskRows)
182
+ stateCounts[stateOf(row.id)] += 1;
183
+ const doneCount = stateCounts.done;
184
+ const totalTaskCount = progressTaskRows.length;
185
+ const progressPercent = totalTaskCount > 0 ? ((doneCount / totalTaskCount) * 100).toFixed(1) : "0.0";
186
+ const readyScope = scope.progressIds
187
+ ? readyAll.filter((id) => scope.progressIds.has(id))
188
+ : readyAll;
189
+ const nextTaskId = (scope.progressIds
190
+ ? readyOrderedAll.filter((id) => scope.progressIds.has(id))
191
+ : readyOrderedAll)[0] ?? null;
192
+ const progressCriticalSet = new Set(progressCpm.critical_path);
193
+ const criticalDoingCount = progressTaskRows.filter((row) => progressCriticalSet.has(row.id) && stateOf(row.id) === "doing").length;
194
+ const progressSummaryLines = buildProgressSummaryLines({
195
+ cpm: progressCpm,
196
+ schedule,
197
+ stateCounts,
198
+ totalTaskCount,
199
+ readyCount: readyScope.length,
200
+ nextTaskId,
201
+ criticalDoingCount,
202
+ });
203
+ writeFileSync(join(genDir, `${scope.fileBase}.svg`), buildGanttChartSvg(renderCpm, schedule, stateSnapshot, { title: scope.title }), "utf8");
204
+ writeFileSync(join(genDir, `${scope.fileBase}.md`), buildGanttChartMarkdown(progressCpm, {
205
+ criticalPathTaskCount: new Set(renderCpm.critical_path).size,
206
+ progressPercent,
207
+ doneTasks: `${doneCount}/${totalTaskCount}`,
208
+ taskStateCounts: `todo=${stateCounts.todo}, doing=${stateCounts.doing}, blocked=${stateCounts.blocked}, done=${stateCounts.done}, cancelled=${stateCounts.cancelled}`,
209
+ progressSummaryLines,
210
+ }, {
211
+ title: scope.title,
212
+ svgFileName: `${scope.fileBase}.svg`,
213
+ scopeLabel: scope.scopeLabel,
214
+ }), "utf8");
215
+ }
156
216
  }
157
217
  export function writeGeneratedCore(projectPath, events, schedule, cpm) {
158
218
  const genDir = generatedDirForProject(projectPath);
159
219
  ensureDir(genDir);
160
- const jsonl = events.map(x => JSON.stringify(x.event)).join('\n') + (events.length ? '\n' : '');
161
- writeFileSync(join(genDir, 'exec.jsonl'), jsonl, 'utf8');
162
- const snapshot = foldEventsToState(events, schedule, projectPath);
163
- writeJson(join(genDir, 'state.json'), snapshot);
220
+ const jsonl = events.map((x) => JSON.stringify(x.event)).join("\n") + (events.length ? "\n" : "");
221
+ writeFileSync(join(genDir, "exec.jsonl"), jsonl, "utf8");
222
+ const initialTasks = buildInitialStateFromStrategy(projectPath, schedule);
223
+ const snapshot = foldEventsToState(events, schedule, projectPath, initialTasks);
224
+ writeJson(join(genDir, "state.json"), snapshot);
164
225
  const ready = computeReadyIds(schedule, snapshot);
165
226
  const readySnapshot = buildReadySnapshot(projectPath, schedule, ready, cpm);
227
+ const phaseModeIndex = buildPhaseModeIndex(projectPath);
228
+ for (const task of readySnapshot.tasks) {
229
+ task.mode = resolveTaskMode(task.local_id, task.id, phaseModeIndex, task.phase_suffix, task.phase_set);
230
+ task.execution = resolveTaskExecution(task.local_id, task.id, phaseModeIndex, task.phase_suffix, task.phase_set);
231
+ task.approach = resolveApproach(task.local_id, task.id, phaseModeIndex, task.phase_suffix, task.phase_set);
232
+ const capabilities = resolveTaskCapabilities(task.local_id, task.id, phaseModeIndex, task.phase_suffix, task.phase_set);
233
+ if (capabilities.length > 0)
234
+ task.capabilities = capabilities;
235
+ const proficiency = resolveTaskProficiency(task.local_id, task.id, phaseModeIndex, task.phase_suffix, task.phase_set);
236
+ if (proficiency !== undefined)
237
+ task.proficiency = proficiency;
238
+ const agentPipeline = resolveAgentPipeline(task.local_id, task.id, phaseModeIndex, task.phase_suffix, task.phase_set);
239
+ if (agentPipeline !== undefined)
240
+ task.agent_pipeline = agentPipeline;
241
+ const agent = resolveAgentAssignment(task.local_id, task.id, phaseModeIndex, task.phase_suffix, task.phase_set);
242
+ if (agent !== undefined)
243
+ task.agent = agent;
244
+ }
166
245
  writeReadyFiles(projectPath, readySnapshot);
167
- writeJson(join(genDir, 'metadata.json'), {
168
- generated_at_utc: nowUtcIsoSeconds(),
246
+ const ganttChartFiles = ["gantt-chart", "gantt-chart-milestones"]
247
+ .concat(scheduleTrackNames(schedule).map((track) => `gantt-chart-track-${track}`))
248
+ .flatMap((base) => [`${base}.md`, `${base}.svg`]);
249
+ writeJson(join(genDir, "metadata.json"), {
169
250
  schedule_path: toArtifactPath(projectPath),
170
251
  execution_path: toArtifactPath(executionRootForProject(projectPath)),
171
252
  generated_dir: toArtifactPath(genDir),
172
- schedule_files: schedule.files.map(p => toScheduleFilePath(projectPath, p)).sort(),
253
+ schedule_files: schedule.files.map((p) => toScheduleFilePath(projectPath, p)).sort(),
173
254
  event_files_count: events.length,
174
- default_scheduler_strategy: 'critical-first',
255
+ default_scheduler_strategy: "critical-first",
175
256
  derived_files: [
176
- 'agent-briefs/index.md',
177
- 'claim-next.json',
178
- 'cpm.json',
179
- 'cpm.md',
180
- 'critical-path.md',
181
- 'exec.jsonl',
182
- 'metadata.json',
183
- 'ready.json',
184
- 'ready.md',
185
- 'schedule-diff.md',
186
- 'schedule-hash.json',
187
- 'state.json',
188
- 'task-catalog.md',
189
- 'timeline.md',
190
- 'timeline.svg',
191
- ],
257
+ "claim-next.json",
258
+ "cpm.json",
259
+ "cpm.md",
260
+ "critical-path.md",
261
+ "exec.jsonl",
262
+ "metadata.json",
263
+ "ready.json",
264
+ "ready.md",
265
+ "schedule-diff.md",
266
+ "schedule-hash.json",
267
+ "state.json",
268
+ ...ganttChartFiles,
269
+ ].sort(),
192
270
  });
193
271
  return snapshot;
194
272
  }
@@ -1,45 +1,163 @@
1
- import { randomBytes } from 'node:crypto';
2
- import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from 'node:fs';
3
- import { basename, join, relative } from 'node:path';
4
- import yaml from 'js-yaml';
5
- import { specdojoRootDir } from './specdojo-config.js';
1
+ import { randomBytes } from "node:crypto";
2
+ import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
3
+ import { basename, join, relative } from "node:path";
4
+ import yaml from "js-yaml";
5
+ import { specdojoRootDir } from "./specdojo-config.js";
6
6
  export function nowUtcIsoSeconds() {
7
- return new Date().toISOString().replace(/\.\d{3}Z$/, 'Z');
7
+ return new Date().toISOString().replace(/\.\d{3}Z$/, "Z");
8
8
  }
9
9
  export function isUtcIsoSeconds(ts) {
10
10
  return /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$/.test(ts);
11
11
  }
12
12
  export function tsForFilenameUtc(ts) {
13
- return ts.replace(/[-:]/g, '').replace('T', 'T');
13
+ return ts.replace(/[-:]/g, "").replace("T", "T");
14
+ }
15
+ // worktree/branch 生成専用。project 修飾した task ID(`<projectId>:<taskId>`)を返す。
16
+ // projectId が未解決(env path override 等)の場合は bare のままにして後方互換を保つ。
17
+ // schedule 検索・plan/result ファイル名・claim には使わない(bare の task ID を使う)。
18
+ export function qualifyTaskId(projectId, taskId) {
19
+ return projectId ? `${projectId}:${taskId}` : taskId;
14
20
  }
15
21
  export function safeSlug(s) {
16
22
  return s
17
23
  .trim()
18
- .replace(/\s+/g, '-')
19
- .replace(/[^A-Za-z0-9._-]/g, '_')
24
+ .replace(/\s+/g, "-")
25
+ .replace(/[^A-Za-z0-9._-]/g, "_")
20
26
  .slice(0, 80);
21
27
  }
22
28
  export function randomHex(bytes) {
23
- return randomBytes(bytes).toString('hex');
29
+ return randomBytes(bytes).toString("hex");
24
30
  }
25
31
  export function ensureDir(path) {
26
32
  if (!existsSync(path))
27
33
  mkdirSync(path, { recursive: true });
28
34
  }
29
35
  export function requireNonEmpty(name, v) {
30
- if (typeof v !== 'string' || v.trim().length === 0)
36
+ if (typeof v !== "string" || v.trim().length === 0)
31
37
  throw new Error(`${name} is required`);
32
38
  return v.trim();
33
39
  }
34
40
  export function collectRepeatable(value, previous) {
35
41
  return previous.concat([value]);
36
42
  }
43
+ // CPM 由来の日数値(ES / EF / slack / duration 等)の表示用フォーマット。
44
+ // 浮動小数点誤差(例: 6.2509999999999994)を吸収し、小数点以下を最大2桁に丸める。
45
+ // JSON 等のデータ出力には使わず、Markdown 表示にのみ使う。
46
+ export function formatDays(value) {
47
+ return String(Math.round(value * 100) / 100);
48
+ }
49
+ // East Asian Wide / Fullwidth code point ranges. Characters in these ranges occupy two terminal
50
+ // columns, so they must count as 2 when aligning columns (e.g. Japanese task names in `exec status`).
51
+ const WIDE_CODE_POINT_RANGES = [
52
+ [0x1100, 0x115f], // Hangul Jamo
53
+ [0x2329, 0x232a], // angle brackets
54
+ [0x2e80, 0x303e], // CJK radicals, Kangxi, CJK symbols and punctuation
55
+ [0x3041, 0x33ff], // Hiragana, Katakana, CJK symbols, enclosed CJK
56
+ [0x3400, 0x4dbf], // CJK Unified Ideographs Extension A
57
+ [0x4e00, 0x9fff], // CJK Unified Ideographs
58
+ [0xa000, 0xa4cf], // Yi
59
+ [0xac00, 0xd7a3], // Hangul Syllables
60
+ [0xf900, 0xfaff], // CJK Compatibility Ideographs
61
+ [0xfe10, 0xfe19], // Vertical forms
62
+ [0xfe30, 0xfe6f], // CJK Compatibility Forms, Small Form Variants
63
+ [0xff00, 0xff60], // Fullwidth Forms
64
+ [0xffe0, 0xffe6], // Fullwidth signs
65
+ [0x1f300, 0x1faff], // Emoji and pictographs
66
+ [0x20000, 0x3fffd], // CJK Unified Ideographs Extension B and beyond
67
+ ];
68
+ function isWideCodePoint(cp) {
69
+ return WIDE_CODE_POINT_RANGES.some(([start, end]) => cp >= start && cp <= end);
70
+ }
71
+ // Returns the terminal display width of a string, counting East Asian Wide / Fullwidth characters
72
+ // as 2 columns and everything else as 1. Iterates by code point so surrogate pairs count once.
73
+ export function displayWidth(text) {
74
+ let width = 0;
75
+ for (const ch of text) {
76
+ width += isWideCodePoint(ch.codePointAt(0) ?? 0) ? 2 : 1;
77
+ }
78
+ return width;
79
+ }
80
+ // Pads a string on the right with spaces until it reaches the given display width. Uses
81
+ // displayWidth so full-width characters are accounted for; returns the string unchanged if it is
82
+ // already at least that wide.
83
+ export function padEndDisplay(text, width) {
84
+ const pad = width - displayWidth(text);
85
+ return pad > 0 ? text + " ".repeat(pad) : text;
86
+ }
87
+ export function expandTemplate(template, values) {
88
+ let result = template;
89
+ for (const [placeholder, value] of Object.entries(values)) {
90
+ result = result.split(placeholder).join(value);
91
+ }
92
+ // 置換値が改行で始まる場合(depends_on の入れ子リストなど)、template 側の
93
+ // `: _PLACEHOLDER_` の空白が行末に残る。生成 plan は prettier の整形対象外
94
+ // (.prettierignore)で checkpoint commit 時に markdownlint の MD009 が直接効くため、
95
+ // ここで行末の空白を取り除く。
96
+ return result.replace(/[ \t]+$/gm, "");
97
+ }
98
+ // 登録簿の自由記述(title / description 列など)を Markdown 本文へ埋め込む際の安全化。
99
+ // `register_date_timezone` のようなアンダースコア入り識別子や `_TODO_` / `_ASSUMPTION_` が、
100
+ // 強調記号(`_..._` / `*...*`)として誤解釈され、生成 plan が markdownlint の MD049
101
+ // (強調スタイル不統一)で失敗する事故を防ぐ。
102
+ //
103
+ // バックスラッシュエスケープ(`\_`)は使わない。生成パイプライン末尾の prettier が「不要」と
104
+ // 判定した抑制を正規化で除去してしまい、生のアンダースコアへ戻るためである。代わりに `_` や `*`
105
+ // を含む ASCII トークンをバッククォートの code span で包み、prettier を通しても安定させる。
106
+ // code span 内は強調解釈されないため MD049 を確実に回避できる。既存の code span は著者が意図した
107
+ // 記法として温存する。日本語などマルチバイト文字は ASCII トークン境界となり巻き込まない。
108
+ const MARKDOWN_CODE_SPAN = /(`+)[\s\S]*?\1/g;
109
+ // バックティック(0x60)を除く印字可能 ASCII の連続。空白とマルチバイト文字で区切られる。
110
+ const ASCII_RUN = /[\x21-\x5f\x61-\x7e]+/g;
111
+ function replaceOutsideMarkdownCodeSpans(text, replace) {
112
+ let result = "";
113
+ let lastIndex = 0;
114
+ for (const match of text.matchAll(MARKDOWN_CODE_SPAN)) {
115
+ const start = match.index ?? 0;
116
+ result += replace(text.slice(lastIndex, start));
117
+ result += match[0];
118
+ lastIndex = start + match[0].length;
119
+ }
120
+ result += replace(text.slice(lastIndex));
121
+ return result;
122
+ }
123
+ // Markdown コードスパン外にある山括弧トークンをインラインコード化する。
124
+ // 山括弧に連結する英数字・ハイフン・アンダースコア・ドットは、記述規約どおり同じ範囲で囲む。
125
+ // ドットを含めるのは `dct-<domain>.yaml` のような拡張子付きの参照を分断しないためだが、
126
+ // 文末の句点を巻き込まないよう、末尾のドットはコードスパンの外へ戻す。
127
+ export function inlineCodeAnglePlaceholders(text) {
128
+ const placeholder = /[A-Za-z0-9._-]*(?:<[^<>\r\n]+>[A-Za-z0-9._-]*)+/g;
129
+ const wrapToken = (token) => {
130
+ const trailing = token.match(/\.+$/)?.[0] ?? "";
131
+ const body = trailing ? token.slice(0, -trailing.length) : token;
132
+ return `\`${body}\`${trailing}`;
133
+ };
134
+ return replaceOutsideMarkdownCodeSpans(text, (segment) => segment.replace(placeholder, wrapToken));
135
+ }
136
+ export function escapeMarkdownInline(text) {
137
+ return replaceOutsideMarkdownCodeSpans(inlineCodeAnglePlaceholders(text), codeSpanRiskyTokens);
138
+ }
139
+ function codeSpanRiskyTokens(segment) {
140
+ return segment.replace(ASCII_RUN, (run) => (/[_*]/.test(run) ? `\`${run}\`` : run));
141
+ }
142
+ // ESC(0x1B) / CSI(0x9B) で始まる ANSI エスケープシーケンス(SGR の色指定や OSC など)。
143
+ // lefthook などが失敗時に返す色付きボックス UI の制御コードを表す。ansi-regex 相当。
144
+ const ANSI_ESCAPE = /[\u001b\u009b][[\]()#;?]*(?:(?:(?:[a-zA-Z\d]*(?:;[a-zA-Z\d]*)*)?\u0007)|(?:(?:\d{1,4}(?:;\d{0,4})*)?[\dA-PR-TZcf-ntqry=><~]))/g;
145
+ // タブ(0x09)・改行(0x0A)・復帰(0x0D) を除く C0/C1 制御文字。改行類は呼び出し側で
146
+ // 1 行化などの整形を行うため、ここでは残す。
147
+ const CONTROL_CHARS = /[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f-\u009f]/g;
148
+ // subprocess の生出力をユーザー向け文字列(Markdown の表セル・result の理由欄など)へ
149
+ // 埋め込む前に、ANSI エスケープシーケンスとその他のターミナル制御文字を除去する。
150
+ // これを怠ると色付き出力を返すコマンド(lefthook 等)の失敗理由が制御コードごと
151
+ // 書き込まれ、表示や Markdown 構造が壊れる。
152
+ export function stripTerminalControlSequences(text) {
153
+ return text.replace(ANSI_ESCAPE, "").replace(CONTROL_CHARS, "");
154
+ }
37
155
  export function parseKeyValuePairs(pairs) {
38
156
  if (!pairs || pairs.length === 0)
39
157
  return undefined;
40
158
  const out = {};
41
159
  for (const p of pairs) {
42
- const idx = p.indexOf('=');
160
+ const idx = p.indexOf("=");
43
161
  if (idx <= 0)
44
162
  throw new Error(`Invalid key=value: ${p}`);
45
163
  const k = p.slice(0, idx).trim();
@@ -65,19 +183,22 @@ export function listFilesRecursive(dir) {
65
183
  return out;
66
184
  }
67
185
  export function readJson(path) {
68
- return JSON.parse(readFileSync(path, 'utf8'));
186
+ return JSON.parse(readFileSync(path, "utf8"));
187
+ }
188
+ export function isRecord(value) {
189
+ return typeof value === "object" && value !== null && !Array.isArray(value);
190
+ }
191
+ export function isStringArray(value) {
192
+ return Array.isArray(value) && value.every((item) => typeof item === "string");
69
193
  }
70
194
  export function writeJson(path, data) {
71
- writeFileSync(path, JSON.stringify(data, null, 2) + '\n', 'utf8');
195
+ writeFileSync(path, JSON.stringify(data, null, 2) + "\n", "utf8");
72
196
  }
73
197
  export function readYaml(path) {
74
- return yaml.load(readFileSync(path, 'utf8'));
198
+ return yaml.load(readFileSync(path, "utf8"));
75
199
  }
76
200
  export function isSchYamlFilename(path) {
77
201
  const name = basename(path);
78
- // Exclude defaults file
79
- if (name === 'sch-defaults.yaml' || name === 'sch-defaults.yml')
80
- return false;
81
202
  return /^sch-.*\.(yaml|yml)$/.test(name);
82
203
  }
83
204
  export function sleepMs(ms) {
@@ -86,25 +207,25 @@ export function sleepMs(ms) {
86
207
  Atomics.wait(int32, 0, 0, ms);
87
208
  }
88
209
  export function toPortablePath(path) {
89
- return path.replace(/\\/g, '/');
210
+ return path.replace(/\\/g, "/");
90
211
  }
91
212
  export function toArtifactPath(path) {
92
213
  const rel = relative(specdojoRootDir(), path);
93
- return toPortablePath(rel || '.');
214
+ return toPortablePath(rel || ".");
94
215
  }
95
216
  export function toScheduleFilePath(schedulePath, filePath) {
96
- return toPortablePath(relative(schedulePath, filePath) || '.');
217
+ return toPortablePath(relative(schedulePath, filePath) || ".");
97
218
  }
98
219
  export function formatDateOnlyUtc(dt) {
99
- const yyyy = dt.getUTCFullYear().toString().padStart(4, '0');
100
- const mm = (dt.getUTCMonth() + 1).toString().padStart(2, '0');
101
- const dd = dt.getUTCDate().toString().padStart(2, '0');
220
+ const yyyy = dt.getUTCFullYear().toString().padStart(4, "0");
221
+ const mm = (dt.getUTCMonth() + 1).toString().padStart(2, "0");
222
+ const dd = dt.getUTCDate().toString().padStart(2, "0");
102
223
  return `${yyyy}-${mm}-${dd}`;
103
224
  }
104
225
  export function normalizeDateOnly(value) {
105
226
  if (value instanceof Date && !Number.isNaN(value.getTime()))
106
227
  return formatDateOnlyUtc(value);
107
- if (typeof value !== 'string')
228
+ if (typeof value !== "string")
108
229
  return null;
109
230
  const trimmed = value.trim();
110
231
  if (!trimmed)