Wiki ACL (KernelBot)

Documentação do projecto. Cada página cobre um domínio; o índice abaixo é o ponto de entrada.

Última revisão: junho/2026 (camada pública, histórico de conversa, B3.1 advisory, alinhamento provider Cursor SDK default + contrato API/SSE).

Camada pública

Para alunos, curiosos e primeiro contacto — linguagem directa, sem jargão de RAG.

Página	Conteúdo
Início — guia público	O que é, comandos rápidos, mapa da documentação
Como contribuir	Ambiente, testes, PR, onde mexer no código
FAQ — utilizador	Comandos, pin, memória, fontes, limites

#	Página	Conteúdo
1	Visão geral	O que é o ACL, princípios, limitações
2	Arquitetura	Stack, componentes, diagramas
3	Estrutura do código	Pastas, módulos, responsabilidades
4	Dados e MySQL	Tabela `knowledge`, contrato 1 row = 1 aula
5	BM25 e chunking	Silos, janelas, Opção B2, IDF
6	Gates e decisões	Classificação retrieval, pós-geração, advisory
7	APIs e SSE	`/chat`, `history`, `/health/catalog`, `ACL_META`
8	Frontend	UI, sessão, histórico, pin, componentes
9	Fluxos operacionais	Boot, chat, pin, reload
10	Integração ISS (Fase 5b)	Pipeline, CI, secrets
11	Enriquecimento léxico B2	Histórico completo de engenharia
12	Configuração	`.env`, variáveis ACL, prompts
13	Staging e testes	Docker local, scripts `bin/`, chat
14	Segurança e logs	Redacção, OOM, fallbacks
15	Glossário	Termos do domínio
16	Prompts — referência	Arquitetura ACL, inventário CL4R1T4S, padrões
17	Deploy Railway	Runbook: Docker, MySQL, variáveis, ingest, smoke, rollback

Ficheiro	Uso
13-staging-testes.md	Staging local, scripts `bin/`, smoke
documentation.md	Índice curto na raiz do repo
Repositório ISS — `documentation.md`	Pipeline Jobs 1–5, ingest Job 2