specdojo 0.2.1 → 0.3.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.
Files changed (168) hide show
  1. package/.github/agents/specdojo-orchestrator.md +165 -0
  2. package/CHANGELOG.md +280 -0
  3. package/README.md +92 -42
  4. package/dist/agent-response.js +20 -0
  5. package/dist/agent.js +4 -4
  6. package/dist/build-command.js +28 -8
  7. package/dist/dashboard.js +122 -1
  8. package/dist/devcontainer-command.js +43 -0
  9. package/dist/devcontainer-scaffold.js +165 -0
  10. package/dist/exec-agent-config.js +107 -9
  11. package/dist/exec-agent-git-state.js +18 -0
  12. package/dist/exec-agent-protected-config.js +46 -8
  13. package/dist/exec-evidence.js +254 -11
  14. package/dist/exec-handoff.js +336 -0
  15. package/dist/exec-parent-validation.js +317 -43
  16. package/dist/exec-pipeline-state.js +74 -9
  17. package/dist/exec-plans.js +115 -113
  18. package/dist/exec-protection-handoff.js +43 -2
  19. package/dist/exec-provider-scaffold.js +247 -15
  20. package/dist/exec-register-resume.js +65 -19
  21. package/dist/exec-register.js +9 -3
  22. package/dist/exec-repo-integration.js +811 -0
  23. package/dist/exec-repo-trace.js +182 -0
  24. package/dist/exec-reporter.js +613 -132
  25. package/dist/exec-results.js +81 -56
  26. package/dist/exec-run-lock.js +110 -107
  27. package/dist/exec-run.js +1585 -356
  28. package/dist/exec-shared.js +7 -0
  29. package/dist/exec-slot-lock.js +242 -0
  30. package/dist/exec-task-repos.js +415 -0
  31. package/dist/exec-trial.js +51 -25
  32. package/dist/exec-worktree-command.js +87 -43
  33. package/dist/exec-worktree-ops.js +502 -57
  34. package/dist/exec-worktree.js +114 -27
  35. package/dist/exec.js +13 -6
  36. package/dist/grade-result.js +128 -0
  37. package/dist/grade.js +809 -72
  38. package/dist/init-command.js +443 -0
  39. package/dist/job.js +160 -10
  40. package/dist/orchestrator.js +213 -0
  41. package/dist/register-event-merge.js +169 -0
  42. package/dist/register-item.js +7 -1
  43. package/dist/register.js +294 -86
  44. package/dist/review-grade.js +252 -0
  45. package/dist/review-plan.js +111 -1
  46. package/dist/review-types.js +40 -1
  47. package/dist/routine.js +72 -5
  48. package/dist/schedule-build.js +2 -2
  49. package/dist/schedule.js +17 -4
  50. package/dist/specdojo-config.js +465 -19
  51. package/dist/specdojo-gitignore.js +135 -0
  52. package/dist/specdojo.js +6 -0
  53. package/dist/viewpoint-document-kinds-check.js +128 -0
  54. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +348 -90
  55. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +51 -17
  56. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +7 -5
  57. package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +29 -31
  58. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +34 -55
  59. package/docs/ja/specdojo/exec-templates/xrp-job-template.md +54 -0
  60. package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +28 -37
  61. package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +29 -34
  62. package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +30 -30
  63. package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +29 -34
  64. package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +29 -34
  65. package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +29 -34
  66. package/docs/ja/specdojo/exec-templates/xrp-template.md +29 -28
  67. package/docs/ja/specdojo/exec-templates/xrr-template.md +11 -9
  68. package/docs/ja/specdojo/guides/docs-editing-guide.md +20 -0
  69. package/docs/ja/specdojo/guides/docs-structure-guide.md +103 -70
  70. package/docs/ja/specdojo/guides/exec-config-guide.md +91 -47
  71. package/docs/ja/specdojo/guides/exec-operation-guide.md +124 -27
  72. package/docs/ja/specdojo/guides/exec-worktree-guide.md +40 -11
  73. package/docs/ja/specdojo/guides/kata-guide.md +4 -4
  74. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +25 -4
  75. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +1 -1
  76. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +13 -13
  77. package/docs/ja/specdojo/guides/quick-start-guide.md +260 -30
  78. package/docs/ja/specdojo/guides/register-operation-guide.md +31 -14
  79. package/docs/ja/specdojo/guides/release-v0-3-0-migration-guide.md +264 -0
  80. package/docs/ja/specdojo/guides/remote-host-development-guide.md +22 -1
  81. package/docs/ja/specdojo/guides/review-guide.md +195 -158
  82. package/docs/ja/specdojo/guides/routine-operation-guide.md +74 -9
  83. package/docs/ja/specdojo/guides/ryu-guide.md +32 -30
  84. package/docs/ja/specdojo/guides/schedule-design-guide.md +10 -10
  85. package/docs/ja/specdojo/guides/schedule-operation-guide.md +1 -1
  86. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +58 -33
  87. package/docs/ja/specdojo/guides/use-case-guide.md +3 -3
  88. package/docs/ja/specdojo/guides/waza-guide.md +15 -2
  89. package/docs/ja/specdojo/index.md +2 -2
  90. package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +5 -5
  91. package/docs/ja/specdojo/recipes/bps-recipe.md +213 -0
  92. package/docs/ja/specdojo/recipes/pm-members-recipe.md +52 -117
  93. package/docs/ja/specdojo/references/command-reference.md +335 -92
  94. package/docs/ja/specdojo/references/deliverables-reference.md +1 -1
  95. package/docs/ja/specdojo/references/directory-layout-reference.md +13 -9
  96. package/docs/ja/specdojo/references/specdojo-config-reference.md +107 -24
  97. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +132 -220
  98. package/docs/ja/specdojo/rulebooks/br-rulebook.md +6 -44
  99. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +2 -0
  100. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +0 -87
  101. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +61 -39
  102. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +0 -87
  103. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +1 -33
  104. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +0 -137
  105. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +0 -247
  106. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +0 -83
  107. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +4 -2
  108. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +78 -150
  109. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +5 -4
  110. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +1 -1
  111. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +0 -11
  112. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +0 -61
  113. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +2 -47
  114. package/docs/ja/specdojo/samples/bps-sample.md +74 -21
  115. package/docs/ja/specdojo/samples/gl-sample.yaml +17 -1
  116. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +28 -0
  117. package/docs/ja/specdojo/samples/pm-members-sample.yaml +2 -67
  118. package/docs/ja/specdojo/samples/pm-organization-sample.md +8 -7
  119. package/docs/ja/specdojo/samples/pm-raci-sample.md +1 -1
  120. package/docs/ja/specdojo/samples/tml-sample.yaml +40 -0
  121. package/docs/ja/specdojo/standards/document-metadata-standard.md +21 -16
  122. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +14 -14
  123. package/docs/ja/specdojo/standards/job-definition-standard.md +37 -17
  124. package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +37 -32
  125. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -1
  126. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +21 -11
  127. package/docs/ja/specdojo/templates/agent-members-template.yaml +25 -0
  128. package/docs/ja/specdojo/templates/bps-template.md +91 -0
  129. package/docs/ja/specdojo/templates/pm-members-template.yaml +2 -59
  130. package/docs/specdojo/schemas/v1/agent-members.schema.yaml +76 -0
  131. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +4 -2
  132. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +55 -2
  133. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +93 -6
  134. package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +27 -78
  135. package/docs/specdojo/schemas/v1/gl.schema.yaml +87 -0
  136. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +33 -0
  137. package/docs/specdojo/schemas/v1/job-run.schema.yaml +27 -0
  138. package/docs/specdojo/schemas/v1/job.schema.yaml +25 -0
  139. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +49 -1
  140. package/docs/specdojo/schemas/v1/pm-members.schema.yaml +9 -169
  141. package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +100 -10
  142. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +13 -0
  143. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +3 -0
  144. package/docs/specdojo/schemas/v1/routine.schema.yaml +7 -0
  145. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +110 -0
  146. package/package.json +15 -9
  147. package/templates/antigravity/README.md +27 -2
  148. package/templates/antigravity/{pm-members-snippet.yaml → agent-members-snippet.yaml} +8 -2
  149. package/templates/antigravity/exec-defaults-snippet.yaml +7 -6
  150. package/templates/antigravity/orchestrator.md +18 -7
  151. package/templates/antigravity/settings.global.json +55 -0
  152. package/templates/claude/agents/claude-executor.md +14 -0
  153. package/templates/claude/agents/claude-reporter.md +16 -0
  154. package/templates/claude/agents/specdojo-orchestrator.md +18 -7
  155. package/templates/claude/settings.edit.json +27 -1
  156. package/templates/codex/README.md +5 -4
  157. package/templates/codex/agents/specdojo-orchestrator.toml +18 -7
  158. package/templates/codex/orchestrator.md +18 -7
  159. package/templates/copilot/README.md +7 -5
  160. package/templates/copilot/{pm-members-snippet.yaml → agent-members-snippet.yaml} +4 -2
  161. package/templates/devcontainer/devcontainer.json +27 -0
  162. package/templates/devcontainer/emacs/init.el +88 -0
  163. package/templates/devcontainer/post-create.sh +62 -0
  164. package/templates/init-agent-members.yaml +200 -0
  165. package/templates/init-exec-defaults.yaml +72 -0
  166. package/templates/opencode/agents/specdojo-orchestrator.md +18 -7
  167. package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +0 -7
  168. package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +0 -7
@@ -0,0 +1,165 @@
1
+ import { existsSync } from "node:fs";
2
+ import { readFile, writeFile, mkdir } from "node:fs/promises";
3
+ import * as path from "node:path";
4
+ function repositoryVolumePrefix(repoRoot) {
5
+ const repositoryName = path.basename(path.resolve(repoRoot)).toLowerCase();
6
+ const safeName = repositoryName.replace(/[^a-z0-9_.-]+/g, "-").replace(/^[._-]+|[._-]+$/g, "");
7
+ return safeName || "project";
8
+ }
9
+ export async function runDevcontainerScaffold(opts) {
10
+ const { packageRoot, repoRoot, providers, editors, ollama, cron, tmux, force, dryRun } = opts;
11
+ const devcontainerDir = path.join(repoRoot, ".devcontainer");
12
+ if (existsSync(devcontainerDir) && !force) {
13
+ if (dryRun) {
14
+ process.stdout.write(`[dry-run] skipped: .devcontainer/ already exists\n`);
15
+ }
16
+ else {
17
+ process.stdout.write(`Skipped (already exists): .devcontainer/\n`);
18
+ }
19
+ return;
20
+ }
21
+ const templateDir = path.join(packageRoot, "templates", "devcontainer");
22
+ if (!existsSync(templateDir)) {
23
+ throw new Error(`Template directory not found: ${templateDir}`);
24
+ }
25
+ // devcontainer.json をパースして改変する
26
+ const devcontainerJsonPath = path.join(templateDir, "devcontainer.json");
27
+ const baseJsonStr = await readFile(devcontainerJsonPath, "utf8");
28
+ const devcontainer = JSON.parse(baseJsonStr);
29
+ const volumePrefix = repositoryVolumePrefix(repoRoot);
30
+ const volumeName = (name) => `${volumePrefix}-specdojo-${name}`;
31
+ devcontainer.mounts = devcontainer.mounts.map((mount) => mount.replace(/^source=specdojo-/, `source=${volumePrefix}-specdojo-`));
32
+ const postCreateScriptPath = path.join(templateDir, "post-create.sh");
33
+ let postCreateScript = await readFile(postCreateScriptPath, "utf8");
34
+ // options に応じて json と script を改変
35
+ const aptPackages = [];
36
+ const extraScripts = [];
37
+ let emacsInitTemplate;
38
+ if (tmux) {
39
+ aptPackages.push("tmux");
40
+ }
41
+ if (cron) {
42
+ aptPackages.push("cron");
43
+ devcontainer.postAttachCommand = "sudo service cron start";
44
+ }
45
+ const knownEditors = new Set(["emacs"]);
46
+ for (const editor of editors) {
47
+ if (!knownEditors.has(editor)) {
48
+ process.stdout.write(`Warning: unknown editor "${editor}"\n`);
49
+ }
50
+ if (editor === "emacs") {
51
+ aptPackages.push("emacs-nox", "ripgrep");
52
+ emacsInitTemplate = await readFile(path.join(templateDir, "emacs", "init.el"), "utf8");
53
+ extraScripts.push(`sudo npm install --global \\
54
+ typescript@6.0.3 \\
55
+ typescript-language-server@6.0.1 \\
56
+ yaml-language-server@1.24.0 \\
57
+ bash-language-server@5.8.1
58
+
59
+ MARKSMAN_VERSION="2026-02-08"
60
+ case "$(dpkg --print-architecture)" in
61
+ amd64)
62
+ MARKSMAN_ARCH="x64"
63
+ MARKSMAN_SHA256="be5098e8213219269c47fc0d916a66fa31ce0602ec967475c722260aabf26087"
64
+ ;;
65
+ arm64)
66
+ MARKSMAN_ARCH="arm64"
67
+ MARKSMAN_SHA256="db8e124527f7f8048e3e6c91821b9c52ef173d92c01e47d221bf1337afd962fb"
68
+ ;;
69
+ *)
70
+ echo "Unsupported architecture for Marksman: $(dpkg --print-architecture)" >&2
71
+ exit 1
72
+ ;;
73
+ esac
74
+ curl -fsSL --retry 3 \\
75
+ "https://github.com/artempyanykh/marksman/releases/download/$MARKSMAN_VERSION/marksman-linux-$MARKSMAN_ARCH" \\
76
+ -o /tmp/marksman
77
+ echo "$MARKSMAN_SHA256 /tmp/marksman" | sha256sum -c -
78
+ sudo install -m 0755 /tmp/marksman /usr/local/bin/marksman
79
+ rm -f /tmp/marksman
80
+
81
+ # Keep dotfiles authoritative: install the bundled defaults only when no supported init file exists.
82
+ if [ ! -f "$HOME/.emacs" ] && \\
83
+ [ ! -f "$HOME/.emacs.el" ] && \\
84
+ [ ! -f "$HOME/.emacs.d/init.el" ] && \\
85
+ [ ! -f "$HOME/.config/emacs/init.el" ]; then
86
+ if [ -d "$HOME/.emacs.d" ]; then
87
+ EMACS_INIT="$HOME/.emacs.d/init.el"
88
+ else
89
+ EMACS_INIT="$HOME/.config/emacs/init.el"
90
+ fi
91
+ mkdir -p "$(dirname "$EMACS_INIT")"
92
+ cp .devcontainer/emacs/init.el "$EMACS_INIT"
93
+ echo "Installed Emacs init: $EMACS_INIT"
94
+ fi`);
95
+ }
96
+ }
97
+ if (aptPackages.length > 0) {
98
+ devcontainer.features["ghcr.io/rocker-org/devcontainer-features/apt-packages:1"] = {
99
+ packages: aptPackages.join(","),
100
+ upgradePackages: false,
101
+ };
102
+ }
103
+ if (ollama) {
104
+ devcontainer.containerEnv["OLLAMA_BASE_URL"] = "http://host.docker.internal:11434";
105
+ devcontainer.containerEnv["LOCAL_OPENAI_BASE_URL"] = "http://host.docker.internal:11434/v1";
106
+ }
107
+ // providers の処理
108
+ const knownProviders = new Set(["claude", "codex", "opencode", "antigravity"]);
109
+ for (const provider of providers) {
110
+ if (!knownProviders.has(provider)) {
111
+ process.stdout.write(`Warning: unknown provider "${provider}"\n`);
112
+ }
113
+ if (provider === "claude") {
114
+ devcontainer.mounts.push(`source=${volumeName("claude")},target=/home/node/.claude,type=volume`);
115
+ devcontainer.containerEnv["CLAUDE_CONFIG_DIR"] = "/home/node/.claude";
116
+ extraScripts.push('if ! curl -fsSL https://claude.ai/install.sh | bash; then\n echo "Warning: Claude Code installer failed."\nfi');
117
+ }
118
+ else if (provider === "codex") {
119
+ devcontainer.runArgs = devcontainer.runArgs ?? [];
120
+ if (!devcontainer.runArgs.includes("--security-opt=seccomp=unconfined")) {
121
+ devcontainer.runArgs.push("--security-opt=seccomp=unconfined");
122
+ }
123
+ devcontainer.mounts.push(`source=${volumeName("codex")},target=/home/node/.codex,type=volume`);
124
+ extraScripts.push("if dpkg-query -W -f='${Status}' bubblewrap 2>/dev/null | grep -qx 'install ok installed'; then\n if ! sudo apt-get remove -y bubblewrap; then\n echo \"Warning: Failed to remove system bubblewrap; Codex sandbox may not start.\" >&2\n fi\nfi");
125
+ // 本リポジトリの devcontainer と同じく公式の install.sh を使い、失敗したら npm で入れる。
126
+ extraScripts.push('if ! curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_NON_INTERACTIVE=1 sh; then\n echo "Warning: Codex installer failed; falling back to npm."\n sudo npm install -g @openai/codex@latest\nfi');
127
+ }
128
+ else if (provider === "opencode") {
129
+ devcontainer.mounts.push(`source=${volumeName("opencode")},target=/home/node/.config/opencode,type=volume`, `source=${volumeName("opencode-data")},target=/home/node/.local/share/opencode,type=volume`);
130
+ devcontainer.containerEnv["OPENCODE_DISABLE_AUTO_UPDATE"] = "1";
131
+ // 本リポジトリで設定を確かめている opencode の npm パッケージ(opencode-ai)を使う。
132
+ extraScripts.push("sudo npm install -g opencode-ai@latest");
133
+ }
134
+ else if (provider === "antigravity") {
135
+ devcontainer.mounts.push(`source=${volumeName("antigravity")},target=/home/node/.config/antigravity,type=volume`);
136
+ extraScripts.push('if ! curl -fsSL https://antigravity.google/cli/install.sh | bash; then\n echo "Warning: Antigravity CLI installer failed."\nfi');
137
+ }
138
+ }
139
+ if (extraScripts.length > 0) {
140
+ postCreateScript = postCreateScript.replace("npm install", extraScripts.join("\n\n") + "\n\nnpm install");
141
+ }
142
+ if (dryRun) {
143
+ process.stdout.write(`[dry-run] would write: .devcontainer/devcontainer.json\n`);
144
+ process.stdout.write(`[dry-run] would write: .devcontainer/post-create.sh\n`);
145
+ if (emacsInitTemplate !== undefined) {
146
+ process.stdout.write(`[dry-run] would write: .devcontainer/emacs/init.el\n`);
147
+ }
148
+ return;
149
+ }
150
+ await mkdir(devcontainerDir, { recursive: true });
151
+ await writeFile(path.join(devcontainerDir, "devcontainer.json"), JSON.stringify(devcontainer, null, 2) + "\n", "utf8");
152
+ await writeFile(path.join(devcontainerDir, "post-create.sh"), postCreateScript, "utf8");
153
+ if (emacsInitTemplate !== undefined) {
154
+ await mkdir(path.join(devcontainerDir, "emacs"), { recursive: true });
155
+ await writeFile(path.join(devcontainerDir, "emacs", "init.el"), emacsInitTemplate, "utf8");
156
+ }
157
+ process.stdout.write(`Written: .devcontainer/devcontainer.json\n`);
158
+ process.stdout.write(`Written: .devcontainer/post-create.sh\n`);
159
+ if (emacsInitTemplate !== undefined) {
160
+ process.stdout.write(`Written: .devcontainer/emacs/init.el\n`);
161
+ }
162
+ process.stdout.write("Next steps:\n" +
163
+ " 1. Commit the scaffolded files.\n" +
164
+ " 2. Open this directory in a Dev Container (VS Code or compatible editor).\n");
165
+ }
@@ -1,17 +1,14 @@
1
1
  import { existsSync } from "node:fs";
2
2
  import { join } from "node:path";
3
3
  import { listFilesRecursive, readYaml } from "./exec-shared.js";
4
+ import { acquirePoolSlot, releaseLock } from "./exec-slot-lock.js";
4
5
  import { specdojoRootDir, } from "./specdojo-config.js";
5
- import { resolveParentValidationDefinitions } from "./exec-parent-validation.js";
6
+ import { resolveParentValidationConcurrency, resolveParentValidationDefinitions, } from "./exec-parent-validation.js";
6
7
  const PLACEHOLDER_PATTERN = /\{([a-z][a-z0-9_]*)\}/g;
7
8
  const BUILTIN_VARIABLE_NAMES = new Set(["nickname", "mode", "proficiency"]);
8
- // Mirror of the nickname pattern in docs/specdojo/schemas/v1/pm-members.schema.yaml
9
- // ($defs.Member.nickname). Defense in depth: a nickname is expanded into a provider's
10
- // command_template and the result is executed with { shell: true }. loadMemberRoster reads
11
- // pm-members.yaml without schema validation, so a roster edited to carry shell metacharacters
12
- // in a nickname could inject an arbitrary command. Re-check the value here, at the point where
13
- // it enters the command, and refuse to build a command for a nickname that the schema would
14
- // have rejected. Keep this pattern byte-for-byte in sync with the schema.
9
+ // Mirror of the nickname pattern in docs/specdojo/schemas/v1/agent-members.schema.yaml.
10
+ // The runtime loader validates the registry; this remains defense in depth immediately before
11
+ // command_template interpolation and shell execution.
15
12
  const NICKNAME_PATTERN = /^[a-z0-9][a-z0-9_-]{0,62}$/;
16
13
  // True when the member has any command source: an explicit override or a provider
17
14
  // command_template. Used to filter selectable agents without expanding the template.
@@ -26,7 +23,7 @@ function buildCommandVariables(provider, member, params) {
26
23
  const variables = new Map();
27
24
  if (!NICKNAME_PATTERN.test(member.nickname)) {
28
25
  throw new Error(`Invalid nickname ${JSON.stringify(member.nickname)} for provider ${provider}: ` +
29
- `must match ${NICKNAME_PATTERN.source} (pm-members.schema.yaml). ` +
26
+ `must match ${NICKNAME_PATTERN.source} (agent-members.schema.yaml). ` +
30
27
  `nickname is expanded into command_template and executed with shell: true; ` +
31
28
  `refusing to build a command.`);
32
29
  }
@@ -126,6 +123,105 @@ export function createProviderCapacityTracker(config) {
126
123
  },
127
124
  };
128
125
  }
126
+ export function providerSlotPoolPath(lockRoot, provider) {
127
+ return join(lockRoot, `provider-${provider}`);
128
+ }
129
+ export const DEFAULT_MAX_CONCURRENT_RUNS = 4;
130
+ export const DEFAULT_REGISTER_EXECUTION = "in-place";
131
+ // Preserve the historical default for repositories that have not opted into worktree execution.
132
+ // Invalid YAML-sourced values are rejected instead of silently changing where agents write.
133
+ export function resolveRegisterExecution(config) {
134
+ const raw = config.run?.register_execution;
135
+ if (raw === undefined)
136
+ return DEFAULT_REGISTER_EXECUTION;
137
+ if (raw !== "in-place" && raw !== "worktree") {
138
+ throw new Error(`run.register_execution in exec-defaults must be "in-place" or "worktree": ${String(raw)}`);
139
+ }
140
+ return raw;
141
+ }
142
+ // Resolve how many `exec run` processes may run at once for one project. Invalid values fall back
143
+ // to the default so a typo cannot silently disable the busy guard.
144
+ export function resolveMaxConcurrentRuns(config) {
145
+ const raw = config.run?.max_concurrent_runs;
146
+ if (typeof raw !== "number" || !Number.isInteger(raw) || raw < 1) {
147
+ return DEFAULT_MAX_CONCURRENT_RUNS;
148
+ }
149
+ return raw;
150
+ }
151
+ // Waits for provider capacity instead of dropping work. Register worktree runs already have a
152
+ // fixed item-to-agent assignment, so unlike auto selection they cannot switch to another provider
153
+ // when a cap is full; each pipeline stage queues until that provider has room.
154
+ //
155
+ // When `lockRoot` is given, the cap also holds across `exec run` processes: after taking an
156
+ // in-process slot, the stage takes one of the provider's slot locks under
157
+ // `<lockRoot>/provider-<name>/`. The in-process queue keeps arrival order within the process;
158
+ // between processes the slot locks are polled without ordering guarantees.
159
+ export class ProviderConcurrencyGate {
160
+ config;
161
+ lockRoot;
162
+ log;
163
+ active = new Map();
164
+ waiters = new Map();
165
+ constructor(config, lockRoot, log = (line) => {
166
+ process.stdout.write(line);
167
+ }) {
168
+ this.config = config;
169
+ this.lockRoot = lockRoot;
170
+ this.log = log;
171
+ }
172
+ async run(provider, task, label) {
173
+ const release = await this.acquire(provider);
174
+ try {
175
+ const cap = resolveMaxConcurrency(this.config, provider);
176
+ if (!this.lockRoot || !provider || cap === undefined)
177
+ return await task();
178
+ const suffix = label ? `: ${label}` : "";
179
+ const slot = await acquirePoolSlot(providerSlotPoolPath(this.lockRoot, provider), cap, { actor: `provider:${provider}`, ...(label ? { label } : {}) }, {
180
+ onWait: () => this.log(` Waiting for ${provider} slot held by another exec run (max_concurrency: ${cap})${suffix}\n`),
181
+ });
182
+ try {
183
+ return await task();
184
+ }
185
+ finally {
186
+ releaseLock(slot);
187
+ }
188
+ }
189
+ finally {
190
+ release();
191
+ }
192
+ }
193
+ async acquire(provider) {
194
+ const cap = resolveMaxConcurrency(this.config, provider);
195
+ if (!provider || cap === undefined)
196
+ return () => undefined;
197
+ if ((this.active.get(provider) ?? 0) < cap) {
198
+ this.active.set(provider, (this.active.get(provider) ?? 0) + 1);
199
+ return () => this.release(provider);
200
+ }
201
+ await new Promise((resolve) => {
202
+ const queue = this.waiters.get(provider) ?? [];
203
+ queue.push(resolve);
204
+ this.waiters.set(provider, queue);
205
+ });
206
+ return () => this.release(provider);
207
+ }
208
+ release(provider) {
209
+ const queue = this.waiters.get(provider);
210
+ const next = queue?.shift();
211
+ if (queue?.length === 0)
212
+ this.waiters.delete(provider);
213
+ if (next) {
214
+ // Transfer the existing slot directly so a newly arriving task cannot overtake the queue.
215
+ next();
216
+ return;
217
+ }
218
+ const nextActive = (this.active.get(provider) ?? 1) - 1;
219
+ if (nextActive > 0)
220
+ this.active.set(provider, nextActive);
221
+ else
222
+ this.active.delete(provider);
223
+ }
224
+ }
129
225
  // ── Loaders ───────────────────────────────────────────────────────────────────
130
226
  export function defaultExecDefaultsPath() {
131
227
  return join(specdojoRootDir(), ".specdojo", "exec-defaults.yaml");
@@ -168,5 +264,7 @@ export function loadExecDefaultsConfig(configPath, executionPath) {
168
264
  defaults.rate_limit_policy = legacyPolicy;
169
265
  }
170
266
  resolveParentValidationDefinitions(defaults.pipeline?.parent_validations);
267
+ resolveParentValidationConcurrency(defaults.pipeline?.parent_validation_concurrency);
268
+ resolveRegisterExecution(defaults);
171
269
  return defaults;
172
270
  }
@@ -48,6 +48,24 @@ export function changedAgentGitStateFields(repoRoot, before) {
48
48
  changed.push("local-config");
49
49
  return changed;
50
50
  }
51
+ // PJR-98G4: プロダクト worktree も runner が commit を管理するため、同じ比較を全リポジトリで行う。
52
+ export function captureAgentGitStateAcrossRepos(repos) {
53
+ return repos.map((repo) => ({ repo, snapshot: captureAgentGitStateSnapshot(repo.root) }));
54
+ }
55
+ /** Changed Git state fields per repository; unchanged repositories are omitted. */
56
+ export function changedAgentGitStateAcrossRepos(before) {
57
+ return before
58
+ .map(({ repo, snapshot }) => ({
59
+ repo,
60
+ before: snapshot,
61
+ fields: changedAgentGitStateFields(repo.root, snapshot),
62
+ }))
63
+ .filter((change) => change.fields.length > 0);
64
+ }
65
+ /** Fields qualified with the product repository name (`<name>:HEAD`); project fields stay bare. */
66
+ export function qualifiedGitStateFields(changes) {
67
+ return changes.flatMap((change) => change.fields.map((field) => (change.repo.name ? `${change.repo.name}:${field}` : field)));
68
+ }
51
69
  function commandStdout(snapshot) {
52
70
  try {
53
71
  const parsed = JSON.parse(snapshot);
@@ -5,7 +5,7 @@ import { join, relative, sep } from "node:path";
5
5
  import { gitEnvironment, gitResult } from "./exec-worktree.js";
6
6
  // PJR-3S8Q で agent の書き込み対象外とした、親 runner / hook / CI の実行内容を
7
7
  // 変えられる設定パス。provider 設定から注入できない固定定義として CLI 側に持つ。
8
- const PROTECTED_DIRECTORY_PREFIXES = [
8
+ export const PROTECTED_DIRECTORY_PREFIXES = [
9
9
  "node_modules/",
10
10
  ".specdojo/",
11
11
  ".agents/rules/",
@@ -20,7 +20,7 @@ const PROTECTED_DIRECTORY_PREFIXES = [
20
20
  ".azure-pipelines/",
21
21
  ".jenkins/",
22
22
  ];
23
- const PROTECTED_EXACT_PATHS = new Set([
23
+ export const PROTECTED_EXACT_PATHS = new Set([
24
24
  "package.json",
25
25
  "AGENTS.md",
26
26
  "CLAUDE.md",
@@ -62,6 +62,9 @@ const GENERATED_PATHS = new Set([
62
62
  ".opencode/bun.lock",
63
63
  ".claude/settings.local.json",
64
64
  ]);
65
+ // git の ignore 判定が行えない場合でも除外してよい生成物。内容が設定として働かず、
66
+ // 親 runner / hook / CI の実行内容や agent の権限を変えないものだけを列挙する。
67
+ const SAFE_WHEN_IGNORE_UNKNOWN = new Set([".specdojo/doc-index.json"]);
65
68
  // provider が agent 実行時に作る作業ディレクトリ。配下のファイル数が多く個別に列挙できないため
66
69
  // prefix で判定する。GENERATED_PATHS と同じく、ignore 済みであることを併せて条件にする。
67
70
  const GENERATED_DIRECTORY_PREFIXES = [".opencode/node_modules/", ".claude/worktrees/"];
@@ -70,6 +73,10 @@ function isGeneratedCandidate(path) {
70
73
  return true;
71
74
  return GENERATED_DIRECTORY_PREFIXES.some((prefix) => path.startsWith(prefix));
72
75
  }
76
+ function isGeneratedDirectoryRoot(path) {
77
+ const normalized = `${normalizeRepoPath(path).replace(/\/+$/, "")}/`;
78
+ return GENERATED_DIRECTORY_PREFIXES.some((prefix) => prefix === normalized);
79
+ }
73
80
  // `.specdojo/doc-index.json` のように、保護対象ディレクトリの下にある gitignore 済みの生成物を
74
81
  // 除外する。agent は共通規約に従って `index build` などの再生成コマンドを実行するため、生成物まで
75
82
  // 保護対象に含めると、規約どおりの検証を行っただけで違反として扱われてしまう。
@@ -91,9 +98,12 @@ function ignoredGeneratedPaths(repoRoot, candidates) {
91
98
  input: `${generatedCandidates.join("\0")}\0`,
92
99
  encoding: "utf8",
93
100
  });
94
- // 0: 1件以上が ignore 対象、1: 該当なし。それ以外は判定不能として除外しない。
101
+ // 0: 1件以上が ignore 対象、1: 該当なし。それ以外は git が使えないなどの異常系。
102
+ // 判定不能時は、内容が設定として働かない生成物(SAFE_WHEN_IGNORE_UNKNOWN)だけを除外し、
103
+ // それ以外は保護対象に残す。`.claude/settings.local.json` のように権限規則を書ける
104
+ // ファイルを判定不能のまま除外すると、保護をすり抜けられるため。
95
105
  if (result.error || (result.status !== 0 && result.status !== 1))
96
- return new Set();
106
+ return new Set(generatedCandidates.filter((path) => SAFE_WHEN_IGNORE_UNKNOWN.has(path)));
97
107
  return new Set((result.stdout ?? "")
98
108
  .split("\0")
99
109
  .filter((path) => path !== "")
@@ -108,7 +118,9 @@ export function isAgentProtectedConfigPath(path) {
108
118
  return true;
109
119
  if (PROTECTED_DIRECTORY_PREFIXES.some((prefix) => normalized.startsWith(prefix)))
110
120
  return true;
111
- return /^(?:commitlint\.config\.[^/]+|\.commitlintrc(?:\.[^/]+)?)$/.test(normalized);
121
+ if (/^(?:commitlint\.config\.[^/]+|\.commitlintrc(?:\.[^/]+)?)$/.test(normalized))
122
+ return true;
123
+ return false;
112
124
  }
113
125
  // snapshot と統合直前の再検査で同じ保護境界を使う。isAgentProtectedConfigPath は
114
126
  // path だけで設定候補を分類し、この関数が repository の ignore 規則と既知の生成物定義を
@@ -144,9 +156,11 @@ function addTreeFiles(repoRoot, rootPath, out) {
144
156
  const entryPath = join(rootPath, entry.name);
145
157
  if (entry.isDirectory()) {
146
158
  // `.opencode/node_modules` のような実行時生成ディレクトリは数百〜数千ファイルになる。
147
- // 走査して fingerprint を取っても結果は除外されるため、入口で辿らない。
159
+ // ignore 済みなら走査して fingerprint を取っても結果は除外されるため、入口で辿らない。
160
+ // ignore されていない場合や git の判定に失敗した場合は、保護対象として検出するため走査する。
148
161
  const relDir = normalizeRepoPath(relative(repoRoot, entryPath).split(sep).join("/"));
149
- if (GENERATED_DIRECTORY_PREFIXES.some((prefix) => `${relDir}/` === prefix))
162
+ if (isGeneratedDirectoryRoot(relDir) &&
163
+ ignoredGeneratedPaths(repoRoot, [`${relDir}/`]).has(`${relDir}/`))
150
164
  continue;
151
165
  addTreeFiles(repoRoot, entryPath, out);
152
166
  continue;
@@ -184,6 +198,28 @@ export function changedAgentProtectedConfigPaths(repoRoot, before) {
184
198
  .filter((path) => before.get(path) !== after.get(path))
185
199
  .sort((a, b) => a.localeCompare(b));
186
200
  }
201
+ /** Qualify a repository-relative path with its product repository name (`<name>:<path>`). */
202
+ export function qualifyRepoPath(repo, path) {
203
+ return repo.name ? `${repo.name}:${path}` : path;
204
+ }
205
+ // PJR-98G4: 保護パスの一覧はプロダクトリポジトリにもそのまま適用する。プロダクト側の
206
+ // `package.json` や CI 設定も、親 runner・hook・CI の実行内容を変えうるため。
207
+ export function captureAgentProtectedConfigAcrossRepos(repos) {
208
+ return repos.map((repo) => ({ repo, snapshot: captureAgentProtectedConfigSnapshot(repo.root) }));
209
+ }
210
+ /** Changed protected paths per repository; repositories without changes are omitted. */
211
+ export function changedAgentProtectedConfigAcrossRepos(before) {
212
+ return before
213
+ .map(({ repo, snapshot }) => ({
214
+ repo,
215
+ paths: changedAgentProtectedConfigPaths(repo.root, snapshot),
216
+ }))
217
+ .filter((change) => change.paths.length > 0);
218
+ }
219
+ /** Flatten per-repository changes to qualified paths for block messages. */
220
+ export function qualifiedRepoPaths(changes) {
221
+ return changes.flatMap((change) => change.paths.map((path) => qualifyRepoPath(change.repo, path)));
222
+ }
187
223
  function gitFailure(result) {
188
224
  const detail = result.error?.message || (typeof result.stderr === "string" ? result.stderr : "");
189
225
  const normalized = detail.trim().replace(/\s+/g, " ");
@@ -231,7 +267,9 @@ function addedFileDiff(repoRoot, path, note) {
231
267
  const lines = content.split("\n");
232
268
  if (lines.at(-1) === "")
233
269
  lines.pop();
234
- return [header, ...lines.map((line) => `+${line}`)].join("\n");
270
+ if (lines.length === 0)
271
+ return `${header}\n@@ -0,0 +0,0 @@`;
272
+ return [header, `@@ -0,0 +1,${lines.length} @@`, ...lines.map((line) => `+${line}`)].join("\n");
235
273
  }
236
274
  // 対象パスごとの提案差分を1つのテキストにまとめる。差分を取得できないパスは、
237
275
  // 取得できなかったことが分かる注記を残し、他パスの差分は落とさない。