From 071d74c7a353afbaf8fd02594720197f34b53fcf Mon Sep 17 00:00:00 2001 From: Jonas Pacheco Date: Wed, 25 Mar 2026 10:45:15 -0300 Subject: [PATCH] docs(03-02): criar SUMMARY.md do plano 03-02 --- .../03-miroflow-embutido/03-02-SUMMARY.md | 40 +++++++++++++++++++ 1 file changed, 40 insertions(+) create mode 100644 .planning/phases/03-miroflow-embutido/03-02-SUMMARY.md diff --git a/.planning/phases/03-miroflow-embutido/03-02-SUMMARY.md b/.planning/phases/03-miroflow-embutido/03-02-SUMMARY.md new file mode 100644 index 0000000..d08762e --- /dev/null +++ b/.planning/phases/03-miroflow-embutido/03-02-SUMMARY.md @@ -0,0 +1,40 @@ +--- +plan: "03-02" +phase: "03-miroflow-embutido" +status: complete +completed: 2026-03-25 +--- + +# Summary: 03-02 — Node.js MiroFlow Bridge + +## What was built + +Bridge Node.js → Python para o MiroFlow: proxy TypeScript com timeout 300s, rotas Express autenticadas e registro imutável de execuções no KG via auditHash SHA-256. + +## Files created/modified + +### Created +- `server/miroflow/engine-proxy.ts` — proxy para :8006, MIROFLOW_TIMEOUT=300_000ms, registerExecutionInKG com SHA-256 +- `server/miroflow/routes.ts` — re-export de registerMiroFlowRoutes + +### Modified +- `server/routes.ts` — import + chamada registerMiroFlowRoutes(app) após registerBiEngineRoutes + +## Key decisions + +- Timeout de 300_000ms (5 min) para POST /analyze — adequado para deepseek-r1:14b +- Health check usa timeout curto (5_000ms) +- KG failure não bloqueia resposta ao cliente (try/catch com console.error) +- auditHash cobre: execution_id + agent + model + input + output + +## TypeScript compilation + +Erros nos novos arquivos: **0** +(Erros pré-existentes em App.tsx e server/modules/miroflow/ não relacionados) + +## Commits + +- `d53be76` — feat(03-02): criar MiroFlow proxy TypeScript com timeout 300s e KG audit logging +- `1a70e87` — feat(03-02): registrar MiroFlow routes em server/routes.ts + +## Self-Check: PASSED