specdojo 0.7.0 → 0.9.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 +7 -3
- package/CHANGELOG.md +217 -0
- package/dist/catalog/build.js +24 -1
- package/dist/catalog/catalog.js +16 -14
- package/dist/catalog/plan.js +1 -1
- package/dist/catalog/scaffold.js +4 -1
- package/dist/commands/agent.js +5 -3
- package/dist/commands/build.js +69 -10
- package/dist/commands/git.js +206 -0
- package/dist/commands/init.js +9 -3
- package/dist/commands/night-orchestrator.js +6 -4
- package/dist/commands/where.js +25 -0
- package/dist/dashboard/dashboard-timeline.js +18 -16
- package/dist/dashboard/dashboard.js +616 -261
- package/dist/dashboard/epic-plan.js +81 -0
- package/dist/dashboard/exec-records.js +16 -20
- package/dist/dashboard/routines.js +11 -12
- package/dist/dashboard/timeline-build.js +5 -9
- package/dist/dashboard/timeline.js +23 -18
- package/dist/devcontainer/scaffold.js +18 -0
- package/dist/docs/frontmatter-namespace.js +1 -48
- package/dist/docs/index-command.js +2 -2
- package/dist/docs/yaml-business-tables.js +243 -0
- package/dist/docs/yaml-interface-tables.js +106 -0
- package/dist/docs/yaml-pages-command.js +5 -3
- package/dist/docs/yaml-pages.js +268 -3
- package/dist/docs/yaml-table-shared.js +70 -0
- package/dist/docs/yaml-tables.js +39 -0
- package/dist/exec/agent-config.js +31 -0
- package/dist/exec/agent-plan.js +3 -2
- package/dist/exec/agent-protected-config.js +2 -0
- package/dist/exec/commands.js +100 -39
- package/dist/exec/commit-hook-skips.js +78 -0
- package/dist/exec/core.js +19 -7
- package/dist/exec/events.js +179 -8
- package/dist/exec/evidence.js +77 -19
- 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 +209 -15
- package/dist/exec/pipeline-state.js +27 -5
- package/dist/exec/plans-condense-findings.js +89 -0
- package/dist/exec/plans-core.js +45 -19
- package/dist/exec/plans-generation.js +52 -30
- 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/post-integration.js +162 -0
- package/dist/exec/queue-command.js +166 -0
- package/dist/exec/queue.js +285 -0
- package/dist/exec/register-foreign-wait.js +84 -0
- package/dist/exec/register-resume.js +55 -56
- package/dist/exec/register.js +26 -22
- package/dist/exec/repo-integration-sync.js +21 -5
- package/dist/exec/repo-integration.js +21 -1
- package/dist/exec/reporter.js +121 -23
- package/dist/exec/results.js +106 -25
- package/dist/exec/review-completion.js +47 -0
- package/dist/exec/review-kata.js +112 -0
- package/dist/exec/run/agent-pipeline.js +78 -8
- package/dist/exec/run/agent.js +32 -13
- package/dist/exec/run/change-scope.js +365 -0
- package/dist/exec/run/deferred-cleanup.js +31 -0
- package/dist/exec/run/in-place.js +73 -33
- package/dist/exec/run/job-lock.js +66 -0
- package/dist/exec/run/job-sequence.js +137 -0
- package/dist/exec/run/job.js +135 -41
- package/dist/exec/run/lifecycle-commands.js +189 -37
- package/dist/exec/run/lock.js +22 -1
- package/dist/exec/run/mode-shared.js +11 -3
- package/dist/exec/run/register-command.js +14 -15
- package/dist/exec/run/register-core.js +20 -13
- package/dist/exec/run/register-mode.js +77 -17
- package/dist/exec/run/register-post-review.js +21 -9
- package/dist/exec/run/register-resume.js +95 -31
- package/dist/exec/run/register-state.js +23 -15
- package/dist/exec/run/register-worktree.js +184 -139
- package/dist/exec/run/schedule-mode.js +79 -18
- package/dist/exec/run/schedule-prepare.js +204 -59
- package/dist/exec/run/schedule-task.js +203 -49
- package/dist/exec/run/shared.js +9 -3
- package/dist/exec/run/trailing-records.js +35 -0
- package/dist/exec/run-records.js +2 -0
- package/dist/exec/schedule/schedule.js +116 -4
- package/dist/exec/shared.js +1 -1
- package/dist/exec/smoke.js +190 -0
- package/dist/exec/strategy.js +14 -3
- package/dist/exec/task-view.js +6 -4
- package/dist/exec/trailing-records.js +242 -0
- package/dist/exec/trial-commands.js +8 -4
- package/dist/exec/trial-core.js +6 -1
- package/dist/exec/validate-records-commit.js +110 -0
- package/dist/exec/validate-records.js +148 -0
- package/dist/exec/validation-metrics.js +181 -0
- package/dist/exec/worktree-cleanup-lock.js +26 -0
- package/dist/exec/worktree-command.js +38 -17
- 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 +32 -4
- package/dist/grade/apply.js +32 -6
- package/dist/grade/command-apply.js +3 -3
- package/dist/grade/command-inspect.js +7 -5
- package/dist/grade/command-plan.js +1 -1
- package/dist/grade/command-run.js +7 -1
- 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 +87 -11
- package/dist/grade/target-discovery.js +17 -4
- package/dist/grade/targets.js +12 -11
- package/dist/job/definition.js +84 -8
- package/dist/job/job.js +109 -39
- package/dist/job/noop.js +104 -0
- package/dist/register/authoring-sources.js +22 -16
- 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 +6 -3
- package/dist/register/planning.js +7 -14
- package/dist/register/register.js +74 -16
- 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 +13 -3
- package/dist/routine/failure.js +30 -0
- package/dist/routine/routine.js +189 -71
- package/dist/routine/status.js +62 -0
- package/dist/routine/storage.js +33 -0
- package/dist/schedule/schedule.js +39 -39
- 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 +7 -0
- package/dist/shared/condense-records.js +25 -0
- package/dist/shared/cross-process-lock.js +9 -1
- package/dist/shared/deprecation.js +8 -0
- package/dist/shared/dist-freshness.js +8 -2
- 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-environment.js +2 -1
- package/dist/shared/git.js +186 -16
- package/dist/shared/grade-result.js +17 -1
- package/dist/shared/lefthook-scaffold.js +3 -0
- package/dist/shared/local-config.js +244 -0
- 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 +73 -41
- package/dist/shared/specdojo-gitignore.js +1 -0
- package/dist/shared/text.js +74 -6
- package/dist/shared/timeline-index.js +2 -0
- package/dist/shared/where-alias.js +13 -0
- package/dist/specdojo.js +4 -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 +12 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
- package/docs/ja/specdojo/guides/exec-config-guide.md +69 -19
- package/docs/ja/specdojo/guides/exec-operation-guide.md +97 -18
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
- package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
- 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 +73 -17
- package/docs/ja/specdojo/guides/register-operation-guide.md +26 -6
- 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 +23 -12
- package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
- package/docs/ja/specdojo/guides/schedule-design-guide.md +27 -21
- 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/guides/waza-guide.md +12 -8
- package/docs/ja/specdojo/recipes/bac-recipe.md +111 -0
- package/docs/ja/specdojo/recipes/bes-recipe.md +141 -0
- package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
- package/docs/ja/specdojo/recipes/br-recipe.md +77 -0
- package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
- package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +92 -99
- package/docs/ja/specdojo/recipes/cnd-recipe.md +135 -0
- package/docs/ja/specdojo/recipes/cpd-recipe.md +140 -0
- package/docs/ja/specdojo/recipes/cxd-recipe.md +162 -0
- package/docs/ja/specdojo/recipes/ifd-recipe.md +145 -0
- package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +112 -90
- package/docs/ja/specdojo/recipes/ifx-index-recipe.md +164 -0
- package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
- package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
- package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -48
- package/docs/ja/specdojo/recipes/pm-plan-recipe.md +72 -50
- package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +40 -49
- package/docs/ja/specdojo/recipes/pm-raci-recipe.md +42 -48
- package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -81
- package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -91
- package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
- package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -156
- package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
- package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
- package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
- package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
- package/docs/ja/specdojo/recipes/stsd-recipe.md +88 -80
- package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +129 -0
- package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +146 -0
- package/docs/ja/specdojo/recipes/sysd-index-recipe.md +141 -0
- package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
- package/docs/ja/specdojo/references/command-reference.md +303 -148
- package/docs/ja/specdojo/references/deliverables-reference.md +30 -16
- package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
- package/docs/ja/specdojo/references/specdojo-config-reference.md +54 -18
- package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
- package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +63 -290
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +162 -80
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +118 -155
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +128 -60
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +70 -94
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +58 -103
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +103 -223
- package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +51 -55
- package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +81 -68
- package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +139 -0
- package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
- package/docs/ja/specdojo/rulebooks/clis-rulebook.md +170 -0
- package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +79 -249
- package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
- package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
- package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +79 -249
- package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +115 -256
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +79 -109
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +119 -174
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +6 -14
- package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
- package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
- package/docs/ja/specdojo/rulebooks/dss-rulebook.md +171 -0
- package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
- package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +93 -57
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +63 -253
- package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +79 -76
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +182 -237
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +111 -40
- package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +23 -46
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +16 -40
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
- package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
- package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
- package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +12 -23
- package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
- package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
- package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
- package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
- package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
- package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
- package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
- package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
- package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
- package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
- package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
- package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
- package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
- package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
- package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
- package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +92 -102
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
- package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
- package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +45 -59
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +56 -66
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +54 -62
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +46 -65
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +65 -97
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +6 -18
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +48 -78
- package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -153
- package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
- package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
- package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
- package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
- package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +106 -32
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +111 -61
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +129 -59
- package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
- package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +46 -40
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +104 -68
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +64 -330
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +70 -263
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +58 -200
- package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -71
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
- package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
- package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
- package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +91 -161
- package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
- package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
- 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 +87 -21
- package/docs/ja/specdojo/samples/bes-index-sample.md +42 -20
- package/docs/ja/specdojo/samples/bes-sample.md +70 -21
- package/docs/ja/specdojo/samples/bps-sample.md +42 -54
- package/docs/ja/specdojo/samples/br-sample.md +57 -15
- package/docs/ja/specdojo/samples/ccd-sample.md +80 -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/cdr-sample.md +78 -0
- package/docs/ja/specdojo/samples/cdsd-sample.md +73 -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 +125 -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/dec-sample.md +2 -3
- 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-api-sample.yaml +0 -2
- 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/ifx-msg-sample.yaml +0 -2
- package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
- package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
- package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
- package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
- package/docs/ja/specdojo/samples/pm-organization-sample.md +42 -21
- package/docs/ja/specdojo/samples/pm-plan-sample.md +78 -26
- package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +41 -22
- package/docs/ja/specdojo/samples/pm-raci-sample.md +63 -28
- package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
- package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +33 -25
- package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
- package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +83 -62
- package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
- package/docs/ja/specdojo/samples/sf-index-sample.md +47 -20
- package/docs/ja/specdojo/samples/sf-sample.md +109 -21
- package/docs/ja/specdojo/samples/sld-sample.md +88 -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 +141 -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/job-definition-standard.md +24 -9
- 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/cdr-template.md +58 -0
- 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 +5 -1
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +95 -8
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +38 -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/job-run.schema.yaml +23 -0
- package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
- 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/sch-strategy.schema.yaml +2 -2
- package/package.json +10 -7
- package/templates/antigravity/orchestrator.md +7 -3
- package/templates/claude/agents/specdojo-orchestrator.md +7 -3
- package/templates/codex/agents/specdojo-orchestrator.toml +7 -3
- package/templates/codex/orchestrator.md +7 -3
- package/templates/devcontainer/tmux.conf +6 -0
- package/templates/init-exec-defaults.yaml +13 -0
- package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +8 -4
|
@@ -1,28 +1,35 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { withPlanConventionsFiles } from "../../shared/plan-conventions.js";
|
|
2
2
|
import { existsSync } from "node:fs";
|
|
3
|
-
import {
|
|
3
|
+
import { specdojoRootDir } from "../../shared/specdojo-config.js";
|
|
4
4
|
import { loadExecDefaultsConfig, providerSlotPoolPath, resolveMaxConcurrency, resolveMaxConcurrentRuns, } from "../agent-config.js";
|
|
5
|
-
import {
|
|
6
|
-
import {
|
|
5
|
+
import { acquireSchedulerLock, buildEvent, claimOwnerOf, foldEventsToState, readAllEventFiles, releaseSchedulerLock, writeEventFile, } from "../events.js";
|
|
6
|
+
import { gradeCheckpointPaths } from "../grade-checkpoint.js";
|
|
7
7
|
import { selectDueDeferredLimitTasks } from "../limit.js";
|
|
8
|
-
import {
|
|
8
|
+
import { parentValidationPoolPath, resolveParentValidationConcurrency, } from "../parent-validation.js";
|
|
9
|
+
import { integratedRepoNames, loadPipelineResumeCheckpoint, } from "../pipeline-state.js";
|
|
10
|
+
import { activateResolvedProjectPaths, resolveProjectPaths } from "../project.js";
|
|
11
|
+
import { loadRegisterResumeCandidates, selectScheduleExecutorResume, } from "../register-resume.js";
|
|
12
|
+
import { readResultFrontmatterSnapshot, updateResultStatus } from "../results.js";
|
|
13
|
+
import { recordPathForRead } from "../run-records.js";
|
|
9
14
|
import { buildInitialStateFromStrategy } from "../schedule/initial.js";
|
|
15
|
+
import { buildScheduleIndex } from "../schedule/schedule.js";
|
|
10
16
|
import { qualifyTaskId } from "../shared.js";
|
|
11
|
-
import {
|
|
12
|
-
import { collectExecLockUsage, execLocksDir, formatExecLockUsage } from "./lock.js";
|
|
17
|
+
import { configuredProductRepos, withProductWorktrees } from "../task-repos.js";
|
|
13
18
|
import { buildTaskView } from "../task-view.js";
|
|
14
|
-
import {
|
|
19
|
+
import { PROJECT_REPO_NAME, mergeInProgress } from "../repo-integration-git.js";
|
|
20
|
+
import { syncTaskWorktreesWithIntegrationTargets, } from "../repo-integration-sync.js";
|
|
15
21
|
import { findExecWorktree, resolveWorktreeBase } from "../worktree.js";
|
|
16
|
-
import {
|
|
17
|
-
import { parentValidationPoolPath, resolveParentValidationConcurrency, } from "../parent-validation.js";
|
|
18
|
-
import { loadPipelineResumeCheckpoint } from "../pipeline-state.js";
|
|
19
|
-
import { loadRegisterResumeCandidates, selectScheduleExecutorResume, } from "../register-resume.js";
|
|
20
|
-
import { buildTaskPhaseMap, configuredWorktreeBase, parseParallel, resolveExecDefaultsPath, withProjectExecRunLock, } from "./shared.js";
|
|
22
|
+
import { currentBranch, isExecBranchMergedIntoCurrent } from "../worktree-ops.js";
|
|
21
23
|
import { loadRosterForExecutionPath, pathInsideWorktree } from "./agent.js";
|
|
24
|
+
import { collectExecLockUsage, execLocksDir, formatExecLockUsage } from "./lock.js";
|
|
25
|
+
import { spawnBlock, spawnIndexBuild, spawnRefresh, spawnValidate, stageActorMeta, } from "./mode-shared.js";
|
|
26
|
+
import { rebuildStaleGeneratedTracksForCycle, resolveClaimingActor, runBatchMode, } from "./schedule-mode.js";
|
|
22
27
|
import { findClaimEventPath, prepareSingleTask, } from "./schedule-prepare.js";
|
|
23
28
|
import { runPreparedTask } from "./schedule-task.js";
|
|
24
|
-
import {
|
|
25
|
-
import {
|
|
29
|
+
import { withTrailingRunRecords } from "./trailing-records.js";
|
|
30
|
+
import { branchOwnedRunRecordPaths } from "../trailing-records.js";
|
|
31
|
+
import { repoRelative } from "../../shared/git.js";
|
|
32
|
+
import { buildTaskPhaseMap, configuredWorktreeBase, parseParallel, resolveExecDefaultsPath, withProjectExecRunLock, } from "./shared.js";
|
|
26
33
|
// 同じ project の exec run が共有する枠(主 run・--join run・register lifecycle・provider の
|
|
27
34
|
// max_concurrency・親検証)の上限と現在の使用数を表示する。ロックは取得しない。
|
|
28
35
|
export function formatExecSlotsReport(executionPath, execDefaults) {
|
|
@@ -58,7 +65,7 @@ export function formatExecSlotsReport(executionPath, execDefaults) {
|
|
|
58
65
|
}
|
|
59
66
|
export function registerSlotsCommand(exec) {
|
|
60
67
|
const cmd = exec
|
|
61
|
-
.command("slots")
|
|
68
|
+
.command("slots", { hidden: true })
|
|
62
69
|
.description("Show the limits and current usage of the slots shared by concurrent exec runs of a project");
|
|
63
70
|
cmd.option("--project <projectId>", "Project id in .specdojo/specdojo.config.json");
|
|
64
71
|
cmd.option("--exec-defaults <path>", "Path to exec-defaults.yaml global config (default: .specdojo/exec-defaults.yaml)");
|
|
@@ -153,7 +160,7 @@ export async function runCycleMode(opts) {
|
|
|
153
160
|
// Step 4/5: validate + refresh schedule state before selecting Ready tasks.
|
|
154
161
|
process.stdout.write("[cycle] step 4/5: validate + refresh schedule state\n");
|
|
155
162
|
if (dryRun) {
|
|
156
|
-
process.stdout.write(" [dry-run] specdojo exec validate\n");
|
|
163
|
+
process.stdout.write(" [dry-run] specdojo exec validate --schedule-only\n");
|
|
157
164
|
process.stdout.write(" [dry-run] specdojo exec refresh\n");
|
|
158
165
|
stepOutcomes.push("refresh=success");
|
|
159
166
|
}
|
|
@@ -231,7 +238,7 @@ export function registerCycleCommand(exec) {
|
|
|
231
238
|
cmd.option("--dry-run", "Print resolved steps without executing", false);
|
|
232
239
|
cmd.action(async (opts) => {
|
|
233
240
|
try {
|
|
234
|
-
await withProjectExecRunLock(opts, "cycle", () => runCycleMode(opts));
|
|
241
|
+
await withProjectExecRunLock(opts, "cycle", () => withTrailingRunRecords(opts, "cycle", () => runCycleMode(opts)));
|
|
235
242
|
}
|
|
236
243
|
catch (error) {
|
|
237
244
|
const message = error instanceof Error ? error.message : String(error);
|
|
@@ -267,23 +274,27 @@ export function prepareScheduleIntegrationResume(params) {
|
|
|
267
274
|
checkpoint.state.stages.reporter.status !== "succeeded") {
|
|
268
275
|
throw new Error(`integration resume requires succeeded executor and reporter stages for ${task.id}`);
|
|
269
276
|
}
|
|
270
|
-
const resultPath =
|
|
277
|
+
const resultPath = recordPathForRead(executionPath, "result", task.id);
|
|
271
278
|
const worktreeResultPath = pathInsideWorktree(repoRoot, worktree.path, resultPath);
|
|
272
279
|
if (!existsSync(resultPath) || !existsSync(worktreeResultPath)) {
|
|
273
280
|
throw new Error(`result is missing for integration resume: ${task.id}-result.md`);
|
|
274
281
|
}
|
|
275
282
|
// 統合再開でも、root に未 commit のまま残る claim / plan / result の作業コピーを merge 前に
|
|
276
283
|
// 解放できるよう、通常実行と同じ checkpoint パスを持たせる。
|
|
277
|
-
const claimEventPath = findClaimEventPath(schedulePath, task.id
|
|
278
|
-
|
|
279
|
-
|
|
284
|
+
const claimEventPath = findClaimEventPath(schedulePath, task.id, {
|
|
285
|
+
repoRoot,
|
|
286
|
+
worktreePath: worktree.path,
|
|
287
|
+
});
|
|
288
|
+
const checkpointPaths = withPlanConventionsFiles([
|
|
289
|
+
recordPathForRead(executionPath, "plan", task.id),
|
|
280
290
|
resultPath,
|
|
281
291
|
...(claimEventPath ? [claimEventPath] : []),
|
|
282
292
|
...gradeCheckpointPaths({ repoRoot, executionPath }),
|
|
283
|
-
];
|
|
293
|
+
]);
|
|
284
294
|
return {
|
|
285
295
|
task,
|
|
286
296
|
actor,
|
|
297
|
+
claimActor: claimOwnerOf(taskState) ?? actor,
|
|
287
298
|
agentCandidates: [],
|
|
288
299
|
plan: "",
|
|
289
300
|
prompt: "",
|
|
@@ -296,6 +307,74 @@ export function prepareScheduleIntegrationResume(params) {
|
|
|
296
307
|
pipelineStateRef: stateRef,
|
|
297
308
|
};
|
|
298
309
|
}
|
|
310
|
+
// 統合の段(reporter の後の commit・検査・merge)まで進んでから止まった run か。
|
|
311
|
+
function stoppedInIntegration(state) {
|
|
312
|
+
return (state.stages.reporter.status === "succeeded" || (state.stages.integrate?.attempts ?? 0) > 0);
|
|
313
|
+
}
|
|
314
|
+
// task 自身の run の記録(repo 相対)。block の後の記帳 commit(PJR-DVNV)が統合先へ入れた
|
|
315
|
+
// 作業コピーは、exec branch 側の同じ記録と両側の追加として競合する。再開の取り込みでは exec branch
|
|
316
|
+
// 側を採る。統合の merge と同じ向きで、再開した executor はこの記録を引き継いで書き直し、後の統合も
|
|
317
|
+
// 統合先の側に変更が無いため競合しない。
|
|
318
|
+
function taskRunRecordPaths(params) {
|
|
319
|
+
const paths = params.branches.flatMap((branch) => branchOwnedRunRecordPaths({ ...params, branch }).map((path) => repoRelative(params.repoRoot, path)));
|
|
320
|
+
return [...new Set(paths)].sort();
|
|
321
|
+
}
|
|
322
|
+
// 統合の段で止まった task を executor へ戻す前の準備(PJR-ED0K)。worktree が merge の途中なら、
|
|
323
|
+
// 解消に `git merge --abort` が要り stage 済みの成果を失うため、状態を変えずに止める。止まって
|
|
324
|
+
// いなければ、統合先(project は root の現在ブランチ)の直しを exec branch へ取り込む。
|
|
325
|
+
// 未 commit の成果と run の記録は取り込みの前に控えて戻し、戻せない場合は取り込み前へ戻して止める。
|
|
326
|
+
export function prepareExecutorResumeFromIntegration(params) {
|
|
327
|
+
const { taskId, worktree, repoRoot } = params;
|
|
328
|
+
const context = {
|
|
329
|
+
repoRoot,
|
|
330
|
+
schedulePath: params.schedulePath,
|
|
331
|
+
executionPath: params.executionPath,
|
|
332
|
+
};
|
|
333
|
+
if (isExecBranchMergedIntoCurrent({ context, worktree })) {
|
|
334
|
+
throw new Error(`cannot resume the executor for ${taskId}: ${worktree.branch} is already merged; ` +
|
|
335
|
+
`run exec resume --task ${taskId} to finish the integration cleanup`);
|
|
336
|
+
}
|
|
337
|
+
const merging = [
|
|
338
|
+
...(worktree.repos ?? [])
|
|
339
|
+
.filter((product) => existsSync(product.path) && mergeInProgress(product.path))
|
|
340
|
+
.map((product) => product.name),
|
|
341
|
+
...(mergeInProgress(worktree.path) ? [PROJECT_REPO_NAME] : []),
|
|
342
|
+
];
|
|
343
|
+
if (merging.length > 0) {
|
|
344
|
+
throw new Error(`cannot resume the executor for ${taskId}: a merge is in progress in ${merging.join(", ")} ` +
|
|
345
|
+
`(${worktree.path}); aborting it would discard staged changes. Commit or resolve the ` +
|
|
346
|
+
`merge in the worktree, then run exec resume --task ${taskId} --resume-from executor again`);
|
|
347
|
+
}
|
|
348
|
+
if (params.dryRun)
|
|
349
|
+
return [];
|
|
350
|
+
process.stdout.write(` Syncing integration targets before executor resume: ${taskId}\n`);
|
|
351
|
+
let synced;
|
|
352
|
+
try {
|
|
353
|
+
const projectTarget = currentBranch(repoRoot);
|
|
354
|
+
synced = syncTaskWorktreesWithIntegrationTargets({
|
|
355
|
+
worktree,
|
|
356
|
+
projectTarget,
|
|
357
|
+
message: `exec(${taskId}): merge integration target before executor resume`,
|
|
358
|
+
projectOursPaths: taskRunRecordPaths({
|
|
359
|
+
repoRoot,
|
|
360
|
+
executionPath: params.executionPath,
|
|
361
|
+
branches: [worktree.branch, projectTarget],
|
|
362
|
+
taskId,
|
|
363
|
+
}),
|
|
364
|
+
integratedProducts: integratedRepoNames(params.state),
|
|
365
|
+
});
|
|
366
|
+
}
|
|
367
|
+
catch (error) {
|
|
368
|
+
throw new Error(`cannot sync the worktree with the integration target before executor resume of ` +
|
|
369
|
+
`${taskId}: ${error instanceof Error ? error.message : String(error)}; ` +
|
|
370
|
+
`resolve it in ${worktree.path} and run exec resume --task ${taskId} --resume-from executor again`, { cause: error });
|
|
371
|
+
}
|
|
372
|
+
for (const entry of synced) {
|
|
373
|
+
process.stdout.write(` [sync] ${entry.repo}: ${entry.status} (${entry.target})` +
|
|
374
|
+
`${entry.detail ? ` — ${entry.detail}` : ""}\n`);
|
|
375
|
+
}
|
|
376
|
+
return synced;
|
|
377
|
+
}
|
|
299
378
|
function validateScheduleResumeOptions(opts) {
|
|
300
379
|
if (opts.resumeFrom !== undefined) {
|
|
301
380
|
if (opts.resumeFrom !== "executor")
|
|
@@ -330,6 +409,10 @@ export async function runResumeMode(opts) {
|
|
|
330
409
|
const events = readAllEventFiles(schedulePath);
|
|
331
410
|
const initTasks = buildInitialStateFromStrategy(schedulePath, schedule);
|
|
332
411
|
let snapshot = foldEventsToState(events, schedule, schedulePath, initTasks);
|
|
412
|
+
const initialTaskStates = new Map(Object.entries(snapshot.tasks).map(([id, state]) => [
|
|
413
|
+
id,
|
|
414
|
+
{ ...state, ...(state.meta ? { meta: { ...state.meta } } : {}) },
|
|
415
|
+
]));
|
|
333
416
|
let doingIds;
|
|
334
417
|
let executorResume;
|
|
335
418
|
let executorWorktree;
|
|
@@ -341,12 +424,14 @@ export async function runResumeMode(opts) {
|
|
|
341
424
|
if (!task.agent_pipeline)
|
|
342
425
|
throw new Error("--resume-from requires an agent_pipeline task.");
|
|
343
426
|
const taskState = snapshot.tasks[opts.task];
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
427
|
+
const blockedStage = taskState?.state === "blocked" ? taskState.meta?.pipeline_stage : undefined;
|
|
428
|
+
// A blocked executor stage is accepted here; selectScheduleExecutorResume admits it only when
|
|
429
|
+
// the runner rejected the executor report before the reporter (PJR-1GCD).
|
|
347
430
|
if (taskState?.state !== "doing" &&
|
|
348
|
-
|
|
349
|
-
|
|
431
|
+
blockedStage !== "reporter" &&
|
|
432
|
+
blockedStage !== "integrate" &&
|
|
433
|
+
blockedStage !== "executor") {
|
|
434
|
+
throw new Error("--resume-from executor requires a doing task or a blocked reporter, integrate, or executor stage.");
|
|
350
435
|
}
|
|
351
436
|
const worktreeTaskId = qualifyTaskId(projectId, opts.task);
|
|
352
437
|
const found = findExecWorktree(repoRoot, worktreeTaskId);
|
|
@@ -364,6 +449,17 @@ export async function runResumeMode(opts) {
|
|
|
364
449
|
throw new Error("no executor stage to resume");
|
|
365
450
|
executorResume = lookup.target;
|
|
366
451
|
executorWorktree = withProductWorktrees(found, configuredProductRepos(schedulePath), worktreeTaskId);
|
|
452
|
+
if (stoppedInIntegration(executorResume.state)) {
|
|
453
|
+
prepareExecutorResumeFromIntegration({
|
|
454
|
+
taskId: opts.task,
|
|
455
|
+
worktree: executorWorktree,
|
|
456
|
+
state: executorResume.state,
|
|
457
|
+
repoRoot,
|
|
458
|
+
schedulePath,
|
|
459
|
+
executionPath,
|
|
460
|
+
dryRun,
|
|
461
|
+
});
|
|
462
|
+
}
|
|
367
463
|
}
|
|
368
464
|
if (opts.due) {
|
|
369
465
|
let lockDir = "";
|
|
@@ -425,7 +521,7 @@ export async function runResumeMode(opts) {
|
|
|
425
521
|
blockedPipelineStage === "integrate") &&
|
|
426
522
|
typeof taskState.meta?.pipeline_state_ref === "string";
|
|
427
523
|
if (canResumeBlockedPipeline) {
|
|
428
|
-
const actor = taskState
|
|
524
|
+
const actor = claimOwnerOf(taskState) ?? opts.by ?? "exec-pipeline-resume";
|
|
429
525
|
if (!dryRun) {
|
|
430
526
|
const resumeMeta = {
|
|
431
527
|
...taskState.meta,
|
|
@@ -447,7 +543,7 @@ export async function runResumeMode(opts) {
|
|
|
447
543
|
: "resume executor from persisted pipeline state",
|
|
448
544
|
meta,
|
|
449
545
|
});
|
|
450
|
-
if (executorResume)
|
|
546
|
+
if (executorResume || opts.executorBy)
|
|
451
547
|
pendingExecutorUnblock = event;
|
|
452
548
|
else
|
|
453
549
|
writeEventFile(schedulePath, event);
|
|
@@ -483,11 +579,12 @@ export async function runResumeMode(opts) {
|
|
|
483
579
|
try {
|
|
484
580
|
const task = buildTaskView(schedulePath, executionPath, taskId);
|
|
485
581
|
const resolved = resolveClaimingActor(snapshot.tasks[taskId], opts.by);
|
|
486
|
-
|
|
582
|
+
// --resume-from executor は統合の段で止まった task でも executor から再実行する。
|
|
583
|
+
const prepared = !executorResume && snapshot.tasks[taskId]?.meta?.pipeline_stage === "integrate"
|
|
487
584
|
? prepareScheduleIntegrationResume({
|
|
488
585
|
task,
|
|
489
586
|
taskState: snapshot.tasks[taskId],
|
|
490
|
-
actor: resolved.actor ?? snapshot.tasks[taskId]
|
|
587
|
+
actor: resolved.actor ?? claimOwnerOf(snapshot.tasks[taskId]) ?? "exec-pipeline-resume",
|
|
491
588
|
projectId,
|
|
492
589
|
repoRoot,
|
|
493
590
|
executionPath,
|
|
@@ -511,9 +608,61 @@ export async function runResumeMode(opts) {
|
|
|
511
608
|
: {}),
|
|
512
609
|
}, opts);
|
|
513
610
|
if (typeof prepared !== "string") {
|
|
514
|
-
|
|
515
|
-
|
|
611
|
+
const priorTaskState = initialTaskStates.get(taskId);
|
|
612
|
+
const previousActor = claimOwnerOf(priorTaskState);
|
|
613
|
+
const resumingExecutorStage = prepared.pipelineResumeStage !== "reporter" &&
|
|
614
|
+
prepared.pipelineResumeStage !== "integrate";
|
|
615
|
+
if (resumingExecutorStage &&
|
|
616
|
+
previousActor &&
|
|
617
|
+
prepared.actor &&
|
|
618
|
+
prepared.actor !== previousActor) {
|
|
619
|
+
if (!dryRun) {
|
|
620
|
+
const releaseEvent = buildEvent("release", {
|
|
621
|
+
task: taskId,
|
|
622
|
+
by: previousActor,
|
|
623
|
+
msg: opts.resumeFrom === "executor"
|
|
624
|
+
? `release claim to switch executor to ${prepared.actor} (--resume-from executor)`
|
|
625
|
+
: `release claim to switch executor to ${prepared.actor}`,
|
|
626
|
+
meta: ["pipeline_resume_released=true", `replaced_by=${prepared.actor}`],
|
|
627
|
+
});
|
|
628
|
+
const resumeMeta = {
|
|
629
|
+
...(priorTaskState?.meta ?? {}),
|
|
630
|
+
...(executorResume
|
|
631
|
+
? { pipeline_stage: "executor", pipeline_state_ref: executorResume.stateRef }
|
|
632
|
+
: {}),
|
|
633
|
+
pipeline_resume_claimed: "true",
|
|
634
|
+
previous_actor: previousActor,
|
|
635
|
+
};
|
|
636
|
+
const meta = Object.entries(resumeMeta).map(([key, value]) => `${key}=${String(value)}`);
|
|
637
|
+
const claimEvent = buildEvent("claim", {
|
|
638
|
+
task: taskId,
|
|
639
|
+
by: prepared.actor,
|
|
640
|
+
msg: opts.resumeFrom === "executor"
|
|
641
|
+
? `claim task as resumed executor ${prepared.actor} (--resume-from executor)`
|
|
642
|
+
: `claim task as resumed executor ${prepared.actor}`,
|
|
643
|
+
meta,
|
|
644
|
+
});
|
|
645
|
+
writeEventFile(schedulePath, releaseEvent);
|
|
646
|
+
writeEventFile(schedulePath, claimEvent);
|
|
647
|
+
}
|
|
516
648
|
pendingExecutorUnblock = undefined;
|
|
649
|
+
snapshot.tasks[taskId] = {
|
|
650
|
+
...snapshot.tasks[taskId],
|
|
651
|
+
state: "doing",
|
|
652
|
+
last_by: prepared.actor,
|
|
653
|
+
claimed_by: prepared.actor,
|
|
654
|
+
last_type: "claim",
|
|
655
|
+
};
|
|
656
|
+
prepared.claimActor = prepared.actor;
|
|
657
|
+
}
|
|
658
|
+
else {
|
|
659
|
+
if (pendingExecutorUnblock) {
|
|
660
|
+
if (!dryRun)
|
|
661
|
+
writeEventFile(schedulePath, pendingExecutorUnblock);
|
|
662
|
+
pendingExecutorUnblock = undefined;
|
|
663
|
+
}
|
|
664
|
+
// The claim stays with its holder when --by or a stage override runs another agent.
|
|
665
|
+
prepared.claimActor = snapshot.tasks[taskId]?.last_by ?? prepared.claimActor;
|
|
517
666
|
}
|
|
518
667
|
const attempts = snapshot.tasks[taskId]?.meta?.limit_attempts;
|
|
519
668
|
prepared.priorLimitAttempts =
|
|
@@ -529,7 +678,7 @@ export async function runResumeMode(opts) {
|
|
|
529
678
|
const message = error instanceof Error ? error.message : String(error);
|
|
530
679
|
process.stderr.write(`[resume] setup error for ${taskId}: ${message}\n`);
|
|
531
680
|
if (opts.due && !dryRun) {
|
|
532
|
-
spawnBlock(projectId, taskId, snapshot.tasks[taskId]
|
|
681
|
+
spawnBlock(projectId, taskId, claimOwnerOf(snapshot.tasks[taskId]) ?? "exec-limit-resume", `resume setup error: ${message}`);
|
|
533
682
|
}
|
|
534
683
|
process.exitCode = 1;
|
|
535
684
|
}
|
|
@@ -546,7 +695,10 @@ export async function runResumeMode(opts) {
|
|
|
546
695
|
const completedAt = new Date().toISOString();
|
|
547
696
|
if (prepared.resultPath)
|
|
548
697
|
await updateResultStatus(prepared.resultPath, "blocked", completedAt);
|
|
549
|
-
spawnBlock(projectId, prepared.task.id, prepared.
|
|
698
|
+
spawnBlock(projectId, prepared.task.id, prepared.claimActor, `runner error: ${message}`, {
|
|
699
|
+
limit_deferred: "false",
|
|
700
|
+
...stageActorMeta(prepared.claimActor, prepared.actor),
|
|
701
|
+
});
|
|
550
702
|
}
|
|
551
703
|
process.exitCode = 1;
|
|
552
704
|
}
|
|
@@ -590,7 +742,7 @@ export function registerResumeCommand(exec) {
|
|
|
590
742
|
process.exitCode = 1;
|
|
591
743
|
return;
|
|
592
744
|
}
|
|
593
|
-
await withProjectExecRunLock(opts, "resume", () => runResumeMode(opts));
|
|
745
|
+
await withProjectExecRunLock(opts, "resume", () => withTrailingRunRecords(opts, "resume", () => runResumeMode(opts)));
|
|
594
746
|
}
|
|
595
747
|
catch (error) {
|
|
596
748
|
const message = error instanceof Error ? error.message : String(error);
|
package/dist/exec/run/lock.js
CHANGED
|
@@ -17,6 +17,15 @@ export class ExecRunBusyError extends Error {
|
|
|
17
17
|
this.name = "ExecRunBusyError";
|
|
18
18
|
}
|
|
19
19
|
}
|
|
20
|
+
export class ExecRunLockTimeoutError extends ExecRunBusyError {
|
|
21
|
+
waitTimeoutMs;
|
|
22
|
+
constructor(lockDir, owner, waitTimeoutMs) {
|
|
23
|
+
super(lockDir, owner);
|
|
24
|
+
this.waitTimeoutMs = waitTimeoutMs;
|
|
25
|
+
this.name = "ExecRunLockTimeoutError";
|
|
26
|
+
this.message = `Exec lock wait timed out after ${waitTimeoutMs} ms.\n${this.message}`;
|
|
27
|
+
}
|
|
28
|
+
}
|
|
20
29
|
export function execLocksDir(executionPath) {
|
|
21
30
|
return join(executionPath, "exec", ".locks");
|
|
22
31
|
}
|
|
@@ -81,7 +90,16 @@ export async function acquireExecRunLock(executionPath, opts) {
|
|
|
81
90
|
const staleMs = opts.staleMs ?? EXEC_RUN_LOCK_STALE_MS;
|
|
82
91
|
const pollMs = opts.pollMs ?? LOCK_POLL_MS;
|
|
83
92
|
let waitingAnnounced = false;
|
|
93
|
+
if (opts.waitTimeoutMs !== undefined &&
|
|
94
|
+
(!Number.isFinite(opts.waitTimeoutMs) || opts.waitTimeoutMs < 0))
|
|
95
|
+
throw new Error("waitTimeoutMs must be a finite non-negative number");
|
|
96
|
+
const deadline = opts.waitTimeoutMs === undefined ? Infinity : Date.now() + opts.waitTimeoutMs;
|
|
97
|
+
let firstAttempt = true;
|
|
84
98
|
while (true) {
|
|
99
|
+
if (!firstAttempt && opts.ifBusy === "wait" && Date.now() >= deadline) {
|
|
100
|
+
throw new ExecRunLockTimeoutError(execRunLockPath(executionPath), describeHolders(executionPath, staleMs), opts.waitTimeoutMs);
|
|
101
|
+
}
|
|
102
|
+
firstAttempt = false;
|
|
85
103
|
const handle = opts.join
|
|
86
104
|
? tryAcquireJoin(executionPath, opts, opts.join.limit, staleMs)
|
|
87
105
|
: tryAcquireExclusive(executionPath, opts, staleMs);
|
|
@@ -96,7 +114,10 @@ export async function acquireExecRunLock(executionPath, opts) {
|
|
|
96
114
|
opts.onWait?.();
|
|
97
115
|
waitingAnnounced = true;
|
|
98
116
|
}
|
|
99
|
-
|
|
117
|
+
if (Date.now() >= deadline) {
|
|
118
|
+
throw new ExecRunLockTimeoutError(execRunLockPath(executionPath), describeHolders(executionPath, staleMs), opts.waitTimeoutMs);
|
|
119
|
+
}
|
|
120
|
+
await delay(Math.min(pollMs, Math.max(0, deadline - Date.now())));
|
|
100
121
|
}
|
|
101
122
|
}
|
|
102
123
|
export function releaseExecRunLock(handle) {
|
|
@@ -1,16 +1,19 @@
|
|
|
1
1
|
import { spawnSync } from "node:child_process";
|
|
2
2
|
import { existsSync } from "node:fs";
|
|
3
|
-
import {
|
|
3
|
+
import { relative, sep } from "node:path";
|
|
4
4
|
import { selfRunArgs } from "../../shared/spawn-self.js";
|
|
5
5
|
import { specdojoRootDir } from "../../shared/specdojo-config.js";
|
|
6
6
|
import { readPipelineState, updatePipelineRepoIntegration, updatePipelineStage, writePipelineState, } from "../pipeline-state.js";
|
|
7
|
+
import { runLogPath } from "../run-records.js";
|
|
7
8
|
export function spawnSelf(args, cwd = specdojoRootDir()) {
|
|
8
9
|
const [exe, fullArgs] = selfRunArgs(args);
|
|
9
10
|
const result = spawnSync(exe, fullArgs, { stdio: "inherit", cwd });
|
|
10
11
|
return result.status === 0;
|
|
11
12
|
}
|
|
12
13
|
export function spawnValidate(projectId) {
|
|
13
|
-
|
|
14
|
+
// Run records can still be incomplete at startup or resume, and the run lock is held.
|
|
15
|
+
// Audit persisted records explicitly or in CI, independently of schedule readiness.
|
|
16
|
+
const args = ["exec", "validate", "--schedule-only"];
|
|
14
17
|
if (projectId)
|
|
15
18
|
args.push("--project", projectId);
|
|
16
19
|
return spawnSelf(args);
|
|
@@ -82,6 +85,11 @@ export function pipelineRecoveryMeta(input) {
|
|
|
82
85
|
...(input.runId ? { pipeline_run_id: input.runId } : {}),
|
|
83
86
|
};
|
|
84
87
|
}
|
|
88
|
+
// The runner blocks a failed task as the actor holding its claim, because another agent may have
|
|
89
|
+
// run the failed stage (fallback, --executor-by, --reporter-by). Record both actors on the event.
|
|
90
|
+
export function stageActorMeta(claimActor, stageActor) {
|
|
91
|
+
return { claim_actor: claimActor, stage_actor: stageActor || claimActor };
|
|
92
|
+
}
|
|
85
93
|
export function spawnBlock(projectId, taskId, by, reason, meta = { limit_deferred: "false" }) {
|
|
86
94
|
const args = ["exec", "block", "--task", taskId, "--by", by, "--msg", reason];
|
|
87
95
|
for (const [key, value] of Object.entries(meta))
|
|
@@ -136,5 +144,5 @@ export function recordRepoIntegration(statePath, repo, patch) {
|
|
|
136
144
|
}
|
|
137
145
|
}
|
|
138
146
|
export function integrateLogPath(statePath) {
|
|
139
|
-
return statePath ?
|
|
147
|
+
return statePath ? runLogPath(statePath, "integrate.log") : undefined;
|
|
140
148
|
}
|
|
@@ -1,15 +1,17 @@
|
|
|
1
|
-
import { parseProductBranchOverrides } from "../product-branches.js";
|
|
2
1
|
import { loadExecDefaultsConfig, resolveRegisterPostReview } from "../agent-config.js";
|
|
2
|
+
import { parseProductBranchOverrides } from "../product-branches.js";
|
|
3
3
|
import { resolveProjectPaths } from "../project.js";
|
|
4
4
|
import { isRegisterFailureMode } from "../register.js";
|
|
5
5
|
import { configuredProductRepos } from "../task-repos.js";
|
|
6
|
-
import { EXCLUSIVE_EXEC_RUN, parseParallel, resolveExecDefaultsPath, resolveRegisterWorktree, withProjectExecRunLock, } from "./shared.js";
|
|
7
|
-
import { runBatchMode, runManualMode } from "./schedule-mode.js";
|
|
8
6
|
import { runInPlaceMode } from "./in-place.js";
|
|
9
|
-
import {
|
|
7
|
+
import { runJobWithProjectLock } from "./job-lock.js";
|
|
10
8
|
import { spawnRefresh, spawnValidate } from "./mode-shared.js";
|
|
11
9
|
import { resolveRegisterPipelineCommand } from "./register-core.js";
|
|
12
10
|
import { runRegisterMode } from "./register-mode.js";
|
|
11
|
+
import { runBatchMode, runManualMode } from "./schedule-mode.js";
|
|
12
|
+
import { EXCLUSIVE_EXEC_RUN, parseParallel, resolveExecDefaultsPath, resolveRegisterWorktree, withProjectExecRunLock, } from "./shared.js";
|
|
13
|
+
import { withTrailingRunRecords } from "./trailing-records.js";
|
|
14
|
+
import { parseUnknownScopePolicy } from "./change-scope.js";
|
|
13
15
|
export function registerRunCommand(exec) {
|
|
14
16
|
const rcmd = exec
|
|
15
17
|
.command("run")
|
|
@@ -40,10 +42,11 @@ export function registerRunCommand(exec) {
|
|
|
40
42
|
rcmd.option("--worktree", "Use a git worktree and integrate back (requires --task, --register, or --job; Job runs are committed and reviewed before merge)", false);
|
|
41
43
|
rcmd.option("--in-place", "Run a register item in the current working tree (overrides run.register_execution; cannot be combined with --worktree)", false);
|
|
42
44
|
rcmd.option("--track-state", "Record claim/complete events (requires --task; --by optional, actor auto-derived from the resolved agent)", false);
|
|
43
|
-
rcmd.option("--archive-on-success", "
|
|
45
|
+
rcmd.option("--archive-on-success", "Keep the completed plan in its run directory after a successful in-place run", false);
|
|
44
46
|
rcmd.option("--integration-branch <repo=branch>", "With register worktree mode: integrate the declared product repository <repo> into the local branch <branch> for this run (repeatable; overrides repos[].integration_branch; resume reuses the value recorded at the start)", (value, previous = []) => [...previous, value]);
|
|
45
47
|
rcmd.option("--branch <repo=name>", "With register worktree mode: override a declared product work branch (repeatable; resume keeps the recorded branch)", (value, previous = []) => [...previous, value]);
|
|
46
48
|
rcmd.option("--parallel <n>", "Number of worktree instances to run in parallel", "1");
|
|
49
|
+
rcmd.option("--unknown-scope <policy>", "Items with an unknown change scope: parallel|serialize (default: parallel)");
|
|
47
50
|
rcmd.option("--worktree-base <path>", "Override worktree base directory");
|
|
48
51
|
rcmd.option("--strategy <s>", "Task selection strategy: critical-first|fifo (default: critical-first)");
|
|
49
52
|
rcmd.option("--loop", "Repeat rounds until no ready tasks remain, rebuilding doc-index and running exec refresh between rounds", false);
|
|
@@ -62,6 +65,7 @@ export function registerRunCommand(exec) {
|
|
|
62
65
|
rcmd.option("--dry-run", "Print resolved command without executing", false);
|
|
63
66
|
rcmd.action(async (opts) => {
|
|
64
67
|
try {
|
|
68
|
+
parseUnknownScopePolicy(opts.unknownScope);
|
|
65
69
|
const isAuto = !!opts.auto;
|
|
66
70
|
const hasTask = !!opts.task;
|
|
67
71
|
const hasDeliverable = !!opts.deliverable;
|
|
@@ -245,6 +249,10 @@ export function registerRunCommand(exec) {
|
|
|
245
249
|
}
|
|
246
250
|
// register worktree 実行だけが共有資源をプロセス横断で統制するため、後から --join する
|
|
247
251
|
// run を受け入れる。それ以外の run は従来どおり project 全体を排他する。
|
|
252
|
+
if (hasJob) {
|
|
253
|
+
await runJobWithProjectLock(opts, resolveRegisterPipelineCommand);
|
|
254
|
+
return;
|
|
255
|
+
}
|
|
248
256
|
const registerWorktreeLockSharing = hasRegister && opts.worktree ? { shareable: true, join: !!opts.join } : EXCLUSIVE_EXEC_RUN;
|
|
249
257
|
await withProjectExecRunLock(opts, "run", async () => {
|
|
250
258
|
// Register-item run: use the configured location or an explicit CLI override, with state tracked
|
|
@@ -253,10 +261,6 @@ export function registerRunCommand(exec) {
|
|
|
253
261
|
await runRegisterMode(opts);
|
|
254
262
|
return;
|
|
255
263
|
}
|
|
256
|
-
if (hasJob) {
|
|
257
|
-
await runJobMode(opts, resolveRegisterPipelineCommand);
|
|
258
|
-
return;
|
|
259
|
-
}
|
|
260
264
|
// In-place manual run (default): generate the plan on demand and run in the
|
|
261
265
|
// current repository. No validate/refresh pass — that is orchestration only.
|
|
262
266
|
if (isManual && !opts.worktree) {
|
|
@@ -276,12 +280,7 @@ export function registerRunCommand(exec) {
|
|
|
276
280
|
return;
|
|
277
281
|
}
|
|
278
282
|
process.stdout.write("[run] refresh: ok\n");
|
|
279
|
-
|
|
280
|
-
await runBatchMode(opts);
|
|
281
|
-
}
|
|
282
|
-
else {
|
|
283
|
-
await runManualMode(opts);
|
|
284
|
-
}
|
|
283
|
+
await withTrailingRunRecords(opts, "run", () => isBatch ? runBatchMode(opts) : runManualMode(opts));
|
|
285
284
|
}, registerWorktreeLockSharing);
|
|
286
285
|
}
|
|
287
286
|
catch (error) {
|
|
@@ -1,22 +1,25 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { readPlanFile } from "../../shared/plan-conventions.js";
|
|
2
2
|
import { existsSync, readFileSync } from "node:fs";
|
|
3
|
-
import { basename } from "node:path";
|
|
4
|
-
import {
|
|
3
|
+
import { basename, dirname } from "node:path";
|
|
4
|
+
import { isAuthoringApproach } from "../../kata/authoring.js";
|
|
5
|
+
import { registerDependencyBlockReason } from "../../register/dependency.js";
|
|
6
|
+
import { registerEventFilePath } from "../../register/events.js";
|
|
7
|
+
import { displayIdFromTicketFilename } from "../../register/item.js";
|
|
5
8
|
import { resolveAgentMember, } from "../../shared/specdojo-config.js";
|
|
9
|
+
import { resolveMemberCommand, } from "../agent-config.js";
|
|
6
10
|
import { buildInPlaceStem } from "../plans.js";
|
|
7
11
|
import { generateRegisterPlan, normalizePjrId, requireRunnableRegisterItem, resolveRegisterRunTarget, sanitizeRegisterConclusion, selectRegisterCommitPaths, selectRegisterRunArtifactResidue, ticketPathFromItem, } from "../register.js";
|
|
8
|
-
import { registerEventFilePath } from "../../register/events.js";
|
|
9
|
-
import { displayIdFromTicketFilename } from "../../register/item.js";
|
|
10
12
|
import { isResultUnfilled, readResultFrontmatterSnapshot, scaffoldResult, updateResultStatus, } from "../results.js";
|
|
11
|
-
import {
|
|
13
|
+
import { recordRef } from "../run-records.js";
|
|
14
|
+
import { configuredProductCheckouts } from "../task-repos.js";
|
|
12
15
|
import { stabilizeCommitTargets, stageCommitTargets, unstageCommitTargets, worktreeStatusPaths, } from "../worktree-ops.js";
|
|
13
|
-
import {
|
|
14
|
-
import { expandPromptRefs } from "./agent.js";
|
|
16
|
+
import { formatGitResultFailure, gitOutput, gitResult } from "../worktree.js";
|
|
15
17
|
import { runAgentPipeline } from "./agent-pipeline.js";
|
|
18
|
+
import { expandPromptRefs } from "./agent.js";
|
|
19
|
+
import { planConventionsFiles } from "../../shared/plan-conventions.js";
|
|
16
20
|
import { spawnAgentInPlace } from "./in-place.js";
|
|
17
21
|
import { commitSubject, repoRelativePath, spawnSelf } from "./mode-shared.js";
|
|
18
|
-
import {
|
|
19
|
-
import { configuredProductCheckouts } from "../task-repos.js";
|
|
22
|
+
import { rateLimitRecoveryReason, resolveAgentOverride, resolvePinnedRateLimitRunOptions, selectCandidates, } from "./shared.js";
|
|
20
23
|
// CLI choices are the highest-priority layer. A difficulty route only supplies omitted stage and
|
|
21
24
|
// recovery options; without a matching route the historical priority-based selection is kept.
|
|
22
25
|
export function applyRegisterDifficultyRouting(item, opts, execDefaults) {
|
|
@@ -214,7 +217,10 @@ export function registerRunnerManagedPaths(repoRoot, registerPaths, planPath, re
|
|
|
214
217
|
// 状態遷移の書き込み先は個票(正本)。pjr-index と派生ビューは生成物として同時に更新される。
|
|
215
218
|
// 移行完了後の pjr-index.md は非追跡の生成物になり存在しないため、存在する場合のみ対象に含める
|
|
216
219
|
// (存在しないパスを git add すると pathspec エラーになる)。
|
|
217
|
-
const
|
|
220
|
+
const versions = existsSync(planPath)
|
|
221
|
+
? planConventionsFiles(readFileSync(planPath, "utf8"), dirname(planPath))
|
|
222
|
+
: [];
|
|
223
|
+
const managed = [planPath, resultPath, ...versions, ...additionalManagedPaths];
|
|
218
224
|
if (existsSync(registerPaths.pjrIndexPath))
|
|
219
225
|
managed.push(registerPaths.pjrIndexPath);
|
|
220
226
|
if (ticketPath)
|
|
@@ -289,14 +295,14 @@ export async function runSingleRegisterItem(context, opts, pjrId) {
|
|
|
289
295
|
item,
|
|
290
296
|
stem,
|
|
291
297
|
});
|
|
292
|
-
const prompt = expandPromptRefs(
|
|
298
|
+
const prompt = expandPromptRefs(readPlanFile(planPath));
|
|
293
299
|
const { resultPath, supersededPaths } = await scaffoldResult({
|
|
294
300
|
executionPath,
|
|
295
301
|
taskId: item.id,
|
|
296
302
|
mode: "edit",
|
|
297
303
|
projectId,
|
|
298
304
|
origin: "register",
|
|
299
|
-
planRef:
|
|
305
|
+
planRef: recordRef(executionPath, planPath),
|
|
300
306
|
agent: actor,
|
|
301
307
|
startedAt: new Date().toISOString(),
|
|
302
308
|
stem,
|
|
@@ -328,6 +334,7 @@ export async function runSingleRegisterItem(context, opts, pjrId) {
|
|
|
328
334
|
executor: pipelineAgents.executor,
|
|
329
335
|
reporterCandidates: pipelineAgents.reporterCandidates,
|
|
330
336
|
planPath,
|
|
337
|
+
runId: stem,
|
|
331
338
|
planPrompt: prompt,
|
|
332
339
|
resultPath,
|
|
333
340
|
registerPaths: registerReporterManagedPaths(registerPaths),
|