wendkeep 0.72.0 → 0.73.0

package/docs/pt-BR/commands/maintenance-and-diagnostics.md

@@ -23,7 +23,7 @@ Execute na raiz do projeto ou informe `--project`/`--vault` explicitamente.
 ## Sintaxe
 
 ```bash
-npx --no-install wendkeep doctor [--vault <cofre>]
+npx --no-install wendkeep doctor [--vault <cofre>] [--scope all|core|runtime] [--strict]
 npx --no-install wendkeep memory curate --vault <cofre>
 npx --no-install wendkeep sync-defs [--check|--reseed] --vault <cofre> --project <raiz>
 npx --no-install wendkeep theme sync --vault <cofre>
@@ -33,7 +33,10 @@ npx --no-install wendkeep --help
 
 ## Opções e códigos de saída
 
-- `doctor` é read-only; exit `0` aceita warnings recuperáveis e exit não zero indica falha.
+- `doctor` é read-only. Por padrão, exit não zero indica erro estrutural; `--strict` também torna
+  atenção de workflow, dívida reparável e memória degradada apropriadas para gate de CI/release.
+- `--scope core` verifica somente instalação, identidade, sessão e memória; `sync` usa esse escopo
+  e não falha por change ainda em andamento. `--scope runtime` isola harness/governança.
 - O `doctor` usa saída em formato humano, com blocos `[integridade]` e `[memória]`, categorias
   amigáveis e uma próxima ação copiável. O hook `vault-health.mjs` continua sendo a superfície JSON
   para automações; nenhum dos dois aplica curadoria.
@@ -44,8 +47,9 @@ npx --no-install wendkeep --help
   event IDs e checkpoint) com outbox, ledger e SHARED; não inferem saúde só pela revision atual.
 - `revision: 0` após migração válida, sem attempt v2, é saudável. Attempt `degraded` cujos eventos
   continuam duráveis na outbox/ledger é warning recuperável.
-- Attempt ambíguo, event ID perdido (ausente de ledger e outbox), estado `projected` apenas na
-  outbox ou checkpoint divergente são falhas bloqueantes.
+- Conflito semântico é `degraded` e omite somente as chaves afetadas; não bloqueia o Core. Attempt
+  causal ambíguo, event ID perdido, ledger corrompido, boundary insegura ou checkpoint divergente
+  continuam sendo falhas estruturais bloqueantes.
 - Para observabilidade de sessão, `legacy`, `degraded`, `stale` e `manifest-unproven` exigem
   reconciliação ou evidência adicional. Somente `none` fresco e `complete` fresco são saudáveis:
   frontier, checkpoint, root stat e source manifest precisam concordar.
@@ -63,6 +67,8 @@ Checklist pós-atualização:
 npx --no-install wendkeep --version
 npx --no-install wendkeep sync-defs --check --vault .MeuApp-vault --project .
 npx --no-install wendkeep doctor --vault .MeuApp-vault
+npx --no-install wendkeep doctor --scope core --vault .MeuApp-vault
+npx --no-install wendkeep doctor --scope runtime --strict --vault .MeuApp-vault
 npx --no-install wendkeep memory status --gate --vault .MeuApp-vault
 npx --no-install wendkeep memory curate --vault .MeuApp-vault
 npx --no-install wendkeep memory candidates --active --vault .MeuApp-vault
@@ -72,7 +78,8 @@ npx --no-install wendkeep cost rebuild --session <id> --json --vault .MeuApp-vau
 
 ## Resultado esperado
 
-O doctor nomeia sessões, registry, links, notas, preços, derivadas e memória como saudáveis ou
+O doctor separa `structural error`, `workflow attention`, `repairable debt` e `semantic ambiguity`,
+e nomeia sessões, registry, links, notas, preços, derivadas e memória como saudáveis ou
 fornece um comando específico de diagnóstico/reparo. Na memória, ele distingue vazio inicial
 válido, replay pendente recuperável e lifecycle perdido/divergente. Nenhum reparo é aplicado
 implicitamente nem o conteúdo privado do erro do projector é reproduzido no relatório. Na

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

@@ -6,7 +6,7 @@
 
 O Observer consolida a observabilidade de vários projetos WendKeep em um serviço local. O volume
 Docker mantém o SQLite `/data/observer.sqlite` como autoridade única para documentos, sessões,
-agentes, uso, chamadas e transcripts completos. O conteúdo fica disponível para navegação e busca
+agentes, uso e chamadas. Transcripts completos são opcionais e exigem captura explícita. O conteúdo fica disponível para navegação e busca
 no próprio container, sem depender do Obsidian para consulta.
 
 ## Quando usar
@@ -24,8 +24,9 @@ pelos hooks e pelo WendKeep local.
 
 ## Pré-requisitos
 
-Tenha os projetos inicializados com WendKeep e registre explicitamente cada projeto antes de
-iniciar o servidor HTTP. No modo local padrão não há token para configurar.
+Tenha Node.js 22.13 ou mais recente para executar o Observer SQL. O Keep Core e os demais comandos
+continuam compatíveis com Node.js 18 ou mais recente. Registre explicitamente cada projeto e defina
+`WENDKEEP_OBSERVER_TOKEN`; leituras no loopback permanecem abertas, mas toda mutação exige Bearer.
 
 ## Sintaxe
 
@@ -33,8 +34,8 @@ iniciar o servidor HTTP. No modo local padrão não há token para configurar.
 npx wendkeep observer status --data-dir <diretório> --json
 npx wendkeep observer register --project <projeto> --vault <vault> --data-dir <diretório>
 npx wendkeep observer publish --project <projeto> --vault <vault> --data-dir <diretório>
-npx wendkeep observer memory import --project <projeto> --vault <vault> --url http://127.0.0.1:8787 --json
-npx wendkeep observer serve --host 127.0.0.1 --port 8787 --data-dir <diretório>
+npx wendkeep observer memory import --project <projeto> --vault <vault> --url http://127.0.0.1:8787 --token <token> --json
+npx wendkeep observer serve --host 127.0.0.1 --port 8787 --data-dir <diretório> --token <token>
 ```
 
 ## Opções e códigos de saída
@@ -44,8 +45,9 @@ npx wendkeep observer serve --host 127.0.0.1 --port 8787 --data-dir <diretório>
 - `--project` e `--vault` identificam o projeto nos comandos `register`, `publish` e `memory import`.
 - `--host` aceita somente `127.0.0.1`, `localhost` ou `::1`; outros hosts são recusados antes do
   listen.
-- as rotas `/v1` ficam abertas no modo local padrão; mantenha `--host 127.0.0.1` e não publique a
-  porta em um endereço de rede.
+- `--token` ou `WENDKEEP_OBSERVER_TOKEN` autentica mutações; `--allow-non-loopback` falha sem token.
+- `WENDKEEP_OBSERVER_CAPTURE_LEVEL` aceita `metadata` (padrão, sem mensagens), `messages` ou
+  `full-transcript`. Caminhos locais absolutos nunca são publicados.
 - Exit `0` indica sucesso; exit `1` indica falha de configuração ou operação; o hook publisher
   também retorna `0` quando o Observer está indisponível.
 
@@ -53,7 +55,8 @@ npx wendkeep observer serve --host 127.0.0.1 --port 8787 --data-dir <diretório>
 
 ```powershell
 npx wendkeep observer register --project C:\GitHub\WendKeep --vault C:\GitHub\WendKeep\.WendKeep-vault --data-dir C:\WendKeepObserver
-npx wendkeep observer serve --host 127.0.0.1 --port 8787 --data-dir C:\WendKeepObserver
+$env:WENDKEEP_OBSERVER_TOKEN = '<token-local-forte>'
+npx wendkeep observer serve --host 127.0.0.1 --port 8787 --data-dir C:\WendKeepObserver --token $env:WENDKEEP_OBSERVER_TOKEN
 $env:WENDKEEP_OBSERVER_URL = 'http://127.0.0.1:8787'
 ```
 
@@ -66,14 +69,14 @@ docker compose -f docker/wendkeep-observer/compose.yaml up -d --build
 ## Painel web local
 
 Com o servidor em execução, abra [http://127.0.0.1:8787/](http://127.0.0.1:8787/) no navegador.
-O painel é servido pelo mesmo processo e abre diretamente, sem formulário ou token. A porta fica
+O painel é servido pelo mesmo processo e abre diretamente para consultas, sem formulário ou token. A porta fica
 presa ao loopback do computador; não coloque o endereço em uma interface de rede.
 
 O painel mostra a lista multi-projeto, versão, saúde, sessão mais recente, change ativa, contagem
 de changes e data da última captura. Ao abrir um projeto, o workspace oferece Overview, Consumo,
 Sessões, Memória, Changes e Sincronização. A aba Consumo mostra custo total, tokens por categoria,
 agentes principais, subagentes, provedores, modelos, tendência diária, cobertura histórica e
-chamadas com prompt, resposta e transcript completo. Os estados de carregamento, vazio, servidor
+chamadas conforme o nível de captura escolhido. Os estados de carregamento, vazio, servidor
 indisponível, conflito, modelo sem tarifa e dados desatualizados ficam visíveis, e a atualização
 pode ser manual ou automática a cada 15 segundos.
 
@@ -85,7 +88,8 @@ Se o navegador mostrar a tela mas a lista falhar, confirme a saúde em
 `register` grava `project_id`, nome, versão e data de registro. `publish` lê o vault local,
 produz o snapshot e envia eventos idempotentes para o SQLite com o conteúdo integral das sessões,
 decisões, bugs, aprendizados, specs, changes, CORE, DIGEST, SHARED_MEMORY, estado do brain,
-sessões de agentes, rollups de custo, chamadas e transcripts. O container grava tudo em
+sessões de agentes, rollups de custo e chamadas. Mensagens e transcripts só são enviados nos
+níveis de captura que os habilitam. O container grava tudo em
 `/data/observer.sqlite`; não monta `C:\GitHub` nem qualquer `.WendKeep-vault`. Markdown é aceito
 somente como conteúdo de uma coluna SQL e volta a existir como arquivo apenas pela exportação
 read-only sob demanda. `memory import` faz a carga inicial e retorna a paridade por arquivo e hash.
@@ -106,7 +110,9 @@ corpo antes de ingerir. O outbox é transporte temporário, não autoridade.
 - `project_not_registered`: rode `observer register` antes de publicar.
 - `host loopback`: troque `0.0.0.0` ou endereço LAN por `127.0.0.1`.
 - Outbox pendente: o serviço estava indisponível; preserve `.brain/observer-outbox/` e
-  `.brain/observer-sql-outbox/` e repita o publisher. Não apague eventos manualmente.
+  `.brain/observer-sql-outbox/` e repita o publisher. Adicione também
+  `.brain/observer-sql-state.json` e `.brain/observer-sql-outbox/` ao ignore do Vault. Não apague eventos manualmente.
+- `WENDKEEP_OBSERVER_NODE_UNSUPPORTED`: execute o Observer em Node.js 22.13 ou mais recente.
 - Se a memória ou o consumo ficarem incompletos, verifique a tela Sincronização, preserve o
   outbox e rode `observer memory import` para reconstruir a carga a partir do vault.
 

package/docs/pt-BR/commands/operating-profiles.md

@@ -1,4 +1,4 @@
-# Perfis de Operação e FLOW
+# Perfis de Operação, work kind, FLOW e delivery
 
 **PT-BR** · [English](../../en/commands/operating-profiles.md)
 
@@ -17,6 +17,8 @@ deliberado e executa as validações e gates próprios daquele comando.
 Use `profile use` para uma seleção humana persistente e `profile route` para o harness registrar a
 rota temporária da implementação atual. Use `FLOW` para manutenção local, reversível e com
 `spec_impact:none` que caiba num microcontrato Executar → Validar, sem change.
+Use `delivery` para merge, push, tag e publicação de comportamento já aprovado: risco operacional
+exige autorização/receipt, não uma nova change ou spec.
 
 ## Quando não usar
 
@@ -55,6 +57,10 @@ npx wendkeep flow status [<id>]
 npx wendkeep flow show <id> [--session <id>]
 npx wendkeep flow finish <id> [--session <id>]
 npx wendkeep flow promote <id> [--change-slug <slug>] [--session <id>]
+npx wendkeep delivery start [id] --allow <capability> [--source-change <slug>] [--source-commit <sha>]
+npx wendkeep delivery status [id]
+npx wendkeep delivery finish [id] [--target <ref>] [--ci-url <url>] [--version <x.y.z>] [--npm-integrity <sha512>] [--release-url <url>]
+npx wendkeep delivery abandon [id] --reason <texto>
 ```
 
 Todos os subcomandos FLOW também aceitam `--project <path>`, `--vault <path>` e `--json`.
@@ -85,7 +91,7 @@ independentes.
 |---|---|---|
 | `OFF` | harness nativo da LLM | Governança automática desligada; Keep Core e comandos explícitos disponíveis. |
 | `FLOW` | E → V | Microcontrato com baseline Git, allowlist, sensores e recibo, sem change. |
-| `GUIDE` | P → E → V | Change compacta; política reconhecida para evolução compatível. |
+| `GUIDE` | P → E → V | `change new --guide`; objetivo, aceite, áreas, testes e resultado; sem design/spec/ADR automático quando `contract_impact:none`. |
 | `GOVERN` | P → R → E → V | Loop a2 atual e fallback conservador. |
 | `ASSURE` | P → R → E → V → C | Governança acrescida de confirmação e handoff. |
 
@@ -163,6 +169,14 @@ harness nativo da LLM.
   dono; contrato, reserva, attempts, recibo e origem permanecem semanticamente vinculados. O
   perdedor permanece ativo e pode repetir com `--change-slug`. Retries retomam idempotentemente a
   mesma promoção em vez de criar outra change. Não existe `--force` no FLOW.
+- Work kind (`inspection`, `maintenance`, `implementation`, `delivery`, `recovery`), perfil,
+  `contract_impact` e `operation_risk` são dimensões independentes. `delivery start` captura repo,
+  branch/worktree, SHA, change de origem e capabilities em `.brain/runtime/deliveries/`; não cria
+  pasta em `08-Mudanças`, delta, spec ou ADR.
+- `delivery finish` exige working tree limpa, comprova que o target contém o commit de origem e,
+  para capability `publish`, exige CI, versão, integridade npm e GitHub Release. O receipt é
+  append-only em `.brain/runtime/delivery-receipts.jsonl`. Se código/config precisar mudar, a
+  delivery para com `WENDKEEP_DELIVERY_IMPLEMENTATION_REQUIRED` e o trabalho volta a implementation.
 - Exit `0` indica consulta ou transição concluída; exit `1` indica política/sensor vermelho; exit
   `2` indica perfil, sessão, flow ou argumentos inválidos, sem mutação parcial.
 
@@ -228,13 +242,22 @@ novamente com um destino explícito:
 npx wendkeep flow promote $flowId --change-slug outro-slug
 ```
 
+Entregar uma versão já aprovada sem fabricar outra change:
+
+```bash
+npx wendkeep delivery start release-0-73-0 --source-change governanca-proporcional --allow git:merge --allow git:push --allow publish
+npx wendkeep delivery status release-0-73-0
+npx wendkeep delivery finish release-0-73-0 --target v0.73.0 --ci-url <run> --version 0.73.0 --npm-integrity <sha512> --release-url <release>
+```
+
 ## Resultado esperado
 
 Trocar o perfil não cria outra sessão nem interrompe o Vault. Em `OFF`, a memória e as lessons
 continuam injetadas e o Stop continua persistindo sessão/memória, mas router, skill gate,
 change context/warn/nag/guard e captura de plano automáticos ficam inativos. Os comandos explícitos
 continuam disponíveis e executam seus próprios contratos. Um FLOW concluído deixa recibo durável e
-consultável; um FLOW promovido passa a seguir o lifecycle normal de change.
+consultável; um FLOW promovido passa a seguir o lifecycle normal de change. Uma delivery concluída
+deixa receipt sem gerar ADR; GUIDE compacto arquiva o resultado sem spec/design/ADR artificiais.
 
 ## Erros comuns e diagnóstico
 
@@ -253,6 +276,8 @@ consultável; um FLOW promovido passa a seguir o lifecycle normal de change.
   repita `flow finish` ou `flow promote`; o marcador idempotente impede duplicação.
 - Sujeira anterior apareceu no diff: ela deve coincidir com o fingerprint inicial e nunca pode ser
   atribuída silenciosamente ao FLOW.
+- Delivery sem `--allow`, working tree suja ou evidência de publish incompleta: retome a
+  implementation real ou forneça os receipts; não crie uma change apenas para publicar.
 
 ## Próximos passos
 

package/docs/pt-BR/commands/sessions-and-import.md

@@ -26,11 +26,11 @@ Claude/Codex e um vault vinculado ao projeto correto.
 ## Sintaxe
 
 ```bash
-npx wendkeep hook <nome>
+npx --no-install wendkeep hook <nome>
 npx wendkeep session list
 npx wendkeep session show <id>
 npx wendkeep session use <id>
-npx wendkeep hook session-backfill --session <id> [--write]
+npx --no-install wendkeep hook session-backfill --session <id> [--write]
 npx wendkeep import [opções]
 ```
 
@@ -95,8 +95,8 @@ npx wendkeep import [opções]
 ```bash
 npx wendkeep session list
 npx wendkeep session show 019abc-session-id
-npx wendkeep hook session-backfill --session 019abc-session-id
-npx wendkeep hook session-backfill --session 019abc-session-id --write
+npx --no-install wendkeep hook session-backfill --session 019abc-session-id
+npx --no-install wendkeep hook session-backfill --session 019abc-session-id --write
 npx wendkeep import --source codex --since 2026-07-01 --dry-run --json
 ```
 

package/hooks/brain-inject.mjs

@@ -29,9 +29,9 @@ function processRouter(localeId) {
   if (localeId === 'en') {
     return [
       '<wk_process>',
-      'Spec-driven process (mandatory for any non-trivial task): INVOKE the wk-workflow Skill BEFORE editing any file.',
-      '1. Plan: invoke the wk-brainstorming Skill (approved design) → wk-planning (task plan).',
-      '2. Record: `wendkeep change new <slug>` and FILL proposta/design/tasks. Resolve `spec_impact`: `required` needs `specs/<capability>/spec.md` + [req:ID]; `none` needs a reason. Never leave pending/placeholders.',
+      'Proportional process: INVOKE the wk-workflow Skill BEFORE editing any file.',
+      '1. Classify work kind independently from profile: inspection, maintenance, implementation, delivery, or recovery.',
+      '2. Delivery of approved code uses `wendkeep delivery start/finish` and a receipt, without a new change/spec. For implementation, use wk-brainstorming + wk-planning, declare spec_impact, then select FLOW, `wendkeep change new --guide`, or GOVERN/ASSURE according to contract impact.',
       '3. Implement: wk-tdd per task; tick `- [x]` as you finish. Something broke? wk-debugging.',
       '4. Close: `wendkeep verify` (+ `--deep` + the wk-verify Skill) → `wendkeep change archive`.',
       'NEVER `archive --force` on your own — a red gate means pending work; --force is the user\'s call, not yours. Dead end? `wendkeep change abandon`.',
@@ -40,9 +40,9 @@ function processRouter(localeId) {
   }
   return [
     '<wk_process>',
-    'Processo spec-driven (obrigatório em tarefa não-trivial): INVOQUE a Skill wk-workflow ANTES de editar qualquer arquivo.',
-    '1. Planejar: invoque a Skill wk-brainstorming (design aprovado) → wk-planning (plano de tarefas).',
-    '2. Registrar: `wendkeep change new <slug>` e PREENCHA proposta/design/tarefas. Resolva `spec_impact`: `required` exige `specs/<capability>/spec.md` + [req:ID]; `none` exige justificativa. Nunca deixe pending/placeholders.',
+    'Processo proporcional: INVOQUE a Skill wk-workflow ANTES de editar qualquer arquivo.',
+    '1. Classifique work kind independentemente do perfil: inspection, maintenance, implementation, delivery ou recovery.',
+    '2. Entrega de código aprovado usa `wendkeep delivery start/finish` e receipt, sem nova change/spec. Em implementation, use wk-brainstorming + wk-planning, declare spec_impact e escolha FLOW, `wendkeep change new --guide` ou GOVERN/ASSURE conforme impacto de contrato.',
     '3. Implementar: wk-tdd por tarefa; marque `- [x]` ao concluir. Quebrou algo? wk-debugging.',
     '4. Fechar: `wendkeep verify` (+ `--deep` + Skill wk-verify) → `wendkeep change archive`.',
     'PROIBIDO `archive --force` por conta própria — gate vermelho significa trabalho pendente; --force é decisão do usuário, não sua. Beco sem saída? `wendkeep change abandon`.',

package/hooks/change-context.mjs

@@ -14,6 +14,7 @@ import {
   profileSentinelId,
   resolveHookOperatingProfile,
 } from './operating-profile-runtime.mjs';
+import { activeDelivery } from '../src/delivery.mjs';
 
 // Conservador de propósito: verbos de tarefa comuns (pt+en) + tamanho mínimo. Falso-negativo
 // custa só o nudge; falso-positivo em pergunta curta viraria ruído.
@@ -29,6 +30,16 @@ export function buildChangePing(vaultBase, sessionId, prompt = '', changeSlug =
   const policy = hookProfilePolicy(profile);
   if (!policy.harness) return null;
   const sentinelId = profileSentinelId(sessionId, profile);
+  const delivery = activeDelivery(vaultBase);
+  if (delivery) {
+    const hash = `delivery:${delivery.id}`;
+    if (readSentinel(vaultBase, 'ctx', sentinelId) === hash) return null;
+    writeSentinel(vaultBase, 'ctx', sentinelId, hash);
+    return {
+      context: `<active_delivery>Delivery ${delivery.id} ativa; capabilities: ${delivery.route.operation_risk.join(', ')}. Risco operacional autorizado sem nova change/spec.</active_delivery>`,
+      hash,
+    };
+  }
   const st = changeCtxState(vaultBase);
   if (st) {
     if (readSentinel(vaultBase, 'ctx', sentinelId) === st.hash) return null;

package/hooks/change-core.mjs

@@ -18,12 +18,15 @@ export function changeDirRel(slug, vaultBase) {
   return join(getLocale(vaultBase).folders.changes, slug);
 }
 
-export function renderChangeScaffold({ slug, sessionRel, dateStr, locale = 'pt-BR', simple = false }) {
+export function renderChangeScaffold({ slug, sessionRel, dateStr, locale = 'pt-BR', simple = false, guide = false }) {
   const en = locale === 'en';
   const source = sessionRel ? `\n  - "${wikilinkFromRel(sessionRel)}"` : ' []';
-  const impact = simple ? 'none' : 'pending';
-  const impactReason = simple
-    ? (en ? 'Simple change with no product-contract impact.' : 'Mudança simples sem impacto no contrato do produto.')
+  const compact = simple || guide;
+  const impact = compact ? 'none' : 'pending';
+  const impactReason = compact
+    ? (guide
+      ? (en ? 'Compact GUIDE change with no product-contract impact.' : 'Change GUIDE compacta sem impacto no contrato do produto.')
+      : (en ? 'Simple change with no product-contract impact.' : 'Mudança simples sem impacto no contrato do produto.'))
     : '';
   const proposta = `---
 type: change
@@ -34,14 +37,18 @@ cssclasses:
 tags:
   - mudanca
 source:${source}
-spec_impact: ${impact}
+${guide ? 'work_kind: implementation\nprofile: GUIDE\ncontract_impact: none\n' : ''}spec_impact: ${impact}
 spec_impact_reason: ${JSON.stringify(impactReason)}
 specs: []
 ---
 
 # ${slug}
 
-${en ? '## Why\n\n(reason for the change)\n\n## What changes\n\n(scope of the change)' : '## Por quê\n\n(motivo da mudança)\n\n## O que muda\n\n(escopo da mudança)'}
+${guide
+    ? (en
+      ? '## Objective\n\n(objective)\n\n## Acceptance criteria\n\n- [ ] (acceptance criterion)\n\n## Affected areas\n\n(affected areas)'
+      : '## Objetivo\n\n(objetivo)\n\n## Critérios de aceite\n\n- [ ] (critério de aceite)\n\n## Áreas afetadas\n\n(áreas afetadas)')
+    : (en ? '## Why\n\n(reason for the change)\n\n## What changes\n\n(scope of the change)' : '## Por quê\n\n(motivo da mudança)\n\n## O que muda\n\n(escopo da mudança)')}
 `;
   // Hub backlink: design/tarefas link the change's proposta so no generated artifact is a
   // graph island. Full-path (never basename — proposta/design exist in every change) so the
@@ -54,11 +61,13 @@ ${hubLink}
 
 ${en ? '## Approach\n\n(technical approach)' : '## Abordagem\n\n(abordagem técnica)'}
 `;
-  const tarefas = `# ${slug} — ${en ? 'tasks' : 'tarefas'}
+  const tarefas = `# ${slug} — ${guide ? (en ? 'validation' : 'validação') : (en ? 'tasks' : 'tarefas')}
 
 ${hubLink}
 
-- [ ] 1.1 ${en ? '(first task)' : '(primeira tarefa)'}
+${guide
+    ? `${en ? '## Tests' : '## Testes'}\n\n- [ ] 1.1 ${en ? '(test or validation)' : '(teste ou validação)'}\n\n${en ? '## Result' : '## Resultado'}\n\n${en ? '(result)' : '(resultado)'}`
+    : `- [ ] 1.1 ${en ? '(first task)' : '(primeira tarefa)'}`}
 `;
   const reqHeading = en ? 'Requirement' : 'Requisito';
   const specDelta = `## ADDED Requirements
@@ -76,11 +85,29 @@ ${en ? '(behaviour / scenarios)' : '(comportamento / cenários)'}
 // proposta/design/tarefas still carry these was never actually planned — archiving it mints a
 // bogus ADR and pollutes _arquivo (seen in production). The archive gate blocks on them.
 const SCAFFOLD_MARKERS = [
-  ['proposta.md', ['(motivo da mudança)', '(escopo da mudança)', '(reason for the change)', '(scope of the change)']],
+  ['proposta.md', [
+    '(motivo da mudança)', '(escopo da mudança)', '(reason for the change)', '(scope of the change)',
+    '(objetivo)', '(objective)', '(critério de aceite)', '(acceptance criterion)',
+    '(áreas afetadas)', '(affected areas)',
+  ]],
   ['design.md', ['(abordagem técnica)', '(technical approach)']],
-  ['tarefas.md', ['(primeira tarefa)', '(first task)']],
+  ['tarefas.md', [
+    '(primeira tarefa)', '(first task)', '(teste ou validação)', '(test or validation)',
+    '(resultado)', '(result)',
+  ]],
 ];
 
+export function isGuideCompactChange(dir) {
+  try {
+    const proposal = readFileSync(join(dir, 'proposta.md'), 'utf8');
+    return /^profile:\s*GUIDE\s*$/mi.test(proposal)
+      && /^contract_impact:\s*none\s*$/mi.test(proposal)
+      && /^spec_impact:\s*none\s*$/mi.test(proposal);
+  } catch {
+    return false;
+  }
+}
+
 export function scaffoldPlaceholders(dir) {
   const found = [];
   for (const [file, markers] of SCAFFOLD_MARKERS) {
@@ -164,12 +191,13 @@ export function assertChangeScaffoldTargetsSafe(vaultBase, slug, {
   return { dir, rel: changeDirRel(slug, vaultBase) };
 }
 
-export function newChange(vaultBase, slug, { sessionRel = '', dateStr, simple = false }) {
+export function newChange(vaultBase, slug, { sessionRel = '', dateStr, simple = false, guide = false }) {
+  const compact = simple || guide;
   const loc = getLocale(vaultBase);
-  const { dir } = assertChangeScaffoldTargetsSafe(vaultBase, slug, { simple });
+  const { dir } = assertChangeScaffoldTargetsSafe(vaultBase, slug, { simple: compact });
   const existed = existsSync(join(dir, 'proposta.md'));
   mkdirVaultPath(vaultBase, dir, { label: 'destino da change' });
-  const files = renderChangeScaffold({ slug, sessionRel, dateStr, locale: loc.id, simple });
+  const files = renderChangeScaffold({ slug, sessionRel, dateStr, locale: loc.id, simple: compact, guide });
   const write = (name, content) => {
     const f = join(dir, name);
     const checked = assertVaultPathSafe(vaultBase, f, {
@@ -186,7 +214,7 @@ export function newChange(vaultBase, slug, { sessionRel = '', dateStr, simple =
   // No `specs/exemplo` placeholder: it was pure noise (always hand-deleted). When a change
   // resolves `spec_impact: required`, the author writes `specs/<capability>/spec.md` directly
   // — the delta format lives in the wk-workflow skill (and `renderChangeScaffold().specDelta`).
-  if (!simple) {
+  if (!compact) {
     write('design.md', files.design);
   }
   if (!existed) captureSpecBaseline(vaultBase, dir);
@@ -512,6 +540,7 @@ export function archiveChange(vaultBase, slug, { gate = gateGreen, dateStr, adrN
   const loc = getLocale(vaultBase);
   const chDir = loc.folders.changes;
   const src = join(vaultBase, chDir, slug);
+  const createAdr = !isGuideCompactChange(src);
   const verdict = gate(src);
   if (!verdict.ok) return { ok: false, failing: verdict.failing || [] };
 
@@ -524,14 +553,17 @@ export function archiveChange(vaultBase, slug, { gate = gateGreen, dateStr, adrN
   const adrRel = join(adrDirRel, `ADR-${num}-${slug}.md`);
 
   // Validate every later mutation target before spec promotion can change living state.
-  const [checkedSource, checkedDestination] = assertVaultPathsSafe(vaultBase, [
+  const mutationTargets = [
     { path: src, allowMissing: false, expectedType: 'directory', label: 'change a arquivar' },
     { path: destAbs, expectedType: 'directory', label: 'destino da change arquivada' },
     { path: archiveRoot, expectedType: 'directory', label: 'raiz de changes arquivadas' },
-    { path: join(vaultBase, adrDirRel), expectedType: 'directory', label: 'pasta mensal de ADR' },
-    { path: join(vaultBase, adrRel), expectedType: 'file', label: 'ADR da change arquivada' },
     { path: join(vaultBase, POINTER), expectedType: 'file', label: 'ponteiro CURRENT_CHANGE.md' },
-  ]);
+    ...(createAdr ? [
+      { path: join(vaultBase, adrDirRel), expectedType: 'directory', label: 'pasta mensal de ADR' },
+      { path: join(vaultBase, adrRel), expectedType: 'file', label: 'ADR da change arquivada' },
+    ] : []),
+  ];
+  const [checkedSource, checkedDestination] = assertVaultPathsSafe(vaultBase, mutationTargets);
   assertVaultPathsSafe(vaultBase, [
     { path: join(checkedSource.target, 'proposta.md'), expectedType: 'file', label: 'proposta da change' },
     { path: join(checkedSource.target, 'tarefas.md'), expectedType: 'file', label: 'tarefas da change' },
@@ -597,7 +629,7 @@ export function archiveChange(vaultBase, slug, { gate = gateGreen, dateStr, adrN
 
   // ADR goes in the same dated month folder as session-derived decisions (04-Decisões/ano/MM-MMM/)
   // — not the year root — so all ADRs sit together in the vault's convention.
-  mkdirVaultPath(vaultBase, join(vaultBase, adrDirRel), { label: 'pasta mensal de ADR' });
+  if (createAdr) mkdirVaultPath(vaultBase, join(vaultBase, adrDirRel), { label: 'pasta mensal de ADR' });
   const capLine = promoted.length
     ? `\n\nCapabilities: ${promoted.map((c) => wikilinkFromRel(join(loc.folders.specs, c))).join(', ')}.`
     : '';
@@ -605,7 +637,7 @@ export function archiveChange(vaultBase, slug, { gate = gateGreen, dateStr, adrN
   // Rastro auditável (0.31.0): um archive forçado ou sem prova declarada fica marcado no ADR.
   const flagLines = `${adrFlags.forced ? '\nforced: true' : ''}${adrFlags.trivial ? '\ntrivial: true' : ''}`;
   const forcedNote = adrFlags.forced ? '\n\n> ⚠️ Arquivada com --force — havia tarefa(s) aberta(s) pulada(s) no gate.' : '';
-  writeVaultFileSync(vaultBase, join(vaultBase, adrRel), `---
+  if (createAdr) writeVaultFileSync(vaultBase, join(vaultBase, adrRel), `---
 type: decision
 status: accepted
 date: ${dateStr}${flagLines}
@@ -625,7 +657,7 @@ Mudança ${changeWikilink} concluída e arquivada.${capLine}${reqLine}${forcedNo
   // Only clear the pointer when the archived change IS the active one — archiving some other
   // slug explicitly must not blank the pointer of a different, still-active change.
   if (activeChange(vaultBase) === slug) clearActiveChange(vaultBase);
-  return { ok: true, failing: [], archivedRel: destRel, adrRel, promoted, specWarnings, linksRewritten };
+  return { ok: true, failing: [], archivedRel: destRel, adrRel: createAdr ? adrRel : '', promoted, specWarnings, linksRewritten };
 }
 
 // --- reescrita de wikilinks pós-move (0.35.0) ----------------------------------

package/hooks/change-warn.mjs

@@ -12,6 +12,7 @@ import {
   profileSentinelId,
   resolveHookOperatingProfile,
 } from './operating-profile-runtime.mjs';
+import { activeDelivery } from '../src/delivery.mjs';
 
 const CODE_EXT = /\.(ts|tsx|js|jsx|mjs|cjs|py|prisma|sql|go|rs|java|cs)$/i;
 
@@ -32,6 +33,7 @@ export function warnDecision(filePath, {
   if (!policy.requiresChange) return null;
   if (!filePath || !isCodeFile(filePath)) return null;
   if (activeChange(vaultBase)) return null;
+  if (activeDelivery(vaultBase)) return null;
   const abs = norm(isAbsolute(filePath) ? filePath : resolve(cwd, filePath));
   // Dentro do vault (NTFS é case-insensitive) ou em dirs de config de agente: não é código do projeto.
   if (abs.toLowerCase().startsWith(`${norm(resolve(vaultBase)).toLowerCase()}/`)) return null;

package/hooks/harness-doctor.mjs

@@ -102,6 +102,8 @@ export function checkHarness(vaultBase, projectRoot) {
   const CHANGES_DIR = loc.folders.changes;
   const errors = [];
   const warnings = [];
+  const attention = [];
+  const repairable = [];
 
   // 1. wendkeep.sensors.json well-formed.
   const sensorsPath = join(projectRoot, 'wendkeep.sensors.json');
@@ -114,7 +116,7 @@ export function checkHarness(vaultBase, projectRoot) {
   }
 
   const specState = checkSpecsState(vaultBase);
-  if (specState.missing) warnings.push('SPECS_STATE ausente — rode `wendkeep spec migrate`; 07-Specs deve ser gerado/read-only');
+  if (specState.missing) repairable.push('SPECS_STATE ausente — rode `wendkeep spec migrate`; 07-Specs deve ser gerado/read-only');
   else if (!specState.ok) errors.push(`07-Specs alterado fora do WendKeep: ${specState.changed.join(', ')} — mova a alteração para 08-Mudanças/<change>/specs`);
 
   // 2/3. Changes: malformed dirs; the active change's deltas add to knownReqs.
@@ -127,12 +129,18 @@ export function checkHarness(vaultBase, projectRoot) {
     try { entries = readdirSync(dir); } catch { continue; } // a file, not a change dir
     if (!entries.includes('proposta.md')) { errors.push(`change sem proposta.md: ${name}`); continue; }
     const impact = validateSpecImpact(dir);
-    errors.push(...impact.errors.map((e) => `${name}: ${e}`));
-    warnings.push(...impact.warnings.map((w) => `${name}: ${w}`));
+    for (const error of impact.errors) {
+      const rendered = `${name}: ${error}`;
+      if (/spec_impact pending/i.test(error)) attention.push(rendered);
+      else errors.push(rendered);
+    }
+    attention.push(...impact.warnings.map((w) => `${name}: ${w}`));
     let tasks = [];
     let tarefasMd = '';
     try { tarefasMd = readFileSync(join(dir, 'tarefas.md'), 'utf8'); tasks = parseTasks(tarefasMd); } catch { /* sem tarefas */ }
     const reqIds = [...new Set(tasks.flatMap((t) => t.reqs ?? []))];
+    const openTasks = tasks.filter((task) => !task.done);
+    if (openTasks.length) attention.push(`${name}: ${openTasks.length} tarefa(s) aberta(s)`);
     const effective = buildEffectiveRequirementPackage(vaultBase, dir, reqIds);
     errors.push(...effective.errors.map((e) => `${name}: spec efetiva inválida: ${e}`));
     if (effective.missing.length) errors.push(`req órfão em ${name}: ${effective.missing.map((id) => `[req:${id}]`).join(', ')} não existe na spec efetiva`);
@@ -140,7 +148,7 @@ export function checkHarness(vaultBase, projectRoot) {
     try { verdict = JSON.parse(readFileSync(join(dir, 'verdict.json'), 'utf8')); } catch { /* sem verdict */ }
     if (verdict && reqIds.length) {
       const v = evaluateVerdict(verdict, reqIds, { tasksHash: tasksHashOf(tarefasMd), effectiveSpecHash: effective.hash });
-      if (!v.ok) warnings.push(`verdict stale/incompleto em ${name}${v.missing.length ? `: falta cobrir ${v.missing.join(', ')}` : ''}`);
+      if (!v.ok) attention.push(`verdict stale/incompleto em ${name}${v.missing.length ? `: falta cobrir ${v.missing.join(', ')}` : ''}`);
     }
   }
 
@@ -152,7 +160,7 @@ export function checkHarness(vaultBase, projectRoot) {
     }
   }
 
-  return { errors, warnings };
+  return { errors, warnings, attention, repairable };
 }
 
 // --- diagnóstico de links do grafo (read-only, reusa os reparos em dry-run) -----

package/hooks/understand-inject.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// understand-inject — SessionStart hook (agent-agnostic, run via `npx wendkeep hook
+// understand-inject — SessionStart hook (agent-agnostic, run via `npx --no-install wendkeep hook
 // understand-inject`). If the Understand-Anything domain graph has been generated
 // (`.understand-anything/knowledge-graph.json` at the project root), inject a cheap
 // slice of it into the session; otherwise stay silent. Never breaks the session.

package/hooks/vault-health.mjs

@@ -504,7 +504,7 @@ export function checkMemoryBundle(vaultBase, { registry } = {}) {
       ? '1 conflito ativo'
       : `${activeConflicts.length} conflitos ativos`;
     const purposes = groupConflictPurposes(activeConflicts).join('; ');
-    failures.push(`${label} (${purposes}). Existem versões concorrentes e nenhum dado foi escolhido automaticamente. Conflito semântico exige curadoria humana; memory repair não escolhe vencedor. Próximo passo: ${memoryCurateCommand(vaultBase)}. Inventário avançado: ${memoryCandidatesCommand(vaultBase)}.`);
+    warnings.push(`${label} (${purposes}). Existem versões concorrentes e nenhum dado foi escolhido automaticamente. Conflito semântico degrada somente as chaves afetadas e exige curadoria humana; memory repair não escolhe vencedor. Próximo passo: ${memoryCurateCommand(vaultBase)}. Inventário avançado: ${memoryCandidatesCommand(vaultBase)}.`);
   }
   if (outbox.count) warnings.push(`${outbox.count} evento(s) pendente(s) na outbox; execute o projector quando seguro.`);
   if (ordinaryCandidates.length) warnings.push(`${ordinaryCandidates.length} candidate(s) aguardando curadoria humana.`);
@@ -514,7 +514,7 @@ export function checkMemoryBundle(vaultBase, { registry } = {}) {
   const semantic = bundle.semantic || {};
   return {
     ok,
-    status: ok ? (warnings.length ? 'warning' : 'healthy') : 'blocked',
+    status: ok ? (activeConflicts.length ? 'degraded' : warnings.length ? 'warning' : 'healthy') : 'blocked',
     failures,
     warnings,
     metrics: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wendkeep",
-  "version": "0.72.0",
+  "version": "0.73.0",
   "description": "Vault-first persistent memory for AI coding agents, with an optional profile-aware governance runtime: OFF, FLOW, GUIDE, GOVERN, or ASSURE. Local-first and agent-agnostic (Claude Code, Codex, Cursor…).",
   "type": "module",
   "workspaces": [
@@ -41,10 +41,12 @@
     "node": ">=18"
   },
   "scripts": {
-    "check": "node --check scripts/release.mjs && node --check scripts/release-plan.mjs && node --check bin/wendkeep.mjs && node --check packages/cli/src/index.mjs && node --check src/init.mjs && node --check src/doctor.mjs && node --check src/project-vault.mjs && node --check src/observer-snapshot.mjs && node --check src/observer-store.mjs && node --check src/observer-memory.mjs && node --check src/observer-memory-publish.mjs && node --check src/observer-sql-store.mjs && node --check src/observer-sql-migrate.mjs && node --check src/observer-sql-publish.mjs && node --check src/observer-transcript-store.mjs && node --check src/observer-server.mjs && node --check src/observer.mjs && node --check src/observer-publish.mjs && node --check src/operating-profile.mjs && node --check src/profile.mjs && node --check src/flow.mjs && node --check web/observer/app.mjs && node --check hooks/observer-publish.mjs && node --check hooks/operating-profile-runtime.mjs && node --check hooks/operating-profile-task-store.mjs && node --check hooks/flow-core.mjs && node --check hooks/flow-protected-policy.mjs && node --check hooks/git-snapshot.mjs && node --check hooks/vault-path-safety.mjs && node --check hooks/vault-runtime-store.mjs && node --check packages/harness/src/index.mjs && node --check packages/harness/src/flow-store.mjs && node --check packages/harness/src/operating-profile.mjs && node --check packages/harness/src/sensors-core.mjs && node --check packages/integrations/src/host-hooks.mjs && node --check packages/integrations/src/hook-envelope.mjs && node --check packages/integrations/src/prompt-content.mjs && node --check packages/integrations/src/transcript-usage.mjs && node --check packages/integrations/src/transcripts.mjs && node --check packages/integrations/src/session-identity.mjs && node --check packages/integrations/src/index.mjs && node --check packages/mcp/src/config.mjs && node --check packages/mcp/src/index.mjs && node --check packages/vault/src/index.mjs && node --check packages/vault/src/project-vault.mjs && node --check packages/vault/src/vault-path-safety.mjs && node --check packages/vault/src/locale.mjs && node --check packages/vault/src/memory-schema.mjs && node --check packages/vault/src/memory-mode.mjs && node --check packages/vault/src/memory-handoff.mjs && node --check packages/vault/src/memory-store.mjs && node --check packages/vault/src/validate-core.mjs && node --check packages/vault/src/validate-memory.mjs",
+    "check": "node --check scripts/release.mjs && node --check scripts/release-plan.mjs && node --check scripts/release-provenance.mjs && node --check scripts/run-scope.mjs && node --check src/release-provenance.mjs && node --check bin/wendkeep.mjs && node --check packages/cli/src/index.mjs && node --check src/init.mjs && node --check src/doctor.mjs && node --check src/project-vault.mjs && node --check src/observer-auth.mjs && node --check src/observer-privacy.mjs && node --check src/observer-snapshot.mjs && node --check src/observer-store.mjs && node --check src/observer-memory.mjs && node --check src/observer-memory-publish.mjs && node --check src/observer-sql-store.mjs && node --check src/observer-sql-migrate.mjs && node --check src/observer-sql-publish.mjs && node --check src/observer-transcript-store.mjs && node --check src/observer-server.mjs && node --check src/observer.mjs && node --check src/observer-publish.mjs && node --check src/operating-profile.mjs && node --check src/profile.mjs && node --check src/flow.mjs && node --check src/work-kind.mjs && node --check src/delivery.mjs && node --check web/observer/app.mjs && node --check hooks/observer-publish.mjs && node --check hooks/operating-profile-runtime.mjs && node --check hooks/operating-profile-task-store.mjs && node --check hooks/flow-core.mjs && node --check hooks/flow-protected-policy.mjs && node --check hooks/git-snapshot.mjs && node --check hooks/vault-path-safety.mjs && node --check hooks/vault-runtime-store.mjs && node --check packages/harness/src/index.mjs && node --check packages/harness/src/flow-store.mjs && node --check packages/harness/src/operating-profile.mjs && node --check packages/harness/src/sensors-core.mjs && node --check packages/integrations/src/host-hooks.mjs && node --check packages/integrations/src/hook-envelope.mjs && node --check packages/integrations/src/prompt-content.mjs && node --check packages/integrations/src/transcript-usage.mjs && node --check packages/integrations/src/transcripts.mjs && node --check packages/integrations/src/session-identity.mjs && node --check packages/integrations/src/index.mjs && node --check packages/mcp/src/config.mjs && node --check packages/mcp/src/index.mjs && node --check packages/vault/src/index.mjs && node --check packages/vault/src/project-vault.mjs && node --check packages/vault/src/vault-path-safety.mjs && node --check packages/vault/src/locale.mjs && node --check packages/vault/src/memory-schema.mjs && node --check packages/vault/src/memory-mode.mjs && node --check packages/vault/src/memory-handoff.mjs && node --check packages/vault/src/memory-store.mjs && node --check packages/vault/src/validate-core.mjs && node --check packages/vault/src/validate-memory.mjs",
     "test": "node --test --test-concurrency=2",
+    "test:core": "node scripts/run-scope.mjs core",
     "release": "node scripts/release.mjs",
     "release:dry": "node scripts/release.mjs --dry-run",
+    "release:provenance": "node scripts/release-provenance.mjs",
     "prepack": "node scripts/readme-pack.mjs pre",
     "postpack": "node scripts/readme-pack.mjs post"
   },
@@ -70,7 +72,6 @@
     "url": "https://github.com/rogersialves/wendkeep/issues"
   },
   "devDependencies": {
-    "acorn": "^8.18.0",
-    "wendkeep": "^0.69.0"
+    "acorn": "^8.18.0"
   }
 }