specdojo 0.1.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (540) hide show
  1. package/LICENSE +22 -0
  2. package/README.md +142 -35
  3. package/dist/agent-response.js +27 -0
  4. package/dist/agent.js +124 -0
  5. package/dist/build-command.js +149 -0
  6. package/dist/build-if-stale.js +35 -0
  7. package/dist/catalog-build.js +1079 -0
  8. package/dist/catalog-generate.js +226 -0
  9. package/dist/catalog-paths.js +31 -0
  10. package/dist/catalog-plan-generate.js +301 -0
  11. package/dist/catalog-plan-prompt.js +73 -0
  12. package/dist/catalog-plan.js +471 -0
  13. package/dist/catalog-scaffold.js +255 -0
  14. package/dist/catalog-types.js +4 -0
  15. package/dist/catalog.js +606 -0
  16. package/dist/dashboard.js +990 -0
  17. package/dist/deliverable-trash.js +148 -0
  18. package/dist/deliverable.js +97 -0
  19. package/dist/dist-freshness.js +150 -0
  20. package/dist/doc-index.js +424 -0
  21. package/dist/exec-agent-config.js +172 -0
  22. package/dist/exec-agent-git-state.js +136 -0
  23. package/dist/exec-agent-protected-config.js +276 -0
  24. package/dist/exec-events.js +250 -112
  25. package/dist/exec-evidence.js +317 -0
  26. package/dist/exec-format.js +54 -0
  27. package/dist/exec-limit.js +202 -0
  28. package/dist/exec-parent-validation.js +169 -0
  29. package/dist/exec-pipeline-state.js +160 -0
  30. package/dist/exec-plans.js +1016 -0
  31. package/dist/exec-project.js +25 -11
  32. package/dist/exec-protection-handoff.js +169 -0
  33. package/dist/exec-provider-scaffold.js +99 -0
  34. package/dist/exec-register-resume.js +196 -0
  35. package/dist/exec-register.js +281 -0
  36. package/dist/exec-reporter.js +329 -0
  37. package/dist/exec-results.js +510 -0
  38. package/dist/exec-run-lock.js +149 -0
  39. package/dist/exec-run.js +4953 -0
  40. package/dist/exec-schedule-calendar.js +86 -9
  41. package/dist/exec-schedule-cpm.js +30 -12
  42. package/dist/exec-schedule-gantt-chart-render.js +428 -0
  43. package/dist/exec-schedule-gantt-chart-scope.js +111 -0
  44. package/dist/exec-schedule-gantt-chart.js +2 -0
  45. package/dist/exec-schedule-hash.js +34 -25
  46. package/dist/exec-schedule-index.js +200 -67
  47. package/dist/exec-schedule-initial.js +100 -0
  48. package/dist/exec-schedule-progress.js +51 -26
  49. package/dist/exec-schedule-ready.js +71 -27
  50. package/dist/exec-schedule.js +171 -93
  51. package/dist/exec-shared.js +146 -25
  52. package/dist/exec-strategy.js +547 -0
  53. package/dist/exec-task-view.js +64 -0
  54. package/dist/exec-trial.js +895 -0
  55. package/dist/exec-worktree-command.js +426 -0
  56. package/dist/exec-worktree-ops.js +847 -0
  57. package/dist/exec-worktree.js +359 -0
  58. package/dist/exec.js +744 -192
  59. package/dist/frontmatter-namespace.js +48 -0
  60. package/dist/git-environment.js +23 -0
  61. package/dist/grade-result.js +137 -0
  62. package/dist/grade.js +2456 -0
  63. package/dist/index-command.js +103 -0
  64. package/dist/job.js +1081 -0
  65. package/dist/kata-command.js +303 -0
  66. package/dist/kata.js +187 -0
  67. package/dist/package-paths.js +33 -0
  68. package/dist/practice-id.js +24 -0
  69. package/dist/register-date.js +122 -0
  70. package/dist/register-events.js +363 -0
  71. package/dist/register-history.js +323 -0
  72. package/dist/register-item.js +455 -0
  73. package/dist/register-migrate-timestamps.js +176 -0
  74. package/dist/register.js +2199 -0
  75. package/dist/review-plan.js +199 -0
  76. package/dist/review-types.js +1 -0
  77. package/dist/role-types.js +1 -0
  78. package/dist/routine.js +814 -0
  79. package/dist/schedule-approach.js +252 -0
  80. package/dist/schedule-build.js +552 -0
  81. package/dist/schedule-phase-sets.js +73 -0
  82. package/dist/schedule-strategy-generate.js +812 -0
  83. package/dist/schedule-strategy-profiles.js +276 -0
  84. package/dist/schedule.js +420 -0
  85. package/dist/spawn-self.js +28 -0
  86. package/dist/specdojo-config.js +133 -39
  87. package/dist/specdojo.js +56 -7
  88. package/dist/template-frontmatter.js +89 -0
  89. package/dist/template-resolution.js +92 -0
  90. package/dist/timeline-build.js +334 -0
  91. package/dist/timeline.js +107 -0
  92. package/dist/watch.js +313 -0
  93. package/dist/yaml-pages-command.js +28 -0
  94. package/dist/yaml-pages.js +180 -0
  95. package/dist/yaml-schema-modeline.js +49 -0
  96. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +600 -0
  97. package/docs/ja/specdojo/exec-templates/xep-bootstrap-template.md +120 -0
  98. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +37 -0
  99. package/docs/ja/specdojo/exec-templates/xep-cross-deliverable-dedup-template.md +51 -0
  100. package/docs/ja/specdojo/exec-templates/xep-freeform-template.md +74 -0
  101. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +109 -0
  102. package/docs/ja/specdojo/exec-templates/xep-job-template.md +43 -0
  103. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +82 -0
  104. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +86 -0
  105. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +42 -0
  106. package/docs/ja/specdojo/exec-templates/xep-register-template.md +49 -0
  107. package/docs/ja/specdojo/exec-templates/xep-retrofit-template.md +98 -0
  108. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +86 -0
  109. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +86 -0
  110. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +86 -0
  111. package/docs/ja/specdojo/exec-templates/xep-template.md +66 -0
  112. package/docs/ja/specdojo/exec-templates/xer-cross-deliverable-dedup-template.md +31 -0
  113. package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +40 -0
  114. package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +30 -0
  115. package/docs/ja/specdojo/exec-templates/xer-template.md +19 -0
  116. package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +70 -0
  117. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +97 -0
  118. package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +76 -0
  119. package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +73 -0
  120. package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +74 -0
  121. package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +74 -0
  122. package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +73 -0
  123. package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +73 -0
  124. package/docs/ja/specdojo/exec-templates/xrp-template.md +67 -0
  125. package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +7 -0
  126. package/docs/ja/specdojo/exec-templates/xrr-template.md +21 -0
  127. package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +7 -0
  128. package/docs/ja/specdojo/guides/branch-workflow-guide.md +354 -0
  129. package/docs/ja/specdojo/guides/docs-editing-guide.md +327 -0
  130. package/docs/ja/specdojo/guides/docs-structure-guide.md +519 -0
  131. package/docs/ja/specdojo/guides/exec-config-guide.md +589 -0
  132. package/docs/ja/specdojo/guides/exec-operation-guide.md +440 -0
  133. package/docs/ja/specdojo/guides/exec-worktree-guide.md +318 -0
  134. package/docs/ja/specdojo/guides/kata-guide.md +89 -0
  135. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +127 -0
  136. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +228 -0
  137. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +111 -0
  138. package/docs/ja/specdojo/guides/quick-start-guide.md +472 -0
  139. package/docs/ja/specdojo/guides/register-operation-guide.md +418 -0
  140. package/docs/ja/specdojo/guides/remote-host-development-guide.md +163 -0
  141. package/docs/ja/specdojo/guides/review-guide.md +428 -0
  142. package/docs/ja/specdojo/guides/routine-operation-guide.md +282 -0
  143. package/docs/ja/specdojo/guides/ryu-guide.md +230 -0
  144. package/docs/ja/specdojo/guides/schedule-design-guide.md +429 -0
  145. package/docs/ja/specdojo/guides/schedule-operation-guide.md +151 -0
  146. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +257 -0
  147. package/docs/ja/specdojo/guides/timeline-design-guide.md +160 -0
  148. package/docs/ja/specdojo/guides/track-design-guide.md +215 -0
  149. package/docs/ja/specdojo/guides/use-case-guide.md +133 -0
  150. package/docs/ja/specdojo/guides/waza-guide.md +224 -0
  151. package/docs/ja/specdojo/index.md +33 -0
  152. package/docs/ja/specdojo/philosophy/needs-to-implementation-philosophy.md +212 -0
  153. package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +242 -0
  154. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +198 -0
  155. package/docs/ja/specdojo/recipes/cdfd-recipe.md +218 -0
  156. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +198 -0
  157. package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +100 -0
  158. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +148 -0
  159. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +97 -0
  160. package/docs/ja/specdojo/recipes/pm-members-recipe.md +149 -0
  161. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +96 -0
  162. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +98 -0
  163. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +97 -0
  164. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +96 -0
  165. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +136 -0
  166. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +162 -0
  167. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +187 -0
  168. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +235 -0
  169. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +205 -0
  170. package/docs/ja/specdojo/recipes/prj-overview-recipe.md +289 -0
  171. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +201 -0
  172. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +168 -0
  173. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +179 -0
  174. package/docs/ja/specdojo/recipes/stsd-recipe.md +138 -0
  175. package/docs/ja/specdojo/references/command-reference.md +718 -0
  176. package/docs/ja/specdojo/references/deliverables-reference.md +407 -0
  177. package/docs/ja/specdojo/references/directory-layout-reference.md +280 -0
  178. package/docs/ja/specdojo/references/specdojo-config-reference.md +133 -0
  179. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +372 -0
  180. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +302 -0
  181. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +331 -0
  182. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +134 -0
  183. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +207 -0
  184. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +102 -0
  185. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +131 -0
  186. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +269 -0
  187. package/docs/ja/specdojo/rulebooks/br-rulebook.md +187 -0
  188. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +279 -0
  189. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +219 -0
  190. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +233 -0
  191. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +182 -0
  192. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +171 -0
  193. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +105 -0
  194. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +195 -0
  195. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +285 -0
  196. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +292 -0
  197. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +171 -0
  198. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +325 -0
  199. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +266 -0
  200. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +294 -0
  201. package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +21 -0
  202. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +401 -0
  203. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +311 -0
  204. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +158 -0
  205. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +287 -0
  206. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +62 -0
  207. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +100 -0
  208. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +298 -0
  209. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +379 -0
  210. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +310 -0
  211. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +86 -0
  212. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +297 -0
  213. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +79 -0
  214. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +213 -0
  215. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +311 -0
  216. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +94 -0
  217. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +81 -0
  218. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +117 -0
  219. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +118 -0
  220. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +116 -0
  221. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +116 -0
  222. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +116 -0
  223. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +421 -0
  224. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +307 -0
  225. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +312 -0
  226. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +63 -0
  227. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +353 -0
  228. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +184 -0
  229. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +179 -0
  230. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +184 -0
  231. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +183 -0
  232. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +185 -0
  233. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +185 -0
  234. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +186 -0
  235. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +186 -0
  236. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +184 -0
  237. package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +61 -0
  238. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +84 -0
  239. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +357 -0
  240. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +80 -0
  241. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +484 -0
  242. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +120 -0
  243. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +293 -0
  244. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +211 -0
  245. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +94 -0
  246. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +116 -0
  247. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +93 -0
  248. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +190 -0
  249. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +108 -0
  250. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +122 -0
  251. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +117 -0
  252. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +116 -0
  253. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +93 -0
  254. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +146 -0
  255. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +65 -0
  256. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +178 -0
  257. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +232 -0
  258. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +235 -0
  259. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +242 -0
  260. package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +187 -0
  261. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +201 -0
  262. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +165 -0
  263. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +165 -0
  264. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +202 -0
  265. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +139 -0
  266. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +63 -0
  267. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +93 -0
  268. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +93 -0
  269. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +329 -0
  270. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +297 -0
  271. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +132 -0
  272. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +215 -0
  273. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +376 -0
  274. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +313 -0
  275. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +246 -0
  276. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +119 -0
  277. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +188 -0
  278. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +114 -0
  279. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +117 -0
  280. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +101 -0
  281. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +103 -0
  282. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +396 -0
  283. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +207 -0
  284. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +387 -0
  285. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +303 -0
  286. package/docs/ja/specdojo/samples/atc-index-sample.md +38 -0
  287. package/docs/ja/specdojo/samples/atc-sample.md +41 -0
  288. package/docs/ja/specdojo/samples/bac-sample.md +38 -0
  289. package/docs/ja/specdojo/samples/bdd-sample.yaml +71 -0
  290. package/docs/ja/specdojo/samples/bds-sample.md +38 -0
  291. package/docs/ja/specdojo/samples/bes-index-sample.md +38 -0
  292. package/docs/ja/specdojo/samples/bes-sample.md +38 -0
  293. package/docs/ja/specdojo/samples/bps-sample.md +38 -0
  294. package/docs/ja/specdojo/samples/br-sample.md +40 -0
  295. package/docs/ja/specdojo/samples/ccd-sample.md +38 -0
  296. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +284 -0
  297. package/docs/ja/specdojo/samples/cdfd-sample.md +229 -0
  298. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +146 -0
  299. package/docs/ja/specdojo/samples/cdsd-sample.md +38 -0
  300. package/docs/ja/specdojo/samples/cld-sample.md +38 -0
  301. package/docs/ja/specdojo/samples/cnd-sample.md +38 -0
  302. package/docs/ja/specdojo/samples/cop-index-sample.md +38 -0
  303. package/docs/ja/specdojo/samples/cop-sample.md +38 -0
  304. package/docs/ja/specdojo/samples/cpd-sample.md +38 -0
  305. package/docs/ja/specdojo/samples/cstd-sample.md +11 -0
  306. package/docs/ja/specdojo/samples/cxd-sample.md +38 -0
  307. package/docs/ja/specdojo/samples/dct-index-sample.yaml +39 -0
  308. package/docs/ja/specdojo/samples/dct-sample.yaml +91 -0
  309. package/docs/ja/specdojo/samples/dec-sample.md +39 -0
  310. package/docs/ja/specdojo/samples/dmd-index-sample.md +50 -0
  311. package/docs/ja/specdojo/samples/dmd-sample.md +74 -0
  312. package/docs/ja/specdojo/samples/etc-index-sample.md +38 -0
  313. package/docs/ja/specdojo/samples/etc-sample.md +38 -0
  314. package/docs/ja/specdojo/samples/gl-sample.yaml +37 -0
  315. package/docs/ja/specdojo/samples/ifd-sample.md +38 -0
  316. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +102 -0
  317. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +107 -0
  318. package/docs/ja/specdojo/samples/ifx-file-sample.md +38 -0
  319. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +89 -0
  320. package/docs/ja/specdojo/samples/imp-business-sample.md +66 -0
  321. package/docs/ja/specdojo/samples/imp-data-sample.md +60 -0
  322. package/docs/ja/specdojo/samples/imp-interface-sample.md +60 -0
  323. package/docs/ja/specdojo/samples/imp-operations-sample.md +60 -0
  324. package/docs/ja/specdojo/samples/imp-test-sample.md +60 -0
  325. package/docs/ja/specdojo/samples/itc-index-sample.md +38 -0
  326. package/docs/ja/specdojo/samples/itc-sample.md +38 -0
  327. package/docs/ja/specdojo/samples/mip-index-sample.md +38 -0
  328. package/docs/ja/specdojo/samples/mm-sample.md +35 -0
  329. package/docs/ja/specdojo/samples/mtp-sample.md +38 -0
  330. package/docs/ja/specdojo/samples/nfr-availability-sample.md +38 -0
  331. package/docs/ja/specdojo/samples/nfr-index-sample.md +38 -0
  332. package/docs/ja/specdojo/samples/nfr-integrity-sample.md +38 -0
  333. package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +38 -0
  334. package/docs/ja/specdojo/samples/nfr-operations-sample.md +38 -0
  335. package/docs/ja/specdojo/samples/nfr-performance-sample.md +38 -0
  336. package/docs/ja/specdojo/samples/nfr-reliability-sample.md +38 -0
  337. package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +38 -0
  338. package/docs/ja/specdojo/samples/nfr-usability-sample.md +38 -0
  339. package/docs/ja/specdojo/samples/ntp-sample.md +38 -0
  340. package/docs/ja/specdojo/samples/opd-access-control-sample.md +29 -0
  341. package/docs/ja/specdojo/samples/opd-incident-management-sample.md +31 -0
  342. package/docs/ja/specdojo/samples/opd-index-sample.md +41 -0
  343. package/docs/ja/specdojo/samples/opd-monitoring-sample.md +32 -0
  344. package/docs/ja/specdojo/samples/opd-sample.md +38 -0
  345. package/docs/ja/specdojo/samples/opr-access-control-sample.md +24 -0
  346. package/docs/ja/specdojo/samples/opr-backup-restore-sample.md +27 -0
  347. package/docs/ja/specdojo/samples/opr-batch-sample.md +23 -0
  348. package/docs/ja/specdojo/samples/opr-change-sample.md +24 -0
  349. package/docs/ja/specdojo/samples/opr-incident-sample.md +38 -0
  350. package/docs/ja/specdojo/samples/opr-index-sample.md +43 -0
  351. package/docs/ja/specdojo/samples/opr-monitoring-sample.md +27 -0
  352. package/docs/ja/specdojo/samples/opr-sample.md +38 -0
  353. package/docs/ja/specdojo/samples/opr-support-sample.md +23 -0
  354. package/docs/ja/specdojo/samples/otp-index-sample.md +66 -0
  355. package/docs/ja/specdojo/samples/otp-sample.md +68 -0
  356. package/docs/ja/specdojo/samples/pm-change-request-log-sample.md +47 -0
  357. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +46 -0
  358. package/docs/ja/specdojo/samples/pm-issue-log-sample.md +45 -0
  359. package/docs/ja/specdojo/samples/pm-members-sample.yaml +103 -0
  360. package/docs/ja/specdojo/samples/pm-organization-sample.md +46 -0
  361. package/docs/ja/specdojo/samples/pm-plan-sample.md +57 -0
  362. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +52 -0
  363. package/docs/ja/specdojo/samples/pm-raci-sample.md +57 -0
  364. package/docs/ja/specdojo/samples/pm-risk-register-sample.md +43 -0
  365. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +41 -0
  366. package/docs/ja/specdojo/samples/pr-sample.md +39 -0
  367. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +57 -0
  368. package/docs/ja/specdojo/samples/prj-charter-sample.md +121 -0
  369. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +105 -0
  370. package/docs/ja/specdojo/samples/prj-issues-and-approach-sample.md +78 -0
  371. package/docs/ja/specdojo/samples/prj-overview-sample.md +95 -0
  372. package/docs/ja/specdojo/samples/prj-scope-sample.md +71 -0
  373. package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +60 -0
  374. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +62 -0
  375. package/docs/ja/specdojo/samples/sac-sample.md +38 -0
  376. package/docs/ja/specdojo/samples/sf-index-sample.md +38 -0
  377. package/docs/ja/specdojo/samples/sf-sample.md +38 -0
  378. package/docs/ja/specdojo/samples/sld-sample.md +38 -0
  379. package/docs/ja/specdojo/samples/stc-index-sample.md +38 -0
  380. package/docs/ja/specdojo/samples/stc-sample.md +38 -0
  381. package/docs/ja/specdojo/samples/stsd-sample.md +58 -0
  382. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +38 -0
  383. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +38 -0
  384. package/docs/ja/specdojo/samples/sysd-index-sample.md +38 -0
  385. package/docs/ja/specdojo/samples/trc-requirements-to-specs-sample.md +56 -0
  386. package/docs/ja/specdojo/samples/trc-requirements-to-tests-sample.md +56 -0
  387. package/docs/ja/specdojo/samples/tsd-index-sample.md +29 -0
  388. package/docs/ja/specdojo/samples/tsd-sample.md +38 -0
  389. package/docs/ja/specdojo/samples/tsp-index-sample.md +38 -0
  390. package/docs/ja/specdojo/samples/uis-sample.md +38 -0
  391. package/docs/ja/specdojo/samples/utc-index-sample.md +38 -0
  392. package/docs/ja/specdojo/samples/utc-sample.md +38 -0
  393. package/docs/ja/specdojo/schemas/v1/guide-content.schema.yaml +20 -0
  394. package/docs/ja/specdojo/schemas/v1/philosophy-content.schema.yaml +21 -0
  395. package/docs/ja/specdojo/schemas/v1/reference-content.schema.yaml +21 -0
  396. package/docs/ja/specdojo/standards/document-metadata-standard.md +323 -0
  397. package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +75 -0
  398. package/docs/ja/specdojo/standards/git-branching-standard.md +227 -0
  399. package/docs/ja/specdojo/standards/guide-authoring-standard.md +124 -0
  400. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +929 -0
  401. package/docs/ja/specdojo/standards/job-definition-standard.md +148 -0
  402. package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +431 -0
  403. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +113 -0
  404. package/docs/ja/specdojo/standards/recipe-authoring-standard.md +143 -0
  405. package/docs/ja/specdojo/standards/reference-authoring-standard.md +99 -0
  406. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +140 -0
  407. package/docs/ja/specdojo/standards/sample-authoring-standard.md +151 -0
  408. package/docs/ja/specdojo/standards/standard-authoring-standard.md +108 -0
  409. package/docs/ja/specdojo/standards/template-authoring-standard.md +101 -0
  410. package/docs/ja/specdojo/standards/test-document-scope-standard.md +176 -0
  411. package/docs/ja/specdojo/templates/cdfd-overview-template.md +199 -0
  412. package/docs/ja/specdojo/templates/cdfd-template.md +173 -0
  413. package/docs/ja/specdojo/templates/cdfd-uc-template.md +148 -0
  414. package/docs/ja/specdojo/templates/dct-architecture-template.yaml +136 -0
  415. package/docs/ja/specdojo/templates/dct-business-acceptance-criteria-template.yaml +34 -0
  416. package/docs/ja/specdojo/templates/dct-business-model-bes-template.yaml +75 -0
  417. package/docs/ja/specdojo/templates/dct-business-model-bps-template.yaml +49 -0
  418. package/docs/ja/specdojo/templates/dct-business-model-br-template.yaml +50 -0
  419. package/docs/ja/specdojo/templates/dct-data-flow-template.yaml +40 -0
  420. package/docs/ja/specdojo/templates/dct-data-model-bdd-template.yaml +46 -0
  421. package/docs/ja/specdojo/templates/dct-data-model-ccd-template.yaml +46 -0
  422. package/docs/ja/specdojo/templates/dct-data-model-cdsd-template.yaml +41 -0
  423. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +38 -0
  424. package/docs/ja/specdojo/templates/dct-data-model-sld-template.yaml +38 -0
  425. package/docs/ja/specdojo/templates/dct-data-model-stsd-template.yaml +46 -0
  426. package/docs/ja/specdojo/templates/dct-external-interface-specs-template.yaml +114 -0
  427. package/docs/ja/specdojo/templates/dct-glossary-template.yaml +35 -0
  428. package/docs/ja/specdojo/templates/dct-impact-analysis-template.yaml +138 -0
  429. package/docs/ja/specdojo/templates/dct-index-template.md +40 -0
  430. package/docs/ja/specdojo/templates/dct-migration-planning-template.yaml +148 -0
  431. package/docs/ja/specdojo/templates/dct-non-functional-requirements-template.yaml +222 -0
  432. package/docs/ja/specdojo/templates/dct-operations-template.yaml +108 -0
  433. package/docs/ja/specdojo/templates/dct-project-definition-template.yaml +210 -0
  434. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +423 -0
  435. package/docs/ja/specdojo/templates/dct-system-acceptance-criteria-template.yaml +37 -0
  436. package/docs/ja/specdojo/templates/dct-system-design-template.yaml +82 -0
  437. package/docs/ja/specdojo/templates/dct-system-functions-template.yaml +58 -0
  438. package/docs/ja/specdojo/templates/dct-test-specs-template.yaml +261 -0
  439. package/docs/ja/specdojo/templates/dct-user-interface-model-template.yaml +60 -0
  440. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +88 -0
  441. package/docs/ja/specdojo/templates/opr-template.md +85 -0
  442. package/docs/ja/specdojo/templates/pjr-change-request-template.md +60 -0
  443. package/docs/ja/specdojo/templates/pjr-decision-template.md +61 -0
  444. package/docs/ja/specdojo/templates/pjr-index-template.md +49 -0
  445. package/docs/ja/specdojo/templates/pjr-issue-template.md +50 -0
  446. package/docs/ja/specdojo/templates/pjr-note-template.md +35 -0
  447. package/docs/ja/specdojo/templates/pjr-question-template.md +53 -0
  448. package/docs/ja/specdojo/templates/pjr-risk-template.md +49 -0
  449. package/docs/ja/specdojo/templates/pjr-todo-template.md +41 -0
  450. package/docs/ja/specdojo/templates/pjr-views-by-owner-template.md +22 -0
  451. package/docs/ja/specdojo/templates/pjr-views-by-priority-template.md +22 -0
  452. package/docs/ja/specdojo/templates/pjr-views-by-status-template.md +22 -0
  453. package/docs/ja/specdojo/templates/pm-change-request-log-template.md +20 -0
  454. package/docs/ja/specdojo/templates/pm-communication-plan-template.md +46 -0
  455. package/docs/ja/specdojo/templates/pm-decision-log-template.md +20 -0
  456. package/docs/ja/specdojo/templates/pm-issue-log-template.md +20 -0
  457. package/docs/ja/specdojo/templates/pm-members-template.yaml +105 -0
  458. package/docs/ja/specdojo/templates/pm-organization-template.md +44 -0
  459. package/docs/ja/specdojo/templates/pm-plan-template.md +52 -0
  460. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +46 -0
  461. package/docs/ja/specdojo/templates/pm-raci-template.md +51 -0
  462. package/docs/ja/specdojo/templates/pm-risk-register-template.md +20 -0
  463. package/docs/ja/specdojo/templates/pm-roles-template.yaml +53 -0
  464. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +59 -0
  465. package/docs/ja/specdojo/templates/prj-charter-template.md +116 -0
  466. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +116 -0
  467. package/docs/ja/specdojo/templates/prj-issues-and-approach-template.md +89 -0
  468. package/docs/ja/specdojo/templates/prj-overview-template.md +85 -0
  469. package/docs/ja/specdojo/templates/prj-scope-template.md +75 -0
  470. package/docs/ja/specdojo/templates/prj-stakeholder-register-template.md +64 -0
  471. package/docs/ja/specdojo/templates/prj-success-criteria-and-acceptance-criteria-template.md +60 -0
  472. package/docs/ja/specdojo/templates/stsd-template.md +57 -0
  473. package/docs/specdojo/schemas/v1/bdd.schema.yaml +230 -0
  474. package/docs/specdojo/schemas/v1/common-frontmatter.schema.yaml +77 -0
  475. package/docs/specdojo/schemas/v1/dct-index.schema.yaml +85 -0
  476. package/docs/specdojo/schemas/v1/dct-plan.schema.yaml +324 -0
  477. package/docs/specdojo/schemas/v1/dct.schema.yaml +368 -0
  478. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +91 -0
  479. package/docs/specdojo/schemas/v1/esil.schema.yaml +142 -0
  480. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +101 -0
  481. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +272 -0
  482. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +162 -0
  483. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +126 -0
  484. package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +151 -0
  485. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +144 -0
  486. package/docs/specdojo/schemas/v1/grade-done-criteria.schema.yaml +79 -0
  487. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +60 -0
  488. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +118 -0
  489. package/docs/specdojo/schemas/v1/guide-frontmatter.schema.yaml +19 -0
  490. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +293 -0
  491. package/docs/specdojo/schemas/v1/job-run.schema.yaml +90 -0
  492. package/docs/specdojo/schemas/v1/job.schema.yaml +198 -0
  493. package/docs/specdojo/schemas/v1/philosophy-frontmatter.schema.yaml +19 -0
  494. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +56 -0
  495. package/docs/specdojo/schemas/v1/pm-members.schema.yaml +252 -0
  496. package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +387 -0
  497. package/docs/specdojo/schemas/v1/pm-roles.schema.yaml +106 -0
  498. package/docs/specdojo/schemas/v1/recipe-frontmatter.schema.yaml +27 -0
  499. package/docs/specdojo/schemas/v1/reference-frontmatter.schema.yaml +18 -0
  500. package/docs/specdojo/schemas/v1/register-events.schema.yaml +106 -0
  501. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +204 -0
  502. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +36 -0
  503. package/docs/specdojo/schemas/v1/routine.schema.yaml +87 -0
  504. package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +61 -0
  505. package/docs/specdojo/schemas/v1/sch-common.schema.yaml +258 -0
  506. package/docs/specdojo/schemas/v1/sch-defaults.schema.yaml +48 -0
  507. package/docs/specdojo/schemas/v1/sch-milestones.schema.yaml +64 -0
  508. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +772 -0
  509. package/docs/specdojo/schemas/v1/sch-track.schema.yaml +66 -0
  510. package/docs/specdojo/schemas/v1/standard-frontmatter.schema.yaml +18 -0
  511. package/docs/specdojo/schemas/v1/tml-index.schema.yaml +103 -0
  512. package/package.json +121 -24
  513. package/templates/antigravity/README.md +35 -0
  514. package/templates/antigravity/exec-defaults-snippet.yaml +38 -0
  515. package/templates/antigravity/orchestrator.md +146 -0
  516. package/templates/antigravity/pm-members-snippet.yaml +55 -0
  517. package/templates/claude/README.md +46 -0
  518. package/templates/claude/agents/claude-expert-review-executor.md +14 -0
  519. package/templates/claude/agents/claude-review-executor.md +14 -0
  520. package/templates/claude/agents/specdojo-orchestrator.md +153 -0
  521. package/templates/claude/settings.edit.json +6 -0
  522. package/templates/claude/settings.report.json +6 -0
  523. package/templates/claude/settings.review.json +7 -0
  524. package/templates/codex/README.md +61 -0
  525. package/templates/codex/agents/codex-executor.toml +12 -0
  526. package/templates/codex/agents/codex-expert-executor.toml +12 -0
  527. package/templates/codex/agents/codex-expert-review-executor.toml +10 -0
  528. package/templates/codex/agents/codex-review-executor.toml +10 -0
  529. package/templates/codex/agents/specdojo-orchestrator.toml +154 -0
  530. package/templates/codex/orchestrator.md +146 -0
  531. package/templates/copilot/README.md +41 -0
  532. package/templates/copilot/exec-defaults-snippet.yaml +28 -0
  533. package/templates/copilot/pm-members-snippet.yaml +44 -0
  534. package/templates/opencode/README.md +41 -0
  535. package/templates/opencode/agents/opencode-executor.md +59 -0
  536. package/templates/opencode/agents/opencode-reporter.md +26 -0
  537. package/templates/opencode/agents/opencode-review-executor.md +48 -0
  538. package/templates/opencode/agents/specdojo-orchestrator.md +193 -0
  539. package/dist/exec-schedule-timeline-render.js +0 -201
  540. package/dist/exec-schedule-timeline.js +0 -2
@@ -0,0 +1,226 @@
1
+ import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
2
+ import { dirname, join } from "node:path";
3
+ import yaml from "js-yaml";
4
+ import { collectResolvedDeliverables } from "./catalog-build.js";
5
+ import { resolveBasePath } from "./catalog-paths.js";
6
+ import { buildSpecdojoFrontmatter, readSpecdojoNamespace } from "./frontmatter-namespace.js";
7
+ import { practiceLocalId } from "./practice-id.js";
8
+ import { flattenTemplateFrontmatter } from "./template-frontmatter.js";
9
+ import { isDctCatalogFileName } from "./catalog-types.js";
10
+ import { resolveSpecdojoPathIfExists, } from "./template-resolution.js";
11
+ const PROJECT_ID_PLACEHOLDER = "_PROJECT_ID_";
12
+ const LOCAL_ID_PLACEHOLDER = "_LOCAL_ID_";
13
+ const DELIVERABLE_NAME_PLACEHOLDER = "_DELIVERABLE_NAME_";
14
+ const DELIVERABLE_OVERVIEW_PLACEHOLDER = "_DELIVERABLE_OVERVIEW_";
15
+ const BASED_ON_PLACEHOLDER = "_BASED_ON_";
16
+ // Template-own metadata keys are dropped when flattening a YAML template into its
17
+ // generated form; the generated metadata comes from `metadata_template` instead
18
+ // (document-metadata-standard.md「生成物メタ情報雛形(metadata_template)」).
19
+ const TEMPLATE_OWN_META_KEYS = new Set([
20
+ "id",
21
+ "type",
22
+ "status",
23
+ "title",
24
+ "rulebook",
25
+ "metadata_template",
26
+ ]);
27
+ function isRecord(value) {
28
+ return typeof value === "object" && value !== null && !Array.isArray(value);
29
+ }
30
+ function replaceGeneratedPlaceholders(value, item, projectId) {
31
+ if (typeof value === "string") {
32
+ const basedOn = (item.depends_on ?? []).map((dependency) => `${projectId}:${dependency}`);
33
+ if (value === BASED_ON_PLACEHOLDER)
34
+ return basedOn;
35
+ return value
36
+ .replaceAll(PROJECT_ID_PLACEHOLDER, projectId)
37
+ .replaceAll(LOCAL_ID_PLACEHOLDER, item.local_id)
38
+ .replaceAll(DELIVERABLE_NAME_PLACEHOLDER, item.name)
39
+ .replaceAll(DELIVERABLE_OVERVIEW_PLACEHOLDER, item.overview)
40
+ .replaceAll(BASED_ON_PLACEHOLDER, JSON.stringify(basedOn));
41
+ }
42
+ if (Array.isArray(value)) {
43
+ return value.map((nested) => replaceGeneratedPlaceholders(nested, item, projectId));
44
+ }
45
+ if (isRecord(value)) {
46
+ return Object.fromEntries(Object.entries(value).map(([key, nested]) => [
47
+ key,
48
+ replaceGeneratedPlaceholders(nested, item, projectId),
49
+ ]));
50
+ }
51
+ return value;
52
+ }
53
+ function isYamlPath(path) {
54
+ return /\.ya?ml$/i.test(path);
55
+ }
56
+ // Normalize a dct file name or `--dct` token to its domain part so `dct-project-definition.yaml`,
57
+ // `dct-project-definition`, and `project-definition` all compare equal.
58
+ function normalizeDctName(name) {
59
+ return name
60
+ .trim()
61
+ .replace(/\.ya?ml$/i, "")
62
+ .replace(/^dct-/, "");
63
+ }
64
+ // Resolve a deliverable template from the rulebook frontmatter declaration. The declaration is
65
+ // the SSOT, so local_id naming conventions are deliberately not used as a fallback. This lets
66
+ // every deliverable in one rulebook lineage share a single template.
67
+ function findTemplate(templatesPath, rulebooksPath, rulebookId, ext, resourceRoots) {
68
+ if (!rulebookId ||
69
+ rulebookId === "none" ||
70
+ rulebookId === "not-needed" ||
71
+ rulebookId === "undecided") {
72
+ return null;
73
+ }
74
+ const rulebookFileName = `${practiceLocalId(rulebookId)}.md`;
75
+ const rulebookPath = resourceRoots
76
+ ? resolveSpecdojoPathIfExists(`docs/ja/specdojo/rulebooks/${rulebookFileName}`, resourceRoots)
77
+ : join(rulebooksPath, rulebookFileName);
78
+ if (!rulebookPath)
79
+ return null;
80
+ if (!existsSync(rulebookPath))
81
+ return null;
82
+ const templateId = readSpecdojoNamespace(readFileSync(rulebookPath, "utf8")).template;
83
+ if (typeof templateId !== "string" ||
84
+ templateId === "none" ||
85
+ templateId === "not-needed" ||
86
+ templateId === "undecided") {
87
+ return null;
88
+ }
89
+ const templateFileName = `${practiceLocalId(templateId)}${ext}`;
90
+ const candidate = resourceRoots
91
+ ? resolveSpecdojoPathIfExists(`docs/ja/specdojo/templates/${templateFileName}`, resourceRoots)
92
+ : join(templatesPath, templateFileName);
93
+ if (!candidate)
94
+ return null;
95
+ return existsSync(candidate) ? candidate : null;
96
+ }
97
+ // Minimal Markdown scaffold built from catalog metadata when no template exists.
98
+ // Fills the generated Frontmatter, an H1 from `name`, the catalog `overview`, and a
99
+ // single `_TODO_` line so the author knows the body is unwritten.
100
+ function fallbackMarkdown(item, projectId) {
101
+ const inner = {
102
+ id: `${projectId}:${item.local_id}`,
103
+ type: "project",
104
+ status: "draft",
105
+ };
106
+ if (item.rulebook && item.rulebook !== "undecided") {
107
+ inner.rulebook = item.rulebook === "not-needed" ? "none" : item.rulebook;
108
+ }
109
+ const basedOn = (item.depends_on ?? []).map((dep) => `${projectId}:${dep}`);
110
+ if (basedOn.length > 0)
111
+ inner.based_on = basedOn;
112
+ const innerLines = yaml
113
+ .dump(inner, { lineWidth: 120, noRefs: true })
114
+ .replace(/\n+$/, "")
115
+ .split("\n");
116
+ const frontmatter = buildSpecdojoFrontmatter(innerLines);
117
+ return `${frontmatter}\n\n# ${item.name}\n\n${item.overview}\n\n_TODO_: 本文を記述する\n`;
118
+ }
119
+ // Minimal YAML scaffold built from catalog metadata when no template exists.
120
+ function fallbackYaml(item, projectId) {
121
+ const doc = {
122
+ id: `${projectId}:${item.local_id}`,
123
+ type: "project",
124
+ status: "draft",
125
+ };
126
+ if (item.rulebook && item.rulebook !== "undecided") {
127
+ doc.rulebook = item.rulebook === "not-needed" ? "none" : item.rulebook;
128
+ }
129
+ return yaml.dump(doc, { lineWidth: 120, noRefs: true });
130
+ }
131
+ // Flatten a YAML deliverable template (`metadata_template` + body, minus own-meta)
132
+ // into its generated form, replacing catalog-derived generation placeholders.
133
+ function expandYamlTemplate(templatePath, item, projectId) {
134
+ const loaded = yaml.load(readFileSync(templatePath, "utf8"));
135
+ if (!isRecord(loaded)) {
136
+ throw new Error(`Template is not a YAML mapping: ${templatePath}`);
137
+ }
138
+ const metadataTemplate = loaded["metadata_template"];
139
+ const body = Object.fromEntries(Object.entries(loaded).filter(([key]) => !TEMPLATE_OWN_META_KEYS.has(key)));
140
+ const merged = isRecord(metadataTemplate) ? { ...metadataTemplate, ...body } : body;
141
+ const doc = replaceGeneratedPlaceholders(merged, item, projectId);
142
+ return yaml.dump(doc, { lineWidth: 120, noRefs: true });
143
+ }
144
+ function generateContent(item, resolvedPath, projectId, templatesPath, rulebooksPath, resourceRoots) {
145
+ if (isYamlPath(resolvedPath)) {
146
+ const template = findTemplate(templatesPath, rulebooksPath, item.rulebook, ".yaml", resourceRoots);
147
+ return template ? expandYamlTemplate(template, item, projectId) : fallbackYaml(item, projectId);
148
+ }
149
+ const template = findTemplate(templatesPath, rulebooksPath, item.rulebook, ".md", resourceRoots);
150
+ if (template) {
151
+ const raw = readFileSync(template, "utf8");
152
+ return replaceGeneratedPlaceholders(flattenTemplateFrontmatter(raw), item, projectId);
153
+ }
154
+ return fallbackMarkdown(item, projectId);
155
+ }
156
+ // Materialize the deliverable files a project's catalog points to. Only `kind: work`
157
+ // items are generated; `control` deliverables have dedicated scaffolds (e.g. register
158
+ // scaffold) and `generated` deliverables are produced by build/schedule/exec.
159
+ export function runGenerate(opts) {
160
+ const { catalogPath, templatesPath, rulebooksPath, repoRoot, force, dryRun = false, dctNames = [], resourceRoots, } = opts;
161
+ const written = [];
162
+ const skipped = [];
163
+ const errors = [];
164
+ if (!existsSync(catalogPath)) {
165
+ errors.push(`Catalog directory not found: ${catalogPath}`);
166
+ return { written, skipped, errors };
167
+ }
168
+ const allFiles = readdirSync(catalogPath).filter(isDctCatalogFileName).sort();
169
+ if (allFiles.length === 0) {
170
+ errors.push(`No dct-*.yaml files found in: ${catalogPath}`);
171
+ return { written, skipped, errors };
172
+ }
173
+ let files = allFiles;
174
+ if (dctNames.length > 0) {
175
+ const wanted = new Set(dctNames.map(normalizeDctName));
176
+ files = allFiles.filter((f) => wanted.has(normalizeDctName(f)));
177
+ const matched = new Set(files.map(normalizeDctName));
178
+ const unmatched = [...wanted].filter((name) => !matched.has(name));
179
+ if (unmatched.length > 0) {
180
+ const available = allFiles.join(", ");
181
+ errors.push(`No dct-*.yaml matches: ${unmatched.join(", ")}\nAvailable: ${available}`);
182
+ return { written, skipped, errors };
183
+ }
184
+ }
185
+ for (const f of files) {
186
+ const filePath = join(catalogPath, f);
187
+ let doc;
188
+ try {
189
+ doc = yaml.load(readFileSync(filePath, "utf8"));
190
+ }
191
+ catch (err) {
192
+ errors.push(`${filePath}: ${err instanceof Error ? err.message : String(err)}`);
193
+ continue;
194
+ }
195
+ if (!doc || !Array.isArray(doc.groups))
196
+ continue;
197
+ const projectId = opts.projectId ?? doc.project_id;
198
+ if (!projectId) {
199
+ errors.push(`${filePath}: project_id missing. Use --project-id <id> to specify it.`);
200
+ continue;
201
+ }
202
+ const resolved = [];
203
+ collectResolvedDeliverables(doc.groups, resolveBasePath("", doc.base_path), resolved);
204
+ for (const { item, resolvedPath } of resolved) {
205
+ if (item.kind !== "work" || !item.path)
206
+ continue;
207
+ const outputPath = join(repoRoot, resolvedPath);
208
+ if (existsSync(outputPath) && !force) {
209
+ skipped.push(resolvedPath);
210
+ continue;
211
+ }
212
+ try {
213
+ const content = generateContent(item, resolvedPath, projectId, templatesPath, rulebooksPath, resourceRoots);
214
+ if (!dryRun) {
215
+ mkdirSync(dirname(outputPath), { recursive: true });
216
+ writeFileSync(outputPath, content, "utf8");
217
+ }
218
+ written.push(resolvedPath);
219
+ }
220
+ catch (err) {
221
+ errors.push(`${resolvedPath}: ${err instanceof Error ? err.message : String(err)}`);
222
+ }
223
+ }
224
+ }
225
+ return { written, skipped, errors };
226
+ }
@@ -0,0 +1,31 @@
1
+ // Single source of truth for resolving catalog base_path / deliverable document paths.
2
+ // All results are canonical repo-root-relative paths: POSIX separators, no leading slash.
3
+ //
4
+ // A leading slash in a catalog base_path or item path means "anchored at the repo root"
5
+ // and is normalized away here so agents and tools resolve the path from the run CWD
6
+ // (repo root for in-place runs, worktree root otherwise) rather than the filesystem root.
7
+ // Combine a parent base_path with a section's base_path. A child starting with `/`
8
+ // re-anchors at the repo root (parent is discarded), otherwise it is appended.
9
+ export function resolveBasePath(parentBase, childBase) {
10
+ if (!childBase)
11
+ return parentBase;
12
+ if (childBase.startsWith("/"))
13
+ return childBase.slice(1);
14
+ return parentBase ? `${parentBase}/${childBase}` : childBase;
15
+ }
16
+ // Resolve a deliverable item's document path against its section base_path. An item
17
+ // without a path resolves to the section base; an item path starting with `/` re-anchors
18
+ // at the repo root.
19
+ export function resolveDeliverablePath(sectionBase, itemPath) {
20
+ if (!itemPath)
21
+ return sectionBase;
22
+ if (itemPath.startsWith("/"))
23
+ return itemPath.slice(1);
24
+ return sectionBase ? `${sectionBase}/${itemPath}` : itemPath;
25
+ }
26
+ // Deprecated deliverables remain in the catalog after being moved to a trash directory.
27
+ // Callers that discover active documents use this segment-based check so similarly named
28
+ // paths (for example, `trash-bin`) remain eligible.
29
+ export function isTrashedPath(repoRelativePath) {
30
+ return repoRelativePath.split("/").includes("trash");
31
+ }
@@ -0,0 +1,301 @@
1
+ // Deterministic DCT generator: turns an agent-authored dct-plan-<domain>.yaml plus the domain's
2
+ // DCT template(s) into dct-<domain>.yaml (or the dct-<domain>-<part>.yaml files of a physically
3
+ // split domain). The agent decides which instances exist and what the placeholders mean; every
4
+ // structural rule (min_size, placeholder expansion, part_of, domain, base_path, physical split,
5
+ // section order) is reused from the catalog scaffold implementation so no second expansion
6
+ // implementation exists.
7
+ import { existsSync, mkdirSync, mkdtempSync, readFileSync, renameSync, rmSync, writeFileSync, } from "node:fs";
8
+ import { join } from "node:path";
9
+ import yaml from "js-yaml";
10
+ import { collectCatalogLocalIds, validateDctDoc } from "./catalog-build.js";
11
+ import { collectTemplateEntries, diffPlanText, loadTemplatesForDomain, validateDctPlan, } from "./catalog-plan.js";
12
+ import { catalogFileNameFromTemplate, dumpDctDoc, scaffoldDoc, } from "./catalog-scaffold.js";
13
+ function newOverlay() {
14
+ return {
15
+ instances: new Map(),
16
+ excluded: new Set(),
17
+ applied: new Set(),
18
+ sizeBlocked: new Set(),
19
+ unresolved: [],
20
+ };
21
+ }
22
+ function variablesFor(plan, deliverable) {
23
+ const variables = {};
24
+ for (const variable of plan.variables ?? [])
25
+ variables[variable.name] = variable.value;
26
+ for (const variable of deliverable.variables ?? [])
27
+ variables[variable.name] = variable.value;
28
+ return variables;
29
+ }
30
+ // A single synthetic template used for plan validation. A physically split domain has one
31
+ // template per part, but the plan references template entries by local_id only, so validation
32
+ // works against the union of every part.
33
+ function mergeTemplates(templates) {
34
+ const first = templates[0].template;
35
+ const groups = templates.flatMap(({ template }) => template.groups ?? []);
36
+ return { ...first, groups };
37
+ }
38
+ function collectDocLocalIds(doc) {
39
+ const ids = [];
40
+ const walk = (sections) => {
41
+ for (const section of sections) {
42
+ for (const item of section.deliverables ?? [])
43
+ ids.push(item.local_id);
44
+ if (section.groups)
45
+ walk(section.groups);
46
+ }
47
+ };
48
+ walk(doc.groups);
49
+ return ids;
50
+ }
51
+ // Blocking conditions that must stop generation before anything is written. A plan is an agent
52
+ // judgment, so an unanswered question or a low-confidence instance is a reason to stop rather
53
+ // than to emit a partially guessed catalog.
54
+ function collectPlanBlockers(plan) {
55
+ const errors = [];
56
+ if (plan.deliverables.length === 0) {
57
+ errors.push(`dct-plan-${plan.domain}.yaml: deliverables が空のため生成できない(agent 判定を先に行う)。`);
58
+ }
59
+ for (const question of plan.open_questions) {
60
+ if (!question.blocking)
61
+ continue;
62
+ errors.push(`dct-plan-${plan.domain}.yaml: 未確定の blocking な open_questions がある (${question.topic}): ` +
63
+ `${question.question}${question.next_action ? ` / next: ${question.next_action}` : ""}`);
64
+ }
65
+ return errors;
66
+ }
67
+ // Generates the catalog document(s) for one plan. Nothing is written here: the caller inspects
68
+ // `errors` first so a plan that fails any check leaves the working tree untouched.
69
+ export function generateCatalogsFromPlan(opts) {
70
+ const { catalogPath, templatesPath, repoRoot, projectId, size, plan } = opts;
71
+ const errors = [...collectPlanBlockers(plan)];
72
+ const warnings = [];
73
+ const templates = loadTemplatesForDomain(templatesPath, plan.domain, repoRoot);
74
+ if (templates.length === 0) {
75
+ errors.push(`No DCT template found for domain '${plan.domain}' in ${templatesPath}.`);
76
+ return { files: [], errors, warnings };
77
+ }
78
+ // Template entry -> owning template file. A duplicated local_id across parts would make the
79
+ // output file ambiguous, so it is an error rather than a first-match win.
80
+ const entryOwner = new Map();
81
+ for (const loaded of templates) {
82
+ const entries = collectTemplateEntries(loaded.template.groups ?? []);
83
+ for (const localId of entries.keys()) {
84
+ const previous = entryOwner.get(localId);
85
+ if (previous) {
86
+ errors.push(`template_local_id '${localId}' が ${previous.file} と ${loaded.file} の両方に定義されている。` +
87
+ `物理分割したテンプレート間で local_id を重複させない。`);
88
+ continue;
89
+ }
90
+ entryOwner.set(localId, { template: loaded, file: loaded.file });
91
+ }
92
+ }
93
+ const planValidation = validateDctPlan(plan, {
94
+ template: mergeTemplates(templates),
95
+ knownLocalIds: collectCatalogLocalIds(catalogPath),
96
+ });
97
+ errors.push(...planValidation.errors);
98
+ warnings.push(...planValidation.warnings);
99
+ // Overlay per template file, keeping the plan order inside each template entry.
100
+ const overlays = new Map();
101
+ for (const loaded of templates)
102
+ overlays.set(loaded.file, newOverlay());
103
+ for (const deliverable of plan.deliverables) {
104
+ const owner = entryOwner.get(deliverable.template_local_id);
105
+ if (!owner) {
106
+ errors.push(`${deliverable.local_id}: template_local_id '${deliverable.template_local_id}' が domain ` +
107
+ `'${plan.domain}' のテンプレートに存在しない。`);
108
+ continue;
109
+ }
110
+ const templateEntry = collectTemplateEntries(owner.template.template.groups ?? []).get(deliverable.template_local_id);
111
+ if (templateEntry && templateEntry.kind !== deliverable.kind) {
112
+ errors.push(`${deliverable.local_id}: kind '${deliverable.kind}' がテンプレート項目 ` +
113
+ `'${deliverable.template_local_id}' の kind '${templateEntry.kind}' と一致しない。`);
114
+ continue;
115
+ }
116
+ const overlay = overlays.get(owner.file);
117
+ const instances = overlay.instances.get(deliverable.template_local_id) ?? [];
118
+ const instance = {
119
+ local_id: deliverable.local_id,
120
+ name: deliverable.name,
121
+ kind: deliverable.kind,
122
+ variables: variablesFor(plan, deliverable),
123
+ ...(deliverable.depends_on ? { depends_on: deliverable.depends_on } : {}),
124
+ ...(deliverable.overview ? { overview: deliverable.overview } : {}),
125
+ };
126
+ instances.push(instance);
127
+ overlay.instances.set(deliverable.template_local_id, instances);
128
+ }
129
+ // Exclusions bound to a template entry drop that entry from the generated catalog. Exclusions
130
+ // without a template entry are documentation of rejected candidates only.
131
+ for (const exclusion of plan.exclusions) {
132
+ if (!exclusion.template_local_id)
133
+ continue;
134
+ const owner = entryOwner.get(exclusion.template_local_id);
135
+ if (!owner) {
136
+ warnings.push(`exclusions: template_local_id '${exclusion.template_local_id}' はテンプレートに存在しない(無視する)。`);
137
+ continue;
138
+ }
139
+ overlays.get(owner.file).excluded.add(exclusion.template_local_id);
140
+ }
141
+ const files = [];
142
+ for (const loaded of templates) {
143
+ const overlay = overlays.get(loaded.file);
144
+ const doc = scaffoldDoc(loaded.template, projectId, size, {}, overlay);
145
+ for (const message of overlay.unresolved) {
146
+ errors.push(`${loaded.file}: ${message}`);
147
+ }
148
+ for (const templateLocalId of overlay.sizeBlocked) {
149
+ errors.push(`${loaded.file}: template_local_id '${templateLocalId}' は min_size により size '${size}' の` +
150
+ `対象外だが plan がインスタンスを要求している。size を上げるか plan から外す。`);
151
+ }
152
+ if (doc.groups.length === 0) {
153
+ warnings.push(`${loaded.file}: 生成対象の成果物が 0 件のため出力しない。`);
154
+ continue;
155
+ }
156
+ const fileName = catalogFileNameFromTemplate(loaded.file);
157
+ files.push({
158
+ path: join(catalogPath, fileName),
159
+ fileName,
160
+ doc,
161
+ content: dumpDctDoc(doc),
162
+ });
163
+ }
164
+ const applied = new Set();
165
+ for (const overlay of overlays.values()) {
166
+ for (const localId of overlay.applied)
167
+ applied.add(localId);
168
+ }
169
+ const dropped = plan.deliverables.filter((deliverable) => entryOwner.has(deliverable.template_local_id) && !applied.has(deliverable.template_local_id));
170
+ for (const deliverable of dropped) {
171
+ errors.push(`${deliverable.local_id}: テンプレート項目 '${deliverable.template_local_id}' が生成対象に含まれず、` +
172
+ `インスタンスを出力できなかった(min_size / セクション条件を確認する)。`);
173
+ }
174
+ // Cross-file checks: the generated documents must not collide with each other or with the
175
+ // catalogs of other domains that stay in place.
176
+ const generatedFileNames = new Set(files.map((file) => file.fileName));
177
+ const otherDomainLocalIds = collectCatalogLocalIdsExcept(catalogPath, generatedFileNames);
178
+ const seen = new Map();
179
+ const plannedLocalIds = new Set(plan.deliverables.map((deliverable) => deliverable.local_id));
180
+ for (const file of files) {
181
+ for (const localId of collectDocLocalIds(file.doc)) {
182
+ const previous = seen.get(localId);
183
+ if (previous) {
184
+ errors.push(`local_id '${localId}' が ${previous} と ${file.fileName} で重複している。`);
185
+ continue;
186
+ }
187
+ seen.set(localId, file.fileName);
188
+ if (!plannedLocalIds.has(localId)) {
189
+ errors.push(`${file.fileName}: template entry '${localId}' が plan の deliverables / exclusions で` +
190
+ `明示的に判定されていない。採用する場合は deliverables、除外する場合は exclusions に記録する。`);
191
+ }
192
+ if (otherDomainLocalIds.has(localId)) {
193
+ errors.push(`local_id '${localId}' は別ドメインのカタログに既に存在する。プロジェクト内で一意にする。`);
194
+ }
195
+ }
196
+ }
197
+ const knownLocalIds = new Set([...otherDomainLocalIds, ...seen.keys()]);
198
+ for (const file of files) {
199
+ const result = validateDctDoc(file.doc, file.path, knownLocalIds, repoRoot);
200
+ errors.push(...result.errors);
201
+ warnings.push(...result.warnings);
202
+ }
203
+ return { files, errors, warnings };
204
+ }
205
+ // local_ids declared by the catalogs that are not regenerated by this run.
206
+ function collectCatalogLocalIdsExcept(catalogPath, skip) {
207
+ if (!existsSync(catalogPath))
208
+ return new Set();
209
+ const all = collectCatalogLocalIds(catalogPath);
210
+ if (skip.size === 0)
211
+ return all;
212
+ const skipped = new Set();
213
+ for (const fileName of skip) {
214
+ const filePath = join(catalogPath, fileName);
215
+ if (!existsSync(filePath))
216
+ continue;
217
+ for (const localId of collectDocLocalIdsFromFile(filePath))
218
+ skipped.add(localId);
219
+ }
220
+ return new Set([...all].filter((localId) => !skipped.has(localId)));
221
+ }
222
+ function collectDocLocalIdsFromFile(filePath) {
223
+ let doc = null;
224
+ try {
225
+ doc = yaml.load(readFileSync(filePath, "utf8"));
226
+ }
227
+ catch {
228
+ return [];
229
+ }
230
+ return doc && Array.isArray(doc.groups) ? collectDocLocalIds(doc) : [];
231
+ }
232
+ // Writes the generated catalogs. Existing files are protected: without `force` the write is
233
+ // skipped and the diff is returned for review. Nothing is written when any file is blocked, so
234
+ // a domain never ends up half regenerated.
235
+ export function writeGeneratedCatalogs(opts) {
236
+ const { catalogPath, files, force, dryRun } = opts;
237
+ const outcomes = [];
238
+ const planned = files.map((file) => {
239
+ const exists = existsSync(file.path);
240
+ const current = exists ? readFileSync(file.path, "utf8") : "";
241
+ const diff = diffPlanText(current, file.content);
242
+ const unchanged = exists && diff.length === 0;
243
+ const blocked = exists && !unchanged && !force;
244
+ return { file, exists, diff, unchanged, blocked };
245
+ });
246
+ const anyBlocked = planned.some((entry) => entry.blocked);
247
+ const writable = !dryRun && !anyBlocked ? planned.filter((entry) => !entry.unchanged) : [];
248
+ let stagingDir = null;
249
+ const staged = new Map();
250
+ try {
251
+ if (writable.length > 0) {
252
+ mkdirSync(catalogPath, { recursive: true });
253
+ stagingDir = mkdtempSync(join(catalogPath, ".specdojo-catalog-generate-"));
254
+ for (const entry of writable) {
255
+ const temporaryPath = join(stagingDir, entry.file.fileName);
256
+ writeFileSync(temporaryPath, entry.file.content, "utf8");
257
+ staged.set(entry.file.path, temporaryPath);
258
+ }
259
+ }
260
+ for (const entry of planned) {
261
+ if (entry.unchanged) {
262
+ outcomes.push({
263
+ path: entry.file.path,
264
+ written: false,
265
+ skippedReason: "unchanged",
266
+ diff: [],
267
+ });
268
+ continue;
269
+ }
270
+ if (entry.blocked) {
271
+ outcomes.push({
272
+ path: entry.file.path,
273
+ written: false,
274
+ skippedReason: "exists",
275
+ diff: entry.diff,
276
+ });
277
+ continue;
278
+ }
279
+ if (dryRun || anyBlocked) {
280
+ outcomes.push({
281
+ path: entry.file.path,
282
+ written: false,
283
+ skippedReason: dryRun ? "dry-run" : "exists",
284
+ diff: entry.diff,
285
+ });
286
+ continue;
287
+ }
288
+ const temporaryPath = staged.get(entry.file.path);
289
+ if (!temporaryPath) {
290
+ throw new Error(`internal error: staged catalog is missing for ${entry.file.path}`);
291
+ }
292
+ renameSync(temporaryPath, entry.file.path);
293
+ outcomes.push({ path: entry.file.path, written: true, diff: entry.diff });
294
+ }
295
+ }
296
+ finally {
297
+ if (stagingDir)
298
+ rmSync(stagingDir, { recursive: true, force: true });
299
+ }
300
+ return outcomes;
301
+ }
@@ -0,0 +1,73 @@
1
+ // Renders the agent instruction for DCT plan judgment. The instruction is plain Markdown
2
+ // so it can be piped into any SpecDojo agent execution path; no agent product API is
3
+ // wired into the CLI. The agent's only output is a dct-plan-<domain>.yaml that conforms
4
+ // to dct-plan.schema.yaml — never free-form prose and never a catalog file.
5
+ const INPUT_KIND_LABEL = {
6
+ "data-flow": "データフロー(主要判定根拠)",
7
+ "upstream-deliverable": "上流成果物",
8
+ "existing-catalog": "既存カタログ(基準線)",
9
+ template: "テンプレート",
10
+ other: "その他",
11
+ };
12
+ export function renderPlanPrompt(options) {
13
+ const { projectId, domain, templateId, templateRelPath, planRelPath, schemaRelPath } = options;
14
+ const existingCatalogs = options.inputs.filter((input) => input.kind === "existing-catalog");
15
+ const lines = [];
16
+ lines.push(`# DCT成果物インスタンス判定指示(${domain})`);
17
+ lines.push("");
18
+ lines.push(`project ${projectId} の domain \`${domain}\` について、下記の入力文書だけを読み、` +
19
+ `必要な成果物インスタンス・placeholder 値・採用しない候補・未確定事項を判定する。`);
20
+ lines.push("");
21
+ lines.push("## 1. 出力");
22
+ lines.push("");
23
+ lines.push(`- 出力先: \`${planRelPath}\``);
24
+ lines.push(`- 準拠スキーマ: \`${schemaRelPath}\`(構造から外れた項目を追加しない)`);
25
+ lines.push("- 出力は YAML のみとする。判断の説明は `rationale` / `open_questions` に構造化して書く。");
26
+ lines.push("- 成果物カタログ(`dct-<domain>.yaml`)そのものを書かない。`groups` / `base_path` / `done_criteria` はテンプレートとジェネレーターの責務である。");
27
+ lines.push("");
28
+ lines.push("## 2. 入力");
29
+ lines.push("");
30
+ lines.push(`- テンプレート: \`${templateRelPath}\`(id: \`${templateId}\`)`);
31
+ if (options.inputs.length === 0) {
32
+ lines.push("- 判定対象の入力文書が解決できていない。判定を行わず、入力不足として報告する。");
33
+ }
34
+ for (const input of options.inputs) {
35
+ const label = INPUT_KIND_LABEL[input.kind];
36
+ lines.push(`- ${label}: \`${input.path}\``);
37
+ }
38
+ lines.push("");
39
+ lines.push("上記以外の文書を根拠にしない。追加の入力が必要な場合は `open_questions` に必要文書を書く。");
40
+ lines.push("");
41
+ lines.push("## 3. 判定手順");
42
+ lines.push("");
43
+ lines.push("1. データフロー文書を読み、業務領域・処理単位・登場する情報の区分を洗い出す。");
44
+ lines.push("2. テンプレートの各項目について、この domain で必要なインスタンスを決める。");
45
+ lines.push("3. `iteration_pattern` を決める。複数業務領域へ項目を複製する場合は `pattern-a`、単一業務領域を処理単位ごとの固定 `local_id` へ分割する場合は `pattern-b` とする。");
46
+ lines.push("4. `pattern-a` では placeholder(`_TERM_` 等)ごとに `variables` へ値・根拠・理由を書き、`local_id` は展開後の値と一致させる。");
47
+ lines.push("5. `pattern-b` では `variables` を使わず、処理単位ごとに固定 `local_id` を与え、由来するテンプレート項目を `template_local_id` に書く。");
48
+ lines.push("6. 採用しないテンプレート項目・業務領域は `exclusions` に候補と理由を書く。");
49
+ lines.push("7. 入力から根拠を得られない placeholder・要否・名称・依存関係は確定させず、`open_questions` に理由と次のアクションを書く。");
50
+ lines.push("");
51
+ lines.push("## 4. 判定の制約");
52
+ lines.push("");
53
+ lines.push("- すべての `deliverables[]` と `variables[]` に、入力文書の ID またはパスを `evidence` として1件以上書く。");
54
+ lines.push("- 根拠のない項目を推測で確定しない。確度が低い判断は `confidence: low` とし、`open_questions` を併記する。");
55
+ lines.push("- `local_id` は kebab-case とし、placeholder を残さない。プロジェクト内で一意にする。");
56
+ lines.push("- `depends_on` には、この plan 内の `local_id` または既存カタログの `local_id` だけを書く。");
57
+ if (existingCatalogs.length > 0) {
58
+ lines.push(`- この domain には既存カタログがある(${existingCatalogs.map((input) => `\`${input.path}\``).join(", ")})。既存 \`local_id\` を落とす場合は \`exclusions\` に理由を書く。`);
59
+ }
60
+ if (options.planExists) {
61
+ lines.push(`- 既存の判定結果 \`${planRelPath}\` がある。無条件に置き換えず、差分をレビューできる形で更新理由を \`notes\` に書く。`);
62
+ }
63
+ lines.push("");
64
+ lines.push("## 5. 完了確認");
65
+ lines.push("");
66
+ lines.push("```sh");
67
+ lines.push(`specdojo catalog plan validate --project ${projectId} --domain ${domain}`);
68
+ lines.push("```");
69
+ lines.push("");
70
+ lines.push("検証がエラーを返す場合は、推測で埋めずに指摘された項目を修正するか `open_questions` へ移す。");
71
+ lines.push("");
72
+ return lines.join("\n");
73
+ }