wendkeep 0.29.1 → 0.29.2

package/CHANGELOG.md

@@ -4,6 +4,19 @@ All notable changes to **wendkeep** are documented here. Format based on
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); this project follows
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.29.2] — 2026-07-09
+
+### Fixed
+- **Iteration turn marker renamed `codex-turn` → `wk-turn`** (provider-neutral). A **Claude**
+  session's iterations carried `<!-- codex-turn: … -->` — a legacy name from when this was a
+  Codex-only tool, confusing in the note source. The marker is a dedup key, so the change is
+  backward-compatible: `hasTurnMarker` still recognizes the legacy name, and `insertIteration`
+  **self-migrates** any `codex-turn` → `wk-turn` on the next write (backfill re-processes older
+  notes). Shared helpers `turnMarker` / `hasTurnMarker` / `normalizeTurnMarkers` in obsidian-common;
+  `vault-health` recognizes both.
+- Note-visible fallback text "Checkpoint registrado pelo hook Stop do **Codex**" → provider-neutral.
+- Stderr log prefix `[codex-obsidian]` → `[wendkeep]` across the hooks.
+
 ## [0.29.1] — 2026-07-09
 
 ### Added

package/hooks/obsidian-common.mjs

@@ -557,6 +557,27 @@ export function wikilinkFromRel(relPath) {
   return `[[${relPath.replace(/\.md$/i, '').replaceAll('\\', '/')}]]`;
 }
 
+// Per-iteration dedup marker (an invisible HTML comment). Provider-neutral name `wk-turn`; the
+// old `codex-turn` (legacy, from when this was a Codex-only tool) is still RECOGNIZED so notes
+// written by older versions keep deduping, and normalizeTurnMarkers migrates them on the next write.
+export const TURN_MARKER = 'wk-turn';
+export const LEGACY_TURN_MARKERS = ['codex-turn'];
+
+export function turnMarker(id) {
+  return `<!-- ${TURN_MARKER}: ${id} -->`;
+}
+
+export function hasTurnMarker(content, id) {
+  return [TURN_MARKER, ...LEGACY_TURN_MARKERS].some((m) => String(content || '').includes(`<!-- ${m}: ${id} -->`));
+}
+
+// Rewrite any legacy turn markers in a note to the current name (self-healing migration).
+export function normalizeTurnMarkers(content) {
+  let c = String(content || '');
+  for (const m of LEGACY_TURN_MARKERS) c = c.replaceAll(`<!-- ${m}: `, `<!-- ${TURN_MARKER}: `);
+  return c;
+}
+
 export function listMarkdownFiles(dir) {
   try {
     return readdirSync(dir).filter((f) => f.endsWith('.md'));

package/hooks/session-backfill.mjs

@@ -36,7 +36,9 @@ function parseArgs(argv) {
 }
 
 function hasTurnMarker(content, turnId) {
-  return content.includes(`<!-- codex-turn: ${turnId} -->`);
+  // recognize both the current `wk-turn` and the legacy `codex-turn`
+  return content.includes(`<!-- wk-turn: ${turnId} -->`)
+    || content.includes(`<!-- codex-turn: ${turnId} -->`);
 }
 
 function sessionEntries(vaultBase, args) {
@@ -135,7 +137,7 @@ if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href)
   try {
     main();
   } catch (error) {
-    process.stderr.write(`[codex-obsidian] Backfill falhou: ${error.message}\n`);
+    process.stderr.write(`[wendkeep] Backfill falhou: ${error.message}\n`);
     process.exitCode = 1;
   }
 }

package/hooks/session-ensure.mjs

@@ -387,6 +387,6 @@ function main() {
 try {
   main();
 } catch (error) {
-  process.stderr.write(`[codex-obsidian] UserPromptSubmit falhou: ${error.message}\n`);
+  process.stderr.write(`[wendkeep] UserPromptSubmit falhou: ${error.message}\n`);
   writeHookOutput({});
 }

package/hooks/session-start.mjs

@@ -161,7 +161,7 @@ function main() {
   try {
     sweepStaleSessionsFile(vaultBase, now, undefined, input.transcript_path || input.transcriptPath || '');
   } catch (error) {
-    process.stderr.write(`[codex-obsidian] sweep de sessões falhou: ${error.message}\n`);
+    process.stderr.write(`[wendkeep] sweep de sessões falhou: ${error.message}\n`);
   }
 
   // Reuso da nota apontada pelo CURRENT_SESSION só quando é a MESMA conversa
@@ -309,9 +309,9 @@ if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href)
   try {
     main();
   } catch (error) {
-    process.stderr.write(`[codex-obsidian] SessionStart falhou: ${error.message}\n`);
+    process.stderr.write(`[wendkeep] SessionStart falhou: ${error.message}\n`);
     writeHookOutput({
-      systemMessage: `[codex-obsidian] Não foi possível criar a sessão Obsidian: ${error.message}`,
+      systemMessage: `[wendkeep] Não foi possível criar a sessão Obsidian: ${error.message}`,
     });
   }
 }

package/hooks/session-stop.mjs

@@ -30,6 +30,9 @@ import {
   wikilinkFromRel,
   writeControl,
   writeHookOutput,
+  turnMarker,
+  hasTurnMarker,
+  normalizeTurnMarkers,
 } from './obsidian-common.mjs';
 
 function extractContentText(content) {
@@ -596,7 +599,7 @@ export function buildIterationBlock(tx, input) {
   // inclui recortes da conversa do turno, sem despejar outputs brutos.
   return `
 ### ${formatTimeForHeading(now)} - ${heading}
-<!-- codex-turn: ${turnId} -->
+${turnMarker(turnId)}
 
 **Pedido:** ${compactText(promptText, 1000)}
 
@@ -609,7 +612,7 @@ ${formatConversation(turn)}
 
 **Arquivos detectados no turno:** ${formatInlineList(files, 'Nenhum arquivo detectado automaticamente.')}
 
-**Estado ao final do turno:** ${compactText(latestAssistant || 'Checkpoint registrado pelo hook Stop do Codex.', 900)}
+**Estado ao final do turno:** ${compactText(latestAssistant || 'Checkpoint registrado automaticamente ao final do turno.', 900)}
 `;
 }
 
@@ -751,17 +754,19 @@ function relocateOrphanIterations(content) {
 }
 
 export function insertIteration(sessionPath, block, turnId, tx) {
-  let content = readFileSync(sessionPath, 'utf-8');
-  if (content.includes(`<!-- codex-turn: ${turnId} -->`)) {
+  const original = readFileSync(sessionPath, 'utf-8');
+  // Self-heal: migrate any legacy `codex-turn` markers to the neutral name on this write.
+  let content = normalizeTurnMarkers(original);
+  if (hasTurnMarker(content, turnId)) {
     // Turno já registrado: ainda assim repara órfãos e seções dedicadas.
     const repaired = applyDedicatedSections(relocateOrphanIterations(content), tx);
-    if (repaired !== content) writeFileSync(sessionPath, repaired, 'utf-8');
+    if (repaired !== original) writeFileSync(sessionPath, repaired, 'utf-8');
     return false;
   }
   content = relocateOrphanIterations(content);
   content = insertIntoIteracoes(content, block);
   content = applyDedicatedSections(content, tx);
-  writeFileSync(sessionPath, content, 'utf-8');
+  if (content !== original) writeFileSync(sessionPath, content, 'utf-8');
   return true;
 }
 
@@ -1037,7 +1042,7 @@ function main() {
   try {
     applyLinearLinks(sessionPath, tx, vaultBase, sessionRel);
   } catch (error) {
-    process.stderr.write(`[codex-obsidian] Linear link falhou: ${error.message}\n`);
+    process.stderr.write(`[wendkeep] Linear link falhou: ${error.message}\n`);
   }
 
   try {
@@ -1048,7 +1053,7 @@ function main() {
       transcriptPath,
     });
   } catch (error) {
-    process.stderr.write(`[codex-obsidian] Token usage falhou: ${error.message}\n`);
+    process.stderr.write(`[wendkeep] Token usage falhou: ${error.message}\n`);
   }
 
   // Subagent/workflow telemetry (0.10.0): fold sibling subagent transcripts into the note.
@@ -1056,7 +1061,7 @@ function main() {
   try {
     upsertSubagentUsage(sessionPath, transcriptPath);
   } catch (error) {
-    process.stderr.write(`[codex-obsidian] Subagent usage falhou: ${error.message}\n`);
+    process.stderr.write(`[wendkeep] Subagent usage falhou: ${error.message}\n`);
   }
 
   if (!shouldFinalizeSession()) {
@@ -1127,7 +1132,7 @@ function main() {
     const rows = buildBrainIndex(vaultBase);
     buildBrainDigest(vaultBase, rows);
   } catch (error) {
-    process.stderr.write(`[codex-obsidian] brain index/digest falhou: ${error.message}\n`);
+    process.stderr.write(`[wendkeep] brain index/digest falhou: ${error.message}\n`);
   }
 
   pingObsidianVault(input.obsidian_api_key);
@@ -1138,7 +1143,7 @@ if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href)
   try {
     main();
   } catch (error) {
-    process.stderr.write(`[codex-obsidian] Stop falhou: ${error.message}\n`);
+    process.stderr.write(`[wendkeep] Stop falhou: ${error.message}\n`);
     writeHookOutput({});
   }
 }

package/hooks/token-usage.mjs

@@ -966,7 +966,7 @@ if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) {
   try {
     runCli();
   } catch (error) {
-    process.stderr.write(`[codex-obsidian] Token usage falhou: ${error.message}\n`);
+    process.stderr.write(`[wendkeep] Token usage falhou: ${error.message}\n`);
     process.exitCode = 1;
   }
 }

package/hooks/vault-health.mjs

@@ -39,7 +39,7 @@ function parseArgs(argv) {
 function findDuplicateTurnMarkers(content) {
   const seen = new Set();
   const duplicated = new Set();
-  const regex = /<!-- codex-turn: ([^>]+) -->/g;
+  const regex = /<!-- (?:wk-turn|codex-turn): ([^>]+) -->/g;
   let match;
   while ((match = regex.exec(content)) !== null) {
     const turnId = match[1].trim();
@@ -104,10 +104,10 @@ function checkSession({ vaultBase, sessionRel, control, registry }) {
 
   const content = readFileSync(sessionPath, 'utf-8');
   const duplicates = findDuplicateTurnMarkers(content);
-  metrics.turnMarkers = (content.match(/<!-- codex-turn:/g) || []).length;
+  metrics.turnMarkers = (content.match(/<!-- (?:wk-turn|codex-turn):/g) || []).length;
   metrics.duplicateTurnMarkers = duplicates.length;
 
-  if (duplicates.length) failures.push(`Marcadores codex-turn duplicados: ${duplicates.join(', ')}`);
+  if (duplicates.length) failures.push(`Marcadores de turno duplicados: ${duplicates.join(', ')}`);
   if (hasHeadingAfterClosing(content)) failures.push('Há headings/iterações após ## Encerramento.');
   if (!usageSectionIsPlaced(content)) failures.push('## Uso de tokens e custos está fora da posição esperada.');
   if (hasDefaultPending(content)) warnings.push('Pendências ainda contém placeholders padrão.');
@@ -197,7 +197,7 @@ if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href)
   try {
     main();
   } catch (error) {
-    process.stderr.write(`[codex-obsidian] Vault health falhou: ${error.message}\n`);
+    process.stderr.write(`[wendkeep] Vault health falhou: ${error.message}\n`);
     process.exitCode = 1;
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wendkeep",
-  "version": "0.29.1",
+  "version": "0.29.2",
   "description": "A persistent-memory harness for AI coding agents on your Obsidian vault: turn-by-turn session capture plus a native, zero-dependency spec→change→verify→archive loop (sensor-gated, independent verdict, mutation discrimination). Local-first, agent-agnostic (Claude Code, Codex, Cursor…).",
   "type": "module",
   "bin": {