agentic-flow-kit 1.8.2 → 2.0.0

package/templates/_agents/skills/wiki/SKILL.md

@@ -1,106 +0,0 @@
----
-name: wiki
-description: 项目 wiki 整理与验证技能。负责把项目内散落文档按主题归位到 wiki/，并维护 INDEX.md、知识沉淀总览.html、drafts-archive 归档一致性。当用户要求"整理 wiki/归类文档/建知识库/查文档归属"时使用。
----
-
-# Wiki 整理与验证技能
-
-## 1. 何时调用本技能
-
-触发短语：
-- "整理 wiki / 归类文档 / 建知识库 / 同步知识沉淀看板"
-- "新增一篇文档到 wiki"
-- "校对 wiki 与 INDEX 是否一致"
-- "把 X.md 归到 wiki 的哪个主题"
-- "wiki 草稿归档 / 把原文归档"
-
-不要调用本技能的场景：
-- 询问文档内容本身（直接 Read 文件即可）
-- workflow/ 下文档（已明确排除）；`docs/`、`.trae/documents/` 均已于 2026-09-12 删除
-
-## 2. 核心约定（与 AGENTS.md 一致）
-
-- **范围**：主数据知识文档 + 全项目数据维护 SQL。MTO/采购/库存/UI 等非主数据知识文档原位不动，不入 wiki。
-- **目录结构**：`wiki/<主题>/<关键词文件>`，一级目录 = 主题，二级由文件组成（无强制二级子目录）。子目录（成套产物，见 INDEX 命名规则）中的 md/html 知识文档 2026-09-17 起计入登记与看板（`*.visual-check.*`/`.json`/`.png` 工具产物不计入；`数据维护` 主题子目录例外，仍走 README 台账）。看板中 html 格式文档的文件名为可点击链接（相对看板解析）。
-- **命名**：`<主题>-<关键词>[-范围/版本].ext`，例：`需求口径说明-正式.md`、`某系统-PRD-v3.0.md`。
-- **权威**：红线与闭环以 AGENTS.md / workflow 为准；wiki 承载当前态知识（领域 / 表 / 编码 / SQL 台账）。wiki 当前文档优于 `drafts-archive/`（归档仅历史快照）。
-- **双格式对（md + html 同内容）**：md 为权威内容源，html 为展示快照——内容冲突以 md 为准，改 md 后按需重出 html；速览表「用途」列标注权威关系。
-- **索引生成（2026-09-13 起）**：速览表计数/映射表/看板 DATA 由 `node .agents/scripts/gen-wiki-board.mjs` 自动生成——人工只维护磁盘文件 + 速览表「用途」列；收录/删除/移动文件后必跑生成器（新主题用途列为 `<待补>` 时补描述后重跑）。写盘前可先 `--dry-run` 看差异（`--help` 打印用法，未知参数 exit 1）。
-- **归档目录**：`wiki/drafts-archive/YYYY-MM-DD-<主题>/`，按整理批次日期+主题命名，保留原文件名。
-- **来源血缘（双向链接，2026-10-10 起）**：沉淀到 wiki 的知识在 frontmatter 记 `来源: workflow/<intents|incidents|...>/<文件>` 指回 workflow 归档；被沉淀的 workflow 文件记 `沉淀: wiki/<主题>/<文件>`（或 `沉淀: 无` 显式豁免）。两向字段由 `verify-wiki-consistency.mjs` 校验存在性（活跃层断链即拦，草稿未落地仅提示）——人工移动/改归类时须同步改这两行，否则 check-loop 的 `[WARN 沉淀断档]` 与验证脚本都会点名。
-- **关单自动沉淀（2026-10-10 起）**：intent 置 done / incident 置 closed 时，跑 `node .agents/scripts/draft-sediment.mjs <源文件>` 自动抽取高价值节（intent：影响面/触达红线；incident：影响面/根因/为什么之前没拦住/复盘三件套）→ 落 `wiki/drafts-archive/<日期-主题>/` 草稿（带 `来源` 字段）→ 回写源文件 `沉淀` 字段 → 重跑 gen-wiki-board。草稿是**中间态**：人工读一遍，归类到 `wiki/<主题>/`（补主题与用途，保留 `来源`）后跑生成器 + §4 验证。`--dry-run` 预览不写盘；仅占位的高价值节会被拒抽（内容无沉淀价值）。
-- **排除**：`workflow/`、依赖锁文件、IDE 配置。
-
-## 3. 标准操作流程
-
-### 3.1 整理（新建/批量归位）
-
-1. **识别范围**：列出候选文件后逐篇读首行判断主题——pwsh：`Get-ChildItem -Recurse -File -Include *.md` / `Get-Content <文件> -TotalCount 8`；POSIX：`find` / `head -8`。
-2. **主题判定**：主题由内容自决，不预设分类。当前已沉淀主题：`产品需求 / 项目计划 / 开发方案 / 用户功能 / 项目规范 / 测试报告 / 数据维护`。新增主题前先与用户对齐。
-3. **建目录**：pwsh `New-Item -ItemType Directory -Force wiki/<主题>`（POSIX：`mkdir -p`）；归档目录同理建 `wiki/drafts-archive/YYYY-MM-DD-<主题>`。
-4. **复制并改名**：pwsh `Copy-Item 原路径 wiki/<主题>/<新名>`（POSIX：`cp`）；来源为仓库内原位文件时，同时按原名复制一份到 `drafts-archive/YYYY-MM-DD-<主题>/` 留溯源。
-5. **生成索引**：跑 `node .agents/scripts/gen-wiki-board.mjs`（速览计数/映射表/看板 DATA 自动重生成）；新主题在速览表「用途」列补一行描述后重跑。
-6. **自检**：跑第 4 节"验证脚本"，确认三方一致、目录无孤儿。
-
-### 3.2 新增单篇文档（新产出直接落活跃层）
-
-新产出的文档**直接归入 `wiki/<主题>/`**，不强制进 `drafts-archive/`——归档只承载整理前的历史原位文档（口径见 §3.1 第 4 步）。
-
-```
-1. 读文件首行判定主题
-2. Copy-Item 原文件 wiki/<主题>/<主题>-<关键词>.<ext>   # POSIX：cp
-3. node .agents/scripts/gen-wiki-board.mjs              （索引自动生成，无需手工改映射表/看板）
-4. 跑 §4 验证
-```
-
-### 3.3 删除/归档 wiki 中错误归位
-
-```
-1. 从 wiki/<错误主题>/ 移到 wiki/<正确主题>/，若改名也同步
-2. drafts-archive 不动（归档记录原貌）
-3. node .agents/scripts/gen-wiki-board.mjs
-4. 跑 §4 验证
-```
-
-### 3.4 重建看板
-
-`wiki/知识沉淀总览.html` 的 DATA 块由生成器从磁盘 + 速览表用途列自动生成（2026-09-13 起）。看板与磁盘不一致时：先跑 `node .agents/scripts/gen-wiki-board.mjs` 再跑 §4 验证；仍不一致说明有人手改了生成区——以生成器输出为准。
-
-## 4. 验证脚本（必跑）
-一条命令完成全部校验（磁盘 ↔ INDEX ↔ 看板 DATA ↔ summary 统计 ↔ 幽灵目录 ↔ 活跃层 file:/// 断链守卫 ↔ 数据维护台账登记 ↔ 看板链接可达性）：
-
-```bash
-node .agents/scripts/verify-wiki-consistency.mjs
-```
-
-- 通过：输出 `✅ wiki 三方一致：文件 N 份 / 主题 N 个（含占位）/ 归档 N 份`，exit 0
-- 失败：逐条列出不一致项，exit 1。除文件集合 / 计数外还覆盖：`wiki/数据维护/` 下子目录（含批次目录）未在 `wiki/数据维护/README.md` 登记、看板「打开目录」链接（`DATA.dir`，相对看板自身 `wiki/` 解析）指向不存在的目录
-- 占位主题（磁盘有目录但 0 文件）只输出 `ℹ️` 提示、不算失败；当前 7 个主题均非空（`开发方案` 2026-09-12 起已有 2 份表设计 md+html）
-- 改了 wiki 内容/INDEX/看板任一处后必须重跑；三者任何一处漏同步都会被拦下
-
-## 5. 命名冲突与歧义处置
-
-- **同名不同扩展**：例如 `数据字典-修复.sql` 与 `数据字典-修复.md` —— 文件名可重复，但 `INDEX.md` 与看板 `DATA` 用 `file` 字段存完整文件名（含扩展）以区分。
-- **跨主题歧义**：用户说"X 放哪"拿不准时，读首行 + 第一段判断；仍无法判定就先与用户确认主题，不预设兜底主题、不自造归类。
-- **二进制（xlsx/csv/sql/json）**：允许直接归位到对应主题；不要为它们新建 markdown 索引——需要说明用途时写进 `wiki/INDEX.md` 速览表的「用途」列（唯一人工维护位，用例描述一句话；该表计数与映射表、看板 DATA 均为生成区，会被 `gen-wiki-board.mjs` 重写）。`wiki/数据维护/` 下的脚本与批次目录则在 `wiki/数据维护/README.md` 台账加登记行（verify 会拦未登记目录）。
-
-## 6. 已知边界
-
-- **workflow/ 永不入 wiki**：闭环工作流目录是项目规范明文排除项。
-- **非主数据知识文档不入 wiki**（MTO/采购/库存/UI 等）——有意决策（2026-09-13 显式化；债与扩展触发条件见 `wiki/INDEX.md` §范围边界决策）；数据维护 SQL 为全项目，不受此限。
-- **dependency 锁文件 / IDE 配置**：不入 wiki（`package-lock.json`、`pnpm-lock.yaml`、`*.sln`、`*.esproj` 等）。
-- **批量整理只动一份副本**：本技能只复制（`Copy-Item` / `cp`），不删除原文件；删除原文件需要用户在对话内单独确认（这是 STOP 线场景）。
-
-## 7. 与 AGENTS.md 衔接
-
-- 改动 `wiki/INDEX.md`、`wiki/知识沉淀总览.html`、`.agents/skills/wiki/SKILL.md` 属 docs 级改动，**豁免 intent**，走 Conventional Commits 直接 commit：`docs(wiki): <动作>`。
-- 若同时改 wiki 内某个具体知识文档（含路径变更/改名），按该文档原主题级别立 intent / incident。
-- wiki 不替代 AGENTS.md / workflow 的红线与闭环；与二者冲突时以 AGENTS.md / workflow 为准。wiki 与 `drafts-archive/` 冲突时以 wiki 当前文档为准。
-
-## 8. 失败模式与回滚
-
-- **忘跑生成器**：磁盘文件动了没跑 `gen-wiki-board.mjs` → §4 脚本报「仅在看板上 / 仅在磁盘上」差异 → 跑生成器即对齐。
-- **手改生成区**：速览计数/映射表/看板 DATA 是生成产物，手改会被 verify 拦且下次生成被覆盖——用途列才是人工编辑位。
-- **原文件误删**：本技能只复制（`Copy-Item` / `cp`），不删原文件；若用户单独要求删除原文件，必须先列目录确认（pwsh `Get-ChildItem` / POSIX `ls`）再操作。
-- **主题命名反复**：以 §4 脚本 A 段为最终事实；速览表用途列的 `<待补>` 提示新主题未补描述。
-- **全文检索**：找「哪个文件讲过 X」用 `node .agents/scripts/wiki-search.mjs <关键词>`（wiki 活跃层，多词 AND；不扫归档；默认跳过 json/csv、视觉校验产物与 >180KB bulk 文件，`--include-generated` 纳入）；跨语料（workflow 流程留痕 + wiki）用 `node .agents/scripts/kb-search.mjs "<词>"`。

package/templates/_agents/workflow-enums.txt

@@ -1,26 +0,0 @@
-# workflow 文档枚举单源（2026-09-25 enum-single-source）
-# 本文件会被 core.autocrlf 检出为 CRLF——读取方显式去 \r（node parseEnums），禁止依赖行尾格式（rule-budgets.txt 同约定）。
-# 消费方：check-loop.mjs / workflow-board-server.mjs / kb-search.mjs / gen-workflow-index.mjs /
-#         fill-{intent,plan,spec}.mjs（均经 scripts/workflow-enums.mjs 读取器）——改枚举改这里，别改消费方。
-# 格式：key=value value value（空格分隔；# 注释行忽略；键重复 / 值重复 / 缺键 = 消费方 fail-loud）
-# 语义：doc = intent/spec/plan 三件；incident = 事故件。
-#   all       全生命周期状态
-#   confirmed 已确认（check-loop「状态未确认」放行口径 = 看板枚举告警口径）
-#   active    活跃（INDEX 活跃层 / kb-search 活跃 ×1.3 排序）
-#   terminal  终态（看板「入口已 done 而 plan 未终态」告警口径）
-#   abandoned 放弃留档（L3 确认三件豁免口径）
-doc.status.all=draft approved done superseded cancelled
-doc.status.confirmed=approved done superseded cancelled
-doc.status.active=draft approved
-doc.status.terminal=done superseded cancelled
-doc.status.abandoned=superseded cancelled
-incident.status.all=open fixed closed
-incident.status.active=open
-# 归因枚举（2026-10-13 自 Shipyard 回灌 incident-attribution）：归因检查（B6b 落地后编号以 check-loop.mjs 头部清单为准）校验 incident frontmatter 的「来源:」/「影响环境:」。
-#   source = 谁发现（self=AI 自查 / user=用户报出 / test=测试或实测暴露 / monitor=监控告警）
-#   env    = 缺陷触达的环境（none=未触达任何运行环境，如仅静态检查发现）
-# 锚前存量不回填；新 open 件必填（生效锚随 B6b 归因检查落地）。
-incident.source.all=self user test monitor
-incident.env.all=dev staging prod none
-# 级别三档（2026-10-13 L0 退役自源仓收敛系列 1 回灌）：L1 = 一份 plan 即入口（协作道）；L2/L3 = 防御道。
-level.all=L1 L2 L3

package/templates/_agents/workflow-modules.txt

@@ -1,11 +0,0 @@
-# workflow 文档模块词表（单源：check-loop.sh 与 .agents/scripts/gen-workflow-index.mjs、kb-search.mjs 共读）
-# 用法：workflow/{intents,specs,plans,incidents} 文档 frontmatter `模块:` 取下列之一（单值，取主导模块；
-#       跨模块任务取承载任务意图的模块，检索面由 kb-search 全文兜住）。
-# 新建文档必填；check-loop 只警告不阻断。按项目模块自行改这张表（改后同步 workflow/README.md「文档协议」段说明）。
-backend
-frontend
-ui
-infra
-integration
-pipeline
-wiki

package/templates/_agents/workflows/_TEMPLATE.md

@@ -1,75 +0,0 @@
-# Workflow 编排机制 — 编排脚本 + steps 扩展点
-
-> kit 的跨宿主编排机制：`.agents/workflows/` 下的编排脚本承载编排语义（依赖分层 / 并行 / 重试 / gate / 用户确认门 / run journal），**宿主 AI 经 AGENTS.md 常驻指令自动加载并按语义执行**——有子智能体的宿主并行 fan-out，没有的顺序自做，验收不变。零宿主协议适配：机制只依赖所有宿主共有的四样本领（读 AGENTS.md、读仓库文件、跑终端命令、子智能体）。
-
-## 自动加载（AGENTS.md 常驻指令）
-
-> 多工作包编排——用户要跑编排、或 plan 执行多工作包时：读 `.agents/workflows/` 编排脚本按本文档语义执行；自定义步骤在 `steps/`。
-
-## 编排脚本（`.agents/workflows/<主题>.md`）
-
-frontmatter（`name` / `description` / `concurrency` 默认 2）+ 一张 stages 表（`human` 列可选——不用确认门的可省该列，保持 9 列）：
-
-```md
----
-name: 并行修两域
-description: 后端+前端并行实现 → 汇聚过测试 → 部署验证（step）→ 独立评审
-concurrency: 2
----
-| id | after | role | step | task / params | files（授权） | accept（验收判据） | gate | human | retries |
-|----|-------|------|------|---------------|--------------|-------------------|------|-------|---------|
-| backend | — | implementer | — | 实现后端 X | src/api/** | 项目测试过 | | | 1 |
-| frontend | — | implementer | — | 改前端 Y | web/** | 构建过 | | | 0 |
-| gate-all | backend,frontend | — | — | — | — | — | npm test | | |
-| confirm-deploy | gate-all | — | — | 用户对话内确认可上 staging | — | 一句「可以」 | | 用户确认 | |
-| deploy-check | confirm-deploy | — | 部署验证 | env=staging | | 部署命令 exit 0 | | | 0 |
-| review | deploy-check | independent-reviewer | — | 评审两域改动 | | 符合 plan 与判据 | | | 0 |
-```
-
-**stage 四形态**（互斥，恰填一项）：
-
-| 形态 | 判据 | 执行 |
-|------|------|------|
-| role 派单行 | `role` 非空 | 派子智能体（`task` 目标 / `files` 授权清单 / `accept` 验收判据写进派单头 + 红线行） |
-| step 行 | `step` 非空 | 宿主 AI 读 `steps/<step>.md` 按指引执行，`task / params` 列传参 |
-| gate 行 | `gate` 非空（role/step/human 空） | 终端跑命令，非零即中止 |
-| human 确认门行 | `human` 非空（其余形态列空） | 宿主 AI **停下向用户询问**（`task` 列 = 问什么、`accept` 列 = 通过判据），通过才派下层；驳回 → 中止汇总。**不派子智能体**（机器判据层面落实「子智能体不跨确认门」，取代早前 role 行伪装确认门的写法） |
-
-**编排语义**（执行口径，全宿主同一）：`after` 空 = 第 0 层；一层全 ok 才派依赖它的下一层；层内按 `concurrency` 分批——有子智能体的宿主并行 fan-out，没有的顺序自做（验收标准不变）；失败且 `retries` > 0 → 重派（全新上下文）；重试超限 / gate 非零 / human 驳回 → 中止后续、汇总报告失败项。human 行无重试语义（retries 视作 0）。
-
-**run journal**（断点续跑与重试计量）：每个 stage 每次尝试出结果（pass / fail / blocked）即记一行；中止后重跑先看 status——已 pass 的 stage 不重跑，从就绪层续：
-
-```bash
-node .agents/scripts/wf-journal.mjs add --wf <编排名> --stage <id> --status pass --form human   # fail/blocked 同式；--form ∈ role|step|gate|human
-node .agents/scripts/wf-journal.mjs status --wf <编排名>                                        # 已完成 / 就绪（含重试就绪×N）/ 待定
-```
-
-journal 落 `.agents/cache/orchestration-runs.jsonl`（本地运行态，可丢弃；同 run 同 stage 多行按末次生效，attempt 自动计次；`--new-run` 新起一轮）。
-
-## steps 扩展点（`.agents/workflows/steps/<名>.md`）
-
-kit 定义的扩展机制：文件名即步骤名（steps 目录即注册表），项目把自己的领域动作（部署 / 迁移 / 审计上报…）注册进来，编排脚本 step 行引用即用。
-
-```md
----
-params: env（目标环境）；timeout-min（可选，默认 10）
----
-# 步骤 — 部署验证
-
-1. 跑终端命令：`npm run deploy -- --env <env>`，非零即步骤失败并回报 stderr 尾段
-2. 跑冒烟检查：`curl -fsS https://<env>.example.com/healthz`
-3. 回报：部署版本号 + 冒烟结果
-```
-
-- frontmatter `params`：参数约定（自由文本列明名称与含义）；调用方在编排脚本 `task / params` 列传参（`k=v`，空格分隔多个）。
-- 正文：执行指引（编号步骤）——可指使命令、子智能体、检查动作；步骤失败按编排脚本行 `retries` 重试。
-
-## 纪律（先读）
-
-- **声明随 plan 确认后方可执行**：编排脚本是 plan 任务拆解的执行器，随 plan 草稿一并全文过目。
-- 子智能体不跨确认门、不 commit / push（派单红线行：只改授权文件；缺输入或需偏离 → `BLOCKER:` 停下）。确认门一律用 human 形态行表达，不得派子智能体代行。
-- 收敛复核：派单返回后核对 diff 与授权文件范围（与 build.md 委派约定同口径）；BLOCKER 停住待处置。
-- **run journal 三条**：① 每个 stage 每次尝试出结果即 `wf-journal.mjs add` 记一行（含重试与 human 门结论）；② 中止后重跑先 `status`——已 pass 不重跑，从就绪层续；③ 收尾可把本 run 的 status 汇总粘 `workflow/delegations.md` 留痕（聚合脚本不读 journal）。
-- **journal 是自报态，非验证态**：run journal 由执行者（宿主 AI）自己记——concurrency / retry / 断点续跑语义的保证取决于记账纪律，编排层无运行时派发器强制（wf-run 已废，执行按本机制文档语义）；中止续跑时对「已 pass」结论保留人工核对权（2026-09-27 audit-gate-hardening 边界声明）。
-- 留痕：每个派单 / step stage 完成后向 `workflow/delegations.md` 委派结果表追加一行（`一次通过` / `返工×N` / `返工待修`，口径与 agg-delegations.cjs 对齐）。
-- 解析校验先行（机器门）：`node .agents/scripts/workflows-check.mjs`——role ∈ `.agents/roles/`、step ∈ `steps/`、after 引用存在且无环、四形态恰填一项、retries/concurrency 数值合法；任一不过即拒，不执行。

package/templates/_agents/workflows/pipeline-closing.md

@@ -1,28 +0,0 @@
----
-name: pipeline-closing
-description: 推广环节 6 阶段闭环——起草 intent + plan（双写）→ 用户对话内确认 → 按 plan 改动面实施 → 2 关静态门（npm test / doctor）→ 关单留痕（intent + plan → done + docs commit）。可复用于本项目所有 L1 推广环节（新增工具 / 微改动 / 协议修补）
-concurrency: 2
----
-# workflow — pipeline-closing（推广环节 6 阶段闭环）
-
-> 把 5 个已闭环推广环节（E/A/D/C/F/B）的标准节奏固化为可复用编排。stage 用 role 派单 / gate 终端 / human 确认门三种形态——不引新 step（`_TEMPLATE.md` 解析校验要求 `step ∈ steps/`，新增 step 留给后续项目注册）。
-
-| id | after | role | step | task / params | files（授权） | accept（验收判据） | gate | human | retries |
-|----|-------|------|------|---------------|--------------|-------------------|------|-------|---------|
-| author | — | implementer | — | 起草 intent + plan（双写 fill-{intent,plan}.mjs 生成草稿 + AI 填实），状态 draft | workflow/intents/<date>-<topic>.md, workflow/plans/<date>-<topic>.md | intent frontmatter 6 字段齐（含 risk_level）+ 状态 draft + 验收标准 ≥ 5 条；plan L1 极简 2 节齐 | | | 1 |
-| gate-doc | author | — | — | — | — | — | node .agents/scripts/fill-intent.test.mjs && node .agents/scripts/fill-plan.test.mjs | | |
-| confirm | gate-doc | — | — | plan 草稿全文过目，用户对话内一句"可以" → plan 状态 draft → approved + 回填「确认与复核」节 | — | plan 状态 approved + 「确认结果：approved（YYYY-MM-DD 用户对话内确认）」 | | 用户确认（plan 确认门） | |
-| plan-commit | confirm | implementer | — | 提交 plan 立项 commit（docs(workflow)） | workflow/intents/, workflow/plans/, workflow/INDEX.md | pre-commit 钩子全过；commit message 含 plan 改动面摘要 | | | 0 |
-| build | plan-commit | implementer | — | 按 plan §改动面 执行 | 见 plan | plan 改动面全部完成 | | | 1 |
-| gate-test | build | — | — | — | — | — | npm test（必须全绿） | | |
-| gate-doctor | build | — | — | — | — | — | node bin/flow-kit.mjs doctor（必须 0 FAIL） | | |
-| feat-commit | gate-test,gate-doctor | implementer | — | 提交 feat commit（feat(模块名)） | 工作区所有变更文件 | pre-commit 钩子全过；commit message 含 build 改动面摘要 | | | 0 |
-| closeout | feat-commit | implementer | — | 补 intent 8 条验收勾验 + plan → done + 关单 docs commit 留痕；同步 INDEX.md（如适用） | workflow/intents/<date>-<topic>.md, workflow/plans/<date>-<topic>.md, workflow/INDEX.md | intent + plan 状态均 done；8 条验收勾验含 commit SHA 证据；commit message 含关单 commit + 8 条勾验摘要 | | | 0 |
-
-**编排语义**：第 0 层 author → 第 1 层 gate-doc + confirm（confirm 为 human 确认门形态——宿主 AI 停下询问用户，不派子智能体；通过才派下层）→ 第 2 层 plan-commit → 第 3 层 build → 第 4 层 2 关静态门（并行 fan-out）→ 第 5 层 feat-commit → 第 6 层 closeout。失败且 retries > 0 → 重派（全新上下文）；gate 非零 / human 驳回 → 中止后续、汇总报告失败项。每个 stage 每次尝试出结果记 `wf-journal.mjs add`；中止续跑先 `wf-journal.mjs status --wf pipeline-closing`（已 pass 不重跑）。
-
-**纪律**（先读）：
-- 声明随 plan 确认后方可执行——本 workflow 是 plan 任务拆解的执行器；plan 草稿先经用户对话内确认。
-- 子智能体不跨确认门、不 commit / push（派单红线行：只改授权文件；缺输入或需偏离 → `BLOCKER:` 停下）。确认门一律 human 形态行表达（confirm 行即此），不得派子智能体代行。
-- 留痕：每个派单 stage 完成后向 `workflow/delegations.md` 委派结果表追加一行（`一次通过` / `返工×N` / `返工待修`）。
-- 解析校验先行（机器门 `node .agents/scripts/workflows-check.mjs`）：role ∈ `.agents/roles/`、after 引用存在且无环、四形态恰填一项——任一不过即拒，不执行。

package/templates/_agents/workflows//347/244/272/344/276/213-/345/271/266/350/241/214/345/256/236/347/216/260/350/257/204/345/256/241.md

@@ -1,16 +0,0 @@
----
-name: 示例-并行实现评审
-description: 两域并行实现 → 汇聚过测试门 → 部署验证（step）→ 独立评审（示例，按 plan 改写后使用）
-concurrency: 2
----
-# workflow — 示例：并行实现评审
-
-> 格式示例：三形态各一处（role 派单 / gate / step）；id / after / task 按 plan 改写；随 plan 确认后方可执行。机制口径见 `_TEMPLATE.md`。
-
-| id | after | role | step | task / params | files（授权） | accept（验收判据） | gate | retries |
-|----|-------|------|------|---------------|--------------|-------------------|------|---------|
-| backend | — | implementer | — | 实现后端改动（示例占位，按 plan 改写） | src/api/** | 项目测试命令通过 | | 0 |
-| frontend | — | implementer | — | 实现前端改动（示例占位，按 plan 改写） | web/** | 项目构建命令通过 | | 0 |
-| gate-all | backend,frontend | — | — | — | — | — | npm test | |
-| deploy-check | gate-all | — | 示例-部署验证 | env=staging | | 部署命令与冒烟 exit 0 | | 0 |
-| review | deploy-check | independent-reviewer | — | 独立评审两域改动是否符合 plan 与验收判据 | | 符合 plan 与判据 | | 0 |

package/templates/_githooks/commit-msg

@@ -1,17 +0,0 @@
-#!/bin/sh
-# Git commit-msg hook：提交类型枚举校验（自 pre-commit 迁入，2026-09-18 papercut 升级修复）
-# AGENTS.md「git提交」：Conventional Commits 中文，feat/fix/docs/style/refactor/perf
-# 豁免仅限真实 merge/revert 形态：git 默认消息（Merge …/Revert …）与自定义小写 merge:/revert: 前缀。
-# 2026-09-24 收紧：不再匹配任意 merge/revert 开头（如 "merged xxx"），空首行不再豁免（fail-closed）。
-# $1 为 git 传入的本次消息文件（真实待提交内容）
-
-msg=$(head -1 "$1" 2>/dev/null)
-case "$msg" in
-  "Merge "*|"merge:"*|"Revert "*|"revert:"*) ;;
-  *)
-    if ! echo "$msg" | grep -qE "^(feat|fix|docs|style|refactor|perf)(\(|:|（)"; then
-      echo "commit-msg: 提交类型须为 feat/fix/docs/style/refactor/perf（AGENTS.md「git提交」），当前首行：$msg" >&2
-      exit 1
-    fi
-    ;;
-esac

package/templates/_githooks/post-commit

@@ -1,10 +0,0 @@
-#!/bin/sh
-# Git 原生 post-commit hook（经 core.hooksPath 挂载，git commit 后触发）
-# 非阻断缓存维护：把本次提交触及的 workflow/、wiki/ 文件从 kb-search 结构缓存
-#   （.agents/cache/kb-index.json）摘除，收敛 [mtimeMs,size] 两元组的
-#   「同刻同尺寸」失效盲区至提交时点。
-# 判据与设计：workflow/intents/2026-09-23-kb-cache-post-commit-evict.md
-# 失败绝不影响提交结果：post-commit 本身非阻断 + evict 脚本坏输入静默 exit 0 + 此处 || true 三重兜底。
-git diff-tree --no-commit-id --name-only -r HEAD \
-  | node .agents/scripts/kb-cache-evict.mjs 2>/dev/null || true
-exit 0

package/templates/_githooks/pre-commit

@@ -1,126 +0,0 @@
-#!/usr/bin/env node
-// Git 原生 pre-commit hook（经 core.hooksPath 挂载）— agentic-flow-kit 通用编排
-// 2026-10-13 门禁去 sh 化（B2，自 Shipyard.Material 参考实现回灌）：钩子体不再含 sh 逻辑——git 仍以自带
-// sh 启动本文件（钩子机制要求），但 shebang 即 node，PATH 无 sh 不再影响任何逻辑；语言单化后 CI 代理/
-// 本地行为一致。写法为 CommonJS——无扩展名文件 node 缺省按 CJS 解析，不依赖 ≥22.7 的 ESM 语法探测。
-// 通用门禁序：闭环配对(增量) → 泳道完整性(增量) → wiki 台账(增量) → 索引漂移(增量) → 常驻面体积预算(增量) → 确认台账不变量(暂存触台账) → 项目门禁(local-pre-commit) → 敏感信息扫描+条件构建(commit-check.cjs；2026-10-16 起常规提交 --no-build——条件构建后移 pre-push 按推送范围执法，合并提交仍 --full 全量构建)
-// 项目专属门禁（架构红线/业务守卫等）放 .agents/hooks/local-pre-commit——sh 挂载点（add-gate 生态按行接线），
-// 存在即在本钩子内以 sh（缺则 bash）执行，返回非零即阻断提交
-// 合并提交场景由 .githooks/pre-merge-commit 原样转发到本脚本（合并时 git 调的是 pre-merge-commit，
-// 不是 pre-commit）——门禁清单只此一份，避免两处分叉
-// fail-closed（沿 Shipyard 2026-10-09 口径；node 化后天然成立——本进程即 node）：门脚本缺失 = 拒提交；
-// 仅 local-pre-commit 保留「存在即执行」挂载点语义（缺失打 advisory）。
-const { spawnSync } = require('node:child_process');
-const fs = require('node:fs');
-
-const top = spawnSync('git', ['rev-parse', '--show-toplevel'], { encoding: 'utf8' });
-if (top.status !== 0 || !top.stdout.trim()) {
-  console.error('pre-commit: 无法定位仓库根（git rev-parse --show-toplevel 失败）——提交已阻止');
-  process.exit(1);
-}
-process.chdir(top.stdout.trim());
-
-// gate(label, script, args)：node 直跑门脚本，非零即阻断（含 fail-closed 缺失检查）
-const requireScript = (rel) => {
-  if (!fs.existsSync(rel)) {
-    console.error(`pre-commit: 门脚本缺失 ${rel}——提交已阻止（脚本随包下发；flow-kit sync 恢复后重试）`);
-    process.exit(1);
-  }
-};
-const gate = (label, script, args = []) => {
-  requireScript(script);
-  const r = spawnSync(process.execPath, [script, ...args], { stdio: 'inherit' });
-  if (r.status !== 0) {
-    console.error(`pre-commit: ${label} 未通过，提交已阻止`);
-    process.exit(r.status === null ? 1 : r.status);
-  }
-};
-
-// 闭环配对门禁（增量版，check-pairing-incremental.mjs：本次暂存的 intents/incidents 入口须已有同名 plan；
-// L2/L3 另须同名 spec）。experiment/* 泳道分支（2026-09-30 hybrid-governance-explore-hardening）：
-// 降级为 advisory——快速 PoC 迭代不因闭环文档断档被拦（断档报告照出），转正合入 main 由 pre-push
-// 加固门（check-loop --hardening）兜底。仅降级闭环文档面：常驻面 / 台账 / 敏感信息扫描等门禁不豁免。
-// 分支不可判（detached HEAD 等）走严格模式。
-const branch = spawnSync('git', ['rev-parse', '--abbrev-ref', 'HEAD'], { encoding: 'utf8' });
-const branchName = branch.status === 0 ? branch.stdout.trim() : '';
-if (branchName.startsWith('experiment/')) {
-  console.error('pre-commit: experiment/* 泳道分支——闭环配对门禁降级为 advisory（报告不阻断；转正入 main 须过加固门）');
-  const adv = spawnSync(process.execPath, ['.agents/hooks/check-pairing-incremental.mjs'], { stdio: 'inherit' });
-  if (adv.status !== 0) console.error('pre-commit: （advisory）闭环配对断档已在上方列出——experiment 泳道不阻断提交');
-} else {
-  gate('闭环配对（增量）', '.agents/hooks/check-pairing-incremental.mjs');
-}
-
-// 泳道完整性（增量，check-lane-surface.mjs——2026-10-01 drift-hardening）：
-//   检查 A「触达面判低」——暂存命中项目 L2 触达面（.agents/lane-surfaces.txt，ERE 逐行；缺失/空=跳过，
-//   装户无感）且活跃入口（draft/approved / open/fixed）全为 L0/L1 → 拦；有活跃 L2/L3 → 放行；无活跃入口 →
-//   仅 advisory（docs/bootstrap 豁免类）。experiment/* 分支降级 advisory（转正由 pre-push 加固门兜底）。
-//   检查 B「探索标记缺失」——experiment/* 分支暂存 intent 缺「阶段: exploring」→ 拦（标记零成本，
-//   advisory 免纪律不免标记——标记是加固门覆盖率的前提）。
-//   脚本缺失 fail-closed 阻断（见 gate()）。
-//   `git merge` 自动提交由 pre-merge-commit 传入 `--merge`（此时 MERGE_HEAD 已不可靠，不能靠探测）；
-//   冲突解决后的手动 `git commit` 仍由脚本自己看 MERGE_HEAD（2026-10-16 自源仓回灌）。
-const mergeCommit = process.argv.includes('--merge');
-gate('泳道完整性（增量）', '.agents/scripts/check-lane-surface.mjs', mergeCommit ? ['--merge'] : []);
-
-// wiki 台账门禁（增量，check-wiki-ledger.mjs：暂存区触及 wiki/ 时跑 verify-wiki-consistency 三方一致性；
-// 无 wiki/ 变更即跳过。脚本缺失 fail-closed）
-gate('wiki 台账（增量）', '.agents/hooks/check-wiki-ledger.mjs');
-
-// 索引漂移（增量硬拦，check-index-incremental.mjs）：暂存触及 workflow 四目录 / 归档 / INDEX.md 时，
-// gen-workflow-index.mjs --check 不一致即拒。卫生段检查 11 仍是 WARN，挡不住关单提交。
-// 未触及这些路径则脚本内跳过。脚本缺失 fail-closed。
-gate('索引漂移（增量）', '.agents/hooks/check-index-incremental.mjs');
-
-// 常驻面体积预算（增量硬拦，rule-budget.mjs --staged：只查本次暂存触及的条目与触及目录的合计；
-// 超限即阻断——常驻面只增不减，须先删除或下沉一条被取代条目再增。预算登记表缺失同样 fail-closed）
-requireScript('.agents/rule-budgets.txt');
-gate('常驻面体积预算', '.agents/scripts/rule-budget.mjs', ['--staged']);
-
-// 确认台账不变量前置（--staged，2026-10-02 ledger-ci-invariant）：暂存的 confirmations.jsonl 与分片
-// confirmations.d/*.jsonl（2026-10-13 ledger-shard-default 起分片为默认写入口径，触发面同步扩大）必须
-// 是 HEAD 的逐字节前缀扩展（append-only）——本地提交时刻即拦「顺手重写台账」，CI 历史全扫兜底。
-// 暂存未触台账静默；触台账而脚本缺失 fail-closed 阻断。
-const staged = spawnSync('git', ['-c', 'core.quotepath=off', 'diff', '--cached', '--name-only'], { encoding: 'utf8' });
-const stagedFiles = String(staged.stdout || '').split(/\r?\n/).filter(Boolean).map((f) => f.replace(/\\/g, '/'));
-const touchesLedger = stagedFiles.some((f) => /^\.agents\/confirmations\.jsonl$|^\.agents\/confirmations\.d\/[^/]+\.jsonl$/.test(f));
-if (touchesLedger) {
-  requireScript('.agents/scripts/check-ledger-invariant.mjs');
-  const li = spawnSync(process.execPath, ['.agents/scripts/check-ledger-invariant.mjs', '--staged'], { stdio: 'inherit' });
-  if (li.status !== 0) {
-    console.error('pre-commit: 确认台账不变量未通过，提交已阻止——历史行禁删改（append-only），修正走追加补偿行');
-    process.exit(li.status === null ? 1 : li.status);
-  }
-}
-
-// 项目门禁挂载点：.agents/hooks/local-pre-commit（项目自建门禁/门禁模块接线处，add-gate 生态往里写行）。
-// 保持 sh 形态：以 sh（缺则 bash）执行；存在即执行、缺失打 advisory 不阻断（挂载点可选语义），
-// 但缺失不再无声——该文件随包下发，advisory 即误删信号。
-if (fs.existsSync('.agents/hooks/local-pre-commit')) {
-  const shBin = spawnSync('sh', ['-c', 'true']).status === 0 ? 'sh' : 'bash';
-  const lp = spawnSync(shBin, ['.agents/hooks/local-pre-commit'], { stdio: 'inherit' });
-  if (lp.status !== 0) {
-    console.error('pre-commit: 项目门禁（local-pre-commit）未通过，提交已阻止');
-    process.exit(lp.status === null ? 1 : lp.status);
-  }
-} else {
-  console.error('pre-commit: （advisory）项目门禁挂载点 .agents/hooks/local-pre-commit 不在场——add-gate 接线处随包下发，若为误删请 flow-kit sync 恢复');
-}
-
-// 合并提交 → 构建验证覆盖【完整合并树】，不做按扩展名的条件裁剪。
-// 常规提交 --no-build（2026-10-16 构建门后移 pre-push，自源仓回灌）：提交内环只跑敏感扫描，条件构建在
-// 推送时按 old..new 范围执法（.githooks/pre-push）；合并结果是没人验证过的新状态，仍全量构建。
-// 两条路径：`git merge` 自动提交由 .githooks/pre-merge-commit 显式传 `--full` 转发到本脚本；
-// 冲突解决后手动 `git commit` 由 git 直接调本脚本，此处按 MERGE_HEAD 探测补上（此时合并仍在进行）。
-let fullArgs = process.argv.slice(2).filter((a) => a !== '--merge');
-if (fullArgs.length === 0) {
-  const mergeHead = spawnSync('git', ['rev-parse', '-q', '--verify', 'MERGE_HEAD'], { encoding: 'utf8' });
-  fullArgs = mergeHead.status === 0 ? ['--full'] : ['--no-build'];
-}
-
-const cc = spawnSync(process.execPath, ['.agents/hooks/commit-check.cjs', ...fullArgs], { stdio: 'inherit' });
-if (cc.status !== 0) {
-  console.error('pre-commit: 验证未通过，提交已阻止');
-  process.exit(cc.status === null ? 1 : cc.status);
-}
-process.exit(0);

package/templates/_githooks/pre-merge-commit

@@ -1,29 +0,0 @@
-#!/usr/bin/env node
-// Git 原生 pre-merge-commit hook（经 core.hooksPath 挂载；2026-10-13 随 pre-commit node 化（B2）改为 node 转发
-// ——转发不再经 sh。CommonJS——无扩展名文件 node 缺省按 CJS 解析，不依赖 ESM 语法探测）
-//
-// 背景：git 对 `git merge` 调的是**本钩子**，不是 pre-commit。此前仓库只挂了
-// pre-commit / pre-push / commit-msg，故合并提交绕过全部门禁、未经任何校验直接落库
-// （2026-09-19 实测，见 workflow/papercuts.md 同日行——那次合并带入后端 .cs 改动，
-// 靠人工补跑静态门 + 全量测试才覆盖到）。
-//
-// 做法：转发到 .githooks/pre-commit（门禁清单只此一份，避免两份拷贝日后分叉），
-// 并显式传 `--full` 与 `--merge`——本钩子「只对 merge 触发」这一身份就是最强信号，无需再去探测
-// MERGE_HEAD（2026-09-19 实测：本时点 MERGE_HEAD 已不可靠）。`--full` 令编译验证
-// 覆盖【完整合并树】、不按扩展名的条件裁剪：合并结果是没人验证过的新状态，且其 diff
-// 相对第一父，裁剪会漏掉需要重跑的一侧。`--merge` 令泳道检查 A 跳过（2026-10-16 自源仓回灌：
-// 同窗口 MERGE_HEAD 已不在，已关单产品路径会被误判「触达面判低」）。
-//
-// 冲突解决后手动 `git commit` 走的是 pre-commit 自身，那条路径由 pre-commit 内部的
-// MERGE_HEAD 探测覆盖（此时合并仍在进行，MERGE_HEAD 确定存在）。
-const { spawnSync } = require('node:child_process');
-const path = require('node:path');
-
-const top = spawnSync('git', ['rev-parse', '--show-toplevel'], { encoding: 'utf8' });
-if (top.status !== 0 || !top.stdout.trim()) {
-  console.error('pre-merge-commit: 无法定位仓库根——合并提交已阻止');
-  process.exit(1);
-}
-const hook = path.join(top.stdout.trim(), '.githooks', 'pre-commit');
-const r = spawnSync(process.execPath, [hook, '--full', '--merge'], { stdio: 'inherit' });
-process.exit(r.status === null ? 1 : r.status);

package/templates/_githooks/pre-push

@@ -1,136 +0,0 @@
-#!/usr/bin/env node
-// Git 原生 pre-push hook（经 core.hooksPath 挂载，git push 时触发）— agentic-flow-kit 通用编排
-// 2026-10-16 node 化（自源仓 2ff869a9/13f67ef7 回灌 pre-push 面）：钩子体不再含 sh 逻辑——git 仍以自带
-// sh 启动本文件（钩子机制要求），但 shebang 即 node，PATH 无 sh 不影响任何逻辑。写法为 CommonJS——
-// 无扩展名文件 node 缺省按 CJS 解析，不依赖 ≥22.7 的 ESM 语法探测。
-// 跑 .agents/scripts/check-loop.mjs：扫 workflow/ 闭环骨架断档（默认只扫硬门）
-//   - 硬阻断（exit 1）= 配对断裂 / 回路断档 / 证据与确认链 / 发版未收口 → push 立即阻断
-//   - 卫生段（模板占位 / 引用漂移 / 宿主副本 / 索引）不在本钩子。要看时跑 --hygiene 或 --all
-// stdin 有行时，每个非删除的本地 sha 用 --rev 扫那棵树。没有行时（手跑钩子）仍无参数扫工作区。
-//
-// 构建门（2026-10-16 自 pre-commit 后移）：另跑 commit-check.cjs --range <old> <new> 按推送范围条件构建
-// （常规提交时刻只做敏感扫描——提交内环提速；构建执法集中到推送与关单）。范围匹配逻辑单源 =
-// commit-check.cjs。experiment/* 目标降级 advisory。手动运行（无 stdin 推送行）无范围事实，构建门跳过。
-//
-// experiment/* 泳道：**目标分支**为 experiment/* 时，闭环扫描与构建门降级 advisory（报告不阻断）——
-// 快速 PoC 推送不因闭环断档/构建失败被拦；转正（目标为 main）由加固门兜底。
-// 加固门（2026-10-01 v09-review-defects）：推送**目标**为 refs/heads/main 时以 --hardening 运行
-// （无论来源分支——experiment/* 直推 main 同样覆盖），exploring 任务须先收口（intent approved/done +
-// 同名 plan 在场 + L2/L3 另须同名 spec；判据见 check-loop.mjs 加固门段），hard 失败即阻断 push。
-//
-// 回路日检（2026-10-16 自源仓 13f67ef7 回灌）：退役催办与 papercut 报债此前无调度，机制空转。每个
-// 本地日在推送成功路径跑一次，advisory，失败不改退出码。摘要落 .agents/cache/loop-watch.jsonl（gitignore）。
-//
-// 机器门：本地钩子跑 check-loop.mjs。装户仓的远端门是随包下发的 .github/workflows/kit-ci.yml（verify.mjs）。
-// kit 源仓：.github/workflows/ci.yml 于 push main / 全部 PR 跑 npm test（lint + 全量套件）。
-// 不要用 `git push --no-verify` 绕开——发现 hard-block 应先修 workflow 文档再推。
-const { spawnSync } = require('node:child_process');
-const fs = require('node:fs');
-
-const top = spawnSync('git', ['rev-parse', '--show-toplevel'], { encoding: 'utf8' });
-if (top.status !== 0 || !top.stdout.trim()) {
-  console.error('pre-push: 无法定位仓库根——推送已阻止');
-  process.exit(1);
-}
-process.chdir(top.stdout.trim());
-
-const LOOP = '.agents/scripts/check-loop.mjs';
-if (!fs.existsSync(LOOP)) {
-  console.error(`pre-push: 未找到 ${LOOP}——闭环扫描无法执行，推送已阻止（脚本随包下发；flow-kit sync 恢复后重试）`);
-  process.exit(1);
-}
-// 构建门脚本（2026-10-16 自 pre-commit 后移）：缺失 fail-closed
-const BUILD_CHECK = '.agents/hooks/commit-check.cjs';
-if (!fs.existsSync(BUILD_CHECK)) {
-  console.error(`pre-push: 未找到 ${BUILD_CHECK}——构建门无法执行，推送已阻止（脚本随包下发；git checkout -- ${BUILD_CHECK} 恢复后重试）`);
-  process.exit(1);
-}
-
-const runLoop = (args = []) => spawnSync(process.execPath, [LOOP, ...args], { stdio: 'inherit' });
-// 范围参数：远端全零 sha（新分支首推）→ 全量构建语义（commit-check 认全零 old）
-const rangeArgsOf = (remoteSha, localSha) => ['--range', remoteSha && !/^0+$/.test(remoteSha) ? remoteSha : '0'.repeat(40), localSha];
-
-let stdinText = '';
-try { stdinText = fs.readFileSync(0, 'utf8'); } catch { stdinText = ''; }
-
-let saw = 0;
-let rc = 0;
-for (const line of stdinText.split(/\r?\n/)) {
-  if (!line.trim()) continue;
-  const parts = line.trim().split(/\s+/);
-  if (parts.length < 4) continue;
-  const [localRef, localSha, remoteRef, remoteSha] = parts;
-  saw = 1;
-  if (/^0+$/.test(localSha)) continue; // 删除推送不扫
-  // 按目标分支分派（判定键 = remote_ref）：
-  // main → 加固门（必带 --hardening）；experiment/* → advisory（报告不阻断）；其他 → 全量扫描（硬门）
-  if (/^refs\/heads\/main$|^main$/.test(remoteRef)) {
-    const r = runLoop(['--rev', localSha, '--hardening']);
-    if (r.status !== 0 && rc === 0) rc = r.status === null ? 1 : r.status;
-    const rb = spawnSync(process.execPath, [BUILD_CHECK, ...rangeArgsOf(remoteSha, localSha)], { stdio: 'inherit' });
-    if (rb.status !== 0 && rc === 0) rc = rb.status === null ? 1 : rb.status;
-  } else if (/^refs\/heads\/experiment\/|^experiment\//.test(remoteRef)) {
-    console.error(`pre-push: experiment/* 目标分支（${remoteRef}）——闭环扫描与构建门降级 advisory，不阻断`);
-    const adv = spawnSync(process.execPath, [LOOP, '--rev', localSha], { stdio: 'inherit' });
-    if (adv.status !== 0) console.error('pre-push: （advisory）闭环断档已在上方列出——experiment 泳道可推送，转正（推 main）须过加固门');
-    const advB = spawnSync(process.execPath, [BUILD_CHECK, ...rangeArgsOf(remoteSha, localSha)], { stdio: 'inherit' });
-    if (advB.status !== 0) console.error('pre-push: （advisory）构建门未过已在上方列出——experiment 泳道不阻断推送');
-  } else {
-    const r = runLoop(['--rev', localSha]);
-    if (r.status !== 0 && rc === 0) rc = r.status === null ? 1 : r.status;
-    const rb = spawnSync(process.execPath, [BUILD_CHECK, ...rangeArgsOf(remoteSha, localSha)], { stdio: 'inherit' });
-    if (rb.status !== 0 && rc === 0) rc = rb.status === null ? 1 : rb.status;
-  }
-}
-
-if (saw === 0) {
-  const r = runLoop();
-  if (r.status !== 0) rc = r.status === null ? 1 : r.status;
-  console.error('pre-push: 手动运行无推送范围——构建门跳过（真实推送时按 old..new 范围执法）');
-}
-
-if (rc !== 0) {
-  console.error('pre-push: 闭环骨架断档 / 构建未过（hard-block）未通过，push 已阻断。修 workflow 文档 / 构建错误后重推——不要用 --no-verify 绕过（本钩子是唯一机器门，无服务端兜底，见头部说明）');
-  console.error('pre-push: 若为「加固未过」= experiment 泳道件转正前须收口：intent approved/done + 同名 plan（L2/L3 另须 spec）且状态非 draft');
-  process.exit(rc);
-}
-
-// 回路日检（2026-10-16 自源仓 13f67ef7 回灌）：每个本地日在推送成功路径跑一次，advisory，失败不改退出码。
-try {
-  const cacheDir = '.agents/cache';
-  const stampPath = `${cacheDir}/loop-watch-stamp`;
-  const ledgerPath = `${cacheDir}/loop-watch.jsonl`;
-  const now = new Date();
-  const today = `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}-${String(now.getDate()).padStart(2, '0')}`;
-  let prev = '';
-  try { prev = fs.readFileSync(stampPath, 'utf8').trim(); } catch { /* 首跑 */ }
-  if (prev !== today) {
-    fs.mkdirSync(cacheDir, { recursive: true });
-    // 退役催办：mechanism-retire-watch（--json 产 actions）；papercut 报债：kit 复用 sensor --json 取 debt
-    const jobs = [
-      ['retire-watch', '.agents/scripts/mechanism-retire-watch.mjs'],
-      ['papercut-report', '.agents/scripts/papercut-debt-sensor.mjs'],
-    ];
-    const runs = [];
-    for (const [id, script] of jobs) {
-      if (!fs.existsSync(script)) { runs.push({ id, missing: true }); continue; }
-      const r = spawnSync(process.execPath, [script, '--json'], { encoding: 'utf8', maxBuffer: 8 * 1024 * 1024 });
-      let summary = {};
-      try { summary = JSON.parse(r.stdout || '{}'); } catch { summary = { parseError: true }; }
-      runs.push({
-        id,
-        exit: r.status,
-        actions: Array.isArray(summary.actions) ? summary.actions.length : null,
-        debt: typeof summary.debt === 'number' ? summary.debt : null,
-      });
-    }
-    fs.appendFileSync(ledgerPath, `${JSON.stringify({ ts: now.toISOString(), day: today, runs })}\n`);
-    fs.writeFileSync(stampPath, `${today}\n`);
-    const retire = runs.find((x) => x.id === 'retire-watch');
-    const paper = runs.find((x) => x.id === 'papercut-report');
-    console.error(`pre-push: （advisory）回路日检已记 ${ledgerPath}（退役动作 ${retire && retire.actions != null ? retire.actions : '?'}，papercut debt ${paper && paper.debt != null ? paper.debt : '?'}）`);
-  }
-} catch (e) {
-  console.error(`pre-push: （advisory）回路日检跳过——${e.message}`);
-}
-process.exit(0);