wendkeep 0.6.1 → 0.8.0

package/CHANGELOG.md

@@ -4,6 +4,45 @@ 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.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.
+
+### Added
+- **`change status`** — one screen: tasks (done/open with `[req:]`/`[sensor:]`), sensor
+  evidence, verdict state (ok / stale / incomplete / absent), mutation round.
+- **`change done <id>` / `undone <id>`** — tick tasks from the CLI (exact-id anchored).
+- **`change diff`** — dry-run preview of the spec promotion (`+` ADDED / `~` MODIFIED /
+  `-` REMOVED / `!` warnings) without touching `07-Specs`.
+- **`spec list` / `spec show <capability>`** — read-only views over the living specs.
+- **`sensors list`** — the sensors from `wendkeep.sensors.json`; a **JSON Schema** for the
+  file now ships in the package (`schema/`) and the init seed points `$schema` at it.
+- README: "the loop in five minutes" worked example.
+
+### Fixed
+- `change` subcommands without a positional argument no longer mistake the `--vault` value
+  for a slug.
+
 ## [0.6.1] — 2026-07-05
 
 Hardening: CI + real-world gate holes found by self-audit.
@@ -141,6 +180,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.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
 [0.5.0]: https://github.com/rogersialves/wendkeep/releases/tag/v0.5.0

package/README.md

@@ -70,8 +70,11 @@ No re‑copying, no snapshot to re‑sync — the package is the single source o
 |---|---|
 | `wendkeep init` | Set up wendkeep in a project (vault taxonomy + settings + MCP + skills). |
 | `wendkeep hook <name>` | Run a session hook; invoked by `settings.json` (reads agent JSON on stdin). |
-| `wendkeep change <sub>` | Change lifecycle: `new <slug>` / `list` / `show <slug>` / `archive <slug>`. |
-| `wendkeep verify [--change s]` | Run the active (or named) change's task sensors; record evidence (the gate). |
+| `wendkeep change <sub>` | Change lifecycle: `new [--simple]` / `list` / `show` / `status` / `done <id>` / `undone <id>` / `diff` / `archive [--force]`. |
+| `wendkeep verify [--deep]` | Run the change's task sensors; `--deep` assembles the independent-verification package. |
+| `wendkeep spec <sub>` | Living specs: `list` / `show <capability>`. |
+| `wendkeep sensors list` | Show the sensors from `wendkeep.sensors.json` (JSON Schema included in the package). |
+| `wendkeep lesson add "t" "l"` | Record a project-local lesson (injected at the next SessionStart). |
 | `wendkeep sync-defs` | Copy `.brain/agents\|skills` into the project (`.codex/agents`, `.claude/skills`). |
 | `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). |
@@ -90,7 +93,37 @@ explore → propose → apply (TDD) → verify → archive
 - **Verify** — `wendkeep verify` runs the sensors your tasks declared (from `wendkeep.sensors.json` at the project root) and records `evidencia.json`. A critical red fails the gate; a `warning` red is advisory.
 - **Archive** — `wendkeep change archive <slug>` **gates** on the evidence (blocks unless every declared critical sensor is green), promotes each capability's spec delta (`ADDED`/`MODIFIED`/`REMOVED`) into the living `07-Specs/<capability>.md`, moves the change to `_arquivo/`, and mints an ADR in `04-Decisões/`.
 
-`wendkeep init` also seeds **native process skills** (`wk-workflow`, `wk-tdd`, `wk-debugging`, `wk-brainstorming`, `wk-planning`) into `.brain/skills` and delivers them to `.claude/skills` — the *how* layer, zero‑dep. Optional companions (`context-mode`, `dotcontext`, `understand-anything`, `caveman`) remain an opt‑in extra layer.
+`wendkeep init` also seeds **native process skills** (`wk-workflow`, `wk-tdd`, `wk-debugging`, `wk-brainstorming`, `wk-planning`, `wk-verify`) into `.brain/skills` and delivers them to `.claude/skills` — the *how* layer, zero‑dep. Optional companions (`context-mode`, `dotcontext`, `understand-anything`, `caveman`) remain an opt‑in extra layer.
+
+### The loop in five minutes
+
+```bash
+npx wendkeep init --yes                        # vault + hooks + sensors + skills
+npx wendkeep change new dark-mode              # proposta/design/tarefas — change is now active
+```
+
+Edit `tarefas.md` — tag proof and requirement per task:
+
+```markdown
+- [ ] 1.1 toggle persists across sessions [req:UI-1] [sensor:tests]
+```
+
+Declare the capability in `proposta.md` (`specs: [ui]`) and author its delta in
+`specs/ui/spec.md` (`## ADDED Requirements` → `### Requisito: UI-1 — dark mode toggle`). Then:
+
+```bash
+npx wendkeep change status                     # one screen: tasks / sensors / verdict
+npx wendkeep change done 1.1                   # tick a task from the CLI
+npx wendkeep verify                            # run the declared sensors -> evidencia.json
+npx wendkeep verify --deep                     # assemble the verification package
+# the wk-verify skill (fresh, read-only pass) writes verdict.json
+npx wendkeep change diff                       # preview what will land in 07-Specs
+npx wendkeep change archive dark-mode          # gate: sensors + verdict + no open tasks
+```
+
+The archive promotes the delta into the living `07-Specs/ui.md`, mints an ADR, and the
+Obsidian graph now links *session ↔ change ↔ requirement ↔ decision*. A change that names
+no `[req:]` skips the independent verdict — the sensor gate is its proof.
 
 ## How it works
 

package/bin/wendkeep.mjs

@@ -43,7 +43,10 @@ Usage:
                            agent's JSON on stdin. Names: ${RUNNABLE_HOOKS.join(', ')}.
 
   wendkeep doctor [--vault P]  Run a vault health check.
-  wendkeep change <sub>        Change lifecycle: new <slug> | list | show <slug> | archive <slug>.
+  wendkeep change <sub>        Change lifecycle: new [--simple] | list | show | status |
+                           done <id> | undone <id> | diff | archive [--force].
+  wendkeep spec <sub>          Living specs: list | show <capability>.
+  wendkeep sensors list        Show the sensors from wendkeep.sensors.json.
   wendkeep verify [--change s] Run a change's task sensors + record evidence (the gate).
   wendkeep lesson add "t" "l"   Record a project-local lesson (injected at SessionStart).
   wendkeep validate-memory [path]  Validate .brain/CORE.md against the compaction
@@ -117,6 +120,16 @@ async function main() {
       runLesson(rest);
       break;
     }
+    case 'spec': {
+      const { runSpec } = await import('../src/spec.mjs');
+      runSpec(rest);
+      break;
+    }
+    case 'sensors': {
+      const { runSensors } = await import('../src/sensors.mjs');
+      runSensors(rest);
+      break;
+    }
     case '--version':
     case '-v':
       process.stdout.write(`${version()}\n`);

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) {
@@ -123,8 +117,19 @@ export function parseTasks(md) {
   return tasks;
 }
 
+// Toggle a task checkbox by its exact id (0.7.0 ergonomics). Returns false when absent.
+export function setTaskDone(changeDir, taskId, done = true) {
+  const path = join(changeDir, 'tarefas.md');
+  const md = readFileSync(path, 'utf8');
+  const esc = String(taskId).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+  const re = new RegExp(`^(-\\s+\\[)( |x)(\\]\\s+${esc}\\s)`, 'm');
+  if (!re.test(md)) return false;
+  writeFileSync(path, md.replace(re, `$1${done ? 'x' : ' '}$3`), 'utf8');
+  return true;
+}
+
 export function listChanges(vaultBase) {
-  const base = join(vaultBase, CHANGES_DIR);
+  const base = join(vaultBase, getLocale(vaultBase).folders.changes);
   const active = [];
   let archived = [];
   try {
@@ -142,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 = [];
@@ -173,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';
@@ -187,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).
@@ -209,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);