agentic-flow-kit 1.8.7 → 2.0.0

package/templates/profiles/dotnet/.agents/config/lane-surfaces.txt

@@ -0,0 +1,33 @@
+# L2 触达面清单（单源：本文件——check-lane-surface.mjs 共读，verify.mjs lane-surface-ci「泳道完整性」门禁：关单/CI 硬拦，2026-10-21 撤出 pre-commit）
+# 格式：每行一条 ERE（grep -E 兼容），匹配暂存/diff 文件的仓库相对路径（/ 分隔）。
+#   # 注释与空行忽略；本文件缺失或清单为空 = 检查跳过（装户无感升级）。
+#   正则语法错误行 → 门禁 fail-closed 阻断（防静默空洞，修配置后重试）。
+# 段协议（2026-10-09 ai-native-review-p1）：`## engine` / `## product` 行切换后续 ERE 类别——
+#   engine  = 引擎/门禁自身面：无活跃入口时仅 advisory（docs/bootstrap 豁免类合法形态）；
+#             CI 面不执法（仅 advisory——撤出 pre-commit 后 engine 段无硬拦执法点）。
+#   product = 产品契约/schema 面：按路径归因，执法点 = verify.mjs lane-surface-ci 关单/CI 硬拦
+#             （--ci diff 面；2026-10-21 撤出 pre-commit，提交钩子不再起本进程）。
+#             CI diff 面按「diff 内协伴 L2+ 入口文档（状态不限）」判据执法。
+#   标记行出现前的 ERE 默认 engine（向后兼容）。
+# 语义：命中任一模式 = 本次改动触及「一处定义、多处消费」的契约 / 规则面（L2 触达面，
+#   判据见 .agents/commands/new-task.md §1 风险定级）。
+#   engine：无硬拦判定——唯一执法点（lane-surface-ci --ci）仅 advisory（活跃入口判据属已撤出的检查 A）。
+#   product：diff 内任一 L2/L3 入口文档（状态不限——fixed/done 亦算，含归档件）即罩住全部命中；
+#     无协伴 → 整批 hard 拦。
+# 产品面登记口径（2026-10-09 ai-native-review-p1，按可路径表达的保守闭集——内容级权威（取号/编码
+#   逻辑内嵌于服务）不可路径表达，仍靠级别判定纪律）：backend/shared 全模块（跨模块共享内核：
+#   契约/分页/错误出口/认证服务，49 文件）+ API 横切根（DI 管线/错误出口/JSON 序列化权威）+
+#   schema 变更与数据修复 SQL（L3 判据直配；此前 2026-09-28 曾实证「4 个 L3 schema 批次无 spec/plan」）。
+# 闭集防漂移（2026-10-09 P3-2）：月度跑 node .agents/scripts/lane-surface-audit.mjs——反查「L2/L3 任务
+#   反复触及却无 ERE 命中的目录」出候选清单，人工评估补登（高频触及 ≠ 契约面，机器不猜语义）。
+## engine
+^templates/
+^\.agents/(scripts|hooks)/
+^\.githooks/
+^bin/
+^modules/
+## product
+^backend/shared/
+^backend/material/Shipyard\.Material\.API/(Program\.cs|ErrorHandling/|JsonConverters/)
+^wiki/数据维护/schema变更/.*\.sql$
+^wiki/数据维护/数据修复/.*\.sql$

package/templates/profiles/dotnet/.agents/config/rule-budgets.txt

@@ -0,0 +1,84 @@
+# 常驻面体积预算（单源：verify.mjs 引擎段一门 rule-budget --all（硬门；2026-10-28 退出 pre-commit），CI 经 verify --full 间接执法——azure-pipelines.yml 无直接引用；判定脚本 rule-budget.mjs，2026-10-08 自 .sh 移植 node）
+# 格式：<路径或 glob> <上限字节>；路径以 / 结尾表示目录合计。上限 = 瘦身后实测 + 余量。
+# 条目数预算（2026-10-15 减重手段②）：<目录> <N>#count = 匹配文件**条数**上限（规则面一进一出：
+#   新增一条须先退役一条，退役判定 node .agents/scripts/agg-judgments.mjs --retire-candidates）。
+# 2026-09-21 第二轮：backend / frontend 两目录级 AGENTS.md 内容精简后重定上限（实测 backend 5955B / frontend 4581B）。
+# 2026-11-04 第九轮：frontend/AGENTS.md 扩充为 BC/G 门禁与 Never 规则全集（实测 8499B），上限 4992→9216B（余量 ~8%，同他条量级）；
+#   .trae/rules 三份通用规则收敛为 backend/frontend 作用域两份（实测 237B/212B），project-workflow 条目随文件退役。
+# 2026-09-21 第三轮：.agents/commands/ 8 个阶段命令去重（触发节 / 子代理约定 / 重复静态门 / 落点说明）后实测合计 37347B；
+# 上限 39936B 不变（余量 2589B ≈ 6.9%，与其它条目同量级），单篇上限 7168B 不变（当前峰值 maintain.md 6127B）。
+# 2026-10-05 第四轮：flow-kit v1.1.3 升级（卡片 8→12 张、build/test 增厚）重定上限：实测合计 63010B、峰值 build.md 8144B；
+# 目录上限 39936→67584B、单篇 7168→8704B（余量与其它条目同量级 ~7%）。
+# 同轮：AGENTS.md 新增「项目适配区」（v1.1.3 test.md 冒烟脚本登记位）实测 8216B，上限 7680→8704B。
+# 同轮：backend/AGENTS.md 复核 P2-2 恢复被夹带删减的红线明细并保留「异常响应收口」红线，实测 6964B，上限 6400→7424B。
+# 超限含义：常驻面只增不减——须先删除或下沉被取代条目再增（一进一出，见 .agents/commands/maintain.md 三件套③）。
+# 说明：本文件会被 core.autocrlf 检出为 CRLF，读取方（rule-budget.mjs）已显式去 \r，禁止依赖行尾格式。
+# 口径：预算比较用「索引 / HEAD 字节」（git cat-file，LF 归一）；禁用工作区 wc -c 核对（CRLF 膨胀，2026-09-21 实测差 ~500B）。
+AGENTS.md 8704
+backend/AGENTS.md 7424
+frontend/AGENTS.md 9216
+.trae/rules/backend-scope.md 256
+.trae/rules/frontend-scope.md 256
+# 2026-10-09 CodeBuddy 适配收口：rules 常驻面（project-workflow + 中文 + 提交）+ 主记忆 CODEBUDDY.md 首入预算（实测 rules 合计 2162B / CODEBUDDY.md 475B）
+# 2026-11-05 CodeBuddy 收敛（对齐 .trae/rules 先例）：三份通用规则退役，收敛为 backend/frontend 作用域两份（实测合计 449B：237B/212B，与 .trae 同字节），上限 2336→512B。
+.codebuddy/rules/ 512
+.codebuddy/CODEBUDDY.md 512
+.agents/commands/*.md 8704
+# 2026-11-08 档 2-F（stages.md 四并一）：plan/design/build/test 四份阶段命令合并为 stages.md，四并一去重后
+# commands 合计下降（四文件 LF 19658B → 单文件 19159B），但单文件超通配行 8704B——为 stages.md 开专用行
+# 重定单文件上限（实测 19159B + 余量 ~7%，与他条同量级）；专用行优先于通配行，语义见 rule-budget.mjs。
+.agents/commands/stages.md 20480
+# 2026-11-10 档二：L0/L1 快速道放宽（L0 上限 3→5、fill-plan --lite 三节、L2 负例增补）后实测 9113B
+#   超通配行 8704B——定级判据单源在入口命令、无法下沉 skills/，按 stages.md 先例开专用行重定
+#   上限（余量 615B ≈ 6.7%，与他条同量级）。
+.agents/commands/new-task.md 9728
+# 2026-10-21 第五轮：路由表去重与快速道检索前移后重定目录上限。实测 commands 合计 41256B（索引 LF），
+# 上限 67584→44144B（余量 2888B ≈ 7.0%）。单篇上限 8704B 不变（峰值 new-task.md 6121B）。
+# 2026-10-22 第六轮：develop 合并（MTO 批 commands 增改）与本地引擎批并集后实测合计 44189B，
+# 两侧各自在旧上限内、并集超 45B——按轮惯例重定：上限 44144→47282B（余量 3093B ≈ 7.0%）。
+# 2026-10-29 第七轮（owner 点名专项瘦身，未重定上限）：第六轮后 docs(engine) 批次只增未减致 HEAD 49617B 超限
+# 2335B——回溯精简 35 处历史注记/复述（判据全留，清单见当日 commit），实测合计 46530B 回到限内（余量 752B）；
+# 同轮 runtime-env 压 7 处已根治条目史叙净减 ~600B 回到限内。教训：docs(engine) 增批次须同步本表对账。
+# 2026-11-06 第八轮：新增 pr-review 路由命令（pr-review.md）+ review.md 的 PR 指针/分档/Evidence 行。
+# 正文已下沉 .agents/skills/pr-review/SKILL.md；commands 只留路由与判据指针。实测 working tree LF 合计 48478B，
+# 上限 47282→48900B（余量 ~422B）。若后续再增命令，先按一进一出下沉/删除，不要继续抬上限。
+# 2026-11-06 第九轮（owner 裁定）：第八轮估 48478B、实测 51354B（pr-review.md 2737B + review.md 扩写），
+# 超第八轮上限 2454B——属长期能力增长，重定上限 48900→52500B（余量 1146B ≈ 2.2%）。
+# 纪律不变：后续再增命令先按一进一出下沉/删除（正文继续下沉 skills/），不要继续抬上限。
+.agents/commands/ 52500
+# 2026-10-15 规则面一进一出（减重手段②）：check-loop 段数上限——锚日升格只增不减的对冲面；
+# 超上限进门先退役一段（候选见 agg-judgments --retire-candidates；段编号承重不重排，退役 = 段体
+# 删除 + SECTIONS 行摘除，编号留疤）。
+# 2026-10-16 减重①落地：§11→§6、§12→§9、§13→§16 三组合并（段体逐字，编号留疤）——上限 26→23。
+# 2026-10-21 门禁极小化第 1 批：§17 发版未收口退役删码（恒不触发，owner 拍板）——段数 23→22，上限棘轮同降。
+# 2026-10-22 门禁收敛批 4：§20 引擎脚本测试覆盖退役删码（挂载条件为包源环境，本仓恒不触发）——段数
+# 22→21，上限棘轮同降（批 4 段体已删但本行未同降，本次补齐——棘轮同降是纪律，漏一次即常驻面只增不减）。
+# 2026-10-23 P1：§28 消费端脚本覆盖对账新增（§20 的替代，判据改扫本仓 .agents/scripts）——段数
+# 21→22，上限同步回升（一进一出：新增段已带豁免表与单测，非无判据扩张）。
+# 2026-10-28 引擎测试面退役：§28 + 全部 .agents/**/*.test.mjs + run-tests 删除（owner 决策）——22→21。
+# 2026-10-28 引擎减重第一刀：hygiene 16 段退役（check-loop 22 段→5 段全 hard）——21→5，上限棘轮同降。
+# 2026-11-11 owner 拍板决策二：§29 回归清单执法者配对新增（审计 P1 168 条空执法者补位）——5→6。
+#   2026-10-22 gate-health「新增 hard 段须先退役一个」本次为 owner 显式拍板扩界（未退役段）。
+.agents/scripts/check-loop-sections/ 6#count
+# 2026-10-22 gate-health：hard 车道有界——新增 hard 段须先退役一个 hard（当前 5：§1 §3x §8 §15 §23）。
+# 总段数棘轮（上一行 5）只锁总量，不锁 hard 数；本行补 hard 面（rule-budget.mjs 数 check-loop.mjs SECTIONS）。
+# 2026-11-11 owner 拍板决策二：§29 同日新增，hard 5→6（同上一行扩界豁免——显式拍板，未走先退役后新增）。
+check-loop-hard 6#count
+# 2026-10-23 docs-ratchet：环境事实册与机制台账此前无预算行（实测只增不减，32 天 3.9KB→47.6KB）。
+# 超限处置顺序（一进一出）：① 合并重复登记（同一事实只留单源）→ ② 历史外迁（已根治项/退役细节删或移 wiki，
+# git 史可查）→ ③ 压缩叙事（读数/过程/日期流水 → 只留结论+判据）→ ④ 确需长期增长才重定上限，
+# 并在该行上方写带日期的理由（仓内惯例，见前几轮）。禁 --no-verify 绕过。
+# 2026-10-31 第八轮（常驻面瘦身 + 防激增）：全量①②③——删重复登记/已根治条目/退役机制史（集成测试
+# 分区库行、§6.4 五行、registry 现状流水段），「最近触发」按三段式压缩，gitleaks/ZCode hook 实证收敛单源；
+# 实测 runtime-env 34.8KB / registry 20.7KB，上限棘轮同降（40960→37888 / 32768→22528，余量 ~9%）。
+# 同轮上线单行上限（防激增 C，替代已退役检查 22 的人工单行纪律）：<N>#line 机器执法，超标 pre-commit 硬拦；
+# 纪律补丁见 mechanism-registry「体量三闸」与 runtime-env §6 头注（月度对账附瘦身步：行超上限 80% 即压）。
+# 2026-11-08 runtime-env-slim 遗留棘轮行使：实测 34,314B ×1.09≈37,402，按仓内 KiB 粒度下调一档。
+# 2026-11-11 宿主适配批量登记（并发任务）：Claude Code 宿主两门+壳（+518B/+422B）、Cline 宿主两门 hook 适配层（+465B/+303B）。
+# 按「超限处置顺序 ④ 确需长期增长才重定上限」：实测 registry 24,174B / runtime-env 37,757B，按仓内 KiB 粒度上调一档。
+.agents/notes/runtime-env.md 37888
+# 2026-11-06：新增「PR 面板评审批次门」登记行（约 400B）；上限 22528→23200B。
+# 2026-11-11 上调：宿主适配批量登记（Claude Code + Cline 门接线），实测 24,174B → 24576B（见 runtime-env 行上方说明）。
+.agents/config/mechanism-registry.md 24576
+.agents/notes/runtime-env.md 832#line
+.agents/config/mechanism-registry.md 832#line