agent-quality-kit 0.12.0 → 0.13.0

package/tool/commands/doctor.mjs

@@ -4,17 +4,19 @@ 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 { 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 { 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 { 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 { 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";
+import { declaredGates, sinceRef, runGates, progress, listArg } from "../lib/run.mjs";
+import { autoProbeAllowed } from "../lib/cadence.mjs";
 
 // Обязательный минимум проекта — прогоном, а не по памяти. До сих пор это было единственное
 // место, где комплект просил верить на слово, что человек прочитал методичку и сверился.
@@ -59,14 +61,7 @@ async function reportCatalog(man, facts, probe = null) {
   // Пока их считали вместе, вывод каждый прогон называл долгом то, что уже держит 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);
-  }
+  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"]
@@ -78,58 +73,13 @@ async function reportCatalog(man, facts, probe = null) {
   );
 
   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);
+    const found = proposeGates(await readAdoptFiles(CWD));
     if (found.length) {
       console.log(`\n  ${c.bold(L.doctor.haveAlready(found.length))}`);
       for (const g of found) {
@@ -167,8 +117,8 @@ async function reportCatalog(man, facts, probe = null) {
   // С ЧЕГО НАЧАТЬ. Двадцать одинаковых крестов — это ноль требований: закрывают первое
   // попавшееся или не закрывают ничего. Порядок не по нашему вкусу: сперва то, что родилось из
   // настоящего отказа И закрывается одной готовой командой.
-  if (todo.length > 3) {
-    const first = startWith(todo, facts, 3);
+  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, {});
@@ -182,6 +132,80 @@ async function reportCatalog(man, facts, probe = null) {
     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)}, ` : "") +
@@ -196,7 +220,7 @@ async function reportCatalog(man, facts, probe = null) {
 // сессии и для самого владельца: список объявленных гейтов молчит о том, сколько из них
 // действительно стоят и работают именно СЕЙЧАС. Перезаписывается каждым прогоном, не копится:
 // история — дело 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 +229,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,6 +241,22 @@ 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");
   const buf = brief ? beginBrief() : null;
@@ -236,10 +279,26 @@ 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`)}`));
+      }
+    }
   }
 
   // Команды в точке входа заполнены или остались пустыми заготовками? Файл берётся тот же,
@@ -353,11 +412,19 @@ async function cmdDoctor() {
   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 });
     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 +436,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 +471,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);

package/tool/commands/probe.mjs

@@ -26,8 +26,9 @@ import { readFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join, dirname, extname } from "node:path";
 import { readManifest } from "../lib/manifest.mjs";
-import { fixHotspots, probeSummary, probeVerdictPaired, countProbe } from "../lib/history.mjs";
+import { fixHotspots, probeSummary, probeVerdictPaired, countProbe, namesPlant, catchVerdict } from "../lib/history.mjs";
 import { detectFacts, readCatalog, triggerVerdict } from "../lib/repo.mjs";
+import { blindAdvice } from "../lib/advice.mjs";
 import { CWD, GATES_SRC, TARGET_DIR, c, SELF, exists } from "../lib/core.mjs";
 import { probeState, probeEvery, PROBE_EVERY, blindLines, parseBlind, parseRan } from "../lib/cadence.mjs";
 import { L } from "../i18n/index.mjs";
@@ -95,7 +96,7 @@ async function writeMark(now, blind, lines) {
     "",
     ...lines,
     "",
-    "Файл эфемерный: его переписывает каждая проба. В .gitignore его стоит держать самому.",
+    "Файл эфемерный: его переписывает каждая проба. `aqk init` кладёт его в .gitignore.",
   ].join("\n");
   await writeFile(MARK(), body + "\n", "utf8");
 }
@@ -156,58 +157,11 @@ function sampleLines(path, max = 4) {
     .map((l) => l.slice(0, 88));
 }
 
-// Совет по НЕПОКРЫТОМУ классу: команда, которую можно вставить прямо сейчас.
-//
-// Проба находит настоящие дыры и печатала про них «close it: aqk add <имя>» — то есть «поставь
-// нашу штуку». Человек, впервые увидевший комплект, закрывает окно. А готовая однострочная
-// команда под его стек У НАС УЖЕ ЛЕЖИТ в `recipes` записи каталога; мы её не показывали.
-//
-// Замер руками на `requests` (самый скачиваемый python-пакет) 2026-09-10: в
-// `src/requests/utils.py` — 75 коммитов-починок; дописана функция с `except Exception: pass`;
-// их собственные `ruff` и `pytest` дали 0 и на чистой копии, и на подсаженной. Строка, которая
-// поймала бы это, лежала в нашем каталоге всё это время.
-//
-// Переносимый рецепт (`any`) в совет НЕ идёт: он зовёт файл из комплекта, и человеку без
-// комплекта вставить его некуда. Нет родного рецепта под стек — команды нет, и это честнее
-// выдуманной.
-function blindAdvice(entry, facts, hot = {}) {
-  const recipes = entry?.recipes && typeof entry.recipes === "object" ? entry.recipes : {};
-  // `langs` приходит МНОЖЕСТВОМ, а не массивом — `Array.isArray` тихо давал пустой список, и
-  // совет не печатался вовсе. Поймано на живом `requests`: langs = Set(1) { python }.
-  const langs = facts?.langs ? [...facts.langs] : [];
-  // Тот же порядок, что у `pickRecipe`: свой язык → безъязыковой родной → ничего. Переносимый
-  // (`any`) сюда не идёт никогда: он зовёт файл из комплекта, и человеку без комплекта вставить
-  // его некуда.
-  let cmd = null;
-  for (const key of [...langs, "native"]) {
-    const r = recipes[key];
-    if (!r || /\{gate\}/.test(r)) continue;
-    cmd = String(r).replace(/\{dir\}/g, ".")
-      // Вычистить то, что относится к НАМ, а не к его проекту. Исключение наших красных
-      // образцов нужно УСТАНОВЛЕННОМУ гейту — рядом с ним лежат образцы. Человеку, который
-      // команду только копирует, этих каталогов не существует, и флаги про них подрывают
-      // доверие: инструмент говорит про чужое хозяйство вместо его кода.
-      .replace(/\s--ignore-pattern\s+'[^']*gates\/[^']*'/g, "")
-      .replace(/\s--ignore-paths=?\s*'[^']*gates\/[^']*'/g, "")
-      .replace(/\s+/g, " ")
-      .trim();
-    break;
-  }
-  // Адрес — того инструмента, которым команда начинается: поле `tool` общее на все языки, и
-  // python-проекту показывалась ссылка на eslint. Первые три слова, а не одно: `npx knip`,
-  // `python -m vulture`. Не совпало — весь список: лишняя ссылка лучше, чем ни одной.
-  const urls = entry?.tool ? String(entry.tool).split(/\s+·\s+/) : [];
-  const head = cmd ? cmd.split(" ").slice(0, 3) : [];
-  const own = urls.find((u) => head.includes(u.replace(/\/+$/, "").split("/").pop()));
-  const tool = own ?? (entry?.tool ? String(entry.tool) : null);
-  return { command: cmd, tool, file: hot.file ?? null, fixes: hot.fixes ?? null, slug: entry?.slug ?? null };
-}
-
 // Красный образец записи, подходящий по расширению горячего файла. Расширение обязано
 // совпадать: питоновский образец в проекте на TypeScript не проверит ничего, а покажет
 // «не прикрыто» — ложная тревога того же класса, что молчащий гейт, только наоборот.
-async function redSampleFor(entry, ext) {
-  const dir = join(GATES_SRC, entry, "red");
+async function sampleFor(entry, ext, kind = "red") {
+  const dir = join(GATES_SRC, entry, kind);
   if (!(await exists(dir))) return null;
   let names = [];
   try { names = await readdir(dir); } catch { return null; }
@@ -226,7 +180,8 @@ async function redSampleFor(entry, ext) {
 //
 // Способ взят из мутационного тестирования, где та же задача решена двадцать лет назад: Stryker
 // копирует проект во временный каталог, СИМЛИНКУЕТ `node_modules` и гоняет там родную команду.
-// Копируются только ОТСЛЕЖИВАЕМЫЕ файлы (`git archive HEAD`) — рабочее дерево не трогается, а
+// Копируются отслеживаемые и неигнорируемые файлы (`git ls-files --cached --others
+// --exclude-standard`) — файлы проекта не меняются (итог пишется в .aqk/last-probe.md), а
 // мусор сборки не тащится; тяжёлые каталоги зависимостей симлинкуются, иначе `npm test` в
 // песочнице падал бы с «модуль не найден», и это читалось бы как сбой инструмента.
 const DEP_DIRS = ["node_modules", ".venv", "venv", "vendor", "target", ".tox", ".bundle"];
@@ -284,20 +239,44 @@ async function plant(root, relPath, sample) {
 // Гейт запускается В ПЕСОЧНИЦЕ и командой КАК ЕСТЬ — ничего в неё не подставляется. Именно это
 // и делает пробу независимой от формы команды.
 //
-// `stopOnRed` — ранний выход: как только гейт покраснел, вердикт «поймано» уже получен, и гонять
-// остальные незачем. На сухом прогоне выхода нет: там нужны ВСЕ длительности и все коды.
-function runGates(gates, sandbox, { stopOnRed = false } = {}) {
+// Вывод гейта сохраняется: по нему видно, ИЗ-ЗА ЧЕГО он покраснел (см. catchVerdict).
+function runGates(gates, sandbox) {
   const out = [];
   for (const [name, cmd] of gates) {
     const t0 = Date.now();
     const r = spawnSync(gateCommand(cmd), { shell: true, cwd: sandbox, encoding: "utf8", timeout: 120000 });
     const code = r.status === null ? 2 : r.status;
-    out.push({ name, code, ms: Date.now() - t0 });
-    if (stopOnRed && code === 1) break;
+    out.push({ name, code, ms: Date.now() - t0, out: `${r.stdout || ""}${r.stderr || ""}`.slice(0, 200000) });
   }
   return out;
 }
 
+// Один класс брака на одном файле: гейты по одному, в порядке плана. Покраснел и назвал файл —
+// контроль ЗЕЛЁНЫМ образцом той же записи в том же месте (catchVerdict). Ранний выход — только на
+// ПОДТВЕРЖДЁННОЙ поимке: первым мог покраснеть форматтер, и остановка на нём скрыла бы линтер,
+// который брак действительно поймал.
+async function probeOne({ sandbox, rel, red, green, gates, baseOut }) {
+  const after = [];
+  let restore = await plant(sandbox, rel, red);
+  try {
+    for (const g of gates) {
+      const [res] = runGates([g], sandbox);
+      after.push(res);
+      if (res.code !== 1) continue;
+      let ctl = null;
+      if (green && namesPlant(baseOut(res.name), res.out, rel)) {
+        await restore(); restore = await plant(sandbox, rel, green);
+        [ctl] = runGates([g], sandbox);
+        await restore(); restore = await plant(sandbox, rel, red);
+      }
+      res.why = catchVerdict(baseOut(res.name), res, ctl, rel);
+      res.named = res.why === "caught";
+      if (res.named) break;
+    }
+  } finally { await restore(); }
+  return after;
+}
+
 // Каким гейтом пробовать и в каком порядке.
 //
 // Цена пробы = (файлы × записи) × сумма длительностей гейтов. На самом комплекте после перехода
@@ -368,7 +347,8 @@ async function cmdProbe(args, { auto = false } = {}) {
   // Пробуем только запланированными, в порядке плана.
   const byName = new Map(gates);
   const probeGates = plan.use.map((g) => [g.name, byName.get(g.name)]);
-  const baseline = plan.use.map((g) => ({ name: g.name, code: g.code }));
+  const baseline = plan.use.map((g) => ({ name: g.name, code: g.code, out: g.out }));
+  const baseOut = (name) => baseline.find((b) => b.name === name)?.out || "";
 
   console.log(c.dim(`  ${P.method(hot.length, entries.length, plan.use.length)}\n`));
   if (plan.tooSlow.length) {
@@ -385,20 +365,20 @@ async function cmdProbe(args, { auto = false } = {}) {
     let probed = 0;
 
     for (const e of entries) {
-      const sample = await redSampleFor(e.slug, ext);
+      const sample = await sampleFor(e.slug, ext, "red");
       if (!sample) continue;
       probed++;
-      const restore = await plant(sandbox, rel, sample);
-      let after;
-      try { after = runGates(probeGates, sandbox, { stopOnRed: true }); } finally { await restore(); }
+      const green = await sampleFor(e.slug, ext, "green");
+      const after = await probeOne({ sandbox, rel, red: sample, green, gates: probeGates, baseOut });
       // Ранний выход обрывает список: гейты, до которых не дошли, считаются такими же, как на
       // сухом прогоне. Иначе их отсутствие прочиталось бы как сбой запуска.
       const seen = new Set(after.map((a) => a.name));
       const full = after.concat(baseline.filter((b) => !seen.has(b.name)));
       const r = probeVerdictPaired(baseline, full);
       const verdict = r.verdict;
-      const caught = full.filter((a) => a.code === 1 && baseline.find((b) => b.name === a.name)?.code === 0)
-        .map((a) => a.name);
+      const redNow = full.filter((a) => a.code === 1 && baseline.find((b) => b.name === a.name)?.code === 0);
+      const caught = redNow.filter((a) => a.named !== false).map((a) => a.name);
+      const nameless = redNow.filter((a) => a.named === false).map((a) => `${a.name} (${a.why === "planting" ? P.planting : P.nameless})`);
       records.push({ entry: e.slug, file: rel, verdict });
       if (verdict === "caught") {
         console.log(`    ${c.green("✔")}  ${e.intent.padEnd(48)} ${c.dim(P.caught(caught.join(", ")))}`);
@@ -419,7 +399,7 @@ async function cmdProbe(args, { auto = false } = {}) {
         if (adv.tool) console.log(c.dim(`         ${P.blindTool(adv.tool)}`));
         console.log(c.dim(`         ${P.install(`${SELF} add ${e.slug}`)}`));
       } else {
-        console.log(`    ${c.dim("~")}  ${c.dim(e.intent.padEnd(48))} ${c.dim(P.unknown)}`);
+        console.log(`    ${c.dim("~")}  ${c.dim(e.intent.padEnd(48))} ${c.dim(nameless.length ? P.unattributed(nameless.join(", ")) : P.unknown)}`);
       }
     }
     if (!probed) { unprobedN++; console.log(c.dim(`    ${P.noSampleFor(ext || "—")}`)); }
@@ -465,4 +445,4 @@ async function probeStatus() {
   return { ...probeState(mark, commitCount(), every), classes: parseBlind(mark?.text), ran: parseRan(mark?.text) };
 }
 
-export { cmdProbe, probeStatus, probeableGates, gatesState, extAlternatives, planProbeGates, blindAdvice, isCode };
+export { cmdProbe, probeStatus, probeableGates, gatesState, extAlternatives, planProbeGates, isCode };

package/tool/commands/project.mjs

@@ -6,7 +6,7 @@ import { spawnSync } from "node:child_process";
 import { join, dirname, relative } from "node:path";
 import {
   CWD, PKG_ROOT, DOCS_SRC, RULES_SRC, TARGET_DIR, MANIFEST, SELF, REPO_URL, c, exists, die,
-  copyDir, writeIfAbsent, FEEDBACK_MARK, docPath } from "../lib/core.mjs";
+  copyDir, writeIfAbsent, FEEDBACK_MARK, docPath, ensureIgnored } from "../lib/core.mjs";
 import { AGENTS_MD, CLAUDE_MD, MANIFEST_YML } from "../lib/templates.mjs";
 import { banner } from "../lib/banner.mjs";
 import { readManifest } from "../lib/manifest.mjs";
@@ -41,6 +41,10 @@ async function cmdInit(args) {
   const claude = join(CWD, "CLAUDE.md");
   track(await writeIfAbsent(claude, CLAUDE_MD, { force }), claude);
 
+  // Служебные файлы — в .gitignore сразу, до первого прогона: иначе первый же `doctor --run`
+  // оставит в дереве файл, который попадёт в коммит (так и случилось на живом проекте).
+  const ignored = await ensureIgnored(CWD);
+
   // Заставка в начале init — первая встреча человека с комплектом. Второй раз он увидит её
   // только если сам спросит `--version`: то, что видишь тридцатый раз, перестаёт читаться.
   console.log(`\n${banner()}\n`);
@@ -56,6 +60,7 @@ async function cmdInit(args) {
   if (LANG === "en" && created.some((f) => f.includes(`${TARGET_DIR}/docs/`) || f.includes(`${TARGET_DIR}\\docs\\`))) {
     console.log(c.dim(`\n  ${L.init.docsRu}`));
   }
+  if (ignored.length) console.log(c.dim(`\n  ${L.init.ignored(ignored.join(", "))}`));
   if (skipped.length) {
     console.log(c.yellow(`\n  ${L.init.kept(skipped.length)}`));
     for (const f of skipped) console.log(`    ${f}`);

package/tool/commands/report.mjs

@@ -86,7 +86,7 @@ async function cmdReport() {
 
   // Прогон, а не чтение манифеста: «объявлен» и «работает» — разные утверждения, и весь
   // смысл этой команды в том, чтобы в отчёт попало второе.
-  const run = declared.length ? runGates(man) : { results: [], failed: 0 };
+  const run = declared.length ? await runGates(man) : { results: [], failed: 0 };
 
   const held = [], broken = [], todo = [], skip = [];
   for (const res of run.results) {

package/tool/commands/vitals.mjs

@@ -16,9 +16,10 @@
 // сознательное решение: pre-commit локально мы не ставим, проверки идут в CI. Команда, которая
 // кричит «сломано» про выбор, — ровно та, которую выключают в первый день, и вместе с ней
 // перестают читать настоящие отказы. Кода возврата касается только `✘`.
+import { spawnSync } from "node:child_process";
 import { readFile } from "node:fs/promises";
 import { join } from "node:path";
-import { CWD, MANIFEST, SELF, c, exists } from "../lib/core.mjs";
+import { CWD, MANIFEST, SELF, c, exists, preCommitHook } from "../lib/core.mjs";
 import { readManifest, unparsedLines, gateRequires } from "../lib/manifest.mjs";
 import { whichSync } from "../lib/repo.mjs";
 import { gitBash } from "../lib/execution.mjs";
@@ -122,14 +123,7 @@ async function cmdVitals() {
   // Хук pre-commit проверяется в `.git/hooks`, а НЕ в `.pre-commit-config.yaml`. Запись в
   // конфиге — это намерение; сработает только то, что лежит в самом гите. Ровно та разница,
   // ради которой весь комплект: объявлено и работает — разные утверждения.
-  let preCommit = null;
-  const hook = join(CWD, ".git", "hooks", "pre-commit");
-  if (await exists(join(CWD, ".git"))) {
-    preCommit = false;
-    if (await exists(hook)) {
-      try { preCommit = /pre-commit|aqk/i.test(await readFile(hook, "utf8")); } catch { preCommit = null; }
-    }
-  }
+  const preCommit = await preCommitHook(CWD);
 
   let sessionHook = null;
   const settings = join(CWD, ".claude", "settings.json");
@@ -145,15 +139,25 @@ async function cmdVitals() {
 
   let version = null;
   if (updateWanted()) {
+    let current = "";
     try {
       const { PKG_ROOT } = await import("../lib/core.mjs");
-      const current = JSON.parse(await readFile(join(PKG_ROOT, "package.json"), "utf8")).version || "";
+      current = JSON.parse(await readFile(join(PKG_ROOT, "package.json"), "utf8")).version || "";
       const r = await fetch("https://registry.npmjs.org/agent-quality-kit/latest", {
         signal: AbortSignal.timeout(3000),
         headers: { accept: "application/vnd.npm.install-v1+json" },
       });
       version = { current, latest: r.ok ? String((await r.json()).version || "") : "" };
-    } catch { /* сети нет — строку про версию просто не покажем */ }
+    } catch { /* прямой запрос не прошёл — ниже спросим npm */ }
+    // ПРЯМОЙ ЗАПРОС НЕ ПРОШЁЛ — СПРОСИТЬ NPM. Отзыв с живого проекта 2026-09-11: vitals писал «не
+    // достучался до реестра», а `npm view` на той же машине работал. `fetch` в Node не знает
+    // прокси и зеркала из .npmrc, а npm знает. Только здесь, не в хуке: там секунды дороже.
+    if (current && !version?.latest) {
+      const r = spawnSync("npm", ["view", "agent-quality-kit", "version"],
+        { encoding: "utf8", timeout: 10000, shell: process.platform === "win32" });
+      const latest = r.status === 0 ? String(r.stdout || "").trim().split("\n").pop() : "";
+      version = { current, latest };
+    }
   }
 
   const rows = vitalsRows({ tools: [...seen.values()], unparsed, preCommit, sessionHook, version });