specdojo 0.8.0 → 0.9.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 +4 -1
- package/CHANGELOG.md +64 -0
- package/dist/catalog/catalog.js +16 -14
- package/dist/commands/agent.js +5 -3
- package/dist/commands/build.js +69 -10
- package/dist/commands/git.js +206 -0
- package/dist/commands/init.js +4 -2
- package/dist/commands/where.js +25 -0
- package/dist/dashboard/dashboard.js +5 -3
- package/dist/dashboard/routines.js +4 -7
- package/dist/dashboard/timeline.js +14 -14
- package/dist/docs/index-command.js +2 -2
- package/dist/docs/yaml-business-tables.js +243 -0
- package/dist/docs/yaml-interface-tables.js +106 -0
- package/dist/docs/yaml-pages-command.js +5 -3
- package/dist/docs/yaml-pages.js +146 -3
- package/dist/docs/yaml-table-shared.js +70 -0
- package/dist/docs/yaml-tables.js +39 -0
- package/dist/exec/agent-config.js +9 -0
- package/dist/exec/agent-protected-config.js +2 -0
- package/dist/exec/commands.js +31 -18
- package/dist/exec/events.js +34 -14
- package/dist/exec/evidence.js +13 -3
- package/dist/exec/parent-validation.js +56 -3
- package/dist/exec/plans-core.js +21 -2
- package/dist/exec/plans-generation.js +6 -7
- package/dist/exec/post-integration.js +162 -0
- package/dist/exec/queue-command.js +166 -0
- package/dist/exec/queue.js +285 -0
- package/dist/exec/register-foreign-wait.js +84 -0
- package/dist/exec/repo-integration-sync.js +17 -5
- package/dist/exec/reporter.js +2 -2
- package/dist/exec/results.js +24 -4
- package/dist/exec/review-kata.js +4 -1
- package/dist/exec/run/agent-pipeline.js +3 -2
- package/dist/exec/run/agent.js +12 -6
- package/dist/exec/run/change-scope.js +365 -0
- package/dist/exec/run/deferred-cleanup.js +31 -0
- package/dist/exec/run/in-place.js +4 -1
- package/dist/exec/run/job-lock.js +66 -0
- package/dist/exec/run/job-sequence.js +137 -0
- package/dist/exec/run/job.js +56 -19
- package/dist/exec/run/lifecycle-commands.js +1 -1
- package/dist/exec/run/lock.js +22 -1
- package/dist/exec/run/register-command.js +8 -5
- package/dist/exec/run/register-mode.js +68 -8
- package/dist/exec/run/register-resume.js +68 -14
- package/dist/exec/run/register-state.js +13 -8
- package/dist/exec/run/register-worktree.js +140 -125
- package/dist/exec/run/schedule-mode.js +75 -14
- package/dist/exec/run/schedule-prepare.js +3 -0
- package/dist/exec/run/schedule-task.js +88 -38
- package/dist/exec/run/shared.js +5 -0
- package/dist/exec/schedule/schedule.js +116 -4
- package/dist/exec/shared.js +1 -1
- package/dist/exec/smoke.js +190 -0
- package/dist/exec/strategy.js +13 -3
- package/dist/exec/task-view.js +6 -4
- package/dist/exec/trial-commands.js +5 -2
- package/dist/exec/trial-core.js +6 -1
- package/dist/exec/validation-metrics.js +181 -0
- package/dist/exec/worktree-cleanup-lock.js +26 -0
- package/dist/exec/worktree-command.js +9 -1
- package/dist/exec/worktree-ops-commit.js +2 -2
- package/dist/exec/worktree.js +13 -2
- package/dist/grade/command-apply.js +3 -3
- package/dist/grade/command-inspect.js +5 -3
- package/dist/grade/command-plan.js +1 -1
- package/dist/grade/command-run.js +5 -1
- package/dist/grade/run.js +64 -8
- package/dist/job/definition.js +84 -8
- package/dist/job/job.js +79 -23
- package/dist/register/authoring-sources.js +22 -16
- package/dist/register/maintenance-commands.js +2 -2
- package/dist/register/register.js +31 -7
- package/dist/routine/definition.js +9 -0
- package/dist/routine/routine.js +137 -43
- package/dist/routine/status.js +62 -0
- package/dist/schedule/schedule.js +38 -39
- package/dist/shared/agent-types.js +5 -0
- package/dist/shared/cross-process-lock.js +9 -1
- package/dist/shared/dist-freshness.js +8 -2
- package/dist/shared/git-environment.js +2 -1
- package/dist/shared/git.js +44 -1
- package/dist/shared/lefthook-scaffold.js +3 -0
- package/dist/shared/local-config.js +244 -0
- package/dist/shared/specdojo-config.js +34 -20
- package/dist/shared/specdojo-gitignore.js +1 -0
- package/dist/shared/text.js +9 -1
- package/dist/shared/where-alias.js +13 -0
- package/dist/specdojo.js +4 -0
- package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +2 -0
- package/docs/ja/specdojo/guides/exec-config-guide.md +23 -4
- package/docs/ja/specdojo/guides/exec-operation-guide.md +44 -1
- package/docs/ja/specdojo/guides/job-sequence-guide.md +77 -0
- package/docs/ja/specdojo/guides/quick-start-guide.md +3 -3
- package/docs/ja/specdojo/guides/register-operation-guide.md +1 -1
- package/docs/ja/specdojo/guides/routine-operation-guide.md +11 -6
- package/docs/ja/specdojo/guides/schedule-design-guide.md +20 -17
- package/docs/ja/specdojo/guides/waza-guide.md +12 -8
- package/docs/ja/specdojo/recipes/bac-recipe.md +66 -49
- package/docs/ja/specdojo/recipes/bes-recipe.md +90 -54
- package/docs/ja/specdojo/recipes/bps-recipe.md +88 -139
- package/docs/ja/specdojo/recipes/br-recipe.md +40 -47
- package/docs/ja/specdojo/recipes/cdfd-overview-recipe.md +97 -109
- package/docs/ja/specdojo/recipes/cdfd-recipe.md +85 -146
- package/docs/ja/specdojo/recipes/cdfd-uc-recipe.md +91 -110
- package/docs/ja/specdojo/recipes/cnd-recipe.md +79 -69
- package/docs/ja/specdojo/recipes/cpd-recipe.md +78 -64
- package/docs/ja/specdojo/recipes/cxd-recipe.md +92 -75
- package/docs/ja/specdojo/recipes/ifd-recipe.md +79 -68
- package/docs/ja/specdojo/recipes/ifx-cmd-recipe.md +78 -105
- package/docs/ja/specdojo/recipes/ifx-index-recipe.md +105 -71
- package/docs/ja/specdojo/recipes/pm-communication-plan-recipe.md +60 -49
- package/docs/ja/specdojo/recipes/pm-members-recipe.md +50 -51
- package/docs/ja/specdojo/recipes/pm-organization-recipe.md +59 -51
- package/docs/ja/specdojo/recipes/pm-plan-recipe.md +69 -56
- package/docs/ja/specdojo/recipes/pm-quality-management-plan-recipe.md +37 -56
- package/docs/ja/specdojo/recipes/pm-raci-recipe.md +39 -53
- package/docs/ja/specdojo/recipes/pm-roles-recipe.md +52 -79
- package/docs/ja/specdojo/recipes/prj-assumptions-constraints-dependencies-recipe.md +64 -93
- package/docs/ja/specdojo/recipes/prj-charter-recipe.md +71 -106
- package/docs/ja/specdojo/recipes/prj-comparison-of-alternatives-recipe.md +78 -157
- package/docs/ja/specdojo/recipes/prj-issues-and-approach-recipe.md +62 -111
- package/docs/ja/specdojo/recipes/prj-scope-recipe.md +67 -123
- package/docs/ja/specdojo/recipes/prj-stakeholder-register-recipe.md +60 -96
- package/docs/ja/specdojo/recipes/prj-success-criteria-and-acceptance-criteria-recipe.md +61 -105
- package/docs/ja/specdojo/recipes/stsd-recipe.md +79 -109
- package/docs/ja/specdojo/recipes/sysd-critical-flows-recipe.md +78 -55
- package/docs/ja/specdojo/recipes/sysd-cross-cutting-policy-recipe.md +82 -73
- package/docs/ja/specdojo/recipes/sysd-index-recipe.md +78 -59
- package/docs/ja/specdojo/recipes/tsd-recipe.md +149 -129
- package/docs/ja/specdojo/references/command-reference.md +257 -117
- package/docs/ja/specdojo/references/deliverables-reference.md +21 -12
- package/docs/ja/specdojo/references/specdojo-config-reference.md +37 -2
- package/docs/ja/specdojo/rulebooks/atc-index-rulebook.md +101 -257
- package/docs/ja/specdojo/rulebooks/atc-rulebook.md +102 -228
- package/docs/ja/specdojo/rulebooks/bac-rulebook.md +19 -28
- package/docs/ja/specdojo/rulebooks/bdd-rulebook.md +16 -67
- package/docs/ja/specdojo/rulebooks/bds-rulebook.md +30 -51
- package/docs/ja/specdojo/rulebooks/bes-index-rulebook.md +41 -61
- package/docs/ja/specdojo/rulebooks/bes-rulebook.md +22 -50
- package/docs/ja/specdojo/rulebooks/bps-rulebook.md +24 -56
- package/docs/ja/specdojo/rulebooks/br-rulebook.md +13 -38
- package/docs/ja/specdojo/rulebooks/ccd-mermaid-rulebook.md +41 -76
- package/docs/ja/specdojo/rulebooks/cdfd-d2-rulebook.md +18 -93
- package/docs/ja/specdojo/rulebooks/cdfd-mermaid-rulebook.md +18 -52
- package/docs/ja/specdojo/rulebooks/cdfd-overview-rulebook.md +109 -147
- package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +80 -108
- package/docs/ja/specdojo/rulebooks/cdfd-uc-rulebook.md +21 -46
- package/docs/ja/specdojo/rulebooks/cdr-rulebook.md +144 -0
- package/docs/ja/specdojo/rulebooks/cdsd-rulebook.md +27 -48
- package/docs/ja/specdojo/rulebooks/cdt-rulebook.md +37 -50
- package/docs/ja/specdojo/rulebooks/clis-rulebook.md +52 -69
- package/docs/ja/specdojo/rulebooks/cnd-mermaid-rulebook.md +33 -86
- package/docs/ja/specdojo/rulebooks/cnd-rulebook.md +16 -32
- package/docs/ja/specdojo/rulebooks/cop-index-rulebook.md +45 -131
- package/docs/ja/specdojo/rulebooks/cop-rulebook.md +69 -275
- package/docs/ja/specdojo/rulebooks/cpd-mermaid-rulebook.md +20 -112
- package/docs/ja/specdojo/rulebooks/cpd-rulebook.md +23 -56
- package/docs/ja/specdojo/rulebooks/cxd-mermaid-rulebook.md +12 -145
- package/docs/ja/specdojo/rulebooks/cxd-rulebook.md +39 -47
- package/docs/ja/specdojo/rulebooks/dct-index-rulebook.md +37 -56
- package/docs/ja/specdojo/rulebooks/dct-rulebook.md +118 -175
- package/docs/ja/specdojo/rulebooks/dec-rulebook.md +5 -14
- package/docs/ja/specdojo/rulebooks/dmd-index-rulebook.md +22 -66
- package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +36 -94
- package/docs/ja/specdojo/rulebooks/dss-rulebook.md +59 -81
- package/docs/ja/specdojo/rulebooks/etc-index-rulebook.md +31 -131
- package/docs/ja/specdojo/rulebooks/etc-rulebook.md +50 -104
- package/docs/ja/specdojo/rulebooks/gl-rulebook.md +51 -61
- package/docs/ja/specdojo/rulebooks/ifd-mermaid-rulebook.md +38 -45
- package/docs/ja/specdojo/rulebooks/ifx-api-rulebook.md +14 -20
- package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +26 -38
- package/docs/ja/specdojo/rulebooks/ifx-file-rulebook.md +26 -107
- package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +42 -49
- package/docs/ja/specdojo/rulebooks/ifx-msg-rulebook.md +14 -22
- package/docs/ja/specdojo/rulebooks/imp-business-rulebook.md +21 -44
- package/docs/ja/specdojo/rulebooks/imp-data-rulebook.md +41 -64
- package/docs/ja/specdojo/rulebooks/imp-interface-rulebook.md +14 -38
- package/docs/ja/specdojo/rulebooks/imp-operations-rulebook.md +34 -61
- package/docs/ja/specdojo/rulebooks/imp-test-rulebook.md +27 -50
- package/docs/ja/specdojo/rulebooks/itc-index-rulebook.md +70 -199
- package/docs/ja/specdojo/rulebooks/itc-rulebook.md +65 -153
- package/docs/ja/specdojo/rulebooks/mip-index-rulebook.md +74 -150
- package/docs/ja/specdojo/rulebooks/mm-rulebook.md +11 -23
- package/docs/ja/specdojo/rulebooks/mtp-rulebook.md +99 -176
- package/docs/ja/specdojo/rulebooks/nfr-availability-rulebook.md +35 -61
- package/docs/ja/specdojo/rulebooks/nfr-index-rulebook.md +75 -117
- package/docs/ja/specdojo/rulebooks/nfr-integrity-rulebook.md +31 -60
- package/docs/ja/specdojo/rulebooks/nfr-maintainability-rulebook.md +26 -81
- package/docs/ja/specdojo/rulebooks/nfr-operations-rulebook.md +32 -70
- package/docs/ja/specdojo/rulebooks/nfr-performance-rulebook.md +45 -87
- package/docs/ja/specdojo/rulebooks/nfr-reliability-rulebook.md +48 -101
- package/docs/ja/specdojo/rulebooks/nfr-security-safety-rulebook.md +44 -80
- package/docs/ja/specdojo/rulebooks/nfr-usability-rulebook.md +59 -127
- package/docs/ja/specdojo/rulebooks/opd-index-rulebook.md +31 -50
- package/docs/ja/specdojo/rulebooks/opd-rulebook.md +42 -109
- package/docs/ja/specdojo/rulebooks/opr-index-rulebook.md +29 -42
- package/docs/ja/specdojo/rulebooks/opr-rulebook.md +29 -87
- package/docs/ja/specdojo/rulebooks/otp-index-rulebook.md +62 -84
- package/docs/ja/specdojo/rulebooks/otp-rulebook.md +11 -61
- package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +91 -106
- package/docs/ja/specdojo/rulebooks/pm-change-request-log-rulebook.md +25 -34
- package/docs/ja/specdojo/rulebooks/pm-communication-plan-rulebook.md +30 -53
- package/docs/ja/specdojo/rulebooks/pm-issue-log-rulebook.md +23 -35
- package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +27 -45
- package/docs/ja/specdojo/rulebooks/pm-organization-rulebook.md +37 -45
- package/docs/ja/specdojo/rulebooks/pm-plan-rulebook.md +45 -46
- package/docs/ja/specdojo/rulebooks/pm-quality-management-plan-rulebook.md +37 -48
- package/docs/ja/specdojo/rulebooks/pm-raci-rulebook.md +25 -29
- package/docs/ja/specdojo/rulebooks/pm-risk-register-rulebook.md +28 -35
- package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +36 -41
- package/docs/ja/specdojo/rulebooks/pr-rulebook.md +5 -18
- package/docs/ja/specdojo/rulebooks/prj-assumptions-constraints-dependencies-rulebook.md +16 -37
- package/docs/ja/specdojo/rulebooks/prj-charter-rulebook.md +23 -97
- package/docs/ja/specdojo/rulebooks/prj-comparison-of-alternatives-rulebook.md +39 -57
- package/docs/ja/specdojo/rulebooks/prj-issues-and-approach-rulebook.md +43 -116
- package/docs/ja/specdojo/rulebooks/prj-scope-rulebook.md +16 -51
- package/docs/ja/specdojo/rulebooks/prj-stakeholder-register-rulebook.md +47 -92
- package/docs/ja/specdojo/rulebooks/prj-success-criteria-and-acceptance-criteria-rulebook.md +25 -84
- package/docs/ja/specdojo/rulebooks/sac-rulebook.md +44 -107
- package/docs/ja/specdojo/rulebooks/sf-index-rulebook.md +39 -49
- package/docs/ja/specdojo/rulebooks/sf-rulebook.md +42 -49
- package/docs/ja/specdojo/rulebooks/sld-rulebook.md +64 -89
- package/docs/ja/specdojo/rulebooks/stc-index-rulebook.md +90 -189
- package/docs/ja/specdojo/rulebooks/stc-rulebook.md +45 -105
- package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +6 -12
- package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +49 -68
- package/docs/ja/specdojo/rulebooks/sysd-critical-flows-rulebook.md +51 -60
- package/docs/ja/specdojo/rulebooks/sysd-cross-cutting-policy-rulebook.md +46 -50
- package/docs/ja/specdojo/rulebooks/sysd-index-rulebook.md +39 -64
- package/docs/ja/specdojo/rulebooks/sysd-rulebook.md +47 -60
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-specs-rulebook.md +69 -70
- package/docs/ja/specdojo/rulebooks/trc-requirements-to-tests-rulebook.md +65 -72
- package/docs/ja/specdojo/rulebooks/tsd-index-rulebook.md +35 -46
- package/docs/ja/specdojo/rulebooks/tsd-rulebook.md +49 -66
- package/docs/ja/specdojo/rulebooks/tsp-index-rulebook.md +64 -139
- package/docs/ja/specdojo/rulebooks/uis-rulebook.md +41 -108
- package/docs/ja/specdojo/rulebooks/utc-index-rulebook.md +49 -144
- package/docs/ja/specdojo/rulebooks/utc-rulebook.md +67 -155
- package/docs/ja/specdojo/samples/bds-sample.md +58 -71
- package/docs/ja/specdojo/samples/bes-index-sample.md +20 -37
- package/docs/ja/specdojo/samples/bes-sample.md +43 -53
- package/docs/ja/specdojo/samples/bps-sample.md +42 -54
- package/docs/ja/specdojo/samples/br-sample.md +40 -52
- package/docs/ja/specdojo/samples/ccd-sample.md +0 -1
- package/docs/ja/specdojo/samples/cdr-sample.md +78 -0
- package/docs/ja/specdojo/samples/cdsd-sample.md +47 -63
- package/docs/ja/specdojo/samples/clis-sample.md +70 -77
- package/docs/ja/specdojo/samples/dec-sample.md +2 -3
- package/docs/ja/specdojo/samples/ifx-api-sample.yaml +0 -2
- package/docs/ja/specdojo/samples/ifx-msg-sample.yaml +0 -2
- package/docs/ja/specdojo/samples/job-sequence.yaml +67 -0
- package/docs/ja/specdojo/samples/mip-index-sample.md +98 -20
- package/docs/ja/specdojo/samples/pm-communication-plan-sample.md +26 -19
- package/docs/ja/specdojo/samples/pm-organization-sample.md +39 -50
- package/docs/ja/specdojo/samples/pm-plan-sample.md +61 -67
- package/docs/ja/specdojo/samples/pm-quality-management-plan-sample.md +31 -45
- package/docs/ja/specdojo/samples/pm-raci-sample.md +31 -37
- package/docs/ja/specdojo/samples/prj-assumptions-constraints-dependencies-sample.md +32 -48
- package/docs/ja/specdojo/samples/prj-charter-sample.md +42 -59
- package/docs/ja/specdojo/samples/prj-comparison-of-alternatives-sample.md +55 -61
- package/docs/ja/specdojo/samples/prj-success-criteria-and-acceptance-criteria-sample.md +30 -33
- package/docs/ja/specdojo/samples/sf-index-sample.md +13 -55
- package/docs/ja/specdojo/samples/sf-sample.md +73 -85
- package/docs/ja/specdojo/samples/sld-sample.md +60 -79
- package/docs/ja/specdojo/samples/uis-sample.md +98 -121
- package/docs/ja/specdojo/standards/job-definition-standard.md +24 -9
- package/docs/ja/specdojo/templates/cdr-template.md +58 -0
- package/docs/specdojo/schemas/v1/exec-common.schema.yaml +2 -1
- package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +42 -5
- package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +35 -0
- package/docs/specdojo/schemas/v1/job-run.schema.yaml +23 -0
- package/docs/specdojo/schemas/v1/job.schema.yaml +63 -2
- package/docs/specdojo/schemas/v1/sch-strategy.schema.yaml +2 -2
- package/package.json +9 -6
- package/templates/antigravity/orchestrator.md +4 -1
- package/templates/claude/agents/specdojo-orchestrator.md +4 -1
- package/templates/codex/agents/specdojo-orchestrator.toml +4 -1
- package/templates/codex/orchestrator.md +4 -1
- package/templates/init-exec-defaults.yaml +13 -0
- package/templates/lefthook/tools/specdojo-pre-commit.mjs +8 -0
- package/templates/opencode/agents/specdojo-orchestrator.md +5 -2
|
@@ -0,0 +1,244 @@
|
|
|
1
|
+
import { existsSync, readFileSync, statSync } from "node:fs";
|
|
2
|
+
import { basename, isAbsolute, join, resolve } from "node:path";
|
|
3
|
+
/**
|
|
4
|
+
* Untracked per-machine overrides of `.specdojo/specdojo.config.json` (PJR-NC9R). Only the keys
|
|
5
|
+
* allowed below are accepted; the shared config stays the single source for everything else.
|
|
6
|
+
*/
|
|
7
|
+
export const LOCAL_CONFIG_RELATIVE_PATH = ".specdojo/specdojo.local.config.json";
|
|
8
|
+
/** Absolute path of the main working tree's local config, passed to processes in worktrees. */
|
|
9
|
+
export const LOCAL_CONFIG_ENV = "SPECDOJO_LOCAL_CONFIG";
|
|
10
|
+
/** Keys a local entry may set on a repository already declared in the shared config. */
|
|
11
|
+
const OVERRIDE_REPO_KEYS = ["name", "path"];
|
|
12
|
+
function readTextFileOrNull(path) {
|
|
13
|
+
try {
|
|
14
|
+
return readFileSync(path, "utf8");
|
|
15
|
+
}
|
|
16
|
+
catch {
|
|
17
|
+
return null;
|
|
18
|
+
}
|
|
19
|
+
}
|
|
20
|
+
function isRecord(value) {
|
|
21
|
+
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
22
|
+
}
|
|
23
|
+
/** True when `rootDir` is a linked worktree (its `.git` is a file, not a directory). */
|
|
24
|
+
function isLinkedWorktree(rootDir) {
|
|
25
|
+
const dotGit = join(resolve(rootDir), ".git");
|
|
26
|
+
return existsSync(dotGit) && !statSync(dotGit).isDirectory();
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
* Root of the main working tree. A linked worktree resolves to the checkout that owns its
|
|
30
|
+
* `.git/worktrees/<name>` directory; any other directory resolves to itself.
|
|
31
|
+
*/
|
|
32
|
+
export function repositoryIdentityRoot(rootDir) {
|
|
33
|
+
const root = resolve(rootDir);
|
|
34
|
+
if (!isLinkedWorktree(root))
|
|
35
|
+
return root;
|
|
36
|
+
const gitdirLine = readTextFileOrNull(join(root, ".git"))
|
|
37
|
+
?.split(/\r?\n/)
|
|
38
|
+
.find((line) => line.startsWith("gitdir:"));
|
|
39
|
+
if (!gitdirLine)
|
|
40
|
+
return root;
|
|
41
|
+
const gitdir = resolve(root, gitdirLine.slice("gitdir:".length).trim()).replaceAll("\\", "/");
|
|
42
|
+
const marker = "/.git/worktrees/";
|
|
43
|
+
const markerIndex = gitdir.lastIndexOf(marker);
|
|
44
|
+
return markerIndex >= 0 ? gitdir.slice(0, markerIndex) : root;
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* Local config path for `rootDir`. The main working tree reads its own file. A linked worktree
|
|
48
|
+
* never trusts a file of the same name inside itself: it uses the path the parent passed in
|
|
49
|
+
* `SPECDOJO_LOCAL_CONFIG`, or else the main working tree's file. The variable is ignored outside
|
|
50
|
+
* linked worktrees so that it cannot leak into another repository's main checkout.
|
|
51
|
+
*/
|
|
52
|
+
export function resolveLocalConfigPath(rootDir, env = process.env) {
|
|
53
|
+
const root = resolve(rootDir);
|
|
54
|
+
if (!isLinkedWorktree(root))
|
|
55
|
+
return join(root, LOCAL_CONFIG_RELATIVE_PATH);
|
|
56
|
+
const fromEnv = env[LOCAL_CONFIG_ENV]?.trim();
|
|
57
|
+
if (fromEnv) {
|
|
58
|
+
if (!isAbsolute(fromEnv) || basename(fromEnv) !== basename(LOCAL_CONFIG_RELATIVE_PATH)) {
|
|
59
|
+
throw new Error(`Invalid ${LOCAL_CONFIG_ENV}="${fromEnv}": expected an absolute path to ` +
|
|
60
|
+
basename(LOCAL_CONFIG_RELATIVE_PATH));
|
|
61
|
+
}
|
|
62
|
+
return fromEnv;
|
|
63
|
+
}
|
|
64
|
+
return join(repositoryIdentityRoot(root), LOCAL_CONFIG_RELATIVE_PATH);
|
|
65
|
+
}
|
|
66
|
+
/** Environment that hands the local config of `rootDir` to a child process in a worktree. */
|
|
67
|
+
export function localConfigEnvironment(rootDir, env = process.env) {
|
|
68
|
+
const path = resolveLocalConfigPath(rootDir, env);
|
|
69
|
+
return existsSync(path) ? { [LOCAL_CONFIG_ENV]: path } : {};
|
|
70
|
+
}
|
|
71
|
+
function validateRepoEntry(entry, at, sharedRepo, addedRepoKeys) {
|
|
72
|
+
if (!isRecord(entry))
|
|
73
|
+
return [`${at} must be an object with name and path`];
|
|
74
|
+
const errors = [];
|
|
75
|
+
const allowed = sharedRepo ? OVERRIDE_REPO_KEYS : [...addedRepoKeys];
|
|
76
|
+
for (const key of Object.keys(entry).sort()) {
|
|
77
|
+
if (!allowed.includes(key)) {
|
|
78
|
+
errors.push(sharedRepo
|
|
79
|
+
? `${at}: key "${key}" cannot override shared repository "${sharedRepo.name}" ` +
|
|
80
|
+
`(allowed: ${OVERRIDE_REPO_KEYS.join(", ")})`
|
|
81
|
+
: `${at}: unknown key "${key}"`);
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
if (typeof entry.path !== "string" || entry.path.trim().length === 0) {
|
|
85
|
+
errors.push(`${at}.path must be a non-empty string`);
|
|
86
|
+
}
|
|
87
|
+
return errors;
|
|
88
|
+
}
|
|
89
|
+
/**
|
|
90
|
+
* Apply a parsed local config to the shared config. Shared `repos[]` entries keep their order and
|
|
91
|
+
* get the local `path` when a local entry has the same `name`; other local entries are appended
|
|
92
|
+
* as local repositories. Every disallowed key or type error is reported with `localPath`.
|
|
93
|
+
* Semantic checks (name pattern, path existence, ...) are left to the shared validator, which
|
|
94
|
+
* runs on the merged result.
|
|
95
|
+
*/
|
|
96
|
+
export function applyLocalConfig(shared, local, localPath, addedRepoKeys) {
|
|
97
|
+
const errors = [];
|
|
98
|
+
const overrides = [];
|
|
99
|
+
const projects = { ...shared.projects };
|
|
100
|
+
const fail = () => {
|
|
101
|
+
throw new Error(`Invalid ${LOCAL_CONFIG_RELATIVE_PATH} (${localPath}):\n` +
|
|
102
|
+
errors.map((message) => ` - ${message}`).join("\n"));
|
|
103
|
+
};
|
|
104
|
+
if (!isRecord(local)) {
|
|
105
|
+
errors.push("expected { version: 1, projects: { ... } }");
|
|
106
|
+
return fail();
|
|
107
|
+
}
|
|
108
|
+
for (const key of Object.keys(local).sort()) {
|
|
109
|
+
if (key !== "version" && key !== "projects") {
|
|
110
|
+
errors.push(`unknown key "${key}" (allowed: version, projects)`);
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
if (local.version !== 1)
|
|
114
|
+
errors.push("version must be 1");
|
|
115
|
+
const localProjects = local.projects ?? {};
|
|
116
|
+
if (!isRecord(localProjects))
|
|
117
|
+
errors.push("projects must be an object");
|
|
118
|
+
for (const [projectId, value] of Object.entries(isRecord(localProjects) ? localProjects : {})) {
|
|
119
|
+
const at = `projects.${projectId}`;
|
|
120
|
+
const sharedProject = shared.projects[projectId];
|
|
121
|
+
if (!sharedProject) {
|
|
122
|
+
errors.push(`${at}: project is not declared in .specdojo/specdojo.config.json`);
|
|
123
|
+
continue;
|
|
124
|
+
}
|
|
125
|
+
if (!isRecord(value)) {
|
|
126
|
+
errors.push(`${at} must be an object`);
|
|
127
|
+
continue;
|
|
128
|
+
}
|
|
129
|
+
for (const key of Object.keys(value).sort()) {
|
|
130
|
+
if (key !== "repos")
|
|
131
|
+
errors.push(`${at}: key "${key}" cannot be overridden (allowed: repos)`);
|
|
132
|
+
}
|
|
133
|
+
if (value.repos === undefined)
|
|
134
|
+
continue;
|
|
135
|
+
if (!Array.isArray(value.repos)) {
|
|
136
|
+
errors.push(`${at}.repos must be an array`);
|
|
137
|
+
continue;
|
|
138
|
+
}
|
|
139
|
+
const sharedRepos = sharedProject.repos ?? [];
|
|
140
|
+
const merged = sharedRepos.map((repo) => ({ ...repo }));
|
|
141
|
+
const seen = new Set();
|
|
142
|
+
value.repos.forEach((entry, index) => {
|
|
143
|
+
const entryAt = `${at}.repos[${index}]`;
|
|
144
|
+
const name = isRecord(entry) ? entry.name : undefined;
|
|
145
|
+
if (typeof name !== "string" || name.trim().length === 0) {
|
|
146
|
+
errors.push(`${entryAt}.name must be a non-empty string`);
|
|
147
|
+
return;
|
|
148
|
+
}
|
|
149
|
+
if (seen.has(name)) {
|
|
150
|
+
errors.push(`${entryAt}.name "${name}" is declared more than once`);
|
|
151
|
+
return;
|
|
152
|
+
}
|
|
153
|
+
seen.add(name);
|
|
154
|
+
const sharedRepo = sharedRepos.find((repo) => repo.name === name);
|
|
155
|
+
const entryErrors = validateRepoEntry(entry, entryAt, sharedRepo, addedRepoKeys);
|
|
156
|
+
errors.push(...entryErrors);
|
|
157
|
+
if (entryErrors.length > 0 || !isRecord(entry))
|
|
158
|
+
return;
|
|
159
|
+
const path = String(entry.path);
|
|
160
|
+
if (sharedRepo) {
|
|
161
|
+
const target = merged.find((repo) => repo.name === name);
|
|
162
|
+
if (target)
|
|
163
|
+
target.path = path;
|
|
164
|
+
overrides.push({
|
|
165
|
+
project: projectId,
|
|
166
|
+
repo: name,
|
|
167
|
+
kind: "path",
|
|
168
|
+
path,
|
|
169
|
+
shared_path: sharedRepo.path,
|
|
170
|
+
});
|
|
171
|
+
}
|
|
172
|
+
else {
|
|
173
|
+
// validateRepoEntry checked the keys; the shared validator checks values after the merge.
|
|
174
|
+
merged.push({ ...entry });
|
|
175
|
+
overrides.push({ project: projectId, repo: name, kind: "added", path });
|
|
176
|
+
}
|
|
177
|
+
});
|
|
178
|
+
projects[projectId] = { ...sharedProject, repos: merged };
|
|
179
|
+
}
|
|
180
|
+
if (errors.length > 0)
|
|
181
|
+
return fail();
|
|
182
|
+
return { config: { ...shared, projects }, overrides };
|
|
183
|
+
}
|
|
184
|
+
/** Read the local config for `rootDir`, or null when the file does not exist. */
|
|
185
|
+
export function readLocalConfig(rootDir, env = process.env) {
|
|
186
|
+
const path = resolveLocalConfigPath(rootDir, env);
|
|
187
|
+
if (!existsSync(path)) {
|
|
188
|
+
if (env[LOCAL_CONFIG_ENV]?.trim() && isLinkedWorktree(rootDir)) {
|
|
189
|
+
throw new Error(`${LOCAL_CONFIG_ENV} points to a missing file: ${path}`);
|
|
190
|
+
}
|
|
191
|
+
return null;
|
|
192
|
+
}
|
|
193
|
+
const raw = readFileSync(path, "utf8");
|
|
194
|
+
try {
|
|
195
|
+
return { path, value: JSON.parse(raw) };
|
|
196
|
+
}
|
|
197
|
+
catch (error) {
|
|
198
|
+
throw new Error(`Invalid ${LOCAL_CONFIG_RELATIVE_PATH} (${path}): ${error instanceof Error ? error.message : String(error)}`, { cause: error });
|
|
199
|
+
}
|
|
200
|
+
}
|
|
201
|
+
/** One line per local override, for `config show` and `where exec`. */
|
|
202
|
+
export function formatLocalOverride(override) {
|
|
203
|
+
return override.kind === "path"
|
|
204
|
+
? `projects.${override.project}.repos[${override.repo}].path = ${override.path} ` +
|
|
205
|
+
`(local; shared: ${override.shared_path})`
|
|
206
|
+
: `projects.${override.project}.repos[${override.repo}] = ${override.path} (local; added)`;
|
|
207
|
+
}
|
|
208
|
+
/** Lines describing the local config and its overrides, for `config show` and `where`. */
|
|
209
|
+
export function formatLocalConfigLines(result, projectId) {
|
|
210
|
+
if (!result.localConfigPath)
|
|
211
|
+
return ["local-config: none"];
|
|
212
|
+
const overrides = (result.localOverrides ?? []).filter((override) => projectId === undefined || override.project === projectId);
|
|
213
|
+
return [
|
|
214
|
+
`local-config: ${result.localConfigPath}`,
|
|
215
|
+
...overrides.map((override) => `local-override: ${formatLocalOverride(override)}`),
|
|
216
|
+
];
|
|
217
|
+
}
|
|
218
|
+
/** `config show` output: config files, then each project's repos with their source. */
|
|
219
|
+
export function formatConfigShow(result, projectId) {
|
|
220
|
+
if (!result.config)
|
|
221
|
+
return `No config found: ${result.configPath}\n`;
|
|
222
|
+
const config = result.config;
|
|
223
|
+
if (projectId !== undefined && !config.projects[projectId]) {
|
|
224
|
+
throw new Error(`Unknown project: ${projectId} (${result.configPath})`);
|
|
225
|
+
}
|
|
226
|
+
const lines = [`config: ${result.configPath}`, ...formatLocalConfigLines(result, projectId)];
|
|
227
|
+
const projectIds = projectId === undefined ? Object.keys(config.projects).sort() : [projectId];
|
|
228
|
+
for (const id of projectIds) {
|
|
229
|
+
lines.push(`project: ${id}`);
|
|
230
|
+
const repos = config.projects[id].repos ?? [];
|
|
231
|
+
if (repos.length === 0)
|
|
232
|
+
lines.push(" repos: none");
|
|
233
|
+
for (const repo of repos) {
|
|
234
|
+
const override = result.localOverrides?.find((candidate) => candidate.project === id && candidate.repo === repo.name);
|
|
235
|
+
const source = !override
|
|
236
|
+
? "shared"
|
|
237
|
+
: override.kind === "added"
|
|
238
|
+
? "local; added"
|
|
239
|
+
: `local; shared: ${override.shared_path}`;
|
|
240
|
+
lines.push(` repo ${repo.name}: ${repo.path} (${source})`);
|
|
241
|
+
}
|
|
242
|
+
}
|
|
243
|
+
return `${lines.join("\n")}\n`;
|
|
244
|
+
}
|
|
@@ -14,6 +14,7 @@ import { runLefthookScaffold } from "./lefthook-scaffold.js";
|
|
|
14
14
|
import { ensureMarkdownlintConfig } from "./markdownlint-config.js";
|
|
15
15
|
import { runSlidevScaffold, SLIDEV_KATA_PATTERNS } from "./slidev-scaffold.js";
|
|
16
16
|
import { ensureGitignore, formatGitignoreReport, gitignorePatternsForLayouts, } from "./specdojo-gitignore.js";
|
|
17
|
+
import { applyLocalConfig, formatConfigShow, readLocalConfig, repositoryIdentityRoot, } from "./local-config.js";
|
|
17
18
|
/** Default IANA time zone for register date derivation when run.register_date_timezone is unset. */
|
|
18
19
|
export const DEFAULT_REGISTER_DATE_TIMEZONE = "UTC";
|
|
19
20
|
export const SPECDOJO_CONFIG_REFERENCE_URL = "https://specdojo.github.io/specdojo/ja/specdojo/references/specdojo-config-reference.html";
|
|
@@ -128,21 +129,6 @@ export function resolveRegisterActor(actor, roster) {
|
|
|
128
129
|
}
|
|
129
130
|
export const DEFAULT_AGENT_MEMBERS_PATH = ".specdojo/agent-members.yaml";
|
|
130
131
|
export const KATA_AUTHORITY_PATTERN = /^(?!prj-)(?!specdojo$)[a-z][a-z0-9-]*$/;
|
|
131
|
-
function repositoryIdentityRoot(rootDir) {
|
|
132
|
-
const root = resolve(rootDir);
|
|
133
|
-
const dotGit = join(root, ".git");
|
|
134
|
-
if (!existsSync(dotGit) || statSync(dotGit).isDirectory())
|
|
135
|
-
return root;
|
|
136
|
-
const gitdirLine = readTextFileOrNull(dotGit)
|
|
137
|
-
?.split(/\r?\n/)
|
|
138
|
-
.find((line) => line.startsWith("gitdir:"));
|
|
139
|
-
if (!gitdirLine)
|
|
140
|
-
return root;
|
|
141
|
-
const gitdir = resolve(root, gitdirLine.slice("gitdir:".length).trim()).replaceAll("\\", "/");
|
|
142
|
-
const marker = "/.git/worktrees/";
|
|
143
|
-
const markerIndex = gitdir.lastIndexOf(marker);
|
|
144
|
-
return markerIndex >= 0 ? gitdir.slice(0, markerIndex) : root;
|
|
145
|
-
}
|
|
146
132
|
export function defaultKataAuthority(rootDir = specdojoRootDir()) {
|
|
147
133
|
const directoryName = basename(repositoryIdentityRoot(rootDir));
|
|
148
134
|
const normalized = directoryName
|
|
@@ -725,19 +711,34 @@ export function loadConfig(configRootDir = specdojoRootDir()) {
|
|
|
725
711
|
}
|
|
726
712
|
const projectIds = Object.keys(parsed.projects);
|
|
727
713
|
const rootDir = dirname(dirname(configPath));
|
|
714
|
+
// The local config is read after the shared one and may change only allowlisted keys
|
|
715
|
+
// (PJR-NC9R). The merged result goes through the same validation as the shared config.
|
|
716
|
+
const local = readLocalConfig(rootDir);
|
|
717
|
+
const applied = local
|
|
718
|
+
? applyLocalConfig(parsed, local.value, local.path, REPO_KEYS)
|
|
719
|
+
: { config: parsed, overrides: [] };
|
|
720
|
+
const effective = applied.config;
|
|
728
721
|
const repoErrors = projectIds
|
|
729
722
|
.sort()
|
|
730
723
|
.flatMap((projectId) => [
|
|
731
|
-
...validateCommitTypes(
|
|
732
|
-
...validateProjectRepos(projectId,
|
|
724
|
+
...validateCommitTypes(effective.projects[projectId].commit_types, `projects.${projectId}.commit_types`),
|
|
725
|
+
...validateProjectRepos(projectId, effective.projects[projectId], projectIds, rootDir),
|
|
733
726
|
]);
|
|
734
|
-
const externalProjectErrors = validateExternalProjects(
|
|
727
|
+
const externalProjectErrors = validateExternalProjects(effective.external_projects, projectIds, rootDir);
|
|
735
728
|
const configErrors = [...repoErrors, ...externalProjectErrors];
|
|
736
729
|
if (configErrors.length > 0) {
|
|
737
|
-
|
|
730
|
+
const localNote = local ? ` with local overrides from ${local.path}` : "";
|
|
731
|
+
throw new Error(`Invalid .specdojo/specdojo.config.json (${configPath}${localNote}):\n` +
|
|
738
732
|
configErrors.map((message) => ` - ${message}`).join("\n"));
|
|
739
733
|
}
|
|
740
|
-
return
|
|
734
|
+
return local
|
|
735
|
+
? {
|
|
736
|
+
configPath,
|
|
737
|
+
config: effective,
|
|
738
|
+
localConfigPath: local.path,
|
|
739
|
+
localOverrides: applied.overrides,
|
|
740
|
+
}
|
|
741
|
+
: { configPath, config: parsed };
|
|
741
742
|
}
|
|
742
743
|
export function writeConfig(config) {
|
|
743
744
|
const configPath = defaultConfigPath();
|
|
@@ -827,6 +828,19 @@ export function registerConfigCommands(program) {
|
|
|
827
828
|
' 6. To let tasks change the product repository, declare it under "repos" ' +
|
|
828
829
|
'(e.g. { "name": "app1", "path": "../app1" }) and write targets/paths as app1:<path>.\n');
|
|
829
830
|
});
|
|
831
|
+
cfg
|
|
832
|
+
.command("show")
|
|
833
|
+
.description("Show the effective repos and which values come from .specdojo/specdojo.local.config.json")
|
|
834
|
+
.option("--project <projectId>", "Show only one project")
|
|
835
|
+
.action((opts) => {
|
|
836
|
+
try {
|
|
837
|
+
process.stdout.write(formatConfigShow(loadConfig(), opts.project));
|
|
838
|
+
}
|
|
839
|
+
catch (error) {
|
|
840
|
+
process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
|
|
841
|
+
process.exitCode = 1;
|
|
842
|
+
}
|
|
843
|
+
});
|
|
830
844
|
cfg
|
|
831
845
|
.command("migrate-members")
|
|
832
846
|
.description("Move agent entries from project pm-members.yaml files to protected agent members")
|
|
@@ -7,6 +7,7 @@ export const NODE_MODULES_PATTERN = "node_modules/";
|
|
|
7
7
|
export const DEFAULT_GITIGNORE_PATTERNS = [
|
|
8
8
|
NODE_MODULES_PATTERN,
|
|
9
9
|
".specdojo/doc-index.json",
|
|
10
|
+
".specdojo/specdojo.local.config.json",
|
|
10
11
|
"docs/**/generated/*",
|
|
11
12
|
"!docs/**/generated/.gitkeep",
|
|
12
13
|
"docs/**/execution/exec/.locks/",
|
package/dist/shared/text.js
CHANGED
|
@@ -82,7 +82,15 @@ function replaceOutsideMarkdownCodeSpans(text, replace) {
|
|
|
82
82
|
export function inlineCodeAnglePlaceholders(text) {
|
|
83
83
|
// HTTP(S) autolink は Markdown として既に安全な山括弧記法なので、プレースホルダとして
|
|
84
84
|
// code span 化しない。register の表セルで bare URL を囲んだ後も autolink を保持する。
|
|
85
|
-
|
|
85
|
+
return wrapAngleTokens(text, /[A-Za-z0-9._-]*(?:<(?!https?:\/\/)[^<>\r\n]+>[A-Za-z0-9._-]*)+/g);
|
|
86
|
+
}
|
|
87
|
+
// frontmatter の文字列値へ書き写す executor 由来の文(condense の記録・block 理由など)向け。
|
|
88
|
+
// lint-fm は frontmatter のコードスパン外の山括弧を autolink や実在 HTML 名も含めて拒否する
|
|
89
|
+
// ため(PJR-V141)、本文用と異なり `<https://...>` も code span 化する。
|
|
90
|
+
export function inlineCodeFrontmatterAnglePlaceholders(text) {
|
|
91
|
+
return wrapAngleTokens(text, /[A-Za-z0-9._-]*(?:<[^<>\r\n]+>[A-Za-z0-9._-]*)+/g);
|
|
92
|
+
}
|
|
93
|
+
function wrapAngleTokens(text, placeholder) {
|
|
86
94
|
const wrapToken = (token) => {
|
|
87
95
|
const trailing = token.match(/\.+$/)?.[0] ?? "";
|
|
88
96
|
const body = trailing ? token.slice(0, -trailing.length) : token;
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import { warnDeprecated } from "./deprecation.js";
|
|
2
|
+
/** Retain the six pre-unification entries for one release before removing them. */
|
|
3
|
+
export function registerDeprecatedWhereAlias(parent, printPaths) {
|
|
4
|
+
const kind = parent.name();
|
|
5
|
+
parent
|
|
6
|
+
.command("where", { hidden: true })
|
|
7
|
+
.description(`Deprecated: use where ${kind} (retained for one release)`)
|
|
8
|
+
.option("--project <projectId>", "Project id in specdojo.config.json")
|
|
9
|
+
.action((opts) => {
|
|
10
|
+
warnDeprecated(`${kind} where`, `Use specdojo where ${kind}. This alias will be removed after one release.`);
|
|
11
|
+
printPaths(opts);
|
|
12
|
+
});
|
|
13
|
+
}
|
package/dist/specdojo.js
CHANGED
|
@@ -15,6 +15,7 @@ import { registerRoutineCommands } from "./routine/routine.js";
|
|
|
15
15
|
import { registerJobCommands } from "./job/job.js";
|
|
16
16
|
import { registerWatchCommand } from "./commands/watch.js";
|
|
17
17
|
import { registerBuildCommand } from "./commands/build.js";
|
|
18
|
+
import { registerWhereCommand } from "./commands/where.js";
|
|
18
19
|
import { registerYamlPagesCommands } from "./docs/yaml-pages-command.js";
|
|
19
20
|
import { registerDashboardCommands } from "./dashboard/dashboard.js";
|
|
20
21
|
import { registerGradeCommand } from "./grade/grade.js";
|
|
@@ -24,6 +25,7 @@ import { registerKataCommands } from "./kata/command.js";
|
|
|
24
25
|
import { registerDevcontainerCommands } from "./devcontainer/command.js";
|
|
25
26
|
import { registerInitCommand } from "./commands/init.js";
|
|
26
27
|
import { registerOrchestratorCommands } from "./commands/orchestrator.js";
|
|
28
|
+
import { registerGitCommand } from "./commands/git.js";
|
|
27
29
|
/**
|
|
28
30
|
* bin は dist/specdojo.js を指すため、開発チェックアウトで `npm run build` を忘れると
|
|
29
31
|
* 古い挙動のまま実行される。src が dist より新しい場合は警告し、exec 系は中断する。
|
|
@@ -57,6 +59,7 @@ async function main() {
|
|
|
57
59
|
registerJobCommands(program);
|
|
58
60
|
registerWatchCommand(program);
|
|
59
61
|
registerBuildCommand(program);
|
|
62
|
+
registerWhereCommand(program);
|
|
60
63
|
registerYamlPagesCommands(program);
|
|
61
64
|
registerDashboardCommands(program);
|
|
62
65
|
registerGradeCommand(program, {
|
|
@@ -67,6 +70,7 @@ async function main() {
|
|
|
67
70
|
registerKataCommands(program);
|
|
68
71
|
registerDevcontainerCommands(program);
|
|
69
72
|
registerOrchestratorCommands(program);
|
|
73
|
+
registerGitCommand(program);
|
|
70
74
|
await program.parseAsync(process.argv);
|
|
71
75
|
}
|
|
72
76
|
void main();
|
|
@@ -324,6 +324,7 @@ viewpoints:
|
|
|
324
324
|
document_kinds:
|
|
325
325
|
exclude:
|
|
326
326
|
- specdojo:bdd-rulebook
|
|
327
|
+
- specdojo:cdr-rulebook
|
|
327
328
|
- specdojo:dct-index-rulebook
|
|
328
329
|
- specdojo:dct-rulebook
|
|
329
330
|
- specdojo:gl-rulebook
|
|
@@ -573,6 +574,7 @@ viewpoints:
|
|
|
573
574
|
- specdojo:cdfd-mermaid-rulebook
|
|
574
575
|
- specdojo:cdfd-rulebook
|
|
575
576
|
- specdojo:cdfd-uc-rulebook
|
|
577
|
+
- specdojo:cdr-rulebook
|
|
576
578
|
- specdojo:cdsd-rulebook
|
|
577
579
|
- specdojo:cdt-rulebook
|
|
578
580
|
- specdojo:cld-rulebook
|
|
@@ -81,7 +81,7 @@ phase_sets:
|
|
|
81
81
|
| `mode` | 任意 | `edit` または `review`。省略時は `edit` |
|
|
82
82
|
| `approach` | 任意 | `fully-guided` / `condense` / `recipe-guided` / `freeform` / `bootstrap` / `retrofit` / `cross-deliverable-dedup` / `rulebook-maintenance` / `recipe-maintenance` / `sample-maintenance` / `template-maintenance` |
|
|
83
83
|
| `capabilities` | 任意 | 必要なツールリスト。ツール不要の場合は省略 |
|
|
84
|
-
| `proficiency` | 任意 |
|
|
84
|
+
| `proficiency` | 任意 | 必要な品質水準。`low` / `normal` / `high` / `expert` / `frontier`。省略すると `frontier` を除く水準が候補 |
|
|
85
85
|
| `agent` | 任意 | `executor`(必須)と `reporter`(任意)の nickname。CLI の stage override に次いで優先 |
|
|
86
86
|
| `agent_pipeline` | 任意 | executor、reporter の 2 stage と stage ごとの `capabilities` / `proficiency`。省略時は従来の単一 agent フロー |
|
|
87
87
|
|
|
@@ -149,12 +149,14 @@ alias の連鎖は使用できますが、循環してはならず、終端は
|
|
|
149
149
|
|
|
150
150
|
pipeline 専用 agent には `stage_role: executor` または `stage_role: reporter` を指定します。`stage_role` を省略した既存 agent は従来の単一 agent フロー専用です。自動選択では、従来タスクから stage role 付き agent を除外し、pipeline stage から stage role 未指定 agent と異なる stage role の agent を除外します。これにより既存 agent 定義を変更せず、新しい pipeline agent を追加できます。
|
|
151
151
|
|
|
152
|
-
`exec run --auto` は phase または pipeline stage の `capabilities` をすべて持つ agent を候補にします。`proficiency` が指定されている場合は一致する agent
|
|
152
|
+
`exec run --auto` は phase または pipeline stage の `capabilities` をすべて持つ agent を候補にします。`proficiency` が指定されている場合は一致する agent のみを候補にし、未指定の場合は `frontier` を除く水準を候補に含めます。候補のソートキーは次の順に評価します。
|
|
153
153
|
|
|
154
154
|
1. busy 状態(イベントログ上で `doing` のタスクを担当中の agent)を最後尾に置きます。`--parallel` 実行で同じ最上位 agent に集中して rate limit に陥るのを避けるためです。
|
|
155
155
|
2. `priority` 昇順(同値なら次へ)。
|
|
156
156
|
3. 余剰 capabilities 数の少ない順。
|
|
157
157
|
|
|
158
|
+
`frontier` は `expert` より上の最上位段です。自動選択では、タスクまたは pipeline stage が `proficiency: frontier` を明示した場合だけ候補にします。通常候補がすべて busy の場合や、rate limit で次候補へ切り替える場合も、この条件は変わりません。名前で指名する CLI、`routing`、sch-strategy / Job の `agent` では、タスクの習熟度要件にかかわらず使用できます。
|
|
159
|
+
|
|
158
160
|
ソート後、`exec-defaults.yaml` の `providers.<provider>.max_concurrency` が設定された provider について、現在実行中の agent が上限に達していれば、その provider の候補を除外します。別 provider の候補が残ればそれを実行者に繰り上げます。すべての候補の provider が上限に達している場合は、claim も worktree 生成も行わずにそのタスクを繰り延べます(タスクは `todo` のまま保持され、取りこぼしません)。`--loop` 実行では、agent 終了時に provider の枠を解放し、空いた `--parallel` 枠へ次の Ready タスクを投入します。`max_concurrency` はグローバルな `--parallel` を下げないため、他 provider は並列実行を維持します。auto 選択以外では、register の worktree モードで実行する executor/reporter pipeline(`--parallel` / `--resume` を含む)に適用し、項目ごとの各 stage を provider の空き枠まで待機させます。その他の Schedule phase の `agent`、`--by` / `--edit-by` / `--review-by` / `--executor-by` / `--reporter-by` による明示指定や Schedule task の resume 実行には適用しません。
|
|
159
161
|
|
|
160
162
|
phase の by-name agent や `--executor-by` / `--reporter-by` で指名した agent の rate limit は、`--on-rate-limit stop|wait|fallback` で扱いを選べます。`stop`(既定)は従来どおり待機状態にし、`wait` は provider の reset / retry-after(無ければ `cooldown_seconds`)まで待って同じ段を同じ agent で1回再開します。待ち時間が `pinned.max_wait_seconds`(既定8時間)を超える、または再開時刻が得られない場合は停止します。`fallback` は `--fallback-executor-by` / `--fallback-reporter-by`(または後述の既定)で指定した agent へ1回だけ切り替え、未指定時や fallback も rate limit の場合は停止します。`exec resume` でも同じ指定が使えます。
|
|
@@ -167,6 +169,8 @@ phase の by-name agent や `--executor-by` / `--reporter-by` で指名した ag
|
|
|
167
169
|
|
|
168
170
|
自動選択で rate limit を検知したら、まず待機なしで次の優先順 agent に切り替えて再実行します(次候補は別アカウント/プロバイダ想定)。全候補が rate limit の場合のみ `rate_limit_policy.on_critical.retry` の wait+backoff で再パスを行い、`max_attempts` 回(初回パスを 1 回目として数える)まで繰り返します。phase の `agent` で指名した場合は候補がその1件に固定されるため、別 agent へは切り替えません。この再試行は critical / non-critical を問わず全タスクに適用します。
|
|
169
171
|
|
|
172
|
+
`rate_limit_policy.on_non_critical.action: skip` は既存 schema との互換用の必須項目で、実行時には参照しません。設定しても非クリティカルタスクをスキップしません。既存の設定ではこの項目を残してください。provider 別の `rate_limit_policy` にも同じ扱いを適用します。
|
|
173
|
+
|
|
170
174
|
```mermaid
|
|
171
175
|
flowchart LR
|
|
172
176
|
T["ready task\nmode / capabilities / proficiency"]
|
|
@@ -323,6 +327,8 @@ routing:
|
|
|
323
327
|
|
|
324
328
|
`exec run --register` は個票に `difficulty` があり、対応する表がある場合だけこの指定を使います。個票に難易度がない場合、または対応する表がない場合は、`stage_role` と `priority` による従来の自動選択へ戻ります。CLI の `--executor-by`・`--reporter-by`・`--on-rate-limit`・fallback 指定は、指定した項目だけ表より優先します。`on_rate_limit: wait` でも fallback は接続不能時の切替先として使用されます。
|
|
325
329
|
|
|
330
|
+
通常実行(`--force-restart` を含む)では、全選択項目の振り分けを解決し、指名した executor・reporter の fallback を start の記帳・plan/result の生成・worktree の作成前に検査します。CLI の段別指定が振り分けの fallback と同じ agent になる場合も設定エラーとして終了コード 1 で停止します。別の fallback を明示するか、段の agent 指定を変更して再実行します。
|
|
331
|
+
|
|
326
332
|
上の `qwen-executor` を使う `easy` の例は、変更範囲が docs・src・tests の内側で完結し、それらの外を変更しない作業に限る運用を前提にしています。難易度は優先度ではなく、必要な推論・判断と安全な変更範囲から決めます。
|
|
327
333
|
|
|
328
334
|
`specdojo init --exec` は、選択した provider の member に合わせて 3 段階の表を生成します。provider を複数選んだ場合は、後続 provider の executor / reporter を fallback の例にも使います。
|
|
@@ -403,6 +409,9 @@ provider ごとに挙動が異なる設定は `providers.<provider>` に置き
|
|
|
403
409
|
|
|
404
410
|
- `command_template`: その provider の agent を起動するコマンドテンプレート。`{nickname}`・`{model}`・`{mode}`・`{proficiency}` と `command_params` の変数を member 属性で展開します。`model` のない従来 member は、これまでどおり `command_params` の `model` を使用できます。グローバル既定は持ちません。
|
|
405
411
|
- `command_params`: テンプレートの追加変数表。`by_mode.<mode>`、`by_proficiency.<proficiency>`、`by_nickname.<nickname>` に変数名と値の組を置きます。同じ変数は `by_nickname`、`by_proficiency`、`by_mode` の順で優先します。
|
|
412
|
+
|
|
413
|
+
`frontier` member を起動する provider には、`command_params.by_proficiency.frontier` が必要です。未定義なら member 名と不足する設定パスを示して起動前に停止します。member の `command` 上書きでも同じ検査を行います。追加変数が不要なら `frontier: {}` と書けます。`specdojo init --exec` の雛形は、Codex に `{ effort: xhigh }`、ほかの標準 provider に `{}` を用意します。既存リポジトリでは、member の追加に先立ってこの設定を加えます。
|
|
414
|
+
|
|
406
415
|
- `rate_limit_detection`: provider 固有の検出シグナル(`stderr_patterns` を優先します)。
|
|
407
416
|
- `connection_error_detection`: provider API やローカル LLM へ接続できない場合の検出シグナル(`stderr_patterns` を優先します)。
|
|
408
417
|
- `rate_limit_policy`: provider 固有のリトライ/フォールバック/block ポリシー。
|
|
@@ -427,6 +436,7 @@ providers:
|
|
|
427
436
|
by_proficiency: # model は実体の member の model を使い、effort だけを切り替える
|
|
428
437
|
normal: { effort: medium }
|
|
429
438
|
expert: { effort: high }
|
|
439
|
+
frontier: { effort: xhigh }
|
|
430
440
|
|
|
431
441
|
antigravity:
|
|
432
442
|
command_template: 'specdojo agent launch --provider antigravity --role {mode} -- --sandbox --model {model} -p "$(cat)"'
|
|
@@ -589,6 +599,15 @@ executor の出力は、そのまま reporter へ渡さずに run 単位の evid
|
|
|
589
599
|
- evidence ディレクトリは Git の管理対象です。成功して統合された run のログは履歴に残り、失敗中の worktree では未コミットのまま保持されます。`--force-restart` などで worktree を破棄すると未コミットログも失われるため、必要な調査を先に行います。既知パターンは保存前に秘匿しますが、未知形式の秘密が残る可能性を考慮し、ログを外部共有する前に内容を確認します。
|
|
590
600
|
- executor が構造化した最終報告を返す場合は、標準出力に `<specdojo_executor_evidence>` タグで JSON(`final_message`・`validations`・省略可能な `completion_status`・`handoff`)を出します。`validations[].status` は `passed` / `failed` / `not_run` / `not_applicable` / `requires_human` のいずれかです。`not_applicable` はリポジトリが検査の適用条件を満たさない場合に使い、`reason` へ理由を必ず記録します。`requires_human` は、実 agent CLI の起動、利用枠や課金を伴う操作、認証情報やホスト側の操作など、agent の sandbox から実行できない確認だけに使います。実行できるが省略した検証には使わず、`not_run` として記録します。タグが無い場合は標準出力の残りを最終メッセージとして扱います。
|
|
591
601
|
- `pipeline.parent_validations` には `validate-schema`(`npm run validate:schema`)、`typecheck`(`npm run typecheck`)、`test-unit`(`npm run test:unit`)、`test-integration`(`npm run test:integration`)、`lint-ts`(`npm run lint:ts`)、`lint-fm`(`npm run lint:fm`)、`lint-md`(`npm run lint:md`)、`lint-mermaid`(`npm run lint:mermaid`)、`lint-d2`(`npm run lint:d2`)、`build`(`npm run build`)、`format-check`(`npm run format:check`)を指定できます。親 runner は executor の成功後・reporter の起動前に、指定順で固定 argv の検証を実行します。
|
|
602
|
+
- `pipeline.post_integration` は、worktree 実行の統合の commit の後に親 runner が流す処理を `{ id, paths }` で指定します。ID は固定の許可リストで、現在は `build-dist`(`npm run build`)だけです。未知の ID、`paths` の欠落・空・空文字、`command` / `args` / `repo` などの余分な項目、ID の重複は設定の読み込みで拒否します。処理は統合の commit の差分が `paths` に当たるときだけ、exec のロックを持ったまま流すため、同時に流れる run の統合と重なりません。失敗しても統合は戻さず、`dist/.specdojo-build-failed` を置いて次の `exec` を dist-freshness の判定で止めます。結果は run の記録の `post-integration.log` に `passed` / `failed` / `skipped`(`paths` に当たらない)として残ります。
|
|
603
|
+
|
|
604
|
+
```yaml
|
|
605
|
+
pipeline:
|
|
606
|
+
post_integration:
|
|
607
|
+
- id: build-dist
|
|
608
|
+
paths: ["src/**", "tsconfig*.json"]
|
|
609
|
+
```
|
|
610
|
+
|
|
592
611
|
- executor prompt には設定済み ID と対応コマンドを明示します。executor はそのコマンドや対象限定版を sandbox 内で実行せず、executor evidence の validations にも含めなくてよいものとします。親 runner の結果は `source: runner` と許可リスト `id` 付きで同じ `validations` 配列へ保存します。executor が同じ検査を `not_run` または `not_applicable` として含めた場合も、同じリポジトリで実行された親 runner の結果を正とします。これにより sandbox 内で成立しない検証を親へ移した場合も二重実行せず、executor の重複報告で run を止めません。
|
|
593
612
|
- result の `changed_files` のパスは evidence の `changes` から、execution の evidence、project register とその派生ビュー、当該 result という runner 管理記録を除いて runner が機械生成します。除外後の変更一覧だけを reporter へ渡し、edit の変更説明は evidence のパスと対にして受け取ります。runner はパスで突き合わせるため、説明の順序は問いません。説明が不足したパスには Git の変更メタデータ(追加・変更・削除・名前の変更、行数)を記録し、変更ファイルが多い場合(50 件超)はディレクトリごとに集約して記録します。evidence にないパスの説明は捨てます。`outcome` と `block_reason` は stage の状態・終了コード・保護機構が保存した理由・executor / 親 runner の検証から機械生成します。reporter の JSON Schema は文章項目と対応づけ用のパスだけを受け付け、いずれかの検証が failed または `not_run` なら、reporter の文章にかかわらず機械判定は blocked です。ただし、executor が `not_run` または `not_applicable` と記録したコマンドを、親 runner が同じリポジトリで同じコマンドとして実行し成功していれば、親 runner の結果を正として executor の報告を無視します。さらに、`npm run <name>` に対応する script がない、`npx <package>` の package が `dependencies` / `devDependencies` にない、検査の対象となる種類の変更ファイルがない、または SpecDojo サブコマンドの設定上の適用条件を満たさないことを runner が機械的に確定できる場合、その `not_run` は block せず、edit result の申し送りへ「適用外の検証(runner の判定)」として追記します。変更ファイル種別で判定する対応は共通規約の検査表を正本とし、`validate:schema:file` は `*.yaml` / `*.yml`、Prettier は `*.md` / `*.ts` / `*.js` / `*.json` / `*.yaml` / `*.yml`、markdownlint は `*.md`、`validate:history-links`(`specdojo-docs-lint history-links` を含む)は履歴蓄積ファイル(`pjr-*.md`(`pjr-index.md` を除く)、または executor 自身が変更した `execution/runs/<origin>/<item>/<run>/` 配下の `plan.md`・`result.md` や旧来の `exec/plans/**/*.md`・`exec/results/**/*.md`)の変更がある場合だけ適用対象とします。変更範囲の判定では、runner が生成・更新する `exec/` 配下(`plans/`・`results/`・`evidence/`・`events/`・`.locks/`)を executor の変更ファイルから除外し、rename は変更前後の両方を見て、プロダクトリポジトリのコマンドはそのリポジトリの変更だけで判定します。`typecheck` など、この対応に含まれない検査の判定は変更しません。SpecDojo の起動形は `specdojo <subcommand>`、`npx specdojo <subcommand>`、ソース/配布済み CLI の直接起動を認識し、`catalog validate`(`npm run validate:catalog` および `tools/catalog-validate-if-configured.mjs` を含む)は対象 project の `catalog_path` で判定します。対象 project は、コマンドの `--project <id>`、run の対象 project(runner が execution path に一致する project を設定から特定したもの)、`current_project` の順に決めます。別の project が `catalog_path` を持っていても、run の対象 project に `catalog_path` がなければ適用外です。対象 project に `catalog_path` があっても、executor の変更(runner が書く `exec/` 配下などの runner 管理記録を除き、rename は変更前後の両方を見ます)が `docs/ja/projects/` 配下に及ばない run では、plan の共通規約の検証表と同じく適用外とし、executor の `not_applicable` も受理します。変更が及ぶ run では従来どおり適用対象です。また、`<repo>:<path>` を引数に含むコマンド、`--prefix <repo>` 付きのコマンド、または `$SPECDOJO_REPO_<NAME>` / `${SPECDOJO_REPO_<NAME>}` を含むコマンドは、対象 project が `repos` で宣言したそのプロダクトリポジトリの `package.json` で script と依存を判定します(`--prefix` はリポジトリ名か設定の `path` と一致するものを対象にします)。設定が読めない、対象 project を特定できない、または適用条件を未定義のサブコマンドは機械的な救済をせず、通常の `not_run` として扱います。executor の failed は親 runner の成功や適用外判定で打ち消しません。`npm run check` のように npm script を `&&` でつないだだけの合成コマンドを executor が `not_run` とした場合は、対象リポジトリの `package.json` の script を展開し、構成する各コマンドが同じリポジトリの親検証か executor 自身の検証で通っていれば満たされたものとして扱います。`npm test` は、`npm run test:unit` と `npm run test:integration` の両方が通っていれば満たされたものとします。構成するコマンドの script の中身と同じコマンドを executor が直接実行して通した場合も満たします(`tsx` の起動の書き方の違いはそろえて比べます)。任意のシェルを含む script は展開しません。理由付きの `not_applicable` は block の理由にせず、runner が edit result の申し送りへ「適用外の検証: `<コマンド>`(<理由>)」として機械的に追記します。ただし、理由がない場合、変更ファイル種別を含む適用条件を満たした `npm run <name>` の script が存在する場合、または同条件を満たした `npx <package>` の package が `dependencies` / `devDependencies` に存在する場合は誤申告として blocked にします。SpecDojo サブコマンドは package の有無だけでは反証せず、既知の適用条件を設定から判定します。適用条件が未定義なら理由付きの agent の申告に従います。`specdojo index build`(`npx specdojo index build`・`node --import tsx src/specdojo.ts index build` などの起動形を含みます)は runner が担う検証です。出力先の `.specdojo/doc-index.json` は agent が書き込めず、index は worktree の準備と統合の前に runner が再生成するため、executor への指示では実行も記録もしないよう伝えます。executor が `not_run` / `not_applicable` と記録しても block の理由にせず、`not_run` の場合は edit result の申し送りへ「runner が担う検証: `<コマンド>`(<理由>)」として追記します。runner の再生成が失敗した場合は worktree の準備で run が止まるか、runner の検証の失敗として block するため、満たしたものとは扱いません。executor の failed は救済せず、ほかの SpecDojo サブコマンドの `not_run` の扱いも変えません。executor の `requires_human` は block の理由にせず、runner が edit result の申し送りへ「人の確認が必要: `<コマンド>`(<要約>)」として機械的に追記します。項目は review へ進み、人が確認してから close します。
|
|
594
613
|
- `completion_status` は作業の完了状態を示す省略可能な欄で、値は `complete` / `incomplete` です。欄のない既存の報告は `complete` として扱います。値が指定されていてこの 2 値に合わない場合は、安全側に倒して `incomplete` として保存します。executor は計画の作業を終えられなかった場合、`incomplete` とし、理由を `final_message`、残作業を `handoff` に書きます。終了コード 0 や親検証の成功では未完了の申告を上書きしません。`exec run --register` は親検証・reporter を起動する前に停止し、項目を `waiting` にして、秘匿処理・文字数制限を適用した `final_message` の要旨を `block_reason` に記録します。worktree 実行では変更と evidence を残し、統合しません。pipeline の executor は `blocked`、evidence の `stage.status` と `exit_code` は実際のプロセス結果のままとします。`--resume --resume-from executor`(または `--resume`)で再開でき、前回の理由と `handoff`、途中の変更を executor に引き継ぎます。完了を申告し直し、必要な検証を通過してから review・統合へ進みます。
|
|
@@ -663,7 +682,7 @@ claude と codex は normal と expert の 2 段を持ちます(0.4.6 から
|
|
|
663
682
|
|
|
664
683
|
init は選んだ provider の実体だけを名簿へ書き、別名は向き先の実体が選ばれたものだけを残します。次の手順の案内(`--executor-by` / `--reporter-by`)には別名を示します。antigravity の `agent-members-snippet.yaml` は実体を `disabled: true` で配布するため、別名は末尾にコメントの例として置きます。別名は無効な member を指せないので、向き先の実体を有効にしたものだけを `aliases` へ写します。
|
|
665
684
|
|
|
666
|
-
`gpt-6-astra`
|
|
685
|
+
`gpt-6-astra` は雛形の既定に入れません。使う場合は、次のように `proficiency: frontier` の実体を名簿へ足し、`--executor-by astra-executor` や `routing` で指名します。既存の起動設定には `providers.codex.command_params.by_proficiency.frontier: { effort: xhigh }` を追加します。
|
|
667
686
|
|
|
668
687
|
```yaml
|
|
669
688
|
members:
|
|
@@ -677,7 +696,7 @@ members:
|
|
|
677
696
|
mode: edit
|
|
678
697
|
stage_role: executor
|
|
679
698
|
capabilities: [web_search]
|
|
680
|
-
proficiency:
|
|
699
|
+
proficiency: frontier
|
|
681
700
|
priority: 1
|
|
682
701
|
persona: task-executor
|
|
683
702
|
scheduler_strategy: critical-first
|
|
@@ -86,6 +86,9 @@ register 実行は exec events を記録しないため、schedule の Ready・C
|
|
|
86
86
|
| plan を確認してから実行する | `exec plan` -> `exec run --plan` | 任意 | 任意 |
|
|
87
87
|
| worktree の各段階を人が確認する | `exec worktree prepare` から `remove` | 手動 | あり |
|
|
88
88
|
| 同じplanで複数agentを比較する | `exec trial run` | なし | agent別 |
|
|
89
|
+
| grade・`exec run`・build を混ぜた順番を予約して流す | `exec queue add` -> `exec queue run` | 予約ファイル | 段に依存 |
|
|
90
|
+
|
|
91
|
+
順番の予約は `<execution_path>/queues/<queue-id>.json` に残り、`exec queue status` と `exec status` の末尾の `queues:` で中身・進み具合・止まった段と理由を確かめます。段の書式と失敗時の扱いは [[specdojo:command-reference|コマンドリファレンス]] の「実行の予約(exec queue)」を参照してください。
|
|
89
92
|
|
|
90
93
|
`exec run --register ... --register-commit` は、各IDのcommit後にhookによる整形差分を同じcommitへ収束させ、対象差分が残っていないことを検証します。登録簿・派生ビュー・当該plan/resultはrunner管理パスとして扱い、その他の実行前からある利用者変更はcommitしません。過去の未commit plan/resultを検出した場合は、現在のIDへ混ぜず警告します。
|
|
91
94
|
|
|
@@ -138,14 +141,31 @@ specdojo exec run --project <project-id> --register PJR-00QV --worktree --join
|
|
|
138
141
|
| agent の同時実行数 | provider の `max_concurrency` をプロセスを跨いで数える | `exec/.locks/provider-<provider>/` |
|
|
139
142
|
| root での状態遷移・生成物の再生成・統合段 | start 遷移・checkpoint・develop への merge・wait commit・派生ビューの再生成を 1 つずつ実行する | `exec/.locks/exec-lifecycle/` |
|
|
140
143
|
| 親 runner の検証(`parent_validations`) | `pipeline.parent_validation_concurrency` をプロセスを跨いで数える | `exec/.locks/parent-validation/` |
|
|
144
|
+
| 変更範囲が重なる項目 | worktree 作成前に範囲を予約し、先行項目の統合後に次の項目を準備する | `exec/.locks/change-scopes/` |
|
|
141
145
|
| 同じ項目の二重実行 | 従来どおり register の start 遷移が防ぐ。遷移は上記の直列化の中で行うため、2 つの run が同時に通らない | - |
|
|
142
146
|
|
|
143
147
|
- 同時に動かせる run の数は `exec-defaults.yaml` の `run.max_concurrent_runs`(既定 4。最初の run を含む)で決まります。`1` にすると `--join` を無効にできます。
|
|
144
148
|
- 合流の枠が埋まっている場合は `--if-busy` に従います。routine から `--if-busy skip` で起動した場合は、従来どおり skip として記録されます。
|
|
145
149
|
- `--auto`、`--task`、`exec cycle`、`exec resume` など register の worktree 実行以外の run は、合流中の run が残っている間は busy として扱われます。
|
|
146
|
-
- 各 run
|
|
150
|
+
- 各 run は自分の項目の結果を持ちます。先行項目が未統合で失敗した場合、変更範囲が重なる後続項目は起動せず、先行項目の再開を促します。
|
|
147
151
|
- 枠の待ちは run のログに `Waiting for <provider> slot held by another exec run`、`Waiting for the register lifecycle lock held by another exec run`、`Waiting for parent validation slot held by another exec run` として出力されます。
|
|
148
152
|
|
|
153
|
+
親検証の時間切れを調べるときは、run の `evidence.json` と同じディレクトリの `parent-validation-metrics.jsonl` を確認します。trial では `exec/trials/<comparison-id>/trials/<trial-id>/` に保存します。再開時も追記するため、`batch_id` と検証の `id`・`repo` で絞って読みます。
|
|
154
|
+
|
|
155
|
+
| 記録 | 読み方 |
|
|
156
|
+
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
157
|
+
| `gate-queued` / `gate-acquired` | 枠の要求・取得時刻。`local_wait_ms` は同一プロセス内、`shared_wait_ms` は共有ロックの取得にかかった時間。各検証の `gate_wait_ms` はバッチ全体の待ち時間で、検証ごとの待ちの合計ではありません |
|
|
158
|
+
| `validation-start` / `validation-end` | `at` は UTC の記録時刻、`started_at` は開始時刻、`duration_ms` は単調時計で測った実行時間。`status`・`exit_code`・`timed_out` で終了状態を確認します |
|
|
159
|
+
| `validation-timeout` | 上限に達した時点で終了要求より先に保存します。`active_test_files` は開始通知があり終了通知のないテストファイル、`output_tail` は直近 16 Ki 文字の標準出力です。詳細な出力は従来の失敗ログも参照します |
|
|
160
|
+
| `load` | Linux の CPU・memory・I/O の PSI(`pressure`)、`loadavg`、`/proc/meminfo` 由来のメモリ・swap 使用量(bytes)。PSI の `avg10` などは待ちの割合、`total` は累積待ち時間(マイクロ秒)です。開始・終了・時間切れの差分で確認します |
|
|
161
|
+
| `activity` | `scope: project-locks` は同じ project の primary / join run の数と PID、および実行中 executor の子 PID・worktree 名。reporter と終了済み executor は数えません。共有ロックのない実行は `scope: process` として自プロセスだけを数えます |
|
|
162
|
+
|
|
163
|
+
このリポジトリの Vitest 設定は、親検証が渡す `SPECDOJO_PARENT_VALIDATION_METRICS=1` のときだけファイル開始・終了通知を出します。他リポジトリの検証でこの通知がない場合、`active_test_files` は空で、実行ファイルは未特定です。直近の出力が示す完了済みファイルを実行中と解釈しないでください。テストの初期化前の停止も通知がない場合があります。
|
|
164
|
+
|
|
165
|
+
負荷はホストの `/proc` が見せる値で、cgroup の上限とは一致しない場合があります。run 数は heartbeat が有効な枠のスナップショットです。executor 数はこの版の runner が起動したプロセスを対象とし、別 project、旧版の runner、手動起動のテストは含みません。executor の記録は `exec/.locks/metrics-executors/` に置き、終了時に除去し、異常終了で残っても PID が生存しなければ数えません。
|
|
166
|
+
|
|
167
|
+
取得できない負荷項目は省略し、計測先への書き込み失敗も検証の合否には影響させません。計測は待ちの要求・取得と検証の開始・終了・時間切れ時だけ行い、継続的なプロセス走査や I/O ベンチマークは行いません。記録は原因の切り分けに使い、同時数や時間上限を自動変更しません。
|
|
168
|
+
|
|
149
169
|
上限と現在の使用枠は `exec slots` で確認できます。ロックは取得しないため、実行中にいつでも実行できます。
|
|
150
170
|
|
|
151
171
|
```bash
|
|
@@ -164,6 +184,29 @@ provider opencode: 1/1
|
|
|
164
184
|
parent validations: 0/1
|
|
165
185
|
```
|
|
166
186
|
|
|
187
|
+
#### 1.4.2. 変更範囲が重なる項目の順番待ち
|
|
188
|
+
|
|
189
|
+
register の worktree 実行(同じ run の `--parallel` と別 run の `--join`)および schedule の `--auto` は、対象範囲を worktree 作成前に予約します。同じファイル、または一方のディレクトリが他方のパスを含む項目は、先行項目の統合後の HEAD から準備します。agent の終了や commit だけでは予約を解放しません。重ならない項目は並列に進めます。
|
|
190
|
+
|
|
191
|
+
範囲は次の和集合で求めます。
|
|
192
|
+
|
|
193
|
+
| 入力 | 推定する範囲 |
|
|
194
|
+
| -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
195
|
+
| 個票・既存 plan の `targets`、個票の `target_path` | doc ID を文書索引、未作成の成果物はカタログからパスへ解決する。`target_path` は作成前でも使う |
|
|
196
|
+
| 個票・既存 plan の本文 | バッククォート内のファイル・ディレクトリと、本文に書かれた `src/exec/run.ts` のような相対パス。個票は対応結果・関連ドキュメント以降を除く。plan は対象・入力・完了条件・作業内容など項目固有の節と finding だけを使い、共通の進め方・完了手順・異常終了条件・規約は除く。項目固有の実行記録パスも除外する |
|
|
197
|
+
| schedule の成果物 | `local_id` / `target_local_ids` と approach から導出する plan の対象文書 |
|
|
198
|
+
| approach の既定 | 通常は対象成果物。bootstrap・bootstrap-finalize・maintenance は `targets` から解決した個別の kata ファイルも含む。authoring の `targets` は先頭の出力だけを使い、後続の参考資料は含めない。変更許可用の kata ディレクトリ全体は自動追加しない。catalog-planning は共有索引を含むカタログディレクトリ、strategy-planning は対象 track の strategy / track ファイル |
|
|
199
|
+
|
|
200
|
+
ディレクトリは `src/exec/` のように書きます。`app:src/main.ts` は宣言済み product repo を表し、無修飾のパスは project repo として区別します。`./` と `..` を正規化し、行番号・`#関数名` はファイル単位へ広げます。glob は最初のワイルドカードより前のディレクトリ全体を予約します。本文の参照パスも安全側に含めるため、読み取り専用の資料が共通して待機する場合があります。宣言にない変更や別名パスまで静的に予測するものではありません。
|
|
201
|
+
|
|
202
|
+
`generated/` 配下と project repo で Git が無視するパス(派生一覧など)は、明示対象も含めて除外します。Git の判定に失敗した場合は `generated/` 以外の候補を残します。生成 plan の共通文に加え、項目固有の本文でも「保護された設定は変えない」「`CHANGELOG.md` は変えず」のように変更しないと明示した節のパスは除外します。同じ文の別の節や別の条件に書かれた変更対象と、明示した `targets` / `target_path` は残します。
|
|
203
|
+
|
|
204
|
+
範囲が空、または対象 doc ID の一部を解決できない場合は不明として扱います。`--unknown-scope parallel`(既定)は推定できた範囲だけで重複を判断し、不明部分は従来どおり並列を許可します。`--unknown-scope serialize` は、不明な項目を他の項目と直列化します。たとえば `exec run --auto --parallel 2 --unknown-scope serialize` で指定します。`--if-busy` は project / join 枠の待機方針であり、この範囲待ちとは別です。dry-run は範囲を予約しません。
|
|
205
|
+
|
|
206
|
+
待機時は `[scope] waiting: <項目> — <先行項目>: <重複範囲>` を出力し、`execution_path/exec/.locks/change-scopes/waits.jsonl` に日時・両項目・理由を追記します。起動できた項目は生成 plan の「変更範囲による実行待ち」にも記録し、統合して残します。schedule の非 loop 実行は従来どおり最大 `--parallel` 件を実行し、重複する項目の準備を前の統合後へ遅らせます。
|
|
207
|
+
|
|
208
|
+
統合前に失敗した予約と heartbeat が止まった予約は、未統合の障害として後続をエラーにし、無期限に待ち続けません。表示された先行項目を再開・再実行し、統合してから後続を流します。保持した worktree の衝突解消は既存の再開手順に従います。統合後の撤去・post-review の失敗は予約の解放を妨げません。
|
|
209
|
+
|
|
167
210
|
### 1.5. 実行eventの保存粒度
|
|
168
211
|
|
|
169
212
|
Schedule taskの状態eventは、`execution_path/exec/events/`へ1 event 1 JSONファイルで保存されます。ファイル名はUTC時刻、actor、task ID、event種別、衝突回避用の乱数を含みます。`exec refresh`などの読取処理は全eventを時系列に並べ、foldして現在状態を再構成します。この保存規範の正本は[[sysd-cross-cutting-policy|SpecDojo システム設計横断ルール]]の`scp-STA-001`です。
|