@legios/quartermaster 0.1.4 → 0.1.5

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 CHANGED
@@ -116,7 +116,7 @@ multi-perfil en un cálculo, no en una heurística.
116
116
  | **H1** consumo local real | ✅ **número** | [`numeros/h1.json`](numeros/h1.json) — 9 340 requests deduplicados, 2,8 G de tokens en 7 días, 946 ms |
117
117
  | **H2** poll de cuota en vivo | ✅ **número** | [`numeros/h2-endpoint.md`](numeros/h2-endpoint.md) — ejecutado por fin: con 95 min de cache, la sesión estaba **11 puntos** abajo y las semanales 0-2 |
118
118
  | **H3** `--watch` y `--json` | ✅ mecanismo | `make qm`, `qm --json`, `qm --watch`, `qm --umbral=N` |
119
- | **H4** Linux y Windows verificados | 🟨 Linux ✅, Windows ⏳ | [`numeros/h4-linux.md`](numeros/h4-linux.md) |
119
+ | **H4** Linux y Windows verificados | 🟨 Linux ✅, Windows ✅ el CLI · ⏳ la credencial | [`numeros/h4-linux.md`](numeros/h4-linux.md) · [`h4-windows.md`](numeros/h4-windows.md) |
120
120
  | **H8** Codex en la misma tabla | ✅ mecanismo | cuota del disco (rollouts) + refresco por app-server + consumo local; `src/adapters/codex.ts` |
121
121
  | **H5** cuota sin red ni credencial | ✅ **número** | [`numeros/h5-cuota.md`](numeros/h5-cuota.md) · [`h5-cuota.json`](numeros/h5-cuota.json) |
122
122
  | **H6** verlo sin ir a buscarlo | ✅ mecanismo | `make indicador` en GNOME · `make tray` en Windows · `make web` en el navegador · `qm --breve` en la statusline de Claude Code |
@@ -140,9 +140,15 @@ multi-perfil en un cálculo, no en una heurística.
140
140
  - **El número del cache puede estar viejo.** Claude Code lo refresca cuando
141
141
  quiere —medido: reescribió `.claude.json` 19 s antes y el bloque de cuota
142
142
  seguía siendo de hacía 83 minutos—. `qm` imprime la edad siempre.
143
- - **Windows no está verificado.** El adaptador asume
144
- `<directorio>/.credentials.json` igual que Linux. Es posible que Claude Code
145
- use DPAPI o el Credential Manager. Hay que probarlo antes de afirmar nada.
143
+ - **En Windows nativo el CLI anda; la credencial sigue sin verificarse.**
144
+ Medido y comiteado en [`numeros/h4-windows.md`](numeros/h4-windows.md): con
145
+ Node nativo, `qm` contesta `plataforma: win32`, descubre los perfiles en rutas
146
+ de Windows y lee la cuota de Codex del disco sin red ni credencial. Lo que
147
+ sigue abierto es si Claude Code guarda la suya en `.credentials.json` o en
148
+ DPAPI, y **no se pudo contestar porque en esa máquina Claude Code nunca corrió
149
+ nativo**: no está en el PATH, no hay `.claude.json`, y el Credential Manager
150
+ no tiene ninguna entrada de Anthropic. El adaptador sigue diciendo «sin
151
+ verificar» en vez de inventar un diagnóstico.
146
152
  - **macOS va a abrir un prompt del llavero por perfil** si se usa `--refrescar`.
147
153
  El camino por defecto ya no toca el llavero.
148
154
 
@@ -525,6 +531,47 @@ La serie vive en `~/.cache/quartermaster/historial.jsonl` y se indexa por el
525
531
  `medidoEn` de la cuota, no por el momento en que qm miró: leer diez veces el
526
532
  mismo cache deja **una** muestra.
527
533
 
534
+ ## ¿Y cuánto me puedo gastar hoy?
535
+
536
+ La proyección contesta «a este ritmo, cuándo choco». Es la pregunta del que ya
537
+ va rápido. La del que todavía no chocó y quiere no chocar es otra: **cuánto
538
+ puedo gastar por día para que la cuota llegue justa al reinicio, y cuánto de eso
539
+ me queda hoy.** Un 78 % con reinicio el sábado no dice si mañana hay que frenar;
540
+ repartirlo sí, y en la misma unidad que todo lo demás:
541
+
542
+ ```
543
+ presupuesto: podés gastar 4.2 %/día · hoy te queda 1.8 % · weekly_scoped (Fable)
544
+ ```
545
+
546
+ La cuenta es de dos renglones y está en `src/core/presupuesto.ts`:
547
+
548
+ ```
549
+ porDia = (100 − porcentaje) / días hasta el reinicio
550
+ quedaHoy = porDia × (horas que le quedan al día / 24)
551
+ ```
552
+
553
+ Mira **hacia adelante**, y eso es lo que la hace honesta sin historial: todo lo
554
+ que ya gastaste hoy está adentro del porcentaje actual, así que no hay que
555
+ restarlo ni ir a buscarlo a un JSONL que puede no cubrir la medianoche. Si te
556
+ pasaste de rosca a la mañana, `porDia` baja solo en la lectura siguiente y
557
+ `quedaHoy` con él; si no tocaste nada, sube. Nunca da negativo.
558
+
559
+ Dos decisiones que no son obvias:
560
+
561
+ - **Se reparte la ventana larga, no la que frena.** Una de 5 h se reinicia
562
+ cuatro veces por día: «cuánto por día» ahí no quiere decir nada, y un número
563
+ que no quiere decir nada al lado de uno que sí es peor que no mostrarlo.
564
+ - **A menos de una hora del reinicio no se reparte.** Cuatro puntos en veinte
565
+ minutos dan «288 %/día», que es cierto y no le sirve a nadie. A esa altura la
566
+ pregunta ya no es cómo dosificar sino cuánto falta, y ésa la contesta el reloj
567
+ del reinicio, que está al lado.
568
+
569
+ Cuando no se puede repartir sale la frase que dice por qué —«esta cuenta no
570
+ informa una ventana larga que repartir»— y no un cero con cara de dato. Va en las
571
+ cinco pantallas —`qm`, el tablero, la barra de menú de macOS, el panel de GNOME y
572
+ el de la bandeja de Windows—, leyendo el mismo campo `presupuesto` del JSON: acá
573
+ tampoco divide nadie.
574
+
528
575
  ## En el navegador
529
576
 
530
577
  El indicador de GNOME es la respuesta para GNOME. `qm-web` es la misma idea
@@ -538,9 +585,10 @@ qm-web --sin-abrir # sólo imprime la URL
538
585
  ```
539
586
 
540
587
  Muestra, de arriba abajo: **lo primero que te frena** —la peor barra de toda la
541
- máquina, con su cuenta regresiva al reinicio corriendo en vivo y la proyección
542
- si la hay—, y después una tarjeta por perfil con todas sus barras, la edad del
543
- cache, el consumo local de la ventana y el desglose por modelo. Un perfil sin
588
+ máquina, con su cuenta regresiva al reinicio corriendo en vivo, la proyección
589
+ si la hay y el presupuesto del día—, y después una tarjeta por perfil con todas
590
+ sus barras, su presupuesto diario, la edad del cache, el consumo local de la
591
+ ventana y el desglose por modelo. Un perfil sin
544
592
  número muestra la frase que dice por qué, igual que en la terminal.
545
593
 
546
594
  Vale la misma regla que el indicador: **sólo dibuja**. `bin/qm-web` le pide el
@@ -584,6 +632,16 @@ un vistazo, que es lo único que hace la barra de menú.
584
632
  `~` va pegado al número, porque califica a *ese* número: `~37` es «esta sesión
585
633
  es de hace rato».
586
634
 
635
+ Hasta acá este archivo era **el único fuente del repo que no abría ningún
636
+ gate**: `gate-duraciones.py` le extrae una función y compila esa sola, así que
637
+ el resto podía tener un error de sintaxis y el CI pasaba en verde — el mismo
638
+ agujero que tuvieron el indicador de GNOME y la bandeja de Windows, contado dos
639
+ veces más abajo. Ahora `gate-dibujo.sh` le corre `swiftc -parse` desde Ubuntu:
640
+ AppKit es de macOS, pero `-parse` sólo parsea —no carga módulos ni chequea
641
+ tipos—, así que el error más barato de cometer deja de descubrirse recién cuando
642
+ alguien compila en una Mac. Si ese `swiftc` igual no puede, el gate lo dice y se
643
+ saltea; nunca se da por bueno en silencio.
644
+
587
645
  Cuando no entra, la escalera saca primero los glifos y **el número es lo último
588
646
  que se cae**. Antes era al revés y el item quedaba mudo justo en la parte que se
589
647
  viene a mirar: la identidad se recupera del orden y del menú, el número no se
@@ -1057,7 +1115,97 @@ que hacer click en cualquiera abre el panel completo. El anillo quedó para el
1057
1115
 
1058
1116
  **El costo de la tira, dicho de frente:** Windows decide por ícono si va a la
1059
1117
  barra o al desplegable de escondidos, y a los nuevos los manda al desplegable.
1060
- Se arrastra una vez y, por lo del UID, la elección persiste.
1118
+ Se arrastra una vez y, por lo del UID, la elección persiste. **Y ahora avisa
1119
+ cuando pasa**, que es lo que faltaba: un ícono que Windows escondió y un ícono
1120
+ que no arrancó se ven exactamente igual —nada— y eso es la misma clase de
1121
+ silencio que motivó el repo. No se supone: cada item vive en
1122
+ `HKCU\Control Panel\NotifyIconSettings` con un `IsPromoted` que vale 1 si está
1123
+ en la barra, y el UID que lo identifica sale por reflexión del campo privado
1124
+ `id` del `NotifyIcon`. Si ninguno de los nuestros está promovido, va un globo.
1125
+ Es el equivalente de `revisarSiSeVe()` en la barra de macOS, que cubre el mismo
1126
+ problema por el otro lado (la barra llena y la muesca).
1127
+
1128
+ **Un ícono general, y uno por cuenta, y cada uno abre SU panel.** La tira
1129
+ empezó siendo un ícono por cuenta y nada más, y con cuatro cuentas eso deja
1130
+ cuatro cuadraditos que abren los cuatro la misma pantalla: el ícono que
1131
+ clickeaste no quería decir nada. Ahora hay un **ícono general** —la marca de
1132
+ quartermaster, que ya es un manómetro: el arco se llena hasta el peor
1133
+ porcentaje de la máquina y se pinta con el color de ese estado, y la cola en
1134
+ diagonal es lo que lo distingue de un anillo cualquiera— cuyo panel es el de
1135
+ siempre, con todas las cuentas y la cabecera de lo primero que te frena. Y el
1136
+ de cada cuenta abre **esa cuenta sola**.
1137
+
1138
+ **Y se eligen desde el ícono, no desde un flag.** Cuatro cuentas son cuatro
1139
+ cuadraditos, y en una barra de tareas llena eso es una inundación. Cualquiera de
1140
+ los paneles —el general y el de cada cuenta— tiene **«Íconos en la bandeja»**:
1141
+ un tilde por cuenta más el general. Destildar uno lo saca en el acto, sin
1142
+ reiniciar nada, y la elección se guarda en
1143
+ `%LOCALAPPDATA%\quartermaster\iconos.json`.
1144
+
1145
+ **Y el panel no se cierra al tildar.** WinForms cierra el menú al clickear
1146
+ cualquier item, y acá eso es peor que en ningún otro lado: elegir íconos es
1147
+ justamente la tarea en la que uno toca varios seguidos, y cerrar el panel
1148
+ después de cada tilde obliga a reabrirlo una vez por cuenta. Va el mismo
1149
+ mecanismo que «Actualizar ahora» —cancelar el cierre, y sólo para eso— con una
1150
+ diferencia que hay que conocer: los eventos de un `ToolStripDropDown` **no suben**
1151
+ al `ContextMenuStrip`, así que el padre nunca se entera de qué nieto se clickeó.
1152
+ La bandera la prende `AlternarIcono`, que es quien sabe; el que cancela sigue
1153
+ siendo el handler del padre. Y `AlClickear` ahora sólo PRENDE la bandera y nunca
1154
+ la apaga: con un `=` la apagaba justo antes de que el otro handler la mirara.
1155
+
1156
+ Va en TODOS los paneles a propósito: el ícono que sobra suele ser justo el que
1157
+ estás mirando, y si el ajuste viviera sólo en el general, esconder el general te
1158
+ dejaría sin forma de volver atrás. Por lo mismo, **el último no se puede
1159
+ esconder**: una bandeja vacía no es una preferencia, es la herramienta apagada
1160
+ sin decirlo, y desde una bandeja vacía no hay menú desde donde volver a
1161
+ prenderla. Y una cuenta escondida sigue LISTADA en el submenú, destildada, que es
1162
+ lo que permite traerla de vuelta.
1163
+
1164
+ Lo que se guarda es la lista de los ESCONDIDOS y no la de los visibles, y la
1165
+ diferencia importa: guardando los visibles, un perfil que aparece después nacería
1166
+ invisible, y una cuenta que no se ve es exactamente igual a una cuenta que va
1167
+ bien. El silencio otra vez, y encima permanente.
1168
+
1169
+ `-Iconos` sigue existiendo para arrancar con una combinación, separando por coma:
1170
+
1171
+ ```
1172
+ (vacío) lo que el usuario haya elegido; la primera vez, todos
1173
+ general sólo el general, con todas las cuentas adentro
1174
+ main,codex sólo esas dos cuentas, sin general
1175
+ general,codex el general y codex
1176
+ ```
1177
+
1178
+ Siembra la elección **una vez** y después manda el menú: un flag que se impusiera
1179
+ en cada arranque sería un ajuste que se deshace solo, que es peor que no tenerlo.
1180
+
1181
+ El filtro se aplica a la TIRA y no a los paneles: el general sigue mostrando
1182
+ todas las cuentas aunque no tengan ícono propio. Y si `-Iconos` no coincide con
1183
+ nada queda el general igual, diciéndolo — una bandeja vacía sería otra vez el
1184
+ silencio, y encima uno que se causó el usuario con un typo.
1185
+
1186
+ **`-Iconos` es la única forma de sacar uno solo, y conviene decir por qué.**
1187
+ Arrastrar un ícono al desplegable de escondidos, que es lo que uno haría, no
1188
+ funciona de a uno: se llevan todos. La causa se midió y no se supone. Windows
1189
+ identifica un ícono de bandeja por `(ruta del ejecutable, UID)` —o por un
1190
+ `guidItem` propio, si la aplicación se lo da— y los cuatro nuestros salen del
1191
+ mismo `powershell.exe`. Con la bandeja andando y sus cuatro íconos visibles
1192
+ (UID 1, 2, 3 y 4, comprobado por reflexión sobre el campo privado `id` del
1193
+ `NotifyIcon`), `HKCU\Control Panel\NotifyIconSettings` tenía **dos** entradas
1194
+ para esos cuatro íconos: los que no tienen entrada propia no tienen ajuste
1195
+ propio, y la decisión de esconderlos cae sobre la aplicación entera.
1196
+
1197
+ Lo que lo arreglaría de verdad es darle a cada ícono un `guidItem` estable, que
1198
+ es justamente para esto. **`NotifyIcon` de WinForms no lo expone** —se listaron
1199
+ sus campos: hay `icon`, `text`, `id`, `contextMenuStrip`, y ningún `guid`— así
1200
+ que habría que dejar de usarlo y hablar con `Shell_NotifyIcon` directamente, lo
1201
+ que implica reescribir a mano la recepción de los clicks y los globos. No está
1202
+ hecho: es la parte más probada de este archivo y reemplazarla a ciegas sería
1203
+ cambiar un problema de acomodo por uno de funcionamiento.
1204
+
1205
+ Verificado por UI Automation contra el fixture de cinco perfiles: la bandeja
1206
+ queda con `quartermaster · 3 cuenta(s) · lo peor 100%` más `main`, `teams`,
1207
+ `codex`, `bedrock` y `personal`, cada uno con su tooltip; y con
1208
+ `-Iconos general,codex,teams` quedan exactamente tres.
1061
1209
 
1062
1210
  **Y tiene modo oscuro.** El panel era el único de los cuatro renderizadores que
1063
1211
  salía siempre blanco, y la causa es la de arriba: `SystemColors.Menu` no sigue al
@@ -1123,6 +1271,90 @@ aviso incluye el minuto de reinicio, así que una ventana avisa una vez y vuelve
1123
1271
  a avisar recién en la siguiente—. La memoria de avisos vive en
1124
1272
  `%LOCALAPPDATA%\quartermaster\avisados.json`.
1125
1273
 
1274
+ **Y ahora avisa también cuando te liberás**, que era el único aviso que la
1275
+ bandeja no tenía: macOS lo hacía con `revisarLiberadas()` y GNOME con
1276
+ `revisar_liberada()`, y Windows no. Es el aviso que sirve para hacer algo
1277
+ distinto ahora mismo —todos los demás avisan cuando SUBÍS— y es justo el momento
1278
+ en que dejaste de mirar la barra, porque no había nada que mirar. Necesita
1279
+ memoria de la vuelta anterior, porque un 3 % puede ser «recién empezás» o
1280
+ «acabás de salir de estar contra el techo» y la diferencia es todo: se guarda el
1281
+ minuto de reinicio junto al porcentaje en
1282
+ `%LOCALAPPDATA%\quartermaster\previos.json`, y cuando el minuto cambia habiendo
1283
+ estado arriba del 80 %, avisa. No pasa por `avisados.json` a propósito: la
1284
+ condición ya es un flanco, y anotarla ahí la silenciaría para el reinicio
1285
+ siguiente, que es el que sí hay que avisar.
1286
+
1287
+ **Y avisa de TODAS las barras, no sólo de la que frena.** Esto era un bug que
1288
+ sólo se ve comparando los tres renderizadores: la bandeja le pasaba a
1289
+ `RevisarAvisos` una sola ventana —`frena`— y `peor()` en `src/core/tipos.ts`
1290
+ devuelve la más alta, así que con la sesión al 96 % y una semanal al 85 % la
1291
+ bandeja avisaba de la sesión y de la semanal no decía nada. macOS y GNOME
1292
+ siempre recorrieron la lista. Es justo lo contrario del principio de SOUL.md que
1293
+ dice leer todas las barras.
1294
+
1295
+ **Y un candado, que faltaba.** Arrancarla dos veces —el arranque automático más
1296
+ un `make tray` a mano, que es lo más fácil del mundo— dejaba DOS tiras enteras:
1297
+ un ícono por cuenta repetido, los globos por duplicado, y los dos procesos
1298
+ pisándose `avisados.json` y `previos.json`. En GNOME eso lo resuelve un nombre
1299
+ en el bus de sesión (`soy_el_unico()`); acá es un mutex nombrado `Global\`, que
1300
+ tiene la misma propiedad que lo hace servir: si el proceso muere de cualquier
1301
+ forma, Windows lo suelta solo. Un archivo con el PID hay que limpiarlo, y nunca
1302
+ se limpia en el caso que importa. La segunda instancia dice
1303
+ `ya hay una bandeja de quartermaster andando en esta máquina` y se va.
1304
+
1305
+ **Un mapa de bits, un dueño.** Esto costó dos bugs del mismo tipo, los dos con
1306
+ el mismo síntoma —«Parameter is not valid», que es lo que tira GDI+ al dibujar
1307
+ un `Bitmap` ya liberado— y ninguno de los dos se ve leyendo la función donde
1308
+ estaba el error. El primero: al pasar a varios menús, los mapas de bits del tick
1309
+ anterior se liberaban al empezar `Refrescar`, cuando los `PictureBox` de los
1310
+ menús todavía los tenían. El segundo, más fino: `ArmarMenu` dibujaba el pie él
1311
+ mismo, o sea **una vez por menú**, y cada llamada liberaba el que el menú
1312
+ anterior acababa de recibir — con cuatro íconos quedaban tres pies apuntando a
1313
+ una imagen muerta, y el renglón salía en blanco. Medido con una sonda que
1314
+ pregunta por cada imagen de cada menú: **3 muertas por vuelta contra 0** con el
1315
+ arreglo. La regla que quedó es una sola: el que crea un mapa de bits es el que
1316
+ lo libera, y lo libera al final, cuando ningún menú lo mira. `gate-bandeja.ps1`
1317
+ comprueba que `ArmarMenu` no dibuje el pie.
1318
+
1319
+ **Y no muere con un cartel.** Por defecto WinForms le muestra al usuario
1320
+ «Unhandled exception has occurred in your application» y, si aprieta Quit o si
1321
+ el cartel aparece con la pantalla bloqueada, la bandeja desaparece — y un ícono
1322
+ que no está se lee exactamente igual que una cuenta que va bien. Ahora una
1323
+ excepción en el hilo de la interfaz se atrapa, se sigue andando con lo anterior,
1324
+ y se DICE: una línea a stderr siempre y un globo la primera vez. Además todo
1325
+ `Bitmap` se crea con `Lienzo`, que acota las dimensiones a 1 px de piso: un
1326
+ `Bitmap` con un lado en 0 tira literalmente «Parameter is not valid», que era el
1327
+ cartel, y un renglón vacío es mejor que una aplicación cerrada. Que una medida dé
1328
+ 0 sigue siendo un bug, y lo agarra el gate, que mide los píxeles que salen.
1329
+
1330
+ **Y se reinicia sola cuando el archivo cambia debajo.** `git pull` reemplaza el
1331
+ `.ps1` y se va; el proceso que ya está corriendo tiene el guión leído y sigue
1332
+ con el código viejo hasta que alguien lo reinicie a mano, que no lo hace nadie,
1333
+ porque la bandeja es justamente lo que se deja andando y se olvida. Es
1334
+ `vigilar_version()` de GNOME, con dos diferencias: va por **sondeo** y no por
1335
+ `FileSystemWatcher` —el guión puede estar del otro lado del 9P de WSL, donde
1336
+ `FileSystemWatcher` no es confiable, y el tick de 30 s ya está pago— y **parsea
1337
+ la versión nueva antes de saltar**, porque si está rota reiniciar te deja sin
1338
+ bandeja y quedarse con la vieja te deja con una que anda. De yapa, eso resuelve
1339
+ gratis la espera a que el gestor de paquetes termine de escribir: un archivo a
1340
+ medio escribir no parsea.
1341
+
1342
+ Tiene un costo, y conviene saberlo antes de que muerda: **es hostil para quien
1343
+ está editando el archivo.** Cada guardado relanza la bandeja, y la relanza con el
1344
+ trabajo a medio hacer — el parseo previo atrapa un archivo roto, no atrapa uno
1345
+ que parsea y todavía no está terminado, que es la forma normal de un archivo
1346
+ mientras se lo escribe. Para eso está `-SinAutoReinicio`.
1347
+
1348
+ **Y el panel dice de cuándo es el número y cuándo deja de serlo.** Cada cuenta
1349
+ lleva `lecturas: cada ~5m · última hace 2m` —la cadencia MEDIDA, mediana de los
1350
+ huecos del historial, no la que el programa se propone— y el panel entero
1351
+ termina en `próxima lectura en 4m 12s`, que **baja sola** mientras está abierto.
1352
+ Las dos cosas venían del panel de GNOME. La edad del cache se mudó ahí desde el
1353
+ pie de la barra que frena: sola decía la mitad, porque «hace 40 m» es
1354
+ tranquilizador si se lee cada hora y alarmante si se lee cada cinco minutos.
1355
+ El renglón que baja se redibuja solo a él, una vez por segundo y sólo con el
1356
+ panel abierto: el resto no cambió.
1357
+
1126
1358
  Vale la misma regla que las otras dos: **sólo dibuja**. `bin/qm-tray.ps1` le
1127
1359
  pide el JSON a `qm` por stdout y no sabe qué es una credencial ni un endpoint.
1128
1360
  La regla de cuál barra manda no se reimplementa acá: llega resuelta en
@@ -1134,11 +1366,52 @@ lanza `powershell.exe`—; el proceso vive del lado de Windows, así que si cerr
1134
1366
  la terminal el tray sigue. Para sacarlo: «Salir» en su propio menú, o
1135
1367
  `make tray-quitar`, que además borra el atajo del arranque automático.
1136
1368
 
1369
+ **Y por fin tiene un gate.** Era la superficie que más tiempo estuvo sin que la
1370
+ mirara nadie: de las ~1500 líneas de `bin/qm-tray.ps1`, el CI comprobaba **una
1371
+ función** —la escalera de duración, que `gate-duraciones.py` extrae y corre
1372
+ suelta— y todo lo demás pasaba en verde con un error de sintaxis adentro. Es
1373
+ exactamente lo que le pasó a `bin/qm-indicator` antes de que existiera
1374
+ `gate-dibujo.sh`, y está contado ahí mismo: se borró medio archivo y el CI no se
1375
+ enteró, porque el CI ni lo abría.
1376
+
1377
+ Hicieron falta dos cosas. Primero, un **modo captura** (`-Desde` un JSON fijo,
1378
+ `-Captura` un PNG, `-Panel` cuál, `-Oscuro`/`-Claro` qué tema) que dibuja sin
1379
+ bandeja ni bucle de mensajes, usando las mismas funciones que el menú — si
1380
+ dibujara por su cuenta, el gate estaría comprobando un dibujo que nadie ve. Es
1381
+ el equivalente de `--desde`/`--captura` en el indicador de GNOME. Y segundo,
1382
+ `scripts/gate-bandeja.ps1` (`make gate-bandeja`, y un job de `windows-latest` en
1383
+ CI), que comprueba cuatro cosas y **las cuatro se probaron en rojo**:
1384
+
1385
+ 1. que **parsee** — también desde Ubuntu, en `gate-dibujo.sh`, porque un error
1386
+ de sintaxis se descubre recién cuando alguien inicia sesión;
1387
+ 2. que **dibuje**: 340 px de ancho y píxeles adentro, en los dos temas;
1388
+ 3. que **nada se salga de la tarjeta**;
1389
+ 4. que el panel de una cuenta **no sea** el de todas.
1390
+
1391
+ El 3 encontró un bug de verdad la primera vez que corrió. GDI+ no recorta nada
1392
+ cuando se dibuja en un punto —igual que Cairo, y por eso el panel de GNOME tiene
1393
+ su `margen_limpio`— así que con el fixture de nombres largos el nombre del perfil
1394
+ se dibujaba **por encima del borde** del panel y el nombre de la ventana se
1395
+ metía **por debajo del porcentaje**, dejando los dos ilegibles. Ahora todo lo que
1396
+ puede ser largo se recorta con puntos suspensivos, y el porcentaje se dibuja
1397
+ primero para que el nombre se recorte contra el hueco que queda. Eso no se ve
1398
+ leyendo el código; se ve mirando una captura, que es para lo que existe el modo.
1399
+
1137
1400
  **Lo que está verificado y lo que no**, para que esta sección no mienta:
1138
1401
 
1139
1402
  - Verificado en Windows 11 con Windows PowerShell 5.1: arranca, dibuja el menú
1140
1403
  contra los perfiles reales de esta máquina, sobrevive los ticks, sale por
1141
1404
  `make tray-quitar`, y el atajo de arranque lanza un tray que anda.
1405
+ - **Los seis íconos y sus tooltips se verificaron por UI Automation** contra el
1406
+ fixture de cinco perfiles, y el filtro `-Iconos` también. Lo que **no** se
1407
+ pudo probar acá es el click: un `mouse_event` sintético no llega al ícono en
1408
+ este build de Windows 11 —se comprobó corriendo el mismo arnés contra la
1409
+ versión commiteada, que falla igual— así que el wiring se verificó por el
1410
+ otro lado: `-Panel <cuenta>` dibuja lo mismo que arma el menú de esa cuenta, y
1411
+ el gate comprueba que ese panel sea más chico que el general.
1412
+ - **El candado se probó**: la segunda instancia sale sola con su mensaje.
1413
+ - **El aviso de «se liberó» y el de todas-las-barras están probados en la
1414
+ lógica, no en pantalla**, igual que los otros avisos de esta sección.
1142
1415
  - **El panel y los íconos se miraron, no se supusieron.** Los dos se
1143
1416
  renderizaron a PNG con los datos reales; los íconos, además, a los 16×16
1144
1417
  reales y agrandados con vecino más cercano sobre fondo claro y oscuro, que es
@@ -204,6 +204,19 @@ struct Proyeccion {
204
204
  let chocas: Bool
205
205
  }
206
206
 
207
+ /// El presupuesto diario, ya repartido por qm: cuánto se puede gastar por día
208
+ /// para que la ventana larga llegue justa al reinicio, y cuánto de eso queda
209
+ /// hoy. Cuál ventana se reparte lo decide el núcleo —la larga, nunca la de
210
+ /// 5 h—, así que acá no hay ni una división.
211
+ ///
212
+ /// Es un enum y no un par de opcionales porque el caso «no se puede repartir»
213
+ /// tiene que producir una FRASE: un renglón en blanco es el bug que esta
214
+ /// herramienta existe para no cometer.
215
+ enum Presupuesto {
216
+ case reparte(porDia: Double, quedaHoy: Double)
217
+ case no(String)
218
+ }
219
+
207
220
  /// Lo que hay que decir de una cuenta arriba: la sesión de 5 h, la barra que
208
221
  /// frena antes, y dos banderas que NO son lo mismo.
209
222
  ///
@@ -252,6 +265,7 @@ struct PerfilVista {
252
265
  let semanal: Ventana?
253
266
  let edadSegundos: Int?
254
267
  let proyeccion: Proyeccion?
268
+ let presupuesto: Presupuesto?
255
269
  }
256
270
 
257
271
  // Las reglas del núcleo no se reimplementan acá: `qm` manda `mostrar`, `frena`,
@@ -326,6 +340,15 @@ func leer() -> Lectura {
326
340
  techo: techo,
327
341
  chocas: pr["chocasAntesDelReinicio"] as? Bool ?? false)
328
342
  }
343
+ var pre: Presupuesto? = nil
344
+ if let pp = p["presupuesto"] as? [String: Any] {
345
+ if (pp["estado"] as? String) == "ok" {
346
+ pre = .reparte(porDia: pp["porDia"] as? Double ?? 0,
347
+ quedaHoy: pp["quedaHoy"] as? Double ?? 0)
348
+ } else if let motivo = pp["motivo"] as? String {
349
+ pre = .no(motivo)
350
+ }
351
+ }
329
352
  return PerfilVista(
330
353
  producto: p["producto"] as? String ?? "claude",
331
354
  nombre: p["perfil"] as? String ?? "?",
@@ -338,7 +361,8 @@ func leer() -> Lectura {
338
361
  mostrar: mostrar, historia: historia,
339
362
  frena: una("frena"), sesion: una("sesion"), semanal: una("semanal"),
340
363
  edadSegundos: cuota["edadSegundos"] as? Int,
341
- proyeccion: proy)
364
+ proyeccion: proy,
365
+ presupuesto: pre)
342
366
  }
343
367
  return .ok(perfiles)
344
368
  }
@@ -456,6 +480,7 @@ final class VistaCuenta: NSView {
456
480
  private let frase: String?
457
481
  private let ritmo: String?
458
482
  private let ritmoRojo: Bool
483
+ private let presupuesto: String?
459
484
 
460
485
  private static let ANCHO: CGFloat = 340
461
486
  private static let MARGEN: CGFloat = 15
@@ -502,11 +527,28 @@ final class VistaCuenta: NSView {
502
527
  self.ritmoRojo = false
503
528
  }
504
529
 
530
+ // El ritmo dice hacia dónde vas; el presupuesto, a cuánto tendrías que
531
+ // ir para que la cuota llegue al reinicio. Van pegados: son la misma
532
+ // pregunta. Sólo en las cuentas CON número — las otras dibujan su frase
533
+ // y vuelven antes de llegar hasta acá.
534
+ if let pre = p.presupuesto, p.hayNumero {
535
+ switch pre {
536
+ case .reparte(let porDia, let quedaHoy):
537
+ self.presupuesto = String(format: "podés gastar %.1f %%/día · hoy te queda %.1f %%",
538
+ porDia, quedaHoy)
539
+ case .no(let motivo):
540
+ self.presupuesto = "presupuesto: \(motivo)"
541
+ }
542
+ } else {
543
+ self.presupuesto = nil
544
+ }
545
+
505
546
  var alto = VistaCuenta.MARGEN + 16 + 15 + 6
506
547
  alto += CGFloat(barras.count) * VistaCuenta.ALTO_BARRA
507
548
  if historia.count >= 3 { alto += VistaCuenta.ALTO_CURVA }
508
549
  if frase != nil { alto += 34 }
509
550
  if ritmo != nil { alto += 16 }
551
+ if presupuesto != nil { alto += 16 }
510
552
  alto += 12
511
553
  super.init(frame: NSRect(x: 0, y: 0, width: VistaCuenta.ANCHO, height: alto))
512
554
  }
@@ -615,6 +657,11 @@ final class VistaCuenta: NSView {
615
657
  escribir(r, m, y, .systemFont(ofSize: 10.5, weight: ritmoRojo ? .medium : .regular),
616
658
  ritmoRojo ? Nivel.critico.color : .tertiaryLabelColor)
617
659
  }
660
+
661
+ if let pre = presupuesto {
662
+ y -= 16
663
+ escribir(pre, m, y, .systemFont(ofSize: 10.5), .secondaryLabelColor)
664
+ }
618
665
  }
619
666
  }
620
667
 
package/bin/qm-indicator CHANGED
@@ -557,6 +557,18 @@ class VistaCuenta:
557
557
  + (" — antes del reinicio" if choca else ""))
558
558
  self.ritmo_rojo = choca
559
559
 
560
+ # El presupuesto diario: cuánto por día para que la ventana larga
561
+ # llegue entera al reinicio, y cuánto de eso queda hoy. La cuenta
562
+ # —incluido CUÁL ventana se reparte— viene hecha del núcleo.
563
+ self.presupuesto = None
564
+ if self.hay_numero:
565
+ pre = p.get("presupuesto") or {}
566
+ if pre.get("estado") == "ok":
567
+ self.presupuesto = (f"podés gastar {pre.get('porDia', 0):.1f} %/día"
568
+ f" · hoy te queda {pre.get('quedaHoy', 0):.1f} %")
569
+ elif pre.get("motivo"):
570
+ self.presupuesto = f"presupuesto: {pre['motivo']}"
571
+
560
572
  # Cada cuánto se lee ESTA cuenta y cuándo fue la última: la pregunta
561
573
  # «¿este número de cuándo es?» no se contesta con un porcentaje.
562
574
  self.lecturas = None
@@ -583,6 +595,8 @@ class VistaCuenta:
583
595
  alto += self.ALTO_CURVA
584
596
  if self.ritmo:
585
597
  alto += 20
598
+ if self.presupuesto:
599
+ alto += 20
586
600
  if self.lecturas:
587
601
  alto += 17
588
602
  return alto + PAD_TARJETA - 4
@@ -695,9 +709,17 @@ class VistaCuenta:
695
709
  Pango.Weight.MEDIUM if self.ritmo_rojo else Pango.Weight.NORMAL,
696
710
  ancho=ancho, elipsis=True)
697
711
  y += 16
698
- if self.lecturas:
712
+ # El ritmo dice hacia dónde vas; el presupuesto, a cuánto tendrías que
713
+ # ir para que la cuota llegue al reinicio. Van pegados.
714
+ if self.presupuesto:
699
715
  if not self.ritmo:
700
716
  y += 4
717
+ pluma.escribir(ix, y, self.presupuesto, 11, TEMA.secundario,
718
+ ancho=ancho, elipsis=True)
719
+ y += 16
720
+ if self.lecturas:
721
+ if not self.ritmo and not self.presupuesto:
722
+ y += 4
701
723
  pluma.escribir(ix, y, self.lecturas, 10.5, TEMA.terciario, ancho=ancho, elipsis=True)
702
724
  return arriba + alto
703
725