specdojo 0.7.0 → 0.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.github/agents/specdojo-orchestrator.md +7 -3
- package/CHANGELOG.md +217 -0
- package/dist/catalog/build.js +24 -1
- package/dist/catalog/catalog.js +16 -14
- package/dist/catalog/plan.js +1 -1
- package/dist/catalog/scaffold.js +4 -1
- package/dist/commands/agent.js +5 -3
- package/dist/commands/build.js +69 -10
- package/dist/commands/git.js +206 -0
- package/dist/commands/init.js +9 -3
- package/dist/commands/night-orchestrator.js +6 -4
- package/dist/commands/where.js +25 -0
- package/dist/dashboard/dashboard-timeline.js +18 -16
- package/dist/dashboard/dashboard.js +616 -261
- package/dist/dashboard/epic-plan.js +81 -0
- package/dist/dashboard/exec-records.js +16 -20
- package/dist/dashboard/routines.js +11 -12
- package/dist/dashboard/timeline-build.js +5 -9
- package/dist/dashboard/timeline.js +23 -18
- package/dist/devcontainer/scaffold.js +18 -0
- package/dist/docs/frontmatter-namespace.js +1 -48
- package/dist/docs/index-command.js +2 -2
- package/dist/docs/yaml-business-tables.js +243 -0
- package/dist/docs/yaml-interface-tables.js +106 -0
- package/dist/docs/yaml-pages-command.js +5 -3
- package/dist/docs/yaml-pages.js +268 -3
- package/dist/docs/yaml-table-shared.js +70 -0
- package/dist/docs/yaml-tables.js +39 -0
- package/dist/exec/agent-config.js +31 -0
- package/dist/exec/agent-plan.js +3 -2
- package/dist/exec/agent-protected-config.js +2 -0
- package/dist/exec/commands.js +100 -39
- package/dist/exec/commit-hook-skips.js +78 -0
- package/dist/exec/core.js +19 -7
- package/dist/exec/events.js +179 -8
- package/dist/exec/evidence.js +77 -19
- package/dist/exec/handoff.js +9 -13
- package/dist/exec/limit.js +1 -1
- package/dist/exec/mechanical-result.js +45 -0
- package/dist/exec/migrate-records.js +249 -0
- package/dist/exec/parent-validation.js +209 -15
- package/dist/exec/pipeline-state.js +27 -5
- package/dist/exec/plans-condense-findings.js +89 -0
- package/dist/exec/plans-core.js +45 -19
- package/dist/exec/plans-generation.js +52 -30
- package/dist/exec/plans-grade-findings.js +8 -3
- package/dist/exec/plans-kata-findings.js +61 -0
- package/dist/exec/plans-planning.js +3 -3
- package/dist/exec/plans-storage.js +12 -24
- package/dist/exec/post-integration.js +162 -0
- package/dist/exec/queue-command.js +166 -0
- package/dist/exec/queue.js +285 -0
- package/dist/exec/register-foreign-wait.js +84 -0
- package/dist/exec/register-resume.js +55 -56
- package/dist/exec/register.js +26 -22
- package/dist/exec/repo-integration-sync.js +21 -5
- package/dist/exec/repo-integration.js +21 -1
- package/dist/exec/reporter.js +121 -23
- package/dist/exec/results.js +106 -25
- package/dist/exec/review-completion.js +47 -0
- package/dist/exec/review-kata.js +112 -0
- package/dist/exec/run/agent-pipeline.js +78 -8
- package/dist/exec/run/agent.js +32 -13
- package/dist/exec/run/change-scope.js +365 -0
- package/dist/exec/run/deferred-cleanup.js +31 -0
- package/dist/exec/run/in-place.js +73 -33
- package/dist/exec/run/job-lock.js +66 -0
- package/dist/exec/run/job-sequence.js +137 -0
- package/dist/exec/run/job.js +135 -41
- package/dist/exec/run/lifecycle-commands.js +189 -37
- package/dist/exec/run/lock.js +22 -1
- package/dist/exec/run/mode-shared.js +11 -3
- package/dist/exec/run/register-command.js +14 -15
- package/dist/exec/run/register-core.js +20 -13
- package/dist/exec/run/register-mode.js +77 -17
- package/dist/exec/run/register-post-review.js +21 -9
- package/dist/exec/run/register-resume.js +95 -31
- package/dist/exec/run/register-state.js +23 -15
- package/dist/exec/run/register-worktree.js +184 -139
- package/dist/exec/run/schedule-mode.js +79 -18
- package/dist/exec/run/schedule-prepare.js +204 -59
- package/dist/exec/run/schedule-task.js +203 -49
- package/dist/exec/run/shared.js +9 -3
- package/dist/exec/run/trailing-records.js +35 -0
- package/dist/exec/run-records.js +2 -0
- package/dist/exec/schedule/schedule.js +116 -4
- package/dist/exec/shared.js +1 -1
- package/dist/exec/smoke.js +190 -0
- package/dist/exec/strategy.js +14 -3
- package/dist/exec/task-view.js +6 -4
- package/dist/exec/trailing-records.js +242 -0
- package/dist/exec/trial-commands.js +8 -4
- package/dist/exec/trial-core.js +6 -1
- package/dist/exec/validate-records-commit.js +110 -0
- package/dist/exec/validate-records.js +148 -0
- package/dist/exec/validation-metrics.js +181 -0
- package/dist/exec/worktree-cleanup-lock.js +26 -0
- package/dist/exec/worktree-command.js +38 -17
- package/dist/exec/worktree-ops-commit.js +119 -48
- package/dist/exec/worktree-ops-lifecycle.js +77 -48
- package/dist/exec/worktree-ops-merge.js +13 -2
- package/dist/exec/worktree-ops.js +2 -2
- package/dist/exec/worktree.js +32 -4
- package/dist/grade/apply.js +32 -6
- package/dist/grade/command-apply.js +3 -3
- package/dist/grade/command-inspect.js +7 -5
- package/dist/grade/command-plan.js +1 -1
- package/dist/grade/command-run.js +7 -1
- package/dist/grade/command-shared.js +1 -1
- package/dist/grade/core.js +18 -5
- package/dist/grade/markdown.js +3 -3
- package/dist/grade/pipeline-state.js +15 -11
- package/dist/grade/plan.js +37 -17
- package/dist/grade/result.js +3 -3
- package/dist/grade/run.js +87 -11
- package/dist/grade/target-discovery.js +17 -4
- package/dist/grade/targets.js +12 -11
- package/dist/job/definition.js +84 -8
- package/dist/job/job.js +109 -39
- package/dist/job/noop.js +104 -0
- package/dist/register/authoring-sources.js +22 -16
- package/dist/register/core.js +2 -0
- package/dist/register/create-commands.js +28 -3
- package/dist/register/deliverable-target.js +9 -1
- package/dist/register/epic.js +104 -26
- package/dist/register/event-merge.js +3 -0
- package/dist/register/events.js +4 -0
- package/dist/register/external-project.js +3 -0
- package/dist/register/item.js +6 -0
- package/dist/register/maintenance-commands.js +6 -3
- package/dist/register/planning.js +7 -14
- package/dist/register/register.js +74 -16
- package/dist/register/track-domains.js +34 -0
- package/dist/register/track-plan.js +78 -0
- package/dist/register/transition-commands.js +8 -0
- package/dist/register/work-table.js +64 -0
- package/dist/review/grade.js +35 -13
- package/dist/routine/definition.js +13 -3
- package/dist/routine/failure.js +30 -0
- package/dist/routine/routine.js +189 -71
- package/dist/routine/status.js +62 -0
- package/dist/routine/storage.js +33 -0
- package/dist/schedule/schedule.js +39 -39
- package/dist/schedule/strategy-generate-document.js +26 -14
- package/dist/schedule/strategy-generate-scope.js +17 -45
- package/dist/schedule/strategy-generate.js +33 -3
- package/dist/schedule/strategy-profiles.js +86 -12
- package/dist/shared/agent-types.js +7 -0
- package/dist/shared/condense-records.js +25 -0
- package/dist/shared/cross-process-lock.js +9 -1
- package/dist/shared/deprecation.js +8 -0
- package/dist/shared/dist-freshness.js +8 -2
- package/dist/shared/document-metadata.js +20 -0
- package/dist/shared/finding-cause.js +20 -0
- package/dist/shared/frontmatter-namespace.js +48 -0
- package/dist/shared/git-environment.js +2 -1
- package/dist/shared/git.js +186 -16
- package/dist/shared/grade-result.js +17 -1
- package/dist/shared/lefthook-scaffold.js +3 -0
- package/dist/shared/local-config.js +244 -0
- package/dist/shared/local-state.js +20 -0
- package/dist/shared/markdownlint-config.js +8 -3
- package/dist/shared/plan-conventions.js +129 -0
- package/dist/shared/plan-templates.js +57 -41
- package/dist/shared/run-records.js +224 -0
- package/dist/shared/specdojo-config.js +73 -41
- package/dist/shared/specdojo-gitignore.js +1 -0
- package/dist/shared/text.js +74 -6
- package/dist/shared/timeline-index.js +2 -0
- package/dist/shared/where-alias.js +13 -0
- package/dist/specdojo.js +4 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
- package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
- package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
- package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
- package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
- package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
- package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
- package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
- package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
- package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
- package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
- package/docs/ja/specdojo/guides/docs-editing-guide.md +12 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
- package/docs/ja/specdojo/guides/exec-config-guide.md +69 -19
- package/docs/ja/specdojo/guides/exec-operation-guide.md +97 -18
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
- package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
- package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +73 -17
- package/docs/ja/specdojo/guides/register-operation-guide.md +26 -6
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +2 -0
- package/docs/ja/specdojo/guides/review-guide.md +22 -19
- package/docs/ja/specdojo/guides/routine-operation-guide.md +23 -12
- package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
- package/docs/ja/specdojo/guides/schedule-design-guide.md +27 -21
- package/docs/ja/specdojo/guides/schedule-operation-guide.md +27 -3
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
- package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
- package/docs/ja/specdojo/guides/use-case-guide.md +92 -155
- package/docs/ja/specdojo/guides/waza-guide.md +12 -8
- package/docs/ja/specdojo/recipes/bac-recipe.md +111 -0
- package/docs/ja/specdojo/recipes/bes-recipe.md +141 -0
- package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
- package/docs/ja/specdojo/recipes/br-recipe.md +77 -0
- package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
- package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +92 -99
- package/docs/ja/specdojo/recipes/cnd-recipe.md +135 -0
- package/docs/ja/specdojo/recipes/cpd-recipe.md +140 -0
- package/docs/ja/specdojo/recipes/cxd-recipe.md +162 -0
- package/docs/ja/specdojo/recipes/ifd-recipe.md +145 -0
- package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +112 -90
- package/docs/ja/specdojo/recipes/ifx-index-recipe.md +164 -0
- package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
- package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
- package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -48
- package/docs/ja/specdojo/recipes/pm-plan-recipe.md +72 -50
- package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +40 -49
- package/docs/ja/specdojo/recipes/pm-raci-recipe.md +42 -48
- package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -81
- package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -91
- package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
- package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -156
- package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
- package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
- package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
- package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
- package/docs/ja/specdojo/recipes/stsd-recipe.md +88 -80
- package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +129 -0
- package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +146 -0
- package/docs/ja/specdojo/recipes/sysd-index-recipe.md +141 -0
- package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
- package/docs/ja/specdojo/references/command-reference.md +303 -148
- package/docs/ja/specdojo/references/deliverables-reference.md +30 -16
- package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
- package/docs/ja/specdojo/references/specdojo-config-reference.md +54 -18
- package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
- package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +63 -290
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +162 -80
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +118 -155
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +128 -60
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +70 -94
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +58 -103
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +103 -223
- package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +51 -55
- package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +81 -68
- package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +139 -0
- package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
- package/docs/ja/specdojo/rulebooks/clis-rulebook.md +170 -0
- package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +79 -249
- package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
- package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
- package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +79 -249
- package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +115 -256
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +79 -109
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +119 -174
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +6 -14
- package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
- package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
- package/docs/ja/specdojo/rulebooks/dss-rulebook.md +171 -0
- package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
- package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +93 -57
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +63 -253
- package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +79 -76
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +182 -237
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +111 -40
- package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +23 -46
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +16 -40
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
- package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
- package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
- package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +12 -23
- package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
- package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
- package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
- package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
- package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
- package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
- package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
- package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
- package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
- package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
- package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
- package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
- package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
- package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
- package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
- package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +92 -102
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
- package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
- package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +45 -59
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +56 -66
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +54 -62
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +46 -65
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +65 -97
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +6 -18
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +48 -78
- package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -153
- package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
- package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
- package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
- package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
- package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +106 -32
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +111 -61
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +129 -59
- package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
- package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +46 -40
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +104 -68
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +64 -330
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +70 -263
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +58 -200
- package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -71
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
- package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
- package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
- package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +91 -161
- package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
- package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
- package/docs/ja/specdojo/samples/bac-sample.md +106 -21
- package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
- package/docs/ja/specdojo/samples/bds-sample.md +87 -21
- package/docs/ja/specdojo/samples/bes-index-sample.md +42 -20
- package/docs/ja/specdojo/samples/bes-sample.md +70 -21
- package/docs/ja/specdojo/samples/bps-sample.md +42 -54
- package/docs/ja/specdojo/samples/br-sample.md +57 -15
- package/docs/ja/specdojo/samples/ccd-sample.md +80 -19
- package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +9 -7
- package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
- package/docs/ja/specdojo/samples/cdsd-sample.md +73 -20
- package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
- package/docs/ja/specdojo/samples/cld-sample.md +3 -30
- package/docs/ja/specdojo/samples/clis-sample.md +125 -0
- package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
- package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
- package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
- package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
- package/docs/ja/specdojo/samples/dec-sample.md +2 -3
- package/docs/ja/specdojo/samples/dss-sample.md +175 -0
- package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
- package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
- package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
- package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
- package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
- package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
- package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
- package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
- package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
- package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
- package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
- package/docs/ja/specdojo/samples/pm-organization-sample.md +42 -21
- package/docs/ja/specdojo/samples/pm-plan-sample.md +78 -26
- package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +41 -22
- package/docs/ja/specdojo/samples/pm-raci-sample.md +63 -28
- package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
- package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +33 -25
- package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
- package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +83 -62
- package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
- package/docs/ja/specdojo/samples/sf-index-sample.md +47 -20
- package/docs/ja/specdojo/samples/sf-sample.md +109 -21
- package/docs/ja/specdojo/samples/sld-sample.md +88 -21
- package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
- package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
- package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
- package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
- package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
- package/docs/ja/specdojo/samples/uis-sample.md +141 -20
- package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
- package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
- package/docs/ja/specdojo/templates/bac-template.md +76 -0
- package/docs/ja/specdojo/templates/bes-template.md +56 -0
- package/docs/ja/specdojo/templates/br-template.md +64 -0
- package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
- package/docs/ja/specdojo/templates/cdfd-uc-template.md +9 -5
- package/docs/ja/specdojo/templates/cdr-template.md +58 -0
- package/docs/ja/specdojo/templates/cnd-template.md +137 -0
- package/docs/ja/specdojo/templates/cpd-template.md +129 -0
- package/docs/ja/specdojo/templates/cxd-template.md +105 -0
- package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
- package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
- package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
- package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
- package/docs/ja/specdojo/templates/ifd-template.md +86 -0
- package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
- package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
- package/docs/ja/specdojo/templates/opr-template.md +2 -4
- package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
- package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
- package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
- package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
- package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
- package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
- package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
- package/docs/ja/specdojo/templates/stsd-template.md +46 -21
- package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
- package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
- package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
- package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
- package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
- package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
- package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
- package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +5 -1
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +95 -8
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +38 -0
- package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
- package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
- package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
- package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
- package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
- package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
- package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
- package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
- package/package.json +10 -7
- package/templates/antigravity/orchestrator.md +7 -3
- package/templates/claude/agents/specdojo-orchestrator.md +7 -3
- package/templates/codex/agents/specdojo-orchestrator.toml +7 -3
- package/templates/codex/orchestrator.md +7 -3
- package/templates/devcontainer/tmux.conf +6 -0
- package/templates/init-exec-defaults.yaml +13 -0
- package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +8 -4
package/dist/job/job.js
CHANGED
|
@@ -1,25 +1,29 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { registerDeprecatedWhereAlias } from "../shared/where-alias.js";
|
|
2
2
|
import { spawn, spawnSync } from "node:child_process";
|
|
3
|
+
import { createHash } from "node:crypto";
|
|
3
4
|
import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
|
|
4
5
|
import { join, relative, resolve } from "node:path";
|
|
5
6
|
import { buildSpecdojoFrontmatter } from "../docs/frontmatter-namespace.js";
|
|
7
|
+
import { recordRef, taskRecordPaths } from "../shared/run-records.js";
|
|
6
8
|
import { listFilesRecursive, writeJson } from "../shared/fs.js";
|
|
7
9
|
import { gitEnvironment } from "../shared/git.js";
|
|
8
10
|
import { formatMarkdownFile } from "../shared/markdown-format.js";
|
|
9
11
|
import { execTemplatePath, injectCommonConventions, MISSING } from "../shared/plan-templates.js";
|
|
10
|
-
import { expandTemplate } from "../shared/text.js";
|
|
11
|
-
import { isJobAgentTask, isJobCommandTask, getPath, loadAllJobs, loadJobDefinition, loadJobRunRecord, parseInputValue, parseJobInputs, renderJobTemplate, resolveJobPaths, validateJobInputValue, } from "./definition.js";
|
|
12
|
-
import { specdojoRootDir } from "../shared/specdojo-config.js";
|
|
13
12
|
import { selfRunCommand } from "../shared/spawn-self.js";
|
|
14
|
-
|
|
13
|
+
import { specdojoRootDir } from "../shared/specdojo-config.js";
|
|
14
|
+
import { expandTemplate } from "../shared/text.js";
|
|
15
|
+
import { getPath, isJobAgentTask, isJobCommandTask, jobCommandText, loadAllJobs, loadJobDefinition, loadJobRunRecord, parseInputValue, parseJobInputs, renderJobTemplate, resolveJobPaths, validateJobInputValue, } from "./definition.js";
|
|
16
|
+
import { jobNoopDirectory, localJobNoopPath } from "./noop.js";
|
|
17
|
+
export { jobCommandText, isJobAgentTask, isJobCommandTask, jobDeclaresReview, jobRunUsesReviewedIntegration, loadAllJobs, loadJobDefinition, loadJobRunRecord, parseJobDefinition, parseJobInputs, renderJobTemplate, resolveJobPaths, resolveJobReviewAgentNominations, } from "./definition.js";
|
|
15
18
|
export function jobCheckpoint(paths, jobId) {
|
|
16
19
|
return deriveJobState(paths).jobs[jobId]?.checkpoint ?? {};
|
|
17
20
|
}
|
|
18
21
|
export function deriveJobState(paths) {
|
|
19
22
|
const state = { version: 1, jobs: {} };
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
+
for (const filePath of [
|
|
24
|
+
...listFilesRecursive(paths.runsPath),
|
|
25
|
+
...listFilesRecursive(jobNoopDirectory(paths.executionPath)),
|
|
26
|
+
]
|
|
23
27
|
.filter((path) => path.endsWith(".json"))
|
|
24
28
|
.sort()) {
|
|
25
29
|
try {
|
|
@@ -118,7 +122,7 @@ function commandOutputText(chunks, truncated) {
|
|
|
118
122
|
return truncated ? text.replace(/\uFFFD$/u, "") : text;
|
|
119
123
|
}
|
|
120
124
|
/** Executes a materialized Job command directly in the runner process, never through an agent. */
|
|
121
|
-
export async function executeJobCommand(command, cwd) {
|
|
125
|
+
export async function executeJobCommand(command, cwd, options = {}) {
|
|
122
126
|
const startedAt = new Date().toISOString();
|
|
123
127
|
return await new Promise((resolveResult) => {
|
|
124
128
|
const stdoutChunks = [];
|
|
@@ -128,6 +132,9 @@ export async function executeJobCommand(command, cwd) {
|
|
|
128
132
|
let stdoutTruncated = false;
|
|
129
133
|
let stderrTruncated = false;
|
|
130
134
|
let settled = false;
|
|
135
|
+
let timedOut = false;
|
|
136
|
+
let timeout;
|
|
137
|
+
let killTimeout;
|
|
131
138
|
const executable = process.platform === "win32" ? process.env.ComSpec || "cmd.exe" : "/bin/sh";
|
|
132
139
|
const args = process.platform === "win32" ? ["/d", "/s", "/c", command] : ["-eu", "-c", command];
|
|
133
140
|
const child = spawn(executable, args, {
|
|
@@ -136,7 +143,27 @@ export async function executeJobCommand(command, cwd) {
|
|
|
136
143
|
shell: false,
|
|
137
144
|
stdio: ["ignore", "pipe", "pipe"],
|
|
138
145
|
windowsHide: true,
|
|
146
|
+
detached: options.timeoutMs !== undefined && process.platform !== "win32",
|
|
139
147
|
});
|
|
148
|
+
const kill = (signal) => {
|
|
149
|
+
try {
|
|
150
|
+
if (process.platform !== "win32" && child.pid)
|
|
151
|
+
process.kill(-child.pid, signal);
|
|
152
|
+
else
|
|
153
|
+
child.kill(signal);
|
|
154
|
+
}
|
|
155
|
+
catch (error) {
|
|
156
|
+
if (error.code !== "ESRCH")
|
|
157
|
+
child.kill(signal);
|
|
158
|
+
}
|
|
159
|
+
};
|
|
160
|
+
if (options.timeoutMs !== undefined) {
|
|
161
|
+
timeout = setTimeout(() => {
|
|
162
|
+
timedOut = true;
|
|
163
|
+
kill("SIGTERM");
|
|
164
|
+
killTimeout = setTimeout(() => kill("SIGKILL"), 1000);
|
|
165
|
+
}, options.timeoutMs);
|
|
166
|
+
}
|
|
140
167
|
child.stdout.on("data", (chunk) => {
|
|
141
168
|
process.stdout.write(chunk);
|
|
142
169
|
const appended = appendCommandOutput(stdoutChunks, chunk, stdoutBytes);
|
|
@@ -153,6 +180,10 @@ export async function executeJobCommand(command, cwd) {
|
|
|
153
180
|
if (settled)
|
|
154
181
|
return;
|
|
155
182
|
settled = true;
|
|
183
|
+
clearTimeout(timeout);
|
|
184
|
+
clearTimeout(killTimeout);
|
|
185
|
+
if (timedOut)
|
|
186
|
+
kill("SIGKILL");
|
|
156
187
|
resolveResult({
|
|
157
188
|
command,
|
|
158
189
|
startedAt,
|
|
@@ -163,6 +194,7 @@ export async function executeJobCommand(command, cwd) {
|
|
|
163
194
|
stdoutTruncated,
|
|
164
195
|
stderrTruncated,
|
|
165
196
|
...(error ? { error } : {}),
|
|
197
|
+
...(timedOut ? { timedOut: true, error: "command timed out" } : {}),
|
|
166
198
|
});
|
|
167
199
|
};
|
|
168
200
|
child.once("error", (error) => finish(null, error.message));
|
|
@@ -230,7 +262,7 @@ export async function generateJobPlan(paths, definition, record) {
|
|
|
230
262
|
const templatePath = execTemplatePath("xep-job-template.md");
|
|
231
263
|
if (!existsSync(templatePath))
|
|
232
264
|
throw new Error(`Template not found: ${templatePath}`);
|
|
233
|
-
const planPath =
|
|
265
|
+
const planPath = taskRecordPaths(paths.executionPath, record.run_id, record.run_id, "job").plan;
|
|
234
266
|
mkdirSync(resolve(planPath, ".."), { recursive: true });
|
|
235
267
|
const commandTask = isJobCommandTask(record.task) ? record.task : undefined;
|
|
236
268
|
const values = {
|
|
@@ -252,7 +284,7 @@ export async function generateJobPlan(paths, definition, record) {
|
|
|
252
284
|
"runner が次の解決済みコマンドを agent の sandbox 外で直接実行する。",
|
|
253
285
|
"",
|
|
254
286
|
"```sh",
|
|
255
|
-
commandTask
|
|
287
|
+
jobCommandText(commandTask),
|
|
256
288
|
"```",
|
|
257
289
|
"",
|
|
258
290
|
commandTask.analysis
|
|
@@ -263,10 +295,13 @@ export async function generateJobPlan(paths, definition, record) {
|
|
|
263
295
|
_JOB_INPUTS_: JSON.stringify(record.inputs, null, 2),
|
|
264
296
|
_JOB_TARGETS_: record.task.targets?.map((target) => `- [[${target}]]`).join("\n") ?? "- -",
|
|
265
297
|
_JOB_PATHS_: record.task.paths?.map((path) => `- \`${path}\``).join("\n") ?? "- -",
|
|
266
|
-
_RESULT_REF_: repoRelative(
|
|
298
|
+
_RESULT_REF_: repoRelative(taskRecordPaths(paths.executionPath, record.run_id, record.run_id, "job").result),
|
|
267
299
|
};
|
|
268
300
|
const body = expandTemplate(readFileSync(templatePath, "utf8"), values);
|
|
269
|
-
const content = injectCommonConventions(body, MISSING, new Map()
|
|
301
|
+
const content = injectCommonConventions(body, MISSING, new Map(), "edit", {
|
|
302
|
+
executionPath: paths.executionPath,
|
|
303
|
+
planPath,
|
|
304
|
+
});
|
|
270
305
|
writeFileSync(planPath, content, "utf8");
|
|
271
306
|
await formatMarkdownFile(planPath);
|
|
272
307
|
return planPath;
|
|
@@ -290,8 +325,7 @@ export async function generateJobReviewPlan(paths, definition, record, opts) {
|
|
|
290
325
|
const templatePath = execTemplatePath("xrp-job-template.md");
|
|
291
326
|
if (!existsSync(templatePath))
|
|
292
327
|
throw new Error(`Template not found: ${templatePath}`);
|
|
293
|
-
const planPath =
|
|
294
|
-
const resultPath = join(paths.executionPath, "exec", "results", `${record.run_id}-review-result.md`);
|
|
328
|
+
const { plan: planPath, result: resultPath } = taskRecordPaths(paths.executionPath, record.run_id, `${record.run_id}-review`, "job");
|
|
295
329
|
mkdirSync(resolve(planPath, ".."), { recursive: true });
|
|
296
330
|
const values = {
|
|
297
331
|
_FRONTMATTER_: jobReviewPlanFrontmatter(paths.projectId, definition, record),
|
|
@@ -310,7 +344,10 @@ export async function generateJobReviewPlan(paths, definition, record, opts) {
|
|
|
310
344
|
_RUN_RESULT_REF_: repoRelative(join(paths.executionPath, record.result_ref)),
|
|
311
345
|
};
|
|
312
346
|
const body = expandTemplate(readFileSync(templatePath, "utf8"), values);
|
|
313
|
-
const content = injectCommonConventions(body, MISSING, new Map(), "review"
|
|
347
|
+
const content = injectCommonConventions(body, MISSING, new Map(), "review", {
|
|
348
|
+
executionPath: paths.executionPath,
|
|
349
|
+
planPath,
|
|
350
|
+
});
|
|
314
351
|
writeFileSync(planPath, content, "utf8");
|
|
315
352
|
await formatMarkdownFile(planPath);
|
|
316
353
|
return { planPath, resultPath };
|
|
@@ -362,7 +399,23 @@ export async function materializeJobRun(opts) {
|
|
|
362
399
|
command: renderJobTemplate(task.precondition.command, context),
|
|
363
400
|
};
|
|
364
401
|
}
|
|
365
|
-
|
|
402
|
+
if (task.command !== undefined)
|
|
403
|
+
task.command = renderJobTemplate(task.command, context);
|
|
404
|
+
if (task.steps) {
|
|
405
|
+
task.steps = task.steps.map((step) => ({
|
|
406
|
+
...step,
|
|
407
|
+
command: renderJobTemplate(step.command, context),
|
|
408
|
+
...(step.completion
|
|
409
|
+
? {
|
|
410
|
+
completion: {
|
|
411
|
+
...step.completion,
|
|
412
|
+
path: renderJobTemplate(step.completion.path, context),
|
|
413
|
+
field: renderJobTemplate(step.completion.field, context),
|
|
414
|
+
},
|
|
415
|
+
}
|
|
416
|
+
: {}),
|
|
417
|
+
}));
|
|
418
|
+
}
|
|
366
419
|
if (task.analysis) {
|
|
367
420
|
task.analysis = {
|
|
368
421
|
...task.analysis,
|
|
@@ -374,10 +427,11 @@ export async function materializeJobRun(opts) {
|
|
|
374
427
|
task.description = renderJobTemplate(task.description, context);
|
|
375
428
|
}
|
|
376
429
|
const now = new Date().toISOString();
|
|
377
|
-
const
|
|
430
|
+
const localNoop = localJobNoopPath(paths.executionPath, runId);
|
|
431
|
+
const existingRun = existsSync(localNoop) || existsSync(runPath);
|
|
378
432
|
let record;
|
|
379
433
|
if (existingRun) {
|
|
380
|
-
record = loadJobRunRecord(runPath);
|
|
434
|
+
record = loadJobRunRecord(existsSync(localNoop) ? localNoop : runPath);
|
|
381
435
|
if (record.idempotency_key !== idempotencyKey || record.job_id !== definition.id) {
|
|
382
436
|
throw new Error(`Job Run identity collision: ${runId}`);
|
|
383
437
|
}
|
|
@@ -406,12 +460,21 @@ export async function materializeJobRun(opts) {
|
|
|
406
460
|
inputs,
|
|
407
461
|
task,
|
|
408
462
|
checkpoint_before: checkpoint,
|
|
409
|
-
plan_ref:
|
|
410
|
-
result_ref:
|
|
463
|
+
plan_ref: recordRef(paths.executionPath, taskRecordPaths(paths.executionPath, runId, runId, "job").plan),
|
|
464
|
+
result_ref: recordRef(paths.executionPath, taskRecordPaths(paths.executionPath, runId, runId, "job").result),
|
|
411
465
|
attempts: [],
|
|
412
466
|
};
|
|
413
467
|
}
|
|
414
|
-
|
|
468
|
+
record = {
|
|
469
|
+
...record,
|
|
470
|
+
plan_ref: recordRef(paths.executionPath, taskRecordPaths(paths.executionPath, runId, runId, "job").plan),
|
|
471
|
+
result_ref: recordRef(paths.executionPath, taskRecordPaths(paths.executionPath, runId, runId, "job").result),
|
|
472
|
+
};
|
|
473
|
+
if (!existingRun &&
|
|
474
|
+
!opts.dryRun &&
|
|
475
|
+
!opts.skipPrecondition &&
|
|
476
|
+
isJobCommandTask(task) &&
|
|
477
|
+
task.precondition) {
|
|
415
478
|
const precondition = await executeJobPrecondition(task.precondition, specdojoRootDir());
|
|
416
479
|
if (precondition.skipped) {
|
|
417
480
|
return {
|
|
@@ -501,28 +564,35 @@ export function completeJobRun(opts) {
|
|
|
501
564
|
}
|
|
502
565
|
return updated;
|
|
503
566
|
}
|
|
567
|
+
/** Persist each step immediately so a stopped runner retains its last known progress. */
|
|
568
|
+
export function recordJobSteps(runPath, steps) {
|
|
569
|
+
const record = loadJobRunRecord(runPath);
|
|
570
|
+
const attempt = record.attempts.at(-1);
|
|
571
|
+
if (!attempt)
|
|
572
|
+
throw new Error(`Job Run has no attempt: ${record.run_id}`);
|
|
573
|
+
attempt.steps = steps;
|
|
574
|
+
record.updated_at = new Date().toISOString();
|
|
575
|
+
writeJson(runPath, record);
|
|
576
|
+
}
|
|
504
577
|
export function jobRunRelativePath(runPath) {
|
|
505
578
|
return repoRelative(runPath);
|
|
506
579
|
}
|
|
580
|
+
export function printJobPaths(opts) {
|
|
581
|
+
try {
|
|
582
|
+
const paths = resolveJobPaths(opts.project);
|
|
583
|
+
process.stdout.write(`project: ${paths.projectId}\n`);
|
|
584
|
+
process.stdout.write(`jobs: ${paths.jobsPath}\n`);
|
|
585
|
+
process.stdout.write(`runs: ${paths.runsPath}\n`);
|
|
586
|
+
process.stdout.write(`state: ${paths.statePath}\n`);
|
|
587
|
+
}
|
|
588
|
+
catch (error) {
|
|
589
|
+
process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
|
|
590
|
+
process.exitCode = 1;
|
|
591
|
+
}
|
|
592
|
+
}
|
|
507
593
|
export function registerJobCommands(program) {
|
|
508
594
|
const command = program.command("job").description("Reusable Job Definition and Run helpers");
|
|
509
|
-
command
|
|
510
|
-
.command("where")
|
|
511
|
-
.description("Print resolved Job paths")
|
|
512
|
-
.option("--project <projectId>", "Project id")
|
|
513
|
-
.action((opts) => {
|
|
514
|
-
try {
|
|
515
|
-
const paths = resolveJobPaths(opts.project);
|
|
516
|
-
process.stdout.write(`project: ${paths.projectId}\n`);
|
|
517
|
-
process.stdout.write(`jobs: ${paths.jobsPath}\n`);
|
|
518
|
-
process.stdout.write(`runs: ${paths.runsPath}\n`);
|
|
519
|
-
process.stdout.write(`state: ${paths.statePath}\n`);
|
|
520
|
-
}
|
|
521
|
-
catch (error) {
|
|
522
|
-
process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
|
|
523
|
-
process.exitCode = 1;
|
|
524
|
-
}
|
|
525
|
-
});
|
|
595
|
+
registerDeprecatedWhereAlias(command, printJobPaths);
|
|
526
596
|
command
|
|
527
597
|
.command("validate")
|
|
528
598
|
.description("Validate job-*.yaml definitions")
|
package/dist/job/noop.js
ADDED
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
import { createHash } from "node:crypto";
|
|
2
|
+
import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, readlinkSync, rmSync, writeFileSync, } from "node:fs";
|
|
3
|
+
import { dirname, join, relative, sep } from "node:path";
|
|
4
|
+
import { gitOutput, gitResult, worktreeStatusPaths } from "../shared/git.js";
|
|
5
|
+
import { listFilesRecursive, writeJson } from "../shared/fs.js";
|
|
6
|
+
import { localStateDirectory } from "../shared/local-state.js";
|
|
7
|
+
import { listRunRecords, planConventionsDirectory, runItemDirectory, } from "../shared/run-records.js";
|
|
8
|
+
import { planConventionsFiles } from "../shared/plan-conventions.js";
|
|
9
|
+
import { specdojoRootDir } from "../shared/specdojo-config.js";
|
|
10
|
+
export function jobNoopDirectory(executionPath, repoRoot = specdojoRootDir()) {
|
|
11
|
+
const key = createHash("sha256").update(relative(repoRoot, executionPath)).digest("hex");
|
|
12
|
+
return join(localStateDirectory(repoRoot), "jobs", key, "noops");
|
|
13
|
+
}
|
|
14
|
+
export function localJobNoopPath(executionPath, runId, repoRoot = specdojoRootDir()) {
|
|
15
|
+
return join(jobNoopDirectory(executionPath, repoRoot), `${runId}.json`);
|
|
16
|
+
}
|
|
17
|
+
function fingerprint(file) {
|
|
18
|
+
if (!existsSync(file))
|
|
19
|
+
return "missing";
|
|
20
|
+
const stat = lstatSync(file);
|
|
21
|
+
const value = stat.isSymbolicLink()
|
|
22
|
+
? readlinkSync(file)
|
|
23
|
+
: stat.isFile()
|
|
24
|
+
? readFileSync(file)
|
|
25
|
+
: "directory";
|
|
26
|
+
return `${stat.mode}:${createHash("sha256").update(value).digest("hex")}`;
|
|
27
|
+
}
|
|
28
|
+
/** Only this Run's bookkeeping is excluded; nested exec events and grade results are output. */
|
|
29
|
+
export function jobBookkeepingPaths(executionPath, record) {
|
|
30
|
+
const directory = runItemDirectory(executionPath, "job", record.run_id);
|
|
31
|
+
const paths = [
|
|
32
|
+
...new Set([
|
|
33
|
+
join(executionPath, "jobs", "runs", `${record.run_id}.json`),
|
|
34
|
+
directory,
|
|
35
|
+
join(executionPath, record.plan_ref),
|
|
36
|
+
join(executionPath, record.result_ref),
|
|
37
|
+
]),
|
|
38
|
+
];
|
|
39
|
+
return paths.filter((file) => !paths.some((parent) => file !== parent && file.startsWith(`${parent}${sep}`)));
|
|
40
|
+
}
|
|
41
|
+
export function snapshotJobOutput(repoRoot, executionPath, record) {
|
|
42
|
+
const artifacts = jobBookkeepingPaths(executionPath, record);
|
|
43
|
+
const conventionsDirectory = planConventionsDirectory(executionPath);
|
|
44
|
+
const previousVersions = new Set(existsSync(conventionsDirectory) ? readdirSync(conventionsDirectory) : []);
|
|
45
|
+
const ignored = artifacts.map((file) => relative(repoRoot, file).split(sep).join("/"));
|
|
46
|
+
ignored.push(relative(repoRoot, conventionsDirectory).split(sep).join("/"), relative(repoRoot, join(executionPath, "exec", ".locks"))
|
|
47
|
+
.split(sep)
|
|
48
|
+
.join("/"));
|
|
49
|
+
const substantive = (file) => !ignored.some((item) => file === item || file.startsWith(`${item}/`)) &&
|
|
50
|
+
!file.split("/").includes("generated");
|
|
51
|
+
const changes = new Map(worktreeStatusPaths(repoRoot)
|
|
52
|
+
.filter(substantive)
|
|
53
|
+
.map((file) => [file, fingerprint(join(repoRoot, file))]));
|
|
54
|
+
const previous = new Map();
|
|
55
|
+
for (const file of artifacts.flatMap((item) => existsSync(item) && lstatSync(item).isDirectory() ? listFilesRecursive(item) : [item])) {
|
|
56
|
+
if (existsSync(file))
|
|
57
|
+
previous.set(file, readFileSync(file));
|
|
58
|
+
}
|
|
59
|
+
// An initialized repository need not have its first commit yet.
|
|
60
|
+
const headResult = gitResult(repoRoot, ["rev-parse", "--verify", "HEAD"]);
|
|
61
|
+
const head = headResult.status === 0 ? String(headResult.stdout).trim() : undefined;
|
|
62
|
+
return {
|
|
63
|
+
hasChanges() {
|
|
64
|
+
const after = new Map(worktreeStatusPaths(repoRoot)
|
|
65
|
+
.filter(substantive)
|
|
66
|
+
.map((file) => [file, fingerprint(join(repoRoot, file))]));
|
|
67
|
+
if ([...new Set([...changes.keys(), ...after.keys()])].some((file) => changes.get(file) !== after.get(file)))
|
|
68
|
+
return true;
|
|
69
|
+
return (!!head &&
|
|
70
|
+
gitOutput(repoRoot, ["diff", "--name-only", "-z", head, "HEAD", "--"])
|
|
71
|
+
.split("\0")
|
|
72
|
+
.filter(Boolean)
|
|
73
|
+
.some(substantive));
|
|
74
|
+
},
|
|
75
|
+
discard(record) {
|
|
76
|
+
// Keep idempotency and checkpoints locally even though no Run artifacts enter Git.
|
|
77
|
+
const local = localJobNoopPath(executionPath, record.run_id, repoRoot);
|
|
78
|
+
mkdirSync(dirname(local), { recursive: true });
|
|
79
|
+
const noop = {
|
|
80
|
+
...record,
|
|
81
|
+
state: "noop",
|
|
82
|
+
attempts: record.attempts.map((attempt, index) => index === record.attempts.length - 1 ? { ...attempt, status: "noop" } : attempt),
|
|
83
|
+
};
|
|
84
|
+
writeJson(local, noop);
|
|
85
|
+
const versions = existsSync(join(executionPath, record.plan_ref))
|
|
86
|
+
? planConventionsFiles(readFileSync(join(executionPath, record.plan_ref), "utf8"), dirname(join(executionPath, record.plan_ref)))
|
|
87
|
+
: [];
|
|
88
|
+
for (const file of artifacts)
|
|
89
|
+
rmSync(file, { recursive: true, force: true });
|
|
90
|
+
for (const [file, content] of previous) {
|
|
91
|
+
mkdirSync(dirname(file), { recursive: true });
|
|
92
|
+
writeFileSync(file, content);
|
|
93
|
+
}
|
|
94
|
+
// Remove only snapshots introduced by this discarded Run. Preserve versions
|
|
95
|
+
// referenced by retained plans, including completed plans.
|
|
96
|
+
const retained = new Set(listRunRecords(executionPath, "plan").flatMap((plan) => planConventionsFiles(readFileSync(plan, "utf8"), dirname(plan))));
|
|
97
|
+
for (const version of versions) {
|
|
98
|
+
if (!previousVersions.has(version.slice(conventionsDirectory.length + 1)) &&
|
|
99
|
+
!retained.has(version))
|
|
100
|
+
rmSync(version);
|
|
101
|
+
}
|
|
102
|
+
},
|
|
103
|
+
};
|
|
104
|
+
}
|
|
@@ -1,6 +1,5 @@
|
|
|
1
|
-
import { existsSync, realpathSync, statSync } from "node:fs";
|
|
1
|
+
import { existsSync, globSync, realpathSync, statSync } from "node:fs";
|
|
2
2
|
import { extname, isAbsolute, posix, relative, resolve, sep } from "node:path";
|
|
3
|
-
import { globSync } from "tinyglobby";
|
|
4
3
|
import { collectDocIndexEntries } from "../docs/doc-index.js";
|
|
5
4
|
import { getProjectRepos, resolveRepoQualifiedRef, resolveRepoRoot, } from "../shared/specdojo-config.js";
|
|
6
5
|
// A bounded source set keeps generated plans reviewable and prevents a broad glob from handing an
|
|
@@ -28,6 +27,23 @@ function assertInsideRoot(root, path, ref) {
|
|
|
28
27
|
throw new Error(`Authoring source resolves outside its repository: ${ref}`);
|
|
29
28
|
}
|
|
30
29
|
}
|
|
30
|
+
const IGNORED_SOURCE_DIRECTORIES = new Set([".git", "node_modules"]);
|
|
31
|
+
function isExcludedSourceEntry(entry) {
|
|
32
|
+
if (entry.isSymbolicLink())
|
|
33
|
+
return true;
|
|
34
|
+
return entry.isDirectory() && IGNORED_SOURCE_DIRECTORIES.has(entry.name);
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* Lists regular files matching the patterns as slash-separated paths relative to `cwd`.
|
|
38
|
+
* node:fs globSync skips dot entries unless a pattern names them; symbolic links found while
|
|
39
|
+
* walking, `.git`, and `node_modules` are excluded.
|
|
40
|
+
*/
|
|
41
|
+
function globSourceFiles(patterns, cwd) {
|
|
42
|
+
const root = resolve(cwd);
|
|
43
|
+
return globSync(patterns, { cwd: root, withFileTypes: true, exclude: isExcludedSourceEntry })
|
|
44
|
+
.filter((entry) => entry.isFile())
|
|
45
|
+
.map((entry) => relative(root, resolve(entry.parentPath, entry.name)).replaceAll("\\", "/"));
|
|
46
|
+
}
|
|
31
47
|
function expandPath(root, rawPath, ref) {
|
|
32
48
|
if (!existsSync(root) || !statSync(root).isDirectory()) {
|
|
33
49
|
throw new Error(`Repository root for authoring source does not exist: ${ref}`);
|
|
@@ -38,26 +54,16 @@ function expandPath(root, rawPath, ref) {
|
|
|
38
54
|
if (existsSync(exact)) {
|
|
39
55
|
assertInsideRoot(root, exact, ref);
|
|
40
56
|
if (statSync(exact).isDirectory()) {
|
|
41
|
-
paths =
|
|
42
|
-
cwd: exact,
|
|
43
|
-
onlyFiles: true,
|
|
44
|
-
dot: false,
|
|
45
|
-
followSymbolicLinks: false,
|
|
46
|
-
ignore: ["**/.git/**", "**/node_modules/**"],
|
|
47
|
-
}).map((entry) => posix.join(normalized, entry.replaceAll("\\", "/")));
|
|
57
|
+
paths = globSourceFiles(["**/*"], exact).map((entry) => posix.join(normalized, entry));
|
|
48
58
|
}
|
|
49
59
|
else {
|
|
50
60
|
paths = [normalized];
|
|
51
61
|
}
|
|
52
62
|
}
|
|
53
63
|
else {
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
dot: false,
|
|
58
|
-
followSymbolicLinks: false,
|
|
59
|
-
ignore: ["**/.git/**", "**/node_modules/**"],
|
|
60
|
-
}).map((entry) => entry.replaceAll("\\", "/"));
|
|
64
|
+
// A pattern that does not end with "*" also matches the files below a matching directory.
|
|
65
|
+
const patterns = normalized.endsWith("*") ? [normalized] : [normalized, `${normalized}/**`];
|
|
66
|
+
paths = globSourceFiles(patterns, root);
|
|
61
67
|
}
|
|
62
68
|
const sorted = [...new Set(paths)].sort();
|
|
63
69
|
if (sorted.length === 0) {
|
package/dist/register/core.js
CHANGED
|
@@ -372,10 +372,12 @@ export function buildRegisterItemContent(opts) {
|
|
|
372
372
|
description: opts.fields.description,
|
|
373
373
|
type: opts.fields.type,
|
|
374
374
|
...(opts.fields.track ? { track: opts.fields.track } : {}),
|
|
375
|
+
...(opts.fields.domains !== undefined ? { domains: opts.fields.domains } : {}),
|
|
375
376
|
priority: opts.fields.priority,
|
|
376
377
|
...(opts.fields.difficulty ? { difficulty: opts.fields.difficulty } : {}),
|
|
377
378
|
owner: opts.fields.owner,
|
|
378
379
|
registeredAt: opts.fields.registeredAt,
|
|
380
|
+
...(opts.fields.startOn !== undefined ? { startOn: opts.fields.startOn } : {}),
|
|
379
381
|
due: opts.fields.due,
|
|
380
382
|
completedAt: opts.fields.completedAt,
|
|
381
383
|
conclusion: opts.fields.conclusion,
|
|
@@ -11,7 +11,7 @@ import { validateRegisterApproachTargetsForProject } from "./approach.js";
|
|
|
11
11
|
import { normalizeDependsOn, validateRegisterDependencies } from "./dependency.js";
|
|
12
12
|
import { normalizeDerivedFrom, validateDerivedFrom } from "./derivation.js";
|
|
13
13
|
import { delegateExternalRegisterAdd } from "./external-project.js";
|
|
14
|
-
import { validateRegisterTrack } from "./epic.js";
|
|
14
|
+
import { validateRegisterDomains, validateRegisterStartOn, validateRegisterTrack } from "./epic.js";
|
|
15
15
|
import { isAuthoringApproach } from "../kata/authoring.js";
|
|
16
16
|
function collectTarget(value, previous = []) {
|
|
17
17
|
return [...previous, value];
|
|
@@ -76,6 +76,7 @@ export function registerCreateCommands(reg, dependencies) {
|
|
|
76
76
|
addProjectOption(addCmd);
|
|
77
77
|
addCmd.requiredOption("--type <type>", `Item type: ${VALID_TYPES.join(" | ")}`);
|
|
78
78
|
addCmd.option("--track <track>", "Track governed by an epic (required for epic)");
|
|
79
|
+
addCmd.option("--domain <domain>", "Catalog domain governed by an epic (repeatable)", collectTarget);
|
|
79
80
|
addCmd.requiredOption("--title <title>", "Short title for the item");
|
|
80
81
|
addCmd.option("--input <text>", "Premise recorded in the ticket (repeatable)", collectTarget);
|
|
81
82
|
addCmd.option("--description <text>", "Description shown in the list", "_TODO_");
|
|
@@ -85,6 +86,7 @@ export function registerCreateCommands(reg, dependencies) {
|
|
|
85
86
|
addCmd.option("--owner <owner>", "Owner or role", "_TODO_");
|
|
86
87
|
addCmd.option("--registered <datetime>", "Registration date-time (RFC 3339 with time zone, or _TODO_; defaults to now in UTC)");
|
|
87
88
|
addCmd.option("--due <date>", "Due date (YYYY-MM-DD, -, or _TODO_)", "_TODO_");
|
|
89
|
+
addCmd.option("--start-on <date>", "Planned epic start date (YYYY-MM-DD; - omits)");
|
|
88
90
|
addCmd.option("--completed <datetime>", "Completion date-time (RFC 3339 with time zone, or -)", "-");
|
|
89
91
|
addCmd.option("--conclusion <text>", "Conclusion or resolution summary", "-");
|
|
90
92
|
addCmd.option("--target-path <path>", "Repository-relative deliverable file path");
|
|
@@ -156,8 +158,12 @@ export function registerCreateCommands(reg, dependencies) {
|
|
|
156
158
|
validateTargetsWithoutApproach: opts.target !== undefined || opts.source !== undefined,
|
|
157
159
|
});
|
|
158
160
|
const track = opts.track?.trim();
|
|
161
|
+
validateRegisterStartOn(opts.type, opts.startOn, true);
|
|
159
162
|
validateRegisterTrack(paths.projectId, opts.type, track);
|
|
163
|
+
const domains = opts.domain?.map((value) => value.trim());
|
|
164
|
+
validateRegisterDomains(opts.type, domains);
|
|
160
165
|
const fields = {
|
|
166
|
+
...(domains !== undefined ? { domains } : {}),
|
|
161
167
|
...(track !== undefined ? { track } : {}),
|
|
162
168
|
type: opts.type,
|
|
163
169
|
title: opts.title,
|
|
@@ -168,6 +174,7 @@ export function registerCreateCommands(reg, dependencies) {
|
|
|
168
174
|
status: opts.status,
|
|
169
175
|
owner: opts.owner,
|
|
170
176
|
registeredAt: registeredAt ?? nowUtcTimestamp(),
|
|
177
|
+
...(opts.startOn !== undefined && opts.startOn !== "-" ? { startOn: opts.startOn } : {}),
|
|
171
178
|
due: opts.due,
|
|
172
179
|
completedAt: completedAt ?? CELL_NONE,
|
|
173
180
|
conclusion: opts.conclusion,
|
|
@@ -258,12 +265,14 @@ export function registerUpdateCommand(reg, dependencies) {
|
|
|
258
265
|
addProjectOption(updateCmd);
|
|
259
266
|
updateCmd.requiredOption("--id <id>", "Item ID (PJR-XXXX)");
|
|
260
267
|
updateCmd.option("--track <track>", "Replace the track governed by an epic");
|
|
268
|
+
updateCmd.option("--domain <domain>", "Replace epic domains (repeatable; - removes)", collectTarget);
|
|
261
269
|
updateCmd.option("--title <title>", "Update title");
|
|
262
270
|
updateCmd.option("--description <text>", "Update description");
|
|
263
271
|
updateCmd.option("--priority <priority>", `Update priority: ${VALID_PRIORITIES.join(" | ")}`);
|
|
264
272
|
updateCmd.option("--difficulty <difficulty>", `Update difficulty: ${VALID_DIFFICULTIES.join(" | ")}; use - to remove`);
|
|
265
273
|
updateCmd.option("--owner <owner>", "Update owner or role");
|
|
266
274
|
updateCmd.option("--due <date>", "Update due date (YYYY-MM-DD, -, or _TODO_)");
|
|
275
|
+
updateCmd.option("--start-on <date>", "Update planned epic start date (YYYY-MM-DD; - removes)");
|
|
267
276
|
updateCmd.option("--conclusion <text>", "Update conclusion or use - to remove it");
|
|
268
277
|
updateCmd.option("--block-reason <text>", "Update the waiting reason or use - to remove it");
|
|
269
278
|
updateCmd.option("--autopilot <approval>", "Night orchestrator approval: approved, or - to revoke");
|
|
@@ -289,12 +298,14 @@ export function registerUpdateCommand(reg, dependencies) {
|
|
|
289
298
|
const item = view.item;
|
|
290
299
|
const hasUpdates = [
|
|
291
300
|
"track",
|
|
301
|
+
"domain",
|
|
292
302
|
"title",
|
|
293
303
|
"description",
|
|
294
304
|
"priority",
|
|
295
305
|
"difficulty",
|
|
296
306
|
"owner",
|
|
297
307
|
"due",
|
|
308
|
+
"startOn",
|
|
298
309
|
"conclusion",
|
|
299
310
|
"blockReason",
|
|
300
311
|
"autopilot",
|
|
@@ -311,7 +322,7 @@ export function registerUpdateCommand(reg, dependencies) {
|
|
|
311
322
|
"topic",
|
|
312
323
|
].some((key) => opts[key] !== undefined);
|
|
313
324
|
if (!hasUpdates) {
|
|
314
|
-
throw new Error("At least one field option must be specified (--track, --title, --description, --priority, --difficulty, --owner, --due, --conclusion, --block-reason, --autopilot, --approach, --target, --source, --input, --from, --depends-on, --commit-type, --commit-scope, --topic)");
|
|
325
|
+
throw new Error("At least one field option must be specified (--track, --domain, --title, --description, --priority, --difficulty, --owner, --due, --start-on, --conclusion, --block-reason, --autopilot, --approach, --target, --source, --input, --from, --depends-on, --commit-type, --commit-scope, --topic)");
|
|
315
326
|
}
|
|
316
327
|
if (opts.priority !== undefined &&
|
|
317
328
|
!VALID_PRIORITIES.includes(opts.priority)) {
|
|
@@ -432,6 +443,9 @@ export function registerUpdateCommand(reg, dependencies) {
|
|
|
432
443
|
(authoring && opts.source !== undefined && (item.targets?.length ?? 0) > 1);
|
|
433
444
|
const shouldUpdateSources = opts.source !== undefined || (authoring && providedLegacySources.length > 0);
|
|
434
445
|
const approachTargetUpdates = {
|
|
446
|
+
...(opts.startOn !== undefined
|
|
447
|
+
? { start_on: opts.startOn === "-" ? REMOVE_REGISTER_ITEM_FIELD : opts.startOn }
|
|
448
|
+
: {}),
|
|
435
449
|
...(opts.dependsOn !== undefined
|
|
436
450
|
? { depends_on: nextDependsOn ?? REMOVE_REGISTER_ITEM_FIELD }
|
|
437
451
|
: {}),
|
|
@@ -478,10 +492,21 @@ export function registerUpdateCommand(reg, dependencies) {
|
|
|
478
492
|
: {}),
|
|
479
493
|
};
|
|
480
494
|
const track = opts.track === undefined ? item.track : opts.track.trim();
|
|
481
|
-
|
|
495
|
+
validateRegisterStartOn(item.type, opts.startOn, true);
|
|
496
|
+
validateRegisterTrack(paths.projectId, item.type, track, item.id);
|
|
497
|
+
const domains = opts.domain?.map((value) => value.trim());
|
|
498
|
+
const removeDomains = domains?.length === 1 && domains[0] === "-";
|
|
499
|
+
if (domains !== undefined) {
|
|
500
|
+
validateRegisterDomains(item.type, removeDomains ? [] : domains);
|
|
501
|
+
approachTargetUpdates.domains = removeDomains ? REMOVE_REGISTER_ITEM_FIELD : domains;
|
|
502
|
+
}
|
|
482
503
|
const inputs = normalizeRegisterInput(opts.input, true);
|
|
483
504
|
const updated = {
|
|
484
505
|
...item,
|
|
506
|
+
...(opts.startOn !== undefined
|
|
507
|
+
? { startOn: opts.startOn === "-" ? undefined : opts.startOn }
|
|
508
|
+
: {}),
|
|
509
|
+
...(domains !== undefined ? { domains: removeDomains ? undefined : domains } : {}),
|
|
485
510
|
...(inputs !== undefined ? { inputs } : {}),
|
|
486
511
|
...(track !== undefined ? { track } : {}),
|
|
487
512
|
...(opts.title !== undefined ? { title: opts.title } : {}),
|
|
@@ -12,6 +12,7 @@ import { load } from "../shared/yaml.js";
|
|
|
12
12
|
export const CATALOG_LESS_APPROACHES = [
|
|
13
13
|
"draft",
|
|
14
14
|
"fully-guided",
|
|
15
|
+
"condense",
|
|
15
16
|
"recipe-guided",
|
|
16
17
|
"freeform",
|
|
17
18
|
"retrofit",
|
|
@@ -74,6 +75,10 @@ export function resolveRegisterDeliverableTarget(opts) {
|
|
|
74
75
|
if (opts.catalogPath) {
|
|
75
76
|
try {
|
|
76
77
|
const resolved = resolveDeliverableByDocId(opts.catalogPath, opts.projectId, opts.targetId, opts.repoRoot);
|
|
78
|
+
if (opts.approach === "condense" &&
|
|
79
|
+
!existsSync(resolve(opts.repoRoot, resolved.info.resolvedPath))) {
|
|
80
|
+
throw new Error(`Approach "condense" requires an existing deliverable: ${opts.targetId}`);
|
|
81
|
+
}
|
|
77
82
|
return { info: resolved.info, catalogless: false };
|
|
78
83
|
}
|
|
79
84
|
catch (error) {
|
|
@@ -102,7 +107,10 @@ export function resolveRegisterDeliverableTarget(opts) {
|
|
|
102
107
|
}
|
|
103
108
|
if (!rulebook)
|
|
104
109
|
throw new Error(`Target ${opts.targetId} requires --target-rulebook or specdojo.rulebook`);
|
|
105
|
-
if ((opts.approach === "
|
|
110
|
+
if ((opts.approach === "condense" ||
|
|
111
|
+
opts.approach === "finalize" ||
|
|
112
|
+
opts.approach === "bootstrap-finalize") &&
|
|
113
|
+
!existing) {
|
|
106
114
|
throw new Error(`Approach "${opts.approach}" requires an existing deliverable: ${opts.targetId}`);
|
|
107
115
|
}
|
|
108
116
|
const refs = {
|