wendkeep 0.9.0 → 0.9.1

package/CHANGELOG.md

@@ -4,6 +4,16 @@ 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.9.1] — 2026-07-06
+
+Interactive install UX: language first.
+
+### Added
+- **`wendkeep init` asks the vault language first** on an interactive TTY (when `--locale`
+  isn't passed): `[1] Português  [2] English`. The answer drives the folders, scaffold and
+  skills — and the remaining prompts (vault path, companion selection) now render in the
+  chosen locale instead of always Portuguese. `--yes`, `--locale` and non-TTY are unchanged.
+
 ## [0.9.0] — 2026-07-06
 
 Engineering debt: sensor editing + i18n coherence for auto-generated notes.
@@ -213,6 +223,7 @@ 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.9.1]: https://github.com/rogersialves/wendkeep/releases/tag/v0.9.1
 [0.9.0]: https://github.com/rogersialves/wendkeep/releases/tag/v0.9.0
 [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

package/package.json

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

package/src/companion-select.mjs

@@ -4,6 +4,7 @@
 import readline from 'node:readline';
 
 const HINT = 'Espaço marca/desmarca · ↑/↓ move · a=todos · n=nenhum · Enter confirma';
+const HEADER = 'Companions';
 
 export function initialCompanionMenu(companions) {
   return {
@@ -35,8 +36,8 @@ export function reduceCompanionMenu(state, action) {
   }
 }
 
-export function renderCompanionMenu(state) {
-  const lines = [`Companions — ${HINT}:`];
+export function renderCompanionMenu(state, { hint = HINT, header = HEADER } = {}) {
+  const lines = [`${header} — ${hint}:`];
   state.items.forEach((it, i) => {
     const cursor = i === state.cursor ? '>' : ' ';
     const box = it.checked ? '[x]' : '[ ]';
@@ -63,7 +64,7 @@ export function canInteractiveSelect(input = process.stdin, output = process.std
 
 // Run the raw-TTY checkbox menu; resolves with the selected ids. Caller must check
 // canInteractiveSelect() first (otherwise use the text fallback).
-export function selectCompanionsInteractive(companions, { input = process.stdin, output = process.stdout } = {}) {
+export function selectCompanionsInteractive(companions, { input = process.stdin, output = process.stdout, labels } = {}) {
   return new Promise((resolve) => {
     let state = initialCompanionMenu(companions);
     let drawnLines = 0;
@@ -77,7 +78,7 @@ export function selectCompanionsInteractive(companions, { input = process.stdin,
         readline.moveCursor(output, 0, -drawnLines);
         readline.clearScreenDown(output);
       }
-      const text = renderCompanionMenu(state);
+      const text = renderCompanionMenu(state, labels);
       output.write(`${text}\n`);
       drawnLines = text.split('\n').length;
     };

package/src/init.mjs

@@ -192,17 +192,55 @@ function installVaultColors(vaultPath) {
 
 // --- main -------------------------------------------------------------------
 
+// Interactive prompt strings by locale. The language question itself is bilingual (asked
+// before the locale is known); everything after follows the answer.
+const PROMPTS = {
+  'pt-BR': {
+    vault: (f) => `Caminho do vault Obsidian (Enter aceita o padrão, ou digite outro)\n  [${f}]\n> `,
+    companionsHeader: '\nCompanions (plugins/MCP opcionais — context-mode é a principal):',
+    companionsAsk: (def) => `Digite os ids separados por vírgula (Enter aceita [${def}], "none" p/ nenhum): `,
+    menu: { hint: 'Espaço marca/desmarca · ↑/↓ move · a=todos · n=nenhum · Enter confirma', header: 'Companions' },
+  },
+  en: {
+    vault: (f) => `Obsidian vault path (Enter for the default, or type another)\n  [${f}]\n> `,
+    companionsHeader: '\nCompanions (optional plugins/MCP — context-mode is the main one):',
+    companionsAsk: (def) => `Enter ids comma-separated (Enter for [${def}], "none" for none): `,
+    menu: { hint: 'Space toggles · ↑/↓ move · a=all · n=none · Enter confirms', header: 'Companions' },
+  },
+};
+
+export function promptStrings(localeId) {
+  return PROMPTS[localeId] || PROMPTS['pt-BR'];
+}
+
+// Map the language answer to a locale id. 2/en → en; 1/pt/empty/unknown → pt-BR.
+export function parseLocaleAnswer(ans) {
+  const a = String(ans || '').trim().toLowerCase();
+  if (a === '2' || a === 'en' || a === 'english') return 'en';
+  return 'pt-BR';
+}
+
 export async function runInit(argv) {
   const args = parseArgs(argv);
   const projectPath = resolve(args.project || process.cwd());
   const log = (s) => process.stdout.write(`${s}\n`);
 
+  // Language first (i18n): an interactive TTY without --locale is asked the vault language;
+  // folders, prompts and scaffold all follow the answer.
+  if (!args.locale && process.stdin.isTTY && !args.yes) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const ans = await rl.question('Idioma do vault / Vault language:\n  [1] Português (pt-BR)   [2] English (en)\n> ');
+    rl.close();
+    args.locale = parseLocaleAnswer(ans);
+  }
+  const P = promptStrings(args.locale && LOCALES[args.locale] ? args.locale : DEFAULT_LOCALE);
+
   let vaultPath = args.vault;
   if (!vaultPath) {
     const fallback = join(projectPath, deriveVaultDirName(projectPath));
     if (process.stdin.isTTY && !args.yes) {
       const rl = createInterface({ input: process.stdin, output: process.stdout });
-      const ans = (await rl.question(`Obsidian vault path (Enter aceita o padrão, ou digite outro caminho)\n  [${fallback}]\n> `)).trim();
+      const ans = (await rl.question(P.vault(fallback))).trim();
       rl.close();
       vaultPath = ans || fallback;
     } else {
@@ -222,16 +260,14 @@ export async function runInit(argv) {
   } else if (process.stdin.isTTY && !args.yes) {
     if (canInteractiveSelect()) {
       log(''); // the checkbox menu renders its own header
-      companions = await selectCompanionsInteractive(COMPANIONS);
+      companions = await selectCompanionsInteractive(COMPANIONS, { labels: P.menu });
     } else {
       // Text fallback (no raw-mode TTY): list + comma input with clear instructions.
-      log('\nCompanions (plugins/MCP opcionais — context-mode é a principal):');
+      log(P.companionsHeader);
       for (const c of COMPANIONS) log(`  ${c.default ? '[x]' : '[ ]'} ${c.label}`);
       const def = resolveCompanions({}).join(',');
       const rl = createInterface({ input: process.stdin, output: process.stdout });
-      const ans = (await rl.question(
-        `Digite os ids separados por vírgula (Enter aceita [${def}], "none" p/ nenhum): `,
-      )).trim();
+      const ans = (await rl.question(P.companionsAsk(def))).trim();
       rl.close();
       companions = ans.toLowerCase() === 'none' ? [] : resolveCompanions({ companionsFlag: ans || def });
     }