specdojo 0.3.1 → 0.4.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 (241) hide show
  1. package/CHANGELOG.md +47 -0
  2. package/README.md +77 -18
  3. package/dist/{catalog-build-references.js → catalog/build-references.js} +4 -4
  4. package/dist/catalog/build-render.js +32 -0
  5. package/dist/{catalog-build.js → catalog/build.js} +9 -9
  6. package/dist/{catalog.js → catalog/catalog.js} +10 -10
  7. package/dist/{catalog-generate.js → catalog/generate.js} +8 -8
  8. package/dist/catalog/paths.js +1 -0
  9. package/dist/{catalog-plan-generate.js → catalog/plan-generate.js} +4 -4
  10. package/dist/{catalog-plan.js → catalog/plan.js} +4 -4
  11. package/dist/{catalog-scaffold.js → catalog/scaffold.js} +3 -3
  12. package/dist/{agent.js → commands/agent.js} +11 -11
  13. package/dist/{build-command.js → commands/build.js} +2 -2
  14. package/dist/{init-command.js → commands/init.js} +98 -32
  15. package/dist/{orchestrator.js → commands/orchestrator.js} +2 -2
  16. package/dist/{watch.js → commands/watch.js} +3 -3
  17. package/dist/{dashboard-timeline.js → dashboard/dashboard-timeline.js} +2 -2
  18. package/dist/{dashboard.js → dashboard/dashboard.js} +11 -10
  19. package/dist/{dashboard-exec-records.js → dashboard/exec-records.js} +2 -2
  20. package/dist/{dashboard-routines.js → dashboard/routines.js} +6 -5
  21. package/dist/{dashboard-shared.js → dashboard/shared.js} +1 -1
  22. package/dist/{timeline-build.js → dashboard/timeline-build.js} +2 -1
  23. package/dist/{timeline.js → dashboard/timeline.js} +1 -1
  24. package/dist/{deliverable.js → deliverable/deliverable.js} +5 -5
  25. package/dist/{deliverable-trash.js → deliverable/trash.js} +5 -5
  26. package/dist/{devcontainer-command.js → devcontainer/command.js} +5 -3
  27. package/dist/{devcontainer-scaffold.js → devcontainer/scaffold.js} +94 -2
  28. package/dist/{doc-index.js → docs/doc-index.js} +1 -1
  29. package/dist/{frontmatter-namespace.js → docs/frontmatter-namespace.js} +1 -1
  30. package/dist/{index-command.js → docs/index-command.js} +1 -1
  31. package/dist/docs/template-resolution.js +1 -0
  32. package/dist/{viewpoint-document-kinds-check.js → docs/viewpoint-document-kinds-check.js} +1 -1
  33. package/dist/{yaml-pages-command.js → docs/yaml-pages-command.js} +1 -1
  34. package/dist/{yaml-pages.js → docs/yaml-pages.js} +2 -2
  35. package/dist/{exec-agent-config.js → exec/agent-config.js} +33 -4
  36. package/dist/{exec-agent-git-state.js → exec/agent-git-state.js} +1 -1
  37. package/dist/{exec-agent-protected-config.js → exec/agent-protected-config.js} +1 -1
  38. package/dist/{exec-commands.js → exec/commands.js} +22 -18
  39. package/dist/{exec-core.js → exec/core.js} +11 -11
  40. package/dist/{exec-events.js → exec/events.js} +2 -2
  41. package/dist/{exec-evidence.js → exec/evidence.js} +11 -6
  42. package/dist/exec/exec.js +2 -0
  43. package/dist/exec/format.js +1 -0
  44. package/dist/{exec-handoff.js → exec/handoff.js} +13 -12
  45. package/dist/{exec-limit.js → exec/limit.js} +93 -12
  46. package/dist/{exec-parent-validation.js → exec/parent-validation.js} +4 -4
  47. package/dist/{exec-pipeline-state.js → exec/pipeline-state.js} +16 -2
  48. package/dist/{exec-plans-core.js → exec/plans-core.js} +68 -114
  49. package/dist/{exec-plans-generation.js → exec/plans-generation.js} +53 -10
  50. package/dist/{exec-plans-storage.js → exec/plans-storage.js} +5 -5
  51. package/dist/{exec-plans.js → exec/plans.js} +3 -3
  52. package/dist/{exec-project.js → exec/project.js} +1 -1
  53. package/dist/{exec-protection-handoff.js → exec/protection-handoff.js} +3 -3
  54. package/dist/{exec-register-resume.js → exec/register-resume.js} +2 -2
  55. package/dist/{exec-register.js → exec/register.js} +92 -9
  56. package/dist/{exec-repo-integration-git.js → exec/repo-integration-git.js} +2 -2
  57. package/dist/{exec-repo-integration-sync.js → exec/repo-integration-sync.js} +4 -4
  58. package/dist/{exec-repo-integration.js → exec/repo-integration.js} +13 -10
  59. package/dist/{exec-repo-trace.js → exec/repo-trace.js} +3 -3
  60. package/dist/{exec-reporter-output.js → exec/reporter-output.js} +2 -2
  61. package/dist/{exec-reporter.js → exec/reporter.js} +29 -12
  62. package/dist/{exec-results.js → exec/results.js} +256 -22
  63. package/dist/{exec-run-agent-pipeline.js → exec/run/agent-pipeline.js} +32 -12
  64. package/dist/{exec-run-agent.js → exec/run/agent.js} +79 -27
  65. package/dist/{exec-run-in-place.js → exec/run/in-place.js} +56 -27
  66. package/dist/{exec-run-job.js → exec/run/job.js} +64 -35
  67. package/dist/{exec-run-lifecycle-commands.js → exec/run/lifecycle-commands.js} +30 -22
  68. package/dist/{exec-run-lock.js → exec/run/lock.js} +4 -3
  69. package/dist/{exec-run-mode-shared.js → exec/run/mode-shared.js} +3 -3
  70. package/dist/{exec-run-register-command.js → exec/run/register-command.js} +18 -10
  71. package/dist/{exec-run-register-core.js → exec/run/register-core.js} +46 -21
  72. package/dist/{exec-run-register-mode.js → exec/run/register-mode.js} +20 -16
  73. package/dist/{exec-run-register-resume.js → exec/run/register-resume.js} +22 -17
  74. package/dist/{exec-run-register-state.js → exec/run/register-state.js} +13 -10
  75. package/dist/{exec-run-register-worktree.js → exec/run/register-worktree.js} +54 -23
  76. package/dist/{exec-run.js → exec/run/run.js} +11 -11
  77. package/dist/{exec-run-schedule-mode.js → exec/run/schedule-mode.js} +17 -17
  78. package/dist/{exec-run-schedule-prepare.js → exec/run/schedule-prepare.js} +31 -18
  79. package/dist/{exec-run-schedule-task.js → exec/run/schedule-task.js} +45 -18
  80. package/dist/{exec-run-shared.js → exec/run/shared.js} +61 -11
  81. package/dist/{exec-schedule-calendar.js → exec/schedule/calendar.js} +1 -1
  82. package/dist/{exec-schedule-cpm.js → exec/schedule/cpm.js} +2 -2
  83. package/dist/{exec-schedule-gantt-chart-render.js → exec/schedule/gantt-chart-render.js} +2 -2
  84. package/dist/exec/schedule/gantt-chart.js +2 -0
  85. package/dist/{exec-schedule-hash.js → exec/schedule/hash.js} +2 -2
  86. package/dist/exec/schedule/index.js +1 -0
  87. package/dist/{exec-schedule-initial.js → exec/schedule/initial.js} +2 -2
  88. package/dist/{exec-schedule-progress.js → exec/schedule/progress.js} +2 -2
  89. package/dist/{exec-schedule-ready.js → exec/schedule/ready.js} +2 -2
  90. package/dist/{exec-schedule.js → exec/schedule/schedule.js} +11 -11
  91. package/dist/exec/shared.js +63 -0
  92. package/dist/exec/slot-lock.js +1 -0
  93. package/dist/{exec-strategy.js → exec/strategy.js} +2 -2
  94. package/dist/{exec-task-repos.js → exec/task-repos.js} +2 -2
  95. package/dist/{exec-task-view.js → exec/task-view.js} +4 -4
  96. package/dist/{exec-trial-commands.js → exec/trial-commands.js} +20 -22
  97. package/dist/{exec-trial-core.js → exec/trial-core.js} +6 -6
  98. package/dist/{exec-trial.js → exec/trial.js} +2 -2
  99. package/dist/{exec-worktree-command.js → exec/worktree-command.js} +25 -23
  100. package/dist/{exec-worktree-ops-commit.js → exec/worktree-ops-commit.js} +25 -60
  101. package/dist/{exec-worktree-ops-lifecycle.js → exec/worktree-ops-lifecycle.js} +13 -8
  102. package/dist/{exec-worktree-ops-merge.js → exec/worktree-ops-merge.js} +48 -7
  103. package/dist/{exec-worktree-ops.js → exec/worktree-ops.js} +3 -3
  104. package/dist/exec/worktree.js +305 -0
  105. package/dist/{grade-apply.js → grade/apply.js} +9 -9
  106. package/dist/{grade-command-apply.js → grade/command-apply.js} +7 -7
  107. package/dist/{grade-command-inspect.js → grade/command-inspect.js} +6 -6
  108. package/dist/{grade-command-plan.js → grade/command-plan.js} +5 -5
  109. package/dist/{grade-core.js → grade/core.js} +3 -3
  110. package/dist/grade/grade.js +19 -0
  111. package/dist/{grade-markdown.js → grade/markdown.js} +6 -6
  112. package/dist/{grade-pipeline-state.js → grade/pipeline-state.js} +4 -4
  113. package/dist/{grade-plan.js → grade/plan.js} +5 -5
  114. package/dist/{grade-result.js → grade/result.js} +5 -94
  115. package/dist/{grade-target-discovery.js → grade/target-discovery.js} +7 -7
  116. package/dist/{grade-targets.js → grade/targets.js} +11 -8
  117. package/dist/{job-definition.js → job/definition.js} +25 -6
  118. package/dist/{job.js → job/job.js} +12 -11
  119. package/dist/{kata-command.js → kata/command.js} +3 -3
  120. package/dist/{kata.js → kata/kata.js} +5 -5
  121. package/dist/register/approach.js +134 -0
  122. package/dist/{register-core.js → register/core.js} +13 -7
  123. package/dist/{register-create-commands.js → register/create-commands.js} +115 -8
  124. package/dist/{register-date.js → register/date.js} +1 -1
  125. package/dist/register/derivation.js +163 -0
  126. package/dist/{register-event-merge.js → register/event-merge.js} +32 -3
  127. package/dist/{register-events.js → register/events.js} +9 -3
  128. package/dist/{register-history.js → register/history.js} +7 -6
  129. package/dist/{register-item.js → register/item.js} +23 -5
  130. package/dist/register/lifecycle-lock.js +5 -0
  131. package/dist/{register-maintenance-commands.js → register/maintenance-commands.js} +13 -7
  132. package/dist/{register-migrate-timestamps.js → register/migrate-timestamps.js} +3 -3
  133. package/dist/{register-migration.js → register/migration.js} +4 -4
  134. package/dist/{register.js → register/register.js} +32 -27
  135. package/dist/{register-renumber.js → register/renumber.js} +38 -11
  136. package/dist/{register-transition-commands.js → register/transition-commands.js} +3 -3
  137. package/dist/{register-update.js → register/update.js} +5 -5
  138. package/dist/{register-views.js → register/views.js} +47 -7
  139. package/dist/{review-grade.js → review/grade.js} +2 -2
  140. package/dist/{review-plan.js → review/plan.js} +3 -3
  141. package/dist/{routine-definition.js → routine/definition.js} +2 -2
  142. package/dist/{routine.js → routine/routine.js} +49 -22
  143. package/dist/{schedule-approach.js → schedule/approach.js} +8 -8
  144. package/dist/{schedule-build.js → schedule/build.js} +7 -4
  145. package/dist/{schedule.js → schedule/schedule.js} +6 -6
  146. package/dist/{schedule-strategy-generate-document.js → schedule/strategy-generate-document.js} +2 -2
  147. package/dist/{schedule-strategy-generate-scope.js → schedule/strategy-generate-scope.js} +4 -4
  148. package/dist/{schedule-strategy-generate.js → schedule/strategy-generate.js} +10 -10
  149. package/dist/shared/agent-types.js +23 -0
  150. package/dist/shared/artifact-path.js +9 -0
  151. package/dist/{build-if-stale.js → shared/build-if-stale.js} +1 -1
  152. package/dist/{catalog-build-render.js → shared/catalog-render.js} +3 -32
  153. package/dist/{exec-slot-lock.js → shared/cross-process-lock.js} +3 -1
  154. package/dist/shared/fs.js +30 -0
  155. package/dist/{exec-worktree.js → shared/git.js} +83 -241
  156. package/dist/shared/grade-result.js +94 -0
  157. package/dist/{package-paths.js → shared/package-paths.js} +3 -3
  158. package/dist/shared/plan-templates.js +114 -0
  159. package/dist/{exec-provider-scaffold.js → shared/provider-scaffold.js} +3 -1
  160. package/dist/shared/random.js +4 -0
  161. package/dist/{exec-schedule-index.js → shared/schedule-index.js} +3 -1
  162. package/dist/shared/schedule-paths.js +9 -0
  163. package/dist/{specdojo-config.js → shared/specdojo-config.js} +93 -5
  164. package/dist/{exec-shared.js → shared/text.js} +0 -134
  165. package/dist/shared/time.js +28 -0
  166. package/dist/specdojo.js +22 -22
  167. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +29 -17
  168. package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +1 -2
  169. package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -2
  170. package/docs/ja/specdojo/exec-templates/xer-template.md +1 -3
  171. package/docs/ja/specdojo/exec-templates/xrp-job-template.md +6 -4
  172. package/docs/ja/specdojo/guides/exec-config-guide.md +91 -16
  173. package/docs/ja/specdojo/guides/exec-operation-guide.md +145 -12
  174. package/docs/ja/specdojo/guides/exec-worktree-guide.md +2 -0
  175. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +31 -0
  176. package/docs/ja/specdojo/guides/quick-start-guide.md +81 -16
  177. package/docs/ja/specdojo/guides/register-operation-guide.md +2 -1
  178. package/docs/ja/specdojo/guides/remote-host-development-guide.md +10 -1
  179. package/docs/ja/specdojo/guides/review-guide.md +1 -1
  180. package/docs/ja/specdojo/guides/routine-operation-guide.md +5 -5
  181. package/docs/ja/specdojo/guides/use-case-guide.md +1 -1
  182. package/docs/ja/specdojo/references/command-reference.md +52 -28
  183. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +17 -11
  184. package/docs/ja/specdojo/standards/job-definition-standard.md +20 -18
  185. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +2 -2
  186. package/docs/ja/specdojo/templates/pjr-derived-items-template.md +22 -0
  187. package/docs/ja/specdojo/templates/pjr-index-template.md +1 -0
  188. package/docs/specdojo/schemas/v1/agent-members.schema.yaml +29 -2
  189. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +20 -0
  190. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +23 -0
  191. package/docs/specdojo/schemas/v1/job-run.schema.yaml +2 -2
  192. package/docs/specdojo/schemas/v1/job.schema.yaml +7 -0
  193. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +26 -0
  194. package/docs/specdojo/schemas/v1/register-events.schema.yaml +3 -0
  195. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +70 -7
  196. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +1 -1
  197. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -1
  198. package/package.json +1 -1
  199. package/templates/antigravity/README.md +5 -1
  200. package/templates/antigravity/agent-members-snippet.yaml +108 -12
  201. package/templates/antigravity/exec-defaults-snippet.yaml +8 -13
  202. package/templates/claude/README.md +27 -3
  203. package/templates/claude/agents/claude-executor.md +0 -1
  204. package/templates/claude/agents/claude-reporter.md +2 -1
  205. package/templates/claude/agents/claude-review-executor.md +0 -1
  206. package/templates/codex/README.md +23 -4
  207. package/templates/devcontainer/devcontainer.json +2 -2
  208. package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +69 -0
  209. package/templates/devcontainer/remote-host/ssh-config.sample +16 -0
  210. package/templates/init-agent-members.yaml +75 -25
  211. package/templates/init-exec-defaults.yaml +24 -8
  212. package/templates/opencode/README.md +17 -3
  213. package/templates/opencode/agents/opencode-executor.md +0 -1
  214. package/templates/opencode/agents/opencode-reporter.md +2 -1
  215. package/templates/opencode/agents/opencode-review-executor.md +0 -1
  216. package/dist/exec-schedule-gantt-chart.js +0 -2
  217. package/dist/exec.js +0 -2
  218. package/dist/grade.js +0 -19
  219. package/templates/claude/agents/claude-expert-review-executor.md +0 -14
  220. /package/dist/{catalog-plan-prompt.js → catalog/plan-prompt.js} +0 -0
  221. /package/dist/{catalog-types.js → catalog/types.js} +0 -0
  222. /package/dist/{template-frontmatter.js → docs/template-frontmatter.js} +0 -0
  223. /package/dist/{role-types.js → exec/role-types.js} +0 -0
  224. /package/dist/{exec-schedule-gantt-chart-scope.js → exec/schedule/gantt-chart-scope.js} +0 -0
  225. /package/dist/{exec-types.js → exec/types.js} +0 -0
  226. /package/dist/{grade-command-shared.js → grade/command-shared.js} +0 -0
  227. /package/dist/{register-command-types.js → register/command-types.js} +0 -0
  228. /package/dist/{review-types.js → review/types.js} +0 -0
  229. /package/dist/{schedule-phase-sets.js → schedule/phase-sets.js} +0 -0
  230. /package/dist/{schedule-strategy-profiles.js → schedule/strategy-profiles.js} +0 -0
  231. /package/dist/{agent-response.js → shared/agent-response.js} +0 -0
  232. /package/dist/{catalog-paths.js → shared/catalog-paths.js} +0 -0
  233. /package/dist/{dist-freshness.js → shared/dist-freshness.js} +0 -0
  234. /package/dist/{git-environment.js → shared/git-environment.js} +0 -0
  235. /package/dist/{exec-format.js → shared/markdown-format.js} +0 -0
  236. /package/dist/{practice-id.js → shared/practice-id.js} +0 -0
  237. /package/dist/{spawn-self.js → shared/spawn-self.js} +0 -0
  238. /package/dist/{specdojo-gitignore.js → shared/specdojo-gitignore.js} +0 -0
  239. /package/dist/{template-resolution.js → shared/template-resolution.js} +0 -0
  240. /package/dist/{yaml-schema-modeline.js → shared/yaml-schema-modeline.js} +0 -0
  241. /package/dist/{yaml.js → shared/yaml.js} +0 -0
@@ -145,6 +145,6 @@ specdojo:
145
145
  `document_kinds` の `include` / `exclude` を列挙している観点ごとに、新しい rulebook の扱いを判断する。
146
146
  観点を当てはめない場合は `exclude`(`include` の観点では当てはめる場合に `include`)へ、
147
147
  既定の結果のままにする場合は `confirmed_default` へ rulebook ID を追加する。
148
- - 判断の漏れは `src/viewpoint-document-kinds-check.ts` の検証が観点 ID と rulebook ID の組で
148
+ - 判断の漏れは `src/docs/viewpoint-document-kinds-check.ts` の検証が観点 ID と rulebook ID の組で
149
149
  error として報告する。検証は `npm test`(`npm run check` に含まれる)で実行され、
150
- `npx tsx src/viewpoint-document-kinds-check.ts` で単独でも確認できる。
150
+ `npx tsx src/docs/viewpoint-document-kinds-check.ts` で単独でも確認できる。
@@ -0,0 +1,22 @@
1
+ ---
2
+ specdojo:
3
+ id: specdojo:pjr-derived-items-template
4
+ type: template
5
+ status: draft
6
+ frontmatter_template:
7
+ specdojo:
8
+ id: _PROJECT_ID_:pjr-derived-items
9
+ type: project
10
+ status: ready
11
+ rulebook: specdojo:pjr-rulebook
12
+ part_of:
13
+ - _PROJECT_ID_:pjr-index
14
+ ---
15
+
16
+ # 登録項目の派生関係
17
+
18
+ > このファイルは個票の `derived_from` から生成された派生ビューです。正本は個票の Frontmatter であり、このファイルは再生成可能です。
19
+
20
+ ## 1. 元の項目から派生先を辿る
21
+
22
+ <!-- specdojo:view-slot=derived-items -->
@@ -40,6 +40,7 @@ Project Register
40
40
  - [[pjr-views-by-status|台帳ビュー(状態別)]]
41
41
  - [[pjr-views-by-priority|台帳ビュー(優先度別)]]
42
42
  - [[pjr-views-by-owner|台帳ビュー(担当者別)]]
43
+ - [[pjr-derived-items|登録項目の派生関係]]
43
44
 
44
45
  ### 2.2. controls 全体の派生管理ビュー
45
46
 
@@ -13,7 +13,18 @@ properties:
13
13
  items:
14
14
  $ref: "#/$defs/AgentMember"
15
15
  uniqueItems: true
16
+ aliases:
17
+ type: array
18
+ description: >
19
+ Backward-compatible names that refer to concrete members. alias_of may refer to
20
+ another alias, but every chain must terminate at an enabled member.
21
+ items:
22
+ $ref: "#/$defs/AgentAlias"
23
+ uniqueItems: true
16
24
  $defs:
25
+ AgentNickname:
26
+ type: string
27
+ pattern: "^[a-z0-9][a-z0-9_-]{0,62}$"
17
28
  RoleLabel:
18
29
  type: string
19
30
  pattern: "^[A-Z]{2,4}$"
@@ -23,8 +34,7 @@ $defs:
23
34
  required: [nickname, display_name, roles, type, provider, capabilities, proficiency, priority]
24
35
  properties:
25
36
  nickname:
26
- type: string
27
- pattern: "^[a-z0-9][a-z0-9_-]{0,62}$"
37
+ $ref: "#/$defs/AgentNickname"
28
38
  display_name:
29
39
  type: string
30
40
  minLength: 1
@@ -42,6 +52,14 @@ $defs:
42
52
  const: agent
43
53
  provider:
44
54
  enum: [opencode, claude, codex, copilot, antigravity, custom]
55
+ model:
56
+ type: string
57
+ minLength: 1
58
+ description: "Provider model identifier, including its version when applicable."
59
+ effort:
60
+ type: string
61
+ minLength: 1
62
+ description: "Provider-specific reasoning effort passed when the provider supports it."
45
63
  persona:
46
64
  type: string
47
65
  minLength: 1
@@ -74,3 +92,12 @@ $defs:
74
92
  enum: [critical-first, dependency-first, fifo, manual]
75
93
  note:
76
94
  type: string
95
+ AgentAlias:
96
+ type: object
97
+ additionalProperties: false
98
+ required: [nickname, alias_of]
99
+ properties:
100
+ nickname:
101
+ $ref: "#/$defs/AgentNickname"
102
+ alias_of:
103
+ $ref: "#/$defs/AgentNickname"
@@ -262,6 +262,26 @@ $defs:
262
262
  oom:
263
263
  type: number
264
264
  exclusiveMinimum: 0
265
+ pinned:
266
+ type: object
267
+ additionalProperties: false
268
+ description: >
269
+ Recovery for an agent selected by nickname. CLI --on-rate-limit and fallback stage
270
+ flags override these values. Omitted action preserves the historical stop behavior.
271
+ properties:
272
+ action:
273
+ type: string
274
+ enum: [stop, wait, fallback]
275
+ max_wait_seconds:
276
+ type: number
277
+ minimum: 0
278
+ description: Maximum wait for reset/retry-after/cooldown (default 28800 seconds).
279
+ fallback_executor_by:
280
+ type: string
281
+ pattern: "^[a-z0-9][a-z0-9_-]{0,62}$"
282
+ fallback_reporter_by:
283
+ type: string
284
+ pattern: "^[a-z0-9][a-z0-9_-]{0,62}$"
265
285
  on_non_critical:
266
286
  type: object
267
287
  additionalProperties: false
@@ -176,6 +176,29 @@ properties:
176
176
  reason:
177
177
  type: string
178
178
  maxLength: 1000
179
+ rate_limit_events:
180
+ description: Runner-recorded wait/fallback history for a pinned executor.
181
+ type: array
182
+ items:
183
+ type: object
184
+ additionalProperties: false
185
+ required: [action, from_actor, to_actor, resumed_at]
186
+ properties:
187
+ action:
188
+ type: string
189
+ enum: [wait, fallback]
190
+ from_actor:
191
+ type: string
192
+ minLength: 1
193
+ to_actor:
194
+ type: string
195
+ minLength: 1
196
+ resumed_at:
197
+ type: string
198
+ format: date-time
199
+ resume_at:
200
+ type: string
201
+ format: date-time
179
202
  final_message:
180
203
  type: string
181
204
  maxLength: 4000
@@ -46,7 +46,7 @@ properties:
46
46
  type: string
47
47
  format: date-time
48
48
  state:
49
- enum: [running, succeeded, failed, noop]
49
+ enum: [running, succeeded, partial, failed, noop]
50
50
  inputs:
51
51
  type: object
52
52
  task:
@@ -78,7 +78,7 @@ properties:
78
78
  type: string
79
79
  format: date-time
80
80
  status:
81
- enum: [running, succeeded, failed, noop]
81
+ enum: [running, succeeded, partial, failed, noop]
82
82
  result_ref:
83
83
  type: string
84
84
  evidence_ref:
@@ -190,6 +190,13 @@ $defs:
190
190
  command:
191
191
  type: string
192
192
  minLength: 1
193
+ partial_exit_code:
194
+ description: >
195
+ Optional non-zero exit code that records a reviewable partial Job Run. Other non-zero
196
+ exit codes remain failures.
197
+ type: integer
198
+ minimum: 1
199
+ maximum: 255
193
200
  precondition:
194
201
  type: object
195
202
  additionalProperties: false
@@ -57,6 +57,8 @@ $defs:
57
57
  format: date-time
58
58
  artifact_ref:
59
59
  type: [string, "null"]
60
+ rate_limit_events:
61
+ $ref: "#/$defs/rateLimitEvents"
60
62
  # Keys are repository names (`project` for the project repository) in integration order.
61
63
  repos:
62
64
  type: object
@@ -102,3 +104,27 @@ $defs:
102
104
  format: date-time
103
105
  artifact_ref:
104
106
  type: [string, "null"]
107
+ rate_limit_events:
108
+ $ref: "#/$defs/rateLimitEvents"
109
+ rateLimitEvents:
110
+ type: array
111
+ items:
112
+ type: object
113
+ additionalProperties: false
114
+ required: [action, from_actor, to_actor, resumed_at]
115
+ properties:
116
+ action:
117
+ type: string
118
+ enum: [wait, fallback]
119
+ from_actor:
120
+ type: string
121
+ minLength: 1
122
+ to_actor:
123
+ type: string
124
+ minLength: 1
125
+ resumed_at:
126
+ type: string
127
+ format: date-time
128
+ resume_at:
129
+ type: string
130
+ format: date-time
@@ -55,6 +55,9 @@ $defs:
55
55
  - completed
56
56
  - conclusion
57
57
  - block_reason
58
+ - approach
59
+ - targets
60
+ - derived_from
58
61
  from:
59
62
  type: string
60
63
  to:
@@ -7,8 +7,9 @@ description: >
7
7
 
8
8
  The frontmatter is the single source of truth for the structured fields of one
9
9
  register item: classification (item_type), processing status (item_status),
10
- priority, owner, dates, block reason and conclusion. The register list (pjr-index) is a derived
11
- view generated from these files, so the same field is never stored in two places.
10
+ priority, owner, dates, block reason, conclusion and derivation sources. The register list
11
+ (pjr-index) is a derived view generated from these files, so the same field is never stored in
12
+ two places.
12
13
 
13
14
  Conventions:
14
15
  - Undecided values are expressed by omitting the key. Table placeholders such as
@@ -43,6 +44,19 @@ properties:
43
44
  # required と同じ位置で対象プロパティを宣言する。
44
45
  properties:
45
46
  completed_at: true
47
+ - if:
48
+ required:
49
+ - approach
50
+ properties:
51
+ approach: true
52
+ then:
53
+ required:
54
+ - targets
55
+ properties:
56
+ targets:
57
+ type: array
58
+ minItems: 1
59
+ maxItems: 1
46
60
  - type: object
47
61
  required:
48
62
  - rulebook
@@ -143,6 +157,26 @@ properties:
143
157
  rejection. Omit the key while it is undetermined; the details stay in
144
158
  the body (list column: 結論).
145
159
 
160
+ derived_from:
161
+ type: array
162
+ items:
163
+ oneOf:
164
+ - $ref: "#/$defs/LocalRegisterItemRef"
165
+ - $ref: "#/$defs/QualifiedRegisterItemRef"
166
+ minItems: 1
167
+ uniqueItems: true
168
+ description: >
169
+ Register items from which this item was derived. Use PJR-XXXX for an item in the
170
+ same project and <project-id>:PJR-XXXX for an item in another project. Omit the key
171
+ when the item was not derived from another register item.
172
+
173
+ approach:
174
+ $ref: "#/$defs/Approach"
175
+ description: >
176
+ Execution approach for the single target. When present, targets must
177
+ contain exactly one document id whose kind is compatible with the
178
+ approach.
179
+
146
180
  targets:
147
181
  type: array
148
182
  items:
@@ -150,11 +184,13 @@ properties:
150
184
  minLength: 1
151
185
  minItems: 1
152
186
  description: >
153
- Doc ids of documents this register item targets, each resolvable
154
- via the doc index. When present, exec plan generation copies these
155
- into the plan frontmatter so that target coverage validation works
156
- for register-originated plans. Omit the key when the target
157
- documents are unknown or not applicable.
187
+ Doc ids of documents this register item targets. Deliverable targets
188
+ used with an approach are resolved via the project catalog so that
189
+ not-yet-created deliverables can be selected; kata and standalone
190
+ targets are resolved via the doc index. When present, exec plan
191
+ generation copies these into the plan frontmatter so that target
192
+ coverage validation works for register-originated plans. Omit the
193
+ key when the target documents are unknown or not applicable.
158
194
 
159
195
  $defs:
160
196
  ItemType:
@@ -200,6 +236,23 @@ $defs:
200
236
  - low
201
237
  description: "Handling priority of a register item."
202
238
 
239
+ Approach:
240
+ type: string
241
+ enum:
242
+ - fully-guided
243
+ - recipe-guided
244
+ - freeform
245
+ - bootstrap
246
+ - retrofit
247
+ - cross-deliverable-dedup
248
+ - rulebook-maintenance
249
+ - recipe-maintenance
250
+ - sample-maintenance
251
+ - template-maintenance
252
+ - finalize
253
+ - bootstrap-finalize
254
+ description: "Execution approach shared with src/shared/agent-types.ts."
255
+
203
256
  Date:
204
257
  type: string
205
258
  format: date
@@ -215,3 +268,13 @@ $defs:
215
268
  Storing the instant instead of a calendar day keeps the record independent of
216
269
  the display timezone. Write it as a quoted YAML string, because an unquoted
217
270
  date-time is loaded as a timestamp value instead of a string.
271
+
272
+ LocalRegisterItemRef:
273
+ type: string
274
+ pattern: "^PJR-[0-9ABCDEFGHJKMNPQRSTVWXYZ]{4}$"
275
+ description: "Display id of a register item in the same project."
276
+
277
+ QualifiedRegisterItemRef:
278
+ type: string
279
+ pattern: "^[a-z][a-z0-9-]*:PJR-[0-9ABCDEFGHJKMNPQRSTVWXYZ]{4}$"
280
+ description: "Project-qualified display id of a register item in another project."
@@ -27,7 +27,7 @@ properties:
27
27
  type: string
28
28
  format: date-time
29
29
  result:
30
- enum: [success, failure, skipped]
30
+ enum: [success, partial, failure, skipped]
31
31
  job_run_ids:
32
32
  type: array
33
33
  uniqueItems: true
@@ -1,7 +1,7 @@
1
1
  $schema: "https://json-schema.org/draft/2020-12/schema"
2
2
  title: SpecDojo Config (.specdojo/specdojo.config.json)
3
3
  description: >-
4
- Shape of .specdojo/specdojo.config.json. The CLI (src/specdojo-config.ts loadConfig) is the
4
+ Shape of .specdojo/specdojo.config.json. The CLI (src/shared/specdojo-config.ts loadConfig) is the
5
5
  authority for checks that a schema cannot express: repository names that collide with a
6
6
  project id and repository paths that do not exist.
7
7
  type: object
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "specdojo",
3
- "version": "0.3.1",
3
+ "version": "0.4.0",
4
4
  "description": "A dojo for Spec-Dō, the way of specification: decide with a register, write specs and designs with kata, and keep sharpening them with AI.",
5
5
  "license": "MIT",
6
6
  "author": "naoji3x",
@@ -57,4 +57,8 @@ agy --add-dir "$(pwd)" --model gemini-3.8-flash-high -i "$(cat .specdojo/antigra
57
57
 
58
58
  ## executor / reporter として使う
59
59
 
60
- `exec-defaults-snippet.yaml` を `.specdojo/exec-defaults.yaml` の `providers` へ、`agent-members-snippet.yaml` の member 定義をリポジトリ共通の `.specdojo/agent-members.yaml` の `members` へ写します。agent は project ごとの `pm-members.yaml` へ書きません。使えるモデル ID は `agy models` で確認します。モデル ID は推論強度を含むため、`--effort` を併用すると起動に失敗します。headless 実行に必要な command は上記のグローバル permission で許可し、`--dangerously-skip-permissions` は使いません。
60
+ `exec-defaults-snippet.yaml` を `.specdojo/exec-defaults.yaml` の `providers` へ、`agent-members-snippet.yaml` の member 定義をリポジトリ共通の `.specdojo/agent-members.yaml` の `members` へ写します。agent は project ごとの `pm-members.yaml` へ書きません。
61
+
62
+ 名簿は実体と別名の 2 段で書きます。実体(`flash-executor`・`agy-opus-executor` など)は model の系統で名付け、model の ID を `model` に持ちます。従来の名前(`agy-executor`・`agy-claude-executor` など)は `aliases` で実体を指す別名にします。スニペット末尾の `aliases` の例は、向き先の member を有効にしたものだけを写します(別名は無効な member を指せません)。
63
+
64
+ 使えるモデル ID は `agy models` で確認します。モデル ID は推論強度を含むため、`--effort` を併用すると起動に失敗します。headless 実行に必要な command は上記のグローバル permission で許可し、`--dangerously-skip-permissions` は使いません。
@@ -3,59 +3,155 @@
3
3
  # project ごとの pm-members.yaml は人間専用なので、agent は記載しない。
4
4
  # 起動コマンドは member には書かず、.specdojo/exec-defaults.yaml の
5
5
  # providers.antigravity.command_template で定義する(exec-defaults-snippet.yaml を参照)。
6
- # モデルの差し替えは command_params.by_nickname で行う。
7
- # 既定では disabled にしてある。使う member だけ disabled を外す。
6
+ #
7
+ # 名簿は実体と別名の 2 段で書く(PJR-ZM1K)。
8
+ # members : model の系統で名付けた実体。provider・model・役割を持ち、model の ID(推論強度を含む)は
9
+ # 実体の model の 1 か所に書く。Claude Code など既定の provider と同じ系統の model は、
10
+ # agy- を前に付けて区別する(agy-opus-executor など)。
11
+ # aliases : 従来の名前(agy-executor など)。実体を指すだけで、Job・routine・利用者の設定はそのまま動く。
12
+ #
13
+ # 既定では members を disabled にしてある。使う member だけ disabled を外す。
14
+ # 別名は有効な member を指す必要があるため、下の aliases の例は、向き先の member の disabled を
15
+ # 外したものだけを .specdojo/agent-members.yaml の aliases へ写す。
8
16
 
9
17
  version: 1
10
18
  members:
11
- - nickname: agy-executor
19
+ - nickname: flash-executor
12
20
  disabled: true
13
21
  priority: 4
14
- display_name: Antigravity Executor
22
+ display_name: Antigravity Flash Executor
15
23
  email: null
16
24
  roles: []
17
25
  type: agent
18
26
  provider: antigravity
27
+ model: gemini-3.8-flash-medium
19
28
  mode: edit
29
+ stage_role: executor
20
30
  proficiency: normal
21
31
  persona: task-executor
22
32
  capabilities: []
23
33
 
24
- - nickname: agy-expert-executor
34
+ - nickname: flash-high-executor
25
35
  disabled: true
26
36
  priority: 3
27
- display_name: Antigravity Expert Executor
37
+ display_name: Antigravity Flash High Executor
28
38
  email: null
29
39
  roles: []
30
40
  type: agent
31
41
  provider: antigravity
42
+ model: gemini-3.8-flash-high
32
43
  mode: edit
44
+ stage_role: executor
33
45
  proficiency: expert
34
46
  persona: task-executor
35
47
  capabilities: []
36
48
 
37
- - nickname: agy-expert-review-executor
49
+ - nickname: flash-high-review-executor
38
50
  disabled: true
39
51
  priority: 3
40
- display_name: Antigravity Expert Review Executor
52
+ display_name: Antigravity Flash High Review Executor
41
53
  email: null
42
54
  roles: []
43
55
  type: agent
44
56
  provider: antigravity
57
+ model: gemini-3.8-flash-high
45
58
  mode: review
59
+ stage_role: executor
46
60
  proficiency: expert
47
- persona: reviewer
61
+ persona: multi-viewpoint-reviewer
48
62
  capabilities: []
49
63
 
50
- - nickname: agy-reporter
64
+ - nickname: flash-reporter
51
65
  disabled: true
52
66
  priority: 4
53
- display_name: Antigravity Reporter
67
+ display_name: Antigravity Flash Reporter
54
68
  email: null
55
69
  roles: []
56
70
  type: agent
57
71
  provider: antigravity
72
+ model: gemini-3.8-flash-medium
58
73
  mode: report
74
+ stage_role: reporter
59
75
  proficiency: normal
60
- persona: reporter
76
+ persona: execution-reporter
61
77
  capabilities: []
78
+
79
+ # Gemini 以外の Antigravity 提供 model。自動選択では選ばれにくい priority にし、by-name で使う。
80
+ - nickname: agy-sonnet-executor
81
+ disabled: true
82
+ priority: 5
83
+ display_name: Antigravity Claude Sonnet Executor
84
+ email: null
85
+ roles: []
86
+ type: agent
87
+ provider: antigravity
88
+ model: claude-sonnet-5-5-medium
89
+ mode: edit
90
+ stage_role: executor
91
+ proficiency: normal
92
+ persona: task-executor
93
+ capabilities: []
94
+
95
+ - nickname: agy-opus-executor
96
+ disabled: true
97
+ priority: 5
98
+ display_name: Antigravity Claude Opus Executor
99
+ email: null
100
+ roles: []
101
+ type: agent
102
+ provider: antigravity
103
+ model: claude-opus-5-5-high
104
+ mode: edit
105
+ stage_role: executor
106
+ proficiency: expert
107
+ persona: task-executor
108
+ capabilities: []
109
+
110
+ - nickname: agy-opus-review-executor
111
+ disabled: true
112
+ priority: 5
113
+ display_name: Antigravity Claude Opus Review Executor
114
+ email: null
115
+ roles: []
116
+ type: agent
117
+ provider: antigravity
118
+ model: claude-opus-5-5-high
119
+ mode: review
120
+ stage_role: executor
121
+ proficiency: expert
122
+ persona: multi-viewpoint-reviewer
123
+ capabilities: []
124
+
125
+ - nickname: agy-gpt-oss-executor
126
+ disabled: true
127
+ priority: 5
128
+ display_name: Antigravity GPT OSS Executor
129
+ email: null
130
+ roles: []
131
+ type: agent
132
+ provider: antigravity
133
+ model: gpt-oss-120b-medium
134
+ mode: edit
135
+ stage_role: executor
136
+ proficiency: normal
137
+ persona: task-executor
138
+ capabilities: []
139
+
140
+ # 別名の例(従来の名前 -> 実体)。向き先の member を有効にしたものだけを写す。
141
+ # aliases:
142
+ # - nickname: agy-executor
143
+ # alias_of: flash-executor
144
+ # - nickname: agy-expert-executor
145
+ # alias_of: flash-high-executor
146
+ # - nickname: agy-expert-review-executor
147
+ # alias_of: flash-high-review-executor
148
+ # - nickname: agy-reporter
149
+ # alias_of: flash-reporter
150
+ # - nickname: agy-claude-executor
151
+ # alias_of: agy-sonnet-executor
152
+ # - nickname: agy-claude-expert-executor
153
+ # alias_of: agy-opus-executor
154
+ # - nickname: agy-claude-expert-review-executor
155
+ # alias_of: agy-opus-review-executor
156
+ # - nickname: agy-gpt-executor
157
+ # alias_of: agy-gpt-oss-executor
@@ -1,7 +1,8 @@
1
1
  # Antigravity CLI(agy)provider 設定のスニペット。
2
2
  # 利用プロジェクトの .specdojo/exec-defaults.yaml の providers へコピーして使う。
3
- # by_nickname は member ごとにモデルを差し替える層で、Gemini 以外のモデルを
4
- # 指名するために使う。不要な member の行は削除してよい。
3
+ # model は実体の member の model に書き、command_template の {model} で渡す(PJR-ZM1K)。
4
+ # model を持たない従来の 1 段の member を残す場合だけ、command_params.by_proficiency /
5
+ # by_nickname で model を補う(member の model があればそちらが優先される)。
5
6
  # 設計の背景は sysd-antigravity-agent-settings と exec-config-guide.md を参照。
6
7
 
7
8
  providers:
@@ -20,17 +21,11 @@ providers:
20
21
  # 使える model の ID は `agy models` で確かめる。Gemini の Pro 系は提供されなくなったため、
21
22
  # expert は Flash の high とする(2026-10-15、agy 1.3.5 で確認)。
22
23
  command_template: 'agy --sandbox --add-dir "$(pwd)" --model {model} -p "$(cat)"'
23
- command_params:
24
- by_proficiency:
25
- normal: { model: gemini-3.8-flash-medium }
26
- expert: { model: gemini-3.8-flash-high }
27
- # Gemini 以外の Antigravity 提供モデルは member nickname で明示的に選ぶ。
28
- # by_nickname は proficiency / mode の既定値より優先される。
29
- by_nickname:
30
- agy-claude-executor: { model: claude-sonnet-5-5-medium }
31
- agy-claude-expert-executor: { model: claude-opus-5-5-high }
32
- agy-claude-expert-review-executor: { model: claude-opus-5-5-high }
33
- agy-gpt-executor: { model: gpt-oss-120b-medium }
24
+ # 従来の 1 段の名簿(model を持たない member)を使い続ける場合の補い方:
25
+ # command_params:
26
+ # by_proficiency:
27
+ # normal: { model: gemini-3.8-flash-medium }
28
+ # expert: { model: gemini-3.8-flash-high }
34
29
  # Gemini API の制限文言は未観測。429 / quota / RESOURCE_EXHAUSTED を初期値とし、
35
30
  # 実観測した文言で更新する(observed-agent-limit-stderr と同じ扱い)。
36
31
  rate_limit_detection:
@@ -15,7 +15,7 @@ specdojo:
15
15
 
16
16
  | パス | 利用プロジェクトでの配置先 | 説明 |
17
17
  | ---------------------- | -------------------------- | --------------------------------------------------------------------- |
18
- | `agents/*.md` | `.claude/agents/` | agent 定義。`--agent <name>` で参照されるため配置先は固定 |
18
+ | `agents/*.md` | `.claude/agents/` | 役割ごとの agent 定義。`--agent <name>` で参照されるため配置先は固定 |
19
19
  | `settings.edit.json` | `.specdojo/claude/` | edit executor 用 permission 設定。成果物への書き込みを許可する |
20
20
  | `settings.review.json` | `.specdojo/claude/` | review executor 用 permission 設定。result 配下のみ書き込みを許可する |
21
21
  | `settings.report.json` | `.specdojo/claude/` | reporter 用 permission 設定。Edit/Write と git add/commit を拒否する |
@@ -31,14 +31,38 @@ specdojo exec scaffold --provider claude
31
31
  既存ファイルは上書きされません(`--force` 指定時のみ上書き)。`--dry-run` でコピー予定を確認できます。コピー後に次の 2 点を行います。
32
32
 
33
33
  1. `.specdojo/exec-defaults.yaml` の `providers.claude.command_template` に `--settings .specdojo/claude/settings.{mode}.json` を指定する(`--permission-mode bypassPermissions` は付けない)。member 側に `command` は書かない。
34
- 2. コピーしたファイルをコミットする。worktree はコミット済み内容から作られるため、未コミットだと agent 実行時に設定が読めない。
34
+ 2. agent の定義は役割(executor・review executor・reporter)ごとの 1 ファイルで、model を持たない。`command_params.by_mode` で mode から定義を選び、model は実体の member の `model` を `--model {model}` で渡す。
35
+ 3. コピーしたファイルをコミットする。worktree はコミット済み内容から作られるため、未コミットだと agent 実行時に設定が読めない。
35
36
 
36
37
  ```yaml
37
38
  providers:
38
39
  claude:
39
- command_template: "claude -p --verbose --agent {nickname} --settings .specdojo/claude/settings.{mode}.json"
40
+ command_template: "claude -p --verbose --agent {agent} --model {model} --settings .specdojo/claude/settings.{mode}.json"
41
+ command_params:
42
+ by_mode:
43
+ edit: { agent: claude-executor }
44
+ review: { agent: claude-review-executor }
45
+ report: { agent: claude-reporter }
40
46
  ```
41
47
 
48
+ `.specdojo/agent-members.yaml` は実体と別名の 2 段で書く。実体は model の系統で名付け(`sonnet-executor`・`opus-executor` など)、`model` に `sonnet` / `opus` を持つ。従来の名前(`claude-executor`・`claude-expert-executor` など)は `aliases` で実体を指す別名にする。
49
+
50
+ ```yaml
51
+ members:
52
+ - nickname: opus-executor
53
+ provider: claude
54
+ model: opus
55
+ mode: edit
56
+ stage_role: executor
57
+ proficiency: expert
58
+ # display_name などの必須項目は省略
59
+ aliases:
60
+ - nickname: claude-expert-executor
61
+ alias_of: opus-executor
62
+ ```
63
+
64
+ 従来の `--agent {nickname}` と model を持つ定義ファイルで組んだ 1 段の名簿は、そのまま動く。scaffold は既存ファイルを上書きしないため、`--force` で役割ごとの定義(model を持たない)に置き換える場合だけ、上の `command_template` へ移す。移行の手順は exec-config-guide の `agent の名簿の 2 段構成と移行` を参照する。
65
+
42
66
  ## 4. カスタマイズ
43
67
 
44
68
  - edit 用の既定値は `docs/**`、`src/**`、`tests/**` を許可する。`Edit(...)` / `Write(...)` のパスパターンは、利用プロジェクトの成果物・execution ディレクトリ配置に合わせて調整する。
@@ -2,7 +2,6 @@
2
2
  name: claude-executor
3
3
  description: SpecDojo pipeline の executor。成果物の編集と検証だけを行い、result は更新しない。
4
4
  tools: Read, Edit, Write, Bash, Glob, Grep, WebSearch, WebFetch
5
- model: sonnet
6
5
  ---
7
6
 
8
7
  あなたは SpecDojo pipeline の Claude executor です。