flow-comet 1.6.5 → 1.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (89) hide show
  1. package/.flow-comet/skills/flow-comet/INSTALLED_VERSION +1 -1
  2. package/.flow-comet/skills/flow-comet/SKILL.md +32 -18
  3. package/.flow-comet/skills/flow-comet/reference/commit-discipline.md +2 -2
  4. package/.flow-comet/skills/flow-comet/reference/decision-points.md +5 -5
  5. package/.flow-comet/skills/flow-comet/reference/dirty-worktree.md +1 -1
  6. package/.flow-comet/skills/flow-comet/reference/entry-detail.md +30 -11
  7. package/.flow-comet/skills/flow-comet/reference/fix-loop.md +4 -4
  8. package/.flow-comet/skills/flow-comet/reference/init-detection.md +1 -1
  9. package/.flow-comet/skills/flow-comet/reference/platform-facts.md +2 -2
  10. package/.flow-comet/skills/flow-comet/reference/post-archive-handoff.md +264 -0
  11. package/.flow-comet/skills/flow-comet/reference/recovery.md +1 -1
  12. package/.flow-comet/skills/flow-comet/reference/replan.md +1 -1
  13. package/.flow-comet/skills/flow-comet/scripts/comet-check.mjs +1 -0
  14. package/.flow-comet/skills/flow-comet/scripts/comet-hook-guard.mjs +270 -30
  15. package/.flow-comet/skills/flow-comet/scripts/context-init.mjs +26 -23
  16. package/.flow-comet/skills/flow-comet/scripts/guard-self-test.mjs +14 -94
  17. package/.flow-comet/skills/flow-comet/scripts/items/a.mjs +122 -11
  18. package/.flow-comet/skills/flow-comet/scripts/items/b.mjs +79 -40
  19. package/.flow-comet/skills/flow-comet/scripts/items/c.mjs +11 -9
  20. package/.flow-comet/skills/flow-comet/scripts/items/e.mjs +52 -10
  21. package/.flow-comet/skills/flow-comet/scripts/items/f.mjs +1 -1
  22. package/.flow-comet/skills/flow-comet/scripts/items/h.mjs +128 -56
  23. package/.flow-comet/skills/flow-comet/scripts/items/k.mjs +357 -3
  24. package/.flow-comet/skills/flow-comet/scripts/items/l.mjs +26 -1
  25. package/.flow-comet/skills/flow-comet/scripts/items/m.mjs +6 -2
  26. package/.flow-comet/skills/flow-comet/scripts/items/n.mjs +29 -21
  27. package/.flow-comet/skills/flow-comet/scripts/lib/ac-coverage.mjs +317 -0
  28. package/.flow-comet/skills/flow-comet/scripts/lib/fix-loop-node.mjs +4 -15
  29. package/.flow-comet/skills/flow-comet/scripts/lib/guard-artifact-skeleton.mjs +47 -5
  30. package/.flow-comet/skills/flow-comet/scripts/lib/guard-evidence-gates.mjs +357 -219
  31. package/.flow-comet/skills/flow-comet/scripts/lib/guard-gates.mjs +725 -309
  32. package/.flow-comet/skills/flow-comet/scripts/lib/guard-routing.mjs +182 -54
  33. package/.flow-comet/skills/flow-comet/scripts/lib/guard-state-io.mjs +8 -6
  34. package/.flow-comet/skills/flow-comet/scripts/lib/guard-template-fidelity.mjs +224 -83
  35. package/.flow-comet/skills/flow-comet/scripts/lib/guard-uidesign.mjs +17 -28
  36. package/.flow-comet/skills/flow-comet/scripts/lib/lessons-hits.mjs +160 -0
  37. package/.flow-comet/skills/flow-comet/scripts/lib/run-root.mjs +21 -0
  38. package/.flow-comet/skills/flow-comet/scripts/lib/section-body.mjs +92 -0
  39. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-admin.mjs +61 -33
  40. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-flow.mjs +663 -205
  41. package/.flow-comet/skills/flow-comet/scripts/lib/state-commands-recovery.mjs +68 -9
  42. package/.flow-comet/skills/flow-comet/scripts/lib/state-determine.mjs +11 -4
  43. package/.flow-comet/skills/flow-comet/scripts/lib/state-explain.mjs +92 -13
  44. package/.flow-comet/skills/flow-comet/scripts/lib/state-io.mjs +232 -11
  45. package/.flow-comet/skills/flow-comet/scripts/lib/state-skillmarkers.mjs +140 -74
  46. package/.flow-comet/skills/flow-comet/scripts/lib/system-fixtures.mjs +8 -4
  47. package/.flow-comet/skills/flow-comet/scripts/lib/task-graph.mjs +84 -31
  48. package/.flow-comet/skills/flow-comet/scripts/lib/test-assertions.mjs +0 -3
  49. package/.flow-comet/skills/flow-comet/scripts/lib/test-fixtures.mjs +248 -24
  50. package/.flow-comet/skills/flow-comet/scripts/lib/test-helpers.mjs +63 -3
  51. package/.flow-comet/skills/flow-comet/scripts/lib/text-anchor-checks.mjs +181 -8
  52. package/.flow-comet/skills/flow-comet/scripts/lib/wave-projection.mjs +340 -0
  53. package/.flow-comet/skills/flow-comet/scripts/protocol-utils.mjs +132 -20
  54. package/.flow-comet/skills/flow-comet/scripts/route-node.mjs +12 -5
  55. package/.flow-comet/skills/flow-comet/scripts/scenarios/a.mjs +1564 -54
  56. package/.flow-comet/skills/flow-comet/scripts/scenarios/b.mjs +1489 -38
  57. package/.flow-comet/skills/flow-comet/scripts/scenarios/c.mjs +1466 -243
  58. package/.flow-comet/skills/flow-comet/scripts/scenarios/d.mjs +743 -24
  59. package/.flow-comet/skills/flow-comet/scripts/scenarios/e.mjs +220 -92
  60. package/.flow-comet/skills/flow-comet/scripts/scenarios/f.mjs +657 -21
  61. package/.flow-comet/skills/flow-comet/scripts/scenarios/g.mjs +41 -27
  62. package/.flow-comet/skills/flow-comet/scripts/scenarios/h.mjs +285 -9
  63. package/.flow-comet/skills/flow-comet/scripts/scenarios/i.mjs +7 -6
  64. package/.flow-comet/skills/flow-comet/scripts/scenarios/j.mjs +21 -15
  65. package/.flow-comet/skills/flow-comet/scripts/scenarios/k.mjs +8 -5
  66. package/.flow-comet/skills/flow-comet/scripts/scenarios/l.mjs +45 -36
  67. package/.flow-comet/skills/flow-comet/scripts/scenarios/m.mjs +2 -2
  68. package/.flow-comet/skills/flow-comet/scripts/scenarios/n.mjs +2381 -85
  69. package/.flow-comet/skills/flow-comet/scripts/state-schema.mjs +135 -2
  70. package/.flow-comet/skills/flow-comet/scripts/workflow-guard.mjs +143 -16
  71. package/.flow-comet/skills/flow-comet/scripts/workflow-handoff.mjs +339 -103
  72. package/.flow-comet/skills/flow-comet/scripts/workflow-state.mjs +5 -2
  73. package/.flow-comet/skills/flow-comet-archive/SKILL.md +33 -11
  74. package/.flow-comet/skills/flow-comet-change/SKILL.md +1 -1
  75. package/.flow-comet/skills/flow-comet-design/SKILL.md +5 -3
  76. package/.flow-comet/skills/flow-comet-dev/SKILL.md +2 -2
  77. package/.flow-comet/skills/flow-comet-execute/SKILL.md +37 -13
  78. package/.flow-comet/skills/flow-comet-integration/SKILL.md +10 -4
  79. package/.flow-comet/skills/flow-comet-plan/GUIDANCE.md +1 -1
  80. package/.flow-comet/skills/flow-comet-plan/SKILL.md +13 -6
  81. package/.flow-comet/skills/flow-comet-review/SKILL.md +21 -12
  82. package/.flow-comet/skills/flow-comet-subagent-execute/GUIDANCE.md +1 -1
  83. package/.flow-comet/skills/flow-comet-subagent-execute/SKILL.md +43 -18
  84. package/.flow-comet/skills/flow-comet-task/SKILL.md +4 -2
  85. package/.flow-comet/skills/flow-comet-ui-design/SKILL.md +2 -2
  86. package/.flow-comet/skills/flow-comet-verify/SKILL.md +1 -1
  87. package/README.md +2 -2
  88. package/package.json +1 -1
  89. package/scripts/dsh-bridge.mjs +238 -21
@@ -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**、数值落在合理量程、且不等于当前值、且行内没有历史
@@ -834,10 +966,29 @@ export function vocabularyMirrorProblems(root = REPO_ROOT) {
834
966
  return problems;
835
967
  }
836
968
 
969
+ // 「自动补写」表述判据(新口径):技能文本不得承诺自动补写(record 自动补写已整体删除,
970
+ // 唯一路径是执行者手动 skill-load)。判据是声明级、不做语义判断:任何一行出现「自动补」
971
+ // 却没有任何否定词(不 / 未 / 禁 / 无)→ 视为承诺自动补写;明确否定(「不再自动补写」
972
+ // 「不覆盖 handoff scope」)与说明其不存在的写法放行。判别力由场景 167 的反向构造常驻证明
973
+ // (追加一行无条件承诺必被判违规)。
974
+ // 否定判定**限定在「自动补」所在的小句内**:整行任意位置出现「无 / 不」就放行,会被
975
+ // 「无需手动声明,record 会自动补写…」这类混合句绕过(否定词落在另一个小句)。句读(。;,)
976
+ // 是边界,跨过边界的否定不算否定这条承诺。
977
+ const AUTO_FILL_NEGATED = /(?:不|未|禁|无|别)[^。;;,,\n]{0,12}自动补|自动补[^。;;,,\n]{0,12}(?:已删|删除|不再|不写|不存在)/;
978
+ export function autoFillPromiseProblems(rel, text) {
979
+ const out = [];
980
+ for (const line of text.split('\n')) {
981
+ if (!line.includes('自动补')) continue;
982
+ if (AUTO_FILL_NEGATED.test(line)) continue;
983
+ out.push(rel + ' 含自动补写承诺表述: ' + line.trim().slice(0, 80));
984
+ }
985
+ return out;
986
+ }
987
+
837
988
  export function twoLayerEntryProblems(rel, text) {
838
989
  const out = [];
839
990
  if (text.includes('见上方 Required Calls 表')) out.push(rel + ' 含 Implementation/Required 混淆句式');
840
- if (text.includes('record 会自动补写缺失的声明标记')) out.push(rel + ' 含无限定自动补表述');
991
+ out.push(...autoFillPromiseProblems(rel, text));
841
992
  if (!text.includes('Skill 工具加载该节点的 Implementation 技能')) out.push(rel + ' 缺入口层锚点句');
842
993
  if (!text.includes('前置门')) out.push(rel + ' 缺前置门表述');
843
994
  return out;
@@ -864,10 +1015,13 @@ export function skillLoadingWordingProblems(rel, text) {
864
1015
  // ⑤ 条件句指针:两册各自须指向 commit-discipline / platform-facts / fix-loop 三个权威文件。
865
1016
  export const COMMIT_DISCIPLINE_REL = 'flow-comet/reference/commit-discipline.md';
866
1017
  export const PLATFORM_FACTS_REL = 'flow-comet/reference/platform-facts.md';
1018
+ // 提交形态的字面(消息在 `--` 之前):两册的要素 token 与入口册的存在性判据**取同一字面**——
1019
+ // 三处各写一份就会各自漂移(改一处漏一处正是这行此前没有锁的成因)。
1020
+ export const COMMIT_FORM_TOKEN = '`git commit -m "<消息>" -- <同一路径>`';
867
1021
  export const COMMIT_DISCIPLINE_ELEMENT_GROUPS = [
868
1022
  ['提交面 pathspec 纪律 · 适用条件', ['**各自独立工作区(worktree 等)内的局部 `reset` / `clean` 不在禁令内**']],
869
1023
  ['提交面 pathspec 纪律 · 要素 1(字面路径集)',
870
- ['`git add -- <自己字面路径>`', '`git commit -- <同一路径>`', 'write_files']],
1024
+ ['`git add -- <自己字面路径>`', COMMIT_FORM_TOKEN, 'write_files']],
871
1025
  ['提交面 pathspec 纪律 · 要素 2(锁失败重试)', ['锁失败重试', 'index.lock', '失败即重试']],
872
1026
  ['提交面 pathspec 纪律 · 要素 3(禁裸命令)',
873
1027
  ['禁裸', '`commit -a`', '`stash`', '`clean`', '`reset`']],
@@ -880,7 +1034,7 @@ export const COMMIT_DISCIPLINE_ELEMENT_GROUPS = [
880
1034
  ];
881
1035
  // 权威处**正文**(逐字搬运进 `commit-discipline.md` 的原句;实测两册均无这些整句——回流即红)。
882
1036
  export const COMMIT_DISCIPLINE_AUTHORITY_PHRASES = [
883
- '2. **`git commit -- <同一路径>`**:提交以 pathspec 限定范围,保证提交只含自己的文件;路径集与上一步**逐字一致**。',
1037
+ '2. **`git commit -m "<消息>" -- <同一路径>`**:消息(含正文尾注 `-m "Task: <id>"`)写在 `--` **之前**,pathspec 写在 `--` 之后——提交以 pathspec 限定范围,保证提交只含自己的文件;路径集与上一步**逐字一致**。消息若落到 `--` 之后(`git commit -- <路径> -m "<消息>"`),`-m` 会被当成 pathspec、提交直接失败(退出码 1)。',
884
1038
  '3. **锁失败重试**:并发提交会撞 `index.lock` / `cannot lock ref`——**失败即重试**(临时仓真并发实测:20 提交 / 25 次锁失败全部重试成功);不得因锁失败改用宽泛命令。',
885
1039
  '5. **为什么**:并发写者共享**同一个索引与工作树**——宽泛命令存在**并发索引竞态**:一方 `add -A` 会把另一方的半成品纳入自己的提交(串味 / 多文件提交);`stash` / `clean` / `reset` 更会直接破坏同伴的未提交工作。',
886
1040
  '**并行波次附加两条(与上列五要素并列适用 · 不改其语义与适用条件)**:',
@@ -889,14 +1043,14 @@ export const COMMIT_DISCIPLINE_AUTHORITY_PHRASES = [
889
1043
  '2. **顺序(确定性规则)**:先按 `depends_on` 的**拓扑序**集成(被依赖者先入);同一拓扑层内按 **task id 升序**(计划期固定的稳定键,与完成先后无关)。**不得依赖书写顺序** / 提交到达顺序 / 完成先后等运行期不确定量。',
890
1044
  '3. **审计留痕**:每次集成输出一行审计行 `INTEGRATE: <task-id> <commitHash> → <集成提交>`;降级路径为 `INTEGRATE: <task-id> <commitHash> via cherry-pick -- 降级原因:<原因>`。映射(task-id → commitHash → 集成提交)记入该趟流程记录(`<task-id>-SUMMARY.md` / handoff evidence 文本字段)。**判级**:审计行是**执行纪律**(review 把关),本节点不声称存在机械门禁校验它。',
891
1045
  ' - **机械冲突**(不改用户可见行为:同一文件不同区域 / 相邻行 / 纯格式):执行者**可自行解决**——解决后必须跑**合并后验证**(该任务 `verify` + 受影响任务的判据),并在审计行记录冲突与解决方式。',
892
- ' - **语义冲突**(两侧对同一行为 / 契约 / 接口给出不同语义:同一函数语义分叉、同一 AC 的两种实现、公共 API 形状不一致):**必须中止集成并上抛**(记 BLOCKED + 恢复指引),**不得**由执行者自行拍板;由协调者 / 用户裁决(补 `depends_on`、拆任务或开新 change)。',
1046
+ ' - **语义冲突**(两侧对同一行为 / 契约 / 接口给出不同语义:同一函数语义分叉、同一 AC 的两种实现、公共 API 形状不一致):**必须中止集成并上抛**(记 BLOCKED + 恢复指引),**不得**由执行者自行拍板;由协调者 / 用户裁决(补 `depends_on`、拆任务或另开 change)。',
893
1047
  ];
894
1048
  // 四属性契约(能力契约锚 · ADR-016 明示「该怎么干」类 ⇒ 留两册正文;两册不再要求逐字相同)。
895
1049
  export const PARALLEL_CONTRACT_BOOK_PHRASES = [
896
1050
  '> **并行安全四属性契约**:契约对象是**四属性**,不是 worktree',
897
1051
  '| ① | **写权限** | 每个写者必须有一条被守卫认可的写入通道 |',
898
1052
  '| ③ | **验证隔离** | 同一时刻只有一个写者:全量判据不得与在飞写者并行 |',
899
- '出口校验锚 = `handoffRequests` 有 request 无对应 `handoffResult` ⇒ 新 change BLOCKED / 旧 change WARN;全部有 result ⇒ 放行;无证据 ⇒ 零输出',
1053
+ '出口校验锚 = `handoffRequests` 有 request 无对应 `handoffResult` ⇒ 一律 BLOCKED(同一形态一个判级);全部有 result ⇒ 放行;无证据 ⇒ 零输出',
900
1054
  '**已撤回的 request 不构成在飞委托**',
901
1055
  '`workflow-handoff.mjs withdraw <task-id> --by <来源>` 在原记录上留痕 `withdrawnAt` + `withdrawnBy`,已撤回 = 终态、历史不删',
902
1056
  '**并同时注入桥接通道标记 `FLOW_COMET_AGENT_DEPTH_SOURCE`——守卫要求标记与深度同时在场才接受该通道**',
@@ -976,6 +1130,26 @@ export function delegationDisciplineProblems({ books, elementDocs, authorityText
976
1130
  return problems;
977
1131
  }
978
1132
 
1133
+ // 入口册的提交形态(场景 184d 使用;纯函数 + 合成文本可驱动):入口册「② 提交隔离」那一行是
1134
+ // 执行者最早读到的提交命令形态——两册与权威处都有要素 token 锁,**唯独这一行没有**:把它退回
1135
+ // 「`git commit -- <路径>`」(不给消息选项)时套件不会红(该形态照抄下行即 `-m` 被当成 pathspec、
1136
+ // exit 1)。判据两条:① 存在性——要点句在场且取与两册**同一字面**(含 `-m`);② 反否定——不得
1137
+ // 出现缺 `-m` 的旧形态字面。反否定的正则只认**相邻**形态(`git commit -- <`):把「`git commit`
1138
+ // 与 `--` 分开匹配会连「`-m` 在前、`--` 在后」的正确写法一并判红,那是恒红而非锁。
1139
+ export const ENTRY_COMMIT_FORM_REL = 'flow-comet/SKILL.md';
1140
+ export const ENTRY_COMMIT_FORM_OLD_RE = /git commit\s+--\s*</;
1141
+ export function entryCommitFormProblems(rel, text) {
1142
+ const problems = [];
1143
+ if (!text.includes(COMMIT_FORM_TOKEN)) {
1144
+ problems.push(rel + ' 缺带消息的提交形态要点句: ' + COMMIT_FORM_TOKEN);
1145
+ }
1146
+ const old = ENTRY_COMMIT_FORM_OLD_RE.exec(text);
1147
+ if (old) {
1148
+ problems.push(rel + ' 出现缺 `-m` 的旧提交形态「' + old[0].trim() + '」——消息必须写在 `--` 之前');
1149
+ }
1150
+ return problems;
1151
+ }
1152
+
979
1153
  // 前端判据散文口径(场景 286 使用;纯函数 + 合成文本面可驱动):ADR-016 把原「五份文本**各自**
980
1154
  // 陈述五个结构 token」重定向为「**一处权威**(`flow-comet-ui-design` 册的「触发与跳过」段陈述
981
1155
  // 结构形态三种 + 词形边界 + 命中片段回显)+ **各引用册指针在场**(条件句指向该册,缺即红)+
@@ -1257,7 +1431,7 @@ export function identityUpgradeProblems({ entry, facts, others }) {
1257
1431
 
1258
1432
  // 平台事实(场景 184 的 ⑤ / ⑦ 使用;纯函数 + 合成输入可驱动):Codex 平台事实与支持面的判别句
1259
1433
  // 随 `worktree-notes.md` 移出技能树后**唯一权威处** = `flow-comet/reference/platform-facts.md`
1260
- //(T07 已按「逐字搬运,不重写」搬入)。判据三侧:① 权威处在场(判别句 + 旧独断句只允许被反驳
1434
+ //(已按「逐字搬运,不重写」搬入)。判据三侧:① 权威处在场(判别句 + 旧独断句只允许被反驳
1261
1435
  // 引用形态 + 适用范围限定 + fail-open / 未闭合的现判据);② 各引用册**指针在场**;③ **证据正文
1262
1436
  // 不回流册子**(权威处唯一——原逐字锁「多处各持一份」的方向已反转)。
1263
1437
  // `PLATFORM_FACTS_ONLY_PHRASES` 是**证据与过程记录**类判别句(按 ADR-016 的「证据与判级随平台事实
@@ -2272,7 +2446,7 @@ export function writeUiDesignBindingVariant(dir, variant) {
2272
2446
  }
2273
2447
 
2274
2448
  export function writeDesignExitFixture(dir, {
2275
- newChange, visualTone, uiDesign, declareUiDesign, changeName = CHANGE_ID, changeTail = '', declareDesign = true,
2449
+ visualTone, uiDesign, declareUiDesign, changeName = CHANGE_ID, changeTail = '', declareDesign = true,
2276
2450
  }) {
2277
2451
  writeFile(dir, 'flow-kit/templates/DESIGN.md', '# DESIGN 模板\n\n## 0. 技术栈选型\n## 1. 技术决策清单\n');
2278
2452
  // CHANGE 模板同样在场:design 出口的前端判据用 `pick('change', ['视觉调性'])` 在**模板派生**的段名表里
@@ -2280,7 +2454,6 @@ export function writeDesignExitFixture(dir, {
2280
2454
  // (模板缺席下的跳过另由 TA-21 覆盖)。
2281
2455
  writeFile(dir, 'flow-kit/templates/CHANGE.md', '# CHANGE 模板\n\n## Why(为什么做)\n\n## 视觉调性(前端项目必填)\n');
2282
2456
  const state = baseState('design');
2283
- state.newChange = newChange === true;
2284
2457
  state.enteredNodes = ['design'];
2285
2458
  const checks = [];
2286
2459
  if (declareDesign) checks.push('required-skill:design.flow-comet-design');
@@ -0,0 +1,340 @@
1
+ // wave-projection.mjs — 波次段解析与「波次 = 依赖层级的投影」判定(纯判定:无 console、无
2
+ // process.exit、无写盘)。
3
+ //
4
+ // 语义:`## 波次划分` 段给每个任务声明它排在第几波;波次不是自由排版,而是依赖层级的投影——
5
+ // level(task) = 1 + max(level(dep))(无依赖 = 第 1 波,见 task-graph.mjs 的 taskWaveLevels)。
6
+ // 声明波次 ≠ 层级即不一致:同波依赖(依赖方与被依赖方写在同一波)、排在依赖之前、以及明明只需
7
+ // 更早波次却排到更后面的保守排法,都会在明细里被逐条点名为「当前波 → 应到波」。
8
+ // 分级不在这里判:本模块产出「判不了」的分类与载荷、明细与报文行;BLOCK / WARN 由调用方给出
9
+ // blocking(单轨下内容不可判一律 blocking)。**分级 → 输出只有一处**(waveReviewOutcome):plan
10
+ // 出口门禁与 replan 重校段共用同一份。调用方不得自写「不可判 → 选级别 → 打印 → exit」的同构分支
11
+ // ——同一分级有两份实现时,改一处只会在另一处静默落后(ADR-013 的前提正是「两处同判」:replan 不豁免)。
12
+ //
13
+ // 判定面覆盖两侧:① 已声明任务的波次必须等于依赖层级;② 任务集里存在、Wave 行一次都没提到的
14
+ // 任务同样不一致(明细取值 = 「未声明」)——只沿「已声明」一侧求差集,未写进 Wave 行的任务会整个
15
+ // 逃过判定(实测:段内只写 `Wave 1: T01` 而任务另有 T02/T03 时,出口 exit 0 且零输出)。修复族
16
+ // 任务不在声明的义务面内(回修有独立生命周期),族判定一律经 task-graph 的唯一谓词
17
+ // `fixTaskClassifier`——判据侧不自写前缀匹配。
18
+ //
19
+ // 解析面刻意宽(真实工件的写法差异一律容忍;误报比漏报更伤):Wave 行带 `(parallel)` /
20
+ // `(serial)` 标注、括号依赖注解 `(depends on …)` / `(T07 on T05; …)`、行尾 `#` 注释、
21
+ // 半角 / 全角冒号与逗号分号顿号、列表记号均可。只取「Wave N … 任务 id 列表」,注解里的 id 不算
22
+ // 本波成员;不是 TASK.md 任务 id 的一律不计入判定。
23
+ //
24
+ // 「判不了」按成因二分,形态与 ac-coverage.mjs **完全一致**(本仓结构判据只此一种形态):
25
+ // { unverified: { reason, notice } | null, unjudgeable: { reason, explanation, recovery } | null, ... }
26
+ // · 载体缺席(无 `## 波次划分` 段 / 段名无从派生)→ unverified 非空:调用方打印 notice
27
+ // (「未校验」)并放行——判据没有可判对象,不改退出码;
28
+ // · 工件内容不可判(段在场,但一行 Wave 行都解析不出可对应任务:正文只写 N/A、点的是不存在的
29
+ // 任务 id、行首强调记号让 Wave 行不成立)→ unjudgeable 非空:一律 BLOCKED(单轨判级——「该写的
30
+ // 没写」不再静默;恢复出路在载荷里)。
31
+ // 收敛到这一形态(而不是 { judgeable, reason })的理由:① 载荷跟着分类走——notice /
32
+ // explanation + recovery 直接可用于打印,调用方不必再按 reason 反查第二张表(同一组取值只许有一张
33
+ // 表:按 key 反查的第二张表与判定表必然分叉);② 「能否判定」由字段出现与否表达,reason 只留人读
34
+ // 成因,不再逼调用方从字符串取值反推分级;③ 新增的结构判据照抄这一组字段即可,不必再选一次。
35
+ // 形态不随落点变化:谁带着载荷,谁就是形态(换一个出口消费它,判定结论与字段不变)。
36
+ import {
37
+ analyzeDependencyGraph,
38
+ collectCrossTaskConflicts,
39
+ fixTaskClassifier,
40
+ taskWaveLevels,
41
+ } from './task-graph.mjs';
42
+ import { taskOpeningAttrs } from '../task-parsing.mjs';
43
+ // 段界单源(围栏 / 同级标题 / 分隔线 / 文末的判定只在这里一份)
44
+ import { sectionBody } from './section-body.mjs';
45
+ // 「这个任务有没有写面」的单一实现(元素提取 + 条目边界都在 lib/lessons-hits.mjs):本模块不自己
46
+ // 拿正则去块里找 <write_files>。同一件事写第二份表达式时,元素名大小写少一个 /i 就够——7 字段门
47
+ // 判字段在场、本模块判未知,任务因此从 [P] 判据的参与者里静默消失。
48
+ import { taskHasWriteFace } from './lessons-hits.mjs';
49
+ // 段名登记值与段标题谓词都取单源:骨架模块是「模板缺席时的段名基准」唯一登记处,也是「这一行是不是
50
+ // 登记的某段」的唯一判定(headingPredicate:级别 + 段名归一后相等),消费方只 import。
51
+ import { WAVE_SECTION_NAME, headingPredicate } from './guard-artifact-skeleton.mjs';
52
+
53
+ // 段界与 plan 出口既有的「波次散文一致性([P] vs parallel)」检测**同一实现**,而段界本身由
54
+ // lib/section-body.mjs 单点决定:围栏代码块里的 `## ` / `---` 是正文示例,不结束段体(段内贴一段
55
+ // Markdown 示例不会把其后声明的 Wave 行整段吞掉)。
56
+ // 段标题判定与 TASK 段形门、AC 覆盖**同一个谓词**(级别 + 归一后的标题正文相等):标题**正文本身**
57
+ // 以井号开头(`## ## 波次划分`)时,行正则会判缺席、段形门却认作在场——同一份工件的同一段在两处得到
58
+ // 相反答案时,一次排版就够关掉其中一处判据(未校验 ≠ 通过)。比较规则不在本模块另写一份。
59
+ const isWaveSectionHeading = headingPredicate(WAVE_SECTION_NAME, 2);
60
+
61
+ // 波次段正文(段标题之后、下一个二级标题 / 分隔线 / 文末之前的文本);无该段 → null。
62
+ export function waveSectionBody(taskContent) {
63
+ return sectionBody(taskContent, isWaveSectionHeading, { level: 2, endOnSeparator: true });
64
+ }
65
+
66
+ // Wave 行:`Wave N (parallel): T01[P], T02 (depends on T01) # 说明`。只认「Wave + 数字」开口
67
+ // (允许缩进与列表记号);行内其余注解由 parseWaveLine 剥离。
68
+ const WAVE_LINE_RE = /^\s*(?:[-*+]\s+)?Wave\s+(\d+)\b/iu;
69
+ // 行尾注释:`#` 之后的不是本波成员(括号内 `(见 #12)` 一类由后续括号剥离兜住)。
70
+ const WAVE_TRAILING_COMMENT_RE = /#[^\n]*/gu;
71
+ // 括号注解(半角 / 全角):`(parallel)` / `(serial)` / `(depends on T01, T02)` / `(T07 on T05; …)`。
72
+ // 注解里的任务 id 是「为什么排在这里」的说明,不是本波成员——先剥注解再取 id,否则依赖注解会把
73
+ // 被依赖方错算进本波(模板自身就写 `Wave 2 (parallel): T03[P], T04[P] (depends on T01)`)。
74
+ const WAVE_ANNOTATION_RE = /[((][^()()]*[))]/gu;
75
+ const WAVE_COLON_RE = /[::]/u;
76
+ // 任务 id 分隔符:半角逗号 / 分号 / 空白 + 中文顿号 / 全角逗号 / 全角分号。漏收全角逗号会让中文
77
+ // 写法的 `Wave 1:T01,T02` 只切出 `T01,T02` 这个假 id ⇒ 无可对应任务 ⇒ 整段降级成「未校验」
78
+ // 放行(半角写法同一计划却 BLOCK)——同一计划的两种标点写法必须得到同一判定。
79
+ const WAVE_TOKEN_SEPARATOR_RE = /[,\s;、,;]+/u;
80
+ // id token 上的标记(`[P]` 并行标记、Markdown 强调符)不是 id 的一部分:先整段剥掉方括号标
81
+ // 记(`T01[P]` → `T01`,只削括号会留下 `P` 拼成假 id),再剥残余的孤立记号。
82
+ const WAVE_TOKEN_BRACKETS_RE = /\[[^\]]*\]/gu;
83
+ const WAVE_TOKEN_MARKERS_RE = /[[\]`*]/gu;
84
+
85
+ // 单行 → { wave, tokens }(tokens 只做过标记剥离与切分,是否真是任务 id 由判定侧用任务集过滤);
86
+ // 不是 Wave 行 → null。
87
+ function parseWaveLine(line) {
88
+ const head = String(line).match(WAVE_LINE_RE);
89
+ if (head === null) return null;
90
+ let rest = String(line).slice(head[0].length)
91
+ .replace(WAVE_TRAILING_COMMENT_RE, '')
92
+ .replace(WAVE_ANNOTATION_RE, ' ')
93
+ .replace(WAVE_ANNOTATION_RE, ' '); // 括号嵌套(少见)再剥一层,不引入递归
94
+ const colon = rest.search(WAVE_COLON_RE);
95
+ if (colon >= 0) rest = rest.slice(colon + 1);
96
+ const tokens = rest
97
+ .split(WAVE_TOKEN_SEPARATOR_RE)
98
+ .map((token) => token.replace(WAVE_TOKEN_BRACKETS_RE, '').replace(WAVE_TOKEN_MARKERS_RE, '').trim())
99
+ .filter(Boolean);
100
+ return { wave: Number(head[1]), tokens };
101
+ }
102
+
103
+ // 波次段 → Map<任务 id, 声明波次>;无该段 → null(不可判)。同一 id 重复声明:首见为准
104
+ // (声明面本应唯一,重复时取确定性的那一个,不按书写顺序反复覆盖)。
105
+ function parseDeclaredWaves(taskContent) {
106
+ const body = waveSectionBody(taskContent);
107
+ if (body === null) return null;
108
+ const declared = new Map();
109
+ for (const line of body.split(/\r?\n/u)) {
110
+ const parsed = parseWaveLine(line);
111
+ if (parsed === null) continue;
112
+ for (const id of parsed.tokens) {
113
+ if (id === '' || declared.has(id)) continue;
114
+ declared.set(id, parsed.wave);
115
+ }
116
+ }
117
+ return declared;
118
+ }
119
+
120
+ // 「未声明」取值:Wave 行一次都没提到的真实任务(修复族例外)。明细形态与既有一致明细同形,
121
+ // 只有 declared 取值不同——渲染 / 分级 / 恢复指引因此仍走同一处构造,不会分叉。
122
+ const WAVE_UNDECLARED = '未声明';
123
+
124
+ // 「载体缺席」的 notice(由判定结果携带,调用方只打印):删段不是通过——判据跳过时执行者必须看见
125
+ // 「未校验」,而 plan 册要求该段在场(模板 H2 必填)。段在场却解析不出可对应任务**不属本支**(那是
126
+ // 「该写的没写」,见 WAVE_CONTENT_UNJUDGEABLE)。
127
+ const WAVE_UNCHECKED_NOTICE = '未校验(无波次段)——TASK.md 缺 ## 波次划分 段(或段名无从派生),波次 = 依赖层级 的投影判据跳过(未验证 ≠ 通过)';
128
+
129
+ // 「工件内容不可判」的成因载荷(与 ac-coverage 的 UNJUDGEABLE_CAUSES 同形:解释 + 恢复出路各占一半
130
+ // ——只有解释没有出路,人只能猜下一步)。reason 是机器可读短句,explanation / recovery 是人读文本,
131
+ // 判定结果自带这三样,调用方不再按 reason 反查第二张表。
132
+ const WAVE_CONTENT_UNJUDGEABLE = Object.freeze({
133
+ reason: 'no-resolvable-wave-line',
134
+ explanation: '## 波次划分 段在场,但段内没有一行 Wave 行能解析出可对应的任务 id'
135
+ + '(正文只写 N/A / Wave 行点的是不存在的任务 id / 行首强调记号让 Wave 行不成立)',
136
+ recovery: '按模板把每一波写成可解析的 Wave 行(如 `Wave 1: T01, T02`,中文标点可用),'
137
+ + '任务 id 必须逐字对应 TASK.md 里的任务;段正文写 N/A 不构成波次声明',
138
+ });
139
+
140
+ // 判定:返回 { unverified, unjudgeable, mismatches, waves }——「判不了」形态见文件头。
141
+ // · mismatches 逐条 { id, deps, declared, expected };
142
+ // · waves = Map<真实任务 id, 声明波次>(可判时非空;[P] 判据复用这份解析结果分组)。
143
+ // 可判条件 = 段在场且至少一条声明能落到 TASK.md 的真实任务上;到不落就说明正文不是可解析的波次
144
+ // 声明(N/A、点了不存在的 id、行首强调记号),此时不再猜「全部一致」。
145
+ // 已声明一侧要求能求出层级(环上任务无层级,其合法性由依赖图判据负责);未声明一侧同样要求层级
146
+ // (没有「应到波」就无法给出可照抄的明细)。明细按任务 id 升序(与书写顺序无关——报告稳定可对照)。
147
+ export function waveProjectionReview({ taskContent, blocks = [] } = {}) {
148
+ const declared = parseDeclaredWaves(taskContent);
149
+ if (declared === null) {
150
+ return { unverified: { reason: 'section-missing', notice: WAVE_UNCHECKED_NOTICE }, unjudgeable: null, mismatches: [], waves: null };
151
+ }
152
+ const graph = analyzeDependencyGraph(blocks);
153
+ const levels = taskWaveLevels(blocks);
154
+ const declaredTaskIds = [...declared.keys()].filter((id) => graph.ids.has(id));
155
+ if (declaredTaskIds.length === 0) {
156
+ return { unverified: null, unjudgeable: WAVE_CONTENT_UNJUDGEABLE, mismatches: [], waves: null };
157
+ }
158
+ // 修复族 = 「不要求排进波次」的那一族:族判定经 task-graph 的唯一谓词(前缀形态与「位于修复段内」
159
+ // 两条边界只在那里表达),本模块只取用结果,不自写前缀匹配。
160
+ const isFixTask = fixTaskClassifier(taskContent);
161
+ const fixIds = new Set(blocks
162
+ .filter((block) => isFixTask(block))
163
+ .map((block) => (taskOpeningAttrs(block) ?? {}).id)
164
+ .filter((id) => typeof id === 'string' && id !== ''));
165
+ const mismatches = [];
166
+ for (const id of declaredTaskIds) {
167
+ if (!levels.has(id)) continue; // 环上任务无层级:合法性由依赖图判据负责
168
+ const declaredWave = declared.get(id);
169
+ const level = levels.get(id);
170
+ if (declaredWave === level) continue;
171
+ mismatches.push({ id, deps: graph.depsById.get(id) ?? [], declared: declaredWave, expected: level });
172
+ }
173
+ // 未声明一侧:任务集减去 Wave 声明集(修复族排除在外)——写漏的任务同样是不一致,逐条点名。
174
+ for (const id of graph.ids) {
175
+ if (declared.has(id) || fixIds.has(id) || !levels.has(id)) continue;
176
+ mismatches.push({ id, deps: graph.depsById.get(id) ?? [], declared: WAVE_UNDECLARED, expected: levels.get(id) });
177
+ }
178
+ mismatches.sort((left, right) => (left.id < right.id ? -1 : left.id > right.id ? 1 : 0));
179
+ // 波次分组(真实任务 id → 声明波次)随判定结果一并返回:[P] 判据(parallelGapReview)用它分组,
180
+ // 不重解析同一段波次散文——同一段两次解析必然分叉。
181
+ const waves = new Map(declaredTaskIds.map((id) => [id, declared.get(id)]));
182
+ return { unverified: null, unjudgeable: null, mismatches, waves };
183
+ }
184
+
185
+ // 「工件内容不可判」的报文构造(plan 出口与 replan 重校共用同一份,只换分级前缀):首行点名哪一环
186
+ // 读不出来并给出分级,第二行给能照做的恢复出路——与 ac-coverage 的 acCoverageUnjudgeableLines 同形
187
+ // (同一件事两处措辞必然先漂移)。判不了即由调用方拒绝通过(不再有渐进档);载荷来自判定结果,
188
+ // 本函数只做渲染。
189
+ function waveContentUnjudgeableLines(unjudgeable, level) {
190
+ const blocking = level === 'BLOCKED';
191
+ return [
192
+ (blocking ? 'BLOCKED: ' : 'WARN: ')
193
+ + 'TASK.md 波次划分段内容不可判——' + unjudgeable.explanation
194
+ + (blocking ? '' : '(旧 change 渐进不阻断)')
195
+ + ':波次 = 依赖层级 的投影判据无法执行(未验证 ≠ 通过)',
196
+ '恢复: ' + unjudgeable.recovery,
197
+ ];
198
+ }
199
+
200
+ // 报文构造(只由 waveReviewOutcome 调用,调用方不直接取用):BLOCKED / WARN 同一文本,只换分级前缀。
201
+ // 明细逐条点名「任务 / 依赖 / 当前波 / 应到波」(未声明的任务当前波记为「未声明」);恢复指引按明细
202
+ // 分流——已声明但波次不对:移到应到波,或把「为什么排在后面」的依赖写成显式 depends_on(作者有意
203
+ // 延后的合法排法靠后者表达);未声明:把它写进应到波的 Wave 行(没有「当前波」可挪,不套用前者)。
204
+ function waveProjectionReportLines(mismatches, level = 'BLOCKED') {
205
+ const blocking = level === 'BLOCKED';
206
+ const lines = [(blocking ? 'BLOCKED: ' : 'WARN: ')
207
+ + 'TASK.md 波次划分与依赖层级不一致——波次 = 依赖层级的投影(无依赖 = 第 1 波,其余 = 1 + 依赖中最晚波次;同波任务必须彼此无依赖;'
208
+ + '任务集里存在但 Wave 行一次都没提到的任务记为「未声明」)'
209
+ + (blocking ? '' : '(旧 change 渐进不阻断)')
210
+ + ':'];
211
+ for (const item of mismatches) {
212
+ lines.push(' - ' + item.id + '(依赖: ' + (item.deps.length > 0 ? item.deps.join(', ') : '无')
213
+ + ')当前波 ' + item.declared + ' → 应到波 ' + item.expected);
214
+ }
215
+ lines.push('恢复: 按明细逐项修正——'
216
+ + mismatches.map((item) => (item.declared === WAVE_UNDECLARED
217
+ ? '把 ' + item.id + ' 写进第 ' + item.expected + ' 波的 Wave 行'
218
+ : '把 ' + item.id + ' 移到第 ' + item.expected
219
+ + ' 波,或给它补 depends_on: <依赖> 把顺序声明出来(要保留当前波次,就把「它为何排在后面」的依赖写成显式 depends_on)')).join(';')
220
+ + ';改完重试');
221
+ return lines;
222
+ }
223
+
224
+ // 分级 → 输出的**唯一出口**(plan 出口与 replan 重校各自只派生 blocking):返回 { lines, block }。
225
+ // · 载体缺席 → 打印 notice、不阻断(block=false;「未校验 ≠ 通过」由文本表达,不改退出码);
226
+ // · 内容不可判 → BLOCKED / WARN 两行(成因 + 恢复出路),block = blocking;
227
+ // · 判过且不一致 → 明细 + 恢复指引,block = blocking;
228
+ // · 判过且一致 → 零行、不阻断(不制造噪音)。
229
+ // 调用方一律「逐行 console.error → 按 block 拒绝」,不再自己选级别、也不再自己构造报文。
230
+ export function waveReviewOutcome(review, { blocking = false } = {}) {
231
+ const blocked = blocking === true;
232
+ const level = blocked ? 'BLOCKED' : 'WARN';
233
+ if (review.unverified !== null) return { lines: [review.unverified.notice], block: false };
234
+ if (review.unjudgeable !== null) {
235
+ return { lines: waveContentUnjudgeableLines(review.unjudgeable, level), block: blocked };
236
+ }
237
+ if (review.mismatches.length === 0) return { lines: [], block: false };
238
+ return { lines: waveProjectionReportLines(review.mismatches, level), block: blocked };
239
+ }
240
+
241
+ // ---------- 同波可并行却漏标 [P](plan 出口的第二条波次面判据) ----------
242
+ // 判据:同一波次内、彼此无依赖路径、且 write_files 不重叠的两个任务——**其中任一**没标
243
+ // parallel="true" 即「可并行却未标 [P]」。只标一个不成立:单边标记既不表达「可并行」,机器路由
244
+ // 又按串行跑(该并行度白丢)。作者的两条出路:两个都标 [P](真并行),或补一条 depends_on 把它们
245
+ // 排到不同波次(顺序显式)。修复族不参与(回修有独立生命周期)。
246
+ //
247
+ // 三条输入面的复用(本判据不另写第二份):
248
+ // · 波次分组 / 层级:分组取 waveProjectionReview 的 waves(同一次解析,见该函数),层级取
249
+ // task-graph 的 taskWaveLevels。**同层 ⇒ 彼此无依赖路径**(依赖边严格抬高层级:
250
+ // level(依赖方) ≥ level(被依赖方) + 1),故「同波 ∧ 同层」即「同一波次内且彼此无依赖路径」——
251
+ // 波次投影一致时两者本就等价,投影不一致时取交集使判据保守。
252
+ // · 写面重叠:**唯一入口是 task-graph 的 collectCrossTaskConflicts**。任务书写的是
253
+ // collectPathOverlaps(重叠判定的底层唯一实现),落地走它的上层入口——后者才带着「已归一路径」
254
+ // 的解析、glob 语义与参与者规则(未完成、非修复族),且这些都收在 task-graph 一处;为直接调底层
255
+ // 函数而导出 parsePaths / normalizeTaskPath,等于把私有契约放大成公共面。**等价关系**:该入口返回
256
+ // 「同波无关 ∧ 写面重叠」(参与者已按未完成 / 非修复族过滤),本判据要的是它的**补集**——同层任务
257
+ // 之间无依赖路径(层级不变量),故「不在其返回集合」⟺「写面不重叠」,不重叠才有资格叫「可并行」。
258
+ // 本判据不自己比较路径:第二份重叠判定(含路径归一与 glob)必然与第一份分叉。
259
+ // 补集判定同样不自己算键:task-graph 返回的 isOverlappingPair 就是「键集合上的成员判定」,任务对键
260
+ // 的形态(无序、NUL 分隔)只在那里表达一次。此处自建第二份键(换个分隔符或换个定序)时两端键不再
261
+ // 相等,补集会静默失效——写面重叠的一对被当成「本可并行」,而本判据照常报出来。
262
+ // · 修复族:族判定经 task-graph 的唯一谓词 fixTaskClassifier,判据侧不自写前缀匹配。
263
+ // 已 done 的任务不参与(规划面上的 [P] 只约束未开始的任务)。
264
+ // 写面未知的任务同样不参与:没有 <write_files>(或清单为空 / 只有注释)意味着「不能断言写面不重叠」,
265
+ // 而不是「写面不重叠」——把它当成后者,补集会把一对写面未知的任务报成「可并行却未标 [P]」,恢复句
266
+ // 还会让作者补 depends_on(真正缺的是字段)。参与者判据因此与 task-graph 的第三族同口径(该族只把
267
+ // 有写面的任务放进重叠比较),而「这份写面算不算有内容」取 lib/lessons-hits.mjs 的唯一判定
268
+ // (taskHasWriteFace)——本模块不再自持第二份元素提取(元素名大小写与注释剥离都在那里表达一次)。
269
+
270
+ // 判定:返回 { gaps },逐条 { a, b, wave, unmarked }(unmarked = 该对里没标 parallel 的任务 id)。
271
+ // 无波次段 / 内容不可判(waves 为 null)→ 空(波次侧已有判别不了,本判据没有分组可用)。
272
+ export function parallelGapReview({ taskContent = '', blocks = [], waves = null } = {}) {
273
+ if (!(waves instanceof Map) || waves.size === 0) return { gaps: [] };
274
+ const levels = taskWaveLevels(blocks);
275
+ const isFixTask = fixTaskClassifier(taskContent);
276
+ const candidates = [];
277
+ for (const block of blocks) {
278
+ const attrs = taskOpeningAttrs(block);
279
+ if (!attrs || typeof attrs.id !== 'string' || attrs.id === '') continue;
280
+ if (attrs.status === 'done' || isFixTask(block)) continue;
281
+ if (!taskHasWriteFace(block)) continue;
282
+ const wave = waves.get(attrs.id);
283
+ const level = levels.get(attrs.id);
284
+ if (wave === undefined || level === undefined) continue;
285
+ candidates.push({ id: attrs.id, wave, level, parallel: attrs.parallel === true });
286
+ }
287
+ if (candidates.length < 2) return { gaps: [] };
288
+ const { depsById } = analyzeDependencyGraph(blocks);
289
+ const { isOverlappingPair } = collectCrossTaskConflicts({
290
+ taskContent, allBlocks: blocks, depsById,
291
+ });
292
+ const gaps = [];
293
+ for (let i = 0; i < candidates.length; i += 1) {
294
+ for (let j = i + 1; j < candidates.length; j += 1) {
295
+ const left = candidates[i];
296
+ const right = candidates[j];
297
+ if (left.wave !== right.wave || left.level !== right.level) continue;
298
+ if (left.parallel && right.parallel) continue;
299
+ if (isOverlappingPair(left.id, right.id)) continue;
300
+ gaps.push({
301
+ a: left.id,
302
+ b: right.id,
303
+ wave: left.wave,
304
+ unmarked: [left, right].filter((task) => !task.parallel).map((task) => task.id),
305
+ });
306
+ }
307
+ }
308
+ return { gaps };
309
+ }
310
+
311
+ // 报文(plan 出口 BLOCKED):逐对点名哪两个任务同波、谁没标,
312
+ // 恢复句给两条出路(都标 [P],或补 depends_on 换波次)——只有一条出路时执行者会以为「标 [P] 是唯一
313
+ // 正确答案」,而真实计划里「这两个任务其实有先后」是同样常见的形态。
314
+ function parallelGapLines(gaps, level = 'BLOCKED') {
315
+ if (gaps.length === 0) return [];
316
+ const blocking = level === 'BLOCKED';
317
+ const sample = gaps[0];
318
+ const lines = [(blocking ? 'BLOCKED: ' : 'WARN: ')
319
+ + 'TASK.md 同波任务可并行却未标 [P]——同一波次内彼此无依赖路径、且 write_files 不重叠的任务本可并行;'
320
+ + '任务开标签的 parallel="true" 才是机器路由依据(Wave 行的 [P] 只是散文标记)'
321
+ + (blocking ? '' : '(旧 change 渐进不阻断)')
322
+ + ':'];
323
+ for (const gap of gaps) {
324
+ lines.push(' - ' + gap.a + ' × ' + gap.b + '(同在第 ' + gap.wave + ' 波;未标 parallel="true": '
325
+ + gap.unmarked.join('、') + ')');
326
+ }
327
+ lines.push('恢复: 两条出路任选——① 给这一对都标 parallel="true"(Wave 行同步标 [P]),让它们真的同波并行;'
328
+ + '② 补一条 depends_on(如给 ' + sample.b + ' 加 <depends_on>' + sample.a + '</depends_on>)'
329
+ + '把它们排到不同波次,顺序因而显式;改完重试');
330
+ return lines;
331
+ }
332
+
333
+ // 分级 → 输出的唯一出口(与 waveReviewOutcome 同形:两个调用方各自只派生 blocking)。ADR-013 的
334
+ // 「replan 不豁免」同样适用于本判据:只在 plan 出口判,执行期重签就能把「本可并行却没标」的计划
335
+ // 换一份发出去——那正是两处同判要防的形态。
336
+ export function parallelGapOutcome(review, { blocking = false } = {}) {
337
+ const blocked = blocking === true;
338
+ if (review.gaps.length === 0) return { lines: [], block: false };
339
+ return { lines: parallelGapLines(review.gaps, blocked ? 'BLOCKED' : 'WARN'), block: blocked };
340
+ }