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
@@ -1,252 +1,92 @@
1
1
  # pm-members.schema.yaml
2
2
  $schema: "https://json-schema.org/draft/2020-12/schema"
3
- title: "SpecDojo Project Member Roster schema"
3
+ title: "SpecDojo Human Member Roster schema"
4
4
  type: object
5
5
  $comment: >
6
- Schema for project member roster files:
7
- docs/ja/projects/<project_id>/030-project-management/pm-members.yaml
8
- Manages the mapping from --by <nickname> (used in specdojo exec events) to
9
- display name, contact info, roles, and actor type. nickname is immutable once
10
- recorded in the event log.
11
-
6
+ Schema for project-local human rosters. Runnable agent definitions belong in the
7
+ repository-wide protected agent-members.yaml file.
12
8
  additionalProperties: false
13
-
14
- required:
15
- - id
16
- - type
17
- - status
18
- - title
19
- - rulebook
20
- - version
21
- - project_id
22
- - members
23
-
9
+ required: [id, type, status, title, rulebook, version, project_id, members]
24
10
  properties:
25
11
  id:
26
12
  type: string
27
13
  pattern: "^[a-z0-9][a-z0-9-:]*$"
28
- description: "Document metadata ID (e.g., prj-0001:pm-members)."
29
-
30
14
  type:
31
- type: string
32
15
  const: project
33
- description: "Document type. Must be 'project'."
34
-
35
16
  status:
36
- type: string
37
17
  enum: [draft, ready, deprecated]
38
- description: "Document status."
39
-
40
18
  title:
41
19
  type: string
42
20
  minLength: 1
43
- description: "Document title. Equivalent to the Markdown H1; used as the heading of the generated display page."
44
-
45
21
  rulebook:
46
22
  type: string
47
23
  pattern: "^((?:[a-z][a-z0-9-]*:)?[a-z0-9][a-z0-9-]*-rulebook|none)$"
48
- description: "Rulebook ID this document conforms to. Use none only when no rulebook exists."
49
-
50
24
  based_on:
51
25
  type: array
52
- description: "Optional source document IDs."
53
26
  items:
54
27
  type: string
55
28
  pattern: "^[a-z0-9][a-z0-9-:]*$"
56
29
  uniqueItems: true
57
-
58
30
  supersedes:
59
31
  type: array
60
- description: "Optional superseded document IDs."
61
32
  items:
62
33
  type: string
63
34
  pattern: "^[a-z0-9][a-z0-9-:]*$"
64
35
  uniqueItems: true
65
-
66
36
  version:
67
37
  type: integer
68
38
  minimum: 1
69
- description: "Schema/data version."
70
-
71
39
  project_id:
72
40
  type: string
73
41
  minLength: 1
74
- description: "Project identifier (e.g., prj-0001)."
75
-
76
42
  members:
77
43
  type: array
78
- minItems: 1
79
- description: "List of project members (human or agent)."
80
44
  items:
81
- $ref: "#/$defs/Member"
45
+ $ref: "#/$defs/HumanMember"
82
46
  uniqueItems: true
83
-
84
47
  rules:
85
48
  type: array
86
- description: "Optional operational rules for using this member roster."
87
49
  items:
88
50
  type: string
89
51
  minLength: 1
90
52
  uniqueItems: true
91
-
92
53
  $defs:
93
54
  RoleLabel:
94
55
  type: string
95
- description: "Role code. Must exist in pm-roles.yaml (e.g., PO, PM, BA, ARC, DEV, QE, UX, OPS)."
96
56
  pattern: "^[A-Z]{2,4}$"
97
-
98
- Member:
57
+ HumanMember:
99
58
  type: object
100
59
  additionalProperties: false
101
- required:
102
- - nickname
103
- - display_name
104
- - roles
105
- - type
60
+ required: [nickname, display_name, roles, type]
106
61
  properties:
107
62
  nickname:
108
63
  type: string
109
- description: >
110
- Immutable identifier used in `specdojo exec --by <nickname>`. Once
111
- recorded in the event log, this value must not change.
112
64
  pattern: "^[a-z0-9][a-z0-9_-]{0,62}$"
113
- minLength: 1
114
-
115
65
  display_name:
116
66
  type: string
117
- description: "Human-readable name (person's name or agent display name)."
118
67
  minLength: 1
119
-
120
68
  email:
121
- description: "Contact email address. Use null for agents or when not applicable."
122
69
  oneOf:
123
70
  - type: string
124
71
  format: email
125
72
  - type: "null"
126
-
127
73
  roles:
128
74
  type: array
129
- description: "Role codes this member corresponds to. Use empty array for cross-role (general-purpose) agents."
130
75
  items:
131
76
  $ref: "#/$defs/RoleLabel"
132
77
  uniqueItems: true
133
-
134
78
  type:
135
- type: string
136
- description: "Actor type: human for a person, agent for an automated agent
137
- (e.g., GitHub Copilot)."
138
- enum: ["human", "agent"]
139
-
140
- provider:
141
- type: string
142
- description: >
143
- Agent runtime provider family. Use this to identify which external CLI
144
- executes the member command.
145
- enum: ["opencode", "claude", "codex", "copilot", "antigravity", "custom"]
146
-
79
+ const: human
147
80
  persona:
148
81
  type: string
149
82
  minLength: 1
150
- description: "Optional working persona label used to describe the member's style
151
- (e.g., value-first, analysis-first, risk-averse)."
152
-
153
83
  focus:
154
84
  type: array
155
- description: "Optional list of emphasis areas used to steer the member's
156
- execution or review perspective."
157
85
  items:
158
86
  type: string
159
87
  minLength: 1
160
88
  uniqueItems: true
161
-
162
- capabilities:
163
- type: array
164
- description: >
165
- Capabilities this agent can perform. Required for type: agent.
166
- See exec-common.schema.yaml for core values (exec, review, web_search).
167
- items:
168
- $ref: "./exec-common.schema.yaml#/$defs/Capability"
169
- uniqueItems: true
170
-
171
- proficiency:
172
- $ref: "./exec-common.schema.yaml#/$defs/Proficiency"
173
- description: >
174
- Agent proficiency level. Used by sch-strategy phase requirements to filter
175
- agents by quality tier. Required for type: agent.
176
-
177
- priority:
178
- type: integer
179
- minimum: 1
180
- description: >
181
- Tiebreaker priority within agents that share the same proficiency and
182
- have equal extra-capabilities count. Lower value = tried first.
183
- Required for type: agent.
184
-
185
- command:
186
- type: string
187
- minLength: 1
188
- description: >
189
- Optional override of the launch command. Normally the command is resolved
190
- from providers.<provider>.command_template in .specdojo/exec-defaults.yaml
191
- using this member's attributes; set command only for configurations without
192
- a template (e.g. provider: custom). Must not contain credentials or
193
- machine-local paths.
194
-
195
- mode:
196
- type: string
197
- enum: ["edit", "review", "report"]
198
- description: >
199
- Launch profile for this agent.
200
- edit: executor profile for deliverable creation and editing tasks.
201
- review: executor profile for read-only deliverable review tasks.
202
- report: reporter profile for turning evidence into a structured result without writing files.
203
- For executor and legacy agents, exec run matches edit/review against the task mode.
204
- Reporter eligibility is determined by stage_role: reporter instead, so report does not
205
- restrict the reporter to edit or review tasks. Omit for a mode-agnostic member.
206
-
207
- stage_role:
208
- type: string
209
- enum: ["executor", "reporter"]
210
- description: >
211
- Optional pipeline-stage responsibility for this agent.
212
- executor and reporter agents are selected only for the matching agent_pipeline stage.
213
- Omit for legacy single-agent execution; members without this field are not pipeline candidates.
214
-
215
- disabled:
216
- type: boolean
217
- description: >
218
- Optional. When true, this agent is temporarily excluded from
219
- exec run --auto candidate selection (including rate-limit fallback).
220
- Use to isolate a single provider during testing (e.g. verifying one
221
- agent's rate-limit handling) without deleting the member definition.
222
- Absent or false means the agent is selectable as usual.
223
-
224
89
  scheduler_strategy:
225
- type: string
226
- description: "Optional default scheduler strategy used when this member runs
227
- `specdojo exec scheduler` without `--strategy`."
228
- enum: ["critical-first", "dependency-first", "fifo", "manual"]
229
-
90
+ enum: [critical-first, dependency-first, fifo, manual]
230
91
  note:
231
92
  type: string
232
- description: "Optional free-text note (e.g., availability, timezone,
233
- responsibilities)."
234
-
235
- allOf:
236
- - if:
237
- properties:
238
- type:
239
- const: agent
240
- then:
241
- required:
242
- - provider
243
- - capabilities
244
- - proficiency
245
- - priority
246
- - if:
247
- required:
248
- - stage_role
249
- then:
250
- properties:
251
- type:
252
- const: agent
@@ -132,7 +132,7 @@ properties:
132
132
 
133
133
  verdict_definitions:
134
134
  type: array
135
- description: "Review verdict vocabulary."
135
+ description: "Review verdict vocabulary for task completion (same values as the review result verdict)."
136
136
  items:
137
137
  $ref: "#/$defs/VerdictDefinition"
138
138
 
@@ -224,8 +224,19 @@ $defs:
224
224
  properties:
225
225
  id:
226
226
  type: string
227
- enum: [pass, conditional_pass, changes_requested, blocked]
228
- description: "Verdict identifier."
227
+ enum:
228
+ [
229
+ complete,
230
+ complete-with-findings,
231
+ incomplete,
232
+ grade-stale,
233
+ grade-unavailable,
234
+ changed-during-review,
235
+ ]
236
+ description: >
237
+ Review verdict identifier for task completion. Shares the vocabulary of the review
238
+ result verdict. The legacy values pass, conditional_pass, changes_requested, and blocked
239
+ are rejected by the loader with the replacement value.
229
240
  description:
230
241
  type: string
231
242
  minLength: 1
@@ -234,7 +245,7 @@ $defs:
234
245
  Viewpoint:
235
246
  type: object
236
247
  additionalProperties: false
237
- required: [id, role, category, title, check, evidence, default_severity, evaluation, continuous]
248
+ required: [id, role, category, title, check, evidence, default_severity, evaluation]
238
249
  properties:
239
250
  id:
240
251
  type: string
@@ -272,11 +283,17 @@ $defs:
272
283
  enum: [blocker, major, minor, note]
273
284
  description: "Default finding severity when this viewpoint fails."
274
285
  evaluation:
275
- enum: [deterministic, agent, human]
276
- description: "Judgment layer responsible for this viewpoint."
277
- continuous:
278
- type: boolean
279
- description: "Whether grade evaluates this viewpoint continuously."
286
+ enum: [deterministic, referential, discretionary]
287
+ description: >
288
+ Where the criterion that decides correctness lives. deterministic: machine-readable rules
289
+ (schema, lint) decide and grade judges it in code. referential: the check compares the
290
+ document with other documents or a declared definition (for example done_criteria), or
291
+ states the criterion itself; grade delegates it to an agent. discretionary: no criterion is
292
+ written and the judge supplies what is sufficient (necessary range, usable granularity,
293
+ understandable); grade delegates it to an agent without stability guarantees. This field
294
+ selects the judgment path only and does not decide grade scope. Every viewpoint is graded;
295
+ grade_targets and document_kinds decide which documents it applies to.
296
+ The removed values agent and human are rejected.
280
297
  grade_targets:
281
298
  type: array
282
299
  minItems: 1
@@ -284,6 +301,71 @@ $defs:
284
301
  items:
285
302
  enum: [kata, deliverable]
286
303
  description: "Optional grade target restriction; omitted means both targets."
304
+ comparison_sources:
305
+ type: array
306
+ minItems: 1
307
+ uniqueItems: true
308
+ items:
309
+ type: string
310
+ pattern: "^(catalog-entry|dependencies|schedule|members|roles|deliverable:[a-z0-9][a-z0-9-]*)$"
311
+ description: >
312
+ Documents other than the graded document that this viewpoint compares against. grade
313
+ records their hashes in the grade result (source_hashes) and grade list --changed-only
314
+ selects the document again when any of them changes. catalog-entry: the document's own
315
+ deliverable catalog entry. dependencies: the deliverables listed in depends_on.
316
+ schedule: the project schedule directory. members / roles: the project members_path /
317
+ roles_path file. deliverable:<local_id>: one catalog deliverable. Omitted means the
318
+ viewpoint judges the graded document alone.
319
+ document_kinds:
320
+ $ref: "#/$defs/DocumentKindApplicability"
321
+
322
+ DocumentKindApplicability:
323
+ type: object
324
+ additionalProperties: false
325
+ minProperties: 1
326
+ description: >
327
+ Optional rulebook-based applicability shared by grade and review. A document's kind is its
328
+ rulebook ID. Rulebooks use their own ID and templates use the rulebook in frontmatter_template.
329
+ Documents with rulebook none or no resolvable rulebook are unclassified.
330
+ properties:
331
+ include:
332
+ type: array
333
+ minItems: 1
334
+ uniqueItems: true
335
+ description: "Rulebook IDs to which this viewpoint applies; omitted means all classified kinds."
336
+ items:
337
+ $ref: "#/$defs/RulebookId"
338
+ exclude:
339
+ type: array
340
+ minItems: 1
341
+ uniqueItems: true
342
+ description: "Rulebook IDs excluded from this viewpoint."
343
+ items:
344
+ $ref: "#/$defs/RulebookId"
345
+ unclassified:
346
+ enum: [include, exclude]
347
+ description: "How to handle rulebook none or missing rulebook; omitted defaults to include."
348
+ confirmed_default:
349
+ type: array
350
+ minItems: 1
351
+ uniqueItems: true
352
+ description: >
353
+ Rulebook IDs reviewed and left at the unlisted outcome (applied when exclude is used,
354
+ not applied when include is used). This records the decision for the coverage check
355
+ and does not change applicability. A rulebook must not also appear in include or exclude.
356
+ items:
357
+ $ref: "#/$defs/RulebookId"
358
+ not:
359
+ required: [include, exclude]
360
+ dependentSchemas:
361
+ confirmed_default:
362
+ anyOf:
363
+ - required: [include]
364
+ - required: [exclude]
365
+
366
+ RulebookId:
367
+ type: string
368
+ pattern: "^(?:[a-z][a-z0-9-]*:)?[a-z0-9][a-z0-9-]*-rulebook$"
287
369
 
288
370
  GradeRubric:
289
371
  type: object
@@ -317,7 +399,11 @@ $defs:
317
399
  type: string
318
400
  minLength: 1
319
401
  review_verdict:
320
- enum: [pass, conditional_pass, changes_requested]
402
+ enum: [complete, complete-with-findings, incomplete]
403
+ description: >
404
+ Starting-point review verdict suggested by this grade level (review input rule).
405
+ Freshness, unavailable grades, and changes during review are not derived from
406
+ a level.
321
407
  weights:
322
408
  type: object
323
409
  additionalProperties: false
@@ -330,6 +416,10 @@ $defs:
330
416
 
331
417
  CategoryWeights:
332
418
  type: object
419
+ description: >
420
+ Weight per category. Every category used by a viewpoint needs a weight because every
421
+ viewpoint is graded. Categories with no applicable viewpoint for a document are left out of
422
+ that document's weighted average.
333
423
  propertyNames:
334
424
  pattern: "^[a-z][a-z0-9_-]*$"
335
425
  additionalProperties:
@@ -143,6 +143,19 @@ properties:
143
143
  rejection. Omit the key while it is undetermined; the details stay in
144
144
  the body (list column: 結論).
145
145
 
146
+ targets:
147
+ type: array
148
+ items:
149
+ type: string
150
+ minLength: 1
151
+ minItems: 1
152
+ 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.
158
+
146
159
  $defs:
147
160
  ItemType:
148
161
  type: string
@@ -34,3 +34,6 @@ properties:
34
34
  items:
35
35
  type: string
36
36
  pattern: "^JBR-[A-Za-z0-9-]+$"
37
+ reason:
38
+ type: string
39
+ minLength: 1
@@ -68,6 +68,13 @@ $defs:
68
68
  type: object
69
69
  additionalProperties:
70
70
  type: string
71
+ commit:
72
+ type: boolean
73
+ description: >
74
+ Compatibility only; not recommended for new routines. Run the Job in an exec worktree,
75
+ commit its outputs, review them, and merge only an accepted Run. Declare task.review in
76
+ the Job Definition instead. When the Job declares task.review, the Job wins and the Run
77
+ is reviewed even if commit is false or omitted.
71
78
  specdojoAction:
72
79
  description: >
73
80
  Runs a specdojo subcommand directly with --project appended, without taking the exec run
@@ -0,0 +1,110 @@
1
+ $schema: "https://json-schema.org/draft/2020-12/schema"
2
+ title: SpecDojo Config (.specdojo/specdojo.config.json)
3
+ description: >-
4
+ Shape of .specdojo/specdojo.config.json. The CLI (src/specdojo-config.ts loadConfig) is the
5
+ authority for checks that a schema cannot express: repository names that collide with a
6
+ project id and repository paths that do not exist.
7
+ type: object
8
+ required:
9
+ - version
10
+ - projects
11
+ properties:
12
+ version:
13
+ const: 1
14
+ current_project:
15
+ type: string
16
+ minLength: 1
17
+ agent_members_path:
18
+ description: Repository-wide protected agent registry path.
19
+ type: string
20
+ pattern: "^(?!.*(?:^|/)\\.\\.(?:/|$))\\.specdojo/.+\\.ya?ml$"
21
+ projects:
22
+ type: object
23
+ additionalProperties:
24
+ $ref: "#/$defs/Project"
25
+ $defs:
26
+ NonEmptyString:
27
+ type: string
28
+ pattern: "\\S"
29
+ Project:
30
+ type: object
31
+ properties:
32
+ base_path:
33
+ type: string
34
+ catalog_path:
35
+ type: string
36
+ schedule_path:
37
+ $ref: "#/$defs/NonEmptyString"
38
+ execution_path:
39
+ $ref: "#/$defs/NonEmptyString"
40
+ timeline_path:
41
+ type: string
42
+ members_path:
43
+ type: string
44
+ roles_path:
45
+ type: string
46
+ viewpoints_path:
47
+ type: string
48
+ project_register_path:
49
+ type: string
50
+ routines_path:
51
+ type: string
52
+ jobs_path:
53
+ type: string
54
+ project_context:
55
+ type: array
56
+ items:
57
+ $ref: "#/$defs/NonEmptyString"
58
+ repos:
59
+ description: >-
60
+ Product repositories that tasks of this project may change. The project repository is
61
+ implicit and is not declared. Names must be unique within the project.
62
+ type: array
63
+ items:
64
+ $ref: "#/$defs/Repo"
65
+ run:
66
+ $ref: "#/$defs/Run"
67
+ Repo:
68
+ type: object
69
+ additionalProperties: false
70
+ required:
71
+ - name
72
+ - path
73
+ properties:
74
+ name:
75
+ description: >-
76
+ Prefix used in targets/paths as <name>:<path>. "project" is reserved for the project
77
+ repository worktree (<worktree_base>/<task-id>/project/).
78
+ type: string
79
+ pattern: "^[a-z0-9-]+$"
80
+ not:
81
+ const: project
82
+ path:
83
+ description: Repository root, relative to the SpecDojo root.
84
+ type: string
85
+ pattern: "\\S"
86
+ not:
87
+ pattern: "^(/|[A-Za-z]:[\\\\/])"
88
+ integration_branch:
89
+ description: Branch exec integrates into. Omit to use the repository's current branch.
90
+ $ref: "#/$defs/NonEmptyString"
91
+ setup:
92
+ description: Whether exec installs dependencies and builds in the repository worktree.
93
+ type: object
94
+ additionalProperties: false
95
+ properties:
96
+ install:
97
+ type: boolean
98
+ build:
99
+ type: boolean
100
+ Run:
101
+ type: object
102
+ properties:
103
+ exec_defaults:
104
+ type: string
105
+ agent_config:
106
+ type: string
107
+ worktree_base:
108
+ type: string
109
+ register_date_timezone:
110
+ type: string
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "specdojo",
3
- "version": "0.2.1",
4
- "description": "SpecDojo CLI, schemas, and documentation for specification-driven execution workflows.",
3
+ "version": "0.3.0",
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",
7
7
  "private": false,
@@ -16,7 +16,9 @@
16
16
  "docs/specdojo",
17
17
  "!docs/specdojo/**/generated/**",
18
18
  "templates",
19
+ ".github/agents/specdojo-orchestrator.md",
19
20
  "README.md",
21
+ "CHANGELOG.md",
20
22
  "LICENSE"
21
23
  ],
22
24
  "repository": {
@@ -52,6 +54,7 @@
52
54
  "prepack": "npm run build",
53
55
  "specdojo:build": "npm run build",
54
56
  "vscode:install": "npm --prefix packages/vscode-specdojo ci",
57
+ "update:agents": "node tools/update-agent-clis.mjs",
55
58
  "vscode:build": "npm --prefix packages/vscode-specdojo run compile",
56
59
  "vscode:package": "npm --prefix packages/vscode-specdojo run package",
57
60
  "exec:watch-claude-log": "tools/exec/watch-claude-log.sh",
@@ -84,7 +87,7 @@
84
87
  "lint:md:fix": "node packages/docs-lint/bin/specdojo-docs-lint.js markdownlint --fix '**/*.md'",
85
88
  "format": "prettier --write '**/*.{ts,js,mjs,cjs,json,yaml,yml,md}'",
86
89
  "format:check": "prettier --check '**/*.{ts,js,mjs,cjs,json,yaml,yml,md}'",
87
- "docs:generate": "tsx src/specdojo.ts build",
90
+ "docs:generate": "node --import tsx src/specdojo.ts build",
88
91
  "docs:dev": "npm run docs:generate && npm --prefix packages/docs-site run docs:dev",
89
92
  "docs:build:mermaid": "npm --prefix packages/docs-site run docs:build:mermaid",
90
93
  "docs:rebuild:mermaid": "rm -f public/mermaid/*.svg && npm run docs:build:mermaid",
@@ -93,8 +96,9 @@
93
96
  "validate:schema:job-run": "node packages/docs-lint/bin/specdojo-docs-lint.js yaml-schema --schema docs/specdojo/schemas/v1/job-run.schema.yaml --data \"docs/ja/**/execution/jobs/runs/*.json\" --allow-empty",
94
97
  "validate:schema:grade-pipeline": "node packages/docs-lint/bin/specdojo-docs-lint.js yaml-schema --schema docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml --data \"docs/ja/**/execution/grade/pipeline/*.json\" --allow-empty",
95
98
  "validate:schema:file": "node packages/docs-lint/bin/specdojo-docs-lint.js yaml-schema",
96
- "validate:schema": "npm run validate:schema:yaml && npm run validate:schema:job-run && npm run validate:schema:grade-pipeline && npm run validate:schema:rulebook-enums",
99
+ "validate:schema": "npm run validate:schema:yaml && npm run validate:schema:job-run && npm run validate:schema:grade-pipeline && npm run validate:schema:rulebook-enums && npm run validate:schema:glossary",
97
100
  "validate:schema:rulebook-enums": "node packages/docs-lint/bin/specdojo-docs-lint.js rulebook-schema-enums",
101
+ "validate:schema:glossary": "node packages/docs-lint/bin/specdojo-docs-lint.js glossary-references",
98
102
  "validate:catalog": "tsx src/specdojo.ts catalog validate",
99
103
  "validate:history-links": "node packages/docs-lint/bin/specdojo-docs-lint.js history-links",
100
104
  "check": "npm run typecheck && npm run lint:ts && npm run lint:md && npm run lint:fm && npm run validate:schema && npm run validate:catalog && npm run validate:history-links && npm test",
@@ -109,12 +113,14 @@
109
113
  "specdojo:exec:auto3": "specdojo exec run --auto --loop --parallel 3 > logs/exec-auto.stdout.log 2> logs/exec-auto.stderr.log",
110
114
  "validate:schema:yaml": "node packages/docs-lint/bin/specdojo-docs-lint.js yaml-schema --modeline"
111
115
  },
116
+ "engines": {
117
+ "node": ">=22.13"
118
+ },
112
119
  "dependencies": {
113
120
  "ajv": "^8.20.0",
114
121
  "commander": "^15.0.0",
115
- "dotenv": "^17.4.2",
116
- "fast-glob": "^3.3.3",
117
- "js-yaml": "^4.2.0",
122
+ "dotenv": "^18.0.4",
123
+ "js-yaml": "^4.3.2",
118
124
  "prettier": "^3.8.4",
119
125
  "remark-parse": "^11.0.0",
120
126
  "unified": "^11.0.5"
@@ -132,15 +138,15 @@
132
138
  "eslint-config-prettier": "^10.1.8",
133
139
  "gray-matter": "^4.0.3",
134
140
  "lefthook": "^2.1.9",
135
- "markdownlint-cli": "^0.48.0",
141
+ "markdownlint-cli": "^0.49.1",
136
142
  "remark": "^15.0.1",
137
143
  "remark-cli": "^12.0.1",
138
144
  "remark-frontmatter": "^5.0.0",
139
145
  "remark-gfm": "^4.0.1",
140
146
  "remark-lint": "^10.0.1",
141
- "remark-lint-frontmatter-schema": "^3.15.4",
142
147
  "remark-mdx": "^3.1.1",
143
148
  "remark-stringify": "^11.0.0",
149
+ "tinyglobby": "^0.2.17",
144
150
  "tsx": "^4.22.4",
145
151
  "typescript": "^6.0.3",
146
152
  "typescript-eslint": "^8.61.0",