@danhachuel/pandanews 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,16 @@
+# Changelog
+
+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.00 (2026-10-23)
+
+Bootstrap inicial do repositório PandaNews.
+
+- Estrutura base de pastas: `bin/`, `scripts/`, `backend/` (app + core), `frontend/`, `.github/workflows/`
+- `AGENTS.md` com as regras permanentes do projeto (versionamento de dois dígitos, push obrigatório, release via GitHub Actions, CHANGELOG obrigatório, sessões simultâneas)
+- `package.json` com pacote `@danhachuel/pandanews` e binário `pandanews`
+- CLI `pandanews` com comandos `install`, `start` e `build` (instalação estrutural funcional; Python portátil chega na 0.2.00, Fase 4)
+- Workflow `publish-npm.yml`: validação de metadados, smoke test do instalador, publicação com dist-tag `next` via dispatch e promoção a `latest` via tags `vX.Y.ZZ`
+- Correção do passo `Apply requested version`: a etiqueta visual de dois dígitos (ex.: `0.1.00`) é normalizada para semver canônico (ex.: `0.1.0`) antes do `npm version` — o primeiro dispatch falhou com "Version not changed"
+- `README.md`, `LICENSE` (MIT), `.gitignore`, `CHANGELOG.md`
+- Release placeholder no registry npm para criar o pacote `@danhachuel/pandanews`

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DanHachuel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,55 @@
-# Temporary Holding Version
+# PandaNews
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+SaaS **local** (roda no navegador) para criação e automação de múltiplos blogs de notícias com IA.
+
+- Blogs multi-tenant com tema (esporte, política, economia, tecnologia, geral) e recorte regional
+- Coleta de feeds RSS → redação via LLM com fallback **NVIDIA NIM → Google Gemini**
+- Imagens fotojornalísticas via Gemini Image
+- Fluxo editorial: rascunho → revisão humana opcional → aprovado/publicado
+- 100% local por padrão (SQLite + arquivos), com Supabase opcional
+- Agendamento automático por blog (APScheduler)
+
+## Instalação
+
+CMD / MobaXterm:
+
+```
+npx.cmd --yes --prefer-online @danhachuel/pandanews@latest install
+npx.cmd --yes --prefer-online @danhachuel/pandanews@latest
+```
+
+Shell (PowerShell, Linux, macOS):
+
+```
+npx --yes @danhachuel/pandanews@latest install
+npx --yes @danhachuel/pandanews@latest
+```
+
+Requisitos: **Node.js >= 20**. Nenhum Python pré-instalado é necessário — o instalador provisiona um runtime Python portátil na primeira execução (`.runtime/` na raiz do pacote; sobrescreva com a variável de ambiente `PANDANEWS_HOME`).
+
+## Status (versão 0.1.00)
+
+Versão inicial de **bootstrap**: estrutura do repositório, CLI (`pandanews install/start/build`) e workflow de publicação via GitHub Actions. O backend FastAPI e a UI React chegam na **0.2.00** (Fases 1 a 4 do plano de implementação — ver `CHANGELOG.md`).
+
+## Desenvolvimento
+
+```
+# Backend
+pip install -r backend/requirements.txt
+uvicorn backend.app.main:app --reload --port 8000
+
+# Frontend
+cd frontend && npm install && npm run dev
+
+# CLI local
+node bin/cli.js install --skip-python-deps
+node bin/cli.js
+```
+
+## Regras do projeto
+
+Versionamento (PATCH de dois dígitos), release via GitHub Actions, CHANGELOG obrigatório e demais regras permanentes estão em [`AGENTS.md`](AGENTS.md).
+
+## Licença
+
+MIT — veja [LICENSE](LICENSE).

package/backend/app/__init__.py

@@ -0,0 +1 @@
+"""PandaNews — aplicação backend (FastAPI)."""

package/backend/app/main.py

@@ -0,0 +1,13 @@
+"""PandaNews API — FastAPI.
+
+Fase 0 (0.1.00): aplicação mínima com endpoint de health.
+Fase 1: CRUD de blogs, configurações e router de LLM (NVIDIA NIM -> Google Gemini).
+"""
+from fastapi import FastAPI
+
+app = FastAPI(title="PandaNews API", version="0.1.00")
+
+
+@app.get("/api/v1/health")
+def health() -> dict:
+    return {"status": "ok", "service": "pandanews", "version": app.version}

package/backend/app/routers/__init__.py

@@ -0,0 +1 @@
+"""Routers do PandaNews: blogs, noticias, configuracoes, imagens, health (Fase 1+)."""

package/backend/app/schemas.py

@@ -0,0 +1 @@
+"""Schemas Pydantic do PandaNews (preenchidos na Fase 1)."""

package/backend/core/__init__.py

@@ -0,0 +1 @@
+"""Core do PandaNews: config, database, llm_router, image_gen, pipeline."""

package/backend/core/config.py

@@ -0,0 +1 @@
+"""Configuração de runtime do PandaNews (Fase 1): .env, caminhos e constantes."""

package/backend/core/database.py

@@ -0,0 +1,6 @@
+"""Camada de dados do PandaNews (Fase 1).
+
+SQLite local por padrão (data/pandanews.db) via SQLAlchemy 2.0, com detecção
+automática de Supabase quando SUPABASE_URL e SUPABASE_SERVICE_ROLE_KEY estão
+definidas no ambiente. Tabelas: blogs, noticias, configuracoes, logs.
+"""

package/backend/core/image_gen.py

@@ -0,0 +1,6 @@
+"""Geração de imagens do PandaNews (Fase 3).
+
+Gemini Image API com prompt fotojornalístico a partir de palavras-chave da
+notícia; imagens salvas em data/imagens/{noticia_id}.png. Se falhar, a notícia
+segue sem imagem e é sinalizada na UI para ação manual.
+"""

package/backend/core/llm_router.py

@@ -0,0 +1,6 @@
+"""Router de LLM do PandaNews (Fase 1).
+
+Fallback ordenado configurável (padrão: NVIDIA NIM -> Google Gemini) usando
+llmswitch-client: roteamento por prioridade com circuit breaker. Retorna o
+texto gerado e o provedor que respondeu (registrado em noticias.llm_provider).
+"""

package/backend/core/pipeline.py

@@ -0,0 +1,6 @@
+"""Pipeline de notícias do PandaNews (Fase 3).
+
+Coleta RSS -> filtragem por relevância -> rascunho via LLM -> imagem via Gemini
+-> revisão humana opcional -> publicação. Disparado por APScheduler conforme a
+frequência de cada blog ou manualmente pela interface.
+"""

package/backend/requirements.txt

@@ -0,0 +1,10 @@
+fastapi>=0.115,<1
+uvicorn[standard]>=0.34,<1
+sqlalchemy>=2.0.36,<3
+pydantic>=2.9,<3
+apscheduler>=3.10,<4
+feedparser>=6.0.11,<7
+httpx>=0.27,<1
+python-dotenv>=1.0,<2
+llmswitch-client==0.0.1
+supabase>=2.6,<3

package/bin/cli.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+// PandaNews CLI (@danhachuel/pandanews)
+// Comandos: install | start (padrão) | build | help | version
+import { readFileSync } from 'node:fs';
+import { runInstall } from '../scripts/install.js';
+import { runStart } from '../scripts/start.js';
+import { runBuild } from '../scripts/build.js';
+
+const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+
+const args = process.argv.slice(2);
+const command = args.find((a) => !a.startsWith('--')) || 'start';
+const flags = new Set(args.filter((a) => a.startsWith('--')));
+
+function printHelp() {
+  console.log(`
+PandaNews ${pkg.version} — automação de blogs de notícias com IA
+
+Uso:
+  pandanews install   Prepara o runtime local (estrutura + Python portátil)
+  pandanews           Inicia backend (127.0.0.1:8000) e UI (127.0.0.1:3030)
+  pandanews build     Compila o frontend de desenvolvimento
+
+Opções:
+  --skip-python-deps  Instalação estrutural sem Python (uso em CI)
+  --help              Mostra esta ajuda
+  --version           Mostra a versão
+`);
+}
+
+async function main() {
+  if (flags.has('--help') || command === 'help') {
+    printHelp();
+    return;
+  }
+  if (flags.has('--version') || command === 'version') {
+    console.log(pkg.version);
+    return;
+  }
+  if (command === 'install') {
+    await runInstall({ skipPythonDeps: flags.has('--skip-python-deps') });
+  } else if (command === 'start') {
+    await runStart();
+  } else if (command === 'build') {
+    await runBuild();
+  } else {
+    console.error(`Comando desconhecido: ${command}`);
+    printHelp();
+    process.exitCode = 1;
+  }
+}
+
+main().catch((err) => {
+  console.error(`pandanews: ${err && err.message ? err.message : err}`);
+  process.exitCode = 1;
+});

package/frontend/README.md

@@ -0,0 +1,8 @@
+# frontend/
+
+UI do PandaNews (React + Vite + Tailwind), inicializada na Fase 2 do plano de implementação.
+
+- 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

package/package.json

@@ -1,6 +1,49 @@
 {
   "name": "@danhachuel/pandanews",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.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",
+  "bin": {
+    "pandanews": "bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "scripts/",
+    "backend/",
+    "frontend/dist/",
+    "CHANGELOG.md",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build:frontend": "node scripts/build.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DanHachuel/PandaNews.git"
+  },
+  "bugs": {
+    "url": "https://github.com/DanHachuel/PandaNews/issues"
+  },
+  "homepage": "https://github.com/DanHachuel/PandaNews#readme",
+  "keywords": [
+    "news",
+    "blog",
+    "ai",
+    "automation",
+    "rss",
+    "llm"
+  ],
+  "author": "DanHachuel",
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "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/build.js

@@ -0,0 +1,25 @@
+// 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 { join } from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+const PKG_ROOT = join(__dirname, '..');
+
+export async function runBuild() {
+  const frontendDir = join(PKG_ROOT, 'frontend');
+  if (!existsSync(join(frontendDir, 'package.json'))) {
+    console.log('frontend/ ainda não foi inicializado — chega na Fase 2 (versão 0.2.00).');
+    return;
+  }
+  const npmCmd = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+  console.log('Instalando dependências do frontend...');
+  const install = spawnSync(npmCmd, ['install'], { cwd: frontendDir, stdio: 'inherit' });
+  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' });
+  if (build.status !== 0) throw new Error('Falha ao compilar o frontend.');
+  console.log('Frontend compilado em frontend/dist.');
+}

package/scripts/install.js

@@ -0,0 +1,57 @@
+// Instalador do runtime PandaNews.
+//
+// Fase 0 (0.1.00): detecta plataforma, cria a estrutura de pastas (data/, .runtime/)
+// e grava o marcador .runtime/.ready. O provisionamento completo de Python
+// portátil + venv + dependências chega na versão 0.2.00 (Fase 4 do plano).
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+export const PKG_ROOT = join(__dirname, '..');
+
+// Raiz de instalação: PANDANEWS_HOME sobrepõe o padrão (raiz do pacote instalado).
+export function resolveHome() {
+  return process.env.PANDANEWS_HOME ? resolve(process.env.PANDANEWS_HOME) : PKG_ROOT;
+}
+
+// Detecta plataforma e arquitetura para o download de python-build-standalone (Fase 4).
+export function detectPlatform() {
+  const arch = process.arch === 'arm64' ? 'aarch64' : 'x86_64';
+  if (process.platform === 'win32') {
+    return { os: 'windows', arch, asset: `${arch}-pc-windows-msvc-shared-install_only.zip` };
+  }
+  if (process.platform === 'darwin') {
+    return { os: 'macos', arch, asset: `${arch}-apple-darwin-install_only.tar.gz` };
+  }
+  return { os: 'linux', arch, asset: `${arch}-unknown-linux-gnu-install_only.tar.gz` };
+}
+
+export async function runInstall({ skipPythonDeps = false } = {}) {
+  const home = resolveHome();
+  const platform = detectPlatform();
+
+  console.log(`PandaNews install — plataforma: ${platform.os} (${platform.arch})`);
+  console.log(`Raiz do runtime: ${home}`);
+
+  // Estrutura de pastas do runtime local
+  const dirs = [
+    join(home, 'data'),
+    join(home, 'data', 'imagens'),
+    join(home, '.runtime'),
+  ];
+  for (const dir of dirs) {
+    mkdirSync(dir, { recursive: true });
+  }
+
+  // Fase 4 (0.2.00): download de Python 3.12 portátil, venv e requirements.
+  if (skipPythonDeps) {
+    console.log('--skip-python-deps: instalação estrutural (uso em CI).');
+  } else {
+    console.log('Provisionamento de Python portátil e dependências: chega na versão 0.2.00 (Fase 4).');
+  }
+
+  writeFileSync(join(home, '.runtime', '.ready'), new Date().toISOString());
+  console.log('Estrutura pronta. Runtime inicializado.');
+  return home;
+}

package/scripts/start.js

@@ -0,0 +1,23 @@
+// Inicia o PandaNews: backend FastAPI (127.0.0.1:8000) + UI estática (127.0.0.1:3030).
+//
+// Fase 0 (0.1.00): garante que o runtime esteja instalado e informa o status.
+// Fase 4 (0.2.00): sobe o uvicorn, serve frontend/dist e abre o navegador.
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { resolveHome, runInstall } from './install.js';
+
+export async function runStart() {
+  const home = resolveHome();
+  const readyMarker = join(home, '.runtime', '.ready');
+
+  if (!existsSync(readyMarker)) {
+    console.log('Runtime não encontrado — executando install...');
+    await runInstall({});
+  }
+
+  console.log('');
+  console.log('PandaNews 0.1.00 — versão inicial de bootstrap.');
+  console.log('O backend FastAPI (127.0.0.1:8000) e a UI (127.0.0.1:3030) serão');
+  console.log('servidos por este comando a partir da versão 0.2.00 (Fases 1 a 4 do plano).');
+  console.log(`Raiz do runtime: ${home}`);
+}