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
@@ -86,6 +86,9 @@ properties:
86
86
  - $ref: "./register-item-frontmatter.schema.yaml#/$defs/Date"
87
87
  - type: "null"
88
88
  description: "登録項目の対応期限または判断期限。未定は省略し、期限なしは null。"
89
+ start_on:
90
+ $ref: "./register-item-frontmatter.schema.yaml#/$defs/Date"
91
+ description: "epic の予定開始日。未定は省略する。type 制約は登録項目 schema が検証する。"
89
92
  completed_at:
90
93
  $ref: "./register-item-frontmatter.schema.yaml#/$defs/Timestamp"
91
94
  description: "登録項目を完了・決定・却下した日時(UTC の RFC 3339・秒精度)。"
@@ -1,142 +1,8 @@
1
1
  $schema: "https://json-schema.org/draft/2020-12/schema"
2
- title: External System Interface List Schema
3
- type: object
4
- additionalProperties: false
5
-
6
- required:
7
- - id
8
- - type
9
- - title
10
- - status
11
- - rulebook
12
- - interfaces
13
-
14
- $defs:
15
- idRef:
16
- type: string
17
- pattern: "^[a-z0-9][a-z0-9-]*$"
18
- description: "英小文字・数字・ハイフンのみ。先頭は英小文字または数字。"
19
- idRefArray:
20
- type: array
21
- items:
22
- $ref: "#/$defs/idRef"
23
- uniqueItems: true
24
- semver:
25
- type: string
26
- # SemVer 2.0.0(prerelease / build metadata も許容)
27
- pattern: "^\\d+\\.\\d+\\.\\d+(?:-[0-9A-Za-z-.]+)?(?:\\+[0-9A-Za-z-.]+)?$"
28
-
29
- properties:
30
- id:
31
- type: string
32
- pattern: "^esil-[a-z0-9-]+$"
33
- description: "一意なID(esil-...)"
34
- type:
35
- type: string
36
- const: "api"
37
- title:
38
- type: string
39
- minLength: 1
40
- status:
41
- type: string
42
- enum: ["draft", "ready", "deprecated"]
43
- rulebook:
44
- type: string
45
- pattern: "^((?:[a-z][a-z0-9-]*:)?[a-z0-9][a-z0-9-]*-rulebook|none)$"
46
- description: "準拠する rulebook の ID。該当がない場合は none。"
47
- version:
48
- $ref: "#/$defs/semver"
49
- owners:
50
- type: array
51
- items:
52
- type: string
53
- pattern: "^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$"
54
- uniqueItems: true
55
-
56
- tags:
57
- type: array
58
- items:
59
- type: string
60
- minLength: 1
61
- uniqueItems: true
62
-
63
- part_of:
64
- $ref: "#/$defs/idRefArray"
65
- default: []
66
- based_on:
67
- $ref: "#/$defs/idRefArray"
68
- default: []
69
- implements:
70
- $ref: "#/$defs/idRefArray"
71
- default: []
72
- tests:
73
- $ref: "#/$defs/idRefArray"
74
- default: []
75
- supersedes:
76
- $ref: "#/$defs/idRefArray"
77
- default: []
78
-
79
- interfaces:
80
- type: array
81
- default: []
82
- minItems: 1
83
- items:
84
- type: object
85
- additionalProperties: false
86
- required:
87
- - name
88
- - source
89
- - target
90
- - direction
91
- - kind
92
- - format
93
- - timing
94
- properties:
95
- name:
96
- type: string
97
- minLength: 1
98
- description: "連携名"
99
- source:
100
- type: string
101
- minLength: 1
102
- description: "連携元(システム/コンテナ/コンポーネントなど)"
103
- target:
104
- type: string
105
- minLength: 1
106
- description: "連携先(外部システム名など)"
107
- direction:
108
- type: string
109
- enum:
110
- - source_to_target
111
- - target_to_source
112
- - bidirectional
113
- description: "方向(source/targetに基づく)"
114
- kind:
115
- type: string
116
- enum:
117
- - API
118
- - ファイル
119
- - メッセージ
120
- - コマンド
121
- description: "連携の種別"
122
- format:
123
- type: string
124
- enum:
125
- - CSV
126
- - JSON
127
- - XML
128
- - その他
129
- - TBD
130
- description: "データ形式(限定列挙)"
131
- timing:
132
- type: string
133
- minLength: 1
134
- description: "連携タイミング"
135
- error_handling:
136
- type: string
137
- description: "エラー処理・備考"
138
- spec_ref:
139
- type: string
140
- pattern: "^(?:ifx-api|ifx-file|ifx-msg|ifx-cmd)-[a-z0-9-]+$|^TBD$"
141
- description: >-
142
- 詳細仕様ドキュメントの id(ifx-api-/ifx-file-/ifx-msg-/ifx-cmd-...)または TBD
2
+ title: External System Interface List Schema (deprecated alias)
3
+ description: >-
4
+ 非推奨の別名。正本は ifx-index.schema.yaml で、本ファイルはそれを参照するだけ。
5
+ 古い名前を指す modeline を持つ YAML の検証を壊さないために残している。
6
+ YAML 先頭の modeline を ifx-index.schema.yaml へ書き換えたら、本ファイルは不要になる。
7
+ deprecated: true
8
+ $ref: "ifx-index.schema.yaml"
@@ -50,6 +50,7 @@ $defs:
50
50
  [
51
51
  "draft",
52
52
  "fully-guided",
53
+ "condense",
53
54
  "recipe-guided",
54
55
  "freeform",
55
56
  "bootstrap",
@@ -80,6 +81,8 @@ $defs:
80
81
  retrofit reads implementation evidence declared by the catalog and reflects the verified
81
82
  current behavior into an existing or newly created deliverable without treating the
82
83
  implementation as the unconditional source of intended behavior.
84
+ condense edits redundancy within one existing document, preserving meaning and recording
85
+ changes, retained candidates, and causes.
83
86
  cross-deliverable-dedup selects canonical descriptions across an explicitly scoped
84
87
  deliverable group and replaces duplicate detail with summaries and references. The
85
88
  *-maintenance values improve the named reference material based on deliverables
@@ -91,13 +94,14 @@ $defs:
91
94
 
92
95
  Proficiency:
93
96
  type: string
94
- enum: ["low", "normal", "high", "expert"]
97
+ enum: ["low", "normal", "high", "expert", "frontier"]
95
98
  description: >
96
99
  Agent proficiency level used for task assignment and brief generation.
97
100
  low: lightweight tasks such as formatting or template filling.
98
101
  normal: standard document creation and editing.
99
102
  high: complex analysis or cross-domain work.
100
103
  expert: deep technical judgment or architectural decisions.
104
+ frontier: highest tier above expert; selected only by name or an explicit frontier request.
101
105
 
102
106
  Capability:
103
107
  type: string
@@ -137,7 +137,8 @@ $defs:
137
137
  - $ref: "#/$defs/ParentValidationId"
138
138
  - type: object
139
139
  additionalProperties: false
140
- required: [id, repo]
140
+ required: [id]
141
+ minProperties: 2
141
142
  properties:
142
143
  id:
143
144
  $ref: "#/$defs/ParentValidationId"
@@ -145,8 +146,73 @@ $defs:
145
146
  type: string
146
147
  pattern: "^[a-z0-9-]+$"
147
148
  description: >
148
- Repository name: `project` for the project repository, or a product
149
- repository name from `projects.<id>.repos`.
149
+ Repository name: `project` for the project repository (default), or a
150
+ product repository name from `projects.<id>.repos`.
151
+ paths:
152
+ type: array
153
+ minItems: 1
154
+ items:
155
+ type: string
156
+ minLength: 1
157
+ description: >
158
+ Glob patterns relative to the assigned repository (`**`, `*`, `?`, `{a,b}`).
159
+ The runner runs the validation only when a file the executor changed matches
160
+ one of them, and records `not_applicable` otherwise. Without `paths`, or when
161
+ the change set is unknown or truncated, or when the integration targets were
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.
188
+ commit_hook_skips:
189
+ type: array
190
+ description: >
191
+ Git hook commands (lefthook command names) that the runner's integration commit skips
192
+ through `LEFTHOOK_EXCLUDE` when every parent validation in `covered_by` was recorded as
193
+ passed for the run. Manual commits are not affected.
194
+ items:
195
+ type: object
196
+ additionalProperties: false
197
+ required: [hook, covered_by]
198
+ properties:
199
+ hook:
200
+ type: string
201
+ pattern: "^[A-Za-z0-9_.-]+$"
202
+ covered_by:
203
+ type: array
204
+ minItems: 1
205
+ items:
206
+ type: string
207
+ minLength: 1
208
+ description: Labels (`<id>` or `<repo>:<id>`) from `parent_validations`.
209
+ mechanical_result:
210
+ type: boolean
211
+ default: false
212
+ description: >
213
+ When true, the runner writes an edit result from executor evidence without invoking the
214
+ reporter agent if the outcome is complete and the executor supplied `final_message`.
215
+ Review results, blocked outcomes, and rendering failures still use the reporter.
150
216
  parent_validation_concurrency:
151
217
  type: integer
152
218
  minimum: 1
@@ -183,6 +249,15 @@ $defs:
183
249
  Maximum number of `exec run` processes that may run at the same time for one project,
184
250
  counting the primary run and every `exec run --register --worktree --join` run
185
251
  (default 4). 1 disables `--join`.
252
+ git_index_lock_wait_seconds:
253
+ type: integer
254
+ minimum: 0
255
+ default: 1200
256
+ description: >
257
+ Seconds the runner's Git operations (integration and trailing-record commits) wait for
258
+ another process, such as a manual commit's pre-commit hook, to release index.lock before
259
+ failing (default 1200). After the first short retries, the wait stops early when the
260
+ lock file remains but no git process is running (a stale lock); the lock is never removed.
186
261
 
187
262
  ProviderOverride:
188
263
  type: object
@@ -250,9 +325,16 @@ $defs:
250
325
  by_proficiency:
251
326
  type: object
252
327
  minProperties: 1
253
- 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.
254
331
  propertyNames:
255
- 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: {}
256
338
  additionalProperties:
257
339
  $ref: "#/$defs/CommandVariableSet"
258
340
  by_nickname:
@@ -363,17 +445,22 @@ $defs:
363
445
  additionalProperties: false
364
446
  required:
365
447
  - action
366
- 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.
367
452
  properties:
368
453
  action:
369
454
  const: "skip"
370
- description: "Record a block event and move to the next task."
455
+ description: "Compatibility value only; does not skip tasks at runtime."
371
456
  on_critical:
372
457
  type: object
373
458
  additionalProperties: false
374
459
  required:
375
460
  - action
376
- 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.
377
464
  properties:
378
465
  action:
379
466
  type: string
@@ -291,3 +291,41 @@ properties:
291
291
  properties:
292
292
  bytes:
293
293
  maximum: 65536
294
+
295
+ condense_records:
296
+ $ref: "condense-records.schema.yaml"
297
+
298
+ local_config_overrides:
299
+ type: array
300
+ description: >-
301
+ Repository settings the runner took from .specdojo/specdojo.local.config.json for this
302
+ run: a shared repos[] path replaced by name (kind path) or a local repository added
303
+ (kind added). Omitted when no local config value was applied.
304
+ items:
305
+ type: object
306
+ additionalProperties: false
307
+ required: [project, repo, kind, path]
308
+ properties:
309
+ project:
310
+ type: string
311
+ minLength: 1
312
+ repo:
313
+ type: string
314
+ minLength: 1
315
+ kind:
316
+ enum: [path, added]
317
+ path:
318
+ type: string
319
+ minLength: 1
320
+ shared_path:
321
+ type: string
322
+ minLength: 1
323
+ if:
324
+ properties:
325
+ kind:
326
+ const: path
327
+ then:
328
+ required: [shared_path]
329
+ else:
330
+ not:
331
+ required: [shared_path]
@@ -21,6 +21,20 @@ properties:
21
21
  - status
22
22
  - project_id
23
23
  allOf:
24
+ - if:
25
+ required: [approach]
26
+ properties:
27
+ approach:
28
+ const: condense
29
+ then:
30
+ required: [targets]
31
+ properties:
32
+ targets:
33
+ type: array
34
+ minItems: 1
35
+ maxItems: 1
36
+ mode:
37
+ const: edit
24
38
  # Register-originated tasks have no predetermined target deliverable, so targets
25
39
  # cannot be resolved and is not required. Schedule tasks always carry it because
26
40
  # the commit allowlist is derived from it.
@@ -24,6 +24,21 @@ properties:
24
24
  - project_id
25
25
  - started_at
26
26
  allOf:
27
+ - if:
28
+ required: [approach]
29
+ properties:
30
+ approach:
31
+ const: condense
32
+ then:
33
+ required: [condense_records, targets]
34
+ properties:
35
+ condense_records: true
36
+ targets:
37
+ type: array
38
+ minItems: 1
39
+ maxItems: 1
40
+ mode:
41
+ const: edit
27
42
  # Register-originated tasks have no predetermined target deliverable, so targets
28
43
  # cannot be resolved and is not required. Schedule tasks always carry it because
29
44
  # the commit allowlist is derived from it.
@@ -142,3 +157,6 @@ properties:
142
157
  Doc ids of the documents this task targets, carried with the same rules as the plan
143
158
  frontmatter targets. Authoring results carry the new kata id; read-only exemplar sources
144
159
  are described in the plan body instead of becoming change-coverage targets.
160
+
161
+ condense_records:
162
+ $ref: "condense-records.schema.yaml"
@@ -0,0 +1,22 @@
1
+ $schema: "https://json-schema.org/draft/2020-12/schema"
2
+ title: Finding Cause
3
+ description: Shared cause for grade findings and edit records. Omission means document.
4
+ oneOf:
5
+ - type: object
6
+ additionalProperties: false
7
+ required: [type]
8
+ properties:
9
+ type:
10
+ const: document
11
+ - type: object
12
+ additionalProperties: false
13
+ required: [type, kind, location]
14
+ properties:
15
+ type:
16
+ const: kata
17
+ kind:
18
+ enum: [rulebook, recipe, sample, template]
19
+ location:
20
+ type: string
21
+ pattern: "\\S"
22
+ description: Heading, line, or quoted passage in the declared Kata supporting the cause.
@@ -31,7 +31,7 @@ properties:
31
31
  enum: [kata, deliverable]
32
32
  document:
33
33
  type: string
34
- pattern: "^(?!/).+\\.md$"
34
+ pattern: "^(?!/).+\\.(md|ya?ml)$"
35
35
  content_hash:
36
36
  type: string
37
37
  pattern: "^[a-f0-9]{64}$"
@@ -119,6 +119,8 @@ properties:
119
119
  message_ja:
120
120
  type: string
121
121
  minLength: 1
122
+ cause:
123
+ $ref: "finding-cause.schema.yaml"
122
124
  level_corrections:
123
125
  type: array
124
126
  items:
@@ -13,7 +13,6 @@ required:
13
13
  - title
14
14
  - rulebook
15
15
  - command
16
- - arguments
17
16
  - streams
18
17
  - exit_codes
19
18
  - authentication
@@ -43,6 +42,11 @@ properties:
43
42
  items:
44
43
  type: string
45
44
  uniqueItems: true
45
+ supersedes:
46
+ type: array
47
+ items:
48
+ type: string
49
+ uniqueItems: true
46
50
  metadata_template:
47
51
  type: object
48
52
  additionalProperties: true
@@ -56,7 +60,6 @@ properties:
56
60
  additionalProperties: false
57
61
  required:
58
62
  - executable
59
- - subcommands
60
63
  - purpose
61
64
  - shell
62
65
  properties:
@@ -65,13 +68,16 @@ properties:
65
68
  minLength: 1
66
69
  subcommands:
67
70
  type: array
68
- minItems: 1
71
+ minItems: 0
69
72
  items:
70
73
  type: string
71
74
  minLength: 1
72
75
  purpose:
73
76
  type: string
74
77
  minLength: 1
78
+ reference:
79
+ type: string
80
+ minLength: 1
75
81
  version_constraint:
76
82
  type: string
77
83
  shell:
@@ -95,7 +101,9 @@ properties:
95
101
  minLength: 1
96
102
  kind:
97
103
  type: string
98
- enum: ["argument", "option", "_ARGUMENT_KIND_"]
104
+ enum: ["argument", "option", "positional", "_ARGUMENT_KIND_"]
105
+ position:
106
+ $ref: "#/$defs/PositiveIntegerOrPlaceholder"
99
107
  required:
100
108
  $ref: "#/$defs/BooleanOrPlaceholder"
101
109
  value_type:
@@ -103,7 +111,8 @@ properties:
103
111
  minLength: 1
104
112
  value_source:
105
113
  type: string
106
- enum: ["literal", "generated", "secret", "user_input", "_ARGUMENT_VALUE_SOURCE_"]
114
+ enum:
115
+ ["literal", "generated", "config", "secret", "user_input", "_ARGUMENT_VALUE_SOURCE_"]
107
116
  description:
108
117
  type: string
109
118
  minLength: 1
@@ -124,6 +133,28 @@ properties:
124
133
  stderr:
125
134
  $ref: "#/$defs/Stream"
126
135
 
136
+ files:
137
+ type: object
138
+ additionalProperties: false
139
+ properties:
140
+ inputs:
141
+ type: array
142
+ items:
143
+ $ref: "#/$defs/FileContract"
144
+ outputs:
145
+ type: array
146
+ items:
147
+ $ref: "#/$defs/FileContract"
148
+
149
+ side_effects:
150
+ oneOf:
151
+ - type: string
152
+ minLength: 1
153
+ - type: array
154
+ items:
155
+ type: string
156
+ minLength: 1
157
+
127
158
  exit_codes:
128
159
  type: array
129
160
  minItems: 1
@@ -148,6 +179,7 @@ properties:
148
179
  - input_error
149
180
  - authentication_error
150
181
  - authorization_error
182
+ - rate_limit
151
183
  - permanent_failure
152
184
  - transient_failure
153
185
  - _FAILURE_CATEGORY_
@@ -220,6 +252,14 @@ properties:
220
252
  condition:
221
253
  type: string
222
254
  minLength: 1
255
+ side_effects:
256
+ oneOf:
257
+ - type: string
258
+ minLength: 1
259
+ - type: array
260
+ items:
261
+ type: string
262
+ minLength: 1
223
263
 
224
264
  error_handling:
225
265
  type: object
@@ -295,3 +335,23 @@ $defs:
295
335
  type: string
296
336
  description:
297
337
  type: string
338
+
339
+ FileContract:
340
+ type: object
341
+ additionalProperties: false
342
+ required:
343
+ - path
344
+ - format
345
+ - description
346
+ properties:
347
+ path:
348
+ type: string
349
+ minLength: 1
350
+ format:
351
+ type: string
352
+ minLength: 1
353
+ encoding:
354
+ type: string
355
+ description:
356
+ type: string
357
+ minLength: 1