--- title: "Especificação Funcional e Arquitetural do PCL Cockpit v3.8" system_scope: "PCL Cockpit" kernel_version: "v3.8.0" type: "Architecture_Spec" status: "Approved" rag_tags: [pcl_cockpit, architecture, specifications, v3.8, thread_zero, squads, skills_manager, no_code_wizard, shadow_dom_extension, hitl_escalation, cfo_roi_calculator, sha256_audit, ebitda_shield] created_at: "2026-11-03" last_updated: "2026-11-03" author: "PromptCore Labs Architecture & Cortex Intelligence" normative_ref: "PCL-AEOS-NORM-01" --- # 🖥️ Especificação Funcional & Arquitetural: PCL Cockpit v3.8 > **Definição Canônica:** O **PCL Cockpit** é o centro de comando agêntico soberano e a interface executiva e técnica do ecossistema PromptCoreLabs_AEOS, executado na porta local **`:3001`**. A versão **v3.8** consolida o saneamento ergonômico pleno, a extensão companheira no navegador via Shadow DOM isolado, a escalação hierárquica Human-in-the-Loop em 2 níveis, o despacho 1-clique de atas WhisperX e o Simulador Soberano de ROI Corporativo para o CFO. > [!IMPORTANT] > **👔 Visão Executiva & Valor de Negócio (Para C-Level, Diretores e Investidores):** > Concebido pela **PromptCore Labs**, o **PCL Cockpit v3.8** é a cabine de pilotagem que orquestra esquadrões de agentes autônomos sob o **PCL AEOS**. Em rigorosa **Avaliação Técnica Duplo-Cega Imparcial** (na qual especialistas julgaram a qualidade sem saber a marca da IA), conquistou a liderança global com **4.95 / 5.0** — superando Google Gemini (`4.45`), ChatGPT Enterprise (`4.30`) e Microsoft Copilot (`3.80`). Garante **Segredo Corporativo Blindado (Resíduo Zero de Dados / BYOS)**, **custo marginal de $0.00** em modo local, trava orçamentária rígida (*EBITDA Shield*) e autoridade decisória humana irrevogável. > [!NOTE] > **🛠️ Visão de Engenharia & Invariantes Físicos:** Aplicação React 19 + TypeScript + Vite (`:3001`) com *Liquid Glass Bento Grid* de 3 colunas retráteis, **Invariante de 0 MB de VRAM na CPU** para o coprocessador Laya System One (`ONNX INT8` via `CPUExecutionProvider`), **Extensão Manifest V3** com encapsulamento estrito por **Shadow DOM** em ERPs/CRMs legados, barramento de telemetria HTTP real (`/api/aeos/status`) e atesto criptográfico imutável **SHA-256** compatível com ISO/IEC 27001 e ISO/IEC 42001. --- ## 1. Topologia de Apresentação (3 Colunas Retráteis & Extensão Injetada) ```mermaid flowchart LR subgraph C1["1. Left Sidebar (64px–260px)"] direction TB L1["Projetos & Squads
Acordeão por data e área"] L2["Thread Zero
Início limpo com Hero State"] L1 --> L2 end subgraph C2["2. Central Workspace (Dual-Plex)"] direction TB M1["Live Stepper (5 Fases)
Telemetria síncrona em ms"] M2["Inteligência de Reuniões
Atas WhisperX & Despacho 1-Clique"] M3["Cortex Canvas DAG
Grafo acíclico dirigido interativo"] M1 --> M2 --> M3 end subgraph C3["3. Right Sidebar & Drawer"] direction TB R1["Monitor de Extensões Ativas
Sessões injetadas & revogação"] R2["Sovereign Drawer (380–850px)
Docs, FinOps Ledger & Audit SHA-256"] R1 --> R2 end subgraph EXT["4. PCL Companion Extension (Navegador)"] direction TB X1["Shadow DOM Fechado
Zero vazamento de CSS em Salesforce/SAP"] X2["Inline Action Dock
Polir, Auditar Laya e Traduzir in-situ"] X3["Trivial Gate HitL (2 Níveis)
Aprovação N1 ➔ N2 Diretoria ➔ TTL 120s"] X1 --> X2 --> X3 end C1 ==> C2 ==> C3 C2 -.-> EXT ``` --- ## 2. As 12 Grandes Inovações Consolidadas na Versão v3.8 ### 1. Inicialização Limpa (Thread Zero com Hero State) - Ao abrir o Cockpit, a tela inicia em **Thread Zero** limpa, exibindo o *Executive Hero Empty State* com quatro cartões de ação rápida (*Análise de Arquitetura Cortex*, *Auditoria FinOps & ROI*, *Inteligência de Reuniões WhisperX* e *Gestor de Squads*), permitindo que o usuário comece uma thread inédita sem poluição de conversas anteriores. ### 2. Higiene Constitucional & Purge de Nomes de Concorrentes - Eliminação absoluta de marcas e nomenclaturas de produtos de terceiros (*Tactiq, Jumpad, Read.ai*) do código-fonte, traduções e documentação técnica. - Padronização rigorosa da **Tríade Institucional Canônica**: **PromptCore Labs** (Holding/Laboratório), **PCL AEOS** (Sistema Operacional/Kernel) e **PCL Cockpit** (Interface/Cabine `:3001`). ### 3. Telemetria Real em Runtime (Zero Mocks) - Monitoramento contínuo via serviço [`daemonHealthService.ts`](file:///c:/PromptCore_Labs/projects/PromptCoreLabs_AEOS_Dashboard/src/services/telemetry/daemonHealthService.ts) realizando probes HTTP reais no endpoint `/api/aeos/status`: - **OmniRoute LLM Gateway** (`:20130`): Roteador resiliente multi-provedor. - **Ollama Host Generativo** (`:11434`): Inferência local soberana na GPU RTX 3050 (`qwen2.5-coder:7b`). - **Laya System One Coprocessor** (`:20140`): Invariante física de **0 MB de VRAM** em CPU INT8 (`CPUExecutionProvider`). - **PostgreSQL 17 Enclave** (`:5432`): Banco relacional e vetorial PGVector com trilha SHA-256. - **Paperclip Automation Engine** (`:3100`): Orquestrador de tarefas em segundo plano. ### 4. Internacionalização Tridimensional Perfeita (PT, EN, ES) - Localização executiva completa em Português (Brasil), Inglês (EUA) e Espanhol (LATAM) com sincronização em tempo real via [`translations.ts`](file:///c:/PromptCore_Labs/projects/PromptCoreLabs_AEOS_Dashboard/src/i18n/translations.ts). ### 5. Biblioteca de Conexões & Servidores MCP Bipartida - **Servidores MCP Soberanos Locais:** Conexões com engines locais via protocolo JSON-RPC nativo e checagem real de latência. - **Conectores Corporativos Externos:** Conectores com credenciais criptografadas localmente em cofre AES-256-GCM sob custódia corporativa blindada (*BYOS*). ### 6. Orquestrador Dinâmico de Squads & Agentes - Módulo [`AgentSquadOrgChart.tsx`](file:///c:/PromptCore_Labs/projects/PromptCoreLabs_AEOS_Dashboard/src/components/admin/AgentSquadOrgChart.tsx) com CRUD dinâmico completo de esquadrões e agentes, permitindo pausar, editar prompts de sistema, alternar modelos e definir níveis de autonomia da metodologia TLC-v3 (*Assistido, Supervisionado, Autônomo*). ### 7. Gestor de Skills Especializadas (Skills Manager) - Módulo [`SkillsManager.tsx`](file:///c:/PromptCore_Labs/projects/PromptCoreLabs_AEOS_Dashboard/src/components/admin/SkillsManager.tsx) abrangendo cinco domínios de negócio (*Segurança & Governança*, *Arquitetura & Engenharia*, *Reuniões & Áudio*, *FinOps & Custos*, *Automação & Orquestração*), com editor markdown de contratos `SKILL.md` e parametrização de sandbox. ### 8. Criador de Agentes No-Code (Wizard em 4 Passos) - Assistente intuitivo [`NoCodeAgentBuilder.tsx`](file:///c:/PromptCore_Labs/projects/PromptCoreLabs_AEOS_Dashboard/src/components/admin/NoCodeAgentBuilder.tsx) estruturado em quatro etapas: *1. Identidade & Missão*, *2. Cérebro & FinOps*, *3. Habilidades & Tools* e *4. Governança & Publicação*, com visualização ao vivo e publicação direta no Cockpit (`@AgentName`). ### 9. Livro-Razão FinOps Soberano & Trava Rígida Hard Lock - Painel [`CostsTokenDashboard.tsx`](file:///c:/PromptCore_Labs/projects/PromptCoreLabs_AEOS_Dashboard/src/components/admin/CostsTokenDashboard.tsx) com indicador de Taxa de Soberania (88.4%), cálculo de dólares poupados (US$ 1.420,00 no mês corrente), trava física rígida (*Hard Lock*) que corta chamadas a APIs pagas no teto orçamentário e exportação de livro-razão em `.csv`. ### 10. Simulador de ROI Soberano CFO (EBITDA Shield v2) - Calculadora executiva interativa para diretores financeiros com predefinições de `25`, `50`, `100`, `250`, `500` e `1.000` colaboradores: - Compara a sangria orçamentária de US$ 60/usuário/mês de nuvens externas contra o custo marginal de **R$ 0,00** da inferência local soberana. - Para **250 colaboradores**, projeta economia anual líquida de **US$ 180.000,00 / R$ 1.026.000,00** retida integralmente no caixa da empresa com payback imediato (Mês 1). - Emissão de parecer financeiro formal em formato `.json` com atesto criptográfico SHA-256. ### 11. Companion Extension Manifest V3 & Injeção em Legados - Extensão de navegador em [`projects/pcl-cockpit-extension/`](file:///c:/PromptCore_Labs/projects/pcl-cockpit-extension/) com encapsulamento por **Shadow DOM**: - **Inline Action Dock:** Barra de atalhos in-situ sobre campos `