specdojo 0.1.0 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +22 -0
- package/README.md +82 -38
- 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 +980 -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 +45 -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 +15 -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 +55 -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 +473 -0
- package/docs/ja/specdojo/guides/register-operation-guide.md +418 -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 +120 -24
- 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/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/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/dist/exec-schedule-timeline-render.js +0 -201
- package/dist/exec-schedule-timeline.js +0 -2
|
@@ -0,0 +1,359 @@
|
|
|
1
|
+
import { spawnSync } from "node:child_process";
|
|
2
|
+
import { existsSync, lstatSync, mkdirSync, unlinkSync } from "node:fs";
|
|
3
|
+
import { isAbsolute, join, relative, resolve, sep } from "node:path";
|
|
4
|
+
import { stripTerminalControlSequences } from "./exec-shared.js";
|
|
5
|
+
import { gitEnvironment } from "./git-environment.js";
|
|
6
|
+
export { GIT_LOCAL_ENV_VARS, gitEnvironment } from "./git-environment.js";
|
|
7
|
+
// git serializes index access through .git/index.lock and fails immediately (no wait) when it
|
|
8
|
+
// cannot acquire it. Under `exec run --parallel`, the parent's root-index operations and the
|
|
9
|
+
// concurrent worktree commits (each firing lefthook pre-commit hooks that invoke git) contend
|
|
10
|
+
// for that lock, surfacing as "Unable to create '.../index.lock'". A failed lock acquisition
|
|
11
|
+
// happens before git mutates anything, so retrying the same command is safe and idempotent.
|
|
12
|
+
const INDEX_LOCK_RETRY_ATTEMPTS = 5;
|
|
13
|
+
const INDEX_LOCK_RETRY_BASE_MS = 50;
|
|
14
|
+
export function isGitIndexLockContention(stderr) {
|
|
15
|
+
return (/Unable to create '[^']*index\.lock'/.test(stderr) ||
|
|
16
|
+
/Another git process seems to be running/.test(stderr));
|
|
17
|
+
}
|
|
18
|
+
// Synchronously block the thread. gitResult is intentionally spawnSync-based (blocking), and we
|
|
19
|
+
// want to wait for a contended index.lock to be released before retrying rather than busy-loop.
|
|
20
|
+
function sleepSync(milliseconds) {
|
|
21
|
+
Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, milliseconds);
|
|
22
|
+
}
|
|
23
|
+
export function gitResult(repoRoot, args) {
|
|
24
|
+
const run = () => spawnSync("git", ["-C", repoRoot, ...args], {
|
|
25
|
+
encoding: "utf8",
|
|
26
|
+
env: gitEnvironment(),
|
|
27
|
+
stdio: ["ignore", "pipe", "pipe"],
|
|
28
|
+
});
|
|
29
|
+
let result = run();
|
|
30
|
+
for (let attempt = 1; attempt <= INDEX_LOCK_RETRY_ATTEMPTS; attempt++) {
|
|
31
|
+
if (result.status === 0)
|
|
32
|
+
break;
|
|
33
|
+
const stderr = typeof result.stderr === "string" ? result.stderr : "";
|
|
34
|
+
if (!isGitIndexLockContention(stderr))
|
|
35
|
+
break;
|
|
36
|
+
sleepSync(INDEX_LOCK_RETRY_BASE_MS * attempt); // 50, 100, 150, 200, 250 ms
|
|
37
|
+
result = run();
|
|
38
|
+
}
|
|
39
|
+
return result;
|
|
40
|
+
}
|
|
41
|
+
// git 失敗メッセージは register イベントの reason、result の block_reason、実行ログの一覧行の
|
|
42
|
+
// いずれでも長さ上限で切り詰められて記録される。commit のように pathspec が全件並ぶコマンドでは、
|
|
43
|
+
// 引数をそのまま連ねると失敗原因(stderr)が上限の外へ押し出されて残らない。原因を先頭付近へ置き、
|
|
44
|
+
// 引数は pathspec を件数へ要約したうえで末尾に添える。
|
|
45
|
+
const MAX_GIT_ARGUMENT_LENGTH = 40;
|
|
46
|
+
const MAX_GIT_ARGUMENT_SUMMARY_LENGTH = 120;
|
|
47
|
+
function abbreviate(value, limit) {
|
|
48
|
+
return value.length <= limit ? value : `${value.slice(0, Math.max(0, limit - 1))}…`;
|
|
49
|
+
}
|
|
50
|
+
// `--` 以降の pathspec は件数へ、それ以外の引数は 1 件ずつ長さを制限して要約する。
|
|
51
|
+
export function summarizeGitArguments(args) {
|
|
52
|
+
const separatorIndex = args.indexOf("--");
|
|
53
|
+
const head = separatorIndex === -1 ? args : args.slice(0, separatorIndex);
|
|
54
|
+
const parts = head.map((arg) => abbreviate(arg, MAX_GIT_ARGUMENT_LENGTH));
|
|
55
|
+
if (separatorIndex !== -1) {
|
|
56
|
+
const pathCount = args.length - separatorIndex - 1;
|
|
57
|
+
parts.push(`-- ${pathCount} ${pathCount === 1 ? "path" : "paths"}`);
|
|
58
|
+
}
|
|
59
|
+
return abbreviate(parts.join(" "), MAX_GIT_ARGUMENT_SUMMARY_LENGTH);
|
|
60
|
+
}
|
|
61
|
+
// git は進捗を `\r` で上書きしながら stderr へ書く(`Updating files: 52% (2412/4638)` など)。
|
|
62
|
+
// 失敗理由へ stderr 全文を載せると進捗が文字数を占有し、register の block_reason が
|
|
63
|
+
// 切り詰められた際に、進捗の後ろへ出る原因行が失われる。行ごとに `\r` の最終表示だけを
|
|
64
|
+
// 残し、進捗だけの行を落としたうえで、原因が書かれる側から行を採る。
|
|
65
|
+
const GIT_PROGRESS_LINE = /^(?:remote: )?(?:Updating files|Receiving objects|Resolving deltas|Counting objects|Compressing objects|Writing objects|Enumerating objects|Checking out files|Unpacking objects|Filtering content)\b.*?\d+%/u;
|
|
66
|
+
const GIT_CAUSE_LINE = /(?:\bfatal\b|\berror\b|\bwarning\b|\bCONFLICT\b|\bdenied\b|\bNo space left\b)/i;
|
|
67
|
+
const GIT_FAILURE_REASON_MAX_LENGTH = 400;
|
|
68
|
+
export function summarizeGitStderr(stderr, maxLength = GIT_FAILURE_REASON_MAX_LENGTH) {
|
|
69
|
+
const lines = stripTerminalControlSequences(stderr)
|
|
70
|
+
.split("\n")
|
|
71
|
+
// `\r` は同じ行の上書きを表すため、最後に表示された内容だけを残す。
|
|
72
|
+
.map((line) => line.split("\r").at(-1) ?? "")
|
|
73
|
+
.map((line) => line.trim())
|
|
74
|
+
.filter((line) => line !== "" && !GIT_PROGRESS_LINE.test(line));
|
|
75
|
+
if (lines.length === 0)
|
|
76
|
+
return "";
|
|
77
|
+
const causes = lines.filter((line) => GIT_CAUSE_LINE.test(line));
|
|
78
|
+
// 原因を示す行が無い場合は、進捗の後ろに残った末尾側の行を採る。先頭は
|
|
79
|
+
// `Preparing worktree ...` のような手順の告知で、失敗の原因を含まない。
|
|
80
|
+
const selected = causes.length > 0 ? causes : lines.slice(-2);
|
|
81
|
+
const joined = selected.join(" / ");
|
|
82
|
+
return joined.length <= maxLength ? joined : `${joined.slice(0, maxLength - 1)}…`;
|
|
83
|
+
}
|
|
84
|
+
export function formatGitCommandFailure(args, stderr) {
|
|
85
|
+
const subcommandIndex = args.findIndex((arg) => !arg.startsWith("-"));
|
|
86
|
+
const label = subcommandIndex === -1 ? "git" : `git ${args[subcommandIndex]}`;
|
|
87
|
+
const summary = summarizeGitArguments(subcommandIndex === -1
|
|
88
|
+
? args
|
|
89
|
+
: [...args.slice(0, subcommandIndex), ...args.slice(subcommandIndex + 1)]);
|
|
90
|
+
const detail = summary ? ` (args: ${summary})` : "";
|
|
91
|
+
const cause = summarizeGitStderr(stderr);
|
|
92
|
+
return cause ? `${label} failed: ${cause}${detail}` : `${label} failed${detail}`;
|
|
93
|
+
}
|
|
94
|
+
// lefthook などの hook 出力から、block reason に載せる「失敗ステップ名 + 最初のエラー行」
|
|
95
|
+
// を取り出す。罫線や ANSI 制御は監査ログには残す一方、短い理由には混ぜない。
|
|
96
|
+
export function summarizeGitHookFailure(output) {
|
|
97
|
+
const lines = stripTerminalControlSequences(output)
|
|
98
|
+
.split(/\r?\n/)
|
|
99
|
+
.map((line) => line
|
|
100
|
+
.trim()
|
|
101
|
+
.replace(/^[│┃║╎┆┊┋┇┌┐└┘├┤┬┴┼╭╮╰╯┏┓┗┛─━═\s]+/u, "")
|
|
102
|
+
.replace(/[│┃║╎┆┊┋┇┌┐└┘├┤┬┴┼╭╮╰╯┏┓┗┛─━═\s]+$/u, "")
|
|
103
|
+
.trim())
|
|
104
|
+
.filter(Boolean);
|
|
105
|
+
if (lines.length === 0)
|
|
106
|
+
return "unknown hook failure";
|
|
107
|
+
let step = "";
|
|
108
|
+
let stepIndex = -1;
|
|
109
|
+
for (const [index, line] of lines.entries()) {
|
|
110
|
+
const match = line.match(/^(.+?)\s*[❯▶]\s*$/u);
|
|
111
|
+
if (!match)
|
|
112
|
+
continue;
|
|
113
|
+
step = match[1].trim();
|
|
114
|
+
stepIndex = index;
|
|
115
|
+
break;
|
|
116
|
+
}
|
|
117
|
+
const isDecoration = (line) => /^(?:hook output|summary:|exit status\b|failed steps?:|skip(?:ped)?\b)/i.test(line) ||
|
|
118
|
+
/^[✓✔✗✘✕❯▶]+$/u.test(line);
|
|
119
|
+
const errorLine = lines
|
|
120
|
+
.slice(stepIndex >= 0 ? stepIndex + 1 : 0)
|
|
121
|
+
.find((line) => line !== step && !isDecoration(line) && !/[❯▶]\s*$/u.test(line));
|
|
122
|
+
if (step && errorLine)
|
|
123
|
+
return `${step}: ${errorLine}`;
|
|
124
|
+
if (step)
|
|
125
|
+
return step;
|
|
126
|
+
return (lines.find((line) => /(?:\bCONFLICT\b|\bfatal:|\berror:|\bfailed\b)/i.test(line)) ??
|
|
127
|
+
lines.find((line) => !isDecoration(line)) ??
|
|
128
|
+
lines[0]);
|
|
129
|
+
}
|
|
130
|
+
// message は block reason 向けに要約する一方、調査に必要な stderr 全文は失わない。
|
|
131
|
+
export class GitCommandError extends Error {
|
|
132
|
+
args;
|
|
133
|
+
stderr;
|
|
134
|
+
constructor(message, args, stderr) {
|
|
135
|
+
super(message);
|
|
136
|
+
this.args = args;
|
|
137
|
+
this.stderr = stderr;
|
|
138
|
+
this.name = "GitCommandError";
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
export function gitOutput(repoRoot, args) {
|
|
142
|
+
const result = gitResult(repoRoot, args);
|
|
143
|
+
if (result.status !== 0) {
|
|
144
|
+
const stderr = typeof result.stderr === "string" ? result.stderr : "";
|
|
145
|
+
throw new GitCommandError(formatGitCommandFailure(args, stderr), args, stderr);
|
|
146
|
+
}
|
|
147
|
+
return typeof result.stdout === "string" ? result.stdout : "";
|
|
148
|
+
}
|
|
149
|
+
export function worktreeNameFromTaskId(value) {
|
|
150
|
+
const slug = value
|
|
151
|
+
.trim()
|
|
152
|
+
.replace(/[^A-Za-z0-9._-]+/g, "-")
|
|
153
|
+
.replace(/-+/g, "-")
|
|
154
|
+
.replace(/^-+|-+$/g, "");
|
|
155
|
+
if (!slug)
|
|
156
|
+
throw new Error(`Task ID cannot be used as a worktree name: ${value}`);
|
|
157
|
+
return slug;
|
|
158
|
+
}
|
|
159
|
+
export function resolveWorktreeBase(repoRoot, override, configured) {
|
|
160
|
+
const value = override?.trim() || configured?.trim() || "../worktrees";
|
|
161
|
+
return isAbsolute(value) ? resolve(value) : resolve(repoRoot, value);
|
|
162
|
+
}
|
|
163
|
+
export function listRegisteredWorktrees(repoRoot) {
|
|
164
|
+
const output = gitOutput(repoRoot, ["worktree", "list", "--porcelain"]);
|
|
165
|
+
const result = [];
|
|
166
|
+
let currentPath;
|
|
167
|
+
let currentBranch;
|
|
168
|
+
function pushCurrent() {
|
|
169
|
+
if (currentPath)
|
|
170
|
+
result.push({ path: currentPath, branch: currentBranch });
|
|
171
|
+
currentPath = undefined;
|
|
172
|
+
currentBranch = undefined;
|
|
173
|
+
}
|
|
174
|
+
for (const line of output.split(/\r?\n/)) {
|
|
175
|
+
if (line.startsWith("worktree ")) {
|
|
176
|
+
pushCurrent();
|
|
177
|
+
currentPath = resolve(line.slice("worktree ".length));
|
|
178
|
+
}
|
|
179
|
+
else if (currentPath && line.startsWith("branch refs/heads/")) {
|
|
180
|
+
currentBranch = line.slice("branch refs/heads/".length);
|
|
181
|
+
}
|
|
182
|
+
else if (line === "") {
|
|
183
|
+
pushCurrent();
|
|
184
|
+
}
|
|
185
|
+
}
|
|
186
|
+
pushCurrent();
|
|
187
|
+
return result;
|
|
188
|
+
}
|
|
189
|
+
export function findExecWorktree(repoRoot, taskId) {
|
|
190
|
+
const name = worktreeNameFromTaskId(taskId);
|
|
191
|
+
const branch = `exec/${name}`;
|
|
192
|
+
const registered = listRegisteredWorktrees(repoRoot).find((item) => item.branch === branch);
|
|
193
|
+
if (!registered)
|
|
194
|
+
return null;
|
|
195
|
+
return { path: registered.path, branch, name, created: false };
|
|
196
|
+
}
|
|
197
|
+
export function execBranchExists(repoRoot, taskId) {
|
|
198
|
+
const branch = `exec/${worktreeNameFromTaskId(taskId)}`;
|
|
199
|
+
return (gitResult(repoRoot, ["show-ref", "--verify", "--quiet", `refs/heads/${branch}`]).status === 0);
|
|
200
|
+
}
|
|
201
|
+
function pathEntryExists(target) {
|
|
202
|
+
try {
|
|
203
|
+
lstatSync(target);
|
|
204
|
+
return true;
|
|
205
|
+
}
|
|
206
|
+
catch {
|
|
207
|
+
return false;
|
|
208
|
+
}
|
|
209
|
+
}
|
|
210
|
+
function trackedPackageLockDirs(worktreePath) {
|
|
211
|
+
const output = gitOutput(worktreePath, [
|
|
212
|
+
"ls-files",
|
|
213
|
+
"-z",
|
|
214
|
+
"--",
|
|
215
|
+
"package-lock.json",
|
|
216
|
+
"*/package-lock.json",
|
|
217
|
+
]);
|
|
218
|
+
const dirs = new Set();
|
|
219
|
+
for (const entry of output.split("\0")) {
|
|
220
|
+
if (!entry)
|
|
221
|
+
continue;
|
|
222
|
+
dirs.add(resolve(worktreePath, entry.slice(0, -"package-lock.json".length) || "."));
|
|
223
|
+
}
|
|
224
|
+
return [...dirs].sort();
|
|
225
|
+
}
|
|
226
|
+
function runNpmCi(packageDir) {
|
|
227
|
+
const command = process.platform === "win32" ? "npm.cmd" : "npm";
|
|
228
|
+
const result = spawnSync(command, ["ci", "--include=dev"], {
|
|
229
|
+
cwd: packageDir,
|
|
230
|
+
env: { ...gitEnvironment(), CI: "true", LEFTHOOK: "0" },
|
|
231
|
+
stdio: "inherit",
|
|
232
|
+
});
|
|
233
|
+
if (result.error) {
|
|
234
|
+
throw new Error(`npm ci could not start in ${packageDir}: ${result.error.message}`);
|
|
235
|
+
}
|
|
236
|
+
if (result.status !== 0) {
|
|
237
|
+
throw new Error(`npm ci failed in ${packageDir} (exit ${result.status ?? "unknown"})`);
|
|
238
|
+
}
|
|
239
|
+
}
|
|
240
|
+
function removeLegacyNodeModulesLink(packageDir) {
|
|
241
|
+
const target = join(packageDir, "node_modules");
|
|
242
|
+
if (!pathEntryExists(target) || !lstatSync(target).isSymbolicLink())
|
|
243
|
+
return;
|
|
244
|
+
unlinkSync(target);
|
|
245
|
+
}
|
|
246
|
+
// Git worktree は独自の作業ツリーを持つだけで node_modules は引き継がないため、
|
|
247
|
+
// tracked package-lock.json ごとに npm ci を実行し、worktree 内へ独立して依存を配置する。
|
|
248
|
+
// 旧方式の共有 symlink は npm に辿らせず、先に link 自体だけを削除する。
|
|
249
|
+
export function installWorktreeDependencies(worktreePath, npmCi = runNpmCi) {
|
|
250
|
+
for (const packageDir of trackedPackageLockDirs(resolve(worktreePath))) {
|
|
251
|
+
if (!existsSync(join(packageDir, "package.json"))) {
|
|
252
|
+
throw new Error(`package.json is missing next to package-lock.json: ${packageDir}`);
|
|
253
|
+
}
|
|
254
|
+
removeLegacyNodeModulesLink(packageDir);
|
|
255
|
+
process.stdout.write(`Installing worktree dependencies: ${relative(worktreePath, packageDir) || "."}\n`);
|
|
256
|
+
npmCi(packageDir);
|
|
257
|
+
}
|
|
258
|
+
}
|
|
259
|
+
const SPECDOJO_CONFIG_REL = join(".specdojo", "specdojo.config.json");
|
|
260
|
+
// 生成物の失敗は成果物の失敗と混同されやすい。準備段階であることと、生成物が worktree ごとに
|
|
261
|
+
// 作り直しになる理由をメッセージ本体へ含める。
|
|
262
|
+
export function formatWorktreeBuildFailure(worktreePath, detail) {
|
|
263
|
+
return (`Worktree preparation failed: specdojo build ${detail} in ${worktreePath}. ` +
|
|
264
|
+
`Generated docs are gitignored and must be rebuilt per worktree, so this is a ` +
|
|
265
|
+
`preparation failure, not a task deliverable failure.`);
|
|
266
|
+
}
|
|
267
|
+
// build は worktree 内で完結させる。依存と同じく、worktree の checkout にある CLI を使うため、
|
|
268
|
+
// 実行元プロセスの entry(テストランナー等)へは依存しない。SpecDojo 自身のリポジトリでは
|
|
269
|
+
// src の entry を worktree の tsx で、CLI を依存として使うリポジトリでは
|
|
270
|
+
// node_modules/.bin/specdojo を使う。
|
|
271
|
+
export function resolveWorktreeBuildCommand(worktreePath) {
|
|
272
|
+
const root = resolve(worktreePath);
|
|
273
|
+
const sourceEntry = join(root, "src", "specdojo.ts");
|
|
274
|
+
const localTsx = join(root, "node_modules", ".bin", "tsx");
|
|
275
|
+
if (existsSync(sourceEntry) && existsSync(localTsx)) {
|
|
276
|
+
return { command: process.execPath, args: [localTsx, sourceEntry, "build"] };
|
|
277
|
+
}
|
|
278
|
+
const installedCli = join(root, "node_modules", ".bin", process.platform === "win32" ? "specdojo.cmd" : "specdojo");
|
|
279
|
+
if (existsSync(installedCli))
|
|
280
|
+
return { command: installedCli, args: ["build"] };
|
|
281
|
+
const builtEntry = join(root, "dist", "specdojo.js");
|
|
282
|
+
if (existsSync(builtEntry))
|
|
283
|
+
return { command: process.execPath, args: [builtEntry, "build"] };
|
|
284
|
+
return null;
|
|
285
|
+
}
|
|
286
|
+
// worktree を cwd にして build を実行する。child は cwd から .specdojo/specdojo.config.json を
|
|
287
|
+
// 辿るため、生成先は worktree 側になる。
|
|
288
|
+
function runWorktreeBuild(worktreePath) {
|
|
289
|
+
const resolved = resolveWorktreeBuildCommand(worktreePath);
|
|
290
|
+
if (!resolved) {
|
|
291
|
+
process.stdout.write(`Skipping worktree artifact generation: no SpecDojo CLI in ${worktreePath}\n`);
|
|
292
|
+
return;
|
|
293
|
+
}
|
|
294
|
+
process.stdout.write("Generating worktree artifacts: specdojo build\n");
|
|
295
|
+
const result = spawnSync(resolved.command, resolved.args, {
|
|
296
|
+
cwd: worktreePath,
|
|
297
|
+
env: { ...gitEnvironment(), CI: "true", LEFTHOOK: "0" },
|
|
298
|
+
stdio: "inherit",
|
|
299
|
+
});
|
|
300
|
+
if (result.error) {
|
|
301
|
+
throw new Error(formatWorktreeBuildFailure(worktreePath, `could not start: ${result.error.message}`));
|
|
302
|
+
}
|
|
303
|
+
if (result.status !== 0) {
|
|
304
|
+
throw new Error(formatWorktreeBuildFailure(worktreePath, `exited with ${result.status ?? "unknown"}`));
|
|
305
|
+
}
|
|
306
|
+
}
|
|
307
|
+
// 生成物(docs/**/generated と .specdojo/doc-index.json)は .gitignore 済みで worktree へ
|
|
308
|
+
// 複製されない。生成物の存在を前提とする検証は、成果物と無関係に失敗するため、依存の install
|
|
309
|
+
// 直後にまとめて生成する。生成対象が増えても追従が要らないよう、scope を絞らず build を通しで
|
|
310
|
+
// 実行する(全 scope で数秒。npm ci に対して無視できる)。
|
|
311
|
+
export function generateWorktreeArtifacts(worktreePath, build = runWorktreeBuild) {
|
|
312
|
+
const root = resolve(worktreePath);
|
|
313
|
+
// SpecDojo の設定を持たないリポジトリには生成物が無い。build は失敗するだけなので実行しない。
|
|
314
|
+
if (!existsSync(join(root, SPECDOJO_CONFIG_REL)))
|
|
315
|
+
return;
|
|
316
|
+
build(root);
|
|
317
|
+
}
|
|
318
|
+
export function ensureExecWorktree(opts) {
|
|
319
|
+
const repoRoot = resolve(opts.repoRoot);
|
|
320
|
+
const baseRelative = relative(repoRoot, resolve(opts.worktreeBase));
|
|
321
|
+
if (baseRelative === "" || (!baseRelative.startsWith(`..${sep}`) && baseRelative !== "..")) {
|
|
322
|
+
throw new Error(`Worktree base must be outside the repository: ${opts.worktreeBase}`);
|
|
323
|
+
}
|
|
324
|
+
const name = worktreeNameFromTaskId(opts.taskId);
|
|
325
|
+
const branch = `exec/${name}`;
|
|
326
|
+
const worktreePath = resolve(join(opts.worktreeBase, name));
|
|
327
|
+
const registered = listRegisteredWorktrees(repoRoot);
|
|
328
|
+
const registeredAtPath = registered.find((item) => item.path === worktreePath);
|
|
329
|
+
if (registeredAtPath) {
|
|
330
|
+
if (!existsSync(worktreePath)) {
|
|
331
|
+
throw new Error(`Registered worktree path does not exist: ${worktreePath}`);
|
|
332
|
+
}
|
|
333
|
+
if (registeredAtPath.branch !== branch) {
|
|
334
|
+
throw new Error(`Worktree ${worktreePath} uses branch ${registeredAtPath.branch ?? "(detached)"}; expected ${branch}`);
|
|
335
|
+
}
|
|
336
|
+
(opts.installDependencies ?? installWorktreeDependencies)(worktreePath);
|
|
337
|
+
(opts.generateArtifacts ?? generateWorktreeArtifacts)(worktreePath);
|
|
338
|
+
return { path: worktreePath, branch, name, created: false };
|
|
339
|
+
}
|
|
340
|
+
if (existsSync(worktreePath)) {
|
|
341
|
+
throw new Error(`Worktree path already exists but is not registered: ${worktreePath}`);
|
|
342
|
+
}
|
|
343
|
+
mkdirSync(opts.worktreeBase, { recursive: true });
|
|
344
|
+
const branchExists = gitResult(repoRoot, ["show-ref", "--verify", "--quiet", `refs/heads/${branch}`]).status === 0;
|
|
345
|
+
const args = branchExists
|
|
346
|
+
? ["worktree", "add", worktreePath, branch]
|
|
347
|
+
: [
|
|
348
|
+
"worktree",
|
|
349
|
+
"add",
|
|
350
|
+
worktreePath,
|
|
351
|
+
"-b",
|
|
352
|
+
branch,
|
|
353
|
+
...(opts.startPoint ? [opts.startPoint] : []),
|
|
354
|
+
];
|
|
355
|
+
gitOutput(repoRoot, args);
|
|
356
|
+
(opts.installDependencies ?? installWorktreeDependencies)(worktreePath);
|
|
357
|
+
(opts.generateArtifacts ?? generateWorktreeArtifacts)(worktreePath);
|
|
358
|
+
return { path: worktreePath, branch, name, created: true };
|
|
359
|
+
}
|