wendkeep 0.47.0 → 0.48.0

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.48.0] — 2026-07-23
+
+### Added
+
+- **`wendkeep note relink [--apply]` — backfill de proveniência das notas derivadas
+  órfãs.** BUG/APR legadas (criadas por versão antiga, sem `source:` de sessão) ficam ilhas
+  no grafo — num vault real: 13 de 15 BUG e 3 de 8 APR sem nenhum link de entrada nem de
+  saída. A origem não está registrada no órfão, mas os irmãos não-órfãos do mesmo tipo
+  carregam a sessão-fonte real. O comando liga cada órfão herdando a sessão **modal** (mais
+  comum) dos irmãos do mesmo tipo e mês, injetando `source:` + `related:` no frontmatter.
+  Dry-run por default; `--apply` escreve; idempotente; pula e reporta o órfão sem nenhum
+  irmão-fonte pra inferir (nunca chuta). Documentado em `derived-notes` (DRV-9).
+
 ## [0.47.0] — 2026-07-23
 
 ### Added

package/README.md

@@ -184,6 +184,8 @@ wendkeep note new --type learning "a regex without /g only ever returns the firs
 
 It prints the created path, numbers from the current max (recursive scan), files it in the month folder for today (`--date YYYY-MM-DD` to override), and links the active session in `source:` so the graph stays connected. Agents get this rule injected at SessionStart — they call the command instead of guessing a filename.
 
+**Reconnecting legacy notes.** Derived notes created by older versions carry no `source:` session and sit as islands in the graph. `wendkeep note relink` backfills them: each orphan inherits the modal source session of its type/month cohort (the session its non-orphan siblings already point to). Dry-run by default; `--apply` writes; notes with no sibling to infer from are skipped and reported.
+
 **Migrating an existing vault.** Notes created before `0.41.0` have date-prefixed names (`2026-07-16-bug-<slug>.md`) and may sit in legacy `DIA N` subfolders. One command per tree renumbers them chronologically, moves them up into the month folder, and rewrites every wikilink across the vault:
 
 ```bash

package/bin/wendkeep.mjs

@@ -77,6 +77,9 @@ Usage:
   wendkeep renumber-learnings   Same for 06-Aprendizados/06-Learnings with APR-<NNNN>-<slug>.
   wendkeep note new --type bug|learning "<título>"  Create a numbered derived note (BUG-/APR-NNNN)
                            in the month folder and print its vault path. --date YYYY-MM-DD · --vault P.
+  wendkeep note relink [--apply]  Backfill orphan derived notes (BUG/APR without a source session),
+                           linking each to the modal source session of its type/month cohort. Dry-run
+                           by default; --apply writes; skips notes with no sibling to infer from.
   wendkeep lesson add "t" "l"   Record a project-local lesson (injected at SessionStart).
   wendkeep validate-memory [path]  Validate .brain/CORE.md against the compaction
                            protocol (cap 25, 3 sections, no secrets/PII). Uses

package/hooks/linked-notes.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { existsSync, readFileSync, readdirSync, writeFileSync } from 'fs';
-import { basename, join } from 'path';
+import { basename, join, relative } from 'path';
 import {
   monthFolderRelFromDateStr,
   derivedContentKey,
@@ -63,6 +63,77 @@ function sessionYamlLinks(sessionRel) {
   ].join('\n');
 }
 
+// --- note relink: backfill de proveniência das notas derivadas órfãs (DRV-9) -----
+// Nota derivada legada (BUG/APR criada por wendkeep antigo) nasce sem `source:` de sessão —
+// ilha no grafo. A origem não está registrada nela, mas os irmãos NÃO-órfãos do mesmo tipo
+// carregam a sessão-fonte real: o órfão herda a sessão MODAL (mais comum) do seu (tipo, mês).
+
+// Extrai a sessão do primeiro `source: - [[...]]` do frontmatter (vazio se não houver).
+function sourceSessionOf(content) {
+  const m = content.match(/^source:\s*\n\s*-\s*"?\[\[([^\]"|]+)/m);
+  return m ? m[1].trim() : '';
+}
+
+// Injeta source+related antes do `---` de fechamento do frontmatter. Sem frontmatter, no-op.
+function insertSourceLinks(content, sessionRel) {
+  const m = content.match(/^(---\n[\s\S]*?\n)(---\n)/);
+  if (!m) return content;
+  return `${m[1]}${sessionYamlLinks(sessionRel)}\n${m[2]}${content.slice(m[0].length)}`;
+}
+
+function modalKey(counts) {
+  const entries = Object.entries(counts || {});
+  if (!entries.length) return '';
+  entries.sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]));
+  return entries[0][0];
+}
+
+export function relinkDerivedNotes(vaultBase, { apply = false } = {}) {
+  const loc = getLocale(vaultBase);
+  const monthOf = (abs) => relative(vaultBase, abs).replaceAll('\\', '/').split('/').slice(0, 3).join('/');
+  const linked = [];
+  const skipped = [];
+  for (const [folderKey, prefix] of [['bugs', 'BUG'], ['learnings', 'APR']]) {
+    const root = join(vaultBase, loc.folders[folderKey]);
+    const files = [];
+    const walk = (dir) => {
+      let entries;
+      try { entries = readdirSync(dir, { withFileTypes: true }); } catch { return; }
+      for (const e of entries) {
+        const p = join(dir, e.name);
+        if (e.isDirectory()) walk(p);
+        else if (e.name.endsWith('.md') && e.name.startsWith(`${prefix}-`)) files.push(p);
+      }
+    };
+    walk(root);
+    const byMonth = {};
+    const typeWide = {};
+    const orphans = [];
+    for (const p of files) {
+      let c;
+      try { c = readFileSync(p, 'utf8'); } catch { continue; }
+      const src = sourceSessionOf(c);
+      if (src) {
+        (byMonth[monthOf(p)] ??= {})[src] = ((byMonth[monthOf(p)] || {})[src] || 0) + 1;
+        typeWide[src] = (typeWide[src] || 0) + 1;
+      } else {
+        orphans.push({ p, c });
+      }
+    }
+    for (const o of orphans) {
+      const rel = relative(vaultBase, o.p).replaceAll('\\', '/');
+      const session = modalKey(byMonth[monthOf(o.p)]) || modalKey(typeWide);
+      if (!session) { skipped.push({ file: rel, reason: 'sem irmão com source para inferir' }); continue; }
+      if (apply) {
+        try { writeFileSync(o.p, insertSourceLinks(o.c, session), 'utf8'); }
+        catch { skipped.push({ file: rel, reason: 'escrita falhou' }); continue; }
+      }
+      linked.push({ file: rel, session: basename(session) });
+    }
+  }
+  return { applied: apply, linked, skipped };
+}
+
 function extractIssueRefs(tx) {
   const text = [
     assistantText(tx),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wendkeep",
-  "version": "0.47.0",
+  "version": "0.48.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": {

package/src/note.mjs

@@ -14,7 +14,7 @@ import {
   toVaultRelative,
 } from '../hooks/obsidian-common.mjs';
 import { getLocale } from '../hooks/locale.mjs';
-import { buildManualBugNote, buildManualLearningNote } from '../hooks/linked-notes.mjs';
+import { buildManualBugNote, buildManualLearningNote, relinkDerivedNotes } from '../hooks/linked-notes.mjs';
 
 const TYPES = {
   bug: { folderKey: 'bugs', prefix: 'BUG', build: buildManualBugNote },
@@ -30,8 +30,23 @@ function opt(argv, name) {
 
 export function runNote(argv) {
   const [sub, ...rest] = argv;
+
+  if (sub === 'relink') {
+    const vaultRaw = opt(rest, '--vault') || process.env.OBSIDIAN_VAULT_PATH;
+    if (!vaultRaw) { process.stderr.write('wendkeep note relink: no vault (--vault or OBSIDIAN_VAULT_PATH).\n'); process.exit(2); }
+    const vaultBase = isAbsolute(vaultRaw) ? vaultRaw : resolve(process.cwd(), vaultRaw);
+    if (!existsSync(vaultBase)) { process.stderr.write(`wendkeep note relink: vault not found: ${vaultBase}\n`); process.exit(2); }
+    const r = relinkDerivedNotes(vaultBase, { apply: rest.includes('--apply') });
+    if (rest.includes('--json')) { process.stdout.write(`${JSON.stringify(r, null, 2)}\n`); process.exit(0); }
+    process.stdout.write(`${r.linked.length} nota(s) derivada(s) órfã(s)${r.applied ? ' linkadas' : ' seriam linkadas'}\n`);
+    for (const l of r.linked) process.stdout.write(`  ${l.file} -> ${l.session}\n`);
+    for (const s of r.skipped) process.stdout.write(`  pulado: ${s.file} (${s.reason})\n`);
+    if (!r.applied && r.linked.length) process.stdout.write('\ndry-run — nada escrito. Rode com --apply para injetar os backlinks.\n');
+    process.exit(0);
+  }
+
   if (sub !== 'new') {
-    process.stderr.write('wendkeep note: subcomando desconhecido (use `note new --type bug|learning "<título>"`).\n');
+    process.stderr.write('wendkeep note: subcomando desconhecido (use `note new --type bug|learning "<título>"` ou `note relink [--apply]`).\n');
     process.exit(2);
   }