specdojo 0.1.0 → 0.2.1
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/LICENSE +22 -0
- package/README.md +142 -35
- package/dist/agent-response.js +27 -0
- package/dist/agent.js +124 -0
- package/dist/build-command.js +149 -0
- package/dist/build-if-stale.js +35 -0
- package/dist/catalog-build.js +1079 -0
- package/dist/catalog-generate.js +226 -0
- package/dist/catalog-paths.js +31 -0
- package/dist/catalog-plan-generate.js +301 -0
- package/dist/catalog-plan-prompt.js +73 -0
- package/dist/catalog-plan.js +471 -0
- package/dist/catalog-scaffold.js +255 -0
- package/dist/catalog-types.js +4 -0
- package/dist/catalog.js +606 -0
- package/dist/dashboard.js +990 -0
- package/dist/deliverable-trash.js +148 -0
- package/dist/deliverable.js +97 -0
- package/dist/dist-freshness.js +150 -0
- package/dist/doc-index.js +424 -0
- package/dist/exec-agent-config.js +172 -0
- package/dist/exec-agent-git-state.js +136 -0
- package/dist/exec-agent-protected-config.js +276 -0
- package/dist/exec-events.js +250 -112
- package/dist/exec-evidence.js +317 -0
- package/dist/exec-format.js +54 -0
- package/dist/exec-limit.js +202 -0
- package/dist/exec-parent-validation.js +169 -0
- package/dist/exec-pipeline-state.js +160 -0
- package/dist/exec-plans.js +1016 -0
- package/dist/exec-project.js +25 -11
- package/dist/exec-protection-handoff.js +169 -0
- package/dist/exec-provider-scaffold.js +99 -0
- package/dist/exec-register-resume.js +196 -0
- package/dist/exec-register.js +281 -0
- package/dist/exec-reporter.js +329 -0
- package/dist/exec-results.js +510 -0
- package/dist/exec-run-lock.js +149 -0
- package/dist/exec-run.js +4953 -0
- package/dist/exec-schedule-calendar.js +86 -9
- package/dist/exec-schedule-cpm.js +30 -12
- package/dist/exec-schedule-gantt-chart-render.js +428 -0
- package/dist/exec-schedule-gantt-chart-scope.js +111 -0
- package/dist/exec-schedule-gantt-chart.js +2 -0
- package/dist/exec-schedule-hash.js +34 -25
- package/dist/exec-schedule-index.js +200 -67
- package/dist/exec-schedule-initial.js +100 -0
- package/dist/exec-schedule-progress.js +51 -26
- package/dist/exec-schedule-ready.js +71 -27
- package/dist/exec-schedule.js +171 -93
- package/dist/exec-shared.js +146 -25
- package/dist/exec-strategy.js +547 -0
- package/dist/exec-task-view.js +64 -0
- package/dist/exec-trial.js +895 -0
- package/dist/exec-worktree-command.js +426 -0
- package/dist/exec-worktree-ops.js +847 -0
- package/dist/exec-worktree.js +359 -0
- package/dist/exec.js +744 -192
- package/dist/frontmatter-namespace.js +48 -0
- package/dist/git-environment.js +23 -0
- package/dist/grade-result.js +137 -0
- package/dist/grade.js +2456 -0
- package/dist/index-command.js +103 -0
- package/dist/job.js +1081 -0
- package/dist/kata-command.js +303 -0
- package/dist/kata.js +187 -0
- package/dist/package-paths.js +33 -0
- package/dist/practice-id.js +24 -0
- package/dist/register-date.js +122 -0
- package/dist/register-events.js +363 -0
- package/dist/register-history.js +323 -0
- package/dist/register-item.js +455 -0
- package/dist/register-migrate-timestamps.js +176 -0
- package/dist/register.js +2199 -0
- package/dist/review-plan.js +199 -0
- package/dist/review-types.js +1 -0
- package/dist/role-types.js +1 -0
- package/dist/routine.js +814 -0
- package/dist/schedule-approach.js +252 -0
- package/dist/schedule-build.js +552 -0
- package/dist/schedule-phase-sets.js +73 -0
- package/dist/schedule-strategy-generate.js +812 -0
- package/dist/schedule-strategy-profiles.js +276 -0
- package/dist/schedule.js +420 -0
- package/dist/spawn-self.js +28 -0
- package/dist/specdojo-config.js +133 -39
- package/dist/specdojo.js +56 -7
- package/dist/template-frontmatter.js +89 -0
- package/dist/template-resolution.js +92 -0
- package/dist/timeline-build.js +334 -0
- package/dist/timeline.js +107 -0
- package/dist/watch.js +313 -0
- package/dist/yaml-pages-command.js +28 -0
- package/dist/yaml-pages.js +180 -0
- package/dist/yaml-schema-modeline.js +49 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +600 -0
- package/docs/ja/specdojo/exec-templates/xep-bootstrap-template.md +120 -0
- package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +37 -0
- package/docs/ja/specdojo/exec-templates/xep-cross-deliverable-dedup-template.md +51 -0
- package/docs/ja/specdojo/exec-templates/xep-freeform-template.md +74 -0
- package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +109 -0
- package/docs/ja/specdojo/exec-templates/xep-job-template.md +43 -0
- package/docs/ja/specdojo/exec-templates/xep-recipe-guided-template.md +82 -0
- package/docs/ja/specdojo/exec-templates/xep-recipe-maintenance-template.md +86 -0
- package/docs/ja/specdojo/exec-templates/xep-register-investigate-template.md +42 -0
- package/docs/ja/specdojo/exec-templates/xep-register-template.md +49 -0
- package/docs/ja/specdojo/exec-templates/xep-retrofit-template.md +98 -0
- package/docs/ja/specdojo/exec-templates/xep-rulebook-maintenance-template.md +86 -0
- package/docs/ja/specdojo/exec-templates/xep-sample-maintenance-template.md +86 -0
- package/docs/ja/specdojo/exec-templates/xep-template-maintenance-template.md +86 -0
- package/docs/ja/specdojo/exec-templates/xep-template.md +66 -0
- package/docs/ja/specdojo/exec-templates/xer-cross-deliverable-dedup-template.md +31 -0
- package/docs/ja/specdojo/exec-templates/xer-human-bootstrap-finalize-template.md +40 -0
- package/docs/ja/specdojo/exec-templates/xer-human-finalize-template.md +30 -0
- package/docs/ja/specdojo/exec-templates/xer-template.md +19 -0
- package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +70 -0
- package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +97 -0
- package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +76 -0
- package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +73 -0
- package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +74 -0
- package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +74 -0
- package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +73 -0
- package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +73 -0
- package/docs/ja/specdojo/exec-templates/xrp-template.md +67 -0
- package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +7 -0
- package/docs/ja/specdojo/exec-templates/xrr-template.md +21 -0
- package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +7 -0
- package/docs/ja/specdojo/guides/branch-workflow-guide.md +354 -0
- package/docs/ja/specdojo/guides/docs-editing-guide.md +327 -0
- package/docs/ja/specdojo/guides/docs-structure-guide.md +519 -0
- package/docs/ja/specdojo/guides/exec-config-guide.md +589 -0
- package/docs/ja/specdojo/guides/exec-operation-guide.md +440 -0
- package/docs/ja/specdojo/guides/exec-worktree-guide.md +318 -0
- package/docs/ja/specdojo/guides/kata-guide.md +89 -0
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +127 -0
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +228 -0
- package/docs/ja/specdojo/guides/practice-system-composition-guide.md +111 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +472 -0
- package/docs/ja/specdojo/guides/register-operation-guide.md +418 -0
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +163 -0
- package/docs/ja/specdojo/guides/review-guide.md +428 -0
- package/docs/ja/specdojo/guides/routine-operation-guide.md +282 -0
- package/docs/ja/specdojo/guides/ryu-guide.md +230 -0
- package/docs/ja/specdojo/guides/schedule-design-guide.md +429 -0
- package/docs/ja/specdojo/guides/schedule-operation-guide.md +151 -0
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +257 -0
- package/docs/ja/specdojo/guides/timeline-design-guide.md +160 -0
- package/docs/ja/specdojo/guides/track-design-guide.md +215 -0
- package/docs/ja/specdojo/guides/use-case-guide.md +133 -0
- package/docs/ja/specdojo/guides/waza-guide.md +224 -0
- package/docs/ja/specdojo/index.md +33 -0
- package/docs/ja/specdojo/philosophy/needs-to-implementation-philosophy.md +212 -0
- package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +242 -0
- package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +198 -0
- package/docs/ja/specdojo/recipes/cdfd-recipe.md +218 -0
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +198 -0
- package/docs/ja/specdojo/recipes/exec-human-finalize-recipe.md +100 -0
- package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +148 -0
- package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +97 -0
- package/docs/ja/specdojo/recipes/pm-members-recipe.md +149 -0
- package/docs/ja/specdojo/recipes/pm-organization-recipe.md +96 -0
- package/docs/ja/specdojo/recipes/pm-plan-recipe.md +98 -0
- package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +97 -0
- package/docs/ja/specdojo/recipes/pm-raci-recipe.md +96 -0
- package/docs/ja/specdojo/recipes/pm-roles-recipe.md +136 -0
- package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +162 -0
- package/docs/ja/specdojo/recipes/prj-charter-recipe.md +187 -0
- package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +235 -0
- package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +205 -0
- package/docs/ja/specdojo/recipes/prj-overview-recipe.md +289 -0
- package/docs/ja/specdojo/recipes/prj-scope-recipe.md +201 -0
- package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +168 -0
- package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +179 -0
- package/docs/ja/specdojo/recipes/stsd-recipe.md +138 -0
- package/docs/ja/specdojo/references/command-reference.md +718 -0
- package/docs/ja/specdojo/references/deliverables-reference.md +407 -0
- package/docs/ja/specdojo/references/directory-layout-reference.md +280 -0
- package/docs/ja/specdojo/references/specdojo-config-reference.md +133 -0
- package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +372 -0
- package/docs/ja/specdojo/rulebooks/atc-rulebook.md +302 -0
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +331 -0
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +134 -0
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +207 -0
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +102 -0
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +131 -0
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +269 -0
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +187 -0
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +279 -0
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +219 -0
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +233 -0
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +182 -0
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +171 -0
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +105 -0
- package/docs/ja/specdojo/rulebooks/cld-rulebook.md +195 -0
- package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +285 -0
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +292 -0
- package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +171 -0
- package/docs/ja/specdojo/rulebooks/cop-rulebook.md +325 -0
- package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +266 -0
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +294 -0
- package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +21 -0
- package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +401 -0
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +311 -0
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +158 -0
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +287 -0
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +62 -0
- package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +100 -0
- package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +298 -0
- package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +379 -0
- package/docs/ja/specdojo/rulebooks/etc-rulebook.md +310 -0
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +86 -0
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +297 -0
- package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +79 -0
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +213 -0
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +311 -0
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +94 -0
- package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +81 -0
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +117 -0
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +118 -0
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +116 -0
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +116 -0
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +116 -0
- package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +421 -0
- package/docs/ja/specdojo/rulebooks/itc-rulebook.md +307 -0
- package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +312 -0
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +63 -0
- package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +353 -0
- package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +184 -0
- package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +179 -0
- package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +184 -0
- package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +183 -0
- package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +185 -0
- package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +185 -0
- package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +186 -0
- package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +186 -0
- package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +184 -0
- package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +61 -0
- package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +84 -0
- package/docs/ja/specdojo/rulebooks/opd-rulebook.md +357 -0
- package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +80 -0
- package/docs/ja/specdojo/rulebooks/opr-rulebook.md +484 -0
- package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +120 -0
- package/docs/ja/specdojo/rulebooks/otp-rulebook.md +293 -0
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +211 -0
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +94 -0
- package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +116 -0
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +93 -0
- package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +190 -0
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +108 -0
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +122 -0
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +117 -0
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +116 -0
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +93 -0
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +146 -0
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +65 -0
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +178 -0
- package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +232 -0
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +235 -0
- package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +242 -0
- package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +187 -0
- package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +201 -0
- package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +165 -0
- package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +165 -0
- package/docs/ja/specdojo/rulebooks/sac-rulebook.md +202 -0
- package/docs/ja/specdojo/rulebooks/sch-rulebook.md +139 -0
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +63 -0
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +93 -0
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +93 -0
- package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +329 -0
- package/docs/ja/specdojo/rulebooks/stc-rulebook.md +297 -0
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +132 -0
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +215 -0
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +376 -0
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +313 -0
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +246 -0
- package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +119 -0
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +188 -0
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +114 -0
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +117 -0
- package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +101 -0
- package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +103 -0
- package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +396 -0
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +207 -0
- package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +387 -0
- package/docs/ja/specdojo/rulebooks/utc-rulebook.md +303 -0
- package/docs/ja/specdojo/samples/atc-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/atc-sample.md +41 -0
- package/docs/ja/specdojo/samples/bac-sample.md +38 -0
- package/docs/ja/specdojo/samples/bdd-sample.yaml +71 -0
- package/docs/ja/specdojo/samples/bds-sample.md +38 -0
- package/docs/ja/specdojo/samples/bes-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/bes-sample.md +38 -0
- package/docs/ja/specdojo/samples/bps-sample.md +38 -0
- package/docs/ja/specdojo/samples/br-sample.md +40 -0
- package/docs/ja/specdojo/samples/ccd-sample.md +38 -0
- package/docs/ja/specdojo/samples/cdfd-overview-sample.md +284 -0
- package/docs/ja/specdojo/samples/cdfd-sample.md +229 -0
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +146 -0
- package/docs/ja/specdojo/samples/cdsd-sample.md +38 -0
- package/docs/ja/specdojo/samples/cld-sample.md +38 -0
- package/docs/ja/specdojo/samples/cnd-sample.md +38 -0
- package/docs/ja/specdojo/samples/cop-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/cop-sample.md +38 -0
- package/docs/ja/specdojo/samples/cpd-sample.md +38 -0
- package/docs/ja/specdojo/samples/cstd-sample.md +11 -0
- package/docs/ja/specdojo/samples/cxd-sample.md +38 -0
- package/docs/ja/specdojo/samples/dct-index-sample.yaml +39 -0
- package/docs/ja/specdojo/samples/dct-sample.yaml +91 -0
- package/docs/ja/specdojo/samples/dec-sample.md +39 -0
- package/docs/ja/specdojo/samples/dmd-index-sample.md +50 -0
- package/docs/ja/specdojo/samples/dmd-sample.md +74 -0
- package/docs/ja/specdojo/samples/etc-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/etc-sample.md +38 -0
- package/docs/ja/specdojo/samples/gl-sample.yaml +37 -0
- package/docs/ja/specdojo/samples/ifd-sample.md +38 -0
- package/docs/ja/specdojo/samples/ifx-api-sample.yaml +102 -0
- package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +107 -0
- package/docs/ja/specdojo/samples/ifx-file-sample.md +38 -0
- package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +89 -0
- package/docs/ja/specdojo/samples/imp-business-sample.md +66 -0
- package/docs/ja/specdojo/samples/imp-data-sample.md +60 -0
- package/docs/ja/specdojo/samples/imp-interface-sample.md +60 -0
- package/docs/ja/specdojo/samples/imp-operations-sample.md +60 -0
- package/docs/ja/specdojo/samples/imp-test-sample.md +60 -0
- package/docs/ja/specdojo/samples/itc-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/itc-sample.md +38 -0
- package/docs/ja/specdojo/samples/mip-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/mm-sample.md +35 -0
- package/docs/ja/specdojo/samples/mtp-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-availability-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-integrity-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-operations-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-performance-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-reliability-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +38 -0
- package/docs/ja/specdojo/samples/nfr-usability-sample.md +38 -0
- package/docs/ja/specdojo/samples/ntp-sample.md +38 -0
- package/docs/ja/specdojo/samples/opd-access-control-sample.md +29 -0
- package/docs/ja/specdojo/samples/opd-incident-management-sample.md +31 -0
- package/docs/ja/specdojo/samples/opd-index-sample.md +41 -0
- package/docs/ja/specdojo/samples/opd-monitoring-sample.md +32 -0
- package/docs/ja/specdojo/samples/opd-sample.md +38 -0
- package/docs/ja/specdojo/samples/opr-access-control-sample.md +24 -0
- package/docs/ja/specdojo/samples/opr-backup-restore-sample.md +27 -0
- package/docs/ja/specdojo/samples/opr-batch-sample.md +23 -0
- package/docs/ja/specdojo/samples/opr-change-sample.md +24 -0
- package/docs/ja/specdojo/samples/opr-incident-sample.md +38 -0
- package/docs/ja/specdojo/samples/opr-index-sample.md +43 -0
- package/docs/ja/specdojo/samples/opr-monitoring-sample.md +27 -0
- package/docs/ja/specdojo/samples/opr-sample.md +38 -0
- package/docs/ja/specdojo/samples/opr-support-sample.md +23 -0
- package/docs/ja/specdojo/samples/otp-index-sample.md +66 -0
- package/docs/ja/specdojo/samples/otp-sample.md +68 -0
- package/docs/ja/specdojo/samples/pm-change-request-log-sample.md +47 -0
- package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +46 -0
- package/docs/ja/specdojo/samples/pm-issue-log-sample.md +45 -0
- package/docs/ja/specdojo/samples/pm-members-sample.yaml +103 -0
- package/docs/ja/specdojo/samples/pm-organization-sample.md +46 -0
- package/docs/ja/specdojo/samples/pm-plan-sample.md +57 -0
- package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +52 -0
- package/docs/ja/specdojo/samples/pm-raci-sample.md +57 -0
- package/docs/ja/specdojo/samples/pm-risk-register-sample.md +43 -0
- package/docs/ja/specdojo/samples/pm-roles-sample.yaml +41 -0
- package/docs/ja/specdojo/samples/pr-sample.md +39 -0
- package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +57 -0
- package/docs/ja/specdojo/samples/prj-charter-sample.md +121 -0
- package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +105 -0
- package/docs/ja/specdojo/samples/prj-issues-and-approach-sample.md +78 -0
- package/docs/ja/specdojo/samples/prj-overview-sample.md +95 -0
- package/docs/ja/specdojo/samples/prj-scope-sample.md +71 -0
- package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +60 -0
- package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +62 -0
- package/docs/ja/specdojo/samples/sac-sample.md +38 -0
- package/docs/ja/specdojo/samples/sf-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/sf-sample.md +38 -0
- package/docs/ja/specdojo/samples/sld-sample.md +38 -0
- package/docs/ja/specdojo/samples/stc-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/stc-sample.md +38 -0
- package/docs/ja/specdojo/samples/stsd-sample.md +58 -0
- package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +38 -0
- package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +38 -0
- package/docs/ja/specdojo/samples/sysd-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/trc-requirements-to-specs-sample.md +56 -0
- package/docs/ja/specdojo/samples/trc-requirements-to-tests-sample.md +56 -0
- package/docs/ja/specdojo/samples/tsd-index-sample.md +29 -0
- package/docs/ja/specdojo/samples/tsd-sample.md +38 -0
- package/docs/ja/specdojo/samples/tsp-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/uis-sample.md +38 -0
- package/docs/ja/specdojo/samples/utc-index-sample.md +38 -0
- package/docs/ja/specdojo/samples/utc-sample.md +38 -0
- package/docs/ja/specdojo/schemas/v1/guide-content.schema.yaml +20 -0
- package/docs/ja/specdojo/schemas/v1/philosophy-content.schema.yaml +21 -0
- package/docs/ja/specdojo/schemas/v1/reference-content.schema.yaml +21 -0
- package/docs/ja/specdojo/standards/document-metadata-standard.md +323 -0
- package/docs/ja/specdojo/standards/exec-human-finalize-standard.md +75 -0
- package/docs/ja/specdojo/standards/git-branching-standard.md +227 -0
- package/docs/ja/specdojo/standards/guide-authoring-standard.md +124 -0
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +929 -0
- package/docs/ja/specdojo/standards/job-definition-standard.md +148 -0
- package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +431 -0
- package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +113 -0
- package/docs/ja/specdojo/standards/recipe-authoring-standard.md +143 -0
- package/docs/ja/specdojo/standards/reference-authoring-standard.md +99 -0
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +140 -0
- package/docs/ja/specdojo/standards/sample-authoring-standard.md +151 -0
- package/docs/ja/specdojo/standards/standard-authoring-standard.md +108 -0
- package/docs/ja/specdojo/standards/template-authoring-standard.md +101 -0
- package/docs/ja/specdojo/standards/test-document-scope-standard.md +176 -0
- package/docs/ja/specdojo/templates/cdfd-overview-template.md +199 -0
- package/docs/ja/specdojo/templates/cdfd-template.md +173 -0
- package/docs/ja/specdojo/templates/cdfd-uc-template.md +148 -0
- package/docs/ja/specdojo/templates/dct-architecture-template.yaml +136 -0
- package/docs/ja/specdojo/templates/dct-business-acceptance-criteria-template.yaml +34 -0
- package/docs/ja/specdojo/templates/dct-business-model-bes-template.yaml +75 -0
- package/docs/ja/specdojo/templates/dct-business-model-bps-template.yaml +49 -0
- package/docs/ja/specdojo/templates/dct-business-model-br-template.yaml +50 -0
- package/docs/ja/specdojo/templates/dct-data-flow-template.yaml +40 -0
- package/docs/ja/specdojo/templates/dct-data-model-bdd-template.yaml +46 -0
- package/docs/ja/specdojo/templates/dct-data-model-ccd-template.yaml +46 -0
- package/docs/ja/specdojo/templates/dct-data-model-cdsd-template.yaml +41 -0
- package/docs/ja/specdojo/templates/dct-data-model-cld-template.yaml +38 -0
- package/docs/ja/specdojo/templates/dct-data-model-sld-template.yaml +38 -0
- package/docs/ja/specdojo/templates/dct-data-model-stsd-template.yaml +46 -0
- package/docs/ja/specdojo/templates/dct-external-interface-specs-template.yaml +114 -0
- package/docs/ja/specdojo/templates/dct-glossary-template.yaml +35 -0
- package/docs/ja/specdojo/templates/dct-impact-analysis-template.yaml +138 -0
- package/docs/ja/specdojo/templates/dct-index-template.md +40 -0
- package/docs/ja/specdojo/templates/dct-migration-planning-template.yaml +148 -0
- package/docs/ja/specdojo/templates/dct-non-functional-requirements-template.yaml +222 -0
- package/docs/ja/specdojo/templates/dct-operations-template.yaml +108 -0
- package/docs/ja/specdojo/templates/dct-project-definition-template.yaml +210 -0
- package/docs/ja/specdojo/templates/dct-project-management-template.yaml +423 -0
- package/docs/ja/specdojo/templates/dct-system-acceptance-criteria-template.yaml +37 -0
- package/docs/ja/specdojo/templates/dct-system-design-template.yaml +82 -0
- package/docs/ja/specdojo/templates/dct-system-functions-template.yaml +58 -0
- package/docs/ja/specdojo/templates/dct-test-specs-template.yaml +261 -0
- package/docs/ja/specdojo/templates/dct-user-interface-model-template.yaml +60 -0
- package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +88 -0
- package/docs/ja/specdojo/templates/opr-template.md +85 -0
- package/docs/ja/specdojo/templates/pjr-change-request-template.md +60 -0
- package/docs/ja/specdojo/templates/pjr-decision-template.md +61 -0
- package/docs/ja/specdojo/templates/pjr-index-template.md +49 -0
- package/docs/ja/specdojo/templates/pjr-issue-template.md +50 -0
- package/docs/ja/specdojo/templates/pjr-note-template.md +35 -0
- package/docs/ja/specdojo/templates/pjr-question-template.md +53 -0
- package/docs/ja/specdojo/templates/pjr-risk-template.md +49 -0
- package/docs/ja/specdojo/templates/pjr-todo-template.md +41 -0
- package/docs/ja/specdojo/templates/pjr-views-by-owner-template.md +22 -0
- package/docs/ja/specdojo/templates/pjr-views-by-priority-template.md +22 -0
- package/docs/ja/specdojo/templates/pjr-views-by-status-template.md +22 -0
- package/docs/ja/specdojo/templates/pm-change-request-log-template.md +20 -0
- package/docs/ja/specdojo/templates/pm-communication-plan-template.md +46 -0
- package/docs/ja/specdojo/templates/pm-decision-log-template.md +20 -0
- package/docs/ja/specdojo/templates/pm-issue-log-template.md +20 -0
- package/docs/ja/specdojo/templates/pm-members-template.yaml +105 -0
- package/docs/ja/specdojo/templates/pm-organization-template.md +44 -0
- package/docs/ja/specdojo/templates/pm-plan-template.md +52 -0
- package/docs/ja/specdojo/templates/pm-quality-management-plan-template.md +46 -0
- package/docs/ja/specdojo/templates/pm-raci-template.md +51 -0
- package/docs/ja/specdojo/templates/pm-risk-register-template.md +20 -0
- package/docs/ja/specdojo/templates/pm-roles-template.yaml +53 -0
- package/docs/ja/specdojo/templates/prj-assumptions-constraints-dependencies-template.md +59 -0
- package/docs/ja/specdojo/templates/prj-charter-template.md +116 -0
- package/docs/ja/specdojo/templates/prj-comparison-of-alternatives-template.md +116 -0
- package/docs/ja/specdojo/templates/prj-issues-and-approach-template.md +89 -0
- package/docs/ja/specdojo/templates/prj-overview-template.md +85 -0
- package/docs/ja/specdojo/templates/prj-scope-template.md +75 -0
- package/docs/ja/specdojo/templates/prj-stakeholder-register-template.md +64 -0
- package/docs/ja/specdojo/templates/prj-success-criteria-and-acceptance-criteria-template.md +60 -0
- package/docs/ja/specdojo/templates/stsd-template.md +57 -0
- package/docs/specdojo/schemas/v1/bdd.schema.yaml +230 -0
- package/docs/specdojo/schemas/v1/common-frontmatter.schema.yaml +77 -0
- package/docs/specdojo/schemas/v1/dct-index.schema.yaml +85 -0
- package/docs/specdojo/schemas/v1/dct-plan.schema.yaml +324 -0
- package/docs/specdojo/schemas/v1/dct.schema.yaml +368 -0
- package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +91 -0
- package/docs/specdojo/schemas/v1/esil.schema.yaml +142 -0
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +101 -0
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +272 -0
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +162 -0
- package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +126 -0
- package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +151 -0
- package/docs/specdojo/schemas/v1/exec-result-frontmatter.schema.yaml +144 -0
- package/docs/specdojo/schemas/v1/grade-done-criteria.schema.yaml +79 -0
- package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +60 -0
- package/docs/specdojo/schemas/v1/grade-result.schema.yaml +118 -0
- package/docs/specdojo/schemas/v1/guide-frontmatter.schema.yaml +19 -0
- package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +293 -0
- package/docs/specdojo/schemas/v1/job-run.schema.yaml +90 -0
- package/docs/specdojo/schemas/v1/job.schema.yaml +198 -0
- package/docs/specdojo/schemas/v1/philosophy-frontmatter.schema.yaml +19 -0
- package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +56 -0
- package/docs/specdojo/schemas/v1/pm-members.schema.yaml +252 -0
- package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +387 -0
- package/docs/specdojo/schemas/v1/pm-roles.schema.yaml +106 -0
- package/docs/specdojo/schemas/v1/recipe-frontmatter.schema.yaml +27 -0
- package/docs/specdojo/schemas/v1/reference-frontmatter.schema.yaml +18 -0
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +106 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +204 -0
- package/docs/specdojo/schemas/v1/routine-run.schema.yaml +36 -0
- package/docs/specdojo/schemas/v1/routine.schema.yaml +87 -0
- package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +61 -0
- package/docs/specdojo/schemas/v1/sch-common.schema.yaml +258 -0
- package/docs/specdojo/schemas/v1/sch-defaults.schema.yaml +48 -0
- package/docs/specdojo/schemas/v1/sch-milestones.schema.yaml +64 -0
- package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +772 -0
- package/docs/specdojo/schemas/v1/sch-track.schema.yaml +66 -0
- package/docs/specdojo/schemas/v1/standard-frontmatter.schema.yaml +18 -0
- package/docs/specdojo/schemas/v1/tml-index.schema.yaml +103 -0
- package/package.json +121 -24
- package/templates/antigravity/README.md +35 -0
- package/templates/antigravity/exec-defaults-snippet.yaml +38 -0
- package/templates/antigravity/orchestrator.md +146 -0
- package/templates/antigravity/pm-members-snippet.yaml +55 -0
- package/templates/claude/README.md +46 -0
- package/templates/claude/agents/claude-expert-review-executor.md +14 -0
- package/templates/claude/agents/claude-review-executor.md +14 -0
- package/templates/claude/agents/specdojo-orchestrator.md +153 -0
- package/templates/claude/settings.edit.json +6 -0
- package/templates/claude/settings.report.json +6 -0
- package/templates/claude/settings.review.json +7 -0
- package/templates/codex/README.md +61 -0
- package/templates/codex/agents/codex-executor.toml +12 -0
- package/templates/codex/agents/codex-expert-executor.toml +12 -0
- package/templates/codex/agents/codex-expert-review-executor.toml +10 -0
- package/templates/codex/agents/codex-review-executor.toml +10 -0
- package/templates/codex/agents/specdojo-orchestrator.toml +154 -0
- package/templates/codex/orchestrator.md +146 -0
- package/templates/copilot/README.md +41 -0
- package/templates/copilot/exec-defaults-snippet.yaml +28 -0
- package/templates/copilot/pm-members-snippet.yaml +44 -0
- package/templates/opencode/README.md +41 -0
- package/templates/opencode/agents/opencode-executor.md +59 -0
- package/templates/opencode/agents/opencode-reporter.md +26 -0
- package/templates/opencode/agents/opencode-review-executor.md +48 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +193 -0
- package/dist/exec-schedule-timeline-render.js +0 -201
- package/dist/exec-schedule-timeline.js +0 -2
|
@@ -0,0 +1,303 @@
|
|
|
1
|
+
import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync } from "node:fs";
|
|
2
|
+
import { basename, dirname, extname, join, relative, resolve } from "node:path";
|
|
3
|
+
import yaml from "js-yaml";
|
|
4
|
+
import { readSpecdojoNamespace } from "./frontmatter-namespace.js";
|
|
5
|
+
import { specdojoResourceCandidates } from "./template-resolution.js";
|
|
6
|
+
export const KATA_RESOURCE_KINDS = [
|
|
7
|
+
"rulebook",
|
|
8
|
+
"standard",
|
|
9
|
+
"recipe",
|
|
10
|
+
"sample",
|
|
11
|
+
"template",
|
|
12
|
+
];
|
|
13
|
+
// eject できない参照固定の種別。CLI のバージョンと対応するため利用リポジトリへ複製しない。
|
|
14
|
+
export const KATA_REFERENCED_KINDS = ["exec-template", "schema"];
|
|
15
|
+
const RESOURCE_KINDS = [
|
|
16
|
+
{ kind: "rulebook", relativeDir: "docs/ja/specdojo/rulebooks", ejectable: true },
|
|
17
|
+
{ kind: "standard", relativeDir: "docs/ja/specdojo/standards", ejectable: true },
|
|
18
|
+
{ kind: "recipe", relativeDir: "docs/ja/specdojo/recipes", ejectable: true },
|
|
19
|
+
{ kind: "sample", relativeDir: "docs/ja/specdojo/samples", ejectable: true },
|
|
20
|
+
{ kind: "template", relativeDir: "docs/ja/specdojo/templates", ejectable: true },
|
|
21
|
+
{
|
|
22
|
+
kind: "exec-template",
|
|
23
|
+
relativeDir: "docs/ja/specdojo/exec-templates",
|
|
24
|
+
ejectable: false,
|
|
25
|
+
},
|
|
26
|
+
{ kind: "schema", relativeDir: "docs/ja/specdojo/schemas", ejectable: false },
|
|
27
|
+
{ kind: "schema", relativeDir: "docs/specdojo/schemas", ejectable: false },
|
|
28
|
+
];
|
|
29
|
+
function isEjectableKind(kind) {
|
|
30
|
+
return KATA_RESOURCE_KINDS.includes(kind);
|
|
31
|
+
}
|
|
32
|
+
const EJECTABLE_KINDS = RESOURCE_KINDS.filter((config) => config.ejectable);
|
|
33
|
+
function normalizeRelativePath(value) {
|
|
34
|
+
return value.replaceAll("\\", "/");
|
|
35
|
+
}
|
|
36
|
+
function filesBelow(root) {
|
|
37
|
+
if (!existsSync(root))
|
|
38
|
+
return [];
|
|
39
|
+
const files = [];
|
|
40
|
+
const visit = (current) => {
|
|
41
|
+
for (const entry of readdirSync(current, { withFileTypes: true })) {
|
|
42
|
+
if (entry.name === "generated")
|
|
43
|
+
continue;
|
|
44
|
+
const absolutePath = join(current, entry.name);
|
|
45
|
+
if (entry.isDirectory())
|
|
46
|
+
visit(absolutePath);
|
|
47
|
+
else if (entry.isFile())
|
|
48
|
+
files.push(absolutePath);
|
|
49
|
+
}
|
|
50
|
+
};
|
|
51
|
+
visit(root);
|
|
52
|
+
return files.sort();
|
|
53
|
+
}
|
|
54
|
+
function parseDataFileId(content, extension) {
|
|
55
|
+
let parsed;
|
|
56
|
+
try {
|
|
57
|
+
parsed = extension === ".json" ? JSON.parse(content) : yaml.load(content);
|
|
58
|
+
}
|
|
59
|
+
catch {
|
|
60
|
+
return undefined;
|
|
61
|
+
}
|
|
62
|
+
if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
|
|
63
|
+
return undefined;
|
|
64
|
+
const id = parsed.id;
|
|
65
|
+
return typeof id === "string" && id !== "" ? id : undefined;
|
|
66
|
+
}
|
|
67
|
+
function resourceId(absolutePath) {
|
|
68
|
+
const content = readFileSync(absolutePath, "utf8");
|
|
69
|
+
const extension = extname(absolutePath).toLowerCase();
|
|
70
|
+
if (extension === ".md" || extension === ".mdx") {
|
|
71
|
+
const id = readSpecdojoNamespace(content).id;
|
|
72
|
+
if (typeof id === "string" && id !== "")
|
|
73
|
+
return id;
|
|
74
|
+
}
|
|
75
|
+
else if ([".yaml", ".yml", ".json"].includes(extension)) {
|
|
76
|
+
const id = parseDataFileId(content, extension);
|
|
77
|
+
if (id)
|
|
78
|
+
return id;
|
|
79
|
+
}
|
|
80
|
+
return basename(absolutePath, extension);
|
|
81
|
+
}
|
|
82
|
+
function sameContents(first, second) {
|
|
83
|
+
return readFileSync(first).equals(readFileSync(second));
|
|
84
|
+
}
|
|
85
|
+
function pathsForConfig(config, roots) {
|
|
86
|
+
const paths = specdojoResourceCandidates(config.relativeDir, roots);
|
|
87
|
+
return { repositoryDir: paths.repositoryPath, bundledDir: paths.bundledPath };
|
|
88
|
+
}
|
|
89
|
+
function relativeFiles(root) {
|
|
90
|
+
return filesBelow(root).map((filePath) => normalizeRelativePath(relative(root, filePath)));
|
|
91
|
+
}
|
|
92
|
+
function enumerateConfig(config, roots) {
|
|
93
|
+
const { repositoryDir, bundledDir } = pathsForConfig(config, roots);
|
|
94
|
+
const relativePaths = [
|
|
95
|
+
...new Set([...relativeFiles(repositoryDir), ...relativeFiles(bundledDir)]),
|
|
96
|
+
];
|
|
97
|
+
return relativePaths.sort().map((filePath) => {
|
|
98
|
+
const repositoryPath = resolve(repositoryDir, filePath);
|
|
99
|
+
const bundledPath = resolve(bundledDir, filePath);
|
|
100
|
+
const hasRepositoryFile = existsSync(repositoryPath);
|
|
101
|
+
const hasBundledFile = existsSync(bundledPath);
|
|
102
|
+
const resolvedPath = hasRepositoryFile ? repositoryPath : bundledPath;
|
|
103
|
+
const source = hasRepositoryFile ? "repository" : "node_modules";
|
|
104
|
+
return {
|
|
105
|
+
id: resourceId(resolvedPath),
|
|
106
|
+
kind: config.kind,
|
|
107
|
+
ejectable: config.ejectable,
|
|
108
|
+
relativePath: normalizeRelativePath(join(config.relativeDir, filePath)),
|
|
109
|
+
repositoryPath: hasRepositoryFile ? repositoryPath : undefined,
|
|
110
|
+
bundledPath: hasBundledFile ? bundledPath : undefined,
|
|
111
|
+
resolvedPath,
|
|
112
|
+
source,
|
|
113
|
+
state: hasRepositoryFile ? "ejected" : "referenced",
|
|
114
|
+
difference: hasRepositoryFile
|
|
115
|
+
? hasBundledFile
|
|
116
|
+
? sameContents(repositoryPath, bundledPath)
|
|
117
|
+
? "same"
|
|
118
|
+
: "modified"
|
|
119
|
+
: "package-missing"
|
|
120
|
+
: "-",
|
|
121
|
+
};
|
|
122
|
+
});
|
|
123
|
+
}
|
|
124
|
+
const ALL_LIST_KINDS = [...KATA_RESOURCE_KINDS, ...KATA_REFERENCED_KINDS];
|
|
125
|
+
function assertKind(kind) {
|
|
126
|
+
if (kind === undefined)
|
|
127
|
+
return undefined;
|
|
128
|
+
if (ALL_LIST_KINDS.includes(kind))
|
|
129
|
+
return kind;
|
|
130
|
+
throw new Error(`Unknown kata kind: ${kind}. Expected ${ALL_LIST_KINDS.join(" | ")}.`);
|
|
131
|
+
}
|
|
132
|
+
// 既定は eject できる種別だけを返す。`all` は参照固定の exec-template / schema も含める。
|
|
133
|
+
// 参照固定の種別は ID を知る手段が他に無いため、一覧から辿れるようにしておく。
|
|
134
|
+
export function listKataResources(options = {}) {
|
|
135
|
+
const kind = assertKind(options.kind);
|
|
136
|
+
const configs = options.all || (kind !== undefined && !isEjectableKind(kind))
|
|
137
|
+
? RESOURCE_KINDS
|
|
138
|
+
: EJECTABLE_KINDS;
|
|
139
|
+
return configs
|
|
140
|
+
.filter((config) => kind === undefined || config.kind === kind)
|
|
141
|
+
.flatMap((config) => enumerateConfig(config, options.roots ?? {}))
|
|
142
|
+
.sort((first, second) => first.kind.localeCompare(second.kind) ||
|
|
143
|
+
first.relativePath.localeCompare(second.relativePath));
|
|
144
|
+
}
|
|
145
|
+
function localId(id) {
|
|
146
|
+
return id.includes(":") ? id.slice(id.lastIndexOf(":") + 1) : id;
|
|
147
|
+
}
|
|
148
|
+
function selectById(resources, id) {
|
|
149
|
+
const exact = resources.filter((resource) => resource.id === id);
|
|
150
|
+
const matches = exact.length > 0 ? exact : resources.filter((resource) => localId(resource.id) === id);
|
|
151
|
+
if (matches.length === 0)
|
|
152
|
+
throw new Error(`Kata not found: ${id}`);
|
|
153
|
+
if (matches.length > 1) {
|
|
154
|
+
throw new Error(`Kata ID is ambiguous: ${id}\n${matches.map((resource) => `- ${resource.id} (${resource.kind})`).join("\n")}`);
|
|
155
|
+
}
|
|
156
|
+
return matches[0];
|
|
157
|
+
}
|
|
158
|
+
// show は読み取りのみのため、参照固定の種別も対象にする。
|
|
159
|
+
export function findKataResource(id, options = {}) {
|
|
160
|
+
return selectById(listKataResources({ ...options, all: true }), id);
|
|
161
|
+
}
|
|
162
|
+
function bundledResources(configs, roots) {
|
|
163
|
+
return configs.flatMap((config) => {
|
|
164
|
+
const { repositoryDir, bundledDir } = pathsForConfig(config, roots);
|
|
165
|
+
return relativeFiles(bundledDir).map((filePath) => ({
|
|
166
|
+
id: resourceId(resolve(bundledDir, filePath)),
|
|
167
|
+
config,
|
|
168
|
+
relativePath: normalizeRelativePath(join(config.relativeDir, filePath)),
|
|
169
|
+
sourcePath: resolve(bundledDir, filePath),
|
|
170
|
+
destinationPath: resolve(repositoryDir, filePath),
|
|
171
|
+
}));
|
|
172
|
+
});
|
|
173
|
+
}
|
|
174
|
+
function selectBundledById(resources, id) {
|
|
175
|
+
const exact = resources.filter((resource) => resource.id === id);
|
|
176
|
+
const matches = exact.length > 0 ? exact : resources.filter((resource) => localId(resource.id) === id);
|
|
177
|
+
if (matches.length === 0)
|
|
178
|
+
throw new Error(`Bundled kata not found: ${id}`);
|
|
179
|
+
if (matches.length > 1) {
|
|
180
|
+
throw new Error(`Bundled kata ID is ambiguous: ${id}\n${matches
|
|
181
|
+
.map((resource) => `- ${resource.id} (${resource.config.kind})`)
|
|
182
|
+
.join("\n")}`);
|
|
183
|
+
}
|
|
184
|
+
return matches[0];
|
|
185
|
+
}
|
|
186
|
+
function copyBundledResource(resource, options) {
|
|
187
|
+
if (!resource.config.ejectable) {
|
|
188
|
+
throw new Error(`Internal error: ${resource.config.kind} is not ejectable.`);
|
|
189
|
+
}
|
|
190
|
+
const exists = existsSync(resource.destinationPath);
|
|
191
|
+
const samePath = resolve(resource.sourcePath) === resolve(resource.destinationPath);
|
|
192
|
+
const action = samePath || (exists && !options.force) ? "skip" : exists ? "overwrite" : "copy";
|
|
193
|
+
if (action !== "skip" && !options.dryRun) {
|
|
194
|
+
mkdirSync(dirname(resource.destinationPath), { recursive: true });
|
|
195
|
+
copyFileSync(resource.sourcePath, resource.destinationPath);
|
|
196
|
+
}
|
|
197
|
+
return {
|
|
198
|
+
id: resource.id,
|
|
199
|
+
kind: resource.config.kind,
|
|
200
|
+
relativePath: resource.relativePath,
|
|
201
|
+
action,
|
|
202
|
+
};
|
|
203
|
+
}
|
|
204
|
+
export function ejectKata(id, options = {}) {
|
|
205
|
+
const resource = selectBundledById(bundledResources(RESOURCE_KINDS, options.roots ?? {}), id);
|
|
206
|
+
if (!resource.config.ejectable) {
|
|
207
|
+
throw new Error(`Cannot eject ${resource.config.kind} '${resource.id}': ${resource.config.relativeDir} is tied to the installed SpecDojo version and must remain package-referenced.`);
|
|
208
|
+
}
|
|
209
|
+
return copyBundledResource(resource, options);
|
|
210
|
+
}
|
|
211
|
+
export function installAllKata(options = {}) {
|
|
212
|
+
return bundledResources(EJECTABLE_KINDS, options.roots ?? {}).map((resource) => copyBundledResource(resource, options));
|
|
213
|
+
}
|
|
214
|
+
function printCommandError(error) {
|
|
215
|
+
process.stdout.write(`${error instanceof Error ? error.message : String(error)}\n`);
|
|
216
|
+
process.exitCode = 1;
|
|
217
|
+
}
|
|
218
|
+
function printCopyResult(result, dryRun) {
|
|
219
|
+
const prefix = dryRun ? "DRY-RUN" : result.action.toUpperCase();
|
|
220
|
+
process.stdout.write(`${prefix}\t${result.action}\t${result.kind}\t${result.id}\t${result.relativePath}\n`);
|
|
221
|
+
}
|
|
222
|
+
export function registerKataCommands(program) {
|
|
223
|
+
const kata = program.command("kata").description("Inspect and copy SpecDojo kata resources");
|
|
224
|
+
kata
|
|
225
|
+
.command("list")
|
|
226
|
+
.description("List resolved kata resources and their source")
|
|
227
|
+
.option("--kind <kind>", `Filter by kind (${ALL_LIST_KINDS.join(" | ")})`)
|
|
228
|
+
.option("--all", "Include exec-template and schema, which cannot be ejected", false)
|
|
229
|
+
.option("--dry-run", "Read-only compatibility option", false)
|
|
230
|
+
.action((opts) => {
|
|
231
|
+
try {
|
|
232
|
+
process.stdout.write("KIND\tSOURCE\tEJECTABLE\tID\tPATH\n");
|
|
233
|
+
for (const resource of listKataResources({ kind: opts.kind, all: opts.all })) {
|
|
234
|
+
process.stdout.write(`${resource.kind}\t${resource.source}\t${resource.ejectable ? "yes" : "no"}\t${resource.id}\t${resource.relativePath}\n`);
|
|
235
|
+
}
|
|
236
|
+
}
|
|
237
|
+
catch (error) {
|
|
238
|
+
printCommandError(error);
|
|
239
|
+
}
|
|
240
|
+
});
|
|
241
|
+
kata
|
|
242
|
+
.command("show")
|
|
243
|
+
.description("Show a kata resource using repository-first resolution")
|
|
244
|
+
.argument("<id>", "Kata document ID")
|
|
245
|
+
.option("--kind <kind>", `Limit lookup to one kind (${KATA_RESOURCE_KINDS.join(" | ")})`)
|
|
246
|
+
.option("--dry-run", "Read-only compatibility option", false)
|
|
247
|
+
.action((id, opts) => {
|
|
248
|
+
try {
|
|
249
|
+
const resource = findKataResource(id, { kind: opts.kind });
|
|
250
|
+
const content = readFileSync(resource.resolvedPath, "utf8");
|
|
251
|
+
process.stdout.write(content.endsWith("\n") ? content : `${content}\n`);
|
|
252
|
+
}
|
|
253
|
+
catch (error) {
|
|
254
|
+
printCommandError(error);
|
|
255
|
+
}
|
|
256
|
+
});
|
|
257
|
+
kata
|
|
258
|
+
.command("status")
|
|
259
|
+
.description("Show referenced/ejected state and package differences")
|
|
260
|
+
.option("--kind <kind>", `Filter by kind (${KATA_RESOURCE_KINDS.join(" | ")})`)
|
|
261
|
+
.option("--dry-run", "Read-only compatibility option", false)
|
|
262
|
+
.action((opts) => {
|
|
263
|
+
try {
|
|
264
|
+
process.stdout.write("KIND\tSTATUS\tDIFF\tID\tPATH\n");
|
|
265
|
+
for (const resource of listKataResources({ kind: opts.kind })) {
|
|
266
|
+
process.stdout.write(`${resource.kind}\t${resource.state}\t${resource.difference}\t${resource.id}\t${resource.relativePath}\n`);
|
|
267
|
+
}
|
|
268
|
+
}
|
|
269
|
+
catch (error) {
|
|
270
|
+
printCommandError(error);
|
|
271
|
+
}
|
|
272
|
+
});
|
|
273
|
+
kata
|
|
274
|
+
.command("eject")
|
|
275
|
+
.description("Copy one bundled kata resource to its canonical repository path")
|
|
276
|
+
.requiredOption("--id <id>", "Bundled kata document ID")
|
|
277
|
+
.option("--dry-run", "Print the copy action without writing", false)
|
|
278
|
+
.option("--force", "Overwrite an existing repository file", false)
|
|
279
|
+
.action((opts) => {
|
|
280
|
+
try {
|
|
281
|
+
printCopyResult(ejectKata(opts.id, { dryRun: opts.dryRun, force: opts.force }), opts.dryRun);
|
|
282
|
+
}
|
|
283
|
+
catch (error) {
|
|
284
|
+
printCommandError(error);
|
|
285
|
+
}
|
|
286
|
+
});
|
|
287
|
+
kata
|
|
288
|
+
.command("install")
|
|
289
|
+
.description("Copy all ejectable bundled kata resources to the repository")
|
|
290
|
+
.requiredOption("--all", "Copy all rulebooks, standards, recipes, samples, and templates")
|
|
291
|
+
.option("--dry-run", "Print copy actions without writing", false)
|
|
292
|
+
.option("--force", "Overwrite existing repository files", false)
|
|
293
|
+
.action((opts) => {
|
|
294
|
+
try {
|
|
295
|
+
for (const result of installAllKata({ dryRun: opts.dryRun, force: opts.force })) {
|
|
296
|
+
printCopyResult(result, opts.dryRun);
|
|
297
|
+
}
|
|
298
|
+
}
|
|
299
|
+
catch (error) {
|
|
300
|
+
printCommandError(error);
|
|
301
|
+
}
|
|
302
|
+
});
|
|
303
|
+
}
|
package/dist/kata.js
ADDED
|
@@ -0,0 +1,187 @@
|
|
|
1
|
+
import { existsSync, readFileSync } from "node:fs";
|
|
2
|
+
import { specdojoRootDir } from "./specdojo-config.js";
|
|
3
|
+
import { readSpecdojoNamespace } from "./frontmatter-namespace.js";
|
|
4
|
+
import { practiceLocalId } from "./practice-id.js";
|
|
5
|
+
import { resolveSpecdojoPathIfExists, resolveSpecdojoReferencePathIfExists, specdojoResourceCandidates, } from "./template-resolution.js";
|
|
6
|
+
import { readYamlSchemaModelineRef } from "./yaml-schema-modeline.js";
|
|
7
|
+
// 実践の型(rulebook / recipe / sample / template)の解決を 1 か所に集約する。
|
|
8
|
+
// plan 生成(明示パスの注入)と validate(参照先の存在確認)の両方から使う。
|
|
9
|
+
const MISSING = "_MISSING_";
|
|
10
|
+
// 解決できなかった実践の型を表すマーカー。呼び出し側が解決結果を判定できるよう公開する。
|
|
11
|
+
export const KATA_MISSING = MISSING;
|
|
12
|
+
const DOCS_BASE = "docs/ja/specdojo";
|
|
13
|
+
const KIND_DIR = {
|
|
14
|
+
recipe: "recipes",
|
|
15
|
+
sample: "samples",
|
|
16
|
+
template: "templates",
|
|
17
|
+
};
|
|
18
|
+
function rulebookFsPath(rulebookId) {
|
|
19
|
+
const relativePath = `${DOCS_BASE}/rulebooks/${practiceLocalId(rulebookId)}.md`;
|
|
20
|
+
return (resolveSpecdojoPathIfExists(relativePath) ??
|
|
21
|
+
specdojoResourceCandidates(relativePath).repositoryPath);
|
|
22
|
+
}
|
|
23
|
+
// 実践の型種別 → repo ルート相対ディレクトリ。commit 許可リスト(maintenance / bootstrap 系
|
|
24
|
+
// approach で実践の型の変更を許可する範囲)の導出に使う。
|
|
25
|
+
export function kataDirsForKinds(kinds) {
|
|
26
|
+
return kinds.map((kind) => kind === "rulebook" ? `${DOCS_BASE}/rulebooks` : `${DOCS_BASE}/${KIND_DIR[kind]}`);
|
|
27
|
+
}
|
|
28
|
+
// rulebook frontmatter の recipe / sample / template / target_format を読む。
|
|
29
|
+
// ファイル不在・frontmatter なしの場合は空オブジェクトを返す。
|
|
30
|
+
export function loadRulebookRefs(rulebookId) {
|
|
31
|
+
const fsPath = rulebookFsPath(rulebookId);
|
|
32
|
+
if (!existsSync(fsPath))
|
|
33
|
+
return {};
|
|
34
|
+
// rulebook frontmatter は `specdojo:` 名前空間配下にある。
|
|
35
|
+
const fm = readSpecdojoNamespace(readFileSync(fsPath, "utf8"));
|
|
36
|
+
const str = (value) => typeof value === "string" && value !== "" ? value : undefined;
|
|
37
|
+
const strArray = (value) => Array.isArray(value)
|
|
38
|
+
? value.filter((v) => typeof v === "string" && v !== "")
|
|
39
|
+
: undefined;
|
|
40
|
+
const strOrArray = (value) => str(value) ?? strArray(value);
|
|
41
|
+
return {
|
|
42
|
+
recipe: str(fm.recipe),
|
|
43
|
+
sample: strOrArray(fm.sample),
|
|
44
|
+
template: str(fm.template),
|
|
45
|
+
target_format: str(fm.target_format),
|
|
46
|
+
includes: strArray(fm.includes),
|
|
47
|
+
};
|
|
48
|
+
}
|
|
49
|
+
// sample / template は対象成果物のフォーマットに合わせて拡張子が変わる。
|
|
50
|
+
function formatExt(targetFormat) {
|
|
51
|
+
return targetFormat === "yaml" ? "yaml" : targetFormat === "json" ? "json" : "md";
|
|
52
|
+
}
|
|
53
|
+
// Canonical repo-root-relative path (no leading slash): the agent opens these files
|
|
54
|
+
// from the run CWD (repo root or worktree root).
|
|
55
|
+
function repoPath(kind, id, ext) {
|
|
56
|
+
return `${DOCS_BASE}/${KIND_DIR[kind]}/${practiceLocalId(id)}.${ext}`;
|
|
57
|
+
}
|
|
58
|
+
// 宣言 ID は拡張子を持たないため、対象形式を優先しつつ実在する例外形式も解決する。
|
|
59
|
+
// dct-index の YAML 正本に対する Markdown 生成ビュー template などが該当する。
|
|
60
|
+
function declaredRefExt(kind, id, preferredExt) {
|
|
61
|
+
const candidates = kind === "recipe" ? ["md"] : [preferredExt, "md", "yaml", "json"];
|
|
62
|
+
for (const ext of [...new Set(candidates)]) {
|
|
63
|
+
if (resolveSpecdojoPathIfExists(repoPath(kind, id, ext)))
|
|
64
|
+
return ext;
|
|
65
|
+
}
|
|
66
|
+
return preferredExt;
|
|
67
|
+
}
|
|
68
|
+
// recipe / sample / template を 1 件解決する。
|
|
69
|
+
// rulebook frontmatter の宣言だけを正とする。未判断・不要・未宣言は MISSING を返す。
|
|
70
|
+
function resolveRef(kind, declaredId, ext) {
|
|
71
|
+
// 複数 sample は宣言順の先頭を既定例として使う。
|
|
72
|
+
const primaryId = Array.isArray(declaredId) ? declaredId[0] : declaredId;
|
|
73
|
+
if (primaryId === "none" || primaryId === "undecided" || primaryId === "not-needed") {
|
|
74
|
+
return MISSING;
|
|
75
|
+
}
|
|
76
|
+
if (primaryId) {
|
|
77
|
+
const relativePath = repoPath(kind, primaryId, declaredRefExt(kind, primaryId, ext));
|
|
78
|
+
return resolveSpecdojoReferencePathIfExists(relativePath) ?? relativePath;
|
|
79
|
+
}
|
|
80
|
+
return MISSING;
|
|
81
|
+
}
|
|
82
|
+
// 成果物の rulebook ID を起点に、recipe / sample / template の repo 相対パスを解決する。
|
|
83
|
+
// 要否と所在は rulebook frontmatter だけを正本とし、成果物カタログの宣言は参照しない。
|
|
84
|
+
// kind: generated は実践の型を適用しないため、rulebook 宣言の有無にかかわらず全項目を MISSING にする。
|
|
85
|
+
// 該当なしの項目は MISSING を返し、表示構造はテンプレート側に委ねる。
|
|
86
|
+
export function resolveKataRefs(rulebookId, targetKind) {
|
|
87
|
+
if (targetKind === "generated") {
|
|
88
|
+
return { rulebook: MISSING, recipe: MISSING, sample: MISSING, template: MISSING };
|
|
89
|
+
}
|
|
90
|
+
const usableRulebookId = rulebookId && rulebookId !== "none" && rulebookId !== "undecided" && rulebookId !== "not-needed"
|
|
91
|
+
? rulebookId
|
|
92
|
+
: undefined;
|
|
93
|
+
const fm = usableRulebookId ? loadRulebookRefs(usableRulebookId) : {};
|
|
94
|
+
return {
|
|
95
|
+
rulebook: usableRulebookId
|
|
96
|
+
? (resolveSpecdojoReferencePathIfExists(rulebookRepoPath(usableRulebookId)) ??
|
|
97
|
+
rulebookRepoPath(usableRulebookId))
|
|
98
|
+
: MISSING,
|
|
99
|
+
recipe: usableRulebookId ? resolveRef("recipe", fm.recipe, "md") : MISSING,
|
|
100
|
+
sample: usableRulebookId
|
|
101
|
+
? resolveRef("sample", fm.sample, formatExt(fm.target_format))
|
|
102
|
+
: MISSING,
|
|
103
|
+
template: usableRulebookId
|
|
104
|
+
? resolveRef("template", fm.template, formatExt(fm.target_format))
|
|
105
|
+
: MISSING,
|
|
106
|
+
};
|
|
107
|
+
}
|
|
108
|
+
// rulebook の repo 相対パス(先頭スラッシュ無し)。
|
|
109
|
+
function rulebookRepoPath(rulebookId) {
|
|
110
|
+
return `${DOCS_BASE}/rulebooks/${practiceLocalId(rulebookId)}.md`;
|
|
111
|
+
}
|
|
112
|
+
// 主 rulebook の frontmatter `includes` から、併せて適用する rulebook の宣言順・重複除去済み
|
|
113
|
+
// ID 一覧を返す。自己参照は除外する。単一段のみ(include 先の include はたどらない)。
|
|
114
|
+
function declaredIncludeIds(rulebookId) {
|
|
115
|
+
const fm = loadRulebookRefs(rulebookId);
|
|
116
|
+
const ids = fm.includes ?? [];
|
|
117
|
+
const seen = new Set();
|
|
118
|
+
const out = [];
|
|
119
|
+
for (const id of ids) {
|
|
120
|
+
if (id === rulebookId || seen.has(id))
|
|
121
|
+
continue;
|
|
122
|
+
seen.add(id);
|
|
123
|
+
out.push(id);
|
|
124
|
+
}
|
|
125
|
+
return out;
|
|
126
|
+
}
|
|
127
|
+
// plan 注入用: 主 rulebook が include する rulebook の repo 相対パス一覧。
|
|
128
|
+
// 実在するファイルのみを返す(不在の宣言は validate で警告する)。
|
|
129
|
+
export function resolveIncludedRulebooks(rulebookId) {
|
|
130
|
+
if (!rulebookId ||
|
|
131
|
+
rulebookId === "none" ||
|
|
132
|
+
rulebookId === "undecided" ||
|
|
133
|
+
rulebookId === "not-needed") {
|
|
134
|
+
return [];
|
|
135
|
+
}
|
|
136
|
+
return declaredIncludeIds(rulebookId)
|
|
137
|
+
.filter((id) => existsSync(rulebookFsPath(id)))
|
|
138
|
+
.map((id) => resolveSpecdojoReferencePathIfExists(rulebookRepoPath(id)) ?? rulebookRepoPath(id));
|
|
139
|
+
}
|
|
140
|
+
// validate 用: 主 rulebook が宣言する include の一覧(実在に関わらず)。
|
|
141
|
+
// 自己参照フラグ付きで返し、呼び出し側で存在・種別を検査する。
|
|
142
|
+
export function declaredIncludes(rulebookId) {
|
|
143
|
+
const fm = loadRulebookRefs(rulebookId);
|
|
144
|
+
const ids = fm.includes ?? [];
|
|
145
|
+
const seen = new Set();
|
|
146
|
+
const out = [];
|
|
147
|
+
for (const id of ids) {
|
|
148
|
+
if (seen.has(id))
|
|
149
|
+
continue;
|
|
150
|
+
seen.add(id);
|
|
151
|
+
out.push({ id, fsPath: rulebookFsPath(id), selfReference: id === rulebookId });
|
|
152
|
+
}
|
|
153
|
+
return out;
|
|
154
|
+
}
|
|
155
|
+
// 成果物を検証する schema の repo 相対パスを、対象 YAML の yaml-language-server
|
|
156
|
+
// modeline から解決する。schema の正本は rulebook frontmatter や命名規約ではなく
|
|
157
|
+
// YAML ファイル自身の先頭宣言である。
|
|
158
|
+
export function resolveDeliverableSchemaRef(deliverablePath) {
|
|
159
|
+
const relativePath = readYamlSchemaModelineRef(specdojoRootDir(), deliverablePath);
|
|
160
|
+
if (!relativePath)
|
|
161
|
+
return MISSING;
|
|
162
|
+
return resolveSpecdojoReferencePathIfExists(relativePath) ?? relativePath;
|
|
163
|
+
}
|
|
164
|
+
// rulebook frontmatter で宣言された recipe / sample / template の絶対パス一覧。
|
|
165
|
+
// not-needed・undecided・旧 none・未宣言は含めない(validate で存在確認するため)。
|
|
166
|
+
export function declaredKata(rulebookId) {
|
|
167
|
+
const fm = loadRulebookRefs(rulebookId);
|
|
168
|
+
const out = [];
|
|
169
|
+
const add = (kind, value, ext) => {
|
|
170
|
+
const ids = Array.isArray(value) ? value : value ? [value] : [];
|
|
171
|
+
for (const id of ids) {
|
|
172
|
+
if (id === "none" || id === "not-needed" || id === "undecided")
|
|
173
|
+
continue;
|
|
174
|
+
const relativePath = repoPath(kind, id, declaredRefExt(kind, id, ext));
|
|
175
|
+
out.push({
|
|
176
|
+
kind,
|
|
177
|
+
id,
|
|
178
|
+
fsPath: resolveSpecdojoPathIfExists(relativePath) ??
|
|
179
|
+
specdojoResourceCandidates(relativePath).repositoryPath,
|
|
180
|
+
});
|
|
181
|
+
}
|
|
182
|
+
};
|
|
183
|
+
add("recipe", fm.recipe, "md");
|
|
184
|
+
add("sample", fm.sample, formatExt(fm.target_format));
|
|
185
|
+
add("template", fm.template, formatExt(fm.target_format));
|
|
186
|
+
return out;
|
|
187
|
+
}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import { readFileSync } from "node:fs";
|
|
2
|
+
import path from "node:path";
|
|
3
|
+
import { fileURLToPath } from "node:url";
|
|
4
|
+
// このモジュールは開発時は src/、npm 配布時は dist/ 直下にある。
|
|
5
|
+
// どちらの場合もモジュールの親ディレクトリが SpecDojo package のルートになる。
|
|
6
|
+
//
|
|
7
|
+
// SPECDOJO_PACKAGE_ROOT は参照先の package を明示的に差し替える。利用リポジトリに kata を
|
|
8
|
+
// 持たない構成では、モジュール位置から求めた package が自動で参照されるため、単体テストの
|
|
9
|
+
// 一時ディレクトリが開発リポジトリの kata へ解決されてしまう。テストと検証では、この変数へ
|
|
10
|
+
// 一時ディレクトリを指定して解決範囲を閉じる。
|
|
11
|
+
function moduleRelativePackageRoot() {
|
|
12
|
+
return path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
|
|
13
|
+
}
|
|
14
|
+
export function specdojoPackageRootDir() {
|
|
15
|
+
const override = process.env.SPECDOJO_PACKAGE_ROOT;
|
|
16
|
+
if (override && override.trim() !== "")
|
|
17
|
+
return path.resolve(override);
|
|
18
|
+
return moduleRelativePackageRoot();
|
|
19
|
+
}
|
|
20
|
+
function isRecord(value) {
|
|
21
|
+
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
22
|
+
}
|
|
23
|
+
// CLI が報告する版。`package.json` を唯一の出所とし、`npm version` の更新へ自動で追従する。
|
|
24
|
+
// SPECDOJO_PACKAGE_ROOT は kata の参照先を差し替えるための変数であり、実行中の CLI 自身の
|
|
25
|
+
// 版とは無関係なため、ここでは参照しない。
|
|
26
|
+
export function specdojoPackageVersion() {
|
|
27
|
+
const packageJsonPath = path.join(moduleRelativePackageRoot(), "package.json");
|
|
28
|
+
const parsed = JSON.parse(readFileSync(packageJsonPath, "utf8"));
|
|
29
|
+
if (isRecord(parsed) && typeof parsed.version === "string" && parsed.version !== "") {
|
|
30
|
+
return parsed.version;
|
|
31
|
+
}
|
|
32
|
+
throw new Error(`version を読み取れません: ${packageJsonPath}`);
|
|
33
|
+
}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
export const SPECDOJO_PRACTICE_AUTHORITY = "specdojo";
|
|
2
|
+
const AUTHORITY_RE = /^[a-z][a-z0-9-]*$/;
|
|
3
|
+
const LOCAL_ID_RE = /^[a-z0-9][a-z0-9-]*$/;
|
|
4
|
+
// An authority expresses logical ownership and never becomes part of a filename.
|
|
5
|
+
export function parsePracticeId(id) {
|
|
6
|
+
const separator = id.indexOf(":");
|
|
7
|
+
if (separator < 0)
|
|
8
|
+
return { localId: id };
|
|
9
|
+
const authority = id.slice(0, separator);
|
|
10
|
+
const localId = id.slice(separator + 1);
|
|
11
|
+
if (!AUTHORITY_RE.test(authority) || !LOCAL_ID_RE.test(localId) || localId.includes(":")) {
|
|
12
|
+
throw new Error(`Invalid practice ID: ${id}`);
|
|
13
|
+
}
|
|
14
|
+
return { authority, localId };
|
|
15
|
+
}
|
|
16
|
+
export function practiceLocalId(id) {
|
|
17
|
+
return parsePracticeId(id).localId;
|
|
18
|
+
}
|
|
19
|
+
export function qualifyPracticeId(authority, id) {
|
|
20
|
+
if (!AUTHORITY_RE.test(authority))
|
|
21
|
+
throw new Error(`Invalid practice authority: ${authority}`);
|
|
22
|
+
const parsed = parsePracticeId(id);
|
|
23
|
+
return parsed.authority ? id : `${authority}:${parsed.localId}`;
|
|
24
|
+
}
|
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
import { DEFAULT_REGISTER_DATE_TIMEZONE } from "./specdojo-config.js";
|
|
2
|
+
// 登録項目の日時(registered_at / completed_at)と、そこから導出する表示日の共通ヘルパー。
|
|
3
|
+
//
|
|
4
|
+
// 保存形式は UTC・RFC 3339・秒精度(`YYYY-MM-DDTHH:MM:SSZ`)に固定する。瞬間そのものを
|
|
5
|
+
// 一意に表せるため、実行環境(OS / コンテナ)の TZ 環境変数にも表示側の都合にも依存しない。
|
|
6
|
+
// 一覧・派生ビューの「登録日」「完了日」は、この瞬間をプロジェクトの登録日タイムゾーン
|
|
7
|
+
// (run.register_date_timezone、既定 UTC)へ変換した暦日として導出する。
|
|
8
|
+
// 期限(due_on)は瞬間ではなく同タイムゾーン上の暦日そのものなので、日付のまま扱う。
|
|
9
|
+
// 保存する日時の書式。秒精度・UTC(`Z`)のみを正とする。
|
|
10
|
+
export const REGISTER_TIMESTAMP_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$/;
|
|
11
|
+
// 旧 registered_on / completed_on から移行する際、時刻が復元できない場合に補う
|
|
12
|
+
// プロジェクトタイムゾーン上の時刻。暦日の表示を変えない範囲で、その日の遅い時刻を選ぶ。
|
|
13
|
+
export const REGISTER_FALLBACK_TIME_OF_DAY = "21:00:00";
|
|
14
|
+
const DATE_ONLY_RE = /^\d{4}-\d{2}-\d{2}$/;
|
|
15
|
+
// 受け付ける入力形式。タイムゾーン(`Z` またはオフセット)を必須にし、
|
|
16
|
+
// ローカル時刻の解釈が実行環境に依存する表記は受け付けない。
|
|
17
|
+
const RFC3339_RE = /^(\d{4})-(\d{2})-(\d{2})[Tt ](\d{2}):(\d{2}):(\d{2})(?:\.\d+)?(?:[Zz]|[+-]\d{2}:\d{2})$/;
|
|
18
|
+
const TIME_OF_DAY_RE = /^(\d{2}):(\d{2}):(\d{2})$/;
|
|
19
|
+
// 指定した IANA タイムゾーンでの暦日を YYYY-MM-DD 形式で返す。
|
|
20
|
+
// timeZone が不正な場合は Intl.DateTimeFormat が RangeError を投げる。文脈を補って再送出する。
|
|
21
|
+
export function formatDateInTimeZone(date, timeZone) {
|
|
22
|
+
const parts = formatPartsInTimeZone(date, timeZone, {
|
|
23
|
+
year: "numeric",
|
|
24
|
+
month: "2-digit",
|
|
25
|
+
day: "2-digit",
|
|
26
|
+
});
|
|
27
|
+
const pick = (type) => parts.find((part) => part.type === type)?.value ?? "";
|
|
28
|
+
return `${pick("year")}-${pick("month")}-${pick("day")}`;
|
|
29
|
+
}
|
|
30
|
+
// 指定した IANA タイムゾーンでの「今日」の暦日を YYYY-MM-DD 形式で返す。
|
|
31
|
+
export function todayInTimeZone(timeZone) {
|
|
32
|
+
return formatDateInTimeZone(new Date(), timeZone);
|
|
33
|
+
}
|
|
34
|
+
// config から対象プロジェクトの登録日タイムゾーンを解決する。未設定なら既定値(UTC)。
|
|
35
|
+
export function resolveRegisterDateTimeZone(config, projectId) {
|
|
36
|
+
const configured = config?.projects[projectId]?.run?.register_date_timezone?.trim();
|
|
37
|
+
return configured || DEFAULT_REGISTER_DATE_TIMEZONE;
|
|
38
|
+
}
|
|
39
|
+
// ================================
|
|
40
|
+
// Timestamps
|
|
41
|
+
// ================================
|
|
42
|
+
// Date を UTC・RFC 3339・秒精度の文字列へ整形する。ミリ秒は切り捨てる。
|
|
43
|
+
export function formatUtcTimestamp(date) {
|
|
44
|
+
const time = date.getTime();
|
|
45
|
+
if (Number.isNaN(time)) {
|
|
46
|
+
throw new Error("Cannot format an invalid Date as a register timestamp");
|
|
47
|
+
}
|
|
48
|
+
return new Date(Math.floor(time / 1000) * 1000).toISOString().replace(/\.\d{3}Z$/, "Z");
|
|
49
|
+
}
|
|
50
|
+
// 現在時刻を UTC・RFC 3339・秒精度で返す。register add / close / reject の既定値になる。
|
|
51
|
+
export function nowUtcTimestamp() {
|
|
52
|
+
return formatUtcTimestamp(new Date());
|
|
53
|
+
}
|
|
54
|
+
// CLI などから受け取った日時を UTC・秒精度へ正規化する。タイムゾーンを含まない表記は、
|
|
55
|
+
// 実行環境のローカル時刻として解釈されうるため受け付けない。
|
|
56
|
+
export function normalizeRegisterTimestamp(value, label) {
|
|
57
|
+
const text = value.trim();
|
|
58
|
+
if (!RFC3339_RE.test(text)) {
|
|
59
|
+
throw new Error(`Invalid ${label}: "${value}". Must be an RFC 3339 date-time with a time zone ` +
|
|
60
|
+
`(e.g., 2026-08-09T14:08:51Z or 2026-08-09T23:08:51+09:00)`);
|
|
61
|
+
}
|
|
62
|
+
const parsed = new Date(text.replace(" ", "T"));
|
|
63
|
+
if (Number.isNaN(parsed.getTime())) {
|
|
64
|
+
throw new Error(`Invalid ${label}: "${value}". Not a valid date-time`);
|
|
65
|
+
}
|
|
66
|
+
return formatUtcTimestamp(parsed);
|
|
67
|
+
}
|
|
68
|
+
// 保存済みの日時から、指定タイムゾーン上の表示用暦日を導出する。
|
|
69
|
+
export function registerDateFromTimestamp(timestamp, timeZone) {
|
|
70
|
+
const parsed = new Date(timestamp);
|
|
71
|
+
if (Number.isNaN(parsed.getTime())) {
|
|
72
|
+
throw new Error(`Invalid register timestamp: "${timestamp}". Must be RFC 3339 (UTC)`);
|
|
73
|
+
}
|
|
74
|
+
return formatDateInTimeZone(parsed, timeZone);
|
|
75
|
+
}
|
|
76
|
+
// 指定タイムゾーンの暦日と時刻(壁時計)に対応する瞬間を UTC の日時へ変換する。
|
|
77
|
+
// 旧 registered_on / completed_on の移行と、旧一覧の日付セルの読み取りで使う。
|
|
78
|
+
export function timestampFromDateInTimeZone(date, timeZone, timeOfDay = REGISTER_FALLBACK_TIME_OF_DAY) {
|
|
79
|
+
if (!DATE_ONLY_RE.test(date)) {
|
|
80
|
+
throw new Error(`Invalid register date: "${date}". Must be YYYY-MM-DD`);
|
|
81
|
+
}
|
|
82
|
+
const time = TIME_OF_DAY_RE.exec(timeOfDay);
|
|
83
|
+
if (!time) {
|
|
84
|
+
throw new Error(`Invalid time of day: "${timeOfDay}". Must be HH:MM:SS`);
|
|
85
|
+
}
|
|
86
|
+
const [year, month, day] = date.split("-").map(Number);
|
|
87
|
+
const wallClockMs = Date.UTC(year, month - 1, day, Number(time[1]), Number(time[2]), Number(time[3]));
|
|
88
|
+
// 壁時計時刻からその瞬間の UTC オフセットは直接は決まらないため、暫定値で1度求めた
|
|
89
|
+
// オフセットを使って補正し、補正後の瞬間で再評価する(DST 切り替え日を跨ぐ場合の補正)。
|
|
90
|
+
let instantMs = wallClockMs - timeZoneOffsetMs(new Date(wallClockMs), timeZone);
|
|
91
|
+
instantMs = wallClockMs - timeZoneOffsetMs(new Date(instantMs), timeZone);
|
|
92
|
+
return formatUtcTimestamp(new Date(instantMs));
|
|
93
|
+
}
|
|
94
|
+
// ================================
|
|
95
|
+
// Internal
|
|
96
|
+
// ================================
|
|
97
|
+
function formatPartsInTimeZone(date, timeZone, options) {
|
|
98
|
+
try {
|
|
99
|
+
// en-CA ロケールは既定で YYYY-MM-DD 並びだが、formatToParts で桁を明示的に組み立てる。
|
|
100
|
+
return new Intl.DateTimeFormat("en-CA", { timeZone, ...options }).formatToParts(date);
|
|
101
|
+
}
|
|
102
|
+
catch (error) {
|
|
103
|
+
const detail = error instanceof Error ? error.message : String(error);
|
|
104
|
+
throw new Error(`Invalid register_date_timezone: "${timeZone}". Use an IANA time zone name (e.g., UTC, Asia/Tokyo). ${detail}`);
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
// 指定した瞬間における、そのタイムゾーンの UTC オフセット(ミリ秒)を返す。
|
|
108
|
+
function timeZoneOffsetMs(instant, timeZone) {
|
|
109
|
+
const parts = formatPartsInTimeZone(instant, timeZone, {
|
|
110
|
+
year: "numeric",
|
|
111
|
+
month: "2-digit",
|
|
112
|
+
day: "2-digit",
|
|
113
|
+
hour: "2-digit",
|
|
114
|
+
minute: "2-digit",
|
|
115
|
+
second: "2-digit",
|
|
116
|
+
hourCycle: "h23",
|
|
117
|
+
});
|
|
118
|
+
const pick = (type) => Number(parts.find((part) => part.type === type)?.value ?? "0");
|
|
119
|
+
const asIfUtcMs = Date.UTC(pick("year"), pick("month") - 1, pick("day"), pick("hour"), pick("minute"), pick("second"));
|
|
120
|
+
// 秒未満の情報は formatToParts に含まれないため、比較前に瞬間側も秒へ丸める。
|
|
121
|
+
return asIfUtcMs - Math.floor(instant.getTime() / 1000) * 1000;
|
|
122
|
+
}
|