agent-quality-kit 0.12.0 → 0.14.0

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,200 +3,23 @@
 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 } from "../lib/core.mjs";
-import { cmdProbe, probeStatus, blindAdvice } from "./probe.mjs";
-import { readManifest, assessLevel, unknownKeys, KNOWN_KEYS, advisorySet, layoutChecks, coversOf, coversUnproven, unparsedLines } from "../lib/manifest.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, layoutChecks, unparsedLines } from "../lib/manifest.mjs";
 import { proveGates } from "../lib/prove.mjs";
-import { detectFacts, readCatalog, triggerVerdict, browserServerAdvice, startWith } from "../lib/repo.mjs";
-import { proposeGates, ADOPT_FILES, ADOPT_SCRIPTS } 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 } from "../lib/run.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 = [];
-  for (const rec of catalog) {
-    const v = triggerVerdict(rec, facts);
-    if (!v.applies) skip.push([rec, v.why]);
-    else if (facts.gateKeys.includes(rec.slug)) held.push(rec);
-    else if (covered.has(rec.slug)) byOther.push([rec, covered.get(rec.slug)]);
-    else todo.push(rec);
-  }
-
-  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 || "")}`);
-  for (const rec of todo) {
-    console.log(`  ${c.yellow("✘")}  ${rec.slug.padEnd(22)} ${rec.intent || ""}`);
-    console.log(c.dim(`      ${L.doctor.install(`${SELF} add ${rec.slug}`)}`));
-  }
-  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() не ловится — и заявка
-  // сняла бы запись с долга, не закрыв её ничем.
-  let linterCfg = "";
-  for (const f of ["ruff.toml", ".ruff.toml", "pyproject.toml", ".eslintrc.json", "eslint.config.js", "eslint.config.mjs", "biome.json"]) {
-    try { linterCfg += await readFile(join(CWD, f), "utf8"); } catch { /* нет файла — нечего читать */ }
-  }
-  const unproven = coversUnproven(man, catalog, linterCfg);
-  for (const u of 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}`)}`));
-  }
-  // Не вердикт, а совет: отсутствие браузерного сервера — незанятая возможность, а не дефект.
-  // Поэтому строка тусклая и без значка, и её нет у проекта без интерфейса.
-  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}`));
-  }
-  // ЧТО У ВАС УЖЕ ЕСТЬ — до итога и до списка крестов. Комплект, поставленный в проект с
-  // eslint, mocha и конвейером, показывал двадцать крестов и «держит машина 0»: мы считали
-  // только СВОИ записи, а чужие проверки не читали вовсе. С точки зрения владельца это
-  // неправда, и первое, что он видел, было обвинением. Предлагаем, а не вписываем: гейт в
-  // чужом манифесте без спроса — наше решение в чужом файле.
-  if (!declaredGates(man).length) {
-    const files = {};
-    for (const n of ADOPT_FILES) {
-      try { files[n] = await readFile(join(CWD, n), "utf8"); } catch { /* нет — и ладно */ }
-    }
-    for (const n of ADOPT_SCRIPTS) if (await exists(join(CWD, n))) files[n] = "";
-    const found = proposeGates(files);
-    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`)}`));
-  }
-
-  // С ЧЕГО НАЧАТЬ. Двадцать одинаковых крестов — это ноль требований: закрывают первое
-  // попавшееся или не закрывают ничего. Порядок не по нашему вкусу: сперва то, что родилось из
-  // настоящего отказа И закрывается одной готовой командой.
-  if (todo.length > 3) {
-    const first = startWith(todo, facts, 3);
-    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}`));
-  }
-
-  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 { declaredGates, sinceRef, runGates, progress, listArg } from "../lib/run.mjs";
+import { autoProbeAllowed, levelLimits } from "../lib/cadence.mjs";
 
 // Короткий отчёт «что из этого реально брали» — не для человека, а для агента в следующей
 // сессии и для самого владельца: список объявленных гейтов молчит о том, сколько из них
 // действительно стоят и работают именно СЕЙЧАС. Перезаписывается каждым прогоном, не копится:
 // история — дело git-лога коммитов с этим отчётом, если владелец решит его коммитить.
-async function writeRunReport({ version, reached, results }) {
+async function writeRunReport({ version, reached, results, skipped = [] }) {
   const stamp = new Date().toISOString().replace("T", " ").slice(0, 16);
   const ok = results.filter((r) => r.ok).length;
   const lines = [
@@ -205,6 +28,9 @@ async function writeRunReport({ version, reached, results }) {
     `${L.report.level}: AQK-${reached < 0 ? L.doctor.levelNone : reached}`,
     "",
     ...results.map((r) => `${r.ok ? "✔" : "✘"} ${r.name} — ${r.secs}s${r.ok ? "" : ` (${r.note || L.doctor.exitCode(r.code)})`}`),
+    // Пропущенные по --skip/--only — строкой «~»: блок для агента читает их как «не запускались»,
+    // а не как зелёные. Молчание о них прочиталось бы как «проверено».
+    ...skipped.map((n) => `~ ${n} — ${L.report.skippedBySelect}`),
     "",
     L.report.summary(ok, results.length),
   ].filter((l) => l !== null);
@@ -214,8 +40,30 @@ async function writeRunReport({ version, reached, results }) {
   await writeFile(dst, lines.join("\n") + "\n", "utf8");
 }
 
+// ПРОБА ЗАПУСКАЕТСЯ САМА, раз в сто коммитов, — кроме конвейера (там это минуты сюрпризом в
+// быстрой проверке, отзыв с живого проекта 2026-09-11). Не влияет на код возврата никогда: это
+// осмотр, а не порог. Отдельной функцией: внутри прогона эта лесенка дала вложенность 6, и наш же
+// complexity-limit её поймал.
+async function autoProbe(brief) {
+  let st;
+  try { st = await probeStatus(); } catch { return; /* пробы нет — прогон про гейты, а не про неё */ }
+  if (st.badEvery !== undefined) { console.log(c.yellow(`\n  ${L.probe.badEvery(st.badEvery)}`)); return; }
+  if (st.state !== "never" && st.state !== "stale") return;
+  if (!autoProbeAllowed({ brief })) { console.log(c.dim(`\n  ${L.probe.autoNotInCi(`${SELF} probe`)}`)); return; }
+  // Сообщение обязано быть верным в обоих случаях: первая версия печатала «прошло сто коммитов»
+  // и там, где пробы не было ВОВСЕ — число бралось из порога, а не из факта.
+  console.log(c.dim(`\n  ${st.state === "never" ? L.probe.autoFirst : L.probe.auto(st.behind)}`));
+  try { await cmdProbe([], { auto: true }); } catch { /* проба не состоялась — прогон это не роняет */ }
+}
+
 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;
   // Версия в шапке — единственное, что привязывает баг-репорт к коммиту, если ставили не из
   // релиза: без неё "у меня не работает" ничем не отличается от любой другой версии за год.
@@ -236,12 +84,33 @@ async function cmdDoctor() {
   const checks = layoutChecks(man, inKit);
 
   let missing = 0;
-  for (const [path, what] of checks) {
+  for (const [path, what, required] of checks) {
     const ok = await exists(join(CWD, path));
-    if (!ok) missing++;
-    console.log(`  ${ok ? c.green("✔") : c.red("✘")}  ${path.padEnd(22)} ${c.dim(what)}`);
+    if (!ok && required) missing++;
+    const mark = ok ? c.green("✔") : required ? c.red("✘") : c.dim("○");
+    console.log(`  ${mark}  ${path.padEnd(22)} ${c.dim(what)}${!ok && !required ? c.dim(` · ${L.doctor.layoutAdvice}`) : ""}`);
+  }
+
+  // СЛУЖЕБНЫЙ ФАЙЛ, КОТОРЫЙ ВИДИТ GIT. Отзыв с живого проекта 2026-09-11: `.aqk/last-run.md`
+  // однажды закоммитили, и каждый прогон оставлял изменённый файл. `init` теперь кладёт их в
+  // .gitignore сам; здесь — для тех, кто поставил раньше. Спрашиваем git, а не диск.
+  const git = (...a) => spawnSync("git", a, { cwd: CWD, encoding: "utf8" });
+  if (git("rev-parse", "--git-dir").status === 0) {
+    const tracked = new Set(String(git("ls-files", "--", TARGET_DIR).stdout || "").split("\n"));
+    for (const f of RUNTIME_FILES.map((n) => `${TARGET_DIR}/${n}`)) {
+      if (tracked.has(f)) {
+        console.log(`\n  ${c.yellow("!")}  ${L.doctor.runtimeTracked(f, `git rm --cached ${f} && echo ${f} >> .gitignore`)}`);
+      } else if (await exists(join(CWD, f)) && git("check-ignore", "-q", f).status !== 0) {
+        console.log(c.dim(`\n  ${L.doctor.runtimeNotIgnored(f, `echo ${f} >> .gitignore`)}`));
+      }
+    }
   }
 
+  // СВОД, КОТОРОГО НЕ ВИДИТ 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";
@@ -260,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;
@@ -331,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")) {
@@ -343,21 +222,26 @@ 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");
   const gates = declaredGates(man);
   let gateFailed = 0;
   let failedNames = [];
+  let skippedNames = [];
   if (wantRun) {
-    const run = runGates(man, { since: sinceRef() });
+    // --jobs N: сколько гейтов одновременно. Без флага — по одному, как было: чужие гейты бывают
+    // зависимыми (общий dist/), и плавающее красное хуже медленного. Не число — отказ, а не тихий
+    // последовательный прогон под видом параллельного.
+    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, verbose });
     gateFailed = run.failed;
     failedNames = run.results.filter((r) => !r.ok).map((r) => r.name);
-    await writeRunReport({ version, reached, results: run.results });
+    skippedNames = run.skipped || [];
+    await writeRunReport({ version, reached, results: run.results, skipped: run.skipped });
 
     // ПРОБА ЗАПУСКАЕТСЯ САМА. Владелец сформулировал так: «команду, о которой надо вспомнить,
     // агент не вспомнит, а человек о ней не узнает». Это тот же класс, что файл, который можно
@@ -369,20 +253,7 @@ async function cmdDoctor() {
     // надо. В кратком режиме не запускается: там хук на воротах коммита, и лишние секунды там
     // стоят дороже. Не влияет на код возврата НИКОГДА — это осмотр, а не порог.
     // Выключается AQK_PROBE=0 — у всего, что случается само, обязан быть выключатель.
-    if (!brief && process.env.AQK_PROBE !== "0") {
-      try {
-        const st = await probeStatus();
-        if (st.badEvery !== undefined) {
-          console.log(c.yellow(`\n  ${L.probe.badEvery(st.badEvery)}`));
-        } else if (st.state === "never" || st.state === "stale") {
-          // Сообщение обязано быть верным в обоих случаях. Первая версия печатала «прошло сто
-          // коммитов» и там, где пробы не было ВОВСЕ: число бралось из порога, а не из факта.
-          // Мелочь, но того же класса, что и всё остальное здесь: вывод, который не врёт.
-          console.log(c.dim(`\n  ${st.state === "never" ? L.probe.autoFirst : L.probe.auto(st.behind)}`));
-          await cmdProbe([], { auto: true });
-        }
-      } catch { /* проба не состоялась — прогон это не роняет: он про гейты, а не про неё */ }
-    }
+    if (!brief && process.env.AQK_PROBE !== "0") await autoProbe(brief);
   } else if (gates.length) {
     console.log(
       c.yellow(`  ${L.doctor.declaredNotRun(gates.length)}`) +
@@ -417,6 +288,7 @@ async function cmdDoctor() {
   if (wantRun) {
     if (ok) {
       console.log(c.green(`  ${L.doctor.runVerdictOk}\n`));
+      if (skippedNames.length) console.log(c.yellow(`  ${L.doctor.selectSkipped(skippedNames.join(", "))}\n`));
     } else {
       const why = [];
       if (missing) why.push(L.doctor.whyMissing);