@bongos/core 1.19.804 → 1.19.805

package/modules/sessions/pollers/session-upload-health.js

@@ -0,0 +1,111 @@
+'use strict';
+
+// modules/sessions/pollers/session-upload-health.js — the half of task 1003865
+// that makes the signal NOTICE rather than merely be answerable.
+//
+// GET /sessions/upload-health makes the outage visible to anyone who asks. Nobody
+// asked for weeks, which is the whole incident: the failure mode is silence, and a
+// number you have to go and look at is silent too. So this sweep asks on a
+// schedule and writes the answer where the server's own operator surface already
+// is — the process log, beside the reward reconciler's lines, which is what a
+// journalctl over this unit is read for.
+//
+// SEPARATE FROM session-reward-reconcile ON PURPOSE. That poller MOVES MONEY; this
+// one only reports. Folding telemetry into the payout sweep would let a bad read
+// here delay or crash a booking there, and the two want different cadences —
+// reward recovery wants minutes, a 14-day coverage ratio does not change in ten.
+//
+// It writes nothing and books nothing. A check that could itself change state
+// would need its own safety argument; this one needs none.
+
+const db = require('../db');
+const uploadHealth = require('../upload-health');
+// The doorway's namespaced structured logger (task 1003130), not console: this
+// module reaches the kernel only through module-api, and console.* in a server
+// path is the count the fitness ratchet exists to shrink, not to grow.
+const api = require('../../../src/module-api');
+const log = api.logger('sessions');
+
+// Hourly. The measurement behind the thresholds used a 14-day lookback stepped
+// daily, so anything under a day is already far finer than the signal; hourly is
+// chosen so a fresh outage surfaces within the same working session rather than
+// the next morning.
+const INTERVAL_MS = Number(process.env.SESSION_UPLOAD_HEALTH_MS) || 60 * 60_000;
+const FIRST_SWEEP_DELAY_MS = Number(process.env.SESSION_UPLOAD_HEALTH_FIRST_MS) || 120_000;
+
+let intervalTimer = null;
+let firstTimer = null;
+
+// logLinesFor — PURE, so the wording is pinned by a DB-free test. A log line that
+// says "unhealthy" and no more is the same silence with a timestamp on it: the
+// firing line has to name the builder, the arithmetic, and where to look next,
+// because the person reading it at 2am did not scope this task.
+function logLinesFor(health) {
+  const v = (health && health.verdict) || {};
+  const where = `GET /api/gds/sessions/upload-health?days=${health && health.days}`;
+  if (!v.firing) {
+    return [`[session-upload-health] ${v.status || 'unknown'} — ${v.reason || 'no reason given'}`];
+  }
+  const lines = [
+    `[session-upload-health] ALERT — ${v.reason}`,
+    `[session-upload-health]   a missing session record means no session.token_reward booked (ADR 0146: cost-plus is the only reward stream), so this is unpaid shipped work, not just missing telemetry.`,
+    `[session-upload-health]   look: ${where}  ·  likely cause: the upload skipping client-side (session-upload-skips.jsonl on that builder's machine).`,
+  ];
+  const sample = Array.isArray(health.sample) ? health.sample.slice(0, 5) : [];
+  if (sample.length > 0) {
+    lines.push(`[session-upload-health]   uncovered ships, newest first: ${sample.map((s) => `#${s.id}`).join(' ')}`);
+  }
+  return lines;
+}
+
+async function runSweep() {
+  const health = await db.sessionUploadHealth({
+    days: uploadHealth.DEFAULT_LOOKBACK_DAYS,
+    windowHours: uploadHealth.DEFAULT_WINDOW_HOURS,
+  });
+  const lines = logLinesFor(health);
+  // A firing sweep goes out at ERROR so it survives a level filter set to hide
+  // the hourly all-clear — the whole failure mode here is a signal nobody saw.
+  const write = health.verdict && health.verdict.firing ? log.error : log.info;
+  for (const line of lines) write(line);
+  return health;
+}
+
+// Start the periodic sweep. Idempotent (a second call is a no-op). Kill-switched
+// by SESSION_UPLOAD_HEALTH_DISABLED=1. Timers are unref'd so they never hold the
+// process open on a systemd restart (the session-reward-reconcile precedent).
+function start() {
+  if (process.env.SESSION_UPLOAD_HEALTH_DISABLED === '1') {
+    log.info('[session-upload-health] disabled (SESSION_UPLOAD_HEALTH_DISABLED=1)');
+    return;
+  }
+  if (intervalTimer) return; // already started
+
+  const tick = () => {
+    runSweep().catch((e) =>
+      log.error(e, '[session-upload-health] sweep crashed')
+    );
+  };
+
+  firstTimer = setTimeout(tick, FIRST_SWEEP_DELAY_MS);
+  if (firstTimer.unref) firstTimer.unref();
+  intervalTimer = setInterval(tick, INTERVAL_MS);
+  if (intervalTimer.unref) intervalTimer.unref();
+
+  log.info(
+    `[session-upload-health] started — checking session-upload coverage every ${Math.round(INTERVAL_MS / 60_000)}m`
+  );
+}
+
+function stop() {
+  if (firstTimer) {
+    clearTimeout(firstTimer);
+    firstTimer = null;
+  }
+  if (intervalTimer) {
+    clearInterval(intervalTimer);
+    intervalTimer = null;
+  }
+}
+
+module.exports = { start, stop, runSweep, logLinesFor, INTERVAL_MS };

package/modules/sessions/pulse.js

@@ -21,7 +21,7 @@
 //    rows as data; a follow-up task is expected to add the marker
 //    column + UPDATE write + builder surface in /builder-start.
 //
-// 2. POST /api/gds/pulse route is NOT wired here — routes.js is out
+// 2. POST /api/bongos/pulse route is NOT wired here — routes.js is out
 //    of touches[]. recordPulse() is exported for whichever future
 //    request handler is created. The CLI shell at scripts/gds/pulse.js
 //    posts to the intended endpoint and will start working once the
@@ -29,7 +29,7 @@
 //
 // Follow-up work (file new tasks when picked up):
 //   a) New migration adding claims.pulse_lost_at timestamptz.
-//   b) Route: POST /api/gds/pulse → recordPulse() (auth + claim
+//   b) Route: POST /api/bongos/pulse → recordPulse() (auth + claim
 //      ownership check).
 //   c) sweepStaleClaims() side-effect: UPDATE claims
 //      SET pulse_lost_at = now() WHERE id = ANY(...).

package/modules/sessions/routes/sessions.js

@@ -6,6 +6,11 @@
 //   POST /sessions          — upload your OWN session digest (6D.1). Owner is
 //                             forced to the caller; body builder_id is ignored.
 //   GET  /sessions/mine     — your own sessions (self-serve summary list).
+//   GET  /sessions/upload-health
+//                           — is the corpus still being written? Ships whose
+//                             builder uploaded no session around them, per
+//                             builder (task 1003865). Same cross-builder gate +
+//                             audit as /search, because it reads the same corpus.
 //   GET  /sessions/search   — cross-builder search over session + builder facets
 //                             (rank/karma/drachmae/tenure). Archon-gated +
 //                             audited (the BFG principal posture until 6C.1).
@@ -36,6 +41,11 @@ const db = require('../db');
 // the interaction profile as data precisely so it does not have to require
 // builder-settings, which ADR 0083 forbids.
 const { scoreAccessibility } = require('../accessibility');
+// The PURE clamps behind /sessions/upload-health. The route audits the values it
+// will actually query with, not the raw query string — an audit row naming
+// `days=99999` for a read that ran at 365 is a record of something that did not
+// happen (task 1003865).
+const uploadHealth = require('../upload-health');
 const seams = api; // resolveOptional('reward' | 'builder-settings') — kernel-mediated ports
 const { validateOrRespond, parseId } = api;
 
@@ -358,6 +368,42 @@ module.exports = function buildSessionsRouter() {
     }
   });
 
+  // GET /sessions/upload-health — the answer to "has anyone's session upload
+  // silently stopped?", which before task 1003865 existed ONLY as a jsonl file on
+  // the builder's own laptop. A skipped upload means no session_records row, which
+  // means the ADR 0146 cost-plus reward never books — a builder earning nothing for
+  // work that shipped, invisible from here.
+  //
+  // Read-only and side-effect-free, so it is DELIBERATELY not a new permission:
+  // it reads the same corpus /sessions/search reads, for the same cross-builder
+  // audience, so it rides the same `session.search` gate and writes the same
+  // fail-closed audit row. A new permission would be a new thing to grant before
+  // anyone could look at a number that already exists.
+  router.get('/sessions/upload-health', auth.requireBuilder, auth.requirePermission('session.search'), readRateLimit, async (req, res) => {
+    const q = req.query || {};
+    try {
+      // Audit BEFORE the query, like /search: no cross-builder read without a
+      // durable record of who asked.
+      await recordSessionRead(req, {
+        route: '/api/bongos/sessions/upload-health',
+        targetBuilderId: null,
+        target: `upload-health days=${uploadHealth.clampLookbackDays(q.days)} window_hours=${uploadHealth.clampWindowHours(q.window_hours)}`,
+      });
+      const health = await db.sessionUploadHealth({
+        days: q.days,
+        windowHours: q.window_hours,
+        sampleLimit: q.sample_limit,
+      });
+      res.json(health);
+    } catch (err) {
+      // The namespaced structured logger, not console — see the poller's note.
+      // Its siblings above still use console because they predate task 1003130;
+      // new call sites do not add to the count the ratchet exists to shrink.
+      api.logger('sessions').error(err, 'GET /sessions/upload-health failed');
+      res.fail('upload_health_failed', 500);
+    }
+  });
+
   // rank: any-builder — your OWN sessions (self-serve; no audit needed).
   router.get('/sessions/mine', auth.requireBuilder, readRateLimit, async (req, res) => {
     try {

package/modules/sessions/upload-health.js

@@ -0,0 +1,197 @@
+'use strict';
+
+// modules/sessions/upload-health.js — the PURE verdict over session-upload
+// coverage (task 1003865, goal 1000118).
+//
+// THE OUTAGE THIS EXISTS FOR. A Windows path-encoding bug made every transcript
+// lookup miss, so each ship skipped its session upload with `transcript_not_found`.
+// No session_records row was written, so no `session.token_reward` credit booked —
+// and since ADR 0146 made cost-plus the SOLE reward stream, the affected builder
+// earned nothing for real shipped work. It ran for weeks before a human noticed.
+//
+// WHY NOTHING NOTICED. The only trace was `session-upload-skips.jsonl`, written by
+// recordUploadSkip on the BUILDER'S OWN MACHINE. It never reaches the server, so
+// from the server's side a skipped upload and a builder who simply did not work
+// look identical: the absence of a row, in both cases.
+//
+// So the signal is built from two things the server already knows INDEPENDENTLY:
+// a task reached `shipped`, and whether that task's builder uploaded any session
+// around then. A ship with no session record for its builder inside a window is
+// the unit of evidence.
+//
+// ---------------------------------------------------------------------------
+// PER BUILDER, AND THAT IS THE WHOLE DESIGN — measured, not assumed.
+//
+// The obvious version of this check — the uncovered share across the CORPUS —
+// cannot see the outage at all. Measured against the real corpora on 2026-09-16
+// (4,495 session records and 2,640 ships carrying shipped_at + shipped_by, paged
+// out of /sessions/search and /tasks):
+//
+//   corpus-wide uncovered share, ±24h:  2026-06 1.7% · 2026-07 3.4% ·
+//                                       2026-08 2.0% · 2026-09 0.2%
+//
+// July and August — the outage months — are indistinguishable from the rest. Of
+// course they are: the failure was one builder on one machine, about 19 ships out
+// of the ~1,164 that landed across those two months. A corpus-wide ratio puts the
+// signal two orders of magnitude beneath its own noise floor.
+//
+// Keyed on the BUILDER, the same data separates cleanly. Re-running the check as
+// it would have run — a rolling 14-day lookback stepped one day at a time over
+// the ~92 evaluable days — at ±24h, min 8 ships, firing above 25%:
+//
+//   fires on 13 days, ALL of them 2026-07-24 … 2026-08-05, ALL one builder
+//   peak 2026-07-25: 19 of 19 ships with no session record — a total outage
+//   silent on the other ~79 days and on every other builder
+//
+// That is the stated outage window (2026-07 into 2026-08) and about the stated
+// ship count ("at least 16 ships"), found without being told where to look.
+//
+// The window width is measured too, not chosen: at ±12h the same sweep fires on
+// 27 days across THREE builders — long sessions that upload once at the end drift
+// past a narrow window and read as outages. ±24h keeps them in.
+// ---------------------------------------------------------------------------
+//
+// KEYED ON BUILDER + TIME, NEVER ON task_ids. `session_records.task_ids` is EMPTY
+// on 54% of rows (1,771 of 3,873 when task 1002448 measured it in 2026-09), so
+// "no session record NAMES this task" is not a usable predicate — it reports the
+// linkage gap as an outage. This file never sees task_ids at all, and the SQL in
+// db.js does not mention it; a test asserts that about the SQL actually emitted.
+//
+// PURE so the firing condition is provable without a database, and so the route
+// (on demand) and the poller (periodically) cannot answer the question two
+// different ways.
+
+// ---- the knobs, every one of them measured above ---------------------------
+
+// The window around a ship in which its builder must have uploaded SOMETHING.
+// The digest uploads at ship time (uploadSessionOnShip, inside finishShip), so a
+// healthy ship's nearest upload is minutes away — p50 is 0.21h across the whole
+// corpus. The width is for what is awkward but not an outage: a long session that
+// uploads once after several ships, a land that polled for hours, a clock that
+// disagrees. ±12h costs three false builders; ±24h costs nothing measurable.
+const DEFAULT_WINDOW_HOURS = 24;
+
+// How far back the check looks. Long enough that one quiet week cannot empty it,
+// short enough that a resolved outage stops firing instead of haunting the number
+// for a quarter. 14 days is what the sweep above was tuned on.
+const DEFAULT_LOOKBACK_DAYS = 14;
+
+// Below this many ships IN THE LOOKBACK, a builder is not judged at all. Three
+// uncovered out of four is 75% and means nothing; the same share over twenty
+// ships is the outage. A check that fires on someone's quiet fortnight teaches
+// people to mute it, which is the state this task exists to fix.
+const DEFAULT_MIN_SHIPS = 8;
+
+// The uncovered share that counts as broken, per builder. The real outage ran at
+// 86-100%; every healthy builder-fortnight in the same sweep stayed under this.
+// Set here rather than at 50% so a PARTIAL outage — some ships uploading, some
+// not — still fires, which is the shape a flaky path bug actually has.
+const DEFAULT_MAX_UNCOVERED_SHARE = 0.25;
+
+// ---- the clamps ------------------------------------------------------------
+//
+// Both reach an SQL interval, and both are reachable from a URL. They are clamped
+// HERE rather than at the route because the route is not the only caller — the
+// poller is the other — and a bound that lives at one of two call sites is not a
+// bound.
+function clampLookbackDays(n) {
+  const x = Number(n);
+  if (!Number.isFinite(x)) return DEFAULT_LOOKBACK_DAYS;
+  return Math.max(1, Math.min(365, Math.trunc(x)));
+}
+function clampWindowHours(n) {
+  const x = Number(n);
+  if (!Number.isFinite(x)) return DEFAULT_WINDOW_HOURS;
+  return Math.max(1, Math.min(720, Math.trunc(x)));
+}
+// The offender sample is evidence, not a report: enough rows to recognise the
+// shape (one machine? one week? everyone?), never the whole corpus.
+function clampSampleLimit(n) {
+  if (n == null) return 20;
+  const x = Number(n);
+  if (!Number.isFinite(x)) return 20;
+  return Math.max(1, Math.min(100, Math.trunc(x)));
+}
+
+// ---- the verdict -----------------------------------------------------------
+
+function toCount(v) {
+  const n = Number(v);
+  return Number.isFinite(n) && n > 0 ? Math.trunc(n) : 0;
+}
+
+// normalizeBuilderRows — take what the SQL returns (per-builder counts, with
+// Postgres' bigint-as-string) and hand back clean numbers. A row without a
+// builder is dropped rather than trusted, and an uncovered count above the ship
+// count is a query bug, not an outage several times over: clamp, don't propagate.
+function normalizeBuilderRows(rows) {
+  const list = Array.isArray(rows) ? rows : [];
+  return list
+    .filter((r) => r && r.builder_id != null)
+    .map((r) => {
+      const ships = toCount(r.ships);
+      const uncovered = Math.min(ships, toCount(r.uncovered));
+      return {
+        builder_id: String(r.builder_id),
+        github_login: r.github_login == null ? null : String(r.github_login),
+        ships,
+        uncovered,
+        uncovered_share: ships > 0 ? Number((uncovered / ships).toFixed(4)) : 0,
+      };
+    });
+}
+
+// uploadHealthVerdict — is any builder's session upload silently failing?
+//
+// The verdict always carries its own arithmetic and names the builder, because
+// the first question a firing check has to answer is "on what evidence", and the
+// answer to "whose machine" is what makes it actionable. An alert that cannot
+// answer either is one more thing to mute.
+function uploadHealthVerdict(rows, opts = {}) {
+  const minShips = Number.isFinite(opts.minShips) ? opts.minShips : DEFAULT_MIN_SHIPS;
+  const maxShare = Number.isFinite(opts.maxUncoveredShare) ? opts.maxUncoveredShare : DEFAULT_MAX_UNCOVERED_SHARE;
+  const builders = normalizeBuilderRows(rows).sort((a, b) => b.uncovered_share - a.uncovered_share);
+  const judged = builders.filter((b) => b.ships >= minShips);
+  const offenders = judged.filter((b) => b.uncovered_share > maxShare);
+  const ships = builders.reduce((a, b) => a + b.ships, 0);
+  const uncovered = builders.reduce((a, b) => a + b.uncovered, 0);
+  const base = { ships, uncovered, builders, judged: judged.length, offenders, minShips, maxUncoveredShare: maxShare };
+
+  if (judged.length === 0) {
+    return {
+      ...base,
+      firing: false,
+      status: 'insufficient-data',
+      reason: `no builder shipped ${minShips}+ tasks in the window (${builders.length} builder(s), ${ships} ship(s) total) — not enough to judge`,
+    };
+  }
+  if (offenders.length > 0) {
+    const worst = offenders[0];
+    const who = worst.github_login || `builder #${worst.builder_id}`;
+    const rest = offenders.length > 1 ? ` (and ${offenders.length - 1} other builder(s) over the line)` : '';
+    return {
+      ...base,
+      firing: true,
+      status: 'uploads-missing',
+      reason: `${who} has ${worst.uncovered} of ${worst.ships} ships (${(worst.uncovered_share * 100).toFixed(1)}%) with no session record in the window${rest}. Their session uploads are probably failing, which means the cost-plus reward is not booking for work that shipped.`,
+    };
+  }
+  return {
+    ...base,
+    firing: false,
+    status: 'healthy',
+    reason: `${judged.length} builder(s) judged, worst ${(judged[0].uncovered_share * 100).toFixed(1)}% uncovered — under the ${(maxShare * 100).toFixed(0)}% threshold`,
+  };
+}
+
+module.exports = {
+  DEFAULT_WINDOW_HOURS,
+  DEFAULT_LOOKBACK_DAYS,
+  DEFAULT_MIN_SHIPS,
+  DEFAULT_MAX_UNCOVERED_SHARE,
+  clampLookbackDays,
+  clampWindowHours,
+  clampSampleLimit,
+  normalizeBuilderRows,
+  uploadHealthVerdict,
+};

package/modules/status-ui/module.json

@@ -1,7 +1,7 @@
 {
   "key": "status-ui",
   "title": "Status dashboard (\"The Watch\")",
-  "description": "The public build-status dashboard served at status.<apex> (status.example.com) — the live up/down banner, version-progress rollups, cost summary, recent ships, leaderboard, and the ecosystem fingerprint, all polling the read-only /api/gds/public/* surface every 60s. A WEB-SURFACE core-domain module carved out of the GDS core in BV1.R84 (ADR 0093 §1; 02-module-map §6 — a web surface is first-class). default-on: a Cloud Bongos instance ships its status page like it ships its hall. Registers no port and contributes no routes — it declares a webSurface (host prefix + static dir) the loader hands serve-internal, which serves the module's public/ dir on the matching host exactly as it served public-status/ before. The public read endpoints it renders stay SHARED core in routes/public.js (the hall + the off-box mirror read them too).",
+  "description": "The public build-status dashboard served at status.<apex> (status.example.com) — the live up/down banner, version-progress rollups, cost summary, recent ships, leaderboard, and the ecosystem fingerprint, all polling the read-only /api/bongos/public/* surface every 60s. A WEB-SURFACE core-domain module carved out of the GDS core in BV1.R84 (ADR 0093 §1; 02-module-map §6 — a web surface is first-class). default-on: a Cloud Bongos instance ships its status page like it ships its hall. Registers no port and contributes no routes — it declares a webSurface (host prefix + static dir) the loader hands serve-internal, which serves the module's public/ dir on the matching host exactly as it served public-status/ before. The public read endpoints it renders stay SHARED core in routes/public.js (the hall + the off-box mirror read them too).",
   "coreVersion": "^1.11.0",
   "default": true,
   "maintenance": { "status": "core-maintained" },

package/modules/status-ui/public/explore.js

@@ -113,7 +113,7 @@
     return el;
   }
 
-  fetch('/api/gds/projects/featured', { headers: { Accept: 'application/json' } })
+  fetch('/api/bongos/projects/featured', { headers: { Accept: 'application/json' } })
     .then(function (r) { if (!r.ok) throw new Error('http ' + r.status); return r.json(); })
     .then(function (data) {
       var projects = (data && Array.isArray(data.projects)) ? data.projects : [];

package/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@bongos/core",
-  "version": "1.19.804",
+  "version": "1.19.805",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@bongos/core",
-      "version": "1.19.804",
+      "version": "1.19.805",
       "license": "AGPL-3.0-or-later",
       "dependencies": {
         "express": "^4.21.2",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bongos/core",
-  "version": "1.19.804",
+  "version": "1.19.805",
   "description": "Cloud Bongos — the AI-first build platform core (GDS + platform surfaces + module system), installed as a versioned dependency (ADR 0108).",
   "license": "AGPL-3.0-or-later",
   "main": "src/platform-server.js",

package/scripts/gds/agent-invoke.js

@@ -610,7 +610,7 @@ module.exports = {
 
 function usage() {
   console.error('Usage: node scripts/gds/agent-invoke.js <agent> "<question>" [--out <path>] [--json]');
-  console.error('  <agent>      the agent name as it appears in the registry (GET /api/gds/agents)');
+  console.error('  <agent>      the agent name as it appears in the registry (GET /api/bongos/agents)');
   console.error('  --out <path> write the answer to a file and record it as the run\'s output_ref');
   console.error('  --json       print the whole result as JSON instead of prose');
 }
@@ -624,7 +624,7 @@ async function main() {
   // Rule 5. requireSession exits with its own guidance when there is no session.
   const cli = require('./cli-lib');
   await cli.requireSession();
-  const me = await cli.apiCall('GET', '/api/gds/me');
+  const me = await cli.apiCall('GET', '/api/bongos/me');
   const builder = (me && me.data && me.data.builder) || null;
   if (!builder || !builder.id) {
     console.error('agent-invoke: could not resolve who you are from /me — a fire has to be attributable.');
@@ -659,7 +659,7 @@ async function main() {
     console.error(`\n  ${name}: ${result.code}`);
     if (result.reason) console.error(`  ${result.reason}`);
     if (result.code === 'agent_not_found') {
-      console.error('  Nothing by that name is in the registry. `node scripts/gds/api.js GET /api/gds/agents` lists it.');
+      console.error('  Nothing by that name is in the registry. `node scripts/gds/api.js GET /api/bongos/agents` lists it.');
     }
     if (result.code === 'agent_refused' && /not enabled/.test(result.reason || '')) {
       console.error('  Definitions land in the registry DISABLED by design: agents-sync reconciles');

package/scripts/gds/api.js

@@ -8,10 +8,10 @@
 // session token + API base, so there is no manual token extraction here.
 //
 // Usage:
-//   node scripts/gds/api.js GET  /api/gds/inbox
-//   node scripts/gds/api.js POST /api/gds/blockers/5/resolve --body '{"resolution_note":"fixed in #690"}'
-//   node scripts/gds/api.js POST /api/gds/security/reports   --body-file report.json
-//   echo '{"verdict":"promote"}' | node scripts/gds/api.js PATCH /api/gds/inbox/12 --body-file -
+//   node scripts/gds/api.js GET  /api/bongos/inbox
+//   node scripts/gds/api.js POST /api/bongos/blockers/5/resolve --body '{"resolution_note":"fixed in #690"}'
+//   node scripts/gds/api.js POST /api/bongos/security/reports   --body-file report.json
+//   echo '{"verdict":"promote"}' | node scripts/gds/api.js PATCH /api/bongos/inbox/12 --body-file -
 //
 // The HTTP status goes to STDERR ("POST /path → 201"); the pretty-printed JSON
 // body goes to STDOUT, so `... | node -e ...` style piping stays clean. Exit 0

package/scripts/gds/api.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 # scripts/gds/api.sh — Git Bash/Linux passthrough wrapper around api.js.
-# MSYS_NO_PATHCONV avoids Git Bash mangling API paths (e.g. /api/gds/inbox) into
+# MSYS_NO_PATHCONV avoids Git Bash mangling API paths (e.g. /api/bongos/inbox) into
 # Windows paths before node ever sees them.
 export MSYS_NO_PATHCONV=1
 exec node "$(dirname "$0")/api.js" "$@"

package/scripts/gds/architect-audit.js

@@ -268,7 +268,7 @@ async function main() {
   console.log(`\n📜 wrote ${relDoc}`);
 
   // File the seed ideas to the planning inbox. Payload mirrors capture.js
-  // (POST /api/gds/inbox): { title, body_md, kind, suggested_version }.
+  // (POST /api/bongos/inbox): { title, body_md, kind, suggested_version }.
   // Provenance (which audit produced it) is folded into body_md.
   let filed = 0;
   const api = await cliClient();

package/scripts/gds/artifact-audit.js

@@ -157,7 +157,7 @@ async function fetchAuditedTasks({ call = apiCall } = {}) {
     for (let page = 0; page < 100; page++) {
       const q = buildTaskPageQuery({ status, limit: TASK_LIST_MAX_LIMIT, offset });
       const qs = new URLSearchParams(q).toString();
-      const r = await call('GET', `/api/gds/tasks?${qs}`);
+      const r = await call('GET', `/api/bongos/tasks?${qs}`);
       if (!r || !r.ok) throw new Error(`GET /tasks?status=${status} → ${r && r.status}`);
       const page_rows = (r.data && r.data.tasks) || [];
       rows.push(...page_rows);
@@ -208,7 +208,7 @@ function blockerBody(stranded) {
 
 async function fileBlocker(stranded, { call = apiCall } = {}) {
   if (!stranded.length) return { filed: false, reason: 'nothing to report' };
-  const r = await call('POST', '/api/gds/blockers', {
+  const r = await call('POST', '/api/bongos/blockers', {
     title: `${stranded.length} shipped task(s) claim an artifact nothing on main names`,
     body_md: blockerBody(stranded),
     source: 'artifact-audit',

package/scripts/gds/audit-ships.js

@@ -160,7 +160,7 @@ async function fetchShipped(days) {
   const d = b.domains || {};
   const statusBase = String(d.statusOrigin || d.publicOrigin || '').replace(/\/+$/, '');
   const r = await fetch(
-    `${statusBase}/api/gds/public/recent-shipped?days=${days}&limit=500`
+    `${statusBase}/api/bongos/public/recent-shipped?days=${days}&limit=500`
   );
   const data = await r.json();
   return data.tasks || [];
@@ -174,7 +174,7 @@ async function fetchFullTask(id) {
 }
 
 async function fetchLearning(taskId) {
-  // /api/gds/learnings?task=<id> — we just need body_md.
+  // /api/bongos/learnings?task=<id> — we just need body_md.
   const api = await cliClient();
   const r = await api.learnings.getLearnings({ query: { task: taskId } });
   if (!r.ok) return null;

package/scripts/gds/backfill-cost.js

@@ -2,7 +2,7 @@
 // Backfill cost_log from the art-pipeline cost ledger.
 //
 // Reads art/iterations/cost_ledger.jsonl (gitignored, lives in whichever
-// worktree ran the pipeline) and POSTs each row to /api/gds/cost.
+// worktree ran the pipeline) and POSTs each row to /api/bongos/cost.
 //
 // Idempotent thanks to migration 004_pms_cost_idempotency.sql:
 // re-running this script is a no-op (skipped rows print as 'dup').

package/scripts/gds/backfill-sessions.js

@@ -56,7 +56,7 @@ const argVal = (name) => {
 };
 const EXISTING_FILE = argVal('existing') || '/tmp/otb-existing-session-ids.txt';
 const LIMIT = argVal('limit') ? parseInt(argVal('limit'), 10) : Infinity;
-// The /api/gds write limiter is per-IP 30 writes / 60s (the binding constraint;
+// The /api/bongos write limiter is per-IP 30 writes / 60s (the binding constraint;
 // per-session is 60/60s). 2100ms spacing keeps us safely under 30/min so the
 // limiter never trips during a long backfill. Override with --pace=<ms>.
 const PACE_MS = argVal('pace') ? parseInt(argVal('pace'), 10) : 2100;

package/scripts/gds/backfill-subagent-rewards.js

@@ -37,7 +37,7 @@
 // SAFETY MODEL (mirrors scripts/gds/backfill-task-rewards.js, ADR 0097):
 //   * DRY-RUN BY DEFAULT. With no flags it prints the full plan + grand total and
 //     writes NOTHING. A live mint requires ALL of: --apply, Archon rank verified
-//     server-side via GET /api/gds/me, and a typed y/N confirmation (--yes skips
+//     server-side via GET /api/bongos/me, and a typed y/N confirmation (--yes skips
 //     only the typing).
 //   * IDEMPOTENT BY CONSTRUCTION, not by a new bookkeeping key. Every mint goes
 //     through the REAL reward writer (modules/economy/credits.js

package/scripts/gds/backfill-task-rewards.js

@@ -17,7 +17,7 @@
 //   * DRY-RUN BY DEFAULT. With no flags it prints the full plan + grand total
 //     and writes NOTHING. A live mint requires ALL of:
 //       --apply               explicit opt-in to write
-//       Archon rank           verified server-side via GET /api/gds/me; the
+//       Archon rank           verified server-side via GET /api/bongos/me; the
 //                             script refuses for any other rank
 //       interactive y/N       a typed confirmation at the terminal (skip only
 //                             with --yes, which an Archon must pass deliberately)
@@ -372,7 +372,7 @@ async function main() {
     const api = await cliClient();
     me = await api.me.getMe();
   } catch (err) {
-    console.error('--apply requires a verified Archon session; could not reach /api/gds/me:', err.message);
+    console.error('--apply requires a verified Archon session; could not reach /api/bongos/me:', err.message);
     await pool.end().catch(() => {});
     process.exit(3);
   }

package/scripts/gds/box-auth-check.js

@@ -70,7 +70,7 @@ async function probeMe(tokenInfo) {
   const ctl = new AbortController();
   const timer = setTimeout(() => ctl.abort(), ME_TIMEOUT_MS);
   try {
-    const res = await fetch(`${tokenInfo.apiBase}/api/gds/me`, {
+    const res = await fetch(`${tokenInfo.apiBase}/api/bongos/me`, {
       method: 'GET',
       headers: { Authorization: `Bearer ${tokenInfo.token}`, 'User-Agent': 'box-auth-check/1.0' },
       signal: ctl.signal,

package/scripts/gds/box-sync.js

@@ -89,8 +89,8 @@ async function runWiden(argv) {
   const listOnly = !add && !remove && !clear;
 
   const r = listOnly
-    ? await apiCall('GET', '/api/gds/box/widen')
-    : await apiCall('POST', '/api/gds/box/widen', {
+    ? await apiCall('GET', '/api/bongos/box/widen')
+    : await apiCall('POST', '/api/bongos/box/widen', {
       ...(add ? { add: [add] } : {}),
       ...(remove ? { remove: [remove] } : {}),
       ...(clear ? { clear: true } : {}),
@@ -200,7 +200,7 @@ function formatScopeReport(scope) {
 async function reportScope() {
   try {
     const { apiCall } = require('./cli-lib');
-    const r = await apiCall('GET', '/api/gds/box/scope');
+    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;