@tacuchi/updater 3.0.0 → 3.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +67 -62
  3. package/dist/cli.js +1379 -1197
  4. package/package.json +11 -2
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Tacuchi
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,94 +1,99 @@
1
1
  # @tacuchi/updater
2
2
 
3
+ > Interfaz de terminal para actualizar gestores de paquetes de macOS, Linux y Windows en un solo flujo.
4
+
3
5
  TUI multiplataforma para actualizar **todos** los gestores de paquetes de tu sistema desde un solo flujo. macOS · Linux · Windows. Sin permisos de administrador (salvo los gestores que los exigen).
4
6
 
7
+ ## Instalación
8
+
9
+ ### Antes de instalar: lo que necesitas
10
+
11
+ Node.js >=18 y npm, según el manifiesto, y los gestores que quieras actualizar.
12
+ La interfaz con teclado requiere una terminal TTY; sin ella, el flujo se confirma automáticamente.
13
+
14
+ ### Instalar el paquete
15
+
16
+ ```sh
17
+ npm install -g @tacuchi/updater
18
+ ```
19
+
20
+ También puedes ejecutarlo sin instalación global:
21
+
5
22
  ```bash
6
23
  npx @tacuchi/updater # ejecutar sin instalar
7
- npx @tacuchi/updater --sudo # incluir gestores que requieren admin (apt, dnf, pacman, snap, choco)
24
+ npx @tacuchi/updater --sudo # macOS/Linux: relanzar con permisos de administrador
8
25
  ```
9
26
 
10
- ## Qué hace
27
+ ### Preparar una copia propia
11
28
 
12
- Un flujo lineal claro: **Detectar → Seleccionar → Confirmar → Actualizar → Resumen**.
29
+ No necesita configurar un servicio. Las preferencias se crean al necesitarlas por primera vez.
30
+ La guía de [preferencias y diagnóstico](docs/config-y-logs.md) explica cómo editarlas.
13
31
 
14
- - Detecta automáticamente los gestores instalados y busca actualizaciones en paralelo.
15
- - Verás spinners mientras trabaja y un resumen inequívoco al terminar (qué se actualizó, qué falló y **por qué**, con la ruta del log).
16
- - Verificación real: cada actualización se confirma re-listando paquetes desactualizados — un fallo nunca se reporta como éxito.
32
+ ### Actualización
17
33
 
18
- ## Gestores soportados (27)
34
+ ```sh
35
+ npm install -g @tacuchi/updater@latest
36
+ ```
19
37
 
20
- - **Sistema**: brew, softwareupdate, apt, dnf, pacman
21
- - **Lenguajes/runtimes**: npm, pnpm, yarn, bun, pip, pipx, conda, gem, composer, angular
22
- - **Apps/tiendas**: winget, choco, flatpak, snap, mas, scoop
23
- - **SDK/toolchains**: rustup, cargo, mise, asdf, flutter, go
38
+ ### Desinstalar
24
39
 
25
- Los gestores que requieren admin (apt, dnf, pacman, snap, choco) se actualizan con `--sudo`; sin permisos muestran el comando manual en vez de fallar en silencio.
40
+ ```sh
41
+ npm uninstall -g @tacuchi/updater
42
+ ```
26
43
 
27
- ## Desarrollo
44
+ La desinstalación del paquete no incluye una rutina para retirar preferencias o registros.
28
45
 
29
- ```bash
30
- npm install
31
- npm run dev # ejecutar sin compilar (tsx)
32
- npm test # vitest
33
- npm run typecheck # tsc --noEmit
34
- npm run build # tsup → dist/cli.js
35
- ```
46
+ ### Plataformas
36
47
 
37
- La arquitectura (motor de ejecución, modelo de descriptores, máquina de estados) está documentada en [`CLAUDE.md`](./CLAUDE.md) y el sistema de diseño en [`docs/DESIGN.md`](./docs/DESIGN.md).
48
+ macOS, Linux y Windows. Cada descriptor declara dónde se ofrece y qué permisos necesita.
49
+ En Windows, `--sudo` no eleva: abre la terminal como Administrador o usa `E` en Confirmar.
38
50
 
39
- ## Config y logs
51
+ ## Uso
40
52
 
41
- El archivo de preferencias **se crea con sus valores por omisión la primera vez que se necesita**, así
42
- que siempre hay algo que leer y editar.
53
+ ### Qué puedes recorrer
43
54
 
44
- | | macOS / Linux | Windows |
45
- |---|---|---|
46
- | Preferencias | `~/.tacuchi-updater/config.json` | `%APPDATA%\tacuchi-updater\config.json` |
47
- | Registros | `~/.tacuchi-updater/logs/` | `%LOCALAPPDATA%\tacuchi-updater\Logs\` |
55
+ Detección con reintento, selección de paquetes, confirmación, actualización y resumen; incluye Ajustes y Detalle.
56
+ La cabecera reúne marca y paso; durante una corrida, Q y Esc preguntan antes de cancelar.
57
+ Ctrl+C cancela y sale de inmediato. La presentación adapta tema, glifos y pistas a la terminal.
58
+ La [guía de uso](docs/uso.md) conserva la lista de 27 gestores y explica los controles y límites.
48
59
 
49
- Campos:
60
+ ### Comandos
50
61
 
51
- | Campo | Por omisión | Qué hace |
52
- |---|---|---|
53
- | `language` | `es` | Idioma de la interfaz (`es` \| `en`). |
54
- | `enabledManagers` | `{}` | Gestores desactivados explícitamente. Lo que no está, está habilitado. |
55
- | `concurrency` | `4` | Gestores actualizados en paralelo (se acota a 1..8). |
56
- | `timeoutsMs` | `{}` | Espera máxima por gestor, en ms. |
57
- | `logTailBytes` | `16384` | Cuánta salida de cada comando se guarda en el registro. |
58
- | `logRetentionRuns` | `30` | Cuántas corridas de registro se conservan. Por **cantidad** y no por antigüedad, porque las corridas llegan en ráfagas. |
59
- | `selfCheck` | `true` | Consultar a npm, **a lo sumo una vez cada 24 h y sin bloquear**, si hay una versión más nueva del updater. Un fallo de red no detiene ni demora la corrida: sólo queda anotado en el registro. |
62
+ ```sh
63
+ updater
64
+ updater --sudo
65
+ updater --yes
66
+ updater --help
67
+ updater --version
68
+ ```
69
+
70
+ `--yes`, `-y`, `--all` o una entrada sin TTY seleccionan y confirman automáticamente.
71
+ Con stdout redirigido, se escriben eventos y resumen por líneas, sin redibujo ni atajos.
72
+ Usa `updater --yes > resultado.txt` para seleccionar y confirmar al redirigir la salida.
73
+ Revisa el resumen: un estado indeterminado puede terminar con código de salida 0.
60
74
 
61
- El registro anota cada sondeo de presencia, cada listado de pendientes y cada comando ejecutado con su
62
- salida, y **termina siempre con una línea de cierre que declara cómo terminó la corrida** — completa,
63
- cancelada, interrumpida, fallida o cedida a una consola elevada.
75
+ ### Desarrollo y comprobaciones
64
76
 
65
- Las señales que se atienden dependen del sistema: `SIGINT` (Ctrl+C), `SIGTERM` y `SIGHUP` en los tres,
66
- más `SIGBREAK` (Ctrl+Break) en Windows, donde existe. Cerrar la ventana de la consola llega como
67
- `SIGHUP` y deja su línea de cierre: se escribe de forma **sincrónica** y **antes** de cancelar la
68
- corrida, así que no gasta el margen que el sistema da antes de matar el proceso. En Windows ese margen
69
- es de **5000 ms** (`SPI_GETHUNGAPPTIMEOUT`) y escribir el cierre mide **0,08 ms**. La verificación corre
70
- en la matriz: el paso *Probe* de `windows-latest` lanza el binario en su propia consola y la cierra.
77
+ La guía de [desarrollo](docs/desarrollo.md) conserva los comandos de instalación, pruebas y construcción.
78
+ La guía de [preferencias y diagnóstico](docs/config-y-logs.md) reúne configuración, registros y señales.
71
79
 
72
- **Límite conocido, y está documentado como imposible, no como pendiente:** cerrar sesión, reiniciar o
73
- apagar Windows **no entrega ninguna señal**. libuv mapea a `SIGHUP` sólo `CTRL_CLOSE_EVENT` e ignora
74
- `CTRL_LOGOFF_EVENT` y `CTRL_SHUTDOWN_EVENT`, y `node.exe` enlaza `user32`, lo que según la
75
- documentación de `SetConsoleCtrlHandler` impide que el manejador se llame para esos dos. Una corrida
76
- terminada por un apagado no deja línea de cierre. Cubrirlo necesitaría un registro que confirme cada
77
- línea, no mejor evidencia.
80
+ ## Cómo funciona
78
81
 
79
- Los registros que sobran y no se pueden retirar se informan con la causa que ese sistema tiene: en
80
- unix es la propiedad del archivo —los dejó una corrida elevada— y viene con el comando que los
81
- retira; en Windows una consola elevada corre como el mismo usuario, así que la propiedad nunca es el
82
- motivo y un rechazo ahí significa que el archivo está bloqueado por otro proceso.
82
+ Un proceso Node.js presenta la interfaz con React e Ink y coordina descriptores de gestores.
83
+ El motor ejecuta comandos locales y compara los pendientes antes y después de actualizar.
84
+ Preferencias y registros quedan en archivos locales; los gestores usan su propia configuración de red.
83
85
 
84
- Las corridas que sobran del límite de retención se retiran al arrancar, y lo que no se pudo retirar se
85
- informa una sola vez.
86
+ ![Diagrama de contexto de system-updater](docs/architecture/context.svg)
86
87
 
87
- Dos variables de entorno mueven esas rutas, y existen para que las pruebas puedan lanzar el binario
88
- real sin tocar tus datos: `TACUCHI_UPDATER_CONFIG_DIR` y `TACUCHI_UPDATER_LOG_DIR`.
88
+ El cuadro completo está en [ARCHITECTURE.md](ARCHITECTURE.md).
89
89
 
90
90
  El script Python original se conserva en `legacy/updater_simple.py` como referencia histórica.
91
91
 
92
+ ## Contribuir
93
+
94
+ Se aceptan issues y pull requests.
95
+ Para trabajar en el código, consulta [desarrollo](docs/desarrollo.md).
96
+
92
97
  ## Licencia
93
98
 
94
- MIT
99
+ [MIT](LICENSE)