@legios/quartermaster 0.1.3 → 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.
@@ -0,0 +1,72 @@
1
+ // postinstall: en macOS, deja la barra de menú andando y arrancando sola.
2
+ //
3
+ // Por qué existe: `npm install -g` dejaba el CLI en el PATH y NINGUNA señal
4
+ // visible. La barra es lo que uno mira sin ir a buscarlo —el punto entero del
5
+ // programa— y venía dentro del paquete sin que nada la arrancara ni la pusiera
6
+ // en el PATH. Quien instalaba por npm en macOS instalaba y no pasaba nada.
7
+ //
8
+ // ESTE SCRIPT NUNCA FALLA UNA INSTALACIÓN. Sale 0 pase lo que pase: un
9
+ // postinstall que rompe `npm install` por no poder dibujar un ícono es un trato
10
+ // pésimo. Si algo no sale, lo dice y sigue.
11
+ //
12
+ // Y no corre donde no corresponde: sólo macOS, sólo instalación global, nunca
13
+ // en CI, nunca como root. Un contenedor de build no quiere un agente de launchd.
14
+ import { execFileSync, spawn } from 'node:child_process';
15
+ import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
16
+ import { homedir, platform } from 'node:os';
17
+ import { dirname, join } from 'node:path';
18
+ import { fileURLToPath } from 'node:url';
19
+
20
+ const RAIZ = join(dirname(fileURLToPath(import.meta.url)), '..');
21
+ const ETIQUETA = 'com.legios.quartermaster.barra';
22
+ const PLIST = join(homedir(), 'Library', 'LaunchAgents', `${ETIQUETA}.plist`);
23
+ const BARRA = join(RAIZ, 'bin', 'qm-barra');
24
+
25
+ const saltar = (motivo) => {
26
+ // En silencio: no es un error, es que acá no va.
27
+ if (process.env['QM_DEBUG_POSTINSTALL']) console.log(`qm: sin barra (${motivo})`);
28
+ process.exit(0);
29
+ };
30
+
31
+ try {
32
+ if (platform() !== 'darwin') saltar('no es macOS');
33
+ if (process.env['npm_config_global'] !== 'true') saltar('no es una instalación global');
34
+ if (process.env['CI']) saltar('CI');
35
+ if (typeof process.getuid === 'function' && process.getuid() === 0) saltar('root');
36
+ if (!existsSync(BARRA)) saltar('no está bin/qm-barra');
37
+
38
+ mkdirSync(dirname(PLIST), { recursive: true });
39
+ writeFileSync(
40
+ PLIST,
41
+ `<?xml version="1.0" encoding="UTF-8"?>
42
+ <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
43
+ <plist version="1.0"><dict>
44
+ <key>Label</key><string>${ETIQUETA}</string>
45
+ <key>ProgramArguments</key><array><string>${BARRA}</string></array>
46
+ <key>RunAtLoad</key><true/>
47
+ <key>KeepAlive</key><false/>
48
+ </dict></plist>
49
+ `,
50
+ 'utf8',
51
+ );
52
+
53
+ // unload primero: si ya había una apuntando al checkout viejo, queda colgada.
54
+ try {
55
+ execFileSync('launchctl', ['unload', PLIST], { stdio: 'ignore' });
56
+ } catch {
57
+ /* no estaba cargada */
58
+ }
59
+ execFileSync('launchctl', ['load', PLIST], { stdio: 'ignore' });
60
+
61
+ // launchd la arranca por RunAtLoad, pero la PRIMERA vez tiene que compilar el
62
+ // Swift y eso tarda. Se lanza también en paralelo y desasociada, así que el
63
+ // ícono aparece durante el install y no varios segundos después.
64
+ spawn(BARRA, [], { detached: true, stdio: 'ignore' }).unref();
65
+
66
+ console.log('qm: barra de menú instalada — arranca sola al iniciar sesión');
67
+ console.log(' sacarla: launchctl unload ' + PLIST);
68
+ } catch (e) {
69
+ console.log(`qm: no pude dejar la barra andando (${e && e.message ? e.message : e}).`);
70
+ console.log(' el CLI quedó bien: probá `qm`. La barra: `qm-barra`.');
71
+ }
72
+ process.exit(0);
@@ -0,0 +1,20 @@
1
+ // Guarda de versión. Es .cjs a propósito: tiene que poder correr en el Node
2
+ // que el usuario tenga, incluso uno que no entienda TypeScript ni ESM moderno.
3
+ //
4
+ // Sin esto, en Node 20 todo comando de este repo muere con
5
+ // node: bad option: --experimental-strip-types
6
+ // que no le dice a nadie qué hacer. Un error opaco es la misma clase de bug
7
+ // que un monitor mudo (ver SOUL.md).
8
+
9
+ var partes = process.versions.node.split('.').map(Number);
10
+ var mayor = partes[0] || 0;
11
+ var menor = partes[1] || 0;
12
+
13
+ if (mayor < 22 || (mayor === 22 && menor < 6)) {
14
+ process.stderr.write(
15
+ '\nquartermaster necesita Node >= 22.6 (tenés ' + process.versions.node + ').\n' +
16
+ 'Lee TypeScript directamente, sin paso de build, y eso recién existe desde 22.6.\n\n' +
17
+ ' nvm install 22 && nvm use 22\n\n',
18
+ );
19
+ process.exit(1);
20
+ }
@@ -4,6 +4,10 @@
4
4
  <meta charset="utf-8">
5
5
  <meta name="viewport" content="width=device-width, initial-scale=1">
6
6
  <title>quartermaster</title>
7
+ <!-- El mismo medidor al que le falta un cuarto que es docs/favicon.svg, acá
8
+ adentro: qm-web sirve UN archivo y nada más, así que un <link> a un .svg
9
+ del repo daría 404 en toda instalación que no sea el clon. -->
10
+ <link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 64 64'><defs><linearGradient id='qm' gradientUnits='userSpaceOnUse' x1='14' y1='46' x2='50' y2='14'><stop offset='0' stop-color='%232fbf71'/><stop offset='.5' stop-color='%23f2b134'/><stop offset='1' stop-color='%23e2483d'/></linearGradient></defs><path d='M32 11A21 21 0 1 1 13.9 43' fill='none' stroke='url(%23qm)' stroke-width='11' stroke-linecap='round'/><path d='M41 41 52 52' fill='none' stroke='url(%23qm)' stroke-width='11' stroke-linecap='round'/></svg>">
7
11
  <style>
8
12
  /* ── Tokens ───────────────────────────────────────────────────────────────
9
13
  Paleta de estado fija (good/warning/serious/critical): el color nunca va
@@ -73,10 +77,8 @@ header.barra {
73
77
  padding: 28px 0 20px; border-bottom: 1px solid var(--linea); margin-bottom: 28px;
74
78
  }
75
79
  .marca { font-size: 15px; font-weight: 620; letter-spacing: -0.01em; }
76
- .marca .punto {
77
- display: inline-block; width: 7px; height: 7px; border-radius: 50%;
78
- background: var(--acento); margin-right: 8px; vertical-align: 1px;
79
- }
80
+ .marca { display: flex; align-items: center; gap: 8px; }
81
+ .marca .logo { flex: none; display: block; }
80
82
  .lema { color: var(--tinta-3); font-size: 13px; }
81
83
  .barra .derecha { margin-left: auto; display: flex; align-items: center; gap: 10px; }
82
84
  .chip {
@@ -177,6 +179,25 @@ button.chip:focus-visible { outline: 2px solid var(--acento); outline-offset: 2p
177
179
  color: var(--tinta-3); margin-top: 2px; }
178
180
  .heroe .detalle .choque { color: var(--critico); font-weight: 550; }
179
181
 
182
+ /* ── Presupuesto diario ───────────────────────────────────────────────── */
183
+ .presupuesto {
184
+ display: flex; align-items: baseline; gap: 6px 18px; flex-wrap: wrap;
185
+ border-top: 1px solid var(--linea); padding-top: 11px; font-size: 12.5px;
186
+ color: var(--tinta-2);
187
+ }
188
+ .presupuesto .par { display: inline-flex; align-items: baseline; gap: 6px; }
189
+ .presupuesto .k {
190
+ font-size: 11px; letter-spacing: .07em; text-transform: uppercase;
191
+ color: var(--tinta-3); font-weight: 600;
192
+ }
193
+ .presupuesto .v {
194
+ font-size: 15px; font-weight: 640; color: var(--tinta);
195
+ font-variant-numeric: tabular-nums; letter-spacing: -0.015em;
196
+ }
197
+ .presupuesto .ventana { color: var(--tinta-3); }
198
+ .presupuesto .motivo { color: var(--tinta-3); }
199
+ .heroe .presupuesto { border-top: none; padding-top: 12px; }
200
+
180
201
  /* ── Frase: todo estado sin número produce una oración ────────────────── */
181
202
  .frase {
182
203
  font-size: 13px; color: var(--tinta-2); background: var(--sup-2);
@@ -239,7 +260,15 @@ td.num { text-align: right; font-variant-numeric: tabular-nums; }
239
260
  <div class="envoltorio">
240
261
  <header class="barra">
241
262
  <div>
242
- <div class="marca"><span class="punto"></span>quartermaster</div>
263
+ <div class="marca">
264
+ <svg class="logo" viewBox="0 0 64 64" width="18" height="18" aria-hidden="true">
265
+ <defs><linearGradient id="grad-qm" gradientUnits="userSpaceOnUse" x1="14" y1="46" x2="50" y2="14">
266
+ <stop offset="0" stop-color="#2fbf71"/><stop offset=".5" stop-color="#f2b134"/><stop offset="1" stop-color="#e2483d"/>
267
+ </linearGradient></defs>
268
+ <circle cx="32" cy="32" r="20" fill="none" stroke="currentColor" stroke-opacity=".14" stroke-width="9"/>
269
+ <path d="M32 12A20 20 0 1 1 14.8 42" fill="none" stroke="url(#grad-qm)" stroke-width="9" stroke-linecap="round"/>
270
+ <path d="M41 41 51.5 51.5" fill="none" stroke="url(#grad-qm)" stroke-width="9" stroke-linecap="round"/>
271
+ </svg>quartermaster</div>
243
272
  <div class="lema">Cuánta cuota te queda, en todas tus cuentas de agentes.</div>
244
273
  </div>
245
274
  <div class="derecha">
@@ -447,6 +476,37 @@ function curva(historia, nivel) {
447
476
  </div>`;
448
477
  }
449
478
 
479
+ // ── presupuesto diario ─────────────────────────────────────────────────
480
+ // «vas 78 %» no dice si mañana hay que frenar. Repartir lo que queda entre los
481
+ // días que faltan sí, y eso llega masticado del núcleo: qué ventana se reparte
482
+ // —la larga, nunca la de 5 h—, cuánto por día y cuánto de eso queda hoy. Acá no
483
+ // se divide nada, igual que con `frena` y `semanal`.
484
+ const unDecimal = (n) => Number(n).toFixed(1).replace('.', ',');
485
+
486
+ function presupuesto(pre) {
487
+ if (!pre) return '';
488
+ if (pre.estado !== 'ok') {
489
+ return `<div class="presupuesto">
490
+ <span class="k">presupuesto diario</span>
491
+ <span class="motivo">${esc(pre.motivo)}</span>
492
+ </div>`;
493
+ }
494
+ const tip = esc(JSON.stringify({
495
+ t: 'presupuesto diario · ' + pre.barra,
496
+ l: [
497
+ `queda ${unDecimal(pre.restante)} % de la ventana y faltan ${unDecimal(pre.horasRestantes / 24)} días para el reinicio`,
498
+ `gastando ${unDecimal(pre.porDia)} % por día llegás justo al reinicio con la cuota consumida`,
499
+ `hoy le quedan ${unDecimal(pre.horasHoy)} h: de ahí sale el ${unDecimal(pre.quedaHoy)} % que te queda hoy`,
500
+ 'se recalcula en cada lectura: si hoy gastaste de más, el ritmo baja solo',
501
+ ],
502
+ }));
503
+ return `<div class="presupuesto" data-tip='${tip}'>
504
+ <span class="par"><span class="k">podés gastar</span><span class="v">${unDecimal(pre.porDia)} %/día</span></span>
505
+ <span class="par"><span class="k">te queda hoy</span><span class="v">${unDecimal(pre.quedaHoy)} %</span></span>
506
+ <span class="ventana">${esc(pre.barra)}</span>
507
+ </div>`;
508
+ }
509
+
450
510
  function desglose(porModelo) {
451
511
  const pares = Object.entries(porModelo).filter(([, v]) => v > 0).sort((a, b) => b[1] - a[1]);
452
512
  if (!pares.length) return '';
@@ -482,7 +542,8 @@ function tarjeta(p) {
482
542
  ? `<div class="medidores">${vs.map(v => medidor(v, proy, proyectada !== null && v.clave === proyectada.clave)).join('')}</div>` +
483
543
  (p.proyeccion && p.proyeccion.estado !== 'sube'
484
544
  ? `<div class="frase">ritmo: ${p.proyeccion.estado === 'plano'
485
- ? 'plano, no sube' : 'todavía no sé el ritmo — ' + esc(p.proyeccion.motivo)}</div>` : '')
545
+ ? 'plano, no sube' : 'todavía no sé el ritmo — ' + esc(p.proyeccion.motivo)}</div>` : '') +
546
+ presupuesto(p.presupuesto)
486
547
  : `<div class="frase">${esc(c.frase)}</div>`;
487
548
 
488
549
  return `
@@ -560,6 +621,7 @@ function heroe() {
560
621
  ${proy ? `<span class="sep">·</span><span class="${proy.chocasAntesDelReinicio ? 'choque' : ''}">${esc(fraseProy(proy))}</span>` : ''}
561
622
  </div>
562
623
  ${curva(p.cuota.historia, n)}
624
+ ${p.presupuesto && p.presupuesto.estado === 'ok' ? presupuesto(p.presupuesto) : ''}
563
625
  </div>
564
626
  </div>`;
565
627
  }