resumo técnico direto do PRAXIUM
# DIAGNOSTICO_TECNICO_PRAXIUM_NIM_01
## 0. Resumo Executivo
O **PRAXIUM NIM-01** é um **núcleo local governado de execução procedural estruturada**, concebido como base mínima funcional do sistema PRAXIUM. Sua função não é atuar como agente autônomo, chatbot ou sistema de inteligência viva, mas servir como **alicerce técnico seguro, previsível e auditável** para execuções locais controladas.
O sistema já apresenta **boa coerência operacional**, sobretudo pela combinação entre:
- `run.py` como orquestrador principal
- `executor.py` como executor soberano
- validação por schemas
- política por workspaces
- logs e ledger auditáveis
- operação em `dry-run` por padrão
O maior gargalo atual não está no conceito nem no núcleo de execução, mas em **três frentes**:
1. **versionamento documental fragmentado**
2. **inconsistências entre regras e índices operacionais**
3. **crescimento do orquestrador sem consolidação modular**
A diretriz recomendada é declarar **v1.5** como estado canônico oficial, preservar `v1.0` e `v1.4` como base histórica e preparar a transição futura para uma estrutura mais modular.
---
## 1. Identidade do Sistema
O **PRAXIUM NIM-01** é o **núcleo mínimo funcional** do sistema PRAXIUM.
Ele foi descrito como uma extração técnica do `PRAXIUM_OS_5_0_3`, representando o menor conjunto estável e executável capaz de:
- governar execução local
- garantir segurança operacional
- servir como base sólida para evolução futura
- funcionar sem dependência obrigatória de IA
### Princípios centrais
- **Puramente local**
- **Governança antes de inteligência**
- **Segurança por padrão**
- **Nada é apagado**
- **O núcleo não cresce; evoluções entram como módulos externos**
### O que o sistema não é
O NIM-01 não é:
- chatbot
- agente autônomo
- sistema com memória viva
- sistema dependente de LLM
- produto final
Ele é um **núcleo soberano de governança e execução local**.
---
## 2. Linha Evolutiva
### v1.0 — Base histórica inicial
A versão `v1.0` consolidou o núcleo funcional mínimo do PRAXIUM NIM-01 com foco em:
- governança
- execução declarativa
- separação entre infraestrutura, conhecimento e execução
- nenhuma inteligência artificial acoplada
Nessa fase, o sistema era mais estrito e deliberadamente limitado.
### v1.4 — Consolidação operacional
A versão `v1.4` já foi descrita como **STABLE**, incorporando:
- execução local governada
- enforcement real de `allowed_operations`
- workspaces versionados
- logs imutáveis por workspace
- relatórios derivados
- IA subordinada em leitura apenas
- separação clara entre `TOOLS`, `LOGS`, `REPORTS` e `AI_SUBORDINATE`
### v1.5 — Estado operacional atual
O `run.py` atual já se apresenta como **v1.5**, incorporando:
- fila `INPUT/COMMANDS`
- handler `socrates.audit`
- ledger canônico
- ACKs e evidências
- coexistência entre modo legado (`tasks.json`) e modo por fila
### Diretriz de governança recomendada
- **Versão documental canônica:** `v1.5`
- **Base histórica preservada:** `v1.0` e `v1.4`
- **Base operacional oficial:** `run.py` + `executor.py`
- **Base futura modular:** `core/`, `motors/`, `schemas/`
---
## 3. Arquitetura Atual
A arquitetura atual é simples, funcional e governada.
### Componentes principais
#### `run.py`
É o **orquestrador principal** do sistema.
Responsabilidades:
- carregar `config.json`
- carregar `tasks.json`
- carregar índice de workspaces
- verificar permissões por workspace
- chamar o executor soberano
- escrever ACKs
- escrever evidências
- registrar logs auxiliares por workspace
- operar a fila `INPUT/COMMANDS`
- rotear o handler `socrates.audit`
#### `executor.py`
É o **executor soberano e seguro**.
Responsabilidades:
- aplicar whitelist
- bloquear metacaracteres perigosos
- operar em `dry-run`
- executar comandos reais quando permitido
- registrar ledger canônico
- validar eventos via JSON Schema
- enviar eventos inválidos para quarentena
- processar arquivos de `INPUT/COMMANDS`
#### `config.json`
Define o estado operacional do sistema:
- timeouts
- polling
- log level
- modo de análise
- política de segurança
- features habilitadas
#### `tasks.json`
Representa o modelo declarativo legado de tarefas, com ações explícitas e vinculadas a workspaces.
#### `WORKSPACES/`
Representa a camada de contexto e governança do sistema.
#### `SCHEMAS/`
Garante integridade dos envelopes e payloads.
### Fluxo lógico atual
```text
Usuário / Input
↓
run.py (orquestração e governança)
↓
executor.py (execução soberana)
↓
validação por schemas
↓
registro em ledger / logs / evidências / ACK
↓
processamento controlado no workspace
Comentários
Postar um comentário