@danhachuel/pandanews 0.2.0 → 0.2.2

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 Todas as versões publicadas são registradas aqui antes do publish (regra em AGENTS.md). A etiqueta visual usa PATCH de dois dígitos (ex.: 0.1.00); o registry npm normaliza para a versão canônica (ex.: 0.1.0).
 
+## 0.2.02 (2026-10-24)
+
+- **O sistema NUNCA abre o navegador**: o app exibe o endereço no terminal e o usuário decide quando abrir (dependência `open` removida)
+- **Terminal limpo**: logs de acesso do uvicorn (stdout — `GET /health`, `GET /api/v1/*` etc.) vão apenas para `data/backend.log`; o console mantém somente stderr (banner de inicialização, WARNING/ERROR e tracebacks)
+- **Fallback de porta também para o backend**: se 8000 estiver ocupada (ex.: outra instância), o backend sobe em 8001, 8002... e o proxy da UI segue automaticamente — junto com o fallback já existente da UI (4030, 4031...)
+- Novo endpoint `GET /health` na raiz (200 OK) para clientes que esperam esse caminho — elimina os 404; o health canônico segue em `/api/v1/health`
+- `data/backend.log` continua registrando TODAS as requisições (incluindo `/health`) para auditoria — o filtro no logger `uvicorn.access` (Python) foi deliberadamente evitado: removeria `/health` também do arquivo de auditoria; o silenciamento é feito apenas no console
+
+## 0.2.01 (2026-10-23)
+
+- **Blindagem do backend**: saída do uvicorn espelhada no console e gravada em `<home>/data/backend.log` — queda anormal registra o motivo para diagnóstico
+- **Auto-restart**: se o backend encerrar com código anormal (ex.: 103), reinicia sozinho em 3s (até 5 tentativas) — a UI não cai junto
+- `install`: correção idempotente dos caminhos absolutos do `pyvenv.cfg` após migração de runtime (venv movida herdava caminhos antigos)
+
 ## 0.2.00 (2026-10-23)
 
 - **UI React completa** (Fase 2): Vite + TypeScript + Tailwind, sidebar com 7 seções, topbar com seletor de blog e tema claro/escuro

package/backend/app/main.py

@@ -19,7 +19,7 @@ async def lifespan(_: FastAPI):
     yield
 
 
-app = FastAPI(title="PandaNews API", version="0.2.0", lifespan=lifespan)
+app = FastAPI(title="PandaNews API", version="0.2.2", lifespan=lifespan)
 
 app.add_middleware(
     CORSMiddleware,
@@ -39,3 +39,9 @@ app.include_router(logs.router, prefix="/api/v1")
 @app.get("/api/v1/health")
 def health() -> dict:
     return {"status": "ok", "service": "pandanews", "version": app.version}
+
+
+@app.get("/health")
+def health_root() -> dict:
+    """Alias na raiz para clientes que esperam /health (extensões, monitores)."""
+    return {"status": "ok", "service": "pandanews", "version": app.version}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danhachuel/pandanews",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "SaaS local de criação e automação de múltiplos blogs de notícias com IA (FastAPI + React + Tailwind).",
   "license": "MIT",
   "type": "module",
@@ -43,7 +43,6 @@
     "extract-zip": "^2.0.1",
     "fs-extra": "^11.3.0",
     "node-fetch": "^3.3.2",
-    "open": "^10.2.0",
     "ora": "^8.2.0"
   }
 }

package/scripts/install.js

@@ -121,6 +121,25 @@ function migrateLegacyRuntime(home) {
   }
 }
 
+// Venvs carregam caminhos absolutos no pyvenv.cfg; após migração, aponta-os
+// para a localização atual do Python (idempotente).
+function fixVenvPaths(home) {
+  const cfgPath = join(home, '.runtime', 'venv', 'pyvenv.cfg');
+  if (!existsSync(cfgPath)) return;
+  const newPythonDir = join(home, '.runtime', 'python');
+  const exeRel = process.platform === 'win32' ? 'python.exe' : join('bin', 'python3');
+  let content = readFileSync(cfgPath, 'utf8');
+  const fixed = content.replace(
+    /^(home|executable|base_executable)\s*=.*$/gim,
+    (_m, key) => `${key} = ${key.toLowerCase() === 'home' ? newPythonDir : join(newPythonDir, exeRel)}`,
+  );
+  if (fixed !== content) {
+    content = fixed;
+    writeFileSync(cfgPath, content);
+    console.log('Caminhos do virtualenv corrigidos (pyvenv.cfg).');
+  }
+}
+
 async function downloadPython(home, platform) {
   const url = pythonArchiveUrl(platform);
   const runtimeDir = join(home, '.runtime');
@@ -201,6 +220,7 @@ export async function runInstall({ skipPythonDeps = false } = {}) {
     } else {
       console.log('Virtualenv já presente.');
     }
+    fixVenvPaths(home);
 
     // Dependências: só roda o pip quando o fingerprint muda.
     const fpFile = join(home, '.runtime', '.deps-fingerprint');

package/scripts/start.js

@@ -1,19 +1,29 @@
-// Inicia o PandaNews: backend FastAPI (127.0.0.1:8000) + UI (127.0.0.1:4030+).
+// Inicia o PandaNews: backend FastAPI (127.0.0.1:8000+) + UI (127.0.0.1:4030+).
 //
-// Fluxo de um único comando (padrão Thunderbolt): se o runtime não estiver
-// provisionado, executa o install completo (Python portátil + dependências)
-// antes de subir os servidores. A UI começa em PANDANEWS_UI_PORT (padrão 4030)
-// e, se a porta estiver ocupada, tenta automaticamente a seguinte (4031, ...).
-// Requisições /api/* são proxies para o backend em 127.0.0.1:8000.
-import { existsSync, readFileSync } from 'node:fs';
+// Fluxo de um único comando: se o runtime não estiver provisionado, executa o
+// install completo (Python portátil + dependências) antes de subir os
+// servidores. Ambas as portas têm fallback automático (API: 8000, 8001, ...;
+// UI: 4030, 4031, ...). O sistema NÃO abre o navegador: o endereço é exibido
+// no terminal e o usuário decide quando abrir.
+//
+// Robustez: o output do backend é gravado em <home>/data/backend.log (completo)
+// e, se o processo morrer de forma anormal, o backend reinicia sozinho (até 5
+// vezes) — a UI não cai junto. Logs de acesso não poluem o console.
+import { createWriteStream, existsSync, readFileSync } from 'node:fs';
 import { spawn } from 'node:child_process';
 import { createServer, request as httpRequest } from 'node:http';
+import net from 'node:net';
 import { join, extname } from 'node:path';
 import { resolveHome, runInstall, PKG_ROOT } from './install.js';
 
-const BACKEND_PORT = Number(process.env.PANDANEWS_API_PORT || 8000);
+const API_PORT_BASE = Number(process.env.PANDANEWS_API_PORT || 8000);
 const UI_PORT_BASE = Number(process.env.PANDANEWS_UI_PORT || 4030);
-const UI_PORT_MAX_TRIES = 20;
+const PORT_MAX_TRIES = 20;
+const BACKEND_MAX_RESTARTS = 5;
+const BACKEND_RESTART_DELAY_MS = 3000;
+const BACKEND_HEALTHY_UPTIME_MS = 60000;
+
+let activeBackendPort = API_PORT_BASE;
 
 const FAVICON_URI = "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 100'%3E%3Crect width='100' height='100' rx='20' fill='%230b1220'/%3E%3Ccircle cx='25' cy='28' r='13' fill='%23e6edf3'/%3E%3Ccircle cx='75' cy='28' r='13' fill='%23e6edf3'/%3E%3Ccircle cx='50' cy='52' r='30' fill='%23e6edf3'/%3E%3Cellipse cx='37' cy='48' rx='9' ry='11' fill='%230b1220' transform='rotate(-15 37 48)'/%3E%3Cellipse cx='63' cy='48' rx='9' ry='11' fill='%230b1220' transform='rotate(15 63 48)'/%3E%3Ccircle cx='38' cy='49' r='3' fill='%2322c55e'/%3E%3Ccircle cx='62' cy='49' r='3' fill='%2322c55e'/%3E%3Cellipse cx='50' cy='62' rx='5' ry='4' fill='%230b1220'/%3E%3C/svg%3E";
 
@@ -52,14 +62,31 @@ function placeholderPage() {
 </html>`;
 }
 
-// Encaminha /api/* para o backend FastAPI em 127.0.0.1:8000.
+// Testa se uma porta pode ser vinculada (probe real de bind).
+function probePort(port) {
+  return new Promise((resolve) => {
+    const srv = net.createServer();
+    srv.once('error', () => resolve(false));
+    srv.once('listening', () => srv.close(() => resolve(true)));
+    srv.listen(port, '127.0.0.1');
+  });
+}
+
+async function findFreePort(base, maxTries) {
+  for (let port = base; port < base + maxTries; port++) {
+    if (await probePort(port)) return port;
+  }
+  throw new Error(`Nenhuma porta livre entre ${base} e ${base + maxTries - 1}`);
+}
+
+// Encaminha /api/* para o backend FastAPI (na porta ativa).
 function proxyApi(req, res) {
   const options = {
     hostname: '127.0.0.1',
-    port: BACKEND_PORT,
+    port: activeBackendPort,
     path: req.url,
     method: req.method,
-    headers: { ...req.headers, host: `127.0.0.1:${BACKEND_PORT}` },
+    headers: { ...req.headers, host: `127.0.0.1:${activeBackendPort}` },
   };
   const proxied = httpRequest(options, (upstream) => {
     res.writeHead(upstream.statusCode || 502, upstream.headers);
@@ -67,7 +94,7 @@ function proxyApi(req, res) {
   });
   proxied.on('error', () => {
     res.writeHead(502, { 'Content-Type': 'application/json; charset=utf-8' });
-    res.end(JSON.stringify({ detail: `Backend PandaNews não responde em 127.0.0.1:${BACKEND_PORT}` }));
+    res.end(JSON.stringify({ detail: `Backend PandaNews não responde em 127.0.0.1:${activeBackendPort}` }));
   });
   req.pipe(proxied);
 }
@@ -109,8 +136,8 @@ function createUiServer() {
 }
 
 function listenUi(port, attempt) {
-  if (attempt > UI_PORT_MAX_TRIES) {
-    console.error(`Nenhuma porta livre entre ${UI_PORT_BASE} e ${UI_PORT_BASE + UI_PORT_MAX_TRIES - 1}.`);
+  if (attempt > PORT_MAX_TRIES) {
+    console.error(`Nenhuma porta livre entre ${UI_PORT_BASE} e ${UI_PORT_BASE + PORT_MAX_TRIES - 1}.`);
     console.error('Encerre algum processo que as ocupe ou defina PANDANEWS_UI_PORT.');
     process.exit(1);
   }
@@ -126,19 +153,61 @@ function listenUi(port, attempt) {
   });
   server.listen(port, '127.0.0.1', () => {
     uiServer = server;
-    console.log(`PandaNews ativo em http://127.0.0.1:${port}`);
+    console.log(`PandaNews ativo em http://127.0.0.1:${port} — abra no seu navegador.`);
     console.log('Pressione Ctrl+C para encerrar.');
-    openBrowser(`http://127.0.0.1:${port}`);
   });
 }
 
-async function openBrowser(url) {
-  try {
-    const { default: open } = await import('open');
-    await open(url);
-  } catch {
-    /* ambiente sem navegador (ex.: CI) */
-  }
+let backendProc = null;
+let backendRestarts = 0;
+
+// Sobe o backend com saída completa em <home>/data/backend.log; o console
+// mantém apenas stderr (banner, erros, tracebacks). Se o processo morrer de
+// forma anormal, reinicia sozinho (até 5 tentativas).
+function startBackend(home) {
+  console.log(`Iniciando backend FastAPI em http://127.0.0.1:${activeBackendPort} ...`);
+  const uvicorn = spawn(
+    venvBin(home),
+    ['-m', 'uvicorn', 'backend.app.main:app', '--host', '127.0.0.1', '--port', String(activeBackendPort)],
+    {
+      cwd: PKG_ROOT,
+      stdio: ['inherit', 'pipe', 'pipe'],
+      env: { ...process.env, PANDANEWS_HOME: home },
+    },
+  );
+  backendProc = uvicorn;
+
+  const logPath = join(home, 'data', 'backend.log');
+  const logStream = createWriteStream(logPath, { flags: 'a' });
+  logStream.write(`\n--- ${new Date().toISOString()} — iniciando backend (pid ${uvicorn.pid}, porta ${activeBackendPort}) ---\n`);
+  // Logs de acesso do uvicorn (stdout) vão SOMENTE para o arquivo: o terminal
+  // fica limpo. O stderr (banner, WARNING/ERROR e tracebacks) é visível.
+  uvicorn.stdout.on('data', (chunk) => {
+    logStream.write(chunk);
+  });
+  uvicorn.stderr.on('data', (chunk) => {
+    process.stderr.write(chunk);
+    logStream.write(chunk);
+  });
+
+  const startedAt = Date.now();
+  uvicorn.on('exit', (code) => {
+    logStream.end(`--- backend encerrou com código ${code} ---\n`);
+    if (code === 0 || code === null) {
+      return;
+    }
+    if (Date.now() - startedAt > BACKEND_HEALTHY_UPTIME_MS) {
+      backendRestarts = 0; // rodou saudável por tempo suficiente: zera o contador
+    }
+    backendRestarts += 1;
+    if (backendRestarts > BACKEND_MAX_RESTARTS) {
+      console.error(`Backend caiu ${backendRestarts - 1}x seguidas — desistindo.`);
+      console.error(`Log completo do backend: ${logPath}`);
+      process.exit(1);
+    }
+    console.error(`Backend encerrou com código ${code} — reiniciando em 3s (tentativa ${backendRestarts}/${BACKEND_MAX_RESTARTS})...`);
+    setTimeout(() => startBackend(home), BACKEND_RESTART_DELAY_MS);
+  });
 }
 
 export async function runStart() {
@@ -154,28 +223,18 @@ export async function runStart() {
     return;
   }
 
-  console.log(`Iniciando backend FastAPI em http://127.0.0.1:${BACKEND_PORT} ...`);
-  const uvicorn = spawn(
-    venvBin(home),
-    ['-m', 'uvicorn', 'backend.app.main:app', '--host', '127.0.0.1', '--port', String(BACKEND_PORT)],
-    {
-      cwd: PKG_ROOT,
-      stdio: 'inherit',
-      env: { ...process.env, PANDANEWS_HOME: home },
-    },
-  );
-  uvicorn.on('exit', (code) => {
-    if (code !== 0 && code !== null) {
-      console.error(`Backend encerrou com código ${code}.`);
-      process.exit(code ?? 1);
-    }
-  });
+  // Fallback de portas: API em 8000, 8001, ...; UI em 4030, 4031, ...
+  activeBackendPort = await findFreePort(API_PORT_BASE, PORT_MAX_TRIES);
+  if (activeBackendPort !== API_PORT_BASE) {
+    console.log(`Porta ${API_PORT_BASE} ocupada — backend usando ${activeBackendPort}.`);
+  }
 
+  startBackend(home);
   listenUi(UI_PORT_BASE, 1);
 
   process.on('exit', () => {
     if (uiServer) uiServer.close();
-    uvicorn.kill();
+    if (backendProc) backendProc.kill();
   });
   process.on('SIGINT', () => process.exit(0));
   process.on('SIGTERM', () => process.exit(0));