@legios/quartermaster 0.1.12 → 0.1.13

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
@@ -219,18 +219,27 @@ quota response it got in each profile's `.claude.json`, so quartermaster reads
219
219
  it from disk — which means it still works on a profile whose token expired,
220
220
  the exact state the motivating monitor died in.
221
221
 
222
- The only thing that ever leaves is one request, and only when you ask for it
223
- (`--refrescar`, or `--calentar`, which is what the panels run):
222
+ The only thing that ever leaves is one request per vendor, and only when you ask
223
+ for it (`--refrescar`, or `--calentar`, which is what the panels run):
224
224
 
225
225
  ```
226
226
  GET https://api.anthropic.com/api/oauth/usage
227
+ GET https://api.z.ai/api/monitor/usage/quota/limit # only if you use z.ai
227
228
  ```
228
229
 
229
- Same host Claude Code already talks to, same credential it already stored, with
230
- a 60-second floor. No account, no cloud, no telemetry, and zero runtime
231
- dependencies. **It never refreshes a token** — a locked non-goal, with a test.
230
+ Each one is the same host that vendor's own tool already talks to, with the
231
+ credential it already stored, asking about your own account, with a 60-second
232
+ floor. No account, no cloud, no telemetry, and zero runtime dependencies. **It
233
+ never refreshes a token** — a locked non-goal, with a test.
232
234
 
233
- The full table, and the straight paragraph about that endpoint being
235
+ The z.ai one is the exception to "no credential", and it is worth knowing which
236
+ direction it runs: opencode stores GLM, MiniMax and Kimi plans as API keys, and
237
+ those plans leave no percentage anywhere on disk. The opencode rows therefore
238
+ show what disk can prove — tokens spent, and the reset time a `429` already told
239
+ you — and the percentage only after you ask for it once. It is cached like every
240
+ other number, so the panels get a bar without ever touching the key themselves.
241
+
242
+ The full table, and the straight paragraph about both endpoints being
234
243
  undocumented, are in [`SECURITY.md`](SECURITY.md).
235
244
 
236
245
  ## Package managers
@@ -273,7 +282,8 @@ What each channel needs configured is in
273
282
  src/core/ profiles, types. Knows nothing about keychains or HTTP.
274
283
  src/adapters/ credentials (keychain / file), transcripts (JSONL), quota
275
284
  from the cache (.claude.json) and from the endpoint (HTTP),
276
- Codex (JSON-RPC) and opencode (SQLite).
285
+ Codex (JSON-RPC), opencode (SQLite) and z.ai (HTTP — the
286
+ only file that opens opencode's auth.json).
277
287
  src/cli/ qm, and one demo per milestone.
278
288
  src/render/ bars and formatting for the terminal, and the dashboard.
279
289
  bin/ the launchers — qm (POSIX), qm.cmd + buscar-node.cmd
package/bin/qm CHANGED
@@ -7,7 +7,8 @@
7
7
  # interactivos— el shebang de siempre falla con un error de sintaxis que no le
8
8
  # dice nada a nadie. Así que acá se busca un Node que sirva antes de arrancar.
9
9
  #
10
- # Orden: $QM_NODE, el del PATH, y después las versiones de nvm de mayor a menor.
10
+ # Orden: $QM_NODE, el del PATH, y después lo que hayan guardado los manejadores
11
+ # de versiones —nvm, fnm y volta— de mayor a menor.
11
12
 
12
13
  set -e
13
14
 
@@ -18,19 +19,47 @@ sirve() {
18
19
  }
19
20
 
20
21
  NODO=""
22
+
23
+ # Cada manejador de versiones guarda los Node con una forma distinta:
24
+ #
25
+ # nvm $NVM_DIR/versions/node/v22.22.2/bin/node
26
+ # fnm $FNM_DIR/node-versions/v22.22.2/installation/bin/node
27
+ # volta $VOLTA_HOME/tools/image/node/22.22.2/bin/node
28
+ #
29
+ # Se recorren de mayor a menor VERSIÓN y no alfabéticamente, para que v9 no le
30
+ # gane a v22. La `v` del nombre se saca antes de ordenar porque volta no la
31
+ # pone, y después se prueban las dos formas del nombre.
32
+ #
33
+ # Acá faltaban fnm y volta, y el README decía que estaban. Se notó de la peor
34
+ # manera posible: el indicador de GNOME arranca desde el autostart, que NO tiene
35
+ # el PATH de un shell interactivo —ahí es donde fnm se carga—, así que no
36
+ # encontraba Node, se quedaba mostrando los números de la sesión anterior, y lo
37
+ # único que lo decía era un renglón en el journal.
38
+ buscar_en() {
39
+ raiz=$1
40
+ medio=$2
41
+ [ -d "$raiz" ] || return 1
42
+ for d in $(ls -1 "$raiz" 2>/dev/null | sed 's/^v//' | sort -t. -k1,1n -k2,2n -k3,3n -r); do
43
+ for nombre in "v$d" "$d"; do
44
+ if sirve "$raiz/$nombre$medio"; then
45
+ NODO="$raiz/$nombre$medio"
46
+ return 0
47
+ fi
48
+ done
49
+ done
50
+ return 1
51
+ }
52
+
21
53
  if [ -n "$QM_NODE" ] && sirve "$QM_NODE"; then
22
54
  NODO="$QM_NODE"
23
55
  elif sirve "$(command -v node 2>/dev/null)"; then
24
56
  NODO="$(command -v node)"
25
57
  else
26
- # nvm guarda cada versión en su propio directorio. Se ordena por número de
27
- # versión, no alfabéticamente, para que v9 no le gane a v22.
28
- for d in $(ls -1 "${NVM_DIR:-$HOME/.nvm}/versions/node" 2>/dev/null | sort -t. -k1.2,1n -k2,2n -k3,3n -r); do
29
- if sirve "${NVM_DIR:-$HOME/.nvm}/versions/node/$d/bin/node"; then
30
- NODO="${NVM_DIR:-$HOME/.nvm}/versions/node/$d/bin/node"
31
- break
32
- fi
33
- done
58
+ buscar_en "${NVM_DIR:-$HOME/.nvm}/versions/node" "/bin/node" \
59
+ || buscar_en "${FNM_DIR:-$HOME/.local/share/fnm}/node-versions" "/installation/bin/node" \
60
+ || buscar_en "$HOME/Library/Application Support/fnm/node-versions" "/installation/bin/node" \
61
+ || buscar_en "${VOLTA_HOME:-$HOME/.volta}/tools/image/node" "/bin/node" \
62
+ || true
34
63
  fi
35
64
 
36
65
  # `src/adapters/opencode.ts` usa node:sqlite, que es experimental, así que Node
@@ -56,7 +85,7 @@ if [ -z "$NODO" ]; then
56
85
  echo "qm necesita Node >= 22.6 y no encontré ninguno." >&2
57
86
  echo "Lee TypeScript sin paso de build, y eso recién existe desde 22.6." >&2
58
87
  echo "" >&2
59
- echo " nvm install 22 # o instalá Node 22 como prefieras" >&2
88
+ echo " nvm install 22 # o fnm install 22, o como prefieras" >&2
60
89
  echo " QM_NODE=/ruta/a/node qm # o decile cuál usar" >&2
61
90
  exit 1
62
91
  fi
@@ -370,6 +370,25 @@ struct PerfilVista {
370
370
  let presupuesto: Presupuesto?
371
371
  /// Cuándo se usó por última vez, según qm. Existe también en --breve.
372
372
  let ultimoUso: Date?
373
+ /// Va al final y no encabeza. Lo decide qm; acá sólo se dibuja.
374
+ let dormida: Bool
375
+ /// Por qué, en palabras. Prosa para mostrar, no para parsear.
376
+ let porque: [String]
377
+ }
378
+
379
+ /// Quién frena primero en toda la máquina, ya resuelto por qm.
380
+ ///
381
+ /// Antes esto se decidía acá adentro, recorriendo los perfiles y quedándose con
382
+ /// el `frena` de porcentaje más alto. Era la misma elección escrita seis veces
383
+ /// —una por pantalla— y las seis coincidían sólo por casualidad: el día que el
384
+ /// criterio cambió (una cuenta dormida en 100 % ya no encabeza), cinco se
385
+ /// quedaron con el criterio viejo. CONTRIBUTING.md: una regla que un renderer
386
+ /// reimplementa es un bug del CLI.
387
+ struct Lider {
388
+ let perfil: String
389
+ let ventana: Ventana
390
+ /// true si NO quedaba ninguna despierta: el encabezado es lo único que hay.
391
+ let dormida: Bool
373
392
  }
374
393
 
375
394
  // Las reglas del núcleo no se reimplementan acá: `qm` manda `mostrar`, `frena`,
@@ -388,7 +407,7 @@ func fecha(_ s: Any?) -> Date? {
388
407
 
389
408
  // ── leer a qm ────────────────────────────────────────────────────────────
390
409
  enum Lectura {
391
- case ok([PerfilVista])
410
+ case ok([PerfilVista], Lider?)
392
411
  /// Silencio es el bug: si no hay número, hay una frase.
393
412
  case falla(String)
394
413
  }
@@ -479,9 +498,27 @@ func leer() -> Lectura {
479
498
  edadSegundos: cuota["edadSegundos"] as? Int,
480
499
  proyeccion: proy,
481
500
  presupuesto: pre,
482
- ultimoUso: fecha(p["ultimoUso"]))
501
+ ultimoUso: fecha(p["ultimoUso"]),
502
+ dormida: ((p["relevancia"] as? [String: Any])?["dormida"] as? Bool) ?? false,
503
+ porque: ((p["relevancia"] as? [String: Any])?["porque"] as? [String]) ?? [])
483
504
  }
484
- return .ok(perfiles)
505
+
506
+ var lider: Lider? = nil
507
+ if let l = raiz["frenaPrimero"] as? [String: Any],
508
+ let nombre = l["perfil"] as? String,
509
+ let v = l["ventana"] as? [String: Any] {
510
+ lider = Lider(perfil: nombre,
511
+ ventana: Ventana(clave: v["clave"] as? String ?? "?",
512
+ alcance: v["alcance"] as? String,
513
+ porcentaje: v["porcentaje"] as? Int ?? 0,
514
+ severidad: v["severidad"] as? String ?? "normal",
515
+ activa: v["activa"] as? Bool ?? false,
516
+ reinicia: fecha(v["reinicia"]),
517
+ grupo: v["grupo"] as? String,
518
+ preocupa: v["preocupa"] as? Bool ?? false),
519
+ dormida: (l["dormida"] as? Bool) ?? false)
520
+ }
521
+ return .ok(perfiles, lider)
485
522
  }
486
523
 
487
524
  // ── avisos ───────────────────────────────────────────────────────────────
@@ -521,20 +558,14 @@ final class VistaResumen: NSView {
521
558
  private let nivel: Nivel
522
559
  private let reinicia: Date?
523
560
 
524
- init?(_ perfiles: [PerfilVista]) {
525
- var mejor: (PerfilVista, Ventana, Int)? = nil
526
- var i = 0
527
- for p in perfiles where p.hayNumero {
528
- if let v = p.frena, mejor == nil || v.porcentaje > mejor!.1.porcentaje {
529
- mejor = (p, v, i)
530
- }
531
- i += 1
532
- }
533
- guard let (p, v, _) = mejor else { return nil }
534
- cuenta = corto(p.nombre)
561
+ init?(_ lider: Lider?, _ perfiles: [PerfilVista]) {
562
+ guard let l = lider else { return nil }
563
+ let p = perfiles.first(where: { $0.nombre == l.perfil })
564
+ let v = l.ventana
565
+ cuenta = corto(p?.nombre ?? l.perfil)
535
566
  barra = v.nombre
536
567
  pct = v.porcentaje
537
- nivel = nivelDe(v.porcentaje, preocupa: v.preocupa || (p.proyeccion?.chocas ?? false))
568
+ nivel = nivelDe(v.porcentaje, preocupa: v.preocupa || (p?.proyeccion?.chocas ?? false))
538
569
  reinicia = v.reinicia
539
570
  super.init(frame: NSRect(x: 0, y: 0, width: 340, height: 74))
540
571
  }
@@ -1058,7 +1089,7 @@ final class Barra: NSObject, NSApplicationDelegate {
1058
1089
  item.button?.image = icono("exclamationmark.triangle.fill")
1059
1090
  agregar(menu, porque, activo: false)
1060
1091
 
1061
- case .ok(let perfiles):
1092
+ case .ok(let perfiles, let lider):
1062
1093
  if ultimaFalla != nil { registrar("lectura de qm volvió a andar") }
1063
1094
  ultimaFalla = nil
1064
1095
  vigilar(perfiles)
@@ -1069,7 +1100,7 @@ final class Barra: NSObject, NSApplicationDelegate {
1069
1100
  var iCuenta = 0
1070
1101
  var peorPct = 0
1071
1102
 
1072
- if let resumen = VistaResumen(perfiles) {
1103
+ if let resumen = VistaResumen(lider, perfiles) {
1073
1104
  let fila = NSMenuItem()
1074
1105
  fila.view = resumen
1075
1106
  menu.addItem(fila)
@@ -1092,7 +1123,9 @@ final class Barra: NSObject, NSApplicationDelegate {
1092
1123
  // El `!` no es sólo severidad: también avisa que a este
1093
1124
  // ritmo tocás el techo ANTES del reinicio.
1094
1125
  let chocas = p.proyeccion?.chocas ?? false
1095
- let esLaProyectada = { (v: Ventana) in chocas && v.clave == cual.clave }
1126
+ // Una cuenta dormida no alarma: el «!» avisa de algo que te
1127
+ // va a frenar, y una cuenta que nadie usa no frena nada.
1128
+ let esLaProyectada = { (v: Ventana) in !p.dormida && chocas && v.clave == cual.clave }
1096
1129
 
1097
1130
  let ses = p.sesion
1098
1131
  let sem = p.semanal
@@ -1100,18 +1133,23 @@ final class Barra: NSObject, NSApplicationDelegate {
1100
1133
  piezas.append(Trozo(
1101
1134
  nombre: corto(p.nombre), producto: p.producto, indice: piezas.count,
1102
1135
  sesion: ses?.porcentaje,
1103
- sesionAlerta: ses.map { $0.preocupa || esLaProyectada($0) } ?? false,
1136
+ sesionAlerta: ses.map { !p.dormida && ($0.preocupa || esLaProyectada($0)) } ?? false,
1104
1137
  semanal: sem?.porcentaje,
1105
- semanalAlerta: sem.map { $0.preocupa || esLaProyectada($0) } ?? false,
1138
+ semanalAlerta: sem.map { !p.dormida && ($0.preocupa || esLaProyectada($0)) } ?? false,
1106
1139
  diario: p.presupuesto?.pctDiario,
1107
1140
  viejo: viejo,
1108
1141
  perfil: p.nombre,
1109
1142
  reiniciaSesion: ses?.reinicia,
1110
1143
  reiniciaSemanal: sem?.reinicia,
1111
1144
  ultimoUso: p.ultimoUso))
1112
- peorPct = max(peorPct, cual.porcentaje)
1113
- revisarAvisos(p, visibles)
1114
- revisarLiberadas(p, visibles)
1145
+ // El color del ícono sigue a lo que te frena DE VERDAD: una
1146
+ // cuenta dormida en 100 % dejaba la barra de menú en rojo
1147
+ // permanente por una cuenta que nadie usa.
1148
+ if !p.dormida { peorPct = max(peorPct, cual.porcentaje) }
1149
+ if !p.dormida {
1150
+ revisarAvisos(p, visibles)
1151
+ revisarLiberadas(p, visibles)
1152
+ }
1115
1153
  }
1116
1154
  }
1117
1155
 
package/bin/qm-indicator CHANGED
@@ -690,6 +690,14 @@ class VistaCuenta:
690
690
  + (" · viejo" if edad >= VIEJO_SEGUNDOS else ""))
691
691
  self.lecturas = "lecturas: " + " · ".join(partes) if partes else None
692
692
 
693
+ # Por qué esta cuenta quedó al fondo y no encabeza. El núcleo ya lo
694
+ # resolvió y lo escribió en palabras; acá sólo se dibuja. Una cuenta
695
+ # que cambia de lugar sin decir por qué es indistinguible de un bug.
696
+ rel = p.get("relevancia") or {}
697
+ self.dormida = None
698
+ if rel.get("dormida"):
699
+ self.dormida = "dormida: " + " · ".join(rel.get("porque") or [])
700
+
693
701
  @staticmethod
694
702
  def _ancho_contenido() -> float:
695
703
  return ANCHO_PANEL - 2 * MARGEN - 2 * PAD_TARJETA
@@ -708,6 +716,8 @@ class VistaCuenta:
708
716
  alto += 4 + 16 * len(self.presupuesto)
709
717
  if self.lecturas:
710
718
  alto += 17
719
+ if self.dormida:
720
+ alto += 17
711
721
  return alto + PAD_TARJETA - 4
712
722
 
713
723
  def _curva(self, cr, pluma, caja, color) -> None:
@@ -831,6 +841,11 @@ class VistaCuenta:
831
841
  if not self.ritmo and not self.presupuesto:
832
842
  y += 4
833
843
  pluma.escribir(ix, y, self.lecturas, 10.5, TEMA.terciario, ancho=ancho, elipsis=True)
844
+ y += 17
845
+ if self.dormida:
846
+ if not self.ritmo and not self.presupuesto and not self.lecturas:
847
+ y += 4
848
+ pluma.escribir(ix, y, self.dormida, 10.5, TEMA.terciario, ancho=ancho, elipsis=True)
834
849
  return arriba + alto
835
850
 
836
851
 
@@ -897,21 +912,33 @@ class VistaResumen:
897
912
  self.nivel, self.reinicia = nivel, reinicia
898
913
 
899
914
  @staticmethod
900
- def desde(perfiles: list) -> "VistaResumen | None":
901
- mejor = None
902
- for p in perfiles:
903
- cuota = p.get("cuota") or {}
904
- if cuota.get("estado") != "ok":
905
- continue
906
- v = cuota.get("frena")
907
- if v and (mejor is None or v["porcentaje"] > mejor[1]["porcentaje"]):
908
- mejor = (p, v)
909
- if mejor is None:
915
+ def desde(datos: dict) -> "VistaResumen | None":
916
+ """Lee quién encabeza del JSON. NO lo vuelve a decidir.
917
+
918
+ Acá adentro había un `for` que se quedaba con el `frena` de porcentaje
919
+ más alto. Decía lo mismo que el CLI sólo por casualidad, y dejó de
920
+ decirlo el día que el criterio cambió: una cuenta dormida en 100 % ya no
921
+ encabeza, y esta copia no se había enterado. La misma elección estaba
922
+ escrita seis veces, una por pantalla.
923
+
924
+ CONTRIBUTING.md lo dice así: una regla que un renderer tiene que
925
+ reimplementar es un bug del CLI. Ahora el CLI la emite en
926
+ `frenaPrimero` y esto sólo la busca.
927
+ """
928
+ lider = datos.get("frenaPrimero")
929
+ if not lider:
930
+ return None
931
+ v = lider.get("ventana")
932
+ if not v:
910
933
  return None
911
- p, v = mejor
934
+ # El perfil completo, para la proyección. Si no aparece —no debería—
935
+ # igual se dibuja la cabecera con lo que vino.
936
+ p = next((x for x in datos.get("perfiles", [])
937
+ if x.get("perfil") == lider.get("perfil")), {})
912
938
  proy = p.get("proyeccion")
913
939
  choca = bool(proy and proy.get("estado") == "sube" and proy.get("chocasAntesDelReinicio"))
914
- return VistaResumen(corto(p.get("perfil") or "?"), nombre_ventana(v), v["porcentaje"],
940
+ nombre = p.get("perfil") or lider.get("perfil") or "?"
941
+ return VistaResumen(corto(nombre), nombre_ventana(v), v["porcentaje"],
915
942
  nivel_de(v["porcentaje"], v.get("preocupa", False) or choca),
916
943
  v.get("reinicia"))
917
944
 
@@ -1019,9 +1046,15 @@ def piezas_de(datos, avisar=None) -> list[dict]:
1019
1046
  continue
1020
1047
  proy = p.get("proyeccion")
1021
1048
  chocas = bool(proy and proy["estado"] == "sube" and proy["chocasAntesDelReinicio"])
1022
-
1023
- def alerta(v, _frena=frena, _chocas=chocas) -> bool:
1024
- if not v:
1049
+ # Una cuenta dormida no alarma. El `!` del item y la notificación de
1050
+ # escritorio existen para avisarte de algo que te va a frenar; una
1051
+ # cuenta que nadie usa, en 100 % desde hace semanas, no te frena nada y
1052
+ # el aviso es puro ruido — el mismo ruido que hizo que alguien quisiera
1053
+ # esconderla, que es lo que este repo no quiere que haga falta.
1054
+ dormida = bool((p.get("relevancia") or {}).get("dormida"))
1055
+
1056
+ def alerta(v, _frena=frena, _chocas=chocas, _dormida=dormida) -> bool:
1057
+ if not v or _dormida:
1025
1058
  return False
1026
1059
  return bool(v.get("preocupa")) or (_chocas and v.get("clave") == _frena.get("clave"))
1027
1060
 
@@ -1050,9 +1083,15 @@ def piezas_de(datos, avisar=None) -> list[dict]:
1050
1083
  "ultimo_uso": p.get("ultimoUso"),
1051
1084
  "viejo": (cuota.get("edadSegundos") or 0) >= VIEJO_SEGUNDOS,
1052
1085
  })
1053
- if avisar is not None:
1086
+ if avisar is not None and not dormida:
1054
1087
  # Todas las barras, no sólo la que frena: la semanal puede estar
1055
1088
  # tranquila mientras la de sesión te para, y al revés.
1089
+ #
1090
+ # Salvo si la cuenta está dormida. Una notificación de escritorio
1091
+ # que dice «codex llegó al 95 %» por una cuenta free que nadie toca
1092
+ # hace semanas no avisa de nada: interrumpe. Es el mismo ruido que
1093
+ # hace que alguien termine escondiendo la cuenta, y esconderla es lo
1094
+ # que este cambio existe para que no haga falta.
1056
1095
  avisar(nombre, cuota.get("mostrar") or [], frena, proy, chocas)
1057
1096
  return piezas
1058
1097
 
@@ -1165,7 +1204,7 @@ def modelo_panel(datos):
1165
1204
  i += 1
1166
1205
  if calladas:
1167
1206
  vistas.append(VistaSinCuota(calladas))
1168
- return VistaResumen.desde(perfiles), vistas
1207
+ return VistaResumen.desde(datos), vistas
1169
1208
 
1170
1209
 
1171
1210
  def _pluma_de_medir() -> Pluma:
@@ -2293,8 +2332,12 @@ class Indicador:
2293
2332
  # El nombre alterna igual que el del item: el shell cachea la
2294
2333
  # textura por ruta y si no, muestra el panel de hace un rato.
2295
2334
  destino = self.iconos / f"panel-{self.turno}.png"
2296
- alto = capturar(self.datos, str(destino), self.falta_para_lectura())
2297
- panel = {"panel": str(destino), "panelAncho": ANCHO_PANEL, "panelAlto": alto}
2335
+ # Un nombre propio, y no `alto` otra vez: pisar el parámetro dejaba
2336
+ # escrito que el ICONO de la barra medía lo que mide el PANEL —
2337
+ # 576 px de alto para un dibujo de 22. La extensión le cree al
2338
+ # archivo y arma el item de ese tamaño.
2339
+ alto_panel = capturar(self.datos, str(destino), self.falta_para_lectura())
2340
+ panel = {"panel": str(destino), "panelAncho": ANCHO_PANEL, "panelAlto": alto_panel}
2298
2341
  except (OSError, MemoryError):
2299
2342
  pass # sin panel dibujado la extensión sigue mostrando el item
2300
2343
  try:
@@ -2479,7 +2522,44 @@ EXTENSION_UUID = "quartermaster@legios"
2479
2522
  EXTENSIONES = Path(os.environ.get("XDG_DATA_HOME", str(Path.home() / ".local/share"))) \
2480
2523
  / "gnome-shell" / "extensions"
2481
2524
  #: De dónde sale la extensión: al lado del paquete, sea un clone, el .deb o npm.
2482
- EXTENSION_FUENTE = YO.parent.parent / "extension" / EXTENSION_UUID
2525
+ EXTENSION_RAIZ = YO.parent.parent / "extension"
2526
+
2527
+
2528
+ def fuente_extension() -> Path:
2529
+ """Cuál de las dos copias de la extensión corresponde a este GNOME.
2530
+
2531
+ GNOME 45 cambió la forma de cargar extensiones —módulos ESM y una clase que
2532
+ extiende Extension— y la 43 y la 44 usan `imports.gi` con una función
2533
+ `init()` suelta. No son dos sintaxis que convivan en un archivo, así que el
2534
+ mismo item vive dos veces y acá se elige.
2535
+
2536
+ Importa en Debian 12, que trae la 43 y va a seguir soportada años. Instalar
2537
+ ahí la de 45 deja la extensión en ERROR, el item cae al camino de
2538
+ AppIndicator, y entonces pasan las dos cosas que esta extensión existe para
2539
+ evitar: el medidor entra en una casilla cuadrada de 16 px y se ve minúsculo,
2540
+ y el click se lo queda el menú del shell, que le rompe el agarre al menú de
2541
+ GTK — el panel aparece y desaparece en el mismo instante.
2542
+
2543
+ Se pregunta acá y no en el Makefile porque quien instaló por npm o por apt
2544
+ no tiene un Makefile, que es la misma razón por la que la instalación entera
2545
+ se mudó a este archivo. Sin poder saber la versión se elige la nueva, que es
2546
+ la que corresponde a todo lo que no sea Debian estable.
2547
+ """
2548
+ vieja = EXTENSION_RAIZ / "gnome43" / EXTENSION_UUID
2549
+ if _shell_es_vieja() and vieja.is_dir():
2550
+ return vieja
2551
+ return EXTENSION_RAIZ / EXTENSION_UUID
2552
+
2553
+
2554
+ def _shell_es_vieja() -> bool:
2555
+ """GNOME 44 o anterior. False si no se puede saber."""
2556
+ try:
2557
+ dicho = subprocess.run(["gnome-shell", "--version"], capture_output=True,
2558
+ text=True, timeout=5, check=True).stdout
2559
+ except (OSError, subprocess.SubprocessError):
2560
+ return False
2561
+ numeros = "".join(c if c.isdigit() else " " for c in dicho).split()
2562
+ return bool(numeros) and int(numeros[0]) <= 44
2483
2563
 
2484
2564
 
2485
2565
  def _habilitadas() -> list[str] | None:
@@ -2511,15 +2591,16 @@ def instalar_extension() -> int:
2511
2591
  esconder: decir «listo» de algo que no se ve hasta cerrar sesión es
2512
2592
  exactamente la mentira que este programa no comete.
2513
2593
  """
2514
- if not EXTENSION_FUENTE.is_dir():
2515
- print(f"no encuentro la extensión en {EXTENSION_FUENTE}", file=sys.stderr)
2594
+ fuente = fuente_extension()
2595
+ if not fuente.is_dir():
2596
+ print(f"no encuentro la extensión en {fuente}", file=sys.stderr)
2516
2597
  return 1
2517
2598
  destino = EXTENSIONES / EXTENSION_UUID
2518
2599
  try:
2519
2600
  EXTENSIONES.mkdir(parents=True, exist_ok=True)
2520
2601
  if destino.exists():
2521
2602
  shutil.rmtree(destino)
2522
- shutil.copytree(EXTENSION_FUENTE, destino)
2603
+ shutil.copytree(fuente, destino)
2523
2604
  except OSError as e:
2524
2605
  print(f"no pude copiarla a {destino}: {e}", file=sys.stderr)
2525
2606
  return 1