Cerebro Studio · Backlog · Changelog
Cerebro • /root/cerebro/docs/changelog/2026/CL-2026-03-13-BK-124.md • 2026-03-14T21:39:02.822Z

CL-2026-03-13-BK-124

  • Status: (P) pendente de conferencia IA adicional
  • Backlog: BK-124
  • Escopo: plataforma
  • Projetos afetados: cerebro-kernel, cerebro-studio
  • Aprovacao humana obrigatoria: nao
  • Revisor IA: auto-revisao pendente

Resumo

Foi implementada a base operacional de squads no kernel do Cerebro, com persistencia propria, definicao declarativa inicial e contrato WS minimo para o Studio iniciar, acompanhar, listar e consultar runs sem sobrecarregar o fluxo atual de chat.

Entregas

  • Novo storage dedicado em kernel/squad_store.js, com adapters SQLite/Postgres e tabelas studio_squad_runs, studio_squad_steps e studio_squad_artifacts.
  • Novo runtime em kernel/squad_runtime.js, com carga de definicao, criacao de runs, execucao linear de steps, persistencia de artifacts e suporte a rework, failed, approved e canceled.
  • Primeira definicao declarativa em kernel/config/squads/rnt-social-squad.json, cobrindo research, copy e review com modos economico e alta_performance.
  • Integracao no kernel/index.js com handlers:
  • studio_squad_run_start
  • studio_squad_run_get
  • studio_squad_run_list
  • Contrato WS minimo entregue com:
  • studio_squad_run_ack
  • studio_squad_run_event
  • studio_squad_run_state
  • studio_squad_run_list
  • Executor de etapa conectado ao roteador atual (callLLMWithAutoFallback) com prompts de squad, parser de <SQUAD_RESULT>{...}</SQUAD_RESULT> e reaproveitamento do executionRegistry para session_stop e panic_stop.

Validacoes executadas

  • node --check /root/cerebro/kernel/index.js
  • node --check /root/cerebro/kernel/squad_runtime.js
  • node --check /root/cerebro/kernel/squad_store.js
  • node --check /root/cerebro/kernel/tests/squad-store.test.js
  • node --check /root/cerebro/kernel/tests/squad-store-pg.test.js
  • node --check /root/cerebro/kernel/tests/unit/squad-runtime.test.js
  • npm test -- --runInBand tests/squad-store.test.js tests/squad-store-pg.test.js tests/unit/squad-runtime.test.js

Evidencias

  • Resultado do npm test: 13 suites aprovadas, 73 testes aprovados, sem falhas.
  • tests/squad-store-pg.test.js permaneceu verde com skip controlado quando TEST_DATABASE_URL nao esta definido.
  • O caminho de integracao ficou paralelo ao Studio Chat existente; nenhum handler legado foi removido.

Riscos residuais

  • O contrato WS novo ainda nao esta consumido por UI final do Studio ou pela tela redes_sociais.php; isso fica para BK-126 e BK-127.
  • O executor de step usa prompt/runtime generico; o gate comercial estruturado de revisao continua como escopo do BK-125.