@danhachuel/pandanews 0.1.2 → 0.2.0

package/frontend/dist/favicon.svg

@@ -0,0 +1,11 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100">
+  <rect width="100" height="100" rx="20" fill="#0b1220"/>
+  <circle cx="25" cy="28" r="13" fill="#e6edf3"/>
+  <circle cx="75" cy="28" r="13" fill="#e6edf3"/>
+  <circle cx="50" cy="52" r="30" fill="#e6edf3"/>
+  <ellipse cx="37" cy="48" rx="9" ry="11" fill="#0b1220" transform="rotate(-15 37 48)"/>
+  <ellipse cx="63" cy="48" rx="9" ry="11" fill="#0b1220" transform="rotate(15 63 48)"/>
+  <circle cx="38" cy="49" r="3" fill="#22c55e"/>
+  <circle cx="62" cy="49" r="3" fill="#22c55e"/>
+  <ellipse cx="50" cy="62" rx="5" ry="4" fill="#0b1220"/>
+</svg>

package/frontend/dist/index.html

@@ -0,0 +1,17 @@
+<!doctype html>
+<html lang="pt-BR" class="dark">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>PandaNews — Automação de blogs de notícias com IA</title>
+    <link rel="preconnect" href="https://fonts.googleapis.com" />
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+    <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&display=swap" rel="stylesheet" />
+    <script type="module" crossorigin src="/assets/index-D0e-vr7T.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-BaPdaYIz.css">
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danhachuel/pandanews",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "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/build.js

@@ -1,6 +1,6 @@
 // Compila o frontend de desenvolvimento (frontend/ -> frontend/dist).
 // A UI React + Vite + Tailwind é inicializada na Fase 2 do plano.
-import { existsSync } from 'node:fs';
+import { existsSync, realpathSync } from 'node:fs';
 import { join } from 'node:path';
 import { spawnSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
@@ -16,10 +16,19 @@ export async function runBuild() {
   }
   const npmCmd = process.platform === 'win32' ? 'npm.cmd' : 'npm';
   console.log('Instalando dependências do frontend...');
-  const install = spawnSync(npmCmd, ['install'], { cwd: frontendDir, stdio: 'inherit' });
+  // shell: true — obrigatório para .cmd no Windows (Node >= 18)
+  const install = spawnSync(npmCmd, ['install'], { cwd: frontendDir, stdio: 'inherit', shell: true });
   if (install.status !== 0) throw new Error('Falha ao instalar dependências do frontend.');
   console.log('Compilando o frontend...');
-  const build = spawnSync(npmCmd, ['run', 'build'], { cwd: frontendDir, stdio: 'inherit' });
+  const build = spawnSync(npmCmd, ['run', 'build'], { cwd: frontendDir, stdio: 'inherit', shell: true });
   if (build.status !== 0) throw new Error('Falha ao compilar o frontend.');
   console.log('Frontend compilado em frontend/dist.');
 }
+
+// Entry point para execução direta: node scripts/build.js
+if (process.argv[1] && realpathSync(process.argv[1]) === realpathSync(fileURLToPath(import.meta.url))) {
+  runBuild().catch((err) => {
+    console.error(`pandanews build: ${err && err.message}`);
+    process.exitCode = 1;
+  });
+}

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

@@ -4,9 +4,10 @@
 // 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';
 import { spawn } from 'node:child_process';
-import { createServer } from 'node:http';
+import { createServer, request as httpRequest } from 'node:http';
 import { join, extname } from 'node:path';
 import { resolveHome, runInstall, PKG_ROOT } from './install.js';
 
@@ -14,6 +15,8 @@ const BACKEND_PORT = 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 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) {
   return process.platform === 'win32'
     ? join(home, '.runtime', 'venv', 'Scripts', 'python.exe')
@@ -34,27 +37,70 @@ const MIME = {
 function placeholderPage() {
   return `<!DOCTYPE html>
 <html lang="pt-BR">
-<head><meta charset="utf-8"><title>PandaNews</title></head>
+<head>
+<meta charset="utf-8">
+<title>PandaNews</title>
+<link rel="icon" href="${FAVICON_URI}">
+</head>
 <body style="font-family: Inter, system-ui, sans-serif; background: #0b1220; color: #e6edf3; display: flex; min-height: 100vh; align-items: center; justify-content: center;">
   <div style="text-align: center;">
     <h1 style="font-size: 3rem; margin: 0;">🐼 PandaNews</h1>
-    <p style="color: #9aa7b5;">Backend ativo em <a style="color: #22c55e;" href="http://127.0.0.1:8000/api/v1/health">127.0.0.1:8000</a></p>
-    <p style="color: #9aa7b5;">A UI React completa chega na versão 0.2.00 (Fases 1 a 3 do plano).</p>
+    <p style="color: #9aa7b5;">Backend ativo em <a style="color: #22c55e;" href="/api/v1/health">/api/v1/health</a></p>
+    <p style="color: #9aa7b5;">A UI React completa chega na versão 0.2.00.</p>
   </div>
 </body>
 </html>`;
 }
 
+// Encaminha /api/* para o backend FastAPI em 127.0.0.1:8000.
+function proxyApi(req, res) {
+  const options = {
+    hostname: '127.0.0.1',
+    port: BACKEND_PORT,
+    path: req.url,
+    method: req.method,
+    headers: { ...req.headers, host: `127.0.0.1:${BACKEND_PORT}` },
+  };
+  const proxied = httpRequest(options, (upstream) => {
+    res.writeHead(upstream.statusCode || 502, upstream.headers);
+    upstream.pipe(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}` }));
+  });
+  req.pipe(proxied);
+}
+
 let uiServer = null;
 
 function createUiServer() {
   const distDir = join(PKG_ROOT, 'frontend', 'dist');
   return createServer((req, res) => {
+    if (req.url.startsWith('/api')) {
+      proxyApi(req, res);
+      return;
+    }
     const url = req.url.split('?')[0];
     const filePath = join(distDir, url === '/' ? 'index.html' : url.slice(1));
     if (!existsSync(filePath)) {
-      res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
-      res.end(placeholderPage());
+      // SPA (BrowserRouter): rotas sem extensão caem no index.html quando o
+      // build existe; sem build, mostra o placeholder.
+      const indexHtml = join(distDir, 'index.html');
+      const hasBuild = existsSync(indexHtml);
+      const isAsset = extname(url) !== '';
+      if (hasBuild && !isAsset) {
+        res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+        res.end(readFileSync(indexHtml));
+        return;
+      }
+      if (!hasBuild) {
+        res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+        res.end(placeholderPage());
+        return;
+      }
+      res.writeHead(404, { 'Content-Type': 'text/plain; charset=utf-8' });
+      res.end('Not found');
       return;
     }
     res.writeHead(200, { 'Content-Type': MIME[extname(filePath)] || 'application/octet-stream' });
@@ -112,7 +158,11 @@ export async function runStart() {
   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' },
+    {
+      cwd: PKG_ROOT,
+      stdio: 'inherit',
+      env: { ...process.env, PANDANEWS_HOME: home },
+    },
   );
   uvicorn.on('exit', (code) => {
     if (code !== 0 && code !== null) {