specdojo 0.2.0 → 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 (170) hide show
  1. package/.github/agents/specdojo-orchestrator.md +165 -0
  2. package/CHANGELOG.md +280 -0
  3. package/README.md +143 -30
  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 +140 -9
  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-format.js +13 -4
  15. package/dist/exec-handoff.js +336 -0
  16. package/dist/exec-parent-validation.js +317 -43
  17. package/dist/exec-pipeline-state.js +74 -9
  18. package/dist/exec-plans.js +115 -113
  19. package/dist/exec-protection-handoff.js +43 -2
  20. package/dist/exec-provider-scaffold.js +247 -15
  21. package/dist/exec-register-resume.js +65 -19
  22. package/dist/exec-register.js +9 -3
  23. package/dist/exec-repo-integration.js +811 -0
  24. package/dist/exec-repo-trace.js +182 -0
  25. package/dist/exec-reporter.js +613 -132
  26. package/dist/exec-results.js +81 -56
  27. package/dist/exec-run-lock.js +110 -107
  28. package/dist/exec-run.js +1585 -356
  29. package/dist/exec-shared.js +7 -0
  30. package/dist/exec-slot-lock.js +242 -0
  31. package/dist/exec-task-repos.js +415 -0
  32. package/dist/exec-trial.js +51 -25
  33. package/dist/exec-worktree-command.js +87 -43
  34. package/dist/exec-worktree-ops.js +502 -57
  35. package/dist/exec-worktree.js +114 -27
  36. package/dist/exec.js +13 -6
  37. package/dist/grade-result.js +128 -0
  38. package/dist/grade.js +809 -72
  39. package/dist/init-command.js +443 -0
  40. package/dist/job.js +160 -10
  41. package/dist/orchestrator.js +213 -0
  42. package/dist/package-paths.js +19 -1
  43. package/dist/register-event-merge.js +169 -0
  44. package/dist/register-item.js +7 -1
  45. package/dist/register.js +294 -86
  46. package/dist/review-grade.js +252 -0
  47. package/dist/review-plan.js +111 -1
  48. package/dist/review-types.js +40 -1
  49. package/dist/routine.js +72 -5
  50. package/dist/schedule-build.js +2 -2
  51. package/dist/schedule.js +17 -4
  52. package/dist/specdojo-config.js +466 -20
  53. package/dist/specdojo-gitignore.js +135 -0
  54. package/dist/specdojo.js +8 -1
  55. package/dist/viewpoint-document-kinds-check.js +128 -0
  56. package/docs/ja/specdojo/defaults/pm-review-viewpoints.yaml +348 -90
  57. package/docs/ja/specdojo/exec-templates/xep-common-conventions-template.md +51 -17
  58. package/docs/ja/specdojo/exec-templates/xep-fully-guided-template.md +7 -5
  59. package/docs/ja/specdojo/exec-templates/xrp-freeform-template.md +29 -31
  60. package/docs/ja/specdojo/exec-templates/xrp-fully-guided-template.md +34 -55
  61. package/docs/ja/specdojo/exec-templates/xrp-job-template.md +54 -0
  62. package/docs/ja/specdojo/exec-templates/xrp-recipe-guided-template.md +28 -37
  63. package/docs/ja/specdojo/exec-templates/xrp-recipe-maintenance-template.md +29 -34
  64. package/docs/ja/specdojo/exec-templates/xrp-retrofit-template.md +30 -30
  65. package/docs/ja/specdojo/exec-templates/xrp-rulebook-maintenance-template.md +29 -34
  66. package/docs/ja/specdojo/exec-templates/xrp-sample-maintenance-template.md +29 -34
  67. package/docs/ja/specdojo/exec-templates/xrp-template-maintenance-template.md +29 -34
  68. package/docs/ja/specdojo/exec-templates/xrp-template.md +29 -28
  69. package/docs/ja/specdojo/exec-templates/xrr-template.md +11 -9
  70. package/docs/ja/specdojo/guides/docs-editing-guide.md +20 -0
  71. package/docs/ja/specdojo/guides/docs-structure-guide.md +103 -70
  72. package/docs/ja/specdojo/guides/exec-config-guide.md +91 -47
  73. package/docs/ja/specdojo/guides/exec-operation-guide.md +124 -27
  74. package/docs/ja/specdojo/guides/exec-worktree-guide.md +40 -11
  75. package/docs/ja/specdojo/guides/kata-guide.md +4 -4
  76. package/docs/ja/specdojo/guides/orchestrator-operation-guide.md +25 -4
  77. package/docs/ja/specdojo/guides/plan-result-lifecycle-guide.md +1 -1
  78. package/docs/ja/specdojo/guides/practice-system-composition-guide.md +13 -13
  79. package/docs/ja/specdojo/guides/quick-start-guide.md +261 -32
  80. package/docs/ja/specdojo/guides/register-operation-guide.md +31 -14
  81. package/docs/ja/specdojo/guides/release-v0-3-0-migration-guide.md +264 -0
  82. package/docs/ja/specdojo/guides/remote-host-development-guide.md +184 -0
  83. package/docs/ja/specdojo/guides/review-guide.md +195 -158
  84. package/docs/ja/specdojo/guides/routine-operation-guide.md +74 -9
  85. package/docs/ja/specdojo/guides/ryu-guide.md +32 -30
  86. package/docs/ja/specdojo/guides/schedule-design-guide.md +10 -10
  87. package/docs/ja/specdojo/guides/schedule-operation-guide.md +1 -1
  88. package/docs/ja/specdojo/guides/specdojo-overview-guide.md +58 -33
  89. package/docs/ja/specdojo/guides/use-case-guide.md +3 -3
  90. package/docs/ja/specdojo/guides/waza-guide.md +15 -2
  91. package/docs/ja/specdojo/index.md +2 -2
  92. package/docs/ja/specdojo/philosophy/specdojo-philosophy.md +5 -5
  93. package/docs/ja/specdojo/recipes/bps-recipe.md +213 -0
  94. package/docs/ja/specdojo/recipes/pm-members-recipe.md +52 -117
  95. package/docs/ja/specdojo/references/command-reference.md +336 -93
  96. package/docs/ja/specdojo/references/deliverables-reference.md +1 -1
  97. package/docs/ja/specdojo/references/directory-layout-reference.md +13 -9
  98. package/docs/ja/specdojo/references/specdojo-config-reference.md +107 -24
  99. package/docs/ja/specdojo/rulebooks/bps-rulebook.md +132 -220
  100. package/docs/ja/specdojo/rulebooks/br-rulebook.md +6 -44
  101. package/docs/ja/specdojo/rulebooks/cdfd-rulebook.md +2 -0
  102. package/docs/ja/specdojo/rulebooks/dmd-rulebook.md +0 -87
  103. package/docs/ja/specdojo/rulebooks/gl-rulebook.md +61 -39
  104. package/docs/ja/specdojo/rulebooks/ifx-cmd-rulebook.md +0 -87
  105. package/docs/ja/specdojo/rulebooks/ifx-index-rulebook.md +1 -33
  106. package/docs/ja/specdojo/rulebooks/opd-rulebook.md +0 -137
  107. package/docs/ja/specdojo/rulebooks/opr-rulebook.md +0 -247
  108. package/docs/ja/specdojo/rulebooks/otp-rulebook.md +0 -83
  109. package/docs/ja/specdojo/rulebooks/pjr-rulebook.md +4 -2
  110. package/docs/ja/specdojo/rulebooks/pm-members-rulebook.md +78 -150
  111. package/docs/ja/specdojo/rulebooks/pm-roles-rulebook.md +5 -4
  112. package/docs/ja/specdojo/rulebooks/sch-rulebook.md +1 -1
  113. package/docs/ja/specdojo/rulebooks/stsd-mermaid-rulebook.md +0 -11
  114. package/docs/ja/specdojo/rulebooks/stsd-rulebook.md +0 -61
  115. package/docs/ja/specdojo/rulebooks/tml-rulebook.md +2 -47
  116. package/docs/ja/specdojo/samples/bps-sample.md +74 -21
  117. package/docs/ja/specdojo/samples/gl-sample.yaml +17 -1
  118. package/docs/ja/specdojo/samples/ifx-index-sample.yaml +28 -0
  119. package/docs/ja/specdojo/samples/pm-members-sample.yaml +2 -67
  120. package/docs/ja/specdojo/samples/pm-organization-sample.md +8 -7
  121. package/docs/ja/specdojo/samples/pm-raci-sample.md +1 -1
  122. package/docs/ja/specdojo/samples/tml-sample.yaml +40 -0
  123. package/docs/ja/specdojo/standards/document-metadata-standard.md +21 -16
  124. package/docs/ja/specdojo/standards/id-and-file-naming-standard.md +14 -14
  125. package/docs/ja/specdojo/standards/job-definition-standard.md +37 -17
  126. package/docs/ja/specdojo/standards/people-and-organization-definition-standard.md +37 -32
  127. package/docs/ja/specdojo/standards/philosophy-authoring-standard.md +1 -1
  128. package/docs/ja/specdojo/standards/rulebook-authoring-standard.md +21 -11
  129. package/docs/ja/specdojo/templates/agent-members-template.yaml +25 -0
  130. package/docs/ja/specdojo/templates/bps-template.md +91 -0
  131. package/docs/ja/specdojo/templates/pm-members-template.yaml +2 -59
  132. package/docs/specdojo/schemas/v1/agent-members.schema.yaml +76 -0
  133. package/docs/specdojo/schemas/v1/exec-common.schema.yaml +4 -2
  134. package/docs/specdojo/schemas/v1/exec-defaults.schema.yaml +55 -2
  135. package/docs/specdojo/schemas/v1/exec-evidence.schema.yaml +93 -6
  136. package/docs/specdojo/schemas/v1/exec-reporter-output.schema.yaml +27 -78
  137. package/docs/specdojo/schemas/v1/gl.schema.yaml +87 -0
  138. package/docs/specdojo/schemas/v1/grade-result.schema.yaml +33 -0
  139. package/docs/specdojo/schemas/v1/job-run.schema.yaml +27 -0
  140. package/docs/specdojo/schemas/v1/job.schema.yaml +25 -0
  141. package/docs/specdojo/schemas/v1/pipeline-state.schema.yaml +49 -1
  142. package/docs/specdojo/schemas/v1/pm-members.schema.yaml +9 -169
  143. package/docs/specdojo/schemas/v1/pm-review-viewpoints.schema.yaml +100 -10
  144. package/docs/specdojo/schemas/v1/register-item-frontmatter.schema.yaml +13 -0
  145. package/docs/specdojo/schemas/v1/routine-run.schema.yaml +3 -0
  146. package/docs/specdojo/schemas/v1/routine.schema.yaml +7 -0
  147. package/docs/specdojo/schemas/v1/specdojo-config.schema.yaml +110 -0
  148. package/package.json +16 -9
  149. package/templates/antigravity/README.md +60 -0
  150. package/templates/antigravity/agent-members-snippet.yaml +61 -0
  151. package/templates/antigravity/exec-defaults-snippet.yaml +39 -0
  152. package/templates/antigravity/orchestrator.md +157 -0
  153. package/templates/antigravity/settings.global.json +55 -0
  154. package/templates/claude/agents/claude-executor.md +14 -0
  155. package/templates/claude/agents/claude-reporter.md +16 -0
  156. package/templates/claude/agents/specdojo-orchestrator.md +164 -0
  157. package/templates/claude/settings.edit.json +27 -1
  158. package/templates/codex/README.md +5 -4
  159. package/templates/codex/agents/specdojo-orchestrator.toml +165 -0
  160. package/templates/codex/orchestrator.md +157 -0
  161. package/templates/copilot/README.md +7 -5
  162. package/templates/copilot/{pm-members-snippet.yaml → agent-members-snippet.yaml} +4 -2
  163. package/templates/devcontainer/devcontainer.json +27 -0
  164. package/templates/devcontainer/emacs/init.el +88 -0
  165. package/templates/devcontainer/post-create.sh +62 -0
  166. package/templates/init-agent-members.yaml +200 -0
  167. package/templates/init-exec-defaults.yaml +72 -0
  168. package/templates/opencode/agents/specdojo-orchestrator.md +204 -0
  169. package/docs/ja/specdojo/exec-templates/xrp-viewpoint-detail-template.md +0 -7
  170. package/docs/ja/specdojo/exec-templates/xrr-viewpoint-detail-template.md +0 -7
@@ -0,0 +1,443 @@
1
+ import { createInterface } from "node:readline/promises";
2
+ import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
3
+ import { dirname, join, relative } from "node:path";
4
+ import yaml from "js-yaml";
5
+ import { runScaffold } from "./catalog-scaffold.js";
6
+ import { runDevcontainerScaffold } from "./devcontainer-scaffold.js";
7
+ import { runProviderScaffold } from "./exec-provider-scaffold.js";
8
+ import { generateDerivedViewFiles } from "./register.js";
9
+ import { defaultWorktreeBase, projectGitignoreLayout, specdojoRootDir, } from "./specdojo-config.js";
10
+ import { ensureGitignore, formatGitignoreReport, gitignorePatternsForLayouts, } from "./specdojo-gitignore.js";
11
+ import { specdojoPackageRootDir } from "./package-paths.js";
12
+ const PROVIDERS = ["claude", "codex", "opencode", "antigravity", "copilot"];
13
+ const PARENT_VALIDATION_SCRIPTS = {
14
+ "lint-ts": "lint:ts",
15
+ "lint-fm": "lint:fm",
16
+ "lint-md": "lint:md",
17
+ "test-integration": "test:integration",
18
+ "validate-schema": "validate:schema",
19
+ typecheck: "typecheck",
20
+ "test-unit": "test:unit",
21
+ };
22
+ const DEFAULTS = {
23
+ projectId: "prj-0001",
24
+ projectName: "My Project",
25
+ nickname: "owner",
26
+ displayName: "Project Owner",
27
+ providers: ["codex"],
28
+ };
29
+ function parseBoolean(answer, defaultValue) {
30
+ const normalized = answer.trim().toLowerCase();
31
+ if (!normalized)
32
+ return defaultValue;
33
+ if (["y", "yes", "true", "1", "はい"].includes(normalized))
34
+ return true;
35
+ if (["n", "no", "false", "0", "いいえ"].includes(normalized))
36
+ return false;
37
+ throw new Error(`yes/no で答えてください: ${answer}`);
38
+ }
39
+ function parseProviders(value) {
40
+ const raw = value?.trim();
41
+ if (!raw)
42
+ return [...DEFAULTS.providers];
43
+ if (raw === "none" || raw === "-")
44
+ return [];
45
+ const providers = [
46
+ ...new Set(raw
47
+ .split(",")
48
+ .map((item) => item.trim())
49
+ .filter(Boolean)),
50
+ ];
51
+ const unknown = providers.filter((provider) => !PROVIDERS.includes(provider));
52
+ if (unknown.length > 0) {
53
+ throw new Error(`Unknown provider: ${unknown.join(", ")}. Available: ${PROVIDERS.join(", ")}`);
54
+ }
55
+ return providers;
56
+ }
57
+ function parseCatalog(value) {
58
+ const normalized = value?.trim().toLowerCase();
59
+ if (!normalized || normalized === "none" || normalized === "-")
60
+ return undefined;
61
+ if (normalized === "small" || normalized === "medium" || normalized === "large") {
62
+ return normalized;
63
+ }
64
+ throw new Error(`Invalid catalog size: ${value}. Must be small, medium, large, or none`);
65
+ }
66
+ function validateAnswers(answers) {
67
+ if (!/^prj-[0-9]{4,}$/.test(answers.projectId)) {
68
+ throw new Error(`Invalid project ID: ${answers.projectId}. Expected prj-0001 style`);
69
+ }
70
+ if (!answers.projectName.trim())
71
+ throw new Error("Project name must not be empty");
72
+ if (!/^[a-z0-9][a-z0-9_-]{0,62}$/.test(answers.nickname)) {
73
+ throw new Error(`Invalid nickname: ${answers.nickname}`);
74
+ }
75
+ if (!answers.displayName.trim())
76
+ throw new Error("Display name must not be empty");
77
+ if (answers.exec && answers.providers.length === 0) {
78
+ throw new Error("--exec requires at least one --provider");
79
+ }
80
+ return answers;
81
+ }
82
+ export async function collectInitAnswers(options, prompter) {
83
+ if (!prompter) {
84
+ const answers = validateAnswers({
85
+ projectId: options.project?.trim() || DEFAULTS.projectId,
86
+ projectName: options.name?.trim() || DEFAULTS.projectName,
87
+ register: options.register !== false,
88
+ nickname: options.nickname?.trim() || DEFAULTS.nickname,
89
+ displayName: options.displayName?.trim() || DEFAULTS.displayName,
90
+ providers: parseProviders(options.provider),
91
+ exec: !!options.exec,
92
+ catalog: parseCatalog(options.catalog),
93
+ devcontainer: !!options.devcontainer,
94
+ });
95
+ for (const [label, used] of [
96
+ ["project", !options.project],
97
+ ["name", !options.name],
98
+ ["nickname", !options.nickname],
99
+ ["display-name", !options.displayName],
100
+ ["provider", !options.provider],
101
+ ["register=yes", options.register !== false],
102
+ ["exec=no", !options.exec],
103
+ ["catalog=none", !options.catalog],
104
+ ["devcontainer=no", !options.devcontainer],
105
+ ]) {
106
+ if (used)
107
+ process.stdout.write(`Using default: ${label}\n`);
108
+ }
109
+ return answers;
110
+ }
111
+ try {
112
+ const projectDefault = options.project?.trim() || DEFAULTS.projectId;
113
+ const nameDefault = options.name?.trim() || DEFAULTS.projectName;
114
+ const registerDefault = options.register !== false;
115
+ const nicknameDefault = options.nickname?.trim() || DEFAULTS.nickname;
116
+ const displayNameDefault = options.displayName?.trim() || DEFAULTS.displayName;
117
+ const providerDefault = options.provider?.trim() || DEFAULTS.providers.join(",");
118
+ const execDefault = !!options.exec;
119
+ const catalogDefault = options.catalog?.trim() || "none";
120
+ const devcontainerDefault = !!options.devcontainer;
121
+ const projectId = (await prompter.question(`Project ID [${projectDefault}]: `)).trim() || projectDefault;
122
+ const projectName = (await prompter.question(`Project name [${nameDefault}]: `)).trim() || nameDefault;
123
+ const register = parseBoolean(await prompter.question(`Create a project register? [${registerDefault ? "Y/n" : "y/N"}]: `), registerDefault);
124
+ const nickname = (await prompter.question(`Your nickname [${nicknameDefault}]: `)).trim() || nicknameDefault;
125
+ const displayName = (await prompter.question(`Your display name [${displayNameDefault}]: `)).trim() ||
126
+ displayNameDefault;
127
+ const providers = parseProviders((await prompter.question(`Orchestrator providers (${PROVIDERS.join(", ")}) [${providerDefault}]: `)) || providerDefault);
128
+ const exec = parseBoolean(await prompter.question(`Delegate work to agents (exec)? [${execDefault ? "Y/n" : "y/N"}]: `), execDefault);
129
+ const catalog = parseCatalog((await prompter.question(`Deliverables catalog (none|small|medium|large) [${catalogDefault}]: `)) || catalogDefault);
130
+ const devcontainer = parseBoolean(await prompter.question(`Create a Dev Container? [${devcontainerDefault ? "Y/n" : "y/N"}]: `), devcontainerDefault);
131
+ return validateAnswers({
132
+ projectId,
133
+ projectName,
134
+ register,
135
+ nickname,
136
+ displayName,
137
+ providers,
138
+ exec,
139
+ catalog,
140
+ devcontainer,
141
+ });
142
+ }
143
+ finally {
144
+ prompter.close();
145
+ }
146
+ }
147
+ function buildConfig(answers, repoRoot) {
148
+ const project = {
149
+ base_path: `docs/ja/projects/${answers.projectId}`,
150
+ ...(answers.catalog ? { catalog_path: "010-deliverables-catalog" } : {}),
151
+ members_path: "030-project-management/pm-members.yaml",
152
+ ...(answers.register ? { project_register_path: "controls/project-register" } : {}),
153
+ project_context: ["prj-overview"],
154
+ run: {
155
+ ...(answers.exec ? { exec_defaults: ".specdojo/exec-defaults.yaml" } : {}),
156
+ worktree_base: defaultWorktreeBase(repoRoot),
157
+ },
158
+ };
159
+ return {
160
+ version: 1,
161
+ current_project: answers.projectId,
162
+ ...(answers.exec ? { agent_members_path: ".specdojo/agent-members.yaml" } : {}),
163
+ projects: { [answers.projectId]: project },
164
+ };
165
+ }
166
+ function writeNewFile(repoRoot, relPath, content, dryRun) {
167
+ const path = join(repoRoot, relPath);
168
+ if (existsSync(path)) {
169
+ process.stdout.write(`Skipped (already exists): ${relPath}\n`);
170
+ return false;
171
+ }
172
+ if (dryRun) {
173
+ process.stdout.write(`[dry-run] would write: ${relPath}\n`);
174
+ return true;
175
+ }
176
+ mkdirSync(dirname(path), { recursive: true });
177
+ writeFileSync(path, content, "utf8");
178
+ process.stdout.write(`Created: ${relPath}\n`);
179
+ return true;
180
+ }
181
+ function humanRoster(answers) {
182
+ return yaml.dump({
183
+ id: `${answers.projectId}:pm-members`,
184
+ type: "project",
185
+ status: "draft",
186
+ title: `${answers.projectName} メンバー名簿`,
187
+ rulebook: "specdojo:pm-members-rulebook",
188
+ version: 1,
189
+ project_id: answers.projectId,
190
+ members: [
191
+ {
192
+ nickname: answers.nickname,
193
+ display_name: answers.displayName,
194
+ email: null,
195
+ roles: [],
196
+ type: "human",
197
+ persona: "final-decision-maker",
198
+ scheduler_strategy: "critical-first",
199
+ },
200
+ ],
201
+ }, { lineWidth: 120, noRefs: true });
202
+ }
203
+ function loadInitTemplate(packageRoot, filename) {
204
+ return yaml.load(readFileSync(join(packageRoot, "templates", filename), "utf8"));
205
+ }
206
+ function readPackageScripts(repoRoot) {
207
+ const packageJsonPath = join(repoRoot, "package.json");
208
+ if (!existsSync(packageJsonPath))
209
+ return {};
210
+ try {
211
+ const parsed = JSON.parse(readFileSync(packageJsonPath, "utf8"));
212
+ if (!parsed.scripts || typeof parsed.scripts !== "object" || Array.isArray(parsed.scripts)) {
213
+ return {};
214
+ }
215
+ return Object.fromEntries(Object.entries(parsed.scripts).filter((entry) => typeof entry[1] === "string"));
216
+ }
217
+ catch {
218
+ return {};
219
+ }
220
+ }
221
+ function selectParentValidations(repoRoot, configured) {
222
+ const scripts = readPackageScripts(repoRoot);
223
+ const candidates = Array.isArray(configured)
224
+ ? configured.filter((entry) => typeof entry === "string")
225
+ : [];
226
+ const selected = [];
227
+ for (const id of candidates) {
228
+ const script = PARENT_VALIDATION_SCRIPTS[id];
229
+ if (script && Object.hasOwn(scripts, script)) {
230
+ selected.push(id);
231
+ process.stdout.write(`Included parent validation: ${id} (npm run ${script})\n`);
232
+ }
233
+ else {
234
+ const reason = script
235
+ ? `package.json script "${script}" was not found`
236
+ : "validation ID is not supported by specdojo init";
237
+ process.stdout.write(`Skipped parent validation: ${id} (${reason})\n`);
238
+ }
239
+ }
240
+ if (selected.length === 0) {
241
+ process.stdout.write("Omitted pipeline.parent_validations: no supported npm scripts were found in package.json.\n");
242
+ }
243
+ return selected;
244
+ }
245
+ function writeExecConfiguration(repoRoot, packageRoot, providers, dryRun) {
246
+ const memberTemplate = loadInitTemplate(packageRoot, "init-agent-members.yaml");
247
+ const defaultsTemplate = loadInitTemplate(packageRoot, "init-exec-defaults.yaml");
248
+ const selected = new Set(providers);
249
+ const members = memberTemplate.members.filter((member) => member.provider && selected.has(member.provider));
250
+ const providerDefaults = Object.fromEntries(Object.entries(defaultsTemplate.providers).filter(([provider]) => selected.has(provider)));
251
+ const { providers: _providers, ...commonDefaults } = defaultsTemplate;
252
+ const commonPipeline = commonDefaults.pipeline && typeof commonDefaults.pipeline === "object"
253
+ ? commonDefaults.pipeline
254
+ : {};
255
+ const { parent_validations: configuredParentValidations, ...otherPipeline } = commonPipeline;
256
+ const parentValidations = selectParentValidations(repoRoot, configuredParentValidations);
257
+ const configuredDefaults = { ...commonDefaults };
258
+ if (parentValidations.length > 0 || Object.keys(otherPipeline).length > 0) {
259
+ configuredDefaults.pipeline = {
260
+ ...otherPipeline,
261
+ ...(parentValidations.length > 0 ? { parent_validations: parentValidations } : {}),
262
+ };
263
+ }
264
+ else {
265
+ delete configuredDefaults.pipeline;
266
+ }
267
+ writeNewFile(repoRoot, ".specdojo/agent-members.yaml", yaml.dump({ version: 1, members }, { lineWidth: 120, noRefs: true }), dryRun);
268
+ writeNewFile(repoRoot, ".specdojo/exec-defaults.yaml", yaml.dump({ ...configuredDefaults, providers: providerDefaults }, { lineWidth: 120, noRefs: true }), dryRun);
269
+ const primaryProvider = providers[0];
270
+ const executor = members.find((member) => member.provider === primaryProvider &&
271
+ member.stage_role === "executor" &&
272
+ member.mode === "edit");
273
+ const reporter = members.find((member) => member.provider === primaryProvider && member.stage_role === "reporter");
274
+ if (!executor || !reporter) {
275
+ throw new Error("init-agent-members.yaml must define an edit executor and reporter");
276
+ }
277
+ return { executor: executor.nickname, reporter: reporter.nickname };
278
+ }
279
+ function scaffoldRegister(repoRoot, config, answers, dryRun) {
280
+ if (!answers.register)
281
+ return;
282
+ const basePath = config.projects[answers.projectId].base_path;
283
+ const registerRel = join(basePath, "controls/project-register");
284
+ const registerPath = join(repoRoot, registerRel);
285
+ const paths = {
286
+ projectId: answers.projectId,
287
+ projectRegisterPath: registerPath,
288
+ executionPath: join(repoRoot, basePath, "execution"),
289
+ pjrIndexPath: join(registerPath, "pjr-index.md"),
290
+ generatedPath: join(registerPath, "generated"),
291
+ controlsGeneratedPath: join(repoRoot, basePath, "controls/generated"),
292
+ registerDateTimeZone: "UTC",
293
+ };
294
+ for (const view of generateDerivedViewFiles(paths, "all")) {
295
+ writeNewFile(repoRoot, relative(repoRoot, view.path), view.content, dryRun);
296
+ }
297
+ }
298
+ function catalogTemplateEntries(packageRoot) {
299
+ const templateDir = join(packageRoot, "docs/ja/specdojo/templates");
300
+ return readdirSync(templateDir)
301
+ .filter((file) => /^dct-.+-template\.yaml$/.test(file))
302
+ .sort()
303
+ .map((file) => {
304
+ const doc = yaml.load(readFileSync(join(templateDir, file), "utf8"));
305
+ return {
306
+ file,
307
+ domain: doc.domain,
308
+ name: doc.title?.replace(/^成果物カタログ(|)$/g, "") || doc.domain,
309
+ };
310
+ });
311
+ }
312
+ function scaffoldCatalog(repoRoot, packageRoot, config, answers, dryRun) {
313
+ if (!answers.catalog)
314
+ return;
315
+ const project = config.projects[answers.projectId];
316
+ const catalogRel = join(project.base_path, project.catalog_path);
317
+ const catalogPath = join(repoRoot, catalogRel);
318
+ const templates = catalogTemplateEntries(packageRoot);
319
+ const domains = [...new Map(templates.map((entry) => [entry.domain, entry])).values()];
320
+ writeNewFile(repoRoot, join(catalogRel, "dct-index.yaml"), yaml.dump({
321
+ id: `${answers.projectId}:dct-index`,
322
+ type: "project",
323
+ status: "draft",
324
+ title: `${answers.projectName} 成果物カタログ`,
325
+ rulebook: "specdojo:dct-index-rulebook",
326
+ project_id: answers.projectId,
327
+ size: answers.catalog,
328
+ groups: [
329
+ {
330
+ name: "成果物",
331
+ domains: domains.map(({ domain, name }) => ({
332
+ domain,
333
+ name,
334
+ overview: `${name}の成果物を管理する。`,
335
+ })),
336
+ },
337
+ ],
338
+ }, { lineWidth: 120, noRefs: true }), dryRun);
339
+ if (dryRun) {
340
+ for (const { file } of templates) {
341
+ const relPath = join(catalogRel, file.replace("-template", ""));
342
+ process.stdout.write(existsSync(join(repoRoot, relPath))
343
+ ? `Skipped (already exists): ${relPath}\n`
344
+ : `[dry-run] would write: ${relPath}\n`);
345
+ }
346
+ return;
347
+ }
348
+ const outcome = runScaffold({
349
+ catalogPath,
350
+ templatesPath: join(packageRoot, "docs/ja/specdojo/templates"),
351
+ size: answers.catalog,
352
+ projectId: answers.projectId,
353
+ force: false,
354
+ });
355
+ for (const path of outcome.written)
356
+ process.stdout.write(`Created: ${relative(repoRoot, path)}\n`);
357
+ for (const path of outcome.skipped)
358
+ process.stdout.write(`Skipped (already exists): ${relative(repoRoot, path)}\n`);
359
+ for (const warning of outcome.warnings)
360
+ process.stdout.write(`WARN: ${warning}\n`);
361
+ if (outcome.errors.length > 0)
362
+ throw new Error(outcome.errors.join("\n"));
363
+ }
364
+ export async function runInit(options, deps) {
365
+ const repoRoot = specdojoRootDir();
366
+ const packageRoot = specdojoPackageRootDir();
367
+ const interactive = !options.yes && !!process.stdin.isTTY && !process.env.CI;
368
+ const prompter = deps?.prompter ??
369
+ (interactive ? createInterface({ input: process.stdin, output: process.stdout }) : undefined);
370
+ const answers = await collectInitAnswers(options, prompter);
371
+ const config = buildConfig(answers, repoRoot);
372
+ const dryRun = !!options.dryRun;
373
+ writeNewFile(repoRoot, ".specdojo/specdojo.config.json", `${JSON.stringify(config, null, 2)}\n`, dryRun);
374
+ const gitignore = ensureGitignore(repoRoot, gitignorePatternsForLayouts([projectGitignoreLayout(config.projects[answers.projectId])]), { dryRun });
375
+ process.stdout.write(formatGitignoreReport(gitignore, dryRun));
376
+ writeNewFile(repoRoot, join(config.projects[answers.projectId].base_path, "030-project-management/pm-members.yaml"), humanRoster(answers), dryRun);
377
+ scaffoldRegister(repoRoot, config, answers, dryRun);
378
+ for (const provider of answers.providers) {
379
+ await runProviderScaffold(provider, {
380
+ packageRoot,
381
+ repoRoot,
382
+ force: false,
383
+ dryRun,
384
+ showNextSteps: false,
385
+ });
386
+ }
387
+ const execAgents = answers.exec
388
+ ? writeExecConfiguration(repoRoot, packageRoot, answers.providers, dryRun)
389
+ : undefined;
390
+ scaffoldCatalog(repoRoot, packageRoot, config, answers, dryRun);
391
+ if (answers.devcontainer) {
392
+ await runDevcontainerScaffold({
393
+ packageRoot,
394
+ repoRoot,
395
+ providers: answers.providers,
396
+ editors: [],
397
+ ollama: answers.providers.includes("opencode"),
398
+ cron: false,
399
+ tmux: false,
400
+ force: false,
401
+ dryRun,
402
+ });
403
+ }
404
+ const firstProvider = answers.providers[0];
405
+ const script = firstProvider === "claude"
406
+ ? "orch:sonnet"
407
+ : firstProvider === "antigravity"
408
+ ? "orch:agy"
409
+ : `orch:${firstProvider}`;
410
+ process.stdout.write("Next steps:\n" +
411
+ (firstProvider
412
+ ? ` 1. Run npm run ${script} and create the first register item.\n`
413
+ : " 1. Create the first register item.\n") +
414
+ (execAgents
415
+ ? ` 2. To run an item without the orchestrator: npx specdojo exec run --register <id> --executor-by ${execAgents.executor} --reporter-by ${execAgents.reporter}\n`
416
+ : "") +
417
+ ` ${execAgents ? "3" : "2"}. Review and commit the files created by specdojo init.\n`);
418
+ }
419
+ export function registerInitCommand(program) {
420
+ program
421
+ .command("init")
422
+ .description("Interactively configure a project, orchestrator providers, and optional agent execution")
423
+ .option("--yes", "Use defaults without prompting", false)
424
+ .option("--project <id>", "Project ID (default: prj-0001)")
425
+ .option("--name <name>", "Project display name")
426
+ .option("--no-register", "Do not create the project register")
427
+ .option("--nickname <nickname>", "Human member nickname")
428
+ .option("--display-name <name>", "Human member display name")
429
+ .option("--provider <names>", `Comma-separated providers (${PROVIDERS.join("|")})`)
430
+ .option("--exec", "Configure executor and reporter agents", false)
431
+ .option("--catalog <size>", "Create a deliverables catalog (small|medium|large)")
432
+ .option("--devcontainer", "Create a Dev Container for the selected providers", false)
433
+ .option("--dry-run", "Show planned files and changes without writing", false)
434
+ .action(async (options) => {
435
+ try {
436
+ await runInit(options);
437
+ }
438
+ catch (error) {
439
+ process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
440
+ process.exitCode = 1;
441
+ }
442
+ });
443
+ }