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,224 @@
|
|
|
1
|
+
import { copyFileSync, existsSync, readdirSync, readFileSync, renameSync, statSync, writeFileSync, } from "node:fs";
|
|
2
|
+
import { basename, dirname, join, relative, resolve } from "node:path";
|
|
3
|
+
import { readSpecdojoNamespace } from "./frontmatter-namespace.js";
|
|
4
|
+
function pathSegment(value) {
|
|
5
|
+
const segment = value.trim().replace(/[^A-Za-z0-9._-]/g, "_");
|
|
6
|
+
if (!segment || segment === "." || segment === "..")
|
|
7
|
+
throw new Error(`Invalid run record identity: ${value}`);
|
|
8
|
+
return segment;
|
|
9
|
+
}
|
|
10
|
+
export const RUN_ORIGINS = ["register", "schedule", "job"];
|
|
11
|
+
export function runRecordsDirectory(executionPath) {
|
|
12
|
+
return join(executionPath, "runs");
|
|
13
|
+
}
|
|
14
|
+
/** Accept only an exact origin/item/run directory produced by the path policy. */
|
|
15
|
+
export function runRecordLocation(executionPath, directory) {
|
|
16
|
+
const parts = relative(runRecordsDirectory(executionPath), directory).split(/[\\/]/);
|
|
17
|
+
if (parts.length !== 3 || !RUN_ORIGINS.includes(parts[0]))
|
|
18
|
+
return undefined;
|
|
19
|
+
try {
|
|
20
|
+
const paths = runRecordPaths(executionPath, parts[0], parts[1], parts[2]);
|
|
21
|
+
return resolve(paths.directory) === resolve(directory) ? paths : undefined;
|
|
22
|
+
}
|
|
23
|
+
catch {
|
|
24
|
+
return undefined;
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
export function planConventionsDirectory(executionPath) {
|
|
28
|
+
return join(executionPath, "conventions");
|
|
29
|
+
}
|
|
30
|
+
export function planConventionsPath(executionPath, hash) {
|
|
31
|
+
if (!/^[a-f0-9]{64}$/.test(hash))
|
|
32
|
+
throw new Error(`Invalid conventions SHA-256: ${hash}`);
|
|
33
|
+
return join(planConventionsDirectory(executionPath), `${hash}.txt`);
|
|
34
|
+
}
|
|
35
|
+
/** All managed execution record paths. */
|
|
36
|
+
export function runRecordPaths(executionPath, origin, itemId, runId) {
|
|
37
|
+
if (!RUN_ORIGINS.includes(origin))
|
|
38
|
+
throw new Error(`Invalid run origin: ${origin}`);
|
|
39
|
+
const directory = join(runItemDirectory(executionPath, origin, itemId), pathSegment(runId));
|
|
40
|
+
return {
|
|
41
|
+
directory,
|
|
42
|
+
plan: join(directory, "plan.md"),
|
|
43
|
+
result: join(directory, "result.md"),
|
|
44
|
+
evidence: join(directory, "evidence.json"),
|
|
45
|
+
state: join(directory, "pipeline-state.json"),
|
|
46
|
+
log: (name) => join(directory, basename(name)),
|
|
47
|
+
};
|
|
48
|
+
}
|
|
49
|
+
export function recordIdentity(taskId, origin) {
|
|
50
|
+
const local = taskId.replace(/^[^:]+:/, "");
|
|
51
|
+
const inferred = origin ?? (/^pjr-/i.test(local) ? "register" : /^JBR-/i.test(local) ? "job" : "schedule");
|
|
52
|
+
const itemId = inferred === "register"
|
|
53
|
+
? (local.match(/^pjr-[a-z0-9]+/i)?.[0] ?? local).toUpperCase()
|
|
54
|
+
: inferred === "job"
|
|
55
|
+
? local.replace(/-review$/, "")
|
|
56
|
+
: local;
|
|
57
|
+
return { origin: inferred, itemId };
|
|
58
|
+
}
|
|
59
|
+
export function runItemDirectory(executionPath, origin, itemId) {
|
|
60
|
+
return join(runRecordsDirectory(executionPath), origin, pathSegment(itemId));
|
|
61
|
+
}
|
|
62
|
+
export function taskRecordPaths(executionPath, taskId, runId = taskId, origin) {
|
|
63
|
+
const identity = recordIdentity(taskId, origin);
|
|
64
|
+
return runRecordPaths(executionPath, identity.origin, identity.itemId, runId);
|
|
65
|
+
}
|
|
66
|
+
export function taskEvidencePaths(executionPath, taskId, runId) {
|
|
67
|
+
const records = taskRecordPaths(executionPath, taskId, runId);
|
|
68
|
+
return { directory: records.directory, evidence: records.evidence, state: records.state };
|
|
69
|
+
}
|
|
70
|
+
export function runRecordPrefixes(executionPath, taskId, runId) {
|
|
71
|
+
return [`${taskRecordPaths(executionPath, taskId, runId).directory.replaceAll("\\", "/")}/`];
|
|
72
|
+
}
|
|
73
|
+
function filesBelow(path) {
|
|
74
|
+
if (!existsSync(path))
|
|
75
|
+
return [];
|
|
76
|
+
return readdirSync(path, { withFileTypes: true })
|
|
77
|
+
.sort((a, b) => a.name.localeCompare(b.name))
|
|
78
|
+
.flatMap((entry) => {
|
|
79
|
+
const child = join(path, entry.name);
|
|
80
|
+
return entry.isDirectory() ? filesBelow(child) : entry.isFile() ? [child] : [];
|
|
81
|
+
});
|
|
82
|
+
}
|
|
83
|
+
export function listRunRecords(executionPath, kind) {
|
|
84
|
+
return filesBelow(join(executionPath, "runs")).filter((path) => basename(path) === `${kind}.md`);
|
|
85
|
+
}
|
|
86
|
+
/** Find the latest run for an item, or a run with the requested stem. */
|
|
87
|
+
export function findRunRecord(executionPath, kind, taskOrStem) {
|
|
88
|
+
const identity = recordIdentity(taskOrStem);
|
|
89
|
+
const itemDirectory = runItemDirectory(executionPath, identity.origin, identity.itemId);
|
|
90
|
+
const newFiles = filesBelow(existsSync(itemDirectory) ? itemDirectory : join(executionPath, "runs")).filter((path) => basename(path) === `${kind}.md`);
|
|
91
|
+
const matches = newFiles.filter((path) => {
|
|
92
|
+
if (recordStem(path) === taskOrStem)
|
|
93
|
+
return true;
|
|
94
|
+
try {
|
|
95
|
+
return readSpecdojoNamespace(readFileSync(path, "utf8")).task_id === taskOrStem;
|
|
96
|
+
}
|
|
97
|
+
catch {
|
|
98
|
+
return false;
|
|
99
|
+
}
|
|
100
|
+
});
|
|
101
|
+
const latest = (paths) => paths
|
|
102
|
+
.sort((a, b) => {
|
|
103
|
+
const time = (path) => {
|
|
104
|
+
if (kind === "result") {
|
|
105
|
+
try {
|
|
106
|
+
const started = readSpecdojoNamespace(readFileSync(path, "utf8")).started_at;
|
|
107
|
+
const timestamp = typeof started === "string" ? Date.parse(started) : NaN;
|
|
108
|
+
if (Number.isFinite(timestamp))
|
|
109
|
+
return timestamp;
|
|
110
|
+
}
|
|
111
|
+
catch {
|
|
112
|
+
/* Fall back to the file timestamp for malformed historical records. */
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
return statSync(path).birthtimeMs || statSync(path).mtimeMs;
|
|
116
|
+
};
|
|
117
|
+
return time(a) - time(b) || a.localeCompare(b);
|
|
118
|
+
})
|
|
119
|
+
.at(-1);
|
|
120
|
+
return latest(matches);
|
|
121
|
+
}
|
|
122
|
+
export function recordPathForRead(executionPath, kind, taskOrStem) {
|
|
123
|
+
return (findRunRecord(executionPath, kind, taskOrStem) ??
|
|
124
|
+
taskRecordPaths(executionPath, taskOrStem)[kind]);
|
|
125
|
+
}
|
|
126
|
+
export function isRunRecordPath(path) {
|
|
127
|
+
return /(?:^|\/)runs\/(?:register|schedule|job)\/[^/]+\/[^/]+\//.test(path.replaceAll("\\", "/"));
|
|
128
|
+
}
|
|
129
|
+
export function recordStem(path) {
|
|
130
|
+
return isRunRecordPath(path)
|
|
131
|
+
? basename(dirname(path))
|
|
132
|
+
: basename(path).replace(/-(plan|result)\.md$/, "");
|
|
133
|
+
}
|
|
134
|
+
export function resultForPlan(planPath) {
|
|
135
|
+
return isRunRecordPath(planPath)
|
|
136
|
+
? join(dirname(planPath), "result.md")
|
|
137
|
+
: planPath.replace(/-plan\.md$/, "-result.md");
|
|
138
|
+
}
|
|
139
|
+
export function recordRef(executionPath, path) {
|
|
140
|
+
return relative(executionPath, path).replaceAll("\\", "/");
|
|
141
|
+
}
|
|
142
|
+
export function runnerRecordPrefixes(executionPath) {
|
|
143
|
+
return [planConventionsDirectory(executionPath), join(executionPath, "runs")].map((path) => `${path.replaceAll("\\", "/")}/`);
|
|
144
|
+
}
|
|
145
|
+
export function taskRecordPrefixes(executionPath, taskId) {
|
|
146
|
+
const identity = recordIdentity(taskId);
|
|
147
|
+
return [
|
|
148
|
+
planConventionsDirectory(executionPath),
|
|
149
|
+
runItemDirectory(executionPath, identity.origin, identity.itemId),
|
|
150
|
+
].map((path) => `${path.replaceAll("\\", "/")}/`);
|
|
151
|
+
}
|
|
152
|
+
export function resumeStatePaths(executionPath, taskId) {
|
|
153
|
+
const identity = recordIdentity(taskId);
|
|
154
|
+
return [runItemDirectory(executionPath, identity.origin, identity.itemId)]
|
|
155
|
+
.flatMap(filesBelow)
|
|
156
|
+
.filter((path) => basename(path) === "pipeline-state.json");
|
|
157
|
+
}
|
|
158
|
+
export function runEvidencePath(statePath) {
|
|
159
|
+
return join(dirname(statePath), "evidence.json");
|
|
160
|
+
}
|
|
161
|
+
export function runLogPath(statePath, name) {
|
|
162
|
+
return join(dirname(statePath), basename(name));
|
|
163
|
+
}
|
|
164
|
+
export function executionRecordLink(file, kind) {
|
|
165
|
+
return join("..", "exec", file.includes("/") ? file : `${kind === "plan" ? "plans" : "results"}/${file}`).replaceAll("\\", "/");
|
|
166
|
+
}
|
|
167
|
+
export function isPlanOrResultRecord(path) {
|
|
168
|
+
// Recognize obsolete names for commit-scope protection without reading that layout.
|
|
169
|
+
return (/(?:^|\/)exec\/(?:plans|results)\//.test(path.replaceAll("\\", "/")) ||
|
|
170
|
+
(isRunRecordPath(path) && /\/(plan|result)\.md$/.test(path.replaceAll("\\", "/"))));
|
|
171
|
+
}
|
|
172
|
+
export function isOtherRunRecord(path, resultPath) {
|
|
173
|
+
return isRunRecordPath(path) && dirname(path) !== dirname(resultPath);
|
|
174
|
+
}
|
|
175
|
+
/** Archive a checkpoint; keep original logs only when the next stage retains their refs. */
|
|
176
|
+
export function snapshotRunAttempt(statePath, retainedLogRefs = []) {
|
|
177
|
+
if (!existsSync(statePath))
|
|
178
|
+
return;
|
|
179
|
+
const directory = dirname(statePath);
|
|
180
|
+
let attempt = 1;
|
|
181
|
+
while (existsSync(join(directory, `pipeline-state.attempt-${attempt}.json`)))
|
|
182
|
+
attempt++;
|
|
183
|
+
const names = readdirSync(directory).filter((file) => !file.includes(".attempt-") &&
|
|
184
|
+
(file === "pipeline-state.json" || file === "evidence.json" || file.endsWith(".log")));
|
|
185
|
+
const retainedLogs = new Set(retainedLogRefs.map((ref) => basename(ref.path.replaceAll("\\", "/"))));
|
|
186
|
+
const archivedLogs = new Map();
|
|
187
|
+
for (const name of names.filter((file) => file.endsWith(".log"))) {
|
|
188
|
+
archivedLogs.set(name, `${name.slice(0, -4)}.attempt-${attempt}.log`);
|
|
189
|
+
}
|
|
190
|
+
for (const name of names) {
|
|
191
|
+
const dot = name.lastIndexOf(".");
|
|
192
|
+
const destination = join(directory, `${name.slice(0, dot)}.attempt-${attempt}${name.slice(dot)}`);
|
|
193
|
+
if (name.endsWith(".log") && !retainedLogs.has(name)) {
|
|
194
|
+
renameSync(join(directory, name), destination);
|
|
195
|
+
}
|
|
196
|
+
else {
|
|
197
|
+
copyFileSync(join(directory, name), destination);
|
|
198
|
+
}
|
|
199
|
+
if (name === "evidence.json") {
|
|
200
|
+
try {
|
|
201
|
+
const evidence = JSON.parse(readFileSync(destination, "utf8"));
|
|
202
|
+
if (Array.isArray(evidence.log_refs)) {
|
|
203
|
+
evidence.log_refs = evidence.log_refs.map((ref) => {
|
|
204
|
+
const refName = basename(ref.path.replaceAll("\\", "/"));
|
|
205
|
+
const archivedName = archivedLogs.get(refName);
|
|
206
|
+
return {
|
|
207
|
+
...ref,
|
|
208
|
+
path: archivedName
|
|
209
|
+
? `${ref.path.slice(0, -refName.length)}${archivedName}`
|
|
210
|
+
: ref.path,
|
|
211
|
+
};
|
|
212
|
+
});
|
|
213
|
+
writeFileSync(destination, `${JSON.stringify(evidence, null, 2)}\n`);
|
|
214
|
+
}
|
|
215
|
+
}
|
|
216
|
+
catch {
|
|
217
|
+
/* Preserve malformed evidence verbatim for diagnosis. */
|
|
218
|
+
}
|
|
219
|
+
}
|
|
220
|
+
}
|
|
221
|
+
}
|
|
222
|
+
export function resolveRunPlanRef(executionPath, ref) {
|
|
223
|
+
return ref.replaceAll("\\", "/").startsWith("runs/") ? resolve(executionPath, ref) : resolve(ref);
|
|
224
|
+
}
|
|
@@ -1,4 +1,6 @@
|
|
|
1
|
+
import { warnDeprecated } from "./deprecation.js";
|
|
1
2
|
import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
|
|
3
|
+
import { tmpdir } from "node:os";
|
|
2
4
|
import { basename, dirname, isAbsolute, join, posix, relative, resolve } from "node:path";
|
|
3
5
|
import dotenv from "dotenv";
|
|
4
6
|
import { validateBranchTemplate } from "./branch-template.js";
|
|
@@ -12,6 +14,7 @@ import { runLefthookScaffold } from "./lefthook-scaffold.js";
|
|
|
12
14
|
import { ensureMarkdownlintConfig } from "./markdownlint-config.js";
|
|
13
15
|
import { runSlidevScaffold, SLIDEV_KATA_PATTERNS } from "./slidev-scaffold.js";
|
|
14
16
|
import { ensureGitignore, formatGitignoreReport, gitignorePatternsForLayouts, } from "./specdojo-gitignore.js";
|
|
17
|
+
import { applyLocalConfig, formatConfigShow, readLocalConfig, repositoryIdentityRoot, } from "./local-config.js";
|
|
15
18
|
/** Default IANA time zone for register date derivation when run.register_date_timezone is unset. */
|
|
16
19
|
export const DEFAULT_REGISTER_DATE_TIMEZONE = "UTC";
|
|
17
20
|
export const SPECDOJO_CONFIG_REFERENCE_URL = "https://specdojo.github.io/specdojo/ja/specdojo/references/specdojo-config-reference.html";
|
|
@@ -126,21 +129,6 @@ export function resolveRegisterActor(actor, roster) {
|
|
|
126
129
|
}
|
|
127
130
|
export const DEFAULT_AGENT_MEMBERS_PATH = ".specdojo/agent-members.yaml";
|
|
128
131
|
export const KATA_AUTHORITY_PATTERN = /^(?!prj-)(?!specdojo$)[a-z][a-z0-9-]*$/;
|
|
129
|
-
function repositoryIdentityRoot(rootDir) {
|
|
130
|
-
const root = resolve(rootDir);
|
|
131
|
-
const dotGit = join(root, ".git");
|
|
132
|
-
if (!existsSync(dotGit) || statSync(dotGit).isDirectory())
|
|
133
|
-
return root;
|
|
134
|
-
const gitdirLine = readTextFileOrNull(dotGit)
|
|
135
|
-
?.split(/\r?\n/)
|
|
136
|
-
.find((line) => line.startsWith("gitdir:"));
|
|
137
|
-
if (!gitdirLine)
|
|
138
|
-
return root;
|
|
139
|
-
const gitdir = resolve(root, gitdirLine.slice("gitdir:".length).trim()).replaceAll("\\", "/");
|
|
140
|
-
const marker = "/.git/worktrees/";
|
|
141
|
-
const markerIndex = gitdir.lastIndexOf(marker);
|
|
142
|
-
return markerIndex >= 0 ? gitdir.slice(0, markerIndex) : root;
|
|
143
|
-
}
|
|
144
132
|
export function defaultKataAuthority(rootDir = specdojoRootDir()) {
|
|
145
133
|
const directoryName = basename(repositoryIdentityRoot(rootDir));
|
|
146
134
|
const normalized = directoryName
|
|
@@ -167,26 +155,34 @@ export function isSpecdojoSourceRepository(rootDir = specdojoRootDir()) {
|
|
|
167
155
|
return false;
|
|
168
156
|
}
|
|
169
157
|
}
|
|
170
|
-
function
|
|
171
|
-
|
|
158
|
+
export function specdojoRootDir(startDir = process.cwd()) {
|
|
159
|
+
const current = resolve(startDir);
|
|
160
|
+
const systemTmp = resolve(tmpdir());
|
|
161
|
+
let dir = current;
|
|
162
|
+
let firstGitDir = null;
|
|
172
163
|
while (true) {
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
164
|
+
// 一時ディレクトリのルートそのもの(/tmp など)にある設定は、テストや検証の
|
|
165
|
+
// 漏洩・干渉を防ぐため親として拾わない。また一時ディレクトリ内から systemTmp を越えて探索しない。
|
|
166
|
+
if (dir === systemTmp) {
|
|
167
|
+
break;
|
|
168
|
+
}
|
|
169
|
+
if (existsSync(join(dir, ".specdojo", "specdojo.config.json"))) {
|
|
170
|
+
return dir;
|
|
171
|
+
}
|
|
172
|
+
if (!firstGitDir && existsSync(join(dir, ".git"))) {
|
|
173
|
+
firstGitDir = dir;
|
|
174
|
+
// リポジトリ境界に到達した。.git より親の .specdojo は拾わない。
|
|
175
|
+
break;
|
|
176
|
+
}
|
|
177
|
+
const parent = dirname(dir);
|
|
178
|
+
if (parent === dir)
|
|
179
|
+
break;
|
|
180
|
+
dir = parent;
|
|
181
|
+
}
|
|
182
|
+
if (firstGitDir) {
|
|
183
|
+
return firstGitDir;
|
|
184
|
+
}
|
|
185
|
+
return current;
|
|
190
186
|
}
|
|
191
187
|
/** Default worktree directory beside the repository, derived from its directory name. */
|
|
192
188
|
export function defaultWorktreeBase(rootDir = specdojoRootDir()) {
|
|
@@ -224,6 +220,8 @@ export function getProjectExecutionPath(project) {
|
|
|
224
220
|
// Timeline lives in a fixed cross-cutting directory under the project root, so an
|
|
225
221
|
// unset timeline_path falls back to "timeline" instead of disabling the command.
|
|
226
222
|
export function getProjectTimelinePath(project) {
|
|
223
|
+
if (project.timeline_path !== undefined)
|
|
224
|
+
warnDeprecated("timeline_path", "Use register epics and dashboard build.");
|
|
227
225
|
return withBasePath(project, project.timeline_path?.trim() || "timeline");
|
|
228
226
|
}
|
|
229
227
|
export function getProjectMembersPath(project) {
|
|
@@ -703,6 +701,8 @@ export function loadConfig(configRootDir = specdojoRootDir()) {
|
|
|
703
701
|
throw new Error(`Invalid .specdojo/specdojo.config.json: kata_authority must match ${KATA_AUTHORITY_PATTERN}`);
|
|
704
702
|
}
|
|
705
703
|
for (const [projectId, project] of Object.entries(parsed.projects)) {
|
|
704
|
+
if (project?.timeline_path !== undefined)
|
|
705
|
+
warnDeprecated("timeline_path", "Use register epics and dashboard build.");
|
|
706
706
|
if (!isValidProjectConfig(project)) {
|
|
707
707
|
throw new Error(`Invalid .specdojo/specdojo.config.json: projects.${projectId} must omit ` +
|
|
708
708
|
`schedule_path/execution_path/integration_branch or set them to non-empty strings, ` +
|
|
@@ -711,19 +711,34 @@ export function loadConfig(configRootDir = specdojoRootDir()) {
|
|
|
711
711
|
}
|
|
712
712
|
const projectIds = Object.keys(parsed.projects);
|
|
713
713
|
const rootDir = dirname(dirname(configPath));
|
|
714
|
+
// The local config is read after the shared one and may change only allowlisted keys
|
|
715
|
+
// (PJR-NC9R). The merged result goes through the same validation as the shared config.
|
|
716
|
+
const local = readLocalConfig(rootDir);
|
|
717
|
+
const applied = local
|
|
718
|
+
? applyLocalConfig(parsed, local.value, local.path, REPO_KEYS)
|
|
719
|
+
: { config: parsed, overrides: [] };
|
|
720
|
+
const effective = applied.config;
|
|
714
721
|
const repoErrors = projectIds
|
|
715
722
|
.sort()
|
|
716
723
|
.flatMap((projectId) => [
|
|
717
|
-
...validateCommitTypes(
|
|
718
|
-
...validateProjectRepos(projectId,
|
|
724
|
+
...validateCommitTypes(effective.projects[projectId].commit_types, `projects.${projectId}.commit_types`),
|
|
725
|
+
...validateProjectRepos(projectId, effective.projects[projectId], projectIds, rootDir),
|
|
719
726
|
]);
|
|
720
|
-
const externalProjectErrors = validateExternalProjects(
|
|
727
|
+
const externalProjectErrors = validateExternalProjects(effective.external_projects, projectIds, rootDir);
|
|
721
728
|
const configErrors = [...repoErrors, ...externalProjectErrors];
|
|
722
729
|
if (configErrors.length > 0) {
|
|
723
|
-
|
|
730
|
+
const localNote = local ? ` with local overrides from ${local.path}` : "";
|
|
731
|
+
throw new Error(`Invalid .specdojo/specdojo.config.json (${configPath}${localNote}):\n` +
|
|
724
732
|
configErrors.map((message) => ` - ${message}`).join("\n"));
|
|
725
733
|
}
|
|
726
|
-
return
|
|
734
|
+
return local
|
|
735
|
+
? {
|
|
736
|
+
configPath,
|
|
737
|
+
config: effective,
|
|
738
|
+
localConfigPath: local.path,
|
|
739
|
+
localOverrides: applied.overrides,
|
|
740
|
+
}
|
|
741
|
+
: { configPath, config: parsed };
|
|
727
742
|
}
|
|
728
743
|
export function writeConfig(config) {
|
|
729
744
|
const configPath = defaultConfigPath();
|
|
@@ -767,9 +782,13 @@ export function registerConfigCommands(program) {
|
|
|
767
782
|
"and initialize .gitignore and markdownlint settings")
|
|
768
783
|
.option("--dry-run", "Show the planned config, .gitignore and markdownlint settings without writing", false)
|
|
769
784
|
.action((opts) => {
|
|
785
|
+
const rootDir = specdojoRootDir();
|
|
786
|
+
if (resolve(rootDir) === resolve(tmpdir())) {
|
|
787
|
+
throw new Error("Refusing to initialize specdojo configuration directly under temporary directory root.");
|
|
788
|
+
}
|
|
770
789
|
const dryRun = !!opts.dryRun;
|
|
771
|
-
const { configPath, config } = loadConfig();
|
|
772
|
-
ensureMarkdownlintConfig(
|
|
790
|
+
const { configPath, config } = loadConfig(rootDir);
|
|
791
|
+
ensureMarkdownlintConfig(rootDir, dryRun);
|
|
773
792
|
if (config) {
|
|
774
793
|
process.stdout.write(`Already exists: ${configPath}\n`);
|
|
775
794
|
writeGitignoreForConfig(config, dryRun);
|
|
@@ -809,6 +828,19 @@ export function registerConfigCommands(program) {
|
|
|
809
828
|
' 6. To let tasks change the product repository, declare it under "repos" ' +
|
|
810
829
|
'(e.g. { "name": "app1", "path": "../app1" }) and write targets/paths as app1:<path>.\n');
|
|
811
830
|
});
|
|
831
|
+
cfg
|
|
832
|
+
.command("show")
|
|
833
|
+
.description("Show the effective repos and which values come from .specdojo/specdojo.local.config.json")
|
|
834
|
+
.option("--project <projectId>", "Show only one project")
|
|
835
|
+
.action((opts) => {
|
|
836
|
+
try {
|
|
837
|
+
process.stdout.write(formatConfigShow(loadConfig(), opts.project));
|
|
838
|
+
}
|
|
839
|
+
catch (error) {
|
|
840
|
+
process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
|
|
841
|
+
process.exitCode = 1;
|
|
842
|
+
}
|
|
843
|
+
});
|
|
812
844
|
cfg
|
|
813
845
|
.command("migrate-members")
|
|
814
846
|
.description("Move agent entries from project pm-members.yaml files to protected agent members")
|
|
@@ -7,6 +7,7 @@ export const NODE_MODULES_PATTERN = "node_modules/";
|
|
|
7
7
|
export const DEFAULT_GITIGNORE_PATTERNS = [
|
|
8
8
|
NODE_MODULES_PATTERN,
|
|
9
9
|
".specdojo/doc-index.json",
|
|
10
|
+
".specdojo/specdojo.local.config.json",
|
|
10
11
|
"docs/**/generated/*",
|
|
11
12
|
"!docs/**/generated/.gitkeep",
|
|
12
13
|
"docs/**/execution/exec/.locks/",
|
package/dist/shared/text.js
CHANGED
|
@@ -82,7 +82,15 @@ function replaceOutsideMarkdownCodeSpans(text, replace) {
|
|
|
82
82
|
export function inlineCodeAnglePlaceholders(text) {
|
|
83
83
|
// HTTP(S) autolink は Markdown として既に安全な山括弧記法なので、プレースホルダとして
|
|
84
84
|
// code span 化しない。register の表セルで bare URL を囲んだ後も autolink を保持する。
|
|
85
|
-
|
|
85
|
+
return wrapAngleTokens(text, /[A-Za-z0-9._-]*(?:<(?!https?:\/\/)[^<>\r\n]+>[A-Za-z0-9._-]*)+/g);
|
|
86
|
+
}
|
|
87
|
+
// frontmatter の文字列値へ書き写す executor 由来の文(condense の記録・block 理由など)向け。
|
|
88
|
+
// lint-fm は frontmatter のコードスパン外の山括弧を autolink や実在 HTML 名も含めて拒否する
|
|
89
|
+
// ため(PJR-V141)、本文用と異なり `<https://...>` も code span 化する。
|
|
90
|
+
export function inlineCodeFrontmatterAnglePlaceholders(text) {
|
|
91
|
+
return wrapAngleTokens(text, /[A-Za-z0-9._-]*(?:<[^<>\r\n]+>[A-Za-z0-9._-]*)+/g);
|
|
92
|
+
}
|
|
93
|
+
function wrapAngleTokens(text, placeholder) {
|
|
86
94
|
const wrapToken = (token) => {
|
|
87
95
|
const trailing = token.match(/\.+$/)?.[0] ?? "";
|
|
88
96
|
const body = trailing ? token.slice(0, -trailing.length) : token;
|
|
@@ -109,10 +117,70 @@ const CONTROL_CHARS = /[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f-\u009f]/g;
|
|
|
109
117
|
export function stripTerminalControlSequences(text) {
|
|
110
118
|
return text.replace(ANSI_ESCAPE, "").replace(CONTROL_CHARS, "");
|
|
111
119
|
}
|
|
112
|
-
/**
|
|
120
|
+
/** Kept in sync with tools/check-evidence-secrets.mjs by a parity test. */
|
|
121
|
+
export const SENSITIVE_TEXT_RULES = [
|
|
122
|
+
{
|
|
123
|
+
kind: "private-key",
|
|
124
|
+
pattern: /-----BEGIN ((?:[A-Z0-9]+ )*PRIVATE KEY)-----[\s\S]*?-----END \1-----/gu,
|
|
125
|
+
replacement: "[REDACTED]",
|
|
126
|
+
},
|
|
127
|
+
{
|
|
128
|
+
kind: "url-credentials",
|
|
129
|
+
pattern: /(\b[a-z][a-z0-9+.-]*:\/\/)[^\s/@<>"'`?#]+@/giu,
|
|
130
|
+
replacement: "$1[REDACTED]@",
|
|
131
|
+
},
|
|
132
|
+
{
|
|
133
|
+
kind: "bearer-token",
|
|
134
|
+
pattern: /\bBearer\s+[A-Za-z0-9._~+/=-]+/giu,
|
|
135
|
+
replacement: "Bearer [REDACTED]",
|
|
136
|
+
},
|
|
137
|
+
{
|
|
138
|
+
kind: "aws-access-key",
|
|
139
|
+
pattern: /\b(?:AKIA|ASIA)[A-Z0-9]{16}\b/gu,
|
|
140
|
+
replacement: "[REDACTED]",
|
|
141
|
+
},
|
|
142
|
+
{
|
|
143
|
+
kind: "google-api-key",
|
|
144
|
+
pattern: /\bAIza[A-Za-z0-9_-]{35}(?![A-Za-z0-9_-])/gu,
|
|
145
|
+
replacement: "[REDACTED]",
|
|
146
|
+
},
|
|
147
|
+
{
|
|
148
|
+
kind: "slack-token",
|
|
149
|
+
pattern: /\bxox[a-z]-[A-Za-z0-9-]{8,}(?![A-Za-z0-9-])/gu,
|
|
150
|
+
replacement: "[REDACTED]",
|
|
151
|
+
},
|
|
152
|
+
{
|
|
153
|
+
kind: "github-fine-grained-token",
|
|
154
|
+
pattern: /\bgithub_pat_[A-Za-z0-9_]{8,}\b/gu,
|
|
155
|
+
replacement: "[REDACTED]",
|
|
156
|
+
},
|
|
157
|
+
{
|
|
158
|
+
kind: "anthropic-api-key",
|
|
159
|
+
pattern: /\bsk-ant-[A-Za-z0-9_-]{8,}(?![A-Za-z0-9_-])/gu,
|
|
160
|
+
replacement: "[REDACTED]",
|
|
161
|
+
},
|
|
162
|
+
{
|
|
163
|
+
kind: "api-token",
|
|
164
|
+
pattern: /\b(?:sk-(?:proj-)?[A-Za-z0-9_-]{8,}|gh[oprsu]_[A-Za-z0-9_]{8,})(?![A-Za-z0-9_-])/gu,
|
|
165
|
+
replacement: "[REDACTED]",
|
|
166
|
+
},
|
|
167
|
+
{
|
|
168
|
+
kind: "jwt",
|
|
169
|
+
pattern: /\beyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+(?![A-Za-z0-9_-])/gu,
|
|
170
|
+
replacement: "[REDACTED]",
|
|
171
|
+
},
|
|
172
|
+
{
|
|
173
|
+
kind: "quoted-credential",
|
|
174
|
+
pattern: /(\b(?:api[_-]?key|access[_-]?token|auth(?:orization)?|password|passwd|secret)\b["']?\s*[:=]\s*)(["'])(?:\\[\s\S]|(?!\2)[^\\\r\n])+\2/giu,
|
|
175
|
+
replacement: "$1$2[REDACTED]$2",
|
|
176
|
+
},
|
|
177
|
+
{
|
|
178
|
+
kind: "credential-assignment",
|
|
179
|
+
pattern: /(\b(?:api[_-]?key|access[_-]?token|auth(?:orization)?|password|passwd|secret)\b["']?\s*[:=]\s*)(?:Bearer\s+)?[^\s,;}"'`\\]+/giu,
|
|
180
|
+
replacement: "$1[REDACTED]",
|
|
181
|
+
},
|
|
182
|
+
];
|
|
183
|
+
/** Redacts known credential forms before subprocess output is persisted as evidence. */
|
|
113
184
|
export function redactSensitiveText(value) {
|
|
114
|
-
return value
|
|
115
|
-
.replace(/\bBearer\s+[A-Za-z0-9._~+/=-]+/giu, "Bearer [REDACTED]")
|
|
116
|
-
.replace(/\b(sk-(?:proj-)?[A-Za-z0-9_-]{8,}|gh[opsu]_[A-Za-z0-9_]{8,})\b/gu, "[REDACTED]")
|
|
117
|
-
.replace(/\b(api[_-]?key|access[_-]?token|auth(?:orization)?|password|passwd|secret)\b(\s*[:=]\s*)([^\s,;]+)/giu, "$1$2[REDACTED]");
|
|
185
|
+
return SENSITIVE_TEXT_RULES.reduce((text, { pattern, replacement }) => text.replace(pattern, replacement), value);
|
|
118
186
|
}
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { warnDeprecated } from "./deprecation.js";
|
|
1
2
|
import { readYaml } from "./fs.js";
|
|
2
3
|
import { normalizeDateOnly } from "./time.js";
|
|
3
4
|
const CATALOG_STATUSES = ["not_started", "draft", "primary"];
|
|
@@ -76,6 +77,7 @@ function parseTrack(raw, index, errors) {
|
|
|
76
77
|
export function loadTimelineIndex(filePath) {
|
|
77
78
|
const errors = [];
|
|
78
79
|
const parsed = readYaml(filePath);
|
|
80
|
+
warnDeprecated("tml-index.yaml", "Move track domains and dependencies to register epics; use dashboard build.");
|
|
79
81
|
if (!isRecord(parsed)) {
|
|
80
82
|
throw new Error(`${filePath}: invalid or empty YAML`);
|
|
81
83
|
}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import { warnDeprecated } from "./deprecation.js";
|
|
2
|
+
/** Retain the six pre-unification entries for one release before removing them. */
|
|
3
|
+
export function registerDeprecatedWhereAlias(parent, printPaths) {
|
|
4
|
+
const kind = parent.name();
|
|
5
|
+
parent
|
|
6
|
+
.command("where", { hidden: true })
|
|
7
|
+
.description(`Deprecated: use where ${kind} (retained for one release)`)
|
|
8
|
+
.option("--project <projectId>", "Project id in specdojo.config.json")
|
|
9
|
+
.action((opts) => {
|
|
10
|
+
warnDeprecated(`${kind} where`, `Use specdojo where ${kind}. This alias will be removed after one release.`);
|
|
11
|
+
printPaths(opts);
|
|
12
|
+
});
|
|
13
|
+
}
|
package/dist/specdojo.js
CHANGED
|
@@ -15,6 +15,7 @@ import { registerRoutineCommands } from "./routine/routine.js";
|
|
|
15
15
|
import { registerJobCommands } from "./job/job.js";
|
|
16
16
|
import { registerWatchCommand } from "./commands/watch.js";
|
|
17
17
|
import { registerBuildCommand } from "./commands/build.js";
|
|
18
|
+
import { registerWhereCommand } from "./commands/where.js";
|
|
18
19
|
import { registerYamlPagesCommands } from "./docs/yaml-pages-command.js";
|
|
19
20
|
import { registerDashboardCommands } from "./dashboard/dashboard.js";
|
|
20
21
|
import { registerGradeCommand } from "./grade/grade.js";
|
|
@@ -24,6 +25,7 @@ import { registerKataCommands } from "./kata/command.js";
|
|
|
24
25
|
import { registerDevcontainerCommands } from "./devcontainer/command.js";
|
|
25
26
|
import { registerInitCommand } from "./commands/init.js";
|
|
26
27
|
import { registerOrchestratorCommands } from "./commands/orchestrator.js";
|
|
28
|
+
import { registerGitCommand } from "./commands/git.js";
|
|
27
29
|
/**
|
|
28
30
|
* bin は dist/specdojo.js を指すため、開発チェックアウトで `npm run build` を忘れると
|
|
29
31
|
* 古い挙動のまま実行される。src が dist より新しい場合は警告し、exec 系は中断する。
|
|
@@ -57,6 +59,7 @@ async function main() {
|
|
|
57
59
|
registerJobCommands(program);
|
|
58
60
|
registerWatchCommand(program);
|
|
59
61
|
registerBuildCommand(program);
|
|
62
|
+
registerWhereCommand(program);
|
|
60
63
|
registerYamlPagesCommands(program);
|
|
61
64
|
registerDashboardCommands(program);
|
|
62
65
|
registerGradeCommand(program, {
|
|
@@ -67,6 +70,7 @@ async function main() {
|
|
|
67
70
|
registerKataCommands(program);
|
|
68
71
|
registerDevcontainerCommands(program);
|
|
69
72
|
registerOrchestratorCommands(program);
|
|
73
|
+
registerGitCommand(program);
|
|
70
74
|
await program.parseAsync(process.argv);
|
|
71
75
|
}
|
|
72
76
|
void main();
|
|
@@ -324,6 +324,7 @@ viewpoints:
|
|
|
324
324
|
document_kinds:
|
|
325
325
|
exclude:
|
|
326
326
|
- specdojo:bdd-rulebook
|
|
327
|
+
- specdojo:cdr-rulebook
|
|
327
328
|
- specdojo:dct-index-rulebook
|
|
328
329
|
- specdojo:dct-rulebook
|
|
329
330
|
- specdojo:gl-rulebook
|
|
@@ -354,7 +355,9 @@ viewpoints:
|
|
|
354
355
|
- specdojo:cdfd-rulebook
|
|
355
356
|
- specdojo:cdfd-uc-rulebook
|
|
356
357
|
- specdojo:cdsd-rulebook
|
|
358
|
+
- specdojo:cdt-rulebook
|
|
357
359
|
- specdojo:cld-rulebook
|
|
360
|
+
- specdojo:clis-rulebook
|
|
358
361
|
- specdojo:cnd-mermaid-rulebook
|
|
359
362
|
- specdojo:cnd-rulebook
|
|
360
363
|
- specdojo:cop-index-rulebook
|
|
@@ -367,6 +370,7 @@ viewpoints:
|
|
|
367
370
|
- specdojo:dec-rulebook
|
|
368
371
|
- specdojo:dmd-index-rulebook
|
|
369
372
|
- specdojo:dmd-rulebook
|
|
373
|
+
- specdojo:dss-rulebook
|
|
370
374
|
- specdojo:etc-index-rulebook
|
|
371
375
|
- specdojo:etc-rulebook
|
|
372
376
|
- specdojo:ifd-mermaid-rulebook
|
|
@@ -516,8 +520,9 @@ viewpoints:
|
|
|
516
520
|
category: usability
|
|
517
521
|
title: 冗長性・簡潔性
|
|
518
522
|
check: >-
|
|
519
|
-
|
|
520
|
-
evidence:
|
|
523
|
+
各節が固有の判断または手順に寄与し、同じ主張の繰り返し、表と本文の二重の説明、図をなぞる文、目的に要らない背景、正本の再掲がないか。判断に要る背景・制約・例外・完了条件が残されていれば下限を満たしているとする。長さだけでは fail にせず、削る・まとめる・参照に置き換えることで判断情報を失わない箇所を具体的に特定できる場合のみ minor とする。
|
|
524
|
+
evidence: >-
|
|
525
|
+
同じ主張の繰り返し、表と本文の二重の説明、図をなぞる文、目的に要らない背景、正本の再掲(正本への参照で置き換えられるもの)。判断に要る背景・制約・例外・完了条件を残したまま、長さだけを根拠にせず、削る・まとめる・参照に置き換えることで判断情報を失わない箇所。
|
|
521
526
|
default_severity: minor
|
|
522
527
|
evaluation: referential
|
|
523
528
|
- id: vp-arc-single-responsibility
|
|
@@ -569,8 +574,11 @@ viewpoints:
|
|
|
569
574
|
- specdojo:cdfd-mermaid-rulebook
|
|
570
575
|
- specdojo:cdfd-rulebook
|
|
571
576
|
- specdojo:cdfd-uc-rulebook
|
|
577
|
+
- specdojo:cdr-rulebook
|
|
572
578
|
- specdojo:cdsd-rulebook
|
|
579
|
+
- specdojo:cdt-rulebook
|
|
573
580
|
- specdojo:cld-rulebook
|
|
581
|
+
- specdojo:clis-rulebook
|
|
574
582
|
- specdojo:cnd-mermaid-rulebook
|
|
575
583
|
- specdojo:cnd-rulebook
|
|
576
584
|
- specdojo:cop-rulebook
|
|
@@ -582,6 +590,7 @@ viewpoints:
|
|
|
582
590
|
- specdojo:dct-rulebook
|
|
583
591
|
- specdojo:dec-rulebook
|
|
584
592
|
- specdojo:dmd-rulebook
|
|
593
|
+
- specdojo:dss-rulebook
|
|
585
594
|
- specdojo:etc-rulebook
|
|
586
595
|
- specdojo:gl-rulebook
|
|
587
596
|
- specdojo:ifd-mermaid-rulebook
|