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
@@ -0,0 +1,471 @@
1
+ // DCT plan (dct-plan-<domain>.yaml): the agent judgment artifact that precedes catalog
2
+ // generation. The agent decides which deliverable instances a domain needs, which template
3
+ // placeholders resolve to which values, which candidates are excluded, and what stays
4
+ // undecided. This module owns the plan's canonical location, schema validation, semantic
5
+ // rules, skeleton scaffolding, and overwrite protection. Catalog structure (groups,
6
+ // base_path, done_criteria) stays in the DCT template and is never copied into a plan.
7
+ import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
8
+ import { basename, join, resolve } from "node:path";
9
+ import yaml from "js-yaml";
10
+ import { resolveSpecdojoPath, specdojoDirectoryPaths } from "./template-resolution.js";
11
+ import Ajv2020Module from "ajv/dist/2020.js";
12
+ import { collectResolvedDeliverables, loadCatalogDocs } from "./catalog-build.js";
13
+ import { isTrashedPath, resolveBasePath } from "./catalog-paths.js";
14
+ export const DCT_PLAN_SCHEMA_VERSION = 1;
15
+ export const DCT_PLAN_SCHEMA_PATH = "docs/specdojo/schemas/v1/dct-plan.schema.yaml";
16
+ const PLACEHOLDER_RE = /_([A-Z][A-Z0-9_]*)_/g;
17
+ const DATA_FLOW_DOMAIN = "data-flow";
18
+ function isRecord(value) {
19
+ return typeof value === "object" && value !== null && !Array.isArray(value);
20
+ }
21
+ export function planFileName(domain) {
22
+ return `dct-plan-${domain}.yaml`;
23
+ }
24
+ // Plans live in a dedicated directory so catalog validate / build, which read
25
+ // dct-*.yaml directly under the catalog directory, never treat them as catalogs.
26
+ export function resolvePlansDir(catalogPath) {
27
+ return join(catalogPath, "plans");
28
+ }
29
+ export function resolvePlanPath(catalogPath, domain) {
30
+ return join(resolvePlansDir(catalogPath), planFileName(domain));
31
+ }
32
+ // Plan files share the `dct-` prefix with catalogs, so every catalog file scan that
33
+ // walks subdirectories must exclude them explicitly.
34
+ export function isDctPlanFileName(fileName) {
35
+ return /^dct-plan-.+\.ya?ml$/i.test(basename(fileName));
36
+ }
37
+ export function domainFromPlanFileName(fileName) {
38
+ const match = basename(fileName).match(/^dct-plan-(.+)\.yaml$/);
39
+ return match ? match[1] : null;
40
+ }
41
+ // ---- schema validation -------------------------------------------------------
42
+ const Ajv2020 = Ajv2020Module.default;
43
+ let compiledSchemaCache = null;
44
+ function compilePlanSchema(repoRoot) {
45
+ const schemaPath = resolveSpecdojoPath(DCT_PLAN_SCHEMA_PATH, { repositoryRoot: repoRoot });
46
+ if (compiledSchemaCache && compiledSchemaCache.schemaPath === schemaPath) {
47
+ return compiledSchemaCache.validate;
48
+ }
49
+ let schema;
50
+ try {
51
+ schema = yaml.load(readFileSync(schemaPath, "utf8"));
52
+ }
53
+ catch (error) {
54
+ throw new Error(`Failed to read DCT plan schema: ${schemaPath} (${error instanceof Error ? error.message : String(error)})`);
55
+ }
56
+ const validate = new Ajv2020({ allErrors: true, strict: false }).compile(schema);
57
+ compiledSchemaCache = { schemaPath, validate };
58
+ return validate;
59
+ }
60
+ // Validates a parsed plan against dct-plan.schema.yaml. Returns human-readable errors
61
+ // with the failing instance path so an agent can fix the exact field.
62
+ export function validatePlanSchema(plan, repoRoot) {
63
+ const validate = compilePlanSchema(repoRoot);
64
+ if (validate(plan))
65
+ return [];
66
+ return (validate.errors ?? []).map((error) => {
67
+ const at = error.instancePath || "/";
68
+ const params = isRecord(error.params) ? error.params : {};
69
+ // Ajv omits the offending key from the message for these keywords, which is exactly
70
+ // the detail an agent needs to fix its output.
71
+ const detail = typeof params.additionalProperty === "string"
72
+ ? ` (${params.additionalProperty})`
73
+ : typeof params.missingProperty === "string"
74
+ ? ` (${params.missingProperty})`
75
+ : Array.isArray(params.allowedValues)
76
+ ? ` (allowed: ${params.allowedValues.join(", ")})`
77
+ : "";
78
+ return `${at}: ${error.message ?? "schema violation"}${detail}`;
79
+ });
80
+ }
81
+ // ---- template lookup ---------------------------------------------------------
82
+ // All templates that declare the domain, in file name order. A domain physically split into
83
+ // dct-<domain>-<part>-template.yaml keeps one template per part (dct-rulebook,
84
+ // 物理分割(1 ドメイン複数ファイル)), so callers that generate catalogs must handle the list.
85
+ export function loadTemplatesForDomain(templatesPath, domain, repoRoot) {
86
+ const resolvedDirectories = specdojoDirectoryPaths("docs/ja/specdojo/templates", {
87
+ repositoryRoot: repoRoot,
88
+ });
89
+ const directories = resolvedDirectories.includes(resolve(templatesPath))
90
+ ? resolvedDirectories
91
+ : [templatesPath];
92
+ const files = new Map();
93
+ for (const directory of directories) {
94
+ for (const file of readdirSync(directory).filter((entry) => /^dct-.+\.yaml$/.test(entry))) {
95
+ if (!files.has(file))
96
+ files.set(file, join(directory, file));
97
+ }
98
+ }
99
+ const loaded = [];
100
+ for (const [file, filePath] of [...files].sort(([a], [b]) => a.localeCompare(b))) {
101
+ let template;
102
+ try {
103
+ template = yaml.load(readFileSync(filePath, "utf8"));
104
+ }
105
+ catch {
106
+ continue;
107
+ }
108
+ if (!template || template.domain !== domain)
109
+ continue;
110
+ loaded.push({ file, relPath: toRepoRelative(filePath, repoRoot), template });
111
+ }
112
+ return loaded;
113
+ }
114
+ export function loadTemplateForDomain(templatesPath, domain, repoRoot) {
115
+ return loadTemplatesForDomain(templatesPath, domain, repoRoot)[0] ?? null;
116
+ }
117
+ export function collectTemplateEntries(sections) {
118
+ const entries = new Map();
119
+ const walk = (nodes) => {
120
+ for (const node of nodes) {
121
+ for (const item of node.deliverables ?? [])
122
+ entries.set(item.local_id, item);
123
+ if (node.groups)
124
+ walk(node.groups);
125
+ }
126
+ };
127
+ walk(sections);
128
+ return entries;
129
+ }
130
+ export function placeholderNames(value) {
131
+ return [...value.matchAll(PLACEHOLDER_RE)].map((match) => match[1]);
132
+ }
133
+ export function expandPlaceholders(value, variables) {
134
+ return value.replace(PLACEHOLDER_RE, (placeholder, name) => Object.hasOwn(variables, name) ? variables[name] : placeholder);
135
+ }
136
+ function toRepoRelative(absolutePath, repoRoot) {
137
+ const normalizedRoot = repoRoot.replace(/\\/g, "/").replace(/\/$/, "");
138
+ const normalized = absolutePath.replace(/\\/g, "/");
139
+ return normalized.startsWith(`${normalizedRoot}/`)
140
+ ? normalized.slice(normalizedRoot.length + 1)
141
+ : normalized;
142
+ }
143
+ // Collects the documents an agent may read for a domain:
144
+ // - every existing data-flow deliverable document (the primary judgment source)
145
+ // - the already generated dct-<domain>.yaml, when the domain was cataloged before
146
+ // - explicitly passed upstream documents (--input)
147
+ // A domain without any data-flow document is an error rather than a silent empty input
148
+ // set, so the agent never has to guess the instances from the template alone.
149
+ export function resolvePlanInputs(opts) {
150
+ const { catalogPath, repoRoot, domain } = opts;
151
+ const warnings = [];
152
+ const errors = [];
153
+ const inputs = [];
154
+ const loaded = loadCatalogDocs(catalogPath);
155
+ const dataFlowPaths = new Set();
156
+ for (const { doc } of loaded) {
157
+ if (doc.domain !== DATA_FLOW_DOMAIN)
158
+ continue;
159
+ const resolved = [];
160
+ collectResolvedDeliverables(doc.groups, resolveBasePath("", doc.base_path), resolved);
161
+ for (const { item, resolvedPath } of resolved) {
162
+ if (item.kind !== "work")
163
+ continue;
164
+ // Deprecated documents keep their catalog entry but move under trash/;
165
+ // they must not become judgment evidence.
166
+ if (isTrashedPath(resolvedPath))
167
+ continue;
168
+ if (!existsSync(join(repoRoot, resolvedPath))) {
169
+ warnings.push(`data-flow document not found on disk (skipped): ${resolvedPath}`);
170
+ continue;
171
+ }
172
+ dataFlowPaths.add(resolvedPath);
173
+ }
174
+ }
175
+ for (const path of [...dataFlowPaths].sort()) {
176
+ inputs.push({ kind: DATA_FLOW_DOMAIN, path });
177
+ }
178
+ for (const { doc, filePath } of loaded) {
179
+ if (doc.domain !== domain)
180
+ continue;
181
+ inputs.push({
182
+ kind: "existing-catalog",
183
+ ...(doc.id ? { id: doc.id } : {}),
184
+ path: toRepoRelative(filePath, repoRoot),
185
+ note: "既存カタログ。既存 local_id を落とす場合は exclusions に理由を残す",
186
+ });
187
+ warnings.push(`domain '${domain}' already has a catalog: ${toRepoRelative(filePath, repoRoot)}. ` +
188
+ `Treat it as a baseline and review the diff before regenerating.`);
189
+ }
190
+ for (const extra of [...new Set(opts.extraInputs ?? [])].sort()) {
191
+ const relPath = toRepoRelative(extra, repoRoot);
192
+ if (!existsSync(join(repoRoot, relPath))) {
193
+ errors.push(`--input not found: ${relPath}`);
194
+ continue;
195
+ }
196
+ inputs.push({ kind: "upstream-deliverable", path: relPath });
197
+ }
198
+ if (dataFlowPaths.size === 0 && (opts.extraInputs ?? []).length === 0) {
199
+ errors.push(`No data-flow document found for domain '${domain}'.\n` +
200
+ `Create the data-flow catalog and documents first, or pass explicit upstream ` +
201
+ `documents with --input <path>.`);
202
+ }
203
+ return { inputs, warnings, errors };
204
+ }
205
+ // ---- skeleton ----------------------------------------------------------------
206
+ export function buildPlanSkeleton(opts) {
207
+ const { projectId, domain, template, inputs } = opts;
208
+ return {
209
+ id: `${projectId}:dct-plan-${domain}`,
210
+ type: "project",
211
+ status: "draft",
212
+ title: `成果物カタログ判定計画(${domain})`,
213
+ rulebook: "none",
214
+ schema_version: DCT_PLAN_SCHEMA_VERSION,
215
+ project_id: projectId,
216
+ domain,
217
+ template,
218
+ inputs,
219
+ // dct-rulebook treats pattern-a as the default; the agent switches to pattern-b when
220
+ // a single business area is split into fixed local_ids.
221
+ iteration_pattern: "pattern-a",
222
+ deliverables: [],
223
+ exclusions: [],
224
+ open_questions: [
225
+ {
226
+ topic: domain,
227
+ question: `domain '${domain}' の成果物インスタンスを判定する`,
228
+ blocking: true,
229
+ reason: "agent 判定が未実施のため、成果物インスタンスが未確定",
230
+ next_action: `specdojo catalog plan prompt --domain ${domain} の指示で agent 判定を行う`,
231
+ },
232
+ ],
233
+ confidence: "low",
234
+ };
235
+ }
236
+ function variableMap(plan, deliverable) {
237
+ const map = {};
238
+ for (const variable of plan.variables ?? [])
239
+ map[variable.name] = variable.value;
240
+ for (const variable of deliverable.variables ?? [])
241
+ map[variable.name] = variable.value;
242
+ return map;
243
+ }
244
+ // Semantic rules that the JSON schema cannot express: file/domain agreement, template
245
+ // traceability, placeholder resolution, pattern A/B distinction, local_id uniqueness,
246
+ // and dependency resolution.
247
+ export function validateDctPlan(plan, options = {}) {
248
+ const errors = [];
249
+ const warnings = [];
250
+ const prefix = plan.domain ? `dct-plan-${plan.domain}.yaml` : "dct-plan";
251
+ if (options.fileName) {
252
+ const fileDomain = domainFromPlanFileName(options.fileName);
253
+ if (fileDomain && fileDomain !== plan.domain) {
254
+ errors.push(`${options.fileName}: domain '${plan.domain}' does not match the file name domain '${fileDomain}'.`);
255
+ }
256
+ }
257
+ if (options.template && options.template.domain !== plan.domain) {
258
+ errors.push(`${prefix}: template domain '${options.template.domain}' does not match plan domain '${plan.domain}'.`);
259
+ }
260
+ if (plan.id !== `${plan.project_id}:dct-plan-${plan.domain}`) {
261
+ errors.push(`${prefix}: id must be '${plan.project_id}:dct-plan-${plan.domain}' (found '${plan.id}').`);
262
+ }
263
+ const templateEntries = options.template
264
+ ? collectTemplateEntries(options.template.groups)
265
+ : new Map();
266
+ const seen = new Map();
267
+ plan.deliverables.forEach((deliverable, index) => {
268
+ const where = `${prefix}: deliverables[${index}] (${deliverable.local_id})`;
269
+ const previous = seen.get(deliverable.local_id);
270
+ if (previous !== undefined) {
271
+ errors.push(`${where}: duplicate local_id (already defined at deliverables[${previous}]).`);
272
+ }
273
+ else {
274
+ seen.set(deliverable.local_id, index);
275
+ }
276
+ if (options.template && !templateEntries.has(deliverable.template_local_id)) {
277
+ errors.push(`${where}: template_local_id '${deliverable.template_local_id}' is not defined in ${options.template.id}.`);
278
+ }
279
+ const templatePlaceholders = placeholderNames(deliverable.template_local_id);
280
+ const variables = variableMap(plan, deliverable);
281
+ const expanded = expandPlaceholders(deliverable.template_local_id, variables);
282
+ if (plan.iteration_pattern === "pattern-a") {
283
+ if (templatePlaceholders.length === 0) {
284
+ errors.push(`${where}: pattern-a requires a placeholder in template_local_id ` +
285
+ `(e.g. cdfd-_TERM_); '${deliverable.template_local_id}' has none. ` +
286
+ `Use iteration_pattern: pattern-b for fixed template entries.`);
287
+ }
288
+ const missing = templatePlaceholders.filter((name) => !Object.hasOwn(variables, name));
289
+ if (missing.length > 0) {
290
+ errors.push(`${where}: unresolved placeholder(s) ${missing.map((name) => `_${name}_`).join(", ")}. ` +
291
+ `Record the value with evidence in variables, or drop the deliverable and ` +
292
+ `record it in open_questions instead of guessing.`);
293
+ }
294
+ else if (expanded !== deliverable.local_id) {
295
+ errors.push(`${where}: local_id must equal the expanded template_local_id ('${expanded}').`);
296
+ }
297
+ }
298
+ else {
299
+ if ((deliverable.variables ?? []).length > 0) {
300
+ errors.push(`${where}: pattern-b entries must not define variables; use a fixed local_id per processing unit.`);
301
+ }
302
+ if (templatePlaceholders.length > 0 && expanded === deliverable.template_local_id) {
303
+ warnings.push(`${where}: template_local_id '${deliverable.template_local_id}' still carries a placeholder; ` +
304
+ `pattern-b uses it only as the derivation source.`);
305
+ }
306
+ }
307
+ if (placeholderNames(deliverable.local_id).length > 0) {
308
+ errors.push(`${where}: local_id still contains an unresolved placeholder.`);
309
+ }
310
+ if (deliverable.confidence === "low") {
311
+ warnings.push(`${where}: confidence is low; a human must confirm before generation.`);
312
+ }
313
+ });
314
+ const planLocalIds = new Set(plan.deliverables.map((deliverable) => deliverable.local_id));
315
+ plan.deliverables.forEach((deliverable, index) => {
316
+ for (const dependency of deliverable.depends_on ?? []) {
317
+ if (planLocalIds.has(dependency))
318
+ continue;
319
+ if (options.knownLocalIds?.has(dependency))
320
+ continue;
321
+ errors.push(`${prefix}: deliverables[${index}] (${deliverable.local_id}): depends_on '${dependency}' ` +
322
+ `is neither planned here nor present in the project catalog.`);
323
+ }
324
+ });
325
+ for (const question of plan.open_questions) {
326
+ if (question.blocking) {
327
+ warnings.push(`${prefix}: blocking open question (${question.topic}): ${question.question}. ` +
328
+ `Catalog generation stops until it is answered.`);
329
+ }
330
+ }
331
+ if (plan.deliverables.length === 0) {
332
+ warnings.push(`${prefix}: no deliverables planned yet (skeleton state).`);
333
+ }
334
+ if (plan.confidence === "low") {
335
+ warnings.push(`${prefix}: overall confidence is low; review the plan before generation.`);
336
+ }
337
+ return { ok: errors.length === 0, errors, warnings };
338
+ }
339
+ // ---- serialization -----------------------------------------------------------
340
+ const PLAN_KEY_ORDER = [
341
+ "id",
342
+ "type",
343
+ "status",
344
+ "title",
345
+ "rulebook",
346
+ "part_of",
347
+ "schema_version",
348
+ "project_id",
349
+ "domain",
350
+ "template",
351
+ "inputs",
352
+ "iteration_pattern",
353
+ "variables",
354
+ "deliverables",
355
+ "exclusions",
356
+ "open_questions",
357
+ "confidence",
358
+ "notes",
359
+ ];
360
+ // Re-emits a plan with a fixed key order so re-running the agent produces reviewable
361
+ // diffs instead of noise from arbitrary key ordering.
362
+ export function normalizePlan(plan) {
363
+ const source = plan;
364
+ const normalized = {};
365
+ for (const key of PLAN_KEY_ORDER) {
366
+ if (source[key] !== undefined)
367
+ normalized[key] = source[key];
368
+ }
369
+ for (const key of Object.keys(source)) {
370
+ if (!Object.hasOwn(normalized, key))
371
+ normalized[key] = source[key];
372
+ }
373
+ return normalized;
374
+ }
375
+ export function dumpPlan(plan) {
376
+ return yaml.dump(normalizePlan(plan), {
377
+ lineWidth: 120,
378
+ noRefs: true,
379
+ quotingType: "'",
380
+ forceQuotes: false,
381
+ });
382
+ }
383
+ export function parsePlan(content, filePath) {
384
+ let parsed;
385
+ try {
386
+ parsed = yaml.load(content);
387
+ }
388
+ catch (error) {
389
+ throw new Error(`${filePath}: failed to parse YAML (${error instanceof Error ? error.message : String(error)})`);
390
+ }
391
+ if (!isRecord(parsed)) {
392
+ throw new Error(`${filePath}: plan must be a YAML mapping.`);
393
+ }
394
+ return parsed;
395
+ }
396
+ export function loadPlan(filePath) {
397
+ return parsePlan(readFileSync(filePath, "utf8"), filePath);
398
+ }
399
+ // ---- diff --------------------------------------------------------------------
400
+ // Minimal LCS line diff so an existing plan is never overwritten without the operator
401
+ // seeing what would change.
402
+ export function diffPlanText(current, next) {
403
+ const splitLines = (text) => text === "" ? [] : text.replace(/\n$/, "").split("\n");
404
+ const before = splitLines(current);
405
+ const after = splitLines(next);
406
+ const lengths = Array.from({ length: before.length + 1 }, () => new Array(after.length + 1).fill(0));
407
+ for (let i = before.length - 1; i >= 0; i--) {
408
+ for (let j = after.length - 1; j >= 0; j--) {
409
+ lengths[i][j] =
410
+ before[i] === after[j]
411
+ ? lengths[i + 1][j + 1] + 1
412
+ : Math.max(lengths[i + 1][j], lengths[i][j + 1]);
413
+ }
414
+ }
415
+ const lines = [];
416
+ let i = 0;
417
+ let j = 0;
418
+ while (i < before.length && j < after.length) {
419
+ if (before[i] === after[j]) {
420
+ i++;
421
+ j++;
422
+ continue;
423
+ }
424
+ if (lengths[i + 1][j] >= lengths[i][j + 1]) {
425
+ lines.push(`- ${before[i++]}`);
426
+ }
427
+ else {
428
+ lines.push(`+ ${after[j++]}`);
429
+ }
430
+ }
431
+ while (i < before.length)
432
+ lines.push(`- ${before[i++]}`);
433
+ while (j < after.length)
434
+ lines.push(`+ ${after[j++]}`);
435
+ return lines;
436
+ }
437
+ // Writes a plan to its canonical path. An existing plan is protected: the write is
438
+ // skipped and the diff is returned for review unless force is set.
439
+ export function writePlan(opts) {
440
+ const { catalogPath, plan, force, dryRun } = opts;
441
+ const path = resolvePlanPath(catalogPath, plan.domain);
442
+ const next = dumpPlan(plan);
443
+ if (existsSync(path)) {
444
+ const current = readFileSync(path, "utf8");
445
+ const diff = diffPlanText(current, next);
446
+ if (diff.length === 0) {
447
+ return { path, written: false, skippedReason: "unchanged", diff };
448
+ }
449
+ if (!force) {
450
+ return { path, written: false, skippedReason: "exists", diff };
451
+ }
452
+ if (dryRun) {
453
+ return { path, written: false, skippedReason: "dry-run", diff };
454
+ }
455
+ writeFileSync(path, next, "utf8");
456
+ return { path, written: true, diff };
457
+ }
458
+ const diff = diffPlanText("", next);
459
+ if (dryRun) {
460
+ return { path, written: false, skippedReason: "dry-run", diff };
461
+ }
462
+ mkdirSync(resolvePlansDir(catalogPath), { recursive: true });
463
+ writeFileSync(path, next, "utf8");
464
+ return { path, written: true, diff };
465
+ }
466
+ export function listPlanFiles(catalogPath) {
467
+ const plansDir = resolvePlansDir(catalogPath);
468
+ if (!existsSync(plansDir))
469
+ return [];
470
+ return readdirSync(plansDir).filter(isDctPlanFileName).sort();
471
+ }