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
package/LICENSE
ADDED
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2025 Tiny Shrine
|
|
4
|
+
Authored by naoji3x
|
|
5
|
+
|
|
6
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
7
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
8
|
+
in the Software without restriction, including without limitation the rights
|
|
9
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
10
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
11
|
+
furnished to do so, subject to the following conditions:
|
|
12
|
+
|
|
13
|
+
The above copyright notice and this permission notice shall be included in all
|
|
14
|
+
copies or substantial portions of the Software.
|
|
15
|
+
|
|
16
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
17
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
18
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
19
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
20
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
21
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
22
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,59 +1,166 @@
|
|
|
1
|
-
#
|
|
1
|
+
# SpecDojo
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
SpecDojo は、仕様駆動開発のためのドキュメントフレームワークです。
|
|
4
|
+
プロダクトの構築・改修に必要な情報を体系化し、人と生成 AI が同じ成果物を作成・検証・更新できるようにします。
|
|
4
5
|
|
|
5
|
-
|
|
6
|
+
**登録簿ひとつから始められます。** 設定 2 行で使い始め、必要になった分だけ広げられます。
|
|
6
7
|
|
|
7
|
-
|
|
8
|
-
|
|
8
|
+
## できること
|
|
9
|
+
|
|
10
|
+
### 気づいたことを、型に沿って残せる
|
|
11
|
+
|
|
12
|
+
作業だけでなく、判断・保留・観測・リスク・変更要求も同じ登録簿へ記録します。種別を選ぶと
|
|
13
|
+
本文の章構成が与えられるため、「選択肢を比較して理由を書く」といった記録が形を保ちます。
|
|
14
|
+
正本は Markdown なので、`git log` でそのまま読め、3 年後も SpecDojo なしで読めます。
|
|
15
|
+
決定ログ・課題ログ・リスク登録簿は、この記録から生成されます。
|
|
16
|
+
|
|
17
|
+
### 会話で進められる
|
|
18
|
+
|
|
19
|
+
同梱の対話型オーケストレーターを配置すると、やりたいことを話すだけで進みます。
|
|
20
|
+
調査や議論の内容がそのまま個票の本文になるため、別途まとめ直す必要がありません。
|
|
21
|
+
状態を変える操作は実行前に提示して承認を求め、`git push` や破壊的操作は行いません。
|
|
22
|
+
|
|
23
|
+
### 必要になったら、成果物の型へ広げられる
|
|
24
|
+
|
|
25
|
+
要件、設計、テスト、運用まで 100 種類以上の記述規則・手順・テンプレート・サンプルを持ちます。
|
|
26
|
+
使うものだけをカタログで宣言し、型に沿って作れます。最初から全部を用意する必要はありません。
|
|
27
|
+
|
|
28
|
+
日本語ドキュメントは [SpecDojo ドキュメントサイト](https://specdojo.github.io/specdojo/ja/) で公開しています。
|
|
29
|
+
|
|
30
|
+
## この README の役割
|
|
31
|
+
|
|
32
|
+
この README は、GitHub やパッケージページでリポジトリを訪れた人に、SpecDojo の概要、入手方法、詳しい文書への入口を示します。
|
|
33
|
+
文書体系や CLI 操作の詳細はここへ複製せず、ドキュメントサイトを正本とします。
|
|
34
|
+
|
|
35
|
+
## 使い始める
|
|
36
|
+
|
|
37
|
+
### npm で導入する
|
|
38
|
+
|
|
39
|
+
既定では、プロダクトリポジトリ `app1/` の隣に SpecDojo 専用リポジトリ
|
|
40
|
+
`app1-specdojo/` と worktree 用ディレクトリ `app1-worktrees/` を置く Detached Unit で始めます。
|
|
41
|
+
workspace 直下で次を実行します。
|
|
42
|
+
|
|
43
|
+
```sh
|
|
44
|
+
mkdir app1-specdojo app1-worktrees
|
|
45
|
+
git -C app1-specdojo init
|
|
46
|
+
cd app1-specdojo
|
|
47
|
+
npm init -y
|
|
48
|
+
npm install --save-dev specdojo @specdojo/docs-lint
|
|
49
|
+
npx specdojo config init
|
|
9
50
|
```
|
|
10
51
|
|
|
11
|
-
|
|
52
|
+
SpecDojo は文書と実行管理のためのツールで、成果物へ同梱されるものではないため `--save-dev` で導入します。あわせて、kata は `node_modules/specdojo` から参照されるため、`package-lock.json` が kata の版も固定します。グローバル導入(`npm install -g`)では版がプロジェクトに記録されず再現できません。
|
|
53
|
+
|
|
54
|
+
`config init` は `.specdojo/specdojo.config.json` とその親ディレクトリを作成します。既定では
|
|
55
|
+
`prj-0001` と `docs/ja/projects/prj-0001/controls/project-register` を使う最小構成です。別の
|
|
56
|
+
project ID や配置を使う場合は、生成された設定の `current_project`、`projects` のキー、
|
|
57
|
+
`base_path` を次へ進む前に変更してください。catalog や schedule へ進むときに追加するキーは
|
|
58
|
+
[SpecDojo設定リファレンス](https://specdojo.github.io/specdojo/ja/specdojo/references/specdojo-config-reference.html)で確認できます。
|
|
59
|
+
|
|
60
|
+
### オーケストレーターを配置する
|
|
61
|
+
|
|
62
|
+
SpecDojo は対話型オーケストレーターを同梱しています。CLI を直接叩く代わりに、会話で意図を伝えると、
|
|
63
|
+
対応するコマンドを提案し、承認を得てから実行します。利用する provider の設定を配置します。
|
|
12
64
|
|
|
13
|
-
```
|
|
14
|
-
npx specdojo --
|
|
65
|
+
```sh
|
|
66
|
+
npx specdojo config scaffold --provider claude
|
|
15
67
|
```
|
|
16
68
|
|
|
17
|
-
|
|
69
|
+
`--provider` には `antigravity`、`claude`、`codex`、`copilot`、`opencode` を指定できます。
|
|
70
|
+
オーケストレーターの配置先と起動方法は provider ごとに異なります。
|
|
18
71
|
|
|
19
|
-
|
|
72
|
+
| provider | 配置先 | 起動 |
|
|
73
|
+
| ------------- | ------------------------------------------- | -------------------------------------------------------------------------- |
|
|
74
|
+
| `claude` | `.claude/agents/specdojo-orchestrator.md` | `claude --agent specdojo-orchestrator` |
|
|
75
|
+
| `opencode` | `.opencode/agents/specdojo-orchestrator.md` | `opencode --agent specdojo-orchestrator` |
|
|
76
|
+
| `codex` | `.specdojo/codex/orchestrator.md` | `codex "$(cat .specdojo/codex/orchestrator.md)"` |
|
|
77
|
+
| `antigravity` | `.specdojo/antigravity/orchestrator.md` | `agy --add-dir "$(pwd)" -i "$(cat .specdojo/antigravity/orchestrator.md)"` |
|
|
20
78
|
|
|
21
|
-
|
|
22
|
-
|
|
79
|
+
`claude` と `opencode` は agent の定義ファイルを名前で選べるため、`--agent` で起動します。`codex` と
|
|
80
|
+
`antigravity` は定義ファイルから agent を選ぶ仕組みを持たないため、規範の本文を起動時の指示として
|
|
81
|
+
渡します。antigravity の `.agents/` は rules と skills のためのディレクトリで、agent の定義は扱いません。
|
|
82
|
+
rules へ置くと全セッションへ読み込まれ、executor として起動したときにも役割が混入します。
|
|
83
|
+
|
|
84
|
+
配置されるファイルにはモデル名が書かれています。手元で使えるモデルに合わせて編集してください。
|
|
85
|
+
executor / reporter の設定も同時に配置されるので、agent にタスクを実行させる段階で使います。
|
|
86
|
+
|
|
87
|
+
### 会話で操作する
|
|
88
|
+
|
|
89
|
+
起動したら、やりたいことをそのまま伝えます。オーケストレーターがコマンドへ翻訳し、実行前に内容を提示します。
|
|
90
|
+
|
|
91
|
+
```text
|
|
92
|
+
あなた : このプロジェクトを始めたい。まず登録簿を用意して、最初の作業を起票して。
|
|
93
|
+
agent : 次を実行します。よろしいですか。
|
|
94
|
+
npx specdojo register scaffold --project prj-0001
|
|
95
|
+
npx specdojo register add --project prj-0001 --type todo --title "..."
|
|
96
|
+
あなた : お願いします。
|
|
23
97
|
```
|
|
24
98
|
|
|
25
|
-
|
|
99
|
+
状態を変える操作は承認を得てから実行し、`git push` や破壊的操作は行いません。起票した項目の
|
|
100
|
+
実行、状況の確認、成果物の生成も同じ流れで進みます。
|
|
26
101
|
|
|
27
|
-
```
|
|
28
|
-
|
|
102
|
+
```text
|
|
103
|
+
PJR-XXXX を実行して
|
|
104
|
+
今の状況は?
|
|
105
|
+
kata の rulebook を確認したい
|
|
29
106
|
```
|
|
30
107
|
|
|
31
|
-
|
|
108
|
+
詳しい進め方は [オーケストレーター運用ガイド](https://specdojo.github.io/specdojo/ja/specdojo/guides/orchestrator-operation-guide.html) を参照してください。
|
|
32
109
|
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
110
|
+
### CLI を直接使う
|
|
111
|
+
|
|
112
|
+
agent を使わずに操作することもできます。最初の登録簿と todo を作り、一覧を生成します。
|
|
113
|
+
|
|
114
|
+
```sh
|
|
115
|
+
npx specdojo register scaffold --project prj-0001
|
|
116
|
+
npx specdojo register add \
|
|
117
|
+
--project prj-0001 \
|
|
118
|
+
--type todo \
|
|
119
|
+
--title "最初のタスク"
|
|
120
|
+
npx specdojo register build --project prj-0001
|
|
36
121
|
```
|
|
37
122
|
|
|
38
|
-
|
|
123
|
+
ここまでの手順は、利用側へ kata をコピーせずに実行できます。生成された todo の個票が編集対象、
|
|
124
|
+
`generated/pjr-index.md` が個票から作る一覧です。`register add` が表示した ID を使い、agent を
|
|
125
|
+
起動せずに exec plan の内容まで確認できます。
|
|
39
126
|
|
|
40
|
-
```
|
|
41
|
-
specdojo exec
|
|
127
|
+
```sh
|
|
128
|
+
npx specdojo exec plan --project prj-0001 --register PJR-XXXX
|
|
42
129
|
```
|
|
43
130
|
|
|
44
|
-
|
|
131
|
+
kata は既定で npm package 内のものを参照します。適用中の rulebook を確認し、プロジェクトで
|
|
132
|
+
上書きする場合だけ eject します。
|
|
133
|
+
|
|
134
|
+
```sh
|
|
135
|
+
npx specdojo kata list --kind rulebook
|
|
136
|
+
npx specdojo kata show specdojo:pjr-rulebook
|
|
137
|
+
npx specdojo kata eject --id specdojo:pjr-rulebook
|
|
138
|
+
```
|
|
45
139
|
|
|
46
|
-
|
|
140
|
+
provider と agent の設定を終えた後は、同じ登録項目を実行できます。成功後は人が result と成果物を
|
|
141
|
+
確認し、登録項目を close します。
|
|
47
142
|
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
"version": 1,
|
|
51
|
-
"projects": {
|
|
52
|
-
"shj-0001": {
|
|
53
|
-
"schedule_path": "docs/ja/sdh-ja-projects/prj-0001/060-schedule",
|
|
54
|
-
"execution_path": "docs/ja/sdh-ja-projects/prj-0001/070-execution",
|
|
55
|
-
"members_path": "docs/ja/sdh-ja-projects/prj-0001/040-project-management/010-management-plan/members.yaml"
|
|
56
|
-
}
|
|
57
|
-
}
|
|
58
|
-
}
|
|
143
|
+
```sh
|
|
144
|
+
npx specdojo exec run --project prj-0001 --register PJR-XXXX
|
|
59
145
|
```
|
|
146
|
+
|
|
147
|
+
agent の実行は数分から数十分かかり、`routine` は定期実行されます。作業端末の状態に依存せず
|
|
148
|
+
実行を続けたい場合は、常時稼働するホストへリモート接続する構成例を
|
|
149
|
+
[常時稼働ホスト運用ガイド](https://specdojo.github.io/specdojo/ja/specdojo/guides/remote-host-development-guide.html) に示しています。
|
|
150
|
+
|
|
151
|
+
### テンプレートリポジトリとして導入する
|
|
152
|
+
|
|
153
|
+
npm package の参照方式ではなく、SpecDojo のソースと文書体系一式を最初から配置して
|
|
154
|
+
カスタマイズする場合は、このリポジトリの **Use this template** から新しいリポジトリを作成します。
|
|
155
|
+
通常の利用開始には、更新差分を小さく保てる npm 導入を推奨します。
|
|
156
|
+
|
|
157
|
+
導入後の初期設定と、最初のタスクを完了するまでの手順は [Quick Start ガイド](https://specdojo.github.io/specdojo/ja/specdojo/guides/quick-start-guide.html) を参照してください。
|
|
158
|
+
全体像から確認する場合は [全体概要ガイド](https://specdojo.github.io/specdojo/ja/specdojo/guides/specdojo-overview-guide.html) を参照してください。
|
|
159
|
+
|
|
160
|
+
## ライセンス
|
|
161
|
+
|
|
162
|
+
本リポジトリは MIT ライセンスです。詳細は [LICENSE](LICENSE) を参照してください。
|
|
163
|
+
|
|
164
|
+
## フィードバック
|
|
165
|
+
|
|
166
|
+
Issue または Pull Request を歓迎します。
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
// agent の最終応答から JSON 本体を取り出す。
|
|
2
|
+
//
|
|
3
|
+
// plan で「JSON だけを出力する」と契約しても、provider やモデルによって前後に
|
|
4
|
+
// 文字列が付く。実測では claude と gemma がコードフェンスで囲み、qwen が作業経過の
|
|
5
|
+
// 前置きを残した。生の応答をそのまま JSON.parse すると、判定内容が妥当でも解析に
|
|
6
|
+
// 失敗する。
|
|
7
|
+
//
|
|
8
|
+
// Ollama の format 指定など provider 固有の出力強制は、他 provider へ適用できず、
|
|
9
|
+
// thinking を有効化した agent とも競合しうるため採らない。呼び出し側は抽出後の
|
|
10
|
+
// 文字列を検証するため、抽出に失敗しても不正な内容を受け入れることはない。
|
|
11
|
+
/**
|
|
12
|
+
* agent の生応答から JSON オブジェクトの本文を取り出す。
|
|
13
|
+
* 取り出せない場合は入力をそのまま返し、解析の失敗は呼び出し側の検証に委ねる。
|
|
14
|
+
*/
|
|
15
|
+
export function extractJsonText(raw) {
|
|
16
|
+
const unfenced = stripCodeFence(raw.trim());
|
|
17
|
+
const start = unfenced.indexOf("{");
|
|
18
|
+
const end = unfenced.lastIndexOf("}");
|
|
19
|
+
if (start === -1 || end <= start)
|
|
20
|
+
return unfenced;
|
|
21
|
+
return unfenced.slice(start, end + 1);
|
|
22
|
+
}
|
|
23
|
+
// 最初のコードフェンスの中身を返す。フェンスが無ければ入力をそのまま返す。
|
|
24
|
+
function stripCodeFence(text) {
|
|
25
|
+
const fenced = /```[a-z]*\r?\n([\s\S]*?)```/i.exec(text);
|
|
26
|
+
return fenced ? fenced[1].trim() : text;
|
|
27
|
+
}
|
package/dist/agent.js
ADDED
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
|
|
2
|
+
import { dirname, resolve } from "node:path";
|
|
3
|
+
import { defaultExecDefaultsPath, loadExecDefaultsConfig, resolveMemberCommand, resolveRateLimitDetection, resolveRateLimitPolicy, } from "./exec-agent-config.js";
|
|
4
|
+
import { resolveProjectPaths } from "./exec-project.js";
|
|
5
|
+
import { executeAgent, loadRosterForExecutionPath } from "./exec-run.js";
|
|
6
|
+
import { gitEnvironment } from "./git-environment.js";
|
|
7
|
+
import { specdojoRootDir } from "./specdojo-config.js";
|
|
8
|
+
// Rate limit は通常失敗と異なり、呼び出し側が処理済みにせず中断・再開する必要がある。
|
|
9
|
+
// shell script が出力文字列を解析せず分岐できるよう、一時失敗を表す専用コードにする。
|
|
10
|
+
export const AGENT_RUN_RATE_LIMIT_EXIT_CODE = 75;
|
|
11
|
+
export function resolveAgentMember(roster, nickname) {
|
|
12
|
+
const members = roster?.members.filter((candidate) => {
|
|
13
|
+
return candidate.type === "agent" && candidate.nickname === nickname;
|
|
14
|
+
});
|
|
15
|
+
if (!members || members.length === 0) {
|
|
16
|
+
return { error: `--by agent nickname not found in pm-members.yaml: ${nickname}` };
|
|
17
|
+
}
|
|
18
|
+
if (members.length !== 1) {
|
|
19
|
+
return { error: `--by agent nickname is not unique in pm-members.yaml: ${nickname}` };
|
|
20
|
+
}
|
|
21
|
+
const [member] = members;
|
|
22
|
+
if (member.disabled) {
|
|
23
|
+
return { error: `--by agent is disabled in pm-members.yaml: ${nickname}` };
|
|
24
|
+
}
|
|
25
|
+
return { member };
|
|
26
|
+
}
|
|
27
|
+
export function resolveAgentCommand(execDefaults, member) {
|
|
28
|
+
let command;
|
|
29
|
+
try {
|
|
30
|
+
command = resolveMemberCommand(execDefaults, member);
|
|
31
|
+
}
|
|
32
|
+
catch (error) {
|
|
33
|
+
return { error: error instanceof Error ? error.message : String(error) };
|
|
34
|
+
}
|
|
35
|
+
if (!command) {
|
|
36
|
+
return { error: `--by agent has no resolvable command: ${member.nickname}` };
|
|
37
|
+
}
|
|
38
|
+
return { command };
|
|
39
|
+
}
|
|
40
|
+
export function readAgentPlan(planPath) {
|
|
41
|
+
const absolutePath = resolve(planPath);
|
|
42
|
+
if (!existsSync(absolutePath)) {
|
|
43
|
+
throw new Error(`--plan not found: ${planPath}`);
|
|
44
|
+
}
|
|
45
|
+
const prompt = readFileSync(absolutePath, "utf8");
|
|
46
|
+
if (!prompt.trim()) {
|
|
47
|
+
throw new Error(`--plan is empty: ${planPath}`);
|
|
48
|
+
}
|
|
49
|
+
return prompt;
|
|
50
|
+
}
|
|
51
|
+
export function writeAgentOutput(outPath, stdout) {
|
|
52
|
+
const absolutePath = resolve(outPath);
|
|
53
|
+
mkdirSync(dirname(absolutePath), { recursive: true });
|
|
54
|
+
writeFileSync(absolutePath, stdout, "utf8");
|
|
55
|
+
return absolutePath;
|
|
56
|
+
}
|
|
57
|
+
export async function runAgentPlan(opts) {
|
|
58
|
+
const prompt = readAgentPlan(opts.planPath);
|
|
59
|
+
const paths = resolveProjectPaths({ project: opts.project });
|
|
60
|
+
const roster = loadRosterForExecutionPath(paths.executionPath);
|
|
61
|
+
const memberResult = resolveAgentMember(roster, opts.nickname);
|
|
62
|
+
if ("error" in memberResult)
|
|
63
|
+
throw new Error(memberResult.error);
|
|
64
|
+
const { member } = memberResult;
|
|
65
|
+
const execDefaults = loadExecDefaultsConfig(opts.execDefaultsPath ?? defaultExecDefaultsPath(), paths.executionPath);
|
|
66
|
+
const commandResult = resolveAgentCommand(execDefaults, member);
|
|
67
|
+
if ("error" in commandResult)
|
|
68
|
+
throw new Error(commandResult.error);
|
|
69
|
+
const { command } = commandResult;
|
|
70
|
+
if (opts.dryRun) {
|
|
71
|
+
process.stdout.write(`${command}\n`);
|
|
72
|
+
return { command, actor: member.nickname };
|
|
73
|
+
}
|
|
74
|
+
const execution = await executeAgent(command, prompt, resolveRateLimitDetection(execDefaults, member.provider), member.provider, resolveRateLimitPolicy(execDefaults, member.provider)?.cooldown_seconds, specdojoRootDir(), {
|
|
75
|
+
...gitEnvironment(),
|
|
76
|
+
SPECDOJO_SCHEDULE_PATH: paths.schedulePath,
|
|
77
|
+
SPECDOJO_EXECUTION_PATH: paths.executionPath,
|
|
78
|
+
}, opts.quiet);
|
|
79
|
+
return { execution, command, actor: member.nickname };
|
|
80
|
+
}
|
|
81
|
+
export function registerAgentCommands(program) {
|
|
82
|
+
const agent = program.command("agent").description("Run a plan with a specific agent");
|
|
83
|
+
agent
|
|
84
|
+
.command("run")
|
|
85
|
+
.description("Feed a plan to one agent and capture its stdout")
|
|
86
|
+
.requiredOption("--plan <path>", "Plan file passed to the agent on stdin")
|
|
87
|
+
.requiredOption("--by <nickname>", "Agent nickname defined in pm-members.yaml")
|
|
88
|
+
.option("--out <path>", "Write the agent stdout to this file instead of the terminal")
|
|
89
|
+
.option("--project <projectId>", "Project id in specdojo.config.json")
|
|
90
|
+
.option("--exec-defaults <path>", "Override the exec-defaults.yaml path")
|
|
91
|
+
.option("--dry-run", "Print the resolved command without executing", false)
|
|
92
|
+
.action(async (options) => {
|
|
93
|
+
try {
|
|
94
|
+
const { execution, command, actor } = await runAgentPlan({
|
|
95
|
+
planPath: options.plan,
|
|
96
|
+
nickname: options.by,
|
|
97
|
+
project: options.project,
|
|
98
|
+
execDefaultsPath: options.execDefaults,
|
|
99
|
+
dryRun: options.dryRun,
|
|
100
|
+
quiet: options.out !== undefined,
|
|
101
|
+
});
|
|
102
|
+
if (!execution)
|
|
103
|
+
return;
|
|
104
|
+
if (options.out) {
|
|
105
|
+
const writtenPath = writeAgentOutput(options.out, execution.stdout);
|
|
106
|
+
process.stdout.write(`Wrote agent stdout: ${writtenPath}\n`);
|
|
107
|
+
}
|
|
108
|
+
if (execution.result === "rate_limit") {
|
|
109
|
+
process.stderr.write(`rate limit: ${actor} (${command})` +
|
|
110
|
+
`${execution.limit?.resume_at ? ` resume_at=${execution.limit.resume_at}` : ""}\n`);
|
|
111
|
+
process.exitCode = AGENT_RUN_RATE_LIMIT_EXIT_CODE;
|
|
112
|
+
return;
|
|
113
|
+
}
|
|
114
|
+
if (execution.result === "failure") {
|
|
115
|
+
process.stderr.write(`agent failed: ${actor} exit=${execution.exitCode ?? "null"}\n`);
|
|
116
|
+
process.exitCode = 1;
|
|
117
|
+
}
|
|
118
|
+
}
|
|
119
|
+
catch (error) {
|
|
120
|
+
process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
|
|
121
|
+
process.exitCode = 1;
|
|
122
|
+
}
|
|
123
|
+
});
|
|
124
|
+
}
|
|
@@ -0,0 +1,149 @@
|
|
|
1
|
+
import { spawnSync } from "node:child_process";
|
|
2
|
+
import { loadConfig, loadEnv, specdojoRootDir } from "./specdojo-config.js";
|
|
3
|
+
import { selfRunArgs } from "./spawn-self.js";
|
|
4
|
+
const VALID_SCOPES = [
|
|
5
|
+
"exec",
|
|
6
|
+
"catalog",
|
|
7
|
+
"register",
|
|
8
|
+
"yaml-pages",
|
|
9
|
+
"dashboard",
|
|
10
|
+
"index",
|
|
11
|
+
"all",
|
|
12
|
+
];
|
|
13
|
+
// ================================
|
|
14
|
+
// Step Resolution
|
|
15
|
+
// ================================
|
|
16
|
+
function isStepApplicable(scope, project) {
|
|
17
|
+
if (scope === "yaml-pages" || scope === "index")
|
|
18
|
+
return true;
|
|
19
|
+
if (!project)
|
|
20
|
+
return false;
|
|
21
|
+
switch (scope) {
|
|
22
|
+
case "exec":
|
|
23
|
+
return !!(project.schedule_path?.trim() && project.execution_path?.trim());
|
|
24
|
+
case "catalog":
|
|
25
|
+
return !!project.catalog_path?.trim();
|
|
26
|
+
case "register":
|
|
27
|
+
return !!project.project_register_path?.trim();
|
|
28
|
+
case "dashboard":
|
|
29
|
+
// タスク実行中(execution_path 指定)のプロジェクトのみ。execution/generated/ に集約する。
|
|
30
|
+
return !!project.execution_path?.trim();
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
function resolveSteps(scope, projectArgs, project) {
|
|
34
|
+
const candidates = [
|
|
35
|
+
{
|
|
36
|
+
scope: "exec",
|
|
37
|
+
label: "exec refresh",
|
|
38
|
+
subArgs: ["exec", "refresh", ...projectArgs],
|
|
39
|
+
},
|
|
40
|
+
{
|
|
41
|
+
scope: "catalog",
|
|
42
|
+
label: "catalog build",
|
|
43
|
+
subArgs: ["catalog", "build", ...projectArgs],
|
|
44
|
+
},
|
|
45
|
+
{
|
|
46
|
+
scope: "register",
|
|
47
|
+
label: "register build",
|
|
48
|
+
subArgs: ["register", "build", ...projectArgs],
|
|
49
|
+
},
|
|
50
|
+
{
|
|
51
|
+
scope: "yaml-pages",
|
|
52
|
+
label: "yaml-pages build",
|
|
53
|
+
subArgs: ["yaml-pages", "build"],
|
|
54
|
+
},
|
|
55
|
+
// dashboard は execution/generated/dashboard.md + timeline Gantt SVG を生成する。
|
|
56
|
+
// state.json / ready.json(exec refresh)と tml-index / rtn-*.yaml / routine-state.json
|
|
57
|
+
// (routines)を機械可読な入力で集約するため、index build の手前に置く。
|
|
58
|
+
{
|
|
59
|
+
scope: "dashboard",
|
|
60
|
+
label: "dashboard build",
|
|
61
|
+
subArgs: ["dashboard", "build", ...projectArgs],
|
|
62
|
+
},
|
|
63
|
+
{
|
|
64
|
+
scope: "index",
|
|
65
|
+
label: "index build",
|
|
66
|
+
subArgs: ["index", "build"],
|
|
67
|
+
},
|
|
68
|
+
];
|
|
69
|
+
const active = scope === "all" ? candidates : candidates.filter((s) => s.scope === scope);
|
|
70
|
+
return active.filter((s) => isStepApplicable(s.scope, project));
|
|
71
|
+
}
|
|
72
|
+
// ================================
|
|
73
|
+
// Logging
|
|
74
|
+
// ================================
|
|
75
|
+
function log(msg) {
|
|
76
|
+
process.stdout.write(`[build] ${msg}\n`);
|
|
77
|
+
}
|
|
78
|
+
function logError(msg) {
|
|
79
|
+
process.stderr.write(`[build] ${msg}\n`);
|
|
80
|
+
}
|
|
81
|
+
// ================================
|
|
82
|
+
// Command Registration
|
|
83
|
+
// ================================
|
|
84
|
+
export function registerBuildCommand(program) {
|
|
85
|
+
program
|
|
86
|
+
.command("build")
|
|
87
|
+
.description("Run all build steps in sequence (exec → catalog → register → yaml-pages → dashboard → index)")
|
|
88
|
+
.option("--project <id>", "Project ID (specdojo.config.json)")
|
|
89
|
+
.option("--scope <scope>", `Build scope: ${VALID_SCOPES.join(" | ")}`, "all")
|
|
90
|
+
.option("--dry-run", "Print commands without executing", false)
|
|
91
|
+
.action((opts) => {
|
|
92
|
+
const scope = opts.scope;
|
|
93
|
+
if (!VALID_SCOPES.includes(scope)) {
|
|
94
|
+
logError(`Invalid scope: "${scope}". Must be one of: ${VALID_SCOPES.join(", ")}`);
|
|
95
|
+
process.exitCode = 1;
|
|
96
|
+
return;
|
|
97
|
+
}
|
|
98
|
+
loadEnv();
|
|
99
|
+
const { config, configPath } = loadConfig();
|
|
100
|
+
const baseDir = specdojoRootDir();
|
|
101
|
+
const projectId = opts.project?.trim() ||
|
|
102
|
+
process.env.SPECDOJO_PROJECT?.trim() ||
|
|
103
|
+
(config ? Object.keys(config.projects)[0] : undefined);
|
|
104
|
+
// Suppress unused variable warning — baseDir is kept for symmetry with other commands
|
|
105
|
+
void baseDir;
|
|
106
|
+
const project = config && projectId ? config.projects[projectId] : undefined;
|
|
107
|
+
if (projectId && config && !project) {
|
|
108
|
+
logError(`Unknown project: "${projectId}" (check ${configPath})`);
|
|
109
|
+
process.exitCode = 1;
|
|
110
|
+
return;
|
|
111
|
+
}
|
|
112
|
+
const projectArgs = projectId ? ["--project", projectId] : [];
|
|
113
|
+
const steps = resolveSteps(scope, projectArgs, project);
|
|
114
|
+
if (steps.length === 0) {
|
|
115
|
+
logError(`No applicable steps for scope "${scope}". ` +
|
|
116
|
+
`Check that required paths are configured in specdojo.config.json.`);
|
|
117
|
+
process.exitCode = 1;
|
|
118
|
+
return;
|
|
119
|
+
}
|
|
120
|
+
const total = steps.length;
|
|
121
|
+
if (opts.dryRun) {
|
|
122
|
+
for (let i = 0; i < total; i++) {
|
|
123
|
+
const step = steps[i];
|
|
124
|
+
const [cmd, args] = selfRunArgs(step.subArgs);
|
|
125
|
+
log(`step ${i + 1}/${total}: ${step.label} (dry-run)`);
|
|
126
|
+
log(` would run: ${cmd} ${args.join(" ")}`);
|
|
127
|
+
}
|
|
128
|
+
return;
|
|
129
|
+
}
|
|
130
|
+
const overallStart = Date.now();
|
|
131
|
+
for (let i = 0; i < total; i++) {
|
|
132
|
+
const step = steps[i];
|
|
133
|
+
log(`step ${i + 1}/${total}: ${step.label}`);
|
|
134
|
+
const start = Date.now();
|
|
135
|
+
const [cmd, args] = selfRunArgs(step.subArgs);
|
|
136
|
+
const result = spawnSync(cmd, args, { stdio: "inherit" });
|
|
137
|
+
const elapsed = ((Date.now() - start) / 1000).toFixed(1);
|
|
138
|
+
const exitCode = result.status ?? 1;
|
|
139
|
+
if (exitCode !== 0) {
|
|
140
|
+
logError(`error: ${step.label} exited with code ${exitCode} — aborting`);
|
|
141
|
+
process.exitCode = 1;
|
|
142
|
+
return;
|
|
143
|
+
}
|
|
144
|
+
log(`done: ${step.label} (${elapsed}s)`);
|
|
145
|
+
}
|
|
146
|
+
const totalElapsed = ((Date.now() - overallStart) / 1000).toFixed(1);
|
|
147
|
+
log(`all steps completed (${totalElapsed}s)`);
|
|
148
|
+
});
|
|
149
|
+
}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
// src が dist より新しい(または dist が無い)場合だけ `npm run build` を実行する。
|
|
3
|
+
//
|
|
4
|
+
// specdojo の bin は dist/specdojo.js を指すため、merge / checkout で src が更新された
|
|
5
|
+
// あとに再ビルドしないと、古い挙動のまま CLI が動作する。Git hook(post-merge /
|
|
6
|
+
// post-checkout)や `npm run build:if-stale` から呼び出すことを想定し、失敗しても
|
|
7
|
+
// 呼び出し元を止めない best-effort な処理にしている。最終的な安全網は
|
|
8
|
+
// dist-freshness.ts による CLI 起動時の鮮度ガードである。
|
|
9
|
+
import { existsSync, lstatSync } from "node:fs";
|
|
10
|
+
import path from "node:path";
|
|
11
|
+
import { fileURLToPath } from "node:url";
|
|
12
|
+
import { ensureFreshDistBuild } from "./dist-freshness.js";
|
|
13
|
+
function report(message) {
|
|
14
|
+
process.stderr.write(`[build-if-stale] ${message}\n`);
|
|
15
|
+
}
|
|
16
|
+
function isPrimaryWorktree(repoRoot) {
|
|
17
|
+
const gitEntry = path.join(repoRoot, ".git");
|
|
18
|
+
return existsSync(gitEntry) && lstatSync(gitEntry).isDirectory();
|
|
19
|
+
}
|
|
20
|
+
function main() {
|
|
21
|
+
const repoRoot = path.dirname(path.dirname(fileURLToPath(import.meta.url)));
|
|
22
|
+
if (!isPrimaryWorktree(repoRoot)) {
|
|
23
|
+
// linked worktree は dist を持たず、agent は tsx で src を直接実行するため対象外。
|
|
24
|
+
return;
|
|
25
|
+
}
|
|
26
|
+
const result = ensureFreshDistBuild(repoRoot);
|
|
27
|
+
if (result.message)
|
|
28
|
+
report(result.message);
|
|
29
|
+
}
|
|
30
|
+
try {
|
|
31
|
+
main();
|
|
32
|
+
}
|
|
33
|
+
catch (error) {
|
|
34
|
+
report(`鮮度判定に失敗した: ${error instanceof Error ? error.message : String(error)}`);
|
|
35
|
+
}
|