specdojo 0.2.1 → 0.3.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.github/agents/specdojo-orchestrator.md +165 -0
- package/CHANGELOG.md +298 -0
- package/README.md +92 -42
- package/dist/agent-response.js +20 -0
- package/dist/agent.js +4 -4
- package/dist/build-command.js +28 -8
- package/dist/catalog-build-references.js +144 -0
- package/dist/catalog-build-render.js +144 -0
- package/dist/catalog-build.js +13 -290
- package/dist/catalog-generate.js +6 -9
- package/dist/catalog-plan-generate.js +2 -2
- package/dist/catalog-plan.js +6 -6
- package/dist/catalog-scaffold.js +4 -4
- package/dist/catalog.js +2 -2
- package/dist/dashboard-exec-records.js +105 -0
- package/dist/dashboard-routines.js +255 -0
- package/dist/dashboard-shared.js +14 -0
- package/dist/dashboard-timeline.js +175 -0
- package/dist/dashboard.js +31 -444
- package/dist/deliverable-trash.js +3 -3
- package/dist/devcontainer-command.js +43 -0
- package/dist/devcontainer-scaffold.js +165 -0
- package/dist/doc-index.js +3 -3
- package/dist/exec-agent-config.js +107 -9
- package/dist/exec-agent-git-state.js +18 -0
- package/dist/exec-agent-protected-config.js +46 -8
- package/dist/exec-commands.js +557 -0
- package/dist/exec-core.js +457 -0
- package/dist/exec-evidence.js +254 -11
- package/dist/exec-handoff.js +336 -0
- package/dist/exec-parent-validation.js +317 -43
- package/dist/exec-pipeline-state.js +74 -9
- package/dist/exec-plans-core.js +693 -0
- package/dist/exec-plans-generation.js +206 -0
- package/dist/exec-plans-storage.js +131 -0
- package/dist/exec-plans.js +3 -1016
- package/dist/exec-protection-handoff.js +43 -2
- package/dist/exec-provider-scaffold.js +247 -15
- package/dist/exec-register-resume.js +65 -19
- package/dist/exec-register.js +9 -3
- package/dist/exec-repo-integration-git.js +23 -0
- package/dist/exec-repo-integration-sync.js +264 -0
- package/dist/exec-repo-integration.js +534 -0
- package/dist/exec-repo-trace.js +182 -0
- package/dist/exec-reporter-output.js +206 -0
- package/dist/exec-reporter.js +525 -248
- package/dist/exec-results.js +103 -71
- package/dist/exec-run-agent-pipeline.js +256 -0
- package/dist/exec-run-agent.js +531 -0
- package/dist/exec-run-in-place.js +541 -0
- package/dist/exec-run-job.js +717 -0
- package/dist/exec-run-lifecycle-commands.js +522 -0
- package/dist/exec-run-lock.js +110 -107
- package/dist/exec-run-mode-shared.js +140 -0
- package/dist/exec-run-register-command.js +244 -0
- package/dist/exec-run-register-core.js +386 -0
- package/dist/exec-run-register-mode.js +206 -0
- package/dist/exec-run-register-resume.js +393 -0
- package/dist/exec-run-register-state.js +322 -0
- package/dist/exec-run-register-worktree.js +509 -0
- package/dist/exec-run-schedule-mode.js +294 -0
- package/dist/exec-run-schedule-prepare.js +353 -0
- package/dist/exec-run-schedule-task.js +572 -0
- package/dist/exec-run-shared.js +399 -0
- package/dist/exec-run.js +11 -4953
- package/dist/exec-shared.js +9 -2
- package/dist/exec-slot-lock.js +242 -0
- package/dist/exec-task-repos.js +415 -0
- package/dist/exec-trial-commands.js +558 -0
- package/dist/exec-trial-core.js +371 -0
- package/dist/exec-trial.js +2 -895
- package/dist/exec-worktree-command.js +87 -43
- package/dist/exec-worktree-ops-commit.js +707 -0
- package/dist/exec-worktree-ops-lifecycle.js +292 -0
- package/dist/exec-worktree-ops-merge.js +303 -0
- package/dist/exec-worktree-ops.js +3 -847
- package/dist/exec-worktree.js +146 -31
- package/dist/exec.js +2 -999
- package/dist/frontmatter-namespace.js +2 -2
- package/dist/grade-apply.js +734 -0
- package/dist/grade-command-apply.js +250 -0
- package/dist/grade-command-inspect.js +138 -0
- package/dist/grade-command-plan.js +101 -0
- package/dist/grade-command-shared.js +68 -0
- package/dist/grade-core.js +307 -0
- package/dist/grade-markdown.js +274 -0
- package/dist/grade-pipeline-state.js +184 -0
- package/dist/grade-plan.js +507 -0
- package/dist/grade-result.js +133 -5
- package/dist/grade-target-discovery.js +265 -0
- package/dist/grade-targets.js +432 -0
- package/dist/grade.js +14 -2451
- package/dist/init-command.js +443 -0
- package/dist/job-definition.js +670 -0
- package/dist/job.js +64 -578
- package/dist/kata-command.js +2 -2
- package/dist/orchestrator.js +213 -0
- package/dist/register-command-types.js +1 -0
- package/dist/register-core.js +363 -0
- package/dist/register-create-commands.js +245 -0
- package/dist/register-event-merge.js +169 -0
- package/dist/register-events.js +4 -4
- package/dist/register-item.js +13 -7
- package/dist/register-maintenance-commands.js +187 -0
- package/dist/register-migration.js +268 -0
- package/dist/register-renumber.js +314 -0
- package/dist/register-transition-commands.js +248 -0
- package/dist/register-update.js +230 -0
- package/dist/register-views.js +256 -0
- package/dist/register.js +175 -1975
- package/dist/review-grade.js +252 -0
- package/dist/review-plan.js +114 -4
- package/dist/review-types.js +40 -1
- package/dist/routine-definition.js +401 -0
- package/dist/routine.js +73 -402
- package/dist/schedule-approach.js +2 -2
- package/dist/schedule-build.js +2 -2
- package/dist/schedule-strategy-generate-document.js +273 -0
- package/dist/schedule-strategy-generate-scope.js +199 -0
- package/dist/schedule-strategy-generate.js +9 -473
- package/dist/schedule.js +19 -6
- package/dist/specdojo-config.js +465 -20
- package/dist/specdojo-gitignore.js +135 -0
- package/dist/specdojo.js +6 -0
- package/dist/viewpoint-document-kinds-check.js +128 -0
- package/dist/yaml-pages.js +4 -4
- package/dist/yaml.js +28 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +348 -90
- package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +51 -17
- package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +7 -5
- package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +29 -31
- package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +34 -55
- package/docs/ja/specdojo/exec-templates/xrp-job-template.md +54 -0
- package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +28 -37
- package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +29 -34
- package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +30 -30
- package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +29 -34
- package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +29 -34
- package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +29 -34
- package/docs/ja/specdojo/exec-templates/xrp-template.md +29 -28
- package/docs/ja/specdojo/exec-templates/xrr-template.md +11 -9
- package/docs/ja/specdojo/guides/docs-editing-guide.md +20 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +103 -70
- package/docs/ja/specdojo/guides/exec-config-guide.md +93 -49
- package/docs/ja/specdojo/guides/exec-operation-guide.md +124 -27
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +40 -11
- package/docs/ja/specdojo/guides/kata-guide.md +4 -4
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +45 -22
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +1 -1
- package/docs/ja/specdojo/guides/practice-system-composition-guide.md +13 -13
- package/docs/ja/specdojo/guides/quick-start-guide.md +260 -30
- package/docs/ja/specdojo/guides/register-operation-guide.md +31 -14
- package/docs/ja/specdojo/guides/release-v0-3-0-migration-guide.md +264 -0
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +22 -1
- package/docs/ja/specdojo/guides/review-guide.md +195 -158
- package/docs/ja/specdojo/guides/routine-operation-guide.md +75 -10
- package/docs/ja/specdojo/guides/ryu-guide.md +32 -30
- package/docs/ja/specdojo/guides/schedule-design-guide.md +10 -10
- package/docs/ja/specdojo/guides/schedule-operation-guide.md +1 -1
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +58 -33
- package/docs/ja/specdojo/guides/use-case-guide.md +3 -3
- package/docs/ja/specdojo/guides/waza-guide.md +15 -2
- package/docs/ja/specdojo/index.md +2 -2
- package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +5 -5
- package/docs/ja/specdojo/recipes/bps-recipe.md +213 -0
- package/docs/ja/specdojo/recipes/pm-members-recipe.md +52 -117
- package/docs/ja/specdojo/references/command-reference.md +335 -92
- package/docs/ja/specdojo/references/deliverables-reference.md +1 -1
- package/docs/ja/specdojo/references/directory-layout-reference.md +13 -9
- package/docs/ja/specdojo/references/specdojo-config-reference.md +107 -24
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +132 -220
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +6 -44
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +2 -0
- package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +0 -87
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +61 -39
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +0 -87
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +1 -33
- package/docs/ja/specdojo/rulebooks/opd-rulebook.md +0 -137
- package/docs/ja/specdojo/rulebooks/opr-rulebook.md +0 -247
- package/docs/ja/specdojo/rulebooks/otp-rulebook.md +0 -83
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +4 -2
- package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +78 -150
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +5 -4
- package/docs/ja/specdojo/rulebooks/sch-rulebook.md +1 -1
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +0 -11
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +0 -61
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +2 -47
- package/docs/ja/specdojo/samples/bps-sample.md +74 -21
- package/docs/ja/specdojo/samples/gl-sample.yaml +17 -1
- package/docs/ja/specdojo/samples/ifx-index-sample.yaml +28 -0
- package/docs/ja/specdojo/samples/pm-members-sample.yaml +2 -67
- package/docs/ja/specdojo/samples/pm-organization-sample.md +8 -7
- package/docs/ja/specdojo/samples/pm-raci-sample.md +1 -1
- package/docs/ja/specdojo/samples/tml-sample.yaml +40 -0
- package/docs/ja/specdojo/standards/document-metadata-standard.md +21 -16
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +14 -14
- package/docs/ja/specdojo/standards/job-definition-standard.md +37 -17
- package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +37 -32
- package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -1
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +21 -11
- package/docs/ja/specdojo/templates/agent-members-template.yaml +25 -0
- package/docs/ja/specdojo/templates/bps-template.md +91 -0
- package/docs/ja/specdojo/templates/pm-members-template.yaml +2 -59
- package/docs/specdojo/schemas/v1/agent-members.schema.yaml +76 -0
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +4 -2
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +55 -2
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +93 -6
- package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +27 -78
- package/docs/specdojo/schemas/v1/gl.schema.yaml +87 -0
- package/docs/specdojo/schemas/v1/grade-result.schema.yaml +33 -0
- package/docs/specdojo/schemas/v1/job-run.schema.yaml +27 -0
- package/docs/specdojo/schemas/v1/job.schema.yaml +25 -0
- package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +49 -1
- package/docs/specdojo/schemas/v1/pm-members.schema.yaml +9 -169
- package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +100 -10
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +13 -0
- package/docs/specdojo/schemas/v1/routine-run.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/routine.schema.yaml +7 -0
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +110 -0
- package/package.json +17 -12
- package/templates/antigravity/README.md +29 -4
- package/templates/antigravity/{pm-members-snippet.yaml → agent-members-snippet.yaml} +8 -2
- package/templates/antigravity/exec-defaults-snippet.yaml +10 -7
- package/templates/antigravity/orchestrator.md +18 -7
- package/templates/antigravity/settings.global.json +55 -0
- package/templates/claude/agents/claude-executor.md +14 -0
- package/templates/claude/agents/claude-reporter.md +16 -0
- package/templates/claude/agents/specdojo-orchestrator.md +18 -7
- package/templates/claude/settings.edit.json +27 -1
- package/templates/codex/README.md +5 -4
- package/templates/codex/agents/specdojo-orchestrator.toml +18 -7
- package/templates/codex/orchestrator.md +18 -7
- package/templates/copilot/README.md +7 -5
- package/templates/copilot/{pm-members-snippet.yaml → agent-members-snippet.yaml} +4 -2
- package/templates/devcontainer/devcontainer.json +27 -0
- package/templates/devcontainer/emacs/init.el +88 -0
- package/templates/devcontainer/post-create.sh +62 -0
- package/templates/init-agent-members.yaml +200 -0
- package/templates/init-exec-defaults.yaml +74 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +18 -7
- package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +0 -7
- 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
|
|
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:
|
|
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:
|
|
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:
|
|
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
|
-
|
|
6
|
-
|
|
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
|
-
|
|
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
|
-
-
|
|
104
|
-
-
|
|
105
|
-
-
|
|
63
|
+
- grade_check
|
|
64
|
+
- rationale
|
|
65
|
+
- improvements
|
|
106
66
|
- approach
|
|
107
|
-
-
|
|
108
|
-
|
|
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
|
-
|
|
115
|
-
$ref: "#/$defs/
|
|
116
|
-
|
|
77
|
+
grade_check:
|
|
78
|
+
$ref: "#/$defs/text"
|
|
79
|
+
rationale:
|
|
117
80
|
type: array
|
|
81
|
+
minItems: 1
|
|
118
82
|
maxItems: 100
|
|
119
83
|
items:
|
|
120
|
-
|
|
121
|
-
|
|
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
|
-
|
|
147
|
-
type: string
|
|
148
|
-
enum: [approve, revise, reject]
|
|
149
|
-
block_reason:
|
|
92
|
+
verdict:
|
|
150
93
|
type: string
|
|
151
|
-
|
|
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/
|
|
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
|