specdojo 0.7.0 → 0.9.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 (462) hide show
  1. package/.github/agents/specdojo-orchestrator.md +7 -3
  2. package/CHANGELOG.md +217 -0
  3. package/dist/catalog/build.js +24 -1
  4. package/dist/catalog/catalog.js +16 -14
  5. package/dist/catalog/plan.js +1 -1
  6. package/dist/catalog/scaffold.js +4 -1
  7. package/dist/commands/agent.js +5 -3
  8. package/dist/commands/build.js +69 -10
  9. package/dist/commands/git.js +206 -0
  10. package/dist/commands/init.js +9 -3
  11. package/dist/commands/night-orchestrator.js +6 -4
  12. package/dist/commands/where.js +25 -0
  13. package/dist/dashboard/dashboard-timeline.js +18 -16
  14. package/dist/dashboard/dashboard.js +616 -261
  15. package/dist/dashboard/epic-plan.js +81 -0
  16. package/dist/dashboard/exec-records.js +16 -20
  17. package/dist/dashboard/routines.js +11 -12
  18. package/dist/dashboard/timeline-build.js +5 -9
  19. package/dist/dashboard/timeline.js +23 -18
  20. package/dist/devcontainer/scaffold.js +18 -0
  21. package/dist/docs/frontmatter-namespace.js +1 -48
  22. package/dist/docs/index-command.js +2 -2
  23. package/dist/docs/yaml-business-tables.js +243 -0
  24. package/dist/docs/yaml-interface-tables.js +106 -0
  25. package/dist/docs/yaml-pages-command.js +5 -3
  26. package/dist/docs/yaml-pages.js +268 -3
  27. package/dist/docs/yaml-table-shared.js +70 -0
  28. package/dist/docs/yaml-tables.js +39 -0
  29. package/dist/exec/agent-config.js +31 -0
  30. package/dist/exec/agent-plan.js +3 -2
  31. package/dist/exec/agent-protected-config.js +2 -0
  32. package/dist/exec/commands.js +100 -39
  33. package/dist/exec/commit-hook-skips.js +78 -0
  34. package/dist/exec/core.js +19 -7
  35. package/dist/exec/events.js +179 -8
  36. package/dist/exec/evidence.js +77 -19
  37. package/dist/exec/handoff.js +9 -13
  38. package/dist/exec/limit.js +1 -1
  39. package/dist/exec/mechanical-result.js +45 -0
  40. package/dist/exec/migrate-records.js +249 -0
  41. package/dist/exec/parent-validation.js +209 -15
  42. package/dist/exec/pipeline-state.js +27 -5
  43. package/dist/exec/plans-condense-findings.js +89 -0
  44. package/dist/exec/plans-core.js +45 -19
  45. package/dist/exec/plans-generation.js +52 -30
  46. package/dist/exec/plans-grade-findings.js +8 -3
  47. package/dist/exec/plans-kata-findings.js +61 -0
  48. package/dist/exec/plans-planning.js +3 -3
  49. package/dist/exec/plans-storage.js +12 -24
  50. package/dist/exec/post-integration.js +162 -0
  51. package/dist/exec/queue-command.js +166 -0
  52. package/dist/exec/queue.js +285 -0
  53. package/dist/exec/register-foreign-wait.js +84 -0
  54. package/dist/exec/register-resume.js +55 -56
  55. package/dist/exec/register.js +26 -22
  56. package/dist/exec/repo-integration-sync.js +21 -5
  57. package/dist/exec/repo-integration.js +21 -1
  58. package/dist/exec/reporter.js +121 -23
  59. package/dist/exec/results.js +106 -25
  60. package/dist/exec/review-completion.js +47 -0
  61. package/dist/exec/review-kata.js +112 -0
  62. package/dist/exec/run/agent-pipeline.js +78 -8
  63. package/dist/exec/run/agent.js +32 -13
  64. package/dist/exec/run/change-scope.js +365 -0
  65. package/dist/exec/run/deferred-cleanup.js +31 -0
  66. package/dist/exec/run/in-place.js +73 -33
  67. package/dist/exec/run/job-lock.js +66 -0
  68. package/dist/exec/run/job-sequence.js +137 -0
  69. package/dist/exec/run/job.js +135 -41
  70. package/dist/exec/run/lifecycle-commands.js +189 -37
  71. package/dist/exec/run/lock.js +22 -1
  72. package/dist/exec/run/mode-shared.js +11 -3
  73. package/dist/exec/run/register-command.js +14 -15
  74. package/dist/exec/run/register-core.js +20 -13
  75. package/dist/exec/run/register-mode.js +77 -17
  76. package/dist/exec/run/register-post-review.js +21 -9
  77. package/dist/exec/run/register-resume.js +95 -31
  78. package/dist/exec/run/register-state.js +23 -15
  79. package/dist/exec/run/register-worktree.js +184 -139
  80. package/dist/exec/run/schedule-mode.js +79 -18
  81. package/dist/exec/run/schedule-prepare.js +204 -59
  82. package/dist/exec/run/schedule-task.js +203 -49
  83. package/dist/exec/run/shared.js +9 -3
  84. package/dist/exec/run/trailing-records.js +35 -0
  85. package/dist/exec/run-records.js +2 -0
  86. package/dist/exec/schedule/schedule.js +116 -4
  87. package/dist/exec/shared.js +1 -1
  88. package/dist/exec/smoke.js +190 -0
  89. package/dist/exec/strategy.js +14 -3
  90. package/dist/exec/task-view.js +6 -4
  91. package/dist/exec/trailing-records.js +242 -0
  92. package/dist/exec/trial-commands.js +8 -4
  93. package/dist/exec/trial-core.js +6 -1
  94. package/dist/exec/validate-records-commit.js +110 -0
  95. package/dist/exec/validate-records.js +148 -0
  96. package/dist/exec/validation-metrics.js +181 -0
  97. package/dist/exec/worktree-cleanup-lock.js +26 -0
  98. package/dist/exec/worktree-command.js +38 -17
  99. package/dist/exec/worktree-ops-commit.js +119 -48
  100. package/dist/exec/worktree-ops-lifecycle.js +77 -48
  101. package/dist/exec/worktree-ops-merge.js +13 -2
  102. package/dist/exec/worktree-ops.js +2 -2
  103. package/dist/exec/worktree.js +32 -4
  104. package/dist/grade/apply.js +32 -6
  105. package/dist/grade/command-apply.js +3 -3
  106. package/dist/grade/command-inspect.js +7 -5
  107. package/dist/grade/command-plan.js +1 -1
  108. package/dist/grade/command-run.js +7 -1
  109. package/dist/grade/command-shared.js +1 -1
  110. package/dist/grade/core.js +18 -5
  111. package/dist/grade/markdown.js +3 -3
  112. package/dist/grade/pipeline-state.js +15 -11
  113. package/dist/grade/plan.js +37 -17
  114. package/dist/grade/result.js +3 -3
  115. package/dist/grade/run.js +87 -11
  116. package/dist/grade/target-discovery.js +17 -4
  117. package/dist/grade/targets.js +12 -11
  118. package/dist/job/definition.js +84 -8
  119. package/dist/job/job.js +109 -39
  120. package/dist/job/noop.js +104 -0
  121. package/dist/register/authoring-sources.js +22 -16
  122. package/dist/register/core.js +2 -0
  123. package/dist/register/create-commands.js +28 -3
  124. package/dist/register/deliverable-target.js +9 -1
  125. package/dist/register/epic.js +104 -26
  126. package/dist/register/event-merge.js +3 -0
  127. package/dist/register/events.js +4 -0
  128. package/dist/register/external-project.js +3 -0
  129. package/dist/register/item.js +6 -0
  130. package/dist/register/maintenance-commands.js +6 -3
  131. package/dist/register/planning.js +7 -14
  132. package/dist/register/register.js +74 -16
  133. package/dist/register/track-domains.js +34 -0
  134. package/dist/register/track-plan.js +78 -0
  135. package/dist/register/transition-commands.js +8 -0
  136. package/dist/register/work-table.js +64 -0
  137. package/dist/review/grade.js +35 -13
  138. package/dist/routine/definition.js +13 -3
  139. package/dist/routine/failure.js +30 -0
  140. package/dist/routine/routine.js +189 -71
  141. package/dist/routine/status.js +62 -0
  142. package/dist/routine/storage.js +33 -0
  143. package/dist/schedule/schedule.js +39 -39
  144. package/dist/schedule/strategy-generate-document.js +26 -14
  145. package/dist/schedule/strategy-generate-scope.js +17 -45
  146. package/dist/schedule/strategy-generate.js +33 -3
  147. package/dist/schedule/strategy-profiles.js +86 -12
  148. package/dist/shared/agent-types.js +7 -0
  149. package/dist/shared/condense-records.js +25 -0
  150. package/dist/shared/cross-process-lock.js +9 -1
  151. package/dist/shared/deprecation.js +8 -0
  152. package/dist/shared/dist-freshness.js +8 -2
  153. package/dist/shared/document-metadata.js +20 -0
  154. package/dist/shared/finding-cause.js +20 -0
  155. package/dist/shared/frontmatter-namespace.js +48 -0
  156. package/dist/shared/git-environment.js +2 -1
  157. package/dist/shared/git.js +186 -16
  158. package/dist/shared/grade-result.js +17 -1
  159. package/dist/shared/lefthook-scaffold.js +3 -0
  160. package/dist/shared/local-config.js +244 -0
  161. package/dist/shared/local-state.js +20 -0
  162. package/dist/shared/markdownlint-config.js +8 -3
  163. package/dist/shared/plan-conventions.js +129 -0
  164. package/dist/shared/plan-templates.js +57 -41
  165. package/dist/shared/run-records.js +224 -0
  166. package/dist/shared/specdojo-config.js +73 -41
  167. package/dist/shared/specdojo-gitignore.js +1 -0
  168. package/dist/shared/text.js +74 -6
  169. package/dist/shared/timeline-index.js +2 -0
  170. package/dist/shared/where-alias.js +13 -0
  171. package/dist/specdojo.js +4 -0
  172. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
  173. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
  174. package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
  175. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
  176. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
  177. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
  178. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
  179. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
  180. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
  181. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
  182. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
  183. package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
  184. package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
  185. package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
  186. package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
  187. package/docs/ja/specdojo/guides/docs-editing-guide.md +12 -0
  188. package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
  189. package/docs/ja/specdojo/guides/exec-config-guide.md +69 -19
  190. package/docs/ja/specdojo/guides/exec-operation-guide.md +97 -18
  191. package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
  192. package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
  193. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
  194. package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
  195. package/docs/ja/specdojo/guides/quick-start-guide.md +73 -17
  196. package/docs/ja/specdojo/guides/register-operation-guide.md +26 -6
  197. package/docs/ja/specdojo/guides/remote-host-development-guide.md +2 -0
  198. package/docs/ja/specdojo/guides/review-guide.md +22 -19
  199. package/docs/ja/specdojo/guides/routine-operation-guide.md +23 -12
  200. package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
  201. package/docs/ja/specdojo/guides/schedule-design-guide.md +27 -21
  202. package/docs/ja/specdojo/guides/schedule-operation-guide.md +27 -3
  203. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
  204. package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
  205. package/docs/ja/specdojo/guides/use-case-guide.md +92 -155
  206. package/docs/ja/specdojo/guides/waza-guide.md +12 -8
  207. package/docs/ja/specdojo/recipes/bac-recipe.md +111 -0
  208. package/docs/ja/specdojo/recipes/bes-recipe.md +141 -0
  209. package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
  210. package/docs/ja/specdojo/recipes/br-recipe.md +77 -0
  211. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
  212. package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
  213. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +92 -99
  214. package/docs/ja/specdojo/recipes/cnd-recipe.md +135 -0
  215. package/docs/ja/specdojo/recipes/cpd-recipe.md +140 -0
  216. package/docs/ja/specdojo/recipes/cxd-recipe.md +162 -0
  217. package/docs/ja/specdojo/recipes/ifd-recipe.md +145 -0
  218. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +112 -90
  219. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +164 -0
  220. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
  221. package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
  222. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -48
  223. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +72 -50
  224. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +40 -49
  225. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +42 -48
  226. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -81
  227. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -91
  228. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
  229. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -156
  230. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
  231. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
  232. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
  233. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
  234. package/docs/ja/specdojo/recipes/stsd-recipe.md +88 -80
  235. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +129 -0
  236. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +146 -0
  237. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +141 -0
  238. package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
  239. package/docs/ja/specdojo/references/command-reference.md +303 -148
  240. package/docs/ja/specdojo/references/deliverables-reference.md +30 -16
  241. package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
  242. package/docs/ja/specdojo/references/specdojo-config-reference.md +54 -18
  243. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
  244. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
  245. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +63 -290
  246. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +162 -80
  247. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +118 -155
  248. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +128 -60
  249. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +70 -94
  250. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
  251. package/docs/ja/specdojo/rulebooks/br-rulebook.md +58 -103
  252. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +103 -223
  253. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
  254. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
  255. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
  256. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
  257. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +51 -55
  258. package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
  259. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +81 -68
  260. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +139 -0
  261. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
  262. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +170 -0
  263. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
  264. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +79 -249
  265. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
  266. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
  267. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
  268. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +79 -249
  269. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
  270. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +115 -256
  271. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +79 -109
  272. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +119 -174
  273. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +6 -14
  274. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
  275. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
  276. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +171 -0
  277. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
  278. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
  279. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +93 -57
  280. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +63 -253
  281. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
  282. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +79 -76
  283. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +182 -237
  284. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +111 -40
  285. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
  286. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +23 -46
  287. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
  288. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +16 -40
  289. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
  290. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
  291. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
  292. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
  293. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
  294. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +12 -23
  295. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
  296. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
  297. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
  298. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
  299. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
  300. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
  301. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
  302. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
  303. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
  304. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
  305. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
  306. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
  307. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
  308. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
  309. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
  310. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
  311. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +92 -102
  312. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
  313. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
  314. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
  315. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
  316. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +45 -59
  317. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +56 -66
  318. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +54 -62
  319. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +46 -65
  320. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
  321. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +65 -97
  322. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +6 -18
  323. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +48 -78
  324. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
  325. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -153
  326. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
  327. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
  328. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
  329. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
  330. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
  331. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +106 -32
  332. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +111 -61
  333. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +129 -59
  334. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
  335. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
  336. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +46 -40
  337. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +104 -68
  338. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +64 -330
  339. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +70 -263
  340. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +58 -200
  341. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
  342. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
  343. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -71
  344. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
  345. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
  346. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
  347. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
  348. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +91 -161
  349. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
  350. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
  351. package/docs/ja/specdojo/samples/bac-sample.md +106 -21
  352. package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
  353. package/docs/ja/specdojo/samples/bds-sample.md +87 -21
  354. package/docs/ja/specdojo/samples/bes-index-sample.md +42 -20
  355. package/docs/ja/specdojo/samples/bes-sample.md +70 -21
  356. package/docs/ja/specdojo/samples/bps-sample.md +42 -54
  357. package/docs/ja/specdojo/samples/br-sample.md +57 -15
  358. package/docs/ja/specdojo/samples/ccd-sample.md +80 -19
  359. package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
  360. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +9 -7
  361. package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
  362. package/docs/ja/specdojo/samples/cdsd-sample.md +73 -20
  363. package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
  364. package/docs/ja/specdojo/samples/cld-sample.md +3 -30
  365. package/docs/ja/specdojo/samples/clis-sample.md +125 -0
  366. package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
  367. package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
  368. package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
  369. package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
  370. package/docs/ja/specdojo/samples/dec-sample.md +2 -3
  371. package/docs/ja/specdojo/samples/dss-sample.md +175 -0
  372. package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
  373. package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
  374. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
  375. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
  376. package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
  377. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
  378. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
  379. package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
  380. package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
  381. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
  382. package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
  383. package/docs/ja/specdojo/samples/pm-organization-sample.md +42 -21
  384. package/docs/ja/specdojo/samples/pm-plan-sample.md +78 -26
  385. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +41 -22
  386. package/docs/ja/specdojo/samples/pm-raci-sample.md +63 -28
  387. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
  388. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +33 -25
  389. package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
  390. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +83 -62
  391. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
  392. package/docs/ja/specdojo/samples/sf-index-sample.md +47 -20
  393. package/docs/ja/specdojo/samples/sf-sample.md +109 -21
  394. package/docs/ja/specdojo/samples/sld-sample.md +88 -21
  395. package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
  396. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
  397. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
  398. package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
  399. package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
  400. package/docs/ja/specdojo/samples/uis-sample.md +141 -20
  401. package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
  402. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
  403. package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
  404. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
  405. package/docs/ja/specdojo/templates/bac-template.md +76 -0
  406. package/docs/ja/specdojo/templates/bes-template.md +56 -0
  407. package/docs/ja/specdojo/templates/br-template.md +64 -0
  408. package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
  409. package/docs/ja/specdojo/templates/cdfd-uc-template.md +9 -5
  410. package/docs/ja/specdojo/templates/cdr-template.md +58 -0
  411. package/docs/ja/specdojo/templates/cnd-template.md +137 -0
  412. package/docs/ja/specdojo/templates/cpd-template.md +129 -0
  413. package/docs/ja/specdojo/templates/cxd-template.md +105 -0
  414. package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
  415. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
  416. package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
  417. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
  418. package/docs/ja/specdojo/templates/ifd-template.md +86 -0
  419. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
  420. package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
  421. package/docs/ja/specdojo/templates/opr-template.md +2 -4
  422. package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
  423. package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
  424. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
  425. package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
  426. package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
  427. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
  428. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
  429. package/docs/ja/specdojo/templates/stsd-template.md +46 -21
  430. package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
  431. package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
  432. package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
  433. package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
  434. package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
  435. package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
  436. package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
  437. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
  438. package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
  439. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +5 -1
  440. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +95 -8
  441. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +38 -0
  442. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
  443. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
  444. package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
  445. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  446. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
  447. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
  448. package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
  449. package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
  450. package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
  451. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  452. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
  453. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
  454. package/package.json +10 -7
  455. package/templates/antigravity/orchestrator.md +7 -3
  456. package/templates/claude/agents/specdojo-orchestrator.md +7 -3
  457. package/templates/codex/agents/specdojo-orchestrator.toml +7 -3
  458. package/templates/codex/orchestrator.md +7 -3
  459. package/templates/devcontainer/tmux.conf +6 -0
  460. package/templates/init-exec-defaults.yaml +13 -0
  461. package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
  462. package/templates/opencode/agents/specdojo-orchestrator.md +8 -4
@@ -22,6 +22,7 @@ CLI は利用リポジトリへローカル導入されるため、`npx specdojo
22
22
  - `git commit` は次の方針で行う。実行前に必ず現在のブランチを確認して提示し、`main` では commit しない(対象ブランチを提案して止まる)。
23
23
  - register の状態遷移や worktree の統合など、runner 相当の記帳は承認なしに commit してよい。register の記帳は `--commit` で commit する。
24
24
  - 自分が判断して書いた変更(実装・設定・規範文書など)は、対象ファイルと commit メッセージを提示して承認を得てから commit する。
25
+ - 書き込みを伴う git 操作(commit・merge・add・restore など)は `npx specdojo git --project <project-id> -- <git の引数>` で流し、runner の統合と同じロックに並べる。register の記帳は、これまでどおり `register ... --commit` を使う。
25
26
  - commit 先のブランチは変更の種類で決める。作業を始める前に現在ブランチを確認し、想定と違う場合は切り替えを提案してから進める。
26
27
  - register の記帳(起票・状態遷移・生成物の再構築)は、対象 project の `develop` へ直接 commit してよい。個票とイベントが項目ごとに分かれ、ID も乱数で採番されるため、並行しても衝突しない。
27
28
  - 自分が内容を書いた変更(実装・設定・規範文書など)は `feature/<project-id>/<topic>` を切ってそこへ commit する。`git push` と PR 作成は行わず、コマンドを提示して利用者へ引き渡す。
@@ -31,7 +32,7 @@ CLI は利用リポジトリへローカル導入されるため、`npx specdojo
31
32
  - 登録簿項目の実行は既定で `exec run --register` を使う。自分で実装するのは、利用者が実装者として自分を指定した場合に限る。「着手してください」は実行経路の指示であり、自分が実装してよい根拠として扱わない。実装者が読み取れない場合は確認する。
32
33
  - 状態遷移の `--by` には、実際にその判断や作業をした主体を書く。利用者が決定・承認した記録は、役割の名前(`PO` など)ではなく人の名簿の nickname で残す。自分が確かめて close する記録や、自分で行った起票・記帳は `specdojo-orchestrator` で残す。`--by` は人と agent の名簿の nickname・alias と予約名(`SpecDojo`・`specdojo-orchestrator`・`night-orchestrator`)だけを受け付け、それ以外は記帳の前にエラーで止まる。
33
34
  - 自分が直接対応した項目は `start` を経ずに `close` してよい。実行していない主体を actor とする遷移を、記録の体裁を揃える目的で追加しない。終端イベントの `reason` に対応経路を記録し、実施内容と検証結果は個票の対応結果へ残す。
34
- - `specdojo.config.json` の project に `repos` で宣言されたプロダクトリポジトリは参照してよい。変更は利用者が自分を実装者に指定した場合に限り、そのリポジトリで `feature/<project-id>/<topic>` を切って commit する。`git push` は行わない。宣言していないリポジトリは参照も変更もしない。
35
+ - `specdojo.config.json` の project に `repos` で宣言されたプロダクトリポジトリ(`.specdojo/specdojo.local.config.json` で追加・パスを差し替えたものを含む。`specdojo config show` で確かめる)は参照してよい。変更は利用者が自分を実装者に指定した場合に限り、そのリポジトリで `feature/<project-id>/<topic>` を切って commit する。`git push` は行わない。宣言していないリポジトリは参照も変更もしない。
35
36
  - 認証情報・秘密鍵・`.env`・`secrets/` を読み込まない。
36
37
  - 変更前に関連する設計書(`docs/ja/specdojo/guides/`、`docs/ja/specdojo/references/command-reference.md`)を確認する。
37
38
  - タスクに関係しない成果物やファイルを変更しない。プロジェクトの事実を捏造しない。不明点は推測で埋めず、利用者に確認する。
@@ -68,6 +69,7 @@ CLI は利用リポジトリへローカル導入されるため、`npx specdojo
68
69
  | 進捗の俯瞰 | `dashboard` | `dashboard build` |
69
70
  | 品質評価 | `grade` | `grade list` / `plan` / `apply` |
70
71
  | ドキュメントIDインデックス | `index` | `index build` |
72
+ | 保存先の確認 | `where` | `where <kind> --project <project-id>` |
71
73
  | 全生成物の一括更新 | `build` | `build` |
72
74
 
73
75
  正確なオプションは実行前に `npx specdojo <command> --help` で確認する。詳細は `docs/ja/specdojo/references/command-reference.md`、設定キーは `docs/ja/specdojo/references/specdojo-config-reference.md` を参照する。
@@ -172,6 +174,7 @@ npx specdojo exec validate --project <project-id>
172
174
 
173
175
  - `exec run --register` は `--worktree` で流す。同時に流すのは 2〜3 件までとする。親の検証は 1 件ずつ順に流れ、並行が多いと負荷で統合テストが時間切れになる。
174
176
  - 時間のかかる run は background で流し、終わりの通知を待つ。途中経過を何度も見に行かない。
177
+ - grade・`exec run`・build を順に流すときは、待ち合わせのシェルスクリプトを書かず `specdojo exec queue add <queue-id> --step "..."` で予約し、`specdojo exec queue run <queue-id>` を background で流す。進み具合は `exec queue status <queue-id>` か `exec status` の `queues:` で確かめる。止まった予約は原因を直してから同じ `exec queue run` で再開する。
175
178
  - プロセスを探す・止めるときに `pkill -f`・`pgrep -f` を使わない。探す文字列を含む自分のシェルにも一致し、自分を止める。
176
179
  - 統合の後に `src` が dist より新しくなると、次の run は始まる前に止まる。dist を作り直してから流す。
177
180
  - 記帳は `register ... --commit` で行う。登録簿の lifecycle のロックを取るため、実行中の run と取り合わない。
@@ -186,6 +189,7 @@ npx specdojo exec validate --project <project-id>
186
189
  - 完了条件にない変更(特に保護された設定や、利用者の環境に関わる設定)が入っていないかを確かめる。
187
190
  - runner や CLI の動きを変えた項目は、統合の後に実際の `exec run --register` を 1 回流して動作を確かめてから close する。生成物を変えた項目は、空のリポジトリで生成して確かめる。
188
191
  - 確かめられない条件(ホストでの確認など)が残る場合は close せず `review` のまま残し、利用者に確かめ方を示す。
192
+ - 確かめた結果、または利用者の確認で直す点が出たら、同じ目的・同じ対象のファイルの手直しは新しく起票しない。元の todo の完了条件に「n 回目の実行(日付)」として直す点を足し、`review` のまま `exec run --register` で流し直す。人の確定を待つ decision は、確定するまで開けたままにし、各回の指摘と判断を個票に足していく。目的が変わる、対象の型やファイルが変わる、元の項目を close してから時間がたっている、のどれかに当たるときだけ新しく起票する。
189
193
  - 見つけた別の問題は、元の項目を `--from` で記録して起票する。完了条件の範囲を勝手に広げない。
190
194
 
191
195
  ## 止まったときの対処
@@ -195,7 +199,7 @@ npx specdojo exec validate --project <project-id>
195
199
  | agent の rate limit・つながらない | `--fallback-executor-by` / `--fallback-reporter-by` で代わりの agent を指定して再開する。解除の時刻が分かれば待つ |
196
200
  | 親の検証の失敗(型・lint・テストの本当の失敗) | `--resume --resume-from executor` で executor からやり直す。失敗した検証の結果が引き継がれる |
197
201
  | 負荷による時間切れ | 負荷を下げてから `--resume` で親の検証を流し直す |
198
- | 統合での衝突(CHANGELOG の同じ節など) | 両方の行を残す形に exec ブランチ側をそろえてから `--resume` する。記帳のファイルの衝突は runner に任せ、手で解かない |
202
+ | 統合での衝突(同じファイルの同じ行など) | 両方の行を残す形に exec ブランチ側をそろえてから `--resume` する。記帳のファイルの衝突は runner に任せ、手で解かない |
199
203
  | 保護された設定への変更 | worktree でその変更だけを戻して `--resume` するか、`exec handoff apply` で利用者の承認のもと当てる |
200
204
  | commit の hook の失敗 | 失敗した段(markdownlint など)の出力を読み、記録のファイルを規約に合わせてから commit する |
201
205
  | 既に統合済みで再開できない | 新しい run として `--force-restart` で流す |
@@ -204,7 +208,7 @@ npx specdojo exec validate --project <project-id>
204
208
 
205
209
  - 検証できる形で書く。完了条件は `exec plan` の入力になり、曖昧だと agent が意図と違う範囲を実装する。
206
210
  - 作業を終える前に流す検査(型検査・lint・単体テスト)と、通すべき親の検証を書く。
207
- - CHANGELOG は未公開の版の節に書き、公開済みの版の節を変えないと書く。
211
+ - CHANGELOG の書き方は、プロジェクトの運用メモの決まりに従うと書く。決まりがなければ、各項目が CHANGELOG の同じ節へ直接書くと並べて流したときに統合で衝突しやすいことを踏まえ、書き方を利用者と決める。公開済みの版の節は変えないと書く。
208
212
  - 保護された設定に触れる場合、register の項目では案を個票の対応結果に書き、pipeline では報告の `handoff` にも書く。反映は利用者の承認のもとで行うと書く。「result に書く」は executor が result を直接書ける実行形式に限る。
209
213
  - 未決の点は `_UNDECIDED_` で残すか、executor に決めさせて理由を記録させるかを明記する。register の項目では個票の対応結果に書かせ、pipeline では報告の `handoff` にも書かせる。「result に書く」は executor が result を直接書ける実行形式に限る。
210
214
  - Markdown では、`*` や `_` を含む語(glob など)をコードの書式にする。コードの書式の中を空白で始めたり終えたりしない。
package/CHANGELOG.md CHANGED
@@ -4,6 +4,221 @@ SpecDojo の利用者に影響する変更を記録します。
4
4
 
5
5
  ## [Unreleased]
6
6
 
7
+ ## [0.9.0] - 2026-11-20
8
+
9
+ 同梱パッケージは `@specdojo/docs-lint` 0.5.0 と `@specdojo/docs-site` 0.6.0 を同時に公開します。動作に必要な Node.js は 22.17 以上です。
10
+
11
+ ### 利用者から見て動きが変わる点
12
+
13
+ - 動作に必要な Node.js を 22.17 以上にしました。ファイル検索を `tinyglobby` から Node.js 組み込みの `fs.globSync` へ移したためです。`@specdojo/docs-lint` も 22.13 から 22.17 へ引き上げました(PJR-5CTM)。
14
+ - `@specdojo/docs-lint` の `**` による検索は、ディレクトリへのシンボリックリンクの中へ入らなくなりました。ファイルへのシンボリックリンクは今までどおり対象です(PJR-5CTM)。
15
+ - `@specdojo/docs-lint` の markdownlint-cli を 0.50 へ上げました。ファイルの末尾に空行が続く Markdown を MD012 として検出するようになります(PJR-A5FY)。
16
+ - `<kind> where` は 1 版の移行期間の互換の入口になりました。`specdojo where <kind>` を使ってください。旧構文は標準エラーへ新構文と削除予定を警告します(PJR-JKQX)。
17
+ - schedule のタスクの agent は、track に書いた値ではなく strategy の `owner_rules[].phase_overrides[].agent`・phase の `agent` から決まります。track を直接編集すると `exec validate` と `exec run --auto` が警告します(PJR-YGZF)。
18
+
19
+ ### 追加機能
20
+
21
+ - `specdojo exec queue` を追加しました。grade・`exec run`(register・schedule)・`post-integration build-dist` を混ぜた順番を `execution/queues/<queue-id>.json` に予約し、前の段の終わりを待って順に流します。段ごとに失敗時の停止・継続を指定でき、止まった段から再開できます。進み具合は `exec queue status` と `exec status` で確かめられます(PJR-1565)。
22
+ - `specdojo exec smoke` を追加しました。統合済みの項目を確認用の個票へ記帳し、開き直して worktree で流し、今回の start と review の event と実体の actor を確かめるところまでを 1 つのコマンドで行います。`--dry-run` に対応します(PJR-8NB8)。
23
+ - `specdojo git -- <Git の引数>` を追加しました。Git の書き込みを runner と同じ lifecycle ロックに並べ、hook の実行中も排他します。読み取りはロックを待ちません。lefthook の scaffold は、run 中のロックのない commit を警告します(PJR-30SA)。
24
+ - `specdojo where <kind>` で exec・catalog・schedule・timeline・job・routine の保存先を確かめられるようにしました(PJR-JKQX)。
25
+ - git で管理しないローカル設定 `.specdojo/specdojo.local.config.json` で、`repos[].path` の差し替えとローカルのリポジトリの追加をできるようにしました。`specdojo config show` を追加し、`where exec` と executor の evidence の `local_config_overrides` でローカル由来の値を示します。`config init` は `.gitignore` にこのファイルを足します(PJR-NC9R)。
26
+ - `exec run` の worktree 実行で、統合した変更が `paths` に当たるときだけ、統合の後に `pipeline.post_integration` の固定の処理(`build-dist` = `npm run build`)を流せるようにしました。失敗しても統合は戻さず、次の `exec` は dist の鮮度の判定で止まります(PJR-8KXJ)。
27
+ - 1 段の時間を短くする設定を追加しました。`pipeline.parent_validations` の要素の `paths` で、executor が変えたファイルに合う検証だけを流します。`pipeline.commit_hook_skips` で、親の検証で済んだ検査の hook を統合の commit で流し直さないようにできます。`pipeline.mechanical_result: true` で、決まった形の edit の result を reporter の agent を起こさずに runner が作ります。worktree の準備の `npm ci` には `--prefer-offline --no-audit --no-fund` を付けました(PJR-T01P)。
28
+ - register の並べた実行・join と schedule の自動実行で、変更範囲が重なる項目を、先の項目の統合の後まで待たせるようにしました。推定できない範囲は `--unknown-scope parallel|serialize` で扱いを選べます(PJR-MJ8V)。
29
+ - command Job の `task.steps` で、exec・grade・build を順に流せるようにしました。段ごとの停止・継続、終了コードと状態ファイルによる完了の判定、ロックの有限の待機、実行時間の上限、試行ごとの段の結果を記録し、routine や cron から起動できます(PJR-V0FQ)。
30
+ - `routine status` を追加しました。routine の状態、busy で skip した回の流し直し待ち、skip の内訳つきの直近の実行履歴を表示します(PJR-KVWH)。
31
+ - agent の習熟度に最上位の `frontier` を追加しました。名前指定か `proficiency: frontier` を明示したときだけ使い、自動選択や rate limit の代わりの候補には含めません。provider の `by_proficiency.frontier` の設定が必要です(PJR-DGRZ)。
32
+ - 親の検証の記録(`parent-validation-metrics.jsonl`)に、検証ごとの待ち時間と所要時間、同時に動いている run と executor の数、Linux の負荷、時間切れのときに実行中だったテストのファイルを残すようにしました(PJR-C07H)。
33
+ - `grade run` は、完了と失敗の文書が混ざると終了コード 2、rate limit で 75 を返します。`--reference-per-kind` で、kata の各文書を同じ種別の `prj-overview` の文書と比べられます(PJR-R7BQ)。
34
+ - `specdojo yaml-pages build` が、外部システムI/F一覧(`ifx-index*.yaml`)から表形式の表示ページを生成するようになりました。連携の一覧・連携ごとの詳細・注記を表示します(PJR-QJ41)。
35
+ - 実装の段の型として、agent 向けのコーディング規約(言語別の instructions)の型 `cdr` の rulebook・sample・template を追加しました(PJR-981V)。
36
+ - VS Code 拡張の「SpecDojo: Open Document by ID」の画面仕様(`uis-open-document-by-id`)を追加しました(PJR-3MTS)。
37
+ - `@specdojo/docs-site` は、利用リポジトリに `docs/index.md` がないとき、SpecDojo の文書と project ごとのトップへのリンクを置いたトップのページを用意するようになりました。今までは `/<base>/` が 404 になっていました。`docs/` の下の project のトップ(`/ja/projects/<project-id>/`)に `index.md` がないときも、登録簿の一覧・派生ビュー・管理ログへのリンクを置いたページを用意します(PJR-PEJS)。
38
+
39
+ ### 変更
40
+
41
+ - 実践の型の rulebook と recipe から、どの成果物にも共通する文書の運用(役割の表、status の昇格と承認、公開の条件、改訂と廃止の手順、未決事項の管理台帳の列など)と、rulebook と同じ判断の言い直しを外し、ドキュメントメタ情報標準とメンバー定義への参照にしました。型ごとの判断の基準・良い例と悪い例・禁止事項・受入の確認は残しています。変えた rulebook と recipe の 137 ファイルで、空白を除いた文字数を約 24% 減らしました(kata-slim-2)。
42
+ - 区分ごとの生成を `build --only <区分>` にまとめました。index・catalog・schedule・register・dashboard・yaml-pages を選べます。今までの個別の build と `build --scope` は内部の互換用として残します(PJR-C4J1)。
43
+ - `grade` の `plan`・`apply`・`translation-plan`・`localize`・`state`・`result`・`validate`、`agent launch`・`agent run`、`exec trial`・`exec slots`・`exec scheduler` を、内部用として help の一覧から外しました。コマンドは今までどおり実行できます。定期の job(`job-grade-kata`・`job-grade-deliverable`)は `grade run` で評価します(PJR-R7BQ)。
44
+ - 画面仕様(uis)の rulebook と sample から共通の運用の記述を外し、ファイル名の規則を `uis-<term>.md` に改めました(PJR-3MTS)。
45
+ - 概念クラス図(ccd)の向きを上から下を既定にし、ccd-mermaid-rulebook に向きの決まりを足しました(PJR-K3Z2)。
46
+ - 移行計画の sample(`mip-index-sample`)を rulebook の章の構成で書き直しました。`docs/ja/index.md` の表から古い駄菓子屋の sample(`sample-gcs-projects/`・`sample-gcs-product/`)の行を外しました(PJR-QTB6)。
47
+ - exec の設定の `rate_limit_policy.on_non_critical` が互換用の必須項目で、実行時には使われないことを、schema・設定ガイド・初期設定の例に書きました。受け付ける形式と動きは変えていません(PJR-DH8E)。
48
+ - 配る依存の npm audit の high と moderate をなくしました。`tinyglobby` を依存から外し(PJR-5CTM)、`@specdojo/docs-lint` の markdownlint-cli を 0.50 へ上げました。`glob`・`minimatch` 起因の moderate は上流の修正を待ちます(PJR-A5FY)。
49
+ - YAML を正本とする業務データ辞書・ロールとメンバーの定義・レビュー観点・外部コマンドとファイルの連携仕様・旧トラック順序計画・成果物カタログ・マイルストーンの表示ページを表形式にし、YAML の正本を折りたたんで添えるようにしました(PJR-2HT5)。
50
+ - 用語集の YAML の表示ページを分類ごとの表にし、関連用語へのページ内リンクと YAML の正本の折りたたみを足しました(PJR-4YS7)。
51
+
52
+ ### 不具合修正
53
+
54
+ - `register ... --commit` の `-m` を繰り返せるようにし、`git commit -m` と同じく件名と本文の段落にしました。今までは 2 つ目の `-m` だけが message になり、commitlint に拒まれて記帳だけが残っていました。commit に失敗したときは、記帳済みで未 commit のファイルを示して終了コード 1 で終わります(PJR-Y3XS)。
55
+ - schedule のタスクの統合が、`register ... --commit` と同じ lifecycle ロックを取るようにしました。記帳の commit の途中に始まった統合が `Staged changes in integration target` で止まらなくなります(PJR-Y3XS)。
56
+ - `register ... --commit` と `specdojo git -- commit ... -- <pathspec>` の後に、commit の hook が整形して stage したファイルが index に残らないようにしました(PJR-Y3XS)。
57
+ - 完了条件の「保護された設定は変えない」「`CHANGELOG.md` は変えず」などの文のパスを変更範囲に含め、関係のない項目を順番待ちや未統合のエラーにしていた誤判定を直しました。kata を扱う run も、変更を許すディレクトリ全体ではなく個別の対象ファイルで範囲を判定します(PJR-9JN6)。
58
+ - 変更範囲の推定から、生成した plan の共通の手順と生成物を外しました。範囲の重ならない項目が、共通の文の `pjr-index.md` で順番待ちになっていました(PJR-MJ8V)。
59
+ - `kind: generated` の成果物がカタログで rulebook を宣言しているとき、rulebook-maintenance などの型の整備の段の plan が、編集対象の型を `_MISSING_`(unresolved)にせず宣言どおりに解決するようにしました(PJR-DM9B)。
60
+ - pjr の rulebook など、登録簿の個票ではない `pjr-*.md` だけを変えた run で、executor が `npm run validate:history-links` を `not_applicable` と報告すると runner が拒んで止まる不具合を直しました(PJR-8Z71)。
61
+ - `exec run` の register の再開で、wait の commit を結果なしでやり直した後や記帳を手で commit した後でも、executor が個票に書いた対応結果が再開の前の同期で消えないようにしました(PJR-EWZG)。
62
+ - executor の commit の対象外の変更で止まったときの理由に、4 件目以降のパスも含めるようにしました(PJR-1Y1M)。
63
+ - `routine` で、別の run がロックを持っていて skip した回を、済んだ回として記録しないようにしました。cron の routine は `missed_run` が `latest`・`all` のとき空いた次の `routine run --due` でその回を流し直し、interval の routine は次の回で due になります。busy の skip が 24 回を超えて続いたら、その回を済んだ回として扱います(PJR-KVWH)。
64
+ - 夜間の job の worktree の中で止まった register の子の run を、主の作業ツリーから `exec run --register <id> --resume` で再開できるようにしました(PJR-97KE)。
65
+ - `exec run` の worktree 実行で、統合の後の worktree と exec ブランチの撤去を lifecycle ロックの外で行うようにしました。撤去に時間がかかっても、別の項目の記帳と `specdojo git` が待たされません(PJR-NHT7)。
66
+ - `exec run --register` で、指名した agent が難易度別の振り分けの代わりの agent と重なるとき、start の記帳や worktree の作成の前に終了コード 1 で止まるようにしました。今までは start の後に止まり、終了コード 0 で終わっていました(PJR-A61W)。
67
+ - 文書サイトのビルドの対象から run 単位の plan と result を外し、実行記録の一覧などのリンクを GitHub の正本へ向けました。`docs:build` のメモリ不足を直しました(PJR-T4X7)。
68
+ - reporter の停止・再開と統合の停止が同じ秒に記録されたとき、イベントの並び順によって統合の再開で reporter を余分に起動していた問題を直しました(PJR-ZK3T)。
69
+ - runner が executor の condense の記録と `block_reason` を result の frontmatter へ書き写すとき、山括弧の語をコードの書式で包むようにしました。今までは lint-fm を落としていました(PJR-V141)。
70
+
71
+ ## [0.8.0] - 2026-11-16
72
+
73
+ 同梱パッケージは `@specdojo/docs-site` 0.5.0 と `@specdojo/docs-lint` 0.4.1 を同時に公開します。docs-site 0.5.0 は、対話のコードブロックの描画(`chat`・`chat tui`、PJR-GZ42)と、型の文書から作るメニュー(PJR-C8J8)を含みます。docs-lint 0.4.1 は、remark の無視対象の扱い(PJR-FTRC)と履歴リンクの検査の対象の更新(PJR-C4KF)を含みます。
74
+
75
+ ### 追加機能
76
+
77
+ - epic の予定開始日 `start_on` と `register add` / `update --start-on` を追加しました。全体計画の開始日は予定開始日、epic 自身の着手記録、先行 epic の終了日の翌稼働日の順に使います。予定開始日が期限を超えると `register build` が警告し、期間を未定として表示します(PJR-74QP)。
78
+
79
+ - `catalog validate` が、JavaScript / TypeScript の re-export だけのファイルを指す `evidence_refs` を警告するようになりました。警告で終了コードは変わりません。`catalog-planning` に状態遷移・判定・検証の本体の参照を確認する手順を追加しました(PJR-ABBM)。
80
+
81
+ - 1 文書の冗長さを直す edit approach `condense` を追加しました。修正・保持の箇所と原因を result のリストと表に記録し、Kata が原因の記録を手入れの plan へ渡します。新規生成する標準フローでは磨き込みと review の間に `condense-pass`(080、normal)を置きます。register からカタログなしでも既存成果物を指定できます(PJR-1BRQ)。
82
+
83
+ - すべての edit plan に、5種類の冗長な記述を避け、削る・まとめる・参照に置き換える規則を載せました。判断に要る背景・制約・例外・完了条件は残し、長さだけでは削りません。判定の正本である `vp-arc-conciseness` の種類と下限の言葉もそろえました。コピー済みの `xep-common-conventions-template.md` と `pm-review-viewpoints.yaml` がある場合は同期してください(PJR-0MR5)。
84
+
85
+ - grade の指摘に任意の原因 `cause`(文書または種類・箇所を示した Kata)を追加しました。Kata の手入れ plan は、宣言された Kata が原因の成果物の指摘を最新の評価から取り込みます。`fully-guided` の磨き込み plan はすべての指摘に原因を添え、原因のない旧結果も文書の指摘として扱います(PJR-SJBV)。
86
+
87
+ - docs-site に `chat` 言語コードブロックの対話描画機能(吹き出し表示および `chat tui` による TUI 風表示)を追加しました。`あなた:` で始まる利用者の発言を右側、`オーケストレーター:` などの相手側の発言を左側にアイコン付きで配置し、続き行の字下げやインラインコードを保持して表示します。`chat tui` では等幅フォント・暗い背景・プロンプト記号(利用者 `>`, 相手側 `●`)で描画します。あわせて Quick Start ガイドの対話コードブロックを `chat` に更新しました(PJR-GZ42)。
88
+
89
+ - devcontainer の構成で tmux を含める場合(`--tmux`、または preset が `recommended` 以上、`init --devcontainer` を含む)に、`.devcontainer/tmux.conf` を生成し、生成する `post-create.sh` で `~/.tmux.conf` へリンク(`ln -sfn`)するようにしました。マウス操作・クリップボード・256 色の設定を含み、利用者が既に独自の `~/.tmux.conf`(通常ファイル)を持っている場合は上書きしません。tmux を含めない構成では `tmux.conf` もリンク処理も生成しません(PJR-8TDX)。
90
+
91
+ - `exec unblock --take-over` を追加しました。人だけが使え、unblock した人が claim の持ち主になります。人が引き取って自分で `exec complete` するときに使います(PJR-M495)。
92
+
93
+ - `exec resume --task <id> --resume-from executor` が、統合の段(commit・検査・merge)で止まった schedule のタスクも受け付けるようになりました。executor を起動する前に統合先を exec branch と worktree へ取り込み、成果と run の記録を保ったまま executor → reporter → 統合をやり直します。統合が成功済み・一部統合済み・merge 済みの run と、worktree が merge の途中の run は断ります(PJR-ED0K)。
94
+
95
+ - `grade list|plan|run|apply|result` が YAML の成果物と sample に対応しました。最上位または `x-spec-meta` のメタ情報を読み、元の YAML の内容ハッシュと行番号で評価結果をサイドカーに保存します(PJR-CBV6)。
96
+
97
+ - `grade run --if-busy fail|wait` で、同じ project の grade の終了を待つかを選べるようになりました(PJR-E4R5)。
98
+
99
+ - CLI 仕様(clis)の型を新設しました。コマンドリファレンスを参照して、操作の流れ、出力と生成ファイルの要点、終了コード、エラー表示と利用者の次の手、入力情報・出力情報(ファイル、標準入力、環境変数、対話、API 連携、外部コマンドの起動)を書きます。`specdojo:clis-rulebook`・`specdojo:clis-sample`(PJR-VMXK・6AQF・1K77・1D1X)。
100
+
101
+ - GUI の色・文字・余白、部品、レイアウト、状態表示、アクセシビリティを定めるデザインシステム(DSS)の型と、駄菓子屋の販売管理 GUI の完成例を追加しました(PJR-JB6S)。
102
+
103
+ - pre-push で、push する commit の実行記録の配置(CI の Check execution record layout と同じ `exec validate --records-only`)を検査するようにしました。`exec validate --records-only --commit <rev>` で任意の commit を検査できます(PJR-1ZQK)。
104
+
105
+ - project を別のリポジトリへ移す手順と安全確認をまとめたガイドを追加しました(PJR-7RZ4)。
106
+
107
+ ### 変更
108
+
109
+ - 外部コマンド連携仕様(ifx-cmd)の型を手入れし、引数・オプションの表は持たずに正本(コマンドリファレンス、exec-defaults.yaml の command_template と exec-config-guide.md、外部公式ドキュメント等)を参照(`command.reference`)し、仕様書には入出力の約束(渡すもの・受け取るもの・終了コードの意味・作るファイル・副作用・失敗の扱い)に絞って記述する規則に変更しました。あわせて `ifx-cmd.schema.yaml`、`ifx-cmd-recipe`、`ifx-cmd-sample`、`ifx-cmd-template` を新規則に合わせ、`files`・`side_effects` プロパティや終了カテゴリ `rate_limit` を追加しつつ、従来の引数定義を含む既存文書の後方互換性を維持しています(PJR-4N3R)。
110
+
111
+ - システム化機能(sf)の型を手入れし、個別機能仕様(`sf-<term>`)は機能の目的と業務プロセス仕様(BPS)・画面仕様(UIS)との対応に絞り、コマンドの使い方やオプション、操作手順はコマンドリファレンスや各種ガイドを参照する規則に変更しました。あわせて `sf-rulebook` と `sf-sample` を新規則に対応させ、`rulebook-authoring-standard` に準拠した標準章構成(目的と概要、業務プロセス・画面との対応、入出力と前提条件、処理要件、非機能制約、操作手順・コマンド参照、検証・受入観点、未決事項)へ揃えました。なお、全体構成を扱う `sf-index` の型および schema は変更していません(PJR-C1RG)。
112
+
113
+ - 業務データ辞書(BDD)の型を手入れし、スキーマがあるエンティティは正本スキーマを参照(`schema_ref`)して `fields` にはスキーマから読めない業務上の意味のみを記載し、型や制約の重複を排除する規則に変更しました。スキーマのないエンティティは、開発フェーズや正本の所在に応じてスタンドアロン定義(今の形)または TypeScript の型参照(`type_ref`)を選択する選定基準を明記しました。あわせて `bdd.schema.yaml` と `bdd-sample` を新規則に対応させ、既存のスタンドアロン記述との後方互換性を維持しています(PJR-MECY)。
114
+
115
+ - 分類一覧(CDT)の型を手入れし、schema の enum や TypeScript の union 型を正本として参照(`schema_ref` / `type_ref`)し、分類一覧には値そのものの機械的な列挙を繰り返さず、値ごとの業務上の意味と使い分け・選定基準に絞って記述する規則に変更しました。実装に型定義が存在しない業務上の分類(人が判断する区分など)は、スタンドアロン形式で値の一覧と成立条件を記述する選定基準を明記しました。あわせて `cdt-rulebook` を Rulebook 記述標準に準拠させ、`cdt-sample` を新規則に適合させました(PJR-7FXC)。
116
+
117
+ - 概念クラス図(CCD)の型 `specdojo:ccd-mermaid-rulebook` と `specdojo:ccd-sample` を手入れしました。クラス属性は主キーのみとし、そのほかの属性は業務データ辞書(bdd)を参照する規則へ変更しました。Mermaid 図と本文は関係の意味(役割名)・多重度・関係の種類に絞り、関連ごとに多重度の業務上の根拠を記述する形式に統一しました(PJR-M7KD)。
118
+
119
+ - 分類一覧(Classification List)の略号を cld から cdt(code table)に変え、新しい型 `specdojo:cdt-rulebook`・`specdojo:cdt-sample`・`specdojo:dct-data-model-cdt-template` を追加しました。旧 ID(`cld-rulebook`、`cld-sample`、`dct-data-model-cld-template`)は非推奨とし、移行の案内のみを残しています。prj-0001 のカタログ `dct-data-model-cld.yaml` を `dct-data-model-cdt.yaml` へ更新し、成果物の略号を `cdt-*` に揃えました(PJR-HMV6)。
120
+
121
+ - `exec validate` に実行記録の配置、plan・result・evidence の欠落、Git に無視されていない lock の検査を追加しました。`--records-only` は配置のみ、`--schedule-only` は schedule・event のみを検査します。`exec run`・`exec cycle` の事前検証は後者を使い、生成途中や中断中の記録があっても実行・再開できます。2 ガイドの構成図を配置モジュールと照合するテストを強化し、派生ビューと lock の配置説明を現行実装にそろえました(PJR-JT5J)。
122
+
123
+ - 旧配置の実行記録を `git mv` で run ごとのディレクトリへ移す `exec migrate-records`(`--dry-run` 対応)を追加しました。参照パスを更新し、通常の読み取りを `execution/runs/` に統一しました。完了した plan は同じ run に保持します。移行には Git index に書き込める環境と、対象 run の worktree の撤去が必要です(PJR-9BY9)。
124
+
125
+ - 保存する exec plan の共通規約を SHA-256 の版への参照にし、規約本体は `execution/conventions/` に版ごとに一度だけ保存するようにしました。agent・reporter への prompt では従来の全文を復元します。再開と `exec run --plan` に対応し、旧 plan もそのまま読めます。参照先の欠落やハッシュの不一致は、原因を示して停止します(PJR-BVS9)。
126
+
127
+ - 新しい実行の plan・result・evidence・ログを `execution/runs/<出どころ>/<項目 ID>/<run ID>/` にまとめ、配置の決定と旧記録の探索を共通モジュールに集約しました。register・schedule・job と再開処理に適用し、既存の `exec/plans`・`exec/results`・`exec/evidence` は移動せず読み取ります(PJR-Z0XR)。
128
+
129
+ - routine の状態・履歴・lock を端末側の状態ディレクトリへ移し、旧 `generated/` の状態を初回利用時に引き継ぎます。dashboard も同じ記録を参照します。Job Run のない失敗だけを Git に残し、成功・skip や成果物を変更しなかった Job の実行記録は commit しません(PJR-PZBP)。
130
+
131
+ - prj-0001 の廃止済みプロダクト文書22件を `docs/` 外の `archive/ja/product/trash/` へ移し、文書サイトと doc index の対象から外しました。既存の wikilink はサイトから archive のソースへ解決します。週報の出力先を `reporting/progress-reports/` にそろえ、初回保存時に作成されることと、週報 routine が無効なサンプルであることをガイドに明記しました(PJR-XD12)。
132
+
133
+ - tml の Kata と Timeline 設計ガイドを非推奨にし、ガイドとリファレンスを epic による全体計画へ更新しました。prj-0001 の 3 件の epic に `domains` を記録し、旧 `tml-index` をカタログから外しました。旧ファイルは互換用に保持します(PJR-JM29)。
134
+
135
+ - 全体計画を epic から生成するようにしました。`register add --type epic --track <track> --domain <domain>`(`--domain` は繰り返し可)で対象 domain を記録し、epic の `depends_on`、着手・完了履歴、`due_on` を使って `dashboard build` がガントと未作成カタログを `execution/generated/` へ出力します。strategy の範囲は既存 scope、epic の domains、旧 timeline の順で解決します。`tml-index.yaml`・`timeline build`・`timeline_path` は非推奨となり、互換読み込みと警告を残しています。移行時は track ごとに epic を一つ作り、domain と epic 間の依存・期限を移してください。期限のない epic の終了日は未定と表示します。strategy-planning の起票には対象 track を担う epic が必要です(PJR-PE19)。
136
+
137
+ - opr の template で H1 直下の概要の段落をなくし、「1. 概要」の章の中へ一本化しました。bps は導入文と概要の役割が分かれているため現状を維持します(PJR-9CVE)。
138
+
139
+ - grade の executor に、判定の根拠と finding を最初から日本語で書かせるようにしました。英語の既存の finding は英語・日本語の両方で照合して引き継ぎ、日本語を新しい正本にします。英語の finding が残った場合だけ翻訳の段を流します(PJR-YYDS。PJR-27Y0 の英語を正本にする方式を改めました)。
140
+
141
+ - Schedule の `exec run`・`exec resume`・`exec cycle` は、run の終わりに、統合の後に runner が書いたイベントと run の記録を記帳の commit 1 件にまとめるようになりました。作業ツリーに実行記録が残らず、develop には run ごとに記帳の commit が 1 件加わります。記帳の commit は、plan・result・evidence がそろわない run を外して知らせます(PJR-DVNV・1ZQK)。
142
+
143
+ - `exec status` の `by` 列と `--by` の絞り込みは、最後に event を書いた actor ではなく claim の持ち主を表すようになりました。人が `exec unblock` しても claim の持ち主は変わりません(PJR-M495)。
144
+
145
+ - exec plan の共通規約に、個票の作業内容の表の各行の状態とメモを実績に合わせる指示を足しました。executor が実行できない行は理由をメモに書いて open のまま残します(PJR-N6GK)。親の検証を evidence に書く場合は、検査ごとに 1 行ずつ書くよう求めます(PJR-Q2AT)。
146
+
147
+ - `schedule strategy generate` の `bootstrap-kata-set` と `improve-kata` が、rulebook・recipe・sample・template を順に同期する段を作るようになりました。型を整備する schedule の review は、代表の成果物に加えて型一式を自動で grade し、型の最新の grade がすべて pass になるまで完了を保留します(PJR-N2CP・E4R5・X05N)。
148
+
149
+ - 外部システムI/F一覧の schema を `docs/specdojo/schemas/v1/ifx-index.schema.yaml` に改名しました。古い名前は非推奨の別名として残り、今後削除します。YAML 先頭の modeline と `validate:schema:file --schema` の指定を新しい名前に書き換えてください。あわせて、一覧の `id` に許す形を `ifx-index`・`ifx-index-...` に限りました(PJR-SBNB)。
150
+
151
+ - `@specdojo/docs-site`:ルール・レシピ・サンプル・テンプレートのメニューを、`docs/ja/specdojo/` の型の文書(rulebook の frontmatter の `recipe`・`sample`・`template`・`includes` と `deliverable_type`)から自動で作るようにしました。利用者のリポジトリで足した型も同じ仕組みでメニューに出ます。サンプルの「運用」のグループ分けをなくし、個別の sample を各項目の下に並べます(PJR-C8J8)。
152
+
153
+ - `@specdojo/docs-lint`:`specdojo-docs-lint remark` が `--silently-ignore` を自動で付け、`.remarkignore` の無視対象をエラーにせずに飛ばすようになりました(PJR-FTRC)。`validate:history-links` の対象に、現行の実行記録の配置(`execution/runs/<origin>/<item>/<run>/` の `plan.md`・`result.md`)を含めました(PJR-C4KF)。
154
+
155
+ - 型(Kata)を手入れしました。
156
+ - 画面仕様(uis)を GUI の画面仕様だけの規則にし、標準の章構成、章別の判断基準、入力境界・会計結果の確認・回復操作を含む GUI 販売登録画面の完成例を整えました(PJR-X3T8・0YNQ・VZT1)。
157
+ - 状態遷移(stsd)の型を、目的・状態の判定・状態遷移の章立てにし、遷移 ID、分割した図の初期点・終了点、表示名(状態名と値)の決まりを足しました。
158
+ - 概念データフロー(cdfd)の詳細の sample と template を、全体概要で採用した D2 にそろえました(PJR-AWW3・T123)。ユースケース別 CDFD に共通の領域・例外の図の分け方と絵文字の決まりを足しました(PJR-87KE)。
159
+ - 業務仕様の型(BES・BR・BDD)とドキュメントメタ情報標準に、改訂・置き換え(`supersedes`)・廃止(`deprecated`)のときの波及の追い方を足しました(PJR-8E7Z)。ifx-cmd・bes・sf・cdt・ccd の記述の不整合を直しました(PJR-8BSV)。
160
+ - プロジェクトの型 7 種類の recipe・template を rulebook に合わせ、プロジェクト文書向けの rulebook の成果物 ID の規則をドキュメント ID 標準に合わせました(PJR-KBRM・80F5)。
161
+ - br・bes・bac・opr の template の `frontmatter_template` の `id` を `_LOCAL_ID_` にしました(PJR-8ZX8)。
162
+ - 受入基準(bac)、データモデル(sld)、画面の作業の流れ(bds)、外部ファイル連携(ifx-file)、成果物カタログの索引(dct-index)、システム設計(sysd)、コンテキスト図(cxd)、コンポーネント配置(cpd)、外部 I/F 定義(ifd)・外部システム I/F 一覧(ifx-index)の型を確定しました。bds・sld・ifx-file の sample と cdfd の sample・template は、0.8.0 の前の手直しで grade が pass になりました(PJR-D948・C6BA・KV37・AWW3・T123)。
163
+
164
+ - 用語集の見出しをガイドと CLI で使う呼び名にそろえ、日本語の旧称を別名として残しました(PJR-EBN6)。オーケストレーターは、確認で直す点が出たとき同じ目的・同じファイルの手直しを新しく起票せず、元の todo に直す点を足して流し直します(PJR-BFW0)。CHANGELOG に書く決まりは、プロジェクトの運用メモに従います(PJR-KSGC)。
165
+
166
+ - 用語集の型(gl)を確定した用語集の実績に合わせ、英語の表記・注記・領域の分け方・ID を変えない決まり・参照の範囲を定め、駄菓子屋の完成例を広げました(PJR-BNK5)。
167
+
168
+ ### 不具合修正
169
+
170
+ - `register --commit` が、実行中に別タスクの記録した block event などを stage・commit に巻き込む問題を修正しました。更新するパスだけを対象とし、失敗と中断時は自分の stage だけを解除します。worktree 統合では無関係な stage 済み変更も merge 前に検出し、対象パスと解除手順を表示します(PJR-HQVE)。
171
+
172
+ - 保存する plan の共通規約への参照を、ハッシュとルート相対パスのインラインコードに変更しました。末尾の参照だけを復元し、本文の記法例による誤検出を防ぎます。旧形式も読み取り、`validate:history-links` は新配置の plan・result も検査します。旧形式の末尾の規約リンクだけは互換用に許容します(PJR-G1W9)。
173
+
174
+ - executor から同じ run を再開するとき、前回のログを `*.attempt-N.*` へ移すようにしました。成功した再開に前回の親検証の失敗ログが元の名前で残る問題を修正し、退避した evidence の参照先も更新します。reporter から再開するときは、引き継ぐ evidence が参照する executor のログを元の名前で保持します(PJR-8YH0)。
175
+
176
+ - `exec validate` が evidence 導入前の run、移行で plan・result を別 run に集約した先行試行、旧配置の記録を欠落・配置違反として扱う問題を修正しました。残る一部だけの記録は通常は警告、`--records-only` ではエラーにします。grade の生成物と空の lock のディレクトリも検査から除外します。検査のための `exec migrate-records` は不要ですが、旧記録の通常の探索には移行が必要です(PJR-KC0T)。
177
+
178
+ - register の worktree 統合で許可外の追加などが残ると、commit・merge を止めて項目を `waiting` にし、worktree を保持するようにしました。移動元の削除だけが統合されることを防ぎ、停止理由にログの場所と代表パス、最後の要約に未 commit の件数を表示します。承認後に対象を手動 commit して `--resume` する手順を運用ガイドへ追加しました(PJR-BRN4)。
179
+
180
+ - 旧配置で開始した run を再開すると evidence・ログが別のディレクトリに書かれ、統合時に失われる問題を修正しました。再開後も元の run ID と保存先を維持し、result の配置にかかわらず同じ run の記録と退避した試行を commit 対象に含めます。除外した別 run の記録は標準出力と `integrate.log` に表示します(PJR-TA6W)。
181
+
182
+ - 実行記録の保存前の伏せ字を AWS・Google・Slack・GitHub fine-grained token・Anthropic・JWT・秘密鍵 PEM・URL の認証情報へ広げました。依存なしで実行できる `node tools/check-evidence-secrets.mjs` を追加し、指定ファイル、ステージ上の実行記録(`--staged`)、追跡中の実行記録(`--tracked`)を値を表示せず検査できます。hook / CI への登録は承認後に反映する設定案として記録しました(PJR-FMA4)。
183
+
184
+ - `draft`・`fully-guided`・`recipe-guided` の edit plan に、カタログの `evidence_refs` を読み取り専用の実装の根拠として展開するようにしました。未指定・カタログなしでも停止せず、未作成の `depends_on` は「未作成」と示し、内容を仮置きして進めます。実装・書き方・意図の根拠の使い分けも明記しました(PJR-H2V8)。
185
+
186
+ - `exec resume --task <task-id> --resume-from executor` および `exec run --register <PJR-ID> --resume --resume-from executor` で worktree の plan を編集してから再開したとき、統合時に直した plan が破棄されて元の plan で上書きされる問題を修正しました。executor から再開した run の統合では worktree の直した plan をコミット対象に含め、統合の commit に履歴として残るようにしました。あわせて登録簿の executor 再開で worktree 内の編集済み plan を読み込むようにしました(PJR-Z807)。
187
+
188
+ - schedule の `exec resume` で executor 段から再開するとき(`--resume-from executor` を含む)に `--executor-by` で元の claim の持ち主と別の agent を指定すると、claim が元の agent のまま残って統合前の完了確認(completion preflight)で止まる問題を修正しました。元の actor の `release` イベントと新しい executor の `claim` イベントを記録して claim を新しい executor へ移し、`complete` イベントも新しい executor で記録するようにしました。あわせて同一秒内に記録された `release` と再 `claim` のイベント順序を状態遷移に沿って解決するようにしました(PJR-FYN5)。
189
+
190
+ - プロダクトの文書(`docs/ja/product/` など)だけを変更したタスクで、executor が `npm run validate:history-links` や `npm run validate:catalog`(`specdojo catalog validate` を含む)を `not_applicable`(または `not_run`)と報告したときに、runner が書く `exec/plans/`・`exec/results/` などの実行管理ファイルを理由に `blocked` になっていた問題を修正しました。検査の適用範囲の判定では runner が書く `exec/` 配下の記録を除外し、`validate:history-links` は履歴蓄積ファイル(`pjr-*.md`(`pjr-index.md` を除く)、または executor 自身が変更した既存の `exec/plans/**/*.md`・`exec/results/**/*.md`)の変更がある場合だけ、`validate:catalog` は `docs/ja/projects/` 配下の成果物・カタログの変更がある場合だけ求めるようにしました。executor 自身が履歴蓄積ファイルやカタログ・プロジェクト文書を変更した場合は従来どおり検査を求めます(PJR-MERV)。
191
+
192
+ - schedule の review で、review の前の grade が失敗したとき、合計 3 回まで再試行するようにしました。それでも失敗した場合と、verdict が `grade-stale`・`grade-unavailable`・`changed-during-review` の場合は、タスクを done にせず blocked にして理由と次の操作を残します(PJR-M18B)。
193
+
194
+ - pipeline の executor が親の検証を 1 行にまとめて `not_run` と報告したとき、親の検証がすべて通っていても止まっていた問題を直しました(PJR-Q2AT)。
195
+
196
+ - claim した agent と別の agent(fallback・`--executor-by`・`--reporter-by`)が段を進めて失敗したとき、block が拒否されてタスクが doing のまま残る問題を直しました。block イベントの meta に `claim_actor` と `stage_actor` を残します(PJR-T4G3)。
197
+
198
+ - 人が `exec unblock` した後、agent の run を `exec resume` で再開すると、完了の確認が「task is being worked on by another actor」で止まる問題を直しました(PJR-M495)。
199
+
200
+ - `condense` の pipeline で executor が `condense_records` を出さないか形式が正しくない場合、reporter ではなく executor の段の失敗として止め、再開の操作を残すようにしました。schedule の `--resume-from executor` はこの状態のタスクも受け付けます(PJR-1GCD)。
201
+
202
+ - schedule の executor の再開で、統合先に commit 済みのそのタスク自身の run の記録と worktree 側の記録が衝突して止まる問題を直しました(PJR-9MWH)。失敗・延期の後に記帳した plan・result が、再開後の統合で exec branch 側と競合しても止まりません(PJR-DVNV)。
203
+
204
+ - executor が commit の対象外の変更を残した場合、schedule のタスクでも統合と worktree の片付けを止め、対象のパスと次の操作を result とログに残すようにしました(PJR-160D)。検査の対象外の判断が runner と executor で食い違う問題を直しました(PJR-MERV)。
205
+
206
+ - `schedule strategy generate` が `--force` で書き直すと、先頭の `# yaml-language-server: $schema=` の modeline が消える問題を直しました(PJR-V2GH)。
207
+
208
+ - 夜間の register の実行で子の worktree が入れ子になり、Job の環境が子の統合テストへ漏れて review・merge を飛ばす問題と、朝報告が文書の検査で止まる問題を直しました(PJR-0X0S・A7CR・RX14・MJEH)。schedule の `--auto --parallel` の統合が index に残った記録のファイルで止まる問題を直しました(PJR-HQVE)。
209
+
210
+ - `docs:build` が既定のメモリの上限で止まる問題を直しました(PJR-2SRR)。
211
+
212
+ - runner の統合・記帳の git 操作が、別のプロセスの `index.lock` を既定で 20 分まで待つようにしました。待ち時間は exec-defaults の `run.git_index_lock_wait_seconds` で変えられます。待っている間は 30 秒ごとに経過を出力し、lock が残っているのに git のプロセスが動いていない古い lock では上限を待たずに失敗します(PJR-964D)。
213
+
214
+ - schedule の review を再開するとき(reporter・executor からの再開)、runner が agent の前に grade を確かめ、最新の評価結果を exec branch に取り込むようにしました。統合の段から再開したときの完了の前の確認を、claim の持ち主で判定します(PJR-ZSRD)。
215
+
216
+ - schedule の review の前に流す grade の再試行の状態を run ごとに分け、並べて流した review どうしが grade の共有ファイルを取り合って統合の前に止まる問題を直しました(PJR-X04G)。
217
+
218
+ - `validate:schema:file`・strategy の読み込み・テストで YAML の読み方(YAML 1.1 互換)をそろえ、引用符のない `task_suffix: 090` を同じように読むようにしました(PJR-5QJ5)。
219
+
220
+ - テストと検証が `/tmp` の直下に `init` の出力を残し、ほかのテストを落とす問題を直しました(PJR-2ZN4)。
221
+
7
222
  ## [0.7.0] - 2026-11-03
8
223
 
9
224
  同梱パッケージは `@specdojo/docs-site` 0.4.0 を同時に公開します。docs-site 0.4.0 は、D2 コードブロックの SVG 生成と配信(`specdojo-docs-site d2`、PJR-6NEM)と、サイドメニューへの Kata(rulebook・recipe・sample・template)の掲載(PJR-PQG3)を含みます。`@specdojo/docs-lint` は変更がないため 0.4.0 のままです。
@@ -24,6 +239,8 @@ SpecDojo の利用者に影響する変更を記録します。
24
239
 
25
240
  ### 変更
26
241
 
242
+ - exec plan の規約を edit / review 共通(`xp-common-conventions-template.md`)、edit 専用(`xep-common-conventions-template.md`)、review 専用(`xrp-common-conventions-template.md`)に分けました。生成時は共通と mode に対応する規約を組み合わせます。規則の文言は変えず、review の詳細から編集専用の指示を除きました。コピー済みの規約がある場合は3ファイルを同期してください(PJR-Y431)。
243
+
27
244
  - 概念データフロー図の Kata を見直しました。全体概要(`cdfd-overview`)の rulebook・recipe・sample・template は、目的を全体像として書き、プロセス領域の区分を代表ノードとする図(区分の位置をそろえる、線のない区分を置かない、調整役の指示の図を分ける、区分の間の実行要求の線を認める、業務の言葉の題)を定め、sample と template の図を D2 の縦の流れにしました(PJR-6QTK・PJR-BC45)。ユースケース別(`cdfd-uc`)の Kata は、「引き渡し」と「例外時の戻り先」の章をなくして渡す情報を図の線で表し、図から調整役を外し、イベントを 1 ノード 1 出来事の短い文にし、deprecated の文書を参照しないことを定め、sample と template の図を D2 の縦の流れにしました(PJR-PRYZ)。eject している場合は、差分を確かめて取り込んでください。
28
245
 
29
246
  - docs-site のサイドメニューに、非推奨でない Kata(rulebook・recipe・sample・template)をすべて載せました。「サンプル」と「テンプレート」のメニューを新設し、載っていない Kata を検出するテストを追加しました(PJR-PQG3)。
@@ -1,4 +1,4 @@
1
- import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
1
+ import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
2
2
  import { join } from "node:path";
3
3
  import { load } from "../shared/yaml.js";
4
4
  import { isDctCatalogFileName } from "./types.js";
@@ -45,6 +45,26 @@ function readPracticeDocumentId(filePath) {
45
45
  }
46
46
  const DCT_INDEX_FILE = "dct-index.yaml";
47
47
  const DCT_INDEX_TEMPLATE = "dct-index-template.md";
48
+ // Tokenize before matching so comments and spacing (including within named exports)
49
+ // do not affect detection, and comment-like text inside strings stays intact.
50
+ const exportIdentifier = String.raw `[$_\p{ID_Start}][$\u200c\u200d\p{ID_Continue}]*`;
51
+ const exportString = String.raw `(?:"(?:[^"\\\r\n]|\\[^\r\n])*"|'(?:[^'\\\r\n]|\\[^\r\n])*')`;
52
+ const exportTokens = new RegExp(String.raw `//[^\r\n]*|/\*[\s\S]*?\*/|${exportString}|${exportIdentifier}|[^\s]`, "gu");
53
+ const exportName = `(?:${exportIdentifier}|"")`;
54
+ const exportSpecifier = `(?:type )?${exportName}(?: as ${exportName})?`;
55
+ const exportClause = `(?:\\*(?: as ${exportIdentifier})?|\\{(?: ${exportSpecifier}(?: , ${exportSpecifier})*(?: ,)?)? \\})`;
56
+ const reExportStatement = `export (?:type )?${exportClause} from ""(?: ;)?`;
57
+ const reExportOnly = new RegExp(`^${reExportStatement}(?: ${reExportStatement})*$`, "u");
58
+ function isReExportOnlyFile(filePath) {
59
+ if (!/\.[cm]?[jt]sx?$/.test(filePath) || !statSync(filePath).isFile())
60
+ return false;
61
+ const tokens = readFileSync(filePath, "utf8").match(exportTokens) ?? [];
62
+ const normalized = tokens
63
+ .filter((token) => !token.startsWith("//") && !token.startsWith("/*"))
64
+ .map((token) => (token.startsWith('"') || token.startsWith("'") ? '""' : token))
65
+ .join(" ");
66
+ return reExportOnly.test(normalized);
67
+ }
48
68
  export { buildMarkdown, isDctTemplateCatalog, renderCatalogTemplateBody };
49
69
  // Collects every local_id across all dct-*.yaml in a catalog directory.
50
70
  // Used to resolve cross-file depends_on references (same project, other file).
@@ -507,6 +527,9 @@ export function validateDctDoc(doc, filePath, knownLocalIds, repoRoot) {
507
527
  if (repoRoot && !existsSync(join(repoRoot, evidencePath))) {
508
528
  errors.push(`${filePath}: ${item.local_id}: evidence_refs path does not exist: ${evidencePath}`);
509
529
  }
530
+ else if (repoRoot && isReExportOnlyFile(join(repoRoot, evidencePath))) {
531
+ warnings.push(`${filePath}: ${item.local_id}: evidence_refs path contains only re-exports (re-export だけ): ${evidencePath}; reference the implementation body`);
532
+ }
510
533
  if (typeof rawRef.purpose !== "string" || rawRef.purpose.trim().length === 0) {
511
534
  errors.push(`${filePath}: ${item.local_id}: evidence_refs purpose must be a non-empty string`);
512
535
  }
@@ -1,3 +1,4 @@
1
+ import { registerDeprecatedWhereAlias } from "../shared/where-alias.js";
1
2
  import { join, relative, resolve } from "node:path";
2
3
  import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
3
4
  import { dirname } from "node:path";
@@ -216,21 +217,20 @@ function runPlanScaffold(opts) {
216
217
  if (!allOk)
217
218
  process.exitCode = 1;
218
219
  }
220
+ export function printCatalogPaths(opts) {
221
+ try {
222
+ const catalogPath = resolveCatalogPath(opts);
223
+ process.stdout.write(`catalog-path: ${catalogPath}\n`);
224
+ process.stdout.write(`generated : ${join(catalogPath, "generated")}\n`);
225
+ process.stdout.write(`plans : ${resolvePlansDir(catalogPath)}\n`);
226
+ }
227
+ catch (error) {
228
+ printCommandError(error);
229
+ }
230
+ }
219
231
  export function registerCatalogCommands(program) {
220
232
  const cat = program.command("catalog").description("Deliverables catalog (dct-*.yaml) commands");
221
- const wcmd = cat.command("where").description("Print resolved catalog paths");
222
- addProjectOption(wcmd);
223
- wcmd.action((opts) => {
224
- try {
225
- const catalogPath = resolveCatalogPath(opts);
226
- process.stdout.write(`catalog-path: ${catalogPath}\n`);
227
- process.stdout.write(`generated : ${join(catalogPath, "generated")}\n`);
228
- process.stdout.write(`plans : ${resolvePlansDir(catalogPath)}\n`);
229
- }
230
- catch (error) {
231
- printCommandError(error);
232
- }
233
- });
233
+ registerDeprecatedWhereAlias(cat, printCatalogPaths);
234
234
  const vcmd = cat.command("validate").description("Validate dct-*.yaml files");
235
235
  addProjectOption(vcmd);
236
236
  vcmd.action((opts) => {
@@ -314,7 +314,9 @@ export function registerCatalogCommands(program) {
314
314
  printCommandError(error);
315
315
  }
316
316
  });
317
- const bcmd = cat.command("build").description("Generate dct-*.md from dct-*.yaml");
317
+ const bcmd = cat
318
+ .command("build", { hidden: true })
319
+ .description("Internal compatibility entry for build --only catalog");
318
320
  addProjectOption(bcmd);
319
321
  bcmd.action((opts) => {
320
322
  try {
@@ -105,7 +105,7 @@ export function loadTemplatesForDomain(templatesPath, domain, repoRoot) {
105
105
  catch {
106
106
  continue;
107
107
  }
108
- if (!template || template.domain !== domain)
108
+ if (!template || template.domain !== domain || template.status === "deprecated")
109
109
  continue;
110
110
  loaded.push({ file, relPath: toRepoRelative(filePath, repoRoot), template });
111
111
  }
@@ -210,7 +210,10 @@ export function runScaffold(opts) {
210
210
  for (const [f, templatePath] of [...templateFiles].sort(([a], [b]) => a.localeCompare(b))) {
211
211
  try {
212
212
  const raw = readFileSync(templatePath, "utf8");
213
- loaded.push({ filename: f, path: templatePath, template: load(raw) });
213
+ const template = load(raw);
214
+ if (template?.status === "deprecated")
215
+ continue;
216
+ loaded.push({ filename: f, path: templatePath, template });
214
217
  }
215
218
  catch (err) {
216
219
  errors.push(`${templatePath}: ${err instanceof Error ? err.message : String(err)}`);
@@ -4,9 +4,11 @@ import { runOrchestratorLaunch } from "./orchestrator.js";
4
4
  import { AGENT_RUN_RATE_LIMIT_EXIT_CODE, runAgentPlan, writeAgentOutput, } from "../exec/agent-plan.js";
5
5
  export { AGENT_RUN_RATE_LIMIT_EXIT_CODE, resolveAgentMember, resolveAgentCommand, readAgentPlan, writeAgentOutput, runAgentPlan, } from "../exec/agent-plan.js";
6
6
  export function registerAgentCommands(program) {
7
- const agent = program.command("agent").description("Run a plan with a specific agent");
7
+ const agent = program
8
+ .command("agent", { hidden: true })
9
+ .description("Run a plan with a specific agent");
8
10
  agent
9
- .command("launch")
11
+ .command("launch", { hidden: true })
10
12
  .description("Launch agy with role-specific session permissions and runner-declared roots")
11
13
  .requiredOption("--provider <name>", "Provider CLI (antigravity)")
12
14
  .requiredOption("--role <role>", "Pipeline role (edit|review|report)")
@@ -36,7 +38,7 @@ export function registerAgentCommands(program) {
36
38
  }
37
39
  });
38
40
  agent
39
- .command("run")
41
+ .command("run", { hidden: true })
40
42
  .description("Feed a plan to one agent and capture its stdout")
41
43
  .requiredOption("--plan <path>", "Plan file passed to the agent on stdin")
42
44
  .requiredOption("--by <nickname>", "Agent nickname defined in agent-members.yaml")