flow-comet 1.6.5 → 1.7.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.
- package/.flow-comet/skills/flow-comet/INSTALLED_VERSION +1 -1
- package/.flow-comet/skills/flow-comet/SKILL.md +17 -5
- package/.flow-comet/skills/flow-comet/reference/commit-discipline.md +1 -1
- package/.flow-comet/skills/flow-comet/reference/entry-detail.md +23 -4
- package/.flow-comet/skills/flow-comet/scripts/context-init.mjs +26 -23
- package/.flow-comet/skills/flow-comet/scripts/guard-self-test.mjs +14 -94
- package/.flow-comet/skills/flow-comet/scripts/items/a.mjs +97 -3
- package/.flow-comet/skills/flow-comet/scripts/items/b.mjs +38 -2
- package/.flow-comet/skills/flow-comet/scripts/items/e.mjs +52 -10
- package/.flow-comet/skills/flow-comet/scripts/items/h.mjs +16 -3
- package/.flow-comet/skills/flow-comet/scripts/items/l.mjs +2 -0
- package/.flow-comet/skills/flow-comet/scripts/items/m.mjs +4 -0
- package/.flow-comet/skills/flow-comet/scripts/items/n.mjs +20 -11
- package/.flow-comet/skills/flow-comet/scripts/lib/ac-coverage.mjs +317 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-artifact-skeleton.mjs +47 -5
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-evidence-gates.mjs +297 -131
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-gates.mjs +616 -151
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-routing.mjs +96 -45
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-state-io.mjs +8 -6
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-template-fidelity.mjs +204 -51
- package/.flow-comet/skills/flow-comet/scripts/lib/guard-uidesign.mjs +7 -9
- package/.flow-comet/skills/flow-comet/scripts/lib/lessons-hits.mjs +160 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/run-root.mjs +21 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/section-body.mjs +92 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-admin.mjs +38 -20
- package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-flow.mjs +439 -134
- package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-recovery.mjs +66 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/state-explain.mjs +92 -13
- package/.flow-comet/skills/flow-comet/scripts/lib/state-io.mjs +55 -2
- package/.flow-comet/skills/flow-comet/scripts/lib/state-skillmarkers.mjs +94 -39
- package/.flow-comet/skills/flow-comet/scripts/lib/system-fixtures.mjs +6 -0
- package/.flow-comet/skills/flow-comet/scripts/lib/task-graph.mjs +84 -31
- package/.flow-comet/skills/flow-comet/scripts/lib/test-fixtures.mjs +57 -7
- package/.flow-comet/skills/flow-comet/scripts/lib/test-helpers.mjs +60 -3
- package/.flow-comet/skills/flow-comet/scripts/lib/text-anchor-checks.mjs +158 -3
- package/.flow-comet/skills/flow-comet/scripts/lib/wave-projection.mjs +341 -0
- package/.flow-comet/skills/flow-comet/scripts/protocol-utils.mjs +92 -17
- package/.flow-comet/skills/flow-comet/scripts/scenarios/a.mjs +1439 -11
- package/.flow-comet/skills/flow-comet/scripts/scenarios/b.mjs +1202 -8
- package/.flow-comet/skills/flow-comet/scripts/scenarios/c.mjs +1204 -76
- package/.flow-comet/skills/flow-comet/scripts/scenarios/d.mjs +753 -5
- package/.flow-comet/skills/flow-comet/scripts/scenarios/e.mjs +32 -1
- package/.flow-comet/skills/flow-comet/scripts/scenarios/f.mjs +582 -3
- package/.flow-comet/skills/flow-comet/scripts/scenarios/g.mjs +5 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/i.mjs +5 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/j.mjs +16 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/k.mjs +2 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/l.mjs +5 -0
- package/.flow-comet/skills/flow-comet/scripts/scenarios/n.mjs +2041 -66
- package/.flow-comet/skills/flow-comet/scripts/state-schema.mjs +135 -0
- package/.flow-comet/skills/flow-comet/scripts/workflow-guard.mjs +143 -16
- package/.flow-comet/skills/flow-comet/scripts/workflow-handoff.mjs +312 -63
- package/.flow-comet/skills/flow-comet/scripts/workflow-state.mjs +5 -2
- package/.flow-comet/skills/flow-comet-execute/SKILL.md +30 -6
- package/.flow-comet/skills/flow-comet-plan/SKILL.md +10 -3
- package/.flow-comet/skills/flow-comet-review/SKILL.md +20 -11
- package/.flow-comet/skills/flow-comet-subagent-execute/SKILL.md +33 -8
- package/.flow-comet/skills/flow-comet-task/SKILL.md +2 -1
- package/README.md +1 -1
- package/package.json +1 -1
- package/scripts/dsh-bridge.mjs +2 -2
|
@@ -1,14 +1,23 @@
|
|
|
1
1
|
// task-graph.mjs — 任务与协议图的底层共享判定(单一权威实现)
|
|
2
2
|
// 承载:① 协议节点顺序 / 启用 / 任务文件路径(route · protocolNodeEnabled · protocolTaskFilePath ·
|
|
3
|
-
// EXECUTE_FAMILY_NODE_IDS);② 任务依赖解析与依赖图(taskDependencyEligibility · analyzeDependencyGraph
|
|
3
|
+
// EXECUTE_FAMILY_NODE_IDS);② 任务依赖解析与依赖图(taskDependencyEligibility · analyzeDependencyGraph ·
|
|
4
|
+
// taskWaveLevels 依赖层级);
|
|
4
5
|
// ③ 并行写冲突检测三族(findParallelWriteConflicts 及其构件);④ 任务集签名与版本语义 ·
|
|
5
6
|
// history 事件归属 · change 名形态 · 修复任务族文本谓词;⑤ 任务块 7 字段集合(TASK7_REQUIRED)。
|
|
6
7
|
// 纯判定:只读 TASK.md 文本、协议对象与 state.history,无 console 输出、无 process.exit、无 state 写入。
|
|
7
|
-
//
|
|
8
|
+
// 依赖方向:只依赖叶子模块(lessons-hits 的条目边界、section-body 的段界)——入口与兄弟模块单向
|
|
9
|
+
// 依赖本模块,不出现反向边。
|
|
8
10
|
import { promises as fs } from 'fs';
|
|
9
11
|
import path from 'path';
|
|
10
12
|
import { createHash } from 'crypto';
|
|
11
13
|
import { taskBlocks, taskOpeningAttrs } from '../task-parsing.mjs';
|
|
14
|
+
// 写面元素(`<write_files>`…`</write_files>`,元素名大小写无关)与条目边界(剥注释 → 行切 → 分号
|
|
15
|
+
// 容错切 → trim → 滤空)都取 lib/lessons-hits.mjs 的唯一实现:本模块只剩「路径归一」这一层自己的
|
|
16
|
+
// 语义(见 normalizeTaskPath),不自带第二份元素提取或切分。
|
|
17
|
+
import { taskWriteFilesById, writeFilesEntries } from './lessons-hits.mjs';
|
|
18
|
+
// 段界(同级标题 / 围栏 / 分隔线 / 文末)取 lib/section-body.mjs 的唯一实现:修复段的段体此前自带一份
|
|
19
|
+
// 「按行找下一个 `## `」的扫描,围栏代码块里的 `## ` 会把段体截断。
|
|
20
|
+
import { sectionBody } from './section-body.mjs';
|
|
12
21
|
|
|
13
22
|
// 任务块 7 字段集合(单一权威):plan 出口的 TASK 完整性门禁与执行期 `replan` 的重签判据共用本常量。
|
|
14
23
|
// `replan` 是执行期唯一允许修订任务集的通道,两侧判据必须同源——任何一侧另写一份字面集合,都会在
|
|
@@ -162,24 +171,22 @@ export function normalizeHeading(raw) {
|
|
|
162
171
|
}
|
|
163
172
|
|
|
164
173
|
// 修复段正文切片:首个同级(##)标题命中 → 返回标题行之后、下一个同级标题(或 EOF)之前的正文;
|
|
165
|
-
// 无命中标题 → null。只认二级标题(###
|
|
174
|
+
// 无命中标题 → null。只认二级标题(### 不闭合本段)。段界(含围栏同步)由 lib/section-body.mjs
|
|
175
|
+
// 单点决定,这里只表达自己的差异——标题按共享归一后比较(「Fix 任务(来自 REVIEW / INTEGRATION)」
|
|
176
|
+
// 「## Fix 任务 ##」等写法命中同一段),且**不以分隔线结束**(修复段内允许 `---` 分节,历史语义)。
|
|
166
177
|
function fixSectionBody(taskContent, fixSectionTitle) {
|
|
167
|
-
const lines = String(taskContent ?? '').replace(/\r\n?/g, '\n').split('\n');
|
|
168
178
|
const wanted = normalizeHeading(fixSectionTitle);
|
|
169
179
|
if (wanted === '') return null;
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
if (/^##\s/.test(lines[i])) { end = i; break; }
|
|
181
|
-
}
|
|
182
|
-
return lines.slice(start + 1, end).join('\n');
|
|
180
|
+
return sectionBody(
|
|
181
|
+
taskContent,
|
|
182
|
+
(heading) => {
|
|
183
|
+
// 只认二级标题起段(### 不闭合本段,也不在这里起段——历史语义)
|
|
184
|
+
if (heading.level !== 2) return false;
|
|
185
|
+
const normalized = normalizeHeading(heading.text);
|
|
186
|
+
return normalized === wanted || normalized.startsWith(wanted);
|
|
187
|
+
},
|
|
188
|
+
{ level: 2, endOnSeparator: false },
|
|
189
|
+
);
|
|
183
190
|
}
|
|
184
191
|
|
|
185
192
|
// 修复任务族 id 前缀(唯一谓词的 id 边界,全模块只此一处定义):含尾连字符——形似编号(前缀
|
|
@@ -260,6 +267,40 @@ export function analyzeDependencyGraph(blocks) {
|
|
|
260
267
|
return { ids, depsById, missing, cyclic, cycleIds };
|
|
261
268
|
}
|
|
262
269
|
|
|
270
|
+
// ---------- 依赖层级(波次投影的层级求值 · 单一权威) ----------
|
|
271
|
+
// 层级定义:level(task) = 1 + max(level(dep)),无依赖 = 1(依赖链的最大深度)。「波次 = 依赖层级
|
|
272
|
+
// 的投影」这一判据(plan 出口 / replan 重校,两处同源调用)消费本函数,不在判据侧自算——层级是
|
|
273
|
+
// 同一份依赖数据的第二次求值,两处各算一遍必然分叉。
|
|
274
|
+
// 输入 = <task> 块数组(与 analyzeDependencyGraph 同源解析),输出 Map<id, level>。
|
|
275
|
+
// 依赖解析复用 analyzeDependencyGraph 的 depsById(依赖文本解析单一权威,不另起第二份正则);
|
|
276
|
+
// 引用不存在的依赖不计入层级(其合法性由依赖图判据负责),环上的任务不产出层级(本函数只求层级,
|
|
277
|
+
// 不承担合法性判定——依赖环 / 缺失依赖由 analyzeDependencyGraph 的消费方先行拦截)。
|
|
278
|
+
export function taskWaveLevels(blocks) {
|
|
279
|
+
const { ids, depsById } = analyzeDependencyGraph(blocks);
|
|
280
|
+
const levels = new Map();
|
|
281
|
+
const resolving = new Set();
|
|
282
|
+
const resolveLevel = (id) => {
|
|
283
|
+
const known = levels.get(id);
|
|
284
|
+
if (known !== undefined) return known;
|
|
285
|
+
if (resolving.has(id)) return null; // 环:该链无解,本 id 不产出层级
|
|
286
|
+
resolving.add(id);
|
|
287
|
+
let deepest = 0;
|
|
288
|
+
let solvable = true;
|
|
289
|
+
for (const dep of depsById.get(id) ?? []) {
|
|
290
|
+
if (!ids.has(dep)) continue;
|
|
291
|
+
const depLevel = resolveLevel(dep);
|
|
292
|
+
if (depLevel === null) { solvable = false; break; }
|
|
293
|
+
if (depLevel > deepest) deepest = depLevel;
|
|
294
|
+
}
|
|
295
|
+
resolving.delete(id);
|
|
296
|
+
if (!solvable) return null;
|
|
297
|
+
levels.set(id, deepest + 1);
|
|
298
|
+
return deepest + 1;
|
|
299
|
+
};
|
|
300
|
+
for (const id of ids) resolveLevel(id);
|
|
301
|
+
return levels;
|
|
302
|
+
}
|
|
303
|
+
|
|
263
304
|
// ---------- 并行文件依赖检测(单源:plan 出口门禁与 replan 重校共用) ----------
|
|
264
305
|
// 解析 TASK.md 的任务 read/write_files 声明,分三族返回:
|
|
265
306
|
// ① writeConflicts(写写强判):本趟可运行的 parallel=pending 任务间 write∩write 非空——同波次
|
|
@@ -317,14 +358,14 @@ function normalizeTaskPath(raw) {
|
|
|
317
358
|
return out.join('/');
|
|
318
359
|
}
|
|
319
360
|
|
|
320
|
-
//
|
|
361
|
+
// 路径解析:入参是**已提取的**写面元素原文(元素提取与条目边界都取 lib/lessons-hits.mjs 的唯一实现
|
|
362
|
+
// ——taskWriteFilesById + writeFilesEntries;与 handoff 的提交子集校验、plan 出口的伪并行启发式
|
|
363
|
+
// 同一份:同一份写面在三处被切成不同条目集、或在元素名的大小写上分叉时,「谁越界」「哪一对并行
|
|
364
|
+
// 任务重叠」会互相矛盾)。本函数只在条目之上叠加本模块自己的归一(normalizeTaskPath)。
|
|
321
365
|
// 按声明实际内容解析,不做扩展名白名单过滤——txt/log/无扩展名路径同等检出(链式重命名的 .txt
|
|
322
366
|
// 事故面闭合)。族①②③共用本实现,不另起第二份。
|
|
323
367
|
function parsePaths(matchText) {
|
|
324
|
-
return
|
|
325
|
-
.replace(/<!--[\s\S]*?-->/g, '')
|
|
326
|
-
.trim().split(/\s*\n\s*/).map((l) => l.trim()).filter(Boolean)
|
|
327
|
-
.flatMap((l) => l.split(';')).map((l) => l.trim()).filter(Boolean)
|
|
368
|
+
return writeFilesEntries(matchText)
|
|
328
369
|
.map(normalizeTaskPath)
|
|
329
370
|
.filter((p) => p !== null && p !== '');
|
|
330
371
|
}
|
|
@@ -374,11 +415,18 @@ export function collectPathOverlaps(leftPaths, rightPaths) {
|
|
|
374
415
|
}
|
|
375
416
|
|
|
376
417
|
// 第三族(同文件跨任务且无依赖路径)计算——本模块具名纯函数:输入任务块 / 依赖图 / 既有族去重键,
|
|
377
|
-
//
|
|
418
|
+
// 输出 { conflicts, isOverlappingPair }——conflicts 是冲突对明细({ a, b, files },报告面用),
|
|
419
|
+
// isOverlappingPair 是**任务对键集合上的成员判定**(谓词)。任务对键的形态只在 taskPairKey 表达一次:
|
|
420
|
+
// 消费方(wave-projection 的 [P] 判据)要的是「这一对是否写面重叠」,拿到的因此是判定而不是键形态——
|
|
421
|
+
// 两端各算一次键时,形态一旦漂移(换分隔符 / 换定序)键就不相等,补集会静默失效(写面重叠的一对被
|
|
422
|
+
// 当成「本可并行」)。无 fs / console / process.exit,不改任何入参。
|
|
378
423
|
// taskContent 与 allBlocks 须同源(taskContent = 产出 allBlocks 的 TASK.md 文本)——修复任务族
|
|
379
424
|
// 谓词需要全文以定位修复段(段标题取该谓词的缺省回退常量,与 fixTaskClassifier 的缺省一致)。
|
|
380
425
|
export function collectCrossTaskConflicts({ taskContent = '', allBlocks = [], depsById = new Map(), excludedPairKeys = new Set() } = {}) {
|
|
381
426
|
const isFixTask = fixTaskClassifier(taskContent);
|
|
427
|
+
// 写面元素(键 = 任务 id)取 lib/lessons-hits.mjs 的唯一提取:元素名大小写无关与 7 字段门的在场
|
|
428
|
+
// 判定同口径——大小写敏感的副本会让混合写法的任务在这里判「没有写面」,从而整对掉出本族。
|
|
429
|
+
const writeFaces = taskWriteFilesById(taskContent);
|
|
382
430
|
const reachCache = new Map();
|
|
383
431
|
const reachableFrom = (id) => {
|
|
384
432
|
if (!reachCache.has(id)) reachCache.set(id, reachableTaskIds(depsById, id));
|
|
@@ -388,9 +436,9 @@ export function collectCrossTaskConflicts({ taskContent = '', allBlocks = [], de
|
|
|
388
436
|
for (const block of allBlocks) {
|
|
389
437
|
const attrs = taskOpeningAttrs(block);
|
|
390
438
|
if (!attrs || !attrs.id || attrs.status === 'done' || isFixTask(block)) continue;
|
|
391
|
-
const
|
|
392
|
-
if (
|
|
393
|
-
const writes = new Set(parsePaths(
|
|
439
|
+
const element = writeFaces.get(attrs.id);
|
|
440
|
+
if (element === undefined) continue;
|
|
441
|
+
const writes = new Set(parsePaths(element));
|
|
394
442
|
if (writes.size === 0) continue;
|
|
395
443
|
participants.push({ id: attrs.id, writes });
|
|
396
444
|
}
|
|
@@ -405,7 +453,8 @@ export function collectCrossTaskConflicts({ taskContent = '', allBlocks = [], de
|
|
|
405
453
|
conflicts.push({ a: participants[i].id, b: participants[j].id, files: overlap });
|
|
406
454
|
}
|
|
407
455
|
}
|
|
408
|
-
|
|
456
|
+
const pairKeys = new Set(conflicts.map((conflict) => taskPairKey(conflict.a, conflict.b)));
|
|
457
|
+
return { conflicts, isOverlappingPair: (a, b) => pairKeys.has(taskPairKey(a, b)) };
|
|
409
458
|
}
|
|
410
459
|
|
|
411
460
|
export async function findParallelWriteConflicts(changeDir) {
|
|
@@ -413,6 +462,9 @@ export async function findParallelWriteConflicts(changeDir) {
|
|
|
413
462
|
let text;
|
|
414
463
|
try { text = await fs.readFile(taskFile, 'utf8'); } catch { return { writeConflicts: [], readWarnings: [], crossTaskConflicts: [] }; }
|
|
415
464
|
const allBlocks = taskBlocks(text);
|
|
465
|
+
// 写面元素(键 = 任务 id)取 lib/lessons-hits.mjs 的唯一提取(元素名大小写无关):大小写敏感的副本
|
|
466
|
+
// 会让混合写法的任务在这里判「没有写面」,同波并行写同一路径的竞态因此漏拦。
|
|
467
|
+
const writeFaces = taskWriteFilesById(text);
|
|
416
468
|
// 依赖资格收窄:仅统计「本趟可运行」的并行任务——deps ⊆ doneIds;等待后续趟次的并行任务
|
|
417
469
|
// (依赖未满足)与已交付任务不参与同趟冲突判定,使 A→B 同写路径的跨趟合法计划不再被首趟误拦
|
|
418
470
|
// (与路由谓词同一口径)。依赖文本解析与资格判定一律走 taskDependencyEligibility——本函数不再
|
|
@@ -430,13 +482,13 @@ export async function findParallelWriteConflicts(changeDir) {
|
|
|
430
482
|
for (const b of blocks) {
|
|
431
483
|
const a = taskOpeningAttrs(b);
|
|
432
484
|
if (!a || !a.id) continue;
|
|
433
|
-
const
|
|
485
|
+
const element = writeFaces.get(a.id);
|
|
434
486
|
const rf = b.match(/<read_files>([\s\S]*?)<\/read_files>/);
|
|
435
|
-
if (
|
|
487
|
+
if (element === undefined && !rf) continue;
|
|
436
488
|
perTask.push({
|
|
437
489
|
id: a.id,
|
|
438
490
|
deps: new Set(taskDependencyEligibility(b).deps),
|
|
439
|
-
writes: new Set(parsePaths(
|
|
491
|
+
writes: new Set(parsePaths(element)),
|
|
440
492
|
reads: new Set(parsePaths(rf && rf[1])),
|
|
441
493
|
});
|
|
442
494
|
}
|
|
@@ -461,11 +513,12 @@ export async function findParallelWriteConflicts(changeDir) {
|
|
|
461
513
|
// 全在该纯函数内,此处不内联第二份。
|
|
462
514
|
const writePairKeys = new Set(writeConflicts.map((c) => taskPairKey(c.a, c.b)));
|
|
463
515
|
const { depsById } = analyzeDependencyGraph(allBlocks);
|
|
516
|
+
// 只取说明面(明细):键集合与判定留在纯函数里,本函数不另算一份键。
|
|
464
517
|
const crossTaskConflicts = collectCrossTaskConflicts({
|
|
465
518
|
taskContent: text,
|
|
466
519
|
allBlocks,
|
|
467
520
|
depsById,
|
|
468
521
|
excludedPairKeys: writePairKeys,
|
|
469
|
-
});
|
|
522
|
+
}).conflicts;
|
|
470
523
|
return { writeConflicts, readWarnings, crossTaskConflicts };
|
|
471
524
|
}
|
|
@@ -24,6 +24,11 @@ import {
|
|
|
24
24
|
writeFile,
|
|
25
25
|
makeTmp as sharedMakeTmp,
|
|
26
26
|
} from './test-helpers.mjs';
|
|
27
|
+
import {
|
|
28
|
+
declarationSkillTargets,
|
|
29
|
+
guardedDeclarationSkills,
|
|
30
|
+
nodePromptFiles,
|
|
31
|
+
} from '../protocol-utils.mjs';
|
|
27
32
|
|
|
28
33
|
// 本模块位于 `<技能包>/scripts/lib/` ⇒ 脚本目录是它的上一级;技能树内所有兄弟脚本路径
|
|
29
34
|
// (GUARD / STATE / HOOK / HANDOFF / 侧命令 / 内置协议副本)一律由它拼接,调用面不再各拼一遍。
|
|
@@ -45,15 +50,52 @@ export const REPO_ROOT = path.resolve(SCRIPTS_DIR, '..', '..', '..', '..');
|
|
|
45
50
|
// 其 .flow-comet/ 只是运行时目录,无 skills/flow-comet/SKILL.md)——与安装器自身判定同判据
|
|
46
51
|
// (prepare-env.mjs 的 gitignore 纳管跳过分支)。
|
|
47
52
|
export const AUTHORITATIVE_SOURCE_ANCHOR = path.join(REPO_ROOT, '.flow-comet', 'skills', 'flow-comet', 'SKILL.md');
|
|
48
|
-
export function isAuthoritativeSourceRepo() {
|
|
49
|
-
return fs.existsSync(AUTHORITATIVE_SOURCE_ANCHOR);
|
|
50
|
-
}
|
|
51
53
|
// 权威源仓库脚本位于仓库根 scripts/prepare-env.mjs;安装副本无此脚本,场景跳过
|
|
52
54
|
export const PREPARE_ENV = path.join(REPO_ROOT, 'scripts', 'prepare-env.mjs');
|
|
53
55
|
// 内置协议源文件(packageRoot/reference/):场景复制到 <tmpdir>/reference/ 内(protected-path 要求 runRoot 内)
|
|
54
56
|
export const BUILTIN_PROTOCOL_SOURCE = path.join(SCRIPTS_DIR, '..', 'reference', 'workflow-protocol.json');
|
|
55
57
|
export const CHANGE_ID = 'ch';
|
|
56
58
|
|
|
59
|
+
// 节点声明标记夹具(唯一构造处):按协议派生「该节点该声明哪些技能」「该节点该读哪些协议文件」,
|
|
60
|
+
// 为每个必需技能写一条 `<node>-<skill>.json` 标记——每条的 protocols 都覆盖该节点**全部**协议文件,
|
|
61
|
+
// 等价于一次带多个 `--prompt` 的真实 skill-load(真实流程里协调者声明、record 自动补写,夹具直接
|
|
62
|
+
// 写 state 时这两步都不发生,必须由夹具补上同一份事实)。
|
|
63
|
+
//
|
|
64
|
+
// 与被测判据同源(protocol-utils 的 declarationSkillTargets / guardedDeclarationSkills / nodePromptFiles),
|
|
65
|
+
// 不手抄清单:协议面演进时夹具跟着变,不会退化成「夹具写死一份旧清单」。
|
|
66
|
+
//
|
|
67
|
+
// 适用边界(契约,负例不得走这里):
|
|
68
|
+
// · 只写**本节点**的必需标记:其它节点的标记不写——「跨节点标记不算数」仍由显式负例判;
|
|
69
|
+
// · 条件绑定的技能(design 的 flow-comet-ui-design)默认不写(非前端 change 本就不要求声明它);
|
|
70
|
+
// 前端夹具传 `frontend: true`,与其它 guarded 技能同权;
|
|
71
|
+
// · 不写多余标记:不进额外技能、不写额外协议文件清单——「多声明也不顶替缺项」仍由显式负例判;
|
|
72
|
+
// · 声明门自身的负例(目录整体缺席 / 缺某个技能 / 旧单值标记)一律显式删目录或显式写标记,
|
|
73
|
+
// 不走本 helper——否则负例被 helper 补齐后就测不到那道门了。
|
|
74
|
+
export function writeNodeDeclarationMarkers(dir, nodeId, { changeId = CHANGE_ID, frontend = false, skills = null } = {}) {
|
|
75
|
+
const protocol = JSON.parse(fs.readFileSync(SKILL_PROTOCOL_FILE, 'utf8'));
|
|
76
|
+
const node = (protocol.nodes ?? []).find((item) => item && item.id === nodeId);
|
|
77
|
+
if (node === undefined) throw new Error('夹具构造失败:协议里没有节点 ' + nodeId);
|
|
78
|
+
// 目标集与出口覆盖门的取用面同源:`declarationSkillTargets` = guarded 必需技能(条件绑定不在
|
|
79
|
+
// 同步面展开),一个都不剩时退到该节点的实现技能——subagent-execute 这类「技能全划给子代理」
|
|
80
|
+
// 的节点,出口仍要求声明 4-dev.md,声明就挂在实现技能名下(与恢复段打印的命令同一个技能名)。
|
|
81
|
+
// 前端夹具(design 的 ui-design 判据成立)把条件绑定的技能一并声明。
|
|
82
|
+
const targets = skills ?? (frontend
|
|
83
|
+
? guardedDeclarationSkills(node)
|
|
84
|
+
: declarationSkillTargets(node));
|
|
85
|
+
const files = nodePromptFiles(node);
|
|
86
|
+
for (const skill of targets) {
|
|
87
|
+
writeFile(dir, '.specs/' + changeId + '/.skill-loads/' + nodeId + '-' + skill + '.json',
|
|
88
|
+
JSON.stringify({
|
|
89
|
+
node: nodeId,
|
|
90
|
+
skill,
|
|
91
|
+
protocol: files[0] ?? null,
|
|
92
|
+
protocols: files,
|
|
93
|
+
at: '2026-08-01T00:00:00.000Z',
|
|
94
|
+
}, null, 2) + '\n');
|
|
95
|
+
}
|
|
96
|
+
return targets;
|
|
97
|
+
}
|
|
98
|
+
|
|
57
99
|
// 组件技能树布局感知(单一来源):本 suite 恒位于 <skillsRoot>/flow-comet/scripts/,
|
|
58
100
|
// 组件技能(flow-comet-execute / flow-comet-review / flow-comet-verify 等)是 <skillsRoot>
|
|
59
101
|
// 下的同级目录。权威源 checkout → <root>/.flow-comet/skills/;安装副本 → <目标>/.claude|
|
|
@@ -129,7 +171,8 @@ export function runPrepareEnv(args, root, envOverrides = {}) {
|
|
|
129
171
|
}
|
|
130
172
|
|
|
131
173
|
// 跑 workflow-state.mjs 的 bridge-check 只读子命令(T05 实现——六判定态健康/文件缺失/
|
|
132
|
-
//
|
|
174
|
+
// 未挂载/版本偏斜/重复注册/不适用)。运行根由唯一解析模块(run-root.mjs)给定:
|
|
175
|
+
// FLOW_COMET_RUN_ROOT 优先(夹具把该变量与 cwd 一并设为 root);协议副本须在 runRoot 内
|
|
133
176
|
// (protected-path)——指向运行器已复制到 <root>/reference/ 的内置协议副本
|
|
134
177
|
// (FLOW_COMET_PROTOCOL env 优先级高于默认,见 protocol-utils resolveProtocol)。
|
|
135
178
|
export function runBridgeCheck(root, dshHome) {
|
|
@@ -668,9 +711,13 @@ export const CROSS_TASK_FIX_SECTION_PAIR =
|
|
|
668
711
|
|
|
669
712
|
// 波次分组场景公共路径:注入 TASK.md → entry plan(记录 enteredNodes,新 change 强制先 entry;
|
|
670
713
|
// 旧 change 亦先 entry 避免 ENTER WARN 干扰断言)→ exit plan。返回 exit plan 结果。
|
|
714
|
+
// 新 change 的声明标记在这里补齐:真实流程里协调者 entry 时会 skill-load、record 会补写标记,
|
|
715
|
+
// 夹具直接写 state 时这两步都不发生——不补就会被「缺协议声明标记」先拦下,被测的波次判据根本
|
|
716
|
+
// 轮不到说话。声明门自身的负例不走本入口(它们直接 runGuard,且显式删目录/缺标记)。
|
|
671
717
|
export function runPlanExit(dir, taskContent) {
|
|
672
718
|
writeFile(dir, '.specs/' + CHANGE_ID + '/TASK.md', '# TASK\n\n## 任务清单\n\n' + taskContent);
|
|
673
719
|
assertExit(runGuard(['entry', 'plan'], dir), 0);
|
|
720
|
+
writeNodeDeclarationMarkers(dir, 'plan');
|
|
674
721
|
return runGuard(['exit', 'plan'], dir);
|
|
675
722
|
}
|
|
676
723
|
|
|
@@ -753,8 +800,8 @@ export function writeMigratedProjectArtifacts(proj, changeId = MIGRATION_CHANGE)
|
|
|
753
800
|
writeFile(proj, '.specs/' + changeId + '/REQUIREMENT.md', '# REQUIREMENT\n\n- **Change ID**: ' + changeId + '\n\n## 用户故事(User Story)\n\nx\n\n## 验收准则(AC)\n\n- y\n');
|
|
754
801
|
}
|
|
755
802
|
|
|
756
|
-
// 跑安装副本内的脚本(cwd =
|
|
757
|
-
//
|
|
803
|
+
// 跑安装副本内的脚本(cwd = 目标项目根,FLOW_COMET_RUN_ROOT 设为同一个根):运行根由唯一
|
|
804
|
+
// 解析模块(run-root.mjs)给定(变量优先)——迁移后链路在真实安装形态(而非权威源脚本)上验证
|
|
758
805
|
export function runInstalled(proj, platformRoot, scriptName, args) {
|
|
759
806
|
const script = path.join(proj, platformRoot, 'skills', 'flow-comet', 'scripts', scriptName);
|
|
760
807
|
const res = spawnSync(process.execPath, [script, ...args], {
|
|
@@ -938,9 +985,12 @@ export function engineConsumersOf(name, scriptsDir = SCRIPTS_DIR) {
|
|
|
938
985
|
|
|
939
986
|
// 从具名 import 列表里摘掉一个名字(反向构造用;名前 / 名后 / 唯一项三种位置都覆盖):
|
|
940
987
|
// 摘掉后消费方仍引用该符号 ⇒ 「未从单源取用」必报。位置感知是必须的——只处理「名字后带逗号」
|
|
941
|
-
//
|
|
988
|
+
// 的写法在名字位于列表末位时会静默不改;只剩一个名字的列表(`import { NAME } from …`)更没有逗号可
|
|
989
|
+
// 依,整句不动。两种形态下探针都退化为恒绿 / 报「前提失效」,锁的判别力无从证明(L-151)。
|
|
942
990
|
export function dropNamedImport(text, name) {
|
|
943
991
|
return String(text)
|
|
992
|
+
// 唯一项:列表里只有这一个名字(单行 / 多行同形;摘完保留 `import {}` 这层语句结构,变异只动名字)。
|
|
993
|
+
.replace(new RegExp('(import\\s*\\{)\\s*\\b' + name + '\\b\\s*(\\})'), '$1$2')
|
|
944
994
|
.replace(new RegExp('(import\\s*\\{[^}]*?)\\b' + name + '\\b\\s*,\\s*'), '$1')
|
|
945
995
|
.replace(new RegExp('(import\\s*\\{[^}]*?)\\s*,\\s*\\b' + name + '\\b'), '$1');
|
|
946
996
|
}
|
|
@@ -93,9 +93,9 @@ export function writeState(root, state) {
|
|
|
93
93
|
}
|
|
94
94
|
|
|
95
95
|
// ---------- 受控命令(runRoot = 夹具根) ----------
|
|
96
|
-
// 约定:spawn 时 cwd =
|
|
97
|
-
//
|
|
98
|
-
//
|
|
96
|
+
// 约定:spawn 时 cwd = 夹具根,并注入 FLOW_COMET_RUN_ROOT 环境变量——状态命令的运行根由唯一
|
|
97
|
+
// 解析模块取该变量优先、否则进程 cwd,故运行根 = 夹具根;同时捕获 stdout + stderr(WARN/BLOCKED
|
|
98
|
+
// 走 stderr,成功退出时只取 stdout 会让 WARN 断言误报)与 exit code,统一返回
|
|
99
99
|
// `{ status, output }`(output 为 stdout+stderr 拼接的字符串)。
|
|
100
100
|
// 统一超时(毫秒):真实命令在冷启动 / 慢文件系统上耗时波动,60s 是两套件既有取值。
|
|
101
101
|
const COMMAND_TIMEOUT_MS = 60000;
|
|
@@ -223,6 +223,63 @@ export function copyTreePortable(src, dst) {
|
|
|
223
223
|
}
|
|
224
224
|
}
|
|
225
225
|
|
|
226
|
+
// ---------- 打印出来的命令:解析 → argv → 真实执行 ----------
|
|
227
|
+
//
|
|
228
|
+
// 运行期消息打印的命令是**给执行者照抄的文本**,判据就得真的照着它跑:只断言字面串、再用 harness
|
|
229
|
+
// 的绝对脚本路径去执行,等于从未执行过打印出来的那条文本(形似全绿)。这一组是那条链路的单一
|
|
230
|
+
// 来源:按安装布局复制技能树 → 把打印命令按 shell 语义切成 argv → 真实执行打印文本。两组场景
|
|
231
|
+
//(委托链路 / 声明恢复)都从这里取用——各存一份时,同一条命令会在两组的判据里各自演化,而任一侧
|
|
232
|
+
// 漂移都不会让另一侧变红。
|
|
233
|
+
|
|
234
|
+
// 把套件自身技能树按安装布局复制进夹具(与安装器装出的副本同构):副本自身运行时推导出的是
|
|
235
|
+
// **运行根相对**的脚本目录,打印的命令因此可在夹具内解析——执行的是打印文本,不是 harness 的
|
|
236
|
+
// 绝对脚本路径。installDirRel 是该布局在运行根下的相对目录(夹具构造,不是断言对象)。
|
|
237
|
+
export function installSkillTreeCopy(root, installDirRel) {
|
|
238
|
+
const skillCopy = path.join(root, installDirRel, 'flow-comet');
|
|
239
|
+
copyTreePortable(path.join(SCRIPTS_DIR, '..'), skillCopy);
|
|
240
|
+
return skillCopy;
|
|
241
|
+
}
|
|
242
|
+
|
|
243
|
+
// 打印命令 → argv:按 shell 分词语义处理双引号与单引号(引号内空白不切分,引号本身不进入参数)。
|
|
244
|
+
// 该解析器对「整条路径未加引号」有判别力——缺引号时含空格的路径会被切成多个参数。
|
|
245
|
+
export function splitPrintedCommand(command) {
|
|
246
|
+
const argv = [];
|
|
247
|
+
let current = '';
|
|
248
|
+
let quote = null;
|
|
249
|
+
let started = false;
|
|
250
|
+
for (const ch of command) {
|
|
251
|
+
if (quote) {
|
|
252
|
+
if (ch === quote) { quote = null; continue; }
|
|
253
|
+
current += ch;
|
|
254
|
+
continue;
|
|
255
|
+
}
|
|
256
|
+
if (ch === '"' || ch === "'") { quote = ch; started = true; continue; }
|
|
257
|
+
if (/\s/.test(ch)) {
|
|
258
|
+
if (started) { argv.push(current); current = ''; started = false; }
|
|
259
|
+
continue;
|
|
260
|
+
}
|
|
261
|
+
current += ch;
|
|
262
|
+
started = true;
|
|
263
|
+
}
|
|
264
|
+
if (quote) throw new Error('打印命令的引号未闭合: ' + command);
|
|
265
|
+
if (started) argv.push(current);
|
|
266
|
+
return argv;
|
|
267
|
+
}
|
|
268
|
+
|
|
269
|
+
// 真实执行打印出来的那条命令:解释器名 `node` 换成本进程的 node 可执行文件(PATH 解析不是本锚点
|
|
270
|
+
// 的断言对象,脚本路径与参数才是),其余一律照打印文本解析。
|
|
271
|
+
export function runPrintedCommand(command, root, envOverrides = {}) {
|
|
272
|
+
const argv = splitPrintedCommand(command);
|
|
273
|
+
const interpreter = /^node(\.exe)?$/i.test(argv[0]) ? process.execPath : argv[0];
|
|
274
|
+
const res = spawnSync(interpreter, argv.slice(1), {
|
|
275
|
+
cwd: root,
|
|
276
|
+
env: { ...process.env, ...envOverrides },
|
|
277
|
+
encoding: 'utf8',
|
|
278
|
+
timeout: 60000,
|
|
279
|
+
});
|
|
280
|
+
return { status: res.status ?? 1, output: String(res.stdout || '') + String(res.stderr || '') };
|
|
281
|
+
}
|
|
282
|
+
|
|
226
283
|
// 最小合法 state(夹具起点):字段与状态校验器的类型要求同形;node 为当前节点。
|
|
227
284
|
export function baseState(node) {
|
|
228
285
|
return {
|
|
@@ -16,6 +16,7 @@ import {
|
|
|
16
16
|
writeState,
|
|
17
17
|
} from './test-helpers.mjs';
|
|
18
18
|
import {
|
|
19
|
+
AUTHORITATIVE_SOURCE_ANCHOR,
|
|
19
20
|
CHANGE_ID,
|
|
20
21
|
HOOK,
|
|
21
22
|
REPO_ROOT,
|
|
@@ -165,6 +166,137 @@ export function maintainerFacePresent(root = REPO_ROOT) {
|
|
|
165
166
|
return fs.existsSync(path.join(root, MAINTAINER_DOC_DIR));
|
|
166
167
|
}
|
|
167
168
|
|
|
169
|
+
// 公开面形态判据(与场景 105 / TA-24 共用同一口径:三份公开面载体是否**俱缺**,判定同一个 existsSync):
|
|
170
|
+
// package.json 的 files 白名单只带 .flow-comet/skills、.flow-comet/rules 与 scripts/——npm 包
|
|
171
|
+
// (以及安装副本)**本来就不含公开面**。这种形态下「受检条目不在场」是载体的正常形态,不是仓库
|
|
172
|
+
// 缺文件:报成「幽灵条目」会把读者送去修一个不存在的缺陷(与维护者组整组缺席同一类判断)。
|
|
173
|
+
// 判据强度不降:跳过通道只对「整份公开面不存在」开放——docs/ 在而某份文档被删 = 检出被裁坏,
|
|
174
|
+
// 仍走逐条严检并判红(反向构造:权威源检出里移走一份受检文档,缺失照样被点名)。
|
|
175
|
+
// **只看 docs/ 不够**:分支 / 稀疏检出 / 误删把 docs/ 整份拿掉时,「本载体不含公开面」
|
|
176
|
+
// 是假话,计数一致性(场景数 / 系统测试集项数锁)、公开产物零代号与词表镜像会整块变成可见 SKIP 并
|
|
177
|
+
// exit 0。故还要求其余公开面载体一并缺席:CONTRIBUTING.md 与 .github/ 都进版本控制、都不进 npm
|
|
178
|
+
// tarball,任一在场即证明本检出是仓库(只是被裁坏了),必须逐条严检并判红。README 刻意不作判据:
|
|
179
|
+
// npm 发布时会强制包含它,用它判断等于把包形态整块误判成「有公开面」,跳过通道反而失效。
|
|
180
|
+
export const PUBLIC_FACE_DOCS_DIR = 'docs';
|
|
181
|
+
export const PUBLIC_FACE_CARRIER_PATHS = ['CONTRIBUTING.md', '.github'];
|
|
182
|
+
export function publicFaceDocsAbsent(root = REPO_ROOT) {
|
|
183
|
+
return !fs.existsSync(path.join(root, PUBLIC_FACE_DOCS_DIR))
|
|
184
|
+
&& PUBLIC_FACE_CARRIER_PATHS.every((rel) => !fs.existsSync(path.join(root, rel)));
|
|
185
|
+
}
|
|
186
|
+
// 跳过提示的措辞是判据的一部分(SKIP = 未校验,不是通过):读者既不该把「此形态不含公开面」读成
|
|
187
|
+
// 「公开面已检查且通过」,也不该读成「仓库缺文件」——那是两个方向相反的误读。
|
|
188
|
+
export const PUBLIC_FACE_SELF_CHECK_SKIP_NOTICE = 'SKIP: 公开面自检(计数一致性 / 公开产物零代号 / 词表镜像)'
|
|
189
|
+
+ '——此形态不含公开面:' + [PUBLIC_FACE_DOCS_DIR + '/', ...PUBLIC_FACE_CARRIER_PATHS].join('、')
|
|
190
|
+
+ ' 都不在本检出(npm 包按 package.json 的 files 白名单、安装副本按安装面,携带的都只是技能树与'
|
|
191
|
+
+ ' scripts/,公开文档不随分发包走)——'
|
|
192
|
+
+ '「受检条目不在场」是这种载体的正常形态,不是仓库缺文件;本次未校验条目在场与同步、'
|
|
193
|
+
+ '公开产物零代号、词表镜像等价性(SKIP = 未校验,不是通过;请在权威源检出重跑本套件)';
|
|
194
|
+
|
|
195
|
+
// ---------- 公开面自检:形态分派 + 各面判据的唯一调用点 ----------
|
|
196
|
+
// 底部自检与场景共用本函数(判定本体只此一份):底部只负责调用与打印;场景在临时根上驱动它,
|
|
197
|
+
// 于是「形态分派对不对」成了常驻断言,不必等到在包形态里整跑一次套件才知道。
|
|
198
|
+
// 形态三向(分派先于任何内容判据):
|
|
199
|
+
// ① 权威源检出 + 公开面在场 → 全套判据(计数一致性 / 维护文档机检 / 公开产物零代号 / 词表镜像);
|
|
200
|
+
// ② 权威源检出 + 公开面载体俱缺(docs/、CONTRIBUTING.md、.github/ 都不在 = npm 包形态)→ 整块
|
|
201
|
+
// 显式 SKIP:受检条目不在场是这种载体的正常形态,报成「幽灵条目」会把读者送去修一个不存在的缺陷;
|
|
202
|
+
// ③ 安装副本(无技能树锚)→ 词表镜像判据「不适用」说明(主仓私有面结构性缺席)。
|
|
203
|
+
// 跳过一律**可见但不算通过**(SKIP = 未校验),且跳过的粒度只有「整份面缺席」——docs/ 在场而某份
|
|
204
|
+
// 受检文档被删仍逐条判红;docs/ 不在而 CONTRIBUTING.md / .github/ 在场同样判红(那是被裁坏的仓库,
|
|
205
|
+
// 不是「不含公开面」的载体)。判据强度不降;计数本体仍是 countSyncProblems,与场景共用同一实现。
|
|
206
|
+
// 技能树锚点的相对形态(字面量仍由 test-fixtures 的 AUTHORITATIVE_SOURCE_ANCHOR 单点拥有,这里只做
|
|
207
|
+
// 相对化):任意受检根上的「本检出是不是权威源」与真实检出同判据,不另写第二份。
|
|
208
|
+
export const AUTHORITATIVE_SOURCE_ANCHOR_REL = path
|
|
209
|
+
.relative(REPO_ROOT, AUTHORITATIVE_SOURCE_ANCHOR)
|
|
210
|
+
.split(path.sep)
|
|
211
|
+
.join('/');
|
|
212
|
+
export function authoritativeSourceAt(root = REPO_ROOT) {
|
|
213
|
+
return fs.existsSync(path.join(root, AUTHORITATIVE_SOURCE_ANCHOR_REL));
|
|
214
|
+
}
|
|
215
|
+
// 安装副本形态的「不适用」说明:措辞与形态判据同处维护——一处说「不适用」、另一处说「缺文件」,
|
|
216
|
+
// 正是本批修掉的误诊形态。
|
|
217
|
+
export const INSTALLED_COPY_SELF_CHECK_NOTICE = 'SKIP/NOT-APPLICABLE: 词表镜像漂移判据(.githooks 为主仓私有面)'
|
|
218
|
+
+ ';本次检出无该私有面,未执行「词表单一来源 ↔ 套件同义镜像」的逐字符等价性比对'
|
|
219
|
+
+ '——请在主仓私有面在场处重跑本套件(主树 L1),勿把不适用当成已校验。';
|
|
220
|
+
// 公开产物零代号受检清单(公开面在场时逐份扫描;条目缺失显式报告,不静默跳过)。
|
|
221
|
+
export const PUBLIC_FACE_CODE_DOCS = [
|
|
222
|
+
'README.md', 'README-zh.md', 'CONTRIBUTING.md', 'CONTRIBUTING-zh.md',
|
|
223
|
+
'SECURITY.md', 'SECURITY-zh.md', 'CODE_OF_CONDUCT.md', 'CODE_OF_CONDUCT-zh.md',
|
|
224
|
+
'CHANGELOG.md', 'CHANGELOG-zh.md',
|
|
225
|
+
'docs/INSTALLATION.md', 'docs/INSTALLATION-zh.md', 'docs/MECHANISM.md', 'docs/MECHANISM-zh.md',
|
|
226
|
+
'docs/USAGE.md', 'docs/USAGE-zh.md',
|
|
227
|
+
'docs/TROUBLESHOOTING.md', 'docs/TROUBLESHOOTING-zh.md', 'docs/VERSIONS.md', 'docs/VERSIONS-zh.md',
|
|
228
|
+
'.github/PULL_REQUEST_TEMPLATE.md',
|
|
229
|
+
'.github/ISSUE_TEMPLATE/1-bug_report.yml', '.github/ISSUE_TEMPLATE/2-feature_request.yml',
|
|
230
|
+
'.github/ISSUE_TEMPLATE/3-question.md', '.github/ISSUE_TEMPLATE/4-task.md',
|
|
231
|
+
];
|
|
232
|
+
// 受检面的可见事实(防漂移):文件数由受检清单推导、不硬编码——分发组 / 维护者组规模变化在此
|
|
233
|
+
// 直接可见(维护者面整组缺席时只计分发面)。
|
|
234
|
+
export function countFaceNotice(root = REPO_ROOT) {
|
|
235
|
+
const distFaceCount = new Set([...SCENARIO_COUNT_FILES, ...SYSTEM_TEST_COUNT_FILES]).size;
|
|
236
|
+
const maintainerFaceCount = maintainerFacePresent(root)
|
|
237
|
+
? new Set([...SCENARIO_COUNT_FILES_MAINTAINER, ...SYSTEM_TEST_COUNT_FILES_MAINTAINER]).size
|
|
238
|
+
: 0;
|
|
239
|
+
return '受检面: ' + (distFaceCount + maintainerFaceCount) + ' 文件(分发 ' + distFaceCount
|
|
240
|
+
+ ' + 维护者 ' + maintainerFaceCount + ')';
|
|
241
|
+
}
|
|
242
|
+
|
|
243
|
+
// 输入:受检根(判定所需的全部读取都相对它进行)+ 计数派生目录;输出:
|
|
244
|
+
// { skip, problems, notices } —— skip 非 null 即该形态不含这一面(problems 恒为空);
|
|
245
|
+
// 否则 problems 是问题清单([{ name, error }],空数组 = 通过),notices 是必须可见的覆盖面事实。
|
|
246
|
+
export async function publicFaceSelfCheck({ root = REPO_ROOT, scriptsDir = SCRIPTS_DIR } = {}) {
|
|
247
|
+
// ③ 安装副本(无技能树锚):主仓私有面结构性缺席 → 词表镜像判据不适用(可见,仍不算通过)。
|
|
248
|
+
if (!authoritativeSourceAt(root)) {
|
|
249
|
+
return {
|
|
250
|
+
skip: { reason: 'installed-copy-without-skill-tree', notice: INSTALLED_COPY_SELF_CHECK_NOTICE },
|
|
251
|
+
problems: [],
|
|
252
|
+
notices: [],
|
|
253
|
+
};
|
|
254
|
+
}
|
|
255
|
+
// ② 包形态(技能树锚在、docs/ + CONTRIBUTING.md + .github/ 三者俱缺):受检条目不在场是这种载体
|
|
256
|
+
// 的正常形态,不是仓库缺文件——报成幽灵条目会把读者送去修一个不存在的缺陷。跳过 ≠ 通过,提示必须
|
|
257
|
+
// 带「未校验」。判据只在三者俱缺时成立:docs/ 被裁掉而其余载体还在时,走下一条逐条严检(那是被裁坏
|
|
258
|
+
// 的仓库,不是不含公开面的载体)。
|
|
259
|
+
if (publicFaceDocsAbsent(root)) {
|
|
260
|
+
return {
|
|
261
|
+
skip: { reason: 'package-without-public-face', notice: PUBLIC_FACE_SELF_CHECK_SKIP_NOTICE },
|
|
262
|
+
problems: [],
|
|
263
|
+
notices: [],
|
|
264
|
+
};
|
|
265
|
+
}
|
|
266
|
+
// ① 权威源检出 + 公开面在场:全套判据(跳过通道到此为止,缺一份文档照样逐条判红)
|
|
267
|
+
const problems = [];
|
|
268
|
+
for (const problem of await countSyncProblems(root, scriptsDir)) {
|
|
269
|
+
problems.push({ name: '计数一致性', error: problem });
|
|
270
|
+
}
|
|
271
|
+
for (const problem of internalDocsProblems(root)) {
|
|
272
|
+
problems.push({ name: '维护文档机检', error: problem });
|
|
273
|
+
}
|
|
274
|
+
for (const rel of PUBLIC_FACE_CODE_DOCS) {
|
|
275
|
+
let text;
|
|
276
|
+
try {
|
|
277
|
+
text = fs.readFileSync(path.join(root, rel), 'utf8');
|
|
278
|
+
} catch (e) {
|
|
279
|
+
// ENOENT 同样显式报告:本清单全部为随仓库分发的文件,任何权威源检出都应存在——静默跳过会让
|
|
280
|
+
// 「永不生效的条目」藏身。
|
|
281
|
+
problems.push({ name: '公开产物零代号(' + rel + ')', error: '文件缺失: ' + e.message });
|
|
282
|
+
continue;
|
|
283
|
+
}
|
|
284
|
+
const hit = text.match(PUBLIC_CODE_RE);
|
|
285
|
+
if (hit) {
|
|
286
|
+
problems.push({ name: '公开产物零代号(' + rel + ')', error: rel + ' 含过程代号: "' + hit[0] + '"' });
|
|
287
|
+
}
|
|
288
|
+
}
|
|
289
|
+
for (const problem of vocabularyMirrorProblems(root)) {
|
|
290
|
+
problems.push({ name: '词表镜像漂移', error: problem });
|
|
291
|
+
}
|
|
292
|
+
const notices = [countFaceNotice(root)];
|
|
293
|
+
for (const skip of maintainerFaceSkips(root)) {
|
|
294
|
+
notices.push('SKIP: ' + skip.face + ' — ' + skip.reason
|
|
295
|
+
+ ';本次检出未执行该面校验,请在维护者主树重跑本套件(主树 L1),勿把跳过当成已校验。');
|
|
296
|
+
}
|
|
297
|
+
return { skip: null, problems, notices };
|
|
298
|
+
}
|
|
299
|
+
|
|
168
300
|
// ---------- 计数 stale 检测(presence 之外的判别力补足) ----------
|
|
169
301
|
// presence 只能证明"当前值在场",证不了"旧值不在场":维护面曾长期带着无标记旧值仍全绿。
|
|
170
302
|
// 判据:受检面里出现**计数形态 token**、数值落在合理量程、且不等于当前值、且行内没有历史
|
|
@@ -864,10 +996,13 @@ export function skillLoadingWordingProblems(rel, text) {
|
|
|
864
996
|
// ⑤ 条件句指针:两册各自须指向 commit-discipline / platform-facts / fix-loop 三个权威文件。
|
|
865
997
|
export const COMMIT_DISCIPLINE_REL = 'flow-comet/reference/commit-discipline.md';
|
|
866
998
|
export const PLATFORM_FACTS_REL = 'flow-comet/reference/platform-facts.md';
|
|
999
|
+
// 提交形态的字面(消息在 `--` 之前):两册的要素 token 与入口册的存在性判据**取同一字面**——
|
|
1000
|
+
// 三处各写一份就会各自漂移(改一处漏一处正是这行此前没有锁的成因)。
|
|
1001
|
+
export const COMMIT_FORM_TOKEN = '`git commit -m "<消息>" -- <同一路径>`';
|
|
867
1002
|
export const COMMIT_DISCIPLINE_ELEMENT_GROUPS = [
|
|
868
1003
|
['提交面 pathspec 纪律 · 适用条件', ['**各自独立工作区(worktree 等)内的局部 `reset` / `clean` 不在禁令内**']],
|
|
869
1004
|
['提交面 pathspec 纪律 · 要素 1(字面路径集)',
|
|
870
|
-
['`git add -- <自己字面路径>`',
|
|
1005
|
+
['`git add -- <自己字面路径>`', COMMIT_FORM_TOKEN, 'write_files']],
|
|
871
1006
|
['提交面 pathspec 纪律 · 要素 2(锁失败重试)', ['锁失败重试', 'index.lock', '失败即重试']],
|
|
872
1007
|
['提交面 pathspec 纪律 · 要素 3(禁裸命令)',
|
|
873
1008
|
['禁裸', '`commit -a`', '`stash`', '`clean`', '`reset`']],
|
|
@@ -880,7 +1015,7 @@ export const COMMIT_DISCIPLINE_ELEMENT_GROUPS = [
|
|
|
880
1015
|
];
|
|
881
1016
|
// 权威处**正文**(逐字搬运进 `commit-discipline.md` 的原句;实测两册均无这些整句——回流即红)。
|
|
882
1017
|
export const COMMIT_DISCIPLINE_AUTHORITY_PHRASES = [
|
|
883
|
-
'2. **`git commit --
|
|
1018
|
+
'2. **`git commit -m "<消息>" -- <同一路径>`**:消息(含正文尾注 `-m "Task: <id>"`)写在 `--` **之前**,pathspec 写在 `--` 之后——提交以 pathspec 限定范围,保证提交只含自己的文件;路径集与上一步**逐字一致**。消息若落到 `--` 之后(`git commit -- <路径> -m "<消息>"`),`-m` 会被当成 pathspec、提交直接失败(退出码 1)。',
|
|
884
1019
|
'3. **锁失败重试**:并发提交会撞 `index.lock` / `cannot lock ref`——**失败即重试**(临时仓真并发实测:20 提交 / 25 次锁失败全部重试成功);不得因锁失败改用宽泛命令。',
|
|
885
1020
|
'5. **为什么**:并发写者共享**同一个索引与工作树**——宽泛命令存在**并发索引竞态**:一方 `add -A` 会把另一方的半成品纳入自己的提交(串味 / 多文件提交);`stash` / `clean` / `reset` 更会直接破坏同伴的未提交工作。',
|
|
886
1021
|
'**并行波次附加两条(与上列五要素并列适用 · 不改其语义与适用条件)**:',
|
|
@@ -976,6 +1111,26 @@ export function delegationDisciplineProblems({ books, elementDocs, authorityText
|
|
|
976
1111
|
return problems;
|
|
977
1112
|
}
|
|
978
1113
|
|
|
1114
|
+
// 入口册的提交形态(场景 184d 使用;纯函数 + 合成文本可驱动):入口册「② 提交隔离」那一行是
|
|
1115
|
+
// 执行者最早读到的提交命令形态——两册与权威处都有要素 token 锁,**唯独这一行没有**:把它退回
|
|
1116
|
+
// 「`git commit -- <路径>`」(不给消息选项)时套件不会红(该形态照抄下行即 `-m` 被当成 pathspec、
|
|
1117
|
+
// exit 1)。判据两条:① 存在性——要点句在场且取与两册**同一字面**(含 `-m`);② 反否定——不得
|
|
1118
|
+
// 出现缺 `-m` 的旧形态字面。反否定的正则只认**相邻**形态(`git commit -- <`):把「`git commit`
|
|
1119
|
+
// 与 `--` 分开匹配会连「`-m` 在前、`--` 在后」的正确写法一并判红,那是恒红而非锁。
|
|
1120
|
+
export const ENTRY_COMMIT_FORM_REL = 'flow-comet/SKILL.md';
|
|
1121
|
+
export const ENTRY_COMMIT_FORM_OLD_RE = /git commit\s+--\s*</;
|
|
1122
|
+
export function entryCommitFormProblems(rel, text) {
|
|
1123
|
+
const problems = [];
|
|
1124
|
+
if (!text.includes(COMMIT_FORM_TOKEN)) {
|
|
1125
|
+
problems.push(rel + ' 缺带消息的提交形态要点句: ' + COMMIT_FORM_TOKEN);
|
|
1126
|
+
}
|
|
1127
|
+
const old = ENTRY_COMMIT_FORM_OLD_RE.exec(text);
|
|
1128
|
+
if (old) {
|
|
1129
|
+
problems.push(rel + ' 出现缺 `-m` 的旧提交形态「' + old[0].trim() + '」——消息必须写在 `--` 之前');
|
|
1130
|
+
}
|
|
1131
|
+
return problems;
|
|
1132
|
+
}
|
|
1133
|
+
|
|
979
1134
|
// 前端判据散文口径(场景 286 使用;纯函数 + 合成文本面可驱动):ADR-016 把原「五份文本**各自**
|
|
980
1135
|
// 陈述五个结构 token」重定向为「**一处权威**(`flow-comet-ui-design` 册的「触发与跳过」段陈述
|
|
981
1136
|
// 结构形态三种 + 词形边界 + 命中片段回显)+ **各引用册指针在场**(条件句指向该册,缺即红)+
|
|
@@ -1257,7 +1412,7 @@ export function identityUpgradeProblems({ entry, facts, others }) {
|
|
|
1257
1412
|
|
|
1258
1413
|
// 平台事实(场景 184 的 ⑤ / ⑦ 使用;纯函数 + 合成输入可驱动):Codex 平台事实与支持面的判别句
|
|
1259
1414
|
// 随 `worktree-notes.md` 移出技能树后**唯一权威处** = `flow-comet/reference/platform-facts.md`
|
|
1260
|
-
|
|
1415
|
+
//(已按「逐字搬运,不重写」搬入)。判据三侧:① 权威处在场(判别句 + 旧独断句只允许被反驳
|
|
1261
1416
|
// 引用形态 + 适用范围限定 + fail-open / 未闭合的现判据);② 各引用册**指针在场**;③ **证据正文
|
|
1262
1417
|
// 不回流册子**(权威处唯一——原逐字锁「多处各持一份」的方向已反转)。
|
|
1263
1418
|
// `PLATFORM_FACTS_ONLY_PHRASES` 是**证据与过程记录**类判别句(按 ADR-016 的「证据与判级随平台事实
|