wendkeep 0.62.0 → 0.63.0

package/CHANGELOG.md

@@ -4,6 +4,35 @@ 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.63.0] — 2026-07-28
+
+### Added
+
+- **O Vault público passa a expor locale e taxonomia de pastas, e o Harness passa a expor o
+  store durável de FLOW.** As novas superfícies canônicas estão disponíveis por
+  wendkeep/vault e wendkeep/harness e são validadas a partir de um tarball instalado em consumidor
+  isolado, inclusive com um ciclo persistido completo.
+
+### Changed
+
+- **Locale agora pertence a packages/vault/src e o store de FLOW a packages/harness/src.**
+  hooks/locale.mjs e hooks/vault-runtime-store.mjs permanecem como fachadas puras, preservando por
+  identidade todas as constantes e funções usadas por consumidores existentes.
+- **A extração stateful não exige migração.** Paths em .brain/runtime, schemas, ids, locks,
+  tentativas, recibos, reservas, promoções, atomicidade, contenção multiprocesso e validação física
+  de paths mantêm o contrato anterior.
+- **A direção Harness → Vault é verificada pelo índice público canônico.** Vault continua proibido
+  de depender do Harness, enquanto CLI, MCP, Integrations, Pi e flow-core permanecem fora deste
+  corte modular.
+
+### Fixed
+
+- **Promoções concorrentes no Windows/Node 22 não confundem a liberação transitória do lock com
+  um path inseguro.** O Vault agora revalida, com backoff curto e limitado, o lock público que
+  desaparece entre `lstat` e `realpath` e leituras `ENOENT` de owner/lease. A aquisição compartilha
+  um único budget/deadline e a liberação limpa o lock sem resíduo; junctions, reparse points, links
+  dangling, erros não transitórios e locks privados `.pending` continuam falhando fechado.
+
 ## [0.62.0] — 2026-07-28
 
 ### Added

package/README.en.md

@@ -23,6 +23,16 @@ Project Memory v2 kernel, respectively. The root package exposes those surfaces
 facades and no session data needs migration;
 see the [modular architecture](docs/en/architecture.md).
 
+In the **0.63 Harness FLOW Store** phase, `packages/vault/src/locale.mjs` becomes the canonical
+source for Vault locale and taxonomy, while `packages/harness/src/flow-store.mjs` becomes the
+canonical durable FLOW store. The historical `hooks/locale.mjs` and
+`hooks/vault-runtime-store.mjs` facades preserve export identity. Harness depends only on Vault's
+public index — never the reverse — with no migration of paths, schemas, or locks; the tarball
+remains a single artifact published by the root `wendkeep` package.
+Under multiprocess contention, transient release of the public lock and its owner/lease metadata
+is revalidated with a bounded budget/deadline, including final cleanup; junctions, reparse points,
+dangling locks, and non-transient errors are still rejected before any write.
+
 ```bash
 npm i -D wendkeep && npx wendkeep init      # captures from the next session on
 npx wendkeep import                          # backfill past Claude + Codex sessions

package/README.md

@@ -23,6 +23,16 @@ Project Memory v2 kernel, respectively. The root package exposes those surfaces
 facades and no session data needs migration;
 see the [modular architecture](docs/en/architecture.md).
 
+In the **0.63 Harness FLOW Store** phase, `packages/vault/src/locale.mjs` becomes the canonical
+source for Vault locale and taxonomy, while `packages/harness/src/flow-store.mjs` becomes the
+canonical durable FLOW store. The historical `hooks/locale.mjs` and
+`hooks/vault-runtime-store.mjs` facades preserve export identity. Harness depends only on Vault's
+public index — never the reverse — with no migration of paths, schemas, or locks; the tarball
+remains a single artifact published by the root `wendkeep` package.
+Under multiprocess contention, transient release of the public lock and its owner/lease metadata
+is revalidated with a bounded budget/deadline, including final cleanup; junctions, reparse points,
+dangling locks, and non-transient errors are still rejected before any write.
+
 ```bash
 npm i -D wendkeep && npx wendkeep init      # captures from the next session on
 npx wendkeep import                          # backfill past Claude + Codex sessions

package/hooks/locale.mjs

@@ -1,73 +1 @@
-// 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'];
-}
+export * from '../packages/vault/src/locale.mjs';