specdojo 0.4.6 → 0.5.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/.github/agents/specdojo-orchestrator.md +14 -9
- package/CHANGELOG.md +62 -0
- package/dist/catalog/document-target.js +75 -0
- package/dist/commands/agent.js +2 -80
- package/dist/commands/init.js +3 -0
- package/dist/commands/night-orchestrator.js +33 -4
- package/dist/dashboard/dashboard.js +5 -6
- package/dist/dashboard/timeline-build.js +5 -1
- package/dist/dashboard/timeline.js +6 -3
- package/dist/docs/yaml-pages.js +17 -17
- package/dist/exec/agent-config.js +28 -16
- package/dist/exec/agent-plan.js +108 -0
- package/dist/exec/commands.js +3 -3
- package/dist/exec/core.js +2 -0
- package/dist/exec/grade-checkpoint.js +12 -0
- package/dist/exec/pipeline-state.js +5 -2
- package/dist/exec/plans-core.js +7 -67
- package/dist/exec/plans-generation.js +28 -7
- package/dist/exec/plans-grade-findings.js +16 -0
- package/dist/exec/plans-planning.js +43 -0
- package/dist/exec/plans-storage.js +5 -2
- package/dist/exec/project.js +4 -1
- package/dist/exec/register.js +82 -6
- package/dist/exec/repo-integration-sync.js +9 -0
- package/dist/exec/repo-integration.js +17 -2
- package/dist/exec/repo-trace.js +17 -4
- package/dist/exec/results.js +2 -0
- package/dist/exec/run/lifecycle-commands.js +2 -0
- package/dist/exec/run/register-core.js +11 -0
- package/dist/exec/run/register-mode.js +19 -1
- package/dist/exec/run/register-resume.js +23 -0
- package/dist/exec/run/register-state.js +4 -1
- package/dist/exec/run/register-worktree.js +28 -1
- package/dist/exec/run/schedule-prepare.js +7 -1
- package/dist/exec/strategy.js +2 -0
- package/dist/exec/task-repos.js +18 -4
- package/dist/exec/worktree-command.js +8 -1
- package/dist/exec/worktree-ops-commit.js +7 -1
- package/dist/exec/worktree-ops-merge.js +40 -1
- package/dist/grade/apply.js +13 -7
- package/dist/grade/command-inspect.js +2 -1
- package/dist/grade/command-run.js +39 -0
- package/dist/grade/grade.js +3 -1
- package/dist/grade/markdown.js +11 -6
- package/dist/grade/pipeline-state.js +8 -6
- package/dist/grade/plan.js +14 -10
- package/dist/grade/run.js +307 -0
- package/dist/grade/target-discovery.js +1 -1
- package/dist/grade/targets.js +44 -22
- package/dist/register/approach.js +35 -0
- package/dist/register/catalog-status.js +49 -0
- package/dist/register/core.js +5 -0
- package/dist/register/create-commands.js +83 -5
- package/dist/register/deliverable-target.js +215 -0
- package/dist/register/dependency.js +123 -0
- package/dist/register/derivation.js +2 -2
- package/dist/register/epic.js +42 -0
- package/dist/register/event-merge.js +5 -2
- package/dist/register/events.js +8 -0
- package/dist/register/external-project.js +4 -0
- package/dist/register/item.js +18 -0
- package/dist/register/maintenance-commands.js +7 -1
- package/dist/register/planning.js +37 -0
- package/dist/register/register.js +5 -1
- package/dist/register/renumber.js +12 -4
- package/dist/register/views.js +55 -4
- package/dist/review/grade.js +19 -17
- package/dist/schedule/schedule.js +3 -1
- package/dist/schedule/strategy-generate-scope.js +5 -1
- package/dist/schedule/strategy-generate.js +1 -0
- package/dist/schedule/strategy-profiles.js +1 -1
- package/dist/shared/agent-plan.js +1 -0
- package/dist/shared/agent-types.js +3 -0
- package/dist/shared/grade-result.js +23 -5
- package/dist/shared/markdownlint-config.js +38 -0
- package/dist/shared/markdownlint-scaffold.js +2 -9
- package/dist/shared/provider-scaffold.js +5 -3
- package/dist/shared/specdojo-config.js +10 -3
- package/dist/shared/specdojo-gitignore.js +4 -0
- package/dist/specdojo.js +5 -1
- package/docs/ja/specdojo/exec-templates/xep-catalog-planning-template.md +24 -0
- package/docs/ja/specdojo/exec-templates/xep-strategy-planning-template.md +24 -0
- package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +2 -2
- package/docs/ja/specdojo/exec-templates/xrp-template.md +2 -2
- package/docs/ja/specdojo/guides/docs-editing-guide.md +14 -1
- package/docs/ja/specdojo/guides/docs-structure-guide.md +10 -8
- package/docs/ja/specdojo/guides/exec-config-guide.md +44 -12
- package/docs/ja/specdojo/guides/exec-operation-guide.md +20 -15
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +19 -1
- package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +3 -1
- package/docs/ja/specdojo/guides/practice-system-composition-guide.md +2 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +59 -16
- package/docs/ja/specdojo/guides/register-operation-guide.md +44 -15
- package/docs/ja/specdojo/guides/remote-host-development-guide.md +15 -1
- package/docs/ja/specdojo/guides/review-guide.md +2 -2
- package/docs/ja/specdojo/guides/ryu-guide.md +12 -0
- package/docs/ja/specdojo/guides/specdojo-overview-guide.md +16 -16
- package/docs/ja/specdojo/guides/timeline-design-guide.md +37 -33
- package/docs/ja/specdojo/recipes/tsd-recipe.md +198 -0
- package/docs/ja/specdojo/references/command-reference.md +92 -29
- package/docs/ja/specdojo/references/specdojo-config-reference.md +49 -16
- package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/atc-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +5 -4
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +3 -2
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +8 -7
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +3 -2
- package/docs/ja/specdojo/rulebooks/cld-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/cop-rulebook.md +3 -2
- package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cstd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/etc-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +9 -6
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +3 -1
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +2 -0
- package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +4 -2
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/itc-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +10 -9
- package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +10 -9
- package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/ntp-rulebook.md +7 -6
- package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/opd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/opr-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/otp-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +56 -36
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-overview-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/sac-rulebook.md +3 -2
- package/docs/ja/specdojo/rulebooks/sch-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +7 -6
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +4 -3
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/stc-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +9 -8
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +2 -1
- package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/tml-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +80 -61
- package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +111 -63
- package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +3 -2
- package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +1 -0
- package/docs/ja/specdojo/rulebooks/utc-rulebook.md +1 -0
- package/docs/ja/specdojo/samples/atc-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/atc-sample.md +1 -1
- package/docs/ja/specdojo/samples/bac-sample.md +1 -1
- package/docs/ja/specdojo/samples/bdd-sample.yaml +1 -1
- package/docs/ja/specdojo/samples/bds-sample.md +1 -1
- package/docs/ja/specdojo/samples/bes-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/bes-sample.md +1 -1
- package/docs/ja/specdojo/samples/ccd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cdfd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cdfd-uc-sample.md +1 -1
- package/docs/ja/specdojo/samples/cdsd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cld-sample.md +1 -1
- package/docs/ja/specdojo/samples/cnd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cop-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/cop-sample.md +1 -1
- package/docs/ja/specdojo/samples/cpd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cstd-sample.md +1 -1
- package/docs/ja/specdojo/samples/cxd-sample.md +1 -1
- package/docs/ja/specdojo/samples/dmd-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/dmd-sample.md +1 -1
- package/docs/ja/specdojo/samples/etc-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/etc-sample.md +1 -1
- package/docs/ja/specdojo/samples/gl-sample.yaml +2 -0
- package/docs/ja/specdojo/samples/ifd-sample.md +1 -1
- package/docs/ja/specdojo/samples/ifx-api-sample.yaml +1 -0
- package/docs/ja/specdojo/samples/ifx-cmd-sample.yaml +1 -1
- package/docs/ja/specdojo/samples/ifx-file-sample.md +1 -1
- package/docs/ja/specdojo/samples/ifx-index-sample.yaml +1 -0
- package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +2 -1
- package/docs/ja/specdojo/samples/itc-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/itc-sample.md +1 -1
- package/docs/ja/specdojo/samples/mtp-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-availability-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-integrity-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-maintainability-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-operations-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-performance-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-reliability-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-security-safety-sample.md +1 -1
- package/docs/ja/specdojo/samples/nfr-usability-sample.md +1 -1
- package/docs/ja/specdojo/samples/ntp-sample.md +1 -1
- package/docs/ja/specdojo/samples/opd-sample.md +1 -1
- package/docs/ja/specdojo/samples/opr-sample.md +1 -1
- package/docs/ja/specdojo/samples/otp-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/otp-sample.md +1 -1
- package/docs/ja/specdojo/samples/prj-stakeholder-register-sample.md +1 -1
- package/docs/ja/specdojo/samples/sac-sample.md +1 -1
- package/docs/ja/specdojo/samples/sf-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/sf-sample.md +1 -1
- package/docs/ja/specdojo/samples/sld-sample.md +1 -1
- package/docs/ja/specdojo/samples/stc-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/stc-sample.md +1 -1
- package/docs/ja/specdojo/samples/stsd-sample.md +1 -1
- package/docs/ja/specdojo/samples/sysd-critical-flows-sample.md +1 -1
- package/docs/ja/specdojo/samples/sysd-cross-cutting-policy-sample.md +1 -1
- package/docs/ja/specdojo/samples/sysd-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/tsd-index-sample.md +22 -16
- package/docs/ja/specdojo/samples/tsd-sample.md +241 -21
- package/docs/ja/specdojo/samples/tsp-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/uis-sample.md +1 -1
- package/docs/ja/specdojo/samples/utc-index-sample.md +1 -1
- package/docs/ja/specdojo/samples/utc-sample.md +1 -1
- package/docs/ja/specdojo/standards/document-metadata-standard.md +28 -3
- package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +2 -0
- package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +16 -11
- package/docs/ja/specdojo/standards/sample-authoring-standard.md +1 -0
- package/docs/ja/specdojo/templates/ifx-cmd-template.yaml +1 -1
- package/docs/ja/specdojo/templates/pjr-dependent-items-template.md +22 -0
- package/docs/ja/specdojo/templates/pjr-epic-items-template.md +22 -0
- package/docs/ja/specdojo/templates/pjr-epic-template.md +44 -0
- package/docs/ja/specdojo/templates/pjr-index-template.md +4 -2
- package/docs/specdojo/schemas/v1/bdd.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/deliverable-frontmatter.schema.yaml +24 -16
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +4 -1
- package/docs/specdojo/schemas/v1/exec-plan-frontmatter.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/gl.schema.yaml +8 -0
- package/docs/specdojo/schemas/v1/grade-pipeline-state.schema.yaml +1 -1
- package/docs/specdojo/schemas/v1/ifx-cmd.schema.yaml +5 -1
- package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +2 -1
- package/docs/specdojo/schemas/v1/register-events.schema.yaml +20 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +73 -4
- package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +5 -0
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +21 -3
- package/package.json +2 -2
- package/templates/antigravity/orchestrator.md +14 -9
- package/templates/claude/agents/specdojo-orchestrator.md +14 -9
- package/templates/codex/agents/specdojo-orchestrator.toml +14 -9
- package/templates/codex/orchestrator.md +14 -9
- package/templates/copilot/README.md +2 -1
- package/templates/devcontainer/devcontainer.json +1 -0
- package/templates/init-agent-members.yaml +46 -3
- package/templates/opencode/README.md +118 -14
- package/templates/opencode/agents/specdojo-orchestrator.md +15 -10
- package/templates/opencode/opencode.json +25 -0
|
@@ -93,15 +93,16 @@ catalog へ進む段階になったら、`.specdojo/specdojo.config.json` へ `c
|
|
|
93
93
|
|
|
94
94
|
type は次のように使い分ける。
|
|
95
95
|
|
|
96
|
-
| type | 用途
|
|
97
|
-
| ---------------- |
|
|
98
|
-
| `issue` | 解決すべき問題。原因調査を伴う
|
|
99
|
-
| `decision` | 選択肢から方針を決める
|
|
100
|
-
| `todo` | 実施する作業
|
|
101
|
-
| `question` | 判断を保留し、後で決める
|
|
102
|
-
| `risk` | 将来の不確実性
|
|
103
|
-
| `change-request` | 合意済み範囲の変更要求
|
|
104
|
-
| `note` | 記録として残す観測・分析
|
|
96
|
+
| type | 用途 | 終端状態 |
|
|
97
|
+
| ---------------- | ---------------------------------- | --------- |
|
|
98
|
+
| `issue` | 解決すべき問題。原因調査を伴う | `done` |
|
|
99
|
+
| `decision` | 選択肢から方針を決める | `decided` |
|
|
100
|
+
| `todo` | 実施する作業 | `done` |
|
|
101
|
+
| `question` | 判断を保留し、後で決める | `decided` |
|
|
102
|
+
| `risk` | 将来の不確実性 | `done` |
|
|
103
|
+
| `change-request` | 合意済み範囲の変更要求 | `done` |
|
|
104
|
+
| `note` | 記録として残す観測・分析 | なし |
|
|
105
|
+
| `epic` | track ごとの仕事の着手と完了の管理 | `done` |
|
|
105
106
|
|
|
106
107
|
起票では `--title` と `--description` を具体的に書く。`--description` は一覧へ出るため、後から見て内容が分かる文にする。`--topic` を省くとタイトルの英数字の部分から導出される。タイトルが日本語の場合は、内容を表す英語の `--topic`(小文字・ハイフン区切り。例: `payment-scope`)を渡す。
|
|
107
108
|
|
|
@@ -131,6 +132,10 @@ npx specdojo register close --project <project-id> --id <PJR-XXXX> \
|
|
|
131
132
|
|
|
132
133
|
`decision` と `question` は `--status decided` を付ける。close の前に個票の `決定内容` / `承認` を埋める。
|
|
133
134
|
|
|
135
|
+
`epic` は `--track <track>` で担う track を指定して起票し、具体的な作業は `--from <epic-id>` を付けた子 todo に分解する。epic 自体は `exec run --register` で実行せず、夜間の実行でも飛ばされる。子項目の状態は `register build` が生成する epic ごとのビューで確かめ、子項目と schedule を材料に人が close を判断する。
|
|
136
|
+
|
|
137
|
+
順番のある項目は `--depends-on <PJR-XXXX>`(繰り返し指定できる)で先に終わっているべき項目を記録する。起票の由来を表す `--from`(`derived_from`)とは別の意味で、どちらかで他方を兼ねない。先行の項目がすべて `done` / `decided` になるまで、`exec run --register` は止まり、夜間の実行では飛ばされる。状態は自動では `waiting` にならない。外すときは `--depends-on -` を指定する。後続の項目は一覧の `depends_on` 列と `generated/pjr-dependent-items.md` で確かめる。
|
|
138
|
+
|
|
134
139
|
`note` は終端させず、`open` のまま新しい事実・知見を追記する。close / reject / defer の対象にしない。対応や判断が必要になった場合は、目的に合う別の type で起票し、note は参照元として残す(`pjr-rulebook` の type 別の扱い)。
|
|
135
140
|
|
|
136
141
|
## 実践の型(kata)の扱い
|
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,68 @@
|
|
|
2
2
|
|
|
3
3
|
SpecDojo の利用者に影響する変更を記録します。
|
|
4
4
|
|
|
5
|
+
## [0.5.0] - 2026-10-29
|
|
6
|
+
|
|
7
|
+
同梱パッケージは `@specdojo/docs-lint` 0.3.0 と `@specdojo/docs-site` 0.3.0 を同時に公開します。docs-lint 0.3.0 は、rulebook の `deliverable_type` と成果物の `type` の照合、YAML 成果物の旧 type のエラー化(下記の破壊的変更の PJR-484B・PJR-0D0T)を含みます。下記の移行手順の検査には docs-lint 0.3.0 が必要です。docs-site 0.3.0 は、生成物の `.vitepress/` への集約(PJR-9ZN5)と、Mermaid の構文エラーで生成を止めない変更(PJR-N9JC)を含みます。
|
|
8
|
+
|
|
9
|
+
### 破壊的変更
|
|
10
|
+
|
|
11
|
+
成果物の `type` を rulebook の宣言と照合するようにし、宣言と違う値や旧値は移行期間なしでエラーになります。次の順で移行してください。詳細は下記の各項目を参照してください。
|
|
12
|
+
|
|
13
|
+
1. `specdojo` を 0.5.0、`@specdojo/docs-lint` を 0.3.0 に更新する(docs-site を使う場合は `@specdojo/docs-site` も 0.3.0 に更新する)。
|
|
14
|
+
2. eject した rulebook に `specdojo.deliverable_type` を追加する。
|
|
15
|
+
3. Markdown 成果物・sample・テンプレートの生成物 Frontmatter の `type` を宣言値に書き換え、`lint:fm` を通す。
|
|
16
|
+
4. YAML 成果物の旧 type(`domain` / `command` / `message`)を置き換え、`validate:schema:yaml` を通す。
|
|
17
|
+
5. `specdojo yaml-pages build` で表示ページを再生成する。
|
|
18
|
+
|
|
19
|
+
- 成果物の `type` に `requirement`(機能・非機能要件・受入基準)と `glossary`(用語集)を追加し、`project` はプロジェクトの管理文書に限定しました。各 rulebook の `specdojo.deliverable_type` を必須とし、Markdown 成果物・sample・テンプレートの生成物 Frontmatter と `lint:fm` で照合します(PJR-484B)。
|
|
20
|
+
- 既存の rulebook には、扱う成果物の `type` を `specdojo.deliverable_type` として追加してください。次に、その rulebook を参照する成果物・sample の `specdojo.type` と、テンプレートの `specdojo.frontmatter_template.specdojo.type` を宣言値に書き換えてください。テンプレート自身の `specdojo.type` は `template` のままにします。`lint:fm` を実行し、エラーに表示される宣言値にそろえてください。移行期間は設けず、従来の `project` や `sample` も宣言と違えばエラーにします。
|
|
21
|
+
- YAML 成果物も rulebook の宣言と照合します(PJR-0D0T)。既存の bdd は `type: domain` を `data`、ifx-cmd は `command` を `api`、ifx-msg の `x-spec-meta.type` は `message` を `api` に変更してください。gl には `type: glossary` と `rulebook: specdojo:gl-rulebook` を追加し、OpenAPI / AsyncAPI の `x-spec-meta` と IF 一覧にも対応する `rulebook` を記載してください。YAML テンプレートの `metadata_template.type` も宣言値に合わせ、自身の `type: template` は維持します。`npm run validate:schema:yaml` を実行し、エラーに示された置き換え先へ修正してください。旧値は即時エラーとなり、`specdojo-schema: none` / `validate=false` でもメタ情報は検証します。最後に `specdojo yaml-pages build` で表示ページを再生成してください。表示ページは元 YAML の `type` を引き継ぎます。
|
|
22
|
+
|
|
23
|
+
### 追加機能
|
|
24
|
+
|
|
25
|
+
- `repos[].integration_strategy` に `branch-only` を指定すると、プロダクトをローカルで merge せず、commit 済みの exec branch を残してプロダクト側の PR レビューへ渡せるようにしました。既定は従来どおり `merge` です。成功後は worktree を撤去し、プロジェクト側は `review` へ進んで result に未統合・branch 名・trace key を記録します。push と PR 作成は行いません(PJR-EXH2)。
|
|
26
|
+
|
|
27
|
+
- register の子 todo からカタログの判定・生成を行う `catalog-planning` と、scope・intent の宣言から strategy・track を生成する `strategy-planning` を追加しました。対象は `domain:<domain>` / `track:<track>` で指定します。`timeline build` と strategy 生成は、カタログ作成 todo の完了から `catalog_status` を導き、手書き計画との差を警告します(PJR-WAGY)。
|
|
28
|
+
|
|
29
|
+
- register に track ごとの仕事を管理する `epic` type と個票テンプレートを追加しました。`add` / `update --track` で担当 track を記録・検証し、`--from` でつないだ子項目と状態を epic 別ビューに表示します。epic 自体は `exec run --register`・filter・夜間 queue の実行対象から外し、完了は子項目と schedule を材料に人が判断します(PJR-B4Y4)。
|
|
30
|
+
|
|
31
|
+
- 登録項目の実行順序を `depends_on` と `register add` / `update --depends-on` で指定できるようにしました。参照先・自己参照・循環を検証し、先行項目が `done` / `decided` になるまで直接実行を停止、sweep・夜間 queue を理由付きでスキップします。一覧の依存列と後続項目の逆引きビューも追加しました(PJR-6RVJ)。
|
|
32
|
+
|
|
33
|
+
### 変更
|
|
34
|
+
|
|
35
|
+
- 配布するオーケストレーターの指示(`templates/` の各環境向け)の type の表に `epic` を加え、track を指定して起票し、子 todo へ分解し、epic 自体は実行しない扱いを書き足しました。
|
|
36
|
+
- 配布するオーケストレーターの指示に、`--depends-on` で順番のある項目の先行を記録し、`--from` の由来とは区別する扱いを書き足しました。
|
|
37
|
+
- `@specdojo/docs-site` が生成するファイルを `.vitepress/` の下にまとめました。Mermaid の SVG と manifest は `.vitepress/mermaid/`、kata のステージングは `.vitepress/kata-staging/` に出力し、ビルド結果には SVG だけを含めます。利用者の `public/` は変更しません。package 同梱の文書は `/ja/specdojo/...` で公開し、eject 済みの文書は利用リポジトリ側を優先します。`config init` が生成する `.gitignore` に `/.vitepress/dist/`・`/.vitepress/cache/`・`/.vitepress/mermaid/`・`/.vitepress/kata-staging/` を追加しました。旧配置の `public/mermaid/` と `specdojo-kata-staging/` は自動では削除しないため、不要になったら削除してください(PJR-9ZN5)。
|
|
38
|
+
- 技術領域別の TSD を作成する `specdojo:tsd-recipe` を追加し、`tsd-rulebook` から参照するようにしました。一冊・分冊の判断、採用値と未決事項の整理、段階的な動作確認、秘密情報の扱いを作業順に辿れます(PJR-05GN)。
|
|
39
|
+
- `specdojo:tsd-sample` を新しい `tsd-rulebook` に合わせて見直しました。駄菓子屋きぬや販売管理システムのデータベース詳細定義(PostgreSQL / Prisma)を題材とし、対象環境・前提条件、採用設定、導入手順、動作確認、制約・トラブルシュートを満たす完成例に再構成しました(PJR-EVAE)。
|
|
40
|
+
- `specdojo:tsd-index-sample` を新しい `tsd-index-rulebook` に合わせて見直しました。技術スタック一覧に版・正本と適用範囲の列を設け、開発・検証・文書化・運用の技術区分と必須・任意の区別を追加し、詳細 TSD サンプルへのリンクを整備しました(PJR-9SXH)。
|
|
41
|
+
- sample の `type` は見本にする成果物の種類とし、sample の識別は `id` とファイル名の `-sample` で行う原則を明文化しました。同梱 sample 5 件の `type` を揃え、既存の `type: sample` は互換性のためスキーマで許容します(PJR-XSM8)。
|
|
42
|
+
|
|
43
|
+
### 不具合修正
|
|
44
|
+
|
|
45
|
+
- markdownlint の設定がない利用リポジトリで、result の commit 前検査が日本語の長い行(MD013)を拒否する問題を修正しました。設定がない場合は SpecDojo の基本規則を使い、既存設定は優先します。通常の `init` と `config init` は不足する `.markdownlint.yaml` を上書きせずに生成します(PJR-0QW0)。
|
|
46
|
+
- plan に展開する grade の finding の `anchor` と本文を、バッククォートを含む場合も壊れないインラインコードで囲むようにしました。引用元に Markdown リンクがあっても、生成した plan が `validate:history-links` に失敗しません(PJR-H988)。
|
|
47
|
+
- `@specdojo/docs-site` の Mermaid 図に構文エラーがあっても、`dev` は対象文書とエラーを警告してほかの図とページの生成を続けるようにしました。`build` と `mermaid` は全図を処理し、失敗した図をまとめて報告してから失敗します。失敗した図の SVG を cache に残さず、修正後の変更検知で再生成します(PJR-N9JC)。
|
|
48
|
+
- `register add` / `update` の `sample-maintenance` が成果物の `type` を持つ sample を拒否する問題を修正しました。索引で対象を解決し、`id` の末尾 `-sample` で判定します(PJR-XSM8)。
|
|
49
|
+
- `project.repos` の文書の grade 結果を `results/<repo 名>/<文書 ID>.yaml` に分離し、別リポジトリの同じ ID による上書きと前回結果の誤参照を修正しました。plan・apply・run の再開・dashboard なども同じ配置を使い、本リポジトリの既存結果の保存先は維持します(PJR-8NWR)。
|
|
50
|
+
|
|
51
|
+
## [0.4.7] - 2026-10-26
|
|
52
|
+
|
|
53
|
+
### 追加機能
|
|
54
|
+
|
|
55
|
+
- カタログのない project でも、既存文書の索引・frontmatter、または個票の `--target-path`・`--target-rulebook` から成果物の approach plan を作れるようにしました。`fully-guided` などの kata 不足は起票時に検証し、`bootstrap` の未作成 kata と `finalize` 系の個票からのチェック表にも対応します。`cross-deliverable-dedup` は引き続きカタログが必要です(PJR-6WQY)。
|
|
56
|
+
|
|
57
|
+
- `projects.<id>.run.parent_validations_exclude` で、共有 `exec-defaults.yaml` の親検証から ID と実行先が一致する検証を project ごとに除外できるようにしました。除外後に既存の `parent_validations` を追記し、指定のない project の検証は維持します。未知の ID、共有一覧にない組の除外、重複する組は agent 起動前にエラーになります(PJR-P14M)。
|
|
58
|
+
|
|
59
|
+
- npm package に `specdojo grade run` を追加しました。文書の選択、評価 plan、名簿に基づく agent 実行、marker の機械変換とサイドカー反映を単段で実行し、同じ `--run-id` で未完了の文書だけを再開します。`--by` の別名は実体名で記録し、`--dry-run` で選択と actor を確認できます(PJR-K87Y)。
|
|
60
|
+
|
|
61
|
+
### 不具合修正
|
|
62
|
+
|
|
63
|
+
- review 前の grade を CLI 本体で実行し、開発用の `tools/grade/run-per-document.sh` への依存を解消しました。宣言済み `project.repos` の相対パスを grade で扱い、grade 結果・完了条件サイドカーを worktree 分岐前の checkpoint に含めます。`exec scaffold --project` の共通観点を `defaults/` から解決し、観点未設定時は同梱定義を使います。review plan の完了条件表を MD060 に適合させました(PJR-K87Y)。
|
|
64
|
+
- OpenCode の scaffold でローカル Ollama の接続・モデル設定を含む `opencode.json`(provider: `ollama-local`)をリポジトリ直下に配置するようにしました。配布する名簿の雛形・agent 定義・接続設定のモデル指定を整合させ、Gemma および Qwen は文脈長 64k を確保するローカル派生タグ(`*-mlx-work-64k`)を標準としました。派生タグ作成手順、接続先設定手順、既存環境の修正手順を OpenCode テンプレートの README および設定ガイドに追記しました(PJR-MB92)。
|
|
65
|
+
- `devcontainer scaffold` で生成する `devcontainer.json` の雛形に `shutdownAction: "none"` を追加し、VS Code などのクライアント切断時にコンテナが停止しないようにしました。既存環境の修正手順を常時稼働ホスト運用ガイドに追記しました(PJR-TVGA)。
|
|
66
|
+
|
|
5
67
|
## [0.4.6] - 2026-10-25
|
|
6
68
|
|
|
7
69
|
### 追加機能
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
import { existsSync, readFileSync } from "node:fs";
|
|
2
|
+
import { basename, resolve } from "node:path";
|
|
3
|
+
import { collectResolvedDeliverables } from "./build.js";
|
|
4
|
+
import { resolveBasePath } from "./paths.js";
|
|
5
|
+
import { readSpecdojoNamespace } from "../docs/frontmatter-namespace.js";
|
|
6
|
+
import { load } from "../shared/yaml.js";
|
|
7
|
+
import { listFilesRecursive } from "../shared/fs.js";
|
|
8
|
+
import { isDctPlanFileName } from "./plan.js";
|
|
9
|
+
import { specdojoRootDir } from "../shared/specdojo-config.js";
|
|
10
|
+
// Existing document metadata is authoritative; uncreated product docs use a bare id.
|
|
11
|
+
export function deliverableDocId(projectId, localId, resolvedPath, repoRoot = specdojoRootDir()) {
|
|
12
|
+
if (resolvedPath) {
|
|
13
|
+
const absolutePath = resolve(repoRoot, resolvedPath);
|
|
14
|
+
if (existsSync(absolutePath)) {
|
|
15
|
+
try {
|
|
16
|
+
const id = readSpecdojoNamespace(readFileSync(absolutePath, "utf8")).id;
|
|
17
|
+
if (typeof id === "string" && id.trim())
|
|
18
|
+
return id.trim();
|
|
19
|
+
}
|
|
20
|
+
catch {
|
|
21
|
+
// Invalid metadata falls back to the placement convention.
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
const normalized = resolvedPath.replaceAll("\\", "/").replace(/^\/+/, "");
|
|
25
|
+
if (/^docs\/[a-z]{2}\/product(?:\/|$)/.test(normalized))
|
|
26
|
+
return localId;
|
|
27
|
+
}
|
|
28
|
+
return projectId ? `${projectId}:${localId}` : localId;
|
|
29
|
+
}
|
|
30
|
+
export function loadPlanCatalogDocs(catalogPath) {
|
|
31
|
+
if (!catalogPath || !existsSync(catalogPath))
|
|
32
|
+
return [];
|
|
33
|
+
// Catalog scans walk subdirectories, so agent judgment plans (plans/dct-plan-*.yaml)
|
|
34
|
+
// must be excluded; they share the dct- prefix but carry no catalog structure.
|
|
35
|
+
const files = listFilesRecursive(catalogPath)
|
|
36
|
+
.filter((f) => {
|
|
37
|
+
const name = basename(f);
|
|
38
|
+
return /^dct-.+\.ya?ml$/i.test(name) && !isDctPlanFileName(name);
|
|
39
|
+
})
|
|
40
|
+
.sort();
|
|
41
|
+
const docs = [];
|
|
42
|
+
for (const filePath of files) {
|
|
43
|
+
try {
|
|
44
|
+
docs.push(load(readFileSync(filePath, "utf8")));
|
|
45
|
+
}
|
|
46
|
+
catch {
|
|
47
|
+
continue;
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
return docs;
|
|
51
|
+
}
|
|
52
|
+
export function resolveDeliverableByDocId(catalogPath, projectId, targetId, repoRoot = specdojoRootDir()) {
|
|
53
|
+
const matches = [];
|
|
54
|
+
for (const doc of loadPlanCatalogDocs(catalogPath)) {
|
|
55
|
+
const deliverables = [];
|
|
56
|
+
collectResolvedDeliverables(doc.groups, resolveBasePath("", doc.base_path), deliverables);
|
|
57
|
+
for (const { item, resolvedPath } of deliverables) {
|
|
58
|
+
if (targetId === deliverableDocId(projectId, item.local_id, resolvedPath, repoRoot) ||
|
|
59
|
+
targetId === item.local_id ||
|
|
60
|
+
targetId === `${projectId}:${item.local_id}`) {
|
|
61
|
+
matches.push({
|
|
62
|
+
domain: doc.domain,
|
|
63
|
+
localId: item.local_id,
|
|
64
|
+
slug: item.local_id,
|
|
65
|
+
info: { deliverable: item, resolvedPath },
|
|
66
|
+
});
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
if (matches.length === 0)
|
|
71
|
+
throw new Error(`catalog deliverable target not found for document id: ${targetId}`);
|
|
72
|
+
if (matches.length > 1)
|
|
73
|
+
throw new Error(`ambiguous catalog deliverable target for document id ${targetId}: ${matches.map((match) => match.localId).join(", ")}`);
|
|
74
|
+
return matches[0];
|
|
75
|
+
}
|
package/dist/commands/agent.js
CHANGED
|
@@ -1,83 +1,5 @@
|
|
|
1
|
-
import {
|
|
2
|
-
|
|
3
|
-
import { defaultExecDefaultsPath, loadExecDefaultsConfig, resolveMemberCommand, resolveRateLimitDetection, resolveRateLimitPolicy, } from "../exec/agent-config.js";
|
|
4
|
-
import { resolveProjectPaths } from "../exec/project.js";
|
|
5
|
-
import { executeAgent, loadRosterForExecutionPath } from "../exec/run/run.js";
|
|
6
|
-
import { gitEnvironment } from "../shared/git-environment.js";
|
|
7
|
-
import { resolveAgentMember as resolveRosterAgentMember, specdojoRootDir, } from "../shared/specdojo-config.js";
|
|
8
|
-
// Rate limit は通常失敗と異なり、呼び出し側が処理済みにせず中断・再開する必要がある。
|
|
9
|
-
// shell script が出力文字列を解析せず分岐できるよう、一時失敗を表す専用コードにする。
|
|
10
|
-
export const AGENT_RUN_RATE_LIMIT_EXIT_CODE = 75;
|
|
11
|
-
export function resolveAgentMember(roster, nickname) {
|
|
12
|
-
const directMembers = roster?.members.filter((candidate) => {
|
|
13
|
-
return candidate.type === "agent" && candidate.nickname === nickname;
|
|
14
|
-
});
|
|
15
|
-
if (directMembers && directMembers.length > 1) {
|
|
16
|
-
return { error: `--by agent nickname is not unique in agent-members.yaml: ${nickname}` };
|
|
17
|
-
}
|
|
18
|
-
const member = resolveRosterAgentMember(roster, nickname);
|
|
19
|
-
if (!member) {
|
|
20
|
-
return { error: `--by agent nickname not found in agent-members.yaml: ${nickname}` };
|
|
21
|
-
}
|
|
22
|
-
if (member.disabled) {
|
|
23
|
-
return { error: `--by agent is disabled in agent-members.yaml: ${nickname}` };
|
|
24
|
-
}
|
|
25
|
-
return { member };
|
|
26
|
-
}
|
|
27
|
-
export function resolveAgentCommand(execDefaults, member) {
|
|
28
|
-
let command;
|
|
29
|
-
try {
|
|
30
|
-
command = resolveMemberCommand(execDefaults, member);
|
|
31
|
-
}
|
|
32
|
-
catch (error) {
|
|
33
|
-
return { error: error instanceof Error ? error.message : String(error) };
|
|
34
|
-
}
|
|
35
|
-
if (!command) {
|
|
36
|
-
return { error: `--by agent has no resolvable command: ${member.nickname}` };
|
|
37
|
-
}
|
|
38
|
-
return { command };
|
|
39
|
-
}
|
|
40
|
-
export function readAgentPlan(planPath) {
|
|
41
|
-
const absolutePath = resolve(planPath);
|
|
42
|
-
if (!existsSync(absolutePath)) {
|
|
43
|
-
throw new Error(`--plan not found: ${planPath}`);
|
|
44
|
-
}
|
|
45
|
-
const prompt = readFileSync(absolutePath, "utf8");
|
|
46
|
-
if (!prompt.trim()) {
|
|
47
|
-
throw new Error(`--plan is empty: ${planPath}`);
|
|
48
|
-
}
|
|
49
|
-
return prompt;
|
|
50
|
-
}
|
|
51
|
-
export function writeAgentOutput(outPath, stdout) {
|
|
52
|
-
const absolutePath = resolve(outPath);
|
|
53
|
-
mkdirSync(dirname(absolutePath), { recursive: true });
|
|
54
|
-
writeFileSync(absolutePath, stdout, "utf8");
|
|
55
|
-
return absolutePath;
|
|
56
|
-
}
|
|
57
|
-
export async function runAgentPlan(opts) {
|
|
58
|
-
const prompt = readAgentPlan(opts.planPath);
|
|
59
|
-
const paths = resolveProjectPaths({ project: opts.project });
|
|
60
|
-
const roster = loadRosterForExecutionPath(paths.executionPath);
|
|
61
|
-
const memberResult = resolveAgentMember(roster, opts.nickname);
|
|
62
|
-
if ("error" in memberResult)
|
|
63
|
-
throw new Error(memberResult.error);
|
|
64
|
-
const { member } = memberResult;
|
|
65
|
-
const execDefaults = loadExecDefaultsConfig(opts.execDefaultsPath ?? defaultExecDefaultsPath(), paths.executionPath);
|
|
66
|
-
const commandResult = resolveAgentCommand(execDefaults, member);
|
|
67
|
-
if ("error" in commandResult)
|
|
68
|
-
throw new Error(commandResult.error);
|
|
69
|
-
const { command } = commandResult;
|
|
70
|
-
if (opts.dryRun) {
|
|
71
|
-
process.stdout.write(`${command}\n`);
|
|
72
|
-
return { command, actor: member.nickname };
|
|
73
|
-
}
|
|
74
|
-
const execution = await executeAgent(command, prompt, resolveRateLimitDetection(execDefaults, member.provider), member.provider, resolveRateLimitPolicy(execDefaults, member.provider)?.cooldown_seconds, specdojoRootDir(), {
|
|
75
|
-
...gitEnvironment(),
|
|
76
|
-
SPECDOJO_SCHEDULE_PATH: paths.schedulePath,
|
|
77
|
-
SPECDOJO_EXECUTION_PATH: paths.executionPath,
|
|
78
|
-
}, opts.quiet);
|
|
79
|
-
return { execution, command, actor: member.nickname };
|
|
80
|
-
}
|
|
1
|
+
import { AGENT_RUN_RATE_LIMIT_EXIT_CODE, runAgentPlan, writeAgentOutput, } from "../exec/agent-plan.js";
|
|
2
|
+
export { AGENT_RUN_RATE_LIMIT_EXIT_CODE, resolveAgentMember, resolveAgentCommand, readAgentPlan, writeAgentOutput, runAgentPlan, } from "../exec/agent-plan.js";
|
|
81
3
|
export function registerAgentCommands(program) {
|
|
82
4
|
const agent = program.command("agent").description("Run a plan with a specific agent");
|
|
83
5
|
agent
|
package/dist/commands/init.js
CHANGED
|
@@ -6,6 +6,7 @@ import { runScaffold } from "../catalog/scaffold.js";
|
|
|
6
6
|
import { runDevcontainerScaffold } from "../devcontainer/scaffold.js";
|
|
7
7
|
import { runProviderScaffold } from "../shared/provider-scaffold.js";
|
|
8
8
|
import { runLefthookScaffold } from "../shared/lefthook-scaffold.js";
|
|
9
|
+
import { ensureMarkdownlintConfig } from "../shared/markdownlint-config.js";
|
|
9
10
|
import { runSlidevScaffold, SLIDEV_KATA_PATTERNS } from "../shared/slidev-scaffold.js";
|
|
10
11
|
import { generateDerivedViewFiles } from "../register/register.js";
|
|
11
12
|
import { defaultWorktreeBase, projectGitignoreLayout, specdojoRootDir, } from "../shared/specdojo-config.js";
|
|
@@ -559,6 +560,8 @@ export async function runInit(options, deps) {
|
|
|
559
560
|
if (answers.slidev) {
|
|
560
561
|
await runSlidevScaffold({ repoRoot, dryRun });
|
|
561
562
|
}
|
|
563
|
+
if (!answers.lefthook && !answers.slidev)
|
|
564
|
+
ensureMarkdownlintConfig(repoRoot, dryRun);
|
|
562
565
|
const firstProvider = answers.providers[0];
|
|
563
566
|
const script = firstProvider === "claude"
|
|
564
567
|
? "orch:opus"
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { registerDependencyBlockReason } from "../register/dependency.js";
|
|
1
2
|
import { spawn } from "node:child_process";
|
|
2
3
|
import { mkdirSync, writeFileSync } from "node:fs";
|
|
3
4
|
import { join, relative } from "node:path";
|
|
@@ -192,19 +193,47 @@ export function registerNightOrchestratorCommand(orchestrator) {
|
|
|
192
193
|
if (!projectId)
|
|
193
194
|
throw new Error("orchestrator night requires --project <id>.");
|
|
194
195
|
const items = loadRegisterItems(resolveRegisterPaths({ project: projectId })).map((view) => view.item);
|
|
195
|
-
const
|
|
196
|
+
const registerPaths = resolveRegisterPaths({ project: projectId });
|
|
197
|
+
const dependencyOutcomes = [];
|
|
198
|
+
const dependencyItems = [];
|
|
199
|
+
const selected = selectApprovedNightItems(items, Number.MAX_SAFE_INTEGER)
|
|
200
|
+
.filter((item) => {
|
|
201
|
+
const reason = registerDependencyBlockReason(registerPaths, item);
|
|
202
|
+
if (!reason)
|
|
203
|
+
return true;
|
|
204
|
+
process.stdout.write(`[night] skipping ${item.id}: ${reason}\n`);
|
|
205
|
+
dependencyItems.push(item);
|
|
206
|
+
dependencyOutcomes.push({
|
|
207
|
+
id: item.id,
|
|
208
|
+
outcome: "skipped",
|
|
209
|
+
transition: "none",
|
|
210
|
+
reason,
|
|
211
|
+
});
|
|
212
|
+
return false;
|
|
213
|
+
})
|
|
214
|
+
.slice(0, maxItems);
|
|
196
215
|
process.stdout.write(`[night] approved queue (${selected.length}/${maxItems}): ${selected.map((item) => item.id).join(", ") || "none"}\n`);
|
|
197
216
|
if (opts.dryRun)
|
|
198
217
|
return;
|
|
199
218
|
const startedAt = opts.scheduledAt
|
|
200
219
|
? new Date(opts.scheduledAt).toISOString()
|
|
201
220
|
: new Date().toISOString();
|
|
202
|
-
const outcomes = [];
|
|
221
|
+
const outcomes = [...dependencyOutcomes];
|
|
203
222
|
const approvalIssues = new Map();
|
|
204
223
|
let consecutiveFailures = 0;
|
|
205
224
|
let stopReason;
|
|
206
225
|
for (let offset = 0; offset < selected.length; offset += parallel) {
|
|
207
|
-
const
|
|
226
|
+
const current = new Map(loadRegisterItems(registerPaths).map((view) => [view.id, view.item]));
|
|
227
|
+
const wave = selected.slice(offset, offset + parallel).filter((item) => {
|
|
228
|
+
const reason = registerDependencyBlockReason(registerPaths, current.get(item.id) ?? item);
|
|
229
|
+
if (!reason)
|
|
230
|
+
return true;
|
|
231
|
+
outcomes.push({ id: item.id, outcome: "skipped", transition: "none", reason });
|
|
232
|
+
process.stdout.write(`[night] skipping ${item.id}: ${reason}\n`);
|
|
233
|
+
return false;
|
|
234
|
+
});
|
|
235
|
+
if (wave.length === 0)
|
|
236
|
+
continue;
|
|
208
237
|
const [command, args] = cliInvocation([
|
|
209
238
|
"exec",
|
|
210
239
|
"run",
|
|
@@ -270,7 +299,7 @@ export function registerNightOrchestratorCommand(orchestrator) {
|
|
|
270
299
|
projectId,
|
|
271
300
|
startedAt,
|
|
272
301
|
completedAt,
|
|
273
|
-
selected,
|
|
302
|
+
selected: [...dependencyItems, ...selected],
|
|
274
303
|
outcomes,
|
|
275
304
|
approvalIssues,
|
|
276
305
|
...(stopReason ? { stopReason } : {}),
|
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
import { mkdirSync, existsSync, readFileSync, writeFileSync
|
|
1
|
+
import { mkdirSync, existsSync, readFileSync, writeFileSync } from "node:fs";
|
|
2
2
|
import { join } from "node:path";
|
|
3
3
|
import { toArtifactPath } from "../shared/artifact-path.js";
|
|
4
|
-
import { readJson } from "../shared/fs.js";
|
|
4
|
+
import { listFilesRecursive, readJson } from "../shared/fs.js";
|
|
5
5
|
import { readAllEventFiles } from "../exec/events.js";
|
|
6
6
|
import { getProjectExecutionPath, getProjectRoutinesPath, getProjectSchedulePath, getProjectTimelinePath, loadConfig, loadEnv, specdojoRootDir, } from "../shared/specdojo-config.js";
|
|
7
7
|
import { resolveRegisterPaths, loadRegisterItems, } from "../register/register.js";
|
|
@@ -381,11 +381,10 @@ function renderDailyRoutineSection(paths) {
|
|
|
381
381
|
export function readDashboardGradeResults(resultsPath) {
|
|
382
382
|
if (!existsSync(resultsPath))
|
|
383
383
|
return [];
|
|
384
|
-
return
|
|
385
|
-
.filter((
|
|
384
|
+
return listFilesRecursive(resultsPath)
|
|
385
|
+
.filter((path) => path.endsWith(".yaml") || path.endsWith(".yml"))
|
|
386
386
|
.sort()
|
|
387
|
-
.flatMap((
|
|
388
|
-
const path = join(resultsPath, name);
|
|
387
|
+
.flatMap((path) => {
|
|
389
388
|
try {
|
|
390
389
|
return [parseGradeResult(readFileSync(path, "utf8"), path)];
|
|
391
390
|
}
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { existsSync } from "node:fs";
|
|
2
2
|
import { join } from "node:path";
|
|
3
3
|
import { collectCatalogFilesByDomain } from "../shared/catalog-files.js";
|
|
4
|
+
import { resolveTimelineCatalogStatus } from "../register/catalog-status.js";
|
|
4
5
|
import { loadTimelineIndex, } from "../shared/timeline-index.js";
|
|
5
6
|
export { collectCatalogFilesByDomain, loadTimelineIndex };
|
|
6
7
|
// depends_on の未定義参照・循環・order との矛盾を検出する。
|
|
@@ -107,6 +108,9 @@ export function buildTimeline(opts) {
|
|
|
107
108
|
const { index, errors: loadErrors } = loadTimelineIndex(indexFile);
|
|
108
109
|
const errors = [...loadErrors];
|
|
109
110
|
const warnings = [];
|
|
111
|
+
const derived = resolveTimelineCatalogStatus(index.tracks, opts.registerPath);
|
|
112
|
+
index.tracks = derived.tracks;
|
|
113
|
+
warnings.push(...derived.warnings);
|
|
110
114
|
const structure = validateTimelineTracks(index.tracks);
|
|
111
115
|
errors.push(...structure.errors);
|
|
112
116
|
warnings.push(...structure.warnings);
|
|
@@ -147,7 +151,7 @@ export function renderTimelineOrderMarkdown(result) {
|
|
|
147
151
|
lines.push(`- catalog_scaffold_targets: \`${result.scaffolds.length}\``);
|
|
148
152
|
lines.push("");
|
|
149
153
|
lines.push(`この文書は \`tml-index.yaml\` から \`specdojo timeline build\` が生成した派生ビューです。` +
|
|
150
|
-
|
|
154
|
+
`直接編集せず、計画は \`tml-index.yaml\`、カタログ作成の完了は register の todo に記録してください。`);
|
|
151
155
|
for (const wave of result.waves) {
|
|
152
156
|
lines.push("");
|
|
153
157
|
lines.push(`## ${wave.wave}. Wave ${wave.wave}`);
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { existsSync, mkdirSync, writeFileSync } from "node:fs";
|
|
2
2
|
import { join, resolve } from "node:path";
|
|
3
|
-
import { getProjectCatalogPath, getProjectTimelinePath, loadConfig, loadEnv, specdojoRootDir, } from "../shared/specdojo-config.js";
|
|
3
|
+
import { getProjectCatalogPath, getProjectTimelinePath, getProjectRegisterPath, loadConfig, loadEnv, specdojoRootDir, } from "../shared/specdojo-config.js";
|
|
4
4
|
import { buildTimeline, renderCatalogScaffoldMarkdown, renderTimelineOrderMarkdown, } from "./timeline-build.js";
|
|
5
5
|
function resolveTimelinePaths(opts) {
|
|
6
6
|
loadEnv();
|
|
@@ -20,9 +20,11 @@ function resolveTimelinePaths(opts) {
|
|
|
20
20
|
throw new Error(`Unknown project: ${projectId} (check ${configPath})`);
|
|
21
21
|
}
|
|
22
22
|
const catalogPath = getProjectCatalogPath(project);
|
|
23
|
+
const registerPath = getProjectRegisterPath(project);
|
|
23
24
|
return {
|
|
24
25
|
timelinePath: resolve(baseDir, getProjectTimelinePath(project)),
|
|
25
26
|
catalogPath: catalogPath ? resolve(baseDir, catalogPath) : null,
|
|
27
|
+
...(registerPath ? { registerPath: resolve(baseDir, registerPath) } : {}),
|
|
26
28
|
};
|
|
27
29
|
}
|
|
28
30
|
function printCommandError(error) {
|
|
@@ -37,6 +39,7 @@ function buildTimelineJson(result) {
|
|
|
37
39
|
return (JSON.stringify({
|
|
38
40
|
project_id: result.projectId,
|
|
39
41
|
schedule_ready_tracks: result.scheduleReadyTracks,
|
|
42
|
+
track_catalog_status: Object.fromEntries(result.waves.flatMap((wave) => wave.tracks.map((track) => [track.track, track.catalog_status]))),
|
|
40
43
|
waves: result.waves.map((wave) => ({
|
|
41
44
|
wave: wave.wave,
|
|
42
45
|
tracks: wave.tracks.map((track) => track.track),
|
|
@@ -70,8 +73,8 @@ export function registerTimelineCommands(program) {
|
|
|
70
73
|
bcmd.option("--dry-run", "Print generated content to stdout without writing", false);
|
|
71
74
|
bcmd.action((opts) => {
|
|
72
75
|
try {
|
|
73
|
-
const { timelinePath, catalogPath } = resolveTimelinePaths(opts);
|
|
74
|
-
const result = buildTimeline({ timelinePath, catalogPath });
|
|
76
|
+
const { timelinePath, catalogPath, registerPath } = resolveTimelinePaths(opts);
|
|
77
|
+
const result = buildTimeline({ timelinePath, catalogPath, registerPath });
|
|
75
78
|
for (const warning of result.warnings)
|
|
76
79
|
process.stdout.write(`WARN: ${warning}\n`);
|
|
77
80
|
for (const error of result.errors)
|
package/dist/docs/yaml-pages.js
CHANGED
|
@@ -66,13 +66,9 @@ function deriveMeta(yamlRelPath, content) {
|
|
|
66
66
|
.replace(/[^a-z0-9:_-]/g, "-");
|
|
67
67
|
const rawId = readMeta("id");
|
|
68
68
|
const id = typeof rawId === "string" && DOC_ID_RE.test(rawId) ? rawId : fileBase;
|
|
69
|
-
//
|
|
70
|
-
|
|
71
|
-
const type =
|
|
72
|
-
? "sample"
|
|
73
|
-
: yamlRelPath.includes("/templates/")
|
|
74
|
-
? "template"
|
|
75
|
-
: "project";
|
|
69
|
+
// 分類は配置パスから推測せず正本の値を引き継ぐ。欠落・旧値は YAML 検証で扱う。
|
|
70
|
+
const rawType = readMeta("type");
|
|
71
|
+
const type = typeof rawType === "string" ? rawType : undefined;
|
|
76
72
|
const rawStatus = readMeta("status");
|
|
77
73
|
const status = typeof rawStatus === "string" && STATUS_VALUES.has(rawStatus)
|
|
78
74
|
? rawStatus
|
|
@@ -83,13 +79,23 @@ function deriveMeta(yamlRelPath, content) {
|
|
|
83
79
|
const info = isRecord(record["info"]) ? record["info"] : {};
|
|
84
80
|
const rawTitle = readMeta("title") ?? info["title"];
|
|
85
81
|
const title = typeof rawTitle === "string" && rawTitle.trim() !== "" ? rawTitle.trim() : undefined;
|
|
86
|
-
return {
|
|
82
|
+
return {
|
|
83
|
+
id,
|
|
84
|
+
...(type !== undefined ? { type } : {}),
|
|
85
|
+
status,
|
|
86
|
+
rulebook,
|
|
87
|
+
...(title ? { title } : {}),
|
|
88
|
+
};
|
|
87
89
|
}
|
|
88
90
|
// 表示ページの Markdown を組み立てる。YAML 本文はコードブロックで埋め込み、
|
|
89
91
|
// 本文中のバッククォート連続より長いフェンスを使って壊れないようにする。
|
|
90
92
|
export function renderYamlPage(yamlRelPath, content) {
|
|
91
93
|
const { title, ...meta } = deriveMeta(yamlRelPath, content);
|
|
92
|
-
|
|
94
|
+
// ジョブ定義・評価記録など、成果物の type を持たない YAML も索引に含まれる。
|
|
95
|
+
// その表示ページは成果物メタ情報を宣言せず、正本の型検証に委ねる。
|
|
96
|
+
const header = meta.type === undefined
|
|
97
|
+
? []
|
|
98
|
+
: ["---", dump({ specdojo: meta }, { lineWidth: -1 }).trimEnd(), "---", ""];
|
|
93
99
|
const fileName = posix.basename(yamlRelPath);
|
|
94
100
|
const heading = title ?? fileName;
|
|
95
101
|
const note = `> このページは \`${yamlRelPath}\` から生成された表示用ページです。正本は YAML ファイルであり、このページは再生成できます。`;
|
|
@@ -104,10 +110,7 @@ export function renderYamlPage(yamlRelPath, content) {
|
|
|
104
110
|
}
|
|
105
111
|
if (isDctTemplateCatalog(yamlRelPath, parsed)) {
|
|
106
112
|
return [
|
|
107
|
-
|
|
108
|
-
frontmatter,
|
|
109
|
-
"---",
|
|
110
|
-
"",
|
|
113
|
+
...header,
|
|
111
114
|
`# ${heading}`,
|
|
112
115
|
"",
|
|
113
116
|
note,
|
|
@@ -123,10 +126,7 @@ export function renderYamlPage(yamlRelPath, content) {
|
|
|
123
126
|
const fence = "`".repeat(Math.max(3, longestRun + 1));
|
|
124
127
|
const body = content.endsWith("\n") ? content : `${content}\n`;
|
|
125
128
|
return [
|
|
126
|
-
|
|
127
|
-
frontmatter,
|
|
128
|
-
"---",
|
|
129
|
-
"",
|
|
129
|
+
...header,
|
|
130
130
|
`# ${heading}`,
|
|
131
131
|
"",
|
|
132
132
|
note,
|
|
@@ -3,7 +3,7 @@ import { isAbsolute, join, resolve } from "node:path";
|
|
|
3
3
|
import { listFilesRecursive, readYaml } from "./shared.js";
|
|
4
4
|
import { acquirePoolSlot, releaseLock } from "./slot-lock.js";
|
|
5
5
|
import { getProjectExecutionPath, loadConfig, specdojoRootDir, } from "../shared/specdojo-config.js";
|
|
6
|
-
import { resolveParentValidationConcurrency, resolveParentValidationDefinitions, } from "./parent-validation.js";
|
|
6
|
+
import { resolveParentValidationConcurrency, resolveParentValidationAssignments, resolveParentValidationDefinitions, } from "./parent-validation.js";
|
|
7
7
|
const PLACEHOLDER_PATTERN = /\{([a-z][a-z0-9_]*)\}/g;
|
|
8
8
|
const BUILTIN_VARIABLE_NAMES = new Set(["nickname", "mode", "proficiency"]);
|
|
9
9
|
// Mirror of the nickname pattern in docs/specdojo/schemas/v1/agent-members.schema.yaml.
|
|
@@ -283,12 +283,12 @@ function loadLegacyRateLimitPolicy(executionPath) {
|
|
|
283
283
|
}
|
|
284
284
|
return undefined;
|
|
285
285
|
}
|
|
286
|
-
function
|
|
286
|
+
function projectParentValidationOverrides(executionPath) {
|
|
287
287
|
if (!executionPath)
|
|
288
|
-
return
|
|
288
|
+
return {};
|
|
289
289
|
const { config } = loadConfig();
|
|
290
290
|
if (!config)
|
|
291
|
-
return
|
|
291
|
+
return {};
|
|
292
292
|
const rootDir = specdojoRootDir();
|
|
293
293
|
const targetExecutionPath = resolve(executionPath);
|
|
294
294
|
const normalizedTarget = targetExecutionPath.replaceAll("\\", "/");
|
|
@@ -303,16 +303,18 @@ function projectParentValidations(executionPath) {
|
|
|
303
303
|
normalizedTarget.endsWith(`/${normalizedConfigured.replace(/^\.\//, "")}`);
|
|
304
304
|
if (resolvedExecutionPath !== targetExecutionPath && !isProjectWorktreePath)
|
|
305
305
|
continue;
|
|
306
|
-
const
|
|
307
|
-
?.
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
throw new Error(`Invalid .specdojo/specdojo.config.json: projects.${projectId}.run.parent_validations must be an array`);
|
|
306
|
+
for (const key of ["parent_validations", "parent_validations_exclude"]) {
|
|
307
|
+
const entries = project.run?.[key];
|
|
308
|
+
if (entries !== undefined && !Array.isArray(entries)) {
|
|
309
|
+
throw new Error(`Invalid .specdojo/specdojo.config.json: projects.${projectId}.run.${key} must be an array`);
|
|
310
|
+
}
|
|
312
311
|
}
|
|
313
|
-
return
|
|
312
|
+
return {
|
|
313
|
+
append: project.run?.parent_validations,
|
|
314
|
+
exclude: project.run?.parent_validations_exclude,
|
|
315
|
+
};
|
|
314
316
|
}
|
|
315
|
-
return
|
|
317
|
+
return {};
|
|
316
318
|
}
|
|
317
319
|
export function loadExecDefaultsConfig(configPath, executionPath) {
|
|
318
320
|
const path = configPath ?? defaultExecDefaultsPath();
|
|
@@ -331,15 +333,25 @@ export function loadExecDefaultsConfig(configPath, executionPath) {
|
|
|
331
333
|
if (legacyPolicy)
|
|
332
334
|
defaults.rate_limit_policy = legacyPolicy;
|
|
333
335
|
}
|
|
334
|
-
const
|
|
335
|
-
if (
|
|
336
|
+
const overrides = projectParentValidationOverrides(executionPath);
|
|
337
|
+
if (overrides.exclude?.length || overrides.append?.length) {
|
|
338
|
+
const sharedEntries = defaults.pipeline?.parent_validations ?? [];
|
|
339
|
+
// Validate the shared list before filtering so an exclusion cannot hide invalid defaults.
|
|
340
|
+
const sharedAssignments = resolveParentValidationAssignments(sharedEntries);
|
|
341
|
+
const sharedLabels = new Set(sharedAssignments.map(({ label }) => label));
|
|
342
|
+
const excludedLabels = new Set(resolveParentValidationAssignments(overrides.exclude).map(({ label }) => label));
|
|
343
|
+
for (const label of excludedLabels) {
|
|
344
|
+
if (!sharedLabels.has(label)) {
|
|
345
|
+
throw new Error(`Invalid run.parent_validations_exclude: ${label} is not present in shared pipeline.parent_validations`);
|
|
346
|
+
}
|
|
347
|
+
}
|
|
336
348
|
defaults = {
|
|
337
349
|
...defaults,
|
|
338
350
|
pipeline: {
|
|
339
351
|
...defaults.pipeline,
|
|
340
352
|
parent_validations: [
|
|
341
|
-
...(
|
|
342
|
-
...
|
|
353
|
+
...sharedEntries.filter((_, index) => !excludedLabels.has(sharedAssignments[index].label)),
|
|
354
|
+
...(overrides.append ?? []),
|
|
343
355
|
],
|
|
344
356
|
},
|
|
345
357
|
};
|