specdojo 0.8.0 → 0.9.1

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 (292) hide show
  1. package/.github/agents/specdojo-orchestrator.md +4 -1
  2. package/CHANGELOG.md +77 -0
  3. package/dist/catalog/catalog.js +16 -14
  4. package/dist/commands/agent.js +5 -3
  5. package/dist/commands/build.js +69 -10
  6. package/dist/commands/git.js +206 -0
  7. package/dist/commands/init.js +4 -2
  8. package/dist/commands/orchestrator.js +5 -77
  9. package/dist/commands/where.js +25 -0
  10. package/dist/dashboard/dashboard.js +5 -3
  11. package/dist/dashboard/routines.js +4 -7
  12. package/dist/dashboard/shared.js +2 -2
  13. package/dist/dashboard/timeline.js +14 -14
  14. package/dist/deliverable/trash.js +2 -1
  15. package/dist/docs/index-command.js +2 -2
  16. package/dist/docs/yaml-business-tables.js +243 -0
  17. package/dist/docs/yaml-interface-tables.js +106 -0
  18. package/dist/docs/yaml-pages-command.js +5 -3
  19. package/dist/docs/yaml-pages.js +146 -3
  20. package/dist/docs/yaml-table-shared.js +70 -0
  21. package/dist/docs/yaml-tables.js +39 -0
  22. package/dist/exec/agent-config.js +9 -0
  23. package/dist/exec/agent-protected-config.js +2 -0
  24. package/dist/exec/commands.js +31 -18
  25. package/dist/exec/events.js +34 -14
  26. package/dist/exec/evidence.js +13 -3
  27. package/dist/exec/opencode-permissions.js +117 -0
  28. package/dist/exec/parent-validation.js +56 -3
  29. package/dist/exec/plans-core.js +21 -2
  30. package/dist/exec/plans-generation.js +6 -7
  31. package/dist/exec/post-integration.js +162 -0
  32. package/dist/exec/queue-command.js +166 -0
  33. package/dist/exec/queue.js +285 -0
  34. package/dist/exec/register-foreign-wait.js +82 -0
  35. package/dist/exec/repo-integration-sync.js +17 -5
  36. package/dist/exec/repo-trace.js +2 -1
  37. package/dist/exec/reporter.js +2 -2
  38. package/dist/exec/results.js +24 -4
  39. package/dist/exec/review-kata.js +4 -1
  40. package/dist/exec/run/agent-pipeline.js +3 -2
  41. package/dist/exec/run/agent.js +12 -6
  42. package/dist/exec/run/change-scope.js +365 -0
  43. package/dist/exec/run/deferred-cleanup.js +31 -0
  44. package/dist/exec/run/in-place.js +5 -2
  45. package/dist/exec/run/job-lock.js +66 -0
  46. package/dist/exec/run/job-sequence.js +137 -0
  47. package/dist/exec/run/job.js +56 -19
  48. package/dist/exec/run/lifecycle-commands.js +1 -1
  49. package/dist/exec/run/lock.js +22 -1
  50. package/dist/exec/run/register-command.js +8 -5
  51. package/dist/exec/run/register-mode.js +68 -8
  52. package/dist/exec/run/register-resume.js +68 -14
  53. package/dist/exec/run/register-state.js +13 -8
  54. package/dist/exec/run/register-worktree.js +140 -125
  55. package/dist/exec/run/schedule-mode.js +75 -14
  56. package/dist/exec/run/schedule-prepare.js +3 -0
  57. package/dist/exec/run/schedule-task.js +88 -38
  58. package/dist/exec/run/shared.js +5 -0
  59. package/dist/exec/schedule/schedule.js +116 -4
  60. package/dist/exec/shared.js +2 -2
  61. package/dist/exec/smoke.js +190 -0
  62. package/dist/exec/strategy.js +13 -3
  63. package/dist/exec/task-repos.js +19 -4
  64. package/dist/exec/task-view.js +6 -4
  65. package/dist/exec/trial-commands.js +5 -2
  66. package/dist/exec/trial-core.js +6 -1
  67. package/dist/exec/validation-metrics.js +181 -0
  68. package/dist/exec/worktree-cleanup-lock.js +26 -0
  69. package/dist/exec/worktree-command.js +12 -2
  70. package/dist/exec/worktree-ops-commit.js +2 -2
  71. package/dist/exec/worktree.js +13 -2
  72. package/dist/grade/command-apply.js +3 -3
  73. package/dist/grade/command-inspect.js +5 -3
  74. package/dist/grade/command-plan.js +1 -1
  75. package/dist/grade/command-run.js +5 -1
  76. package/dist/grade/run.js +64 -8
  77. package/dist/job/definition.js +84 -8
  78. package/dist/job/job.js +79 -23
  79. package/dist/register/authoring-sources.js +22 -16
  80. package/dist/register/maintenance-commands.js +2 -2
  81. package/dist/register/register.js +31 -7
  82. package/dist/register/renumber.js +1 -3
  83. package/dist/routine/definition.js +9 -0
  84. package/dist/routine/routine.js +137 -43
  85. package/dist/routine/status.js +62 -0
  86. package/dist/schedule/schedule.js +38 -39
  87. package/dist/shared/agent-types.js +5 -0
  88. package/dist/shared/cross-process-lock.js +9 -1
  89. package/dist/shared/dist-freshness.js +8 -2
  90. package/dist/shared/git-environment.js +2 -1
  91. package/dist/shared/git.js +44 -1
  92. package/dist/shared/lefthook-scaffold.js +3 -0
  93. package/dist/shared/local-config.js +244 -0
  94. package/dist/shared/specdojo-config.js +34 -20
  95. package/dist/shared/specdojo-gitignore.js +1 -0
  96. package/dist/shared/text.js +17 -1
  97. package/dist/shared/where-alias.js +13 -0
  98. package/dist/specdojo.js +4 -0
  99. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
  100. package/docs/ja/specdojo/guides/exec-config-guide.md +23 -4
  101. package/docs/ja/specdojo/guides/exec-operation-guide.md +44 -1
  102. package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
  103. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +1 -1
  104. package/docs/ja/specdojo/guides/quick-start-guide.md +3 -3
  105. package/docs/ja/specdojo/guides/register-operation-guide.md +1 -1
  106. package/docs/ja/specdojo/guides/routine-operation-guide.md +11 -6
  107. package/docs/ja/specdojo/guides/schedule-design-guide.md +20 -17
  108. package/docs/ja/specdojo/guides/waza-guide.md +12 -8
  109. package/docs/ja/specdojo/recipes/bac-recipe.md +66 -49
  110. package/docs/ja/specdojo/recipes/bes-recipe.md +90 -54
  111. package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
  112. package/docs/ja/specdojo/recipes/br-recipe.md +40 -47
  113. package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
  114. package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
  115. package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +91 -110
  116. package/docs/ja/specdojo/recipes/cnd-recipe.md +79 -69
  117. package/docs/ja/specdojo/recipes/cpd-recipe.md +78 -64
  118. package/docs/ja/specdojo/recipes/cxd-recipe.md +92 -75
  119. package/docs/ja/specdojo/recipes/ifd-recipe.md +79 -68
  120. package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +78 -105
  121. package/docs/ja/specdojo/recipes/ifx-index-recipe.md +105 -71
  122. package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
  123. package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
  124. package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -51
  125. package/docs/ja/specdojo/recipes/pm-plan-recipe.md +69 -56
  126. package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +37 -56
  127. package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -53
  128. package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -79
  129. package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -93
  130. package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
  131. package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -157
  132. package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
  133. package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
  134. package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
  135. package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
  136. package/docs/ja/specdojo/recipes/stsd-recipe.md +79 -109
  137. package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +78 -55
  138. package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +82 -73
  139. package/docs/ja/specdojo/recipes/sysd-index-recipe.md +78 -59
  140. package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
  141. package/docs/ja/specdojo/references/command-reference.md +258 -118
  142. package/docs/ja/specdojo/references/deliverables-reference.md +21 -12
  143. package/docs/ja/specdojo/references/specdojo-config-reference.md +47 -10
  144. package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
  145. package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
  146. package/docs/ja/specdojo/rulebooks/bac-rulebook.md +19 -28
  147. package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +16 -67
  148. package/docs/ja/specdojo/rulebooks/bds-rulebook.md +30 -51
  149. package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +41 -61
  150. package/docs/ja/specdojo/rulebooks/bes-rulebook.md +22 -50
  151. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
  152. package/docs/ja/specdojo/rulebooks/br-rulebook.md +13 -38
  153. package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +41 -76
  154. package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
  155. package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
  156. package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
  157. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
  158. package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +21 -46
  159. package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
  160. package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +27 -48
  161. package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +37 -50
  162. package/docs/ja/specdojo/rulebooks/clis-rulebook.md +52 -69
  163. package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
  164. package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +16 -32
  165. package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
  166. package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
  167. package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
  168. package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +23 -56
  169. package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
  170. package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +39 -47
  171. package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +37 -56
  172. package/docs/ja/specdojo/rulebooks/dct-rulebook.md +118 -175
  173. package/docs/ja/specdojo/rulebooks/dec-rulebook.md +5 -14
  174. package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
  175. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
  176. package/docs/ja/specdojo/rulebooks/dss-rulebook.md +59 -81
  177. package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
  178. package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
  179. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +51 -61
  180. package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +38 -45
  181. package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
  182. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +26 -38
  183. package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +26 -107
  184. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +42 -49
  185. package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
  186. package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +21 -44
  187. package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
  188. package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +14 -38
  189. package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
  190. package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
  191. package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
  192. package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
  193. package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
  194. package/docs/ja/specdojo/rulebooks/mm-rulebook.md +11 -23
  195. package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
  196. package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
  197. package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
  198. package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
  199. package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
  200. package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
  201. package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
  202. package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
  203. package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
  204. package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
  205. package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
  206. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
  207. package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
  208. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
  209. package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
  210. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
  211. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +91 -106
  212. package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
  213. package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
  214. package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
  215. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
  216. package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +37 -45
  217. package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +45 -46
  218. package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +37 -48
  219. package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +25 -29
  220. package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
  221. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +36 -41
  222. package/docs/ja/specdojo/rulebooks/pr-rulebook.md +5 -18
  223. package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +16 -37
  224. package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
  225. package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +39 -57
  226. package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
  227. package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
  228. package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
  229. package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
  230. package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
  231. package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +39 -49
  232. package/docs/ja/specdojo/rulebooks/sf-rulebook.md +42 -49
  233. package/docs/ja/specdojo/rulebooks/sld-rulebook.md +64 -89
  234. package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
  235. package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
  236. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +6 -12
  237. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +49 -68
  238. package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +51 -60
  239. package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +46 -50
  240. package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +39 -64
  241. package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
  242. package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -70
  243. package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
  244. package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
  245. package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
  246. package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
  247. package/docs/ja/specdojo/rulebooks/uis-rulebook.md +41 -108
  248. package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
  249. package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
  250. package/docs/ja/specdojo/samples/bds-sample.md +58 -71
  251. package/docs/ja/specdojo/samples/bes-index-sample.md +20 -37
  252. package/docs/ja/specdojo/samples/bes-sample.md +43 -53
  253. package/docs/ja/specdojo/samples/bps-sample.md +42 -54
  254. package/docs/ja/specdojo/samples/br-sample.md +40 -52
  255. package/docs/ja/specdojo/samples/ccd-sample.md +0 -1
  256. package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
  257. package/docs/ja/specdojo/samples/cdsd-sample.md +47 -63
  258. package/docs/ja/specdojo/samples/clis-sample.md +70 -77
  259. package/docs/ja/specdojo/samples/dec-sample.md +2 -3
  260. package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
  261. package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
  262. package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
  263. package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
  264. package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
  265. package/docs/ja/specdojo/samples/pm-organization-sample.md +39 -50
  266. package/docs/ja/specdojo/samples/pm-plan-sample.md +61 -67
  267. package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +31 -45
  268. package/docs/ja/specdojo/samples/pm-raci-sample.md +31 -37
  269. package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +32 -48
  270. package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
  271. package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +55 -61
  272. package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
  273. package/docs/ja/specdojo/samples/sf-index-sample.md +13 -55
  274. package/docs/ja/specdojo/samples/sf-sample.md +73 -85
  275. package/docs/ja/specdojo/samples/sld-sample.md +60 -79
  276. package/docs/ja/specdojo/samples/uis-sample.md +98 -121
  277. package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
  278. package/docs/ja/specdojo/templates/cdr-template.md +58 -0
  279. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
  280. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +42 -5
  281. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +35 -0
  282. package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
  283. package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
  284. package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
  285. package/package.json +9 -6
  286. package/templates/antigravity/orchestrator.md +4 -1
  287. package/templates/claude/agents/specdojo-orchestrator.md +4 -1
  288. package/templates/codex/agents/specdojo-orchestrator.toml +4 -1
  289. package/templates/codex/orchestrator.md +4 -1
  290. package/templates/init-exec-defaults.yaml +13 -0
  291. package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
  292. package/templates/opencode/agents/specdojo-orchestrator.md +5 -2
@@ -16,45 +16,45 @@ specdojo:
16
16
 
17
17
  ### 1.1. 利用環境と対象範囲
18
18
 
19
- - 単一店舗のタブレット 1 台で、認証済みの担当者が 1 件ずつ取引する。新規販売は店舗待機画面から開始し、確定後は販売完了画面へ進む。
20
- - 商品コードは手入力するか、入力欄を選択した状態でバーコードスキャナから読み取る。スキャナは商品コードの入力と商品追加の確定を行う。
21
- - 本画面は現金販売を扱う。つけ販売・返品・確定後の取消は別業務とし、登録中の取引は本画面で中止できる。
22
- - _ASSUMPTION_: 店舗サービスに接続して商品情報の取得と会計確定を行う。接続できない間は入力済みの明細を保持して復旧を待つ。営業中に復旧できない場合は店主が取引番号と状況を控えて開発担当へ連絡し、紙の販売記録による継続を判断する。採用前の確認担当・判断時点・報告先は「本仕様内の未確認事項」に示す。
19
+ - 単一店舗のタブレット 1 台で、認証済みの担当者が 1 件ずつ取引する。
20
+ - 商品コードは手入力するか、入力欄を選択した状態でバーコードスキャナから読み取るし、スキャンで商品追加を確定する。
21
+ - 本画面は現金販売を扱う。つけ販売・返品・確定後の取消は別業務とする。
22
+ - _ASSUMPTION_: 店舗サービスに接続して商品情報の取得と会計確定を行う(「メモ / 将来課題」)。
23
23
 
24
24
  ## 2. 対象ユーザー/利用目的
25
25
 
26
- | 対象ユーザー | 利用場面・目的 | 許可される操作 |
27
- | ------------ | ---------------------------------------------------------- | ------------------------------------------------------------------ |
28
- | 店員 | 接客中に商品を登録し、請求額と預かり金を照合して釣銭を渡す | 商品追加、数量変更、明細削除、商品検索、会計確定、登録中の取引中止 |
29
- | 店主 | 自ら店番し、誤入力や通信失敗時にも取引の確定状況を確認する | 店員と同じ操作、および同じ回復操作 |
26
+ | 対象ユーザー | 利用場面・目的 | 許可される操作 |
27
+ | ------------ | ---------------------------------------------------------- | ---------------- |
28
+ | 店員 | 接客中に商品を登録し、請求額と預かり金を照合して釣銭を渡す | 「操作」の全操作 |
29
+ | 店主 | 自ら店番し、誤入力や通信失敗時にも取引の確定状況を確認する | 店員と同じ |
30
30
 
31
- 来店客には担当者が合計請求金額と釣銭を伝える。画面を直接操作するのは店員・店主とする。販売登録権限を持たない利用者は本画面を利用できない。
31
+ 画面を操作するのは店員・店主で、来店客には担当者が合計請求金額と釣銭を伝える。
32
32
 
33
33
  ## 3. 表示項目
34
34
 
35
35
  ### 3.1. 入力・明細・集計
36
36
 
37
- | 項目名 | 種別 | 表示内容 | 編集可否 | 初期値・表示条件・更新契機 |
38
- | ------------------------ | ---- | ------------------------------------------------ | -------- | -------------------------------------------------------------- |
39
- | 取引番号 | 識別 | 開始時に発行された取引の一意な番号 | 不可 | 例 `TX-20261108-0012`。回復操作でも同じ番号を使用 |
40
- | 取引開始日時 | 識別 | 店舗時刻の年月日・時分 | 不可 | 新規販売開始時に設定し、再試行で変更しない |
41
- | 担当者 | 識別 | 現在の担当者の表示名 | 不可 | 例「店主」。認証済みの担当者を表示 |
42
- | 商品コード | 入力 | 登録する商品の 8 桁数字コード | 可 | 初期値は空。追加成功時に空へ戻す。失敗時は入力を保持 |
43
- | 明細の商品コード・商品名 | 一覧 | 追加済みの商品の識別と名称 | 不可 | 商品台帳から取得。明細なしは「商品を追加してください」 |
44
- | 明細の単価 | 一覧 | 1 個あたりの税込販売価格、円単位 | 不可 | 商品追加時に取得。確定時に価格変更があれば再確認 |
45
- | 明細の数量 | 入力 | 当該商品の購入数量、個単位 | 可 | 初回追加は 1。同じ商品の追加で 1 増加 |
46
- | 明細小計 | 一覧 | 税込単価 × 数量、円単位 | 不可 | 追加・数量変更の成功時に更新 |
47
- | 現在庫数 | 一覧 | 各商品の販売可能な数量、個単位 | 不可 | 商品追加・数量変更・会計確定時に再確認 |
48
- | 品目数・総数量 | 集計 | 異なる商品の件数と数量の合計 | 不可 | 初期値は 0 品目 0 点。明細更新時に再計算 |
49
- | 税抜小計 | 集計 | 合計請求金額から内税額を差し引いた金額 | 不可 | 初期値は 0 円。明細更新時に再計算 |
50
- | 内税額 | 集計 | 税率別の内税額とその合計、円単位 | 不可 | 初期値は各 0 円。明細更新時に再計算 |
51
- | 合計請求金額 | 集計 | 全明細小計の合計、円単位 | 不可 | 初期値は 0 円。明細更新時に再計算 |
52
- | 預かり金額 | 入力 | 来店客から受領した金額、円単位 | 可 | 初期値は空。明細更新後も入力値を保持して再判定 |
53
- | 釣銭金額 | 集計 | 預かり金額 − 合計請求金額、円単位 | 不可 | 未入力・形式不正・金額不足時は「未計算」。有効な入力後は再計算 |
54
- | 取引状態 | 状態 | 「登録中」「会計処理中」「結果確認待ち」 | 不可 | 状態別の操作可否は「操作」に従う |
55
- | 処理・エラー通知 | 状態 | 実行中の操作、失敗理由、修正対象、次に行える操作 | 不可 | エラー事象に対応する表示を行い、解消時に消去 |
56
-
57
- 商品台帳は税込単価と税率区分(8% または 10%)を持つ。金額計算は税率別に税込明細小計を合算し、それぞれの合算額 × 税率 ÷(100 + 税率)の 1 円未満を切り捨てて内税額とする。請求額に内税額を加算しない。
37
+ | 項目名 | 種別 | 表示内容 | 編集可否 | 初期値・表示条件・更新契機 |
38
+ | ------------------------ | ---- | ------------------------------------------------ | -------- | ------------------------------------------------------ |
39
+ | 取引番号 | 識別 | 開始時に発行された取引の一意な番号 | 不可 | 例 `TX-20261108-0012`。回復操作でも同じ番号を使う |
40
+ | 担当者 | 識別 | 認証済みの担当者の表示名 | 不可 | 例「店主」 |
41
+ | 取引開始日時 | 識別 | 店舗時刻の年月日・時分 | 不可 | 新規販売開始時に設定し、再試行で変えない |
42
+ | 商品コード | 入力 | 登録する商品の 8 桁数字コード | 可 | 初期値は空。追加成功時に空へ戻し、失敗時は保持 |
43
+ | 明細の商品コード・商品名 | 一覧 | 追加済みの商品の識別と名称 | 不可 | 商品台帳から取得。明細なしは「商品を追加してください」 |
44
+ | 明細の単価 | 一覧 | 1 個あたりの税込販売価格、円単位 | 不可 | 商品追加時に取得 |
45
+ | 明細の数量 | 入力 | 購入数量、個単位 | 可 | 初回追加は 1。同じ商品の追加で 1 増加 |
46
+ | 明細小計 | 一覧 | 税込単価 × 数量、円単位 | 不可 | 追加・数量変更の成功時に更新 |
47
+ | 現在庫数 | 一覧 | 販売可能な数量、個単位 | 不可 | 在庫の判定時に更新 |
48
+ | 品目数・総数量 | 集計 | 異なる商品の件数と数量の合計 | 不可 | 初期値は 0 品目 0 点 |
49
+ | 税抜小計 | 集計 | 合計請求金額から内税額を引いた金額 | 不可 | 初期値は 0 円 |
50
+ | 内税額 | 集計 | 税率別の内税額とその合計、円単位 | 不可 | 初期値は各 0 円 |
51
+ | 合計請求金額 | 集計 | 全明細小計の合計、円単位 | 不可 | 初期値は 0 円 |
52
+ | 預かり金額 | 入力 | 来店客から受け取った金額、円単位 | 可 | 初期値は空。明細更新後も保持して再判定 |
53
+ | 釣銭金額 | 集計 | 預かり金額 − 合計請求金額、円単位 | 不可 | 預かり金額が無効・不足の間は「未計算」 |
54
+ | 取引状態 | 状態 | 「登録中」「会計処理中」「結果確認待ち」 | 不可 | 「状態と操作可否」 |
55
+ | 処理・エラー通知 | 状態 | 実行中の操作、失敗理由、修正対象、次に行える操作 | 不可 | 解消時に消す |
56
+
57
+ 集計は明細の更新ごとに計算し直す。商品台帳は税込単価と税率区分(8% または 10%)を持つ。税率別に税込明細小計を合算し、合算額 × 税率 ÷(100 + 税率)の 1 円未満を切り捨てて内税額とする。請求額に内税額を加算しない。
58
58
 
59
59
  ### 3.2. 表示値の確認例
60
60
 
@@ -63,120 +63,97 @@ specdojo:
63
63
  | きなこ棒(袋) | 108 円 | 8% | 2 個 | 216 円 |
64
64
  | おもちゃ入り菓子 | 110 円 | 10% | 1 個 | 110 円 |
65
65
 
66
- この明細では 2 品目 3 点、合計請求金額 326 円、内税額は 8% 分 16 円と 10% 分 10 円の計 26 円、税抜小計 300 円となる。預かり金額 500 円で釣銭は 174 円、326 円で釣銭は 0 円、325 円で釣銭は「未計算」となる。
66
+ この明細では 2 品目 3 点、合計請求金額 326 円、内税額は 8% 分 16 円と 10% 分 10 円の計 26 円、税抜小計 300 円となる。預かり金額 500 円で釣銭は 174 円、326 円で 0 円、325 円で「未計算」となる。
67
67
 
68
68
  ## 4. 操作
69
69
 
70
70
  ### 4.1. 状態と操作可否
71
71
 
72
- | 状態 | 可能な操作 | 状態を抜ける条件 |
73
- | ------------ | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
74
- | 登録中 | 入力・商品追加・数量変更・明細削除・商品検索・取引中止・会計確定 | 会計確定の受付で「会計処理中」。中止確認に同意した場合は店舗待機画面へ |
75
- | 会計処理中 | 状態表示の確認 | 成功時は販売完了画面へ。確定されていないことが確認できる失敗は「登録中」。通信切断・30 秒の応答待ち超過は「結果確認待ち」 |
76
- | 結果確認待ち | 「結果確認」、認証失効・権限不足時の「再ログイン」 | 確定済みは販売完了画面へ。元の確定処理が終了して未確定であることが確認できれば「登録中」。処理継続中・照会失敗はこの状態を保持 |
72
+ | 状態 | 可能な操作 | 状態を抜ける条件 |
73
+ | ------------ | -------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
74
+ | 登録中 | 結果確認・再ログイン以外の操作 | 会計確定の受付で「会計処理中」。中止に同意すると店舗待機画面へ |
75
+ | 会計処理中 | 状態表示の確認 | 成功時は販売完了画面へ。未確定と確認できる失敗は「登録中」。通信切断・30 秒の応答待ち超過は「結果確認待ち」 |
76
+ | 結果確認待ち | 「結果確認」、認証失効・権限不足時の「再ログイン」 | 確定済みは販売完了画面へ。元の確定処理が終わって未確定と確認できれば「登録中」。処理継続中・照会失敗はこの状態を保持 |
77
77
 
78
- 「会計処理中」「結果確認待ち」では入力、商品検索、明細変更、取引中止、会計確定を無効化する。登録中の取得・変更操作も 1 件ずつ処理し、その処理中は他の登録操作を無効化する。認証失効・権限不足時は「再ログイン」だけを許可する。
78
+ 登録中の取得・変更操作は 1 件ずつ処理し、その処理中は他の登録操作を無効化する。認証失効・権限不足時は「再ログイン」だけを許す。
79
79
 
80
80
  ### 4.2. 操作ごとの前提と結果
81
81
 
82
- | 操作名 | 対象 | 前提条件 | 結果(更新/遷移) |
83
- | ------------ | -------------------------------------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
84
- | 商品追加 | 商品コード入力欄と「商品追加」、スキャナ入力 | 登録中。商品コードを入力済み | 制約確認後、未追加の商品は数量 1 の行を追加。同じ商品は既存行の数量を 1 増やし、集計・釣銭を再計算。失敗時は明細を保持 |
85
- | 数量変更 | 明細の数量 | 登録中。対象明細が存在 | 制約確認後に数量と集計・釣銭を更新。失敗時は前の有効数量を保持し、修正用の入力値とエラーを表示 |
86
- | 明細削除 | 明細の「削除」 | 登録中。対象明細が存在 | 対象行を削除し、集計・釣銭を再計算。最終行の削除後は空の明細表示へ戻る |
87
- | 預かり金入力 | 預かり金額 | 登録中 | 入力値を保持。形式・金額を判定し、有効なら釣銭を再計算 |
88
- | 商品検索 | 「商品検索」 | 登録中 | 商品検索ダイアログを開く。選択した商品コードを商品追加と同じ条件で反映。選択取消時は元の入力・明細を保持 |
89
- | 取引中止 | 「取引中止」 | 登録中 | 中止確認を開く。同意時に明細・預かり金を破棄して店舗待機画面へ。戻る場合は登録を継続 |
90
- | 会計確定 | 「会計確定」 | 登録中。明細が 1 件以上あり、明細の数量に未修正の入力エラーがなく、預かり金額の形式・範囲が有効 | 「バリデーション」の確定条件を判定。成功時は販売記録と在庫引落をまとめて確定し、完了画面へ。条件違反時は登録中のまま対応エラーを表示 |
91
- | 読み直し | 「読み直し」 | 登録中。商品取得・在庫確認が通信失敗 | 同じ商品コード・数量で情報を再取得し、成功時に元の追加・変更を 1 回反映。失敗時は入力と有効な明細を保持 |
92
- | 結果確認 | 「結果確認」 | 結果確認待ち。認証と販売登録権限が有効 | 同じ取引番号の状態を照会し、「状態と操作可否」に従って復帰。新たな会計確定要求は発行しない |
93
- | 再ログイン | 「再ログイン」 | 認証失効または権限不足を検出 | 取引番号・状態・入力を保持してログイン画面へ。同じ担当者が再認証し権限確認できた場合に復帰 |
82
+ 取引中止・再ログインは「遷移」、入力条件は「バリデーション」、回復は「エラー表示と利用者の次の手」に従う。
94
83
 
95
- 会計確定は販売記録と在庫引落の両方が成功した時点を完了とする。片方だけの成功を利用者へ完了として表示しない。同じ取引番号で確定操作を再実行しても、販売記録と在庫引落は各 1 回とする。会計処理中の連打は追加の確定として受け付けない。
84
+ | 操作名 | 対象 | 前提条件 | 結果 |
85
+ | ------------ | -------------------------------------------- | -------------------------------------- | --------------------------------------------------------------------------- |
86
+ | 商品追加 | 商品コード入力欄と「商品追加」、スキャナ入力 | 登録中。商品コードを入力済み | 未追加の商品は数量 1 の行を追加し、追加済みの商品は数量を 1 増やす |
87
+ | 数量変更 | 明細の数量 | 登録中。対象明細がある | 数量と集計を更新する |
88
+ | 明細削除 | 明細の「削除」 | 登録中。対象明細がある | 行を削除して集計を更新する。最終行の削除後は空の明細表示へ戻る |
89
+ | 預かり金入力 | 預かり金額 | 登録中 | 入力値を保持し、有効なら釣銭を計算する |
90
+ | 商品検索 | 「商品検索」 | 登録中 | 商品検索ダイアログを開き、選んだ商品を商品追加と同じ条件で反映する |
91
+ | 会計確定 | 「会計確定」 | 登録中。確定時の条件を満たす | 販売記録と在庫引落をまとめて確定し、販売完了画面へ |
92
+ | 読み直し | 「読み直し」 | 登録中。商品取得・在庫確認が通信失敗 | 同じ商品コード・数量で情報を取り直し、成功時に元の追加・変更を 1 回反映する |
93
+ | 結果確認 | 「結果確認」 | 結果確認待ち。認証と販売登録権限が有効 | 同じ取引番号の状態を照会する。新たな会計確定要求は出さない |
96
94
 
97
- 「読み直し」は直前に失敗した商品取得・在庫確認を対象とする。入力の修正や別の明細操作を行った場合は、その失敗要求を取り消して「読み直し」を解除する。追加・変更の成功後も解除する。
95
+ 会計確定は販売記録と在庫引落の両方が成功した時点を完了とし、片方だけの成功を完了と表示しない。同じ取引番号で確定を再実行しても、販売記録と在庫引落は各 1 回とする。
96
+
97
+ 「読み直し」は直前に失敗した商品取得・在庫確認を対象とし、入力の修正、別の明細操作、追加・変更の成功で解除する。
98
98
 
99
99
  ## 5. 遷移
100
100
 
101
- 本画面の業務上の識別子は `uis-sales-register` とする。周辺画面は未作成のため、画面名と識別子で示す。
101
+ 本画面の識別子は `uis-sales-register` とする。
102
102
 
103
- | 遷移名 | 契機(操作) | 遷移元 | 遷移先 | 条件 | 引き渡し情報・入力の扱い |
104
- | ---------------- | -------------------------------------------- | -------------------------------- | ------------------------------------------ | ------------------------------------ | ---------------------------------------------------------------------- |
105
- | 新規取引開始 | 「新規販売」 | `店舗待機画面(uis-store-home)` | 販売登録画面 | 販売登録権限があり、未完了取引がない | 新規取引番号、担当者識別子。空の明細と未入力の預かり金で開始 |
106
- | 商品検索表示 | 「商品検索」 | 販売登録画面 | `商品検索ダイアログ(uis-product-search)` | 登録中 | なし。販売登録の明細・入力は保持 |
107
- | 商品選択反映 | 検索で「選択」 | `商品検索ダイアログ` | 販売登録画面 | 商品を 1 件選択済み | 選択商品コード。追加に失敗した場合も元の明細と入力を保持してエラー表示 |
108
- | 商品検索取消 | 検索で「戻る」 | `商品検索ダイアログ` | 販売登録画面 | 選択せず戻る | なし。保持した明細・入力へ復帰 |
109
- | 中止確認表示 | 「取引中止」 | 販売登録画面 | 中止確認ダイアログ | 登録中 | 現在の取引番号。入力は保持 |
110
- | 中止確定 | 確認で「中止する」 | 中止確認ダイアログ | `店舗待機画面` | 中止への同意 | 中止した取引番号。販売・在庫は更新せず、入力を破棄 |
111
- | 中止確認から復帰 | 確認で「戻る」 | 中止確認ダイアログ | 販売登録画面 | 中止せず戻る | なし。保持した明細・入力へ復帰 |
112
- | 会計完了 | 会計確定成功、または結果確認で確定済みを確認 | 販売登録画面 | `販売完了画面(uis-sales-complete)` | 同じ取引の販売・在庫更新が確定済み | 取引番号、確定明細、合計請求金額、預かり金額、釣銭。以後は編集不可 |
113
- | 再認証へ | 「再ログイン」 | 販売登録画面 | `ログイン画面(uis-login)` | 認証失効または権限不足 | 復帰先と取引番号。入力と直前の取引状態を保持 |
114
- | 再認証から復帰 | ログイン成功 | `ログイン画面` | 販売登録画面 | 同じ担当者に販売登録権限がある | 保持した取引へ復帰。会計結果が不明なら結果確認待ちで復帰 |
103
+ | 遷移名 | 契機 | 遷移元 | 遷移先 | 条件 | 引き渡し情報・入力の扱い |
104
+ | ---------------- | -------------------------------------------- | -------------------------------- | ------------------------------------------ | ------------------------------------ | ------------------------------------------------------------------ |
105
+ | 新規取引開始 | 「新規販売」 | `店舗待機画面(uis-store-home)` | 販売登録画面 | 販売登録権限があり、未完了取引がない | 新規取引番号と担当者。空の明細と未入力の預かり金で開始 |
106
+ | 商品検索表示 | 「商品検索」 | 販売登録画面 | `商品検索ダイアログ(uis-product-search)` | 登録中 | なし。明細・入力を保持 |
107
+ | 商品選択反映 | 検索で「選択」 | `商品検索ダイアログ` | 販売登録画面 | 商品を 1 件選択済み | 選択した商品コード |
108
+ | 商品検索取消 | 検索で「戻る」 | `商品検索ダイアログ` | 販売登録画面 | 選択せず戻る | なし。保持した明細・入力へ戻る |
109
+ | 中止確認表示 | 「取引中止」 | 販売登録画面 | 中止確認ダイアログ | 登録中 | 取引番号。入力を保持 |
110
+ | 中止確定 | 確認で「中止する」 | 中止確認ダイアログ | `店舗待機画面` | 中止への同意 | 中止した取引番号。販売・在庫は更新せず、入力を破棄 |
111
+ | 中止確認から復帰 | 確認で「戻る」 | 中止確認ダイアログ | 販売登録画面 | 中止せず戻る | なし。保持した明細・入力へ戻る |
112
+ | 会計完了 | 会計確定成功、または結果確認で確定済みを確認 | 販売登録画面 | `販売完了画面(uis-sales-complete)` | 同じ取引の販売・在庫更新が確定済み | 取引番号、確定明細、合計請求金額、預かり金額、釣銭。以後は編集不可 |
113
+ | 再認証へ | 「再ログイン」 | 販売登録画面 | `ログイン画面(uis-login)` | 認証失効または権限不足 | 復帰先と取引番号。入力と取引状態を保持 |
114
+ | 再認証から復帰 | ログイン成功 | `ログイン画面` | 販売登録画面 | 同じ担当者に販売登録権限がある | 保持した取引へ戻る。会計結果が不明なら結果確認待ちで戻る |
115
115
 
116
- 販売完了画面は釣銭の手渡し確認とレシート発行を担う。印刷失敗時の再発行も同画面で扱い、販売登録へ戻して再会計しない。権限が回復しない場合はログイン画面に留まり、店主が担当者の権限を確認する。
116
+ 販売完了画面は釣銭の手渡し確認とレシート発行を担い、印刷失敗時の再発行も同画面で扱う(販売登録へ戻して再会計しない)。権限が回復しない場合はログイン画面に留まる。
117
117
 
118
118
  ## 6. バリデーション
119
119
 
120
- | 対象 | 必須性 | 条件 | 判定時点 | 違反時の扱い・対応エラー |
121
- | ---------------------- | ---------------- | ------------------------------------------------------------------------------- | -------------------------------------- | ------------------------------------------------------------------------------------------ |
122
- | 商品コード | 商品追加時に必須 | 半角数字 8 桁。先頭の 0 を保持し、前後空白や記号を許容しない | 商品追加時、スキャン確定時 | 入力値を保持し、明細は変更しない。「商品コード形式不正」 |
123
- | 商品の存在・販売可否 | 商品追加時に必須 | 商品台帳に存在し、販売中である | 商品追加時と会計確定時 | 未登録は「商品コード未登録」。販売停止は「販売対象外」。確定時の失敗は販売・在庫とも未更新 |
124
- | 数量 | 各明細で必須 | 半角数字による 1〜999 の整数。空欄・符号・小数・文字を許容しない | 商品追加時、数量変更時、会計確定時 | 前の有効数量を保持し、修正入力を残す。「数量形式・範囲不正」 |
125
- | 在庫との相関 | 各明細で必須 | 同一商品をまとめた数量が最新の現在庫数以下 | 商品追加時、数量変更時、会計確定時 | 「在庫不足」。入力と明細を保持し、確定時の失敗でも在庫引落なし |
126
- | 販売価格 | 確定時に必須 | 追加時の税込単価と最新の単価が一致 | 会計確定時 | 確定せず、最新単価・集計・釣銭へ更新。「販売価格変更」で再確認を求める |
127
- | 明細の有無 | 確定時に必須 | 明細 1 件以上 | 会計確定前 | 0 件では「会計確定」を無効化 |
128
- | 預かり金額の形式・範囲 | 確定時に必須 | 半角数字による 0〜999999 の整数、円単位。空欄・符号・小数・桁区切りを許容しない | 入力変更時と会計確定前 | 空欄・形式不正時は「会計確定」を無効化。「預かり金形式・範囲不正」を表示 |
129
- | 預かり金額との相関 | 確定時に必須 | 預かり金額が合計請求金額以上 | 預かり金入力時、明細更新時、会計確定時 | 不足額を表示。確定操作でも拒否して「預かり金額不足」。釣銭は未計算 |
120
+ 違反時の状態の扱いは「エラー表示と利用者の次の手」の対応エラーの行に従う。
121
+
122
+ | 対象 | 必須性 | 条件 | 判定時点 | 対応エラー |
123
+ | ---------------------- | ---------------- | ----------------------------------------------------------------------------- | -------------------------------------- | ---------------------------------------------------------------- |
124
+ | 商品コード | 商品追加時に必須 | 半角数字 8 桁。先頭の 0 を保持し、前後空白や記号を許さない | 商品追加時、スキャン確定時 | 商品コード形式不正 |
125
+ | 商品の存在・販売可否 | 商品追加時に必須 | 商品台帳にあり、販売中である | 商品追加時と会計確定時 | 商品コード未登録、販売対象外 |
126
+ | 数量 | 各明細で必須 | 半角数字による 1〜999 の整数。空欄・符号・小数・文字を許さない | 商品追加時、数量変更時、会計確定時 | 数量形式・範囲不正 |
127
+ | 在庫との相関 | 各明細で必須 | 同一商品をまとめた数量が最新の現在庫数以下 | 商品追加時、数量変更時、会計確定時 | 在庫不足 |
128
+ | 販売価格 | 確定時に必須 | 追加時の税込単価と最新の単価が一致 | 会計確定時 | 販売価格変更 |
129
+ | 明細の有無 | 確定時に必須 | 明細 1 件以上 | 会計確定前 | なし。0 件では「会計確定」を無効化 |
130
+ | 預かり金額の形式・範囲 | 確定時に必須 | 半角数字による 0〜999999 の整数、円単位。空欄・符号・小数・桁区切りを許さない | 入力変更時と会計確定前 | 預かり金形式・範囲不正。空欄・形式不正の間は「会計確定」を無効化 |
131
+ | 預かり金額との相関 | 確定時に必須 | 預かり金額が合計請求金額以上 | 預かり金入力時、明細更新時、会計確定時 | 預かり金額不足 |
130
132
 
131
- 会計確定時の条件違反では販売記録を確定しない。数量の境界は 1・999 を許容し、0・1000・1.5 を拒否する。在庫数 3 の商品は数量 3 を許容し、4 を拒否する。金額相関の境界は「表示値の確認例」に従う。
133
+ 会計確定時の違反では販売記録も在庫引落も確定しない。数量は 1・999 を許し、0・1000・1.5 を拒否する。在庫数 3 の商品は数量 3 を許し、4 を拒否する。金額の境界は「表示値の確認例」に従う。
132
134
 
133
135
  ## 7. エラー表示と利用者の次の手
134
136
 
135
- | エラー事象 | 発生条件 | 表示要点 | 状態の扱い | 利用者の次の手(回復アクション) |
136
- | ---------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------------------ | -------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
137
- | 商品コード形式不正 | 商品追加時に空欄または 8 桁数字以外 | 「商品コードを 8 桁の数字で入力してください」 | 入力を保持。明細・集計は変更しない | コードを修正して「商品追加」。コードが不明なら「商品検索」 |
138
- | 商品コード未登録 | 入力コードが商品台帳にない | 「商品コードが登録されていません」と入力コード | 入力を保持。明細は追加しない | 入力を確認するか、「商品検索」で登録済みの商品を選択 |
139
- | 販売対象外 | 追加時または確定時に販売停止を検出 | 「現在販売できない商品です」と商品名 | 確定せず登録中を保持 | 未追加なら別の商品を選択。明細内の商品なら「明細削除」で除いて再確認 |
140
- | 数量形式・範囲不正 | 数量が空欄、整数以外、1〜999 の範囲外 | 「数量は 1〜999 の整数で入力してください」と対象商品 | 前の有効明細と集計を保持し、修正入力を残す | 対象数量を修正。購入しない場合は「明細削除」 |
141
- | 在庫不足(初回追加) | 未追加の商品を追加しようとしたが現在庫数が 0 | 「在庫が不足しています」と商品名、現在庫数 0 | 販売・在庫は未更新。対象行は作らず、入力・既存明細を保持 | 商品コードを空にして追加を取りやめるか、別のコードを入力・商品検索して販売可能な商品を追加する |
142
- | 在庫不足(既存明細) | 同一商品の再追加・数量変更・会計確定時に数量が現在庫数を超過 | 「在庫が不足しています」と商品名、現在庫数 | 販売・在庫は未更新。入力と直前の有効明細・集計を保持 | 現在庫数が 1 以上なら数量をその数以下へ修正。0 または購入を取りやめる場合は対象行を「明細削除」して再確認 |
143
- | 預かり金形式・範囲不正 | 入力が半角数字による 0〜999999 の整数でない | 「預かり金額を 0〜999999 円の整数で入力してください」 | 入力を保持。釣銭は未計算 | 受領額を確認し、桁区切り等を除いて預かり金額を修正 |
144
- | 預かり金額不足 | 預かり金額が合計請求金額未満 | 「預かり金が不足しています」と不足額 | 登録中を保持。釣銭は未計算 | 不足分を受領して預かり金額を修正し、再度「会計確定」 |
145
- | 販売価格変更 | 確定時に単価の変更を検出 | 「価格が変わりました。金額を確認してください」と変更商品、旧単価・新単価 | 販売・在庫は未更新。最新価格で再計算し、預かり金は保持 | 新しい請求額を来店客へ伝え、預かり金を確認・修正して再度「会計確定」 |
146
- | 商品取得・在庫確認の通信失敗 | 登録中の取得要求で接続切断または 30 秒の応答待ち超過 | 「商品情報を取得できません」と「読み直し」 | 入力と有効な明細を保持。追加・変更は未反映 | 接続を確認して「読み直し」。編集を続ける場合は入力を修正して元の操作を実行すると、失敗した要求を置き換える |
147
- | 会計確定失敗 | 店舗サービスから、会計が未確定であるとの失敗応答 | 「会計を確定できませんでした」と取引番号 | 登録中へ戻る。販売・在庫は未更新、入力を保持 | 接続の復旧後、明細と預かり金を確認して「会計確定」。再発時は店主へ取引番号を連絡 |
148
- | 会計結果不明 | 会計要求後の接続切断または 30 秒の応答待ち超過 | 「会計結果を確認してください」と取引番号、「結果確認」 | 結果確認待ちへ移り、編集・中止・確定を無効化 | 接続の復旧後に「結果確認」。未確定が確認できた場合のみ登録を再開 |
149
- | 会計結果の照会未完了 | 結果確認で処理継続中、または照会に失敗 | 「会計結果をまだ確認できません」と取引番号 | 結果確認待ちを保持 | 接続と処理状況を確認して再度「結果確認」。復旧しない場合は店主へ取引番号を連絡 |
150
- | 認証失効 | 登録中または結果確認時に認証失効を検出 | 「再ログインしてください」 | 入力と直前の状態を保持。会計要求後に検出した場合は結果確認待ち | 「再ログイン」で同じ担当者が認証。復帰後、結果確認待ちなら「結果確認」 |
151
- | 権限不足 | 画面への進入時または操作時に販売登録権限がない | 「販売登録の権限がありません」 | 進入を拒否。操作中なら入力を保持して変更を停止。会計要求後なら結果確認待ち | 「再ログイン」へ進み、店主に担当者の権限確認を依頼。権限確認後に同じ取引へ復帰 |
137
+ | エラー事象 | 発生条件 | 表示要点 | 状態の扱い | 利用者の次の手 |
138
+ | ---------------------------- | ---------------------------------------------------- | ------------------------------------------------------------------------ | ---------------------------------------------------------------------- | ------------------------------------------------------------------- |
139
+ | 商品コード形式不正 | 「バリデーション」の商品コード | 「商品コードを 8 桁の数字で入力してください」 | 入力を保持。明細・集計は変えない | コードを直して「商品追加」するか、「商品検索」 |
140
+ | 商品コード未登録 | 入力コードが商品台帳にない | 「商品コードが登録されていません」と入力コード | 入力を保持。明細は追加しない | 入力を確かめるか「商品検索」で選ぶ |
141
+ | 販売対象外 | 追加時または確定時に販売停止を検出 | 「現在販売できない商品です」と商品名 | 確定せず登録中を保持 | 別の商品を選ぶか、明細内なら「明細削除」 |
142
+ | 数量形式・範囲不正 | 「バリデーション」の数量 | 「数量は 1〜999 の整数で入力してください」と対象商品 | 前の有効明細と集計を保持し、修正入力を残す | 数量を直すか、購入しないなら「明細削除」 |
143
+ | 在庫不足(初回追加) | 未追加の商品の現在庫数が 0 | 「在庫が不足しています」と商品名、現在庫数 0 | 行は作らず、入力・既存明細を保持 | 追加を取りやめるか、別の商品を追加する |
144
+ | 在庫不足(既存明細) | 再追加・数量変更・会計確定時に数量が現在庫数を超える | 「在庫が不足しています」と商品名、現在庫数 | 入力と直前の有効明細・集計を保持 | 数量を現在庫数以下へ直す。現在庫数 0 か購入をやめるなら「明細削除」 |
145
+ | 預かり金形式・範囲不正 | 「バリデーション」の預かり金額の形式・範囲 | 「預かり金額を 0〜999999 円の整数で入力してください」 | 入力を保持。釣銭は未計算 | 桁区切りなどを除いて預かり金額を直す |
146
+ | 預かり金額不足 | 預かり金額が合計請求金額未満 | 「預かり金が不足しています」と不足額 | 登録中を保持。釣銭は未計算 | 不足分を受け取り、預かり金額を直して「会計確定」 |
147
+ | 販売価格変更 | 確定時に単価の変更を検出 | 「価格が変わりました。金額を確認してください」と変更商品、旧単価・新単価 | 最新価格で計算し直し、預かり金は保持 | 新しい請求額を伝えて「会計確定」 |
148
+ | 商品取得・在庫確認の通信失敗 | 登録中の取得要求で接続切断または 30 秒の応答待ち超過 | 「商品情報を取得できません」と「読み直し」 | 入力と有効な明細を保持。追加・変更は未反映 | 接続を確かめて「読み直し」 |
149
+ | 会計確定失敗 | 店舗サービスから、会計が未確定であるとの失敗応答 | 「会計を確定できませんでした」と取引番号 | 登録中へ戻る。販売・在庫は未更新、入力を保持 | 接続の復旧後に再度「会計確定」。再発時は店主へ取引番号を伝える |
150
+ | 会計結果不明 | 会計要求後の接続切断または 30 秒の応答待ち超過 | 「会計結果を確認してください」と取引番号、「結果確認」 | 結果確認待ちへ移る | 接続の復旧後に「結果確認」。未確定と確認できた場合だけ登録を再開 |
151
+ | 会計結果の照会未完了 | 結果確認で処理継続中、または照会に失敗 | 「会計結果をまだ確認できません」と取引番号 | 結果確認待ちを保持 | 再度「結果確認」。復旧しない場合は店主へ取引番号を伝える |
152
+ | 認証失効 | 登録中または結果確認時に認証失効を検出 | 「再ログインしてください」 | 入力と状態を保持。会計要求後なら結果確認待ち | 「再ログイン」で再認証し、結果確認待ちなら「結果確認」 |
153
+ | 権限不足 | 画面への進入時または操作時に販売登録権限がない | 「販売登録の権限がありません」 | 進入を拒否。操作中は入力を保持して変更を止め、会計要求後は結果確認待ち | 「再ログイン」へ進み、店主に担当者の権限確認を頼む |
152
154
 
153
155
  ## 8. メモ / 将来課題
154
156
 
155
- ### 8.1. 本仕様内の未確認事項
156
-
157
- 次表は架空の販売管理プロジェクトでの確認事項である。本 sample では例示の前提として扱い、実プロジェクトへ採用する際は確認結果に基づいて仕様を確定する。業務上の最終判断は人間の PO(店主代表)が担う。
158
-
159
- | 未確認事項 | 影響範囲・次の確認 | 確認担当(Role code) | 確認・判断時点 | 報告先 |
160
- | -------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- | ------------------------------------------------ | ---------------------------------------------------------------------------------------------------- |
161
- | _ASSUMPTION_: 店舗サービスへの接続を前提に販売を行い、復旧しない場合は店主が紙の記録による継続を判断する | 商品取得・会計確定・結果確認に影響。開発担当が接続断と復旧後の同一取引の照会を確認し、店主代表が結果不明取引を重複記録しない引継ぎ手順と紙での継続可否を確認する | DEV(技術確認)、PO(業務確認・判断) | 採用先の画面仕様承認前。未確認なら承認を保留する | DEV から PO へ結果と残る制約を報告。PO から PM(未配置なら PO が兼務)へ採用可否と運用への影響を報告 |
162
-
163
- ### 8.2. 採用プロジェクトの管理記録へ引き継ぐ事項
164
-
165
- 次表は本仕様の現行動作とは分けて管理する、採用先のプロジェクト登録簿(PJR)への転記候補である。PM(未配置なら PO が兼務)が起票要否と優先順位を判断する。本 sample は実際の起票・採否決定を示すものではない。
166
-
167
- | 転記候補 | 対応方針・仕様への影響 | 確認担当(Role code) | 判断時点 | 報告先 |
168
- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------ | --------------------- | ---------------------------------------------- | -------------------------------------- |
169
- | 接続前提と障害時運用の受入確認 | 「本仕様内の未確認事項」の確認作業と結果をリスク・対応記録へ引き継ぎ、画面仕様の承認条件として追跡する | PM | 採用計画を作るとき。仕様承認前に結果を確認する | PO |
170
- | 電子マネー・QR 決済への拡張 | 初期の現金販売には含めない。店主代表が決済方法と取消手順を確認し、預かり金・会計確定・結果確認の変更範囲を整理する | BA、PO | 決済方法の追加を検討するとき | PM へ変更要求候補、PO へ採否判断を報告 |
171
- | 入力欄の選択を要しない連続スキャン | 初期の入力方式には含めない。店員と開発担当が誤読・重複追加時の修正手順を確認する | BA、DEV | 連続スキャンの導入を検討するとき | PM へ改善候補、PO へ採否判断を報告 |
172
-
173
- ### 8.3. 同梱 sample の承認と公開前確認
174
-
175
- 公開対象は、架空の画面仕様の完成例としての本文・表示値・課題表であり、SpecDojo の同梱文書として一般の利用者へ公開する範囲とする。実顧客・実取引の情報、担当者の個人情報、認証情報、店舗固有の非公開情報を含めない。同梱 sample の `ready` 化と公開可否の最終承認・説明責任は、SpecDojo 側の人間の PO が担う。agent による編集・検査だけでは承認済みとしない。
176
-
177
- `draft` から `ready` へ進める前に、次の条件を確認する。
178
-
179
- - QE が rulebook の必須項目と、表示値・操作・遷移・入力境界・回復操作の整合を確認する。在庫 0 の初回追加では行が作られず、既存明細だけが削除対象になることを含める。
180
- - QE が Markdown・Frontmatter の検査と、uis-rulebook・uis-sample の最新内容に対する grade の pass を確認する。残る指摘があれば対応内容または未対応理由を PO に報告する。
181
- - PO が未確認事項の担当・判断時点・報告先と PJR 転記候補を確認する。架空の運用仮定は採用時の確認事項として残せるが、同梱公開を妨げる未解決指摘は解消し、解消できなければ保留理由を記録して `draft` を維持する。
182
- - PO が公開対象に非公開情報を含まないことを確認し、承認対象の版と承認理由をプロジェクトの管理記録へ残してから、人が `status` を変更する。
157
+ - _ASSUMPTION_: 店舗サービスとの接続が営業中に復旧しない場合は、店主が取引番号と状況を控えて開発担当へ連絡し、紙の販売記録で続けるかを判断する。採用前に、復旧後に同じ取引を照会できることと、結果不明の取引を紙と二重に記録しないことを確かめる。
158
+ - 電子マネー・QR 決済は初期の現金販売に含めない。導入時は決済方法と取消手順を決め、預かり金・会計確定・結果確認への影響を整理する。
159
+ - 入力欄の選択を要しない連続スキャンは初期の入力方式に含めない。導入時は誤読・重複追加時の修正手順を決める。
@@ -20,22 +20,23 @@ Job Definition Standard
20
20
 
21
21
  ## 2. 基本方針
22
22
 
23
- - 決定論的な手順(分岐条件が事前に確定し、実行結果が入力から一意に決まる手順)は script または CLI へ実装し、`mode: command` の `task.command` からその入口を呼ぶ。
23
+ - 決定論的な手順は script または CLI へ実装し、`mode: command` の `task.command` から入口を呼ぶ。複数の入口を順に実行する場合は `task.steps` を使う。
24
24
  - `task.command` は materialize 時に入力を展開して Run へ凍結し、runner が agent の sandbox 外で直接実行する。
25
25
  - 対象選択を伴う command Job は任意の `task.precondition` で選択を先に評価できる。skip 条件を満たした場合は Job Run と付随成果物を作らない。
26
26
  - command Job が同じプロジェクトの `specdojo exec` を子プロセスとして呼ぶ場合、runner が保持する project 実行 lock の token を子へ継承する。子は owner token の一致を検証した場合だけ再取得を省略し、Job 全体の排他範囲を維持する。
27
27
  - 判断(観測した結果の解釈、失敗の切り分け、次の行動の提案)が必要な command Job だけ、`task.analysis` で reporter agent と判断内容を指定する。
28
28
  - `edit` / `review` Job は従来どおり agent に作業を委譲し、`task.description` に判断内容を書く。
29
29
  - 委譲先の agent は nickname で指名する。`capabilities` / `proficiency` による間接指定は、指名が不要な場合に限る。
30
+ - `task.proficiency` は `low` / `normal` / `high` / `expert` / `frontier` を受け付ける。最上位の `frontier` は、`task.agent` で指名するか `task.proficiency: frontier` を明示した場合だけ候補にする。provider の起動設定は [[specdojo:exec-config-guide|exec 設定ガイド]] に従う。
30
31
  - 同じ論理実行に対して同じ Run を作れるよう、Job が使う値は `inputs`、`job_id`、`scheduled_at`、前回成功 checkpoint に限定する。Run ID 確定後の task と checkpoint では `job_run_id` も参照できる。
31
32
 
32
33
  ### 2.1. 判断と手順の切り分け基準
33
34
 
34
- 次の表で「手順」に該当する記述は `task.description` へ書かず、script または CLI へ移す。
35
+ 次の表で「手順」に該当する記述は `task.description` へ書かず、`task.steps` または script / CLI へ移す。
35
36
 
36
37
  | 区分 | 判定基準 | 記述場所 | 例 |
37
38
  | ---- | ---------------------------------------------------------- | ----------------------------------------------------- | ------------------------------------------------ |
38
- | 手順 | 実行前に条件と順序が確定し、結果が入力から一意に決まる | script / CLI と `task.command` | 対象文書の列挙、段の順序制御、1件ごとの CLI 実行 |
39
+ | 手順 | 実行前に条件と順序が確定し、結果が入力から一意に決まる | `task.steps` または script / CLI と `task.command` | 対象文書の列挙、段の順序制御、1件ごとの CLI 実行 |
39
40
  | 手順 | 同じ操作を対象ごとに繰り返す | script / CLI と `task.command` | 全件ループ、対象0件時の分岐 |
40
41
  | 判断 | 観測した結果を解釈し、複数の説明のどれが妥当かを選ぶ | `task.analysis.description` または `task.description` | 失敗が rate limit か agent の失敗かの切り分け |
41
42
  | 判断 | 事実から次の行動(再開・見直し・エスカレーション)を決める | `task.analysis.description` または `task.description` | 閾値の見直し要否、再開可否の判断 |
@@ -77,7 +78,7 @@ Job Definition Standard
77
78
  ### 3.4. 責務境界と粒度
78
79
 
79
80
  - 1つの Job は1つの委譲単位に対応させる。同じ処理を条件違いで繰り返すために Job を分割してはならない。条件差は `inputs` で表す。
80
- - 実行順序を Job の分割で表現してはならない。順序は script または CLI が持ち、routine の `action` 配列は独立した委譲単位の並びにだけ使う。
81
+ - 実行順序を Job の分割で表現してはならない。順序は `task.steps` または script / CLI が持ち、routine の `action` 配列は独立した委譲単位の並びにだけ使う。
81
82
  - Job は起動時刻を持たない。時刻条件は routine または外部スケジューラが持つ。
82
83
  - Job は agent 実行エンジンを持たない。plan 生成、agent 選択、result、worktree、commit は `exec` 実行基盤へ委ねる。
83
84
 
@@ -101,6 +102,20 @@ Job Definition Standard
101
102
  - `job_run_id` は `idempotency_key` から導出されるため、`run.idempotency_key` では参照できない。
102
103
  - 同じ `scheduled_at` を明示した手動・routine 起動は同じ実行枠として重複排除する。`scheduled_at` を省略した手動起動は起動ごとに新しい実行枠とする。
103
104
 
105
+ ### 3.7. command Job の順次実行
106
+
107
+ `task.command` の代わりに非空の `task.steps` を指定すると、runner は各段のプロセス終了を待ってから次を実行する。両方の併記、agent mode での使用、`task.partial_exit_code` との併用は認めない。各段の `id` は Job 内で一意な小文字 slug、`command` は非空とし、入力 template を materialize 時に解決して Run へ凍結する。
108
+
109
+ - 各段の `on_failure` は自身の失敗・延期後の `stop`(既定)または `continue`。続行しても既に発生した失敗を成功へ読み替えない。
110
+ - 段は終了コード 0 で成功、75 で延期、それ以外(signal・起動不能を含む)で失敗とする。未実行の後続段も理由付きの `deferred` として `attempts[].steps` に保存する。全段が成功した場合だけ Run は `succeeded`、失敗・延期があれば `failed`。CLI は失敗を含めば 1、延期だけなら 75 を返す。
111
+ - 終了コードだけでは完了を表せないコマンドには `completion` を必ず指定する。`path` は repository 内の相対パス(JSON、YAML、Markdown frontmatter)、`field` はドット区切りのキー、`succeeded` は成功状態の非空リスト、任意の `deferred` は延期状態のリスト。終了コード 0 に加え、そのフィールドが成功状態に一致する場合だけ成功とする。ファイル欠落・不正、キー欠落、未指定の状態は失敗とする。CLI が最新状態を生成する必要があれば、同じ段の command の最後で refresh する。ログの文言から完了を判定しない。
112
+ - sequence は project 実行 lock を排他的に取得するまで待つ。`task.lock_wait_seconds` は待機上限の秒数(非負整数、既定 3600、0 は即時判定)。この Job の外側の `--if-busy` より定義を優先する。上限超過では precondition・段・analysis を実行せず、全段を延期として記録する。
113
+ - lock は全段の終了まで保持し、同一 project の子 exec は検証済み token を継承する。先行プロセスのログや `pgrep` は監視しない。同じ論理 Run の同時起動は別の guard で拒否し、待機中の記録を上書きしない。
114
+ - 各段の任意の `timeout_seconds`(1〜2147483 の整数)は lock 待機を含む command 全体の上限。超過は延期とし、POSIX では command のプロセス群を停止してから後続へ進む。grade 独自の lock を待つ場合は `grade run --if-busy wait` と併用する。
115
+ - 各段の状態を直ちに保存し、実行済み段には終了コード・時刻・command evidence 参照を残す。同じ実行枠の retry は新しい attempt として全段を先頭から実行する。段のコマンドには冪等な操作、既存の resume、grade の再開機能を使う。
116
+
117
+ 例と routine / cron の接続は [[specdojo:job-sequence-guide|順次実行 Job の例]] を参照する。
118
+
104
119
  ## 4. 値制約・判定基準
105
120
 
106
121
  | 項目 | 必須 | 判定基準 |
@@ -108,7 +123,8 @@ Job Definition Standard
108
123
  | `id` | ○ | `job-<slug>` 形式で、ファイル名の拡張子を除いた部分と一致する |
109
124
  | `task.mode` | ○ | `edit` / `review` / `command` |
110
125
  | `task.description` | 条件 | `edit` / `review` で必須。決定論的手順の列挙を含まない |
111
- | `task.command` | 条件 | `command` で必須。入力展開後も非空 |
126
+ | `task.command` | 条件 | `command` で `task.steps` といずれか一方が必須。入力展開後も非空 |
127
+ | `task.steps` | 条件 | `command` の順次実行。第3.7節に従う |
112
128
  | `task.partial_exit_code` | 任意 | `command` だけで使用する1〜255の終了コード。明示した値だけを`partial`とする |
113
129
  | `task.precondition` | 任意 | `command` と `empty-output` または 0〜255 の終了コードを指定 |
114
130
  | `task.analysis` | 任意 | command 結果の判断が必要な場合だけ agent と description を指定 |
@@ -123,7 +139,7 @@ Job Definition Standard
123
139
 
124
140
  ## 5. 記述例
125
141
 
126
- 次の grade Job は SpecDojo 本体リポジトリを保守するための例です。`tools/grade/run-per-document.sh` は本体リポジトリの開発用で npm package には含まれません。v0.3.0 の公開物における grade は試験的で、利用者は `grade list` / `plan` / `apply` / `validate` / `result` などの部品を組み合わせます。成果物の grade には project の `catalog_path` が必要です。
142
+ 次の grade Job は `grade run` で変更済みの Kata を評価する例です。成果物の grade には project の `catalog_path` が必要です。
127
143
 
128
144
  ```yaml
129
145
  task:
@@ -133,12 +149,11 @@ task:
133
149
  command: "{{specdojo}} grade list --target kata --changed-only --project {{project_id}}"
134
150
  skip_when: empty-output
135
151
  command: |
136
- tools/grade/run-per-document.sh --run-id {{job_run_id}}
137
- cat logs/grade/runs/per-document/{{job_run_id}}/results.tsv
152
+ {{specdojo}} grade run --run-id {{job_run_id}} --target kata --changed-only --project {{project_id}}
138
153
  analysis:
139
154
  agent: claude-reporter
140
155
  description: |
141
- command evidence と results.tsv から未完了の段の有無、失敗の切り分け、
156
+ command evidence と grade run の出力から未完了の文書の有無、失敗の切り分け、
142
157
  閾値の見直し要否を判断して報告する。
143
158
  paths:
144
159
  - docs/ja/specdojo/rulebooks
@@ -0,0 +1,58 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:cdr-template
4
+ type: template
5
+ status: draft
6
+ frontmatter_template:
7
+ applyTo: _APPLY_TO_
8
+ specdojo:
9
+ id: _LOCAL_ID_
10
+ type: architecture
11
+ status: draft
12
+ rulebook: specdojo:cdr-rulebook
13
+ based_on: _BASED_ON_
14
+ ---
15
+
16
+ # _DELIVERABLE_NAME_
17
+
18
+ _DELIVERABLE_OVERVIEW_
19
+
20
+ ## 1. 基本方針
21
+
22
+ - _TODO_
23
+
24
+ ## 2. モジュールと import
25
+
26
+ - モジュール方式・import の書き方: _TODO_
27
+ - 依存の向きの制約と検査する仕組み: _TODO_
28
+
29
+ ## 3. 型
30
+
31
+ <!-- 動的型の言語では型ヒントの方針に置き換えるか、章を削除して導入文に理由を書く。 -->
32
+
33
+ - 型の宣言: _TODO_
34
+ - 不明な外部入力の扱い: _TODO_
35
+ - 型の強制の制限: _TODO_
36
+
37
+ ## 4. エラー処理
38
+
39
+ - 例外と戻り値の使い分け: _TODO_
40
+ - エラーメッセージに含める文脈: _TODO_
41
+ - 例外の握りつぶしの禁止: _TODO_
42
+
43
+ ## 5. 命名
44
+
45
+ - 識別子の大文字小文字: _TODO_
46
+ - 略語・真偽値の名前: _TODO_
47
+
48
+ ## 6. テストと検証
49
+
50
+ | コマンド | 対象 | 実行条件 | 失敗時 |
51
+ | --------- | ------ | -------- | ------ |
52
+ | _COMMAND_ | _TODO_ | _TODO_ | _TODO_ |
53
+
54
+ ## 7. 禁止事項
55
+
56
+ | 禁止事項 | 理由 |
57
+ | -------- | ------ |
58
+ | _TODO_ | _TODO_ |
@@ -94,13 +94,14 @@ $defs:
94
94
 
95
95
  Proficiency:
96
96
  type: string
97
- enum: ["low", "normal", "high", "expert"]
97
+ enum: ["low", "normal", "high", "expert", "frontier"]
98
98
  description: >
99
99
  Agent proficiency level used for task assignment and brief generation.
100
100
  low: lightweight tasks such as formatting or template filling.
101
101
  normal: standard document creation and editing.
102
102
  high: complex analysis or cross-domain work.
103
103
  expert: deep technical judgment or architectural decisions.
104
+ frontier: highest tier above expert; selected only by name or an explicit frontier request.
104
105
 
105
106
  Capability:
106
107
  type: string
@@ -160,6 +160,31 @@ $defs:
160
160
  one of them, and records `not_applicable` otherwise. Without `paths`, or when
161
161
  the change set is unknown or truncated, or when the integration targets were
162
162
  merged into the worktree, the validation always runs.
163
+ post_integration:
164
+ type: array
165
+ uniqueItems: true
166
+ description: >
167
+ Fixed actions run in the integration target checkout after its merge commit, while
168
+ retaining the exec/lifecycle lock. Failure is recorded without undoing integration.
169
+ Each ID may appear only once; arbitrary commands, arguments and repositories are rejected.
170
+ items:
171
+ type: object
172
+ additionalProperties: false
173
+ required: [id, paths]
174
+ properties:
175
+ id:
176
+ type: string
177
+ enum: [build-dist]
178
+ description: Runs npm run build with fixed argv (no shell).
179
+ paths:
180
+ type: array
181
+ minItems: 1
182
+ items:
183
+ type: string
184
+ pattern: "\\S"
185
+ description: >
186
+ Repository-relative globs (`**`, `*`, `?`, `{a,b}`) selecting the action from
187
+ the actual integration commit diff, including deletions and both rename paths.
163
188
  commit_hook_skips:
164
189
  type: array
165
190
  description: >
@@ -300,9 +325,16 @@ $defs:
300
325
  by_proficiency:
301
326
  type: object
302
327
  minProperties: 1
303
- description: "Variables selected by the member's proficiency."
328
+ description: >
329
+ Variables selected by the member's proficiency. Frontier members require an explicit
330
+ frontier entry before launch; use an empty mapping when no extra variables are needed.
304
331
  propertyNames:
305
- enum: ["low", "normal", "high", "expert"]
332
+ $ref: "./exec-common.schema.yaml#/$defs/Proficiency"
333
+ properties:
334
+ frontier:
335
+ anyOf:
336
+ - $ref: "#/$defs/CommandVariableSet"
337
+ - const: {}
306
338
  additionalProperties:
307
339
  $ref: "#/$defs/CommandVariableSet"
308
340
  by_nickname:
@@ -413,17 +445,22 @@ $defs:
413
445
  additionalProperties: false
414
446
  required:
415
447
  - action
416
- description: "Behavior for non-critical tasks (cpm.slack > 0)."
448
+ description: >
449
+ Compatibility-only field, still required by this schema. Ignored at runtime:
450
+ automatic agent selection uses on_critical.retry for all tasks, regardless of
451
+ critical-path membership. Keep action: skip in existing configurations.
417
452
  properties:
418
453
  action:
419
454
  const: "skip"
420
- description: "Record a block event and move to the next task."
455
+ description: "Compatibility value only; does not skip tasks at runtime."
421
456
  on_critical:
422
457
  type: object
423
458
  additionalProperties: false
424
459
  required:
425
460
  - action
426
- description: "Behavior for critical-path tasks (cpm.slack == 0)."
461
+ description: >
462
+ Retry policy used by automatic agent selection for all tasks, regardless of
463
+ critical-path membership. The on_critical name is retained for compatibility.
427
464
  properties:
428
465
  action:
429
466
  type: string