agentic-flow-kit 1.8.2 → 2.0.0

package/src/init.test.mjs

@@ -1,163 +0,0 @@
-#!/usr/bin/env node
-// init.mjs 交互解析纯函数测试（normalizeStack / parseChoices）+ 装户面断言——解析层不触真实安装与 stdin；
-// 装户面节对真实 templates/ 树跑 renderTree（init/sync 同一装户路径），断言编排 runner 与 workflows 目录在装户清单内。
-// 断言：①ts/js 别名归一 node；②序号/名称/混输/全角逗号/空白分隔解析正确（去重保序）；
-//       ③非法输入返回 null（就地重问信号）；④空输入回默认（EOF/直接回车安全回退）；⑥装户面含 runner/workflows。
-// 用法：node src/init.test.mjs
-import { normalizeStack, parseChoices, hasAgentsSkeleton, mergeAgents, menuMark } from './init.mjs';
-import { HOSTS as HOST_REG } from './profiles.mjs';
-import { renderTree, scriptTrusted, listTree } from './render.mjs';
-import { sha256 } from './render.mjs';
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-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);
-{
-  const realHosts = Object.keys(HOST_REG);
-  const n = String(realHosts.length);
-  check('菜单号覆盖全部宿主，序号 7 选中最后一项', menuMark(realHosts.length - 1) === n && eq(parseChoices(n, realHosts, 'zcode'), [realHosts[realHosts.length - 1]]));
-}
-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');
-
-// ---- ⑥ 装户面：真实模板树含编排机制件（init/sync 同走 renderTree，结构保证装户必有） ----
-{
-  const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'fk-surface-'));
-  const pkgRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
-  const t = renderTree(path.join(pkgRoot, 'templates'), tmp, { BOARD_PORT: '8933' }, { force: true });
-  const rels = new Set(t.written.map((w) => w.rel));
-  check('装户面含机制文档与编排脚本示例（_TEMPLATE + 示例 .md）',
-    rels.has('.agents/workflows/_TEMPLATE.md') && rels.has('.agents/workflows/示例-并行实现评审.md'),
-    [...rels].filter((r) => r.includes('workflows')).join('、'));
-  check('装户面含 steps 扩展点示例', rels.has('.agents/workflows/steps/示例-部署验证.md'),
-    [...rels].filter((r) => r.includes('steps')).join('、'));
-  check('装户面无 orchestrate 命令残留（编排机制为目录约定，2026-09-25-wf-runtime）',
-    ![...rels].some((r) => r.includes('orchestrate')),
-    [...rels].filter((r) => r.includes('orchestrate')).join('、'));
-  fs.rmSync(tmp, { recursive: true, force: true });
-}
-
-// ---- ⑦ 钩子执行位 + 供应链防线 + 记账归一（2026-09-27 init-p1-batch 复核条件①）----
-{
-  const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'init-p1-'));
-  const pkgRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
-  const vars = { BOARD_PORT: '8933' };
-  renderTree(path.join(pkgRoot, 'templates'), tmp, vars, { force: true });
-  // P1-1：renderTree 落盘执行位——win32 下 statSync().mode 无 0o111 语义（恒 0666 系），
-  // 断言「writeFileSync 带 mode 参数不炸 + POSIX 语义表达」；真值在 POSIX CI 腿验证
-  const hookStat = fs.statSync(path.join(tmp, '.githooks', 'pre-commit'));
-  const hookHasExecBit = (hookStat.mode & 0o111) !== 0;
-  check('钩子落盘执行位：writeFileSync mode=0755 不炸且 POSIX 语义下可执行位为真（win32 平台分支容忍）',
-    hookHasExecBit || process.platform === 'win32',
-    `mode=${(hookStat.mode & 0o777).toString(8)} platform=${process.platform}`);
-  // P1-3：scriptTrusted——一致放行 / 预置拒绝 / 包源无模板拒绝
-  const ok1 = scriptTrusted({ pkgRoot, target: tmp, rel: '.agents/scripts/gen-workflow-index.mjs', vars });
-  check('scriptTrusted：与包源渲染值一致 → ok', ok1.ok, ok1.note);
-  fs.writeFileSync(path.join(tmp, '.agents/scripts/gen-workflow-index.mjs'), 'require("fs").writeFileSync("MARKER","pwned")\n');
-  const bad1 = scriptTrusted({ pkgRoot, target: tmp, rel: '.agents/scripts/gen-workflow-index.mjs', vars });
-  check('scriptTrusted：预置/被改动 → 拒绝且 note 可见', !bad1.ok && bad1.note.includes('不符'), bad1.note);
-  const bad2 = scriptTrusted({ pkgRoot, target: tmp, rel: '.agents/scripts/not-in-pkg.mjs', vars });
-  check('scriptTrusted：包源无模板 → fail-closed 拒绝', !bad2.ok, bad2.note);
-  // P1-4：owned 记账 LF 归一——CRLF 盘面与 LF 内容同 sha（与 doctor §6.6 比较口径一致）
-  const crlfFile = path.join(tmp, 'crlf-owned.txt');
-  fs.writeFileSync(crlfFile, '行甲\r\n行乙\r\n');
-  const normSha = sha256(Buffer.from('行甲\n行乙\n', 'utf8'));
-  const rawSha = sha256(Buffer.from('行甲\r\n行乙\r\n', 'utf8'));
-  const readNorm = sha256(Buffer.from(fs.readFileSync(crlfFile, 'utf8').replace(/\r\n/g, '\n'), 'utf8'));
-  check('记账口径：LF 归一 sha == LF 内容 sha != 原始字节 sha（CRLF 盘面跨 checkout 稳定）',
-    readNorm === normSha && readNorm !== rawSha);
-  fs.rmSync(tmp, { recursive: true, force: true });
-}
-
-// ---- ⑧ --force owned 保护 + 端口校验（2026-09-27 p2-batch1）----
-{
-  const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'init-protect-'));
-  const pkgRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
-  const vars = { BOARD_PORT: '8933' };
-  // 预置「用户已自定义」的 owned 文件（内容 != 模板渲染值）
-  const agPath = path.join(tmp, 'AGENTS.md');
-  fs.writeFileSync(agPath, '# 我的项目\n\n自定义适配区命令行，p2b1-marker-keep。\n');
-  const lpPath = path.join(tmp, '.agents', 'hooks', 'local-pre-commit');
-  fs.mkdirSync(path.dirname(lpPath), { recursive: true });
-  fs.writeFileSync(lpPath, '#!/bin/sh\nset -e\nsh .agents/hooks/check-architecture.sh  # add-gate 接线行 p2b1-marker-keep\n');
-  const t = renderTree(path.join(pkgRoot, 'templates'), tmp, vars, { force: true, protectSet: new Set([...listTree(path.join(pkgRoot, 'templates')).filter((rel) => rel === 'AGENTS.md' || rel === '.agents/hooks/local-pre-commit')]) });
-  check('⑧--force owned 保护：自定义 AGENTS.md 不被覆盖（marker 保留 + protectedSkipped 记录）',
-    fs.readFileSync(agPath, 'utf8').includes('p2b1-marker-keep') && (t.protectedSkipped || []).includes('AGENTS.md'),
-    JSON.stringify({ ps: t.protectedSkipped }));
-  check('⑧--force owned 保护：local-pre-commit 接线行保留',
-    fs.readFileSync(lpPath, 'utf8').includes('p2b1-marker-keep') && (t.protectedSkipped || []).includes('.agents/hooks/local-pre-commit'),
-    JSON.stringify({ ps: t.protectedSkipped }));
-  // managed 文件不受保护（--force 照常覆盖）
-  const cmd = path.join(tmp, '.agents', 'commands', 'plan.md');
-  check('⑧managed 文件 --force 照常覆盖（不在 protectedSkipped）',
-    fs.existsSync(cmd) && !(t.protectedSkipped || []).includes('.agents/commands/plan.md'),
-    JSON.stringify({ ps: t.protectedSkipped }));
-  fs.rmSync(tmp, { recursive: true, force: true });
-}
-
-// ---- ⑨ 引擎基线不下发（装户端内容清理后：包源径基线的键命名空间与装户盘面不一致，下发即污染）----
-{
-  const src = fs.mkdtempSync(path.join(os.tmpdir(), 'fk-lock-src-'));
-  const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'fk-lock-tgt-'));
-  fs.mkdirSync(path.join(src, '_agents', 'scripts'), { recursive: true });
-  fs.writeFileSync(path.join(src, '_agents', 'scripts', 'gate.mjs'), '// 正常模板件\n');
-  fs.writeFileSync(path.join(src, '_agents', 'engine-lock.json'), '{"files":{}}\n');
-  const rels = listTree(src);
-  check('⑨listTree 排除 .agents/engine-lock.json（枚举面无基线）',
-    rels.includes('.agents/scripts/gate.mjs') && !rels.includes('.agents/engine-lock.json'),
-    JSON.stringify(rels));
-  const t = renderTree(src, tmp, {}, { force: true });
-  check('⑨renderTree 不落盘 .agents/engine-lock.json（written 无基线、目标不生成）',
-    !t.written.some((w) => w.rel === '.agents/engine-lock.json') && !fs.existsSync(path.join(tmp, '.agents', 'engine-lock.json')),
-    JSON.stringify(t.written.map((w) => w.rel)));
-  fs.rmSync(src, { recursive: true, force: true });
-  fs.rmSync(tmp, { recursive: true, force: true });
-}
-
-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/instance-ref.test.mjs

@@ -1,62 +0,0 @@
-// instance-ref.test.mjs — 引擎/文档实例引用不变量门（2026-10-11 engine-output-provenance）。
-// 公理：引擎面向用户的输出是证据性的——引用的每个出处装户必须可解析（README「不伪造」柱）。
-// 此前 check-lane-surface.mjs 阻断消息与 check-loop.mjs WARN 引用包源仓专属的 specs/incidents/papercuts
-// 实例文档（装户随包只有 _TEMPLATE 与骨架，路径悬空）——本门把不变量机器化：
-//   包源随包下发件（引擎脚本 + 命令/角色/协议文档）不得引用「实例专属的带日期文档路径」。
-// 判据形态（宁可窄不可误伤）：
-//   /(incidents|specs|intents|plans)\/20\d{2}-/   带日期的实例文档路径（目录前缀引用合法——
-//                                                  new-task.md「立 incident（workflow/incidents/）」不受影响）
-//   /papercuts(\.md)?\s+20\d{2}/                  papercuts 条目按日期引用（papercuts-cleanup-batch
-//                                                  事件名不带空格+日期，不命中）
-// 例外：*.test.mjs 夹具里的合法日期文件名；board/（第三方 vendor）。出处一律写「包源仓 git 历史
-// 与 CHANGELOG」——立法时间点保留，可解析指针删除。
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
-const PATTERNS = [
-  { re: /(incidents|specs|intents|plans)\/20\d{2}-/g, why: '实例带日期文档路径' },
-  { re: /papercuts(\.md)?\s+20\d{2}/g, why: 'papercuts 条目日期引用' },
-];
-const EXTS = new Set(['.mjs', '.sh', '.cjs', '.md', '.txt', '.json']);
-const SKIP_DIR = new Set(['board', '.git', 'node_modules', 'cache']);
-
-function* walk(dir) {
-  for (const e of fs.readdirSync(dir, { withFileTypes: true })) {
-    if (e.isDirectory()) { if (!SKIP_DIR.has(e.name)) yield* walk(path.join(dir, e.name)); continue; }
-    if (!EXTS.has(path.extname(e.name))) continue;
-    if (e.name.endsWith('.test.mjs')) continue; // 夹具日期文件名合法
-    yield path.join(dir, e.name);
-  }
-}
-
-const targets = [
-  ...walk(path.join(ROOT, 'templates')),
-  ...fs.readdirSync(path.join(ROOT, 'src')).filter((f) => f.endsWith('.mjs') && !f.endsWith('.test.mjs')).map((f) => path.join(ROOT, 'src', f)),
-  ...fs.readdirSync(path.join(ROOT, 'bin')).filter((f) => f.endsWith('.mjs')).map((f) => path.join(ROOT, 'bin', f)),
-  ...fs.readdirSync(path.join(ROOT, 'scripts')).filter((f) => f.endsWith('.mjs')).map((f) => path.join(ROOT, 'scripts', f)),
-];
-
-const hits = [];
-let scanned = 0;
-for (const abs of targets) {
-  scanned++;
-  const lines = fs.readFileSync(abs, 'utf8').replace(/\r\n/g, '\n').split('\n');
-  for (let i = 0; i < lines.length; i++) {
-    for (const { re, why } of PATTERNS) {
-      re.lastIndex = 0;
-      if (re.test(lines[i])) hits.push(`${path.relative(ROOT, abs)}:${i + 1}（${why}）`);
-    }
-  }
-}
-
-if (hits.length) {
-  console.log(`FAIL 引擎/文档存在实例专属引用（装户径路径悬空）——${hits.length} 处：`);
-  for (const h of hits) console.log(`  - ${h}`);
-  console.log('修法：出处改写为「留痕在包源仓 git 历史与 CHANGELOG，装户径不引实例路径」；用法示例用 <日期> 占位。');
-  process.exit(1);
-}
-console.log(`PASS 实例引用不变量：${scanned} 份随包源文件零实例专属日期引用`);
-console.log(`\n合计: PASS 1 / FAIL 0`);
-process.exit(0);

package/src/jscpd-drift.test.mjs

@@ -1,144 +0,0 @@
-#!/usr/bin/env node
-// jscpd-drift.test.mjs — jscpd 漂移检查的纯函数 + 夹具回归（2026-10-12 jscpd-drift-gate）
-// 不真跑 jscpd、不联网：runJscpd 走真 worktree + npx，离线不可靠且慢；本套件只钉判据纯函数与
-// --no-run 端到端（基线可解析性）。真跑路径由 CI 的 workflow_dispatch 手动 job 覆盖。
-// 用法：node src/jscpd-drift.test.mjs
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { spawnSync } from 'node:child_process';
-import { pathToFileURL } from 'node:url';
-
-const ROOT = path.resolve(path.dirname(new URL(import.meta.url).pathname.replace(/^\/([A-Za-z]:)/, '$1')), '..');
-const SCRIPT = path.join(ROOT, 'scripts', 'jscpd-drift.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 mod = await import(pathToFileURL(SCRIPT).href);
-const { loadBaseline, parseReport, compareDrift, pickRef, DRIFT_WARN_PCT, DRIFT_FAIL_PCT } = mod;
-
-const tmp = (name, content) => {
-  const dir = fs.mkdtempSync(path.join(os.tmpdir(), `jscpd-drift-test-${name}-`));
-  const f = path.join(dir, 'baseline.json');
-  fs.writeFileSync(f, content, 'utf8');
-  return f;
-};
-const cleanup = (...fs_) => fs_.forEach((f) => fs.rmSync(path.dirname(f), { recursive: true, force: true }));
-
-// ---- 场景 1：真实基线可解析（消费端接的是本仓锚，不是夹具）----
-{
-  const r = loadBaseline();
-  check('场景 1：本仓基线可解析且六键齐', r.ok, r.error);
-  check('场景 1：基线含 commit 锚 + 复现命令 + 日期',
-    r.ok && !!r.baseline.commit && !!r.baseline.command && !!r.baseline.date,
-    r.ok ? JSON.stringify(r.baseline) : 'load 失败');
-  check('场景 1：默认阈值单调（0 < warn ≤ fail）',
-    DRIFT_WARN_PCT > 0 && DRIFT_FAIL_PCT >= DRIFT_WARN_PCT, `${DRIFT_WARN_PCT} / ${DRIFT_FAIL_PCT}`);
-  check('场景 1：基线重复率在合理区间（0 < pct ≤ 100）',
-    r.ok && r.baseline.totals.duplicatedLinesPct > 0 && r.baseline.totals.duplicatedLinesPct <= 100,
-    r.ok ? String(r.baseline.totals.duplicatedLinesPct) : '');
-}
-
-// ---- 场景 2：fail-loud —— 判据的输入坏了必须可见（红线：无判定依据不产噪声，但也绝不静默）----
-{
-  const missing = tmp('missing', '{}');
-  check('场景 2：totals 缺键 → fail-loud 且点名缺哪些键',
-    !loadBaseline(missing).ok && /缺键或非法/.test(loadBaseline(missing).error), loadBaseline(missing).error);
-  cleanup(missing);
-
-  const noCommit = tmp('nocommit', JSON.stringify({ totals: { sources: 1, lines: 2, clones: 1, duplicatedLines: 1, duplicatedLinesPct: 1, duplicatedTokensPct: 1 }, command: 'x' }));
-  check('场景 2：缺 commit 锚 → fail-loud（基线量的是哪一版无法对质）',
-    !loadBaseline(noCommit).ok && /commit/.test(loadBaseline(noCommit).error), loadBaseline(noCommit).error);
-  cleanup(noCommit);
-
-  const noCmd = tmp('nocmd', JSON.stringify({ totals: { sources: 1, lines: 2, clones: 1, duplicatedLines: 1, duplicatedLinesPct: 1, duplicatedTokensPct: 1 }, commit: 'abc1234' }));
-  check('场景 2：缺复现命令 → fail-loud（口径不可复现）',
-    !loadBaseline(noCmd).ok && /command/.test(loadBaseline(noCmd).error), loadBaseline(noCmd).error);
-  cleanup(noCmd);
-
-  const bad = tmp('bad', '{ not json');
-  check('场景 2：JSON 不可解析 → fail-loud', !loadBaseline(bad).ok && /解析失败/.test(loadBaseline(bad).error), loadBaseline(bad).error);
-  cleanup(bad);
-
-  const absent = path.join(os.tmpdir(), 'jscpd-drift-nonexistent-baseline.json');
-  check('场景 2：文件不存在 → fail-loud（不是「无数据即 OK」）', !loadBaseline(absent).ok, loadBaseline(absent).error);
-
-  const neg = tmp('neg', JSON.stringify({ totals: { sources: 1, lines: 2, clones: -1, duplicatedLines: 1, duplicatedLinesPct: 1, duplicatedTokensPct: 1 }, commit: 'a', command: 'b' }));
-  check('场景 2：负数值 → fail-loud', !loadBaseline(neg).ok, loadBaseline(neg).error);
-  cleanup(neg);
-}
-
-// ---- 场景 3：parseReport 跨版本字段探测 ----
-{
-  check('场景 3：小写字段路径命中', parseReport({ statistics: { total: { sources: 2, lines: 10, clones: 1, duplicatedLines: 3, duplicatedLinesPct: 30, duplicatedTokensPct: 20 } } })?.duplicatedLinesPct === 30);
-  check('场景 3：驼峰字段路径命中（jscpd Statistics/Total/DuplicatedLinesPct）',
-    parseReport({ Statistics: { Total: { Sources: 2, Lines: 10, Clones: 1, DuplicatedLines: 3, DuplicatedLinesPct: 30, DuplicatedTokensPct: 20 } } })?.duplicatedLinesPct === 30);
-  check('场景 3：jscpd 5.4.1 实测字段路径命中（statistics.total.percentage / percentageTokens）',
-    parseReport({ statistics: { total: { sources: 116, lines: 26228, clones: 231, duplicatedLines: 2029, percentage: 7.736, percentageTokens: 6.398 } } })?.duplicatedLinesPct === 7.736);
-  check('场景 3：5.x 与早期 duplicatedLinesPct 混用时逐路径取首个有限数',
-    parseReport({ statistics: { total: { duplicatedLinesPct: 7.49, percentage: 7.736 } } })?.duplicatedLinesPct === 7.736);
-  check('场景 3：结构不可识别 → null（不猜、不用 0 冒充）',
-    parseReport({ foo: 1 }) === null && parseReport(null) === null && parseReport({}) === null);
-  const partial = parseReport({ statistics: { total: { sources: 2 } } });
-  check('场景 3：部分键缺失 → 其余为 null（compareDrift 据此判 unknown）',
-    partial.duplicatedLinesPct === null && partial.sources === 2, JSON.stringify(partial));
-}
-
-// ---- 场景 4：compareDrift 四态 ----
-{
-  check('场景 4：持平（Δ0）→ ok', compareDrift(7.49, 7.49).level === 'ok');
-  check('场景 4：下降（Δ<0）→ ok 且不报抬升', compareDrift(7.49, 6.0).level === 'ok' && compareDrift(7.49, 6.0).deltaPct < 0);
-  const warn = compareDrift(7.49, 8.60);
-  check('场景 4：Δ+1.11pct → warn（越过 warn 阈值，未到 fail）',
-    warn.level === 'warn' && Math.abs(warn.deltaPct - 1.11) < 1e-9 && warn.lines.some((l) => /抬升（>\+1pct）/.test(l)), JSON.stringify(warn));
-  const high = compareDrift(7.49, 11.0);
-  check('场景 4：Δ+3.51pct → high 且提示立 intent 收敛（指回 incidents 克隆分叉采集点）',
-    high.level === 'high' && high.lines.some((l) => /立 intent 收敛/.test(l)) && high.lines.some((l) => /克隆分叉/.test(l)), JSON.stringify(high));
-  const unknown = compareDrift(7.49, null);
-  check('场景 4：实测取不到 → unknown（既不判 OK 也不判红——拿不到数据不是「没退化」的证据）',
-    unknown.level === 'unknown' && unknown.deltaPct === null, JSON.stringify(unknown));
-  const custom = compareDrift(10, 11, 0.5, 2.0);
-  check('场景 4：自定义阈值生效（Δ+1.0 在 0.5/2.0 档下仍为 warn）', custom.level === 'warn', JSON.stringify(custom));
-}
-
-// ---- 场景 4b：实测面选 commit（这条判据错则脚本退化为「自我复读」）----
-{
-  check('场景 4b：默认比对 HEAD 而非基线 commit（扫基线 commit 必得 Δ=0，等于没测）',
-    pickRef(false, '9e0cbc5') === 'HEAD', pickRef(false, '9e0cbc5'));
-  check('场景 4b：--verify-baseline 才复扫基线 commit（口径自查，与漂移判定分离）',
-    pickRef(true, '9e0cbc5') === '9e0cbc5', pickRef(true, '9e0cbc5'));
-}
-
-// ---- 场景 5：--no-run 端到端（真实基线；不出网、零 jscpd 依赖）----
-{
-  const r = spawnSync(process.execPath, [SCRIPT, '--no-run'], { cwd: ROOT, encoding: 'utf8' });
-  check('场景 5：--no-run → exit 0 且打印基线数值', r.status === 0 && /重复 7\.49%/.test(r.stdout), `exit=${r.status}\n${r.stdout}${r.stderr}`);
-  const j = spawnSync(process.execPath, [SCRIPT, '--no-run', '--json'], { cwd: ROOT, encoding: 'utf8' });
-  let parsed = null;
-  try { parsed = JSON.parse(j.stdout); } catch { /* 断言下方给出 */ }
-  check('场景 5：--no-run --json → 机器可读且 totals 齐',
-    j.status === 0 && parsed && parsed.ok === true && parsed.baseline && parsed.baseline.clones > 0, j.stdout);
-  check('场景 5：--json 输出含基线 commit 锚（可对质「量的是哪一版」）',
-    parsed && parsed.note && parsed.note.includes('基线 commit'), JSON.stringify(parsed));
-}
-
-// ---- 场景 6：阈值参数校验与未知参数 ----
-{
-  const bad = spawnSync(process.execPath, [SCRIPT, '--warn-pct', '5', '--fail-pct', '1', '--no-run'], { cwd: ROOT, encoding: 'utf8' });
-  check('场景 6：warn > fail → exit 1', bad.status === 1, `exit=${bad.status}\n${bad.stderr}`);
-  const nan = spawnSync(process.execPath, [SCRIPT, '--warn-pct', 'abc', '--no-run'], { cwd: ROOT, encoding: 'utf8' });
-  check('场景 6：非数值阈值 → exit 1', nan.status === 1, `exit=${nan.status}\n${nan.stderr}`);
-  const unknownArg = spawnSync(process.execPath, [SCRIPT, '--wat'], { cwd: ROOT, encoding: 'utf8' });
-  check('场景 6：未知参数 → exit 1 且给用法', unknownArg.status === 1 && /用法/.test(unknownArg.stderr), `exit=${unknownArg.status}\n${unknownArg.stderr}`);
-  const badBase = spawnSync(process.execPath, [SCRIPT, '--baseline', path.join(os.tmpdir(), 'no-such-baseline.json'), '--no-run'], { cwd: ROOT, encoding: 'utf8' });
-  check('场景 6：基线坏 → exit 1 且报错（不静默跳过）', badBase.status === 1 && /基线/.test(badBase.stderr), `exit=${badBase.status}\n${badBase.stderr}`);
-}
-
-console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
-if (fail) { console.log('\n用法：node src/jscpd-drift.test.mjs'); process.exit(1); }
-process.exit(0);

package/src/pack.test.mjs

@@ -1,24 +0,0 @@
-// pack.test.mjs — npm 打包防线断言：templates/_agents/cache（运行时生成、gitignore）不得进发布包。
-// 0.4.0 实发包含测试残留 kb-index.json（incident 2026-09-24-npm-pack-cache-leak）——files 白名单列出
-// templates 后 npm-packlist 不再按根 .gitignore 排除目录内文件，须显式负向排除；prepack 兜底物理清除。
-// 此处断言配置层两道防线在位（npm 10/11 双版本 pack 行为已在 incident 实测验证）。
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
-const pkg = JSON.parse(fs.readFileSync(path.join(ROOT, 'package.json'), 'utf8'));
-
-let pass = 0, fail = 0;
-function check(name, cond, detail = '') {
-  if (cond) { pass++; console.log(`PASS ${name}`); }
-  else { fail++; console.log(`FAIL ${name}${detail ? `——${detail}` : ''}`); }
-}
-
-const files = pkg.files || [];
-const prepack = pkg.scripts?.prepack || '';
-check('P1 files 负向排除 cache 目录与内容', files.includes('!templates/_agents/cache') && files.includes('!templates/_agents/cache/**'), JSON.stringify(files));
-check('P2 prepack 兜底清除 cache 目录', /templates[\\/]_agents[\\/]cache/.test(prepack) && /rmSync/.test(prepack), prepack || 'scripts.prepack 缺失');
-
-console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
-process.exit(fail ? 1 : 0);

package/src/profiles.mjs

@@ -1,183 +0,0 @@
-// 宿主注册表 + 技术栈 profile + init 生成的 owned 基线配置
-// fs/path 仅供 srcTemplatePath（模板下发感知）——显式 import，不依赖 Node 22+ 的全局 fs（engines >=18）
-import fs from 'node:fs';
-import path from 'node:path';
-// stack 决定门禁配置三处：commit-check 的条件构建（builds）与质量检测（checks，秒级确定性
-// 检查——lint/类型/vet；测试不放提交门，关单在 test.md 阶段门）、settings.json 的自检验
-// 命令权限（allow）、AGENTS.md「项目适配区」命令预填；不改工作流流程本身。
-// checks.when / builds.when = 条件才启用。文件路径或尾部 * 通配表示配置文件存在；
-// pkg:scripts.build 表示 package.json 里该脚本为非空字符串。没有对应配置的项目自动跳过，
-// 不 fail-closed 误拦。none = 不配置（项目日后自填）。
-export const HOSTS = {
-  // 2026-10-05 宿主本地化撤销：zcode / omp 原 localOnly:true（init 与 add-host 会把 .zcode/、.omp/
-  // 整目录写进装户 .gitignore）。改为 false 后七个宿主一律入库，换宿主不丢文件、CI 克隆面与本仓一致。
-  // 代价是 zcode 的会话级液态草稿（.zcode/drafts/、.zcode/plans/）改由装户自己加 .gitignore 规则；
-  // 本仓 .gitignore 净效果保留这两行草稿规则（实例见根 .gitignore），.zcode/agents/*.md 保持 tracked（2026-09-27 gate-coverage 独立复核确立）。
-  zcode: { dir: '.zcode', localOnly: false },
-  opencode: { dir: '.opencode', localOnly: false, commandPrefix: 'wf-' },
-  trae: { dir: '.trae', localOnly: false, commandPrefix: 'wf-' },
-  omp: { dir: '.omp', localOnly: false },
-  // 2026-09-29 店面：序号仍把 zcode 放第一（交互菜单 1–4 不变）。claude / cursor 的 commands 由宿主自动加载；
-  // codex 自动读仓库根 AGENTS.md 与 .codex/skills/，commands 与 agents 是同形薄转发，供显式引用。
-  claude: { dir: '.claude', localOnly: false, commandPrefix: 'wf-' },
-  cursor: { dir: '.cursor', localOnly: false, commandPrefix: 'wf-' },
-  codex: { dir: '.codex', localOnly: false, commandPrefix: 'wf-' },
-};
-// commandPrefix = 该宿主的命令层薄适配文件名（= 宿主命令名）统一前缀，2026-09-28 opencode-cmd-wf-prefix
-// 与 trae 对齐后单源：命令名不再裸占宿主顶层命名空间（撞宿主内置/第三方命令无从规避）；缺该字段的宿主
-// 表示只有角色层适配、不参与 commands 权威源映射（zcode/omp）。sync-hosts（包源侧）与 doctor §7.x
-// （装户侧）两份实现均从本表派生，新增命令层宿主只改这一处。
-
-const ESLINT_CONFIGS = [
-  'eslint.config.js', 'eslint.config.mjs', 'eslint.config.cjs',
-  '.eslintrc.js', '.eslintrc.cjs', '.eslintrc.json', '.eslintrc.yml', '.eslintrc',
-];
-
-export const STACKS = {
-  dotnet: {
-    build: 'dotnet build',
-    test: 'dotnet test',
-    typecheck: 'dotnet build（编译即类型检查）',
-    builds: [{ name: 'backend', command: 'dotnet build', ext: ['.cs', '.sln', '.csproj'] }],
-    checks: [{ name: 'format', command: 'dotnet format --verify-no-changes', ext: ['.cs'], when: ['*.sln'] }],
-    allow: ['dotnet build', 'dotnet run', 'dotnet test', 'dotnet format'],
-  },
-  node: {
-    build: 'npm run build',
-    test: 'npm test',
-    typecheck: 'npx tsc --noEmit（或 npm run typecheck）',
-    builds: [{ name: 'build', command: 'npm run build', ext: ['.ts', '.tsx', '.vue', '.js', '.jsx', '.mjs', '.cjs'], when: ['pkg:scripts.build'] }],
-    checks: [
-      { name: 'typecheck', command: 'npx tsc --noEmit', ext: ['.ts', '.tsx'], when: ['tsconfig.json'] },
-      { name: 'lint', command: 'npx eslint .', ext: ['.ts', '.tsx', '.js', '.jsx', '.vue'], when: ESLINT_CONFIGS },
-    ],
-    allow: ['npm test'],
-  },
-  python: {
-    build: '（Python 无统一构建命令，按项目填）',
-    test: 'python -m pytest',
-    typecheck: '（可选：mypy）',
-    builds: [],
-    checks: [{ name: 'lint', command: 'ruff check .', ext: ['.py'], when: ['ruff.toml', '.ruff.toml'] }],
-    allow: ['python -m pytest', 'pytest', 'ruff check'],
-  },
-  go: {
-    build: 'go build ./...',
-    test: 'go test ./...',
-    typecheck: 'go vet',
-    builds: [{ name: 'build', command: 'go build ./...', ext: ['.go'] }],
-    checks: [{ name: 'vet', command: 'go vet ./...', ext: ['.go'], when: ['go.mod'] }],
-    allow: ['go build', 'go test', 'go vet'],
-  },
-  none: {
-    build: '<填写>',
-    test: '<填写>',
-    typecheck: '<填写>',
-    builds: [],
-    checks: [],
-    allow: [],
-  },
-};
-
-// 技术栈别名归一：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;
-  return { BUILD_CMD: s.build, TEST_CMD: s.test, TYPECHECK_CMD: s.typecheck };
-}
-
-// 两态文件模型的归属判定：managed（随包升级）之外皆 owned（项目内容，sync 永不覆盖）
-// local-pre-commit 是项目门禁挂载点——一旦接线即含项目内容，按 owned 起步（旧台账里若在 managed，改动后 sync 也会保守跳过）
-// metric-claims.txt 是**项目自持的指标登记表**（2026-09-28 metric-claim-gate 复核 P2 更正）：装户按
-// 设计要在其中新增自有指标，若按 managed 记账则 sync 每次都报「本地已改、升级时需合并」，且将来包侧
-// 新增内置指标**永远下不来**（台账停在包侧基线）。故归 owned——随包附带一份起步内容，此后归项目。
-// metric-derivers.cjs 是**项目自持的取数器模块**（2026-09-28 adopter-derivers）：它正是上面那份登记表的
-// 扩展点——装户在此实现自有指标的取数逻辑。**必须与 metric-claims.txt 同归 owned**：若落 managed，
-// 装户一用该功能就会让 sync 永久报「本地已改」、doctor WARN，并因供应链防线使 check-loop 跳过执行
-// （门禁静默停摆）——那正是本单要修的缺陷本身（同名 incident 有实测链路）。
-// **后缀为 .cjs 而非 .mjs**（2026-09-28 跨版本实测修正）：首版用 .mjs + require(esm)，实测在
-// Node 18.20 / 20.18 / 22.11 全部 ERR_REQUIRE_ESM（只有 ≥20.19/≥22.12 可用），而本仓 engines
-// 写 >=18.0.0、CI 跑 18/22 → 装户在 CI 目标版本上根本用不了。改 .cjs 后 createRequire 同步载入
-// 全线可用。旧 .mjs 路径同样登记为 owned（免装户残留旧文件时落 managed 重演缺陷）。
-// .github/ 是装户 CI 远端门（2026-10-07 adopter-ci-github）：kit 只下发 workflows/kit-ci.yml 薄模板，
-// 触发分支 / node 版本 / 测试命令均项目特定——归 owned，sync 永不覆盖；感知锚经 srcTemplatePath
-// 通用点前缀翻译命中 templates/_github/。
-export function isOwned(rel) {
-  return rel === 'AGENTS.md' || rel === '.gitattributes' || rel.startsWith('workflow/') || rel.startsWith('wiki/')
-    || rel.startsWith('.agents/notes/')
-    || rel === '.agents/workflow-modules.txt' || rel === '.agents/rule-budgets.txt'
-    // level-hints.txt（2026-10-13 flow-kit-route）：风险级别**路径下限**清单，内容项目私有（照抄别人的
-    //   清单等于没登记），故归装户自持、sync 永不覆盖——与 lane-surfaces.txt 同款性质。
-    || rel === '.agents/level-hints.txt'
-  || rel === '.agents/metric-claims.txt' || rel === '.agents/metric-derivers.cjs'
-  || rel === '.agents/metric-derivers.mjs'
-  // mechanism-registry.md（2026-10-13 judgment-ledger 回灌 B4）：机制使用量登记表——装户按月对账
-  // 自持运营（增删机制行 / 刷新计数 / 退役处置），若落 managed 则每次对账编辑都报「本地已改」漂移，
-  // 与 metric-claims.txt 同款性质，归 owned（随包附带示例行起步内容，此后归项目）。
-  || rel === '.agents/mechanism-registry.md'
-  || rel === '.agents/hooks/local-pre-commit'
-    || rel.startsWith('.github/');
-}
-
-// ---- 模板下发感知（2026-10-06 template-downstream）----
-// 装户 owned 模板无下发通道（init 一次性复制），源仓演进静默陈旧——S18/S20 装户事故根因。
-// 感知层 = 三方 sha 比对（一律 LF 归一，与 ownedSha 自愈同口径）：
-//   disk＝装户盘面 / srcRecord＝kit.json owned[].srcSha256（上次 sync/init 见过的包源 sha）/ srcCur＝本次包源。
-
-// 生成器目标（init「按生成后盘面重记」的清单，原 init 内 GEN_TARGETS 挪此单源）：生成器拥有该文件，
-// 装户不期望跟随包源模板——模板感知排除出比对面（防「拉取了也被生成器重写」的无谓出账）。新增生成器目标须同步本清单。
-export const TEMPLATE_DRIFT_EXCLUDE = new Set(['workflow/INDEX.md', 'wiki/INDEX.md', 'wiki/知识沉淀总览.html']);
-
-// 映射规则单源：renderTree 的「srcRoot/templates ↔ targetRoot/项目根」关系 + 点目录前缀翻译。
-// 通用点前缀翻译（2026-10-07 adopter-ci-github，由 .agents/ 特例泛化）：装户 rel 首段以 `.` 开头时探
-// templates/_<去点首段>/<余径>（.agents/notes/x → _agents/notes/x、.github/workflows/kit-ci.yml →
-// _github/…）——与 render.mjs relOf 的顶层 `_`→`.` 同一规则的逆向；无点前缀 rel（AGENTS.md / workflow/…）
-// 原样探 templates/<rel>。无对应模板返回 null（不参与感知）。
-export function srcTemplatePath(pkgRoot, rel) {
-  const first = rel.split('/')[0];
-  const tplRel = first.startsWith('.') ? `_${first.slice(1)}${rel.slice(first.length)}` : rel;
-  const p = path.join(pkgRoot, 'templates', tplRel);
-  return fs.existsSync(p) ? p : null;
-}
-
-// 三态判定纯函数（sync 出账与 doctor 回显共用——防两处字面量漂移，N3 教训）：
-//   'stale-drift'   源已演进且盘面未跟随 → 唯一出账形态（advisory）
-//   'custom-synced' 盘面 ≠ 源但源 == 上次锚 → 装户定制跟源，owned 语义正常态，永不告警
-//   'synced'        盘面 == 当前源 → 静默（手工拉取后天然落此态）
-//   'no-anchor'     台账缺 srcSha256（旧装户）→ 静默跳过，下次 sync 写锚后生效，不追溯
-export function templateDriftOf({ disk, srcRecord, srcCur }) {
-  if (typeof srcRecord !== 'string' || !srcRecord) return 'no-anchor';
-  if (disk === srcCur) return 'synced';
-  if (srcCur !== srcRecord) return 'stale-drift';
-  return 'custom-synced';
-}
-
-export function settingsJson(stackKey) {
-  const allow = [...new Set([
-    'node', 'git status', 'git diff', 'git add', 'git commit', 'git log', 'git push',
-    'npm run', 'npm install', 'npm ci',
-    ...(STACKS[stackKey]?.allow || []),
-  ])];
-  return `${JSON.stringify({
-    permissions: {
-      allow,
-      deny: ['git reset --hard', 'git push --force', 'git push -f', 'drop database'],
-      ask: ['git checkout', 'git clean', 'git branch -D', 'rm -rf'],
-    },
-  }, null, 2)}\n`;
-}
-
-export function commitCheckConfig(stackKey) {
-  return `${JSON.stringify({
-    knownPatterns: [],
-    builds: STACKS[stackKey]?.builds || [],
-    checks: STACKS[stackKey]?.checks || [],
-  }, null, 2)}\n`;
-}