agent-quality-kit 0.13.0 → 0.14.0

package/tool/commands/context.mjs

@@ -260,6 +260,37 @@ async function installHook(full = false) {
   console.log(c.dim(`  ${T.hookWhat}`));
 }
 
+// Прошлый прогон — из отчёта, который кладёт `doctor --run`. Отдельной функцией: его читают и
+// `context`, и `prompt`, и два разбора одного файла разошлись бы.
+async function readRun() {
+  const lastRun = join(CWD, TARGET_DIR, "last-run.md");
+  if (!(await exists(lastRun))) return null;
+  const run = parseLastRun(await readFile(lastRun, "utf8"));
+  if (run) run.stale = runIsStale(run.when);
+  return run;
+}
+
+// Что советовать — теми же функциями, что у `doctor`: корзины каталога, «начните с трёх», совет
+// под язык, чужие проверки проекта. Одно место на `context` и `prompt`: второй расчёт того же
+// самого разошёлся бы с первым. Класс из пробы, чей гейт уже стоит, в совет не идёт — ставить
+// его второй раз бессмысленно.
+async function readAdvice(man, probe) {
+  const facts = await detectFacts(man);
+  const catalog = await readCatalog();
+  const { todo } = catalogBuckets(catalog, facts, coversOf(man).covered);
+  const adopt = declaredGates(man).length ? [] : proposeGates(await readAdoptFiles(CWD));
+  const blind = (probe?.classes || [])
+    .filter((b) => !facts.gateKeys.includes(b.slug))
+    .map((b) => ({ ...b, command: blindAdvice(catalog.find((r) => r.slug === b.slug), facts, {}).command }));
+  const start = startWith(todo, facts, 3)
+    .map((rec) => ({ slug: rec.slug, intent: rec.intent || "", command: blindAdvice(rec, facts, {}).command }));
+  // Гейт стоит, проба его ГОНЯЛА — и брак он пропустил. Самое ценное, что проба знает: не
+  // «поставь», а «твоя проверка здесь слепа». Гейт, поставленный после пробы, сюда не идёт —
+  // поймает ли, покажет следующая.
+  const missed = (probe?.classes || []).filter((b) => facts.gateKeys.includes(b.slug) && probe?.ran?.has(b.slug));
+  return { adopt, blind, start, missed };
+}
+
 async function cmdContext(args = []) {
   const full = args.includes("--full");
   if (args.includes("--install")) return installHook(full);
@@ -286,12 +317,7 @@ async function cmdContext(args = []) {
     rules = countArbiters(await readFile(join(CWD, entry), "utf8"), ["человек", "human", "nobody"]);
   }
 
-  let run = null;
-  const lastRun = join(CWD, TARGET_DIR, "last-run.md");
-  if (await exists(lastRun)) {
-    run = parseLastRun(await readFile(lastRun, "utf8"));
-    if (run) run.stale = runIsStale(run.when);
-  }
+  const run = await readRun();
 
   // Проба: сколько классов не ловит никто и насколько отметка отстала. Читается из файла,
   // ничего не запускает — блок обязан укладываться в секунду.
@@ -334,14 +360,7 @@ async function cmdContext(args = []) {
   // язык, чужие проверки проекта. Второй расчёт того же самого разошёлся бы с первым.
   let next = null;
   try {
-    const facts = await detectFacts(man);
-    const catalog = await readCatalog();
-    const { todo } = catalogBuckets(catalog, facts, coversOf(man).covered);
-    const adopt = declaredGates(man).length ? [] : proposeGates(await readAdoptFiles(CWD));
-    const blind = (probe?.classes || [])
-      .filter((b) => !facts.gateKeys.includes(b.slug))
-      .map((b) => ({ ...b, command: blindAdvice(catalog.find((r) => r.slug === b.slug), facts, {}).command }));
-    const start = startWith(todo, facts, 3).map((rec) => ({ slug: rec.slug, command: blindAdvice(rec, facts, {}).command }));
+    const { adopt, blind, start } = await readAdvice(man, probe);
     next = nextSteps({ init: !man, adopt, blind, start });
   } catch { /* не посчитали — блок скажет остальное; выдумывать шаги нельзя */ }
 
@@ -351,4 +370,4 @@ async function cmdContext(args = []) {
   }).join("\n"));
 }
 
-export { cmdContext, contextBlock, nextSteps, parseLastRun, countArbiters, withHook, hasOurHook, portableSelf };
+export { cmdContext, contextBlock, nextSteps, parseLastRun, countArbiters, withHook, hasOurHook, portableSelf, readRun, readAdvice };

package/tool/commands/doctor-catalog.mjs

@@ -0,0 +1,222 @@
+// tool/commands/doctor-catalog.mjs — что каталог говорит об ЭТОМ репозитории: какие записи
+// держит машина, что у проекта уже есть, что пропустила проба, с чего начать, что неприменимо.
+//
+// Вынесено из doctor.mjs, когда тот дорос до 496 строк при пределе 500 (наш же
+// `file-size-limit`). Шов настоящий: прогон гейтов и уровень — про то, что ОБЪЯВЛЕНО и как оно
+// отработало; здесь — про каталог против фактов репозитория, и меняется это в другие дни.
+
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { CWD, SELF, c } from "../lib/core.mjs";
+import { coversOf, coversUnproven } from "../lib/manifest.mjs";
+import { readCatalog, browserServerAdvice } from "../lib/repo.mjs";
+import { startWith, catalogBuckets, blindAdvice } from "../lib/advice.mjs";
+import { proposeGates, readAdoptFiles } from "../lib/adopt.mjs";
+import { assessBaseline, DEP_FILES, BASELINE_TOTAL } from "../lib/baseline.mjs";
+import { declaredGates } from "../lib/run.mjs";
+import { L } from "../i18n/index.mjs";
+
+// Обязательный минимум проекта — прогоном, а не по памяти. До сих пор это было единственное
+// место, где комплект просил верить на слово, что человек прочитал методичку и сверился.
+async function reportBaseline(man, facts) {
+  const { readdir, readFile } = await import("node:fs/promises");
+  let files = [];
+  try {
+    files = (await readdir(CWD, { withFileTypes: true })).map((d) => d.name);
+  } catch { /* пустой список честнее выдуманного: ни один пункт не подтвердится */ }
+
+  // Файлы зависимостей читаются целиком и склеиваются: трекер ошибок объявляют по-разному в
+  // каждой экосистеме, а искать его надо одинаково.
+  let depsText = "";
+  for (const f of DEP_FILES) {
+    if (!files.some((n) => n.toLowerCase() === f)) continue;
+    try { depsText += (await readFile(join(CWD, f), "utf8")).toLowerCase() + "\n"; } catch { /* нечитаемый файл — просто не признак */ }
+  }
+
+  const rows = assessBaseline({ files, gateKeys: facts.gateKeys, facts, manifest: man || {}, depsText });
+  const okCount = rows.filter((r) => r.ok).length;
+
+  console.log(c.bold(`\n  ${L.baseline.heading}\n`));
+  console.log(c.dim(`  ${L.baseline.intro(rows.length, BASELINE_TOTAL)}`));
+  console.log(c.dim(`  ${L.baseline.caveat}\n`));
+  for (const r of rows) {
+    const mark = r.ok ? c.green("✔") : c.yellow("✘");
+    const title = L.baseline.titles[r.key] || r.key;
+    console.log(`  ${mark}  ${String(r.n).padStart(2)}. ${title}`);
+    console.log(c.dim(`        ${r.ok ? L.baseline.by(r.by) : L.baseline.none}`));
+  }
+  console.log(
+    "\n  " + (okCount === rows.length ? c.green(`${okCount}/${rows.length}`) : c.yellow(`${okCount}/${rows.length}`)) +
+      c.dim(`  ·  ${L.baseline.eyes(BASELINE_TOTAL - rows.length, "kit/docs/ai/project-baseline.md")}\n`)
+  );
+}
+
+async function reportCatalog(man, facts, probe = null, verbose = true) {
+  const catalog = await readCatalog();
+  if (!catalog.length) return;
+
+  // Четвёртая корзина, а не третья: «закрыто другим арбитром» — это НЕ «не поставлено».
+  // Пока их считали вместе, вывод каждый прогон называл долгом то, что уже держит biome или
+  // ruff. Просьба первого чужого пользователя; она же — наша собственная норма про вывод.
+  const { covered, unknownGates } = coversOf(man);
+  const { held, todo, skip, byOther } = catalogBuckets(catalog, facts, covered);
+
+  console.log(c.bold(`\n  ${L.doctor.gatesHeading}\n`));
+  const marks = ["has_ci", "has_db", "has_docker", "has_tests", "has_deps"]
+    .filter((k) => facts[k])
+    .map((k) => k.replace("has_", ""));
+  console.log(
+    c.dim(`  ${L.doctor.langs}: ${[...facts.langs].join(", ") || L.doctor.langsUnknown} · ${L.doctor.files}: ${facts.files}` +
+      (marks.length ? ` · ${L.doctor.hasThings}: ${marks.join(", ")}` : "") + "\n")
+  );
+
+  if (verbose) for (const rec of held) console.log(`  ${c.green("✔")}  ${rec.slug.padEnd(22)} ${c.dim(rec.intent || "")}`);
+  else if (held.length) console.log(`  ${c.green("✔")}  ${L.doctor.heldQuiet(held.length, `${SELF} doctor --verbose`)}`);
+  // ЧТО У ВАС УЖЕ ЕСТЬ — до итога и до списка крестов. Комплект, поставленный в проект с
+  // eslint, mocha и конвейером, показывал двадцать крестов и «держит машина 0»: мы считали
+  // только СВОИ записи, а чужие проверки не читали вовсе. С точки зрения владельца это
+  // неправда, и первое, что он видел, было обвинением. Предлагаем, а не вписываем: гейт в
+  // чужом манифесте без спроса — наше решение в чужом файле.
+  if (!declaredGates(man).length) {
+    const found = proposeGates(await readAdoptFiles(CWD));
+    if (found.length) {
+      console.log(`\n  ${c.bold(L.doctor.haveAlready(found.length))}`);
+      for (const g of found) {
+        console.log(`  ${c.green("✔")}  ${g.name.padEnd(12)} ${c.dim(`${g.cmd}   ← ${g.source}`)}`);
+      }
+      console.log(c.dim(`     ${L.doctor.haveAlreadyHow(found.map((g) => `${g.name}: "${g.cmd}"`).join("  "))}`));
+    }
+  }
+
+  // ЧТО ВАШИ ПРОВЕРКИ ПРОПУСТИЛИ. Проба знала имена непойманных классов и писала в отметку одно
+  // число; человек в `doctor` не видел ничего. Это самое конкретное, что мы знаем о проекте, —
+  // не «хорошая практика», а брак, подсаженный в ЕГО файл и ЕГО проверками не замеченный, —
+  // поэтому стоит выше списка «с чего начать». Читается из файла: ничего не запускает.
+  const blindOnes = (probe?.classes || []).map((b) => [b, catalog.find((r) => r.slug === b.slug)]).filter(([, r]) => r);
+  if (blindOnes.length) {
+    console.log(`\n  ${c.yellow("⚠")}  ${c.bold(L.doctor.blindHeading(probe.behind))}`);
+    for (const [b, rec] of blindOnes) {
+      // Три случая, и сливать их нельзя. Гейт стоял и проба его ГОНЯЛА — «стоит, но здесь не
+      // ловит», самое ценное. Гейт объявлен, но проба его не гоняла (поставлен позже или
+      // медленный) — «поймает ли, покажет следующая», а не «пойман». Гейта нет — совет.
+      const ranIt = probe.ran?.has(rec.slug);
+      const now = facts.gateKeys.includes(rec.slug);
+      console.log(`  ${now && !ranIt ? c.dim("~") : c.red("✘")}  ${rec.slug.padEnd(22)} ${c.dim(`${rec.intent || ""}  ← ${b.file}`)}`);
+      if (ranIt) { console.log(c.dim(`     ${L.doctor.blindRan(rec.slug)}`)); continue; }
+      if (now) { console.log(c.dim(`     ${L.doctor.blindInstalled}`)); continue; }
+      const adv = blindAdvice(rec, facts, {});
+      if (adv.command) console.log(c.dim(`     ${L.doctor.startCmd(adv.command)}`));
+      else console.log(c.dim(`     ${L.doctor.install(`${SELF} add ${rec.slug}`)}`));
+    }
+    console.log(c.dim(`     ${L.doctor.blindMore(`${SELF} probe`)}`));
+  } else if (probe?.state === "never" && declaredGates(man).length) {
+    console.log(c.dim(`\n  ${L.doctor.probeNever(`${SELF} probe`)}`));
+  }
+
+  // С ЧЕГО НАЧАТЬ. Двадцать одинаковых крестов — это ноль требований: закрывают первое
+  // попавшееся или не закрывают ничего. Порядок не по нашему вкусу: сперва то, что родилось из
+  // настоящего отказа И закрывается одной готовой командой.
+  const first = todo.length > 3 ? startWith(todo, facts, 3) : [];
+  if (first.length) {
+    console.log(`\n  ${c.bold(L.doctor.startWith)}`);
+    for (const rec of first) {
+      const adv = blindAdvice(rec, facts, {});
+      console.log(`  ${c.yellow("→")}  ${rec.slug.padEnd(22)} ${c.dim(rec.intent || "")}`);
+      if (adv.command) console.log(c.dim(`     ${L.doctor.startCmd(adv.command)}`));
+      if (adv.tool) console.log(c.dim(`     ${L.doctor.startTool(adv.tool)}`));
+    }
+    // Одна проверка руками — это разовый героизм. Сказать про хук здесь, а не в конце: человек
+    // читает первые строки и закрывает, а именно сейчас у него в руках список того, что стоит
+    // повесить перед пушем.
+    console.log(c.dim(`\n     ${L.doctor.startHook}`));
+  }
+
+  // ОСТАЛЬНОЕ — ПОСЛЕ ГЛАВНОГО И СЖАТО. Список шёл первым, по две строки на запись (вторая —
+  // «поставить: aqk add …»), и на requests главное начиналось со строки 84 из 102: человек
+  // читает сверху и закрывает раньше. Разбор соседа 2026-09-11 (research/competitors/agentlint.md):
+  // там первыми идут пять главных исправлений. Записи не теряются — теряется повтор подсказки.
+  const rest = todo.filter((r) => !first.includes(r));
+  if (rest.length) {
+    if (first.length) console.log(`\n  ${c.bold(L.doctor.todoRest(rest.length))}`);
+    else console.log("");
+    // ○, а не ✘: запись не установлена — это не падение. Крест в зелёном прогоне глаз читает
+    // как провал, и через неделю человек перестаёт смотреть на красное вообще (отзыв с живого
+    // проекта 2026-09-11). ✘ остаётся за тем, что упало или пропустило брак.
+    for (const rec of rest) console.log(`  ${c.dim("○")}  ${rec.slug.padEnd(22)} ${rec.intent || ""}`);
+    console.log(c.dim(`     ${L.doctor.todoRestHow(SELF)}`));
+  }
+
+  // Второстепенное — в конце: что закрыто чужим арбитром, что неприменимо, советы без вердикта.
+  if (byOther.length) {
+    console.log(c.dim(`\n  ${L.doctor.coveredBy(byOther.length)}`));
+    for (const [rec, gate] of byOther) console.log(c.dim(`  ~  ${rec.slug.padEnd(22)} ${L.doctor.coveredByGate(gate)}`));
+  }
+  // Гейт, которого нет в gates:, не закрывает ничего — и молчать об этом нельзя: человек
+  // считает запись закрытой, а её не держит никто. Называется поимённо, жёлтым.
+  if (unknownGates.length) {
+    console.log(c.yellow(`\n  ${L.doctor.coversUnknown(unknownGates.join(", "))}`));
+  }
+  // Заявка «эту запись держит наш линтер» сверяется с кодами правил из рецепта записи.
+  // Замерено на живом ruff.toml: девятнадцать групп правил, а print() не ловится — и заявка
+  // сняла бы запись с долга, не закрыв её ничем.
+  // Конфиги — ПО ЛИНТЕРАМ, а не одной склейкой: заявка сверяется правилами того линтера,
+  // которым закрыт гейт (отзыв с живого проекта 2026-09-11 — коды ruff искались в biome.json).
+  const readAll = async (names) => {
+    let t = "";
+    for (const f of names) { try { t += await readFile(join(CWD, f), "utf8") + "\n"; } catch { /* нет файла */ } }
+    return t;
+  };
+  let scripts = {}, pkgText = "";
+  try { pkgText = await readFile(join(CWD, "package.json"), "utf8"); scripts = JSON.parse(pkgText)?.scripts || {}; } catch { /* нет или не JSON */ }
+  const configs = {
+    // ruff.toml и .ruff.toml — конфиг ruff целиком, слово «ruff» в них писать незачем (поймал наш же
+    // smoke: `extend-select = [..., "T20"]` выбрасывался). pyproject.toml — только если в нём есть
+    // раздел ruff: он есть почти у каждого python-проекта и без ruff.
+    ruff: (await readAll(["ruff.toml", ".ruff.toml"])) +
+      ((await readAll(["pyproject.toml"])).match(/^\[tool\.ruff[\s\S]*/m)?.[0] || ""),
+    eslint: (await readAll([".eslintrc", ".eslintrc.json", ".eslintrc.js", ".eslintrc.cjs", ".eslintrc.yml", "eslint.config.js", "eslint.config.mjs", "eslint.config.cjs", "eslint.config.ts"])) +
+      (/"eslintConfig"/.test(pkgText) ? pkgText : ""),
+    biome: await readAll(["biome.json", "biome.jsonc"]),
+    scripts,
+  };
+  for (const u of coversUnproven(man, catalog, configs)) {
+    if (u.kind === "unproven") {
+      console.log(c.yellow(`\n  ${L.doctor.coversUnproven(u.entry, u.gate, u.codes.join(", "))}`));
+      console.log(c.dim(`  ${L.doctor.coversUnprovenHow(`${SELF} add ${u.entry}`)}`));
+    } else if (u.kind === "impossible") {
+      console.log(c.yellow(`\n  ${L.doctor.coversImpossible(u.entry, u.gate, u.linter)}`));
+      console.log(c.dim(`  ${L.doctor.coversUnprovenHow(`${SELF} add ${u.entry}`)}`));
+    } else {
+      console.log(c.dim(`\n  ${L.doctor.coversCantCheck(u.entry, u.gate)}`));
+    }
+  }
+  // Не вердикт, а совет: отсутствие браузерного сервера — незанятая возможность, а не дефект.
+  // Поэтому строка тусклая и без значка, и её нет у проекта без интерфейса.
+  let mcpText = "";
+  for (const f of [".mcp.json", ".cursor/mcp.json", ".vscode/mcp.json", ".claude/mcp.json"]) {
+    try { mcpText += await readFile(join(CWD, f), "utf8"); } catch { /* нет файла — нечего читать */ }
+  }
+  const browser = browserServerAdvice(facts, mcpText);
+  if (browser) {
+    console.log(c.dim(`\n  ${L.doctor.noBrowserServer}`));
+    console.log(c.dim(`  ${L.doctor.noBrowserServerHow(browser.servers.join("  ·  "))}`));
+  }
+  if (skip.length) {
+    if (verbose) {
+      console.log(c.dim(`\n  ${L.doctor.notApplicable(skip.length)}`));
+      for (const [rec, why] of skip) console.log(c.dim(`  ·  ${rec.slug.padEnd(22)} ${why}`));
+    } else {
+      console.log(c.dim(`\n  ${L.doctor.skipQuiet(skip.length, `${SELF} doctor --verbose`)}`));
+    }
+  }
+  console.log(
+    `\n  ${c.bold(L.doctor.total)} ${L.doctor.totalHeld(held.length)}, ${L.doctor.totalTodo(c.yellow(todo.length))}, ` +
+      (byOther.length ? `${L.doctor.totalCovered(byOther.length)}, ` : "") +
+      c.dim(L.doctor.totalSkip(skip.length)) + "\n"
+  );
+  // Числа отдаются наружу, а не пересчитываются второй раз: два счёта одного и того же
+  // расходятся ровно так же, как два списка команд.
+  return { held: held.length, todo: todo.length, todoRecs: todo };
+}
+
+export { reportBaseline, reportCatalog };

package/tool/commands/doctor.mjs

@@ -3,218 +3,17 @@
 import { readFile, mkdir, writeFile } from "node:fs/promises";
 import { join, resolve } from "node:path";
 import { spawnSync } from "node:child_process";
-import { scopeOutput, splitAdvice, changedFiles } from "../lib/scope.mjs";
 import { CWD, PKG_ROOT, TARGET_DIR, MANIFEST, SELF, c, exists, die, RUNTIME_FILES } from "../lib/core.mjs";
 import { cmdProbe, probeStatus } from "./probe.mjs";
-import { readManifest, assessLevel, unknownKeys, KNOWN_KEYS, advisorySet, layoutChecks, coversOf, coversUnproven, unparsedLines } from "../lib/manifest.mjs";
+import { readManifest, assessLevel, unknownKeys, KNOWN_KEYS, layoutChecks, unparsedLines } from "../lib/manifest.mjs";
 import { proveGates } from "../lib/prove.mjs";
-import { detectFacts, readCatalog, browserServerAdvice } from "../lib/repo.mjs";
-import { startWith, catalogBuckets, blindAdvice } from "../lib/advice.mjs";
-import { proposeGates, readAdoptFiles } from "../lib/adopt.mjs";
-import { assessBaseline, DEP_FILES, BASELINE_TOTAL } from "../lib/baseline.mjs";
+import { detectFacts, claudeShimFor } from "../lib/repo.mjs";
+import { reportBaseline, reportCatalog } from "./doctor-catalog.mjs";
 import { L } from "../i18n/index.mjs";
 import { countArbiters } from "./context.mjs";
 import { beginBrief, finishBrief } from "../lib/brief.mjs";
 import { declaredGates, sinceRef, runGates, progress, listArg } from "../lib/run.mjs";
-import { autoProbeAllowed } from "../lib/cadence.mjs";
-
-// Обязательный минимум проекта — прогоном, а не по памяти. До сих пор это было единственное
-// место, где комплект просил верить на слово, что человек прочитал методичку и сверился.
-async function reportBaseline(man, facts) {
-  const { readdir, readFile } = await import("node:fs/promises");
-  let files = [];
-  try {
-    files = (await readdir(CWD, { withFileTypes: true })).map((d) => d.name);
-  } catch { /* пустой список честнее выдуманного: ни один пункт не подтвердится */ }
-
-  // Файлы зависимостей читаются целиком и склеиваются: трекер ошибок объявляют по-разному в
-  // каждой экосистеме, а искать его надо одинаково.
-  let depsText = "";
-  for (const f of DEP_FILES) {
-    if (!files.some((n) => n.toLowerCase() === f)) continue;
-    try { depsText += (await readFile(join(CWD, f), "utf8")).toLowerCase() + "\n"; } catch { /* нечитаемый файл — просто не признак */ }
-  }
-
-  const rows = assessBaseline({ files, gateKeys: facts.gateKeys, facts, manifest: man || {}, depsText });
-  const okCount = rows.filter((r) => r.ok).length;
-
-  console.log(c.bold(`\n  ${L.baseline.heading}\n`));
-  console.log(c.dim(`  ${L.baseline.intro(rows.length, BASELINE_TOTAL)}`));
-  console.log(c.dim(`  ${L.baseline.caveat}\n`));
-  for (const r of rows) {
-    const mark = r.ok ? c.green("✔") : c.yellow("✘");
-    const title = L.baseline.titles[r.key] || r.key;
-    console.log(`  ${mark}  ${String(r.n).padStart(2)}. ${title}`);
-    console.log(c.dim(`        ${r.ok ? L.baseline.by(r.by) : L.baseline.none}`));
-  }
-  console.log(
-    "\n  " + (okCount === rows.length ? c.green(`${okCount}/${rows.length}`) : c.yellow(`${okCount}/${rows.length}`)) +
-      c.dim(`  ·  ${L.baseline.eyes(BASELINE_TOTAL - rows.length, "kit/docs/ai/project-baseline.md")}\n`)
-  );
-}
-
-async function reportCatalog(man, facts, probe = null) {
-  const catalog = await readCatalog();
-  if (!catalog.length) return;
-
-  // Четвёртая корзина, а не третья: «закрыто другим арбитром» — это НЕ «не поставлено».
-  // Пока их считали вместе, вывод каждый прогон называл долгом то, что уже держит biome или
-  // ruff. Просьба первого чужого пользователя; она же — наша собственная норма про вывод.
-  const { covered, unknownGates } = coversOf(man);
-  const { held, todo, skip, byOther } = catalogBuckets(catalog, facts, covered);
-
-  console.log(c.bold(`\n  ${L.doctor.gatesHeading}\n`));
-  const marks = ["has_ci", "has_db", "has_docker", "has_tests", "has_deps"]
-    .filter((k) => facts[k])
-    .map((k) => k.replace("has_", ""));
-  console.log(
-    c.dim(`  ${L.doctor.langs}: ${[...facts.langs].join(", ") || L.doctor.langsUnknown} · ${L.doctor.files}: ${facts.files}` +
-      (marks.length ? ` · ${L.doctor.hasThings}: ${marks.join(", ")}` : "") + "\n")
-  );
-
-  for (const rec of held) console.log(`  ${c.green("✔")}  ${rec.slug.padEnd(22)} ${c.dim(rec.intent || "")}`);
-  // ЧТО У ВАС УЖЕ ЕСТЬ — до итога и до списка крестов. Комплект, поставленный в проект с
-  // eslint, mocha и конвейером, показывал двадцать крестов и «держит машина 0»: мы считали
-  // только СВОИ записи, а чужие проверки не читали вовсе. С точки зрения владельца это
-  // неправда, и первое, что он видел, было обвинением. Предлагаем, а не вписываем: гейт в
-  // чужом манифесте без спроса — наше решение в чужом файле.
-  if (!declaredGates(man).length) {
-    const found = proposeGates(await readAdoptFiles(CWD));
-    if (found.length) {
-      console.log(`\n  ${c.bold(L.doctor.haveAlready(found.length))}`);
-      for (const g of found) {
-        console.log(`  ${c.green("✔")}  ${g.name.padEnd(12)} ${c.dim(`${g.cmd}   ← ${g.source}`)}`);
-      }
-      console.log(c.dim(`     ${L.doctor.haveAlreadyHow(found.map((g) => `${g.name}: "${g.cmd}"`).join("  "))}`));
-    }
-  }
-
-  // ЧТО ВАШИ ПРОВЕРКИ ПРОПУСТИЛИ. Проба знала имена непойманных классов и писала в отметку одно
-  // число; человек в `doctor` не видел ничего. Это самое конкретное, что мы знаем о проекте, —
-  // не «хорошая практика», а брак, подсаженный в ЕГО файл и ЕГО проверками не замеченный, —
-  // поэтому стоит выше списка «с чего начать». Читается из файла: ничего не запускает.
-  const blindOnes = (probe?.classes || []).map((b) => [b, catalog.find((r) => r.slug === b.slug)]).filter(([, r]) => r);
-  if (blindOnes.length) {
-    console.log(`\n  ${c.yellow("⚠")}  ${c.bold(L.doctor.blindHeading(probe.behind))}`);
-    for (const [b, rec] of blindOnes) {
-      // Три случая, и сливать их нельзя. Гейт стоял и проба его ГОНЯЛА — «стоит, но здесь не
-      // ловит», самое ценное. Гейт объявлен, но проба его не гоняла (поставлен позже или
-      // медленный) — «поймает ли, покажет следующая», а не «пойман». Гейта нет — совет.
-      const ranIt = probe.ran?.has(rec.slug);
-      const now = facts.gateKeys.includes(rec.slug);
-      console.log(`  ${now && !ranIt ? c.dim("~") : c.red("✘")}  ${rec.slug.padEnd(22)} ${c.dim(`${rec.intent || ""}  ← ${b.file}`)}`);
-      if (ranIt) { console.log(c.dim(`     ${L.doctor.blindRan(rec.slug)}`)); continue; }
-      if (now) { console.log(c.dim(`     ${L.doctor.blindInstalled}`)); continue; }
-      const adv = blindAdvice(rec, facts, {});
-      if (adv.command) console.log(c.dim(`     ${L.doctor.startCmd(adv.command)}`));
-      else console.log(c.dim(`     ${L.doctor.install(`${SELF} add ${rec.slug}`)}`));
-    }
-    console.log(c.dim(`     ${L.doctor.blindMore(`${SELF} probe`)}`));
-  } else if (probe?.state === "never" && declaredGates(man).length) {
-    console.log(c.dim(`\n  ${L.doctor.probeNever(`${SELF} probe`)}`));
-  }
-
-  // С ЧЕГО НАЧАТЬ. Двадцать одинаковых крестов — это ноль требований: закрывают первое
-  // попавшееся или не закрывают ничего. Порядок не по нашему вкусу: сперва то, что родилось из
-  // настоящего отказа И закрывается одной готовой командой.
-  const first = todo.length > 3 ? startWith(todo, facts, 3) : [];
-  if (first.length) {
-    console.log(`\n  ${c.bold(L.doctor.startWith)}`);
-    for (const rec of first) {
-      const adv = blindAdvice(rec, facts, {});
-      console.log(`  ${c.yellow("→")}  ${rec.slug.padEnd(22)} ${c.dim(rec.intent || "")}`);
-      if (adv.command) console.log(c.dim(`     ${L.doctor.startCmd(adv.command)}`));
-      if (adv.tool) console.log(c.dim(`     ${L.doctor.startTool(adv.tool)}`));
-    }
-    // Одна проверка руками — это разовый героизм. Сказать про хук здесь, а не в конце: человек
-    // читает первые строки и закрывает, а именно сейчас у него в руках список того, что стоит
-    // повесить перед пушем.
-    console.log(c.dim(`\n     ${L.doctor.startHook}`));
-  }
-
-  // ОСТАЛЬНОЕ — ПОСЛЕ ГЛАВНОГО И СЖАТО. Список шёл первым, по две строки на запись (вторая —
-  // «поставить: aqk add …»), и на requests главное начиналось со строки 84 из 102: человек
-  // читает сверху и закрывает раньше. Разбор соседа 2026-09-11 (research/competitors/agentlint.md):
-  // там первыми идут пять главных исправлений. Записи не теряются — теряется повтор подсказки.
-  const rest = todo.filter((r) => !first.includes(r));
-  if (rest.length) {
-    if (first.length) console.log(`\n  ${c.bold(L.doctor.todoRest(rest.length))}`);
-    else console.log("");
-    // ○, а не ✘: запись не установлена — это не падение. Крест в зелёном прогоне глаз читает
-    // как провал, и через неделю человек перестаёт смотреть на красное вообще (отзыв с живого
-    // проекта 2026-09-11). ✘ остаётся за тем, что упало или пропустило брак.
-    for (const rec of rest) console.log(`  ${c.dim("○")}  ${rec.slug.padEnd(22)} ${rec.intent || ""}`);
-    console.log(c.dim(`     ${L.doctor.todoRestHow(SELF)}`));
-  }
-
-  // Второстепенное — в конце: что закрыто чужим арбитром, что неприменимо, советы без вердикта.
-  if (byOther.length) {
-    console.log(c.dim(`\n  ${L.doctor.coveredBy(byOther.length)}`));
-    for (const [rec, gate] of byOther) console.log(c.dim(`  ~  ${rec.slug.padEnd(22)} ${L.doctor.coveredByGate(gate)}`));
-  }
-  // Гейт, которого нет в gates:, не закрывает ничего — и молчать об этом нельзя: человек
-  // считает запись закрытой, а её не держит никто. Называется поимённо, жёлтым.
-  if (unknownGates.length) {
-    console.log(c.yellow(`\n  ${L.doctor.coversUnknown(unknownGates.join(", "))}`));
-  }
-  // Заявка «эту запись держит наш линтер» сверяется с кодами правил из рецепта записи.
-  // Замерено на живом ruff.toml: девятнадцать групп правил, а print() не ловится — и заявка
-  // сняла бы запись с долга, не закрыв её ничем.
-  // Конфиги — ПО ЛИНТЕРАМ, а не одной склейкой: заявка сверяется правилами того линтера,
-  // которым закрыт гейт (отзыв с живого проекта 2026-09-11 — коды ruff искались в biome.json).
-  const readAll = async (names) => {
-    let t = "";
-    for (const f of names) { try { t += await readFile(join(CWD, f), "utf8") + "\n"; } catch { /* нет файла */ } }
-    return t;
-  };
-  let scripts = {}, pkgText = "";
-  try { pkgText = await readFile(join(CWD, "package.json"), "utf8"); scripts = JSON.parse(pkgText)?.scripts || {}; } catch { /* нет или не JSON */ }
-  const configs = {
-    // ruff.toml и .ruff.toml — конфиг ruff целиком, слово «ruff» в них писать незачем (поймал наш же
-    // smoke: `extend-select = [..., "T20"]` выбрасывался). pyproject.toml — только если в нём есть
-    // раздел ruff: он есть почти у каждого python-проекта и без ruff.
-    ruff: (await readAll(["ruff.toml", ".ruff.toml"])) +
-      ((await readAll(["pyproject.toml"])).match(/^\[tool\.ruff[\s\S]*/m)?.[0] || ""),
-    eslint: (await readAll([".eslintrc", ".eslintrc.json", ".eslintrc.js", ".eslintrc.cjs", ".eslintrc.yml", "eslint.config.js", "eslint.config.mjs", "eslint.config.cjs", "eslint.config.ts"])) +
-      (/"eslintConfig"/.test(pkgText) ? pkgText : ""),
-    biome: await readAll(["biome.json", "biome.jsonc"]),
-    scripts,
-  };
-  for (const u of coversUnproven(man, catalog, configs)) {
-    if (u.kind === "unproven") {
-      console.log(c.yellow(`\n  ${L.doctor.coversUnproven(u.entry, u.gate, u.codes.join(", "))}`));
-      console.log(c.dim(`  ${L.doctor.coversUnprovenHow(`${SELF} add ${u.entry}`)}`));
-    } else if (u.kind === "impossible") {
-      console.log(c.yellow(`\n  ${L.doctor.coversImpossible(u.entry, u.gate, u.linter)}`));
-      console.log(c.dim(`  ${L.doctor.coversUnprovenHow(`${SELF} add ${u.entry}`)}`));
-    } else {
-      console.log(c.dim(`\n  ${L.doctor.coversCantCheck(u.entry, u.gate)}`));
-    }
-  }
-  // Не вердикт, а совет: отсутствие браузерного сервера — незанятая возможность, а не дефект.
-  // Поэтому строка тусклая и без значка, и её нет у проекта без интерфейса.
-  let mcpText = "";
-  for (const f of [".mcp.json", ".cursor/mcp.json", ".vscode/mcp.json", ".claude/mcp.json"]) {
-    try { mcpText += await readFile(join(CWD, f), "utf8"); } catch { /* нет файла — нечего читать */ }
-  }
-  const browser = browserServerAdvice(facts, mcpText);
-  if (browser) {
-    console.log(c.dim(`\n  ${L.doctor.noBrowserServer}`));
-    console.log(c.dim(`  ${L.doctor.noBrowserServerHow(browser.servers.join("  ·  "))}`));
-  }
-  if (skip.length) {
-    console.log(c.dim(`\n  ${L.doctor.notApplicable(skip.length)}`));
-    for (const [rec, why] of skip) console.log(c.dim(`  ·  ${rec.slug.padEnd(22)} ${why}`));
-  }
-  console.log(
-    `\n  ${c.bold(L.doctor.total)} ${L.doctor.totalHeld(held.length)}, ${L.doctor.totalTodo(c.yellow(todo.length))}, ` +
-      (byOther.length ? `${L.doctor.totalCovered(byOther.length)}, ` : "") +
-      c.dim(L.doctor.totalSkip(skip.length)) + "\n"
-  );
-  // Числа отдаются наружу, а не пересчитываются второй раз: два счёта одного и того же
-  // расходятся ровно так же, как два списка команд.
-  return { held: held.length, todo: todo.length, todoRecs: todo };
-}
+import { autoProbeAllowed, levelLimits } from "../lib/cadence.mjs";
 
 // Короткий отчёт «что из этого реально брали» — не для человека, а для агента в следующей
 // сессии и для самого владельца: список объявленных гейтов молчит о том, сколько из них
@@ -259,6 +58,12 @@ async function autoProbe(brief) {
 
 async function cmdDoctor() {
   const brief = process.argv.includes("--brief");
+  // Коротко по умолчанию, поимённо по `--verbose`. Отзыв с живого проекта 2026-09-11: вывод на
+  // сто строк, из них семьдесят — зелёные галочки, и красное теряется между ними. Сворачивается
+  // только то, что ничего не требует: пройденное, неприменимое, пояснения. Упавшее, совет и
+  // «что поставить» печатаются всегда.
+  // AQK_VERBOSE=1 — то же для конвейера, где лог читают потом и целиком.
+  const verbose = process.argv.includes("--verbose") || process.env.AQK_VERBOSE === "1";
   const buf = brief ? beginBrief() : null;
   // Версия в шапке — единственное, что привязывает баг-репорт к коммиту, если ставили не из
   // релиза: без неё "у меня не работает" ничем не отличается от любой другой версии за год.
@@ -301,6 +106,11 @@ async function cmdDoctor() {
     }
   }
 
+  // СВОД, КОТОРОГО НЕ ВИДИТ CLAUDE CODE. Он читает CLAUDE.md, а не AGENTS.md (документация,
+  // сверено 2026-09-11); подробности и исходы — claudeSeesRules.
+  const shim = await claudeShimFor(CWD);
+  if (shim) console.log(`\n  ${c.yellow("!")}  ${L.doctor.claudeShim[shim]}`);
+
   // Команды в точке входа заполнены или остались пустыми заготовками? Файл берётся тот же,
   // что проверен выше, — иначе проект на `CLAUDE.md` этой проверки не получал вовсе.
   const entryFile = (Array.isArray(man?.entry) ? man.entry : []).find((e) => typeof e === "string" && e.trim())?.trim() || "AGENTS.md";
@@ -319,7 +129,7 @@ async function cmdDoctor() {
     const arb = countArbiters(text, ["человек", "human", "nobody"]);
     if (arb.total && arb.human) {
       console.log(`\n  ${c.yellow("!")}  ${L.doctor.rulesByHuman(arb.total, arb.machine, arb.human)}`);
-      console.log(c.dim(`     ${L.doctor.rulesByHumanWhy}`));
+      if (verbose) console.log(c.dim(`     ${L.doctor.rulesByHumanWhy}`));
     }
 
     const emptyCommands = (text.match(/^- [^:]+: ``$/gm) || []).length;
@@ -390,6 +200,16 @@ async function cmdDoctor() {
   } else {
     console.log(c.green(`  ${L.doctor.allDone}\n`));
   }
+  // Состояние пробы — из файла отметки, миллисекунды. Нет его — блок про пробу просто молчит.
+  let probe = null;
+  try { probe = await probeStatus(); } catch { /* пробы нет — и ладно */ }
+  // Чего уровень НЕ доказывает — сразу под ним, пока глаз на нём (см. levelLimits).
+  if (reached >= 1) {
+    const lim = levelLimits(probe);
+    console.log(c.dim(`  ${L.doctor.limitsTitle}`));
+    console.log(`    ${L.doctor.limitsProbe[lim.kind](lim, `${SELF} probe`)}`);
+    console.log(`    ${L.doctor.limitsCi}\n`);
+  }
 
   const facts = await detectFacts(man);
   if (process.argv.includes("--baseline")) {
@@ -402,10 +222,7 @@ async function cmdDoctor() {
     await reportBaseline(man, facts);
     process.exit(0);
   }
-  // Состояние пробы — из файла отметки, миллисекунды. Нет его — блок про пробу просто молчит.
-  let probe = null;
-  try { probe = await probeStatus(); } catch { /* пробы нет — и ладно */ }
-  const cat = (await reportCatalog(man, facts, probe)) || { held: 0, todo: 0, todoRecs: [] };
+  const cat = (await reportCatalog(man, facts, probe, verbose)) || { held: 0, todo: 0, todoRecs: [] };
 
   // «Объявлен» ≠ «работает». Без --run говорим это вслух, а не молчим.
   const wantRun = process.argv.includes("--run");
@@ -420,7 +237,7 @@ async function cmdDoctor() {
     const ji = process.argv.indexOf("--jobs");
     const jobs = ji > -1 ? Number(process.argv[ji + 1]) : 1;
     if (!Number.isInteger(jobs) || jobs < 1) die(L.doctor.jobsBad(process.argv[ji + 1] ?? ""));
-    const run = await runGates(man, { since: sinceRef(), only: listArg(process.argv, "--only"), skip: listArg(process.argv, "--skip"), jobs });
+    const run = await runGates(man, { since: sinceRef(), only: listArg(process.argv, "--only"), skip: listArg(process.argv, "--skip"), jobs, verbose });
     gateFailed = run.failed;
     failedNames = run.results.filter((r) => !r.ok).map((r) => r.name);
     skippedNames = run.skipped || [];