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

CL-2026-03-13-BK-125

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

Resumo

Foi implementado o gate de revisao reutilizavel dos squads no kernel, separando decisao automatica, necessidade de aprovacao humana e rework com feedback estruturado persistido como artefato da run.

Entregas

  • Novo modulo kernel/squad_review.js para normalizar:
  • scorecard;
  • checklist;
  • decisao do gate (approved, human_approval_required, rework);
  • alvo de retrabalho.
  • kernel/squad_runtime.js atualizado para:
  • anexar reviewGate ao payload persistido;
  • reencaminhar automaticamente para a etapa alvo em caso de rework;
  • respeitar max_review_loops por modo (economico/alta_performance);
  • manter reviewGate no summary final da run.
  • kernel/index.js atualizado para instruir o revisor a devolver JSON estruturado com gateDecision, approvalMode, humanApprovalRequired, checklist e feedbackText.
  • kernel/config/squads/rnt-social-squad.json enriquecido com review_policy global e local da etapa review.
  • Cobertura adicionada em:
  • kernel/tests/unit/squad-review.test.js
  • kernel/tests/unit/squad-runtime.test.js

Validacoes executadas

  • node --check /root/cerebro/kernel/squad_review.js
  • node --check /root/cerebro/kernel/squad_runtime.js
  • node --check /root/cerebro/kernel/index.js
  • node --check /root/cerebro/kernel/tests/unit/squad-review.test.js
  • node --check /root/cerebro/kernel/tests/unit/squad-runtime.test.js
  • node -e "JSON.parse(require('fs').readFileSync('/root/cerebro/kernel/config/squads/rnt-social-squad.json','utf8')); console.log('json-ok')"
  • npm test -- --runInBand tests/unit/squad-review.test.js tests/unit/squad-runtime.test.js

Evidencias

  • Resultado do npm test: 14 suites aprovadas, 79 testes aprovados, sem falhas.
  • O runtime agora cobre tres caminhos de gate:
  • aprovacao automatica;
  • aprovacao humana obrigatoria;
  • rework com reroute para a etapa anterior.
  • O feedback de revisao deixa de depender de parsing frouxo de texto e passa a existir em payload.reviewGate.

Riscos residuais

  • O Studio ainda nao consome visualmente o reviewGate; isso fica para BK-126.
  • O caso de human_approval_required ainda fica representado em payload/summary, sem status visual dedicado na UI.