wendkeep 0.47.0 → 0.49.0

package/CHANGELOG.md

@@ -4,6 +4,34 @@ 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.49.0] — 2026-07-23
+
+### Added
+
+- **`wendkeep doctor` agora surfaça os órfãos do grafo com o comando de reparo.** Nova seção
+  `[links]`: conta notas derivadas sem sessão-fonte (→ `note relink`), artefatos de change
+  sem backlink (→ `change backlink`) e o estado das cores do grafo (→ `theme sync`); quando
+  tudo conectado, diz `grafo conectado`. Reusa as funções de reparo em dry-run — zero lógica
+  nova de detecção. Antes o dono do vault só descobria os órfãos olhando o grafo no Obsidian
+  e não sabia qual comando rodava.
+- **Sessão não mente "inativa" com atividade recente.** Nova seção `[sessão]`: quando o
+  control marca `inactive` mas a nota da sessão foi escrita há pouco, o doctor sinaliza
+  possível workflow/subagente em segundo plano — o control só reflete o lifecycle da
+  sessão-mãe, não a atividade de background. Capability `vault-doctor` (DIAG-1..4).
+
+## [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/harness-doctor.mjs

@@ -1,10 +1,12 @@
 // hooks/harness-doctor.mjs — integrity checks for the a2 harness state (Wave B).
 // Pure-ish (fs reads only). `wendkeep doctor` reports errors (exit 1) + warnings.
-import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
 import { join } from 'node:path';
-import { activeChange, parseTasks } from './change-core.mjs';
+import { activeChange, parseTasks, backfillArtifactLinks } from './change-core.mjs';
+import { relinkDerivedNotes } from './linked-notes.mjs';
 import { buildEffectiveRequirementPackage, checkSpecsState, evaluateVerdict, tasksHashOf, validateSpecImpact } from './spec-core.mjs';
 import { getLocale } from './locale.mjs';
+import { readControl } from './obsidian-common.mjs';
 
 export function checkHarness(vaultBase, projectRoot) {
   const loc = getLocale(vaultBase);
@@ -63,3 +65,37 @@ export function checkHarness(vaultBase, projectRoot) {
 
   return { errors, warnings };
 }
+
+// --- diagnóstico de links do grafo (read-only, reusa os reparos em dry-run) -----
+// Surfaça os órfãos que o doctor não enxergava: notas derivadas sem sessão-fonte,
+// artefatos de change sem backlink, e o estado das cores do grafo. Cada não-zero tem um
+// comando de reparo (note relink / change backlink / theme sync).
+export function checkVaultLinks(vaultBase) {
+  let derivedOrphans = 0;
+  try { derivedOrphans = relinkDerivedNotes(vaultBase, {}).linked.length; } catch { /* sem notas derivadas */ }
+  let artifactOrphans = 0;
+  try { artifactOrphans = backfillArtifactLinks(vaultBase, {}).changed.length; } catch { /* sem changes */ }
+  let graphColors = null; // true=com grupos · false=vazio/ausente de cores · null=sem graph.json
+  try {
+    const g = JSON.parse(readFileSync(join(vaultBase, '.obsidian', 'graph.json'), 'utf8'));
+    graphColors = Array.isArray(g.colorGroups) && g.colorGroups.length > 0;
+  } catch { graphColors = null; }
+  return { derivedOrphans, artifactOrphans, graphColors };
+}
+
+const unquoteControl = (v) => String(v ?? '').replace(/^"(.*)"$/, '$1').trim();
+
+// O control marca `inactive` quando a sessão-mãe encerra, mesmo com um workflow/subagente
+// ainda vivo em background. Se a nota da sessão foi escrita há pouco apesar do `inactive`,
+// sinaliza a atividade recente — o doctor deixa de dizer "inativa" quando não está.
+export function checkSessionActivity(vaultBase, { now = Date.now(), windowMs = 5 * 60000 } = {}) {
+  const control = readControl(vaultBase);
+  const active = unquoteControl(control.status) === 'active';
+  const sessionRel = unquoteControl(active ? control.session_file : (control.last_session_file || control.session_file));
+  let ageMs = null;
+  if (sessionRel) {
+    try { ageMs = now - statSync(join(vaultBase, sessionRel)).mtimeMs; } catch { ageMs = null; }
+  }
+  const backgroundSuspected = !active && sessionRel !== '' && ageMs !== null && ageMs >= 0 && ageMs < windowMs;
+  return { lastSession: sessionRel, active, ageMs, backgroundSuspected };
+}