PromptCore Labs Architecture

graph LR
    A[Foundation / Governance] --> B[Bootstrap / Onboarding]
    B --> C[Knowledge / Memory]
    C --> D[Agents / Squads]
    D --> E[Runtime / Harness]
    E --> F[Models / Integrations]
    F --> G[Projects / Active Apps]
    
    style A fill:#1a365d,stroke:#3182ce,stroke-width:2px,color:#fff
    style D fill:#2c5282,stroke:#4299e1,stroke-width:2px,color:#fff
    style G fill:#2b6cb0,stroke:#63b3ed,stroke-width:2px,color:#fff
        

sequenceDiagram
    autonumber
    actor Humano as Operador Humano
    participant PL as Agente Planner
    participant BL as Agente Builder
    participant QA as Agente QA/Reviewer
    participant AD as Agente Auditor
    
    Humano->>PL: Aprova specify.md (Gate 1)
    PL->>BL: Cria e entrega tasks.md (Backlog)
    BL->>BL: Executa edições cirúrgicas (máx 3 retentativas)
    BL->>QA: Solicita validação (envia código e diffs)
    QA->>QA: Executa auditoria adversária e testes por observação
    alt Testes Falham / Adulteração Detectada
        QA-->>BL: Emite REFUTED com logs de erro
    else Testes e Diffs Aprovados
        QA->>AD: Solicita auditoria de compliance (VERIFIED)
        AD->>AD: Verifica padrões e vazamento de chaves
        AD-->>Humano: Entrega validate.md e relatório de compliance
        Humano->>Humano: Assina e aprova Stage Gate (STATE.md)
    end
        

graph LR
    classDef shortM fill:#131b2e,stroke:#38bdf8,stroke-width:2px,color:#fff;
    classDef medM fill:#0f172a,stroke:#34d399,stroke-width:2px,color:#fff;
    classDef longM fill:#1e1b4b,stroke:#c084fc,stroke-width:2px,color:#fff;
    classDef erdTable fill:#1e293b,stroke:#94a3b8,stroke-width:1.5px,color:#f8fafc;

    subgraph Tier1["1. Memoria de Curto Prazo"]
        S1["Contexto Ativo do Agente
Conversa e Prompt Buffer"]:::shortM
        S2["OmniRoute Prompt Cache
Porta 20130 EBITDA Shield"]:::shortM
        S1 --> S2
    end

    subgraph Tier2["2. Memoria de Medio Prazo"]
        M1["Docs Markdown e ADRs"]:::medM
        M2["Chunking e Embeddings 768D"]:::medM
        M3["Busca por Cosseno HNSW"]:::medM
        M1 --> M2 --> M3
    end

    subgraph Tier3["3. Memoria de Longo Prazo e ERD"]
        T1["Tabela document_chunks
id, source_file, embedding"]:::erdTable
        T2["Tabela agent_execution_logs
execution_id, session_id, metrics"]:::erdTable
        T1 -.-> T2
    end

    Tier1 --> Tier2
    Tier2 --> Tier3
        

# Executar o backup completo da Memória de Longo Prazo (PostgreSQL pcl-db + AES-256 + Cloudflare R2)
powershell -ExecutionPolicy Bypass -File "scripts/backup/backup-aeos-tripartido.ps1" -Mode cron

# Testar o Plano de Recuperação de Desastres (DRP) em 1 comando
powershell -ExecutionPolicy Bypass -File "scripts/backup/restore-aeos-tripartido.ps1"

# Inicializar todos os serviços localmente
docker compose up -d

# Acompanhar logs de inferência e governança
docker compose logs -f

# Parar contêineres preservando volumes persistentes
docker compose down

flowchart TD
    Req[Requisição do PaperClip / Agente] --> OmniRoute[OmniRoute AI Gateway :20130]
    
    subgraph ModoOnline [1. Operação Primária Online - 0 MB VRAM]
        OmniRoute -->|Rede Ativa| CloudAPI[Cloud Free Tier / OpenRouter]
        CloudAPI --> SuccessCloud((Resposta Cloud))
    end
    
    subgraph FailoverL1 [2. Failover Nível 1 - Alta Velocidade]
        CloudAPI -.->|Timeout / Queda de Rede| OllamaLocal[Ollama Local :11434
qwen2.5-coder:7b-instruct-q4_K_M]
        OllamaLocal -->|100% VRAM ~4.7 GB| SuccessOllama((Resposta Nível 1))
    end
    
    subgraph FailoverL2 [3. Failover Nível 2 - Lógica MoE / Refatoração]
        OllamaLocal -.->|Se Indisponível / Tarefa MoE| LMStudioLocal[LM Studio :1234
DeepSeek-Coder-V2-Lite MoE Q4_K_S]
        LMStudioLocal -->|GPU Offload VRAM+RAM| SuccessLMS((Resposta Nível 2))
    end
        

flowchart TD
    Daemon[Watcher Daemon: watch_network_trigger.ps1] --> Router{Status da Conexão}

    subgraph EstadoOnline [1. Estado Primário Online]
        direction TB
        Router -->|Rede Ativa / Ping OK| CloudOp[OmniRoute Roteia para Cloud APIs]
        CloudOp --> ZeroVRAM[RTX 3050 em Repouso: 0 MB VRAM]
    end

    subgraph EstadoOffline [2. Failover Local Sob Demanda]
        direction TB
        Router -.->|Queda de Rede / Timeout| TriggerOff[Dispara on_offline_event.ps1]
        TriggerOff --> L1[Nível 1: Ollama qwen2.5-coder:7b
100% VRAM ~4.7 GB]
        L1 -.->|Se Indisponível ou MoE| L2[Nível 2: LM Studio DeepSeek MoE
GPU Offload VRAM + RAM]
    end

    subgraph EstadoRestauracao [3. Restauração & Desalocação]
        direction TB
        Router -.->|Rede Restabelecida| TriggerOn[Dispara on_online_event.ps1]
        TriggerOn --> Unload[lms unload --all e ollama stop]
        Unload --> ZeroReturn[Retorno Estrito a 0 MB VRAM]
    end

    ZeroReturn -->|GPU 100% Liberada| Router