spec-wave 2.1.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.
Files changed (175) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +327 -0
  3. package/README.zh-CN.md +327 -0
  4. package/RELEASING.md +52 -0
  5. package/assets/README.md +30 -0
  6. package/assets/ci/samples/README.md +76 -0
  7. package/assets/ci/samples/hgm-ingest.yml.example +42 -0
  8. package/assets/ci/samples/lint-wiki-delta.pin.yml.example +47 -0
  9. package/assets/ci/samples/lint-wiki-delta.yml.example +49 -0
  10. package/assets/ci/samples/pytest.yml.example +49 -0
  11. package/assets/ci/samples/quality.yml.example +56 -0
  12. package/assets/ci/samples/skills-validate.yml.example +38 -0
  13. package/assets/ci/samples/tech-graph.yml.example +55 -0
  14. package/assets/coding_wiki/templates/README.md +115 -0
  15. package/assets/coding_wiki/templates/_index.md +19 -0
  16. package/assets/coding_wiki/templates/context.md +18 -0
  17. package/assets/coding_wiki/templates/stable.md +26 -0
  18. package/assets/coding_wiki/templates/topics/wiki_layout.md +13 -0
  19. package/assets/coding_wiki/templates/topics/wikilinks_export.md +13 -0
  20. package/assets/coding_wiki/templates/volatile.md +25 -0
  21. package/assets/docs/POINTER_ONBOARDING.md +9 -0
  22. package/assets/docs/POINTER_RUNBOOK_wiki_delta.md +18 -0
  23. package/assets/docs/POINTER_SDD_HAT_FLOW.md +8 -0
  24. package/assets/docs/POINTER_USER_GUIDE.md +8 -0
  25. package/assets/graph/stubs/README.md +6 -0
  26. package/assets/graph/templates/00_main.graph.yaml +72 -0
  27. package/assets/graph/templates/00_main.md +85 -0
  28. package/assets/graph/templates/01_struct.md +38 -0
  29. package/assets/graph/templates/02_version.md +7 -0
  30. package/assets/graph/templates/10_flow_MAIN.graph.yaml +105 -0
  31. package/assets/graph/templates/10_flow_MAIN.md +103 -0
  32. package/assets/graph/templates/99_mermaid_protocol.md +156 -0
  33. package/assets/graph/templates/README.md +66 -0
  34. package/assets/harness/README.md +18 -0
  35. package/assets/harness/discipline-coverage.yaml +320 -0
  36. package/assets/harness/invokes/README.md +22 -0
  37. package/assets/harness/invokes/TEMPLATE_invoke.md +61 -0
  38. package/assets/harness/lifecycle.yaml +127 -0
  39. package/assets/harness/prompts/00-orchestrator.md +91 -0
  40. package/assets/harness/prompts/10-spec-requirements.md +63 -0
  41. package/assets/harness/prompts/10-task-requirements.md +70 -0
  42. package/assets/harness/prompts/20-spec-audit.md +50 -0
  43. package/assets/harness/prompts/20-task-audit.md +90 -0
  44. package/assets/harness/prompts/30-execute-code.md +64 -0
  45. package/assets/harness/prompts/40-self-check.md +65 -0
  46. package/assets/harness/prompts/FRAGMENT_00_delegate_only_v1_zh.md +19 -0
  47. package/assets/harness/prompts/FRAGMENT_30_gate_verify_v1_zh.md +34 -0
  48. package/assets/harness/prompts/FRAGMENT_30_invoke_block_v1_zh.md +28 -0
  49. package/assets/harness/prompts/FRAGMENT_hat_reanchor_v1_zh.md +19 -0
  50. package/assets/harness/prompts/README.md +67 -0
  51. package/assets/harness/prompts/TEMPLATE_30_gate_stop.md +36 -0
  52. package/assets/harness/templates/FRAGMENT_task_domain_infer_v1_zh.md +16 -0
  53. package/assets/harness/templates/ONTOLOGY_consumer_slice_v1.md +41 -0
  54. package/assets/harness/templates/QUICKREF_v1_zh.md +35 -0
  55. package/assets/harness/templates/README.md +50 -0
  56. package/assets/harness/templates/TASK_TEMPLATE.md +133 -0
  57. package/assets/harness/templates/TASK_done_README.md +76 -0
  58. package/assets/harness/templates/TASK_epic.md +103 -0
  59. package/assets/harness/templates/TASK_graph_bootstrap.md +115 -0
  60. package/assets/harness/templates/VIEW_done_by_domain.md +66 -0
  61. package/assets/harness/templates/VIEW_done_thin_pointer.md +16 -0
  62. package/assets/ide/adapters/AGENTS.md.fragment.example +33 -0
  63. package/assets/ide/adapters/CLAUDE.md.fragment.example +32 -0
  64. package/assets/ide/adapters/README.md +57 -0
  65. package/assets/ide/adapters/cursor-harness-starter.mdc.example +39 -0
  66. package/assets/ide/commands/claude/kit/apply-standards.md +10 -0
  67. package/assets/ide/commands/claude/kit/gate-status.md +10 -0
  68. package/assets/ide/commands/claude/kit/graph-check.md +8 -0
  69. package/assets/ide/commands/claude/kit/hat-00-delegate.md +9 -0
  70. package/assets/ide/commands/claude/kit/hat-10-spec.md +9 -0
  71. package/assets/ide/commands/claude/kit/hat-10-task.md +9 -0
  72. package/assets/ide/commands/claude/kit/hat-20-spec-audit.md +9 -0
  73. package/assets/ide/commands/claude/kit/hat-20-task-audit.md +9 -0
  74. package/assets/ide/commands/claude/kit/hat-reanchor.md +8 -0
  75. package/assets/ide/commands/claude/kit/init-guide.md +16 -0
  76. package/assets/ide/commands/claude/kit/sync-prompts-guide.md +9 -0
  77. package/assets/ide/commands/claude/kit/verify.md +16 -0
  78. package/assets/ide/commands/cursor/kit-apply-standards.md +12 -0
  79. package/assets/ide/commands/cursor/kit-gate-status.md +12 -0
  80. package/assets/ide/commands/cursor/kit-graph-check.md +10 -0
  81. package/assets/ide/commands/cursor/kit-hat-00-delegate.md +11 -0
  82. package/assets/ide/commands/cursor/kit-hat-10-spec.md +11 -0
  83. package/assets/ide/commands/cursor/kit-hat-10-task.md +11 -0
  84. package/assets/ide/commands/cursor/kit-hat-20-spec-audit.md +11 -0
  85. package/assets/ide/commands/cursor/kit-hat-20-task-audit.md +11 -0
  86. package/assets/ide/commands/cursor/kit-hat-reanchor.md +10 -0
  87. package/assets/ide/commands/cursor/kit-init-guide.md +18 -0
  88. package/assets/ide/commands/cursor/kit-sync-prompts-guide.md +11 -0
  89. package/assets/ide/commands/cursor/kit-verify.md +18 -0
  90. package/assets/ide/host-adapt/README.md +113 -0
  91. package/assets/ide/host-adapt/examples/mvp-hosts.yaml +78 -0
  92. package/assets/ide/host-adapt/host-adapt.schema.json +97 -0
  93. package/assets/ide/skills-orch/README.md +16 -0
  94. package/assets/ide/skills-orch/kit-apply-standards/SKILL.md +17 -0
  95. package/assets/ide/skills-orch/kit-gate-status/SKILL.md +17 -0
  96. package/assets/ide/skills-orch/kit-hat-reanchor/SKILL.md +15 -0
  97. package/assets/ide/skills-orch/kit-init-guide/SKILL.md +23 -0
  98. package/assets/ide/skills-orch/kit-verify/SKILL.md +23 -0
  99. package/assets/ontology.yaml +113 -0
  100. package/assets/skills/README.md +37 -0
  101. package/assets/skills/harness-00-delegate-only/SKILL.md +19 -0
  102. package/assets/skills/harness-10-spec/SKILL.md +63 -0
  103. package/assets/skills/harness-10-task/SKILL.md +70 -0
  104. package/assets/skills/harness-20-spec-audit/SKILL.md +50 -0
  105. package/assets/skills/harness-20-task-audit/SKILL.md +90 -0
  106. package/assets/skills/harness-20-task-audit/references/TEMPLATE_30_gate_stop.md +36 -0
  107. package/assets/skills/harness-hat-reanchor/SKILL.md +19 -0
  108. package/assets/standards/POINTER_workspace_truth_v1_zh.md +42 -0
  109. package/assets/standards/README.md +35 -0
  110. package/assets/standards/SOURCES_v1_zh.md +49 -0
  111. package/assets/standards/TEMPLATE_CODING_BASELINE_L1_v1_zh.md +88 -0
  112. package/assets/standards/TEMPLATE_CODING_BASELINE_L2_backend_v1_zh.md +75 -0
  113. package/assets/standards/TEMPLATE_CODING_BASELINE_L2_frontend_v1_zh.md +76 -0
  114. package/bin/dsh-coding-kit.js +7 -0
  115. package/bin/specgate.js +7 -0
  116. package/bin/validate_template_compliance.py +470 -0
  117. package/cordis.patch.yml +5 -0
  118. package/lib/cli-checks.d.ts +68 -0
  119. package/lib/cli-checks.js +812 -0
  120. package/lib/cli-checks.js.map +1 -0
  121. package/lib/cli-graph-hgm.d.ts +74 -0
  122. package/lib/cli-graph-hgm.js +416 -0
  123. package/lib/cli-graph-hgm.js.map +1 -0
  124. package/lib/cli-graph-yaml.d.ts +79 -0
  125. package/lib/cli-graph-yaml.js +602 -0
  126. package/lib/cli-graph-yaml.js.map +1 -0
  127. package/lib/cli-graph.d.ts +1 -0
  128. package/lib/cli-graph.js +199 -0
  129. package/lib/cli-graph.js.map +1 -0
  130. package/lib/cli-host.d.ts +24 -0
  131. package/lib/cli-host.js +1197 -0
  132. package/lib/cli-host.js.map +1 -0
  133. package/lib/cli-lifecycle.d.ts +2 -0
  134. package/lib/cli-lifecycle.js +401 -0
  135. package/lib/cli-lifecycle.js.map +1 -0
  136. package/lib/cli-refresh-ide-blocks.d.ts +66 -0
  137. package/lib/cli-refresh-ide-blocks.js +484 -0
  138. package/lib/cli-refresh-ide-blocks.js.map +1 -0
  139. package/lib/cli-shared.d.ts +74 -0
  140. package/lib/cli-shared.js +281 -0
  141. package/lib/cli-shared.js.map +1 -0
  142. package/lib/cli-skills.d.ts +52 -0
  143. package/lib/cli-skills.js +363 -0
  144. package/lib/cli-skills.js.map +1 -0
  145. package/lib/cli-status.d.ts +2 -0
  146. package/lib/cli-status.js +251 -0
  147. package/lib/cli-status.js.map +1 -0
  148. package/lib/cli-sync-prompts.d.ts +25 -0
  149. package/lib/cli-sync-prompts.js +158 -0
  150. package/lib/cli-sync-prompts.js.map +1 -0
  151. package/lib/cli-sync.d.ts +2 -0
  152. package/lib/cli-sync.js +124 -0
  153. package/lib/cli-sync.js.map +1 -0
  154. package/lib/cli-task-extra.d.ts +53 -0
  155. package/lib/cli-task-extra.js +408 -0
  156. package/lib/cli-task-extra.js.map +1 -0
  157. package/lib/cli-timeline.d.ts +28 -0
  158. package/lib/cli-timeline.js +68 -0
  159. package/lib/cli-timeline.js.map +1 -0
  160. package/lib/cli-wiki.d.ts +21 -0
  161. package/lib/cli-wiki.js +189 -0
  162. package/lib/cli-wiki.js.map +1 -0
  163. package/lib/cli.d.ts +22 -0
  164. package/lib/cli.js +1034 -0
  165. package/lib/cli.js.map +1 -0
  166. package/lib/host-contract.d.ts +23 -0
  167. package/lib/host-contract.js +143 -0
  168. package/lib/host-contract.js.map +1 -0
  169. package/lib/index.d.ts +18 -0
  170. package/lib/index.js +290 -0
  171. package/lib/index.js.map +1 -0
  172. package/lib/yaml.d.ts +4 -0
  173. package/lib/yaml.js +10 -0
  174. package/lib/yaml.js.map +1 -0
  175. package/package.json +87 -0
@@ -0,0 +1,408 @@
1
+ import { existsSync, readdirSync, readFileSync } from 'node:fs';
2
+ import path from 'node:path';
3
+ import { extractTaskSlug, fail, findWikiDeltaOutsideMetaSection, normalizeSlug, parseHarnessMeta, resolveTarget, takeOption, } from "./cli-shared.js";
4
+ const DONE_DIR_CANDIDATES = ['docs/tasks/done', 'docs/harness/tasks/done'];
5
+ const INVOKE_DIR_CANDIDATES = ['docs/harness/invokes/by-task', 'invokes/by-task'];
6
+ const TASK_DIR_CANDIDATES = [
7
+ { rel: 'docs/tasks/active', scope: 'active' },
8
+ { rel: 'docs/tasks/done', scope: 'done' },
9
+ { rel: 'docs/harness/tasks/active', scope: 'active' },
10
+ { rel: 'docs/harness/tasks/done', scope: 'done' },
11
+ ];
12
+ function collectMarkdown(dir) {
13
+ const out = [];
14
+ if (!existsSync(dir))
15
+ return out;
16
+ for (const ent of readdirSync(dir, { withFileTypes: true })) {
17
+ const full = path.join(dir, ent.name);
18
+ if (ent.isDirectory()) {
19
+ if (ent.name.startsWith('_') || ent.name.startsWith('.'))
20
+ continue;
21
+ out.push(...collectMarkdown(full));
22
+ }
23
+ else if (ent.isFile() && ent.name.endsWith('.md') && !/^readme\.md$/i.test(ent.name)) {
24
+ out.push(full);
25
+ }
26
+ }
27
+ return out;
28
+ }
29
+ export function lintDoneInvokes(target) {
30
+ const doneSlugs = new Map();
31
+ for (const rel of DONE_DIR_CANDIDATES) {
32
+ const dir = path.join(target, rel);
33
+ if (!existsSync(dir))
34
+ continue;
35
+ for (const file of collectMarkdown(dir)) {
36
+ const slug = normalizeSlug(extractTaskSlug(path.basename(file)));
37
+ if (!doneSlugs.has(slug)) {
38
+ doneSlugs.set(slug, path.relative(target, file).replace(/\\/g, '/'));
39
+ }
40
+ }
41
+ }
42
+ const invokeSlugs = new Set();
43
+ for (const rel of INVOKE_DIR_CANDIDATES) {
44
+ const invokeRoot = path.join(target, rel);
45
+ if (!existsSync(invokeRoot))
46
+ continue;
47
+ for (const ent of readdirSync(invokeRoot, { withFileTypes: true })) {
48
+ if (ent.isDirectory())
49
+ invokeSlugs.add(normalizeSlug(ent.name));
50
+ }
51
+ }
52
+ const missing = [...doneSlugs.keys()].filter((s) => !invokeSlugs.has(s)).sort();
53
+ const extra = [...invokeSlugs].filter((s) => !doneSlugs.has(s)).sort();
54
+ return {
55
+ ok: missing.length === 0,
56
+ missing,
57
+ extra,
58
+ doneCount: doneSlugs.size,
59
+ invokeCount: invokeSlugs.size,
60
+ };
61
+ }
62
+ // DEF-021:wiki_delta strict 词表——none / n/a 为字面值;
63
+ // 其余值须为 path 形态(含 / 或 .,如 docs/coding_wiki/x.md 或 coding_wiki/templates)。
64
+ // DEF-003 阶段二 T6:export 供 cli-checks evalCloseWikiDelta 复用(同一词表 · 不复制)。
65
+ export const WIKI_DELTA_LITERALS = new Set(['none', 'n/a']);
66
+ export const WIKI_DELTA_PATHISH_RE = /[/.]/;
67
+ export function lintWikiDeltaMissing(target, options = {}) {
68
+ const scope = options.scope || 'all';
69
+ const strict = Boolean(options.strict);
70
+ if (!['all', 'active', 'done'].includes(scope)) {
71
+ throw new Error(`lint-wiki-delta --scope 须为 all|active|done(当前: ${scope})`);
72
+ }
73
+ const missing = [];
74
+ const issues = [];
75
+ let scanned = 0;
76
+ const seen = new Set();
77
+ for (const { rel, scope: dirScope } of TASK_DIR_CANDIDATES) {
78
+ if (scope !== 'all' && scope !== dirScope)
79
+ continue;
80
+ const dir = path.join(target, rel);
81
+ if (!existsSync(dir))
82
+ continue;
83
+ for (const abs of collectMarkdown(dir)) {
84
+ const relPath = path.relative(target, abs).replace(/\\/g, '/');
85
+ if (seen.has(relPath))
86
+ continue;
87
+ seen.add(relPath);
88
+ scanned += 1;
89
+ const content = readFileSync(abs, 'utf8');
90
+ const meta = parseHarnessMeta(content);
91
+ const raw = meta.wiki_delta;
92
+ if (raw == null || String(raw).trim() === '') {
93
+ // K1:字段写在 ## Harness 元信息 之外的节 → wiki_delta_wrong_section 替代 missing(不双报);
94
+ // 完全无该行 → 仍 wiki_delta_missing。诊断非兼容:parseHarnessMeta 权威节名不变。
95
+ const wrong = findWikiDeltaOutsideMetaSection(content);
96
+ const row = wrong
97
+ ? {
98
+ path: relPath,
99
+ scope: dirScope,
100
+ code: 'wiki_delta_wrong_section',
101
+ detail: `wiki_delta 行写在「${wrong.section}」节 L${wrong.line} · 须在 \`## Harness 元信息\` 表格内`,
102
+ }
103
+ : {
104
+ path: relPath,
105
+ scope: dirScope,
106
+ code: 'wiki_delta_missing',
107
+ detail: '缺 wiki_delta 字段(须 path|none|n/a)',
108
+ };
109
+ missing.push(row);
110
+ issues.push(row);
111
+ }
112
+ else if (strict) {
113
+ // DEF-021 完成态 A:--strict 在默认档之上追加扩展检查(SPEC G7 note/path 口径)。
114
+ // 词表 path|none|n/a:none / n/a 为字面值;其余按 path 形态处理。
115
+ // 新缺口只入 issues 不入 missing,默认档结果不变。
116
+ const value = String(raw).trim();
117
+ if (!WIKI_DELTA_LITERALS.has(value)) {
118
+ if (!WIKI_DELTA_PATHISH_RE.test(value)) {
119
+ issues.push({
120
+ path: relPath,
121
+ scope: dirScope,
122
+ code: 'wiki_delta_invalid',
123
+ detail: `wiki_delta 值非法: ${value}(须 path|none|n/a)`,
124
+ });
125
+ }
126
+ else if (!existsSync(path.resolve(target, value))) {
127
+ issues.push({
128
+ path: relPath,
129
+ scope: dirScope,
130
+ code: 'wiki_delta_path_missing',
131
+ detail: `wiki_delta 指向不存在的 wiki 路径(相对仓根): ${value}`,
132
+ });
133
+ }
134
+ }
135
+ }
136
+ }
137
+ }
138
+ missing.sort((a, b) => a.path.localeCompare(b.path));
139
+ issues.sort((a, b) => a.path.localeCompare(b.path));
140
+ return {
141
+ ok: (strict ? issues : missing).length === 0,
142
+ missing,
143
+ issues: strict ? issues : missing.map((m) => ({ ...m })),
144
+ scanned,
145
+ scope,
146
+ strict,
147
+ };
148
+ }
149
+ const SLUG_RE = /^[a-z0-9][a-z0-9_-]*$/;
150
+ export function loadTaskSidecar(filePath) {
151
+ const raw = readFileSync(filePath, 'utf8');
152
+ try {
153
+ return JSON.parse(raw);
154
+ }
155
+ catch (err) {
156
+ fail(`JSON 解析失败: ${filePath}: ${err.message}`);
157
+ }
158
+ }
159
+ export function validateTaskSidecar(data, fileLabel = 'task') {
160
+ const errors = [];
161
+ if (data == null || typeof data !== 'object' || Array.isArray(data)) {
162
+ return { ok: false, errors: [`${fileLabel}: 根节点须为 object`] };
163
+ }
164
+ const allowed = new Set([
165
+ 'schema_version',
166
+ 'task_slug',
167
+ 'test_strategy',
168
+ 'test_strategy_note',
169
+ 'depends_on',
170
+ 'parallel_group',
171
+ 'git_branch',
172
+ 'worktree_root',
173
+ 'epic_slug',
174
+ 'status',
175
+ 'task_markdown',
176
+ ]);
177
+ for (const key of Object.keys(data)) {
178
+ if (!allowed.has(key))
179
+ errors.push(`${fileLabel}: 未知字段 "${key}"`);
180
+ }
181
+ if (data.schema_version !== '1')
182
+ errors.push(`${fileLabel}: schema_version 须为 "1"`);
183
+ if (typeof data.task_slug !== 'string' || !SLUG_RE.test(data.task_slug)) {
184
+ errors.push(`${fileLabel}: task_slug 无效(小写 slug)`);
185
+ }
186
+ const strategies = ['required', 'recommended', 'not_applicable'];
187
+ if (!strategies.includes(String(data.test_strategy))) {
188
+ errors.push(`${fileLabel}: test_strategy 须为 ${strategies.join(' | ')}`);
189
+ }
190
+ if (data.test_strategy === 'not_applicable') {
191
+ if (typeof data.test_strategy_note !== 'string' || !data.test_strategy_note.trim()) {
192
+ errors.push(`${fileLabel}: test_strategy=not_applicable 须填 test_strategy_note`);
193
+ }
194
+ }
195
+ if (data.depends_on !== undefined) {
196
+ if (!Array.isArray(data.depends_on))
197
+ errors.push(`${fileLabel}: depends_on 须为 array`);
198
+ else {
199
+ const seen = new Set();
200
+ for (const dep of data.depends_on) {
201
+ if (typeof dep !== 'string' || !SLUG_RE.test(dep)) {
202
+ errors.push(`${fileLabel}: depends_on 项无效 "${dep}"`);
203
+ }
204
+ if (dep === data.task_slug)
205
+ errors.push(`${fileLabel}: depends_on 不可自引用 "${dep}"`);
206
+ if (seen.has(dep))
207
+ errors.push(`${fileLabel}: depends_on 重复 "${dep}"`);
208
+ seen.add(String(dep));
209
+ }
210
+ }
211
+ }
212
+ if (data.status !== undefined) {
213
+ const statuses = ['draft', 'pending', 'in_progress', 'done'];
214
+ if (!statuses.includes(String(data.status)))
215
+ errors.push(`${fileLabel}: status 无效`);
216
+ }
217
+ return { ok: errors.length === 0, errors };
218
+ }
219
+ function collectTaskSidecars(dirs) {
220
+ const map = new Map();
221
+ const scanDir = (dir) => {
222
+ if (!existsSync(dir))
223
+ return;
224
+ for (const ent of readdirSync(dir, { withFileTypes: true })) {
225
+ const full = path.join(dir, ent.name);
226
+ if (ent.isDirectory())
227
+ scanDir(full);
228
+ else if (ent.isFile() && ent.name.endsWith('.harness.json')) {
229
+ const data = loadTaskSidecar(full);
230
+ map.set(String(data.task_slug), { filePath: full, label: full, data });
231
+ }
232
+ }
233
+ };
234
+ for (const dir of dirs)
235
+ scanDir(path.resolve(dir));
236
+ return map;
237
+ }
238
+ function detectDependsOnCycle(taskMap) {
239
+ const visiting = new Set();
240
+ const visited = new Set();
241
+ let cyclePath = null;
242
+ const dfs = (slug, stack) => {
243
+ if (visited.has(slug))
244
+ return false;
245
+ if (visiting.has(slug)) {
246
+ const idx = stack.indexOf(slug);
247
+ cyclePath = stack.slice(idx).concat(slug);
248
+ return true;
249
+ }
250
+ visiting.add(slug);
251
+ stack.push(slug);
252
+ const deps = taskMap.get(slug)?.data?.depends_on ?? [];
253
+ for (const dep of deps) {
254
+ if (dfs(dep, stack))
255
+ return true;
256
+ }
257
+ stack.pop();
258
+ visiting.delete(slug);
259
+ visited.add(slug);
260
+ return false;
261
+ };
262
+ for (const slug of taskMap.keys()) {
263
+ if (dfs(slug, []))
264
+ return { ok: false, cycle: cyclePath ?? undefined };
265
+ }
266
+ return { ok: true };
267
+ }
268
+ export function checkTaskFile(filePath, options = {}) {
269
+ const abs = path.resolve(filePath);
270
+ const data = loadTaskSidecar(abs);
271
+ const label = path.basename(abs);
272
+ const validation = validateTaskSidecar(data, label);
273
+ const result = {
274
+ file: abs,
275
+ task_slug: data.task_slug,
276
+ validation,
277
+ cycle: { ok: true },
278
+ };
279
+ if (!validation.ok)
280
+ return result;
281
+ if (options.noCircular) {
282
+ const dirs = new Set([path.dirname(abs), ...(options.registryDirs ?? []).map((d) => path.resolve(d))]);
283
+ const taskMap = collectTaskSidecars([...dirs]);
284
+ if (!taskMap.has(String(data.task_slug))) {
285
+ taskMap.set(String(data.task_slug), { filePath: abs, label, data });
286
+ }
287
+ for (const dep of data.depends_on ?? []) {
288
+ if (!taskMap.has(dep)) {
289
+ validation.errors.push(`${label}: depends_on 未找到 sidecar "${dep}"`);
290
+ validation.ok = false;
291
+ }
292
+ }
293
+ if (validation.ok)
294
+ result.cycle = detectDependsOnCycle(taskMap);
295
+ }
296
+ return result;
297
+ }
298
+ export async function cmdTaskLintDone(args) {
299
+ if (args.includes('--help') || args.includes('-h')) {
300
+ console.log(`用法: npx spec-wave task lint-done [--target PATH]`);
301
+ return;
302
+ }
303
+ let rest = args;
304
+ const { value: targetArg, rest: r1 } = takeOption(rest, '--target');
305
+ rest = r1;
306
+ if (rest.length > 0)
307
+ fail(`task lint-done 未知参数: ${rest.join(' ')}`);
308
+ const target = resolveTarget(process.cwd(), targetArg);
309
+ const result = lintDoneInvokes(target);
310
+ console.log(`目标: ${target}`);
311
+ console.log(`done slugs: ${result.doneCount} · invoke dirs: ${result.invokeCount}`);
312
+ for (const slug of result.extra)
313
+ console.log(`warn: invokes 有而 done 无(进行中?): ${slug}`);
314
+ if (!result.ok) {
315
+ console.log('缺失 invoke 的 done 任务:');
316
+ for (const slug of result.missing)
317
+ console.log(` - ${slug}`);
318
+ console.log(`LINT-DONE: FAIL · missing ${result.missing.length}`);
319
+ fail('', 2);
320
+ }
321
+ console.log('LINT-DONE: PASS');
322
+ }
323
+ export async function cmdTaskLintWikiDelta(args) {
324
+ if (args.includes('--help') || args.includes('-h')) {
325
+ console.log(`用法: npx spec-wave task lint-wiki-delta [--target PATH] [--scope all|active|done] [--strict] [--json]`);
326
+ console.log(' 默认档: 缺 wiki_delta 字段(wiki_delta_missing);字段写在 ## Harness 元信息 之外的节' +
327
+ '(wiki_delta_wrong_section · 替代 missing 不双报);--strict 追加值域校验(path|none|n/a)' +
328
+ '与 path 存在性检查(wiki_delta_invalid / wiki_delta_path_missing)');
329
+ return;
330
+ }
331
+ const json = args.includes('--json');
332
+ const strict = args.includes('--strict');
333
+ let rest = args.filter((a) => a !== '--json' && a !== '--strict');
334
+ const { value: targetArg, rest: r1 } = takeOption(rest, '--target');
335
+ rest = r1;
336
+ const { value: scopeArg, rest: r2 } = takeOption(rest, '--scope');
337
+ rest = r2;
338
+ if (rest.length > 0)
339
+ fail(`task lint-wiki-delta 未知参数: ${rest.join(' ')}`);
340
+ const target = resolveTarget(process.cwd(), targetArg);
341
+ let result;
342
+ try {
343
+ result = lintWikiDeltaMissing(target, { scope: scopeArg || 'all', strict });
344
+ }
345
+ catch (e) {
346
+ fail(e.message || String(e));
347
+ }
348
+ if (json)
349
+ console.log(JSON.stringify(result, null, 2));
350
+ else {
351
+ console.log(`目标: ${target}`);
352
+ console.log(`scope: ${result.scope} · scanned: ${result.scanned} · strict: ${result.strict} · missing: ${result.missing.length} · issues: ${result.issues.length}`);
353
+ if (!result.ok) {
354
+ const label = result.strict ? 'wiki_delta 缺口(含 --strict)' : '缺 wiki_delta 字段的 task';
355
+ console.log(`${label}:`);
356
+ for (const m of result.issues) {
357
+ console.log(` - ${m.path}${m.code ? ` · ${m.code}` : ''}${m.detail ? ` · ${m.detail}` : ''}`);
358
+ }
359
+ }
360
+ console.log(result.ok ? 'LINT-WIKI-DELTA: PASS' : `LINT-WIKI-DELTA: FAIL · issues ${result.issues.length}`);
361
+ }
362
+ if (!result.ok)
363
+ fail('', 2);
364
+ }
365
+ export async function cmdTaskCheck(rest) {
366
+ const noCircular = rest.includes('--no-circular');
367
+ let filePath;
368
+ const registryDirs = [];
369
+ const filtered = [];
370
+ for (let i = 0; i < rest.length; i += 1) {
371
+ const arg = rest[i];
372
+ if (arg === '--no-circular')
373
+ continue;
374
+ if (arg === '--file') {
375
+ filePath = rest[i + 1];
376
+ i += 1;
377
+ continue;
378
+ }
379
+ if (arg === '--registry') {
380
+ registryDirs.push(rest[i + 1]);
381
+ i += 1;
382
+ continue;
383
+ }
384
+ filtered.push(arg);
385
+ }
386
+ if (filtered.length > 0)
387
+ fail(`task check 未知参数: ${filtered.join(' ')}`);
388
+ if (!filePath)
389
+ fail('task check 须指定 --file PATH');
390
+ const result = checkTaskFile(filePath, { noCircular, registryDirs });
391
+ console.log(`文件: ${result.file}`);
392
+ console.log(`task_slug: ${result.task_slug}`);
393
+ if (!result.validation.ok) {
394
+ console.log('schema: FAIL');
395
+ for (const msg of result.validation.errors)
396
+ console.log(` - ${msg}`);
397
+ fail('task sidecar 校验失败');
398
+ }
399
+ console.log('schema: OK');
400
+ if (noCircular) {
401
+ if (!result.cycle.ok) {
402
+ console.log(`depends_on: CYCLE ${(result.cycle.cycle ?? []).join(' → ')}`);
403
+ fail('depends_on 存在环');
404
+ }
405
+ console.log('depends_on: acyclic');
406
+ }
407
+ }
408
+ //# sourceMappingURL=cli-task-extra.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli-task-extra.js","sourceRoot":"","sources":["../src/cli-task-extra.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,28 @@
1
+ export declare function buildTaskTimeline(target: string, taskFile: string, options?: {
2
+ limit?: number | null;
3
+ ingest?: boolean;
4
+ actor?: string;
5
+ }): {
6
+ payload: {
7
+ schema_version: string;
8
+ task_slug: string;
9
+ task_path: string;
10
+ event_count: number;
11
+ returned: number;
12
+ limit: number | null;
13
+ ingested: boolean;
14
+ ingest: {
15
+ count: number;
16
+ skipped: number;
17
+ } | null;
18
+ events: {
19
+ occurred_at: string | null;
20
+ type: string;
21
+ subject: string;
22
+ summary: string;
23
+ event_id: string | null;
24
+ }[];
25
+ };
26
+ warnings: string[];
27
+ };
28
+ export declare function formatTimelineHuman(payload: ReturnType<typeof buildTaskTimeline>['payload']): string;
@@ -0,0 +1,68 @@
1
+ import { existsSync, readFileSync } from 'node:fs';
2
+ import path from 'node:path';
3
+ import { fail, parseHarnessMeta, resolveTaskPath, toRel } from "./cli-shared.js";
4
+ import { filterEventsForTask, ingestRepoIdempotent, loadEvents, summarizeEvent, } from "./cli-graph-hgm.js";
5
+ const OBS_TIMELINE_SCHEMA = 'obs_timeline.v1';
6
+ export function buildTaskTimeline(target, taskFile, options = {}) {
7
+ const { limit = null, ingest = false, actor = 'system' } = options;
8
+ const absTask = resolveTaskPath(target, taskFile);
9
+ if (!existsSync(absTask))
10
+ fail(`task 文件不存在: ${taskFile}`);
11
+ const content = readFileSync(absTask, 'utf8');
12
+ const meta = parseHarnessMeta(content);
13
+ const slug = meta.task_slug || path.basename(absTask, '.md');
14
+ let ingestResult = null;
15
+ if (ingest) {
16
+ ingestResult = ingestRepoIdempotent(target, { actor, source: 'timeline-cli', dryRun: false });
17
+ }
18
+ const all = loadEvents(target);
19
+ let related = filterEventsForTask(all, slug);
20
+ related = [...related].sort((a, b) => String(a.occurred_at || '').localeCompare(String(b.occurred_at || '')) ||
21
+ String(a.event_id || '').localeCompare(String(b.event_id || '')));
22
+ const truncated = limit != null && Number.isFinite(limit) && limit >= 0 ? related.slice(0, limit) : related;
23
+ const events = truncated.map((e) => ({
24
+ occurred_at: e.occurred_at ?? null,
25
+ type: e.type ?? 'Unknown',
26
+ subject: e.subject ?? '',
27
+ summary: summarizeEvent(e),
28
+ event_id: e.event_id ?? null,
29
+ }));
30
+ const warnings = [];
31
+ if (related.length === 0) {
32
+ warnings.push('WARN: 无 HGM 数据(该 task 无匹配事件)。可先: npx spec-wave graph ingest --target <repo>;或本命令加 --ingest(显式写盘)');
33
+ }
34
+ return {
35
+ payload: {
36
+ schema_version: OBS_TIMELINE_SCHEMA,
37
+ task_slug: slug,
38
+ task_path: toRel(target, absTask),
39
+ event_count: related.length,
40
+ returned: events.length,
41
+ limit: limit == null ? null : Number(limit),
42
+ ingested: Boolean(ingest),
43
+ ingest: ingestResult,
44
+ events,
45
+ },
46
+ warnings,
47
+ };
48
+ }
49
+ export function formatTimelineHuman(payload) {
50
+ const lines = [
51
+ `task: ${payload.task_slug}`,
52
+ `path: ${payload.task_path}`,
53
+ `events: ${payload.event_count} returned: ${payload.returned}${payload.limit != null ? ` limit=${payload.limit}` : ''}`,
54
+ ];
55
+ if (payload.ingested) {
56
+ lines.push(`ingest: new=${payload.ingest?.count ?? 0} skipped=${payload.ingest?.skipped ?? 0}`);
57
+ }
58
+ if (payload.events.length === 0)
59
+ lines.push('(no events)');
60
+ else {
61
+ lines.push('timeline (asc):');
62
+ for (const e of payload.events) {
63
+ lines.push(` ${e.occurred_at || '—'} ${e.type} ${e.subject} · ${e.summary}`);
64
+ }
65
+ }
66
+ return `${lines.join('\n')}\n`;
67
+ }
68
+ //# sourceMappingURL=cli-timeline.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli-timeline.js","sourceRoot":"","sources":["../src/cli-timeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAChF,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,UAAU,EACV,cAAc,GACf,MAAM,oBAAoB,CAAA;AAE3B,MAAM,mBAAmB,GAAG,iBAAiB,CAAA;AAE7C,MAAM,UAAU,iBAAiB,CAC/B,MAAc,EACd,QAAgB,EAChB,UAAuE,EAAE;IAezE,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,MAAM,GAAG,KAAK,EAAE,KAAK,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAA;IAClE,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IACjD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,IAAI,CAAC,eAAe,QAAQ,EAAE,CAAC,CAAA;IACzD,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IAC7C,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAA;IACtC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IAC5D,IAAI,YAAY,GAA8C,IAAI,CAAA;IAClE,IAAI,MAAM,EAAE,CAAC;QACX,YAAY,GAAG,oBAAoB,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;IAC/F,CAAC;IACD,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA;IAC9B,IAAI,OAAO,GAAG,mBAAmB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;IAC5C,OAAO,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CACzB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACP,MAAM,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QACtE,MAAM,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CACnE,CAAA;IACD,MAAM,SAAS,GACb,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;IAC3F,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACnC,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,IAAI;QAClC,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,SAAS;QACzB,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE;QACxB,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;QAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,IAAI;KAC7B,CAAC,CAAC,CAAA;IACH,MAAM,QAAQ,GAAa,EAAE,CAAA;IAC7B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,QAAQ,CAAC,IAAI,CACX,kGAAkG,CACnG,CAAA;IACH,CAAC;IACD,OAAO;QACL,OAAO,EAAE;YACP,cAAc,EAAE,mBAAmB;YACnC,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC;YACjC,WAAW,EAAE,OAAO,CAAC,MAAM;YAC3B,QAAQ,EAAE,MAAM,CAAC,MAAM;YACvB,KAAK,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;YAC3C,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC;YACzB,MAAM,EAAE,YAAY;YACpB,MAAM;SACP;QACD,QAAQ;KACT,CAAA;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAwD;IAC1F,MAAM,KAAK,GAAG;QACZ,SAAS,OAAO,CAAC,SAAS,EAAE;QAC5B,SAAS,OAAO,CAAC,SAAS,EAAE;QAC5B,WAAW,OAAO,CAAC,WAAW,eAAe,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,WAAW,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;KAC1H,CAAA;IACD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,eAAe,OAAO,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,aAAa,OAAO,CAAC,MAAM,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC,CAAA;IAClG,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;SACrD,CAAC;QACJ,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;QAC7B,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,CAAA;QAClF,CAAC;IACH,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAA;AAChC,CAAC"}
@@ -0,0 +1,21 @@
1
+ export declare const WIKI_GRAPH_SCHEMA = "harness.wiki_graph.v1";
2
+ export declare function exportWikiGraph(repoRoot: string, options?: {
3
+ root?: string;
4
+ }): {
5
+ schema: string;
6
+ root: string;
7
+ nodes: {
8
+ id: string;
9
+ path: string;
10
+ title: string;
11
+ }[];
12
+ edges: {
13
+ source: string;
14
+ target: string;
15
+ kind: string;
16
+ }[];
17
+ warnings: string[];
18
+ skipped_illustrative: number;
19
+ };
20
+ export declare function isIllustrativeWikilink(name: string): boolean;
21
+ export declare function cmdWiki(args: string[]): Promise<void>;