@legios/quartermaster 0.1.11 → 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.
@@ -17,6 +17,19 @@
17
17
  //
18
18
  // Todo por la API, sin clonar: winget-pkgs son cientos de miles de archivos y
19
19
  // un clone en cada release sería minutos de runner para tocar cuatro YAML.
20
+ //
21
+ // UN SOLO PR MIENTRAS EL PAQUETE NO ESTÉ EN EL CATÁLOGO. Hasta el 2026-09-14
22
+ // cada release abría su propio «New package»: seis PRs abiertos a la vez, de
23
+ // 0.1.6 a 0.1.11, esperando al mismo moderador, con el primero validado desde
24
+ // el día anterior. Un paquete nuevo lo aprueba a mano un moderador voluntario,
25
+ // y seis envíos del mismo paquete son ruido en el repo de otro y un motivo para
26
+ // cerrarlos. Ahora, si hay un PR abierto de este paquete —de la versión que
27
+ // sea—, la release NUEVA se empuja a esa rama y se le cambia el título: el
28
+ // moderador ve un solo envío, siempre con la última versión. Una vez que el
29
+ // paquete está en el catálogo, cada versión va en su PR, que es lo normal ahí.
30
+ //
31
+ // --en-seco ¿el token llega a la org y al fork? No toca nada.
32
+ // --plan además dice qué haría con esta versión. Tampoco toca nada.
20
33
 
21
34
  import { readdirSync, readFileSync } from 'node:fs';
22
35
  import { join } from 'node:path';
@@ -27,17 +40,20 @@ const DIR = process.env.DIR;
27
40
  const ARRIBA = process.env.UPSTREAM ?? 'microsoft/winget-pkgs';
28
41
  const FORK = process.env.FORK ?? 'legiosai/winget-pkgs';
29
42
  const SECO = process.argv.includes('--en-seco');
43
+ const PLAN = process.argv.includes('--plan');
30
44
 
31
45
  // DIR sólo hace falta cuando de verdad se va a mandar algo: --en-seco existe
32
46
  // para poder preguntar «¿este token llega a la organización?» sin haber armado
33
47
  // los manifests, que es lo que hay que poder contestar ANTES de tirar un tag.
34
- for (const [k, v] of Object.entries({ GITHUB_TOKEN: TOKEN, V, ...(SECO ? {} : { DIR }) })) {
48
+ for (const [k, v] of Object.entries({ GITHUB_TOKEN: TOKEN, V, ...(SECO || PLAN ? {} : { DIR }) })) {
35
49
  if (!v) { console.error(`falta ${k}`); process.exit(2); }
36
50
  }
37
51
 
38
52
  const [ORG] = FORK.split('/');
39
- const RAMA = `Legios.Quartermaster-${V}`;
40
- const RUTA = `manifests/l/Legios/Quartermaster/${V}`;
53
+ const PAQUETE = 'Legios.Quartermaster';
54
+ const PREFIJO_RAMA = `${PAQUETE}-`;
55
+ const RUTA_PAQUETE = 'manifests/l/Legios/Quartermaster';
56
+ const RUTA = `${RUTA_PAQUETE}/${V}`;
41
57
 
42
58
  async function api(metodo, ruta, cuerpo) {
43
59
  const r = await fetch(`https://api.github.com/${ruta}`, {
@@ -85,6 +101,7 @@ if (!org.ok) {
85
101
  // ── el fork de la org ─────────────────────────────────────────────────
86
102
  let fork = await api('GET', `repos/${FORK}`);
87
103
  if (!fork.ok) {
104
+ if (PLAN) { console.log(`· --plan: ${FORK} no existe; se forkearía ${ARRIBA} y se abriría un PR nuevo`); process.exit(0); }
88
105
  console.log(`· ${FORK} no existe: forkeando ${ARRIBA} a la organización`);
89
106
  const hecho = await api('POST', `repos/${ARRIBA}/forks`, {
90
107
  organization: ORG, default_branch_only: true,
@@ -104,6 +121,55 @@ if (!fork.datos.permissions?.push) {
104
121
  const base = fork.datos.default_branch;
105
122
  console.log(`· fork: ${FORK} (rama base ${base})`);
106
123
 
124
+ if (SECO) { console.log('· --en-seco: hasta acá llego'); process.exit(0); }
125
+
126
+ // ── qué corresponde: PR nuevo, o el que ya está abierto ───────────────
127
+ // En el catálogo = ya hay una carpeta del paquete en winget-pkgs.
128
+ const catalogo = await api('GET', `repos/${ARRIBA}/contents/${RUTA_PAQUETE}`);
129
+ const enCatalogo = catalogo.ok;
130
+
131
+ /** El PR abierto de este paquete desde el fork, de la versión que sea, o null. */
132
+ async function prAbierto() {
133
+ // Se buscan las ramas del fork y no con la búsqueda de GitHub: el índice de
134
+ // búsqueda tarda minutos en enterarse de un PR cerrado, y acá eso sería
135
+ // empujarle una versión a un PR que ya no existe.
136
+ const ramas = [];
137
+ for (let pagina = 1; pagina <= 10; pagina++) {
138
+ const r = await api('GET', `repos/${FORK}/branches?per_page=100&page=${pagina}`);
139
+ if (!r.ok) morir(`no pude listar las ramas de ${FORK}`, r);
140
+ ramas.push(...r.datos.map((b) => b.name).filter((n) => n.startsWith(PREFIJO_RAMA)));
141
+ if (r.datos.length < 100) break;
142
+ }
143
+ // La más nueva primero: si por algo quedaran dos, se usa la de la última versión.
144
+ ramas.sort((a, b) => b.localeCompare(a, 'en', { numeric: true }));
145
+ for (const rama of ramas) {
146
+ const ps = await api('GET', `repos/${ARRIBA}/pulls?head=${ORG}:${rama}&state=open`);
147
+ if (ps.ok && ps.datos.length > 0) return ps.datos[0];
148
+ }
149
+ return null;
150
+ }
151
+
152
+ // Con el paquete en el catálogo cada versión va en su propio PR; mientras no,
153
+ // se reusa el que esté abierto.
154
+ const abierto = enCatalogo
155
+ ? (await api('GET', `repos/${ARRIBA}/pulls?head=${ORG}:${PREFIJO_RAMA}${V}&state=open`)).datos?.[0] ?? null
156
+ : await prAbierto();
157
+ const RAMA = abierto?.head.ref ?? `${PREFIJO_RAMA}${V}`;
158
+ const titulo = `${enCatalogo ? 'New version' : 'New package'}: ${PAQUETE} version ${V}`;
159
+
160
+ console.log(`· ${PAQUETE} ${enCatalogo ? 'ya está' : 'todavía no está'} en el catálogo de ${ARRIBA}`);
161
+ console.log(abierto
162
+ ? `· PR abierto: #${abierto.number} (${abierto.title}), rama ${RAMA}`
163
+ : '· no hay un PR abierto de este paquete');
164
+
165
+ if (PLAN) {
166
+ console.log(abierto
167
+ ? `· --plan: se empujaría ${V} a ${ORG}:${RAMA} y #${abierto.number} pasaría a llamarse «${titulo}»`
168
+ : `· --plan: se abriría un PR nuevo «${titulo}» desde ${ORG}:${RAMA}`);
169
+ process.exit(0);
170
+ }
171
+
172
+ // ── la rama con los cuatro manifests ──────────────────────────────────
107
173
  // Ponerlo al día con Microsoft antes de ramificar. Sin esto el fork se queda
108
174
  // donde quedó la release anterior y el PR arrastra la diferencia.
109
175
  const aldia = await api('POST', `repos/${FORK}/merge-upstream`, { branch: base });
@@ -111,9 +177,6 @@ console.log(aldia.ok
111
177
  ? `· ${base} al día con ${ARRIBA}: ${aldia.datos.merge_type}`
112
178
  : `· no pude sincronizar ${base} (HTTP ${aldia.estado}); sigo igual`);
113
179
 
114
- if (SECO) { console.log('· --en-seco: hasta acá llego'); process.exit(0); }
115
-
116
- // ── la rama con los cuatro manifests ──────────────────────────────────
117
180
  const ref = await api('GET', `repos/${FORK}/git/ref/heads/${base}`);
118
181
  if (!ref.ok) morir(`no pude leer ${base} del fork`, ref);
119
182
  const shaBase = ref.datos.object.sha;
@@ -131,34 +194,29 @@ for (const f of archivos) {
131
194
  console.log(` · ${f}`);
132
195
  }
133
196
 
197
+ // El árbol sale de la base, no de la rama: si la rama era de otra versión, la
198
+ // carpeta vieja desaparece y el PR queda tocando UN solo manifest, que es lo que
199
+ // pide la checklist de winget-pkgs.
134
200
  const tree = await api('POST', `repos/${FORK}/git/trees`, { base_tree: shaBase, tree: arbol });
135
201
  if (!tree.ok) morir('no pude armar el árbol', tree);
136
202
 
137
203
  const commit = await api('POST', `repos/${FORK}/git/commits`, {
138
- message: `New package: Legios.Quartermaster version ${V}`,
139
- tree: tree.datos.sha, parents: [shaBase],
204
+ message: titulo, tree: tree.datos.sha, parents: [shaBase],
140
205
  });
141
206
  if (!commit.ok) morir('no pude armar el commit', commit);
142
207
 
143
- // force: un rerun del job tiene que poder repetirse sin dejar la rama a medias.
208
+ // force: un rerun del job tiene que poder repetirse sin dejar la rama a medias,
209
+ // y empujar una versión nueva a la rama de otra reemplaza su contenido.
144
210
  let rama = await api('PATCH', `repos/${FORK}/git/refs/heads/${RAMA}`, { sha: commit.datos.sha, force: true });
145
211
  if (!rama.ok) rama = await api('POST', `repos/${FORK}/git/refs`, { ref: `refs/heads/${RAMA}`, sha: commit.datos.sha });
146
212
  if (!rama.ok) morir(`no pude dejar la rama ${RAMA}`, rama);
147
213
  console.log(`· rama ${ORG}:${RAMA} en ${commit.datos.sha.slice(0, 10)}`);
148
214
 
149
215
  // ── el PR ─────────────────────────────────────────────────────────────
150
- // Si ya hay uno abierto con esta misma cabeza, el push de arriba ya lo
151
- // actualizó: abrir otro sería ruido en el repo de otro.
152
- const abiertos = await api('GET', `repos/${ARRIBA}/pulls?head=${ORG}:${RAMA}&state=open`);
153
- if (abiertos.ok && abiertos.datos.length > 0) {
154
- console.log(`::notice::winget: el PR ya estaba abierto y se actualizó: ${abiertos.datos[0].html_url}`);
155
- process.exit(0);
156
- }
157
-
158
216
  const cuerpo = [
159
217
  '## 📖 Description',
160
218
  '',
161
- `New package: **Legios.Quartermaster** version ${V} — a CLI that reports how much`,
219
+ `${enCatalogo ? 'New version' : 'New package'}: **${PAQUETE}** version ${V} — a CLI that reports how much`,
162
220
  'quota is left across every Claude Code profile on the machine, plus Codex and',
163
221
  'opencode. MIT, source at https://github.com/legiosai/quartermaster',
164
222
  '',
@@ -170,9 +228,14 @@ const cuerpo = [
170
228
  ' inno`, `Scope: user`). The Node dependency\'s MSI does, so a machine without',
171
229
  ' Node will see one UAC prompt that is not ours.',
172
230
  '',
231
+ ...(enCatalogo ? [] : [
232
+ 'While this package is waiting for its first review, new releases are pushed',
233
+ 'to this same PR instead of opening another one.',
234
+ '',
235
+ ]),
173
236
  '## ✅ Checklist',
174
237
  '',
175
- '- [ ] Signed the [Contributor License Agreement](https://cla.opensource.microsoft.com)',
238
+ '- [x] Signed the [Contributor License Agreement](https://cla.opensource.microsoft.com)',
176
239
  '',
177
240
  '## 📦 Manifest Checklist',
178
241
  '',
@@ -181,9 +244,31 @@ const cuerpo = [
181
244
  '- [ ] Tested manifest locally with `winget install --manifest <path>`',
182
245
  ].join('\n');
183
246
 
247
+ if (abierto) {
248
+ const antes = abierto.title;
249
+ const cambio = await api('PATCH', `repos/${ARRIBA}/pulls/${abierto.number}`, { title: titulo, body: cuerpo });
250
+ if (!cambio.ok) morir(`empujé ${V} pero no pude renombrar #${abierto.number}`, cambio);
251
+ if (antes !== titulo) {
252
+ // Una línea para el moderador: el PR que estaba mirando cambió de versión.
253
+ await api('POST', `repos/${ARRIBA}/issues/${abierto.number}/comments`, {
254
+ body: `Updated to ${PAQUETE} ${V} (was: “${antes}”). Pushing new releases here instead of opening a new PR.`,
255
+ });
256
+ }
257
+ console.log(`::notice::winget: ${V} empujada al PR que ya estaba abierto — ${abierto.html_url}`);
258
+ process.exit(0);
259
+ }
260
+
184
261
  const pr = await api('POST', `repos/${ARRIBA}/pulls`, {
185
- title: `New package: Legios.Quartermaster version ${V}`,
186
- head: `${ORG}:${RAMA}`, base, body: cuerpo, maintainer_can_modify: true,
262
+ title: titulo, head: `${ORG}:${RAMA}`, base, body: cuerpo, maintainer_can_modify: true,
187
263
  });
188
264
  if (!pr.ok) morir('no pude abrir el PR', pr);
189
265
  console.log(`::notice::winget: PR abierto — ${pr.datos.html_url}`);
266
+
267
+ // El bot del CLA marca cada PR nuevo con Needs-CLA aunque la cuenta ya haya
268
+ // firmado, y no la saca hasta que se le contesta en ESE PR. Pasó en los cinco
269
+ // PRs después del primero. El token es de la cuenta que firmó, así que la
270
+ // respuesta la puede dar el job.
271
+ const cla = await api('POST', `repos/${ARRIBA}/issues/${pr.datos.number}/comments`, {
272
+ body: '@microsoft-github-policy-service agree company="Legios"',
273
+ });
274
+ console.log(cla.ok ? '· CLA: respondido en el PR' : `· CLA: no pude comentar (HTTP ${cla.estado}); hay que hacerlo a mano`);
@@ -300,10 +300,11 @@ td.num { text-align: right; font-variant-numeric: tabular-nums; }
300
300
  <p class="pie-pagina" id="pie">
301
301
  Todo sale del disco de esta máquina: el <code>.claude.json</code> de cada perfil, los rollouts de
302
302
  Codex y la base de sesiones de opencode. Lo único que sale a la red es el refresco de cuota, y
303
- sólo cuando se pide: al mismo lugar al que Claude Code y Codex ya hablan. Las cuentas de opencode
304
- son planes por API key — su porcentaje vive en el endpoint del proveedor, así que acá se muestra
305
- el consumo y se dice por qué no hay barra. <b>Ninguna credencial de opencode se lee.</b>
306
- El tablero escucha sólo en 127.0.0.1.
303
+ sólo cuando se pide: al mismo lugar al que Claude Code, Codex y opencode ya hablan. Las cuentas
304
+ de opencode son planes por API key y su porcentaje vive en el endpoint del proveedor: el de z.ai
305
+ se consulta con <code>--refrescar</code> y queda cacheado, y del resto se muestra el consumo y se
306
+ dice por qué no hay barra. <b>La única credencial de opencode que se lee es la clave de z.ai, y
307
+ sólo para ese pedido.</b> El tablero escucha sólo en 127.0.0.1.
307
308
  </p>
308
309
  </div>
309
310
 
@@ -593,6 +594,10 @@ function tarjeta(p) {
593
594
  </div>
594
595
  </div>
595
596
  <div class="col">${cuerpo}</div>
597
+ ${p.relevancia && p.relevancia.dormida
598
+ ? `<div class="frase">dormida: ${esc((p.relevancia.porque || []).join(' · '))} — sigue acá con todos sus
599
+ números, pero no encabeza y va al final de la lista.</div>`
600
+ : ''}
596
601
  <div class="consumo">
597
602
  <div class="rotulo">consumo local · ${datos.ventanaDias} d</div>
598
603
  ${p.local === null || p.local === undefined
@@ -609,13 +614,16 @@ function tarjeta(p) {
609
614
  }
610
615
 
611
616
  function heroe() {
612
- // Una sola cifra héroe por vista: la barra que te frena primero, en toda la máquina.
613
- let mejor = null;
614
- for (const p of datos.perfiles) {
615
- if (p.cuota.estado !== 'ok') continue;
616
- const v = p.cuota.frena;
617
- if (v && (!mejor || v.porcentaje > mejor.v.porcentaje)) mejor = { p, v };
618
- }
617
+ // Una sola cifra héroe por vista: la barra que te frena primero, en toda la
618
+ // máquina. QUIÉN encabeza lo decide el CLI y llega en `frenaPrimero`: acá
619
+ // había un `for` que se quedaba con el porcentaje más alto, y esa misma
620
+ // elección estaba escrita en las otras cinco pantallas. Seis copias son seis
621
+ // respuestas en cuanto el criterio cambia — y cambió: una cuenta dormida en
622
+ // 100 % ya no encabeza.
623
+ const lider = datos.frenaPrimero;
624
+ const mejor = lider && lider.ventana
625
+ ? { p: datos.perfiles.find((x) => x.perfil === lider.perfil) ?? {}, v: lider.ventana }
626
+ : null;
619
627
  if (!mejor) {
620
628
  return `<div class="heroe"><div class="texto">
621
629
  <div class="rotulo">lo primero que te frena</div>