agentic-flow-kit 0.2.1 → 0.3.1

package/README.md

@@ -60,4 +60,6 @@ modules/gates/      可选门禁模块（dotnet-ca：Clean Architecture 参考
 - [x] v0.1.0：init（flags 模式）+ doctor + 4 宿主适配 + dotnet-ca 门禁模块
 - [x] v0.2.0：sync 升级（未动覆盖 / 已改跳过报告 + `--force` / 生成器锚点重写）+ add-host / add-gate
 - [x] v0.2.0 已发布：npm view agentic-flow-kit（npx agentic-flow-kit init 即用；默认镜像源用户需等 npmmirror 同步或 --registry npmjs）
-- [x] v0.2.1：Shipyard 回流第二笔（模板引用去死链 + owned 台账记账策略：add-gate 接线刷新 + sync 盘面自愈）+ 全项目审查修复（量化台账 fail-loud / 生成器锚点与 ENOENT 守卫 / sync 跳过件持续报告 / P4 清账 / metrics glob 词表收口）——npm publish 待执行
+- [x] v0.2.1：Shipyard 回流第二笔（模板引用去死链 + owned 台账记账策略：add-gate 接线刷新 + sync 盘面自愈）+ 全项目审查修复（量化台账 fail-loud / 生成器锚点与 ENOENT 守卫 / sync 跳过件持续报告 / P4 清账 / metrics glob 词表收口）——已发布
+- [x] v0.3.0：init 交互升级（序号菜单 + ANSI 色彩降级 + ts/js 技术栈别名归一 node）+ AGENTS.md 骨架探测补齐（已存在无标记时文末追加，原内容保留）+ wiki 模板预置 7 主题内容目录 + 关单 verify 固定编排（npm test + check-loop 一键过门，非绿不关单）+ workflow 看板纸墨视觉改版
+- [x] v0.3.1：doctor 修复——Windows 无 sh 环境（PowerShell）把 sh ENOENT 误报成 check-loop hard-block（探测分流：明示「未跑勿当作通过」，git 钩子门禁不受影响）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-flow-kit",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "AI-Native 闭环工作流 + wiki 知识层脚手架——flow-kit init 一条命令为新项目装好 .agents 工作流引擎（阶段命令/角色契约/门禁钩子/kb 检索/看板/规则面预算）+ workflow 文档闭环 + wiki 知识库，装完自包含、零运行时依赖",
   "type": "module",
   "scripts": {

package/src/cli.mjs

@@ -14,7 +14,8 @@ const PKG_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..'
 export const HELP = `flow-kit — AI-Native 闭环工作流 + wiki 知识层脚手架（agentic-flow-kit）
 
 用法：
-  flow-kit init             安装到当前项目（裸跑无参数 → 交互确认环节；带参数直接执行）
+  flow-kit init             安装到当前项目（裸跑无参数 → 交互确认环节；带参数直接执行；
+                            已存在的 AGENTS.md 无工作流骨架时文末追加补齐，其余已存在文件保守跳过）
   flow-kit sync             升级 managed 文件（未改动→覆盖新版；本地已改→跳过并持续报告——台账不基线化，
                             不会被下次升级静默覆盖；--force 才覆盖；INDEX/看板等生成器目标重跑锚点重写；
                             owned 文件永不触碰）
@@ -23,7 +24,8 @@ export const HELP = `flow-kit — AI-Native 闭环工作流 + wiki 知识层脚
   flow-kit doctor           体检：目录布局 / git 钩子 / managed 清单 / 索引漂移 / check-loop
 
 init 选项（全部可选，均有默认值）：
-  --stack <技术栈>     dotnet | node | python | go | none（默认 none）——门禁配置三处：commit-check
+  --stack <技术栈>     dotnet | node（ts/js） | python | go | none（默认 none；ts/js/typescript/javascript
+                       归一为 node）——门禁配置三处：commit-check
                        条件编译检查（builds）与质量检测（checks：lint/类型/vet 等秒级确定性检查，
                        有对应配置文件才启用）、settings.json 自检验命令权限（allow）、
                        AGENTS.md「项目适配区」命令预填

package/src/doctor.mjs

@@ -127,13 +127,20 @@ export function doctor(args, pkgRoot) {
     else add('WARN', `delegations 台账结构漂移——${String(agg.stderr || agg.stdout || '').split('\n')[0]}`);
   }
 
-  // 7. check-loop
-  const cl = spawnSync('sh', ['.agents/scripts/check-loop.sh'], { cwd: target, encoding: 'utf8' });
-  if (cl.status === 0) {
-    const warnTxt = String(cl.stderr || '').trim();
-    add('PASS', `check-loop 干净${warnTxt ? `（${warnTxt.split('\n').filter((l) => l.includes('WARN')).length} 条 advisory 警告）` : ''}`);
+  // 7. check-loop——先探 sh 可用性（对齐 run-tests.mjs 先例）：Windows PowerShell 常无 sh，
+  //    ENOENT 曾被吞进 hard-block 分支报成空原因假警报（incident 2026-09-24-doctor-sh-enoent）。
+  //    git 钩子门禁不受此影响——git 以自带 sh 执行钩子，与用户 PATH 无关。
+  const shProbe = spawnSync('sh', ['-c', 'true'], { encoding: 'utf8' });
+  if (shProbe.status !== 0) {
+    add('WARN', '环境无 sh——check-loop 未跑，勿当作通过；装 Git Bash / WSL 后重跑 doctor（git 钩子门禁不受影响，git 以自带 sh 执行）');
   } else {
-    add('FAIL', `check-loop 有 hard-block：\n${String(cl.stderr || '').split('\n').slice(0, 8).join('\n')}`);
+    const cl = spawnSync('sh', ['.agents/scripts/check-loop.sh'], { cwd: target, encoding: 'utf8' });
+    if (cl.status === 0) {
+      const warnTxt = String(cl.stderr || '').trim();
+      add('PASS', `check-loop 干净${warnTxt ? `（${warnTxt.split('\n').filter((l) => l.includes('WARN')).length} 条 advisory 警告）` : ''}`);
+    } else {
+      add('FAIL', `check-loop 有 hard-block：\n${String(cl.stderr || '').split('\n').slice(0, 8).join('\n')}`);
+    }
   }
 
   // 8. 看板端口（信息级）

package/src/init.mjs

@@ -4,8 +4,8 @@ import fs from 'node:fs';
 import path from 'node:path';
 import readline from 'node:readline';
 import { execSync, spawnSync } from 'node:child_process';
-import { renderTree, sha256 } from './render.mjs';
-import { HOSTS, STACKS, settingsJson, commitCheckConfig, pickStackVars, isOwned } from './profiles.mjs';
+import { renderTree, renderContent, sha256 } from './render.mjs';
+import { HOSTS, STACKS, STACK_ALIASES, settingsJson, commitCheckConfig, pickStackVars, isOwned } from './profiles.mjs';
 import { doctor } from './doctor.mjs';
 
 function fail(msg) {
@@ -42,21 +42,85 @@ function makePrompt() {
   };
 }
 
-// 交互确认环节：宿主多选 → 看板端口 → 显式确认（EOF / 非 y 一律取消，不装）
+// ---- TUI 风格：hand-rolled ANSI（零依赖纪律）；NO_COLOR / 非 TTY 自动降级纯文本 ----
+const RAW = !process.env.NO_COLOR && process.stdout.isTTY;
+const paint = (code, s) => (RAW ? `\x1b[${code}m${s}\x1b[0m` : String(s));
+const bold = (s) => paint('1', s);
+const dim = (s) => paint('2', s);
+const cyan = (s) => paint('36', s);
+
+// normalizeStack：ts/js 用户口径归一为 node 栈；其余小写透传（STACKS 校验兜底未知值）
+export function normalizeStack(s) {
+  const t = String(s || '').trim().toLowerCase();
+  return STACK_ALIASES[t] || t;
+}
+
+// parseChoices：序号/名称/混输多选解析（逗号/全角逗号/空白分隔，去重保序）；
+// 空输入 → [def]（EOF/直接回车安全回退默认）；含非法 token 返回 null（调用方就地重问）；
+// map 用于输入侧归一（如 ts→node），序号先于 map 解析。
+export function parseChoices(input, names, def, map = (x) => x) {
+  const text = String(input || '').trim();
+  if (!text) return [def];
+  const out = [];
+  for (const tok of text.split(/[,，\s]+/).filter(Boolean)) {
+    const i = /^\d+$/.test(tok) ? Number(tok) - 1 : names.indexOf(map(tok.toLowerCase()));
+    if (!Number.isInteger(i) || i < 0 || i >= names.length) return null;
+    if (!out.includes(names[i])) out.push(names[i]);
+  }
+  return out;
+}
+
+// ---- AGENTS.md 骨架探测与追加补齐 ----
+// 标记随模板渲染落盘：新装/补齐后的 AGENTS.md 都含它，探测以此为准（不猜标题——避免误伤项目自写的同名「AI工作流」节）
+const SKELETON_MARKER = '<!-- flow-kit:agents-skeleton -->';
+export function hasAgentsSkeleton(text) {
+  return String(text || '').includes(SKELETON_MARKER);
+}
+// mergeAgents：原内容在上（尾部空白折叠），空行分隔，含标记的完整骨架在下
+export function mergeAgents(existing, incoming) {
+  const head = String(existing || '').replace(/\s+$/, '');
+  const tail = String(incoming || '').trim();
+  return head ? `${head}\n\n${tail}\n` : `${tail}\n`;
+}
+
+// 交互确认环节：序号菜单问答（宿主多选 → 技术栈 → 看板端口）→ 已选 recap → 显式确认
+// （EOF / 非 y 一律取消，不装；makePrompt 行式语义不变——管道/EOF 安全回退默认）
 async function interactive() {
   const p = makePrompt();
-  console.log('▶ flow-kit init（交互模式——裸跑无参数时进入；带参数则直接执行，见 flow-kit --help）');
-  console.log('  将在当前目录安装：.agents/ ｜ .githooks/ ｜ workflow/ ｜ wiki/ ｜ AGENTS.md（已存在的文件保守跳过）');
+  const hostNames = Object.keys(HOSTS);
+  const stackNames = Object.keys(STACKS);
+  const stackLabel = (n) => (n === 'node' ? 'node（ts/js）' : n);
+  const menu = (names) => '  ' + names.map((n, i) => dim(`${'①②③④⑤⑥'[i]} ${stackLabel(n)}`)).join(dim('   '));
+
+  console.log(bold(cyan('▶ flow-kit init')) + dim(' · AI 闭环工作流 + wiki 知识层脚手架'));
+  console.log(dim('  安装到当前目录：.agents/ · .githooks/ · workflow/ · wiki/ · AGENTS.md（已存在的文件保守跳过；AGENTS.md 无工作流骨架时文末追加补齐）'));
   try {
-    const hosts = await p.ask('1/3 选择 agent 宿主（逗号分隔：zcode / opencode / trae / omp）', 'zcode');
-    const stack = await p.ask('2/3 技术栈——决定编译检查与自检验命令初值（dotnet / node / python / go / none）', 'none');
-    const boardPort = await p.ask('3/3 workflow 看板端口', '8933');
-    const yes = await p.ask('确认安装到当前目录？(y/n)');
+    let hosts;
+    for (;;) {
+      console.log(`\n${cyan('── 1/3 · agent 宿主')} ${dim('· 可多选')}`);
+      console.log(menu(hostNames));
+      const picked = parseChoices(await p.ask(dim('  序号或名称，逗号分隔（直接回车 = zcode）')), hostNames, hostNames[0]);
+      if (picked) { hosts = picked; break; }
+      console.log(dim('  ⚠️ 没认出这个组合——序号或名称再来一次（如 1,3 或 zcode,trae）'));
+    }
+    let stack;
+    for (;;) {
+      console.log(`\n${cyan('── 2/3 · 技术栈')} ${dim('· 决定编译检查与自检验命令初值')}`);
+      console.log(menu(stackNames));
+      const picked = parseChoices(await p.ask(dim('  序号或名称（直接回车 = none；ts/js 自动归一 node）')), stackNames, 'none', normalizeStack);
+      if (picked) { stack = picked[0]; break; }
+      console.log(dim('  ⚠️ 没认出——序号或名称再来一次'));
+    }
+    console.log(`\n${cyan('── 3/3 · workflow 看板端口')}`);
+    const boardPort = (await p.ask(dim('  直接回车 = 8933'))) || '8933';
+
+    console.log(`\n  ${bold(`宿主 ${hosts.join('、')}`)}${dim(' ｜ ')}${bold(`技术栈 ${stack}`)}${dim(' ｜ ')}${bold(`端口 ${boardPort}`)}`);
+    const yes = await p.ask(dim('  确认安装到当前目录？(y/n，回车取消)'));
     if (!/^(y|yes)$/i.test(yes)) {
       console.log('已取消（未做任何改动）');
       process.exit(0);
     }
-    return { hosts, stack, boardPort, dir: process.cwd(), force: false };
+    return { hosts: hosts.join(','), stack, boardPort, dir: process.cwd(), force: false };
   } finally {
     p.close();
   }
@@ -84,7 +148,8 @@ export async function init(args, pkgRoot) {
     }
   }
 
-  if (!STACKS[opt.stack]) fail(`未知技术栈：${opt.stack}（可选 dotnet | node | python | go | none——对应编译检查与自检验命令初值）`);
+  opt.stack = normalizeStack(opt.stack);
+  if (!STACKS[opt.stack]) fail(`未知技术栈：${opt.stack}（可选 dotnet | node（ts/js） | python | go | none——对应编译检查与自检验命令初值）`);
   const hosts = opt.hosts.split(',').map((s) => s.trim()).filter(Boolean);
   for (const h of hosts) {
     if (!HOSTS[h]) fail(`未知宿主：${h}（可选 ${Object.keys(HOSTS).join(' | ')}）`);
@@ -99,11 +164,29 @@ export async function init(args, pkgRoot) {
 
   const vars = { BOARD_PORT: String(opt.boardPort), ...pickStackVars(opt.stack) };
 
-  console.log(`▶ flow-kit init → ${target}`);
+  console.log(`${bold(cyan('▶ flow-kit init'))}${dim(' → ')}${target}`);
   console.log(`  宿主：${hosts.join(', ')} ｜ 技术栈：${opt.stack} ｜ 看板端口：${opt.boardPort}`);
 
   // 1) 模板树（保守：已存在文件跳过，--force 覆盖）
   const t = renderTree(path.join(pkgRoot, 'templates'), target, vars, { force: opt.force });
+
+  // 1.5) AGENTS.md 特例：已存在且无骨架标记 → 文末追加补齐（原内容保留）；带标记 → 保守跳过
+  let agentsMergedSha = null;
+  if (t.skipped.includes('AGENTS.md')) {
+    const agentsAbs = path.join(target, 'AGENTS.md');
+    const existing = fs.readFileSync(agentsAbs, 'utf8');
+    if (hasAgentsSkeleton(existing)) {
+      t.skipped = t.skipped.filter((r) => r !== 'AGENTS.md'); // 专属提示已报，不进末尾「未覆盖」汇总重复列
+      console.log('  跳过（已存在且含工作流骨架）：AGENTS.md');
+    } else {
+      const incoming = renderContent(fs.readFileSync(path.join(pkgRoot, 'templates', 'AGENTS.md'), 'utf8'), vars);
+      fs.writeFileSync(agentsAbs, mergeAgents(existing, incoming));
+      agentsMergedSha = sha256(fs.readFileSync(agentsAbs));
+      t.skipped = t.skipped.filter((r) => r !== 'AGENTS.md');
+      console.log('  AGENTS.md 已存在但无工作流骨架——文末追加补齐（原内容保留，「项目适配区」照常自填）');
+    }
+  }
+
   // 2) 宿主适配层
   const hostResults = {};
   for (const h of hosts) {
@@ -155,6 +238,7 @@ export async function init(args, pkgRoot) {
     ...hosts.flatMap((h) => hostResults[h].written.map((f) => ({ ...f, rel: `${HOSTS[h].dir}/${f.rel}` }))),
   ];
   const owned = [...t.written.filter((f) => isOwned(f.rel)), ...ownedGenerated];
+  if (agentsMergedSha) owned.push({ rel: 'AGENTS.md', sha256: agentsMergedSha });
   const pkg = JSON.parse(fs.readFileSync(path.join(pkgRoot, 'package.json'), 'utf8'));
   fs.mkdirSync(path.dirname(kitPath), { recursive: true });
   fs.writeFileSync(kitPath, `${JSON.stringify({

package/src/init.test.mjs

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+// init.mjs 交互解析纯函数测试（normalizeStack / parseChoices）——不触真实安装与 stdin
+// 断言：①ts/js 别名归一 node；②序号/名称/混输/全角逗号/空白分隔解析正确（去重保序）；
+//       ③非法输入返回 null（就地重问信号）；④空输入回默认（EOF/直接回车安全回退）。
+// 用法：node src/init.test.mjs
+import { normalizeStack, parseChoices, hasAgentsSkeleton, mergeAgents } from './init.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 HOSTS = ['zcode', 'opencode', 'trae', 'omp'];
+const STACKS = ['dotnet', 'node', 'python', 'go', 'none'];
+const eq = (a, b) => JSON.stringify(a) === JSON.stringify(b);
+
+// ---- ① 别名归一 ----
+check('ts/TS/TypeScript/javascript 均归一 node', normalizeStack('ts') === 'node' && normalizeStack('TS') === 'node' && normalizeStack('TypeScript') === 'node' && normalizeStack('javascript') === 'node');
+check('规范名与空值透传', normalizeStack('node') === 'node' && normalizeStack('dotnet') === 'dotnet' && normalizeStack('  go ') === 'go' && normalizeStack('') === '' && normalizeStack(undefined) === '');
+
+// ---- ② 序号/名称/混输解析 ----
+check('序号 1,3 → zcode,trae', eq(parseChoices('1,3', HOSTS, 'zcode'), ['zcode', 'trae']));
+check('名称 trae → trae', eq(parseChoices('trae', HOSTS, 'zcode'), ['trae']));
+check('混输 zcode，3（全角逗号）→ zcode,trae', eq(parseChoices('zcode，3', HOSTS, 'zcode'), ['zcode', 'trae']));
+check('空白分隔 1 3 → zcode,trae', eq(parseChoices('1 3', HOSTS, 'zcode'), ['zcode', 'trae']));
+check('去重保序 3,1,1 → trae,zcode', eq(parseChoices('3,1,1', HOSTS, 'zcode'), ['trae', 'zcode']));
+check('栈序号 2 + map 归一 → node', eq(parseChoices('2', STACKS, 'none', normalizeStack), ['node']));
+check('栈别名 ts + map 归一 → node', eq(parseChoices('ts', STACKS, 'none', normalizeStack), ['node']));
+
+// ---- ③ 非法输入 → null（就地重问） ----
+check('越界序号 9 → null', parseChoices('9', HOSTS, 'zcode') === null);
+check('未知名称 bad → null', parseChoices('zcode,bad', HOSTS, 'zcode') === null);
+check('栈别名未传 map 不归一（ts → null）', parseChoices('ts', STACKS, 'none') === null);
+
+// ---- ④ 空输入回默认 ----
+check('空串 → [def]', eq(parseChoices('', HOSTS, 'zcode'), ['zcode']));
+check('undefined → [def]', eq(parseChoices(undefined, STACKS, 'none'), ['none']));
+
+// ---- ⑤ AGENTS.md 骨架探测与合并 ----
+check('标记探测：带标记 true', hasAgentsSkeleton('x\n<!-- flow-kit:agents-skeleton -->\n# y') === true);
+check('标记探测：外部自写 AGENTS.md false', hasAgentsSkeleton('# 我的项目\n\n构建: dotnet build') === false);
+check('标记探测：空值 false', hasAgentsSkeleton('') === false && hasAgentsSkeleton(undefined) === false);
+check('合并：原内容在上、空行分隔、骨架在下',
+  mergeAgents('# A\n内容', '<!-- m -->\n# B') === '# A\n内容\n\n<!-- m -->\n# B\n');
+check('合并：原内容尾部空白折叠不产生连续空行',
+  mergeAgents('# A\n内容\n\n\n', '<!-- m -->\n# B') === '# A\n内容\n\n<!-- m -->\n# B\n');
+check('合并：原内容为空时骨架即全文', mergeAgents('', '<!-- m -->\n# B') === '<!-- m -->\n# B\n');
+
+console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
+if (fail) {
+  console.log('\n用法：node src/init.test.mjs');
+  process.exit(1);
+}
+process.exit(0);

package/src/profiles.mjs

@@ -62,6 +62,14 @@ export const STACKS = {
   },
 };
 
+// 技术栈别名归一：ts/js 用户口径 → node 栈（init 交互与 --stack 共用；别名不进 kit.json，落盘始终是规范名）
+export const STACK_ALIASES = {
+  ts: 'node',
+  js: 'node',
+  typescript: 'node',
+  javascript: 'node',
+};
+
 // AGENTS.md「项目适配区」的命令预填变量（技术栈未知时留 <填写> 占位）
 export function pickStackVars(stackKey) {
   const s = STACKS[stackKey] || STACKS.none;

package/src/render.mjs

@@ -17,6 +17,11 @@ function relOf(absFile, srcRoot) {
   return parts.join('/');
 }
 
+// renderContent：单文件文本渲染（{{KEY}} 替换，未知占位符原样保留）——renderTree 与 init 的 AGENTS.md 追加补齐共用
+export function renderContent(text, vars) {
+  return String(text || '').replace(PH_RE, (m, key) => (Object.prototype.hasOwnProperty.call(vars, key) ? vars[key] : m));
+}
+
 export function renderTree(srcRoot, targetRoot, vars, { force = false } = {}) {
   const written = [];   // { rel, sha256 }
   const skipped = [];   // rel（已存在，保守跳过）
@@ -43,15 +48,7 @@ export function renderTree(srcRoot, targetRoot, vars, { force = false } = {}) {
       const raw = fs.readFileSync(abs);
       let out = raw;
       if (raw.length < 512 * 1024 && !raw.includes(0)) {
-        const text = raw.toString('utf8');
-        const used = new Set();
-        const replaced = text.replace(PH_RE, (m, key) => {
-          if (Object.prototype.hasOwnProperty.call(vars, key)) {
-            used.add(key);
-            return vars[key];
-          }
-          return m; // 未知占位符原样保留，doctor 会告警
-        });
+        const replaced = renderContent(raw.toString('utf8'), vars);
         if (replaced.includes('{{')) {
           for (const m of replaced.matchAll(/\{\{([A-Z][A-Z0-9_]*)\}\}/g)) {
             if (!Object.prototype.hasOwnProperty.call(vars, m[1])) warnings.push(`${rel}: 未知占位符 {{${m[1]}}}（原样保留）`);

package/src/run-tests.mjs

@@ -9,6 +9,7 @@ const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
 
 const nodeSuites = [
   'src/sync.test.mjs',
+  'src/init.test.mjs',
   ...fs.readdirSync(path.join(ROOT, 'templates/_agents/scripts'))
     .filter((f) => f.endsWith('.test.mjs'))
     .sort()

package/templates/AGENTS.md

@@ -1,3 +1,4 @@
+<!-- flow-kit:agents-skeleton -->
 # AGENTS.md — AI 工作流 + Wiki
 
 > 本文件由 agentic-flow-kit 生成：说明本仓库的 AI 工作流与 Wiki 用法。「项目适配区」由项目自行填写；工作流约定可增不可删。

package/templates/_agents/board/index.html

@@ -2,93 +2,157 @@
 <html lang="zh-CN">
 <head>
 <meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="color-scheme" content="light">
 <title>Workflow 看板 — AI 执行流程</title>
 <script src="/marked.min.js"></script>
 <style>
+  /* ============ 定调：纸墨工业（极致极简 × Industrial） ============
+     暖纸底 + 暖墨字；四类文档各一枚同重量低饱和标签色，只出现在小徽标与卡片左缘；
+     朱红是唯一强调色，只留给告警 / 老化 / 挂起等必须被看见的状态。
+     标题/数字/徽标用本机等宽字体栈（JetBrains Mono→Cascadia→Consolas），正文中文用雅黑；
+     零外部字体请求——看板是 127.0.0.1 本地工具，不引网络资源。 */
   :root {
-    --bg: #14171c; --panel: #1c2027; --card: #232833; --card-hover: #2b3140;
-    --border: #2e3542; --text: #d7dce4; --dim: #8b93a1;
-    --intent: #4f8ef7; --incident: #e0674f; --spec: #9a6ff0; --plan: #2fa87c;
-    --ok: #3fbf7f; --warn: #d9a53a; --bad: #e0674f;
+    --bg: #f2f0e9;            /* 暖纸 */
+    --surface: #f7f5ee;       /* 顶栏 / 抽屉面板 */
+    --card: #fdfcf8;          /* 卡片近白 */
+    --card-hover: #ffffff;
+    --border: #ddd7c8;        /* 发丝线 */
+    --border-strong: #b5ad99;
+    --text: #26241d;          /* 暖墨 */
+    --muted: #6c675a;
+    --faint: #99937f;         /* 仅装饰：滚动条 / 占位符 */
+    --accent: #bc4327;        /* 朱 — 唯一强调色 */
+    --intent: #3f6288; --incident: #a04b35; --spec: #6f5a88; --plan: #3e7157;
+    --ok: #3e7157; --warn: #7d6224; --bad: #a04b35;
+    --shadow-1: 0 1px 2px rgba(38,36,29,.05), 0 3px 10px rgba(38,36,29,.07);
+    --shadow-2: -16px 0 40px rgba(38,36,29,.16);
+    --ease: cubic-bezier(.16, 1, .3, 1);
+    --mono: "JetBrains Mono", "Cascadia Code", Consolas, "Courier New", monospace;
   }
   * { box-sizing: border-box; margin: 0; }
-  body { background: var(--bg); color: var(--text); font: 14px/1.6 "Segoe UI", "Microsoft YaHei", sans-serif; }
-  header { display: flex; align-items: center; gap: 14px; padding: 12px 18px; border-bottom: 1px solid var(--border); }
-  header h1 { font-size: 16px; font-weight: 600; }
-  .chip { font-size: 12px; color: var(--dim); background: var(--panel); border: 1px solid var(--border); border-radius: 10px; padding: 1px 9px; }
-  #sse { display: inline-flex; align-items: center; gap: 5px; font-size: 12px; color: var(--dim); margin-left: auto; }
-  #sse i { width: 8px; height: 8px; border-radius: 50%; background: var(--bad); }
+  ::selection { background: rgba(188,67,39,.18); }
+  ::-webkit-scrollbar { width: 10px; height: 10px; }
+  ::-webkit-scrollbar-thumb { background: var(--border-strong); border-radius: 5px; border: 2px solid var(--bg); }
+  ::-webkit-scrollbar-track { background: transparent; }
+  body { background: var(--bg); color: var(--text); font: 14px/1.7 "Microsoft YaHei", "PingFang SC", "Segoe UI", sans-serif; letter-spacing: .01em; }
+  /* 纸张颗粒：5% 噪点叠层让纸面有物理质感；pointer-events 关闭不挡交互 */
+  body::before { content: ""; position: fixed; inset: 0; z-index: 0; pointer-events: none; opacity: .05;
+    background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='140' height='140'%3E%3Cfilter id='n'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='.9' numOctaves='2'/%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23n)'/%3E%3C/svg%3E"); }
+  header, #board { position: relative; z-index: 1; }
+  :focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
+
+  /* ---- 顶栏：墨字标题 + 朱印章方块（记忆点） ---- */
+  header { display: flex; align-items: center; gap: 14px; height: 58px; padding: 0 22px; background: var(--surface); border-bottom: 1px solid var(--border); }
+  header h1 { font: 700 15px/1 var(--mono); letter-spacing: .02em; }
+  header h1::after { content: ""; display: inline-block; width: 7px; height: 7px; background: var(--accent); margin-left: 9px; }
+  .chip { font: 500 11px/1 var(--mono); color: var(--muted); background: transparent; border: 1px solid var(--border); border-radius: 3px; padding: 4px 8px; font-variant-numeric: tabular-nums; }
+  #sse { display: inline-flex; align-items: center; gap: 6px; font: 11px/1 var(--mono); color: var(--muted); margin-left: auto; }
+  #sse i { width: 7px; height: 7px; border-radius: 50%; background: var(--bad); }
   #sse.on i { background: var(--ok); }
-  #board { display: flex; gap: 10px; padding: 14px 18px; overflow-x: auto; height: calc(100vh - 53px); }
-  .col { flex: 1 1 0; min-width: 215px; display: flex; flex-direction: column; background: var(--panel); border: 1px solid var(--border); border-radius: 8px; }
-  .col h2 { font-size: 13px; font-weight: 600; padding: 9px 12px; border-bottom: 1px solid var(--border); color: var(--dim); }
-  .col h2 b { color: var(--text); margin-right: 4px; }
-  .col .list { flex: 1; overflow-y: auto; padding: 8px; display: flex; flex-direction: column; gap: 7px; }
-  .card { background: var(--card); border: 1px solid var(--border); border-left: 3px solid var(--border); border-radius: 6px; padding: 8px 10px; cursor: pointer; }
-  .card:hover { background: var(--card-hover); border-color: var(--dim); }
-  .row { display: flex; align-items: center; gap: 6px; margin-bottom: 3px; }
-  .type { font-size: 10px; font-weight: 700; letter-spacing: .5px; color: #fff; border-radius: 3px; padding: 0 5px; }
-  .lv { font-size: 10px; font-weight: 700; border: 1px solid var(--dim); color: var(--dim); border-radius: 3px; padding: 0 4px; }
+  #sse.poll i { background: var(--warn); }
+  #q { background: var(--card); border: 1px solid var(--border); color: var(--text); border-radius: 3px; padding: 6px 10px; font: 12px/1.4 var(--mono); width: 200px; transition: border-color .15s ease-out; }
+  #q::placeholder { color: var(--faint); }
+  #q:focus { outline: none; border-color: var(--border-strong); }
+
+  /* ---- 看板：去列盒子，发丝竖线分栏的编辑式构图 ---- */
+  #board { display: flex; overflow-x: auto; height: calc(100vh - 58px); }
+  .col { flex: 1 1 0; min-width: 240px; display: flex; flex-direction: column; border-left: 1px solid var(--border); }
+  .col:first-child { border-left: none; }
+  .col h2 { display: flex; align-items: baseline; gap: 8px; font: 600 11px/1 var(--mono); letter-spacing: .12em; color: var(--muted); padding: 16px 16px 12px; border-bottom: 1px solid var(--border); }
+  .col h2 b { color: var(--text); font-weight: 600; }
+  .col .list { flex: 1; overflow-y: auto; padding: 14px 14px 20px; display: flex; flex-direction: column; gap: 10px; }
+
+  /* ---- 卡片：近白纸片，色彩只出现在左缘 3px 与小徽标 ---- */
+  .card { background: var(--card); border: 1px solid var(--border); border-left: 3px solid var(--border-strong); border-radius: 4px; padding: 12px 14px; cursor: pointer; transition: background .15s ease-out, border-color .15s ease-out, transform .15s ease-out, box-shadow .15s ease-out; }
+  .card:hover { background: var(--card-hover); border-color: var(--border-strong); transform: translateY(-1px); box-shadow: var(--shadow-1); }
+  .row { display: flex; align-items: center; flex-wrap: wrap; gap: 6px; margin-bottom: 7px; }
+  .type { font: 700 9.5px/1 var(--mono); letter-spacing: .06em; color: var(--card); border-radius: 2px; padding: 3px 5px; }
+  .type.mini { font-size: 9px; padding: 2px 4px; }
+  .lv { font: 700 10px/1 var(--mono); border: 1px solid var(--border-strong); color: var(--muted); border-radius: 2px; padding: 2px 4px; }
   .lv.hi { border-color: var(--warn); color: var(--warn); }
-  .date { font-size: 11px; color: var(--dim); margin-left: auto; }
-  .acpt { font-size: 10px; border: 1px solid var(--border); color: var(--dim); border-radius: 3px; padding: 0 4px; }
+  .date { font: 11px/1 var(--mono); color: var(--muted); margin-left: auto; font-variant-numeric: tabular-nums; }
+  .acpt { font: 600 10px/1 var(--mono); border: 1px solid var(--border-strong); color: var(--muted); border-radius: 2px; padding: 2px 4px; font-variant-numeric: tabular-nums; }
   .acpt.full { color: var(--ok); border-color: var(--ok); }
-  .age { font-size: 10px; font-weight: 700; border-radius: 3px; padding: 0 4px; }
+  .age { font: 700 10px/1 var(--mono); border-radius: 2px; padding: 2px 4px; }
   .age.a1 { color: var(--warn); border: 1px solid var(--warn); }
-  .age.a2 { color: #fff; background: var(--bad); }
+  .age.a2 { color: var(--card); background: var(--accent); border: 1px solid var(--accent); }
   .card.age1 { outline: 1px solid var(--warn); outline-offset: -1px; }
-  .card.age2 { outline: 1px solid var(--bad); outline-offset: -1px; }
-  .alrt { color: var(--bad); font-size: 11px; cursor: help; }
-  #q { background: var(--card); border: 1px solid var(--border); color: var(--text); border-radius: 6px; padding: 3px 10px; font-size: 12px; width: 180px; }
-  #q:focus { outline: none; border-color: var(--intent); }
-  .hold { font-size: 10px; font-weight: 700; color: var(--bad); border: 1px solid var(--bad); border-radius: 3px; padding: 0 4px; margin-right: 5px; }
+  .card.age2 { outline: 1px solid var(--accent); outline-offset: -1px; }
+  .alrt { font: 700 11px/1 var(--mono); color: var(--accent); cursor: help; }
+  .hold { font: 700 10px/1 var(--mono); color: var(--accent); border: 1px solid var(--accent); border-radius: 2px; padding: 1px 5px; margin-right: 6px; }
+  .auth { font: 10.5px/1 var(--mono); color: var(--muted); background: var(--surface); border: 1px solid var(--border); border-radius: 2px; padding: 2px 5px; }
+  .card .title { font-size: 13px; line-height: 1.6; }
   .ct { display: inline-block; width: 8px; height: 8px; border-radius: 50%; margin-right: 6px; vertical-align: 1px; }
-  #toast { position: fixed; top: 54px; right: 18px; background: var(--card); border: 1px solid var(--ok); color: var(--text); border-radius: 6px; padding: 6px 14px; font-size: 12.5px; z-index: 99; opacity: 0; transition: opacity .2s; pointer-events: none; }
-  #toast.show { opacity: 1; }
-  .card .title { font-size: 12.5px; line-height: 1.45; }
-  /* 任务卡：作者 + 展开的文档清单 */
-  .auth { font-size: 11px; color: var(--dim); background: var(--panel); border: 1px solid var(--border); border-radius: 8px; padding: 0 7px; }
-  .type.mini { font-size: 9px; padding: 0 4px; }
-  .docs { display: none; border-top: 1px dashed var(--border); margin-top: 6px; padding-top: 4px; flex-direction: column; gap: 2px; }
+
+  /* ---- 任务卡展开区：同族文档清单 ---- */
+  .docs { display: none; border-top: 1px dashed var(--border); margin-top: 10px; padding-top: 8px; flex-direction: column; gap: 4px; }
   .card.open .docs { display: flex; }
-  .doc-item { display: flex; align-items: center; gap: 6px; padding: 3px 4px; border-radius: 4px; cursor: pointer; font-size: 12px; }
-  .doc-item:hover { background: var(--card-hover); }
+  .doc-item { display: flex; align-items: center; gap: 6px; padding: 6px 7px; border-radius: 3px; cursor: pointer; font-size: 12px; transition: background .15s ease-out; }
+  .doc-item:hover { background: var(--bg); }
   .doc-item .doc-title { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
-  .doc-item .chip { font-size: 10px; padding: 0 5px; flex-shrink: 0; }
-  .empty { color: var(--dim); font-size: 12px; text-align: center; padding: 18px 0; }
-  /* 抽屉 */
-  #drawer { position: fixed; top: 0; right: -780px; width: min(760px, 92vw); height: 100vh; background: var(--panel); border-left: 1px solid var(--border); transition: right .18s ease; display: flex; flex-direction: column; box-shadow: -8px 0 24px rgba(0,0,0,.4); z-index: 10; }
-  #drawer.open { right: 0; }
-  #d-head { padding: 14px 18px 8px; }
-  #d-title { font-size: 16px; font-weight: 600; margin: 6px 0 8px; }
-  #d-close { float: right; background: none; border: none; color: var(--dim); font-size: 20px; cursor: pointer; }
-  #d-close:hover { color: var(--text); }
-  #d-related { display: flex; gap: 6px; flex-wrap: wrap; margin-bottom: 8px; }
-  #d-related a { font-size: 11px; color: var(--intent); background: var(--card); border: 1px solid var(--border); border-radius: 10px; padding: 1px 9px; cursor: pointer; text-decoration: none; }
-  #d-related a:hover { border-color: var(--intent); }
-  #d-tabs { display: flex; gap: 2px; padding: 0 18px; border-bottom: 1px solid var(--border); }
-  #d-tabs button { background: none; border: none; border-bottom: 2px solid transparent; color: var(--dim); font-size: 13px; padding: 7px 12px; cursor: pointer; }
-  #d-tabs button.on { color: var(--text); border-bottom-color: var(--intent); }
-  #d-body { flex: 1; overflow-y: auto; padding: 16px 20px 40px; }
-  #sse.poll i { background: var(--warn); }
-  /* md 渲染 */
-  .md h1, .md h2, .md h3 { margin: 18px 0 8px; line-height: 1.35; } .md h1 { font-size: 19px; } .md h2 { font-size: 16px; } .md h3 { font-size: 14.5px; }
-  .md p, .md ul, .md ol { margin: 6px 0; } .md li { margin: 2px 0; }
-  .md code { background: var(--card); border-radius: 3px; padding: 1px 5px; font-size: 12.5px; }
-  .md pre { background: var(--card); border: 1px solid var(--border); border-radius: 6px; padding: 10px 12px; overflow-x: auto; margin: 8px 0; } .md pre code { background: none; padding: 0; }
-  .md table { border-collapse: collapse; margin: 8px 0; font-size: 12.5px; } .md th, .md td { border: 1px solid var(--border); padding: 4px 10px; } .md th { background: var(--card); }
-  .md blockquote { border-left: 3px solid var(--border); color: var(--dim); padding-left: 12px; margin: 8px 0; }
-  .md a { color: var(--intent); }
-  .md hr { border: none; border-top: 1px solid var(--border); margin: 14px 0; }
-  /* 历史时间线 */
+  .doc-item .chip { font: 500 10px/1 var(--mono); padding: 2px 5px; flex-shrink: 0; }
+  .empty { color: var(--muted); font: 11px/1 var(--mono); text-align: center; padding: 28px 0; }
+
+  /* ---- 抽屉：纸面 transform 右滑入（不触发布局） ---- */
+  #drawer { position: fixed; top: 0; right: 0; width: min(760px, 92vw); height: 100vh; background: var(--surface); border-left: 1px solid var(--border-strong); transform: translateX(calc(100% + 24px)); transition: transform .3s var(--ease); display: flex; flex-direction: column; box-shadow: var(--shadow-2); z-index: 10; }
+  #drawer.open { transform: none; }
+  #d-head { padding: 22px 26px 10px; }
+  #d-badges { display: flex; align-items: center; flex-wrap: wrap; gap: 7px; }
+  #d-title { font-size: 18px; font-weight: 700; line-height: 1.45; margin: 12px 0; }
+  #d-close { float: right; width: 32px; height: 32px; background: none; border: none; border-radius: 3px; color: var(--muted); font-family: inherit; font-size: 18px; line-height: 1; cursor: pointer; transition: background .15s ease-out, color .15s ease-out; }
+  #d-close:hover { color: var(--text); background: var(--bg); }
+  #d-related { display: flex; gap: 7px; flex-wrap: wrap; margin-bottom: 14px; }
+  #d-related a { font: 500 11px/1 var(--mono); color: var(--text); background: var(--card); border: 1px solid var(--border); border-radius: 3px; padding: 5px 9px; cursor: pointer; text-decoration: none; transition: border-color .15s ease-out, background .15s ease-out; }
+  #d-related a:hover { border-color: var(--border-strong); background: var(--card-hover); }
+  #d-tabs { display: flex; gap: 4px; padding: 0 26px; border-bottom: 1px solid var(--border); }
+  #d-tabs button { position: relative; background: none; border: none; color: var(--muted); font-family: inherit; font-size: 13px; letter-spacing: .02em; padding: 11px 14px; cursor: pointer; }
+  #d-tabs button::after { content: ""; position: absolute; left: 14px; right: 14px; bottom: -1px; height: 2px; background: var(--text); transform: scaleX(0); transition: transform .2s var(--ease); }
+  #d-tabs button.on { color: var(--text); font-weight: 600; }
+  #d-tabs button.on::after { transform: scaleX(1); }
+  #d-body { flex: 1; overflow-y: auto; padding: 26px 30px 56px; }
+
+  /* ---- md 渲染 ---- */
+  .md > :first-child { margin-top: 0; }
+  .md h1, .md h2, .md h3 { margin: 26px 0 10px; line-height: 1.4; letter-spacing: .01em; } .md h1 { font-size: 18px; } .md h2 { font-size: 15.5px; } .md h3 { font-size: 14px; }
+  .md p, .md ul, .md ol { margin: 10px 0; } .md li { margin: 5px 0; }
+  .md code { background: var(--bg); border-radius: 2px; padding: 1px 5px; font: 12px/1.4 var(--mono); }
+  .md pre { background: var(--card); border: 1px solid var(--border); border-radius: 4px; padding: 14px 16px; overflow-x: auto; margin: 12px 0; } .md pre code { background: none; padding: 0; }
+  .md table { border-collapse: collapse; margin: 12px 0; font-size: 12.5px; } .md th, .md td { border: 1px solid var(--border); padding: 6px 12px; } .md th { background: var(--bg); font-weight: 600; }
+  .md blockquote { border-left: 3px solid var(--border-strong); color: var(--muted); padding-left: 14px; margin: 12px 0; }
+  .md a { color: var(--intent); text-underline-offset: 3px; }
+  .md hr { border: none; border-top: 1px solid var(--border); margin: 20px 0; }
+
+  /* ---- 历史时间线 ---- */
   .tl { position: relative; padding-left: 22px; }
   .tl::before { content: ""; position: absolute; left: 6px; top: 6px; bottom: 6px; width: 1px; background: var(--border); }
-  .tl-item { position: relative; padding: 4px 0 10px; }
-  .tl-item::before { content: ""; position: absolute; left: -20px; top: 11px; width: 9px; height: 9px; border-radius: 50%; background: var(--panel); border: 2px solid var(--intent); }
+  .tl-item { position: relative; padding: 6px 0 16px; }
+  .tl-item::before { content: ""; position: absolute; left: -20px; top: 10px; width: 8px; height: 8px; border-radius: 50%; background: var(--surface); border: 2px solid var(--border-strong); }
   .tl-sub { color: var(--text); font-size: 13px; }
-  .tl-meta { color: var(--dim); font-size: 12px; }
-  .tl-meta code { cursor: pointer; } .tl-meta code:hover { color: var(--text); }
-  .none { color: var(--dim); font-size: 13px; }
+  .tl-meta { color: var(--muted); font: 12px/1.6 var(--mono); }
+  .tl-meta code { cursor: pointer; background: var(--card); border: 1px solid var(--border); border-radius: 2px; padding: 0 4px; } .tl-meta code:hover { color: var(--text); border-color: var(--border-strong); }
+  .none { color: var(--muted); font-size: 13px; }
+
+  /* ---- toast：墨底纸字，像盖下去的一方印 ---- */
+  #toast { position: fixed; top: 70px; right: 22px; background: var(--text); color: var(--bg); border-radius: 3px; padding: 9px 14px; font-size: 12px; z-index: 99; opacity: 0; transform: translateY(-6px); transition: opacity .2s ease-out, transform .2s ease-out; pointer-events: none; box-shadow: var(--shadow-1); }
+  #toast.show { opacity: 1; transform: none; }
+
+  /* ---- 动效：一次编排好的入场（列错峰 60ms），SSE 重渲染不重播 ---- */
+  @media (prefers-reduced-motion: no-preference) {
+    header { animation: rise .4s var(--ease) both; }
+    #board.boot .col { animation: rise .45s var(--ease) both; }
+    #board.boot .col:nth-child(2) { animation-delay: 60ms; }
+    #board.boot .col:nth-child(3) { animation-delay: 120ms; }
+    #board.boot .col:nth-child(4) { animation-delay: 180ms; }
+    #board.boot .col:nth-child(5) { animation-delay: 240ms; }
+    #board.boot .col:nth-child(6) { animation-delay: 300ms; }
+    #sse.on i { animation: breath 2.4s ease-in-out infinite; }
+  }
+  @keyframes rise { from { opacity: 0; transform: translateY(10px); } }
+  @keyframes breath { 50% { opacity: .45; } }
+  @media (prefers-reduced-motion: reduce) {
+    *, *::before, *::after { transition: none !important; animation: none !important; }
+  }
 </style>
 </head>
 <body>
@@ -376,7 +440,10 @@ setInterval(() => refreshBoard(), 60000);
 // 搜索过滤：本地过滤标题/slug/文件，SSE 刷新时保持关键字
 $('#q').addEventListener('input', (e) => { Q = e.target.value; refreshBoard(); });
 
+// 首次入场：列错峰上浮一次（.boot 稍后摘除，SSE / 过滤触发的重渲染不再重播）
+$('#board').classList.add('boot');
 refreshBoard();
+setTimeout(() => $('#board').classList.remove('boot'), 1500);
 </script>
 </body>
 </html>

package/templates/_agents/cache/kb-index.json

@@ -1 +1 @@
-{"fp":"b779761db958797b","files":{"/tmp/kb-search-test-0L2Mp6::workflow/intents/2026-09-21-bbb.md":{"st":[1790219799032.8064,270],"kind":"wf","meta":{"状态":"approved","级别":"L1","日期":"2026-09-21","模块":"pipeline"},"title":"乙需求","lines":[[1,"(frontmatter)","---"],[2,"(frontmatter)","状态: approved"],[3,"(frontmatter)","级别: L1"],[4,"(frontmatter)","日期: 2026-09-21"],[5,"(frontmatter)","模块: pipeline"],[6,"(frontmatter)","---"],[7,"(标题)","# INTENT — 乙需求"],[9,"目标","## 目标"],[10,"目标","- 统一口径：编码模板与分类层级，冲突处理见 A/B乙"],[11,"目标",""]]},"/tmp/kb-search-test-0L2Mp6::workflow/plans/2026-09-20-ccc.md":{"st":[1790219799032.8064,200],"kind":"wf","meta":{"状态":"approved","级别":"L1","模块":"purchase"},"title":"丙计划","lines":[[1,"(frontmatter)","---"],[2,"(frontmatter)","状态: approved"],[3,"(frontmatter)","级别: L1"],[4,"(frontmatter)","模块: purchase"],[5,"(frontmatter)","---"],[6,"(标题)","# PLAN — 丙计划"],[8,"目标","## 目标"],[9,"目标","- 只讲编码模板，不提另一个词"],[10,"目标",""]]},"/tmp/kb-search-test-0L2Mp6::workflow/incidents/2026-09-01-aaa.md":{"st":[1790219799032.8064,270],"kind":"wf","meta":{"状态":"closed","级别":"L2","发现":"2026-09-01","模块":"material"},"title":"甲事故","lines":[[1,"(frontmatter)","---"],[2,"(frontmatter)","状态: closed"],[3,"(frontmatter)","级别: L2"],[4,"(frontmatter)","发现: 2026-09-01"],[5,"(frontmatter)","模块: material"],[6,"(frontmatter)","---"],[7,"(标题)","# INCIDENT — 甲事故"],[9,"目标","## 目标"],[10,"目标","- 统一口径：编码模板与分类层级，冲突处理见 A/B甲"],[11,"目标",""]]},"/tmp/kb-search-test-0L2Mp6::wiki/测试主题/说明.md":{"st":[1790219799032.8064,47],"kind":"wiki","lines":[[1,"# 说明"],[2,""],[3,"编码模板的领域知识条目。"],[4,""]]}}}
+{"fp":"b779761db958797b","files":{"/tmp/kb-search-test-T8zWVC::workflow/intents/2026-09-21-bbb.md":{"st":[1790250003552.587,270],"kind":"wf","meta":{"状态":"approved","级别":"L1","日期":"2026-09-21","模块":"pipeline"},"title":"乙需求","lines":[[1,"(frontmatter)","---"],[2,"(frontmatter)","状态: approved"],[3,"(frontmatter)","级别: L1"],[4,"(frontmatter)","日期: 2026-09-21"],[5,"(frontmatter)","模块: pipeline"],[6,"(frontmatter)","---"],[7,"(标题)","# INTENT — 乙需求"],[9,"目标","## 目标"],[10,"目标","- 统一口径：编码模板与分类层级，冲突处理见 A/B乙"],[11,"目标",""]]},"/tmp/kb-search-test-T8zWVC::workflow/plans/2026-09-20-ccc.md":{"st":[1790250003552.587,200],"kind":"wf","meta":{"状态":"approved","级别":"L1","模块":"purchase"},"title":"丙计划","lines":[[1,"(frontmatter)","---"],[2,"(frontmatter)","状态: approved"],[3,"(frontmatter)","级别: L1"],[4,"(frontmatter)","模块: purchase"],[5,"(frontmatter)","---"],[6,"(标题)","# PLAN — 丙计划"],[8,"目标","## 目标"],[9,"目标","- 只讲编码模板，不提另一个词"],[10,"目标",""]]},"/tmp/kb-search-test-T8zWVC::workflow/incidents/2026-09-01-aaa.md":{"st":[1790250003552.587,270],"kind":"wf","meta":{"状态":"closed","级别":"L2","发现":"2026-09-01","模块":"material"},"title":"甲事故","lines":[[1,"(frontmatter)","---"],[2,"(frontmatter)","状态: closed"],[3,"(frontmatter)","级别: L2"],[4,"(frontmatter)","发现: 2026-09-01"],[5,"(frontmatter)","模块: material"],[6,"(frontmatter)","---"],[7,"(标题)","# INCIDENT — 甲事故"],[9,"目标","## 目标"],[10,"目标","- 统一口径：编码模板与分类层级，冲突处理见 A/B甲"],[11,"目标",""]]},"/tmp/kb-search-test-T8zWVC::wiki/测试主题/说明.md":{"st":[1790250003552.587,47],"kind":"wiki","lines":[[1,"# 说明"],[2,""],[3,"编码模板的领域知识条目。"],[4,""]]}}}

package/templates/_agents/commands/test.md

@@ -72,6 +72,7 @@ node .agents/scripts/verify-wiki-consistency.mjs   # 触及 wiki/ 时跑(exit 1
 - 输出测试报告(通过项 / 失败项)
 - 失败项已修复并复测通过
 - **关单**（日常闭环点，不依赖是否上 prod）:
+  - 关单前一键过门：`node .agents/scripts/verify.mjs`（npm test + check-loop 固定编排，任一失败非零退出，非绿不关单）
   - 新需求：逐条勾验入口 intent「验收标准」，每条补「证据：」，intent → done；同名 spec（若有）仍 approved → done
   - 修复：防复发验证已落地，incident → closed
   - **同族收尾**：入口置终态时，同名 plan 一并置 `done`（spec 见上条），不留 `approved` 孤儿（口径同看板「入口已 done，本 plan 未终态」告警）

package/templates/_agents/scripts/verify.mjs

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+// verify.mjs — 关单固定编排（2026-09-24 intent closeout-verify-script）
+// 用途：关单前一键过门——按写死顺序执行 npm test → check-loop.sh，逐项输出 pass/fail。
+// 语义：只编排不裁决——两条命令都是既有门禁原样跑，本脚本不新增校验、不读配置、无状态；
+//   任一步非零即 fail-fast 退出 1，失败原因经 stdio inherit 原样透传不吞；
+//   缺 sh 环境 fail-closed 明确报错（关单门不可跳过，不像 run-tests 那样跳过并提示）。
+// 测试：node templates/_agents/scripts/verify.test.mjs（--test-cmd 注入假命令 + CHECK_LOOP_ROOT 注入夹具，不触真实 npm test 与 workflow）
+// 用法：node .agents/scripts/verify.mjs [--test-cmd "<shell 命令>"]（--test-cmd 仅供测试注入）
+import { spawnSync } from 'node:child_process';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
+const args = process.argv.slice(2);
+const testCmd = args.includes('--test-cmd') ? args[args.indexOf('--test-cmd') + 1] : 'npm test';
+const checkLoop = path.join(SCRIPT_DIR, 'check-loop.sh');
+
+console.log(`[verify] ▶ 1/2 ${testCmd}`);
+const t = spawnSync(testCmd, { shell: true, stdio: 'inherit' });
+if (t.status !== 0) {
+  console.error(`[verify] ❌ 1/2 ${testCmd} 未通过（exit ${t.status ?? t.error?.code}）——修复后重跑，非绿不关单`);
+  process.exit(1);
+}
+console.log('[verify] ✅ 1/2 测试通过');
+
+console.log('[verify] ▶ 2/2 check-loop');
+const c = spawnSync('sh', [checkLoop], { stdio: 'inherit' });
+if (c.status !== 0) {
+  const hint = c.error?.code === 'ENOENT'
+    ? '环境无 sh（装 Git Bash / WSL）——关单门不可跳过，不静默放行'
+    : '按上方输出修复后原路重跑';
+  console.error(`[verify] ❌ 2/2 check-loop 未通过（exit ${c.status ?? c.error?.code}）——${hint}`);
+  process.exit(1);
+}
+console.log('[verify] ✅ 2/2 闭环校验通过');
+console.log('[verify] ✅ 全绿——可以关单（逐条勾验验收标准补证据后 intent/plan → done）');

package/templates/_agents/scripts/verify.test.mjs

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+// verify.mjs 的 fixture 测试（--test-cmd 注入假命令 + CHECK_LOOP_ROOT 注入夹具根，不触真实 npm test 与 workflow）
+// 断言：①绿路径（假过 + 空夹具闭环）exit 0；②步骤 1 假败 exit 1 且不出全绿；
+//       ③步骤 2 配对断裂夹具 exit 1（verify 自身标记断言——孙进程 stdio inherit 输出不进本测试管道）。
+// 用法：node templates/_agents/scripts/verify.test.mjs
+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 VERIFY = path.join(SCRIPT_DIR, 'verify.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}` : ''}`); }
+};
+
+// 空闭环夹具（四目录齐全、无文档 → check-loop 无断档）
+const mkfix = () => {
+  const d = fs.mkdtempSync(path.join(os.tmpdir(), 'verify-fix-'));
+  for (const s of ['intents', 'specs', 'plans', 'incidents']) fs.mkdirSync(path.join(d, 'workflow', s), { recursive: true });
+  return d;
+};
+// 配对断裂夹具（L1 intent 无同名 plan → hard-block）
+const mkBroken = () => {
+  const d = mkfix();
+  fs.writeFileSync(path.join(d, 'workflow', 'intents', '2026-09-12-lonely.md'), [
+    '---', '状态: done', '级别: L1', '日期: 2026-09-12', '---', '# INTENT — lonely', '',
+    '## 验收标准（可测试）', '- [x] 用例通过（证据:dotnet test 全绿）', '',
+  ].join('\n'), 'utf8');
+  return d;
+};
+// 假命令（绝对路径直调，不依赖 PATH，跨平台无引号问题）
+const mkCmd = (code) => {
+  const f = path.join(fs.mkdtempSync(path.join(os.tmpdir(), 'verify-cmd-')), `exit${code}.mjs`);
+  fs.writeFileSync(f, `process.exit(${code});`, 'utf8');
+  return f;
+};
+const run = (argv, opts = {}) => spawnSync(process.execPath, [VERIFY, ...argv], { encoding: 'utf8', ...opts });
+
+// ---- 场景 1：绿路径——假过 + 空夹具闭环 → exit 0 ----
+{
+  const root = mkfix();
+  const r = run(['--test-cmd', `node ${mkCmd(0)}`], { env: { ...process.env, CHECK_LOOP_ROOT: root } });
+  check('场景 1：exit 0', r.status === 0, `exit=${r.status}\n${r.stdout}\n${r.stderr}`);
+  check('场景 1：两步全过且输出全绿', r.stdout.includes('✅ 1/2') && r.stdout.includes('✅ 2/2') && r.stdout.includes('全绿'), r.stdout);
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+// ---- 场景 2：红路径步骤 1——假败 → exit 1、fail-fast 不出全绿 ----
+{
+  const root = mkfix();
+  const r = run(['--test-cmd', `node ${mkCmd(3)}`], { env: { ...process.env, CHECK_LOOP_ROOT: root } });
+  check('场景 2：exit 1', r.status === 1, `exit=${r.status}\n${r.stdout}\n${r.stderr}`);
+  check('场景 2：步骤 1 失败标记在 stderr，且不输出全绿', r.stderr.includes('❌ 1/2') && !r.stdout.includes('全绿'), `${r.stdout}\n${r.stderr}`);
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+// ---- 场景 3：红路径步骤 2——配对断裂夹具 → exit 1 ----
+{
+  const root = mkBroken();
+  const r = run(['--test-cmd', `node ${mkCmd(0)}`], { env: { ...process.env, CHECK_LOOP_ROOT: root } });
+  check('场景 3：exit 1', r.status === 1, `exit=${r.status}\n${r.stdout}\n${r.stderr}`);
+  check('场景 3：步骤 2 失败标记在 stderr，且不输出全绿', r.stderr.includes('❌ 2/2') && !r.stdout.includes('全绿'), `${r.stdout}\n${r.stderr}`);
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
+if (fail) {
+  console.log('\n用法：node templates/_agents/scripts/verify.test.mjs');
+  process.exit(1);
+}
+process.exit(0);

package/templates/wiki/INDEX.md

@@ -9,8 +9,15 @@
 
 | 主题 | 文件数 | 用途 |
 |---|---|---|
-
-合计：**0 份**知识文档，**0 个主题**
+| 产品需求 | 1 | 需求文档与变更记录（PRD、需求说明、评审结论） |
+| 用户功能 | 1 | 功能清单与操作说明（功能视角；与产品需求的分工：那里记"为什么做"，这里记"怎么用"） |
+| 开发方案 | 1 | 技术方案与设计文档（架构、接口、关键取舍） |
+| 项目规范 | 1 | 编码 / 流程 / 协作规范（只放现行有效版本） |
+| 项目计划 | 1 | 计划、里程碑与会议纪要（按日期命名） |
+| 测试报告 | 1 | 测试报告与验收记录（按 日期-主题 命名） |
+| 数据维护 | 1 | schema 变更与数据修复台账（子目录按批次组织，批内 README 记账，不参与文件级登记） |
+
+合计：**7 份**知识文档，**7 个主题**
 
 ## 文件 → 主题 → 归属目录 映射表
 

package/templates/wiki//344/272/247/345/223/201/351/234/200/346/261/202/README.md

@@ -0,0 +1,3 @@
+# 产品需求 — 需求文档与变更记录
+
+PRD、需求说明、评审结论归此；按 `<主题>-<日期>` 或成套子目录命名。原始聊天/草稿先归 `../drafts-archive/`，整理后入位。

package/templates/wiki//345/274/200/345/217/221/346/226/271/346/241/210/README.md

@@ -0,0 +1,3 @@
+# 开发方案 — 技术方案与设计文档
+
+架构设计、接口方案、关键取舍与评审记录归此。落码前的方案定稿入位，过程讨论归 `../drafts-archive/`。

package/templates/wiki//346/225/260/346/215/256/347/273/264/346/212/244/README.md

@@ -0,0 +1,3 @@
+# 数据维护 — schema 变更与数据修复台账
+
+顶层放汇总文档；变更/修复按子目录 `<批次>/` 组织，批内 README.md 记账（引擎特例：本主题子目录不参与 INDEX 文件级登记，见 gen-wiki-board.mjs）。

package/templates/wiki//346/265/213/350/257/225/346/212/245/345/221/212/README.md

@@ -0,0 +1,3 @@
+# 测试报告 — 测试报告与验收记录
+
+按 `<日期>-<主题>` 命名（如 `2026-09-24-采购入库回归.md`）；关门单的验收证据链接 workflow/ 闭环文档，不重复粘贴。

package/templates/wiki//347/224/250/346/210/267/345/212/237/350/203/275/README.md

@@ -0,0 +1,3 @@
+# 用户功能 — 功能清单与操作说明
+
+按功能视角组织：功能清单、页面/角色操作说明、成套截图文档。与「产品需求」的分工：那里记"为什么做"，这里记"怎么用、有哪些"。

package/templates/wiki//351/241/271/347/233/256/350/247/204/350/214/203/README.md

@@ -0,0 +1,3 @@
+# 项目规范 — 编码 / 流程 / 协作规范
+
+编码规范、分支与提交约定、目录级 AGENTS 补充等团队契约归此；只放现行有效版本，历史版本走 `../drafts-archive/`。

package/templates/wiki//351/241/271/347/233/256/350/256/241/345/210/222/README.md

@@ -0,0 +1,3 @@
+# 项目计划 — 计划、里程碑与会议纪要
+
+排期计划、里程碑、复盘纪要归此；按日期命名（如 `2026-Q4-排期.md`）。