@bongos/core 1.20.45 → 1.20.46

package/docs/copy-inventory.md

@@ -4,13 +4,13 @@
 > Deterministic on a given tree — regenerate and commit rather than hand-editing.
 > Machine-readable twin: [`copy-registry.json`](copy-registry.json).
 
-**2231 strings** across 3 surfaces · 1921 distinct pieces of copy · 2231 certain, 0 heuristic · 216 shown in more than one place.
+**2237 strings** across 3 surfaces · 1927 distinct pieces of copy · 2237 certain, 0 heuristic · 216 shown in more than one place.
 
 ## Surfaces
 
 | surface | lives at | files | strings |
 |---|---|---|---|
-| `builders-hall` | `modules/hall-ui/public` | 112 | 1660 |
+| `builders-hall` | `modules/hall-ui/public` | 112 | 1666 |
 | `status-dashboard` | `modules/status-ui/public` | 4 | 100 |
 | `landing` | `modules/public-landing/public` | 6 | 471 |
 
@@ -78,7 +78,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `4e25e6872321` | 3x | Your projects | modules/public-landing/public/index.html:691, modules/public-landing/public/projects.html:506, modules/public-landing/public/projects.html:668 |
 | … | | _176 more in the JSON registry_ | |
 
-## `builders-hall` — 1660 strings
+## `builders-hall` — 1666 strings
 
 | id | conf | text | where |
 |---|---|---|---|
@@ -128,7 +128,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `b8f70e36c7f9` | certain | A goal may only be added to a version that is still in planning. These were added after this version started b | `modules/hall-ui/public/roadmap.js:95` |
 | `df5eb70b5a05` | certain | A higher rank. Its details are hidden until you reach the rank directly below it. | `modules/hall-ui/public/ranks.js:125` |
 | `0150152ea9ec` | certain | A known snag stopped the move to core {…}: | `modules/hall-ui/public/deploy.js:206` |
-| `2e17d7e236d9` | certain | A module built here can be submitted upstream for review, so it can join the shared catalog with your name and | `modules/hall-ui/public/modules.html:71` |
+| `2e17d7e236d9` | certain | A module built here can be submitted upstream for review, so it can join the shared catalog with your name and | `modules/hall-ui/public/modules.html:74` |
 | `0c611f5a76af` | certain | A move to core {…} failed{…} — this project has moved on since, and is serving {…} now. Whatever stopped that  | `modules/hall-ui/public/deploy.js:366` |
 | `a07c7b335a66` | certain | A protected-scope goal requires a Metic+ member. | `modules/hall-ui/public/goals-render.js:1286` |
 | `a07c7b335a66` | certain | A protected-scope goal requires a Metic+ member. | `modules/hall-ui/public/goals-render.js:1308` |
@@ -169,6 +169,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `375b0e67bc30` | certain | Allow new releases and move to {…} | `modules/hall-ui/public/deploy.js:677` |
 | `86ea8d57d34e` | certain | Allowlisted goals | `modules/hall-ui/public/gate.js:300` |
 | `e99cc5d37404` | certain | Already a member? | `modules/hall-ui/public/hall-render.js:367` |
+| `70ffbebe42fd` | certain | Also available as a Claude page | `modules/hall-ui/public/modules.html:87` |
 | `da5368d10f85` | certain | Amendment {…} passed{…}, and the constitution below is not the one it decided: | `modules/hall-ui/public/government.js:633` |
 | `2ca420e19dbb` | certain | An earlier attempt did not land. | `modules/hall-ui/public/deploy.js:366` |
 | `69f0ca4a4d84` | certain | Analytics scope | `modules/hall-ui/public/hall-render.js:1175` |
@@ -231,7 +232,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `a78477a24a48` | certain | Builders' Hall | `modules/hall-ui/public/index.html:12` |
 | `a78477a24a48` | certain | Builders' Hall | `modules/hall-ui/public/index.html:12` |
 | `a78477a24a48` | certain | Builders' Hall | `modules/hall-ui/public/index.html:49` |
-| `b51edc826cbe` | certain | Built by this project | `modules/hall-ui/public/modules.html:67` |
+| `b51edc826cbe` | certain | Built by this project | `modules/hall-ui/public/modules.html:70` |
 | `563d29ed86d8` | certain | Bulk actions | `modules/hall-ui/public/goals.html:187` |
 | `563d29ed86d8` | certain | Bulk actions | `modules/hall-ui/public/work.html:161` |
 | `46b33550d52b` | certain | Bulk claim | `modules/hall-ui/public/goals.html:190` |
@@ -241,7 +242,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `a015a43bfc7f` | certain | CLI access | `modules/hall-ui/public/settings.html:133` |
 | `084eb64bce72` | certain | Capabilities held by a machine identity, never by a person or a rank. Shown for completeness; nothing here can | `modules/hall-ui/public/government.html:123` |
 | `bdca1f219e6f` | certain | Cast objection | `modules/hall-ui/public/board-room.js:368` |
-| `a974494e44f3` | certain | Catalog at a glance | `modules/hall-ui/public/modules.html:50` |
+| `a974494e44f3` | certain | Catalog at a glance | `modules/hall-ui/public/modules.html:53` |
 | `c1c7158e0a43` | certain | Category saved. | `modules/hall-ui/public/project-settings.js:214` |
 | `0279db21e29a` | certain | Change in Settings → | `modules/hall-ui/public/hall-render.js:577` |
 | `2637480ee2b8` | certain | Change to | `modules/hall-ui/public/deploy.js:294` |
@@ -332,7 +333,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `90691bceaf68` | certain | Could not load | `modules/hall-ui/public/project-settings.js:242` |
 | `90691bceaf68` | certain | Could not load | `modules/hall-ui/public/task.js:1034` |
 | `589a4cfc5442` | certain | Could not load idea {…}. | `modules/hall-ui/public/ideas.js:1018` |
-| `192c893fc64e` | certain | Could not load modules. | `modules/hall-ui/public/modules.js:319` |
+| `192c893fc64e` | certain | Could not load modules. | `modules/hall-ui/public/modules.js:328` |
 | `9912c3835136` | certain | Could not load requests — reload to try again. | `modules/hall-ui/public/collab.js:845` |
 | `7775fec0fa85` | certain | Could not load sessions. | `modules/hall-ui/public/sessions.js:399` |
 | `7775fec0fa85` | certain | Could not load sessions. | `modules/hall-ui/public/sessions.js:437` |
@@ -350,7 +351,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `64f9d51f0fa2` | certain | Could not load your settings. | `modules/hall-ui/public/settings.js:1159` |
 | `de244c45d916` | certain | Could not load {…} | `modules/hall-ui/public/task.js:1027` |
 | `2366356926b4` | certain | Could not mark the primer just now. Try again. | `modules/hall-ui/public/primer.js:259` |
-| `753987b5da13` | certain | Could not reach the submit endpoint. | `modules/hall-ui/public/modules.js:298` |
+| `753987b5da13` | certain | Could not reach the submit endpoint. | `modules/hall-ui/public/modules.js:307` |
 | `6f500726f0ac` | certain | Could not read the report: {…} | `modules/hall-ui/public/watch.js:669` |
 | `21c2f33168a3` | certain | Could not read this project's deploy state: {…} | `modules/hall-ui/public/deploy.js:616` |
 | `21a782f1af26` | certain | Could not read what this would bring in: {…}. The check below still applies. | `modules/hall-ui/public/deploy.js:534` |
@@ -451,7 +452,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `04bbccfe7465` | certain | Everything a new builder needs before claiming their first task. About a ten-minute read. | `modules/hall-ui/public/primer.html:42` |
 | `89d9c0962048` | certain | Everything that fell out of it | `modules/hall-ui/public/idea.js:420` |
 | `37110f7e2b27` | certain | Everything this builder has shipped. Seen one role at a time, with goals and ideas, under | `modules/hall-ui/public/profile.html:108` |
-| `efdb46f76b02` | certain | Everything this instance can run: what the core ships, what this project built, and who keeps each one true as | `modules/hall-ui/public/modules.html:32` |
+| `efdb46f76b02` | certain | Everything this instance can run: what the core ships, what this project built, and who keeps each one true as | `modules/hall-ui/public/modules.html:35` |
 | `94339ddaeeea` | certain | Explore: the sky reveals itself as you follow routes from where you begin. | `modules/hall-ui/public/goal-map.html:65` |
 | `de62f4cc7d2e` | certain | File a bug or idea | `modules/hall-ui/public/ideas.html:55` |
 | `297a6d0a8608` | certain | File conflicts in your goals | `modules/hall-ui/public/goal-inbox.js:126` |
@@ -642,7 +643,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `a0c18cece568` | certain | Loading sittings… | `modules/hall-ui/public/board-room.js:544` |
 | `7ca55f9ba183` | certain | Loading task | `modules/hall-ui/public/task.html:35` |
 | `20d8552e13db` | certain | Loading tasks… | `modules/hall-ui/public/work.html:32` |
-| `217f64ef8667` | certain | Loading the catalog… | `modules/hall-ui/public/modules.html:59` |
+| `217f64ef8667` | certain | Loading the catalog… | `modules/hall-ui/public/modules.html:62` |
 | `a8b3b04b0b4d` | certain | Loading the copy desk… | `modules/hall-ui/public/copy-desk.html:28` |
 | `fcd755e8dd30` | certain | Loading the five questions… | `modules/hall-ui/public/ideas.html:183` |
 | `e201b4962858` | certain | Loading the idea | `modules/hall-ui/public/idea.html:43` |
@@ -676,7 +677,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `d7ce4a3bb745` | certain | Minimize the welcome panel | `modules/hall-ui/public/hall-widgets.js:52` |
 | `19b0ed5781ae` | certain | Minimum rank required to claim this task | `modules/hall-ui/public/task-lib.js:85` |
 | `64e91044df43` | certain | Mint a fresh CLI token using this browser session and paste it into your terminal — the quick way back in when | `modules/hall-ui/public/settings.html:134` |
-| `0f8ea58a536b` | certain | Module catalog | `modules/hall-ui/public/modules.html:46` |
+| `0f8ea58a536b` | certain | Module catalog | `modules/hall-ui/public/modules.html:49` |
 | `adcfddee56a8` | certain | Module scope — tasks authored in this goal are bounded to these modules | `modules/hall-ui/public/goals-render.js:838` |
 | `9af4b7a3a36f` | certain | Module truth | `modules/hall-ui/public/atlas.html:48` |
 | `319e9db996ea` | certain | Modules — {{worldName}} | `modules/hall-ui/public/modules.html:6` |
@@ -774,7 +775,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `9ac63d97239a` | certain | Nothing newer is published that this box can take. There is nothing to deploy. | `modules/hall-ui/public/deploy.js:596` |
 | `43626cff7071` | certain | Nothing of that kind in your sky. | `modules/hall-ui/public/sky-panel.js:123` |
 | `ad9a17a8a5eb` | certain | Nothing shipped yet. | `modules/hall-ui/public/profile.js:242` |
-| `f326632f2013` | certain | Nothing to submit — every module here ships with the core. | `modules/hall-ui/public/modules.js:259` |
+| `f326632f2013` | certain | Nothing to submit — every module here ships with the core. | `modules/hall-ui/public/modules.js:268` |
 | `27c0d872db2d` | certain | Nothing you have typed above is lost by opening this. | `modules/hall-ui/public/ideas.html:155` |
 | `26a07b64f49d` | certain | Now running core {…} | `modules/hall-ui/public/deploy.js:392` |
 | `21cb60a8a96a` | certain | Now running core {…} — but GitHub was not updated. | `modules/hall-ui/public/deploy.js:382` |
@@ -950,6 +951,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `f7ed4ba07178` | certain | Roadmap — {{worldName}} | `modules/hall-ui/public/roadmap.html:6` |
 | `12af2af5acf2` | certain | Role it sits under | `modules/hall-ui/public/settings.html:230` |
 | `b6596905f845` | certain | Said more than once | `modules/hall-ui/public/copy-desk.html:56` |
+| `ce046dcbd8e1` | certain | Save as PDF | `modules/hall-ui/public/modules.html:88` |
 | `0c79b504aebe` | certain | Save key | `modules/hall-ui/public/settings.js:832` |
 | `b3d55c8c765a` | certain | Save my choices | `modules/hall-ui/public/settings-specialities.js:163` |
 | `13ca64ad2498` | certain | Save rule | `modules/hall-ui/public/deploy.js:294` |
@@ -994,7 +996,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `2566a43904cb` | certain | Settings — {{worldName}} | `modules/hall-ui/public/settings.html:6` |
 | `2566a43904cb` | certain | Settings — {{worldName}} | `modules/hall-ui/public/settings.html:6` |
 | `ac44b08aec92` | certain | Ship it | `modules/hall-ui/public/task.js:733` |
-| `b94a6b5b3d8c` | certain | Shipped with the core | `modules/hall-ui/public/modules.html:56` |
+| `b94a6b5b3d8c` | certain | Shipped with the core | `modules/hall-ui/public/modules.html:59` |
 | `0c0a50ba1666` | certain | Shipped {…}{…}, {…}. | `modules/hall-ui/public/task.js:705` |
 | `6dde12eb0c78` | certain | Show all {…} | `modules/hall-ui/public/collab.js:432` |
 | `47b6199cc471` | certain | Show or hide the clock | `modules/hall-ui/public/goal-map.html:68` |
@@ -1145,7 +1147,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `af664a644b13` | certain | The seven government structures, for getting a team up to speed before deciding when to flip a switch. | `modules/hall-ui/public/government.js:809` |
 | `6360a5988f26` | certain | The shape and health of the codebase. | `modules/hall-ui/public/watch.html:105` |
 | `fc422cced9e3` | certain | The shared goals you’ve joined. Browse, join, and leave goals — and read their criteria — on the | `modules/hall-ui/public/goals.js:94` |
-| `ac46dc53d95f` | certain | The shared repository the core ships and the modules this project built for itself, each credited to its autho | `modules/hall-ui/public/modules.html:47` |
+| `ac46dc53d95f` | certain | The shared repository the core ships and the modules this project built for itself, each credited to its autho | `modules/hall-ui/public/modules.html:50` |
 | `5f631f51f29e` | certain | The skill list could not be loaded. Reload the page to try again. | `modules/hall-ui/public/settings.js:127` |
 | `6b617d158e40` | certain | The sky | `modules/hall-ui/public/goal-map.html:45` |
 | `6b617d158e40` | certain | The sky | `modules/hall-ui/public/goal-map.html:45` |
@@ -1549,7 +1551,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `ec6d8c900bc8` | certain | sign in | `modules/hall-ui/public/profile-charts.js:514` |
 | `c8c2551006dc` | certain | skip the tour | `modules/hall-ui/public/goal-map.html:112` |
 | `c8c2551006dc` | certain | skip the tour | `modules/hall-ui/public/thinking.html:122` |
-| `0215b2cdca8c` | certain | submit for review | `modules/hall-ui/public/modules.js:133` |
+| `0215b2cdca8c` | certain | submit for review | `modules/hall-ui/public/modules.js:142` |
 | `43e6f1592ae3` | certain | submit it in the editor | `modules/hall-ui/public/studio.js:797` |
 | `9ec19e32f86f` | certain | submit page | `modules/hall-ui/public/tweak-editor.html:66` |
 | `da30b952a60b` | certain | system / unattributed | `modules/hall-ui/public/goals-page.js:269` |
@@ -1639,7 +1641,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `6c08bfe92e2b` | certain | {…} This project is invite-only: the {…} invites each builder, and there is nothing to apply for here. | `modules/hall-ui/public/hall-render.js:286` |
 | `c5623d60015d` | certain | {…} Your standing is {…}. | `modules/hall-ui/public/hall-render.js:841` |
 | `a91e1e702d4d` | certain | {…} achieved, {…} in progress, {…} not started of {…} goals | `modules/hall-ui/public/roadmap.js:73` |
-| `a65d371b5cb3` | certain | {…} and above can enable or disable a module | `modules/hall-ui/public/modules.js:131` |
+| `a65d371b5cb3` | certain | {…} and above can enable or disable a module | `modules/hall-ui/public/modules.js:140` |
 | `98b1c674fc37` | certain | {…} and up | `modules/hall-ui/public/sessions.js:187` |
 | `111b71a9acaf` | certain | {…} and up. | `modules/hall-ui/public/sessions.js:185` |
 | `56b00d773232` | certain | {…} and {…} | `modules/hall-ui/public/profile-nudge.js:77` |
@@ -1678,6 +1680,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `1a8a6267e490` | certain | {…} unfinished task{…} — say what happens to each | `modules/hall-ui/public/goals-render.js:1015` |
 | `3ad8f32dd43b` | certain | {…} you have sent | `modules/hall-ui/public/profile-connections.js:146` |
 | `8186b562553a` | certain | {…} {…} waiting | `modules/hall-ui/public/work.js:432` |
+| `a9216af9b05e` | certain | {…} {…} — how-to | `modules/hall-ui/public/modules.js:383` |
 | `0d4016a5531c` | certain | {…} {…}{…} | `modules/hall-ui/public/watch.js:503` |
 | `0d4016a5531c` | certain | {…} {…}{…} | `modules/hall-ui/public/work.js:265` |
 | `b3757ba3bb46` | certain | {…} · Stored encrypted; never shown again after saving. | `modules/hall-ui/public/settings.js:834` |
@@ -1685,6 +1688,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `d73256fbc395` | certain | {…} · who votes, and how it {…} | `modules/hall-ui/public/board-room.js:449` |
 | `cab2a4296aec` | certain | {…} · {…} · {…}{…} | `modules/hall-ui/public/goal-inbox.js:458` |
 | `1ac723849449` | certain | {…} · {…}{…} | `modules/hall-ui/public/sky-interaction.js:33` |
+| `ddd2bfc1fb60` | certain | {…} — how to use it | `modules/hall-ui/public/modules.js:385` |
 | `085f93f3f775` | certain | {…} — see all standings | `modules/hall-ui/public/hall-render.js:80` |
 | `f75ee96a7511` | certain | {…} — total payout from shipped work. | `modules/hall-ui/public/profile.js:94` |
 | `2a2728a4ec4f` | certain | {…}% of tasks complete | `modules/hall-ui/public/roadmap.js:63` |
@@ -1700,6 +1704,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `97e27ab169ae` | certain | {…}{…} session{…} across {…} builder{…}. | `modules/hall-ui/public/sessions.js:338` |
 | `3d74668f69e5` | certain | {…}{…} · {…} | `modules/hall-ui/public/task.js:667` |
 | `7f79bedecf60` | certain | {…}{…} — open it to see what went | `modules/hall-ui/public/goal-inbox.js:374` |
+| `1026fd5f68b7` | certain | · version | `modules/hall-ui/public/modules.js:388` |
 | `4a5ff4f662df` | certain | — ${…} of ${…} this month ({…}%). {…} | `modules/hall-ui/public/hall-render.js:517` |
 | `a6ae9cbdee30` | certain | — all builders — | `modules/hall-ui/public/builders.js:711` |
 | `729d4ce22b99` | certain | — any — | `modules/hall-ui/public/hall-widgets.js:132` |
@@ -1726,6 +1731,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `5f1d914ad45e` | certain | …{…} more — | `modules/hall-ui/public/goal-inbox.js:561` |
 | `de8fa5223aee` | certain | ‹ Prev | `modules/hall-ui/public/hall-kit.js:74` |
 | `d4b84b7fbdeb` | certain | ← All goals | `modules/hall-ui/public/goals.html:83` |
+| `9159687c73ff` | certain | ← All modules | `modules/hall-ui/public/modules.html:85` |
 | `7926e30955d2` | certain | ← Back to goal | `modules/hall-ui/public/goals.html:199` |
 | `7926e30955d2` | certain | ← Back to goal | `modules/hall-ui/public/goals.html:210` |
 | `7926e30955d2` | certain | ← Back to goal | `modules/hall-ui/public/goals.html:222` |

package/docs/copy-registry.json

@@ -3,9 +3,9 @@
   "generator": "scripts/gds/copy-inventory.js",
   "goal": 1000074,
   "counts": {
-    "strings": 2231,
-    "unique_ids": 1921,
-    "certain": 2231,
+    "strings": 2237,
+    "unique_ids": 1927,
+    "certain": 2237,
     "heuristic": 0,
     "duplicate_ids": 216
   },
@@ -13,7 +13,7 @@
     "builders-hall": {
       "at": "modules/hall-ui/public",
       "files": 112,
-      "strings": 1660
+      "strings": 1666
     },
     "status-dashboard": {
       "at": "modules/status-ui/public",
@@ -2713,7 +2713,7 @@
       "surface": "builders-hall",
       "text": "A module built here can be submitted upstream for review, so it can join the shared catalog with your name and this project credited.",
       "file": "modules/hall-ui/public/modules.html",
-      "line": 71,
+      "line": 74,
       "origin": "html-text",
       "confidence": "certain"
     },
@@ -3077,6 +3077,15 @@
       "origin": "js-markup",
       "confidence": "certain"
     },
+    {
+      "id": "70ffbebe42fd",
+      "surface": "builders-hall",
+      "text": "Also available as a Claude page",
+      "file": "modules/hall-ui/public/modules.html",
+      "line": 87,
+      "origin": "html-text",
+      "confidence": "certain"
+    },
     {
       "id": "da5368d10f85",
       "surface": "builders-hall",
@@ -3640,7 +3649,7 @@
       "surface": "builders-hall",
       "text": "Built by this project",
       "file": "modules/hall-ui/public/modules.html",
-      "line": 67,
+      "line": 70,
       "origin": "html-text",
       "confidence": "certain"
     },
@@ -3730,7 +3739,7 @@
       "surface": "builders-hall",
       "text": "Catalog at a glance",
       "file": "modules/hall-ui/public/modules.html",
-      "line": 50,
+      "line": 53,
       "origin": "html-attr:aria-label",
       "confidence": "certain"
     },
@@ -4549,7 +4558,7 @@
       "surface": "builders-hall",
       "text": "Could not load modules.",
       "file": "modules/hall-ui/public/modules.js",
-      "line": 319,
+      "line": 328,
       "origin": "js-notice",
       "confidence": "certain"
     },
@@ -4711,7 +4720,7 @@
       "surface": "builders-hall",
       "text": "Could not reach the submit endpoint.",
       "file": "modules/hall-ui/public/modules.js",
-      "line": 298,
+      "line": 307,
       "origin": "js-notice",
       "confidence": "certain"
     },
@@ -5620,7 +5629,7 @@
       "surface": "builders-hall",
       "text": "Everything this instance can run: what the core ships, what this project built, and who keeps each one true as the core advances.",
       "file": "modules/hall-ui/public/modules.html",
-      "line": 32,
+      "line": 35,
       "origin": "html-text",
       "confidence": "certain"
     },
@@ -7339,7 +7348,7 @@
       "surface": "builders-hall",
       "text": "Loading the catalog…",
       "file": "modules/hall-ui/public/modules.html",
-      "line": 59,
+      "line": 62,
       "origin": "html-text",
       "confidence": "certain"
     },
@@ -7645,7 +7654,7 @@
       "surface": "builders-hall",
       "text": "Module catalog",
       "file": "modules/hall-ui/public/modules.html",
-      "line": 46,
+      "line": 49,
       "origin": "html-text",
       "confidence": "certain"
     },
@@ -8527,7 +8536,7 @@
       "surface": "builders-hall",
       "text": "Nothing to submit — every module here ships with the core.",
       "file": "modules/hall-ui/public/modules.js",
-      "line": 259,
+      "line": 268,
       "origin": "js-text-assign",
       "confidence": "certain"
     },
@@ -10106,6 +10115,15 @@
       "origin": "html-text",
       "confidence": "certain"
     },
+    {
+      "id": "ce046dcbd8e1",
+      "surface": "builders-hall",
+      "text": "Save as PDF",
+      "file": "modules/hall-ui/public/modules.html",
+      "line": 88,
+      "origin": "html-text",
+      "confidence": "certain"
+    },
     {
       "id": "0c79b504aebe",
       "surface": "builders-hall",
@@ -10507,7 +10525,7 @@
       "surface": "builders-hall",
       "text": "Shipped with the core",
       "file": "modules/hall-ui/public/modules.html",
-      "line": 56,
+      "line": 59,
       "origin": "html-text",
       "confidence": "certain"
     },
@@ -11866,7 +11884,7 @@
       "surface": "builders-hall",
       "text": "The shared repository the core ships and the modules this project built for itself, each credited to its author and the project it came from. Everyone can see the state; the switch is rank-gated.",
       "file": "modules/hall-ui/public/modules.html",
-      "line": 47,
+      "line": 50,
       "origin": "html-text",
       "confidence": "certain"
     },
@@ -15502,7 +15520,7 @@
       "surface": "builders-hall",
       "text": "submit for review",
       "file": "modules/hall-ui/public/modules.js",
-      "line": 133,
+      "line": 142,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -16312,7 +16330,7 @@
       "surface": "builders-hall",
       "text": "{…} and above can enable or disable a module",
       "file": "modules/hall-ui/public/modules.js",
-      "line": 131,
+      "line": 140,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -16658,6 +16676,15 @@
       "origin": "js-text-assign",
       "confidence": "certain"
     },
+    {
+      "id": "a9216af9b05e",
+      "surface": "builders-hall",
+      "text": "{…} {…} — how-to",
+      "file": "modules/hall-ui/public/modules.js",
+      "line": 383,
+      "origin": "js-text-assign",
+      "confidence": "certain"
+    },
     {
       "id": "0d4016a5531c",
       "surface": "builders-hall",
@@ -16721,6 +16748,15 @@
       "origin": "js-markup",
       "confidence": "certain"
     },
+    {
+      "id": "ddd2bfc1fb60",
+      "surface": "builders-hall",
+      "text": "{…} — how to use it",
+      "file": "modules/hall-ui/public/modules.js",
+      "line": 385,
+      "origin": "js-text-assign",
+      "confidence": "certain"
+    },
     {
       "id": "085f93f3f775",
       "surface": "builders-hall",
@@ -16856,6 +16892,15 @@
       "origin": "js-markup",
       "confidence": "certain"
     },
+    {
+      "id": "1026fd5f68b7",
+      "surface": "builders-hall",
+      "text": "· version",
+      "file": "modules/hall-ui/public/modules.js",
+      "line": 388,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
     {
       "id": "4a5ff4f662df",
       "surface": "builders-hall",
@@ -17090,6 +17135,15 @@
       "origin": "html-text",
       "confidence": "certain"
     },
+    {
+      "id": "9159687c73ff",
+      "surface": "builders-hall",
+      "text": "← All modules",
+      "file": "modules/hall-ui/public/modules.html",
+      "line": 85,
+      "origin": "html-text",
+      "confidence": "certain"
+    },
     {
       "id": "7926e30955d2",
       "surface": "builders-hall",

package/docs/module-api-changelog.md

@@ -2747,5 +2747,7 @@ is load-bearing: the script throws rather than guess if it is missing, and
         landed since 1.20.43 with no explicit bump. run 36804013644. (task 1002620)
   1.20.45 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
         landed since 1.20.44 with no explicit bump. run 36806095325. (task 1002620)
+  1.20.46 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
+        landed since 1.20.45 with no explicit bump. run 36807065875. (task 1002620)
 ---------------------------------------------------------------------------
 ```

package/docs/modules-contract.md

@@ -370,6 +370,7 @@ Run `bongos upgrade` to confirm coreVersion compatibility, then `node scripts/gd
 - The download is checked with `verifyModuleArtifact`, the same checker the store runs on publish, and must match the version and hashes the store described. A failed check places nothing.
 - A module with no price, or a zero price, is free and granted on the spot. A priced one answers 402 until buying exists (area 8). An entitlement is kept for good, even if a price is added later (ADR 0338 D2).
 - Install never enables. Switch the module on from the hall's Modules tab.
+- **Every version's how-to is a page** (task 1004366). `GET /store/modules/:key/versions/:version/howto` reads the `HOWTO.md` from that version's own stored tarball, after the same hash check install runs, and returns it as text; the hall shows it at `/builders/modules?howto=<key>&version=<X.Y.Z>`, rendered through the hall's escaping markdown reader (`md-reader.js`) because the file is author-written. Any signed-in builder can read it without holding the module; a delisted module's how-to reads only for people who hold it. "Save as PDF" is the browser's own print, with a print sheet that keeps only the document. The optional `howto.artifactUrl` shows as "Also available as a Claude page". Install prints the link, and a Modules-tab row links it when the module on disk is a published store version. A version published before the gate has none and answers 404 `howto_missing`.
 - A module already on disk, in the instance's `modules/` or bundled with the core, is refused; moving one to a newer version is `update`. A module this core cannot mount is refused before download.
 - A delisted module cannot be acquired or downloaded. Channels are not checked yet: every version is general until the channel tasks land.
 

package/docs/page-inventory.json

@@ -591,6 +591,7 @@
       "files": [
         "modules/hall-ui/public/modules.html",
         "modules/hall-ui/public/style.css",
+        "modules/hall-ui/public/room.css",
         "modules/hall-ui/public/oversight.css",
         "modules/hall-ui/public/modules.css",
         "modules/hall-ui/public/shell.js",
@@ -598,6 +599,7 @@
         "modules/hall-ui/public/dom-utils.js",
         "modules/hall-ui/public/brand-apply.js",
         "modules/hall-ui/public/hall-kit.js",
+        "modules/hall-ui/public/md-reader.js",
         "modules/hall-ui/public/modules.js"
       ],
       "states_files": [

package/docs/page-readings.json

@@ -1657,27 +1657,27 @@
       "surface": "builders",
       "title": "Modules",
       "states_read": ["browse","search-empty","lens","details","out"],
-      "files_hash": "6dd8711bd8eea1a0",
+      "files_hash": "171b4bee0aa7dd21",
       "reading_hash": "165201cda2af2264",
       "counts": {"lines":42,"placed":14,"shared":5,"unplaced":23},
       "omitted": {"data":77},
       "notes": [],
       "lines": [
-        {"key":"L0001","section":"skip link","text":"Skip to content","placement":"shared","file":"modules/hall-ui/public/shell.js","line":770,"string_id":"87cee78ca134"},
+        {"key":"L0001","section":"skip link","text":"Skip to content","placement":"shared","file":"modules/hall-ui/public/shell.js","line":767,"string_id":"87cee78ca134"},
         {"key":"L0002","section":"top bar","text":"Modules","placement":"shared"},
-        {"key":"L0003","section":"top bar","text":"Jump to…","placement":"shared","file":"modules/hall-ui/public/shell.js","line":490,"string_id":"eba610d25523"},
-        {"key":"L0004","section":"top bar","text":"⌘K","placement":"shared"},
+        {"key":"L0003","section":"top bar","text":"Jump to…","placement":"shared","file":"modules/hall-ui/public/shell.js","line":487,"string_id":"eba610d25523"},
+        {"key":"L0004","section":"top bar","text":"Ctrl K","placement":"shared"},
         {"key":"L0005","section":"Modules","text":"Modules","placement":"unplaced"},
-        {"key":"L0006","section":"Modules","text":"Everything this instance can run: what the core ships, what this project built, and who keeps each one true as the core advances.","placement":"placed","file":"modules/hall-ui/public/modules.html","line":32,"string_id":"efdb46f76b02"},
-        {"key":"L0007","section":"Module catalog","text":"Module catalog","placement":"placed","file":"modules/hall-ui/public/modules.html","line":46,"string_id":"0f8ea58a536b"},
-        {"key":"L0008","section":"Module catalog","text":"The shared repository the core ships and the modules this project built for itself, each credited to its author and the project it came from. Everyone can see the state; the switch is rank-gated.","placement":"placed","file":"modules/hall-ui/public/modules.html","line":47,"string_id":"ac46dc53d95f"},
+        {"key":"L0006","section":"Modules","text":"Everything this instance can run: what the core ships, what this project built, and who keeps each one true as the core advances.","placement":"placed","file":"modules/hall-ui/public/modules.html","line":35,"string_id":"efdb46f76b02"},
+        {"key":"L0007","section":"Module catalog","text":"Module catalog","placement":"placed","file":"modules/hall-ui/public/modules.html","line":49,"string_id":"0f8ea58a536b"},
+        {"key":"L0008","section":"Module catalog","text":"The shared repository the core ships and the modules this project built for itself, each credited to its author and the project it came from. Everyone can see the state; the switch is rank-gated.","placement":"placed","file":"modules/hall-ui/public/modules.html","line":50,"string_id":"ac46dc53d95f"},
         {"key":"L0009","section":"Module catalog","text":"Search","placement":"unplaced"},
         {"key":"L0010","section":"Module catalog","text":"name, author, origin or licence","placement":"unplaced","attr":"placeholder"},
         {"key":"L0011","section":"Module catalog","text":"State","placement":"unplaced"},
         {"key":"L0012","section":"Module catalog","text":"all","placement":"unplaced"},
         {"key":"L0013","section":"Module catalog","text":"enabled","placement":"unplaced","occurrences":16},
         {"key":"L0014","section":"Module catalog","text":"disabled","placement":"unplaced","occurrences":4},
-        {"key":"L0015","section":"Module catalog","text":"{…} of {…}","placement":"placed","file":"modules/hall-ui/public/sky-panel.js","line":120,"string_id":"73c1372b43d9","state":"search-empty","occurrences":2},
+        {"key":"L0015","section":"Module catalog","text":"{…} of {…}","placement":"placed","file":"modules/hall-ui/public/sky-panel.js","line":120,"string_id":"73c1372b43d9","state":"lens","occurrences":3},
         {"key":"L0016","section":"Module catalog","text":"modules","placement":"unplaced"},
         {"key":"L0017","section":"Module catalog","text":"16 from the {…}","placement":"unplaced"},
         {"key":"L0018","section":"Module catalog","text":"of {…}","placement":"placed","file":"modules/hall-ui/public/roadmap.js","line":288,"string_id":"5e7a2220c6a9"},
@@ -1685,7 +1685,7 @@
         {"key":"L0020","section":"Module catalog","text":"can go upstream","placement":"unplaced"},
         {"key":"L0021","section":"Module catalog","text":"no upkeep","placement":"unplaced"},
         {"key":"L0022","section":"Module catalog","text":"every module owned","placement":"unplaced"},
-        {"key":"L0023","section":"Module catalog","text":"Shipped with the core","placement":"placed","file":"modules/hall-ui/public/modules.html","line":56,"string_id":"b94a6b5b3d8c"},
+        {"key":"L0023","section":"Module catalog","text":"Shipped with the core","placement":"placed","file":"modules/hall-ui/public/modules.html","line":59,"string_id":"b94a6b5b3d8c"},
         {"key":"L0024","section":"Module catalog","text":"No catalog module matches that {…}.","placement":"unplaced","state":"search-empty"},
         {"key":"L0025","section":"Module catalog","text":"{…} and {…}","placement":"placed","file":"modules/hall-ui/public/profile-nudge.js","line":77,"string_id":"56b00d773232","occurrences":12},
         {"key":"L0026","section":"Module catalog","text":"by","placement":"unplaced","occurrences":17},
@@ -1701,10 +1701,10 @@
         {"key":"L0036","section":"Module catalog","text":"{…}-loaded","placement":"unplaced"},
         {"key":"L0037","section":"Module catalog","text":"{…} file{…}","placement":"placed","file":"modules/hall-ui/public/gate.js","line":151,"string_id":"3efa67dc6e07"},
         {"key":"L0038","section":"Module catalog","text":"sessions","placement":"placed","file":"modules/hall-ui/public/task.js","line":495,"string_id":"732b4c935e36"},
-        {"key":"L0039","section":"Module catalog","text":"Built by this project","placement":"placed","file":"modules/hall-ui/public/modules.html","line":67,"string_id":"b51edc826cbe"},
-        {"key":"L0040","section":"Module catalog","text":"submit for review","placement":"placed","file":"modules/hall-ui/public/modules.js","line":133,"string_id":"0215b2cdca8c"},
-        {"key":"L0041","section":"Module catalog","text":"A module built here can be submitted upstream for review, so it can join the shared catalog with your name and this project credited.","placement":"placed","file":"modules/hall-ui/public/modules.html","line":71,"string_id":"2e17d7e236d9"},
-        {"key":"L0042","section":"footer","text":"Sign out","placement":"shared","file":"modules/hall-ui/public/shell.js","line":467,"string_id":"1883ad7f07fc"}
+        {"key":"L0039","section":"Module catalog","text":"Built by this project","placement":"placed","file":"modules/hall-ui/public/modules.html","line":70,"string_id":"b51edc826cbe"},
+        {"key":"L0040","section":"Module catalog","text":"submit for review","placement":"placed","file":"modules/hall-ui/public/modules.js","line":142,"string_id":"0215b2cdca8c"},
+        {"key":"L0041","section":"Module catalog","text":"A module built here can be submitted upstream for review, so it can join the shared catalog with your name and this project credited.","placement":"placed","file":"modules/hall-ui/public/modules.html","line":74,"string_id":"2e17d7e236d9"},
+        {"key":"L0042","section":"footer","text":"Sign out","placement":"shared","file":"modules/hall-ui/public/shell.js","line":464,"string_id":"1883ad7f07fc"}
       ]
     },
     {

package/modules/hall-ui/public/modules.css

@@ -72,3 +72,48 @@
    disabled in the faint ink, the accent only on hover. A viewer below the floor
    sees the state as a pill, not a dead control. */
 .mod-row__right .btn-ghost { white-space: nowrap; }
+
+/* ---- One store version's how-to (task 1004366, ADR 0347) ----
+   The HOWTO.md a version shipped with, read as a document: the reading room's
+   article card (room.css .primer-article) under a bar holding the way back and
+   the two extras. The how-to link on a catalog row is a fact-line text link
+   with the 24px floor's padding trick, like the details disclosure above. */
+.mod-howto {
+  display: inline-block;
+  min-height: 24px;
+  padding: 3px 4px;
+  margin: -3px -4px;
+  line-height: 18px;
+  color: var(--accent-ink);
+}
+.howto[hidden] { display: none; }
+.howto__bar { display: flex; flex-wrap: wrap; align-items: center; justify-content: space-between; gap: 8px 16px; margin: 0 0 12px; }
+.howto__actions { display: inline-flex; flex-wrap: wrap; align-items: center; gap: 8px 14px; }
+.howto__back, .howto__extra {
+  display: inline-block;
+  min-height: 24px;
+  padding: 3px 4px;
+  margin: -3px -4px;
+  line-height: 18px;
+  font-size: 13.5px;
+  color: var(--accent-ink);
+}
+.howto__extra[hidden] { display: none; }
+.howto__meta { margin: 0 0 6px; font-size: 13px; color: var(--ink-soft); }
+.howto__h { margin: 0 0 14px; }
+
+/* "Save as PDF" is the browser's own print (CLAUDE.md §4: the cheapest path, no
+   server-side PDF library). The print sheet keeps the document and drops the
+   hall around it, so the saved PDF is the how-to and nothing else. */
+@media print {
+  .app-sidebar, .app-scrim, .app-topbar, .app-foot, .page-head, #core-scroll, .howto__bar, .toast { display: none !important; }
+  .app, .app-body, .app-content, #hall-main { display: block !important; margin: 0 !important; padding: 0 !important; }
+  /* Paper is light whatever mode the hall was in: the system pair, not a literal. */
+  html { color-scheme: light; }
+  body, .howto__doc { background: Canvas !important; color: CanvasText !important; }
+  .howto__doc { max-width: none; box-shadow: none !important; background: none !important; padding: 0 !important; }
+  /* The dark tier's ink is light; on paper every line is the system ink. */
+  .howto__doc * { color: CanvasText !important; background: none !important; }
+  .howto__doc a { text-decoration: underline; }
+  .howto__doc pre { white-space: pre-wrap; }
+}

package/modules/hall-ui/public/modules.html

@@ -9,6 +9,9 @@
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
   <link rel="stylesheet" href="/builders/style.css?v=2026-07-02-shell1">
+  <!-- task 1004366: a store version's how-to reads as a document, so it borrows the
+       reading room's article card (room.css is scoped to its own primer- classes). -->
+  <link rel="stylesheet" href="/builders/room.css">
   <!-- task 1003472: the catalog rides the oversight family's row (a titled row
        with facts and one action on the right), so the family sheet loads first
        and modules.css holds only what a module row has that no other row does. -->
@@ -71,6 +74,24 @@
             <p class="ov-foot" id="submit-lede">A module built here can be submitted upstream for review, so it can join the shared catalog with your name and this project credited.</p>
           </div>
         </section>
+
+        <!-- One store version's how-to (task 1004366, ADR 0347): the HOWTO.md that
+             version shipped with, opened as ?howto=<key>&version=<X.Y.Z>. Hidden
+             until then; when it shows, the catalog above is hidden instead. The
+             markdown is author-written, so it renders through md-reader.js, which
+             escapes every byte before it adds any markup. -->
+        <section class="howto" id="howto-view" aria-labelledby="howto-h" hidden>
+          <div class="howto__bar">
+            <a class="howto__back" href="/builders/modules">← All modules</a>
+            <span class="howto__actions">
+              <a class="howto__extra" id="howto-extra" target="_blank" rel="noopener" hidden>Also available as a Claude page</a>
+              <button type="button" class="btn-ghost btn--sm" id="howto-print">Save as PDF</button>
+            </span>
+          </div>
+          <p class="howto__meta" id="howto-meta"></p>
+          <h2 class="howto__h" id="howto-h">How-to</h2>
+          <article class="primer-article scroll howto__doc" id="howto-doc" aria-busy="true"></article>
+        </section>
       </main>
 
       <footer class="app-foot" id="app-foot"></footer>
@@ -86,6 +107,7 @@
 <script src="/builders/dom-utils.js?v=2026-06-23-contrib"></script>
 <script src="/builders/brand-apply.js"></script>
 <script src="/builders/hall-kit.js"></script>
-<script src="/builders/modules.js?v=2026-09-02-rows"></script>
+<script src="/builders/md-reader.js"></script>
+<script src="/builders/modules.js?v=2026-09-30-howto"></script>
 </body>
 </html>