specdojo 0.4.7 → 0.5.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 (267) hide show
  1. package/.github/agents/specdojo-orchestrator.md +14 -9
  2. package/CHANGELOG.md +46 -0
  3. package/dist/commands/init.js +3 -0
  4. package/dist/commands/night-orchestrator.js +33 -4
  5. package/dist/dashboard/dashboard.js +5 -6
  6. package/dist/dashboard/timeline-build.js +5 -1
  7. package/dist/dashboard/timeline.js +6 -3
  8. package/dist/docs/yaml-pages.js +17 -17
  9. package/dist/exec/core.js +2 -0
  10. package/dist/exec/pipeline-state.js +5 -2
  11. package/dist/exec/plans-core.js +3 -2
  12. package/dist/exec/plans-generation.js +9 -5
  13. package/dist/exec/plans-grade-findings.js +16 -0
  14. package/dist/exec/plans-planning.js +43 -0
  15. package/dist/exec/plans-storage.js +5 -2
  16. package/dist/exec/register.js +16 -1
  17. package/dist/exec/repo-integration-sync.js +9 -0
  18. package/dist/exec/repo-integration.js +17 -2
  19. package/dist/exec/repo-trace.js +17 -4
  20. package/dist/exec/results.js +2 -0
  21. package/dist/exec/run/register-core.js +11 -0
  22. package/dist/exec/run/register-mode.js +19 -1
  23. package/dist/exec/run/register-resume.js +22 -0
  24. package/dist/exec/run/register-worktree.js +23 -0
  25. package/dist/exec/strategy.js +2 -0
  26. package/dist/exec/task-repos.js +18 -4
  27. package/dist/exec/worktree-ops-commit.js +7 -1
  28. package/dist/grade/apply.js +6 -2
  29. package/dist/grade/markdown.js +7 -2
  30. package/dist/grade/plan.js +6 -4
  31. package/dist/register/approach.js +19 -0
  32. package/dist/register/catalog-status.js +49 -0
  33. package/dist/register/core.js +3 -0
  34. package/dist/register/create-commands.js +34 -4
  35. package/dist/register/dependency.js +123 -0
  36. package/dist/register/derivation.js +2 -2
  37. package/dist/register/epic.js +42 -0
  38. package/dist/register/event-merge.js +5 -2
  39. package/dist/register/events.js +4 -0
  40. package/dist/register/external-project.js +4 -0
  41. package/dist/register/item.js +10 -0
  42. package/dist/register/maintenance-commands.js +7 -1
  43. package/dist/register/planning.js +37 -0
  44. package/dist/register/register.js +5 -1
  45. package/dist/register/renumber.js +12 -4
  46. package/dist/register/views.js +55 -4
  47. package/dist/schedule/schedule.js +3 -1
  48. package/dist/schedule/strategy-generate-scope.js +5 -1
  49. package/dist/schedule/strategy-generate.js +1 -0
  50. package/dist/schedule/strategy-profiles.js +1 -1
  51. package/dist/shared/agent-types.js +3 -0
  52. package/dist/shared/grade-result.js +23 -5
  53. package/dist/shared/markdownlint-config.js +38 -0
  54. package/dist/shared/markdownlint-scaffold.js +2 -9
  55. package/dist/shared/specdojo-config.js +10 -3
  56. package/dist/shared/specdojo-gitignore.js +4 -0
  57. package/docs/ja/specdojo/exec-templates/xep-catalog-planning-template.md +24 -0
  58. package/docs/ja/specdojo/exec-templates/xep-strategy-planning-template.md +24 -0
  59. package/docs/ja/specdojo/guides/docs-editing-guide.md +14 -1
  60. package/docs/ja/specdojo/guides/docs-structure-guide.md +10 -8
  61. package/docs/ja/specdojo/guides/exec-operation-guide.md +16 -15
  62. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +19 -1
  63. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +2 -0
  64. package/docs/ja/specdojo/guides/quick-start-guide.md +37 -14
  65. package/docs/ja/specdojo/guides/register-operation-guide.md +44 -15
  66. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +16 -16
  67. package/docs/ja/specdojo/guides/timeline-design-guide.md +37 -33
  68. package/docs/ja/specdojo/recipes/tsd-recipe.md +198 -0
  69. package/docs/ja/specdojo/references/command-reference.md +42 -4
  70. package/docs/ja/specdojo/references/specdojo-config-reference.md +20 -8
  71. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +1 -0
  72. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +1 -0
  73. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +5 -4
  74. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +3 -2
  75. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +4 -3
  76. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +8 -7
  77. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +4 -3
  78. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +1 -0
  79. package/docs/ja/specdojo/rulebooks/br-rulebook.md +1 -0
  80. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +1 -0
  81. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +1 -0
  82. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +1 -0
  83. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +1 -0
  84. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +1 -0
  85. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +3 -2
  86. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +2 -1
  87. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +1 -0
  88. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +1 -0
  89. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +2 -1
  90. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +3 -2
  91. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +1 -0
  92. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +1 -0
  93. package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +1 -0
  94. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +1 -0
  95. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +1 -0
  96. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +1 -0
  97. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +1 -0
  98. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +1 -0
  99. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +2 -1
  100. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +2 -1
  101. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +1 -0
  102. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +1 -0
  103. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +9 -6
  104. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +1 -0
  105. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +3 -1
  106. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +2 -1
  107. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +2 -1
  108. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +2 -0
  109. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +4 -2
  110. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +1 -0
  111. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +1 -0
  112. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +1 -0
  113. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +1 -0
  114. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +1 -0
  115. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +1 -0
  116. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +1 -0
  117. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +2 -1
  118. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +1 -0
  119. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +4 -3
  120. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +9 -8
  121. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +10 -9
  122. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +9 -8
  123. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +9 -8
  124. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +9 -8
  125. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +9 -8
  126. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +10 -9
  127. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +9 -8
  128. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +9 -8
  129. package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +7 -6
  130. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +1 -0
  131. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +1 -0
  132. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +1 -0
  133. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +1 -0
  134. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +2 -1
  135. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +2 -1
  136. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +50 -36
  137. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +1 -0
  138. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +1 -0
  139. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +1 -0
  140. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +1 -0
  141. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +1 -0
  142. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +1 -0
  143. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +1 -0
  144. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +1 -0
  145. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +1 -0
  146. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +1 -0
  147. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +1 -0
  148. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +1 -0
  149. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +1 -0
  150. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +1 -0
  151. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +1 -0
  152. package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +1 -0
  153. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +1 -0
  154. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +1 -0
  155. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +1 -0
  156. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +3 -2
  157. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +1 -0
  158. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +7 -6
  159. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +4 -3
  160. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +2 -1
  161. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +1 -0
  162. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +1 -0
  163. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +1 -0
  164. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +1 -0
  165. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +2 -1
  166. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +9 -8
  167. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +2 -1
  168. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +1 -0
  169. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +1 -0
  170. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +1 -0
  171. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +1 -0
  172. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +80 -61
  173. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +111 -63
  174. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +1 -0
  175. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +3 -2
  176. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +1 -0
  177. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +1 -0
  178. package/docs/ja/specdojo/samples/atc-index-sample.md +1 -1
  179. package/docs/ja/specdojo/samples/atc-sample.md +1 -1
  180. package/docs/ja/specdojo/samples/bac-sample.md +1 -1
  181. package/docs/ja/specdojo/samples/bdd-sample.yaml +1 -1
  182. package/docs/ja/specdojo/samples/bds-sample.md +1 -1
  183. package/docs/ja/specdojo/samples/bes-index-sample.md +1 -1
  184. package/docs/ja/specdojo/samples/bes-sample.md +1 -1
  185. package/docs/ja/specdojo/samples/ccd-sample.md +1 -1
  186. package/docs/ja/specdojo/samples/cdfd-sample.md +1 -1
  187. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +1 -1
  188. package/docs/ja/specdojo/samples/cdsd-sample.md +1 -1
  189. package/docs/ja/specdojo/samples/cld-sample.md +1 -1
  190. package/docs/ja/specdojo/samples/cnd-sample.md +1 -1
  191. package/docs/ja/specdojo/samples/cop-index-sample.md +1 -1
  192. package/docs/ja/specdojo/samples/cop-sample.md +1 -1
  193. package/docs/ja/specdojo/samples/cpd-sample.md +1 -1
  194. package/docs/ja/specdojo/samples/cstd-sample.md +1 -1
  195. package/docs/ja/specdojo/samples/cxd-sample.md +1 -1
  196. package/docs/ja/specdojo/samples/dmd-index-sample.md +1 -1
  197. package/docs/ja/specdojo/samples/dmd-sample.md +1 -1
  198. package/docs/ja/specdojo/samples/etc-index-sample.md +1 -1
  199. package/docs/ja/specdojo/samples/etc-sample.md +1 -1
  200. package/docs/ja/specdojo/samples/gl-sample.yaml +2 -0
  201. package/docs/ja/specdojo/samples/ifd-sample.md +1 -1
  202. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +1 -0
  203. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +1 -1
  204. package/docs/ja/specdojo/samples/ifx-file-sample.md +1 -1
  205. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +1 -0
  206. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +2 -1
  207. package/docs/ja/specdojo/samples/itc-index-sample.md +1 -1
  208. package/docs/ja/specdojo/samples/itc-sample.md +1 -1
  209. package/docs/ja/specdojo/samples/mtp-sample.md +1 -1
  210. package/docs/ja/specdojo/samples/nfr-availability-sample.md +1 -1
  211. package/docs/ja/specdojo/samples/nfr-index-sample.md +1 -1
  212. package/docs/ja/specdojo/samples/nfr-integrity-sample.md +1 -1
  213. package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +1 -1
  214. package/docs/ja/specdojo/samples/nfr-operations-sample.md +1 -1
  215. package/docs/ja/specdojo/samples/nfr-performance-sample.md +1 -1
  216. package/docs/ja/specdojo/samples/nfr-reliability-sample.md +1 -1
  217. package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +1 -1
  218. package/docs/ja/specdojo/samples/nfr-usability-sample.md +1 -1
  219. package/docs/ja/specdojo/samples/ntp-sample.md +1 -1
  220. package/docs/ja/specdojo/samples/opd-sample.md +1 -1
  221. package/docs/ja/specdojo/samples/opr-sample.md +1 -1
  222. package/docs/ja/specdojo/samples/otp-index-sample.md +1 -1
  223. package/docs/ja/specdojo/samples/otp-sample.md +1 -1
  224. package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +1 -1
  225. package/docs/ja/specdojo/samples/sac-sample.md +1 -1
  226. package/docs/ja/specdojo/samples/sf-index-sample.md +1 -1
  227. package/docs/ja/specdojo/samples/sf-sample.md +1 -1
  228. package/docs/ja/specdojo/samples/sld-sample.md +1 -1
  229. package/docs/ja/specdojo/samples/stc-index-sample.md +1 -1
  230. package/docs/ja/specdojo/samples/stc-sample.md +1 -1
  231. package/docs/ja/specdojo/samples/stsd-sample.md +1 -1
  232. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +1 -1
  233. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +1 -1
  234. package/docs/ja/specdojo/samples/sysd-index-sample.md +1 -1
  235. package/docs/ja/specdojo/samples/tsd-index-sample.md +22 -16
  236. package/docs/ja/specdojo/samples/tsd-sample.md +241 -21
  237. package/docs/ja/specdojo/samples/tsp-index-sample.md +1 -1
  238. package/docs/ja/specdojo/samples/uis-sample.md +1 -1
  239. package/docs/ja/specdojo/samples/utc-index-sample.md +1 -1
  240. package/docs/ja/specdojo/samples/utc-sample.md +1 -1
  241. package/docs/ja/specdojo/standards/document-metadata-standard.md +28 -3
  242. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +2 -0
  243. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +16 -11
  244. package/docs/ja/specdojo/standards/sample-authoring-standard.md +1 -0
  245. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +1 -1
  246. package/docs/ja/specdojo/templates/pjr-dependent-items-template.md +22 -0
  247. package/docs/ja/specdojo/templates/pjr-epic-items-template.md +22 -0
  248. package/docs/ja/specdojo/templates/pjr-epic-template.md +44 -0
  249. package/docs/ja/specdojo/templates/pjr-index-template.md +4 -2
  250. package/docs/specdojo/schemas/v1/bdd.schema.yaml +1 -1
  251. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +24 -16
  252. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +4 -1
  253. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +1 -1
  254. package/docs/specdojo/schemas/v1/gl.schema.yaml +8 -0
  255. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +5 -1
  256. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +2 -1
  257. package/docs/specdojo/schemas/v1/register-events.schema.yaml +18 -0
  258. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +40 -3
  259. package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +5 -0
  260. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +5 -0
  261. package/package.json +2 -2
  262. package/templates/antigravity/orchestrator.md +14 -9
  263. package/templates/claude/agents/specdojo-orchestrator.md +14 -9
  264. package/templates/codex/agents/specdojo-orchestrator.toml +14 -9
  265. package/templates/codex/orchestrator.md +14 -9
  266. package/templates/copilot/README.md +2 -1
  267. package/templates/opencode/agents/specdojo-orchestrator.md +14 -9
@@ -93,15 +93,16 @@ catalog へ進む段階になったら、`.specdojo/specdojo.config.json` へ `c
93
93
 
94
94
  type は次のように使い分ける。
95
95
 
96
- | type | 用途 | 終端状態 |
97
- | ---------------- | ------------------------------ | --------- |
98
- | `issue` | 解決すべき問題。原因調査を伴う | `done` |
99
- | `decision` | 選択肢から方針を決める | `decided` |
100
- | `todo` | 実施する作業 | `done` |
101
- | `question` | 判断を保留し、後で決める | `decided` |
102
- | `risk` | 将来の不確実性 | `done` |
103
- | `change-request` | 合意済み範囲の変更要求 | `done` |
104
- | `note` | 記録として残す観測・分析 | なし |
96
+ | type | 用途 | 終端状態 |
97
+ | ---------------- | ---------------------------------- | --------- |
98
+ | `issue` | 解決すべき問題。原因調査を伴う | `done` |
99
+ | `decision` | 選択肢から方針を決める | `decided` |
100
+ | `todo` | 実施する作業 | `done` |
101
+ | `question` | 判断を保留し、後で決める | `decided` |
102
+ | `risk` | 将来の不確実性 | `done` |
103
+ | `change-request` | 合意済み範囲の変更要求 | `done` |
104
+ | `note` | 記録として残す観測・分析 | なし |
105
+ | `epic` | track ごとの仕事の着手と完了の管理 | `done` |
105
106
 
106
107
  起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルの英数字の部分から導出される。タイトルが日本語の場合は、内容を表す英語の `--topic`(小文字・ハイフン区切り。例: `payment-scope`)を渡す。
107
108
 
@@ -131,6 +132,10 @@ npx specdojo register close --project <project-id> --id <PJR-XXXX> \
131
132
 
132
133
  `decision` と `question` は `--status decided` を付ける。close の前に個票の `決定内容` / `承認` を埋める。
133
134
 
135
+ `epic` は `--track <track>` で担う track を指定して起票し、具体的な作業は `--from <epic-id>` を付けた子 todo に分解する。epic 自体は `exec run --register` で実行せず、夜間の実行でも飛ばされる。子項目の状態は `register build` が生成する epic ごとのビューで確かめ、子項目と schedule を材料に人が close を判断する。
136
+
137
+ 順番のある項目は `--depends-on <PJR-XXXX>`(繰り返し指定できる)で先に終わっているべき項目を記録する。起票の由来を表す `--from`(`derived_from`)とは別の意味で、どちらかで他方を兼ねない。先行の項目がすべて `done` / `decided` になるまで、`exec run --register` は止まり、夜間の実行では飛ばされる。状態は自動では `waiting` にならない。外すときは `--depends-on -` を指定する。後続の項目は一覧の `depends_on` 列と `generated/pjr-dependent-items.md` で確かめる。
138
+
134
139
  `note` は終端させず、`open` のまま新しい事実・知見を追記する。close / reject / defer の対象にしない。対応や判断が必要になった場合は、目的に合う別の type で起票し、note は参照元として残す(`pjr-rulebook` の type 別の扱い)。
135
140
 
136
141
  ## 実践の型(kata)の扱い
package/CHANGELOG.md CHANGED
@@ -2,6 +2,52 @@
2
2
 
3
3
  SpecDojo の利用者に影響する変更を記録します。
4
4
 
5
+ ## [0.5.0] - 2026-10-29
6
+
7
+ 同梱パッケージは `@specdojo/docs-lint` 0.3.0 と `@specdojo/docs-site` 0.3.0 を同時に公開します。docs-lint 0.3.0 は、rulebook の `deliverable_type` と成果物の `type` の照合、YAML 成果物の旧 type のエラー化(下記の破壊的変更の PJR-484B・PJR-0D0T)を含みます。下記の移行手順の検査には docs-lint 0.3.0 が必要です。docs-site 0.3.0 は、生成物の `.vitepress/` への集約(PJR-9ZN5)と、Mermaid の構文エラーで生成を止めない変更(PJR-N9JC)を含みます。
8
+
9
+ ### 破壊的変更
10
+
11
+ 成果物の `type` を rulebook の宣言と照合するようにし、宣言と違う値や旧値は移行期間なしでエラーになります。次の順で移行してください。詳細は下記の各項目を参照してください。
12
+
13
+ 1. `specdojo` を 0.5.0、`@specdojo/docs-lint` を 0.3.0 に更新する(docs-site を使う場合は `@specdojo/docs-site` も 0.3.0 に更新する)。
14
+ 2. eject した rulebook に `specdojo.deliverable_type` を追加する。
15
+ 3. Markdown 成果物・sample・テンプレートの生成物 Frontmatter の `type` を宣言値に書き換え、`lint:fm` を通す。
16
+ 4. YAML 成果物の旧 type(`domain` / `command` / `message`)を置き換え、`validate:schema:yaml` を通す。
17
+ 5. `specdojo yaml-pages build` で表示ページを再生成する。
18
+
19
+ - 成果物の `type` に `requirement`(機能・非機能要件・受入基準)と `glossary`(用語集)を追加し、`project` はプロジェクトの管理文書に限定しました。各 rulebook の `specdojo.deliverable_type` を必須とし、Markdown 成果物・sample・テンプレートの生成物 Frontmatter と `lint:fm` で照合します(PJR-484B)。
20
+ - 既存の rulebook には、扱う成果物の `type` を `specdojo.deliverable_type` として追加してください。次に、その rulebook を参照する成果物・sample の `specdojo.type` と、テンプレートの `specdojo.frontmatter_template.specdojo.type` を宣言値に書き換えてください。テンプレート自身の `specdojo.type` は `template` のままにします。`lint:fm` を実行し、エラーに表示される宣言値にそろえてください。移行期間は設けず、従来の `project` や `sample` も宣言と違えばエラーにします。
21
+ - YAML 成果物も rulebook の宣言と照合します(PJR-0D0T)。既存の bdd は `type: domain` を `data`、ifx-cmd は `command` を `api`、ifx-msg の `x-spec-meta.type` は `message` を `api` に変更してください。gl には `type: glossary` と `rulebook: specdojo:gl-rulebook` を追加し、OpenAPI / AsyncAPI の `x-spec-meta` と IF 一覧にも対応する `rulebook` を記載してください。YAML テンプレートの `metadata_template.type` も宣言値に合わせ、自身の `type: template` は維持します。`npm run validate:schema:yaml` を実行し、エラーに示された置き換え先へ修正してください。旧値は即時エラーとなり、`specdojo-schema: none` / `validate=false` でもメタ情報は検証します。最後に `specdojo yaml-pages build` で表示ページを再生成してください。表示ページは元 YAML の `type` を引き継ぎます。
22
+
23
+ ### 追加機能
24
+
25
+ - `repos[].integration_strategy` に `branch-only` を指定すると、プロダクトをローカルで merge せず、commit 済みの exec branch を残してプロダクト側の PR レビューへ渡せるようにしました。既定は従来どおり `merge` です。成功後は worktree を撤去し、プロジェクト側は `review` へ進んで result に未統合・branch 名・trace key を記録します。push と PR 作成は行いません(PJR-EXH2)。
26
+
27
+ - register の子 todo からカタログの判定・生成を行う `catalog-planning` と、scope・intent の宣言から strategy・track を生成する `strategy-planning` を追加しました。対象は `domain:<domain>` / `track:<track>` で指定します。`timeline build` と strategy 生成は、カタログ作成 todo の完了から `catalog_status` を導き、手書き計画との差を警告します(PJR-WAGY)。
28
+
29
+ - register に track ごとの仕事を管理する `epic` type と個票テンプレートを追加しました。`add` / `update --track` で担当 track を記録・検証し、`--from` でつないだ子項目と状態を epic 別ビューに表示します。epic 自体は `exec run --register`・filter・夜間 queue の実行対象から外し、完了は子項目と schedule を材料に人が判断します(PJR-B4Y4)。
30
+
31
+ - 登録項目の実行順序を `depends_on` と `register add` / `update --depends-on` で指定できるようにしました。参照先・自己参照・循環を検証し、先行項目が `done` / `decided` になるまで直接実行を停止、sweep・夜間 queue を理由付きでスキップします。一覧の依存列と後続項目の逆引きビューも追加しました(PJR-6RVJ)。
32
+
33
+ ### 変更
34
+
35
+ - 配布するオーケストレーターの指示(`templates/` の各環境向け)の type の表に `epic` を加え、track を指定して起票し、子 todo へ分解し、epic 自体は実行しない扱いを書き足しました。
36
+ - 配布するオーケストレーターの指示に、`--depends-on` で順番のある項目の先行を記録し、`--from` の由来とは区別する扱いを書き足しました。
37
+ - `@specdojo/docs-site` が生成するファイルを `.vitepress/` の下にまとめました。Mermaid の SVG と manifest は `.vitepress/mermaid/`、kata のステージングは `.vitepress/kata-staging/` に出力し、ビルド結果には SVG だけを含めます。利用者の `public/` は変更しません。package 同梱の文書は `/ja/specdojo/...` で公開し、eject 済みの文書は利用リポジトリ側を優先します。`config init` が生成する `.gitignore` に `/.vitepress/dist/`・`/.vitepress/cache/`・`/.vitepress/mermaid/`・`/.vitepress/kata-staging/` を追加しました。旧配置の `public/mermaid/` と `specdojo-kata-staging/` は自動では削除しないため、不要になったら削除してください(PJR-9ZN5)。
38
+ - 技術領域別の TSD を作成する `specdojo:tsd-recipe` を追加し、`tsd-rulebook` から参照するようにしました。一冊・分冊の判断、採用値と未決事項の整理、段階的な動作確認、秘密情報の扱いを作業順に辿れます(PJR-05GN)。
39
+ - `specdojo:tsd-sample` を新しい `tsd-rulebook` に合わせて見直しました。駄菓子屋きぬや販売管理システムのデータベース詳細定義(PostgreSQL / Prisma)を題材とし、対象環境・前提条件、採用設定、導入手順、動作確認、制約・トラブルシュートを満たす完成例に再構成しました(PJR-EVAE)。
40
+ - `specdojo:tsd-index-sample` を新しい `tsd-index-rulebook` に合わせて見直しました。技術スタック一覧に版・正本と適用範囲の列を設け、開発・検証・文書化・運用の技術区分と必須・任意の区別を追加し、詳細 TSD サンプルへのリンクを整備しました(PJR-9SXH)。
41
+ - sample の `type` は見本にする成果物の種類とし、sample の識別は `id` とファイル名の `-sample` で行う原則を明文化しました。同梱 sample 5 件の `type` を揃え、既存の `type: sample` は互換性のためスキーマで許容します(PJR-XSM8)。
42
+
43
+ ### 不具合修正
44
+
45
+ - markdownlint の設定がない利用リポジトリで、result の commit 前検査が日本語の長い行(MD013)を拒否する問題を修正しました。設定がない場合は SpecDojo の基本規則を使い、既存設定は優先します。通常の `init` と `config init` は不足する `.markdownlint.yaml` を上書きせずに生成します(PJR-0QW0)。
46
+ - plan に展開する grade の finding の `anchor` と本文を、バッククォートを含む場合も壊れないインラインコードで囲むようにしました。引用元に Markdown リンクがあっても、生成した plan が `validate:history-links` に失敗しません(PJR-H988)。
47
+ - `@specdojo/docs-site` の Mermaid 図に構文エラーがあっても、`dev` は対象文書とエラーを警告してほかの図とページの生成を続けるようにしました。`build` と `mermaid` は全図を処理し、失敗した図をまとめて報告してから失敗します。失敗した図の SVG を cache に残さず、修正後の変更検知で再生成します(PJR-N9JC)。
48
+ - `register add` / `update` の `sample-maintenance` が成果物の `type` を持つ sample を拒否する問題を修正しました。索引で対象を解決し、`id` の末尾 `-sample` で判定します(PJR-XSM8)。
49
+ - `project.repos` の文書の grade 結果を `results/<repo 名>/<文書 ID>.yaml` に分離し、別リポジトリの同じ ID による上書きと前回結果の誤参照を修正しました。plan・apply・run の再開・dashboard なども同じ配置を使い、本リポジトリの既存結果の保存先は維持します(PJR-8NWR)。
50
+
5
51
  ## [0.4.7] - 2026-10-26
6
52
 
7
53
  ### 追加機能
@@ -6,6 +6,7 @@ import { runScaffold } from "../catalog/scaffold.js";
6
6
  import { runDevcontainerScaffold } from "../devcontainer/scaffold.js";
7
7
  import { runProviderScaffold } from "../shared/provider-scaffold.js";
8
8
  import { runLefthookScaffold } from "../shared/lefthook-scaffold.js";
9
+ import { ensureMarkdownlintConfig } from "../shared/markdownlint-config.js";
9
10
  import { runSlidevScaffold, SLIDEV_KATA_PATTERNS } from "../shared/slidev-scaffold.js";
10
11
  import { generateDerivedViewFiles } from "../register/register.js";
11
12
  import { defaultWorktreeBase, projectGitignoreLayout, specdojoRootDir, } from "../shared/specdojo-config.js";
@@ -559,6 +560,8 @@ export async function runInit(options, deps) {
559
560
  if (answers.slidev) {
560
561
  await runSlidevScaffold({ repoRoot, dryRun });
561
562
  }
563
+ if (!answers.lefthook && !answers.slidev)
564
+ ensureMarkdownlintConfig(repoRoot, dryRun);
562
565
  const firstProvider = answers.providers[0];
563
566
  const script = firstProvider === "claude"
564
567
  ? "orch:opus"
@@ -1,3 +1,4 @@
1
+ import { registerDependencyBlockReason } from "../register/dependency.js";
1
2
  import { spawn } from "node:child_process";
2
3
  import { mkdirSync, writeFileSync } from "node:fs";
3
4
  import { join, relative } from "node:path";
@@ -192,19 +193,47 @@ export function registerNightOrchestratorCommand(orchestrator) {
192
193
  if (!projectId)
193
194
  throw new Error("orchestrator night requires --project <id>.");
194
195
  const items = loadRegisterItems(resolveRegisterPaths({ project: projectId })).map((view) => view.item);
195
- const selected = selectApprovedNightItems(items, maxItems);
196
+ const registerPaths = resolveRegisterPaths({ project: projectId });
197
+ const dependencyOutcomes = [];
198
+ const dependencyItems = [];
199
+ const selected = selectApprovedNightItems(items, Number.MAX_SAFE_INTEGER)
200
+ .filter((item) => {
201
+ const reason = registerDependencyBlockReason(registerPaths, item);
202
+ if (!reason)
203
+ return true;
204
+ process.stdout.write(`[night] skipping ${item.id}: ${reason}\n`);
205
+ dependencyItems.push(item);
206
+ dependencyOutcomes.push({
207
+ id: item.id,
208
+ outcome: "skipped",
209
+ transition: "none",
210
+ reason,
211
+ });
212
+ return false;
213
+ })
214
+ .slice(0, maxItems);
196
215
  process.stdout.write(`[night] approved queue (${selected.length}/${maxItems}): ${selected.map((item) => item.id).join(", ") || "none"}\n`);
197
216
  if (opts.dryRun)
198
217
  return;
199
218
  const startedAt = opts.scheduledAt
200
219
  ? new Date(opts.scheduledAt).toISOString()
201
220
  : new Date().toISOString();
202
- const outcomes = [];
221
+ const outcomes = [...dependencyOutcomes];
203
222
  const approvalIssues = new Map();
204
223
  let consecutiveFailures = 0;
205
224
  let stopReason;
206
225
  for (let offset = 0; offset < selected.length; offset += parallel) {
207
- const wave = selected.slice(offset, offset + parallel);
226
+ const current = new Map(loadRegisterItems(registerPaths).map((view) => [view.id, view.item]));
227
+ const wave = selected.slice(offset, offset + parallel).filter((item) => {
228
+ const reason = registerDependencyBlockReason(registerPaths, current.get(item.id) ?? item);
229
+ if (!reason)
230
+ return true;
231
+ outcomes.push({ id: item.id, outcome: "skipped", transition: "none", reason });
232
+ process.stdout.write(`[night] skipping ${item.id}: ${reason}\n`);
233
+ return false;
234
+ });
235
+ if (wave.length === 0)
236
+ continue;
208
237
  const [command, args] = cliInvocation([
209
238
  "exec",
210
239
  "run",
@@ -270,7 +299,7 @@ export function registerNightOrchestratorCommand(orchestrator) {
270
299
  projectId,
271
300
  startedAt,
272
301
  completedAt,
273
- selected,
302
+ selected: [...dependencyItems, ...selected],
274
303
  outcomes,
275
304
  approvalIssues,
276
305
  ...(stopReason ? { stopReason } : {}),
@@ -1,7 +1,7 @@
1
- import { mkdirSync, existsSync, readFileSync, writeFileSync, readdirSync } from "node:fs";
1
+ import { mkdirSync, existsSync, readFileSync, writeFileSync } from "node:fs";
2
2
  import { join } from "node:path";
3
3
  import { toArtifactPath } from "../shared/artifact-path.js";
4
- import { readJson } from "../shared/fs.js";
4
+ import { listFilesRecursive, readJson } from "../shared/fs.js";
5
5
  import { readAllEventFiles } from "../exec/events.js";
6
6
  import { getProjectExecutionPath, getProjectRoutinesPath, getProjectSchedulePath, getProjectTimelinePath, loadConfig, loadEnv, specdojoRootDir, } from "../shared/specdojo-config.js";
7
7
  import { resolveRegisterPaths, loadRegisterItems, } from "../register/register.js";
@@ -381,11 +381,10 @@ function renderDailyRoutineSection(paths) {
381
381
  export function readDashboardGradeResults(resultsPath) {
382
382
  if (!existsSync(resultsPath))
383
383
  return [];
384
- return readdirSync(resultsPath)
385
- .filter((name) => name.endsWith(".yaml") || name.endsWith(".yml"))
384
+ return listFilesRecursive(resultsPath)
385
+ .filter((path) => path.endsWith(".yaml") || path.endsWith(".yml"))
386
386
  .sort()
387
- .flatMap((name) => {
388
- const path = join(resultsPath, name);
387
+ .flatMap((path) => {
389
388
  try {
390
389
  return [parseGradeResult(readFileSync(path, "utf8"), path)];
391
390
  }
@@ -1,6 +1,7 @@
1
1
  import { existsSync } from "node:fs";
2
2
  import { join } from "node:path";
3
3
  import { collectCatalogFilesByDomain } from "../shared/catalog-files.js";
4
+ import { resolveTimelineCatalogStatus } from "../register/catalog-status.js";
4
5
  import { loadTimelineIndex, } from "../shared/timeline-index.js";
5
6
  export { collectCatalogFilesByDomain, loadTimelineIndex };
6
7
  // depends_on の未定義参照・循環・order との矛盾を検出する。
@@ -107,6 +108,9 @@ export function buildTimeline(opts) {
107
108
  const { index, errors: loadErrors } = loadTimelineIndex(indexFile);
108
109
  const errors = [...loadErrors];
109
110
  const warnings = [];
111
+ const derived = resolveTimelineCatalogStatus(index.tracks, opts.registerPath);
112
+ index.tracks = derived.tracks;
113
+ warnings.push(...derived.warnings);
110
114
  const structure = validateTimelineTracks(index.tracks);
111
115
  errors.push(...structure.errors);
112
116
  warnings.push(...structure.warnings);
@@ -147,7 +151,7 @@ export function renderTimelineOrderMarkdown(result) {
147
151
  lines.push(`- catalog_scaffold_targets: \`${result.scaffolds.length}\``);
148
152
  lines.push("");
149
153
  lines.push(`この文書は \`tml-index.yaml\` から \`specdojo timeline build\` が生成した派生ビューです。` +
150
- `直接編集せず、\`tml-index.yaml\` を更新してください。`);
154
+ `直接編集せず、計画は \`tml-index.yaml\`、カタログ作成の完了は register の todo に記録してください。`);
151
155
  for (const wave of result.waves) {
152
156
  lines.push("");
153
157
  lines.push(`## ${wave.wave}. Wave ${wave.wave}`);
@@ -1,6 +1,6 @@
1
1
  import { existsSync, mkdirSync, writeFileSync } from "node:fs";
2
2
  import { join, resolve } from "node:path";
3
- import { getProjectCatalogPath, getProjectTimelinePath, loadConfig, loadEnv, specdojoRootDir, } from "../shared/specdojo-config.js";
3
+ import { getProjectCatalogPath, getProjectTimelinePath, getProjectRegisterPath, loadConfig, loadEnv, specdojoRootDir, } from "../shared/specdojo-config.js";
4
4
  import { buildTimeline, renderCatalogScaffoldMarkdown, renderTimelineOrderMarkdown, } from "./timeline-build.js";
5
5
  function resolveTimelinePaths(opts) {
6
6
  loadEnv();
@@ -20,9 +20,11 @@ function resolveTimelinePaths(opts) {
20
20
  throw new Error(`Unknown project: ${projectId} (check ${configPath})`);
21
21
  }
22
22
  const catalogPath = getProjectCatalogPath(project);
23
+ const registerPath = getProjectRegisterPath(project);
23
24
  return {
24
25
  timelinePath: resolve(baseDir, getProjectTimelinePath(project)),
25
26
  catalogPath: catalogPath ? resolve(baseDir, catalogPath) : null,
27
+ ...(registerPath ? { registerPath: resolve(baseDir, registerPath) } : {}),
26
28
  };
27
29
  }
28
30
  function printCommandError(error) {
@@ -37,6 +39,7 @@ function buildTimelineJson(result) {
37
39
  return (JSON.stringify({
38
40
  project_id: result.projectId,
39
41
  schedule_ready_tracks: result.scheduleReadyTracks,
42
+ track_catalog_status: Object.fromEntries(result.waves.flatMap((wave) => wave.tracks.map((track) => [track.track, track.catalog_status]))),
40
43
  waves: result.waves.map((wave) => ({
41
44
  wave: wave.wave,
42
45
  tracks: wave.tracks.map((track) => track.track),
@@ -70,8 +73,8 @@ export function registerTimelineCommands(program) {
70
73
  bcmd.option("--dry-run", "Print generated content to stdout without writing", false);
71
74
  bcmd.action((opts) => {
72
75
  try {
73
- const { timelinePath, catalogPath } = resolveTimelinePaths(opts);
74
- const result = buildTimeline({ timelinePath, catalogPath });
76
+ const { timelinePath, catalogPath, registerPath } = resolveTimelinePaths(opts);
77
+ const result = buildTimeline({ timelinePath, catalogPath, registerPath });
75
78
  for (const warning of result.warnings)
76
79
  process.stdout.write(`WARN: ${warning}\n`);
77
80
  for (const error of result.errors)
@@ -66,13 +66,9 @@ function deriveMeta(yamlRelPath, content) {
66
66
  .replace(/[^a-z0-9:_-]/g, "-");
67
67
  const rawId = readMeta("id");
68
68
  const id = typeof rawId === "string" && DOC_ID_RE.test(rawId) ? rawId : fileBase;
69
- // type は deliverable-frontmatter スキーマの enum に収まるよう配置パスから決める
70
- // (YAML 側の type は "domain" 等スキーマ外の値を取りうる)。
71
- const type = yamlRelPath.includes("/samples/")
72
- ? "sample"
73
- : yamlRelPath.includes("/templates/")
74
- ? "template"
75
- : "project";
69
+ // 分類は配置パスから推測せず正本の値を引き継ぐ。欠落・旧値は YAML 検証で扱う。
70
+ const rawType = readMeta("type");
71
+ const type = typeof rawType === "string" ? rawType : undefined;
76
72
  const rawStatus = readMeta("status");
77
73
  const status = typeof rawStatus === "string" && STATUS_VALUES.has(rawStatus)
78
74
  ? rawStatus
@@ -83,13 +79,23 @@ function deriveMeta(yamlRelPath, content) {
83
79
  const info = isRecord(record["info"]) ? record["info"] : {};
84
80
  const rawTitle = readMeta("title") ?? info["title"];
85
81
  const title = typeof rawTitle === "string" && rawTitle.trim() !== "" ? rawTitle.trim() : undefined;
86
- return { id, type, status, rulebook, ...(title ? { title } : {}) };
82
+ return {
83
+ id,
84
+ ...(type !== undefined ? { type } : {}),
85
+ status,
86
+ rulebook,
87
+ ...(title ? { title } : {}),
88
+ };
87
89
  }
88
90
  // 表示ページの Markdown を組み立てる。YAML 本文はコードブロックで埋め込み、
89
91
  // 本文中のバッククォート連続より長いフェンスを使って壊れないようにする。
90
92
  export function renderYamlPage(yamlRelPath, content) {
91
93
  const { title, ...meta } = deriveMeta(yamlRelPath, content);
92
- const frontmatter = dump({ specdojo: meta }, { lineWidth: -1 }).trimEnd();
94
+ // ジョブ定義・評価記録など、成果物の type を持たない YAML も索引に含まれる。
95
+ // その表示ページは成果物メタ情報を宣言せず、正本の型検証に委ねる。
96
+ const header = meta.type === undefined
97
+ ? []
98
+ : ["---", dump({ specdojo: meta }, { lineWidth: -1 }).trimEnd(), "---", ""];
93
99
  const fileName = posix.basename(yamlRelPath);
94
100
  const heading = title ?? fileName;
95
101
  const note = `> このページは \`${yamlRelPath}\` から生成された表示用ページです。正本は YAML ファイルであり、このページは再生成できます。`;
@@ -104,10 +110,7 @@ export function renderYamlPage(yamlRelPath, content) {
104
110
  }
105
111
  if (isDctTemplateCatalog(yamlRelPath, parsed)) {
106
112
  return [
107
- "---",
108
- frontmatter,
109
- "---",
110
- "",
113
+ ...header,
111
114
  `# ${heading}`,
112
115
  "",
113
116
  note,
@@ -123,10 +126,7 @@ export function renderYamlPage(yamlRelPath, content) {
123
126
  const fence = "`".repeat(Math.max(3, longestRun + 1));
124
127
  const body = content.endsWith("\n") ? content : `${content}\n`;
125
128
  return [
126
- "---",
127
- frontmatter,
128
- "---",
129
- "",
129
+ ...header,
130
130
  `# ${heading}`,
131
131
  "",
132
132
  note,
package/dist/exec/core.js CHANGED
@@ -16,6 +16,8 @@ const KNOWN_APPROACHES = [
16
16
  "recipe-guided",
17
17
  "freeform",
18
18
  "bootstrap",
19
+ "catalog-planning",
20
+ "strategy-planning",
19
21
  "rulebook-authoring",
20
22
  "recipe-authoring",
21
23
  "sample-authoring",
@@ -77,6 +77,7 @@ function isRepoIntegrationState(value) {
77
77
  return ((repo.status === "pending" ||
78
78
  repo.status === "merged" ||
79
79
  repo.status === "unchanged" ||
80
+ repo.status === "branch-only" ||
80
81
  repo.status === "failed") &&
81
82
  (typeof repo.commit === "string" || repo.commit === null) &&
82
83
  (typeof repo.merged_at === "string" || repo.merged_at === null) &&
@@ -176,13 +177,15 @@ export function updatePipelineRepoIntegration(state, repo, patch, updatedAt) {
176
177
  };
177
178
  }
178
179
  /**
179
- * Names of the repositories recorded as integrated (`merged` or `unchanged`) under
180
+ * Names of repositories whose handling completed (`merged`, `unchanged` or `branch-only`) under
180
181
  * `stages.integrate.repos`. A state without per-repository records yields an empty set.
181
182
  */
182
183
  export function integratedRepoNames(state) {
183
184
  const repos = state.stages.integrate?.repos ?? {};
184
185
  return new Set(Object.entries(repos)
185
- .filter(([, entry]) => entry.status === "merged" || entry.status === "unchanged")
186
+ .filter(([, entry]) => entry.status === "merged" ||
187
+ entry.status === "unchanged" ||
188
+ entry.status === "branch-only")
186
189
  .map(([name]) => name));
187
190
  }
188
191
  function resolveArtifactRef(worktreePath, ref) {
@@ -13,8 +13,9 @@ import { MISSING } from "../shared/plan-templates.js";
13
13
  export { MISSING, execTemplatePath, execTemplatesDir, injectCommonConventions, loadPlanTemplate, } from "../shared/plan-templates.js";
14
14
  import { resolveViewpointsDoc, viewpointAppliesToDocument } from "../review/plan.js";
15
15
  import { listFilesRecursive, nowUtcIsoSeconds, randomHex, tsForFilenameUtc } from "./shared.js";
16
- import { gradeFindingDisplayMessage, gradeResultPathForDocument, readGradeResultForDocument, } from "../shared/grade-result.js";
16
+ import { gradeResultPathForDocument, readGradeResultForDocument } from "../shared/grade-result.js";
17
17
  import { renderReviewGradeSummary, reviewGradeFreshness } from "../review/grade.js";
18
+ import { planGradeFindingText } from "./plans-grade-findings.js";
18
19
  export function execDocId(projectId, prefix, localBase) {
19
20
  const localId = `${prefix}-${localBase.toLowerCase()}`;
20
21
  return projectId ? `${projectId}:${localId}` : localId;
@@ -228,7 +229,7 @@ export function gradeFindingsText(projectId, targetPath) {
228
229
  if (!result || result.findings.length === 0)
229
230
  return "- なし";
230
231
  return result.findings
231
- .map((finding) => `- ${finding.id} [${finding.severity}/${finding.rule}; line=${finding.line}; anchor=${JSON.stringify(finding.anchor)}]: ${gradeFindingDisplayMessage(finding)}`)
232
+ .map((finding) => `- ${finding.id} ${planGradeFindingText(finding)}`)
232
233
  .join("\n");
233
234
  }
234
235
  catch {
@@ -5,6 +5,7 @@ import { resolveDeliverableSchemaRef, resolveKataRefs } from "../kata/kata.js";
5
5
  import { formatMarkdownFile } from "./format.js";
6
6
  import { expandTemplate } from "./shared.js";
7
7
  import { isAuthoringApproach } from "../kata/authoring.js";
8
+ import { isPlanningApproach } from "../register/planning.js";
8
9
  import { MISSING, applicableReviewCriteria, crossDeliverableTargetDetails, deliverableDependsOn, deliverableName, deliverableOverview, deliverablePath, doneCriteriaChecklist, doneCriteriaGoals, doneCriteriaItems, execDocId, findDeliverableInfo, frontmatter, gradeFindingsText, gradeFindingTargetPath, gradeResultRef, gradeTargetKind, implementationEvidence, injectCommonConventions, kataRefState, loadPlanTemplate, loadRoles, loadViewpoints, ownerRoleFields, phaseDescriptionText, projectContextSection, repoRelativePath, reviewDoneCriteriaRows, reviewGradeSummaryText, rulebookIncludesText, targetDocIds, targetDocIdsForTask, } from "./plans-core.js";
9
10
  function buildEditPlanMarkdown(template, task, deliverable, roleMap, vpMap, projectId, catalogPath, projectContext, resultRef, stem, crossDeliverables = new Map(), planOverrides) {
10
11
  const cpm = task.cpm;
@@ -87,9 +88,11 @@ function buildEditPlanMarkdown(template, task, deliverable, roleMap, vpMap, proj
87
88
  const section = [
88
89
  "## 個票の追加完了条件",
89
90
  "",
90
- deliverable?.catalogless
91
- ? "個票が定める次の条件と rulebook を満たす。"
92
- : "成果物カタログの `done_criteria` に加え、登録簿の個票が定める次の条件も満たす。",
91
+ isPlanningApproach(task.approach)
92
+ ? "次の生成手順・完了条件と、個票が定める追加条件を満たす。"
93
+ : deliverable?.catalogless
94
+ ? "個票が定める次の条件と rulebook を満たす。"
95
+ : "成果物カタログの `done_criteria` に加え、登録簿の個票が定める次の条件も満たす。",
93
96
  "",
94
97
  planOverrides.additionalConditions.trim(),
95
98
  "",
@@ -147,8 +150,9 @@ function buildReviewPlanMarkdown(template, task, deliverable, criteria, vpMap, p
147
150
  }
148
151
  async function writeTaskPlan(ctx, task, override) {
149
152
  const mode = task.mode ?? "edit";
150
- if (isAuthoringApproach(task.approach) && override?.origin !== "register") {
151
- throw new Error(`Approach ${task.approach} is register-only because schedule targets cannot express a new kata id followed by exemplar deliverables`);
153
+ if ((isAuthoringApproach(task.approach) || isPlanningApproach(task.approach)) &&
154
+ override?.origin !== "register") {
155
+ throw new Error(`Approach ${task.approach} is register-only because schedule targets cannot express its target contract`);
152
156
  }
153
157
  const localId = task.local_id;
154
158
  const targetLocalIds = [...new Set(task.target_local_ids ?? [])];
@@ -0,0 +1,16 @@
1
+ import { gradeFindingDisplayMessage } from "../shared/grade-result.js";
2
+ // 引用した文書や finding 本文の Markdown を、plan 自身のリンクとして解釈させない。
3
+ function inlineCode(value) {
4
+ const text = value.replace(/\r\n?|\n/g, " ").trim();
5
+ const longestRun = Math.max(0, ...(text.match(/`+/g) ?? []).map((run) => run.length));
6
+ const delimiter = "`".repeat(longestRun + 1);
7
+ // 端のバッククォートと区切りが結合しないよう、表示時に除去される空白を加える。
8
+ const padding = /^`|`$/.test(text) ? " " : "";
9
+ return `${delimiter}${padding}${text}${padding}${delimiter}`;
10
+ }
11
+ export function planGradeFindingText(finding) {
12
+ const anchor = inlineCode(JSON.stringify(finding.anchor));
13
+ const message = inlineCode(gradeFindingDisplayMessage(finding));
14
+ // register の箇条書き先頭でも [判定情報]: 本文 が参照リンク定義にならないようにする。
15
+ return `\\[${finding.severity}/${finding.rule}; line=${finding.line}; anchor=${anchor}\\]: ${message}`;
16
+ }
@@ -0,0 +1,43 @@
1
+ import { existsSync } from "node:fs";
2
+ import { join, relative } from "node:path";
3
+ import { loadCatalogDocs } from "../catalog/build.js";
4
+ import { loadTemplatesForDomain, resolvePlanPath } from "../catalog/plan.js";
5
+ import { resolveSpecdojoPath } from "../docs/template-resolution.js";
6
+ import { resolveKataRefs } from "../kata/kata.js";
7
+ import { planningTarget } from "../register/planning.js";
8
+ import { getProjectSchedulePath, getProjectTimelinePath, } from "../shared/specdojo-config.js";
9
+ export function planningPlanFields(opts) {
10
+ const unit = planningTarget(opts.approach, opts.target);
11
+ const path = (file) => relative(opts.repoRoot, file).replaceAll("\\", "/");
12
+ const catalogs = existsSync(opts.catalogPath) ? loadCatalogDocs(opts.catalogPath) : [];
13
+ const catalogRefs = catalogs
14
+ .map(({ doc, filePath }) => `- \`${doc.id}\`: \`${path(filePath)}\`(domain: \`${doc.domain}\`)`)
15
+ .join("\n") || "- なし。必要な上流入力を個票から確認する。";
16
+ const catalog = opts.approach === "catalog-planning";
17
+ const refs = resolveKataRefs(catalog ? "specdojo:dct-rulebook" : "specdojo:sch-rulebook");
18
+ const common = [
19
+ `### 作業単位と既存カタログ`,
20
+ "",
21
+ `対象: \`${opts.target}\`(project: \`${opts.projectId}\`)。既存カタログは読み取り、scope と依存関係の判断に取り込む。`,
22
+ "",
23
+ catalogRefs,
24
+ "",
25
+ "### 参照する実践の型",
26
+ "",
27
+ ...Object.entries(refs).map(([kind, ref]) => `- ${kind}: \`${ref}\``),
28
+ "",
29
+ ];
30
+ const projectArg = `--project ${opts.projectId}`;
31
+ if (catalog) {
32
+ const templates = loadTemplatesForDomain(resolveSpecdojoPath("docs/ja/specdojo/templates"), unit, opts.repoRoot);
33
+ if (templates.length === 0)
34
+ throw new Error(`No catalog template found for domain '${unit}'`);
35
+ const plan = path(resolvePlanPath(opts.catalogPath, unit));
36
+ common.push("### 判定・生成手順と完了条件", "", ...templates.map((template) => `- domain の雛形: \`${template.template.id}\`(\`${template.relPath}\`)`), "", `1. \`specdojo catalog plan prompt ${projectArg} --domain ${unit}\` を実行し、その入力文書・判定規約に従う。データフローがない場合は、個票が指定する上流資料を \`--input <path>\` で明示する。入力不足なら停止して必要資料を申し送る。`, "2. agent の判定を YAML に出力する。インスタンス・根拠・除外・未確定事項を記録する。既存カタログと kata を優先して参照し、テンプレート由来の構造を独自に再作成しない。", `3. \`specdojo catalog plan scaffold ${projectArg} --domain ${unit} --from <agent-output>.yaml\` で \`${plan}\` に検証保存する。prompt に入力を追加した場合は同じ \`--input\` を渡す。`, `4. \`specdojo catalog plan validate ${projectArg} --domain ${unit}\` を通す。blocking な \`open_questions\` を解消する。`, `5. \`specdojo catalog scaffold ${projectArg} --domain ${unit} --plan\` で \`dct-${unit}.yaml\`(物理分割時は全 part)を生成する。\`dct-index.yaml\` の \`size\` がない場合は個票の範囲に合わせて \`--size <small|medium|large>\` を明示する。既存ファイルは差分を確認し、必要な場合だけ \`--force\` を使う。`, `6. \`specdojo catalog validate ${projectArg}\` を通す。先に \`dct-index.yaml\` の全 domain の索引を整備し、生成した domain を登録する(物理分割も同じ domain の一項目とする)。判定計画とカタログの保存、参照・依存・完了条件の整合を完了基準とする。`, "7. 個票の作業内容・対応結果と実行記録に判断・検証結果を記録する。todo の close は runner と人が行う。close 後の `timeline build` が domain を `primary` と導く。`tml-index.yaml` は変更しない。");
37
+ }
38
+ else {
39
+ const strategy = join(getProjectSchedulePath(opts.project), `sch-strategy-${unit}.yaml`).replaceAll("\\", "/");
40
+ common.push("### scope・intent の宣言と完了条件", "", `1. \`${join(getProjectTimelinePath(opts.project), "tml-index.yaml").replaceAll("\\", "/")}\` があれば対象 track の domains と依存・着手順を確認する。\`timeline build\` の register 由来の状態と既存カタログも確認する。`, `2. \`${strategy}\` に \`scope.catalogs\`(ID・リポジトリルートからのパス)、\`scope.include_kinds\` と \`approach_rules\` を宣言する。既存 scope の意図を保ち、各成果物の \`local_ids\` と \`intent\`(例: author-deliverable / bootstrap-kata-set / confirm-deliverable)、必要時の \`kata_target\` / \`bootstrap_scope\` を根拠付きで決める。`, "3. 主担当を `owner_rules` または生成時の `--owner` / `--default-owner` で明示する。`done_criteria.roles` を主担当と解釈しない。必要な kata の grade が不足なら先に評価し、不明な判断を推測で補わない。", `4. \`specdojo schedule strategy generate ${projectArg} --track ${unit}\` を実行し、scope・intent・担当・依存関係に関するエラーを解消する。既存 strategy の変更は差分を確認し、必要な場合だけ \`--force\` を指定する。`, `5. \`specdojo schedule build ${projectArg} --track ${unit}\` を通し、\`sch-track-${unit}.yaml\` が生成され、scope の成果物とタスクの対応・依存が一致することを確認する。`, "6. strategy と track の保存、scope 全件の intent と担当の解決、生成・検証の成功を完了基準とし、個票の作業内容・対応結果と実行記録へ判断と検証を記録する。カタログ本体と `tml-index.yaml` は変更しない。");
41
+ }
42
+ return { refs, conditions: common.join("\n") };
43
+ }
@@ -3,8 +3,9 @@ import { join, relative } from "node:path";
3
3
  import { specdojoRootDir } from "../shared/specdojo-config.js";
4
4
  import { nowUtcIsoSeconds, randomHex, tsForFilenameUtc } from "./shared.js";
5
5
  import { readSpecdojoNamespace } from "../docs/frontmatter-namespace.js";
6
- import { gradeFindingDisplayMessage, gradeResultPathForDocument, readGradeResultForDocument, } from "../shared/grade-result.js";
6
+ import { gradeResultPathForDocument, readGradeResultForDocument } from "../shared/grade-result.js";
7
7
  import { lookupDocIndex } from "../docs/doc-index.js";
8
+ import { planGradeFindingText } from "./plans-grade-findings.js";
8
9
  export function archivePlan(opts, dependencies = {}) {
9
10
  const plansDir = join(opts.executionPath, "exec", "plans");
10
11
  const from = join(plansDir, `${opts.slug}-plan.md`);
@@ -43,6 +44,8 @@ const PLAN_APPROACHES = [
43
44
  "recipe-guided",
44
45
  "freeform",
45
46
  "bootstrap",
47
+ "catalog-planning",
48
+ "strategy-planning",
46
49
  "rulebook-authoring",
47
50
  "recipe-authoring",
48
51
  "sample-authoring",
@@ -132,7 +135,7 @@ export function registerGradeFindingsText(projectId, ticketPath) {
132
135
  lines.push(` - 他 ${result.findings.length - MAX_FINDINGS} 件の finding があります。詳細はサイドカーを参照してください。`);
133
136
  break;
134
137
  }
135
- lines.push(` - [${finding.severity}/${finding.rule}; line=${finding.line}; anchor=${JSON.stringify(finding.anchor)}]: ${gradeFindingDisplayMessage(finding)}`);
138
+ lines.push(` - ${planGradeFindingText(finding)}`);
136
139
  findingCount++;
137
140
  }
138
141
  docCount++;
@@ -15,6 +15,8 @@ import { formatMarkdownFile } from "./format.js";
15
15
  import { loadConfig, specdojoRootDir } from "../shared/specdojo-config.js";
16
16
  import { resolveAuthoringSources, } from "../register/authoring-sources.js";
17
17
  import { repoEnvironmentVariableName } from "./task-repos.js";
18
+ import { isPlanningApproach } from "../register/planning.js";
19
+ import { planningPlanFields } from "./plans-planning.js";
18
20
  const EDIT_TYPES = new Set(["todo", "issue", "change-request"]);
19
21
  const INVESTIGATE_TYPES = new Set(["question", "risk"]);
20
22
  export function registerItemCategory(itemType) {
@@ -395,7 +397,20 @@ export async function generateRegisterPlan(opts) {
395
397
  let cataloglessConditions = "";
396
398
  let planTargets = [targetId];
397
399
  let authoring;
398
- if (newKataKind) {
400
+ if (isPlanningApproach(item.approach)) {
401
+ const project = loadConfig(specdojoRootDir()).config?.projects[opts.projectId] ?? {};
402
+ const fields = planningPlanFields({
403
+ repoRoot: specdojoRootDir(),
404
+ projectId: opts.projectId,
405
+ project,
406
+ catalogPath: opts.catalogPath ?? "",
407
+ approach: item.approach,
408
+ target: targetId,
409
+ });
410
+ refs = fields.refs;
411
+ cataloglessConditions = fields.conditions;
412
+ }
413
+ else if (newKataKind) {
399
414
  const sourceRefs = [...(item.targets ?? []).slice(1), ...(item.sources ?? [])];
400
415
  const project = loadConfig(specdojoRootDir()).config?.projects[opts.projectId] ?? {};
401
416
  const resolvedSources = resolveAuthoringSources({
@@ -229,6 +229,15 @@ export function syncTaskWorktreesWithIntegrationTargets(params) {
229
229
  const synced = [];
230
230
  for (const product of params.worktree.repos ?? []) {
231
231
  const target = productIntegrationTarget(product);
232
+ if (product.integrationStrategy === "branch-only") {
233
+ synced.push({
234
+ repo: product.name,
235
+ target,
236
+ status: "skipped",
237
+ detail: "product-side review (branch-only)",
238
+ });
239
+ continue;
240
+ }
232
241
  if (params.integratedProducts?.has(product.name)) {
233
242
  synced.push({ repo: product.name, target, status: "skipped", detail: "already integrated" });
234
243
  continue;