wendkeep 0.7.0 → 0.8.1

package/CHANGELOG.md

@@ -4,6 +4,42 @@ 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.8.1] — 2026-07-06
+
+Polish: i18n coherence + presentation.
+
+### Added
+- **Locale-aware process skills + vault docs:** an `en` vault now seeds the `wk-*` skills,
+  the vault README, the change template, and the specs README in English (previously
+  Portuguese regardless of locale). Completes the `--locale en` promise.
+- **`wendkeep.sensors.json` at the repo root** — the project gates itself with its own
+  test/check sensors (dogfooding the harness).
+
+### Changed
+- npm `description` now describes the harness + a2 loop (was capture-only).
+- CI: `actions/checkout` and `actions/setup-node` bumped to `v5` (v4 runner deprecation).
+- README: the i18n "known limitation" is resolved.
+
+## [0.8.0] — 2026-07-05
+
+Reach: internationalization + agent-agnostic distribution.
+
+### Added
+- **Vault locale (i18n):** `wendkeep init --locale en` creates an English vault
+  (`02-Sessions`, `04-Decisions`, `08-Changes`, …, English months, English change scaffold,
+  English CORE skeleton, localized theme/graph groups). The locale is a vault property
+  (`.brain/config.json`), locked at init; absent = `pt-BR` — existing vaults are untouched
+  and never renamed. Parsers are **bilingual everywhere** (`Requisito|Requirement`,
+  `mata mutante|kill mutant`, CORE section sets), so mixed content never breaks.
+- **AGENTS.md managed section:** `sync-defs`/`init` maintain a marker-delimited section in
+  the project's `AGENTS.md` (loop summary + skill inventory) — one file that Codex, Amp,
+  Cursor, Zed and any AGENTS.md-reading agent picks up. User content around it is preserved.
+- **Harness contract v1.2** (`docs/14`): locale + AGENTS.md channel.
+
+### Deferred
+- Extra mutation-report formats (mutmut/PIT) and per-agent session-hook wiring — backlog
+  (`docs/17`).
+
 ## [0.7.0] — 2026-07-05
 
 Ergonomics: the loop without hand-editing files.
@@ -160,6 +196,8 @@ Initial release — the capture engine, extracted from a system in daily product
 - `wendkeep init` (cross-platform installer) + optional `@bitbonsai/mcpvault` MCP server.
 
 <!-- Only v0.4.0+ is tagged in git (history starts here); older versions link to npm. -->
+[0.8.1]: https://github.com/rogersialves/wendkeep/releases/tag/v0.8.1
+[0.8.0]: https://github.com/rogersialves/wendkeep/releases/tag/v0.8.0
 [0.7.0]: https://github.com/rogersialves/wendkeep/releases/tag/v0.7.0
 [0.6.1]: https://github.com/rogersialves/wendkeep/releases/tag/v0.6.1
 [0.6.0]: https://github.com/rogersialves/wendkeep/releases/tag/v0.6.0

package/README.md

@@ -136,7 +136,7 @@ The agent's settings.json points each hook at `npx wendkeep hook …`. On `Stop`
 
 ## Known limitations (`v0.1`)
 
-- **Vault folder names and month labels are Portuguese** (`02-Sessões`, `04-Decisões`, …), hardcoded in the hooks. Internationalization is not done yet — the taxonomy `wendkeep init` creates matches what the hooks expect on purpose.
+- **Vault folder names default to Portuguese** (`02-Sessões`, `04-Decisões`, …). Pass `wendkeep init --locale en` for an English vault (`02-Sessions`, `04-Decisions`, English scaffold/skills). The locale is a vault property, locked at init; parsers are bilingual so mixed content never breaks.
 - **Search is keyword/frontmatter scoring**, not on‑device embeddings (that's on the roadmap).
 - **Transcript formats are agent‑internal** and can change between agent versions; parsing is isolated but may need updates.
 - Installer wires **Claude Code** settings + `.mcp.json`. Codex hooks run on the same scripts but are not auto‑wired yet.

package/hooks/brain-core.mjs

@@ -3,6 +3,7 @@
 import { readdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { ensureDir, stripYamlQuotes, toVaultRelative } from './obsidian-common.mjs';
+import { getLocale } from './locale.mjs';
 
 export function brainDir(vaultBase) {
   return join(vaultBase, '.brain');
@@ -60,7 +61,7 @@ function derivedLinks(content) {
 // Varre 02-Sessões/** e regrava .brain/index.jsonl inteiro. Provider-agnóstico.
 export function buildBrainIndex(vaultBase) {
   const rows = [];
-  for (const fp of walkMd(join(vaultBase, '02-Sessões'))) {
+  for (const fp of walkMd(join(vaultBase, getLocale(vaultBase).folders.sessions))) {
     let content;
     try { content = readFileSync(fp, 'utf8'); } catch { continue; }
     const fm = parseFrontmatter(content);

package/hooks/change-core.mjs

@@ -2,20 +2,20 @@
 // Native change/spec lifecycle in the vault (Pilar B). Vault-facing lib consumed by
 // the `wendkeep change` CLI (src/change.mjs) and the brain-inject hook. No external deps.
 import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
+import { dirname, join } from 'node:path';
 import { ensureDir, wikilinkFromRel } from './obsidian-common.mjs';
 import { parseSpecsList, promoteSpecs } from './spec-core.mjs';
+import { getLocale } from './locale.mjs';
 
-export const CHANGES_DIR = '08-Mudanças';
-export const SPECS_DIR = '07-Specs';
 export const ARCHIVE_DIR = '_arquivo';
 const POINTER = '.brain/CURRENT_CHANGE.md';
 
-export function changeDirRel(slug) {
-  return join(CHANGES_DIR, slug);
+export function changeDirRel(slug, vaultBase) {
+  return join(getLocale(vaultBase).folders.changes, slug);
 }
 
-export function renderChangeScaffold({ slug, sessionRel, dateStr }) {
+export function renderChangeScaffold({ slug, sessionRel, dateStr, locale = 'pt-BR' }) {
+  const en = locale === 'en';
   const source = sessionRel ? `\n  - "${wikilinkFromRel(sessionRel)}"` : ' []';
   const proposta = `---
 type: change
@@ -31,27 +31,20 @@ specs: []
 
 # ${slug}
 
-## Por quê
-
-(motivo da mudança)
-
-## O que muda
-
-(escopo da mudança)
+${en ? '## Why\n\n(reason for the change)\n\n## What changes\n\n(scope of the change)' : '## Por quê\n\n(motivo da mudança)\n\n## O que muda\n\n(escopo da mudança)'}
 `;
   const design = `# ${slug} — design
 
-## Abordagem
-
-(abordagem técnica)
+${en ? '## Approach\n\n(technical approach)' : '## Abordagem\n\n(abordagem técnica)'}
 `;
-  const tarefas = `# ${slug} — tarefas
+  const tarefas = `# ${slug} — ${en ? 'tasks' : 'tarefas'}
 
-- [ ] 1.1 (primeira tarefa)
+- [ ] 1.1 ${en ? '(first task)' : '(primeira tarefa)'}
 `;
+  const reqHeading = en ? 'Requirement' : 'Requisito';
   const specDelta = `## ADDED Requirements
-### Requisito: (nome)
-(comportamento / cenários)
+### ${reqHeading}: ${en ? '(name)' : '(nome)'}
+${en ? '(behaviour / scenarios)' : '(comportamento / cenários)'}
 
 ## MODIFIED Requirements
 
@@ -80,10 +73,11 @@ export function clearActiveChange(vaultBase) {
 }
 
 export function newChange(vaultBase, slug, { sessionRel = '', dateStr, simple = false }) {
-  const dir = join(vaultBase, CHANGES_DIR, slug);
+  const loc = getLocale(vaultBase);
+  const dir = join(vaultBase, loc.folders.changes, slug);
   const existed = existsSync(join(dir, 'proposta.md'));
   mkdirSync(dir, { recursive: true });
-  const files = renderChangeScaffold({ slug, sessionRel, dateStr });
+  const files = renderChangeScaffold({ slug, sessionRel, dateStr, locale: loc.id });
   const write = (name, content) => {
     const f = join(dir, name);
     if (!existsSync(f)) writeFileSync(f, content, 'utf8');
@@ -100,7 +94,7 @@ export function newChange(vaultBase, slug, { sessionRel = '', dateStr, simple =
     }
   }
   setActiveChange(vaultBase, slug);
-  return { rel: changeDirRel(slug), created: !existed };
+  return { rel: changeDirRel(slug, vaultBase), created: !existed };
 }
 
 export function parseTasks(md) {
@@ -135,7 +129,7 @@ export function setTaskDone(changeDir, taskId, done = true) {
 }
 
 export function listChanges(vaultBase) {
-  const base = join(vaultBase, CHANGES_DIR);
+  const base = join(vaultBase, getLocale(vaultBase).folders.changes);
   const active = [];
   let archived = [];
   try {
@@ -153,29 +147,33 @@ export function listChanges(vaultBase) {
 export function buildActiveChangeInjection(vaultBase, { maxTasks = 8 } = {}) {
   const slug = activeChange(vaultBase);
   if (!slug) return '';
+  const chDir = getLocale(vaultBase).folders.changes;
   let md = '';
-  try { md = readFileSync(join(vaultBase, CHANGES_DIR, slug, 'tarefas.md'), 'utf8'); } catch { return ''; }
+  try { md = readFileSync(join(vaultBase, chDir, slug, 'tarefas.md'), 'utf8'); } catch { return ''; }
   const open = parseTasks(md).filter((t) => !t.done).slice(0, maxTasks);
   const lines = open.map((t) => `- [ ] ${t.id} ${t.text}`);
   const more = open.length === maxTasks ? '\n*…mais tarefas em tarefas.md*' : '';
   return `<active_change>
-Mudança ativa: ${slug} — [[${CHANGES_DIR}/${slug}/proposta]]. Tarefas abertas:
+Mudança ativa: ${slug} — [[${chDir}/${slug}/proposta]]. Tarefas abertas:
 ${lines.join('\n')}${more}
 </active_change>`;
 }
 
 export function activeChangeLink(vaultBase) {
   const slug = activeChange(vaultBase);
-  return slug ? `Change ativa: [[${CHANGES_DIR}/${slug}/proposta]]` : '';
+  return slug ? `Change ativa: [[${getLocale(vaultBase).folders.changes}/${slug}/proposta]]` : '';
 }
 
 // Append fix tasks for surviving mutants to a change's tarefas.md (Wave B). Deduped by
 // file:line, numbered M.<n> continuing from any existing fix tasks. Returns count added.
 export function appendFixTasks(changeDir, mutants, sensorId) {
   const path = join(changeDir, 'tarefas.md');
+  // changeDir = <vault>/<changesDir>/<slug> — derive the vault for the locale verb.
+  const verb = getLocale(dirname(dirname(changeDir))).fixTaskVerb;
   let md = '';
   try { md = readFileSync(path, 'utf8'); } catch { /* nova */ }
-  const existing = new Set([...md.matchAll(/mata mutante (\S+):(\d+)/g)].map((m) => `${m[1]}:${m[2]}`));
+  // Dedup is bilingual so a vault that switched locale mid-change never duplicates.
+  const existing = new Set([...md.matchAll(/(?:mata mutante|kill mutant) (\S+):(\d+)/g)].map((m) => `${m[1]}:${m[2]}`));
   const nums = [...md.matchAll(/^-\s+\[[ x]\]\s+M\.(\d+)\b/gm)].map((m) => Number(m[1]));
   let n = nums.length ? Math.max(...nums) : 0;
   const lines = [];
@@ -184,7 +182,7 @@ export function appendFixTasks(changeDir, mutants, sensorId) {
     if (existing.has(key)) continue;
     existing.add(key);
     n += 1;
-    lines.push(`- [ ] M.${n} mata mutante ${mut.file}:${mut.line} (${mut.mutator}) [sensor:${sensorId}]`);
+    lines.push(`- [ ] M.${n} ${verb} ${mut.file}:${mut.line} (${mut.mutator}) [sensor:${sensorId}]`);
   }
   if (!lines.length) return 0;
   const sep = md === '' || md.endsWith('\n') ? '' : '\n';
@@ -198,11 +196,13 @@ export function gateGreen() {
 }
 
 export function archiveChange(vaultBase, slug, { gate = gateGreen, dateStr, adrNum }) {
-  const src = join(vaultBase, CHANGES_DIR, slug);
+  const loc = getLocale(vaultBase);
+  const chDir = loc.folders.changes;
+  const src = join(vaultBase, chDir, slug);
   const verdict = gate(src);
   if (!verdict.ok) return { ok: false, failing: verdict.failing || [] };
 
-  const destRel = join(CHANGES_DIR, ARCHIVE_DIR, `${dateStr}-${slug}`);
+  const destRel = join(chDir, ARCHIVE_DIR, `${dateStr}-${slug}`);
   const changeWikilink = wikilinkFromRel(join(destRel, 'proposta'));
 
   // Promote spec deltas into the living 07-Specs BEFORE moving (deltas live in src).
@@ -220,16 +220,16 @@ export function archiveChange(vaultBase, slug, { gate = gateGreen, dateStr, adrN
   let reqIds = [];
   try { reqIds = [...new Set(parseTasks(readFileSync(join(src, 'tarefas.md'), 'utf8')).map((t) => t.req).filter(Boolean))]; } catch { /* sem tarefas */ }
 
-  ensureDir(join(vaultBase, CHANGES_DIR, ARCHIVE_DIR));
+  ensureDir(join(vaultBase, chDir, ARCHIVE_DIR));
   renameSync(src, join(vaultBase, destRel));
 
   const [year] = String(dateStr).split('-');
-  const adrDirRel = join('04-Decisões', year);
+  const adrDirRel = join(loc.folders.decisions, year);
   ensureDir(join(vaultBase, adrDirRel));
   const num = String(adrNum).padStart(3, '0');
   const adrRel = join(adrDirRel, `ADR-${num}-${slug}.md`);
   const capLine = promoted.length
-    ? `\n\nCapabilities: ${promoted.map((c) => wikilinkFromRel(join(SPECS_DIR, c))).join(', ')}.`
+    ? `\n\nCapabilities: ${promoted.map((c) => wikilinkFromRel(join(loc.folders.specs, c))).join(', ')}.`
     : '';
   const reqLine = reqIds.length ? `\n\nRequisitos: ${reqIds.join(', ')}.` : '';
   writeFileSync(join(vaultBase, adrRel), `---

package/hooks/harness-doctor.mjs

@@ -4,11 +4,12 @@ import { existsSync, readFileSync, readdirSync } from 'node:fs';
 import { join } from 'node:path';
 import { activeChange, parseTasks } from './change-core.mjs';
 import { parseRequirements, parseSpecsList, parseDelta, evaluateVerdict } from './spec-core.mjs';
-
-const CHANGES_DIR = '08-Mudanças';
-const SPECS_DIR = '07-Specs';
+import { getLocale } from './locale.mjs';
 
 export function checkHarness(vaultBase, projectRoot) {
+  const loc = getLocale(vaultBase);
+  const CHANGES_DIR = loc.folders.changes;
+  const SPECS_DIR = loc.folders.specs;
   const errors = [];
   const warnings = [];
 

package/hooks/linked-notes.mjs

@@ -12,6 +12,7 @@ import {
   toVaultRelative,
   wikilinkFromRel,
 } from './obsidian-common.mjs';
+import { getLocale } from './locale.mjs';
 
 function yamlQuote(value) {
   return `"${String(value || '').replaceAll('"', '\\"')}"`;
@@ -446,7 +447,7 @@ _Registrar como este conhecimento pode ser reutilizado._
 `;
 }
 
-const DERIVED_FOLDERS = { bugs: '05-Bugs', decisions: '04-Decisões', learnings: '06-Aprendizados' };
+const derivedFoldersFor = (vaultBase) => { const f = getLocale(vaultBase).folders; return { bugs: f.bugs, decisions: f.decisions, learnings: f.learnings }; };
 
 function listMd(dir) {
   try { return readdirSync(dir).filter((f) => f.endsWith('.md')); } catch { return []; }
@@ -456,8 +457,8 @@ function listMd(dir) {
 function existingKeysForSession(vaultBase, sessionRel, dateStr) {
   const wikilink = wikilinkFromRel(sessionRel);
   const out = { bugs: [], decisions: [], learnings: [] };
-  for (const [type, folder] of Object.entries(DERIVED_FOLDERS)) {
-    const dir = join(vaultBase, monthFolderRelFromDateStr(folder, dateStr));
+  for (const [type, folder] of Object.entries(derivedFoldersFor(vaultBase))) {
+    const dir = join(vaultBase, monthFolderRelFromDateStr(folder, dateStr, vaultBase));
     for (const fileName of listMd(dir)) {
       try {
         const c = readFileSync(join(dir, fileName), 'utf-8');
@@ -477,9 +478,10 @@ function alreadyHasKey(keys, candidate) {
 export function createLinkedNotes(vaultBase, dateStr, sessionRel, tx, options = {}) {
   const linked = { decisions: [], bugs: [], learnings: [] };
   const provider = providerMeta(options.provider);
-  const bugsDir = join(vaultBase, monthFolderRelFromDateStr('05-Bugs', dateStr));
-  const decisionsDir = join(vaultBase, monthFolderRelFromDateStr('04-Decisões', dateStr));
-  const learningsDir = join(vaultBase, monthFolderRelFromDateStr('06-Aprendizados', dateStr));
+  const locF = getLocale(vaultBase).folders;
+  const bugsDir = join(vaultBase, monthFolderRelFromDateStr(locF.bugs, dateStr, vaultBase));
+  const decisionsDir = join(vaultBase, monthFolderRelFromDateStr(locF.decisions, dateStr, vaultBase));
+  const learningsDir = join(vaultBase, monthFolderRelFromDateStr(locF.learnings, dateStr, vaultBase));
   ensureDir(bugsDir);
   ensureDir(decisionsDir);
   ensureDir(learningsDir);

package/hooks/locale.mjs

@@ -0,0 +1,73 @@
+// hooks/locale.mjs — vault locale (i18n, 0.8.0). The locale is a property of the VAULT,
+// stored at <vault>/.brain/config.json ({ "locale": "en" }); absent = pt-BR (full backward
+// compat). Parsers stay bilingual everywhere; only RENDERING follows the locale.
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+export const LOCALES = {
+  'pt-BR': {
+    id: 'pt-BR',
+    folders: {
+      inbox: '00-Inbox',
+      project: '01-Projeto',
+      sessions: '02-Sessões',
+      linear: '03-Linear',
+      decisions: '04-Decisões',
+      bugs: '05-Bugs',
+      learnings: '06-Aprendizados',
+      specs: '07-Specs',
+      changes: '08-Mudanças',
+    },
+    months: ['01-JAN', '02-FEV', '03-MAR', '04-ABR', '05-MAI', '06-JUN', '07-JUL', '08-AGO', '09-SET', '10-OUT', '11-NOV', '12-DEZ'],
+    reqHeading: 'Requisito',
+    fixTaskVerb: 'mata mutante',
+    coreSections: ['Preferências do Usuário', 'Padrões Ativos', 'Pendências Abertas'],
+  },
+  en: {
+    id: 'en',
+    folders: {
+      inbox: '00-Inbox',
+      project: '01-Project',
+      sessions: '02-Sessions',
+      linear: '03-Linear',
+      decisions: '04-Decisions',
+      bugs: '05-Bugs',
+      learnings: '06-Learnings',
+      specs: '07-Specs',
+      changes: '08-Changes',
+    },
+    months: ['01-JAN', '02-FEB', '03-MAR', '04-APR', '05-MAY', '06-JUN', '07-JUL', '08-AUG', '09-SEP', '10-OCT', '11-NOV', '12-DEC'],
+    reqHeading: 'Requirement',
+    fixTaskVerb: 'kill mutant',
+    coreSections: ['User Preferences', 'Active Patterns', 'Open Items'],
+  },
+};
+
+export const DEFAULT_LOCALE = 'pt-BR';
+
+// Per-process cache: one vault per process (hooks + CLI), reads are hot paths.
+const cache = new Map();
+
+export function getLocale(vaultBase) {
+  if (!vaultBase) return LOCALES[DEFAULT_LOCALE];
+  const key = String(vaultBase);
+  if (cache.has(key)) return cache.get(key);
+  let id = DEFAULT_LOCALE;
+  try {
+    const data = JSON.parse(readFileSync(join(key, '.brain', 'config.json'), 'utf8'));
+    if (data.locale && LOCALES[data.locale]) id = data.locale;
+  } catch { /* sem config = pt-BR */ }
+  const loc = LOCALES[id];
+  cache.set(key, loc);
+  return loc;
+}
+
+// Test hook: drop the memoized entry (tests rewrite config.json under one tmpdir).
+export function clearLocaleCache() {
+  cache.clear();
+}
+
+// The full vault taxonomy for a locale (folders + fixed entries), in creation order.
+export function vaultFolders(loc) {
+  return [...Object.values(loc.folders), 'Templates', '.brain'];
+}

package/hooks/obsidian-common.mjs

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, statSync, writeFileSync } from 'fs';
 import { basename, dirname, join, relative } from 'path';
+import { getLocale } from './locale.mjs';
 
 // Neutral fallback only. The vault is normally resolved from the
 // OBSIDIAN_VAULT_PATH env var (set by `wendkeep init`) via getVaultBase() below.
@@ -128,26 +129,28 @@ export function formatLocalIso(date = new Date()) {
   return `${formatDate(date)}T${formatTime(date)}`;
 }
 
-export function datedFolderRel(rootFolder, date = new Date()) {
+// Locale (0.8.0): month labels + folder names come from the vault locale when a
+// vaultBase is given; without it, pt-BR (backward compat — every legacy caller).
+export function datedFolderRel(rootFolder, date = new Date(), vaultBase) {
   const p = localDateParts(date);
-  return join(rootFolder, String(p.year), MONTH_FOLDERS[p.month - 1], `DIA ${pad2(p.day)}`);
+  return join(rootFolder, String(p.year), getLocale(vaultBase).months[p.month - 1], `DIA ${pad2(p.day)}`);
 }
 
 // Mesma estrutura datada a partir de uma string 'YYYY-MM-DD' (sessões: até o DIA).
-export function datedFolderRelFromDateStr(rootFolder, dateStr) {
+export function datedFolderRelFromDateStr(rootFolder, dateStr, vaultBase) {
   const [year, month, day] = String(dateStr).split('-');
-  return join(rootFolder, year, MONTH_FOLDERS[Number(month) - 1], `DIA ${pad2(day)}`);
+  return join(rootFolder, year, getLocale(vaultBase).months[Number(month) - 1], `DIA ${pad2(day)}`);
 }
 
 // Estrutura até o MÊS (sem DIA) — usada pelas notas derivadas (decisões/bugs/
 // aprendizados): tudo do mês fica junto em <pasta>/<ano>/<MM-MMM>/.
-export function monthFolderRelFromDateStr(rootFolder, dateStr) {
+export function monthFolderRelFromDateStr(rootFolder, dateStr, vaultBase) {
   const [year, month] = String(dateStr).split('-');
-  return join(rootFolder, year, MONTH_FOLDERS[Number(month) - 1]);
+  return join(rootFolder, year, getLocale(vaultBase).months[Number(month) - 1]);
 }
 
-export function sessionFolderRel(date = new Date()) {
-  return datedFolderRel('02-Sessões', date);
+export function sessionFolderRel(date = new Date(), vaultBase) {
+  return datedFolderRel(getLocale(vaultBase).folders.sessions, date, vaultBase);
 }
 
 export function controlPath(vaultBase) {
@@ -532,7 +535,7 @@ export function listMarkdownFiles(dir) {
 }
 
 export function getNextAdrNumber(vaultBase) {
-  const decisionsDir = join(vaultBase, '04-Decisões');
+  const decisionsDir = join(vaultBase, getLocale(vaultBase).folders.decisions);
   let max = 0;
   // Varre recursivamente: os ADRs agora vivem em subpastas datadas (AAAA/MM-MMM/DIA DD).
   const walk = (dir) => {

package/hooks/session-ensure.mjs

@@ -115,7 +115,7 @@ Sessão ainda em andamento.
 }
 
 function allocateSessionPath(vaultBase, now, summary = 'session') {
-  const folderRel = sessionFolderRel(now);
+  const folderRel = sessionFolderRel(now, vaultBase);
   const folderAbs = join(vaultBase, folderRel);
   ensureDir(folderAbs);
 

package/hooks/session-start.mjs

@@ -113,7 +113,7 @@ Sessão ainda em andamento.
 }
 
 function allocateSessionPath(vaultBase, now, summary = 'session') {
-  const folderRel = sessionFolderRel(now);
+  const folderRel = sessionFolderRel(now, vaultBase);
   const folderAbs = join(vaultBase, folderRel);
   ensureDir(folderAbs);
 

package/hooks/session-stop.mjs

@@ -7,6 +7,7 @@ import { createLinkedNotes } from './linked-notes.mjs';
 import { addUsage, costBreakdown, emptyTokenUsage, normalizeClaudeUsage, normalizeCodexUsage, priceForModel, updateSessionUsage } from './token-usage.mjs';
 import { buildBrainDigest, buildBrainIndex } from './brain-core.mjs';
 import { activeChangeLink } from './change-core.mjs';
+import { getLocale } from './locale.mjs';
 import {
   ensureDir,
   findActiveSessionByTranscript,
@@ -781,10 +782,11 @@ function noteReferencesSession(content, sessionRel) {
 
 function findLinkedDerivedNotes(vaultBase, sessionRel) {
   const linked = { decisions: [], bugs: [], learnings: [] };
+  const locF = getLocale(vaultBase).folders;
   const folders = {
-    decisions: '04-Decisões',
-    bugs: '05-Bugs',
-    learnings: '06-Aprendizados',
+    decisions: locF.decisions,
+    bugs: locF.bugs,
+    learnings: locF.learnings,
   };
 
   for (const [key, folder] of Object.entries(folders)) {

package/hooks/spec-core.mjs

@@ -4,14 +4,15 @@ import { createHash } from 'node:crypto';
 import { readFileSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { ensureDir } from './obsidian-common.mjs';
+import { getLocale } from './locale.mjs';
 
 // Short stable fingerprint of tarefas.md — freshness check between package/verdict and gate.
 export function tasksHashOf(md) {
   return createHash('sha1').update(String(md)).digest('hex').slice(0, 12);
 }
 
-const SPECS_DIR = '07-Specs';
-const REQ_RE = /^### Requisito:\s*(.+)$/gm;
+// Parse is BILINGUAL always (mixed vaults never break); rendering follows the vault locale.
+const REQ_RE = /^### (?:Requisito|Requirement):\s*(.+)$/gm;
 
 export function parseRequirements(md) {
   const text = String(md);
@@ -71,8 +72,8 @@ export function applyDelta(reqs, delta) {
   return { reqs: out, warnings };
 }
 
-export function renderSpec(capability, reqs, { footer } = {}) {
-  const blocks = reqs.map((r) => `### Requisito: ${r.id ? `${r.id} — ${r.name}` : r.name}\n${r.body}`).join('\n\n');
+export function renderSpec(capability, reqs, { footer, reqHeading = 'Requisito' } = {}) {
+  const blocks = reqs.map((r) => `### ${reqHeading}: ${r.id ? `${r.id} — ${r.name}` : r.name}\n${r.body}`).join('\n\n');
   const foot = footer ? `\n\n> ${footer}\n` : '\n';
   return `---\ntype: spec\ncssclasses:\n  - topic-spec\ntags:\n  - spec\n---\n\n# ${capability}\n\n## Requisitos\n\n${blocks}${foot}`;
 }
@@ -88,20 +89,22 @@ export function parseSpecsList(propostaMd) {
 
 // Merge each capability's delta (in the change) into the living spec in 07-Specs.
 export function promoteSpecs(vaultBase, changeDir, specs, { changeWikilink, dateStr } = {}) {
+  const loc = getLocale(vaultBase);
+  const specsDir = loc.folders.specs;
   const promoted = [];
   const warnings = [];
   for (const cap of specs) {
     let delta;
     try { delta = parseDelta(readFileSync(join(changeDir, 'specs', cap, 'spec.md'), 'utf8')); }
     catch { warnings.push(`sem delta para ${cap}`); continue; }
-    const livePath = join(vaultBase, SPECS_DIR, `${cap}.md`);
+    const livePath = join(vaultBase, specsDir, `${cap}.md`);
     let current = [];
     try { current = parseRequirements(readFileSync(livePath, 'utf8')); } catch { /* nova capability */ }
     const applied = applyDelta(current, delta);
     warnings.push(...applied.warnings.map((w) => `${cap}: ${w}`));
-    ensureDir(join(vaultBase, SPECS_DIR));
+    ensureDir(join(vaultBase, specsDir));
     const footer = changeWikilink ? `Atualizado por ${changeWikilink} em ${dateStr}.` : '';
-    writeFileSync(livePath, renderSpec(cap, applied.reqs, { footer }), 'utf8');
+    writeFileSync(livePath, renderSpec(cap, applied.reqs, { footer, reqHeading: loc.reqHeading }), 'utf8');
     promoted.push(cap);
   }
   return { promoted, warnings };

package/hooks/vault-health.mjs

@@ -10,6 +10,7 @@ import {
   readSessionRegistry,
   wikilinkFromRel,
 } from './obsidian-common.mjs';
+import { getLocale } from './locale.mjs';
 
 const DEFAULT_PENDING_PATTERNS = [
   /^- \[ \] Revisar resumo da sessão$/i,
@@ -164,7 +165,8 @@ export function runVaultHealth({ vaultBase, session = '' }) {
     .length;
   if (staleDone) warnings.push(`${staleDone} entradas active com ended_at no SESSION_REGISTRY.`);
 
-  const derivedFolders = ['04-Decisões', '05-Bugs', '06-Aprendizados'];
+  const locF = getLocale(vaultBase).folders;
+  const derivedFolders = [locF.decisions, locF.bugs, locF.learnings];
   const derivedCount = derivedFolders.reduce((total, folder) => {
     const dir = join(vaultBase, folder);
     return total + (existsSync(dir) ? listMarkdownFiles(dir).length : 0);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "wendkeep",
-  "version": "0.7.0",
-  "description": "Automatically capture AI coding agent sessions (Claude Code, Codex) as local Markdown in your Obsidian vault — turn-by-turn history, cost/token tracking, auto-extracted decisions/bugs/learnings, rendered in the graph. Local-first.",
+  "version": "0.8.1",
+  "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": {
     "wendkeep": "bin/wendkeep.mjs",

package/src/change.mjs

@@ -12,6 +12,7 @@ import {
 import { evaluateGate, requiredSensors } from '../hooks/sensors-core.mjs';
 import { evaluateVerdict, tasksHashOf, parseSpecsList, parseDelta, parseRequirements, applyDelta } from '../hooks/spec-core.mjs';
 import { getNextAdrNumber, readControl } from '../hooks/obsidian-common.mjs';
+import { getLocale } from '../hooks/locale.mjs';
 
 function resolveVault(argv) {
   let vault;
@@ -69,7 +70,7 @@ export function runChange(argv) {
     const slug = slugArg();
     if (!slug) { process.stderr.write('wendkeep change show: missing <slug>\n'); process.exit(2); }
     let md;
-    try { md = readFileSync(join(vaultBase, '08-Mudanças', slug, 'tarefas.md'), 'utf8'); }
+    try { md = readFileSync(join(vaultBase, getLocale(vaultBase).folders.changes, slug, 'tarefas.md'), 'utf8'); }
     catch { process.stderr.write(`wendkeep change show: not found: ${slug}\n`); process.exit(2); }
     const tasks = parseTasks(md);
     const open = tasks.filter((t) => !t.done).length;
@@ -81,7 +82,7 @@ export function runChange(argv) {
   if (sub === 'status') {
     const slug = slugArg() || activeChange(vaultBase);
     if (!slug) { process.stderr.write('wendkeep change status: no change (arg or active)\n'); process.exit(2); }
-    const dir = join(vaultBase, '08-Mudanças', slug);
+    const dir = join(vaultBase, getLocale(vaultBase).folders.changes, slug);
     let tarefasMd;
     try { tarefasMd = readFileSync(join(dir, 'tarefas.md'), 'utf8'); }
     catch { process.stderr.write(`wendkeep change status: not found: ${slug}\n`); process.exit(2); }
@@ -117,7 +118,7 @@ export function runChange(argv) {
     if (!taskId) { process.stderr.write(`wendkeep change ${sub}: missing <taskId>\n`); process.exit(2); }
     const slug = opt(rest, '--change') || activeChange(vaultBase);
     if (!slug) { process.stderr.write(`wendkeep change ${sub}: no active change\n`); process.exit(2); }
-    const dir = join(vaultBase, '08-Mudanças', slug);
+    const dir = join(vaultBase, getLocale(vaultBase).folders.changes, slug);
     let ok = false;
     try { ok = setTaskDone(dir, taskId, sub === 'done'); } catch { /* sem tarefas.md */ }
     if (!ok) { process.stderr.write(`wendkeep change ${sub}: task não encontrada: ${taskId}\n`); process.exit(2); }
@@ -128,7 +129,7 @@ export function runChange(argv) {
   if (sub === 'diff') {
     const slug = slugArg() || activeChange(vaultBase);
     if (!slug) { process.stderr.write('wendkeep change diff: no change (arg or active)\n'); process.exit(2); }
-    const dir = join(vaultBase, '08-Mudanças', slug);
+    const dir = join(vaultBase, getLocale(vaultBase).folders.changes, slug);
     let specs = [];
     try { specs = parseSpecsList(readFileSync(join(dir, 'proposta.md'), 'utf8')); }
     catch { process.stderr.write(`wendkeep change diff: not found: ${slug}\n`); process.exit(2); }
@@ -142,7 +143,7 @@ export function runChange(argv) {
       for (const r of delta.modified) process.stdout.write(`  ~ ${r.id || r.name} (MODIFIED)\n`);
       for (const k of delta.removed) process.stdout.write(`  - ${k} (REMOVED)\n`);
       let living = [];
-      try { living = parseRequirements(readFileSync(join(vaultBase, '07-Specs', `${cap}.md`), 'utf8')); } catch { /* nova capability */ }
+      try { living = parseRequirements(readFileSync(join(vaultBase, getLocale(vaultBase).folders.specs, `${cap}.md`), 'utf8')); } catch { /* nova capability */ }
       for (const w of applyDelta(living, delta).warnings) process.stdout.write(`  ! ${w}\n`);
     }
     process.exit(0);