parche-cli 0.1.1 → 0.5.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "parche-cli",
-  "version": "0.1.1",
+  "version": "0.5.1",
   "description": "Dependabot para APIs: detecta cambios de APIs de terceros en tu código y abre el PR con el arreglo.",
   "keywords": [
     "api",
@@ -29,7 +29,9 @@
     "bin",
     "src",
     "packs",
-    "templates"
+    "data",
+    "templates",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "test": "node --test test/*.test.js",
@@ -40,6 +42,8 @@
   },
   "dependencies": {
     "@babel/parser": "^7.28.0",
-    "jscodeshift": "^17.3.0"
+    "jscodeshift": "^17.3.0",
+    "php-parser": "^3.7.0",
+    "typescript": "~6.0.3"
   }
 }

package/packs/ai.model-retirements.json

@@ -1,38 +1,90 @@
 {
   "id": "ai.model-retirements",
-  "version": "2026.10.15",
+  "version": "2026.10.16",
   "provider": "Modelos de IA",
   "title": "Modelos y endpoints de IA retirados o por retirarse",
   "kind": "retirement",
   "severity": "high",
   "deadline": null,
-  "last_verified": "2026-10-15",
+  "last_verified": "2026-10-16",
   "summary_es": "Tu código usa modelos o APIs de IA que ya no responden o tienen fecha de retiro.",
-  "why_es": "Los proveedores de modelos retiran IDs de modelo y endpoints con algunas semanas o meses de aviso. Después de la fecha, las llamadas fallan. Parche no reemplaza el modelo automáticamente porque cambiar de modelo cambia el comportamiento: te avisa y te dice a qué migrar.",
+  "why_es": "Los proveedores de modelos retiran IDs de modelo y endpoints con algunas semanas o meses de aviso. Después de la fecha, las llamadas fallan. Parche no reemplaza el modelo automáticamente porque cambiar de modelo cambia el comportamiento: te avisa, te dice la fecha y el reemplazo que recomienda el proveedor.",
   "sources": [
     { "title": "Anthropic: Model deprecations", "url": "https://platform.claude.com/docs/en/about-claude/model-deprecations" },
-    { "title": "OpenAI Assistants API: cierre el 26/08/2026", "url": "https://dev.to/mr_manushukla/openai-assistants-api-shuts-down-26-august-2026-a-3-week-migration-sprint-plan-596b" }
+    { "title": "OpenAI: Deprecations", "url": "https://developers.openai.com/api/docs/deprecations" }
   ],
   "detect": {
     "packages": ["@anthropic-ai/sdk", "openai"],
     "retired_models": {
-      "claude-3-opus-20240229": "2026-01-05",
-      "claude-3-7-sonnet-20250219": "2026-02-19",
-      "claude-3-5-haiku-20241022": "2026-02-19",
-      "claude-3-haiku-20240307": "2026-04-20",
-      "claude-sonnet-4-20250514": "2026-06-15",
-      "claude-opus-4-20250514": "2026-06-15",
-      "claude-opus-4-1-20250805": "2026-08-05"
+      "claude-sonnet-4-5-20250929": { "date": "2026-11-30", "replacement": "claude-sonnet-5-5" },
+      "claude-opus-4-1-20250805": { "date": "2026-08-05", "replacement": "claude-opus-4-8" },
+      "claude-sonnet-4-20250514": { "date": "2026-06-15", "replacement": "claude-sonnet-5-5" },
+      "claude-opus-4-20250514": { "date": "2026-06-15", "replacement": "claude-opus-4-8" },
+      "claude-3-haiku-20240307": { "date": "2026-04-20", "replacement": "claude-haiku-4-5-20251001" },
+      "claude-3-7-sonnet-20250219": { "date": "2026-02-19", "replacement": "claude-sonnet-5-5" },
+      "claude-3-5-haiku-20241022": { "date": "2026-02-19", "replacement": "claude-haiku-4-5-20251001" },
+      "claude-3-opus-20240229": { "date": "2026-01-05", "replacement": "claude-opus-4-8" },
+      "claude-3-5-sonnet-20241022": { "date": "2025-10-28", "replacement": "claude-sonnet-5-5" },
+      "claude-3-5-sonnet-20240620": { "date": "2025-10-28", "replacement": "claude-sonnet-5-5" },
+      "claude-3-sonnet-20240229": { "date": "2025-07-21", "replacement": "claude-sonnet-5-5" },
+      "claude-2.1": { "date": "2025-07-21", "replacement": "claude-opus-4-8" },
+      "claude-2.0": { "date": "2025-07-21", "replacement": "claude-opus-4-8" },
+      "claude-instant-1.2": { "date": "2024-11-06", "replacement": "claude-haiku-4-5-20251001" },
+      "claude-instant-1.1": { "date": "2024-11-06", "replacement": "claude-haiku-4-5-20251001" },
+      "claude-instant-1.0": { "date": "2024-11-06", "replacement": "claude-haiku-4-5-20251001" },
+      "claude-1.3": { "date": "2024-11-06", "replacement": "claude-haiku-4-5-20251001" },
+      "claude-1.2": { "date": "2024-11-06", "replacement": "claude-haiku-4-5-20251001" },
+      "claude-1.1": { "date": "2024-11-06", "replacement": "claude-haiku-4-5-20251001" },
+      "claude-1.0": { "date": "2024-11-06", "replacement": "claude-haiku-4-5-20251001" },
+
+      "gpt-5-2025-08-07": { "date": "2026-12-11", "replacement": "gpt-5.6-sol" },
+      "gpt-5-mini-2025-08-07": { "date": "2026-12-11", "replacement": "gpt-5.6-terra" },
+      "gpt-5-nano-2025-08-07": { "date": "2026-12-11", "replacement": "gpt-5.6-luna" },
+      "gpt-5-pro-2025-10-06": { "date": "2026-12-11", "replacement": "gpt-5.6-sol (reasoning.mode: pro)" },
+      "o3-2025-04-16": { "date": "2026-12-11", "replacement": "gpt-5.6-sol" },
+      "o3-pro-2025-06-10": { "date": "2026-12-11", "replacement": "gpt-5.6-sol (reasoning.mode: pro)" },
+      "gpt-3.5-turbo": { "date": "2026-10-23", "replacement": "gpt-5.6-terra" },
+      "gpt-3.5-turbo-0125": { "date": "2026-10-23", "replacement": "gpt-5.6-terra" },
+      "gpt-4": { "date": "2026-10-23", "replacement": "gpt-5.6-sol" },
+      "gpt-4-0613": { "date": "2026-10-23", "replacement": "gpt-5.6-sol" },
+      "gpt-4-1106-preview": { "date": "2026-10-23", "replacement": "gpt-5.6-sol" },
+      "gpt-4-turbo": { "date": "2026-10-23", "replacement": "gpt-5.6-sol" },
+      "gpt-4-turbo-2024-04-09": { "date": "2026-10-23", "replacement": "gpt-5.6-sol" },
+      "gpt-4.1-nano": { "date": "2026-10-23", "replacement": "gpt-5.6-luna" },
+      "gpt-4.1-nano-2025-04-14": { "date": "2026-10-23", "replacement": "gpt-5.6-luna" },
+      "gpt-4o-2024-05-13": { "date": "2026-10-23", "replacement": "gpt-5.6-sol" },
+      "gpt-image-1": { "date": "2026-10-23", "replacement": "gpt-image-2.5-sunburst o gpt-image-2.5-flare" },
+      "o1": { "date": "2026-10-23", "replacement": "gpt-5.6-sol" },
+      "o1-2024-12-17": { "date": "2026-10-23", "replacement": "gpt-5.6-sol" },
+      "o1-pro": { "date": "2026-10-23", "replacement": "gpt-5.6-sol (reasoning.mode: pro)" },
+      "o1-pro-2025-03-19": { "date": "2026-10-23", "replacement": "gpt-5.6-sol (reasoning.mode: pro)" },
+      "o3-mini": { "date": "2026-10-23", "replacement": "gpt-5.6-sol" },
+      "o3-mini-2025-01-31": { "date": "2026-10-23", "replacement": "gpt-5.6-sol" },
+      "o4-mini": { "date": "2026-10-23", "replacement": "gpt-5.6-terra" },
+      "o4-mini-2025-04-16": { "date": "2026-10-23", "replacement": "gpt-5.6-terra" },
+      "gpt-3.5-turbo-instruct": { "date": "2026-09-28", "replacement": "gpt-5.6-terra" },
+      "gpt-3.5-turbo-1106": { "date": "2026-09-28", "replacement": "gpt-5.6-terra" },
+      "babbage-002": { "date": "2026-09-28", "replacement": "gpt-5.6-terra" },
+      "davinci-002": { "date": "2026-09-28", "replacement": "gpt-5.6-terra" },
+      "dall-e-3": { "date": "2026-05-12", "replacement": "gpt-image-2, gpt-image-1 o gpt-image-1-mini" },
+      "dall-e-2": { "date": "2026-05-12", "replacement": "gpt-image-2, gpt-image-1 o gpt-image-1-mini" },
+      "gpt-4o-realtime-preview": { "date": "2026-05-07", "replacement": "gpt-realtime-1.5" },
+      "gpt-4o-realtime-preview-2025-06-03": { "date": "2026-05-07", "replacement": "gpt-realtime-1.5" },
+      "gpt-4o-realtime-preview-2024-12-17": { "date": "2026-05-07", "replacement": "gpt-realtime-1.5" },
+      "gpt-4-0314": { "date": "2026-03-26", "replacement": "gpt-5 o gpt-4.1" },
+      "gpt-4-0125-preview": { "date": "2026-03-26", "replacement": "gpt-5 o gpt-4.1" },
+      "gpt-4-turbo-preview": { "date": "2026-03-26", "replacement": "gpt-5 o gpt-4.1" },
+      "chatgpt-4o-latest": { "date": "2026-02-17", "replacement": "gpt-5.1-chat-latest" },
+      "codex-mini-latest": { "date": "2026-02-12", "replacement": "gpt-5-codex-mini" }
     },
     "retirement_floors": {
-      "claude-sonnet-4-5-20250929": "2026-09-29",
       "claude-haiku-4-5-20251001": "2026-10-15",
       "claude-opus-4-5-20251101": "2026-11-24"
     },
     "retired_endpoints": [
-      { "pattern": ".beta.assistants", "retired": "2026-08-26", "replacement_es": "Responses API + Conversations API" },
-      { "pattern": ".beta.threads", "retired": "2026-08-26", "replacement_es": "Responses API + Conversations API" },
-      { "pattern": "/v1/assistants", "retired": "2026-08-26", "replacement_es": "Responses API + Conversations API" }
+      { "pattern": ".beta.assistants", "retired": "2026-08-26", "replacement_es": "Responses API + Conversations API", "provider": "openai" },
+      { "pattern": ".beta.threads", "retired": "2026-08-26", "replacement_es": "Responses API + Conversations API", "provider": "openai" },
+      { "pattern": "/v1/assistants", "retired": "2026-08-26", "replacement_es": "Responses API + Conversations API", "provider": "openai" }
     ]
   },
   "codemod": null,

package/packs/arca.wsfe.condicion-iva-receptor.json

@@ -1,22 +1,24 @@
 {
   "id": "arca.wsfe.condicion-iva-receptor",
-  "version": "2026.10.15",
+  "version": "2026.10.16",
   "provider": "ARCA (ex AFIP)",
   "title": "Condición frente al IVA del receptor obligatoria en WSFEv1",
   "kind": "breaking",
   "severity": "critical",
   "deadline": "2026-12-01",
-  "last_verified": "2026-10-15",
+  "last_verified": "2026-10-16",
   "summary_es": "Desde el 1/12/2026 ARCA rechaza automáticamente las solicitudes de CAE que no informen CondicionIVAReceptorId.",
   "why_es": "La RG 5616/2024 hizo obligatorio informar la condición frente al IVA del receptor en cada comprobante electrónico. El manual del desarrollador de WSFEv1 (v4.8) fija el 1 de diciembre de 2026 como fecha desde la cual el campo es obligatorio: si viaja vacío, nulo o no viaja, el pedido de CAE se rechaza y no se puede facturar.",
   "sources": [
     { "title": "VATupdate: Argentina makes recipient VAT status mandatory (WSFEv1 v4.8)", "url": "https://www.vatupdate.com/2026/09/09/argentina-makes-recipient-vat-status-mandatory-in-electronic-invoices/" },
     { "title": "iProfesional: ARCA rechazará facturas sin la condición del cliente frente al IVA", "url": "https://www.iprofesional.com/impuestos/464104-nuevo-requisito-arca-puede-trabar-emision-facturas" },
-    { "title": "Tabla de códigos de FEParamGetCondicionIvaReceptor", "url": "https://app.spomsolutions.com/blog/condicion-iva-receptor-rg-5616" }
+    { "title": "Tabla de códigos de FEParamGetCondicionIvaReceptor", "url": "https://app.spomsolutions.com/blog/condicion-iva-receptor-rg-5616" },
+    { "title": "Afip SDK: factura electrónica (Node y PHP, CreateVoucher / CreateNextVoucher)", "url": "https://docs.afipsdk.com/siguientes-pasos/web-services/factura-electronica" },
+    { "title": "afipsdk/afip.php en Packagist", "url": "https://packagist.org/packages/afipsdk/afip.php" }
   ],
   "detect": {
-    "packages": ["@afipsdk/afip.js", "afip.js"],
-    "calls": ["ElectronicBilling.createVoucher", "ElectronicBilling.createNextVoucher"],
+    "packages": ["@afipsdk/afip.js", "@arcasdk/core", "afip.ts", "ts-afip-ws", "facturajs", "afipsdk/afip.php", "fertandil87/afip.php", "ivanalemunioz/afip.php", "eesnaola/afip.php"],
+    "calls": ["ElectronicBilling.createVoucher", "ElectronicBilling.createNextVoucher", "ElectronicBilling->CreateVoucher", "ElectronicBilling->CreateNextVoucher"],
     "raw_markers": ["FECAESolicitar", "FECAEDetRequest"],
     "field": "CondicionIVAReceptorId"
   },

package/src/ast.js

@@ -1,6 +1,7 @@
 // Utilidades de AST compartidas por todos los codemods.
 import jscodeshift from 'jscodeshift';
 import { parse as babelParse } from '@babel/parser';
+import { parsePhp, isPhp } from './php.js';
 
 export function jFor(file) {
   const parser = /\.ts$/.test(file) ? 'ts' : 'tsx';
@@ -22,6 +23,15 @@ export function eolOf(source) {
   return crlf > lf ? '\r\n' : '\n';
 }
 
+// Aplica inserciones de texto { offset, text } de atrás para adelante, así no se corren los offsets.
+export function applyEdits(source, edits) {
+  let out = source;
+  for (const e of [...edits].sort((a, b) => b.offset - a.offset)) {
+    out = out.slice(0, e.offset) + e.text + out.slice(e.offset);
+  }
+  return out;
+}
+
 // Offset en el texto original de una posición { line, column } de recast.
 // No usar node.start/node.end para editar texto: recast parsea una copia con las líneas unidas
 // por os.EOL y las tabs de la indentación expandidas, así que esos offsets no coinciden con el
@@ -146,7 +156,13 @@ export function resolveBinding(path, name) {
 
 // Chequeo de sintaxis del resultado, usado por verify y por los tests.
 export function parseCheck(source, file) {
-  const plugins = ['jsx'];
+  if (isPhp(file)) {
+    parsePhp(source, file);
+    return true;
+  }
+  // decorators-legacy: NestJS, Angular y TypeORM usan decoradores (@Injectable()); sin el plugin, el chequeo
+  // de sintaxis fallaba y --verify frenaba el PR en esos repos.
+  const plugins = ['jsx', 'decorators-legacy'];
   if (/\.(ts|tsx)$/.test(file)) plugins.push('typescript');
   if (/\.ts$/.test(file)) plugins.splice(plugins.indexOf('jsx'), 1);
   babelParse(source, { sourceType: 'unambiguous', plugins, allowAwaitOutsideFunction: true });
@@ -175,6 +191,10 @@ export function tidy(original, output) {
   let i = 0;
   let k = 0;
   while (k < m) {
+    // Una línea en blanco que también puede emparejarse más adelante se toma como nueva: así lo
+    // insertado con insertAfter queda pegado a la línea anterior (el import nuevo junto a los otros
+    // imports) y la línea en blanco original queda después.
+    if (i < n && a[i] === b[k] && b[k].trim() === '' && dp[i][k + 1] === dp[i][k]) { k++; continue; }
     if (i < n && a[i] === b[k]) { keep.push(b[k]); i++; k++; continue; }
     if (i < n && dp[i + 1][k] >= dp[i][k + 1]) { i++; continue; }
     if (b[k].trim() !== '') keep.push(b[k]); // línea nueva con contenido: se queda

package/src/codemods/arca-rules.js

@@ -0,0 +1,109 @@
+// Reglas del pack arca.wsfe.condicion-iva-receptor, compartidas por los codemods de JS y de PHP:
+// qué se puede inferir sin datos del negocio y con qué mensajes se reporta.
+
+import { isTestFile } from '../paths.js';
+
+export const PACK = 'arca.wsfe.condicion-iva-receptor';
+
+// Prefiltro de los codemods: sin estas palabras no hay nada de ARCA en el archivo y no se parsea
+// (en repos con bundles grandes, parsear todo tardaba minutos y 1,5 GB de RAM).
+export const ARCA_HINT = /electronicbilling|fecaesolicitar|fecaedetrequest/i;
+
+const CLASS = {
+  A: new Set([1, 2, 3, 201, 202, 203]),
+  B: new Set([6, 7, 8, 206, 207, 208]),
+  C: new Set([11, 12, 13, 211, 212, 213]),
+};
+
+export function classOf(cbteTipo) {
+  for (const [k, set] of Object.entries(CLASS)) if (set.has(cbteTipo)) return k;
+  return null;
+}
+
+// docTipo y cbteTipo: números si el valor es un literal, undefined si no se puede saber.
+export function decideCondition({ docTipo, cbteTipo }, pack) {
+  const clase = typeof cbteTipo === 'number' ? classOf(cbteTipo) : null;
+  if (docTipo === 99) {
+    return { status: 'auto', code: 5, comment: ' parche: 5 = Consumidor Final (DocTipo 99, sin identificar)' };
+  }
+  if (docTipo === 96 && (clase === 'B' || clase === 'C')) {
+    return { status: 'needs-review', code: 5, comment: ' parche: inferido Consumidor Final (DNI + comprobante ' + clase + ') — REVISAR' };
+  }
+  const valid = clase ? pack.codes_by_class[clase] : null;
+  return { status: 'needs-input', clase, valid };
+}
+
+export function validCodesText(decision, pack) {
+  return (decision.valid || Object.keys(pack.codes).map(Number))
+    .map((c) => `${c} (${pack.codes[String(c)]})`).join(', ');
+}
+
+export function missingMessage(decision) {
+  return `Falta CondicionIVAReceptorId y no se puede inferir sin saber la condición frente al IVA del cliente${decision.clase ? ` (comprobante clase ${decision.clase})` : ''}.`;
+}
+
+export function appliedMessage(status) {
+  return status === 'auto'
+    ? 'Agregado CondicionIVAReceptorId: 5 (Consumidor Final): el comprobante va a un consumidor sin identificar.'
+    : 'Agregado CondicionIVAReceptorId: 5 por inferencia (DNI + comprobante B/C). Confirmá que el cliente no sea exento ni no alcanzado.';
+}
+
+// "El repo ya usa CondicionIVAReceptorId en otro lado": prefijo para bajar a "revisar" lo que no se pudo leer
+// (en repos ya migrados, el objeto suele salir de un builder que sí pone el campo).
+export function alreadyMigratedPrefix(context) {
+  const f = context?.fieldFiles?.[0];
+  return f ? `El repo ya usa CondicionIVAReceptorId (en \`${f}\`): verificá que este comprobante también lo lleve. ` : null;
+}
+
+// Si el campo puede no llegar a ARCA aunque esté en el código: librería 0.x (WSDL de 2021) o un WSDL viejo
+// en el repo. Verificado en el código de afip.js/afip.php el 16/10/2026 (ver src/context.js).
+export function libraryCaveat(context, ecosystem) {
+  const lib = (context?.arcaLibs || []).find((l) => l.ecosystem === ecosystem && l.travels !== 'si');
+  if (lib) {
+    return `Ojo: con ${lib.name} ${lib.version} el pedido se arma con un WSDL de 2021 que no tiene este campo`
+      + `${lib.travels === 'no' ? '' : ' (en JS falta confirmarlo)'}: para que llegue a ARCA hay que actualizar la librería a 1.x.`;
+  }
+  const wsdl = context?.staleWsdl?.[0];
+  if (wsdl) return `Ojo: el repo tiene un WSDL de WSFEv1 sin este campo (\`${wsdl}\`): si el cliente SOAP lo usa, el campo no viaja hasta actualizarlo.`;
+  return null;
+}
+
+// Integraciones SOAP propias (cualquier lenguaje): solo detección.
+// Con menos ruido que la primera versión (frente B, 16/10): no marca tests, mocks, tipos, copias de la librería
+// ni archivos que solo nombran el método (constantes, reexports); solo los que arman el detalle del comprobante.
+export function soapDetection(source, file, context) {
+  if (!/FECAESolicitar|FECAEDetRequest/.test(source) || /CondicionIVAReceptorId/.test(source)) return null;
+  if (isTestFile(file) || /\.d\.[cm]?ts$/.test(file)) return null;
+  if (/class\s+ElectronicBilling\b/.test(source)) return null; // copia de afip.php/afip.js: la cubren la versión y el WSDL
+  const generated = /(^|\/)Reference\.cs$|Stub\.java$/i.test(file) || /class\s+FECAEDetRequest\b/.test(source);
+  if (!generated && !/\b(DocTipo|CbteDesde|ImpTotal)\b/.test(source)) return null;
+  const line = source.split('\n').findIndex((l) => /FECAESolicitar|FECAEDetRequest/.test(l)) + 1;
+  const base = generated
+    ? 'Cliente SOAP de WSFEv1 generado sin CondicionIVAReceptorId: hay que regenerarlo con el WSDL vigente (y después completar el campo).'
+    : 'Integración SOAP propia con WSFEv1 sin CondicionIVAReceptorId en el FECAEDetRequest. Hay que agregarlo al XML, con la condición frente al IVA del cliente.';
+  const prefix = alreadyMigratedPrefix(context);
+  return {
+    finding: { pack: PACK, file, line, status: prefix ? 'needs-review' : 'needs-input', message: (prefix || '') + base },
+    usage: { provider: 'arca', op: generated ? 'WSFEv1 SOAP (cliente generado)' : 'WSFEv1 SOAP', line },
+  };
+}
+
+// Archivos .wsdl de WSFEv1 sin el campo: si el cliente SOAP arma el pedido con ese esquema
+// (SoapClient en modo WSDL, la librería soap de Node), el campo no viaja aunque esté en el código.
+export function wsdlDetection({ source, file }) {
+  const findings = [];
+  const usages = [];
+  if (/FECAESolicitar|FECAEDetRequest/.test(source) && !source.includes('CondicionIVAReceptorId')) {
+    const line = source.split('\n').findIndex((l) => /FECAEDetRequest/.test(l)) + 1 || 1;
+    findings.push({ pack: PACK, file, line, status: 'needs-input',
+      message: 'WSDL de WSFEv1 sin CondicionIVAReceptorId: si tu cliente SOAP arma el pedido con este archivo, el campo no viaja aunque lo agregues al código. Reemplazalo por el WSDL vigente de WSFEv1.' });
+    usages.push({ provider: 'arca', op: 'WSFEv1 WSDL', line });
+  }
+  return { output: null, findings, usages };
+}
+
+// Lenguajes sin codemod (Python, C#, Java, Go, VB.NET): solo la detección de SOAP propio o cliente generado.
+export function soapOnly({ source, file, context }) {
+  const soap = soapDetection(source, file, context);
+  return { output: null, findings: soap ? [soap.finding] : [], usages: soap ? [soap.usage] : [] };
+}

package/src/codemods/arca-wsfe-condicion-iva-php.js

@@ -0,0 +1,195 @@
+// Pack arca.wsfe.condicion-iva-receptor (PHP: afipsdk/afip.php y sus forks)
+// Mismas reglas que el codemod de JS: agrega CondicionIVAReceptorId a cada
+// $afip->ElectronicBilling->CreateVoucher($data) / CreateNextVoucher($data) cuando se puede inferir
+// sin datos del negocio, y marca el resto para que una persona complete el dato.
+// Edita con inserciones de texto mínimas sobre los offsets exactos de php-parser (ver src/php.js).
+import { eolOf, applyEdits, finding } from '../ast.js';
+import { parsePhp, walkPhp, phpLiteral, phpKey } from '../php.js';
+import {
+  PACK, decideCondition, validCodesText, missingMessage, appliedMessage, soapDetection, ARCA_HINT, libraryCaveat, alreadyMigratedPrefix,
+} from './arca-rules.js';
+import { emptyContext } from '../context.js';
+
+// En PHP los nombres de método no distinguen mayúsculas: createVoucher también es válido.
+// El inventario usa el nombre oficial, así un mismo método no aparece dos veces.
+const VOUCHER_METHODS = new Map([['createvoucher', 'CreateVoucher'], ['createnextvoucher', 'CreateNextVoucher']]);
+// Claves que cambian la decisión: si se tocan fuera del array literal, no se puede inferir.
+const DECISION_KEYS = new Set(['DocTipo', 'CbteTipo', 'DocNro']);
+const FIELD = 'CondicionIVAReceptorId';
+const HINT_TAIL = 'con la condición frente al IVA del cliente.';
+
+const isLookup = (n) => n && (n.kind === 'propertylookup' || n.kind === 'nullsafepropertylookup');
+const identName = (n) => (n && n.kind === 'identifier' ? n.name : null);
+
+// '...->ElectronicBilling->CreateVoucher(...)' → nombre oficial del método; null si no es.
+function voucherMethod(call) {
+  const what = call.what;
+  if (!isLookup(what)) return null;
+  const method = identName(what.offset);
+  if (!method || !VOUCHER_METHODS.has(method.toLowerCase())) return null;
+  if (!isLookup(what.what) || identName(what.what.offset) !== 'ElectronicBilling') return null;
+  return VOUCHER_METHODS.get(method.toLowerCase());
+}
+
+// Asignaciones por scope: $var = ... y $var['Clave'] = ...
+function collect(ast) {
+  const scopes = new Map();
+  const calls = [];
+  const info = (scope) => {
+    if (!scopes.has(scope)) scopes.set(scope, { assigns: new Map(), offsets: new Map() });
+    return scopes.get(scope);
+  };
+  const push = (map, name, value) => map.set(name, [...(map.get(name) || []), value]);
+  walkPhp(ast, (node, scope) => {
+    if (node.kind === 'assign') {
+      const left = node.left;
+      if (left.kind === 'variable' && typeof left.name === 'string') push(info(scope).assigns, left.name, node);
+      else if (left.kind === 'offsetlookup' && left.what && left.what.kind === 'variable' && typeof left.what.name === 'string' && left.offset) {
+        push(info(scope).offsets, left.what.name, { key: phpLiteral(left.offset), node });
+      }
+    }
+    if (node.kind === 'call') {
+      const method = voucherMethod(node);
+      if (method) calls.push({ node, scope, method });
+    }
+  });
+  return { scopes, calls };
+}
+
+// El array con los datos del comprobante: literal en la llamada o $var definida una sola vez,
+// antes de la llamada y en el mismo scope.
+function resolveData(arg, scope, call, scopes) {
+  if (!arg) return { reason: 'la llamada no tiene argumentos' };
+  if (arg.kind === 'array') return { arr: arg };
+  if (arg.kind !== 'variable' || typeof arg.name !== 'string') return { reason: 'no es un array literal ni una variable' };
+  const s = scopes.get(scope) || { assigns: new Map(), offsets: new Map() };
+  const defs = s.assigns.get(arg.name) || [];
+  const v = `$${arg.name}`;
+  if (defs.length === 0) {
+    const isParam = (scope.arguments || []).some((a) => a.kind === 'parameter' && (a.name?.name ?? a.name) === arg.name);
+    if (isParam) return { hint: `Los datos del comprobante llegan en \`${v}\` como parámetro: agregá ${FIELD} donde se arma ese array, ${HINT_TAIL}` };
+    return { reason: `${v} no se define en esta función` };
+  }
+  if (defs.length > 1) return { reason: `${v} se asigna más de una vez` };
+  const def = defs[0];
+  // $data = armarComprobante(...) / $this->builder->armar(...) / Builder::armar(...): decir qué función lo arma.
+  if (def.right.kind === 'call') {
+    const what = def.right.what;
+    const fn = what && (what.kind === 'name' ? what.name : identName(what.offset));
+    if (typeof fn === 'string') return { hint: `Los datos del comprobante los arma \`${fn}()\`: agregá ${FIELD} ahí, ${HINT_TAIL}` };
+  }
+  if (def.operator !== '=' || def.right.kind !== 'array') return { reason: `${v} no es un array literal` };
+  if (def.loc.start.offset > call.loc.start.offset) return { reason: `${v} se define después de la llamada` };
+  const offsets = s.offsets.get(arg.name) || [];
+  if (offsets.some((o) => o.key === FIELD)) return { migrated: true };
+  if (offsets.some((o) => o.key === undefined || DECISION_KEYS.has(o.key))) return { reason: `${v} se completa en varios pasos` };
+  return { arr: def.right };
+}
+
+export default function transform({ source, file, pack, context = emptyContext() }) {
+  const findings = [];
+  const usages = [];
+  if (!ARCA_HINT.test(source)) return { output: null, findings, usages }; // prefiltro (ver el codemod de JS)
+  const caveat = libraryCaveat(context, 'composer');
+  const migrated = alreadyMigratedPrefix(context);
+  let ast;
+  try {
+    ast = parsePhp(source, file);
+  } catch (err) {
+    if (/ElectronicBilling|FECAESolicitar|FECAEDetRequest/.test(source)) {
+      findings.push({ pack: PACK, file, line: err.lineNumber || null, status: 'needs-input',
+        message: `No pude analizar este archivo PHP (${err.message}). Revisá a mano las llamadas a ElectronicBilling.` });
+    }
+    return { output: null, findings, usages };
+  }
+
+  const { scopes, calls } = collect(ast);
+  const edits = [];
+  const edited = new Set(); // el mismo $data en dos llamadas: se inserta una sola vez (ver el codemod de JS)
+  for (const { node: call, scope, method } of calls) {
+    usages.push({ provider: 'arca', op: `ElectronicBilling->${method}`, line: call.loc.start.line });
+    const data = resolveData(call.arguments[0], scope, call, scopes);
+    if (data.migrated) continue;
+    const entries = data.arr ? data.arr.items.filter((it) => it && it.kind === 'entry') : null;
+    if (!entries || entries.some((e) => e.unpack || e.byRef)) {
+      const msg = data.hint || `No pude leer los datos del comprobante (${data.reason || 'el array usa ...$otro o referencias'}). Agregá ${FIELD} a mano, ${HINT_TAIL}`;
+      findings.push(finding(PACK, file, call, migrated ? 'needs-review' : 'needs-input', (migrated || '') + msg));
+      continue;
+    }
+    const byKey = (k) => entries.find((e) => phpKey(e) === k);
+    if (byKey(FIELD) || edited.has(data.arr)) continue; // ya está migrado (o ya lo editamos)
+
+    const d = decideCondition({ docTipo: phpLiteral(byKey('DocTipo')?.value), cbteTipo: phpLiteral(byKey('CbteTipo')?.value) }, pack);
+    if (d.status === 'needs-input') {
+      findings.push(finding(PACK, file, call, 'needs-input', missingMessage(d) + (caveat ? ` ${caveat}` : ''),
+        { suggestion: `'${FIELD}' => <condición del cliente>,  // valores válidos: ${validCodesText(d, pack)}` }));
+      continue;
+    }
+    const anchor = byKey('DocNro') || entries[entries.length - 1];
+    edits.push(...insertAfterEntry(source, entries, anchor, { value: d.code, comment: d.comment }));
+    edited.add(data.arr);
+    // Con afip.php 0.x (WSDL de 2021 sin el campo) el arreglo no alcanza solo: deja de ser "automático".
+    const status = caveat && d.status === 'auto' ? 'needs-review' : d.status;
+    findings.push(finding(PACK, file, call, status, appliedMessage(d.status) + (caveat ? ` ${caveat}` : '')));
+  }
+
+  const soap = soapDetection(source, file, context);
+  if (soap) { findings.push(soap.finding); usages.push(soap.usage); }
+
+  return { output: edits.length ? applyEdits(source, edits) : null, findings, usages };
+}
+
+// Inserta 'CondicionIVAReceptorId' => N después de `anchor`, copiando el estilo del array:
+// comillas de las claves, indentación, alineación de los =>, coma final y fin de línea.
+export function insertAfterEntry(source, entries, anchor, { value, comment }) {
+  const eol = eolOf(source);
+  const keyed = entries.filter((e) => e.key && e.key.kind === 'string');
+  const doubles = keyed.filter((e) => source[e.key.loc.start.offset] === '"').length;
+  const q = doubles > keyed.length / 2 ? '"' : "'";
+  const key = `${q}${FIELD}${q}`;
+
+  const end = anchor.loc.end.offset;
+  let k = end;
+  while (k < source.length && /[ \t]/.test(source[k])) k++;
+  const hasComma = source[k] === ',';
+  const nl = source.indexOf('\n', end);
+  const rest = source.slice(hasComma ? k + 1 : end, nl === -1 ? source.length : nl);
+  const endsLine = nl !== -1 && (rest.trim() === '' || /^\s*(\/\/|#)/.test(rest));
+
+  if (!endsLine) {
+    // Array en una sola línea.
+    return [{ offset: hasComma ? k + 1 : end, text: `${hasComma ? '' : ','} ${key} => ${value} /*${comment} */${hasComma ? ',' : ''}` }];
+  }
+
+  const lineStart = source.lastIndexOf('\n', anchor.loc.start.offset - 1) + 1;
+  const indent = source.slice(lineStart).match(/^[ \t]*/)[0];
+  const { before, after } = arrowSpacing(source, keyed, anchor, key.length);
+  const isLast = anchor === entries[entries.length - 1];
+  const trailing = hasComma || !isLast ? ',' : '';
+  const out = [{ offset: nl + 1, text: `${indent}//${comment}${eol}${indent}${key}${before}=>${after}${value}${trailing}${eol}` }];
+  if (!hasComma) out.push({ offset: end, text: ',' });
+  return out;
+}
+
+// Espacios antes y después del => para la línea nueva. Si las claves del array están alineadas
+// con espacios ('DocTipo'    => 99), se alinea igual; si no, se copia el espaciado del ancla.
+function arrowSpacing(source, keyed, anchor, newKeyLength) {
+  const parts = (e) => {
+    const keyEnd = e.key.loc.end.offset;
+    const arrow = source.indexOf('=>', keyEnd);
+    return {
+      width: arrow - e.key.loc.start.offset,
+      before: source.slice(keyEnd, arrow),
+      after: source.slice(arrow + 2, e.value.loc.start.offset),
+      line: e.loc.start.line,
+    };
+  };
+  const all = keyed.map(parts);
+  const own = anchor.key && anchor.key.kind === 'string' ? parts(anchor) : { before: ' ', after: ' ' };
+  const after = /^[ \t]*$/.test(own.after) && own.after ? own.after : ' ';
+  const multiline = new Set(all.map((p) => p.line)).size === all.length;
+  const aligned = multiline && all.length > 1 && all.every((p) => p.width === all[0].width && /^ +$/.test(p.before))
+    && all.some((p) => p.before.length > 1);
+  if (aligned) return { before: ' '.repeat(Math.max(1, all[0].width - newKeyLength)), after };
+  return { before: /^[ \t]+$/.test(own.before) ? own.before : ' ', after };
+}