specdojo 0.8.0 → 0.9.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.github/agents/specdojo-orchestrator.md +4 -1
- package/CHANGELOG.md +77 -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/orchestrator.js +5 -77
- package/dist/commands/where.js +25 -0
- package/dist/dashboard/dashboard.js +5 -3
- package/dist/dashboard/routines.js +4 -7
- package/dist/dashboard/shared.js +2 -2
- package/dist/dashboard/timeline.js +14 -14
- package/dist/deliverable/trash.js +2 -1
- 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/opencode-permissions.js +117 -0
- 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 +82 -0
- package/dist/exec/repo-integration-sync.js +17 -5
- package/dist/exec/repo-trace.js +2 -1
- 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 +5 -2
- 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 +2 -2
- package/dist/exec/smoke.js +190 -0
- package/dist/exec/strategy.js +13 -3
- package/dist/exec/task-repos.js +19 -4
- 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 +12 -2
- 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/register/renumber.js +1 -3
- 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 +17 -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/orchestrator-operation-guide.md +1 -1
- 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 +258 -118
- package/docs/ja/specdojo/references/deliverables-reference.md +21 -12
- package/docs/ja/specdojo/references/specdojo-config-reference.md +47 -10
- 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;
|
|
@@ -176,3 +184,11 @@ export const SENSITIVE_TEXT_RULES = [
|
|
|
176
184
|
export function redactSensitiveText(value) {
|
|
177
185
|
return SENSITIVE_TEXT_RULES.reduce((text, { pattern, replacement }) => text.replace(pattern, replacement), value);
|
|
178
186
|
}
|
|
187
|
+
// 正規表現のメタ文字をエスケープし、外から入る値をリテラルとして埋め込めるようにする。
|
|
188
|
+
export function escapeRegExp(value) {
|
|
189
|
+
return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
|
|
190
|
+
}
|
|
191
|
+
// Markdown 表のセルへ入れる文字列をエスケープする。先に `\` を `\\` にしてから `|` を `\|` にする。
|
|
192
|
+
export function escapeMarkdownTableCell(cell) {
|
|
193
|
+
return cell.replace(/\\/g, "\\\\").replace(/\|/g, "\\|");
|
|
194
|
+
}
|
|
@@ -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
|