agent-quality-kit 0.8.0 → 0.9.0

package/tool/commands/vitals.mjs

@@ -0,0 +1,159 @@
+// tool/commands/vitals.mjs — «всё ли у самого комплекта подключено».
+//
+// ЗАЧЕМ ОТДЕЛЬНАЯ КОМАНДА. `doctor` смотрит на РЕПОЗИТОРИЙ, `prove` — на гейты, `context` —
+// на состояние. На саму обвязку не смотрит никто: стоят ли инструменты, которых требуют
+// объявленные гейты; прописан ли хук в `.git/hooks` НА САМОМ ДЕЛЕ, а не только в конфиге;
+// получает ли агент состояние. Сегодня это выясняется красным гейтом посреди коммита — в
+// худший момент из возможных, когда человек занят другим и просто выключит проверку.
+//
+// ЧЕТЫРЕ СОСТОЯНИЯ, А НЕ ДВА, И КАЖДОЕ ЗАРАБОТАНО.
+//   ✔  подключено;
+//   ✘  СЛОМАНО — объявленный гейт не состоится: нет инструмента, потеряна строка манифеста;
+//   ·  не подключено, и это выбор — хука pre-commit нет, потому что гоняют в конвейере;
+//   ~  посмотреть не смогли.
+//
+// Первая версия ставила `✘` хуку, которого нет. На нашем же репозитории вышло два креста за
+// сознательное решение: pre-commit локально мы не ставим, проверки идут в CI. Команда, которая
+// кричит «сломано» про выбор, — ровно та, которую выключают в первый день, и вместе с ней
+// перестают читать настоящие отказы. Кода возврата касается только `✘`.
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { CWD, MANIFEST, SELF, c, exists } from "../lib/core.mjs";
+import { readManifest, unparsedLines, gateRequires } from "../lib/manifest.mjs";
+import { whichSync } from "../lib/repo.mjs";
+import { updateWanted } from "../lib/brief.mjs";
+import { L } from "../i18n/index.mjs";
+
+// Чистая функция: на входе факты, на выходе строки. Отделена от чтения диска намеренно —
+// «неизвестно» проверяется перебором случаев, а не прогоном, потому что случай «не смогли
+// посмотреть» на исправной машине не воспроизвести.
+function vitalsRows(f) {
+  const t = L.vitals;
+  const missing = (f.tools || []).filter((x) => !x.found);
+  const rows = [
+    {
+      key: "tools",
+      ok: (f.tools || []).length === 0 ? null : missing.length === 0,
+      detail: missing.length
+        ? t.toolsMissing(missing.map((x) => `${x.prog} (${x.gate})`).join(", "))
+        : t.toolsOk((f.tools || []).length),
+    },
+    {
+      key: "manifest",
+      ok: f.unparsed > 0 ? false : true,
+      detail: f.unparsed > 0 ? t.manifestBad(f.unparsed) : t.manifestOk,
+    },
+    {
+      key: "preCommit",
+      ok: f.preCommit === null ? null : f.preCommit ? true : "no",
+      detail: f.preCommit === null ? t.unknownHook : f.preCommit ? t.preCommitOk : t.preCommitNo,
+    },
+    {
+      key: "sessionHook",
+      ok: f.sessionHook === null ? null : f.sessionHook ? true : "no",
+      detail: f.sessionHook === null ? t.unknownHook : f.sessionHook ? t.sessionOk : t.sessionNo(`${SELF} context --install`),
+    },
+  ];
+  // Устаревшая версия — не отказ: человек мог закрепить её сознательно, и ронять за это нельзя.
+  if (f.version) {
+    rows.push({
+      key: "version",
+      ok: null,
+      detail: f.version.latest && f.version.latest !== f.version.current
+        ? t.versionOld(f.version.latest, f.version.current)
+        : t.versionOk(f.version.current),
+    });
+  }
+  return rows;
+}
+
+function vitalsVerdict(rows) {
+  return rows.some((r) => r.ok === false) ? 1 : 0;
+}
+
+// Первое слово команды — та программа, без которой гейт не состоится. Обёртки снимаются:
+// `bash x.sh` требует bash, а не x.sh; `npx --yes knip@6` требует npx.
+function progOf(cmd) {
+  const parts = String(cmd || "").trim().split(/\s+/);
+  return parts[0] || "";
+}
+
+async function cmdVitals() {
+  const man = await readManifest();
+  const gates = man?.gates && typeof man.gates === "object" && !Array.isArray(man.gates) ? man.gates : {};
+
+  const seen = new Map();
+  for (const [gate, cmd] of Object.entries(gates)) {
+    const prog = progOf(cmd);
+    if (!prog || seen.has(prog)) continue;
+    seen.set(prog, { gate, prog, found: Boolean(whichSync(prog)) });
+  }
+
+  // Первого слова мало. Запись каталога бывает обёрткой: команда начинается с `bash`, который
+  // есть всегда, а работать без `slopcheck` или `zizmor` она не может — и `doctor --run`
+  // краснеет там, где `vitals` печатал «все инструменты на месте». Ровно тот разрыв, ради
+  // закрытия которого эта команда и заведена. Программа названа в `requires:` записи.
+  // Найдено 2026-09-09 сверкой вывода двух команд на одном репозитории.
+  const samplesDir = typeof man?.samples === "string" ? man.samples.trim() : "";
+  for (const gate of Object.keys(gates)) {
+    const missing = await gateRequires(samplesDir, gate, whichSync);
+    for (const prog of missing || []) {
+      if (seen.has(prog)) continue;
+      seen.set(prog, { gate, prog, found: false });
+    }
+  }
+
+  let unparsed = 0;
+  try { unparsed = unparsedLines(await readFile(join(CWD, MANIFEST), "utf8")).length; } catch { /* манифеста нет */ }
+
+  // Хук 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; }
+    }
+  }
+
+  let sessionHook = null;
+  const settings = join(CWD, ".claude", "settings.json");
+  if (await exists(join(CWD, ".claude"))) {
+    sessionHook = false;
+    if (await exists(settings)) {
+      try {
+        const s = JSON.parse(await readFile(settings, "utf8"));
+        sessionHook = JSON.stringify(s?.hooks?.SessionStart || []).includes("context");
+      } catch { sessionHook = null; }
+    }
+  }
+
+  let version = null;
+  if (updateWanted()) {
+    try {
+      const { PKG_ROOT } = await import("../lib/core.mjs");
+      const 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 { /* сети нет — строку про версию просто не покажем */ }
+  }
+
+  const rows = vitalsRows({ tools: [...seen.values()], unparsed, preCommit, sessionHook, version });
+  console.log(c.bold(`\n  ${L.vitals.title}\n`));
+  for (const r of rows) {
+    const mark = r.ok === true ? c.green("✔")
+      : r.ok === false ? c.red("✘")
+      : r.ok === "no" ? c.yellow("·")
+      : c.dim("~");
+    console.log(`  ${mark}  ${L.vitals.names[r.key].padEnd(22)} ${r.ok === false ? r.detail : c.dim(r.detail)}`);
+  }
+  console.log("");
+  process.exit(vitalsVerdict(rows));
+}
+
+export { cmdVitals, vitalsRows, vitalsVerdict };

package/tool/i18n/en-docs.mjs

@@ -7,6 +7,46 @@
 // the second for one second in a terminal.
 
 const enDocs = {
+  // Блок vitals переехал сюда 2026-09-09 по той же причине, что и brief: терминальный
+  // каталог снова перерос 500 строк, и поймал это наш же file-size-limit.
+  vitals: {
+    title: "Is what the kit runs on actually wired up",
+    names: {
+      tools: "gate tools",
+      manifest: "manifest parsed",
+      preCommit: "pre-commit hook",
+      sessionHook: "state to the agent",
+      version: "version",
+    vitals: "is what the kit runs on wired up: tools, hooks, freshness",
+    },
+    toolsOk: (n) => `all ${n} present`,
+    toolsMissing: (l) => `NOT FOUND: ${l} — those gates will not happen`,
+    manifestOk: "parsed in full",
+    manifestBad: (n) => `${n} lines were not parsed and HAVE NO EFFECT — details in doctor`,
+    unknownHook: "could not look — unknown, not \"no\"",
+    preCommitOk: "wired in .git/hooks",
+    preCommitNo: "not in .git/hooks: a config entry is an intent, not a guard",
+    sessionOk: "the SessionStart hook hands the state to the agent",
+    sessionNo: (cmd) => `the agent gets no state: ${cmd}`,
+    versionOk: (v) => `${v}, current`,
+    versionOld: (l, cur) => `${l} is out, you have ${cur}`,
+  },
+  // Блок краткого вывода переехал сюда 2026-09-09: терминальный каталог снова перерос
+  // 500 строк, и поймал это наш же file-size-limit. Шов по смыслу условен — это всё-таки
+  // терминал, — но предел настоящий, а делить пополам хуже, чем делить по соседству.
+  brief: {
+    name: "AQK",
+    held: (n) => `holds ${n}`,
+    todo: (n) => `not installed ${n}`,
+    levelUnknown: "level unknown",
+    red: (l) => `     RED: ${l}`,
+    advise: (slug, why) => `     ↑ install: ${slug} — ${why}`,
+    adviseOff: (cmd, env) => `       not needed: ${cmd}, or ${env}`,
+    update: (l, c, how) => `version ${l} is out, you have ${c} — update: ${how}`,
+    updateHow: "npx agent-quality-kit@latest, or npm i -g agent-quality-kit",
+    updateHookHow: "pre-commit autoupdate",
+    updateOff: (env) => `       not needed: ${env}`,
+  },
   // THE STATE BLOCK — the one text of ours whose reader is a machine, not a person.
   // It goes into the agent's context via a SessionStart hook, so it is written as claims of
   // fact: no politeness, no preamble, every line either a fact or an honest "unknown".

package/tool/i18n/en.mjs

@@ -44,6 +44,7 @@ export const en = {
     contextInstall: "the same in full — the map and the rulebook — installed as a hook",
     report: "the mandatory report form: what is in place, what is not, what was not read; --since <ref> adds what proves the diff",
     badge: "a level badge for your README — and a check that it does not lie",
+    version: "the banner and the version number — same as --version and -v",
     noInstall: "Without installing:  npx agent-quality-kit init",
     language: "Output language: AQK_LANG=ru (or en), otherwise your system locale",
   },
@@ -87,6 +88,16 @@ export const en = {
     hasThings: "has",
     install: (cmd) => `install: ${cmd}`,
     notApplicable: (n) => `Not applicable to this repository (${n}):`,
+    noBrowserServer:
+      "this project has a UI, and the agent has no browser: it cannot look at its own change\n  and judges the work by what compiled. Those are different claims.",
+    noBrowserServerHow: (l) => `add an MCP server — works with any agent: ${l}`,
+    coveredBy: (n) => `held by another arbiter: ${n} — the portable entry is not needed`,
+    coveredByGate: (g) => `held by "${g}", declared in the manifest`,
+    coversUnknown: (l) => `covers names a gate absent from gates: ${l} — those entries are held by nothing`,
+    coversUnproven: (e, g, codes) =>
+      `claim unverified: "${e}" is declared held by gate "${g}", but neither its command nor the\n  linter config names rules ${codes} — the entry may be held by nothing`,
+    coversUnprovenHow: (cmd) => `settle it: add those rules to the linter, or install the entry — ${cmd}`,
+    totalCovered: (n) => `held by another arbiter ${n}`,
     total: "Total:",
     totalHeld: (n) => `held by a machine ${n}`,
     totalTodo: (n) => `applicable but not installed ${n}`,
@@ -96,6 +107,7 @@ export const en = {
     sinceBadRef: (ref) => `cannot compare against "${ref}": no such ref, or this is not a git repository`,
     notScopable: "output carries no paths — cannot be narrowed by diff, left red",
     outsideDiff: (n) => `findings exist, but outside the diff (${n})`,
+    advisoryQuiet: "(advisory — cannot fail the run)",
     advisoryMark: "advisory — shown, the run was not failed",
     advisorySummary: (names) =>
       `advisory and red: ${names.join(", ")}. These are switched-off checks: ` +
@@ -110,6 +122,9 @@ export const en = {
     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.`,
+    manifestUnparsed: (n, t) => `manifest line ${n} was not parsed and HAS NO EFFECT: ${t}`,
+    manifestUnparsedWhy:
+      "field and gate names use latin letters, digits, dash and underscore. What is declared here\n  does not run at all — while looking as if it does.",
     manifestKnown: (keys) => `Manifest fields: ${keys.join(", ")}`,
     thresholdPass: (min) => `Threshold AQK-${min} passed.`,
     thresholdFail: (min, now) => `Threshold AQK-${min} NOT passed: currently AQK-${now}.`,
@@ -164,6 +179,7 @@ export const en = {
       has_agent_config: ["the agent was never configured here", "agent settings exist"],
       has_agent_entry: ["no entry point for an agent here", "an entry point for an agent exists"],
       has_ui: ["no stylesheets or UI components in sight", "a UI exists: stylesheets or components"],
+      has_mcp: ["no MCP tools are wired up for the agent here", "MCP servers are declared"],
     },
   },
 
@@ -367,6 +383,7 @@ export const en = {
     title: "If this was useful:",
     star: (url) => `Star it — ${url}`,
     issue: "Found a bug or it did not fit — open an issue; both are the most useful feedback there is.",
+    notRemembered: "could not remember this (home is not writable) — the message will appear again",
     once: "This message is shown once: it will not appear again on this machine.",
   },
 
@@ -448,6 +465,7 @@ export const en = {
     noTarget: "no place to substitute the sample directory — the command was written by hand",
     otherRecipe: (lang) => `the samples are written for the "${lang}" recipe, another one is installed — nothing to prove with`,
     noGates: "no gates declared — nothing to prove",
+    needsProgram: (progs) => `NOT CHECKED here — needs "${progs}"`,
     noSamplesDir: "the samples field in .aqk.yml is empty — nowhere to look for samples",
     nothingProven:
       "not a single gate is proven. A level above AQK-1 would mean trust in the author, not a fact:\n  a project whose gate is `true` would pass it exactly like a project with real protection.",

package/tool/i18n/index.mjs

@@ -11,23 +11,56 @@
 // хуже и расходятся молча. Каталоги лежат отдельно, и модульная проверка сверяет, что в них
 // одни и те же ключи: «поддерживаем два языка» — утверждение, которое обязана держать машина.
 
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
 import { ru } from "./ru.mjs";
 import { en } from "./en.mjs";
 
 // Порядок: явная переменная окружения → системная локаль → английский. Английский последним
 // потому, что незнакомый язык интерфейса — это препятствие, а незнакомый английский в 2026-м
 // препятствие меньшее, чем незнакомая кириллица.
-function pickLang(env = process.env) {
+// Порядок: переменная окружения → ПОЛЕ МАНИФЕСТА → системная локаль → английский.
+//
+// Поле манифеста добавлено 2026-09-08 по просьбе первого чужого пользователя: «язык берётся из
+// LC_ALL/LANG, а на Windows их просто нет: русский проект получает английский вывод. AQK_LANG=ru
+// чинит, но у следующего человека будет своё». Он прав: язык репозитория — свойство репозитория,
+// а локаль — свойство машины, на которой его сегодня открыли.
+//
+// Переменная окружения оставлена ВЫШЕ манифеста намеренно: человек, набравший AQK_LANG=en
+// руками, хочет английский именно сейчас, и спорить с ним манифестом значит отнять у него
+// последнее средство. Манифест выше локали — он про проект, локаль про машину.
+function pickLang(env = process.env, man = null) {
   const forced = String(env.AQK_LANG || "").toLowerCase();
   if (forced.startsWith("ru")) return "ru";
   if (forced.startsWith("en")) return "en";
+  const declared = String(man?.lang || "").toLowerCase();
+  if (declared.startsWith("ru")) return "ru";
+  if (declared.startsWith("en")) return "en";
   const locale = String(env.LC_ALL || env.LC_MESSAGES || env.LANG || "").toLowerCase();
   if (locale.startsWith("ru")) return "ru";
   return "en";
 }
 
+// Язык читается СИНХРОННО и одним полем: каталог строк нужен раньше, чем что-либо успеет
+// прочитать манифест целиком, а полный разбор отсюда звать нельзя — manifest.mjs сам берёт
+// строки здесь, и вышло бы кольцо. Чтобы этот сокращённый разбор не разошёлся с настоящим,
+// модульная проверка сверяет их ответы на одном и том же тексте.
+function langFromText(text) {
+  const m = String(text).match(/^lang:[ \t]*["']?([A-Za-z][A-Za-z-]*)/m);
+  return m ? m[1] : "";
+}
+
+function manifestLang(cwd = process.cwd()) {
+  try {
+    return { lang: langFromText(readFileSync(join(cwd, ".aqk.yml"), "utf8")) };
+  } catch {
+    // Манифеста нет или он нечитаем — не повод падать: язык просто выберется дальше по порядку.
+    return null;
+  }
+}
+
 const CATALOGS = { ru, en };
-const LANG = pickLang();
+const LANG = pickLang(process.env, manifestLang());
 const L = CATALOGS[LANG];
 
-export { L, LANG, pickLang, CATALOGS };
+export { L, LANG, pickLang, langFromText, CATALOGS };

package/tool/i18n/ru-docs.mjs

@@ -7,6 +7,46 @@
 // вторые — он же в терминале, одну секунду.
 
 const ruDocs = {
+  // Блок vitals переехал сюда 2026-09-09 по той же причине, что и brief: терминальный
+  // каталог снова перерос 500 строк, и поймал это наш же file-size-limit.
+  vitals: {
+    title: "Подключено ли то, чем комплект работает",
+    names: {
+      tools: "инструменты гейтов",
+      manifest: "манифест разобран",
+      preCommit: "хук pre-commit",
+      sessionHook: "состояние агенту",
+      version: "версия",
+    vitals: "подключено ли то, чем комплект работает: инструменты, хуки, свежесть",
+    },
+    toolsOk: (n) => `все ${n} на месте`,
+    toolsMissing: (l) => `НЕ НАЙДЕНЫ: ${l} — эти гейты не состоятся`,
+    manifestOk: "разобран целиком",
+    manifestBad: (n) => `${n} строк не разобраны и НЕ ДЕЙСТВУЮТ — подробности в doctor`,
+    unknownHook: "посмотреть не смогли — неизвестно, а не «нет»",
+    preCommitOk: "прописан в .git/hooks",
+    preCommitNo: "в .git/hooks его нет: запись в конфиге — намерение, а не защита",
+    sessionOk: "хук SessionStart отдаёт состояние агенту",
+    sessionNo: (cmd) => `агент не получает состояние: ${cmd}`,
+    versionOk: (v) => `${v}, свежая`,
+    versionOld: (l, cur) => `есть ${l}, у вас ${cur}`,
+  },
+  // Блок краткого вывода переехал сюда 2026-09-09: терминальный каталог снова перерос
+  // 500 строк, и поймал это наш же file-size-limit. Шов по смыслу условен — это всё-таки
+  // терминал, — но предел настоящий, а делить пополам хуже, чем делить по соседству.
+  brief: {
+    name: "AQK",
+    held: (n) => `держит ${n}`,
+    todo: (n) => `не поставлено ${n}`,
+    levelUnknown: "уровень неизвестен",
+    red: (l) => `     КРАСНЫЕ: ${l}`,
+    advise: (slug, why) => `     ↑ поставить: ${slug} — ${why}`,
+    adviseOff: (cmd, env) => `       не нужно: ${cmd}, либо ${env}`,
+    update: (l, c, how) => `новая версия ${l}, у вас ${c} — обновить: ${how}`,
+    updateHow: "npx agent-quality-kit@latest, либо npm i -g agent-quality-kit",
+    updateHookHow: "pre-commit autoupdate",
+    updateOff: (env) => `       не нужно: ${env}`,
+  },
   // БЛОК СОСТОЯНИЯ — единственный наш текст, у которого читатель машина, а не человек.
   // Уходит в контекст агента хуком SessionStart, поэтому пишется как утверждения о факте:
   // без вежливости, без вводных, каждая строка либо факт, либо честное «неизвестно».

package/tool/i18n/ru.mjs

@@ -45,6 +45,7 @@ export const ru = {
     contextInstall: "то же самое, но целиком — карта и свод правил — и хуком в контекст",
     report: "обязательная форма отчёта: что стоит, что нет, что не прочитано; --since <ссылка> — ещё и чем доказан диф",
     badge: "значок уровня для README — и проверка, что он не врёт",
+    version: "заставка и номер версии — то же по --version и -v",
     noInstall: "Без установки:  npx agent-quality-kit init",
     language: "Язык вывода: AQK_LANG=en (или ru), иначе по системной локали",
   },
@@ -88,6 +89,16 @@ export const ru = {
     hasThings: "есть",
     install: (cmd) => `поставить: ${cmd}`,
     notApplicable: (n) => `Не применимо к этому репозиторию (${n}):`,
+    noBrowserServer:
+      "у проекта есть интерфейс, а у агента нет браузера: посмотреть на своё изменение глазами\n  он не может и судит о работе по тому, что собралось. Это разные утверждения.",
+    noBrowserServerHow: (l) => `подключается MCP-сервером, любым агентом: ${l}`,
+    coveredBy: (n) => `закрыто другим арбитром: ${n} — переносимую запись ставить незачем`,
+    coveredByGate: (g) => `держит «${g}», объявленный в манифесте`,
+    coversUnknown: (l) => `covers называет гейт, которого нет в gates: ${l} — эти записи не закрыты ничем`,
+    coversUnproven: (e, g, codes) =>
+      `заявка не подтверждена: «${e}» объявлена закрытой гейтом «${g}», но ни его команда, ни\n  конфиг линтера не называют правил ${codes} — запись может быть не закрыта ничем`,
+    coversUnprovenHow: (cmd) => `подтверди: добавь эти правила в линтер, либо поставь запись — ${cmd}`,
+    totalCovered: (n) => `закрыто другим арбитром ${n}`,
     total: "Итого:",
     totalHeld: (n) => `держит машина ${n}`,
     totalTodo: (n) => `применимо но не поставлено ${n}`,
@@ -97,6 +108,7 @@ export const ru = {
     sinceBadRef: (ref) => `не могу сравнить с «${ref}»: такой ссылки нет или это не репозиторий git`,
     notScopable: "вывод без путей — дифом не сужается, оставлен красным",
     outsideDiff: (n) => `находки есть, но вне дифа (${n})`,
+    advisoryQuiet: "(совещательный — уронить прогон не может)",
     advisoryMark: "совещательный — показано, прогон не уронен",
     advisorySummary: (names) =>
       `совещательные и красные: ${names.join(", ")}. Это выключенные проверки: ` +
@@ -111,6 +123,9 @@ export const ru = {
     manifestUnknown: (keys) =>
       `В манифесте поля, которых стандарт не знает: ${keys.join(", ")}. Похоже на опечатку — ` +
       `такое поле молча читается как отсутствующее, и вердикт выходит неверным.`,
+    manifestUnparsed: (n, t) => `строка ${n} манифеста не разобрана и НЕ ДЕЙСТВУЕТ: ${t}`,
+    manifestUnparsedWhy:
+      "имена полей и гейтов пишутся латиницей, цифрами, дефисом и подчёркиванием. Объявленное\n  здесь не выполняется вовсе — а выглядит так, будто выполняется.",
     manifestKnown: (keys) => `Поля манифеста: ${keys.join(", ")}`,
     thresholdPass: (min) => `Порог AQK-${min} пройден.`,
     thresholdFail: (min, now) => `Порог AQK-${min} НЕ пройден: сейчас AQK-${now}.`,
@@ -170,6 +185,7 @@ export const ru = {
       has_agent_config: ["агента здесь не настраивали", "настройки агента есть"],
       has_agent_entry: ["свода для агента здесь нет", "свод для агента есть"],
       has_ui: ["не видно стилей и компонентов интерфейса", "интерфейс есть: стили или компоненты"],
+      has_mcp: ["агенту здесь не подключали внешних инструментов через MCP", "MCP-серверы объявлены"],
     },
   },
 
@@ -373,6 +389,7 @@ export const ru = {
     title: "Если пригодилось:",
     star: (url) => `Поставь звезду — ${url}`,
     issue: "Нашёл баг или не подошло — заведи Issue, самая полезная обратная связь: и то и другое.",
+    notRemembered: "запомнить не удалось (дом недоступен для записи) — сообщение появится снова",
     once: "Это разовое сообщение: больше не покажется на этой машине.",
   },
 
@@ -454,6 +471,7 @@ export const ru = {
     noTarget: "не видно, куда подставить каталог образца — команда написана руками",
     otherRecipe: (lang) => `образцы написаны под рецепт «${lang}», а стоит другой — доказать нечем`,
     noGates: "гейтов не объявлено — доказывать нечего",
+    needsProgram: (progs) => `НЕ ПРОВЕРЕНА здесь — нужен «${progs}»`,
     noSamplesDir: "в .aqk.yml не заполнено поле samples — образцы искать негде",
     nothingProven:
       "ни один гейт не доказан. Уровень выше AQK-1 означал бы доверие к автору, а не факт:\n  проект с гейтом «true» прошёл бы его так же, как проект с настоящей защитой.",

package/tool/lib/banner.mjs

@@ -0,0 +1,59 @@
+// tool/lib/banner.mjs — заставка. Первая встреча человека с комплектом.
+//
+// ЗАЧЕМ ОНА ЕСТЬ. Жалоба владельца: «скачал и че дальше, не понятно, работает он вообще или
+// нет». Строка присутствия в прогоне отвечает на «работает ли», а заставка — на «что это
+// вообще такое»: она показывается там, где человек встречается с инструментом впервые.
+//
+// ПОКАЗЫВАЕТСЯ ДВАЖДЫ ЗА ВСЮ ЖИЗНЬ: при `init` и по `--version`. На каждой команде — нет:
+// то, что видишь тридцатый раз, перестаёт читаться, а рядом стоят находки, которые читать надо.
+//
+// РИСУНОК — СВОЙ. Готовые работы из чужих подборок красивы, но у них нет ни автора, ни
+// лицензии, а пакет уезжает в npm под MIT. Вставить чужое молча — сделать ровно то, за что мы
+// ругаем других. Этот прислан владельцем; надпись собрана шрифтом ANSI Shadow, к шрифтам
+// вопросов о правах нет.
+// Отступ у кошки ОДИН пробел, у букв — два, и это не опечатка. Пустой Брайль `⠀` занимает
+// место, но ничего не рисует: у рисунка видимая часть начинается со второго знака, и при
+// одинаковом отступе кошка выглядела сдвинутой вправо на целый знак. Центры сведены по
+// ВИДИМОЙ части, а не по началу строки.
+const ART = [
+  " ⠀⠀⠀⠀⢀⣾⢷⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣼⢧⡀",
+  " ⠀⠀⠀⠀⠀⢀⣾⠃⢘⣷⣀⣀⣤⣤⣤⣄⣀⢸⡏⠈⢷⡀",
+  " ⠀⠀⠀⠀⠀⣼⣷⣾⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣶⣬⣷",
+  " ⠀⠀⠀⠀⢰⣿⣿⣿⣿⠁⠸⠗⢹⣿⡟⠰⠷⠈⢻⣿⣿⣿⡇",
+  " ⠀⠀⢐⣒⣺⣿⣿⣿⣿⣀⠀⣀⣼⠛⢷⣄⠀⢀⣼⣿⣿⣿⣿⣉⡁",
+  " ⠀⠀⠀⠤⢺⣿⣿⣿⣿⣿⣿⣿⣿⡇⣿⣿⣿⣿⣿⣿⣿⣿⣿⠢",
+  "",
+  "   █████╗  ██████╗ ██╗  ██╗",
+  "  ██╔══██╗██╔═══██╗██║ ██╔╝",
+  "  ███████║██║   ██║█████╔╝",
+  "  ██╔══██║██║▄▄ ██║██╔═██╗",
+  "  ██║  ██║╚██████╔╝██║  ██╗",
+  "  ╚═╝  ╚═╝ ╚══▀▀═╝ ╚═╝  ╚═╝",
+];
+
+// Объявленная ширина сверяется с настоящей модульной проверкой: правка рисунка, разъехавшаяся
+// с этим числом, роняет её. Иначе число здесь через месяц врёт, как всякая цифра в комментарии.
+const BANNER_WIDTH = 27;
+
+// Терминал без UTF-8 превратит Брайль в вопросительные знаки, и человек решит, что инструмент
+// сломан. Тогда честнее короткая строка: она несёт то же самое, только буквами.
+function canDrawArt(env) {
+  if (String(env.AQK_NO_ART || "") === "1") return false;
+  const loc = `${env.LC_ALL || ""}${env.LC_CTYPE || ""}${env.LANG || ""}`.toLowerCase();
+  // Windows-терминалы локаль обычно не выставляют вовсе, а UTF-8 там с 2019 года есть.
+  // Поэтому пусто — рисуем; явно не-UTF-8 — не рисуем.
+  if (!loc) return true;
+  return loc.includes("utf-8") || loc.includes("utf8");
+}
+
+// ВЕРСИИ В ЗАСТАВКЕ НЕТ — решение владельца. Выпуски идут часто, и номер в картинке устаревает
+// быстрее всего остального; за версией есть `--version`, где она и печатается отдельной строкой.
+function banner(env = process.env) {
+  if (!canDrawArt(env)) return "  aqk — agent quality kit";
+  // Отступ подписи — шесть, а не три: он посчитан от ВИДИМОГО центра букв (со 2-го знака по
+  // 26-й, центр 14), а не подобран на глаз. Подобранный на глаз держался до первой правки
+  // рисунка; посчитанный переживёт её, а проверка ниже покажет, если разъедется.
+  return `${ART.join("\n")}\n      agent quality kit`;
+}
+
+export { banner, BANNER_WIDTH, canDrawArt };