From e4e809fa5b32fc02d2d60f2236e4d293415891d3 Mon Sep 17 00:00:00 2001 From: Jonas Pacheco Date: Wed, 25 Mar 2026 10:52:59 -0300 Subject: [PATCH] docs(03-01): atualizar SUMMARY.md com commits e desvios do plano 03-01 - Adicionar hashes de commit ao SUMMARY.md - Documentar fallback llama3.2:3b para researcher - Documentar conftest.py como desvio Rule 2 - Atualizar STATE.md com plano 03-01 concluido - Atualizar ROADMAP.md progresso fase 3 --- .planning/ROADMAP.md | 106 ++++++++++++++++++ .planning/STATE.md | 18 +++ .../03-miroflow-embutido/03-01-SUMMARY.md | 10 ++ 3 files changed, 134 insertions(+) create mode 100644 .planning/ROADMAP.md create mode 100644 .planning/STATE.md diff --git a/.planning/ROADMAP.md b/.planning/ROADMAP.md new file mode 100644 index 0000000..2aefa82 --- /dev/null +++ b/.planning/ROADMAP.md @@ -0,0 +1,106 @@ +# Roadmap: Arcádia Agentic Suite + +## Overview + +Evolução do Arcádia Suite de ERP tradicional para Sistema Agêntico Orientado a Objetos. Skills são objetos reutilizáveis (POO), Agentes instanciam Skills, Automações são composições orquestradas, Dev Center é a fábrica de agentes. + +## Phases + +- [x] **Phase 1: Fundação** - Infraestrutura base: submodules MiroFlow/OpenClaw, tabelas skills, Neo4j, ReferenceParser +- [~] **Phase 2: Skills Engine** - Skills criáveis e executáveis com editor Monaco e Marketplace +- [ ] **Phase 3: MiroFlow Embutido** - Análises científicas via agentes especializados + bridge Superset +- [ ] **Phase 4: OpenClaw Embutido** - Skills emergentes com detecção de padrões +- [ ] **Phase 5: Automation Fabric** - Automações unificadas (XOS + Central) +- [ ] **Phase 6: Dev Center Completo** - Fábrica de agentes: Design → Assemble → Deploy + +## Phase Details + +### Phase 1: Fundação +**Goal**: Infraestrutura base funcionando com submodules, banco, KG e parser de referências +**Depends on**: Nothing +**Success Criteria** (what must be TRUE): + 1. Submodules MiroFlow e OpenClaw clonados e inicializados + 2. Tabelas arcadia_skills e skill_executions existem no banco + 3. Neo4j rodando via docker-compose + 4. ReferenceParser parseia referências /skill/, /kg/, /file/ etc. + +Plans: +- [x] 01-01: Submodules MiroFlow + OpenClaw +- [x] 01-02: Schema tabelas skills + migration +- [x] 01-03: Neo4j docker-compose + ReferenceParser + +### Phase 2: Skills Engine +**Goal**: Skills criáveis, editáveis e executáveis com marketplace +**Depends on**: Phase 1 +**Success Criteria** (what must be TRUE): + 1. SkillEngine.ts suporta herança, composição e polimorfismo + 2. API REST /skills CRUD funcionando + 3. Editor Monaco com autocomplete de referências (/) + 4. Skill Marketplace lista e filtra skills disponíveis + 5. Versionamento Git-like de skills implementado + +Plans: +- [x] 02-01: SkillEngine + API REST +- [x] 02-02: Editor Monaco + autocomplete + rota /skills +- [x] 02-03: Skill Marketplace (Biblioteca) +- [ ] 02-04: Versionamento Git-like de skills + +### Phase 3: MiroFlow Embutido +**Goal**: Análises científicas disponíveis via agentes especializados integrados ao Superset +**Depends on**: Phase 2 +**Success Criteria** (what must be TRUE): + 1. MiroFlow configurado para Ollama local com modelos até 14B + 2. Agente Statistician analisa dados SQL com deepseek-r1:14b + 3. Agente Fiscal Auditor valida NFe/SPED com deepseek-r1:14b + 4. Agente Researcher consulta KG com llama3.1:8b + 5. Endpoint POST /api/miroflow/analyze retorna análise estruturada + 6. MiroFlowControl.tsx toggle "Modo Científico" aparece no Superset + 7. Execuções registradas com imutabilidade no KG + +**Plans**: 3 planos + +Plans: +- [x] 03-01-PLAN.md — Setup (ollama pull llama3.1:8b) + miroflow_service.py FastAPI porta 8006 com 3 agentes +- [x] 03-02-PLAN.md — Node bridge (engine-proxy.ts + routes.ts) + KG logging SHA-256 +- [ ] 03-03-PLAN.md — Frontend MiroFlowControl.tsx + tab "Científico" em BiWorkspace.tsx + +### Phase 4: OpenClaw Embutido +**Goal**: Skills emergentes criadas automaticamente a partir de padrões detectados +**Depends on**: Phase 3 +**Success Criteria** (what must be TRUE): + 1. PatternDetector detecta padrões (min 3 ocorrências, 30 dias, 80% confiança) + 2. Skills emergentes criadas como DRAFT aguardando aprovação + 3. Widget flutuante notifica usuário de sugestões + 4. Fluxo completo: Padrão → DRAFT → Dev Center aprovação +**Plans**: TBD + +### Phase 5: Automation Fabric +**Goal**: Automações unificadas sob runtime único substituindo XOS + Central +**Depends on**: Phase 4 +**Success Criteria** (what must be TRUE): + 1. 5 runtimes funcionando: WorkflowEngine, RuleEngine, AgentExecutor, ScheduleEngine, EventEngine + 2. Automações existentes do XOS migradas sem perda de dados + 3. Automações existentes do /automations Central migradas + 4. AutomationCenter.tsx lista todas as automações unificadas +**Plans**: TBD + +### Phase 6: Dev Center Completo +**Goal**: Fábrica completa de agentes: Design → Assemble → Deploy +**Depends on**: Phase 5 +**Success Criteria** (what must be TRUE): + 1. DesignStudio com modos UML, Visual Flow, Markdown Spec, Code Editor + 2. AssembleLine gera código via Blackboard (GeneratorAgent) + 3. OrchestrateCenter faz deploy, versionamento e monitoramento + 4. Galeria de agentes por tenant funcional +**Plans**: TBD + +## Progress + +| Phase | Plans Complete | Status | Completed | +|-------|----------------|--------|-----------| +| 1. Fundação | 3/3 | Complete | 2026-03-25 | +| 2. Skills Engine | 3/4 | In progress | - | +| 3. MiroFlow Embutido | 2/3 | In Progress| | +| 4. OpenClaw Embutido | 0/TBD | Not started | - | +| 5. Automation Fabric | 0/TBD | Not started | - | +| 6. Dev Center Completo | 0/TBD | Not started | - | diff --git a/.planning/STATE.md b/.planning/STATE.md new file mode 100644 index 0000000..c5b84a9 --- /dev/null +++ b/.planning/STATE.md @@ -0,0 +1,18 @@ +# State + +## Current Phase: 3 — MiroFlow Embutido + +## Completed +- Phase 1: submodules, tabelas, Neo4j, ReferenceParser +- Phase 2: SkillEngine, API REST, Monaco Editor, /skills, autocomplete, Marketplace + +## Completed Plans +- Phase 3, Plan 01: miroflow_service.py + tests (60f1c5c, 76e1d34) + +## In Progress +- Phase 2 pendente: versionamento Git-like de skills (pode ser feito em paralelo ou movido para backlog) + +## Notes +- Superset em produção com RLS configurado — não alterar sem confirmação +- Branch de deploy: `Servidor` +- Modelos Ollama precisam ser baixados: deepseek-r1:14b, llama3.1:8b (máximo 14B) diff --git a/.planning/phases/03-miroflow-embutido/03-01-SUMMARY.md b/.planning/phases/03-miroflow-embutido/03-01-SUMMARY.md index fbe0532..21a7142 100644 --- a/.planning/phases/03-miroflow-embutido/03-01-SUMMARY.md +++ b/.planning/phases/03-miroflow-embutido/03-01-SUMMARY.md @@ -36,3 +36,13 @@ llama3.1:8b nao disponivel no Ollama local — fallback automatico para llama3.2 omegaconf 2.3.0, hydra-core 1.3.2, mcp 1.26.0 instalados via pip3 --break-system-packages. ## Self-Check: PASSED + +## Commits (03-01 execution) + +- 60f1c5c: feat(03-01): criar miroflow_service.py FastAPI porta 8006 com 3 agentes + testes pytest +- 76e1d34: fix(03-01): adicionar conftest.py para resolver imports em pytest do root + +## Deviations + +- [Rule 2] conftest.py adicionado: pytest da raiz falhava sem sys.path fix +- [Documentado] llama3.2:3b usado como fallback para researcher (llama3.1:8b nao instalado)