Ловим ошибки агента автоматически: слои проверок, бюджеты, петли и выдуманные методы

// .claude/hooks/lint-after-edit.js — PostToolUse: ESLint для правленого файла
import { execFileSync } from "node:child_process";

let raw = "";
process.stdin.on("data", (c) => (raw += c));
process.stdin.on("end", () => {
  const file = JSON.parse(raw).tool_input?.file_path ?? "";
  if (!/\.(ts|js)$/.test(file)) process.exit(0);
  try {
    execFileSync("npx", ["eslint", "--max-warnings=0", file], { encoding: "utf8" });
    process.exit(0);
  } catch (e) {
    // код 2: ошибки уйдут модели, она исправит их на следующем шаге
    process.stderr.write(`ESLint нашёл проблемы в ${file}:\n${e.stdout}`);
    process.exit(2);
  }
});

#!/usr/bin/env php
<?php
// .claude/hooks/lint-after-edit.php — PostToolUse: phpstan для правленого файла
$event = json_decode(stream_get_contents(STDIN), true, flags: JSON_THROW_ON_ERROR);
$file = $event['tool_input']['file_path'] ?? '';
if (!str_ends_with($file, '.php')) {
    exit(0);
}
exec('vendor/bin/phpstan analyse --no-progress --error-format=raw ' . escapeshellarg($file) . ' 2>&1', $out, $code);
if ($code !== 0) {
    fwrite(STDERR, "phpstan нашёл ошибки в $file:\n" . implode("\n", $out));
    exit(2);
}
exit(0);

#!/usr/bin/env python3
# .claude/hooks/tests-before-stop.py — Stop: не отпускать агента с красными тестами
import json
import subprocess
import sys

event = json.load(sys.stdin)
# Если агент уже продолжает работу из-за этого хука, не держим его вечно
if event.get("stop_hook_active"):
    sys.exit(0)

proc = subprocess.run(["pytest", "-q", "-x"], capture_output=True, text=True)
if proc.returncode != 0:
    tail = (proc.stdout + proc.stderr)[-3000:]
    print("Тесты красные, задачу нельзя считать готовой:\n" + tail, file=sys.stderr)
    sys.exit(2)
sys.exit(0)

// trace.ts — простой трейс шагов агента в JSON Lines
import { appendFileSync } from "node:fs";

interface TraceStep {
  task: string;
  step: number;
  tool: string;
  input: unknown;
  inputTokens: number;
  outputTokens: number;
  ms: number;
  ok: boolean;
}

export function trace(s: TraceStep): void {
  // одна строка — один шаг: легко грепать, считать и грузить в Grafana/Loki
  appendFileSync("var/agent-trace.jsonl", JSON.stringify({ at: new Date().toISOString(), ...s }) + "\n");
}

// В цикле агента после каждого шага:
// trace({ task: "fix-price", step, tool: block.name, input: block.input,
//         inputTokens: res.usage.input_tokens, outputTokens: res.usage.output_tokens, ms, ok: !isError });