specdojo 0.7.0 → 0.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.github/agents/specdojo-orchestrator.md +7 -3
- package/CHANGELOG.md +217 -0
- package/dist/catalog/build.js +24 -1
- package/dist/catalog/catalog.js +16 -14
- package/dist/catalog/plan.js +1 -1
- package/dist/catalog/scaffold.js +4 -1
- package/dist/commands/agent.js +5 -3
- package/dist/commands/build.js +69 -10
- package/dist/commands/git.js +206 -0
- package/dist/commands/init.js +9 -3
- package/dist/commands/night-orchestrator.js +6 -4
- package/dist/commands/where.js +25 -0
- package/dist/dashboard/dashboard-timeline.js +18 -16
- package/dist/dashboard/dashboard.js +616 -261
- package/dist/dashboard/epic-plan.js +81 -0
- package/dist/dashboard/exec-records.js +16 -20
- package/dist/dashboard/routines.js +11 -12
- package/dist/dashboard/timeline-build.js +5 -9
- package/dist/dashboard/timeline.js +23 -18
- package/dist/devcontainer/scaffold.js +18 -0
- package/dist/docs/frontmatter-namespace.js +1 -48
- package/dist/docs/index-command.js +2 -2
- package/dist/docs/yaml-business-tables.js +243 -0
- package/dist/docs/yaml-interface-tables.js +106 -0
- package/dist/docs/yaml-pages-command.js +5 -3
- package/dist/docs/yaml-pages.js +268 -3
- package/dist/docs/yaml-table-shared.js +70 -0
- package/dist/docs/yaml-tables.js +39 -0
- package/dist/exec/agent-config.js +31 -0
- package/dist/exec/agent-plan.js +3 -2
- package/dist/exec/agent-protected-config.js +2 -0
- package/dist/exec/commands.js +100 -39
- package/dist/exec/commit-hook-skips.js +78 -0
- package/dist/exec/core.js +19 -7
- package/dist/exec/events.js +179 -8
- package/dist/exec/evidence.js +77 -19
- package/dist/exec/handoff.js +9 -13
- package/dist/exec/limit.js +1 -1
- package/dist/exec/mechanical-result.js +45 -0
- package/dist/exec/migrate-records.js +249 -0
- package/dist/exec/parent-validation.js +209 -15
- package/dist/exec/pipeline-state.js +27 -5
- package/dist/exec/plans-condense-findings.js +89 -0
- package/dist/exec/plans-core.js +45 -19
- package/dist/exec/plans-generation.js +52 -30
- package/dist/exec/plans-grade-findings.js +8 -3
- package/dist/exec/plans-kata-findings.js +61 -0
- package/dist/exec/plans-planning.js +3 -3
- package/dist/exec/plans-storage.js +12 -24
- package/dist/exec/post-integration.js +162 -0
- package/dist/exec/queue-command.js +166 -0
- package/dist/exec/queue.js +285 -0
- package/dist/exec/register-foreign-wait.js +84 -0
- package/dist/exec/register-resume.js +55 -56
- package/dist/exec/register.js +26 -22
- package/dist/exec/repo-integration-sync.js +21 -5
- package/dist/exec/repo-integration.js +21 -1
- package/dist/exec/reporter.js +121 -23
- package/dist/exec/results.js +106 -25
- package/dist/exec/review-completion.js +47 -0
- package/dist/exec/review-kata.js +112 -0
- package/dist/exec/run/agent-pipeline.js +78 -8
- package/dist/exec/run/agent.js +32 -13
- package/dist/exec/run/change-scope.js +365 -0
- package/dist/exec/run/deferred-cleanup.js +31 -0
- package/dist/exec/run/in-place.js +73 -33
- package/dist/exec/run/job-lock.js +66 -0
- package/dist/exec/run/job-sequence.js +137 -0
- package/dist/exec/run/job.js +135 -41
- package/dist/exec/run/lifecycle-commands.js +189 -37
- package/dist/exec/run/lock.js +22 -1
- package/dist/exec/run/mode-shared.js +11 -3
- package/dist/exec/run/register-command.js +14 -15
- package/dist/exec/run/register-core.js +20 -13
- package/dist/exec/run/register-mode.js +77 -17
- package/dist/exec/run/register-post-review.js +21 -9
- package/dist/exec/run/register-resume.js +95 -31
- package/dist/exec/run/register-state.js +23 -15
- package/dist/exec/run/register-worktree.js +184 -139
- package/dist/exec/run/schedule-mode.js +79 -18
- package/dist/exec/run/schedule-prepare.js +204 -59
- package/dist/exec/run/schedule-task.js +203 -49
- package/dist/exec/run/shared.js +9 -3
- package/dist/exec/run/trailing-records.js +35 -0
- package/dist/exec/run-records.js +2 -0
- package/dist/exec/schedule/schedule.js +116 -4
- package/dist/exec/shared.js +1 -1
- package/dist/exec/smoke.js +190 -0
- package/dist/exec/strategy.js +14 -3
- package/dist/exec/task-view.js +6 -4
- package/dist/exec/trailing-records.js +242 -0
- package/dist/exec/trial-commands.js +8 -4
- package/dist/exec/trial-core.js +6 -1
- package/dist/exec/validate-records-commit.js +110 -0
- package/dist/exec/validate-records.js +148 -0
- package/dist/exec/validation-metrics.js +181 -0
- package/dist/exec/worktree-cleanup-lock.js +26 -0
- package/dist/exec/worktree-command.js +38 -17
- package/dist/exec/worktree-ops-commit.js +119 -48
- package/dist/exec/worktree-ops-lifecycle.js +77 -48
- package/dist/exec/worktree-ops-merge.js +13 -2
- package/dist/exec/worktree-ops.js +2 -2
- package/dist/exec/worktree.js +32 -4
- package/dist/grade/apply.js +32 -6
- package/dist/grade/command-apply.js +3 -3
- package/dist/grade/command-inspect.js +7 -5
- package/dist/grade/command-plan.js +1 -1
- package/dist/grade/command-run.js +7 -1
- package/dist/grade/command-shared.js +1 -1
- package/dist/grade/core.js +18 -5
- package/dist/grade/markdown.js +3 -3
- package/dist/grade/pipeline-state.js +15 -11
- package/dist/grade/plan.js +37 -17
- package/dist/grade/result.js +3 -3
- package/dist/grade/run.js +87 -11
- package/dist/grade/target-discovery.js +17 -4
- package/dist/grade/targets.js +12 -11
- package/dist/job/definition.js +84 -8
- package/dist/job/job.js +109 -39
- package/dist/job/noop.js +104 -0
- package/dist/register/authoring-sources.js +22 -16
- package/dist/register/core.js +2 -0
- package/dist/register/create-commands.js +28 -3
- package/dist/register/deliverable-target.js +9 -1
- package/dist/register/epic.js +104 -26
- package/dist/register/event-merge.js +3 -0
- package/dist/register/events.js +4 -0
- package/dist/register/external-project.js +3 -0
- package/dist/register/item.js +6 -0
- package/dist/register/maintenance-commands.js +6 -3
- package/dist/register/planning.js +7 -14
- package/dist/register/register.js +74 -16
- package/dist/register/track-domains.js +34 -0
- package/dist/register/track-plan.js +78 -0
- package/dist/register/transition-commands.js +8 -0
- package/dist/register/work-table.js +64 -0
- package/dist/review/grade.js +35 -13
- package/dist/routine/definition.js +13 -3
- package/dist/routine/failure.js +30 -0
- package/dist/routine/routine.js +189 -71
- package/dist/routine/status.js +62 -0
- package/dist/routine/storage.js +33 -0
- package/dist/schedule/schedule.js +39 -39
- package/dist/schedule/strategy-generate-document.js +26 -14
- package/dist/schedule/strategy-generate-scope.js +17 -45
- package/dist/schedule/strategy-generate.js +33 -3
- package/dist/schedule/strategy-profiles.js +86 -12
- package/dist/shared/agent-types.js +7 -0
- package/dist/shared/condense-records.js +25 -0
- package/dist/shared/cross-process-lock.js +9 -1
- package/dist/shared/deprecation.js +8 -0
- package/dist/shared/dist-freshness.js +8 -2
- package/dist/shared/document-metadata.js +20 -0
- package/dist/shared/finding-cause.js +20 -0
- package/dist/shared/frontmatter-namespace.js +48 -0
- package/dist/shared/git-environment.js +2 -1
- package/dist/shared/git.js +186 -16
- package/dist/shared/grade-result.js +17 -1
- package/dist/shared/lefthook-scaffold.js +3 -0
- package/dist/shared/local-config.js +244 -0
- package/dist/shared/local-state.js +20 -0
- package/dist/shared/markdownlint-config.js +8 -3
- package/dist/shared/plan-conventions.js +129 -0
- package/dist/shared/plan-templates.js +57 -41
- package/dist/shared/run-records.js +224 -0
- package/dist/shared/specdojo-config.js +73 -41
- package/dist/shared/specdojo-gitignore.js +1 -0
- package/dist/shared/text.js +74 -6
- package/dist/shared/timeline-index.js +2 -0
- package/dist/shared/where-alias.js +13 -0
- package/dist/specdojo.js +4 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +11 -2
- package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +4 -74
- package/docs/ja/specdojo/exec-templates/xep-condense-template.md +50 -0
- package/docs/ja/specdojo/exec-templates/xep-draft-template.md +17 -5
- package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +16 -3
- package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +15 -5
- package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-register-template.md +1 -1
- package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +6 -0
- package/docs/ja/specdojo/exec-templates/xer-condense-template.md +25 -0
- package/docs/ja/specdojo/exec-templates/xp-common-conventions-template.md +50 -0
- package/docs/ja/specdojo/exec-templates/xrp-common-conventions-template.md +30 -0
- package/docs/ja/specdojo/guides/branch-workflow-guide.md +1 -1
- package/docs/ja/specdojo/guides/docs-editing-guide.md +12 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +48 -15
- package/docs/ja/specdojo/guides/exec-config-guide.md +69 -19
- package/docs/ja/specdojo/guides/exec-operation-guide.md +97 -18
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +20 -11
- package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +92 -55
- package/docs/ja/specdojo/guides/project-move-guide.md +381 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +73 -17
- package/docs/ja/specdojo/guides/register-operation-guide.md +26 -6
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +2 -0
- package/docs/ja/specdojo/guides/review-guide.md +22 -19
- package/docs/ja/specdojo/guides/routine-operation-guide.md +23 -12
- package/docs/ja/specdojo/guides/ryu-guide.md +23 -13
- package/docs/ja/specdojo/guides/schedule-design-guide.md +27 -21
- package/docs/ja/specdojo/guides/schedule-operation-guide.md +27 -3
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +5 -4
- package/docs/ja/specdojo/guides/timeline-design-guide.md +27 -144
- package/docs/ja/specdojo/guides/use-case-guide.md +92 -155
- package/docs/ja/specdojo/guides/waza-guide.md +12 -8
- package/docs/ja/specdojo/recipes/bac-recipe.md +111 -0
- package/docs/ja/specdojo/recipes/bes-recipe.md +141 -0
- package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
- package/docs/ja/specdojo/recipes/br-recipe.md +77 -0
- package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
- package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +92 -99
- package/docs/ja/specdojo/recipes/cnd-recipe.md +135 -0
- package/docs/ja/specdojo/recipes/cpd-recipe.md +140 -0
- package/docs/ja/specdojo/recipes/cxd-recipe.md +162 -0
- package/docs/ja/specdojo/recipes/ifd-recipe.md +145 -0
- package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +112 -90
- package/docs/ja/specdojo/recipes/ifx-index-recipe.md +164 -0
- package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
- package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
- package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -48
- package/docs/ja/specdojo/recipes/pm-plan-recipe.md +72 -50
- package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +40 -49
- package/docs/ja/specdojo/recipes/pm-raci-recipe.md +42 -48
- package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -81
- package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -91
- package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
- package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -156
- package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
- package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
- package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
- package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
- package/docs/ja/specdojo/recipes/stsd-recipe.md +88 -80
- package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +129 -0
- package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +146 -0
- package/docs/ja/specdojo/recipes/sysd-index-recipe.md +141 -0
- package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
- package/docs/ja/specdojo/references/command-reference.md +303 -148
- package/docs/ja/specdojo/references/deliverables-reference.md +30 -16
- package/docs/ja/specdojo/references/directory-layout-reference.md +3 -2
- package/docs/ja/specdojo/references/specdojo-config-reference.md +54 -18
- package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
- package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +63 -290
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +162 -80
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +118 -155
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +128 -60
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +70 -94
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +58 -103
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +103 -223
- package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +51 -55
- package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +81 -68
- package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +139 -0
- package/docs/ja/specdojo/rulebooks/cld-rulebook.md +9 -184
- package/docs/ja/specdojo/rulebooks/clis-rulebook.md +170 -0
- package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +79 -249
- package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
- package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
- package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +79 -249
- package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +115 -256
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +79 -109
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +119 -174
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +6 -14
- package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
- package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
- package/docs/ja/specdojo/rulebooks/dss-rulebook.md +171 -0
- package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
- package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +93 -57
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +63 -253
- package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +79 -76
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +182 -237
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +111 -40
- package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +23 -46
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +16 -40
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
- package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
- package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
- package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +12 -23
- package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
- package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
- package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
- package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
- package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
- package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
- package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
- package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
- package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
- package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
- package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
- package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
- package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
- package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
- package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
- package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +92 -102
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
- package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
- package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +45 -59
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +56 -66
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +54 -62
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +46 -65
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +65 -97
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +6 -18
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +48 -78
- package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +61 -153
- package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
- package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
- package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
- package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
- package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +106 -32
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +111 -61
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +129 -59
- package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
- package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +46 -40
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +104 -68
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +64 -330
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +70 -263
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +58 -200
- package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +4 -9
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -71
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
- package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
- package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
- package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +91 -161
- package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
- package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
- package/docs/ja/specdojo/samples/bac-sample.md +106 -21
- package/docs/ja/specdojo/samples/bdd-sample.yaml +143 -35
- package/docs/ja/specdojo/samples/bds-sample.md +87 -21
- package/docs/ja/specdojo/samples/bes-index-sample.md +42 -20
- package/docs/ja/specdojo/samples/bes-sample.md +70 -21
- package/docs/ja/specdojo/samples/bps-sample.md +42 -54
- package/docs/ja/specdojo/samples/br-sample.md +57 -15
- package/docs/ja/specdojo/samples/ccd-sample.md +80 -19
- package/docs/ja/specdojo/samples/cdfd-sample.md +172 -99
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +9 -7
- package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
- package/docs/ja/specdojo/samples/cdsd-sample.md +73 -20
- package/docs/ja/specdojo/samples/cdt-sample.md +116 -0
- package/docs/ja/specdojo/samples/cld-sample.md +3 -30
- package/docs/ja/specdojo/samples/clis-sample.md +125 -0
- package/docs/ja/specdojo/samples/cnd-sample.md +127 -21
- package/docs/ja/specdojo/samples/cpd-sample.md +136 -22
- package/docs/ja/specdojo/samples/cxd-sample.md +108 -22
- package/docs/ja/specdojo/samples/dct-index-sample.yaml +63 -17
- package/docs/ja/specdojo/samples/dec-sample.md +2 -3
- package/docs/ja/specdojo/samples/dss-sample.md +175 -0
- package/docs/ja/specdojo/samples/gl-sample.yaml +50 -14
- package/docs/ja/specdojo/samples/ifd-sample.md +105 -21
- package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
- package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +91 -60
- package/docs/ja/specdojo/samples/ifx-file-sample.md +462 -21
- package/docs/ja/specdojo/samples/ifx-index-sample.yaml +87 -19
- package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
- package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
- package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
- package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
- package/docs/ja/specdojo/samples/pm-members-sample.yaml +37 -13
- package/docs/ja/specdojo/samples/pm-organization-sample.md +42 -21
- package/docs/ja/specdojo/samples/pm-plan-sample.md +78 -26
- package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +41 -22
- package/docs/ja/specdojo/samples/pm-raci-sample.md +63 -28
- package/docs/ja/specdojo/samples/pm-roles-sample.yaml +13 -12
- package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +33 -25
- package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
- package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +83 -62
- package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
- package/docs/ja/specdojo/samples/sf-index-sample.md +47 -20
- package/docs/ja/specdojo/samples/sf-sample.md +109 -21
- package/docs/ja/specdojo/samples/sld-sample.md +88 -21
- package/docs/ja/specdojo/samples/stsd-sample.md +54 -26
- package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +166 -21
- package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +178 -21
- package/docs/ja/specdojo/samples/sysd-index-sample.md +82 -21
- package/docs/ja/specdojo/samples/tml-sample.yaml +4 -1
- package/docs/ja/specdojo/samples/uis-sample.md +141 -20
- package/docs/ja/specdojo/standards/document-metadata-standard.md +33 -4
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +3 -1
- package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +1 -0
- package/docs/ja/specdojo/templates/bac-template.md +76 -0
- package/docs/ja/specdojo/templates/bes-template.md +56 -0
- package/docs/ja/specdojo/templates/br-template.md +64 -0
- package/docs/ja/specdojo/templates/cdfd-template.md +81 -54
- package/docs/ja/specdojo/templates/cdfd-uc-template.md +9 -5
- package/docs/ja/specdojo/templates/cdr-template.md +58 -0
- package/docs/ja/specdojo/templates/cnd-template.md +137 -0
- package/docs/ja/specdojo/templates/cpd-template.md +129 -0
- package/docs/ja/specdojo/templates/cxd-template.md +105 -0
- package/docs/ja/specdojo/templates/dct-data-model-cdt-template.yaml +40 -0
- package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +7 -14
- package/docs/ja/specdojo/templates/dct-index-template.md +9 -20
- package/docs/ja/specdojo/templates/dct-project-management-template.yaml +5 -1
- package/docs/ja/specdojo/templates/ifd-template.md +86 -0
- package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +44 -28
- package/docs/ja/specdojo/templates/ifx-index-template.yaml +40 -0
- package/docs/ja/specdojo/templates/opr-template.md +2 -4
- package/docs/ja/specdojo/templates/pm-organization-template.md +9 -3
- package/docs/ja/specdojo/templates/pm-plan-template.md +4 -4
- package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +17 -9
- package/docs/ja/specdojo/templates/pm-raci-template.md +24 -13
- package/docs/ja/specdojo/templates/pm-roles-template.yaml +3 -2
- package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +6 -3
- package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +22 -19
- package/docs/ja/specdojo/templates/stsd-template.md +46 -21
- package/docs/ja/specdojo/templates/sysd-critical-flows-template.md +94 -0
- package/docs/ja/specdojo/templates/sysd-cross-cutting-policy-template.md +122 -0
- package/docs/ja/specdojo/templates/sysd-index-template.md +89 -0
- package/docs/specdojo/lib/yaml-metadata.cjs +7 -0
- package/docs/specdojo/schemas/v1/bdd.schema.yaml +25 -57
- package/docs/specdojo/schemas/v1/condense-records.schema.yaml +26 -0
- package/docs/specdojo/schemas/v1/dct.schema.yaml +10 -0
- package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +3 -0
- package/docs/specdojo/schemas/v1/esil.schema.yaml +7 -141
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +5 -1
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +95 -8
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +38 -0
- package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +14 -0
- package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +18 -0
- package/docs/specdojo/schemas/v1/finding-cause.schema.yaml +22 -0
- package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/grade-result.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +65 -5
- package/docs/specdojo/schemas/v1/ifx-index.schema.yaml +142 -0
- package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
- package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +2 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +17 -1
- package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
- package/package.json +10 -7
- package/templates/antigravity/orchestrator.md +7 -3
- package/templates/claude/agents/specdojo-orchestrator.md +7 -3
- package/templates/codex/agents/specdojo-orchestrator.toml +7 -3
- package/templates/codex/orchestrator.md +7 -3
- package/templates/devcontainer/tmux.conf +6 -0
- package/templates/init-exec-defaults.yaml +13 -0
- package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +8 -4
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
import { existsSync, readFileSync } from "node:fs";
|
|
2
|
+
import { addWorkingDaysToDate, isWorkingDateUtc } from "../exec/schedule/calendar.js";
|
|
3
|
+
import { epicPredecessors, hasReversedEpicDates, orderEpics } from "../register/epic.js";
|
|
4
|
+
import { registerDateFromTimestamp } from "../register/date.js";
|
|
5
|
+
import { loadRegisterItemDocs } from "../register/item.js";
|
|
6
|
+
import { readRegisterEventsFromContent, registerEventFilePath } from "../register/events.js";
|
|
7
|
+
export function computeEpicSchedules(opts) {
|
|
8
|
+
const epics = orderEpics(opts.items, opts.projectId);
|
|
9
|
+
const byId = new Map(epics.map((item) => [item.id, item]));
|
|
10
|
+
const rows = new Map();
|
|
11
|
+
for (const item of epics) {
|
|
12
|
+
const predecessors = epicPredecessors(item, opts.projectId, byId);
|
|
13
|
+
const actualStart = opts.starts.get(item.id);
|
|
14
|
+
const completed = ["done", "decided", "rejected"].includes(item.status);
|
|
15
|
+
let endDate = completed
|
|
16
|
+
? registerDateFromTimestamp(item.completedAt, opts.timeZone)
|
|
17
|
+
: /^\d{4}-\d{2}-\d{2}$/.test(item.due)
|
|
18
|
+
? item.due
|
|
19
|
+
: undefined;
|
|
20
|
+
let startDate = item.startOn ??
|
|
21
|
+
(actualStart ? registerDateFromTimestamp(actualStart, opts.timeZone) : undefined);
|
|
22
|
+
if (!startDate && predecessors.length > 0) {
|
|
23
|
+
const ends = predecessors.map((p) => rows.get(p.id)?.endDate);
|
|
24
|
+
if (ends.every((end) => end !== undefined)) {
|
|
25
|
+
startDate = addWorkingDaysToDate(ends.sort().at(-1), 1, opts.calendar);
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
if (hasReversedEpicDates(item) || (startDate && endDate && startDate > endDate)) {
|
|
29
|
+
startDate = undefined;
|
|
30
|
+
endDate = undefined;
|
|
31
|
+
}
|
|
32
|
+
// Unknown start/end stays unknown; do not fabricate a date or propagate it downstream.
|
|
33
|
+
let estimateDays;
|
|
34
|
+
if (startDate && endDate && endDate >= startDate) {
|
|
35
|
+
estimateDays = 0;
|
|
36
|
+
const cursor = new Date(`${startDate}T00:00:00Z`);
|
|
37
|
+
const end = new Date(`${endDate}T00:00:00Z`);
|
|
38
|
+
while (cursor <= end) {
|
|
39
|
+
if (isWorkingDateUtc(cursor, opts.calendar))
|
|
40
|
+
estimateDays += 1;
|
|
41
|
+
cursor.setUTCDate(cursor.getUTCDate() + 1);
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
rows.set(item.id, {
|
|
45
|
+
id: item.id,
|
|
46
|
+
title: item.title,
|
|
47
|
+
itemStatus: item.status,
|
|
48
|
+
track: item.track,
|
|
49
|
+
domains: item.domains ?? [],
|
|
50
|
+
status: completed ? "primary" : item.status === "open" ? "not_started" : "draft",
|
|
51
|
+
order: rows.size + 1,
|
|
52
|
+
wave: 1 + Math.max(0, ...predecessors.map((p) => rows.get(p.id)?.wave ?? 0)),
|
|
53
|
+
depends_on: predecessors.map((p) => p.track),
|
|
54
|
+
startDate,
|
|
55
|
+
endDate: endDate === "-" || endDate === "_TODO_" ? undefined : endDate,
|
|
56
|
+
estimateDays,
|
|
57
|
+
});
|
|
58
|
+
}
|
|
59
|
+
const schedule = [...rows.values()];
|
|
60
|
+
const plannedStartDate = schedule
|
|
61
|
+
.flatMap((row) => (row.startDate ? [row.startDate] : []))
|
|
62
|
+
.sort()[0];
|
|
63
|
+
return { schedule, plannedStartDate };
|
|
64
|
+
}
|
|
65
|
+
export function loadEpicSchedules(opts) {
|
|
66
|
+
const items = loadRegisterItemDocs(opts.registerPath).map((doc) => doc.item);
|
|
67
|
+
const starts = new Map();
|
|
68
|
+
for (const item of items.filter((item) => item.type === "epic")) {
|
|
69
|
+
const file = registerEventFilePath(opts.registerPath, item.id);
|
|
70
|
+
const events = existsSync(file)
|
|
71
|
+
? readRegisterEventsFromContent(readFileSync(file, "utf8"), file)
|
|
72
|
+
: [];
|
|
73
|
+
const start = events
|
|
74
|
+
.filter((event) => event.action === "start")
|
|
75
|
+
.map((event) => event.ts)
|
|
76
|
+
.sort()[0];
|
|
77
|
+
if (start)
|
|
78
|
+
starts.set(item.id, start);
|
|
79
|
+
}
|
|
80
|
+
return computeEpicSchedules({ ...opts, items, starts });
|
|
81
|
+
}
|
|
@@ -1,5 +1,6 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import {
|
|
1
|
+
import { readFileSync } from "node:fs";
|
|
2
|
+
import { dirname, relative } from "node:path";
|
|
3
|
+
import { executionRecordLink, listRunRecords } from "../exec/run-records.js";
|
|
3
4
|
import { load } from "../shared/yaml.js";
|
|
4
5
|
import { sanitizeDashboardCell } from "./shared.js";
|
|
5
6
|
export const EXEC_RECORDS_FILE = "exec-records.md";
|
|
@@ -29,14 +30,7 @@ function frontmatterText(value) {
|
|
|
29
30
|
return value.toISOString();
|
|
30
31
|
return undefined;
|
|
31
32
|
}
|
|
32
|
-
|
|
33
|
-
if (!existsSync(dir))
|
|
34
|
-
return [];
|
|
35
|
-
return readdirSync(dir)
|
|
36
|
-
.filter((name) => name.endsWith(suffix))
|
|
37
|
-
.sort();
|
|
38
|
-
}
|
|
39
|
-
// execution/exec/{plans,results} の記録を実行単位(ファイル名の stem)でまとめる。
|
|
33
|
+
// 記録を run 単位でまとめる。
|
|
40
34
|
// 並びは開始日時の新しい順、開始日時が無いものは後ろに stem 順で置く。
|
|
41
35
|
export function collectExecRecords(execPath) {
|
|
42
36
|
const rows = new Map();
|
|
@@ -48,17 +42,17 @@ export function collectExecRecords(execPath) {
|
|
|
48
42
|
rows.set(stem, created);
|
|
49
43
|
return created;
|
|
50
44
|
};
|
|
51
|
-
for (const
|
|
52
|
-
const row = rowFor(
|
|
53
|
-
const fm = readSpecdojoFrontmatter(
|
|
54
|
-
row.planFile =
|
|
45
|
+
for (const path of listRunRecords(dirname(execPath), "plan")) {
|
|
46
|
+
const row = rowFor(relative(dirname(execPath), dirname(path)).replaceAll("\\", "/"));
|
|
47
|
+
const fm = readSpecdojoFrontmatter(path);
|
|
48
|
+
row.planFile = relative(execPath, path).replaceAll("\\", "/");
|
|
55
49
|
row.taskId ??= frontmatterText(fm.task_id);
|
|
56
50
|
row.mode ??= frontmatterText(fm.mode);
|
|
57
51
|
}
|
|
58
|
-
for (const
|
|
59
|
-
const row = rowFor(
|
|
60
|
-
const fm = readSpecdojoFrontmatter(
|
|
61
|
-
row.resultFile =
|
|
52
|
+
for (const path of listRunRecords(dirname(execPath), "result")) {
|
|
53
|
+
const row = rowFor(relative(dirname(execPath), dirname(path)).replaceAll("\\", "/"));
|
|
54
|
+
const fm = readSpecdojoFrontmatter(path);
|
|
55
|
+
row.resultFile = relative(execPath, path).replaceAll("\\", "/");
|
|
62
56
|
row.taskId = frontmatterText(fm.task_id) ?? row.taskId;
|
|
63
57
|
row.mode = frontmatterText(fm.mode) ?? row.mode;
|
|
64
58
|
row.status = frontmatterText(fm.status);
|
|
@@ -76,7 +70,9 @@ export function collectExecRecords(execPath) {
|
|
|
76
70
|
});
|
|
77
71
|
}
|
|
78
72
|
function execRecordLink(dir, file, label) {
|
|
79
|
-
return file
|
|
73
|
+
return file
|
|
74
|
+
? `[${label}](${executionRecordLink(file, dir === "plans" ? "plan" : "result")})`
|
|
75
|
+
: "-";
|
|
80
76
|
}
|
|
81
77
|
export function buildExecRecordsMarkdown(projectId, rows) {
|
|
82
78
|
const lines = [
|
|
@@ -85,7 +81,7 @@ export function buildExecRecordsMarkdown(projectId, rows) {
|
|
|
85
81
|
`- project_id: \`${projectId}\``,
|
|
86
82
|
`- 再生成: \`specdojo dashboard build --project ${projectId}\``,
|
|
87
83
|
"",
|
|
88
|
-
"> このページは `specdojo dashboard build` が生成した派生ビューです。正本は `execution/
|
|
84
|
+
"> このページは `specdojo dashboard build` が生成した派生ビューです。正本は `execution/runs/`配下の plan / result であり、このページを手編集しても次回のビルドで失われます。実行記録はサイドバーに載せないため、このページから辿ります。",
|
|
89
85
|
"",
|
|
90
86
|
];
|
|
91
87
|
if (rows.length === 0) {
|
|
@@ -2,19 +2,21 @@ import { existsSync, readFileSync, readdirSync } from "node:fs";
|
|
|
2
2
|
import { join } from "node:path";
|
|
3
3
|
import { load } from "../shared/yaml.js";
|
|
4
4
|
import { readJson } from "../shared/fs.js";
|
|
5
|
-
import {
|
|
6
|
-
|
|
5
|
+
import { migrateRoutineStorage } from "../routine/storage.js";
|
|
6
|
+
import { cronMatches, isRoutineEntryDue, routineActionKindLabel, } from "../routine/definition.js";
|
|
7
|
+
// routine ファイル(rtn-*.yaml)を読み、端末側の状態ファイルと突き合わせて
|
|
7
8
|
// 最終実行・実行結果・due 状況を得る。CLI 出力(routine list)の転記に依存しない。
|
|
8
|
-
export function aggregateRoutines(routinesPath) {
|
|
9
|
+
export function aggregateRoutines(routinesPath, repoRoot) {
|
|
9
10
|
if (!routinesPath || !existsSync(routinesPath))
|
|
10
11
|
return { rows: [], docs: [], history: [] };
|
|
12
|
+
const storage = migrateRoutineStorage(routinesPath, repoRoot);
|
|
11
13
|
const result = {
|
|
12
14
|
rows: [],
|
|
13
15
|
docs: [],
|
|
14
|
-
history: readRoutineRunHistory(
|
|
16
|
+
history: readRoutineRunHistory(storage.runsPath),
|
|
15
17
|
error: undefined,
|
|
16
18
|
};
|
|
17
|
-
const stateEntries = readRoutineStateEntries(
|
|
19
|
+
const stateEntries = readRoutineStateEntries(storage.statePath);
|
|
18
20
|
const now = new Date();
|
|
19
21
|
const files = readdirSync(routinesPath)
|
|
20
22
|
.filter((name) => /^rtn-.*\.(ya?ml)$/.test(name))
|
|
@@ -172,7 +174,7 @@ export function collapseFrequentRoutineRows(rows) {
|
|
|
172
174
|
}
|
|
173
175
|
return collapsed;
|
|
174
176
|
}
|
|
175
|
-
//
|
|
177
|
+
// 端末側の routine-state.json の routines.<id> が状態の正本。破損時は空。
|
|
176
178
|
function readRoutineStateEntries(statePath) {
|
|
177
179
|
const entries = {};
|
|
178
180
|
if (!existsSync(statePath))
|
|
@@ -188,6 +190,7 @@ function readRoutineStateEntries(statePath) {
|
|
|
188
190
|
last_run: typeof entry.last_run === "string" ? entry.last_run : undefined,
|
|
189
191
|
last_result: typeof entry.last_result === "string" ? entry.last_result : undefined,
|
|
190
192
|
last_scheduled_for: typeof entry.last_scheduled_for === "string" ? entry.last_scheduled_for : undefined,
|
|
193
|
+
busy_skip_count: typeof entry.busy_skip_count === "number" ? entry.busy_skip_count : undefined,
|
|
191
194
|
};
|
|
192
195
|
}
|
|
193
196
|
}
|
|
@@ -236,12 +239,8 @@ function buildRoutineRow(result, doc, stateEntries, now) {
|
|
|
236
239
|
export function computeRoutineDue(doc, stateEntry, enabled, now) {
|
|
237
240
|
if (!enabled)
|
|
238
241
|
return "disabled";
|
|
239
|
-
if (doc.trigger) {
|
|
240
|
-
|
|
241
|
-
return occurrences.length > 0 ? "due" : "-";
|
|
242
|
-
}
|
|
243
|
-
if (doc.interval) {
|
|
244
|
-
return isRoutineDue(doc, stateEntry?.last_run, now) ? "due" : "-";
|
|
242
|
+
if (doc.trigger || doc.interval) {
|
|
243
|
+
return isRoutineEntryDue(doc, stateEntry, now) ? "due" : "-";
|
|
245
244
|
}
|
|
246
245
|
return "-";
|
|
247
246
|
}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { loadTrackPlan } from "../register/track-plan.js";
|
|
2
2
|
import { join } from "node:path";
|
|
3
3
|
import { collectCatalogFilesByDomain } from "../shared/catalog-files.js";
|
|
4
4
|
import { resolveTimelineCatalogStatus } from "../register/catalog-status.js";
|
|
@@ -101,11 +101,7 @@ export function buildCatalogScaffoldPlans(tracks, catalogPath) {
|
|
|
101
101
|
return { scaffolds, warnings };
|
|
102
102
|
}
|
|
103
103
|
export function buildTimeline(opts) {
|
|
104
|
-
const
|
|
105
|
-
if (!existsSync(indexFile)) {
|
|
106
|
-
throw new Error(`Timeline index not found: ${indexFile}`);
|
|
107
|
-
}
|
|
108
|
-
const { index, errors: loadErrors } = loadTimelineIndex(indexFile);
|
|
104
|
+
const { index, errors: loadErrors } = loadTrackPlan(opts);
|
|
109
105
|
const errors = [...loadErrors];
|
|
110
106
|
const warnings = [];
|
|
111
107
|
const derived = resolveTimelineCatalogStatus(index.tracks, opts.registerPath);
|
|
@@ -150,8 +146,8 @@ export function renderTimelineOrderMarkdown(result) {
|
|
|
150
146
|
lines.push(`- schedule_ready_tracks: \`${result.scheduleReadyTracks.length}\``);
|
|
151
147
|
lines.push(`- catalog_scaffold_targets: \`${result.scaffolds.length}\``);
|
|
152
148
|
lines.push("");
|
|
153
|
-
lines.push(`この文書は \`tml-index.yaml
|
|
154
|
-
|
|
149
|
+
lines.push(`この文書は epic・strategy(互換用 \`tml-index.yaml\`)から非推奨の \`specdojo timeline build\` が生成した派生ビューです。` +
|
|
150
|
+
`計画は register の epic、範囲は strategy の scope、カタログ作成の完了は register の todo に記録し、通常は \`dashboard build\` を使ってください。`);
|
|
155
151
|
for (const wave of result.waves) {
|
|
156
152
|
lines.push("");
|
|
157
153
|
lines.push(`## ${wave.wave}. Wave ${wave.wave}`);
|
|
@@ -174,7 +170,7 @@ export function renderCatalogScaffoldMarkdown(result) {
|
|
|
174
170
|
lines.push(`- project_id: \`${result.projectId}\``);
|
|
175
171
|
lines.push(`- targets: \`${result.scaffolds.length}\``);
|
|
176
172
|
lines.push("");
|
|
177
|
-
lines.push(
|
|
173
|
+
lines.push(`既存 strategy の scope、epic の domains、互換用 \`tml-index.yaml\` の順で対象を解決し、\`dct-<domain>.yaml\` が未作成のものを列挙します。`);
|
|
178
174
|
lines.push("");
|
|
179
175
|
if (result.scaffolds.length === 0) {
|
|
180
176
|
lines.push(`未作成の成果物カタログはありません。`);
|
|
@@ -1,6 +1,8 @@
|
|
|
1
|
+
import { registerDeprecatedWhereAlias } from "../shared/where-alias.js";
|
|
2
|
+
import { warnDeprecated } from "../shared/deprecation.js";
|
|
1
3
|
import { existsSync, mkdirSync, writeFileSync } from "node:fs";
|
|
2
4
|
import { join, resolve } from "node:path";
|
|
3
|
-
import { getProjectCatalogPath, getProjectTimelinePath, getProjectRegisterPath, loadConfig, loadEnv, specdojoRootDir, } from "../shared/specdojo-config.js";
|
|
5
|
+
import { getProjectCatalogPath, getProjectTimelinePath, getProjectSchedulePath, getProjectRegisterPath, loadConfig, loadEnv, specdojoRootDir, } from "../shared/specdojo-config.js";
|
|
4
6
|
import { buildTimeline, renderCatalogScaffoldMarkdown, renderTimelineOrderMarkdown, } from "./timeline-build.js";
|
|
5
7
|
function resolveTimelinePaths(opts) {
|
|
6
8
|
loadEnv();
|
|
@@ -23,6 +25,9 @@ function resolveTimelinePaths(opts) {
|
|
|
23
25
|
const registerPath = getProjectRegisterPath(project);
|
|
24
26
|
return {
|
|
25
27
|
timelinePath: resolve(baseDir, getProjectTimelinePath(project)),
|
|
28
|
+
schedulePath: resolve(baseDir, getProjectSchedulePath(project)),
|
|
29
|
+
repoRoot: baseDir,
|
|
30
|
+
projectId,
|
|
26
31
|
catalogPath: catalogPath ? resolve(baseDir, catalogPath) : null,
|
|
27
32
|
...(registerPath ? { registerPath: resolve(baseDir, registerPath) } : {}),
|
|
28
33
|
};
|
|
@@ -50,31 +55,31 @@ function buildTimelineJson(result) {
|
|
|
50
55
|
})),
|
|
51
56
|
}, null, 2) + "\n");
|
|
52
57
|
}
|
|
58
|
+
export function printTimelinePaths(opts) {
|
|
59
|
+
try {
|
|
60
|
+
const { timelinePath, catalogPath } = resolveTimelinePaths(opts);
|
|
61
|
+
process.stdout.write(`timeline-path: ${timelinePath}\n`);
|
|
62
|
+
process.stdout.write(`catalog-path: ${catalogPath ?? "(not configured)"}\n`);
|
|
63
|
+
const indexFile = join(timelinePath, "tml-index.yaml");
|
|
64
|
+
process.stdout.write(`tml-index: ${indexFile}${existsSync(indexFile) ? "" : " (does not exist)"}\n`);
|
|
65
|
+
}
|
|
66
|
+
catch (error) {
|
|
67
|
+
printCommandError(error);
|
|
68
|
+
}
|
|
69
|
+
}
|
|
53
70
|
export function registerTimelineCommands(program) {
|
|
54
71
|
const tml = program.command("timeline").description("Timeline build commands");
|
|
55
|
-
|
|
56
|
-
addProjectOption(wcmd);
|
|
57
|
-
wcmd.action((opts) => {
|
|
58
|
-
try {
|
|
59
|
-
const { timelinePath, catalogPath } = resolveTimelinePaths(opts);
|
|
60
|
-
process.stdout.write(`timeline-path: ${timelinePath}\n`);
|
|
61
|
-
process.stdout.write(`catalog-path: ${catalogPath ?? "(not configured)"}\n`);
|
|
62
|
-
const indexFile = join(timelinePath, "tml-index.yaml");
|
|
63
|
-
process.stdout.write(`tml-index: ${indexFile}${existsSync(indexFile) ? "" : " (does not exist)"}\n`);
|
|
64
|
-
}
|
|
65
|
-
catch (error) {
|
|
66
|
-
printCommandError(error);
|
|
67
|
-
}
|
|
68
|
-
});
|
|
72
|
+
registerDeprecatedWhereAlias(tml, printTimelinePaths);
|
|
69
73
|
const bcmd = tml
|
|
70
74
|
.command("build")
|
|
71
|
-
.description("
|
|
75
|
+
.description("Deprecated: derive track order and catalog targets from epics and legacy tml-index.yaml");
|
|
72
76
|
addProjectOption(bcmd);
|
|
73
77
|
bcmd.option("--dry-run", "Print generated content to stdout without writing", false);
|
|
74
78
|
bcmd.action((opts) => {
|
|
75
79
|
try {
|
|
76
|
-
|
|
77
|
-
const
|
|
80
|
+
warnDeprecated("timeline build", "Use dashboard build; move domains and dependencies to register epics.");
|
|
81
|
+
const { timelinePath, ...paths } = resolveTimelinePaths(opts);
|
|
82
|
+
const result = buildTimeline({ timelinePath, ...paths });
|
|
78
83
|
for (const warning of result.warnings)
|
|
79
84
|
process.stdout.write(`WARN: ${warning}\n`);
|
|
80
85
|
for (const error of result.errors)
|
|
@@ -192,6 +192,7 @@ export async function runDevcontainerScaffold(opts) {
|
|
|
192
192
|
// options に応じて json と script を改変
|
|
193
193
|
const aptPackages = [];
|
|
194
194
|
const extraScripts = [];
|
|
195
|
+
let tmuxConfTemplate;
|
|
195
196
|
let emacsInitTemplate;
|
|
196
197
|
let vimrcTemplate;
|
|
197
198
|
if (includesRecommended) {
|
|
@@ -207,6 +208,14 @@ fi`);
|
|
|
207
208
|
}
|
|
208
209
|
if (effectiveTmux) {
|
|
209
210
|
aptPackages.push("tmux");
|
|
211
|
+
tmuxConfTemplate = await readFile(path.join(templateDir, "tmux.conf"), "utf8");
|
|
212
|
+
extraScripts.push(`# Link bundled tmux.conf when tmux is enabled, preserving any non-symlink user configuration.
|
|
213
|
+
SCRIPT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")" && pwd)"
|
|
214
|
+
if [ -f "\${SCRIPT_DIR}/tmux.conf" ]; then
|
|
215
|
+
if [ ! -e "$HOME/.tmux.conf" ] || [ -L "$HOME/.tmux.conf" ]; then
|
|
216
|
+
ln -sfn "\${SCRIPT_DIR}/tmux.conf" "$HOME/.tmux.conf"
|
|
217
|
+
fi
|
|
218
|
+
fi`);
|
|
210
219
|
}
|
|
211
220
|
if (effectiveCron) {
|
|
212
221
|
aptPackages.push("cron");
|
|
@@ -386,6 +395,9 @@ fi`);
|
|
|
386
395
|
if (dryRun) {
|
|
387
396
|
process.stdout.write(`[dry-run] would write: .devcontainer/devcontainer.json\n`);
|
|
388
397
|
process.stdout.write(`[dry-run] would write: .devcontainer/post-create.sh\n`);
|
|
398
|
+
if (tmuxConfTemplate !== undefined) {
|
|
399
|
+
process.stdout.write(`[dry-run] would write: .devcontainer/tmux.conf\n`);
|
|
400
|
+
}
|
|
389
401
|
if (emacsInitTemplate !== undefined) {
|
|
390
402
|
process.stdout.write(`[dry-run] would write: .devcontainer/emacs/init.el\n`);
|
|
391
403
|
}
|
|
@@ -402,6 +414,9 @@ fi`);
|
|
|
402
414
|
await mkdir(devcontainerDir, { recursive: true });
|
|
403
415
|
await writeFile(path.join(devcontainerDir, "devcontainer.json"), JSON.stringify(devcontainer, null, 2) + "\n", "utf8");
|
|
404
416
|
await writeFile(path.join(devcontainerDir, "post-create.sh"), postCreateScript, "utf8");
|
|
417
|
+
if (tmuxConfTemplate !== undefined) {
|
|
418
|
+
await writeFile(path.join(devcontainerDir, "tmux.conf"), tmuxConfTemplate, "utf8");
|
|
419
|
+
}
|
|
405
420
|
if (emacsInitTemplate !== undefined) {
|
|
406
421
|
await mkdir(path.join(devcontainerDir, "emacs"), { recursive: true });
|
|
407
422
|
await writeFile(path.join(devcontainerDir, "emacs", "init.el"), emacsInitTemplate, "utf8");
|
|
@@ -420,6 +435,9 @@ fi`);
|
|
|
420
435
|
await writeFile(path.join(remoteHostDir, "ssh-config.sample"), sshConfigScript, "utf8");
|
|
421
436
|
process.stdout.write(`Written: .devcontainer/devcontainer.json\n`);
|
|
422
437
|
process.stdout.write(`Written: .devcontainer/post-create.sh\n`);
|
|
438
|
+
if (tmuxConfTemplate !== undefined) {
|
|
439
|
+
process.stdout.write(`Written: .devcontainer/tmux.conf\n`);
|
|
440
|
+
}
|
|
423
441
|
if (emacsInitTemplate !== undefined) {
|
|
424
442
|
process.stdout.write(`Written: .devcontainer/emacs/init.el\n`);
|
|
425
443
|
}
|
|
@@ -1,48 +1 @@
|
|
|
1
|
-
|
|
2
|
-
// (document-metadata-standard.md)。他フレームワークの frontmatter キーとの衝突を避け、
|
|
3
|
-
// トップレベルを第三者ツールへ明け渡すための共通ユーティリティ。
|
|
4
|
-
//
|
|
5
|
-
// 対象は Markdown frontmatter のみ。独立 YAML データファイル(dct-*.yaml / pm-*.yaml /
|
|
6
|
-
// sch-*.yaml など)は名前空間化しないため、本モジュールは使わない。
|
|
7
|
-
import { load } from "../shared/yaml.js";
|
|
8
|
-
const FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/;
|
|
9
|
-
function specdojoFromBlock(block) {
|
|
10
|
-
let parsed;
|
|
11
|
-
try {
|
|
12
|
-
parsed = load(block);
|
|
13
|
-
}
|
|
14
|
-
catch {
|
|
15
|
-
return {};
|
|
16
|
-
}
|
|
17
|
-
if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
|
|
18
|
-
return {};
|
|
19
|
-
const namespace = parsed.specdojo;
|
|
20
|
-
if (!namespace || typeof namespace !== "object" || Array.isArray(namespace))
|
|
21
|
-
return {};
|
|
22
|
-
return namespace;
|
|
23
|
-
}
|
|
24
|
-
// Markdown 文書先頭の frontmatter から `specdojo:` 名前空間オブジェクトを取り出す。
|
|
25
|
-
// frontmatter が無い / 解析不能 / `specdojo:` を欠く場合は空オブジェクトを返す。
|
|
26
|
-
export function readSpecdojoNamespace(content) {
|
|
27
|
-
const match = content.match(FRONTMATTER_RE);
|
|
28
|
-
if (!match)
|
|
29
|
-
return {};
|
|
30
|
-
return specdojoFromBlock(match[1]);
|
|
31
|
-
}
|
|
32
|
-
// readSpecdojoNamespace と同じだが、frontmatter に続く本文も返す(read-modify-write 用)。
|
|
33
|
-
export function parseSpecdojoDocument(content) {
|
|
34
|
-
const match = content.match(FRONTMATTER_RE);
|
|
35
|
-
if (!match)
|
|
36
|
-
return { data: {}, body: content };
|
|
37
|
-
return { data: specdojoFromBlock(match[1]), body: match[2] ?? "" };
|
|
38
|
-
}
|
|
39
|
-
// トップレベルの `key: value` 行群を `specdojo:` 配下へ字下げし、`---` で囲んだ
|
|
40
|
-
// frontmatter ブロック文字列にして返す。frontmatter を生成する各所で使う。
|
|
41
|
-
export function buildSpecdojoFrontmatter(innerLines) {
|
|
42
|
-
return [
|
|
43
|
-
"---",
|
|
44
|
-
"specdojo:",
|
|
45
|
-
...innerLines.map((line) => (line.length === 0 ? "" : ` ${line}`)),
|
|
46
|
-
"---",
|
|
47
|
-
].join("\n");
|
|
48
|
-
}
|
|
1
|
+
export { buildSpecdojoFrontmatter, parseSpecdojoDocument, readSpecdojoNamespace, } from "../shared/frontmatter-namespace.js";
|
|
@@ -10,8 +10,8 @@ function printCommandError(error) {
|
|
|
10
10
|
export function registerIndexCommands(program) {
|
|
11
11
|
const idx = program.command("index").description("Document ID index commands");
|
|
12
12
|
idx
|
|
13
|
-
.command("build")
|
|
14
|
-
.description("
|
|
13
|
+
.command("build", { hidden: true })
|
|
14
|
+
.description("Internal compatibility entry for build --only index")
|
|
15
15
|
.option("--root <path>", "Root directory to scan", "docs")
|
|
16
16
|
.option("--output <path>", "Output path", ".specdojo/doc-index.json")
|
|
17
17
|
.action((opts) => {
|