agent-quality-kit 0.6.0 → 0.8.0

package/kit/gates/no-print-in-prod/check.sh

@@ -1,38 +0,0 @@
-#!/usr/bin/env sh
-# Отладочная печать переживает задачу и уезжает в прод: она не ошибка сборки и
-# не видна в ревью диффа на 400 строк. В проде это либо шум, либо утечка данных
-# мимо системы логов.
-DIR="${1:-.}"
-. "$(dirname "$0")/../_skip.sh" 2>/dev/null || SKIP_NAMES=".git .aqk node_modules .venv"
-# Красный образец — намеренно сломанный код в репозитории. Сканирующий гейт обязан его
-# пропускать, иначе будет вечно краснеть на том, что сам же и положил. Исключение снимается,
-# когда проверяют сам образец: тогда каталог red и есть цель проверки.
-
-# Где печать законна и дефектом не является: вспомогательные скрипты, оснастка, примеры,
-# записные книжки. Это НЕ общий список исключений: секрет в scripts/ — такой же секрет,
-# а печать там — обычный способ говорить с человеком.
-#
-# На настоящем проекте без этого различия 285 находок из 330 пришли из scripts/ и оснастки.
-# Гейт, который на 86% состоит из ложных сработок, выключают целиком.
-TOOLING="--exclude-dir=scripts --exclude-dir=tools --exclude-dir=bin --exclude-dir=examples --exclude-dir=notebooks --exclude-dir=docs --exclude-dir=.claude --exclude-dir=gates"
-# `gates-reference` отсюда убран: это имя каталога ОДНОГО проекта, зашитое в общий
-# инструмент. Такому место в .aqkignore самого проекта — он появился позже этой строки.
-
-# Проект называет СВОИ каталоги, где печать — интерфейс, а не отладка: у программы командной
-# строки это её исходники целиком. Объявляется в манифесте, рядом с командой, и потому видно
-# глазами: AQK_PRINT_OK_DIRS="tool cli" bash .../check.sh .
-#
-# ЗАЧЕМ ОТДЕЛЬНО ОТ ХРАПОВИКА. Сначала такие места записали долгом — и каждая новая строка
-# вывода красила проверку, требуя переснять реестр. Но долг — это то, что собираются погасить;
-# печать из программы командной строки убирать никто не будет. Долг, который нельзя погасить
-# работой, — не долг, а неверная мера: журнал, 2026-09-03.
-for D in ${AQK_PRINT_OK_DIRS:-}; do
-  TOOLING="$TOOLING --exclude-dir=$D"
-done
-HITS=$(grep -rnE $(skip_grep "$DIR") $(include_code) $TOOLING '(^|[^A-Za-z_.])(print\(|console\.log\(|fmt\.Print|println!|print!|dbg!|System\.out\.print|Console\.Write)' "$DIR" 2>/dev/null | drop_comments | own_samples_filter "$DIR")
-if [ -n "$HITS" ]; then
-  echo "$HITS"
-  echo "  почини: замени на вызов системы логов — тогда запись попадёт в общий журнал и уровень можно приглушить."
-  exit 1
-fi
-exit 0

package/kit/gates/no-print-in-prod/green/docs.ts

@@ -1,15 +0,0 @@
-// Печать внутри комментария — не печать. Пример в документации к функции и закомментированная
-// строка отладки одинаково не выполняются: находка здесь означает, что проверка читает текст,
-// а не код. Найдено прогоном по audit_project — семь находок из JSDoc и закомментированных строк.
-
-/**
- * Скачивает файл.
- *
- * @example
- *   const result = await download(id);
- *   console.log('Done:', result.file_url);
- */
-export async function download(id: string): Promise<string> {
-  // console.log('отладка', id);
-  return `/files/${id}`;
-}

package/kit/gates/no-print-in-prod/green/main.go

@@ -1,8 +0,0 @@
-package main
-
-import "log/slog"
-
-func handle(x int) int {
-	slog.Debug("got", "x", x)
-	return x + 1
-}

package/kit/gates/no-print-in-prod/green/main.rs

@@ -1,4 +0,0 @@
-fn handle(x: i32) -> i32 {
-    log::debug!("got {}", x);
-    x + 1
-}

package/kit/gates/no-print-in-prod/red/main.go

@@ -1,8 +0,0 @@
-package main
-
-import "fmt"
-
-func handle(x int) int {
-	fmt.Println("got", x)
-	return x + 1
-}

package/kit/gates/no-print-in-prod/red/main.rs

@@ -1,4 +0,0 @@
-fn handle(x: i32) -> i32 {
-    println!("got {}", x);
-    x + 1
-}

package/kit/gates/swallowed-error/check.sh

@@ -1,54 +0,0 @@
-#!/usr/bin/env sh
-# Тихо проглоченная ошибка — отказ, о котором никто не узнал. Система продолжает работать
-# «как будто всё хорошо», а причина всплывает через недели и в другом месте.
-DIR="${1:-.}"
-. "$(dirname "$0")/../_skip.sh" 2>/dev/null || SKIP_NAMES=".git .aqk node_modules .venv"
-
-# Список файлов собираем заранее. awk без файловых аргументов читает поток ввода и ждёт его
-# вечно: на проекте без файлов этих языков проверка зависала навсегда — в конвейере и в хуке
-# коммита, где поток ввода открыт. Найдено прогоном по проекту на Go.
-FILES=$(find "$DIR" $(skip_find "$DIR") -type f -print 2>/dev/null | only_code | own_samples_filter "$DIR")
-[ -z "$FILES" ] && exit 0
-
-printf '%s\n' "$FILES" | xargs -r awk '
-  FILENAME ~ /\/(\.git|\.aqk|node_modules|dist|build|vendor)\// { next }
-
-  # python: except ...: с пустым телом
-  prev ~ /^[[:space:]]*except([[:space:]]|:)/ && $0 ~ /^[[:space:]]*(pass|\.\.\.)[[:space:]]*$/ {
-    print FILENAME ":" FNR ": перехват без обработки — " gensub(/^[[:space:]]+/, "", 1, prev)
-  }
-  # python в одну строку
-  /^[[:space:]]*except[^:]*:[[:space:]]*(pass|\.\.\.)[[:space:]]*$/ {
-    print FILENAME ":" FNR ": перехват без обработки — " gensub(/^[[:space:]]+/, "", 1, $0)
-  }
-  # js/java/go-подобные: catch (...) { } пустой
-  /catch[[:space:]]*(\([^)]*\))?[[:space:]]*\{[[:space:]]*\}/ {
-    print FILENAME ":" FNR ": перехват без обработки — " gensub(/^[[:space:]]+/, "", 1, $0)
-  }
-  # go: пустое тело после проверки ошибки, либо ошибка присвоена в пустоту
-  prev ~ /if[[:space:]]+err[[:space:]]*!=[[:space:]]*nil/ && $0 ~ /^[[:space:]]*\}[[:space:]]*$/ {
-    print FILENAME ":" FNR ": ошибка проверена и выброшена — " gensub(/^[[:space:]]+/, "", 1, prev)
-  }
-  /^[[:space:]]*_[[:space:]]*=[[:space:]]*err[[:space:]]*$/ {
-    print FILENAME ":" FNR ": ошибка присвоена в пустоту — " gensub(/^[[:space:]]+/, "", 1, $0)
-  }
-  # rust: результат отброшен без разбора
-  /\.ok\(\);[[:space:]]*$/ || /let[[:space:]]+_[[:space:]]*=[^;]*\?[[:space:]]*;/ {
-    print FILENAME ":" FNR ": результат отброшен без разбора — " gensub(/^[[:space:]]+/, "", 1, $0)
-  }
-  # обещания: .catch(() => {})
-  /\.catch\([^)]*=>[[:space:]]*\{[[:space:]]*\}\)/ {
-    print FILENAME ":" FNR ": перехват без обработки — " gensub(/^[[:space:]]+/, "", 1, $0)
-  }
-  { prev = $0 }
-' > /tmp/.swallowed.$$ 2>/dev/null
-
-if [ -s /tmp/.swallowed.$$ ]; then
-  cat /tmp/.swallowed.$$
-  echo "  почини: либо обработай и запиши в лог, либо пробрось дальше."
-  echo "  тихий перехват — это отказ, о котором никто не узнает, пока не станет поздно."
-  rm -f /tmp/.swallowed.$$
-  exit 1
-fi
-rm -f /tmp/.swallowed.$$
-exit 0

package/kit/gates/swallowed-error/green/run.js

@@ -1,8 +0,0 @@
-async function go() {
-  try {
-    await run();
-  } catch (e) {
-    logger.error("шаг не выполнен", e);
-    throw e;
-  }
-}

package/kit/gates/swallowed-error/red/run.js

@@ -1,3 +0,0 @@
-async function go() {
-  try { await run(); } catch (e) {}
-}