wendkeep 0.86.0 → 0.88.0

package/docs/pt-BR/commands/commit.md

@@ -0,0 +1,159 @@
+# Commits baseados em evidências
+
+**PT-BR** · [English](../../en/commands/commit.md)
+
+## Objetivo
+
+Produzir a mesma mensagem auditável em Codex, Claude Code ou outro cliente Git, usando somente
+entrada tipada, referências públicas e o resumo do index staged. O kernel é determinístico e não
+lê o Vault, `.brain`, registros de sessão ou rede.
+
+## Quando usar
+
+Use antes de commits de implementação `feat`, `fix`, `refactor` ou `perf` que precisam registrar
+autoridade causal, tarefas, testes, escopo e evidência verificável de forma equivalente entre
+harnesses.
+
+## Quando não usar
+
+Não use para inventar prova, publicar conteúdo privado, reescrever histórico ou automatizar push.
+Commits `docs`, `test` e `chore` dispensam contexto somente quando todos os arquivos alterados são
+objetivamente documentação/testes. Alteração de produto exige o corpo governado mesmo com outro tipo.
+
+## Pré-requisitos
+
+Execute dentro de um repositório Git, com o WendKeep instalado localmente e os arquivos do produto
+já selecionados no index staged.
+
+## Sintaxe
+
+```bash
+npx --no-install wendkeep commit context --input <json|-> [--json]
+npx --no-install wendkeep commit context --clear [--json]
+npx --no-install wendkeep commit render --input <json|->
+npx --no-install wendkeep commit prepare --message-file <path> [--source <source>]
+npx --no-install wendkeep commit validate --message-file <path> [--json]
+```
+
+## Opções e códigos de saída
+
+- Exit `0`: contexto escrito/limpo ou mensagem válida.
+- Exit `1`: mensagem governada inválida.
+- Exit `2`: argumento, JSON, Git, privacidade ou contexto inválido/stale.
+- `--consume-context` é reservado ao wrapper `commit-msg`; remove o contexto após validação verde.
+
+## Instalação opt-in
+
+Os hooks Git não são ativados pelo `init` padrão. Para copiar os wrappers portáteis e configurar
+`core.hooksPath=.githooks` somente neste repositório:
+
+```bash
+npx --no-install wendkeep init --git-commit-hooks --yes
+```
+
+Hooks personalizados nunca são sobrescritos silenciosamente. Se o `init` encontrar conflito, ele
+preserva o arquivo. Revise-o e, somente se quiser substituí-lo, execute novamente com `--force`; o
+arquivo anterior fica em `.bak`.
+Um `core.hooksPath` customizado também é conflito: sem `--force` ele permanece intocado.
+
+## Exemplos
+
+### Preparar um commit
+
+Crie um JSON conforme `schema/commit-message-v1.schema.json`. Declare autoridade e referências de
+evidência, mas não envie `tasks`, `tests`, `fresh` ou `verified`. O runtime deriva tarefas do
+checklist canônico com Task Contracts concluídos. Testes vêm somente de sensores declarados por
+`[sensor:<id>]` e executados pelo coletor; `[phase:verify]`
+sozinho nunca é resultado. Sensors declarados no Envelope devem corresponder exatamente em IDs,
+configuração, comando, severidade e resultado à reexecução canônica; apenas essa reexecução gera a
+linha `Tests`. O gate remoto reexecuta o sensor no checkout do SHA correspondente.
+Cada referência publicada recebe digest SHA-256 rederivado. ADR/design validam
+ID/path/artefato. Tasks com `[req:]` exigem uma referência `spec` versionada e sanitizada que defina
+cada requisito. Evidence Envelope, Verdict, receipt e TDD attestation podem participar da validação
+local, mas são omitidos da Evidence remota: não há publicação de IDs de worktree/sessão/branch nem
+promoção de consistência autocontida para prova. Se uma mensagem os alegar como `fresh`/`verified`,
+o range rejeita `WENDKEEP_COMMIT_REMOTE_PROOF_UNAVAILABLE`. Os trailers fixos
+`Remote-Proof-Scope: git,authority,tasks,spec,sensors` e `Local-Causal-Proof: unpublished` tornam
+essa fronteira explícita. No range, authority/artefatos, task/spec, `Scope` Git e config/sensors são
+rederivados do SHA, e apenas a reexecução canônica gera `Tests`. `Co-Authored-By` é
+omitido enquanto não houver identidade registrada confiável.
+
+A autoridade normal é a ADR causal:
+
+```json
+{ "authority": { "kind": "adr", "adr": "ADR-1234", "ref": "docs/ADR-1234.md", "issue": "#123" } }
+```
+
+Somente quando não existe change/ADR causal, o harness nativo pode declarar o fallback abaixo.
+`issue` deve ser `#NNN` e `design` precisa estar versionado no mesmo commit sob
+`docs/superpowers/specs/` ou `plans/`:
+
+```json
+{
+  "authority": {
+    "kind": "native",
+    "issue": "#40",
+    "design": "docs/superpowers/specs/design-aprovado.md"
+  }
+}
+```
+
+O runtime confirma perfil efetivo `OFF`, ausência de context/change/lease e ADR causal reais, além
+da issue no design. Esse modo gera trailers únicos `Authority: native-no-causal-change`, `Issue` e `Design`. Texto solto,
+design não versionado, prova stale/unverified, corpo ou testes ausentes falham fechados.
+
+```bash
+git add <arquivos-do-produto>
+npx --no-install wendkeep commit context --input commit-input.json
+git commit -m "feat(escopo): rascunho"
+```
+
+`commit context` calcula o hash SHA-256 do diff staged e guarda o contexto sanitizado em
+`.git/wendkeep-commit-input.json`, fora do working tree. `prepare-commit-msg` substitui o rascunho
+pela mensagem canônica; `commit-msg` valida e consome o contexto. Se o index mudar, o contexto fica
+stale e deve ser recriado.
+O `commit-msg` relê o contexto, compara a mensagem inteira e o hash/files staged, e só consome o
+contexto após sucesso. `merge`, `squash` e amend limpam contexto incompatível para não contaminar o
+commit seguinte. `--message-file` fica contido no repositório ou git-dir.
+
+Outros comandos:
+
+```bash
+npx --no-install wendkeep commit render --input commit-input.json
+npx --no-install wendkeep commit validate --message-file .git/COMMIT_EDITMSG
+npx --no-install wendkeep commit context --clear
+```
+
+Commits realmente triviais permanecem intactos. Commits de implementação
+`feat`, `fix`, `refactor` e `perf` exigem assunto Conventional Commit com ADR ou o fallback nativo
+restrito acima, seções Capability, Evidence, Tasks, Tests e Scope, hash staged e trailer
+`WendKeep-Commit: v1`. Amend, merge e squash não recebem corpo duplicado ou prova inventada.
+
+## Privacidade e falha segura
+
+- Caminhos absolutos mesmo embutidos, qualquer Vault configurado/default, `.brain`, registros de sessão, PII e segredos são
+  rejeitados antes da persistência.
+- Evidência `reported`, `legacy-unbound`, `stale` ou `unproven` não pode ser apresentada como prova.
+- O contexto contém referências sanitizadas e metadados do diff, nunca o conteúdo privado do Vault.
+- `--no-verify` não é um fluxo aceito: o CI valida cada commit novo, inclusive merges e resoluções inéditas.
+
+## Resultado esperado
+
+Uma mensagem determinística, autocontida, sem material privado, com hash do mesmo index que foi
+commitado e trailers causais coerentes.
+
+## Erros comuns e diagnóstico
+
+`wendkeep doctor` mostra `[commit-hooks] healthy`, `disabled`, `missing` ou `drift` e permanece
+read-only. Para recuperar arquivos ausentes ou divergentes após revisão:
+
+```bash
+npx --no-install wendkeep init --git-commit-hooks --force --yes
+```
+
+Se um commit for abandonado, limpe apenas o contexto transitório com
+`wendkeep commit context --clear`. Nenhum comando reescreve histórico ou faz push automaticamente.
+
+## Próximos passos
+
+Revise a mensagem gerada, faça o commit e deixe o gate de range do PR validar qualquer bypass local.

package/docs/pt-BR/commands/observer-security.md

@@ -0,0 +1,154 @@
+# Segurança do Observer
+
+**PT-BR** · [English](../../en/commands/observer-security.md)
+
+## Objetivo
+
+O Observer é um read model local ou de equipe, nunca uma nova autoridade sobre Vault, spec, memória
+ou sync. O modelo de ameaça considera host remoto comprometido, token roubado, operador curioso,
+banco/outbox copiados, payload adversarial e purge interrompido. Host/Origin continuam validados;
+mutações e leituras sensíveis falham fechadas, inclusive no loopback.
+
+| Classe | Padrão | Risco principal |
+|---|---|---|
+| documento | `metadata` | memória/decisões integrais |
+| transcript | `metadata` | conversa e ferramentas |
+| prompt/resposta | `redacted` | PII e segredos |
+| uso | `aggregate` | custo e identidade operacional |
+| audit/receipt | metadados mínimos | apagar a própria prova |
+
+A policy v1 restringe por classe, `project_id`, glob de path e `entity_type`. Regras mais tardias
+vencem apenas no projeto correspondente. Redaction cobre Bearer, credenciais em URL/connection
+string, access keys, e-mail, telefone e regexes configuráveis seguras. O schema é
+`schema/observer-policy-v1.schema.json`.
+Em `transcript_capture: messages`, arrays, JSONL e o envelope canônico `{messages:[...]}` preservam
+somente mensagens `user|assistant|system` com `role`/`content` string após redaction; campos extras,
+tools e entradas malformadas são descartados ou falham fechados.
+A policy explícita é a única autoridade de captura do publisher; `WENDKEEP_OBSERVER_CAPTURE_LEVEL`
+é apenas compatibilidade traduzida para policy quando nenhum arquivo de policy foi fornecido e
+nunca eleva nem suprime `none|metadata|messages|full` ou documentos `selected` explícitos.
+Nos upserts de documento/transcript, `content_hash` sempre representa o conteúdo final após captura
+e redaction; captura metadata/selected usa o SHA-256 do conteúdo vazio. Exclusões de documento
+continuam efetivas mesmo com captura `none`, preservam path/revision/operação e nunca transportam
+conteúdo ou hash obsoleto.
+A redaction nunca reescreve campos validados de identidade estrutural, como IDs de projeto/evento/
+entidade, paths lógicos, revisions ou operações. A privacidade do path é aplicada de modo fail-closed
+pelas regras de captura por projeto/path, não pela renomeação da chave de storage por uma regra de
+redaction de conteúdo.
+O contrato estrutural por evento também preserva aliases snake/camel aceitos, chaves de documento/
+sessão/agente/call/transcript/rollup, timestamps, roles, status, coverage, dimensões de modelo/preço,
+workflow e proveniência de source. `title`, `summary`, `agent_name`, conteúdo, prompt/resposta e
+metadata continuam como campos de display/conteúdo sujeitos a redaction.
+Na publicação incremental, timestamps de turn ausentes ou vazios herdam o instante canônico do
+lote, epoch numérico em milissegundos é normalizado para ISO 8601 e valor não vazio inválido falha
+fechado antes da policy/store; evento e payload usam o mesmo instante.
+
+## Quando usar
+
+Use ao habilitar o Observer para dados reais, cadastrar ou revogar credenciais, restringir captura,
+proteger SQLite/outbox, definir retenção ou eliminar dados com prova verificável.
+
+## Quando não usar
+
+Não use como KMS/secret manager corporativo, para publicar Vault/runtime, para substituir a
+autoridade local ou para apagar manualmente tabelas e índices. Captura `full` continua opt-in e
+sujeita à policy/redaction.
+
+## Pré-requisitos
+
+Use Node.js 22.13+, mantenha o bind no loopback e injete tokens/chaves somente por variáveis de
+ambiente. O token de bootstrap é registrado somente pelo hash, exige projetos explícitos e
+expiração finita; não é um admin wildcard fora do registry. Para Docker, defina também
+`WENDKEEP_OBSERVER_BOOTSTRAP_PROJECTS`, `WENDKEEP_OBSERVER_BOOTSTRAP_EXPIRES_AT` e uma chave de
+32 bytes em hex/base64 em `WENDKEEP_OBSERVER_ENCRYPTION_KEY`. O operador guarda a chave e receipts externos.
+
+## Sintaxe
+
+```bash
+npx wendkeep observer serve --token <token> --bootstrap-projects <p1,p2> --bootstrap-expires-at <ISO> [--bootstrap-token-id <id>] [--require-loopback-auth] [--require-encryption]
+npx wendkeep observer security token create --project-id <projeto> --role <role> --scopes <scopes> --token-env <env> --expires-at <ISO>
+npx wendkeep observer security token rotate --project-id <projeto> --token-id <id> --token-env <env> --expires-at <ISO> [--new-token-id <id>]
+npx wendkeep observer security token revoke --project-id <projeto> --token-id <id>
+npx wendkeep observer security policy set --project-id <projeto> --file <policy.json>
+npx wendkeep observer security policy show --project-id <projeto>
+npx wendkeep observer security purge --project-id <projeto> --before <ISO> --classes <classes> [--dry-run]
+npx wendkeep observer security retention run --project-id <projeto> [--dry-run] [--operation-id <id>]
+```
+
+## Opções e códigos de saída
+
+- `viewer` lê metadata/agregados; `auditor` pode receber scopes sensíveis; `publisher` ingere;
+  `admin` administra policy, purge e recovery. Role, scope e projeto precisam autorizar juntos.
+- Tokens são persistidos somente como SHA-256; expiração, rotação e revogação valem sem restart.
+- Após rotacionar o bootstrap, atualize token e token ID no ambiente; reiniciar nunca reativa a
+  credencial antiga revogada ou expirada.
+- `--token-env` nomeia a variável com o segredo; o comando nunca imprime o valor.
+- `--require-loopback-auth` protege toda a API; reads sensíveis exigem token mesmo sem a flag.
+- `--require-encryption` falha se a chave externa estiver ausente ou inválida.
+- `WENDKEEP_OBSERVER_REQUIRE_ENCRYPTION=1` aplica a mesma falha fechada a `status`, `security`,
+  `register`, `publish` e `reconcile`; com chave configurada, todo primeiro upgrade v5 usa apenas
+  `.bak.enc` + manifest antes de qualquer leitura/backfill.
+- Exit `0` indica operação concluída; exit `1` indica configuração, autorização, policy, chave ou
+  operação inválida. O hook mantém exit `0` fail-open para o fluxo local, mas aborta antes de
+  persistir conteúdo inseguro.
+
+O audit guarda capability, resultado, rota e horário, nunca Bearer, prompt, resposta ou payload.
+
+## Exemplos
+
+Recovery offline explícito e auditado:
+
+```powershell
+$env:OBSERVER_RECOVERY_TOKEN = '<segredo-forte-temporário>'
+npx wendkeep observer security token create --data-dir C:\WendKeepObserver `
+  --project-id project-a --role admin --scopes '*' --token-env OBSERVER_RECOVERY_TOKEN `
+  --expires-at 2026-09-29T12:00:00Z --reason 'offline recovery' --json
+npx wendkeep observer security token revoke --data-dir C:\WendKeepObserver `
+  --project-id project-a --token-id <id> --reason 'recovery complete' --json
+```
+
+Sempre faça dry-run antes do purge. O runner de retenção é explícito/idempotente (CLI ou
+`POST /v1/projects/:id/security/retention`), sem timer oculto:
+
+```powershell
+npx wendkeep observer security purge --data-dir C:\WendKeepObserver `
+  --project-id project-a --before 2026-08-01T00:00:00Z `
+  --classes documents,calls,transcripts --dry-run --json
+```
+
+```powershell
+npx wendkeep observer security retention run --data-dir C:\WendKeepObserver `
+  --project-id project-a --operation-id scheduled-2026-08-29 --dry-run --json
+```
+
+## Resultado esperado
+
+TTL é independente para documentos, calls e transcripts. Contagens, remoção de projeções/FTS,
+eventos e receipt usam a mesma transação; retry é idempotente e dado antigo tardio gera nova prova.
+
+AES-256-GCM usa AAD por projeto/classe/registro/campo e `keyProvider` externo. O backfill v6 remove
+plaintext e índices derivados antes de liberar leituras; chave errada falha sem revelar conteúdo.
+A migration estrutural `006-observer-security.sql` cria backup, valida checksum, faz rollback e
+permite retry. Em modo at-rest obrigatório, o backup é `.bak.enc`, tem manifest/key ID/permissão
+restrita e restauração falha com chave errada; nenhum `.bak` plaintext permanece.
+
+O hook aplica policy metadata/redacted por padrão; `WENDKEEP_OBSERVER_POLICY_FILE` seleciona policy
+explícita. `WENDKEEP_OBSERVER_OUTBOX_KEY_ENV` nomeia a variável da chave da outbox e
+`WENDKEEP_OBSERVER_OUTBOX_KEY_ID` identifica a chave. O Compose exige autenticação e criptografia.
+O painel guarda Bearer somente em memória, exporta cópia sanitizada e expõe Segurança. MCP exige
+scope para calls/busca integral. Sync leva apenas `policy_ref`, sem duplicar tokens ou autoridade.
+
+## Erros comuns e diagnóstico
+
+- `observer_token_missing|expired|revoked`: crie/rotacione um token escopado ou faça recovery offline.
+- `observer_project_forbidden|role_forbidden|scope_forbidden`: confira a interseção projeto/role/scope.
+- `observer_encryption_key_unavailable|observer_decryption_failed`: confira key ID e material externo;
+  nunca enfraqueça o modo obrigatório.
+- `observer_policy_invalid`: valide campos/captures e remova regex inválida ou explosiva.
+- Falha de migration v6: preserve `.pre-006-*.bak.enc` e seu manifest, corrija a causa e repita.
+
+## Próximos passos
+
+Leia [Observer local](observer.md), faça um dry-run de retenção, valide token revogado/expirado e
+guarde o receipt fora do banco quando precisar de prova externa. Nunca publique banco, backup,
+outbox, chave, token ou `/data`.

package/docs/pt-BR/commands/observer.md

@@ -26,7 +26,9 @@ pelos hooks e pelo WendKeep local.
 
 Tenha Node.js 22.13 ou mais recente para executar o Observer SQL. O Keep Core e os demais comandos
 continuam compatíveis com Node.js 18 ou mais recente. Registre explicitamente cada projeto e defina
-`WENDKEEP_OBSERVER_TOKEN`; leituras no loopback permanecem abertas, mas toda mutação exige Bearer.
+`WENDKEEP_OBSERVER_TOKEN`. Toda mutação e toda leitura de conteúdo sensível exigem Bearer, inclusive
+no loopback; metadados e agregados podem permanecer abertos localmente quando
+`--require-loopback-auth` não é usado. Veja [Segurança do Observer](observer-security.md).
 
 ## Sintaxe
 
@@ -36,7 +38,7 @@ npx wendkeep observer register --project <projeto> --vault <vault> --data-dir <d
 npx wendkeep observer publish --project <projeto> --vault <vault> --data-dir <diretório>
 npx wendkeep observer reconcile --project <projeto> --vault <vault> --data-dir <diretório> [--url http://127.0.0.1:8787]
 npx wendkeep observer memory import --project <projeto> --vault <vault> --url http://127.0.0.1:8787 --token <token> --json
-npx wendkeep observer serve --host 127.0.0.1 --port 8787 --data-dir <diretório> --token <token>
+npx wendkeep observer serve --host 127.0.0.1 --port 8787 --data-dir <diretório> --token <token> --bootstrap-projects <p1,p2> --bootstrap-expires-at <ISO> [--require-loopback-auth] [--require-encryption]
 ```
 
 ## Opções e códigos de saída
@@ -46,7 +48,13 @@ npx wendkeep observer serve --host 127.0.0.1 --port 8787 --data-dir <diretório>
 - `--project` e `--vault` identificam o projeto nos comandos `register`, `publish`, `reconcile` e `memory import`.
 - `--host` aceita somente `127.0.0.1`, `localhost` ou `::1`; outros hosts são recusados antes do
   listen.
-- `--token` ou `WENDKEEP_OBSERVER_TOKEN` autentica mutações; `--allow-non-loopback` falha sem token.
+- `--token` ou `WENDKEEP_OBSERVER_TOKEN` fornece o segredo de bootstrap hash-only; projetos
+  explícitos e expiração finita são obrigatórios, e toda mutação/leitura sensível passa pelo registry;
+  `--allow-non-loopback` falha sem token.
+- `--require-loopback-auth` exige Bearer também para metadados e agregados locais e ativa a policy
+  segura do projeto na ingestão.
+- `--require-encryption` exige `WENDKEEP_OBSERVER_ENCRYPTION_KEY` com 32 bytes em hex/base64; use
+  `WENDKEEP_OBSERVER_ENCRYPTION_KEY_ID` para identificar a chave externa.
 - `WENDKEEP_OBSERVER_CAPTURE_LEVEL` aceita `metadata` (padrão, sem mensagens), `messages` ou
   `full-transcript`. Caminhos locais absolutos nunca são publicados.
 - Exit `0` indica sucesso; exit `1` indica falha de configuração ou operação; o hook publisher
@@ -57,7 +65,10 @@ npx wendkeep observer serve --host 127.0.0.1 --port 8787 --data-dir <diretório>
 ```powershell
 npx wendkeep observer register --project C:\GitHub\WendKeep --vault C:\GitHub\WendKeep\.WendKeep-vault --data-dir C:\WendKeepObserver
 $env:WENDKEEP_OBSERVER_TOKEN = '<token-local-forte>'
-npx wendkeep observer serve --host 127.0.0.1 --port 8787 --data-dir C:\WendKeepObserver --token $env:WENDKEEP_OBSERVER_TOKEN
+$env:WENDKEEP_OBSERVER_BOOTSTRAP_PROJECTS = 'project-a'
+$env:WENDKEEP_OBSERVER_BOOTSTRAP_EXPIRES_AT = '2026-09-29T12:00:00Z'
+$env:WENDKEEP_OBSERVER_ENCRYPTION_KEY = '<32-bytes-em-hex-ou-base64>'
+npx wendkeep observer serve --host 127.0.0.1 --port 8787 --data-dir C:\WendKeepObserver --token $env:WENDKEEP_OBSERVER_TOKEN --require-loopback-auth
 $env:WENDKEEP_OBSERVER_URL = 'http://127.0.0.1:8787'
 ```
 
@@ -67,15 +78,19 @@ Para Docker local:
 docker compose -f docker/wendkeep-observer/compose.yaml up -d --build
 ```
 
+O Compose exige token, allowlist/expiração do bootstrap e chave; inicia com autenticação integral
+e criptografia obrigatória. A policy `encryption_required` recusa ingestão e outbox plaintext.
+
 ## Painel web local
 
 Com o servidor em execução, abra [http://127.0.0.1:8787/](http://127.0.0.1:8787/) no navegador.
-O painel é servido pelo mesmo processo e abre diretamente para consultas, sem formulário ou token. A porta fica
-presa ao loopback do computador; não coloque o endereço em uma interface de rede.
+O painel é servido pelo mesmo processo. Informe o token no formulário local: ele fica somente na
+memória da página, segue como Bearer nas consultas e é descartado ao recarregar. A porta fica presa
+ao loopback do computador; não coloque o endereço em uma interface de rede.
 
 O painel mostra a lista multi-projeto, versão, saúde, sessão mais recente, change ativa, contagem
 de changes e data da última captura. Ao abrir um projeto, o workspace oferece Overview, Consumo,
-Sessões, Memória, Changes e Sincronização. A aba Consumo mostra custo total, tokens por categoria,
+Sessões, Memória, Changes, Sincronização e Segurança. A aba Consumo mostra custo total, tokens por categoria,
 agentes principais, subagentes, provedores, modelos, tendência diária, cobertura histórica e
 chamadas conforme o nível de captura escolhido. Os estados de carregamento, vazio, servidor
 indisponível, conflito, modelo sem tarifa e dados desatualizados ficam visíveis, e a atualização
@@ -160,18 +175,21 @@ corte. As telas do Observer não concluem, arquivam, reparam ou promovem estado.
 - `POST /v1/projects/:project_id/ingest` — lote idempotente de documentos, sessões, agentes, rollups,
   chamadas e transcripts.
 - `GET /v1/projects/:project_id/memory/tree` — árvore e metadados dos documentos.
-- `GET /v1/projects/:project_id/memory/document?path=...` — conteúdo Markdown integral.
+- `GET /v1/projects/:project_id/memory/document?path=...` — conteúdo Markdown integral; exige Bearer.
 - `GET /v1/projects/:project_id/memory/search?q=...` — busca ranqueada por chunks, com trecho do
-  match e proveniência; usa fallback lexical quando FTS5 não está disponível.
+  match e proveniência; usa fallback lexical quando FTS5 não está disponível e exige Bearer.
 - `GET /v1/projects/:project_id/sync` — modo, contagem, conflitos e último evento.
 - `PUT /v1/projects/:project_id/sync` — compatibilidade de configuração; a autoridade continua SQL.
-- `GET /v1/projects/:project_id/memory/export` — exportação read-only com conteúdo completo.
+- `GET /v1/projects/:project_id/memory/export` — exportação read-only sanitizada por padrão; exige Bearer.
 - `POST /v1/projects/:project_id/memory/events` — ingestão idempotente em lote.
 - `GET /v1/projects/:project_id/usage/summary` — totais filtráveis por período, change, sessão,
   agente, provedor, modelo e papel.
 - `GET /v1/projects/:project_id/usage/breakdown` — hierarquia de agentes, subagentes e modelos.
-- `GET /v1/projects/:project_id/usage/calls` — chamadas individuais com prompt e resposta.
-- `GET /v1/projects/:project_id/transcripts/:transcript_id` — transcript comprimido, validado por hash.
+- `GET /v1/projects/:project_id/usage/calls` — chamadas individuais com prompt e resposta; exige Bearer.
+- `GET /v1/projects/:project_id/transcripts/:transcript_id` — transcript comprimido, validado por hash; exige Bearer.
+- `GET /v1/projects/:project_id/security` — policy, contagens de tokens e audit sanitizado; exige admin.
+- `PUT /v1/projects/:project_id/security/policy` — atualiza a policy efetiva sem restart; exige admin.
+- `POST /v1/projects/:project_id/security/purge` — dry-run/purge transacional com receipt; exige admin.
 
 As rotas `/v1` rejeitam corpo transportado ou expandido acima do limite e validam projeto, caminho,
 revisão, hash, idempotência e isolamento antes de gravar o conteúdo no SQLite. Para preservar uma

package/hooks/observer-publish.mjs

@@ -1,15 +1,17 @@
 #!/usr/bin/env node
 import { pathToFileURL } from 'node:url';
 import { debugLog, readHookInput, resolveVault } from './obsidian-common.mjs';
-import { publishObserverSnapshot } from '../src/observer-publish.mjs';
+import { publishObserverSnapshot, resolveObserverPublisherSecurity } from '../src/observer-publish.mjs';
 
 async function main() {
   const input = readHookInput();
   const resolved = resolveVault(input);
+  const publisherSecurity = resolveObserverPublisherSecurity();
   const result = await publishObserverSnapshot({
     vaultBase: resolved.base,
     projectRoot: resolved.projectRoot,
     input,
+    ...publisherSecurity,
   });
   if (!result.ok && result.error) debugLog('Observer publish fail-open:', result.error);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wendkeep",
-  "version": "0.86.0",
+  "version": "0.88.0",
   "description": "Vault-first persistent memory for AI coding agents, with an optional profile-aware governance runtime: OFF, FLOW, GUIDE, GOVERN, or ASSURE. Local-first and agent-agnostic (Claude Code, Codex, Cursor…).",
   "type": "module",
   "workspaces": [
@@ -9,6 +9,7 @@
   "exports": {
     "./harness": "./packages/harness/src/index.mjs",
     "./vault": "./packages/vault/src/index.mjs",
+    "./commit": "./packages/commit/src/index.mjs",
     "./hooks/*": "./hooks/*",
     "./src/*": "./src/*",
     "./bin/*": "./bin/*",
@@ -28,8 +29,10 @@
     "bin",
     "src",
     "hooks",
+    ".githooks",
     "packages",
     "schema",
+    "scripts/validate-commit-range.mjs",
     "web/observer",
     "docs/pt-BR/commands/*.md",
     "docs/en/commands/*.md",
@@ -42,7 +45,8 @@
   },
   "scripts": {
     "precheck": "node --check src/capabilities.mjs && node --check src/host-capabilities.mjs && node --check src/task-contracts.mjs && node --check src/task-leases.mjs && node --check src/task.mjs && node --check src/change.mjs && node --check src/archive-operation-lock.mjs && node --check src/worktree.mjs && node --check src/worktree-cleanup.mjs && node --check src/provenance-gate.mjs && node --check src/provenance-sources.mjs && node --check src/receipt-ledger.mjs && node --check src/evidence-envelope.mjs && node --check src/context.mjs && node --check src/active-context-health.mjs && node --check src/active-context-runtime.mjs && node --check hooks/active-context-store.mjs && node --check hooks/change-core.mjs && node --check hooks/brain-inject.mjs && node --check hooks/change-context.mjs && node --check hooks/session-stop.mjs && node --check packages/vault/src/worktree-metadata.mjs && node --check packages/vault/src/evidence-envelope.mjs && node --check packages/vault/src/memory-handoff.mjs && node --check packages/integrations/src/capabilities.mjs && node --check packages/pi/src/index.mjs && node --check src/sync-protocol.mjs && node --check src/sync-outbox.mjs && node --check src/sync-adapters.mjs && node --check src/sync-protocol-cli.mjs && node --check packages/mcp/src/sync.mjs && node --check src/portable.mjs && node --check src/tdd.mjs && node --check src/tdd-attestation.mjs && node --check src/tdd-attestation-store.mjs",
-    "check": "node --check scripts/release.mjs && node --check scripts/release-plan.mjs && node --check scripts/release-provenance.mjs && node --check scripts/run-scope.mjs && node --check src/release-provenance.mjs && node --check bin/wendkeep.mjs && node --check packages/cli/src/index.mjs && node --check src/mcp.mjs && node --check src/init.mjs && node --check src/doctor.mjs && node --check src/active-context-health.mjs && node --check src/project-vault.mjs && node --check src/observer-auth.mjs && node --check src/observer-privacy.mjs && node --check src/observer-snapshot.mjs && node --check src/observer-store.mjs && node --check src/observer-memory.mjs && node --check src/observer-memory-publish.mjs && node --check src/observer-sql-store.mjs && node --check src/observer-sql-migrate.mjs && node --check src/observer-sql-publish.mjs && node --check src/observer-transcript-store.mjs && node --check src/observer-server.mjs && node --check src/observer.mjs && node --check src/observer-publish.mjs && node --check src/operating-profile.mjs && node --check src/profile.mjs && node --check src/flow.mjs && node --check src/work-kind.mjs && node --check src/delivery.mjs && node --check web/observer/app.mjs && node --check hooks/observer-publish.mjs && node --check hooks/evidence-context.mjs && node --check hooks/active-context-handoff-evidence.mjs && node --check hooks/evidence-recall.mjs && node --check hooks/memory-scope.mjs && node --check hooks/operating-profile-runtime.mjs && node --check hooks/operating-profile-task-store.mjs && node --check hooks/flow-core.mjs && node --check hooks/flow-protected-policy.mjs && node --check hooks/git-snapshot.mjs && node --check hooks/vault-path-safety.mjs && node --check hooks/vault-runtime-store.mjs && node --check packages/harness/src/index.mjs && node --check packages/harness/src/flow-store.mjs && node --check packages/harness/src/operating-profile.mjs && node --check packages/harness/src/sensors-core.mjs && node --check packages/integrations/src/host-hooks.mjs && node --check packages/integrations/src/hook-envelope.mjs && node --check packages/integrations/src/prompt-content.mjs && node --check packages/integrations/src/transcript-usage.mjs && node --check packages/integrations/src/transcripts.mjs && node --check packages/integrations/src/session-identity.mjs && node --check packages/integrations/src/index.mjs && node --check packages/mcp/src/audit.mjs && node --check packages/mcp/src/cli.mjs && node --check packages/mcp/src/config.mjs && node --check packages/mcp/src/effects.mjs && node --check packages/mcp/src/executor.mjs && node --check packages/mcp/src/server.mjs && node --check packages/mcp/src/stdio.mjs && node --check packages/mcp/src/index.mjs && node --check packages/vault/src/index.mjs && node --check packages/vault/src/project-vault.mjs && node --check packages/vault/src/vault-path-safety.mjs && node --check packages/vault/src/locale.mjs && node --check packages/vault/src/memory-schema.mjs && node --check packages/vault/src/memory-mode.mjs && node --check packages/vault/src/memory-scope.mjs && node --check packages/vault/src/memory-candidate-policy.mjs && node --check packages/vault/src/evidence-recall.mjs && node --check packages/vault/src/memory-handoff.mjs && node --check packages/vault/src/memory-store.mjs && node --check packages/vault/src/validate-core.mjs && node --check packages/vault/src/validate-memory.mjs",
+    "check": "node --check scripts/validate-commit-range.mjs && node --check packages/commit/src/index.mjs && node --check packages/commit/src/cli.mjs && node --check packages/commit/src/git-runtime.mjs && node --check src/git-commit-hooks.mjs && node --check scripts/release.mjs && node --check scripts/release-plan.mjs && node --check scripts/release-provenance.mjs && node --check scripts/run-scope.mjs && node --check src/release-provenance.mjs && node --check bin/wendkeep.mjs && node --check packages/cli/src/index.mjs && node --check src/mcp.mjs && node --check src/init.mjs && node --check src/doctor.mjs && node --check src/active-context-health.mjs && node --check src/project-vault.mjs && node --check src/observer-auth.mjs && node --check src/observer-privacy.mjs && node --check src/observer-snapshot.mjs && node --check src/observer-store.mjs && node --check src/observer-memory.mjs && node --check src/observer-memory-publish.mjs && node --check src/observer-sql-store.mjs && node --check src/observer-sql-migrate.mjs && node --check src/observer-sql-publish.mjs && node --check src/observer-transcript-store.mjs && node --check src/observer-server.mjs && node --check src/observer.mjs && node --check src/observer-publish.mjs && node --check src/operating-profile.mjs && node --check src/profile.mjs && node --check src/flow.mjs && node --check src/work-kind.mjs && node --check src/delivery.mjs && node --check web/observer/app.mjs && node --check hooks/observer-publish.mjs && node --check hooks/evidence-context.mjs && node --check hooks/active-context-handoff-evidence.mjs && node --check hooks/evidence-recall.mjs && node --check hooks/memory-scope.mjs && node --check hooks/operating-profile-runtime.mjs && node --check hooks/operating-profile-task-store.mjs && node --check hooks/flow-core.mjs && node --check hooks/flow-protected-policy.mjs && node --check hooks/git-snapshot.mjs && node --check hooks/vault-path-safety.mjs && node --check hooks/vault-runtime-store.mjs && node --check packages/harness/src/index.mjs && node --check packages/harness/src/flow-store.mjs && node --check packages/harness/src/operating-profile.mjs && node --check packages/harness/src/sensors-core.mjs && node --check packages/integrations/src/host-hooks.mjs && node --check packages/integrations/src/hook-envelope.mjs && node --check packages/integrations/src/prompt-content.mjs && node --check packages/integrations/src/transcript-usage.mjs && node --check packages/integrations/src/transcripts.mjs && node --check packages/integrations/src/session-identity.mjs && node --check packages/integrations/src/index.mjs && node --check packages/mcp/src/audit.mjs && node --check packages/mcp/src/cli.mjs && node --check packages/mcp/src/config.mjs && node --check packages/mcp/src/effects.mjs && node --check packages/mcp/src/executor.mjs && node --check packages/mcp/src/server.mjs && node --check packages/mcp/src/stdio.mjs && node --check packages/mcp/src/index.mjs && node --check packages/vault/src/index.mjs && node --check packages/vault/src/project-vault.mjs && node --check packages/vault/src/vault-path-safety.mjs && node --check packages/vault/src/locale.mjs && node --check packages/vault/src/memory-schema.mjs && node --check packages/vault/src/memory-mode.mjs && node --check packages/vault/src/memory-scope.mjs && node --check packages/vault/src/memory-candidate-policy.mjs && node --check packages/vault/src/evidence-recall.mjs && node --check packages/vault/src/memory-handoff.mjs && node --check packages/vault/src/memory-store.mjs && node --check packages/vault/src/validate-core.mjs && node --check packages/vault/src/validate-memory.mjs",
+    "postcheck": "node --check packages/observer/src/index.mjs && node --check packages/observer/src/policy.mjs && node --check packages/observer/src/redaction.mjs && node --check packages/observer/src/authz.mjs && node --check packages/observer/src/token-registry.mjs && node --check packages/observer/src/encryption.mjs && node --check packages/observer/src/retention.mjs && node --check packages/observer/src/purge.mjs && node --check packages/observer/src/audit.mjs",
     "test": "node --test --test-concurrency=2",
     "test:core": "node scripts/run-scope.mjs core",
     "release": "node scripts/release.mjs",

package/packages/cli/src/index.mjs

@@ -34,6 +34,7 @@ Usage:
     --no-companions        Skip companion plugins/MCP entirely.
     --no-colors            Skip the Obsidian color system (.obsidian snippet + graph groups).
     --vscode-worktree-tasks Create local, Git-excluded VS Code tasks for managed worktrees.
+    --git-commit-hooks      Opt in to .githooks + local core.hooksPath for evidence commits.
     --dotcontext-mcp <v>   dotcontext MCP placement: auto (default; skip project entry
                            if already global), project, or none.
     --dotcontext-hooks <v> dotcontext hooks: full (default), light (no PostToolUse), none.
@@ -53,6 +54,7 @@ Usage:
                            Uses explicit CAS/conflicts and an offline outbox; --remote path or --url HTTPS.
 
   wendkeep doctor [--vault P]  Health check. --scope core|runtime · --strict for CI/release.
+  wendkeep commit <sub>        Evidence-based Git commits: context | render | prepare | validate.
   wendkeep portable <sub>      Shared authored state: status | export | import | diff.
                            Default file: .wendkeep/portable/state.json; private runtime stays local.
   wendkeep mcp <serve|config>  Native semantic MCP over stdio, or client config generation.
@@ -232,6 +234,9 @@ async function main(argv) {
     } else if (cmd === 'capabilities') {
       const { CAPABILITIES_HELP } = await import('../../../src/capabilities.mjs');
       process.stdout.write(CAPABILITIES_HELP);
+    } else if (cmd === 'commit') {
+      const { COMMIT_HELP } = await import('../../commit/src/cli.mjs');
+      process.stdout.write(COMMIT_HELP);
     } else {
       process.stdout.write(HELP);
     }
@@ -245,7 +250,7 @@ async function main(argv) {
     // `sync` starts with `init` and resolves the freshly bound Vault itself. Pre-resolving
     // here would prevent that repair step from reporting a corrupt binding as its own
     // first-stage failure (and could never make it as far as the guarded init).
-    && !['init', 'sync', 'worktree', 'hook', 'observer', 'mcp', 'capabilities', '--version', '-v', '--help', '-h', 'help'].includes(cmd)) {
+    && !['init', 'sync', 'worktree', 'hook', 'observer', 'mcp', 'capabilities', 'commit', '--version', '-v', '--help', '-h', 'help'].includes(cmd)) {
     await preferProjectVault(rest);
   }
   switch (cmd) {
@@ -262,6 +267,11 @@ async function main(argv) {
       process.exit(runDoctor(rest));
       break;
     }
+    case 'commit': {
+      const { runCommit } = await import('../../commit/src/cli.mjs');
+      process.exit(runCommit(rest));
+      break;
+    }
     case 'portable': {
       const { runPortable } = await import('../../../src/portable.mjs');
       process.exit(runPortable(rest));

package/packages/commit/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "@wendkeep/commit",
+  "private": true,
+  "type": "module",
+  "exports": "./src/index.mjs"
+}

package/packages/commit/src/cli.mjs

@@ -0,0 +1,89 @@
+import { readFileSync } from 'node:fs';
+
+import { renderCommitMessage } from './commit-message.mjs';
+import {
+  buildCommitInput,
+  clearCommitContext,
+  prepareCommitMessageFile,
+  validateCommitMessageFile,
+  writeCommitContext,
+} from './git-runtime.mjs';
+
+export const COMMIT_HELP = `wendkeep commit — evidence-based Git commit policy
+
+Usage:
+  wendkeep commit context --input <json|-> [--json]
+  wendkeep commit context --clear [--json]
+  wendkeep commit render --input <json|->
+  wendkeep commit prepare --message-file <path> [--source <source>]
+  wendkeep commit validate --message-file <path> [--consume-context] [--json]
+
+The context is stored under the repository Git directory, never in the Vault or working tree.
+`;
+
+function option(argv, name) {
+  const index = argv.indexOf(name);
+  if (index >= 0) return argv[index + 1] || '';
+  return argv.find((item) => item.startsWith(`${name}=`))?.slice(name.length + 1) || '';
+}
+
+function readInput(path) {
+  if (!path) throw Object.assign(new Error('--input is required'), { code: 'WENDKEEP_COMMIT_ARGUMENT' });
+  const source = path === '-' ? readFileSync(0, 'utf8') : readFileSync(path, 'utf8');
+  return JSON.parse(source);
+}
+
+function outputJson(value) {
+  process.stdout.write(`${JSON.stringify(value)}\n`);
+}
+
+export function runCommit(argv, { cwd = process.cwd() } = {}) {
+  const [subcommand, ...rest] = argv;
+  const json = rest.includes('--json');
+  try {
+    if (!subcommand || subcommand === 'help' || rest.includes('--help') || rest.includes('-h')) {
+      process.stdout.write(COMMIT_HELP);
+      return 0;
+    }
+    if (subcommand === 'context') {
+      const result = rest.includes('--clear')
+        ? clearCommitContext({ cwd })
+        : writeCommitContext(readInput(option(rest, '--input')), { cwd });
+      if (json) outputJson(rest.includes('--clear') ? result : { path: result.path, schema_version: 1 });
+      else process.stdout.write(`${rest.includes('--clear') ? 'cleared' : 'written'}: ${result.path}\n`);
+      return 0;
+    }
+    if (subcommand === 'render') {
+      const input = buildCommitInput(readInput(option(rest, '--input')), { cwd });
+      process.stdout.write(renderCommitMessage(input));
+      return 0;
+    }
+    if (subcommand === 'prepare') {
+      const result = prepareCommitMessageFile({
+        messageFile: option(rest, '--message-file'),
+        source: option(rest, '--source'),
+        cwd,
+      });
+      if (json) outputJson(result);
+      return 0;
+    }
+    if (subcommand === 'validate') {
+      const result = validateCommitMessageFile({
+        messageFile: option(rest, '--message-file'),
+        consumeContext: rest.includes('--consume-context'),
+        cwd,
+      });
+      if (json) outputJson(result);
+      if (!result.ok) {
+        process.stderr.write(`WENDKEEP_COMMIT_MESSAGE_INVALID\n${result.errors.map((error) => `- ${error}`).join('\n')}\n`);
+        return 1;
+      }
+      return 0;
+    }
+    process.stderr.write(`wendkeep commit: unknown subcommand "${subcommand}"\n`);
+    return 2;
+  } catch (error) {
+    process.stderr.write(`${error.code || 'WENDKEEP_COMMIT_ERROR'}: ${error.message}\n`);
+    return 2;
+  }
+}