parche-cli 0.0.0-stage → 0.1.1

package/src/ledger.js

@@ -0,0 +1,16 @@
+// Registro append-only de eventos. En el producto real esto se sube (anonimizado) y es lo que
+// hace que la base de packs mejore: qué fixes se mergean, cuáles se editan y cuáles se rechazan.
+import fs from 'node:fs';
+import path from 'node:path';
+
+export function record(root, event) {
+  const dir = path.join(root, '.parche');
+  fs.mkdirSync(dir, { recursive: true });
+  fs.appendFileSync(path.join(dir, 'ledger.jsonl'), JSON.stringify({ at: new Date().toISOString(), ...event }) + '\n');
+}
+
+export function read(root) {
+  const f = path.join(root, '.parche', 'ledger.jsonl');
+  if (!fs.existsSync(f)) return [];
+  return fs.readFileSync(f, 'utf8').trim().split('\n').filter(Boolean).map((l) => JSON.parse(l));
+}

package/src/packs.js

@@ -0,0 +1,39 @@
+// Carga de packs (la base de cambios) y el registro de transformaciones.
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import arca from './codemods/arca-wsfe-condicion-iva.js';
+import mercadopago from './codemods/mercadopago-payments-to-orders.js';
+import aiModels from './detectors/ai-model-retirements.js';
+
+const HERE = path.dirname(fileURLToPath(import.meta.url));
+export const PACKS_DIR = path.join(HERE, '..', 'packs');
+
+const TRANSFORMS = {
+  'arca.wsfe.condicion-iva-receptor': arca,
+  'mercadopago.payments-to-orders': mercadopago,
+  'ai.model-retirements': aiModels,
+};
+
+export const REQUIRED_FIELDS = ['id', 'version', 'provider', 'title', 'kind', 'severity', 'deadline', 'last_verified',
+  'summary_es', 'why_es', 'sources', 'detect', 'codemod', 'review_checklist_es'];
+
+export function validatePack(pack) {
+  const missing = REQUIRED_FIELDS.filter((f) => !(f in pack));
+  if (missing.length) throw new Error(`Pack ${pack.id || '?'}: faltan campos ${missing.join(', ')}`);
+  if (!Array.isArray(pack.sources) || pack.sources.some((s) => !s.url)) throw new Error(`Pack ${pack.id}: sources inválidas`);
+  if (!['critical', 'high', 'medium', 'low'].includes(pack.severity)) throw new Error(`Pack ${pack.id}: severity inválida`);
+  return true;
+}
+
+export function loadPacks(dir = PACKS_DIR) {
+  return fs.readdirSync(dir)
+    .filter((f) => f.endsWith('.json'))
+    .map((f) => JSON.parse(fs.readFileSync(path.join(dir, f), 'utf8')))
+    .map((p) => (validatePack(p), p))
+    .sort((a, b) => (a.deadline || '9999').localeCompare(b.deadline || '9999'));
+}
+
+export function transformFor(packId) {
+  return TRANSFORMS[packId] || null;
+}

package/src/report.js

@@ -0,0 +1,91 @@
+// Reporte del scan y cuerpo del PR, en castellano.
+const LABEL = {
+  auto: '✅ automático',
+  'needs-review': '👀 revisar',
+  'needs-input': '✋ falta un dato',
+  blocked: '⛔ bloqueado',
+  'detect-only': '🔎 detectado',
+};
+const SEVERITY = { critical: 'crítica', high: 'alta', medium: 'media', low: 'baja' };
+
+export function daysUntil(date, today = new Date()) {
+  if (!date) return null;
+  const ms = new Date(date + 'T00:00:00-03:00') - today;
+  return Math.ceil(ms / 86400000);
+}
+
+function deadlineText(pack, today) {
+  if (!pack.deadline) return 'sin fecha límite';
+  const d = daysUntil(pack.deadline, today);
+  return d >= 0 ? `${pack.deadline} (faltan ${d} días)` : `${pack.deadline} (vencida hace ${-d} días)`;
+}
+
+export function counts(findings) {
+  const c = {};
+  for (const f of findings) c[f.status] = (c[f.status] || 0) + 1;
+  return c;
+}
+
+export function scanReport({ inventory, findings, packs, changed }, today = new Date()) {
+  const out = [];
+  out.push(`# Parche — reporte de \`${inventory.repo}\``, '');
+  out.push('## APIs que usa este repo', '');
+  const pk = Object.entries(inventory.packages);
+  if (pk.length) out.push(...pk.map(([n, v]) => `- \`${n}\` ${v}`), '');
+  for (const [prov, p] of Object.entries(inventory.providers)) {
+    out.push(`- **${prov}**: ${p.callSites} usos en ${p.files.length} archivo(s) — ${Object.entries(p.ops).map(([o, n]) => `${o} ×${n}`).join(', ')}`);
+  }
+  out.push('');
+  for (const pack of packs) {
+    const fs = findings.filter((f) => f.pack === pack.id);
+    if (!fs.length) continue;
+    out.push(`## ${pack.title}`, '');
+    out.push(`**Proveedor:** ${pack.provider} · **Severidad:** ${SEVERITY[pack.severity]} · **Fecha límite:** ${deadlineText(pack, today)}`, '');
+    out.push(pack.summary_es, '');
+    for (const f of fs) {
+      out.push(`- ${LABEL[f.status]} \`${f.file}${f.line ? `:${f.line}` : ''}\` — ${f.message}`);
+      if (f.suggestion) out.push(`  - Sugerido: \`${f.suggestion}\``);
+    }
+    out.push('');
+  }
+  if (changed && changed.length) {
+    out.push('## Archivos modificados', '', ...changed.map((c) => `- \`${c.file}\` (${c.packs.join(', ')})`), '');
+  }
+  return out.join('\n');
+}
+
+export function prBody({ pack, findings, changed, verification }, today = new Date()) {
+  const fs = findings.filter((f) => f.pack === pack.id);
+  const c = counts(fs);
+  const out = [];
+  out.push(`## ${pack.title}`, '');
+  out.push(`> **${pack.provider}** · severidad ${SEVERITY[pack.severity]} · fecha límite: ${deadlineText(pack, today)}`, '');
+  out.push('### Qué cambió', '', pack.why_es, '');
+  out.push('### Qué hace este PR', '');
+  const applied = fs.filter((f) => f.status === 'auto' || f.status === 'needs-review');
+  out.push(changed.length
+    ? `Modifica ${changed.length} archivo(s): ${changed.map((x) => `\`${x.file}\``).join(', ')}.`
+    : 'No modifica archivos: solo reporta lo que hay que resolver a mano.', '');
+  for (const f of applied) out.push(`- ${LABEL[f.status]} \`${f.file}:${f.line}\` — ${f.message}`);
+  const pending = fs.filter((f) => f.status === 'needs-input' || f.status === 'blocked');
+  if (pending.length) {
+    out.push('', '### Lo que este PR NO resuelve (necesita una persona)', '');
+    for (const f of pending) {
+      out.push(`- ${LABEL[f.status]} \`${f.file}:${f.line}\` — ${f.message}`);
+      if (f.suggestion) out.push(`  - Agregá: \`${f.suggestion}\``);
+    }
+  }
+  out.push('', '### Verificación', '');
+  if (verification) {
+    out.push(`- Sintaxis de los archivos modificados: ${verification.parse.ok ? '✅ OK' : '❌ ' + verification.parse.errors.join('; ')}`);
+    if (verification.tests) out.push(`- Tests del repo (\`npm test\`): ${verification.tests.ok ? '✅ pasan' : verification.tests.skipped ? '— no hay script de test' : '❌ fallan'}`);
+  } else {
+    out.push('- Sin verificar (corré `parche pr --verify`).');
+  }
+  out.push('', '### Checklist antes de mergear', '', ...pack.review_checklist_es.map((x) => `- [ ] ${x}`), '');
+  out.push('### Fuentes', '', ...pack.sources.map((s) => `- [${s.title}](${s.url})`), '');
+  out.push(`<sub>Pack \`${pack.id}\` v${pack.version}, verificado el ${pack.last_verified}. Resumen: ${Object.entries(c).map(([k, v]) => `${LABEL[k]} ${v}`).join(' · ')}. ¿Este PR te sirvió? Mergealo, editalo o cerralo: Parche aprende de cada resultado.</sub>`, '');
+  return out.join('\n');
+}
+
+export { LABEL };

package/src/verify.js

@@ -0,0 +1,31 @@
+// Verificación: ningún PR sale sin que el código modificado parsee y, si se pide, sin que pasen los tests.
+import fs from 'node:fs';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { parseCheck } from './ast.js';
+
+export function verify(root, changedFiles, { runTests = false } = {}) {
+  const errors = [];
+  for (const rel of changedFiles) {
+    try {
+      parseCheck(fs.readFileSync(path.join(root, rel), 'utf8'), rel);
+    } catch (e) {
+      errors.push(`${rel}: ${e.message}`);
+    }
+  }
+  const result = { parse: { ok: errors.length === 0, errors } };
+  if (runTests) {
+    const pkgPath = path.join(root, 'package.json');
+    const pkg = fs.existsSync(pkgPath) ? JSON.parse(fs.readFileSync(pkgPath, 'utf8')) : {};
+    if (!pkg.scripts || !pkg.scripts.test) {
+      result.tests = { ok: true, skipped: true };
+    } else {
+      // En Windows npm es npm.cmd y Node solo lo ejecuta a través de un shell.
+      const r = spawnSync('npm', ['test', '--silent'], { cwd: root, encoding: 'utf8', timeout: 300000, shell: process.platform === 'win32' });
+      const output = (r.stdout || '') + (r.stderr || '') + (r.error ? `\n${r.error.message}` : '');
+      result.tests = { ok: r.status === 0, output: output.slice(-2000) };
+    }
+  }
+  result.ok = result.parse.ok && (!result.tests || result.tests.ok);
+  return result;
+}

package/templates/github-workflow.yml

@@ -0,0 +1,27 @@
+# Copiá este archivo a .github/workflows/parche.yml en tu repo.
+# Cada lunes Parche revisa tu código contra la base de cambios de APIs
+# y abre un PR por cada cambio que te afecta (en borrador si hay algo para revisar).
+name: Parche
+
+on:
+  schedule:
+    - cron: "17 11 * * 1" # lunes 8:17 (hora de Argentina)
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  parche:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-node@v7
+        with:
+          node-version: 24
+      - name: Instalar dependencias del proyecto (para correr sus tests antes de cada PR)
+        run: npm ci
+      - uses: Pepo08/parche@v0