@danhachuel/pandanews 0.1.1 → 0.1.3

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.1.03 (2026-10-23)
+
+- Runtime movido para um diretório **estável por usuário** (`~/.pandanews`, sobrescrevível via `PANDANEWS_HOME`): upgrades de versão do pacote não reinstalam mais Python/dependências — o instalador detecta o que já existe e só instala o que falta
+- **Migração automática**: runtimes de instalações anteriores (cache do npx ou layout antigo na pasta do pacote) são localizados e reaproveitados em vez de baixados de novo (`PANDANEWS_SKIP_MIGRATE=1` força instalação limpa)
+- **Fingerprint de dependências** (requirements.txt + versão do Python): o pip só roda quando os requisitos mudam
+- Reinstalação do Python apenas quando a versão do runtime muda (limpeza automática do antigo)
+- Workflow: passo `npm ci` antes do smoke test — o checkout do CI não tem `node_modules` e o launcher (que importa `fs-extra`) falhava com ERR_MODULE_NOT_FOUND
+
+## 0.1.02 (2026-10-23)
+
+- Porta padrão da UI alterada de 3030 para **4030** (sobrescrevível via `PANDANEWS_UI_PORT`)
+- Fallback automático de porta: se 4030 estiver ocupada, o PandaNews tenta a seguinte (4031, 4032, ...) em até 20 tentativas, com mensagem clara se nenhuma estiver livre
+- CORS do backend passa a aceitar localhost/127.0.0.1 em qualquer porta, acompanhando a porta dinâmica da UI
+
 ## 0.1.01 (2026-10-23)
 
 - README reescrito para o fluxo de um único comando via npx (padrão Thunderbolt): `npx @danhachuel/pandanews` instala tudo junto e sobe o app; removidas as instruções manuais de desenvolvimento (pip, uvicorn, npm)

package/README.md

@@ -32,11 +32,11 @@ npx.cmd --yes --prefer-online @danhachuel/pandanews install
 npx --yes @danhachuel/pandanews install
 ```
 
-O runtime fica em `.runtime/` na raiz do pacote (sobrescreva com a variável de ambiente `PANDANEWS_HOME`).
+O runtime fica em `~/.pandanews` (sobrescreva com a variável de ambiente `PANDANEWS_HOME`) — **upgrades de versão não reinstalam** o que já existe: o instalador detecta Python, dependências e dados já presentes e só instala o que falta.
 
-## Status (versão 0.1.01)
+## Status (versão 0.1.03)
 
-- `npx @danhachuel/pandanews` instala tudo junto (Python portátil + dependências + banco local) e sobe o backend em 127.0.0.1:8000 com página em 127.0.0.1:3030
+- `npx @danhachuel/pandanews` instala tudo junto (Python portátil + dependências + banco local) e sobe o backend em 127.0.0.1:8000 com página em 127.0.0.1:4030 — se a porta estiver ocupada, usa a seguinte automaticamente (4031, 4032, ...)
 - A UI React completa (Dashboard, Blogs, Notícias, Imagens, Automação, Configurações) e o pipeline de notícias chegam nas próximas versões (Fases 1 a 3 do plano — ver `CHANGELOG.md`)
 
 ## Regras do projeto

package/backend/app/main.py

@@ -1,16 +1,17 @@
 """PandaNews API — FastAPI.
 
 Fase 0/1: aplicação mínima com endpoint de health e CORS liberado para a UI
-local (127.0.0.1:3030). CRUD de blogs e configurações chegam na Fase 1.
+local (localhost/127.0.0.1 em qualquer porta — a UI usa porta dinâmica a partir
+de 4030). CRUD de blogs e configurações chegam na Fase 1.
 """
 from fastapi import FastAPI
 from fastapi.middleware.cors import CORSMiddleware
 
-app = FastAPI(title="PandaNews API", version="0.1.1")
+app = FastAPI(title="PandaNews API", version="0.1.3")
 
 app.add_middleware(
     CORSMiddleware,
-    allow_origins=["http://localhost:3030", "http://127.0.0.1:3030"],
+    allow_origin_regex=r"^https?://(localhost|127\.0\.0\.1)(:\d+)?$",
     allow_methods=["*"],
     allow_headers=["*"],
 )

package/frontend/README.md

@@ -5,4 +5,4 @@ UI do PandaNews (React + Vite + Tailwind), inicializada na Fase 2 do plano de im
 - Páginas: Dashboard, Blogs, Notícias, Imagens, Automação, Configurações, Logs
 - Sidebar + topbar no padrão Leadmaster
 - 7 leis de usabilidade aplicadas (Fitts, Hick, Zeigarnik, Jakob, Gradiente de Meta, von Restorff, Miller)
-- Build: `npm run build` → `dist/` servido em 127.0.0.1:3030
+- Build: `npm run build` → `dist/` servido em 127.0.0.1:4030 (com fallback para 4031, 4032, ... se ocupada)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danhachuel/pandanews",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "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",

package/scripts/install.js

@@ -1,15 +1,22 @@
 // Instalador do runtime PandaNews.
 //
-// Provisiona tudo em um único comando (padrão Thunderbolt):
-// 1. estrutura de pastas (data/, .runtime/)
-// 2. Python 3.12.7 portátil via python-build-standalone (sem Python pré-instalado)
-// 3. virtualenv em .runtime/venv
-// 4. dependências do backend (backend/requirements.txt)
-// 5. marcadores de estado (.runtime/.ready, .runtime/.python-ready)
-import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+// O runtime vive em um diretório ESTÁVEL por usuário (~/.pandanews, ou
+// PANDANEWS_HOME), separado da pasta do pacote npm: upgrades de versão não
+// reinstalam Python/dependências. O instalador detecta o que já existe e só
+// executa o que falta:
+//   1. estrutura de pastas (data/, .runtime/)
+//   2. Python 3.12.7 portátil (python-build-standalone)
+//   3. virtualenv (.runtime/venv)
+//   4. dependências do backend — com fingerprint de requirements.txt + versão
+//      do Python: pip só roda quando mudam
+//   5. migração de runtimes legados (pasta do pacote / cache do npx)
+import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync } from 'node:fs';
 import { spawnSync } from 'node:child_process';
-import { join, resolve } from 'node:path';
+import { createHash } from 'node:crypto';
+import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import os from 'node:os';
+import fse from 'fs-extra';
 
 const __dirname = fileURLToPath(new URL('.', import.meta.url));
 export const PKG_ROOT = join(__dirname, '..');
@@ -17,9 +24,10 @@ export const PKG_ROOT = join(__dirname, '..');
 const PYTHON_VERSION = '3.12.7';
 const PYTHON_RELEASE = '20241016';
 
-// Raiz de instalação: PANDANEWS_HOME sobrepõe o padrão (raiz do pacote instalado).
+// Raiz de instalação estável: PANDANEWS_HOME sobrepõe; padrão ~/.pandanews.
 export function resolveHome() {
-  return process.env.PANDANEWS_HOME ? resolve(process.env.PANDANEWS_HOME) : PKG_ROOT;
+  if (process.env.PANDANEWS_HOME) return resolve(process.env.PANDANEWS_HOME);
+  return join(os.homedir(), '.pandanews');
 }
 
 // Detecta plataforma e asset de python-build-standalone.
@@ -51,6 +59,68 @@ function venvBin(home) {
     : join(home, '.runtime', 'venv', 'bin', 'python');
 }
 
+function pythonSpec() {
+  return `cpython-${PYTHON_VERSION}+${PYTHON_RELEASE}`;
+}
+
+// Fingerprint das dependências: muda quando o requirements.txt ou a versão do
+// Python mudam — só então o pip roda de novo.
+function depsFingerprint() {
+  const reqPath = join(PKG_ROOT, 'backend', 'requirements.txt');
+  const req = existsSync(reqPath) ? readFileSync(reqPath, 'utf8') : '';
+  const hash = createHash('sha256').update(req).digest('hex').slice(0, 16);
+  return `${pythonSpec()};req=${hash}`;
+}
+
+// Procura runtimes legados: na própria pasta do pacote (layout antigo) e nos
+// buckets do cache do npx (versões anteriores do pacote). Best effort.
+function findLegacyRuntime() {
+  const candidates = [];
+  const marker = '.python-ready';
+  const sameDir = join(PKG_ROOT, '.runtime');
+  if (existsSync(join(sameDir, marker))) candidates.push(sameDir);
+  try {
+    const cacheBase = process.env.npm_config_cache
+      ? process.env.npm_config_cache
+      : join(os.homedir(), process.platform === 'win32' ? join('AppData', 'Local', 'npm-cache') : '.npm');
+    const npxRoot = join(cacheBase, '_npx');
+    if (existsSync(npxRoot)) {
+      for (const entry of readdirSync(npxRoot)) {
+        const rt = join(npxRoot, entry, 'node_modules', '@danhachuel', 'pandanews', '.runtime');
+        if (existsSync(join(rt, marker))) candidates.push(rt);
+      }
+    }
+  } catch { /* best effort */ }
+  if (candidates.length === 0) return null;
+  candidates.sort((a, b) => statSync(join(b, marker)).mtimeMs - statSync(join(a, marker)).mtimeMs);
+  return candidates[0];
+}
+
+// Reaproveita um runtime legado movendo-o para o home estável. Pula se o home
+// já tiver um runtime válido, ou se PANDANEWS_SKIP_MIGRATE estiver definido.
+function migrateLegacyRuntime(home) {
+  if (process.env.PANDANEWS_SKIP_MIGRATE) return;
+  const targetRuntime = join(home, '.runtime');
+  if (existsSync(join(targetRuntime, '.python-ready'))) return;
+  const legacy = findLegacyRuntime();
+  if (!legacy) return;
+  console.log(`Runtime já instalado encontrado em ${legacy} — reaproveitando (movendo para ${home})...`);
+  try {
+    // Remove stubs vazios criados antes da migração: rename de diretório no
+    // Windows falha (EPERM) quando o destino já existe.
+    rmSync(targetRuntime, { recursive: true, force: true });
+    fse.moveSync(legacy, targetRuntime);
+    const legacyData = join(dirname(legacy), 'data');
+    if (existsSync(legacyData)) {
+      fse.copySync(legacyData, join(home, 'data'));
+      rmSync(legacyData, { recursive: true, force: true });
+    }
+    console.log('Migração concluída.');
+  } catch (err) {
+    console.log(`Migração falhou (${err && err.message}) — seguindo com instalação nova.`);
+  }
+}
+
 async function downloadPython(home, platform) {
   const url = pythonArchiveUrl(platform);
   const runtimeDir = join(home, '.runtime');
@@ -108,9 +178,19 @@ export async function runInstall({ skipPythonDeps = false } = {}) {
 
   if (skipPythonDeps) {
     console.log('--skip-python-deps: instalação estrutural (uso em CI).');
-  } else if (existsSync(join(home, '.runtime', '.python-ready'))) {
-    console.log('Runtime Python já provisionado — nada a fazer.');
   } else {
+    migrateLegacyRuntime(home);
+
+    // Versão do Python mudou? Limpa o runtime antigo antes de reinstalar.
+    const specFile = join(home, '.runtime', '.python-spec');
+    const wantSpec = pythonSpec();
+    const haveSpec = existsSync(specFile) ? readFileSync(specFile, 'utf8').trim() : '';
+    if (haveSpec && haveSpec !== wantSpec) {
+      console.log('Versão do Python do runtime mudou — limpando instalação antiga...');
+      rmSync(join(home, '.runtime', 'python'), { recursive: true, force: true });
+      rmSync(join(home, '.runtime', 'venv'), { recursive: true, force: true });
+    }
+
     if (!existsSync(pythonBin(home))) {
       await downloadPython(home, platform);
     } else {
@@ -121,9 +201,21 @@ export async function runInstall({ skipPythonDeps = false } = {}) {
     } else {
       console.log('Virtualenv já presente.');
     }
-    installDeps(home);
+
+    // Dependências: só roda o pip quando o fingerprint muda.
+    const fpFile = join(home, '.runtime', '.deps-fingerprint');
+    const haveFp = existsSync(fpFile) ? readFileSync(fpFile, 'utf8').trim() : '';
+    const wantFp = depsFingerprint();
+    if (haveFp !== wantFp) {
+      installDeps(home);
+      writeFileSync(fpFile, wantFp);
+      console.log('Dependências em dia.');
+    } else {
+      console.log('Dependências já instaladas — nada a fazer.');
+    }
+
+    writeFileSync(specFile, wantSpec);
     writeFileSync(join(home, '.runtime', '.python-ready'), new Date().toISOString());
-    console.log('Dependências instaladas. Runtime Python pronto.');
   }
 
   writeFileSync(join(home, '.runtime', '.ready'), new Date().toISOString());

package/scripts/start.js

@@ -1,8 +1,9 @@
-// Inicia o PandaNews: backend FastAPI (127.0.0.1:8000) + UI (127.0.0.1:3030).
+// 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. Ao final, abre o navegador.
+// 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, ...).
 import { existsSync, readFileSync } from 'node:fs';
 import { spawn } from 'node:child_process';
 import { createServer } from 'node:http';
@@ -10,7 +11,8 @@ 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 UI_PORT = Number(process.env.PANDANEWS_UI_PORT || 3030);
+const UI_PORT_BASE = Number(process.env.PANDANEWS_UI_PORT || 4030);
+const UI_PORT_MAX_TRIES = 20;
 
 function venvBin(home) {
   return process.platform === 'win32'
@@ -43,9 +45,11 @@ function placeholderPage() {
 </html>`;
 }
 
-function serveUi(onReady) {
+let uiServer = null;
+
+function createUiServer() {
   const distDir = join(PKG_ROOT, 'frontend', 'dist');
-  const server = createServer((req, res) => {
+  return createServer((req, res) => {
     const url = req.url.split('?')[0];
     const filePath = join(distDir, url === '/' ? 'index.html' : url.slice(1));
     if (!existsSync(filePath)) {
@@ -56,16 +60,30 @@ function serveUi(onReady) {
     res.writeHead(200, { 'Content-Type': MIME[extname(filePath)] || 'application/octet-stream' });
     res.end(readFileSync(filePath));
   });
-  server.on('error', (err) => {
+}
+
+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}.`);
+    console.error('Encerre algum processo que as ocupe ou defina PANDANEWS_UI_PORT.');
+    process.exit(1);
+  }
+  const server = createUiServer();
+  server.once('error', (err) => {
     if (err && err.code === 'EADDRINUSE') {
-      console.error(`A porta ${UI_PORT} já está em uso. Encerre o processo que a ocupa ou defina PANDANEWS_UI_PORT.`);
+      console.log(`Porta ${port} ocupada — tentando ${port + 1}...`);
+      listenUi(port + 1, attempt + 1);
     } else {
       console.error(`Erro no servidor de UI: ${err && err.message}`);
+      process.exit(1);
     }
-    process.exit(1);
   });
-  server.listen(UI_PORT, '127.0.0.1', onReady);
-  return server;
+  server.listen(port, '127.0.0.1', () => {
+    uiServer = server;
+    console.log(`PandaNews ativo em http://127.0.0.1:${port}`);
+    console.log('Pressione Ctrl+C para encerrar.');
+    openBrowser(`http://127.0.0.1:${port}`);
+  });
 }
 
 async function openBrowser(url) {
@@ -103,14 +121,10 @@ export async function runStart() {
     }
   });
 
-  const server = serveUi(() => {
-    console.log(`PandaNews ativo em http://127.0.0.1:${UI_PORT}`);
-    console.log('Pressione Ctrl+C para encerrar.');
-    openBrowser(`http://127.0.0.1:${UI_PORT}`);
-  });
+  listenUi(UI_PORT_BASE, 1);
 
   process.on('exit', () => {
-    server.close();
+    if (uiServer) uiServer.close();
     uvicorn.kill();
   });
   process.on('SIGINT', () => process.exit(0));