specdojo 0.4.6 → 0.5.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 +14 -9
- package/CHANGELOG.md +62 -0
- package/dist/catalog/document-target.js +75 -0
- package/dist/commands/agent.js +2 -80
- package/dist/commands/init.js +3 -0
- package/dist/commands/night-orchestrator.js +33 -4
- package/dist/dashboard/dashboard.js +5 -6
- package/dist/dashboard/timeline-build.js +5 -1
- package/dist/dashboard/timeline.js +6 -3
- package/dist/docs/yaml-pages.js +17 -17
- package/dist/exec/agent-config.js +28 -16
- package/dist/exec/agent-plan.js +108 -0
- package/dist/exec/commands.js +3 -3
- package/dist/exec/core.js +2 -0
- package/dist/exec/grade-checkpoint.js +12 -0
- package/dist/exec/pipeline-state.js +5 -2
- package/dist/exec/plans-core.js +7 -67
- package/dist/exec/plans-generation.js +28 -7
- package/dist/exec/plans-grade-findings.js +16 -0
- package/dist/exec/plans-planning.js +43 -0
- package/dist/exec/plans-storage.js +5 -2
- package/dist/exec/project.js +4 -1
- package/dist/exec/register.js +82 -6
- package/dist/exec/repo-integration-sync.js +9 -0
- package/dist/exec/repo-integration.js +17 -2
- package/dist/exec/repo-trace.js +17 -4
- package/dist/exec/results.js +2 -0
- package/dist/exec/run/lifecycle-commands.js +2 -0
- package/dist/exec/run/register-core.js +11 -0
- package/dist/exec/run/register-mode.js +19 -1
- package/dist/exec/run/register-resume.js +23 -0
- package/dist/exec/run/register-state.js +4 -1
- package/dist/exec/run/register-worktree.js +28 -1
- package/dist/exec/run/schedule-prepare.js +7 -1
- package/dist/exec/strategy.js +2 -0
- package/dist/exec/task-repos.js +18 -4
- package/dist/exec/worktree-command.js +8 -1
- package/dist/exec/worktree-ops-commit.js +7 -1
- package/dist/exec/worktree-ops-merge.js +40 -1
- package/dist/grade/apply.js +13 -7
- package/dist/grade/command-inspect.js +2 -1
- package/dist/grade/command-run.js +39 -0
- package/dist/grade/grade.js +3 -1
- package/dist/grade/markdown.js +11 -6
- package/dist/grade/pipeline-state.js +8 -6
- package/dist/grade/plan.js +14 -10
- package/dist/grade/run.js +307 -0
- package/dist/grade/target-discovery.js +1 -1
- package/dist/grade/targets.js +44 -22
- package/dist/register/approach.js +35 -0
- package/dist/register/catalog-status.js +49 -0
- package/dist/register/core.js +5 -0
- package/dist/register/create-commands.js +83 -5
- package/dist/register/deliverable-target.js +215 -0
- package/dist/register/dependency.js +123 -0
- package/dist/register/derivation.js +2 -2
- package/dist/register/epic.js +42 -0
- package/dist/register/event-merge.js +5 -2
- package/dist/register/events.js +8 -0
- package/dist/register/external-project.js +4 -0
- package/dist/register/item.js +18 -0
- package/dist/register/maintenance-commands.js +7 -1
- package/dist/register/planning.js +37 -0
- package/dist/register/register.js +5 -1
- package/dist/register/renumber.js +12 -4
- package/dist/register/views.js +55 -4
- package/dist/review/grade.js +19 -17
- package/dist/schedule/schedule.js +3 -1
- package/dist/schedule/strategy-generate-scope.js +5 -1
- package/dist/schedule/strategy-generate.js +1 -0
- package/dist/schedule/strategy-profiles.js +1 -1
- package/dist/shared/agent-plan.js +1 -0
- package/dist/shared/agent-types.js +3 -0
- package/dist/shared/grade-result.js +23 -5
- package/dist/shared/markdownlint-config.js +38 -0
- package/dist/shared/markdownlint-scaffold.js +2 -9
- package/dist/shared/provider-scaffold.js +5 -3
- package/dist/shared/specdojo-config.js +10 -3
- package/dist/shared/specdojo-gitignore.js +4 -0
- package/dist/specdojo.js +5 -1
- package/docs/ja/specdojo/exec-templates/xep-catalog-planning-template.md +24 -0
- package/docs/ja/specdojo/exec-templates/xep-strategy-planning-template.md +24 -0
- package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-template.md +2 -2
- package/docs/ja/specdojo/guides/docs-editing-guide.md +14 -1
- package/docs/ja/specdojo/guides/docs-structure-guide.md +10 -8
- package/docs/ja/specdojo/guides/exec-config-guide.md +44 -12
- package/docs/ja/specdojo/guides/exec-operation-guide.md +20 -15
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +19 -1
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +3 -1
- package/docs/ja/specdojo/guides/practice-system-composition-guide.md +2 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +59 -16
- package/docs/ja/specdojo/guides/register-operation-guide.md +44 -15
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +15 -1
- package/docs/ja/specdojo/guides/review-guide.md +2 -2
- package/docs/ja/specdojo/guides/ryu-guide.md +12 -0
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +16 -16
- package/docs/ja/specdojo/guides/timeline-design-guide.md +37 -33
- package/docs/ja/specdojo/recipes/tsd-recipe.md +198 -0
- package/docs/ja/specdojo/references/command-reference.md +92 -29
- package/docs/ja/specdojo/references/specdojo-config-reference.md +49 -16
- package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/atc-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +5 -4
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +3 -2
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +8 -7
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +3 -2
- package/docs/ja/specdojo/rulebooks/cld-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/cop-rulebook.md +3 -2
- package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/etc-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +9 -6
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +3 -1
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +2 -0
- package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +4 -2
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/itc-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +10 -9
- package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +10 -9
- package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +7 -6
- package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/opd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/opr-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/otp-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +56 -36
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/sac-rulebook.md +3 -2
- package/docs/ja/specdojo/rulebooks/sch-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +7 -6
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/stc-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +80 -61
- package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +111 -63
- package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +3 -2
- package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/utc-rulebook.md +1 -0
- package/docs/ja/specdojo/samples/atc-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/atc-sample.md +1 -1
- package/docs/ja/specdojo/samples/bac-sample.md +1 -1
- package/docs/ja/specdojo/samples/bdd-sample.yaml +1 -1
- package/docs/ja/specdojo/samples/bds-sample.md +1 -1
- package/docs/ja/specdojo/samples/bes-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/bes-sample.md +1 -1
- package/docs/ja/specdojo/samples/ccd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cdfd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +1 -1
- package/docs/ja/specdojo/samples/cdsd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cld-sample.md +1 -1
- package/docs/ja/specdojo/samples/cnd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cop-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/cop-sample.md +1 -1
- package/docs/ja/specdojo/samples/cpd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cstd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cxd-sample.md +1 -1
- package/docs/ja/specdojo/samples/dmd-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/dmd-sample.md +1 -1
- package/docs/ja/specdojo/samples/etc-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/etc-sample.md +1 -1
- package/docs/ja/specdojo/samples/gl-sample.yaml +2 -0
- package/docs/ja/specdojo/samples/ifd-sample.md +1 -1
- package/docs/ja/specdojo/samples/ifx-api-sample.yaml +1 -0
- package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +1 -1
- package/docs/ja/specdojo/samples/ifx-file-sample.md +1 -1
- package/docs/ja/specdojo/samples/ifx-index-sample.yaml +1 -0
- package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +2 -1
- package/docs/ja/specdojo/samples/itc-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/itc-sample.md +1 -1
- package/docs/ja/specdojo/samples/mtp-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-availability-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-integrity-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-operations-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-performance-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-reliability-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-usability-sample.md +1 -1
- package/docs/ja/specdojo/samples/ntp-sample.md +1 -1
- package/docs/ja/specdojo/samples/opd-sample.md +1 -1
- package/docs/ja/specdojo/samples/opr-sample.md +1 -1
- package/docs/ja/specdojo/samples/otp-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/otp-sample.md +1 -1
- package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +1 -1
- package/docs/ja/specdojo/samples/sac-sample.md +1 -1
- package/docs/ja/specdojo/samples/sf-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/sf-sample.md +1 -1
- package/docs/ja/specdojo/samples/sld-sample.md +1 -1
- package/docs/ja/specdojo/samples/stc-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/stc-sample.md +1 -1
- package/docs/ja/specdojo/samples/stsd-sample.md +1 -1
- package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +1 -1
- package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +1 -1
- package/docs/ja/specdojo/samples/sysd-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/tsd-index-sample.md +22 -16
- package/docs/ja/specdojo/samples/tsd-sample.md +241 -21
- package/docs/ja/specdojo/samples/tsp-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/uis-sample.md +1 -1
- package/docs/ja/specdojo/samples/utc-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/utc-sample.md +1 -1
- package/docs/ja/specdojo/standards/document-metadata-standard.md +28 -3
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +2 -0
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +16 -11
- package/docs/ja/specdojo/standards/sample-authoring-standard.md +1 -0
- package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +1 -1
- package/docs/ja/specdojo/templates/pjr-dependent-items-template.md +22 -0
- package/docs/ja/specdojo/templates/pjr-epic-items-template.md +22 -0
- package/docs/ja/specdojo/templates/pjr-epic-template.md +44 -0
- package/docs/ja/specdojo/templates/pjr-index-template.md +4 -2
- package/docs/specdojo/schemas/v1/bdd.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +24 -16
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +4 -1
- package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/gl.schema.yaml +8 -0
- package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +5 -1
- package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +2 -1
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +20 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +73 -4
- package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +5 -0
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +21 -3
- package/package.json +2 -2
- package/templates/antigravity/orchestrator.md +14 -9
- package/templates/claude/agents/specdojo-orchestrator.md +14 -9
- package/templates/codex/agents/specdojo-orchestrator.toml +14 -9
- package/templates/codex/orchestrator.md +14 -9
- package/templates/copilot/README.md +2 -1
- package/templates/devcontainer/devcontainer.json +1 -0
- package/templates/init-agent-members.yaml +46 -3
- package/templates/opencode/README.md +118 -14
- package/templates/opencode/agents/specdojo-orchestrator.md +15 -10
- package/templates/opencode/opencode.json +25 -0
|
@@ -0,0 +1,215 @@
|
|
|
1
|
+
import { existsSync, readFileSync, realpathSync, statSync } from "node:fs";
|
|
2
|
+
import { dirname, isAbsolute, relative, resolve } from "node:path";
|
|
3
|
+
import { collectDocIndexEntries } from "../docs/doc-index.js";
|
|
4
|
+
import { specdojoReferencePath } from "../docs/template-resolution.js";
|
|
5
|
+
import { readSpecdojoNamespace } from "../docs/frontmatter-namespace.js";
|
|
6
|
+
import { resolveDeliverableByDocId } from "../catalog/document-target.js";
|
|
7
|
+
import { KATA_MISSING, resolveKataDocumentPathIfExists } from "../kata/kata.js";
|
|
8
|
+
import { AUTHORING_KINDS } from "../kata/authoring.js";
|
|
9
|
+
import { loadConfig } from "../shared/specdojo-config.js";
|
|
10
|
+
import { parsePracticeId } from "../shared/practice-id.js";
|
|
11
|
+
import { load } from "../shared/yaml.js";
|
|
12
|
+
export const CATALOG_LESS_APPROACHES = [
|
|
13
|
+
"fully-guided",
|
|
14
|
+
"recipe-guided",
|
|
15
|
+
"freeform",
|
|
16
|
+
"retrofit",
|
|
17
|
+
"bootstrap",
|
|
18
|
+
"finalize",
|
|
19
|
+
"bootstrap-finalize",
|
|
20
|
+
];
|
|
21
|
+
function metadata(path) {
|
|
22
|
+
const text = readFileSync(path, "utf8");
|
|
23
|
+
if (/\.mdx?$/.test(path))
|
|
24
|
+
return readSpecdojoNamespace(text);
|
|
25
|
+
const parsed = load(text);
|
|
26
|
+
return (parsed?.specdojo ?? parsed ?? {});
|
|
27
|
+
}
|
|
28
|
+
// Resolve the nearest existing ancestor as well, so symlink parents cannot escape the repository.
|
|
29
|
+
export function validateDeliverablePath(root, value) {
|
|
30
|
+
if (!value.trim() || isAbsolute(value) || /^[a-z]:/i.test(value) || value.includes("\\")) {
|
|
31
|
+
throw new Error(`--target-path must be a repository-relative path: ${value}`);
|
|
32
|
+
}
|
|
33
|
+
const absolute = resolve(root, value);
|
|
34
|
+
const path = relative(root, absolute).replaceAll("\\", "/");
|
|
35
|
+
if (!path || path === ".." || path.startsWith("../")) {
|
|
36
|
+
throw new Error(`--target-path points outside the repository: ${value}`);
|
|
37
|
+
}
|
|
38
|
+
let ancestor = absolute;
|
|
39
|
+
while (!existsSync(ancestor))
|
|
40
|
+
ancestor = dirname(ancestor);
|
|
41
|
+
const physical = relative(realpathSync(root), realpathSync(ancestor));
|
|
42
|
+
if (physical === ".." || physical.startsWith("../") || isAbsolute(physical)) {
|
|
43
|
+
throw new Error(`--target-path points outside the repository through a symlink: ${value}`);
|
|
44
|
+
}
|
|
45
|
+
if (existsSync(absolute) && !statSync(absolute).isFile()) {
|
|
46
|
+
throw new Error(`--target-path must name a file: ${value}`);
|
|
47
|
+
}
|
|
48
|
+
return path;
|
|
49
|
+
}
|
|
50
|
+
export function resolveRegisterDeliverableTarget(opts) {
|
|
51
|
+
if (opts.catalogPath) {
|
|
52
|
+
try {
|
|
53
|
+
const resolved = resolveDeliverableByDocId(opts.catalogPath, opts.projectId, opts.targetId, opts.repoRoot);
|
|
54
|
+
return { info: resolved.info, catalogless: false };
|
|
55
|
+
}
|
|
56
|
+
catch (error) {
|
|
57
|
+
if (!(error instanceof Error) ||
|
|
58
|
+
!error.message.startsWith("catalog deliverable target not found"))
|
|
59
|
+
throw error;
|
|
60
|
+
if (!opts.targetPath || !opts.targetRulebook)
|
|
61
|
+
throw error;
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
if (!CATALOG_LESS_APPROACHES.includes(opts.approach)) {
|
|
65
|
+
throw new Error(`Approach "${opts.approach}" requires a deliverable target from the project catalog (catalog_path)`);
|
|
66
|
+
}
|
|
67
|
+
const entries = collectDocIndexEntries(resolve(opts.repoRoot, "docs"), opts.repoRoot);
|
|
68
|
+
const indexed = entries[opts.targetId]?.replace(/:\d+$/, "");
|
|
69
|
+
const indexedPath = indexed
|
|
70
|
+
? relative(opts.repoRoot, resolve(opts.repoRoot, indexed))
|
|
71
|
+
: undefined;
|
|
72
|
+
if (!opts.targetPath && !indexedPath) {
|
|
73
|
+
throw new Error(`Target ${opts.targetId} is not indexed; specify --target-path and --target-rulebook (catalog_path is not configured)`);
|
|
74
|
+
}
|
|
75
|
+
const path = validateDeliverablePath(opts.repoRoot, opts.targetPath ?? indexedPath ?? "");
|
|
76
|
+
if (indexedPath && path !== validateDeliverablePath(opts.repoRoot, indexedPath)) {
|
|
77
|
+
throw new Error(`--target-path conflicts with the indexed document ${opts.targetId}: ${indexedPath}`);
|
|
78
|
+
}
|
|
79
|
+
const absolute = resolve(opts.repoRoot, path);
|
|
80
|
+
const existing = existsSync(absolute);
|
|
81
|
+
const fm = existing ? metadata(absolute) : {};
|
|
82
|
+
if (existing && fm.id !== opts.targetId) {
|
|
83
|
+
throw new Error(`--target-path is occupied by another document: ${path} (expected ${opts.targetId})`);
|
|
84
|
+
}
|
|
85
|
+
if (AUTHORING_KINDS.includes(fm.type)) {
|
|
86
|
+
throw new Error(`Target ${opts.targetId} is a kata, not a deliverable`);
|
|
87
|
+
}
|
|
88
|
+
const declaredRulebook = typeof fm.rulebook === "string" ? fm.rulebook : undefined;
|
|
89
|
+
if (opts.targetRulebook && declaredRulebook && opts.targetRulebook !== declaredRulebook) {
|
|
90
|
+
throw new Error(`--target-rulebook conflicts with specdojo.rulebook of ${opts.targetId}: ${declaredRulebook}`);
|
|
91
|
+
}
|
|
92
|
+
const rulebook = opts.targetRulebook ?? declaredRulebook;
|
|
93
|
+
if (!existing && (!opts.targetPath || !opts.targetRulebook)) {
|
|
94
|
+
throw new Error(`New deliverable ${opts.targetId} requires --target-path and --target-rulebook`);
|
|
95
|
+
}
|
|
96
|
+
if (!rulebook)
|
|
97
|
+
throw new Error(`Target ${opts.targetId} requires --target-rulebook or specdojo.rulebook`);
|
|
98
|
+
if ((opts.approach === "finalize" || opts.approach === "bootstrap-finalize") && !existing) {
|
|
99
|
+
throw new Error(`Approach "${opts.approach}" requires an existing deliverable: ${opts.targetId}`);
|
|
100
|
+
}
|
|
101
|
+
const refs = {
|
|
102
|
+
rulebook: KATA_MISSING,
|
|
103
|
+
recipe: KATA_MISSING,
|
|
104
|
+
sample: KATA_MISSING,
|
|
105
|
+
template: KATA_MISSING,
|
|
106
|
+
};
|
|
107
|
+
const kataIds = [];
|
|
108
|
+
const kataTargets = [];
|
|
109
|
+
const findKata = (kind, id) => {
|
|
110
|
+
const entry = entries[id]?.replace(/:\d+$/, "");
|
|
111
|
+
if (entry) {
|
|
112
|
+
const absolutePath = resolve(opts.repoRoot, entry);
|
|
113
|
+
if (kind !== "sample" && metadata(absolutePath).type !== kind)
|
|
114
|
+
throw new Error(`Kata ${id} must have type ${kind}`);
|
|
115
|
+
return specdojoReferencePath(absolutePath, { repositoryRoot: opts.repoRoot });
|
|
116
|
+
}
|
|
117
|
+
for (const extension of kind === "rulebook" || kind === "recipe"
|
|
118
|
+
? ["md"]
|
|
119
|
+
: ["md", "yaml", "yml", "json"]) {
|
|
120
|
+
const found = resolveKataDocumentPathIfExists(kind, id, extension, {
|
|
121
|
+
repositoryRoot: opts.repoRoot,
|
|
122
|
+
});
|
|
123
|
+
if (found &&
|
|
124
|
+
metadata(found).id === id &&
|
|
125
|
+
(kind === "sample" || metadata(found).type === kind))
|
|
126
|
+
return specdojoReferencePath(found, { repositoryRoot: opts.repoRoot });
|
|
127
|
+
}
|
|
128
|
+
return undefined;
|
|
129
|
+
};
|
|
130
|
+
if (opts.approach === "bootstrap") {
|
|
131
|
+
if (!opts.targetPath || !opts.targetRulebook)
|
|
132
|
+
throw new Error("Catalog-less bootstrap requires --target-path and --target-rulebook");
|
|
133
|
+
const authority = loadConfig(opts.repoRoot).config?.kata_authority;
|
|
134
|
+
if (!authority)
|
|
135
|
+
throw new Error("Catalog-less bootstrap requires kata_authority in specdojo.config.json");
|
|
136
|
+
const parsed = parsePracticeId(rulebook);
|
|
137
|
+
if (parsed.authority !== authority || !/^[a-z0-9][a-z0-9-]*-rulebook$/.test(parsed.localId)) {
|
|
138
|
+
throw new Error(`Bootstrap rulebook must use kata_authority ${authority} and end with -rulebook: ${rulebook}`);
|
|
139
|
+
}
|
|
140
|
+
if (findKata("rulebook", rulebook))
|
|
141
|
+
throw new Error(`Bootstrap requires a new rulebook id; ${rulebook} already exists`);
|
|
142
|
+
const stem = parsed.localId.slice(0, -"-rulebook".length);
|
|
143
|
+
for (const kind of AUTHORING_KINDS) {
|
|
144
|
+
const id = `${authority}:${stem}-${kind}`;
|
|
145
|
+
const proposedPath = `docs/ja/specdojo/${kind}s/${authority}/${stem}-${kind}.md`;
|
|
146
|
+
validateDeliverablePath(opts.repoRoot, proposedPath);
|
|
147
|
+
// Do not reuse somebody else's kata when the generated id/path collides.
|
|
148
|
+
if (entries[id] || existsSync(resolve(opts.repoRoot, proposedPath)) || findKata(kind, id)) {
|
|
149
|
+
throw new Error(`Bootstrap kata id or path already exists: ${id} (${proposedPath})`);
|
|
150
|
+
}
|
|
151
|
+
refs[kind] = proposedPath;
|
|
152
|
+
kataIds.push(id);
|
|
153
|
+
kataTargets.push({ id, path: proposedPath });
|
|
154
|
+
}
|
|
155
|
+
}
|
|
156
|
+
else {
|
|
157
|
+
const missing = [];
|
|
158
|
+
const rulebookPath = !["none", "not-needed", "undecided"].includes(rulebook)
|
|
159
|
+
? findKata("rulebook", rulebook)
|
|
160
|
+
: undefined;
|
|
161
|
+
if (rulebookPath) {
|
|
162
|
+
refs.rulebook = rulebookPath;
|
|
163
|
+
kataIds.push(rulebook);
|
|
164
|
+
kataTargets.push({ id: rulebook, path: rulebookPath });
|
|
165
|
+
}
|
|
166
|
+
else if (opts.approach !== "freeform")
|
|
167
|
+
missing.push("rulebook");
|
|
168
|
+
const rb = rulebookPath ? metadata(resolve(opts.repoRoot, rulebookPath)) : {};
|
|
169
|
+
for (const kind of ["recipe", "sample", "template"]) {
|
|
170
|
+
const declaration = rb[kind];
|
|
171
|
+
const ids = Array.isArray(declaration) ? declaration : [declaration];
|
|
172
|
+
const notNeeded = declaration === "not-needed";
|
|
173
|
+
const required = (opts.approach === "fully-guided" && !notNeeded) ||
|
|
174
|
+
(opts.approach === "recipe-guided" && kind === "recipe") ||
|
|
175
|
+
(opts.approach === "bootstrap-finalize" && !notNeeded);
|
|
176
|
+
let resolvedAny = false;
|
|
177
|
+
for (const id of ids) {
|
|
178
|
+
if (typeof id !== "string" || ["none", "not-needed", "undecided"].includes(id))
|
|
179
|
+
continue;
|
|
180
|
+
const found = findKata(kind, id);
|
|
181
|
+
if (found) {
|
|
182
|
+
if (!resolvedAny)
|
|
183
|
+
refs[kind] = found;
|
|
184
|
+
resolvedAny = true;
|
|
185
|
+
kataIds.push(id);
|
|
186
|
+
kataTargets.push({ id, path: found });
|
|
187
|
+
}
|
|
188
|
+
else if (required)
|
|
189
|
+
missing.push(`${kind} (${id})`);
|
|
190
|
+
}
|
|
191
|
+
if (required && !resolvedAny)
|
|
192
|
+
missing.push(kind);
|
|
193
|
+
}
|
|
194
|
+
if (missing.length)
|
|
195
|
+
throw new Error(`Approach "${opts.approach}" is missing kata: ${[...new Set(missing)].join(", ")}`);
|
|
196
|
+
}
|
|
197
|
+
return {
|
|
198
|
+
catalogless: true,
|
|
199
|
+
refs,
|
|
200
|
+
kataIds,
|
|
201
|
+
kataTargets,
|
|
202
|
+
info: {
|
|
203
|
+
catalogless: true,
|
|
204
|
+
resolvedPath: path,
|
|
205
|
+
deliverable: {
|
|
206
|
+
local_id: opts.targetId.split(":").pop(),
|
|
207
|
+
name: opts.targetId,
|
|
208
|
+
kind: "work",
|
|
209
|
+
overview: "個票の概要・完了条件を参照する。",
|
|
210
|
+
path,
|
|
211
|
+
rulebook,
|
|
212
|
+
},
|
|
213
|
+
},
|
|
214
|
+
};
|
|
215
|
+
}
|
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
import { basename } from "node:path";
|
|
2
|
+
import { gitOutput, gitResult } from "../shared/git.js";
|
|
3
|
+
import { getProjectRegisterPath, loadConfig, specdojoRootDir } from "../shared/specdojo-config.js";
|
|
4
|
+
import { resolveProjectIntegrationBranch } from "./cross-project.js";
|
|
5
|
+
import { parseRegisterItemRef } from "./derivation.js";
|
|
6
|
+
import { loadRegisterItemDocs, readRegisterItemContent } from "./item.js";
|
|
7
|
+
export function normalizeDependsOn(values) {
|
|
8
|
+
if (values === undefined)
|
|
9
|
+
return undefined;
|
|
10
|
+
const refs = [...new Set(values.map((value) => value.trim()).filter(Boolean))];
|
|
11
|
+
if (refs.includes("-")) {
|
|
12
|
+
if (refs.length !== 1)
|
|
13
|
+
throw new Error("--depends-on - cannot be combined with other item IDs");
|
|
14
|
+
return undefined;
|
|
15
|
+
}
|
|
16
|
+
if (refs.length === 0)
|
|
17
|
+
throw new Error("--depends-on must contain a register item ID");
|
|
18
|
+
return refs;
|
|
19
|
+
}
|
|
20
|
+
// Each operation gets a fresh snapshot. Other projects are read from the same local
|
|
21
|
+
// integration branches used to verify derived_from, never from unrelated worktrees.
|
|
22
|
+
function dependencyGraph(paths, replacement) {
|
|
23
|
+
const projects = new Map();
|
|
24
|
+
const local = new Map(loadRegisterItemDocs(paths.projectRegisterPath).map((doc) => [doc.id, doc.item]));
|
|
25
|
+
if (replacement)
|
|
26
|
+
local.set(replacement.id, replacement);
|
|
27
|
+
projects.set(paths.projectId, local);
|
|
28
|
+
const projectItems = (projectId) => {
|
|
29
|
+
const cached = projects.get(projectId);
|
|
30
|
+
if (cached)
|
|
31
|
+
return cached;
|
|
32
|
+
const { config } = loadConfig();
|
|
33
|
+
const project = config?.projects[projectId];
|
|
34
|
+
if (!project)
|
|
35
|
+
throw new Error(`depends_on: unknown project ${projectId}`);
|
|
36
|
+
const registerPath = getProjectRegisterPath(project);
|
|
37
|
+
if (!registerPath)
|
|
38
|
+
throw new Error(`depends_on: project_register_path is not set for ${projectId}`);
|
|
39
|
+
const root = specdojoRootDir();
|
|
40
|
+
const branch = resolveProjectIntegrationBranch(projectId, project);
|
|
41
|
+
if (gitResult(root, ["show-ref", "--verify", "--quiet", `refs/heads/${branch}`]).status !== 0) {
|
|
42
|
+
throw new Error(`depends_on: integration branch does not exist locally: ${branch}`);
|
|
43
|
+
}
|
|
44
|
+
const files = gitOutput(root, [
|
|
45
|
+
"ls-tree",
|
|
46
|
+
"-r",
|
|
47
|
+
"--name-only",
|
|
48
|
+
branch,
|
|
49
|
+
"--",
|
|
50
|
+
registerPath.replaceAll("\\", "/"),
|
|
51
|
+
]);
|
|
52
|
+
const items = new Map();
|
|
53
|
+
for (const file of files.split(/\r?\n/).filter(Boolean)) {
|
|
54
|
+
if (!/^pjr-[0-9a-z]{4}-.+\.md$/.test(basename(file)))
|
|
55
|
+
continue;
|
|
56
|
+
const parsed = readRegisterItemContent(gitOutput(root, ["show", `${branch}:${file}`]), basename(file));
|
|
57
|
+
if (parsed)
|
|
58
|
+
items.set(parsed.id, parsed.item);
|
|
59
|
+
}
|
|
60
|
+
projects.set(projectId, items);
|
|
61
|
+
return items;
|
|
62
|
+
};
|
|
63
|
+
const lookup = (ref, projectId) => {
|
|
64
|
+
const parsed = parseRegisterItemRef(ref, projectId);
|
|
65
|
+
if (!parsed)
|
|
66
|
+
throw new Error(`Invalid depends_on item ID: "${ref}". Use PJR-XXXX or <project-id>:PJR-XXXX`);
|
|
67
|
+
const item = projectItems(parsed.projectId).get(parsed.itemId);
|
|
68
|
+
if (!item)
|
|
69
|
+
throw new Error(`Depends-on item not found: ${ref} (searched configured project ${parsed.projectId})`);
|
|
70
|
+
return { ...parsed, key: `${parsed.projectId}:${parsed.itemId}`, item };
|
|
71
|
+
};
|
|
72
|
+
const visited = new Set();
|
|
73
|
+
const visiting = [];
|
|
74
|
+
const visit = (item, projectId) => {
|
|
75
|
+
const key = `${projectId}:${item.id}`;
|
|
76
|
+
if (visiting.includes(key))
|
|
77
|
+
throw new Error(`depends_on cycle: ${[...visiting, key].join(" -> ")}`);
|
|
78
|
+
if (visited.has(key))
|
|
79
|
+
return;
|
|
80
|
+
visiting.push(key);
|
|
81
|
+
for (const ref of item.dependsOn ?? []) {
|
|
82
|
+
const target = lookup(ref, projectId);
|
|
83
|
+
if (target.key === key)
|
|
84
|
+
throw new Error(`Item ${key} cannot depend on itself`);
|
|
85
|
+
visit(target.item, target.projectId);
|
|
86
|
+
}
|
|
87
|
+
visiting.pop();
|
|
88
|
+
visited.add(key);
|
|
89
|
+
};
|
|
90
|
+
return { local, lookup, visit };
|
|
91
|
+
}
|
|
92
|
+
export function validateRegisterDependencies(paths, replacement) {
|
|
93
|
+
const graph = dependencyGraph(paths, replacement);
|
|
94
|
+
for (const item of graph.local.values())
|
|
95
|
+
graph.visit(item, paths.projectId);
|
|
96
|
+
}
|
|
97
|
+
export function validateRegisterDependencyDocs(paths) {
|
|
98
|
+
try {
|
|
99
|
+
validateRegisterDependencies(paths);
|
|
100
|
+
return [];
|
|
101
|
+
}
|
|
102
|
+
catch (error) {
|
|
103
|
+
return [error instanceof Error ? error.message : String(error)];
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
export function registerDependencyBlockReason(paths, item) {
|
|
107
|
+
if (!item.dependsOn?.length)
|
|
108
|
+
return undefined;
|
|
109
|
+
try {
|
|
110
|
+
const graph = dependencyGraph(paths, item);
|
|
111
|
+
graph.visit(item, paths.projectId);
|
|
112
|
+
const pending = item.dependsOn.flatMap((ref) => {
|
|
113
|
+
const target = graph.lookup(ref, paths.projectId);
|
|
114
|
+
return ["done", "decided"].includes(target.item.status)
|
|
115
|
+
? []
|
|
116
|
+
: [`${ref} (${target.item.status})`];
|
|
117
|
+
});
|
|
118
|
+
return pending.length ? `Unfinished depends_on: ${pending.join(", ")}` : undefined;
|
|
119
|
+
}
|
|
120
|
+
catch (error) {
|
|
121
|
+
return error instanceof Error ? error.message : String(error);
|
|
122
|
+
}
|
|
123
|
+
}
|
|
@@ -147,11 +147,11 @@ function configuredExternalRegisterDirectories(paths) {
|
|
|
147
147
|
return existsSync(absolutePath) ? [{ projectId, registerPath: absolutePath }] : [];
|
|
148
148
|
});
|
|
149
149
|
}
|
|
150
|
-
export function collectDerivedRegisterRelations(paths, currentItems) {
|
|
150
|
+
export function collectDerivedRegisterRelations(paths, currentItems, relationField = "derivedFrom") {
|
|
151
151
|
const relations = [];
|
|
152
152
|
const collect = (projectId, items) => {
|
|
153
153
|
for (const item of items) {
|
|
154
|
-
for (const ref of item.item
|
|
154
|
+
for (const ref of item.item[relationField] ?? []) {
|
|
155
155
|
const source = parseRegisterItemRef(ref, projectId);
|
|
156
156
|
if (!source || source.projectId !== paths.projectId)
|
|
157
157
|
continue;
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
import { existsSync } from "node:fs";
|
|
2
|
+
import { join, resolve } from "node:path";
|
|
3
|
+
import { getProjectTimelinePath, loadConfig, specdojoRootDir } from "../shared/specdojo-config.js";
|
|
4
|
+
import { loadTimelineIndex } from "../shared/timeline-index.js";
|
|
5
|
+
import { loadRegisterItemDocs } from "./item.js";
|
|
6
|
+
// track は epic の担当単位。timeline がない project でも同じ形式の識別子を保持する。
|
|
7
|
+
export function validateRegisterTrack(projectId, itemType, track) {
|
|
8
|
+
if (itemType !== "epic") {
|
|
9
|
+
if (track !== undefined)
|
|
10
|
+
throw new Error("--track is only valid for epic items");
|
|
11
|
+
return;
|
|
12
|
+
}
|
|
13
|
+
if (!track || !/^[a-z0-9][a-z0-9-]*$/.test(track)) {
|
|
14
|
+
throw new Error("An epic requires --track with a lowercase track identifier");
|
|
15
|
+
}
|
|
16
|
+
const { config } = loadConfig();
|
|
17
|
+
const project = config?.projects[projectId];
|
|
18
|
+
if (!project)
|
|
19
|
+
throw new Error(`Cannot validate epic track: unknown project ${projectId}`);
|
|
20
|
+
const indexPath = resolve(specdojoRootDir(), getProjectTimelinePath(project), "tml-index.yaml");
|
|
21
|
+
if (!existsSync(indexPath))
|
|
22
|
+
return;
|
|
23
|
+
const { index, errors } = loadTimelineIndex(indexPath);
|
|
24
|
+
if (errors.length > 0)
|
|
25
|
+
throw new Error(`${indexPath}: ${errors.join("; ")}`);
|
|
26
|
+
if (!index.tracks.some((entry) => entry.track === track)) {
|
|
27
|
+
throw new Error(`Undefined epic track "${track}" in ${indexPath}`);
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
export function validateRegisterEpicDocs(paths) {
|
|
31
|
+
return loadRegisterItemDocs(paths.projectRegisterPath).flatMap((doc) => {
|
|
32
|
+
try {
|
|
33
|
+
validateRegisterTrack(paths.projectId, doc.item.type, doc.item.track);
|
|
34
|
+
return [];
|
|
35
|
+
}
|
|
36
|
+
catch (error) {
|
|
37
|
+
return [
|
|
38
|
+
`${join(paths.projectRegisterPath, doc.filename)}: ${error instanceof Error ? error.message : String(error)}`,
|
|
39
|
+
];
|
|
40
|
+
}
|
|
41
|
+
});
|
|
42
|
+
}
|
|
@@ -125,6 +125,8 @@ function fieldUpdateFromChange(change) {
|
|
|
125
125
|
switch (change.field) {
|
|
126
126
|
case "type":
|
|
127
127
|
return isUnset ? undefined : { item_type: value };
|
|
128
|
+
case "track":
|
|
129
|
+
return { track: isUnset ? REMOVE_REGISTER_ITEM_FIELD : value };
|
|
128
130
|
case "priority":
|
|
129
131
|
return isUnset ? undefined : { priority: value };
|
|
130
132
|
case "difficulty":
|
|
@@ -158,13 +160,14 @@ function fieldUpdateFromChange(change) {
|
|
|
158
160
|
return undefined;
|
|
159
161
|
}
|
|
160
162
|
}
|
|
163
|
+
case "depends_on":
|
|
161
164
|
case "derived_from": {
|
|
162
165
|
if (isUnset)
|
|
163
|
-
return {
|
|
166
|
+
return { [change.field]: REMOVE_REGISTER_ITEM_FIELD };
|
|
164
167
|
try {
|
|
165
168
|
const parsed = JSON.parse(value);
|
|
166
169
|
return Array.isArray(parsed) && parsed.every((ref) => typeof ref === "string")
|
|
167
|
-
? {
|
|
170
|
+
? { [change.field]: parsed }
|
|
168
171
|
: undefined;
|
|
169
172
|
}
|
|
170
173
|
catch {
|
package/dist/register/events.js
CHANGED
|
@@ -13,6 +13,7 @@ export const REGISTER_EVENT_FIELDS = [
|
|
|
13
13
|
"title",
|
|
14
14
|
"description",
|
|
15
15
|
"type",
|
|
16
|
+
"track",
|
|
16
17
|
"priority",
|
|
17
18
|
"difficulty",
|
|
18
19
|
"owner",
|
|
@@ -24,7 +25,10 @@ export const REGISTER_EVENT_FIELDS = [
|
|
|
24
25
|
"approach",
|
|
25
26
|
"targets",
|
|
26
27
|
"sources",
|
|
28
|
+
"target_path",
|
|
29
|
+
"target_rulebook",
|
|
27
30
|
"derived_from",
|
|
31
|
+
"depends_on",
|
|
28
32
|
"autopilot",
|
|
29
33
|
];
|
|
30
34
|
export const REGISTER_EVENT_ACTIONS = [
|
|
@@ -67,6 +71,7 @@ export function registerEventFieldValues(content, filename, timeZone) {
|
|
|
67
71
|
title: item.title,
|
|
68
72
|
description: item.description,
|
|
69
73
|
type: item.type,
|
|
74
|
+
track: item.track ?? CELL_NONE,
|
|
70
75
|
priority: item.priority,
|
|
71
76
|
difficulty: item.difficulty ?? CELL_NONE,
|
|
72
77
|
owner: item.owner,
|
|
@@ -77,8 +82,11 @@ export function registerEventFieldValues(content, filename, timeZone) {
|
|
|
77
82
|
block_reason: parsed.blockReason,
|
|
78
83
|
approach: item.approach ?? CELL_NONE,
|
|
79
84
|
targets: item.targets ? JSON.stringify(item.targets) : CELL_NONE,
|
|
85
|
+
target_path: item.targetPath ?? CELL_NONE,
|
|
86
|
+
target_rulebook: item.targetRulebook ?? CELL_NONE,
|
|
80
87
|
sources: item.sources ? JSON.stringify(item.sources) : CELL_NONE,
|
|
81
88
|
derived_from: item.derivedFrom ? JSON.stringify(item.derivedFrom) : CELL_NONE,
|
|
89
|
+
depends_on: item.dependsOn ? JSON.stringify(item.dependsOn) : CELL_NONE,
|
|
82
90
|
autopilot: item.autopilot ?? CELL_NONE,
|
|
83
91
|
};
|
|
84
92
|
}
|
|
@@ -40,6 +40,7 @@ export function buildExternalRegisterAddArgs(alias, externalProject, opts) {
|
|
|
40
40
|
"--conclusion",
|
|
41
41
|
opts.conclusion,
|
|
42
42
|
];
|
|
43
|
+
addValue(args, "--track", opts.track);
|
|
43
44
|
addValue(args, "--difficulty", opts.difficulty);
|
|
44
45
|
addValue(args, "--registered", opts.registered);
|
|
45
46
|
addValue(args, "--approach", opts.approach);
|
|
@@ -50,6 +51,9 @@ export function buildExternalRegisterAddArgs(alias, externalProject, opts) {
|
|
|
50
51
|
for (const source of opts.from ?? []) {
|
|
51
52
|
addValue(args, "--from", rewriteExternalDerivedFrom(source, alias, externalProject.project_id));
|
|
52
53
|
}
|
|
54
|
+
for (const predecessor of opts.dependsOn ?? []) {
|
|
55
|
+
addValue(args, "--depends-on", rewriteExternalDerivedFrom(predecessor, alias, externalProject.project_id));
|
|
56
|
+
}
|
|
53
57
|
addValue(args, "--id", opts.id);
|
|
54
58
|
addValue(args, "--topic", opts.topic);
|
|
55
59
|
addValue(args, "--by", opts.by);
|
package/dist/register/item.js
CHANGED
|
@@ -20,6 +20,7 @@ export const VALID_STATUSES = [
|
|
|
20
20
|
];
|
|
21
21
|
export const VALID_TYPES = [
|
|
22
22
|
"todo",
|
|
23
|
+
"epic",
|
|
23
24
|
"question",
|
|
24
25
|
"risk",
|
|
25
26
|
"issue",
|
|
@@ -57,6 +58,7 @@ const SPECDOJO_KEY_ORDER = [
|
|
|
57
58
|
"part_of",
|
|
58
59
|
"based_on",
|
|
59
60
|
"item_type",
|
|
61
|
+
"track",
|
|
60
62
|
"item_status",
|
|
61
63
|
"priority",
|
|
62
64
|
"difficulty",
|
|
@@ -67,10 +69,13 @@ const SPECDOJO_KEY_ORDER = [
|
|
|
67
69
|
"block_reason",
|
|
68
70
|
"conclusion",
|
|
69
71
|
"derived_from",
|
|
72
|
+
"depends_on",
|
|
70
73
|
"autopilot",
|
|
71
74
|
"approach",
|
|
72
75
|
"targets",
|
|
73
76
|
"sources",
|
|
77
|
+
"target_path",
|
|
78
|
+
"target_rulebook",
|
|
74
79
|
];
|
|
75
80
|
// ================================
|
|
76
81
|
// Derivation helpers
|
|
@@ -226,6 +231,9 @@ export function readRegisterItemContent(content, filename) {
|
|
|
226
231
|
const derivedFrom = Array.isArray(fields.derived_from)
|
|
227
232
|
? fields.derived_from.filter((entry) => typeof entry === "string" && entry.trim() !== "")
|
|
228
233
|
: undefined;
|
|
234
|
+
const dependsOn = Array.isArray(fields.depends_on)
|
|
235
|
+
? fields.depends_on.filter((value) => typeof value === "string" && value.trim() !== "")
|
|
236
|
+
: undefined;
|
|
229
237
|
const autopilot = fields.autopilot === "approved" ? "approved" : undefined;
|
|
230
238
|
const difficulty = asString(fields.difficulty);
|
|
231
239
|
const item = {
|
|
@@ -234,6 +242,7 @@ export function readRegisterItemContent(content, filename) {
|
|
|
234
242
|
title: titleFromBody(body, id),
|
|
235
243
|
description: descriptionFromBody(body),
|
|
236
244
|
type: asString(fields.item_type) ?? CELL_TODO,
|
|
245
|
+
...(asString(fields.track) ? { track: asString(fields.track) } : {}),
|
|
237
246
|
priority: asString(fields.priority) ?? "medium",
|
|
238
247
|
...(difficulty ? { difficulty } : {}),
|
|
239
248
|
owner: asString(fields.owner) ?? CELL_TODO,
|
|
@@ -246,9 +255,14 @@ export function readRegisterItemContent(content, filename) {
|
|
|
246
255
|
conclusion: asString(fields.conclusion) ?? CELL_NONE,
|
|
247
256
|
ticket: ticketRefCell(filename),
|
|
248
257
|
...(approach ? { approach } : {}),
|
|
258
|
+
...(asString(fields.target_path) ? { targetPath: asString(fields.target_path) } : {}),
|
|
259
|
+
...(asString(fields.target_rulebook)
|
|
260
|
+
? { targetRulebook: asString(fields.target_rulebook) }
|
|
261
|
+
: {}),
|
|
249
262
|
...(targets && targets.length > 0 ? { targets } : {}),
|
|
250
263
|
...(sources && sources.length > 0 ? { sources } : {}),
|
|
251
264
|
...(derivedFrom && derivedFrom.length > 0 ? { derivedFrom } : {}),
|
|
265
|
+
...(dependsOn && dependsOn.length > 0 ? { dependsOn } : {}),
|
|
252
266
|
...(autopilot ? { autopilot } : {}),
|
|
253
267
|
};
|
|
254
268
|
return {
|
|
@@ -370,10 +384,14 @@ export function registerItemFieldsFromItem(item) {
|
|
|
370
384
|
conclusion: isPlaceholderCell(item.conclusion)
|
|
371
385
|
? null
|
|
372
386
|
: inlineCodeAnglePlaceholders(item.conclusion.trim()),
|
|
387
|
+
...(item.track ? { track: item.track } : {}),
|
|
373
388
|
...(item.approach ? { approach: item.approach } : {}),
|
|
389
|
+
...(item.targetPath ? { target_path: item.targetPath } : {}),
|
|
390
|
+
...(item.targetRulebook ? { target_rulebook: item.targetRulebook } : {}),
|
|
374
391
|
...(item.targets && item.targets.length > 0 ? { targets: item.targets } : {}),
|
|
375
392
|
...(item.sources && item.sources.length > 0 ? { sources: item.sources } : {}),
|
|
376
393
|
...(item.derivedFrom && item.derivedFrom.length > 0 ? { derived_from: item.derivedFrom } : {}),
|
|
394
|
+
...(item.dependsOn && item.dependsOn.length > 0 ? { depends_on: item.dependsOn } : {}),
|
|
377
395
|
...(item.autopilot ? { autopilot: item.autopilot } : {}),
|
|
378
396
|
};
|
|
379
397
|
}
|
|
@@ -4,6 +4,8 @@ import { createGitTimestampResolver, planRegisterTimestampMigration, summarizeTi
|
|
|
4
4
|
import { registerEventFilePath, validateRegisterEventDocs } from "./events.js";
|
|
5
5
|
import { validateRegisterItemDocs } from "./item.js";
|
|
6
6
|
import { specdojoRootDir } from "../shared/specdojo-config.js";
|
|
7
|
+
import { validateRegisterDependencyDocs } from "./dependency.js";
|
|
8
|
+
import { validateRegisterEpicDocs } from "./epic.js";
|
|
7
9
|
import { validateDerivedFromDocs } from "./derivation.js";
|
|
8
10
|
export function registerMaintenanceCommands(reg, dependencies) {
|
|
9
11
|
const { addProjectOption, addRegisterCommitOptions, applyRegisterMigrationPlan, generateDerivedViewFiles, loadItemForUpdate, migrateEmbeddedRegisterEvents, migrateRegisterEventsFromGit, parseHistoryIds, planRegisterMigration, planRenumber, printCommandError, registerEventActor, renumberPjrItem, repoRelativePathspec, resolveRegisterPaths, runRegisterMutation, validBuildScopes, writeDerivedViews, } = dependencies;
|
|
@@ -87,7 +89,11 @@ export function registerMaintenanceCommands(reg, dependencies) {
|
|
|
87
89
|
throw new Error(`Invalid scope: "${opts.scope}". Must be one of: ${validBuildScopes.join(", ")}`);
|
|
88
90
|
}
|
|
89
91
|
const validation = validateRegisterItemDocs(paths.projectRegisterPath);
|
|
90
|
-
const derivationErrors =
|
|
92
|
+
const derivationErrors = [
|
|
93
|
+
...validateDerivedFromDocs(paths),
|
|
94
|
+
...validateRegisterEpicDocs(paths),
|
|
95
|
+
...validateRegisterDependencyDocs(paths),
|
|
96
|
+
];
|
|
91
97
|
const eventErrors = validateRegisterEventDocs(paths.projectRegisterPath, paths.registerDateTimeZone);
|
|
92
98
|
if (validation.errors.length > 0 || derivationErrors.length > 0 || eventErrors.length > 0) {
|
|
93
99
|
throw new Error(`Invalid register item files:\n${[
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import { existsSync } from "node:fs";
|
|
2
|
+
import { join, resolve } from "node:path";
|
|
3
|
+
import { getProjectCatalogPath, getProjectTimelinePath, } from "../shared/specdojo-config.js";
|
|
4
|
+
import { loadTimelineIndex } from "../shared/timeline-index.js";
|
|
5
|
+
export function isPlanningApproach(approach) {
|
|
6
|
+
return approach === "catalog-planning" || approach === "strategy-planning";
|
|
7
|
+
}
|
|
8
|
+
// These targets identify work units, including units whose documents do not exist yet.
|
|
9
|
+
export function planningTarget(approach, target) {
|
|
10
|
+
const prefix = approach === "catalog-planning" ? "domain" : "track";
|
|
11
|
+
const match = target.match(new RegExp(`^${prefix}:([a-z0-9][a-z0-9-]{0,62})$`));
|
|
12
|
+
if (!match)
|
|
13
|
+
throw new Error(`Approach "${approach}" requires --target ${prefix}:<id>`);
|
|
14
|
+
return match[1];
|
|
15
|
+
}
|
|
16
|
+
export function validatePlanningTarget(opts) {
|
|
17
|
+
const unit = planningTarget(opts.approach, opts.target);
|
|
18
|
+
if (!getProjectCatalogPath(opts.project)) {
|
|
19
|
+
throw new Error(`Approach "${opts.approach}" requires catalog_path`);
|
|
20
|
+
}
|
|
21
|
+
if (opts.approach !== "strategy-planning")
|
|
22
|
+
return;
|
|
23
|
+
if (!opts.project.schedule_path?.trim()) {
|
|
24
|
+
throw new Error('Approach "strategy-planning" requires schedule_path');
|
|
25
|
+
}
|
|
26
|
+
const file = resolve(opts.repoRoot, getProjectTimelinePath(opts.project), "tml-index.yaml");
|
|
27
|
+
if (!existsSync(file)) {
|
|
28
|
+
// A declared strategy scope also supports projects without a timeline.
|
|
29
|
+
return;
|
|
30
|
+
}
|
|
31
|
+
const { index, errors } = loadTimelineIndex(file);
|
|
32
|
+
if (errors.length > 0)
|
|
33
|
+
throw new Error(`${file}: ${errors.join("; ")}`);
|
|
34
|
+
if (!index.tracks.some((track) => track.track === unit)) {
|
|
35
|
+
throw new Error(`Undefined strategy track "${unit}" in ${join(getProjectTimelinePath(opts.project), "tml-index.yaml")}`);
|
|
36
|
+
}
|
|
37
|
+
}
|
|
@@ -6,6 +6,7 @@ import { inlineCodeAnglePlaceholders } from "../shared/text.js";
|
|
|
6
6
|
import { atomicWriteFile, buildRegisterItemContent, derivedTopicNeedsWarning, generatePjrId, printDerivedTopicWarning, registerEventActor, REGISTER_TOPIC_RE, resolveRegisterPaths, slugify, validateFields, } from "./core.js";
|
|
7
7
|
import { registerCreateCommands, registerUpdateCommand } from "./create-commands.js";
|
|
8
8
|
import { normalizeRegisterTimestamp } from "./date.js";
|
|
9
|
+
import { validateRegisterDependencyDocs } from "./dependency.js";
|
|
9
10
|
import { validateDerivedFromDocs } from "./derivation.js";
|
|
10
11
|
import { appendRegisterEvent, deterministicRegisterEventId, readEmbeddedRegisterEvents, readRegisterEventsFromContent, registerEventFilePath, removeEmbeddedRegisterEvents, serializeRegisterEvents, validateRegisterEventDocs, } from "./events.js";
|
|
11
12
|
import { collectRegisterHistoryEvents } from "./history.js";
|
|
@@ -82,7 +83,10 @@ function defaultRegisterCommitMessage(command, result) {
|
|
|
82
83
|
}
|
|
83
84
|
function rebuildRegisterViews(paths) {
|
|
84
85
|
const validation = validateRegisterItemDocs(paths.projectRegisterPath);
|
|
85
|
-
const derivationErrors =
|
|
86
|
+
const derivationErrors = [
|
|
87
|
+
...validateDerivedFromDocs(paths),
|
|
88
|
+
...validateRegisterDependencyDocs(paths),
|
|
89
|
+
];
|
|
86
90
|
const eventErrors = validateRegisterEventDocs(paths.projectRegisterPath, paths.registerDateTimeZone);
|
|
87
91
|
if (validation.errors.length > 0 || derivationErrors.length > 0 || eventErrors.length > 0) {
|
|
88
92
|
throw new Error(`Invalid register item files:\n${[
|