Cerebro Studio · Backlog · Changelog
Cerebro • /root/cerebro/docs/changelog/2026/CL-2026-04-28-BK-CORE-003-memory-fts.md • 2026-04-28T13:15:17.712Z

CL-2026-04-28-BK-CORE-003 - Memory FTS local para o Debate Runtime

Status: (V)

Escopo: projeto

Projetos afetados: cerebro-kernel

Aprovacao humana obrigatoria: nao

Revisor IA: auto-revisao Codex por indisponibilidade temporaria dos revisores externos

Resumo

O kernel do Cérebro ganhou uma camada local minima de memoria textual baseada em SQLite/FTS5. A entrega fecha BK-CORE-003 e prepara a base para o BK-CORE-004 Project Context Layer.

Alteracoes

  • Criado kernel/memory_fts.js com MemoryFtsStore.
  • Criada suite kernel/tests/unit/memory-fts.test.js.
  • Atualizados backlog, changelog e roadmap do Debate Runtime.

Comportamento entregue

  • Upsert de documentos com id, project_id, source, title, content e metadata.
  • Busca FTS5 local com ranking bm25.
  • Filtro por project_id/projectId.
  • Delete transacional removendo documento e indice.
  • Query vazia ou somente pontuacao cai para listagem recente, sem erro de sintaxe FTS.
  • Sem dependencia de API pay-per-use, free tier ou provider externo.

Validacao

Comandos executados:

```bash

node --check kernel/memory_fts.js

node --check kernel/tests/unit/memory-fts.test.js

cd kernel && npm test -- --runInBand tests/unit/memory-fts.test.js

```

Resultado observado:

  • sintaxe OK nos dois arquivos JS;
  • Jest do kernel verde com 20 suites e 129 testes.

Observacoes operacionais

OpenCode entregou a triagem inicial util, mas falhou duas vezes na implementacao do mesmo job. Gemini direto entregou segunda opiniao de triagem, mas expirou sem parecer na revisao final. OpenCode tambem falhou na revisao final por erro de provider/schema. Kimi abortou nas tentativas da rodada. A implementacao direta pelo Codex seguiu a excecao operacional registrada no backlog vivo.

Proximo passo

Executar BK-CORE-004 - Project Context Layer, conectando esta memoria local a fontes reais de contexto por projeto e ao Debate Runtime.