specdo 1.0.2

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 (161) hide show
  1. package/CHANGELOG.md +139 -0
  2. package/README.md +308 -0
  3. package/README.zh-CN.md +306 -0
  4. package/bin/specdo.js +3 -0
  5. package/dist/cli/index.d.ts +15 -0
  6. package/dist/cli/index.d.ts.map +1 -0
  7. package/dist/cli/index.js +297 -0
  8. package/dist/cli/index.js.map +1 -0
  9. package/dist/commands/_shared.d.ts +45 -0
  10. package/dist/commands/_shared.d.ts.map +1 -0
  11. package/dist/commands/_shared.js +124 -0
  12. package/dist/commands/_shared.js.map +1 -0
  13. package/dist/commands/apply.d.ts +30 -0
  14. package/dist/commands/apply.d.ts.map +1 -0
  15. package/dist/commands/apply.js +393 -0
  16. package/dist/commands/apply.js.map +1 -0
  17. package/dist/commands/archive.d.ts +25 -0
  18. package/dist/commands/archive.d.ts.map +1 -0
  19. package/dist/commands/archive.js +362 -0
  20. package/dist/commands/archive.js.map +1 -0
  21. package/dist/commands/doctor.d.ts +21 -0
  22. package/dist/commands/doctor.d.ts.map +1 -0
  23. package/dist/commands/doctor.js +180 -0
  24. package/dist/commands/doctor.js.map +1 -0
  25. package/dist/commands/domains.d.ts +14 -0
  26. package/dist/commands/domains.d.ts.map +1 -0
  27. package/dist/commands/domains.js +107 -0
  28. package/dist/commands/domains.js.map +1 -0
  29. package/dist/commands/explore.d.ts +48 -0
  30. package/dist/commands/explore.d.ts.map +1 -0
  31. package/dist/commands/explore.js +378 -0
  32. package/dist/commands/explore.js.map +1 -0
  33. package/dist/commands/init.d.ts +45 -0
  34. package/dist/commands/init.d.ts.map +1 -0
  35. package/dist/commands/init.js +243 -0
  36. package/dist/commands/init.js.map +1 -0
  37. package/dist/commands/list.d.ts +23 -0
  38. package/dist/commands/list.d.ts.map +1 -0
  39. package/dist/commands/list.js +135 -0
  40. package/dist/commands/list.js.map +1 -0
  41. package/dist/commands/propose.d.ts +22 -0
  42. package/dist/commands/propose.d.ts.map +1 -0
  43. package/dist/commands/propose.js +316 -0
  44. package/dist/commands/propose.js.map +1 -0
  45. package/dist/commands/show.d.ts +15 -0
  46. package/dist/commands/show.d.ts.map +1 -0
  47. package/dist/commands/show.js +214 -0
  48. package/dist/commands/show.js.map +1 -0
  49. package/dist/commands/status.d.ts +17 -0
  50. package/dist/commands/status.d.ts.map +1 -0
  51. package/dist/commands/status.js +146 -0
  52. package/dist/commands/status.js.map +1 -0
  53. package/dist/commands/sync.d.ts +21 -0
  54. package/dist/commands/sync.d.ts.map +1 -0
  55. package/dist/commands/sync.js +113 -0
  56. package/dist/commands/sync.js.map +1 -0
  57. package/dist/commands/validate.d.ts +117 -0
  58. package/dist/commands/validate.d.ts.map +1 -0
  59. package/dist/commands/validate.js +446 -0
  60. package/dist/commands/validate.js.map +1 -0
  61. package/dist/core/apply-brief-renderer.d.ts +35 -0
  62. package/dist/core/apply-brief-renderer.d.ts.map +1 -0
  63. package/dist/core/apply-brief-renderer.js +242 -0
  64. package/dist/core/apply-brief-renderer.js.map +1 -0
  65. package/dist/core/config-store.d.ts +190 -0
  66. package/dist/core/config-store.d.ts.map +1 -0
  67. package/dist/core/config-store.js +280 -0
  68. package/dist/core/config-store.js.map +1 -0
  69. package/dist/core/context-store.d.ts +96 -0
  70. package/dist/core/context-store.d.ts.map +1 -0
  71. package/dist/core/context-store.js +426 -0
  72. package/dist/core/context-store.js.map +1 -0
  73. package/dist/core/json-schemas.d.ts +349 -0
  74. package/dist/core/json-schemas.d.ts.map +1 -0
  75. package/dist/core/json-schemas.js +125 -0
  76. package/dist/core/json-schemas.js.map +1 -0
  77. package/dist/core/skill-content/cross-domain.d.ts +12 -0
  78. package/dist/core/skill-content/cross-domain.d.ts.map +1 -0
  79. package/dist/core/skill-content/cross-domain.js +291 -0
  80. package/dist/core/skill-content/cross-domain.js.map +1 -0
  81. package/dist/core/skill-content/protocol-examples.d.ts +13 -0
  82. package/dist/core/skill-content/protocol-examples.d.ts.map +1 -0
  83. package/dist/core/skill-content/protocol-examples.js +190 -0
  84. package/dist/core/skill-content/protocol-examples.js.map +1 -0
  85. package/dist/core/skill-content/workflow-content.d.ts +25 -0
  86. package/dist/core/skill-content/workflow-content.d.ts.map +1 -0
  87. package/dist/core/skill-content/workflow-content.js +1572 -0
  88. package/dist/core/skill-content/workflow-content.js.map +1 -0
  89. package/dist/core/skill-exporter.d.ts +186 -0
  90. package/dist/core/skill-exporter.d.ts.map +1 -0
  91. package/dist/core/skill-exporter.js +922 -0
  92. package/dist/core/skill-exporter.js.map +1 -0
  93. package/dist/core/spec-sync.d.ts +65 -0
  94. package/dist/core/spec-sync.d.ts.map +1 -0
  95. package/dist/core/spec-sync.js +226 -0
  96. package/dist/core/spec-sync.js.map +1 -0
  97. package/dist/core/task-parser.d.ts +58 -0
  98. package/dist/core/task-parser.d.ts.map +1 -0
  99. package/dist/core/task-parser.js +244 -0
  100. package/dist/core/task-parser.js.map +1 -0
  101. package/dist/core/template-renderer.d.ts +51 -0
  102. package/dist/core/template-renderer.d.ts.map +1 -0
  103. package/dist/core/template-renderer.js +362 -0
  104. package/dist/core/template-renderer.js.map +1 -0
  105. package/dist/domains/architecture.d.ts +34 -0
  106. package/dist/domains/architecture.d.ts.map +1 -0
  107. package/dist/domains/architecture.js +341 -0
  108. package/dist/domains/architecture.js.map +1 -0
  109. package/dist/domains/backend.d.ts +35 -0
  110. package/dist/domains/backend.d.ts.map +1 -0
  111. package/dist/domains/backend.js +367 -0
  112. package/dist/domains/backend.js.map +1 -0
  113. package/dist/domains/frontend.d.ts +36 -0
  114. package/dist/domains/frontend.d.ts.map +1 -0
  115. package/dist/domains/frontend.js +373 -0
  116. package/dist/domains/frontend.js.map +1 -0
  117. package/dist/domains/index.d.ts +49 -0
  118. package/dist/domains/index.d.ts.map +1 -0
  119. package/dist/domains/index.js +255 -0
  120. package/dist/domains/index.js.map +1 -0
  121. package/dist/domains/operations.d.ts +37 -0
  122. package/dist/domains/operations.d.ts.map +1 -0
  123. package/dist/domains/operations.js +344 -0
  124. package/dist/domains/operations.js.map +1 -0
  125. package/dist/domains/pool-ranking.d.ts +43 -0
  126. package/dist/domains/pool-ranking.d.ts.map +1 -0
  127. package/dist/domains/pool-ranking.js +153 -0
  128. package/dist/domains/pool-ranking.js.map +1 -0
  129. package/dist/domains/quality.d.ts +45 -0
  130. package/dist/domains/quality.d.ts.map +1 -0
  131. package/dist/domains/quality.js +368 -0
  132. package/dist/domains/quality.js.map +1 -0
  133. package/dist/domains/security.d.ts +19 -0
  134. package/dist/domains/security.d.ts.map +1 -0
  135. package/dist/domains/security.js +364 -0
  136. package/dist/domains/security.js.map +1 -0
  137. package/dist/domains/signal-match.d.ts +25 -0
  138. package/dist/domains/signal-match.d.ts.map +1 -0
  139. package/dist/domains/signal-match.js +67 -0
  140. package/dist/domains/signal-match.js.map +1 -0
  141. package/dist/domains/types.d.ts +354 -0
  142. package/dist/domains/types.d.ts.map +1 -0
  143. package/dist/domains/types.js +12 -0
  144. package/dist/domains/types.js.map +1 -0
  145. package/dist/index.d.ts +9 -0
  146. package/dist/index.d.ts.map +1 -0
  147. package/dist/index.js +9 -0
  148. package/dist/index.js.map +1 -0
  149. package/dist/protocols/index.d.ts +36 -0
  150. package/dist/protocols/index.d.ts.map +1 -0
  151. package/dist/protocols/index.js +85 -0
  152. package/dist/protocols/index.js.map +1 -0
  153. package/dist/protocols/review-to-solid.d.ts +32 -0
  154. package/dist/protocols/review-to-solid.d.ts.map +1 -0
  155. package/dist/protocols/review-to-solid.js +309 -0
  156. package/dist/protocols/review-to-solid.js.map +1 -0
  157. package/dist/utils/prompt.d.ts +37 -0
  158. package/dist/utils/prompt.d.ts.map +1 -0
  159. package/dist/utils/prompt.js +81 -0
  160. package/dist/utils/prompt.js.map +1 -0
  161. package/package.json +80 -0
@@ -0,0 +1,446 @@
1
+ /**
2
+ * specdo validate [--change <name>] [--json]
3
+ *
4
+ * 校验范围:
5
+ * 1. config.yaml schema + overrides (loadConfig)
6
+ * 2. 每个 change(active)的 context.json schema (Zod)
7
+ * 3. tasks.md 一致性:
8
+ * - 重复编号 / 缺口 → warn(缺口)/ error(重复)
9
+ * - 已完成任务缺 evidence → warning
10
+ * - context.apply.{tasksTotal, tasksCompleted, tasksEvidence} 与 tasks.md 一致
11
+ * 4. artifact 引用:proposal/design/tasks/specs 文件存在
12
+ * 5. context.json 与 propose.artifacts 路径自洽
13
+ *
14
+ * 输出:分组 (config / changes/<name>) 列出 issues;error 计数 > 0 → exit 1。
15
+ * 任意 change 失败时仍继续校验剩余 change。
16
+ */
17
+ import * as fs from 'node:fs';
18
+ import * as path from 'node:path';
19
+ import { z } from 'zod';
20
+ import { loadConfig } from '../core/config-store.js';
21
+ import { isCanonicalTaskReference, parseTasks } from '../core/task-parser.js';
22
+ import { fail, findSpecdoConfig, getChangeDir, getSpecdoDir, isValidChangeName, ok, safeExists, safeIsDir, } from './_shared.js';
23
+ // ─── Zod schema for context.json ────────────────────────────────
24
+ const matchSchema = z.object({
25
+ name: z.string(),
26
+ score: z.number(),
27
+ reason: z.string(),
28
+ });
29
+ const exploreSchema = z.object({
30
+ input: z.string(),
31
+ matchedDomains: z.array(matchSchema),
32
+ answers: z.record(z.string(), z.string()),
33
+ flaggedConcerns: z.array(z.string()),
34
+ completedAt: z.string().nullable(),
35
+ collectedContext: z.string().optional(),
36
+ depth: z.enum(['shallow', 'standard', 'deep']).nullable().optional(),
37
+ llmQuestions: z.record(z.string(), z.array(z.string())).optional(),
38
+ });
39
+ const proposeSchema = z.object({
40
+ artifacts: z.object({
41
+ proposal: z.string(),
42
+ specs: z.array(z.string()),
43
+ design: z.string(),
44
+ tasks: z.string(),
45
+ }),
46
+ domainsUsed: z.array(z.string()),
47
+ capabilities: z.array(z.object({
48
+ name: z.string(),
49
+ kind: z.enum(['new', 'modified']),
50
+ specPath: z.string(),
51
+ })).default([]),
52
+ completedAt: z.string().nullable(),
53
+ });
54
+ const applySchema = z.object({
55
+ completedAt: z.string().nullable(),
56
+ tasksTotal: z.number().int().nonnegative(),
57
+ tasksCompleted: z.number().int().nonnegative(),
58
+ tasksEvidence: z.record(z.string(), z.string()),
59
+ applyBriefGenerated: z.boolean(),
60
+ });
61
+ const syncSchema = z.object({
62
+ syncedSpecs: z.array(z.string()),
63
+ conflicts: z.array(z.string()),
64
+ forcedConflicts: z.array(z.string()).optional(),
65
+ forcedConflictHashes: z
66
+ .record(z.string(), z.object({ before: z.string(), after: z.string() }))
67
+ .optional(),
68
+ forced: z.boolean(),
69
+ completedAt: z.string().nullable(),
70
+ });
71
+ const archiveSchema = z.object({
72
+ archivedAt: z.string(),
73
+ archivePath: z.string(),
74
+ summaryPath: z.string(),
75
+ skippedSyncCheck: z.boolean().optional(),
76
+ skipSyncReason: z.string().optional(),
77
+ syncSnapshot: z
78
+ .object({
79
+ completedAt: z.string().nullable(),
80
+ unresolvedConflicts: z.array(z.string()),
81
+ forcedConflicts: z.array(z.string()),
82
+ })
83
+ .optional(),
84
+ riskNotes: z.array(z.string()).optional(),
85
+ });
86
+ const contextSchema = z.object({
87
+ version: z.literal(2, {
88
+ error: () => 'Unsupported context version. Please upgrade specdo CLI.',
89
+ }),
90
+ change: z.object({
91
+ name: z.string(),
92
+ createdAt: z.string(),
93
+ updatedAt: z.string(),
94
+ }),
95
+ explore: exploreSchema.optional(),
96
+ propose: proposeSchema.optional(),
97
+ apply: applySchema.optional(),
98
+ sync: syncSchema.optional(),
99
+ archive: archiveSchema.optional(),
100
+ });
101
+ export async function handleValidate(options) {
102
+ const { cwd } = options;
103
+ if (!findSpecdoConfig(cwd)) {
104
+ return fail(1, ["Not initialized. Run 'specdo init' first."]);
105
+ }
106
+ const issues = [];
107
+ // ─── config ───
108
+ const cfgResult = loadConfig(cwd);
109
+ for (const ci of cfgResult.issues) {
110
+ issues.push({ level: 'error', scope: 'config', path: ci.path, message: ci.message });
111
+ }
112
+ // ─── changes ───
113
+ const targets = options.change
114
+ ? (() => {
115
+ if (!isValidChangeName(options.change)) {
116
+ issues.push({
117
+ level: 'error',
118
+ scope: 'change',
119
+ path: '--change',
120
+ message: `Invalid --change name: "${options.change}".`,
121
+ });
122
+ return [];
123
+ }
124
+ const dir = getChangeDir(cwd, options.change);
125
+ if (!safeIsDir(dir)) {
126
+ issues.push({
127
+ level: 'error',
128
+ scope: 'change',
129
+ path: options.change,
130
+ message: `Change directory not found: ${dir}`,
131
+ });
132
+ return [];
133
+ }
134
+ return [options.change];
135
+ })()
136
+ : listActiveChanges(cwd);
137
+ for (const name of targets) {
138
+ issues.push(...validateChange(cwd, name).issues);
139
+ }
140
+ // ─── render ───
141
+ const errorCount = issues.filter((i) => i.level === 'error').length;
142
+ const warnCount = issues.filter((i) => i.level === 'warn').length;
143
+ if (options.json) {
144
+ return {
145
+ exitCode: errorCount === 0 ? 0 : 1,
146
+ stdout: [JSON.stringify({ summary: { errors: errorCount, warnings: warnCount }, issues }, null, 2)],
147
+ stderr: [],
148
+ };
149
+ }
150
+ const stdout = [];
151
+ if (issues.length === 0) {
152
+ stdout.push('✓ Validation passed.');
153
+ return ok(stdout);
154
+ }
155
+ // group by scope
156
+ const byScope = new Map();
157
+ for (const i of issues) {
158
+ const list = byScope.get(i.scope) ?? [];
159
+ list.push(i);
160
+ byScope.set(i.scope, list);
161
+ }
162
+ for (const [scope, list] of byScope) {
163
+ stdout.push(`# ${scope}`);
164
+ for (const i of list) {
165
+ const icon = i.level === 'error' ? '✗' : '!';
166
+ stdout.push(` ${icon} ${i.path}: ${i.message}`);
167
+ }
168
+ stdout.push('');
169
+ }
170
+ stdout.push(`Summary: ${errorCount} error(s), ${warnCount} warning(s).`);
171
+ return { exitCode: errorCount === 0 ? 0 : 1, stdout, stderr: [] };
172
+ }
173
+ // ─── helpers ────────────────────────────────────────────────────
174
+ function listActiveChanges(cwd) {
175
+ const dir = path.join(getSpecdoDir(cwd), 'changes');
176
+ if (!safeIsDir(dir))
177
+ return [];
178
+ return fs
179
+ .readdirSync(dir)
180
+ .filter((n) => safeIsDir(path.join(dir, n)));
181
+ }
182
+ export function validateChange(cwd, name) {
183
+ const issues = [];
184
+ const scope = `changes/${name}`;
185
+ const dir = getChangeDir(cwd, name);
186
+ // 1. context.json schema
187
+ const ctxPath = path.join(dir, 'context.json');
188
+ let ctx = null;
189
+ if (safeExists(ctxPath)) {
190
+ let raw;
191
+ try {
192
+ raw = JSON.parse(fs.readFileSync(ctxPath, 'utf-8'));
193
+ }
194
+ catch (err) {
195
+ issues.push({ level: 'error', scope, path: 'context.json', message: `JSON parse failed: ${err.message}` });
196
+ }
197
+ if (raw !== undefined) {
198
+ const parsed = contextSchema.safeParse(raw);
199
+ if (!parsed.success) {
200
+ for (const i of parsed.error.issues) {
201
+ issues.push({
202
+ level: 'error',
203
+ scope,
204
+ path: `context.${formatZodPath(i.path)}`,
205
+ message: i.message,
206
+ });
207
+ }
208
+ }
209
+ else {
210
+ ctx = parsed.data;
211
+ }
212
+ }
213
+ }
214
+ else {
215
+ issues.push({ level: 'warn', scope, path: 'context.json', message: 'context.json missing — run explore/propose first' });
216
+ }
217
+ // 2. tasks.md
218
+ const tasksPath = path.join(dir, 'tasks.md');
219
+ let tasksTotal = 0;
220
+ let tasksCompleted = 0;
221
+ const evidenceMap = {};
222
+ if (safeExists(tasksPath)) {
223
+ try {
224
+ const parsed = parseTasks(fs.readFileSync(tasksPath, 'utf-8'));
225
+ tasksTotal = parsed.tasks.length;
226
+ tasksCompleted = parsed.tasks.filter((t) => t.completed).length;
227
+ for (const t of parsed.tasks) {
228
+ if (t.completed && t.evidence && t.evidence.trim().length > 0) {
229
+ evidenceMap[String(t.number)] = t.evidence;
230
+ }
231
+ }
232
+ for (const w of parsed.warnings) {
233
+ issues.push({ level: 'warn', scope, path: 'tasks.md', message: w });
234
+ }
235
+ for (const t of parsed.tasks) {
236
+ if (t.completed && (!t.evidence || t.evidence.trim().length === 0)) {
237
+ issues.push({
238
+ level: 'warn',
239
+ scope,
240
+ path: `tasks.md#${t.number}`,
241
+ message: `Task ${t.number} is completed but has no evidence`,
242
+ });
243
+ }
244
+ }
245
+ }
246
+ catch (err) {
247
+ issues.push({ level: 'error', scope, path: 'tasks.md', message: err.message });
248
+ }
249
+ }
250
+ // 3. context.apply 与 tasks.md 一致
251
+ if (ctx?.apply) {
252
+ if (ctx.apply.tasksTotal !== tasksTotal) {
253
+ issues.push({
254
+ level: 'error',
255
+ scope,
256
+ path: 'context.apply.tasksTotal',
257
+ message: `mismatch: parsed tasks.md=${tasksTotal}, context=${ctx.apply.tasksTotal}. Run 'specdo apply' to refresh.`,
258
+ });
259
+ }
260
+ if (ctx.apply.tasksCompleted !== tasksCompleted) {
261
+ issues.push({
262
+ level: 'error',
263
+ scope,
264
+ path: 'context.apply.tasksCompleted',
265
+ message: `mismatch: parsed tasks.md=${tasksCompleted}, context=${ctx.apply.tasksCompleted}.`,
266
+ });
267
+ }
268
+ // evidence keys 必须是任务编号字符串
269
+ for (const key of Object.keys(ctx.apply.tasksEvidence)) {
270
+ if (!isCanonicalTaskReference(key)) {
271
+ issues.push({
272
+ level: 'error',
273
+ scope,
274
+ path: `context.apply.tasksEvidence.${key}`,
275
+ message: `evidence key must be a positive task reference string`,
276
+ });
277
+ }
278
+ }
279
+ const allEvidenceKeys = new Set([
280
+ ...Object.keys(ctx.apply.tasksEvidence),
281
+ ...Object.keys(evidenceMap),
282
+ ]);
283
+ for (const key of allEvidenceKeys) {
284
+ const ctxValue = ctx.apply.tasksEvidence[key];
285
+ const taskValue = evidenceMap[key];
286
+ if (ctxValue === undefined && taskValue !== undefined) {
287
+ issues.push({
288
+ level: 'error',
289
+ scope,
290
+ path: `context.apply.tasksEvidence.${key}`,
291
+ message: `missing evidence for task ${key}; tasks.md has "${taskValue}".`,
292
+ });
293
+ continue;
294
+ }
295
+ if (ctxValue !== undefined && taskValue === undefined) {
296
+ issues.push({
297
+ level: 'error',
298
+ scope,
299
+ path: `context.apply.tasksEvidence.${key}`,
300
+ message: `stale evidence for task ${key}; tasks.md has no completed evidence block for this task.`,
301
+ });
302
+ continue;
303
+ }
304
+ if (ctxValue !== taskValue) {
305
+ issues.push({
306
+ level: 'error',
307
+ scope,
308
+ path: `context.apply.tasksEvidence.${key}`,
309
+ message: `evidence mismatch for task ${key}; context=${JSON.stringify(ctxValue)}, tasks.md=${JSON.stringify(taskValue)}.`,
310
+ });
311
+ }
312
+ }
313
+ }
314
+ // 4. propose.artifacts 引用是否存在
315
+ if (ctx?.propose) {
316
+ const items = [
317
+ { key: 'proposal', rel: ctx.propose.artifacts.proposal },
318
+ { key: 'design', rel: ctx.propose.artifacts.design },
319
+ { key: 'tasks', rel: ctx.propose.artifacts.tasks },
320
+ ...ctx.propose.artifacts.specs.map((s, idx) => ({ key: `specs[${idx}]`, rel: s })),
321
+ ];
322
+ for (const item of items) {
323
+ const abs = path.join(dir, item.rel);
324
+ if (!safeExists(abs)) {
325
+ issues.push({
326
+ level: 'error',
327
+ scope,
328
+ path: `context.propose.artifacts.${item.key}`,
329
+ message: `referenced file missing: ${item.rel}`,
330
+ });
331
+ }
332
+ }
333
+ const specLayout = inspectSpecLayout(dir);
334
+ const compatibleCapabilities = deriveCompatibleCapabilities(ctx.propose, specLayout);
335
+ const capabilitySpecPaths = new Set(compatibleCapabilities.map((capability) => capability.specPath));
336
+ for (const rel of ctx.propose.artifacts.specs) {
337
+ if (!capabilitySpecPaths.has(rel)) {
338
+ issues.push({
339
+ level: 'error',
340
+ scope,
341
+ path: 'context.propose.capabilities',
342
+ message: `missing capability metadata for spec artifact ${rel}`,
343
+ });
344
+ }
345
+ }
346
+ for (const capability of compatibleCapabilities) {
347
+ if (!ctx.propose.artifacts.specs.includes(capability.specPath)) {
348
+ issues.push({
349
+ level: 'error',
350
+ scope,
351
+ path: 'context.propose.capabilities',
352
+ message: `stale capability metadata for ${capability.specPath}; no matching spec artifact entry`,
353
+ });
354
+ }
355
+ }
356
+ if (specLayout === 'mixed') {
357
+ issues.push({
358
+ level: 'error',
359
+ scope,
360
+ path: 'specs/',
361
+ message: 'mixed spec layout detected: legacy flat markdown files and capability/spec.md directories coexist',
362
+ });
363
+ }
364
+ else if (specLayout === 'legacy') {
365
+ issues.push({
366
+ level: 'warn',
367
+ scope,
368
+ path: 'specs/',
369
+ message: 'legacy flat spec layout detected; re-running propose --force without task progress will upgrade to capability/spec.md paths',
370
+ });
371
+ }
372
+ }
373
+ // 5. archive 存在但 active 仍存在 → warn(应该 rename 后 active 消失)
374
+ if (ctx?.archive) {
375
+ issues.push({
376
+ level: 'warn',
377
+ scope,
378
+ path: 'change directory',
379
+ message: `context.archive is set but the change is still under specdo/changes/. Likely a previously interrupted archive — run 'specdo archive --change ${name}' to retry.`,
380
+ });
381
+ }
382
+ return {
383
+ issues,
384
+ context: ctx,
385
+ tasks: {
386
+ total: tasksTotal,
387
+ completed: tasksCompleted,
388
+ evidenceMap,
389
+ },
390
+ };
391
+ }
392
+ function formatZodPath(p) {
393
+ return p
394
+ .map((seg, idx) => {
395
+ if (typeof seg === 'number')
396
+ return `[${seg}]`;
397
+ const str = String(seg);
398
+ return idx === 0 ? str : `.${str}`;
399
+ })
400
+ .join('');
401
+ }
402
+ function inspectSpecLayout(changeDir) {
403
+ const specsDir = path.join(changeDir, 'specs');
404
+ if (!safeIsDir(specsDir))
405
+ return 'empty';
406
+ const entries = fs.readdirSync(specsDir, { withFileTypes: true });
407
+ const hasLegacy = entries.some((entry) => entry.isFile() && entry.name.endsWith('.md'));
408
+ const hasCapability = entries.some((entry) => entry.isDirectory() && safeExists(path.join(specsDir, entry.name, 'spec.md')));
409
+ if (hasLegacy && hasCapability)
410
+ return 'mixed';
411
+ if (hasCapability)
412
+ return 'capability';
413
+ if (hasLegacy)
414
+ return 'legacy';
415
+ return 'empty';
416
+ }
417
+ function deriveCompatibleCapabilities(propose, layout) {
418
+ if (layout !== 'legacy') {
419
+ return propose.capabilities;
420
+ }
421
+ const byPath = new Map();
422
+ for (const capability of propose.capabilities) {
423
+ byPath.set(capability.specPath, capability);
424
+ }
425
+ return propose.artifacts.specs.map((specPath, index) => {
426
+ const existing = byPath.get(specPath);
427
+ if (existing)
428
+ return existing;
429
+ return {
430
+ name: deriveCapabilityNameFromSpecPath(specPath),
431
+ kind: index === 0 ? 'new' : 'modified',
432
+ specPath,
433
+ };
434
+ });
435
+ }
436
+ function deriveCapabilityNameFromSpecPath(specPath) {
437
+ if (specPath.startsWith('specs/') && specPath.endsWith('/spec.md')) {
438
+ return specPath.slice('specs/'.length, -'/spec.md'.length);
439
+ }
440
+ if (specPath.startsWith('specs/') && specPath.endsWith('.md')) {
441
+ return specPath.slice('specs/'.length, -'.md'.length);
442
+ }
443
+ const parsed = path.parse(specPath);
444
+ return parsed.name || specPath;
445
+ }
446
+ //# sourceMappingURL=validate.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,35 @@
1
+ /**
2
+ * apply-brief-renderer — apply-brief.md 渲染器
3
+ *
4
+ * 渲染顺序遵循 phases/03-phase2-commands.md §`apply-brief.md 内容模板`:
5
+ *
6
+ * 1. 标题 + 进度(completed/total)
7
+ * 2. 当前任务(基于 tasks.md 第一个未完成任务)
8
+ * 3. Domain Focus(聚合所有命中领域的 implement.focusAreas)
9
+ * 4. Execution Discipline (TDD)
10
+ * - 默认:3 步红绿重构
11
+ * - 若 quality protocol 命中:替换为 review-to-solid 顺序工作流
12
+ * 5. Verification Gates(test/lint/manual)
13
+ * 6. Guardrails(领域 antiPatterns)
14
+ * 7. Evidence 提示
15
+ *
16
+ * 设计要点:
17
+ * - 命令层负责选择哪些 domain / protocol 注入;本模块仅做无状态渲染
18
+ * - 输出确定性:相同输入相同字符串(顺序、空行、分隔符);测试必须可
19
+ * 断言完整字符串
20
+ * - 完成态(all-done)展示祝贺 + 下一步指引(sync / archive)
21
+ */
22
+ import type { DomainModule, Protocol } from '../domains/types.js';
23
+ import type { ParsedTask } from './task-parser.js';
24
+ export interface ApplyBriefInput {
25
+ changeName: string;
26
+ domains: DomainModule[];
27
+ /** 可选注入的 protocol(如 review-to-solid) */
28
+ protocol?: Protocol | null;
29
+ tasks: ParsedTask[];
30
+ /** 当前关注的任务编号(默认:第一个未完成;全部完成时 null) */
31
+ currentTaskNumber?: string | null;
32
+ generatedAt: string;
33
+ }
34
+ export declare function renderApplyBrief(input: ApplyBriefInput): string;
35
+ //# sourceMappingURL=apply-brief-renderer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"apply-brief-renderer.d.ts","sourceRoot":"","sources":["../../src/core/apply-brief-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,sCAAsC;IACtC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAsI/D"}