agentic-flow-kit 1.8.7 → 2.1.0

package/locales/zh-CN/installer.json

@@ -0,0 +1,110 @@
+{
+  "help": "agentic-flow-kit v{{version}}\n\n用法：\n  flow-kit install --agent <host> [--agent <host>...] [--lang zh-CN|en] [--stack dotnet|node|typescript|rust|go|java|empty] [--tier lean|standard|enterprise] [--hardened] [--target <dir>] [--model [host:]role=<id>] [--model-mode recommend|detect|inherit] [--probe-models] [--no-model-config] [--dry-run] [--force] [--no-git-config] [--track-hosts]\n  flow-kit add-host <host> [--target <dir>] [--model [host:]role=<id>] [--model-mode recommend|detect|inherit] [--probe-models] [--no-model-config] [--dry-run] [--force]\n  flow-kit upgrade [--target <dir>] [--model [host:]role=<id>] [--model-mode recommend|detect|inherit] [--probe-models] [--dry-run] [--force]\n  flow-kit doctor [--target <dir>] [--deep] [--fix]\n  flow-kit list-hosts\n\n宿主：trae, codebuddy, claude, opencode, qwen, pi, cline, commandcode, qoder, zcode\n\n模型角色：code（实现）/ judgment（判断）/ review（独立复核，建议与 code 不同）\n\n示例：\n  node cli-tools/agentic-flow-kit/bin/flow-kit.mjs install --agent claude --lang zh-CN --model claude:code=haiku --model claude:review=opus --target .\n",
+  "install.start": "▶ {{command}} → {{target}}",
+  "install.plan": "  宿主={{hosts}} 栈={{stack}} 语言={{lang}} 计划={{count}} 个文件",
+  "install.dryRun": "  （dry-run：只打印计划，不写盘）",
+  "install.create": "创建",
+  "install.update": "更新",
+  "install.skip": "跳过",
+  "install.conflict": "冲突",
+  "install.summary": "完成：创建 {{create}} / 更新 {{update}} / 合并 {{merge}} / 跳过 {{skip}} / 冲突 {{conflict}}",
+  "install.manifest": "manifest：{{path}}",
+  "install.gitConfig": "已配置 git 门禁：core.hooksPath / merge.ours.driver / merge.jsonl-union.driver",
+  "install.gitSkip": "未配置 git（目标不是仓库或使用了 --no-git-config）；clone 后请手动执行三条例行配置",
+  "install.next": "下一步：node .agents/scripts/check-local-gates.mjs --fix",
+  "doctor.manifestMissing": "未找到 .agents/install-manifest.json；先运行 flow-kit install",
+  "doctor.fileMissing": "manifest 登记的文件缺失",
+  "doctor.unknownHost": "宿主模板不存在",
+  "doctor.ok": "doctor 全过（{{total}} 项）",
+  "doctor.fail": "doctor 失败：{{failed}}/{{total}} 项",
+  "error.noHosts": "未指定宿主。用 --agent <host> 指定，可选：{{hosts}}",
+  "error.unknownHost": "未知宿主：{{name}}。可选：{{hosts}}",
+  "error.badModel": "无效的 --model：{{value}}（格式：[宿主:]角色=模型，角色：code / judgment / review）",
+  "error.noManifest": "目标未安装本引擎；先运行 install",
+  "error.noHostsInManifest": "manifest 未登记宿主；先运行 install",
+  "error.badTier": "无效的 --tier：{{value}}（可选 lean / standard / enterprise）",
+  "listHosts.title": "支持的宿主：",
+  "tui.title": "agentic-flow-kit 向导",
+  "tui.menuQuestion": "选择操作",
+  "tui.menu.install": "安装",
+  "tui.menu.upgrade": "升级",
+  "tui.menu.addHost": "追加宿主",
+  "tui.menu.doctor": "体检",
+  "tui.menu.listHosts": "宿主列表",
+  "tui.menu.quit": "退出",
+  "tui.hint.moveEnter": "↑/↓ 选择，回车确认",
+  "tui.hint.toggle": "空格勾选，回车确认",
+  "tui.hostsQuestion": "选择要安装的宿主",
+  "tui.langQuestion": "选择语言",
+  "tui.stackQuestion": "选择技术栈",
+  "tui.optsQuestion": "选择安装选项",
+  "tui.opt.gitConfig": "配置 git 门禁（推荐）",
+  "tui.opt.dryRun": "dry-run：只打印计划，不写盘",
+  "tui.opt.force": "强制覆盖冲突文件",
+  "tui.detected": "检测到",
+  "tui.detectedFile": "检测到 {{file}}",
+  "tui.stack.dotnet": ".NET",
+  "tui.stack.node": "Node.js",
+  "tui.stack.typescript": "TypeScript",
+  "tui.stack.rust": "Rust",
+  "tui.stack.go": "Go",
+  "tui.stack.java": "Java",
+  "tui.stack.empty": "未指定",
+  "tui.currentStack": "当前",
+  "tui.upgradeStackQuestion": "选择本次升级的技术栈",
+  "tui.installed": "已安装",
+  "tui.planTitle": "安装计划",
+  "tui.plan.target": "目标：{{target}}",
+  "tui.plan.hosts": "宿主：{{hosts}}",
+  "tui.plan.lang": "语言：{{lang}}",
+  "tui.plan.stack": "栈：{{stack}}",
+  "tui.confirmInstall": "开始安装？",
+  "tui.confirmUpgrade": "开始升级？",
+  "tui.askDoctor": "安装后立即体检？",
+  "tui.running": "执行中…",
+  "tui.done": "完成",
+  "tui.dryDone": "dry-run 完成，未写盘",
+  "tui.doctorQuestion": "选择体检模式",
+  "tui.doctor.normal": "普通体检",
+  "tui.doctor.deep": "深度体检（含 check-local-gates）",
+  "tui.addHostQuestion": "选择要追加的宿主",
+  "tui.backOrQuit": "返回菜单？",
+  "tui.errorTitle": "出错了",
+  "tui.yes": "是",
+  "tui.no": "否",
+  "tui.inputNumber": "输入序号后回车：",
+  "tui.toggleNumber": "输入序号切换勾选，直接回车完成：",
+  "tui.invalidNumber": "无效序号，请重试",
+  "tui.minSelection": "至少选择 {{min}} 项",
+  "install.models": "模型：{{models}}",
+  "install.modelWarning": "模型提示：{{host}} 的 {{role}} 与实现模型相同，跨模型复核不可用",
+  "install.localModels": "本地模型配置：{{path}}",
+  "install.tier": "安装档位：{{tier}}（加固：{{hardened}}）",
+  "doctor.modelConfigInvalid": "model-roles.local.json 无法解析",
+  "doctor.reviewSameAsCode": "review 与 code 相同，跨模型复核不可用",
+  "doctor.tier": "安装档位：{{tier}}",
+  "doctor.ciMissing": "缺少 CI 模板：{{paths}}（tier=lean 可忽略）",
+  "doctor.guaranteeGap": "宿主 {{host}} 不支持 {{capability}}；该保证只能是 advisory，不能当 deterministic 门",
+  "doctor.modelDrift": "模型漂移：{{host}}/{{role}} 安装值 {{installed}} ≠ 本地 {{local}}；按 model-upgrade 技能先评测再升级",
+  "doctor.hardenedHint": "加固配置含 managed-only 键；需由平台/IT 以 managed settings 部署才不可被覆盖",
+  "tui.model.useRecommended": "{{host}} 使用推荐模型？",
+  "tui.model.role": "选择 {{role}} 模型",
+  "tui.model.role.code": "实现（code）",
+  "tui.model.role.judgment": "判断（judgment）",
+  "tui.model.role.review": "复核（review）",
+  "tui.model.recommended": "推荐",
+  "tui.model.inherit": "inherit（跟随主模型）",
+  "tui.model.manual": "手动输入…",
+  "tui.model.skip": "跳过（不指定）",
+  "tui.model.manualPrompt": "输入模型 ID：",
+  "tui.model.invalid": "模型 ID 不能为空",
+  "tui.model.allowProbe": "允许执行 {{host}} 的只读模型列表命令？",
+  "tui.model.sameAsCode": "review 与 code 相同，跨模型复核不可用",
+  "tui.plan.models": "模型：{{models}}",
+  "tui.hint.typeEnter": "输入后回车",
+  "host.skillPointer": "权威技能：`{{path}}`。本文件是指针壳，执行时读取权威源；相对路径（scripts/、references/ 等）以该目录为基准。",
+  "host.skillsIndexTitle": "# 技能索引",
+  "host.skillsIndexDescription": "技能索引：权威正文在 .agents/skills/",
+  "host.skillsIndexLine": "- `{{name}}` — {{description}}（权威：`{{path}}`）",
+  "host.skillsIndexEmpty": "（暂无技能）"
+}

package/package.json

@@ -1,50 +1,37 @@
 {
   "name": "agentic-flow-kit",
-  "version": "1.8.7",
-  "description": "AI-Native 闭环工作流 + wiki 知识层脚手架——flow-kit init 一条命令为新项目装好 .agents 工作流引擎（阶段命令/角色契约/门禁钩子/kb 检索/看板/规则面预算）+ workflow 文档闭环 + wiki 知识库，装完本地可跑、零运行时依赖",
+  "version": "2.1.0",
+  "description": "AI-Native workflow engine installer: generate .agents, git hooks, host adapters, wiki/workflow scaffolds from zero.",
+  "license": "MIT",
   "type": "module",
-  "scripts": {
-    "test": "node src/run-tests.mjs",
-    "lint": "eslint .",
-    "prepack": "node -e \"require('fs').rmSync('templates/_agents/cache',{recursive:true,force:true})\" && node scripts/check-pack-eol.mjs"
-  },
   "bin": {
     "flow-kit": "bin/flow-kit.mjs"
   },
-  "files": [
-    "bin",
-    "src",
-    "templates",
-    "modules",
-    "README.md",
-    "!templates/_agents/cache",
-    "!templates/_agents/cache/**"
-  ],
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=22"
   },
   "keywords": [
     "ai-native",
     "workflow",
-    "agent",
-    "scaffold",
-    "cli",
-    "wiki",
-    "check-loop",
-    "closed-loop"
+    "agents",
+    "codex",
+    "claude-code",
+    "trae",
+    "codebuddy",
+    "installer"
   ],
-  "license": "MIT",
-  "private": false,
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/zerosloney/agentic-flow-kit.git"
-  },
-  "bugs": {
-    "url": "https://github.com/zerosloney/agentic-flow-kit/issues"
-  },
-  "homepage": "https://github.com/zerosloney/agentic-flow-kit#readme",
-  "devDependencies": {
-    "@eslint/js": "^9.39.5",
-    "eslint": "^9.39.4"
+  "files": [
+    "bin",
+    "src",
+    "templates",
+    "locales",
+    "schemas",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node --test tests/*.test.mjs",
+    "extract": "node tools/extract-from-project.mjs",
+    "doctor:self": "node bin/flow-kit.mjs doctor --target .",
+    "prepublishOnly": "node --test tests/*.test.mjs"
   }
 }

package/schemas/install-manifest.schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentic-flow-kit/install-manifest.schema.json",
+  "title": "agentic-flow-kit install manifest",
+  "type": "object",
+  "required": ["kit", "version", "language", "hosts", "stack", "files"],
+  "properties": {
+    "kit": { "const": "agentic-flow-kit" },
+    "version": { "type": "string" },
+    "installedAt": { "type": "string", "format": "date-time" },
+    "language": { "enum": ["zh-CN", "en"] },
+    "hosts": {
+      "type": "array",
+      "items": { "enum": ["trae", "codebuddy", "claude", "opencode", "qwen", "pi", "cline", "commandcode", "qoder", "zcode"] },
+      "uniqueItems": true
+    },
+    "stack": { "enum": ["dotnet", "node", "typescript", "rust", "go", "java", "empty"] },
+    "tier": { "enum": ["lean", "standard", "enterprise"] },
+    "hardened": { "type": "boolean" },
+    "files": {
+      "type": "object",
+      "additionalProperties": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/project-profile.schema.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentic-flow-kit/project-profile.schema.json",
+  "title": "agentic-flow-kit project profile",
+  "type": "object",
+  "required": ["stack"],
+  "properties": {
+    "stack": { "enum": ["dotnet", "node", "typescript", "rust", "go", "java", "empty"] },
+    "ports": {
+      "type": "object",
+      "properties": {
+        "api": { "type": "integer", "minimum": 1, "maximum": 65535 },
+        "web": { "type": "integer", "minimum": 1, "maximum": 65535 },
+        "board": { "type": "integer", "minimum": 1, "maximum": 65535 }
+      },
+      "additionalProperties": false
+    },
+    "paths": {
+      "type": "object",
+      "additionalProperties": { "type": "string" }
+    },
+    "commands": {
+      "type": "object",
+      "additionalProperties": { "type": "string" }
+    }
+  },
+  "additionalProperties": true
+}

package/src/cli/args.mjs

@@ -0,0 +1,43 @@
+// 极简参数解析：--key value / --flag / --key=value；--agent 可重复。
+export function parseArgs(argv) {
+  const args = { _: [], agents: [], models: [], flags: new Set() };
+  const takeValue = (i) => {
+    const next = argv[i + 1];
+    if (next == null || (next.startsWith('--') && next !== '-')) return null;
+    return next;
+  };
+  for (let i = 0; i < argv.length; i += 1) {
+    const raw = argv[i];
+    if (!raw.startsWith('--')) {
+      args._.push(raw);
+      continue;
+    }
+    const eq = raw.indexOf('=');
+    if (eq >= 0) {
+      const key = raw.slice(2, eq);
+      const value = raw.slice(eq + 1);
+      if (key === 'agent') args.agents.push(value);
+      else if (key === 'model') args.models.push(value);
+      else args[key] = value;
+      continue;
+    }
+    const key = raw.slice(2);
+    const value = takeValue(i);
+    if (value != null) {
+      if (key === 'agent') args.agents.push(value);
+      else if (key === 'model') args.models.push(value);
+      else args[key] = value;
+      i += 1;
+    } else {
+      args.flags.add(key);
+    }
+  }
+  // --agents a,b,c
+  if (typeof args.agents === 'string') args.agents = args.agents.split(',');
+  args.agents = args.agents.flatMap((a) => String(a).split(',')).map((a) => a.trim()).filter(Boolean);
+  return args;
+}
+
+export function flag(args, name) {
+  return args.flags.has(name) || args[name] === true || args[name] === 'true';
+}

package/src/cli/main.mjs

@@ -0,0 +1,79 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { parseArgs, flag } from './args.mjs';
+import { makeT, LANGUAGES } from '../i18n.mjs';
+import { HOST_NAMES, resolveHost } from '../hosts/registry.mjs';
+import { installCommand } from '../commands/install.mjs';
+import { doctorCommand } from '../commands/doctor.mjs';
+import { addHostCommand } from '../commands/add-host.mjs';
+import { upgradeCommand } from '../commands/upgrade.mjs';
+import { KIT_ROOT } from '../install/plan.mjs';
+
+const SUPPORTED_LANGS = new Set(LANGUAGES);
+
+function normalizeLang(input) {
+  const lang = String(input || 'zh-CN');
+  if (!SUPPORTED_LANGS.has(lang)) {
+    const err = new Error(`unsupported language: ${lang}`);
+    err.code = 'BAD_LANG';
+    throw err;
+  }
+  return lang;
+}
+
+async function main(argv) {
+  const args = parseArgs(argv);
+  const command = args._[0] || (args.help || args.h ? 'help' : 'help');
+  const lang = normalizeLang(args.lang);
+  const t = makeT(lang);
+
+  // 无位置参数且无任何选项（含 --agent/--target 等值形参数，它们不进 flags.size）、交互终端 → 进入 TUI 向导（懒加载，避免影响脚本路径）
+  if (!args._.length && args.flags.size === 0 && args.lang == null && args.agents.length === 0 && args.target == null
+    && process.stdin.isTTY && process.stdout.isTTY) {
+    const { wizardCommand } = await import('../tui/wizard.mjs');
+    return wizardCommand({ t, lang });
+  }
+
+  if (flag(args, 'version') || flag(args, 'v')) {
+    console.log(readVersion());
+    return 0;
+  }
+  if ((flag(args, 'help') || flag(args, 'h')) && command !== 'help') {
+    console.log(t('help', { version: readVersion() }));
+    return 0;
+  }
+
+  switch (command) {
+    case 'install':
+      return installCommand({ args, t, lang });
+    case 'add-host':
+      return addHostCommand({ args, t, lang });
+    case 'upgrade':
+      return upgradeCommand({ args, t, lang });
+    case 'doctor':
+      return doctorCommand({ args, t, lang });
+    case 'list-hosts':
+      for (const name of HOST_NAMES) {
+        const h = resolveHost(name);
+        console.log(`${name}\t${h.label}\t${h.dir}${h.tracked ? '\ttracked' : ''}`);
+      }
+      return 0;
+    case 'help':
+    case '--help':
+    case '-h':
+      console.log(t('help', { version: readVersion() }));
+      return 0;
+    default:
+      throw new Error(`unknown command: ${command}`);
+  }
+}
+
+function readVersion() {
+  try {
+    return JSON.parse(fs.readFileSync(path.join(KIT_ROOT, 'package.json'), 'utf8')).version;
+  } catch {
+    return 'unknown';
+  }
+}
+
+export { main, normalizeLang, SUPPORTED_LANGS, flag };

package/src/commands/add-host.mjs

@@ -0,0 +1,29 @@
+import { readManifest } from '../install/manifest.mjs';
+import { makeT } from '../i18n.mjs';
+import { resolveTarget, runInstall, resolveHosts } from './install.mjs';
+
+export function addHostCommand({ args, t, lang }) {
+  const target = resolveTarget(args);
+  const manifest = readManifest(target);
+  if (!manifest) {
+    const err = new Error(t('error.noManifest'));
+    err.code = 'NO_MANIFEST';
+    throw err;
+  }
+  // add-host 支持 `add-host claude` 位置参数，也兼容 `--agent claude`。
+  const positional = args._.slice(1);
+  const hostArgs = { ...args, agents: args.agents.length ? args.agents : positional };
+  const newHosts = resolveHosts(hostArgs, t);
+  const currentLang = args.lang || manifest.language || lang;
+  const tt = makeT(currentLang);
+  return runInstall({
+    args: { ...hostArgs, target },
+    t: tt,
+    lang: currentLang,
+    hosts: newHosts,
+    planHosts: newHosts,
+    categories: ['host'],
+    commandLabel: 'add-host',
+    stackOverride: manifest.stack,
+  });
+}

package/src/commands/doctor.mjs

@@ -0,0 +1,126 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { readManifest } from '../install/manifest.mjs';
+import { doctorGit } from '../git/config.mjs';
+import { HOSTS, hostTargetRel } from '../hosts/registry.mjs';
+import { listFiles, TEMPLATES } from '../install/plan.mjs';
+import { ROLE_NAMES, readInjectedModels, readLocalModelRoles } from '../models/resolve.mjs';
+import { resolveTarget } from './install.mjs';
+
+const HOOK_FILES = ['pre-commit', 'commit-msg', 'post-commit', 'pre-merge-commit', 'pre-push'];
+
+export function doctorCommand({ args, t }) {
+  const target = resolveTarget(args);
+  const checks = [];
+  const add = (ok, name, detail, fix, extra = {}) => checks.push({ ok, name, detail, fix, ...extra });
+  const roleVal = (entry) => (typeof entry === 'string' ? entry : entry?.model || null);
+
+  const manifest = readManifest(target);
+  if (!manifest) {
+    add(false, 'install-manifest', t('doctor.manifestMissing'));
+  } else {
+    add(true, 'install-manifest', `.agents/install-manifest.json (v${manifest.version || '?'})`);
+    for (const rel of Object.keys(manifest.files || {})) {
+      if (!fs.existsSync(path.join(target, rel))) add(false, `file ${rel}`, t('doctor.fileMissing'));
+    }
+  }
+
+  checks.push(...doctorGit(target));
+
+  const attrPath = path.join(target, '.gitattributes');
+  let attr = '';
+  try {
+    attr = fs.readFileSync(attrPath, 'utf8');
+  } catch {
+    /* missing handled below */
+  }
+  add(/merge=jsonl-union/.test(attr), '.gitattributes jsonl-union', attr ? '' : t('doctor.fileMissing'));
+  add(/merge=ours/.test(attr), '.gitattributes ours', attr ? '' : t('doctor.fileMissing'));
+
+  for (const hook of HOOK_FILES) {
+    add(fs.existsSync(path.join(target, '.githooks', hook)), `hook ${hook}`, '');
+  }
+
+  for (const host of manifest?.hosts || []) {
+    const h = HOSTS[host];
+    if (!h) {
+      add(false, `host ${host}`, t('doctor.unknownHost'));
+      continue;
+    }
+    for (const rel of listFiles(path.join(TEMPLATES, 'hosts', host))) {
+      if (rel === 'settings.hardened.json') continue; // 替换源，不独立安装
+      const targetRel = hostTargetRel(host, rel);
+      if (!fs.existsSync(path.join(target, targetRel))) add(false, `host ${host}: ${targetRel}`, t('doctor.fileMissing'));
+    }
+    // 能力缺口：没有 hooks / modelField 的宿主，相关保证只能是 advisory。
+    if (!h.hooks) add(true, `guarantee ${host}`, t('doctor.guaranteeGap', { host, capability: 'hooks' }), '', { warn: true });
+    if (h.agents && !h.agents.modelField) add(true, `guarantee ${host}`, t('doctor.guaranteeGap', { host, capability: 'model injection' }), '', { warn: true });
+  }
+
+  // 安装档位与交付面：lean 允许没有 CI；standard/enterprise 应有可运行 CI。
+  const tier = manifest?.tier || 'standard';
+  add(true, 'tier', t('doctor.tier', { tier }));
+  if (tier !== 'lean') {
+    const ci = ['azure-pipelines.yml', '.github/workflows/ci.yml'].filter((rel) => fs.existsSync(path.join(target, rel)));
+    if (ci.length) add(true, 'ci', ci.join(', '));
+    else add(true, 'ci', t('doctor.ciMissing', { paths: 'azure-pipelines.yml / .github/workflows/ci.yml' }), '', { warn: true });
+  }
+  if (manifest?.hardened) add(true, 'hardened', t('doctor.hardenedHint'), '', { warn: true });
+
+  // 模型配置是用户本地状态：存在则校验，缺失不失败（旧安装保持 doctor 全过）。
+  const localModels = readLocalModelRoles(target);
+  if (localModels.error) {
+    add(false, 'model-roles.local', t('doctor.modelConfigInvalid'));
+  } else if (localModels.exists) {
+    add(true, 'model-roles.local', path.relative(target, localModels.file) || localModels.file);
+    const value = (entry) => (typeof entry === 'string' ? entry : entry?.model);
+    const code = value(localModels.roles.code);
+    const review = value(localModels.roles.review);
+    if (code && review && code === review) {
+      add(true, 'models heterogeneous', t('doctor.reviewSameAsCode'));
+    }
+    for (const role of ROLE_NAMES) {
+      if (value(localModels.roles[role]) == null) continue;
+      add(true, `model ${role}`, String(value(localModels.roles[role])));
+    }
+    // 模型漂移：本地配置 vs 已安装子代理的 model 字段。升级前必须先评测（model-upgrade 技能）。
+    const injected = readInjectedModels({ target, hosts: manifest?.hosts || [] });
+    for (const host of manifest?.hosts || []) {
+      for (const role of ROLE_NAMES) {
+        const local = localModels.hosts?.[host]?.[role] ?? roleVal(localModels.roles[role]);
+        const installed = injected[host]?.[role];
+        if (local != null && installed != null && String(local) !== String(installed)) {
+          add(true, `drift ${host}/${role}`, t('doctor.modelDrift', { host, role, installed, local }), '', { warn: true });
+        }
+      }
+    }
+  }
+
+  const nodeMajor = Number(process.versions.node.split('.')[0]);
+  add(nodeMajor >= 22, 'node >= 22', process.version);
+
+  let failed = 0;
+  for (const c of checks) {
+    if (c.ok) {
+      const mark = c.warn ? '!' : '✓';
+      console.log(`${mark} ${c.name}${c.detail ? ` — ${c.detail}` : ''}`);
+    } else {
+      failed += 1;
+      console.log(`✗ ${c.name}${c.detail ? ` — ${c.detail}` : ''}`);
+      if (c.fix) console.log(`  → ${c.fix}`);
+    }
+  }
+  console.log(failed ? t('doctor.fail', { failed, total: checks.length }) : t('doctor.ok', { total: checks.length }));
+
+  if (args.deep) {
+    const gates = path.join(target, '.agents/scripts/check-local-gates.mjs');
+    if (fs.existsSync(gates)) {
+      console.log(`\n$ node ${gates}`);
+      const r = spawnSync(process.execPath, [gates, ...(args.fix ? ['--fix'] : [])], { cwd: target, stdio: 'inherit' });
+      if (r.status !== 0) failed += 1;
+    }
+  }
+
+  return failed ? 1 : 0;
+}