🌉 Longo Horizonte e Multi-Context

#!/usr/bin/env bash
# init.sh — idempotente, rodar 1x para criar scaffold
set -euo pipefail
ROOT="$(cd "$(dirname "$0")" && pwd)"
cd "$ROOT"

mkdir -p .agent
[ -f .agent/spec.md ] || cat > .agent/spec.md <<'EOF'
# Spec

## Intent
<descreva o objetivo em 2 linhas>

## Constraints
- <o que NÃO pode quebrar>

## Criteria
- [ ] todos os testes em .agent/tests.json passando
- [ ] nenhum arquivo fora do escopo modificado

## Files
- src/...
EOF

[ -f .agent/tests.json ] || cat > .agent/tests.json <<'EOF'
{
  "tests": [
    { "id": "t1", "desc": "...", "status": "todo" }
  ]
}
EOF

[ -f .agent/progress.txt ] || echo "# progress.txt — append-only" > .agent/progress.txt

grep -q '^\.agent/$' .gitignore 2>/dev/null || echo ".agent/scratch/" >> .gitignore
echo "scaffold ok."

{
  "tests": [
    { "id": "t1", "desc": "POST /users cria usuário",     "status": "passed", "last_run": "2026-04-20T13:05:00Z" },
    { "id": "t2", "desc": "GET /users/:id retorna 404",   "status": "failed", "error": "returns 500" },
    { "id": "t3", "desc": "middleware valida JWT",        "status": "todo" },
    { "id": "t4", "desc": "rate limit por IP",            "status": "todo" }
  ],
  "summary": { "total": 4, "passed": 1, "failed": 1, "todo": 2 }
}

<context_awareness>
Your context window will be automatically compacted when it
approaches its limit. Treat this as inevitable — your job is
to ensure that a future instance (with a fresh or compacted
context) can resume your work from disk.

Before making non-trivial progress:
  1. Read .agent/spec.md to re-anchor on the goal.
  2. Read .agent/tests.json to see current status.
  3. Read .agent/progress.txt to see what was already tried.

After meaningful progress:
  1. Update .agent/tests.json (status transitions).
  2. Append to .agent/progress.txt one line per decision:
     `YYYY-MM-DD HH:MM <what> — <why>`.
  3. If a new insight changes the plan, patch spec.md.
  4. Commit with message starting `chore(agent): `.

Assume a compact can happen at any turn. Never keep critical
state only in memory — write it down.
</context_awareness>