arcli 2.2.0 → 2.2.1

package/CHANGELOG.md

@@ -8,6 +8,20 @@ El formato sigue [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/) y e
 
 ## [Sin publicar]
 
+## [2.2.1] - 2026-11-03
+
+Corrige `arcli pdf instalar` en Windows y suma lo necesario para recibir contribuciones: plantillas de issue y de PR, código de conducta, Discussions para preguntas, y un CI que también corre en Windows, macOS y Node 26. No cambian comandos, flags, claves de config ni el `--json`.
+
+### Corregido
+
+- **`arcli pdf instalar` en Windows:** la descarga del navegador pasaba por `cmd.exe`, que corta las rutas con espacios (como `C:\Users\Nombre Apellido`), y fallaba. Ahora la shell se usa solo para correr `npm.cmd`.
+
+### Documentación
+
+- El README explica cómo instalar con pnpm y Yarn además de npm, cómo probarlo con `npx` y cómo actualizar, y suma las secciones "Ayuda y soporte" (preguntas en [Discussions](https://github.com/LcsGrz/arcli/discussions), bugs en issues) y "Estabilidad" (qué es contrato público y qué puede cambiar entre versiones).
+- Plantillas de issue y de PR, y [código de conducta](CODE_OF_CONDUCT.md).
+- El CI corre también en Windows, macOS y Node 26.
+
 ## [2.2.0] - 2026-11-02
 
 Trae la factura de exportación `E` (`arcli fe`) sobre WSFEX: items, país de destino, incoterm y permisos de embarque, con credenciales propias para `wsfex`, PDF con el diseño de exportación y modo interactivo. Es todo agregado: los comandos y flags de A, B, C y FCE siguen igual. Gracias a [Manuel Aller](https://github.com/itManuel), que la trajo en [#67](https://github.com/LcsGrz/arcli/pull/67).
@@ -388,7 +402,8 @@ Primera versión publicada en npm.
 - `llms.txt`: referencia condensada para que un agente de IA con acceso a terminal ejecute el CLI.
 - Publicación con npm Trusted Publishers (OIDC).
 
-[Sin publicar]: https://github.com/LcsGrz/arcli/compare/v2.2.0...HEAD
+[Sin publicar]: https://github.com/LcsGrz/arcli/compare/v2.2.1...HEAD
+[2.2.1]: https://github.com/LcsGrz/arcli/compare/v2.2.0...v2.2.1
 [2.2.0]: https://github.com/LcsGrz/arcli/compare/v2.1.0...v2.2.0
 [2.1.0]: https://github.com/LcsGrz/arcli/compare/v2.0.0...v2.1.0
 [2.0.0]: https://github.com/LcsGrz/arcli/compare/v1.8.0...v2.0.0

package/README.md

@@ -26,12 +26,23 @@ CLI para previsualizar y emitir comprobantes electrónicos de ARCA (ex AFIP) des
 
 ## Instalación
 
-Requiere Node.js 22.22.1 o superior.
+Requiere Node.js 22.22.1 o superior. Si no lo tenés, bajá la versión LTS de [nodejs.org](https://nodejs.org/es/download): trae `npm`.
 
 ```bash
 npm install -g arcli
 ```
 
+También con otros gestores de paquetes:
+
+```bash
+pnpm add -g arcli
+yarn global add arcli   # Yarn 1; Yarn 2 o superior no instala paquetes globales
+```
+
+Para probarlo sin instalar nada: `npx arcli --ayuda`.
+
+Para actualizar, repetí la instalación con `arcli@latest` (por ejemplo, `npm install -g arcli@latest`). Funciona en macOS, Linux y Windows.
+
 Opcional: autocompletado con Tab de comandos, flags y valores, en bash, zsh o fish. Se instala con `arcli completado instalar` y se saca con `arcli completado desinstalar` ([detalle](docs/cli-reference.md#autocompletado)).
 
 ## Configuración
@@ -95,9 +106,27 @@ yarn dev --ayuda
 
 Antes de abrir un PR: `yarn typecheck`, `yarn lint` y `yarn test`. Más en la [guía de desarrollo](https://github.com/LcsGrz/arcli/blob/main/docs/development.md) y la [arquitectura](https://github.com/LcsGrz/arcli/blob/main/docs/architecture.md).
 
+## Ayuda y soporte
+
+- **Preguntas y dudas de uso** (configuración, certificados, cómo facturar algo): [GitHub Discussions](https://github.com/LcsGrz/arcli/discussions).
+- **Bugs y propuestas**: [issues](https://github.com/LcsGrz/arcli/issues/new/choose), con las plantillas.
+- **Vulnerabilidades**: en privado, como dice [SECURITY.md](https://github.com/LcsGrz/arcli/blob/main/SECURITY.md).
+
+Antes de preguntar, puede que ya esté en [Troubleshooting](https://github.com/LcsGrz/arcli/blob/main/docs/troubleshooting.md). No pegues certificados, claves, tickets ni la salida de `--bruto` en ningún lado.
+
+## Estabilidad
+
+ARCLI usa [versionado semántico](https://semver.org/lang/es/). Son contrato público, y solo cambian de forma incompatible en una versión mayor y avisándolo en el [CHANGELOG](https://github.com/LcsGrz/arcli/blob/main/CHANGELOG.md):
+
+- los comandos y sus flags,
+- las claves de configuración,
+- el JSON de entrada (`--cargar`) y de salida (`--json`), incluidos los `codigo` de error.
+
+La salida en texto (tablas, mensajes, colores) es para leer, no para parsear, y puede cambiar en cualquier versión. Para scripts, usá `--json`.
+
 ## Contribuir
 
-Leé [CONTRIBUTING.md](https://github.com/LcsGrz/arcli/blob/main/CONTRIBUTING.md). Para vulnerabilidades, ver [SECURITY.md](https://github.com/LcsGrz/arcli/blob/main/SECURITY.md); no subas certificados, claves ni tokens reales a issues ni PRs.
+Leé [CONTRIBUTING.md](https://github.com/LcsGrz/arcli/blob/main/CONTRIBUTING.md) y el [código de conducta](https://github.com/LcsGrz/arcli/blob/main/CODE_OF_CONDUCT.md). Para vulnerabilidades, ver [SECURITY.md](https://github.com/LcsGrz/arcli/blob/main/SECURITY.md); no subas certificados, claves ni tokens reales a issues ni PRs.
 
 ## Agradecimientos
 

package/dist/cli/version.js

@@ -1 +1 @@
-export const CLI_VERSION = '2.2.0';
+export const CLI_VERSION = '2.2.1';

package/dist/services/pdf/pdf-plugin.js

@@ -11,8 +11,10 @@ export const PDF_PLUGIN_VERSION = '0.2.1';
 export const NPM_INSTALL_TIMEOUT_MS = 5 * 60_000;
 export const BROWSER_DOWNLOAD_TIMEOUT_MS = 15 * 60_000;
 export const runProcessWithSpawn = (command, args, options) => new Promise((resolve) => {
-    // En Windows npm es un .cmd y necesita shell.
-    const child = spawn(command, args, { cwd: options.cwd, env: options.env, shell: process.platform === 'win32' });
+    // En Windows npm es un .cmd y necesita shell. Solo ese caso: con shell, una ruta con espacios (node.exe en
+    // C:\Program Files) se corta en el espacio.
+    const shell = process.platform === 'win32' && /\.(cmd|bat)$/i.test(command);
+    const child = spawn(command, args, { cwd: options.cwd, env: options.env, shell });
     let output = '';
     const timer = setTimeout(() => {
         child.kill();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arcli",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "description": "CLI para previsualizar y emitir comprobantes ARCA desde terminal, con validaciones claras y salida lista para automatizar",
   "keywords": [
     "arca",