arcli 2.0.0 → 2.2.0

package/dist/ui/presenters/errors.presenter.js

@@ -7,15 +7,17 @@ import { formatZodError } from './errors.zod-presenter.js';
 function formatErrorTitle(code) {
     switch (code) {
         case 'CONFIGURATION_ERROR':
-            return 'Error de configuracion';
+            return 'Error de configuración';
+        case 'CERTIFICATE_EXPIRED':
+            return 'Certificado vencido';
         case 'INPUT_VALIDATION_ERROR':
             return 'Error de entrada';
         case 'BATCH_VALIDATION_ERROR':
-            return 'Lote invalido';
+            return 'Lote inválido';
         case 'BATCH_EMISSION_ERROR':
             return 'Lote interrumpido';
         case 'EMISSION_UNCERTAIN':
-            return 'Emision sin confirmar';
+            return 'Emisión sin confirmar';
         case 'PDF_GENERATION_ERROR':
         case 'PDF_ISSUER_INCOMPLETE':
         case 'PDF_PLUGIN_MISSING':
@@ -32,13 +34,13 @@ function formatErrorHint(error) {
     }
     switch (error.code) {
         case 'CONFIGURATION_ERROR':
-            return 'Revise la configuracion con `arcli config` o corra `arcli config revisar`.';
+            return 'Revisá la configuración con `arcli config` o corré `arcli config revisar`.';
         case 'INPUT_VALIDATION_ERROR':
-            return 'Revise los parametros del comando con `ayuda` e intente nuevamente.';
+            return 'Revisá los parámetros del comando con `ayuda` e intentá nuevamente.';
         case 'BATCH_VALIDATION_ERROR':
-            return 'Corrija esos comprobantes en el archivo y vuelva a correr el lote completo.';
+            return 'Corregí esos comprobantes en el archivo y volvé a correr el lote completo.';
         case 'BATCH_EMISSION_ERROR':
-            return 'Los comprobantes de arriba ya se emitieron: no los vuelva a cargar. Antes de reintentar el que fallo, verifique con `arcli ultimos` si se emitio; despues reintente los que quedaron sin procesar.';
+            return 'Los comprobantes de arriba ya se emitieron: no los volvé a cargar. Antes de reintentar el que fallo, verificá con `arcli ultimos` si se emitió; después reintentá los que quedaron sin procesar.';
         default:
             return null;
     }
@@ -46,13 +48,13 @@ function formatErrorHint(error) {
 function detectTransientError(message) {
     if (message.includes('coe.alreadyAuthenticated')) {
         return {
-            sugerencia: 'WSAA informo que ya existe un TA valido para este servicio. Espere unos segundos y vuelva a intentar sin cambiar el payload.',
+            sugerencia: 'WSAA informo que ya existe un TA válido para este servicio. Esperá unos segundos y volvé a intentar sin cambiar el payload.',
             title: 'Error transitorio WSAA',
         };
     }
     if (message.includes('Transacción Activa')) {
         return {
-            sugerencia: 'ARCA devolvio una transaccion activa. Espere unos segundos y reintente la emision antes de modificar datos del comprobante.',
+            sugerencia: 'ARCA devolvió una transacción activa. Esperá unos segundos y reintentá la emisión antes de modificar datos del comprobante.',
             title: 'Error transitorio ARCA',
         };
     }
@@ -89,7 +91,8 @@ export function formatCliError(error, useJson) {
                 codigo: error.code,
                 detalles: formatErrorDetailsAsJson(error.details),
                 error: error.message,
-                ...(error.suggestion ? { sugerencia: error.suggestion } : {}),
+                // Siempre presente: `null` cuando no hay que sugerir, igual que en los errores inesperados.
+                sugerencia: error.suggestion ?? null,
             });
         }
         const details = formatErrorDetails(error.details);
@@ -106,6 +109,5 @@ export function formatCliError(error, useJson) {
             sugerencia: transientError?.sugerencia ?? null,
         });
     }
-    return errorPanel(transientError?.title ?? 'Error inesperado', message, [], transientError?.sugerencia ?? 'Si el problema persiste, revise la configuracion o reintente con mas contexto.');
+    return errorPanel(transientError?.title ?? 'Error inesperado', message, [], transientError?.sugerencia ?? 'Si el problema persiste, revisá la configuración o reintentá con más contexto.');
 }
-//# sourceMappingURL=errors.presenter.js.map

package/dist/ui/presenters/errors.zod-presenter.js

@@ -1,8 +1,9 @@
+import { BILLING_JSON_KEY_BY_INTERNAL_KEY } from '../../modules/billing/billing.json-input.js';
 import { errorPanel } from '../components/errorPanel.js';
 import { renderJson } from '../primitives/renderJson.js';
 import { bold } from '../primitives/text.js';
 const ZOD_PATH_LABELS = {
-    associatedPeriod: 'periodo asociado',
+    associatedPeriod: 'período asociado',
     associatedVoucher: 'comprobante asociado',
     billingDate: 'fecha del comprobante',
     cancellation: 'anulacion',
@@ -10,12 +11,12 @@ const ZOD_PATH_LABELS = {
     cbuAlias: 'alias del CBU',
     concept: 'concepto',
     currencyCode: 'moneda',
-    documentNumber: 'numero de documento',
+    documentNumber: 'número de documento',
     documentType: 'tipo de documento',
-    dueDay: 'dia de vencimiento',
+    dueDay: 'día de vencimiento',
     exchangeRate: 'cotizacion',
     exemptAmount: 'importe exento',
-    ivaRate: 'alicuota de IVA',
+    ivaRate: 'alícuota de IVA',
     ivaCondition: 'IVA receptor',
     paymentDueDate: 'vencimiento de pago',
     pointOfSale: 'punto de venta',
@@ -26,31 +27,6 @@ const ZOD_PATH_LABELS = {
     transferMode: 'modalidad de transferencia',
     untaxedAmount: 'importe no gravado',
 };
-const ZOD_PUBLIC_PATHS = {
-    associatedPeriod: ['periodoAsociado'],
-    associatedVoucher: ['comprobanteAsociado'],
-    billingDate: ['fechaComprobante'],
-    cancellation: ['anulacion'],
-    cbu: ['cbu'],
-    cbuAlias: ['aliasCbu'],
-    concept: ['concepto'],
-    currencyCode: ['codigoMoneda'],
-    documentNumber: ['numeroDocumento'],
-    documentType: ['tipoDocumento'],
-    dueDay: ['dia'],
-    exchangeRate: ['cotizacionMoneda'],
-    exemptAmount: ['importeExento'],
-    ivaRate: ['alicuotaIva'],
-    ivaCondition: ['ivaReceptor'],
-    paymentDueDate: ['vencimientoPago'],
-    pointOfSale: ['puntoVenta'],
-    sameCurrency: ['mismaMoneda'],
-    serviceEndDate: ['servicioHasta'],
-    serviceStartDate: ['servicioDesde'],
-    totalAmount: ['montoTotal'],
-    transferMode: ['transferencia'],
-    untaxedAmount: ['importeNoGravado'],
-};
 function formatZodIssuePath(path) {
     if (path.length === 0) {
         return 'Entrada';
@@ -71,16 +47,18 @@ function humanizeZodIssue(issue) {
     }
     if (issue.code === 'invalid_value') {
         const allowedValues = issue.values.map((value) => String(value)).join(', ');
-        return `${label[0]?.toUpperCase() ?? ''}${label.slice(1)} tiene un valor no soportado. Valores validos: ${allowedValues}.`;
+        return `${label[0]?.toUpperCase() ?? ''}${label.slice(1)} tiene un valor no soportado. Valores válidos: ${allowedValues}.`;
     }
     if (issue.code === 'invalid_type') {
-        return `${label[0]?.toUpperCase() ?? ''}${label.slice(1)} tiene un formato invalido.`;
+        return `${label[0]?.toUpperCase() ?? ''}${label.slice(1)} tiene un formato inválido.`;
     }
     return issue.message;
 }
 function formatPublicIssuePath(path) {
     const pathKey = formatZodIssuePath(path);
-    return ZOD_PUBLIC_PATHS[pathKey] ?? path.map((segment) => String(segment));
+    // La clave del JSON sale del esquema de `--cargar`, la misma que se documenta.
+    const publicKey = BILLING_JSON_KEY_BY_INTERNAL_KEY[pathKey];
+    return publicKey ? [publicKey] : path.map((segment) => String(segment));
 }
 /** Resumen de una linea, para listar errores por item (por ejemplo, en un lote). */
 export function summarizeZodError(error) {
@@ -94,7 +72,8 @@ export function formatZodError(error, useJson) {
                 mensaje: humanizeZodIssue(issue),
                 ruta: formatPublicIssuePath(issue.path),
             })),
-            error: 'Hay parametros invalidos o incompletos en la entrada.',
+            error: 'Hay parámetros inválidos o incompletos en la entrada.',
+            sugerencia: null,
         });
     }
     const detailLines = error.issues.map((issue) => {
@@ -102,6 +81,5 @@ export function formatZodError(error, useJson) {
         const label = ZOD_PATH_LABELS[pathKey] ?? pathKey;
         return `${bold(`${label}:`)} ${humanizeZodIssue(issue)}`;
     });
-    return errorPanel('Error de entrada', 'Hay parametros invalidos o incompletos en la entrada.', detailLines, 'Revise los parametros del comando con `ayuda` e intente nuevamente.');
+    return errorPanel('Error de entrada', 'Hay parámetros inválidos o incompletos en la entrada.', detailLines, 'Revisá los parámetros del comando con `ayuda` e intentá nuevamente.');
 }
-//# sourceMappingURL=errors.zod-presenter.js.map

package/dist/ui/presenters/export.presenter.js

@@ -0,0 +1 @@
+export { formatExportResultAsJson, formatExportResultAsText } from '../../modules/export/export.presenter.js';

package/dist/ui/presenters/index.js

@@ -2,6 +2,6 @@ export * from './billing.presenter.js';
 export * from './config.presenter.js';
 export * from './errors.presenter.js';
 export { summarizeZodError } from './errors.zod-presenter.js';
+export * from './export.presenter.js';
 export * from './pdf.presenter.js';
 export * from './showcase.presenter.js';
-//# sourceMappingURL=index.js.map

package/dist/ui/presenters/pdf.presenter.js

@@ -33,7 +33,7 @@ export function formatPdfPluginStatusAsJson(status) {
 export function formatPdfPluginStatusAsText(status, title = 'Plugin de PDF') {
     const rows = [
         ['Estado', status.installed ? 'instalado' : 'no instalado'],
-        ['Version', status.installedVersion ?? `no instalada (arcli usa la ${status.version})`],
+        ['Versión', status.installedVersion ?? `no instalada (arcli usa la ${status.version})`],
         [
             'Navegador',
             status.browser ? `${status.browser} (${BROWSER_SOURCE_LABELS[status.browserSource ?? 'sistema']})` : 'ninguno',
@@ -43,4 +43,3 @@ export function formatPdfPluginStatusAsText(status, title = 'Plugin de PDF') {
     const footer = status.installed ? 'Listo para generar PDFs' : 'Instalelo con `arcli pdf instalar`';
     return keyValuePanel(title, renderKeyValueRows(rows, { labelWidth: resolveKeyValueLabelWidth('standard', rows, [25, 75]) }), footer, 'standard', status.installed ? 'success' : 'warning', 'sheet');
 }
-//# sourceMappingURL=pdf.presenter.js.map

package/dist/ui/presenters/showcase.presenter.js

@@ -1,2 +1 @@
 export { renderStorybookShowcase } from '../../modules/storybook/showcase.js';
-//# sourceMappingURL=showcase.presenter.js.map

package/dist/ui/primitives/index.js

@@ -8,4 +8,3 @@ export * from './renderPanel.js';
 export * from './renderSubtitle.js';
 export * from './renderTable.js';
 export * from './text.js';
-//# sourceMappingURL=index.js.map

package/dist/ui/primitives/renderDivider.js

@@ -2,4 +2,3 @@ import { centerText } from './text.js';
 export function renderDivider(props) {
     return centerText((props.character ?? '═').repeat(props.width), props.width);
 }
-//# sourceMappingURL=renderDivider.js.map

package/dist/ui/primitives/renderFooter.js

@@ -3,4 +3,3 @@ export function renderFooter(props) {
     const color = props.textColor ?? 'neutral';
     return centerText(colorize(props.text, color), props.width);
 }
-//# sourceMappingURL=renderFooter.js.map

package/dist/ui/primitives/renderJson.js

@@ -16,4 +16,3 @@ export function highlightJsonValues(content, target = 'stdout') {
         return colorize(token, 'warning', target);
     });
 }
-//# sourceMappingURL=renderJson.js.map

package/dist/ui/primitives/renderKeyValue.js

@@ -31,4 +31,3 @@ export function renderKeyValueRows(rows, options = {}) {
     const labelWidth = options.labelWidth ?? widestLabel;
     return rows.map(([label, value]) => renderKeyValue(label, value, { ...options, labelWidth }));
 }
-//# sourceMappingURL=renderKeyValue.js.map

package/dist/ui/primitives/renderLogo.js

@@ -47,4 +47,3 @@ export function renderLogo(version) {
     const indent = logoIndent();
     return `\n\n${[...logo, renderLogoFooter(version)].map((line) => `${indent}${line}`).join('\n')}\n\n`;
 }
-//# sourceMappingURL=renderLogo.js.map

package/dist/ui/primitives/renderObject.js

@@ -16,4 +16,3 @@ export function renderObject(value) {
         });
     }
 }
-//# sourceMappingURL=renderObject.js.map

package/dist/ui/primitives/renderPanel.js

@@ -168,4 +168,3 @@ function centerInContentWidth(panel, panelWidth) {
             .join('\n')
         : panel;
 }
-//# sourceMappingURL=renderPanel.js.map

package/dist/ui/primitives/renderSubtitle.js

@@ -3,4 +3,3 @@ export function renderSubtitle(props) {
     const color = props.textColor ?? 'muted';
     return wrapPlainText(props.text, props.width).map((line) => centerText(colorize(line, color), props.width));
 }
-//# sourceMappingURL=renderSubtitle.js.map

package/dist/ui/primitives/renderTable.js

@@ -11,4 +11,3 @@ export function renderTable(rows, options = {}) {
     })
         .join('\n');
 }
-//# sourceMappingURL=renderTable.js.map

package/dist/ui/primitives/terminalWidth.js

@@ -8,4 +8,3 @@ export function fitToTerminal(width, minimum = 24) {
     const columns = resolveTerminalColumns();
     return columns === null ? width : Math.min(width, Math.max(minimum, columns));
 }
-//# sourceMappingURL=terminalWidth.js.map

package/dist/ui/primitives/text.js

@@ -222,4 +222,3 @@ export function centerLineBlock(lines, width) {
     const leftPadding = Math.max(0, Math.floor((width - blockWidth) / 2));
     return flattenedLines.map((line) => `${' '.repeat(leftPadding)}${line}`);
 }
-//# sourceMappingURL=text.js.map

package/dist/ui/stream/index.js

@@ -1,2 +1 @@
 export * from './terminal-stream.js';
-//# sourceMappingURL=index.js.map

package/dist/ui/stream/terminal-stream.js

@@ -16,9 +16,14 @@ export function sanitizeTerminalText(content) {
 export function formatTerminalOutput(content, options = {}) {
     const target = options.target ?? 'stdout';
     const safeContent = sanitizeTerminalText(content);
-    const renderedContent = options.json && supportsColor(target) ? highlightJsonValues(safeContent, target) : safeContent;
+    const renderedContent = options.json && shouldHighlightJson(target) ? highlightJsonValues(safeContent, target) : safeContent;
     return `\n${renderedContent}\n\n`;
 }
+// FORCE_COLOR no alcanza para pintar el JSON: si va a un pipe o a un archivo, tiene que poder parsearse.
+function shouldHighlightJson(target) {
+    const stream = target === 'stderr' ? process.stderr : process.stdout;
+    return stream.isTTY === true && supportsColor(target);
+}
 export function writeTerminalOutput(content) {
     process.stdout.write(formatTerminalOutput(content, { target: 'stdout' }));
 }
@@ -28,7 +33,13 @@ export function writeTerminalJson(content) {
 export function writeTerminalError(content) {
     process.stderr.write(formatTerminalOutput(content, { target: 'stderr' }));
 }
+/**
+ * Aviso antes de la salida del comando, en stderr. Sin la linea vacia de cierre: lo que sigue ya empieza con una
+ * y quedarian dos.
+ */
+export function writeTerminalNotice(content) {
+    process.stderr.write(`\n${sanitizeTerminalText(content)}\n`);
+}
 export function writeTerminalJsonError(content) {
     process.stderr.write(formatTerminalOutput(content, { json: true, target: 'stderr' }));
 }
-//# sourceMappingURL=terminal-stream.js.map

package/dist/ui/theme/index.js

@@ -1,2 +1 @@
 export * from './theme.js';
-//# sourceMappingURL=index.js.map

package/dist/ui/theme/theme.js

@@ -227,4 +227,3 @@ export const UI_THEME = {
         wide: CONTENT_WIDTH,
     },
 };
-//# sourceMappingURL=theme.js.map

package/llms.txt

@@ -29,7 +29,7 @@ Con la salida redirigida (pipe o archivo) no hay colores, así que `--json` se p
 
 ## Modo interactivo (no usar desde un agente)
 
-`arcli` sin argumentos en una TTY abre un asistente con prompts (`arcli interactivo` lo abre explícito). Sin TTY o con `--json`, `arcli` sin argumentos muestra la ayuda y `arcli interactivo` falla. Un agente siempre tiene que usar los comandos con flags de abajo.
+`arcli` sin argumentos en una TTY abre un asistente con prompts (`arcli interactivo` lo abre explícito). Sin TTY, `arcli` sin argumentos muestra la ayuda y `arcli interactivo` falla. `arcli interactivo` acepta solo `--testing`/`--produccion`: `--json` y `--bruto` se ignoran con un aviso. Un agente siempre tiene que usar los comandos con flags de abajo.
 
 ## Comandos de facturación (shortcut de 2-4 letras)
 
@@ -48,33 +48,86 @@ Shortcuts (`family` = comando alternativo `arcli <family> <letra>`, ej. `arcli f
 | ncea, nceb, ncec | Nota de crédito electrónica A/B/C | nota-credito-electronica | sí |
 | ndea, ndeb, ndec | Nota de débito electrónica A/B/C | nota-debito-electronica | sí |
 
+## Factura de exportación E (WSFEX)
+
+`arcli fe` (o `arcli factura e`, que hace lo mismo) emite la Factura de exportación E con el
+servicio `wsfex`. No lleva concepto, IVA ni receptor con CUIT/CUIL/DNI: lleva
+cliente y domicilio del exterior, país de destino, incoterm, items y permisos de embarque. `--cargar`
+acepta un solo objeto, no un array.
+
+```bash
+arcli fe -m 1500 --cliente "ACME LLC" --domicilio-cliente "123 Main St" --pais-destino 203 \
+  --numero 1 --actividad 620100 --item "001|Servicios de consultoría|1|1500|unidad" --previsualizar --json
+```
+
+- Requeridos: `-m, --monto <n>`, `--cliente <texto>`, `--domicilio-cliente <texto>`,
+  `--pais-destino <codigo|nombre>` (código de ARCA o nombre, ej. `203` o `Brasil`), `--numero <n>` (el
+  siguiente al último E de ese punto de venta; arcli todavía no lo puede consultar en WSFEX porque
+  `@arcasdk/core` arma mal `FEXGetLast_CMP`) y la actividad: `--actividad <codigo>` o la clave
+  `exportacion.actividad`. No hay default: tiene que ser un código de la tabla de actividades de WSFEX,
+  que no es la del padrón (ej. `620100`; `620900` no está). Si no está en la tabla es
+  `INPUT_VALIDATION_ERROR` con las que empiezan igual.
+- `--item <partes>` (repetible): `codigo|descripcion|cantidad|precio|unidad`; con 4 partes se omite
+  el código y con 3 la unidad (por defecto `unidad`, código `7`). La suma de los items tiene que dar
+  `--monto`: se valida antes de ir a ARCA. Sin `--item` va un renglón con `--descripcion`.
+- Opcionales: `--id-impositivo <texto>`, `--cuit-pais <n>` (sin flag sale del país de destino; si ARCA no
+  publica un CUIT para ese país, el flag es obligatorio),
+  `--tipo-expo <1|2|4>` (`2` servicios por defecto, `1` bienes, `4` otros).
+  `solicitud` no informa `Cmps_asoc` ni `Opcionales` mientras no los haya: ARCA rechaza los bloques
+  vacíos (error 1820 el primero).
+- `--incoterm <codigo>`,
+  `--incoterms-desc <texto>`, `--idioma <codigo>` (`1` español por defecto, `2` inglés, `3` portugués),
+  `--forma-pago <texto>` (por defecto `Transferencia Internacional`), `--permiso <id>` (repetible, requiere
+  `--permiso-existente` y solo se acepta con `--tipo-expo 1`), `--permiso-existente`,
+  `--id-solicitud <n>` (sin flag, el siguiente de WSFEX), `--punto-venta <n>` (`--pv`), `-f, --fecha <fecha>`, `--fecha-pago <fecha>`,
+  `--moneda <codigo>` (`--mda`; por defecto `DOL`), `--cotizacion-moneda <n>` (`--cm`; sin flag, la de
+  aduana que publica ARCA; la clave `cotizacion` de la config no aplica), `--misma-moneda`
+  (manda `CanMisMonExt` en `S`: el pago se cancela en la misma moneda extranjera),
+  `--observaciones <texto>`, `--obs-comerciales <texto>`, `--descripcion <texto>`, `--cargar <path>`,
+  `--exportar-pdf` (`--pdf`), `--sin-pdf`, `--previsualizar`, `--emitir`, `--json`, `--bruto`.
+- La fecha del comprobante no puede ser futura. WSFEX numera por punto de venta y tipo.
+- `fe` es estricto: un flag de A/B/C es opción desconocida. `factura <letra>` acepta los flags de todas las
+  letras y saltea los que no aplican a la elegida con un aviso en `avisos` (`factura a --incoterm`,
+  `factura e --alicuota`).
+- Credenciales: usa `exportacion.cert.<entorno>`/`exportacion.key.<entorno>` si están configuradas y,
+  si no, `cert.<entorno>`/`key.<entorno>`; el certificado tiene que estar autorizado a `wsfex` (si no,
+  `WSFEX_SERVICE_NOT_AUTHORIZED`). Con la
+  mitad del par configurada, el comando corta antes de ir a ARCA.
+- Un rechazo de WSFEX sale como respuesta válida con exit code `2`, igual que en las letras A, B y C.
+- PDF: `factura-e_<pv>-<numero>.pdf`, con el diseño de exportación (divisa, destino, forma y fecha de
+  pago, incoterm, leyenda de IVA exento).
+
 ## Flags principales (alias corto entre paréntesis)
 
-- `-m, --monto <n>`: importe total (requerido). Montos en formato argentino: punto para miles, coma para decimales (`15000`, `15.000`, `1.500,50`). `1500.50` da error; máximo 2 decimales (la cotización, 6). Aplica a `--monto`, `--exento`, `--nogravado`, `--cm` y `--alicuota TASA:MONTO`. En JSON los montos son números, también con 2 decimales como máximo. Enteros (`--pv`, `--ar`, `--dia`…) solo con dígitos; `--cuit`/`--cuil`/`--dni` aceptan guiones.
+- `-m, --monto <n>`: importe total (requerido). Montos en formato argentino: punto para miles, coma para decimales (`15000`, `15.000`, `1.500,50`). `1500.50` da error; máximo 2 decimales (la cotización, 6). Aplica a `--monto`, `--exento`, `--nogravado`, `--cm` y `--alicuota TASA:MONTO`. En JSON los montos son números, también con 2 decimales como máximo. Enteros (`--pv`, `--ar`, `--dia`…) solo con dígitos; `--cuit`/`--cuil`/`--acuit`/`--dni` aceptan guiones, y todo CUIT (también el de `padron`, `fce-obligado` y `config establecer cuit`) se valida con su dígito verificador.
 - Concepto: `--concepto <tipo>` (`productos`/`servicios`/`productos-servicios`) o atajos `--cs` `--cp` `--csp`. Uno solo, no combinar `--concepto` con un atajo.
 - IVA receptor: `--iva-receptor <tipo>` / `--ir <tipo>` (alias) o un atajo `--ir-ce|--ir-cf|--ir-il|--ir-ina|--ir-ms|--ir-mtip|--ir-pe|--ir-ri|--ir-rm|--ir-se|--ir-snc`. Usar exactamente una forma.
   Valores válidos: `cliente-del-exterior`, `consumidor-final`, `iva-liberado`, `iva-no-alcanzado`, `monotributista-social`, `monotributo-trabajador-independiente-promovido`, `proveedor-del-exterior`, `responsable-inscripto`, `responsable-monotributo`, `sujeto-exento`, `sujeto-no-categorizado`.
-  El IVA receptor tiene que ser válido para la letra: `A` solo admite `responsable-inscripto`, `responsable-monotributo`, `monotributista-social` y `monotributo-trabajador-independiente-promovido`; `B` admite el resto; `C` admite todos. Letras `A` y `B` siempre discriminan IVA al 21%.
+  El IVA receptor tiene que ser válido para la letra: `A` solo admite `responsable-inscripto`, `responsable-monotributo`, `monotributista-social` y `monotributo-trabajador-independiente-promovido`; `B` admite el resto; `C` admite todos. Letras `A` y `B` discriminan IVA a la alícuota de `--alicuota` (por defecto 21%, ver abajo).
 - IVA (solo letras A y B): `--alicuota general|reducida|incrementada|cero` o el número `0|2.5|5|10.5|21|27` (default `config.alicuota` o 21; la config no aplica a C). Varias alícuotas: repetir `--alicuota TASA:MONTO` con el monto IVA incluido de cada una (`--alicuota general:1210 --alicuota reducida:552,50`); `--monto` pasa a ser opcional y, si se pasa, tiene que coincidir con la suma. En JSON: `alicuotas: [{tasa, monto}]`. Además, `--exento <monto>` y `--nogravado <monto>` (sin guion). `--monto` es siempre el total; exento y no gravado se descuentan y el IVA se calcula sobre el resto. En letra C esos flags dan error.
 - Identidad del receptor: `--cuit <n>` / `--cuil <n>` / `--dni <n>` / `--consumidor-final` (alias `--cfinal`, documento 0). Usar como máximo una. Desde $10.000.000 (total × cotización) no se puede usar `--consumidor-final`: identificar con `--dni`/`--cuit`/`--cuil` y `--ir-cf`.
 - Punto de venta: `--punto-venta <n>` (alias `--pv`). Si no se pasa, usa el default de config.
 - Moneda: `--moneda <codigo>` (alias `--mda`, ej. `ARS`/`USD`; `USD` se envía como `DOL`) y `--cotizacion-moneda <n>` (alias `--cm`). En moneda extranjera la cotización es obligatoria y no puede ser 1; si el pago es en la misma moneda extranjera, usar `--misma-moneda` en lugar de `--cm` (consulta la cotización oficial a ARCA). En pesos no pasar cotización distinta de 1.
-- Fechas: `-f, --fecha <fecha>` acepta formato argentino día-primero: `D`, `DD`, `D/M`, `DD/MM`, `D-M-YY`, `DD-MM-YYYY` (con `-` o `/`); si se omiten mes/año usa los actuales. También `--servicio-desde`/`--sd` y `--servicio-hasta`/`--sh`, y `-d, --dia <n>` (día de vencimiento; no se combina con `--fecha` ni `--servicio-hasta`). "Hoy" es siempre la fecha argentina, aunque el equipo esté en UTC. `--vencimiento <fecha>` (alias `--vto`) fija `FchVtoPago` aparte del período de servicio (servicios y facturas FCE; no en productos ni NC/ND FCE). Ventana de `--fecha` respecto de hoy: productos ±5 días, servicios ±10, FCE −5/+1; en productos y FCE una fecha futura tiene que caer en el mes actual.
+- Fechas: `-f, --fecha <fecha>` acepta formato argentino día-primero: `D`, `DD`, `D/M`, `DD/MM`, `D-M-YY`, `DD-MM-YYYY` (con `-` o `/`); si se omiten mes/año usa los actuales. También `--servicio-desde`/`--sd` y `--servicio-hasta`/`--sh`, y `-d, --dia <n>` (día de vencimiento: este mes si todavía no pasó, si no el mes que viene; si ese día no existe en el mes, como 31 en abril, da error; no se combina con `--fecha` ni `--servicio-hasta`). "Hoy" es siempre la fecha argentina, aunque el equipo esté en UTC. `--vencimiento <fecha>` (alias `--vto`) fija `FchVtoPago` aparte del período de servicio (servicios y facturas FCE; no en productos ni NC/ND FCE). Ventana de `--fecha` respecto de hoy: productos ±5 días, servicios ±10, FCE −5/+1; en productos y FCE una fecha futura tiene que caer en el mes actual.
 - Comprobante asociado (obligatorio en notas de crédito/débito): `--ac <shortcut>` (ej. `fc`), `--apv <n>` (punto de venta, alias `--asociado-punto-venta`), `--ar <n>` (número), `--acuit <n>`, `--at <n>` (tipo ARCA, alternativa a `--ac`; no combinar ambos), `--afecha <fecha>` (fecha del asociado, opcional salvo en NC/ND FCE). En notas comunes, en lugar del bloque `--ac` se puede usar un período: `--periodo-desde <fecha>` y `--periodo-hasta <fecha>` (alias `--pd`/`--ph`); no se combinan con `--ac`/`--at`, no aplican a FCE y el período no puede terminar después de la nota.
 - Crédito electrónico (FCE): las facturas `fcea/fceb/fcec` requieren `--cbu <22 dígitos>` (o `arcli config establecer cbu ...`); opcionales `--alias <alias>` y `--transferencia sca|adc` (default `sca`). Las NC/ND FCE (`ncea`…`ndec`) requieren `--afecha`, aceptan `--anulacion`, toman `--acuit` del CUIT emisor si se omite y no aceptan `--cbu`/`--alias`/`--transferencia`. Fuera de FCE esos flags dan error.
+- Padrón: `arcli padron <cuit> [--json]` consulta en ARCA (`ws_sr_constancia_inscripcion`) nombre, domicilio fiscal, `condicionIva` (`responsable-inscripto`, `responsable-monotributo`, `sujeto-exento` o `null` si no se puede deducir), impuestos y actividades. CUIT inexistente: error `TAXPAYER_NOT_FOUND`. Al facturar con `--cuit` y sin `--ir`/`ivaReceptor`, se usa la condición del padrón antes que el `ivaReceptor` de la config; si el padrón no responde o no la informa, se usa la config con un aviso en `avisos`, y sin config es `INPUT_VALIDATION_ERROR`. Se desactiva con `arcli config establecer consultarPadron false`. Para no depender del padrón, pasá `--ir` explícito.
+- Autocompletado con Tab (para personas; un agente no lo necesita): `arcli completado instalar [shell]` lo agrega al archivo de inicio del shell, `arcli completado desinstalar [shell]` lo saca, `arcli completado` dice si está instalado y `arcli completado <bash|zsh|fish>` imprime el script. Con `--json`: `{ cambio, instalado, ruta, shell }`.
 - Régimen FCE: `arcli fce-obligado <cuit> [--fecha <fecha>] [--json]` consulta en ARCA (`wsfecred`) si el receptor está obligado a recibir FCE y desde qué monto. Con `arcli config establecer verificarFce true`, cada factura con CUIT hace esa consulta y devuelve avisos en `avisos` (JSON) sin bloquear. Requiere autorizar `wsfecred` en ARCA además de `wsfe`.
 - Ejecución: `--previsualizar` (solo arma y muestra la solicitud) vs `--emitir` (real contra ARCA) — son mutuamente excluyentes. El entorno sale de `config.entorno` (`testing` por defecto) salvo `--testing`/`--produccion`. Sin `--emitir` ni `--previsualizar` decide `config.emitir` (o `"emitir"` del JSON); si tampoco hay, en una terminal pregunta y con `--json` o sin TTY no emite. `--produccion --emitir` emite de verdad sin confirmación adicional, y lo mismo pasa sin flags si la config tiene `entorno produccion` y `emitir true`. Para no depender de la config, pasá siempre `--testing` o `--produccion` y `--emitir` o `--previsualizar` explícitos.
-- Salida: `--json` (estructurada, para scripts/agentes — desactiva el aviso de nueva versión), `--bruto` (incluye la respuesta cruda de ARCA).
+- Salida: `--json` (estructurada, para scripts/agentes — desactiva el aviso de nueva versión), `--bruto` (incluye la respuesta cruda de ARCA). `--bruto` solo existe en los comandos de facturación; en `padron`, `fce-obligado`, `ultimos`, `consultar`, `parametros` y `estado` se ignora con un aviso en stderr. En todos los comandos, sin `--json` decide la clave de config `json`.
 - `--cargar <path.json>`: carga uno o un array de comprobantes desde un JSON en vez de flags (ver forma abajo). Los flags pisan lo que venga del archivo.
-- PDF: `--exportar-pdf` (alias `--pdf`) genera el PDF con QR después de emitir; `--sin-pdf` no lo genera; sin flag decide `config pdf` (`preguntar` por defecto, que sin TTY o con `--json` no genera). Datos que solo van en el PDF (ARCA no los recibe): `--descripcion <texto>`, `--receptor-nombre <texto>`, `--receptor-domicilio <texto>`. Requiere el plugin (`arcli pdf instalar`, ~160 MB; desde un agente instalarlo antes, porque sin TTY nunca se descarga solo) y `emisor.razonSocial`, `emisor.domicilio`, `emisor.inicioActividades` en la config. Detalle: `docs/pdf.md`.
+- PDF: `--exportar-pdf` (alias `--pdf`) genera el PDF con QR después de emitir; `--sin-pdf` no lo genera; sin flag decide `config pdf` (`preguntar` por defecto, que sin TTY o con `--json` no genera). Datos que solo van en el PDF (ARCA no los recibe): `--descripcion <texto>`, `--receptor-nombre <texto>`, `--receptor-domicilio <texto>`. Requiere el plugin (`arcli pdf instalar`, ~160 MB; desde un agente instalarlo antes, porque sin TTY nunca se descarga solo) y `emisor.razonSocial`, `emisor.domicilio`, `emisor.inicioActividades` en la config. Detalle: https://github.com/LcsGrz/arcli/blob/main/docs/pdf.md.
 
 ## Modo no interactivo
 
-Sin `--emitir` ni `--previsualizar`, si la sesión es interactiva (TTY) arcli muestra una vista
-previa y pregunta si emitir. **Con `--json`, o cuando stdin/stdout no son un TTY (scripts,
-agentes, CI), nunca pregunta** — se comporta como si fuera dry-run salvo que se pase
-`--emitir` explícitamente. Para invocar desde un agente, siempre pasar `--emitir` o
-`--previsualizar` de forma explícita y no depender del prompt.
+Sin `--emitir` ni `--previsualizar`, decide `"emitir"` del JSON de `--cargar` y, si no está,
+`config.emitir`. Si nada pide emitir y la sesión es interactiva (TTY), arcli muestra una vista
+previa y pregunta. **Con `--json`, o cuando stdin/stdout no son un TTY (scripts, agentes, CI),
+nunca pregunta**: no emite, salvo que `config.emitir` sea `true`, y en ese caso emite sin
+confirmar (en producción también, si `config.entorno` es `produccion`). Para invocar desde un
+agente, siempre pasar `--emitir` o `--previsualizar` (y `--testing` o `--produccion`) de forma
+explícita y no depender de la config ni del prompt.
 
 ## Forma del JSON de `--cargar` (un objeto o un array de estos)
 
@@ -88,20 +141,22 @@ agentes, CI), nunca pregunta** — se comporta como si fuera dry-run salvo que s
   "puntoVenta": 3,
   "codigoMoneda": "ARS",
   "cotizacionMoneda": 1,
-  "fechaComprobante": "18-03-2026",
-  "servicioDesde": "01-03-2026",
-  "servicioHasta": "31-03-2026",
   "dia": 10,
-  "emitir": false,
   "previsualizar": true,
-  "comprobanteAsociado": { "atajo": "fc", "cuit": "20123456789", "numero": 10, "puntoVenta": 3 },
   "pdf": true,
-  "descripcion": "Servicios de marzo",
+  "descripcion": "Servicios del mes",
   "receptorNombre": "Cliente SA",
   "receptorDomicilio": "Calle 1"
 }
 ```
 
+Las claves son las de este ejemplo más `emitir`, `fechaComprobante`, `servicioDesde`, `servicioHasta` (fechas como en los
+flags; `dia` no se combina con `fechaComprobante` ni `servicioHasta`), `alicuotaIva`, `alicuotas` (`[{tasa, monto}]`),
+`importeExento`, `importeNoGravado`, `mismaMoneda`, `vencimientoPago`, `cbu`, `aliasCbu`, `transferencia` y, solo en notas,
+`comprobanteAsociado` (`{atajo|tipo, puntoVenta, numero, cuit, fecha}`), `periodoAsociado` (`{desde, hasta}`) y `anulacion`. Lista y equivalencia con los flags: https://github.com/LcsGrz/arcli/blob/main/docs/input-output.md.
+Una clave desconocida (`montototal`, `vencimiento`, `moneda`) o un tipo incorrecto (`"puntoVenta": "3"`, `"emitir": "true"`,
+`null`) es `INPUT_VALIDATION_ERROR` (en un lote, `BATCH_VALIDATION_ERROR` con el índice): no se ignora. Números sin comillas.
+
 ## Forma de la respuesta (`--json`, sin `--bruto`)
 
 ```json
@@ -117,77 +172,99 @@ agentes, CI), nunca pregunta** — se comporta como si fuera dry-run salvo que s
   "eventos": [],
   "observaciones": ["..."],
   "observacion": "string | null",
-  "solicitud": { "...": "payload enviado a ARCA" },
+  "numero": "number (número emitido) | null (previsualización)",
+  "solicitud": { "...": "payload enviado a ARCA; si se emitió, con CbteDesde/CbteHasta" },
   "previsualizacion": true,
   "sugerencias": ["texto en español sugiriendo como resolver errores comunes de ARCA"],
   "pdf": { "ruta": "/ruta/al/archivo.pdf" }
 }
 ```
 
+En la factura E (`fe`) el objeto agrega `exportacion` (`cliente`, `destino`, `domicilioCliente`,
+`incoterm`, `items`, `permisos`, `tipoExpo`) y `solicitud` es el `Cmp` de WSFEX con los nombres de ARCA
+(`Dst_cmp`, `Moneda_Id`, `Items.Item`…). `solicitud` no lleva `Permisos` cuando no hay permisos de
+embarque: ARCA rechaza ese campo (error 1720) si `Permiso_existente` es `N`, y lo exige vacío en los
+tipos `2` (servicios) y `4` (otros), donde tampoco admite permisos (error 1550).
+
 `pdf` aparece solo si se intentó generar el PDF. Si falló es `{ "error": { "codigo", "mensaje", "sugerencia" } }`
 (`PDF_PLUGIN_MISSING`, `PDF_PLUGIN_INSTALL_ERROR`, `PDF_ISSUER_INCOMPLETE`, `PDF_GENERATION_ERROR`) y el exit code
 sigue siendo `0`: el comprobante ya está emitido, **no reemitir para obtener el PDF**.
 
-Con múltiples comprobantes (batch o `--cargar` con array) la salida es un array de estos
-objetos. Con `--bruto` se agrega `respuesta` con la respuesta cruda del SDK.
+Con `--cargar` y un array la salida es un array de estos objetos (con `indice`), aunque el array tenga un
+solo elemento; con un objeto o con flags, un objeto. Con `--bruto` se agrega `respuesta` con la respuesta
+cruda del SDK; el resto de los campos no cambia.
 
 **Importante:** un comprobante rechazado por ARCA (`"estado": "rechazado"`) es una respuesta
-válida, no una excepción — el proceso termina con exit code `0` igual. Para saber si un
-comprobante fue realmente aprobado hay que revisar `estado`/`resultado`/`errores` en el
-JSON, nunca alcanza con chequear el exit code.
+válida, no una excepción: sale por stdout como cualquier resultado y el proceso termina con
+exit code `2`. En un lote, `2` si ARCA rechazó al menos uno; para saber cuáles, revisar
+`estado`/`resultado`/`errores` de cada uno. `observado` es aprobado (tiene CAE) y sale con `0`.
 
 ## Salida de error
 
 Sin `--json` (ni `json=true` en la config): panel de texto en stderr. Con `--json` o `json=true`: JSON en stderr con la forma
 `{"codigo": "...", "detalles": {...} | null, "error": "mensaje", "sugerencia": "..." | null}`.
 `codigo` es `CONFIGURATION_ERROR`, `INPUT_VALIDATION_ERROR`, `EMISSION_UNCERTAIN` (falló la llamada
-que emite: puede haberse emitido igual; antes de reintentar, verificar con el `arcli ultimos <tipo> --pv <n>`
-que viene en `sugerencia`), `TRANSIENT_ERROR` (consultas: reintentar), `UNEXPECTED_ERROR`, `VOUCHER_NOT_FOUND` (`consultar`), o en un lote
-(`--cargar` con un array) `BATCH_VALIDATION_ERROR` (no se emitió ninguno; `detalles.comprobantes` lista cada
+que emite, no el login ni el pedido del último número: puede haberse emitido igual; antes de reintentar, verificar con el `arcli ultimos <tipo> --pv <n>`
+que viene en `sugerencia`), `TRANSIENT_ERROR` (consultas: reintentar), `ARCA_LAST_VOUCHER_ERROR` (facturación o `ultimos`: ARCA rechazó el pedido del último número, por ejemplo con un punto de venta no habilitado; no se emitió nada), `CERTIFICATE_EXPIRED` (el certificado del entorno venció: se corta antes
+de ARCA, no se envió nada; `detalles.entorno` y `detalles.vencimiento`, la guía en `sugerencia`), `UNEXPECTED_ERROR`, `VOUCHER_NOT_FOUND` (`consultar`), o en un lote
+(`--cargar` con un array, aunque tenga un solo elemento) `BATCH_VALIDATION_ERROR` (no se emitió ninguno; `detalles.comprobantes` lista cada
 `{indice, error}`) y `BATCH_EMISSION_ERROR` (se cortó a mitad: los resultados ya procesados salen antes por
 stdout; si viene `detalles.sinConfirmar`, verificar ese índice con `arcli ultimos` antes de reintentarlo;
-después reintentar `detalles.sinProcesar`, nunca los ya emitidos). El proceso termina con
-exit code `1` en cualquier error.
+después reintentar `detalles.sinProcesar`, nunca los ya emitidos). En consultas: `TAXPAYER_NOT_FOUND` (`padron`),
+`PADRON_SERVICE_NOT_AUTHORIZED` (`padron`; al facturar no corta, usa la config con un aviso), `FCE_SERVICE_NOT_AUTHORIZED`
+y `FCE_OBLIGATION_ERROR` (`fce-obligado`; con `verificarFce` al facturar salen como aviso), `ARCA_UNAVAILABLE` (`estado`),
+`ARCA_PARAMETERS_ERROR` (`parametros <tabla>`) y `ARCA_QUOTATION_ERROR` (`parametros cotizacion` o `--misma-moneda`).
+`PDF_PLUGIN_INSTALL_ERROR` sale de `arcli pdf instalar`. `sugerencia` está siempre: `null` si no hay nada que sugerir.
+Qué hacer con cada código: tabla "Códigos de error" de https://github.com/LcsGrz/arcli/blob/main/docs/input-output.md. Los errores de uso (opción desconocida, valor faltante, comando inexistente) también salen en este JSON como `INPUT_VALIDATION_ERROR`, con el mensaje de commander en `error`. El proceso termina con
+exit code `1` en cualquier error. Resumen: `0` aprobado (u observado), `1` error, `2` rechazado por ARCA.
 
 ## Comando `config`
 
 ```bash
 arcli config                              # ver config actual (agregar --json)
-arcli config revisar [--testing|--produccion]   # valida credenciales + contexto real
-arcli config ruta                         # path del archivo de config
+arcli config revisar                      # valida credenciales y contexto de los dos entornos (agregar --json)
+arcli config ruta [--json]                # path del archivo de config ({"ruta": ...})
 arcli config establecer <clave> <valor>
 arcli config eliminar <clave>
 ```
 
-Claves válidas: `cuit`, `cbu`, `aliasCbu` (solo facturas FCE), `verificarFce`, `alicuota`, `puntoVenta`, `comprobantesPorLista` (1 a 50, por defecto 15), `concepto`, `ivaReceptor`, `moneda`, `cotizacion`,
+Claves válidas: `cuit`, `cbu`, `aliasCbu` (solo facturas FCE), `verificarFce`, `consultarPadron` (por defecto `true`), `alicuota`, `puntoVenta`, `comprobantesPorLista` (1 a 50, por defecto 15), `concepto`, `ivaReceptor`, `moneda`, `cotizacion`,
 `entorno` (`testing`/`produccion`), `emitir`, `json`, `bruto` (booleanos: `true/false`,
 `si/no`, `1/0`), `cert.testing`, `cert.produccion`, `key.testing`, `key.produccion`
-(rutas a archivos PEM, se validan al guardar), `ticketPath` (carpeta donde se cachea el
+(rutas a archivos PEM, se validan al guardar), `exportacion.cert.testing`, `exportacion.cert.produccion`,
+`exportacion.key.testing`, `exportacion.key.produccion` (credenciales propias de WSFEX para la factura
+de exportación; si faltan, se usan `cert.*`/`key.*`), `exportacion.actividad` (código de la tabla de
+actividades de WSFEX para la `E`; `--actividad` lo pisa), `ticketPath` (carpeta donde se cachea el
 ticket WSAA; por defecto una carpeta junto al archivo de config).
-Para el PDF: `pdf` (`siempre`/`preguntar`/`nunca`), `pdfCarpeta` (por defecto `~/arcli/comprobantes`; los de
-testing van a `testing/`), `pdfNavegador` (ruta a Chrome/Chromium/Edge), `emisor.razonSocial`, `emisor.domicilio`,
+Para el PDF: `pdf` (`siempre`/`preguntar`/`nunca`), `pdfCarpeta` (por defecto `~/arcli/comprobantes`; una subcarpeta
+por CUIT emisor, los de testing en `testing/<CUIT>/`, y nunca se pisa un PDF existente: se suma `-2`, `-3`), `pdfNavegador` (ruta a Chrome/Chromium/Edge), `emisor.razonSocial`, `emisor.domicilio`,
 `emisor.inicioActividades` (fecha con año), `emisor.iibb`, `emisor.condicionIva`, `emisor.logo` (PNG o JPG).
 
-`config revisar` también avisa si un certificado ya venció o vence en menos de 30 días.
+`config revisar` también avisa si un certificado ya venció o vence en menos de 30 días. Con `--json` devuelve
+`{ok, chequeos: [{categoria: "ok"|"warning"|"error", etiqueta, detalle}]}`; `ok: false` sale igual con exit code `0`.
+`arcli config --json` devuelve la config con las rutas enmascaradas (`cert`, `key` y `emisor` como objetos).
+Además, a menos de 30 días de vencer cualquiera de los certificados configurados (testing o producción, sin importar el entorno
+en uso), cada comando que va a ARCA avisa en stderr (nunca en stdout) y la facturación lo suma a `avisos` del JSON.
 
 ## Otros comandos
 
 - `arcli ultimos <tipo> [--cantidad N] [--pv N] [--json]`: últimos comprobantes emitidos (de 1 a 50; por defecto `config.comprobantesPorLista` o 15), del más nuevo al más viejo. `tipo` es el atajo (`fb`, `nca`…).
 - `arcli consultar <tipo> <numero> [--pv N] [--json]`: detalle de un comprobante emitido (CAE, vencimiento, importes, receptor). Si no existe, el error es `VOUCHER_NOT_FOUND`. Sirve para verificar después de emitir.
 - `arcli pdf [estado|instalar|desinstalar] [--json]`: plugin que genera los PDFs. `arcli pdf instalar` lo descarga sin preguntar (sirve en scripts).
-- `arcli estado [--json]`: si ARCA responde (servidores app/db/auth, latencia) y si el punto de venta configurado está habilitado. `listo: true` = se puede emitir. En testing ARCA no informa puntos de venta (`puntoVenta.estado: "sin-datos"`).
-- `arcli parametros [tabla] [--json]`: tablas de ARCA vigentes: `puntos-venta`, `comprobantes`, `documentos`, `alicuotas`, `iva-receptor`, `monedas`, `conceptos`, `opcionales`, `tributos`. `arcli parametros cotizacion USD` da la cotización oficial (`{moneda, cotizacion, fecha}`).
+- `arcli estado [--json]`: si ARCA responde y si el punto de venta configurado está habilitado: `{entorno, latenciaMs, listo, puntoVenta: {estado, numero, tipoEmision}, servidores: {aplicacion, baseDeDatos, autenticacion}}`. `listo: true` = se puede emitir; `listo: false` sale igual con exit code `0`, así que hay que leer `listo`. En testing ARCA no informa puntos de venta (`puntoVenta.estado: "sin-datos"`). Si ARCA no responde: error `ARCA_UNAVAILABLE`.
+- `arcli parametros [tabla] [--json]`: tablas de ARCA vigentes: `puntos-venta`, `comprobantes`, `documentos`, `alicuotas`, `iva-receptor`, `monedas`, `conceptos`, `opcionales`, `tributos`. Sin tabla: `{tablas: [{tabla, descripcion}]}`; con tabla: `{entorno, tabla, valores: [{id, descripcion, detalle, vigenteHasta}]}`. `arcli parametros cotizacion USD` da la cotización oficial (`{cotizacion, entorno, fecha, moneda}`, con `moneda` en código ARCA: `DOL`).
 - `arcli ejemplos`: comandos listos para copiar por cada tipo de comprobante.
-- `arcli storybook [escena]`: demos visuales de la UI (sin llamar a ARCA).
 - `arcli <cualquier comando> ayuda` o `--ayuda`: ayuda contextual con ejemplos (nota: el flag
   estándar `--help` de commander está deshabilitado, usar `--ayuda` o el subcomando `ayuda`).
 
 ## Más detalle
 
-- `docs/cli-reference.md`: referencia completa de comandos y flags.
-- `docs/configuration.md`: config persistente, claves soportadas, ticketPath.
-- `docs/validation-rules.md` y `docs/input-output.md`: reglas de validación y formatos de entrada/salida.
-- `docs/troubleshooting.md`: errores comunes de ARCA y como resolverlos.
-- `docs/pdf.md`: PDF de comprobantes, plugin, carpeta y nombre del archivo.
-- `docs/modo-interactivo.md`: asistente interactivo (un agente no debe usarlo).
-- `AGENTS.md`: para agentes que van a modificar el código de este repo (no para usar el CLI).
+Los docs no vienen en el paquete de npm: están en GitHub.
+
+- https://github.com/LcsGrz/arcli/blob/main/docs/cli-reference.md: referencia completa de comandos y flags.
+- https://github.com/LcsGrz/arcli/blob/main/docs/configuration.md: config persistente, claves soportadas, ticketPath.
+- https://github.com/LcsGrz/arcli/blob/main/docs/validation-rules.md y https://github.com/LcsGrz/arcli/blob/main/docs/input-output.md: reglas de validación y formatos de entrada/salida, con el JSON de cada comando y los códigos de error.
+- https://github.com/LcsGrz/arcli/blob/main/docs/troubleshooting.md: errores comunes de ARCA y como resolverlos.
+- https://github.com/LcsGrz/arcli/blob/main/docs/pdf.md: PDF de comprobantes, plugin, carpeta y nombre del archivo.
+- https://github.com/LcsGrz/arcli/blob/main/docs/modo-interactivo.md: asistente interactivo (un agente no debe usarlo).
+- https://github.com/LcsGrz/arcli/blob/main/AGENTS.md: para agentes que van a modificar el código de este repo (no para usar el CLI).