specdojo 0.7.0 → 0.8.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.
- package/.github/agents/specdojo-orchestrator.md +3 -2
- package/CHANGELOG.md +153 -0
- package/dist/catalog/build.js +24 -1
- package/dist/catalog/plan.js +1 -1
- package/dist/catalog/scaffold.js +4 -1
- package/dist/commands/init.js +5 -1
- package/dist/commands/night-orchestrator.js +6 -4
- package/dist/dashboard/dashboard-timeline.js +18 -16
- package/dist/dashboard/dashboard.js +612 -259
- package/dist/dashboard/epic-plan.js +81 -0
- package/dist/dashboard/exec-records.js +16 -20
- package/dist/dashboard/routines.js +8 -6
- package/dist/dashboard/timeline-build.js +5 -9
- package/dist/dashboard/timeline.js +9 -4
- package/dist/devcontainer/scaffold.js +18 -0
- package/dist/docs/frontmatter-namespace.js +1 -48
- package/dist/docs/yaml-pages.js +125 -3
- package/dist/exec/agent-config.js +22 -0
- package/dist/exec/agent-plan.js +3 -2
- package/dist/exec/commands.js +69 -21
- package/dist/exec/commit-hook-skips.js +78 -0
- package/dist/exec/core.js +19 -7
- package/dist/exec/events.js +159 -8
- package/dist/exec/evidence.js +64 -16
- package/dist/exec/handoff.js +9 -13
- package/dist/exec/limit.js +1 -1
- package/dist/exec/mechanical-result.js +45 -0
- package/dist/exec/migrate-records.js +249 -0
- package/dist/exec/parent-validation.js +153 -12
- package/dist/exec/pipeline-state.js +27 -5
- package/dist/exec/plans-condense-findings.js +89 -0
- package/dist/exec/plans-core.js +24 -17
- package/dist/exec/plans-generation.js +48 -25
- package/dist/exec/plans-grade-findings.js +8 -3
- package/dist/exec/plans-kata-findings.js +61 -0
- package/dist/exec/plans-planning.js +3 -3
- package/dist/exec/plans-storage.js +12 -24
- package/dist/exec/register-resume.js +55 -56
- package/dist/exec/register.js +26 -22
- package/dist/exec/repo-integration-sync.js +8 -4
- package/dist/exec/repo-integration.js +21 -1
- package/dist/exec/reporter.js +121 -23
- package/dist/exec/results.js +85 -24
- package/dist/exec/review-completion.js +47 -0
- package/dist/exec/review-kata.js +109 -0
- package/dist/exec/run/agent-pipeline.js +75 -6
- package/dist/exec/run/agent.js +20 -7
- package/dist/exec/run/in-place.js +69 -32
- package/dist/exec/run/job.js +81 -24
- package/dist/exec/run/lifecycle-commands.js +188 -36
- package/dist/exec/run/mode-shared.js +11 -3
- package/dist/exec/run/register-command.js +6 -10
- package/dist/exec/run/register-core.js +20 -13
- package/dist/exec/run/register-mode.js +12 -12
- package/dist/exec/run/register-post-review.js +21 -9
- package/dist/exec/run/register-resume.js +28 -18
- package/dist/exec/run/register-state.js +10 -7
- package/dist/exec/run/register-worktree.js +60 -30
- package/dist/exec/run/schedule-mode.js +4 -4
- package/dist/exec/run/schedule-prepare.js +201 -59
- package/dist/exec/run/schedule-task.js +129 -25
- package/dist/exec/run/shared.js +4 -3
- package/dist/exec/run/trailing-records.js +35 -0
- package/dist/exec/run-records.js +2 -0
- package/dist/exec/strategy.js +1 -0
- package/dist/exec/trailing-records.js +242 -0
- package/dist/exec/trial-commands.js +3 -2
- package/dist/exec/validate-records-commit.js +110 -0
- package/dist/exec/validate-records.js +148 -0
- package/dist/exec/worktree-command.js +29 -16
- package/dist/exec/worktree-ops-commit.js +119 -48
- package/dist/exec/worktree-ops-lifecycle.js +77 -48
- package/dist/exec/worktree-ops-merge.js +13 -2
- package/dist/exec/worktree-ops.js +2 -2
- package/dist/exec/worktree.js +19 -2
- package/dist/grade/apply.js +32 -6
- package/dist/grade/command-inspect.js +2 -2
- package/dist/grade/command-run.js +2 -0
- package/dist/grade/command-shared.js +1 -1
- package/dist/grade/core.js +18 -5
- package/dist/grade/markdown.js +3 -3
- package/dist/grade/pipeline-state.js +15 -11
- package/dist/grade/plan.js +37 -17
- package/dist/grade/result.js +3 -3
- package/dist/grade/run.js +23 -3
- package/dist/grade/target-discovery.js +17 -4
- package/dist/grade/targets.js +12 -11
- package/dist/job/job.js +31 -17
- package/dist/job/noop.js +104 -0
- package/dist/register/core.js +2 -0
- package/dist/register/create-commands.js +28 -3
- package/dist/register/deliverable-target.js +9 -1
- package/dist/register/epic.js +104 -26
- package/dist/register/event-merge.js +3 -0
- package/dist/register/events.js +4 -0
- package/dist/register/external-project.js +3 -0
- package/dist/register/item.js +6 -0
- package/dist/register/maintenance-commands.js +4 -1
- package/dist/register/planning.js +7 -14
- package/dist/register/register.js +43 -9
- package/dist/register/track-domains.js +34 -0
- package/dist/register/track-plan.js +78 -0
- package/dist/register/transition-commands.js +8 -0
- package/dist/register/work-table.js +64 -0
- package/dist/review/grade.js +35 -13
- package/dist/routine/definition.js +4 -3
- package/dist/routine/failure.js +30 -0
- package/dist/routine/routine.js +56 -32
- package/dist/routine/storage.js +33 -0
- package/dist/schedule/schedule.js +1 -0
- package/dist/schedule/strategy-generate-document.js +26 -14
- package/dist/schedule/strategy-generate-scope.js +17 -45
- package/dist/schedule/strategy-generate.js +33 -3
- package/dist/schedule/strategy-profiles.js +86 -12
- package/dist/shared/agent-types.js +2 -0
- package/dist/shared/condense-records.js +25 -0
- package/dist/shared/deprecation.js +8 -0
- package/dist/shared/document-metadata.js +20 -0
- package/dist/shared/finding-cause.js +20 -0
- package/dist/shared/frontmatter-namespace.js +48 -0
- package/dist/shared/git.js +142 -15
- package/dist/shared/grade-result.js +17 -1
- package/dist/shared/local-state.js +20 -0
- package/dist/shared/markdownlint-config.js +8 -3
- package/dist/shared/plan-conventions.js +129 -0
- package/dist/shared/plan-templates.js +57 -41
- package/dist/shared/run-records.js +224 -0
- package/dist/shared/specdojo-config.js +39 -21
- package/dist/shared/text.js +65 -5
- package/dist/shared/timeline-index.js +2 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +9 -2
- package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
- package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
- package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
- package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
- package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
- package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
- package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
- package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
- package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
- package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
- package/docs/ja/specdojo/guides/docs-editing-guide.md +12 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
- package/docs/ja/specdojo/guides/exec-config-guide.md +47 -16
- package/docs/ja/specdojo/guides/exec-operation-guide.md +53 -17
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
- package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +70 -14
- package/docs/ja/specdojo/guides/register-operation-guide.md +25 -5
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +2 -0
- package/docs/ja/specdojo/guides/review-guide.md +22 -19
- package/docs/ja/specdojo/guides/routine-operation-guide.md +14 -8
- package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
- package/docs/ja/specdojo/guides/schedule-design-guide.md +7 -4
- package/docs/ja/specdojo/guides/schedule-operation-guide.md +27 -3
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
- package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
- package/docs/ja/specdojo/guides/use-case-guide.md +92 -155
- package/docs/ja/specdojo/recipes/bac-recipe.md +94 -0
- package/docs/ja/specdojo/recipes/bes-recipe.md +105 -0
- package/docs/ja/specdojo/recipes/br-recipe.md +84 -0
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +36 -24
- package/docs/ja/specdojo/recipes/cnd-recipe.md +125 -0
- package/docs/ja/specdojo/recipes/cpd-recipe.md +126 -0
- package/docs/ja/specdojo/recipes/cxd-recipe.md +145 -0
- package/docs/ja/specdojo/recipes/ifd-recipe.md +134 -0
- package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +135 -86
- package/docs/ja/specdojo/recipes/ifx-index-recipe.md +130 -0
- package/docs/ja/specdojo/recipes/pm-organization-recipe.md +29 -26
- package/docs/ja/specdojo/recipes/pm-plan-recipe.md +35 -26
- package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +38 -28
- package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -31
- package/docs/ja/specdojo/recipes/pm-roles-recipe.md +26 -28
- package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +10 -8
- package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +18 -17
- package/docs/ja/specdojo/recipes/stsd-recipe.md +100 -62
- package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +106 -0
- package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +137 -0
- package/docs/ja/specdojo/recipes/sysd-index-recipe.md +122 -0
- package/docs/ja/specdojo/references/command-reference.md +79 -64
- package/docs/ja/specdojo/references/deliverables-reference.md +9 -4
- package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
- package/docs/ja/specdojo/references/specdojo-config-reference.md +17 -16
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +72 -290
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +212 -79
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +138 -154
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +147 -59
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +100 -96
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +88 -108
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +126 -211
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +56 -35
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +102 -68
- package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +152 -0
- package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
- package/docs/ja/specdojo/rulebooks/clis-rulebook.md +187 -0
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +93 -247
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +104 -241
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +124 -257
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +87 -98
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +9 -7
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/dss-rulebook.md +193 -0
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +100 -54
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +69 -252
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +91 -76
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +252 -226
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +118 -40
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +11 -11
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +9 -9
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +4 -4
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +11 -11
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +11 -11
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +34 -29
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +8 -8
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +2 -2
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +50 -56
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +46 -55
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +57 -54
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +50 -65
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +2 -2
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +70 -97
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +47 -56
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -135
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +116 -32
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +118 -61
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +152 -57
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +51 -39
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +101 -46
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +72 -329
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +74 -263
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +78 -195
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +3 -4
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +3 -3
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +140 -143
- package/docs/ja/specdojo/samples/bac-sample.md +106 -21
- package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
- package/docs/ja/specdojo/samples/bds-sample.md +100 -21
- package/docs/ja/specdojo/samples/bes-index-sample.md +59 -20
- package/docs/ja/specdojo/samples/bes-sample.md +80 -21
- package/docs/ja/specdojo/samples/br-sample.md +68 -14
- package/docs/ja/specdojo/samples/ccd-sample.md +81 -19
- package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +9 -7
- package/docs/ja/specdojo/samples/cdsd-sample.md +89 -20
- package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
- package/docs/ja/specdojo/samples/cld-sample.md +3 -30
- package/docs/ja/specdojo/samples/clis-sample.md +132 -0
- package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
- package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
- package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
- package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
- package/docs/ja/specdojo/samples/dss-sample.md +175 -0
- package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
- package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
- package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
- package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
- package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
- package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
- package/docs/ja/specdojo/samples/pm-organization-sample.md +52 -20
- package/docs/ja/specdojo/samples/pm-plan-sample.md +84 -26
- package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +55 -22
- package/docs/ja/specdojo/samples/pm-raci-sample.md +69 -28
- package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
- package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +50 -26
- package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +89 -62
- package/docs/ja/specdojo/samples/sf-index-sample.md +89 -20
- package/docs/ja/specdojo/samples/sf-sample.md +121 -21
- package/docs/ja/specdojo/samples/sld-sample.md +107 -21
- package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
- package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
- package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
- package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
- package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
- package/docs/ja/specdojo/samples/uis-sample.md +164 -20
- package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
- package/docs/ja/specdojo/templates/bac-template.md +76 -0
- package/docs/ja/specdojo/templates/bes-template.md +56 -0
- package/docs/ja/specdojo/templates/br-template.md +64 -0
- package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
- package/docs/ja/specdojo/templates/cdfd-uc-template.md +9 -5
- package/docs/ja/specdojo/templates/cnd-template.md +137 -0
- package/docs/ja/specdojo/templates/cpd-template.md +129 -0
- package/docs/ja/specdojo/templates/cxd-template.md +105 -0
- package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
- package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
- package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
- package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
- package/docs/ja/specdojo/templates/ifd-template.md +86 -0
- package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
- package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
- package/docs/ja/specdojo/templates/opr-template.md +2 -4
- package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
- package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
- package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
- package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
- package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
- package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
- package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
- package/docs/ja/specdojo/templates/stsd-template.md +46 -21
- package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
- package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
- package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
- package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
- package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
- package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
- package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
- package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +53 -3
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
- package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
- package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
- package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
- package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
- package/package.json +2 -2
- package/templates/antigravity/orchestrator.md +3 -2
- package/templates/claude/agents/specdojo-orchestrator.md +3 -2
- package/templates/codex/agents/specdojo-orchestrator.toml +3 -2
- package/templates/codex/orchestrator.md +3 -2
- package/templates/devcontainer/tmux.conf +6 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +3 -2
|
@@ -69,6 +69,7 @@ SpecDojo 拡張は、ワークスペースの `.specdojo/doc-index.json` を使
|
|
|
69
69
|
| 文書リンクの表示・遷移 | Markdown の SpecDojo 文書リンクをクリックして対象文書を開きます。プレビュー内のリンクにも対応します |
|
|
70
70
|
| ID で文書を開く | コマンドパレットで `SpecDojo: Open Document by ID` を実行し、文書 ID を入力します |
|
|
71
71
|
| Markdown 表の整形 | 表内へカーソルを置き、コマンドパレットで `SpecDojo: Format Markdown Table` を実行します |
|
|
72
|
+
| 対話のプレビュー | `chat` を吹き出し、`chat tui` を TUI 風に表示します |
|
|
72
73
|
|
|
73
74
|
文書リンクは、本文では `[[id]]` または `[[id|表示名]]` と記述します。Markdown 表のセル内では、
|
|
74
75
|
列区切りとの衝突を避けるため `[[id\|表示名]]` と記述してください。
|
|
@@ -136,6 +137,17 @@ VS Code では、Markdown ファイルを編集しながら、
|
|
|
136
137
|
|
|
137
138
|
現在の Markdown ファイルのプレビューが開きます。
|
|
138
139
|
|
|
140
|
+
SpecDojo 拡張を導入すると、次の `chat` ブロックが吹き出しで表示されます。利用者は右、相手側は左に配置されます。`chat tui` に変えると、暗い背景と等幅文字を使い、利用者の発言に `>`、相手側に `●` を添えます。
|
|
141
|
+
|
|
142
|
+
```chat
|
|
143
|
+
あなた: 設定を確認してください。
|
|
144
|
+
|
|
145
|
+
オーケストレーター: `specdojo.config.json` を確認しました。
|
|
146
|
+
プロジェクトの設定が見つかりました。
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
発言の間には 1 行空け、続き行は字下げします。空行なしでも描画でき、空白・タブだけの行を含む空行は続き行の間でも読み飛ばします。空行の後の続き行も直前の発言に含まれ、空行以外の改行・字下げは維持されます。インラインコードにはバッククォートを使えます。文書サイトも同じ表示に対応し、GitHub や拡張未導入の VS Code ではコードブロックとして読めます。
|
|
150
|
+
|
|
139
151
|
#### 3.1.2. 編集画面とプレビューを並べて表示(推奨)
|
|
140
152
|
|
|
141
153
|
- Windows / Linux: `Ctrl + K` → `V`
|
|
@@ -224,16 +224,36 @@ flowchart TB
|
|
|
224
224
|
|
|
225
225
|
### 6.1. dct・sch・execの対応
|
|
226
226
|
|
|
227
|
-
| 情報 | 主な役割 | 担当ファイル
|
|
228
|
-
| ------------------- | -------------------------------------------------------------------- |
|
|
229
|
-
| 成果物カタログ | 管理する成果物、配置、依存関係、完了条件を定義する | `dct-<domain>.yaml`
|
|
230
|
-
| トラック | 対象成果物のスコープを決め、実行系列としてまとめる | `sch-track-<track>.yaml` / `sch-strategy-<track>.yaml`
|
|
231
|
-
| 実行フェーズ / パス | 成果物ごと、または成果物群を横断して適用する作業段階を定義する | `sch-strategy-<track>.yaml`
|
|
232
|
-
| タスク | 成果物×フェーズ から生成される実行アトム。担当・期限・依存関係を持つ | `sch-track-<track>.yaml`(生成物)
|
|
233
|
-
| plan | 一回の作業で確認・変更する対象と手順を示す | `execution/
|
|
234
|
-
| result | 実施内容、確認結果、残課題を記録する | `execution/
|
|
235
|
-
| 実行イベント | claim / complete / block などの実行履歴を表す | `execution/exec/events/`
|
|
236
|
-
| 実行生成物 | Ready、状態スナップショット、クリティカルパスなどを表す | `execution/generated/`
|
|
227
|
+
| 情報 | 主な役割 | 担当ファイル |
|
|
228
|
+
| ------------------- | -------------------------------------------------------------------- | -------------------------------------------------------- |
|
|
229
|
+
| 成果物カタログ | 管理する成果物、配置、依存関係、完了条件を定義する | `dct-<domain>.yaml` |
|
|
230
|
+
| トラック | 対象成果物のスコープを決め、実行系列としてまとめる | `sch-track-<track>.yaml` / `sch-strategy-<track>.yaml` |
|
|
231
|
+
| 実行フェーズ / パス | 成果物ごと、または成果物群を横断して適用する作業段階を定義する | `sch-strategy-<track>.yaml` |
|
|
232
|
+
| タスク | 成果物×フェーズ から生成される実行アトム。担当・期限・依存関係を持つ | `sch-track-<track>.yaml`(生成物) |
|
|
233
|
+
| plan | 一回の作業で確認・変更する対象と手順を示す | `execution/runs/<出どころ>/<項目 ID>/<run ID>/plan.md` |
|
|
234
|
+
| result | 実施内容、確認結果、残課題を記録する | `execution/runs/<出どころ>/<項目 ID>/<run ID>/result.md` |
|
|
235
|
+
| 実行イベント | claim / complete / block などの実行履歴を表す | `execution/exec/events/` |
|
|
236
|
+
| 実行生成物 | Ready、状態スナップショット、クリティカルパスなどを表す | `execution/generated/` |
|
|
237
|
+
|
|
238
|
+
実行記録は次の配置で保持します。出どころは `register`・`schedule`・`job` です。項目 ID と run ID の決め方は [[specdojo:plan-result-lifecycle-guide|plan/resultライフサイクルガイド]] を参照してください。
|
|
239
|
+
|
|
240
|
+
```text
|
|
241
|
+
execution/
|
|
242
|
+
runs/<出どころ>/<項目 ID>/<run ID>/
|
|
243
|
+
plan.md
|
|
244
|
+
result.md
|
|
245
|
+
evidence.json
|
|
246
|
+
pipeline-state.json
|
|
247
|
+
executor.log
|
|
248
|
+
reporter.log
|
|
249
|
+
conventions/
|
|
250
|
+
exec/events/
|
|
251
|
+
grade/results/
|
|
252
|
+
jobs/runs/
|
|
253
|
+
generated/
|
|
254
|
+
```
|
|
255
|
+
|
|
256
|
+
job の定義はプロジェクト直下の `jobs/` に置きます。`exec/trials/` は比較実験の記録であり、通常の run とは別に管理します。配置の検査は [[specdojo:plan-result-lifecycle-guide|plan/resultライフサイクルガイド]] の「配置の検査」を参照してください。
|
|
237
257
|
|
|
238
258
|
### 6.2. 展開の流れ
|
|
239
259
|
|
|
@@ -287,14 +307,17 @@ idと対応させない場合(日本語名称を使用する場合等)は、
|
|
|
287
307
|
#### 8.1.2. 横断ドキュメント
|
|
288
308
|
|
|
289
309
|
- 横断ディレクトリは特定ドメインの配下に置かず、プロジェクト直下に置きます。
|
|
290
|
-
`controls/project-register/` の登録項目や `execution/
|
|
310
|
+
`controls/project-register/` の登録項目や `execution/runs/<出どころ>/<項目 ID>/<run ID>/plan.md` の実行プランは、
|
|
291
311
|
プロジェクト定義・プロダクト変更を含む全ドメインの成果物を対象とするためです。
|
|
292
312
|
- これらが成果物カタログの管理対象かどうかは配置とは独立で、
|
|
293
313
|
どのドメインに分類するかは各 `dct-<domain>.yaml` の `domain` が決めます。
|
|
294
314
|
例えば `controls/` と `reporting/` は `dct-project-management.yaml`
|
|
295
|
-
(`domain: project-management
|
|
296
|
-
|
|
297
|
-
`
|
|
315
|
+
(`domain: project-management`)が管理します。全体計画の正本は `controls/project-register/` の epic です。
|
|
316
|
+
`schedule/` の計画成果物は `dct-planning.yaml`(`domain: planning`)で管理し、
|
|
317
|
+
旧 `timeline/tml-index.yaml` は非推奨の互換用ファイルとして扱います。
|
|
318
|
+
`routines/`、`controls/generated/`、各 `generated/` は CLI の入出力領域なのでカタログ管理対象外です。
|
|
319
|
+
|
|
320
|
+
派生ビューは `controls/generated/`、`schedule/generated/` など横断ディレクトリの直下に置きます。旧 sch-assessment は廃止済みのため、専用のサブディレクトリは作りません。routine の状態・履歴・lock は [[specdojo:routine-operation-guide|routine 運用ガイド]] に従って Git の外の端末側へ保存し、exec の lock は Git が無視する `execution/exec/.locks/` に置きます。
|
|
298
321
|
|
|
299
322
|
再利用可能なJob Definitionは`jobs/`、各回のJob Runは`execution/jobs/`へ置きます。詳細は[Job実行設計](../../product/040-system-design/sysd-job-execution.md)を参照してください。
|
|
300
323
|
|
|
@@ -311,7 +334,7 @@ projects/<prj-id>/
|
|
|
311
334
|
├── 050-impact-analysis/ # 導入・変更の影響調査
|
|
312
335
|
├── 060-migration-planning/ # 移行計画・設計・切替計画
|
|
313
336
|
├── ... # 070- 以降の成果物ドメイン
|
|
314
|
-
├── controls/ #
|
|
337
|
+
├── controls/ # 管理台帳・派生ビュー(登録簿・generated/)
|
|
315
338
|
├── schedule/ # Schedule(sch-*.yaml)
|
|
316
339
|
├── routines/ # 定期実行ルーチン(rtn-*.yaml)
|
|
317
340
|
├── jobs/ # 再利用可能なJob Definition(job-*.yaml)
|
|
@@ -321,6 +344,16 @@ projects/<prj-id>/
|
|
|
321
344
|
|
|
322
345
|
ファイル単位の完全なツリーは [ディレクトリレイアウトリファレンス](../references/directory-layout-reference.md) の `プロジェクトドキュメントの構成` を参照してください。
|
|
323
346
|
|
|
347
|
+
`reporting/progress-reports/` は週報などの成果物を初めて保存するときに作成します。job・routine の定義を置くだけでは作成されません。agent 型 job は作業指示を exec plan に展開し、報告本文と保存先ディレクトリの作成を agent が行います。出力先は project の `base_path` からの相対パスです。
|
|
348
|
+
|
|
349
|
+
prj-0001 の `job-weekly-report.yaml` はこの出力先を指定していますが、対応する `rtn-weekly-report.yaml` は `enabled: false` のサンプルであり、`routine run --due` では選ばれません。週報を作成するまで `reporting/` が存在しないのは、この構成では正常です。
|
|
350
|
+
|
|
351
|
+
### 8.3. 公開しない旧文書の保管
|
|
352
|
+
|
|
353
|
+
現行の文書ツリーから外す旧文書は、リポジトリ直下の `archive/` に保管します。prj-0001 で廃止したプロダクト文書22件は `archive/ja/product/trash/` に置きます。`docs/` と project の外に置くことで、文書サイトのページ・サイドバー・検索と doc index の走査対象から外します。`trash` のパス区分は残し、カタログの現行文書探索や grade の対象に戻さないようにします。
|
|
354
|
+
|
|
355
|
+
カタログの `path` は移動先を指し、ID と本文は保持します。過去の文書からの wikilink は `archive/ja/product/trash/links.json` で旧IDと移動先を対応付け、サイトではリポジトリ上のソースへ解決します。この対応表は公開 doc index には追加しません。
|
|
356
|
+
|
|
324
357
|
## 9. プロダクトドキュメントの構成
|
|
325
358
|
|
|
326
359
|
### 9.1. ディレクトリ構成の概観
|
|
@@ -75,15 +75,15 @@ phase_sets:
|
|
|
75
75
|
mode: review
|
|
76
76
|
```
|
|
77
77
|
|
|
78
|
-
| フィールド | 必須 | 説明
|
|
79
|
-
| ---------------- | ---- |
|
|
80
|
-
| `execution` | 任意 | `agent` または `human`。省略時は `agent`
|
|
81
|
-
| `mode` | 任意 | `edit` または `review`。省略時は `edit`
|
|
82
|
-
| `approach` | 任意 | `fully-guided` / `recipe-guided` / `freeform` / `bootstrap` / `retrofit` / `cross-deliverable-dedup` / `rulebook-maintenance` / `recipe-maintenance` / `sample-maintenance` / `template-maintenance` |
|
|
83
|
-
| `capabilities` | 任意 | 必要なツールリスト。ツール不要の場合は省略
|
|
84
|
-
| `proficiency` | 任意 | 必要な品質水準。省略すると全水準が候補
|
|
85
|
-
| `agent` | 任意 | `executor`(必須)と `reporter`(任意)の nickname。CLI の stage override に次いで優先
|
|
86
|
-
| `agent_pipeline` | 任意 | executor、reporter の 2 stage と stage ごとの `capabilities` / `proficiency`。省略時は従来の単一 agent フロー
|
|
78
|
+
| フィールド | 必須 | 説明 |
|
|
79
|
+
| ---------------- | ---- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
80
|
+
| `execution` | 任意 | `agent` または `human`。省略時は `agent` |
|
|
81
|
+
| `mode` | 任意 | `edit` または `review`。省略時は `edit` |
|
|
82
|
+
| `approach` | 任意 | `fully-guided` / `condense` / `recipe-guided` / `freeform` / `bootstrap` / `retrofit` / `cross-deliverable-dedup` / `rulebook-maintenance` / `recipe-maintenance` / `sample-maintenance` / `template-maintenance` |
|
|
83
|
+
| `capabilities` | 任意 | 必要なツールリスト。ツール不要の場合は省略 |
|
|
84
|
+
| `proficiency` | 任意 | 必要な品質水準。省略すると全水準が候補 |
|
|
85
|
+
| `agent` | 任意 | `executor`(必須)と `reporter`(任意)の nickname。CLI の stage override に次いで優先 |
|
|
86
|
+
| `agent_pipeline` | 任意 | executor、reporter の 2 stage と stage ごとの `capabilities` / `proficiency`。省略時は従来の単一 agent フロー |
|
|
87
87
|
|
|
88
88
|
`approach` の値ごとの意味と、rulebook / recipe / sample / template の参照方針は [実践の進め方ガイド](ryu-guide.md) を参照します。
|
|
89
89
|
|
|
@@ -206,6 +206,7 @@ pipeline:
|
|
|
206
206
|
|
|
207
207
|
run:
|
|
208
208
|
max_concurrent_runs: 4 # 省略時も 4(最初の run と --join の run の合計)
|
|
209
|
+
git_index_lock_wait_seconds: 1200 # 省略時も 1200(index.lock の解放を待つ秒数)
|
|
209
210
|
|
|
210
211
|
rate_limit_detection:
|
|
211
212
|
exit_codes: []
|
|
@@ -360,12 +361,40 @@ pipeline:
|
|
|
360
361
|
- 同じ `id` と `repo` の組の重複、`id`・`repo` 以外のキー、`repo` の無いオブジェクトは、agent 起動前の設定エラーになります。
|
|
361
362
|
- 実行するコマンドは、どのリポジトリでも ID ごとの固定 argv です(例: `test-unit` は `npm run test:unit`)。リポジトリ別に command や npm script 名を指定する手段は設けません。プロダクトリポジトリの npm script 名が異なる場合は、プロダクト側の `package.json` に許可リストと同じ名前の script(`test:unit` など)を用意してください。用意できない検証は、そのリポジトリへ割り当てないでください。script が無いまま割り当てると、`npm run` が失敗して親検証は `failed` になります。
|
|
362
363
|
|
|
364
|
+
要素に `paths` を書くと、変更の種類で検証を選べます(PJR-T01P)。親 runner は executor が変えたファイルを `paths` の glob(`**`・`*`・`?`・`{a,b}`、割り当てたリポジトリからの相対)と照らし、合うファイルが無ければ検証を流さず `not_applicable` として記録します。`not_applicable` は失敗として扱わず、executor が同じ検証を `not_run` と報告していても block しません。次の場合は `paths` があっても流します。
|
|
365
|
+
|
|
366
|
+
- `paths` を書かない検証(迷う場合は書かずに、今までどおり毎回流します)。
|
|
367
|
+
- 変更一覧が無い、または evidence の上限(1,000 件)で切れた場合。
|
|
368
|
+
- reporter の再開の前に統合先を取り込んだ後の再検証。
|
|
369
|
+
|
|
370
|
+
```yaml
|
|
371
|
+
pipeline:
|
|
372
|
+
parent_validations:
|
|
373
|
+
- lint-md
|
|
374
|
+
- validate-schema # 文書だけの変更でも流す
|
|
375
|
+
- { id: typecheck, paths: ["{src,tests,tools}/**", "tsconfig*.json"] }
|
|
376
|
+
- { id: test-unit, paths: ["{src,tests,tools}/**", "docs/ja/specdojo/**", "vitest.config.*"] }
|
|
377
|
+
```
|
|
378
|
+
|
|
379
|
+
`pipeline.commit_hook_skips` は、runner の統合の commit で流し直さない Git hook(lefthook のコマンド名)を宣言します。`covered_by` に並べた親の検証がその run ですべて `passed` のときだけ、commit を `LEFTHOOK_EXCLUDE` 付きで実行します。`not_applicable` や失敗した検証は代わりにならないため、その場合は hook を流します。人が手で commit するときの hook は変わりません。
|
|
380
|
+
|
|
381
|
+
```yaml
|
|
382
|
+
pipeline:
|
|
383
|
+
commit_hook_skips:
|
|
384
|
+
- { hook: typecheck, covered_by: [typecheck] }
|
|
385
|
+
- { hook: test, covered_by: [test-unit, test-integration] }
|
|
386
|
+
```
|
|
387
|
+
|
|
388
|
+
`pipeline.mechanical_result` を `true` にすると、edit result を reporter の agent を起動せずに runner が作ります。対象は、結果が完了で executor が `final_message` を返した edit だけです。実施内容は `final_message` の各行で、進め方には runner が作ったことを書きます。review、block、描画の失敗は従来どおり reporter が書きます。既定は `false` です。
|
|
389
|
+
|
|
363
390
|
`run.register_execution` は、`exec run --register` の既定の実行場所です。`worktree` または `in-place` を指定します。省略時は既存リポジトリとの互換性のため `in-place` です。CLI の `--worktree` / `--in-place` は設定を上書きし、同時指定はエラーになります。
|
|
364
391
|
|
|
365
392
|
`run.register_post_review` は、register の worktree 統合後に読み取り専用 review pipeline を実行し、todo / issue を verdict に応じて自動 close または `waiting` へ遷移するかを指定する boolean です。既定は `false` です。CLI の `--post-review` でもその run だけ有効にできます。review executor の既定は `claude-expert-review-executor` で、`--review-by` が優先されます。詳しい判定と、runner 自身を変更した項目を自動 close しない規則は [exec運用ガイド](exec-operation-guide.md) を参照してください。
|
|
366
393
|
|
|
367
394
|
`run.max_concurrent_runs` は、同じ project で同時に動かせる `exec run` プロセスの数の上限です。最初の run と、register の worktree 実行へ `--join` で合流する run の合計で数えます。正の整数だけを指定でき、省略時や不正な値の場合は `4` です。`1` を指定すると `--join` は無効になります。現在の使用数は `exec slots --project <project-id>` で確認できます。
|
|
368
395
|
|
|
396
|
+
`run.git_index_lock_wait_seconds` は、runner の統合・記帳などの git 操作が、別のプロセス(手の commit の pre-commit hook など)が握る `index.lock` の解放を待つ秒数です。0 以上の整数だけを指定でき、省略時は `1200`(20 分)です。不正な値は設定の読み込みでエラーになります。最初の 10 回は 1.5 秒間隔、その後は 5 秒間隔でやり直し、待っている間は 30 秒ごとに `warning: waiting for index.lock to be released (elapsed <経過> / limit <上限>, lock: <パス>, ...)` を出力します。上限を越えると、lock のパスと原因の候補(hook の実行中、または異常終了した git が残した古い lock)を添えて失敗します。最初の 10 回の後、lock のファイルが残っているのに git のプロセスが 1 つも動いていない場合は古い lock とみなし、上限を待たずに `index.lock looks stale` で失敗します。この判定は Linux の `/proc` で行い、読めない環境では上限まで待ちます。runner は lock のファイルを消しません。git のプロセスが動いていないことを確かめてから、人が消してください(PJR-964D)。
|
|
397
|
+
|
|
369
398
|
`pipeline.parent_validation_concurrency` は、1 つの `exec run` プロセスの中で親検証を同時に実行できる項目数の上限です。正の整数だけを指定でき、省略時は `1` です。`--parallel` で複数項目を並行実行しても、親検証は項目単位で 1 本ずつ直列に実行されます。vitest は検証ごとに複数の worker を起動するため、検証が重なるとコンテナの負荷で成果物と無関係なタイムアウトが起きます。これを防ぐための既定値です(PJR-3HHW)。制限の対象は親検証だけで、executor と reporter は `--parallel` のとおり並行に動きます。空きを待つ項目は `Waiting for parent validation slot: <項目> (<検証 ID>); running: <実行中の項目>` をログへ出力し、枠を得たときに `Parent validation slot acquired: <項目>` を出力します。
|
|
370
399
|
|
|
371
400
|
この直列化は、同じ `exec run` プロセス内の全経路に適用されます。対象は executor 成功後の検証、reporter 再開前の検証の再実行、`exec trial` の検証です。同じ project の `exec run` は `exec-run.lock` によって run 全体で排他されるため、通常は別プロセスの検証が重なることはありません。register の worktree 実行へ `--join` で合流した run どうしは並行して動くため、`exec-run.lock` または合流の枠を取得したプロセスは、同じ上限の枠を `exec/.locks/parent-validation/` にも取得します。これにより、合流した run を跨いでも親検証は `parent_validation_concurrency` 本までに抑えられます(PJR-4HBG)。別プロセスの枠を待つ項目は `Waiting for parent validation slot held by another exec run: <項目> (<検証 ID>)` をログへ出力します。枠は heartbeat 付きのロックで、プロセスが異常終了した場合は heartbeat が止まってから 30 秒で stale とみなされ、後続の run が奪取します。このため、解放漏れで無関係な run が止まり続けることはありません。別 project の run を同時に起動した場合は、ロックの配置が異なるため、互いの検証が重なり得ます。executor が sandbox 内で実行する検証は runner の管理外です。このため、vitest を使う `test-unit` / `test-integration` は `parent_validations` へ寄せ、executor には実行させません。
|
|
@@ -539,7 +568,7 @@ specdojo exec run --project <project-id> --task <task-id> \
|
|
|
539
568
|
|
|
540
569
|
### 6.3. evidence とログの引き渡し方針
|
|
541
570
|
|
|
542
|
-
executor の出力は、そのまま reporter へ渡さずに run 単位の evidence へ整形して保存します。保存先は `<execution_path>/
|
|
571
|
+
executor の出力は、そのまま reporter へ渡さずに run 単位の evidence へ整形して保存します。保存先は `<execution_path>/runs/<出どころ>/<項目 ID>/<run ID>/` です。
|
|
543
572
|
|
|
544
573
|
| ファイル | 内容 |
|
|
545
574
|
| --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
|
|
@@ -554,15 +583,16 @@ executor の出力は、そのまま reporter へ渡さずに run 単位の evid
|
|
|
554
583
|
- reporter へ渡すのは、plan と `evidence.json` の内容と出力 JSON Schema だけです。ログ本文・生 diff は渡しません。
|
|
555
584
|
- ログは `evidence.json` の `log_refs` に参照(パス・バイト数・切り詰めの有無)としてだけ現れます。ログ本文を読むのは人です。
|
|
556
585
|
- 保存前に上限を適用します。`executor.log` は全体で 64KiB、失敗した reporter のログは stdout / stderr の各ファイルを 64KiB とします。失敗した親検証は stdout / stderr をそれぞれ 1MiB まで取得し、両方を 1 つのログへ保存します。1MiB を超えたストリームは先頭と末尾を残して中間を省略します。最終メッセージと diff サマリは各 4,000 文字、検証結果は 50 件、変更ファイルは 1,000 件までです。超過分を切り詰めた事実は `log_refs.truncated` に残します。
|
|
557
|
-
-
|
|
586
|
+
- 保存前に秘匿値を伏せ字化します。対象は `Bearer`、OpenAI・Anthropic・GitHub(fine-grained を含む)・AWS・Google・Slack のキーやトークン、JWT、秘密鍵の PEM ブロック全体、URL の認証情報、`api_key` / `access_token` / `password` などの名前付きの値です。evidence と executor / reporter のログに適用します。
|
|
558
587
|
- reporter が非ゼロ終了または形式エラーで失敗した場合、同じ reporter stage 内の各形式試行を `reporter-attempt-<n>.stdout.log` と `reporter-attempt-<n>.stderr.log` に保存します。同じ run を resume して再度失敗した場合は、直近の失敗内容でこれらのファイルと `log_refs` を置き換えます。
|
|
559
588
|
- 親検証は失敗時だけ出力を保存し、成功時は要約だけを記録します。失敗ログは `parent-validation-output` として `log_refs` から参照します。同じ run の resume や統合段の再検証では attempt 番号を増やして新しいログを追加し、以前の失敗ログを上書きしません。親検証の要約は 1,000 文字以内で先頭と末尾を残すため、末尾に出る失敗ケース名と件数を evidence から確認できます。
|
|
560
589
|
- evidence ディレクトリは Git の管理対象です。成功して統合された run のログは履歴に残り、失敗中の worktree では未コミットのまま保持されます。`--force-restart` などで worktree を破棄すると未コミットログも失われるため、必要な調査を先に行います。既知パターンは保存前に秘匿しますが、未知形式の秘密が残る可能性を考慮し、ログを外部共有する前に内容を確認します。
|
|
561
590
|
- executor が構造化した最終報告を返す場合は、標準出力に `<specdojo_executor_evidence>` タグで JSON(`final_message`・`validations`・省略可能な `completion_status`・`handoff`)を出します。`validations[].status` は `passed` / `failed` / `not_run` / `not_applicable` / `requires_human` のいずれかです。`not_applicable` はリポジトリが検査の適用条件を満たさない場合に使い、`reason` へ理由を必ず記録します。`requires_human` は、実 agent CLI の起動、利用枠や課金を伴う操作、認証情報やホスト側の操作など、agent の sandbox から実行できない確認だけに使います。実行できるが省略した検証には使わず、`not_run` として記録します。タグが無い場合は標準出力の残りを最終メッセージとして扱います。
|
|
562
591
|
- `pipeline.parent_validations` には `validate-schema`(`npm run validate:schema`)、`typecheck`(`npm run typecheck`)、`test-unit`(`npm run test:unit`)、`test-integration`(`npm run test:integration`)、`lint-ts`(`npm run lint:ts`)、`lint-fm`(`npm run lint:fm`)、`lint-md`(`npm run lint:md`)、`lint-mermaid`(`npm run lint:mermaid`)、`lint-d2`(`npm run lint:d2`)、`build`(`npm run build`)、`format-check`(`npm run format:check`)を指定できます。親 runner は executor の成功後・reporter の起動前に、指定順で固定 argv の検証を実行します。
|
|
563
592
|
- executor prompt には設定済み ID と対応コマンドを明示します。executor はそのコマンドや対象限定版を sandbox 内で実行せず、executor evidence の validations にも含めなくてよいものとします。親 runner の結果は `source: runner` と許可リスト `id` 付きで同じ `validations` 配列へ保存します。executor が同じ検査を `not_run` または `not_applicable` として含めた場合も、同じリポジトリで実行された親 runner の結果を正とします。これにより sandbox 内で成立しない検証を親へ移した場合も二重実行せず、executor の重複報告で run を止めません。
|
|
564
|
-
- result の `changed_files` のパスは evidence の `changes` から、execution の evidence、project register とその派生ビュー、当該 result という runner 管理記録を除いて runner が機械生成します。除外後の変更一覧だけを reporter へ渡し、edit の変更説明は evidence のパスと対にして受け取ります。runner はパスで突き合わせるため、説明の順序は問いません。説明が不足したパスには Git の変更メタデータ(追加・変更・削除・名前の変更、行数)を記録し、変更ファイルが多い場合(50 件超)はディレクトリごとに集約して記録します。evidence にないパスの説明は捨てます。`outcome` と `block_reason` は stage の状態・終了コード・保護機構が保存した理由・executor / 親 runner の検証から機械生成します。reporter の JSON Schema は文章項目と対応づけ用のパスだけを受け付け、いずれかの検証が failed または `not_run` なら、reporter の文章にかかわらず機械判定は blocked です。ただし、executor が `not_run` または `not_applicable` と記録したコマンドを、親 runner が同じリポジトリで同じコマンドとして実行し成功していれば、親 runner の結果を正として executor の報告を無視します。さらに、`npm run <name>` に対応する script がない、`npx <package>` の package が `dependencies` / `devDependencies` にない、検査の対象となる種類の変更ファイルがない、または SpecDojo サブコマンドの設定上の適用条件を満たさないことを runner が機械的に確定できる場合、その `not_run` は block せず、edit result の申し送りへ「適用外の検証(runner の判定)」として追記します。変更ファイル種別で判定する対応は共通規約の検査表を正本とし、`validate:schema:file` は `*.yaml` / `*.yml`、Prettier は `*.md` / `*.ts` / `*.js` / `*.json` / `*.yaml` / `*.yml`、markdownlint は `*.md`
|
|
593
|
+
- result の `changed_files` のパスは evidence の `changes` から、execution の evidence、project register とその派生ビュー、当該 result という runner 管理記録を除いて runner が機械生成します。除外後の変更一覧だけを reporter へ渡し、edit の変更説明は evidence のパスと対にして受け取ります。runner はパスで突き合わせるため、説明の順序は問いません。説明が不足したパスには Git の変更メタデータ(追加・変更・削除・名前の変更、行数)を記録し、変更ファイルが多い場合(50 件超)はディレクトリごとに集約して記録します。evidence にないパスの説明は捨てます。`outcome` と `block_reason` は stage の状態・終了コード・保護機構が保存した理由・executor / 親 runner の検証から機械生成します。reporter の JSON Schema は文章項目と対応づけ用のパスだけを受け付け、いずれかの検証が failed または `not_run` なら、reporter の文章にかかわらず機械判定は blocked です。ただし、executor が `not_run` または `not_applicable` と記録したコマンドを、親 runner が同じリポジトリで同じコマンドとして実行し成功していれば、親 runner の結果を正として executor の報告を無視します。さらに、`npm run <name>` に対応する script がない、`npx <package>` の package が `dependencies` / `devDependencies` にない、検査の対象となる種類の変更ファイルがない、または SpecDojo サブコマンドの設定上の適用条件を満たさないことを runner が機械的に確定できる場合、その `not_run` は block せず、edit result の申し送りへ「適用外の検証(runner の判定)」として追記します。変更ファイル種別で判定する対応は共通規約の検査表を正本とし、`validate:schema:file` は `*.yaml` / `*.yml`、Prettier は `*.md` / `*.ts` / `*.js` / `*.json` / `*.yaml` / `*.yml`、markdownlint は `*.md`、`validate:history-links`(`specdojo-docs-lint history-links` を含む)は履歴蓄積ファイル(`pjr-*.md`(`pjr-index.md` を除く)、または executor 自身が変更した `execution/runs/<origin>/<item>/<run>/` 配下の `plan.md`・`result.md` や旧来の `exec/plans/**/*.md`・`exec/results/**/*.md`)の変更がある場合だけ適用対象とします。変更範囲の判定では、runner が生成・更新する `exec/` 配下(`plans/`・`results/`・`evidence/`・`events/`・`.locks/`)を executor の変更ファイルから除外し、rename は変更前後の両方を見て、プロダクトリポジトリのコマンドはそのリポジトリの変更だけで判定します。`typecheck` など、この対応に含まれない検査の判定は変更しません。SpecDojo の起動形は `specdojo <subcommand>`、`npx specdojo <subcommand>`、ソース/配布済み CLI の直接起動を認識し、`catalog validate`(`npm run validate:catalog` および `tools/catalog-validate-if-configured.mjs` を含む)は対象 project の `catalog_path` で判定します。対象 project は、コマンドの `--project <id>`、run の対象 project(runner が execution path に一致する project を設定から特定したもの)、`current_project` の順に決めます。別の project が `catalog_path` を持っていても、run の対象 project に `catalog_path` がなければ適用外です。対象 project に `catalog_path` があっても、executor の変更(runner が書く `exec/` 配下などの runner 管理記録を除き、rename は変更前後の両方を見ます)が `docs/ja/projects/` 配下に及ばない run では、plan の共通規約の検証表と同じく適用外とし、executor の `not_applicable` も受理します。変更が及ぶ run では従来どおり適用対象です。また、`<repo>:<path>` を引数に含むコマンド、`--prefix <repo>` 付きのコマンド、または `$SPECDOJO_REPO_<NAME>` / `${SPECDOJO_REPO_<NAME>}` を含むコマンドは、対象 project が `repos` で宣言したそのプロダクトリポジトリの `package.json` で script と依存を判定します(`--prefix` はリポジトリ名か設定の `path` と一致するものを対象にします)。設定が読めない、対象 project を特定できない、または適用条件を未定義のサブコマンドは機械的な救済をせず、通常の `not_run` として扱います。executor の failed は親 runner の成功や適用外判定で打ち消しません。`npm run check` のように npm script を `&&` でつないだだけの合成コマンドを executor が `not_run` とした場合は、対象リポジトリの `package.json` の script を展開し、構成する各コマンドが同じリポジトリの親検証か executor 自身の検証で通っていれば満たされたものとして扱います。`npm test` は、`npm run test:unit` と `npm run test:integration` の両方が通っていれば満たされたものとします。構成するコマンドの script の中身と同じコマンドを executor が直接実行して通した場合も満たします(`tsx` の起動の書き方の違いはそろえて比べます)。任意のシェルを含む script は展開しません。理由付きの `not_applicable` は block の理由にせず、runner が edit result の申し送りへ「適用外の検証: `<コマンド>`(<理由>)」として機械的に追記します。ただし、理由がない場合、変更ファイル種別を含む適用条件を満たした `npm run <name>` の script が存在する場合、または同条件を満たした `npx <package>` の package が `dependencies` / `devDependencies` に存在する場合は誤申告として blocked にします。SpecDojo サブコマンドは package の有無だけでは反証せず、既知の適用条件を設定から判定します。適用条件が未定義なら理由付きの agent の申告に従います。`specdojo index build`(`npx specdojo index build`・`node --import tsx src/specdojo.ts index build` などの起動形を含みます)は runner が担う検証です。出力先の `.specdojo/doc-index.json` は agent が書き込めず、index は worktree の準備と統合の前に runner が再生成するため、executor への指示では実行も記録もしないよう伝えます。executor が `not_run` / `not_applicable` と記録しても block の理由にせず、`not_run` の場合は edit result の申し送りへ「runner が担う検証: `<コマンド>`(<理由>)」として追記します。runner の再生成が失敗した場合は worktree の準備で run が止まるか、runner の検証の失敗として block するため、満たしたものとは扱いません。executor の failed は救済せず、ほかの SpecDojo サブコマンドの `not_run` の扱いも変えません。executor の `requires_human` は block の理由にせず、runner が edit result の申し送りへ「人の確認が必要: `<コマンド>`(<要約>)」として機械的に追記します。項目は review へ進み、人が確認してから close します。
|
|
565
594
|
- `completion_status` は作業の完了状態を示す省略可能な欄で、値は `complete` / `incomplete` です。欄のない既存の報告は `complete` として扱います。値が指定されていてこの 2 値に合わない場合は、安全側に倒して `incomplete` として保存します。executor は計画の作業を終えられなかった場合、`incomplete` とし、理由を `final_message`、残作業を `handoff` に書きます。終了コード 0 や親検証の成功では未完了の申告を上書きしません。`exec run --register` は親検証・reporter を起動する前に停止し、項目を `waiting` にして、秘匿処理・文字数制限を適用した `final_message` の要旨を `block_reason` に記録します。worktree 実行では変更と evidence を残し、統合しません。pipeline の executor は `blocked`、evidence の `stage.status` と `exit_code` は実際のプロセス結果のままとします。`--resume --resume-from executor`(または `--resume`)で再開でき、前回の理由と `handoff`、途中の変更を executor に引き継ぎます。完了を申告し直し、必要な検証を通過してから review・統合へ進みます。
|
|
595
|
+
- approach が報告に求める項目は、runner が reporter の起動前に検査します。現在の対象は `condense` の edit が求める `condense_records` で、欠けている、または形式が正しくない場合は reporter の失敗にせず executor の段の失敗とします。evidence を `completion_status: incomplete` とし、理由と再開の操作(schedule は `exec resume --task <id> --resume-from executor`、register は `exec run --register <id> --worktree --resume --resume-from executor`、agent を替える場合は `--executor-by`)を `block_reason` と result に残します。pipeline の executor は `blocked` です。再開は executor の段から始まり、reporter だけを同じ evidence で流し直しません。この検査より前に記録され、reporter の段で止まった run も、reporter の再開時に同じ検査で executor の段へ戻します。
|
|
566
596
|
- `handoff` は executor が申し送る判断の理由、保護された設定の変更案、次のアクションなどの文字列配列です。先頭 100 件、各 4,000 文字までを秘匿処理して evidence に保存し、空文字列や文字列以外の要素は除外します。省略した既存の報告・evidence も有効です。reporter にはこの欄も渡し、edit result の「申し送り」には runner が reporter の補足と合わせて機械的に転記します。同一の文字列は重複させず、reporter が省略しても executor の記録は残します。register の完了条件が result への記録を求める場合、pipeline の executor は個票の対応結果と報告の `handoff` の両方に書きます。close の前には個票の対応結果と result の両方を確認します。
|
|
567
597
|
- reporter の出力は JSON Schema で厳格に検証します。形式不正のときは同じ plan と evidence のまま reporter だけを最大 3 回再実行し、executor は再実行しません。
|
|
568
598
|
- reporter stage の再開では、現在の設定 ID と一致する親検証が保存済み evidence にそろっている場合だけ executor evidence を再利用します。`{ id, repo }` を使う場合は、ID とリポジトリの組が一致することを求めます。再実行時も同じ割り当てで、各リポジトリの worktree を `cwd` にします。保存済みの親検証がすべて成功していれば再実行しません。`failed` / `not_run` があれば、親 runner が現在の worktree で固定許可リストの親検証を再実行し、同じ ID の結果を evidence 上で置換してから reporter へ渡します。過去の親検証ログは置換せず、新しい失敗ログだけを追加します。executor 由来の検証は再実行・置換しません。設定 ID が変わった、または結果が欠けている場合、Schedule 実行は新しい executor run としてやり直し、register 実行は明示的な再実行を促して再開を拒否します。
|
|
@@ -685,7 +715,7 @@ provider によらず、exec の実行構造そのものが次の境界を提供
|
|
|
685
715
|
| git 操作の分離 | `git add` / `commit` / `merge` は specdojo CLI が親プロセスで行い、agent には git 権限を与えない |
|
|
686
716
|
| Git 環境・状態ガード | repository 固有環境を除去し、agent 前後の HEAD・local config 変更を検知して block する |
|
|
687
717
|
| ready 昇格の human-only 化 | 成果物 `status` の `ready` への昇格を commit 時に検出し、agent 実行では block する |
|
|
688
|
-
| commit 対象の除外 | `
|
|
718
|
+
| commit 対象の除外 | `plan.md`、対象 run 以外の `execution/runs/`、`exec/events/`、`generated/` は commit しない |
|
|
689
719
|
| merge の重複ガード | root 側の未 commit 変更と merge 対象パスが重複する場合は merge しない |
|
|
690
720
|
|
|
691
721
|
### 8.2. provider 別の権限設定
|
|
@@ -784,11 +814,12 @@ providers:
|
|
|
784
814
|
| human / edit | 対象 task の result、result frontmatter の `targets` から解決した成果物パス |
|
|
785
815
|
| edit(maintenance / bootstrap 系 approach) | 上記に加え、実践の型ディレクトリ(rulebooks / recipes / samples / templates) |
|
|
786
816
|
|
|
787
|
-
-
|
|
788
|
-
-
|
|
817
|
+
- agent の許可リスト外の変更が残っていれば、`commit-scope: integration blocked` と対象パスを出力し、commit・統合・通常の worktree 撤去を止めます。対象パスと次のアクションを result の申し送りと `integrate.log` に残し、worktree を保持します。再開時も同じ検査を適用します。human の schedule タスクは result による選択を維持します。
|
|
818
|
+
- `bootstrap` と `*-maintenance` でも、成果物カタログ・schema・文書サイトの型のメニューを一括で許可しません。これらは他の成果物や親 runner の動作へ影響するため、明示された `targets` で解決できるファイルだけを commit 対象にします。対象外なら変更せず、変更理由・対象パス・提案差分・必要な検証を個票の対応結果(register タスクの場合)と executor 報告の `handoff` に書き、対象の見直しまたは別タスクで反映します。
|
|
819
|
+
- 既存の除外リスト(`plan.md` や対象 run 以外の実行記録等)は許可リストの内側でも引き続き適用します。
|
|
789
820
|
- agent の mode / approach / `targets` は worktree の **agent 起動前の HEAD 側** plan(CLI が checkpoint commit した版)から読みます。agent 前後の HEAD は runner が比較し、agent 自身の commit や checkout を検知した場合は統合前に block するため、許可リストの導出は改ざん耐性があります。
|
|
790
821
|
- human は plan を持たないため、HEAD 側 result の `execution: human`、mode、approach、`targets` から許可リストを導出します。human には敵対 agent が存在しないため、plan を独立した改ざん耐性境界にする要件は適用しません。
|
|
791
|
-
- `targets` の doc id は HEAD 側 doc-index でパスへ解決し、未登録の場合(未作成の新規成果物)は catalog(`dct-*.yaml`)が宣言するパスへフォールバックします。どちらでも解決できない id
|
|
822
|
+
- `targets` の doc id は HEAD 側 doc-index でパスへ解決し、未登録の場合(未作成の新規成果物)は catalog(`dct-*.yaml`)が宣言するパスへフォールバックします。どちらでも解決できない id は `unresolved target doc id (no individual path; approach directory permissions still apply)` を出力し、その id による個別パスの許可は追加しません。approach が許可する型のディレクトリ内のファイルは、id の解決と独立して commit 対象になります。ディレクトリの許可もないファイルの変更は、上記の停止ガードの対象です。
|
|
792
823
|
- `retrofit` の `evidence_refs` は plan 本文へ読み取り専用の調査入力として展開されますが、`targets` や実践の型ディレクトリの許可には変換されません。実装エビデンスへの変更は commit 対象外です。
|
|
793
824
|
- agent で HEAD に plan が無い場合、または human で HEAD に result が無い場合など、frontmatter から task 識別を復元できない場合のみ従来の除外リスト方式へフォールバックします。CLI 経由では正本となる plan / result を checkpoint するため、agent 側からこの分岐を誘発することはできません。
|
|
794
825
|
- この許可リストは specdojo CLI が行う commit にのみ効くため、**agent 自身に `git commit` を許可しないこと**が全 provider 共通の前提になります。agent が exec branch 上に直接 commit すると許可リストを経由せず merge に到達します。claude は settings の allow に `git add` / `git commit` を含めません(`-p` 実行では未許可ツールは自動拒否されます)、codex は共有 `.git` が worktree 外にあるため sandbox が書き込みを遮断します、opencode は `bash` の許可リストで塞ぎます。
|
|
@@ -249,27 +249,27 @@ agent起動時はhook由来の`GIT_DIR`などを継承せず、各trialのcwdか
|
|
|
249
249
|
|
|
250
250
|
`blocked` は人の判断や外部対応が必要な障害を表します。状況に応じて次のコマンドを使います。
|
|
251
251
|
|
|
252
|
-
| 状況
|
|
253
|
-
|
|
|
254
|
-
| 中断で `doing` のまま
|
|
255
|
-
| pipeline の reporter で `blocked`
|
|
256
|
-
| reporter
|
|
257
|
-
| pipeline の統合段で `blocked`
|
|
258
|
-
| 障害を解消し同じ試行を続ける
|
|
259
|
-
| 試行を破棄して最初からやり直す
|
|
260
|
-
| 着手前のタスクを恒久的に中止する
|
|
252
|
+
| 状況 | コマンド | 結果 |
|
|
253
|
+
| --------------------------------------------------------------------------------------- | ------------------------------------------------ | ------------------------------------------------------------------ |
|
|
254
|
+
| 中断で `doing` のまま | `exec resume` | 既存 worktree 上で継続 |
|
|
255
|
+
| pipeline の reporter で `blocked` | `exec resume --task <id>` | executor evidence から再開 |
|
|
256
|
+
| reporter・統合段で `blocked`、または中断で `doing` の pipeline を executor からやり直す | `exec resume --task <id> --resume-from executor` | 既存 worktree と変更を引き継ぎ、executor → reporter → 統合を再実行 |
|
|
257
|
+
| pipeline の統合段で `blocked` | `exec resume --task <id>` | agent を起動せず統合だけ再開 |
|
|
258
|
+
| 障害を解消し同じ試行を続ける | `exec unblock` | `blocked -> doing` |
|
|
259
|
+
| 試行を破棄して最初からやり直す | `exec release` | `blocked -> todo` |
|
|
260
|
+
| 着手前のタスクを恒久的に中止する | `exec cancel` | `todo -> cancelled` |
|
|
261
261
|
|
|
262
262
|
`release` は `doing` / `blocked` の試行を破棄して `todo` に戻します。`cancel` は `todo` のタスクを終端状態にする操作です。
|
|
263
263
|
|
|
264
|
-
executor / reporter pipeline では、run ごとの
|
|
264
|
+
executor / reporter pipeline では、run ごとの `<execution_path>/runs/<出どころ>/<項目 ID>/<run ID>/pipeline-state.json` に各段(executor / reporter と、runner が担う統合段 `integrate`)の状態、agent、試行回数、evidence / result 参照を保存します。executor 中断の block event は `pipeline_stage=executor`、reporter 失敗は `pipeline_stage=reporter`、統合失敗は `pipeline_stage=integrate` を持ち、いずれも `pipeline_state_ref` から同じ run を再開します。`exec resume --task <task-id>` は state に応じて未完了の段から再開し、完了済みの agent 段を重複実行しません。
|
|
265
265
|
|
|
266
|
-
成果物の不足を executor に直させる場合は `--resume-from executor` を付けます。対象は executor が `succeeded`
|
|
266
|
+
成果物の不足を executor に直させる場合は `--resume-from executor` を付けます。対象は executor が `succeeded` で、reporter が未完了または統合段(commit・検査・merge)で止まった pipeline と、approach の必須項目(`condense_records` など)を欠いた報告として runner が executor の段で止めた pipeline に限ります。既存 run の executor 試行回数を増やし、`blocked` からの再開は `unblock` イベントを記録します。統合段から戻す場合は、executor を起動する前に統合先(project は root の現在ブランチ)を exec branch と worktree へ取り込むため、統合先で直した不具合を worktree で `git merge` せずに受け取れます。未 commit の変更と run の記録は取り込みの前に控えて戻し、戻せない場合は取り込み前へ戻して停止します。統合段の block 理由と result には、失敗した操作のメッセージと、この再開と統合だけの再試行(`exec resume --task <id>`)の 2 つの次の操作を記録します。統合が成功済みの run、一部のリポジトリを統合済みの run、exec branch が merge 済みの run、worktree が merge の途中の run(中止すると stage 済みの変更を失うため)、executor 未成功、pipeline 以外、`executor` 以外の値は理由を表示して停止します。この指定には `--task` が必要で、`--due` とは併用できません。
|
|
267
267
|
|
|
268
268
|
停止後に plan の指示を補う場合は、次の手順で再開します。
|
|
269
269
|
|
|
270
270
|
1. `specdojo exec worktree status --project <project-id> --task <task-id>` で残っている worktree を確認する。
|
|
271
|
-
2. その worktree の `<execution_path>/
|
|
272
|
-
3. `specdojo exec resume --project <project-id> --task <task-id> --resume-from executor`
|
|
271
|
+
2. その worktree の `<execution_path>/runs/<出どころ>/<項目 ID>/<run ID>/plan.md` を編集し、追加の指示と、変更の理由・再開までの経緯を result の申し送りへ残す指示を書く。
|
|
272
|
+
3. `specdojo exec resume --project <project-id> --task <task-id> --resume-from executor`(登録簿の場合は `specdojo exec run --project <project-id> --register <id> --resume --resume-from executor`)を実行する。root で plan を生成し直さず、worktree にある編集済み plan を executor と reporter へ渡す。既存の成果物と未コミット変更も引き継ぎ、統合時には直した plan がコミットに含まれて元の plan で上書きされずに履歴に残る。
|
|
273
273
|
4. 再開後の result で経緯と検証結果を確認する。pipeline の executor は result を直接編集せず、報告の `handoff` に経緯を記載し、reporter と runner が result へ反映する。
|
|
274
274
|
|
|
275
275
|
stage agent を明示する場合は次のように指定します。片方を省略すると、その stage は要件と優先度から自動選択されます。
|
|
@@ -282,6 +282,8 @@ specdojo exec resume \
|
|
|
282
282
|
--reporter-by <reporter-nickname>
|
|
283
283
|
```
|
|
284
284
|
|
|
285
|
+
executor 段から再開するとき(`--resume-from executor` を付けた再開、または executor 段で止まったタスクの再開)に `--executor-by` で現在の claim の持ち主と異なる executor を指定すると、実行前に元の actor の `release` イベントと新しい executor の `claim` イベントを記録して claim を新しい executor へ移し、完了時の `complete` イベント(および中断時の `block` イベント)も新しい executor で記録します。`--executor-by` を省略した場合や同じ executor を指定した場合は既存の claim を維持します(`doing` はそのまま継続し、`blocked` は `unblock` イベントで `doing` に戻します)。reporter 段や統合段のみを再開する場合は既存の claim を維持します。
|
|
286
|
+
|
|
285
287
|
```bash
|
|
286
288
|
specdojo exec release \
|
|
287
289
|
--project <project-id> \
|
|
@@ -303,6 +305,17 @@ specdojo exec release \
|
|
|
303
305
|
|
|
304
306
|
`--reset-worktree` は未commitの result や成果物変更を破棄します。内容を確認したい場合は、先に [exec worktree運用ガイド](exec-worktree-guide.md) の `status` を使います。
|
|
305
307
|
|
|
308
|
+
#### 2.2.1. 人が unblock するときの続行と引き取り
|
|
309
|
+
|
|
310
|
+
`exec unblock` を人が実行しても、claim の持ち主は変わりません。claim の持ち主は `claim` イベントの actor で、`note` やほかの actor の `unblock` では移りません。人が障害を取り除いて agent の run を続けさせる場合と、人が自分で直して完了させる場合は、`--take-over` の有無で区別します。
|
|
311
|
+
|
|
312
|
+
| 意図 | コマンド | claim の持ち主 | その後 |
|
|
313
|
+
| ------------------------------------ | ------------------------------------------------------------- | ------------------------- | --------------------------------------------------------------------------------------- |
|
|
314
|
+
| agent の run を続けさせる | `exec unblock --task <id> --by <human> --msg ...` | 元の actor(agent)のまま | `exec resume --task <id>` が元の agent で再開し、runner の `complete` / `block` も通る |
|
|
315
|
+
| 人が引き取り、自分で直して完了させる | `exec unblock --task <id> --by <human> --msg ... --take-over` | unblock した人 | 人が `exec complete --task <id> --by <human>` で完了させる。agent の run は完了できない |
|
|
316
|
+
|
|
317
|
+
`--take-over` は roster の `type: human` の actor だけが使えます。`--take-over` の `unblock` イベントは `take_over=true` を持ち、pipeline の再開情報(`pipeline_stage` など)を引き継ぎません。claim の持ち主を確かめるには `exec status --state doing` を使います。`by` 列と `--by` の絞り込みは claim の持ち主を表します。
|
|
318
|
+
|
|
306
319
|
### 2.3. 完了済みタスクをtodoに戻す
|
|
307
320
|
|
|
308
321
|
完了条件を満たしていないのに `complete` した場合など、完了判定そのものを訂正するときは `exec reopen` を使います。単に追加作業が発生した場合は、完了履歴を訂正せず新しい schedule task として計画します。
|
|
@@ -328,7 +341,7 @@ specdojo exec refresh --project <project-id>
|
|
|
328
341
|
|
|
329
342
|
後続 task も完了済みの場合は、依存グラフの下流から順に `reopen` します。後続 task が `doing` / `blocked` の場合は、先に同じ試行を完了させるか、`exec release` で `todo` に戻します。これにより、完了していない依存先を前提に後続 task が進行・完了している状態を防ぎます。
|
|
330
343
|
|
|
331
|
-
`reopen`
|
|
344
|
+
`reopen` は過去 run の plan・result、成果物、Git 履歴を変更・削除しません。完了済み plan は同じ run ディレクトリに残り、次の `exec plan` / `exec run` で新しい run を生成します。同じ run の続きは `exec resume` で再開します。
|
|
332
345
|
|
|
333
346
|
```bash
|
|
334
347
|
specdojo exec claim --project <project-id> --task <task-id> --by <actor> --msg "rerun"
|
|
@@ -392,11 +405,13 @@ specdojo exec run --project <project-id> --task <task-id> --worktree
|
|
|
392
405
|
schedule に `agent_pipeline` を持たない plan(`exec plan --deliverable <localId> --mode review` で生成した review plan など)は、`exec run --plan` または `exec run --deliverable` に `--executor-by` / `--reporter-by` を足すと同じ 2 stage で実行します。片方だけ指定した場合、もう一方は `stage_role` による自動選択で決まります。reporter が scaffold 済みの result を記入するため、`--plan` では frontmatter に `task_id` を持つ plan が必要です。`--by` に `stage_role` を持つ pipeline 用 agent を指定すると、result 未記入の blocked にはせず、`--executor-by` / `--reporter-by` を使うよう案内するエラーで実行前に拒否します。
|
|
393
406
|
|
|
394
407
|
```bash
|
|
395
|
-
specdojo exec run --project <project-id> --plan <
|
|
408
|
+
specdojo exec run --project <project-id> --plan <execution_path>/runs/<出どころ>/<項目 ID>/<run ID>/plan.md \
|
|
396
409
|
--executor-by <executor-nickname> --reporter-by <reporter-nickname>
|
|
397
410
|
```
|
|
398
411
|
|
|
399
|
-
run
|
|
412
|
+
新規 run の plan・result・evidence・ログ・state は `<execution_path>/runs/<出どころ>/<項目 ID>/<run ID>/` に残ります。出どころは `register`・`schedule`・`job` です。停止位置と再開可否はここを見て判断します。
|
|
413
|
+
|
|
414
|
+
旧配置の `<execution_path>/exec/evidence/<task-id>/<run-id>/` に checkpoint がある run は、`--resume`(`--resume-from executor` を含む)後も同じ run ID とディレクトリへ記録を続けます。executor を再実行すると、前回の state・evidence・ログを同じ場所の `*.attempt-N.*` に退避します。統合では result の配置にかかわらず現在の run の記録を commit します。commit 対象から外した別 run の記録は、ほかの許可外の変更とともに標準出力と `integrate.log` に一覧を表示します。
|
|
400
415
|
|
|
401
416
|
| ファイル | 確認できること |
|
|
402
417
|
| --------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
|
|
@@ -406,7 +421,7 @@ run ごとの実行記録は `<execution_path>/exec/evidence/<task-id>/<run-id>/
|
|
|
406
421
|
| `reporter-attempt-<n>.stdout.log` / `reporter-attempt-<n>.stderr.log` | 失敗した reporter の形式試行別の生出力(秘匿値は伏せ字化、各ストリーム 64KiB で切り詰め) |
|
|
407
422
|
| `integrate.log` | checkpoint・統合段の commit / merge 失敗の stdout / stderr 全文(秘匿値は伏せ字化) |
|
|
408
423
|
|
|
409
|
-
agent ログは人が調査するための参照先で、reporter には渡りません。reporter が受け取るのは plan、runner 管理記録を除いた `evidence.json` の変更一覧、文章項目と対応づけ用パスだけの出力スキーマです。runner 管理記録は、解決済みの execution path 配下の evidence、project register とその派生ビュー、当該 result のパスを基準に除外します。ただし executor の試行中に runner 管理記録が実際に変わった場合、そのパスと状態は reporter 専用の `runner_context.runner_managed_attempt_changes` に含めます。reporter は、executor の最終メッセージがその変更に触れたのに `changed_files` にないという理由だけで確認を求めません。result の変更パスはこの除外後の `changes`、`outcome` と `block_reason` は executor の stage・終了コード・保護理由と検証結果から runner が機械生成します。executor または親 runner の検証に failed / `not_run` があれば blocked です。executor の `not_run` は、親 runner が同じコマンドを project で実行して成功していれば満たされたものとして扱います。また、対応する npm script がない、`npx` の package
|
|
424
|
+
agent ログは人が調査するための参照先で、reporter には渡りません。reporter が受け取るのは plan、runner 管理記録を除いた `evidence.json` の変更一覧、文章項目と対応づけ用パスだけの出力スキーマです。runner 管理記録は、解決済みの execution path 配下の evidence、project register とその派生ビュー、当該 result のパスを基準に除外します。ただし executor の試行中に runner 管理記録が実際に変わった場合、そのパスと状態は reporter 専用の `runner_context.runner_managed_attempt_changes` に含めます。reporter は、executor の最終メッセージがその変更に触れたのに `changed_files` にないという理由だけで確認を求めません。result の変更パスはこの除外後の `changes`、`outcome` と `block_reason` は executor の stage・終了コード・保護理由と検証結果から runner が機械生成します。executor または親 runner の検証に failed / `not_run` があれば blocked です。executor の `not_run` は、親 runner が同じコマンドを project で実行して成功していれば満たされたものとして扱います。また、対応する npm script がない、`npx` の package が未導入、変更ファイル種別を含む適用条件を満たさない、または SpecDojo サブコマンドの設定上の適用条件を満たさないと runner が確定できる場合は適用外として block せず、result の申し送りへ「適用外の検証(runner の判定)」を残します。この判定は reporter 専用の `runner_context.mechanically_not_applicable` にも含め、reporter は同じ検証の実行を申し送りで求めません。変更範囲の判定では、runner が生成・更新する `exec/` 配下(`plans/`・`results/`・`evidence/`・`events/`・`.locks/`)を executor の変更ファイルから除外します。`validate:history-links`(`specdojo-docs-lint history-links` を含む)は履歴蓄積ファイル(`pjr-*.md`(`pjr-index.md` を除く)、または executor 自身が変更した `execution/runs/<origin>/<item>/<run>/` 配下の `plan.md`・`result.md` や旧来の `exec/plans/**/*.md`・`exec/results/**/*.md`)の変更がある場合だけ適用対象とします。`catalog validate`(`npm run validate:catalog` および `tools/catalog-validate-if-configured.mjs` を含む)は対象 project の `catalog_path` と、runner 管理記録を除いた変更が `docs/ja/projects/` 配下に及ぶかで判定し、設定や対象 project を特定できない場合と適用条件が未定義のサブコマンドは救済しません。対象 project は `--project <id>`、run の対象 project、`current_project` の順に決めるため、別の project の `catalog_path` では判定しません。`<repo>:<path>` を引数に含むコマンドや `--prefix <repo>` 付きのコマンドは、そのプロダクトリポジトリの `package.json` で判定します。`npm run <name> -- <args>` と `npm run <name> <args>` も `<name>` の script が存在すれば適用外の申告を反証しますが、引数付きコマンドを親 runner が実行した引数なしコマンドと同一とはみなしません。`npm run check` のような合成コマンドは、構成する各コマンドが親 runner か executor の検証で通っていれば満たされたものとして扱います。理由付きの `not_applicable` は block せず result の申し送りへ残しますが、理由がない場合や、変更ファイル種別を含む適用条件を満たしたうえで存在する npm script/依存 package を適用外とした場合は blocked です。ただし SpecDojo サブコマンドは package の有無だけでは反証せず、既知の適用条件を設定から判定します。executor の `requires_human` は sandbox 外で人が行う確認として block せず、runner が edit result の申し送りへ「人の確認が必要: `<コマンド>`(<要約>)」を機械的に追記します。reporter は実施内容、パスと対にした各変更の説明、申し送り、approach、review の判断根拠と改善指示だけを返します。runner はパスで説明を突き合わせ、順序は問いません。説明がない evidence のパスには差分参照を促す既定文を記録し、evidence にないパスの説明は捨てるため、件数の過不足で result の作成は失敗しません。機械管理項目を追加した出力は形式不正として拒否されます。失敗理由の要約だけでは原因が分からない場合は、記録済み `evidence.json` の `log_refs` から stdout / stderr を個別に確認します。ログは Git 管理対象の evidence ディレクトリにありますが、失敗中の worktree では未コミットのため、`--force-restart` などで破棄する前に確認します(詳細は [exec設定ガイド](exec-config-guide.md) の `evidence とログの引き渡し方針`)。
|
|
410
425
|
|
|
411
426
|
stage 別の失敗と対応は次のとおりです。
|
|
412
427
|
|
|
@@ -526,6 +541,25 @@ reporter 段の再開の入力は、`pipeline-state.json`(stage 状態と plan
|
|
|
526
541
|
|
|
527
542
|
統合段の再開は、executor と reporter が成功したまま commit・merge・worktree 撤去のいずれかが失敗した run が対象です。worktree は統合が完了したときにだけ撤去されるため、reporter 成功済みの worktree が残っていること自体が統合の未完了を意味します。この再開では agent を1つも起動せず、worktree に残っている成果物と記入済み result をそのまま統合します。前回の試行で merge まで完了していた場合は、取り込み済みの exec ブランチを再 merge せずに残りの手順(worktree 撤去と `register review`)だけを進めます。再開の開始時に項目は `in-progress` へ戻り、成功なら `review`、失敗なら `waiting` へ遷移するため、再試行の成否は登録簿の状態とイベントに残ります。統合段の進捗(開始と失敗)は `pipeline-state.json` の `integrate` にも記録します。
|
|
528
543
|
|
|
544
|
+
register の統合で許可外の追加など commit 対象外の変更が見つかると、成果物の commit・merge を止め、項目を `waiting` にして worktree を保持します。`block_reason` に未 commit の件数・先頭3件のパス・worktree 内の `integrate.log` の場所、run の最後の要約に `uncommitted=<件数>` を表示します。ログには全対象パスが残ります。移動元の削除が許可内でも、移動先が許可外なら同じ扱いです。
|
|
545
|
+
|
|
546
|
+
新しい最上位ディレクトリへの移動など必要な変更の場合は、ログと差分を確認し、利用者の承認後に保持した worktree で対象パスを明示して commit します。次は `docs/ja/product/trash/` から `archive/ja/product/trash/` への移動の例です。`<worktree-path>` は停止時に表示された場所に置き換えます。
|
|
547
|
+
|
|
548
|
+
```bash
|
|
549
|
+
git -C <worktree-path> status --short --untracked-files=all
|
|
550
|
+
git -C <worktree-path> diff -- docs/ja/product/trash/
|
|
551
|
+
# 移動先の内容と links.json も確認し、利用者の承認を得てから実行する
|
|
552
|
+
git -C <worktree-path> add -A -- docs/ja/product/trash/ archive/ja/product/trash/
|
|
553
|
+
git -C <worktree-path> diff --cached --stat
|
|
554
|
+
git -C <worktree-path> commit -m "Archive documents approved by user"
|
|
555
|
+
```
|
|
556
|
+
|
|
557
|
+
その後、統合先の worktree から次を実行します。executor と reporter を再実行せず、手動 commit と残りの成果物を統合します。不要な一時ファイルだった場合は worktree 内で対象だけを除去してから同じコマンドで再開します。新しいディレクトリの自動許可や `--force-restart` による破棄は必要ありません。
|
|
558
|
+
|
|
559
|
+
```bash
|
|
560
|
+
specdojo exec run --project <project-id> --register <PJR-ID> --worktree --resume
|
|
561
|
+
```
|
|
562
|
+
|
|
529
563
|
`specdojo.config.json` の project に `repos` を宣言している場合、統合段は宣言順のプロダクトリポジトリ、最後にプロジェクトリポジトリの順で統合し、リポジトリ別の状態(`pending` / `merged` / `unchanged` / `failed`)を `pipeline-state.json` の `integrate.repos` に記録します。途中で失敗すると、統合済みのリポジトリはそのまま残し、項目を `waiting` へ戻して全リポジトリの worktree を保持します。統合段の再開では、統合先へ取り込み済みのプロダクトを merge し直さず、失敗したリポジトリから統合を続けます。統合の順序と部分状態の詳細は [[specdojo:docs-structure-guide|ドキュメント構成ガイド]] の「複数リポジトリの統合の失敗と再開」を参照してください。
|
|
530
564
|
|
|
531
565
|
再開できるかどうかは、対象 worktree の最新 run だけで判定します。次の場合は worktree・exec ブランチ・未コミットの成果を一切変更せず、理由を出力して終了コード 1 で終わります。
|
|
@@ -667,6 +701,8 @@ specdojo:
|
|
|
667
701
|
- **対象(`targets`)**: 成果物カタログ(DCT)に定義されている成果物の文書 ID(doc id)を指定します(例: `prj-0001:cxd-specdojo`、`specdojo:exec-config-guide`)。プロダクト成果物の場合は `local_id` の canonical 形式(`<project-id>:<local_id>`)も受け付けます。まだ文書ファイルが作成されていない成果物であっても、カタログに定義されていればカタログで解決され、起票・実行できます。
|
|
668
702
|
- **進め方(`approach`)**: 成果物を作成・修正する進め方(`draft`(文脈を調べて下書き)、`fully-guided`(既存成果物の磨き込み)、`recipe-guided`、`freeform`、`bootstrap`、`retrofit`、`cross-deliverable-dedup` など)から目的に応じて選びます。
|
|
669
703
|
|
|
704
|
+
`draft`・`fully-guided`・`recipe-guided` の edit plan は、カタログの `evidence_refs` を「実装エビデンスと未作成の依存」節へ展開します。列挙された実装は読み取り専用で、変更許可範囲と commit 対象には入りません。`evidence_refs` がない場合やカタログなしの場合も、それだけでは停止しません。未作成の `depends_on` はインラインコードと「未作成」で示し、内容を推測せず _TODO_ / _ASSUMPTION_ と次のアクションを残して進めます。資料が食い違うときの根拠の使い分けは [[specdojo:ryu-guide|実践の進め方ガイド]] を参照してください。
|
|
705
|
+
|
|
670
706
|
#### 4.3.2. kata(実践の型)を対象にする場合
|
|
671
707
|
|
|
672
708
|
- **対象(`targets`)**: kata の文書 ID(doc id)を指定します(例: `specdojo:pjr-rulebook`、`specdojo:exec-human-finalize-recipe` など)。kata は文書索引(doc-index)で解決されます。
|