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/dist/exec-schedule.js
CHANGED
|
@@ -1,13 +1,48 @@
|
|
|
1
|
-
import { existsSync, writeFileSync } from
|
|
2
|
-
import { extname, join } from
|
|
3
|
-
import { computeReadyIds, foldEventsToState, validateEventShape } from
|
|
4
|
-
import { ensureDir,
|
|
5
|
-
import { eventsDirForProject, executionRootForProject, generatedDirForProject, } from
|
|
6
|
-
import {
|
|
7
|
-
import { buildScheduleIndex } from
|
|
8
|
-
import {
|
|
9
|
-
import {
|
|
10
|
-
import {
|
|
1
|
+
import { existsSync, statSync, writeFileSync } from "node:fs";
|
|
2
|
+
import { basename, extname, join } from "node:path";
|
|
3
|
+
import { computeReadyIds, foldEventsToState, isExecEventV1, validateEventShape, } from "./exec-events.js";
|
|
4
|
+
import { ensureDir, formatDays, listFilesRecursive, readJson, toArtifactPath, toScheduleFilePath, writeJson, } from "./exec-shared.js";
|
|
5
|
+
import { eventsDirForProject, executionRootForProject, generatedDirForProject, } from "./exec-project.js";
|
|
6
|
+
import { buildGanttChartMarkdown, buildGanttChartSvg, buildProgressSummaryLines, } from "./exec-schedule-gantt-chart.js";
|
|
7
|
+
import { buildScheduleIndex } from "./exec-schedule-index.js";
|
|
8
|
+
import { buildGanttChartScopeSpecs, filterCpmNodes, scheduleTrackNames, } from "./exec-schedule-gantt-chart-scope.js";
|
|
9
|
+
import { computeCpm, topoSort } from "./exec-schedule-cpm.js";
|
|
10
|
+
import { buildReadySnapshot, orderReadyIds, writeReadyFiles, selectNextTask, } from "./exec-schedule-ready.js";
|
|
11
|
+
import { writeScheduleHashAndDiff } from "./exec-schedule-hash.js";
|
|
12
|
+
import { buildInitialStateFromStrategy } from "./exec-schedule-initial.js";
|
|
13
|
+
import { buildPhaseModeIndex, resolveAgentAssignment, resolveAgentPipeline, resolveApproach, resolveTaskCapabilities, resolveTaskExecution, resolveTaskMode, resolveTaskProficiency, } from "./exec-strategy.js";
|
|
14
|
+
export function findStaleGeneratedTracks(projectPath) {
|
|
15
|
+
const files = listFilesRecursive(projectPath);
|
|
16
|
+
const trackFiles = new Map();
|
|
17
|
+
for (const file of files) {
|
|
18
|
+
const match = basename(file).match(/^sch-track-(.+)\.yaml$/);
|
|
19
|
+
if (match)
|
|
20
|
+
trackFiles.set(match[1], file);
|
|
21
|
+
}
|
|
22
|
+
const staleTracks = [];
|
|
23
|
+
for (const strategyFile of files) {
|
|
24
|
+
const match = basename(strategyFile).match(/^sch-strategy-(.+)\.yaml$/);
|
|
25
|
+
if (!match)
|
|
26
|
+
continue;
|
|
27
|
+
const track = match[1];
|
|
28
|
+
const trackFile = trackFiles.get(track);
|
|
29
|
+
if (!trackFile) {
|
|
30
|
+
staleTracks.push({ track, strategyFile, reason: "missing" });
|
|
31
|
+
continue;
|
|
32
|
+
}
|
|
33
|
+
if (statSync(strategyFile).mtimeMs > statSync(trackFile).mtimeMs) {
|
|
34
|
+
staleTracks.push({ track, strategyFile, trackFile, reason: "outdated" });
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
return staleTracks.sort((a, b) => a.track.localeCompare(b.track));
|
|
38
|
+
}
|
|
39
|
+
export function findStaleGeneratedTrackWarnings(projectPath) {
|
|
40
|
+
return findStaleGeneratedTracks(projectPath).map((stale) => stale.reason === "missing"
|
|
41
|
+
? `${basename(stale.strategyFile)} has no generated sch-track-${stale.track}.yaml. ` +
|
|
42
|
+
`Run: specdojo schedule build --track ${stale.track}`
|
|
43
|
+
: `${basename(stale.strategyFile)} is newer than ${basename(stale.trackFile)}. ` +
|
|
44
|
+
`Run: specdojo schedule build --track ${stale.track} --force before exec refresh.`);
|
|
45
|
+
}
|
|
11
46
|
export function validateAll(projectPath) {
|
|
12
47
|
const errors = [];
|
|
13
48
|
const warnings = [];
|
|
@@ -16,6 +51,7 @@ export function validateAll(projectPath) {
|
|
|
16
51
|
if (schedule.nodes.size === 0) {
|
|
17
52
|
warnings.push(`No schedule nodes loaded from sch-*.yaml under: ${projectPath}`);
|
|
18
53
|
}
|
|
54
|
+
warnings.push(...findStaleGeneratedTrackWarnings(projectPath));
|
|
19
55
|
for (const node of schedule.nodes.values()) {
|
|
20
56
|
for (const dep of node.depends_on) {
|
|
21
57
|
if (!schedule.nodes.has(dep)) {
|
|
@@ -25,12 +61,12 @@ export function validateAll(projectPath) {
|
|
|
25
61
|
}
|
|
26
62
|
const topo = topoSort(schedule);
|
|
27
63
|
if (topo.cycle && topo.cycle.length) {
|
|
28
|
-
errors.push(`schedule dependency cycle detected (nodes involved): ${topo.cycle.join(
|
|
64
|
+
errors.push(`schedule dependency cycle detected (nodes involved): ${topo.cycle.join(", ")}`);
|
|
29
65
|
}
|
|
30
66
|
const eventsDir = eventsDirForProject(projectPath);
|
|
31
67
|
if (!existsSync(eventsDir))
|
|
32
68
|
warnings.push(`No exec/events directory: ${eventsDir}`);
|
|
33
|
-
const files = listFilesRecursive(eventsDir).filter(p => extname(p).toLowerCase() ===
|
|
69
|
+
const files = listFilesRecursive(eventsDir).filter((p) => extname(p).toLowerCase() === ".json");
|
|
34
70
|
let parsedEvents = 0;
|
|
35
71
|
for (const f of files) {
|
|
36
72
|
let obj;
|
|
@@ -43,11 +79,12 @@ export function validateAll(projectPath) {
|
|
|
43
79
|
}
|
|
44
80
|
const shapeErrs = validateEventShape(obj, f);
|
|
45
81
|
errors.push(...shapeErrs);
|
|
46
|
-
if (
|
|
82
|
+
if (isExecEventV1(obj, f)) {
|
|
47
83
|
parsedEvents++;
|
|
48
84
|
const ev = obj;
|
|
49
85
|
if (!scheduleIds.has(ev.task_id))
|
|
50
|
-
|
|
86
|
+
warnings.push(`${f}: task_id ${ev.task_id} not found in current sch-*.yaml; ` +
|
|
87
|
+
`the historical event will be ignored when building state`);
|
|
51
88
|
}
|
|
52
89
|
}
|
|
53
90
|
return {
|
|
@@ -63,15 +100,15 @@ export function validateAll(projectPath) {
|
|
|
63
100
|
};
|
|
64
101
|
}
|
|
65
102
|
export function printValidateResult(res) {
|
|
66
|
-
process.stdout.write(res.ok ?
|
|
103
|
+
process.stdout.write(res.ok ? "OK: validation passed\n" : "NG: validation failed\n");
|
|
67
104
|
process.stdout.write(`stats: events=${res.stats.events}, event_files=${res.stats.event_files}, schedule_ids=${res.stats.schedule_ids}, schedule_files=${res.stats.schedule_files}\n`);
|
|
68
105
|
if (res.warnings.length) {
|
|
69
|
-
process.stdout.write(
|
|
106
|
+
process.stdout.write("\nWarnings:\n");
|
|
70
107
|
for (const w of res.warnings)
|
|
71
108
|
process.stdout.write(`- ${w}\n`);
|
|
72
109
|
}
|
|
73
110
|
if (res.errors.length) {
|
|
74
|
-
process.stdout.write(
|
|
111
|
+
process.stdout.write("\nErrors:\n");
|
|
75
112
|
for (const e of res.errors)
|
|
76
113
|
process.stdout.write(`- ${e}\n`);
|
|
77
114
|
}
|
|
@@ -82,113 +119,154 @@ export function exitWithCode(ok) {
|
|
|
82
119
|
export function writeCpmFiles(projectPath, cpm, stateSnapshot) {
|
|
83
120
|
const genDir = generatedDirForProject(projectPath);
|
|
84
121
|
ensureDir(genDir);
|
|
85
|
-
writeJson(join(genDir,
|
|
122
|
+
writeJson(join(genDir, "cpm.json"), cpm);
|
|
86
123
|
const rows = Object.values(cpm.nodes).sort((a, b) => a.es - b.es || a.id.localeCompare(b.id));
|
|
87
124
|
const lines = [];
|
|
88
125
|
lines.push(`# CPM`);
|
|
89
|
-
lines.push(
|
|
90
|
-
lines.push(`- project_duration_days: \`${cpm.project_duration_days}\``);
|
|
91
|
-
lines.push(
|
|
126
|
+
lines.push("");
|
|
127
|
+
lines.push(`- project_duration_days: \`${formatDays(cpm.project_duration_days)}\``);
|
|
128
|
+
lines.push("");
|
|
92
129
|
lines.push(`| id | owner | kind | dur | ES | EF | LS | LF | slack | depends_on |`);
|
|
93
130
|
lines.push(`|---|---|---:|---:|---:|---:|---:|---:|---:|---|`);
|
|
94
131
|
for (const r of rows) {
|
|
95
|
-
lines.push(`| \`${r.id}\` | ${r.owner ??
|
|
132
|
+
lines.push(`| \`${r.id}\` | ${r.owner ?? "-"} | ${r.kind} | ${formatDays(r.duration_days)} | ${formatDays(r.es)} | ${formatDays(r.ef)} | ${formatDays(r.ls)} | ${formatDays(r.lf)} | ${formatDays(r.slack)} | ${r.depends_on.join(", ")} |`);
|
|
96
133
|
}
|
|
97
|
-
lines.push(
|
|
98
|
-
writeFileSync(join(genDir,
|
|
134
|
+
lines.push("");
|
|
135
|
+
writeFileSync(join(genDir, "cpm.md"), lines.join("\n"), "utf8");
|
|
99
136
|
const cp = [];
|
|
100
137
|
cp.push(`# Critical Path`);
|
|
101
|
-
cp.push(
|
|
102
|
-
cp.push(`- project_duration_days: \`${cpm.project_duration_days}\``);
|
|
103
|
-
cp.push(
|
|
138
|
+
cp.push("");
|
|
139
|
+
cp.push(`- project_duration_days: \`${formatDays(cpm.project_duration_days)}\``);
|
|
140
|
+
cp.push("");
|
|
104
141
|
if (!cpm.critical_path.length)
|
|
105
|
-
cp.push(
|
|
142
|
+
cp.push("_No critical path computed._");
|
|
106
143
|
else {
|
|
107
144
|
cp.push(`Critical path (one path, tie-broken):`);
|
|
108
|
-
cp.push(
|
|
145
|
+
cp.push("");
|
|
109
146
|
for (const id of cpm.critical_path) {
|
|
110
147
|
const n = cpm.nodes[id];
|
|
111
|
-
cp.push(`- \`${id}\`${n.name ? ` — ${n.name}` :
|
|
148
|
+
cp.push(`- \`${id}\`${n.name ? ` — ${n.name}` : ""} (ES=${formatDays(n.es)}, EF=${formatDays(n.ef)})`);
|
|
112
149
|
}
|
|
113
150
|
}
|
|
114
|
-
cp.push(
|
|
115
|
-
writeFileSync(join(genDir,
|
|
151
|
+
cp.push("");
|
|
152
|
+
writeFileSync(join(genDir, "critical-path.md"), cp.join("\n"), "utf8");
|
|
116
153
|
const schedule = buildScheduleIndex(projectPath);
|
|
117
|
-
const
|
|
118
|
-
const
|
|
119
|
-
const
|
|
120
|
-
todo: 0,
|
|
121
|
-
doing: 0,
|
|
122
|
-
blocked: 0,
|
|
123
|
-
done: 0,
|
|
124
|
-
cancelled: 0,
|
|
125
|
-
};
|
|
126
|
-
for (const row of taskRows) {
|
|
127
|
-
const state = stateSnapshot?.tasks[row.id]?.state ?? 'todo';
|
|
128
|
-
stateCounts[state] += 1;
|
|
129
|
-
}
|
|
130
|
-
const doneCount = stateCounts.done;
|
|
131
|
-
const totalTaskCount = taskRows.length;
|
|
132
|
-
const progressPercent = totalTaskCount > 0 ? ((doneCount / totalTaskCount) * 100).toFixed(1) : '0.0';
|
|
133
|
-
const ready = computeReadyIds(schedule, {
|
|
154
|
+
const allTaskRows = rows.filter((row) => row.kind === "task");
|
|
155
|
+
const tasksState = stateSnapshot?.tasks ?? {};
|
|
156
|
+
const readyAll = computeReadyIds(schedule, {
|
|
134
157
|
schedule_path: cpm.schedule_path,
|
|
135
|
-
tasks:
|
|
158
|
+
tasks: tasksState,
|
|
136
159
|
});
|
|
137
|
-
const
|
|
138
|
-
const
|
|
139
|
-
const
|
|
140
|
-
cpm
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
160
|
+
const readyOrderedAll = orderReadyIds(readyAll, cpm, "critical-first");
|
|
161
|
+
const stateOf = (id) => stateSnapshot?.tasks[id]?.state ?? "todo";
|
|
162
|
+
for (const scope of buildGanttChartScopeSpecs(cpm)) {
|
|
163
|
+
// SVG: scope の描画対象ノードだけを持つ CpmResult(full は cpm そのまま)。
|
|
164
|
+
const renderCpm = scope.renderIds
|
|
165
|
+
? filterCpmNodes(cpm, scope.renderIds, scope.keepCriticalPath)
|
|
166
|
+
: cpm;
|
|
167
|
+
// 進捗サマリー: scope の母集団(track なら track の task、full/milestones は全 task)。
|
|
168
|
+
const progressCpm = scope.progressIds
|
|
169
|
+
? filterCpmNodes(cpm, scope.progressIds, scope.keepCriticalPath)
|
|
170
|
+
: cpm;
|
|
171
|
+
const progressTaskRows = scope.progressIds
|
|
172
|
+
? allTaskRows.filter((row) => scope.progressIds.has(row.id))
|
|
173
|
+
: allTaskRows;
|
|
174
|
+
const stateCounts = {
|
|
175
|
+
todo: 0,
|
|
176
|
+
doing: 0,
|
|
177
|
+
blocked: 0,
|
|
178
|
+
done: 0,
|
|
179
|
+
cancelled: 0,
|
|
180
|
+
};
|
|
181
|
+
for (const row of progressTaskRows)
|
|
182
|
+
stateCounts[stateOf(row.id)] += 1;
|
|
183
|
+
const doneCount = stateCounts.done;
|
|
184
|
+
const totalTaskCount = progressTaskRows.length;
|
|
185
|
+
const progressPercent = totalTaskCount > 0 ? ((doneCount / totalTaskCount) * 100).toFixed(1) : "0.0";
|
|
186
|
+
const readyScope = scope.progressIds
|
|
187
|
+
? readyAll.filter((id) => scope.progressIds.has(id))
|
|
188
|
+
: readyAll;
|
|
189
|
+
const nextTaskId = (scope.progressIds
|
|
190
|
+
? readyOrderedAll.filter((id) => scope.progressIds.has(id))
|
|
191
|
+
: readyOrderedAll)[0] ?? null;
|
|
192
|
+
const progressCriticalSet = new Set(progressCpm.critical_path);
|
|
193
|
+
const criticalDoingCount = progressTaskRows.filter((row) => progressCriticalSet.has(row.id) && stateOf(row.id) === "doing").length;
|
|
194
|
+
const progressSummaryLines = buildProgressSummaryLines({
|
|
195
|
+
cpm: progressCpm,
|
|
196
|
+
schedule,
|
|
197
|
+
stateCounts,
|
|
198
|
+
totalTaskCount,
|
|
199
|
+
readyCount: readyScope.length,
|
|
200
|
+
nextTaskId,
|
|
201
|
+
criticalDoingCount,
|
|
202
|
+
});
|
|
203
|
+
writeFileSync(join(genDir, `${scope.fileBase}.svg`), buildGanttChartSvg(renderCpm, schedule, stateSnapshot, { title: scope.title }), "utf8");
|
|
204
|
+
writeFileSync(join(genDir, `${scope.fileBase}.md`), buildGanttChartMarkdown(progressCpm, {
|
|
205
|
+
criticalPathTaskCount: new Set(renderCpm.critical_path).size,
|
|
206
|
+
progressPercent,
|
|
207
|
+
doneTasks: `${doneCount}/${totalTaskCount}`,
|
|
208
|
+
taskStateCounts: `todo=${stateCounts.todo}, doing=${stateCounts.doing}, blocked=${stateCounts.blocked}, done=${stateCounts.done}, cancelled=${stateCounts.cancelled}`,
|
|
209
|
+
progressSummaryLines,
|
|
210
|
+
}, {
|
|
211
|
+
title: scope.title,
|
|
212
|
+
svgFileName: `${scope.fileBase}.svg`,
|
|
213
|
+
scopeLabel: scope.scopeLabel,
|
|
214
|
+
}), "utf8");
|
|
215
|
+
}
|
|
156
216
|
}
|
|
157
217
|
export function writeGeneratedCore(projectPath, events, schedule, cpm) {
|
|
158
218
|
const genDir = generatedDirForProject(projectPath);
|
|
159
219
|
ensureDir(genDir);
|
|
160
|
-
const jsonl = events.map(x => JSON.stringify(x.event)).join(
|
|
161
|
-
writeFileSync(join(genDir,
|
|
162
|
-
const
|
|
163
|
-
|
|
220
|
+
const jsonl = events.map((x) => JSON.stringify(x.event)).join("\n") + (events.length ? "\n" : "");
|
|
221
|
+
writeFileSync(join(genDir, "exec.jsonl"), jsonl, "utf8");
|
|
222
|
+
const initialTasks = buildInitialStateFromStrategy(projectPath, schedule);
|
|
223
|
+
const snapshot = foldEventsToState(events, schedule, projectPath, initialTasks);
|
|
224
|
+
writeJson(join(genDir, "state.json"), snapshot);
|
|
164
225
|
const ready = computeReadyIds(schedule, snapshot);
|
|
165
226
|
const readySnapshot = buildReadySnapshot(projectPath, schedule, ready, cpm);
|
|
227
|
+
const phaseModeIndex = buildPhaseModeIndex(projectPath);
|
|
228
|
+
for (const task of readySnapshot.tasks) {
|
|
229
|
+
task.mode = resolveTaskMode(task.local_id, task.id, phaseModeIndex, task.phase_suffix, task.phase_set);
|
|
230
|
+
task.execution = resolveTaskExecution(task.local_id, task.id, phaseModeIndex, task.phase_suffix, task.phase_set);
|
|
231
|
+
task.approach = resolveApproach(task.local_id, task.id, phaseModeIndex, task.phase_suffix, task.phase_set);
|
|
232
|
+
const capabilities = resolveTaskCapabilities(task.local_id, task.id, phaseModeIndex, task.phase_suffix, task.phase_set);
|
|
233
|
+
if (capabilities.length > 0)
|
|
234
|
+
task.capabilities = capabilities;
|
|
235
|
+
const proficiency = resolveTaskProficiency(task.local_id, task.id, phaseModeIndex, task.phase_suffix, task.phase_set);
|
|
236
|
+
if (proficiency !== undefined)
|
|
237
|
+
task.proficiency = proficiency;
|
|
238
|
+
const agentPipeline = resolveAgentPipeline(task.local_id, task.id, phaseModeIndex, task.phase_suffix, task.phase_set);
|
|
239
|
+
if (agentPipeline !== undefined)
|
|
240
|
+
task.agent_pipeline = agentPipeline;
|
|
241
|
+
const agent = resolveAgentAssignment(task.local_id, task.id, phaseModeIndex, task.phase_suffix, task.phase_set);
|
|
242
|
+
if (agent !== undefined)
|
|
243
|
+
task.agent = agent;
|
|
244
|
+
}
|
|
166
245
|
writeReadyFiles(projectPath, readySnapshot);
|
|
167
|
-
|
|
168
|
-
|
|
246
|
+
const ganttChartFiles = ["gantt-chart", "gantt-chart-milestones"]
|
|
247
|
+
.concat(scheduleTrackNames(schedule).map((track) => `gantt-chart-track-${track}`))
|
|
248
|
+
.flatMap((base) => [`${base}.md`, `${base}.svg`]);
|
|
249
|
+
writeJson(join(genDir, "metadata.json"), {
|
|
169
250
|
schedule_path: toArtifactPath(projectPath),
|
|
170
251
|
execution_path: toArtifactPath(executionRootForProject(projectPath)),
|
|
171
252
|
generated_dir: toArtifactPath(genDir),
|
|
172
|
-
schedule_files: schedule.files.map(p => toScheduleFilePath(projectPath, p)).sort(),
|
|
253
|
+
schedule_files: schedule.files.map((p) => toScheduleFilePath(projectPath, p)).sort(),
|
|
173
254
|
event_files_count: events.length,
|
|
174
|
-
default_scheduler_strategy:
|
|
255
|
+
default_scheduler_strategy: "critical-first",
|
|
175
256
|
derived_files: [
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
'timeline.md',
|
|
190
|
-
'timeline.svg',
|
|
191
|
-
],
|
|
257
|
+
"claim-next.json",
|
|
258
|
+
"cpm.json",
|
|
259
|
+
"cpm.md",
|
|
260
|
+
"critical-path.md",
|
|
261
|
+
"exec.jsonl",
|
|
262
|
+
"metadata.json",
|
|
263
|
+
"ready.json",
|
|
264
|
+
"ready.md",
|
|
265
|
+
"schedule-diff.md",
|
|
266
|
+
"schedule-hash.json",
|
|
267
|
+
"state.json",
|
|
268
|
+
...ganttChartFiles,
|
|
269
|
+
].sort(),
|
|
192
270
|
});
|
|
193
271
|
return snapshot;
|
|
194
272
|
}
|
package/dist/exec-shared.js
CHANGED
|
@@ -1,45 +1,163 @@
|
|
|
1
|
-
import { randomBytes } from
|
|
2
|
-
import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from
|
|
3
|
-
import { basename, join, relative } from
|
|
4
|
-
import yaml from
|
|
5
|
-
import { specdojoRootDir } from
|
|
1
|
+
import { randomBytes } from "node:crypto";
|
|
2
|
+
import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
|
|
3
|
+
import { basename, join, relative } from "node:path";
|
|
4
|
+
import yaml from "js-yaml";
|
|
5
|
+
import { specdojoRootDir } from "./specdojo-config.js";
|
|
6
6
|
export function nowUtcIsoSeconds() {
|
|
7
|
-
return new Date().toISOString().replace(/\.\d{3}Z$/,
|
|
7
|
+
return new Date().toISOString().replace(/\.\d{3}Z$/, "Z");
|
|
8
8
|
}
|
|
9
9
|
export function isUtcIsoSeconds(ts) {
|
|
10
10
|
return /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$/.test(ts);
|
|
11
11
|
}
|
|
12
12
|
export function tsForFilenameUtc(ts) {
|
|
13
|
-
return ts.replace(/[-:]/g,
|
|
13
|
+
return ts.replace(/[-:]/g, "").replace("T", "T");
|
|
14
|
+
}
|
|
15
|
+
// worktree/branch 生成専用。project 修飾した task ID(`<projectId>:<taskId>`)を返す。
|
|
16
|
+
// projectId が未解決(env path override 等)の場合は bare のままにして後方互換を保つ。
|
|
17
|
+
// schedule 検索・plan/result ファイル名・claim には使わない(bare の task ID を使う)。
|
|
18
|
+
export function qualifyTaskId(projectId, taskId) {
|
|
19
|
+
return projectId ? `${projectId}:${taskId}` : taskId;
|
|
14
20
|
}
|
|
15
21
|
export function safeSlug(s) {
|
|
16
22
|
return s
|
|
17
23
|
.trim()
|
|
18
|
-
.replace(/\s+/g,
|
|
19
|
-
.replace(/[^A-Za-z0-9._-]/g,
|
|
24
|
+
.replace(/\s+/g, "-")
|
|
25
|
+
.replace(/[^A-Za-z0-9._-]/g, "_")
|
|
20
26
|
.slice(0, 80);
|
|
21
27
|
}
|
|
22
28
|
export function randomHex(bytes) {
|
|
23
|
-
return randomBytes(bytes).toString(
|
|
29
|
+
return randomBytes(bytes).toString("hex");
|
|
24
30
|
}
|
|
25
31
|
export function ensureDir(path) {
|
|
26
32
|
if (!existsSync(path))
|
|
27
33
|
mkdirSync(path, { recursive: true });
|
|
28
34
|
}
|
|
29
35
|
export function requireNonEmpty(name, v) {
|
|
30
|
-
if (typeof v !==
|
|
36
|
+
if (typeof v !== "string" || v.trim().length === 0)
|
|
31
37
|
throw new Error(`${name} is required`);
|
|
32
38
|
return v.trim();
|
|
33
39
|
}
|
|
34
40
|
export function collectRepeatable(value, previous) {
|
|
35
41
|
return previous.concat([value]);
|
|
36
42
|
}
|
|
43
|
+
// CPM 由来の日数値(ES / EF / slack / duration 等)の表示用フォーマット。
|
|
44
|
+
// 浮動小数点誤差(例: 6.2509999999999994)を吸収し、小数点以下を最大2桁に丸める。
|
|
45
|
+
// JSON 等のデータ出力には使わず、Markdown 表示にのみ使う。
|
|
46
|
+
export function formatDays(value) {
|
|
47
|
+
return String(Math.round(value * 100) / 100);
|
|
48
|
+
}
|
|
49
|
+
// East Asian Wide / Fullwidth code point ranges. Characters in these ranges occupy two terminal
|
|
50
|
+
// columns, so they must count as 2 when aligning columns (e.g. Japanese task names in `exec status`).
|
|
51
|
+
const WIDE_CODE_POINT_RANGES = [
|
|
52
|
+
[0x1100, 0x115f], // Hangul Jamo
|
|
53
|
+
[0x2329, 0x232a], // angle brackets
|
|
54
|
+
[0x2e80, 0x303e], // CJK radicals, Kangxi, CJK symbols and punctuation
|
|
55
|
+
[0x3041, 0x33ff], // Hiragana, Katakana, CJK symbols, enclosed CJK
|
|
56
|
+
[0x3400, 0x4dbf], // CJK Unified Ideographs Extension A
|
|
57
|
+
[0x4e00, 0x9fff], // CJK Unified Ideographs
|
|
58
|
+
[0xa000, 0xa4cf], // Yi
|
|
59
|
+
[0xac00, 0xd7a3], // Hangul Syllables
|
|
60
|
+
[0xf900, 0xfaff], // CJK Compatibility Ideographs
|
|
61
|
+
[0xfe10, 0xfe19], // Vertical forms
|
|
62
|
+
[0xfe30, 0xfe6f], // CJK Compatibility Forms, Small Form Variants
|
|
63
|
+
[0xff00, 0xff60], // Fullwidth Forms
|
|
64
|
+
[0xffe0, 0xffe6], // Fullwidth signs
|
|
65
|
+
[0x1f300, 0x1faff], // Emoji and pictographs
|
|
66
|
+
[0x20000, 0x3fffd], // CJK Unified Ideographs Extension B and beyond
|
|
67
|
+
];
|
|
68
|
+
function isWideCodePoint(cp) {
|
|
69
|
+
return WIDE_CODE_POINT_RANGES.some(([start, end]) => cp >= start && cp <= end);
|
|
70
|
+
}
|
|
71
|
+
// Returns the terminal display width of a string, counting East Asian Wide / Fullwidth characters
|
|
72
|
+
// as 2 columns and everything else as 1. Iterates by code point so surrogate pairs count once.
|
|
73
|
+
export function displayWidth(text) {
|
|
74
|
+
let width = 0;
|
|
75
|
+
for (const ch of text) {
|
|
76
|
+
width += isWideCodePoint(ch.codePointAt(0) ?? 0) ? 2 : 1;
|
|
77
|
+
}
|
|
78
|
+
return width;
|
|
79
|
+
}
|
|
80
|
+
// Pads a string on the right with spaces until it reaches the given display width. Uses
|
|
81
|
+
// displayWidth so full-width characters are accounted for; returns the string unchanged if it is
|
|
82
|
+
// already at least that wide.
|
|
83
|
+
export function padEndDisplay(text, width) {
|
|
84
|
+
const pad = width - displayWidth(text);
|
|
85
|
+
return pad > 0 ? text + " ".repeat(pad) : text;
|
|
86
|
+
}
|
|
87
|
+
export function expandTemplate(template, values) {
|
|
88
|
+
let result = template;
|
|
89
|
+
for (const [placeholder, value] of Object.entries(values)) {
|
|
90
|
+
result = result.split(placeholder).join(value);
|
|
91
|
+
}
|
|
92
|
+
// 置換値が改行で始まる場合(depends_on の入れ子リストなど)、template 側の
|
|
93
|
+
// `: _PLACEHOLDER_` の空白が行末に残る。生成 plan は prettier の整形対象外
|
|
94
|
+
// (.prettierignore)で checkpoint commit 時に markdownlint の MD009 が直接効くため、
|
|
95
|
+
// ここで行末の空白を取り除く。
|
|
96
|
+
return result.replace(/[ \t]+$/gm, "");
|
|
97
|
+
}
|
|
98
|
+
// 登録簿の自由記述(title / description 列など)を Markdown 本文へ埋め込む際の安全化。
|
|
99
|
+
// `register_date_timezone` のようなアンダースコア入り識別子や `_TODO_` / `_ASSUMPTION_` が、
|
|
100
|
+
// 強調記号(`_..._` / `*...*`)として誤解釈され、生成 plan が markdownlint の MD049
|
|
101
|
+
// (強調スタイル不統一)で失敗する事故を防ぐ。
|
|
102
|
+
//
|
|
103
|
+
// バックスラッシュエスケープ(`\_`)は使わない。生成パイプライン末尾の prettier が「不要」と
|
|
104
|
+
// 判定した抑制を正規化で除去してしまい、生のアンダースコアへ戻るためである。代わりに `_` や `*`
|
|
105
|
+
// を含む ASCII トークンをバッククォートの code span で包み、prettier を通しても安定させる。
|
|
106
|
+
// code span 内は強調解釈されないため MD049 を確実に回避できる。既存の code span は著者が意図した
|
|
107
|
+
// 記法として温存する。日本語などマルチバイト文字は ASCII トークン境界となり巻き込まない。
|
|
108
|
+
const MARKDOWN_CODE_SPAN = /(`+)[\s\S]*?\1/g;
|
|
109
|
+
// バックティック(0x60)を除く印字可能 ASCII の連続。空白とマルチバイト文字で区切られる。
|
|
110
|
+
const ASCII_RUN = /[\x21-\x5f\x61-\x7e]+/g;
|
|
111
|
+
function replaceOutsideMarkdownCodeSpans(text, replace) {
|
|
112
|
+
let result = "";
|
|
113
|
+
let lastIndex = 0;
|
|
114
|
+
for (const match of text.matchAll(MARKDOWN_CODE_SPAN)) {
|
|
115
|
+
const start = match.index ?? 0;
|
|
116
|
+
result += replace(text.slice(lastIndex, start));
|
|
117
|
+
result += match[0];
|
|
118
|
+
lastIndex = start + match[0].length;
|
|
119
|
+
}
|
|
120
|
+
result += replace(text.slice(lastIndex));
|
|
121
|
+
return result;
|
|
122
|
+
}
|
|
123
|
+
// Markdown コードスパン外にある山括弧トークンをインラインコード化する。
|
|
124
|
+
// 山括弧に連結する英数字・ハイフン・アンダースコア・ドットは、記述規約どおり同じ範囲で囲む。
|
|
125
|
+
// ドットを含めるのは `dct-<domain>.yaml` のような拡張子付きの参照を分断しないためだが、
|
|
126
|
+
// 文末の句点を巻き込まないよう、末尾のドットはコードスパンの外へ戻す。
|
|
127
|
+
export function inlineCodeAnglePlaceholders(text) {
|
|
128
|
+
const placeholder = /[A-Za-z0-9._-]*(?:<[^<>\r\n]+>[A-Za-z0-9._-]*)+/g;
|
|
129
|
+
const wrapToken = (token) => {
|
|
130
|
+
const trailing = token.match(/\.+$/)?.[0] ?? "";
|
|
131
|
+
const body = trailing ? token.slice(0, -trailing.length) : token;
|
|
132
|
+
return `\`${body}\`${trailing}`;
|
|
133
|
+
};
|
|
134
|
+
return replaceOutsideMarkdownCodeSpans(text, (segment) => segment.replace(placeholder, wrapToken));
|
|
135
|
+
}
|
|
136
|
+
export function escapeMarkdownInline(text) {
|
|
137
|
+
return replaceOutsideMarkdownCodeSpans(inlineCodeAnglePlaceholders(text), codeSpanRiskyTokens);
|
|
138
|
+
}
|
|
139
|
+
function codeSpanRiskyTokens(segment) {
|
|
140
|
+
return segment.replace(ASCII_RUN, (run) => (/[_*]/.test(run) ? `\`${run}\`` : run));
|
|
141
|
+
}
|
|
142
|
+
// ESC(0x1B) / CSI(0x9B) で始まる ANSI エスケープシーケンス(SGR の色指定や OSC など)。
|
|
143
|
+
// lefthook などが失敗時に返す色付きボックス UI の制御コードを表す。ansi-regex 相当。
|
|
144
|
+
const ANSI_ESCAPE = /[\u001b\u009b][[\]()#;?]*(?:(?:(?:[a-zA-Z\d]*(?:;[a-zA-Z\d]*)*)?\u0007)|(?:(?:\d{1,4}(?:;\d{0,4})*)?[\dA-PR-TZcf-ntqry=><~]))/g;
|
|
145
|
+
// タブ(0x09)・改行(0x0A)・復帰(0x0D) を除く C0/C1 制御文字。改行類は呼び出し側で
|
|
146
|
+
// 1 行化などの整形を行うため、ここでは残す。
|
|
147
|
+
const CONTROL_CHARS = /[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f-\u009f]/g;
|
|
148
|
+
// subprocess の生出力をユーザー向け文字列(Markdown の表セル・result の理由欄など)へ
|
|
149
|
+
// 埋め込む前に、ANSI エスケープシーケンスとその他のターミナル制御文字を除去する。
|
|
150
|
+
// これを怠ると色付き出力を返すコマンド(lefthook 等)の失敗理由が制御コードごと
|
|
151
|
+
// 書き込まれ、表示や Markdown 構造が壊れる。
|
|
152
|
+
export function stripTerminalControlSequences(text) {
|
|
153
|
+
return text.replace(ANSI_ESCAPE, "").replace(CONTROL_CHARS, "");
|
|
154
|
+
}
|
|
37
155
|
export function parseKeyValuePairs(pairs) {
|
|
38
156
|
if (!pairs || pairs.length === 0)
|
|
39
157
|
return undefined;
|
|
40
158
|
const out = {};
|
|
41
159
|
for (const p of pairs) {
|
|
42
|
-
const idx = p.indexOf(
|
|
160
|
+
const idx = p.indexOf("=");
|
|
43
161
|
if (idx <= 0)
|
|
44
162
|
throw new Error(`Invalid key=value: ${p}`);
|
|
45
163
|
const k = p.slice(0, idx).trim();
|
|
@@ -65,19 +183,22 @@ export function listFilesRecursive(dir) {
|
|
|
65
183
|
return out;
|
|
66
184
|
}
|
|
67
185
|
export function readJson(path) {
|
|
68
|
-
return JSON.parse(readFileSync(path,
|
|
186
|
+
return JSON.parse(readFileSync(path, "utf8"));
|
|
187
|
+
}
|
|
188
|
+
export function isRecord(value) {
|
|
189
|
+
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
190
|
+
}
|
|
191
|
+
export function isStringArray(value) {
|
|
192
|
+
return Array.isArray(value) && value.every((item) => typeof item === "string");
|
|
69
193
|
}
|
|
70
194
|
export function writeJson(path, data) {
|
|
71
|
-
writeFileSync(path, JSON.stringify(data, null, 2) +
|
|
195
|
+
writeFileSync(path, JSON.stringify(data, null, 2) + "\n", "utf8");
|
|
72
196
|
}
|
|
73
197
|
export function readYaml(path) {
|
|
74
|
-
return yaml.load(readFileSync(path,
|
|
198
|
+
return yaml.load(readFileSync(path, "utf8"));
|
|
75
199
|
}
|
|
76
200
|
export function isSchYamlFilename(path) {
|
|
77
201
|
const name = basename(path);
|
|
78
|
-
// Exclude defaults file
|
|
79
|
-
if (name === 'sch-defaults.yaml' || name === 'sch-defaults.yml')
|
|
80
|
-
return false;
|
|
81
202
|
return /^sch-.*\.(yaml|yml)$/.test(name);
|
|
82
203
|
}
|
|
83
204
|
export function sleepMs(ms) {
|
|
@@ -86,25 +207,25 @@ export function sleepMs(ms) {
|
|
|
86
207
|
Atomics.wait(int32, 0, 0, ms);
|
|
87
208
|
}
|
|
88
209
|
export function toPortablePath(path) {
|
|
89
|
-
return path.replace(/\\/g,
|
|
210
|
+
return path.replace(/\\/g, "/");
|
|
90
211
|
}
|
|
91
212
|
export function toArtifactPath(path) {
|
|
92
213
|
const rel = relative(specdojoRootDir(), path);
|
|
93
|
-
return toPortablePath(rel ||
|
|
214
|
+
return toPortablePath(rel || ".");
|
|
94
215
|
}
|
|
95
216
|
export function toScheduleFilePath(schedulePath, filePath) {
|
|
96
|
-
return toPortablePath(relative(schedulePath, filePath) ||
|
|
217
|
+
return toPortablePath(relative(schedulePath, filePath) || ".");
|
|
97
218
|
}
|
|
98
219
|
export function formatDateOnlyUtc(dt) {
|
|
99
|
-
const yyyy = dt.getUTCFullYear().toString().padStart(4,
|
|
100
|
-
const mm = (dt.getUTCMonth() + 1).toString().padStart(2,
|
|
101
|
-
const dd = dt.getUTCDate().toString().padStart(2,
|
|
220
|
+
const yyyy = dt.getUTCFullYear().toString().padStart(4, "0");
|
|
221
|
+
const mm = (dt.getUTCMonth() + 1).toString().padStart(2, "0");
|
|
222
|
+
const dd = dt.getUTCDate().toString().padStart(2, "0");
|
|
102
223
|
return `${yyyy}-${mm}-${dd}`;
|
|
103
224
|
}
|
|
104
225
|
export function normalizeDateOnly(value) {
|
|
105
226
|
if (value instanceof Date && !Number.isNaN(value.getTime()))
|
|
106
227
|
return formatDateOnlyUtc(value);
|
|
107
|
-
if (typeof value !==
|
|
228
|
+
if (typeof value !== "string")
|
|
108
229
|
return null;
|
|
109
230
|
const trimmed = value.trim();
|
|
110
231
|
if (!trimmed)
|