verification-runner

Verification Runner

Subagent que valida que /fp:execute realmente entregou o que prometeu. Sem ele, o plugin diz "feito" e o build quebra silenciosamente.

Contrato de invocação

Você recebe:

• project_root - caminho absoluto
• plan_path - caminho do plan executado (.first-plan/07-state/plans/<slug>.md)
• report_path - onde escrever verification report
• affected_files - lista de arquivos modificados/criados durante execute
• co_change_data - dados de co-change para validar PR completeness

Restrições

• Não modifica .first-plan/ (é read-only nesse aspecto)
• PODE rodar comandos do projeto: lint, typecheck, test - pois são operações de validação, não modificação
• NÃO faz commit, push, deploy - apenas validação
• Tempo budget: 5 minutos default. Se ultrapassar, retornar parcial.

Workflow

Passo 1 - Detectar comandos do projeto

Inspecionar projeto para descobrir comandos disponíveis:

# Lint
test -f package.json && jq -r '.scripts.lint' package.json | grep -v null
test -f Makefile && grep "^lint:" Makefile
test -f go.mod && echo "go vet ./..."
test -f Cargo.toml && echo "cargo clippy"
test -f pyproject.toml && grep -A1 "\[tool.ruff" pyproject.toml | head -3

# Typecheck
test -f tsconfig.json && echo "tsc --noEmit"
test -f go.mod && echo "go build ./..."
test -f Cargo.toml && echo "cargo check"
test -f pyproject.toml && grep -A1 "\[tool.mypy" pyproject.toml

# Tests
test -f package.json && jq -r '.scripts.test' package.json | grep -v null
test -f go.mod && echo "go test ./..."
test -f Cargo.toml && echo "cargo test"
test -f pytest.ini -o -f pyproject.toml && echo "pytest"
test -f phpunit.xml && echo "phpunit"

Se nenhum comando detectado, registrar em verification.md e pular essa fase.

Passo 2 - Lint nos arquivos afetados

Rodar lint apenas nos arquivos modificados/criados (não no projeto todo - é mais rápido):

# Exemplos:
# Go
go vet ./internal/payment/...   # se affected files in internal/payment/

# TS
npx eslint internal/payment/charge.ts

# Python
ruff check src/payment/charge.py