@jaimevalasek/aioson 1.28.1 → 1.30.0

package/CHANGELOG.md

@@ -2,6 +2,48 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.30.0] - 2026-06-22
+
+### Added
+- **Context intelligence and hygiene tooling.** Added the `context:brief` recall path, operational `context:guard` hook adapter/injection flow, guard rule attribution, and the read-only `hygiene:scan` diagnostic for stale session/context noise.
+- **Gate D proof hardening.** Added AC-to-test audit and evidence-gated Gate D expectations across SDD, QA, and agent contracts.
+
+### Changed
+- **Agent context loading now uses canonical context paths.** Gateway and agent prompts resolve `project-pulse.md`, `features.md`, `dev-state.md`, `last-handoff.json`, and `workflow.state.json` to `.aioson/context/`, preventing root or `.aioson/` misreads during activation recovery.
+- **Feature routing and recall are stricter.** Slug resolution, recall index isolation, `context:guard` salience, and selected-context loading were tightened across the spec chain.
+
+### Fixed
+- **Context intelligence safety fixes.** Hardened hook agent-name validation, tester test-plan/test-inventory scoping, Sheldon validation scoping, deleted-file recall cleanup, Windows temp-dir cleanup, and the context subsystem P1-P5 audit findings.
+- **Feature archive restore cleanup.** Retried empty archive-directory removal during restore to avoid leaving `.aioson/context/done/{slug}/` behind on transient Windows filesystem locks.
+
+## [1.29.2] - 2026-06-13
+
+### Fixed
+- **`aioson system:publish` crashava com `Error: archiver is not a function`.** O `archiver` tinha sido atualizado para `^8.0.0`, uma reescrita ESM que removeu a API chamável `archiver('zip', opts)` e passou a exportar só classes nomeadas (`Archiver`, `ZipArchive`, …) — sem função default. Fixado de volta em `^7.0.1` (CommonJS, API chamável que `createZipBuffer` em `src/commands/store-system.js` espera), o que também elimina o `ExperimentalWarning` de ESM-em-require no Node 23.
+
+## [1.29.1] - 2026-06-12
+
+### Docs
+- **Documented the v1.29.0 selective-context model in the project docs.** New "Carregamento seletivo de contexto" section in `memoria-e-contexto.md` (the two modes, activation fast paths, mid-flow activation guards, selector-routable rules/docs frontmatter, and `rules:lint`); `context:select` and `rules:lint` added to the CLI reference; per-agent notes for squad (investigation opt-out + create-phase genome pass), copywriter (INDEX-driven genome menu + binding operational sections), genome and the profiler pipeline (operational-method layer), and activation fast-path cross-links on briefing/sheldon.
+
+## [1.29.0] - 2026-06-11
+
+### Added
+- **Activation-only fast paths across the entry agents.** `@briefing`, `@product`, `@sheldon`, `@analyst`, and `@copywriter` join `@deyvin`: bare activation loads only foundation context (plus registry frontmatter / filename listings where the agent needs a menu), presents the starting options, and stops. Required inputs are now declared with the step that needs each item — never all upfront. `@product` was compressed to fit the fast path inside its 25KB kernel budget (24,999 bytes).
+- **Activation guards on the mid-flow agents.** `@architect`, `@ux-ui`, `@pm`, `@qa`, `@orchestrator`, `@scope-check`, and `@discovery-design-doc`: activation without a feature slug reads foundation context only, reports the current stage, asks which feature to work on, and stops. `@qa`'s legacy eager loading section (the "design governance" variant) is replaced by `context:select`-backed Context loading modes. `@validator` heading aligned (its strict sandbox semantics were already the tightest loader in the framework).
+- **The eager rules/docs loading section is retired framework-wide.** `@tester`, `@squad`, `@site-forge`, and `@discover` replace "Project rules, docs & design docs" with on-demand Context loading modes; gateways (CLAUDE.md/AGENTS.md) describe rule loading as on-demand; a contract test bans every variant of the eager section in every template agent.
+- **Selector-routable rules and docs.** All template rules carry routing frontmatter (`modes`, `task_types`, `triggers`, `paths`, `load_tier`) — description-only rules were selector-invisible (+20 < threshold 30). 41 template docs (squad, sheldon, dev, deyvin, pentester, tester, dossier, site-forge, governance) gain the same routing fields. `context:select` activation-only mode generalized to all workflow agents (per-agent foundation allowlist).
+- **`aioson rules:lint [--docs] [--strict] [--json]`** — flags selector-invisible rules (and docs with `--docs`), missing required fields, and suggests routing metadata. `--strict` exits 1 on warnings for CI. Template ships 67/67 selector-visible files, locked by test.
+- **Squad creation: investigation is opt-out and genomes enter the loop.** Tier-2 domains run `@orache` by default; tier-3 with no sourceDocs gets an announced Quick Scan. New `squad-create` Step 5.5 (genome pass): planned genomes are reused or generated via `@genome` and bound (manifest `genomes`+`genomeBindings`, executor `## Active genomes`, `squad.md`); pending bindings are queued with `status: pending` and surfaced — never silently empty.
+- **Operational-method layer in the persona pipeline.** Benchmarked against practitioner source prompts (Stefan Georgi / RMBC): `@profiler-enricher` Module 9 extracts the executable method (procedure, output structure, style metrics, prohibitions, delivery checklist) from evidence; `@profiler-forge` emits it as five required Genome 3.0 sections; `@genome` treats a missing `## Operating Procedure` on function/practitioner-persona genomes as a generation defect; genome-bindings propagate Prohibitions → executor Hard constraints, Delivery Checklist → squad checklists, Operating Procedure → Response pattern.
+- **`@copywriter` genome menu via `INDEX.md`.** New Step G2.4 discovers all installed genomes (masters, personas, domain, brand-voice) through `.aioson/genomes/INDEX.md` with its audience/output-type selection guides; the hardcoded master list becomes the index-absent fallback. The menu serves marketing pages, content, site copy, and system/UI microcopy. Operational sections of a selected genome are binding for the piece (procedure, prohibitions, style metrics, delivery checklist).
+
+### Changed
+- `@orache` squad rules load by frontmatter match instead of wholesale scan; `@squad` decision-gating and `@sheldon` mining restricted to selected context; `@sheldon` brain index loads after PRD selection instead of on activation.
+
+### Tests
+- Contract suites for every fast path/guard (tokens + section ordering), per-agent activation-only selection, rules/docs routing visibility (67/67), `rules:lint` behavior, squad investigation/genome-pass tokens, operational-method tokens across the pipeline, and copywriter INDEX discovery. Full suite green (3227 pass).
+
 ## [1.28.0] - 2026-06-11
 
 ### Added

package/README.md

@@ -246,7 +246,7 @@ aioson context:monitor     # ASCII bars, warning/critical detection
 ```
 ```
 Context usage ████████████░░░░ 73%  ⚠ approaching threshold (SMALL: 65%)
-Agents recommend /clear before next phase
+Agents recommend /compact before the next same-feature phase; /clear is reserved for hard resets
 ```
 
 **FTS5 Search Index** — find anything across all your project artifacts in milliseconds:
@@ -730,10 +730,12 @@ aioson intake:ask [path] --agent=<agent> --schema=<questions.json> [--out=<answe
 
 ```bash
 aioson preflight [path] [--json]
-aioson classify [path] [--json]
-aioson gate:check [path] --gate=A|B|C|D [--json]
-aioson artifact:validate [path] --feature=<slug> [--json]
-aioson detect:test-runner [path] [--json]
+aioson classify [path] [--json]
+aioson gate:check [path] --gate=A|B|C|D [--json]
+aioson artifact:validate [path] --feature=<slug> [--json]
+aioson ac:test-audit [path] --feature=<slug> [--json]
+aioson sdd:benchmark [path] --feature=<slug> [--json]
+aioson detect:test-runner [path] [--json]
 aioson agent:audit [path] [--json]
 aioson brief:gen [path] --feature=<slug> [--json]
 aioson verify:gate [path] --feature=<slug> [--json]

package/docs/en/5-reference/cli-reference.md

@@ -677,23 +677,53 @@ aioson harness:check . --slug=checkout
 # Run only a subset of criteria
 aioson harness:check . --slug=checkout --criteria=C1,C3
 
-# Custom timeout and JSON output (exit 0 = pass)
-aioson harness:check . --slug=checkout --timeout=120000 --json
+# Custom timeout and JSON output (exit 0 = pass)
+aioson harness:check . --slug=checkout --timeout=120000 --json
+
+# Strict mode: binary criteria without verification block the result
+aioson harness:check . --slug=checkout --strict
 ```
 
 **Options:**
 - `--slug=<feature>` — feature slug matching the harness contract. If omitted, the active contract is auto-discovered.
-- `--criteria=C1,C2` — run only the listed criteria instead of all verifiable ones.
-- `--timeout=<ms>` — per-criterion timeout override.
-- `--json` — structured output; exit code propagated.
+- `--criteria=C1,C2` — run only the listed criteria instead of all verifiable ones.
+- `--timeout=<ms>` — per-criterion timeout override.
+- `--strict` — fail when binary criteria lack executable `verification` or no executable criterion exists.
+- `--json` — structured output; exit code propagated.
 
 **What it does:** the `verification` field is authored per criterion by `@sheldon` for every mechanically-checkable `binary: true` criterion (prefer the project test runner; deterministic; cross-platform; exit 0 = pass). `harness:check` is the standalone deterministic verification of those criteria — it never touches the circuit-breaker state (that stays exclusive to `harness:validate`/`apply-validation`). Legacy contracts without `verification` remain valid; `validateContract` only emits an advisory **warning** for `binary: true` criteria lacking it. `@validator` runs `harness:check` first and copies the exit-code verdicts verbatim into `results[].passed`, LLM-judging only the criteria without `verification`.
 
-See [Executable verification](./executable-verification.md) for the full theme.
-
----
-
-## harness:validate
+See [Executable verification](./executable-verification.md) for the full theme.
+
+---
+
+## ac:test-audit
+
+Map declared acceptance criteria to deterministic test evidence.
+
+```bash
+aioson ac:test-audit . --feature=checkout
+aioson ac:test-audit . --feature=checkout --json
+```
+
+**What it does:** extracts `AC-*` IDs from `requirements-{slug}.md`, `prd-{slug}.md`, and `conformance-{slug}.yaml`, then checks whether each ID appears in a test file or an executable harness criterion. Gate D treats missing evidence as blocking when ACs are declared.
+
+---
+
+## sdd:benchmark
+
+Generate a deterministic SDD quality snapshot for a feature.
+
+```bash
+aioson sdd:benchmark . --feature=checkout
+aioson sdd:benchmark . --feature=checkout --strict --json
+```
+
+**What it does:** combines artifact presence, `spec:analyze`, and `ac:test-audit` into a reproducible score and writes `.aioson/context/retro/sdd-benchmark-{slug}.md`.
+
+---
+
+## harness:validate
 
 Generate the `validator-prompt.txt` for the binary success contract and append a self-contained **review payload** so the validator can judge in a fresh, isolated context. Consumes the verdict back through the circuit breaker.
 

package/docs/pt/4-agentes/briefing.md

@@ -70,6 +70,8 @@ Você > Todos.
 4. `.aioson/context/prd*.md` e `prds/*.md` — evita duplicar trabalho já comprometido.
 5. Web search quando há premissas que precisam de validação externa.
 
+> **Fast path de ativação (v1.29.0):** ativar `@briefing` "seco", sem nomear plano ou tarefa, carrega **só** o `project.context.md`, o frontmatter do registro e a *listagem de nomes* de `plans/` — apresenta o menu e para. O conteúdo dos planos e PRDs acima entra só no passo que os usa. Veja [Carregamento seletivo de contexto](../5-referencia/memoria-e-contexto.md#carregamento-seletivo-de-contexto-v1290).
+
 ## Handoff típico
 
 - **Vem de:** você, com anotações em `plans/` ou uma ideia conversacional.

package/docs/pt/4-agentes/copywriter.md

@@ -53,6 +53,8 @@ A grande diferença em relação a um "prompt de copy genérico" é que ele tem
 
 ## Selecionar a mente do copywriter (genomes)
 
+> **Menu via INDEX (v1.29.0):** a descoberta de genomes agora lê o `.aioson/genomes/INDEX.md` — o registro de **todos** os genomes instalados (mestres, personas, domínio, brand-voice), com guias de seleção por audiência e por tipo de output. O menu aparece quando você pergunta "quais genomes tenho", na ativação seca, ou quando mais de um genome serve para a peça. Vale para qualquer entrega: páginas de marketing, conteúdo, copy de site e **microcopy de sistema** (botões, empty states, onboarding, mensagens de erro). Quando o genome escolhido tem seções operacionais (geradas pelo pipeline de persona — `## Operating Procedure`, `## Prohibitions`, `## Style Metrics`, `## Delivery Checklist`), elas são **vinculantes** para a peça: o procedimento dirige o fluxo, as proibições viram hard constraints e o checklist roda na validação final.
+
 Quando há múltiplos genomes de mestres instalados, o `@copywriter` pergunta qual perspectiva aplicar. **8 mestres disponíveis** organizados em 2 hemisférios:
 
 ### Mestres universais (US, em inglês — adaptam-se ao idioma do projeto)

package/docs/pt/4-agentes/genome.md

@@ -105,6 +105,7 @@ aioson system:publish --type=genome --slug=<slug>
 ## Detalhes recentes
 
 - **Genome 4.0 (2026):** novos campos `anchor_prompt`, `relations`, `hexaco_h`, e `trait_interactions` — o genome passou a modelar como traços interagem entre si, não apenas listá-los isoladamente
+- **Camada de método operacional (v1.29.0):** genomes de função e de persona-praticante agora carregam **o que a pessoa FAZ**, não só quem ela é. Cinco seções obrigatórias — `## Operating Procedure` (o método em passos executáveis, ex: RMBC), `## Output Structure`, `## Style Metrics`, `## Prohibitions`, `## Delivery Checklist` — extraídas das evidências pelo pipeline de persona. Um genome de praticante sem `## Operating Procedure` simula opiniões, não trabalho, e é tratado como defeito de geração. Ao vincular num squad, essas seções se propagam: proibições viram hard constraints do executor, o checklist vira checklist do squad, e o procedimento dirige o padrão de resposta.
 
 ---
 

package/docs/pt/4-agentes/pm.md

@@ -117,7 +117,7 @@ aioson workflow:status .
 **Feature MEDIUM (pré-dev):**
 - **Vem de:** `@discovery-design-doc`
 - **Produz:** `implementation-plan-{slug}.md` (Gate C)
-- **Vai para:** STOP — desenvolvedor faz `/clear` e ativa `/dev`
+- **Vai para:** STOP — desenvolvedor faz `/compact` e ativa `/dev` quando continuar a mesma feature; usa `/clear` só para reset forte
 
 **Projeto MEDIUM (modo completo):**
 - **Vem de:** `@ux-ui`

package/docs/pt/4-agentes/profiler-enricher.md

@@ -71,6 +71,8 @@ Você > proceed
 └── enriched-profile.md      ← saída desta etapa
 ```
 
+> **Método operacional (v1.29.0):** além do perfil psicométrico (DISC, Big Five, etc.), o enricher extrai das evidências o **método executável** da pessoa — procedimento em passos, estrutura de output, métricas de estilo, proibições e checklist de entrega (a seção `## Operational Method` do perfil). É o que faz o genome simular *o que a pessoa faz*, não só suas opiniões. Quando a fonte não documenta um método passo a passo, ele é reconstruído e marcado `inferred` — nunca inventado.
+
 ---
 
 ## Como ele lê seu projeto

package/docs/pt/4-agentes/profiler-forge.md

@@ -71,6 +71,8 @@ Você > 3
 .aioson/genomes/{slug}-advisor.md        ← advisor como prompt utilizável
 ```
 
+> **Seções operacionais (v1.29.0):** o forge emite o método capturado pelo enricher como cinco seções obrigatórias no genome — `## Operating Procedure`, `## Output Structure`, `## Style Metrics`, `## Prohibitions`, `## Delivery Checklist`. Um genome de persona-praticante sem `## Operating Procedure` é tratado como defeito de geração. Veja [genome.md](./genome.md) para como essas seções se propagam ao vincular num squad.
+
 ---
 
 ## Como ele lê seu projeto

package/docs/pt/4-agentes/sheldon.md

@@ -80,6 +80,8 @@ O `@sheldon` decide entre **enriquecer in-place** ou **criar plano faseado** dep
 5. `.aioson/briefings/{slug}/briefings.md` — se `briefing_source` está no PRD.
 6. `plans/*.md` e `prds/*.md` — fontes de pesquisa pré-produção do usuário.
 
+> **Fast path de ativação (v1.29.0):** ativar `@sheldon` "seco", sem PRD/slug, carrega **só** o `project.context.md`, a listagem de nomes dos `prd*.md` e a tabela `features.md` — apresenta a lista de PRDs para seleção e para. O conteúdo do PRD e o índice de brains entram só depois da escolha do alvo. Veja [Carregamento seletivo de contexto](../5-referencia/memoria-e-contexto.md#carregamento-seletivo-de-contexto-v1290).
+
 ## Handoff típico
 
 - **Vem de:** `@product` (PRD gerado) — pode ser ativado N vezes antes de ir adiante.

package/docs/pt/4-agentes/squad.md

@@ -93,16 +93,16 @@ Antes de criar, o `@squad` lê:
 
 ## Comandos CLI relacionados
 
-```bash
-# Criar squad via CLI
-aioson squad:scaffold . --slug=<slug> --name="Meu Squad" --mode=mixed
-
-# Diagnosticar squad existente
-aioson squad:doctor . --squad=<slug>
-
-# Publicar no aioson.com
-aioson system:publish --type=squad --slug=<slug>
-```
+```bash
+# Criar squad via CLI
+aioson squad:scaffold . --slug=<slug> --name="Meu Squad" --mode=mixed
+
+# Diagnosticar squad existente
+aioson squad:doctor . --squad=<slug>
+
+# Publicar no aioson.com
+aioson system:publish --type=squad --slug=<slug>
+```
 
 ---
 
@@ -117,6 +117,8 @@ aioson system:publish --type=squad --slug=<slug>
 
 - **domain breadth (Mai/2026):** executores que antes recusavam pedidos adjacentes ao seu escopo agora respondem com mais amplitude contextual
 - **squad refresh:** `@squad refresh <slug>` atualiza um squad existente com nova investigação sem recriar do zero
+- **investigação opt-out (v1.29.0):** a investigação de domínio com `@orache` agora roda **por padrão** — completa para domínios regulados/especializados, Quick Scan (1–2 rodadas) para domínios comuns sem fontes. É o que aterra os executores em frameworks/vocabulário reais em vez de priors do modelo (a causa nº1 de executor raso). O `@squad` anuncia o scan em vez de perguntar; diga "pula" para dispensar.
+- **genome pass na criação (v1.29.0):** os genomes planejados por executor são gerados e vinculados **durante** a criação do squad — não mais como passo manual depois. Um squad de domínio especializado nunca sai com `## Active genomes` vazio: ou vincula o genome, ou entrega o comando `@genome` exato pendente no resumo da criação. Para re-aterrar executores rasos de squads antigos, rode `@squad refresh <slug>`.
 
 ---
 

package/docs/pt/5-referencia/autopilot-handoff.md

@@ -33,7 +33,7 @@ Sem essa flag (ou com `false`), o comportamento padrão é handoff manual — ca
         STOP — human entra com /dev
 ```
 
-A cadeia pré-dev **sempre para antes do primeiro `@dev`**. O desenvolvedor faz `/clear` (limpa o contexto) e inicia a implementação numa janela de contexto fresca — `@dev` é pesado e se beneficia de contexto limpo.
+A cadeia pré-dev **sempre para antes do primeiro `@dev`**. O desenvolvedor faz `/compact` quando continua a mesma feature e inicia a implementação a partir do pacote/checkpoint de contexto — `@dev` é pesado e se beneficia de um handoff operacional compacto. Use `/clear` apenas para reset forte, troca de feature, contexto poluído ou reset sensível a segurança.
 
 ### Segmento 2 — Ciclo de revisão pós-dev (hub = @qa)
 
@@ -87,7 +87,7 @@ O autopilot interrompe a cadeia e emite o handoff manual normal quando:
 3. **Cap de correções atingido** — ciclo `@qa` ↔ `@dev` limitado a 2 rounds.
 4. **Finding crítico de segurança** — keywords auth/secret/credential/session/password/token/PII detectados pelo gate de segurança do `@qa` → STOP, requer intervenção humana.
 5. **Verdict não passou** — `@scope-check` não aprovado, `@architect` Gate B bloqueado, `@discovery-design-doc` readiness bloqueado, `@pm` Gate C bloqueado, `@validator` FAIL sem caminho seguro → STOP, roteamento manual.
-6. **Orçamento de contexto** — uso ≥ `context_warning_threshold`: grava checkpoint em `last-handoff.json`, STOP, recomenda `/clear`. A próxima sessão reentra no autopilot automaticamente.
+6. **Orçamento de contexto** — uso ≥ `context_warning_threshold`: grava checkpoint em `last-handoff.json`, STOP, recomenda `/compact` para continuidade na mesma feature. A próxima sessão reentra no autopilot automaticamente. Use `/clear` apenas para reset forte, troca de feature, contexto poluído ou reset sensível a segurança.
 7. **Ambiguidade** — estado do workflow indisponível ou qualquer decisão real requer input humano → STOP.
 
 O usuário pode interromper a qualquer momento com Ctrl+C. O autopilot nunca retenta uma invocação interrompida.
@@ -130,9 +130,9 @@ Você > /analyst  (start)
 @scope-check → pre-dev check → autopilot: invocando @architect
 @architect   → Gate B PASS → autopilot: invocando @discovery-design-doc
 @discovery-design-doc → readiness ok → autopilot: invocando @pm (MEDIUM)
-@pm          → Gate C PASS → STOP — "Recomendo /clear e /dev"
+@pm          → Gate C PASS → STOP — "Recomendo /compact e /dev"
 
-Você > /clear
+Você > /compact
 Você > /dev  (implementação manual — contexto limpo)
 
 @dev → testes ok → autopilot retoma: invocando @qa

package/docs/pt/5-referencia/comandos-cli.md

@@ -150,6 +150,8 @@
 | `skill:list` | Lista skills instaladas em `.aioson/installed-skills/` | Quando quer saber quais skills estão ativas |
 | `skill:remove` | Remove skill instalada e limpa diretórios de ferramentas | Quando uma skill não é mais necessária |
 | `compress:agents` | Comprime arquivos de instrução dos agentes para reduzir consumo de tokens por sessão. Modo estrutural (gratuito) ou semântico via LLM (`--llm`). Salva backup automático em `.original.md`. Aceita `--agent`, `--rules`, `--dry-run`, `--restore`. | Quando quer reduzir custo de API sem alterar nenhuma lógica. Veja [compress:agents](./compress-agents.md) |
+| `context:select` | Seleciona sob demanda só as regras/docs/design-docs relevantes para a tarefa atual, por agente e modo (`--mode=planning\|executing`). Aceita `--agent`, `--task`, `--paths`, `--feature`, `--json`. | É o motor por trás dos *fast paths* e *activation guards* — os agentes o invocam para carregar só o que a task exige. Veja [Memória e Contexto](./memoria-e-contexto.md) |
+| `rules:lint` | Acusa regras (e docs, com `--docs`) "invisíveis ao seletor" — sem `task_types`/`triggers`/`paths` e sem `load_tier: always`, que o `context:select` nunca carregaria sob demanda. Aceita `--docs`, `--strict` (sai com código 1 em CI), `--json`. | Depois de criar/editar regras ou docs em `.aioson/rules/` ou `.aioson/docs/` — confirma que o seletor consegue roteá-los. Veja [Memória e Contexto](./memoria-e-contexto.md) |
 | `design-hybrid:options` | Abre um seletor visual com setas + espaço para montar um preset temporário de variações de design | Quando quer alimentar a `design-hybrid-forge` com direções mais extravagantes, clássicas, animadas ou com CSS avançado. Usa o locale do projeto automaticamente e aceita `--locale` como override; com `--advanced` libera um 3º modificador. Veja [design-hybrid-forge](../4-agentes/design-hybrid-forge.md) |
 
 ### Cloud
@@ -224,8 +226,10 @@ Scripts determinísticos que movem verificações de estado, validação de arte
 | `feature:archive` | Move artefatos de uma feature `done` para `.aioson/context/done/{slug}/` e atualiza o manifest | Chamado pelo `feature:close` automaticamente; também disponível para retroativo com `--dry-run` e `--restore` |
 | `feature:export` | **Copia** todos os artefatos de uma feature para um `--out` limpo, sem mexer na origem; gera `INDEX.md` | Exportar specs para analisar fora, entregar a cliente, ou usar o AIOSON só como gerador de specs. Veja [feature-export.md](./feature-export.md) |
 | `gate:check` | Valida pré-requisitos e artefatos de um phase gate (A/B/C/D); retorna PASS ou BLOCKED | Antes de avançar para o próximo agente |
-| `artifact:validate` | Verifica a cadeia completa de artefatos de uma feature (PRD → spec → plano → conformance) | A qualquer momento para checar completude |
-| `spec:analyze` | Irmão de **conteúdo** do `artifact:validate`: consistência cruzada entre os artefatos (rastreabilidade REQ/AC, staleness, readiness, sanidade do contrato, vínculo AC→contrato, overlap de waves) antes do gate de execução | No preflight do `@scope-check` — errors viram blockers, warnings viram evidência de drift |
+| `artifact:validate` | Verifica a cadeia completa de artefatos de uma feature (PRD → spec → plano → conformance) | A qualquer momento para checar completude |
+| `ac:test-audit` | Mapeia cada `AC-*` declarado em PRD/requisitos/conformance para evidência em testes ou critério executável do harness | Antes do Gate D; falha quando algum AC não tem prova de teste |
+| `sdd:benchmark` | Gera score determinístico de SDD usando cadeia de artefatos, `spec:analyze` e `ac:test-audit`; salva relatório em `.aioson/context/retro/` | Para medir a qualidade do harness sem depender de julgamento solto |
+| `spec:analyze` | Irmão de **conteúdo** do `artifact:validate`: consistência cruzada entre os artefatos (rastreabilidade REQ/AC, staleness, readiness, sanidade do contrato, vínculo AC→contrato, overlap de waves) antes do gate de execução | No preflight do `@scope-check` — errors viram blockers, warnings viram evidência de drift |
 | `forge:compile` | **Lane B:** compila os artefatos de uma feature MEDIUM num `forge-run.workflow.js` auditável e versionável (parallel por Wave → convergência no `harness:check` → revisão adversarial → validador fresh-context) | Quando quer execução compilada e reproduzível via `@forge-run`; nunca roda `feature:close`/publish |
 | `workflow:execute` | Monta e executa o plano de agentes baseado na classificação; aceita `--dry-run` e `--start-from` | Para orquestrar features sem o dashboard |
 | `runner:run` | Executa uma tarefa ou worker diretamente pelo runner | Quando quer executar fora do loop principal de sessão |
@@ -985,7 +989,7 @@ O manifest em `.aioson/context/done/MANIFEST.md` registra todas as features arqu
 # Verificar se está no safe zone (< 60%), warning (60–80%) ou critical (≥ 80%)
 aioson context:monitor . --budget=80000 --tokens=52000
 # ⚠ Context: 52,000 tokens (65%) — WARNING
-# Suggestion: /clear before next agent activation
+# Suggestion: /compact before next agent activation; use /clear only for a hard reset
 
 # Verificar com output JSON para integrar em scripts
 aioson context:monitor . --budget=80000 --tokens=67000 --json

package/docs/pt/5-referencia/fluxo-artefatos.md

@@ -52,7 +52,7 @@ O PRD produzido pelo @product é o **documento base vivo** — nenhum agente dow
 - `sheldon-enrichment-{slug}.md` (ou `sheldon-enrichment.md`) em `.aioson/context/` — log de cada rodada, decisões de gray areas, score e readiness
 
 **No Modo C (validação completa)**, gera adicionalmente:
-- `sheldon-validation.md` — relatório de auditoria com gate por agente (🟢/🟡/🔴)
+- `sheldon-validation-{slug}.md` (projeto: `sheldon-validation.md`) — relatório de auditoria com gate por agente (🟢/🟡/🔴)
 - `.aioson/plans/{slug}/checklist.md` — checklist de implementação por fase
 
 **Pesquisas web (RF-WEB)** ficam em:

package/docs/pt/5-referencia/memoria-e-contexto.md

@@ -229,13 +229,13 @@ aioson context:monitor . --budget=80000 --tokens=52000
 
 ```
   ⚠ Context: 52,000 tokens (65%) — WARNING
-  Suggestion: /clear before next agent activation
+  Suggestion: /compact before next agent activation; use /clear only for a hard reset
 ```
 
 | Zona | Faixa | Ação |
 |---|---|---|
 | safe | < 60% | Continuar normalmente |
-| warning | 60–80% | Planejar `/clear` antes do próximo agente |
+| warning | 60–80% | Planejar `/compact` antes do próximo agente; usar `/clear` só para reset forte |
 | critical | ≥ 80% | Rodar `context:health` e reduzir carga |
 
 **Thresholds por classificação** (para automonitoramento dos agentes, configurado em `.aioson/config.md`):
@@ -260,6 +260,66 @@ Quando a zona é `warning` ou `critical`, um evento é automaticamente registrad
 
 ---
 
+## Carregamento seletivo de contexto (v1.29.0+)
+
+As 3 camadas acima resolvem *onde* a memória mora. Esta seção resolve um problema diferente: *quando* cada arquivo entra na janela de contexto. Antes, ativar um agente carregava de tudo — regras, docs, design-docs, specs — logo de cara, mesmo que a tarefa não precisasse. A partir da v1.29.0 isso é seletivo: o agente carrega só o que a task atual exige, e o resto entra sob demanda.
+
+### Os dois modos
+
+Todo agente que mexe com contexto opera em dois modos explícitos, via `context:select`:
+
+| Modo | Quando | O que carrega |
+|---|---|---|
+| **PLANNING** | Inspecionar status, listar fontes, decidir o próximo passo | Só fundação + frontmatter; nunca pastas inteiras de regras/docs |
+| **EXECUTING** | Antes de escrever/editar um artefato ou código | Só as regras/docs/design-docs selecionados para os arquivos em questão |
+
+```bash
+aioson context:select . --agent=dev --mode=planning  --task="<tarefa>" --paths="<arquivos conhecidos>"
+aioson context:select . --agent=dev --mode=executing --task="<tarefa>" --paths="<arquivos a tocar>"
+```
+
+A saída traz a linha **Boundary**: *"carregue só os arquivos selecionados até a task, o modo, a feature ou os paths mudarem"*. Ou seja: quando o assunto muda no meio da conversa, o agente roda o seletor de novo com a task nova — não fica preso ao que carregou na entrada.
+
+### Fast path de ativação (agentes de entrada)
+
+Ativar um agente "seco" — `@briefing`, `@product`, `@sheldon`, `@analyst`, `@copywriter` (e `@deyvin`) sem nomear feature/tarefa — carrega **só o contexto de fundação** (`project.context.md` + `project-pulse.md`, mais o registro/listagem que o agente precisa para o menu), apresenta as opções de início e para. Nada de PRDs, dossiers, regras ou skills antes de você dizer o que fazer.
+
+### Guarda de ativação (agentes de meio de fluxo)
+
+`@architect`, `@ux-ui`, `@pm`, `@qa`, `@orchestrator`, `@scope-check` e `@discovery-design-doc` ganharam uma **guarda de ativação**: ativados sem slug de feature, leem só a fundação, reportam o estágio atual do workflow, perguntam qual feature trabalhar e param. Os artefatos pesados (specs, requirements, arquitetura) entram só na etapa que os usa.
+
+### Regras e docs roteáveis pelo seletor
+
+Para o `context:select` conseguir escolher uma regra ou doc, o arquivo precisa de **frontmatter de roteamento** — senão ele é "invisível ao seletor" e nunca é carregado sob demanda:
+
+```yaml
+---
+description: "..."
+agents: [dev, qa]          # quem pode carregar
+modes: [planning, executing]
+task_types: [payment, billing]
+triggers: [money, pricing, checkout]   # palavras/frases batidas contra a task
+paths: [src/billing/**]                # globs batidos contra os arquivos tocados
+load_tier: trigger                     # trigger (padrão) | always | justified
+---
+```
+
+Uma regra só com `description` (sem `task_types`/`triggers`/`paths` e sem `load_tier: always`) pontua abaixo do corte e o seletor nunca a carrega. Para auditar isso:
+
+```bash
+aioson rules:lint .            # acusa regras invisíveis ao seletor
+aioson rules:lint . --docs     # inclui .aioson/docs/ na varredura
+aioson rules:lint . --strict   # sai com código 1 se houver avisos (para CI)
+```
+
+> **Depois de `aioson update` em um projeto:** rode `aioson rules:lint . --docs`. Ele aponta exatamente quais regras/docs locais seus ficaram sem metadata de roteamento e precisam de `triggers`/`task_types`/`paths` para o seletor enxergá-los.
+
+### Por que isso reduz tokens
+
+Lazy-loading rende ~10x mais que comprimir prosa: deixar de carregar PRDs/dossiers/regras inteiros na ativação economiza ~10–25k tokens por sessão, contra ~1k de uma compressão de texto. Os dois se somam — o [`compress:agents`](./compress-agents.md) enxuga o arquivo do agente; o carregamento seletivo evita puxar arquivos que a task nem usa.
+
+---
+
 ## Onde tudo vive
 
 ```

package/docs/pt/_arquivo/monitor-de-contexto.md

@@ -69,7 +69,7 @@ aioson context:monitor [path] --budget=<tokens-totais> --tokens=<tokens-atuais>
 | Zona | Faixa | Ícone | Ação sugerida |
 |---|---|---|---|
 | safe | < 60% | ✓ | Continuar normalmente |
-| warning | 60–80% | ⚠ | Planejar `/clear` antes do próximo agente |
+| warning | 60–80% | ⚠ | Planejar `/compact` antes do próximo agente; usar `/clear` só para reset forte |
 | critical | ≥ 80% | ! | Rodar `context:health` e reduzir carga |
 
 **Exemplos:**
@@ -82,7 +82,7 @@ aioson context:monitor . --budget=80000 --tokens=28000
 # Sessão em warning zone
 aioson context:monitor . --budget=80000 --tokens=52000
 #   ⚠ Context: 52,000 tokens (65%) — WARNING
-#   Suggestion: /clear before next agent activation
+#   Suggestion: /compact before next agent activation; use /clear only for a hard reset
 
 # Sessão em critical zone
 aioson context:monitor . --budget=80000 --tokens=67000

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jaimevalasek/aioson",
-  "version": "1.28.1",
+  "version": "1.30.0",
   "description": "AI operating framework for hyper-personalized software.",
   "keywords": [
     "ai",
@@ -46,8 +46,10 @@
     "ci": "npm run lint && npm test"
   },
   "dependencies": {
-    "archiver": "^8.0.0",
+    "archiver": "^7.0.1",
     "better-sqlite3": "^12.6.2",
+    "ignore": "^7.0.5",
+    "javascript-obfuscator": "^5.4.3",
     "terser": "^5.48.0"
   }
 }