agentic-flow-kit 0.9.0 → 0.9.1

package/README.md

@@ -1,93 +1,93 @@
-# agentic-flow-kit
-
-AI-Native 闭环工作流 + wiki 知识层脚手架。`flow-kit init` 一条命令为新项目装好整套项目级 AI 工作流引擎：8 个阶段命令、3 个子智能体角色契约、git 门禁钩子（闭环配对 / 敏感信息扫描 / 条件构建 / 规则面预算）、kb 跨语料检索、workflow 实时看板、intents→specs→plans→incidents 文档闭环、wiki 知识库三件套。
-
-**装完即自包含**：引擎文件拷贝进项目（零 npm 运行时依赖，Node ≥ 18 即可跑），clone 后只差 `git config core.hooksPath .githooks`——init 会自动挂好。
-
-## English
-
-agentic-flow-kit installs a self-contained AI workflow into a repository: stage commands, role contracts, git hooks, and an intent → spec → plan → incident trail. After `init`, the project does not need this package at runtime. Node ≥ 18 is enough.
-
-The product is the hook, not another prompt pack. Five rules always block a bad push: paired docs, checked acceptance, a confirmation ledger, secret scanning, and the managed/owned ledger. Other hygiene checks are warnings, and a fresh install sets `audit: false` so only those five stay in the way. Omit `audit` on an older ledger and the full check set stays on.
-
-Hosts: `zcode`, `opencode`, `trae`, `omp`, `claude`, `cursor`, `codex`. Claude Code loads `.claude/commands` and `.claude/agents`. Cursor loads `.cursor/commands`. Codex reads the repo `AGENTS.md` and `.codex/skills/flow-kit`; the `.codex/commands` files are the same thin forwards for explicit reference.
-
-```bash
-npx agentic-flow-kit init --stack node --hosts claude,cursor
-npx agentic-flow-kit doctor
-```
-
-## 60 秒路径
-
-```bash
-npx agentic-flow-kit init --stack node --hosts claude
-# 按 .agents/commands/plan.md 写一份 L1 intent 与同名 plan（状态先保持 draft）
-node .agents/scripts/confirm-doc.mjs workflow/intents/<文件>.md   # 终端里键入「可以」
-# 改代码，git add，然后提交。配对没齐、验收没勾、确认指纹对不上，钩子会拒绝这次提交。
-```
-
-## 五条硬规则
-
-新装的 `kit.json` 写 `audit: false` 与 `policyVersion: 2`：check-loop 只阻断配对、验收勾验、确认留痕，外加发版提交树上仍未收口的文档。敏感信息在 pre-commit，双源和台账在 doctor / sync。`audit` 缺省（升级来的旧台账）保持全量卫生警告。本仓库显式 `audit: true`。豁免日期只在 `.agents/scripts/policy.mjs` 的 `policyVersion` 表里改。
-
-可选红线用 `add-gate`：`dotnet-ca`、`node-layer`、`py-import`、`generated-readonly`。约定见 `modules/gates/README.md`。
-
-## 快速开始
-
-```bash
-cd <你的项目根>
-npx agentic-flow-kit init                        # 交互模式：宿主 → 技术栈 → 端口 → 显式确认安装
-# 或直接给参数
-npx agentic-flow-kit init --stack node --hosts zcode,opencode
-
-# 体检（布局 / git 钩子 / managed 台账 / 索引漂移 / check-loop）
-npx agentic-flow-kit doctor
-
-# 包出新版后升级（未改动→覆盖；本地已改→跳过并报告，--force 才覆盖；owned 永不触碰）
-npx agentic-flow-kit sync
-
-# 后补宿主 / 装门禁（dotnet-ca：Clean Architecture 红线守卫，装后归项目）
-npx agentic-flow-kit add-host opencode
-npx agentic-flow-kit add-gate dotnet-ca
-```
-
-| 选项 | 说明 |
-|------|------|
-| `--stack` | `dotnet` / `node` / `python` / `go` / `none`（默认 none）——**门禁配置三处**：commit-check 条件编译检查（暂存对应扩展名时 commit 前自动构建）+ **质量检测**（`checks`：lint / 类型检查 / vet 等秒级确定性检查，存在对应配置文件（tsconfig / eslint / ruff / go.mod 等）才启用，没有则自动跳过；测试不放提交门——关单在 test.md 阶段门）、settings.json 自检验命令权限、AGENTS.md「项目适配区」命令预填 |
-| `--hosts` | `zcode` / `opencode` / `trae` / `omp` / `claude` / `cursor` / `codex` 逗号多选（默认 zcode）。zcode/omp 为本地配置，自动进 .gitignore。Claude Code 加载 `.claude/commands` 与 `.claude/agents`；Cursor 加载 `.cursor/commands`；Codex 读仓库根 `AGENTS.md` 与 `.codex/skills/`，`.codex/commands` 是同形薄转发 |
-| `--board-port` | workflow 看板端口（默认 8933） |
-| `--dir` | 目标项目根（默认当前目录） |
-| `--force` | 覆盖已存在的同名文件（默认保守跳过） |
-
-init 不问项目名 / 描述：`AGENTS.md` 只生成「AI工作流 + Wiki」两章骨架 + 「项目适配区」；技术栈经 `--stack` 传入只用于门禁配置（编译检查与自检验命令初值），密钥白名单等其余细节在 `.agents/hooks/commit-check.config.json` 里按项目填。
-
-## 装了什么
-
-```
-.agents/            阶段命令×8 / 角色契约×3 / 门禁钩子 / 引擎脚本（检索·索引·看板·预算·聚合）/ 技能×2 / settings.json / kit.json 台账
-.githooks/          pre-commit（通用门禁编排+项目门禁挂载点）/ pre-push（闭环断档）/ commit-msg / post-commit / pre-merge-commit
-workflow/           intents/specs/plans/incidents 模板×4 + README 协议 + 台账三件（delegations/papercuts/regression-checklist）
-wiki/               INDEX 骨架 + 知识沉淀总览 + drafts-archive
-AGENTS.md           项目规范骨架（项目段占位待填）
-modules/gates/      可选门禁模块（dotnet-ca：Clean Architecture 参考实现，装进项目后归项目）
-```
-
-**两态文件模型**：`.agents/kit.json` 记录 managed（引擎件，随包升级）与 owned（项目内容，永不覆盖）清单及 sha256；`doctor` 会校验漂移。已存在的文件 init 保守跳过（`--force` 覆盖）。
-
-**升级语义（sync）**：managed 文件三方比对（台账 sha / 磁盘 sha / 新版渲染 sha）——未改动 → 直接覆盖新版；本地已改 → 跳过并报告（`--force` 才覆盖，git diff 自查差异；跳过件的台账保持包侧基线，后续每次 sync 持续报告，不会在下次升级被静默覆盖——消除报告的办法：`--force` 覆盖，或把本地内容改回与新版一致）；改动恰好等于新版 → 视为已最新。包内新增文件自动安装；包内已删文件仅报告不删盘；缺失的 managed 文件自动恢复。INDEX / wiki 看板等生成器目标不比对 sha，收尾重跑生成器走锚点重写。门禁模块（add-gate 装入）归项目所有，sync 永不覆盖。add-host 对已存在的宿主文件保守跳过且不入台账——后续 sync 不升级（仅报告「已存在未入台账」），要纳入包管理用 `--force` 覆盖。owned 件归项目所有、sync 永不覆盖；其台账哈希仅记账不约束，sync 每次按盘面自愈刷新（手改后无须手工对账），add-gate 接线 local-pre-commit 后同步刷新其记账。
-
-## 设计原则
-
-- **权威单源**：角色行为只在 `.agents/roles/`，流程只在 `.agents/commands/`，宿主适配层是纯转发薄层——换宿主不换流程。
-- **门禁即 git 钩子**：不依赖任何 agent 客户端自觉；项目专属门禁挂 `.agents/hooks/local-pre-commit`。
-- **中文优先**：文档协议、命令、检查输出全中文；frontmatter 受限子集供机器断言。
-- 抽取自真实项目长期运转的引擎（某真实项目），dogfooding 是后续路线（sync 升级 / add-host / add-gate / npm 发布）的一部分。
-- **威胁模型（2026-09-27 init-p1-batch）**：勿在不可信仓库运行 `init` / `doctor` / `sync`——三命令在执行目标侧 `.agents/scripts/` 脚本（生成器 / 校验器）前有供应链防线：脚本内容与包源渲染值（LF 归一 sha）一致才执行，失配即显式跳过提示，不执行不下结论。**防线不覆盖 git 钩子面**：预植的 `.githooks/`、`.agents/hooks/` 仍会被保留挂载，并在你自己的首次 git 操作时执行——不可信仓库请先审查/清除预置件再 init。
-
-## 当前能力（已发布 0.8.0）
-
-版本沿革写在 `CHANGELOG.md`。0.8.0 已包含：init / doctor / sync / add-host / add-gate、四套技术栈门禁初值、宿主薄适配、确认门、check-loop 16 项、看板端口上探、opencode 命令 `wf-` 前缀、pre-commit managed 台账快检。
-
-仓库里还没打进版本号的增量：`audit` 档（新装默认 false）、`policyVersion`、检查 17（发版树上的未收口文档）、检查 18（委派台账对账）、检查 19（逐阶段审计）、逐阶段前置门（起草门 / 确认门 / done 前置门）、claude / cursor / codex 薄适配、`node-layer` / `py-import` / `generated-readonly` 三个可选门禁、fresh init 冒烟。效果数字等有外部仓库跑过再记，不在这次。
-
-活跃层里 2026-09-23 至 09-28 的 approved / open 文档没有在这次改成 done 或 closed。那些文件的确认指纹绑着当时的正文，关单要逐份 `confirm-doc`。
+# agentic-flow-kit
+
+AI-Native 闭环工作流 + wiki 知识层脚手架。`flow-kit init` 一条命令为新项目装好整套项目级 AI 工作流引擎：8 个阶段命令、3 个子智能体角色契约、git 门禁钩子（闭环配对 / 敏感信息扫描 / 条件构建 / 规则面预算）、kb 跨语料检索、workflow 实时看板、intents→specs→plans→incidents 文档闭环、wiki 知识库三件套。
+
+**装完即自包含**：引擎文件拷贝进项目（零 npm 运行时依赖，Node ≥ 18 即可跑），clone 后只差 `git config core.hooksPath .githooks`——init 会自动挂好。
+
+## English
+
+agentic-flow-kit installs a self-contained AI workflow into a repository: stage commands, role contracts, git hooks, and an intent → spec → plan → incident trail. After `init`, the project does not need this package at runtime. Node ≥ 18 is enough.
+
+The product is the hook, not another prompt pack. Five rules always block a bad push: paired docs, checked acceptance, a confirmation ledger, secret scanning, and the managed/owned ledger. Other hygiene checks are warnings, and a fresh install sets `audit: false` so only those five stay in the way. Omit `audit` on an older ledger and the full check set stays on.
+
+Hosts: `zcode`, `opencode`, `trae`, `omp`, `claude`, `cursor`, `codex`. Claude Code loads `.claude/commands` and `.claude/agents`. Cursor loads `.cursor/commands`. Codex reads the repo `AGENTS.md` and `.codex/skills/flow-kit`; the `.codex/commands` files are the same thin forwards for explicit reference.
+
+```bash
+npx agentic-flow-kit init --stack node --hosts claude,cursor
+npx agentic-flow-kit doctor
+```
+
+## 60 秒路径
+
+```bash
+npx agentic-flow-kit init --stack node --hosts claude
+# 按 .agents/commands/plan.md 写一份 L1 intent 与同名 plan（状态先保持 draft）
+node .agents/scripts/confirm-doc.mjs workflow/intents/<文件>.md   # 终端里键入「可以」
+# 改代码，git add，然后提交。配对没齐、验收没勾、确认指纹对不上，钩子会拒绝这次提交。
+```
+
+## 五条硬规则
+
+新装的 `kit.json` 写 `audit: false` 与 `policyVersion: 2`：check-loop 只阻断配对、验收勾验、确认留痕，外加发版提交树上仍未收口的文档。敏感信息在 pre-commit，双源和台账在 doctor / sync。`audit` 缺省（升级来的旧台账）保持全量卫生警告。本仓库显式 `audit: true`。豁免日期只在 `.agents/scripts/policy.mjs` 的 `policyVersion` 表里改。
+
+可选红线用 `add-gate`：`dotnet-ca`、`node-layer`、`py-import`、`generated-readonly`。约定见 `modules/gates/README.md`。
+
+## 快速开始
+
+```bash
+cd <你的项目根>
+npx agentic-flow-kit init                        # 交互模式：宿主 → 技术栈 → 端口 → 显式确认安装
+# 或直接给参数
+npx agentic-flow-kit init --stack node --hosts zcode,opencode
+
+# 体检（布局 / git 钩子 / managed 台账 / 索引漂移 / check-loop）
+npx agentic-flow-kit doctor
+
+# 包出新版后升级（未改动→覆盖；本地已改→跳过并报告，--force 才覆盖；owned 永不触碰）
+npx agentic-flow-kit sync
+
+# 后补宿主 / 装门禁（dotnet-ca：Clean Architecture 红线守卫，装后归项目）
+npx agentic-flow-kit add-host opencode
+npx agentic-flow-kit add-gate dotnet-ca
+```
+
+| 选项 | 说明 |
+|------|------|
+| `--stack` | `dotnet` / `node` / `python` / `go` / `none`（默认 none）——**门禁配置三处**：commit-check 条件编译检查（暂存对应扩展名时 commit 前自动构建）+ **质量检测**（`checks`：lint / 类型检查 / vet 等秒级确定性检查，存在对应配置文件（tsconfig / eslint / ruff / go.mod 等）才启用，没有则自动跳过；测试不放提交门——关单在 test.md 阶段门）、settings.json 自检验命令权限、AGENTS.md「项目适配区」命令预填 |
+| `--hosts` | `zcode` / `opencode` / `trae` / `omp` / `claude` / `cursor` / `codex` 逗号多选（默认 zcode）。zcode/omp 为本地配置，自动进 .gitignore。Claude Code 加载 `.claude/commands` 与 `.claude/agents`；Cursor 加载 `.cursor/commands`；Codex 读仓库根 `AGENTS.md` 与 `.codex/skills/`，`.codex/commands` 是同形薄转发 |
+| `--board-port` | workflow 看板端口（默认 8933） |
+| `--dir` | 目标项目根（默认当前目录） |
+| `--force` | 覆盖已存在的同名文件（默认保守跳过） |
+
+init 不问项目名 / 描述：`AGENTS.md` 只生成「AI工作流 + Wiki」两章骨架 + 「项目适配区」；技术栈经 `--stack` 传入只用于门禁配置（编译检查与自检验命令初值），密钥白名单等其余细节在 `.agents/hooks/commit-check.config.json` 里按项目填。
+
+## 装了什么
+
+```
+.agents/            阶段命令×8 / 角色契约×3 / 门禁钩子 / 引擎脚本（检索·索引·看板·预算·聚合）/ 技能×2 / settings.json / kit.json 台账
+.githooks/          pre-commit（通用门禁编排+项目门禁挂载点）/ pre-push（闭环断档）/ commit-msg / post-commit / pre-merge-commit
+workflow/           intents/specs/plans/incidents 模板×4 + README 协议 + 台账三件（delegations/papercuts/regression-checklist）
+wiki/               INDEX 骨架 + 知识沉淀总览 + drafts-archive
+AGENTS.md           项目规范骨架（项目段占位待填）
+modules/gates/      可选门禁模块（dotnet-ca：Clean Architecture 参考实现，装进项目后归项目）
+```
+
+**两态文件模型**：`.agents/kit.json` 记录 managed（引擎件，随包升级）与 owned（项目内容，永不覆盖）清单及 sha256；`doctor` 会校验漂移。已存在的文件 init 保守跳过（`--force` 覆盖）。
+
+**升级语义（sync）**：managed 文件三方比对（台账 sha / 磁盘 sha / 新版渲染 sha）——未改动 → 直接覆盖新版；本地已改 → 跳过并报告（`--force` 才覆盖，git diff 自查差异；跳过件的台账保持包侧基线，后续每次 sync 持续报告，不会在下次升级被静默覆盖——消除报告的办法：`--force` 覆盖，或把本地内容改回与新版一致）；改动恰好等于新版 → 视为已最新。包内新增文件自动安装；包内已删文件仅报告不删盘；缺失的 managed 文件自动恢复。INDEX / wiki 看板等生成器目标不比对 sha，收尾重跑生成器走锚点重写。门禁模块（add-gate 装入）归项目所有，sync 永不覆盖。add-host 对已存在的宿主文件保守跳过且不入台账——后续 sync 不升级（仅报告「已存在未入台账」），要纳入包管理用 `--force` 覆盖。owned 件归项目所有、sync 永不覆盖；其台账哈希仅记账不约束，sync 每次按盘面自愈刷新（手改后无须手工对账），add-gate 接线 local-pre-commit 后同步刷新其记账。
+
+## 设计原则
+
+- **权威单源**：角色行为只在 `.agents/roles/`，流程只在 `.agents/commands/`，宿主适配层是纯转发薄层——换宿主不换流程。
+- **门禁即 git 钩子**：不依赖任何 agent 客户端自觉；项目专属门禁挂 `.agents/hooks/local-pre-commit`。
+- **中文优先**：文档协议、命令、检查输出全中文；frontmatter 受限子集供机器断言。
+- 抽取自真实项目长期运转的引擎（某真实项目），dogfooding 是后续路线（sync 升级 / add-host / add-gate / npm 发布）的一部分。
+- **威胁模型（2026-09-27 init-p1-batch）**：勿在不可信仓库运行 `init` / `doctor` / `sync`——三命令在执行目标侧 `.agents/scripts/` 脚本（生成器 / 校验器）前有供应链防线：脚本内容与包源渲染值（LF 归一 sha）一致才执行，失配即显式跳过提示，不执行不下结论。**防线不覆盖 git 钩子面**：预植的 `.githooks/`、`.agents/hooks/` 仍会被保留挂载，并在你自己的首次 git 操作时执行——不可信仓库请先审查/清除预置件再 init。
+
+## 当前能力（已发布 0.8.0）
+
+版本沿革写在 `CHANGELOG.md`。0.8.0 已包含：init / doctor / sync / add-host / add-gate、四套技术栈门禁初值、宿主薄适配、确认门、check-loop 16 项、看板端口上探、opencode 命令 `wf-` 前缀、pre-commit managed 台账快检。
+
+仓库里还没打进版本号的增量：`audit` 档（新装默认 false）、`policyVersion`、检查 17（发版树上的未收口文档）、检查 18（委派台账对账）、检查 19（逐阶段审计）、逐阶段前置门（起草门 / 确认门 / done 前置门）、claude / cursor / codex 薄适配、`node-layer` / `py-import` / `generated-readonly` 三个可选门禁、fresh init 冒烟。效果数字等有外部仓库跑过再记，不在这次。
+
+活跃层里 2026-09-23 至 09-28 的 approved / open 文档没有在这次改成 done 或 closed。那些文件的确认指纹绑着当时的正文，关单要逐份 `confirm-doc`。

package/package.json

@@ -1,45 +1,45 @@
-{
-  "name": "agentic-flow-kit",
-  "version": "0.9.0",
-  "description": "AI-Native 闭环工作流 + wiki 知识层脚手架——flow-kit init 一条命令为新项目装好 .agents 工作流引擎（阶段命令/角色契约/门禁钩子/kb 检索/看板/规则面预算）+ workflow 文档闭环 + wiki 知识库，装完自包含、零运行时依赖",
-  "type": "module",
-  "scripts": {
-    "test": "node src/run-tests.mjs",
-    "prepack": "node -e \"require('fs').rmSync('templates/_agents/cache',{recursive:true,force:true})\" && node scripts/check-pack-eol.mjs"
-  },
-  "bin": {
-    "flow-kit": "bin/flow-kit.mjs"
-  },
-  "files": [
-    "bin",
-    "src",
-    "templates",
-    "modules",
-    "README.md",
-    "!templates/_agents/cache",
-    "!templates/_agents/cache/**"
-  ],
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "keywords": [
-    "ai-native",
-    "workflow",
-    "agent",
-    "scaffold",
-    "cli",
-    "wiki",
-    "check-loop",
-    "closed-loop"
-  ],
-  "license": "MIT",
-  "private": false,
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/zerosloney/agentic-flow-kit.git"
-  },
-  "bugs": {
-    "url": "https://github.com/zerosloney/agentic-flow-kit/issues"
-  },
-  "homepage": "https://github.com/zerosloney/agentic-flow-kit#readme"
-}
+{
+  "name": "agentic-flow-kit",
+  "version": "0.9.1",
+  "description": "AI-Native 闭环工作流 + wiki 知识层脚手架——flow-kit init 一条命令为新项目装好 .agents 工作流引擎（阶段命令/角色契约/门禁钩子/kb 检索/看板/规则面预算）+ workflow 文档闭环 + wiki 知识库，装完自包含、零运行时依赖",
+  "type": "module",
+  "scripts": {
+    "test": "node src/run-tests.mjs",
+    "prepack": "node -e \"require('fs').rmSync('templates/_agents/cache',{recursive:true,force:true})\" && node scripts/check-pack-eol.mjs"
+  },
+  "bin": {
+    "flow-kit": "bin/flow-kit.mjs"
+  },
+  "files": [
+    "bin",
+    "src",
+    "templates",
+    "modules",
+    "README.md",
+    "!templates/_agents/cache",
+    "!templates/_agents/cache/**"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "ai-native",
+    "workflow",
+    "agent",
+    "scaffold",
+    "cli",
+    "wiki",
+    "check-loop",
+    "closed-loop"
+  ],
+  "license": "MIT",
+  "private": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zerosloney/agentic-flow-kit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/zerosloney/agentic-flow-kit/issues"
+  },
+  "homepage": "https://github.com/zerosloney/agentic-flow-kit#readme"
+}

package/templates/_agents/commands/new-task.md

@@ -53,7 +53,7 @@ next: 按阶段路由
 | 级别 | 改什么 | 流程 |
 |------|--------|------|
 | L0 | 文档/样式微调(无行为影响) | 直接 commit,豁免 intent |
-| L1 | **实现级改动**(未命中 L2/L3) | 快车道:液态草稿(.zcode/drafts) $\rightarrow$ 实现 $\rightarrow$ 一键固化(`solidify-task.mjs`) |
+| L1 | **实现级改动**(未命中 L2/L3) | 快车道:液态草稿(.zcode/drafts) $\rightarrow$ 实现 $\rightarrow$ 固化(`solidify-task.mjs`)——用户确认后带 `--delegated "<原话>"` 执行；无确认来源只迁移不落账 |
 | L2 | **规则 / 契约**(一处改、多处依赖) | 入口文档(intent / incident) + spec + plan 三件套 |
 | L3 | **数据与运行时结构**(schema / 迁移 SQL / DI 链 / 认证与中间件管线) | 同 L2 + spec 新会话独立复核 |
 

package/templates/_agents/scripts/pre-push.test.mjs

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+// pre-push.test.mjs — 加固门目标分支判定 fixture 套件（2026-10-01 v09-review-defects）
+// 真仓端到端：临时仓库挂载真实 pre-push，.agents/scripts/check-loop.sh 以桩脚本记录 argv。
+// 断言三态 refspec：
+//   main→main                  → argv 含 --hardening（加固门）
+//   experiment/x→main         → argv 含 --hardening（修复回归：直推漏口）
+//   experiment/y→experiment/y → argv 不含 --hardening（advisory）
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+
+const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
+const PRE_PUSH = path.join(SCRIPT_DIR, '..', '..', '_githooks', 'pre-push');
+
+let pass = 0;
+let fail = 0;
+const check = (desc, cond, detail = '') => {
+  if (cond) { pass++; console.log(`PASS  ${desc}`); }
+  else { fail++; console.log(`FAIL  ${desc}${detail ? '\n      ' + detail : ''}`); }
+};
+
+const git = (cwd, args) => spawnSync('git', args, { cwd, encoding: 'utf8' });
+const run = (cwd, args) => spawnSync('git', args, { cwd, encoding: 'utf8' });
+
+const setup = () => {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'prepush-test-'));
+  const remote = path.join(root, 'remote.git');
+  fs.mkdirSync(path.join(root, '.githooks'), { recursive: true });
+  fs.mkdirSync(path.join(root, '.agents', 'scripts'), { recursive: true });
+  // 挂载真实 pre-push（装户同款），stub 替换 check-loop 记录 argv
+  fs.copyFileSync(PRE_PUSH, path.join(root, '.githooks', 'pre-push'));
+  fs.writeFileSync(path.join(root, '.agents', 'scripts', 'check-loop.sh'), '#!/bin/sh\necho "$@" >> .stub-args\nexit 0\n');
+  fs.writeFileSync(path.join(root, 'a.txt'), 'a\n');
+  git(root, ['init', '-q']);
+  git(root, ['config', 'user.email', 't@t']);
+  git(root, ['config', 'user.name', 't']);
+  git(root, ['config', 'core.hooksPath', '.githooks']);
+  git(root, ['add', 'a.txt']);
+  git(root, ['commit', '-q', '-m', 'init']);
+  git(root, ['init', '-q', '--bare', remote]);
+  git(root, ['remote', 'add', 'origin', remote]);
+  return root;
+};
+const stubArgs = (root) => {
+  const p = path.join(root, '.stub-args');
+  return fs.existsSync(p) ? fs.readFileSync(p, 'utf8').split(/\n/).filter(Boolean) : [];
+};
+
+const root = setup();
+const w = (f, c) => fs.writeFileSync(path.join(root, f), c);
+
+// 1) main → main：应含 --hardening
+git(root, ['checkout', '-q', '-b', 'main']);
+let r = run(root, ['push', 'origin', 'HEAD:main']);
+check('main→main 推送成功', r.status === 0, `${r.stdout}${r.stderr}`);
+check('main→main argv 含 --hardening', (stubArgs(root)[0] || '').includes('--hardening'), stubArgs(root).join('|'));
+
+// 2) experiment/x → main（回归漏口）：本地分支在 experiment，目标 main → 必须含 --hardening
+git(root, ['checkout', '-q', '-b', 'experiment/x']);
+w('b.txt', 'b\n');
+git(root, ['add', 'b.txt']);
+git(root, ['commit', '-q', '-m', 'x']);
+r = run(root, ['push', 'origin', 'HEAD:main']);
+check('experiment/x→main 推送成功', r.status === 0, `${r.stdout}${r.stderr}`);
+check('experiment/x→main argv 含 --hardening（直推漏口修复）', (stubArgs(root)[1] || '').includes('--hardening'), stubArgs(root).join('|'));
+
+// 3) experiment/y → experiment/y：目标在探索泳道 → 不含 --hardening
+git(root, ['fetch', '-q', 'origin']);
+git(root, ['branch', 'experiment/y', 'origin/main']);
+git(root, ['checkout', '-q', 'experiment/y']);
+w('c.txt', 'c\n');
+git(root, ['add', 'c.txt']);
+git(root, ['commit', '-q', '-m', 'y']);
+r = run(root, ['push', 'origin', 'HEAD:experiment/y']);
+check('experiment→experiment 推送成功', r.status === 0, `${r.stdout}${r.stderr}`);
+const line3 = stubArgs(root)[2] || '';
+check('experiment→experiment argv 不含 --hardening', !line3.includes('--hardening'), stubArgs(root).join('|'));
+
+console.log(`\n${fail ? `❌ ${fail} failed` : '✅ all passed'}（${pass} passed）`);
+process.exit(fail ? 1 : 0);

package/templates/_agents/scripts/solidify-task.mjs

@@ -1,101 +1,107 @@
 #!/usr/bin/env node
-// solidify-task: 将 L1 液态草稿一次性固化为正式 workflow 文档（迁移 + 批量确认 + 索引更新）
-// 用法：node .agents/scripts/solidify-task.mjs --topic "主题" [--root <仓库根>]
+// solidify-task: 将 L1 液态草稿固化为正式 workflow 文档（迁移 + 可选确认 + 索引更新）
+// 用法：
+//   node .agents/scripts/solidify-task.mjs --topic <主题> [--root <仓库根>]
+//       # 只迁移 + 更新索引，绝不写确认台账；末尾打印确认指引
+//   node .agents/scripts/solidify-task.mjs --topic <主题> --delegated "<用户原话>"
+//       # 迁移后，以调用方显式传入的用户原话逐份 confirm-doc --delegated（quote 原样转发）
+//   node .agents/scripts/solidify-task.mjs --topic <主题> --auto
+//       # 迁移后，逐份 confirm-doc --auto（trust-mode=Trusted 才放行；Strict 下被拒并计数失败）
+// 确认门契约（incidents/2026-10-01-v09-review-defects）：--delegated 的 quote 必须来自用户在对话内的
+//   明确原话，由调用方显式传入——本脚本永不编造用户话术。无确认来源时只迁移不落账，末尾打印指引。
 import fs from 'node:fs';
 import path from 'node:path';
 import { spawnSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 
 const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
-const ROOT = process.argv.includes('--root') ? 
-  process.argv[process.argv.indexOf('--root') + 1] : 
-  process.cwd();
-const DRAFTS_DIR = path.join(ROOT, '.zcode', 'drafts');
-const WF_ROOT = path.join(ROOT, 'workflow');
 
-function fail(msg) { console.error('❌ ' + msg); process.exit(1); }
+function fail(msg) {
+  console.error(`❌ ${msg}`);
+  process.exit(1);
+}
 
 function parseArgs() {
   const topicIdx = process.argv.indexOf('--topic');
-  if (topicIdx === -1 || !process.argv[topicIdx + 1]) {
-    console.error('用法: node .agents/scripts/solidify-task.mjs --topic "主题"');
-    process.exit(1);
-  }
-  return process.argv[topicIdx + 1];
+  const topic = topicIdx !== -1 ? process.argv[topicIdx + 1] : '';
+  if (!topic) fail('用法: node .agents/scripts/solidify-task.mjs --topic "主题" [--root <仓库根>] [--delegated "<用户原话>" | --auto]');
+  let root = process.cwd();
+  const rootIdx = process.argv.indexOf('--root');
+  if (rootIdx !== -1 && process.argv[rootIdx + 1]) root = process.argv[rootIdx + 1];
+  const delegatedIdx = process.argv.indexOf('--delegated');
+  const delegated = delegatedIdx !== -1 ? String(process.argv[delegatedIdx + 1] ?? '') : '';
+  const auto = process.argv.includes('--auto');
+  if (delegated && auto) fail('--delegated 与 --auto 互斥，只能选其一');
+  return { topic, root, delegated, auto };
 }
 
-async function run() {
-  const topic = parseArgs();
-  console.log(`🚀 开始固化 L1 任务: ${topic}...`);
+const classify = (content) => {
+  if (content.includes('# INTENT')) return 'intents';
+  if (content.includes('# PLAN')) return 'plans';
+  if (content.includes('# SPEC')) return 'specs';
+  if (content.includes('# INCIDENT')) return 'incidents';
+  return null;
+};
 
-  if (!fs.existsSync(DRAFTS_DIR)) fail('草稿目录 .zcode/drafts/ 不存在');
-
-  // 1. 搜寻草稿
-  const files = fs.readdirSync(DRAFTS_DIR).filter(f => f.includes(topic) && f.endsWith('.md'));
-  if (!files.length) fail(`在 ${DRAFTS_DIR} 中未找到主题为 ${topic} 的草稿文件`);
+function run() {
+  const { topic, root, delegated, auto } = parseArgs();
+  const draftsDir = path.join(root, '.zcode', 'drafts');
+  if (!fs.existsSync(draftsDir)) fail(`草稿目录 ${draftsDir} 不存在`);
+  const files = fs.readdirSync(draftsDir).filter((f) => f.includes(topic) && f.endsWith('.md'));
+  if (!files.length) fail(`在 ${draftsDir} 中未找到主题为 ${topic} 的草稿文件`);
 
   const today = new Date().toISOString().slice(0, 10);
   const solidified = [];
-
-  // 2. 迁移并规范化命名
   for (const file of files) {
-    const content = fs.readFileSync(path.join(DRAFTS_DIR, file), 'utf8');
-    let targetDir = '';
-    
-    // 简单启发式判定类型
-    if (content.includes('# INTENT')) targetDir = 'intents';
-    else if (content.includes('# PLAN')) targetDir = 'plans';
-    else if (content.includes('# SPEC')) targetDir = 'specs';
-    else if (content.includes('# INCIDENT')) targetDir = 'incidents';
-    else continue;
-
-    const targetName = `${today}-${file.replace(/.*-/, '').replace('.md', '.md')}`;
-    if (!targetName.startsWith('20')) {
-       // 如果文件名没日期前缀，强制加上
-       // 假设文件名为 <topic>.md
-    }
-    
-    // 统一处理：强制 YYYY-MM-DD- 前缀
+    const content = fs.readFileSync(path.join(draftsDir, file), 'utf8');
+    const targetDir = classify(content);
+    if (!targetDir) continue;
+    // 统一强制 YYYY-MM-DD- 前缀；已有前缀的文件名原样保留
     const finalName = /^\d{4}-\d{2}-\d{2}-/.test(file) ? file : `${today}-${file}`;
-    const targetPath = path.join(WF_ROOT, targetDir, finalName);
-
+    const targetPath = path.join(root, 'workflow', targetDir, finalName);
     fs.mkdirSync(path.dirname(targetPath), { recursive: true });
-    fs.copyFileSync(path.join(DRAFTS_DIR, file), targetPath);
-    
-    solidified.push({
-      rel: `workflow/${targetDir}/${finalName}`,
-      abs: targetPath,
-      type: targetDir
-    });
-    console.log(`  📦 迁移: ${file} -> ${targetKebab(targetDir)}/${finalName}`);
+    fs.copyFileSync(path.join(draftsDir, file), targetPath);
+    solidified.push({ rel: `workflow/${targetDir}/${finalName}`, abs: targetPath, type: targetDir });
+    console.log(` 📦 迁移: ${file} -> ${targetDir}/${finalName}`);
   }
+  if (!solidified.length) fail(`草稿中未找到可识别的 INTENT/PLAN/SPEC/INCIDENT 文档（主题 ${topic}）`);
 
-  function targetKebab(dir) { return dir; }
-
-  // 3. 批量确认 (Delegated)
-  console.log('🛡️  执行批量确认...');
-  for (const item of solidified) {
-    const res = spawnSync('node', [
-      path.join(SCRIPT_DIR, 'confirm-doc.mjs'), 
-      item.rel, 
-      '--delegated', 
-      `固化 L1 任务 ${topic}：用户确认草稿无误，执行固化归档`
-    ], { encoding: 'utf8' });
-    
-    if (res.status !== 0) {
-      console.error(`  ❌ 确认失败 [${item.rel}]: ${res.stderr}`);
-      // 此时不 exit，尝试继续其他文件的确认
-    } else {
-      console.log(`  ✅ 已确认: ${item.rel}`);
+  // 确认：仅当调用方显式提供确认来源时执行；否则只迁移，绝不落账。
+  let failed = 0;
+  if (delegated || auto) {
+    console.log('🛡️ 执行逐份确认...');
+    for (const item of solidified) {
+      const args = [path.join(SCRIPT_DIR, 'confirm-doc.mjs'), item.rel, '--root', root];
+      if (delegated) args.push('--delegated', delegated);
+      else args.push('--auto');
+      const res = spawnSync('node', args, { cwd: root, encoding: 'utf8' });
+      if (res.status !== 0) {
+        failed++;
+        console.error(` ❌ 确认失败 [${item.rel}]: ${(res.stderr || '').trim()}`);
+      } else {
+        console.log(` ✅ 已确认: ${item.rel}`);
+      }
+    }
+    console.log(`确认汇总：${solidified.length - failed}/${solidified.length} 成功${failed ? `，${failed} 失败` : ''}`);
+  } else {
+    console.log('⏭️ 未提供确认来源，仅迁移不落账。');
+    for (const item of solidified) {
+      console.log(`  → 确认指引: node .agents/scripts/confirm-doc.mjs ${item.rel}（TTY 键入「可以」）`);
+      console.log(`    或（用户对话内明确确认后）: node .agents/scripts/confirm-doc.mjs ${item.rel} --delegated "<用户原话>"`);
     }
   }
 
-  // 4. 更新索引
+  // 更新索引；失败同样传播退出码。
   console.log('📖 更新工作流索引...');
-  spawnSync('node', [path.join(SCRIPT_DIR, 'gen-workflow-index.mjs')], { stdio: 'inherit' });
+  const idx = spawnSync('node', [path.join(SCRIPT_DIR, 'gen-workflow-index.mjs')], { cwd: root, stdio: 'inherit' });
+  if (idx.status !== 0) {
+    console.error(' ❌ 索引更新失败');
+    process.exit(1);
+  }
 
+  if (failed) process.exit(1);
   console.log(`\n✨ 任务 ${topic} 已成功固化！`);
   console.log(`👉 建议执行: git add workflow/ .agents/confirmations.jsonl && git commit -m "docs(workflow): solidify L1 task ${topic}"`);
 }
 
-run();
+run();

package/templates/_agents/scripts/solidify-task.test.mjs

@@ -0,0 +1,126 @@
+#!/usr/bin/env node
+// solidify-task.test.mjs — 快车道固化脚本 fixture 套件（2026-10-01 v09-review-defects）
+// 验证确认门契约：无确认来源只迁移不落账；--delegated quote 原样转发；--auto Strict 下拒绝且失败退出；
+// 互斥/缺草稿/非文档等边界。gen-workflow-index 无 --root 参数，spawn 时以 fixture 根为 cwd。
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+
+const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
+const SCRIPT = path.join(SCRIPT_DIR, 'solidify-task.mjs');
+
+let pass = 0;
+let fail = 0;
+const check = (desc, cond, detail = '') => {
+  if (cond) { pass++; console.log(`PASS  ${desc}`); }
+  else { fail++; console.log(`FAIL  ${desc}${detail ? '\n      ' + detail : ''}`); }
+};
+
+const ENUMS_FIXTURE = [
+  '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',
+  'level.all=L0 L1 L2 L3',
+].join('\n') + '\n';
+
+const mkfix = () => {
+  const d = fs.mkdtempSync(path.join(os.tmpdir(), 'solidify-test-'));
+  for (const s of ['intents', 'plans', 'specs', 'incidents']) {
+    fs.mkdirSync(path.join(d, 'workflow', s), { recursive: true });
+  }
+  fs.mkdirSync(path.join(d, '.agents'), { recursive: true });
+  fs.mkdirSync(path.join(d, '.zcode', 'drafts'), { recursive: true });
+  fs.writeFileSync(path.join(d, '.agents', 'workflow-enums.txt'), ENUMS_FIXTURE);
+  fs.writeFileSync(path.join(d, '.agents', 'workflow-modules.txt'), '# modules\npipeline\nui\n');
+  return d;
+};
+const DRAFT = (name, eol = '\n') =>
+  `---${eol}状态: draft${eol}级别: L1${eol}日期: 2026-10-01${eol}模块: pipeline${eol}---${eol}# INTENT — ${name}${eol}`;
+const run = (root, args) => {
+  const r = spawnSync(process.execPath, [SCRIPT, ...args], { cwd: root, encoding: 'utf8' });
+  return { code: r.status, out: `${r.stdout || ''}${r.stderr || ''}` };
+};
+const ledgerLines = (root) => {
+  const p = path.join(root, '.agents', 'confirmations.jsonl');
+  return fs.existsSync(p) ? fs.readFileSync(p, 'utf8').split(/\n/).filter(Boolean) : [];
+};
+
+// T1：默认只迁移不落账
+{
+  const d = mkfix();
+  fs.writeFileSync(path.join(d, '.zcode', 'drafts', 'demo-task.md'), DRAFT('demo'));
+  const r = run(d, ['--topic', 'demo', '--root', d]);
+  check('T1 默认迁移成功 exit 0', r.code === 0, r.out);
+  check('T1 草稿已迁移到 intents 且日期前缀正确',
+    fs.existsSync(path.join(d, 'workflow', 'intents', '2026-10-01-demo-task.md')), '');
+  check('T1 零台账新增（无确认来源绝不落账）', ledgerLines(d).length === 0, JSON.stringify(ledgerLines(d)));
+  check('T1 输出含确认指引', r.out.includes('确认指引') && r.out.includes('--delegated'), r.out);
+}
+// T2：--delegated 原话原样转发
+{
+  const d = mkfix();
+  fs.writeFileSync(path.join(d, '.zcode', 'drafts', 'demo-task.md'), DRAFT('demo'));
+  const r = run(d, ['--topic', 'demo', '--root', d, '--delegated', '固化了可以']);
+  check('T2 --delegated 流程 exit 0', r.code === 0, r.out);
+  const lines = ledgerLines(d);
+  check('T2 台账落 1 行', lines.length === 1, JSON.stringify(lines));
+  check('T2 quote 原样（脚本不编造话术）',
+    lines[0].includes('"quote":"固化了可以"') && lines[0].includes('chat-delegated'), lines[0]);
+  check('T2 目标文档状态已 approved',
+    fs.readFileSync(path.join(d, 'workflow', 'intents', '2026-10-01-demo-task.md'), 'utf8').includes('状态: approved'), '');
+}
+// T3：--auto 在 Strict（缺 trust-mode.json）下被拒 → 失败计数并 exit 1
+{
+  const d = mkfix();
+  fs.writeFileSync(path.join(d, '.zcode', 'drafts', 'demo-task.md'), DRAFT('demo'));
+  const r = run(d, ['--topic', 'demo', '--root', d, '--auto']);
+  check('T3 --auto 在缺省 Strict 下 exit 1（不吞失败）', r.code === 1, r.out);
+  check('T3 输出含失败汇总', r.out.includes('确认汇总') && r.out.includes('失败'), r.out);
+  check('T3 台账零行（拒绝不落账）', ledgerLines(d).length === 0, JSON.stringify(ledgerLines(d)));
+}
+// T4：缺草稿 → exit 1
+{
+  const d = mkfix();
+  fs.writeFileSync(path.join(d, '.zcode', 'drafts', 'other.md'), DRAFT('other'));
+  const r = run(d, ['--topic', 'nope', '--root', d]);
+  check('T4 缺主题草稿 exit 1 且带指引', r.code === 1 && r.out.includes('未找到主题'), r.out);
+}
+// T5：草稿非可识别文档 → exit 1
+{
+  const d = mkfix();
+  fs.writeFileSync(path.join(d, '.zcode', 'drafts', 'demo-note.md'), '# 随手笔记\nnot a workflow doc\n');
+  const r = run(d, ['--topic', 'demo', '--root', d]);
+  check('T5 无可识别文档 exit 1', r.code === 1 && r.out.includes('未找到可识别'), r.out);
+}
+// T6：--delegated 与 --auto 互斥 → exit 1
+{
+  const d = mkfix();
+  fs.writeFileSync(path.join(d, '.zcode', 'drafts', 'demo-task.md'), DRAFT('demo'));
+  const r = run(d, ['--topic', 'demo', '--root', d, '--delegated', 'x', '--auto']);
+  check('T6 互斥 exit 1', r.code === 1 && r.out.includes('互斥'), r.out);
+}
+// T7：失败路径退出码传播（确认失败后 exit 1，不吞）
+{
+  const d = mkfix();
+  fs.writeFileSync(path.join(d, '.zcode', 'drafts', 'demo-task.md'), DRAFT('demo'));
+  // 让确认失败：用 --auto 触发 Strict 拒绝（缺 trust-mode.json 即 Strict）。
+  const r = run(d, ['--topic', 'demo', '--root', d, '--auto']);
+  check('T7 失败后 exit 1 且索引仍生成', r.code === 1 && fs.existsSync(path.join(d, 'workflow', 'INDEX.md')), r.out);
+}
+// T8：索引更新失败传播退出码（独立于确认失败路径——删除 workflow/plans 目录使 gen-workflow-index 失败）
+{
+  const d = mkfix();
+  fs.writeFileSync(path.join(d, '.zcode', 'drafts', 'demo-task.md'), DRAFT('demo'));
+  fs.rmSync(path.join(d, 'workflow', 'plans'), { recursive: true });
+  const r = run(d, ['--topic', 'demo', '--root', d]);
+  check('T8 索引更新失败 exit 1 且输出指明', r.code === 1 && r.out.includes('索引更新失败'), r.out);
+}
+
+console.log(`\n${fail ? `❌ ${fail} failed` : '✅ all passed'}（${pass} passed）`);
+process.exit(fail ? 1 : 0);

package/templates/_githooks/pre-push

@@ -5,9 +5,10 @@
 #   - 警告（advisory）= 状态未确认 / 模板占位残留 / 引用漂移 等卫生项 → 仅打印提示
 # stdin 有行时，每个非删除的本地 sha 用 --rev 扫那棵树。没有行时（手跑钩子）仍无参数扫工作区。
 #
-# experiment/* 泳道分支（2026-09-30 hybrid-governance-explore-hardening）：check-loop 降级 advisory——
-#   快速 PoC 推送不因闭环断档被拦（断档报告照出）；转正（合入 main）由下方加固门兜底。
-# 加固门（同日）：推送目标为 refs/heads/main 时以 --hardening 运行——exploring 任务须先收口
+# experiment/* 泳道（2026-09-30 hybrid-governance-explore-hardening）：**目标分支**为 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，防「未文档化的探索件」进 main。
 #
@@ -34,33 +35,36 @@ run_loop() {
 saw=0
 rc=0
 while read -r local_ref local_sha remote_ref _remote_sha; do
-  saw=1
-  case "$local_sha" in
-    *[!0]*) ;;
-    *) continue ;;
-  esac
-  # experiment/* 泳道：advisory（报告不阻断； detached / 其他分支不受影响）
-  case "$local_ref" in
-    refs/heads/experiment/*|experiment/*)
-      echo "pre-push: experiment/* 泳道分支（$local_ref）——闭环扫描降级 advisory，不阻断" >&2
-      if command -v sh >/dev/null 2>&1; then
-        sh "$SCRIPT" --rev "$local_sha" >&2 || echo "pre-push: （advisory）闭环断档已在上方列出——experiment 泳道可推送，转正合入 main 须过加固门" >&2
-      else
-        bash "$SCRIPT" --rev "$local_sha" >&2 || echo "pre-push: （advisory）闭环断档已在上方列出——experiment 泳道可推送，转正合入 main 须过加固门" >&2
-      fi
-      continue
-      ;;
-  esac
-  # 加固门：推 main 时追加 --hardening（其余目标维持既有全量扫描）
-  hard_args=""
-  case "$remote_ref" in
-    refs/heads/main|main) hard_args="--hardening" ;;
-  esac
-  run_loop --rev "$local_sha" $hard_args
-  one=$?
-  if [ "$one" -ne 0 ] && [ "$rc" -eq 0 ]; then
-    rc=$one
-  fi
+saw=1
+case "$local_sha" in
+*[!0]*) ;;
+*) continue ;;
+esac
+# 按目标分支三态分派（2026-10-01 v09-review-defects：判定键从 local_ref 改为 remote_ref——
+# 修复 experiment/*→main 直推被 advisory continue 吞掉加固门的漏口）：
+#   main            → 加固门（必带 --hardening）
+#   experiment/*    → advisory（报告不阻断）
+#   其他            → 全量扫描
+case "$remote_ref" in
+refs/heads/main|main)
+run_loop --rev "$local_sha" --hardening
+;;
+refs/heads/experiment/*|experiment/*)
+echo "pre-push: experiment/* 目标分支（$remote_ref）——闭环扫描降级 advisory，不阻断" >&2
+if command -v sh >/dev/null 2>&1; then
+sh "$SCRIPT" --rev "$local_sha" >&2 || echo "pre-push: （advisory）闭环断档已在上方列出——experiment 泳道可推送，转正（推 main）须过加固门" >&2
+else
+bash "$SCRIPT" --rev "$local_sha" >&2 || echo "pre-push: （advisory）闭环断档已在上方列出——experiment 泳道可推送，转正（推 main）须过加固门" >&2
+fi
+;;
+*)
+run_loop --rev "$local_sha"
+;;
+esac
+one=$?
+if [ "$one" -ne 0 ] && [ "$rc" -eq 0 ]; then
+rc=$one
+fi
 done
 
 if [ "$saw" -eq 0 ]; then

package/templates/workflow/README.md

@@ -50,7 +50,7 @@
 
 1. **同名配对**：L1 有 plan；L2/L3 有 spec 与 plan。incident 的回路断档同样阻断。
 2. **验收勾验**：新建 intent 关到 done 时，验收标准未勾则阻断。
-3. **确认留痕**：approved / done / fixed / closed 须经 `confirm-doc.mjs`，指纹与台账一致。
+3. **确认留痕**：approved / done / fixed / closed 须经 `confirm-doc.mjs`，指纹与台账一致。`--delegated` 原话仅限用户对话内明确确认的当次措辞——官方脚本/门禁不得自动代录或编造 quote（2026-10-01 v09-review-defects：solidify-task 曾自动伪造原话，已修复并纳入回归）。
 4. **敏感信息**：pre-commit 的 commit-check 扫描密钥。
 5. **双源与台账**：doctor 核对 managed / owned 的 sha；引擎改动改包源 `templates/` 再 `sync`。