specdojo 0.2.1 → 0.3.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 (168) hide show
  1. package/.github/agents/specdojo-orchestrator.md +165 -0
  2. package/CHANGELOG.md +280 -0
  3. package/README.md +92 -42
  4. package/dist/agent-response.js +20 -0
  5. package/dist/agent.js +4 -4
  6. package/dist/build-command.js +28 -8
  7. package/dist/dashboard.js +122 -1
  8. package/dist/devcontainer-command.js +43 -0
  9. package/dist/devcontainer-scaffold.js +165 -0
  10. package/dist/exec-agent-config.js +107 -9
  11. package/dist/exec-agent-git-state.js +18 -0
  12. package/dist/exec-agent-protected-config.js +46 -8
  13. package/dist/exec-evidence.js +254 -11
  14. package/dist/exec-handoff.js +336 -0
  15. package/dist/exec-parent-validation.js +317 -43
  16. package/dist/exec-pipeline-state.js +74 -9
  17. package/dist/exec-plans.js +115 -113
  18. package/dist/exec-protection-handoff.js +43 -2
  19. package/dist/exec-provider-scaffold.js +247 -15
  20. package/dist/exec-register-resume.js +65 -19
  21. package/dist/exec-register.js +9 -3
  22. package/dist/exec-repo-integration.js +811 -0
  23. package/dist/exec-repo-trace.js +182 -0
  24. package/dist/exec-reporter.js +613 -132
  25. package/dist/exec-results.js +81 -56
  26. package/dist/exec-run-lock.js +110 -107
  27. package/dist/exec-run.js +1585 -356
  28. package/dist/exec-shared.js +7 -0
  29. package/dist/exec-slot-lock.js +242 -0
  30. package/dist/exec-task-repos.js +415 -0
  31. package/dist/exec-trial.js +51 -25
  32. package/dist/exec-worktree-command.js +87 -43
  33. package/dist/exec-worktree-ops.js +502 -57
  34. package/dist/exec-worktree.js +114 -27
  35. package/dist/exec.js +13 -6
  36. package/dist/grade-result.js +128 -0
  37. package/dist/grade.js +809 -72
  38. package/dist/init-command.js +443 -0
  39. package/dist/job.js +160 -10
  40. package/dist/orchestrator.js +213 -0
  41. package/dist/register-event-merge.js +169 -0
  42. package/dist/register-item.js +7 -1
  43. package/dist/register.js +294 -86
  44. package/dist/review-grade.js +252 -0
  45. package/dist/review-plan.js +111 -1
  46. package/dist/review-types.js +40 -1
  47. package/dist/routine.js +72 -5
  48. package/dist/schedule-build.js +2 -2
  49. package/dist/schedule.js +17 -4
  50. package/dist/specdojo-config.js +465 -19
  51. package/dist/specdojo-gitignore.js +135 -0
  52. package/dist/specdojo.js +6 -0
  53. package/dist/viewpoint-document-kinds-check.js +128 -0
  54. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +348 -90
  55. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +51 -17
  56. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +7 -5
  57. package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +29 -31
  58. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +34 -55
  59. package/docs/ja/specdojo/exec-templates/xrp-job-template.md +54 -0
  60. package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +28 -37
  61. package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +29 -34
  62. package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +30 -30
  63. package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +29 -34
  64. package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +29 -34
  65. package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +29 -34
  66. package/docs/ja/specdojo/exec-templates/xrp-template.md +29 -28
  67. package/docs/ja/specdojo/exec-templates/xrr-template.md +11 -9
  68. package/docs/ja/specdojo/guides/docs-editing-guide.md +20 -0
  69. package/docs/ja/specdojo/guides/docs-structure-guide.md +103 -70
  70. package/docs/ja/specdojo/guides/exec-config-guide.md +91 -47
  71. package/docs/ja/specdojo/guides/exec-operation-guide.md +124 -27
  72. package/docs/ja/specdojo/guides/exec-worktree-guide.md +40 -11
  73. package/docs/ja/specdojo/guides/kata-guide.md +4 -4
  74. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +25 -4
  75. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +1 -1
  76. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +13 -13
  77. package/docs/ja/specdojo/guides/quick-start-guide.md +260 -30
  78. package/docs/ja/specdojo/guides/register-operation-guide.md +31 -14
  79. package/docs/ja/specdojo/guides/release-v0-3-0-migration-guide.md +264 -0
  80. package/docs/ja/specdojo/guides/remote-host-development-guide.md +22 -1
  81. package/docs/ja/specdojo/guides/review-guide.md +195 -158
  82. package/docs/ja/specdojo/guides/routine-operation-guide.md +74 -9
  83. package/docs/ja/specdojo/guides/ryu-guide.md +32 -30
  84. package/docs/ja/specdojo/guides/schedule-design-guide.md +10 -10
  85. package/docs/ja/specdojo/guides/schedule-operation-guide.md +1 -1
  86. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +58 -33
  87. package/docs/ja/specdojo/guides/use-case-guide.md +3 -3
  88. package/docs/ja/specdojo/guides/waza-guide.md +15 -2
  89. package/docs/ja/specdojo/index.md +2 -2
  90. package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +5 -5
  91. package/docs/ja/specdojo/recipes/bps-recipe.md +213 -0
  92. package/docs/ja/specdojo/recipes/pm-members-recipe.md +52 -117
  93. package/docs/ja/specdojo/references/command-reference.md +335 -92
  94. package/docs/ja/specdojo/references/deliverables-reference.md +1 -1
  95. package/docs/ja/specdojo/references/directory-layout-reference.md +13 -9
  96. package/docs/ja/specdojo/references/specdojo-config-reference.md +107 -24
  97. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +132 -220
  98. package/docs/ja/specdojo/rulebooks/br-rulebook.md +6 -44
  99. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +2 -0
  100. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +0 -87
  101. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +61 -39
  102. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +0 -87
  103. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +1 -33
  104. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +0 -137
  105. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +0 -247
  106. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +0 -83
  107. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +4 -2
  108. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +78 -150
  109. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +5 -4
  110. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +1 -1
  111. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +0 -11
  112. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +0 -61
  113. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +2 -47
  114. package/docs/ja/specdojo/samples/bps-sample.md +74 -21
  115. package/docs/ja/specdojo/samples/gl-sample.yaml +17 -1
  116. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +28 -0
  117. package/docs/ja/specdojo/samples/pm-members-sample.yaml +2 -67
  118. package/docs/ja/specdojo/samples/pm-organization-sample.md +8 -7
  119. package/docs/ja/specdojo/samples/pm-raci-sample.md +1 -1
  120. package/docs/ja/specdojo/samples/tml-sample.yaml +40 -0
  121. package/docs/ja/specdojo/standards/document-metadata-standard.md +21 -16
  122. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +14 -14
  123. package/docs/ja/specdojo/standards/job-definition-standard.md +37 -17
  124. package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +37 -32
  125. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -1
  126. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +21 -11
  127. package/docs/ja/specdojo/templates/agent-members-template.yaml +25 -0
  128. package/docs/ja/specdojo/templates/bps-template.md +91 -0
  129. package/docs/ja/specdojo/templates/pm-members-template.yaml +2 -59
  130. package/docs/specdojo/schemas/v1/agent-members.schema.yaml +76 -0
  131. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +4 -2
  132. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +55 -2
  133. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +93 -6
  134. package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +27 -78
  135. package/docs/specdojo/schemas/v1/gl.schema.yaml +87 -0
  136. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +33 -0
  137. package/docs/specdojo/schemas/v1/job-run.schema.yaml +27 -0
  138. package/docs/specdojo/schemas/v1/job.schema.yaml +25 -0
  139. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +49 -1
  140. package/docs/specdojo/schemas/v1/pm-members.schema.yaml +9 -169
  141. package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +100 -10
  142. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +13 -0
  143. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +3 -0
  144. package/docs/specdojo/schemas/v1/routine.schema.yaml +7 -0
  145. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +110 -0
  146. package/package.json +15 -9
  147. package/templates/antigravity/README.md +27 -2
  148. package/templates/antigravity/{pm-members-snippet.yaml → agent-members-snippet.yaml} +8 -2
  149. package/templates/antigravity/exec-defaults-snippet.yaml +7 -6
  150. package/templates/antigravity/orchestrator.md +18 -7
  151. package/templates/antigravity/settings.global.json +55 -0
  152. package/templates/claude/agents/claude-executor.md +14 -0
  153. package/templates/claude/agents/claude-reporter.md +16 -0
  154. package/templates/claude/agents/specdojo-orchestrator.md +18 -7
  155. package/templates/claude/settings.edit.json +27 -1
  156. package/templates/codex/README.md +5 -4
  157. package/templates/codex/agents/specdojo-orchestrator.toml +18 -7
  158. package/templates/codex/orchestrator.md +18 -7
  159. package/templates/copilot/README.md +7 -5
  160. package/templates/copilot/{pm-members-snippet.yaml → agent-members-snippet.yaml} +4 -2
  161. package/templates/devcontainer/devcontainer.json +27 -0
  162. package/templates/devcontainer/emacs/init.el +88 -0
  163. package/templates/devcontainer/post-create.sh +62 -0
  164. package/templates/init-agent-members.yaml +200 -0
  165. package/templates/init-exec-defaults.yaml +72 -0
  166. package/templates/opencode/agents/specdojo-orchestrator.md +18 -7
  167. package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +0 -7
  168. package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +0 -7
@@ -3,8 +3,8 @@ $schema: "https://json-schema.org/draft/2020-12/schema"
3
3
  title: "SpecDojo executor evidence schema"
4
4
  description: >
5
5
  Bounded, structured evidence collected by the runner after an executor pipeline stage.
6
- Redacted and bounded agent output logs may be referenced for failure investigation;
7
- raw diffs and unbounded process logs are intentionally excluded.
6
+ Redacted and bounded agent and parent-validation output logs may be referenced for failure
7
+ investigation; raw diffs and unbounded process logs are intentionally excluded.
8
8
  type: object
9
9
  additionalProperties: false
10
10
  required:
@@ -64,6 +64,23 @@ properties:
64
64
  status:
65
65
  type: string
66
66
  minLength: 1
67
+ attempt_changes:
68
+ description: >
69
+ Files materially changed during this executor attempt. Pre-existing worktree changes are
70
+ excluded so an interrupted first attempt can provide a lower-bound coverage set on resume.
71
+ type: array
72
+ maxItems: 1000
73
+ items:
74
+ type: object
75
+ additionalProperties: false
76
+ required: [path, status]
77
+ properties:
78
+ path:
79
+ type: string
80
+ minLength: 1
81
+ status:
82
+ type: string
83
+ minLength: 1
67
84
  diff_summary:
68
85
  type: object
69
86
  additionalProperties: false
@@ -90,16 +107,33 @@ properties:
90
107
  source:
91
108
  type: string
92
109
  enum: [executor, runner]
110
+ repo:
111
+ type: string
112
+ pattern: "^[a-z0-9-]+$"
113
+ description: >
114
+ Repository whose worktree was the cwd of a runner validation: `project` for the
115
+ project repository or a product repository name from `projects.<id>.repos`. Recorded
116
+ when the task spans product repositories or the validation is assigned to one.
93
117
  command:
94
118
  type: string
95
119
  minLength: 1
96
120
  maxLength: 500
97
121
  status:
98
122
  type: string
99
- enum: [passed, failed, not_run]
123
+ enum: [passed, failed, not_run, not_applicable, requires_human]
124
+ description: >
125
+ Executor validations may use requires_human only for checks that cannot run in the
126
+ agent sandbox. The runner preserves those checks as human handoff items without
127
+ treating them as validation failures. Executor validations may use not_applicable
128
+ only when the repository does not meet the check's applicability conditions, and
129
+ must explain why in reason.
100
130
  summary:
101
131
  type: string
102
132
  maxLength: 1000
133
+ reason:
134
+ type: string
135
+ minLength: 1
136
+ maxLength: 1000
103
137
  allOf:
104
138
  - if:
105
139
  required: [source]
@@ -108,9 +142,49 @@ properties:
108
142
  const: runner
109
143
  then:
110
144
  required: [id]
145
+ - if:
146
+ required: [status]
147
+ properties:
148
+ status:
149
+ const: not_applicable
150
+ then:
151
+ required: [reason]
152
+ target_coverage:
153
+ description: >
154
+ Per-target disposition reported by an executor. On resume the runner requires complete
155
+ coverage of declared plan targets, or of the interrupted first attempt's lower-bound change
156
+ set when a register plan declares no targets. Changed targets identify a repository-relative
157
+ path; unchanged targets carry the reason preserved in the result.
158
+ type: array
159
+ maxItems: 1000
160
+ items:
161
+ type: object
162
+ additionalProperties: false
163
+ required: [target, status, reason]
164
+ properties:
165
+ target:
166
+ type: string
167
+ minLength: 1
168
+ maxLength: 1000
169
+ status:
170
+ type: string
171
+ enum: [changed, unchanged]
172
+ path:
173
+ type: string
174
+ minLength: 1
175
+ maxLength: 1000
176
+ reason:
177
+ type: string
178
+ maxLength: 1000
111
179
  final_message:
112
180
  type: string
113
181
  maxLength: 4000
182
+ block_reason:
183
+ description: >
184
+ Runner-derived failure or protection reason. Reporter prose never supplies this field.
185
+ type: string
186
+ minLength: 1
187
+ maxLength: 1000
114
188
  command:
115
189
  description: >
116
190
  Runner-executed deterministic Job command, stream references, and optional redacted,
@@ -143,20 +217,33 @@ properties:
143
217
  maxLength: 65536
144
218
  log_refs:
145
219
  type: array
146
- maxItems: 10
220
+ maxItems: 1000
147
221
  items:
148
222
  type: object
149
223
  additionalProperties: false
150
224
  required: [kind, path, bytes, truncated]
151
225
  properties:
152
226
  kind:
153
- enum: [agent-output-excerpt, command-stdout, command-stderr]
227
+ enum:
228
+ - agent-output-excerpt
229
+ - command-stdout
230
+ - command-stderr
231
+ - parent-validation-output
154
232
  path:
155
233
  type: string
156
234
  minLength: 1
157
235
  bytes:
158
236
  type: integer
159
237
  minimum: 0
160
- maximum: 65536
238
+ maximum: 5500000
161
239
  truncated:
162
240
  type: boolean
241
+ allOf:
242
+ - if:
243
+ properties:
244
+ kind:
245
+ const: parent-validation-output
246
+ else:
247
+ properties:
248
+ bytes:
249
+ maximum: 65536
@@ -2,8 +2,10 @@
2
2
  $schema: "https://json-schema.org/draft/2020-12/schema"
3
3
  title: "SpecDojo reporter output schema"
4
4
  description: >
5
- Strict structured output produced by the reporter pipeline stage. The runner validates this
6
- object before rendering result Markdown and owns all result frontmatter fields.
5
+ Structured output produced by the reporter pipeline stage. The runner validates this object
6
+ before combining it with evidence-derived facts and rendering result Markdown. The runner owns
7
+ all result frontmatter fields, outcome, block_reason, and the authoritative changed-file list.
8
+ Reporter descriptions carry evidence paths only as correlation keys.
7
9
  oneOf:
8
10
  - $ref: "#/$defs/edit"
9
11
  - $ref: "#/$defs/review"
@@ -12,43 +14,21 @@ $defs:
12
14
  type: string
13
15
  minLength: 1
14
16
  maxLength: 4000
15
- outcome:
16
- type: string
17
- enum: [complete, blocked]
18
17
  edit:
19
18
  type: object
20
19
  additionalProperties: false
21
- allOf:
22
- - if:
23
- properties:
24
- outcome:
25
- const: blocked
26
- then:
27
- properties:
28
- block_reason:
29
- type: string
30
- pattern: "\\S"
31
- else:
32
- properties:
33
- block_reason:
34
- type: string
35
- maxLength: 0
36
20
  required:
37
21
  - schema_version
38
22
  - mode
39
- - outcome
40
23
  - summary
41
24
  - changed_files
42
25
  - handoff
43
26
  - approach
44
- - block_reason
45
27
  properties:
46
28
  schema_version:
47
29
  const: 1
48
30
  mode:
49
31
  const: edit
50
- outcome:
51
- $ref: "#/$defs/outcome"
52
32
  summary:
53
33
  type: array
54
34
  minItems: 1
@@ -64,9 +44,7 @@ $defs:
64
44
  required: [path, summary]
65
45
  properties:
66
46
  path:
67
- type: string
68
- minLength: 1
69
- maxLength: 1000
47
+ $ref: "#/$defs/text"
70
48
  summary:
71
49
  $ref: "#/$defs/text"
72
50
  handoff:
@@ -76,76 +54,47 @@ $defs:
76
54
  $ref: "#/$defs/text"
77
55
  approach:
78
56
  $ref: "#/$defs/text"
79
- block_reason:
80
- type: string
81
- maxLength: 4000
82
57
  review:
83
58
  type: object
84
59
  additionalProperties: false
85
- allOf:
86
- - if:
87
- properties:
88
- outcome:
89
- const: blocked
90
- then:
91
- properties:
92
- block_reason:
93
- type: string
94
- pattern: "\\S"
95
- else:
96
- properties:
97
- block_reason:
98
- type: string
99
- maxLength: 0
100
60
  required:
101
61
  - schema_version
102
62
  - mode
103
- - outcome
104
- - viewpoint_results
105
- - findings
63
+ - grade_check
64
+ - rationale
65
+ - improvements
106
66
  - approach
107
- - recommendation
108
- - block_reason
67
+ - verdict
68
+ description: >
69
+ Review does not re-grade the deliverable. It records the stored grade result it relied on,
70
+ the rationale for the task completion judgement, improvement instructions, and a verdict
71
+ that maps one-to-one to the acceptance viewpoints of bps-task-completion.
109
72
  properties:
110
73
  schema_version:
111
74
  const: 1
112
75
  mode:
113
76
  const: review
114
- outcome:
115
- $ref: "#/$defs/outcome"
116
- viewpoint_results:
77
+ grade_check:
78
+ $ref: "#/$defs/text"
79
+ rationale:
117
80
  type: array
81
+ minItems: 1
118
82
  maxItems: 100
119
83
  items:
120
- type: object
121
- additionalProperties: false
122
- required: [id, result, evidence, notes]
123
- properties:
124
- id:
125
- type: string
126
- pattern: "^RVP-[0-9]{3}$"
127
- result:
128
- type: string
129
- enum: [pass, fail, unclear]
130
- evidence:
131
- type: array
132
- minItems: 1
133
- maxItems: 100
134
- items:
135
- $ref: "#/$defs/text"
136
- notes:
137
- type: string
138
- maxLength: 4000
139
- findings:
84
+ $ref: "#/$defs/text"
85
+ improvements:
140
86
  type: array
141
87
  maxItems: 100
142
88
  items:
143
89
  $ref: "#/$defs/text"
144
90
  approach:
145
91
  $ref: "#/$defs/text"
146
- recommendation:
147
- type: string
148
- enum: [approve, revise, reject]
149
- block_reason:
92
+ verdict:
150
93
  type: string
151
- maxLength: 4000
94
+ enum:
95
+ - complete
96
+ - complete-with-findings
97
+ - incomplete
98
+ - grade-stale
99
+ - grade-unavailable
100
+ - changed-during-review
@@ -0,0 +1,87 @@
1
+ $schema: "https://json-schema.org/draft/2020-12/schema"
2
+ title: "SpecDojo Glossary Schema"
3
+ type: object
4
+ additionalProperties: false
5
+ required:
6
+ - id
7
+ - title
8
+ - locale
9
+ - terms
10
+ properties:
11
+ id:
12
+ type: string
13
+ pattern: "^([a-z0-9-]+:)?gl-[a-z0-9-]+$"
14
+ description: "用語集ID(gl-...)"
15
+ title:
16
+ type: string
17
+ minLength: 1
18
+ description: "用語集名"
19
+ locale:
20
+ type: string
21
+ minLength: 1
22
+ description: "言語(例: ja / en)"
23
+ status:
24
+ type: string
25
+ enum: ["draft", "ready", "deprecated"]
26
+ description: "文書のステータス"
27
+ terms:
28
+ type: array
29
+ description: "用語のリスト"
30
+ items:
31
+ type: object
32
+ additionalProperties: false
33
+ required:
34
+ - id
35
+ - term
36
+ - definition
37
+ properties:
38
+ id:
39
+ type: string
40
+ pattern: "^tm-[a-z0-9-]+$"
41
+ description: "用語ID(tm-...)"
42
+ term:
43
+ type: string
44
+ minLength: 1
45
+ description: "用語(正式名称)"
46
+ englishName:
47
+ type: string
48
+ minLength: 1
49
+ description: "英語名(概念の英語表記)"
50
+ aliases:
51
+ type: array
52
+ items:
53
+ type: string
54
+ minLength: 1
55
+ description: "別名"
56
+ uniqueItems: true
57
+ definition:
58
+ type: string
59
+ minLength: 1
60
+ description: "定義(境界が分かる説明)"
61
+ notes:
62
+ type: string
63
+ minLength: 1
64
+ description: "補足・運用メモ"
65
+ category:
66
+ type: string
67
+ minLength: 1
68
+ description: "分類"
69
+ relatedTerms:
70
+ type: array
71
+ items:
72
+ type: string
73
+ pattern: "^tm-[a-z0-9-]+$"
74
+ description: "関連用語ID"
75
+ uniqueItems: true
76
+ source:
77
+ type: string
78
+ minLength: 1
79
+ description: "出典/参考"
80
+ status:
81
+ type: string
82
+ enum: ["official", "deprecated", "candidate"]
83
+ description: "用語のステータス"
84
+ example:
85
+ type: string
86
+ minLength: 1
87
+ description: "用例"
@@ -49,6 +49,18 @@ properties:
49
49
  content_hash:
50
50
  type: string
51
51
  pattern: "^[a-f0-9]{64}$"
52
+ source_hashes:
53
+ type: object
54
+ description: >
55
+ SHA-256 of the documents other than the graded document that the grade depended on, keyed
56
+ by source (catalog-entry, schedule, members, roles, deliverable:<local_id>,
57
+ dependency:<local_id>). grade list --changed-only and --dependency-changed compare them with
58
+ the current sources. Omitted in results recorded before source tracking.
59
+ propertyNames:
60
+ pattern: "^(catalog-entry|schedule|members|roles|deliverable:[a-z0-9][a-z0-9-]*|dependency:[a-z0-9][a-z0-9-]*)$"
61
+ additionalProperties:
62
+ type: string
63
+ pattern: "^[a-f0-9]{64}$"
52
64
  categories:
53
65
  type: object
54
66
  propertyNames:
@@ -104,6 +116,27 @@ properties:
104
116
  message:
105
117
  type: string
106
118
  minLength: 1
119
+ message_ja:
120
+ type: string
121
+ minLength: 1
122
+ level_corrections:
123
+ type: array
124
+ items:
125
+ type: object
126
+ additionalProperties: false
127
+ required: [viewpoint, original_level, corrected_level]
128
+ properties:
129
+ viewpoint:
130
+ type: string
131
+ pattern: "^vp-[a-z][a-z0-9-]*$"
132
+ original_level:
133
+ type: integer
134
+ minimum: 0
135
+ maximum: 4
136
+ corrected_level:
137
+ type: integer
138
+ minimum: 0
139
+ maximum: 4
107
140
  done_criteria:
108
141
  type: object
109
142
  $defs:
@@ -88,3 +88,30 @@ properties:
88
88
  type: [integer, "null"]
89
89
  reason:
90
90
  type: string
91
+ review:
92
+ type: object
93
+ additionalProperties: false
94
+ required: [plan_ref, result_ref, reviewed_at, branch]
95
+ properties:
96
+ plan_ref:
97
+ type: string
98
+ minLength: 1
99
+ result_ref:
100
+ type: string
101
+ minLength: 1
102
+ reviewed_at:
103
+ type: string
104
+ format: date-time
105
+ branch:
106
+ type: string
107
+ pattern: "^exec/"
108
+ verdict:
109
+ enum:
110
+ - complete
111
+ - complete-with-findings
112
+ - incomplete
113
+ - grade-stale
114
+ - grade-unavailable
115
+ - changed-during-review
116
+ reason:
117
+ type: string
@@ -154,6 +154,29 @@ $defs:
154
154
  minLength: 1
155
155
  proficiency:
156
156
  enum: [low, normal, high, expert]
157
+ review:
158
+ $ref: "#/$defs/review"
159
+ review:
160
+ description: >
161
+ Declares that the Run output is reviewed before integration. A Job with this mapping runs
162
+ in an exec worktree, is committed by the runner, reviewed, and merged only on an accepted
163
+ verdict, whether a routine or a manual exec run --job starts it. An empty mapping declares
164
+ the review without pinning agents. agent pins the review executor/reporter nicknames; the
165
+ resolution order is --review-by / --reporter-by, then this agent, then auto selection.
166
+ type: object
167
+ additionalProperties: false
168
+ properties:
169
+ agent:
170
+ type: object
171
+ additionalProperties: false
172
+ required: [executor]
173
+ properties:
174
+ executor:
175
+ type: string
176
+ pattern: "^[a-z0-9][a-z0-9_-]{0,62}$"
177
+ reporter:
178
+ type: string
179
+ pattern: "^[a-z0-9][a-z0-9_-]{0,62}$"
157
180
  commandTask:
158
181
  type: object
159
182
  additionalProperties: false
@@ -196,3 +219,5 @@ $defs:
196
219
  $ref: "#/$defs/pathScope"
197
220
  paths:
198
221
  $ref: "#/$defs/pathScope"
222
+ review:
223
+ $ref: "#/$defs/review"
@@ -31,8 +31,56 @@ properties:
31
31
  # Runner-owned integration stage (commit -> merge -> worktree removal). Absent in runs
32
32
  # recorded before the stage existed, so it is optional.
33
33
  integrate:
34
- $ref: "#/$defs/stage"
34
+ $ref: "#/$defs/integrateStage"
35
35
  $defs:
36
+ # The integrate stage of a project that declares product repositories (`repos`) also records
37
+ # the state of each repository. `repos` is optional; states without it are read as a single
38
+ # project repository integration.
39
+ integrateStage:
40
+ type: object
41
+ additionalProperties: false
42
+ required: [status, actor, attempts, started_at, completed_at, artifact_ref]
43
+ properties:
44
+ status:
45
+ type: string
46
+ enum: [pending, running, succeeded, failed, rate_limited, blocked]
47
+ actor:
48
+ type: [string, "null"]
49
+ attempts:
50
+ type: integer
51
+ minimum: 0
52
+ started_at:
53
+ type: [string, "null"]
54
+ format: date-time
55
+ completed_at:
56
+ type: [string, "null"]
57
+ format: date-time
58
+ artifact_ref:
59
+ type: [string, "null"]
60
+ # Keys are repository names (`project` for the project repository) in integration order.
61
+ repos:
62
+ type: object
63
+ propertyNames:
64
+ pattern: "^[a-z0-9-]+$"
65
+ additionalProperties:
66
+ $ref: "#/$defs/repoIntegration"
67
+ repoIntegration:
68
+ type: object
69
+ additionalProperties: false
70
+ required: [status, commit, merged_at]
71
+ properties:
72
+ status:
73
+ type: string
74
+ enum: [pending, merged, unchanged, failed]
75
+ # Merge commit on the integration target. Null for the project repository (the merge commit
76
+ # contains this state) and for repositories that are not merged.
77
+ commit:
78
+ type: [string, "null"]
79
+ merged_at:
80
+ type: [string, "null"]
81
+ format: date-time
82
+ error:
83
+ type: string
36
84
  stage:
37
85
  type: object
38
86
  additionalProperties: false