specdojo 0.6.0 → 0.8.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 (366) hide show
  1. package/.github/agents/specdojo-orchestrator.md +3 -2
  2. package/CHANGELOG.md +193 -0
  3. package/README.md +2 -2
  4. package/dist/catalog/build.js +24 -1
  5. package/dist/catalog/plan.js +1 -1
  6. package/dist/catalog/scaffold.js +4 -1
  7. package/dist/commands/agent.js +33 -0
  8. package/dist/commands/init.js +6 -1
  9. package/dist/commands/night-orchestrator.js +6 -4
  10. package/dist/commands/orchestrator.js +10 -1
  11. package/dist/dashboard/dashboard-timeline.js +18 -16
  12. package/dist/dashboard/dashboard.js +612 -259
  13. package/dist/dashboard/epic-plan.js +81 -0
  14. package/dist/dashboard/exec-records.js +16 -20
  15. package/dist/dashboard/routines.js +8 -6
  16. package/dist/dashboard/timeline-build.js +5 -9
  17. package/dist/dashboard/timeline.js +9 -4
  18. package/dist/devcontainer/command.js +18 -0
  19. package/dist/devcontainer/host-script.js +21 -0
  20. package/dist/devcontainer/scaffold.js +22 -3
  21. package/dist/docs/frontmatter-namespace.js +1 -48
  22. package/dist/docs/yaml-pages.js +125 -3
  23. package/dist/exec/agent-config.js +22 -0
  24. package/dist/exec/agent-plan.js +3 -2
  25. package/dist/exec/antigravity-session.js +154 -0
  26. package/dist/exec/commands.js +69 -21
  27. package/dist/exec/commit-hook-skips.js +78 -0
  28. package/dist/exec/core.js +19 -7
  29. package/dist/exec/events.js +159 -8
  30. package/dist/exec/evidence.js +64 -16
  31. package/dist/exec/handoff.js +9 -13
  32. package/dist/exec/limit.js +1 -1
  33. package/dist/exec/mechanical-result.js +45 -0
  34. package/dist/exec/migrate-records.js +249 -0
  35. package/dist/exec/parent-validation.js +160 -12
  36. package/dist/exec/pipeline-state.js +27 -5
  37. package/dist/exec/plan-markdownlint.js +89 -0
  38. package/dist/exec/plans-condense-findings.js +89 -0
  39. package/dist/exec/plans-core.js +24 -17
  40. package/dist/exec/plans-generation.js +52 -25
  41. package/dist/exec/plans-grade-findings.js +8 -3
  42. package/dist/exec/plans-kata-findings.js +61 -0
  43. package/dist/exec/plans-planning.js +3 -3
  44. package/dist/exec/plans-storage.js +12 -24
  45. package/dist/exec/register-resume.js +69 -42
  46. package/dist/exec/register.js +26 -22
  47. package/dist/exec/repo-integration-sync.js +8 -4
  48. package/dist/exec/repo-integration.js +21 -1
  49. package/dist/exec/reporter.js +121 -23
  50. package/dist/exec/results.js +85 -24
  51. package/dist/exec/review-completion.js +47 -0
  52. package/dist/exec/review-kata.js +109 -0
  53. package/dist/exec/run/agent-pipeline.js +75 -6
  54. package/dist/exec/run/agent.js +20 -7
  55. package/dist/exec/run/in-place.js +69 -32
  56. package/dist/exec/run/job.js +81 -24
  57. package/dist/exec/run/lifecycle-commands.js +264 -43
  58. package/dist/exec/run/mode-shared.js +11 -3
  59. package/dist/exec/run/register-command.js +12 -10
  60. package/dist/exec/run/register-core.js +20 -13
  61. package/dist/exec/run/register-mode.js +12 -12
  62. package/dist/exec/run/register-post-review.js +21 -9
  63. package/dist/exec/run/register-resume.js +28 -18
  64. package/dist/exec/run/register-state.js +10 -7
  65. package/dist/exec/run/register-worktree.js +60 -30
  66. package/dist/exec/run/schedule-mode.js +26 -6
  67. package/dist/exec/run/schedule-prepare.js +228 -45
  68. package/dist/exec/run/schedule-task.js +132 -25
  69. package/dist/exec/run/shared.js +4 -3
  70. package/dist/exec/run/trailing-records.js +35 -0
  71. package/dist/exec/run-records.js +2 -0
  72. package/dist/exec/strategy.js +1 -0
  73. package/dist/exec/trailing-records.js +242 -0
  74. package/dist/exec/trial-commands.js +3 -2
  75. package/dist/exec/validate-records-commit.js +110 -0
  76. package/dist/exec/validate-records.js +148 -0
  77. package/dist/exec/worktree-command.js +29 -16
  78. package/dist/exec/worktree-ops-commit.js +118 -59
  79. package/dist/exec/worktree-ops-lifecycle.js +77 -44
  80. package/dist/exec/worktree-ops-merge.js +13 -2
  81. package/dist/exec/worktree-ops.js +2 -2
  82. package/dist/exec/worktree.js +19 -2
  83. package/dist/grade/apply.js +32 -6
  84. package/dist/grade/command-inspect.js +2 -2
  85. package/dist/grade/command-run.js +2 -0
  86. package/dist/grade/command-shared.js +1 -1
  87. package/dist/grade/core.js +18 -5
  88. package/dist/grade/markdown.js +3 -3
  89. package/dist/grade/pipeline-state.js +15 -11
  90. package/dist/grade/plan.js +37 -17
  91. package/dist/grade/result.js +3 -3
  92. package/dist/grade/run.js +23 -3
  93. package/dist/grade/target-discovery.js +17 -4
  94. package/dist/grade/targets.js +12 -11
  95. package/dist/job/job.js +31 -17
  96. package/dist/job/noop.js +104 -0
  97. package/dist/register/core.js +2 -0
  98. package/dist/register/create-commands.js +28 -3
  99. package/dist/register/deliverable-target.js +9 -1
  100. package/dist/register/epic.js +104 -26
  101. package/dist/register/event-merge.js +3 -0
  102. package/dist/register/events.js +4 -0
  103. package/dist/register/external-project.js +3 -0
  104. package/dist/register/item.js +6 -0
  105. package/dist/register/maintenance-commands.js +4 -1
  106. package/dist/register/planning.js +7 -14
  107. package/dist/register/register.js +74 -32
  108. package/dist/register/track-domains.js +34 -0
  109. package/dist/register/track-plan.js +78 -0
  110. package/dist/register/transition-commands.js +8 -0
  111. package/dist/register/work-table.js +64 -0
  112. package/dist/review/grade.js +35 -13
  113. package/dist/routine/definition.js +4 -3
  114. package/dist/routine/failure.js +30 -0
  115. package/dist/routine/routine.js +56 -32
  116. package/dist/routine/storage.js +33 -0
  117. package/dist/schedule/schedule.js +1 -0
  118. package/dist/schedule/strategy-generate-document.js +26 -14
  119. package/dist/schedule/strategy-generate-scope.js +17 -45
  120. package/dist/schedule/strategy-generate.js +33 -3
  121. package/dist/schedule/strategy-profiles.js +86 -12
  122. package/dist/shared/agent-types.js +2 -0
  123. package/dist/shared/condense-records.js +25 -0
  124. package/dist/shared/deprecation.js +8 -0
  125. package/dist/shared/document-metadata.js +20 -0
  126. package/dist/shared/finding-cause.js +20 -0
  127. package/dist/shared/frontmatter-namespace.js +48 -0
  128. package/dist/shared/git.js +149 -15
  129. package/dist/shared/grade-result.js +17 -1
  130. package/dist/shared/local-state.js +20 -0
  131. package/dist/shared/markdownlint-config.js +8 -3
  132. package/dist/shared/plan-conventions.js +129 -0
  133. package/dist/shared/plan-templates.js +57 -41
  134. package/dist/shared/provider-scaffold.js +2 -0
  135. package/dist/shared/run-records.js +224 -0
  136. package/dist/shared/specdojo-config.js +39 -21
  137. package/dist/shared/specdojo-gitignore.js +1 -0
  138. package/dist/shared/text.js +65 -5
  139. package/dist/shared/timeline-index.js +2 -0
  140. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
  141. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
  142. package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
  143. package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
  144. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
  145. package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
  146. package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
  147. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
  148. package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
  149. package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
  150. package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
  151. package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
  152. package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
  153. package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
  154. package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
  155. package/docs/ja/specdojo/guides/docs-editing-guide.md +48 -0
  156. package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
  157. package/docs/ja/specdojo/guides/exec-config-guide.md +61 -28
  158. package/docs/ja/specdojo/guides/exec-operation-guide.md +61 -13
  159. package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
  160. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
  161. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
  162. package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
  163. package/docs/ja/specdojo/guides/quick-start-guide.md +589 -807
  164. package/docs/ja/specdojo/guides/register-operation-guide.md +26 -4
  165. package/docs/ja/specdojo/guides/remote-host-development-guide.md +33 -4
  166. package/docs/ja/specdojo/guides/review-guide.md +22 -19
  167. package/docs/ja/specdojo/guides/routine-operation-guide.md +14 -8
  168. package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
  169. package/docs/ja/specdojo/guides/schedule-design-guide.md +7 -4
  170. package/docs/ja/specdojo/guides/schedule-operation-guide.md +41 -3
  171. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
  172. package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
  173. package/docs/ja/specdojo/guides/use-case-guide.md +471 -74
  174. package/docs/ja/specdojo/recipes/bac-recipe.md +94 -0
  175. package/docs/ja/specdojo/recipes/bes-recipe.md +105 -0
  176. package/docs/ja/specdojo/recipes/br-recipe.md +84 -0
  177. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +88 -86
  178. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +108 -122
  179. package/docs/ja/specdojo/recipes/cnd-recipe.md +125 -0
  180. package/docs/ja/specdojo/recipes/cpd-recipe.md +126 -0
  181. package/docs/ja/specdojo/recipes/cxd-recipe.md +145 -0
  182. package/docs/ja/specdojo/recipes/ifd-recipe.md +134 -0
  183. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +135 -86
  184. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +130 -0
  185. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +29 -26
  186. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +35 -26
  187. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +38 -28
  188. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -31
  189. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +26 -28
  190. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +10 -8
  191. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +18 -17
  192. package/docs/ja/specdojo/recipes/stsd-recipe.md +100 -62
  193. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +106 -0
  194. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +137 -0
  195. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +122 -0
  196. package/docs/ja/specdojo/references/command-reference.md +146 -99
  197. package/docs/ja/specdojo/references/deliverables-reference.md +9 -4
  198. package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
  199. package/docs/ja/specdojo/references/specdojo-config-reference.md +17 -16
  200. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +72 -290
  201. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +212 -79
  202. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +138 -154
  203. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +147 -59
  204. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +100 -96
  205. package/docs/ja/specdojo/rulebooks/br-rulebook.md +88 -108
  206. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +126 -211
  207. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +367 -0
  208. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
  209. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
  210. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
  211. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +132 -106
  212. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +102 -68
  213. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +152 -0
  214. package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
  215. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +187 -0
  216. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +93 -247
  217. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +104 -241
  218. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +124 -257
  219. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +87 -98
  220. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +9 -7
  221. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +2 -1
  222. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +193 -0
  223. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +100 -54
  224. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +69 -252
  225. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +91 -76
  226. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +252 -226
  227. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +118 -40
  228. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +11 -11
  229. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +9 -9
  230. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +4 -4
  231. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +11 -11
  232. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +11 -11
  233. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +4 -3
  234. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +34 -29
  235. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +8 -8
  236. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +2 -2
  237. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +50 -56
  238. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +46 -55
  239. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +57 -54
  240. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +50 -65
  241. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +2 -2
  242. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +70 -97
  243. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +2 -1
  244. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +47 -56
  245. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -135
  246. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +116 -32
  247. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +118 -61
  248. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +152 -57
  249. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +51 -39
  250. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +101 -46
  251. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +72 -329
  252. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +74 -263
  253. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +78 -195
  254. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
  255. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +3 -4
  256. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +3 -3
  257. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +140 -143
  258. package/docs/ja/specdojo/samples/bac-sample.md +106 -21
  259. package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
  260. package/docs/ja/specdojo/samples/bds-sample.md +100 -21
  261. package/docs/ja/specdojo/samples/bes-index-sample.md +59 -20
  262. package/docs/ja/specdojo/samples/bes-sample.md +80 -21
  263. package/docs/ja/specdojo/samples/br-sample.md +68 -14
  264. package/docs/ja/specdojo/samples/ccd-sample.md +81 -19
  265. package/docs/ja/specdojo/samples/cdfd-overview-sample.md +248 -140
  266. package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
  267. package/docs/ja/specdojo/samples/cdfd-uc-sample.md +130 -97
  268. package/docs/ja/specdojo/samples/cdsd-sample.md +89 -20
  269. package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
  270. package/docs/ja/specdojo/samples/cld-sample.md +3 -30
  271. package/docs/ja/specdojo/samples/clis-sample.md +132 -0
  272. package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
  273. package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
  274. package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
  275. package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
  276. package/docs/ja/specdojo/samples/dss-sample.md +175 -0
  277. package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
  278. package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
  279. package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
  280. package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
  281. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
  282. package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
  283. package/docs/ja/specdojo/samples/pm-organization-sample.md +52 -20
  284. package/docs/ja/specdojo/samples/pm-plan-sample.md +84 -26
  285. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +55 -22
  286. package/docs/ja/specdojo/samples/pm-raci-sample.md +69 -28
  287. package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
  288. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +50 -26
  289. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +89 -62
  290. package/docs/ja/specdojo/samples/sf-index-sample.md +89 -20
  291. package/docs/ja/specdojo/samples/sf-sample.md +121 -21
  292. package/docs/ja/specdojo/samples/sld-sample.md +107 -21
  293. package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
  294. package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
  295. package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
  296. package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
  297. package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
  298. package/docs/ja/specdojo/samples/uis-sample.md +164 -20
  299. package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
  300. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
  301. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
  302. package/docs/ja/specdojo/templates/bac-template.md +76 -0
  303. package/docs/ja/specdojo/templates/bes-template.md +56 -0
  304. package/docs/ja/specdojo/templates/br-template.md +64 -0
  305. package/docs/ja/specdojo/templates/cdfd-overview-template.md +161 -83
  306. package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
  307. package/docs/ja/specdojo/templates/cdfd-uc-template.md +130 -89
  308. package/docs/ja/specdojo/templates/cnd-template.md +137 -0
  309. package/docs/ja/specdojo/templates/cpd-template.md +129 -0
  310. package/docs/ja/specdojo/templates/cxd-template.md +105 -0
  311. package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
  312. package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
  313. package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
  314. package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
  315. package/docs/ja/specdojo/templates/ifd-template.md +86 -0
  316. package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
  317. package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
  318. package/docs/ja/specdojo/templates/opr-template.md +2 -4
  319. package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
  320. package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
  321. package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
  322. package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
  323. package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
  324. package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
  325. package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
  326. package/docs/ja/specdojo/templates/stsd-template.md +46 -21
  327. package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
  328. package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
  329. package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
  330. package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
  331. package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
  332. package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
  333. package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
  334. package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
  335. package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
  336. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +3 -0
  337. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +54 -3
  338. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +3 -0
  339. package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
  340. package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
  341. package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
  342. package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
  343. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
  344. package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
  345. package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
  346. package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
  347. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
  348. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -0
  349. package/package.json +6 -3
  350. package/templates/antigravity/README.md +19 -46
  351. package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
  352. package/templates/antigravity/orchestrator.md +3 -2
  353. package/templates/antigravity/settings.edit.json +73 -0
  354. package/templates/antigravity/settings.orchestrator.json +15 -0
  355. package/templates/antigravity/settings.report.json +7 -0
  356. package/templates/antigravity/settings.review.json +7 -0
  357. package/templates/claude/agents/specdojo-orchestrator.md +3 -2
  358. package/templates/codex/agents/specdojo-orchestrator.toml +3 -2
  359. package/templates/codex/orchestrator.md +3 -2
  360. package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
  361. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -96
  362. package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
  363. package/templates/devcontainer/tmux.conf +6 -0
  364. package/templates/init-agent-members.yaml +1 -0
  365. package/templates/init-exec-defaults.yaml +1 -1
  366. package/templates/opencode/agents/specdojo-orchestrator.md +3 -2
@@ -2,39 +2,93 @@
2
2
  specdojo:
3
3
  id: specdojo:br-sample
4
4
  type: rule
5
- status: draft
5
+ status: ready
6
6
  rulebook: specdojo:br-rulebook
7
7
  ---
8
8
 
9
- <!-- markdownlint-disable MD025 -->
9
+ # 駄菓子屋きぬや 在庫不足判定
10
10
 
11
- # 在庫不足判定
12
-
13
- <!-- markdownlint-enable MD025 -->
11
+ 在庫確認の対象商品について、予約分を差し引いた販売可能数が発注点を下回るかを判定する。
14
12
 
15
13
  ## 1. 概要
16
14
 
17
- 販売可能な在庫が発注点を下回っているかを判定する。
15
+ - 業務価値: 店主代表以外の人が店番するときも、同じ在庫から同じ不足判定を得て、人気商品の欠品に気付けるようにする。
16
+ - 利用者・適用場面: 店主代表または家族利用者代表が在庫を確認するとき、商品ごとの現在の在庫数・予約数・発注点がそろった時点で使う。
17
+ - 適用範囲: 単一店舗の商品 1 種類に対する、同一の確認時点の個数の比較。在庫数は店舗が保有する総数で、予約分を含む。予約分は店頭で自由に販売できる数量から除く。
18
+ - 本完成例では、個数を 0 以上の整数とし、比較時点と商品が一致する入力を前提とする。値は学習用であり、実店舗の設定値ではない。
19
+ - 対象外: 発注点の決め方、発注量、仕入れ先、発注承認、在庫の更新、販売の可否。判定結果から自動的に発注を確定しない。
18
20
 
19
21
  ## 2. 入力
20
22
 
21
- - 在庫: 在庫数と予約数を、有効在庫の算出に使用する。
22
- - 商品: 発注点を、不足判定のしきい値として使用する。
23
+ | 入力 | 概念データ・項目 | 利用目的 | 適用条件・欠損時の扱い |
24
+ | -------- | ---------------- | ------------------------------------ | ------------------------------------------------------------------- |
25
+ | 対象商品 | 商品識別 | 入力と判定結果を同じ商品へ対応付ける | 必須。未設定は `E-01` |
26
+ | 在庫 | 在庫数(個) | 販売可能数の計算の起点 | 必須。同じ確認時点の予約分を含む総数。未設定は `E-01` |
27
+ | 予約 | 予約数(個) | 販売可能数から予約済みの個数を除く | 必須。予約なしは 0 を明示する。未設定は `E-01` |
28
+ | 商品 | 発注点(個) | 不足とみなす境界 | 必須。0 も有効な値であり、未設定の代用には使わない。未設定は `E-01` |
23
29
 
24
30
  ## 3. ルール(判定/計算)
25
31
 
26
- 1. 有効在庫を `在庫数 − 予約数` で算出する。
27
- 2. 有効在庫が発注点を下回る場合は在庫不足と判定する。
32
+ ### 3.1. 判定規則
33
+
34
+ #### 3.1.1. R-01 入力の確認
35
+
36
+ 最初に必須項目の有無を確認し、次に個数が整数であること、最後に負数でないことを確認する。不備があれば「例外 / 異常系」に従い、以後の計算を行わない。0 は未設定とは区別する。
37
+
38
+ #### 3.1.2. R-02 販売可能数の算出
39
+
40
+ 販売可能数を「在庫数 − 予約数」で算出する。
41
+
42
+ 予約数が在庫数を超える場合は、予約を満たす在庫も足りていないため、負の販売可能数をそのまま不足判定に使う。0 に丸めず、入力不備とも扱わない。予約の調整自体は本ルールの対象外である。
43
+
44
+ #### 3.1.3. R-03 不足判定
45
+
46
+ - 販売可能数が発注点より小さい場合は「不足」とする。
47
+ - 販売可能数が発注点と等しい、または大きい場合は「不足なし」とする。
48
+
49
+ ### 3.2. 判定例
50
+
51
+ 商品識別を `ITEM-A` とし、各行で同じ確認時点の入力を使う。「未設定」は値が与えられていないことを表す。
52
+
53
+ | 例 | 入力・前提(在庫数 / 予約数 / 発注点、単位: 個) | 適用規則 | 期待結果 |
54
+ | --- | ------------------------------------------------ | -------------- | ----------------------------------------------- |
55
+ | 1 | 12 / 3 / 10 | `R-02`、`R-03` | 販売可能数 9、不足 |
56
+ | 2 | 13 / 3 / 10 | `R-02`、`R-03` | 販売可能数 10、不足なし(境界一致) |
57
+ | 3 | 14 / 3 / 10 | `R-02`、`R-03` | 販売可能数 11、不足なし |
58
+ | 4 | 0 / 0 / 1 | `R-02`、`R-03` | 販売可能数 0、不足 |
59
+ | 5 | 0 / 0 / 0 | `R-02`、`R-03` | 販売可能数 0、不足なし |
60
+ | 6 | 2 / 4 / 0 | `R-02`、`R-03` | 販売可能数 −2、不足(予約超過) |
61
+ | 7 | 8 / 未設定 / 10 | `R-01` | `E-01`。販売可能数・不足判定とも返さない |
62
+ | 8 | 8 / 0.5 / 10 | `R-01` | `E-02`。販売可能数・不足判定とも返さない |
63
+ | 9 | −1 / 0 / 10 | `R-01` | `E-03`。販売可能数・不足判定とも返さない |
64
+ | 10 | −1 / 未設定 / 10 | `R-01` | `E-01` が先。修正後の再判定で `E-03` を確認する |
65
+ | 11 | 商品識別が未設定、8 / 0 / 10 | `R-01` | `E-01`。商品へ結果を関連付けられない |
28
66
 
29
67
  ## 4. 出力
30
68
 
31
- - 不足フラグ: 在庫不足の場合は `true`、それ以外は `false`。
69
+ | 出力 | 意味・単位または区分 | 利用先 |
70
+ | ---------- | ---------------------------------------------- | ---------------------------------------------- |
71
+ | 対象商品 | 入力の商品識別。商品識別自体が不備なら返せない | 在庫確認結果を照合する店主代表・家族利用者代表 |
72
+ | 販売可能数 | 予約分を除いた個数。負数もあり得る | 不足理由の確認 |
73
+ | 不足判定 | 「不足 / 不足なし」。発注の確定を意味しない | 店主代表による補充検討 |
74
+ | 入力不備 | 例外 ID と該当する項目名。正常時には返さない | 入力した担当者による修正 |
75
+
76
+ 正常時は対象商品・販売可能数・不足判定を返す。入力不備のときは例外 ID と不備項目を返し、販売可能数・不足判定を返さない。判定不能を「不足なし」と扱わない。
32
77
 
33
78
  ## 5. 例外 / 異常系
34
79
 
35
- - 在庫数、予約数、発注点のいずれかが未設定の場合は判定せず、入力不備として通知する。
36
- - 在庫数、予約数、発注点のいずれかが負数の場合は判定せず、値の矛盾として通知する。
80
+ | ID | 状況 | 扱い | 利用者の次の手 |
81
+ | ------ | ---------------------------------------------------------------- | ------------------------------------------------------------ | ---------------------------------------------------------------------------- |
82
+ | `E-01` | 必須項目のいずれかが未設定 | 判定を行わず、未設定の項目名を返す | 在庫確認担当が不足項目を確認・入力して再判定する。発注点は店主代表へ確認する |
83
+ | `E-02` | 在庫数・予約数・発注点のいずれかが整数でない(文字列や小数など) | 判定を行わず、該当項目を返す。単位の換算や端数の丸めはしない | 在庫確認担当が個数として入力し直して再判定する |
84
+ | `E-03` | 在庫数・予約数・発注点のいずれかが負数 | 判定を行わず、負数の項目名を返す | 在庫確認担当が記録を確認・修正して再判定する |
85
+
86
+ 複数の種類の不備がある場合は `E-01` → `E-02` → `E-03` の順で最初の種類を返す。同じ種類に該当する項目はすべて示す。修正後は全入力を再確認する。
87
+
88
+ 外部参照の取得処理は本ルールに含めない。呼出元が必要項目を取得できなければ、値を推測して本ルールを呼び出さない。
37
89
 
38
90
  ## 6. メモ / 将来課題
39
91
 
40
- - 将来、季節要因に応じて発注点を動的に変更する。
92
+ 本完成例の判定範囲に未決事項はない。店主代表への業務承認依頼では、予約分の控除、発注点との等号の扱い、予約超過、入力不備時の判定不能を確認する。
93
+
94
+ 季節別の発注点の設定方法は将来の別ルールで扱う。本ルールは与えられた発注点との比較だけを担うため、その設定方法を先取りしない。
@@ -2,37 +2,99 @@
2
2
  specdojo:
3
3
  id: specdojo:ccd-sample
4
4
  type: data
5
- status: draft
5
+ status: ready
6
6
  rulebook: specdojo:ccd-mermaid-rulebook
7
+ based_on:
8
+ - specdojo:bdd-sample
7
9
  ---
8
10
 
9
- # [概念クラス図](../rulebooks/ccd-mermaid-rulebook.md) サンプル
11
+ # 概念クラス図 サンプル
10
12
 
11
13
  ## 1. 目的と適用範囲
12
14
 
13
- 本書は、業務上のエンティティ関係を図で定義するための最小サンプルである。
15
+ 駄菓子屋きぬやの店主代表と開発担当が、販売した商品と購入者を同じ単位で追跡できるよう、商品・顧客・売上記録・売上明細の識別と関連を定義する。技術メンターは設計時の管理単位の確認に、同行レビュー担当はキーと関連の整合性確認に用いる。
14
16
 
15
- ## 2. 入力情報
17
+ ### 1.1. 対象領域と扱う時点
16
18
 
17
- - 対象: 駄菓子屋の販売管理システム
18
- - 前提: プロジェクト文脈は handbook の共通方針に準拠する
19
- - 参照: `../rulebooks/ccd-mermaid-rulebook.md`
19
+ - 単一店舗の店頭販売を対象とし、確定済みの売上記録を扱う。入力途中・取消済みの取引は含めない。会計確定までの操作は [[specdojo:clis-sample|販売管理 CLI 仕様]] を参照する。
20
+ - 商品は販売する種類の単位で管理し、一個ずつの現物とは区別する。商品・売上記録・売上明細の業務上の意味は [[specdojo:bdd-sample|業務データ辞書(駄菓子屋の販売管理)]] に従う。
21
+ - 在庫、発注、つけ残高の集計、決済サービスの応答は対象外とする。購入者との関連は扱うが、代金回収の履歴は本図に含めない。
20
22
 
21
- ## 3. 記述内容
23
+ ### 1.2. 識別と辞書の境界
22
24
 
23
- - 主な内容: 商品・在庫・発注・店舗などの概念と属性、関連(継承/親子/参照) など
24
- - 必須観点: 対象、条件、判定基準、責任者
25
+ 図には主キーを示し、販売単価・数量などの定義の正本は販売管理の辞書とその参照先とする。顧客台帳と商品の特殊化については、既存辞書で確認できた対応と未照合の範囲を「参照業務データ辞書」に示す。
25
26
 
26
- ## 4. 最小記述例
27
+ ## 2. 概念クラス図
27
28
 
28
- | 項目 | 値 | 備考 |
29
- | ------------ | ------------------------------------------------------------------- | ------------------------------------ |
30
- | ドキュメント | [概念クラス図](../rulebooks/ccd-mermaid-rulebook.md) | 最小サンプル |
31
- | 目的 | 業務上のエンティティ関係を図で定義する | specdojo:deliverables-reference 準拠 |
32
- | 主な内容 | 商品・在庫・発注・店舗などの概念と属性、関連(継承/親子/参照) など | 要点のみ記載 |
29
+ ```mermaid
30
+ classDiagram
31
+ direction LR
32
+
33
+ class 商品 {
34
+ 商品ID: PK
35
+ }
36
+
37
+ class お菓子 {}
38
+
39
+ class 玩具 {}
40
+
41
+ class 顧客 {
42
+ 顧客ID: PK
43
+ }
44
+
45
+ class 売上記録 {
46
+ 売上ID: PK
47
+ }
48
+
49
+ class 売上明細 {
50
+ 売上ID: PK
51
+ 明細番号: PK
52
+ }
53
+
54
+ 商品 <|-- お菓子 : 種類
55
+ 商品 <|-- 玩具 : 種類
56
+ 売上記録 "1" *-- "1..*" 売上明細 : 構成する
57
+ 売上明細 "0..*" --> "1" 商品 : 対象商品
58
+ 売上記録 "0..*" --> "0..1" 顧客 : 購入者
59
+ ```
60
+
61
+ お菓子と玩具は商品の下位概念であり、商品IDを継承する。同じ商品の別レコードを作る意味ではなく、独立した主キーは追加しない。特殊化の辞書定義は未照合である。
62
+
63
+ ## 3. 関連定義と多重度の根拠
64
+
65
+ ### 3.1. 関連ごとの成立条件
66
+
67
+ 多重度は図の起点側・先側の順に示す。
68
+
69
+ | 関連(起点 - 先) | 関係種別 | 多重度 | 役割名 | 業務上の理由・根拠 |
70
+ | ------------------- | -------- | ---------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
71
+ | 商品 - お菓子 | 継承 | — | 種類 | お菓子は販売対象の商品として識別・参照される種類であり、売上明細との関連も引き継ぐ。商品の構成部品ではない。 |
72
+ | 商品 - 玩具 | 継承 | — | 種類 | 玩具も商品として販売・追跡する種類であり、商品と別の識別単位を設けない。お菓子と玩具の分類境界は辞書整備時に確認する。 |
73
+ | 売上記録 - 売上明細 | 親子 | `1` 対 `1..*` | 構成する | 明細は必ず一つの売上記録に属し、単独で管理しない。確定済み売上には一行以上必要で、複数商品の購入では複数行になる。入力途中の明細0件は対象時点の外にある。 |
74
+ | 売上明細 - 商品 | 参照 | `0..*` 対 `1` | 対象商品 | 明細一行の販売対象は必ず一つの商品。同じ商品は複数の販売・明細に現れ、未販売の商品も管理するため、商品に対応する明細は0件以上となる。商品は売上とは別の管理単位として残す。 |
75
+ | 売上記録 - 顧客 | 参照 | `0..*` 対 `0..1` | 購入者 | 一回の販売で特定する購入者は一人まで。一見客の現金販売では特定しない。顧客は購入前に登録でき、繰り返し購入できるため、対応する売上は0件以上となる。つけ販売の必須条件は次節で限定する。 |
76
+
77
+ ### 3.2. 図だけでは表せない整合性条件
78
+
79
+ - 売上明細は売上IDと明細番号の組で一意にする。明細番号は別の売上で再利用でき、商品IDだけで明細をまとめない。同じ商品を複数行で販売しても各行を識別できる。
80
+ - 売上明細の参照先商品と、購入者を指定した売上の参照先顧客が存在することを確認する。過去の販売を追跡できるよう、商品の名称・価格の変更によって参照先の識別を変えない。親子の線は業務上の所属を表し、保存ファイルの削除連動は定めない。
81
+ - 売上と顧客の任意関連は全販売に対する許容範囲である。[[specdojo:bdd-sample|業務データ辞書(駄菓子屋の販売管理)]] の売上記録に従い、つけ販売では請求先の顧客を必須とする。購入者未指定を現金販売と読み替えない。
82
+
83
+ ## 4. 参照業務データ辞書
84
+
85
+ 作成済み辞書と照合したキーの対応を示す。「未定義」は既存辞書に該当する概念がない状態、「未作成」は参照予定の辞書自体がない状態を表す。
86
+
87
+ | エンティティ | 主キーの対応 | 参照先業務データ辞書 |
88
+ | ------------ | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
89
+ | 商品 | 商品ID → `product_id`。店舗で管理する商品の範囲で一意 | [[specdojo:bdd-sample\|業務データ辞書(駄菓子屋の販売管理)]] の商品 |
90
+ | お菓子・玩具 | 商品の `product_id` を継承。商品全体と同じ識別範囲を使い、種類ごとに同じIDを別商品へ割り当てない | [[specdojo:bdd-sample\|業務データ辞書(駄菓子屋の販売管理)]] の商品キーのみ照合済み。下位概念は未定義 |
91
+ | 顧客 | 顧客ID → 売上記録の参照項目 `customer_id`。顧客台帳内で一意とする想定だが、台帳のキーは未照合 | 予定 ID `specdojo:bdd-customer`(未作成)。既存の [[specdojo:bdd-sample\|販売管理の辞書]] では顧客台帳は対象外 |
92
+ | 売上記録 | 売上ID → `sale_id`。店舗の販売全体で一意 | [[specdojo:bdd-sample\|業務データ辞書(駄菓子屋の販売管理)]] の売上記録 |
93
+ | 売上明細 | 売上ID・明細番号 → `sale_id`・`line_number` の複合主キー。明細番号単独の一意性は一回の販売内に限る | [[specdojo:bdd-sample\|業務データ辞書(駄菓子屋の販売管理)]] の売上明細 |
33
94
 
34
95
  ## 5. 未解決事項
35
96
 
36
- | 論点 | 処理方針 |
37
- | -------------- | ------------------------ |
38
- | 要件詳細の補強 | 実案件適用時に具体化する |
97
+ | 論点 | 影響・現在の扱い | 解消責務・確認条件 |
98
+ | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
99
+ | 商品の特殊化の辞書定義 | 商品キーとの対応は確認済みだが、お菓子・玩具の分類境界は既存辞書で未定義。図の継承は維持し、分類の網羅性・排他性は断定しない | 開発担当が辞書への定義追加案を作成し、店主代表が分類境界を確認する。技術メンターが継承するキーと関連を照合できた時点で解消する |
100
+ | 顧客台帳との照合 | _ASSUMPTION_: 予定辞書 `specdojo:bdd-customer` で顧客IDを台帳内の一意キーとする。売上側の参照名は確認済みだが、参照先のキー・識別範囲は未照合。顧客関連を確定済みとは扱わない | 開発担当が顧客辞書を整備し、店主代表が購入者の特定単位を確認する。技術メンターが `customer_id` の対応・一意性・参照先の存在条件と、つけ販売時の必須条件を照合した時点で解消する |