@bongos/core 1.20.79 → 1.20.81

package/docs/page-readings.json

@@ -5,7 +5,7 @@
   "adr": "0341 D3",
   "reread": "node scripts/gds/page-reader.js --stale",
   "how": ["Generated by node scripts/gds/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":40,"lines":4566,"placed":1610,"shared":245,"unplaced":2711,"omitted_data":2252},
+  "counts": {"pages":40,"lines":4571,"placed":1613,"shared":245,"unplaced":2713,"omitted_data":2254},
   "pages": [
     {
       "id": "builders:atlas",
@@ -946,7 +946,7 @@
       "surface": "builders",
       "title": "Gate",
       "states_read": ["queue","out","approve"],
-      "files_hash": "fce003b152adb982",
+      "files_hash": "af5d80b03048ddf1",
       "reading_hash": "08d3e5d3657e5afb",
       "counts": {"lines":41,"placed":17,"shared":5,"unplaced":19},
       "omitted": {"data":34},
@@ -955,17 +955,17 @@
         {"key":"L0001","section":"skip link","text":"Skip to content","placement":"shared","file":"modules/hall-ui/public/shell.js","line":884,"string_id":"87cee78ca134"},
         {"key":"L0002","section":"top bar","text":"Gate","placement":"shared"},
         {"key":"L0003","section":"top bar","text":"Jump to…","placement":"shared","file":"modules/hall-ui/public/shell.js","line":495,"string_id":"eba610d25523"},
-        {"key":"L0004","section":"top bar","text":"Ctrl K","placement":"shared"},
+        {"key":"L0004","section":"top bar","text":"⌘K","placement":"shared"},
         {"key":"L0005","section":"Gate","text":"Gate","placement":"unplaced"},
-        {"key":"L0006","section":"Gate","text":"Changes touching protected build surfaces, held for your approval.","placement":"placed","file":"modules/hall-ui/public/gate.js","line":448,"string_id":"4b714191b423"},
+        {"key":"L0006","section":"Gate","text":"Changes touching protected build surfaces, held for your approval.","placement":"placed","file":"modules/hall-ui/public/gate.js","line":517,"string_id":"4b714191b423"},
         {"key":"L0007","section":"Gate","text":"Awaiting your approval","placement":"unplaced"},
         {"key":"L0008","section":"Gate","text":"held at the gate check","placement":"unplaced"},
         {"key":"L0009","section":"Gate","text":"Hard-floor holds","placement":"unplaced"},
         {"key":"L0010","section":"Gate","text":"touch a surface only an owner may clear","placement":"unplaced"},
         {"key":"L0011","section":"Gate","text":"Trust holds","placement":"unplaced"},
         {"key":"L0012","section":"Gate","text":"an author the gate does not yet trust","placement":"unplaced"},
-        {"key":"L0013","section":"Held pull requests","text":"Held pull requests","placement":"placed","file":"modules/hall-ui/public/gate.html","line":63,"string_id":"adac4cd8b973"},
-        {"key":"L0014","section":"Held pull requests","text":"Each one touched a protected surface and stopped at the gate check. Approving records your seal on that commit and re-runs the check.","placement":"placed","file":"modules/hall-ui/public/gate.html","line":64,"string_id":"77b7e3abfb07"},
+        {"key":"L0013","section":"Held pull requests","text":"Held pull requests","placement":"placed","file":"modules/hall-ui/public/gate.html","line":66,"string_id":"adac4cd8b973"},
+        {"key":"L0014","section":"Held pull requests","text":"Each one touched a protected surface and stopped at the gate check. Approving records your seal on that commit and re-runs the check.","placement":"placed","file":"modules/hall-ui/public/gate.html","line":67,"string_id":"77b7e3abfb07"},
         {"key":"L0015","section":"Held pull requests","text":"{…} and {…}","placement":"placed","file":"modules/hall-ui/public/profile-nudge.js","line":77,"string_id":"56b00d773232","occurrences":2},
         {"key":"L0016","section":"Held pull requests","text":"Hard floor","placement":"unplaced","occurrences":2},
         {"key":"L0017","section":"Held pull requests","text":"task {…}","placement":"placed","file":"modules/hall-ui/public/gate.js","line":157,"string_id":"4d8ee7d68974","occurrences":2},
@@ -2584,25 +2584,25 @@
       "surface": "builders",
       "title": "Settings",
       "states_read": ["account","access","preferences","skills-walkthrough","offered-skills","sound","update"],
-      "files_hash": "e0941c22b8ed0433",
-      "reading_hash": "801ade9057081281",
-      "counts": {"lines":169,"placed":118,"shared":5,"unplaced":46},
-      "omitted": {"data":192},
+      "files_hash": "b0bddb4881e32387",
+      "reading_hash": "3811f66a9bff1f0c",
+      "counts": {"lines":174,"placed":121,"shared":5,"unplaced":48},
+      "omitted": {"data":194},
       "notes": [],
       "lines": [
         {"key":"L0001","section":"skip link","text":"Skip to content","placement":"shared","file":"modules/hall-ui/public/shell.js","line":884,"string_id":"87cee78ca134"},
         {"key":"L0002","section":"top bar","text":"Settings","placement":"shared"},
         {"key":"L0003","section":"top bar","text":"Jump to…","placement":"shared","file":"modules/hall-ui/public/shell.js","line":495,"string_id":"eba610d25523"},
-        {"key":"L0004","section":"top bar","text":"Ctrl K","placement":"shared"},
+        {"key":"L0004","section":"top bar","text":"⌘K","placement":"shared"},
         {"key":"L0005","section":"settings","text":"settings","placement":"unplaced"},
         {"key":"L0006","section":"settings","text":"Your preferences, {…}.","placement":"placed","file":"modules/hall-ui/public/settings.js","line":630,"string_id":"e91418db3962"},
         {"key":"L0007","section":"settings","text":"Account","placement":"unplaced"},
         {"key":"L0008","section":"settings","text":"Access & keys","placement":"unplaced"},
         {"key":"L0009","section":"settings","text":"Preferences","placement":"unplaced"},
         {"key":"L0010","section":"settings","text":"Sound","placement":"unplaced"},
-        {"key":"L0011","section":"settings","text":"Software update","placement":"placed","file":"modules/hall-ui/public/settings.html","line":373,"string_id":"207af7ce6828"},
-        {"key":"L0012","section":"Software update","text":"Software update","placement":"placed","file":"modules/hall-ui/public/settings.html","line":373,"string_id":"207af7ce6828","state":"update"},
-        {"key":"L0013","section":"Software update","text":"Which version of Cloud Bongos this project runs, whether a newer one is ready for it, and what each newer version brings.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":374,"string_id":"68da8cb13058","state":"update"},
+        {"key":"L0011","section":"settings","text":"Software update","placement":"placed","file":"modules/hall-ui/public/settings.html","line":390,"string_id":"207af7ce6828"},
+        {"key":"L0012","section":"Software update","text":"Software update","placement":"placed","file":"modules/hall-ui/public/settings.html","line":390,"string_id":"207af7ce6828","state":"update"},
+        {"key":"L0013","section":"Software update","text":"Which version of Cloud Bongos this project runs, whether a newer one is ready for it, and what each newer version brings.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":391,"string_id":"68da8cb13058","state":"update"},
         {"key":"L0014","section":"Software update","text":"{…} project{…}","placement":"placed","file":"modules/hall-ui/public/fleet.js","line":39,"string_id":"771bef3d31b5","state":"update","occurrences":2},
         {"key":"L0015","section":"Software update","text":"— published 21 hours ago","placement":"unplaced","state":"update"},
         {"key":"L0016","section":"Software update","text":"Update ready","placement":"placed","file":"modules/hall-ui/public/settings-software-update.js","line":145,"string_id":"13ced9b2fa12","state":"update"},
@@ -2616,37 +2616,37 @@
         {"key":"L0024","section":"What's new in these 7 versions","text":"Show {…} more version{…}","placement":"placed","file":"modules/hall-ui/public/settings-software-update.js","line":119,"string_id":"44945da22716","state":"update"},
         {"key":"L0025","section":"What's new in these 7 versions","text":"Checked 20 hours ago.","placement":"unplaced","state":"update"},
         {"key":"L0026","section":"footer","text":"Sign out","placement":"shared","file":"modules/hall-ui/public/shell.js","line":471,"string_id":"1883ad7f07fc","state":"update","occurrences":5},
-        {"key":"L0027","section":"Skill voices","text":"Skill voices","placement":"placed","file":"modules/hall-ui/public/settings.html","line":314,"string_id":"ecc12c1dd4de","state":"sound"},
-        {"key":"L0028","section":"Skill voices","text":"Each slash-command can run on a different model. The system has a default for every skill; choose another to override it, or leave it on Default.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":315,"string_id":"7f1b1c32d360","state":"sound"},
+        {"key":"L0027","section":"Skill voices","text":"Skill voices","placement":"placed","file":"modules/hall-ui/public/settings.html","line":331,"string_id":"ecc12c1dd4de","state":"sound"},
+        {"key":"L0028","section":"Skill voices","text":"Each slash-command can run on a different model. The system has a default for every skill; choose another to override it, or leave it on Default.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":332,"string_id":"7f1b1c32d360","state":"sound"},
         {"key":"L0029","section":"Skill voices","text":"Skill","placement":"placed","file":"modules/hall-ui/public/settings-specialities.js","line":130,"string_id":"4b0ca7d7171f","state":"sound"},
         {"key":"L0030","section":"Skill voices","text":"Default","placement":"unplaced","state":"sound"},
-        {"key":"L0031","section":"Skill voices","text":"Your choice","placement":"placed","file":"modules/hall-ui/public/settings.html","line":323,"string_id":"f96bc227dba0","state":"sound"},
+        {"key":"L0031","section":"Skill voices","text":"Your choice","placement":"placed","file":"modules/hall-ui/public/settings.html","line":340,"string_id":"f96bc227dba0","state":"sound"},
         {"key":"L0032","section":"Skill voices","text":"no LLM","placement":"unplaced","state":"sound","occurrences":22},
         {"key":"L0033","section":"Skill voices","text":"Default ({…})","placement":"placed","file":"modules/hall-ui/public/settings.js","line":63,"string_id":"7c6891813679","state":"sound","occurrences":16},
         {"key":"L0034","section":"Skill voices","text":"Opus","placement":"unplaced","state":"sound","occurrences":21},
         {"key":"L0035","section":"Skill voices","text":"Sonnet","placement":"unplaced","state":"sound","occurrences":21},
         {"key":"L0036","section":"Skill voices","text":"Haiku","placement":"unplaced","state":"sound","occurrences":16},
-        {"key":"L0037","section":"Skill voices","text":"Changes save the moment you pick. “Default” clears your override and falls back to the system's choice.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":329,"string_id":"cab7a9526ca1","state":"sound"},
+        {"key":"L0037","section":"Skill voices","text":"Changes save the moment you pick. “Default” clears your override and falls back to the system's choice.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":346,"string_id":"cab7a9526ca1","state":"sound"},
         {"key":"L0038","section":"Sounds","text":"Sounds","placement":"unplaced","state":"sound"},
-        {"key":"L0039","section":"Sounds","text":"A sound plays at each turn of your work — a gentle chime when Claude finishes, a flourish when a task ships or your rank rises. Turn off any you would rather not hear.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":335,"string_id":"a3185a43c230","state":"sound"},
+        {"key":"L0039","section":"Sounds","text":"A sound plays at each turn of your work — a gentle chime when Claude finishes, a flourish when a task ships or your rank rises. Turn off any you would rather not hear.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":352,"string_id":"a3185a43c230","state":"sound"},
         {"key":"L0040","section":"Sounds","text":"Volume","placement":"placed","file":"modules/hall-ui/public/settings.js","line":216,"string_id":"2940b7828d26","state":"sound"},
-        {"key":"L0041","section":"Sounds","text":"Changes save at once and take effect the next time you start a session on this machine.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":346,"string_id":"906c2947dfc1","state":"sound"},
-        {"key":"L0042","section":"Event sounds","text":"Event sounds","placement":"placed","file":"modules/hall-ui/public/settings.html","line":351,"string_id":"44f928d13699","state":"sound"},
-        {"key":"L0043","section":"Event sounds","text":"Choose which sound plays for each build event — one when Claude waits for your input, another when a task ships, a coin clink when {{currency}} arrive. Each event offers a small set of choices; more will be added as new audio ships.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":352,"string_id":"6c88cdf417f1","state":"sound"},
+        {"key":"L0041","section":"Sounds","text":"Changes save at once and take effect the next time you start a session on this machine.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":363,"string_id":"906c2947dfc1","state":"sound"},
+        {"key":"L0042","section":"Event sounds","text":"Event sounds","placement":"placed","file":"modules/hall-ui/public/settings.html","line":368,"string_id":"44f928d13699","state":"sound"},
+        {"key":"L0043","section":"Event sounds","text":"Choose which sound plays for each build event — one when Claude waits for your input, another when a task ships, a coin clink when {{currency}} arrive. Each event offers a small set of choices; more will be added as new audio ships.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":369,"string_id":"6c88cdf417f1","state":"sound"},
         {"key":"L0044","section":"Event sounds","text":"{…} and {…}","placement":"placed","file":"modules/hall-ui/public/profile-nudge.js","line":77,"string_id":"56b00d773232","state":"sound","occurrences":2},
         {"key":"L0045","section":"Event sounds","text":"{…} (default)","placement":"unplaced","state":"sound","occurrences":5},
         {"key":"L0046","section":"Event sounds","text":"Play","placement":"unplaced","state":"sound","occurrences":5},
-        {"key":"L0047","section":"Event sounds","text":"Task {…}","placement":"placed","file":"modules/hall-ui/public/task.js","line":503,"string_id":"eff70e59d12e","state":"sound"},
-        {"key":"L0048","section":"Event sounds","text":"{…} earned","placement":"placed","file":"modules/hall-ui/public/goals-render.js","line":822,"string_id":"cf89ac85440d","state":"sound"},
-        {"key":"L0049","section":"Event sounds","text":"Changes save at once. Your new choice plays the next time that event fires.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":359,"string_id":"52384bdc035c","state":"sound"},
-        {"key":"L0050","section":"How Claude talks to you","text":"How Claude talks to you","placement":"placed","file":"modules/hall-ui/public/settings.html","line":193,"string_id":"0469a83cf1e8","state":"preferences"},
-        {"key":"L0051","section":"How Claude talks to you","text":"How replies are pitched for you — the vocabulary assumed, how much hand-holding local tooling gets, how long an answer runs, and how much of the work behind it is narrated. These reach every session you start. The defaults assume no software-engineering background; change any of them and the rest stay as they are.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":194,"string_id":"63dbe9873b4e","state":"preferences"},
+        {"key":"L0047","section":"Event sounds","text":"Task {…}","placement":"placed","file":"modules/hall-ui/public/task.js","line":512,"string_id":"eff70e59d12e","state":"sound"},
+        {"key":"L0048","section":"Event sounds","text":"{…} earned","placement":"placed","file":"modules/hall-ui/public/goals-render.js","line":828,"string_id":"cf89ac85440d","state":"sound"},
+        {"key":"L0049","section":"Event sounds","text":"Changes save at once. Your new choice plays the next time that event fires.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":376,"string_id":"52384bdc035c","state":"sound"},
+        {"key":"L0050","section":"How Claude talks to you","text":"How Claude talks to you","placement":"placed","file":"modules/hall-ui/public/settings.html","line":210,"string_id":"0469a83cf1e8","state":"preferences"},
+        {"key":"L0051","section":"How Claude talks to you","text":"How replies are pitched for you — the vocabulary assumed, how much hand-holding local tooling gets, how long an answer runs, and how much of the work behind it is narrated. These reach every session you start. The defaults assume no software-engineering background; change any of them and the rest stay as they are.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":211,"string_id":"63dbe9873b4e","state":"preferences"},
         {"key":"L0052","section":"How Claude talks to you","text":"{…} file{…}","placement":"placed","file":"modules/hall-ui/public/gate.js","line":151,"string_id":"3efa67dc6e07","state":"preferences"},
-        {"key":"L0053","section":"Your specialities","text":"Your specialities","placement":"placed","file":"modules/hall-ui/public/settings.html","line":212,"string_id":"dd419ffd76f0","state":"preferences"},
-        {"key":"L0054","section":"Your specialities","text":"A role says how you work. A speciality says what you work on — and how you, as someone who knows the subject, want to be engaged inside it. Whichever one you are using reaches every session where you hold a claim in that role. Train it by adding things you have written; it also picks things up on its own as you work.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":213,"string_id":"244ea2a3564e","state":"preferences"},
-        {"key":"L0055","section":"Your specialities","text":"Markets, incentives, and how to price them.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":241,"string_id":"8bdec961e84a","state":"preferences"},
+        {"key":"L0053","section":"Your specialities","text":"Your specialities","placement":"placed","file":"modules/hall-ui/public/settings.html","line":229,"string_id":"dd419ffd76f0","state":"preferences"},
+        {"key":"L0054","section":"Your specialities","text":"A role says how you work. A speciality says what you work on — and how you, as someone who knows the subject, want to be engaged inside it. Whichever one you are using reaches every session where you hold a claim in that role. Train it by adding things you have written; it also picks things up on its own as you work.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":230,"string_id":"244ea2a3564e","state":"preferences"},
+        {"key":"L0055","section":"Your specialities","text":"Markets, incentives, and how to price them.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":258,"string_id":"8bdec961e84a","state":"preferences"},
         {"key":"L0056","section":"Your specialities","text":"What this adds to your sessions — written by someone else","placement":"unplaced","state":"preferences"},
-        {"key":"L0057","section":"Your specialities","text":"Argue from mechanism, not vibes. Always name the assumption a number rests on.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":245,"string_id":"d9dd46194f35","state":"preferences"},
+        {"key":"L0057","section":"Your specialities","text":"Argue from mechanism, not vibes. Always name the assumption a number rests on.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":262,"string_id":"d9dd46194f35","state":"preferences"},
         {"key":"L0058","section":"Your specialities","text":"{…} and {…}","placement":"placed","file":"modules/hall-ui/public/profile-nudge.js","line":77,"string_id":"56b00d773232","state":"preferences","occurrences":46},
         {"key":"L0059","section":"Your specialities","text":"Trained on","placement":"placed","file":"modules/hall-ui/public/settings-specialities.js","line":322,"string_id":"becc35640e42","state":"preferences","occurrences":2},
         {"key":"L0060","section":"Your specialities","text":"document{…} you added · learned","placement":"placed","file":"modules/hall-ui/public/settings-specialities.js","line":322,"string_id":"a3fd52d9513b","state":"preferences","occurrences":2},
@@ -2674,46 +2674,46 @@
         {"key":"L0082","section":"Your specialities","text":"{…} file{…}","placement":"placed","file":"modules/hall-ui/public/gate.js","line":151,"string_id":"3efa67dc6e07","state":"offered-skills","occurrences":4},
         {"key":"L0083","section":"Your specialities","text":"{…} of {…}","placement":"placed","file":"modules/hall-ui/public/sky-panel.js","line":120,"string_id":"73c1372b43d9","state":"offered-skills","occurrences":4},
         {"key":"L0084","section":"Your specialities","text":"Save what it offers","placement":"placed","file":"modules/hall-ui/public/settings-specialities.js","line":276,"string_id":"a98b96e49388","state":"offered-skills"},
-        {"key":"L0085","section":"Create one","text":"Create one","placement":"placed","file":"modules/hall-ui/public/settings.html","line":224,"string_id":"20459b66303a","state":"preferences"},
+        {"key":"L0085","section":"Create one","text":"Create one","placement":"placed","file":"modules/hall-ui/public/settings.html","line":241,"string_id":"20459b66303a","state":"preferences"},
         {"key":"L0086","section":"Create one","text":"Name","placement":"unplaced","state":"preferences"},
-        {"key":"L0087","section":"Create one","text":"Role it sits under","placement":"placed","file":"modules/hall-ui/public/settings.html","line":230,"string_id":"12af2af5acf2","state":"preferences"},
-        {"key":"L0088","section":"Create one","text":"Pick one…","placement":"placed","file":"modules/hall-ui/public/settings.html","line":232,"string_id":"45378ea261f6","state":"preferences"},
+        {"key":"L0087","section":"Create one","text":"Role it sits under","placement":"placed","file":"modules/hall-ui/public/settings.html","line":247,"string_id":"12af2af5acf2","state":"preferences"},
+        {"key":"L0088","section":"Create one","text":"Pick one…","placement":"placed","file":"modules/hall-ui/public/settings.html","line":249,"string_id":"45378ea261f6","state":"preferences"},
         {"key":"L0089","section":"Create one","text":"Ideator","placement":"unplaced","state":"preferences"},
         {"key":"L0090","section":"Create one","text":"Artist","placement":"unplaced","state":"preferences"},
-        {"key":"L0091","section":"Create one","text":"UI design","placement":"placed","file":"modules/hall-ui/public/settings.html","line":236,"string_id":"6516cc82021a","state":"preferences"},
+        {"key":"L0091","section":"Create one","text":"UI design","placement":"placed","file":"modules/hall-ui/public/settings.html","line":253,"string_id":"6516cc82021a","state":"preferences"},
         {"key":"L0092","section":"Create one","text":"Summary","placement":"unplaced","state":"preferences"},
         {"key":"L0093","section":"Create one","text":"(optional)","placement":"unplaced","state":"preferences","occurrences":3},
-        {"key":"L0094","section":"Create one","text":"Markets, incentives, and how to price them.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":241,"string_id":"8bdec961e84a","attr":"placeholder","state":"preferences"},
-        {"key":"L0095","section":"Create one","text":"How Claude should engage you in it","placement":"placed","file":"modules/hall-ui/public/settings.html","line":244,"string_id":"6dd3c797943b","state":"preferences"},
-        {"key":"L0096","section":"Create one","text":"Argue from mechanism, not vibes. Always name the assumption a number rests on.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":245,"string_id":"d9dd46194f35","attr":"placeholder","state":"preferences"},
-        {"key":"L0097","section":"Create one","text":"Who can use it","placement":"placed","file":"modules/hall-ui/public/settings.html","line":248,"string_id":"b79ea4077bc5","state":"preferences"},
-        {"key":"L0098","section":"Create one","text":"Only me","placement":"placed","file":"modules/hall-ui/public/settings.html","line":250,"string_id":"45b667751b95","state":"preferences"},
-        {"key":"L0099","section":"Create one","text":"Anyone in the owning project","placement":"placed","file":"modules/hall-ui/public/settings.html","line":251,"string_id":"8832c7204180","state":"preferences"},
-        {"key":"L0100","section":"Create one","text":"Anyone on this instance","placement":"placed","file":"modules/hall-ui/public/settings.html","line":252,"string_id":"7d2ab55d4112","state":"preferences"},
-        {"key":"L0101","section":"Create one","text":"May be offered for sale later","placement":"placed","file":"modules/hall-ui/public/settings.html","line":257,"string_id":"6e73716aec6c","state":"preferences"},
-        {"key":"L0102","section":"Create one","text":"Records your decision only — there is no marketplace yet, and nothing is listed anywhere.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":259,"string_id":"b40c4a61070e","state":"preferences"},
-        {"key":"L0103","section":"Create one","text":"Skills it offers","placement":"placed","file":"modules/hall-ui/public/settings.html","line":263,"string_id":"bbbb6e8ab564","state":"preferences"},
-        {"key":"L0104","section":"Create one","text":"Create speciality","placement":"placed","file":"modules/hall-ui/public/settings.html","line":267,"string_id":"af21de422c14","state":"preferences"},
+        {"key":"L0094","section":"Create one","text":"Markets, incentives, and how to price them.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":258,"string_id":"8bdec961e84a","attr":"placeholder","state":"preferences"},
+        {"key":"L0095","section":"Create one","text":"How Claude should engage you in it","placement":"placed","file":"modules/hall-ui/public/settings.html","line":261,"string_id":"6dd3c797943b","state":"preferences"},
+        {"key":"L0096","section":"Create one","text":"Argue from mechanism, not vibes. Always name the assumption a number rests on.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":262,"string_id":"d9dd46194f35","attr":"placeholder","state":"preferences"},
+        {"key":"L0097","section":"Create one","text":"Who can use it","placement":"placed","file":"modules/hall-ui/public/settings.html","line":265,"string_id":"b79ea4077bc5","state":"preferences"},
+        {"key":"L0098","section":"Create one","text":"Only me","placement":"placed","file":"modules/hall-ui/public/settings.html","line":267,"string_id":"45b667751b95","state":"preferences"},
+        {"key":"L0099","section":"Create one","text":"Anyone in the owning project","placement":"placed","file":"modules/hall-ui/public/settings.html","line":268,"string_id":"8832c7204180","state":"preferences"},
+        {"key":"L0100","section":"Create one","text":"Anyone on this instance","placement":"placed","file":"modules/hall-ui/public/settings.html","line":269,"string_id":"7d2ab55d4112","state":"preferences"},
+        {"key":"L0101","section":"Create one","text":"May be offered for sale later","placement":"placed","file":"modules/hall-ui/public/settings.html","line":274,"string_id":"6e73716aec6c","state":"preferences"},
+        {"key":"L0102","section":"Create one","text":"Records your decision only — there is no marketplace yet, and nothing is listed anywhere.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":276,"string_id":"b40c4a61070e","state":"preferences"},
+        {"key":"L0103","section":"Create one","text":"Skills it offers","placement":"placed","file":"modules/hall-ui/public/settings.html","line":280,"string_id":"bbbb6e8ab564","state":"preferences"},
+        {"key":"L0104","section":"Create one","text":"Create speciality","placement":"placed","file":"modules/hall-ui/public/settings.html","line":284,"string_id":"af21de422c14","state":"preferences"},
         {"key":"L0105","section":"Wandering","text":"Wandering","placement":"unplaced","state":"preferences"},
-        {"key":"L0106","section":"Wandering","text":"How readily Claude opens a","placement":"placed","file":"modules/hall-ui/public/settings.html","line":279,"string_id":"0bae5deb899d","state":"preferences"},
-        {"key":"L0107","section":"Wandering","text":"new thread","placement":"placed","file":"modules/hall-ui/public/settings.html","line":280,"string_id":"86f235ddfe01","state":"preferences"},
-        {"key":"L0108","section":"Wandering","text":"of work — a tangent, an investigation, an unprompted suggestion — instead of staying on your claimed task. It never limits the work on the task itself. Your rank sets the starting point; newcomers stay locked low.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":280,"string_id":"99f88f2af2ee","state":"preferences"},
+        {"key":"L0106","section":"Wandering","text":"How readily Claude opens a","placement":"placed","file":"modules/hall-ui/public/settings.html","line":296,"string_id":"0bae5deb899d","state":"preferences"},
+        {"key":"L0107","section":"Wandering","text":"new thread","placement":"placed","file":"modules/hall-ui/public/settings.html","line":297,"string_id":"86f235ddfe01","state":"preferences"},
+        {"key":"L0108","section":"Wandering","text":"of work — a tangent, an investigation, an unprompted suggestion — instead of staying on your claimed task. It never limits the work on the task itself. Your rank sets the starting point; newcomers stay locked low.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":297,"string_id":"99f88f2af2ee","state":"preferences"},
         {"key":"L0109","section":"Wandering","text":"{…} file{…}","placement":"placed","file":"modules/hall-ui/public/gate.js","line":151,"string_id":"3efa67dc6e07","state":"preferences"},
         {"key":"L0110","section":"Wandering","text":"default for your rank","placement":"placed","file":"modules/hall-ui/public/settings.js","line":420,"string_id":"4a287afb0892","state":"preferences"},
         {"key":"L0111","section":"Wandering","text":"{…} and {…}","placement":"placed","file":"modules/hall-ui/public/profile-nudge.js","line":77,"string_id":"56b00d773232","state":"preferences"},
         {"key":"L0112","section":"Wandering","text":"Now: {…}. Your rank allows up to {…}.","placement":"unplaced","state":"preferences"},
         {"key":"L0113","section":"Rendering","text":"Rendering","placement":"unplaced","state":"preferences"},
-        {"key":"L0114","section":"Rendering","text":"How much your session cards — what","placement":"placed","file":"modules/hall-ui/public/settings.html","line":298,"string_id":"160adde1e398","state":"preferences"},
-        {"key":"L0115","section":"Rendering","text":", claiming, and shipping show — spend on explaining themselves. Richer cards say more and cost more tokens; leaner ones carry the same facts for less. By default this follows how Claude talks to you, so you can set it once in","placement":"placed","file":"modules/hall-ui/public/settings.html","line":299,"string_id":"1f8aceffb15e","state":"preferences"},
-        {"key":"L0116","section":"Rendering","text":"How Claude talks to you","placement":"placed","file":"modules/hall-ui/public/settings.html","line":193,"string_id":"0469a83cf1e8","state":"preferences"},
-        {"key":"L0117","section":"Rendering","text":"and leave this alone.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":303,"string_id":"2177da93be9b","state":"preferences"},
+        {"key":"L0114","section":"Rendering","text":"How much your session cards — what","placement":"placed","file":"modules/hall-ui/public/settings.html","line":315,"string_id":"160adde1e398","state":"preferences"},
+        {"key":"L0115","section":"Rendering","text":", claiming, and shipping show — spend on explaining themselves. Richer cards say more and cost more tokens; leaner ones carry the same facts for less. By default this follows how Claude talks to you, so you can set it once in","placement":"placed","file":"modules/hall-ui/public/settings.html","line":316,"string_id":"1f8aceffb15e","state":"preferences"},
+        {"key":"L0116","section":"Rendering","text":"How Claude talks to you","placement":"placed","file":"modules/hall-ui/public/settings.html","line":210,"string_id":"0469a83cf1e8","state":"preferences"},
+        {"key":"L0117","section":"Rendering","text":"and leave this alone.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":320,"string_id":"2177da93be9b","state":"preferences"},
         {"key":"L0118","section":"Rendering","text":"Session card richness","placement":"placed","file":"modules/hall-ui/public/settings-render.js","line":83,"string_id":"64a1f055129e","state":"preferences"},
         {"key":"L0119","section":"Rendering","text":"How much the claim and ship cards show. Richer cards explain more and cost more tokens; the confirmation line is always there whichever you pick.","placement":"placed","file":"modules/hall-ui/public/settings-render.js","line":84,"string_id":"d76a5fcbde7c","state":"preferences"},
         {"key":"L0120","section":"Rendering","text":"Match my interaction profile","placement":"unplaced","state":"preferences"},
         {"key":"L0121","section":"Rendering","text":"default ({…})","placement":"placed","file":"modules/hall-ui/public/settings-render.js","line":64,"string_id":"4adbb8da9999","state":"preferences"},
         {"key":"L0122","section":"Rendering","text":"{…} Change that profile and this follows it.","placement":"placed","file":"modules/hall-ui/public/settings-render.js","line":65,"string_id":"de5b58a187c6","state":"preferences"},
         {"key":"L0123","section":"Rendering","text":"{…} and {…}","placement":"placed","file":"modules/hall-ui/public/profile-nudge.js","line":77,"string_id":"56b00d773232","state":"preferences"},
-        {"key":"L0124","section":"Rendering","text":"Saves the moment you choose; applies from your next session.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":307,"string_id":"72f24fcbe9e0","state":"preferences"},
+        {"key":"L0124","section":"Rendering","text":"Saves the moment you choose; applies from your next session.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":324,"string_id":"72f24fcbe9e0","state":"preferences"},
         {"key":"L0125","section":"Rendering","text":"Using this speciality.","placement":"placed","file":"modules/hall-ui/public/settings-specialities.js","line":454,"string_id":"e1ecd543a2ca","state":"skills-walkthrough"},
         {"key":"L0126","section":"CLI access","text":"CLI access","placement":"placed","file":"modules/hall-ui/public/settings.html","line":133,"string_id":"a015a43bfc7f","state":"access"},
         {"key":"L0127","section":"CLI access","text":"Mint a fresh CLI token using this browser session and paste it into your terminal — the quick way back in when a","placement":"placed","file":"modules/hall-ui/public/settings.html","line":134,"string_id":"64e91044df43","state":"access"},
@@ -2732,33 +2732,38 @@
         {"key":"L0140","section":"Active sessions","text":"Sign out everywhere","placement":"placed","file":"modules/hall-ui/public/settings.html","line":160,"string_id":"8ad669ab2565","state":"access"},
         {"key":"L0141","section":"Active sessions","text":"ends every session including this one — you will be asked to sign in again.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":161,"string_id":"12a23cc46ace","state":"access"},
         {"key":"L0142","section":"Active sessions","text":"Ending a session takes effect immediately; the token stops working on its very next request.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":163,"string_id":"8e82771e5b63","state":"access"},
-        {"key":"L0143","section":"Image-generation key","text":"Image-generation key","placement":"placed","file":"modules/hall-ui/public/settings.html","line":173,"string_id":"783853467d52","state":"access","occurrences":2},
-        {"key":"L0144","section":"Image-generation key","text":"The art pipeline draws tiles and sprites with Google AI Studio (Gemini). Needed only if you generate art — your key, your bill, paid only for what you make.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":174,"string_id":"600b90074021","state":"access"},
-        {"key":"L0145","section":"Image-generation key","text":"Your key","placement":"placed","file":"modules/hall-ui/public/settings.js","line":828,"string_id":"51fd6f1ecb2f","state":"access"},
-        {"key":"L0146","section":"Image-generation key","text":"Paste your Google AI Studio key","placement":"unplaced","attr":"placeholder","state":"access"},
-        {"key":"L0147","section":"Image-generation key","text":"Save key","placement":"placed","file":"modules/hall-ui/public/settings.js","line":832,"string_id":"0c79b504aebe","state":"access"},
-        {"key":"L0148","section":"Image-generation key","text":"Get a free key ↗","placement":"placed","file":"modules/hall-ui/public/settings.js","line":800,"string_id":"2ae2114b61db","state":"access"},
-        {"key":"L0149","section":"Image-generation key","text":"· Stored encrypted; never shown again after saving.","placement":"placed","file":"modules/hall-ui/public/settings.js","line":834,"string_id":"b3757ba3bb46","state":"access"},
-        {"key":"L0150","section":"Image-generation key","text":"Stored encrypted; never shown again after saving — only its last four digits.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":182,"string_id":"6c6544f5c011","state":"access"},
-        {"key":"L0151","section":"Connections","text":"Connections","placement":"unplaced"},
-        {"key":"L0152","section":"Connections","text":"Link your Discord account and you're added to the {{worldName}} server with your rank role already set — no invite to share or leak.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":64,"string_id":"64e85f1691f9"},
-        {"key":"L0153","section":"Connections","text":"Discord connected ✓","placement":"placed","file":"modules/hall-ui/public/settings.js","line":676,"string_id":"0f685daf1bd5"},
-        {"key":"L0154","section":"Connections","text":"You're in the {…} server with your rank role.","placement":"placed","file":"modules/hall-ui/public/settings.js","line":677,"string_id":"8e1915b19274"},
-        {"key":"L0155","section":"Connections","text":"Unlink","placement":"unplaced"},
-        {"key":"L0156","section":"Connections","text":"Linking opens Discord's consent screen; unlinking applies at once.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":69,"string_id":"9a31cf5fe05b"},
-        {"key":"L0157","section":"Display name","text":"Display name","placement":"placed","file":"modules/hall-ui/public/settings.html","line":77,"string_id":"3e561393f4e9","occurrences":2},
-        {"key":"L0158","section":"Display name","text":"The name shown beside your work — in the roster, the leaderboard, and the work feed. Your sign-in and the credit for shipped work stay tied to your account, not this label.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":78,"string_id":"82479c539fca"},
-        {"key":"L0159","section":"Display name","text":"Your display name","placement":"placed","file":"modules/hall-ui/public/settings.html","line":87,"string_id":"909b0b7c6ffa","attr":"placeholder"},
-        {"key":"L0160","section":"Display name","text":"Save","placement":"unplaced"},
-        {"key":"L0161","section":"Display name","text":"Saves when you press Save; shows everywhere at once.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":91,"string_id":"e8e4e49fe8f4"},
-        {"key":"L0162","section":"Preferred roles","text":"Preferred roles","placement":"placed","file":"modules/hall-ui/public/settings.html","line":115,"string_id":"e883f2789cae"},
-        {"key":"L0163","section":"Preferred roles","text":"The kinds of work you prefer. Task suggestions lean toward your choices — pick one, several, or none.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":116,"string_id":"9f45c63c9697"},
-        {"key":"L0164","section":"Preferred roles","text":"Artist","placement":"unplaced"},
-        {"key":"L0165","section":"Preferred roles","text":"Ideator","placement":"unplaced"},
-        {"key":"L0166","section":"Preferred roles","text":"UI","placement":"unplaced"},
-        {"key":"L0167","section":"Preferred roles","text":"Save","placement":"unplaced"},
-        {"key":"L0168","section":"Preferred roles","text":"Saves when you press Save; your next","placement":"placed","file":"modules/hall-ui/public/settings.html","line":125,"string_id":"42cbc20a6ec8"},
-        {"key":"L0169","section":"Preferred roles","text":"reflects it.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":125,"string_id":"26da1df6fd4a"}
+        {"key":"L0143","section":"Your Autobongos runner","text":"Your Autobongos runner","placement":"placed","file":"modules/hall-ui/public/settings.html","line":173,"string_id":"3749997eef4a","state":"access"},
+        {"key":"L0144","section":"Your Autobongos runner","text":"Choose which goals your own runner works while you are away. You can only choose from the goals the project allows. If you choose none, your runner takes no work.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":174,"string_id":"2b504633779f","state":"access"},
+        {"key":"L0145","section":"Your Autobongos runner","text":"Goal {…}","placement":"placed","file":"modules/hall-ui/public/gate.js","line":288,"string_id":"ec88b946ad16","state":"access","occurrences":2},
+        {"key":"L0146","section":"Your Autobongos runner","text":"Save","placement":"unplaced","state":"access"},
+        {"key":"L0147","section":"Your Autobongos runner","text":"Your runner works 1 goal.","placement":"unplaced","state":"access"},
+        {"key":"L0148","section":"Image-generation key","text":"Image-generation key","placement":"placed","file":"modules/hall-ui/public/settings.html","line":190,"string_id":"783853467d52","state":"access","occurrences":2},
+        {"key":"L0149","section":"Image-generation key","text":"The art pipeline draws tiles and sprites with Google AI Studio (Gemini). Needed only if you generate art — your key, your bill, paid only for what you make.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":191,"string_id":"600b90074021","state":"access"},
+        {"key":"L0150","section":"Image-generation key","text":"Your key","placement":"placed","file":"modules/hall-ui/public/settings.js","line":828,"string_id":"51fd6f1ecb2f","state":"access"},
+        {"key":"L0151","section":"Image-generation key","text":"Paste your Google AI Studio key","placement":"unplaced","attr":"placeholder","state":"access"},
+        {"key":"L0152","section":"Image-generation key","text":"Save key","placement":"placed","file":"modules/hall-ui/public/settings.js","line":832,"string_id":"0c79b504aebe","state":"access"},
+        {"key":"L0153","section":"Image-generation key","text":"Get a free key ↗","placement":"placed","file":"modules/hall-ui/public/settings.js","line":800,"string_id":"2ae2114b61db","state":"access"},
+        {"key":"L0154","section":"Image-generation key","text":"· Stored encrypted; never shown again after saving.","placement":"placed","file":"modules/hall-ui/public/settings.js","line":834,"string_id":"b3757ba3bb46","state":"access"},
+        {"key":"L0155","section":"Image-generation key","text":"Stored encrypted; never shown again after saving — only its last four digits.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":199,"string_id":"6c6544f5c011","state":"access"},
+        {"key":"L0156","section":"Connections","text":"Connections","placement":"unplaced"},
+        {"key":"L0157","section":"Connections","text":"Link your Discord account and you're added to the {{worldName}} server with your rank role already set — no invite to share or leak.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":64,"string_id":"64e85f1691f9"},
+        {"key":"L0158","section":"Connections","text":"Discord connected ✓","placement":"placed","file":"modules/hall-ui/public/settings.js","line":676,"string_id":"0f685daf1bd5"},
+        {"key":"L0159","section":"Connections","text":"You're in the {…} server with your rank role.","placement":"placed","file":"modules/hall-ui/public/settings.js","line":677,"string_id":"8e1915b19274"},
+        {"key":"L0160","section":"Connections","text":"Unlink","placement":"unplaced"},
+        {"key":"L0161","section":"Connections","text":"Linking opens Discord's consent screen; unlinking applies at once.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":69,"string_id":"9a31cf5fe05b"},
+        {"key":"L0162","section":"Display name","text":"Display name","placement":"placed","file":"modules/hall-ui/public/settings.html","line":77,"string_id":"3e561393f4e9","occurrences":2},
+        {"key":"L0163","section":"Display name","text":"The name shown beside your work — in the roster, the leaderboard, and the work feed. Your sign-in and the credit for shipped work stay tied to your account, not this label.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":78,"string_id":"82479c539fca"},
+        {"key":"L0164","section":"Display name","text":"Your display name","placement":"placed","file":"modules/hall-ui/public/settings.html","line":87,"string_id":"909b0b7c6ffa","attr":"placeholder"},
+        {"key":"L0165","section":"Display name","text":"Save","placement":"unplaced"},
+        {"key":"L0166","section":"Display name","text":"Saves when you press Save; shows everywhere at once.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":91,"string_id":"e8e4e49fe8f4"},
+        {"key":"L0167","section":"Preferred roles","text":"Preferred roles","placement":"placed","file":"modules/hall-ui/public/settings.html","line":115,"string_id":"e883f2789cae"},
+        {"key":"L0168","section":"Preferred roles","text":"The kinds of work you prefer. Task suggestions lean toward your choices — pick one, several, or none.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":116,"string_id":"9f45c63c9697"},
+        {"key":"L0169","section":"Preferred roles","text":"Artist","placement":"unplaced"},
+        {"key":"L0170","section":"Preferred roles","text":"Ideator","placement":"unplaced"},
+        {"key":"L0171","section":"Preferred roles","text":"UI","placement":"unplaced"},
+        {"key":"L0172","section":"Preferred roles","text":"Save","placement":"unplaced"},
+        {"key":"L0173","section":"Preferred roles","text":"Saves when you press Save; your next","placement":"placed","file":"modules/hall-ui/public/settings.html","line":125,"string_id":"42cbc20a6ec8"},
+        {"key":"L0174","section":"Preferred roles","text":"reflects it.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":125,"string_id":"26da1df6fd4a"}
       ]
     },
     {

package/docs/recipes/private-npm-distribution.md

@@ -57,6 +57,8 @@ npm publish ./clients/bongos-client               # real (publishConfig makes it
 
 **Publishing is automatic on merge** as of 2026-08-08: the `publish` workflow rides behind the required `unit` check and waits for the `integration` lane's verdict on the commit it releases (task 1004290), auto-bumps a patch when nobody bumped, builds through the fail-closed no-leak gate, publishes, and tags — see the workflow header (`.github/workflows/publish.yml`) and ADR 0161. It ships inert until the owner arms it: repo variable `PUBLISH_ON_MERGE=1`, a **trusted publisher** registered on npmjs.com for `@bongos/core` naming this repo + `publish.yml`, and the secret `RELEASE_PUSH_TOKEN` (contents:write, for the bump commit). There is deliberately **no** `NPM_TOKEN` — the lane authenticates by OIDC, and the workflow sets neither `NPM_TOKEN` nor `NODE_AUTH_TOKEN` because either one would send npm down the legacy token path and skip the OIDC exchange entirely. A **minor/major bump stays a human in-task edit**. The update subscription ([ADR 0136](../adr/0136-update-channel-subscription-policy.md)) consumes whatever is published, on its next sweep.
 
+**Candidates and Release** ([ADR 0361](../adr/0361-merges-publish-as-candidates-release-decides-what-others-are-offered.md), task 1004298). With the repo variable `PUBLISH_AS_CANDIDATE=1`, each merge publishes under the `next` label: the platform hall runs it, and no other project is offered it. **Release** on /deploy runs `publish.yml`'s `release` job (`workflow_dispatch`, input `release_version`), which moves `latest` to that version over the same OIDC trusted publisher. It needs **Allow npm dist-tag** ticked on the `publish.yml` trusted-publisher entry, and the server's GitHub App needs **Actions: write** to start the job. From a terminal the same job runs as `gh workflow run publish.yml -f release_version=<x.y.z>`. The arming order is in the ADR.
+
 The steps below remain as the **manual fallback** (lane disarmed, npm outage, or a deliberate out-of-band release):
 
 1. **Bump `CORE_VERSION`** in [`src/module-api.js`](../../src/module-api.js) (semver; a **patch** for a fix, **minor** for additive surface — a **major** is a deliberate, human-only event) and append an entry to the release ledger [`docs/module-api-changelog.md`](../module-api-changelog.md) in the same commit ([ADR 0203](../adr/0203-doorway-changelog-out-of-module-api.md) moved that ledger out of `module-api.js`). This bump is a normal claimed task, not a release-tool side effect — the version's provenance stays in the git history + ledger.

package/docs/recipes/upgrading-the-core.md

@@ -97,7 +97,7 @@ A **major** is never automatic; prereleases are never auto-targeted.
 | `released` *(default)* | versions at or below the registry's `latest` label, what the owner has released | every project |
 | `candidates` | every published version, as soon as it is published | **the platform's own hall only** |
 
-An instance that follows releases and whose `latest` label cannot be read is **skipped**, never upgraded on a guess. Until candidates publish under their own label (task 1004298), `latest` is the newest version, so the two follows pick the same target. Set the platform's own entry to `"follow": "candidates"` **before** that split lands, or the platform stops taking candidates the day they appear.
+An instance that follows releases and whose `latest` label cannot be read is **skipped**, never upgraded on a guess. Once merges publish as candidates (task 1004298, [ADR 0361](../adr/0361-merges-publish-as-candidates-release-decides-what-others-are-offered.md), switched on by the repo variable `PUBLISH_AS_CANDIDATE=1`), `latest` moves only when the owner presses **Release** on /deploy, and the two follows part. Until that variable is set, `latest` is the newest version and they pick the same target. Set the platform's own entry to `"follow": "candidates"` **before** setting it, or the platform stops taking new versions the moment it is set. The platform's runner for hosted projects needs no roster entry: the `control-plane` row follows candidates and every other project follows releases.
 
 **Crossing a minor from /deploy** (task [1004405](https://cloudbongos.com/builders#/task/1004405)): set the project's update rule to **Fixes and new releases** (`minor`), or press **Allow new releases and move** on the refused move — either is the explicit "this crosses a minor version" choice. That only works once the box runs a core whose runner reads the rule (core 1.20.29 or later, task [1004445](https://cloudbongos.com/builders#/task/1004445)). A box on anything older runs the old runner, which bounds every move to `patch` whatever the rule says, so its **first** crossing is the manual `upgrade.js --to <version>` above; every later one goes through /deploy.
 

package/modules/autonomy/cadence.js

@@ -161,6 +161,9 @@ function classifyEvent(row = {}) {
 
   if (event === 'fenced') {
     if (code === 'kill_switch') return { class: 'stopped', detail: row.reason || 'an owner stopped the runner' };
+    // The per-builder stops (task 1004501) are the same kind of fact as the project
+    // switch: a person decided, and probing will not change their mind.
+    if (code === 'builder_paused' || code === 'not_permitted') return { class: 'stopped', detail: row.reason || 'this builder’s runner is stopped' };
     if (code === 'grader_unavailable') return { class: 'transient', detail: 'the grader is unavailable, and it is the only review there is' };
     if (code === 'fence_unreadable') return { class: 'transient', detail: 'the fence could not be read' };
     // no_allowlist / goal_not_allowlisted / protected_path: the fence is working

package/modules/autonomy/db.js

@@ -157,6 +157,138 @@ async function disallowGoal(goalId) {
   return { removed: rowCount > 0 };
 }
 
+// ── each builder's runner scope (task 1004501) ───────────────────────────────
+//
+// The builder's half of the fence: which allowlisted goals THEIR runner works, and
+// whether the owner has paused it. The composition with the project fence is pure
+// and lives in ../fence.js (effectiveFence); these stay dumb.
+
+// readBuilderScope — one builder's picks and pause, or null when they have neither
+// (which effectiveFence reads as "no goals", by owner ruling). The picks join the
+// allowlist so a pick can never outlive its goal there, on top of the CASCADE.
+async function readBuilderScope(builderId) {
+  const [scope, goals] = await Promise.all([
+    pool.query('SELECT owner_paused, owner_paused_reason, owner_paused_by, updated_at FROM autonomy_builder_scope WHERE builder_id = $1', [builderId]),
+    pool.query(
+      `SELECT bg.goal_id FROM autonomy_builder_goals bg
+         JOIN autonomy_allowed_goals ag ON ag.goal_id = bg.goal_id
+        WHERE bg.builder_id = $1 ORDER BY bg.goal_id`,
+      [builderId]
+    ),
+  ]);
+  const row = scope.rows[0];
+  if (!row && !goals.rows.length) return null;
+  return {
+    goals: goals.rows.map((g) => Number(g.goal_id)),
+    owner_paused: !!(row && row.owner_paused === true),
+    owner_paused_reason: (row && row.owner_paused_reason) || null,
+    owner_paused_by: row && row.owner_paused_by ? String(row.owner_paused_by) : null,
+    updated_at: row ? row.updated_at : null,
+  };
+}
+
+// setBuilderGoals — replace one builder's picks with `goalIds`, in one transaction.
+// Every id must already be on the allowlist; if any is not, NOTHING is written and
+// `{ notAllowed: [...] }` says which, so the Settings page can name them. An empty
+// list is a valid answer and means "my runner takes no work".
+async function setBuilderGoals({ builderId, goalIds }) {
+  const ids = [...new Set((goalIds || []).map(Number))];
+  const client = await pool.connect();
+  try {
+    await client.query('BEGIN');
+    if (ids.length) {
+      const { rows } = await client.query('SELECT goal_id FROM autonomy_allowed_goals WHERE goal_id = ANY($1::bigint[])', [ids]);
+      const allowed = new Set(rows.map((r) => Number(r.goal_id)));
+      const notAllowed = ids.filter((g) => !allowed.has(g));
+      if (notAllowed.length) { await client.query('ROLLBACK'); return { notAllowed }; }
+    }
+    await client.query('DELETE FROM autonomy_builder_goals WHERE builder_id = $1', [builderId]);
+    if (ids.length) {
+      await client.query(
+        'INSERT INTO autonomy_builder_goals (builder_id, goal_id) SELECT $1, unnest($2::bigint[])',
+        [builderId, ids]
+      );
+    }
+    // Bump the scope row so the change reaches a waiting runner as a signal.
+    await client.query(
+      `INSERT INTO autonomy_builder_scope (builder_id, updated_at) VALUES ($1, now())
+       ON CONFLICT (builder_id) DO UPDATE SET updated_at = now()`,
+      [builderId]
+    );
+    await client.query('COMMIT');
+    return { goals: ids.slice().sort((a, b) => a - b) };
+  } catch (err) {
+    try { await client.query('ROLLBACK'); } catch (_) { /* the original error is the one to report */ }
+    throw err;
+  } finally {
+    client.release();
+  }
+}
+
+// setBuilderPause — the owner pauses or resumes ONE builder's runner. The reason
+// is kept only while paused, like the project switch. Returns null when no such
+// builder exists, so a typo in the id is a 404 rather than an inert orphan row.
+async function setBuilderPause({ builderId, paused, reason = null, byBuilderId = null }) {
+  const { rows } = await pool.query(
+    `INSERT INTO autonomy_builder_scope (builder_id, owner_paused, owner_paused_reason, owner_paused_by, updated_at)
+     SELECT $1, $2, $3, $4, now() WHERE EXISTS (SELECT 1 FROM builders WHERE id = $1)
+     ON CONFLICT (builder_id) DO UPDATE SET
+       owner_paused = EXCLUDED.owner_paused,
+       owner_paused_reason = EXCLUDED.owner_paused_reason,
+       owner_paused_by = EXCLUDED.owner_paused_by,
+       updated_at = now()
+     RETURNING builder_id, owner_paused, owner_paused_reason, updated_at`,
+    [builderId, paused === true, paused === true ? (reason || 'paused by the owner') : null, byBuilderId]
+  );
+  const r = rows[0];
+  return r ? { ...r, builder_id: String(r.builder_id) } : null;
+}
+
+// readAllRunnerScopes — the owner's view: every builder who has a runner scope or
+// has ever had a runner check in, with their picks, pause, and runners. Three
+// small reads joined here rather than one wide SQL join, so a builder with picks
+// but no runner and one with a runner but no picks both appear.
+async function readAllRunnerScopes() {
+  const [scopes, picks, beats] = await Promise.all([
+    pool.query('SELECT builder_id, owner_paused, owner_paused_reason, updated_at FROM autonomy_builder_scope'),
+    pool.query(
+      `SELECT bg.builder_id, bg.goal_id FROM autonomy_builder_goals bg
+         JOIN autonomy_allowed_goals ag ON ag.goal_id = bg.goal_id ORDER BY bg.goal_id`
+    ),
+    // Capped PER BUILDER, at readRunnerHeartbeats' own 20, so one builder's many
+    // hosts can never push a quieter builder out of the owner's view.
+    pool.query(
+      `SELECT builder_id, host, pid, started_at, mode, consecutive_failures, last_event, working_task_id, working_goal_id,
+              head, disk_head, main_head, claude_account, last_seen_at
+         FROM (SELECT h.*, row_number() OVER (PARTITION BY builder_id ORDER BY last_seen_at DESC) AS rn
+                 FROM autonomy_runner_heartbeat h) t
+        WHERE rn <= 20
+        ORDER BY last_seen_at DESC`
+    ),
+  ]);
+  const byId = new Map();
+  const entry = (id) => {
+    const k = String(id);
+    if (!byId.has(k)) byId.set(k, { builder_id: k, goals: [], owner_paused: false, owner_paused_reason: null, runners: [] });
+    return byId.get(k);
+  };
+  for (const s of scopes.rows) Object.assign(entry(s.builder_id), { owner_paused: s.owner_paused === true, owner_paused_reason: s.owner_paused_reason || null });
+  for (const p of picks.rows) entry(p.builder_id).goals.push(Number(p.goal_id));
+  for (const b of beats.rows) {
+    entry(b.builder_id).runners.push({
+      ...b, builder_id: undefined,
+      working_task_id: b.working_task_id ? String(b.working_task_id) : null,
+      working_goal_id: b.working_goal_id ? String(b.working_goal_id) : null,
+    });
+  }
+  const ids = [...byId.keys()];
+  if (ids.length) {
+    const { rows } = await pool.query('SELECT id, github_login, display_name, rank FROM builders WHERE id = ANY($1::bigint[])', [ids]);
+    for (const r of rows) Object.assign(byId.get(String(r.id)), { github_login: r.github_login, display_name: r.display_name, rank: r.rank });
+  }
+  return [...byId.values()];
+}
+
 // ── the runner heartbeat (task 1003905) ──────────────────────────────────────
 
 // recordRunnerHeartbeat — upsert one host's check-in. ON CONFLICT so the normal
@@ -225,4 +357,8 @@ module.exports = {
   allowGoal,
   disallowGoal,
   setPriorityGoal,
+  readBuilderScope,
+  setBuilderGoals,
+  setBuilderPause,
+  readAllRunnerScopes,
 };