@bongos/core 1.21.64 → 1.21.66

package/docs/copy-registry.json

@@ -3,17 +3,17 @@
   "generator": "scripts/gds/copy-inventory.js",
   "goal": 1000074,
   "counts": {
-    "strings": 2557,
-    "unique_ids": 2184,
-    "certain": 2557,
+    "strings": 2556,
+    "unique_ids": 2183,
+    "certain": 2556,
     "heuristic": 0,
     "duplicate_ids": 227
   },
   "surfaces": {
     "builders-hall": {
       "at": "modules/hall-ui/public",
-      "files": 134,
-      "strings": 1829
+      "files": 133,
+      "strings": 1828
     },
     "status-dashboard": {
       "at": "modules/status-ui/public",
@@ -669,7 +669,7 @@
       "at": [
         "modules/hall-ui/public/profile-charts.js:605",
         "modules/hall-ui/public/profile.js:841",
-        "modules/hall-ui/public/profile.js:982"
+        "modules/hall-ui/public/profile.js:977"
       ]
     },
     {
@@ -2659,7 +2659,7 @@
       "surface": "builders-hall",
       "text": ", or",
       "file": "modules/hall-ui/public/profile.js",
-      "line": 982,
+      "line": 977,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -3037,7 +3037,7 @@
       "surface": "builders-hall",
       "text": "Activity, by role",
       "file": "modules/hall-ui/public/profile.html",
-      "line": 137,
+      "line": 138,
       "origin": "html-text",
       "confidence": "certain"
     },
@@ -3883,7 +3883,7 @@
       "surface": "builders-hall",
       "text": "By the numbers",
       "file": "modules/hall-ui/public/profile.html",
-      "line": 64,
+      "line": 65,
       "origin": "html-text",
       "confidence": "certain"
     },
@@ -4900,7 +4900,7 @@
       "surface": "builders-hall",
       "text": "Could not load the profile.",
       "file": "modules/hall-ui/public/profile.js",
-      "line": 1059,
+      "line": 1054,
       "origin": "js-notice",
       "confidence": "certain"
     },
@@ -5458,7 +5458,7 @@
       "surface": "builders-hall",
       "text": "Cross-project record",
       "file": "modules/hall-ui/public/profile.html",
-      "line": 98,
+      "line": 99,
       "origin": "html-text",
       "confidence": "certain"
     },
@@ -6016,7 +6016,7 @@
       "surface": "builders-hall",
       "text": "Everything this builder has shipped. Seen one role at a time, with goals and ideas, under",
       "file": "modules/hall-ui/public/profile.html",
-      "line": 112,
+      "line": 113,
       "origin": "html-text",
       "confidence": "certain"
     },
@@ -6673,7 +6673,7 @@
       "surface": "builders-hall",
       "text": "Goals created",
       "file": "modules/hall-ui/public/profile.html",
-      "line": 153,
+      "line": 154,
       "origin": "html-text",
       "confidence": "certain"
     },
@@ -7843,7 +7843,7 @@
       "surface": "builders-hall",
       "text": "Loading profile…",
       "file": "modules/hall-ui/public/profile.html",
-      "line": 35,
+      "line": 36,
       "origin": "html-text",
       "confidence": "certain"
     },
@@ -8527,7 +8527,7 @@
       "surface": "builders-hall",
       "text": "No builder selected. Open a builder from the",
       "file": "modules/hall-ui/public/profile.js",
-      "line": 982,
+      "line": 977,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -9688,7 +9688,7 @@
       "surface": "builders-hall",
       "text": "Over time",
       "file": "modules/hall-ui/public/profile.html",
-      "line": 76,
+      "line": 77,
       "origin": "html-text",
       "confidence": "certain"
     },
@@ -9994,7 +9994,7 @@
       "surface": "builders-hall",
       "text": "Profile sections",
       "file": "modules/hall-ui/public/profile.html",
-      "line": 45,
+      "line": 46,
       "origin": "html-attr:aria-label",
       "confidence": "certain"
     },
@@ -11150,15 +11150,6 @@
       "origin": "js-markup",
       "confidence": "certain"
     },
-    {
-      "id": "a9c398651862",
-      "surface": "builders-hall",
-      "text": "See the cross-project record",
-      "file": "modules/hall-ui/public/profile-canonical.js",
-      "line": 114,
-      "origin": "js-markup",
-      "confidence": "certain"
-    },
     {
       "id": "17d5b5739f46",
       "surface": "builders-hall",
@@ -14476,7 +14467,7 @@
       "surface": "builders-hall",
       "text": "What this builder has done, seen one role at a time.",
       "file": "modules/hall-ui/public/profile.html",
-      "line": 138,
+      "line": 139,
       "origin": "html-text",
       "confidence": "certain"
     },
@@ -14800,7 +14791,7 @@
       "surface": "builders-hall",
       "text": "Works completed",
       "file": "modules/hall-ui/public/profile.html",
-      "line": 148,
+      "line": 149,
       "origin": "html-text",
       "confidence": "certain"
     },
@@ -17050,7 +17041,7 @@
       "surface": "builders-hall",
       "text": "sign in",
       "file": "modules/hall-ui/public/profile.js",
-      "line": 982,
+      "line": 977,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -17356,7 +17347,7 @@
       "surface": "builders-hall",
       "text": "the page everyone else reads",
       "file": "modules/hall-ui/public/profile.html",
-      "line": 33,
+      "line": 34,
       "origin": "html-text",
       "confidence": "certain"
     },
@@ -17518,7 +17509,7 @@
       "surface": "builders-hall",
       "text": "to see your own profile.",
       "file": "modules/hall-ui/public/profile.js",
-      "line": 982,
+      "line": 977,
       "origin": "js-markup",
       "confidence": "certain"
     },

package/docs/file-map.md

@@ -98,7 +98,7 @@
 │   └── <redacted>.sql ← task 615: rename disciplines engineering→engineer, creative→artist|ideator; swaps both CHECK constraints + backfills tasks.discipline & builders.preferred_disciplines
 ├── modules/                    ← self-contained optional feature modules (ADR 0083 / docs/modules-contract.md). Each `modules/<key>/` is a full vertical slice — routes, migrations, skills, seam registrations — reached only through src/module-api.js. The loader discovers them at boot; no core file changes to add one.
 │   ├── game/                   ← the playable Example world — Phaser client, Colyseus rooms (WorldRoom/QueueRoom), world/terrain model, game DB tables, static assets. Moved BV1.R49 (task 1418). CLAUDE.md, module.json, routes/game.js, rooms/, world/, public/, migrations/.
-│   ├── discord/                ← outbound ship broadcast + inbound #ideas/#bugs bot + role-sync + channel management + account-link state + the Board Room mirror. Mirror only, never authority (ADR 0033). CLAUDE.md, module.json, routes/discord.js, routes/bug-attachments.js, discord-bot.js, discord-lib.js, board-broadcast.js (announce a window / edit the outcome onto it — R21/R22 of goal 1000069), migrations/discord_001_board_messages.sql.
+│   ├── discord/                ← outbound ship broadcast + inbound #ideas/#bugs bot + role-sync + channel management + account-link state + the Board Room mirror. Mirror only, never authority (ADR 0033). CLAUDE.md, module.json, routes/discord.js, routes/bug-attachments.js, discord-bot.js, discord-lib.js, board-broadcast.js (announce a window / edit the outcome onto it — R21/R22 of goal 1000069), discord-support.js (the #support answerer: @-mention → public-docs answer, read-only, monthly cap — ADR 0367), migrations/discord_001_board_messages.sql.
 │   ├── art-pipeline/           ← self-improving pixel-art generation pipeline (its otb-* skills are the pixel-art module's since task 1004470; artist is a core discipline since ADR 0272). CLAUDE.md, module.json, routes/art-key.js, art/ (lives under art/ at repo root; module owns the route and discipline entry).
 │   ├── memory/                 ← CORE-DOMAIN carve (BV1.R72, default-on): per-builder session memory + the recall/search retrieval layer (ADR 0060) + learnings. CLAUDE.md, module.json, routes/{memory,search,learnings}.js, memory.js, search.js, search-chunker.js, learnings.js.
 │   ├── grading/                ← CORE-DOMAIN carve (BV1.R73, default-on): the grade-a-diff adversarial worker panel + deterministic pre-passes + rubric; registers the `grade` kernel port. CLAUDE.md, module.json, routes/grade.js, grader.js, grader-rubric.json.

package/docs/module-api-changelog.md

@@ -2960,5 +2960,9 @@ is load-bearing: the script throws rather than guess if it is missing, and
         stays and still answers the profile alone.
   1.21.64 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
         landed since 1.21.63 with no explicit bump. run 37477390735. (task 1002620)
+  1.21.65 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
+        landed since 1.21.64 with no explicit bump. run 37482378254. (task 1002620)
+  1.21.66 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
+        landed since 1.21.65 with no explicit bump. run 37486828045. (task 1002620)
 ---------------------------------------------------------------------------
 ```

package/docs/page-inventory.json

@@ -758,7 +758,6 @@
         "modules/hall-ui/public/hall-visual.js",
         "modules/hall-ui/public/hall-kit.js",
         "modules/hall-ui/public/profile-connections.js",
-        "modules/hall-ui/public/profile-canonical.js",
         "modules/hall-ui/public/profile-charts.js",
         "modules/hall-ui/public/founding-mark.js",
         "modules/hall-ui/public/profile-roles.js",

package/docs/page-readings.json

@@ -2374,7 +2374,7 @@
       "surface": "builders",
       "title": "Profile",
       "states_read": ["own","works","activity","activity-artist","activity-ideator","other","artist","ideator","out"],
-      "files_hash": "6fe4be25444cf73f",
+      "files_hash": "47ded1e58ca035ec",
       "reading_hash": "8d48fe73a48c9fc3",
       "counts": {"lines":200,"placed":72,"shared":9,"unplaced":119},
       "omitted": {"data":195},
@@ -2388,7 +2388,7 @@
         {"key":"L0006","section":"top bar","text":"Artistry","placement":"shared"},
         {"key":"L0007","section":"top bar","text":"Ideating","placement":"shared"},
         {"key":"L0008","section":"top bar","text":"Governing","placement":"shared"},
-        {"key":"L0009","section":"page top","text":"the page everyone else reads","placement":"placed","file":"modules/hall-ui/public/profile.html","line":33,"string_id":"95854f8315ca"},
+        {"key":"L0009","section":"page top","text":"the page everyone else reads","placement":"placed","file":"modules/hall-ui/public/profile.html","line":34,"string_id":"95854f8315ca"},
         {"key":"L0010","section":"profile","text":"profile","placement":"unplaced"},
         {"key":"L0011","section":"profile","text":"{…} file{…}","placement":"placed","file":"modules/hall-ui/public/gate.js","line":151,"string_id":"3efa67dc6e07","state":"activity-ideator","occurrences":2},
         {"key":"L0012","section":"profile","text":"{…} — {…} · 9 pages approved","placement":"unplaced","state":"activity-artist"},
@@ -2400,8 +2400,8 @@
         {"key":"L0018","section":"profile","text":"Member since {…}","placement":"placed","file":"modules/hall-ui/public/profile.js","line":118,"string_id":"df335a1224ae","state":"ideator","occurrences":3},
         {"key":"L0019","section":"profile","text":"Ideator, {…} role","placement":"unplaced","state":"ideator"},
         {"key":"L0020","section":"profile","text":"Artist, {…} role","placement":"unplaced","state":"artist"},
-        {"key":"L0021","section":"Activity, by role","text":"Activity, by role","placement":"placed","file":"modules/hall-ui/public/profile.html","line":137,"string_id":"d628b36ec58e","state":"activity"},
-        {"key":"L0022","section":"Activity, by role","text":"What this builder has done, seen one role at a time.","placement":"placed","file":"modules/hall-ui/public/profile.html","line":138,"string_id":"a444ad812e4f","state":"activity"},
+        {"key":"L0021","section":"Activity, by role","text":"Activity, by role","placement":"placed","file":"modules/hall-ui/public/profile.html","line":138,"string_id":"d628b36ec58e","state":"activity"},
+        {"key":"L0022","section":"Activity, by role","text":"What this builder has done, seen one role at a time.","placement":"placed","file":"modules/hall-ui/public/profile.html","line":139,"string_id":"a444ad812e4f","state":"activity"},
         {"key":"L0023","section":"Activity, by role","text":"Artist","placement":"unplaced","state":"activity-artist"},
         {"key":"L0024","section":"Activity, by role","text":"Ideator","placement":"unplaced","state":"activity"},
         {"key":"L0025","section":"Activity, by role","text":"{…} file{…}","placement":"placed","file":"modules/hall-ui/public/gate.js","line":151,"string_id":"3efa67dc6e07","state":"activity-ideator","occurrences":3},
@@ -2446,7 +2446,7 @@
         {"key":"L0064","section":"Activity, by role","text":"after","placement":"unplaced","state":"activity-artist","occurrences":4},
         {"key":"L0065","section":"footer","text":"Sign out","placement":"shared","file":"modules/hall-ui/public/shell.js","line":471,"string_id":"1883ad7f07fc","state":"activity-artist","occurrences":4},
         {"key":"L0066","section":"Activity, by role","text":"Builders hall · this session","placement":"placed","file":"modules/hall-ui/public/craft-mode.js","line":352,"string_id":"fd1903586e8e","state":"activity-artist"},
-        {"key":"L0067","section":"Works completed","text":"Works completed","placement":"placed","file":"modules/hall-ui/public/profile.html","line":148,"string_id":"0e6b8e8f26cc","state":"activity"},
+        {"key":"L0067","section":"Works completed","text":"Works completed","placement":"placed","file":"modules/hall-ui/public/profile.html","line":149,"string_id":"0e6b8e8f26cc","state":"activity"},
         {"key":"L0068","section":"Works completed","text":"Role","placement":"unplaced","state":"activity"},
         {"key":"L0069","section":"Works completed","text":"Shipped","placement":"placed","file":"modules/hall-ui/public/task.js","line":677,"string_id":"0c0a50ba1666","state":"activity"},
         {"key":"L0070","section":"Works completed","text":"{…} file{…}","placement":"placed","file":"modules/hall-ui/public/gate.js","line":151,"string_id":"3efa67dc6e07","state":"activity","occurrences":3},
@@ -2459,7 +2459,7 @@
         {"key":"L0077","section":"Works completed","text":"‹ Prev","placement":"placed","file":"modules/hall-ui/public/hall-kit.js","line":74,"string_id":"de8fa5223aee","state":"activity"},
         {"key":"L0078","section":"Works completed","text":"Page {…} of {…}","placement":"placed","file":"modules/hall-ui/public/hall-kit.js","line":112,"string_id":"15a49bf15007","state":"activity"},
         {"key":"L0079","section":"Works completed","text":"Next ›","placement":"placed","file":"modules/hall-ui/public/hall-kit.js","line":74,"string_id":"f52ba261d930","state":"activity"},
-        {"key":"L0080","section":"Goals created","text":"Goals created","placement":"placed","file":"modules/hall-ui/public/profile.html","line":153,"string_id":"6a85997bda21","state":"activity"},
+        {"key":"L0080","section":"Goals created","text":"Goals created","placement":"placed","file":"modules/hall-ui/public/profile.html","line":154,"string_id":"6a85997bda21","state":"activity"},
         {"key":"L0081","section":"Goals created","text":"Goal","placement":"placed","file":"modules/hall-ui/public/gate.js","line":360,"string_id":"ec88b946ad16","state":"activity"},
         {"key":"L0082","section":"Goals created","text":"Roles","placement":"unplaced","state":"activity"},
         {"key":"L0083","section":"Goals created","text":"Progress","placement":"unplaced","state":"activity"},
@@ -2467,7 +2467,7 @@
         {"key":"L0085","section":"Goals created","text":"{…} and {…}","placement":"placed","file":"modules/hall-ui/public/profile-nudge.js","line":77,"string_id":"56b00d773232","state":"activity"},
         {"key":"L0086","section":"Goals created","text":"Builders hall · this session","placement":"placed","file":"modules/hall-ui/public/craft-mode.js","line":352,"string_id":"fd1903586e8e","state":"activity"},
         {"key":"L0087","section":"Works","text":"Works","placement":"unplaced","state":"works"},
-        {"key":"L0088","section":"Works","text":"Everything this builder has shipped. Seen one role at a time, with goals and ideas, under","placement":"placed","file":"modules/hall-ui/public/profile.html","line":112,"string_id":"37110f7e2b27","state":"works"},
+        {"key":"L0088","section":"Works","text":"Everything this builder has shipped. Seen one role at a time, with goals and ideas, under","placement":"placed","file":"modules/hall-ui/public/profile.html","line":113,"string_id":"37110f7e2b27","state":"works"},
         {"key":"L0089","section":"Works","text":"activity","placement":"unplaced","state":"works"},
         {"key":"L0090","section":"Works","text":"Credits","placement":"unplaced","state":"works"},
         {"key":"L0091","section":"Works","text":"Shipped","placement":"placed","file":"modules/hall-ui/public/task.js","line":677,"string_id":"0c0a50ba1666","state":"works"},
@@ -2485,7 +2485,7 @@
         {"key":"L0103","section":"profile","text":"this week","placement":"unplaced","state":"artist"},
         {"key":"L0104","section":"profile","text":"works {…}","placement":"unplaced"},
         {"key":"L0105","section":"profile","text":"karma","placement":"unplaced"},
-        {"key":"L0106","section":"By the numbers","text":"By the numbers","placement":"placed","file":"modules/hall-ui/public/profile.html","line":64,"string_id":"181cfa50b127"},
+        {"key":"L0106","section":"By the numbers","text":"By the numbers","placement":"placed","file":"modules/hall-ui/public/profile.html","line":65,"string_id":"181cfa50b127"},
         {"key":"L0107","section":"By the numbers","text":"works {…}","placement":"unplaced"},
         {"key":"L0108","section":"By the numbers","text":"all kinds, see below","placement":"unplaced"},
         {"key":"L0109","section":"By the numbers","text":"karma","placement":"unplaced"},
@@ -2508,7 +2508,7 @@
         {"key":"L0126","section":"pages tweaked, per surface","text":"pages tweaked, per surface","placement":"placed","file":"modules/hall-ui/public/profile.js","line":183,"string_id":"356573640ce1","state":"artist"},
         {"key":"L0127","section":"pages tweaked, per surface","text":"{…} of {…}","placement":"placed","file":"modules/hall-ui/public/sky-panel.js","line":120,"string_id":"73c1372b43d9","state":"artist","occurrences":3},
         {"key":"L0128","section":"By the numbers","text":"2 ignited","placement":"unplaced"},
-        {"key":"L0129","section":"Over time","text":"Over time","placement":"placed","file":"modules/hall-ui/public/profile.html","line":76,"string_id":"695ffff13730"},
+        {"key":"L0129","section":"Over time","text":"Over time","placement":"placed","file":"modules/hall-ui/public/profile.html","line":77,"string_id":"695ffff13730"},
         {"key":"L0130","section":"Over time","text":"30 days","placement":"unplaced"},
         {"key":"L0131","section":"Over time","text":"90 days","placement":"unplaced"},
         {"key":"L0132","section":"Over time","text":"1 year","placement":"unplaced"},
@@ -2548,7 +2548,7 @@
         {"key":"L0166","section":"Achievements","text":"Achievements","placement":"unplaced"},
         {"key":"L0167","section":"Achievements","text":"No achievements earned yet.","placement":"placed","file":"modules/hall-ui/public/profile.js","line":199,"string_id":"c255749ec989","state":"ideator"},
         {"key":"L0168","section":"Achievements","text":"Won {…}","placement":"placed","file":"modules/hall-ui/public/profile.js","line":206,"string_id":"c5fd76a9e03d","occurrences":2},
-        {"key":"L0169","section":"Cross-project record","text":"Cross-project record","placement":"placed","file":"modules/hall-ui/public/profile.html","line":98,"string_id":"a55e423263f0"},
+        {"key":"L0169","section":"Cross-project record","text":"Cross-project record","placement":"placed","file":"modules/hall-ui/public/profile.html","line":99,"string_id":"a55e423263f0"},
         {"key":"L0170","section":"Cross-project record","text":"Works {…}","placement":"unplaced"},
         {"key":"L0171","section":"Cross-project record","text":"Credits","placement":"unplaced"},
         {"key":"L0172","section":"Cross-project record","text":"Karma","placement":"unplaced"},

package/modules/discord/db.js

@@ -79,6 +79,36 @@ async function countRecentDiscordBugFilings(builderId, sinceIso) {
   return rows[0].n;
 }
 
+// --- the #support answerer's ledger (task 1002534, ADR 0367) -----------------
+//
+// The bot's own builders row (migration 067, system_role='discord_bot'): the
+// principal an answer is booked to. The asker is never looked up.
+async function getBotPrincipalId() {
+  const { rows } = await pool.query(
+    `SELECT id FROM builders WHERE system_role = 'discord_bot' ORDER BY id LIMIT 1`
+  );
+  return rows.length ? Number(rows[0].id) : null;
+}
+
+// Month-to-date #support spend, the UTC calendar month, summed from the cost each
+// answer's audit row carries. The monthly cap reads this, so it survives a
+// restart. Throws on a DB error; the caller treats that as "no answer".
+// INDEXED: `route = $1 AND recorded_at >= <month start>` is exactly the shape of
+// migrations/033_audit_log.sql's idx_audit_log_route (route, recorded_at DESC), so
+// this reads one month of one route's rows, never a scan of the whole log. It
+// runs once per answer, after the free checks (rate limit, cap, concurrency).
+async function sumSupportSpendThisMonth(route = 'discord:support') {
+  const { rows } = await pool.query(
+    `SELECT COALESCE(SUM((request_body_redacted->>'cost_usd')::numeric), 0)::float8 AS usd
+       FROM audit_log
+      WHERE route = $1
+        AND surface = 'discord_bot'
+        AND recorded_at >= date_trunc('month', now() AT TIME ZONE 'UTC') AT TIME ZONE 'UTC'`,
+    [route]
+  );
+  return Number(rows[0].usd) || 0;
+}
+
 // --- the board mirror's own bookkeeping (R22 of goal 1000069) ----------------
 //
 // Which message announced which board item, so the close can be EDITED onto the
@@ -137,6 +167,8 @@ module.exports = {
   getDiscordLink,
   getDiscordLinks,
   countRecentDiscordBugFilings,
+  getBotPrincipalId,
+  sumSupportSpendThisMonth,
   recordApplause,
   recordBoardMessage,
   getBoardMessage,

package/modules/discord/discord-bot.js

@@ -471,6 +471,20 @@ async function start() {
       channelId: bugsChannelId, aggregator: bugAggregator, logLabel: 'bug handler',
     }));
 
+    // #support answers (task 1002534, ADR 0367): an @-mention in the pinned
+    // support channel gets a short answer from the public docs. Read-only, its
+    // own kill switch (DISCORD_SUPPORT_ENABLED) on top of this one, and a
+    // monthly spend cap. Everything lives in discord-support.js; it is the
+    // first feature that REPLIES through the gateway, so the bot needs Send
+    // Messages in that one channel.
+    const support = require('./discord-support').createLiveSupport({ client: c, db });
+    if (support.handler) {
+      c.on(Events.MessageCreate, support.handler);
+      log.info(`[discord-bot] answering @-mentions in #support (${support.channelId}), cap $${support.capUsd}/month.`);
+    } else {
+      log.info(`[discord-bot] #support answers are inert (${support.inertReason}).`);
+    }
+
     // Role-on-arrival (F7, ADR 0033 — the link-first onboarding gate's safety
     // net). The auto-join path (routes/auth.js) already sets the rank role at
     // add-time, so a builder who linked-then-joined is correct immediately. This