specdojo 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (531) hide show
  1. package/LICENSE +22 -0
  2. package/README.md +82 -38
  3. package/dist/agent-response.js +27 -0
  4. package/dist/agent.js +124 -0
  5. package/dist/build-command.js +149 -0
  6. package/dist/build-if-stale.js +35 -0
  7. package/dist/catalog-build.js +1079 -0
  8. package/dist/catalog-generate.js +226 -0
  9. package/dist/catalog-paths.js +31 -0
  10. package/dist/catalog-plan-generate.js +301 -0
  11. package/dist/catalog-plan-prompt.js +73 -0
  12. package/dist/catalog-plan.js +471 -0
  13. package/dist/catalog-scaffold.js +255 -0
  14. package/dist/catalog-types.js +4 -0
  15. package/dist/catalog.js +606 -0
  16. package/dist/dashboard.js +980 -0
  17. package/dist/deliverable-trash.js +148 -0
  18. package/dist/deliverable.js +97 -0
  19. package/dist/dist-freshness.js +150 -0
  20. package/dist/doc-index.js +424 -0
  21. package/dist/exec-agent-config.js +172 -0
  22. package/dist/exec-agent-git-state.js +136 -0
  23. package/dist/exec-agent-protected-config.js +276 -0
  24. package/dist/exec-events.js +250 -112
  25. package/dist/exec-evidence.js +317 -0
  26. package/dist/exec-format.js +45 -0
  27. package/dist/exec-limit.js +202 -0
  28. package/dist/exec-parent-validation.js +169 -0
  29. package/dist/exec-pipeline-state.js +160 -0
  30. package/dist/exec-plans.js +1016 -0
  31. package/dist/exec-project.js +25 -11
  32. package/dist/exec-protection-handoff.js +169 -0
  33. package/dist/exec-provider-scaffold.js +99 -0
  34. package/dist/exec-register-resume.js +196 -0
  35. package/dist/exec-register.js +281 -0
  36. package/dist/exec-reporter.js +329 -0
  37. package/dist/exec-results.js +510 -0
  38. package/dist/exec-run-lock.js +149 -0
  39. package/dist/exec-run.js +4953 -0
  40. package/dist/exec-schedule-calendar.js +86 -9
  41. package/dist/exec-schedule-cpm.js +30 -12
  42. package/dist/exec-schedule-gantt-chart-render.js +428 -0
  43. package/dist/exec-schedule-gantt-chart-scope.js +111 -0
  44. package/dist/exec-schedule-gantt-chart.js +2 -0
  45. package/dist/exec-schedule-hash.js +34 -25
  46. package/dist/exec-schedule-index.js +200 -67
  47. package/dist/exec-schedule-initial.js +100 -0
  48. package/dist/exec-schedule-progress.js +51 -26
  49. package/dist/exec-schedule-ready.js +71 -27
  50. package/dist/exec-schedule.js +171 -93
  51. package/dist/exec-shared.js +146 -25
  52. package/dist/exec-strategy.js +547 -0
  53. package/dist/exec-task-view.js +64 -0
  54. package/dist/exec-trial.js +895 -0
  55. package/dist/exec-worktree-command.js +426 -0
  56. package/dist/exec-worktree-ops.js +847 -0
  57. package/dist/exec-worktree.js +359 -0
  58. package/dist/exec.js +744 -192
  59. package/dist/frontmatter-namespace.js +48 -0
  60. package/dist/git-environment.js +23 -0
  61. package/dist/grade-result.js +137 -0
  62. package/dist/grade.js +2456 -0
  63. package/dist/index-command.js +103 -0
  64. package/dist/job.js +1081 -0
  65. package/dist/kata-command.js +303 -0
  66. package/dist/kata.js +187 -0
  67. package/dist/package-paths.js +15 -0
  68. package/dist/practice-id.js +24 -0
  69. package/dist/register-date.js +122 -0
  70. package/dist/register-events.js +363 -0
  71. package/dist/register-history.js +323 -0
  72. package/dist/register-item.js +455 -0
  73. package/dist/register-migrate-timestamps.js +176 -0
  74. package/dist/register.js +2199 -0
  75. package/dist/review-plan.js +199 -0
  76. package/dist/review-types.js +1 -0
  77. package/dist/role-types.js +1 -0
  78. package/dist/routine.js +814 -0
  79. package/dist/schedule-approach.js +252 -0
  80. package/dist/schedule-build.js +552 -0
  81. package/dist/schedule-phase-sets.js +73 -0
  82. package/dist/schedule-strategy-generate.js +812 -0
  83. package/dist/schedule-strategy-profiles.js +276 -0
  84. package/dist/schedule.js +420 -0
  85. package/dist/spawn-self.js +28 -0
  86. package/dist/specdojo-config.js +133 -39
  87. package/dist/specdojo.js +55 -7
  88. package/dist/template-frontmatter.js +89 -0
  89. package/dist/template-resolution.js +92 -0
  90. package/dist/timeline-build.js +334 -0
  91. package/dist/timeline.js +107 -0
  92. package/dist/watch.js +313 -0
  93. package/dist/yaml-pages-command.js +28 -0
  94. package/dist/yaml-pages.js +180 -0
  95. package/dist/yaml-schema-modeline.js +49 -0
  96. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +600 -0
  97. package/docs/ja/specdojo/exec-templates/xep-bootstrap-template.md +120 -0
  98. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +37 -0
  99. package/docs/ja/specdojo/exec-templates/xep-cross-deliverable-dedup-template.md +51 -0
  100. package/docs/ja/specdojo/exec-templates/xep-freeform-template.md +74 -0
  101. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +109 -0
  102. package/docs/ja/specdojo/exec-templates/xep-job-template.md +43 -0
  103. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +82 -0
  104. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +86 -0
  105. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +42 -0
  106. package/docs/ja/specdojo/exec-templates/xep-register-template.md +49 -0
  107. package/docs/ja/specdojo/exec-templates/xep-retrofit-template.md +98 -0
  108. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +86 -0
  109. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +86 -0
  110. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +86 -0
  111. package/docs/ja/specdojo/exec-templates/xep-template.md +66 -0
  112. package/docs/ja/specdojo/exec-templates/xer-cross-deliverable-dedup-template.md +31 -0
  113. package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +40 -0
  114. package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +30 -0
  115. package/docs/ja/specdojo/exec-templates/xer-template.md +19 -0
  116. package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +70 -0
  117. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +97 -0
  118. package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +76 -0
  119. package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +73 -0
  120. package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +74 -0
  121. package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +74 -0
  122. package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +73 -0
  123. package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +73 -0
  124. package/docs/ja/specdojo/exec-templates/xrp-template.md +67 -0
  125. package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +7 -0
  126. package/docs/ja/specdojo/exec-templates/xrr-template.md +21 -0
  127. package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +7 -0
  128. package/docs/ja/specdojo/guides/branch-workflow-guide.md +354 -0
  129. package/docs/ja/specdojo/guides/docs-editing-guide.md +327 -0
  130. package/docs/ja/specdojo/guides/docs-structure-guide.md +519 -0
  131. package/docs/ja/specdojo/guides/exec-config-guide.md +589 -0
  132. package/docs/ja/specdojo/guides/exec-operation-guide.md +440 -0
  133. package/docs/ja/specdojo/guides/exec-worktree-guide.md +318 -0
  134. package/docs/ja/specdojo/guides/kata-guide.md +89 -0
  135. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +127 -0
  136. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +228 -0
  137. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +111 -0
  138. package/docs/ja/specdojo/guides/quick-start-guide.md +473 -0
  139. package/docs/ja/specdojo/guides/register-operation-guide.md +418 -0
  140. package/docs/ja/specdojo/guides/review-guide.md +428 -0
  141. package/docs/ja/specdojo/guides/routine-operation-guide.md +282 -0
  142. package/docs/ja/specdojo/guides/ryu-guide.md +230 -0
  143. package/docs/ja/specdojo/guides/schedule-design-guide.md +429 -0
  144. package/docs/ja/specdojo/guides/schedule-operation-guide.md +151 -0
  145. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +257 -0
  146. package/docs/ja/specdojo/guides/timeline-design-guide.md +160 -0
  147. package/docs/ja/specdojo/guides/track-design-guide.md +215 -0
  148. package/docs/ja/specdojo/guides/use-case-guide.md +133 -0
  149. package/docs/ja/specdojo/guides/waza-guide.md +224 -0
  150. package/docs/ja/specdojo/index.md +33 -0
  151. package/docs/ja/specdojo/philosophy/needs-to-implementation-philosophy.md +212 -0
  152. package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +242 -0
  153. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +198 -0
  154. package/docs/ja/specdojo/recipes/cdfd-recipe.md +218 -0
  155. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +198 -0
  156. package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +100 -0
  157. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +148 -0
  158. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +97 -0
  159. package/docs/ja/specdojo/recipes/pm-members-recipe.md +149 -0
  160. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +96 -0
  161. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +98 -0
  162. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +97 -0
  163. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +96 -0
  164. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +136 -0
  165. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +162 -0
  166. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +187 -0
  167. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +235 -0
  168. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +205 -0
  169. package/docs/ja/specdojo/recipes/prj-overview-recipe.md +289 -0
  170. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +201 -0
  171. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +168 -0
  172. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +179 -0
  173. package/docs/ja/specdojo/recipes/stsd-recipe.md +138 -0
  174. package/docs/ja/specdojo/references/command-reference.md +718 -0
  175. package/docs/ja/specdojo/references/deliverables-reference.md +407 -0
  176. package/docs/ja/specdojo/references/directory-layout-reference.md +280 -0
  177. package/docs/ja/specdojo/references/specdojo-config-reference.md +133 -0
  178. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +372 -0
  179. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +302 -0
  180. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +331 -0
  181. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +134 -0
  182. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +207 -0
  183. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +102 -0
  184. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +131 -0
  185. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +269 -0
  186. package/docs/ja/specdojo/rulebooks/br-rulebook.md +187 -0
  187. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +279 -0
  188. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +219 -0
  189. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +233 -0
  190. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +182 -0
  191. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +171 -0
  192. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +105 -0
  193. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +195 -0
  194. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +285 -0
  195. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +292 -0
  196. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +171 -0
  197. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +325 -0
  198. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +266 -0
  199. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +294 -0
  200. package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +21 -0
  201. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +401 -0
  202. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +311 -0
  203. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +158 -0
  204. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +287 -0
  205. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +62 -0
  206. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +100 -0
  207. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +298 -0
  208. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +379 -0
  209. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +310 -0
  210. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +86 -0
  211. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +297 -0
  212. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +79 -0
  213. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +213 -0
  214. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +311 -0
  215. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +94 -0
  216. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +81 -0
  217. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +117 -0
  218. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +118 -0
  219. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +116 -0
  220. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +116 -0
  221. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +116 -0
  222. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +421 -0
  223. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +307 -0
  224. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +312 -0
  225. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +63 -0
  226. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +353 -0
  227. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +184 -0
  228. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +179 -0
  229. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +184 -0
  230. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +183 -0
  231. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +185 -0
  232. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +185 -0
  233. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +186 -0
  234. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +186 -0
  235. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +184 -0
  236. package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +61 -0
  237. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +84 -0
  238. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +357 -0
  239. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +80 -0
  240. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +484 -0
  241. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +120 -0
  242. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +293 -0
  243. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +211 -0
  244. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +94 -0
  245. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +116 -0
  246. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +93 -0
  247. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +190 -0
  248. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +108 -0
  249. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +122 -0
  250. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +117 -0
  251. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +116 -0
  252. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +93 -0
  253. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +146 -0
  254. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +65 -0
  255. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +178 -0
  256. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +232 -0
  257. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +235 -0
  258. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +242 -0
  259. package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +187 -0
  260. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +201 -0
  261. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +165 -0
  262. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +165 -0
  263. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +202 -0
  264. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +139 -0
  265. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +63 -0
  266. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +93 -0
  267. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +93 -0
  268. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +329 -0
  269. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +297 -0
  270. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +132 -0
  271. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +215 -0
  272. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +376 -0
  273. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +313 -0
  274. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +246 -0
  275. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +119 -0
  276. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +188 -0
  277. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +114 -0
  278. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +117 -0
  279. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +101 -0
  280. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +103 -0
  281. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +396 -0
  282. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +207 -0
  283. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +387 -0
  284. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +303 -0
  285. package/docs/ja/specdojo/samples/atc-index-sample.md +38 -0
  286. package/docs/ja/specdojo/samples/atc-sample.md +41 -0
  287. package/docs/ja/specdojo/samples/bac-sample.md +38 -0
  288. package/docs/ja/specdojo/samples/bdd-sample.yaml +71 -0
  289. package/docs/ja/specdojo/samples/bds-sample.md +38 -0
  290. package/docs/ja/specdojo/samples/bes-index-sample.md +38 -0
  291. package/docs/ja/specdojo/samples/bes-sample.md +38 -0
  292. package/docs/ja/specdojo/samples/bps-sample.md +38 -0
  293. package/docs/ja/specdojo/samples/br-sample.md +40 -0
  294. package/docs/ja/specdojo/samples/ccd-sample.md +38 -0
  295. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +284 -0
  296. package/docs/ja/specdojo/samples/cdfd-sample.md +229 -0
  297. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +146 -0
  298. package/docs/ja/specdojo/samples/cdsd-sample.md +38 -0
  299. package/docs/ja/specdojo/samples/cld-sample.md +38 -0
  300. package/docs/ja/specdojo/samples/cnd-sample.md +38 -0
  301. package/docs/ja/specdojo/samples/cop-index-sample.md +38 -0
  302. package/docs/ja/specdojo/samples/cop-sample.md +38 -0
  303. package/docs/ja/specdojo/samples/cpd-sample.md +38 -0
  304. package/docs/ja/specdojo/samples/cstd-sample.md +11 -0
  305. package/docs/ja/specdojo/samples/cxd-sample.md +38 -0
  306. package/docs/ja/specdojo/samples/dct-index-sample.yaml +39 -0
  307. package/docs/ja/specdojo/samples/dct-sample.yaml +91 -0
  308. package/docs/ja/specdojo/samples/dec-sample.md +39 -0
  309. package/docs/ja/specdojo/samples/dmd-index-sample.md +50 -0
  310. package/docs/ja/specdojo/samples/dmd-sample.md +74 -0
  311. package/docs/ja/specdojo/samples/etc-index-sample.md +38 -0
  312. package/docs/ja/specdojo/samples/etc-sample.md +38 -0
  313. package/docs/ja/specdojo/samples/gl-sample.yaml +37 -0
  314. package/docs/ja/specdojo/samples/ifd-sample.md +38 -0
  315. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +102 -0
  316. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +107 -0
  317. package/docs/ja/specdojo/samples/ifx-file-sample.md +38 -0
  318. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +89 -0
  319. package/docs/ja/specdojo/samples/imp-business-sample.md +66 -0
  320. package/docs/ja/specdojo/samples/imp-data-sample.md +60 -0
  321. package/docs/ja/specdojo/samples/imp-interface-sample.md +60 -0
  322. package/docs/ja/specdojo/samples/imp-operations-sample.md +60 -0
  323. package/docs/ja/specdojo/samples/imp-test-sample.md +60 -0
  324. package/docs/ja/specdojo/samples/itc-index-sample.md +38 -0
  325. package/docs/ja/specdojo/samples/itc-sample.md +38 -0
  326. package/docs/ja/specdojo/samples/mip-index-sample.md +38 -0
  327. package/docs/ja/specdojo/samples/mm-sample.md +35 -0
  328. package/docs/ja/specdojo/samples/mtp-sample.md +38 -0
  329. package/docs/ja/specdojo/samples/nfr-availability-sample.md +38 -0
  330. package/docs/ja/specdojo/samples/nfr-index-sample.md +38 -0
  331. package/docs/ja/specdojo/samples/nfr-integrity-sample.md +38 -0
  332. package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +38 -0
  333. package/docs/ja/specdojo/samples/nfr-operations-sample.md +38 -0
  334. package/docs/ja/specdojo/samples/nfr-performance-sample.md +38 -0
  335. package/docs/ja/specdojo/samples/nfr-reliability-sample.md +38 -0
  336. package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +38 -0
  337. package/docs/ja/specdojo/samples/nfr-usability-sample.md +38 -0
  338. package/docs/ja/specdojo/samples/ntp-sample.md +38 -0
  339. package/docs/ja/specdojo/samples/opd-access-control-sample.md +29 -0
  340. package/docs/ja/specdojo/samples/opd-incident-management-sample.md +31 -0
  341. package/docs/ja/specdojo/samples/opd-index-sample.md +41 -0
  342. package/docs/ja/specdojo/samples/opd-monitoring-sample.md +32 -0
  343. package/docs/ja/specdojo/samples/opd-sample.md +38 -0
  344. package/docs/ja/specdojo/samples/opr-access-control-sample.md +24 -0
  345. package/docs/ja/specdojo/samples/opr-backup-restore-sample.md +27 -0
  346. package/docs/ja/specdojo/samples/opr-batch-sample.md +23 -0
  347. package/docs/ja/specdojo/samples/opr-change-sample.md +24 -0
  348. package/docs/ja/specdojo/samples/opr-incident-sample.md +38 -0
  349. package/docs/ja/specdojo/samples/opr-index-sample.md +43 -0
  350. package/docs/ja/specdojo/samples/opr-monitoring-sample.md +27 -0
  351. package/docs/ja/specdojo/samples/opr-sample.md +38 -0
  352. package/docs/ja/specdojo/samples/opr-support-sample.md +23 -0
  353. package/docs/ja/specdojo/samples/otp-index-sample.md +66 -0
  354. package/docs/ja/specdojo/samples/otp-sample.md +68 -0
  355. package/docs/ja/specdojo/samples/pm-change-request-log-sample.md +47 -0
  356. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +46 -0
  357. package/docs/ja/specdojo/samples/pm-issue-log-sample.md +45 -0
  358. package/docs/ja/specdojo/samples/pm-members-sample.yaml +103 -0
  359. package/docs/ja/specdojo/samples/pm-organization-sample.md +46 -0
  360. package/docs/ja/specdojo/samples/pm-plan-sample.md +57 -0
  361. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +52 -0
  362. package/docs/ja/specdojo/samples/pm-raci-sample.md +57 -0
  363. package/docs/ja/specdojo/samples/pm-risk-register-sample.md +43 -0
  364. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +41 -0
  365. package/docs/ja/specdojo/samples/pr-sample.md +39 -0
  366. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +57 -0
  367. package/docs/ja/specdojo/samples/prj-charter-sample.md +121 -0
  368. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +105 -0
  369. package/docs/ja/specdojo/samples/prj-issues-and-approach-sample.md +78 -0
  370. package/docs/ja/specdojo/samples/prj-overview-sample.md +95 -0
  371. package/docs/ja/specdojo/samples/prj-scope-sample.md +71 -0
  372. package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +60 -0
  373. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +62 -0
  374. package/docs/ja/specdojo/samples/sac-sample.md +38 -0
  375. package/docs/ja/specdojo/samples/sf-index-sample.md +38 -0
  376. package/docs/ja/specdojo/samples/sf-sample.md +38 -0
  377. package/docs/ja/specdojo/samples/sld-sample.md +38 -0
  378. package/docs/ja/specdojo/samples/stc-index-sample.md +38 -0
  379. package/docs/ja/specdojo/samples/stc-sample.md +38 -0
  380. package/docs/ja/specdojo/samples/stsd-sample.md +58 -0
  381. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +38 -0
  382. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +38 -0
  383. package/docs/ja/specdojo/samples/sysd-index-sample.md +38 -0
  384. package/docs/ja/specdojo/samples/trc-requirements-to-specs-sample.md +56 -0
  385. package/docs/ja/specdojo/samples/trc-requirements-to-tests-sample.md +56 -0
  386. package/docs/ja/specdojo/samples/tsd-index-sample.md +29 -0
  387. package/docs/ja/specdojo/samples/tsd-sample.md +38 -0
  388. package/docs/ja/specdojo/samples/tsp-index-sample.md +38 -0
  389. package/docs/ja/specdojo/samples/uis-sample.md +38 -0
  390. package/docs/ja/specdojo/samples/utc-index-sample.md +38 -0
  391. package/docs/ja/specdojo/samples/utc-sample.md +38 -0
  392. package/docs/ja/specdojo/schemas/v1/guide-content.schema.yaml +20 -0
  393. package/docs/ja/specdojo/schemas/v1/philosophy-content.schema.yaml +21 -0
  394. package/docs/ja/specdojo/schemas/v1/reference-content.schema.yaml +21 -0
  395. package/docs/ja/specdojo/standards/document-metadata-standard.md +323 -0
  396. package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +75 -0
  397. package/docs/ja/specdojo/standards/git-branching-standard.md +227 -0
  398. package/docs/ja/specdojo/standards/guide-authoring-standard.md +124 -0
  399. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +929 -0
  400. package/docs/ja/specdojo/standards/job-definition-standard.md +148 -0
  401. package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +431 -0
  402. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +113 -0
  403. package/docs/ja/specdojo/standards/recipe-authoring-standard.md +143 -0
  404. package/docs/ja/specdojo/standards/reference-authoring-standard.md +99 -0
  405. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +140 -0
  406. package/docs/ja/specdojo/standards/sample-authoring-standard.md +151 -0
  407. package/docs/ja/specdojo/standards/standard-authoring-standard.md +108 -0
  408. package/docs/ja/specdojo/standards/template-authoring-standard.md +101 -0
  409. package/docs/ja/specdojo/standards/test-document-scope-standard.md +176 -0
  410. package/docs/ja/specdojo/templates/cdfd-overview-template.md +199 -0
  411. package/docs/ja/specdojo/templates/cdfd-template.md +173 -0
  412. package/docs/ja/specdojo/templates/cdfd-uc-template.md +148 -0
  413. package/docs/ja/specdojo/templates/dct-architecture-template.yaml +136 -0
  414. package/docs/ja/specdojo/templates/dct-business-acceptance-criteria-template.yaml +34 -0
  415. package/docs/ja/specdojo/templates/dct-business-model-bes-template.yaml +75 -0
  416. package/docs/ja/specdojo/templates/dct-business-model-bps-template.yaml +49 -0
  417. package/docs/ja/specdojo/templates/dct-business-model-br-template.yaml +50 -0
  418. package/docs/ja/specdojo/templates/dct-data-flow-template.yaml +40 -0
  419. package/docs/ja/specdojo/templates/dct-data-model-bdd-template.yaml +46 -0
  420. package/docs/ja/specdojo/templates/dct-data-model-ccd-template.yaml +46 -0
  421. package/docs/ja/specdojo/templates/dct-data-model-cdsd-template.yaml +41 -0
  422. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +38 -0
  423. package/docs/ja/specdojo/templates/dct-data-model-sld-template.yaml +38 -0
  424. package/docs/ja/specdojo/templates/dct-data-model-stsd-template.yaml +46 -0
  425. package/docs/ja/specdojo/templates/dct-external-interface-specs-template.yaml +114 -0
  426. package/docs/ja/specdojo/templates/dct-glossary-template.yaml +35 -0
  427. package/docs/ja/specdojo/templates/dct-impact-analysis-template.yaml +138 -0
  428. package/docs/ja/specdojo/templates/dct-index-template.md +40 -0
  429. package/docs/ja/specdojo/templates/dct-migration-planning-template.yaml +148 -0
  430. package/docs/ja/specdojo/templates/dct-non-functional-requirements-template.yaml +222 -0
  431. package/docs/ja/specdojo/templates/dct-operations-template.yaml +108 -0
  432. package/docs/ja/specdojo/templates/dct-project-definition-template.yaml +210 -0
  433. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +423 -0
  434. package/docs/ja/specdojo/templates/dct-system-acceptance-criteria-template.yaml +37 -0
  435. package/docs/ja/specdojo/templates/dct-system-design-template.yaml +82 -0
  436. package/docs/ja/specdojo/templates/dct-system-functions-template.yaml +58 -0
  437. package/docs/ja/specdojo/templates/dct-test-specs-template.yaml +261 -0
  438. package/docs/ja/specdojo/templates/dct-user-interface-model-template.yaml +60 -0
  439. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +88 -0
  440. package/docs/ja/specdojo/templates/opr-template.md +85 -0
  441. package/docs/ja/specdojo/templates/pjr-change-request-template.md +60 -0
  442. package/docs/ja/specdojo/templates/pjr-decision-template.md +61 -0
  443. package/docs/ja/specdojo/templates/pjr-index-template.md +49 -0
  444. package/docs/ja/specdojo/templates/pjr-issue-template.md +50 -0
  445. package/docs/ja/specdojo/templates/pjr-note-template.md +35 -0
  446. package/docs/ja/specdojo/templates/pjr-question-template.md +53 -0
  447. package/docs/ja/specdojo/templates/pjr-risk-template.md +49 -0
  448. package/docs/ja/specdojo/templates/pjr-todo-template.md +41 -0
  449. package/docs/ja/specdojo/templates/pjr-views-by-owner-template.md +22 -0
  450. package/docs/ja/specdojo/templates/pjr-views-by-priority-template.md +22 -0
  451. package/docs/ja/specdojo/templates/pjr-views-by-status-template.md +22 -0
  452. package/docs/ja/specdojo/templates/pm-change-request-log-template.md +20 -0
  453. package/docs/ja/specdojo/templates/pm-communication-plan-template.md +46 -0
  454. package/docs/ja/specdojo/templates/pm-decision-log-template.md +20 -0
  455. package/docs/ja/specdojo/templates/pm-issue-log-template.md +20 -0
  456. package/docs/ja/specdojo/templates/pm-members-template.yaml +105 -0
  457. package/docs/ja/specdojo/templates/pm-organization-template.md +44 -0
  458. package/docs/ja/specdojo/templates/pm-plan-template.md +52 -0
  459. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +46 -0
  460. package/docs/ja/specdojo/templates/pm-raci-template.md +51 -0
  461. package/docs/ja/specdojo/templates/pm-risk-register-template.md +20 -0
  462. package/docs/ja/specdojo/templates/pm-roles-template.yaml +53 -0
  463. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +59 -0
  464. package/docs/ja/specdojo/templates/prj-charter-template.md +116 -0
  465. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +116 -0
  466. package/docs/ja/specdojo/templates/prj-issues-and-approach-template.md +89 -0
  467. package/docs/ja/specdojo/templates/prj-overview-template.md +85 -0
  468. package/docs/ja/specdojo/templates/prj-scope-template.md +75 -0
  469. package/docs/ja/specdojo/templates/prj-stakeholder-register-template.md +64 -0
  470. package/docs/ja/specdojo/templates/prj-success-criteria-and-acceptance-criteria-template.md +60 -0
  471. package/docs/ja/specdojo/templates/stsd-template.md +57 -0
  472. package/docs/specdojo/schemas/v1/bdd.schema.yaml +230 -0
  473. package/docs/specdojo/schemas/v1/common-frontmatter.schema.yaml +77 -0
  474. package/docs/specdojo/schemas/v1/dct-index.schema.yaml +85 -0
  475. package/docs/specdojo/schemas/v1/dct-plan.schema.yaml +324 -0
  476. package/docs/specdojo/schemas/v1/dct.schema.yaml +368 -0
  477. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +91 -0
  478. package/docs/specdojo/schemas/v1/esil.schema.yaml +142 -0
  479. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +101 -0
  480. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +272 -0
  481. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +162 -0
  482. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +126 -0
  483. package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +151 -0
  484. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +144 -0
  485. package/docs/specdojo/schemas/v1/grade-done-criteria.schema.yaml +79 -0
  486. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +60 -0
  487. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +118 -0
  488. package/docs/specdojo/schemas/v1/guide-frontmatter.schema.yaml +19 -0
  489. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +293 -0
  490. package/docs/specdojo/schemas/v1/job-run.schema.yaml +90 -0
  491. package/docs/specdojo/schemas/v1/job.schema.yaml +198 -0
  492. package/docs/specdojo/schemas/v1/philosophy-frontmatter.schema.yaml +19 -0
  493. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +56 -0
  494. package/docs/specdojo/schemas/v1/pm-members.schema.yaml +252 -0
  495. package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +387 -0
  496. package/docs/specdojo/schemas/v1/pm-roles.schema.yaml +106 -0
  497. package/docs/specdojo/schemas/v1/recipe-frontmatter.schema.yaml +27 -0
  498. package/docs/specdojo/schemas/v1/reference-frontmatter.schema.yaml +18 -0
  499. package/docs/specdojo/schemas/v1/register-events.schema.yaml +106 -0
  500. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +204 -0
  501. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +36 -0
  502. package/docs/specdojo/schemas/v1/routine.schema.yaml +87 -0
  503. package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +61 -0
  504. package/docs/specdojo/schemas/v1/sch-common.schema.yaml +258 -0
  505. package/docs/specdojo/schemas/v1/sch-defaults.schema.yaml +48 -0
  506. package/docs/specdojo/schemas/v1/sch-milestones.schema.yaml +64 -0
  507. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +772 -0
  508. package/docs/specdojo/schemas/v1/sch-track.schema.yaml +66 -0
  509. package/docs/specdojo/schemas/v1/standard-frontmatter.schema.yaml +18 -0
  510. package/docs/specdojo/schemas/v1/tml-index.schema.yaml +103 -0
  511. package/package.json +120 -24
  512. package/templates/claude/README.md +46 -0
  513. package/templates/claude/agents/claude-expert-review-executor.md +14 -0
  514. package/templates/claude/agents/claude-review-executor.md +14 -0
  515. package/templates/claude/settings.edit.json +6 -0
  516. package/templates/claude/settings.report.json +6 -0
  517. package/templates/claude/settings.review.json +7 -0
  518. package/templates/codex/README.md +61 -0
  519. package/templates/codex/agents/codex-executor.toml +12 -0
  520. package/templates/codex/agents/codex-expert-executor.toml +12 -0
  521. package/templates/codex/agents/codex-expert-review-executor.toml +10 -0
  522. package/templates/codex/agents/codex-review-executor.toml +10 -0
  523. package/templates/copilot/README.md +41 -0
  524. package/templates/copilot/exec-defaults-snippet.yaml +28 -0
  525. package/templates/copilot/pm-members-snippet.yaml +44 -0
  526. package/templates/opencode/README.md +41 -0
  527. package/templates/opencode/agents/opencode-executor.md +59 -0
  528. package/templates/opencode/agents/opencode-reporter.md +26 -0
  529. package/templates/opencode/agents/opencode-review-executor.md +48 -0
  530. package/dist/exec-schedule-timeline-render.js +0 -201
  531. package/dist/exec-schedule-timeline.js +0 -2
@@ -1,24 +1,29 @@
1
- import { existsSync, readFileSync, writeFileSync } from 'node:fs';
2
- import { dirname, resolve } from 'node:path';
3
- import dotenv from 'dotenv';
4
- import yaml from 'js-yaml';
1
+ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
2
+ import { dirname, join, resolve } from "node:path";
3
+ import dotenv from "dotenv";
4
+ import yaml from "js-yaml";
5
+ import { runProviderScaffold, specdojoPackageRootDir } from "./exec-provider-scaffold.js";
6
+ /** Default IANA time zone for register date derivation when run.register_date_timezone is unset. */
7
+ export const DEFAULT_REGISTER_DATE_TIMEZONE = "UTC";
8
+ export const SPECDOJO_CONFIG_REFERENCE_URL = "https://specdojo.github.io/specdojo/ja/specdojo/references/specdojo-config-reference.html";
9
+ export const DEFAULT_PROJECT_CONTEXT = ["prj-overview"];
5
10
  function findUpward(startDir, name) {
6
11
  let currentDir = resolve(startDir);
7
12
  while (true) {
8
13
  const candidate = resolve(currentDir, name);
9
14
  if (existsSync(candidate))
10
15
  return candidate;
11
- const parentDir = resolve(currentDir, '..');
16
+ const parentDir = resolve(currentDir, "..");
12
17
  if (parentDir === currentDir)
13
18
  return null;
14
19
  currentDir = parentDir;
15
20
  }
16
21
  }
17
22
  export function specdojoRootDir() {
18
- const configPath = findUpward(process.cwd(), 'specdojo.config.json');
23
+ const configPath = findUpward(process.cwd(), join(".specdojo", "specdojo.config.json"));
19
24
  if (configPath)
20
- return dirname(configPath);
21
- const gitMarker = findUpward(process.cwd(), '.git');
25
+ return dirname(dirname(configPath));
26
+ const gitMarker = findUpward(process.cwd(), ".git");
22
27
  if (gitMarker)
23
28
  return dirname(gitMarker);
24
29
  return process.cwd();
@@ -26,29 +31,72 @@ export function specdojoRootDir() {
26
31
  export function loadEnv() {
27
32
  // Load .env from the repository root if present.
28
33
  // Safe if missing.
29
- dotenv.config({ path: resolve(specdojoRootDir(), '.env') });
34
+ dotenv.config({ path: resolve(specdojoRootDir(), ".env"), quiet: true });
30
35
  }
31
36
  export function defaultConfigPath() {
32
- return resolve(specdojoRootDir(), 'specdojo.config.json');
37
+ return join(specdojoRootDir(), ".specdojo", "specdojo.config.json");
33
38
  }
39
+ // Join a project document path with the project's base_path, returning a repo-root-relative path.
40
+ // An empty/undefined base_path leaves the path unchanged (full backward compatibility).
41
+ function withBasePath(project, relPath) {
42
+ const base = project.base_path?.trim();
43
+ const rel = relPath.trim();
44
+ return base ? join(base, rel) : rel;
45
+ }
46
+ function withOptionalBasePath(project, relPath) {
47
+ if (!relPath || !relPath.trim())
48
+ return undefined;
49
+ return withBasePath(project, relPath);
50
+ }
51
+ // schedule と execution は project 直下の固定ディレクトリに置く。設定を省いても既定値へ
52
+ // 解決することで、登録簿だけを使う構成でも path 設定を書かずに始められる。戻り値は
53
+ // string のままなので、呼び出し側の扱いは変わらない。
34
54
  export function getProjectSchedulePath(project) {
35
- return project.schedule_path;
55
+ return withBasePath(project, project.schedule_path?.trim() || "schedule");
36
56
  }
37
57
  export function getProjectExecutionPath(project) {
38
- return project.execution_path;
58
+ return withBasePath(project, project.execution_path?.trim() || "execution");
59
+ }
60
+ // Timeline lives in a fixed cross-cutting directory under the project root, so an
61
+ // unset timeline_path falls back to "timeline" instead of disabling the command.
62
+ export function getProjectTimelinePath(project) {
63
+ return withBasePath(project, project.timeline_path?.trim() || "timeline");
39
64
  }
40
65
  export function getProjectMembersPath(project) {
41
- return project.members_path;
66
+ return withOptionalBasePath(project, project.members_path);
67
+ }
68
+ export function getProjectCatalogPath(project) {
69
+ return withOptionalBasePath(project, project.catalog_path);
70
+ }
71
+ export function getProjectRolesPath(project) {
72
+ return withOptionalBasePath(project, project.roles_path);
73
+ }
74
+ export function getProjectViewpointsPath(project) {
75
+ return withOptionalBasePath(project, project.viewpoints_path);
76
+ }
77
+ export function getProjectRegisterPath(project) {
78
+ return withOptionalBasePath(project, project.project_register_path);
79
+ }
80
+ export function getProjectRoutinesPath(project) {
81
+ return withOptionalBasePath(project, project.routines_path);
82
+ }
83
+ export function getProjectJobsPath(project) {
84
+ return withOptionalBasePath(project, project.jobs_path);
85
+ }
86
+ export function getProjectContext(project) {
87
+ return project.project_context === undefined
88
+ ? [...DEFAULT_PROJECT_CONTEXT]
89
+ : [...project.project_context];
42
90
  }
43
91
  export function loadMemberRoster(baseDir, project) {
44
- const membersPath = project.members_path;
45
- if (!membersPath || !membersPath.trim())
92
+ const membersPath = getProjectMembersPath(project);
93
+ if (!membersPath)
46
94
  return null;
47
- const fullPath = resolve(baseDir, membersPath.trim());
95
+ const fullPath = resolve(baseDir, membersPath);
48
96
  if (!existsSync(fullPath)) {
49
97
  throw new Error(`members_path not found: ${fullPath}`);
50
98
  }
51
- const raw = readFileSync(fullPath, 'utf8');
99
+ const raw = readFileSync(fullPath, "utf8");
52
100
  const parsed = yaml.load(raw);
53
101
  if (!parsed || !Array.isArray(parsed.members)) {
54
102
  throw new Error(`Invalid members file: ${fullPath} (expected { members: [...] })`);
@@ -58,21 +106,30 @@ export function loadMemberRoster(baseDir, project) {
58
106
  export function assertValidActor(actor, roster) {
59
107
  if (!roster)
60
108
  return;
61
- const known = roster.members.map(m => m.nickname);
109
+ const known = roster.members.map((m) => m.nickname);
62
110
  if (!known.includes(actor)) {
63
- throw new Error(`Unknown actor: "${actor}". Must be one of: ${known.join(', ')}\n` +
111
+ throw new Error(`Unknown actor: "${actor}". Must be one of: ${known.join(", ")}\n` +
64
112
  `Register the nickname in members_path file before use.`);
65
113
  }
66
114
  }
115
+ function isOmittedOrNonEmptyString(value) {
116
+ if (value === undefined)
117
+ return true;
118
+ return typeof value === "string" && value.trim().length > 0;
119
+ }
67
120
  function isValidProjectConfig(project) {
68
- if (!project || typeof project !== 'object' || Array.isArray(project))
121
+ if (!project || typeof project !== "object" || Array.isArray(project))
69
122
  return false;
70
123
  const candidate = project;
71
- if (typeof candidate.schedule_path !== 'string' || candidate.schedule_path.trim().length === 0) {
124
+ // 省略は既定値へ解決するため許容する。ただし指定したうえでの空文字は、設定漏れと
125
+ // 意図的な省略を区別できないため引き続き不正として扱う。
126
+ if (!isOmittedOrNonEmptyString(candidate.schedule_path))
72
127
  return false;
73
- }
74
- if (typeof candidate.execution_path !== 'string' ||
75
- candidate.execution_path.trim().length === 0) {
128
+ if (!isOmittedOrNonEmptyString(candidate.execution_path))
129
+ return false;
130
+ if (candidate.project_context !== undefined &&
131
+ (!Array.isArray(candidate.project_context) ||
132
+ !candidate.project_context.every((ref) => typeof ref === "string" && ref.trim().length > 0))) {
76
133
  return false;
77
134
  }
78
135
  return true;
@@ -83,27 +140,32 @@ export function loadConfig() {
83
140
  if (!existsSync(configPath)) {
84
141
  return { configPath, config: null };
85
142
  }
86
- const raw = readFileSync(configPath, 'utf8');
143
+ const raw = readFileSync(configPath, "utf8");
87
144
  const parsed = JSON.parse(raw);
88
- if (!parsed || parsed.version !== 1 || typeof parsed.projects !== 'object') {
89
- throw new Error(`Invalid specdojo.config.json: expected { version: 1, projects: { ... } }`);
145
+ if (!parsed || parsed.version !== 1 || typeof parsed.projects !== "object") {
146
+ throw new Error(`Invalid .specdojo/specdojo.config.json: expected { version: 1, projects: { ... } }`);
90
147
  }
91
148
  for (const [projectId, project] of Object.entries(parsed.projects)) {
92
149
  if (!isValidProjectConfig(project)) {
93
- throw new Error(`Invalid specdojo.config.json: projects.${projectId} must be { schedule_path, execution_path }`);
150
+ throw new Error(`Invalid .specdojo/specdojo.config.json: projects.${projectId} must omit ` +
151
+ `schedule_path/execution_path or set them to non-empty strings, ` +
152
+ `and project_context must be a string[] when present`);
94
153
  }
95
154
  }
96
155
  return { configPath, config: parsed };
97
156
  }
98
157
  export function writeConfig(config) {
99
158
  const configPath = defaultConfigPath();
100
- writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf8');
159
+ mkdirSync(dirname(configPath), { recursive: true });
160
+ writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n", "utf8");
101
161
  }
102
162
  export function registerConfigCommands(program) {
103
- const cfg = program.command('config').description('Config helpers (specdojo.config.json)');
163
+ const cfg = program
164
+ .command("config")
165
+ .description("Config helpers (.specdojo/specdojo.config.json)");
104
166
  cfg
105
- .command('init')
106
- .description('Create specdojo.config.json template (does not overwrite existing)')
167
+ .command("init")
168
+ .description("Create .specdojo/specdojo.config.json template (does not overwrite existing)")
107
169
  .action(() => {
108
170
  const { configPath, config } = loadConfig();
109
171
  if (config) {
@@ -112,21 +174,53 @@ export function registerConfigCommands(program) {
112
174
  }
113
175
  const template = {
114
176
  version: 1,
177
+ current_project: "prj-0001",
115
178
  projects: {
116
- 'shj-0001': {
117
- schedule_path: 'docs/ja/sdh-ja-projects/prj-0001/060-schedule',
118
- execution_path: 'docs/ja/sdh-ja-projects/prj-0001/070-execution',
179
+ "prj-0001": {
180
+ base_path: "docs/ja/projects/prj-0001",
181
+ project_register_path: "controls/project-register",
182
+ project_context: ["prj-overview"],
183
+ run: {
184
+ worktree_base: "../app1-worktrees",
185
+ },
119
186
  },
120
187
  },
121
188
  };
122
189
  writeConfig(template);
123
190
  process.stdout.write(`Created: ${configPath}\n`);
191
+ process.stdout.write("Next steps:\n" +
192
+ " 1. Keep this repository beside the product repository as app1-specdojo/.\n" +
193
+ " 2. Review the project ID and paths; worktrees default to ../app1-worktrees.\n" +
194
+ " 3. Optional agent setup: npx specdojo config scaffold --provider <name>\n" +
195
+ " 4. Create a register: npx specdojo register scaffold --project prj-0001\n" +
196
+ ` 5. Before using catalog or schedule, add the required paths: ${SPECDOJO_CONFIG_REFERENCE_URL}\n`);
197
+ });
198
+ cfg
199
+ .command("scaffold")
200
+ .description("Scaffold agent/settings templates for a provider")
201
+ .requiredOption("--provider <name>", "Provider template to copy (claude|codex|copilot|opencode)")
202
+ .option("--force", "Overwrite existing files", false)
203
+ .option("--dry-run", "Show planned files without writing", false)
204
+ .action(async (opts) => {
205
+ try {
206
+ await runProviderScaffold(String(opts.provider), {
207
+ packageRoot: specdojoPackageRootDir(),
208
+ repoRoot: specdojoRootDir(),
209
+ force: !!opts.force,
210
+ dryRun: !!opts.dryRun,
211
+ });
212
+ }
213
+ catch (error) {
214
+ const message = error instanceof Error ? error.message : String(error);
215
+ process.stderr.write(`${message}\n`);
216
+ process.exitCode = 1;
217
+ }
124
218
  });
125
219
  }
126
220
  export function registerProjectCommands(program) {
127
- const pj = program.command('project').description('Project registry commands');
128
- pj.command('list')
129
- .description('List projects from specdojo.config.json')
221
+ const pj = program.command("project").description("Project registry commands");
222
+ pj.command("list")
223
+ .description("List projects from .specdojo/specdojo.config.json")
130
224
  .action(() => {
131
225
  const { configPath, config } = loadConfig();
132
226
  if (!config) {
@@ -143,7 +237,7 @@ export function registerProjectCommands(program) {
143
237
  for (const [id, project] of entries) {
144
238
  const schedulePath = getProjectSchedulePath(project);
145
239
  const executionPath = getProjectExecutionPath(project);
146
- const suffix = executionPath ? `\t${executionPath}` : '';
240
+ const suffix = executionPath ? `\t${executionPath}` : "";
147
241
  process.stdout.write(`${id}\t${schedulePath}${suffix}\n`);
148
242
  }
149
243
  });
package/dist/specdojo.js CHANGED
@@ -1,13 +1,61 @@
1
1
  #!/usr/bin/env node
2
- import { Command } from 'commander';
3
- import { registerConfigCommands, registerProjectCommands } from './specdojo-config.js';
4
- import { registerExecCommands } from './exec.js';
5
- function main() {
2
+ import { fileURLToPath } from "node:url";
3
+ import { Command } from "commander";
4
+ import { evaluateDistFreshness, inspectDistEntryFreshness } from "./dist-freshness.js";
5
+ import { registerConfigCommands, registerProjectCommands } from "./specdojo-config.js";
6
+ import { registerExecCommands } from "./exec.js";
7
+ import { registerCatalogCommands } from "./catalog.js";
8
+ import { registerDeliverableCommands } from "./deliverable.js";
9
+ import { registerScheduleCommands } from "./schedule.js";
10
+ import { registerTimelineCommands } from "./timeline.js";
11
+ import { registerIndexCommands } from "./index-command.js";
12
+ import { registerRegisterCommands } from "./register.js";
13
+ import { registerRoutineCommands } from "./routine.js";
14
+ import { registerJobCommands } from "./job.js";
15
+ import { registerWatchCommand } from "./watch.js";
16
+ import { registerBuildCommand } from "./build-command.js";
17
+ import { registerYamlPagesCommands } from "./yaml-pages-command.js";
18
+ import { registerDashboardCommands } from "./dashboard.js";
19
+ import { registerGradeCommand } from "./grade.js";
20
+ import { registerAgentCommands } from "./agent.js";
21
+ import { registerKataCommands } from "./kata-command.js";
22
+ /**
23
+ * bin は dist/specdojo.js を指すため、開発チェックアウトで `npm run build` を忘れると
24
+ * 古い挙動のまま実行される。src が dist より新しい場合は警告し、exec 系は中断する。
25
+ * 配布パッケージには src が無いため、この検査は no-op になる。
26
+ */
27
+ function guardDistFreshness() {
28
+ const decision = evaluateDistFreshness(inspectDistEntryFreshness(fileURLToPath(import.meta.url)), process.argv, process.env);
29
+ if (decision.action === "none")
30
+ return true;
31
+ process.stderr.write(`${decision.message}\n`);
32
+ return decision.action !== "block";
33
+ }
34
+ async function main() {
35
+ if (!guardDistFreshness()) {
36
+ process.exitCode = 1;
37
+ return;
38
+ }
6
39
  const program = new Command();
7
- program.name('specdojo').description('SpecDojo helper CLI').version('0.4.0');
40
+ program.name("specdojo").description("SpecDojo helper CLI").version("0.4.0");
8
41
  registerConfigCommands(program);
9
42
  registerProjectCommands(program);
10
43
  registerExecCommands(program);
11
- program.parse(process.argv);
44
+ registerCatalogCommands(program);
45
+ registerDeliverableCommands(program);
46
+ registerScheduleCommands(program);
47
+ registerTimelineCommands(program);
48
+ registerIndexCommands(program);
49
+ registerRegisterCommands(program);
50
+ registerRoutineCommands(program);
51
+ registerJobCommands(program);
52
+ registerWatchCommand(program);
53
+ registerBuildCommand(program);
54
+ registerYamlPagesCommands(program);
55
+ registerDashboardCommands(program);
56
+ registerGradeCommand(program);
57
+ registerAgentCommands(program);
58
+ registerKataCommands(program);
59
+ await program.parseAsync(process.argv);
12
60
  }
13
- main();
61
+ void main();
@@ -0,0 +1,89 @@
1
+ // Markdown 成果物テンプレートは、自身の Frontmatter に生成物の Frontmatter を
2
+ // `frontmatter_template` フィールドとして持つ(document-metadata-standard.md の
3
+ // `生成物 Frontmatter 雛形`)。本モジュールはテンプレートを「生成物形」へ平坦化する。
4
+ // grade が Markdown 本文へ付与する finding は評価対象への注釈であり、テンプレートから
5
+ // 生成する成果物の一部ではない。生成処理で共通利用できるよう、平坦化と同じ境界で除去する。
6
+ const FINDING_COMMENT_LINE_RE = /^[ \t]*<!--[ \t]*specdojo:finding(?:[ \t]+[^\r\n]*?)?[ \t]*-->[ \t]*$/;
7
+ function lineBody(line) {
8
+ return line.replace(/\r\n$|[\r\n]$/, "");
9
+ }
10
+ function isBlankLine(line) {
11
+ return /^[ \t]*$/.test(lineBody(line));
12
+ }
13
+ export function stripSpecdojoFindingComments(raw) {
14
+ if (!raw.includes("specdojo:finding"))
15
+ return raw;
16
+ const lines = raw.match(/[^\r\n]*(?:\r\n|\r|\n|$)/g) ?? [];
17
+ if (lines.at(-1) === "")
18
+ lines.pop();
19
+ const output = [];
20
+ for (let index = 0; index < lines.length;) {
21
+ const line = lines[index];
22
+ if (!isBlankLine(line) && !FINDING_COMMENT_LINE_RE.test(lineBody(line))) {
23
+ output.push(line);
24
+ index += 1;
25
+ continue;
26
+ }
27
+ const whitespaceBlock = [];
28
+ let hasFinding = false;
29
+ while (index < lines.length) {
30
+ const candidate = lines[index];
31
+ const finding = FINDING_COMMENT_LINE_RE.test(lineBody(candidate));
32
+ if (!isBlankLine(candidate) && !finding)
33
+ break;
34
+ whitespaceBlock.push(candidate);
35
+ hasFinding ||= finding;
36
+ index += 1;
37
+ }
38
+ if (!hasFinding) {
39
+ output.push(...whitespaceBlock);
40
+ continue;
41
+ }
42
+ // finding の前後にあった空行は、コメント除去後には同じ空白ブロックになる。
43
+ // そのブロックだけを1空行へ畳み、finding と無関係な空白は変更しない。
44
+ const blankLine = whitespaceBlock.find(isBlankLine);
45
+ // 文末では、呼び出し側が保持する最終改行だけで十分。空行まで残すと MD012 になる。
46
+ if (blankLine !== undefined && index < lines.length)
47
+ output.push(blankLine);
48
+ }
49
+ return output.join("");
50
+ }
51
+ // テンプレートの `frontmatter_template` を出力 Frontmatter として展開し、テンプレート
52
+ // 自身のメタ情報(`id: *-template` など)と finding コメントを取り除いた文字列を返す。
53
+ // 生成時プレースホルダ(`_PROJECT_ID_` 等)は温存し、実値への置換は呼び出し側が行う。
54
+ //
55
+ // `frontmatter_template` を持たないテンプレートや Frontmatter を持たない入力は、finding
56
+ // コメントの除去以外はそのまま返す(変換前テンプレートとの後方互換のため)。
57
+ //
58
+ // SpecDojo の Frontmatter は `specdojo:` 名前空間配下に置くため、テンプレートでは
59
+ // `frontmatter_template` はインデント 2(`specdojo:` の子)に、その中身(生成物 Frontmatter
60
+ // = `specdojo:` ラッパー込み)はインデント 4 に退避される。平坦化は YAML 再シリアライズでは
61
+ // なく 4 スペースの de-indent で行い、退避前の生成物 Frontmatter をバイト等価で復元する。
62
+ export function flattenTemplateFrontmatter(raw) {
63
+ const sanitized = stripSpecdojoFindingComments(raw);
64
+ const match = sanitized.match(/^---\n([\s\S]*?)\n---(\n|$)/);
65
+ if (!match)
66
+ return sanitized;
67
+ const fmBlock = match[1];
68
+ const rest = sanitized.slice(match[0].length);
69
+ const fmLines = fmBlock.split("\n");
70
+ const ftIndex = fmLines.findIndex((line) => /^ frontmatter_template:[ \t]*$/.test(line));
71
+ if (ftIndex === -1)
72
+ return sanitized;
73
+ const nested = [];
74
+ for (const line of fmLines.slice(ftIndex + 1)) {
75
+ if (line.length === 0) {
76
+ nested.push("");
77
+ }
78
+ else if (line.startsWith(" ")) {
79
+ nested.push(line.slice(4));
80
+ }
81
+ else {
82
+ // `frontmatter_template` の後に兄弟キー(インデント 2 以下)が現れた場合は、
83
+ // それ以降を生成物 Frontmatter に含めない。変換済みテンプレートでは
84
+ // `frontmatter_template` が `specdojo:` 配下の最後のキーであり、通常は発生しない。
85
+ break;
86
+ }
87
+ }
88
+ return `---\n${nested.join("\n")}\n---\n${rest}`;
89
+ }
@@ -0,0 +1,92 @@
1
+ import { existsSync } from "node:fs";
2
+ import { isAbsolute, join, relative, resolve } from "node:path";
3
+ import { specdojoPackageRootDir } from "./package-paths.js";
4
+ import { specdojoRootDir } from "./specdojo-config.js";
5
+ const SPECDOJO_TEMPLATES_RELATIVE_DIR = "docs/ja/specdojo/templates";
6
+ // kata と schema は同じ規則で解決する。呼び出し側ごとに fallback の実装を持つと、
7
+ // eject 済みファイルと package 同梱ファイルが混在する場合に優先順位がずれるため、
8
+ // 候補の組み立てと存在判定をこのモジュールへ集約する。
9
+ function normalizedResourcePath(relativePath) {
10
+ const normalized = relativePath.replaceAll("\\", "/").replace(/^\.\//, "");
11
+ if (!normalized ||
12
+ isAbsolute(relativePath) ||
13
+ normalized === ".." ||
14
+ normalized.startsWith("../") ||
15
+ normalized.includes("/../")) {
16
+ throw new Error(`SpecDojo resource path must be repository-relative: ${relativePath}`);
17
+ }
18
+ if (normalized !== "docs/ja/specdojo" &&
19
+ !normalized.startsWith("docs/ja/specdojo/") &&
20
+ normalized !== "docs/specdojo/schemas" &&
21
+ !normalized.startsWith("docs/specdojo/schemas/")) {
22
+ throw new Error(`Unsupported SpecDojo resource path: ${relativePath}`);
23
+ }
24
+ return normalized;
25
+ }
26
+ export function specdojoResourceCandidates(relativePath, roots = {}) {
27
+ const normalized = normalizedResourcePath(relativePath);
28
+ return {
29
+ repositoryPath: resolve(roots.repositoryRoot ?? specdojoRootDir(), normalized),
30
+ bundledPath: resolve(roots.packageRoot ?? specdojoPackageRootDir(), normalized),
31
+ };
32
+ }
33
+ export function resolveSpecdojoPathIfExists(relativePath, roots = {}) {
34
+ const { repositoryPath, bundledPath } = specdojoResourceCandidates(relativePath, roots);
35
+ if (existsSync(repositoryPath))
36
+ return repositoryPath;
37
+ if (existsSync(bundledPath))
38
+ return bundledPath;
39
+ return undefined;
40
+ }
41
+ // ディレクトリを列挙する処理向け。両方が存在する場合も repository を先に返し、
42
+ // 呼び出し側が同じ相対ファイル名を先勝ちで重複除去できるようにする。
43
+ export function specdojoDirectoryPaths(relativePath, roots = {}) {
44
+ const { repositoryPath, bundledPath } = specdojoResourceCandidates(relativePath, roots);
45
+ return [...new Set([repositoryPath, bundledPath])].filter((path) => existsSync(path));
46
+ }
47
+ export function resolveSpecdojoPath(relativePath, roots = {}) {
48
+ const resolved = resolveSpecdojoPathIfExists(relativePath, roots);
49
+ if (resolved)
50
+ return resolved;
51
+ const { repositoryPath, bundledPath } = specdojoResourceCandidates(relativePath, roots);
52
+ throw new Error(`SpecDojo resource not found: ${relativePath}\n` +
53
+ `Searched repository resource: ${repositoryPath}\n` +
54
+ `Searched bundled package resource: ${bundledPath}`);
55
+ }
56
+ // plan に記載する参照は、実際に選ばれたファイルを利用者リポジトリからの相対パスで表す。
57
+ // npm 導入時は node_modules/specdojo/...、SpecDojo 自身の src/dist 実行時は docs/... になる。
58
+ // 利用者リポジトリの外へ解決された場合(別 checkout から CLI を実行した場合など)は、
59
+ // `../` で遡る相対パスが agent の作業ディレクトリ基準で不安定になるため絶対パスを返す。
60
+ export function specdojoReferencePath(absolutePath, roots = {}) {
61
+ const repositoryRoot = roots.repositoryRoot ?? specdojoRootDir();
62
+ const relativePath = relative(repositoryRoot, absolutePath).replaceAll("\\", "/");
63
+ if (relativePath === "" || relativePath === ".." || relativePath.startsWith("../")) {
64
+ return absolutePath.replaceAll("\\", "/");
65
+ }
66
+ return relativePath;
67
+ }
68
+ export function resolveSpecdojoReferencePathIfExists(relativePath, roots = {}) {
69
+ const resolved = resolveSpecdojoPathIfExists(relativePath, roots);
70
+ return resolved ? specdojoReferencePath(resolved, roots) : undefined;
71
+ }
72
+ export function resolveSpecdojoTemplatesDir(roots = {}) {
73
+ const resolved = resolveSpecdojoPathIfExists(SPECDOJO_TEMPLATES_RELATIVE_DIR, roots);
74
+ if (resolved)
75
+ return resolved;
76
+ const { repositoryPath, bundledPath } = specdojoResourceCandidates(SPECDOJO_TEMPLATES_RELATIVE_DIR, roots);
77
+ throw new Error(`Templates directory not found.\n` +
78
+ `Searched repository templates: ${repositoryPath}\n` +
79
+ `Searched bundled package templates: ${bundledPath}`);
80
+ }
81
+ // 利用者リポジトリの template を上書きとして優先し、無い場合だけ npm package に
82
+ // 同梱した原本へフォールバックする。両方に無い場合は調査できるよう探索元をすべて示す。
83
+ export function resolveSpecdojoTemplatePath(templateFileName, roots = {}) {
84
+ const relativePath = join(SPECDOJO_TEMPLATES_RELATIVE_DIR, templateFileName);
85
+ const resolved = resolveSpecdojoPathIfExists(relativePath, roots);
86
+ if (resolved)
87
+ return resolved;
88
+ const { repositoryPath, bundledPath } = specdojoResourceCandidates(relativePath, roots);
89
+ throw new Error(`Template not found: ${templateFileName}\n` +
90
+ `Searched repository template: ${repositoryPath}\n` +
91
+ `Searched bundled package template: ${bundledPath}`);
92
+ }