specdojo 0.6.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 +193 -0
- package/README.md +2 -2
- package/dist/catalog/build.js +24 -1
- package/dist/catalog/plan.js +1 -1
- package/dist/catalog/scaffold.js +4 -1
- package/dist/commands/agent.js +33 -0
- package/dist/commands/init.js +6 -1
- package/dist/commands/night-orchestrator.js +6 -4
- package/dist/commands/orchestrator.js +10 -1
- 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/command.js +18 -0
- package/dist/devcontainer/host-script.js +21 -0
- package/dist/devcontainer/scaffold.js +22 -3
- 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/antigravity-session.js +154 -0
- 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 +160 -12
- package/dist/exec/pipeline-state.js +27 -5
- package/dist/exec/plan-markdownlint.js +89 -0
- package/dist/exec/plans-condense-findings.js +89 -0
- package/dist/exec/plans-core.js +24 -17
- package/dist/exec/plans-generation.js +52 -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 +69 -42
- 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 +264 -43
- package/dist/exec/run/mode-shared.js +11 -3
- package/dist/exec/run/register-command.js +12 -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 +26 -6
- package/dist/exec/run/schedule-prepare.js +228 -45
- package/dist/exec/run/schedule-task.js +132 -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 +118 -59
- package/dist/exec/worktree-ops-lifecycle.js +77 -44
- 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 +74 -32
- 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 +149 -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/provider-scaffold.js +2 -0
- package/dist/shared/run-records.js +224 -0
- package/dist/shared/specdojo-config.js +39 -21
- package/dist/shared/specdojo-gitignore.js +1 -0
- package/dist/shared/text.js +65 -5
- package/dist/shared/timeline-index.js +2 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -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 +48 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
- package/docs/ja/specdojo/guides/exec-config-guide.md +61 -28
- package/docs/ja/specdojo/guides/exec-operation-guide.md +61 -13
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
- 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 +589 -807
- package/docs/ja/specdojo/guides/register-operation-guide.md +26 -4
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +33 -4
- 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 +41 -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 +471 -74
- 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-overview-recipe.md +88 -86
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +108 -122
- 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 +146 -99
- 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-d2-rulebook.md +367 -0
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +132 -106
- 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-overview-sample.md +248 -140
- package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +130 -97
- 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-overview-template.md +161 -83
- package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
- package/docs/ja/specdojo/templates/cdfd-uc-template.md +130 -89
- 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 +54 -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/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -0
- package/package.json +6 -3
- package/templates/antigravity/README.md +19 -46
- package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
- package/templates/antigravity/orchestrator.md +3 -2
- package/templates/antigravity/settings.edit.json +73 -0
- package/templates/antigravity/settings.orchestrator.json +15 -0
- package/templates/antigravity/settings.report.json +7 -0
- package/templates/antigravity/settings.review.json +7 -0
- 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/remote-host/devcontainer-tmux.sh +217 -0
- package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -96
- package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
- package/templates/devcontainer/tmux.conf +6 -0
- package/templates/init-agent-members.yaml +1 -0
- package/templates/init-exec-defaults.yaml +1 -1
- package/templates/opencode/agents/specdojo-orchestrator.md +3 -2
|
@@ -0,0 +1,217 @@
|
|
|
1
|
+
#!/usr/bin/env bash
|
|
2
|
+
#
|
|
3
|
+
# devcontainer-tmux.sh
|
|
4
|
+
#
|
|
5
|
+
# SpecDojo が配布する、ホストから devcontainer 内の tmux セッションへ入るためのスクリプト本体です。
|
|
6
|
+
# workspace の .specdojo/host/devcontainer-tmux.sh へ書き出され、ホスト側のラッパーから呼ばれます。
|
|
7
|
+
#
|
|
8
|
+
# 対応 OS:
|
|
9
|
+
# - macOS
|
|
10
|
+
# - Linux
|
|
11
|
+
# - Windows WSL2
|
|
12
|
+
#
|
|
13
|
+
set -euo pipefail
|
|
14
|
+
|
|
15
|
+
if [ $# -lt 1 ] || [ -z "${1:-}" ]; then
|
|
16
|
+
echo "Usage: $0 <workspace-path>" >&2
|
|
17
|
+
exit 1
|
|
18
|
+
fi
|
|
19
|
+
|
|
20
|
+
workspace_dir_input="$1"
|
|
21
|
+
if [ ! -d "$workspace_dir_input" ]; then
|
|
22
|
+
echo "Workspace directory not found: $workspace_dir_input" >&2
|
|
23
|
+
exit 1
|
|
24
|
+
fi
|
|
25
|
+
|
|
26
|
+
workspace_dir="$(cd "$workspace_dir_input" && pwd -P)"
|
|
27
|
+
|
|
28
|
+
devcontainer_json="$workspace_dir/.devcontainer/devcontainer.json"
|
|
29
|
+
if [ ! -f "$devcontainer_json" ]; then
|
|
30
|
+
if [ -f "$workspace_dir/.devcontainer.json" ]; then
|
|
31
|
+
devcontainer_json="$workspace_dir/.devcontainer.json"
|
|
32
|
+
else
|
|
33
|
+
echo "devcontainer.json was not found in $workspace_dir" >&2
|
|
34
|
+
exit 1
|
|
35
|
+
fi
|
|
36
|
+
fi
|
|
37
|
+
|
|
38
|
+
remote_user="$(sed -E -e 's,//.*$,,' -e 's,/\*.*\*/,,' "$devcontainer_json" | grep -E '"remoteUser"[[:space:]]*:' | head -n 1 | sed -E 's/.*"remoteUser"[[:space:]]*:[[:space:]]*"([^"]+)".*/\1/' || true)"
|
|
39
|
+
|
|
40
|
+
if [ -z "$remote_user" ]; then
|
|
41
|
+
echo "remoteUser is not defined in $devcontainer_json" >&2
|
|
42
|
+
exit 1
|
|
43
|
+
fi
|
|
44
|
+
|
|
45
|
+
# docker の探索は最初の呼び出しより前に行う。SSH の PATH だけには依存しない。
|
|
46
|
+
docker_dir=""
|
|
47
|
+
docker_search_path="$PATH"
|
|
48
|
+
docker_login_shell="${SHELL:-/bin/bash}"
|
|
49
|
+
docker_candidates=(
|
|
50
|
+
/usr/local/bin
|
|
51
|
+
/opt/homebrew/bin
|
|
52
|
+
"${HOME:-}/.docker/bin"
|
|
53
|
+
/Applications/Docker.app/Contents/Resources/bin
|
|
54
|
+
/snap/bin
|
|
55
|
+
/usr/bin
|
|
56
|
+
)
|
|
57
|
+
|
|
58
|
+
select_docker() {
|
|
59
|
+
local candidate="$1" candidate_dir
|
|
60
|
+
# command -v が返す alias や関数の説明は受け付けない。
|
|
61
|
+
case "$candidate" in
|
|
62
|
+
*/docker) ;;
|
|
63
|
+
*) return 1 ;;
|
|
64
|
+
esac
|
|
65
|
+
[ -f "$candidate" ] && [ -x "$candidate" ] || return 1
|
|
66
|
+
candidate_dir="${candidate%/*}"
|
|
67
|
+
candidate_dir="$(cd "${candidate_dir:-/}" && pwd -P)" || return 1
|
|
68
|
+
docker_dir="$candidate_dir"
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
docker_hint() {
|
|
72
|
+
local failure="$1" host_os kernel
|
|
73
|
+
host_os="$(uname -s 2>/dev/null || true)"
|
|
74
|
+
kernel="$(uname -r 2>/dev/null || true)"
|
|
75
|
+
case "$host_os" in
|
|
76
|
+
Darwin)
|
|
77
|
+
if [ "$failure" = missing ]; then
|
|
78
|
+
echo "macOS: Install Docker Desktop." >&2
|
|
79
|
+
else
|
|
80
|
+
echo "macOS: Start Docker Desktop and check the Docker context." >&2
|
|
81
|
+
fi
|
|
82
|
+
;;
|
|
83
|
+
Linux)
|
|
84
|
+
if printf '%s\n' "$kernel" | grep -qi microsoft || grep -qi microsoft /proc/version 2>/dev/null; then
|
|
85
|
+
echo "WSL2: Start Docker Desktop and enable WSL integration for this distribution." >&2
|
|
86
|
+
elif [ "$failure" = missing ]; then
|
|
87
|
+
echo "Linux: Install Docker Engine." >&2
|
|
88
|
+
else
|
|
89
|
+
echo "Linux: Start the docker service and check membership in the docker group (then log in again)." >&2
|
|
90
|
+
fi
|
|
91
|
+
;;
|
|
92
|
+
*) echo "Install and start Docker, and check the Docker context and access permissions." >&2 ;;
|
|
93
|
+
esac
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
if [ -n "${SPECDOJO_DOCKER_BIN:-}" ]; then
|
|
97
|
+
# 明示指定はディレクトリ。誤指定を別の Docker で隠さず、下で診断する。
|
|
98
|
+
select_docker "$SPECDOJO_DOCKER_BIN/docker" || true
|
|
99
|
+
else
|
|
100
|
+
if ! select_docker "$(command -v docker || true)"; then
|
|
101
|
+
# 起動時のメッセージを無視し、問い合わせの印が付いた実行ファイルだけを採る。
|
|
102
|
+
# shellcheck disable=SC2016
|
|
103
|
+
login_output="$("$docker_login_shell" -lc 'printf "\n__SPECDOJO_DOCKER__"; command -v docker' 2>/dev/null)" || login_output=""
|
|
104
|
+
while IFS= read -r line; do
|
|
105
|
+
case "$line" in
|
|
106
|
+
__SPECDOJO_DOCKER__*)
|
|
107
|
+
if select_docker "${line#__SPECDOJO_DOCKER__}"; then
|
|
108
|
+
break
|
|
109
|
+
fi
|
|
110
|
+
;;
|
|
111
|
+
esac
|
|
112
|
+
done <<< "$login_output"
|
|
113
|
+
if [ -z "$docker_dir" ]; then
|
|
114
|
+
for candidate_dir in "${docker_candidates[@]}"; do
|
|
115
|
+
if select_docker "$candidate_dir/docker"; then
|
|
116
|
+
break
|
|
117
|
+
fi
|
|
118
|
+
done
|
|
119
|
+
fi
|
|
120
|
+
fi
|
|
121
|
+
fi
|
|
122
|
+
|
|
123
|
+
if [ -z "$docker_dir" ]; then
|
|
124
|
+
echo "Docker executable not found." >&2
|
|
125
|
+
if [ -n "${SPECDOJO_DOCKER_BIN:-}" ]; then
|
|
126
|
+
echo "Searched SPECDOJO_DOCKER_BIN: $SPECDOJO_DOCKER_BIN/docker (must be an executable file)." >&2
|
|
127
|
+
else
|
|
128
|
+
echo "Searched PATH: $docker_search_path" >&2
|
|
129
|
+
echo "Queried login shell: $docker_login_shell -lc 'command -v docker'" >&2
|
|
130
|
+
printf 'Searched directory: %s\n' "${docker_candidates[@]}" >&2
|
|
131
|
+
fi
|
|
132
|
+
docker_hint missing
|
|
133
|
+
exit 1
|
|
134
|
+
fi
|
|
135
|
+
|
|
136
|
+
export PATH="$docker_dir:$PATH"
|
|
137
|
+
if ! docker info >/dev/null 2>&1; then
|
|
138
|
+
echo "Docker is not usable: $docker_dir/docker (docker info failed)." >&2
|
|
139
|
+
docker_hint unavailable
|
|
140
|
+
exit 1
|
|
141
|
+
fi
|
|
142
|
+
|
|
143
|
+
# 1. 動いているコンテナを探す
|
|
144
|
+
container_id="$(docker ps -q --filter "label=devcontainer.local_folder=$workspace_dir" | head -n 1)"
|
|
145
|
+
|
|
146
|
+
# 2. 止まっているコンテナがあれば docker start で起こす
|
|
147
|
+
if [ -z "$container_id" ]; then
|
|
148
|
+
stopped_id="$(docker ps -a -q --filter "label=devcontainer.local_folder=$workspace_dir" | head -n 1)"
|
|
149
|
+
if [ -n "$stopped_id" ]; then
|
|
150
|
+
docker start "$stopped_id" >/dev/null
|
|
151
|
+
container_id="$stopped_id"
|
|
152
|
+
fi
|
|
153
|
+
fi
|
|
154
|
+
|
|
155
|
+
# 3. コンテナが無いときだけ devcontainer up を動かす
|
|
156
|
+
if [ -z "$container_id" ]; then
|
|
157
|
+
echo "Starting devcontainer for $workspace_dir..." >&2
|
|
158
|
+
if [ -n "${SPECDOJO_NODE_BIN:-}" ]; then
|
|
159
|
+
PATH="$docker_dir:$SPECDOJO_NODE_BIN:$PATH" devcontainer up --workspace-folder "$workspace_dir" >&2
|
|
160
|
+
else
|
|
161
|
+
# shellcheck disable=SC2016
|
|
162
|
+
"${SHELL:-/bin/bash}" -lic 'export PATH="$1:$PATH"; exec devcontainer up --workspace-folder "$2"' devcontainer-launcher "$docker_dir" "$workspace_dir" >&2
|
|
163
|
+
fi
|
|
164
|
+
container_id="$(docker ps -q --filter "label=devcontainer.local_folder=$workspace_dir" | head -n 1)"
|
|
165
|
+
fi
|
|
166
|
+
|
|
167
|
+
if [ -z "$container_id" ]; then
|
|
168
|
+
echo "Failed to start or find devcontainer for $workspace_dir" >&2
|
|
169
|
+
exit 1
|
|
170
|
+
fi
|
|
171
|
+
|
|
172
|
+
# 4. コンテナ内の作業ディレクトリをマウント情報から求める
|
|
173
|
+
mounts_info="$(docker inspect --format '{{range .Mounts}}{{printf "%s\t%s\t%s\n" .Type .Source .Destination}}{{end}}' "$container_id")"
|
|
174
|
+
best_match_src=""
|
|
175
|
+
best_match_dst=""
|
|
176
|
+
|
|
177
|
+
while IFS=$'\t' read -r m_type m_src m_dst; do
|
|
178
|
+
[ "$m_type" != "bind" ] && continue
|
|
179
|
+
[ -z "$m_src" ] && continue
|
|
180
|
+
|
|
181
|
+
norm_src="$m_src"
|
|
182
|
+
if [ -d "$m_src" ]; then
|
|
183
|
+
norm_src="$(cd "$m_src" && pwd -P)"
|
|
184
|
+
fi
|
|
185
|
+
|
|
186
|
+
if [ "$workspace_dir" = "$norm_src" ]; then
|
|
187
|
+
best_match_src="$norm_src"
|
|
188
|
+
best_match_dst="$m_dst"
|
|
189
|
+
break
|
|
190
|
+
elif [ "${workspace_dir#"$norm_src"/}" != "$workspace_dir" ]; then
|
|
191
|
+
if [ ${#norm_src} -gt ${#best_match_src} ]; then
|
|
192
|
+
best_match_src="$norm_src"
|
|
193
|
+
best_match_dst="$m_dst"
|
|
194
|
+
fi
|
|
195
|
+
fi
|
|
196
|
+
done <<< "$mounts_info"
|
|
197
|
+
|
|
198
|
+
if [ -z "$best_match_src" ]; then
|
|
199
|
+
echo "Could not determine container workspace directory from mounts for: $workspace_dir" >&2
|
|
200
|
+
exit 1
|
|
201
|
+
fi
|
|
202
|
+
|
|
203
|
+
if [ "$workspace_dir" = "$best_match_src" ]; then
|
|
204
|
+
container_workspace_dir="$best_match_dst"
|
|
205
|
+
else
|
|
206
|
+
rel_path="${workspace_dir#"$best_match_src"/}"
|
|
207
|
+
container_workspace_dir="${best_match_dst%/}/$rel_path"
|
|
208
|
+
fi
|
|
209
|
+
|
|
210
|
+
if ! docker exec "$container_id" test -d "$container_workspace_dir"; then
|
|
211
|
+
echo "Workspace directory '$container_workspace_dir' does not exist in container '$container_id'." >&2
|
|
212
|
+
exit 1
|
|
213
|
+
fi
|
|
214
|
+
|
|
215
|
+
# 5. tmux セッションへ入る
|
|
216
|
+
session_name="${SPECDOJO_TMUX_SESSION:-specdojo}"
|
|
217
|
+
exec docker exec -it --detach-keys="ctrl-]" -u "$remote_user" -w "$container_workspace_dir" "$container_id" tmux new-session -A -s "$session_name"
|
|
@@ -5,104 +5,16 @@
|
|
|
5
5
|
# 常時稼働ホスト上で devcontainer 内の tmux セッションへ入るためのスクリプトです。
|
|
6
6
|
# ホスト側の ~/bin/specdojo-tmux.sh などへコピーし、実行権限(chmod +x)を付与して使用してください。
|
|
7
7
|
#
|
|
8
|
-
#
|
|
9
|
-
#
|
|
10
|
-
# - Dev Container CLI (@devcontainers/cli): コンテナの起動に使用 (npm install -g @devcontainers/cli)
|
|
11
|
-
# - tmux: コンテナ内にインストールされている必要があります
|
|
12
|
-
#
|
|
13
|
-
# 起動コマンド:
|
|
14
|
-
# - コンテナ起動: devcontainer up --workspace-folder "$workspace_dir"
|
|
15
|
-
# - セッション接続: docker exec -it ... tmux new-session -A -s <名前>
|
|
16
|
-
#
|
|
17
|
-
# コンテナの特定(ラベルの一致):
|
|
18
|
-
# - スクリプトはラベル devcontainer.local_folder が workspace_dir と一致する
|
|
19
|
-
# コンテナを探して接続します。
|
|
20
|
-
# - ラベルが workspace_dir と一致しないと、devcontainer up が別の新しいコンテナを作ります。
|
|
21
|
-
# - 既存コンテナのラベルは次のコマンドで確認できます:
|
|
22
|
-
# docker inspect <id> --format '{{index .Config.Labels "devcontainer.local_folder"}}'
|
|
8
|
+
# 実際の処理本体は各 workspace の .specdojo/host/devcontainer-tmux.sh が行います。
|
|
9
|
+
# 本体のスクリプトは `npx specdojo devcontainer host-script` で書き出せます。
|
|
23
10
|
#
|
|
24
|
-
#
|
|
25
|
-
# -
|
|
26
|
-
# -
|
|
27
|
-
#
|
|
28
|
-
# PATH の設定(SSH 経由での実行):
|
|
29
|
-
# - ssh の RemoteCommand は非対話シェルで動くため、Mac の通常端末で読み込まれる
|
|
30
|
-
# ~/.zshrc などの PATH の設定が反映されません。
|
|
31
|
-
# - ホスト側の通常端末で node と devcontainer の配置場所を確認し、必要に応じて
|
|
32
|
-
# 下記 node_bin_dir を設定してください:
|
|
33
|
-
# dirname "$(command -v devcontainer)"
|
|
34
|
-
# - Homebrew の例: node_bin_dir="/opt/homebrew/bin"
|
|
35
|
-
# - nvm の例: node_bin_dir="$HOME/.nvm/versions/node/v22.0.0/bin"
|
|
36
|
-
# - mise の例: node_bin_dir="$HOME/.local/share/mise/installs/node/24/bin"
|
|
37
|
-
# - node と Dev Container CLI は同じ node_bin_dir にあることを前提とします。
|
|
11
|
+
# 前提ツール:
|
|
12
|
+
# - Docker (Docker Desktop または Docker Engine)
|
|
13
|
+
# - Dev Container CLI (@devcontainers/cli): コンテナ未作成時のみ起動に使用
|
|
38
14
|
#
|
|
39
15
|
set -euo pipefail
|
|
40
16
|
|
|
41
|
-
#
|
|
42
|
-
|
|
43
|
-
workspace_dir="${HOME}/<path-to-workspace>/<repo-name>"
|
|
44
|
-
|
|
45
|
-
# コンテナ内の実行ユーザー(devcontainer.json の remoteUser に合わせます。既定は node です)
|
|
46
|
-
# remoteUser を変更した場合は、この値を変更してください。
|
|
47
|
-
container_user="node"
|
|
48
|
-
|
|
49
|
-
# セッション名(必要に応じて変更してください)
|
|
50
|
-
session_name="specdojo"
|
|
51
|
-
|
|
52
|
-
# Mac や Linux の通常端末で確認した実際のディレクトリへ置き換えてください。
|
|
53
|
-
# Homebrew の例: node_bin_dir="/opt/homebrew/bin"
|
|
54
|
-
# nvm の例: node_bin_dir="$HOME/.nvm/versions/node/v22.0.0/bin"
|
|
55
|
-
# mise の例: node_bin_dir="$HOME/.local/share/mise/installs/node/24/bin"
|
|
56
|
-
# node と Dev Container CLI は同じ node_bin_dir にあることを前提とします。
|
|
57
|
-
node_bin_dir="/absolute/path/to/node/bin"
|
|
58
|
-
export PATH="$node_bin_dir:/opt/homebrew/bin:/usr/local/bin:$PATH"
|
|
59
|
-
|
|
60
|
-
find_container() {
|
|
61
|
-
docker ps -q --filter "label=devcontainer.local_folder=$workspace_dir" | head -n 1
|
|
62
|
-
}
|
|
63
|
-
|
|
64
|
-
if [ ! -f "$workspace_dir/.devcontainer/devcontainer.json" ]; then
|
|
65
|
-
echo "devcontainer.json was not found: $workspace_dir" >&2
|
|
66
|
-
echo "Set workspace_dir to the repository path on the host." >&2
|
|
67
|
-
exit 1
|
|
68
|
-
fi
|
|
69
|
-
|
|
70
|
-
if ! command -v devcontainer >/dev/null 2>&1; then
|
|
71
|
-
echo "Dev Container CLI is not installed or not in PATH." >&2
|
|
72
|
-
echo "Current PATH: $PATH" >&2
|
|
73
|
-
echo "Check the location on the host terminal with: dirname \"\$(command -v devcontainer)\"" >&2
|
|
74
|
-
echo "Install it with: npm install -g @devcontainers/cli" >&2
|
|
75
|
-
exit 1
|
|
76
|
-
fi
|
|
77
|
-
|
|
78
|
-
if ! command -v docker >/dev/null 2>&1; then
|
|
79
|
-
echo "Docker command was not found in PATH." >&2
|
|
80
|
-
echo "Current PATH: $PATH" >&2
|
|
81
|
-
echo "Check the location on the host terminal with: dirname \"\$(command -v docker)\"" >&2
|
|
82
|
-
exit 1
|
|
83
|
-
fi
|
|
84
|
-
|
|
85
|
-
if ! docker info >/dev/null 2>&1; then
|
|
86
|
-
echo "Docker is not running on the host." >&2
|
|
87
|
-
exit 1
|
|
88
|
-
fi
|
|
89
|
-
|
|
90
|
-
container_name="$(find_container)"
|
|
91
|
-
|
|
92
|
-
if [ -z "$container_name" ]; then
|
|
93
|
-
echo "Starting devcontainer..." >&2
|
|
94
|
-
devcontainer up --workspace-folder "$workspace_dir" >&2
|
|
95
|
-
container_name="$(find_container)"
|
|
96
|
-
fi
|
|
97
|
-
|
|
98
|
-
if [ -z "$container_name" ]; then
|
|
99
|
-
echo "The devcontainer did not start." >&2
|
|
100
|
-
exit 1
|
|
101
|
-
fi
|
|
102
|
-
|
|
103
|
-
if ! docker exec "$container_name" test -d "$container_workspace_dir"; then
|
|
104
|
-
echo "Workspace directory '$container_workspace_dir' was not found in container '$container_name'." >&2
|
|
105
|
-
exit 1
|
|
106
|
-
fi
|
|
17
|
+
# ホスト上のワークスペースのパス(実際の配置場所に合わせて書き換えてください)
|
|
18
|
+
workspace_dir="${1:-$HOME/<path-to-workspace>/<repo-name>}"
|
|
107
19
|
|
|
108
|
-
exec
|
|
20
|
+
exec bash "$workspace_dir/.specdojo/host/devcontainer-tmux.sh" "$workspace_dir"
|
|
@@ -8,8 +8,10 @@ Host <host>
|
|
|
8
8
|
|
|
9
9
|
# devcontainer 内の tmux セッションへ直接入る接続用
|
|
10
10
|
# RemoteCommand は非対話シェルで動くため、接続先端末の ~/.zshrc などの PATH 設定は読み込まれません。
|
|
11
|
+
# 通常の接続(コンテナ稼働中または停止中)では Node.js は不要です(docker のみ使用)。
|
|
12
|
+
# コンテナ未作成時のみ Dev Container CLI が自動起動されます。
|
|
11
13
|
# 接続元から「ssh <host> 'command -v devcontainer'」を実行して Dev Container CLI が見つかるか確認できます。
|
|
12
|
-
#
|
|
14
|
+
# 見つからない場合は、ホストの環境変数 SPECDOJO_NODE_BIN を設定するか、ログインシェルの PATH を確認してください。
|
|
13
15
|
Host <host>-tmux
|
|
14
16
|
HostName <host>
|
|
15
17
|
User <user>
|
|
@@ -92,7 +92,7 @@ providers:
|
|
|
92
92
|
# 使える model の ID は `agy models` で確かめる。Gemini の Pro 系は提供されなくなったため、
|
|
93
93
|
# expert は Flash の high とする(2026-10-15、agy 1.3.5 で確認)。
|
|
94
94
|
# model の ID は実体の member の model に書く(PJR-ZM1K)。
|
|
95
|
-
command_template: '
|
|
95
|
+
command_template: 'specdojo agent launch --provider antigravity --role {mode} -- --sandbox --model {model} -p "$(cat)"'
|
|
96
96
|
rate_limit_detection:
|
|
97
97
|
stderr_patterns: [rate limit, "429", quota, RESOURCE_EXHAUSTED]
|
|
98
98
|
copilot:
|
|
@@ -279,6 +279,7 @@ npx specdojo exec validate --project <project-id>
|
|
|
279
279
|
- 完了条件にない変更(特に保護された設定や、利用者の環境に関わる設定)が入っていないかを確かめる。
|
|
280
280
|
- runner や CLI の動きを変えた項目は、統合の後に実際の `exec run --register` を 1 回流して動作を確かめてから close する。生成物を変えた項目は、空のリポジトリで生成して確かめる。
|
|
281
281
|
- 確かめられない条件(ホストでの確認など)が残る場合は close せず `review` のまま残し、利用者に確かめ方を示す。
|
|
282
|
+
- 確かめた結果、または利用者の確認で直す点が出たら、同じ目的・同じ対象のファイルの手直しは新しく起票しない。元の todo の完了条件に「n 回目の実行(日付)」として直す点を足し、`review` のまま `exec run --register` で流し直す。人の確定を待つ decision は、確定するまで開けたままにし、各回の指摘と判断を個票に足していく。目的が変わる、対象の型やファイルが変わる、元の項目を close してから時間がたっている、のどれかに当たるときだけ新しく起票する。
|
|
282
283
|
- 見つけた別の問題は、元の項目を `--from` で記録して起票する。完了条件の範囲を勝手に広げない。
|
|
283
284
|
|
|
284
285
|
## 止まったときの対処
|
|
@@ -288,7 +289,7 @@ npx specdojo exec validate --project <project-id>
|
|
|
288
289
|
| agent の rate limit・つながらない | `--fallback-executor-by` / `--fallback-reporter-by` で代わりの agent を指定して再開する。解除の時刻が分かれば待つ |
|
|
289
290
|
| 親の検証の失敗(型・lint・テストの本当の失敗) | `--resume --resume-from executor` で executor からやり直す。失敗した検証の結果が引き継がれる |
|
|
290
291
|
| 負荷による時間切れ | 負荷を下げてから `--resume` で親の検証を流し直す |
|
|
291
|
-
|
|
|
292
|
+
| 統合での衝突(同じファイルの同じ行など) | 両方の行を残す形に exec ブランチ側をそろえてから `--resume` する。記帳のファイルの衝突は runner に任せ、手で解かない |
|
|
292
293
|
| 保護された設定への変更 | worktree でその変更だけを戻して `--resume` するか、`exec handoff apply` で利用者の承認のもと当てる |
|
|
293
294
|
| commit の hook の失敗 | 失敗した段(markdownlint など)の出力を読み、記録のファイルを規約に合わせてから commit する |
|
|
294
295
|
| 既に統合済みで再開できない | 新しい run として `--force-restart` で流す |
|
|
@@ -297,7 +298,7 @@ npx specdojo exec validate --project <project-id>
|
|
|
297
298
|
|
|
298
299
|
- 検証できる形で書く。完了条件は `exec plan` の入力になり、曖昧だと agent が意図と違う範囲を実装する。
|
|
299
300
|
- 作業を終える前に流す検査(型検査・lint・単体テスト)と、通すべき親の検証を書く。
|
|
300
|
-
- CHANGELOG
|
|
301
|
+
- CHANGELOG の書き方は、プロジェクトの運用メモの決まりに従うと書く。決まりがなければ、各項目が CHANGELOG の同じ節へ直接書くと並べて流したときに統合で衝突しやすいことを踏まえ、書き方を利用者と決める。公開済みの版の節は変えないと書く。
|
|
301
302
|
- 保護された設定に触れる場合、register の項目では案を個票の対応結果に書き、pipeline では報告の `handoff` にも書く。反映は利用者の承認のもとで行うと書く。「result に書く」は executor が result を直接書ける実行形式に限る。
|
|
302
303
|
- 未決の点は `_UNDECIDED_` で残すか、executor に決めさせて理由を記録させるかを明記する。register の項目では個票の対応結果に書かせ、pipeline では報告の `handoff` にも書かせる。「result に書く」は executor が result を直接書ける実行形式に限る。
|
|
303
304
|
- Markdown では、`*` や `_` を含む語(glob など)をコードの書式にする。コードの書式の中を空白で始めたり終えたりしない。
|