wendkeep 0.72.1 → 0.74.0

package/docs/en/commands/operating-profiles.md

@@ -1,4 +1,4 @@
-# Operating profiles and FLOW
+# Operating profiles, work kind, FLOW, and delivery
 
 **English** · [Português](../../pt-BR/commands/operating-profiles.md)
 
@@ -17,6 +17,8 @@ opt-in and runs that command's own validations and gates.
 Use `profile use` for a persistent human selection and `profile route` for the harness to record
 the temporary route for the current implementation. Use `FLOW` for local, reversible
 `spec_impact:none` maintenance that fits an Execute → Validate microcontract without a change.
+Use `delivery` for merge, push, tag, and publication of already-approved behavior: operational
+risk needs authorization and a receipt, not a new change or spec.
 
 ## When not to use
 
@@ -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 <text>
 ```
 
 Every FLOW subcommand also accepts `--project <path>`, `--vault <path>`, and `--json`. When
@@ -84,7 +90,7 @@ Harness. The workspaces remain private and are not published as independent npm
 |---|---|---|
 | `OFF` | LLM-native harness | Automatic governance off; Keep Core and explicit commands available. |
 | `FLOW` | E → V | Microcontract with Git baseline, allowlist, sensors, and receipt, without a change. |
-| `GUIDE` | P → E → V | Compact change; policy recognized for compatible evolution. |
+| `GUIDE` | P → E → V | `change new --guide`; objective, acceptance, areas, tests, and result; no automatic design/spec/ADR for `contract_impact:none`. |
 | `GOVERN` | P → R → E → V | Current a2 loop and conservative fallback. |
 | `ASSURE` | P → R → E → V → C | Governance plus confirmation and handoff. |
 
@@ -164,6 +170,14 @@ ownership to the native LLM harness.
   loser remains active and can retry with `--change-slug`. Retries idempotently resume the same
   promotion instead of creating another change.
   No FLOW command accepts `--force`.
+- Work kind (`inspection`, `maintenance`, `implementation`, `delivery`, `recovery`), profile,
+  `contract_impact`, and `operation_risk` are independent dimensions. `delivery start` captures
+  repo, branch/worktree, SHA, source change, and capabilities in `.brain/runtime/deliveries/`;
+  it creates no `08-Changes` folder, delta, spec, or ADR.
+- `delivery finish` requires a clean worktree, proves that the target contains the source commit,
+  and for `publish` requires CI, version, npm integrity, and GitHub Release evidence. Receipts are
+  append-only in `.brain/runtime/delivery-receipts.jsonl`. If code/config must change, delivery
+  stops with `WENDKEEP_DELIVERY_IMPLEMENTATION_REQUIRED` and work returns to implementation.
 - Exit `0` means a successful query or transition; exit `1` means a policy/red-sensor block; exit
   `2` means invalid profile, session, flow, or arguments, with no partial mutation.
 
@@ -229,13 +243,22 @@ again with an explicit destination:
 npx wendkeep flow promote $flowId --change-slug another-slug
 ```
 
+Deliver an approved version without manufacturing another change:
+
+```bash
+npx wendkeep delivery start release-0-73-0 --source-change proportional-governance --allow git:merge --allow git:push --allow publish
+npx wendkeep delivery status release-0-73-0
+npx wendkeep delivery finish release-0-74-0 --target v0.74.0 --ci-url <run> --version 0.74.0 --npm-integrity <sha512> --release-url <release>
+```
+
 ## Expected result
 
 Changing profile neither creates a new session nor interrupts the Vault. In `OFF`, memory and
 lessons are still injected and Stop still persists the session/memory lifecycle, while automatic
 router, skill gate, change context/warn/nag/guard, and plan capture are inactive. Explicit commands
 remain available and run their own contracts. A completed FLOW leaves a durable, inspectable
-receipt; a promoted FLOW enters the normal change lifecycle.
+receipt; a promoted FLOW enters the normal change lifecycle. Completed delivery leaves a receipt
+without an ADR; compact GUIDE archives its result without artificial spec/design/ADR.
 
 ## Common errors and diagnosis
 
@@ -254,6 +277,8 @@ receipt; a promoted FLOW enters the normal change lifecycle.
   retry `flow finish` or `flow promote`; the idempotent marker prevents duplication.
 - Pre-existing dirt appeared in the diff: it must match the initial fingerprint and must never be
   silently attributed to the FLOW.
+- Delivery without `--allow`, with a dirty worktree, or with incomplete publish evidence: resume
+  the real implementation or provide the receipts; do not create a change only to publish.
 
 ## Next steps
 

package/docs/pt-BR/commands/changes-and-verification.md

@@ -25,7 +25,7 @@ Tenha o projeto inicializado, um vault saudável e `wendkeep.sensors.json` váli
 ## Sintaxe
 
 ```bash
-npx wendkeep change new <slug>
+npx wendkeep change new <slug> [--simple|--guide]
 npx wendkeep change status [slug]
 npx wendkeep spec effective --change <slug>
 npx wendkeep sensors list
@@ -35,8 +35,10 @@ npx wendkeep change archive <slug>
 
 ## Opções e códigos de saída
 
-- `wendkeep change new <slug> [--simple]` cria uma change; `--simple` só pula o design, não é nem
-  equivale a `FLOW` e preserva o lifecycle/ADR legado.
+- `wendkeep change new <slug> [--simple|--guide]` cria uma change. `--simple` só pula o design,
+  não equivale a `FLOW` e preserva o lifecycle/ADR legado. `--guide` cria o contrato GUIDE
+  compacto (objetivo, aceite, áreas, testes e resultado), sem design/spec/ADR automático quando
+  `contract_impact:none`.
 - `change use`, `list`, `show`, `status`, `diff`, `done` e `undone` inspecionam ou atualizam o
   trabalho sem arquivar.
 - `change continue <arquivada> <nova>` abre continuação sem herdar evidência antiga.
@@ -52,6 +54,7 @@ npx wendkeep change archive <slug>
 
 ```bash
 npx wendkeep change new login-tenant
+npx wendkeep change new ajuste-interno --guide
 npx wendkeep spec effective --change login-tenant
 npx wendkeep change done 1.1 --change login-tenant
 npx wendkeep verify --change login-tenant
@@ -67,8 +70,10 @@ npx wendkeep sensors add api-contracts "npm run test:contracts" --severity criti
 
 ## Resultado esperado
 
-A change arquivada move seu delta para o spec vivo, preserva proposta/design/tarefas/evidência e
-gera um ADR. O archive só passa com tarefas fechadas, sensores exigidos verdes e verdict atual.
+A change arquivada move seu delta para o spec vivo quando aplicável e preserva proposta,
+tarefas/evidência e design quando existente. GOVERN/ASSURE geram ADR; GUIDE compacta sem impacto
+de contrato não gera ADR automático. O archive só passa com tarefas fechadas, sensores exigidos
+verdes e verdict atual.
 
 ## Cerca de escopo para ferramentas
 

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/memory.md

@@ -30,6 +30,7 @@ Informe o vault explicitamente em automações. Preserve backups e evidências a
 npx wendkeep memory status [--gate] --vault <cofre>
 npx wendkeep memory curate --vault <cofre>
 npx wendkeep memory candidates [--active] --vault <cofre>
+npx wendkeep memory rescope [--apply] --vault <cofre>
 npx wendkeep memory repair --vault <cofre>
 npx wendkeep memory recover-attempt <sessão> [--apply] --vault <cofre>
 npx wendkeep memory reconcile <sessão-ambígua> --by-session <sessão-sucessora> --reason <motivo> [--apply] --vault <cofre>
@@ -51,7 +52,7 @@ npx wendkeep validate-memory --vault <cofre-v2>
   não-TTY/terminal não interativo, ele retorna exit `2` sem alterar bytes e orienta usar o fallback
   avançado `memory candidates --active`.
 - `memory candidates` é read-only e imprime JSON determinístico com somente `candidate_id`,
-  `reason`, `status`, `memory_key` e `event_ids`; não expõe valores nem conteúdo da memória e não
+  `reason`, `status`, `memory_key`, escopo quando presente e `event_ids`; não expõe valores nem conteúdo da memória e não
   cria lock nem altera o bundle. `--active` omite candidates terminais (`resolved`, `rejected` e
   `superseded`). Status ausente é normalizado para `active`.
 - Em `memory candidates`, exit `0` indica inventário válido (inclusive vazio ou com conflitos),
@@ -95,6 +96,18 @@ npx wendkeep validate-memory --vault <cofre-v2>
   do attempt exato, salva backup do registry e limita a mutação ao attempt ambíguo e à sucessora.
   O replay é CORE-aware, usa cursor físico do ledger no checkpoint e não reescreve ledger, CORE ou
   notas, nem consome a outbox. Repetir a mesma decisão aplicada é idempotente.
+- `memory rescope` é dry-run por padrão e lista somente IDs, chaves e escopos planejados. Com
+  `--apply`, anexa eventos explícitos de projeto, work session, change, branch ou worktree e mantém
+  os bytes históricos como prefixo do ledger. Candidates ambíguos não são migrados nem recebem
+  vencedor; uma repetição retorna `unchanged`.
+- Registradores como `git.local-head`, `handoff.latest`, `quality.latest-*` e
+  `change.<slug>.status` só competem dentro do mesmo escopo. Resolução automática ainda exige o
+  mesmo projeto e linhagem causal; decisões, constraints e blockers incompatíveis permanecem sob
+  curadoria. Uma chave ambígua é omitida de SHARED sem remover CORE ou chaves independentes.
+- `.brain/EVIDENCE_INDEX.jsonl` divide documentos por headings e blocos e registra arquivo,
+  heading, tipo, change, sessão, work session, autoridade, data, validade e hash. `/brain-recall`
+  e o hook `UserPromptSubmit` usam BM25, frase exata, pesos por campo, autoridade, validade,
+  recência limitada e diversidade para retornar o trecho do match com proveniência.
 - Toda rota de memória valida a topologia física de `.brain`, ledger, outbox, CORE, SHARED,
   candidates, registry, notas, backups, temporários e sidecars antes de ler ou escrever. Junction,
   symlink, reparse point ou hardlink falham fechados sem tocar bytes externos. Locks publicam owner
@@ -134,6 +147,8 @@ npx wendkeep validate-memory --vault <cofre-v2>
 npx wendkeep memory status --gate --vault .MeuApp-vault
 npx wendkeep memory curate --vault .MeuApp-vault
 npx wendkeep memory candidates --active --vault .MeuApp-vault
+npx wendkeep memory rescope --vault .MeuApp-vault
+npx wendkeep memory rescope --apply --vault .MeuApp-vault
 npx wendkeep memory recover-attempt sessao-123 --vault .MeuApp-vault
 npx wendkeep memory recover-attempt sessao-123 --apply --vault .MeuApp-vault
 npx wendkeep memory reconcile antiga --by-session atual --reason "entrega continuada" --vault .MeuApp-vault

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

@@ -98,6 +98,11 @@ reconciliação quando o ledger detalhado não fecha com ele; essa linha não in
 Sessões históricas com o mesmo `session_id` recebem uma identidade canônica por arquivo para
 evitar que um rollup sobrescreva o outro.
 
+No schema 4, cada documento ingerido também é projetado em chunks com caminho, heading,
+autoridade, data e validade. O Observer faz um feature probe de FTS5 e usa o índice quando a
+extensão está disponível; caso contrário, mantém a mesma semântica por fallback lexical. A busca
+retorna o trecho em que houve o match e sua proveniência, não apenas o começo do documento.
+
 O `init` projeta `observer-publish` para `SessionStart`, `Stop` e `SubagentStop` depois dos hooks
 principais. Sem servidor disponível, ele grava snapshots em `.brain/observer-outbox/` e eventos
 SQL em `.brain/observer-sql-outbox/`, sem bloquear a sessão; uma execução posterior tenta
@@ -140,7 +145,8 @@ corte. As telas do Observer não concluem, arquivam, reparam ou promovem estado.
   chamadas e transcripts.
 - `GET /v1/projects/:project_id/memory/tree` — árvore e metadados dos documentos.
 - `GET /v1/projects/:project_id/memory/document?path=...` — conteúdo Markdown integral.
-- `GET /v1/projects/:project_id/memory/search?q=...` — busca no caminho e no corpo.
+- `GET /v1/projects/:project_id/memory/search?q=...` — busca ranqueada por chunks, com trecho do
+  match e proveniência; usa fallback lexical quando FTS5 não está disponível.
 - `GET /v1/projects/:project_id/sync` — modo, contagem, conflitos e último evento.
 - `PUT /v1/projects/:project_id/sync` — compatibilidade de configuração; a autoridade continua SQL.
 - `GET /v1/projects/:project_id/memory/export` — exportação read-only com conteúdo completo.

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-74-0 --target v0.74.0 --ci-url <run> --version 0.74.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/hooks/brain-core.mjs

@@ -5,6 +5,7 @@ import { basename, join } from 'node:path';
 import { ensureDir, stripYamlQuotes, toVaultRelative } from './obsidian-common.mjs';
 import { getLocale } from './locale.mjs';
 import { sanitizeMemoryText } from './memory-schema.mjs';
+import { buildEvidenceIndex } from './evidence-recall.mjs';
 
 export function brainDir(vaultBase) {
   return join(vaultBase, '.brain');
@@ -85,6 +86,7 @@ export function buildBrainIndex(vaultBase) {
   ensureDir(brainDir(vaultBase));
   const out = rows.map((r) => JSON.stringify(r)).join('\n') + (rows.length ? '\n' : '');
   writeFileSync(join(brainDir(vaultBase), 'index.jsonl'), out, 'utf8');
+  buildEvidenceIndex(vaultBase);
   return rows;
 }
 

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/brain-recall.mjs

@@ -4,10 +4,12 @@
 import { pathToFileURL } from 'node:url';
 import { getVaultBase } from './obsidian-common.mjs';
 import { loadIndex } from './brain-core.mjs';
+import { loadEvidenceIndex, recallEvidence } from './evidence-recall.mjs';
 
 export { loadIndex };
 
 export function scoreRows(rows, query, topK = 5) {
+  if (rows.some((row) => row?.chunk_id)) return recallEvidence(rows, query, { topK });
   const terms = String(query).toLowerCase().split(/\s+/).filter(Boolean);
   if (!terms.length) return [];
   return rows
@@ -27,6 +29,8 @@ export function scoreRows(rows, query, topK = 5) {
 
 if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
   const vaultBase = getVaultBase();
-  const hits = scoreRows(loadIndex(vaultBase), process.argv.slice(2).join(' '));
+  const query = process.argv.slice(2).join(' ');
+  const evidence = loadEvidenceIndex(vaultBase);
+  const hits = evidence.length ? recallEvidence(evidence, query, { topK: 5 }) : scoreRows(loadIndex(vaultBase), query);
   process.stdout.write(JSON.stringify(hits, null, 2) + '\n');
 }

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;