@jaimevalasek/aioson 1.7.2 → 1.9.0

package/docs/pt/deyvin-subtask-scout/diagramas.md

@@ -0,0 +1,124 @@
+# Diagramas — Sub-task Scout
+
+---
+
+## Fluxo completo de despacho
+
+```
+Usuário pergunta ao @deyvin algo que dispara rubrica linha 111
+(survey de >5 arquivos ou rastreamento de fluxo de runtime)
+         │
+         ▼
+┌─────────────────────────────────────────────────────────────┐
+│  aioson scout:prep                                          │
+│  ─────────────────                                          │
+│  1. Valida inputs (question, scope, excerpt obrigatório)   │
+│  2. Resolve scope_paths → paths absolutos                   │
+│  3. Checa caps: scouts_in_session < max (3) ?              │
+│                 scope_size < max_files (20) ?               │
+│  4. Incrementa scouts_in_session no state file             │
+│  5. Gera prompt com tool whitelist [Read, Grep]            │
+│  6. Retorna { id, prompt, output_path, cap_remaining }     │
+└──────────────────────────────┬──────────────────────────────┘
+                               │ exit 0
+                               ▼
+┌─────────────────────────────────────────────────────────────┐
+│  harness.sub-agent(prompt)    ← CONTEXTO ISOLADO            │
+│  ────────────────────────                                   │
+│  ferramentas: [Read, Grep] APENAS                           │
+│  proibido: [Bash, Edit, Write]  ← Nautilus pattern         │
+│                                                             │
+│  sub-agente inspeciona scope_paths                          │
+│  escreve JSON em output_path                                │
+└──────────────────────────────┬──────────────────────────────┘
+                               │
+                               ▼
+┌─────────────────────────────────────────────────────────────┐
+│  aioson scout:validate --input=<output_path>                │
+│  ───────────────────────────────────────────                │
+│  valida contra OUTPUT_SCHEMA                                │
+│  atualiza retries_by_id no state                            │
+└──────────┬───────────────────────────────┬──────────────────┘
+           │ PASS (exit 0)                 │ FAIL (exit 2)
+           ▼                               ▼
+┌──────────────────────────┐   ┌───────────────────────────────┐
+│ aioson scout:commit      │   │ retry_remaining > 0?          │
+│ ────────────────────     │   │  sim → @deyvin re-prompta     │
+│ persiste scout JSON      │   │  não → retry_exhausted        │
+│ decrementa cap           │   │         status: "error"       │
+│ emite telemetria         │   │         @deyvin informa user  │
+└──────────┬───────────────┘   └───────────────────────────────┘
+           │
+           ▼
+┌──────────────────────────────────────────────────────────────┐
+│ @deyvin lê findings, confidence, recommendation              │
+│ dobra na resposta ao usuário                                 │
+│                                                              │
+│ contexto pai cresceu: ~500 tokens (relatório)               │
+│ vs inline survey:     ~10k+ tokens (arquivos brutos)        │
+└──────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Archivamento no feature:close
+
+```
+aioson feature:close --slug=<s> --verdict=PASS
+         │
+         ▼
+ (hook na Phase 5 do feature:close)
+         │
+         ├─ procura .aioson/runtime/scouts/ por files com feature_slug=<s>
+         │
+         ├─ para cada scout encontrado:
+         │    ├─ copia para .aioson/context/features/<s>/scouts/{id}.json
+         │    └─ appenda bullet em dossier.md > ## Sub-task scouts (idempotente)
+         │
+         └─ emite telemetria type=sub_task action=archived_on_close
+         
+ (runtime copies permanecem em .aioson/runtime/scouts/ — poda pelo doctor)
+```
+
+---
+
+## Poda pelo doctor
+
+```
+aioson doctor . [--fix]
+         │
+         ├─ check: scouts_directory_pruning
+         │    ├─ lê .aioson/config/scout-engine.json → prune_unattached_after_days (default: 90)
+         │    ├─ lista .aioson/runtime/scouts/*.json
+         │    │    ├─ tem feature_slug? → NUNCA poda (cold-load memory)
+         │    │    └─ sem feature_slug + idade > threshold? → candidato
+         │    └─ sem --fix: reporta count como advisory WARN
+         │       com --fix: apaga candidatos
+```
+
+---
+
+## State file e file-lock
+
+```
+.aioson/runtime/scouts/.state.json
+{
+  "sessions": {
+    "sess-abc123": {
+      "scouts_in_session": 2,      ← incrementado em prep, decrementado em commit
+      "retries_by_id": {
+        "scout-2026-05-14-a3b7c1": 0
+      },
+      "committed_ids": {
+        "scout-2026-05-14-a3b7c1": true
+      }
+    }
+  }
+}
+
+Lock: .aioson/runtime/scouts/.state.json.lock
+  ├─ conteúdo: { pid, lockedAt (ISO) }
+  ├─ stale se age > 30s
+  ├─ retry a cada 100ms, deadline 30s
+  └─ criado em prep/commit/validate; removido após a operação
+```

package/docs/pt/deyvin-subtask-scout/sub-task-scout.md

@@ -0,0 +1,113 @@
+# O que é o Sub-task Scout
+
+> O scout fecha o item explicitamente adiado na feature `deyvin-density` (2026-05-11). A rubrica do `@deyvin` na linha 111 dizia: "diagnóstico ambíguo; precisa de survey de >5 arquivos ou rastreamento de fluxo de runtime → Despachar sub-task scout (adiado para `deyvin-subtask-scout`; até então: parar e perguntar ao usuário)." Agora tem primitiva.
+
+---
+
+## O problema
+
+Sem o scout, `@deyvin` tinha duas opções ruins quando uma pergunta precisava inspecionar muitos arquivos:
+
+1. **Ler tudo inline** — queima ≥10k tokens no contexto pai, polui a memória de trabalho do agente e força o próximo turno a competir com conteúdo de survey obsoleto.
+2. **Fazer handoff para `/architect` ou pausar** — ultrapassa a necessidade real (a maioria dos surveys não precisa de decisões arquiteturais) e quebra o fluxo da conversa com uma troca completa de agente.
+
+O scout resolve isso: o agente pai mantém o contexto limpo e recebe um relatório estruturado de ~500 tokens em vez dos arquivos brutos.
+
+---
+
+## Como funciona
+
+### Ciclo de vida completo
+
+```
+@deyvin detecta rubrica linha 111
+         │
+         ▼
+aioson scout:prep --question="..." --scope-paths="a.js,b.js" ...
+  └─ valida inputs
+  └─ checa caps (sessão, escopo)
+  └─ gera prompt padronizado para o sub-agente
+  └─ retorna { id, prompt, output_path, cap_remaining }
+         │
+         ▼
+@deyvin chama harness.sub-agent(prompt)
+  └─ sub-agente roda em contexto ISOLADO
+  └─ ferramentas permitidas: [Read, Grep]
+  └─ ferramentas proibidas: [Bash, Edit, Write]   ← Nautilus pattern
+  └─ escreve JSON em output_path
+         │
+         ▼
+aioson scout:validate --input=<output_path>
+  └─ valida JSON contra OUTPUT_SCHEMA
+  └─ PASS → continua
+  └─ FAIL → incrementa retry; @deyvin re-prompta (máx 1 retry)
+         │
+         ▼
+aioson scout:commit --input=<output_path>
+  └─ persiste em .aioson/runtime/scouts/{id}.json
+  └─ decrementa cap_remaining
+  └─ emite telemetria action=committed
+         │
+         ▼
+@deyvin lê findings, confidence, recommendation
+  └─ dobra na resposta ao usuário
+  └─ contexto pai cresceu ~500 tokens (só o relatório)
+     em vez de ~10k+ (os arquivos inspecionados)
+```
+
+### O relatório (OutputSchema)
+
+Campo | Tipo | O que é
+`id` | string | Identificador único do scout (`scout-{slug}-{data}-{rand6}`)
+`parent_agent` | string | Agente que despachou (`"deyvin"` em V1)
+`parent_session_id` | string | ID da sessão pai (para rastreabilidade de caps)
+`parent_session_excerpt` | string (50-1000 chars) | **Obrigatório.** Por que o scout foi despachado — essencial para cold-load por agentes futuros
+`feature_slug` | string \| null | Feature em andamento, se houver
+`question` | string | A pergunta original
+`scope` | object | Arquivos e diretórios inspecionados
+`findings[]` | array | Cada finding: `file`, `line`, `evidence` (max 200 chars), `relevance`, `explanation` (20-300 chars)
+`confidence` | `"high" \| "medium" \| "low"` | Autoavaliação do sub-agente
+`recommendation` | string (30-1000 chars) | O que o agente pai deve fazer a seguir
+`files_inspected[]` | string[] | Lista de arquivos efetivamente lidos
+`status` | `"success" \| "partial" \| "no_findings" \| "error"` | Estado final do scout
+`completed_at` | ISO string | Timestamp de conclusão
+
+---
+
+## As 3 fases da feature
+
+### Fase 1 — `core-engine`
+Módulo puro `src/sub-task-engine.js`: template de prompt, validadores JSON hand-rolled (zero novas dependências), gerenciamento de estado de caps, lifecycle state. Sem I/O — só o que os comandos CLI invocam explicitamente.
+
+### Fase 2 — `cli-verbs`
+Três verbos CLI (`scout:prep`, `scout:validate`, `scout:commit`) + estado com file-lock em `src/sub-task-state.js`. Template de config `template/.aioson/config/scout-engine.json` (vazio `{}`; defaults ativos). Sandbox path check: `scope_paths` fora do root do projeto são rejeitados.
+
+### Fase 3 — `wiring-and-lifecycle`
+- `deyvin.md` (workspace + template byte-identical, 13611 bytes, abaixo do limite de 15360): nova seção "Sub-task scout invocation" com caminho CLI + fallback CLI-less por harness (Claude Code Agent tool, Codex MultiAgentV2, Gemini/OpenCode com mensagem `harness_unsupported`)
+- `feature:close`: hook de arquivamento copia scouts com `feature_slug` correspondente para `.aioson/context/features/{slug}/scouts/`, appenda bullet no dossier
+- `memory:summary`: linha "Scouts dispatched: N (top topics: ...)" sempre presente — visível em cold-load de agente
+- `doctor`: check advisory `scouts_directory_pruning` (scouts órfãos >90d); `--fix` apaga; scouts com `feature_slug` **nunca** são podados
+
+---
+
+## Padrões de segurança
+
+**Nautilus pattern** — ferramenta de whitelist no sub-agente:
+- Permitido: `[Read, Grep]`
+- Proibido: `[Bash, Edit, Write]`
+- Aplicado via prompt template; harnesses que suportam configuração explícita de tools também recebem a whitelist como parâmetro
+
+**Sandbox de path** — `scope_paths` fora do `rootDir` do projeto são rejeitados com `error.code = 'path_outside_root'`
+
+**Cap discipline** — nenhum scout pode ultrapassar os limits configurados; exceder retorna exit 2 antes de despachar o sub-agente
+
+**`parent_session_excerpt` obrigatório** — bloqueado em `scout:prep` se ausente. É o campo que garante que agentes futuros lendo o scout em cold-load consigam reconstruir a intenção sem histórico de conversa.
+
+---
+
+## Continue lendo
+
+- [Como usar](./como-usar.md) — fluxos concretos passo a passo
+- [Referência CLI](./comandos-cli.md) — flags completos
+- [Diagramas](./diagramas.md) — fluxo visual
+- [Troubleshooting](./troubleshooting.md) — problemas conhecidos

package/docs/pt/deyvin-subtask-scout/troubleshooting.md

@@ -0,0 +1,184 @@
+# Troubleshooting — Sub-task Scout
+
+---
+
+## Cap exceeded (`cap_exceeded`)
+
+**Sintoma:** `aioson scout:prep` retorna exit 2 com `error.code = "cap_exceeded"`.
+
+**Por que acontece:** o `parent_session_id` já despacharam `max_scouts_per_session` scouts nesta sessão (default: 3).
+
+**Soluções:**
+
+1. **Consolidar scouts** — combine perguntas relacionadas num único scout com escopo mais amplo.
+2. **Nova sessão** — inicie uma nova sessão (novo `parent_session_id`); caps são por sessão, não por projeto.
+3. **Aumentar o limite** no projeto:
+
+```json
+// .aioson/config/scout-engine.json
+{ "max_scouts_per_session": 5 }
+```
+
+Se a taxa de `cap_exceeded` passar de 5% em uso real, os defaults estão apertados — ajuste.
+
+---
+
+## Escopo muito grande (`scope_too_large`)
+
+**Sintoma:** `aioson scout:prep` retorna `error.code = "scope_too_large"`.
+
+**Por que acontece:** `scope_paths` resolveu para mais de `max_files_in_scope` arquivos (default: 20).
+
+**Soluções:**
+
+1. **Especificar arquivos concretos** em vez de diretórios:
+   ```bash
+   # em vez de:
+   --scope-paths="src/"
+   # use:
+   --scope-paths="src/commands/workflow-next.js,src/handoff-contract.js"
+   ```
+
+2. **Aumentar o limite** no projeto:
+   ```json
+   { "max_files_in_scope": 30 }
+   ```
+
+> Diretórios em `scope_paths` expandem apenas 1 nível de profundidade (filhos diretos). `scope_globs` está adiado para V2.
+
+---
+
+## JSON malformado do sub-agente (`schema_invalid`)
+
+**Sintoma:** `aioson scout:validate` retorna exit 2 com `error.code = "schema_invalid"`.
+
+**Por que acontece:** o sub-agente não produziu JSON válido contra o `OUTPUT_SCHEMA`. Pode ser:
+- Campo obrigatório faltando (`parent_session_excerpt`, `confidence`, `recommendation`)
+- `confidence` com valor inválido (deve ser `high`, `medium`, ou `low`)
+- `evidence` ou `explanation` excedendo os limites de caracteres (200 e 300 respectivamente)
+- Chaves extras (schema tem `additionalProperties: false`)
+
+**Solução:** re-prompta o sub-agente com o erro exato:
+
+```
+Sua saída anterior falhou na validação:
+- findings[0].evidence: campo obrigatório ausente
+- confidence: deve ser um de: high, medium, low
+
+Reexecute e produza JSON válido conforme o schema.
+```
+
+Você tem 1 retry (`max_retries_on_malformed_json=1`). Se o segundo também falhar, o scout fica com `status: "error"` e `@deyvin` precisa lidar manualmente (handoff ou resposta direta).
+
+---
+
+## Retry exhausted (`retry_exhausted`)
+
+**Sintoma:** `aioson scout:validate` retorna `error.code = "retry_exhausted"`.
+
+**Por que acontece:** o sub-agente falhou na validação duas vezes seguidas (prep + 1 retry).
+
+**O que fazer:**
+
+1. O scout foi persistido com `status: "error"` em `.aioson/runtime/scouts/{id}.json`.
+2. `@deyvin` informa o usuário e oferece handoff para `/architect` ou resposta direta com o que já sabe.
+3. Para aumentar os retries: `{ "max_retries_on_malformed_json": 2 }` no config (raramente necessário — se acontece frequentemente, o prompt template precisa de ajuste).
+
+---
+
+## Harness sem suporte a sub-agentes (`harness_unsupported`)
+
+**Sintoma:** Gemini CLI ou OpenCode não suportam o Agent tool / sub-agent nativamente.
+
+**O que acontece:** `scout:prep` retorna normalmente, mas o harness emite `harness_unsupported` ao tentar despachar o sub-agente.
+
+**Solução:** use o fallback CLI-less embutido no `deyvin.md`. A seção "Sub-task scout invocation — CLI-less fallback" descreve como construir o prompt manualmente e usar o Agent tool diretamente no Claude Code, ou como adaptar para o harness disponível.
+
+O fallback produz o mesmo relatório JSON, mas sem caps, telemetria ou archivamento automático.
+
+---
+
+## Lock preso no state file
+
+**Sintoma:** `aioson scout:prep` (ou `scout:commit`) trava por mais de 30s.
+
+**Por que acontece:** `.aioson/runtime/scouts/.state.json.lock` existe com PID de um processo morto.
+
+**Solução:**
+
+```bash
+# Verificar se o PID ainda está vivo
+cat .aioson/runtime/scouts/.state.json.lock
+# { "pid": 12345, "lockedAt": "2026-05-14T10:00:00.000Z" }
+
+# Se o processo não existe mais, remover manualmente:
+rm .aioson/runtime/scouts/.state.json.lock
+```
+
+O lock é declarado stale automaticamente após 30s — na próxima operação CLI, será sobrescrito sem intervenção.
+
+---
+
+## `parent_session_excerpt` bloqueado
+
+**Sintoma:** `aioson scout:prep` retorna `error.code = "input_invalid"` com `field: "parent_session_excerpt"`.
+
+**Por que acontece:** o campo é obrigatório (não pode ser omitido ou menor que 50 chars).
+
+**Por que existe:** agentes futuros lendo o scout arquivado em cold-load precisam reconstruir o contexto sem histórico de conversa. O `parent_session_excerpt` é o único campo que explica o WHY.
+
+**Solução:** passe um excerpt informativo da sessão pai (50-1000 chars):
+
+```bash
+--parent-session-excerpt="Usuário reportou bug onde workflow:next herda featureSlug anterior em novos handoffs; investigando loadOrCreateState em workflow-next.js"
+```
+
+---
+
+## Scouts órfãos acumulando em `.aioson/runtime/scouts/`
+
+**Sintoma:** `aioson doctor .` reporta advisory `scouts_directory_pruning` com scouts antigos sem `feature_slug`.
+
+**O que são:** scouts despachados sem `--feature-slug` ou de features já fechadas cujo `feature_slug` não corresponde a nenhuma feature em `features.md`.
+
+**Solução:**
+
+```bash
+# Ver quais seriam podados
+aioson doctor . --json | grep scouts_directory_pruning
+
+# Podar (apaga scouts órfãos > 90d; NUNCA poda scouts com feature_slug)
+aioson doctor . --fix
+```
+
+Para preservar um scout órfão manualmente antes da poda (ex: para auditoria futura), copie-o para fora do diretório de runtime ou associe-o a uma feature:
+
+```bash
+cp .aioson/runtime/scouts/{id}.json .aioson/context/features/{slug}/scouts/
+```
+
+---
+
+## `aioson update` sobrescreve `scout-engine.json`
+
+**Sintoma:** customizações em `.aioson/config/scout-engine.json` são perdidas após `aioson update`.
+
+**Status:** comportamento atual do installer (M-01 follow-up — veja também o mesmo issue em `learning-loop.json`). A correção (merge inteligente) está em planejamento como feature MICRO.
+
+**Workaround:** faça backup antes de rodar `aioson update`:
+
+```bash
+cp .aioson/config/scout-engine.json /tmp/scout-engine-backup.json
+aioson update
+# restaurar customizações manualmente
+```
+
+---
+
+## `scope_globs` não implementado
+
+**Sintoma:** `error.code = "globs_not_implemented_v1"` ao usar `--scope-globs`.
+
+**Por que:** Node 18-21 não tem `fs.glob` nativo; adicionar dependência de glob quebraria a política zero-deps do V1.
+
+**Workaround:** use `scope_paths` com arquivos explícitos ou diretórios (1 nível de expansão). Globs serão suportados em V2.

package/docs/pt/living-memory/README.md

@@ -0,0 +1,81 @@
+# Memória Viva — guia em português
+
+> **Memória Viva** é o nome do conjunto de capacidades que mantém o AIOSON ciente do projeto **enquanto ele muda**. Em vez de ler o repositório do zero a cada sessão, o framework guarda um resumo semântico em `bootstrap/`, atualiza esse resumo automaticamente quando uma sessão muda algo relevante, e usa um contrato de autonomia em três níveis para decidir o que pode rodar sozinho, o que precisa notificar, e o que precisa de humano.
+
+Esta pasta é a porta de entrada para entender e usar a feature. Ela é dividida em **conceito**, **como funciona**, **referência** e **operação**.
+
+---
+
+## Para que serve
+
+- **Acelerar agentes** — quando `@dev`, `@qa` ou `@deyvin` começam uma sessão, eles leem o `bootstrap/` em vez de varrer o código. Menos contexto consumido, mais sessão útil.
+- **Manter o resumo fiel** — toda sessão que mexe em rotas, models, PRDs ou volume alto de código atualiza `bootstrap/*.md` antes do próximo agente entrar. Sem intervenção humana.
+- **Dar autonomia controlada** — o agente pode rodar comandos read-only (tier 1) sem perguntar, comandos de memória interna (tier 2) com notificação, e nunca pode disparar operações irreversíveis (tier 3) sozinho.
+- **Diagnosticar o estado da memória** — `aioson doctor` reporta cobertura de bootstrap, drift de permissões, slashes ausentes e version mismatch com hints acionáveis.
+
+---
+
+## Roteiro de leitura
+
+### Estou começando — quero entender o conceito (10 min)
+1. [O que é Memória Viva](./memoria-viva.md) — as 4 camadas, ciclo de vida de uma sessão, problema que resolve
+2. [Diagramas](./diagramas.md) — fluxo de uma sessão completa em ASCII
+
+### Quero saber como a reflexão funciona por baixo (15 min)
+3. [Reflexão In-Harness](./reflexao-in-harness.md) — engine determinístico, manifest, validação, exemplos com comandos reais
+4. [Diagramas](./diagramas.md) seção *Reflection flow*
+
+### Vou configurar permissões / notify / harness (20 min)
+5. [Autonomy Contract](./autonomy-contract.md) — 3 tiers, comandos canônicos por tier, como cada harness aplica
+6. [Notificações inline](./notificacoes-info.md) — `aioson notify`, levels ℹ/⚠/⛔, exit codes, integração com dashboard
+
+### Algo quebrou — preciso resolver agora
+7. [Troubleshooting](./troubleshooting.md) — bootstrap 0/4, agente parece burro, push bloqueado, version drift, permissions drift, reflect rejeitado
+
+---
+
+## Comandos canônicos
+
+Os comandos abaixo são o vocabulário mínimo da Memória Viva. Cada um tem um doc próprio com detalhes.
+
+| Comando | O que faz | Doc |
+|---|---|---|
+| `aioson memory:status .` | Mostra cobertura de bootstrap, devlogs, brains, runtime | [memoria-viva](./memoria-viva.md) |
+| `aioson memory:summary . --last=5` | Resumo compacto para abrir sessão fria | [memoria-viva](./memoria-viva.md) |
+| `aioson memory:reflect-prepare . --agent=<a>` | Roda heurística + gera manifest em `.aioson/runtime/reflect-prompt.json` | [reflexao-in-harness](./reflexao-in-harness.md) |
+| `aioson memory:reflect-commit . --agent=<a> --output=<json>` | Valida output do agente e escreve em `bootstrap/*.md` | [reflexao-in-harness](./reflexao-in-harness.md) |
+| `aioson notify . --level=info\|warn\|block --topic=<t> --message=<m>` | Notificação inline com prefixo visual + telemetria | [notificacoes-info](./notificacoes-info.md) |
+| `aioson doctor .` | Diagnóstico completo, incluindo 5 checks de Memória Viva | [troubleshooting](./troubleshooting.md) |
+| `aioson doctor . --fix` | Aplica auto-correções: regenera permissões, restaura slashes, cria diretórios | [troubleshooting](./troubleshooting.md) |
+
+---
+
+## Onde os artefatos vivem
+
+| Arquivo | Papel |
+|---|---|
+| `.aioson/context/bootstrap/what-is.md` | Identidade do sistema, usuários, valor |
+| `.aioson/context/bootstrap/how-it-works.md` | Arquitetura, módulos, fluxo de dados |
+| `.aioson/context/bootstrap/what-it-does.md` | Features, regras de negócio, workflows |
+| `.aioson/context/bootstrap/current-state.md` | O que já foi entregue (append-only) |
+| `.aioson/config/autonomy-protocol.json` | Contrato canônico de autonomia (v1.1 com `tiers`) |
+| `.aioson/runtime/reflect-prompt.json` | Manifest pendente de reflexão (efêmero — apagado após commit) |
+| `.aioson/runtime/aios.sqlite` | Telemetria: eventos `memory_reflect_*`, `notify_*` |
+| `.claude/settings.json` + `.codex/`/`.gemini/`/`.opencode/` | Permissões nativas geradas a partir do protocol |
+
+---
+
+## Status
+
+A feature `living-memory` foi entregue em 5 fases entre 2026-04 e 2026-05:
+
+| Fase | Entrega | Status |
+|---|---|---|
+| 0 | Slash `/discover` em todos harnesses + `doctor.js` reconhece slashes | ✅ |
+| 1 | Engine determinístico + `memory:reflect-prepare/commit` + 3 templates | ✅ |
+| 2 | `autonomy-protocol.json` v1.1 com `tiers` + `permissions-generator` (4 harnesses) + `notify` | ✅ |
+| 3 | Capability `reflect_memory` nos manifests + hooks em `workflow:next` + `runAgentDone` + agentes com Memory reflection | ✅ |
+| 4 | 5 checks em `doctor` + 5 fix actions + i18n en/pt-BR/es/fr | ✅ |
+| 5 | Esta documentação | ✅ |
+
+A arquitetura completa está em `.aioson/context/architecture-living-memory.md`. As decisões da implementação (D1-D28) estão em `.aioson/context/spec-living-memory.md`.