wendkeep 0.76.8 → 0.77.0

package/hooks/brain-inject.mjs

@@ -7,7 +7,12 @@ import { join } from 'node:path';
 import { pathToFileURL } from 'node:url';
 import { readHookInput, writeHookOutput } from './obsidian-common.mjs';
 import { brainDir } from './brain-core.mjs';
-import { buildActiveChangeInjection, changeCtxState, writeSentinel } from './change-core.mjs';
+import {
+  activeChange,
+  buildActiveChangeInjection,
+  changeCtxState,
+  writeSentinel,
+} from './change-core.mjs';
 import { buildLessonsInjection } from './lessons-core.mjs';
 import { getLocale } from './locale.mjs';
 import { resolveSessionEntry } from './session-identity.mjs';
@@ -20,6 +25,7 @@ import {
 } from './operating-profile-runtime.mjs';
 import { assertVaultPathSafe } from './vault-path-safety.mjs';
 import { CORE_LIMITS, validateCore } from '../src/validate-core.mjs';
+import { resolveCommandActiveContext } from '../src/active-context-runtime.mjs';
 
 // The process ROUTER — the enforcement layer. The wk-* skills are passive files; without a
 // standing instruction the model plans in chat, leaves the change scaffold raw and forces the
@@ -220,7 +226,9 @@ function budgetNotice(priority, layer, message) {
   return `<wk_budget_notice priority="${priority}" layer="${layer}">${message}</wk_budget_notice>`;
 }
 
-export function buildInjection(vaultBase, input = {}, { profile = 'GOVERN', bindingError = null } = {}) {
+export function buildInjection(vaultBase, input = {}, {
+  profile = 'GOVERN', bindingError = null, context = null,
+} = {}) {
   const brain = detectMemoryMode(vaultBase).mode === 'v2'
     ? buildV2Memory(vaultBase)
     : buildLegacyMemory(vaultBase);
@@ -236,10 +244,14 @@ export function buildInjection(vaultBase, input = {}, { profile = 'GOVERN', bind
   // visible below, but the standing change router would contradict that contract.
   const router = policy.requiresChange ? processRouter(getLocale(vaultBase).id) : '';
   const { identity, entry } = resolveSessionEntry(vaultBase, input);
-  const focus = identity.state === 'resolved' && entry?.change_slug
-    ? `<session_change>${boundAncillaryText(`Change vinculada a esta sessão: ${entry.change_slug}. Este vínculo prevalece para writes automáticos; todas as pendências continuam visíveis acima.`, '<session_change></session_change>'.length)}</session_change>`
+  const contextualChange = context ? activeChange(vaultBase, { context }) : '';
+  const sessionChange = contextualChange || (!context && identity.state === 'resolved' ? entry?.change_slug : '');
+  const focus = sessionChange
+    ? `<session_change>${boundAncillaryText(`Change vinculada a esta sessão: ${sessionChange}. Este vínculo prevalece para writes automáticos; todas as pendências continuam visíveis acima.`, '<session_change></session_change>'.length)}</session_change>`
     : '';
-  const allChanges = buildActiveChangeInjection(vaultBase, { maxLineChars: INJECTION_LIMITS.lineChars });
+  const allChanges = buildActiveChangeInjection(vaultBase, {
+    context, maxLineChars: INJECTION_LIMITS.lineChars,
+  });
 
   // Global priority is deterministic: memory/router/focus, then changes, then lessons.
   let output = joinInjection([brain, profileNotice, router, focus, allChanges, lessons]);
@@ -253,6 +265,7 @@ export function buildInjection(vaultBase, input = {}, { profile = 'GOVERN', bind
   // Second pressure step: non-current changes leave the hot context before the current one.
   const nonCurrentEvicted = budgetNotice(2, 'non-current-changes', 'Changes não atuais omitidas depois das lessons.');
   const currentChange = buildActiveChangeInjection(vaultBase, {
+    context,
     currentOnly: true,
     maxLineChars: INJECTION_LIMITS.lineChars,
   });
@@ -264,6 +277,7 @@ export function buildInjection(vaultBase, input = {}, { profile = 'GOVERN', bind
   const fixed = joinInjection([brain, profileNotice, router, focus, lessonsEvicted, nonCurrentEvicted, currentSummarized]);
   const remaining = Math.max(512, INJECTION_LIMITS.totalBytes - byteLength(fixed) - 1);
   const boundedCurrent = buildActiveChangeInjection(vaultBase, {
+    context,
     currentOnly: true,
     maxBytes: remaining,
     maxLineChars: INJECTION_LIMITS.lineChars,
@@ -285,21 +299,29 @@ if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href)
     const input = readHookInput();
     const runtime = resolveHookOperatingProfile({ input });
     const vaultBase = runtime.vaultBase;
+    const { identity } = runtime;
+    const sid = identity.state === 'resolved'
+      ? identity.canonicalConversationId : (input.session_id || input.sessionId || '');
+    const commandContext = runtime.bindingError ? null : resolveCommandActiveContext({
+      vaultBase,
+      projectRoot: input.cwd || process.cwd(),
+      sessionId: sid,
+      requireExisting: true,
+    });
     writeHookOutput({
       hookSpecificOutput: {
         hookEventName: 'SessionStart',
         additionalContext: buildInjection(vaultBase, input, {
           profile: runtime.profile,
           bindingError: runtime.bindingError,
+          context: commandContext,
         }),
       },
     });
     // Sentinela do change-context: o backlog completo acabou de ser injetado aqui, então o hook
     // UserPromptSubmit não precisa re-pingar no 1º prompt. Bônus — nunca derruba a injeção.
     if (runtime.policy.harness && !runtime.bindingError) try {
-      const st = changeCtxState(vaultBase);
-      const { identity } = runtime;
-      const sid = identity.state === 'resolved' ? identity.canonicalConversationId : (input.session_id || input.sessionId || '');
+      const st = changeCtxState(vaultBase, { context: commandContext });
       if (st) {
         writeSentinel(vaultBase, 'ctx', profileSentinelId(sid, runtime.profile), st.hash);
       }

package/hooks/change-context.mjs

@@ -8,7 +8,9 @@
 import { pathToFileURL } from 'node:url';
 import { readHookInput, writeHookOutput } from './obsidian-common.mjs';
 import { profileRuntimeError } from './brain-inject.mjs';
-import { changeCtxState, readSentinel, renderOpenChanges, writeSentinel } from './change-core.mjs';
+import {
+  activeChange, changeCtxState, readSentinel, renderOpenChanges, writeSentinel,
+} from './change-core.mjs';
 import {
   hookProfilePolicy,
   profileSentinelId,
@@ -43,7 +45,7 @@ export function buildChangePing(vaultBase, sessionId, prompt = '', changeSlug =
       hash,
     };
   }
-  const st = changeCtxState(vaultBase);
+  const st = changeCtxState(vaultBase, { context });
   if (st) {
     if (readSentinel(vaultBase, 'ctx', sentinelId) === st.hash) return null;
     writeSentinel(vaultBase, 'ctx', sentinelId, st.hash);
@@ -75,10 +77,14 @@ if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href)
       vaultBase,
       projectRoot: input.cwd || process.cwd(),
       sessionId: sid,
+      requireExisting: true,
     });
+    const changeSlug = commandContext
+      ? activeChange(vaultBase, { context: commandContext })
+      : (entry?.change_slug || '');
     const ping = runtime.bindingError
       ? { context: profileRuntimeError(runtime.bindingError) }
-      : buildChangePing(vaultBase, sid, input.prompt || '', entry?.change_slug || '', {
+      : buildChangePing(vaultBase, sid, input.prompt || '', changeSlug, {
         profile: runtime.profile,
         context: commandContext,
       });

package/hooks/change-core.mjs

@@ -420,7 +420,8 @@ export function renderOpenChanges(state, {
 // Mantém o nome exportado para consumidores internos existentes, mas agora injeta o backlog
 // completo em vez de ocultar changes não selecionadas.
 export function buildActiveChangeInjection(vaultBase, options = {}) {
-  return renderOpenChanges(allChangesState(vaultBase), options);
+  const { context, ...renderOptions } = options;
+  return renderOpenChanges(allChangesState(vaultBase, { context }), renderOptions);
 }
 
 export function activeChangeLink(vaultBase, { context } = {}) {
@@ -479,8 +480,8 @@ export function writeSentinel(vaultBase, kind, sid, value = '1') {
 // Estado global usado pelo change-context: hash cobre qualquer tarefa aberta, inclusive de uma
 // change que não esteja no ponteiro. As propriedades slug/openTasks preservam compatibilidade com
 // consumidores antigos e descrevem somente a atual.
-export function changeCtxState(vaultBase) {
-  const state = allChangesState(vaultBase);
+export function changeCtxState(vaultBase, { context } = {}) {
+  const state = allChangesState(vaultBase, { context });
   if (!state.changes.length && !state.pointerWarning) return null;
   const selected = state.changes.find((change) => change.current);
   return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wendkeep",
-  "version": "0.76.8",
+  "version": "0.77.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": {
-    "precheck": "node --check src/worktree.mjs && node --check src/context.mjs && node --check src/active-context-health.mjs && node --check packages/vault/src/worktree-metadata.mjs",
+    "precheck": "node --check src/worktree.mjs && node --check src/worktree-cleanup.mjs && node --check src/context.mjs && node --check src/active-context-health.mjs && node --check src/active-context-runtime.mjs && node --check hooks/active-context-store.mjs && node --check hooks/change-core.mjs && node --check hooks/brain-inject.mjs && node --check hooks/change-context.mjs && node --check packages/vault/src/worktree-metadata.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/active-context-health.mjs && node --check src/project-vault.mjs && node --check src/observer-auth.mjs && node --check src/observer-privacy.mjs && node --check src/observer-snapshot.mjs && node --check src/observer-store.mjs && node --check src/observer-memory.mjs && node --check src/observer-memory-publish.mjs && node --check src/observer-sql-store.mjs && node --check src/observer-sql-migrate.mjs && node --check src/observer-sql-publish.mjs && node --check src/observer-transcript-store.mjs && node --check src/observer-server.mjs && node --check src/observer.mjs && node --check src/observer-publish.mjs && node --check src/operating-profile.mjs && node --check src/profile.mjs && node --check src/flow.mjs && node --check src/work-kind.mjs && node --check src/delivery.mjs && node --check web/observer/app.mjs && node --check hooks/observer-publish.mjs && node --check hooks/evidence-context.mjs && node --check hooks/active-context-handoff-evidence.mjs && node --check hooks/evidence-recall.mjs && node --check hooks/memory-scope.mjs && node --check hooks/operating-profile-runtime.mjs && node --check hooks/operating-profile-task-store.mjs && node --check hooks/flow-core.mjs && node --check hooks/flow-protected-policy.mjs && node --check hooks/git-snapshot.mjs && node --check hooks/vault-path-safety.mjs && node --check hooks/vault-runtime-store.mjs && node --check packages/harness/src/index.mjs && node --check packages/harness/src/flow-store.mjs && node --check packages/harness/src/operating-profile.mjs && node --check packages/harness/src/sensors-core.mjs && node --check packages/integrations/src/host-hooks.mjs && node --check packages/integrations/src/hook-envelope.mjs && node --check packages/integrations/src/prompt-content.mjs && node --check packages/integrations/src/transcript-usage.mjs && node --check packages/integrations/src/transcripts.mjs && node --check packages/integrations/src/session-identity.mjs && node --check packages/integrations/src/index.mjs && node --check packages/mcp/src/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-scope.mjs && node --check packages/vault/src/memory-candidate-policy.mjs && node --check packages/vault/src/evidence-recall.mjs && node --check packages/vault/src/memory-handoff.mjs && node --check packages/vault/src/memory-store.mjs && node --check packages/vault/src/validate-core.mjs && node --check packages/vault/src/validate-memory.mjs",
     "test": "node --test --test-concurrency=2",
     "test:core": "node scripts/run-scope.mjs core",

package/packages/cli/src/index.mjs

@@ -249,7 +249,7 @@ async function main(argv) {
     }
     case 'worktree': {
       const { runWorktree } = await import('../../../src/worktree.mjs');
-      process.exit(runWorktree(rest));
+      process.exit(await runWorktree(rest));
       break;
     }
     case 'context': {

package/src/active-context-runtime.mjs

@@ -1,5 +1,9 @@
 import { readSessionRegistry } from '../hooks/obsidian-common.mjs';
-import { migrateLegacyActiveContext } from '../hooks/active-context-store.mjs';
+import {
+  activeContextRegistryInitialized,
+  migrateLegacyActiveContext,
+  resolveActiveContext,
+} from '../hooks/active-context-store.mjs';
 import { captureProjectScope, compareProjectScopes } from '../hooks/project-scope.mjs';
 import {
   discoverWorktreeRepository,
@@ -107,6 +111,7 @@ export function resolveCommandActiveContext({
   projectRoot = process.cwd(),
   sessionId = '',
   spawn,
+  requireExisting = false,
 } = {}) {
   const requestedSession = String(sessionId || '').trim();
   let identity;
@@ -116,7 +121,7 @@ export function resolveCommandActiveContext({
     });
   } catch (error) {
     const registry = readSessionRegistry(vaultBase);
-    const initialized = Object.keys(registry.active_contexts || {}).length > 0;
+    const initialized = activeContextRegistryInitialized(registry);
     const legacyUnavailable = error?.code === 'WENDKEEP_ACTIVE_CONTEXT_IDENTITY_UNAVAILABLE'
       || (!requestedSession && error?.code === 'WENDKEEP_ACTIVE_CONTEXT_NOT_FOUND');
     if (!initialized && legacyUnavailable) return null;
@@ -127,5 +132,10 @@ export function resolveCommandActiveContext({
       vaultBase, projectRoot, sessionId: candidateId, ...(spawn ? { spawn } : {}),
     }),
   });
+  if (requireExisting) {
+    const registry = readSessionRegistry(vaultBase);
+    if (!activeContextRegistryInitialized(registry)) return null;
+    resolveActiveContext(vaultBase, identity);
+  }
   return identity;
 }