@tacuchi/updater 2.2.1 → 3.0.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 (3) hide show
  1. package/README.md +48 -2
  2. package/dist/cli.js +903 -165
  3. package/package.json +2 -2
package/README.md CHANGED
@@ -38,8 +38,54 @@ La arquitectura (motor de ejecución, modelo de descriptores, máquina de estado
38
38
 
39
39
  ## Config y logs
40
40
 
41
- - Config: `~/.tacuchi-updater/config.json` (idioma, gestores habilitados, concurrencia, timeouts).
42
- - Logs: `~/.tacuchi-updater/logs/` — registra cada comando ejecutado con su salida para diagnosticar fallos.
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.
43
+
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\` |
48
+
49
+ Campos:
50
+
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. |
60
+
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.
64
+
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.
71
+
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.
78
+
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.
83
+
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
+
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`.
43
89
 
44
90
  El script Python original se conserva en `legacy/updater_simple.py` como referencia histórica.
45
91