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
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
import { join } from "node:path";
|
|
2
|
+
import { mkdirSync } from "node:fs";
|
|
3
|
+
import { isJobCommandTask, loadJobDefinition, materializeJobRun, resolveJobPaths, } from "../../job/job.js";
|
|
4
|
+
import { resolveProjectPaths } from "../project.js";
|
|
5
|
+
import { releaseLock, tryAcquireLock } from "../slot-lock.js";
|
|
6
|
+
import { runJobMode } from "./job.js";
|
|
7
|
+
import { execLocksDir, ExecRunLockTimeoutError, inheritsExecRunLock } from "./lock.js";
|
|
8
|
+
import { withProjectExecRunLock } from "./shared.js";
|
|
9
|
+
/** A sequence waits for exclusive access, including when invoked by routine/cron. */
|
|
10
|
+
export async function runJobWithProjectLock(opts, resolver) {
|
|
11
|
+
const paths = resolveProjectPaths({ project: opts.project });
|
|
12
|
+
const definition = loadJobDefinition(resolveJobPaths(paths.projectId ?? opts.project), String(opts.job));
|
|
13
|
+
if (!isJobCommandTask(definition.task) || !definition.task.steps) {
|
|
14
|
+
await withProjectExecRunLock(opts, "run", () => runJobMode(opts, resolver));
|
|
15
|
+
return;
|
|
16
|
+
}
|
|
17
|
+
if (opts.dryRun) {
|
|
18
|
+
await runJobMode(opts, resolver);
|
|
19
|
+
return;
|
|
20
|
+
}
|
|
21
|
+
if (inheritsExecRunLock(paths.executionPath)) {
|
|
22
|
+
await withProjectExecRunLock(opts, "run", () => runJobMode(opts, resolver));
|
|
23
|
+
return;
|
|
24
|
+
}
|
|
25
|
+
const preview = await materializeJobRun({
|
|
26
|
+
projectId: paths.projectId ?? opts.project,
|
|
27
|
+
jobId: String(opts.job),
|
|
28
|
+
inputs: opts.input,
|
|
29
|
+
scheduledAt: opts.scheduledAt,
|
|
30
|
+
dryRun: true,
|
|
31
|
+
});
|
|
32
|
+
// Guard the logical Run while waiting too. A duplicate caller must not overwrite a
|
|
33
|
+
// running attempt with a timeout result. Different Runs still queue on the project lock.
|
|
34
|
+
mkdirSync(execLocksDir(paths.executionPath), { recursive: true });
|
|
35
|
+
const guard = tryAcquireLock(join(execLocksDir(paths.executionPath), `${preview.record.run_id}.sequence.lock`), { actor: "job-sequence" });
|
|
36
|
+
if (!guard)
|
|
37
|
+
throw new Error(`Job sequence already running: ${preview.record.run_id}`);
|
|
38
|
+
const frozenOpts = { ...opts, scheduledAt: preview.record.scheduled_at };
|
|
39
|
+
const waitSeconds = isJobCommandTask(preview.record.task)
|
|
40
|
+
? (preview.record.task.lock_wait_seconds ?? 3600)
|
|
41
|
+
: 3600;
|
|
42
|
+
try {
|
|
43
|
+
if (preview.duplicateComplete) {
|
|
44
|
+
await runJobMode(frozenOpts, resolver);
|
|
45
|
+
return;
|
|
46
|
+
}
|
|
47
|
+
try {
|
|
48
|
+
await withProjectExecRunLock({
|
|
49
|
+
...frozenOpts,
|
|
50
|
+
ifBusy: "wait",
|
|
51
|
+
lockWaitMs: waitSeconds * 1000,
|
|
52
|
+
}, "run", () => runJobMode(frozenOpts, resolver));
|
|
53
|
+
}
|
|
54
|
+
catch (error) {
|
|
55
|
+
if (!(error instanceof ExecRunLockTimeoutError))
|
|
56
|
+
throw error;
|
|
57
|
+
await runJobMode({
|
|
58
|
+
...frozenOpts,
|
|
59
|
+
sequenceDeferredReason: `project lock wait timed out after ${waitSeconds} seconds`,
|
|
60
|
+
}, resolver);
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
finally {
|
|
64
|
+
releaseLock(guard);
|
|
65
|
+
}
|
|
66
|
+
}
|
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
import { readFileSync } from "node:fs";
|
|
2
|
+
import { isAbsolute, relative, resolve, sep } from "node:path";
|
|
3
|
+
import { load } from "../../shared/yaml.js";
|
|
4
|
+
import { executeJobCommand, jobCommandText, recordJobSteps, } from "../../job/job.js";
|
|
5
|
+
import { recordCommandEvidence } from "../evidence.js";
|
|
6
|
+
function completionState(task, cwd) {
|
|
7
|
+
if (!task.completion)
|
|
8
|
+
return { status: "succeeded", reason: "command exited 0" };
|
|
9
|
+
const rule = task.completion;
|
|
10
|
+
const path = resolve(cwd, rule.path);
|
|
11
|
+
const rel = relative(cwd, path);
|
|
12
|
+
if (isAbsolute(rule.path) || rel === ".." || rel.startsWith(`..${sep}`))
|
|
13
|
+
return { status: "failed", reason: "completion.path must stay inside the repository" };
|
|
14
|
+
try {
|
|
15
|
+
const text = readFileSync(path, "utf8");
|
|
16
|
+
const frontmatter = text.match(/^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/)?.[1];
|
|
17
|
+
const document = path.endsWith(".json") ? JSON.parse(text) : load(frontmatter ?? text);
|
|
18
|
+
let value = document;
|
|
19
|
+
for (const field of rule.field.split(".")) {
|
|
20
|
+
value =
|
|
21
|
+
typeof value === "object" && value !== null && Object.hasOwn(value, field)
|
|
22
|
+
? value[field]
|
|
23
|
+
: undefined;
|
|
24
|
+
}
|
|
25
|
+
if (typeof value === "string" && rule.succeeded.includes(value))
|
|
26
|
+
return { status: "succeeded", reason: "exit 0 and completion state accepted" };
|
|
27
|
+
if (typeof value === "string" && rule.deferred?.includes(value))
|
|
28
|
+
return { status: "deferred", reason: "completion state requires a later retry" };
|
|
29
|
+
return { status: "failed", reason: "completion state missing or not accepted" };
|
|
30
|
+
}
|
|
31
|
+
catch {
|
|
32
|
+
return { status: "failed", reason: "completion state file unavailable or invalid" };
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
/** Runs frozen commands serially. Logs are evidence only, never a completion protocol. */
|
|
36
|
+
export async function executeJobSequence(params) {
|
|
37
|
+
const { task, runId, runPath, cwd, executionPath, deferredReason } = params;
|
|
38
|
+
const startedAt = new Date().toISOString();
|
|
39
|
+
const steps = (task.steps ?? []).map(({ id }) => ({
|
|
40
|
+
id,
|
|
41
|
+
status: "deferred",
|
|
42
|
+
reason: deferredReason ?? "preceding step has not completed",
|
|
43
|
+
}));
|
|
44
|
+
recordJobSteps(runPath, steps);
|
|
45
|
+
if (!deferredReason) {
|
|
46
|
+
for (const [index, step] of (task.steps ?? []).entries()) {
|
|
47
|
+
steps[index] = { id: step.id, status: "running", started_at: new Date().toISOString() };
|
|
48
|
+
recordJobSteps(runPath, steps);
|
|
49
|
+
let outcome;
|
|
50
|
+
try {
|
|
51
|
+
outcome = await executeJobCommand(step.command, cwd, step.timeout_seconds === undefined ? {} : { timeoutMs: step.timeout_seconds * 1000 });
|
|
52
|
+
}
|
|
53
|
+
catch {
|
|
54
|
+
steps[index] = {
|
|
55
|
+
...steps[index],
|
|
56
|
+
status: "failed",
|
|
57
|
+
completed_at: new Date().toISOString(),
|
|
58
|
+
reason: "command execution threw",
|
|
59
|
+
};
|
|
60
|
+
recordJobSteps(runPath, steps);
|
|
61
|
+
if (step.on_failure !== "continue")
|
|
62
|
+
break;
|
|
63
|
+
continue;
|
|
64
|
+
}
|
|
65
|
+
const verdict = outcome.timedOut
|
|
66
|
+
? {
|
|
67
|
+
status: "deferred",
|
|
68
|
+
reason: `command exceeded ${step.timeout_seconds} seconds`,
|
|
69
|
+
}
|
|
70
|
+
: outcome.error
|
|
71
|
+
? { status: "failed", reason: "command could not be executed" }
|
|
72
|
+
: outcome.exitCode === 75
|
|
73
|
+
? {
|
|
74
|
+
status: "deferred",
|
|
75
|
+
reason: "command exited 75 (temporary unavailability)",
|
|
76
|
+
}
|
|
77
|
+
: outcome.exitCode !== 0
|
|
78
|
+
? {
|
|
79
|
+
status: "failed",
|
|
80
|
+
reason: `command exited ${outcome.exitCode ?? "by signal"}`,
|
|
81
|
+
}
|
|
82
|
+
: completionState(step, cwd);
|
|
83
|
+
steps[index] = {
|
|
84
|
+
id: step.id,
|
|
85
|
+
...verdict,
|
|
86
|
+
started_at: outcome.startedAt,
|
|
87
|
+
completed_at: outcome.completedAt,
|
|
88
|
+
exit_code: outcome.exitCode,
|
|
89
|
+
};
|
|
90
|
+
recordJobSteps(runPath, steps);
|
|
91
|
+
const evidence = recordCommandEvidence({
|
|
92
|
+
repoRoot: cwd,
|
|
93
|
+
worktreePath: cwd,
|
|
94
|
+
executionPath,
|
|
95
|
+
taskId: runId,
|
|
96
|
+
runId: `${runId}-attempt-${params.attempt}-step-${step.id}`,
|
|
97
|
+
actor: "specdojo-runner",
|
|
98
|
+
command: step.command,
|
|
99
|
+
shell: process.platform === "win32" ? process.env.ComSpec || "cmd.exe" : "/bin/sh -eu",
|
|
100
|
+
startedAt: outcome.startedAt,
|
|
101
|
+
completedAt: outcome.completedAt,
|
|
102
|
+
exitCode: outcome.exitCode,
|
|
103
|
+
stdout: outcome.stdout,
|
|
104
|
+
stderr: outcome.stderr,
|
|
105
|
+
stdoutTruncated: outcome.stdoutTruncated,
|
|
106
|
+
stderrTruncated: outcome.stderrTruncated,
|
|
107
|
+
...(outcome.error ? { error: outcome.error } : {}),
|
|
108
|
+
});
|
|
109
|
+
steps[index] = {
|
|
110
|
+
id: step.id,
|
|
111
|
+
...verdict,
|
|
112
|
+
started_at: outcome.startedAt,
|
|
113
|
+
completed_at: outcome.completedAt,
|
|
114
|
+
exit_code: outcome.exitCode,
|
|
115
|
+
evidence_ref: relative(cwd, evidence.evidencePath).split(sep).join("/"),
|
|
116
|
+
};
|
|
117
|
+
recordJobSteps(runPath, steps);
|
|
118
|
+
if (verdict.status !== "succeeded" && step.on_failure !== "continue")
|
|
119
|
+
break;
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
const failed = steps.some((step) => step.status === "failed");
|
|
123
|
+
const deferred = steps.some((step) => step.status === "deferred");
|
|
124
|
+
return {
|
|
125
|
+
command: jobCommandText(task),
|
|
126
|
+
startedAt,
|
|
127
|
+
completedAt: new Date().toISOString(),
|
|
128
|
+
exitCode: failed ? 1 : deferred ? 75 : 0,
|
|
129
|
+
stdout: JSON.stringify({ steps }),
|
|
130
|
+
stderr: "",
|
|
131
|
+
stdoutTruncated: false,
|
|
132
|
+
stderrTruncated: false,
|
|
133
|
+
...(failed || deferred
|
|
134
|
+
? { reason: deferredReason ?? "sequence contains failed or deferred steps" }
|
|
135
|
+
: {}),
|
|
136
|
+
};
|
|
137
|
+
}
|
package/dist/exec/run/job.js
CHANGED
|
@@ -1,23 +1,28 @@
|
|
|
1
|
+
import { readPlanFile } from "../../shared/plan-conventions.js";
|
|
1
2
|
import { spawnSync } from "node:child_process";
|
|
2
3
|
import { existsSync, readFileSync, writeFileSync } from "node:fs";
|
|
3
4
|
import { relative, resolve, sep } from "node:path";
|
|
5
|
+
import { completeJobRun, executeJobCommand, generateJobReviewPlan, isJobCommandTask, jobCommandText, jobRunUsesReviewedIntegration, loadJobDefinition, loadJobRunRecord, materializeJobRun, recordJobRunReview, resolveJobPaths, resolveJobReviewAgentNominations, } from "../../job/job.js";
|
|
4
6
|
import { selfRunArgs } from "../../shared/spawn-self.js";
|
|
7
|
+
import { specdojoRootDir } from "../../shared/specdojo-config.js";
|
|
5
8
|
import { loadExecDefaultsConfig, resolveMemberCommand, } from "../agent-config.js";
|
|
9
|
+
import { recordCommandEvidence } from "../evidence.js";
|
|
10
|
+
import { runPostIntegration } from "../post-integration.js";
|
|
11
|
+
import { formatMarkdownFile } from "../format.js";
|
|
12
|
+
import { createPipelineState, pipelineStateLocation, updatePipelineStage, writePipelineState, } from "../pipeline-state.js";
|
|
6
13
|
import { activateResolvedProjectPaths, resolveProjectPaths } from "../project.js";
|
|
7
|
-
import {
|
|
8
|
-
import { ROUTINE_BUSY_SKIP_EXIT_CODE, ROUTINE_EXEC_ENV } from "./lock.js";
|
|
14
|
+
import { evidenceForReporter } from "../reporter.js";
|
|
9
15
|
import { isResultUnfilled, readResultFrontmatterSnapshot, renderReporterResult, scaffoldResult, stripLeadingListMarker, updateResultStatus, } from "../results.js";
|
|
10
|
-
import {
|
|
11
|
-
import { completeJobRun, executeJobCommand, generateJobReviewPlan, isJobCommandTask, jobRunUsesReviewedIntegration, loadJobDefinition, loadJobRunRecord, materializeJobRun, recordJobRunReview, resolveJobPaths, resolveJobReviewAgentNominations, } from "../../job/job.js";
|
|
12
|
-
import { ensureExecWorktree, formatGitResultFailure, gitOutput, gitResult, resolveWorktreeBase, summarizeGitHookFailure, } from "../worktree.js";
|
|
16
|
+
import { runLogPath, taskRecordPrefixes } from "../run-records.js";
|
|
13
17
|
import { mergeWorktreeIntoCurrent, removeWorktree, stabilizeCommitTargets, stageCommitTargets, worktreeStatusPaths, } from "../worktree-ops.js";
|
|
14
|
-
import {
|
|
15
|
-
import { evidenceForReporter } from "../reporter.js";
|
|
16
|
-
import { createPipelineState, pipelineStateLocation, updatePipelineStage, writePipelineState, } from "../pipeline-state.js";
|
|
17
|
-
import { configuredWorktreeBase, resolveAgentOverride, resolveExecDefaultsPath, selectCandidates, } from "./shared.js";
|
|
18
|
-
import { executorRequirements, expandPromptRefs, loadRosterForExecutionPath, resolveReporterAgentCandidates, } from "./agent.js";
|
|
18
|
+
import { ensureExecWorktree, formatGitResultFailure, gitEnvironment, gitOutput, gitResult, resolveWorktreeBase, summarizeGitHookFailure, } from "../worktree.js";
|
|
19
19
|
import { runAgentPipeline, runReporterStage } from "./agent-pipeline.js";
|
|
20
|
+
import { executorRequirements, expandPromptRefs, loadRosterForExecutionPath, resolveReporterAgentCandidates, } from "./agent.js";
|
|
20
21
|
import { resolveInPlaceCommand, spawnAgentInPlace } from "./in-place.js";
|
|
22
|
+
import { ROUTINE_BUSY_SKIP_EXIT_CODE, ROUTINE_EXEC_ENV } from "./lock.js";
|
|
23
|
+
import { configuredWorktreeBase, resolveAgentOverride, resolveExecDefaultsPath, selectCandidates, } from "./shared.js";
|
|
24
|
+
import { localJobNoopPath, snapshotJobOutput } from "../../job/noop.js";
|
|
25
|
+
import { executeJobSequence } from "./job-sequence.js";
|
|
21
26
|
async function runCommandJobMode(params) {
|
|
22
27
|
const { opts, record, runPath, planPath, projectId, schedulePath, executionPath } = params;
|
|
23
28
|
if (!isJobCommandTask(record.task))
|
|
@@ -31,7 +36,7 @@ async function runCommandJobMode(params) {
|
|
|
31
36
|
const repoRoot = specdojoRootDir();
|
|
32
37
|
const roster = loadRosterForExecutionPath(executionPath);
|
|
33
38
|
const execDefaults = loadExecDefaultsConfig(resolveExecDefaultsPath(opts, schedulePath), executionPath);
|
|
34
|
-
const analysisNickname = record.task.analysis
|
|
39
|
+
const analysisNickname = record.task.analysis && !opts.sequenceDeferredReason
|
|
35
40
|
? opts.reporterBy?.trim() || record.task.analysis.agent
|
|
36
41
|
: undefined;
|
|
37
42
|
const analysisResolution = analysisNickname
|
|
@@ -55,7 +60,9 @@ async function runCommandJobMode(params) {
|
|
|
55
60
|
process.stdout.write(`[dry-run] precondition:\n${record.task.precondition.command}\n`);
|
|
56
61
|
process.stdout.write(`[dry-run] precondition skip_when: ${record.task.precondition.skip_when}\n`);
|
|
57
62
|
}
|
|
58
|
-
process.stdout.write(`[dry-run] command:\n${record.task
|
|
63
|
+
process.stdout.write(`[dry-run] command:\n${jobCommandText(record.task)}\n`);
|
|
64
|
+
if (record.task.steps)
|
|
65
|
+
process.stdout.write(`[dry-run] sequence:\n${JSON.stringify(record.task.steps, null, 2)}\n`);
|
|
59
66
|
if (analysisCandidate) {
|
|
60
67
|
process.stdout.write(`[dry-run] agent: ${analysisCandidate.actor ?? ""} (analysis reporter)\n`);
|
|
61
68
|
process.stdout.write(`[dry-run] reporter command: ${analysisCandidate.command}\n`);
|
|
@@ -77,9 +84,19 @@ async function runCommandJobMode(params) {
|
|
|
77
84
|
startedAt: new Date().toISOString(),
|
|
78
85
|
...(record.task.targets ? { targets: record.task.targets } : {}),
|
|
79
86
|
});
|
|
80
|
-
const evidenceRunId =
|
|
87
|
+
const evidenceRunId = record.run_id;
|
|
81
88
|
process.stdout.write(`Running Job Run ${record.run_id} command in place.\n`);
|
|
82
|
-
const commandOutcome =
|
|
89
|
+
const commandOutcome = record.task.steps
|
|
90
|
+
? await executeJobSequence({
|
|
91
|
+
task: record.task,
|
|
92
|
+
runId: record.run_id,
|
|
93
|
+
attempt: record.attempts.length,
|
|
94
|
+
runPath,
|
|
95
|
+
cwd: repoRoot,
|
|
96
|
+
executionPath,
|
|
97
|
+
deferredReason: opts.sequenceDeferredReason,
|
|
98
|
+
})
|
|
99
|
+
: await executeJobCommand(record.task.command, repoRoot);
|
|
83
100
|
const commandPartial = !commandOutcome.error &&
|
|
84
101
|
record.task.partial_exit_code !== undefined &&
|
|
85
102
|
commandOutcome.exitCode === record.task.partial_exit_code;
|
|
@@ -90,7 +107,7 @@ async function runCommandJobMode(params) {
|
|
|
90
107
|
taskId: record.run_id,
|
|
91
108
|
runId: evidenceRunId,
|
|
92
109
|
actor: "specdojo-runner",
|
|
93
|
-
command: record.task
|
|
110
|
+
command: jobCommandText(record.task),
|
|
94
111
|
shell: process.platform === "win32" ? process.env.ComSpec || "cmd.exe" : "/bin/sh -eu",
|
|
95
112
|
startedAt: commandOutcome.startedAt,
|
|
96
113
|
completedAt: commandOutcome.completedAt,
|
|
@@ -115,9 +132,11 @@ async function runCommandJobMode(params) {
|
|
|
115
132
|
});
|
|
116
133
|
const reason = commandAccepted
|
|
117
134
|
? undefined
|
|
118
|
-
: commandOutcome.
|
|
119
|
-
?
|
|
120
|
-
:
|
|
135
|
+
: commandOutcome.reason
|
|
136
|
+
? commandOutcome.reason
|
|
137
|
+
: commandOutcome.error
|
|
138
|
+
? `command spawn failed: ${commandOutcome.error}`
|
|
139
|
+
: `command exited with code ${commandOutcome.exitCode ?? "unknown"}`;
|
|
121
140
|
await renderReporterResult(resultPath, {
|
|
122
141
|
schema_version: 1,
|
|
123
142
|
mode: "edit",
|
|
@@ -149,14 +168,12 @@ async function runCommandJobMode(params) {
|
|
|
149
168
|
}
|
|
150
169
|
else if (commandPartial) {
|
|
151
170
|
process.stdout.write(`Job Run partial: ${record.run_id}\n`);
|
|
152
|
-
if (record.trigger === "routine") {
|
|
153
|
-
process.stdout.write(`[routine-job] complete run_id=${record.run_id} state=partial\n`);
|
|
154
|
-
}
|
|
155
171
|
}
|
|
156
172
|
else {
|
|
157
173
|
process.stdout.write(`Job Run failed: ${record.run_id}\n`);
|
|
158
174
|
process.exitCode = commandOutcome.exitCode || 1;
|
|
159
175
|
}
|
|
176
|
+
process.stdout.write(`[routine-job] complete run_id=${record.run_id} state=${commandSucceeded ? "succeeded" : commandPartial ? "partial" : "failed"}\n`);
|
|
160
177
|
return;
|
|
161
178
|
}
|
|
162
179
|
const stateLocation = pipelineStateLocation({
|
|
@@ -191,7 +208,7 @@ async function runCommandJobMode(params) {
|
|
|
191
208
|
schedulePath,
|
|
192
209
|
executionPath,
|
|
193
210
|
reporterCandidates: [analysisCandidate],
|
|
194
|
-
planPrompt: expandPromptRefs(
|
|
211
|
+
planPrompt: expandPromptRefs(readPlanFile(planPath)),
|
|
195
212
|
resultPath,
|
|
196
213
|
execDefaults,
|
|
197
214
|
evidence: recorded.evidence,
|
|
@@ -211,14 +228,12 @@ async function runCommandJobMode(params) {
|
|
|
211
228
|
});
|
|
212
229
|
if (reporterOutcome.exitCode === 0) {
|
|
213
230
|
process.stdout.write(`Job Run ${commandPartial ? "partial" : "complete"}: ${record.run_id}\n`);
|
|
214
|
-
if (commandPartial && record.trigger === "routine") {
|
|
215
|
-
process.stdout.write(`[routine-job] complete run_id=${record.run_id} state=partial\n`);
|
|
216
|
-
}
|
|
217
231
|
}
|
|
218
232
|
else {
|
|
219
233
|
process.stdout.write(`Job Run failed: ${record.run_id}\n`);
|
|
220
234
|
process.exitCode = 1;
|
|
221
235
|
}
|
|
236
|
+
process.stdout.write(`[routine-job] complete run_id=${record.run_id} state=${reporterOutcome.exitCode === 0 ? (commandPartial ? "partial" : "succeeded") : "failed"}\n`);
|
|
222
237
|
}
|
|
223
238
|
const ACCEPTED_JOB_REVIEW_VERDICTS = new Set(["complete", "complete-with-findings"]);
|
|
224
239
|
function acceptsJobReview(record, verdict) {
|
|
@@ -383,6 +398,8 @@ async function runJobWorktreeMode(opts) {
|
|
|
383
398
|
});
|
|
384
399
|
if (preview.duplicateComplete) {
|
|
385
400
|
process.stdout.write(`Job Run already complete: ${preview.record.run_id} (${preview.record.state})\n`);
|
|
401
|
+
if (preview.record.state === "noop")
|
|
402
|
+
process.stdout.write(`[routine-job] noop state=noop\n`);
|
|
386
403
|
if (trigger === "routine" && preview.record.state === "partial") {
|
|
387
404
|
process.stdout.write(`[routine-job] complete run_id=${preview.record.run_id} state=partial\n`);
|
|
388
405
|
}
|
|
@@ -420,7 +437,7 @@ async function runJobWorktreeMode(opts) {
|
|
|
420
437
|
const child = spawnSync(executable, fullArgs, {
|
|
421
438
|
cwd: worktree.path,
|
|
422
439
|
env: {
|
|
423
|
-
...
|
|
440
|
+
...gitEnvironment(),
|
|
424
441
|
[ROUTINE_EXEC_ENV]: trigger === "routine" ? "1" : "0",
|
|
425
442
|
[JOB_REVIEW_WORKTREE_CHILD_ENV]: "1",
|
|
426
443
|
},
|
|
@@ -441,10 +458,23 @@ async function runJobWorktreeMode(opts) {
|
|
|
441
458
|
const worktreeExecutionPath = resolve(worktree.path, executionRel);
|
|
442
459
|
const worktreeJobPaths = resolveJobPaths(projectId);
|
|
443
460
|
const runPath = resolve(worktree.path, relative(repoRoot, preview.runPath));
|
|
461
|
+
if (child.status === 0 && existsSync(localJobNoopPath(executionPath, preview.record.run_id))) {
|
|
462
|
+
removeWorktree({
|
|
463
|
+
context: { repoRoot, schedulePath, executionPath },
|
|
464
|
+
worktree,
|
|
465
|
+
taskId: `${preview.record.run_id}-review`,
|
|
466
|
+
deleteBranch: true,
|
|
467
|
+
});
|
|
468
|
+
process.stdout.write(`[routine-job] noop state=noop\n`);
|
|
469
|
+
return;
|
|
470
|
+
}
|
|
444
471
|
if (!existsSync(runPath)) {
|
|
445
472
|
throw new Error(`Job Run record was not created in worktree: ${preview.record.run_id}`);
|
|
446
473
|
}
|
|
447
474
|
let record = loadJobRunRecord(runPath);
|
|
475
|
+
// The child may fail before printing a completion marker. Its worktree still owns
|
|
476
|
+
// the diagnostic Run record even if commit or review subsequently fails.
|
|
477
|
+
process.stdout.write(`[routine-job] recorded run_id=${record.run_id} state=${record.state}\n`);
|
|
448
478
|
const outputPaths = worktreeStatusPaths(worktree.path);
|
|
449
479
|
const outputCommit = commitJobPaths(worktree.path, outputPaths, `chore(routine): ${preview.definition.name}`, `Job Run: ${record.run_id}\nState: ${record.state}`);
|
|
450
480
|
const reviewTaskId = `${record.run_id}-review`;
|
|
@@ -491,7 +521,7 @@ async function runJobWorktreeMode(opts) {
|
|
|
491
521
|
executor: agents.executor,
|
|
492
522
|
reporterCandidates: agents.reporterCandidates,
|
|
493
523
|
planPath,
|
|
494
|
-
planPrompt: expandPromptRefs(
|
|
524
|
+
planPrompt: expandPromptRefs(readPlanFile(planPath)),
|
|
495
525
|
resultPath,
|
|
496
526
|
execDefaults,
|
|
497
527
|
mode: "review",
|
|
@@ -527,7 +557,7 @@ async function runJobWorktreeMode(opts) {
|
|
|
527
557
|
process.chdir(originalCwd);
|
|
528
558
|
}
|
|
529
559
|
const allowedReviewPrefixes = [
|
|
530
|
-
|
|
560
|
+
...taskRecordPrefixes(relative(worktree.path, worktreeExecutionPath), reviewTaskId),
|
|
531
561
|
];
|
|
532
562
|
const allowedReviewFiles = new Set([
|
|
533
563
|
relative(worktree.path, planPath).split(sep).join("/"),
|
|
@@ -570,12 +600,20 @@ async function runJobWorktreeMode(opts) {
|
|
|
570
600
|
process.exitCode = child.status || 1;
|
|
571
601
|
return;
|
|
572
602
|
}
|
|
603
|
+
const preIntegrationCommit = gitOutput(repoRoot, ["rev-parse", "HEAD"]).trim();
|
|
573
604
|
mergeWorktreeIntoCurrent({
|
|
574
605
|
context: { repoRoot, schedulePath, executionPath },
|
|
575
606
|
worktree,
|
|
576
607
|
taskId: reviewTaskId,
|
|
577
608
|
message: `chore(routine): merge ${record.run_id}`,
|
|
578
609
|
});
|
|
610
|
+
await runPostIntegration({
|
|
611
|
+
entries: execDefaults.pipeline?.post_integration,
|
|
612
|
+
repoRoot,
|
|
613
|
+
baseCommit: preIntegrationCommit,
|
|
614
|
+
outputCommit: gitOutput(repoRoot, ["rev-parse", "HEAD"]).trim(),
|
|
615
|
+
logPath: runLogPath(resolve(repoRoot, relative(worktree.path, resultPath)), "post-integration.log"),
|
|
616
|
+
});
|
|
579
617
|
removeWorktree({
|
|
580
618
|
context: { repoRoot, schedulePath, executionPath },
|
|
581
619
|
worktree,
|
|
@@ -584,11 +622,10 @@ async function runJobWorktreeMode(opts) {
|
|
|
584
622
|
});
|
|
585
623
|
process.stdout.write(`[routine-job] merged run_id=${record.run_id} state=${record.state} review=${verdict} branch=${worktree.branch}\n`);
|
|
586
624
|
}
|
|
587
|
-
|
|
625
|
+
async function runJobModeUnchecked(opts, resolvePipelineAgents, isWorktreeChild) {
|
|
588
626
|
const resolvedPaths = resolveProjectPaths({ project: opts.project });
|
|
589
627
|
activateResolvedProjectPaths(resolvedPaths);
|
|
590
|
-
|
|
591
|
-
if (!isWorktreeChild) {
|
|
628
|
+
if (!isWorktreeChild && !opts.sequenceDeferredReason) {
|
|
592
629
|
// A Job's task.review declaration takes precedence over the caller: it routes the Run
|
|
593
630
|
// through the reviewed integration path even without --worktree (routine action.commit).
|
|
594
631
|
const reviewProjectId = resolvedPaths.projectId ?? opts.project ?? process.env.SPECDOJO_PROJECT ?? "";
|
|
@@ -614,6 +651,7 @@ export async function runJobMode(opts, resolvePipelineAgents) {
|
|
|
614
651
|
scheduledAt: opts.scheduledAt,
|
|
615
652
|
trigger,
|
|
616
653
|
dryRun: !!opts.dryRun,
|
|
654
|
+
skipPrecondition: !!opts.sequenceDeferredReason,
|
|
617
655
|
});
|
|
618
656
|
const { definition, record, runPath, planPath } = materialized;
|
|
619
657
|
if (materialized.preconditionSkipped) {
|
|
@@ -624,21 +662,34 @@ export async function runJobMode(opts, resolvePipelineAgents) {
|
|
|
624
662
|
}
|
|
625
663
|
if (materialized.duplicateComplete) {
|
|
626
664
|
process.stdout.write(`Job Run already complete: ${record.run_id} (${record.state})\n`);
|
|
665
|
+
if (record.state === "noop")
|
|
666
|
+
process.stdout.write(`[routine-job] noop state=noop\n`);
|
|
627
667
|
if (trigger === "routine" && record.state === "partial") {
|
|
628
668
|
process.stdout.write(`[routine-job] complete run_id=${record.run_id} state=partial\n`);
|
|
629
669
|
}
|
|
630
670
|
return;
|
|
631
671
|
}
|
|
632
672
|
if (isJobCommandTask(record.task)) {
|
|
633
|
-
|
|
634
|
-
|
|
635
|
-
|
|
636
|
-
|
|
637
|
-
|
|
638
|
-
|
|
639
|
-
|
|
640
|
-
|
|
641
|
-
|
|
673
|
+
try {
|
|
674
|
+
await runCommandJobMode({
|
|
675
|
+
opts,
|
|
676
|
+
record,
|
|
677
|
+
runPath,
|
|
678
|
+
planPath,
|
|
679
|
+
projectId,
|
|
680
|
+
schedulePath,
|
|
681
|
+
executionPath,
|
|
682
|
+
});
|
|
683
|
+
}
|
|
684
|
+
catch (error) {
|
|
685
|
+
completeJobRun({
|
|
686
|
+
projectId,
|
|
687
|
+
runPath,
|
|
688
|
+
status: "failed",
|
|
689
|
+
reason: error instanceof Error ? error.message : String(error),
|
|
690
|
+
});
|
|
691
|
+
throw error;
|
|
692
|
+
}
|
|
642
693
|
return;
|
|
643
694
|
}
|
|
644
695
|
const task = {
|
|
@@ -696,7 +747,7 @@ export async function runJobMode(opts, resolvePipelineAgents) {
|
|
|
696
747
|
...(record.task.targets ? { targets: record.task.targets } : {}),
|
|
697
748
|
});
|
|
698
749
|
const resultScaffold = readResultFrontmatterSnapshot(resultPath);
|
|
699
|
-
const prompt = expandPromptRefs(
|
|
750
|
+
const prompt = expandPromptRefs(readPlanFile(planPath));
|
|
700
751
|
const repoRoot = specdojoRootDir();
|
|
701
752
|
let exitCode;
|
|
702
753
|
let reason;
|
|
@@ -743,4 +794,47 @@ export async function runJobMode(opts, resolvePipelineAgents) {
|
|
|
743
794
|
process.stdout.write(`Job Run failed: ${record.run_id}\n`);
|
|
744
795
|
process.exitCode = effectiveExit || 1;
|
|
745
796
|
}
|
|
797
|
+
process.stdout.write(`[routine-job] complete run_id=${record.run_id} state=${effectiveExit === 0 ? "succeeded" : "failed"}\n`);
|
|
798
|
+
}
|
|
799
|
+
export async function runJobMode(opts, resolvePipelineAgents) {
|
|
800
|
+
const isWorktreeChild = process.env[JOB_REVIEW_WORKTREE_CHILD_ENV] === "1";
|
|
801
|
+
// This marker routes only this Job's re-entry. Preconditions, commands, agents and
|
|
802
|
+
// their tests must choose their own worktree/review mode rather than inherit it.
|
|
803
|
+
delete process.env[JOB_REVIEW_WORKTREE_CHILD_ENV];
|
|
804
|
+
const paths = resolveProjectPaths({ project: opts.project });
|
|
805
|
+
activateResolvedProjectPaths(paths);
|
|
806
|
+
const projectId = paths.projectId ?? opts.project;
|
|
807
|
+
const definition = loadJobDefinition(resolveJobPaths(projectId), String(opts.job).trim());
|
|
808
|
+
if (opts.dryRun ||
|
|
809
|
+
opts.sequenceDeferredReason ||
|
|
810
|
+
jobRunUsesReviewedIntegration(definition, {
|
|
811
|
+
worktree: opts.worktree,
|
|
812
|
+
isWorktreeChild,
|
|
813
|
+
}) ||
|
|
814
|
+
// In-place command Jobs also support projects without a Git repository. There is
|
|
815
|
+
// nothing to commit there, and no reliable Git diff for suppressing Run records.
|
|
816
|
+
gitResult(specdojoRootDir(), ["rev-parse", "--is-inside-work-tree"]).status !== 0) {
|
|
817
|
+
await runJobModeUnchecked(opts, resolvePipelineAgents, isWorktreeChild);
|
|
818
|
+
return;
|
|
819
|
+
}
|
|
820
|
+
const preview = await materializeJobRun({
|
|
821
|
+
projectId,
|
|
822
|
+
jobId: String(opts.job).trim(),
|
|
823
|
+
inputs: opts.input,
|
|
824
|
+
scheduledAt: opts.scheduledAt,
|
|
825
|
+
dryRun: true,
|
|
826
|
+
});
|
|
827
|
+
if (preview.duplicateComplete) {
|
|
828
|
+
await runJobModeUnchecked(opts, resolvePipelineAgents, isWorktreeChild);
|
|
829
|
+
return;
|
|
830
|
+
}
|
|
831
|
+
const snapshot = snapshotJobOutput(specdojoRootDir(), paths.executionPath, preview.record);
|
|
832
|
+
await runJobModeUnchecked({ ...opts, scheduledAt: preview.record.scheduled_at }, resolvePipelineAgents, isWorktreeChild);
|
|
833
|
+
if (!existsSync(preview.runPath))
|
|
834
|
+
return;
|
|
835
|
+
const record = loadJobRunRecord(preview.runPath);
|
|
836
|
+
if (record.state === "succeeded" && !snapshot.hasChanges()) {
|
|
837
|
+
snapshot.discard(completeJobRun({ projectId, runPath: preview.runPath, status: "noop" }));
|
|
838
|
+
process.stdout.write(`[routine-job] noop state=noop\n`);
|
|
839
|
+
}
|
|
746
840
|
}
|