iter(g41): verify 校验 README 分组行与清单一致

.ua/backlog.json

@@ -684,6 +684,14 @@
       "acceptance": "ButtonProps 增 type（缺省 button）；form 内提交按钮用 submit、重置用 button；单行输入框 Enter 等同提交且 textarea 不受影响；文档同步；npm run check 全绿",
       "status": "done",
       "notes": "自补：缺陷修复；textarea 保留换行语义"
+    },
+    {
+      "id": "g41",
+      "title": "verify 校验 README 分组行",
+      "motivation": "README「分组：」行是第二份组件清单，新增组件只改 ua:components 区块时分组行会静默过期（本轮之前已漏 6 个组件）",
+      "acceptance": "verify 解析分组行并比对清单集合，漏写/多写均报错（formItem 作为别名放行）；负向删除 tree 即失败；npm run check 全绿",
+      "status": "open",
+      "notes": "自补：构建/门禁工具链改进"
     }
   ]
 }

AGENTS.md

@@ -27,7 +27,7 @@
 - `apps/demo`（@ui-arch/demo）：交互演示，产物 apps/demo/dist/demo.html
 - `apps/docs`：文档站，纯产物（ua docs 生成）
 
-**门禁一条龙**：`npm run check` = build + demo + style + typecheck + smoke + index + verify，提交前必过。`ua verify` 校验清单 ↔ 文档 ↔ 演示一致（docs.components 的 id 必须在 api.exports 有对应条目、props 必须带 n/t/d、demo 锚点必须在 `apps/demo/main.ts` 中存在），检查皮肤包样式表无硬编码颜色（`#hex` 一律禁止，必须走 `--ua-*` 令牌）与令牌引用有效（`var(--ua-*)` 必须是 tokens.css 已定义或组件自设的变量），核对 README 的 `<!-- ua:components -->` 区块与清单组件集合完全一致，并交叉校验 backlog 的 done 条目与 `.ua/iterations.log` 的 done 留痕一一对应。
+**门禁一条龙**：`npm run check` = build + demo + style + typecheck + smoke + index + verify，提交前必过。`ua verify` 校验清单 ↔ 文档 ↔ 演示一致（docs.components 的 id 必须在 api.exports 有对应条目、props 必须带 n/t/d、demo 锚点必须在 `apps/demo/main.ts` 中存在），检查皮肤包样式表无硬编码颜色（`#hex` 一律禁止，必须走 `--ua-*` 令牌）与令牌引用有效（`var(--ua-*)` 必须是 tokens.css 已定义或组件自设的变量），核对 README 的 `<!-- ua:components -->` 区块与「分组：」行都覆盖清单组件集合（漏写/多写都报错），并交叉校验 backlog 的 done 条目与 `.ua/iterations.log` 的 done 留痕一一对应。
 
 **提交信息规范**：`COMMITTING.md`（`<type>(<scope>): <中文祈使句>`），`ua commit-lint` + commit-msg 钩子自动校验，迭代提交用 `iter(<条目id>): <subject>`。
 

packages/tools/cli/bin/ua.js

@@ -709,6 +709,16 @@ function checkReadme(pkgs) {
   const actual = new Set(pkgs.flatMap((p) => (p.docs?.components ?? []).map((c) => c.id)));
   for (const id of actual) if (!listed.has(id)) issues.push(`README.md 组件区块缺少 ${id}`);
   for (const id of listed) if (!actual.has(id)) issues.push(`README.md 组件区块多出 ${id}（清单里没有）`);
+  // 分组行同一份清单的另一种表述：漏写/多写同样算文档漂移
+  const groupLine = fs.readFileSync(file, 'utf8').split(/\r?\n/).find((line) => line.startsWith('分组：'));
+  if (!groupLine) {
+    issues.push('README.md 缺少「分组：」行（组件分类导航）');
+    return issues;
+  }
+  const grouped = new Set(groupLine.match(/[a-zA-Z][A-Za-z0-9]*/g) ?? []);
+  const alias = new Set(['formItem']); // formItem 与 form 共用一条文档，分组行里会单独出现
+  for (const id of actual) if (!grouped.has(id)) issues.push(`README.md 分组行缺少 ${id}`);
+  for (const id of grouped) if (!actual.has(id) && !alias.has(id)) issues.push(`README.md 分组行多出 ${id}（清单里没有）`);
   return issues;
 }
 
@@ -871,7 +881,7 @@ function cmdVerify() {
     console.error(`${issues.length} violation(s)`);
     process.exit(1);
   }
-  console.log('verify OK (manifest ↔ docs ↔ demo 一致，皮肤无硬编码颜色与未定义令牌，README 组件清单同步，backlog ↔ 留痕一致)');
+  console.log('verify OK (manifest ↔ docs ↔ demo 一致，皮肤无硬编码颜色与未定义令牌，README 组件清单与分组同步，backlog ↔ 留痕一致)');
 }
 
 /*** 校验 git 提交信息是否符合 COMMITTING.md 规范（参数为 message 文件路径或直接 message 文本），违规退出码 1 ***/