agent-quality-kit 0.14.0 → 0.16.0

package/kit/gates/hook-actually-fires/check.sh

@@ -1,6 +1,12 @@
 #!/usr/bin/env sh
-# Хук, который не сработает никогда: имя события с опечаткой, либо `matcher` на событии,
-# которое его не поддерживает.
+# Хук, который не сработает никогда: имя события с опечаткой, `matcher` на событии, которое его
+# не поддерживает, либо команда, указывающая на файл, которого нет.
+#
+# ТРЕТИЙ КЛАСС ДОБАВЛЕН 2026-09-14, И НАШЁЛ ЕГО ЧУЖОЙ ИНСТРУМЕНТ. `agnix`, прогнанный по нашему
+# же репозиторию, сказал «Script file not found» о ШЕСТИ хуках в нашем ЗЕЛЁНОМ образце: гейт с
+# именем `hook-actually-fires` говорил «чисто» о настройке, где ни один хук сработать не мог.
+# Это второй раз за неделю, когда соседский инструмент находит у нас то, чего не видят наши же
+# проверки, — и ровно тот класс, ради которого написан весь комплект.
 #
 # ЗАЧЕМ. Человек заводит хук, чтобы машина держала то, что он держать не может: не дать
 # сделать force-push, отформатировать после правки, не отпустить работу с красным линтером.
@@ -117,6 +123,10 @@ for F in "$DIR/.claude/settings.json" "$DIR/.claude/settings.local.json" \
             # означают «всё» — ровно то, что и происходит на событии без поддержки matcher, то
             # есть автор не обманут. Замер по 39 чужим настройкам: без этого сужения гейт краснел
             # на четырёх, и все четыре были «matcher»: "" либо "*", то есть шум.
+            if (awaitCmd) {
+              awaitCmd = 0
+              printf "@CMD@%d@%s\n", cmdLine, pending
+            }
             if (awaitMatcher) {
               awaitMatcher = 0
               if (pending != "" && pending != "*" && pending != ".*")
@@ -130,6 +140,9 @@ for F in "$DIR/.claude/settings.json" "$DIR/.claude/settings.local.json" \
         if (c == ":") {
           key = pending; keyLine = pendingLine
           if (ev != "" && key == "matcher" && (ev in NOMATCHER)) { awaitMatcher = 1; matcherLine = keyLine; matcherEv = ev }
+          # Команда хука. Существование файла проверяет ОБОЛОЧКА, а не awk: у awk нет способа
+          # спросить файловую систему, не вызывая внешний процесс на каждую строку.
+          if (key == "command") { awaitCmd = 1; cmdLine = keyLine }
           continue
         }
         # ЛЮБОЙ структурный символ снимает ожидание значения matcher. Без этого нестроковое
@@ -137,7 +150,7 @@ for F in "$DIR/.claude/settings.json" "$DIR/.claude/settings.local.json" \
         # следующая строка документа — обычно ключ «hooks» — печаталась как значение matcher.
         # Найдено код-ревью 2026-09-07.
         if (c == "{" || c == "[") {
-          awaitMatcher = 0
+          awaitMatcher = 0; awaitCmd = 0
           depth++
           if (c == "{" && rootIsHooks == 1 && depth == 1 && hooksDepth == -1) hooksDepth = 1
           else if (c == "{" && key == "hooks" && hooksDepth == -1) hooksDepth = depth
@@ -145,12 +158,12 @@ for F in "$DIR/.claude/settings.json" "$DIR/.claude/settings.local.json" \
           key = ""; continue
         }
         if (c == "}" || c == "]") {
-          awaitMatcher = 0
+          awaitMatcher = 0; awaitCmd = 0
           if (depth == evDepth) { ev = ""; evDepth = -1 }
           if (depth == hooksDepth) hooksDepth = -1
           depth--; key = ""; continue
         }
-        if (c == ",") { awaitMatcher = 0; key = ""; continue }
+        if (c == ",") { awaitMatcher = 0; awaitCmd = 0; key = ""; continue }
       }
     }
   ' "$F" 2>/tmp/.hookerr.$$)
@@ -160,6 +173,52 @@ for F in "$DIR/.claude/settings.json" "$DIR/.claude/settings.local.json" \
   # Разделяем их кодом возврата: «не смогли разобрать» — это 2, а не молчаливый ноль.
   if [ "$CODE" -ne 0 ] || [ -n "$E" ]; then
     ERR="$ERR$F: разобрать не удалось${E:+ — }$E
+"
+  fi
+  # КОМАНДЫ ХУКОВ — отдельной дорожкой: awk отдал их помеченными строками, файловую систему
+  # спрашивает оболочка.
+  #
+  # ГРАНИЦА НАМЕРЕННО УЗКАЯ. Красим только ОТНОСИТЕЛЬНЫЙ путь со слэшем: `.claude/hooks/x.sh`,
+  # `scripts/guard.sh`. Программа из PATH (`npx`, `prettier`, `bash -c …`) нам не видна — у неё
+  # нет пути, и «не нашли» означало бы обвинение по догадке. Абсолютный путь пропускаем: он
+  # относится к чужой машине, а не к репозиторию. Из двух ошибок здесь выбирается молчание:
+  # ложное обвинение выключает гейт целиком.
+  CMDS=$(printf '%s\n' "$RES" | grep '^@CMD@' || true)
+  RES=$(printf '%s\n' "$RES" | grep -v '^@CMD@' || true)
+  if [ -n "$CMDS" ]; then
+    MISS=$(printf '%s\n' "$CMDS" | while IFS= read -r L; do
+      [ -z "$L" ] && continue
+      LN=$(printf '%s' "$L" | cut -d@ -f3)
+      CMD=$(printf '%s' "$L" | cut -d@ -f4-)
+      # Переменная окружения, которой Claude Code называет корень проекта, — это и есть DIR.
+      CMD=$(printf '%s' "$CMD" | sed 's|\${CLAUDE_PROJECT_DIR}/*||g; s|\$CLAUDE_PROJECT_DIR/*||g')
+      # КАВЫЧКИ СНИМАЮТСЯ ПОСЛЕ ПЕРЕМЕННОЙ И ДО РАЗБОРА НА СЛОВА. Найдено замером 2026-09-15 по
+      # `kupzed/catatz`: у них `node "$CLAUDE_PROJECT_DIR/.claude/hooks/adapter.mjs"` — путь
+      # лежит ВНУТРИ кавычек вместе с переменной. Переменную мы снимали, кавычки оставались, и
+      # файл искался по имени с кавычками. Пять «пропавших» хуков, и все пять на месте (200).
+      # Письмо по такой находке было бы неправдой — а писать мы собирались именно по ним.
+      CMD=$(printf '%s' "$CMD" | tr -d '"'"'"'"')
+      # Первое слово — программа. Если это запускалка, файл стоит вторым.
+      P=$(printf '%s' "$CMD" | awk "{print \$1}")
+      case "$P" in
+        bash|sh|node|python|python3|ruby|perl|deno|bun) P=$(printf '%s' "$CMD" | awk "{print \$2}") ;;
+      esac
+      case "$P" in
+        # ПЕРЕМЕННАЯ, КОТОРУЮ МЫ НЕ РАСКРЫВАЕМ, — повод молчать. Замер 2026-09-15 по
+        # `Aurealibe/claude-config`: `${CLAUDE_PLUGIN_ROOT:-.}/.claude/hooks/session-start`.
+        # Значение задаётся снаружи, проверить путь на диске нельзя, и объявить его пропавшим
+        # значит обвинить по догадке. CLAUDE_PROJECT_DIR — исключение: он и есть корень, и
+        # снимается выше.
+        *'$'*) continue ;;
+        # ДОМАШНИЙ КАТАЛОГ — НЕ РЕПОЗИТОРИЙ. Найдено 2026-09-15 на `Dynokostya/just-works`:
+        # `bash ~/.claude/statusline-command.sh` — хук пользовательского уровня, он живёт у
+        # человека, а не в проекте. Проверить его на диске проекта нельзя.
+        '~'*) continue ;;
+        ""|-*|/*) continue ;;
+        */*) [ -e "$DIR/$P" ] || printf "%s:%s: команда хука указывает на «%s» — такого файла в проекте нет, хук не сработает никогда\n" "$F" "$LN" "$P" ;;
+      esac
+    done)
+    [ -n "$MISS" ] && OUT="$OUT$MISS
 "
   fi
   [ -n "$RES" ] && OUT="$OUT$RES
@@ -178,6 +237,7 @@ fi
 ALL=$(printf '%s' "$OUT" | grep -v '^$')
 [ -z "$ALL" ] && exit 0
 printf '%s\n' "$ALL"
-echo "  почини: сверь имя события с https://code.claude.com/docs/en/hooks и убери matcher там, где его нет."
+echo "  почини: сверь имя события с https://code.claude.com/docs/en/hooks, убери matcher там, где его нет,"
+echo "  и верни на место файл, на который указывает команда, — либо убери сам хук."
 echo "  хук с неверным именем не вызывается и об этом не сообщается — защита существует только на бумаге."
 exit 1

package/kit/gates/hook-actually-fires/gate.yml

@@ -1,5 +1,5 @@
-intent: хук агента правда срабатывает — имя события известно, matcher не игнорируется молча
-intent_en: an agent hook actually fires — the event name is real and the matcher is not silently ignored
+intent: хук агента правда срабатывает — имя события известно, matcher не игнорируется молча, файл команды существует
+intent_en: an agent hook actually fires — the event name is real, the matcher is not silently ignored, and the command's file exists
 
 # Только там, где агента настраивали. В проекте без `.claude/settings.json` проверять нечего,
 # а запись, показанная не тому, стоит доверия всему каталогу.

package/kit/gates/hook-actually-fires/green/.claude/hooks/auto-format.sh

@@ -0,0 +1,3 @@
+#!/usr/bin/env sh
+# Образец: хук, который существует и потому может сработать.
+exit 0

package/kit/gates/hook-actually-fires/green/.claude/hooks/block-dangerous.sh

@@ -0,0 +1,3 @@
+#!/usr/bin/env sh
+# Образец: хук, который существует и потому может сработать.
+exit 0

package/kit/gates/hook-actually-fires/green/.claude/hooks/done.sh

@@ -0,0 +1,3 @@
+#!/usr/bin/env sh
+# Образец: хук, который существует и потому может сработать.
+exit 0

package/kit/gates/hook-actually-fires/green/.claude/hooks/idle.sh

@@ -0,0 +1,3 @@
+#!/usr/bin/env sh
+# Образец: хук, который существует и потому может сработать.
+exit 0

package/kit/gates/hook-actually-fires/green/.claude/hooks/prompt.sh

@@ -0,0 +1,3 @@
+#!/usr/bin/env sh
+# Образец: хук, который существует и потому может сработать.
+exit 0

package/kit/gates/hook-actually-fires/green/.claude/hooks/session.mjs

@@ -0,0 +1 @@
+// Образец: путь лежит внутри кавычек вместе с переменной, и файл существует.

package/kit/gates/hook-actually-fires/green/.claude/hooks/stop-gate.sh

@@ -0,0 +1,3 @@
+#!/usr/bin/env sh
+# Образец: хук, который существует и потому может сработать.
+exit 0

package/kit/gates/hook-actually-fires/green/.claude/settings.json

@@ -69,6 +69,18 @@
           }
         ]
       }
+    ],
+    "SessionStart": [
+      {
+        "matcher": "startup|resume",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/session.mjs\"",
+            "timeout": 15
+          }
+        ]
+      }
     ]
   }
 }

package/kit/gates/test-not-adjusted/README.md

@@ -77,3 +77,34 @@ deletes or disables the checkwash job disarms it in the same diff»* — это
 коммитами. `red/` — код изменён на неверный, три утверждения заменены на `is not None`.
 `green/` — код и тест выросли вместе: добавлена функция и тест к ней, ни одно утверждение не
 убрано и не ослаблено.
+
+## Известное ложное срабатывание: литерал `"\n"` читается как имя теста
+
+**Цена записи, названная вслух.** `checkwash` принимает строковый литерал `"\n"` за ИМЯ
+тестового юнита. Файл, где таких литералов два и больше, при ЛЮБОМ сдвиге строк получает
+`TEST_DISABLED — test unit disappeared` уровня **high** — даже если тронут один комментарий и
+ни одно утверждение не изменено.
+
+Воспроизведение, шесть строк (проверено 2026-09-16 на 0.2.13 и 0.3.4 — в обеих одинаково):
+
+```js
+import test from "node:test";
+test("единственный", (t) => {
+  const a = "x\ny".split("\n").slice(-1).join("\n");
+  const b = "p\nq".split("\n").slice(-1).join("\n");
+  t.assert.ok(a && b);
+});
+```
+
+Коммит «before» с этим файлом, коммит «after» с добавленной строкой комментария — и
+`checkwash check HEAD~1..HEAD` даёт `verdict: block`, `unit: "\n"`.
+
+`split("\n")` — обычнейшая конструкция в тестах, работающих с выводом команды. Мы наступили на
+это на собственном `tool/selfcheck/smoke/verdict.test.mjs`: гейт покраснел на добавленном
+комментарии. У себя обошли устранением настоящего повтора (хвост вывода вынесен в функцию
+фикстуры), но **это обход, а не лечение**: чинить может только автор инструмента.
+
+**Что это значит для того, кто ставит запись.** Приговор `TEST_DISABLED` на файле, где
+утверждения не менялись, стоит перепроверить глазами: посмотрите, есть ли в нём литералы
+`"\n"` и совпадает ли имя «исчезнувшего юнита» с настоящим именем теста. Имя вида `\n` — признак
+этого дефекта, а не подгонки теста. Остальные двадцать детекторов инструмента он не затрагивает.

package/llms.txt

@@ -1,11 +1,15 @@
 # AQK — Agent Quality Kit
 
-> A standard and a CLI that check whether a repository is ready to have its code written by AI
-> coding agents. Every rule the project promises to follow becomes a command with an exit code,
-> so a machine holds the promise instead of somebody's attention. Reports a level from AQK-0 to
-> AQK-3, computed by a run — never by a questionnaire and never by a model's opinion. One step
-> further than readiness scores: `probe` plants a known defect into a copy of the project and
-> checks whether the DECLARED guards go red. "Tests exist" and "tests catch" are different claims.
+> A CLI that answers one question: can the checks this repository declares actually fail? A check
+> that cannot fail looks exactly like a check that passes — `|| true`, `continue-on-error`, a
+> linter aimed at an empty directory, a test with no assertion, a hook nobody installed. AQK plants
+> a known defect into a COPY of the project and reports which declared guard noticed and which
+> stayed silent. It distinguishes three outcomes and never collapses them into two: clean ·
+> finding · COULD NOT CHECK. The third means the check itself failed; treating it as either of the
+> others is how a repository ends up protected by checks that cannot go red. Every rule the project
+> promises becomes a command with an exit code, so a machine holds the promise instead of somebody's
+> attention. Levels AQK-0..3 measure equipment, not quality, and are computed by a run — never by a
+> questionnaire and never by a model's opinion.
 
 Vendor-neutral: works with any coding agent (Claude Code, Codex, Cursor, Gemini CLI, GitHub
 Copilot, Windsurf, Aider, OpenCode) and with no AI at all. It calls no vendor API and needs no
@@ -50,6 +54,18 @@ Zero runtime dependencies. Node 18+ and an `sh` shell. MIT.
   ground rules on top, at most five items by weight (red gates, defects the probe planted and no
   check caught, the project's own checks to declare, rules Claude Code cannot see, catalog
   entries to propose), and for every item the command that proves it done. Nothing is run
+- Send the author one answer — the only payment the kit asks: `npx agent-quality-kit feedback`
+  prints a short report built from the last run and the probe (version, level, stack, what went
+  red, what it COULD NOT CHECK, which defect classes nothing here catches) with **no paths, no
+  code and no repository name**, plus a prefilled link. `feedback --send "your words"` posts it in
+  one command using the human's own `gh` account, as a comment in an open discussion. **Without
+  the flag nothing ever leaves the machine**, and a machine holds that claim, not this sentence.
+  An agent must show the text and ask before adding the flag
+- Install it into Claude Code as a plugin, from the kit's own marketplace, with nobody's approval
+  to wait for: `/plugin marketplace add arsen-ask-lx/Agent_Quality_Kit` then
+  `/plugin install aqk@agent-quality-kit`. The session-start hook puts the repository state into
+  the agent's context before its first action; two skills cover "can these checks fail" and "what
+  to fix first". A thin wrapper over the same CLI — no logic of its own
 - Check that the kit's own wiring is actually connected: `npx agent-quality-kit vitals` — are the
   tools the declared gates need installed, is the hook present in `.git/hooks` (a line in the
   config is an intention, not a guard), does the agent receive the state, is the version current.
@@ -76,7 +92,7 @@ Zero runtime dependencies. Node 18+ and an `sh` shell. MIT.
   the files `init` writes are owned by root, so you cannot edit your own manifest. Debian-based
   on purpose: the gates are `sh`, `grep`, `awk`, `find` — under alpine's busybox they behave
   differently, and an image where the gates behave differently is worse than no image
-- As a GitHub Action: `uses: arsen-ask-lx/Agent_Quality_Kit@v0.14.0` with `min: 1`
+- As a GitHub Action: `uses: arsen-ask-lx/Agent_Quality_Kit@v0.16.0` with `min: 1`
   (https://github.com/marketplace/actions/agent-quality-kit-aqk)
 
 ## What makes it different
@@ -95,6 +111,9 @@ Zero runtime dependencies. Node 18+ and an `sh` shell. MIT.
 - `.aqk.yml` — the manifest: entry, rules, docs, lang, gates as commands, covers (what a
   declared gate already holds, so it is not reported as debt), samples, ratchets, lessons
 - `.aqkignore` — paths the scanning checks must not read (brought-in code, vendored, generated)
+- `.aqk/last-run.md` — the short report of the last run, with three marks and not two: `✔` clean,
+  `✘` a finding, `?` COULD NOT CHECK. Readers (the context block, the task list, the feedback
+  report) must never collapse the third into either of the others
 
 ## Documentation
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-quality-kit",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "description": "Turns the rules an agent is supposed to follow into commands with exit codes, and reports which of them actually run. Zero dependencies.",
   "type": "module",
   "bin": {

package/tool/commands/context.mjs

@@ -21,14 +21,14 @@
 // а агент примет его за утверждение. Поэтому каждое незнание называется словом: прогона не было —
 // так и написано, прогон устарел — тоже, инструмента нет — тоже.
 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, preCommitHook } from "../lib/core.mjs";
+import { maybeAsk } from "./feedback.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 { declaredGates, readRun } from "../lib/run.mjs";
 import { probeStatus } from "./probe.mjs";
 import { L } from "../i18n/index.mjs";
 
@@ -73,11 +73,17 @@ function contextBlock(state, T = L.context) {
     out.push(T.runNone);
   } else {
     const red = state.run.red || [];
-    const shown = red.slice(0, MAX_RED);
-    const names = red.length > MAX_RED
-      ? `${shown.join(", ")} — ${T.andMore(red.length - MAX_RED)}`
-      : shown.join(", ");
-    out.push(red.length ? T.runRed(state.run.when, names) : T.runClean(state.run.when));
+    const cannot = state.run.cannot || [];
+    const short = (list) => (list.length > MAX_RED
+      ? `${list.slice(0, MAX_RED).join(", ")} — ${T.andMore(list.length - MAX_RED)}`
+      : list.join(", "));
+    if (red.length) out.push(T.runRed(state.run.when, short(red)));
+    // «НЕ СМОГЛИ ПРОВЕРИТЬ» — ОТДЕЛЬНОЙ СТРОКОЙ, И ЧИСТО ТОЛЬКО КОГДА ОБА СПИСКА ПУСТЫ.
+    // Гейт, который не сумел отработать, не находка о коде: агент, прочитавший его как находку,
+    // пойдёт чинить исправный файл. А если бы он не попал НИКУДА, прогон, где всё сломалось,
+    // читался бы как «чисто» — та же тишина, только внутри блока, который читает машина.
+    if (cannot.length) out.push(T.runCannot(short(cannot)));
+    if (!red.length && !cannot.length) out.push(T.runClean(state.run.when));
     if (state.run.stale) out.push(T.runStale(state.run.when));
     if (state.run.skipped) out.push(T.skipped(state.run.skipped));
   }
@@ -148,20 +154,13 @@ function contextBlock(state, T = L.context) {
   // чем промолчать: он пойдёт его читать и получит пустоту вместо правил. Замерено на шести
   // чужих проектах: на flask блок писал «Свод правил: AGENTS.md», которого там нет.
   if (state.entryExists !== false) out.push("", T.where(state.entry || "AGENTS.md"));
+  // ПРОСЬБА ОБ ОТЗЫВЕ — последней строкой и только при содержании (feedback.mjs). Последней
+  // потому, что это единственная строка блока, которая не про состояние проекта: ставить её
+  // выше значило бы отодвинуть работой то, ради чего блок и читают.
+  if (state.ask) out.push("", state.ask);
   return out;
 }
 
-// Разбор отчёта прошлого прогона. Формат кладёт сам `doctor` в .aqk/last-run.md; читаем его,
-// а не запускаем гейты заново: хук обязан укладываться в секунду-две, а прогон у нас идёт минуту.
-function parseLastRun(text) {
-  if (!text) return null;
-  const when = (text.match(/^# aqk doctor --run — (.+)$/m) || [])[1] || "";
-  const red = [];
-  for (const m of text.matchAll(/^✘ ([^\s—]+)/gm)) red.push(m[1]);
-  const skipped = (text.match(/^~ /gm) || []).length;
-  return { when: when.trim(), red, skipped, stale: false };
-}
-
 // Правила и их арбитры: отметка `<!-- aqk: имя -->` рядом с правилом. `человек` — честное
 // признание, что машина этого не держит; так его и считаем, отдельно от машинных.
 function countArbiters(text, humanWords) {
@@ -173,16 +172,6 @@ function countArbiters(text, humanWords) {
   return { total: marks.length, machine: marks.length - human, human };
 }
 
-// Прогон старше последнего коммита описывает не тот код, что лежит перед агентом. Молча выдать
-// его за свежий — соврать: именно так «зелёный месяц назад» превращается в «зелёный сейчас».
-function runIsStale(when) {
-  if (!when) return false;
-  const r = spawnSync("git", ["log", "-1", "--format=%cI"], { cwd: CWD, encoding: "utf8" });
-  if (r.status !== 0 || !r.stdout) return false;
-  const commit = Date.parse(r.stdout.trim());
-  const run = Date.parse(when.replace(" ", "T"));
-  return Number.isFinite(commit) && Number.isFinite(run) && run < commit;
-}
 
 
 // УСТАНОВКА ХУКА — отдельной командой, а не частью `init`, и это решение, а не лень. Комплект
@@ -260,16 +249,6 @@ async function installHook(full = false) {
   console.log(c.dim(`  ${T.hookWhat}`));
 }
 
-// Прошлый прогон — из отчёта, который кладёт `doctor --run`. Отдельной функцией: его читают и
-// `context`, и `prompt`, и два разбора одного файла разошлись бы.
-async function readRun() {
-  const lastRun = join(CWD, TARGET_DIR, "last-run.md");
-  if (!(await exists(lastRun))) return null;
-  const run = parseLastRun(await readFile(lastRun, "utf8"));
-  if (run) run.stale = runIsStale(run.when);
-  return run;
-}
-
 // Что советовать — теми же функциями, что у `doctor`: корзины каталога, «начните с трёх», совет
 // под язык, чужие проверки проекта. Одно место на `context` и `prompt`: второй расчёт того же
 // самого разошёлся бы с первым. Класс из пробы, чей гейт уже стоит, в совет не идёт — ставить
@@ -278,7 +257,9 @@ async function readAdvice(man, probe) {
   const facts = await detectFacts(man);
   const catalog = await readCatalog();
   const { todo } = catalogBuckets(catalog, facts, coversOf(man).covered);
-  const adopt = declaredGates(man).length ? [] : proposeGates(await readAdoptFiles(CWD));
+  // Чужие проверки — и тогда, когда гейты уже объявлены: отсев идёт по КОМАНДЕ внутри
+  // `proposeGates`, а не по факту «манифест не пуст» (замер 2026-09-16, см. doctor-catalog).
+  const adopt = proposeGates(await readAdoptFiles(CWD), declaredGates(man).map(([, cmd]) => cmd));
   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 }));
@@ -364,10 +345,27 @@ async function cmdContext(args = []) {
     next = nextSteps({ init: !man, adopt, blind, start });
   } catch { /* не посчитали — блок скажет остальное; выдумывать шаги нельзя */ }
 
+  // ЕДИНСТВЕННАЯ ПЛАТА ЗА КОМПЛЕКТ — один ответ автору, и просит о нём агент: он читает этот
+  // блок каждую сессию и передаёт человеку то, что в нём написано. Замер 2026-09-14: тысяча
+  // скачиваний в неделю и ноль отзывов за всё время — просьба печаталась только при `init`, то
+  // есть до того, как комплект сделал хоть что-то.
+  //
+  // ТРИ УСЛОВИЯ, И ВСЕ ТРИ ОБЯЗАТЕЛЬНЫ: не выключено человеком, не просили на этом проекте
+  // раньше, и ЕСТЬ О ЧЁМ рассказать. Без третьего это «оставьте отзыв» — шум, а шум выключают
+  // вместе с хуком, в котором он приехал.
+  //
+  // ЕДИНСТВЕННАЯ ЗАПИСЬ НА ДИСК В ЭТОЙ КОМАНДЕ, кроме `--install`. Без отметки просьба
+  // повторялась бы каждую сессию: красный гейт живёт в проекте днями, а блок читается заново
+  // при каждом запуске агента и после каждого сжатия контекста.
+  const ask = await maybeAsk({
+    cannot: run?.cannot || [], red: run?.red || [],
+    blind: (probe?.classes || []).map((b) => b.slug),
+  }, portableSelf(SELF), { agent: true });
+
   console.log(contextBlock({
     entry, entryExists: rules !== null, level, rules, run, ratchets, probe, full: fullPart,
-    next, when: { hook: await preCommitHook(CWD) },
+    next, when: { hook: await preCommitHook(CWD) }, ask,
   }).join("\n"));
 }
 
-export { cmdContext, contextBlock, nextSteps, parseLastRun, countArbiters, withHook, hasOurHook, portableSelf, readRun, readAdvice };
+export { cmdContext, contextBlock, nextSteps, countArbiters, withHook, hasOurHook, portableSelf, readAdvice };

package/tool/commands/doctor-catalog.mjs

@@ -18,6 +18,34 @@ import { L } from "../i18n/index.mjs";
 
 // Обязательный минимум проекта — прогоном, а не по памяти. До сих пор это было единственное
 // место, где комплект просил верить на слово, что человек прочитал методичку и сверился.
+// ЧТО У ПРОЕКТА УЖЕ ЕСТЬ — отдельной функцией, а не ветками внутри вывода: выбор причины из
+// трёх плюс перебор плюс два условия давали вложенность 6 при пределе 5, и наш же гейт это
+// поймал. Печать — единственное, что здесь происходит; решение принято в `adopt.mjs`.
+function weakSay(weak) {
+  return weak.kind === "off" ? L.doctor.weakOff(weak.text)
+    : weak.kind === "zero" ? L.doctor.weakZero()
+    : L.doctor.weakStub(weak.text);
+}
+
+function printAdopted(found) {
+  if (!found.length) return;
+  console.log(`\n  ${c.bold(L.doctor.haveAlready(found.length))}`);
+  for (const g of found) {
+    // ВЫКЛЮЧЕННАЯ ПРОВЕРКА — ЭТО НАХОДКА, а не «посмотреть не смогли»: мы прочитали тело
+    // скрипта и знаем ответ. Поэтому крест, а не вопрос, и причина названа дословно — человек
+    // не поверит обвинению без строки, которую может найти у себя глазами.
+    console.log(`  ${g.weak ? c.red("✘") : c.green("✔")}  ${g.name.padEnd(12)} ${c.dim(`${g.cmd}   ← ${g.source}`)}`);
+    if (g.weak) console.log(`     ${c.red(weakSay(g.weak))}`);
+  }
+  // «Впишите в манифест» — ТОЛЬКО про рабочие. Строкой выше сказано, что слабую объявлять
+  // нельзя; предложить её тут же — это совет, противоречащий собственному предостережению,
+  // и человек послушает тот, что ближе к строке с командой.
+  const weak = found.filter((g) => g.weak).length;
+  const ok = found.filter((g) => !g.weak);
+  if (weak) console.log(c.dim(`     ${L.doctor.weakHow(weak)}`));
+  if (ok.length) console.log(c.dim(`     ${L.doctor.haveAlreadyHow(ok.map((g) => `${g.name}: "${g.cmd}"`).join("  "))}`));
+}
+
 async function reportBaseline(man, facts) {
   const { readdir, readFile } = await import("node:fs/promises");
   let files = [];
@@ -77,16 +105,13 @@ async function reportCatalog(man, facts, probe = null, verbose = true) {
   // только СВОИ записи, а чужие проверки не читали вовсе. С точки зрения владельца это
   // неправда, и первое, что он видел, было обвинением. Предлагаем, а не вписываем: гейт в
   // чужом манифесте без спроса — наше решение в чужом файле.
-  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("  "))}`));
-    }
-  }
+  //
+  // ПОКАЗЫВАЕТСЯ И ТОГДА, КОГДА ГЕЙТЫ ОБЪЯВЛЕНЫ. Прежде здесь стояло `!declaredGates(man).length`:
+  // чужие проверки читались только у того, у кого гейтов нет вовсе. Замер 2026-09-16 по двенадцати
+  // репозиториям: у шести зрелых блок исчезал целиком, стоило объявить ОДИН гейт, и итог говорил
+  // «держит машина 0» проекту с настоящим pre-commit и Makefile. Чем больше человек настроил, тем
+  // меньше мы о нём знали. Повтора не будет: уже объявленную команду `proposeGates` отсеивает сам.
+  printAdopted(proposeGates(await readAdoptFiles(CWD), declaredGates(man).map(([, cmd]) => cmd)));
 
   // ЧТО ВАШИ ПРОВЕРКИ ПРОПУСТИЛИ. Проба знала имена непойманных классов и писала в отметку одно
   // число; человек в `doctor` не видел ничего. Это самое конкретное, что мы знаем о проекте, —

package/tool/commands/doctor.mjs

@@ -4,6 +4,7 @@ import { readFile, mkdir, writeFile } from "node:fs/promises";
 import { join, resolve } from "node:path";
 import { spawnSync } from "node:child_process";
 import { CWD, PKG_ROOT, TARGET_DIR, MANIFEST, SELF, c, exists, die, RUNTIME_FILES } from "../lib/core.mjs";
+import { maybeAsk } from "./feedback.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";
@@ -12,34 +13,9 @@ import { reportBaseline, reportCatalog } from "./doctor-catalog.mjs";
 import { L } from "../i18n/index.mjs";
 import { countArbiters } from "./context.mjs";
 import { beginBrief, finishBrief } from "../lib/brief.mjs";
-import { declaredGates, sinceRef, runGates, progress, listArg } from "../lib/run.mjs";
+import { declaredGates, sinceRef, runGates, progress, listArg, writeRunReport } from "../lib/run.mjs";
 import { autoProbeAllowed, levelLimits } from "../lib/cadence.mjs";
 
-// Короткий отчёт «что из этого реально брали» — не для человека, а для агента в следующей
-// сессии и для самого владельца: список объявленных гейтов молчит о том, сколько из них
-// действительно стоят и работают именно СЕЙЧАС. Перезаписывается каждым прогоном, не копится:
-// история — дело git-лога коммитов с этим отчётом, если владелец решит его коммитить.
-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 = [
-    `# ${L.report.title} — ${stamp}`,
-    version ? `${L.report.version}: ${version}` : null,
-    `${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);
-
-  const dst = join(CWD, TARGET_DIR, "last-run.md");
-  await mkdir(join(CWD, TARGET_DIR), { recursive: true });
-  await writeFile(dst, lines.join("\n") + "\n", "utf8");
-}
-
 // ПРОБА ЗАПУСКАЕТСЯ САМА, раз в сто коммитов, — кроме конвейера (там это минуты сюрпризом в
 // быстрой проверке, отзыв с живого проекта 2026-09-11). Не влияет на код возврата никогда: это
 // осмотр, а не порог. Отдельной функцией: внутри прогона эта лесенка дала вложенность 6, и наш же
@@ -229,6 +205,7 @@ async function cmdDoctor() {
   const gates = declaredGates(man);
   let gateFailed = 0;
   let failedNames = [];
+  let cannotNames = [];
   let skippedNames = [];
   if (wantRun) {
     // --jobs N: сколько гейтов одновременно. Без флага — по одному, как было: чужие гейты бывают
@@ -254,6 +231,7 @@ async function cmdDoctor() {
     // стоят дороже. Не влияет на код возврата НИКОГДА — это осмотр, а не порог.
     // Выключается AQK_PROBE=0 — у всего, что случается само, обязан быть выключатель.
     if (!brief && process.env.AQK_PROBE !== "0") await autoProbe(brief);
+    cannotNames = run.results.filter((r) => r.cannot).map((r) => r.name);
   } else if (gates.length) {
     console.log(
       c.yellow(`  ${L.doctor.declaredNotRun(gates.length)}`) +
@@ -261,6 +239,20 @@ async function cmdDoctor() {
     );
   }
 
+  // ЕДИНСТВЕННАЯ ПЛАТА ЗА КОМПЛЕКТ — один ответ автору. Человеку говорим здесь, агенту — в
+  // блоке `context`; текст и решение «есть ли о чём просить» одни на оба места (feedback.mjs),
+  // отметка одна на проект (ask.mjs): кто первым дошёл, тот и спросил, второй раз не спрашивает
+  // никто. В кратком режиме молчим — там ворота коммита, и лишняя строка там дороже всего.
+  const askText = brief ? null : await maybeAsk({
+    cannot: cannotNames,
+    red: failedNames.filter((n) => !cannotNames.includes(n)),
+    blind: (probe?.classes || []).map((b) => b.slug),
+  }, SELF);
+  if (askText) {
+    for (const l of askText.split("\n")) console.log(c.dim(`  ${l}`));
+    console.log("");
+  }
+
   // Код возврата — для конвейера. Порог задаётся так: aqk doctor --min 1
   const minIdx = process.argv.indexOf("--min");
   const min = minIdx > -1 ? Number(process.argv[minIdx + 1]) : null;