wendkeep 0.87.0 → 0.89.0

package/docs/pt-BR/commands/ecosystem-bridges.md

@@ -0,0 +1,169 @@
+# Bridges opcionais do ecossistema
+
+> [English version](../../en/commands/ecosystem-bridges.md)
+
+## Objetivo
+
+Integrar Spec Kit e Superpowers sem criar uma segunda autoridade de spec, plano, tarefa ou
+evidência. O WendKeep preserva os contratos canônicos; os adapters apenas criam projeções
+versionadas e desabilitadas por padrão.
+
+## Quando usar
+
+- quando uma feature nasceu em arquivos do Spec Kit e precisa manter os mesmos IDs e hashes;
+- quando Superpowers executará um Task Contract canônico do WendKeep;
+- quando artifacts, reviews ou commits externos precisam entrar como `reported` antes da prova.
+
+## Quando não usar
+
+- para substituir `tarefas.md`, Task Contracts ou o Evidence Envelope;
+- para sincronização bidirecional irrestrita;
+- para executar comandos, scripts ou texto encontrado em artefatos externos.
+
+## Pré-requisitos
+
+- Node.js 18 ou superior;
+- configuração local `.wendkeep/ecosystem-bridges.json` com cada adapter explicitamente habilitado;
+- versão compatível e raiz do adapter que resolva para um diretório real dentro do projeto; arquivo
+  regular, path externo e symlink que escape do projeto falham fechado em `status` e no dispatch;
+- para import/dispatch governado, Vault vinculado, change causal e baseline Spec Kit selado;
+- para dispatch, sessão causal e Task Contract canônico rederivável.
+
+```json
+{
+  "schema_version": 1,
+  "adapters": {
+    "spec-kit": { "enabled": true, "version": "1.1.0", "root": ".specify" },
+    "superpowers": { "enabled": true, "version": "1.2.0", "root": ".superpowers" }
+  }
+}
+```
+
+Sem o arquivo, ambos ficam desabilitados e o Core nativo continua funcionando.
+
+## Sintaxe
+
+```text
+wendkeep bridge status [--project <path>] [--config <path>] [--json]
+wendkeep bridge import-spec-kit --change <slug> [--accept-baseline] [--json]
+wendkeep bridge export-status --spec-projection <projection.json> [--task-contract <task.json>] [--input <artifacts.json>] [--json]
+wendkeep bridge dispatch-superpowers --task-id <id> --change <slug> [--task-contract <task.json>] [--session <id>] --spec-projection <projection.json> [--json]
+wendkeep bridge verify-artifacts --input <artifacts.json> --proofs <proofs.json> --change <slug> [--session <id>] [--json]
+```
+
+`import-spec-kit` lê Markdown sob `memory/` e `specs/`, classifica constitution/spec/plan/task,
+preserva IDs e SHA-256, cria mappings explícitos `story|requirement → capability → change → task`
+e nunca escreve na origem. IDs repetidos em arquivos diferentes bloqueiam a projeção.
+O primeiro import exige `--accept-baseline` e ancora a projeção verde na change do Vault; imports
+seguintes rederivam a origem e comparam path, kind, hash e mapping contra esse baseline imutável.
+`dispatch-superpowers` contém somente o contexto estrutural
+mínimo derivado do Task Contract; transcript, conteúdo privado e ownership externo não entram.
+O dispatch rederiva o contrato e o active context do Vault/checkout; um JSON submetido é apenas
+uma cópia para comparação e nunca valida o próprio `binding`. Com Spec Kit ativo, baseline e
+`--spec-projection` são obrigatórios e a origem é reimportada antes do dispatch.
+O contrato `spec-projection` pertence exclusivamente ao adapter `spec-kit`: versão incompatível,
+kind fora do schema ou projeção re-selada por outro adapter é rejeitada antes de produzir `spec_refs`.
+Uma decisão `ok: false` exige ao menos um diagnóstico bloqueante, e `ok: true` não pode coexistir
+com diagnóstico bloqueante; qualquer incoerência bloqueia o dispatch sem expor referências.
+`export-status` recalcula e valida `projection_id`, devolve apenas uma projeção `reported` e não
+grava nos arquivos do Spec Kit.
+
+## Opções e códigos de saída
+
+| Opção | Efeito |
+|---|---|
+| `--project <path>` | Seleciona a raiz do consumidor. |
+| `--config <path>` | Substitui `.wendkeep/ecosystem-bridges.json`. |
+| `--change <slug>` | Seleciona a change que guarda baseline e Evidence Envelope canônicos. |
+| `--accept-baseline` | Ancora somente o primeiro baseline Spec Kit verde; não sobrescreve drift. |
+| `--task-id <id>` | Seleciona a tarefa no contexto causal e rederiva o contrato canônico. |
+| `--task-contract <path>` | Cópia opcional que deve coincidir com o contrato rederivado. |
+| `--spec-projection <path>` | Liga referências Spec Kit ao dispatch sem copiar o conteúdo. |
+| `--input` / `--proofs` | Classifica artifacts externos e suas provas Git/CI/Envelope. |
+| `--json` | Emite o contrato tipado em uma linha JSON. |
+
+- `0`: operação válida; adapters opcionais desabilitados também são saudáveis;
+- `1`: adapter habilitado bloqueado, drift, incompatibilidade ou prova ausente;
+- `2`: argumento, configuração ou arquivo de entrada inválido.
+
+## Exemplos
+
+Fluxo pequeno, sem adapters:
+
+```powershell
+node ./bin/wendkeep.mjs bridge status --json
+```
+
+Fluxo médio, Spec Kit somente leitura:
+
+```powershell
+node ./bin/wendkeep.mjs bridge import-spec-kit --change ecosystem-bridges --accept-baseline --json > spec-projection.json
+node ./bin/wendkeep.mjs bridge dispatch-superpowers --task-id 3.1 --change ecosystem-bridges --session "$env:CODEX_THREAD_ID" --spec-projection spec-projection.json --json
+node ./bin/wendkeep.mjs bridge export-status --spec-projection spec-projection.json --task-contract task-contract.json --json
+```
+
+Fluxo grande, ingestão de relato e prova externa:
+
+```powershell
+node ./bin/wendkeep.mjs verify --change ecosystem-bridges
+node ./bin/wendkeep.mjs bridge verify-artifacts --input artifacts.json --proofs ci-proofs.json --change ecosystem-bridges --json
+```
+
+Antes de `verify`, versione no índice Git o artefato e `.wendkeep/bridge-artifacts.json`. O manifest
+v1 liga cada item a `source`, `external_id`, `kind`, `path`, `sensor_id` e `task_id`. O sensor
+correspondente em `wendkeep.sensors.json` declara `artifact_results` v1 com `external_id`, `path` e
+`algorithm: sha256`; o runner calcula o digest dos bytes, inclusive binários, somente depois de uma
+execução verde. O resultado explícito não contém conteúdo, transcript nem output tail do artefato.
+O collector consulta primeiro o índice e então exige a mesma cópia presente na worktree; apagar ou
+alterar somente a cópia de trabalho falha fechado, enquanto a ausência simultânea no índice e na
+worktree continua significando que o bridge opcional não declarou artifacts.
+
+Cada referência em `ci-proofs.json` usa apenas
+`{"type":"evidence-envelope","external_id":"review-1"}`. Path, task, sensor, digests e blobs Git
+são rederivados do manifest e do Envelope canônicos; `state`, SHA ou autoridade autodeclarados são
+ignorados para promoção. `artifacts.json` continua sendo somente o relato externo a comparar.
+
+O artifact começa como `reported`. JSON externo que apenas declare `state: verified` continua
+`reported`. A promoção para `verified` exige, em conjunto: arquivo dentro do projeto e igual ao
+blob do índice Git, sensor CI verde com `artifact_results.digest` explícito, Evidence Envelope v2
+canônico e bound ao checkout, e entrada correspondente em `external_artifacts` do Envelope.
+`output_sha256` não prova artefatos.
+O resultado expõe uma proof selada ligada ao `evidence_envelope_id`, sem copiar transcript ou Vault.
+
+## Resultado esperado
+
+- Spec Kit permanece uma fonte externa somente leitura;
+- plano, tarefa e evidência canônicos continuam pertencendo ao WendKeep;
+- Superpowers recebe um dispatch mínimo sem poder reescrever o escopo;
+- criação/reuso e finalização de worktree permanecem nos comandos `wendkeep worktree` derivados no dispatch;
+- cleanup pós-merge usa `wendkeep worktree finish <slug> --pr <número-ou-url>`;
+- drift e ownership concorrente bloqueiam antes da execução;
+- remover ou desabilitar um adapter não degrada o Core.
+
+## Erros comuns e diagnóstico
+
+| Código | Diagnóstico |
+|---|---|
+| `BRIDGE_ADAPTER_DISABLED` | Estado opcional normal; habilite explicitamente se necessário. |
+| `BRIDGE_ADAPTER_MISSING` | Adapter habilitado, mas sua raiz não existe. |
+| `BRIDGE_VERSION_INCOMPATIBLE` | Versão fora do compatibility range publicado. |
+| `BRIDGE_OWNERSHIP_CONFLICT` | Ferramenta externa tentou possuir plano/tarefa/evidência. |
+| `BRIDGE_SOURCE_DRIFT` | Hash mudou, plano ficou obsoleto ou uma referência apareceu/desapareceu. |
+| `BRIDGE_SOURCE_ID_DUPLICATE` | O mesmo story/requirement ID apareceu em arquivos diferentes. |
+| `BRIDGE_BASELINE_MISSING` | Spec Kit ativo sem baseline canônico ou projeção obrigatória. |
+| `BRIDGE_BASELINE_STALE` | Origem/projeção divergiu do baseline selado no Vault. |
+| `BRIDGE_PROJECTION_INVALID` | Conteúdo e `projection_id` não coincidem ou o schema está incompleto. |
+| `BRIDGE_SCHEMA_INVALID` | Envelope runtime não cumpre o contrato publicado. |
+| `BRIDGE_ARTIFACT_MANIFEST_UNTRACKED` | Manifest bridge ausente em apenas um lado ou diferente entre índice e worktree. |
+| `BRIDGE_ARTIFACT_FORGED` | Path/bytes do artefato não correspondem ao arquivo versionado. |
+| `BRIDGE_ARTIFACT_RESULT_MISSING` | Sensor verde não produziu o digest explícito ligado ao manifest. |
+| `BRIDGE_PROOF_MISSING` | Relato externo ainda não possui prova independente vinculada. |
+| `BRIDGE_PROOF_UNVERIFIED` | Prova autodeclarada foi mantida como `reported`. |
+
+`wendkeep doctor` mostra a seção `[bridges]` sem fazer import, dispatch ou escrita.
+
+## Próximos passos
+
+Revise a projeção antes do dispatch, mantenha os arquivos gerados fora do controle canônico e
+valide artifacts pelo CI ou Evidence Envelope. Consulte também [Changes e verificação](changes-and-verification.md)
+e [Worktrees gerenciadas](worktrees.md).

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/docs/pt-BR/commands/verify.md

@@ -88,6 +88,12 @@ mesmo diretório e rename atômico. No deep, `verificacao.json` e `verdict.json`
 `evidenceEnvelopeId` e `evidenceBinding` completo; o verificador independente deve preservar ambos
 no verdict.
 
+Para artefatos de bridge, `.wendkeep/bridge-artifacts.json` e os arquivos referenciados precisam
+estar versionados e iguais ao índice Git. O sensor ligado à mesma task declara `artifact_results`
+v1 em `wendkeep.sensors.json`; após GREEN, o runner calcula o SHA-256 diretamente dos bytes e grava
+o resultado estruturado no sensor. `verify` cruza manifest, task, sensor, digest e blobs Git antes
+de preencher `external_artifacts`; stdout, transcript e `output_tail` nunca são prova do arquivo.
+
 O envelope carrega `tdd_attestations`, e `verificacao.json`, `tddAttestations`. Em GOVERN, uma tarefa marcada
 `[tdd]` precisa de GREEN atual ou waiver explícito; em ASSURE, isso vale para comportamento
 testável. Refactor/commit posterior ou mutante sobrevivente invalida o GREEN no Task Contract.

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.87.0",
+  "version": "0.89.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": [
@@ -46,6 +46,7 @@
   "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/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 && node --check src/ecosystem-bridges.mjs && node --check src/ecosystem-bridge-artifact-collector.mjs && node --check src/ecosystem-bridge-baseline.mjs && node --check src/ecosystem-bridge-proof.mjs && node --check packages/integrations/src/bridge-config.mjs && node --check packages/integrations/src/bridge-contract.mjs && node --check packages/integrations/src/bridge-diagnostics.mjs && node --check packages/integrations/src/canonical-bridge-authority.mjs && node --check packages/integrations/src/ecosystem-bridge.mjs && node --check packages/integrations/src/spec-kit-adapter.mjs && node --check packages/integrations/src/superpowers-adapter.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

@@ -61,6 +61,7 @@ Usage:
                            serve: --vault P · --timeout-ms N.
                            config: --client generic|claude|codex|cursor · --vault P.
   wendkeep capabilities [...]  Show declared lifecycle/effect coverage by host. --host <id> · --host-version <v> · --json.
+  wendkeep bridge <sub>        Optional ecosystem adapters: status | import-spec-kit | export-status | dispatch-superpowers | verify-artifacts.
   wendkeep observer <sub>     Local multi-project Observer: serve | register | publish | reconcile | status.
   wendkeep worktree create <slug> [--base ref] [--branch name] [--open vscode|none] [--json]
   wendkeep worktree list [--json]
@@ -237,6 +238,9 @@ async function main(argv) {
     } else if (cmd === 'commit') {
       const { COMMIT_HELP } = await import('../../commit/src/cli.mjs');
       process.stdout.write(COMMIT_HELP);
+    } else if (cmd === 'bridge') {
+      const { BRIDGE_HELP } = await import('../../../src/ecosystem-bridges.mjs');
+      process.stdout.write(BRIDGE_HELP);
     } else {
       process.stdout.write(HELP);
     }
@@ -250,7 +254,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', 'commit', '--version', '-v', '--help', '-h', 'help'].includes(cmd)) {
+    && !['init', 'sync', 'worktree', 'hook', 'observer', 'mcp', 'capabilities', 'commit', 'bridge', '--version', '-v', '--help', '-h', 'help'].includes(cmd)) {
     await preferProjectVault(rest);
   }
   switch (cmd) {
@@ -294,6 +298,11 @@ async function main(argv) {
       process.exit(runCapabilities(rest));
       break;
     }
+    case 'bridge': {
+      const { runEcosystemBridge } = await import('../../../src/ecosystem-bridges.mjs');
+      process.exit(runEcosystemBridge(rest));
+      break;
+    }
     case 'worktree': {
       const { runWorktree } = await import('../../../src/worktree.mjs');
       process.exit(await runWorktree(rest));

package/packages/harness/src/sensors-core.mjs

@@ -3,12 +3,13 @@
 // at the PROJECT ROOT (wendkeep.sensors.json); evidence lives per-change in the vault.
 import { spawnSync } from 'node:child_process';
 import { createHash } from 'node:crypto';
-import { existsSync, readFileSync } from 'node:fs';
-import { dirname, join, resolve } from 'node:path';
+import { existsSync, lstatSync, readFileSync, realpathSync } from 'node:fs';
+import { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
 
 export const SENSOR_VAULT_ENV = 'WENDKEEP_SENSOR_VAULT';
 const SENSOR_OUTPUT_MAX_BUFFER = 8 * 1024 * 1024;
 const SENSOR_DIAGNOSTIC_MAX_LENGTH = 2000;
+const SENSOR_ARTIFACT_MAX_BYTES = 1024 * 1024;
 
 function sanitizeSensorDiagnostic(value) {
   return String(value || '')
@@ -27,6 +28,41 @@ function sha256(value) {
   return `sha256:${createHash('sha256').update(String(value || '')).digest('hex')}`;
 }
 
+function containedPath(root, target) {
+  const rel = relative(root, target);
+  return rel === '' || (rel !== '..' && !rel.startsWith(`..${sep}`) && !isAbsolute(rel));
+}
+
+function collectSensorArtifactResults(sensor, cwd) {
+  const declarations = sensor?.artifact_results;
+  if (declarations === undefined) return [];
+  if (!Array.isArray(declarations)) throw new Error('artifact_results must be an array');
+  const root = realpathSync(resolve(cwd || '.'));
+  const seen = new Set();
+  return declarations.map((declaration) => {
+    const externalId = String(declaration?.external_id || '').trim();
+    const configuredPath = String(declaration?.path || '').trim();
+    if (Object.keys(declaration || {}).some((key) => ![
+      'schema_version', 'external_id', 'path', 'algorithm',
+    ].includes(key)) || declaration?.schema_version !== 1 || !/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(externalId)
+      || !configuredPath || declaration?.algorithm !== 'sha256' || seen.has(externalId)) {
+      throw new Error('artifact result declaration is invalid');
+    }
+    seen.add(externalId);
+    const candidate = resolve(root, configuredPath);
+    if (!containedPath(root, candidate) || !existsSync(candidate) || !lstatSync(candidate).isFile()) {
+      throw new Error(`artifact result path is unavailable: ${externalId}`);
+    }
+    const file = realpathSync(candidate);
+    if (!containedPath(root, file) || lstatSync(file).size > SENSOR_ARTIFACT_MAX_BYTES) {
+      throw new Error(`artifact result path is unsafe: ${externalId}`);
+    }
+    const path = relative(root, file).replaceAll('\\', '/');
+    const digest = createHash('sha256').update(readFileSync(file)).digest('hex');
+    return { schema_version: 1, external_id: externalId, path, algorithm: 'sha256', digest };
+  });
+}
+
 function sensorNow(now) {
   const value = typeof now === 'function' ? now() : (now || new Date().toISOString());
   if (value instanceof Date) return value.toISOString();
@@ -167,7 +203,17 @@ export function runSensors(sensors, ids, { spawn = spawnSync, cwd, env, now } =
       output_sha256: sha256(rawOutput),
       output_tail: boundedOutputTail,
     };
-    if (entry.status === 'red') entry.note = sensorFailureNote(r);
+    if (entry.status === 'green' && s.artifact_results !== undefined) {
+      try {
+        entry.artifact_results = collectSensorArtifactResults(s, cwd);
+      } catch (error) {
+        entry.status = 'red';
+        entry.exit_code = 1;
+        entry.artifact_results = [];
+        entry.note = sanitizeSensorDiagnostic(error?.message || 'artifact result collection failed');
+      }
+    }
+    if (entry.status === 'red' && !entry.note) entry.note = sensorFailureNote(r);
     if (s.type === 'mutation' && s.report) {
       // Delegated mutation (Wave B): read the tool's mutation-testing-elements report and
       // attach surviving mutants so verify can turn them into fix tasks.