@legios/quartermaster 0.1.3

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 (46) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +1276 -0
  3. package/bin/qm +66 -0
  4. package/bin/qm-barra +63 -0
  5. package/bin/qm-barra.swift +1253 -0
  6. package/bin/qm-indicator +2063 -0
  7. package/bin/qm-tray +41 -0
  8. package/bin/qm-tray.ps1 +1241 -0
  9. package/bin/qm-web +137 -0
  10. package/dist/adapters/cache-cuota.js +45 -0
  11. package/dist/adapters/cache-cuota.js.map +1 -0
  12. package/dist/adapters/cache-endpoint.js +66 -0
  13. package/dist/adapters/cache-endpoint.js.map +1 -0
  14. package/dist/adapters/codex.js +462 -0
  15. package/dist/adapters/codex.js.map +1 -0
  16. package/dist/adapters/credenciales.js +88 -0
  17. package/dist/adapters/credenciales.js.map +1 -0
  18. package/dist/adapters/cuota.js +73 -0
  19. package/dist/adapters/cuota.js.map +1 -0
  20. package/dist/adapters/historial.js +103 -0
  21. package/dist/adapters/historial.js.map +1 -0
  22. package/dist/adapters/opencode.js +214 -0
  23. package/dist/adapters/opencode.js.map +1 -0
  24. package/dist/adapters/transcripciones.js +129 -0
  25. package/dist/adapters/transcripciones.js.map +1 -0
  26. package/dist/adapters/utilizacion.js +151 -0
  27. package/dist/adapters/utilizacion.js.map +1 -0
  28. package/dist/cli/demo-h1.js +60 -0
  29. package/dist/cli/demo-h1.js.map +1 -0
  30. package/dist/cli/preflight.js +39 -0
  31. package/dist/cli/preflight.js.map +1 -0
  32. package/dist/cli/qm.js +779 -0
  33. package/dist/cli/qm.js.map +1 -0
  34. package/dist/core/config.js +63 -0
  35. package/dist/core/config.js.map +1 -0
  36. package/dist/core/perfiles.js +139 -0
  37. package/dist/core/perfiles.js.map +1 -0
  38. package/dist/core/proyeccion.js +83 -0
  39. package/dist/core/proyeccion.js.map +1 -0
  40. package/dist/core/tipos.js +101 -0
  41. package/dist/core/tipos.js.map +1 -0
  42. package/dist/render/barras.js +62 -0
  43. package/dist/render/barras.js.map +1 -0
  44. package/dist/render/tablero.html +664 -0
  45. package/package.json +59 -0
  46. package/src/render/tablero.html +664 -0
package/bin/qm-web ADDED
@@ -0,0 +1,137 @@
1
+ #!/usr/bin/env node
2
+ // qm en el navegador.
3
+ //
4
+ // Es la contraparte de `bin/qm-indicator` para las máquinas sin barra de GNOME:
5
+ // misma regla, sólo dibuja. Le pide el JSON a `qm` por stdout y no sabe qué es
6
+ // una credencial, un llavero ni un endpoint. Si algún día `qm` cambia por
7
+ // dentro, esto no se entera.
8
+ //
9
+ // El servidor escucha sólo en 127.0.0.1: el tablero muestra mails, planes y
10
+ // rutas de casa, y SOUL.md dice que nada sale de la máquina.
11
+ //
12
+ // Es JavaScript común, no TypeScript, y a propósito: así corre con el Node que
13
+ // haya (>= 18) y el requisito de 22.6 queda donde de verdad hace falta, adentro
14
+ // de `qm`, que es quien lee el TypeScript.
15
+
16
+ import http from 'node:http';
17
+ import fs from 'node:fs';
18
+ import path from 'node:path';
19
+ import { execFile } from 'node:child_process';
20
+ import { fileURLToPath } from 'node:url';
21
+
22
+ const AQUI = path.dirname(fileURLToPath(import.meta.url));
23
+ const RAIZ = path.resolve(AQUI, '..');
24
+ // Igual que bin/qm: dist/ si está (el tarball de npm), src/ si no (clone,
25
+ // .deb, brew). El tablero es un archivo estático, así que el build lo copia.
26
+ const PAGINA = [
27
+ path.join(RAIZ, 'dist', 'render', 'tablero.html'),
28
+ path.join(RAIZ, 'src', 'render', 'tablero.html'),
29
+ ].find((p) => fs.existsSync(p)) ?? path.join(RAIZ, 'src', 'render', 'tablero.html');
30
+ const QM = path.join(RAIZ, 'bin', 'qm');
31
+
32
+ const AYUDA = `qm-web · el tablero de quartermaster en el navegador
33
+
34
+ qm-web levanta el tablero y abre el navegador
35
+ qm-web --puerto=N en otro puerto (por defecto 7391)
36
+ qm-web --dias=N ventana del consumo local (por defecto 7)
37
+ qm-web --sin-abrir no abre el navegador, sólo imprime la URL
38
+
39
+ Escucha únicamente en 127.0.0.1. Sólo dibuja: el número lo pone \`qm\`.`;
40
+
41
+ // ── argumentos ──────────────────────────────────────────────────────────
42
+ const opciones = { puerto: 7391, dias: 7, abrir: true };
43
+ for (const a of process.argv.slice(2)) {
44
+ const m = /^--(puerto|dias)=(\d+)$/.exec(a);
45
+ if (m) { opciones[m[1]] = Number(m[2]); continue; }
46
+ if (a === '--sin-abrir') { opciones.abrir = false; continue; }
47
+ if (a === '--ayuda' || a === '-h' || a === '--help') { console.log(AYUDA); process.exit(0); }
48
+ console.error(`no entiendo "${a}".\n\n${AYUDA}`);
49
+ process.exit(2);
50
+ }
51
+
52
+ // ── el único dato: lo que imprime qm --json ─────────────────────────────
53
+ // Una lectura completa tarda ~1 s (lee todas las transcripciones), así que dos
54
+ // pestañas abiertas no disparan dos lecturas: la segunda se cuelga de la
55
+ // primera.
56
+ let enVuelo = null;
57
+
58
+ function estado() {
59
+ if (enVuelo) return enVuelo;
60
+ enVuelo = new Promise((resolver) => {
61
+ execFile(QM, ['--json', `--dias=${opciones.dias}`], { maxBuffer: 32 << 20 }, (err, salida, errSalida) => {
62
+ enVuelo = null;
63
+ if (err && !salida) {
64
+ // Silencio es el bug (SOUL.md): si no hay número, hay una frase.
65
+ resolver({
66
+ ok: false,
67
+ cuerpo: {
68
+ error: 'qm no pudo leer el estado',
69
+ detalle: (errSalida || err.message || '').trim() || 'sin detalle',
70
+ },
71
+ });
72
+ return;
73
+ }
74
+ try {
75
+ resolver({ ok: true, cuerpo: JSON.parse(salida) });
76
+ } catch (e) {
77
+ resolver({
78
+ ok: false,
79
+ cuerpo: { error: 'qm no devolvió JSON', detalle: (errSalida || String(e)).trim().slice(0, 4000) },
80
+ });
81
+ }
82
+ });
83
+ });
84
+ return enVuelo;
85
+ }
86
+
87
+ // ── servidor ────────────────────────────────────────────────────────────
88
+ const servidor = http.createServer(async (pedido, respuesta) => {
89
+ const ruta = (pedido.url || '/').split('?')[0];
90
+
91
+ if (ruta === '/api/estado') {
92
+ const r = await estado();
93
+ respuesta.writeHead(r.ok ? 200 : 503, {
94
+ 'content-type': 'application/json; charset=utf-8',
95
+ 'cache-control': 'no-store',
96
+ });
97
+ respuesta.end(JSON.stringify(r.cuerpo));
98
+ return;
99
+ }
100
+
101
+ if (ruta === '/' || ruta === '/index.html') {
102
+ fs.readFile(PAGINA, (err, buf) => {
103
+ if (err) {
104
+ respuesta.writeHead(500, { 'content-type': 'text/plain; charset=utf-8' });
105
+ respuesta.end(`no encuentro el tablero en ${PAGINA}\n`);
106
+ return;
107
+ }
108
+ respuesta.writeHead(200, { 'content-type': 'text/html; charset=utf-8', 'cache-control': 'no-store' });
109
+ respuesta.end(buf);
110
+ });
111
+ return;
112
+ }
113
+
114
+ respuesta.writeHead(404, { 'content-type': 'text/plain; charset=utf-8' });
115
+ respuesta.end('no hay nada acá\n');
116
+ });
117
+
118
+ servidor.on('error', (e) => {
119
+ if (e.code === 'EADDRINUSE') {
120
+ console.error(`el puerto ${opciones.puerto} ya está ocupado.\n\n qm-web --puerto=${opciones.puerto + 1}\n`);
121
+ process.exit(1);
122
+ }
123
+ throw e;
124
+ });
125
+
126
+ servidor.listen(opciones.puerto, '127.0.0.1', () => {
127
+ const url = `http://127.0.0.1:${opciones.puerto}`;
128
+ console.log(`quartermaster · tablero en ${url}`);
129
+ console.log('sólo en 127.0.0.1 · ctrl-c para salir');
130
+ if (!opciones.abrir) return;
131
+ const abridor = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'explorer' : 'xdg-open';
132
+ execFile(abridor, [url], () => {});
133
+ });
134
+
135
+ for (const senal of ['SIGINT', 'SIGTERM']) {
136
+ process.on(senal, () => { servidor.close(); process.exit(0); });
137
+ }
@@ -0,0 +1,45 @@
1
+ // H5 · la cuota SIN red y SIN credencial.
2
+ //
3
+ // Claude Code guarda en el .claude.json de cada perfil la última respuesta de
4
+ // utilización que recibió, bajo `cachedUsageUtilization`:
5
+ //
6
+ // { "fetchedAtMs": 1788916089239, "accountUuid": "…", "utilization": { … } }
7
+ //
8
+ // Eso convierte el número de cuota en un dato de disco. Importa por tres
9
+ // razones, y la tercera es la que justifica el archivo:
10
+ //
11
+ // 1. No cuesta una llamada de red.
12
+ // 2. No necesita credencial, así que funciona en un perfil con el token
13
+ // vencido — que es EXACTAMENTE el estado en el que la herramienta que
14
+ // motivó este repo se quedaba muda para siempre.
15
+ // 3. Es lo que Claude Code ya está mirando, así que no puede discrepar con
16
+ // lo que el usuario ve adentro de Claude Code.
17
+ //
18
+ // El precio es que es un cache: sólo se refresca cuando ese perfil corre. Por
19
+ // eso `medidoEn` no se negocia y quien muestre esto tiene que mostrar la edad.
20
+ // Un número viejo presentado como actual es la misma mentira que el silencio.
21
+ import { leerConfig } from "../core/perfiles.js";
22
+ import { parsearUtilizacion } from "./utilizacion.js";
23
+ export function cuotaEnCache(perfil) {
24
+ const config = leerConfig(perfil.directorio);
25
+ if (config === null)
26
+ return { estado: 'sin-cache' };
27
+ const cache = config['cachedUsageUtilization'];
28
+ if (typeof cache !== 'object' || cache === null)
29
+ return { estado: 'sin-cache' };
30
+ const c = cache;
31
+ const ms = c['fetchedAtMs'];
32
+ if (typeof ms !== 'number' || !Number.isFinite(ms)) {
33
+ return { estado: 'ilegible', detalle: 'cachedUsageUtilization sin fetchedAtMs' };
34
+ }
35
+ const ventanas = parsearUtilizacion(c);
36
+ if (ventanas.length === 0) {
37
+ const dentro = c['utilization'];
38
+ const claves = Object.keys(dentro ?? {}).slice(0, 8);
39
+ if (claves.length === 0)
40
+ return { estado: 'sin-suscripcion' };
41
+ return { estado: 'ilegible', detalle: `sin barras reconocibles en {${claves.join(', ')}}` };
42
+ }
43
+ return { estado: 'ok', origen: 'cache', medidoEn: new Date(ms), ventanas };
44
+ }
45
+ //# sourceMappingURL=cache-cuota.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cache-cuota.js","sourceRoot":"","sources":["../../src/adapters/cache-cuota.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,EAAE;AACF,8EAA8E;AAC9E,0DAA0D;AAC1D,EAAE;AACF,+EAA+E;AAC/E,EAAE;AACF,yEAAyE;AACzE,wDAAwD;AACxD,EAAE;AACF,qCAAqC;AACrC,0EAA0E;AAC1E,2EAA2E;AAC3E,sDAAsD;AACtD,6EAA6E;AAC7E,oDAAoD;AACpD,EAAE;AACF,8EAA8E;AAC9E,+EAA+E;AAC/E,8EAA8E;AAE9E,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGtD,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC7C,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAEpD,MAAM,KAAK,GAAG,MAAM,CAAC,wBAAwB,CAAC,CAAC;IAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAChF,MAAM,CAAC,GAAG,KAAgC,CAAC;IAE3C,MAAM,EAAE,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC;IAC5B,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;QACnD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,wCAAwC,EAAE,CAAC;IACnF,CAAC;IAED,MAAM,QAAQ,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC;IACvC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC;QAChC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAE,MAAkC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAClF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;QAC9D,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,+BAA+B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IAC9F,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC;AAC7E,CAAC"}
@@ -0,0 +1,66 @@
1
+ // El cache de lo que devolvió el endpoint, escrito por nosotros.
2
+ //
3
+ // Hace falta por una asimetría que H2 dejó a la vista. El número bueno de la
4
+ // sesión sólo sale del endpoint —con 95 minutos de cache la sesión estaba 11
5
+ // puntos abajo, ver numeros/h2-endpoint.md—, pero **ese número no se puede
6
+ // guardar donde Claude Code guarda el suyo**: `.claude.json` es de él, y este
7
+ // repo lee credenciales y configuración, no las escribe. Meterle mano sería
8
+ // competir con sus escrituras por un cache.
9
+ //
10
+ // Así que la lectura fresca se guarda acá, al lado de la de Codex, y `qm` usa
11
+ // la más nueva de las dos: la de Claude Code o la nuestra. La edad se sigue
12
+ // mostrando siempre, venga de donde venga.
13
+ import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
14
+ import { homedir } from 'node:os';
15
+ import { dirname, join } from 'node:path';
16
+ const CACHE = join(homedir(), '.cache', 'quartermaster', 'endpoint.json');
17
+ function leerTodo() {
18
+ try {
19
+ return JSON.parse(readFileSync(CACHE, 'utf8'));
20
+ }
21
+ catch {
22
+ return {};
23
+ }
24
+ }
25
+ /** Guarda una lectura del endpoint. Si no se puede escribir, se pierde la edad y nada más. */
26
+ export function guardarEndpoint(perfil, cuota) {
27
+ if (cuota.estado !== 'ok')
28
+ return;
29
+ try {
30
+ const todo = leerTodo();
31
+ todo[perfil] = {
32
+ medidoEn: cuota.medidoEn.toISOString(),
33
+ ventanas: cuota.ventanas.map((v) => ({ ...v, reinicia: v.reinicia?.toISOString() ?? null })),
34
+ };
35
+ mkdirSync(dirname(CACHE), { recursive: true });
36
+ writeFileSync(CACHE, JSON.stringify(todo));
37
+ }
38
+ catch {
39
+ /* vacío a propósito */
40
+ }
41
+ }
42
+ export function endpointEnCache(perfil) {
43
+ if (!existsSync(CACHE))
44
+ return null;
45
+ const g = leerTodo()[perfil];
46
+ if (g === undefined)
47
+ return null;
48
+ const medidoEn = new Date(g.medidoEn);
49
+ if (Number.isNaN(medidoEn.getTime()))
50
+ return null;
51
+ return {
52
+ estado: 'ok',
53
+ origen: 'endpoint',
54
+ medidoEn,
55
+ ventanas: g.ventanas.map((v) => ({ ...v, reinicia: v.reinicia === null ? null : new Date(v.reinicia) })),
56
+ };
57
+ }
58
+ /** La más nueva de las dos. Ninguna miente mientras se muestre su edad. */
59
+ export function masNueva(a, b) {
60
+ if (b === null || b.estado !== 'ok')
61
+ return a;
62
+ if (a.estado !== 'ok')
63
+ return b;
64
+ return b.medidoEn.getTime() > a.medidoEn.getTime() ? b : a;
65
+ }
66
+ //# sourceMappingURL=cache-endpoint.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cache-endpoint.js","sourceRoot":"","sources":["../../src/adapters/cache-endpoint.ts"],"names":[],"mappings":"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"}