specdojo 0.4.7 → 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 +46 -0
- 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/core.js +2 -0
- package/dist/exec/pipeline-state.js +5 -2
- package/dist/exec/plans-core.js +3 -2
- package/dist/exec/plans-generation.js +9 -5
- 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/register.js +16 -1
- 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/register-core.js +11 -0
- package/dist/exec/run/register-mode.js +19 -1
- package/dist/exec/run/register-resume.js +22 -0
- package/dist/exec/run/register-worktree.js +23 -0
- package/dist/exec/strategy.js +2 -0
- package/dist/exec/task-repos.js +18 -4
- package/dist/exec/worktree-ops-commit.js +7 -1
- package/dist/grade/apply.js +6 -2
- package/dist/grade/markdown.js +7 -2
- package/dist/grade/plan.js +6 -4
- package/dist/register/approach.js +19 -0
- package/dist/register/catalog-status.js +49 -0
- package/dist/register/core.js +3 -0
- package/dist/register/create-commands.js +34 -4
- 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 +4 -0
- package/dist/register/external-project.js +4 -0
- package/dist/register/item.js +10 -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/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-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/specdojo-config.js +10 -3
- package/dist/shared/specdojo-gitignore.js +4 -0
- 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/guides/docs-editing-guide.md +14 -1
- package/docs/ja/specdojo/guides/docs-structure-guide.md +10 -8
- package/docs/ja/specdojo/guides/exec-operation-guide.md +16 -15
- package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +19 -1
- package/docs/ja/specdojo/guides/practice-system-composition-guide.md +2 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +37 -14
- package/docs/ja/specdojo/guides/register-operation-guide.md +44 -15
- 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 +42 -4
- package/docs/ja/specdojo/references/specdojo-config-reference.md +20 -8
- 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 +50 -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/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 +18 -0
- package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +40 -3
- package/docs/specdojo/schemas/v1/rulebook-frontmatter.schema.yaml +5 -0
- package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +5 -0
- 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/opencode/agents/specdojo-orchestrator.md +14 -9
package/dist/register/views.js
CHANGED
|
@@ -149,9 +149,9 @@ function markdownLink(label, fromDirectory, targetPath) {
|
|
|
149
149
|
const href = path.startsWith(".") ? path : `./${path}`;
|
|
150
150
|
return `[${toCell(label)}](${href})`;
|
|
151
151
|
}
|
|
152
|
-
function generateDerivedItemsFile(paths, items) {
|
|
152
|
+
function generateDerivedItemsFile(paths, items, relationField = "derivedFrom") {
|
|
153
153
|
const sourceDocs = new Map(items.flatMap((view) => (view.ticketPath ? [[view.id, view.ticketPath]] : [])));
|
|
154
|
-
const rows = collectDerivedRegisterRelations(paths, items).map((relation) => {
|
|
154
|
+
const rows = collectDerivedRegisterRelations(paths, items, relationField).map((relation) => {
|
|
155
155
|
const sourcePath = sourceDocs.get(relation.sourceId);
|
|
156
156
|
const sourceCell = sourcePath
|
|
157
157
|
? markdownLink(relation.sourceId, paths.generatedPath, sourcePath)
|
|
@@ -172,11 +172,15 @@ function generateDerivedItemsFile(paths, items) {
|
|
|
172
172
|
});
|
|
173
173
|
const table = [
|
|
174
174
|
"<!-- prettier-ignore -->",
|
|
175
|
-
|
|
175
|
+
relationField === "dependsOn"
|
|
176
|
+
? "| 先行項目 | 後続項目 | 分類 | ステータス | タイトル |"
|
|
177
|
+
: "| 元の項目 | 派生先 | 分類 | ステータス | タイトル |",
|
|
176
178
|
"| --- | --- | --- | --- | --- |",
|
|
177
179
|
...rows,
|
|
178
180
|
].join("\n");
|
|
179
|
-
const template = loadViewTemplate("
|
|
181
|
+
const template = loadViewTemplate(relationField === "dependsOn"
|
|
182
|
+
? "pjr-dependent-items-template.md"
|
|
183
|
+
: "pjr-derived-items-template.md", paths.projectId);
|
|
180
184
|
return injectViewSlots(template, { "derived-items": table });
|
|
181
185
|
}
|
|
182
186
|
function generateTypeFilterView(items, type, templateFileName, projectId, heading) {
|
|
@@ -186,6 +190,47 @@ function generateTypeFilterView(items, type, templateFileName, projectId, headin
|
|
|
186
190
|
table: ["<!-- prettier-ignore -->", makeTable(filtered, heading)].join("\n"),
|
|
187
191
|
});
|
|
188
192
|
}
|
|
193
|
+
function generateEpicItemsFile(paths, items) {
|
|
194
|
+
const relations = collectDerivedRegisterRelations(paths, items);
|
|
195
|
+
const groups = items
|
|
196
|
+
.filter((view) => view.item.type === "epic")
|
|
197
|
+
.map((epic, index) => {
|
|
198
|
+
const label = epic.ticketPath
|
|
199
|
+
? markdownLink(epic.id, paths.generatedPath, epic.ticketPath)
|
|
200
|
+
: epic.id;
|
|
201
|
+
const children = relations.filter((relation) => relation.sourceId === epic.id);
|
|
202
|
+
const rows = children.map((child) => {
|
|
203
|
+
const id = child.derivedProjectId === paths.projectId
|
|
204
|
+
? child.derivedItem.id
|
|
205
|
+
: `${child.derivedProjectId}:${child.derivedItem.id}`;
|
|
206
|
+
return `| ${[
|
|
207
|
+
markdownLink(id, paths.generatedPath, child.derivedTicketPath),
|
|
208
|
+
child.derivedItem.type,
|
|
209
|
+
child.derivedItem.status,
|
|
210
|
+
child.derivedItem.title,
|
|
211
|
+
]
|
|
212
|
+
.map(toCell)
|
|
213
|
+
.join(" | ")} |`;
|
|
214
|
+
});
|
|
215
|
+
return [
|
|
216
|
+
`### 1.${index + 1}. ${label} ${toCell(epic.item.title)}`,
|
|
217
|
+
"",
|
|
218
|
+
`track: ${toCell(epic.item.track ?? "-")} / ステータス: ${toCell(epic.item.status)}`,
|
|
219
|
+
"",
|
|
220
|
+
...(rows.length === 0
|
|
221
|
+
? ["子項目なし"]
|
|
222
|
+
: [
|
|
223
|
+
"<!-- prettier-ignore -->",
|
|
224
|
+
"| 子項目 | 分類 | ステータス | タイトル |",
|
|
225
|
+
"| --- | --- | --- | --- |",
|
|
226
|
+
...rows,
|
|
227
|
+
]),
|
|
228
|
+
].join("\n");
|
|
229
|
+
});
|
|
230
|
+
return injectViewSlots(loadViewTemplate("pjr-epic-items-template.md", paths.projectId), {
|
|
231
|
+
"epic-items": groups.join("\n\n") || "該当なし",
|
|
232
|
+
});
|
|
233
|
+
}
|
|
189
234
|
export const VALID_BUILD_SCOPES = ["register", "controls", "all"];
|
|
190
235
|
export function generateDerivedViewFiles(paths, scope) {
|
|
191
236
|
// 項目の値は個票 frontmatter(正本)から集める。列見出しは template から採用するため、
|
|
@@ -220,6 +265,12 @@ export function generateDerivedViewFiles(paths, scope) {
|
|
|
220
265
|
}, {
|
|
221
266
|
path: join(paths.generatedPath, "pjr-derived-items.md"),
|
|
222
267
|
content: generateDerivedItemsFile(paths, itemViews),
|
|
268
|
+
}, {
|
|
269
|
+
path: join(paths.generatedPath, "pjr-dependent-items.md"),
|
|
270
|
+
content: generateDerivedItemsFile(paths, itemViews, "dependsOn"),
|
|
271
|
+
}, {
|
|
272
|
+
path: join(paths.generatedPath, "pjr-epic-items.md"),
|
|
273
|
+
content: generateEpicItemsFile(paths, itemViews),
|
|
223
274
|
});
|
|
224
275
|
}
|
|
225
276
|
if (scope === "controls" || scope === "all") {
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { dirname, join, relative, resolve, sep } from "node:path";
|
|
2
2
|
import { existsSync, readdirSync, writeFileSync } from "node:fs";
|
|
3
3
|
import { dump } from "../shared/yaml.js";
|
|
4
|
-
import { getProjectCatalogPath, getProjectRolesPath, getProjectSchedulePath, getProjectTimelinePath, loadConfig, loadEnv, loadMemberRoster, specdojoRootDir, } from "../shared/specdojo-config.js";
|
|
4
|
+
import { getProjectCatalogPath, getProjectRolesPath, getProjectSchedulePath, getProjectTimelinePath, getProjectRegisterPath, loadConfig, loadEnv, loadMemberRoster, specdojoRootDir, } from "../shared/specdojo-config.js";
|
|
5
5
|
import { buildScheduleTrack, } from "./build.js";
|
|
6
6
|
import { readYaml } from "../shared/fs.js";
|
|
7
7
|
import { resolveSpecdojoPath } from "../docs/template-resolution.js";
|
|
@@ -255,11 +255,13 @@ function registerScheduleStrategyCommands(sch) {
|
|
|
255
255
|
if (!context.catalogPath) {
|
|
256
256
|
throw new Error(`catalog_path not set for project '${context.projectId}'.`);
|
|
257
257
|
}
|
|
258
|
+
const registerPath = getProjectRegisterPath(context.project);
|
|
258
259
|
const result = generateStrategy({
|
|
259
260
|
repoRoot: context.baseDir,
|
|
260
261
|
schedulePath: context.schedulePath,
|
|
261
262
|
catalogPath: context.catalogPath,
|
|
262
263
|
timelinePath: context.timelinePath,
|
|
264
|
+
...(registerPath ? { registerPath: resolve(context.baseDir, registerPath) } : {}),
|
|
263
265
|
...(context.rolesPath ? { rolesPath: context.rolesPath } : {}),
|
|
264
266
|
projectId: context.projectId,
|
|
265
267
|
track,
|
|
@@ -5,6 +5,7 @@ import { resolveBasePath } from "../catalog/paths.js";
|
|
|
5
5
|
import { collectCatalogFilesByDomain } from "../shared/catalog-files.js";
|
|
6
6
|
import { readYaml } from "../shared/fs.js";
|
|
7
7
|
import { loadTimelineIndex } from "../shared/timeline-index.js";
|
|
8
|
+
import { resolveTimelineCatalogStatus } from "../register/catalog-status.js";
|
|
8
9
|
export function isRecord(value) {
|
|
9
10
|
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
10
11
|
}
|
|
@@ -44,6 +45,9 @@ export function resolveTrackScopeCatalogs(opts) {
|
|
|
44
45
|
const indexFile = join(timelinePath, "tml-index.yaml");
|
|
45
46
|
if (existsSync(indexFile)) {
|
|
46
47
|
const { index, errors: loadErrors } = loadTimelineIndex(indexFile);
|
|
48
|
+
const derived = resolveTimelineCatalogStatus(index.tracks, opts.registerPath);
|
|
49
|
+
index.tracks = derived.tracks;
|
|
50
|
+
warnings.push(...derived.warnings);
|
|
47
51
|
if (loadErrors.length > 0) {
|
|
48
52
|
warnings.push(`${basename(indexFile)}: ${loadErrors.join(" / ")}`);
|
|
49
53
|
}
|
|
@@ -63,7 +67,7 @@ export function resolveTrackScopeCatalogs(opts) {
|
|
|
63
67
|
}
|
|
64
68
|
if (plan.catalog_status !== "primary") {
|
|
65
69
|
warnings.push(`timeline: track '${track}' の catalog_status は '${plan.catalog_status}'。` +
|
|
66
|
-
|
|
70
|
+
`カタログ作成 todo の完了を確認して timeline build を実行する。todo がない domain は手書きの計画値を使う。`);
|
|
67
71
|
}
|
|
68
72
|
}
|
|
69
73
|
else {
|
|
@@ -250,7 +250,7 @@ export const STRATEGY_PROFILES = {
|
|
|
250
250
|
};
|
|
251
251
|
export function profileFor(approach) {
|
|
252
252
|
if (!(approach in STRATEGY_PROFILES)) {
|
|
253
|
-
throw new Error(`Approach "${approach}" has no schedule strategy profile; kata authoring approaches are register-only`);
|
|
253
|
+
throw new Error(`Approach "${approach}" has no schedule strategy profile; kata authoring and planning approaches are register-only`);
|
|
254
254
|
}
|
|
255
255
|
return STRATEGY_PROFILES[approach];
|
|
256
256
|
}
|
|
@@ -7,11 +7,14 @@
|
|
|
7
7
|
// cross-deliverable-dedup は明示した成果物群を横断して正本を選び、重複を要約と参照へ置換する。
|
|
8
8
|
// finalize は human が成果物のみを最終確認して status を ready へ確定する進め方、
|
|
9
9
|
// bootstrap-finalize は bootstrap と対になり、成果物と参考資料一式をまとめて確定する進め方。
|
|
10
|
+
// catalog-planning / strategy-planning は register の domain / track 単位で計画を生成する。
|
|
10
11
|
export const APPROACHES = [
|
|
11
12
|
"fully-guided",
|
|
12
13
|
"recipe-guided",
|
|
13
14
|
"freeform",
|
|
14
15
|
"bootstrap",
|
|
16
|
+
"catalog-planning",
|
|
17
|
+
"strategy-planning",
|
|
15
18
|
"rulebook-authoring",
|
|
16
19
|
"recipe-authoring",
|
|
17
20
|
"sample-authoring",
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
import { createHash } from "node:crypto";
|
|
2
|
-
import { existsSync, readFileSync } from "node:fs";
|
|
3
|
-
import { join, resolve } from "node:path";
|
|
2
|
+
import { existsSync, readFileSync, realpathSync } from "node:fs";
|
|
3
|
+
import { isAbsolute, join, relative, resolve, sep } from "node:path";
|
|
4
4
|
import { load } from "./yaml.js";
|
|
5
|
-
import { getProjectExecutionPath, loadConfig, specdojoRootDir } from "./specdojo-config.js";
|
|
5
|
+
import { getProjectExecutionPath, loadConfig, resolveRepoRoot, specdojoRootDir, } from "./specdojo-config.js";
|
|
6
6
|
const DOCUMENT_ID_RE = /^[a-z0-9][a-z0-9-:]*$/;
|
|
7
7
|
export const SEVERITIES = ["blocker", "major", "minor", "note"];
|
|
8
8
|
function isRecord(value) {
|
|
@@ -24,7 +24,7 @@ export function markdownDocumentId(content, path) {
|
|
|
24
24
|
return id;
|
|
25
25
|
}
|
|
26
26
|
export function resolveGradeResultsDirectory(projectOption, rootDir = specdojoRootDir()) {
|
|
27
|
-
const { config } = loadConfig();
|
|
27
|
+
const { config } = loadConfig(rootDir);
|
|
28
28
|
if (!config)
|
|
29
29
|
throw new Error("grade commands require .specdojo/specdojo.config.json");
|
|
30
30
|
const projectId = projectOption?.trim() || config.current_project || Object.keys(config.projects)[0] || "";
|
|
@@ -48,7 +48,25 @@ export function gradeResultPathForDocument(opts) {
|
|
|
48
48
|
const rootDir = opts.rootDir ?? specdojoRootDir();
|
|
49
49
|
const absolute = resolve(rootDir, opts.documentPath);
|
|
50
50
|
const content = readFileSync(absolute, "utf8");
|
|
51
|
-
|
|
51
|
+
const { config } = loadConfig(rootDir);
|
|
52
|
+
const projectId = opts.project?.trim() || config?.current_project || Object.keys(config?.projects ?? {})[0];
|
|
53
|
+
const project = projectId ? config?.projects[projectId] : undefined;
|
|
54
|
+
const documentRealPath = realpathSync(absolute);
|
|
55
|
+
// 宣言済み repo の実体で判定し、相対・絶対パスや worktree の配置によらず同じ場所を使う。
|
|
56
|
+
const repo = (project?.repos ?? [])
|
|
57
|
+
.map((entry) => {
|
|
58
|
+
const root = resolveRepoRoot(rootDir, entry);
|
|
59
|
+
return { name: entry.name, root: existsSync(root) ? realpathSync(root) : root };
|
|
60
|
+
})
|
|
61
|
+
.sort((a, b) => b.root.length - a.root.length)
|
|
62
|
+
.find(({ root }) => {
|
|
63
|
+
const rel = relative(root, documentRealPath);
|
|
64
|
+
return rel !== ".." && !rel.startsWith(`..${sep}`) && !isAbsolute(rel);
|
|
65
|
+
});
|
|
66
|
+
const resultsDirectory = opts.resultsDirectory
|
|
67
|
+
? resolve(rootDir, opts.resultsDirectory)
|
|
68
|
+
: resolveGradeResultsDirectory(opts.project, rootDir);
|
|
69
|
+
return gradeResultPath(repo ? join(resultsDirectory, repo.name) : resultsDirectory, markdownDocumentId(content, opts.documentPath));
|
|
52
70
|
}
|
|
53
71
|
export function parseGradeResult(content, path) {
|
|
54
72
|
const parsed = load(content);
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
import { existsSync, readdirSync, writeFileSync } from "node:fs";
|
|
2
|
+
import { dirname, join } from "node:path";
|
|
3
|
+
import { dump } from "js-yaml";
|
|
4
|
+
// Keep the fallback result check and every scaffold on the same document rules.
|
|
5
|
+
export const DEFAULT_MARKDOWNLINT_CONFIG = {
|
|
6
|
+
MD013: false,
|
|
7
|
+
MD024: false,
|
|
8
|
+
MD033: false,
|
|
9
|
+
MD036: false,
|
|
10
|
+
MD041: false,
|
|
11
|
+
MD060: false,
|
|
12
|
+
};
|
|
13
|
+
// These are the project files read by markdownlint-cli (CLI2 uses a separate config).
|
|
14
|
+
export function hasMarkdownlintConfig(repoRoot) {
|
|
15
|
+
if (["jsonc", "json", "yaml", "yml"].some((ext) => existsSync(join(repoRoot, `.markdownlint.${ext}`))))
|
|
16
|
+
return true;
|
|
17
|
+
// markdownlint-cli also discovers .markdownlintrc in parent directories.
|
|
18
|
+
for (let dir = repoRoot;; dir = dirname(dir)) {
|
|
19
|
+
if (existsSync(join(dir, ".markdownlintrc")))
|
|
20
|
+
return true;
|
|
21
|
+
if (dirname(dir) === dir)
|
|
22
|
+
return false;
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
export function ensureMarkdownlintConfig(repoRoot, dryRun) {
|
|
26
|
+
const hasExistingConfig = readdirSync(repoRoot).some((file) => file.startsWith(".markdownlint.") || file.startsWith(".markdownlint-cli2."));
|
|
27
|
+
if (hasMarkdownlintConfig(repoRoot) || hasExistingConfig) {
|
|
28
|
+
process.stdout.write("Kept existing markdownlint settings.\n");
|
|
29
|
+
return;
|
|
30
|
+
}
|
|
31
|
+
const content = dump(DEFAULT_MARKDOWNLINT_CONFIG);
|
|
32
|
+
if (dryRun) {
|
|
33
|
+
process.stdout.write(`[dry-run] would write: .markdownlint.yaml\n${content}`);
|
|
34
|
+
return;
|
|
35
|
+
}
|
|
36
|
+
writeFileSync(join(repoRoot, ".markdownlint.yaml"), content, { encoding: "utf8", flag: "wx" });
|
|
37
|
+
process.stdout.write("Written: .markdownlint.yaml\n");
|
|
38
|
+
}
|
|
@@ -2,14 +2,7 @@ import { existsSync } from "node:fs";
|
|
|
2
2
|
import { readdir, writeFile } from "node:fs/promises";
|
|
3
3
|
import path from "node:path";
|
|
4
4
|
import { dump } from "js-yaml";
|
|
5
|
-
|
|
6
|
-
MD013: false,
|
|
7
|
-
MD024: false,
|
|
8
|
-
MD033: false,
|
|
9
|
-
MD036: false,
|
|
10
|
-
MD041: false,
|
|
11
|
-
MD060: false,
|
|
12
|
-
};
|
|
5
|
+
import { DEFAULT_MARKDOWNLINT_CONFIG } from "./markdownlint-config.js";
|
|
13
6
|
// Slide boundaries and per-slide frontmatter interrupt normal Markdown blocks.
|
|
14
7
|
// Each slide may start with its own H1 or use a heading level chosen for its layout.
|
|
15
8
|
const SLIDEV_CONFIG = {
|
|
@@ -24,7 +17,7 @@ export async function writeMarkdownlintConfigs(opts) {
|
|
|
24
17
|
const legacyConfigs = files.filter((file) => file.startsWith(".markdownlint."));
|
|
25
18
|
const cli2Configs = files.filter((file) => file.startsWith(".markdownlint-cli2."));
|
|
26
19
|
const hasRc = existsSync(path.join(opts.repoRoot, ".markdownlintrc"));
|
|
27
|
-
const rcContent = `${JSON.stringify(
|
|
20
|
+
const rcContent = `${JSON.stringify(DEFAULT_MARKDOWNLINT_CONFIG, null, 2)}\n`;
|
|
28
21
|
const cli2Content = dump({
|
|
29
22
|
config: { extends: ".markdownlintrc" },
|
|
30
23
|
...(opts.slidevKataPatterns?.length
|
|
@@ -6,6 +6,7 @@ import Ajv2020Module from "ajv/dist/2020.js";
|
|
|
6
6
|
import { runProviderScaffold, specdojoPackageRootDir } from "./provider-scaffold.js";
|
|
7
7
|
import { runWorkspaceScaffold } from "./workspace-scaffold.js";
|
|
8
8
|
import { runLefthookScaffold } from "./lefthook-scaffold.js";
|
|
9
|
+
import { ensureMarkdownlintConfig } from "./markdownlint-config.js";
|
|
9
10
|
import { runSlidevScaffold, SLIDEV_KATA_PATTERNS } from "./slidev-scaffold.js";
|
|
10
11
|
import { ensureGitignore, formatGitignoreReport, gitignorePatternsForLayouts, } from "./specdojo-gitignore.js";
|
|
11
12
|
/** Default IANA time zone for register date derivation when run.register_date_timezone is unset. */
|
|
@@ -254,7 +255,7 @@ export function getProjectRepos(project) {
|
|
|
254
255
|
function isRecord(value) {
|
|
255
256
|
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
256
257
|
}
|
|
257
|
-
const REPO_KEYS = new Set(["name", "path", "integration_branch", "setup"]);
|
|
258
|
+
const REPO_KEYS = new Set(["name", "path", "integration_branch", "integration_strategy", "setup"]);
|
|
258
259
|
const REPO_SETUP_KEYS = new Set(["install", "build"]);
|
|
259
260
|
const EXTERNAL_PROJECT_KEYS = new Set(["path", "project_id"]);
|
|
260
261
|
/** Resolve a configured external-project repository from the SpecDojo root. */
|
|
@@ -381,6 +382,11 @@ export function validateProjectRepos(projectId, project, projectIds, rootDir) {
|
|
|
381
382
|
!isOmittedOrNonEmptyString(repo.integration_branch)) {
|
|
382
383
|
errors.push(`${at}.integration_branch must be a non-empty string when present`);
|
|
383
384
|
}
|
|
385
|
+
if (repo.integration_strategy !== undefined &&
|
|
386
|
+
repo.integration_strategy !== "merge" &&
|
|
387
|
+
repo.integration_strategy !== "branch-only") {
|
|
388
|
+
errors.push(`${at}.integration_strategy must be "merge" or "branch-only" when present`);
|
|
389
|
+
}
|
|
384
390
|
const setup = repo.setup;
|
|
385
391
|
if (setup !== undefined) {
|
|
386
392
|
if (!isRecord(setup)) {
|
|
@@ -727,11 +733,12 @@ export function registerConfigCommands(program) {
|
|
|
727
733
|
cfg
|
|
728
734
|
.command("init")
|
|
729
735
|
.description("Create .specdojo/specdojo.config.json template (does not overwrite existing) " +
|
|
730
|
-
"and
|
|
731
|
-
.option("--dry-run", "Show the planned config
|
|
736
|
+
"and initialize .gitignore and markdownlint settings")
|
|
737
|
+
.option("--dry-run", "Show the planned config, .gitignore and markdownlint settings without writing", false)
|
|
732
738
|
.action((opts) => {
|
|
733
739
|
const dryRun = !!opts.dryRun;
|
|
734
740
|
const { configPath, config } = loadConfig();
|
|
741
|
+
ensureMarkdownlintConfig(specdojoRootDir(), dryRun);
|
|
735
742
|
if (config) {
|
|
736
743
|
process.stdout.write(`Already exists: ${configPath}\n`);
|
|
737
744
|
writeGitignoreForConfig(config, dryRun);
|
|
@@ -10,6 +10,10 @@ export const DEFAULT_GITIGNORE_PATTERNS = [
|
|
|
10
10
|
"docs/**/generated/*",
|
|
11
11
|
"!docs/**/generated/.gitkeep",
|
|
12
12
|
"docs/**/execution/exec/.locks/",
|
|
13
|
+
"/.vitepress/dist/",
|
|
14
|
+
"/.vitepress/cache/",
|
|
15
|
+
"/.vitepress/mermaid/",
|
|
16
|
+
"/.vitepress/kata-staging/",
|
|
13
17
|
];
|
|
14
18
|
// repo-root 相対の posix パスへ正規化する。リポジトリ外(絶対パス・`..`)や root 自身は
|
|
15
19
|
// 除外対象にできないため undefined を返す。
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
_FRONTMATTER_
|
|
2
|
+
|
|
3
|
+
# Edit Plan: _TASK_ID_ カタログの判定計画と生成
|
|
4
|
+
|
|
5
|
+
## 1. このフェーズで行うこと
|
|
6
|
+
|
|
7
|
+
_PHASE_DESCRIPTION_
|
|
8
|
+
|
|
9
|
+
対象単位・参照資料・実行コマンド・完了条件は「個票の追加完了条件」に展開する。
|
|
10
|
+
|
|
11
|
+
- result: `_RESULT_REF_`
|
|
12
|
+
|
|
13
|
+
## 2. 完了手順
|
|
14
|
+
|
|
15
|
+
1. 参照する kata・既存カタログと個票を読み、追加完了条件の手順を実行する。
|
|
16
|
+
2. 共通規約に従って必要な整形・静的検査を行う。
|
|
17
|
+
3. 個票の作業内容・対応結果を更新し、実行記録に判断根拠・変更ファイル・検証結果を残す。pipeline の executor は result を編集せず報告へ記入する。
|
|
18
|
+
|
|
19
|
+
## 3. 異常終了の条件
|
|
20
|
+
|
|
21
|
+
- 入力不足、対象不明、解消できない判定事項、生成・検査失敗があれば停止し、理由と次のアクションを報告する。
|
|
22
|
+
- 登録簿と個票のステータスを変更しない。
|
|
23
|
+
|
|
24
|
+
_COMMON_CONVENTIONS_
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
_FRONTMATTER_
|
|
2
|
+
|
|
3
|
+
# Edit Plan: _TASK_ID_ Schedule strategy と track の生成
|
|
4
|
+
|
|
5
|
+
## 1. このフェーズで行うこと
|
|
6
|
+
|
|
7
|
+
_PHASE_DESCRIPTION_
|
|
8
|
+
|
|
9
|
+
対象単位・参照資料・実行コマンド・完了条件は「個票の追加完了条件」に展開する。
|
|
10
|
+
|
|
11
|
+
- result: `_RESULT_REF_`
|
|
12
|
+
|
|
13
|
+
## 2. 完了手順
|
|
14
|
+
|
|
15
|
+
1. 参照する kata・既存カタログと個票を読み、追加完了条件の手順を実行する。
|
|
16
|
+
2. 共通規約に従って必要な整形・静的検査を行う。
|
|
17
|
+
3. 個票の作業内容・対応結果を更新し、実行記録に判断根拠・変更ファイル・検証結果を残す。pipeline の executor は result を編集せず報告へ記入する。
|
|
18
|
+
|
|
19
|
+
## 3. 異常終了の条件
|
|
20
|
+
|
|
21
|
+
- 入力不足、対象不明、解消できない判定事項、生成・検査失敗があれば停止し、理由と次のアクションを報告する。
|
|
22
|
+
- 登録簿と個票のステータスを変更しない。
|
|
23
|
+
|
|
24
|
+
_COMMON_CONVENTIONS_
|
|
@@ -336,7 +336,20 @@ npm install --save-dev @specdojo/docs-site
|
|
|
336
336
|
npx specdojo-docs-site build .
|
|
337
337
|
```
|
|
338
338
|
|
|
339
|
-
開発サーバは `npx specdojo-docs-site dev .` で起動します。`build` と `dev`
|
|
339
|
+
開発サーバは `npx specdojo-docs-site dev .` で起動します。`build` と `dev` は、利用リポジトリの `docs/` と package 同梱の kata・guide・reference を `.vitepress/kata-staging/docs/` に重ねた閲覧用ツリーを作り、`/ja/specdojo/` で配信します。eject 済みの文書は利用リポジトリ側を優先し、`dev` 中の編集・追加・削除も同期するため、サイト表示のために `kata install --all` を実行する必要はありません。ページ走査のルートをこのツリーに限定し、`.vitepress/dist` や cache、利用者の設定ファイルはページに含めません。
|
|
340
|
+
|
|
341
|
+
Mermaid SVG の生成だけを行う場合は `npx specdojo-docs-site mermaid .` を使います。SVG と manifest は `.vitepress/mermaid/`、サイトの build 結果は `.vitepress/dist/`、cache は `.vitepress/cache/` に置きます。図の公開 URL は `/mermaid/<hash>.svg` を維持し、利用者の `public/` のファイルも従来どおり配信します。
|
|
342
|
+
|
|
343
|
+
`specdojo config init` は `.gitignore` の既存の内容を保持して、次の生成ディレクトリだけを除外します。既存のリポジトリでは再実行するか、手動で追記してください。`.vitepress/` 全体を除外せず、利用者の設定ファイルは Git 管理対象に残します。
|
|
344
|
+
|
|
345
|
+
```text
|
|
346
|
+
/.vitepress/dist/
|
|
347
|
+
/.vitepress/cache/
|
|
348
|
+
/.vitepress/mermaid/
|
|
349
|
+
/.vitepress/kata-staging/
|
|
350
|
+
```
|
|
351
|
+
|
|
352
|
+
旧配置の `public/mermaid/` と `specdojo-kata-staging/` は自動で削除しません。移行時は内容を確認し、不要な生成物だけを手動で片付けてください。
|
|
340
353
|
|
|
341
354
|
### 6.1. Mermaid 図を組み立てる
|
|
342
355
|
|
|
@@ -527,13 +527,15 @@ app1-specdojo-worktrees/
|
|
|
527
527
|
|
|
528
528
|
統合は次の順序で行います。
|
|
529
529
|
|
|
530
|
-
1. 全リポジトリで commit 対象を commit し、merge
|
|
531
|
-
2.
|
|
532
|
-
3.
|
|
530
|
+
1. 全リポジトリで commit 対象を commit し、merge するリポジトリでは merge 可否、`branch-only` では exec worktree に未 commit の変更が無いことを事前に検査する。1つでも検査に失敗したリポジトリがあれば、どのリポジトリも統合しない。
|
|
531
|
+
2. 宣言順にプロダクトを処理する。`repos[].integration_strategy` が `merge`(既定)の場合は exec branch を統合先ブランチへ merge commit で統合し、`branch-only` の場合は merge せず exec branch を保持する。プロダクト側の commit と merge commit には `Refs: <project-id>:<item-id>` を付ける(register 項目の場合)。
|
|
532
|
+
3. プロダクトの trace key、exec branch 名、状態、統合先の commit snapshot を、プロジェクト側の result 本文へ記録する(register 項目の場合)。`branch-only` は未統合と明示し、統合先の snapshot と PR は `not applicable` とする。
|
|
533
533
|
4. プロジェクトの exec branch を `app1-specdojo/` の統合先ブランチへ統合する。
|
|
534
|
-
5.
|
|
534
|
+
5. 処理成功後に全リポジトリの worktree を撤去する。`merge` の exec branch とプロジェクトの exec branch は削除し、`branch-only` の exec branch は変更の有無によらず残す。
|
|
535
535
|
|
|
536
|
-
|
|
536
|
+
ソースを先に処理することで、プロダクトの処理を SpecDojo 側の統合成否から切り離します。プロジェクト側の記帳(`review` への遷移と result)は、全プロダクトが merge 済み・変更なし・`branch-only` の保持のいずれかになった後に統合先へ入ります。`review` は SpecDojo のタスク成果を確認する段階であり、プロダクト側の PR が merge 済みであることを意味しません。
|
|
537
|
+
|
|
538
|
+
PR レビューを必須にするプロダクトは、[[specdojo:specdojo-config-reference|設定リファレンス]] の `repos` で `"integration_strategy": "branch-only"` を選びます。統合先への merge 可否や統合先 checkout の未 commit 変更は、そのリポジトリの事前検査を妨げません。runner は push と PR 作成(`gh` を含む)を実装せず、利用者が必要な承認のもと、保持された branch を push してプロダクト側で PR を作ります。squash merge では `Refs:` を commit メッセージに残してください。未統合の branch は `exec worktree prune` でも削除しません。同じ項目を新規実行する際に保持済み branch があると停止するため、既存 run を再開するか、プロダクト側の作業を終えて branch を退避・削除します。
|
|
537
539
|
|
|
538
540
|
### 10.7. 複数リポジトリの統合の失敗と再開
|
|
539
541
|
|
|
@@ -545,10 +547,10 @@ app1-specdojo-worktrees/
|
|
|
545
547
|
| n 番目のプロダクトの統合 | 1〜n-1 番目のプロダクトだけ統合済み | 項目を `waiting` とし、統合済みのプロダクトを飛ばして n 番目から再開する |
|
|
546
548
|
| プロジェクトの統合 | 全プロダクトが統合済み、プロジェクトは未統合 | 項目を `waiting` とし、プロダクトを再統合せずプロジェクトの統合だけ再開する |
|
|
547
549
|
|
|
548
|
-
- リポジトリ別の状態(`pending` / `merged` / `unchanged` / `failed`)は、run の `pipeline-state.json` の `stages.integrate.repos` に記録します。失敗の詳細は同じ run の `integrate.log` に残ります。
|
|
550
|
+
- リポジトリ別の状態(`pending` / `merged` / `unchanged` / `branch-only` / `failed`)は、run の `pipeline-state.json` の `stages.integrate.repos` に記録します。失敗の詳細は同じ run の `integrate.log` に残ります。
|
|
549
551
|
- `block_reason` には、失敗したリポジトリ、統合済みのリポジトリ、未統合のリポジトリを記録します。
|
|
550
552
|
- 失敗後も全リポジトリの worktree と exec branch を保持します。原因を解消した後、`exec run --register <item-id> --worktree --resume` で統合段から再開します。agent は再実行しません。
|
|
551
|
-
- 再開の前に、runner は未統合のリポジトリにだけ統合先の最新を取り込みます。`stages.integrate.repos` で統合済み(`merged` / `unchanged
|
|
553
|
+
- 再開の前に、runner は未統合のリポジトリにだけ統合先の最新を取り込みます。`stages.integrate.repos` で統合済み(`merged` / `unchanged`)または方式が `branch-only` のプロダクトは取り込まず、exec branch に merge commit を作りません。
|
|
552
554
|
- 再開時は、統合先へ取り込み済みのプロダクトを merge し直さず、最初の統合で作った merge commit を result の trace 表へ記録します。
|
|
553
555
|
|
|
554
|
-
|
|
556
|
+
`branch-only` の保持はそのリポジトリの処理完了とします。これを除き、一部のリポジトリだけが統合済みの状態は完了ではないため、`review` へ進めません。統合を打ち切る場合、統合済みのプロダクトの変更を残すか revert するかは、通常の統合後の判断として人が決めます。自動的に履歴を巻き戻しません。
|
|
@@ -43,25 +43,26 @@ exec が扱う関心事、タスクの出どころによる実行経路の選び
|
|
|
43
43
|
|
|
44
44
|
### 1.2. 実行経路の使い分け
|
|
45
45
|
|
|
46
|
-
agent
|
|
47
|
-
|
|
48
|
-
| 観点 |
|
|
49
|
-
| ------------ |
|
|
50
|
-
|
|
|
51
|
-
|
|
|
52
|
-
|
|
|
53
|
-
|
|
|
54
|
-
|
|
|
55
|
-
|
|
|
56
|
-
|
|
|
46
|
+
agent にタスクを実行させる経路には、業務の起点・着手承認・完了判断を担う register と、成果物カタログに基づく途中の進み具合を担う schedule があります。両者は同格の 2 経路ではなく、register を親、schedule を子とする階層関係にあります。routine はそれらを時刻条件で発火させるトリガー層で、それ自体は実行機構を持ちません。「何を実行するか」(register の項目 / schedule のタスク)と「いつ実行するか」(人が起動する / routine が定期起動する)は独立に選べます。
|
|
47
|
+
|
|
48
|
+
| 観点 | register 実行(親: 起点・承認・完了) | schedule 実行(子: 途中の進捗・依存実行) | routine(トリガー層) |
|
|
49
|
+
| ------------ | --------------------------------------------------------------------------- | ----------------------------------------- | ---------------------------------------- |
|
|
50
|
+
| 役割 | 業務の起点、着手承認、完了判断、単発の調査・対応 | 成果物の依存関係に基づく進捗管理・実行 | 定期起動・スケジューリング |
|
|
51
|
+
| 実行対象 | `generated/pjr-index.md` の項目(todo / issue / change-request 等) | `sch-track-*.yaml` のタスク(依存グラフ) | `rtn-*.yaml` の定義(実体は左の 2 経路) |
|
|
52
|
+
| 代表コマンド | `exec run --register` | `exec run --task` / `exec run --auto` | `routine run --due` |
|
|
53
|
+
| 起動 | 人、または routine(`job-register-sweep`) | 人、または routine(`job-exec-auto`) | 外部スケジューラ(cron / CI) |
|
|
54
|
+
| 状態追跡 | register の遷移(in-progress / review / waiting) | exec events(claim / complete / block) | `last_run` の記録のみ |
|
|
55
|
+
| 隔離 | `run.register_execution` または CLI で選択 | worktree(`--worktree` / `--auto`) | -(実行経路へ委譲) |
|
|
56
|
+
| 終端の扱い | 人が確認して `register close`(epic も人が判断) | `complete` event(human finalize で確定) | -(発火の記録のみ) |
|
|
57
|
+
| 典型用途 | 課題・判断、track の epic 起票、カタログ・strategy 計画、計画外の対応・調査 | 計画された成果物群の作成・レビュー・確定 | 日次スイープ・夜間バッチなどの定期実行 |
|
|
57
58
|
|
|
58
59
|
迷った場合は次で判断します。
|
|
59
60
|
|
|
60
|
-
-
|
|
61
|
-
-
|
|
62
|
-
-
|
|
61
|
+
- 業務の起点・着手承認・完了判断、未整理な課題や判断、単発の対応・調査、およびカタログや strategy の計画は register を使う(`register add` で登録し、agent 実行可能な type は `exec run --register`。まとまった仕事は track ごとに `epic` を起票する。手順は [登録簿運用ガイド](register-operation-guide.md))。
|
|
62
|
+
- `epic` のもとで成果物カタログと依存関係を展開し、途中の進み具合を管理しながら進める作業は schedule 実行を使う(`exec run --auto` / `--task`。手順は [Schedule実行運用ガイド](schedule-operation-guide.md))。
|
|
63
|
+
- 上記のいずれかを決まった時刻条件で繰り返したい場合は routine を使う(`rtn-*.yaml` を定義して外部スケジューラから `routine run --due` を呼ぶ。手順は [routine運用ガイド](routine-operation-guide.md))。
|
|
63
64
|
|
|
64
|
-
register 実行は exec events を記録しないため、schedule の Ready・CPM・phase gate
|
|
65
|
+
register 実行は exec events を記録しないため、schedule の Ready・CPM・phase gate には影響しません。まとまった仕事は track ごとに `epic` を起票し、その子 todo でカタログ作成(`catalog-planning`)や strategy 作成(`strategy-planning`)を進めて schedule へ展開します。途中の進み具合は schedule が持ち、トラック完了時に人が `epic` の完了を判断して close します。
|
|
65
66
|
|
|
66
67
|
登録の判断、type の選び方、個票の作成などの台帳運用は [登録簿運用ガイド](register-operation-guide.md) を参照します。
|
|
67
68
|
|
|
@@ -17,7 +17,7 @@ Orchestrator Operation Guide
|
|
|
17
17
|
|
|
18
18
|
**この文書で分かること**
|
|
19
19
|
|
|
20
|
-
-
|
|
20
|
+
- オーケストレーターの位置づけ、起動用スクリプト、VS Code からの使い方、対話フロー、承認と安全の扱い、設定ファイルの構成
|
|
21
21
|
|
|
22
22
|
**次に読む文書**
|
|
23
23
|
|
|
@@ -109,6 +109,24 @@ npx specdojo config scaffold --provider antigravity --global
|
|
|
109
109
|
|
|
110
110
|
分離環境が必要な場合は、追加の任意手順として `devcontainer scaffold` を利用できます。既存の `.devcontainer/` は上書きされず、provider の設定ディレクトリは名前付きボリュームへ保存されます。詳細は [CLIコマンドリファレンス](../references/command-reference.md) の `devcontainer` を参照してください。
|
|
111
111
|
|
|
112
|
+
### 2.2. VS Code から使う
|
|
113
|
+
|
|
114
|
+
VS Code の各種 AI 拡張機能からオーケストレーターを利用することもできます。拡張機能ごとの起動手順は次のとおりです。
|
|
115
|
+
|
|
116
|
+
- **GitHub Copilot Chat**:
|
|
117
|
+
`npx specdojo config scaffold --provider copilot` を実行して設定を配置した後、VS Code の Copilot Chat パネルで agent の選択肢から `specdojo-orchestrator` を選びます(`.github/agents/specdojo-orchestrator.md` が読み込まれます)。
|
|
118
|
+
- **Claude Code 拡張**:
|
|
119
|
+
設定(settings)の `agent` キーに `specdojo-orchestrator` を設定すると、セッションがオーケストレーターとして開始されます。共有の `.claude/settings.json` に書くとそのリポジトリを利用する全員のすべてのセッションが対象になるため、各自のローカル設定である `.claude/settings.local.json` に記述することを推奨します。
|
|
120
|
+
|
|
121
|
+
```json
|
|
122
|
+
{
|
|
123
|
+
"agent": "specdojo-orchestrator"
|
|
124
|
+
}
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
- **Codex 拡張**:
|
|
128
|
+
Codex の VS Code 拡張(`Codex – OpenAI's coding agent`)で名前付きの agent の定義を選ぶ仕組みは、公式の文書では確かめられていません(2026-10 時点で未確認)。そのため、会話開始時に SSOT である `.agents/specdojo-orchestrator.agent.md` の本文を最初の指示(プロンプト)として渡して対話を開始します。
|
|
129
|
+
|
|
112
130
|
## 3. 対話の進め方
|
|
113
131
|
|
|
114
132
|
オーケストレーターは「提案 → 承認 → 実行」を基本とします。
|
|
@@ -64,6 +64,8 @@ package の探索では `node_modules` 全体を再帰走査せず、resolver
|
|
|
64
64
|
|
|
65
65
|
template は記述する部分を _TODO_ などのプレースホルダとして配置した雛形で、内容が埋まった完成例である sample と役割を分担します。
|
|
66
66
|
|
|
67
|
+
sample は成果物として成り立つ完成例であり、template の `type: template` と異なり、見本にする成果物の type を持ちます。`type` と sample の識別の原則は [[specdojo:document-metadata-standard|ドキュメントメタ情報標準]] を正本とします。
|
|
68
|
+
|
|
67
69
|
ここでいう `reference` は文書種別です。exec plan が実行時に参照する実践の型(rulebook / recipe / sample / template)とは別の役割として扱います。
|
|
68
70
|
|
|
69
71
|
## 3. 種別間の関係と成果物への紐付け
|