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
@@ -0,0 +1,224 @@
1
+ import { copyFileSync, existsSync, readdirSync, readFileSync, renameSync, statSync, writeFileSync, } from "node:fs";
2
+ import { basename, dirname, join, relative, resolve } from "node:path";
3
+ import { readSpecdojoNamespace } from "./frontmatter-namespace.js";
4
+ function pathSegment(value) {
5
+ const segment = value.trim().replace(/[^A-Za-z0-9._-]/g, "_");
6
+ if (!segment || segment === "." || segment === "..")
7
+ throw new Error(`Invalid run record identity: ${value}`);
8
+ return segment;
9
+ }
10
+ export const RUN_ORIGINS = ["register", "schedule", "job"];
11
+ export function runRecordsDirectory(executionPath) {
12
+ return join(executionPath, "runs");
13
+ }
14
+ /** Accept only an exact origin/item/run directory produced by the path policy. */
15
+ export function runRecordLocation(executionPath, directory) {
16
+ const parts = relative(runRecordsDirectory(executionPath), directory).split(/[\\/]/);
17
+ if (parts.length !== 3 || !RUN_ORIGINS.includes(parts[0]))
18
+ return undefined;
19
+ try {
20
+ const paths = runRecordPaths(executionPath, parts[0], parts[1], parts[2]);
21
+ return resolve(paths.directory) === resolve(directory) ? paths : undefined;
22
+ }
23
+ catch {
24
+ return undefined;
25
+ }
26
+ }
27
+ export function planConventionsDirectory(executionPath) {
28
+ return join(executionPath, "conventions");
29
+ }
30
+ export function planConventionsPath(executionPath, hash) {
31
+ if (!/^[a-f0-9]{64}$/.test(hash))
32
+ throw new Error(`Invalid conventions SHA-256: ${hash}`);
33
+ return join(planConventionsDirectory(executionPath), `${hash}.txt`);
34
+ }
35
+ /** All managed execution record paths. */
36
+ export function runRecordPaths(executionPath, origin, itemId, runId) {
37
+ if (!RUN_ORIGINS.includes(origin))
38
+ throw new Error(`Invalid run origin: ${origin}`);
39
+ const directory = join(runItemDirectory(executionPath, origin, itemId), pathSegment(runId));
40
+ return {
41
+ directory,
42
+ plan: join(directory, "plan.md"),
43
+ result: join(directory, "result.md"),
44
+ evidence: join(directory, "evidence.json"),
45
+ state: join(directory, "pipeline-state.json"),
46
+ log: (name) => join(directory, basename(name)),
47
+ };
48
+ }
49
+ export function recordIdentity(taskId, origin) {
50
+ const local = taskId.replace(/^[^:]+:/, "");
51
+ const inferred = origin ?? (/^pjr-/i.test(local) ? "register" : /^JBR-/i.test(local) ? "job" : "schedule");
52
+ const itemId = inferred === "register"
53
+ ? (local.match(/^pjr-[a-z0-9]+/i)?.[0] ?? local).toUpperCase()
54
+ : inferred === "job"
55
+ ? local.replace(/-review$/, "")
56
+ : local;
57
+ return { origin: inferred, itemId };
58
+ }
59
+ export function runItemDirectory(executionPath, origin, itemId) {
60
+ return join(runRecordsDirectory(executionPath), origin, pathSegment(itemId));
61
+ }
62
+ export function taskRecordPaths(executionPath, taskId, runId = taskId, origin) {
63
+ const identity = recordIdentity(taskId, origin);
64
+ return runRecordPaths(executionPath, identity.origin, identity.itemId, runId);
65
+ }
66
+ export function taskEvidencePaths(executionPath, taskId, runId) {
67
+ const records = taskRecordPaths(executionPath, taskId, runId);
68
+ return { directory: records.directory, evidence: records.evidence, state: records.state };
69
+ }
70
+ export function runRecordPrefixes(executionPath, taskId, runId) {
71
+ return [`${taskRecordPaths(executionPath, taskId, runId).directory.replaceAll("\\", "/")}/`];
72
+ }
73
+ function filesBelow(path) {
74
+ if (!existsSync(path))
75
+ return [];
76
+ return readdirSync(path, { withFileTypes: true })
77
+ .sort((a, b) => a.name.localeCompare(b.name))
78
+ .flatMap((entry) => {
79
+ const child = join(path, entry.name);
80
+ return entry.isDirectory() ? filesBelow(child) : entry.isFile() ? [child] : [];
81
+ });
82
+ }
83
+ export function listRunRecords(executionPath, kind) {
84
+ return filesBelow(join(executionPath, "runs")).filter((path) => basename(path) === `${kind}.md`);
85
+ }
86
+ /** Find the latest run for an item, or a run with the requested stem. */
87
+ export function findRunRecord(executionPath, kind, taskOrStem) {
88
+ const identity = recordIdentity(taskOrStem);
89
+ const itemDirectory = runItemDirectory(executionPath, identity.origin, identity.itemId);
90
+ const newFiles = filesBelow(existsSync(itemDirectory) ? itemDirectory : join(executionPath, "runs")).filter((path) => basename(path) === `${kind}.md`);
91
+ const matches = newFiles.filter((path) => {
92
+ if (recordStem(path) === taskOrStem)
93
+ return true;
94
+ try {
95
+ return readSpecdojoNamespace(readFileSync(path, "utf8")).task_id === taskOrStem;
96
+ }
97
+ catch {
98
+ return false;
99
+ }
100
+ });
101
+ const latest = (paths) => paths
102
+ .sort((a, b) => {
103
+ const time = (path) => {
104
+ if (kind === "result") {
105
+ try {
106
+ const started = readSpecdojoNamespace(readFileSync(path, "utf8")).started_at;
107
+ const timestamp = typeof started === "string" ? Date.parse(started) : NaN;
108
+ if (Number.isFinite(timestamp))
109
+ return timestamp;
110
+ }
111
+ catch {
112
+ /* Fall back to the file timestamp for malformed historical records. */
113
+ }
114
+ }
115
+ return statSync(path).birthtimeMs || statSync(path).mtimeMs;
116
+ };
117
+ return time(a) - time(b) || a.localeCompare(b);
118
+ })
119
+ .at(-1);
120
+ return latest(matches);
121
+ }
122
+ export function recordPathForRead(executionPath, kind, taskOrStem) {
123
+ return (findRunRecord(executionPath, kind, taskOrStem) ??
124
+ taskRecordPaths(executionPath, taskOrStem)[kind]);
125
+ }
126
+ export function isRunRecordPath(path) {
127
+ return /(?:^|\/)runs\/(?:register|schedule|job)\/[^/]+\/[^/]+\//.test(path.replaceAll("\\", "/"));
128
+ }
129
+ export function recordStem(path) {
130
+ return isRunRecordPath(path)
131
+ ? basename(dirname(path))
132
+ : basename(path).replace(/-(plan|result)\.md$/, "");
133
+ }
134
+ export function resultForPlan(planPath) {
135
+ return isRunRecordPath(planPath)
136
+ ? join(dirname(planPath), "result.md")
137
+ : planPath.replace(/-plan\.md$/, "-result.md");
138
+ }
139
+ export function recordRef(executionPath, path) {
140
+ return relative(executionPath, path).replaceAll("\\", "/");
141
+ }
142
+ export function runnerRecordPrefixes(executionPath) {
143
+ return [planConventionsDirectory(executionPath), join(executionPath, "runs")].map((path) => `${path.replaceAll("\\", "/")}/`);
144
+ }
145
+ export function taskRecordPrefixes(executionPath, taskId) {
146
+ const identity = recordIdentity(taskId);
147
+ return [
148
+ planConventionsDirectory(executionPath),
149
+ runItemDirectory(executionPath, identity.origin, identity.itemId),
150
+ ].map((path) => `${path.replaceAll("\\", "/")}/`);
151
+ }
152
+ export function resumeStatePaths(executionPath, taskId) {
153
+ const identity = recordIdentity(taskId);
154
+ return [runItemDirectory(executionPath, identity.origin, identity.itemId)]
155
+ .flatMap(filesBelow)
156
+ .filter((path) => basename(path) === "pipeline-state.json");
157
+ }
158
+ export function runEvidencePath(statePath) {
159
+ return join(dirname(statePath), "evidence.json");
160
+ }
161
+ export function runLogPath(statePath, name) {
162
+ return join(dirname(statePath), basename(name));
163
+ }
164
+ export function executionRecordLink(file, kind) {
165
+ return join("..", "exec", file.includes("/") ? file : `${kind === "plan" ? "plans" : "results"}/${file}`).replaceAll("\\", "/");
166
+ }
167
+ export function isPlanOrResultRecord(path) {
168
+ // Recognize obsolete names for commit-scope protection without reading that layout.
169
+ return (/(?:^|\/)exec\/(?:plans|results)\//.test(path.replaceAll("\\", "/")) ||
170
+ (isRunRecordPath(path) && /\/(plan|result)\.md$/.test(path.replaceAll("\\", "/"))));
171
+ }
172
+ export function isOtherRunRecord(path, resultPath) {
173
+ return isRunRecordPath(path) && dirname(path) !== dirname(resultPath);
174
+ }
175
+ /** Archive a checkpoint; keep original logs only when the next stage retains their refs. */
176
+ export function snapshotRunAttempt(statePath, retainedLogRefs = []) {
177
+ if (!existsSync(statePath))
178
+ return;
179
+ const directory = dirname(statePath);
180
+ let attempt = 1;
181
+ while (existsSync(join(directory, `pipeline-state.attempt-${attempt}.json`)))
182
+ attempt++;
183
+ const names = readdirSync(directory).filter((file) => !file.includes(".attempt-") &&
184
+ (file === "pipeline-state.json" || file === "evidence.json" || file.endsWith(".log")));
185
+ const retainedLogs = new Set(retainedLogRefs.map((ref) => basename(ref.path.replaceAll("\\", "/"))));
186
+ const archivedLogs = new Map();
187
+ for (const name of names.filter((file) => file.endsWith(".log"))) {
188
+ archivedLogs.set(name, `${name.slice(0, -4)}.attempt-${attempt}.log`);
189
+ }
190
+ for (const name of names) {
191
+ const dot = name.lastIndexOf(".");
192
+ const destination = join(directory, `${name.slice(0, dot)}.attempt-${attempt}${name.slice(dot)}`);
193
+ if (name.endsWith(".log") && !retainedLogs.has(name)) {
194
+ renameSync(join(directory, name), destination);
195
+ }
196
+ else {
197
+ copyFileSync(join(directory, name), destination);
198
+ }
199
+ if (name === "evidence.json") {
200
+ try {
201
+ const evidence = JSON.parse(readFileSync(destination, "utf8"));
202
+ if (Array.isArray(evidence.log_refs)) {
203
+ evidence.log_refs = evidence.log_refs.map((ref) => {
204
+ const refName = basename(ref.path.replaceAll("\\", "/"));
205
+ const archivedName = archivedLogs.get(refName);
206
+ return {
207
+ ...ref,
208
+ path: archivedName
209
+ ? `${ref.path.slice(0, -refName.length)}${archivedName}`
210
+ : ref.path,
211
+ };
212
+ });
213
+ writeFileSync(destination, `${JSON.stringify(evidence, null, 2)}\n`);
214
+ }
215
+ }
216
+ catch {
217
+ /* Preserve malformed evidence verbatim for diagnosis. */
218
+ }
219
+ }
220
+ }
221
+ }
222
+ export function resolveRunPlanRef(executionPath, ref) {
223
+ return ref.replaceAll("\\", "/").startsWith("runs/") ? resolve(executionPath, ref) : resolve(ref);
224
+ }
@@ -1,4 +1,6 @@
1
+ import { warnDeprecated } from "./deprecation.js";
1
2
  import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
3
+ import { tmpdir } from "node:os";
2
4
  import { basename, dirname, isAbsolute, join, posix, relative, resolve } from "node:path";
3
5
  import dotenv from "dotenv";
4
6
  import { validateBranchTemplate } from "./branch-template.js";
@@ -12,6 +14,7 @@ import { runLefthookScaffold } from "./lefthook-scaffold.js";
12
14
  import { ensureMarkdownlintConfig } from "./markdownlint-config.js";
13
15
  import { runSlidevScaffold, SLIDEV_KATA_PATTERNS } from "./slidev-scaffold.js";
14
16
  import { ensureGitignore, formatGitignoreReport, gitignorePatternsForLayouts, } from "./specdojo-gitignore.js";
17
+ import { applyLocalConfig, formatConfigShow, readLocalConfig, repositoryIdentityRoot, } from "./local-config.js";
15
18
  /** Default IANA time zone for register date derivation when run.register_date_timezone is unset. */
16
19
  export const DEFAULT_REGISTER_DATE_TIMEZONE = "UTC";
17
20
  export const SPECDOJO_CONFIG_REFERENCE_URL = "https://specdojo.github.io/specdojo/ja/specdojo/references/specdojo-config-reference.html";
@@ -126,21 +129,6 @@ export function resolveRegisterActor(actor, roster) {
126
129
  }
127
130
  export const DEFAULT_AGENT_MEMBERS_PATH = ".specdojo/agent-members.yaml";
128
131
  export const KATA_AUTHORITY_PATTERN = /^(?!prj-)(?!specdojo$)[a-z][a-z0-9-]*$/;
129
- function repositoryIdentityRoot(rootDir) {
130
- const root = resolve(rootDir);
131
- const dotGit = join(root, ".git");
132
- if (!existsSync(dotGit) || statSync(dotGit).isDirectory())
133
- return root;
134
- const gitdirLine = readTextFileOrNull(dotGit)
135
- ?.split(/\r?\n/)
136
- .find((line) => line.startsWith("gitdir:"));
137
- if (!gitdirLine)
138
- return root;
139
- const gitdir = resolve(root, gitdirLine.slice("gitdir:".length).trim()).replaceAll("\\", "/");
140
- const marker = "/.git/worktrees/";
141
- const markerIndex = gitdir.lastIndexOf(marker);
142
- return markerIndex >= 0 ? gitdir.slice(0, markerIndex) : root;
143
- }
144
132
  export function defaultKataAuthority(rootDir = specdojoRootDir()) {
145
133
  const directoryName = basename(repositoryIdentityRoot(rootDir));
146
134
  const normalized = directoryName
@@ -167,26 +155,34 @@ export function isSpecdojoSourceRepository(rootDir = specdojoRootDir()) {
167
155
  return false;
168
156
  }
169
157
  }
170
- function findUpward(startDir, name) {
171
- let currentDir = resolve(startDir);
158
+ export function specdojoRootDir(startDir = process.cwd()) {
159
+ const current = resolve(startDir);
160
+ const systemTmp = resolve(tmpdir());
161
+ let dir = current;
162
+ let firstGitDir = null;
172
163
  while (true) {
173
- const candidate = resolve(currentDir, name);
174
- if (existsSync(candidate))
175
- return candidate;
176
- const parentDir = resolve(currentDir, "..");
177
- if (parentDir === currentDir)
178
- return null;
179
- currentDir = parentDir;
180
- }
181
- }
182
- export function specdojoRootDir() {
183
- const configPath = findUpward(process.cwd(), join(".specdojo", "specdojo.config.json"));
184
- if (configPath)
185
- return dirname(dirname(configPath));
186
- const gitMarker = findUpward(process.cwd(), ".git");
187
- if (gitMarker)
188
- return dirname(gitMarker);
189
- return process.cwd();
164
+ // 一時ディレクトリのルートそのもの(/tmp など)にある設定は、テストや検証の
165
+ // 漏洩・干渉を防ぐため親として拾わない。また一時ディレクトリ内から systemTmp を越えて探索しない。
166
+ if (dir === systemTmp) {
167
+ break;
168
+ }
169
+ if (existsSync(join(dir, ".specdojo", "specdojo.config.json"))) {
170
+ return dir;
171
+ }
172
+ if (!firstGitDir && existsSync(join(dir, ".git"))) {
173
+ firstGitDir = dir;
174
+ // リポジトリ境界に到達した。.git より親の .specdojo は拾わない。
175
+ break;
176
+ }
177
+ const parent = dirname(dir);
178
+ if (parent === dir)
179
+ break;
180
+ dir = parent;
181
+ }
182
+ if (firstGitDir) {
183
+ return firstGitDir;
184
+ }
185
+ return current;
190
186
  }
191
187
  /** Default worktree directory beside the repository, derived from its directory name. */
192
188
  export function defaultWorktreeBase(rootDir = specdojoRootDir()) {
@@ -224,6 +220,8 @@ export function getProjectExecutionPath(project) {
224
220
  // Timeline lives in a fixed cross-cutting directory under the project root, so an
225
221
  // unset timeline_path falls back to "timeline" instead of disabling the command.
226
222
  export function getProjectTimelinePath(project) {
223
+ if (project.timeline_path !== undefined)
224
+ warnDeprecated("timeline_path", "Use register epics and dashboard build.");
227
225
  return withBasePath(project, project.timeline_path?.trim() || "timeline");
228
226
  }
229
227
  export function getProjectMembersPath(project) {
@@ -703,6 +701,8 @@ export function loadConfig(configRootDir = specdojoRootDir()) {
703
701
  throw new Error(`Invalid .specdojo/specdojo.config.json: kata_authority must match ${KATA_AUTHORITY_PATTERN}`);
704
702
  }
705
703
  for (const [projectId, project] of Object.entries(parsed.projects)) {
704
+ if (project?.timeline_path !== undefined)
705
+ warnDeprecated("timeline_path", "Use register epics and dashboard build.");
706
706
  if (!isValidProjectConfig(project)) {
707
707
  throw new Error(`Invalid .specdojo/specdojo.config.json: projects.${projectId} must omit ` +
708
708
  `schedule_path/execution_path/integration_branch or set them to non-empty strings, ` +
@@ -711,19 +711,34 @@ export function loadConfig(configRootDir = specdojoRootDir()) {
711
711
  }
712
712
  const projectIds = Object.keys(parsed.projects);
713
713
  const rootDir = dirname(dirname(configPath));
714
+ // The local config is read after the shared one and may change only allowlisted keys
715
+ // (PJR-NC9R). The merged result goes through the same validation as the shared config.
716
+ const local = readLocalConfig(rootDir);
717
+ const applied = local
718
+ ? applyLocalConfig(parsed, local.value, local.path, REPO_KEYS)
719
+ : { config: parsed, overrides: [] };
720
+ const effective = applied.config;
714
721
  const repoErrors = projectIds
715
722
  .sort()
716
723
  .flatMap((projectId) => [
717
- ...validateCommitTypes(parsed.projects[projectId].commit_types, `projects.${projectId}.commit_types`),
718
- ...validateProjectRepos(projectId, parsed.projects[projectId], projectIds, rootDir),
724
+ ...validateCommitTypes(effective.projects[projectId].commit_types, `projects.${projectId}.commit_types`),
725
+ ...validateProjectRepos(projectId, effective.projects[projectId], projectIds, rootDir),
719
726
  ]);
720
- const externalProjectErrors = validateExternalProjects(parsed.external_projects, projectIds, rootDir);
727
+ const externalProjectErrors = validateExternalProjects(effective.external_projects, projectIds, rootDir);
721
728
  const configErrors = [...repoErrors, ...externalProjectErrors];
722
729
  if (configErrors.length > 0) {
723
- throw new Error(`Invalid .specdojo/specdojo.config.json (${configPath}):\n` +
730
+ const localNote = local ? ` with local overrides from ${local.path}` : "";
731
+ throw new Error(`Invalid .specdojo/specdojo.config.json (${configPath}${localNote}):\n` +
724
732
  configErrors.map((message) => ` - ${message}`).join("\n"));
725
733
  }
726
- return { configPath, config: parsed };
734
+ return local
735
+ ? {
736
+ configPath,
737
+ config: effective,
738
+ localConfigPath: local.path,
739
+ localOverrides: applied.overrides,
740
+ }
741
+ : { configPath, config: parsed };
727
742
  }
728
743
  export function writeConfig(config) {
729
744
  const configPath = defaultConfigPath();
@@ -767,9 +782,13 @@ export function registerConfigCommands(program) {
767
782
  "and initialize .gitignore and markdownlint settings")
768
783
  .option("--dry-run", "Show the planned config, .gitignore and markdownlint settings without writing", false)
769
784
  .action((opts) => {
785
+ const rootDir = specdojoRootDir();
786
+ if (resolve(rootDir) === resolve(tmpdir())) {
787
+ throw new Error("Refusing to initialize specdojo configuration directly under temporary directory root.");
788
+ }
770
789
  const dryRun = !!opts.dryRun;
771
- const { configPath, config } = loadConfig();
772
- ensureMarkdownlintConfig(specdojoRootDir(), dryRun);
790
+ const { configPath, config } = loadConfig(rootDir);
791
+ ensureMarkdownlintConfig(rootDir, dryRun);
773
792
  if (config) {
774
793
  process.stdout.write(`Already exists: ${configPath}\n`);
775
794
  writeGitignoreForConfig(config, dryRun);
@@ -809,6 +828,19 @@ export function registerConfigCommands(program) {
809
828
  ' 6. To let tasks change the product repository, declare it under "repos" ' +
810
829
  '(e.g. { "name": "app1", "path": "../app1" }) and write targets/paths as app1:<path>.\n');
811
830
  });
831
+ cfg
832
+ .command("show")
833
+ .description("Show the effective repos and which values come from .specdojo/specdojo.local.config.json")
834
+ .option("--project <projectId>", "Show only one project")
835
+ .action((opts) => {
836
+ try {
837
+ process.stdout.write(formatConfigShow(loadConfig(), opts.project));
838
+ }
839
+ catch (error) {
840
+ process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
841
+ process.exitCode = 1;
842
+ }
843
+ });
812
844
  cfg
813
845
  .command("migrate-members")
814
846
  .description("Move agent entries from project pm-members.yaml files to protected agent members")
@@ -7,6 +7,7 @@ export const NODE_MODULES_PATTERN = "node_modules/";
7
7
  export const DEFAULT_GITIGNORE_PATTERNS = [
8
8
  NODE_MODULES_PATTERN,
9
9
  ".specdojo/doc-index.json",
10
+ ".specdojo/specdojo.local.config.json",
10
11
  "docs/**/generated/*",
11
12
  "!docs/**/generated/.gitkeep",
12
13
  "docs/**/execution/exec/.locks/",
@@ -82,7 +82,15 @@ function replaceOutsideMarkdownCodeSpans(text, replace) {
82
82
  export function inlineCodeAnglePlaceholders(text) {
83
83
  // HTTP(S) autolink は Markdown として既に安全な山括弧記法なので、プレースホルダとして
84
84
  // code span 化しない。register の表セルで bare URL を囲んだ後も autolink を保持する。
85
- const placeholder = /[A-Za-z0-9._-]*(?:<(?!https?:\/\/)[^<>\r\n]+>[A-Za-z0-9._-]*)+/g;
85
+ return wrapAngleTokens(text, /[A-Za-z0-9._-]*(?:<(?!https?:\/\/)[^<>\r\n]+>[A-Za-z0-9._-]*)+/g);
86
+ }
87
+ // frontmatter の文字列値へ書き写す executor 由来の文(condense の記録・block 理由など)向け。
88
+ // lint-fm は frontmatter のコードスパン外の山括弧を autolink や実在 HTML 名も含めて拒否する
89
+ // ため(PJR-V141)、本文用と異なり `<https://...>` も code span 化する。
90
+ export function inlineCodeFrontmatterAnglePlaceholders(text) {
91
+ return wrapAngleTokens(text, /[A-Za-z0-9._-]*(?:<[^<>\r\n]+>[A-Za-z0-9._-]*)+/g);
92
+ }
93
+ function wrapAngleTokens(text, placeholder) {
86
94
  const wrapToken = (token) => {
87
95
  const trailing = token.match(/\.+$/)?.[0] ?? "";
88
96
  const body = trailing ? token.slice(0, -trailing.length) : token;
@@ -109,10 +117,70 @@ const CONTROL_CHARS = /[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f-\u009f]/g;
109
117
  export function stripTerminalControlSequences(text) {
110
118
  return text.replace(ANSI_ESCAPE, "").replace(CONTROL_CHARS, "");
111
119
  }
112
- /** Redacts common credential forms before subprocess output is persisted as evidence. */
120
+ /** Kept in sync with tools/check-evidence-secrets.mjs by a parity test. */
121
+ export const SENSITIVE_TEXT_RULES = [
122
+ {
123
+ kind: "private-key",
124
+ pattern: /-----BEGIN ((?:[A-Z0-9]+ )*PRIVATE KEY)-----[\s\S]*?-----END \1-----/gu,
125
+ replacement: "[REDACTED]",
126
+ },
127
+ {
128
+ kind: "url-credentials",
129
+ pattern: /(\b[a-z][a-z0-9+.-]*:\/\/)[^\s/@<>"'`?#]+@/giu,
130
+ replacement: "$1[REDACTED]@",
131
+ },
132
+ {
133
+ kind: "bearer-token",
134
+ pattern: /\bBearer\s+[A-Za-z0-9._~+/=-]+/giu,
135
+ replacement: "Bearer [REDACTED]",
136
+ },
137
+ {
138
+ kind: "aws-access-key",
139
+ pattern: /\b(?:AKIA|ASIA)[A-Z0-9]{16}\b/gu,
140
+ replacement: "[REDACTED]",
141
+ },
142
+ {
143
+ kind: "google-api-key",
144
+ pattern: /\bAIza[A-Za-z0-9_-]{35}(?![A-Za-z0-9_-])/gu,
145
+ replacement: "[REDACTED]",
146
+ },
147
+ {
148
+ kind: "slack-token",
149
+ pattern: /\bxox[a-z]-[A-Za-z0-9-]{8,}(?![A-Za-z0-9-])/gu,
150
+ replacement: "[REDACTED]",
151
+ },
152
+ {
153
+ kind: "github-fine-grained-token",
154
+ pattern: /\bgithub_pat_[A-Za-z0-9_]{8,}\b/gu,
155
+ replacement: "[REDACTED]",
156
+ },
157
+ {
158
+ kind: "anthropic-api-key",
159
+ pattern: /\bsk-ant-[A-Za-z0-9_-]{8,}(?![A-Za-z0-9_-])/gu,
160
+ replacement: "[REDACTED]",
161
+ },
162
+ {
163
+ kind: "api-token",
164
+ pattern: /\b(?:sk-(?:proj-)?[A-Za-z0-9_-]{8,}|gh[oprsu]_[A-Za-z0-9_]{8,})(?![A-Za-z0-9_-])/gu,
165
+ replacement: "[REDACTED]",
166
+ },
167
+ {
168
+ kind: "jwt",
169
+ pattern: /\beyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+(?![A-Za-z0-9_-])/gu,
170
+ replacement: "[REDACTED]",
171
+ },
172
+ {
173
+ kind: "quoted-credential",
174
+ pattern: /(\b(?:api[_-]?key|access[_-]?token|auth(?:orization)?|password|passwd|secret)\b["']?\s*[:=]\s*)(["'])(?:\\[\s\S]|(?!\2)[^\\\r\n])+\2/giu,
175
+ replacement: "$1$2[REDACTED]$2",
176
+ },
177
+ {
178
+ kind: "credential-assignment",
179
+ pattern: /(\b(?:api[_-]?key|access[_-]?token|auth(?:orization)?|password|passwd|secret)\b["']?\s*[:=]\s*)(?:Bearer\s+)?[^\s,;}"'`\\]+/giu,
180
+ replacement: "$1[REDACTED]",
181
+ },
182
+ ];
183
+ /** Redacts known credential forms before subprocess output is persisted as evidence. */
113
184
  export function redactSensitiveText(value) {
114
- return value
115
- .replace(/\bBearer\s+[A-Za-z0-9._~+/=-]+/giu, "Bearer [REDACTED]")
116
- .replace(/\b(sk-(?:proj-)?[A-Za-z0-9_-]{8,}|gh[opsu]_[A-Za-z0-9_]{8,})\b/gu, "[REDACTED]")
117
- .replace(/\b(api[_-]?key|access[_-]?token|auth(?:orization)?|password|passwd|secret)\b(\s*[:=]\s*)([^\s,;]+)/giu, "$1$2[REDACTED]");
185
+ return SENSITIVE_TEXT_RULES.reduce((text, { pattern, replacement }) => text.replace(pattern, replacement), value);
118
186
  }
@@ -1,3 +1,4 @@
1
+ import { warnDeprecated } from "./deprecation.js";
1
2
  import { readYaml } from "./fs.js";
2
3
  import { normalizeDateOnly } from "./time.js";
3
4
  const CATALOG_STATUSES = ["not_started", "draft", "primary"];
@@ -76,6 +77,7 @@ function parseTrack(raw, index, errors) {
76
77
  export function loadTimelineIndex(filePath) {
77
78
  const errors = [];
78
79
  const parsed = readYaml(filePath);
80
+ warnDeprecated("tml-index.yaml", "Move track domains and dependencies to register epics; use dashboard build.");
79
81
  if (!isRecord(parsed)) {
80
82
  throw new Error(`${filePath}: invalid or empty YAML`);
81
83
  }
@@ -0,0 +1,13 @@
1
+ import { warnDeprecated } from "./deprecation.js";
2
+ /** Retain the six pre-unification entries for one release before removing them. */
3
+ export function registerDeprecatedWhereAlias(parent, printPaths) {
4
+ const kind = parent.name();
5
+ parent
6
+ .command("where", { hidden: true })
7
+ .description(`Deprecated: use where ${kind} (retained for one release)`)
8
+ .option("--project <projectId>", "Project id in specdojo.config.json")
9
+ .action((opts) => {
10
+ warnDeprecated(`${kind} where`, `Use specdojo where ${kind}. This alias will be removed after one release.`);
11
+ printPaths(opts);
12
+ });
13
+ }
package/dist/specdojo.js CHANGED
@@ -15,6 +15,7 @@ import { registerRoutineCommands } from "./routine/routine.js";
15
15
  import { registerJobCommands } from "./job/job.js";
16
16
  import { registerWatchCommand } from "./commands/watch.js";
17
17
  import { registerBuildCommand } from "./commands/build.js";
18
+ import { registerWhereCommand } from "./commands/where.js";
18
19
  import { registerYamlPagesCommands } from "./docs/yaml-pages-command.js";
19
20
  import { registerDashboardCommands } from "./dashboard/dashboard.js";
20
21
  import { registerGradeCommand } from "./grade/grade.js";
@@ -24,6 +25,7 @@ import { registerKataCommands } from "./kata/command.js";
24
25
  import { registerDevcontainerCommands } from "./devcontainer/command.js";
25
26
  import { registerInitCommand } from "./commands/init.js";
26
27
  import { registerOrchestratorCommands } from "./commands/orchestrator.js";
28
+ import { registerGitCommand } from "./commands/git.js";
27
29
  /**
28
30
  * bin は dist/specdojo.js を指すため、開発チェックアウトで `npm run build` を忘れると
29
31
  * 古い挙動のまま実行される。src が dist より新しい場合は警告し、exec 系は中断する。
@@ -57,6 +59,7 @@ async function main() {
57
59
  registerJobCommands(program);
58
60
  registerWatchCommand(program);
59
61
  registerBuildCommand(program);
62
+ registerWhereCommand(program);
60
63
  registerYamlPagesCommands(program);
61
64
  registerDashboardCommands(program);
62
65
  registerGradeCommand(program, {
@@ -67,6 +70,7 @@ async function main() {
67
70
  registerKataCommands(program);
68
71
  registerDevcontainerCommands(program);
69
72
  registerOrchestratorCommands(program);
73
+ registerGitCommand(program);
70
74
  await program.parseAsync(process.argv);
71
75
  }
72
76
  void main();
@@ -324,6 +324,7 @@ viewpoints:
324
324
  document_kinds:
325
325
  exclude:
326
326
  - specdojo:bdd-rulebook
327
+ - specdojo:cdr-rulebook
327
328
  - specdojo:dct-index-rulebook
328
329
  - specdojo:dct-rulebook
329
330
  - specdojo:gl-rulebook
@@ -354,7 +355,9 @@ viewpoints:
354
355
  - specdojo:cdfd-rulebook
355
356
  - specdojo:cdfd-uc-rulebook
356
357
  - specdojo:cdsd-rulebook
358
+ - specdojo:cdt-rulebook
357
359
  - specdojo:cld-rulebook
360
+ - specdojo:clis-rulebook
358
361
  - specdojo:cnd-mermaid-rulebook
359
362
  - specdojo:cnd-rulebook
360
363
  - specdojo:cop-index-rulebook
@@ -367,6 +370,7 @@ viewpoints:
367
370
  - specdojo:dec-rulebook
368
371
  - specdojo:dmd-index-rulebook
369
372
  - specdojo:dmd-rulebook
373
+ - specdojo:dss-rulebook
370
374
  - specdojo:etc-index-rulebook
371
375
  - specdojo:etc-rulebook
372
376
  - specdojo:ifd-mermaid-rulebook
@@ -516,8 +520,9 @@ viewpoints:
516
520
  category: usability
517
521
  title: 冗長性・簡潔性
518
522
  check: >-
519
- 各節が固有の判断または手順に寄与し、同じ主張の反復、一般論、表と本文の内容重複、正本からの過剰な再掲がないか。判断に必要な背景、制約、例外、done_criteria が残されていれば下限を満たしているとする。長さだけでは fail にせず、削除または統合しても判断情報を失わない箇所を具体的に特定できる場合のみ minor とする。
520
- evidence: 反復する段落、表と本文の重複、正本への参照で置換できる再掲、削除または統合しても判断情報を失わない箇所。
523
+ 各節が固有の判断または手順に寄与し、同じ主張の繰り返し、表と本文の二重の説明、図をなぞる文、目的に要らない背景、正本の再掲がないか。判断に要る背景・制約・例外・完了条件が残されていれば下限を満たしているとする。長さだけでは fail にせず、削る・まとめる・参照に置き換えることで判断情報を失わない箇所を具体的に特定できる場合のみ minor とする。
524
+ evidence: >-
525
+ 同じ主張の繰り返し、表と本文の二重の説明、図をなぞる文、目的に要らない背景、正本の再掲(正本への参照で置き換えられるもの)。判断に要る背景・制約・例外・完了条件を残したまま、長さだけを根拠にせず、削る・まとめる・参照に置き換えることで判断情報を失わない箇所。
521
526
  default_severity: minor
522
527
  evaluation: referential
523
528
  - id: vp-arc-single-responsibility
@@ -569,8 +574,11 @@ viewpoints:
569
574
  - specdojo:cdfd-mermaid-rulebook
570
575
  - specdojo:cdfd-rulebook
571
576
  - specdojo:cdfd-uc-rulebook
577
+ - specdojo:cdr-rulebook
572
578
  - specdojo:cdsd-rulebook
579
+ - specdojo:cdt-rulebook
573
580
  - specdojo:cld-rulebook
581
+ - specdojo:clis-rulebook
574
582
  - specdojo:cnd-mermaid-rulebook
575
583
  - specdojo:cnd-rulebook
576
584
  - specdojo:cop-rulebook
@@ -582,6 +590,7 @@ viewpoints:
582
590
  - specdojo:dct-rulebook
583
591
  - specdojo:dec-rulebook
584
592
  - specdojo:dmd-rulebook
593
+ - specdojo:dss-rulebook
585
594
  - specdojo:etc-rulebook
586
595
  - specdojo:gl-rulebook
587
596
  - specdojo:ifd-mermaid-rulebook