specdojo 0.6.0 → 0.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.github/agents/specdojo-orchestrator.md +3 -2
- package/CHANGELOG.md +193 -0
- package/README.md +2 -2
- package/dist/catalog/build.js +24 -1
- package/dist/catalog/plan.js +1 -1
- package/dist/catalog/scaffold.js +4 -1
- package/dist/commands/agent.js +33 -0
- package/dist/commands/init.js +6 -1
- package/dist/commands/night-orchestrator.js +6 -4
- package/dist/commands/orchestrator.js +10 -1
- package/dist/dashboard/dashboard-timeline.js +18 -16
- package/dist/dashboard/dashboard.js +612 -259
- package/dist/dashboard/epic-plan.js +81 -0
- package/dist/dashboard/exec-records.js +16 -20
- package/dist/dashboard/routines.js +8 -6
- package/dist/dashboard/timeline-build.js +5 -9
- package/dist/dashboard/timeline.js +9 -4
- package/dist/devcontainer/command.js +18 -0
- package/dist/devcontainer/host-script.js +21 -0
- package/dist/devcontainer/scaffold.js +22 -3
- package/dist/docs/frontmatter-namespace.js +1 -48
- package/dist/docs/yaml-pages.js +125 -3
- package/dist/exec/agent-config.js +22 -0
- package/dist/exec/agent-plan.js +3 -2
- package/dist/exec/antigravity-session.js +154 -0
- package/dist/exec/commands.js +69 -21
- package/dist/exec/commit-hook-skips.js +78 -0
- package/dist/exec/core.js +19 -7
- package/dist/exec/events.js +159 -8
- package/dist/exec/evidence.js +64 -16
- package/dist/exec/handoff.js +9 -13
- package/dist/exec/limit.js +1 -1
- package/dist/exec/mechanical-result.js +45 -0
- package/dist/exec/migrate-records.js +249 -0
- package/dist/exec/parent-validation.js +160 -12
- package/dist/exec/pipeline-state.js +27 -5
- package/dist/exec/plan-markdownlint.js +89 -0
- package/dist/exec/plans-condense-findings.js +89 -0
- package/dist/exec/plans-core.js +24 -17
- package/dist/exec/plans-generation.js +52 -25
- package/dist/exec/plans-grade-findings.js +8 -3
- package/dist/exec/plans-kata-findings.js +61 -0
- package/dist/exec/plans-planning.js +3 -3
- package/dist/exec/plans-storage.js +12 -24
- package/dist/exec/register-resume.js +69 -42
- package/dist/exec/register.js +26 -22
- package/dist/exec/repo-integration-sync.js +8 -4
- package/dist/exec/repo-integration.js +21 -1
- package/dist/exec/reporter.js +121 -23
- package/dist/exec/results.js +85 -24
- package/dist/exec/review-completion.js +47 -0
- package/dist/exec/review-kata.js +109 -0
- package/dist/exec/run/agent-pipeline.js +75 -6
- package/dist/exec/run/agent.js +20 -7
- package/dist/exec/run/in-place.js +69 -32
- package/dist/exec/run/job.js +81 -24
- package/dist/exec/run/lifecycle-commands.js +264 -43
- package/dist/exec/run/mode-shared.js +11 -3
- package/dist/exec/run/register-command.js +12 -10
- package/dist/exec/run/register-core.js +20 -13
- package/dist/exec/run/register-mode.js +12 -12
- package/dist/exec/run/register-post-review.js +21 -9
- package/dist/exec/run/register-resume.js +28 -18
- package/dist/exec/run/register-state.js +10 -7
- package/dist/exec/run/register-worktree.js +60 -30
- package/dist/exec/run/schedule-mode.js +26 -6
- package/dist/exec/run/schedule-prepare.js +228 -45
- package/dist/exec/run/schedule-task.js +132 -25
- package/dist/exec/run/shared.js +4 -3
- package/dist/exec/run/trailing-records.js +35 -0
- package/dist/exec/run-records.js +2 -0
- package/dist/exec/strategy.js +1 -0
- package/dist/exec/trailing-records.js +242 -0
- package/dist/exec/trial-commands.js +3 -2
- package/dist/exec/validate-records-commit.js +110 -0
- package/dist/exec/validate-records.js +148 -0
- package/dist/exec/worktree-command.js +29 -16
- package/dist/exec/worktree-ops-commit.js +118 -59
- package/dist/exec/worktree-ops-lifecycle.js +77 -44
- package/dist/exec/worktree-ops-merge.js +13 -2
- package/dist/exec/worktree-ops.js +2 -2
- package/dist/exec/worktree.js +19 -2
- package/dist/grade/apply.js +32 -6
- package/dist/grade/command-inspect.js +2 -2
- package/dist/grade/command-run.js +2 -0
- package/dist/grade/command-shared.js +1 -1
- package/dist/grade/core.js +18 -5
- package/dist/grade/markdown.js +3 -3
- package/dist/grade/pipeline-state.js +15 -11
- package/dist/grade/plan.js +37 -17
- package/dist/grade/result.js +3 -3
- package/dist/grade/run.js +23 -3
- package/dist/grade/target-discovery.js +17 -4
- package/dist/grade/targets.js +12 -11
- package/dist/job/job.js +31 -17
- package/dist/job/noop.js +104 -0
- package/dist/register/core.js +2 -0
- package/dist/register/create-commands.js +28 -3
- package/dist/register/deliverable-target.js +9 -1
- package/dist/register/epic.js +104 -26
- package/dist/register/event-merge.js +3 -0
- package/dist/register/events.js +4 -0
- package/dist/register/external-project.js +3 -0
- package/dist/register/item.js +6 -0
- package/dist/register/maintenance-commands.js +4 -1
- package/dist/register/planning.js +7 -14
- package/dist/register/register.js +74 -32
- package/dist/register/track-domains.js +34 -0
- package/dist/register/track-plan.js +78 -0
- package/dist/register/transition-commands.js +8 -0
- package/dist/register/work-table.js +64 -0
- package/dist/review/grade.js +35 -13
- package/dist/routine/definition.js +4 -3
- package/dist/routine/failure.js +30 -0
- package/dist/routine/routine.js +56 -32
- package/dist/routine/storage.js +33 -0
- package/dist/schedule/schedule.js +1 -0
- package/dist/schedule/strategy-generate-document.js +26 -14
- package/dist/schedule/strategy-generate-scope.js +17 -45
- package/dist/schedule/strategy-generate.js +33 -3
- package/dist/schedule/strategy-profiles.js +86 -12
- package/dist/shared/agent-types.js +2 -0
- package/dist/shared/condense-records.js +25 -0
- package/dist/shared/deprecation.js +8 -0
- package/dist/shared/document-metadata.js +20 -0
- package/dist/shared/finding-cause.js +20 -0
- package/dist/shared/frontmatter-namespace.js +48 -0
- package/dist/shared/git.js +149 -15
- package/dist/shared/grade-result.js +17 -1
- package/dist/shared/local-state.js +20 -0
- package/dist/shared/markdownlint-config.js +8 -3
- package/dist/shared/plan-conventions.js +129 -0
- package/dist/shared/plan-templates.js +57 -41
- package/dist/shared/provider-scaffold.js +2 -0
- package/dist/shared/run-records.js +224 -0
- package/dist/shared/specdojo-config.js +39 -21
- package/dist/shared/specdojo-gitignore.js +1 -0
- package/dist/shared/text.js +65 -5
- package/dist/shared/timeline-index.js +2 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
- package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
- package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
- package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
- package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
- package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
- package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
- package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
- package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
- package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
- package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
- package/docs/ja/specdojo/guides/docs-editing-guide.md +48 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
- package/docs/ja/specdojo/guides/exec-config-guide.md +61 -28
- package/docs/ja/specdojo/guides/exec-operation-guide.md +61 -13
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +4 -2
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
- package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +589 -807
- package/docs/ja/specdojo/guides/register-operation-guide.md +26 -4
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +33 -4
- package/docs/ja/specdojo/guides/review-guide.md +22 -19
- package/docs/ja/specdojo/guides/routine-operation-guide.md +14 -8
- package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
- package/docs/ja/specdojo/guides/schedule-design-guide.md +7 -4
- package/docs/ja/specdojo/guides/schedule-operation-guide.md +41 -3
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
- package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
- package/docs/ja/specdojo/guides/use-case-guide.md +471 -74
- package/docs/ja/specdojo/recipes/bac-recipe.md +94 -0
- package/docs/ja/specdojo/recipes/bes-recipe.md +105 -0
- package/docs/ja/specdojo/recipes/br-recipe.md +84 -0
- package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +88 -86
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +108 -122
- package/docs/ja/specdojo/recipes/cnd-recipe.md +125 -0
- package/docs/ja/specdojo/recipes/cpd-recipe.md +126 -0
- package/docs/ja/specdojo/recipes/cxd-recipe.md +145 -0
- package/docs/ja/specdojo/recipes/ifd-recipe.md +134 -0
- package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +135 -86
- package/docs/ja/specdojo/recipes/ifx-index-recipe.md +130 -0
- package/docs/ja/specdojo/recipes/pm-organization-recipe.md +29 -26
- package/docs/ja/specdojo/recipes/pm-plan-recipe.md +35 -26
- package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +38 -28
- package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -31
- package/docs/ja/specdojo/recipes/pm-roles-recipe.md +26 -28
- package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +10 -8
- package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +18 -17
- package/docs/ja/specdojo/recipes/stsd-recipe.md +100 -62
- package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +106 -0
- package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +137 -0
- package/docs/ja/specdojo/recipes/sysd-index-recipe.md +122 -0
- package/docs/ja/specdojo/references/command-reference.md +146 -99
- package/docs/ja/specdojo/references/deliverables-reference.md +9 -4
- package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
- package/docs/ja/specdojo/references/specdojo-config-reference.md +17 -16
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +72 -290
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +212 -79
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +138 -154
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +147 -59
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +100 -96
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +88 -108
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +126 -211
- package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +367 -0
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +6 -5
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +96 -100
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +38 -47
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +132 -106
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +102 -68
- package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +152 -0
- package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
- package/docs/ja/specdojo/rulebooks/clis-rulebook.md +187 -0
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +93 -247
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +104 -241
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +124 -257
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +87 -98
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +9 -7
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/dss-rulebook.md +193 -0
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +100 -54
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +69 -252
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +91 -76
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +252 -226
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +118 -40
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +11 -11
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +9 -9
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +4 -4
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +11 -11
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +11 -11
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +34 -29
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +8 -8
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +2 -2
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +50 -56
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +46 -55
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +57 -54
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +50 -65
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +2 -2
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +70 -97
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +47 -56
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -135
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +116 -32
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +118 -61
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +152 -57
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +51 -39
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +101 -46
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +72 -329
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +74 -263
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +78 -195
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +3 -4
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +3 -3
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +140 -143
- package/docs/ja/specdojo/samples/bac-sample.md +106 -21
- package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
- package/docs/ja/specdojo/samples/bds-sample.md +100 -21
- package/docs/ja/specdojo/samples/bes-index-sample.md +59 -20
- package/docs/ja/specdojo/samples/bes-sample.md +80 -21
- package/docs/ja/specdojo/samples/br-sample.md +68 -14
- package/docs/ja/specdojo/samples/ccd-sample.md +81 -19
- package/docs/ja/specdojo/samples/cdfd-overview-sample.md +248 -140
- package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +130 -97
- package/docs/ja/specdojo/samples/cdsd-sample.md +89 -20
- package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
- package/docs/ja/specdojo/samples/cld-sample.md +3 -30
- package/docs/ja/specdojo/samples/clis-sample.md +132 -0
- package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
- package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
- package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
- package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
- package/docs/ja/specdojo/samples/dss-sample.md +175 -0
- package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
- package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
- package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
- package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
- package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
- package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
- package/docs/ja/specdojo/samples/pm-organization-sample.md +52 -20
- package/docs/ja/specdojo/samples/pm-plan-sample.md +84 -26
- package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +55 -22
- package/docs/ja/specdojo/samples/pm-raci-sample.md +69 -28
- package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
- package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +50 -26
- package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +89 -62
- package/docs/ja/specdojo/samples/sf-index-sample.md +89 -20
- package/docs/ja/specdojo/samples/sf-sample.md +121 -21
- package/docs/ja/specdojo/samples/sld-sample.md +107 -21
- package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
- package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
- package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
- package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
- package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
- package/docs/ja/specdojo/samples/uis-sample.md +164 -20
- package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
- package/docs/ja/specdojo/templates/bac-template.md +76 -0
- package/docs/ja/specdojo/templates/bes-template.md +56 -0
- package/docs/ja/specdojo/templates/br-template.md +64 -0
- package/docs/ja/specdojo/templates/cdfd-overview-template.md +161 -83
- package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
- package/docs/ja/specdojo/templates/cdfd-uc-template.md +130 -89
- package/docs/ja/specdojo/templates/cnd-template.md +137 -0
- package/docs/ja/specdojo/templates/cpd-template.md +129 -0
- package/docs/ja/specdojo/templates/cxd-template.md +105 -0
- package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
- package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
- package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
- package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
- package/docs/ja/specdojo/templates/ifd-template.md +86 -0
- package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
- package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
- package/docs/ja/specdojo/templates/opr-template.md +2 -4
- package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
- package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
- package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
- package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
- package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
- package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
- package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
- package/docs/ja/specdojo/templates/stsd-template.md +46 -21
- package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
- package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
- package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
- package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
- package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
- package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
- package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
- package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +54 -3
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
- package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
- package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
- package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
- package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +1 -0
- package/package.json +6 -3
- package/templates/antigravity/README.md +19 -46
- package/templates/antigravity/exec-defaults-snippet.yaml +5 -6
- package/templates/antigravity/orchestrator.md +3 -2
- package/templates/antigravity/settings.edit.json +73 -0
- package/templates/antigravity/settings.orchestrator.json +15 -0
- package/templates/antigravity/settings.report.json +7 -0
- package/templates/antigravity/settings.review.json +7 -0
- package/templates/claude/agents/specdojo-orchestrator.md +3 -2
- package/templates/codex/agents/specdojo-orchestrator.toml +3 -2
- package/templates/codex/orchestrator.md +3 -2
- package/templates/devcontainer/remote-host/devcontainer-tmux.sh +217 -0
- package/templates/devcontainer/remote-host/specdojo-tmux.sh.sample +8 -96
- package/templates/devcontainer/remote-host/ssh-config.sample +3 -1
- package/templates/devcontainer/tmux.conf +6 -0
- package/templates/init-agent-members.yaml +1 -0
- package/templates/init-exec-defaults.yaml +1 -1
- package/templates/opencode/agents/specdojo-orchestrator.md +3 -2
|
@@ -0,0 +1,249 @@
|
|
|
1
|
+
import { spawnSync } from "node:child_process";
|
|
2
|
+
import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
|
|
3
|
+
import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
|
|
4
|
+
import { readSpecdojoNamespace } from "../shared/frontmatter-namespace.js";
|
|
5
|
+
import { listFilesRecursive } from "../shared/fs.js";
|
|
6
|
+
import { gitEnvironment } from "../shared/git.js";
|
|
7
|
+
import { rebasePlanConventions } from "../shared/plan-conventions.js";
|
|
8
|
+
import { recordIdentity, taskRecordPaths } from "../shared/run-records.js";
|
|
9
|
+
import { specdojoRootDir } from "../shared/specdojo-config.js";
|
|
10
|
+
import { addProjectOptions, resolveProjectContext, resolveProjectId } from "./core.js";
|
|
11
|
+
import { qualifyTaskId } from "./shared.js";
|
|
12
|
+
import { listRegisteredWorktrees, worktreeNameFromTaskId } from "./worktree.js";
|
|
13
|
+
const posix = (path) => path.split(sep).join("/");
|
|
14
|
+
const json = (path) => JSON.parse(readFileSync(path, "utf8"));
|
|
15
|
+
/** Retain formatting and every non-reference value, including historical change paths. */
|
|
16
|
+
function rewriteJsonPaths(source, rewrite) {
|
|
17
|
+
JSON.parse(source);
|
|
18
|
+
const stack = [];
|
|
19
|
+
return source.replace(/"(?:[^"\\]|\\.)*"|[{}[\]]/g, (token, offset) => {
|
|
20
|
+
const parent = stack.at(-1);
|
|
21
|
+
if (token === "{" || token === "[") {
|
|
22
|
+
stack.push({ field: parent?.key ?? "", key: "" });
|
|
23
|
+
}
|
|
24
|
+
else if (token === "}" || token === "]") {
|
|
25
|
+
stack.pop();
|
|
26
|
+
}
|
|
27
|
+
else if (/^\s*:/.test(source.slice(offset + token.length))) {
|
|
28
|
+
if (parent)
|
|
29
|
+
parent.key = JSON.parse(token);
|
|
30
|
+
}
|
|
31
|
+
else if (parent &&
|
|
32
|
+
(/(?:_ref|_path)$/.test(parent.key) ||
|
|
33
|
+
(parent.key === "path" && stack.some((frame) => frame.field === "log_refs")))) {
|
|
34
|
+
return JSON.stringify(rewrite(JSON.parse(token)));
|
|
35
|
+
}
|
|
36
|
+
return token;
|
|
37
|
+
});
|
|
38
|
+
}
|
|
39
|
+
/** Plan first, validate every destination, then mutate. No clock or random identity is used. */
|
|
40
|
+
export function planRecordMigration(repoRoot, executionPath, projectId) {
|
|
41
|
+
const root = resolve(repoRoot);
|
|
42
|
+
const execution = resolve(executionPath);
|
|
43
|
+
const repoRef = (path) => posix(relative(root, path));
|
|
44
|
+
const pairs = new Map();
|
|
45
|
+
for (const kind of ["plan", "result"]) {
|
|
46
|
+
for (const path of listFilesRecursive(join(execution, "exec", `${kind}s`)).sort()) {
|
|
47
|
+
if (!path.endsWith(`-${kind}.md`))
|
|
48
|
+
throw new Error(`Unknown legacy record: ${path}`);
|
|
49
|
+
const stem = basename(path).replace(new RegExp(`-${kind}\\.md$`), "");
|
|
50
|
+
const fm = readSpecdojoNamespace(readFileSync(path, "utf8"));
|
|
51
|
+
if (typeof fm.task_id !== "string" || !fm.task_id.trim())
|
|
52
|
+
throw new Error(`Missing task_id: ${path}`);
|
|
53
|
+
const pair = pairs.get(stem) ?? { stem, task: fm.task_id };
|
|
54
|
+
if (pair[kind] || pair.task !== fm.task_id)
|
|
55
|
+
throw new Error(`Ambiguous pair: ${stem}`);
|
|
56
|
+
pair[kind] = path;
|
|
57
|
+
pairs.set(stem, pair);
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
const evidenceRoot = join(execution, "exec", "evidence");
|
|
61
|
+
const directories = new Map();
|
|
62
|
+
for (const path of listFilesRecursive(evidenceRoot).sort()) {
|
|
63
|
+
const directory = dirname(path);
|
|
64
|
+
directories.set(directory, [...(directories.get(directory) ?? []), path]);
|
|
65
|
+
}
|
|
66
|
+
const groups = [];
|
|
67
|
+
for (const [directory, files] of directories) {
|
|
68
|
+
const parts = relative(evidenceRoot, directory).split(sep);
|
|
69
|
+
if (parts.length !== 2)
|
|
70
|
+
throw new Error(`Unknown evidence directory: ${directory}`);
|
|
71
|
+
const metadata = ["pipeline-state.json", "evidence.json"]
|
|
72
|
+
.map((name) => join(directory, name))
|
|
73
|
+
.filter(existsSync)
|
|
74
|
+
.map(json);
|
|
75
|
+
const state = metadata.find((record) => record.artifacts);
|
|
76
|
+
const artifacts = state?.artifacts;
|
|
77
|
+
const task = metadata[0]?.task_id ?? parts[0];
|
|
78
|
+
const run = metadata[0]?.run_id ?? parts[1];
|
|
79
|
+
if (typeof task !== "string" || typeof run !== "string")
|
|
80
|
+
throw new Error(`Invalid evidence identity: ${directory}`);
|
|
81
|
+
if (metadata.some((record) => record.task_id !== task || record.run_id !== run))
|
|
82
|
+
throw new Error(`Conflicting evidence identities: ${directory}`);
|
|
83
|
+
groups.push({
|
|
84
|
+
task,
|
|
85
|
+
run,
|
|
86
|
+
files,
|
|
87
|
+
refs: Object.values(artifacts ?? {}).filter((value) => typeof value === "string"),
|
|
88
|
+
updated: String(metadata[0]?.updated_at ?? run),
|
|
89
|
+
});
|
|
90
|
+
}
|
|
91
|
+
// A retained exec worktree may still resume with the old paths and its own index.
|
|
92
|
+
// Refuse even dry-runs before planning updates; stopped processes alone are insufficient.
|
|
93
|
+
const tasks = new Set([...pairs.values(), ...groups].map(({ task }) => task));
|
|
94
|
+
if (tasks.size) {
|
|
95
|
+
for (const worktree of listRegisteredWorktrees(root)) {
|
|
96
|
+
if (!worktree.branch?.startsWith("exec/") || !existsSync(worktree.path))
|
|
97
|
+
continue;
|
|
98
|
+
for (const task of tasks) {
|
|
99
|
+
const names = [task, recordIdentity(task).itemId].map(worktreeNameFromTaskId);
|
|
100
|
+
const branchTask = worktree.branch.slice("exec/".length);
|
|
101
|
+
const matches = names.some((name) => branchTask === name ||
|
|
102
|
+
(projectId
|
|
103
|
+
? branchTask === worktreeNameFromTaskId(qualifyTaskId(projectId, name))
|
|
104
|
+
: branchTask.endsWith(`-${name}`)));
|
|
105
|
+
if (matches)
|
|
106
|
+
throw new Error(`Migration target ${task} has a retained exec worktree: ${worktree.path} ` +
|
|
107
|
+
`(${worktree.branch}). Finish or discard the run and remove its worktree before migrating`);
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
const virtualRefs = [];
|
|
112
|
+
const moves = [];
|
|
113
|
+
const add = (from, to) => moves.push({ from: repoRef(from), to: repoRef(to) });
|
|
114
|
+
for (const group of groups) {
|
|
115
|
+
const records = taskRecordPaths(execution, group.task, group.run);
|
|
116
|
+
for (const path of group.files)
|
|
117
|
+
add(path, records.log(basename(path)));
|
|
118
|
+
virtualRefs.push({ from: repoRef(dirname(group.files[0])), to: repoRef(records.directory) });
|
|
119
|
+
}
|
|
120
|
+
const missing = [];
|
|
121
|
+
for (const pair of pairs.values()) {
|
|
122
|
+
if (!pair.plan || !pair.result)
|
|
123
|
+
missing.push({ stem: pair.stem, missing: pair.plan ? "result" : "plan" });
|
|
124
|
+
// Exact checkpoint refs are authoritative. For pre-checkpoint records, associate only
|
|
125
|
+
// an unambiguous task/pair; otherwise retain separate runs instead of guessing by time.
|
|
126
|
+
let candidates = groups.filter((group) => group.refs.some((ref) => [pair.plan, pair.result].some((path) => path && (ref === repoRef(path) || ref === posix(relative(execution, path))))));
|
|
127
|
+
if (candidates.length === 0 &&
|
|
128
|
+
[...pairs.values()].filter((p) => p.task === pair.task).length === 1)
|
|
129
|
+
candidates = groups.filter((group) => group.task === pair.task && group.refs.length === 0);
|
|
130
|
+
const latest = candidates
|
|
131
|
+
.sort((a, b) => a.updated.localeCompare(b.updated) || a.run.localeCompare(b.run))
|
|
132
|
+
.at(-1);
|
|
133
|
+
const records = taskRecordPaths(execution, pair.task, latest?.run ?? pair.stem);
|
|
134
|
+
if (pair.plan)
|
|
135
|
+
add(pair.plan, records.plan);
|
|
136
|
+
if (pair.result)
|
|
137
|
+
add(pair.result, records.result);
|
|
138
|
+
for (const kind of ["plan", "result"]) {
|
|
139
|
+
if (!pair[kind])
|
|
140
|
+
virtualRefs.push({
|
|
141
|
+
from: repoRef(join(execution, "exec", `${kind}s`, `${pair.stem}-${kind}.md`)),
|
|
142
|
+
to: repoRef(records[kind]),
|
|
143
|
+
});
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
moves.sort((a, b) => a.from.localeCompare(b.from));
|
|
147
|
+
const destinations = new Set();
|
|
148
|
+
for (const move of moves) {
|
|
149
|
+
if (destinations.has(move.to) || existsSync(join(root, move.to)))
|
|
150
|
+
throw new Error(`Migration destination already exists: ${move.to}`);
|
|
151
|
+
if (isAbsolute(move.to) || move.to.startsWith("../"))
|
|
152
|
+
throw new Error(`Migration destination outside repository: ${move.to}`);
|
|
153
|
+
destinations.add(move.to);
|
|
154
|
+
}
|
|
155
|
+
// References can be repository-relative, execution-relative, or absolute under a previous
|
|
156
|
+
// checkout. Match the execution suffix without changing prose, commands, IDs, or log bodies.
|
|
157
|
+
const refs = new Map();
|
|
158
|
+
for (const move of [...moves, ...virtualRefs]) {
|
|
159
|
+
refs.set(move.from, move.to);
|
|
160
|
+
refs.set(posix(relative(execution, join(root, move.from))), posix(relative(execution, join(root, move.to))));
|
|
161
|
+
}
|
|
162
|
+
const rewrite = (value) => {
|
|
163
|
+
const direct = refs.get(value);
|
|
164
|
+
if (direct)
|
|
165
|
+
return direct;
|
|
166
|
+
for (let slash = value.indexOf("/"); slash >= 0; slash = value.indexOf("/", slash + 1)) {
|
|
167
|
+
const target = refs.get(value.slice(slash + 1));
|
|
168
|
+
if (target)
|
|
169
|
+
return `${value.slice(0, slash + 1)}${target}`;
|
|
170
|
+
}
|
|
171
|
+
return value;
|
|
172
|
+
};
|
|
173
|
+
const updates = [];
|
|
174
|
+
const targets = new Map(moves.map((move) => [move.from, move.to]));
|
|
175
|
+
const structured = [
|
|
176
|
+
...moves.map((move) => join(root, move.from)),
|
|
177
|
+
...listFilesRecursive(join(execution, "jobs", "runs")),
|
|
178
|
+
];
|
|
179
|
+
for (const path of structured) {
|
|
180
|
+
if (!/\.(json|md)$/.test(path))
|
|
181
|
+
continue;
|
|
182
|
+
const original = readFileSync(path, "utf8");
|
|
183
|
+
let content = original;
|
|
184
|
+
if (path.endsWith(".json")) {
|
|
185
|
+
content = rewriteJsonPaths(original, rewrite);
|
|
186
|
+
}
|
|
187
|
+
else if (path.endsWith(".md")) {
|
|
188
|
+
content = original.replace(/^---\r?\n[\s\S]*?\r?\n---/, (fm) => fm.replace(/^(\s*[\w]+(?:_ref|_path):\s*)([^\r\n]+)$/gm, (_line, key, raw) => {
|
|
189
|
+
const quote = raw.startsWith('"') ? '"' : raw.startsWith("'") ? "'" : "";
|
|
190
|
+
const value = quote ? raw.slice(1, -1) : raw;
|
|
191
|
+
return `${key}${quote}${rewrite(value)}${quote}`;
|
|
192
|
+
}));
|
|
193
|
+
if (path.endsWith("-plan.md"))
|
|
194
|
+
content = rebasePlanConventions(content, path, join(root, targets.get(repoRef(path))));
|
|
195
|
+
}
|
|
196
|
+
if (content !== original)
|
|
197
|
+
updates.push({ path: targets.get(repoRef(path)) ?? repoRef(path), content });
|
|
198
|
+
}
|
|
199
|
+
return { moves, updates, missing, skipped: [] };
|
|
200
|
+
}
|
|
201
|
+
export function applyRecordMigration(repoRoot, plan) {
|
|
202
|
+
if (!plan.moves.length && !plan.updates.length)
|
|
203
|
+
return;
|
|
204
|
+
const tracked = spawnSync("git", ["ls-files", "-z"], {
|
|
205
|
+
cwd: repoRoot,
|
|
206
|
+
env: gitEnvironment(),
|
|
207
|
+
encoding: "utf8",
|
|
208
|
+
});
|
|
209
|
+
if (tracked.status !== 0)
|
|
210
|
+
throw new Error(`git ls-files failed: ${tracked.stderr}`);
|
|
211
|
+
const files = new Set(tracked.stdout.split("\0"));
|
|
212
|
+
for (const move of plan.moves) {
|
|
213
|
+
if (!files.has(move.from))
|
|
214
|
+
throw new Error(`Migration source is not tracked: ${move.from}`);
|
|
215
|
+
}
|
|
216
|
+
for (const move of plan.moves) {
|
|
217
|
+
mkdirSync(dirname(join(repoRoot, move.to)), { recursive: true });
|
|
218
|
+
const result = spawnSync("git", ["mv", "--", move.from, move.to], {
|
|
219
|
+
cwd: repoRoot,
|
|
220
|
+
env: gitEnvironment(),
|
|
221
|
+
encoding: "utf8",
|
|
222
|
+
});
|
|
223
|
+
if (result.status !== 0)
|
|
224
|
+
throw new Error(`git mv failed: ${move.from}: ${result.stderr}`);
|
|
225
|
+
}
|
|
226
|
+
for (const update of plan.updates)
|
|
227
|
+
writeFileSync(join(repoRoot, update.path), update.content);
|
|
228
|
+
}
|
|
229
|
+
export function registerRecordMigrationCommand(exec) {
|
|
230
|
+
const command = exec
|
|
231
|
+
.command("migrate-records")
|
|
232
|
+
.description("Move tracked legacy run records with git mv");
|
|
233
|
+
addProjectOptions(command);
|
|
234
|
+
command.option("--dry-run", "List moves and reference updates without writing", false);
|
|
235
|
+
command.action((opts) => {
|
|
236
|
+
try {
|
|
237
|
+
const { executionPath } = resolveProjectContext(opts);
|
|
238
|
+
const root = specdojoRootDir();
|
|
239
|
+
const plan = planRecordMigration(root, executionPath, resolveProjectId(opts));
|
|
240
|
+
process.stdout.write(`${JSON.stringify({ ...plan, updates: plan.updates.map(({ path }) => path) }, null, 2)}\n`);
|
|
241
|
+
if (!opts.dryRun)
|
|
242
|
+
applyRecordMigration(root, plan);
|
|
243
|
+
}
|
|
244
|
+
catch (error) {
|
|
245
|
+
process.stderr.write(`blocked: ${error instanceof Error ? error.message : String(error)}; need=resolve migration precondition; ref=${opts.project ?? "current project"}\n`);
|
|
246
|
+
process.exitCode = 1;
|
|
247
|
+
}
|
|
248
|
+
});
|
|
249
|
+
}
|
|
@@ -2,7 +2,7 @@ import { spawn } from "node:child_process";
|
|
|
2
2
|
import { join } from "node:path";
|
|
3
3
|
import { gitEnvironment } from "./worktree.js";
|
|
4
4
|
import { acquirePoolSlot, getActiveExecLocksDir, releaseLock } from "./slot-lock.js";
|
|
5
|
-
import { redactSensitiveText } from "./evidence.js";
|
|
5
|
+
import { MAX_CHANGE_FILES, redactSensitiveText } from "./evidence.js";
|
|
6
6
|
import { PROJECT_REPO_WORKTREE_DIRNAME, REPO_NAME_PATTERN } from "../shared/specdojo-config.js";
|
|
7
7
|
export const MAX_PARENT_VALIDATION_STREAM_BYTES = 1024 * 1024;
|
|
8
8
|
const MAX_SUMMARY_LENGTH = 1_000;
|
|
@@ -64,6 +64,13 @@ const PARENT_VALIDATION_REGISTRY = {
|
|
|
64
64
|
displayCommand: "npm run lint:mermaid",
|
|
65
65
|
timeoutMs: 10 * 60 * 1_000,
|
|
66
66
|
},
|
|
67
|
+
"lint-d2": {
|
|
68
|
+
id: "lint-d2",
|
|
69
|
+
command: process.platform === "win32" ? "npm.cmd" : "npm",
|
|
70
|
+
args: ["run", "lint:d2"],
|
|
71
|
+
displayCommand: "npm run lint:d2",
|
|
72
|
+
timeoutMs: 10 * 60 * 1_000,
|
|
73
|
+
},
|
|
67
74
|
build: {
|
|
68
75
|
id: "build",
|
|
69
76
|
command: process.platform === "win32" ? "npm.cmd" : "npm",
|
|
@@ -157,15 +164,25 @@ function isRecord(value) {
|
|
|
157
164
|
function assignmentLabel(id, repo) {
|
|
158
165
|
return repo === PARENT_VALIDATION_PROJECT_REPO ? id : `${repo}:${id}`;
|
|
159
166
|
}
|
|
167
|
+
function parsePaths(value, where) {
|
|
168
|
+
if (value === undefined)
|
|
169
|
+
return undefined;
|
|
170
|
+
if (!Array.isArray(value) ||
|
|
171
|
+
value.length === 0 ||
|
|
172
|
+
!value.every((pattern) => typeof pattern === "string" && pattern.trim().length > 0)) {
|
|
173
|
+
throw new Error(`${where}.paths must be a non-empty array of non-empty glob strings`);
|
|
174
|
+
}
|
|
175
|
+
return value.map((pattern) => pattern.trim());
|
|
176
|
+
}
|
|
160
177
|
function parseEntry(entry, index) {
|
|
161
178
|
const where = `pipeline.parent_validations[${index}] in exec-defaults`;
|
|
162
179
|
if (typeof entry === "string")
|
|
163
180
|
return { id: entry, repo: PARENT_VALIDATION_PROJECT_REPO };
|
|
164
181
|
if (!isRecord(entry)) {
|
|
165
|
-
throw new Error(`${where} must be a validation id or { id, repo }: ${JSON.stringify(entry)}`);
|
|
182
|
+
throw new Error(`${where} must be a validation id or { id, repo?, paths? }: ${JSON.stringify(entry)}`);
|
|
166
183
|
}
|
|
167
184
|
const unknownKeys = Object.keys(entry)
|
|
168
|
-
.filter((key) => key !== "id" && key !== "repo")
|
|
185
|
+
.filter((key) => key !== "id" && key !== "repo" && key !== "paths")
|
|
169
186
|
.sort();
|
|
170
187
|
if (unknownKeys.length > 0) {
|
|
171
188
|
throw new Error(`${where}: unknown key(s) ${unknownKeys.map((key) => `"${key}"`).join(", ")}`);
|
|
@@ -173,17 +190,22 @@ function parseEntry(entry, index) {
|
|
|
173
190
|
if (typeof entry.id !== "string" || entry.id.length === 0) {
|
|
174
191
|
throw new Error(`${where}.id must be a non-empty string`);
|
|
175
192
|
}
|
|
176
|
-
|
|
193
|
+
const paths = parsePaths(entry.paths, where);
|
|
194
|
+
if (entry.repo === undefined && paths === undefined) {
|
|
195
|
+
throw new Error(`${where} must set repo or paths when written as an object`);
|
|
196
|
+
}
|
|
197
|
+
const repo = entry.repo ?? PARENT_VALIDATION_PROJECT_REPO;
|
|
198
|
+
if (typeof repo !== "string" || !REPO_NAME_PATTERN.test(repo)) {
|
|
177
199
|
throw new Error(`${where}.repo must match ${String(REPO_NAME_PATTERN)} (got ${JSON.stringify(entry.repo)})`);
|
|
178
200
|
}
|
|
179
|
-
return { id: entry.id, repo:
|
|
201
|
+
return { id: entry.id, repo, ...(paths ? { paths } : {}) };
|
|
180
202
|
}
|
|
181
203
|
export function resolveParentValidationAssignments(entries) {
|
|
182
204
|
if (!entries)
|
|
183
205
|
return [];
|
|
184
206
|
const seen = new Set();
|
|
185
207
|
return entries.map((entry, index) => {
|
|
186
|
-
const { id, repo } = parseEntry(entry, index);
|
|
208
|
+
const { id, repo, paths } = parseEntry(entry, index);
|
|
187
209
|
const label = assignmentLabel(id, repo);
|
|
188
210
|
if (seen.has(label)) {
|
|
189
211
|
throw new Error(`Duplicate parent validation id in exec-defaults: ${label}`);
|
|
@@ -195,9 +217,76 @@ export function resolveParentValidationAssignments(entries) {
|
|
|
195
217
|
if (!definition) {
|
|
196
218
|
throw new Error(`Unknown parent validation id in exec-defaults: ${id} (allowed: ${Object.keys(PARENT_VALIDATION_REGISTRY).join(", ")})`);
|
|
197
219
|
}
|
|
198
|
-
return { definition, repo, label };
|
|
220
|
+
return { definition, repo, label, ...(paths ? { paths } : {}) };
|
|
199
221
|
});
|
|
200
222
|
}
|
|
223
|
+
function escapeRegExp(value) {
|
|
224
|
+
return value.replace(/[.+^${}()|[\]\\]/g, "\\$&");
|
|
225
|
+
}
|
|
226
|
+
// lefthook の glob と同じ書き方のうち、`**`・`*`・`?`・入れ子のない `{a,b}` だけを扱う。
|
|
227
|
+
function globSource(pattern) {
|
|
228
|
+
let source = "";
|
|
229
|
+
for (let index = 0; index < pattern.length; index++) {
|
|
230
|
+
const char = pattern[index];
|
|
231
|
+
if (char === "*" && pattern[index + 1] === "*") {
|
|
232
|
+
const followedBySlash = pattern[index + 2] === "/";
|
|
233
|
+
source += followedBySlash ? "(?:.*/)?" : ".*";
|
|
234
|
+
index += followedBySlash ? 2 : 1;
|
|
235
|
+
}
|
|
236
|
+
else if (char === "*") {
|
|
237
|
+
source += "[^/]*";
|
|
238
|
+
}
|
|
239
|
+
else if (char === "?") {
|
|
240
|
+
source += "[^/]";
|
|
241
|
+
}
|
|
242
|
+
else if (char === "{" && pattern.indexOf("}", index) > index) {
|
|
243
|
+
const end = pattern.indexOf("}", index);
|
|
244
|
+
const alternatives = pattern
|
|
245
|
+
.slice(index + 1, end)
|
|
246
|
+
.split(",")
|
|
247
|
+
.map(globSource);
|
|
248
|
+
source += `(?:${alternatives.join("|")})`;
|
|
249
|
+
index = end;
|
|
250
|
+
}
|
|
251
|
+
else {
|
|
252
|
+
source += escapeRegExp(char);
|
|
253
|
+
}
|
|
254
|
+
}
|
|
255
|
+
return source;
|
|
256
|
+
}
|
|
257
|
+
export function matchesParentValidationPaths(path, patterns) {
|
|
258
|
+
return patterns.some((pattern) => new RegExp(`^${globSource(pattern)}$`).test(path));
|
|
259
|
+
}
|
|
260
|
+
// evidence の変更一覧は、プロジェクトの変更を相対パス、プロダクトの変更を `<repo>:<path>`、
|
|
261
|
+
// 名前の変更を `old -> new` で記録する。割り当てたリポジトリの相対パスへ戻して照合する。
|
|
262
|
+
function changedPathsForRepo(changedPaths, repo, productRepos) {
|
|
263
|
+
const sides = changedPaths.flatMap((path) => path.split(" -> "));
|
|
264
|
+
if (repo !== PARENT_VALIDATION_PROJECT_REPO) {
|
|
265
|
+
const prefix = `${repo}:`;
|
|
266
|
+
return sides.filter((path) => path.startsWith(prefix)).map((path) => path.slice(prefix.length));
|
|
267
|
+
}
|
|
268
|
+
return sides.filter((path) => !productRepos.some((name) => path.startsWith(`${name}:`)));
|
|
269
|
+
}
|
|
270
|
+
/**
|
|
271
|
+
* Selection from the executor's recorded changes. A truncated change list (the evidence keeps at
|
|
272
|
+
* most MAX_CHANGE_FILES entries) is treated as unknown so no validation is skipped.
|
|
273
|
+
*/
|
|
274
|
+
export function parentValidationSelectionForEvidence(evidence) {
|
|
275
|
+
if (evidence.changes.length >= MAX_CHANGE_FILES)
|
|
276
|
+
return {};
|
|
277
|
+
return { changedPaths: evidence.changes.map((change) => change.path) };
|
|
278
|
+
}
|
|
279
|
+
/**
|
|
280
|
+
* Whether a validation declared with `paths` is skipped for the given change set. Validations
|
|
281
|
+
* without `paths` always run, and so does every validation when the change set is unknown.
|
|
282
|
+
*/
|
|
283
|
+
export function isParentValidationSkipped(assignment, selection, productRepos = []) {
|
|
284
|
+
const patterns = assignment.paths;
|
|
285
|
+
const changedPaths = selection?.changedPaths;
|
|
286
|
+
if (!patterns || changedPaths === undefined)
|
|
287
|
+
return false;
|
|
288
|
+
return !changedPathsForRepo(changedPaths, assignment.repo, productRepos).some((path) => matchesParentValidationPaths(path, patterns));
|
|
289
|
+
}
|
|
201
290
|
export function resolveParentValidationDefinitions(entries) {
|
|
202
291
|
return resolveParentValidationAssignments(entries).map((assignment) => assignment.definition);
|
|
203
292
|
}
|
|
@@ -284,15 +373,32 @@ function validationSummary(result) {
|
|
|
284
373
|
* without spawning anything. Results carry `repo` when the run spans product repositories or the
|
|
285
374
|
* assignment names one, so single-repository evidence keeps its previous shape.
|
|
286
375
|
*/
|
|
287
|
-
export async function runParentValidationBatch(entries, cwd, invoke = invokeParentValidation) {
|
|
376
|
+
export async function runParentValidationBatch(entries, cwd, invoke = invokeParentValidation, selection) {
|
|
288
377
|
const assignments = resolveParentValidationAssignments(entries);
|
|
289
378
|
const roots = typeof cwd === "string" ? { project: cwd } : cwd;
|
|
290
379
|
const recordsRepo = Object.keys(roots.repos ?? {}).length > 0 ||
|
|
291
380
|
assignments.some((assignment) => assignment.repo !== PARENT_VALIDATION_PROJECT_REPO);
|
|
292
381
|
const validations = [];
|
|
293
382
|
const failureOutputs = [];
|
|
294
|
-
|
|
383
|
+
const productRepos = Object.keys(roots.repos ?? {});
|
|
384
|
+
for (const assignment of assignments) {
|
|
385
|
+
const { definition, repo } = assignment;
|
|
295
386
|
const repoField = recordsRepo ? { repo } : {};
|
|
387
|
+
if (isParentValidationSkipped(assignment, selection, productRepos)) {
|
|
388
|
+
// 変更の種類に合わない検証は流さず、記録だけを残す(PJR-T01P)。ラベルの並びを保つため、
|
|
389
|
+
// 再開時の hasRecordedParentValidations は流し直しを要求しない。
|
|
390
|
+
const reason = truncateHead(`skipped by change type: no changed file matches paths (${(assignment.paths ?? []).join(", ")})`, MAX_SUMMARY_LENGTH);
|
|
391
|
+
validations.push({
|
|
392
|
+
id: definition.id,
|
|
393
|
+
source: "runner",
|
|
394
|
+
...repoField,
|
|
395
|
+
command: definition.displayCommand,
|
|
396
|
+
status: "not_applicable",
|
|
397
|
+
summary: reason,
|
|
398
|
+
reason,
|
|
399
|
+
});
|
|
400
|
+
continue;
|
|
401
|
+
}
|
|
296
402
|
const root = repo === PARENT_VALIDATION_PROJECT_REPO
|
|
297
403
|
? roots.project
|
|
298
404
|
: Object.hasOwn(roots.repos ?? {}, repo)
|
|
@@ -331,8 +437,8 @@ export async function runParentValidationBatch(entries, cwd, invoke = invokePare
|
|
|
331
437
|
}
|
|
332
438
|
return { validations, failureOutputs };
|
|
333
439
|
}
|
|
334
|
-
export async function runParentValidations(entries, cwd, invoke = invokeParentValidation) {
|
|
335
|
-
return (await runParentValidationBatch(entries, cwd, invoke)).validations;
|
|
440
|
+
export async function runParentValidations(entries, cwd, invoke = invokeParentValidation, selection) {
|
|
441
|
+
return (await runParentValidationBatch(entries, cwd, invoke, selection)).validations;
|
|
336
442
|
}
|
|
337
443
|
/** `<id>` or `<repo>:<id>` of a recorded runner validation (no `repo` means the project). */
|
|
338
444
|
export function recordedParentValidationLabel(validation) {
|
|
@@ -432,11 +538,53 @@ export function parentValidationGateFor(execDefaults, lockRoot = getActiveExecLo
|
|
|
432
538
|
return gate;
|
|
433
539
|
}
|
|
434
540
|
export function failedParentValidationReason(validations) {
|
|
435
|
-
|
|
541
|
+
// runner の `not_applicable` は、`paths` に合う変更が無く流さなかった検証である(PJR-T01P)。
|
|
542
|
+
const failed = validations.filter((validation) => validation.source === "runner" &&
|
|
543
|
+
validation.status !== "passed" &&
|
|
544
|
+
validation.status !== "not_applicable");
|
|
436
545
|
if (failed.length === 0)
|
|
437
546
|
return undefined;
|
|
438
547
|
return `parent validation failed: ${failed.map(recordedParentValidationLabel).join(", ")}`;
|
|
439
548
|
}
|
|
549
|
+
// PJR-Q2AT: executor が親検証をまとめて 1 行(例: `parent runner: lint-ts, lint-fm`、
|
|
550
|
+
// `親 runner 指定検査(lint-ts, lint-fm)`)に書いた場合に、末尾の区切り列を検証ラベルとして取り出す。
|
|
551
|
+
const AGGREGATE_LABEL_PATTERN = "(?:[A-Za-z0-9][A-Za-z0-9_-]*:)?[a-z][a-z0-9-]*";
|
|
552
|
+
const AGGREGATE_LINE_PATTERN = new RegExp(`^(\\S.*?)(?:[::((\\[]|\\s)\\s*(${AGGREGATE_LABEL_PATTERN}(?:\\s*[,、]\\s*${AGGREGATE_LABEL_PATTERN})*)\\s*[))\\]]?\\s*$`, "u");
|
|
553
|
+
// コマンドそのもの(`npm run lint:md` など)をまとめた行と取り違えない。
|
|
554
|
+
const COMMAND_PREFIX_PATTERN = /^(?:npm|npx|pnpm|yarn|node|tsx|specdojo)(?:\s|$)/u;
|
|
555
|
+
function aggregatedParentValidationLabels(command) {
|
|
556
|
+
const normalized = command.trim().replace(/\s+/gu, " ");
|
|
557
|
+
if (COMMAND_PREFIX_PATTERN.test(normalized))
|
|
558
|
+
return undefined;
|
|
559
|
+
const match = AGGREGATE_LINE_PATTERN.exec(normalized);
|
|
560
|
+
if (!match)
|
|
561
|
+
return undefined;
|
|
562
|
+
return match[2].split(/\s*[,、]\s*/u).filter((label) => label.length > 0);
|
|
563
|
+
}
|
|
564
|
+
/**
|
|
565
|
+
* Whether an executor validation line that lists parent validation labels together
|
|
566
|
+
* (e.g. `parent runner: lint-ts, lint-fm`) is covered by the runner's own results.
|
|
567
|
+
* Every listed label must have a runner record (so it is configured in
|
|
568
|
+
* `pipeline.parent_validations`) that passed or was skipped by change type.
|
|
569
|
+
*/
|
|
570
|
+
export function isAggregatedParentValidationSatisfied(command, validations) {
|
|
571
|
+
const labels = aggregatedParentValidationLabels(command);
|
|
572
|
+
if (!labels || labels.length === 0)
|
|
573
|
+
return false;
|
|
574
|
+
const runnerStatuses = new Map();
|
|
575
|
+
for (const validation of validations) {
|
|
576
|
+
if (validation.source !== "runner" || typeof validation.id !== "string")
|
|
577
|
+
continue;
|
|
578
|
+
const label = recordedParentValidationLabel(validation);
|
|
579
|
+
runnerStatuses.set(label, [...(runnerStatuses.get(label) ?? []), validation.status]);
|
|
580
|
+
}
|
|
581
|
+
return labels.every((label) => {
|
|
582
|
+
const statuses = runnerStatuses.get(label);
|
|
583
|
+
return (statuses !== undefined &&
|
|
584
|
+
statuses.length > 0 &&
|
|
585
|
+
statuses.every((status) => status === "passed" || status === "not_applicable"));
|
|
586
|
+
});
|
|
587
|
+
}
|
|
440
588
|
/**
|
|
441
589
|
* Replaces stale runner-owned validation results while preserving executor-owned evidence.
|
|
442
590
|
* The caller must supply results produced from the fixed parent-validation allowlist.
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { existsSync, readFileSync, renameSync, writeFileSync } from "node:fs";
|
|
2
2
|
import { dirname, join, relative, resolve, sep } from "node:path";
|
|
3
|
-
import {
|
|
3
|
+
import { runEvidencePath, taskEvidencePaths } from "./run-records.js";
|
|
4
|
+
import { ensureDir } from "./shared.js";
|
|
4
5
|
function emptyStage(actor) {
|
|
5
6
|
return {
|
|
6
7
|
status: "pending",
|
|
@@ -33,7 +34,7 @@ function executionRelative(repoRoot, executionPath) {
|
|
|
33
34
|
return rel;
|
|
34
35
|
}
|
|
35
36
|
export function pipelineStateLocation(input) {
|
|
36
|
-
const path = join(input.worktreePath, executionRelative(input.repoRoot, input.executionPath),
|
|
37
|
+
const path = taskEvidencePaths(join(input.worktreePath, executionRelative(input.repoRoot, input.executionPath)), input.taskId, input.runId).state;
|
|
37
38
|
return { path, ref: relative(input.worktreePath, path).split(sep).join("/") };
|
|
38
39
|
}
|
|
39
40
|
function isStageState(value) {
|
|
@@ -196,6 +197,29 @@ function resolveArtifactRef(worktreePath, ref) {
|
|
|
196
197
|
return null;
|
|
197
198
|
return path;
|
|
198
199
|
}
|
|
200
|
+
/**
|
|
201
|
+
* Validations recorded in the executor evidence of a run (PJR-T01P: the integration commit reads
|
|
202
|
+
* the parent-validation results). Returns an empty list when the state or evidence is unreadable.
|
|
203
|
+
*/
|
|
204
|
+
export function recordedRunValidations(worktreePath, statePath) {
|
|
205
|
+
if (!statePath || !existsSync(statePath))
|
|
206
|
+
return [];
|
|
207
|
+
try {
|
|
208
|
+
const state = readPipelineState(statePath);
|
|
209
|
+
const ref = state.stages.executor.artifact_ref;
|
|
210
|
+
const evidencePath = ref ? resolveArtifactRef(worktreePath, ref) : null;
|
|
211
|
+
if (!evidencePath || !existsSync(evidencePath))
|
|
212
|
+
return [];
|
|
213
|
+
const evidence = JSON.parse(readFileSync(evidencePath, "utf8"));
|
|
214
|
+
if (!isExecutorEvidence(evidence, state.task_id, state.run_id))
|
|
215
|
+
return [];
|
|
216
|
+
return Array.isArray(evidence.validations) ? evidence.validations : [];
|
|
217
|
+
}
|
|
218
|
+
catch {
|
|
219
|
+
// 読めない場合は hook を外さない(すべて流す)側へ倒す。
|
|
220
|
+
return [];
|
|
221
|
+
}
|
|
222
|
+
}
|
|
199
223
|
function isExecutorEvidence(value, taskId, runId) {
|
|
200
224
|
if (!value || typeof value !== "object" || Array.isArray(value))
|
|
201
225
|
return false;
|
|
@@ -226,9 +250,7 @@ export function loadPipelineResumeCheckpoint(input) {
|
|
|
226
250
|
const recordedEvidenceRef = state.stages.executor.artifact_ref;
|
|
227
251
|
const evidenceRef = recordedEvidenceRef ??
|
|
228
252
|
(state.stages.executor.status === "running"
|
|
229
|
-
? relative(input.worktreePath,
|
|
230
|
-
.split(sep)
|
|
231
|
-
.join("/")
|
|
253
|
+
? relative(input.worktreePath, runEvidencePath(statePath)).split(sep).join("/")
|
|
232
254
|
: null);
|
|
233
255
|
if (!evidenceRef)
|
|
234
256
|
return { state, statePath };
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
import { existsSync } from "node:fs";
|
|
2
|
+
import { createRequire } from "node:module";
|
|
3
|
+
import { dirname, join, relative } from "node:path";
|
|
4
|
+
import { pathToFileURL } from "node:url";
|
|
5
|
+
import { load } from "../shared/yaml.js";
|
|
6
|
+
import { DEFAULT_MARKDOWNLINT_CONFIG } from "../shared/markdownlint-config.js";
|
|
7
|
+
async function markdownlintApi(repoRoot) {
|
|
8
|
+
// Prefer the consumer's installation, then SpecDojo's development installation.
|
|
9
|
+
// Resolve from markdownlint-cli as well, for package managers without hoisting.
|
|
10
|
+
for (let require of [
|
|
11
|
+
createRequire(join(repoRoot, "package.json")),
|
|
12
|
+
createRequire(import.meta.url),
|
|
13
|
+
]) {
|
|
14
|
+
try {
|
|
15
|
+
try {
|
|
16
|
+
require = createRequire(require.resolve("markdownlint-cli/markdownlint.js"));
|
|
17
|
+
}
|
|
18
|
+
catch {
|
|
19
|
+
// A direct markdownlint installation is sufficient too.
|
|
20
|
+
}
|
|
21
|
+
const api = (await import(pathToFileURL(require.resolve("markdownlint/sync")).href));
|
|
22
|
+
const parsers = [];
|
|
23
|
+
try {
|
|
24
|
+
const jsonc = require("jsonc-parser");
|
|
25
|
+
parsers.push((text) => {
|
|
26
|
+
const errors = [];
|
|
27
|
+
const value = jsonc.parse(text, errors, { allowTrailingComma: true });
|
|
28
|
+
if (errors.length)
|
|
29
|
+
throw new Error("Invalid JSONC configuration");
|
|
30
|
+
return value;
|
|
31
|
+
});
|
|
32
|
+
}
|
|
33
|
+
catch {
|
|
34
|
+
// JSON and YAML remain supported without markdownlint-cli's JSONC parser.
|
|
35
|
+
}
|
|
36
|
+
parsers.push((text) => load(text));
|
|
37
|
+
return { ...api, parsers };
|
|
38
|
+
}
|
|
39
|
+
catch {
|
|
40
|
+
// Try the next installation without downloading a package.
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
throw new Error("markdownlint not available; install markdownlint-cli in the project to validate plans.");
|
|
44
|
+
}
|
|
45
|
+
function planLintConfig(repoRoot, api) {
|
|
46
|
+
let config;
|
|
47
|
+
// Merge ancestor .markdownlintrc files from outermost to nearest, like the CLI.
|
|
48
|
+
const rcPaths = [];
|
|
49
|
+
for (let dir = repoRoot;; dir = dirname(dir)) {
|
|
50
|
+
const candidate = join(dir, ".markdownlintrc");
|
|
51
|
+
if (existsSync(candidate))
|
|
52
|
+
rcPaths.unshift(candidate);
|
|
53
|
+
if (dirname(dir) === dir)
|
|
54
|
+
break;
|
|
55
|
+
}
|
|
56
|
+
for (const file of rcPaths)
|
|
57
|
+
config = { ...config, ...api.readConfig(file, api.parsers) };
|
|
58
|
+
for (const ext of ["jsonc", "json", "yaml", "yml"]) {
|
|
59
|
+
const file = join(repoRoot, `.markdownlint.${ext}`);
|
|
60
|
+
if (existsSync(file)) {
|
|
61
|
+
config = { ...config, ...api.readConfig(file, api.parsers) };
|
|
62
|
+
break;
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
return config ?? DEFAULT_MARKDOWNLINT_CONFIG;
|
|
66
|
+
}
|
|
67
|
+
// Lint rendered source before formatting or replacing an existing schedule plan.
|
|
68
|
+
// A string input bypasses ignore globs for generated history directories.
|
|
69
|
+
export async function assertPlanMarkdownlint(repoRoot, taskId, outPath, content) {
|
|
70
|
+
const planPath = relative(repoRoot, outPath);
|
|
71
|
+
const label = `Task ${taskId}, plan ${planPath}`;
|
|
72
|
+
let errors;
|
|
73
|
+
try {
|
|
74
|
+
const api = await markdownlintApi(repoRoot);
|
|
75
|
+
const issues = api.lint({
|
|
76
|
+
strings: { [planPath]: content },
|
|
77
|
+
config: planLintConfig(repoRoot, api),
|
|
78
|
+
configParsers: api.parsers,
|
|
79
|
+
})[planPath] ?? [];
|
|
80
|
+
errors = issues
|
|
81
|
+
.map((issue) => `${planPath}: ${issue.lineNumber} ${issue.ruleNames.join("/")} ${issue.ruleDescription}${issue.errorDetail ? ` [${issue.errorDetail}]` : ""}`)
|
|
82
|
+
.join("\n");
|
|
83
|
+
}
|
|
84
|
+
catch (error) {
|
|
85
|
+
throw new Error(`${label}: Failed to run markdownlint before plan generation: ${error instanceof Error ? error.message : String(error)}`);
|
|
86
|
+
}
|
|
87
|
+
if (errors)
|
|
88
|
+
throw new Error(`${label}: Plan Markdown notation violation before generation\n${errors}`);
|
|
89
|
+
}
|