agent-quality-kit 0.2.2

package/kit/gates/file-size-limit/red/big.py

@@ -0,0 +1,601 @@
+def f():
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1
+    x = 1

package/kit/gates/gate-has-samples/README.md

@@ -0,0 +1,29 @@
+# У каждого гейта есть красный и зелёный образец
+
+**Намерение.** Гейт, который никогда не проверяли, — это не гейт, а надежда.
+
+**Какой отказ это поймало.** В `audit_project` правило статического анализа запрещало создавать
+десятичное число из числа с плавающей точкой и предписывало писать строкой — и при этом краснело
+на правильном написании строкой, причём не всегда, а в зависимости от соседнего кода в файле.
+Красный конвейер, полчаса на локализацию, круг конвейера 15–18 минут.
+Запись в журнале: `incidents/README.md`, 2026-08-24.
+
+**Зелёный образец важнее красного.** Что гейт ловит брак, обычно проверяют при установке. Что он
+молчит на исправном коде — не проверяют почти никогда. Именно этот пропуск и стоил времени: гейт
+ругался на то написание, которое сам же предписывал.
+
+**Что именно требует образцы.** Только записи-сканеры: те, чья команда запускает проверку из
+каталога образцов. У прогона с собственным арбитром — `pytest`, `node --test`, `go test` —
+образцы уже внутри него.
+
+**Чего НЕ ловит.** Прогон, который в каталог не ссылается, эта запись не проверяет вовсе:
+`tests: "echo ok"` проедет. Что арбитр настоящий, показывает только красный прогон — сломай
+проверяемое и убедись, что конвейер краснеет.
+
+**Готового аналога нет.** Проверено: правило «у проверки должен быть образец, на котором она
+краснеет» — про устройство самой оснастки, а не про язык. Ни `ruff`, ни `eslint`, ни `semgrep`
+таких правил не содержат: они проверяют код, а не проверки.
+
+**Образцы.** `red/` — объявлен свой гейт-сканер, папок `red/` и `green/` у него нет; рядом
+`tests: "pytest -q"`, который образцов не требует и в счёт не идёт. `green/` — тот же манифест,
+образцы на месте.

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

@@ -0,0 +1,48 @@
+#!/usr/bin/env sh
+# Гейт без образцов — непроверенное утверждение. Красный образец доказывает, что гейт ловит
+# брак; зелёный — что он молчит на исправном коде. Зелёный важнее: именно он ловит гейт,
+# который ругается на предписанное им же написание.
+#
+# ЧТО ИМЕННО ТРЕБУЕТ ОБРАЗЦЫ. Только записи-сканеры: те, чья команда запускает проверку из
+# каталога образцов. У прогона с собственным арбитром — `pytest`, `node --test`, `go test` —
+# образцы уже внутри него, и требовать их отдельно значит требовать работу, которой нет.
+# Первая редакция этого не различала и записала долгом четыре собственных прогона комплекта:
+# проверка мерила не то, что называла.
+#
+# ЧЕГО НЕ ЛОВИТ. Прогон, объявленный в манифесте и не ссылающийся на каталог, этой записью не
+# проверяется вовсе. Что его арбитр настоящий, а не `echo ok`, показывает только красный прогон:
+# сломай проверяемое — конвейер обязан покраснеть.
+DIR="${1:-.}"
+MAN="$DIR/.aqk.yml"
+[ -f "$MAN" ] || { echo "нет .aqk.yml — проверять нечего"; exit 0; }
+
+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")
+
+[ -z "$KEYS" ] && { echo "гейтов не объявлено — проверять нечего"; exit 0; }
+
+if [ -z "$SAMPLES" ]; then
+  # Без каталога образцов проверить нечего ни у одной записи. Одно сообщение, а не по одному
+  # на гейт: дефект здесь один, и он в манифесте.
+  echo "в .aqk.yml не заполнено поле samples — образцы искать негде"
+  echo "  почини: заведи каталог образцов и укажи его в samples"
+  exit 1
+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")
+  case "$CMD" in
+    *"$SAMPLES/"*) ;;                 # сканер из каталога — образцы обязательны
+    *) continue ;;                    # свой прогон — арбитр внутри него
+  esac
+  for KIND in red green; do
+    if [ ! -d "$DIR/$SAMPLES/$K/$KIND" ]; then
+      echo "гейт «$K»: нет образца $KIND ($SAMPLES/$K/$KIND)"
+      echo "  почини: положи код, на котором гейт обязан $( [ $KIND = red ] && echo краснеть || echo молчать )"
+      BAD=1
+    fi
+  done
+done
+exit $BAD

package/kit/gates/gate-has-samples/gate.yml

@@ -0,0 +1,9 @@
+intent: у каждого объявленного гейта есть красный и зелёный образец
+
+trigger:
+  has_gates: true
+
+recipes:
+  any: bash {gate}/check.sh {dir}
+
+proof: incidents/README.md — «2026-08-24 гейт краснел на том написании, которое сам предписывал»

package/kit/gates/gate-has-samples/green/.aqk.yml

@@ -0,0 +1,10 @@
+aqk: 1
+entry:
+  - AGENTS.md
+rules: rules
+gates:
+  # Свой гейт: сканирует проект, значит обязан показать красный и зелёный образец.
+  no-print-in-prod: "bash gates/no-print-in-prod/check.sh ."
+  # Прогон с собственным арбитром — образцов не требует и в счёт не идёт.
+  tests: "pytest -q"
+samples: gates

package/kit/gates/gate-has-samples/green/gates/no-print-in-prod/check.sh

@@ -0,0 +1,2 @@
+#!/usr/bin/env sh
+exit 0

package/kit/gates/gate-has-samples/green/gates/no-print-in-prod/green/good.py

@@ -0,0 +1,2 @@
+import logging
+logging.getLogger(__name__).debug("ок")

package/kit/gates/gate-has-samples/green/gates/no-print-in-prod/red/bad.py

@@ -0,0 +1 @@
+print("отладка")

package/kit/gates/gate-has-samples/red/.aqk.yml

@@ -0,0 +1,10 @@
+aqk: 1
+entry:
+  - AGENTS.md
+rules: rules
+gates:
+  # Свой гейт: сканирует проект, значит обязан показать красный и зелёный образец.
+  no-print-in-prod: "bash gates/no-print-in-prod/check.sh ."
+  # Прогон с собственным арбитром — образцов не требует и в счёт не идёт.
+  tests: "pytest -q"
+samples: gates

package/kit/gates/gate-has-samples/red/gates/no-print-in-prod/check.sh

@@ -0,0 +1,2 @@
+#!/usr/bin/env sh
+exit 0