wendkeep 0.72.1 → 0.73.0

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/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.1",
+  "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,7 +41,7 @@
     "node": ">=18"
   },
   "scripts": {
-    "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 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",

package/packages/cli/src/index.mjs

@@ -48,9 +48,9 @@ Usage:
                            package first (npm i -D wendkeep@latest); a running process
                            cannot replace itself. · --vault P · --profile <name> · --yes.
 
-  wendkeep doctor [--vault P]  Run a vault health check.
+  wendkeep doctor [--vault P]  Health check. --scope core|runtime · --strict for CI/release.
   wendkeep observer <sub>     Local multi-project Observer: serve | register | publish | status.
-  wendkeep change <sub>        Change lifecycle: new [--simple] | use | bind <slug> --session <id> | continue | list | show |
+  wendkeep change <sub>        Change lifecycle: new [--simple|--guide] | use | bind <slug> --session <id> | continue | list | show |
                            status | done <id> | undone <id> | diff | archive [--force] | abandon | relink | backlink.
                            archive exige verdict (rode verify --deep); abandon descarta sem ADR.
                            backlink [--apply]: injeta o backlink pro proposta em design/tarefas/spec órfãos (open + _arquivo).
@@ -62,6 +62,8 @@ Usage:
                            the project default. The Vault/session/memory core is always active.
   wendkeep flow <sub>          Low-ceremony E -> V contract: start | status | show | finish | promote.
                            FLOW records scope, sensors and a receipt without creating a change.
+  wendkeep delivery <sub>      Operational delivery: start | status | finish | abandon.
+                           Records authorization and an append-only receipt; never creates a change/spec/ADR.
   wendkeep spec <sub>          Specs: list | show | effective [--change] [--json] | migrate | rebase.
   wendkeep sensors <sub>       list | add <id> "<command>" [--severity --type --report].
   wendkeep cost [opts]         Aggregate AI-coding spend across the vault's sessions.
@@ -184,6 +186,9 @@ async function main(argv) {
     if (cmd === 'flow') {
       const { FLOW_HELP } = await import('../../../src/flow.mjs');
       process.stdout.write(FLOW_HELP);
+    } else if (cmd === 'delivery') {
+      const { DELIVERY_HELP } = await import('../../../src/delivery.mjs');
+      process.stdout.write(DELIVERY_HELP);
     } else if (cmd === 'profile') {
       const { PROFILE_HELP } = await import('../../../src/profile.mjs');
       process.stdout.write(PROFILE_HELP);
@@ -273,6 +278,11 @@ async function main(argv) {
       process.exit(await runFlow(rest));
       break;
     }
+    case 'delivery': {
+      const { runDelivery } = await import('../../../src/delivery.mjs');
+      process.exit(runDelivery(rest));
+      break;
+    }
     case 'theme': {
       const { runTheme } = await import('../../../src/theme.mjs');
       runTheme(rest);

package/src/change.mjs

@@ -16,6 +16,7 @@ import {
   relinkChanges,
   backfillArtifactLinks,
   scaffoldPlaceholders,
+  isGuideCompactChange,
 } from '../hooks/change-core.mjs';
 import { evaluateGate, requiredSensors } from '../hooks/sensors-core.mjs';
 import { buildEffectiveRequirementPackage, evaluateVerdict, formatOrphanReqs, tasksHashOf, parseSpecsList, parseDelta, parseRequirements, applyDelta, validateSpecImpact } from '../hooks/spec-core.mjs';
@@ -61,7 +62,9 @@ export function runChange(argv) {
     // G2: link the active session into the proposta's source: (graph edge proposta->sessão).
     let sessionRel = '';
     try { sessionRel = readControl(vaultBase).session_file || ''; } catch { /* sem control */ }
-    const r = newChange(vaultBase, slug, { dateStr: today(), simple: rest.includes('--simple'), sessionRel });
+    const r = newChange(vaultBase, slug, {
+      dateStr: today(), simple: rest.includes('--simple'), guide: rest.includes('--guide'), sessionRel,
+    });
     process.stdout.write(`change ${r.created ? 'created' : 'exists'}: ${r.rel} (active)\n`);
     process.exit(0);
   }
@@ -97,7 +100,7 @@ export function runChange(argv) {
     let sessionRel = '';
     try { sessionRel = readControl(vaultBase).session_file || ''; } catch { /* no control */ }
     const r = continueChange(vaultBase, archivedSlug, newSlug, {
-      dateStr: today(), simple: rest.includes('--simple'), sessionRel,
+      dateStr: today(), simple: rest.includes('--simple'), guide: rest.includes('--guide'), sessionRel,
     });
     if (!r.ok) { process.stderr.write(`wendkeep change continue: ${r.error}\n`); process.exit(2); }
     process.stdout.write(`change created: ${r.rel} (continues ${r.archived}; active)\n`);
@@ -287,13 +290,16 @@ export function runChange(argv) {
     try { tasks = parseTasks(readFileSync(join(vaultBase, getLocale(vaultBase).folders.changes, slug, 'tarefas.md'), 'utf8')); } catch { /* sem tarefas */ }
     const forced = rest.includes('--force') && tasks.some((t) => !t.done);
     const trivial = !tasks.some((t) => t.req) && !tasks.some((t) => t.sensor);
-    if (trivial) process.stderr.write('aviso: change trivial (sem [req:]/[sensor:]) — ADR marcado trivial: true\n');
+    const compactGuide = isGuideCompactChange(join(vaultBase, getLocale(vaultBase).folders.changes, slug));
+    if (trivial) process.stderr.write(compactGuide
+      ? 'aviso: GUIDE compacta sem [req:]/[sensor:] — resultado permanece auditável no archive, sem ADR automático\n'
+      : 'aviso: change trivial (sem [req:]/[sensor:]) — ADR marcado trivial: true\n');
     const r = archiveChange(vaultBase, slug, { dateStr: today(), adrNum: getNextAdrNumber(vaultBase), gate, adrFlags: { forced, trivial } });
     if (!r.ok) {
       process.stderr.write(`change archive BLOCKED (gate): ${r.failing.join('; ')}\n`);
       process.exit(1);
     }
-    process.stdout.write(`archived: ${r.archivedRel}; ADR: ${r.adrRel}\n`);
+    process.stdout.write(`archived: ${r.archivedRel}${r.adrRel ? `; ADR: ${r.adrRel}` : '; GUIDE compacta: sem ADR'}\n`);
     if (r.promoted && r.promoted.length) process.stdout.write(`specs promovidas: ${r.promoted.join(', ')}\n`);
     if (r.specWarnings && r.specWarnings.length) for (const w of r.specWarnings) process.stderr.write(`  aviso spec: ${w}\n`);
     process.exit(0);