arcli 2.1.0 → 2.2.0

package/dist/modules/billing/billing.json-input.js

@@ -6,7 +6,7 @@ import { InputValidationError } from '../../lib/errors/app-error.js';
  * Es `.strict()`: una clave que no esta aca es un error, para que un typo no se ignore en silencio.
  */
 const ivaRateJsonSchema = z.union([z.string(), z.number()], {
-    error: 'tiene que ser un texto ("general", "10.5") o un numero (10.5)',
+    error: 'tiene que ser un texto ("general", "10.5") o un número (10.5)',
 });
 const associatedVoucherJsonSchema = z
     .object({
@@ -182,7 +182,7 @@ function formatPath(path) {
 function describeExpected(expected) {
     switch (expected) {
         case 'number':
-            return 'un numero';
+            return 'un número';
         case 'string':
             return 'un texto';
         case 'boolean':
@@ -234,7 +234,7 @@ function describeIssue(issue) {
         }
         if (path.length === 0) {
             return [
-                { mensaje: `Cada comprobante tiene que ser un objeto y llego ${describeReceived(issue.input)}.`, ruta: [] },
+                { mensaje: `Cada comprobante tiene que ser un objeto y llegó ${describeReceived(issue.input)}.`, ruta: [] },
             ];
         }
         const unquote = issue.expected === 'number' && typeof issue.input === 'string' && issue.input.trim() !== ''
@@ -242,7 +242,7 @@ function describeIssue(issue) {
             : '';
         return [
             {
-                mensaje: `"${pathLabel}" tiene que ser ${describeExpected(issue.expected)} y llego ${describeReceived(issue.input)}.${unquote}`,
+                mensaje: `"${pathLabel}" tiene que ser ${describeExpected(issue.expected)} y llegó ${describeReceived(issue.input)}.${unquote}`,
                 ruta: path.map(String),
             },
         ];
@@ -267,7 +267,7 @@ export function parseBillingJsonInput(value) {
 export function readBillingJsonItems(source) {
     if (Array.isArray(source)) {
         if (source.length === 0) {
-            throw new InputValidationError('El JSON de --cargar es un lote vacio: no hay comprobantes para procesar.');
+            throw new InputValidationError('El JSON de --cargar es un lote vacío: no hay comprobantes para procesar.');
         }
         return source;
     }
@@ -276,4 +276,3 @@ export function readBillingJsonItems(source) {
     }
     return [source];
 }
-//# sourceMappingURL=billing.json-input.js.map

package/dist/modules/billing/billing.labels.js

@@ -76,7 +76,7 @@ export function formatCurrencyLabel(value) {
         case 'PES':
             return 'Pesos argentinos (ARS)';
         case 'DOL':
-            return 'Dolares estadounidenses (USD)';
+            return 'Dólares estadounidenses (USD)';
         default:
             return value ?? 'N/D';
     }
@@ -105,4 +105,3 @@ export function formatDecimalLabel(value) {
         maximumFractionDigits: 6,
     }).format(value);
 }
-//# sourceMappingURL=billing.labels.js.map

package/dist/modules/billing/billing.mappers.js

@@ -57,4 +57,3 @@ export function formatDocumentFlag(documentType) {
             return '--consumidor-final';
     }
 }
-//# sourceMappingURL=billing.mappers.js.map

package/dist/modules/billing/billing.padron.js

@@ -1,6 +1,6 @@
 import { AppError, InputValidationError } from '../../lib/errors/app-error.js';
 import { formatIvaConditionName } from '../pdf/pdf-issuer.js';
-const MISSING_IVA_HINT = 'Use --ir <tipo> o un flag --ir-*, o configure uno por defecto con "arcli config establecer ivaReceptor <tipo>".';
+const MISSING_IVA_HINT = 'Usá --ir <tipo> o un flag --ir-*, o configurá uno por defecto con "arcli config establecer ivaReceptor <tipo>".';
 /** Hay que consultar el padron: un CUIT sin IVA receptor explicito (vino de la config o falta). */
 export function needsPadronLookup(input) {
     return (input.documentType === 'cuit' &&
@@ -34,22 +34,26 @@ export async function resolveIvaConditionFromPadron(input, gateway) {
     }
     catch (error) {
         const message = error instanceof Error ? error.message.replace(/\.$/, '') : 'error desconocido';
-        return fallBack(input, `No se pudo consultar el padron de ARCA (${message})`, lookupErrorHint(error));
+        return fallBack(input, `No se pudo consultar el padrón de ARCA (${message})`, lookupErrorHint(error));
     }
     if (!taxpayer) {
-        return fallBack(input, `El CUIT ${cuit} no figura en el padron de ARCA`);
+        return fallBack(input, `El CUIT ${cuit} no figura en el padrón de ARCA`);
     }
+    const fromPadron = [
+        ...(!input.receiverAddress && taxpayer.address ? ['address'] : []),
+        ...(!input.receiverName && taxpayer.name ? ['name'] : []),
+    ];
     const withReceiver = {
         ...input,
         receiverAddress: input.receiverAddress ?? taxpayer.address ?? undefined,
+        receiverFromPadron: fromPadron.length > 0 ? fromPadron : undefined,
         receiverName: input.receiverName ?? taxpayer.name ?? undefined,
     };
     if (!taxpayer.ivaCondition) {
-        return fallBack(withReceiver, `El padron de ARCA no informa la condicion IVA del CUIT ${cuit}`);
+        return fallBack(withReceiver, `El padrón de ARCA no informa la condición IVA del CUIT ${cuit}`);
     }
     return {
         input: { ...withReceiver, ivaCondition: taxpayer.ivaCondition, ivaConditionSource: 'padron' },
         warnings: [],
     };
 }
-//# sourceMappingURL=billing.padron.js.map

package/dist/modules/billing/billing.presenter.js

@@ -1,3 +1,2 @@
 export { formatBillingResultAsJson } from './billing.json-format.js';
 export { formatBillingResultAsText } from './billing.text.js';
-//# sourceMappingURL=billing.presenter.js.map

package/dist/modules/billing/billing.schemas.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { parseCuit } from '../../lib/identity/cuit.js';
 import { AMOUNT_DECIMALS, EXCHANGE_RATE_DECIMALS, hasAtMostDecimals } from '../../lib/numbers/argentine-amount.js';
 const BILLING_CONCEPT_ALIASES = {
     p: 'productos',
@@ -52,13 +53,13 @@ export function normalizeIvaRateInput(value) {
     const normalized = value.trim().toLowerCase();
     return IVA_RATE_ALIASES[normalized] ?? normalized.replace(',', '.').replace(/%$/, '');
 }
-export const billingIvaRateSchema = z.preprocess(normalizeIvaRateInput, z.enum(IVA_RATE_VALUES, { message: `La alicuota debe ser ${IVA_RATE_HINT}.` }));
+export const billingIvaRateSchema = z.preprocess(normalizeIvaRateInput, z.enum(IVA_RATE_VALUES, { message: `La alícuota debe ser ${IVA_RATE_HINT}.` }));
 /** Importe positivo con los decimales que acepta ARCA: 2 en importes y 6 en la cotizacion. */
 function positiveAmountSchema(decimals = AMOUNT_DECIMALS) {
     return z
         .number()
         .positive()
-        .refine((value) => hasAtMostDecimals(value, decimals), { message: `Use hasta ${decimals} decimales.` });
+        .refine((value) => hasAtMostDecimals(value, decimals), { message: `Usá hasta ${decimals} decimales.` });
 }
 /** Una alicuota con el importe que le corresponde, IVA incluido (igual que --monto). */
 const billingIvaRateAmountSchema = z.object({
@@ -69,8 +70,14 @@ const billingAssociatedVoucherSchema = z
     .object({
     cuit: z
         .string()
-        .trim()
-        .regex(/^\d{11}$/)
+        .transform((value, context) => {
+        const result = parseCuit(value);
+        if (!result.ok) {
+            context.addIssue({ code: 'custom', message: `El CUIT del comprobante asociado ${result.reason}.` });
+            return z.NEVER;
+        }
+        return result.value;
+    })
         .optional(),
     fecha: z.string().trim().optional(),
     numero: z.number().int().positive().optional(),
@@ -98,7 +105,7 @@ export const billingCommandSchema = z.object({
     cbuAlias: z
         .string()
         .trim()
-        .regex(/^[A-Za-z0-9.-]{6,20}$/, 'El alias debe tener entre 6 y 20 caracteres (letras, numeros, punto o guion)')
+        .regex(/^[A-Za-z0-9.-]{6,20}$/, 'El alias debe tener entre 6 y 20 caracteres (letras, números, punto o guion)')
         .optional(),
     concept: billingConceptSchema,
     currencyCode: z.string().trim().length(3).default('ARS'),
@@ -125,6 +132,8 @@ export const billingCommandSchema = z.object({
     pdfDescription: z.string().trim().min(1).max(200).optional(),
     pointOfSale: z.number().int().positive().optional(),
     receiverAddress: z.string().trim().min(1).max(200).optional(),
+    /** Que datos del receptor completo el padron (no los paso quien factura). */
+    receiverFromPadron: z.array(z.enum(['address', 'name'])).optional(),
     receiverName: z.string().trim().min(1).max(200).optional(),
     sameCurrency: z.boolean().default(false),
     serviceEndDate: z.string().trim().optional(),
@@ -143,4 +152,3 @@ export const billingCommandSchema = z.object({
         .pipe(z.enum(['adc', 'sca']))
         .optional(),
 });
-//# sourceMappingURL=billing.schemas.js.map

package/dist/modules/billing/billing.serialize.js

@@ -3,7 +3,7 @@ function formatRawResponse(result) {
         return result.response.raw;
     }
     return {
-        mensaje: 'Sin emision real. Use --emitir para obtener una respuesta de ARCA.',
+        mensaje: 'Sin emisión real. Usá --emitir para obtener una respuesta de ARCA.',
     };
 }
 // Aditivo: la clave `pdf` solo aparece si se intento generar el PDF.
@@ -29,8 +29,12 @@ function formatVoucherSummary(result) {
         eventos: result.response.events,
         observaciones: result.response.observaciones,
         observacion: result.response.observacion,
+        numero: result.voucherNumber ?? null,
         ...formatPdfOutcome(result),
-        solicitud: result.payload,
+        // Lo que se envio a ARCA, con el numero que le toco.
+        solicitud: result.voucherNumber === undefined
+            ? result.payload
+            : { ...result.payload, CbteDesde: result.voucherNumber, CbteHasta: result.voucherNumber },
         previsualizacion: result.dryRun,
         resultado: result.response.resultado,
         sugerencias: result.response.suggestions,
@@ -56,4 +60,3 @@ export function serializeBillingBatch(results, options = {}) {
 export function formatRawBillingResponse(result) {
     return formatRawResponse(result);
 }
-//# sourceMappingURL=billing.serialize.js.map

package/dist/modules/billing/billing.service.js

@@ -69,6 +69,7 @@ export class BillingService {
             payload,
             receiver,
             response: mapBillingResponse(response),
+            voucherNumber,
             voucherKind,
             warnings: options.warnings ?? [],
         };
@@ -92,17 +93,17 @@ export class BillingService {
         }
         catch (error) {
             const reason = error instanceof Error ? error.message : 'error desconocido';
-            return [`No se pudo verificar el regimen FCE del receptor: ${reason}`];
+            return [`No se pudo verificar el régimen FCE del receptor: ${reason}`];
         }
     }
     buildVoucherPayload(input, runtime, voucherKind = this.requireVoucherKind(input.shortcut)) {
         const pointOfSale = input.pointOfSale ?? runtime.pointOfSale;
         // Resguardo: un IVA receptor que esperaba al padron nunca llega a ARCA con el valor provisorio.
         if (input.ivaConditionSource === 'missing') {
-            throw new InputValidationError('Falta IVA receptor. Use --ir <tipo> o un flag --ir-*, o configure uno por defecto con "arcli config establecer ivaReceptor <tipo>".');
+            throw new InputValidationError('Falta IVA receptor. Usá --ir <tipo> o un flag --ir-*, o configurá uno por defecto con "arcli config establecer ivaReceptor <tipo>".');
         }
         if (!pointOfSale) {
-            throw new InputValidationError('Falta el punto de venta. Use --punto-venta o --pv, o configurelo con "arcli config establecer puntoVenta <valor>".');
+            throw new InputValidationError('Falta el punto de venta. Usá --punto-venta o --pv, o configuralo con "arcli config establecer puntoVenta <valor>".');
         }
         const dateRange = resolveBillingDateRange(input, voucherKind);
         const concept = resolveBillingConceptCode(input.concept);
@@ -171,4 +172,3 @@ export class BillingService {
         return definition;
     }
 }
-//# sourceMappingURL=billing.service.js.map

package/dist/modules/billing/billing.text.js

@@ -45,4 +45,3 @@ export function formatBillingResultAsText(result, options = {}) {
     }
     return lines.join('\n\n');
 }
-//# sourceMappingURL=billing.text.js.map

package/dist/modules/billing/billing.types.internal.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=billing.types.internal.js.map

package/dist/modules/billing/billing.types.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=billing.types.js.map

package/dist/modules/billing/billing.validation.js

@@ -1,5 +1,6 @@
 import { diffArcaDatesInDays, formatArcaDateAsArgentineDate } from '../../lib/dates/arca-date.js';
 import { InputValidationError } from '../../lib/errors/app-error.js';
+import { parseCuit } from '../../lib/identity/cuit.js';
 import { formatDocumentFlag, formatVoucherLabel } from './billing.mappers.js';
 export function ensureDateOrder(serviceStartDate, serviceEndDate) {
     if (serviceStartDate > serviceEndDate) {
@@ -11,7 +12,7 @@ export function validateConceptDateInputs(input, voucherKind) {
     const hasPartialServiceDate = Boolean(input.serviceStartDate) !== Boolean(input.serviceEndDate);
     if (input.paymentDueDate) {
         if (voucherKind.isElectronicCredit && voucherKind.family !== 'factura-credito-electronica') {
-            throw new InputValidationError(`La ${formatVoucherLabel(voucherKind)} no lleva vencimiento de pago. Quite --vencimiento.`);
+            throw new InputValidationError(`La ${formatVoucherLabel(voucherKind)} no lleva vencimiento de pago. Sacá --vencimiento.`);
         }
         if (!voucherKind.isElectronicCredit && input.concept === 'productos') {
             throw new InputValidationError('El concepto "productos" no usa --vencimiento.');
@@ -19,10 +20,10 @@ export function validateConceptDateInputs(input, voucherKind) {
     }
     if (input.concept === 'productos') {
         if (hasAnyServiceDate) {
-            throw new InputValidationError('El concepto "productos" no usa fechas de servicio. Quite --servicio-desde y --servicio-hasta.');
+            throw new InputValidationError('El concepto "productos" no usa fechas de servicio. Sacá --servicio-desde y --servicio-hasta.');
         }
         if (input.dueDay) {
-            throw new InputValidationError('El concepto "productos" no usa --dia. Use solo fecha o monto.');
+            throw new InputValidationError('El concepto "productos" no usa --dia. Usá solo fecha o monto.');
         }
         return;
     }
@@ -31,7 +32,7 @@ export function validateConceptDateInputs(input, voucherKind) {
     }
     // --dia arma el fin del servicio desde hoy; con una fecha explicita no se usaria y nadie se enteraria.
     if (input.dueDay && (input.billingDate || input.serviceEndDate)) {
-        throw new InputValidationError('--dia no se combina con --fecha ni con --servicio-hasta: con esas fechas no se usa. Quite --dia o esas fechas.');
+        throw new InputValidationError('--dia no se combina con --fecha ni con --servicio-hasta: con esas fechas no se usa. Sacá --dia o esas fechas.');
     }
 }
 export function validateDocumentIdentity(input, voucherKind) {
@@ -40,16 +41,18 @@ export function validateDocumentIdentity(input, voucherKind) {
             throw new InputValidationError(`La ${formatVoucherLabel(voucherKind)} usa consumidor final solo con --ir-cf o --iva-receptor consumidor-final.`);
         }
         if (typeof input.documentNumber === 'number' && input.documentNumber !== 0) {
-            throw new InputValidationError(`La ${formatVoucherLabel(voucherKind)} usa consumidor final solo con documento 0. Use --consumidor-final.`);
+            throw new InputValidationError(`La ${formatVoucherLabel(voucherKind)} usa consumidor final solo con documento 0. Usá --consumidor-final.`);
         }
         return;
     }
     if (typeof input.documentNumber !== 'number') {
-        throw new InputValidationError(`La ${formatVoucherLabel(voucherKind)} requiere documento del receptor. Use ${formatDocumentFlag(input.documentType)}.`);
+        throw new InputValidationError(`La ${formatVoucherLabel(voucherKind)} requiere documento del receptor. Usá ${formatDocumentFlag(input.documentType)}.`);
     }
-    if ((input.documentType === 'cuit' || input.documentType === 'cuil') &&
-        !/^\d{11}$/.test(String(input.documentNumber))) {
-        throw new InputValidationError(`${formatDocumentFlag(input.documentType)} debe tener 11 digitos en ${formatVoucherLabel(voucherKind)}.`);
+    if (input.documentType === 'cuit' || input.documentType === 'cuil') {
+        const result = parseCuit(input.documentNumber);
+        if (!result.ok) {
+            throw new InputValidationError(`${formatDocumentFlag(input.documentType)} ${input.documentNumber} no es válido en ${formatVoucherLabel(voucherKind)}: ${result.reason}.`);
+        }
     }
     if (input.documentType === 'dni' && !/^\d{7,8}$/.test(String(input.documentNumber))) {
         throw new InputValidationError(`--dni debe tener 7 u 8 digitos en ${formatVoucherLabel(voucherKind)}.`);
@@ -70,7 +73,7 @@ export function validateBillingDateWindow(billingDate, today, concept, voucherKi
     const offset = diffArcaDatesInDays(today, billingDate);
     const label = formatArcaDateAsArgentineDate(billingDate);
     if (offset < -window.maxDaysBefore || offset > window.maxDaysAfter) {
-        throw new InputValidationError(`La fecha ${label} esta fuera de rango para la ${formatVoucherLabel(voucherKind)}: ARCA acepta hasta ${window.maxDaysBefore} dias antes y ${window.maxDaysAfter} despues de hoy.`);
+        throw new InputValidationError(`La fecha ${label} esta fuera de rango para la ${formatVoucherLabel(voucherKind)}: ARCA acepta hasta ${window.maxDaysBefore} días antes y ${window.maxDaysAfter} después de hoy.`);
     }
     if (window.sameMonthWhenFuture && offset > 0 && billingDate.slice(0, 6) !== today.slice(0, 6)) {
         throw new InputValidationError(`La fecha ${label} es futura y cae en otro mes. Para la ${formatVoucherLabel(voucherKind)} ARCA solo acepta fechas futuras dentro del mes actual.`);
@@ -81,4 +84,3 @@ export function validatePaymentDueDate(paymentDueDate, minimumPaymentDueDate) {
         throw new InputValidationError(`El vencimiento de pago (${formatArcaDateAsArgentineDate(paymentDueDate)}) no puede ser anterior al ${formatArcaDateAsArgentineDate(minimumPaymentDueDate)}.`);
     }
 }
-//# sourceMappingURL=billing.validation.js.map

package/dist/modules/billing/voucher-kind-map.js

@@ -28,7 +28,7 @@ export const VOUCHER_KIND_MAP = {
     },
     nca: {
         arcaType: 3,
-        displayName: 'Nota de credito A',
+        displayName: 'Nota de crédito A',
         family: 'nota-credito',
         isElectronicCredit: false,
         letter: 'a',
@@ -37,7 +37,7 @@ export const VOUCHER_KIND_MAP = {
     },
     ncb: {
         arcaType: 8,
-        displayName: 'Nota de credito B',
+        displayName: 'Nota de crédito B',
         family: 'nota-credito',
         isElectronicCredit: false,
         letter: 'b',
@@ -46,7 +46,7 @@ export const VOUCHER_KIND_MAP = {
     },
     ncc: {
         arcaType: 13,
-        displayName: 'Nota de credito C',
+        displayName: 'Nota de crédito C',
         family: 'nota-credito',
         isElectronicCredit: false,
         letter: 'c',
@@ -55,7 +55,7 @@ export const VOUCHER_KIND_MAP = {
     },
     nda: {
         arcaType: 2,
-        displayName: 'Nota de debito A',
+        displayName: 'Nota de débito A',
         family: 'nota-debito',
         isElectronicCredit: false,
         letter: 'a',
@@ -64,7 +64,7 @@ export const VOUCHER_KIND_MAP = {
     },
     ndb: {
         arcaType: 7,
-        displayName: 'Nota de debito B',
+        displayName: 'Nota de débito B',
         family: 'nota-debito',
         isElectronicCredit: false,
         letter: 'b',
@@ -73,7 +73,7 @@ export const VOUCHER_KIND_MAP = {
     },
     ndc: {
         arcaType: 12,
-        displayName: 'Nota de debito C',
+        displayName: 'Nota de débito C',
         family: 'nota-debito',
         isElectronicCredit: false,
         letter: 'c',
@@ -82,7 +82,7 @@ export const VOUCHER_KIND_MAP = {
     },
     fcea: {
         arcaType: 201,
-        displayName: 'Factura de credito electronica A',
+        displayName: 'Factura de crédito electrónica A',
         family: 'factura-credito-electronica',
         isElectronicCredit: true,
         letter: 'a',
@@ -91,7 +91,7 @@ export const VOUCHER_KIND_MAP = {
     },
     fceb: {
         arcaType: 206,
-        displayName: 'Factura de credito electronica B',
+        displayName: 'Factura de crédito electrónica B',
         family: 'factura-credito-electronica',
         isElectronicCredit: true,
         letter: 'b',
@@ -100,7 +100,7 @@ export const VOUCHER_KIND_MAP = {
     },
     fcec: {
         arcaType: 211,
-        displayName: 'Factura de credito electronica C',
+        displayName: 'Factura de crédito electrónica C',
         family: 'factura-credito-electronica',
         isElectronicCredit: true,
         letter: 'c',
@@ -109,7 +109,7 @@ export const VOUCHER_KIND_MAP = {
     },
     ncea: {
         arcaType: 203,
-        displayName: 'Nota de credito electronica A',
+        displayName: 'Nota de crédito electrónica A',
         family: 'nota-credito-electronica',
         isElectronicCredit: true,
         letter: 'a',
@@ -118,7 +118,7 @@ export const VOUCHER_KIND_MAP = {
     },
     nceb: {
         arcaType: 208,
-        displayName: 'Nota de credito electronica B',
+        displayName: 'Nota de crédito electrónica B',
         family: 'nota-credito-electronica',
         isElectronicCredit: true,
         letter: 'b',
@@ -127,7 +127,7 @@ export const VOUCHER_KIND_MAP = {
     },
     ncec: {
         arcaType: 213,
-        displayName: 'Nota de credito electronica C',
+        displayName: 'Nota de crédito electrónica C',
         family: 'nota-credito-electronica',
         isElectronicCredit: true,
         letter: 'c',
@@ -136,7 +136,7 @@ export const VOUCHER_KIND_MAP = {
     },
     ndea: {
         arcaType: 202,
-        displayName: 'Nota de debito electronica A',
+        displayName: 'Nota de débito electrónica A',
         family: 'nota-debito-electronica',
         isElectronicCredit: true,
         letter: 'a',
@@ -145,7 +145,7 @@ export const VOUCHER_KIND_MAP = {
     },
     ndeb: {
         arcaType: 207,
-        displayName: 'Nota de debito electronica B',
+        displayName: 'Nota de débito electrónica B',
         family: 'nota-debito-electronica',
         isElectronicCredit: true,
         letter: 'b',
@@ -154,7 +154,7 @@ export const VOUCHER_KIND_MAP = {
     },
     ndec: {
         arcaType: 212,
-        displayName: 'Nota de debito electronica C',
+        displayName: 'Nota de débito electrónica C',
         family: 'nota-debito-electronica',
         isElectronicCredit: true,
         letter: 'c',
@@ -177,4 +177,3 @@ export function getVoucherKindByArcaType(arcaType) {
 export function isVoucherShortcut(value) {
     return value in VOUCHER_KIND_MAP;
 }
-//# sourceMappingURL=voucher-kind-map.js.map

package/dist/modules/completion/completion.js

@@ -0,0 +1,53 @@
+function resolveValues(values, previousArguments) {
+    if (!values) {
+        return [];
+    }
+    return typeof values === 'function' ? values(previousArguments) : values;
+}
+function findOption(command, word) {
+    return command.options.find((option) => option.flags.includes(word));
+}
+/**
+ * Lo que puede seguir en la linea, segun las palabras escritas despues de `arcli`. La ultima es la que se esta
+ * completando (puede venir vacia). Sin candidatos devuelve una lista vacia y el shell completa rutas de archivo,
+ * que es lo que piden `--cargar` y las rutas de config.
+ */
+export function completeWords(root, words) {
+    const current = words.at(-1) ?? '';
+    const previous = words.slice(0, -1);
+    let command = root;
+    let positionals = [];
+    let pendingOption;
+    for (const word of previous) {
+        if (pendingOption) {
+            pendingOption = undefined;
+            continue;
+        }
+        if (word.startsWith('-')) {
+            const option = findOption(command, word);
+            pendingOption = option?.takesValue ? option : undefined;
+            continue;
+        }
+        const subcommand = positionals.length === 0 ? command.subcommands.find((sub) => sub.name === word) : undefined;
+        if (subcommand) {
+            command = subcommand;
+            positionals = [];
+        }
+        else {
+            positionals.push(word);
+        }
+    }
+    const matches = (candidates) => [...new Set(candidates)].filter((candidate) => candidate.startsWith(current));
+    if (pendingOption) {
+        return matches(resolveValues(pendingOption.values, positionals));
+    }
+    if (current.startsWith('-')) {
+        return matches(command.options
+            .filter((option) => !option.hidden)
+            .flatMap((option) => option.flags.filter((flag) => flag.startsWith('--'))));
+    }
+    return matches([
+        ...(positionals.length === 0 ? command.subcommands.map((sub) => sub.name) : []),
+        ...resolveValues(command.argumentValues[positionals.length], positionals),
+    ]);
+}

package/dist/modules/completion/completion.presenter.js

@@ -0,0 +1,35 @@
+import { noticePanel } from '../../ui/index.js';
+/** `/Users/vos/.zshrc` → `~/.zshrc`, como lo escribe la gente. */
+function displayPath(path, home) {
+    return home && path.startsWith(`${home}/`) ? `~${path.slice(home.length)}` : path;
+}
+function reloadHint(state, home) {
+    return state.shell === 'fish'
+        ? 'Abrí una terminal nueva.'
+        : `Abrí una terminal nueva o corré: source ${displayPath(state.path, home)}`;
+}
+export function formatCompletionStateAsText(state, home) {
+    const where = displayPath(state.path, home);
+    return state.installed
+        ? noticePanel(`Autocompletado instalado para ${state.shell} (${where}).`, 'success')
+        : noticePanel(`Autocompletado no instalado para ${state.shell}. Instalalo con: arcli completado instalar`, 'muted');
+}
+export function formatCompletionResultAsText(result, home) {
+    const where = displayPath(result.path, home);
+    if (!result.changed) {
+        return noticePanel(result.installed
+            ? `El autocompletado ya estaba instalado para ${result.shell} (${where}).`
+            : `El autocompletado no estaba instalado para ${result.shell}.`, 'muted');
+    }
+    return result.installed
+        ? noticePanel(`Autocompletado instalado para ${result.shell} en ${where}.\n${reloadHint(result, home)}`, 'success')
+        : noticePanel(`Autocompletado desinstalado de ${where}.\nEn esta terminal sigue activo hasta cerrarla.`, 'success');
+}
+export function formatCompletionStateAsJson(state) {
+    return JSON.stringify({
+        ...('changed' in state ? { cambio: state.changed } : {}),
+        instalado: state.installed,
+        ruta: state.path,
+        shell: state.shell,
+    }, null, 2);
+}

package/dist/modules/completion/installer.js

@@ -0,0 +1,92 @@
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { basename, dirname, join } from 'node:path';
+import { COMPLETION_SHELLS } from './shell-scripts.js';
+/** Marca lo que agrega arcli, para reconocerlo y sacarlo despues sin tocar nada mas. */
+const MARKER = '# arcli: autocompletado con Tab (se saca con "arcli completado desinstalar")';
+export function currentCompletionEnvironment() {
+    return {
+        home: process.env.HOME ?? '',
+        platform: process.platform,
+        shell: process.env.SHELL,
+        xdgConfigHome: process.env.XDG_CONFIG_HOME,
+        zdotdir: process.env.ZDOTDIR,
+    };
+}
+/** El shell de `$SHELL`, si es uno que arcli sabe completar. */
+export function detectShell(shellPath) {
+    const name = shellPath ? basename(shellPath) : '';
+    return COMPLETION_SHELLS.find((shell) => shell === name);
+}
+/** Donde va el autocompletado: la linea en el rc de bash o zsh, o un archivo propio en fish. */
+export function resolveCompletionPath(shell, environment) {
+    if (shell === 'fish') {
+        return join(environment.xdgConfigHome ?? join(environment.home, '.config'), 'fish', 'completions', 'arcli.fish');
+    }
+    if (shell === 'zsh') {
+        return join(environment.zdotdir ?? environment.home, '.zshrc');
+    }
+    if (environment.platform !== 'darwin') {
+        return join(environment.home, '.bashrc');
+    }
+    // La Terminal de macOS abre bash como login shell: lee el primero que exista de estos. Crear .bash_profile
+    // cuando solo hay .profile haria que bash deje de leer .profile.
+    const loginFiles = ['.bash_profile', '.bash_login', '.profile'].map((name) => join(environment.home, name));
+    return loginFiles.find((path) => existsSync(path)) ?? loginFiles[0];
+}
+function activationLine(shell) {
+    return shell === 'fish'
+        ? 'arcli completado fish | source'
+        : `command -v arcli >/dev/null 2>&1 && eval "$(arcli completado ${shell})"`;
+}
+function readText(path) {
+    return existsSync(path) ? readFileSync(path, 'utf8') : '';
+}
+/** Lo agrego arcli o se agrego a mano: cualquier linea que active `arcli completado <shell>`. */
+function isActivationLine(line, shell) {
+    return line === MARKER || line.includes(`arcli completado ${shell}`);
+}
+export function getCompletionState(shell, environment) {
+    const path = resolveCompletionPath(shell, environment);
+    const installed = readText(path)
+        .split('\n')
+        .some((line) => line !== MARKER && isActivationLine(line, shell) && !line.trimStart().startsWith('#'));
+    return { installed, path, shell };
+}
+export function installCompletion(shell, environment) {
+    const state = getCompletionState(shell, environment);
+    if (state.installed) {
+        return { ...state, changed: false };
+    }
+    const block = `${MARKER}\n${activationLine(shell)}\n`;
+    mkdirSync(dirname(state.path), { recursive: true });
+    if (shell === 'fish') {
+        writeFileSync(state.path, block);
+    }
+    else {
+        const current = readText(state.path);
+        const separator = current === '' ? '' : current.endsWith('\n') ? '\n' : '\n\n';
+        writeFileSync(state.path, `${current}${separator}${block}`);
+    }
+    return { ...state, changed: true, installed: true };
+}
+export function uninstallCompletion(shell, environment) {
+    const state = getCompletionState(shell, environment);
+    const current = readText(state.path);
+    if (!current.includes(MARKER) && !state.installed) {
+        return { ...state, changed: false };
+    }
+    if (shell === 'fish') {
+        rmSync(state.path, { force: true });
+        return { ...state, changed: true, installed: false };
+    }
+    const lines = current.split('\n');
+    const kept = lines.filter((line, index) => {
+        if (isActivationLine(line, shell)) {
+            return false;
+        }
+        // La linea en blanco que se agrego antes del bloque tambien se va.
+        return !(line === '' && lines[index + 1] === MARKER);
+    });
+    writeFileSync(state.path, kept.join('\n'));
+    return { ...state, changed: true, installed: false };
+}