@danhachuel/pandanews 0.2.1 → 0.2.2

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 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

package/backend/app/main.py

@@ -19,7 +19,7 @@ async def lifespan(_: FastAPI):
     yield
 
 
-app = FastAPI(title="PandaNews API", version="0.2.1", 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.1",
+  "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/start.js

@@ -1,27 +1,30 @@
-// 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.
+// 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 e, se o
-// processo morrer de forma anormal, o backend reinicia sozinho (até 5 vezes)
-// — a UI não cai junto.
+// 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";
 
 function venvBin(home) {
@@ -59,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);
@@ -74,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);
 }
@@ -116,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);
   }
@@ -133,31 +153,22 @@ 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 espelhada no console e em <home>/data/backend.log.
-// Se o processo morrer de forma anormal, reinicia sozinho (até 5 tentativas).
+// 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:${BACKEND_PORT} ...`);
+  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(BACKEND_PORT)],
+    ['-m', 'uvicorn', 'backend.app.main:app', '--host', '127.0.0.1', '--port', String(activeBackendPort)],
     {
       cwd: PKG_ROOT,
       stdio: ['inherit', 'pipe', 'pipe'],
@@ -168,9 +179,10 @@ function startBackend(home) {
 
   const logPath = join(home, 'data', 'backend.log');
   const logStream = createWriteStream(logPath, { flags: 'a' });
-  logStream.write(`\n--- ${new Date().toISOString()} — iniciando backend (pid ${uvicorn.pid}) ---\n`);
+  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) => {
-    process.stdout.write(chunk);
     logStream.write(chunk);
   });
   uvicorn.stderr.on('data', (chunk) => {
@@ -211,6 +223,12 @@ export async function runStart() {
     return;
   }
 
+  // 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);