@bongos/core 1.19.1072 → 1.19.1074

package/scripts/gds/box-sync.js

@@ -1,216 +0,0 @@
-#!/usr/bin/env node
-// scripts/gds/box-sync.js — BV1.R96 (goal 1000051): "sync now".
-//
-// Re-run the box's source-fetch ON DEMAND so a freshly-claimed task's code
-// materializes within seconds, instead of waiting for the ~10-min cron (which
-// stays the backstop). Because the box's fetch calls GET /box/source-access —
-// which since BV1.R94 returns the sparse set for the builder's ACTIVE CLAIM
-// (task/module scope, ADR 0148) — re-running it RE-SCOPES the box to whatever the
-// builder just claimed. So `/builder-claim N` then `box-sync` = the box holds
-// exactly task N's module code, seconds later.
-//
-// Runs ON THE BOX, where infra/box-source-fetch.sh lives (it is in the box's BASE
-// sparse set). OFF a box there is no fetch script — the source IS the local
-// checkout — so it says so plainly and exits non-zero rather than failing opaquely.
-//
-// Usage:  node scripts/gds/box-sync.js            # re-fetch now
-//         node scripts/gds/box-sync.js --dry-run  # print what it WOULD run
-//         node scripts/gds/box-sync.js --widen <dir>    # keep <dir> across ticks
-//         node scripts/gds/box-sync.js --unwiden <dir>  # stop keeping it
-//         node scripts/gds/box-sync.js --widen-list     # what is kept, and what is ignored
-//
-// WHY --widen EXISTS (task 1003087 / idea 1000793). `git sparse-checkout add`
-// does not survive: the */10 cron re-applies the SERVER-computed set and deletes
-// the addition, sometimes MID-COMMAND — a live test suite died with
-// MODULE_NOT_FOUND that read exactly like a code bug. --widen records the
-// directory server-side instead, so every fetch (the cron included) returns it
-// in the set and it stops being deleted. It is capped, and it can never widen
-// past what your RANK already reaches — a request outside it is stored but
-// reported as ignored rather than silently applied.
-
-const fs = require('node:fs');
-const path = require('node:path');
-const { spawnSync } = require('node:child_process');
-
-// Reuse box.js's instance-root-first infra resolver (ADR 0150 / R98) so this
-// locates infra/ the SAME way provisioning does — the box's fetch script lives
-// beside the cloud-init template it validates on.
-const { resolveBoxInfraDir } = require('./box.js');
-
-const FETCH_SCRIPT = 'box-source-fetch.sh';
-
-// Absolute path to the box source-fetch script, or null when it can't be found
-// (i.e. not on a box). Pure: opts thread through to resolveBoxInfraDir for tests.
-function resolveFetchScript(opts = {}) {
-  const infraDir = resolveBoxInfraDir(opts);
-  if (!infraDir) return null;
-  const p = path.join(infraDir, FETCH_SCRIPT);
-  try { return fs.existsSync(p) ? p : null; } catch { return null; }
-}
-
-// valueAfter(argv, flag) — the argument following a flag, or null. Kept tiny and
-// pure so the arg handling is testable without spawning anything.
-function valueAfter(argv, flag) {
-  const i = argv.indexOf(flag);
-  if (i < 0) return null;
-  const v = argv[i + 1];
-  return typeof v === 'string' && v && !v.startsWith('--') ? v : null;
-}
-
-// formatWidenReport — PURE. The lines to print for a /box/widen body. Reports
-// IGNORED entries loudly: a widen the server accepted into storage but will not
-// apply (because it is outside your rank scope) looks identical to a working one
-// unless it is said out loud, and a silently-inert widen is exactly the class of
-// bug this whole task is about.
-function formatWidenReport(body) {
-  if (!body || typeof body !== 'object' || Array.isArray(body)) {
-    return ['widen: could not read your widen set.'];
-  }
-  const kept = Array.isArray(body.widen_paths) ? body.widen_paths : [];
-  const ignored = Array.isArray(body.ignored) ? body.ignored : [];
-  const out = [];
-  out.push(kept.length
-    ? `widen: keeping ${kept.length} path(s) across ticks: ${kept.join(', ')}`
-    : 'widen: nothing kept — the fetch set is whatever your claim scope says.');
-  if (ignored.length) {
-    out.push(`widen: IGNORED (outside your rank scope, stored but not applied): ${ignored.join(', ')}`);
-  }
-  return out;
-}
-
-// The --widen family. Talks to the control plane, so it works off a box too —
-// unlike the fetch itself, the widen set is server state you can inspect and
-// edit from anywhere.
-async function runWiden(argv) {
-  const { apiCall } = require('./cli-lib');
-  const add = valueAfter(argv, '--widen');
-  const remove = valueAfter(argv, '--unwiden');
-  const clear = argv.includes('--widen-clear');
-  const listOnly = !add && !remove && !clear;
-
-  const r = listOnly
-    ? await apiCall('GET', '/api/bongos/box/widen')
-    : await apiCall('POST', '/api/bongos/box/widen', {
-      ...(add ? { add: [add] } : {}),
-      ...(remove ? { remove: [remove] } : {}),
-      ...(clear ? { clear: true } : {}),
-    });
-
-  if (!r || (r.status !== 200 && r.status !== 201)) {
-    const code = r && r.data && r.data.error ? r.data.error : `HTTP ${r ? r.status : '?'}`;
-    if (code === 'no_box') {
-      console.error('widen: you have no dev box — there is nothing to widen. Provision one first.');
-    } else if (code === 'bad_widen_path') {
-      const bad = r.data && r.data.rejected ? r.data.rejected.join(', ') : '';
-      console.error(`widen: refused ${bad} — give a repo-relative DIRECTORY (no leading /, no "..").`);
-    } else {
-      console.error(`widen: failed (${code}).`);
-    }
-    return 1;
-  }
-  for (const line of formatWidenReport(r.data)) console.log(line);
-  if (!listOnly) console.log('widen: run `box-sync` (no flags) to apply it to the checkout now.');
-  return 0;
-}
-
-function main(argv = process.argv.slice(2)) {
-  // The widen family is server state, not a fetch — handled before the on-a-box
-  // check, so it works from a laptop too.
-  if (argv.some((a) => a === '--widen' || a === '--unwiden' || a === '--widen-list' || a === '--widen-clear')) {
-    runWiden(argv).then((code) => process.exit(code), () => process.exit(1));
-    return;
-  }
-  const dryRun = argv.includes('--dry-run') || argv.includes('-n');
-  const script = resolveFetchScript();
-  if (!script) {
-    console.error(
-      `sync: no infra/${FETCH_SCRIPT} found. This runs ON a dev box (where the box `
-      + `source-fetch lives). Off a box your source IS your local checkout — nothing to sync.`,
-    );
-    process.exit(1);
-  }
-  if (dryRun) {
-    console.log(`sync [dry-run]: would run  bash ${script}`);
-    console.log('  → re-fetches the sparse checkout for your ACTIVE claim (re-scopes in place).');
-    process.exit(0);
-  }
-  console.log(`sync: re-running ${script} — re-scoping the box to your active claim…`);
-  const r = spawnSync('bash', [script], { stdio: 'inherit' });
-  if (r.error) {
-    console.error(`sync: could not run the fetch (${r.error.message})`);
-    process.exit(1);
-  }
-  if (r.status !== 0) process.exit(r.status == null ? 1 : r.status);
-  console.log('sync: done — your box now holds the code for your active claim.');
-  // Then say WHAT it holds, so a base-only box is visible instead of silent.
-  reportScope().then(() => process.exit(0), () => process.exit(0));
-}
-
-// ---------------------------------------------------------------------------
-// task 1002731 — say what scope the box ACTUALLY got
-// ---------------------------------------------------------------------------
-
-// The failure this exists for is a SILENT one: a box comes up holding only the
-// base slice (no modules/ at all) and nothing anywhere says so. Live, that was
-// 247 of 248 source grants — including an Archon with 7 active claims — and the
-// only way to see it was reading box_events on the control plane. GET /box/scope
-// already returns the resolved decision; nothing ever showed it to a human.
-//
-// PURE so it is unit-testable without a box or a network: takes the /box/scope
-// body, returns the lines to print. null/garbage in → one honest line rather
-// than a crash, because this is diagnostic output on an already-degraded path
-// and must never be the thing that fails.
-function formatScopeReport(scope) {
-  if (!scope || typeof scope !== 'object' || Array.isArray(scope)) {
-    return ['scope: could not read your box scope (GET /box/scope did not answer).'];
-  }
-  const modules = Array.isArray(scope.modules) ? scope.modules : null;
-  const paths = Array.isArray(scope.sparse_paths) ? scope.sparse_paths : [];
-  const out = [];
-
-  if (scope.scope === 'task' && modules && modules.length) {
-    out.push(`scope: task — your box holds ${modules.length} module(s): ${modules.join(', ')}`);
-  } else if (scope.scope === 'base') {
-    out.push('scope: BASE ONLY — your box holds no modules/ code at all.');
-    out.push(scope.task_scope
-      ? '  Why: you hold no active claim, so there is no work to scope the box to.'
-      : '  Why: this instance resolved no claim scope.');
-    out.push('  Fix: claim a task (/builder-claim N), then re-run this sync.');
-  } else if (scope.scope === 'full') {
-    out.push('scope: full — your box holds the whole repo (your rank allows it).');
-    if (modules && modules.length === 0) {
-      // The task-1002729 fallback fired: claims held, but their goals declare no
-      // wall. Worth naming — the box is usable, but task-scoping is doing nothing.
-      out.push('  Note: your claimed work declares no module scope, so this fell back to');
-      out.push("  your rank rather than scoping to the task. Setting the goal's");
-      out.push('  scope_modules would give you a tighter box.');
-    }
-  } else if (scope.scope === 'starter') {
-    out.push('scope: starter — a fixed slice for newcomers, not scoped to your claim.');
-  } else {
-    out.push(`scope: ${String(scope.scope || 'unknown')}`);
-  }
-  if (paths.length) out.push(`  paths: ${paths.length} sparse entr${paths.length === 1 ? 'y' : 'ies'}`);
-  return out;
-}
-
-// Read the resolved scope and print it. Never throws and never changes the exit
-// status — a diagnostic that could fail the sync it reports on would be worse
-// than no diagnostic.
-async function reportScope() {
-  try {
-    const { apiCall } = require('./cli-lib');
-    const r = await apiCall('GET', '/api/bongos/box/scope');
-    if (!r || r.status !== 200) {
-      console.log('scope: could not read your box scope right now (that does not affect the sync above).');
-      return;
-    }
-    for (const line of formatScopeReport(r.data)) console.log(line);
-  } catch (_) {
-    console.log('scope: could not read your box scope right now (that does not affect the sync above).');
-  }
-}
-
-if (require.main === module) main();
-
-module.exports = { resolveFetchScript, FETCH_SCRIPT, formatScopeReport, formatWidenReport, valueAfter };