wendkeep 0.54.0 → 0.55.0

package/CHANGELOG.md

@@ -4,6 +4,22 @@ 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.55.0] — 2026-07-25
+
+### Fixed
+
+- **O `[derivadas]` do doctor deixa de acusar nota já correta.** O `doctor` reportava
+  `5 link(s) faltando` numa nota onde os cinco estavam presentes; o
+  `note repair-sections --apply` rodava, não mudava nada (`unchanged`), e o doctor voltava a
+  acusar — um vermelho que nenhum reparo fechava. Causa: detector e reparador localizavam a
+  seção por critérios diferentes — `## <heading>` como substring solta contra
+  `\n## <heading>\n` ancorado. Numa nota de sessão isso é fatal, porque ela transcreve a
+  conversa, e uma conversa **sobre** as seções cita os nomes delas: o detector casava a
+  menção em prosa e lia o texto errado. Agora existe um localizador único
+  (`findSectionBounds`) por onde detector e reparo obrigatoriamente passam — corrigir apenas
+  o marcador deixaria dois localizadores independentes, que foi como o bug nasceu.
+  Capability `vault-doctor` (DIAG-7).
+
 ## [0.54.0] — 2026-07-25
 
 ### Added

package/hooks/derived-sections.mjs

@@ -108,11 +108,25 @@ export function listSessionNotes(vaultBase) {
   return out;
 }
 
+// Localizador ÚNICO da seção — detector e reparador passam por aqui.
+//
+// Um heading Markdown começa em coluna zero; casar `## X` como substring solta encontra
+// qualquer menção em prosa. A nota de sessão é justamente o lugar onde isso acontece: ela
+// transcreve a conversa, e uma conversa SOBRE as seções cita os nomes delas. Foi assim que
+// o detector passou a acusar links faltando que estavam presentes na seção verdadeira,
+// enquanto o reparo (que já usava o marcador ancorado) não achava nada a fazer.
+export function findSectionBounds(content, heading) {
+  const marker = `\n## ${heading}\n`;
+  const start = content.indexOf(marker);
+  if (start === -1) return null;
+  const bodyStart = start + marker.length;
+  const nextRel = content.slice(bodyStart).search(/\n## /);
+  return { start, bodyStart, bodyEnd: nextRel === -1 ? content.length : bodyStart + nextRel };
+}
+
 const sectionBody = (content, heading) => {
-  const i = content.indexOf(`## ${heading}`);
-  if (i < 0) return null;
-  const j = content.indexOf('\n## ', i + 3);
-  return content.slice(i, j < 0 ? content.length : j);
+  const at = findSectionBounds(content, heading);
+  return at ? content.slice(at.start, at.bodyEnd) : null;
 };
 
 // O que a nota DEVERIA listar mas não lista. Excedente (link posto à mão) não é sintoma
@@ -185,12 +199,9 @@ export const isDerivedPlaceholder = (line) => /^-?\s*Nenhum[ao]?\s+\S+.*registra
 // vault escreveu na seção não pode sumir num conserto automático.
 function defaultUpsert(content, heading, lines) {
   if (!lines.length) return content;
-  const marker = `\n## ${heading}\n`;
-  const start = content.indexOf(marker);
-  if (start === -1) return content; // heading ausente: nunca inventa seção em nota alheia
-  const bodyStart = start + marker.length;
-  const nextRel = content.slice(bodyStart).search(/\n## /);
-  const bodyEnd = nextRel === -1 ? content.length : bodyStart + nextRel;
+  const at = findSectionBounds(content, heading);
+  if (!at) return content; // heading ausente: nunca inventa seção em nota alheia
+  const { bodyStart, bodyEnd } = at;
 
   const prose = [];
   const items = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wendkeep",
-  "version": "0.54.0",
+  "version": "0.55.0",
   "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": {
@@ -46,6 +46,6 @@
     "url": "https://github.com/rogersialves/wendkeep/issues"
   },
   "devDependencies": {
-    "wendkeep": "^0.52.0"
+    "wendkeep": "^0.54.0"
   }
 }