agentic-flow-kit 2.0.0 → 2.1.0

package/src/tui/widgets.mjs

@@ -0,0 +1,111 @@
+// 状态机 + 视图行，不接触 IO（不读 stdin、不写 stdout），渲染与接线由上层完成。
+import { cyan, dim, green, red } from './ansi.mjs';
+
+// select：单选列表。items: [{ value, label, hint? }]
+export function createSelect({ items, cursor = 0 }) {
+  let idx = cursor;
+  const n = items.length;
+  return {
+    view() {
+      return items.map((it, i) => {
+        const head = i === idx ? cyan(`❯ ● ${it.label}`) : dim(`  ○ ${it.label}`);
+        return it.hint ? `${head}  ${dim(it.hint)}` : head;
+      });
+    },
+    onKey(key) {
+      if (key.name === 'up') idx = (idx - 1 + n) % n;
+      else if (key.name === 'down') idx = (idx + 1) % n;
+      else if (key.name === 'return') return { value: items[idx].value };
+      return undefined;
+    },
+  };
+}
+
+// multiselect：多选列表，min 为最少勾选数。items: [{ value, label, hint?, checked? }]
+// minMessage：最少数量提示文案（可本地化注入），缺省为内置中文
+export function createMultiSelect({ items, cursor = 0, min = 1, minMessage = `至少选择 ${min} 项` }) {
+  let idx = cursor;
+  const checked = items.map((it) => it.checked === true);
+  let error = false;
+  const n = items.length;
+  return {
+    view() {
+      const rows = items.map((it, i) => {
+        const head = checked[i]
+          ? `${i === idx ? '❯ ' : '  '}◉ ${cyan(it.label)}${green(' ✓')}`
+          : `${i === idx ? '❯ ' : '  '}○ ${dim(it.label)}`;
+        return it.hint ? `${head}  ${dim(it.hint)}` : head;
+      });
+      if (error) rows.push(red(minMessage));
+      return rows;
+    },
+    onKey(key) {
+      if (error) error = false; // 任意键先清除错误提示
+      if (key.name === 'up') idx = (idx - 1 + n) % n;
+      else if (key.name === 'down') idx = (idx + 1) % n;
+      else if (key.name === 'space' || key.sequence === ' ') checked[idx] = !checked[idx];
+      else if (key.name === 'a' || key.sequence === 'a') checked.fill(!checked.every(Boolean));
+      else if (key.name === 'return') {
+        if (checked.filter(Boolean).length < min) {
+          error = true;
+          return undefined;
+        }
+        return { value: items.filter((_, i) => checked[i]).map((it) => it.value) };
+      }
+      return undefined;
+    },
+  };
+}
+
+// textinput：单行文本（模型 ID 手填）。view 返回一行；Esc 返回 null。
+export function createTextInput({ initial = '', placeholder = '', validate = () => null } = {}) {
+  let value = String(initial);
+  let error = null;
+  return {
+    view() {
+      const line = value ? `❯ ${value}█` : dim(`❯ ${placeholder}`);
+      return error ? [line, red(error)] : [line];
+    },
+    onKey(key) {
+      if (!key) return undefined;
+      if (key.name === 'return') {
+        const err = validate(value);
+        if (err) {
+          error = err;
+          return undefined;
+        }
+        return { value };
+      }
+      if (key.name === 'escape') return { value: null };
+      if (key.ctrl) return undefined;
+      if (key.name === 'backspace') {
+        value = value.slice(0, -1);
+        error = null;
+        return undefined;
+      }
+      if (key.sequence && !/[\x00-\x1f]/.test(key.sequence)) {
+        value += key.sequence;
+        error = null;
+      }
+      return undefined;
+    },
+  };
+}
+
+// confirm：是/否二选一（题干归 runPrompt 渲染，view 只返回两行选项）
+export function createConfirm({ yesLabel = '是', noLabel = '否', defaultYes = true }) {
+  let yes = defaultYes === true;
+  const row = (text, active) => (active ? cyan(`❯ ● ${text}`) : dim(`  ○ ${text}`));
+  return {
+    view() {
+      return [row(yesLabel, yes), row(noLabel, !yes)];
+    },
+    onKey(key) {
+      if (key.name === 'left' || key.name === 'right') yes = !yes;
+      else if (key.name === 'y' || key.sequence === 'y') yes = true;
+      else if (key.name === 'n' || key.sequence === 'n') yes = false;
+      else if (key.name === 'return') return { value: yes };
+      return undefined;
+    },
+  };
+}

package/src/tui/wizard.mjs

@@ -0,0 +1,68 @@
+// TUI 向导入口：主循环表驱动 FLOWS；交互终端走 keypress 状态机（screen.mjs），
+// 非交互终端降级为「编号 + 回车」问答（prompts.mjs）。
+// 任何一步 EOF（stdin 关闭）都干净退出返回码 0；Ctrl+C 同样以退出码 0 退出。
+import { createScreen, createLineReader, QuitError } from './screen.mjs';
+import { pickOne, confirmYes, showError } from './prompts.mjs';
+import { FLOWS, baseArgs } from './flows.mjs';
+
+// 主菜单：无位置参数且无任何选项、交互终端时由 cli/main.mjs 懒加载进入
+export async function wizardCommand({ t, lang }) {
+  const screen = createScreen({ input: process.stdin, output: process.stdout });
+  screen.setup();
+  const ctx = { screen, t, lang };
+  // 降级模式：会话级读行器（交互模式禁用，避免与 keypress 抢输入）
+  if (!screen.interactive) ctx.reader = createLineReader(screen.input, screen.output);
+  try {
+    while (true) {
+      const action = await pickOne(ctx, {
+        question: t('tui.menuQuestion'),
+        hint: t('tui.hint.moveEnter'),
+        items: [
+          { value: 'install', label: t('tui.menu.install') },
+          { value: 'upgrade', label: t('tui.menu.upgrade') },
+          { value: 'add-host', label: t('tui.menu.addHost') },
+          { value: 'doctor', label: t('tui.menu.doctor') },
+          { value: 'list-hosts', label: t('tui.menu.listHosts') },
+          { value: 'quit', label: t('tui.menu.quit') },
+        ],
+      });
+      if (action === null || action === 'quit') return 0;
+      try {
+        await FLOWS[action]?.(ctx);
+      } catch (err) {
+        if (err instanceof QuitError) return 0;
+        // 命令抛错（如无 manifest）：红字 box 显示 message，confirm 后回菜单，不裸抛堆栈
+        showError(ctx, err);
+      }
+      // 命令输出可能推进过光标，confirm 从当前位置新起一块
+      screen.print('');
+      const again = await confirmYes(ctx, t('tui.backOrQuit'));
+      if (!again) return 0;
+    }
+  } catch (err) {
+    if (err instanceof QuitError) return 0;
+    throw err;
+  } finally {
+    screen.restore();
+  }
+}
+
+// 纯函数：向导选择 → runInstall 入参（argv 形状与 cli/args.mjs parseArgs 经 baseArgs 一致）。
+// git 配置 CLI 侧默认开，--no-git-config 关闭
+export function buildInstallArgs({ hosts, lang, stack, gitConfig = true, dryRun = false, force = false, models = null }) {
+  const args = {
+    ...baseArgs(),
+    _: ['install'],
+    agents: hosts,
+    lang,
+    stack,
+    flags: new Set([
+      ...(gitConfig ? [] : ['no-git-config']),
+      ...(dryRun ? ['dry-run'] : []),
+      ...(force ? ['force'] : []),
+    ]),
+  };
+  // 模型参数保持 opt-in：默认路径不新增 flag，避免破坏既有 argv 断言。
+  if (models && Object.keys(models).length) args.tuiModels = models;
+  return args;
+}

package/templates/engine/.agents/commands/new-task.md

@@ -64,8 +64,8 @@
 1. **定级**：用 §1 两问和 L2 闭集。未命中即 L1，`级别` 写在 plan frontmatter。完成标准：plan 头里的级别与两问结论一致。
 2. **检索**：`node .agents/scripts/kb-search.mjs --scope workflow --module <token> "<关键词>"`。命中的 incident 根因写进下一步 plan 的自查。完成标准：命令跑过；命中根因备写进 plan，无命中粘贴脚本输出即可（免另写说明）。命中同功能 spec / features $\rightarrow$ 按 `workflow/README.md`「同功能续作」改原件不新建。
 3. **立 plan**：`node .agents/scripts/fill-plan.mjs --level L1 --topic <主题> --output workflow/plans/<YYYY-MM-DD>-<主题>.md`。可加 `--lite`（三节：入口 / 改动方案 / 验证与验收；条件：第 2 步检索无 incident 命中且红线全不勾），缺省仍为五节。填实入口（来源、目标、红线）、改动方案、约束与风险、验证计划、验收标准，并把第 2 步的检索结果写进自查。frontmatter `模块` 改成主导模块。不写 intent，不写预判字段。完成标准：所选模板各节有正文（五节或 lite 三节）、检索结论已入 plan；验收写不出可测试判据就停；红线要么勾中升 L2/L3，要么明确不勾。
-4. **确认后动手**：`node .agents/scripts/confirm-doc.mjs <plan> --delegated "<用户原话>"` 把 draft 收到 approved（确认门口径单源：逐件调用禁并录、逐件原话禁复用、逐跳迁移禁单跳），然后再改代码。只改 plan 列出的文件。四条红线：不提交密钥或 `.env`、不用 `--no-verify`、最小改动、偏离 plan 先停。**承诺面锁定**：approved 之后改「承诺面」（验收判据文本 / 红线 / 目标 / 改动方案）须先让用户重新点头并重录承诺面指纹——重确认口令见 `workflow/README.md`「承诺面绑定」；否则关单被拒、推送被检查 15 hard 拦（勾验收 + 证据回填不算改承诺）。改完不单独提交：验证（第 5 步）绿后按第 6 步连跳 done 并与代码同笔提交。改码前开 /tour 全景，每批刷新（skills/dev-tour）。完成标准：改动留在工作区，plan 仍是 approved。
-5. **验证**：`node .agents/scripts/verify.mjs --scope`（口径见头注）。有前端改动再打开 `.agents/skills/verify-ui/SKILL.md`。失败就改代码，不在本页改门禁。完成标准：命令退出码 0，前端改动另有实测证据。
+4. **确认后动手**：`node .agents/scripts/confirm-doc.mjs <plan> --delegated "<用户原话>"` 把 draft 收到 approved（确认门口径单源：逐件调用禁并录、逐件原话禁复用、逐跳迁移禁单跳），然后再改代码。只改 plan 列出的文件。四条红线：不提交密钥或 `.env`、不用 `--no-verify`、最小改动、偏离 plan 先停。**承诺面锁定**：approved 之后改「承诺面」（验收判据文本 / 红线 / 目标 / 改动方案）须先让用户重新点头并重录承诺面指纹——重确认口令见 `workflow/README.md`「承诺面绑定」；否则关单被拒、推送被检查 15 hard 拦（勾验收 + 证据回填不算改承诺）。改完不单独提交：验证（第 5 步）绿后按第 6 步连跳 done 并与代码同笔提交。改码前开 /tour 全景，每批刷新（skills/dev-tour）。**修复类**改码前 `node .agents/scripts/fix-task.mjs start`，关单后 `stop`——窗口内既有测试只读，新建复现测试放行。完成标准：改动留在工作区，plan 仍是 approved。
+5. **验证**：`node .agents/scripts/verify.mjs --scope`（口径见头注）。触及 `.agents/skills|commands|roles` 或模型配置时，另跑 `node .agents/scripts/agent-eval.mjs check`（无凭证先按 eval 技能跑并 record）。有前端改动再打开 `.agents/skills/verify-ui/SKILL.md`。失败就改代码，不在本页改门禁。完成标准：命令退出码 0，前端改动另有实测证据。
 6. **关单＝单笔提交**：`node .agents/scripts/confirm-doc.mjs <plan> --delegated "<用户原话>"` 连续再跳一次把 approved 收到 done，随后单笔提交——plan(done) + 代码 + 确认分片 + verify 凭证同一笔入库，L1 无独立关单提交。仅 plan 独立关单场景（代码已在前笔入库）才打开 `.agents/skills/shipyard-workflow-closeout/SKILL.md`。完成标准：plan 为 done，单笔提交已入库。
 
 下面才打开别的文件：委派 implementer → `stages.md` Build §3；改了库连接 → `stages.md` Test §2；全量首跑红、隔离重跑转绿 → `stages.md` Test §1；L2/L3 独立复核 → `stages.md` Test §4。

package/templates/engine/.agents/commands/pipeline-run.md

@@ -14,9 +14,12 @@ next: 按 run 停机点循环推进至 done
 
 阶段机已对齐 commands 手册。与手动阶段路由二选一，禁混用。
 
-> **保留待用**：暂零 run（`cache/pipeline-runs/` 空）但不退役；启用前先跑一次小任务验证状态机。
+> **保留待用**：暂零 run（`cache/pipeline-runs/` 空）但不退役。启用前先跑
+> `node .agents/scripts/check-pipeline-state.mjs`（静态闭包检查：stage/stopType 是否都在
+> `.agents/config/pipeline.json` 内），再用一个小任务跑一次端到端 run——静态检查不能替代真实状态机验证。
 
 > **分工**：确定性部分由 `pipeline-run.mjs` 状态机驱动（fill-* $\rightarrow$ confirm-doc $\rightarrow$ verify.mjs $\rightarrow$ git，退出码全记录）；AI 槽位按工单协议执行；人件门到点即停、原话代录；宿主禁自行改状态。
+> **fix 工单**：动手前 `node .agents/scripts/fix-task.mjs start`，签收后 `stop`——窗口内既有测试只读。
 
 ## 1. 驱动协议 (Protocol)
 
@@ -44,6 +47,7 @@ next: 按 run 停机点循环推进至 done
 
 3. **放弃**: 用户明确不做 $\rightarrow$ `abort --run <id> --to superseded|cancelled --delegated "<原话>"` (approved 文档逐份走 confirm-doc --to)
 4. **观测** (可选): `status [--run <id>] [--json]` 全量事件流水 / `watch` 终端轮询视图
+5. **并行写同一页**: 多个 arm 要改同一 `workflow/` 或 `wiki/` 页面时，先 `node .agents/scripts/path-lease.mjs acquire --path <page> --owner <arm>`，写完 `release`；一页一 writer。
 
 ## 🚫 硬纪律 (违反即协议破坏)
 

package/templates/engine/.agents/commands/stages.md

@@ -212,7 +212,8 @@ L1 不在本章起草 plan，回 `.agents/commands/new-task.md` §L1 快速道
 1. **执行门禁**: `node .agents/scripts/verify.mjs`（档位口径以 verify.mjs 头注为准，本文不复述）。项目构建、测试、类型检查的命令清单单源是 `.agents/hooks/commit-check.config.json`。
 2. **故障处置**: 任一失败 $\rightarrow$ **HALT**。L1 回 `.agents/commands/new-task.md` 快速道第 5 步改代码。L2/L3 回 Build 章修复。偶发/跨层问题用 `diagnosing-bugs` 诊断。全量首跑红、隔离重跑转绿不算绿：按 flaky 立项（papercut/incident）后修复，禁以重跑绿直接关单。
 3. **档位按任务小类**: 纯文档/业务面 → 默认档（产品门按 diff 面裁）；跨面或发版前 → `--full`。引擎面无测试门，`*.test.mjs` 不入库不自动跑（2026-10-29 清库）；手动工具——合并语义探针 `node .agents/scripts/check-loop-rev-semantics.mjs`（FULL 模式末尾自动跑）。
-**Output**: 静态门全绿证据
+4. **行为评测（引擎面/模型面）**: 本批改动触及 `.agents/skills/**`、`.agents/commands/**`、`.agents/roles/**` 或模型配置时，跑 `node .agents/scripts/agent-eval.mjs check`。无当前内容签名的凭证 → 按 `.agents/skills/eval/SKILL.md` 跑任务集，再 `agent-eval.mjs record`。**修复类**在动手前 `node .agents/scripts/fix-task.mjs start`，关单后 `stop`——窗口内修改既有测试会被写前门拒绝（新建复现测试放行）。
+**Output**: 静态门全绿证据 +（引擎面/模型面）行为评测凭证
 **Note**: 运行环境细节见 `.agents/notes/runtime-env.md` §1, §2；长门禁命令（verify 全量/`dotnet test`）**分段等 + 每段回报进度**，不阻塞到 timeout 上限——口径 §6.4「后台长任务取结果」
 
 ## 2. 切库冒烟 (DB Smoke Test)

package/templates/engine/.agents/config/agent-eval.json

@@ -0,0 +1,17 @@
+{
+  "version": 1,
+  "sensitive": [
+    ".agents/skills/**",
+    ".agents/commands/**",
+    ".agents/roles/**",
+    ".agents/config/model-roles.json",
+    ".agents/config/steering.json",
+    ".agents/config/pipeline.json",
+    ".agents/config/agent-eval.json"
+  ],
+  "results": ".agents/evals/results.jsonl",
+  "threshold": 0.8,
+  "maxAgeDays": 30,
+  "minTasks": 5,
+  "advisory": false
+}

package/templates/engine/.agents/config/mechanism-registry.md

@@ -41,10 +41,11 @@
 | 接线宣称一致性（check-hook-wiring） | .githooks/pre-push（推送范围触宿主壳/.agents/hooks/registry 条件执行，实测 <1s）+ 手动——check-hook-wiring.mjs 的 CLAIMS 表 ↔ 宿主配置实态对账 | 漂移拦截计数（月，人工对账） | registry 各行接线信息改为机读结构（宣称随行携带）→ 评估退役 | 2026-10-29 建：引擎测试面退役后接线漂移无自动防线的补位（首跑产出即上行「轮询门修正」案例） | 现役 [检出型] | — |
 | 先确认后改代码 | .githooks/commit-msg 接线 `.agents/hooks/check-confirm-order.mjs`（暂存产品路径才跑；合并族跳过；2026-11-08 档 2-D 自 pre-commit 位移——pre-commit 看不到消息）。豁免 A：消息体非空 `L0:` 行且产品 ≤5 放行（judgments 落账 L0 计数）；豁免 B：覆盖 plan 与产品同批 staged（done 亦可，L1 单笔提交）放行 | hard「路径不在 approved plan 正文」拒绝计数 + L0 放行计数（月，人工对账） | 不退役（顺序红线主干。增量理由：确认指纹只核状态与承诺面，不核发生顺序；历史 done plan 仍不算覆盖，仅同批 staged 算） | 2026-11-03 建（incident 2026-11-03-po-pml-outbound-guards：实现提交先于三件套，check-loop 期间无阻塞） | 现役 [不退役主干] | — |
 | 提交信息卫生检出（ci-commit-hygiene） | azure-pipelines.yml ci-push-before 后无条件步（中/重两档）；区间三层——PR 构建取合并提交第一父（目标分支尖端）只判本 PR 新增提交、推送构建用 CI_PUSH_BEFORE、缺省退 HEAD~1（2026-11-05 build 29054 假红修正：changes API 基准会拉入目标侧存量提交）——枚举/正则单源 commit-msg-rules.json 与 .githooks/commit-msg 同判 | CI 红计数（违规笔数，检出型） | 连续 6 月 = 0 → 评估退役 | 2026-11-05 建（复盘 P0：钩子未挂/--no-verify 且消息违规 → CI 可见；不覆盖消息恰好合法的绕过） | 现役 [检出型] | 复评 2027-02-05 |
-| Dreaming 持续运行链路（dream-run 接线） | .githooks/post-commit（advisory 第三段，≥7 天提醒）+ `.agents/skills/dream/SKILL.md`（session-resume 装载、会话内执行）+ dream-run.mjs E2 阶段 | 冷数据候选数（agg-kb-usage --stale-days 90，月；kb-search 命中遥测 `.agents/cache/kb-usage.jsonl` 为数据源） | 不退役（Anthropic Dreaming 对照的记忆维护主干）；数据面按「有数据月」对账 | 2026-11-11 建（对照文章补接线：post-commit 7 天提醒 + 会话内执行链路 + kb-search 命中遥测 + E2 冷数据候选） | 现役 [数据面] | — |
+| Dreaming 持续运行链路（dream-run 接线） | .githooks/post-commit（advisory 第三段，≥7 天提醒）+ `.agents/skills/dream/SKILL.md`（session-resume 装载、会话内执行）+ dream-run.mjs E2 阶段 + 主张依据节（claims.mjs recheck，只报告，退出码 0，不进门） | 冷数据候选数（agg-kb-usage --stale-days 90，月；kb-search 命中遥测 `.agents/cache/kb-usage.jsonl` 为数据源）；主张 broken 数（dream-report，月；数据源 `workflow/claims.d/*.jsonl`） | 不退役（Anthropic Dreaming 对照的记忆维护主干）；数据面按「有数据月」对账 | 2026-11-11 建（对照文章补接线：post-commit 7 天提醒 + 会话内执行链路 + kb-search 命中遥测 + E2 冷数据候选）；2026-11-12 主张账：核对只报告，不改正文 | 现役 [数据面] | — |
 | PI 宿主门禁接线（本机私有） | .pi/extensions/shipyard-gates.ts（session_start 接线自检 + tool_call → pre-shell-check.cjs / pre-write-check.cjs，判据单源在 .agents/hooks/）；check-local-gates.mjs advisory 对账 4 必需文件 + project trust | 接线缺失 / trust 未检出的 WARN 计数（月，advisory 输出）；pi 会话 tool_call 门 deny 计数（gates.json 判据） | 不适用零命中退役（[健康静默]：0 命中 = 接线健康）；本仓不再使用 pi 宿主或宿主原生提供等价门禁 → 评估退役 | 2026-11-11 建门（P0 补 ctx_execute / ctx_batch 绕过口、createRequire 修 /reload CJS 缓存）；增量理由：.pi/ 不随 clone 传播，接线缺失时 session_start 自检随之消失，无外部防线 | 现役 [健康静默] | — |
 | Cline 宿主适配（本机私有） | .cline/workflows/wf-*.md（7 指针壳 → `.agents/commands/`）+ .cline/agents/*.yml（7 角色 → `.agents/roles/`）+ `.cline/hooks/PreToolUse.cjs`（命令门/写前门协议适配层 → pre-shell-check.cjs / pre-write-check.cjs）；权威源零改动 | check-local-gates.mjs advisory 对账（workflows+agents 壳 + hook 在位） | 不适用零命中退役（[健康静默]：未用 ≠ 失效）；弃用 → 评估退役 | 2026-11-11 建（Cline 原生读 `AGENTS.md` 与 `.agents/skills/`；hook 协议与仓库 CJS 不兼容，故建适配层，参照 `.pi/extensions/lib/gates-core.cjs` 同型映射） | 现役 [健康静默] | — |
 | Claude Code 宿主适配（本机私有） | `.claude/settings.json` PreToolUse 两门（`Bash` → pre-shell-check.cjs；`Write\|Edit\|MultiEdit` → pre-write-check.cjs）+ `.claude/commands/wf-*.md`（7 指针壳 → `.agents/commands/`）+ `.claude/agents/*.md`（7 角色 → `.agents/roles/`）；根 `CLAUDE.md` 为 AGENTS.md 镜像；权威源零改动 | check-local-gates.mjs ⑩ advisory 对账（settings 两门接线 + 7+7 壳） | 不适用零命中退役（[健康静默]：未用 ≠ 失效）；弃用 → 评估退役 | 2026-11-11 建（hook 协议与 Trae/CodeBuddy 同形；`.claude/` 与 CLAUDE.md gitignore 不随 clone）。增量理由：Claude 会话此前无宿主侧两门，仅 git 钩子兜底 | 现役 [健康静默] | — |
+| 测试守卫 | pre-write §2.5 | 改测试 deny/月 | 不退役 | 2026-11-12 | 现役[不退役主干] | — |
 
 ## 维护纪律
 

package/templates/engine/.agents/config/memory-tiers.json

@@ -0,0 +1,13 @@
+{
+  "version": 1,
+  "injected": {
+    "file": ".agents/notes/injected-memory.md",
+    "maxLines": 200,
+    "maxBytes": 25600
+  },
+  "promotion": {
+    "candidates": ".agents/cache/memory-promotions.jsonl",
+    "minOccurrences": 3,
+    "outputDir": "tmp"
+  }
+}

package/templates/engine/.agents/config/pipeline.json

@@ -0,0 +1,36 @@
+{
+  "version": 1,
+  "stages": [
+    "triage",
+    "adopted",
+    "intent-draft",
+    "intent-fill",
+    "intent-confirm",
+    "spec-draft",
+    "spec-fill",
+    "spec-review",
+    "spec-confirm",
+    "plan-draft",
+    "plan-fill",
+    "plan-confirm",
+    "implement",
+    "verify",
+    "changes-confirm",
+    "fix",
+    "review",
+    "review-only",
+    "verify-only",
+    "deploy-prep",
+    "deploy-check",
+    "deploy-await",
+    "done-confirm",
+    "closeout",
+    "incident-draft",
+    "incident-fill",
+    "incident-confirm",
+    "incident-fixed-confirm",
+    "incident-closed-confirm",
+    "done"
+  ],
+  "stopTypes": ["work-order", "await-confirm", "gate-fail", "done", "aborted"]
+}

package/templates/engine/.agents/config/steering.json

@@ -0,0 +1,28 @@
+{
+  "version": 1,
+  "defaultTier": "standard",
+  "tiers": {
+    "frontier": {
+      "scaffolding": "goal",
+      "judgmentLatitude": "high",
+      "guidance": "给目标、约束、验收与红线；少给逐步指令。固定‘只记失败’这类规则可能削弱强模型，保留判断空间。"
+    },
+    "standard": {
+      "scaffolding": "mixed",
+      "judgmentLatitude": "medium",
+      "guidance": "保留确认门与检查清单；实现步骤可精简，关键判据必须显式。"
+    },
+    "lean": {
+      "scaffolding": "step",
+      "judgmentLatitude": "low",
+      "guidance": "给明确步骤、模板与反例；用门禁兜住判断缺口。"
+    }
+  },
+  "invariants": [
+    "确认门与不可逆操作红线",
+    "独立复核与职责分离",
+    "单源纪律（同一事实只写一处）",
+    "测试不可弱化",
+    "提交与推送门禁"
+  ]
+}

package/templates/engine/.agents/evals/README.md

@@ -0,0 +1,49 @@
+# 行为评测（agent-eval）
+
+静态门回答“脚本是否还能跑”；行为评测回答“智能体的行为是否还一样”。
+
+适用改动面（`.agents/config/agent-eval.json` 的 `sensitive`）：
+
+- `.agents/skills/**`、`.agents/commands/**`、`.agents/roles/**`
+- 模型角色 / 严格度 / pipeline 配置
+
+## 跑一次
+
+1. 按 `.agents/skills/eval/SKILL.md` 准备任务集：5–10 条，有已知判据，正负例都有。
+2. 用新子代理跑两臂（A=新配置，B=旧配置），同模型、同上下文、盲评。
+3. 用 `eval-score.mjs` 算通过率，然后落凭证：
+
+```bash
+node .agents/scripts/agent-eval.mjs record --pass-rate 0.9 --tasks 8 --model opus --note "skill x v2"
+```
+
+4. 门禁检查：
+
+```bash
+node .agents/scripts/agent-eval.mjs check            # 严格：无凭证/过期/不达标 → 非零
+node .agents/scripts/agent-eval.mjs check --advisory # 试点：只告警
+```
+
+## 新装为什么严格 check 会失败
+
+新装项目没有任何评测凭证，`check` 报 `no-eval-for-tree` 是**门在工作**，不是安装坏了。
+此时只有两条路：
+
+1. 按上面的流程真跑一次评测并 `record`（推荐）；
+2. 试点期在 CI 里用 `--advisory`，严格 check 留到改敏感面时再跑。
+
+`record` 拒绝不可追溯的凭证：`--pass-rate` 必须是 0..1 的显式值，`--tasks` 不少于
+`minTasks`（默认 5），`--model` 不能为空。不要把 `record --pass-rate 1` 当“免测开关”。
+
+## 判据
+
+- 凭证绑定的是**评测敏感面的内容签名**，不是提交号：只改业务代码不会让凭证失效。
+- 凭证默认 30 天过期；模型升级、技能重写、命令改步骤都应重跑。
+- `results.jsonl` 是 append-only 台账；多机/多分支用 jsonl-union 合并。
+- 通过率写“A 臂命中率”；Δ 与翻转任务留在评测报告里，不进凭证。
+- `results.jsonl` 属于运行态：不随安装器模板出厂（`listFiles` 已排除），否则新项目会继承一张假凭证。
+
+## 放进 CI
+
+`templates/git/azure-pipelines.yml` 与 `templates/git/.github/workflows/ci.yml`
+在 `verify --full` 之后调用 `check --advisory`。稳定后去掉 `--advisory`。

package/templates/engine/.agents/evals/tasks.tsv

@@ -0,0 +1,6 @@
+task	expected
+skill-trigger-positive	相关任务能加载该技能并按其约束执行
+skill-trigger-negative	无关任务不加载该技能、不引入额外步骤
+command-step-order	按命令文件的确认门顺序执行，不跳过确认
+role-contract	角色只做契约内动作，越界即停
+model-quality	强模型档不因过度分步提示而降低判断质量

package/templates/engine/.agents/hooks/pre-write-check.cjs

@@ -159,6 +159,33 @@ if (proposed !== null && LEDGER_RE.test(rel)) {
   }
 }
 
+// ── 2.5) 测试不可弱化（fix 任务窗口）──────────────────
+// Anthropic AI-native SDLC：修复时，写代码的 agent 不得削弱证明修复有效的检查。
+// 协议：修复开始前 `node .agents/scripts/fix-task.mjs start` 落 .agents/cache/fix-task.json；
+// 结束后 stop。窗口内改既有测试 → deny；新建测试（复现用例）放行。
+// 逃生口：① --test 预登记允许路径；② 提议内容含 `TEST-GUARD-ALLOW: <理由>`（保留给合法重构，
+// 复核时可见）；③ 用户明示的 write-gate 解锁。
+const TEST_PATH_RE = /(^|\/)(tests?|__tests__)\/|\.(test|spec)\.[cm]?[jt]sx?$|Tests?\.(cs|java|kt)$|_test\.(go|py)$|^test_.*\.py$|\.feature$/;
+try {
+  const marker = path.join(root, '.agents', 'cache', 'fix-task.json');
+  if (!unlocked && TEST_PATH_RE.test(rel) && fs.existsSync(marker)) {
+    let task = null;
+    try { task = JSON.parse(fs.readFileSync(marker, 'utf8')); } catch { task = null; }
+    if (task && task.active !== false) {
+      const existed = fs.existsSync(abs);
+      const allowed = Array.isArray(task.allowedTests) && task.allowedTests.some((p) => String(p).replace(/\\/g, '/') === rel);
+      const escape = typeof proposed === 'string' && /TEST-GUARD-ALLOW:\s*\S+/.test(proposed);
+      // 新建测试 = 失败的复现用例，允许；修改/删除既有测试一律拦。
+      if (existed && !allowed && !escape) {
+        deny(`测试不可弱化：当前处于修复任务窗口（${task.id || 'fix'}），不得修改既有测试 ${rel}。\n`
+          + '允许：新建复现测试；或让修复只改实现。\n'
+          + '如属合法重构：在提议内容里加 `TEST-GUARD-ALLOW: <理由>`，并在复核中说明；'
+          + '或先结束窗口 node .agents/scripts/fix-task.mjs stop。');
+      }
+    }
+  }
+} catch { /* 标记读取失败 → 放行，git 钩子与独立复核兜底 */ }
+
 // ── 3) 红线内容判据（快照-换入-跑真实门-恢复）─────────
 const gates = [];
 if (/^backend\/.+\.(cs|csproj|sln)$/i.test(rel)) {

package/templates/engine/.agents/notes/injected-memory.md

@@ -0,0 +1,14 @@
+# 注入层（Injected Memory）
+
+> 每次会话都会加载的文件。**上限 200 行 / 25KB**（见 `.agents/config/memory-tiers.json`）。
+> 只放“每次都必须知道”的稳定事实；细节一律用链接下沉。
+> 更长不等于更有效：指令文件越长，遵循度越低（Anthropic agent memory 研究）。
+> 由 dreaming 的 `memory-tier audit/suggest` 维护；`suggest` 只出候选，不自动改本文件。
+
+- 入口与定级：`.agents/commands/new-task.md`
+- L2/L3 阶段流：`.agents/commands/stages.md`
+- 会话重入：`.agents/skills/session-resume/SKILL.md`
+- 主张账（未来会当真的话）：`workflow/claims.d/`
+- 记忆地图：`wiki/_memory/INDEX.md`
+- 行为评测门：`.agents/scripts/agent-eval.mjs`
+- 离线梦境：`.agents/skills/dream/SKILL.md`

package/templates/engine/.agents/notes/steering-tiers.md

@@ -0,0 +1,28 @@
+# 严格度分层（steering tiers）
+
+> 背景：Anthropic agent memory 研究显示，对更强模型，事先写死的固定规则
+> （例如“只记录失败”）会削弱记忆带来的增益；告诉它“记忆用来做什么”，比规定“怎么用”更有效。
+> Playbook 也提醒：更长/更细的指令文件会降低遵循度。
+
+## 分层
+
+| 档 | 适用 | 脚手架 | 判断空间 |
+|---|---|---|---|
+| frontier | 强推理模型（judgment/review） | goal（目标 + 约束 + 验收） | 高 |
+| standard | 默认 | mixed（确认门 + 精简步骤） | 中 |
+| lean | 小模型/低成本实现 | step（明确步骤 + 模板 + 反例） | 低 |
+
+配置单源：`.agents/config/steering.json`；解析：
+`node .agents/scripts/steering.mjs resolve --model opus`。
+
+## 什么永远不能“按档放宽”
+
+`invariants` 列表里的内容不随模型档位变化：确认门、独立复核、单源、测试不可弱化、提交/推送门禁。
+分层只调整**表达方式**（目标式 vs 步骤式），不调整**底线**。
+
+## 切换口径
+
+- 换模型后先跑 `.agents/skills/model-upgrade/SKILL.md` 的评测。
+- 强模型档发现命令文件步骤过细、反而降低判断质量时，把该命令的实现段改成目标式；
+  确认门与验收判据保留。
+- 弱模型档不要靠“它应该懂”省略步骤；用模板与门禁补。