specdojo 0.6.0 → 0.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.github/agents/specdojo-orchestrator.md +3 -2
- package/CHANGELOG.md +193 -0
- package/README.md +2 -2
- package/dist/catalog/build.js +24 -1
- package/dist/catalog/plan.js +1 -1
- package/dist/catalog/scaffold.js +4 -1
- package/dist/commands/agent.js +33 -0
- package/dist/commands/init.js +6 -1
- package/dist/commands/night-orchestrator.js +6 -4
- package/dist/commands/orchestrator.js +10 -1
- package/dist/dashboard/dashboard-timeline.js +18 -16
- package/dist/dashboard/dashboard.js +612 -259
- package/dist/dashboard/epic-plan.js +81 -0
- package/dist/dashboard/exec-records.js +16 -20
- package/dist/dashboard/routines.js +8 -6
- package/dist/dashboard/timeline-build.js +5 -9
- package/dist/dashboard/timeline.js +9 -4
- package/dist/devcontainer/command.js +18 -0
- package/dist/devcontainer/host-script.js +21 -0
- package/dist/devcontainer/scaffold.js +22 -3
- package/dist/docs/frontmatter-namespace.js +1 -48
- package/dist/docs/yaml-pages.js +125 -3
- package/dist/exec/agent-config.js +22 -0
- package/dist/exec/agent-plan.js +3 -2
- package/dist/exec/antigravity-session.js +154 -0
- package/dist/exec/commands.js +69 -21
- package/dist/exec/commit-hook-skips.js +78 -0
- package/dist/exec/core.js +19 -7
- package/dist/exec/events.js +159 -8
- package/dist/exec/evidence.js +64 -16
- package/dist/exec/handoff.js +9 -13
- package/dist/exec/limit.js +1 -1
- package/dist/exec/mechanical-result.js +45 -0
- package/dist/exec/migrate-records.js +249 -0
- package/dist/exec/parent-validation.js +160 -12
- package/dist/exec/pipeline-state.js +27 -5
- package/dist/exec/plan-markdownlint.js +89 -0
- package/dist/exec/plans-condense-findings.js +89 -0
- package/dist/exec/plans-core.js +24 -17
- package/dist/exec/plans-generation.js +52 -25
- package/dist/exec/plans-grade-findings.js +8 -3
- package/dist/exec/plans-kata-findings.js +61 -0
- package/dist/exec/plans-planning.js +3 -3
- package/dist/exec/plans-storage.js +12 -24
- package/dist/exec/register-resume.js +69 -42
- package/dist/exec/register.js +26 -22
- package/dist/exec/repo-integration-sync.js +8 -4
- package/dist/exec/repo-integration.js +21 -1
- package/dist/exec/reporter.js +121 -23
- package/dist/exec/results.js +85 -24
- package/dist/exec/review-completion.js +47 -0
- package/dist/exec/review-kata.js +109 -0
- package/dist/exec/run/agent-pipeline.js +75 -6
- package/dist/exec/run/agent.js +20 -7
- package/dist/exec/run/in-place.js +69 -32
- package/dist/exec/run/job.js +81 -24
- package/dist/exec/run/lifecycle-commands.js +264 -43
- package/dist/exec/run/mode-shared.js +11 -3
- package/dist/exec/run/register-command.js +12 -10
- package/dist/exec/run/register-core.js +20 -13
- package/dist/exec/run/register-mode.js +12 -12
- package/dist/exec/run/register-post-review.js +21 -9
- package/dist/exec/run/register-resume.js +28 -18
- package/dist/exec/run/register-state.js +10 -7
- package/dist/exec/run/register-worktree.js +60 -30
- package/dist/exec/run/schedule-mode.js +26 -6
- package/dist/exec/run/schedule-prepare.js +228 -45
- package/dist/exec/run/schedule-task.js +132 -25
- package/dist/exec/run/shared.js +4 -3
- package/dist/exec/run/trailing-records.js +35 -0
- package/dist/exec/run-records.js +2 -0
- package/dist/exec/strategy.js +1 -0
- package/dist/exec/trailing-records.js +242 -0
- package/dist/exec/trial-commands.js +3 -2
- package/dist/exec/validate-records-commit.js +110 -0
- package/dist/exec/validate-records.js +148 -0
- package/dist/exec/worktree-command.js +29 -16
- package/dist/exec/worktree-ops-commit.js +118 -59
- package/dist/exec/worktree-ops-lifecycle.js +77 -44
- package/dist/exec/worktree-ops-merge.js +13 -2
- package/dist/exec/worktree-ops.js +2 -2
- package/dist/exec/worktree.js +19 -2
- package/dist/grade/apply.js +32 -6
- package/dist/grade/command-inspect.js +2 -2
- package/dist/grade/command-run.js +2 -0
- package/dist/grade/command-shared.js +1 -1
- package/dist/grade/core.js +18 -5
- package/dist/grade/markdown.js +3 -3
- package/dist/grade/pipeline-state.js +15 -11
- package/dist/grade/plan.js +37 -17
- package/dist/grade/result.js +3 -3
- package/dist/grade/run.js +23 -3
- package/dist/grade/target-discovery.js +17 -4
- package/dist/grade/targets.js +12 -11
- package/dist/job/job.js +31 -17
- package/dist/job/noop.js +104 -0
- package/dist/register/core.js +2 -0
- package/dist/register/create-commands.js +28 -3
- package/dist/register/deliverable-target.js +9 -1
- package/dist/register/epic.js +104 -26
- package/dist/register/event-merge.js +3 -0
- package/dist/register/events.js +4 -0
- package/dist/register/external-project.js +3 -0
- package/dist/register/item.js +6 -0
- package/dist/register/maintenance-commands.js +4 -1
- package/dist/register/planning.js +7 -14
- package/dist/register/register.js +74 -32
- package/dist/register/track-domains.js +34 -0
- package/dist/register/track-plan.js +78 -0
- package/dist/register/transition-commands.js +8 -0
- package/dist/register/work-table.js +64 -0
- package/dist/review/grade.js +35 -13
- package/dist/routine/definition.js +4 -3
- package/dist/routine/failure.js +30 -0
- package/dist/routine/routine.js +56 -32
- package/dist/routine/storage.js +33 -0
- package/dist/schedule/schedule.js +1 -0
- package/dist/schedule/strategy-generate-document.js +26 -14
- package/dist/schedule/strategy-generate-scope.js +17 -45
- package/dist/schedule/strategy-generate.js +33 -3
- package/dist/schedule/strategy-profiles.js +86 -12
- package/dist/shared/agent-types.js +2 -0
- package/dist/shared/condense-records.js +25 -0
- package/dist/shared/deprecation.js +8 -0
- package/dist/shared/document-metadata.js +20 -0
- package/dist/shared/finding-cause.js +20 -0
- package/dist/shared/frontmatter-namespace.js +48 -0
- package/dist/shared/git.js +149 -15
- package/dist/shared/grade-result.js +17 -1
- package/dist/shared/local-state.js +20 -0
- package/dist/shared/markdownlint-config.js +8 -3
- package/dist/shared/plan-conventions.js +129 -0
- package/dist/shared/plan-templates.js +57 -41
- package/dist/shared/provider-scaffold.js +2 -0
- package/dist/shared/run-records.js +224 -0
- package/dist/shared/specdojo-config.js +39 -21
- package/dist/shared/specdojo-gitignore.js +1 -0
- package/dist/shared/text.js +65 -5
- package/dist/shared/timeline-index.js +2 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
- package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
- package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
- package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
- package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
- package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
- package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
- package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
- package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
- package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
- package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
- package/docs/ja/specdojo/guides/docs-editing-guide.md +48 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
- package/docs/ja/specdojo/guides/exec-config-guide.md +61 -28
- package/docs/ja/specdojo/guides/exec-operation-guide.md +61 -13
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
- package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +589 -807
- package/docs/ja/specdojo/guides/register-operation-guide.md +26 -4
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +33 -4
- package/docs/ja/specdojo/guides/review-guide.md +22 -19
- package/docs/ja/specdojo/guides/routine-operation-guide.md +14 -8
- package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
- package/docs/ja/specdojo/guides/schedule-design-guide.md +7 -4
- package/docs/ja/specdojo/guides/schedule-operation-guide.md +41 -3
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
- package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
- package/docs/ja/specdojo/guides/use-case-guide.md +471 -74
- package/docs/ja/specdojo/recipes/bac-recipe.md +94 -0
- package/docs/ja/specdojo/recipes/bes-recipe.md +105 -0
- package/docs/ja/specdojo/recipes/br-recipe.md +84 -0
- package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +88 -86
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +108 -122
- package/docs/ja/specdojo/recipes/cnd-recipe.md +125 -0
- package/docs/ja/specdojo/recipes/cpd-recipe.md +126 -0
- package/docs/ja/specdojo/recipes/cxd-recipe.md +145 -0
- package/docs/ja/specdojo/recipes/ifd-recipe.md +134 -0
- package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +135 -86
- package/docs/ja/specdojo/recipes/ifx-index-recipe.md +130 -0
- package/docs/ja/specdojo/recipes/pm-organization-recipe.md +29 -26
- package/docs/ja/specdojo/recipes/pm-plan-recipe.md +35 -26
- package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +38 -28
- package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -31
- package/docs/ja/specdojo/recipes/pm-roles-recipe.md +26 -28
- package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +10 -8
- package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +18 -17
- package/docs/ja/specdojo/recipes/stsd-recipe.md +100 -62
- package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +106 -0
- package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +137 -0
- package/docs/ja/specdojo/recipes/sysd-index-recipe.md +122 -0
- package/docs/ja/specdojo/references/command-reference.md +146 -99
- package/docs/ja/specdojo/references/deliverables-reference.md +9 -4
- package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
- package/docs/ja/specdojo/references/specdojo-config-reference.md +17 -16
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +72 -290
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +212 -79
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +138 -154
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +147 -59
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +100 -96
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +88 -108
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +126 -211
- package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +367 -0
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +132 -106
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +102 -68
- package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +152 -0
- package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
- package/docs/ja/specdojo/rulebooks/clis-rulebook.md +187 -0
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +93 -247
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +104 -241
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +124 -257
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +87 -98
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +9 -7
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/dss-rulebook.md +193 -0
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +100 -54
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +69 -252
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +91 -76
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +252 -226
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +118 -40
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +11 -11
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +9 -9
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +4 -4
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +11 -11
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +11 -11
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +34 -29
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +8 -8
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +2 -2
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +50 -56
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +46 -55
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +57 -54
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +50 -65
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +2 -2
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +70 -97
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +47 -56
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -135
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +116 -32
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +118 -61
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +152 -57
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +51 -39
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +101 -46
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +72 -329
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +74 -263
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +78 -195
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +3 -4
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +3 -3
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +140 -143
- package/docs/ja/specdojo/samples/bac-sample.md +106 -21
- package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
- package/docs/ja/specdojo/samples/bds-sample.md +100 -21
- package/docs/ja/specdojo/samples/bes-index-sample.md +59 -20
- package/docs/ja/specdojo/samples/bes-sample.md +80 -21
- package/docs/ja/specdojo/samples/br-sample.md +68 -14
- package/docs/ja/specdojo/samples/ccd-sample.md +81 -19
- package/docs/ja/specdojo/samples/cdfd-overview-sample.md +248 -140
- package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +130 -97
- package/docs/ja/specdojo/samples/cdsd-sample.md +89 -20
- package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
- package/docs/ja/specdojo/samples/cld-sample.md +3 -30
- package/docs/ja/specdojo/samples/clis-sample.md +132 -0
- package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
- package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
- package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
- package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
- package/docs/ja/specdojo/samples/dss-sample.md +175 -0
- package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
- package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
- package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
- package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
- package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
- package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
- package/docs/ja/specdojo/samples/pm-organization-sample.md +52 -20
- package/docs/ja/specdojo/samples/pm-plan-sample.md +84 -26
- package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +55 -22
- package/docs/ja/specdojo/samples/pm-raci-sample.md +69 -28
- package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
- package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +50 -26
- package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +89 -62
- package/docs/ja/specdojo/samples/sf-index-sample.md +89 -20
- package/docs/ja/specdojo/samples/sf-sample.md +121 -21
- package/docs/ja/specdojo/samples/sld-sample.md +107 -21
- package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
- package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
- package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
- package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
- package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
- package/docs/ja/specdojo/samples/uis-sample.md +164 -20
- package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
- package/docs/ja/specdojo/templates/bac-template.md +76 -0
- package/docs/ja/specdojo/templates/bes-template.md +56 -0
- package/docs/ja/specdojo/templates/br-template.md +64 -0
- package/docs/ja/specdojo/templates/cdfd-overview-template.md +161 -83
- package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
- package/docs/ja/specdojo/templates/cdfd-uc-template.md +130 -89
- package/docs/ja/specdojo/templates/cnd-template.md +137 -0
- package/docs/ja/specdojo/templates/cpd-template.md +129 -0
- package/docs/ja/specdojo/templates/cxd-template.md +105 -0
- package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
- package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
- package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
- package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
- package/docs/ja/specdojo/templates/ifd-template.md +86 -0
- package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
- package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
- package/docs/ja/specdojo/templates/opr-template.md +2 -4
- package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
- package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
- package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
- package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
- package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
- package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
- package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
- package/docs/ja/specdojo/templates/stsd-template.md +46 -21
- package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
- package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
- package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
- package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
- package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
- package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
- package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
- package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +54 -3
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
- package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
- package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
- package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
- package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -0
- package/package.json +6 -3
- package/templates/antigravity/README.md +19 -46
- package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
- package/templates/antigravity/orchestrator.md +3 -2
- package/templates/antigravity/settings.edit.json +73 -0
- package/templates/antigravity/settings.orchestrator.json +15 -0
- package/templates/antigravity/settings.report.json +7 -0
- package/templates/antigravity/settings.review.json +7 -0
- package/templates/claude/agents/specdojo-orchestrator.md +3 -2
- package/templates/codex/agents/specdojo-orchestrator.toml +3 -2
- package/templates/codex/orchestrator.md +3 -2
- package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
- package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -96
- package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
- package/templates/devcontainer/tmux.conf +6 -0
- package/templates/init-agent-members.yaml +1 -0
- package/templates/init-exec-defaults.yaml +1 -1
- package/templates/opencode/agents/specdojo-orchestrator.md +3 -2
|
@@ -1,26 +1,29 @@
|
|
|
1
|
+
import { readPlanFile } from "../../shared/plan-conventions.js";
|
|
1
2
|
import { spawn } from "node:child_process";
|
|
2
3
|
import { existsSync, readFileSync } from "node:fs";
|
|
3
|
-
import {
|
|
4
|
+
import { relative, resolve, sep } from "node:path";
|
|
5
|
+
import { extractLocalId } from "../../schedule/phase-sets.js";
|
|
6
|
+
import { resolveAgentMember, specdojoRootDir, } from "../../shared/specdojo-config.js";
|
|
4
7
|
import { loadExecDefaultsConfig, resolveMemberCommand, } from "../agent-config.js";
|
|
8
|
+
import { agentGitStateViolation, captureAgentGitStateSnapshot, changedAgentGitStateFields, } from "../agent-git-state.js";
|
|
9
|
+
import { agentProtectedConfigViolation, captureAgentProtectedConfigSnapshot, changedAgentProtectedConfigPaths, } from "../agent-protected-config.js";
|
|
10
|
+
import { enforceExecutorReportContract, executorStageResumeHint, recordExecutorEvidence, recordReporterFailureOutput, writeExecutorEvidence, } from "../evidence.js";
|
|
11
|
+
import { createPipelineState, pipelineStateLocation, updatePipelineStage, writePipelineState, } from "../pipeline-state.js";
|
|
12
|
+
import { archivePlan, buildInPlaceStem, finalizeResultSectionsForDeliverable, generateDeliverablePlan, generateSinglePlan, parsePlanTaskIdentity, resolveDeliverableTarget, stemFromPlanPath, targetDocIdsForScheduledTask, } from "../plans.js";
|
|
5
13
|
import { activateResolvedProjectPaths, resolveProjectPaths } from "../project.js";
|
|
14
|
+
import { recordGitStateBlock, recordProtectedConfigBlock } from "../protection-handoff.js";
|
|
15
|
+
import { deriveReporterFacts, evidenceForReporter, runReporterWithFormatRetry, } from "../reporter.js";
|
|
16
|
+
import { isResultUnfilled, readResultFrontmatterSnapshot, renderReporterResult, scaffoldResult, updateResultStatus, } from "../results.js";
|
|
17
|
+
import { isRunRecordPath, recordRef, recordStem, taskRecordPaths } from "../run-records.js";
|
|
6
18
|
import { randomHex } from "../shared.js";
|
|
7
|
-
import {
|
|
8
|
-
import { extractLocalId } from "../../schedule/phase-sets.js";
|
|
9
|
-
import { archivePlan, buildInPlaceStem, generateDeliverablePlan, generateSinglePlan, parsePlanTaskIdentity, resolveDeliverableTarget, finalizeResultSectionsForDeliverable, targetDocIdsForScheduledTask, stemFromPlanPath, } from "../plans.js";
|
|
19
|
+
import { configuredProductCheckouts, productRepoEnvironment, withAgentExtraRoots, withoutInheritedRepoEnvironment, } from "../task-repos.js";
|
|
10
20
|
import { buildTaskView } from "../task-view.js";
|
|
11
|
-
import { isResultUnfilled, readResultFrontmatterSnapshot, renderReporterResult, scaffoldResult, updateResultStatus, } from "../results.js";
|
|
12
21
|
import { gitEnvironment } from "../worktree.js";
|
|
13
|
-
import { agentProtectedConfigViolation, captureAgentProtectedConfigSnapshot, changedAgentProtectedConfigPaths, } from "../agent-protected-config.js";
|
|
14
|
-
import { agentGitStateViolation, captureAgentGitStateSnapshot, changedAgentGitStateFields, } from "../agent-git-state.js";
|
|
15
|
-
import { recordGitStateBlock, recordProtectedConfigBlock } from "../protection-handoff.js";
|
|
16
|
-
import { recordExecutorEvidence, recordReporterFailureOutput, writeExecutorEvidence, } from "../evidence.js";
|
|
17
|
-
import { deriveReporterFacts, evidenceForReporter, runReporterWithFormatRetry, } from "../reporter.js";
|
|
18
|
-
import { createPipelineState, pipelineStateLocation, updatePipelineStage, writePipelineState, } from "../pipeline-state.js";
|
|
19
|
-
import { pinnedExecutor, pinnedReporter, resolvePinnedRateLimitRunOptions, resolveExecDefaultsPath, selectCandidates, } from "./shared.js";
|
|
20
22
|
import { appendParentValidationsToExecutorEvidence, buildExecutorPrompt, executorRequirements, expandPromptRefs, extractBlockReason, loadRosterForExecutionPath, reportProtectionHandoffRecord, resolveReporterAgentCandidates, runWithRetry, } from "./agent.js";
|
|
21
|
-
import {
|
|
22
|
-
import {
|
|
23
|
-
import {
|
|
23
|
+
import { pipelineRecoveryMeta, spawnBlock, spawnClaim, spawnComplete, stageActorMeta, } from "./mode-shared.js";
|
|
24
|
+
import { enforceScheduleKataReview, gradeBeforeReviewPlan } from "./schedule-prepare.js";
|
|
25
|
+
import { reviewTaskBlockReason } from "../review-completion.js";
|
|
26
|
+
import { pinnedExecutor, pinnedReporter, resolveExecDefaultsPath, resolvePinnedRateLimitRunOptions, selectCandidates, } from "./shared.js";
|
|
24
27
|
// Resolve the agent command and the actor for an in-place run, ignoring task state. Unlike the
|
|
25
28
|
// worktree flow, this never requires the task to be claimable. The actor is derived the same way
|
|
26
29
|
// as the worktree path (`prepareTask`): explicit --by wins, otherwise the resolved member's
|
|
@@ -162,18 +165,11 @@ export async function runInPlaceMode(opts) {
|
|
|
162
165
|
const projectId = resolvedPaths.projectId ?? opts.project ?? process.env.SPECDOJO_PROJECT ?? "";
|
|
163
166
|
const roster = loadRosterForExecutionPath(executionPath);
|
|
164
167
|
const execDefaults = loadExecDefaultsConfig(resolveExecDefaultsPath(opts, schedulePath), executionPath);
|
|
165
|
-
//
|
|
166
|
-
// file naming. Task-identity runs (--task) always use the fixed `<task-id>` stem (shared with
|
|
167
|
-
// claim / run --track-state), so an in-place result can be adopted by claim/complete without
|
|
168
|
-
// renaming; re-runs overwrite the same plan/result and git history is the audit trail. Only
|
|
169
|
-
// --deliverable / ad-hoc runs (no task identity) use a unique stem to avoid id collisions.
|
|
168
|
+
// State tracking and artifact identity are independent: each new execution gets its own run.
|
|
170
169
|
const trackState = !!opts.trackState;
|
|
171
|
-
const plansDir = join(executionPath, "exec", "plans");
|
|
172
170
|
let planPath;
|
|
173
171
|
let slug;
|
|
174
|
-
//
|
|
175
|
-
// recovered from the plan filename so re-running the same plan overwrites the tied result; for
|
|
176
|
-
// --deliverable it is unique per run (`<slug>-<UTC>-<rand>`).
|
|
172
|
+
// The run id is recovered from a supplied managed plan or minted for a new execution.
|
|
177
173
|
let stem;
|
|
178
174
|
let task = null;
|
|
179
175
|
// null target = bring-your-own --plan (not generated, not archived).
|
|
@@ -212,14 +208,14 @@ export async function runInPlaceMode(opts) {
|
|
|
212
208
|
const taskId = opts.task.trim();
|
|
213
209
|
task = buildTaskView(schedulePath, executionPath, taskId);
|
|
214
210
|
slug = taskId;
|
|
215
|
-
stem = taskId;
|
|
216
|
-
planPath =
|
|
211
|
+
stem = buildInPlaceStem(taskId);
|
|
212
|
+
planPath = taskRecordPaths(executionPath, taskId, stem).plan;
|
|
217
213
|
}
|
|
218
214
|
else {
|
|
219
215
|
target = resolveDeliverableTarget(catalogPath ?? "", opts.deliverable.trim());
|
|
220
216
|
slug = target.slug;
|
|
221
217
|
stem = buildInPlaceStem(slug);
|
|
222
|
-
planPath =
|
|
218
|
+
planPath = taskRecordPaths(executionPath, slug, stem).plan;
|
|
223
219
|
task = {
|
|
224
220
|
id: slug,
|
|
225
221
|
local_id: target.localId,
|
|
@@ -259,8 +255,9 @@ export async function runInPlaceMode(opts) {
|
|
|
259
255
|
}
|
|
260
256
|
// Generate the plan on demand (skip for bring-your-own --plan).
|
|
261
257
|
const generatedPlan = !opts.plan;
|
|
258
|
+
let reviewGradeOutcome;
|
|
262
259
|
if (opts.task && task) {
|
|
263
|
-
|
|
260
|
+
reviewGradeOutcome = await gradeBeforeReviewPlan({
|
|
264
261
|
task,
|
|
265
262
|
projectId,
|
|
266
263
|
catalogPath,
|
|
@@ -275,6 +272,7 @@ export async function runInPlaceMode(opts) {
|
|
|
275
272
|
viewpointsPath,
|
|
276
273
|
projectContext,
|
|
277
274
|
task,
|
|
275
|
+
outPath: planPath,
|
|
278
276
|
...(stem ? { stem } : {}),
|
|
279
277
|
...(reviewGradeOutcome ? { reviewGradeOutcome } : {}),
|
|
280
278
|
});
|
|
@@ -288,10 +286,11 @@ export async function runInPlaceMode(opts) {
|
|
|
288
286
|
viewpointsPath,
|
|
289
287
|
projectContext,
|
|
290
288
|
target,
|
|
289
|
+
outPath: planPath,
|
|
291
290
|
...(stem ? { stem } : {}),
|
|
292
291
|
});
|
|
293
292
|
}
|
|
294
|
-
const planPrompt = expandPromptRefs(
|
|
293
|
+
const planPrompt = expandPromptRefs(readPlanFile(planPath));
|
|
295
294
|
const prompt = task?.agent_pipeline
|
|
296
295
|
? buildExecutorPrompt(planPrompt, execDefaults.pipeline?.parent_validations)
|
|
297
296
|
: planPrompt;
|
|
@@ -318,7 +317,7 @@ export async function runInPlaceMode(opts) {
|
|
|
318
317
|
taskId: slug,
|
|
319
318
|
mode: task.mode ?? "edit",
|
|
320
319
|
projectId: projectId || planProjectId,
|
|
321
|
-
planRef:
|
|
320
|
+
planRef: recordRef(executionPath, planPath),
|
|
322
321
|
agent: actor,
|
|
323
322
|
startedAt: new Date().toISOString(),
|
|
324
323
|
...(stem ? { stem } : {}),
|
|
@@ -335,9 +334,12 @@ export async function runInPlaceMode(opts) {
|
|
|
335
334
|
let pipelineStateRef;
|
|
336
335
|
let pipelineRunId;
|
|
337
336
|
let pipelineFailureStage = "executor";
|
|
337
|
+
let failedStageActor = actor;
|
|
338
338
|
if (task?.agent_pipeline) {
|
|
339
339
|
const startedAt = new Date().toISOString();
|
|
340
|
-
pipelineRunId =
|
|
340
|
+
pipelineRunId = isRunRecordPath(planPath)
|
|
341
|
+
? recordStem(planPath)
|
|
342
|
+
: `${new Date().toISOString().replace(/[-:.]/g, "")}-${randomHex(4)}`;
|
|
341
343
|
const stateLocation = pipelineStateLocation({
|
|
342
344
|
repoRoot,
|
|
343
345
|
worktreePath: repoRoot,
|
|
@@ -414,7 +416,25 @@ export async function runInPlaceMode(opts) {
|
|
|
414
416
|
evidencePath: recorded.evidencePath,
|
|
415
417
|
});
|
|
416
418
|
}
|
|
417
|
-
|
|
419
|
+
failedStageActor = outcome.actor ?? actor;
|
|
420
|
+
// PJR-1GCD: a missing approach-required field is an executor failure, not a reporter failure.
|
|
421
|
+
const contractFailure = outcome.result === "success"
|
|
422
|
+
? enforceExecutorReportContract({
|
|
423
|
+
evidence: recorded.evidence,
|
|
424
|
+
evidencePath: recorded.evidencePath,
|
|
425
|
+
contract: { approach: task.approach, mode: task.mode ?? "edit" },
|
|
426
|
+
resumeHint: executorStageResumeHint({ kind: "schedule", taskId: task.id }),
|
|
427
|
+
})
|
|
428
|
+
: undefined;
|
|
429
|
+
if (contractFailure) {
|
|
430
|
+
const blockedAt = new Date().toISOString();
|
|
431
|
+
pipelineState = updatePipelineStage(pipelineState, "executor", { status: "blocked", completed_at: blockedAt }, blockedAt);
|
|
432
|
+
writePipelineState(stateLocation.path, pipelineState);
|
|
433
|
+
process.stdout.write(`Executor report rejected before the reporter: ${contractFailure}\n`);
|
|
434
|
+
pipelineBlockReason = contractFailure;
|
|
435
|
+
exitCode = 1;
|
|
436
|
+
}
|
|
437
|
+
else if (outcome.result === "success") {
|
|
418
438
|
pipelineFailureStage = "reporter";
|
|
419
439
|
const reporterEvidence = evidenceForReporter(recorded.evidence, {
|
|
420
440
|
repoRoot,
|
|
@@ -493,6 +513,7 @@ export async function runInPlaceMode(opts) {
|
|
|
493
513
|
invocationOutputs: reporter.invocationOutputs,
|
|
494
514
|
});
|
|
495
515
|
}
|
|
516
|
+
failedStageActor = reporterActor ?? failedStageActor;
|
|
496
517
|
const reporterCompletedAt = new Date().toISOString();
|
|
497
518
|
pipelineState = updatePipelineStage(pipelineState, "reporter", {
|
|
498
519
|
status: exitCode === 0
|
|
@@ -528,7 +549,22 @@ export async function runInPlaceMode(opts) {
|
|
|
528
549
|
// normally. The agent's core duty is to fill the result while preserving its scaffold
|
|
529
550
|
// frontmatter, so treat an incomplete or modified result as a block even on exit 0.
|
|
530
551
|
let effectiveExit = exitCode;
|
|
552
|
+
if (exitCode === 0 && task && resultPath) {
|
|
553
|
+
enforceScheduleKataReview({ task, catalogPath, resultPath, projectId, rootDir: repoRoot });
|
|
554
|
+
}
|
|
531
555
|
let blockReason = pipelineBlockReason;
|
|
556
|
+
const reviewBlockReason = exitCode === 0 && task && resultPath
|
|
557
|
+
? reviewTaskBlockReason({
|
|
558
|
+
mode: task.mode,
|
|
559
|
+
resultPath,
|
|
560
|
+
...(reviewGradeOutcome ? { gradeOutcome: reviewGradeOutcome } : {}),
|
|
561
|
+
})
|
|
562
|
+
: undefined;
|
|
563
|
+
if (reviewBlockReason) {
|
|
564
|
+
effectiveExit = 1;
|
|
565
|
+
blockReason = reviewBlockReason;
|
|
566
|
+
process.stdout.write(`run blocked: ${label} (${reviewBlockReason})\n`);
|
|
567
|
+
}
|
|
532
568
|
if (exitCode === 0 &&
|
|
533
569
|
resultPath &&
|
|
534
570
|
task &&
|
|
@@ -549,6 +585,7 @@ export async function runInPlaceMode(opts) {
|
|
|
549
585
|
else
|
|
550
586
|
spawnBlock(projectId, opts.task.trim(), actor, blockReason ?? "agent exited with non-zero code", {
|
|
551
587
|
limit_deferred: "false",
|
|
588
|
+
...stageActorMeta(actor, failedStageActor),
|
|
552
589
|
...(pipelineRunId
|
|
553
590
|
? pipelineRecoveryMeta({
|
|
554
591
|
stage: pipelineFailureStage,
|
package/dist/exec/run/job.js
CHANGED
|
@@ -1,23 +1,26 @@
|
|
|
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, 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 { formatMarkdownFile } from "../format.js";
|
|
11
|
+
import { createPipelineState, pipelineStateLocation, updatePipelineStage, writePipelineState, } from "../pipeline-state.js";
|
|
6
12
|
import { activateResolvedProjectPaths, resolveProjectPaths } from "../project.js";
|
|
7
|
-
import {
|
|
8
|
-
import { ROUTINE_BUSY_SKIP_EXIT_CODE, ROUTINE_EXEC_ENV } from "./lock.js";
|
|
13
|
+
import { evidenceForReporter } from "../reporter.js";
|
|
9
14
|
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";
|
|
15
|
+
import { taskRecordPrefixes } from "../run-records.js";
|
|
13
16
|
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";
|
|
17
|
+
import { ensureExecWorktree, formatGitResultFailure, gitEnvironment, gitOutput, gitResult, resolveWorktreeBase, summarizeGitHookFailure, } from "../worktree.js";
|
|
19
18
|
import { runAgentPipeline, runReporterStage } from "./agent-pipeline.js";
|
|
19
|
+
import { executorRequirements, expandPromptRefs, loadRosterForExecutionPath, resolveReporterAgentCandidates, } from "./agent.js";
|
|
20
20
|
import { resolveInPlaceCommand, spawnAgentInPlace } from "./in-place.js";
|
|
21
|
+
import { ROUTINE_BUSY_SKIP_EXIT_CODE, ROUTINE_EXEC_ENV } from "./lock.js";
|
|
22
|
+
import { configuredWorktreeBase, resolveAgentOverride, resolveExecDefaultsPath, selectCandidates, } from "./shared.js";
|
|
23
|
+
import { localJobNoopPath, snapshotJobOutput } from "../../job/noop.js";
|
|
21
24
|
async function runCommandJobMode(params) {
|
|
22
25
|
const { opts, record, runPath, planPath, projectId, schedulePath, executionPath } = params;
|
|
23
26
|
if (!isJobCommandTask(record.task))
|
|
@@ -77,7 +80,7 @@ async function runCommandJobMode(params) {
|
|
|
77
80
|
startedAt: new Date().toISOString(),
|
|
78
81
|
...(record.task.targets ? { targets: record.task.targets } : {}),
|
|
79
82
|
});
|
|
80
|
-
const evidenceRunId =
|
|
83
|
+
const evidenceRunId = record.run_id;
|
|
81
84
|
process.stdout.write(`Running Job Run ${record.run_id} command in place.\n`);
|
|
82
85
|
const commandOutcome = await executeJobCommand(record.task.command, repoRoot);
|
|
83
86
|
const commandPartial = !commandOutcome.error &&
|
|
@@ -149,14 +152,12 @@ async function runCommandJobMode(params) {
|
|
|
149
152
|
}
|
|
150
153
|
else if (commandPartial) {
|
|
151
154
|
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
155
|
}
|
|
156
156
|
else {
|
|
157
157
|
process.stdout.write(`Job Run failed: ${record.run_id}\n`);
|
|
158
158
|
process.exitCode = commandOutcome.exitCode || 1;
|
|
159
159
|
}
|
|
160
|
+
process.stdout.write(`[routine-job] complete run_id=${record.run_id} state=${commandSucceeded ? "succeeded" : commandPartial ? "partial" : "failed"}\n`);
|
|
160
161
|
return;
|
|
161
162
|
}
|
|
162
163
|
const stateLocation = pipelineStateLocation({
|
|
@@ -191,7 +192,7 @@ async function runCommandJobMode(params) {
|
|
|
191
192
|
schedulePath,
|
|
192
193
|
executionPath,
|
|
193
194
|
reporterCandidates: [analysisCandidate],
|
|
194
|
-
planPrompt: expandPromptRefs(
|
|
195
|
+
planPrompt: expandPromptRefs(readPlanFile(planPath)),
|
|
195
196
|
resultPath,
|
|
196
197
|
execDefaults,
|
|
197
198
|
evidence: recorded.evidence,
|
|
@@ -211,14 +212,12 @@ async function runCommandJobMode(params) {
|
|
|
211
212
|
});
|
|
212
213
|
if (reporterOutcome.exitCode === 0) {
|
|
213
214
|
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
215
|
}
|
|
218
216
|
else {
|
|
219
217
|
process.stdout.write(`Job Run failed: ${record.run_id}\n`);
|
|
220
218
|
process.exitCode = 1;
|
|
221
219
|
}
|
|
220
|
+
process.stdout.write(`[routine-job] complete run_id=${record.run_id} state=${reporterOutcome.exitCode === 0 ? (commandPartial ? "partial" : "succeeded") : "failed"}\n`);
|
|
222
221
|
}
|
|
223
222
|
const ACCEPTED_JOB_REVIEW_VERDICTS = new Set(["complete", "complete-with-findings"]);
|
|
224
223
|
function acceptsJobReview(record, verdict) {
|
|
@@ -383,6 +382,8 @@ async function runJobWorktreeMode(opts) {
|
|
|
383
382
|
});
|
|
384
383
|
if (preview.duplicateComplete) {
|
|
385
384
|
process.stdout.write(`Job Run already complete: ${preview.record.run_id} (${preview.record.state})\n`);
|
|
385
|
+
if (preview.record.state === "noop")
|
|
386
|
+
process.stdout.write(`[routine-job] noop state=noop\n`);
|
|
386
387
|
if (trigger === "routine" && preview.record.state === "partial") {
|
|
387
388
|
process.stdout.write(`[routine-job] complete run_id=${preview.record.run_id} state=partial\n`);
|
|
388
389
|
}
|
|
@@ -420,7 +421,7 @@ async function runJobWorktreeMode(opts) {
|
|
|
420
421
|
const child = spawnSync(executable, fullArgs, {
|
|
421
422
|
cwd: worktree.path,
|
|
422
423
|
env: {
|
|
423
|
-
...
|
|
424
|
+
...gitEnvironment(),
|
|
424
425
|
[ROUTINE_EXEC_ENV]: trigger === "routine" ? "1" : "0",
|
|
425
426
|
[JOB_REVIEW_WORKTREE_CHILD_ENV]: "1",
|
|
426
427
|
},
|
|
@@ -441,10 +442,23 @@ async function runJobWorktreeMode(opts) {
|
|
|
441
442
|
const worktreeExecutionPath = resolve(worktree.path, executionRel);
|
|
442
443
|
const worktreeJobPaths = resolveJobPaths(projectId);
|
|
443
444
|
const runPath = resolve(worktree.path, relative(repoRoot, preview.runPath));
|
|
445
|
+
if (child.status === 0 && existsSync(localJobNoopPath(executionPath, preview.record.run_id))) {
|
|
446
|
+
removeWorktree({
|
|
447
|
+
context: { repoRoot, schedulePath, executionPath },
|
|
448
|
+
worktree,
|
|
449
|
+
taskId: `${preview.record.run_id}-review`,
|
|
450
|
+
deleteBranch: true,
|
|
451
|
+
});
|
|
452
|
+
process.stdout.write(`[routine-job] noop state=noop\n`);
|
|
453
|
+
return;
|
|
454
|
+
}
|
|
444
455
|
if (!existsSync(runPath)) {
|
|
445
456
|
throw new Error(`Job Run record was not created in worktree: ${preview.record.run_id}`);
|
|
446
457
|
}
|
|
447
458
|
let record = loadJobRunRecord(runPath);
|
|
459
|
+
// The child may fail before printing a completion marker. Its worktree still owns
|
|
460
|
+
// the diagnostic Run record even if commit or review subsequently fails.
|
|
461
|
+
process.stdout.write(`[routine-job] recorded run_id=${record.run_id} state=${record.state}\n`);
|
|
448
462
|
const outputPaths = worktreeStatusPaths(worktree.path);
|
|
449
463
|
const outputCommit = commitJobPaths(worktree.path, outputPaths, `chore(routine): ${preview.definition.name}`, `Job Run: ${record.run_id}\nState: ${record.state}`);
|
|
450
464
|
const reviewTaskId = `${record.run_id}-review`;
|
|
@@ -491,7 +505,7 @@ async function runJobWorktreeMode(opts) {
|
|
|
491
505
|
executor: agents.executor,
|
|
492
506
|
reporterCandidates: agents.reporterCandidates,
|
|
493
507
|
planPath,
|
|
494
|
-
planPrompt: expandPromptRefs(
|
|
508
|
+
planPrompt: expandPromptRefs(readPlanFile(planPath)),
|
|
495
509
|
resultPath,
|
|
496
510
|
execDefaults,
|
|
497
511
|
mode: "review",
|
|
@@ -527,7 +541,7 @@ async function runJobWorktreeMode(opts) {
|
|
|
527
541
|
process.chdir(originalCwd);
|
|
528
542
|
}
|
|
529
543
|
const allowedReviewPrefixes = [
|
|
530
|
-
|
|
544
|
+
...taskRecordPrefixes(relative(worktree.path, worktreeExecutionPath), reviewTaskId),
|
|
531
545
|
];
|
|
532
546
|
const allowedReviewFiles = new Set([
|
|
533
547
|
relative(worktree.path, planPath).split(sep).join("/"),
|
|
@@ -584,10 +598,9 @@ async function runJobWorktreeMode(opts) {
|
|
|
584
598
|
});
|
|
585
599
|
process.stdout.write(`[routine-job] merged run_id=${record.run_id} state=${record.state} review=${verdict} branch=${worktree.branch}\n`);
|
|
586
600
|
}
|
|
587
|
-
|
|
601
|
+
async function runJobModeUnchecked(opts, resolvePipelineAgents, isWorktreeChild) {
|
|
588
602
|
const resolvedPaths = resolveProjectPaths({ project: opts.project });
|
|
589
603
|
activateResolvedProjectPaths(resolvedPaths);
|
|
590
|
-
const isWorktreeChild = process.env[JOB_REVIEW_WORKTREE_CHILD_ENV] === "1";
|
|
591
604
|
if (!isWorktreeChild) {
|
|
592
605
|
// A Job's task.review declaration takes precedence over the caller: it routes the Run
|
|
593
606
|
// through the reviewed integration path even without --worktree (routine action.commit).
|
|
@@ -624,6 +637,8 @@ export async function runJobMode(opts, resolvePipelineAgents) {
|
|
|
624
637
|
}
|
|
625
638
|
if (materialized.duplicateComplete) {
|
|
626
639
|
process.stdout.write(`Job Run already complete: ${record.run_id} (${record.state})\n`);
|
|
640
|
+
if (record.state === "noop")
|
|
641
|
+
process.stdout.write(`[routine-job] noop state=noop\n`);
|
|
627
642
|
if (trigger === "routine" && record.state === "partial") {
|
|
628
643
|
process.stdout.write(`[routine-job] complete run_id=${record.run_id} state=partial\n`);
|
|
629
644
|
}
|
|
@@ -696,7 +711,7 @@ export async function runJobMode(opts, resolvePipelineAgents) {
|
|
|
696
711
|
...(record.task.targets ? { targets: record.task.targets } : {}),
|
|
697
712
|
});
|
|
698
713
|
const resultScaffold = readResultFrontmatterSnapshot(resultPath);
|
|
699
|
-
const prompt = expandPromptRefs(
|
|
714
|
+
const prompt = expandPromptRefs(readPlanFile(planPath));
|
|
700
715
|
const repoRoot = specdojoRootDir();
|
|
701
716
|
let exitCode;
|
|
702
717
|
let reason;
|
|
@@ -743,4 +758,46 @@ export async function runJobMode(opts, resolvePipelineAgents) {
|
|
|
743
758
|
process.stdout.write(`Job Run failed: ${record.run_id}\n`);
|
|
744
759
|
process.exitCode = effectiveExit || 1;
|
|
745
760
|
}
|
|
761
|
+
process.stdout.write(`[routine-job] complete run_id=${record.run_id} state=${effectiveExit === 0 ? "succeeded" : "failed"}\n`);
|
|
762
|
+
}
|
|
763
|
+
export async function runJobMode(opts, resolvePipelineAgents) {
|
|
764
|
+
const isWorktreeChild = process.env[JOB_REVIEW_WORKTREE_CHILD_ENV] === "1";
|
|
765
|
+
// This marker routes only this Job's re-entry. Preconditions, commands, agents and
|
|
766
|
+
// their tests must choose their own worktree/review mode rather than inherit it.
|
|
767
|
+
delete process.env[JOB_REVIEW_WORKTREE_CHILD_ENV];
|
|
768
|
+
const paths = resolveProjectPaths({ project: opts.project });
|
|
769
|
+
activateResolvedProjectPaths(paths);
|
|
770
|
+
const projectId = paths.projectId ?? opts.project;
|
|
771
|
+
const definition = loadJobDefinition(resolveJobPaths(projectId), String(opts.job).trim());
|
|
772
|
+
if (opts.dryRun ||
|
|
773
|
+
jobRunUsesReviewedIntegration(definition, {
|
|
774
|
+
worktree: opts.worktree,
|
|
775
|
+
isWorktreeChild,
|
|
776
|
+
}) ||
|
|
777
|
+
// In-place command Jobs also support projects without a Git repository. There is
|
|
778
|
+
// nothing to commit there, and no reliable Git diff for suppressing Run records.
|
|
779
|
+
gitResult(specdojoRootDir(), ["rev-parse", "--is-inside-work-tree"]).status !== 0) {
|
|
780
|
+
await runJobModeUnchecked(opts, resolvePipelineAgents, isWorktreeChild);
|
|
781
|
+
return;
|
|
782
|
+
}
|
|
783
|
+
const preview = await materializeJobRun({
|
|
784
|
+
projectId,
|
|
785
|
+
jobId: String(opts.job).trim(),
|
|
786
|
+
inputs: opts.input,
|
|
787
|
+
scheduledAt: opts.scheduledAt,
|
|
788
|
+
dryRun: true,
|
|
789
|
+
});
|
|
790
|
+
if (preview.duplicateComplete) {
|
|
791
|
+
await runJobModeUnchecked(opts, resolvePipelineAgents, isWorktreeChild);
|
|
792
|
+
return;
|
|
793
|
+
}
|
|
794
|
+
const snapshot = snapshotJobOutput(specdojoRootDir(), paths.executionPath, preview.record);
|
|
795
|
+
await runJobModeUnchecked({ ...opts, scheduledAt: preview.record.scheduled_at }, resolvePipelineAgents, isWorktreeChild);
|
|
796
|
+
if (!existsSync(preview.runPath))
|
|
797
|
+
return;
|
|
798
|
+
const record = loadJobRunRecord(preview.runPath);
|
|
799
|
+
if (record.state === "succeeded" && !snapshot.hasChanges()) {
|
|
800
|
+
snapshot.discard(completeJobRun({ projectId, runPath: preview.runPath, status: "noop" }));
|
|
801
|
+
process.stdout.write(`[routine-job] noop state=noop\n`);
|
|
802
|
+
}
|
|
746
803
|
}
|