cognitivebc
v0.4.0
Published
Cognitive Bytecode (CBC) — The Decision Encoding & Execution Substrate for Synap-se
Maintainers
Readme
cognitivebc (cognitivebc.io)
Infraestrutura de Compilação de Experiência Operacional, Decisória e Bytecode Cognitivo para Sistemas de Agentes
SDK oficial no npm (cognitivebc) e serviço de API (api.cognitivebc.io ou localmente em http://localhost:4780).
🚀 Como Servir a API Localmente
Modo Interativo (Terminal)
# Inicia na porta padrão 4780
npm start
# Ou especificando porta customizada
PORT=4780 npm startModo Daemon Permanente (macOS launchd)
O serviço roda silenciosamente em segundo plano, sobrevive a reinicializações e reinicia automaticamente se necessário:
# Gerenciamento simples via npm:
npm run daemon:status # Verifica se está rodando e testa o endpoint HTTP
npm run daemon:restart # Reinicia o daemon
npm run daemon:logs # Exibe os últimos logs (stdout e stderr)
npm run daemon:stop # Para o daemon
npm run daemon:start # Inicia o daemon
# Ou diretamente pelo script:
./bin/cbc-daemon.sh statusEndpoints Canônicos Disponíveis
| Método | Rota | Descrição |
| :--- | :--- | :--- |
| GET | /health | Status do serviço e contagem de artefatos carregados |
| POST | /api/v1/resolve | Resolução JIT de contexto filtrado por papel com teto de tokens |
| POST | /api/v1/streams/ingest | Ingestão de telemetria e detector de SilentSelfCorrectionCycle |
| POST | /api/v1/compile | Compilador dos 3 Regimes (Corretivo Externo, Autocorreção Multimodal, Pioneiro) |
| POST | /api/v1/gates/verify | Validação determinística de contratos (ContractGate) |
| GET | /api/v1/artifacts/:type/:id | Consulta de artefatos versionados (bytecode, skill, map) com SHA-256 |
📦 Como Usar o SDK no Synap-se e BUs
const { CognitiveBCClient } = require('cognitivebc');
const cbc = new CognitiveBCClient({
baseUrl: process.env.COGNITIVEBC_URL || 'http://localhost:4780',
apiKey: process.env.COGNITIVEBC_API_KEY,
localFallbackDir: './.cbc-cache', // Cache offline-first
});
// 1. Resolução JIT por Papel (Roteirista, Construtor 3D, Revisor, etc.)
const packet = await cbc.resolve({
tenant: 'diario_glp1',
squad: 'mktsquad',
area: 'midias-organico',
role: 'construtor_3d',
stacks: ['scientific_3d_stack'],
maxTokens: 600,
});
console.log(packet.push_markdown);
console.log('Tokens estimados:', packet.token_count);
console.log('Digest SHA-256:', packet.digest_sha256);
// 2. Verificação de Portão Determinístico (ContractGate)
const gate = await cbc.verifyGate({
stage: 'roteiro',
draftPayload: {
titulo: 'Como as canetas de GLP-1 funcionam',
texto: 'As canetas de GLP-1 auxiliam no equilíbrio metabólico...',
},
});
console.log('Gate passou?', gate.passed);🧪 Testes Automatizados
Executa a suíte de testes com validação completa de esquemas, motor de resolução JIT, 3 regimes de compilação e chamadas HTTP na API local:
npm test📚 Documentação Técnica
Consulte a especificação canônica detalhada em docs/TECHNICAL_SPECIFICATION.md.
