# Changelog All notable changes to **wendkeep** are documented here. Format based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); this project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ## [0.85.1] — 2026-08-25 ### Fixed - **Proveniência da árvore publicada após o sync do próprio projeto.** O checkout de desenvolvimento permanece sem depender do pacote `wendkeep` publicado, enquanto o bump patch alinha `package.json`, lockfile, tag e automação de Release à árvore integrada pelo PR #109. ### Changed - **Harness do repositório sincronizado com 0.85.0.** `AGENTS.md` e as skills gerenciadas passam a refletir o contrato atual, incluindo o binding completo do Evidence Envelope no verdict; o MCP do projeto usa o servidor nativo e o perfil persistente continua explicitamente `OFF`. ## [0.85.0] — 2026-08-25 ### Added - **Matriz versionada de capacidades dos hosts.** Claude Code, Codex, Pi e MCP/CLI genérico declaram as mesmas 17 capacidades de lifecycle/efeitos como `native`, `adapted`, `polled`, `manual` ou `unavailable`; `wendkeep capabilities` inspeciona a cobertura sem exigir Vault e versões/hosts desconhecidos entram em modo degradado explícito. - **Pi adapter e efeitos MCP verificáveis.** O workspace Pi deixa de ser placeholder e normaliza envelopes lifecycle sem importar adapters irmãos. Efeitos vêm do catálogo assinado, nunca do nome da tool: reads conhecidos pulam o mutation gate, writes/destructive permanecem gated e desconhecidos falham fechado. - **Cobertura causal persistida.** Gaps são injetados no início e acompanham session registry, active context, handoff, Evidence Envelope e Observer; estados manuais continuam apenas `reported`, sem promoção indevida a prova verificada. ### Changed - **Gates de verify e ASSURE conscientes do host.** Projetos podem declarar `requires_host_capabilities` no `wendkeep.sensors.json`; capacidades manuais/indisponíveis bloqueiam `verify` e handoff ASSURE salvo waiver humano explícito com aprovador e motivo. - **Contrato e documentação pública bilíngue.** Novos schemas de manifest/cobertura, campos opcionais de handoff/evidência, README e guias PT-BR/EN documentam fallback, versões, waivers, códigos de saída e recovery. ## [0.84.0] — 2026-08-25 ### Added - **Protocolo de sync local-first.** `wendkeep sync status/push/pull/conflicts/resolve` transporta estado autoral portátil por revisões, CAS, pais causais, record keys com escopo de projeto/branch/worktree, tombstones e conflitos explícitos, sem last-write-wins ou cloud obrigatória. - **Operação offline e coordenação recuperável.** Outbox append-only, acknowledgements idempotentes, replay fora de ordem, leases expirantes com histórico, adaptadores de referência filesystem/HTTP e resolução auditável preservam autoria sob partição, retry e clocks divergentes. - **Privacidade, diagnóstico e contrato público.** Envelopes opt-in AES-256-GCM com rotação de chave, schemas v1, status no `doctor` e no Observer sanitizado, chaos tests e guias PT-BR/EN documentam consistência, erros e threat model. O sync desabilitado não cria runtime nem altera Keep Core. ## [0.83.0] — 2026-08-25 ### Added - **Estado autoral portátil e `active-work`.** `wendkeep portable status/export/import/diff` produz um snapshot determinístico e revisável de CORE, ADRs, specs e changes autorais, com uma projeção compacta de retomada por active context sem session/worktree IDs, paths locais, tokens, transcritos, locks, leases ou outboxes. - **Import fail-closed e provenance privado.** Schema, project, allowlist, hashes, limites, traversal, symlinks/hardlinks e revision/hash são validados antes da primeira escrita; estado stale ou conflitante nunca sobrescreve silenciosamente o local. Export/import registram somente metadados e hashes em ledger privado, e o `doctor` diagnostica authored state divergente. - **Contrato público bilíngue.** Schemas `portable-state-v1`/`portable-active-work-v1`, README, guias PT-BR/EN e política LF em `.gitattributes` documentam redaction, opt-out de Git, revisão em PR e retomada segura em clone limpo. ## [0.82.0] — 2026-08-25 ### Added - **MCP semântico nativo.** `wendkeep mcp serve` oferece tools bounded para projeto, contexto, memória, changes, specs, tarefas, handoff, evidência e Observer por JSON-RPC/stdio, com schemas versionados, paginação, budgets, timeout, cancelamento, redaction e compatibilidade Core com Node 18; Observer SQL permanece capability separada em Node 22.13+. - **Effects, capabilities e writes causais.** Um catálogo versionado com integridade SHA-256 distingue read/write/destructive; reads conhecidas deixam de ser bloqueadas apenas pelo prefixo MCP, enquanto desconhecidas e manifestos inválidos falham fechado. Writes exigem capability, ator, sessão, active context, lease e motivo, revalidam o binding causal e reutilizam os gates da CLI; delivery, merge, push, tag, publicação e exclusão ficam fora da superfície padrão. - **Auditoria e configuração multi-cliente.** O ledger local registra somente metadados de chamada, nunca argumentos/payload; `wendkeep mcp config` gera configuração para Claude, Codex, Cursor e clientes genéricos, e o tarball instalado prova o handshake e a consulta semântica. ### Changed - **MCP principal reproduzível.** `init` substitui o servidor de Vault executado com `@latest` por `npx --no-install wendkeep mcp serve --vault `, preservando o merge não destrutivo de `.mcp.json`; README, arquitetura e guias PT-BR/EN documentam tools, gates, limites e recovery. - **Bootstrap stdio desacoplado do checkout.** `mcp serve` inicia sem exigir um Vault no cwd; quando `--vault` não é informado, cada tool resolve e audita somente o binding do `project_root` declarado, preservando isolamento multi-projeto e permitindo handshake empacotado em CI/editores. ## [0.81.0] — 2026-08-24 ### Added - **Atestação TDD causal.** `wendkeep tdd red|green|status|waive` registra o ciclo RED → GREEN ligado a projeto, repositório, worktree, work session, change, tarefa, requisito e paths de teste. RED já verde ou causado por import/sintaxe/configuração fica `invalid`; GREEN exige sucessor causal e diff de produção posterior, enquanto waiver exige motivo e autoridade humana explícita. - **Prova reviewable e portátil.** O store v1 conserva digests e cauda sanitizada limitada, preserva histórico após refactor/revalidação e expõe IDs no Evidence Envelope, pacote deep, handoff e Observer, sem persistir saída completa nem paths absolutos. ### Changed - **Gate TDD por perfil.** Task Contracts exigem atestação atual para tarefas `[tdd]` em GOVERN e para comportamento testável em ASSURE; mutante sobrevivente ou mudança pós-GREEN invalida a prova. OFF/FLOW permanecem opcionais e GUIDE recomendado. Skill `wk-tdd`, schemas, README e guias PT-BR/EN documentam o contrato e a recuperação. ## [0.80.2] — 2026-08-24 ### Fixed - **Perfil persistente em worktrees vinculadas.** `profile use` e `profile status` agora leem e escrevem o binding canônico da worktree principal quando o Vault é resolvido pelo registry Git compartilhado, sem alterar o `.wendkeep.json` versionado da worktree vinculada. A identidade de caminho também normaliza aliases Windows 8.3, impedindo que uma seleção humana `OFF` volte imediatamente ao fallback `GOVERN`; README e guia de perfis foram atualizados em PT-BR/EN. ## [0.80.1] — 2026-08-24 ### Fixed - **Bootstrap causal das sessões Codex.** `session-start` e `session-ensure` agora derivam um `work_session_id` estável do `session_id` canônico quando o host não envia essa identidade, preservando primeiro handoff explícito e valor já registrado. Novas sessões deixam de falhar em `profile route`, `change new` e active context por identidade ausente, sem relaxar as validações de projeto, repositório, worktree ou branch; README e o guia de contexto foram atualizados em PT-BR/EN. ## [0.80.0] — 2026-08-24 ### Added - **Task Contract v1.** `wendkeep task list/show/evaluate/claim/release` deriva contratos tipados da change e do active context, com IDs estáveis, hashes de HEAD/tarefas/spec/manifesto, diagnósticos estruturados e leases exclusivos recuperáveis sob o lock do `SESSION_REGISTRY`. - **Artifact gates bounded.** Manifestos v1 suportam `name`, `path`, `glob` e `file-count`, com fallback de filesystem explícito, ignores seguros, limites de tempo/quantidade e bloqueio de path escape, symlink ou junction externo. - **Handoff Contract v1.** SessionStop publica handoff causal com task, artifacts, Evidence Envelope, decisões, próximas ações, blockers e hashes; ASSURE exige contrato verificado e handoffs históricos permanecem `legacy-reported`. - **Schemas e guias bilíngues.** Schemas públicos de task/handoff/artifacts, README e guias PT-BR/EN documentam comandos, erros, recovery, autoridade e compatibilidade. ### Changed - **Execute → Verify machine-checkable.** `verify` preserva o Evidence Envelope recém-capturado, grava `task-evaluation.json` e bloqueia sucesso/pacote deep quando checkbox, requisito, sensor, artifact, dependência ou binding causal ainda estiver aberto; `[phase:verify]` separa a tarefa final de revisão/arquivo sem enfraquecer o gate de archive. - **Memória e Observer sem autoridade duplicada.** `handoff.latest` passa a transportar o contrato estruturado verificado pela mesma outbox sanitizada; resumos heurísticos continuam apenas como projeção reportada. ## [0.79.0] — 2026-08-23 ### Added - **Gate único de proveniência.** Archive, delivery, release e cleanup rederivam a autoridade no subject atual com a taxonomia `verified`, `reported`, `legacy-unbound`, `stale`, `conflict` e `unproven`; somente `verified` satisfaz prova obrigatória, com códigos e recovery sanitizados. - **Fontes verificáveis.** Adapters injetáveis ligam Git, CI, tag, NPM e GitHub Release ao repositório, target commit, package/version, integrity e notas esperados sem confiar em URL/claim fornecida nem na worktree incidental. - **Receipt Ledger v2.** Autorizações de archive e receipts de delivery/cleanup ganham sequência, `previous_hash`, `receipt_hash`, lock, publicação atômica e checkpoint separado, com schema público e replay idempotente. ### Changed - **Archive fail-closed.** Evidence Envelope v2, pacote deep e verdict completos/canônicos agora são exigidos mesmo sem sensores; uma autorização v2 é encadeada antes da mutação e `--force` continua limitado a tarefa aberta, sem pular proveniência. - **Delivery e release ligadas ao destino.** Merge/push observam `/`, exigem ancestralidade e preservam origin/worktree/branch do start; tag/publish derivam package e artefato do target e verificam CI → commit → tag → versão/integrity → GitHub Release. Offline permanece `reported` e não grava completion receipt. - **Cleanup retomável e causal.** Finish/remove/prune validam o ledger antes da mutação, vinculam todos os contextos, PR/head/merge e ator disponível, e retomam o mesmo operation ID após crash antes/depois do append ou finalize; texto e `--json` preservam códigos e recovery sanitizados. - **Compatibilidade explícita.** Ledgers v1 permanecem read-only como prefixo `legacy-unbound`; no Windows com Node 18–22, receipts e operation locks tratam `st_dev=0` como metadado indisponível quando o inode continua idêntico, sem aceitar identificadores de dispositivo não-zero conflitantes; aquisições e liberações concorrentes relêem rotações e sharing violations transitórias com limite estrito, e o release fecha e revalida o marker antes do unlink nas runtimes antigas; README, contrato do harness e guias de changes/verify/profiles/worktrees foram atualizados em PT-BR/EN. ### Security - Adulteração intermediária, JSON parcial, cauda/checkpoint removidos, colisão de ID, locks trocados por outro owner, writer concorrente e escape por symlink/junction passam a bloquear antes da mutação; diagnósticos não persistem tokens nem paths privados. ## [0.78.0] — 2026-08-22 ### Added - **Evidence Envelope v2.** `verify` liga cada prova a projeto, repositório, worktree, work session, branch, base/HEAD, árvore do índice e digest determinístico de staged/unstaged/untracked por SHA-256 canônico; texto normaliza CRLF/CR para LF e binários preservam bytes. - **Proveniência por sensor.** Cada resultado registra comando efetivo sanitizado e hash, timestamps, duração, exit code, digest da saída e tail sanitizado limitado; alteração da configuração invalida o binding anterior. - **Diagnóstico causal.** `change status`, doctor, handoff e Observer distinguem evidência `bound`, `stale`, `context-mismatch` e `legacy-unbound`; pacote deep e verdict carregam o mesmo `evidenceEnvelopeId` e `evidenceBinding` completo e não podem ser reutilizados entre worktrees. ### Changed - **Publicação fail-closed.** Mudança de HEAD durante os sensores preserva a evidência anterior e retorna `WENDKEEP_EVIDENCE_HEAD_CHANGED`. Evidência, pacote, verdict trivial e seals são gravados por temporário path-safe no mesmo diretório e rename atômico. - **Compatibilidade explícita.** Evidência v1 continua legível para histórico, mas sensores v1 não satisfazem autoridade v2 no archive. README, schema e guias PT-BR/EN documentam formato, normalização, recovery e vínculo do passe independente. ## [0.77.0] — 2026-08-22 ### Added - **Fechamento comprovado de worktrees.** `worktree finish --pr ` valida no GitHub que o PR foi merged, cruza branch e merge commit com a base local, executa preflight de checkout, sessões, delivery, outbox e handoff, e fecha somente o active context da worktree alvo. - **Cleanup auditável e retomável.** Reservas sob lock, remoção do ref local por CAS e receipts JSONL append-only tornam o fechamento idempotente e retomável depois de crash; `doctor` diagnostica estado interrompido, failed ou receipt inconsistente com recovery objetivo. - **Comandos destrutivos explícitos.** `worktree cleanup --merged` e `worktree prune` são dry-run por padrão e exigem `--apply`; `worktree remove --reason` preserva branch não merged. Exclusão remota continua proibida sem `--delete-remote` e falha fechado quando a branch diverge. - **Paridade operacional.** README e guia de worktrees PT-BR/EN documentam flags, blockers, PowerShell/POSIX e recovery; a task local do VS Code oferece `WendKeep: Finish merged worktree`. ## [0.76.9] — 2026-08-22 ### Fixed - **Injeção de change causal.** `brain-inject` e `change-context` usam o active context da sessão para marcar `ATUAL`, calcular o hash da sentinela e preservar o mesmo foco em todos os degraus do budget; o backlog continua global sem promover a change irmã pelo pointer legado. - **Store vazio fail-closed.** A presença de `active_contexts`, schema ou revision — inclusive `active_contexts: {}` — impede fallback a `CURRENT_CHANGE.md` quando o contexto causal está ausente ou ambíguo; compatibilidade legada permanece somente antes da inicialização contextual. - **Criação contextual preservada.** Operações mutáveis como `delivery start` continuam recebendo a identidade causal antes de existir um context record, enquanto hooks read-only exigem o registro existente e nunca publicam foco de sibling. ## [0.76.8] — 2026-08-22 ### Added - **Doctor de active contexts.** A seção `[active-contexts]` cruza store, sessões e topologia Git read-only para classificar sessão órfã, worktree removida e lease `request-stop` expirada; uma topologia não provada permanece diagnóstico não acionável, nunca falso positivo de remoção. - **Reparo explícito com CAS.** `context repair` exige key, revision, sessão ator e motivo, revalida sob o lock e falha sem writes quando o alvo ficou saudável, stale ou não pode ser provado. - **Preservação histórica.** Orphan/removed muda para `closed` sem apagar o contexto; lease vencida isolada muda para `expired` sem fechar contexto saudável. Receipt append-only e projeções legadas são atualizados sem tocar ledger, evidência, notas ou memória histórica. ## [0.76.7] — 2026-08-22 ### Fixed - **Handoff causal no Stop.** Com `active_contexts` inicializado, work session, repository, worktree, branch e change vêm do contexto chamador; payload divergente falha antes de CAS, nota, outbox ou ledger e não publica estado parcial. - **Evidência da change correta.** O lifecycle coleta verdict, sensores e ADR apenas da change do active context causal, sem reutilizar `change_slug` legado ou link global de uma sessão irmã. - **Recall automático escopado.** `UserPromptSubmit` permanece somente leitura, sem migrar pointer ou registry; exclui evidência de sessão/change irmã ativa e preserva material global/histórico. `/brain-recall` explícito segue global. - **Compatibilidade conservadora.** O comportamento anterior permanece somente quando o registry ainda não possui nenhum campo do store contextual, inclusive quando `active_contexts` está vazio. ## [0.76.6] — 2026-08-22 ### Fixed - **Task lease causal.** `operating_profile_task` passa a pertencer ao `active_contexts` da worktree/work session; rotas temporárias irmãs não se sobrescrevem nem ampliam autorização. - **CLI e hooks escopados.** `profile route/status`, os hooks de operating profile e o consumo no Stop resolvem a lease do chamador e preservam o sibling byte a byte por revision/CAS. - **Fallback legado fail-closed.** Vault sem registry contextual conserva a lease na sessão; depois da inicialização, uma lease global não é copiada nem aplicada sem identidade provada. ## [0.76.5] — 2026-08-22 ### Added - **Delivery causal.** `delivery_id` passa a pertencer ao `active_contexts` da worktree/work session; start, status, finish e abandon isolam deliveries concorrentes e rejeitam IDs de outro contexto. - **Hooks escopados.** `change-context` e `change-warn` só reconhecem a autorização de delivery do chamador causal, sem herdar permissões de sessões irmãs. - **Compatibilidade conservadora.** `CURRENT_DELIVERY` vira projeção somente para um contexto inequívoco; falha de bind remove o estado recém-criado sem publicar ponteiro parcial. ## [0.76.4] — 2026-08-22 ### Added - **Registry multi-contexto.** `active_contexts` mantém change, branch e HEAD por `repository_id` + `worktree_id` + `work_session_id`, com schema, revisão, CAS e writes atômicos; duas worktrees ou sessões deixam de sobrescrever o foco operacional umas das outras. - **Resolução causal de change.** Change, spec e verify usam a sessão/worktree chamadora; ausência de sessão só aceita um contexto inequívoco e qualquer ambiguidade falha fechado. - **Compatibilidade conservadora.** `CURRENT_CHANGE.md` é somente projeção quando há um único contexto ativo, e a migração legada não inventa worktree ou sessão quando a identidade não pode ser provada. ## [0.76.3] — 2026-08-21 ### Added - **Recuperação explícita do contexto em quarentena.** `context status --session ` inventaria candidatas `reserved`/`observed` sem paths locais; `context recover` exige seleção, revisão CAS, motivo e correspondência integral com o checkout/HEAD antes de limpar o conflito. - **Receipt pós-conflito.** A recuperação preserva change, lease e autorizações, incrementa a revisão e registra evidência sanitizada `from/to`; revision stale, identidade divergente ou falha de persistência mantêm registry e quarentena intactos. ## [0.76.2] — 2026-08-21 ### Fixed - **Projeção SHARED bounded na origem.** O projector agora admite eventos completos de forma determinística e priorizada, nunca publica `SHARED_MEMORY.md` acima de 48 linhas/6144 bytes e declara as contagens projetada/omitida sem perder a autoridade integral do ledger. - **Omissão bounded verificável.** O gate semântico rederiva a seleção esperada; apenas o recorte exato é aceito como aviso operacional, enquanto IDs ou contagens divergentes continuam bloqueando. - **Recuperação antes de rescope.** Com memória estruturalmente bloqueada, o doctor orienta `memory repair` e novo `memory status --gate` antes de voltar ao dry-run, sem recomendar `memory rescope --apply` sobre uma projeção inválida. ## [0.76.1] — 2026-08-21 ### Added - **Transição causal de branch.** `context switch [--create] [--session ]` move Git e a scope da mesma sessão juntos na worktree atual, preserva change/lease/autorizações, incrementa revisão e registra evidência `from/to` sob o lock do registry. ### Fixed - **Guard não deixa mais a sessão inutilizável após checkout.** `git checkout/switch` cru que mudaria branch é negado antecipadamente com orientação acionável; falha durante a transição segura executa rollback da branch/HEAD e não publica scope parcial. Contextos incompletos de outra worktree comprovada também deixam de causar falso conflito na worktree atual. ## [0.76.0] — 2026-08-21 ### Added - **Worktrees gerenciadas e seguras.** `worktree create/list/status/open` cria linked worktrees idempotentes sob `.worktrees`, com branch `wk/`, validação de path/ref e abertura opcional em nova janela do VS Code. O registry privado no Git common-dir compartilha identidade e Vault canônico sem alterar `.wendkeep.json`, usa lock multiprocesso e registra falhas recuperáveis. - **Integração operacional.** `doctor` reconcilia registry/Git, `init` e `sync` aceitam `--vscode-worktree-tasks` sem sobrescrever preferências locais, e ignores/walkers excluem a raiz gerenciada. Saídas humanas são bilíngues e `--json` preserva o boundary do Vault. ### Fixed - **Gate staged sem falsos positivos.** O scanner reconhece códigos públicos `WENDKEEP_*`, limita a allowlist de diagnósticos às superfícies de observabilidade e mantém bloqueio de identificadores opacos; fixtures do worktree manager usam exclusivamente o namespace sintético `wk-fixture-*`. ## [0.75.3] — 2026-08-20 ### Fixed - **Sync seguro no self-checkout.** O instalador agora reconhece o repositório do próprio WendKeep e migra hooks Claude/Codex para `node ./bin/wendkeep.mjs` sem duplicá-los. Projetos consumidores continuam usando `npx --no-install`, e executar `sync` no checkout de desenvolvimento não reintroduz a autodependência publicada. ## [0.75.2] — 2026-08-20 ### Fixed - **Handoffs legados reescopáveis.** `memory rescope` agora separa individualmente eventos `handoff.latest` ambíguos quando a sessão de origem é comprovável. A migração permanece append-only, não escolhe vencedor e conserva ambiguidades reais dentro da mesma work session. - **Curadoria proporcional.** `memory curate` mostra conflitos acionáveis por padrão; `--all` inclui handoffs de sessões encerradas com status/change sanitizados e permite `H` para encerrar em lote somente recomendações seguras, sempre com confirmação e releitura entre decisões. - **Diagnóstico sem falso bloqueio.** O doctor separa conflitos acionáveis de handoffs históricos reparáveis no mesmo snapshot. Dívida histórica isolada gera atenção e orienta `memory rescope`, sem degradar a memória nem ocultar a contagem restante. ## [0.75.1] — 2026-08-20 ### Fixed - **Coalescência sem perda.** A outbox seleciona o identificador próprio de cada tipo de evento; chamadas, agentes, rollups e transcripts distintos da mesma sessão não disputam mais a mesma chave. - **Reconciliação realmente integral.** `observer reconcile --url` e `observer memory import` ignoram o cursor incremental local, consultam as revisões remotas e regeneram documentos, consumo, chamadas e transcripts mesmo após restauração ou troca do Observer. - **Leases compatíveis com o transporte.** Locks de batch e publisher permanecem válidos além do timeout máximo de request e só podem ser liberados pelo proprietário que os adquiriu. ## [0.75.0] — 2026-08-20 ### Added - **Identidades SQL escopadas por projeto.** Sessões, agentes, rollups, chamadas e transcripts mantêm chaves internas derivadas de `project_id` + identificador externo, constraints compostas e foreign keys que carregam o projeto. Colisões deliberadas entre projetos ficam isoladas. - **Migrações comprováveis.** Cada arquivo de schema recebe checksum; uma migração estrutural de base existente cria backup consistente antes da transação e pode ser retomada com segurança. - **Reconciliação explícita.** `observer reconcile` reserva a varredura integral para bootstrap, reparo e comprovação de paridade por hash, localmente ou contra o serviço. - **Outbox observável.** `doctor` informa lotes, eventos, bytes e idade; uma lease admite apenas um publisher e batches do mesmo escopo são coalescidos. ### Changed - **Publicação incremental nos hooks.** `SessionStart` apenas drena, `Stop` lê uma sessão e `SubagentStop` somente o transcript afetado. `note new` e `change archive` enfileiram diretamente os documentos que escreveram. O file store antigo deixa de receber publicação viva e permanece apenas como fonte de migração. - **Schema SQL 5.** O mesmo `session_id`, `agent_id`, `call_id`, `transcript_id` ou `rollup_key` pode existir em projetos diferentes sem disputar uma linha global. ### Fixed - **Ingest atômico por evento.** Cada evento usa `SAVEPOINT ingest_one`; qualquer falha reverte o registro de ingestão e todas as projeções antes de o batch continuar. Retry permanece idempotente. - **Chamadas incrementais estáveis.** Turnos concluídos usam identidade causal estável, evitando duplicação quando um transcript cresce após a primeira publicação. ### Performance - O caminho de hook não varre mais o Vault. A fixture de publicação incremental comprova `p95 < 200 ms`, uma sessão lida por `Stop` e zero documentos lidos por `SessionStart`. ## [0.74.0] — 2026-08-20 ### Added - **Registradores de memória escopados.** Eventos novos declaram escopo de projeto, work session, change, branch ou worktree. HEADs de branches paralelas coexistem, enquanto decisões, constraints e blockers realmente incompatíveis continuam sob curadoria humana. - **Migração append-only de escopo.** `memory rescope` mostra uma prévia sem valores e `memory rescope --apply` anexa eventos de reescopo sem reescrever o ledger histórico; retry é idempotente e candidates ambíguos não recebem vencedor automático. - **Recall baseado em evidências.** O índice `.brain/EVIDENCE_INDEX.jsonl` divide Markdown por headings, parágrafos, decisões, tarefas, requisitos e evidências, preservando origem, heading, autoridade, validade, sessão, work session, change e hash. - **Context broker por prompt.** `UserPromptSubmit` consulta o índice local, aplica ranking lexical BM25 com frase exata, peso por campo, autoridade, validade, recência limitada e diversidade, e injeta somente os melhores trechos dentro de um budget explícito. - **FTS5 no Observer.** O schema SQL 4 mantém chunks por projeto, faz feature probe de FTS5 e usa o mesmo ranking/proveniência do Keep Core com fallback lexical quando a extensão não está disponível. ### Changed - **Ambiguidade fica isolada.** Uma chave conflitante é omitida da projeção operacional e recebe marcador de revisão; CORE e registros independentes continuam disponíveis. - **`/brain-recall` retorna passagens.** Resultados agora apontam para o trecho do match e incluem arquivo, heading, autoridade, data e validade, em vez de retornar somente nomes de sessões. ### Performance - Documentos excepcionalmente grandes usam amostragem distribuída limitada a 4 MiB no índice de chunks, preservando o transporte gzip e evitando trabalho proporcional a transcripts gigantes. ## [0.73.0] — 2026-08-20 ### Added - **Work kind independente do perfil.** `inspection`, `maintenance`, `implementation`, `delivery` e `recovery` passam a ser classificados separadamente de perfil, impacto de contrato e risco operacional. - **Delivery com autorização e receipt.** `delivery start/status/finish/abandon` captura repositório, branch/worktree, SHA, change de origem e capabilities; comprova target, CI, versão, tag, integridade npm e GitHub Release quando aplicável, sem criar change, spec ou ADR. - **GUIDE realmente compacta.** `change new --guide` gera somente objetivo, critérios de aceite, áreas afetadas, testes e resultado. Sem impacto de contrato, seu archive não fabrica design, delta de spec ou ADR. ### Changed - **Doctor proporcional.** O diagnóstico separa erro estrutural, atenção de workflow, dívida reparável e ambiguidade semântica. `--scope core|runtime` isola as superfícies e `--strict` promove pendências a falha para CI/release. - **Sync valida somente o Keep Core.** Trabalho em andamento no Wend Runtime deixa de transformar uma instalação saudável em falha; a conclusão informa separadamente a saúde do Core. - **Conflitos semânticos degradam por chave.** Candidates ativos aguardam curadoria sem bloquear o bundle inteiro; corrupção de ledger, boundary, identidade ou projeção continua falhando fechada. ### Fixed - **Proveniência preserva lifecycle scripts.** A comparação de integridade executa `npm pack` normalmente em uma cópia isolada, mantendo `prepack`/`postpack` e impedindo que a verificação altere o working tree de origem. ## [0.72.1] — 2026-08-20 ### Added - **Proveniência verificável de release.** A publicação gera um receipt com commit, versão, tag, integridade npm, execução do workflow e GitHub Release, e recusa divergências entre o SHA testado, a tag e o tarball publicado. - **Contrato seguro do Observer.** O Keep Core permanece em Node.js 18+, enquanto comandos SQL diagnosticam `WENDKEEP_OBSERVER_NODE_UNSUPPORTED` abaixo do Node.js 22.13. Mutações exigem Bearer, non-loopback exige token e requisições validam Host e Origin. - **Níveis de captura.** `metadata` é o padrão sem mensagens; `messages` e `full-transcript` são opt-in. Caminhos absolutos não são publicados e init recomenda ignorar state e outbox SQL. ### Changed - **Release somente após CI verde.** O workflow publica o SHA aprovado pela matriz Core (Node 18/20) e Observer (Node 22.13/24), cria a tag no mesmo commit e pode reconciliar execuções repetidas. - **Dogfooding pelo working tree.** O repositório não depende mais de `wendkeep` em devDependencies; seus hooks chamam `node ./bin/wendkeep.mjs`, enquanto projetos consumidores usam `npx --no-install wendkeep` e o tarball continua testado isoladamente. ### Fixed - **Identidade de arquivos de memória no Windows.** A revalidação compara o índice do arquivo como inteiro exato e tolera a inconsistência conhecida do serial de volume do libuv antigo, evitando falsos `VAULT_PATH_UNSAFE` no Node.js 22.13 sem relaxar a rejeição de hardlinks ou reparses. - **Ingestão SQL grande em runners lentos.** O timeout HTTP cresce com o tamanho bruto do lote até 120 segundos, preservando 15 segundos para payloads vazios/pequenos e evitando outbox falsa para lotes gzip válidos acima de 64 MB. - **Trusted Publisher preservado após o gate de CI.** `auto-tag.yml`, o workflow já autorizado no npm, passa a executar a matriz da `main` e mantém o publish em um job com `needs: test`; `test.yml` fica exclusivo para pull requests. ## [0.72.0] — 2026-08-17 ### Added - **Observer SQL authority.** O volume Docker agora usa `/data/observer.sqlite` como autoridade única para documentos, sessões, agentes, uso, chamadas LLM e transcripts comprimidos; as migrações SQL são versionadas e idempotentes. - **Ingestão resiliente.** Hooks de sessão e subagentes enviam eventos idempotentes ao Observer, preservam custos registrados e usam outbox local quando o container está indisponível. - **Dashboard de Consumo.** Cada projeto ganhou resumo de tokens/custos, filtros, hierarquia agente/subagente/modelo, tendência diária, chamadas e leitura de transcript. - **Migração sem perda.** Conteúdo legado do volume, `MEMORY_EVENTS.jsonl`, frontmatter de custo e históricos sem transcript são importados sem apagar as fontes existentes; históricos incompletos são marcados como `summary_only`; divergências entre frontmatter e ledger ficam em linhas explícitas de reconciliação e `session_id` duplicado é desambiguado por arquivo. ### Changed - Markdown deixou de ser autoridade operacional no container. Ele permanece armazenado como conteúdo documental no SQLite e só é materializado por exportação explícita. - O transporte divide lotes por quantidade e tamanho, reconhece retries do hash legado e preserva transcripts grandes dentro do limite HTTP do Observer. - Lotes SQL agora usam gzip no transporte e são expandidos com limite controlado no Observer, permitindo importar transcripts históricos que excedem 64 MB em JSON puro sem aumentar indiscriminadamente o limite de requisição. ## [0.71.1] — 2026-08-17 ### Added - **Observer memory authority.** O container local agora recebe a cópia integral das sessões, decisões, bugs, aprendizados, specs, changes, CORE, DIGEST, SHARED_MEMORY e estado do brain. A API oferece árvore, leitura completa, busca por corpo, sincronização, modos `mirror`/`container-read`/`container-authority` e exportação read-only. - **Workspace de memória no navegador.** O painel local navega por projeto, sessões, memória, changes, sincronização e leitor Markdown completo, sem formulário ou token no loopback. - **Importação do WendKeep.** `observer memory import` registra a carga inicial e informa paridade por arquivo e hash; o volume Docker permanece preservado em rebuild e reinício. ### Fixed - **Observer local abre diretamente.** O dashboard não exige mais token, formulário ou `Authorization` para consultar a projeção no loopback; o compose também inicia sem variável de token obrigatória. ## [0.71.0] — 2026-08-17 ### Added - **Painel web local do Observer.** O servidor agora entrega uma interface read-only no navegador para consultar projetos, saúde, sessões, changes e snapshots sanitizados da última captura. A interface é empacotada no npm e na imagem Docker, exige o token local para consultar `/v1`, mantém o token somente no `sessionStorage` da aba e não amplia o contrato de dados sanitizados. ## [0.70.0] — 2026-08-17 ### Added - **Observer local multi-projeto.** O WendKeep agora expõe snapshots sanitizados, ingestão HTTP loopback, índice append-only reconstruível, CLI `observer`, outbox fail-open nos hooks e um compose Docker que persiste somente a projeção; os vaults locais continuam sendo a autoridade. ### Fixed - **Modelos research preview agora são distinguidos de modelos desconhecidos.** O Spark é reconhecido sem preço inventado, o `doctor` mantém o custo não estimado e a cobertura de preços passa a ser validada por sensor crítico. ## [0.69.0] — 2026-08-16 ### Added - **A Shared Project Memory v2 preserva handoffs estruturados entre providers.** Stop publica objetivo, entrega, restrições, decisões, próximas ações, bloqueios e riscos com `work_session_id`; CORE continua manual com cap 40/alerta 35, e status/validate-memory diagnosticam cobertura semântica sem expor valores privados. ## [0.68.6] — 2026-08-16 ### Fixed - **A orientação de atualização em monorepos pnpm agora resolve a versão publicada antes da instalação.** README e guias bilíngues deixam de oferecer `X.Y.Z` como argumento copiável, explicam o cooldown silencioso de `@latest` e orientam a regeneração segura do lock quando a integridade do tarball divergir. ## [0.68.5] — 2026-08-14 ### Fixed - **O Stop passa a deixar um resultado durável por sessão, turno e estágio.** O ledger local, append-only, sanitizado distingue inserção, duplicata, caminho pulado, abortado, lock ocupado, falha e status de observabilidade; o cursor só avança após confirmação da nota. - **A importação Codex compartilha a normalização de conteúdo sintético e ferramentas.** `subagent_notification` não vira prompt, `turn_aborted` é explícito e a saída de uma `custom_tool_call` não é contada como uma segunda chamada. - **O encerramento de uma sessão alinha a projeção e a autoridade causal.** O Stop marca a activation e a sessão como `done` no `SESSION_REGISTRY.json` somente depois da publicação de memória/observabilidade; `CURRENT_SESSION.md` continua sendo uma visão derivada e não lista sessões já finalizadas. - **O release automático publica no npm por OIDC antes de criar tag e GitHub Release.** O `auto-tag.yml` usa Node 24, prepara o registry público, ignora versões já publicadas com `--prefer-online` e deixa a provenance ser gerada pela própria publicação confiável. ## [0.68.4] — 2026-08-14 ### Fixed - **O guard de escopo do projeto passa a proteger mutações antes da ferramenta.** O `PreToolUse` do Codex revalida sessão, projeto, raiz Git, remoto, branch/worktree e concorrência; mantém `commit`, `push`, `pull`, `merge`, `publish` e operações destrutivas como capacidades independentes, com bloqueio fail-closed para alvos ausentes ou divergentes. ## [0.68.3] — 2026-08-13 ### Fixed - **Deferred replay reancora candidates de memória na fonte causal final.** Depois de uma promoção legacy válida, um assert moderno reaplicado pelo replay não deixa mais os candidates posteriores presos à fonte intermediária. A promoção explícita continua exigindo o guard causal e mantém o fail-closed para linhagens incompletas ou ambíguas; o ledger permanece append-only. ## [0.68.2] — 2026-08-08 ### Fixed - **O guard do `npm run release` deixa de bloquear a tag criada pelo `auto-tag.yml`.** Os dois automatismos assumem ordens opostas: o script publica no npm e então cria a tag, enquanto o workflow cria a tag no merge em `main`, antes de qualquer publish. Quando o merge precedia o publish — o caminho normal de um PR — o release abortava num estado perfeitamente publicável. O guard passa a proteger a unicidade da versão no registry, não a ausência da tag: publica e preserva a tag existente quando ela aponta para o commit corrente, e continua abortando se a versão já foi lançada ou se a tag aponta para outro commit. A decisão virou função pura, então a matriz de estados é verificável sem publicar nem mutar o repositório. ## [0.68.1] — 2026-08-08 ### Fixed - **A contenção de locks do Vault deixa de expor `VAULT_PATH_UNSAFE` no Windows.** A revalidação de uma falha transiente de resolução do lock público passa a decidir por um walk fresco do componente, e não pelo `errno` reportado pela plataforma. O Windows devolve `UNKNOWN`, `EBADF` ou `EPERM` onde o Linux devolve `ENOENT`, então a guarda de retry nunca disparava lá e promoções FLOW concorrentes falhavam de forma intermitente com o código de fronteira física em vez do conflito de promoção. Sufixo ausente ou diretório canônico estabilizado autorizam o retry; junction, symlink, reparse point, componente redirecionado ou estado irresolvível persistente continuam falhando fechado, e o orçamento de retry permanece único e limitado por aquisição. - **Falha de lock nos caminhos FLOW reporta o código do domínio.** `withFlowPromotionLock` e o store de sessão passam a propagar `FLOW_VAULT_BOUNDARY` para a fronteira física, alinhando a superfície de erro ao resto da saga de promoção. ## [0.68.0] — 2026-08-02 ### Added - **Curadoria de memória agora tem um assistente interativo para pessoas.** O novo `memory curate --vault ` agrupa conflitos por nomes amigáveis, exibe somente previews sanitizados e guia promoção, rejeição, pulo ou saída com confirmação negativa por padrão. O trabalho restante pode ser retomado em outra execução; ambientes não-TTY recebem o fallback seguro `memory candidates --active` e nenhuma escrita implícita. ### Changed - **O `doctor` apresenta integridade e conflitos de memória em formato humano.** A saída principal usa seções e categorias amigáveis e recomenda primeiro o assistente guiado, enquanto o hook de health preserva seu contrato JSON para automações. O diagnóstico continua somente leitura e `memory repair` continua estritamente estrutural, sem escolher vencedores semânticos. ## [0.67.3] — 2026-08-02 ### Fixed - **Conflitos semânticos agora levam a uma curadoria humana executável.** O doctor diferencia candidates em conflito de corrupção estrutural, explica que `memory repair` não escolhe um vencedor e mostra `memory candidates --active --vault ` com o Vault resolvido, seguido pelos modelos explícitos para promover ou rejeitar a decisão. - **A inspeção de candidates deixa de exigir leitura direta do sidecar.** O novo comando read-only `memory candidates [--active]` devolve somente `candidate_id`, `reason`, `status`, `memory_key` e `event_ids`, sem valores ou conteúdo, em ordem determinística e sem alterar o bundle de memória. ## [0.67.2] — 2026-08-02 ### Fixed - **O doctor agora exibe comandos de reparo executáveis no projeto.** Os diagnósticos de memória e observabilidade usam `npx --no-install wendkeep`, informam o Vault absoluto resolvido em `--vault` e mantêm a sequência segura de inspeção (dry-run) antes da variante explícita com `--apply`. - **O doctor continua somente leitura.** A correção altera apenas as recomendações exibidas; o reparo continua exigindo execução humana do comando `--apply`. ## [0.67.1] — 2026-08-02 ### Fixed - **Turnos de subagents não bloqueiam mais a captura da sessão-mãe.** `UserPromptSubmit` de rollout filho registra o path para observabilidade sem avançar a sequência principal, e `SessionStop` prefere o mapeamento causal `turn_sequences[turn_id]` antes da ordem local do transcript. Isso preserva os marcadores `wk-turn`, o encerramento e a memória mesmo com filhos intercalados. - **`SubagentStop` consome o transcript correto do payload Codex.** O hook resolve o filho por `agent_transcript_path`/`agentTranscriptPath`, valida identidade, sessão e `parent_thread_id` contra um root comprovado e mantém `transcript_path` como contexto da sessão-mãe, permitindo preencher `Subagents e workflows` no último filho sem aceitar sinais de outra cadeia. - **O backfill não grava o turno Codex ainda em execução.** `hook session-backfill` exige `task_complete`, separa `missingTurns` de `incompleteTurns`, permanece dry-run por padrão e aplica somente turnos concluídos de forma idempotente. A CLI agora encaminha `--session`, `--vault`, `--write` e demais argumentos ao hook executado. README e guias PT-BR/EN documentam o reparo. - **O bloco gerenciado do `AGENTS.md` exige roteamento adaptativo antes de editar.** O harness inspeciona o perfil-base, classifica a solicitação, registra uma lease temporária entre `FLOW`, `GUIDE`, `GOVERN` e `ASSURE` e confirma o perfil efetivo; `OFF` nunca é escolhido pela LLM e a escolha explícita do usuário prevalece. - **O scanner de privacidade distingue configuração pública de identificadores privados.** Comandos longos legítimos em `wendkeep.sensors.json` deixam de gerar falso positivo, sem permitir que UUID, hash, token compacto, campo desconhecido ou path absoluto sejam ocultados pela exceção. ## [0.67.0] — 2026-08-01 ### Added - **O harness da LLM pode selecionar uma rota Wend temporária por solicitação.** `profile route --session --reason ` grava uma lease auditável ligada ao prompt atual, sem alterar o perfil persistente do projeto ou da sessão. `OFF` permanece exclusivamente humano e é rejeitado na seleção adaptativa. Contexto sem prompt causal completo e coincidente no registry falha antes de mutar, e `profile status --session` mostra perfil-base e estado da lease também na saída humana. - **A lease expira causalmente sem interromper implementações longas.** Um Stop aceito a consome por CAS; bloqueio/retry a preserva, e o próximo prompt restaura o perfil-base mesmo depois de crash ou hook ausente. Skills e AGENTS gerados ensinam a matriz FLOW/GUIDE/GOVERN/ASSURE. ### Fixed - **Sessões Obsidian não renderizam envelopes internos do assistente como HTML.** A captura remove metadata completa ou truncada de citação somente das respostas do assistente e escapa tags XML-like nas linhas geradas, preservando relatos do usuário e autolinks HTTP(S). Reimport e `SessionStop` convergem no mesmo normalizador idempotente, e o encerramento migra somente campos gerados reconhecíveis de notas antigas sem reescrever prosa autoral. - **README e guias bilíngues explicam as letras `P/R/E/V/C` e a duração das escolhas.** A documentação distingue `profile use` persistente de `profile route` por solicitação e deixa explícito que a classificação semântica pertence ao harness, não a heurísticas do runtime. - **Sensores vermelhos deixam diagnóstico acionável sem persistir logs verdes.** O runner captura stdout/stderr com limite, redige segredos e grava no máximo 2.000 caracteres apenas na entrada vermelha de `evidencia.json`, em vez de descartar a causa da falha. ## [0.66.5] — 2026-08-01 ### Fixed - **A observabilidade Codex passa a registrar o grafo completo de subagentes.** Metadata é lida incrementalmente mesmo em rollouts grandes; descendentes em dias posteriores ou níveis aninhados são atribuídos uma única vez, enquanto transcripts top-level permanecem no bucket principal e sinais duplicados ou atrasados não regridem o snapshot publicado. - **SessionStop e SubagentStop convergem sob frontier causal e estado explícito.** O schema 2 distingue `complete`, `none` e `degraded`, coalesce rajadas com lease, preserva o último snapshot íntegro diante de fonte incompleta e mantém cache/runtime reconstruíveis sem publicar zero silencioso. - **Rebuild, import e doctor agora reconciliam a observabilidade persistida.** Preview permanece sem escrita, apply rejeita resultado parcial, import atualiza notas completas porém stale e o doctor correlaciona checkpoint, manifest e dirty para expor degradação real. ### Security - **Diagnostics e provas públicas aplicam uma fronteira de privacidade estável.** Somente pares allowlisted `{code,count}` podem ser persistidos; paths, identificadores, prompts e exceções brutas ficam fora de fixtures, evidências e notas de release. ## [0.66.4] — 2026-07-30 ### Fixed - **`memory repair` fecha o acknowledgement apenas para a outbox que a própria execução consumiu integralmente.** O receipt do projetor preserva idempotência e impede que attempts históricos, parciais, causalmente divergentes ou concorrentes sejam reclassificados. - **`memory recover-attempt ` recupera com segurança o estado já projetado pela 0.66.3.** O dry-run é padrão e `--apply` altera somente o registry/checkpoint sob prova física, lock e CAS; A→B→A, ledger/sidecars divergentes, outbox pendente e links inseguros falham sem escrita. O diagnóstico agora orienta esse comando quando o acknowledgement ficou pendente. ## [0.66.3] — 2026-07-30 ### Fixed - **O replay reavalia candidates transitórios contra a fonte moderna final.** Um Stop da mesma sessão/activation/epoch e turno maior agora avança depois que a correção causal já presente se torna ativa; turno menor fica superseded e divergências reais continuam para curadoria. - **`memory repair` migra o checkpoint antigo somente com prova e CAS.** O repair compara a semântica anterior e a atual, faz backup, atualiza attempt e espelho e registra auditoria sem reordenar, reescrever ou acrescentar evento ao ledger. Prova incompleta continua bloqueada. A 0.66.2 não deve ser publicada no npm; publique e instale a 0.66.3. ## [0.66.2] — 2026-07-29 ### Fixed - **Promoção preserva valor e identidade causal do evento escolhido.** `memory promote` não converte mais objetos/arrays JSON em texto e mantém sessão, activation/epoch, turno de origem e sequência; o próximo `SessionStop` da mesma cadeia avança o handoff sem recriar candidate. - **A recuperação 0.66.1 cobre inversão física/temporal sem ampliar autoridade.** Quando uma promoção legada projetada fica fora do candidate por `observed_at`, `memory promote` só a inclui em `supersedes` sob prova de ancestralidade e mesma linhagem; fonte moderna ou alheia falha antes de anexar. O E2E percorre o dispatcher público e prova Stop posterior e duplicado idempotentes. ## [0.66.1] — 2026-07-29 ### Fixed - **A curadoria de candidates agora é durável e idempotente.** `memory promote` e `memory reject` registram decisões causais no ledger; repair/replay não recriam o conflito resolvido, retries não duplicam eventos, candidates sobrepostos permanecem isolados e a promoção recupera o checkpoint divergente do attempt correspondente sem tocar attempt novo. - **Promoção de conflito exige escolha explícita.** `memory promote --event ` publica exatamente o evento escolhido, rejeita IDs externos ao candidate e não permite que `blocked_by_core` sobrescreva a autoridade canônica de CORE. ## [0.66.0] — 2026-07-29 ### Added - **O workspace privado Integrations passa a ter um kernel canônico para Claude Code e Codex.** Catálogo/projeção de hooks, envelope e provider, filtros de conteúdo, normalização de uso, parsers de transcript e identidade de sessão/turno agora vivem em módulos puros sob `packages/integrations/src/`, sem filesystem, ambiente global, Vault ou registry no import. - **O tarball instalado prova a fronteira completa fora do checkout.** O teste executa `init` e um hook `session-ensure` em consumidor temporário, valida estado persistido e as projeções Claude/Codex contra o kernel empacotado, e confirma que Integrations permanece interno à única publicação `wendkeep`. ### Changed - **As fachadas históricas agora injetam efeitos no kernel de Integrations.** Taxonomia e hooks preservam assinaturas e identidade dos exports enquanto stdin/stdout, `process.env`, leitura de transcripts, acesso ao Vault e ao registry continuam nas bordas; paths, schemas, configs e sessões existentes não exigem migração. - **Os workspaces privados deixaram de vazar por deep imports do wildcard raiz.** A allowlist de exports mantém `wendkeep/harness`, `wendkeep/vault` e os caminhos históricos publicados, mas bloqueia `packages/*`, inclusive variantes percent-encoded; MCP e Integrations seguem como adapters irmãos sem dependência direta. ### Fixed - **A reconexão de sessão por transcript agora respeita o provider.** Uma entrada do registry de outro host é ignorada sem substituir uma identidade canônica válida já inspecionada. - **A suíte integral mantém determinismo sob carga de I/O no Windows.** O runner limita a duas as files executadas em paralelo, preservando a concorrência multiprocesso dentro dos testes de CAS/locks e todos os asserts, sem falsos vermelhos causados por starvation entre suítes. ## [0.65.0] — 2026-07-29 ### Added - **O workspace privado MCP passa a ter um kernel canônico de configuração.** `packages/mcp/src/config.mjs` concentra a entrada do MCPVault, a seleção de servidores por descritores e o merge imutável de `.mcp.json`, sem efeitos no import. - **O tarball instalado prova a composição MCP fora do checkout.** O teste executa `init` em um consumidor temporário, confirma a preservação de configuração existente e rejeita exports públicos prematuros como `wendkeep/mcp` e `@wendkeep/mcp`. ### Changed - **Taxonomia e instalador agora delegam ao kernel MCP.** `src/taxonomy.mjs` fornece descritores como dados e preserva a identidade dos exports históricos; `src/init.mjs` mantém a orquestração do filesystem e o comportamento de reconciliação, inclusive `.mcp.json.new` para JSON inválido. - **A publicação continua unificada e compatível.** Não há servidor MCP nativo, subpath público ou pacote npm separado nesta fase; comandos, flags, transporte MCPVault e arquivos existentes preservam o comportamento anterior. ## [0.64.0] — 2026-07-28 ### Added - **O workspace privado CLI passa a ter runtime canônico em `packages/cli/src/index.mjs`.** Help, versão, seleção de Vault, apresentação de erros e dispatch lazy agora pertencem à fronteira `@wendkeep/cli`, com import sem autoexecução. - **O tarball instalado prova a CLI fora do checkout.** A distribuição inclui o runtime novo e exercita os aliases `wendkeep` e `wk` em um consumidor temporário, mantendo o pacote raiz como a única unidade npm. ### Changed - **`bin/wendkeep.mjs` agora é uma fachada executável fina.** O arquivo preserva o shebang e apenas invoca `runCli()`, enquanto comandos, flags, help antes do Vault, streams, mensagens e códigos de saída mantêm o comportamento anterior. - **A CLI programática permanece privada durante a migração.** Não há export raiz `wendkeep/cli`; as superfícies públicas continuam sendo os binários, `wendkeep/harness` e `wendkeep/vault`. ## [0.63.0] — 2026-07-28 ### Added - **O Vault público passa a expor locale e taxonomia de pastas, e o Harness passa a expor o store durável de FLOW.** As novas superfícies canônicas estão disponíveis por wendkeep/vault e wendkeep/harness e são validadas a partir de um tarball instalado em consumidor isolado, inclusive com um ciclo persistido completo. ### Changed - **Locale agora pertence a packages/vault/src e o store de FLOW a packages/harness/src.** hooks/locale.mjs e hooks/vault-runtime-store.mjs permanecem como fachadas puras, preservando por identidade todas as constantes e funções usadas por consumidores existentes. - **A extração stateful não exige migração.** Paths em .brain/runtime, schemas, ids, locks, tentativas, recibos, reservas, promoções, atomicidade, contenção multiprocesso e validação física de paths mantêm o contrato anterior. - **A direção Harness → Vault é verificada pelo índice público canônico.** Vault continua proibido de depender do Harness, enquanto CLI, MCP, Integrations, Pi e flow-core permanecem fora deste corte modular. ### Fixed - **Promoções concorrentes no Windows/Node 22 não confundem a liberação transitória do lock com um path inseguro.** O Vault agora revalida, com backoff curto e limitado, o lock público que desaparece entre `lstat` e `realpath` e leituras `ENOENT` de owner/lease. A aquisição compartilha um único budget/deadline e a liberação limpa o lock sem resíduo; junctions, reparse points, links dangling, erros não transitórios e locks privados `.pending` continuam falhando fechado. ## [0.62.0] — 2026-07-28 ### Added - **`wendkeep/harness` passa a expor o policy kernel reutilizável.** Os contratos dos cinco Perfis de Operação e a engine de sensores podem ser importados pela superfície pública do pacote raiz, com identidade validada a partir de um tarball realmente instalado. ### Changed - **As implementações canônicas de perfis e sensores agora pertencem a `packages/harness/src`.** `src/operating-profile.mjs` e `hooks/sensors-core.mjs` permanecem como fachadas de reexport, preservando funções, constantes, objetos congelados e consumidores atuais. - **A direção modular do Harness virou contrato estrutural.** O workspace aceita somente built-ins, módulos internos e a superfície pública do Vault; Vault continua proibido de depender do Harness, e CLI, MCP, Integrations e Pi permanecem adaptadores superiores. - **OFF preserva a semântica publicada:** Keep Core/Vault continua ativo e a governança automática fica desligada; comandos explícitos do operador não ganham bloqueios novos nesta extração. ## [0.61.0] — 2026-07-28 ### Added - **`wendkeep/vault` passa a expor o kernel de memória operacional.** Schema v2, detecção de modo, handoff, ledger/projeção e validadores CORE/SHARED ficam disponíveis pela superfície pública e são exercitados a partir de um tarball realmente instalado. ### Changed - **A implementação canônica do kernel agora pertence a `packages/vault/src`.** Os paths históricos em `hooks/` e `src/` permanecem como fachadas de reexport, inclusive por bare specifiers no pacote instalado, preservando identidade de funções, classes, constantes e compatibilidade com consumidores existentes. - **A extração é estrutural e não migra dados.** Schema 2, ledger, locks, projeção, SessionStop e o conteúdo de cada Vault mantêm o mesmo contrato persistente. ### Fixed - **`memory repair` converge checkpoints assert-only históricos pré-0.59 sem editar o ledger.** O repair só migra quando prefixo, revision, cursor, hash, identidade e turns reproduzem exatamente a semântica antiga e o espelho `memory_checkpoint` é compatível; o caminho preserva CORE/ledger, usa CAS do attempt e do espelho, backup e auditoria e continua falhando fechado para tuples, operações ou espelhos divergentes. ## [0.60.0] — 2026-07-27 ### Added - **O runtime ganha seis fronteiras físicas internas:** `cli`, `harness`, `vault`, `mcp`, `integrations` e `pi` passam a existir como workspaces privados `@wendkeep/*`, mantendo `wendkeep` como uma única unidade de instalação e publicação. - **O Keep Core inaugura a API programática `wendkeep/vault`.** Binding/resolução do Vault e a fronteira segura de paths podem ser importados pelo novo subpath público, incluído e validado no tarball. ### Changed - **Binding e segurança física agora pertencem a `packages/vault`.** Os paths históricos em `src/project-vault.mjs` e `hooks/vault-path-safety.mjs` permanecem como fachadas compatíveis, sem alterar CLI, hooks ou dados existentes. - **A direção de dependências virou gate estrutural.** O workspace Vault aceita somente built-ins Node e módulos internos, impedindo que Keep Core passe a depender de Harness, perfis, changes, FLOW, sensores ou CLI. ## [0.59.0] — 2026-07-27 ### Added - **Perfis de Operação separam memória persistente de governança:** `OFF`, `FLOW`, `GUIDE`, `GOVERN` e `ASSURE`, com resolução explícita por sessão ou projeto e fallback conservador para `GOVERN`. O novo `wendkeep profile status|use` torna a escolha e sua origem auditáveis. - **FLOW executa ajustes pequenos por um microcontrato E → V:** `flow start/status/show/finish` exige allowlist e sensores, registra baseline Git e tentativas no Vault e produz um recibo terminal imutável sem criar change, ADR ou veredicto independente. `flow promote` preserva a evidência ao converter o trabalho em uma change normal, sem `--force`. ### Changed - **Keep Core agora é explicitamente inegociável e sempre ativo.** Vault, identidade, sessões, CORE, SHARED_MEMORY, lessons e persistência continuam funcionando em todos os perfis; apenas o Wend Runtime de governança é desligado em `OFF`. Hooks, skills, `init` e `sync` respeitam a mesma fronteira, e instalações novas começam em `GOVERN`. - **Artefatos de runtime FLOW vivem em `.brain/runtime/flows/`.** A fronteira arquitetural impede dependências do Vault para o harness/perfil e mantém aberta uma modularização física posterior em `cli`, `harness`, `vault`, `mcp`, `integration` e `pi`. ### Fixed - **Retries concorrentes do mesmo evento de memória convergem durante a publicação.** O perdedor do `open(..., 'wx')` tolera por uma janela limitada apenas o JSON ainda parcial do produtor vencedor, revalidando a fronteira física do Vault a cada leitura; payload diferente, arquivo permanentemente ilegível e aliases inseguros continuam falhando fechado. Fixtures de CLI também isolam `WENDKEEP_SENSOR_VAULT`, permitindo que a suíte rode dentro do próprio `verify --vault`. - **Handoffs sequenciais da mesma ativação respeitam causalidade.** Um turno mais novo da mesma sessão/ativação substitui o anterior em vez de abrir conflito; ativações realmente distintas continuam exigindo resolução humana. - **Todas as tags de sensor de uma tarefa entram no gate.** `verify` não descarta mais tags `[sensor:]` adicionais na mesma linha: IDs distintos executam uma vez, na ordem declarada, e o primeiro continua disponível como alias legado para consumidores antigos. - **Reconciliação de memória separa reparo estrutural de decisão semântica.** O novo `memory reconcile` é dry-run por padrão, reprojeta o ledger sem consumir outbox, distingue cursor físico de ordem causal e usa os mesmos invariantes do CORE no projector e no health check. `verify` e `flow finish` agora executam sensores contra o Vault efetivamente selecionado. `memory repair` reconhece e migra por CAS checkpoints causais válidos pré-0.59, com backup/auditoria, enquanto locks owner-aware por PID/token impedem reap de processos vivos e remoção ABA. - **Iterações truncadas preservam Markdown válido.** Backticks inline ou fences cortados pelo limite de tamanho são escapados antes da escrita e não engolem mais a linha seguinte. - **`sync` preserva seu estágio de reparo sem reabrir fallback global.** A CLI não tenta resolver o Vault antes do `init`; binding inválido falha fechado nessa primeira etapa, e apenas o vínculo validado é repassado a `sync-defs` e `doctor`. ### Security - **FLOW falha fechado fora do contrato.** Escapes da allowlist, superfícies protegidas, mudança de configuração de sensores, metadata/flags ocultas do Git, sensores críticos vermelhos ou mutantes, symlink/junction/reparse/hardlink, submodules e superfícies ignoradas bloqueiam o recibo. ProjectRoot/sensor cwd ficam congelados e um snapshot terminal fecha a janela após os sensores. Raízes adicionais podem ser declaradas por `harness.flow.protectedRoots`; uma política canônica gera classifier, discovery e topologia. Escritas/locks do Vault falham antes de escapar, usando owner+lease sem reap de processo vivo ou liberação ABA. Uma descoberta no-follow limitada inclui aliases protegidos vazios/ignorados sem entrar no Vault, `.git` ou caches. Promoção cross-process elege um dono, vincula semanticamente contrato/reserva/recibo/origem, preflighta destinos multi-spec e permite ao perdedor repetir com `--change-slug`. IDs não atravessam o runtime root, artefatos corrompidos nunca reabrem o FLOW, não existe `--force`, e promoção nunca toma outra change ou repositório. Ledger, outbox, CORE/SHARED, registry, notas, sidecars, temporários e backups também falham fechados em aliases físicos ou hardlinks externos. - **Supersession ambígua exige autorização auditável e CAS exato.** A aplicação nomeia a sessão sucessora e o motivo, prova que cada evento pertence à identidade causal nomeada, rejeita flags ambíguas antes de I/O, limita a mutação às duas sessões, preserva o attempt original e cria backup exato do registry antes da troca. - **Binding ilegível não desliga governança silenciosamente.** Hooks mutantes falham fechados; quando um Vault explícito ou legado é inequívoco, Keep Core continua injetado sob fallback `GOVERN` junto do diagnóstico de corrupção. Config legada mais próxima inválida, shape tipado incorreto, marcador ausente ou identidade divergente não herdam Vault pai/global; `profile` expõe `binding_error` e rejeita flags duplicadas/ambíguas antes de I/O. O guard cobre caixa, shims locais, entrypoint Node e paths/call operator de Git nos gates force/no-verify. ## [0.58.3] — 2026-07-26 ### Fixed - **O primeiro `SessionStop` elegível após a migração legacy → v2 volta a publicar o handoff.** A activation passa a representar um epoch com múltiplos Stops, e `UserPromptSubmit` recupera uma única activation ausente sob lock. Identidade nativa de sessão/turno e a ordem física do transcript impedem que Stops duplicados, atrasados ou de uma activation anterior publiquem de novo ou sobrescrevam checkpoints mais recentes. - **A publicação de memória ficou durável e observável de ponta a ponta.** O evento é enfileirado antes de registrar `enqueued`, a projeção ocorre fora do lock e retries reutilizam a tentativa congelada. Falhas preservam a outbox como `degraded`, enquanto retornos ambíguos deixam evidência diagnóstica em vez de encerrar silenciosamente. - **`wendkeep doctor` agora detecta memória v2 realmente estagnada sem acusar uma migração nova.** O diagnóstico correlaciona tentativa, ledger, outbox, revisão e checkpoint; revision 0 logo após uma migração válida continua saudável, mas perda causal, ambiguidade e divergência bloqueiam. ### Changed - **Os guias bilíngues de memória, sessões, migração e diagnóstico descrevem o lifecycle real.** A documentação cobre epochs multi-Stop, recuperação única, retries idempotentes, estados `enqueued|projected|degraded|ambiguous` e como interpretar revision 0. ### Security - **Fixtures persistíveis de lifecycle são integralmente sintéticas.** Um gate de privacidade verifica arquivos rastreados e novos e reporta somente arquivo, linha e categoria, evitando que caminhos ou identificadores locais entrem em testes, commits e artefatos. ## [0.58.2] — 2026-07-26 ### Added - **Referência completa dos comandos agora é bilíngue e orientada por tarefa.** Sete guias por domínio e três guias profundos cobrem instalação, changes, verificação, memória, sessões, importação, notas, custos e manutenção em PT-BR e inglês, com sintaxe, exits, exemplos, resultados esperados e diagnóstico. - **Paridade documental virou gate automatizado.** O novo sensor `docs-bilingual` bloqueia pares ausentes, comandos públicos sem cobertura, links quebrados, estrutura divergente, drift da regra local e guias ausentes no tarball. ### Changed - **Os READMEs agora apresentam as funcionalidades por grupos.** A referência extensa deu lugar a um mapa navegável que leva ao guia correto no GitHub e no npm. O fluxo de `verify` deixa explícito que exit 2 por ausência de change é contexto ocioso, não falha de saúde do projeto. ## [0.58.1] — 2026-07-26 ### Fixed - **Vaults com `SHARED_MEMORY.md` legado voltam a atualizar sem bloquear o doctor.** `init` e `sync` ainda preservam todos os bytes existentes e podem criar os sidecars v2 ausentes, mas sidecars vazios não ativam a memória v2. `memory status --gate` reporta o estado `legacy` como aviso não bloqueante e `brain-inject` mantém CORE+DIGEST durante a janela de compatibilidade. - **`SessionStop` não migra memória implicitamente.** Enquanto o vault permanecer legado, o Stop não grava outbox, ledger, candidates nem reescreve SHARED. A transição acontece somente com `wendkeep memory migrate --apply`; conteúdo com assinatura/evidência v2 corrompida continua visível e bloqueante, sem fallback silencioso. ## [0.58.0] — 2026-07-26 ### Added - **Shared Project Memory v2 torna o handoff entre agentes causal, auditável e diretamente injetável.** O `SessionStop` publica eventos locais imutáveis numa outbox, o projector serializa o ledger `MEMORY_EVENTS.jsonl` e gera `SHARED_MEMORY.md`; o próximo `startup|clear|compact` recebe CORE + SHARED completos antes do contexto da change. Epochs de activation impedem um Stop atrasado de fechar ou promover sobre uma sessão mais nova. - **Curadoria operacional ganhou comandos e gate próprios.** `wendkeep memory` oferece `status`, migração dry-run/apply com backup, `repair` e decisões append-only de `promote|reject`; `memory-health` bloqueia verify/archive em corrupção, lag ou conflito ativo e mantém outbox/candidates comuns como avisos recuperáveis. ### Security - **Memória v2 permanece local-only e sanitizada em duas fronteiras.** Secrets, tokens, PII, paths de transcript e payloads do harness são removidos antes da persistência e novamente antes da injeção; eventos são isolados por `project_id`, CORE/SHARED nunca são truncados silenciosamente e o envelope total possui budget rígido de 24 KiB. ## [0.57.2] — 2026-07-25 ### Fixed - **O README deixa de recomendar um `pnpm add` que não atualiza.** A seção "Atualizar" mandava rodar `pnpm add -D -w wendkeep@latest`. Medido num projeto pnpm limpo, sem configuração alguma: o comando devolveu `+ wendkeep 0.49.0 (0.57.1 is available)` e saiu 0. O `minimumReleaseAge` de 24h é **default do pnpm 11**, não config do projeto, e ele não recusa o pacote recente — instala o anterior em silêncio, com o `(X.Y.Z is available)` como única pista. Quem seguia o README ficava na versão velha achando que tinha atualizado. O bloco pnpm passa a mostrar a versão exata com `--config.minimumReleaseAge=0`, e o `@latest` aparece como armadilha nomeada. A nota também corrige quem escreve a exceção: o `minimumReleaseAgeExclude` do `pnpm-workspace.yaml` é **manual** — o pnpm não escreve essa linha, e sem ela o `pnpm install` do CI falha com `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION` até a versão completar 24h. Vale nos dois idiomas. ## [0.57.1] — 2026-07-25 ### Fixed - **A troca de README no empacotamento resiste a falha transitória de arquivo.** O CI ficou vermelho em **windows-latest + node 22** (só nessa matriz — Windows 18/20 e as três de Ubuntu passaram): o `postpack` não restaurou e o repositório ficou com o inglês em `README.md`. É uma operação de arquivo falhando enquanto outro processo segura o handle, a mesma classe do `rmSync` já conhecida neste projeto. A restauração passa a tentar `rename` e, falhando, `copyFile` + `unlink`, com algumas tentativas curtas; esgotadas, **falha ruidosamente** com `git checkout README.md` em vez de deixar a árvore trocada em silêncio — o estado ruim aqui é o repositório de quem publica, e ele só descobriria estranhando um `git status`. O teste de empacotamento passa a restaurar a árvore no `finally`: continua detectando a falha pela asserção, mas deixa de ser ele próprio a causa de um repositório sujo. ## [0.57.0] — 2026-07-25 ### Fixed - **`wendkeep sync` deixa de mascarar o `defs stale`.** O comando chamava `sync-defs` **sem** `--reseed`: copiava o conteúdo da versão anterior de `.brain/skills` para os destinos **e** carimbava a versão nova no `.wendkeep-meta.json`. Como o `checkSyncDefs` compara destino × `.brain` e `meta.wendkeepVersion` × versão instalada, os dois passavam a bater e o `doctor` parava de acusar `defs stale` **sem que uma única skill fosse atualizada** — pior que não fazer nada, porque o aviso que apontava o problema real desaparecia. O `sync` agora ressemeia: as `wk-*` são artefato do pacote, e trazer os seeds da versão instalada é o trabalho dele. Se você editou uma `wk-*` à mão, a edição é sobrescrita — customização própria pertence a uma skill sua, que o reseed não toca. Capability `cli-safety` (CLI-SYNC-1). - **O comando de atualização documentado abria um seletor interativo.** `wendkeep sync --project` sem `--yes` cai no picker de companions a cada atualização; e `--project` sem valor funcionava por acaso, contradizendo a assinatura `[--project P]` da própria tabela. Os dois READMEs passam a mostrar `--project . --yes`. ## [0.56.0] — 2026-07-25 ### Changed - **O README do GitHub passa a ser o português.** `README.md` é o português (o que a página do projeto exibe) e `README.en.md` o inglês, cada um linkando o outro. O `README.pt-BR.md` deixa de existir — manter os dois nomes seria convidá-los a divergir. - **O npm continua em inglês.** A página do pacote sempre renderiza o `README.md` do tarball, e não há campo em `package.json` que aponte para outro arquivo; sem tratamento, inverter no repositório mudaria também a vitrine para o público global. Hooks `prepack`/`postpack` trocam os dois no empacotamento, cobrindo `npm publish` e `npm pack` — o teste confere o **conteúdo do tarball**, não os arquivos do repositório, que é justamente onde os dois divergem de propósito. Capability `cli-safety` (CLI-PKG-1). ### Fixed - **Os dois READMEs estavam atrás do código.** Nenhum documentava `wendkeep sync`, `note repair-frontmatter`, `note repair-sections` nem as quatro seções de diagnóstico do `doctor`; o português também não tinha `theme sync` nem `note relink`, e `change backlink` faltava nos dois. Uma auditoria contra o CLI achou ainda quatro flags que existem no código e não estavam documentadas: `verify --project`, `sensors --project`, `lesson --change/--vault` e `continue --simple`. A seção de atualização prescrevia a receita manual de quatro comandos que o `sync` substitui, e agora cobre npm **e** pnpm — inclusive o cooldown que faz o comando de npm falhar num monorepo pnpm. ## [0.55.0] — 2026-07-25 ### Fixed - **O `[derivadas]` do doctor deixa de acusar nota já correta.** O `doctor` reportava `5 link(s) faltando` numa nota onde os cinco estavam presentes; o `note repair-sections --apply` rodava, não mudava nada (`unchanged`), e o doctor voltava a acusar — um vermelho que nenhum reparo fechava. Causa: detector e reparador localizavam a seção por critérios diferentes — `## ` como substring solta contra `\n## \n` ancorado. Numa nota de sessão isso é fatal, porque ela transcreve a conversa, e uma conversa **sobre** as seções cita os nomes delas: o detector casava a menção em prosa e lia o texto errado. Agora existe um localizador único (`findSectionBounds`) por onde detector e reparo obrigatoriamente passam — corrigir apenas o marcador deixaria dois localizadores independentes, que foi como o bug nasceu. Capability `vault-doctor` (DIAG-7). ## [0.54.0] — 2026-07-25 ### Added - **`wendkeep sync [--project P]`** — roda `init` → `sync-defs` → `doctor` no **projeto corrente**, num comando só. São os três passos que se repetem idênticos depois de cada atualização do pacote; repetir à mão convida a esquecer o `sync-defs`, e aí as skills `wk-*` ficam na versão anterior enquanto o pacote já é o novo. Para no primeiro passo que falha. O `npm install` fica **fora** de propósito: um processo não se auto-substitui e continua rodando, e é o passo que mais varia entre projetos (npm/pnpm/workspace/cooldown). O comando opera onde é invocado, nunca sobre uma lista de repositórios — o wendkeep é um pacote público. Capability `cli-safety` (CLI-SYNC-1). ### Fixed - **`sync` blinda contra o *env bleed*.** O vault é re-resolvido com `resolveProjectVault` **depois** do `init` (que pode tê-lo acabado de criar) e repassado explícito aos passos seguintes. Sem isso, `sync-defs` cairia em `OBSIDIAN_VAULT_PATH` e, num projeto novo, o env global da máquina levaria as skills para o vault de outro projeto. Capability `project-vault-routing` (PVR-SYNC-1). ### Changed - **`runSyncDefs` e `runDoctor` devolvem o código de saída** em vez de chamar `process.exit`; quem sai é o `bin`. Ambos saíam incondicionalmente, o que matava o processo no segundo passo de qualquer encadeamento. Os códigos de saída observáveis de `wendkeep doctor` e `wendkeep sync-defs` não mudaram. Capability `cli-safety` (CLI-SYNC-2). ## [0.53.0] — 2026-07-25 ### Fixed - **As seções derivadas do corpo refletem a sessão inteira.** O `## Encerramento` listava 15 decisões e 5 aprendizados enquanto o corpo da nota mostrava 3 decisões e *"Nenhum aprendizado registrado ainda."* — medido num vault real. A causa é ausência de escrita: os placeholders nascem no template e, depois disso, só `decision-capture` escrevia — e apenas ADRs capturados via `AskUserQuestion`. As seções de **Bugs e Aprendizados nunca tiveram writer nenhum**. O dado certo já estava no lugar certo e era descartado: `finalizeSessionFile` recebe a lista mesclada (capturados + varredura) e usava só para o Encerramento; agora as três seções saem do mesmo objeto, na mesma passada. - **A proveniência declarada manda na atribuição.** `noteReferencesSession` casava substring no arquivo inteiro, então uma derivada que citava outra sessão em `related:` era atribuída às duas — caso real: um BUG com `session:` de uma sessão e `source:` de outra ia para ambas. Agora `source:` decide quando existe; sem ele (nota legada) qualquer referência ainda vale, preservando DRV-5. Capability `derived-notes` (DRV-10, DRV-12). ### Added - **`wendkeep note repair-sections [--apply] [--json]`** — reconstrói as seções derivadas das notas já fechadas, que não se corrigem sozinhas (o fecho só roda em sessão que ainda fecha). Lê as derivadas uma vez e indexa por sessão (O(N+M), não O(N·M)); dry-run por padrão; grava sob o mesmo lock dos hooks. Descarta o placeholder em qualquer variante, **preserva prosa** escrita na seção, e é no-op em nota que não tem os headings. Capability `derived-notes` (DRV-11). - **`wendkeep doctor` surfaça seções derivadas desatualizadas.** Nova seção `[derivadas]` com as notas afetadas, quantos links faltam e o comando de reparo. Só falta conta como sintoma — link a mais pode ser curadoria do dono do vault. Capability `vault-doctor` (DIAG-6). ## [0.52.0] — 2026-07-25 ### Fixed - **`claude-opus-5` e `claude-mythos-5` deixam de custar $0.** Modelo ausente de `hooks/pricing.json` faz `priceForModel` devolver `null` e a parcela dele do custo virar zero — sem erro, sem aviso, sem nada no `doctor`. Num vault real: `claude-opus-5 $0.0000` no `wendkeep cost`, enquanto Opus 4.8 e Fable 5 somavam $462. Adicionados com os preços de API: Opus 5 a $5 input / $0,50 cache read / $25 output (mesmo tier do Opus 4.8) e Mythos 5 a $10 / $1 / $50 (mesmo tier do Fable 5), com os aliases das variantes de id. Notas já fechadas com custo zerado se corrigem com `wendkeep cost rebuild`. ### Added - **`wendkeep doctor` surfaça modelos sem preço.** Nova seção `[preços]`: lista os modelos que aparecem nas notas de sessão com uso registrado mas sem entrada na tabela, e aponta `hooks/pricing.json`. Cada modelo citado é consultado direto em `priceForModel` — **não** se infere pelo sintoma "custo zerado", que não funciona: na nota que motivou a correção, `modelo: "claude-opus-4.8 + claude-fable-5 + claude-opus-5"` fecha com **$415** porque os dois primeiros têm preço, e só a fatia do Opus 5 está zerada. Um detector por custo zero passaria batido justamente no caso real. Capability `session-observability` (OBS-9, OBS-10). ## [0.51.0] — 2026-07-25 ### Added - **`wendkeep note repair-frontmatter [--apply]` — conserta as notas de sessão empilhadas.** A 0.50.0 fechou a causa (lock + escrita atômica) e ensinou o `doctor` a **apontar** as notas danificadas, mas não havia comando para consertá-las — a única checagem do doctor sem conserto ao lado. O reparo funde os blocos num só sem perder nada: as chaves-base vêm do bloco original (o de baixo, o único que as tem) e os valores gerenciados do bloco mais recente (o do topo, último prepend). O merge opera sobre o texto bruto de cada chave, sem reserializar YAML, então listas aninhadas atravessam byte-a-byte. Dry-run por padrão como o `note relink`; `--apply` grava pelo mesmo lock dos hooks. Antes de gravar valida que o resultado tem um bloco só, que nenhuma chave sumiu e que o corpo sobreviveu — falhando qualquer uma, pula e reporta. O `doctor` agora imprime `→ wendkeep note repair-frontmatter --apply` quando a contagem é > 0. Capability `session-observability` (OBS-7, OBS-8) e `vault-doctor` (DIAG-5). ## [0.50.0] — 2026-07-23 ### Fixed - **Nota de sessão não empilha mais frontmatter.** Uma nota real fechou com 4 blocos de frontmatter no topo: o Obsidian só parseia o primeiro, então `type`/`date`/`provider`/ `status`/`tags`/`source` sumiram do painel de propriedades e os outros 3 blocos viraram texto do corpo. Duas falhas somadas: (1) `upsertSessionFrontmatter` **prependava** um frontmatter novo quando o regex não casava — numa nota existente isso nunca é "faltou frontmatter", é conteúdo truncado; (2) os escritores da nota faziam read-modify-write com `writeFileSync` cru, sem lock. Como `subagent-stop` dispara uma vez por subagent (a sessão danificada teve 46), um hook lia o arquivo já truncado por outro e caía no prepend. Agora todo hook que reescreve a nota (`token-usage`, `subagent-usage`, `session-observability`, `session-stop`, `session-ensure`, `decision-capture`, `task-log`) grava por `mutateSessionNote`: lock por `mkdir` + escrita atômica (`tmp` + `rename`), e frontmatter ilegível **aborta** a gravação em vez de prependar. Um teste-guarda estrutural impede que um escritor novo volte ao `writeFileSync` cru. Capability `session-observability` (OBS-5, OBS-6). - **Lock liberado em caminho acentuado.** `fs.rmSync(dir, { recursive: true, force: true })` é um **no-op silencioso** no Windows (Node 24) quando o caminho contém caractere não-ASCII — não remove e não lança (medido: 20/20 falhas em `02-Sessões`, `ação`, `Mudanças`; 0/20 em ASCII). Como toda nota de sessão vive sob `02-Sessões/`, o lock ficava preso e o segundo escritor desistia — perda silenciosa de turnos. A liberação passa a usar `rmdirSync`. O mesmo defeito estava latente no lock do `SESSION_REGISTRY.json`, que travaria após a primeira mutação num vault sob pasta acentuada. ### Added - **`wendkeep doctor` surfaça notas de sessão com frontmatter empilhado.** Nova seção `[notas]`: conta e lista as notas danificadas pela escrita concorrente (versões anteriores a esta); quando não há nenhuma, diz `frontmatter íntegro`. `---` no corpo (regra horizontal, separador de tabela) não é falso positivo. Capability `vault-doctor` (DIAG-5). ## [0.49.0] — 2026-07-23 ### Added - **`wendkeep doctor` agora surfaça os órfãos do grafo com o comando de reparo.** Nova seção `[links]`: conta notas derivadas sem sessão-fonte (→ `note relink`), artefatos de change sem backlink (→ `change backlink`) e o estado das cores do grafo (→ `theme sync`); quando tudo conectado, diz `grafo conectado`. Reusa as funções de reparo em dry-run — zero lógica nova de detecção. Antes o dono do vault só descobria os órfãos olhando o grafo no Obsidian e não sabia qual comando rodava. - **Sessão não mente "inativa" com atividade recente.** Nova seção `[sessão]`: quando o control marca `inactive` mas a nota da sessão foi escrita há pouco, o doctor sinaliza possível workflow/subagente em segundo plano — o control só reflete o lifecycle da sessão-mãe, não a atividade de background. Capability `vault-doctor` (DIAG-1..4). ## [0.48.0] — 2026-07-23 ### Added - **`wendkeep note relink [--apply]` — backfill de proveniência das notas derivadas órfãs.** BUG/APR legadas (criadas por versão antiga, sem `source:` de sessão) ficam ilhas no grafo — num vault real: 13 de 15 BUG e 3 de 8 APR sem nenhum link de entrada nem de saída. A origem não está registrada no órfão, mas os irmãos não-órfãos do mesmo tipo carregam a sessão-fonte real. O comando liga cada órfão herdando a sessão **modal** (mais comum) dos irmãos do mesmo tipo e mês, injetando `source:` + `related:` no frontmatter. Dry-run por default; `--apply` escreve; idempotente; pula e reporta o órfão sem nenhum irmão-fonte pra inferir (nunca chuta). Documentado em `derived-notes` (DRV-9). ## [0.47.0] — 2026-07-23 ### Added - **Grafo do vault conectado: todo artefato de change linka o hub.** `change new` gera `design.md` e `tarefas.md` com um backlink full-path pro `proposta.md` da própria change — antes nasciam sem nenhum wikilink, ilhas no grafo do Obsidian (num vault real: 48 de 63 `.md` de `08-Mudanças` órfãos). O full-path (nunca basename, ambíguo entre changes) sobrevive ao archive: o `rewriteChangeLinks` retargeta pro `_arquivo` junto com os demais links. - **Auto-heal do backlink em `spec.md`.** O delta de spec é escrito à mão, então `verify` e `archive` passam a injetar o backlink pro proposta em cada `specs//spec.md` que estiver sem — idempotente. Nenhum artefato de change fica desconectado do plano↔sessão. - **`wendkeep change backlink [--apply]`** — backfill dos artefatos órfãos que já existem no vault (changes open e arquivadas), apontando cada `design`/`tarefas`/`spec` pro proposta no seu local atual. Dry-run por default; `--apply` escreve. Idempotente. - **`wendkeep theme sync`** — re-aplica o color system (snippet CSS + graph color groups) num vault existente, sem re-`init`. Recupera o grafo que ficou cinza quando o Obsidian (dono do `graph.json`) zera os `colorGroups`. O instalador virou módulo compartilhado com o `init`, então os dois nunca divergem. - **Snippet define `--file-line-width`.** O CSS gerado passa a definir a largura de linha legível (1400px, ajustável) sobre o `body` com `!important` — antes era edição manual em cada vault. As capabilities `change-graph` e `vault-theme` documentam o contrato em `07-Specs`. ## [0.46.2] — 2026-07-19 ### Fixed - **Rollout de subagent do Codex virava sessão top-level no import.** Um subagent do Codex não é um arquivo em `/subagents/` — é um rollout **irmão** no `~/.codex/sessions/`, cujo `session_meta` declara `source.subagent` e aponta pro pai via `parent_thread_id`. O import ignorava o marcador e materializava o subagent como uma "sessão" própria, com o contexto do pai inteiro replicado (subagent herda o histórico) — no caso real, uma nota fantasma de 23 turnos duplicando a conversa da sessão-mãe. Agora a descoberta expõe o marcador, o import conta subagents à parte no relatório (nunca em `skipped`) e nenhuma nota é criada. A entrada de registry que o import antigo escreveu para um subagent é removida — self-healing do nosso próprio dado errado, nunca limpeza genérica: entrada com o mesmo id mas transcript diferente é preservada. - **Telemetria de subagent do Codex nunca chegava à sessão-mãe — nem ao vivo.** A descoberta (`collectSubagentUsage`) era Claude-shaped: procurava um diretório `subagents/` ao lado do transcript, que no Codex não existe. Resultado: toda sessão Codex fechava com `subagents_count: 0`, tanto no import quanto no hook vivo `SubagentStop` wirado na 0.46.0 — o custo dos subagents simplesmente não existia no vault. A nova `collectCodexSubagentUsage` acha os irmãos por `parent_thread_id` (no dia do rollout pai e no dia seguinte, cobrindo spawn que cruza a meia-noite UTC — o caso real passou a seis minutos disso) e devolve o mesmo agregado que o writer já consome: vivo e import passam a atribuir pelo mesmo caminho. - **O bloco injetado ainda aparecia como fala do usuário no "Contexto conversado".** O fix da 0.46.1 protegeu o título, mas a linha `**Usuário:**` da iteração vinha de um segundo filtro (`shouldIgnoreUserText`) que duplicava por cópia a lista do `isBootstrapPrompt` — e as cópias divergiram. O filtro agora delega: um lugar só para o próximo bloco que o harness inventar. - Bytes NUL literais em `hooks/token-usage.mjs` e `hooks/subagent-usage.mjs` escapados — mesma classe do fix de `taxonomy.mjs` (#7): o byte cru fazia o `file` classificar o fonte como binário e o ripgrep pulá-lo em silêncio. Entrou `tests/source-hygiene.test.mjs` barrando byte de controle em qualquer fonte publicado; ele pegou uma quarta ocorrência introduzida durante esta própria mudança. ## [0.46.1] — 2026-07-19 ### Fixed - **Turnos do Codex sumiam da nota sem nenhum aviso.** No Windows o Codex serializa o payload do `Stop` com o campo `last_assistant_message` cortado no meio, sem fechar a string JSON — bug upstream ainda aberto ([openai/codex#23784](https://github.com/openai/codex/issues/23784)). Sessão em português enche esse campo de acento, então o corte é frequente. O `readHookInput` fazia `JSON.parse` cru, lançava, e o `session-stop` saía com código 0 escrevendo só no stderr — que o Codex descarta. Resultado: a nota era criada, o summary atualizava a cada prompt, e nenhuma iteração jamais entrava. Só o `Stop` quebrava porque `last_assistant_message` é o único campo exclusivo dele; `SessionStart` e `UserPromptSubmit` não o carregam. Como esse campo é o **último** do `StopCommandInput`, tudo que o wendkeep consome (`session_id`, `turn_id`, `transcript_path`, `cwd`) está no prefixo bem-formado. O `readHookInput` passa a recuperar esse prefixo numa passada só, descartando o campo truncado — nunca reconstruindo-o, porque metade de uma mensagem é dado inventado. - **O hook parou de falhar em silêncio.** Todo caminho de bail do `session-stop` agora emite `systemMessage`, que a UI do Codex mostra, com o motivo e o comando de recuperação. O exit code continua 0 de propósito: hook de `Stop` que sai diferente de zero trava o turno (openai/codex#21921), e trocar turno perdido por sessão travada é pior negócio. - **`resolveSessionIdentity` passa a usar o `SESSION_REGISTRY` como fonte do `transcript_path`** quando o payload não o traz. O registry já tinha o mapeamento; o lookup é que ficava abaixo do gate, inalcançável justo no caso que resolveria. A entrada precisa ser do mesmo provider, o que preserva o invariante do incidente de contaminação cross-provider de 2026-07-11. - **`wendkeep import` deixou de ser cego para a sessão danificada.** O dedup perguntava "existe registro?", não "existe conteúdo?" — e como o `session-start` registra antes do `session-stop` escrever, **as sessões esvaziadas pelo bug acima eram exatamente as que o comando de recuperação se recusava a consertar.** Agora a decisão compara os turnos do transcript com os marcadores `wk-turn` já na nota: cobertura completa pula, parcial ou vazia completa a nota existente sem criar uma segunda. Sem flag opt-in — quem roda `import` depois de perder sessão não tem como saber que precisaria de uma. O relatório ganhou a categoria `repaired`, separada de `imported` (nota nova) e de `skipped` (já completa). - **Sessões importadas ganhavam título de bloco injetado pelo harness.** Seis notas de um mesmo projeto ficaram chamadas ` Here is a list of plugins that ar`, no frontmatter e no nome do arquivo. Causa de uma linha: `buildIterationBlock` seleciona `userPrompts.at(-1)` e o `deriveSummary` usava `.find(Boolean)` — o harness injeta o bloco como **primeiro** prompt do turno e o pedido do usuário vem por **último**. Mesmo dado, ponta oposta. As duas seleções agora são a mesma, com `isBootstrapPrompt` (que passou a reconhecer ``) como rede, aplicado ao prompt inteiro e não linha a linha — filtrar por linha cairia na linha seguinte do próprio bloco injetado. ### Recuperação - Quem perdeu turnos de sessões Codex antes desta versão recupera com `wendkeep import --source codex`. O rollout do Codex fica íntegro em disco, e o import agora completa a nota existente em vez de pulá-la. Rodar mais de uma vez é no-op. - Notas já criadas com título poluído **não** são renomeadas automaticamente: mexer em nome de arquivo quebra wikilink e reorganiza o grafo, e isso é decisão do dono do vault. ## [0.46.0] — 2026-07-18 ### Added - `wendkeep init` agora escreve também `/.codex/hooks.json`, e não só `.claude/settings.json`. Fechava aqui o buraco mais confuso do onboarding com Codex: o `.mcp.json` gerado deixava o vault **alcançável**, então tudo parecia certo — mas sem hooks não havia sessão, `CURRENT_SESSION.md` nunca aparecia e o `registrySessions` ficava em 0. As saídas eram escrever o `.codex/hooks.json` à mão ou rodar `wendkeep import --source codex` depois do fato, ambas descobertas tarde demais. Um projeto novo com Codex nasce com sessão. - Sete hooks wirados, marcados `codex: true` em `src/taxonomy.mjs`: `brain-inject` (SessionStart, matcher `startup|clear|compact`), `session-start` (SessionStart, `startup`), `session-ensure` e `change-context` (UserPromptSubmit, sem matcher), `session-stop` e `change-nag` (Stop, sem matcher) e `subagent-stop` (SubagentStop). - Cinco hooks ficaram **deliberadamente de fora**, cada um com um comentário `// codex:` no `src/taxonomy.mjs` explicando o porquê — projetar um hook que não funciona é pior que não projetá-lo. `change-guard` lê `tool_input.command`, mas a superfície de shell do Codex é `exec` (`custom_tool_call`, com `tool_input` string crua) ou `exec_command`/`shell_command`: o guard falharia **aberto**, dando uma sensação de proteção que não existe. `change-warn` lê `tool_input.file_path`, e o `apply_patch` do Codex manda um envelope de patch sem esse campo. `plan-capture` não tem equivalente — `update_plan` é a lista de TODO corrente e dispara no meio do turno, não no fim do plano. `decision-capture` depende de `AskUserQuestion`, uma ferramenta exclusiva do Claude. E `task-log` depende de `TaskCompleted`, que não existe no enum de eventos de hook do Codex. - A projeção Codex tem três diferenças em relação ao formato do `settings.json`, todas **silenciosas quando erradas** — daí valerem registro. (1) A chave de timeout é `timeoutSec`, não `timeout`. (2) O comando é sempre `npx --no-install wendkeep hook `, nunca a forma node-direta: aquela emite `${CLAUDE_PROJECT_DIR}`, que não existe no Codex, então a flag `preferLocal` é ignorada de propósito na projeção. (3) As chaves de evento são PascalCase — o snake_case que se vê em `[hooks.state]` no `~/.codex/config.toml` é o rótulo interno do evento, não a chave do JSON. - Merge não-destrutivo, mesma disciplina do `mergeSettings`: reconhece um grupo já wirado e nunca duplica em re-`init`, preserva hooks de terceiros e hooks irmãos agrupados junto, `--force` atualiza `timeoutSec`/`statusMessage` no lugar, e um `.bak` é salvo. Arquivo existente ilegível não é tocado — a proposta vai para `.codex/hooks.json.new`. - Testes: `tests/init-codex-hooks.test.mjs` (12 unitários sobre `mergeCodexHooks`) e um e2e em `tests/init-vault.test.mjs`. Suíte completa: 397 passando. ### Fixed - Hooks Codex do wendkeep rodavam com o timeout **default de 600s**, não com o configurado. A chave correta é `timeoutSec`; `timeout` não é campo, não é rejeitado e simplesmente não é lido, então o valor caía no default sem um único aviso. Todo `.codex/hooks.json` escrito à mão antes disso (o do NutriGym, entre outros) carrega o erro. `mergeCodexHooks` migra a chave legada in place, **mesmo sem `--force`** — é correção de bug, não refresh opcional. - `src/taxonomy.mjs` carregava um NUL (`0x00`) e um `0x1f` **literais** dentro da classe de caracteres do `deriveVaultDirName`. Por causa do NUL o `file` classificava o fonte como binário, e o ripgrep pula binário por default — um Grep por qualquer termo no arquivo voltava vazio, em silêncio. Não era erro, era ausência de resultado, e justo no arquivo onde vivem os specs de hook e as constantes de companion. Os dois bytes viraram as sequências de escape `\x00` e `\x1f`; o regex é byte-idêntico em comportamento (#7). ### Changed - A numeração dos passos do `init` foi de `[n/4]` para `[n/5]`. O novo passo 3 é o `.codex/hooks.json`, então `.mcp.json` passou a ser `[4/5]` e as cores `[5/5]`. ### Migration - **Quem já tem hooks Codex do wendkeep vai ver um prompt "Hooks need review" a mais neste upgrade.** Isso é esperado, não regressão: a identidade do hook é hasheada, e corrigir `timeout` → `timeoutSec` muda o conteúdo, logo muda o hash, logo o Codex pede re-aprovação. Uma vez só. - Independente disso, todo hook nasce Untrusted: o Codex enumera mas **não executa** até o usuário aprovar no prompt de startup. O `init` não tem como pré-aprovar — `--dangerously-bypass-hook-trust` é por invocação e não persiste `trusted_hash` — então passou a imprimir um aviso explicando o prompt em vez de deixar o usuário achar que o wiring falhou. - O `init` **não** escreve `[features] hooks = true` no `.codex/config.toml`, de propósito. O Codex declara essa feature como `Stage::Stable` com `default_enabled: true`, então a linha seria no-op — e a camada de config do projeto é trust-gated como um todo de qualquer forma. ## [0.45.1] — 2026-07-18 ### Fixed - Documentação: 31 inconsistências entre os READMEs e o comportamento real do pacote, encontradas auditando o texto contra o tarball publicado da 0.45.0. Nenhuma mudança de código — `src/`, `hooks/`, `bin/` e `schema/` são idênticos aos da 0.45.0. Este release existe porque o README viaja dentro do tarball: a correção só chega à página do npm e a quem instala o pacote com uma nova publicação. - Duas afirmações levavam o usuário a um resultado diferente do prometido: o README dizia que `context-mode` vinha pré-marcado no picker de companions e que `init --yes` o instalava (todo companion é `default: false` desde a 0.24.0, e `--yes` instala zero), e as seções de requisitos/init sugeriam captura de sessões Codex automática após o `init`, contradizendo o próprio Notes & roadmap (o `init` só wira `.claude/settings.json`). - Tabela de Comandos reescrita a partir do `--help` do binário: faltavam `stats` (usado na própria introdução do README), `dashboard`, `change use|continue|abandon|relink`, `cost --top|--trend|--write`, `import --stamp-ids|--rescan-decisions`, `verify --change`, `spec rebase --accept-current`, `sensors add --name|--description` e `sync-defs --reseed`. Três linhas da tabela em inglês tinham ficado em português. - Correções factuais: `--force` dispensa só a checagem de tarefa aberta (G1), não o gate inteiro; `verdict.json` é exigido sempre desde a 0.31.0 (uma change sem `[req:]` destrava com o verdict trivial do `verify --deep`, não pulando a etapa); `change new` não scaffolda mais `specs/` e `--simple` pula o `design.md`; os sensores semeados são uma allow-list fixa mais `memory-validation`; `detectProvider()` não conhece Copilot; `context-mode` é plugin do Claude Code, sem entrada em `.mcp.json`; `brain-inject` roda em `startup|clear|compact`; as skills vão para `.claude/skills` e `.agents/skills`; `dotcontext` é `hidden`; `docs/` não vai no tarball; e uma tarefa carrega um só `[sensor:]` (`[req:]` é que aceita vários). - `README.pt-BR.md`: a tabela de comandos estava partida ao meio por um parágrafo, fazendo oito linhas renderizarem como texto cru no npm e no GitHub. Reparada e sincronizada com o inglês — os dois arquivos fecham com os mesmos 20 comandos e 42 flags. ## [0.45.0] — 2026-07-18 ### Fixed - Observabilidade: o note de sessão deixa de ser reescrito com timestamp novo a cada Stop quando o uso não muda. A preservação de `atualizado_em` (`token-usage.mjs`) comparava `previous` (parseado do note) com `current` (recém-computado) via `JSON.stringify` — sensível à ordem das chaves, que difere entre parse e build, então a comparação **sempre** falhava e o timestamp era re-stampado toda vez. Novo `sameUsageData(a, b)` compara os campos de uso de forma ordem-insensível (ignorando `atualizado_em`). Corrige o churn de reescrita e o teste flaky "same sources produce byte-identical markdown". ## [0.44.0] — 2026-07-17 ### Changed - `wendkeep change new` não cria mais o placeholder `specs/exemplo/spec.md` (nem a pasta `specs/`). Era ruído — sempre deletado à mão, e `discoverSpecDeltas` já o filtrava. Quando a change resolve `spec_impact: required`, o autor escreve `specs//spec.md` direto; o formato do delta vive na skill wk-workflow. O filtro de `exemplo` fica (compat com changes antigas em voo). - README gerado do `07-Specs` reescrito para explicar o ponto mais confundido: specs são **por capability, não por mudança** (N changes promovem no mesmo arquivo; o histórico por-change vive em `_arquivo`). `promoteSpecs` passa a garantir/atualizar esse README a cada archive (`ensureSpecsReadme`), então vaults existentes recebem o texto novo no próximo archive — não só os criados via `init`. ## [0.43.0] — 2026-07-17 ### Fixed - Dedup de nota derivada era assimétrico: aprendizado deduplicava recursivamente (vault inteiro), mas **bug e decisão só olhavam a pasta do mês** (`existingKeysForSession`, scan não-recursivo). Uma nota da sessão numa subpasta `DIA` legada não era vista, então um re-import/re-captura da mesma sessão criava uma duplicata de bug/decisão. Agora `existingKeysForSession` varre a pasta derivada recursivamente (como o de aprendizado), mantendo a semântica per-sessão (só notas que referenciam a sessão contam). ## [0.42.0] — 2026-07-17 ### Changed - `wendkeep renumber-decisions --apply` agora **move** as notas de subpastas `DIA N` para a pasta do mês da sua data (achatando o legado), consistente com `renumber-bugs`/ `renumber-learnings` do 0.41.0. Antes só renomeava in-place para `ADR-NNNN-` e deixava as pastas de dia intactas. Os wikilinks já eram reescritos vault-wide; agora acompanham o novo caminho de mês, e as pastas `DIA` que ficam vazias são removidas. Notas sem data resolvível preservam a pasta atual (nunca são perdidas). Idempotente. ## [0.41.0] — 2026-07-16 ### Added - Notas derivadas numeradas: bug e aprendizado gerados automaticamente nascem como `BUG-NNNN-.md` / `APR-NNNN-.md` na pasta do mês (nunca subpasta `DIA N`), com frontmatter `bug:`/`apr:` e H1 `# BUG-0001 — ` — paridade com o ADR de 04-Decisões. Numeração via `getNextDerivedNumber` (scan recursivo, max+1; `getNextAdrNumber` virou wrapper). - `wendkeep note new --type bug|learning ""`: cria a nota manual já numerada no path certo (respeitando locale), com backlink da sessão ativa, e imprime o path — o agente nunca calcula número nem pasta à mão. `--date YYYY-MM-DD` opcional. - `wendkeep renumber-bugs` e `wendkeep renumber-learnings`: migração retroativa — preview por default, `--apply` renomeia em ordem cronológica, MOVE notas de subpastas `DIA N` e da raiz para a pasta do mês, normaliza frontmatter/H1, reescreve wikilinks vault-wide (full-path e basename) e remove pastas `DIA` vazias. Idempotente. - Convenção injetada (VAULT_COMPLEMENT_RULES) e seeds wk-debugging (pt/en) ensinam a numeração, a regra sem-DIA e o uso de `wendkeep note new`. ### Fixed - `findLinkedDerivedNotes` (Stop hook) agora varre as pastas derivadas recursivamente — antes só enxergava notas na raiz de 04-Decisões/05-Bugs/06-Aprendizados, então notas nas subpastas de mês nunca entravam no merge de wikilinks da sessão. ### Migration - Para migrar vaults existentes: `wendkeep renumber-bugs` (revisar preview) → `wendkeep renumber-bugs --apply`; idem `renumber-learnings`. Depois `wendkeep sync-defs --project . --reseed` para atualizar as skills wk-*. ## [0.40.0] — 2026-07-16 ### Added - `parseTasks` captura **todos** os `[req:]` de uma tarefa em `reqs: string[]` (`req` permanece como alias do primeiro, retrocompatível). Antes, só o primeiro entrava no pacote de verificação e os demais sumiam sem aviso. - Heading de requisito aceita ID puro (`### Requisito: GATE-1`) como identidade, além do formato preferido `### Requisito: — `. Diagnóstico de requisito órfão agora ensina o formato esperado com exemplo concreto. - `findProjectRoot`: `wendkeep verify` executado de um subdiretório sobe a árvore até achar `wendkeep.sensors.json`/`.wendkeep.json` (à la `.git`); `--project` continua autoritativo. - `--help`/`-h` universal: qualquer subcomando com `--help` imprime a ajuda e sai com 0, interceptado antes da resolução de vault — nunca executa o comando. ### Fixed - Regex de ID de requisito unificada entre tarefa e spec (`REQ_ID_RE_SRC`): IDs multi-segmento (`API-AUTH-2`) agora são reconhecidos também nas tarefas. - `wendkeep verify` distingue `wendkeep.sensors.json` ausente (aviso com path + dica `--project`) de JSON inválido (erro alto com a mensagem do parse). Antes, ambos viravam "sensor não definido" para todos os sensores. - `wendkeep import` com flag desconhecida agora falha com exit 2 citando a flag, em vez de cair no default destrutivo `--source all` (que chegou a importar 78 sessões sem querer). - Templates seed (skills de workflow pt/en) documentam o formato de heading de requisito e o suporte a múltiplos `[req:]` por tarefa. ## [0.39.0] — 2026-07-13 ### Added - Configuração provider-neutral `.wendkeep.json`, descoberta do diretório da sessão para os pais, permitindo que Codex e Claude Code resolvam o mesmo vault sem variável global do Windows. Caminhos relativos ao projeto e caminhos absolutos são suportados. - Identidade estável `projectId`, espelhada em `.brain/PROJECT.json`; vínculos que apontem para o vault de outro projeto são rejeitados antes de qualquer gravação. - `doctor` informa caminho e origem do vínculo efetivo. Comandos CLI executados dentro do projeto também descobrem o vault local, mantendo `--vault` como override explícito. ### Changed - `wendkeep init` cria o vínculo projeto→vault de forma idempotente e adota instalações antigas registradas em `.claude/settings.json`, sem mover ou dividir o histórico. - Um vínculo local sempre vence um `OBSIDIAN_VAULT_PATH` herdado pelo processo. A variável permanece apenas para compatibilidade de comandos manuais legados. ### Fixed - Hooks do Codex deixam de gravar sessões no vault doméstico `~/wendkeep-vault` quando o processo não recebe o ambiente privado do Claude Code. Sem vínculo local ou payload explícito, o hook agora falha de modo seguro, emite diagnóstico e não cria arquivos. - Projetos simultâneos deixam de compartilhar acidentalmente sessões, mudanças e grafo por causa de uma variável global de usuário apontando para um único vault. ### Migration - Após atualizar, execute uma vez `wendkeep init --project . --vault --yes`, depois `wendkeep sync-defs --project . --reseed` e `wendkeep doctor --project .`; reinicie Codex e Claude Code para recarregar os artefatos gerados. ## [0.38.3] — 2026-07-12 ### Fixed - Sessões do Codex Desktop voltam a ser criadas quando `SessionStart` ou o primeiro `UserPromptSubmit` não fornecem `transcript_path`: o resolvedor usa o UUID canônico de `CODEX_THREAD_ID` e associa o rollout à mesma entrada assim que o transcript materializa. - A barreira cross-provider permanece fail-closed: quando `CODEX_THREAD_ID` e `session_meta.payload.session_id` estão presentes, divergência entre eles adia a escrita em vez de contaminar outra sessão. ## [0.38.2] — 2026-07-12 ### Fixed - Observabilidade de sessão: o `Effort` do Claude Code passa a derivar da **presença** de blocos `thinking` (a `signature` persiste mesmo quando o Claude Code redige o texto do pensamento), não da estimativa por caracteres — que dava `0` e marcava a sessão como `unknown` mesmo com o extended thinking ativo (visto em 42/43 chamadas do transcript principal). Rótulo binário `thinking`/`none`, desacoplado da contagem de reasoning tokens. Subagents com mesmo modelo/estado deixam de se dividir em linhas `unknown` + `thinking ~Nk` e agrupam corretamente. Reasoning do Claude vira estimativa-piso do texto sobrevivente (não determina mais o effort). Caminho Codex inalterado. ## [0.38.1] — 2026-07-12 ### Fixed - Sessão Claude nova não perde mais o 1º turno: `resolveSessionIdentity` usa o `session_id` do hook como identidade canônica quando o transcript ainda não materializou em disco, em vez de adiar a criação da nota. Codex mantém a exigência de rollout/registry — a barreira anti-contaminação do 0.38.0 segue intacta. - `task-log` e `subagent-stop` passam a honrar `input.provider` ao resolver a sessão (paridade com `decision-capture`), evitando deferimento falso quando o provider do ambiente diverge do transcript. ## [0.38.0] — 2026-07-12 ### Added - Registry multi-sessão v2: `SESSION_REGISTRY.json` passa a ser a autoridade por conversa, enquanto `CURRENT_SESSION.md` vira um dashboard compatível com todas as sessões ativas. - `wendkeep session list|show|use` e `wendkeep change bind --session ` permitem inspecionar sessões concorrentes e transferir explicitamente o vínculo de uma change. - Metadados de auditoria da observabilidade registram caller, conversa canônica, transcript e instante da atualização. ### Fixed - Roteamento cross-provider agora é fail-closed: Codex usa `session_meta.payload.session_id`, Claude usa o `sessionId` do transcript, e writers não recorrem ao foco global quando a identidade é ambígua. - Atualizações concorrentes do registry usam lock, releitura e rename atômico; patches vazios não apagam transcript ou metadados válidos. - `cost rebuild` reporta entradas órfãs, ausentes ou incompatíveis como estado não verde em vez de omiti-las silenciosamente. ## [0.37.0] — 2026-07-11 ### Added - Observabilidade consolidada em `## Agentes, tokens e custos`: Stop, SubagentStop, importação e rebuild usam um único writer atômico para main + subagents. - Ledger por modelo/origem com reasoning tokens e effort, sem alterar a regra de preço do modelo. - Novo `wendkeep cost rebuild`, dry-run por padrão; `--apply` reconstrói sessões antigas via `SESSION_REGISTRY` e grava `.brain/COST_REBUILD.json`. - Preços API-equivalentes de GPT-5.6 Sol, Terra e Luna. ### Fixed - Custos de subagents são atribuídos ao modelo que realmente os executou, em vez do modelo principal. - Migração remove os headings legados sem perder reaberturas ou iterações mal posicionadas. - Totais combinados de tokens/custo são atualizados também no `SubagentStop` e persistidos em campos compatíveis com os dashboards existentes. ## [0.36.0] — 2026-07-11 _Publicada no npm sem changelog dedicado (bump de versão não foi commitado à época); registrada retroativamente para paridade npm ↔ GitHub. As mudanças reais desta faixa estão consolidadas entre 0.35.0 e 0.38.1._ ## [0.35.0] — 2026-07-11 ### Fixed - **Wikilinks para changes arquivadas não quebram mais.** `archive` e `abandon` movem a pasta para `_arquivo/-/` — e todo wikilink gravado ANTES do move (sessões fechadas, decisões, outras changes) morria, aparecendo cinza no grafo (visto em produção). Agora o move **reescreve os wikilinks no vault inteiro** (`[[08-Mudanças//…]]` → `[[08-Mudanças/_arquivo/-/…]]`, full-path com e sem alias; nunca por basename — `proposta`/`design` existem em toda change). Fail-quiet: a reescrita nunca derruba o archive. ### Added - **`wendkeep change relink [--apply] [--json]`** — cura retroativa para vaults com links já mortos (changes arquivadas antes da 0.35.0): mapeia cada slug morto para o dir datado em `_arquivo/` e reescreve. Dry-run por default; slug ambíguo (arquivado 2×) é reportado e pulado — nunca chuta; sem archive correspondente vira aviso. ## [0.34.1] — 2026-07-11 ### Fixed - **Tabela "Por subagent" ilegível na nota de sessão**: a tabela markdown vivia dentro de `
` e o Obsidian (reading view) trata o bloco como HTML cru — sem renderizar a tabela, tudo virava uma linha só de pipes embaralhados (visto em produção). A seção agora usa um sub-heading `### Por subagent (N)` + tabela markdown pura: renderiza correto e continua colapsável via fold nativo de heading. Notas existentes se autocuram no próximo Stop/refresh (a seção inteira é regenerada pelo upsert). ## [0.34.0] — 2026-07-11 ### Added - **Spec efetiva por change**: `wendkeep spec effective --change [--json]` combina o contrato consolidado com somente o delta selecionado, incluindo origem e operação por requisito. - `change use ` troca o ponteiro global; `change continue ` cria continuação com backlink sem reabrir arquivo nem herdar evidência/verdict. - `sync-defs --check`, metadata de versão/hash e entrega idêntica de skills em `.claude/skills` e `.agents/skills`. - `SPECS_STATE.json`, baseline por change e `spec migrate/rebase` para detectar edição direta e conflitos concorrentes no mesmo requisito. ### Changed - `08-Mudanças//specs/` é o único local de autoria. `07-Specs` permanece como contrato consolidado gerado/read-only, preservando ADRs e links históricos. - `verify --deep` agora grava requisitos completos em `verificacao.json` e sela o pacote com `effectiveSpecHash`; `wk-verify` não relê `07-Specs`. - `doctor` valida todas as changes abertas e avisa quando skills precisam de reseed + reinício. ### Fixed - Requisitos `ADDED` ainda não arquivados deixam de ficar invisíveis ao verificador independente. - Archives concorrentes bloqueiam somente quando outra change alterou o mesmo requisito; mudanças não relacionadas na mesma capability podem prosseguir. ### Migration - Rode `wendkeep spec migrate --vault ` uma vez para adotar os contratos consolidados atuais. - Rode `wendkeep sync-defs --reseed --vault --project .` e reinicie Claude Code/Codex. ## [0.33.0] — 2026-07-11 ### Added - **Visão global de changes abertas**: `SessionStart`, `UserPromptSubmit`, `wendkeep change list` e `wendkeep change status` sem slug mostram todas as pendências, inclusive as iniciadas por outro agente. - Ações de takeover explícitas no contexto: Claude, Codex ou outro agente podem retomar uma change existente sem perder o restante do backlog. ### Changed - `.brain/CURRENT_CHANGE.md` continua como ponteiro global único, agora marcado como change **atual**. Comandos implícitos (`done`, `verify`, `archive`, `abandon`) continuam restritos a ela. - Mudanças em qualquer `tarefas.md` invalidam o hash do hook de contexto e reinjetam a lista global na sessão afetada. - `change-nag` permanece local à change atual; pendências de outra frente não bloqueiam o agente em foco. ## [0.32.0] — 2026-07-09 ### Added - **Contrato explícito `spec_impact`** para changes novas: `pending`, `required` ou `none`. Changes materiais (`required`) precisam listar a capability e manter um delta real em `specs//spec.md`; `none` exige justificativa em `spec_impact_reason`. - **Snapshots imutáveis de planos aprovados** em `planos/.md`, deduplicados por conteúdo. `plano-aprovado.md` passa a ser o índice dos snapshots, sem sobrescrever planos anteriores da mesma change. - Diagnósticos de `spec_impact` no `wendkeep doctor`, incluindo estado pendente, delta ausente e divergência entre `specs:` e o conteúdo real no disco. ### Changed - Hooks Claude de alta frequência usam `node` com caminho ancorado em `${CLAUDE_PROJECT_DIR}`. O `init` migra automaticamente os comandos relativos de 0.31.0 sem duplicar grupos, inclusive quando o agente muda o `cwd` para um subprojeto. - `wk-workflow`, `wk-brainstorming`, `wk-planning` e o roteador de SessionStart agora exigem a classificação do impacto, o delta da capability e a rastreabilidade `[req:ID]` antes do archive. - O archive passa a ser **fail-closed** para specs: placeholder, arquivo ausente ou falha de promoção bloqueiam o move e a criação do ADR. - Ao arquivar, links da sessão para a change ativa são reescritos para o caminho em `_arquivo`. Decisões capturadas também entram imediatamente na seção de decisões da sessão ativa. ### Fixed - **Planos aprovados descartados no Claude Code atual**: `plan-capture` agora lê `tool_response.plan` no payload estruturado de `PostToolUse:ExitPlanMode`, mantendo os formatos textuais legados e rejeições como no-op. - **52 falhas `MODULE_NOT_FOUND` observadas em produção** quando `change-warn`/`change-guard` rodavam a partir de `mobile-app` ou `backend-core`. - A criação automática de change por plano aprovado agora preserva o backlink da sessão resolvido pelo `transcript_path`/registry. - `vault-health` não exige `## Encerramento` de uma sessão ainda ativa; continua validando a ordem completa quando a sessão está finalizada. ### Migration - Rode `wendkeep init --force` para migrar hooks relativos instalados pela 0.31.0. - Rode `wendkeep sync-defs --reseed` para atualizar as skills wk-* em vaults existentes. - Changes antigas sem `spec_impact` continuam legíveis e são diagnosticadas como legadas; antes do próximo archive, classifique-as explicitamente como `required` ou `none`. ## [0.31.0] — 2026-07-09 ### Added — enforcement do loop a2 (o loop deixa de ser opcional na prática) - **5 hooks de lifecycle novos**, wired por default pelo `wendkeep init` (invocação **node-direta** `node node_modules/wendkeep/hooks/.mjs` quando o pacote está instalado no projeto — ~100-250ms vs segundos do npx no Windows; fallback npx): - **`change-context`** (UserPromptSubmit) — re-injeta a change ativa (``: slug + tarefas abertas) SÓ quando o estado mudou desde a última injeção (hash em sentinela por sessão). Sem change ativa: prompt com cara de tarefa ganha `` mandando invocar a Skill wk-workflow ANTES de editar — 1x por sessão. - **`change-warn`** (PostToolUse `Edit|Write|MultiEdit`) — edição de código sem change ativa gera aviso 1x/sessão (nunca bloqueia; ignora vault/.claude/.agent/.brain e não-código). - **`change-guard`** (PreToolUse `Bash`) — `wendkeep change archive --force` vindo do agente é **negado** (deny; escape: `WENDKEEP_ALLOW_FORCE=1` no ambiente); `git commit` com change ativa E (`--no-verify` OU sensor crítico vermelho) vira **ask** (o usuário decide). Fast-path sem I/O para comandos comuns. - **`change-nag`** (Stop) — change ativa com tarefas abertas bloqueia o encerramento 1x/sessão cobrando fechamento honesto (done / verify / **ou informar a pendência ao usuário**). Anti-loop absoluto via `stop_hook_active`. - **`plan-capture`** (PostToolUse `ExitPlanMode`) — **a ponte determinística plan-mode → vault**: plano aprovado no plan mode do Claude Code vira change no vault (proposta do Contexto, design do corpo, tarefas dos checkboxes) ou anexa `plano-aprovado.md` à change ativa. Não depende de a LLM lembrar do processo. - **`wendkeep change abandon [slug]`** — a saída legítima para change que não vai adiante: move para `_arquivo/--abandonada` com `status: abandoned`, SEM ADR, SEM promoção de specs; limpa o ponteiro só se era a ativa. Elimina o motivo real de `--force` em scaffold. - **`quickGateState(vaultBase)`** + sentinelas por sessão (`.brain/.change-*-`, GC >7 dias no Stop) em change-core — fonte única do estado do gate para hooks e CLI. - **`wendkeep sync-defs --reseed`** — re-semeia as skills wk-* de `.brain/skills` com os seeds da versão instalada (é como um vault existente recebe as descriptions/HARD-GATE novos). ### Changed — gate endurecido + ativação da skill - **Verdict SEMPRE exigido no archive** (breaking-ish): sem `verdict.json` o archive bloqueia, mesmo sem `[req:]` — `wendkeep verify --deep` grava o verdict trivial automático (1 comando). Changes em andamento criadas antes de 0.31.0 precisam de um `verify --deep` antes do archive. - **G0 inescapável**: `--force` deixa de pular o check de scaffold — um scaffold cru NUNCA é arquivável (era o buraco que mintou ADR falso em produção). - **`--force` e trivialidade rastreáveis**: ADR ganha `forced: true` (+ aviso ⚠️ no corpo) quando `--force` pulou tarefa aberta, e `trivial: true` quando a change não declarou `[req:]`/`[sensor:]`. - **Promoção de specs = união frontmatter + disco**: o archive promove também os deltas REAIS achados em `specs/*/spec.md` mesmo com `specs: []` na proposta (warning por cap não listada; o `exemplo` placeholder do scaffold é filtrado). Fecha o buraco que deixava 07-Specs vazio com delta preenchido no disco. - **Ativação da skill (paridade Superpowers)**: descriptions das wk-* reescritas com gatilhos concretos ("Use SEMPRE que o usuário pedir para implementar/criar/corrigir/refatorar… Invoque ANTES de editar qualquer arquivo"); `` no corpo da wk-workflow; o `` do brain-inject agora manda **invocar a Skill** (verbo de skill) e cita `abandon`. ### Fixed - **Seções apagadas pelo Stop (classe de bug, visto em produção)**: qualquer seção inserida entre `## Pendências` e `## Encerramento` era descartada pelo finalize (`replacePendingSection` reconstruía o span inteiro) — atingia `## Subagents & Workflows` (frontmatter sobrevivia, corpo sumia), `## Progresso do plano` e `## Mudanças`. Duas camadas: `upsertSection` agora ancora ANTES de `## Pendências`, e o finalize preserva seções desconhecidas dentro do span. Notas antigas se autocuram no próximo Stop/backfill (os dados persistem em `subagents/`). ### Known limitation (aceita e documentada) - Hooks do mesmo evento rodam em **paralelo** no Claude Code: quando o `change-nag` bloqueia o Stop, o `session-stop` já finalizou a nota — o turno de continuação não é logado nela (recuperável via `session-backfill`/`import`; perda máx. de 1 turno, 1x por sessão). ## [0.30.0] — 2026-07-09 ### Changed - **Decision notes follow the ADR convention: `ADR--`.** Every decision note now carries a 4-digit, zero-padded sequential number assigned in the order decisions are made (`ADR-0001`, `ADR-0002`, …) — replacing the old `YYYY-MM-DD-escolha-` filenames from the interactive and prose captures. The number goes in the filename, in an `adr:` frontmatter field, and as an `# ADR-NNNN — ` H1 prefix. The native `wendkeep change archive` ADR and the `createLinkedNotes` heuristic ADR widen from 3 to 4 digits (`ADR-007` → `ADR-0007`) to match. - **Decision capture dedups by `content_key`, not by filename.** Because the filename now carries a fresh ADR number it can't dedup, so a decision already recorded in the target folder (same normalized question) is skipped by content — both the AskUserQuestion hook (`captureDecision`) and the agnostic prose capture (`captureProseDecisions`). New `decisionKeyExists` / `padAdr` helpers. ### Added - **`wendkeep renumber-decisions`** — retroactive fix for vaults that accumulated the three historical naming eras (`ADR-NNN`, dated `escolha`, hand-written). Renumbers **every** note in 04-Decisões to `ADR-<NNNN>-<slug>` in strict chronological order, renames the files in place, and **rewrites every wikilink to them across the whole vault** (full-path, basename, and `|ADR-006` display aliases). Normalizes each note's `type: decision` / `adr:` / H1. Preview by default (writes nothing); pass `--apply` to commit the renames. Idempotent — a second run on a canonical vault is a no-op. `--vault P` / `--json`. New `hooks/renumber-decisions.mjs` (`planRenumber`, `renumberDecisions`, `slugFromDecisionName`, `decisionSortKey`, `normalizeDecisionContent`, `rewriteLinks`). ## [0.29.2] — 2026-07-09 ### Fixed - **Iteration turn marker renamed `codex-turn` → `wk-turn`** (provider-neutral). A **Claude** session's iterations carried `<!-- codex-turn: … -->` — a legacy name from when this was a Codex-only tool, confusing in the note source. The marker is a dedup key, so the change is backward-compatible: `hasTurnMarker` still recognizes the legacy name, and `insertIteration` **self-migrates** any `codex-turn` → `wk-turn` on the next write (backfill re-processes older notes). Shared helpers `turnMarker` / `hasTurnMarker` / `normalizeTurnMarkers` in obsidian-common; `vault-health` recognizes both. - Note-visible fallback text "Checkpoint registrado pelo hook Stop do **Codex**" → provider-neutral. - Stderr log prefix `[codex-obsidian]` → `[wendkeep]` across the hooks. ## [0.29.1] — 2026-07-09 ### Added - **`wendkeep import --rescan-decisions`** — re-scan **already-imported/captured** transcripts for prose decisions only (no session re-import). For sessions imported before 0.29.0 whose rollouts carry options-in-prose choices that were never captured. Walks the registry (`session_file` + `transcript_path`), runs the same conservative extraction, dedupes by filename — re-running is a no-op. `--limit N` / `--json` supported. New `rescanDecisions()` export. ## [0.29.0] — 2026-07-09 Codex decision parity — agnostic prose-decision capture. ### Added - **Prose-decision capture** (`extractProseDecisions` / `captureProseDecisions` in `hooks/decision-capture.mjs`, wired inside `createLinkedNotes`): Codex has no `AskUserQuestion`-style tool — the agent asks in **prose**. A conservative pattern (assistant message with ≥2 enumerated options ending in a question + a SHORT user reply) now produces the **same decision note** the Claude hook writes (options + the user's choice, in `04-Decisões/`, wikilinked to the session). One integration point covers **live Stop, `import` and backfill, for every provider**. Validated on 144 real Codex rollouts: 6 genuine decisions extracted, no visible false positives. ### Notes (investigated, decided against) - **Codex subagent telemetry**: real rollouts contain **no** subagent/parallel structure — nothing to map; documented as not applicable. - **Codex structured events** (`thread_goal_updated`, `task_complete`): goal payload ≈ the initial prompt; task events are turn markers already parsed. No extra capture worth the noise. ## [0.28.1] — 2026-07-09 Startup-contention fixes — root-caused from a real VSCode startup log where the memory injection silently dropped and MCPs timed out. ### Fixed - **`brain-inject` timeout 15 → 45s.** The hook is healthy (~2.5s direct, ~4s via npx warm), but Windows session startup runs several `npx` cold-starts at once (a sibling MCP took **26s** in the log) and 15s silently killed the CORE+DIGEST injection for the whole session. - **context-mode double-registration eliminated.** Its plugin ships its **own** MCP server; wiring an `.mcp.json` entry too registered it twice — two concurrent `npx context-mode` cold-starts, both timing out. The companion is now **plugin-only** (on non-Claude agents add the MCP manually: `npx -y context-mode`). - **`MCP_TIMEOUT=60000` default** added to the settings `env` by init (only when absent — a user value is never clobbered), giving npx-launched stdio MCPs (wendkeep-vault included) headroom over Claude Code's 30s default. ### Upgrade - Existing installs: re-run `wendkeep init` (now recognizes your vault) to pick up the timeout + `MCP_TIMEOUT`; remove a duplicated `context-mode` entry from `.mcp.json`/`enabledMcpjsonServers` by hand if present. ## [0.28.0] — 2026-07-09 Three new hooks: decisions, subagents, plan progress. ### Added - **Decision capture** (`PostToolUse` / `AskUserQuestion` → `hooks/decision-capture.mjs`): when the agent asks the user to choose between options, the decision is recorded in `04-Decisões/` — the question, **every** option (label + description), the user's choice (✅), and a wikilink to the session. Explicit, high-signal decisions get full traceability in the graph. Shape validated against real transcripts. - **Live subagent telemetry** (`SubagentStop` → `hooks/subagent-stop.mjs`): refreshes the session's subagent/workflow cost notes the moment each subagent finishes (reuses `upsertSubagentUsage`), so a session that never reaches `Stop` still has its telemetry. *Model choice stays the harness's job — wendkeep observes, it does not impose a routing rule.* - **Plan progress log** (`TaskCompleted` → `hooks/task-log.mjs`): when a task is marked complete, appends it to a durable `## Progresso do plano` section in the active session note (before `## Encerramento`, so reopen can't strip it). A progress trail, not a fuzzy map to `tarefas.md`. All three are wired by `wendkeep init`, are fail-open, and localize (pt-BR / en). `--force`-free — they only read + append. ## [0.27.0] — 2026-07-08 ### Fixed - **Re-running `wendkeep init` no longer re-asks for the vault (or language) — and can't split your data.** On a project already set up, init now reads the registered vault from `.claude/settings.json` (`OBSIDIAN_VAULT_PATH`) and the locked locale from the vault's `.brain/config.json`, reuses both, and skips the prompts. Previously a re-run (e.g. after `npm i -D wendkeep@latest`) offered the *derived* default (`.<project>-vault`); accepting it — or mistyping the name — created a **second, divergent vault**. `--vault` / `--locale` still override. New exported `detectRegisteredVault()` / `readVaultLocale()`. `src/init.mjs`. ### Note - You do **not** need `wendkeep init` for a routine update: the hooks live in the package (`settings.json` calls `npx --no-install wendkeep hook …`), so `npm i -D wendkeep@latest` updates them. Re-run `init` only when a release adds new wiring (the CHANGELOG says so); it's idempotent. ## [0.26.0] — 2026-07-08 ### Fixed - **`wendkeep init` output now follows the chosen vault language.** Picking Português left the whole summary + `[n/4]` steps + "Next steps" block in English; only the interactive prompts were localized. All init output is now driven by a locale message set (pt-BR / en) resolved from the language answer — "Próximos passos", "taxonomia do vault", "sensores semeados", etc. `src/init.mjs`. ## [0.25.1] — 2026-07-08 ### Added - **Landing page in the repo**: a static SVG hero (`docs/assets/wendkeep-hero.svg`, the knowledge graph) embedded at the top of the README, plus the self-contained interactive landing at `docs/index.html` (live Canvas graph; serve `docs/` via GitHub Pages for a public URL). ### Changed - `wendkeep stats` now says **"N dias ativos (first→last)"** — the count is distinct days *with activity*, not the calendar span; the old "N dia(s)" read as calendar days. ## [0.25.0] — 2026-07-08 Cost trend/projection + shareable stats + launch assets. ### Added - **`wendkeep cost --trend [day|week|month]`** — cost bucketed over time plus a run-rate **projection** (recent-window daily average × horizon). `wendkeep cost --write` generates a `00-Custo.md` trend note in the vault (by-month table + projection + top models). `src/cost.mjs`. - **`wendkeep stats`** — one shareable line: sessions · prompts · spend · date span · models (`--json` too). For the npm page, a README badge line, or a post. `src/stats.mjs`. - **Launch assets** (`docs/`): README hero (tagline, badges, quickstart, screenshot slot), Show HN / r/ObsidianMD / X post drafts (`docs/20-launch-posts.md`), and a repeatable graph-screenshot guide (`docs/21-graph-screenshot.md`). ## [0.24.0] — 2026-07-08 ### Changed - **No companion is pre-selected anymore.** `context-mode` was pre-checked (and the non-interactive default); wendkeep is a neutral harness and should not presume a third-party plugin. The interactive picker now starts with **nothing checked**, `init --yes` (and any non-interactive run) installs **no** companions, and `resolveCompanions({})` returns `[]`. Opt in explicitly — interactively (Space) or `--companions context-mode`. `src/taxonomy.mjs`. - Prompt/help/README text updated to reflect the empty default. ## [0.23.0] — 2026-07-08 Vault structure — generated views + housekeeping (audit wave 2). ### Added - **Generated Bases + Dashboard MOC**: `wendkeep init` now writes one folder-filtered `.base` per taxonomy area (sessions/decisions/bugs/learnings/specs/changes) and a `00-Dashboard.md` that embeds them — the vault's structural index. Filters are **by folder** (`file.inFolder("05-Bugs")`), fixing the tag-filter that hid ~1/3 of bugs. New `wendkeep dashboard [--force]` (re)generates them; non-destructive (never clobbers your own bases). Locale-aware. `src/vault-views.mjs`. ### Changed - **Archive ADRs land in the dated month folder** (`04-Decisões/<year>/<MM-MMM>/`) alongside session-derived decisions, instead of the year root. `hooks/change-core.mjs`. - **`SESSION_REGISTRY` is pruned** on the idle sweep: `done` entries older than 90 days, then a cap of 200 most-recent — active entries are never touched. Bounds the per-hook read/serialize cost that had grown to 330 entries / ~170 KB in production. `hooks/obsidian-common.mjs`. - **Generated note names truncate on a word boundary** instead of mid-word (`slugify` gained a boundary-aware `maxLen`). `hooks/obsidian-common.mjs`, `hooks/linked-notes.mjs`. - **Learnings dedup vault-wide**: a learning already recorded anywhere in `06-Aprendizados` (by `content_key`) is not re-emitted on a later day/session. `hooks/linked-notes.mjs`. ### Deferred - Unifying the two `buildSessionContent` skeletons (session-start / session-ensure) stays as tracked tech-debt — pure refactor, high regression risk in the capture layer, and the user-facing drift (`session_id`) was already closed in 0.18/0.21. ## [0.22.0] — 2026-07-08 Hardening — 10 audit-confirmed bugs fixed (each survived an adversarial refuter). ### Fixed - **Archive trusted stale evidence**: `verify` now seals `evidencia.json` with a `.evidence-hash` (the `tarefas.md` hash it ran against); the archive gate rejects evidence gone stale (a sensor task added/edited after the last green verify). `src/verify.mjs`, `src/change.mjs`. - **Archiving a non-active change wiped the active pointer**: `archiveChange` now only clears `CURRENT_CHANGE` when the archived slug IS the active one. `hooks/change-core.mjs`. - **Non-atomic archive**: a destination-exists guard fails BEFORE promoting specs (same-day slug reuse no longer half-promotes `07-Specs` then errors on the move); `renameSync` wrapped. - **Archived proposta kept `status: active`** → flipped to `status: archived` on archive. - **Import dropped Codex sessions whose `session_meta` exceeded 16KB** (~31% in production): the reader now grows the buffer to the first newline instead of a fixed prefix. `hooks/import-sessions.mjs`. - **Cost was silently $0 for untabled models**: `normalizeModelName` strips a `[1m]` context tag generically (so `claude-opus-4-8[1m]` prices), `claude-sonnet-5` added, plus approximate Codex `gpt-5.4`/`gpt-5.3-codex` aliases. `hooks/token-usage.mjs`, `hooks/pricing.json`. - **Imported session titles came from harness meta-prompts** ("Generate a concise title…"): those utility prompts are now filtered in both parsers' `shouldIgnoreUserText`. - **Session↔change link died on reopen**: the change wikilink moved from an append after `## Encerramento` (stripped every turn) to a durable `## Mudanças` section before it, which accumulates every change the session touched. `hooks/session-stop.mjs`. - **`init --force` duplicated every hook group**: now refreshes the managed entry in place instead of appending a second identical group. `src/init.mjs`. - **Injected DIGEST carried dead wikilinks**: `buildBrainDigest` now keeps only targets that resolve to a real note and drops truncated placeholders. `hooks/brain-core.mjs`. ### Changed - **Docs coherence**: `--help` moved `--top` from `import` to `cost`, gave `import` its real flags (`--source`/`--stamp-ids`/`--from`/`--codex-from`/`--limit`/`--dry-run`, "Claude + Codex"), and added `verify [--deep]`. README dropped the stale "v0.1" framing, fixed the 5→6 skill list (adds `wk-verify`), made the `docs/` link absolute, and documented the `<wk_process>` router + the G0 scaffold gate. ## [0.21.0] — 2026-07-08 Process enforcement — fixes from a real planning failure (production session): the model planned in chat, never invoked the wk-* skills, left the change scaffold raw and archived it with `--force`, minting a bogus ADR. ### Added - **`<wk_process>` router injected every session** (brain-inject): the enforcement layer the skills were missing. Plan → wk-brainstorming + wk-planning; record → `change new` + FILL proposta/design/tarefas; implement → wk-tdd; close → verify + wk-verify + archive. States explicitly that `archive --force` is the user's call, never the agent's. Localized (pt-BR/en). - **G0 — anti-scaffold gate**: `change archive` now blocks when proposta/design/tarefas still carry the scaffold placeholders (`(motivo da mudança)`, `(abordagem técnica)`, `(primeira tarefa)` + en variants) — an unfilled scaffold is not a completed change. `--force` still escapes (human hatch); new `scaffoldPlaceholders(dir)` in change-core. ### Fixed - **session-ensure now stamps `session_id`** in the notes it creates — the 4th note-creation path, missed in 0.18.0 (it has its own skeleton builder). Notes born from UserPromptSubmit (no SessionStart, e.g. resumed windows) were coming out without identity. ## [0.20.1] — 2026-07-06 ### Changed - The interactive (and text-fallback) companion picker in `wendkeep init` **no longer lists dotcontext**. The native a2 loop replaces it, so leaving it in the prompt was just clutter. It stays reachable for anyone already invested via an explicit `--companions dotcontext` — the hiding is UI-only (`resolveCompanions` still honors the id). New `selectableCompanions()` helper drives the picker. ## [0.20.0] — 2026-07-06 Richer skills: bundled templates (multi-file). ### Added - The process skills now ship **bundled templates** next to their `SKILL.md`, delivered together by `sync-defs` (the whole skill folder is copied) and auto-delivered by `init`. The model reads them on demand — depth without bloating `SKILL.md`: - **wk-verify** → `spec-reviewer-prompt.md` (the prompt to hand a fresh read-only verifier sub-agent) + `verdict-template.json` (the exact `verdict.json` shape). - **wk-planning** → `plan-template.md` (file map + bite-sized TDD task structure). - **wk-brainstorming** → `design-template.md` (context, approaches, signed-off assumptions, out-of-scope table, acceptance). - pt-BR and en variants; the prose templates follow the vault locale, the JSON is shared. ### Notes - Subagents stay the **native harness's** job. wendkeep ships the verifier **prompt** (the agent spawns a read-only sub-agent via its own Task/Agent tool) and captures subagent telemetry — it does not orchestrate spawning. So the reviewer is a template, not a Claude-only `.claude/agents/*.md`, which keeps it agent-agnostic. ### Upgrade - `npm update wendkeep`, then `wendkeep init` (or `wendkeep sync-defs`) to get the templates alongside your existing skills. Non-destructive — existing `SKILL.md` files are never overwritten. ## [0.19.0] — 2026-07-06 Fix: memory + active-change injection wired by default. ### Fixed - `wendkeep init` now wires the **`brain-inject`** hook into SessionStart (ordered *before* `session-start`), so every session gets `<brain_memory>` injected: CORE + DIGEST + the **active change** (proposal + open tasks) + project lessons. Previously the default hook set was only `session-start` / `session-stop` / `session-ensure` — the memory/change injector existed (`wendkeep hook brain-inject`) but wasn't wired, so the "the change is injected at the next SessionStart" promise (the `wk-workflow` skill and the README) didn't actually hold on a fresh install. matcher `startup|clear|compact` re-injects after a compaction or clear, not only on a cold startup. ### Upgrade - Existing installs pick it up by re-running `wendkeep init --force` (idempotent — it only adds the missing hook), or by adding `npx --no-install wendkeep hook brain-inject` to the SessionStart hooks manually. ## [0.18.0] — 2026-07-06 Session identity in the note. ### Added - Session notes now carry **`session_id`** in their frontmatter — both live capture and import, Claude and Codex. Pairs with the existing `provider:` field so every note self-identifies (which conversation, which agent) without consulting the registry. - **`wendkeep import --stamp-ids`** — backfill `session_id` into existing notes from the `SESSION_REGISTRY` (for notes captured or imported before the field existed). Idempotent; only touches notes missing the field. - Import dedup now also scans existing notes' `session_id` (`capturedSessionIds` = registry ∪ note frontmatter), so a session that already has a note on disk is never re-imported even if the registry was reset or lost. ### Changed - `buildSessionContent` accepts a `sessionId`; the SessionStart hook (all three create/recreate paths) and `importSession` thread the id through, so a note records its identity at creation. ## [0.17.0] — 2026-07-06 Retroactive memory, now agent-agnostic (Codex). ### Added - **`wendkeep import --source codex|all`** — import now covers **Codex** too. Codex rollouts (`~/.codex/sessions/**`) aren't organized by project, so they're scoped by the `cwd` recorded in each session's `session_meta` — matched case- and separator-insensitively, including subdirectories. `--source` defaults to **`all`** (both agents); narrow with `claude` / `codex`. `--codex-from <dir>` overrides the sessions root. - Transcript parsers now carry a `provider` field, so an imported note is tagged with the transcript's **real** provider (`provider: codex` for Codex) instead of the ambient default. ### Changed - `wendkeep import` default source is now **`all`** (was Claude-only in 0.16.0). Still idempotent — already-imported sessions are skipped by `session_id`, per project (Claude by slug dir, Codex by `session_meta.cwd`). - Import registration keys off the **discovered** `session_id` (filename for Claude, `session_meta.id` for Codex) so the dedup key and the registry key are always identical — closes a latent duplicate-on-reimport gap if a transcript's filename ever diverged from its internal id. - Validated on real data: **24** Codex sessions discovered for a production project (across drive-case variants), 0 parse errors, notes correctly tagged `codex`. ## [0.16.0] — 2026-07-06 Retroactive memory. ### Added - **`wendkeep import`** — backfill the vault with this project's *past* Claude Code sessions. It scans `.claude/projects/<slug>/*.jsonl`, and for every session not already in the vault (deduped by `session_id` against the `SESSION_REGISTRY`) reconstructs a full, dated session note — frontmatter, one iteration block per turn, cost + subagent telemetry, derived decision/bug/learning notes, and a finalized closing — placed in its **real** date folder (`02-Sessões/<year>/<MM-MMM>/DIA <dd>/`), not today's. One command turns your whole history into memory that `wendkeep cost` immediately aggregates. - Offline replay of the live capture flow (same `buildSessionContent` / `insertIteration` / `finalizeSessionFile` / usage + subagent code) so an imported note is indistinguishable from a captured one. - Options: `--from <dir>` (point at the `.claude/projects` folder explicitly), `--project`, `--since <date>`, `--limit <n>`, `--dry-run` (report without writing), `--json`. - Idempotent: re-running skips everything already imported. Never overwrites an existing note. - v1 covers Claude Code transcripts; Codex is a follow-up. ### Changed - `session-start.mjs` now guards its `main()` behind the standard `import.meta.url` check (like `session-stop.mjs`) so its note-building helpers can be imported by `import`/tests without running the hook. No behavioral change when invoked as a hook. ## [0.15.0] — 2026-07-06 ### Added - **`wendkeep cost --top [N]`** — the N priciest sessions (cost incl. subagents · date · file), most expensive first (default 10). Spot where the money went. `cost --json` now also carries the per-session `sessions` list. ## [0.14.0] — 2026-07-06 ### Changed - **dotcontext is no longer a default companion.** wendkeep's native a2 loop (`change` / `verify` / gate) recreates dotcontext's execution/gate role, so pinning it duplicates the harness. The interactive / `--yes` default is now **`context-mode` only**; dotcontext stays selectable via `--companions dotcontext` for anyone already invested. - **README:** rewrote "Install & set up" with a clear **`init` options table** and a per-companion breakdown; clarified that `--no-mcp` skips **only wendkeep's own** vault MCP (companion MCPs still follow `--companions`). ## [0.13.0] — 2026-07-06 Cost intelligence: waste + average. ### Added - **Wasted-spend tracking:** a killed/failed workflow run's subagent cost is now recorded per session (`subagents_wasted_usd` + a line in the note's `## Subagents & Workflows`) and rolled up by `wendkeep cost` (`desperdiçado (runs killed/failed): $X`). Money burned on aborted runs was invisible before. - **`wendkeep cost` per-session average** (`$/sessão`) alongside the vault total. ## [0.12.0] — 2026-07-06 Deeper subagent/workflow telemetry. ### Added - **Workflow run metadata** in the `## Subagents & Workflows` section: each run now shows its **status** (completed / killed / …), phase titles, duration and agent count — read from the authoritative `workflows/wf_*.json`. On a real session this surfaced a **killed** run that still cost $2.50 next to the completed $5.76 one — wasted spend you couldn't see before. - **Subagent tools rollup:** the distinct tools the subagents used, shown in the section and a new `subagents_tools` frontmatter field. ## [0.11.0] — 2026-07-06 Vault-wide cost. ### Added - **`wendkeep cost`** — aggregate AI-coding spend across every session note in the vault: total (main + subagents), by model, by day. `--since <YYYY-MM-DD>` to window; `--json` for scripting. Builds on the per-session cost the capture hooks already record — on a real project vault it surfaced **~$4.7k across 140 sessions** in one command. ## [0.10.0] — 2026-07-06 Subagent & workflow telemetry — closing the biggest observability gap. ### Added - **Subagent + workflow capture:** the Stop hook now scans the session's sibling subagent transcripts (`<session>/subagents/**`) and workflow runs, and folds them into the session note — a new `## Subagents & Workflows` section (aggregate + a collapsible per-subagent table) plus frontmatter fields (`subagents_count`, `subagents_tokens_total`, `subagents_custo_usd`, `tokens_total_incl_subagents`). Reuses the token-usage parser (deduped per request). Previously a session that spawned a Workflow recorded ONLY the main transcript — on a real audit session that hid **12 subagents / 4.6M tokens / $7.59** (2× the main). The main `tokens_total` stays the main agent's (comparable to Claude Code's own display); subagents are a separate axis. - Provider-gated by structure (Claude Code's `subagents/` layout); fail-open — never blocks Stop. ## [0.9.1] — 2026-07-06 Interactive install UX: language first. ### Added - **`wendkeep init` asks the vault language first** on an interactive TTY (when `--locale` isn't passed): `[1] Português [2] English`. The answer drives the folders, scaffold and skills — and the remaining prompts (vault path, companion selection) now render in the chosen locale instead of always Portuguese. `--yes`, `--locale` and non-TTY are unchanged. ## [0.9.0] — 2026-07-06 Engineering debt: sensor editing + i18n coherence for auto-generated notes. ### Added - **`wendkeep sensors add <id> "<command>"`** (`--severity` / `--type` / `--report` / `--name` / `--description`) — append a sensor to `wendkeep.sensors.json` (creates the file with `$schema` when absent, dedups by id) instead of hand-editing JSON. - **Locale-aware derived notes:** the auto-generated bug/decision/learning notes render their headings + callout in the vault locale — an `en` vault no longer gets Portuguese headings. ### Deferred (with reason) - `migrate-locale`: renaming a populated vault breaks every wikilink to the old folder names; needs a backlink-repair pass — its own effort, not a patch. - Code-hash verdict freshness: a change carries no file manifest, so "the code" is undefined; the existing `tarefas.md` hash already blocks task drift. ## [0.8.1] — 2026-07-06 Polish: i18n coherence + presentation. ### Added - **Locale-aware process skills + vault docs:** an `en` vault now seeds the `wk-*` skills, the vault README, the change template, and the specs README in English (previously Portuguese regardless of locale). Completes the `--locale en` promise. - **`wendkeep.sensors.json` at the repo root** — the project gates itself with its own test/check sensors (dogfooding the harness). ### Changed - npm `description` now describes the harness + a2 loop (was capture-only). - CI: `actions/checkout` and `actions/setup-node` bumped to `v5` (v4 runner deprecation). - README: the i18n "known limitation" is resolved. ## [0.8.0] — 2026-07-05 Reach: internationalization + agent-agnostic distribution. ### Added - **Vault locale (i18n):** `wendkeep init --locale en` creates an English vault (`02-Sessions`, `04-Decisions`, `08-Changes`, …, English months, English change scaffold, English CORE skeleton, localized theme/graph groups). The locale is a vault property (`.brain/config.json`), locked at init; absent = `pt-BR` — existing vaults are untouched and never renamed. Parsers are **bilingual everywhere** (`Requisito|Requirement`, `mata mutante|kill mutant`, CORE section sets), so mixed content never breaks. - **AGENTS.md managed section:** `sync-defs`/`init` maintain a marker-delimited section in the project's `AGENTS.md` (loop summary + skill inventory) — one file that Codex, Amp, Cursor, Zed and any AGENTS.md-reading agent picks up. User content around it is preserved. - **Harness contract v1.2** (`docs/14`): locale + AGENTS.md channel. ### Deferred - Extra mutation-report formats (mutmut/PIT) and per-agent session-hook wiring — backlog (`docs/17`). ## [0.7.0] — 2026-07-05 Ergonomics: the loop without hand-editing files. ### Added - **`change status`** — one screen: tasks (done/open with `[req:]`/`[sensor:]`), sensor evidence, verdict state (ok / stale / incomplete / absent), mutation round. - **`change done <id>` / `undone <id>`** — tick tasks from the CLI (exact-id anchored). - **`change diff`** — dry-run preview of the spec promotion (`+` ADDED / `~` MODIFIED / `-` REMOVED / `!` warnings) without touching `07-Specs`. - **`spec list` / `spec show <capability>`** — read-only views over the living specs. - **`sensors list`** — the sensors from `wendkeep.sensors.json`; a **JSON Schema** for the file now ships in the package (`schema/`) and the init seed points `$schema` at it. - README: "the loop in five minutes" worked example. ### Fixed - `change` subcommands without a positional argument no longer mistake the `--vault` value for a slug. ## [0.6.1] — 2026-07-05 Hardening: CI + real-world gate holes found by self-audit. ### Added - **CI (GitHub Actions):** test + check matrix on ubuntu/windows × Node 18/20/22. - **Open-task gate:** `change archive` blocks while tasks are open (`- [ ]`, including mutation fix-tasks `M.n` — a surviving mutant can no longer be archived). Explicit escape: `--force`. - **Freshness seal (`tasksHash`):** `verify --deep` fingerprints `tarefas.md` into the package and verdict; the gate rejects a verdict minted against different tasks as stale. Pre-0.6.1 verdicts (no hash) still accepted. - **Auto-lesson on mutation escalation:** the 3rd surviving round records a project-local lesson. - **Session link in proposta:** `change new` fills `source:` with the active session (graph edge proposta → sessão). ### Fixed - `.mutation-round` now resets when the report comes back clean (a future survivor starts a fresh 3-round cycle instead of instantly escalating). - `verify` exits 1 when mutants survive (was 0 — CI couldn't see it). - `.brain/lessons/` capped at 50 (oldest pruned) instead of growing unbounded. ## [0.6.0] — 2026-07-05 Enforcement layer (Wave B of the TLC-parity program) — closes TLC parity. ### Added - **Discrimination sensor (`type: mutation`):** delegates to the project's mutation tool and parses its mutation-testing-elements report; surviving mutants become fix tasks in the active change (`- [ ] M.n mata mutante file:line`), bounded to 3 rounds before escalating. - **Harness self-check:** `wendkeep doctor` now validates the a2 state — an invalid `wendkeep.sensors.json`, a broken `CURRENT_CHANGE` pointer, changes without a `proposta.md`, an orphan `[req:]` (unknown requirement), and stale verdicts. - **Lessons loop:** `wendkeep lesson add "<trigger>" "<lesson>"` records a project-local lesson in `.brain/lessons/`; `brain-inject` surfaces the recent ones as a `<lessons>` block at SessionStart. - **Auto-sizing:** `wendkeep change new <slug> --simple` scaffolds only proposta + tarefas (no design / spec-delta) for trivial changes. - **Harness contract v1.1** (`docs/14-harness-contract.md`): the mutation + lesson formats. ## [0.5.0] — 2026-07-05 Verification & credibility layer (Wave A of the TLC-parity program). The gate stops being "green sensors" alone and starts requiring an independent verdict for changes that touch a spec. ### Added - **Requirement IDs + traceability:** living-spec requirements carry a stable ID (`### Requisito: GATE-1 — nome`); tasks reference them with `[req:<ID>]`; the archive ADR lists the requirements it satisfied. Rastro req → task → verdict → ADR. - **`wendkeep verify --deep`:** assembles a verification package (`verificacao.json`) for an independent pass. A trivial change (no `[req:]`, sensors green) gets an auto verdict. - **Independent verdict gate:** `change archive` now also requires `verdict.json` (`ok`, covering every declared `[req:]`) for requirement-bearing changes. - **TLC-grade process skills:** rewrote `wk-tdd` (spec-derived assertions, non-shallow litmus, test adequacy, test-learning) and `wk-brainstorming` (closure gate + out-of-scope); new `wk-verify` (fresh read-only verifier, author≠verifier). - **Harness contract v1** (`docs/14-harness-contract.md`): the extension-point formats. ### Changed - Requirement-less changes are unaffected — the sensor gate remains their proof. The verdict requirement applies only when a change declares `[req:]` tasks. Specs from 0.4.0 (headings without an ID) stay valid. ## [0.4.0] — 2026-07-05 Spec promotion (the living contract) + harness fixes. ### Added - **Spec promotion** — `wendkeep change archive` merges each capability's spec delta (`## ADDED` / `## MODIFIED` / `## REMOVED Requirements`) into the living `07-Specs/<capability>.md`. Multi-capability per change via `specs: [slugs]` in the proposta; the living spec footer wikilinks the archived change (`hooks/spec-core.mjs`). - Change scaffold now seeds an example spec delta at `specs/exemplo/spec.md`. - `wendkeep change archive` prints promoted capabilities and surfaces delta warnings (ADDED-already-exists / MODIFIED-missing) without blocking. ### Changed - `wendkeep init` now runs `sync-defs` itself — process skills and agents are delivered to `.claude/skills` / `.codex/agents` immediately (no manual step). - The archive gate and `wendkeep verify` share one rule: only **critical** (or missing) sensors block; a red `warning` sensor is advisory. Evidence records each sensor's severity. - README documents the change/verify/skills commands and the a2 loop. ## [0.3.0] — 2026-07-05 The a2 native harness — a zero-dependency spec→change→proof loop on the vault memory core (recreates the best of OpenSpec + dotcontext + superpowers, natively). ### Added - **Pilar B — change lifecycle:** `wendkeep change new|list|show|archive`. Scaffolds `08-Mudanças/<slug>/` (proposta/design/tarefas); the active change is injected at the next `SessionStart`; archive moves the change to `_arquivo/` and mints an ADR in `04-Decisões/`. New vault folders `07-Specs/`, `08-Mudanças/` (`hooks/change-core.mjs`). - **Pilar C — verify + gate:** `wendkeep verify` runs a change's task-declared sensors (`[sensor:<id>]` hints) from a native `wendkeep.sensors.json`, records `evidencia.json`; `change archive` gates on the evidence (`hooks/sensors-core.mjs`). - **Pilar A — process skills:** native `wk-workflow` / `wk-tdd` / `wk-debugging` / `wk-brainstorming` / `wk-planning` seeded into `.brain/skills` (`src/skills-seed.mjs`). ## [0.2.7] — 2026-06-30 ### Added - **Definitions layer:** `.brain/agents/` + `.brain/skills/` as versioned source of truth, copied into the project with `wendkeep sync-defs`. - **dotcontext seed:** a starter `.context/config/sensors.json` (a `validate-memory` sensor plus one per detected `package.json` script) when the dotcontext companion is selected. ## [0.2.1] – [0.2.6] — 2026-06-29 Rapid iteration on the companion + memory layers (same day): - **Companions** wired the most agent-agnostic way (context-mode / dotcontext as MCP, understand-anything via a domain-graph SessionStart injector, caveman via installer). - **Obsidian color system** — a mode-agnostic CSS snippet (note-type accents) + graph color groups, merged non-destructively into `.obsidian/`. - **Curated memory protocol** — `.brain/CORE.md` + `COMPACTION_PROTOCOL.md` and `wendkeep validate-memory` (cap 25 lines, 3 sections, no secrets/PII). - Cross-platform caveman installer fix (npx non-interactive; Gemini excluded). - Derived notes grouped by month under the year. ## [0.2.0] — 2026-06-29 ### Added - Companion plugins/MCP selection in `wendkeep init` (context-mode, understand-anything, caveman) with idempotent settings/`.mcp.json` merging. ## [0.1.0] — 2026-06-29 Initial release — the capture engine, extracted from a system in daily production use. ### Added - Automatic session capture (`SessionStart` / `UserPromptSubmit` / `Stop` hooks) into `02-Sessões/` as turn-by-turn Markdown. - Multi-agent provider detection (Claude Code, Codex, Copilot). - Token & cost tracking (cache-aware `pricing.json`). - Auto-extracted derived notes (decisions / bugs / learnings), backlinked to the session. - Curated memory (`.brain/` cold index + `CORE` + `DIGEST` injected at `SessionStart`). - `wendkeep init` (cross-platform installer) + optional `@bitbonsai/mcpvault` MCP server. <!-- Only v0.4.0+ is tagged in git (history starts here); older versions link to npm. --> [0.15.0]: https://github.com/rogersialves/wendkeep/releases/tag/v0.15.0 [0.14.0]: https://github.com/rogersialves/wendkeep/releases/tag/v0.14.0 [0.13.0]: https://github.com/rogersialves/wendkeep/releases/tag/v0.13.0 [0.12.0]: https://github.com/rogersialves/wendkeep/releases/tag/v0.12.0 [0.11.0]: https://github.com/rogersialves/wendkeep/releases/tag/v0.11.0 [0.10.0]: https://github.com/rogersialves/wendkeep/releases/tag/v0.10.0 [0.9.1]: https://github.com/rogersialves/wendkeep/releases/tag/v0.9.1 [0.9.0]: https://github.com/rogersialves/wendkeep/releases/tag/v0.9.0 [0.8.1]: https://github.com/rogersialves/wendkeep/releases/tag/v0.8.1 [0.8.0]: https://github.com/rogersialves/wendkeep/releases/tag/v0.8.0 [0.7.0]: https://github.com/rogersialves/wendkeep/releases/tag/v0.7.0 [0.6.1]: https://github.com/rogersialves/wendkeep/releases/tag/v0.6.1 [0.6.0]: https://github.com/rogersialves/wendkeep/releases/tag/v0.6.0 [0.5.0]: https://github.com/rogersialves/wendkeep/releases/tag/v0.5.0 [0.4.0]: https://github.com/rogersialves/wendkeep/releases/tag/v0.4.0 [0.3.0]: https://www.npmjs.com/package/wendkeep/v/0.3.0 [0.2.7]: https://www.npmjs.com/package/wendkeep/v/0.2.7 [0.2.0]: https://www.npmjs.com/package/wendkeep/v/0.2.0 [0.1.0]: https://www.npmjs.com/package/wendkeep/v/0.1.0