agent-quality-kit 0.9.0 → 0.10.1

package/tool/i18n/ru-docs.mjs

@@ -29,6 +29,7 @@ const ruDocs = {
     sessionOk: "хук SessionStart отдаёт состояние агенту",
     sessionNo: (cmd) => `агент не получает состояние: ${cmd}`,
     versionOk: (v) => `${v}, свежая`,
+    versionUnknown: (v) => `${v}, до реестра не дозвонились — свежая ли, неизвестно`,
     versionOld: (l, cur) => `есть ${l}, у вас ${cur}`,
   },
   // Блок краткого вывода переехал сюда 2026-09-09: терминальный каталог снова перерос
@@ -68,6 +69,15 @@ const ruDocs = {
     runRed: (when, names) => `Последний прогон ${when} — КРАСНЫЕ: ${names}.`,
     andMore: (n) => `и ещё ${n}`,
     skipped: (n) => `Не запускались: ${n} — инструмента нет на этой машине, их состояние неизвестно.`,
+    probeNever: "Проба покрытия не делалась — что здесь не прикрыто ничем, НЕИЗВЕСТНО. Это не «прикрыто»: `aqk probe`.",
+    probeOff: "Проба покрытия выключена в манифесте (`probe: 0`) — что здесь не прикрыто ничем, никто не считает.",
+    probeUnknown: "Пробу покрытия провести не удалось — что здесь не прикрыто ничем, НЕИЗВЕСТНО. Это не «прикрыто».",
+    probeBlind: (n, behind) =>
+      `Не прикрыто ничем: ${n} классов брака в местах, куда чаще всего возвращаются с починкой` +
+      (behind ? ` (проба отстала на ${behind} коммитов)` : "") + ". Подробно: `aqk probe`.",
+    probeClean: (behind) =>
+      "Проба покрытия: в проверенных местах каждый применимый класс кто-то ловит" +
+      (behind ? ` (отстала на ${behind} коммитов)` : "") + ".",
     ratchets: (list) => `Храповики: ${list}. Список может только укорачиваться, увеличивать нельзя.`,
     where: (entry) => `Свод правил: ${entry}. Чем доказан диф: \`aqk report --since main\`.`,
     mapTitle: "ЧТО УМЕЕТ ЭТОТ ИНСТРУМЕНТ. Полный список команд — не пересказ, а тот же список,\nиз которого собрана справка:",

package/tool/i18n/ru-gates.mjs

@@ -0,0 +1,311 @@
+// tool/i18n/ru-gates.mjs — то, что программа говорит про ЗАПИСИ КАТАЛОГА: постановка,
+// заготовка, храповик, сверка по намерению, разбор отказа, доказательство, проба, значок.
+//
+// ПОЧЕМУ ОТДЕЛЬНЫМ ФАЙЛОМ. Не ради размера: делить пополам запрещает наш же гейт
+// `file-size-limit` («раздели по смыслу, а не пополам»). Здесь настоящий шов — команды про
+// РЕПОЗИТОРИЙ (осмотр, уровень, состояние, обвязка) и команды про ЗАПИСИ КАТАЛОГА живут разной
+// жизнью и правятся в разные дни. Разделено 2026-09-09, когда строки `probe` перевели файл
+// за собственный предел в 500 строк.
+export const ruGates = {
+  add: {
+    noSuchGate: (slug, cmd) => `Нет такого гейта: ${slug}\nСписок применимых — ${cmd}`,
+    toolMissing: (slug, missing) =>
+      `Записи ${slug} нужен ${missing.join(" и ")}, а его нет на этой машине.\n  почини: поставь ${missing.join(" и ")} и повтори — запись делегирует готовому инструменту по устройству, своей проверки у неё нет.`,
+    noRecipe: (slug, stack, missing) =>
+      `У записи ${slug} нет команды ни под ${stack}, ни общей.` +
+      (Array.isArray(missing) && missing.length
+        ? `\n  почини: поставь ${missing.join(" или ")} и повтори — запись делегирует готовому инструменту по устройству, своей проверки у неё нет.`
+        : `\n  почини: добавь рецепт под свой стек в gate.yml этой записи либо возьми другую.`),
+    thisStack: "этот стек",
+    needName: (cmd, doctor) => `Укажи имя гейта: ${cmd}. Список — ${doctor}`,
+    noManifest: (cmd) => `Нет .aqk.yml — сначала ${cmd}`,
+    notApplicable: (why) => `Этот гейт к репозиторию не применим: ${why}`,
+    installAnyway: "Ставлю всё равно — решение твоё, но сторожить ему нечего.",
+    copied: (n) => `${n} файлов: проверка и образцы`,
+    declared: (cmd) => `гейт объявлен: ${cmd}`,
+    notDeclared: (why, slug, cmd) => `не тронут (${why}). Впиши сам: ${slug}: "${cmd}"`,
+    nextTitle: "Дальше:",
+    next1: "Проверь, что он краснеет и молчит там, где должен:",
+    expectFail: "→ ожидается отказ",
+    expectSilence: "→ ожидается тишина",
+    next2: "Впиши команду в хук коммита и в конвейер.",
+    next2Why: "Гейт, который никто не запускает, — не гейт.",
+    next3: (cmd) => `Прогон всех объявленных: ${cmd}`,
+  },
+
+  gnew: {
+    needName: (cmd) => `Укажи имя: ${cmd}`,
+    badName: (slug) => `Имя «${slug}» не годится: латиница через дефис, например secrets-not-in-code.\nИмя читают в чужих проектах — оно часть словаря.`,
+    looksExisting: (slug) => `Похоже, такое уже есть: ${slug}`,
+    recipeNotGate: "Рецепт под другой стек — это строка в recipes существующей записи.",
+    forceHint: (cmd) => `Всё равно завести новую: ${cmd}`,
+    exists: (path) => `${path} уже существует.`,
+    nextTitle: "Дальше — по порядку:",
+    n1: "Проверь, нет ли готового правила",
+    n1Where: "в ruff, eslint, semgrep.",
+    n1Why: "Готовое точнее, подробнее и его поддерживают без тебя. Своя проверка — запасная.",
+    n2: "Положи образцы.",
+    n2Red: "— код, на котором проверка обязана сработать.",
+    n2Green: "— тот же код, но правильный.",
+    n2Why: "Зелёный важнее: он ловит проверку, которая краснеет на исправном коде.",
+    n3: "Напиши проверку",
+    n3Where: "в check.sh. В тексте отказа — что именно сделать.",
+    n4: "Заполни gate.yml:",
+    n4What: "намерение, триггер, доказательство отказом.",
+    n5: "Прогони:",
+    n5Why: "Арбитр обязан покраснеть на red/ и промолчать на green/. Не прошло — не запись.",
+  },
+
+  ratchet: {
+    needName: (cmd) => `Укажи гейт: ${cmd}. Он должен быть уже объявлен в .aqk.yml`,
+    noManifest: (cmd) => `Нет .aqk.yml — сначала ${cmd}`,
+    notDeclared: (slug, cmd) => `Гейт «${slug}» не объявлен в .aqk.yml. Сначала: ${cmd}`,
+    already: (slug) => `На гейте «${slug}» храповик уже стоит.`,
+    notRunnable: (slug, cmd) =>
+      `Гейт «${slug}» не запускается: ${cmd}\n` +
+      `Снимать долг с несуществующего сторожа нельзя — в реестр попадут его же сообщения\n` +
+      `об ошибке, и он станет разрешением. Сначала почини команду.`,
+    registryHead: (slug, stamp) =>
+      `# Реестр долга: ${slug}\n` +
+      `# Снят ${stamp}. Список разрешается ТОЛЬКО укорачивать.\n` +
+      `# Новое нарушение красит гейт; исправленное вычёркивается автоматически.\n` +
+      `#\n` +
+      `# Долг без цели и срока не кончается. Цель — сколько нарушений считать погашенным долгом;\n` +
+      `# по достижении храповик скажет убрать обёртку. Срок необязателен, но если он есть,\n` +
+      `# после этой даты непогашенный долг красит гейт — срок без последствия не срок.\n` +
+      `# aqk-goal: 0\n` +
+      `# aqk-deadline:\n`,
+    recorded: (n) => `${n} нарушений записано долгом`,
+    libCopied: "обёртка скопирована в проект",
+    wrapped: "команда завёрнута в храповик",
+    changesTitle: "Что это меняет:",
+    fromToday: "со дня установки",
+    changes1: (fromToday) => `Правило действует ${fromToday}. Старый код трогать не надо, но новое`,
+    changes2: "нарушение того же класса гейт не пропустит.",
+    test1: "Проверка, что это храповик, а не советчик: «может ли новый код добавить нарушение",
+    test2: "и пройти?» Может — значит гейта нет.",
+    run: (cmd) => `Прогнать: ${cmd}`,
+  },
+
+  find: {
+    needQuery: (cmd) => `Опиши намерение словами: ${cmd}`,
+    example: 'find "отладочная печать не доезжает до прода"',
+    exists: "Такое уже есть — новую запись заводить не надо:",
+    match: (pct) => `совпадение ${pct}%`,
+    recipes: (langs) => `рецепты: ${langs}общий`,
+    existsWhy1: "Если у тебя рецепт под другой стек — это строка в recipes существующей",
+    existsWhy2: "записи, а не новый гейт. Намерение одно, исполнителей может быть много.",
+    near: "Точного совпадения нет, но рядом лежит:",
+    nearWhy: "Прочитай их README. Если намерение то же — дополняй, а не заводи новое.",
+    none: "Такого намерения в каталоге нет.",
+    journal: "В журнале есть шишка на эту тему:",
+    journalWhy: "Шишка записана — значит доказательство для новой записи уже есть.",
+    howTitle: "Как добавить свой гейт:",
+    how1: "Назови отказ.",
+    how1What: "Какой конкретный брак он поймал в живом проекте, чего это стоило.",
+    how1Why: "«Это хорошая практика» не принимается: так каталог набирает сотни пунктов и умирает.",
+    how2: "Заведи папку",
+    how2What: "— gate.yml, red/, green/, README.md.",
+    how2Why: "Норма записи со всеми полями — kit/gates/README.md",
+    how3: "Проверь машиной:",
+    how3Why: "Арбитр обязан покраснеть на red/ и промолчать на green/. Не прошло — не запись.",
+    how4: "Пришли изменением",
+    how4What: "в репозиторий комплекта.",
+  },
+
+  why: {
+    needQuery: (cmd) => `Опиши, что пропустили: ${cmd}`,
+    example: 'why "файл вырос до девяти тысяч строк"',
+    ciAtOnce: "разом: doctor --run",
+    ciOwnStep: "отдельным шагом",
+    unsure: "Уверенного совпадения нет. Похоже на эти записи:",
+    unsureByName: (cmd) => `Назови запись именем: ${cmd}`,
+    unsureNone: (cmd) => `Ни одна не подходит — значит сторожа не было: ${cmd}`,
+    decideTitle: "Дальше решаешь ты:",
+    decideQ: "это твоя частность или общий случай?",
+    decideWhy: "Общий — идёт в каталог и достаётся всем. Частный — остаётся у тебя.",
+    decideNote: (cmd) => `Урок в общий журнал в любом случае: ${cmd}`,
+    fix: "Почини так:",
+    noGuard: "Сторожа не было.",
+    noGuardWhy: "В каталоге нет записи с таким намерением.",
+    noGuardFix: (cmd) => `заведи запись — ${cmd}`,
+    noGuardHint: "Красный образец бери прямо из этой поломки: она уже случилась, выдумывать нечего.",
+    closest: (slug, pct) => `Ближайшая запись каталога: ${slug}  совпадение ${pct}%`,
+    notInstalled: "Сторож есть в каталоге, но в этом проекте не поставлен.",
+    notInstalledHint1: "Он покраснеет на старом коде — это нормально: старое закрывается храповиком,",
+    notInstalledHint2: (cmd) => `новое ловится со дня установки. ${cmd}`,
+    declaredAs: (cmd) => `Объявлен: ${cmd}`,
+    notRunning: "Сторож объявлен, но не запускается.",
+    notRunningWhy: "Худший случай: тишина читается как успех.",
+    notRunningFix: "путь или программа из команды не существуют — проверь их.",
+    notRunningHint: "Отсутствие сигнала неотличимо от успеха, поэтому это не «мелочь в конфиге».",
+    bypassed: "Сторож есть и эту поломку ловит — значит его обошли.",
+    noCiFix: "конвейера нет. Проверка, которую гоняет только человек,",
+    noCiHint: "работает ровно до первого «забыл».",
+    notInCiFix: "конвейер есть, но этот гейт в нём не запускается.",
+    notInCiHint: (cmd) => `Дешевле всего одним шагом: ${cmd} — он гоняет всё объявленное.`,
+    inCiFix: (how) => `конвейер его гоняет (${how}) — значит красный прогон`,
+    inCiHint1: "кто-то пропустил или обошёл. Перенеси правило из текста в механику:",
+    inCiHint2: "блокирующий шаг, а не необязательный; запрет слияния при красном.",
+    blind: "Сторож есть, стоит и запускается — но этой поломки не видит.",
+    blindFix: (dir) => `положи в ${dir} кусок кода из этой поломки`,
+    blindHint1: "и доведи проверку до красного на нём. Порядок обратный привычному: сначала",
+    blindHint2: "образец, потом правка — иначе непонятно, что именно починено.",
+    blindCheck: "Проверить после правки: bash tool/selfcheck/gates.sh",
+  },
+
+  init: {
+    noDocs: (dir) => `Не найден корпус методичек: ${dir}\nПохоже, пакет установлен не полностью.`,
+    docsRu:
+      "методички в .aqk/docs/ остаются на русском — решение, а не недоделка.",
+    created: (n) => `создано (${n}):`,
+    andMore: (n) => `… и ещё ${n}`,
+    kept: (n) => `уже были на месте, не тронуты (${n}):`,
+    overwrite: (cmd) => `перезаписать: ${cmd}`,
+    nextTitle: "Что дальше — по порядку:",
+    n1a: "Открой",
+    n1b: "и заполни раздел «Команды». Команда, которую нельзя",
+    n1c: "скопировать и выполнить, — не команда, а пожелание.",
+    n2a: "Прочитай",
+    n2b: "— это обязательный минимум",
+    n2c: "проекта без привязки к языку. Пройди сверху вниз и отметь, чего нет.",
+    n3a: "Заполни",
+    n3b: "— гейты, образцы, журнал. Уровень соответствия AQK",
+    n3c: (cmd) => `считается по нему: ${cmd}.`,
+    n4a: "Поднимайся по ступеням",
+    n4b: "по одной",
+    n4c: ". Гейт стережёт существующий артефакт:",
+    n4d: "проверка на код, которого ещё нет, — мёртвое правило.",
+    burned: (cmd) => `Обжёгся на чём-то — запиши: ${cmd}`,
+    hookHint: (cmd) => `Claude Code: ${cmd} — состояние проекта будет попадать в контекст агента\n  само, до первого действия. Для других агентов хука нет, и это не недоделка.`,
+  },
+
+  feedback: {
+    title: "Если пригодилось:",
+    star: (url) => `Поставь звезду — ${url}`,
+    issue: "Нашёл баг или не подошло — заведи Issue, самая полезная обратная связь: и то и другое.",
+    notRemembered: "запомнить не удалось (дом недоступен для записи) — сообщение появится снова",
+    once: "Это разовое сообщение: больше не покажется на этой машине.",
+  },
+
+  note: {
+    journalTitle: "Журнал шишек",
+    needTitle: (cmd) => `Нужен заголовок: ${cmd}`,
+    noJournal: (url) => `Клон журнала не найден.\nСделай один раз:\n  git clone ${url}.git ~/projects/aqk\nили укажи путь: export AQK_HOME=/путь/к/aqk`,
+    journalMissing: (path) => `Журнал не найден: ${path}`,
+    emptyBody: `Тело записи пустое. Передай его на стандартный ввод, например:\n\n  aqk note "заголовок" <<'EOF'\n  **Что случилось.** ...\n  **Чем это стоило.** ...\n  **Вывод.** 🔧 ...\n  EOF`,
+    noOutcome:
+      "В записи нет отметки решения. Урок без вывода — это история, а не урок.\n" +
+      "Припиши одну из трёх:\n" +
+      "  ✅ **Стало гейтом:** <имя записи каталога>\n" +
+      "  🔧 **Стало правкой оснастки:** <что именно изменено>\n" +
+      "  👤 **Гейтом не станет:** <почему>",
+    unknownProject: "неизвестно",
+    projectField: "Проект",
+    pushed: (title) => `Записано и отправлено: ${title}`,
+    localOnly: (cmd) => `Записано локально, push не прошёл. Отправить: ${cmd}`,
+  },
+
+  blob: {
+    noDocs: (dir) => `Не найдены методички: ${dir}`,
+    header: (stamp) =>
+      `<!-- СОБРАНО КОМАНДОЙ aqk blob ${stamp} из kit/docs. Не править руками:\n` +
+      `     правки затрёт следующая сборка. Источник — отдельные файлы. -->\n\n` +
+      `# AQK — методички одним файлом\n`,
+    source: (path) => `источник: ${path}`,
+    done: (n, kb) => `GOD_AI.md — ${n} файлов, ${kb} КБ`,
+    rebuilt: "Собирается заново каждой командой. Править надо оригиналы в kit/docs.",
+  },
+
+  start: {
+    noRecipeHere: "нужен инструмент, которого нет на этой машине",
+    initFailed: (cmd) => `Не получилось разложить комплект. Начни с ${cmd}`,
+    tooManyFiles: (n) => `В репозитории уже ${n} файлов кода — это другой сценарий.`,
+    useDoctor: (cmd) => `${cmd} осмотрит, что есть, и разделит записи на три списка:`,
+    threeLists: "держит машина · применимо и не поставлено · не применимо и почему.",
+    anyway: (cmd) => `Всё равно поставить сторожей дня 0: ${cmd}`,
+    expectRed: "Готовься к красному: сторож, поставленный на живой код, краснеет на нём весь.",
+    expectRedFix: (cmd) => `Это лечится храповиком — ${cmd}, — а не отключением.`,
+    installed: (n) => `Поставлено сторожей дня 0: ${n}`,
+    noDebt1: "Долга нет: на пустом проекте им нечего пропускать. Тот же сторож, поставленный",
+    noDebt2: "через полгода, покраснел бы на всём старом коде — и его бы выключили.",
+    allDeclared: "Все применимые записи уже объявлены.",
+    notYet: "Не применимо пока:",
+    notYetWhy: "Появится признак — запись покажется сама.",
+    orderTitle: "Порядок, в котором это делают:",
+    o1: "Задача словами.",
+    o1What: "Что и кому, без единого технического слова.",
+    o1Why: "Пока задача не описана словами, любая архитектура защищает неизвестно что.",
+    o2: "Ограничения.",
+    o2What: "Сроки, деньги, нагрузка, чем нельзя пользоваться.",
+    o2Why: "Ограничения выбирают решение куда чаще, чем вкус: без них выбирают вкусом.",
+    o3: "Сайзинг.",
+    o3What: "Сколько данных, запросов, людей — числами, хотя бы порядком.",
+    o3Why: "Число отделяет «нужна очередь» от «хватит таблицы». Без него спорят словами.",
+    o4: "Архитектура.",
+    o4What: "И только теперь — из первых трёх, а не до них.",
+    softNote1: "Этот порядок программа не проверяет: он в .aqk/docs/, и агент может его",
+    softNote2: "проигнорировать. Машина держит другое — сторожей выше. Разница между",
+    softNote3: "мягким и жёстким тут ровно такая: текст просят, команду выполняют.",
+    next: "Дальше:",
+    nextWhy: "— прогнать всё, что объявлено",
+  },
+
+
+  probe: {
+    shallow: "клон мелкий (git clone --depth) — истории здесь нет, и это НЕ «починок не было». Полный клон: git fetch --unshallow",
+    badEvery: (v) => `в манифесте probe: «${v}» — это не число коммитов. Проба НЕ делается: подставить умолчание значило бы делать не то, что написано.`,
+    autoFirst: "пробы покрытия здесь ещё не делали — делаю её сам. Выключить: AQK_PROBE=0",
+    auto: (n) => `прошло ${n} коммитов с прошлой пробы — делаю её сам. Выключить: AQK_PROBE=0`,
+    title: "aqk probe — чего объявленные проверки не видят",
+    method: (files, entries) =>
+      `метод: в копию каждого файла подсаживается красный образец записи каталога, ` +
+      `по нему прогоняются ОБЪЯВЛЕННЫЕ гейты. Файлов: ${files}, применимых записей: ${entries}. ` +
+      `Рабочее дерево не трогается.`,
+    fixes: (n) => `починок в истории: ${n}`,
+    caught: (names) => `ловит: ${names}`,
+    blind: "НЕ ЛОВИТ НИКТО",
+    unknown: "проверить нечем — гейт не состоялся (нет делегированной программы)",
+    install: (cmd) => `закрыть: ${cmd}`,
+    noSampleFor: (ext) => `в каталоге нет красного образца под «${ext}» — проверить нечем`,
+    noGates: (cmd) => `гейтов не объявлено — пробовать нечем. Сначала: ${cmd}`,
+    noGit: "это не репозиторий git — истории починок взять неоткуда",
+    noFixes: "в истории не нашлось коммитов-починок: тема начинается с fix / исправ / почин",
+    summaryBlind: (n) =>
+      `не прикрыто классов: ${n}. Это не оценка кода: это места, куда возвращаются с починкой, ` +
+      `и брак, которого там не увидит ни одна ваша проверка.`,
+    summaryClean: "в проверенных местах каждый применимый класс кто-то ловит.",
+  },
+  prove: {
+    title: "aqk prove — доказательство гейтов",
+    running: "доказываю гейты по их образцам…",
+    proven: (n) => `доказано: ${n}`,
+    broken: (n) => `не ловят: ${n}`,
+    unprovable: (n) => `нечем доказать: ${n}`,
+    okRed: "краснеет на красном, молчит на зелёном",
+    redPassed: "промолчал на КРАСНОМ образце — гейт не ловит брак",
+    greenFailed: "покраснел на ЗЕЛЁНОМ образце — гейт ругается на исправный код",
+    empty: "команда пустая — объявление без команды защиты не даёт",
+    noSamples: "нет образцов — доказать нечем",
+    noTarget: "не видно, куда подставить каталог образца — команда написана руками",
+    otherRecipe: (lang) => `образцы написаны под рецепт «${lang}», а стоит другой — доказать нечем`,
+    noGates: "гейтов не объявлено — доказывать нечего",
+    needsProgram: (progs) => `НЕ ПРОВЕРЕНА здесь — нужен «${progs}»`,
+    noSamplesDir: "в .aqk.yml не заполнено поле samples — образцы искать негде",
+    nothingProven:
+      "ни один гейт не доказан. Уровень выше AQK-1 означал бы доверие к автору, а не факт:\n  проект с гейтом «true» прошёл бы его так же, как проект с настоящей защитой.",
+    fix: (cmd) => `почини: поставь запись каталога вместе с образцами — ${cmd}`,
+    heading: "Доказательство гейтов",
+  },
+  badge: {
+    noManifest: (cmd) => `Нет .aqk.yml — уровня ещё нет. Начни с ${cmd}`,
+    notReached: (cmd) => `AQK-0 не достигнут — значок выдавать не за что. Чего не хватает: ${cmd}`,
+    redGates: (n, names) =>
+      `Красных гейтов: ${n} (${names}). Значок при красном гейте — заявление автора, а не факт машины.`,
+    hint: (n) => `Проверено прогоном. Зелёных гейтов: ${n}. Строку выше — в README.`,
+    keepTrue: (cmd) => `Чтобы значок не превратился во враньё, поставь в конвейер: ${cmd}`,
+    checkMissing: (places) => `Значка AQK нет ни в одном из файлов: ${places}. Вставить нужно этот:`,
+    checkMismatch: (where, level) => `Значок врёт: ${where}, а прогон говорит AQK-${level}. Заменить на:`,
+    checkOk: (level, where) => `Значок совпал с прогоном: AQK-${level} — ${where}`,
+  },
+};