wendkeep 0.41.0 → 0.42.0

package/CHANGELOG.md

@@ -4,6 +4,17 @@ 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.42.0] — 2026-07-17
+
+### Changed
+
+- `wendkeep renumber-decisions --apply` agora **move** as notas de subpastas `DIA N` para a
+  pasta do mês da sua data (achatando o legado), consistente com `renumber-bugs`/
+  `renumber-learnings` do 0.41.0. Antes só renomeava in-place para `ADR-NNNN-<slug>` e
+  deixava as pastas de dia intactas. Os wikilinks já eram reescritos vault-wide; agora
+  acompanham o novo caminho de mês, e as pastas `DIA` que ficam vazias são removidas.
+  Notas sem data resolvível preservam a pasta atual (nunca são perdidas). Idempotente.
+
 ## [0.41.0] — 2026-07-16
 
 ### Added

package/README.md

@@ -138,14 +138,18 @@ Restart Codex and Claude Code after reseeding their generated skills.
 | `wendkeep cost rebuild [opts]` | Recalcula custos históricos do transcript principal e subagents usando `SESSION_REGISTRY`. Dry-run por padrão; `--apply` atualiza notas e grava `.brain/COST_REBUILD.json`. Aceita `--session`, `--limit` e `--json`. |
 | `wendkeep session list\|show\|use` | Lista o registry multi-sessão, mostra uma conversa ou muda somente o foco humano de `CURRENT_SESSION.md`. |
 | `wendkeep change bind <slug> --session <id>` | Vincula ou transfere uma change para uma conversa canônica sem esconder as demais pendências. |
-
-Session notes use one live `## Agentes, tokens e custos` snapshot. Main-agent and subagent hooks recompose it atomically, with costs, token dimensions, reasoning tokens and effort per model/source.
+| `wendkeep note new --type bug\|learning "<title>"` | Create a **numbered** derived note (`BUG-`/`APR-NNNN`) in the month folder and print its vault path. `--date YYYY-MM-DD`. |
+| `wendkeep renumber-decisions` | Renumber `04-Decisões` to `ADR-NNNN-<slug>` chronologically, move notes out of legacy `DIA N` subfolders into the month folder, and rewrite wikilinks. Preview by default; `--apply` / `--json`. |
+| `wendkeep renumber-bugs` | Same for `05-Bugs` → `BUG-NNNN-<slug>`. |
+| `wendkeep renumber-learnings` | Same for `06-Aprendizados`/`06-Learnings` → `APR-NNNN-<slug>`. |
 | `wendkeep lesson add "t" "l"` | Record a project-local lesson (injected at the next SessionStart). |
 | `wendkeep sync-defs` | Copy `.brain/agents\|skills` into `.codex/agents`, `.claude/skills`, `.agents/skills`; `--check` detects drift. |
 | `wendkeep validate-memory [path]` | Validate `.brain/CORE.md` (cap 25, 3 sections, no secrets/PII). |
 | `wendkeep doctor [--vault P]` | Run a vault health check (integrity of sessions, registry, links). |
 | `wendkeep --version` / `--help` | Version / usage. |
 
+Session notes use one live `## Agentes, tokens e custos` snapshot. Main-agent and subagent hooks recompose it atomically, with costs, token dimensions, reasoning tokens and effort per model/source.
+
 ## Retroactive memory (`import`) — install today, remember yesterday
 
 Install wendkeep into an existing project and it only remembers sessions **from now on**. `wendkeep import` fixes that: one command backfills your project's past **Claude & Codex** sessions into the vault — deduped, dated, with cost — so the graph starts full, not empty. It rebuilds each transcript as a full session note in its **real** date folder — frontmatter (tagged with the transcript's real provider), one iteration block per turn, cost + subagent telemetry, derived decision/bug/learning notes, finalized closing. An offline replay of the live capture flow, so an imported note is indistinguishable from a captured one.
@@ -162,6 +166,43 @@ wendkeep import --vault .myproject-vault --source codex   # just Codex
 - **`--from <dir>`** / **`--codex-from <dir>`** point at the transcript folders explicitly (use if the auto-derived path misses). Also: `--since <date>`, `--limit <n>`, `--json`.
 - Once imported, `wendkeep cost` aggregates your entire history — retroactively, across both agents.
 
+## Derived notes — numbered like ADRs (`note new`, `renumber-*`)
+
+Decisions, bugs and learnings are **derived notes**: they live in the month folder of their tree (`<folder>/<year>/<MM-MON>/`) and carry a sequential id — `ADR-0001`, `BUG-0001`, `APR-0001`. One glance tells you what a note is and where it sits in the project's history. No day-level subfolders: a `DIA N` folder holding one note is noise, and it hides the note from folder-wide search.
+
+**Creating one** (never write the file by hand — the command owns the number, the folder and the frontmatter):
+
+```bash
+wendkeep note new --type bug "login 500s when the token expires mid-refresh"
+# → 05-Bugs/2026/07-JUL/BUG-0007-login-500s-when-the-token-expires.md
+
+wendkeep note new --type learning "a regex without /g only ever returns the first match"
+# → 06-Aprendizados/2026/07-JUL/APR-0003-a-regex-without-g-only-ever-returns.md
+```
+
+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.
+
+**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
+# Bugs — 05-Bugs → BUG-NNNN
+wendkeep renumber-bugs                  # preview: prints every from → to, writes nothing
+wendkeep renumber-bugs --apply          # migrate
+
+# Learnings — 06-Aprendizados → APR-NNNN
+wendkeep renumber-learnings             # preview
+wendkeep renumber-learnings --apply     # migrate
+
+# Decisions — 04-Decisões → ADR-NNNN (since 0.30.0)
+wendkeep renumber-decisions             # preview
+wendkeep renumber-decisions --apply     # migrate
+```
+
+- **Preview is the default.** Nothing is written until `--apply` — read the `from → to` list first; that is where a mangled slug shows up, before it touches your files.
+- **One tree at a time, on purpose.** There is no `renumber-all`: each folder is migrated and reviewed on its own.
+- **Order is chronological**, derived from the note's date (frontmatter → filename prefix → folder), so `BUG-0001` is genuinely the oldest bug — not the first one the scanner happened to read.
+- **Wikilinks are rewritten vault-wide** (full-path and basename forms, aliases preserved), the body's `type`/`bug:`/`apr:`/H1 are normalized, and emptied `DIA` folders are removed. **Idempotent**: a second `--apply` renames nothing. Close Obsidian while migrating, and commit the vault first if it is under git.
+
 ## Change lifecycle — the a2 loop (spec‑driven, native)
 
 Beyond capturing sessions, wendkeep is a **harness**: a native, zero‑dependency loop that keeps *intent* (specs), *work* (changes) and *proof* (sensors) together in the vault, wikilinked into the Obsidian graph.

package/hooks/renumber-decisions.mjs

@@ -5,9 +5,10 @@
 // chronological order (the order decisions were made), renames the files in place, updates every
 // wikilink to them across the whole vault, and normalizes each note's `type`/`adr`/H1. Idempotent:
 // running it again on an already-canonical vault is a no-op (same order, same names).
-import { readdirSync, readFileSync, renameSync, writeFileSync, existsSync } from 'node:fs';
+import { readdirSync, readFileSync, renameSync, rmdirSync, writeFileSync, existsSync } from 'node:fs';
 import { join, dirname, relative } from 'node:path';
 import { getLocale } from './locale.mjs';
+import { ensureDir, monthFolderRelFromDateStr } from './obsidian-common.mjs';
 
 export const padAdr = (n) => String(n).padStart(4, '0');
 
@@ -29,17 +30,25 @@ function walkDecisions(vaultBase, decisionsDir) {
   return out;
 }
 
+// Resolve a decision's date: frontmatter `date:` > filename `YYYY-MM-DD` prefix > dated folder
+// (`.../YYYY/MM-.../DIA N/`). Returns '' when nothing is derivable. Used by both the sort key
+// and the destination-folder computation (so a note is filed under the month of its real date).
+export function decisionDate({ abs, base, content }) {
+  const c = content ?? (existsSync(abs) ? safeRead(abs) : '');
+  const fmDate = c.match(/^date:\s*(\d{4}-\d{2}-\d{2})/m);
+  if (fmDate) return fmDate[1];
+  const fnDate = base.match(/^(\d{4}-\d{2}-\d{2})/);
+  if (fnDate) return fnDate[1];
+  const folderDate = String(abs).replaceAll('\\', '/').match(/\/(\d{4})\/(\d{2})-[^/]+\/DIA\s+(\d{1,2})\//i);
+  if (folderDate) return `${folderDate[1]}-${folderDate[2]}-${String(folderDate[3]).padStart(2, '0')}`;
+  return '';
+}
+
 // Chronological sort key: date, then time, then existing ADR number, then filename — all derived
 // from (in priority) frontmatter, filename prefix, and the dated folder path.
 export function decisionSortKey({ abs, base, content }) {
   const c = content ?? (existsSync(abs) ? safeRead(abs) : '');
-  const fmDate = c.match(/^date:\s*(\d{4}-\d{2}-\d{2})/m);
-  const fnDate = base.match(/^(\d{4}-\d{2}-\d{2})/);
-  const folderDate = abs.replaceAll('\\', '/').match(/\/(\d{4})\/(\d{2})-[^/]+\/DIA\s+(\d{1,2})\//i);
-  let date = '9999-12-31';
-  if (fmDate) date = fmDate[1];
-  else if (fnDate) date = fnDate[1];
-  else if (folderDate) date = `${folderDate[1]}-${folderDate[2]}-${String(folderDate[3]).padStart(2, '0')}`;
+  const date = decisionDate({ abs, base, content: c }) || '9999-12-31';
 
   const fmTime = c.match(/^started_at:\s*\S*T(\d{2}:\d{2}:\d{2})/m);
   const srcTime = c.match(/\[\[[^\]]*\/(\d{2})-(\d{2})-[^\]]*\]\]/); // session wikilink HH-MM prefix
@@ -131,13 +140,16 @@ export function planRenumber(vaultBase) {
     const num = i + 1;
     const slug = slugFromDecisionName(n.base);
     const newBase = `ADR-${padAdr(num)}-${slug}.md`;
-    const folderRel = dirname(n.rel);
-    const newRel = folderRel === '.' ? newBase : `${folderRel}/${newBase}`;
+    // Destination = the month folder of the note's date (like renumber-derived): flatten legacy
+    // `DIA N` subfolders. No derivable date -> keep the current dirname (never lose the note).
+    const date = decisionDate(n);
+    const destDirRel = date ? monthFolderRelFromDateStr(decisionsDir, date, vaultBase) : dirname(n.rel);
+    const newRel = `${destDirRel.replaceAll('\\', '/')}/${newBase}`;
     const oldAdr = n.base.match(/^ADR-(\d+)/i);
     renames.push({
       num, slug,
       oldAbs: n.abs,
-      newAbs: join(dirname(n.abs), newBase),
+      newAbs: join(vaultBase, destDirRel, newBase),
       oldRelNoExt: n.rel.replace(/\.md$/i, ''),
       newRelNoExt: newRel.replace(/\.md$/i, ''),
       oldBaseNoExt: n.base.replace(/\.md$/i, ''),
@@ -173,11 +185,12 @@ export function renumberDecisions(vaultBase, { apply = false } = {}) {
     temps.set(r, tmp);
   });
 
-  // Phase B — normalize each note's body, then land it at its final path. For a renamed note we
-  // write the normalized content back over its temp and renameSync temp -> final (no delete: the
-  // temp file becomes the final file). For an unchanged name we just rewrite in place.
+  // Phase B — normalize each note's body, then land it at its final path (possibly a different
+  // month directory). For a renamed note we write the normalized content over its temp and
+  // renameSync temp -> final; for an unchanged name we rewrite in place.
   for (const r of renames) {
     const tmp = temps.get(r);
+    ensureDir(dirname(r.newAbs));
     if (tmp) {
       writeFileSync(tmp, normalizeDecisionContent(safeRead(tmp), r.num), 'utf8');
       renameSync(tmp, r.newAbs);
@@ -194,5 +207,25 @@ export function renumberDecisions(vaultBase, { apply = false } = {}) {
     const after = rewriteLinks(before, linkRenames);
     if (after !== before) { writeFileSync(abs, after, 'utf8'); report.filesTouched += 1; report.linksUpdated += 1; }
   }
+
+  // Phase D — drop legacy `DIA *` folders left empty by the move to the month folder.
+  pruneEmptyDayFolders(vaultBase, getLocale(vaultBase).folders.decisions);
   return report;
 }
+
+// Remove now-empty `DIA *` folders under the decisions root (best-effort, fail-quiet).
+function pruneEmptyDayFolders(vaultBase, folderRel) {
+  const walk = (dir) => {
+    let entries;
+    try { entries = readdirSync(dir, { withFileTypes: true }); } catch { return; }
+    for (const e of entries) {
+      if (!e.isDirectory()) continue;
+      const abs = join(dir, e.name);
+      walk(abs);
+      if (/^DIA\s/i.test(e.name)) {
+        try { rmdirSync(abs); } catch { /* não-vazio — fica */ }
+      }
+    }
+  };
+  walk(join(vaultBase, folderRel));
+}

package/package.json

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