@bongos/core 1.19.804 → 1.19.806

package/scripts/gds/dev-lib.js

@@ -261,7 +261,7 @@ function stop(params, deps = {}) {
 }
 
 // Probe the running server. Returns { up, authConfigured }. `up` = the plain
-// /healthz (needs no DB); authConfigured comes from /api/gds/healthz.
+// /healthz (needs no DB); authConfigured comes from /api/bongos/healthz.
 async function health(params, deps = {}) {
   const fetchImpl = deps.fetchImpl || fetch;
   const base = `http://${probeHost(params)}:${params.port}`;
@@ -273,7 +273,7 @@ async function health(params, deps = {}) {
   } catch { return { up: false, authConfigured: false }; }
   let authConfigured = false;
   try {
-    const r = await fetchImpl(`${base}/api/gds/healthz`, { signal: AbortSignal.timeout(timeout) });
+    const r = await fetchImpl(`${base}/api/bongos/healthz`, { signal: AbortSignal.timeout(timeout) });
     const j = await r.json();
     authConfigured = j && j.auth_configured === true;
   } catch { /* leave false */ }

package/scripts/gds/fetch-art-key.js

@@ -3,7 +3,7 @@
 // the local session file so a newcomer's art pipeline can use it (task 1281).
 //
 // The art pipeline (modules/art-pipeline/pipeline/gen_api.py) runs LOCALLY and can't call the API
-// per generation, so SessionStart runs this once: GET /api/gds/me/art-key and,
+// per generation, so SessionStart runs this once: GET /api/bongos/me/art-key and,
 // based on the builder's live rank, write or remove the `shared_gemini_api_key`
 // field in ~/.config/otb/bongos-session.json. gen_api.py reads that field as a
 // fallback BELOW the builder's own key — so own key always wins, and a newcomer
@@ -43,7 +43,7 @@ async function main() {
   const timer = setTimeout(() => ctrl.abort(), FETCH_TIMEOUT_MS);
   let data = null;
   try {
-    const res = await fetch(`${base}/api/gds/me/art-key`, {
+    const res = await fetch(`${base}/api/bongos/me/art-key`, {
       headers: {
         Authorization: `Bearer ${session.token}`,
         'User-Agent': require('../../src/branding').userAgent(),

package/scripts/gds/fetch-sound-prefs.js

@@ -5,7 +5,7 @@
 // The toggle lives server-side (builders.sound_prefs), but the sound plays from
 // a LOCAL Stop hook + ship.js via .claude/sounds/play.js — which can't make a
 // network call on every turn. So SessionStart runs this once: fetch
-// GET /api/gds/me/sound-prefs and write its effective_map to
+// GET /api/bongos/me/sound-prefs and write its effective_map to
 // ~/.config/otb/sound-prefs.json. play.js reads that file and skips muted sounds.
 //
 // Best-effort by construction:
@@ -48,11 +48,11 @@ async function main() {
     // Fetch both prefs in parallel; a failure on either leaves both at their
     // existing cached state (fail-open).
     const [soundRes, eventRes] = await Promise.all([
-      fetch(`${sess.apiBase}/api/gds/me/sound-prefs`, {
+      fetch(`${sess.apiBase}/api/bongos/me/sound-prefs`, {
         headers: { Authorization: `Bearer ${sess.token}`, 'User-Agent': require('../../src/branding').userAgent() },
         signal: ctrl.signal,
       }),
-      fetch(`${sess.apiBase}/api/gds/me/event-sound-prefs`, {
+      fetch(`${sess.apiBase}/api/bongos/me/event-sound-prefs`, {
         headers: { Authorization: `Bearer ${sess.token}`, 'User-Agent': require('../../src/branding').userAgent() },
         signal: ctrl.signal,
       }),

package/scripts/gds/grade-smoke.js

@@ -78,7 +78,7 @@ const BAD_TASK = {
 Acceptance:
 - New table billing_charges captures one row per art-pipeline ship with
   stripe_charge_id, amount_cents, currency, status.
-- POST /api/gds/cost on art-pipeline tasks creates a Stripe charge against
+- POST /api/bongos/cost on art-pipeline tasks creates a Stripe charge against
   the configured Hermeslines customer and writes the billing_charges row.
 - A failure to charge rolls the cost-log insert back so we never claim a
   charge that didn't happen.

package/scripts/gds/hooks/pre-push.js

@@ -92,7 +92,7 @@ async function liveRank() {
   try {
     const timeout = new Promise((resolve) => { timer = setTimeout(() => resolve('__timeout__'), LIVE_RANK_TIMEOUT_MS); });
     const res = await Promise.race([
-      apiCall('GET', '/api/gds/me', null, { allowUnauthenticated: true }),
+      apiCall('GET', '/api/bongos/me', null, { allowUnauthenticated: true }),
       timeout,
     ]);
     // The loser of the race must be cleared. This used to leak: process.exit()

package/scripts/gds/init.js

@@ -8,7 +8,7 @@
 //   1. gathers a spec (interactive interview, or --from <spec.json>),
 //   2. writes the instance config — config/branding.json + config/modules.json
 //      (lean OVERRIDES; config/*.neutral.json fills the rest, src/branding.js),
-//   3. seeds the first version + its done-when goal via POST /api/gds/versions
+//   3. seeds the first version + its done-when goal via POST /api/bongos/versions
 //      (the primitive added in this same task), then files the starter task and
 //      the human-only KICKOFF steps as real, tracked tasks via POST /tasks,
 //   4. points the owner at docs/branding-fill-prompt.md for the LOOK (a locked
@@ -200,7 +200,7 @@ function provisioningSlug(spec) {
   return slugify(base, 'instance').slice(0, 40).replace(/-+$/, '');
 }
 
-// The POST /api/gds/provisioning/instances body built from the interview's infra
+// The POST /api/bongos/provisioning/instances body built from the interview's infra
 // answers — or null when the owner didn't opt into provisioning (no spec.provisioning
 // block). THE ADR 0111 §3 ARM: infra answers become a real provisioning REQUEST (a
 // provisioning_intents row the control-plane runner drains) instead of only a manual
@@ -382,7 +382,7 @@ function validateSpec(spec, { adopt = false, noSeed = false } = {}) {
   return errs;
 }
 
-// Build the POST /api/gds/versions body from the spec (pure). The first version's
+// Build the POST /api/bongos/versions body from the spec (pure). The first version's
 // done_when goal becomes both the version blurb and one done-when criterion, so
 // /status has a finish line to roll up from day one.
 function versionPayload(spec) {
@@ -701,11 +701,11 @@ async function seedViaApi(spec, { dryRun, log = console.log, api = apiCall } = {
   const pr = provisioningRequest(spec); // ADR 0111 §3 — null unless the owner opted in
 
   if (dryRun) {
-    log(`\n[dry-run] would POST /api/gds/versions:`);
+    log(`\n[dry-run] would POST /api/bongos/versions:`);
     log(JSON.stringify(vp, null, 2));
     log(`\n[dry-run] would create ${starters.length} starter + ${kickoff.length} kickoff task(s) under ${vp.id}.`);
     if (pr) {
-      log(`\n[dry-run] would POST /api/gds/provisioning/instances:`);
+      log(`\n[dry-run] would POST /api/bongos/provisioning/instances:`);
       log(JSON.stringify(pr, null, 2));
       log(`  (queues a 'provision' intent; the control-plane runner stands up hosting — ADR 0111 §2/§3.`);
       log(`   production-topology is left OFF the kickoff list since it's now automated.)`);
@@ -714,7 +714,7 @@ async function seedViaApi(spec, { dryRun, log = console.log, api = apiCall } = {
   }
 
   // 1. version + first goal
-  const vres = await api('POST', '/api/gds/versions', vp);
+  const vres = await api('POST', '/api/bongos/versions', vp);
   if (!vres.ok && vres.status !== 409) {
     throw new Error(`POST /versions failed (${vres.status}): ${JSON.stringify(vres.data)}`);
   }
@@ -726,7 +726,7 @@ async function seedViaApi(spec, { dryRun, log = console.log, api = apiCall } = {
   let goalId = vres.ok && vres.data && vres.data.goal ? vres.data.goal.id : null;
   if (vres.status === 409) {
     log(`  • version ${vp.id} already exists — continuing.`);
-    const gres = await api('GET', `/api/gds/goals?version=${encodeURIComponent(vp.id)}`);
+    const gres = await api('GET', `/api/bongos/goals?version=${encodeURIComponent(vp.id)}`);
     const goals = gres.ok ? (Array.isArray(gres.data) ? gres.data : (gres.data && gres.data.goals) || []) : [];
     const open = goals.find((g) => g && g.status === 'open' && !g.is_maintenance) || goals.find((g) => g && g.status === 'open');
     goalId = open ? open.id : null;
@@ -752,7 +752,7 @@ async function seedViaApi(spec, { dryRun, log = console.log, api = apiCall } = {
   const failures = [];
   const postTask = async (t, extra = {}) => {
     attempted++;
-    const res = await api('POST', '/api/gds/tasks', {
+    const res = await api('POST', '/api/bongos/tasks', {
       version_id: vp.id, goal_id: goalId, title: t.title, description: t.description || '', status: 'ready',
       kind: t.kind || 'infra', discipline: t.discipline || 'engineer', source: 'bongos-init', ...extra,
     });
@@ -777,7 +777,7 @@ async function seedViaApi(spec, { dryRun, log = console.log, api = apiCall } = {
   // re-file that manual step here so the leg is never silently dropped.
   let provisioned = false;
   if (pr) {
-    const pres = await api('POST', '/api/gds/provisioning/instances', pr);
+    const pres = await api('POST', '/api/bongos/provisioning/instances', pr);
     if (pres.ok) {
       provisioned = true;
       const inst = (pres.data && pres.data.instance) || {};

package/scripts/gds/key-card.js

@@ -187,7 +187,7 @@ async function resolveWidgetsEnabled() {
     const ctrl = new AbortController();
     const timer = setTimeout(() => ctrl.abort(), 3000);
     try {
-      const res = await fetch(`${base}/api/gds/me`, {
+      const res = await fetch(`${base}/api/bongos/me`, {
         headers: { Authorization: `Bearer ${session.token}`, 'User-Agent': require('../../src/branding').userAgent() },
         signal: ctrl.signal,
       });

package/scripts/gds/learning-capture.js

@@ -100,7 +100,7 @@ function autoDetectFiles() {
 
   if (dryRun) {
     console.log('=== DRY RUN ===');
-    console.log('POST /api/gds/learnings:');
+    console.log('POST /api/bongos/learnings:');
     console.log(JSON.stringify({
       title, body_md: body, tags, related_files: relatedFiles, source, source_ref: sourceRef, task_id: taskId,
     }, null, 2));
@@ -135,7 +135,7 @@ function autoDetectFiles() {
   if (learning.related_files?.length) {
     console.log(`Related files: ${learning.related_files.join(', ')}`);
   }
-  console.log('Stored in GDS DB. Query with: node scripts/gds/learning-list.js (TBD) or GET /api/gds/learnings');
+  console.log('Stored in GDS DB. Query with: node scripts/gds/learning-list.js (TBD) or GET /api/bongos/learnings');
   // Phase 2b — the per-tag markdown append was removed. The DB is now the
   // canonical store for short-form learnings; long-form operational recipes
   // live separately under docs/recipes/.

package/scripts/gds/linkify-refs.js

@@ -24,7 +24,7 @@
 // recreates the complaint. So the classifier is deliberately conservative —
 // it links a "#NNN" ONLY when ALL of these hold:
 //   • NNN is a real id of the classified kind (fetched live from the public
-//     /api/gds/public/ref-ids allow-list; PR-only numbers are therefore never
+//     /api/bongos/public/ref-ids allow-list; PR-only numbers are therefore never
 //     touched, and an idea id is never linked as a task).
 //   • It is a bare reference — NOT a markdown heading anchor like
 //     `](#12-session-update-protocol)` (digits followed by `-`/word chars), and
@@ -520,7 +520,7 @@ function linkifyText(text, ids, stats) {
 // Token-free: the public id allow-list, so this script (and the CI gate) work
 // with no builder session. Override the host with GDS_API_BASE for local dev.
 async function fetchRefIds() {
-  const res = await fetch(`${API_BASE}/api/gds/public/ref-ids`);
+  const res = await fetch(`${API_BASE}/api/bongos/public/ref-ids`);
   if (!res.ok) throw new Error(`/public/ref-ids fetch failed (HTTP ${res.status})`);
   const data = await res.json();
   const toSet = (a) => new Set((a || []).map(Number).filter(Number.isInteger));

package/scripts/gds/local-preview-lib.js

@@ -4,7 +4,7 @@
 // preview a dev box gets at sandbox-<login>.example.com (ADR 0044/0046/0052)
 // — but served at http://localhost:<port> on their OWN machine: no Cloudflare
 // tunnel, no public URL, $0. It runs the ADR 0052 game-only entry
-// (src/preview-server.js), which serves ONLY the playable game (no /api/gds, no
+// (src/preview-server.js), which serves ONLY the playable game (no /api/bongos, no
 // BuildersHall), degraded-DB exactly like the box sandbox.
 //
 // The preview is a long-running DETACHED background process (the laptop analogue

package/scripts/gds/login.js

@@ -32,13 +32,14 @@ const { branding } = require('../../src/branding');
 // --- pure helpers (unit-tested) ---------------------------------------------
 
 // Normalize whatever the user pastes into an origin: add https:// if no scheme,
-// drop trailing slashes, and tolerate a pasted /api/gds suffix.
+// drop trailing slashes, and tolerate a pasted API base — the canonical
+// /api/bongos or the permanent /api/gds alias, with or without the /v1 segment.
 function normalizeInstanceBase(raw) {
   let s = String(raw || '').trim();
   if (!s) throw new Error('missing instance URL');
   if (!/^https?:\/\//i.test(s)) s = `https://${s}`;
   s = s.replace(/\/+$/, '');
-  s = s.replace(/\/api\/gds\/?$/i, '');
+  s = s.replace(/\/api\/(?:bongos|gds)(?:\/v1)?\/?$/i, '');
   return s;
 }
 
@@ -95,7 +96,7 @@ const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
 // The instance's OWN admission gate runs at poll (direct) or exchange (federated),
 // so the stranger path is identical for both.
 async function runDeviceFlow(base, { log, idp = null }) {
-  const startUrl = idp ? `${idp.origin}/api/gds/sso/device/start` : `${base}/api/gds/auth/device/start`;
+  const startUrl = idp ? `${idp.origin}/api/bongos/sso/device/start` : `${base}/api/bongos/auth/device/start`;
   const start = await fetchJson(startUrl, {
     method: 'POST',
     // Federated: the hub resolves + binds the client from the USER-TYPED origin
@@ -136,7 +137,7 @@ async function runDeviceFlow(base, { log, idp = null }) {
   openBrowser(verification_uri);
   log('  Waiting for you to approve in the browser…');
 
-  const pollUrl = idp ? `${idp.origin}/api/gds/sso/device/poll` : `${base}/api/gds/auth/device/poll`;
+  const pollUrl = idp ? `${idp.origin}/api/bongos/sso/device/poll` : `${base}/api/bongos/auth/device/poll`;
   const deadline = Date.now() + expires * 1000;
   while (Date.now() < deadline) {
     await sleep(interval * 1000);
@@ -150,7 +151,7 @@ async function runDeviceFlow(base, { log, idp = null }) {
     if (st === 'ok') {
       if (!idp) return { state: 'ok', token: poll.data.token, builder: poll.data.builder };
       // Federated: exchange the hub assertion at the instance for a real session.
-      const ex = await fetchJson(`${base}/api/gds/auth/device/exchange`, {
+      const ex = await fetchJson(`${base}/api/bongos/auth/device/exchange`, {
         method: 'POST',
         body: JSON.stringify({ assertion: poll.data.assertion }),
       });
@@ -200,9 +201,9 @@ async function main() {
   // 1. Manifest — brand + admission posture, and a check that this really is a
   //    Cloud Bongos instance before we start a device flow.
   log(`▸ Connecting to ${base}…`);
-  const man = await fetchJson(`${base}/api/gds/instance`);
+  const man = await fetchJson(`${base}/api/bongos/instance`);
   if (!man.ok || !man.data || man.data.schema !== 'instance-manifest/v1') {
-    console.error(`✖ ${base} does not look like a Cloud Bongos instance (no /api/gds/instance manifest).`);
+    console.error(`✖ ${base} does not look like a Cloud Bongos instance (no /api/bongos/instance manifest).`);
     process.exit(1);
   }
   const instanceName = man.data.name || base;
@@ -230,7 +231,7 @@ async function main() {
     let stored = null;
     try { stored = await loadStoredSession(base); } catch (_) { stored = null; }
     if (stored && stored.token) {
-      const me = await fetchJson(`${base}/api/gds/me`, { headers: { Authorization: `Bearer ${stored.token}` } });
+      const me = await fetchJson(`${base}/api/bongos/me`, { headers: { Authorization: `Bearer ${stored.token}` } });
       if (me.ok && me.data && me.data.builder) {
         await saveSession({ ...stored, builder: me.data.builder, api_base: base,
           instance: { name: instanceName, origin: base } });
@@ -265,7 +266,7 @@ async function main() {
       console.error('✖ need your GitHub username to request access.');
       process.exit(2);
     }
-    const reqRes = await fetchJson(`${base}/api/gds/access-requests`, {
+    const reqRes = await fetchJson(`${base}/api/bongos/access-requests`, {
       method: 'POST',
       body: JSON.stringify({ github_login: ghLogin, note: 'via bongos login' }),
     });
@@ -287,7 +288,7 @@ async function main() {
     const admitDeadline = Date.now() + 30 * 60 * 1000; // 30 min
     for (;;) {
       await sleep(5000);
-      const s = await fetchJson(`${base}/api/gds/access-requests/status?github_login=${encodeURIComponent(ghLogin)}`);
+      const s = await fetchJson(`${base}/api/bongos/access-requests/status?github_login=${encodeURIComponent(ghLogin)}`);
       const decision = pollDecision(s.data);
       if (decision === 'admitted') {
         log('\n  ✓ Approved! Finishing sign-in — approve once more in your browser.');

package/scripts/gds/main-audit.js

@@ -282,7 +282,7 @@ async function fetchRankMap({ useDb = false } = {}) {
   // Caveat: a zero-activity builder may be absent → resolves as UNRESOLVED
   // ('review' finding), never as falsely-trusted.
   try {
-    const res = await fetch(`${API_BASE}/api/gds/public/leaderboard`);
+    const res = await fetch(`${API_BASE}/api/bongos/public/leaderboard`);
     if (res.ok) {
       const data = await res.json();
       return rowsToMap(data?.leaderboard || []);

package/scripts/gds/newcomer-floor.config.json

@@ -1,6 +1,6 @@
 {
   "_doc": "Supply knob for the deterministic newcomer-task floor replenisher (scripts/gds/newcomer-floor.js) and the on-claim restock (src/bongos/newcomer-restock.js). As of task 1488 each discipline holds a LIST of chore templates, and each chore keeps its OWN standing pool to its OWN `floor` (declared per-template in newcomer-floor.templates.json). The `floor` in this disciplines map is now the DEFAULT applied to any template that omits its own — i.e. a fallback, not the primary knob. The pool is measured in READY copies of each template (source_ref tmpl:<discipline>:<template_id>:<seq>); when a chore's ready copies drop below its floor, fresh identical copies are stamped — deterministic, no AI subagent, no 401. The CHORE definitions (and their per-template floors) live in templates.json (edit there to add/change a chore or tune its pool depth).",
-  "_review_gate": "`auto_promote` is the review toggle for the CLI seeder. true -> stamped copies land at status='ready' (claimable immediately). Safe here because output is deterministic and the templates are pre-approved (set true 2026-06-16, owner decision). false -> copies land at status='backlog' (NOT Xenos-claimable) for an Archon to promote via POST /api/gds/tasks/:id/promote. (The on-claim restock always stamps 'ready' — it tops a just-claimed chore's pool back up so the shelf is never empty.)",
+  "_review_gate": "`auto_promote` is the review toggle for the CLI seeder. true -> stamped copies land at status='ready' (claimable immediately). Safe here because output is deterministic and the templates are pre-approved (set true 2026-06-16, owner decision). false -> copies land at status='backlog' (NOT Xenos-claimable) for an Archon to promote via POST /api/bongos/tasks/:id/promote. (The on-claim restock always stamps 'ready' — it tops a just-claimed chore's pool back up so the shelf is never empty.)",
   "_floor_note": "Per-template `floor` lives in newcomer-floor.templates.json (next to each chore's credits_reward + est_minutes). The disciplines map below is only the per-discipline DEFAULT used when a template omits its own floor. credits_reward is never read from here.",
   "templates_path": "newcomer-floor.templates.json",
   "auto_promote": true,

package/scripts/gds/newcomer-floor.js

@@ -37,7 +37,7 @@
 //                      deterministic and the templates are pre-approved.
 //   false           -> copies land status='backlog' for an Archon to promote.
 //
-// AUTH: POST /api/gds/tasks is archon-gated (creating work is scope-shaping —
+// AUTH: POST /api/bongos/tasks is archon-gated (creating work is scope-shaping —
 // ADR 0016). Run under an Archon session (on the droplet, the operator's).
 //
 // Usage:
@@ -393,7 +393,7 @@ function report(summary, FLAGS, { checkOnly }) {
   }
   if (!summary.autoPromote && !FLAGS.dryRun && summary.stamped.some((g) => g.task_id)) {
     console.log('\nNext: a Metic+ builder promotes the new backlog copies to ready:');
-    console.log('  node scripts/gds/api.js POST /api/gds/tasks/<id>/promote   (or the builders\' hall)');
+    console.log('  node scripts/gds/api.js POST /api/bongos/tasks/<id>/promote   (or the builders\' hall)');
   }
 }
 

package/scripts/gds/newcomer-floor.templates.json

@@ -70,13 +70,13 @@
       "est_minutes": 45,
       "credits_reward": 12,
       "title": "Idea-seed pass: file 5-8 fresh in-world ideas (names, lore, or builder-UX) into the idea inbox",
-      "description": "## What you'll do\n\nThe seed of almost everything built here is the **idea_inbox** — a queue anyone can drop ideas into, which trusted builders later triage into real tasks. Your first ship as an ideator is simple and concrete: **add a small batch of fresh ideas to that inbox.** You write no code, touch no game, change no system — you think, write a few short well-shaped ideas, and file them with one command each.\n\nIt is identical for every newcomer and **always valuable**: the inbox is never \"done\" — every triage pass consumes ideas (promote/discard/merge), so it is permanently hungry for fresh input, and a growing world always wants more names, more lore, more texture. Your batch is brand-new content, so it can never duplicate \"the work\" — the supply IS the work.\n\n## Pick ONE branch\n\n- **Branch A — PRODUCT flavour (default).** Ideas that grow the world players see: **names + one line of lore** for a character, structure, landmark, district, ship, or festival; or a world-background snippet (a custom, a superstition, a line a named NPC says). Tone: mythic, mysterious, a \"discovered secret\"; Mediterranean ancient-Greek coast (just south of Athens); NOT modern, NOT tongue-in-cheek-modern. Ground it in CLAUDE.md §3/§6/§7.\n- **Branch B — INTERNAL / builder-UX.** Small user-experience improvement ideas for the GDS / builders' hall (the surfaces builders use, not the game): a clearer label, a confusing onboarding message, a quality-of-life tweak to a status page or a slash-command's output. See `docs/TRACKS.md` for product vs internal.\n\n## How to find your way in\n\n1. (Branch A) Read CLAUDE.md §3/§6/§7 for tone. (Branch B) Skim `docs/TRACKS.md` and click around your instance's /builders hall for the rough edge you'll write up.\n2. See what's already filed so you don't repeat it: `node scripts/gds/api.js GET /api/gds/inbox`.\n3. File each idea with `node scripts/gds/capture.js \"<title>\" --body-file <path>` (filing an idea is the open-to-all path — a Xenos/Thetes session is allowed to do it; you just can't triage them). Put one line of detail + a `track: product` or `track: internal` line in each body file.",
+      "description": "## What you'll do\n\nThe seed of almost everything built here is the **idea_inbox** — a queue anyone can drop ideas into, which trusted builders later triage into real tasks. Your first ship as an ideator is simple and concrete: **add a small batch of fresh ideas to that inbox.** You write no code, touch no game, change no system — you think, write a few short well-shaped ideas, and file them with one command each.\n\nIt is identical for every newcomer and **always valuable**: the inbox is never \"done\" — every triage pass consumes ideas (promote/discard/merge), so it is permanently hungry for fresh input, and a growing world always wants more names, more lore, more texture. Your batch is brand-new content, so it can never duplicate \"the work\" — the supply IS the work.\n\n## Pick ONE branch\n\n- **Branch A — PRODUCT flavour (default).** Ideas that grow the world players see: **names + one line of lore** for a character, structure, landmark, district, ship, or festival; or a world-background snippet (a custom, a superstition, a line a named NPC says). Tone: mythic, mysterious, a \"discovered secret\"; Mediterranean ancient-Greek coast (just south of Athens); NOT modern, NOT tongue-in-cheek-modern. Ground it in CLAUDE.md §3/§6/§7.\n- **Branch B — INTERNAL / builder-UX.** Small user-experience improvement ideas for the GDS / builders' hall (the surfaces builders use, not the game): a clearer label, a confusing onboarding message, a quality-of-life tweak to a status page or a slash-command's output. See `docs/TRACKS.md` for product vs internal.\n\n## How to find your way in\n\n1. (Branch A) Read CLAUDE.md §3/§6/§7 for tone. (Branch B) Skim `docs/TRACKS.md` and click around your instance's /builders hall for the rough edge you'll write up.\n2. See what's already filed so you don't repeat it: `node scripts/gds/api.js GET /api/bongos/inbox`.\n3. File each idea with `node scripts/gds/capture.js \"<title>\" --body-file <path>` (filing an idea is the open-to-all path — a Xenos/Thetes session is allowed to do it; you just can't triage them). Put one line of detail + a `track: product` or `track: internal` line in each body file.",
       "done_when": [
         "You filed 5–8 fresh ideas into the idea_inbox via `node scripts/gds/capture.js` (each prints a `Captured idea #N` confirmation), all in ONE branch (A product, or B internal/UX).",
         "Each idea has a clear title and a body with at least one sentence of detail — for Branch A, one line of in-world lore (who/what it is); for Branch B, what the rough edge is and what 'better' looks like.",
         "Branch A ideas are in the world's voice and consistent with CLAUDE.md §3/§6/§7 (ancient-Greek coast, Example, mythic 'discovered secret' tone — not modern/anachronistic).",
         "Each idea body declares its track on a `track: product` or `track: internal` line so triage can route it.",
-        "Before filing you ran `GET /api/gds/inbox` and confirmed your ideas are not near-duplicates of open ones.",
+        "Before filing you ran `GET /api/bongos/inbox` and confirmed your ideas are not near-duplicates of open ones.",
         "You touched only the idea_inbox via capture.js — no code, no migrations, no infra, no permission/pipeline files; nothing committed to the repo."
       ],
       "touches": [],

package/scripts/gds/onboarding-ship.js

@@ -11,7 +11,7 @@
 // realized as a privacy-preserving two-step: this script gzips completed
 // transcripts into a local spool, and onboarding-analyze.js then ships only
 // the *distilled friction signal* (not the raw transcript) to the shared GDS
-// via POST /api/gds/inbox. The raw transcript never leaves the machine — a
+// via POST /api/bongos/inbox. The raw transcript never leaves the machine — a
 // deliberate privacy choice given transcripts can contain anything the builder
 // typed. A dedicated upload endpoint would need a new route + storage table
 // (migration), both outside this task's touches[].

package/scripts/gds/paste-token.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 // scripts/gds/paste-token.js — V3.R91 / #401.
 //
-// Accept a CLI bearer minted by the builders' hall (POST /api/gds/auth/cli-token/issue)
+// Accept a CLI bearer minted by the builders' hall (POST /api/bongos/auth/cli-token/issue)
 // and write it into ~/.config/otb/bongos-session.json. Preserves any existing
 // fields (notably gemini_api_key registered via /builder-setup) so a token
 // paste never silently un-registers a builder's Gemini key.
@@ -14,7 +14,7 @@
 // builder can copy + paste a single line.
 //
 // Safety contract:
-//   1. The token is verified against /api/gds/me BEFORE the session file is
+//   1. The token is verified against /api/bongos/me BEFORE the session file is
 //      touched. A bad paste exits non-zero with a clear message and leaves
 //      the existing session intact.
 //   2. The file is written with mode 0600, same as setup.js.
@@ -70,7 +70,7 @@ async function main() {
   //    paste was meant to REPLACE, not destroy.
   let me;
   try {
-    const res = await fetch(`${API_BASE}/api/gds/me`, {
+    const res = await fetch(`${API_BASE}/api/bongos/me`, {
       headers: { Authorization: `Bearer ${token}` },
     });
     if (res.status === 401) {

package/scripts/gds/portability-smoke-memory.sh

@@ -109,11 +109,11 @@ if [ -z "$REMOTE" ]; then bad "could not resolve origin remote for fresh-clone t
 fi
 
 # --- 3. unauthenticated memory read is rejected (guard) ----------------------
-code=$(curl -sS -o /dev/null -w '%{http_code}' "$BASE/api/gds/memory/files" || echo 000)
+code=$(curl -sS -o /dev/null -w '%{http_code}' "$BASE/api/bongos/memory/files" || echo 000)
 [ "$code" = "401" ] && ok "unauth GET /memory/files → 401" || bad "unauth GET /memory/files → $code (expected 401)"
 
 # --- 4. authenticated builder can pull their server-canonical memory ---------
-FILES_JSON=$(curl -sS -H "Authorization: Bearer $TOKEN" "$BASE/api/gds/memory/files" || echo '{}')
+FILES_JSON=$(curl -sS -H "Authorization: Bearer $TOKEN" "$BASE/api/bongos/memory/files" || echo '{}')
 COUNT=$(echo "$FILES_JSON" | python3 -c "import json,sys;print(json.load(sys.stdin).get('count',-1))" 2>/dev/null || echo -1)
 if [ "$COUNT" -ge 1 ] 2>/dev/null; then
   ok "authenticated pull lists $COUNT server-canonical memory file(s)"
@@ -125,7 +125,7 @@ fi
 # Take the first listed file, fetch it, recompute sha256, compare to server's.
 FIRST_PATH=$(echo "$FILES_JSON" | python3 -c "import json,sys;f=json.load(sys.stdin).get('files',[]);print(f[0]['path'] if f else '')" 2>/dev/null || echo "")
 if [ -n "$FIRST_PATH" ]; then
-  VERDICT=$(curl -sS -H "Authorization: Bearer $TOKEN" --get "$BASE/api/gds/memory/file" --data-urlencode "path=$FIRST_PATH" \
+  VERDICT=$(curl -sS -H "Authorization: Bearer $TOKEN" --get "$BASE/api/bongos/memory/file" --data-urlencode "path=$FIRST_PATH" \
     | python3 -c "
 import json,sys,hashlib
 d=json.load(sys.stdin)
@@ -158,9 +158,9 @@ if [ "${GDS_SMOKE_ALLOW_WRITE:-0}" = "1" ] && [ "$TOKEN_SRC" = "env" ]; then
   PUSH_BODY=$(python3 -c "import json,sys;print(json.dumps({'files':[{'path':'$SPATH','content':sys.argv[1]}]}))" "$STAMP")
   PUSH_CODE=$(curl -sS -o /dev/null -w '%{http_code}' -X POST \
     -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-    "$BASE/api/gds/memory/sync" -d "$PUSH_BODY" || echo 000)
+    "$BASE/api/bongos/memory/sync" -d "$PUSH_BODY" || echo 000)
   if [ "$PUSH_CODE" = "200" ]; then
-    RT=$(curl -sS -H "Authorization: Bearer $TOKEN" --get "$BASE/api/gds/memory/file" --data-urlencode "path=$SPATH" \
+    RT=$(curl -sS -H "Authorization: Bearer $TOKEN" --get "$BASE/api/bongos/memory/file" --data-urlencode "path=$SPATH" \
       | python3 -c "import json,sys;d=json.load(sys.stdin);print('OK' if d.get('content')==sys.argv[1] else 'MISMATCH')" "$STAMP" 2>/dev/null || echo ERR)
     [ "$RT" = "OK" ] && ok "push→pull sync round-trip (content persisted + retrieved intact)" \
                      || bad "push→pull round-trip content mismatch ($RT)"

package/scripts/gds/prove-strict-versioning.js

@@ -71,14 +71,14 @@ function errorCode(body) {
 
 /** GET a Bongos API path, returning the parsed body. Throws on a non-2xx. */
 async function get(path) {
-  const r = await apiCall('GET', `/api/gds${path}`);
+  const r = await apiCall('GET', `/api/bongos${path}`);
   if (!r.ok) throw new Error(`GET ${path} → ${r.status}`);
   return r.data;
 }
 
 /** POST a probe. Returns the status WITHOUT throwing — the status IS the proof. */
 async function probePost(path, body) {
-  const r = await apiCall('POST', `/api/gds${path}`, body || {});
+  const r = await apiCall('POST', `/api/bongos${path}`, body || {});
   return { status: r.status, body: r.data, why: errorCode(r.data) };
 }
 

package/scripts/gds/provision-net.js

@@ -55,7 +55,7 @@ function shouldFederate(inst, deps) {
 // device sign-in (and a wrong origin would be a takeover vector). client_id is the
 // (unique, DNS-safe) slug, so a re-provision rotates the SAME row's secret via
 // registerClient's ON CONFLICT rather than orphaning a client. redirect_uri lists both
-// callback prefixes the core may emit (/api/gds is what auth.js builds today) so the
+// callback prefixes the core may emit (/api/bongos is what auth.js builds today) so the
 // hub's exact-match allow-list accepts the browser leg. --apply gates the real hub
 // write; dry-run returns a placeholder block (so webEnvBody can still be composed) + logs.
 async function federateInstance(inst, deps) {
@@ -246,7 +246,7 @@ function healthzCmd(inst) {
 
 // The instance manifest, read over loopback — the identity companion to healthzCmd (task 1003740).
 function identityCmd(inst) {
-  return `curl -sS --max-time 5 http://127.0.0.1:${inst.port}/api/gds/instance`;
+  return `curl -sS --max-time 5 http://127.0.0.1:${inst.port}/api/bongos/instance`;
 }
 
 // Does a freshly provisioned instance report ITSELF, or the platform it is hosted on?

package/scripts/gds/provision-units.js

@@ -153,7 +153,7 @@ WantedBy=timers.target
 //
 // The pin outlived it, and src/branding.js's ENV_OVERRIDES cover domains, auth.idp and landing —
 // never `identity.productName`. So every hosted instance kept serving the NEUTRAL pack's name:
-// GET /api/gds/instance on hermeslines-marketing, mercury and demo all answered "Cloud Bongos"
+// GET /api/bongos/instance on hermeslines-marketing, mercury and demo all answered "Cloud Bongos"
 // while each instance's own pack on disk said otherwise, and `bongos login <instance>` greeted a
 // newcomer with the platform's name at the moment they were deciding whether to trust it.
 //
@@ -310,10 +310,10 @@ function settingsEnvVarsFor(inst) {
 }
 
 // The instance's own public manifest — the settings read-back ADR 0190 names
-// (GET /api/gds/instance → brand.project). Sibling of provision-net's healthzCmd:
+// (GET /api/bongos/instance → brand.project). Sibling of provision-net's healthzCmd:
 // same loopback + timeout, a different question ("did you READ it?").
 function instanceManifestCmd(inst) {
-  return `curl -sS --max-time 5 http://127.0.0.1:${inst.port}/api/gds/instance`;
+  return `curl -sS --max-time 5 http://127.0.0.1:${inst.port}/api/bongos/instance`;
 }
 
 // Did the restarted instance CONSUME the pushed settings? Compares each key of

package/scripts/gds/pulse.js

@@ -15,7 +15,7 @@
 //
 // -------------------------------------------------------------------------
 // Pulse-mode follow-up note (unchanged from original):
-//   POST /api/gds/pulse is NOT yet wired (route lives in src/bongos/routes.js,
+//   POST /api/bongos/pulse is NOT yet wired (route lives in src/bongos/routes.js,
 //   which is OUT of THAT task's touches[]). Once a follow-up task adds
 //   the route, the pulse path starts working with no changes. Until then,
 //   running it will print a 404 from the server — that is expected.
@@ -314,7 +314,7 @@ async function releaseStale({ timer, dryRun }) {
   const r = await api.request('POST', '/pulse', { body: { claim_id: claimId } });
   if (!r.ok) {
     // Fire-and-forget: log the diagnostic but do not fail.
-    // Until the /api/gds/pulse route is mounted, this routinely returns 404.
+    // Until the /api/bongos/pulse route is mounted, this routinely returns 404.
     console.error(`pulse non-ok (status ${r.status}):`, r.data);
     process.exit(0);
   }

package/scripts/gds/push-path-brief.js

@@ -18,7 +18,7 @@
 // strand-watch.js. On the server-publish path (pushVia() 'server' — no authenticated
 // gh, i.e. a dev box or any credential-less checkout) it prints ONE line stating the
 // credential model and where the truth about published work lives
-// (GET /api/gds/tasks/:id/publish-status). On a laptop that pushes locally
+// (GET /api/bongos/tasks/:id/publish-status). On a laptop that pushes locally
 // (pushVia() 'local') it prints NOTHING — a line that fires on every healthy laptop
 // becomes wallpaper and the real one gets scrolled past (the strand-watch lesson).
 //
@@ -40,7 +40,7 @@ const BRIEF = 'This machine holds NO GitHub push credential — BY DESIGN (ADR 0
   + 'git push / ls-remote / fetch against origin fail with auth errors here, and that is not a fault to fix. '
   + 'Landing is server-mediated — /builder-ship uploads a git bundle and the SERVER pushes, opens the PR, and lands it. '
   + 'NEVER ask the owner for a PAT or credential; that request is always wrong on this machine. '
-  + 'To see whether work reached GitHub, use GET /api/gds/tasks/:id/publish-status — never raw git probes.';
+  + 'To see whether work reached GitHub, use GET /api/bongos/tasks/:id/publish-status — never raw git probes.';
 
 // briefLine(via) — the unit-testable core: the SessionStart line for this publish
 // path, or null. Null IS the silence (the laptop case, and the undetermined case —

package/scripts/gds/reauth.js

@@ -11,7 +11,7 @@
 // getting back in — the slow Device Flow, terminal codes, Gemini-key prompts — is
 // not something to keep. This script is the fix:
 //
-//   1. Detect — is the current session still valid? (GET /api/gds/me)
+//   1. Detect — is the current session still valid? (GET /api/bongos/me)
 //        valid   → print who you are + exit 0. Nothing to do.
 //        invalid → exit 10 ("re-auth needed") after opening the browser.
 //   2. Guide — open the builder's Settings page in the default browser (where

package/scripts/gds/recall.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 // scripts/gds/recall.js — one-call project-knowledge search (task 955, V4.R17 /
-// ADR 0060). Wraps POST /api/gds/search: lexical (FTS + pg_trgm) fused with RRF,
+// ADR 0060). Wraps POST /api/bongos/search: lexical (FTS + pg_trgm) fused with RRF,
 // rank/owner-scoped server-side (a sub-Metic caller never sees protected docs;
 // you only ever see your own private chunks). Authenticated — reads the builder
 // session like every other /builder-* CLI.

package/scripts/gds/redteam-patrol.js

@@ -28,7 +28,7 @@
 //
 // Filing: DRY-RUN by default (prints what it would file). --file POSTs one
 // report PER CLASS (max severity within the class, details in repro_steps_md)
-// to /api/gds/security/reports. --canary proves the end-to-end pipe: plants a
+// to /api/bongos/security/reports. --canary proves the end-to-end pipe: plants a
 // constructed token, asserts the scanner catches it, files a low "[canary]"
 // report, and dispute-closes it so the queue stays clean.
 //
@@ -317,14 +317,14 @@ function filingBlocker() {
 
 async function fileReport(report) {
   const { apiCall } = require('./cli-lib.js');
-  const r = await apiCall('POST', '/api/gds/security/reports', report);
+  const r = await apiCall('POST', '/api/bongos/security/reports', report);
   const row = (r.data && r.data.report) || {};
   return row.id || null;
 }
 
 async function disputeReport(id, note) {
   const { apiCall } = require('./cli-lib.js');
-  return apiCall('POST', `/api/gds/security/reports/${id}/dispute`, { note });
+  return apiCall('POST', `/api/bongos/security/reports/${id}/dispute`, { note });
 }
 
 // ---------- canary ----------