agent-quality-kit 0.4.1 → 0.5.0

package/kit/gates/duplicate-code/check.sh

@@ -19,7 +19,8 @@ find "$DIR" $(skip_find "$DIR") $TESTS -type f \
      ! -name 'test_*' ! -name '*_test.*' ! -name '*.test.*' ! -name '*.spec.*' \
      -print 2>/dev/null | only_code | own_samples_filter "$DIR" \
   | while IFS= read -r F; do is_generated "$F" || printf '%s\n' "$F"; done \
-  | xargs -r awk -v WIN="$WIN" '
+  | LC_ALL=C sort \
+  | xargs -r env LC_ALL=C awk -v WIN="$WIN" '
       FNR == 1 { n = 0; delete buf }
       {
         line = $0
@@ -37,11 +38,19 @@ find "$DIR" $(skip_find "$DIR") $TESTS -type f \
         }
       }
     ' 2>/dev/null | sort -u \
-  | awk -F' и |: ' '
+  | LC_ALL=C awk -F' и |: ' '
       # Один повторённый кусок даёт столько сообщений, на сколько окон он делится: восемь
       # строк — восемь почти одинаковых строк отчёта. Схлопываем в одну на пару файлов.
-      { split($1, a, ":"); split($2, b, ":"); pair = a[1] " и " b[1]
-        if (!(pair in seen)) { seen[pair] = $1 " и " $2 }
+      #
+      # Пара упорядочивается лексикографически, а НЕ в порядке обхода. Порядок, в котором
+      # find отдаёт файлы, свой на каждой системе (здесь — по хешу имени), и реестр, снятый
+      # на одной машине, краснел в конвейере целиком: те же дубли читались как новые, а
+      # храповик объявлял их исправленными и вычёркивал. Одной сортировки списка файлов мало:
+      # когда кусок лежит в трёх файлах, «первым» становится тот, кого раньше отдал обход.
+      { split($1, a, ":"); split($2, b, ":")
+        if (a[1] <= b[1]) { pair = a[1] " и " b[1]; loc = $1 " и " $2 }
+        else              { pair = b[1] " и " a[1]; loc = $2 " и " $1 }
+        if (!(pair in seen)) { seen[pair] = loc }
         cnt[pair]++ }
       END { for (p in seen) print seen[p] ": одинаковый кусок" (cnt[p] > 1 ? " (окон: " cnt[p] ")" : "") }
     ' | sort > /tmp/.dup.$$

package/kit/gates/duplicate-code/gate.yml

@@ -7,7 +7,16 @@ trigger:
 recipes:
   any: bash {gate}/check.sh {dir}
   # jscpd умеет и Python, и TypeScript одним прогоном и считает похожесть, а не совпадение.
-  javascript: npx --yes jscpd@5 --min-lines 8 --threshold 1 {dir}
-  typescript: npx --yes jscpd@5 --min-lines 8 --threshold 1 {dir}
+  #
+  # --format обязателен: без него jscpd считает клонами разметку, JSON и текст. Замер на живом
+  # проекте (Django + React, 2750 файлов кода): 1846 клонов, из них 435 — markdown, json и
+  # text, то есть 23.6% находок не про код вовсе. Переносимая проверка смотрит только в
+  # расширения кода (CODE_EXT в _skip.sh), и родная обязана мерить то же самое: иначе один
+  # гейт означает разное на разных машинах.
+  #
+  # «c#» в списке нет намеренно: разбор манифеста режет строку по «#», и рецепт обрывался бы
+  # на «c». Обёртку _native.sh не пишем — её добавляет сама программа при установке гейта.
+  javascript: npx --yes jscpd@5 --min-lines 8 --threshold 1 --format "javascript,jsx,typescript,tsx,vue,python,go,ruby,java,php,rust,kotlin,swift,scala" {dir}
+  typescript: npx --yes jscpd@5 --min-lines 8 --threshold 1 --format "javascript,jsx,typescript,tsx,vue,python,go,ruby,java,php,rust,kotlin,swift,scala" {dir}
 
 proof: incidents/README.md — «2026-08-25 разбор 1069 коммитов»: число моделей захардкожено в четырёх местах четырьмя разными значениями

package/kit/gates/gate-has-samples/check.sh

@@ -15,9 +15,15 @@
 DIR="${1:-.}"
 MAN="$DIR/.aqk.yml"
 [ -f "$MAN" ] || { echo "нет .aqk.yml — проверять нечего"; exit 0; }
+# Перевод строк из windows-чекаута снимается ДО разбора. Жадный захват в sed («[^"#]*») и
+# якорь конца строки («s/"$//») проглатывают \r: путь получался с кавычкой на хвосте, а
+# красный образец переставал краснеть. Найдено мутационной проверкой
+# (tool/selfcheck/mutation.sh), а не на Windows-машине — её у нас до сих пор нет.
+MANTEXT="$(tr -d '\r' < "$MAN")"
 
-SAMPLES=$(sed -n 's/^samples:[[:space:]]*"\{0,1\}\([^"#]*\)"\{0,1\}[[:space:]]*$/\1/p' "$MAN" | head -1)
-KEYS=$(awk '/^gates:/{g=1;next} /^[A-Za-z]/{g=0} g && /^[[:space:]]+[A-Za-z0-9_-]+:/{sub(/:.*/,"");gsub(/[[:space:]]/,"");print}' "$MAN")
+
+SAMPLES=$(printf '%s\n' "$MANTEXT" | sed -n 's/^samples:[[:space:]]*"\{0,1\}\([^"#]*\)"\{0,1\}[[:space:]]*$/\1/p' | head -1)
+KEYS=$(printf '%s\n' "$MANTEXT" | awk '/^gates:/{g=1;next} /^[A-Za-z]/{g=0} g && /^[[:space:]]+[A-Za-z0-9_-]+:/{sub(/:.*/,"");gsub(/[[:space:]]/,"");print}')
 
 [ -z "$KEYS" ] && { echo "гейтов не объявлено — проверять нечего"; exit 0; }
 
@@ -32,7 +38,7 @@ fi
 BAD=0
 for K in $KEYS; do
   # Команда записи целиком — по ней видно, сканер это или собственный прогон проекта.
-  CMD=$(awk -v k="$K" '/^gates:/{g=1;next} /^[A-Za-z]/{g=0} g && $0 ~ "^[[:space:]]+" k ":" {sub(/^[[:space:]]*[A-Za-z0-9_-]+:[[:space:]]*/,"");gsub(/^"|"$/,"");print;exit}' "$MAN")
+  CMD=$(printf '%s\n' "$MANTEXT" | awk -v k="$K" '/^gates:/{g=1;next} /^[A-Za-z]/{g=0} g && $0 ~ "^[[:space:]]+" k ":" {sub(/^[[:space:]]*[A-Za-z0-9_-]+:[[:space:]]*/,"");gsub(/^"|"$/,"");print;exit}')
   case "$CMD" in
     *"$SAMPLES/"*) ;;                 # сканер из каталога — образцы обязательны
     *) continue ;;                    # свой прогон — арбитр внутри него

package/kit/gates/gates-are-runnable/check.sh

@@ -5,9 +5,15 @@
 DIR="${1:-.}"
 MAN="$DIR/.aqk.yml"
 [ -f "$MAN" ] || { echo "нет .aqk.yml — проверять нечего"; exit 0; }
+# Перевод строк из windows-чекаута снимается ДО разбора. Жадный захват в sed («[^"#]*») и
+# якорь конца строки («s/"$//») проглатывают \r: путь получался с кавычкой на хвосте, а
+# красный образец переставал краснеть. Найдено мутационной проверкой
+# (tool/selfcheck/mutation.sh), а не на Windows-машине — её у нас до сих пор нет.
+MANTEXT="$(tr -d '\r' < "$MAN")"
+
 
 # строки вида `  имя: "команда"` внутри блока gates:
-LINES=$(awk '/^gates:/{g=1;next} /^[A-Za-z]/{g=0} g && /^[[:space:]]+[A-Za-z0-9_-]+:/{print}' "$MAN")
+LINES=$(printf '%s\n' "$MANTEXT" | awk '/^gates:/{g=1;next} /^[A-Za-z]/{g=0} g && /^[[:space:]]+[A-Za-z0-9_-]+:/{print}')
 [ -z "$LINES" ] && { echo "гейтов не объявлено"; exit 0; }
 
 BAD=0

package/kit/gates/gates-run-in-ci/check.sh

@@ -4,6 +4,12 @@
 DIR="${1:-.}"
 MAN="$DIR/.aqk.yml"
 [ -f "$MAN" ] || { echo "нет .aqk.yml — проверять нечего"; exit 0; }
+# Перевод строк из windows-чекаута снимается ДО разбора. Жадный захват в sed («[^"#]*») и
+# якорь конца строки («s/"$//») проглатывают \r: путь получался с кавычкой на хвосте, а
+# красный образец переставал краснеть. Найдено мутационной проверкой
+# (tool/selfcheck/mutation.sh), а не на Windows-машине — её у нас до сих пор нет.
+MANTEXT="$(tr -d '\r' < "$MAN")"
+
 
 CI=$(find "$DIR/.github/workflows" "$DIR/.gitlab-ci.yml" "$DIR/.circleci" "$DIR/Jenkinsfile" \
      -type f 2>/dev/null)
@@ -18,7 +24,7 @@ if grep -qE 'doctor[[:space:]]+--run|--run[[:space:]]+.*doctor' $CI 2>/dev/null;
   exit 0
 fi
 
-NAMES=$(awk '/^gates:/{g=1;next} /^[A-Za-z]/{g=0} g && /^[[:space:]]+[A-Za-z0-9_-]+:/{print}' "$MAN")
+NAMES=$(printf '%s\n' "$MANTEXT" | awk '/^gates:/{g=1;next} /^[A-Za-z]/{g=0} g && /^[[:space:]]+[A-Za-z0-9_-]+:/{print}')
 [ -z "$NAMES" ] && { echo "гейтов не объявлено"; exit 0; }
 
 BAD=0

package/kit/gates/lesson-has-outcome/check.sh

@@ -9,7 +9,12 @@ DIR="${1:-.}"
 MAN="$DIR/.aqk.yml"
 
 # Где журнал — говорит манифест. Своего мнения у проверки быть не должно: путь у каждого свой.
-LESSONS=$(sed -n 's/^lessons:[[:space:]]*"\{0,1\}\([^"#]*\)"\{0,1\}[[:space:]]*$/\1/p' "$MAN" 2>/dev/null | head -1)
+# Перевод строк из windows-чекаута снимается ДО разбора. Жадный захват в sed («[^"#]*») и
+# якорь конца строки («s/"$//») проглатывают \r: путь получался с кавычкой на хвосте, а
+# красный образец переставал краснеть. Найдено мутационной проверкой
+# (tool/selfcheck/mutation.sh), а не на Windows-машине — её у нас до сих пор нет.
+MANTEXT="$(tr -d '\r' < "$MAN" 2>/dev/null)"
+LESSONS=$(printf '%s\n' "$MANTEXT" | sed -n 's/^lessons:[[:space:]]*"\{0,1\}\([^"#]*\)"\{0,1\}[[:space:]]*$/\1/p' 2>/dev/null | head -1)
 case "$LESSONS" in
   "" ) echo "в .aqk.yml не указано поле lessons — журнала нет"; exit 0 ;;
   http*://* ) echo "журнал вынесен наружу ($LESSONS) — здесь не проверить"; exit 0 ;;

package/kit/ratchet/ratchet.sh

@@ -17,7 +17,12 @@ REG="${1:-}"; shift || true
 
 # Ключ нарушения обязан переживать правку соседних строк, иначе сдвиг на строку читается
 # как новое нарушение. Поэтому номер строки из ключа убирается.
-keys() { grep -E '^[^[:space:]].*:' | sed -E 's/:[0-9]+:/:/' | sort -u; }
+#
+# Два шаблона, а не один: у гейта duplicate-code строка несёт ДВА места — «a:171 и b:188: …»,
+# и за номером первого идёт не двоеточие, а пробел. Шаблон с двоеточием убирал номер только
+# у второго файла пары, и сдвиг кода в первом читался как новое нарушение — ровно то, от чего
+# храповик защищает.
+keys() { grep -E '^[^[:space:]].*:' | sed -E 's/:[0-9]+:/:/g; s/:[0-9]+( |$)/:\1/g' | LC_ALL=C sort -u; }
 
 OUT="$("$@" 2>&1)"
 NOW="$(printf '%s\n' "$OUT" | keys)"
@@ -26,7 +31,9 @@ if [ ! -f "$REG" ]; then
   echo "нет реестра $REG — сначала: aqk ratchet <гейт>"
   exit 2
 fi
-WAS="$(grep -vE '^\s*(#|$)' "$REG" | sort -u)"
+# Та же сортировка, что в keys(): comm сравнивает построчно и требует, чтобы оба входа были
+# упорядочены одинаково. Разная локаль у двух сторон — это тихо разъехавшееся сравнение.
+WAS="$(grep -vE '^\s*(#|$)' "$REG" | LC_ALL=C sort -u)"
 
 NEW="$(comm -23 <(printf '%s\n' "$NOW") <(printf '%s\n' "$WAS"))"
 GONE="$(comm -13 <(printf '%s\n' "$NOW") <(printf '%s\n' "$WAS"))"

package/llms.txt

@@ -0,0 +1,57 @@
+# 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.
+
+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
+key. Stack-neutral: portable checks are plain `sh`; where the project already has a native tool
+(ruff, eslint, knip, jscpd) the check uses it instead and says so when it falls back.
+
+Zero runtime dependencies. Node 18+ and an `sh` shell. MIT.
+
+## Use it
+
+- Check an existing repository: `npx agent-quality-kit doctor` (read-only: writes nothing, sends
+  nothing)
+- Start a new one: `npx agent-quality-kit start`
+- Install one guard from the catalogue: `npx agent-quality-kit add <name>`
+- Check the minimum a project needs before agents can be handed the work:
+  `npx agent-quality-kit doctor --baseline` (14 of 50 points confirmed by a run, ecosystem-neutral;
+  the other 36 are named as a number, not hidden)
+- Fail a pipeline below a level or on a failed gate: `npx agent-quality-kit doctor --run --min 1`
+- Exit codes: 0 pass, 1 below the level or a gate failed
+- As a pre-commit hook: `repo: https://github.com/arsen-ask-lx/Agent_Quality_Kit` with
+  `id: aqk` (blocking), `aqk-doctor` (read-only) or `aqk-baseline`. pre-commit installs the
+  package itself; there are no dependencies to pull in.
+- As a GitHub Action: `uses: arsen-ask-lx/Agent_Quality_Kit@v0.4.2` with `min: 1`
+  (https://github.com/marketplace/actions/agent-quality-kit-aqk)
+
+## What makes it different
+
+- The level is computed by running what the repository declares — not from a self-assessment
+  questionnaire, not from the presence of a config file, not from a language model's judgement.
+- Every guard must ship a red and a green sample, and a machine checks that the guard goes red on
+  the red one and stays quiet on the green one. A check that cannot fail is indistinguishable
+  from a check that works; this is the only place that requirement is enforced.
+- An entry enters the catalogue only when it names a real failure it caught, recorded in the
+  bruise journal.
+
+## Files it reads and writes
+
+- `AGENTS.md` — what the agent reads first (the entry point; `CLAUDE.md` and others work too)
+- `.aqk.yml` — the manifest: entry, rules, gates as commands, samples, ratchets, lessons
+- `.aqkignore` — paths the scanning checks must not read (brought-in code, vendored, generated)
+
+## Documentation
+
+- [README](README.md): what it is, how to install, the catalogue, the badge, CI
+- [SPEC.md](SPEC.md): the standard itself — levels, manifest, how an entry is accepted
+- [Project baseline](kit/docs/ai/project-baseline.md): what a project needs before agents can be
+  handed the work, in plain words, independent of language and tooling
+- [The gate catalogue](kit/gates/README.md): what a gate is and the bar an entry must clear
+- [The bruise journal](incidents/README.md): every defect found, and what was made of it
+- [CONTRIBUTING.md](CONTRIBUTING.md): how to bring a gate
+- [SECURITY.md](SECURITY.md): reporting a vulnerability, and the trust model of the manifest

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agent-quality-kit",
-  "version": "0.4.1",
-  "description": "AQK — Agent Quality Kit: переносимый комплект, приводящий проект в состояние, пригодное для работы агентов. Правила, механические упоры, накопленные уроки. Одна команда, любой инструмент.",
+  "version": "0.5.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": {
     "aqk": "tool/program.mjs"
@@ -11,6 +11,7 @@
     "kit",
     "README.md",
     "README.ru.md",
+    "llms.txt",
     "LICENSE"
   ],
   "engines": {
@@ -34,7 +35,11 @@
     "codex",
     "cursor",
     "harness",
-    "repository-standard"
+    "repository-standard",
+    "agents-md",
+    "agents",
+    "github-action",
+    "npx"
   ],
   "knip": {
     "entry": [

package/tool/commands/doctor.mjs

@@ -4,10 +4,46 @@ 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, SELF, c, exists } from "../lib/core.mjs";
-import { readManifest, assessLevel } from "../lib/manifest.mjs";
+import { readManifest, assessLevel, unknownKeys, KNOWN_KEYS } from "../lib/manifest.mjs";
 import { detectFacts, readCatalog, triggerVerdict, recipeFor } from "../lib/repo.mjs";
+import { assessBaseline, DEP_FILES, BASELINE_TOTAL } from "../lib/baseline.mjs";
 import { L } from "../i18n/index.mjs";
 
+// Обязательный минимум проекта — прогоном, а не по памяти. До сих пор это было единственное
+// место, где комплект просил верить на слово, что человек прочитал методичку и сверился.
+async function reportBaseline(man, facts) {
+  const { readdir, readFile } = await import("node:fs/promises");
+  let files = [];
+  try {
+    files = (await readdir(CWD, { withFileTypes: true })).map((d) => d.name);
+  } catch { /* пустой список честнее выдуманного: ни один пункт не подтвердится */ }
+
+  // Файлы зависимостей читаются целиком и склеиваются: трекер ошибок объявляют по-разному в
+  // каждой экосистеме, а искать его надо одинаково.
+  let depsText = "";
+  for (const f of DEP_FILES) {
+    if (!files.some((n) => n.toLowerCase() === f)) continue;
+    try { depsText += (await readFile(join(CWD, f), "utf8")).toLowerCase() + "\n"; } catch { /* нечитаемый файл — просто не признак */ }
+  }
+
+  const rows = assessBaseline({ files, gateKeys: facts.gateKeys, facts, manifest: man || {}, depsText });
+  const okCount = rows.filter((r) => r.ok).length;
+
+  console.log(c.bold(`\n  ${L.baseline.heading}\n`));
+  console.log(c.dim(`  ${L.baseline.intro(rows.length, BASELINE_TOTAL)}`));
+  console.log(c.dim(`  ${L.baseline.caveat}\n`));
+  for (const r of rows) {
+    const mark = r.ok ? c.green("✔") : c.yellow("✘");
+    const title = L.baseline.titles[r.key] || r.key;
+    console.log(`  ${mark}  ${String(r.n).padStart(2)}. ${title}`);
+    console.log(c.dim(`        ${r.ok ? L.baseline.by(r.by) : L.baseline.none}`));
+  }
+  console.log(
+    "\n  " + (okCount === rows.length ? c.green(`${okCount}/${rows.length}`) : c.yellow(`${okCount}/${rows.length}`)) +
+      c.dim(`  ·  ${L.baseline.eyes(BASELINE_TOTAL - rows.length, "kit/docs/ai/project-baseline.md")}\n`)
+  );
+}
+
 async function reportCatalog(man, facts) {
   const catalog = await readCatalog();
   if (!catalog.length) return;
@@ -158,6 +194,15 @@ async function cmdDoctor() {
   }
 
   const man = await readManifest();
+
+  // Опечатка в имени поля означала «поля нет»: вердикт выдавался неверный, а причина молчала.
+  // Называем поле и говорим, какие бывают — иначе человек ищет ошибку в проекте, а она в файле.
+  const unknown = unknownKeys(man);
+  if (unknown.length) {
+    console.log(c.yellow(`\n  ${L.doctor.manifestUnknown(unknown)}`));
+    console.log(c.dim(`  ${L.doctor.manifestKnown(KNOWN_KEYS)}\n`));
+  }
+
   const { reached, steps } = await assessLevel(man);
 
   console.log(c.bold(`\n  ${L.doctor.levelHeading}\n`));
@@ -190,15 +235,21 @@ async function cmdDoctor() {
   }
 
   const facts = await detectFacts(man);
+  if (process.argv.includes("--baseline")) {
+    await reportBaseline(man, facts);
+    process.exit(0);
+  }
   await reportCatalog(man, facts);
 
   // «Объявлен» ≠ «работает». Без --run говорим это вслух, а не молчим.
   const wantRun = process.argv.includes("--run");
   const gates = declaredGates(man);
   let gateFailed = 0;
+  let failedNames = [];
   if (wantRun) {
     const run = runGates(man);
     gateFailed = run.failed;
+    failedNames = run.results.filter((r) => !r.ok).map((r) => r.name);
     await writeRunReport({ version, reached, results: run.results });
   } else if (gates.length) {
     console.log(
@@ -211,12 +262,16 @@ async function cmdDoctor() {
   const minIdx = process.argv.indexOf("--min");
   const min = minIdx > -1 ? Number(process.argv[minIdx + 1]) : null;
   if (min !== null) {
-    const pass = reached >= min && gateFailed === 0;
-    console.log(
-      pass
-        ? c.green(`  ${L.doctor.thresholdPass(min)}\n`)
-        : c.red(`  ${L.doctor.thresholdFail(min, reached < 0 ? L.doctor.levelNone : reached)}\n`)
-    );
+    const levelOk = reached >= min;
+    const pass = levelOk && gateFailed === 0;
+    // Две разные развилки, и сообщение обязано их различать. «Порог не пройден: сейчас AQK-1»
+    // при пороге AQK-1 противоречит само себе и отправляет чинить манифест, когда падал гейт.
+    const now = reached < 0 ? L.doctor.levelNone : reached;
+    let line;
+    if (pass) line = c.green(`  ${L.doctor.thresholdPass(min)}\n`);
+    else if (!levelOk) line = c.red(`  ${L.doctor.thresholdFail(min, now)}\n`);
+    else line = c.red(`  ${L.doctor.thresholdGateFail(min, now, failedNames)}\n`);
+    console.log(line);
     process.exit(pass ? 0 : 1);
   }
   process.exit(missing || reached < 0 || gateFailed ? 1 : 0);

package/tool/commands/gates.mjs

@@ -44,7 +44,13 @@ async function installGate(slug, man, facts) {
   let cmd = picked
     .replace(/\{gate\}/g, `${PROJECT_GATES}/${slug}`)
     .replace(/\{dir\}/g, ".");
-  if (!cmd) die(L.add.noRecipe(slug, [...facts.langs].join("/") || L.add.thisStack));
+  // Отказ, а не смерть. `add` ставит одну запись — там смерть уместна и остаётся в вызывающем.
+  // `start` ставит пачку, и падение на одной записи оставляло проект с тремя сторожами вместо
+  // двенадцати, без единого слова про остальные девять. Найдено прогоном на Windows: там нет
+  // ни `ruff`, ни `vulture`, и установка обрывалась на записи `dead-code`, которой нужен
+  // настоящий инструмент. Отсутствие сигнала неотличимо от успеха — здесь оно было внутри
+  // самой установки.
+  if (!cmd) return { rec, cmd: null, copied, declared: false, why: null, noRecipe: true };
 
   // Родной инструмент не знает про наши образцы и выдаёт их как находки — в любом проекте,
   // куда поставили гейты. Заворачиваем его в общий фильтр. Переносимая проверка фильтрует
@@ -81,7 +87,8 @@ async function cmdAdd(args) {
     console.log(c.dim(`  ${L.add.installAnyway}\n`));
   }
 
-  const { cmd, copied, declared, why } = await installGate(slug, man, facts);
+  const { cmd, copied, declared, why, noRecipe } = await installGate(slug, man, facts);
+  if (noRecipe) die(L.add.noRecipe(slug, [...facts.langs].join("/") || L.add.thisStack));
 
   console.log(c.bold(`\naqk add ${slug}\n`));
   console.log(`  ${c.green("✔")}  ${PROJECT_GATES}/${slug}/  ${c.dim(L.add.copied(copied.length))}`);

package/tool/commands/project.mjs

@@ -6,8 +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,
-} from "../lib/core.mjs";
+  copyDir, writeIfAbsent, FEEDBACK_MARK, docPath } from "../lib/core.mjs";
 import { AGENTS_MD, CLAUDE_MD, MANIFEST_YML } from "../lib/templates.mjs";
 import { readManifest } from "../lib/manifest.mjs";
 import { detectFacts, readCatalog, triggerVerdict } from "../lib/repo.mjs";
@@ -199,7 +198,7 @@ async function cmdBlob() {
   await walk(dir);
 
   for (const full of found) {
-    out += `\n\n${"=".repeat(78)}\n<!-- ${L.blob.source(relative(PKG_ROOT, full))} -->\n${"=".repeat(78)}\n\n`;
+    out += `\n\n${"=".repeat(78)}\n<!-- ${L.blob.source(docPath(PKG_ROOT, full))} -->\n${"=".repeat(78)}\n\n`;
     // Ссылки на соседние файлы в склейке ведут в никуда: соседей рядом больше нет,
     // все они внутри этого же текста. Оставляем подпись, снимаем разметку.
     const body = (await readFile(full, "utf8")).replace(
@@ -268,7 +267,11 @@ async function cmdStart(args) {
       if (declared.has(rec.slug)) continue;
       const v = triggerVerdict(rec, facts0);
       if (!v.applies) { skipped.push([rec.slug, v.why]); continue; }
-      const { cmd } = await installGate(rec.slug, man, facts0);
+      const { cmd, noRecipe } = await installGate(rec.slug, man, facts0);
+      // Записи, которой нужен инструмент, а его на машине нет, здесь не место — но и вся
+      // установка из-за неё останавливаться не должна. Причина называется вслух и попадает
+      // в тот же список пропущенного, что и записи, не подошедшие по триггеру.
+      if (noRecipe) { skipped.push([rec.slug, L.start.noRecipeHere]); declared.add(rec.slug); continue; }
       put.push([rec.slug, cmd, rec.intent || ""]);
       declared.add(rec.slug);
       added++;

package/tool/commands/report.mjs

@@ -15,7 +15,7 @@
 
 import { mkdir, writeFile, readdir, readFile } from "node:fs/promises";
 import { join, relative } from "node:path";
-import { CWD, TARGET_DIR, SELF, c, exists } from "../lib/core.mjs";
+import { CWD, TARGET_DIR, SELF, c, exists, docPath } from "../lib/core.mjs";
 import { readManifest, assessLevel } from "../lib/manifest.mjs";
 import { detectFacts, readCatalog, triggerVerdict, whichSync } from "../lib/repo.mjs";
 import { runGates, declaredGates } from "./doctor.mjs";
@@ -59,7 +59,7 @@ async function findDoc(name) {
     for (const e of entries.sort((a, b) => a.name.localeCompare(b.name))) {
       const full = join(dir, e.name);
       if (e.isDirectory()) { const hit = await walk(full); if (hit) return hit; }
-      else if (e.name === name) return relative(CWD, full);
+      else if (e.name === name) return docPath(CWD, full);
     }
     return null;
   };

package/tool/i18n/en.mjs

@@ -73,8 +73,44 @@ export const en = {
     declaredNotRun: (n) => `${n} gates declared, but never run.`,
     declaredNotRunWhy: (cmd) => ` "declared" and "works" are different claims: ${cmd}`,
 
+    manifestUnknown: (keys) =>
+      `The manifest has fields the standard does not know: ${keys.join(", ")}. Looks like a typo — ` +
+      `such a field is silently read as absent, and the verdict comes out wrong.`,
+    manifestKnown: (keys) => `Manifest fields: ${keys.join(", ")}`,
     thresholdPass: (min) => `Threshold AQK-${min} passed.`,
     thresholdFail: (min, now) => `Threshold AQK-${min} NOT passed: currently AQK-${now}.`,
+    thresholdGateFail: (min, now, names) =>
+      `Threshold AQK-${min} passed (currently AQK-${now}), but a gate failed: ${names.join(", ")}.`,
+  },
+
+  baseline: {
+    heading: "The minimum a project needs",
+    intro: (checked, total) =>
+      `a machine confirms ${checked} of ${total} points; the rest are for your eyes, in the guide`,
+    eyes: (n, path) => `${n} points a machine cannot check — they live in ${path}`,
+    caveat: "presence is what gets checked, not whether it works: \"a linter is configured\" and \"a linter catches things\" are different claims",
+    by: (b) =>
+      "proven by: " +
+      ({ gate: `gate ${b.value}`, fact: `repository scan: ${b.value}`,
+         manifest: `field ${b.value} in the manifest`, dep: `dependency ${b.value}`,
+         file: b.value }[b.kind] || b.value),
+    none: "no conventional marker — check by eye, it may be done another way",
+    titles: {
+      oneCommand: "one command brings the whole project up",
+      lockfile: "exact versions pinned in a lockfile",
+      sameEnv: "the environment is the same for everyone and in CI",
+      formatter: "formatting is uniform and applied automatically",
+      linter: "a linter is configured",
+      types: "type checking exists",
+      secretScan: "secret scanning",
+      fileSize: "a file size limit",
+      ownInvariants: "the project's own invariants",
+      tests: "arbiters of correctness: tests exist",
+      pipeline: "a pipeline exists",
+      errorTracker: "errors are collected separately from logs",
+      machineReadable: "the project is machine-readable",
+      rulesInRepo: "rules live in the repository and are versioned",
+    },
   },
 
   trigger: {
@@ -91,6 +127,7 @@ export const en = {
       has_deps: ["no dependency file in sight", "dependencies are declared"],
       has_tests: ["no tests in sight", "tests exist"],
       has_env: ["no environment file", "an environment file exists"],
+      has_ui: ["no stylesheets or UI components in sight", "a UI exists: stylesheets or components"],
     },
   },
 
@@ -299,6 +336,7 @@ export const en = {
   },
 
   start: {
+    noRecipeHere: "needs a tool that is not on this machine",
     initFailed: (cmd) => `Could not lay out the kit. Start with ${cmd}`,
     tooManyFiles: (n) => `This repository already has ${n} code files — that is a different scenario.`,
     useDoctor: (cmd) => `${cmd} will inspect what is here and split the entries into three lists:`,

package/tool/i18n/ru.mjs

@@ -74,8 +74,49 @@ export const ru = {
     declaredNotRun: (n) => `${n} гейтов объявлено, но не запускалось.`,
     declaredNotRunWhy: (cmd) => ` «Объявлен» и «работает» — разные утверждения: ${cmd}`,
 
+    manifestUnknown: (keys) =>
+      `В манифесте поля, которых стандарт не знает: ${keys.join(", ")}. Похоже на опечатку — ` +
+      `такое поле молча читается как отсутствующее, и вердикт выходит неверным.`,
+    manifestKnown: (keys) => `Поля манифеста: ${keys.join(", ")}`,
     thresholdPass: (min) => `Порог AQK-${min} пройден.`,
     thresholdFail: (min, now) => `Порог AQK-${min} НЕ пройден: сейчас AQK-${now}.`,
+    // Ступень взята, но прогон красный — это другое утверждение, и виновника называем сразу:
+    // иначе его ищут глазами выше по логу конвейера.
+    thresholdGateFail: (min, now, names) =>
+      `Порог AQK-${min} пройден (сейчас AQK-${now}), но упал гейт: ${names.join(", ")}.`,
+  },
+
+  baseline: {
+    heading: "Обязательный минимум проекта",
+    intro: (checked, total) =>
+      `машина подтверждает ${checked} пунктов из ${total}; остальные — глазами, по методичке`,
+    eyes: (n, path) => `${n} пунктов машина проверить не может — они в ${path}`,
+    caveat: "проверяется НАЛИЧИЕ признака, а не то, что он работает: «линтер настроен» и «линтер ловит» — разные утверждения",
+    by: (b) =>
+      "подтверждено: " +
+      ({ gate: `гейт ${b.value}`, fact: `осмотр репозитория: ${b.value}`,
+         manifest: `поле ${b.value} в манифесте`, dep: `зависимость ${b.value}`,
+         file: b.value }[b.kind] || b.value),
+    // «Не найдено» и «нет» — разные утверждения. Признак ищется по общепринятым именам; проект
+    // может делать то же самое своим способом, и тогда пункт остаётся человеку, а не считается
+    // проваленным. Иначе прибор врёт на первом же нестандартном проекте — на нас самих и врал.
+    none: "общепринятого признака нет — проверь глазами, возможно сделано иначе",
+    titles: {
+      oneCommand: "одна команда поднимает проект целиком",
+      lockfile: "точные версии записаны в файл-замок",
+      sameEnv: "среда одинакова у всех и в конвейере",
+      formatter: "форматирование единое и применяется автоматически",
+      linter: "линтер настроен",
+      types: "проверка типов есть",
+      secretScan: "поиск секретов",
+      fileSize: "ограничение размера файла",
+      ownInvariants: "свои инварианты проекта",
+      tests: "арбитры правильности: тесты есть",
+      pipeline: "конвейер есть",
+      errorTracker: "ошибки собираются отдельно от логов",
+      machineReadable: "проект читается машиной",
+      rulesInRepo: "правила живут в репозитории и версионируются",
+    },
   },
 
   trigger: {
@@ -92,6 +133,7 @@ export const ru = {
       has_deps: ["не видно файла зависимостей", "зависимости объявлены"],
       has_tests: ["не видно тестов", "тесты есть"],
       has_env: ["нет файла окружения", "файл окружения есть"],
+      has_ui: ["не видно стилей и компонентов интерфейса", "интерфейс есть: стили или компоненты"],
     },
   },
 
@@ -300,6 +342,7 @@ export const ru = {
   },
 
   start: {
+    noRecipeHere: "нужен инструмент, которого нет на этой машине",
     initFailed: (cmd) => `Не получилось разложить комплект. Начни с ${cmd}`,
     tooManyFiles: (n) => `В репозитории уже ${n} файлов кода — это другой сценарий.`,
     useDoctor: (cmd) => `${cmd} осмотрит, что есть, и разделит записи на три списка:`,