agent-quality-kit 0.11.0 → 0.13.0

package/tool/commands/context.mjs

@@ -23,8 +23,12 @@
 import { readFile, writeFile, mkdir } from "node:fs/promises";
 import { spawnSync } from "node:child_process";
 import { join } from "node:path";
-import { CWD, TARGET_DIR, SELF, c, exists, commandRows } from "../lib/core.mjs";
-import { readManifest, assessLevel } from "../lib/manifest.mjs";
+import { CWD, TARGET_DIR, SELF, c, exists, commandRows, preCommitHook } from "../lib/core.mjs";
+import { readManifest, assessLevel, coversOf } from "../lib/manifest.mjs";
+import { detectFacts, readCatalog } from "../lib/repo.mjs";
+import { catalogBuckets, startWith, blindAdvice } from "../lib/advice.mjs";
+import { proposeGates, readAdoptFiles } from "../lib/adopt.mjs";
+import { declaredGates } from "../lib/run.mjs";
 import { probeStatus } from "./probe.mjs";
 import { L } from "../i18n/index.mjs";
 
@@ -33,6 +37,23 @@ import { L } from "../i18n/index.mjs";
 const MAX_RED = 5;
 const MAX_RATCHETS = 3;
 
+// ЧТО ДЕЛАТЬ ДАЛЬШЕ — не больше трёх шагов, по убыванию того, насколько это ФАКТ о проекте:
+//   1. объявить проверки, которые у проекта уже есть: дешевле всего, и это его собственное;
+//   2. классы брака, которые проба подсадила в ЕГО файлы и ЕГО проверки не поймали;
+//   3. «начните с этих трёх» из каталога.
+// Класс, названный пробой, в третьем списке не повторяется: один шаг, а не два. Остаток —
+// числом: молчание о нём прочиталось бы как «больше делать нечего».
+function nextSteps({ init = false, adopt = [], blind = [], start = [] } = {}, max = 3) {
+  const all = [];
+  // Без манифеста `aqk add` отказывает — остальные шаги без этого невыполнимы.
+  if (init) all.push({ kind: "init" });
+  if (adopt.length) all.push({ kind: "adopt", gates: adopt });
+  for (const b of blind) all.push({ kind: "blind", ...b });
+  const seen = new Set(blind.map((b) => b.slug));
+  for (const st of start) if (!seen.has(st.slug)) all.push({ kind: "start", ...st });
+  return { steps: all.slice(0, max), rest: Math.max(0, all.length - max) };
+}
+
 // Чистая функция: на входе состояние, на выходе строки. Отделена от чтения диска намеренно —
 // это единственное место комплекта, чей текст читает машина, и проверять его надо не прогоном,
 // а перебором случаев, включая те, которых на нашем репозитории не бывает.
@@ -80,10 +101,28 @@ function contextBlock(state, T = L.context) {
     if (pr.state === "never") out.push(T.probeNever);
     else if (pr.state === "off") out.push(T.probeOff);
     else if (pr.state === "unknown") out.push(T.probeUnknown);
-    else if (pr.blind > 0) out.push(T.probeBlind(pr.blind, pr.state === "stale" ? pr.behind : 0));
+    // Имена — агенту они нужнее числа: «один класс» не говорит, какой файл трогать осторожно.
+    else if (pr.blind > 0) out.push(T.probeBlind(pr.blind, pr.state === "stale" ? pr.behind : 0,
+      (pr.classes || []).map((b) => `${b.slug} (${b.file})`).join(", ")));
     else out.push(T.probeClean(pr.state === "stale" ? pr.behind : 0));
   }
 
+  // ДАЛЬШЕ — то, что `doctor` знает, а агенту не говорилось: блок отвечал только «как дела».
+  // Шаги вычислены, а не пожелания: у каждого команда, которую можно выполнить сейчас.
+  const nx = state.next;
+  if (nx && nx.steps && nx.steps.length) {
+    out.push("", T.nextTitle);
+    nx.steps.forEach((st, i) => out.push(`${i + 1}. ${T.nextStep[st.kind](st)}`));
+    if (nx.rest) out.push(T.nextMore(nx.rest));
+  }
+
+  // КОГДА ЧТО — правила вида «ситуация → команда». Общий совет («тестируй изменения») агент
+  // пролистывает; проверяемый («перед коммитом — вот эта команда») выполняет. Первое правило
+  // зависит от факта: стоит хук — сказать не обходить его; нет — дать команду, само не случится.
+  if (state.when) {
+    out.push("", T.whenTitle, `- ${T.whenCommit(state.when.hook)}`, ...T.whenRules.map((r) => `- ${r}`));
+  }
+
   // ПОЛНЫЙ БЛОК — решение владельца от 2026-09-08, принятое ПОСЛЕ возражения и вопреки ему.
   // Возражение было такое: вход, растущий в длину, роняет качество у всех проверенных моделей,
   // и свод, влитый целиком, даёт правило, которое в контексте есть и не выполняется. Ответ
@@ -291,9 +330,25 @@ async function cmdContext(args = []) {
     fullPart = { entry, rows, text };
   }
 
+  // ДАЛЬШЕ — теми же функциями, что у `doctor`: корзины каталога, «начните с трёх», совет под
+  // язык, чужие проверки проекта. Второй расчёт того же самого разошёлся бы с первым.
+  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 }));
+    next = nextSteps({ init: !man, adopt, blind, start });
+  } catch { /* не посчитали — блок скажет остальное; выдумывать шаги нельзя */ }
+
   console.log(contextBlock({
     entry, entryExists: rules !== null, level, rules, run, ratchets, probe, full: fullPart,
+    next, when: { hook: await preCommitHook(CWD) },
   }).join("\n"));
 }
 
-export { cmdContext, contextBlock, parseLastRun, countArbiters, withHook, hasOurHook, portableSelf };
+export { cmdContext, contextBlock, nextSteps, parseLastRun, countArbiters, withHook, hasOurHook, portableSelf };

package/tool/commands/doctor.mjs

@@ -4,16 +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 { 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 } from "../lib/repo.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 } from "../lib/run.mjs";
+import { declaredGates, sinceRef, runGates, progress, listArg } from "../lib/run.mjs";
+import { autoProbeAllowed } from "../lib/cadence.mjs";
 
 // Обязательный минимум проекта — прогоном, а не по памяти. До сих пор это было единственное
 // место, где комплект просил верить на слово, что человек прочитал методичку и сверился.
@@ -50,7 +53,7 @@ async function reportBaseline(man, facts) {
   );
 }
 
-async function reportCatalog(man, facts) {
+async function reportCatalog(man, facts, probe = null) {
   const catalog = await readCatalog();
   if (!catalog.length) return;
 
@@ -58,14 +61,7 @@ async function reportCatalog(man, facts) {
   // Пока их считали вместе, вывод каждый прогон называл долгом то, что уже держит 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"]
@@ -77,10 +73,81 @@ async function reportCatalog(man, facts) {
   );
 
   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}`)}`));
+  // ЧТО У ВАС УЖЕ ЕСТЬ — до итога и до списка крестов. Комплект, поставленный в проект с
+  // 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)}`));
@@ -93,14 +160,36 @@ async function reportCatalog(man, facts) {
   // Заявка «эту запись держит наш линтер» сверяется с кодами правил из рецепта записи.
   // Замерено на живом 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}`)}`));
+  // Конфиги — ПО ЛИНТЕРАМ, а не одной склейкой: заявка сверяется правилами того линтера,
+  // которым закрыт гейт (отзыв с живого проекта 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)}`));
+    }
   }
   // Не вердикт, а совет: отсутствие браузерного сервера — незанятая возможность, а не дефект.
   // Поэтому строка тусклая и без значка, и её нет у проекта без интерфейса.
@@ -131,7 +220,7 @@ async function reportCatalog(man, facts) {
 // сессии и для самого владельца: список объявленных гейтов молчит о том, сколько из них
 // действительно стоят и работают именно СЕЙЧАС. Перезаписывается каждым прогоном, не копится:
 // история — дело 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 = [
@@ -140,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);
@@ -149,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;
@@ -171,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`)}`));
+      }
+    }
   }
 
   // Команды в точке входа заполнены или остались пустыми заготовками? Файл берётся тот же,
@@ -227,7 +351,11 @@ async function cmdDoctor() {
   // Доказательство считается только при прогоне: узнать, ловит ли гейт брак, нельзя иначе как
   // запустив его по образцу. Без прогона ступени со второй помечаются «не доказано» — это
   // честнее, чем показывать их выполненными по наличию папок.
+  // Доказательство — секунды тишины до первой строки уровня; строка «идёт» их называет.
+  const bar = progress();
+  if (process.argv.includes("--run")) bar.show(c.dim(`  ⋯  ${L.doctor.proving}`));
   const proof = process.argv.includes("--run") ? await proveGates(man) : null;
+  bar.clear();
   const { reached, steps } = await assessLevel(man, proof);
 
   console.log(c.bold(`\n  ${L.doctor.levelHeading}\n`));
@@ -274,18 +402,29 @@ async function cmdDoctor() {
     await reportBaseline(man, facts);
     process.exit(0);
   }
-  const cat = (await reportCatalog(man, facts)) || { held: 0, todo: 0, todoRecs: [] };
+  // Состояние пробы — из файла отметки, миллисекунды. Нет его — блок про пробу просто молчит.
+  let probe = null;
+  try { probe = await probeStatus(); } catch { /* пробы нет — и ладно */ }
+  const cat = (await reportCatalog(man, facts, probe)) || { 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 });
     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 });
 
     // ПРОБА ЗАПУСКАЕТСЯ САМА. Владелец сформулировал так: «команду, о которой надо вспомнить,
     // агент не вспомнит, а человек о ней не узнает». Это тот же класс, что файл, который можно
@@ -297,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)}`) +
@@ -345,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/gates.mjs

@@ -15,6 +15,7 @@ import {
 } from "../lib/repo.mjs";
 import { GATE_YML_TEMPLATE, CHECK_SH_TEMPLATE, README_TEMPLATE } from "../lib/templates.mjs";
 import { L } from "../i18n/index.mjs";
+import { gateCommand } from "../lib/execution.mjs";
 
 // Ставит гейт из каталога в проект. Проверка КОПИРУЕТСЯ в репозиторий, а не остаётся
 // ссылкой в пакет: при установке через npx пакет временный, и завтра команда в манифесте
@@ -230,7 +231,7 @@ async function cmdRatchet(args) {
 
   // Снимок текущих нарушений — это и есть долг. Ключ без номера строки: правка соседней
   // строки не должна читаться как новое нарушение.
-  const r = spawnSync(inner, { shell: true, cwd: CWD, encoding: "utf8", timeout: 300000 });
+  const r = spawnSync(gateCommand(inner), { shell: true, cwd: CWD, encoding: "utf8", timeout: 300000 });
   if (r.status === 127 || (r.error && r.error.code === "ENOENT")) {
     die(L.ratchet.notRunnable(slug, inner));
   }
@@ -438,7 +439,7 @@ async function cmdWhy(args) {
 
   // --- 3. объявлен: спрашиваем у него самого ---------------------------------
   console.log(c.dim(`  ${L.why.declaredAs(cmd)}`));
-  const r = spawnSync(String(cmd), { shell: true, cwd: CWD, encoding: "utf8", timeout: 300000 });
+  const r = spawnSync(gateCommand(String(cmd)), { shell: true, cwd: CWD, encoding: "utf8", timeout: 300000 });
   const ci = await runsInCi(slug, String(cmd));
 
   if (r.status === 127 || (r.error && r.error.code === "ENOENT")) {