agentic-flow-kit 1.8.7 → 2.1.0

package/modules/hosts/trae/hooks/post-edit-check.cjs

@@ -1,98 +0,0 @@
-#!/usr/bin/env node
-/**
- * PostToolUse(Edit|Write) hook — 编辑 .cs 文件后即时跑架构红线检查
- *
- * Trae 宿主事实：PostToolUse 不能撤销已完成的编辑，但可用 hookSpecificOutput.additionalContext
- * 把违例喂回模型，让它在提交前自行修掉；硬阻断在 PreToolUse 的 pre-shell-check.cjs（走 .githooks/pre-commit）。
- *
- * stdin: { tool_name, llm_tool_name, tool_input: { file_path, ... }, cwd, workspace_roots, ... }
- */
-const { execFileSync } = require('child_process');
-const fs = require('fs');
-const { resolveShell } = require('./resolve-shell.cjs');
-
-// --- 读取 stdin ---
-let raw = '';
-try {
-  raw = fs.readFileSync(0, 'utf8');
-} catch {
-  process.exit(0);
-}
-
-let data;
-try {
-  data = JSON.parse(raw);
-} catch {
-  process.exit(0);
-}
-
-const toolName = `${data.tool_name || ''} ${data.llm_tool_name || ''}`;
-if (!/edit|write/i.test(toolName)) {
-  process.exit(0);
-}
-
-// 文件路径字段名跨宿主/版本可能不同，逐个候选取第一个命中的
-function extractFilePath(input) {
-  if (!input || typeof input !== 'object') return '';
-  for (const k of ['file_path', 'filePath', 'path', 'target_file', 'file']) {
-    if (typeof input[k] === 'string' && input[k]) return input[k];
-  }
-  return '';
-}
-
-const filePath = extractFilePath(data.tool_input);
-if (!/\.cs$/i.test(filePath)) {
-  process.exit(0); // 非 .cs 文件，跳过
-}
-
-const projectRoot = data.cwd || (Array.isArray(data.workspace_roots) && data.workspace_roots[0]) || process.cwd();
-
-const shellBin = resolveShell();
-if (!shellBin) {
-  console.log(JSON.stringify({
-    hookSpecificOutput: {
-      hookEventName: 'PostToolUse',
-      additionalContext: '⚠️ 架构红线检查未执行：未找到可用的 bash / sh。安装 Git for Windows 后重试，或提交前手动跑 .agents/hooks/check-architecture.sh。'
-    }
-  }));
-  process.exit(0);
-}
-
-// timeout 单位是毫秒：架构检查实测约 0.6 秒，30 秒预算够用；
-// （2026-09-19 修复：原值 30 是 30 毫秒，必然 ETIMEDOUT，导致每次 .cs 编辑都误报「发现违例」）
-try {
-  execFileSync(shellBin, ['.agents/hooks/check-architecture.sh'], {
-    cwd: projectRoot, stdio: ['ignore', 'pipe', 'pipe'], timeout: 30000
-  });
-  // 通过，无输出
-} catch (e) {
-  if (e.code === 'ETIMEDOUT') {
-    console.log(JSON.stringify({
-      hookSpecificOutput: {
-        hookEventName: 'PostToolUse',
-        additionalContext: '⚠️ 架构红线检查超时（30 秒）：本次编辑未验证，请在提交前手动跑 .agents/hooks/check-architecture.sh。'
-      }
-    }));
-    process.exit(0);
-  }
-  // 门禁脚本未装（未跑 add-gate dotnet-ca）≠ 发现违例——区分口径，对齐 pre-shell-check 的 ENOENT 处理（2026-09-24）；
-  // status 127 同义（2026-09-27 host-gates-p1 P2-B4：存在的 bash 跑缺失脚本返回 127 而非 ENOENT，实测原分支不可达）
-  if (e.code === 'ENOENT' || e.status === 127) {
-    console.log(JSON.stringify({
-      hookSpecificOutput: {
-        hookEventName: 'PostToolUse',
-        additionalContext: '⚠️ 架构红线检查未执行：check-architecture.sh 未安装（flow-kit add-gate dotnet-ca 装入）——本次编辑未验证。'
-      }
-    }));
-    process.exit(0);
-  }
-  const err = String((e.stderr || '') + (e.stdout || '')).slice(0, 800);
-  console.log(JSON.stringify({
-    hookSpecificOutput: {
-      hookEventName: 'PostToolUse',
-      additionalContext: `⚠️ 架构红线检查发现违例（check-architecture.sh）：\n${err}\n请在提交前修复；硬阻断在 git commit 时执行。`
-    }
-  }));
-}
-
-process.exit(0);

package/modules/hosts/trae/hooks/pre-shell-check.cjs

@@ -1,192 +0,0 @@
-#!/usr/bin/env node
-/**
- * PreToolUse(RunCommand) hook — 两道关卡：
- * 1) deny/ask 命令门禁（口径同 .agents/settings.json 的 deny/ask 策略）
- * 2) git commit / git push 前置检查：直接调 .githooks/pre-commit / pre-push
- *
- * 为什么调 .githooks/*：那是项目唯一的门禁权威（pre-commit 门禁链 + pre-push 闭环断档）。
- * 本钩子是**宿主侧冗余**——core.hooksPath 漏配时 git 侧门禁静默失效（2026-09-16 Trae 侧缺档事故），
- * 由这里在命令执行前拦下；门禁清单只维护 .githooks/ 一份，本文件不复制。
- *
- * Trae 宿主事实（docs.trae.ai/ide/hook-configuration-reference）：
- *   - 终端工具的 matcher 名是 RunCommand（不是 Shell/Bash）；timeout 单位是**秒**。
- *   - stdin: { session_id, cwd, hook_event_name, workspace_roots, tool_use_id, tool_name, llm_tool_name, tool_input }
- *   - stdout: hookSpecificOutput.permissionDecision = allow / deny / ask；无输出 = 放行。
- */
-const { execFileSync } = require('child_process');
-const fs = require('fs');
-const { resolveShell } = require('./resolve-shell.cjs');
-
-// --- 读取 stdin ---
-let raw = '';
-try {
-  raw = fs.readFileSync(0, 'utf8');
-} catch {
-  process.exit(0); // 无 stdin，放行
-}
-
-let data;
-try {
-  data = JSON.parse(raw);
-} catch {
-  process.exit(0); // JSON 解析失败，放行（不阻塞正常工作流）
-}
-
-// 工具名兼容：Trae 规范化名为 RunCommand，llm_tool_name 为原始名；保留 Claude 风格别名防宿主差异
-const toolName = `${data.tool_name || ''} ${data.llm_tool_name || ''}`;
-if (!/runcommand|bash|shell|terminal|executecommand/i.test(toolName)) {
-  process.exit(0);
-}
-
-// 取命令文本：优先约定的 command 字段；字段名缺失时退回扫描 tool_input 的字符串值
-// （信任边界上的宿主 payload，字段名跨版本可能不同——漏读会让门禁静默失效，故兜底扫描）
-function extractCommand(input) {
-  if (!input || typeof input !== 'object') return '';
-  if (typeof input.command === 'string' && input.command) return input.command;
-  return Object.values(input).filter(v => typeof v === 'string').join('\n');
-}
-
-const command = extractCommand(data.tool_input);
-if (!command) {
-  process.exit(0);
-}
-
-const projectRoot = data.cwd || (Array.isArray(data.workspace_roots) && data.workspace_roots[0]) || process.cwd();
-
-function deny(reason) {
-  console.log(JSON.stringify({
-    hookSpecificOutput: {
-      hookEventName: 'PreToolUse',
-      permissionDecision: 'deny',
-      permissionDecisionReason: reason
-    }
-  }));
-  process.exit(0);
-}
-
-function ask(reason) {
-  console.log(JSON.stringify({
-    hookSpecificOutput: {
-      hookEventName: 'PreToolUse',
-      permissionDecision: 'ask',
-      permissionDecisionReason: reason
-    }
-  }));
-  process.exit(0);
-}
-
-// ── 1) deny/ask 命令门禁 ──────────────────────────────
-// 清单权威源 = .agents/settings.json（p2-batch2 对齐：旧清单多抄了一项 'dotnet ef' 造成双源漂移——
-// settings.json 无此项；EF Migrations 禁令属 dotnet-ca 门禁域，如需恢复请先加进 settings.json 再同步此处）
-const denyList = [
-  { pat: 'git reset --hard',  reason: '禁破坏性重置' },
-  { pat: 'drop database',     reason: '禁删库' }
-];
-const askList = [
-  { pat: 'git checkout',  reason: '可能切换/丢弃工作区改动' },
-  { pat: 'git clean',     reason: '可能删除未跟踪文件' },
-  { pat: 'git branch -D', reason: '可能删除未合并分支' },
-  { pat: 'rm -rf',        reason: '可能递归删除文件' }
-];
-
-// stripMessages：剥 -c/-m 的值（含引号整段）——deny/ask 门与强推检测共用，防 commit 消息字样误触发
-function stripMessages(cmd) {
-  return cmd
-    .replace(/(^|\s)-[cm]\s+"[^"]*"(?=\s|$)/g, ' ')
-    .replace(/(^|\s)-[cm]\s+'[^']*'(?=\s|$)/g, ' ')
-    .replace(/(^|\s)-[cm]\s+\S+(?=\s|$)/g, ' ')
-    .replace(/\s+/g, ' ').trim();
-}
-
-// 强推检测 token 化（2026-09-27 host-gates-p1 P1-B2）：子串模式 'git push --force' 挡不住换序
-// （git push origin main --force）与 +refspec 变体（git push origin +main）——改为 token 级判定。
-// 复核 P2 收窄（同日）：①按 &&/||/;/| 分段，--force 只在 push 段内计数（dotnet build --force 不误并）；
-// ②组合短旗标（-vf）与 -f 同为 force；③--force-with-lease 是带尾巴的独立 token 不匹配。
-// p2-batch2 补：先剥 commit 消息（引号感知）再分段——"git commit -m "修 push --force"" 曾被误拦。
-// 本钩子是 core.hooksPath 漏配时的主要强推执行点，语义必须完整。
-function isForcePush(cmd) {
-  const stripped = stripMessages(cmd);
-  return stripped.split(/&&|\|\||;|\|/).some((seg) => {
-    const tokens = seg.replace(/\s+/g, ' ').trim().split(' ').filter(Boolean);
-    if (!tokens.includes('push')) return false;
-    return tokens.some((t) => t === '--force'
-      || (t.startsWith('-') && !t.startsWith('--') && /^-[a-zA-Z]*f/.test(t))
-      || (t.startsWith('+') && t.length > 1));
-  });
-}
-
-// gateMatch：比裸 includes 收紧三处（2026-09-24；p2-batch2 补 ③）——
-//   ① token 边界：'git checkout' 不再误吃 'git commit-msg'
-//   ② 剥离 git 全局参 -c <k=v> 与 -m <msg> 后以剥后文本为准——堵 'git -c x=y reset --hard' 绕过
-//   ③ 消息字样误触（p2-batch2）：带引号多词消息（-m "修 git push --force 误拦"）单 token 剥不净——
-//     剥离逻辑收敛到 stripMessages 单源（引号感知）
-function gateMatch(cmd, pat) {
-  const re = new RegExp(pat.replace(/[.*+?^${}()|[\]\\]/g, '\\$&') + '(?![\\w-])');
-  const norm = stripMessages(cmd);
-  return norm !== cmd ? re.test(norm) : re.test(cmd);
-}
-
-if (isForcePush(command)) {
-  deny('禁止执行: git push 强制推送（--force / -f / +refspec；项目红线：禁强制推送）');
-}
-for (const d of denyList) {
-  if (gateMatch(command, d.pat)) {
-    deny(`禁止执行: ${d.pat}（项目红线：${d.reason}）`);
-  }
-}
-for (const a of askList) {
-  if (gateMatch(command, a.pat)) {
-    ask(`需确认: ${a.pat}（项目 ask 策略：${a.reason}）`);
-  }
-}
-
-// ── 2) git commit / git push 前置检查 ──────────────────
-const isCommit = /git\s+commit/.test(command);
-const isPush = /git\s+push/.test(command);
-
-if (!isCommit && !isPush) {
-  process.exit(0); // 非 commit/push，放行
-}
-
-const shellBin = resolveShell();
-if (!shellBin) {
-  deny('门禁未执行：未找到可用的 bash / sh——请安装 Git for Windows，或在 Git Bash 终端手动跑 .githooks/pre-commit');
-}
-
-// runGate：把 .githooks/ 门禁原始输出透传给 AI；未执行（脚本缺失）与判定失败分开报，避免把 ENOENT 误报成代码违例
-// 127 分支（2026-09-27 host-gates-p1 P2-B4）：shell 报 127 = 脚本未装（二进制已在 resolveShell 预检排除）——
-// 实测 ENOENT 分支不可达（execFileSync 对存在的 bash 跑缺失脚本返回 status 127 而非 e.code ENOENT）
-function runGate(scriptRelPath, label, budgetMs) {
-  try {
-    execFileSync(shellBin, [scriptRelPath], {
-      cwd: projectRoot,
-      stdio: ['ignore', 'pipe', 'pipe'],
-      timeout: budgetMs
-    });
-  } catch (e) {
-    if (e.code === 'ETIMEDOUT') {
-      deny(`${label}超时（${scriptRelPath}，${Math.round(budgetMs / 1000)} 秒未完成）——检查 dotnet build / npm run build 是否卡住`);
-    }
-    if (e.code === 'ENOENT' || e.status === 127) {
-      deny(`门禁未执行（${label}）：${scriptRelPath} 不可达——确认仓库完整后重试`);
-    }
-    const err = String((e.stdout || '') + (e.stderr || '')).slice(0, 1200);
-    deny(`${label}未通过（${scriptRelPath}）：\n${err}`);
-  }
-}
-
-if (isCommit) {
-  // pre-commit 门禁链（通用包口径）：闭环配对（增量）+ wiki 台账（增量）+ 常驻面预算 + 项目门禁（local-pre-commit）+ 敏感信息扫描与条件构建
-  // 预算 5 分钟覆盖 dotnet build / npm run build（.githooks/pre-commit 内部无超时）
-  runGate('.githooks/pre-commit', '提交前门禁', 300000);
-}
-
-if (isPush) {
-  // pre-push：check-loop.sh 扫 workflow/ 闭环断档（hard-block = 配对断裂 / 回路断档 / 新建 done 未勾验）
-  // 预算 7 分钟：2026-09-19 实测 check-loop.sh 全量扫描耗时 2 分 53 秒（231 任务卡），
-  // 原定 2 分钟会误报超时——不要按「脚本应该很快」调小
-  runGate('.githooks/pre-push', '推送前闭环扫描', 420000);
-}
-
-// 全部通过，放行
-process.exit(0);

package/modules/hosts/trae/hooks/resolve-shell.cjs

@@ -1,30 +0,0 @@
-// shell 探测（供 .trae/hooks/ 各钩子共用）
-// Windows 下 bash 常不在 PATH：优先 Git Bash 绝对路径，回退 PATH 的 bash/sh。
-// 返回 null 表示不可用——调用方须 fail-closed 报告「门禁未执行」，不要当成检查通过。
-const { execFileSync } = require('child_process');
-const fs = require('fs');
-
-function resolveShell() {
-  const candidates = [
-    'C:\\Program Files\\Git\\bin\\bash.exe',
-    'C:\\Program Files (x86)\\Git\\bin\\bash.exe'
-  ];
-  for (const p of candidates) {
-    try { fs.accessSync(p); return p; } catch { /* 尝试下一个 */ }
-  }
-  // PATH 回退须避开 WSL 启动器：C:\Windows\System32\bash.exe 能过 exit 0 探测，但路径/行尾语义是 Linux 侧的（2026-09-24）
-  for (const c of ['bash', 'sh']) {
-    let cand = c;
-    try {
-      const hits = execFileSync('where.exe', [c], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] })
-        .split(/\r?\n/).map((s) => s.trim()).filter(Boolean);
-      const good = hits.find((p) => !/system32/i.test(p)); // 全部命中都在 System32（纯 WSL）→ 跳过该候选
-      if (good) cand = good;
-      else continue;
-    } catch { /* where 不可用（非 Windows）：按原名探测，保持旧行为 */ }
-    try { execFileSync(cand, ['-c', 'exit 0'], { stdio: 'pipe', timeout: 5000 }); return cand; } catch { /* 尝试下一个 */ }
-  }
-  return null;
-}
-
-module.exports = { resolveShell };

package/modules/hosts/trae/hooks.json

@@ -1,29 +0,0 @@
-{
-  "version": 1,
-  "hooks": {
-    "PreToolUse": [
-      {
-        "matcher": "RunCommand|Bash|Shell|Terminal",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node .trae/hooks/pre-shell-check.cjs",
-            "timeout": 800
-          }
-        ]
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "Edit|Write|MultiEdit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node .trae/hooks/post-edit-check.cjs",
-            "timeout": 60
-          }
-        ]
-      }
-    ]
-  }
-}

package/modules/hosts/trae/rules/beautify-input-chinese.md

@@ -1,6 +0,0 @@
----
-alwaysApply: false
-scene: beautify_input
----
-
-请使用中文回复。所有解释、说明、注释和对话均使用中文。

package/modules/hosts/trae/rules/git-commit-message.md

@@ -1,10 +0,0 @@
----
-alwaysApply: false
-scene: git_message
----
-
-提交信息一律中文，遵循 Conventional Commits：`<类型>(<范围>): <说明>`，例如 `fix(采购订单): 页签切换浮层收纳`、`docs(trae): 同步工作流适配层`。
-
-- 类型枚举：feat / fix / docs / style / refactor / perf；`.githooks/commit-msg` 按此硬校验首行，非枚举前缀会被拦下，merge / revert 提交豁免。
-- 范围可省：`fix: 说明` 同样合法；分隔符 `:` 或 `（` 均可。
-- 禁止 `[feat] 说明` 这类方括号写法。

package/modules/hosts/trae/rules/project-workflow.md

@@ -1,14 +0,0 @@
----
-alwaysApply: true
----
-
-本项目工作流唯一权威是根目录 `AGENTS.md`：开工前必须完整读取并严格遵循（任务流程 / 通用约束与红线 / 目录级规则 / 运行时与验证标准），本规则只做入口指针，不复制内容。
-
-- 规则加载是惰性的：根 `AGENTS.md` 常驻；目录级 `AGENTS.md`（如有，如 `backend/AGENTS.md`、`frontend/AGENTS.md`）只在该目录文件被读取或被提及时才生效——动对应目录前先主动读，别凭记忆。
-- 终端环境差异（shell 可用性 / 退出码取法 /「命令不存在 ⇒ 假绿」）见 `.agents/notes/runtime-env.md` §1。
-- 闭环流程目录：`workflow/`（intents / specs / plans / incidents / delegations.md 委派台账 / papercuts.md 留痕）。
-- 6 阶段命令：按用户触发短语路由到 `.trae/commands/wf-*.md`（new-task / plan / design / build / test / deploy / maintain / review）。
-- 子智能体（`.trae/agents/*.md`）按适配器委派；Trae 子智能体为 Beta 功能、需在设置中开启，未开启时按权威命令的 fallback 执行——`fallback: new-session` 必须另开新会话，不得由原会话自查冒充。
-- 闭环兜底以 `.githooks/` 为准（门禁清单以各 hook / `.agents/scripts/check-loop.sh` 头部注释为准，不在本文件复述）；`.trae/hooks/` 在命令执行前再拦一次，`core.hooksPath` 漏配时它是唯一门禁。
-- 委派完成后在 `workflow/delegations.md` 追加一行留痕；命令 / 技能卡壳误导时在 `workflow/papercuts.md` 记一行，不当场顺手改。
-- 中文为项目唯一语言；提交遵循 Conventional Commits 中文。

package/modules/hosts/zcode/agents/implementer.md

@@ -1,51 +0,0 @@
----
-name: implementer
-description: 在已批准且边界明确的工作包内实现改动或补测试；超出授权文件范围即停
----
-# Implementer
-
-> 公共角色契约（本文件）：`.agents/roles/implementer.md`。宿主薄适配（各宿主目录下 `agents/implementer.md`）正文段同源本文件，frontmatter 各自保留宿主特化字段（check-loop 检查项 6 按本引用校验适配层不断线）。
-
-## 1. 职责
-
-执行已经由主智能体和用户确认、范围明确的实现任务。适用范围仅限：
-
-- 单文件或边界清晰的局部实现
-- 有明确复现路径的 bug 修复
-- 编写或调整任务直接要求的测试
-- 修复与任务直接相关的编译错误
-
-## 2. 必需输入
-
-开始前必须获得：
-
-- 一句话任务目标
-- 必须读取的入口文档、spec 或 plan
-- 允许修改的文件清单
-- 可执行的验收条件
-
-任一输入缺失或相互冲突时，停止并向主智能体报告，不自行扩大范围。
-
-## 3. 行为边界
-
-- 只修改明确授权的文件；若必须触及其他文件，先停止并说明原因。
-- 仓库可能有其他智能体或用户同时工作；保留现有改动，不回退、不覆盖无关修改。
-- 复用现有实现、标准库和已安装依赖，保持最小工作 diff。
-- 不修改公共接口、数据 Schema、依赖、构建步骤、安全或权限策略。
-- 不执行提交、推送、发布、数据迁移或破坏性操作。
-- 不顺手重构、格式化或清理与任务无关的代码。
-
-## 4. 验证
-
-- 运行任务指定的最小相关检查。
-- 检查失败时只修复由本次改动引起且仍在授权范围内的问题。
-- 同一验证连续失败三次，或继续需要猜测需求时，停止并报告阻塞。
-
-## 5. 输出
-
-返回给主智能体：
-
-1. 修改文件清单
-2. 每个文件的改动摘要
-3. 已运行的验证及结果
-4. 未解决的阻塞或剩余风险

package/modules/hosts/zcode/agents/independent-reviewer.md

@@ -1,49 +0,0 @@
----
-name: independent-reviewer
-description: 只读独立复核（spec 或实现 diff）；不改动文件、不替用户批准
----
-# Independent Reviewer
-
-> 公共角色契约（本文件）：`.agents/roles/independent-reviewer.md`。宿主薄适配（各宿主目录下 `agents/independent-reviewer.md`）正文段同源本文件，frontmatter 各自保留宿主特化字段（check-loop 检查项 6 按本引用校验适配层不断线）。
-
-## 1. 职责
-
-在独立上下文中对 spec、plan 或代码 diff 做只读复核，发现原作者可能遗漏的正确性、契约、架构、数据安全和回归风险。
-
-## 2. 必需输入
-
-开始前必须获得：
-
-- 复核对象及固定基准（文件路径、提交或 diff 范围）
-- 对应入口文档、spec、plan（按任务级别提供）
-- 项目根目录 `AGENTS.md` + 改动域对应的目录级 `AGENTS.md`（如有）
-- 期望的复核结论或验收标准
-
-输入不足以确定范围时，停止并向主智能体报告。
-
-## 3. 行为边界
-
-- 只读，不修改任何仓库文件。
-- 不替用户决定问题定性、方案取舍、合入或上线。
-- 不继承或猜测原作者未写入输入材料的推理。
-- 只报告能用具体文件、行号、行为或契约证明的问题。
-- 不把样式偏好、假设性风险或既有无关问题包装成缺陷。
-- 无法验证的事项明确标为未验证，不声称已经通过。
-
-## 4. 复核重点
-
-1. 实现是否满足入口文档和验收标准
-2. 是否违反根 `AGENTS.md` 与改动域目录级 `AGENTS.md` 的架构、数据和所在域红线
-3. 是否改变未批准的公共契约或范围
-4. 是否缺少能防止回归的验证
-5. 是否存在数据丢失、安全、权限或发布风险
-
-## 5. 输出
-
-按严重度输出问题清单：
-
-- `P0`：数据、安全、权限或必然阻断交付的问题
-- `P1`：功能错误、明确回归或违反项目硬约束
-- `P2`：非阻断但有证据的维护性问题
-
-每项必须包含：位置、问题、证据、建议。没有发现时明确输出"未发现阻断问题"，并列出未验证范围。

package/modules/hosts/zcode/agents/ui-verifier.md

@@ -1,48 +0,0 @@
----
-name: ui-verifier
-description: 浏览器实测 UI 改动（只读验证、不留脏数据）；结论按页面/步骤/证据回报
----
-# UI Verifier
-
-> 公共角色契约（本文件）：`.agents/roles/ui-verifier.md`。宿主薄适配（各宿主目录下 `agents/ui-verifier.md`）正文段同源本文件，frontmatter 各自保留宿主特化字段（check-loop 检查项 6 按本引用校验适配层不断线）。
-
-## 1. 职责
-
-对已经实现的 UI 改动执行浏览器实测并收集可复核证据。只验证，不修复。
-
-## 2. 必需输入
-
-开始前必须获得：
-
-- 待验证页面或路由
-- 用户操作步骤
-- 每一步的预期结果
-- 涉及的改动文件或 diff 范围
-
-缺少可观察的预期结果时，停止并向主智能体报告。
-
-## 3. 执行
-
-1. 读取项目根目录 `AGENTS.md`，以及改动域目录级 `AGENTS.md`（如有，前端改动域）。
-2. 读取并遵循项目 UI 实测技能 `.agents/skills/verify-ui/SKILL.md`（如有）。
-3. 启动该技能指定的 API、前端和浏览器验证环境。
-4. 按输入步骤验证页面行为；布局类问题优先使用可重复的 DOM 几何数据。
-5. 收集控制台、网络请求、DOM 数据或截图等证据。
-6. 结束时关闭本次启动的后台进程。
-
-## 4. 行为边界
-
-- 不修改代码、配置、测试数据或工作流文档。
-- 不自行修复发现的问题；将失败证据交还主智能体。
-- 不使用生产环境或真实业务数据。
-- 无法启动环境或完成关键路径时，报告阻塞，不把部分验证标记为通过。
-
-## 5. 输出
-
-返回：
-
-1. 验证环境与页面路由
-2. 逐项通过/失败结果
-3. 失败的复现步骤和证据
-4. 控制台或网络异常
-5. 未验证范围与阻塞项

package/src/add-gate.mjs

@@ -1,116 +0,0 @@
-// flow-kit add-gate <门禁>：装门禁模块到 .agents/hooks/ 并接线 local-pre-commit 挂载点。
-// 模块约定：modules/gates/<gate>/ 下源文件拷入 .agents/hooks/（平铺，README.md 与 local-pre-commit.line 为包内元数据不拷）；
-// local-pre-commit.line 内容 = 需追加进 .agents/hooks/local-pre-commit 的挂载行（存在同名行则不重复追加，幂等）。
-// 门禁装后归项目所有：入 owned 台账，sync 永不覆盖（改红线/删不适用条目自行编辑——见各模块 README）。
-// gate 防改锚（2026-10-11 P3-1）：逐字拷贝安装的 gate 脚本，owned 条目写 srcSha256＝安装时刻包源文件
-// （modules/gates/<gate>/<file>）的 LF 归一 sha。语义：sync 对 owned 的 sha256 按盘面自愈（记账不约束），
-// 但 srcSha256 只按包源刷新——gate 文件在装户 sync 中 srcTemplatePath 解析不到包源模板（templates/_agents/
-// hooks/ 无同名件）即提前 return，锚一经写入恒定。doctor 的 gate 安装锚校验据此让「装后手改」永久可见：
-// 装户可改（不阻断），但改了会被看见。--force 重装锚随新安装刷新（即重锚路径）；已存在被跳过的文件锚
-// 盘面现状（盘面非逐字拷贝，锚包源会装后即误报），盘面与包源不一致时 WARN 差异。local-pre-commit 是
-// 合并接线件（模板 + 各门挂载行），非逐字拷贝——不写锚（它的 srcSha256 由 init/sync 按模板语义记，含义不同）。
-import fs from 'node:fs';
-import path from 'node:path';
-import { sha256 } from './render.mjs';
-
-function fail(msg) {
-  console.error(`❌ ${msg}`);
-  process.exit(1);
-}
-
-const META = new Set(['README.md', 'local-pre-commit.line']); // 包内文档/接线元数据，不装进项目
-
-export function addGate(args, pkgRoot) {
-  const gatesRoot = path.join(pkgRoot, 'modules', 'gates');
-  const available = fs.existsSync(gatesRoot) ? fs.readdirSync(gatesRoot, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name) : [];
-  const gate = args[0];
-  if (!gate || gate.startsWith('--')) fail(`缺少门禁参数（可选：${available.join(' | ') || '无'}）`);
-  if (!available.includes(gate)) fail(`未知门禁：${gate}（可选：${available.join(' | ') || '无'}）`);
-
-  let target = process.cwd();
-  let force = false;
-  for (let i = 1; i < args.length; i++) {
-    if (args[i] === '--dir') target = path.resolve(args[++i] || fail('--dir 缺少值'));
-    else if (args[i] === '--force') force = true;
-    else fail(`未知选项：${args[i]}`);
-  }
-
-  const kitPath = path.join(target, '.agents', 'kit.json');
-  if (!fs.existsSync(kitPath)) fail(`${target} 无 .agents/kit.json——先 flow-kit init`);
-  const kit = JSON.parse(fs.readFileSync(kitPath, 'utf8'));
-
-  const srcRoot = path.join(gatesRoot, gate);
-  const hooksDir = path.join(target, '.agents', 'hooks');
-  fs.mkdirSync(hooksDir, { recursive: true });
-  console.log(`▶ flow-kit add-gate ${gate} → ${target}`);
-
-  const installed = [], skipped = [];
-  let wireLine = null;
-  for (const entry of fs.readdirSync(srcRoot, { withFileTypes: true })) {
-    if (entry.isDirectory()) fail(`门禁模块含子目录（${entry.name}）——平铺约定不支持，请检查模块内容`);
-    if (entry.name === 'local-pre-commit.line') { wireLine = fs.readFileSync(path.join(srcRoot, entry.name), 'utf8').trim(); continue; }
-    if (META.has(entry.name)) continue;
-    const dst = path.join(hooksDir, entry.name);
-    if (fs.existsSync(dst) && !force) { skipped.push(entry.name); continue; }
-    fs.copyFileSync(path.join(srcRoot, entry.name), dst);
-    installed.push(entry.name);
-  }
-  console.log(installed.length ? `  安装到 .agents/hooks/：${installed.join('、')}` : '  无新文件');
-  if (skipped.length) console.log(`  跳过（已存在，--force 覆盖）：${skipped.join('、')}`);
-
-  // 接线 local-pre-commit（幂等：挂载行已存在不重复；旧装态尾部 exit 0 会吞掉其后门禁的失败——归一化剥掉）
-  let wiredLp = false;
-  if (wireLine) {
-    const lpPath = path.join(hooksDir, 'local-pre-commit');
-    const cur = fs.existsSync(lpPath) ? fs.readFileSync(lpPath, 'utf8') : '';
-    if (cur.split(/\r?\n/).some((l) => l.trim() === wireLine)) {
-      console.log('  local-pre-commit 已接线（幂等跳过）');
-    } else {
-      let lines = cur.split(/\r?\n/);
-      while (lines.length && lines[lines.length - 1].trim() === '') lines.pop();
-      if (lines.length && lines[lines.length - 1].trim() === 'exit 0') {
-        lines.pop();
-        console.log('  local-pre-commit 归一化：剥掉尾部 exit 0（旧装态，会吞掉其后门禁的失败）');
-      }
-      const body = lines.length ? `${lines.join('\n')}\n` : '#!/bin/sh\nset -e\n';
-      fs.writeFileSync(lpPath, `${body}${wireLine}\n`);
-      console.log(`  local-pre-commit 接线：+ ${wireLine}`);
-      wiredLp = true;
-    }
-  }
-
-  // owned 台账补记（归项目所有，sync 永不覆盖）。接线改写了 local-pre-commit（init 时按模板态记账）——
-  // 须同步刷新其 owned 哈希，否则台账停在模板态（Shipyard 回流发现的漂移根因，2026-09-24）。
-  // 记账一律 LF 归一（init-p1-batch P1-4 rider）：与 doctor §6.6 / sync ownedSha 同口径，跨 checkout 字节稳定
-  const shaText = (p) => sha256(Buffer.from(fs.readFileSync(p, 'utf8').replace(/\r\n/g, '\n'), 'utf8'));
-  const ownedLedger = new Map((kit.owned || []).map((f) => [f.rel, f]));
-  // 跳过件（盘上已存在、未 --force）：先出声再记账——盘面与包源不一致即本地已改，WARN 保证差异在安装输出可见。
-  // 无台账条目的首次见面按盘面现状建立基线与锚；已有条目则原样保留（锚停在安装时刻值，盘面手改
-  // 继续由 doctor gate 安装锚校验留痕——重锚会把手改吸收成「无差异」，违背防改锚初衷）。
-  for (const name of skipped) {
-    const rel = `.agents/hooks/${name}`;
-    const known = ownedLedger.has(rel);
-    if (shaText(path.join(hooksDir, name)) !== shaText(path.join(srcRoot, name))) {
-      console.log(known
-        ? `  ⚠️ ${name} 盘面与包源不一致（本地已改）——原锚保留，手改由 doctor 锚校验留痕；重装覆盖用 --force`
-        : `  ⚠️ ${name} 盘面与包源不一致（本地已改），锚记盘面现状——重装覆盖用 --force`);
-    }
-    if (!known) {
-      const diskSha = shaText(path.join(hooksDir, name));
-      ownedLedger.set(rel, { rel, sha256: diskSha, srcSha256: diskSha });
-    }
-  }
-  for (const name of installed) {
-    const rel = `.agents/hooks/${name}`;
-    // srcSha256＝安装时刻包源文件 sha（gate 防改锚，见文件头注）：sha256 被 sync 按盘面自愈，锚恒定
-    ownedLedger.set(rel, { rel, sha256: shaText(path.join(hooksDir, name)), srcSha256: shaText(path.join(srcRoot, name)) });
-  }
-  if (wiredLp) {
-    const lpRel = '.agents/hooks/local-pre-commit';
-    ownedLedger.set(lpRel, { rel: lpRel, sha256: shaText(path.join(hooksDir, 'local-pre-commit')) });
-  }
-  kit.owned = [...ownedLedger.values()].sort((a, b) => a.rel.localeCompare(b.rel));
-  fs.writeFileSync(kitPath, `${JSON.stringify(kit, null, 2)}\n`);
-
-  console.log('✅ 门禁已装（归项目所有，sync 不覆盖）。装后首个 commit 前先核对脚本头部 CONFIG 的目录/类型名——门禁 fail-closed，目标缺失会拦截提交。');
-}