@danhachuel/pandanews 0.1.2 → 0.1.3

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.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`)

package/README.md

@@ -32,9 +32,9 @@ 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.02)
+## 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: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`)

package/backend/app/main.py

@@ -7,7 +7,7 @@ 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.2")
+app = FastAPI(title="PandaNews API", version="0.1.3")
 
 app.add_middleware(
     CORSMiddleware,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danhachuel/pandanews",
-  "version": "0.1.2",
+  "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());