@tacuchi/updater 2.2.1 → 3.0.1
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.
- package/README.md +48 -2
- package/dist/cli.js +959 -203
- 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
|
-
|
|
42
|
-
|
|
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
|
|