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,363 @@
|
|
|
1
|
+
// Register の現在値は個票 frontmatter、変更履歴は events/pjr-XXXX.yaml が正本である。
|
|
2
|
+
// イベントは項目ごとの YAML 配列へ古い順に追記し、個票本文の変更と監査履歴の差分を分離する。
|
|
3
|
+
import { createHash, randomUUID } from "node:crypto";
|
|
4
|
+
import { existsSync, readdirSync, readFileSync } from "node:fs";
|
|
5
|
+
import { join } from "node:path";
|
|
6
|
+
import yaml from "js-yaml";
|
|
7
|
+
import { CELL_NONE, displayIdFromTicketFilename, readRegisterItemContent, readSpecdojoFields, toDisplayItem, updateSpecdojoFields, VALID_STATUSES, } from "./register-item.js";
|
|
8
|
+
import { isUtcIsoSeconds, nowUtcIsoSeconds } from "./exec-shared.js";
|
|
9
|
+
export const REGISTER_EVENTS_DIRNAME = "events";
|
|
10
|
+
export const REGISTER_EVENTS_SCHEMA_MODELINE = "# yaml-language-server: $schema=../../../../../../specdojo/schemas/v1/register-events.schema.yaml";
|
|
11
|
+
export const REGISTER_EVENT_FIELDS = [
|
|
12
|
+
"status",
|
|
13
|
+
"title",
|
|
14
|
+
"description",
|
|
15
|
+
"type",
|
|
16
|
+
"priority",
|
|
17
|
+
"owner",
|
|
18
|
+
"registered",
|
|
19
|
+
"due",
|
|
20
|
+
"completed",
|
|
21
|
+
"conclusion",
|
|
22
|
+
"block_reason",
|
|
23
|
+
];
|
|
24
|
+
export const REGISTER_EVENT_ACTIONS = [
|
|
25
|
+
"add",
|
|
26
|
+
"start",
|
|
27
|
+
"wait",
|
|
28
|
+
"review",
|
|
29
|
+
"close",
|
|
30
|
+
"reject",
|
|
31
|
+
"defer",
|
|
32
|
+
"reopen",
|
|
33
|
+
"update",
|
|
34
|
+
"renumber",
|
|
35
|
+
"migrate",
|
|
36
|
+
];
|
|
37
|
+
export const REGISTER_EVENT_ID_RE = /^reg_[a-f0-9]{32}$/;
|
|
38
|
+
const REGISTER_EVENT_FILENAME_RE = /^pjr-([0-9abcdefghjkmnpqrstvwxyz]{4})\.yaml$/;
|
|
39
|
+
function isRecord(value) {
|
|
40
|
+
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
41
|
+
}
|
|
42
|
+
export function registerEventFilename(displayId) {
|
|
43
|
+
return `${displayId.toLowerCase()}.yaml`;
|
|
44
|
+
}
|
|
45
|
+
export function displayIdFromRegisterEventFilename(filename) {
|
|
46
|
+
const match = REGISTER_EVENT_FILENAME_RE.exec(filename);
|
|
47
|
+
return match ? `PJR-${match[1].toUpperCase()}` : undefined;
|
|
48
|
+
}
|
|
49
|
+
export function registerEventFilePath(projectRegisterPath, displayId) {
|
|
50
|
+
return join(projectRegisterPath, REGISTER_EVENTS_DIRNAME, registerEventFilename(displayId));
|
|
51
|
+
}
|
|
52
|
+
export function registerEventFieldValues(content, filename, timeZone) {
|
|
53
|
+
if (content === undefined)
|
|
54
|
+
return undefined;
|
|
55
|
+
const parsed = readRegisterItemContent(content, filename);
|
|
56
|
+
if (!parsed)
|
|
57
|
+
return undefined;
|
|
58
|
+
const item = toDisplayItem(parsed.item, timeZone);
|
|
59
|
+
return {
|
|
60
|
+
status: item.status,
|
|
61
|
+
title: item.title,
|
|
62
|
+
description: item.description,
|
|
63
|
+
type: item.type,
|
|
64
|
+
priority: item.priority,
|
|
65
|
+
owner: item.owner,
|
|
66
|
+
registered: item.registered,
|
|
67
|
+
due: item.due,
|
|
68
|
+
completed: item.completed,
|
|
69
|
+
conclusion: item.conclusion,
|
|
70
|
+
block_reason: parsed.blockReason,
|
|
71
|
+
};
|
|
72
|
+
}
|
|
73
|
+
function isUnsetFieldValue(value) {
|
|
74
|
+
return value === "" || value === CELL_NONE;
|
|
75
|
+
}
|
|
76
|
+
export function diffRegisterEventFields(before, after) {
|
|
77
|
+
const changes = [];
|
|
78
|
+
for (const field of REGISTER_EVENT_FIELDS) {
|
|
79
|
+
const from = before?.[field] ?? "";
|
|
80
|
+
const to = after?.[field] ?? "";
|
|
81
|
+
if (isUnsetFieldValue(from) && isUnsetFieldValue(to))
|
|
82
|
+
continue;
|
|
83
|
+
if (from !== to)
|
|
84
|
+
changes.push({ field, from, to });
|
|
85
|
+
}
|
|
86
|
+
return changes;
|
|
87
|
+
}
|
|
88
|
+
function randomEventId() {
|
|
89
|
+
return `reg_${randomUUID().replaceAll("-", "")}`;
|
|
90
|
+
}
|
|
91
|
+
export function deterministicRegisterEventId(seed) {
|
|
92
|
+
return `reg_${createHash("sha256").update(seed).digest("hex").slice(0, 32)}`;
|
|
93
|
+
}
|
|
94
|
+
export function buildRegisterEvent(opts) {
|
|
95
|
+
const before = registerEventFieldValues(opts.beforeContent, opts.filename, opts.timeZone);
|
|
96
|
+
const after = registerEventFieldValues(opts.afterContent, opts.filename, opts.timeZone);
|
|
97
|
+
if (!after)
|
|
98
|
+
throw new Error(`cannot build register event for invalid item: ${opts.filename}`);
|
|
99
|
+
const changes = [...(opts.extraChanges ?? []), ...diffRegisterEventFields(before, after)];
|
|
100
|
+
if (changes.length === 0)
|
|
101
|
+
return undefined;
|
|
102
|
+
const actor = opts.actor.trim();
|
|
103
|
+
const reason = opts.reason.trim();
|
|
104
|
+
if (actor === "")
|
|
105
|
+
throw new Error("register event actor must not be empty");
|
|
106
|
+
if (reason === "")
|
|
107
|
+
throw new Error("register event reason must not be empty");
|
|
108
|
+
const event = {
|
|
109
|
+
v: 1,
|
|
110
|
+
id: opts.id ?? randomEventId(),
|
|
111
|
+
ts: opts.ts ?? nowUtcIsoSeconds(),
|
|
112
|
+
action: opts.action,
|
|
113
|
+
actor,
|
|
114
|
+
from_status: before?.status ?? null,
|
|
115
|
+
to_status: after.status,
|
|
116
|
+
reason,
|
|
117
|
+
changes,
|
|
118
|
+
};
|
|
119
|
+
if (opts.legacyCommit)
|
|
120
|
+
event.legacy_commit = opts.legacyCommit;
|
|
121
|
+
return event;
|
|
122
|
+
}
|
|
123
|
+
export function validateRegisterEventShape(value, source) {
|
|
124
|
+
const errors = [];
|
|
125
|
+
const error = (message) => {
|
|
126
|
+
errors.push(`${source}: ${message}`);
|
|
127
|
+
};
|
|
128
|
+
if (!isRecord(value)) {
|
|
129
|
+
error("event must be an object");
|
|
130
|
+
return errors;
|
|
131
|
+
}
|
|
132
|
+
if (value.v !== 1)
|
|
133
|
+
error("v must be 1");
|
|
134
|
+
if (typeof value.id !== "string" || !REGISTER_EVENT_ID_RE.test(value.id)) {
|
|
135
|
+
error("id must match reg_<32 lowercase hex characters>");
|
|
136
|
+
}
|
|
137
|
+
if (typeof value.ts !== "string" || !isUtcIsoSeconds(value.ts)) {
|
|
138
|
+
error("ts must be UTC ISO seconds like 2026-03-05T03:10:00Z");
|
|
139
|
+
}
|
|
140
|
+
if (typeof value.action !== "string" ||
|
|
141
|
+
!REGISTER_EVENT_ACTIONS.includes(value.action)) {
|
|
142
|
+
error(`action must be one of ${REGISTER_EVENT_ACTIONS.join(", ")}`);
|
|
143
|
+
}
|
|
144
|
+
if (typeof value.actor !== "string" || value.actor.trim() === "") {
|
|
145
|
+
error("actor must be a non-empty string");
|
|
146
|
+
}
|
|
147
|
+
if (value.from_status !== null &&
|
|
148
|
+
(typeof value.from_status !== "string" ||
|
|
149
|
+
!VALID_STATUSES.includes(value.from_status))) {
|
|
150
|
+
error(`from_status must be null or one of ${VALID_STATUSES.join(", ")}`);
|
|
151
|
+
}
|
|
152
|
+
if (typeof value.to_status !== "string" ||
|
|
153
|
+
!VALID_STATUSES.includes(value.to_status)) {
|
|
154
|
+
error(`to_status must be one of ${VALID_STATUSES.join(", ")}`);
|
|
155
|
+
}
|
|
156
|
+
if (typeof value.reason !== "string" || value.reason.trim() === "") {
|
|
157
|
+
error("reason must be a non-empty string");
|
|
158
|
+
}
|
|
159
|
+
if (!Array.isArray(value.changes) || value.changes.length === 0) {
|
|
160
|
+
error("changes must be a non-empty array");
|
|
161
|
+
}
|
|
162
|
+
else {
|
|
163
|
+
value.changes.forEach((change, index) => {
|
|
164
|
+
if (!isRecord(change)) {
|
|
165
|
+
error(`changes[${index}] must be an object`);
|
|
166
|
+
return;
|
|
167
|
+
}
|
|
168
|
+
if (typeof change.field !== "string" ||
|
|
169
|
+
![...REGISTER_EVENT_FIELDS, "id"].includes(change.field)) {
|
|
170
|
+
error(`changes[${index}].field is invalid`);
|
|
171
|
+
}
|
|
172
|
+
if (typeof change.from !== "string")
|
|
173
|
+
error(`changes[${index}].from must be a string`);
|
|
174
|
+
if (typeof change.to !== "string")
|
|
175
|
+
error(`changes[${index}].to must be a string`);
|
|
176
|
+
});
|
|
177
|
+
}
|
|
178
|
+
if (value.previous_event_id !== undefined &&
|
|
179
|
+
(typeof value.previous_event_id !== "string" ||
|
|
180
|
+
!REGISTER_EVENT_ID_RE.test(value.previous_event_id))) {
|
|
181
|
+
error("previous_event_id must be a register event id");
|
|
182
|
+
}
|
|
183
|
+
if (value.legacy_commit !== undefined && typeof value.legacy_commit !== "string") {
|
|
184
|
+
error("legacy_commit must be a string");
|
|
185
|
+
}
|
|
186
|
+
return errors;
|
|
187
|
+
}
|
|
188
|
+
export function readRegisterEventsFromContent(content, source) {
|
|
189
|
+
let parsed;
|
|
190
|
+
try {
|
|
191
|
+
parsed = yaml.load(content);
|
|
192
|
+
}
|
|
193
|
+
catch (error) {
|
|
194
|
+
const detail = error instanceof Error ? error.message : String(error);
|
|
195
|
+
throw new Error(`${source}: invalid register event YAML: ${detail}`);
|
|
196
|
+
}
|
|
197
|
+
if (!Array.isArray(parsed))
|
|
198
|
+
throw new Error(`${source}: register event file must be an array`);
|
|
199
|
+
const events = [];
|
|
200
|
+
parsed.forEach((event, index) => {
|
|
201
|
+
const errors = validateRegisterEventShape(event, `${source}[${index}]`);
|
|
202
|
+
if (errors.length > 0)
|
|
203
|
+
throw new Error(errors.join("; "));
|
|
204
|
+
events.push(event);
|
|
205
|
+
});
|
|
206
|
+
return events;
|
|
207
|
+
}
|
|
208
|
+
export function serializeRegisterEvents(events) {
|
|
209
|
+
return `${REGISTER_EVENTS_SCHEMA_MODELINE}\n${yaml.dump([...events], {
|
|
210
|
+
lineWidth: -1,
|
|
211
|
+
noRefs: true,
|
|
212
|
+
quotingType: '"',
|
|
213
|
+
})}`;
|
|
214
|
+
}
|
|
215
|
+
export function appendRegisterEvent(content, event) {
|
|
216
|
+
const events = content ? readRegisterEventsFromContent(content, "register event file") : [];
|
|
217
|
+
if (events.some((existing) => existing.id === event.id))
|
|
218
|
+
return content ?? serializeRegisterEvents(events);
|
|
219
|
+
const previous = events.at(-1);
|
|
220
|
+
const next = previous
|
|
221
|
+
? { ...event, previous_event_id: previous.id }
|
|
222
|
+
: { ...event };
|
|
223
|
+
return serializeRegisterEvents([...events, next]);
|
|
224
|
+
}
|
|
225
|
+
export function readEmbeddedRegisterEvents(content, source) {
|
|
226
|
+
const fields = readSpecdojoFields(content);
|
|
227
|
+
if (fields.register_events === undefined)
|
|
228
|
+
return [];
|
|
229
|
+
if (!Array.isArray(fields.register_events)) {
|
|
230
|
+
throw new Error(`${source}: register_events must be an array`);
|
|
231
|
+
}
|
|
232
|
+
const events = [];
|
|
233
|
+
fields.register_events.forEach((event, index) => {
|
|
234
|
+
const errors = validateRegisterEventShape(event, `${source}: register_events[${index}]`);
|
|
235
|
+
if (errors.length > 0)
|
|
236
|
+
throw new Error(errors.join("; "));
|
|
237
|
+
events.push(event);
|
|
238
|
+
});
|
|
239
|
+
return events;
|
|
240
|
+
}
|
|
241
|
+
export function removeEmbeddedRegisterEvents(content) {
|
|
242
|
+
return updateSpecdojoFields(content, (fields) => {
|
|
243
|
+
delete fields.register_events;
|
|
244
|
+
});
|
|
245
|
+
}
|
|
246
|
+
export function validateRegisterEventLog(ticketContent, eventContent, ticketFilename, eventFilename, timeZone) {
|
|
247
|
+
let events;
|
|
248
|
+
try {
|
|
249
|
+
events = readRegisterEventsFromContent(eventContent, eventFilename);
|
|
250
|
+
}
|
|
251
|
+
catch (error) {
|
|
252
|
+
return [error instanceof Error ? error.message : String(error)];
|
|
253
|
+
}
|
|
254
|
+
if (events.length === 0)
|
|
255
|
+
return [`${eventFilename}: event log must not be empty`];
|
|
256
|
+
const errors = [];
|
|
257
|
+
const ids = new Set();
|
|
258
|
+
let previous;
|
|
259
|
+
for (const event of events) {
|
|
260
|
+
if (ids.has(event.id))
|
|
261
|
+
errors.push(`${eventFilename}: duplicate register event id ${event.id}`);
|
|
262
|
+
ids.add(event.id);
|
|
263
|
+
if (previous) {
|
|
264
|
+
if (event.previous_event_id !== previous.id) {
|
|
265
|
+
errors.push(`${eventFilename}: event ${event.id} does not reference previous event ${previous.id}`);
|
|
266
|
+
}
|
|
267
|
+
if (event.ts < previous.ts) {
|
|
268
|
+
errors.push(`${eventFilename}: event ${event.id} timestamp precedes the previous event`);
|
|
269
|
+
}
|
|
270
|
+
if (event.from_status !== previous.to_status) {
|
|
271
|
+
errors.push(`${eventFilename}: event ${event.id} starts at ${event.from_status ?? "null"}, expected ${previous.to_status}`);
|
|
272
|
+
}
|
|
273
|
+
}
|
|
274
|
+
else if (event.previous_event_id !== undefined) {
|
|
275
|
+
errors.push(`${eventFilename}: first event must not have previous_event_id`);
|
|
276
|
+
}
|
|
277
|
+
const statusChange = event.changes.find((change) => change.field === "status");
|
|
278
|
+
if (statusChange) {
|
|
279
|
+
const expectedFrom = event.from_status ?? "";
|
|
280
|
+
if (statusChange.from !== expectedFrom || statusChange.to !== event.to_status) {
|
|
281
|
+
errors.push(`${eventFilename}: event ${event.id} status change disagrees with transition fields`);
|
|
282
|
+
}
|
|
283
|
+
}
|
|
284
|
+
else if (event.from_status !== event.to_status) {
|
|
285
|
+
errors.push(`${eventFilename}: event ${event.id} changes status without a status change entry`);
|
|
286
|
+
}
|
|
287
|
+
previous = event;
|
|
288
|
+
}
|
|
289
|
+
const current = registerEventFieldValues(ticketContent, ticketFilename, timeZone);
|
|
290
|
+
if (!current)
|
|
291
|
+
return [...errors, `${ticketFilename}: cannot read current register item state`];
|
|
292
|
+
if (previous?.to_status !== current.status) {
|
|
293
|
+
errors.push(`${eventFilename}: latest event status ${previous?.to_status ?? CELL_NONE} does not match ${ticketFilename} item_status ${current.status}`);
|
|
294
|
+
}
|
|
295
|
+
return errors;
|
|
296
|
+
}
|
|
297
|
+
export function validateRegisterEventDocs(projectRegisterPath, timeZone) {
|
|
298
|
+
if (!existsSync(projectRegisterPath))
|
|
299
|
+
return [];
|
|
300
|
+
const errors = [];
|
|
301
|
+
const eventIds = new Map();
|
|
302
|
+
const tickets = new Map();
|
|
303
|
+
for (const entry of readdirSync(projectRegisterPath, { withFileTypes: true })) {
|
|
304
|
+
if (!entry.isFile())
|
|
305
|
+
continue;
|
|
306
|
+
const id = displayIdFromTicketFilename(entry.name);
|
|
307
|
+
if (!id)
|
|
308
|
+
continue;
|
|
309
|
+
const content = readFileSync(join(projectRegisterPath, entry.name), "utf8");
|
|
310
|
+
if (readSpecdojoFields(content).register_events !== undefined) {
|
|
311
|
+
errors.push(`${entry.name}: register_events must be stored in events/${registerEventFilename(id)}`);
|
|
312
|
+
}
|
|
313
|
+
tickets.set(id, { filename: entry.name, content });
|
|
314
|
+
}
|
|
315
|
+
const eventsPath = join(projectRegisterPath, REGISTER_EVENTS_DIRNAME);
|
|
316
|
+
if (!existsSync(eventsPath)) {
|
|
317
|
+
return tickets.size > 0
|
|
318
|
+
? [...errors, `${REGISTER_EVENTS_DIRNAME}/: register event directory not found`]
|
|
319
|
+
: errors;
|
|
320
|
+
}
|
|
321
|
+
const seenItems = new Set();
|
|
322
|
+
const entries = readdirSync(eventsPath, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name));
|
|
323
|
+
for (const entry of entries) {
|
|
324
|
+
if (!entry.isFile())
|
|
325
|
+
continue;
|
|
326
|
+
const id = displayIdFromRegisterEventFilename(entry.name);
|
|
327
|
+
if (!id) {
|
|
328
|
+
if (entry.name.endsWith(".yaml"))
|
|
329
|
+
errors.push(`${entry.name}: invalid register event filename`);
|
|
330
|
+
continue;
|
|
331
|
+
}
|
|
332
|
+
seenItems.add(id);
|
|
333
|
+
const ticket = tickets.get(id);
|
|
334
|
+
if (!ticket) {
|
|
335
|
+
errors.push(`${entry.name}: no matching register item for ${id}`);
|
|
336
|
+
continue;
|
|
337
|
+
}
|
|
338
|
+
const content = readFileSync(join(eventsPath, entry.name), "utf8");
|
|
339
|
+
errors.push(...validateRegisterEventLog(ticket.content, content, ticket.filename, `${REGISTER_EVENTS_DIRNAME}/${entry.name}`, timeZone));
|
|
340
|
+
let events;
|
|
341
|
+
try {
|
|
342
|
+
events = readRegisterEventsFromContent(content, entry.name);
|
|
343
|
+
}
|
|
344
|
+
catch {
|
|
345
|
+
continue;
|
|
346
|
+
}
|
|
347
|
+
for (const event of events) {
|
|
348
|
+
const previous = eventIds.get(event.id);
|
|
349
|
+
if (previous) {
|
|
350
|
+
errors.push(`${event.id}: duplicate register event ID in ${previous} and ${entry.name}`);
|
|
351
|
+
}
|
|
352
|
+
else {
|
|
353
|
+
eventIds.set(event.id, entry.name);
|
|
354
|
+
}
|
|
355
|
+
}
|
|
356
|
+
}
|
|
357
|
+
for (const [id, ticket] of tickets) {
|
|
358
|
+
if (!seenItems.has(id)) {
|
|
359
|
+
errors.push(`${ticket.filename}: missing register event file events/${registerEventFilename(id)}`);
|
|
360
|
+
}
|
|
361
|
+
}
|
|
362
|
+
return errors;
|
|
363
|
+
}
|
|
@@ -0,0 +1,323 @@
|
|
|
1
|
+
// 登録項目(PJR-XXXX)の変更履歴を項目別の event ファイルから再構成する。event 導入前または
|
|
2
|
+
// 未移行の期間だけ Git 差分を読み、event の開始時刻より前の legacy 履歴として統合する。
|
|
3
|
+
//
|
|
4
|
+
// 比較対象は生成される登録項目一覧の列(ステータス・タイトル・説明・分類・優先度・担当・
|
|
5
|
+
// 登録日・期限・完了日・結論)に、待機時のブロック理由を加える。ブロック理由は一覧には
|
|
6
|
+
// 表示しないが、conclusion と用途を分けた後も監査できるよう履歴の比較対象にする。
|
|
7
|
+
import { existsSync, readdirSync, readFileSync } from "node:fs";
|
|
8
|
+
import { basename, join } from "node:path";
|
|
9
|
+
import { displayIdFromTicketFilename, isPlaceholderCell } from "./register-item.js";
|
|
10
|
+
import { gitOutput, gitResult } from "./exec-worktree.js";
|
|
11
|
+
import { DEFAULT_REGISTER_DATE_TIMEZONE } from "./specdojo-config.js";
|
|
12
|
+
import { REGISTER_EVENT_FIELDS, REGISTER_EVENTS_DIRNAME, displayIdFromRegisterEventFilename, readRegisterEventsFromContent, registerEventFieldValues, } from "./register-events.js";
|
|
13
|
+
// 比較する項目と出力順。登録項目一覧の列順(ID と個票リンクを除く)に合わせる。
|
|
14
|
+
export const REGISTER_HISTORY_FIELDS = REGISTER_EVENT_FIELDS;
|
|
15
|
+
// git log の1コミット分の区切り(レコード分離子)とヘッダー項目の区切り(単位分離子)。
|
|
16
|
+
// コミットメッセージ本文には現れない制御文字を使い、subject にタブや `|` があっても壊れない。
|
|
17
|
+
const RECORD_SEPARATOR = "\u001e";
|
|
18
|
+
const UNIT_SEPARATOR = "\u001f";
|
|
19
|
+
const LOG_PRETTY_FORMAT = `format:${RECORD_SEPARATOR}%H${UNIT_SEPARATOR}%ad${UNIT_SEPARATOR}%an${UNIT_SEPARATOR}%s`;
|
|
20
|
+
// `--status-only` で残すフィールド。状態遷移そのものと、遷移に伴って記録される値に限る。
|
|
21
|
+
const STATUS_ONLY_FIELDS = new Set([
|
|
22
|
+
"id",
|
|
23
|
+
"status",
|
|
24
|
+
"type",
|
|
25
|
+
"completed",
|
|
26
|
+
"conclusion",
|
|
27
|
+
"block_reason",
|
|
28
|
+
]);
|
|
29
|
+
// 値なしを表す表示文字列。frontmatter のキー省略と、一覧のプレースホルダの両方を含む。
|
|
30
|
+
const EMPTY_VALUE = "(none)";
|
|
31
|
+
// テキスト出力で1つの値を表示する最大長。説明・結論は長文になりうるため省略する。
|
|
32
|
+
const MAX_VALUE_LENGTH = 60;
|
|
33
|
+
const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
|
|
34
|
+
// ================================
|
|
35
|
+
// Parsing
|
|
36
|
+
// ================================
|
|
37
|
+
// `git log --name-status` の出力をコミット単位へ分解する。
|
|
38
|
+
export function parseRegisterLogOutput(output) {
|
|
39
|
+
const entries = [];
|
|
40
|
+
for (const record of output.split(RECORD_SEPARATOR)) {
|
|
41
|
+
if (record.trim() === "")
|
|
42
|
+
continue;
|
|
43
|
+
const lines = record.split(/\r?\n/);
|
|
44
|
+
const header = lines[0]?.split(UNIT_SEPARATOR) ?? [];
|
|
45
|
+
if (header.length < 4)
|
|
46
|
+
continue;
|
|
47
|
+
const files = [];
|
|
48
|
+
for (const line of lines.slice(1)) {
|
|
49
|
+
if (line.trim() === "")
|
|
50
|
+
continue;
|
|
51
|
+
const columns = line.split("\t");
|
|
52
|
+
const status = columns[0]?.trim() ?? "";
|
|
53
|
+
if (!status || columns.length < 2)
|
|
54
|
+
continue;
|
|
55
|
+
if (status.startsWith("R") || status.startsWith("C")) {
|
|
56
|
+
if (columns.length < 3)
|
|
57
|
+
continue;
|
|
58
|
+
files.push({ status, path: columns[2], oldPath: columns[1] });
|
|
59
|
+
continue;
|
|
60
|
+
}
|
|
61
|
+
files.push({ status, path: columns[1] });
|
|
62
|
+
}
|
|
63
|
+
entries.push({
|
|
64
|
+
commit: header[0],
|
|
65
|
+
date: header[1],
|
|
66
|
+
author: header[2],
|
|
67
|
+
subject: header.slice(3).join(UNIT_SEPARATOR),
|
|
68
|
+
files,
|
|
69
|
+
});
|
|
70
|
+
}
|
|
71
|
+
return entries;
|
|
72
|
+
}
|
|
73
|
+
// ================================
|
|
74
|
+
// Event Construction
|
|
75
|
+
// ================================
|
|
76
|
+
// 個票の内容から、比較対象フィールドの値を取り出す。個票として読めない内容は undefined。
|
|
77
|
+
// 登録日・完了日は保存された日時を表示タイムゾーンの暦日へ変換した値で比較する。
|
|
78
|
+
function kindFromStatus(status) {
|
|
79
|
+
if (status.startsWith("A"))
|
|
80
|
+
return "added";
|
|
81
|
+
if (status.startsWith("D"))
|
|
82
|
+
return "removed";
|
|
83
|
+
return "updated";
|
|
84
|
+
}
|
|
85
|
+
function diffFieldValues(before, after) {
|
|
86
|
+
const changes = [];
|
|
87
|
+
for (const field of REGISTER_HISTORY_FIELDS) {
|
|
88
|
+
const from = before?.[field] ?? "";
|
|
89
|
+
const to = after?.[field] ?? "";
|
|
90
|
+
if (from === to)
|
|
91
|
+
continue;
|
|
92
|
+
changes.push({ field, from, to });
|
|
93
|
+
}
|
|
94
|
+
return changes;
|
|
95
|
+
}
|
|
96
|
+
// 個票以外のファイル(生成物・一覧・添付など)は台帳の項目変更ではないため除外する。
|
|
97
|
+
function registerItemIdForPath(path) {
|
|
98
|
+
if (path.includes("/generated/"))
|
|
99
|
+
return undefined;
|
|
100
|
+
return displayIdFromTicketFilename(basename(path));
|
|
101
|
+
}
|
|
102
|
+
// コミット列と「あるリビジョン時点のファイル内容を返す関数」から、項目単位の変更イベントを作る。
|
|
103
|
+
// 入力の順序(git log --reverse なら古い順)をそのまま保つ。
|
|
104
|
+
export function buildRegisterHistoryEvents(commits, readAt, options = {}) {
|
|
105
|
+
const idFilter = options.ids && options.ids.length > 0 ? new Set(options.ids) : undefined;
|
|
106
|
+
const timeZone = options.timeZone ?? DEFAULT_REGISTER_DATE_TIMEZONE;
|
|
107
|
+
const events = [];
|
|
108
|
+
for (const commit of commits) {
|
|
109
|
+
const files = [...commit.files].sort((a, b) => a.path === b.path ? 0 : a.path < b.path ? -1 : 1);
|
|
110
|
+
for (const file of files) {
|
|
111
|
+
const id = registerItemIdForPath(file.path);
|
|
112
|
+
if (!id)
|
|
113
|
+
continue;
|
|
114
|
+
if (idFilter && !idFilter.has(id))
|
|
115
|
+
continue;
|
|
116
|
+
const kind = kindFromStatus(file.status);
|
|
117
|
+
const sourcePath = file.oldPath ?? file.path;
|
|
118
|
+
const before = kind === "added"
|
|
119
|
+
? undefined
|
|
120
|
+
: registerEventFieldValues(readAt(`${commit.commit}^`, sourcePath), basename(sourcePath), timeZone);
|
|
121
|
+
const after = kind === "removed"
|
|
122
|
+
? undefined
|
|
123
|
+
: registerEventFieldValues(readAt(commit.commit, file.path), basename(file.path), timeZone);
|
|
124
|
+
let changes = kind === "removed" ? [] : diffFieldValues(before, after);
|
|
125
|
+
// renumber による ID 付け替えは、フィールド値が変わらないため rename から検出する。
|
|
126
|
+
const oldId = file.oldPath ? registerItemIdForPath(file.oldPath) : undefined;
|
|
127
|
+
if (oldId && oldId !== id) {
|
|
128
|
+
changes.unshift({ field: "id", from: oldId, to: id });
|
|
129
|
+
}
|
|
130
|
+
if (kind === "updated" && changes.length === 0)
|
|
131
|
+
continue;
|
|
132
|
+
if (options.statusOnly) {
|
|
133
|
+
if (kind === "updated" && !changes.some((change) => change.field === "status"))
|
|
134
|
+
continue;
|
|
135
|
+
// 状態遷移の監査に必要な項目だけへ絞る。説明・タイトルの推敲差分は落とす。
|
|
136
|
+
changes = changes.filter((change) => STATUS_ONLY_FIELDS.has(change.field));
|
|
137
|
+
}
|
|
138
|
+
events.push({
|
|
139
|
+
id,
|
|
140
|
+
commit: commit.commit,
|
|
141
|
+
date: commit.date,
|
|
142
|
+
author: commit.author,
|
|
143
|
+
subject: commit.subject,
|
|
144
|
+
kind,
|
|
145
|
+
file: file.path,
|
|
146
|
+
changes,
|
|
147
|
+
});
|
|
148
|
+
}
|
|
149
|
+
}
|
|
150
|
+
return events;
|
|
151
|
+
}
|
|
152
|
+
// ================================
|
|
153
|
+
// Formatting
|
|
154
|
+
// ================================
|
|
155
|
+
function displayValue(value) {
|
|
156
|
+
const text = value.trim();
|
|
157
|
+
if (text === "")
|
|
158
|
+
return EMPTY_VALUE;
|
|
159
|
+
if (text.length <= MAX_VALUE_LENGTH)
|
|
160
|
+
return text;
|
|
161
|
+
return `${text.slice(0, MAX_VALUE_LENGTH)}...`;
|
|
162
|
+
}
|
|
163
|
+
function formatChanges(event) {
|
|
164
|
+
if (event.kind === "removed")
|
|
165
|
+
return "(register item file removed)";
|
|
166
|
+
if (event.kind === "added") {
|
|
167
|
+
// 起票時点で未定の項目(`-` / `_TODO_`)は、値が入った時点の updated で拾えるため出さない。
|
|
168
|
+
const assignments = event.changes
|
|
169
|
+
.filter((change) => !isPlaceholderCell(change.to))
|
|
170
|
+
.map((change) => `${change.field}=${displayValue(change.to)}`);
|
|
171
|
+
return assignments.length > 0 ? assignments.join(", ") : "(no fields)";
|
|
172
|
+
}
|
|
173
|
+
return event.changes
|
|
174
|
+
.map((change) => `${change.field}: ${displayValue(change.from)} -> ${displayValue(change.to)}`)
|
|
175
|
+
.join("; ");
|
|
176
|
+
}
|
|
177
|
+
// 監査時に上から読める1行1イベントの形へ整形する。
|
|
178
|
+
export function formatRegisterHistoryEvents(events) {
|
|
179
|
+
return events
|
|
180
|
+
.map((event) => {
|
|
181
|
+
const commit = event.source === "event" ? event.commit.slice(4, 11) : event.commit.slice(0, 7);
|
|
182
|
+
const kind = event.kind.padEnd(7);
|
|
183
|
+
const suffix = event.source === "event"
|
|
184
|
+
? `${event.action ?? "update"} by ${event.author}: ${event.subject}`
|
|
185
|
+
: event.subject;
|
|
186
|
+
return `${event.date} ${commit} ${event.id} ${kind} ${formatChanges(event)} # ${suffix}`;
|
|
187
|
+
})
|
|
188
|
+
.join("\n");
|
|
189
|
+
}
|
|
190
|
+
export function assertHistoryDate(value, option) {
|
|
191
|
+
if (!DATE_RE.test(value)) {
|
|
192
|
+
throw new Error(`Invalid ${option} date: "${value}". Must be YYYY-MM-DD`);
|
|
193
|
+
}
|
|
194
|
+
}
|
|
195
|
+
function buildLogArgs(query) {
|
|
196
|
+
const args = [
|
|
197
|
+
"log",
|
|
198
|
+
"--reverse",
|
|
199
|
+
"--no-merges",
|
|
200
|
+
"--date=iso-strict",
|
|
201
|
+
`--pretty=${LOG_PRETTY_FORMAT}`,
|
|
202
|
+
"--name-status",
|
|
203
|
+
"--find-renames",
|
|
204
|
+
];
|
|
205
|
+
if (query.since) {
|
|
206
|
+
assertHistoryDate(query.since, "--since");
|
|
207
|
+
args.push(`--since=${query.since} 00:00:00`);
|
|
208
|
+
}
|
|
209
|
+
if (query.until) {
|
|
210
|
+
assertHistoryDate(query.until, "--until");
|
|
211
|
+
args.push(`--until=${query.until} 23:59:59`);
|
|
212
|
+
}
|
|
213
|
+
if (query.limit !== undefined) {
|
|
214
|
+
if (!Number.isInteger(query.limit) || query.limit <= 0) {
|
|
215
|
+
throw new Error(`Invalid --limit: "${query.limit}". Must be a positive integer`);
|
|
216
|
+
}
|
|
217
|
+
args.push(`--max-count=${query.limit}`);
|
|
218
|
+
}
|
|
219
|
+
args.push("--", query.registerPathspec);
|
|
220
|
+
return args;
|
|
221
|
+
}
|
|
222
|
+
function storedEventToHistory(id, file, event, sequence, options) {
|
|
223
|
+
const kind = event.action === "add" ? "added" : "updated";
|
|
224
|
+
let changes = event.changes.map((change) => ({ ...change }));
|
|
225
|
+
if (options.statusOnly) {
|
|
226
|
+
if (kind === "updated" && !changes.some((change) => change.field === "status")) {
|
|
227
|
+
return undefined;
|
|
228
|
+
}
|
|
229
|
+
changes = changes.filter((change) => STATUS_ONLY_FIELDS.has(change.field));
|
|
230
|
+
}
|
|
231
|
+
return {
|
|
232
|
+
id,
|
|
233
|
+
commit: `evt:${event.id}`,
|
|
234
|
+
date: event.ts,
|
|
235
|
+
author: event.actor,
|
|
236
|
+
subject: event.reason,
|
|
237
|
+
kind,
|
|
238
|
+
file,
|
|
239
|
+
changes,
|
|
240
|
+
source: "event",
|
|
241
|
+
action: event.action,
|
|
242
|
+
event_id: event.id,
|
|
243
|
+
sequence,
|
|
244
|
+
};
|
|
245
|
+
}
|
|
246
|
+
function collectStoredRegisterHistoryEvents(query) {
|
|
247
|
+
const registerDir = join(query.repoRoot, query.registerPathspec);
|
|
248
|
+
if (!existsSync(registerDir))
|
|
249
|
+
return { events: [], firstEventById: new Map() };
|
|
250
|
+
const idFilter = query.ids && query.ids.length > 0 ? new Set(query.ids) : undefined;
|
|
251
|
+
const events = [];
|
|
252
|
+
const firstEventById = new Map();
|
|
253
|
+
const eventsDir = join(registerDir, REGISTER_EVENTS_DIRNAME);
|
|
254
|
+
if (!existsSync(eventsDir))
|
|
255
|
+
return { events: [], firstEventById: new Map() };
|
|
256
|
+
const entries = readdirSync(eventsDir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name));
|
|
257
|
+
for (const entry of entries) {
|
|
258
|
+
if (!entry.isFile())
|
|
259
|
+
continue;
|
|
260
|
+
const id = displayIdFromRegisterEventFilename(entry.name);
|
|
261
|
+
if (!id || (idFilter && !idFilter.has(id)))
|
|
262
|
+
continue;
|
|
263
|
+
const content = readFileSync(join(eventsDir, entry.name), "utf8");
|
|
264
|
+
const stored = readRegisterEventsFromContent(content, entry.name);
|
|
265
|
+
if (stored.length === 0)
|
|
266
|
+
continue;
|
|
267
|
+
firstEventById.set(id, stored[0].ts);
|
|
268
|
+
for (const [sequence, event] of stored.entries()) {
|
|
269
|
+
const date = event.ts.slice(0, 10);
|
|
270
|
+
if (query.since && date < query.since)
|
|
271
|
+
continue;
|
|
272
|
+
if (query.until && date > query.until)
|
|
273
|
+
continue;
|
|
274
|
+
const history = storedEventToHistory(id, `${query.registerPathspec}/${REGISTER_EVENTS_DIRNAME}/${entry.name}`, event, sequence, { statusOnly: query.statusOnly });
|
|
275
|
+
if (history)
|
|
276
|
+
events.push(history);
|
|
277
|
+
}
|
|
278
|
+
}
|
|
279
|
+
return { events, firstEventById };
|
|
280
|
+
}
|
|
281
|
+
// 指定リビジョン時点のファイル内容を返す。そのリビジョンに存在しない場合は undefined。
|
|
282
|
+
function readFileAtRevision(repoRoot, revision, path) {
|
|
283
|
+
const result = gitResult(repoRoot, ["show", `${revision}:${path}`]);
|
|
284
|
+
if (result.status !== 0)
|
|
285
|
+
return undefined;
|
|
286
|
+
return typeof result.stdout === "string" ? result.stdout : undefined;
|
|
287
|
+
}
|
|
288
|
+
// git 履歴から登録項目の変更イベントを古い順に集める。
|
|
289
|
+
export function collectRegisterHistoryEvents(query) {
|
|
290
|
+
if (query.since)
|
|
291
|
+
assertHistoryDate(query.since, "--since");
|
|
292
|
+
if (query.until)
|
|
293
|
+
assertHistoryDate(query.until, "--until");
|
|
294
|
+
const stored = collectStoredRegisterHistoryEvents(query);
|
|
295
|
+
let gitEvents = [];
|
|
296
|
+
try {
|
|
297
|
+
const output = gitOutput(query.repoRoot, buildLogArgs(query));
|
|
298
|
+
const commits = parseRegisterLogOutput(output).map((commit) => ({
|
|
299
|
+
...commit,
|
|
300
|
+
date: commit.date.includes("T")
|
|
301
|
+
? new Date(commit.date).toISOString().replace(/\.000Z$/, "Z")
|
|
302
|
+
: commit.date,
|
|
303
|
+
}));
|
|
304
|
+
gitEvents = buildRegisterHistoryEvents(commits, (revision, path) => readFileAtRevision(query.repoRoot, revision, path), { ids: query.ids, statusOnly: query.statusOnly, timeZone: query.timeZone }).filter((event) => {
|
|
305
|
+
const cutoff = stored.firstEventById.get(event.id);
|
|
306
|
+
return cutoff === undefined || event.date < cutoff;
|
|
307
|
+
});
|
|
308
|
+
}
|
|
309
|
+
catch (error) {
|
|
310
|
+
if (stored.events.length === 0)
|
|
311
|
+
throw error;
|
|
312
|
+
}
|
|
313
|
+
return [...gitEvents, ...stored.events].sort((a, b) => {
|
|
314
|
+
if (a.date !== b.date)
|
|
315
|
+
return a.date < b.date ? -1 : 1;
|
|
316
|
+
if (a.id !== b.id)
|
|
317
|
+
return a.id < b.id ? -1 : 1;
|
|
318
|
+
if (a.source === "event" && b.source === "event") {
|
|
319
|
+
return (a.sequence ?? 0) - (b.sequence ?? 0);
|
|
320
|
+
}
|
|
321
|
+
return a.commit < b.commit ? -1 : a.commit > b.commit ? 1 : 0;
|
|
322
|
+
});
|
|
323
|
+
}
|