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-project.js
CHANGED
|
@@ -1,8 +1,7 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import {
|
|
1
|
+
import { join, resolve } from "node:path";
|
|
2
|
+
import { getProjectCatalogPath, getProjectContext, getProjectExecutionPath, getProjectRolesPath, getProjectSchedulePath, getProjectViewpointsPath, loadConfig, loadEnv, specdojoRootDir, } from "./specdojo-config.js";
|
|
3
3
|
function projectBaseDir() {
|
|
4
|
-
|
|
5
|
-
return dirname(configPath || defaultConfigPath());
|
|
4
|
+
return specdojoRootDir();
|
|
6
5
|
}
|
|
7
6
|
function resolveProjectRelative(baseDir, pathValue) {
|
|
8
7
|
return resolve(baseDir, pathValue.trim());
|
|
@@ -36,15 +35,15 @@ export function executionRootForProject(projectPath) {
|
|
|
36
35
|
`Provide --project <id>, or SPECDOJO_PROJECT, or SPECDOJO_SCHEDULE_PATH together with SPECDOJO_EXECUTION_PATH.`);
|
|
37
36
|
}
|
|
38
37
|
export function generatedDirForProject(projectPath) {
|
|
39
|
-
return join(executionRootForProject(projectPath),
|
|
38
|
+
return join(executionRootForProject(projectPath), "generated");
|
|
40
39
|
}
|
|
41
40
|
export function eventsDirForProject(projectPath) {
|
|
42
|
-
return join(executionRootForProject(projectPath),
|
|
41
|
+
return join(executionRootForProject(projectPath), "exec", "events");
|
|
43
42
|
}
|
|
44
43
|
export function resolveProjectPaths(opts) {
|
|
45
44
|
loadEnv();
|
|
46
45
|
const { config, configPath } = loadConfig();
|
|
47
|
-
const baseDir =
|
|
46
|
+
const baseDir = specdojoRootDir();
|
|
48
47
|
const envSchedulePath = process.env.SPECDOJO_SCHEDULE_PATH;
|
|
49
48
|
const envExecutionPath = process.env.SPECDOJO_EXECUTION_PATH;
|
|
50
49
|
const envProject = process.env.SPECDOJO_PROJECT;
|
|
@@ -57,13 +56,21 @@ export function resolveProjectPaths(opts) {
|
|
|
57
56
|
if (!project) {
|
|
58
57
|
throw new Error(`Unknown ${source} value: ${projectId} (check ${configPath})`);
|
|
59
58
|
}
|
|
59
|
+
const catalogPath = getProjectCatalogPath(project);
|
|
60
|
+
const rolesPath = getProjectRolesPath(project);
|
|
61
|
+
const viewpointsPath = getProjectViewpointsPath(project);
|
|
60
62
|
return {
|
|
63
|
+
projectId,
|
|
61
64
|
schedulePath: resolveProjectRelative(baseDir, getProjectSchedulePath(project)),
|
|
62
65
|
executionPath: resolveProjectRelative(baseDir, getProjectExecutionPath(project)),
|
|
66
|
+
catalogPath: catalogPath ? resolveProjectRelative(baseDir, catalogPath) : undefined,
|
|
67
|
+
rolesPath: rolesPath ? resolveProjectRelative(baseDir, rolesPath) : undefined,
|
|
68
|
+
viewpointsPath: viewpointsPath ? resolveProjectRelative(baseDir, viewpointsPath) : undefined,
|
|
69
|
+
projectContext: getProjectContext(project),
|
|
63
70
|
};
|
|
64
71
|
}
|
|
65
72
|
if (opts.project && opts.project.trim()) {
|
|
66
|
-
return fromProjectId(opts.project.trim(),
|
|
73
|
+
return fromProjectId(opts.project.trim(), "--project");
|
|
67
74
|
}
|
|
68
75
|
if ((envSchedulePath && envSchedulePath.trim()) ||
|
|
69
76
|
(envExecutionPath && envExecutionPath.trim())) {
|
|
@@ -79,9 +86,16 @@ export function resolveProjectPaths(opts) {
|
|
|
79
86
|
};
|
|
80
87
|
}
|
|
81
88
|
if (envProject && envProject.trim()) {
|
|
82
|
-
return fromProjectId(envProject.trim(),
|
|
89
|
+
return fromProjectId(envProject.trim(), "SPECDOJO_PROJECT");
|
|
90
|
+
}
|
|
91
|
+
if (config?.current_project && config.current_project.trim()) {
|
|
92
|
+
return fromProjectId(config.current_project.trim(), "current_project");
|
|
93
|
+
}
|
|
94
|
+
const defaultProjectId = config ? Object.keys(config.projects)[0] : "";
|
|
95
|
+
if (defaultProjectId) {
|
|
96
|
+
return fromProjectId(defaultProjectId, "current_project");
|
|
83
97
|
}
|
|
84
98
|
throw new Error(`Project path not specified.\n` +
|
|
85
|
-
`Provide --project <id>,
|
|
86
|
-
`
|
|
99
|
+
`Provide --project <id>, set current_project in specdojo.config.json, or set SPECDOJO_PROJECT.\n` +
|
|
100
|
+
`The value must match a project id in ${configPath}.`);
|
|
87
101
|
}
|
|
@@ -0,0 +1,169 @@
|
|
|
1
|
+
import { existsSync, readFileSync, writeFileSync } from "node:fs";
|
|
2
|
+
import { stripTerminalControlSequences } from "./exec-shared.js";
|
|
3
|
+
import { describeAgentProtectedConfigChanges } from "./exec-agent-protected-config.js";
|
|
4
|
+
import { describeAgentGitStateChanges, } from "./exec-agent-git-state.js";
|
|
5
|
+
// PJR-VH6R: 保護機構が agent の変更を止めたとき、規約は「対象・変更理由・提案差分・
|
|
6
|
+
// 変更後に必要な検証」を result の申し送りへ書くことを求めている。しかし block は agent の
|
|
7
|
+
// 記入を待たずに成立するため、実際には _TODO_ のまま残り、orchestrator が worktree の
|
|
8
|
+
// `git diff` を読み直す必要があった。ここでは機構が自動で取得できる情報(対象と提案差分)を
|
|
9
|
+
// result へ記録し、agent 由来の情報(理由・必要な検証)は未記入であることを明示する。
|
|
10
|
+
export const PROTECTION_HANDOFF_MARKER = "<!-- specdojo:agent-protection-handoff -->";
|
|
11
|
+
const PROTECTION_HANDOFF_HEADING_TITLE = "保護機構による block の申し送り";
|
|
12
|
+
// 見出し行の末尾は `[ \t]*` で止め、改行を巻き込まないようにする(節の開始位置がずれるため)。
|
|
13
|
+
const HANDOFF_SECTION_HEADING = /^## +\d+\. +申し送り[ \t]*$/m;
|
|
14
|
+
const PROTECTION_SECTION_HEADING = new RegExp(`^## +\\d+\\. +${PROTECTION_HANDOFF_HEADING_TITLE}[ \t]*$`, "m");
|
|
15
|
+
const EVIDENCE_MAX_LINES = 200;
|
|
16
|
+
const EVIDENCE_MAX_CHARS = 8000;
|
|
17
|
+
function inlineText(value) {
|
|
18
|
+
return stripTerminalControlSequences(value)
|
|
19
|
+
.replace(/[\r\n]+/g, " ")
|
|
20
|
+
.replace(/`/g, "'")
|
|
21
|
+
.trim();
|
|
22
|
+
}
|
|
23
|
+
export function truncateProtectionEvidence(text) {
|
|
24
|
+
const normalized = stripTerminalControlSequences(text).replace(/\r\n/g, "\n").trimEnd();
|
|
25
|
+
if (normalized === "")
|
|
26
|
+
return "";
|
|
27
|
+
const lines = normalized.split("\n");
|
|
28
|
+
const limited = lines.length > EVIDENCE_MAX_LINES
|
|
29
|
+
? [
|
|
30
|
+
...lines.slice(0, EVIDENCE_MAX_LINES),
|
|
31
|
+
`... (${lines.length - EVIDENCE_MAX_LINES} 行を省略)`,
|
|
32
|
+
]
|
|
33
|
+
: lines;
|
|
34
|
+
const joined = limited.join("\n");
|
|
35
|
+
if (joined.length <= EVIDENCE_MAX_CHARS)
|
|
36
|
+
return joined;
|
|
37
|
+
return `${joined.slice(0, EVIDENCE_MAX_CHARS)}\n... (文字数上限で切り詰め)`;
|
|
38
|
+
}
|
|
39
|
+
// 差分がコードフェンスを含んでも result の構造を壊さないよう、内容より長いフェンスを使う。
|
|
40
|
+
function fenceFor(text) {
|
|
41
|
+
const runs = [...text.matchAll(/^\s*(`{3,})/gm)].map((match) => match[1].length);
|
|
42
|
+
return "`".repeat(Math.max(3, ...runs, 0) + (runs.length > 0 ? 1 : 0));
|
|
43
|
+
}
|
|
44
|
+
export function renderProtectionHandoff(handoff, agentRecorded) {
|
|
45
|
+
const subjects = handoff.subjects.length === 0
|
|
46
|
+
? "なし"
|
|
47
|
+
: handoff.subjects.map((subject) => `\`${inlineText(subject)}\``).join(", ");
|
|
48
|
+
const evidence = truncateProtectionEvidence(handoff.evidence);
|
|
49
|
+
const fence = fenceFor(evidence);
|
|
50
|
+
const agentNote = agentRecorded
|
|
51
|
+
? "この節の上に agent が記入した申し送りを参照する。"
|
|
52
|
+
: "agent の記入なし。";
|
|
53
|
+
const lines = [
|
|
54
|
+
PROTECTION_HANDOFF_MARKER,
|
|
55
|
+
"",
|
|
56
|
+
`**保護機構による自動記録**: \`${handoff.mechanism}\` が agent の変更を止めた。適用するかどうかは人または対話型 orchestrator が agent 実行外で判断する。`,
|
|
57
|
+
"",
|
|
58
|
+
`- ${handoff.subjectLabel}: ${subjects}`,
|
|
59
|
+
`- 変更理由: ${agentNote}${agentRecorded ? "" : "自動記録では意図までは復元できないため、下の差分と block メッセージから判断する。"}`,
|
|
60
|
+
`- 変更後に必要な検証: ${agentNote}${agentRecorded ? "" : "適用者が対象設定に対応する test / hook / CI 検証を判断する。"}`,
|
|
61
|
+
`- block メッセージ: \`${inlineText(handoff.reason)}\``,
|
|
62
|
+
"",
|
|
63
|
+
];
|
|
64
|
+
if (evidence === "") {
|
|
65
|
+
lines.push(`${handoff.evidenceLabel}: 取得できなかった(対象は上記のとおり)。`);
|
|
66
|
+
return lines.join("\n");
|
|
67
|
+
}
|
|
68
|
+
lines.push(`${handoff.evidenceLabel}:`, "", `${fence}${handoff.evidenceLanguage}`, evidence, fence);
|
|
69
|
+
return lines.join("\n");
|
|
70
|
+
}
|
|
71
|
+
function normalizeDocument(content) {
|
|
72
|
+
return `${content
|
|
73
|
+
.replace(/\r\n/g, "\n")
|
|
74
|
+
.replace(/\n{3,}/g, "\n\n")
|
|
75
|
+
.replace(/\n+$/, "")}\n`;
|
|
76
|
+
}
|
|
77
|
+
// 申し送り節のうち、agent が書いた部分だけを取り出す。テンプレートのプレースホルダのままなら
|
|
78
|
+
// 未記入として扱い、過去の自動記録(マーカー以降)は毎回置き換える。
|
|
79
|
+
function agentHandoffText(section) {
|
|
80
|
+
const markerIndex = section.indexOf(PROTECTION_HANDOFF_MARKER);
|
|
81
|
+
const text = (markerIndex === -1 ? section : section.slice(0, markerIndex)).trim();
|
|
82
|
+
if (text === "" || text.includes("_TODO_"))
|
|
83
|
+
return "";
|
|
84
|
+
return text;
|
|
85
|
+
}
|
|
86
|
+
function sectionRange(content, heading) {
|
|
87
|
+
const start = heading.index + heading[0].length;
|
|
88
|
+
const rest = content.slice(start);
|
|
89
|
+
const next = /^##\s+/m.exec(rest);
|
|
90
|
+
return { start, end: next ? start + next.index : content.length };
|
|
91
|
+
}
|
|
92
|
+
function nextSectionNumber(content) {
|
|
93
|
+
const numbers = [...content.matchAll(/^##\s+(\d+)\./gm)].map((match) => Number(match[1]));
|
|
94
|
+
return numbers.length === 0 ? 1 : Math.max(...numbers) + 1;
|
|
95
|
+
}
|
|
96
|
+
/**
|
|
97
|
+
* result 本文へ保護機構の申し送りを反映する。申し送り節(edit result)があればその節へ、
|
|
98
|
+
* 無ければ専用節を追加する。同じ result へ複数回記録された場合は、直前の自動記録を置き換える。
|
|
99
|
+
*/
|
|
100
|
+
export function applyProtectionHandoff(content, handoff) {
|
|
101
|
+
const normalized = content.replace(/\r\n/g, "\n");
|
|
102
|
+
const handoffHeading = HANDOFF_SECTION_HEADING.exec(normalized);
|
|
103
|
+
if (handoffHeading) {
|
|
104
|
+
const { start, end } = sectionRange(normalized, handoffHeading);
|
|
105
|
+
const agentText = agentHandoffText(normalized.slice(start, end));
|
|
106
|
+
const body = [agentText, renderProtectionHandoff(handoff, agentText !== "")]
|
|
107
|
+
.filter((part) => part !== "")
|
|
108
|
+
.join("\n\n");
|
|
109
|
+
return normalizeDocument(`${normalized.slice(0, start)}\n\n${body}\n\n${normalized.slice(end)}`);
|
|
110
|
+
}
|
|
111
|
+
const protectionHeading = PROTECTION_SECTION_HEADING.exec(normalized);
|
|
112
|
+
if (protectionHeading) {
|
|
113
|
+
const { start, end } = sectionRange(normalized, protectionHeading);
|
|
114
|
+
return normalizeDocument(`${normalized.slice(0, start)}\n\n${renderProtectionHandoff(handoff, false)}\n\n${normalized.slice(end)}`);
|
|
115
|
+
}
|
|
116
|
+
const heading = `## ${nextSectionNumber(normalized)}. ${PROTECTION_HANDOFF_HEADING_TITLE}`;
|
|
117
|
+
return normalizeDocument(`${normalized}\n\n${heading}\n\n${renderProtectionHandoff(handoff, false)}`);
|
|
118
|
+
}
|
|
119
|
+
/**
|
|
120
|
+
* result ファイルへ申し送りを書き込む。result が無い run(--deliverable の一部など)や
|
|
121
|
+
* 書き込みに失敗した場合は false を返し、block 自体は呼び出し側の経路をそのまま通す。
|
|
122
|
+
*/
|
|
123
|
+
export function recordProtectionHandoff(resultPath, handoff) {
|
|
124
|
+
if (!resultPath || !existsSync(resultPath))
|
|
125
|
+
return false;
|
|
126
|
+
try {
|
|
127
|
+
const content = readFileSync(resultPath, "utf8");
|
|
128
|
+
const updated = applyProtectionHandoff(content, handoff);
|
|
129
|
+
if (updated === content)
|
|
130
|
+
return false;
|
|
131
|
+
writeFileSync(resultPath, updated, "utf8");
|
|
132
|
+
return true;
|
|
133
|
+
}
|
|
134
|
+
catch {
|
|
135
|
+
// 申し送りを書けないこと自体で block 経路を壊さない。block と終了コードは呼び出し側が担う。
|
|
136
|
+
return false;
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
// 差分の収集に失敗しても block 経路を止めない。対象と block メッセージだけでも記録する。
|
|
140
|
+
function collectEvidence(collect) {
|
|
141
|
+
try {
|
|
142
|
+
return collect();
|
|
143
|
+
}
|
|
144
|
+
catch {
|
|
145
|
+
return "";
|
|
146
|
+
}
|
|
147
|
+
}
|
|
148
|
+
export function recordProtectedConfigBlock(params) {
|
|
149
|
+
return recordProtectionHandoff(params.resultPath, {
|
|
150
|
+
mechanism: "agent-config-write",
|
|
151
|
+
subjectLabel: "対象パス",
|
|
152
|
+
subjects: params.paths,
|
|
153
|
+
reason: params.reason,
|
|
154
|
+
evidenceLabel: "提案差分",
|
|
155
|
+
evidenceLanguage: "diff",
|
|
156
|
+
evidence: collectEvidence(() => describeAgentProtectedConfigChanges(params.repoRoot, params.paths)),
|
|
157
|
+
});
|
|
158
|
+
}
|
|
159
|
+
export function recordGitStateBlock(params) {
|
|
160
|
+
return recordProtectionHandoff(params.resultPath, {
|
|
161
|
+
mechanism: "agent-git-state-write",
|
|
162
|
+
subjectLabel: "対象フィールド",
|
|
163
|
+
subjects: params.fields,
|
|
164
|
+
reason: params.reason,
|
|
165
|
+
evidenceLabel: "検知した変更",
|
|
166
|
+
evidenceLanguage: "text",
|
|
167
|
+
evidence: collectEvidence(() => describeAgentGitStateChanges(params.repoRoot, params.before, params.fields)),
|
|
168
|
+
});
|
|
169
|
+
}
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
import { existsSync } from "node:fs";
|
|
2
|
+
import { copyFile, mkdir, readdir } from "node:fs/promises";
|
|
3
|
+
import path from "node:path";
|
|
4
|
+
export { specdojoPackageRootDir } from "./package-paths.js";
|
|
5
|
+
export async function listProviderTemplates(packageRoot) {
|
|
6
|
+
const templatesDir = path.join(packageRoot, "templates");
|
|
7
|
+
if (!existsSync(templatesDir))
|
|
8
|
+
return [];
|
|
9
|
+
const entries = await readdir(templatesDir, { withFileTypes: true });
|
|
10
|
+
return entries
|
|
11
|
+
.filter((entry) => entry.isDirectory())
|
|
12
|
+
.map((entry) => entry.name)
|
|
13
|
+
.sort();
|
|
14
|
+
}
|
|
15
|
+
async function collectFilesRecursively(rootDir, relDir = "") {
|
|
16
|
+
const entries = await readdir(path.join(rootDir, relDir), { withFileTypes: true });
|
|
17
|
+
const files = [];
|
|
18
|
+
for (const entry of entries) {
|
|
19
|
+
const relPath = relDir ? path.join(relDir, entry.name) : entry.name;
|
|
20
|
+
if (entry.isDirectory()) {
|
|
21
|
+
files.push(...(await collectFilesRecursively(rootDir, relPath)));
|
|
22
|
+
}
|
|
23
|
+
else if (entry.isFile()) {
|
|
24
|
+
files.push(relPath);
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
return files;
|
|
28
|
+
}
|
|
29
|
+
function toPosix(relPath) {
|
|
30
|
+
return relPath.split(path.sep).join("/");
|
|
31
|
+
}
|
|
32
|
+
export async function buildProviderScaffoldPlan(opts) {
|
|
33
|
+
const { packageRoot, repoRoot, provider } = opts;
|
|
34
|
+
const templateDir = path.join(packageRoot, "templates", provider);
|
|
35
|
+
if (!existsSync(templateDir)) {
|
|
36
|
+
const available = await listProviderTemplates(packageRoot);
|
|
37
|
+
const availableLabel = available.length > 0 ? available.join(", ") : "(none)";
|
|
38
|
+
throw new Error(`Unknown provider template: ${provider}. Available: ${availableLabel} (looked in ${path.join(packageRoot, "templates")})`);
|
|
39
|
+
}
|
|
40
|
+
const relFiles = (await collectFilesRecursively(templateDir)).map(toPosix).sort();
|
|
41
|
+
const entries = [];
|
|
42
|
+
for (const relFile of relFiles) {
|
|
43
|
+
// 配布原本の説明書は利用リポジトリへコピーしない。
|
|
44
|
+
if (relFile === "README.md")
|
|
45
|
+
continue;
|
|
46
|
+
const destinationRelPath = relFile.startsWith("agents/")
|
|
47
|
+
? `.${provider}/${relFile}`
|
|
48
|
+
: `.specdojo/${provider}/${relFile}`;
|
|
49
|
+
entries.push({
|
|
50
|
+
sourcePath: path.join(templateDir, ...relFile.split("/")),
|
|
51
|
+
destinationPath: path.join(repoRoot, ...destinationRelPath.split("/")),
|
|
52
|
+
destinationRelPath,
|
|
53
|
+
});
|
|
54
|
+
}
|
|
55
|
+
return { provider, entries };
|
|
56
|
+
}
|
|
57
|
+
export async function applyProviderScaffoldPlan(plan, opts) {
|
|
58
|
+
const outcomes = [];
|
|
59
|
+
for (const entry of plan.entries) {
|
|
60
|
+
if (existsSync(entry.destinationPath) && !opts.force) {
|
|
61
|
+
outcomes.push({ entry, written: false });
|
|
62
|
+
continue;
|
|
63
|
+
}
|
|
64
|
+
await mkdir(path.dirname(entry.destinationPath), { recursive: true });
|
|
65
|
+
await copyFile(entry.sourcePath, entry.destinationPath);
|
|
66
|
+
outcomes.push({ entry, written: true });
|
|
67
|
+
}
|
|
68
|
+
return outcomes;
|
|
69
|
+
}
|
|
70
|
+
/**
|
|
71
|
+
* config scaffold と従来の exec scaffold で共有する provider 設定の配置処理。
|
|
72
|
+
* package root と利用リポジトリ root は呼び出し側で解決し、このモジュールはコピーと
|
|
73
|
+
* 利用者向け出力だけを担う。
|
|
74
|
+
*/
|
|
75
|
+
export async function runProviderScaffold(provider, opts) {
|
|
76
|
+
const plan = await buildProviderScaffoldPlan({
|
|
77
|
+
packageRoot: opts.packageRoot,
|
|
78
|
+
repoRoot: opts.repoRoot,
|
|
79
|
+
provider,
|
|
80
|
+
});
|
|
81
|
+
if (opts.dryRun) {
|
|
82
|
+
for (const entry of plan.entries) {
|
|
83
|
+
process.stdout.write(`[dry-run] would write: ${entry.destinationRelPath}\n`);
|
|
84
|
+
}
|
|
85
|
+
return;
|
|
86
|
+
}
|
|
87
|
+
const outcomes = await applyProviderScaffoldPlan(plan, { force: opts.force });
|
|
88
|
+
for (const { entry, written } of outcomes) {
|
|
89
|
+
if (written) {
|
|
90
|
+
process.stdout.write(`Written: ${entry.destinationRelPath}\n`);
|
|
91
|
+
}
|
|
92
|
+
else {
|
|
93
|
+
process.stdout.write(`Skipped (already exists): ${entry.destinationRelPath}\n`);
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
process.stdout.write("Next steps:\n" +
|
|
97
|
+
" 1. Commit the scaffolded files (worktree runs read committed content).\n" +
|
|
98
|
+
` 2. Define providers.${provider}.command_template in .specdojo/exec-defaults.yaml (see templates/${provider}/README.md).\n`);
|
|
99
|
+
}
|
|
@@ -0,0 +1,196 @@
|
|
|
1
|
+
import { existsSync, readdirSync } from "node:fs";
|
|
2
|
+
import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
|
|
3
|
+
import { loadPipelineResumeCheckpoint } from "./exec-pipeline-state.js";
|
|
4
|
+
import { safeSlug } from "./exec-shared.js";
|
|
5
|
+
export function registerEvidenceDir(input) {
|
|
6
|
+
const executionRel = relative(input.repoRoot, input.executionPath);
|
|
7
|
+
return join(input.worktreePath, executionRel, "exec", "evidence", safeSlug(input.taskId));
|
|
8
|
+
}
|
|
9
|
+
// worktree に残っている run ディレクトリを読み、pipeline-state.json を持つものを候補にする。
|
|
10
|
+
// 壊れた state・別 task の state は loadPipelineResumeCheckpoint が弾くため、ここでは黙って
|
|
11
|
+
// 候補から外す(再開可否の判定は selectResumableRegisterRun が理由つきで行う)。
|
|
12
|
+
export function loadRegisterResumeCandidates(input) {
|
|
13
|
+
const evidenceDir = registerEvidenceDir(input);
|
|
14
|
+
if (!existsSync(evidenceDir))
|
|
15
|
+
return [];
|
|
16
|
+
const runIds = readdirSync(evidenceDir, { withFileTypes: true })
|
|
17
|
+
.filter((entry) => entry.isDirectory())
|
|
18
|
+
.map((entry) => entry.name)
|
|
19
|
+
.sort();
|
|
20
|
+
const candidates = [];
|
|
21
|
+
for (const runId of runIds) {
|
|
22
|
+
const statePath = join(evidenceDir, runId, "pipeline-state.json");
|
|
23
|
+
if (!existsSync(statePath))
|
|
24
|
+
continue;
|
|
25
|
+
const stateRef = relative(input.worktreePath, statePath).split(sep).join("/");
|
|
26
|
+
const checkpoint = loadPipelineResumeCheckpoint({
|
|
27
|
+
worktreePath: input.worktreePath,
|
|
28
|
+
stateRef,
|
|
29
|
+
taskId: input.taskId,
|
|
30
|
+
});
|
|
31
|
+
if (!checkpoint)
|
|
32
|
+
continue;
|
|
33
|
+
candidates.push({
|
|
34
|
+
runId,
|
|
35
|
+
stateRef,
|
|
36
|
+
statePath: checkpoint.statePath,
|
|
37
|
+
state: checkpoint.state,
|
|
38
|
+
...(checkpoint.evidence ? { evidence: checkpoint.evidence } : {}),
|
|
39
|
+
...(checkpoint.evidence
|
|
40
|
+
? {
|
|
41
|
+
evidenceRef: checkpoint.state.stages.executor.artifact_ref ??
|
|
42
|
+
relative(input.worktreePath, join(dirname(statePath), "evidence.json"))
|
|
43
|
+
.split(sep)
|
|
44
|
+
.join("/"),
|
|
45
|
+
}
|
|
46
|
+
: {}),
|
|
47
|
+
});
|
|
48
|
+
}
|
|
49
|
+
return candidates;
|
|
50
|
+
}
|
|
51
|
+
// 再開対象は「最新の run」だけに限定する。より古い run へ遡ると、後続 run が作った
|
|
52
|
+
// 未コミット成果や result と食い違うため、最新 run が再開できない場合は理由を返して止める。
|
|
53
|
+
export function selectResumableRegisterRun(candidates) {
|
|
54
|
+
if (candidates.length === 0) {
|
|
55
|
+
return { kind: "not-resumable", reason: "no pipeline run state found in the worktree" };
|
|
56
|
+
}
|
|
57
|
+
const latest = [...candidates].sort((a, b) => {
|
|
58
|
+
if (a.state.updated_at !== b.state.updated_at) {
|
|
59
|
+
return a.state.updated_at < b.state.updated_at ? -1 : 1;
|
|
60
|
+
}
|
|
61
|
+
return a.runId < b.runId ? -1 : a.runId > b.runId ? 1 : 0;
|
|
62
|
+
})[candidates.length - 1];
|
|
63
|
+
// rate limit または保護機構の block で打ち切られた executor は、evidence が記録されていても
|
|
64
|
+
// 作業を完了していない。reporter へ進めず、申し送りを反映できるよう既存 worktree 上で
|
|
65
|
+
// executor を再開する。通常のプロセス失敗は failed のまま区別し、再開対象にしない。
|
|
66
|
+
if (latest.state.stages.executor.status === "rate_limited" ||
|
|
67
|
+
latest.state.stages.executor.status === "blocked") {
|
|
68
|
+
return {
|
|
69
|
+
kind: "resumable",
|
|
70
|
+
target: {
|
|
71
|
+
stage: "executor",
|
|
72
|
+
runId: latest.runId,
|
|
73
|
+
stateRef: latest.stateRef,
|
|
74
|
+
statePath: latest.statePath,
|
|
75
|
+
state: latest.state,
|
|
76
|
+
},
|
|
77
|
+
};
|
|
78
|
+
}
|
|
79
|
+
if (latest.state.stages.executor.status === "running") {
|
|
80
|
+
if (latest.evidence && latest.evidenceRef) {
|
|
81
|
+
const recoveredState = {
|
|
82
|
+
...latest.state,
|
|
83
|
+
updated_at: latest.evidence.stage.completed_at,
|
|
84
|
+
stages: {
|
|
85
|
+
...latest.state.stages,
|
|
86
|
+
executor: {
|
|
87
|
+
...latest.state.stages.executor,
|
|
88
|
+
status: "succeeded",
|
|
89
|
+
actor: latest.evidence.stage.actor,
|
|
90
|
+
attempts: latest.evidence.stage.attempts,
|
|
91
|
+
completed_at: latest.evidence.stage.completed_at,
|
|
92
|
+
artifact_ref: latest.evidenceRef,
|
|
93
|
+
},
|
|
94
|
+
},
|
|
95
|
+
};
|
|
96
|
+
return {
|
|
97
|
+
kind: "resumable",
|
|
98
|
+
target: {
|
|
99
|
+
stage: "reporter",
|
|
100
|
+
runId: latest.runId,
|
|
101
|
+
stateRef: latest.stateRef,
|
|
102
|
+
statePath: latest.statePath,
|
|
103
|
+
state: recoveredState,
|
|
104
|
+
evidence: latest.evidence,
|
|
105
|
+
evidenceRef: latest.evidenceRef,
|
|
106
|
+
},
|
|
107
|
+
};
|
|
108
|
+
}
|
|
109
|
+
return {
|
|
110
|
+
kind: "resumable",
|
|
111
|
+
target: {
|
|
112
|
+
stage: "executor",
|
|
113
|
+
runId: latest.runId,
|
|
114
|
+
stateRef: latest.stateRef,
|
|
115
|
+
statePath: latest.statePath,
|
|
116
|
+
state: latest.state,
|
|
117
|
+
},
|
|
118
|
+
};
|
|
119
|
+
}
|
|
120
|
+
if (latest.state.stages.executor.status !== "succeeded") {
|
|
121
|
+
return {
|
|
122
|
+
kind: "not-resumable",
|
|
123
|
+
reason: `executor stage is "${latest.state.stages.executor.status}" for run ${latest.runId}; re-run the item instead`,
|
|
124
|
+
};
|
|
125
|
+
}
|
|
126
|
+
const evidenceRef = latest.state.stages.executor.artifact_ref;
|
|
127
|
+
if (!latest.evidence || !evidenceRef) {
|
|
128
|
+
return {
|
|
129
|
+
kind: "not-resumable",
|
|
130
|
+
reason: `executor evidence is missing or invalid for run ${latest.runId}`,
|
|
131
|
+
};
|
|
132
|
+
}
|
|
133
|
+
return {
|
|
134
|
+
kind: "resumable",
|
|
135
|
+
target: {
|
|
136
|
+
// reporter が成功済みなら残っているのは統合だけ。executor / reporter は起動しない。
|
|
137
|
+
stage: latest.state.stages.reporter.status === "succeeded" ? "integrate" : "reporter",
|
|
138
|
+
runId: latest.runId,
|
|
139
|
+
stateRef: latest.stateRef,
|
|
140
|
+
statePath: latest.statePath,
|
|
141
|
+
state: latest.state,
|
|
142
|
+
evidence: latest.evidence,
|
|
143
|
+
evidenceRef,
|
|
144
|
+
},
|
|
145
|
+
};
|
|
146
|
+
}
|
|
147
|
+
export function findResumableRegisterRun(input) {
|
|
148
|
+
return selectResumableRegisterRun(loadRegisterResumeCandidates(input));
|
|
149
|
+
}
|
|
150
|
+
// plan / result のファイル名は `<pjr-id>-<UTC>-<rand>-(plan|result).md`(buildInPlaceStem)。
|
|
151
|
+
// state に artifacts が無い旧 run のために、worktree の result 一覧から最新の stem を復元する。
|
|
152
|
+
export function selectLatestRegisterResultStem(fileNames, pjrId) {
|
|
153
|
+
const pattern = new RegExp(`^(${pjrId.toLowerCase()}-\\d{8}T\\d{6}Z-[0-9a-f]+)-result\\.md$`, "i");
|
|
154
|
+
const stems = [];
|
|
155
|
+
for (const name of fileNames) {
|
|
156
|
+
const match = name.match(pattern);
|
|
157
|
+
if (match)
|
|
158
|
+
stems.push(match[1]);
|
|
159
|
+
}
|
|
160
|
+
if (stems.length === 0)
|
|
161
|
+
return null;
|
|
162
|
+
return stems.sort()[stems.length - 1];
|
|
163
|
+
}
|
|
164
|
+
// state はエージェントが書き込める worktree 内のファイルのため、参照が root の外へ出ないことを
|
|
165
|
+
// 確認してから使う(絶対パスや `..` を含む参照は受け付けない)。
|
|
166
|
+
function isContainedRef(root, ref) {
|
|
167
|
+
if (!ref)
|
|
168
|
+
return false;
|
|
169
|
+
const rel = relative(root, resolve(root, ref));
|
|
170
|
+
return rel !== "" && rel !== ".." && !rel.startsWith(`..${sep}`) && !isAbsolute(rel);
|
|
171
|
+
}
|
|
172
|
+
// reporter 段の入力(plan と result)を state から復元する。state に artifacts がある場合は
|
|
173
|
+
// それを正本とし、無い旧 run では worktree の result ファイル名から stem を復元する。
|
|
174
|
+
export function resolveRegisterResumeArtifacts(input) {
|
|
175
|
+
const executionRel = relative(input.repoRoot, input.executionPath).split(sep).join("/");
|
|
176
|
+
const artifacts = input.state.artifacts;
|
|
177
|
+
if (artifacts) {
|
|
178
|
+
if (!isContainedRef(input.repoRoot, artifacts.plan_ref) ||
|
|
179
|
+
!isContainedRef(input.worktreePath, artifacts.result_ref)) {
|
|
180
|
+
return null;
|
|
181
|
+
}
|
|
182
|
+
const stem = artifacts.result_ref.replace(/^.*\//, "").replace(/-result\.md$/, "");
|
|
183
|
+
return { planRef: artifacts.plan_ref, resultRef: artifacts.result_ref, stem };
|
|
184
|
+
}
|
|
185
|
+
const resultsDir = join(input.worktreePath, executionRel, "exec", "results");
|
|
186
|
+
if (!existsSync(resultsDir))
|
|
187
|
+
return null;
|
|
188
|
+
const stem = selectLatestRegisterResultStem(readdirSync(resultsDir), input.taskId);
|
|
189
|
+
if (!stem)
|
|
190
|
+
return null;
|
|
191
|
+
return {
|
|
192
|
+
planRef: `${executionRel}/exec/plans/${stem}-plan.md`,
|
|
193
|
+
resultRef: `${executionRel}/exec/results/${stem}-result.md`,
|
|
194
|
+
stem,
|
|
195
|
+
};
|
|
196
|
+
}
|