@bongos/core 1.25.10 → 1.25.12

package/docs/page-readings.json

@@ -5,7 +5,7 @@
   "adr": "0341 D3",
   "reread": "node scripts/bongos/page-reader.js --stale",
   "how": ["Generated by node scripts/bongos/page-reader.js (BV2.TW04, task 1004315; ADR 0341 D3). Do not hand-edit.","One entry per page of docs/page-inventory.json. Lines are in page order: the default state first, and a line only another state shows sits where that state shows it, with its state named.","placement: placed = a docs/copy-registry.json row renders it (file, line, string_id); shared = shell text every page of the surface carries (top bar, sidebar, footer), with its row when the registry has one; unplaced = the registry cannot place it (a rewrite becomes an engineer task, ADR 0341 D4).","text keeps {…} where the registry row has a hole, or where a value the page read from its API was filled in. A string that is only such data is counted under omitted.data, not listed.","reading_hash is over the non-shared lines (key, section, text); files_hash is over the page's inventory files. --check compares files_hash only and never opens a browser.","Rendered through the hall-preview harness (hall) and the ui-design kit stub (landing, status), at 1280x800 with the clock pinned, so a reading is the fixture world's page."],
-  "counts": {"pages":45,"lines":4408,"placed":1635,"shared":369,"unplaced":2404,"omitted_data":2980},
+  "counts": {"pages":45,"lines":4408,"placed":1635,"shared":369,"unplaced":2404,"omitted_data":2981},
   "pages": [
     {
       "id": "builders:ai-studio",
@@ -283,7 +283,7 @@
       "surface": "builders",
       "title": "The city",
       "states_read": ["city","fullscreen","focus","pins","living","card","card-ask"],
-      "files_hash": "71c3ed36a93ff43e",
+      "files_hash": "3c25fd8c0304dc17",
       "reading_hash": "277096d903879a57",
       "counts": {"lines":26,"placed":9,"shared":6,"unplaced":11},
       "omitted": {"data":7},
@@ -2590,10 +2590,10 @@
       "surface": "builders",
       "title": "The street",
       "states_read": ["street","fullscreen","card","focus","here","inside-rules","inside-disputes","inside-people","inside-planning","inside-automation","inside-review","inside-release","inside-treasury","floor","amend","district","desk","desk-facts","desk-quiet","desk-people-builders","desk-people-tier","desk-disputes","desk-automation-goals","desk-release-core","desk-rules","desk-rules-category","desk-planning-priorities","desk-planning-ideas","desk-planning-blockers","pins","pins-pager","living","deck","deck-treasury","sitting","object","voted","admission","settled","blocker","blocker-more","report","report-more","core","core-more","recheck","recheck-more","idea","idea-more","queue","queue-more","automation","automation-more"],
-      "files_hash": "60c23fda46dd74d6",
-      "reading_hash": "e788e6bf4be8d68c",
+      "files_hash": "9f27d4ebab0219e6",
+      "reading_hash": "84dc42e85d9e23a3",
       "counts": {"lines":325,"placed":54,"shared":6,"unplaced":265},
-      "omitted": {"data":240},
+      "omitted": {"data":241},
       "notes": ["fullscreen: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","card: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","floor: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","amend: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","desk: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","desk-facts: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","desk-quiet: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","desk-people-builders: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","desk-people-tier: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","desk-disputes: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","desk-automation-goals: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","desk-release-core: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","desk-rules: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","desk-rules-category: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","desk-planning-priorities: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","desk-planning-ideas: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","desk-planning-blockers: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","pins: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","pins-pager: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","living: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","deck: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","deck-treasury: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","sitting: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","object: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","voted: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","admission: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","settled: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","blocker: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","blocker-more: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","report: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","report-more: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","core: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","core-more: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","recheck: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","recheck-more: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","idea: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","idea-more: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","queue: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","queue-more: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","automation: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood","automation-more: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood"],
       "lines": [
         {"key":"L0001","section":"skip link","text":"Skip to content","placement":"shared","file":"modules/hall-ui/public/shell.js","line":814,"string_id":"87cee78ca134"},
@@ -2618,7 +2618,7 @@
         {"key":"L0020","section":"page top","text":"5 need you","placement":"unplaced","state":"inside-disputes"},
         {"key":"L0021","section":"page top","text":"{…} in {…}","placement":"unplaced","state":"inside-rules"},
         {"key":"L0022","section":"page top","text":"Founding","placement":"unplaced","state":"here"},
-        {"key":"L0023","section":"page top","text":"{…} of {…}","placement":"placed","file":"modules/hall-ui/public/sky-panel.js","line":120,"string_id":"73c1372b43d9","state":"here","occurrences":4},
+        {"key":"L0023","section":"page top","text":"{…} of {…}","placement":"placed","file":"modules/hall-ui/public/sky-panel.js","line":120,"string_id":"73c1372b43d9","state":"here","occurrences":5},
         {"key":"L0024","section":"page top","text":"AI {…}","placement":"unplaced","state":"inside-treasury"},
         {"key":"L0025","section":"page top","text":"{…} to ratify","placement":"unplaced","state":"inside-planning"},
         {"key":"L0026","section":"page top","text":"New {…}","placement":"unplaced","state":"inside-rules"},
@@ -2658,142 +2658,142 @@
         {"key":"L0060","section":"page top","text":"Ranks","placement":"unplaced","state":"inside-people"},
         {"key":"L0061","section":"page top","text":"§5 Money","placement":"unplaced","state":"here"},
         {"key":"L0062","section":"page top","text":"{…} · decides a…","placement":"unplaced","state":"here"},
-        {"key":"L0063","section":"page top","text":"Goal {…}","placement":"placed","file":"modules/hall-ui/public/gate.js","line":202,"string_id":"ec88b946ad16","state":"inside-people"},
-        {"key":"L0064","section":"page top","text":"Live this month","placement":"unplaced","state":"inside-release"},
-        {"key":"L0065","section":"page top","text":"{…} · decides al…","placement":"unplaced","state":"here"},
-        {"key":"L0066","section":"page top","text":"empty floor","placement":"unplaced","state":"here","occurrences":6},
-        {"key":"L0067","section":"page top","text":"{…}'s office","placement":"unplaced","state":"here"},
-        {"key":"L0068","section":"page top","text":"no {…} · {…} holds it","placement":"unplaced","state":"here"},
-        {"key":"L0069","section":"{…}","text":"{…} and {…}","placement":"placed","file":"modules/hall-ui/public/profile-nudge.js","line":77,"string_id":"56b00d773232","state":"inside-treasury","occurrences":25},
-        {"key":"L0070","section":"{…}","text":"B","placement":"unplaced","state":"inside-treasury","occurrences":36},
-        {"key":"L0071","section":"{…}","text":"you","placement":"unplaced","state":"inside-treasury","occurrences":9},
-        {"key":"L0072","section":"{…}","text":"change how this works","placement":"placed","file":"modules/hall-ui/public/street.html","line":171,"string_id":"3c593c73628a","state":"inside-treasury","occurrences":9},
-        {"key":"L0073","section":"{…}","text":"{…} of {…}","placement":"placed","file":"modules/hall-ui/public/sky-panel.js","line":120,"string_id":"73c1372b43d9","state":"inside-treasury","occurrences":16},
-        {"key":"L0074","section":"{…}","text":"No {…} yet","placement":"unplaced","state":"inside-treasury","occurrences":9},
-        {"key":"L0075","section":"{…}","text":"{…} holds {…}","placement":"unplaced","state":"inside-treasury","occurrences":9},
-        {"key":"L0076","section":"{…}","text":"the office","placement":"unplaced","state":"inside-treasury","occurrences":9},
-        {"key":"L0077","section":"{…}","text":"to {…} here","placement":"unplaced","state":"inside-treasury","occurrences":5},
-        {"key":"L0078","section":"{…}","text":"1 to do","placement":"unplaced","state":"inside-treasury","occurrences":2},
-        {"key":"L0079","section":"{…}","text":"{…} in a row","placement":"unplaced","state":"inside-treasury","occurrences":5},
-        {"key":"L0080","section":"{…}","text":"the {…}","placement":"unplaced","state":"inside-treasury"},
-        {"key":"L0081","section":"{…}","text":"this month","placement":"unplaced","state":"inside-treasury"},
-        {"key":"L0082","section":"{…}","text":"in reserve","placement":"unplaced","state":"inside-treasury"},
-        {"key":"L0083","section":"{…}","text":"Spend cap","placement":"unplaced","state":"inside-treasury"},
-        {"key":"L0084","section":"{…}","text":"off · no spend limit, the {…}","placement":"unplaced","state":"inside-treasury"},
-        {"key":"L0085","section":"{…}","text":"pots per {…}","placement":"unplaced","state":"inside-treasury"},
-        {"key":"L0086","section":"{…}","text":"Governor / Builder /…","placement":"unplaced","state":"inside-treasury"},
-        {"key":"L0087","section":"{…}","text":"maintenance","placement":"unplaced","state":"inside-treasury"},
-        {"key":"L0088","section":"{…}","text":"Bongos Core distribution","placement":"unplaced","state":"inside-treasury"},
-        {"key":"L0089","section":"{…}","text":"Account creation, managem…","placement":"unplaced","state":"inside-treasury"},
-        {"key":"L0090","section":"{…}","text":"Government","placement":"unplaced","state":"inside-treasury"},
-        {"key":"L0091","section":"{…}","text":"and 9 smaller pots","placement":"unplaced","state":"inside-treasury"},
-        {"key":"L0092","section":"{…}","text":"floor 5","placement":"unplaced","state":"inside-treasury","occurrences":2},
-        {"key":"L0093","section":"Spending matters","text":"Spending matters","placement":"unplaced","state":"inside-treasury"},
-        {"key":"L0094","section":"Spending matters","text":"1 {…} · oldest 1 min","placement":"unplaced","state":"inside-treasury"},
-        {"key":"L0095","section":"Spending matters","text":"open","placement":"placed","file":"modules/hall-ui/public/approval-queue.js","line":173,"string_id":"9a803563c948","state":"inside-treasury"},
-        {"key":"L0096","section":"Spending matters","text":"on {…}","placement":"unplaced","state":"inside-treasury"},
-        {"key":"L0097","section":"Spending matters","text":"WA","placement":"unplaced","state":"inside-treasury"},
-        {"key":"L0098","section":"Spending matters","text":"{…} of {…}","placement":"placed","file":"modules/hall-ui/public/sky-panel.js","line":120,"string_id":"73c1372b43d9","state":"inside-treasury"},
-        {"key":"L0099","section":"Spending matters","text":"{…} from the reserve?","placement":"unplaced","state":"inside-treasury"},
-        {"key":"L0100","section":"Spending matters","text":"{…} · today","placement":"unplaced","state":"inside-treasury"},
-        {"key":"L0101","section":"Spending matters","text":"7 builders earned 5,5… · today","placement":"unplaced","state":"inside-treasury"},
-        {"key":"L0102","section":"Spending matters","text":"{…} · 4w","placement":"unplaced","state":"inside-treasury","occurrences":2},
-        {"key":"L0103","section":"Spending matters","text":"the record","placement":"placed","file":"modules/hall-ui/public/street.html","line":188,"string_id":"4bde7b562cf4","state":"inside-treasury"},
-        {"key":"L0104","section":"Spending matters","text":"1 matter on the docket · 16 on the {…}","placement":"unplaced","state":"inside-treasury"},
-        {"key":"L0105","section":"Spending matters","text":"oct","placement":"unplaced","state":"inside-treasury"},
-        {"key":"L0106","section":"Spending matters","text":"sep","placement":"unplaced","state":"inside-treasury"},
-        {"key":"L0107","section":"Spending matters","text":"aug","placement":"unplaced","state":"inside-treasury"},
-        {"key":"L0108","section":"Spending matters","text":"jul","placement":"unplaced","state":"inside-treasury"},
-        {"key":"L0109","section":"Spending matters","text":"jun","placement":"unplaced","state":"inside-treasury"},
-        {"key":"L0110","section":"Spending matters","text":"may","placement":"unplaced","state":"inside-treasury"},
-        {"key":"L0111","section":"Spending matters","text":"{…} you","placement":"unplaced","state":"inside-treasury"},
-        {"key":"L0112","section":"Spending matters","text":"Builders hall · this session","placement":"placed","file":"modules/hall-ui/public/craft-mode.js","line":746,"string_id":"fd1903586e8e","state":"inside-treasury"},
-        {"key":"L0113","section":"{…}","text":"floor 1","placement":"unplaced","state":"inside-release","occurrences":2},
-        {"key":"L0114","section":"Overrides","text":"Overrides","placement":"unplaced","state":"inside-release"},
-        {"key":"L0115","section":"Overrides","text":"1 {…} · oldest 3 weeks","placement":"unplaced","state":"inside-release"},
-        {"key":"L0116","section":"Overrides","text":"on {…}","placement":"unplaced","state":"inside-release"},
-        {"key":"L0117","section":"Overrides","text":"OR","placement":"unplaced","state":"inside-release"},
-        {"key":"L0118","section":"Overrides","text":"Override: Reconstruct the {…}-plus {…} {…} lost to the Windows transcript-encodi…","placement":"unplaced","state":"inside-release"},
-        {"key":"L0119","section":"Overrides","text":"{…} · 3 weeks","placement":"unplaced","state":"inside-release"},
-        {"key":"L0120","section":"Overrides","text":"hold","placement":"unplaced","state":"inside-release"},
-        {"key":"L0121","section":"Overrides","text":"mergeBlockReason coun… · today","placement":"unplaced","state":"inside-release"},
-        {"key":"L0122","section":"Overrides","text":"ship.js --regrade sil… · today","placement":"unplaced","state":"inside-release"},
-        {"key":"L0123","section":"Overrides","text":"Fix the failing cases… · today","placement":"unplaced","state":"inside-release"},
-        {"key":"L0124","section":"Overrides","text":"Ship reports say plai… · today","placement":"unplaced","state":"inside-release"},
-        {"key":"L0125","section":"Overrides","text":"the record","placement":"placed","file":"modules/hall-ui/public/street.html","line":188,"string_id":"4bde7b562cf4","state":"inside-release"},
-        {"key":"L0126","section":"Overrides","text":"1 matter on the docket · 60 on the {…}","placement":"unplaced","state":"inside-release"},
-        {"key":"L0127","section":"Overrides","text":"oct","placement":"unplaced","state":"inside-release"},
-        {"key":"L0128","section":"Overrides","text":"sep","placement":"unplaced","state":"inside-release"},
-        {"key":"L0129","section":"Overrides","text":"{…} and {…}","placement":"placed","file":"modules/hall-ui/public/profile-nudge.js","line":77,"string_id":"56b00d773232","state":"inside-release","occurrences":3},
-        {"key":"L0130","section":"Overrides","text":"{…} of {…}","placement":"placed","file":"modules/hall-ui/public/sky-panel.js","line":120,"string_id":"73c1372b43d9","state":"inside-release"},
-        {"key":"L0131","section":"Overrides","text":"and 48 more","placement":"unplaced","state":"inside-release"},
-        {"key":"L0132","section":"Overrides","text":"Builders hall · this session","placement":"placed","file":"modules/hall-ui/public/craft-mode.js","line":746,"string_id":"fd1903586e8e","state":"inside-release"},
-        {"key":"L0133","section":"Reports","text":"Reports","placement":"unplaced","state":"inside-automation"},
-        {"key":"L0134","section":"Reports","text":"nothing {…} you · {…}","placement":"unplaced","state":"inside-automation"},
-        {"key":"L0135","section":"Reports","text":"on {…}","placement":"unplaced","state":"inside-automation"},
-        {"key":"L0136","section":"Reports","text":"Nothing {…} you here","placement":"unplaced","state":"inside-automation"},
-        {"key":"L0137","section":"Reports","text":"Unattended building s… · today","placement":"unplaced","state":"inside-automation"},
-        {"key":"L0138","section":"Reports","text":"the record","placement":"placed","file":"modules/hall-ui/public/street.html","line":188,"string_id":"4bde7b562cf4","state":"inside-automation"},
-        {"key":"L0139","section":"Reports","text":"1 matter on the docket · 1 on the {…}","placement":"unplaced","state":"inside-automation"},
-        {"key":"L0140","section":"Reports","text":"oct","placement":"unplaced","state":"inside-automation"},
-        {"key":"L0141","section":"Reports","text":"Builders hall · this session","placement":"placed","file":"modules/hall-ui/public/craft-mode.js","line":746,"string_id":"fd1903586e8e","state":"inside-automation"},
-        {"key":"L0142","section":"{…}","text":"floor 7","placement":"unplaced","state":"inside-people"},
-        {"key":"L0143","section":"Goal {…}","text":"nothing {…} you · nothing {…}","placement":"unplaced","state":"inside-people"},
-        {"key":"L0144","section":"Goal {…}","text":"Nothing {…} you here","placement":"unplaced","state":"inside-people"},
-        {"key":"L0145","section":"Goal {…}","text":"nothing {…}","placement":"unplaced","state":"inside-people"},
-        {"key":"L0146","section":"Goal {…}","text":"nothing yet","placement":"unplaced","state":"inside-people"},
-        {"key":"L0147","section":"Goal {…}","text":"the record","placement":"placed","file":"modules/hall-ui/public/street.html","line":188,"string_id":"4bde7b562cf4","state":"inside-people"},
-        {"key":"L0148","section":"Goal {…}","text":"nothing on file yet","placement":"unplaced","state":"inside-people"},
-        {"key":"L0149","section":"{…}","text":"5 to do","placement":"unplaced","state":"inside-disputes"},
-        {"key":"L0150","section":"{…} reports","text":"{…} reports","placement":"unplaced","state":"inside-disputes"},
-        {"key":"L0151","section":"{…} reports","text":"{…} · oldest 16 weeks","placement":"unplaced","state":"inside-disputes"},
-        {"key":"L0152","section":"{…} reports","text":"open","placement":"placed","file":"modules/hall-ui/public/approval-queue.js","line":173,"string_id":"9a803563c948","state":"inside-disputes"},
-        {"key":"L0153","section":"{…} reports","text":"to fix","placement":"unplaced","state":"inside-disputes"},
-        {"key":"L0154","section":"{…} reports","text":"on {…}","placement":"unplaced","state":"inside-disputes"},
-        {"key":"L0155","section":"{…} reports","text":"SR","placement":"unplaced","state":"inside-disputes","occurrences":6},
-        {"key":"L0156","section":"{…} reports","text":"{…} · 16 weeks","placement":"unplaced","state":"inside-disputes"},
-        {"key":"L0157","section":"{…} reports","text":"{…} · 13 weeks","placement":"unplaced","state":"inside-disputes"},
-        {"key":"L0158","section":"{…} reports","text":"{…} · 7 weeks","placement":"unplaced","state":"inside-disputes"},
-        {"key":"L0159","section":"{…} reports","text":"{…} · 5 weeks","placement":"unplaced","state":"inside-disputes"},
-        {"key":"L0160","section":"{…} reports","text":"{…} · 4 weeks","placement":"unplaced","state":"inside-disputes"},
-        {"key":"L0161","section":"{…} reports","text":"{…} report — detail… · 4w","placement":"unplaced","state":"inside-disputes"},
-        {"key":"L0162","section":"{…} reports","text":"{…} report — detail… · 5w","placement":"unplaced","state":"inside-disputes"},
-        {"key":"L0163","section":"{…} reports","text":"{…} report — detai… · 4mo","placement":"unplaced","state":"inside-disputes","occurrences":2},
-        {"key":"L0164","section":"{…} reports","text":"the record","placement":"placed","file":"modules/hall-ui/public/street.html","line":188,"string_id":"4bde7b562cf4","state":"inside-disputes"},
-        {"key":"L0165","section":"{…} reports","text":"5 matters on the docket · 20 on the {…}","placement":"unplaced","state":"inside-disputes"},
-        {"key":"L0166","section":"{…} reports","text":"aug","placement":"unplaced","state":"inside-disputes"},
-        {"key":"L0167","section":"{…} reports","text":"jun","placement":"unplaced","state":"inside-disputes"},
-        {"key":"L0168","section":"{…} reports","text":"confirmed","placement":"placed","file":"modules/hall-ui/public/hall-render.js","line":465,"string_id":"d427d9dab01c","state":"inside-disputes"},
-        {"key":"L0169","section":"{…} reports","text":"{…} you","placement":"unplaced","state":"inside-disputes","occurrences":3},
-        {"key":"L0170","section":"{…} reports","text":"Builders hall · this session","placement":"placed","file":"modules/hall-ui/public/craft-mode.js","line":746,"string_id":"fd1903586e8e","state":"inside-disputes"},
-        {"key":"L0171","section":"{…}","text":"the law book","placement":"unplaced","state":"inside-rules"},
-        {"key":"L0172","section":"{…}","text":"1 in {…}","placement":"unplaced","state":"inside-rules"},
-        {"key":"L0173","section":"{…}","text":"The landing {…}","placement":"unplaced","state":"inside-rules"},
-        {"key":"L0174","section":"{…}","text":"the docket · standing","placement":"unplaced","state":"inside-rules"},
-        {"key":"L0175","section":"{…}","text":"the AI","placement":"unplaced","state":"inside-rules"},
-        {"key":"L0176","section":"{…}","text":"what every agent reads at the start","placement":"unplaced","state":"inside-rules"},
-        {"key":"L0177","section":"{…}","text":"how it talks to you","placement":"unplaced","state":"inside-rules"},
-        {"key":"L0178","section":"{…}","text":"Interaction profile for this {…} — pitch replies accordingly:","placement":"unplaced","state":"inside-rules"},
-        {"key":"L0179","section":"{…}","text":"the {…}'s laws","placement":"unplaced","state":"inside-rules"},
-        {"key":"L0180","section":"{…}","text":"1. The landing {…} — {…}","placement":"unplaced","state":"inside-rules"},
-        {"key":"L0181","section":"{…}","text":"floor 2","placement":"unplaced","state":"inside-rules","occurrences":2},
-        {"key":"L0182","section":"New {…}","text":"New {…}","placement":"unplaced","state":"inside-rules"},
-        {"key":"L0183","section":"New {…}","text":"nothing {…} you · a {…} put to the counc…","placement":"unplaced","state":"inside-rules"},
-        {"key":"L0184","section":"New {…}","text":"on {…}","placement":"unplaced","state":"inside-rules"},
-        {"key":"L0185","section":"New {…}","text":"Nothing {…} you here","placement":"unplaced","state":"inside-rules"},
-        {"key":"L0186","section":"New {…}","text":"a {…} put to the {…}","placement":"unplaced","state":"inside-rules"},
-        {"key":"L0187","section":"New {…}","text":"The landing {…} sett… · today","placement":"unplaced","state":"inside-rules"},
-        {"key":"L0188","section":"New {…}","text":"The landing {…} {…}… · 4w","placement":"unplaced","state":"inside-rules"},
-        {"key":"L0189","section":"New {…}","text":"the record","placement":"placed","file":"modules/hall-ui/public/street.html","line":188,"string_id":"4bde7b562cf4","state":"inside-rules"},
-        {"key":"L0190","section":"New {…}","text":"2 on the {…}","placement":"unplaced","state":"inside-rules"},
-        {"key":"L0191","section":"New {…}","text":"oct","placement":"unplaced","state":"inside-rules"},
-        {"key":"L0192","section":"New {…}","text":"sep","placement":"unplaced","state":"inside-rules"},
-        {"key":"L0193","section":"New {…}","text":"Builders hall · this session","placement":"placed","file":"modules/hall-ui/public/craft-mode.js","line":746,"string_id":"fd1903586e8e","state":"inside-rules"},
-        {"key":"L0194","section":"{…}","text":"how {…} the {…} run","placement":"unplaced","state":"here"},
-        {"key":"L0195","section":"{…}","text":"no preset yet","placement":"unplaced","state":"here"},
-        {"key":"L0196","section":"{…}","text":"Open {…}","placement":"placed","file":"modules/hall-ui/public/goals.js","line":84,"string_id":"f6f68ba322be","state":"here"},
-        {"key":"L0197","section":"{…}","text":"Laws are {…} one at a time.","placement":"unplaced","state":"here"},
-        {"key":"L0198","section":"{…}","text":"floor 8","placement":"unplaced","state":"here"},
+        {"key":"L0063","section":"page top","text":"Cards","placement":"unplaced","state":"inside-people"},
+        {"key":"L0064","section":"page top","text":"Goal {…}","placement":"placed","file":"modules/hall-ui/public/gate.js","line":202,"string_id":"ec88b946ad16","state":"inside-people"},
+        {"key":"L0065","section":"page top","text":"Live this month","placement":"unplaced","state":"inside-release"},
+        {"key":"L0066","section":"page top","text":"{…} · decides al…","placement":"unplaced","state":"here"},
+        {"key":"L0067","section":"page top","text":"empty floor","placement":"unplaced","state":"here","occurrences":6},
+        {"key":"L0068","section":"page top","text":"{…}'s office","placement":"unplaced","state":"here"},
+        {"key":"L0069","section":"page top","text":"no {…} · {…} holds it","placement":"unplaced","state":"here"},
+        {"key":"L0070","section":"{…}","text":"{…} and {…}","placement":"placed","file":"modules/hall-ui/public/profile-nudge.js","line":77,"string_id":"56b00d773232","state":"inside-treasury","occurrences":25},
+        {"key":"L0071","section":"{…}","text":"B","placement":"unplaced","state":"inside-treasury","occurrences":36},
+        {"key":"L0072","section":"{…}","text":"you","placement":"unplaced","state":"inside-treasury","occurrences":9},
+        {"key":"L0073","section":"{…}","text":"change how this works","placement":"placed","file":"modules/hall-ui/public/street.html","line":171,"string_id":"3c593c73628a","state":"inside-treasury","occurrences":9},
+        {"key":"L0074","section":"{…}","text":"{…} of {…}","placement":"placed","file":"modules/hall-ui/public/sky-panel.js","line":120,"string_id":"73c1372b43d9","state":"inside-treasury","occurrences":16},
+        {"key":"L0075","section":"{…}","text":"No {…} yet","placement":"unplaced","state":"inside-treasury","occurrences":9},
+        {"key":"L0076","section":"{…}","text":"{…} holds {…}","placement":"unplaced","state":"inside-treasury","occurrences":9},
+        {"key":"L0077","section":"{…}","text":"the office","placement":"unplaced","state":"inside-treasury","occurrences":9},
+        {"key":"L0078","section":"{…}","text":"to {…} here","placement":"unplaced","state":"inside-treasury","occurrences":5},
+        {"key":"L0079","section":"{…}","text":"1 to do","placement":"unplaced","state":"inside-treasury","occurrences":2},
+        {"key":"L0080","section":"{…}","text":"{…} in a row","placement":"unplaced","state":"inside-treasury","occurrences":5},
+        {"key":"L0081","section":"{…}","text":"the {…}","placement":"unplaced","state":"inside-treasury"},
+        {"key":"L0082","section":"{…}","text":"this month","placement":"unplaced","state":"inside-treasury"},
+        {"key":"L0083","section":"{…}","text":"in reserve","placement":"unplaced","state":"inside-treasury"},
+        {"key":"L0084","section":"{…}","text":"Spend cap","placement":"unplaced","state":"inside-treasury"},
+        {"key":"L0085","section":"{…}","text":"off · no spend limit, the {…}","placement":"unplaced","state":"inside-treasury"},
+        {"key":"L0086","section":"{…}","text":"pots per {…}","placement":"unplaced","state":"inside-treasury"},
+        {"key":"L0087","section":"{…}","text":"Governor / Builder /…","placement":"unplaced","state":"inside-treasury"},
+        {"key":"L0088","section":"{…}","text":"maintenance","placement":"unplaced","state":"inside-treasury"},
+        {"key":"L0089","section":"{…}","text":"Bongos Core distribution","placement":"unplaced","state":"inside-treasury"},
+        {"key":"L0090","section":"{…}","text":"Account creation, managem…","placement":"unplaced","state":"inside-treasury"},
+        {"key":"L0091","section":"{…}","text":"Government","placement":"unplaced","state":"inside-treasury"},
+        {"key":"L0092","section":"{…}","text":"and 9 smaller pots","placement":"unplaced","state":"inside-treasury"},
+        {"key":"L0093","section":"{…}","text":"floor 5","placement":"unplaced","state":"inside-treasury","occurrences":2},
+        {"key":"L0094","section":"Spending matters","text":"Spending matters","placement":"unplaced","state":"inside-treasury"},
+        {"key":"L0095","section":"Spending matters","text":"1 {…} · oldest 1 min","placement":"unplaced","state":"inside-treasury"},
+        {"key":"L0096","section":"Spending matters","text":"open","placement":"placed","file":"modules/hall-ui/public/approval-queue.js","line":173,"string_id":"9a803563c948","state":"inside-treasury"},
+        {"key":"L0097","section":"Spending matters","text":"on {…}","placement":"unplaced","state":"inside-treasury"},
+        {"key":"L0098","section":"Spending matters","text":"WA","placement":"unplaced","state":"inside-treasury"},
+        {"key":"L0099","section":"Spending matters","text":"{…} of {…}","placement":"placed","file":"modules/hall-ui/public/sky-panel.js","line":120,"string_id":"73c1372b43d9","state":"inside-treasury"},
+        {"key":"L0100","section":"Spending matters","text":"{…} from the reserve?","placement":"unplaced","state":"inside-treasury"},
+        {"key":"L0101","section":"Spending matters","text":"{…} · today","placement":"unplaced","state":"inside-treasury"},
+        {"key":"L0102","section":"Spending matters","text":"7 builders earned 5,5… · today","placement":"unplaced","state":"inside-treasury"},
+        {"key":"L0103","section":"Spending matters","text":"{…} · 4w","placement":"unplaced","state":"inside-treasury","occurrences":2},
+        {"key":"L0104","section":"Spending matters","text":"the record","placement":"placed","file":"modules/hall-ui/public/street.html","line":188,"string_id":"4bde7b562cf4","state":"inside-treasury"},
+        {"key":"L0105","section":"Spending matters","text":"1 matter on the docket · 16 on the {…}","placement":"unplaced","state":"inside-treasury"},
+        {"key":"L0106","section":"Spending matters","text":"oct","placement":"unplaced","state":"inside-treasury"},
+        {"key":"L0107","section":"Spending matters","text":"sep","placement":"unplaced","state":"inside-treasury"},
+        {"key":"L0108","section":"Spending matters","text":"aug","placement":"unplaced","state":"inside-treasury"},
+        {"key":"L0109","section":"Spending matters","text":"jul","placement":"unplaced","state":"inside-treasury"},
+        {"key":"L0110","section":"Spending matters","text":"jun","placement":"unplaced","state":"inside-treasury"},
+        {"key":"L0111","section":"Spending matters","text":"may","placement":"unplaced","state":"inside-treasury"},
+        {"key":"L0112","section":"Spending matters","text":"{…} you","placement":"unplaced","state":"inside-treasury"},
+        {"key":"L0113","section":"Spending matters","text":"Builders hall · this session","placement":"placed","file":"modules/hall-ui/public/craft-mode.js","line":746,"string_id":"fd1903586e8e","state":"inside-treasury"},
+        {"key":"L0114","section":"{…}","text":"floor 1","placement":"unplaced","state":"inside-release","occurrences":2},
+        {"key":"L0115","section":"Overrides","text":"Overrides","placement":"unplaced","state":"inside-release"},
+        {"key":"L0116","section":"Overrides","text":"1 {…} · oldest 3 weeks","placement":"unplaced","state":"inside-release"},
+        {"key":"L0117","section":"Overrides","text":"on {…}","placement":"unplaced","state":"inside-release"},
+        {"key":"L0118","section":"Overrides","text":"OR","placement":"unplaced","state":"inside-release"},
+        {"key":"L0119","section":"Overrides","text":"Override: Reconstruct the {…}-plus {…} {…} lost to the Windows transcript-encodi…","placement":"unplaced","state":"inside-release"},
+        {"key":"L0120","section":"Overrides","text":"{…} · 3 weeks","placement":"unplaced","state":"inside-release"},
+        {"key":"L0121","section":"Overrides","text":"hold","placement":"unplaced","state":"inside-release"},
+        {"key":"L0122","section":"Overrides","text":"mergeBlockReason coun… · today","placement":"unplaced","state":"inside-release"},
+        {"key":"L0123","section":"Overrides","text":"ship.js --regrade sil… · today","placement":"unplaced","state":"inside-release"},
+        {"key":"L0124","section":"Overrides","text":"Fix the failing cases… · today","placement":"unplaced","state":"inside-release"},
+        {"key":"L0125","section":"Overrides","text":"Ship reports say plai… · today","placement":"unplaced","state":"inside-release"},
+        {"key":"L0126","section":"Overrides","text":"the record","placement":"placed","file":"modules/hall-ui/public/street.html","line":188,"string_id":"4bde7b562cf4","state":"inside-release"},
+        {"key":"L0127","section":"Overrides","text":"1 matter on the docket · 60 on the {…}","placement":"unplaced","state":"inside-release"},
+        {"key":"L0128","section":"Overrides","text":"oct","placement":"unplaced","state":"inside-release"},
+        {"key":"L0129","section":"Overrides","text":"sep","placement":"unplaced","state":"inside-release"},
+        {"key":"L0130","section":"Overrides","text":"{…} and {…}","placement":"placed","file":"modules/hall-ui/public/profile-nudge.js","line":77,"string_id":"56b00d773232","state":"inside-release","occurrences":3},
+        {"key":"L0131","section":"Overrides","text":"{…} of {…}","placement":"placed","file":"modules/hall-ui/public/sky-panel.js","line":120,"string_id":"73c1372b43d9","state":"inside-release"},
+        {"key":"L0132","section":"Overrides","text":"and 48 more","placement":"unplaced","state":"inside-release"},
+        {"key":"L0133","section":"Overrides","text":"Builders hall · this session","placement":"placed","file":"modules/hall-ui/public/craft-mode.js","line":746,"string_id":"fd1903586e8e","state":"inside-release"},
+        {"key":"L0134","section":"Reports","text":"Reports","placement":"unplaced","state":"inside-automation"},
+        {"key":"L0135","section":"Reports","text":"nothing {…} you · {…}","placement":"unplaced","state":"inside-automation"},
+        {"key":"L0136","section":"Reports","text":"on {…}","placement":"unplaced","state":"inside-automation"},
+        {"key":"L0137","section":"Reports","text":"Nothing {…} you here","placement":"unplaced","state":"inside-automation"},
+        {"key":"L0138","section":"Reports","text":"Unattended building s… · today","placement":"unplaced","state":"inside-automation"},
+        {"key":"L0139","section":"Reports","text":"the record","placement":"placed","file":"modules/hall-ui/public/street.html","line":188,"string_id":"4bde7b562cf4","state":"inside-automation"},
+        {"key":"L0140","section":"Reports","text":"1 matter on the docket · 1 on the {…}","placement":"unplaced","state":"inside-automation"},
+        {"key":"L0141","section":"Reports","text":"oct","placement":"unplaced","state":"inside-automation"},
+        {"key":"L0142","section":"Reports","text":"Builders hall · this session","placement":"placed","file":"modules/hall-ui/public/craft-mode.js","line":746,"string_id":"fd1903586e8e","state":"inside-automation"},
+        {"key":"L0143","section":"{…}","text":"floor 8","placement":"unplaced","state":"inside-people","occurrences":2},
+        {"key":"L0144","section":"Goal {…}","text":"nothing {…} you · nothing {…}","placement":"unplaced","state":"inside-people"},
+        {"key":"L0145","section":"Goal {…}","text":"Nothing {…} you here","placement":"unplaced","state":"inside-people"},
+        {"key":"L0146","section":"Goal {…}","text":"nothing {…}","placement":"unplaced","state":"inside-people"},
+        {"key":"L0147","section":"Goal {…}","text":"nothing yet","placement":"unplaced","state":"inside-people"},
+        {"key":"L0148","section":"Goal {…}","text":"the record","placement":"placed","file":"modules/hall-ui/public/street.html","line":188,"string_id":"4bde7b562cf4","state":"inside-people"},
+        {"key":"L0149","section":"Goal {…}","text":"nothing on file yet","placement":"unplaced","state":"inside-people"},
+        {"key":"L0150","section":"{…}","text":"5 to do","placement":"unplaced","state":"inside-disputes"},
+        {"key":"L0151","section":"{…} reports","text":"{…} reports","placement":"unplaced","state":"inside-disputes"},
+        {"key":"L0152","section":"{…} reports","text":"{…} · oldest 16 weeks","placement":"unplaced","state":"inside-disputes"},
+        {"key":"L0153","section":"{…} reports","text":"open","placement":"placed","file":"modules/hall-ui/public/approval-queue.js","line":173,"string_id":"9a803563c948","state":"inside-disputes"},
+        {"key":"L0154","section":"{…} reports","text":"to fix","placement":"unplaced","state":"inside-disputes"},
+        {"key":"L0155","section":"{…} reports","text":"on {…}","placement":"unplaced","state":"inside-disputes"},
+        {"key":"L0156","section":"{…} reports","text":"SR","placement":"unplaced","state":"inside-disputes","occurrences":6},
+        {"key":"L0157","section":"{…} reports","text":"{…} · 16 weeks","placement":"unplaced","state":"inside-disputes"},
+        {"key":"L0158","section":"{…} reports","text":"{…} · 13 weeks","placement":"unplaced","state":"inside-disputes"},
+        {"key":"L0159","section":"{…} reports","text":"{…} · 7 weeks","placement":"unplaced","state":"inside-disputes"},
+        {"key":"L0160","section":"{…} reports","text":"{…} · 5 weeks","placement":"unplaced","state":"inside-disputes"},
+        {"key":"L0161","section":"{…} reports","text":"{…} · 4 weeks","placement":"unplaced","state":"inside-disputes"},
+        {"key":"L0162","section":"{…} reports","text":"{…} report — detail… · 4w","placement":"unplaced","state":"inside-disputes"},
+        {"key":"L0163","section":"{…} reports","text":"{…} report — detail… · 5w","placement":"unplaced","state":"inside-disputes"},
+        {"key":"L0164","section":"{…} reports","text":"{…} report — detai… · 4mo","placement":"unplaced","state":"inside-disputes","occurrences":2},
+        {"key":"L0165","section":"{…} reports","text":"the record","placement":"placed","file":"modules/hall-ui/public/street.html","line":188,"string_id":"4bde7b562cf4","state":"inside-disputes"},
+        {"key":"L0166","section":"{…} reports","text":"5 matters on the docket · 20 on the {…}","placement":"unplaced","state":"inside-disputes"},
+        {"key":"L0167","section":"{…} reports","text":"aug","placement":"unplaced","state":"inside-disputes"},
+        {"key":"L0168","section":"{…} reports","text":"jun","placement":"unplaced","state":"inside-disputes"},
+        {"key":"L0169","section":"{…} reports","text":"confirmed","placement":"placed","file":"modules/hall-ui/public/hall-render.js","line":465,"string_id":"d427d9dab01c","state":"inside-disputes"},
+        {"key":"L0170","section":"{…} reports","text":"{…} you","placement":"unplaced","state":"inside-disputes","occurrences":3},
+        {"key":"L0171","section":"{…} reports","text":"Builders hall · this session","placement":"placed","file":"modules/hall-ui/public/craft-mode.js","line":746,"string_id":"fd1903586e8e","state":"inside-disputes"},
+        {"key":"L0172","section":"{…}","text":"the law book","placement":"unplaced","state":"inside-rules"},
+        {"key":"L0173","section":"{…}","text":"1 in {…}","placement":"unplaced","state":"inside-rules"},
+        {"key":"L0174","section":"{…}","text":"The landing {…}","placement":"unplaced","state":"inside-rules"},
+        {"key":"L0175","section":"{…}","text":"the docket · standing","placement":"unplaced","state":"inside-rules"},
+        {"key":"L0176","section":"{…}","text":"the AI","placement":"unplaced","state":"inside-rules"},
+        {"key":"L0177","section":"{…}","text":"what every agent reads at the start","placement":"unplaced","state":"inside-rules"},
+        {"key":"L0178","section":"{…}","text":"how it talks to you","placement":"unplaced","state":"inside-rules"},
+        {"key":"L0179","section":"{…}","text":"Interaction profile for this {…} — pitch replies accordingly:","placement":"unplaced","state":"inside-rules"},
+        {"key":"L0180","section":"{…}","text":"the {…}'s laws","placement":"unplaced","state":"inside-rules"},
+        {"key":"L0181","section":"{…}","text":"1. The landing {…} — {…}","placement":"unplaced","state":"inside-rules"},
+        {"key":"L0182","section":"{…}","text":"floor 2","placement":"unplaced","state":"inside-rules","occurrences":2},
+        {"key":"L0183","section":"New {…}","text":"New {…}","placement":"unplaced","state":"inside-rules"},
+        {"key":"L0184","section":"New {…}","text":"nothing {…} you · a {…} put to the counc…","placement":"unplaced","state":"inside-rules"},
+        {"key":"L0185","section":"New {…}","text":"on {…}","placement":"unplaced","state":"inside-rules"},
+        {"key":"L0186","section":"New {…}","text":"Nothing {…} you here","placement":"unplaced","state":"inside-rules"},
+        {"key":"L0187","section":"New {…}","text":"a {…} put to the {…}","placement":"unplaced","state":"inside-rules"},
+        {"key":"L0188","section":"New {…}","text":"The landing {…} sett… · today","placement":"unplaced","state":"inside-rules"},
+        {"key":"L0189","section":"New {…}","text":"The landing {…} {…}… · 4w","placement":"unplaced","state":"inside-rules"},
+        {"key":"L0190","section":"New {…}","text":"the record","placement":"placed","file":"modules/hall-ui/public/street.html","line":188,"string_id":"4bde7b562cf4","state":"inside-rules"},
+        {"key":"L0191","section":"New {…}","text":"2 on the {…}","placement":"unplaced","state":"inside-rules"},
+        {"key":"L0192","section":"New {…}","text":"oct","placement":"unplaced","state":"inside-rules"},
+        {"key":"L0193","section":"New {…}","text":"sep","placement":"unplaced","state":"inside-rules"},
+        {"key":"L0194","section":"New {…}","text":"Builders hall · this session","placement":"placed","file":"modules/hall-ui/public/craft-mode.js","line":746,"string_id":"fd1903586e8e","state":"inside-rules"},
+        {"key":"L0195","section":"{…}","text":"how {…} the {…} run","placement":"unplaced","state":"here"},
+        {"key":"L0196","section":"{…}","text":"no preset yet","placement":"unplaced","state":"here"},
+        {"key":"L0197","section":"{…}","text":"Open {…}","placement":"placed","file":"modules/hall-ui/public/goals.js","line":84,"string_id":"f6f68ba322be","state":"here"},
+        {"key":"L0198","section":"{…}","text":"Laws are {…} one at a time.","placement":"unplaced","state":"here"},
         {"key":"L0199","section":"§7 {…}","text":"nothing {…} you · whoever may put a relea…","placement":"unplaced","state":"here"},
         {"key":"L0200","section":"§7 {…}","text":"on {…}","placement":"unplaced","state":"here"},
         {"key":"L0201","section":"§7 {…}","text":"Nothing {…} you here","placement":"unplaced","state":"here"},

package/modules/front-door-guide/CLAUDE.md

@@ -0,0 +1,15 @@
+# @bongos/core — installed platform dependency (not your project's CLAUDE.md)
+
+This file is a placeholder shipped inside the **@bongos/core** package. The core's own
+internal agent notes are intentionally omitted from the published artifact so they cannot
+load into your instance's context.
+
+**It does not govern this repository.** Your own root `CLAUDE.md`, your `.claude/`
+directory, and the live Bongos database are the source of truth for how work happens here
+and who may do what.
+
+You are seeing this only because an agent opened a file under `node_modules/@bongos/core/`.
+Nothing in here needs to be read to use the platform — run `bongos help` for commands.
+
+_To work ON the platform core itself, use the standalone @bongos/core source repository,
+not this vendored copy._

package/modules/front-door-guide/claude.js

@@ -0,0 +1,51 @@
+// modules/front-door-guide/claude.js — the one Claude Messages API call behind the
+// start-a-project guide (task 1005272), on the platform's own key.
+//
+// The SDK is required lazily, so an instance with the guide off never loads it, and the
+// client is injectable so the tests run a mocked one and never spend real money.
+// Thinking cannot be switched off on the default model; `effort` keeps a chat reply
+// short and cheap, and `max_tokens` bounds the bill of one reply (thinking included).
+
+'use strict';
+
+const CALL_TIMEOUT_MS = 30_000;
+
+// createClient(apiKey, { sdk }) — the live client. The key goes only to the SDK.
+function createClient(apiKey, { sdk = null } = {}) {
+  const mod = sdk || require('@anthropic-ai/sdk');
+  const Anthropic = mod.Anthropic || mod.default || mod;
+  return new Anthropic({ apiKey, timeout: CALL_TIMEOUT_MS, maxRetries: 1 });
+}
+
+// buildRequest — the request body, kept separate so a test can read it.
+function buildRequest({ settings, system, messages }) {
+  return {
+    model: settings.model,
+    max_tokens: settings.maxReplyTokens,
+    output_config: { effort: settings.effort },
+    system,
+    messages: messages.map((m) => ({ role: m.role, content: m.content })),
+  };
+}
+
+// askGuide({ client, settings, system, messages }) →
+//   { ok: true, stopReason, content, usage, model }
+//   { ok: false, error }   a thrown SDK error (network, 4xx, 5xx); nothing was billed.
+// Never throws.
+async function askGuide({ client, settings, system, messages }) {
+  let res;
+  try {
+    res = await client.messages.create(buildRequest({ settings, system, messages }));
+  } catch (e) {
+    return { ok: false, error: `api_error${e && e.status ? ` ${e.status}` : ''}` };
+  }
+  return {
+    ok: true,
+    stopReason: res && res.stop_reason,
+    content: (res && res.content) || [],
+    usage: (res && res.usage) || {},
+    model: (res && res.model) || settings.model,
+  };
+}
+
+module.exports = { createClient, buildRequest, askGuide, CALL_TIMEOUT_MS };

package/modules/front-door-guide/db.js

@@ -0,0 +1,72 @@
+// modules/front-door-guide/db.js — the SQL behind the start-a-project guide (task
+// 1005272). Every function takes an optional executor so a test can hand in a fake; the
+// default is the shared pool. Money is integer micro-dollars; Postgres returns BIGINT
+// sums as strings, so every read goes through Number().
+
+'use strict';
+
+const exec = (executor) => executor || ((text, params) => require('../../src/module-api').pool.query(text, params));
+
+async function createConversation(tokenHash, visitorHash, executor) {
+  const { rows } = await exec(executor)(
+    `INSERT INTO front_door_guide_conversations (token_hash, visitor_hash)
+     VALUES ($1, $2)
+     RETURNING id, visitor_hash, messages, visitor_messages, spend_micro, status, end_reason, created_at`,
+    [tokenHash, visitorHash]);
+  return rows[0];
+}
+
+// The conversation, only when the caller holds its token.
+async function getConversation(id, tokenHash, executor) {
+  const { rows } = await exec(executor)(
+    `SELECT id, visitor_hash, messages, visitor_messages, spend_micro, status, end_reason, created_at
+       FROM front_door_guide_conversations WHERE id = $1 AND token_hash = $2`, [id, tokenHash]);
+  return rows[0] || null;
+}
+
+// The whole site's spend since the start of this UTC 'day' or 'month'.
+async function siteSpendMicro(period, executor) {
+  if (period !== 'day' && period !== 'month') throw new Error('period must be day or month');
+  const { rows } = await exec(executor)(
+    `SELECT COALESCE(SUM(cost_micro), 0) AS spend FROM front_door_guide_calls
+      WHERE created_at >= (date_trunc($1, now() AT TIME ZONE 'UTC') AT TIME ZONE 'UTC')`, [period]);
+  return Number(rows[0].spend) || 0;
+}
+
+// One visitor's answered messages and spend over the last 24 hours, across every
+// conversation they started: a new chat does not reset their cap.
+async function visitorUsage(visitorHash, executor) {
+  const { rows } = await exec(executor)(
+    `SELECT COUNT(*) AS messages, COALESCE(SUM(cost_micro), 0) AS spend FROM front_door_guide_calls
+      WHERE visitor_hash = $1 AND created_at >= now() - interval '24 hours'`, [visitorHash]);
+  return { messages: Number(rows[0].messages) || 0, spendMicro: Number(rows[0].spend) || 0 };
+}
+
+// recordTurn — one answered visitor message, in one statement: the call's ledger row and
+// the conversation's new transcript, count, spend and status.
+async function recordTurn(convId, { messages, status, endReason }, call, executor) {
+  const { rows } = await exec(executor)(
+    `WITH c AS (
+       INSERT INTO front_door_guide_calls
+         (conversation_id, visitor_hash, model, input_tokens, output_tokens, cache_read_tokens, cache_write_tokens, cost_micro, stop_reason)
+       VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9)
+       RETURNING cost_micro)
+     UPDATE front_door_guide_conversations
+        SET messages = $10::jsonb, visitor_messages = visitor_messages + 1,
+            spend_micro = spend_micro + (SELECT cost_micro FROM c),
+            status = $11, end_reason = $12, updated_at = now()
+      WHERE id = $1
+      RETURNING id, visitor_hash, messages, visitor_messages, spend_micro, status, end_reason, created_at`,
+    [convId, call.visitorHash, call.model, call.inputTokens, call.outputTokens, call.cacheReadTokens,
+      call.cacheWriteTokens, call.costMicro, call.stopReason, JSON.stringify(messages), status, endReason || null]);
+  return rows[0];
+}
+
+// Close a conversation without a call (a cap was already reached on arrival).
+async function endConversation(convId, endReason, executor) {
+  await exec(executor)(
+    `UPDATE front_door_guide_conversations SET status = 'ended', end_reason = $2, updated_at = now() WHERE id = $1`,
+    [convId, endReason]);
+}
+
+module.exports = { createConversation, getConversation, siteSpendMicro, visitorUsage, recordTurn, endConversation };