@bongos/core 1.21.40 → 1.21.42

package/docs/api-reference.md

@@ -2,7 +2,7 @@
 
 # Bongos API reference
 
-> **Generated from the live route files** — the route file is authoritative. 503 endpoints across 92 route files.
+> **Generated from the live route files** — the route file is authoritative. 510 endpoints across 93 route files.
 > Machine-readable spec: [`docs/api/openapi.json`](api/openapi.json) (OpenAPI 3.1). Rendered docs site: **`/docs`** (e.g. `cloudbongos.com/docs`).
 
 Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust-boundary-server-enforced-permissions.md)): `public` < `any-builder` < `metic+archon` < `archon`.
@@ -573,6 +573,18 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | GET | `/api/bongos/override-requests` | `metic+archon` | — | GET /override-requests?status=open — Archon queue. |
 | POST | `/api/bongos/override-requests/:id/decide` | `metic+archon` | `decision`, `note` | POST /override-requests/:id/decide — body: { decision: 'approve'\|'deny', note? } On approve, atomically flips the task completed→confirme… |
 
+## `page-notes` (7)
+
+| Method | Path | Rank | Body | Description |
+|---|---|---|---|---|
+| GET | `/api/bongos/page-notes` | `any-builder` | — |  |
+| POST | `/api/bongos/page-notes` | `any-builder` | `page_id`, `page_path`, `page_title` |  |
+| GET | `/api/bongos/page-notes/:id` | `any-builder` | — |  |
+| PATCH | `/api/bongos/page-notes/:id` | `any-builder` | `body_md` |  |
+| POST | `/api/bongos/page-notes/:id/images` | `any-builder` | `content_type`, `data`, `name` |  |
+| POST | `/api/bongos/page-notes/:id/submit` | `any-builder` | — |  |
+| GET | `/api/bongos/page-notes/images/:id` | `any-builder` | — |  |
+
 ## `profiles` (1)
 
 | Method | Path | Rank | Body | Description |

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).
 
-**2424 strings** across 3 surfaces · 2107 distinct pieces of copy · 2424 certain, 0 heuristic · 220 shown in more than one place.
+**2441 strings** across 3 surfaces · 2123 distinct pieces of copy · 2441 certain, 0 heuristic · 221 shown in more than one place.
 
 ## Surfaces
 
 | surface | lives at | files | strings |
 |---|---|---|---|
-| `builders-hall` | `modules/hall-ui/public` | 131 | 1775 |
+| `builders-hall` | `modules/hall-ui/public` | 132 | 1792 |
 | `status-dashboard` | `modules/status-ui/public` | 4 | 100 |
 | `landing` | `modules/public-landing/public` | 6 | 549 |
 
@@ -76,9 +76,9 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `a061df49e6cb` | 3x | Skip to content | modules/public-landing/public/account.html:88, modules/public-landing/public/index.html:650, modules/public-landing/public/projects.html:687 |
 | `2ae36be1c531` | 3x | Start a project | modules/public-landing/public/index.html:730, modules/public-landing/public/index.html:894, modules/public-landing/public/projects.html:808 |
 | `2287c62afcdd` | 3x | The street | modules/hall-ui/public/street.html:54, modules/hall-ui/public/street.html:54, modules/hall-ui/public/street.html:97 |
-| … | | _180 more in the JSON registry_ | |
+| … | | _181 more in the JSON registry_ | |
 
-## `builders-hall` — 1775 strings
+## `builders-hall` — 1792 strings
 
 | id | conf | text | where |
 |---|---|---|---|
@@ -147,6 +147,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `524188fe0078` | certain | Active sessions | `modules/hall-ui/public/settings.html:159` |
 | `d628b36ec58e` | certain | Activity, by role | `modules/hall-ui/public/profile.html:137` |
 | `2b94171ce525` | certain | Add dependency | `modules/hall-ui/public/task.js:592` |
+| `a70b72ec4dcc` | certain | Add images | `modules/hall-ui/public/page-notes.js:97` |
 | `da8659b0099b` | certain | Add something you wrote — notes, a standard, a worked example. It is indexed for recall, not pasted into every | `modules/hall-ui/public/settings-specialities.js:354` |
 | `82a8bd77d374` | certain | Add these ranks | `modules/hall-ui/public/government.js:891` |
 | `eded707fab69` | certain | Add to what it knows | `modules/hall-ui/public/settings-specialities.js:354` |
@@ -182,10 +183,10 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `206acb4467a2` | certain | Archive this goal? | `modules/hall-ui/public/goals-render.js:1035` |
 | `d9dd46194f35` | certain | Argue from mechanism, not vibes. Always name the assumption a number rests on. | `modules/hall-ui/public/settings.html:270` |
 | `4d3b1bcae3eb` | certain | Artist Review Status | `modules/hall-ui/public/studio.html:125` |
-| `4a9385eeab33` | certain | Artists start on Artistry. | `modules/hall-ui/public/craft-mode.js:292` |
+| `4a9385eeab33` | certain | Artists start on Artistry. | `modules/hall-ui/public/craft-mode.js:348` |
 | `5fcfdf8975cf` | certain | As configuration: | `modules/hall-ui/public/government.js:960` |
 | `01a0f29ff406` | certain | As first filed | `modules/hall-ui/public/idea.js:467` |
-| `fa86bf403775` | certain | Ask me again next session | `modules/hall-ui/public/craft-mode.js:290` |
+| `fa86bf403775` | certain | Ask me again next session | `modules/hall-ui/public/craft-mode.js:346` |
 | `9b02ba5e6d23` | certain | Asked of others | `modules/hall-ui/public/collab.html:131` |
 | `688cc6dd38ee` | certain | Asked of you | `modules/hall-ui/public/collab.html:48` |
 | `688cc6dd38ee` | certain | Asked of you | `modules/hall-ui/public/collab.html:122` |
@@ -206,6 +207,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `ef2fab4901d6` | certain | Back to tasks | `modules/hall-ui/public/task.js:192` |
 | `2deb6dd36e58` | certain | Back to the city overview | `modules/hall-ui/public/street.html:66` |
 | `28d8d79c4f21` | certain | Backend-only: nothing to record. Check it the way it can be checked (a log, a report, a test against the live  | `modules/hall-ui/public/criterion-uat-ui.js:147` |
+| `02d9d01d5c8b` | certain | Being split into ideas… | `modules/hall-ui/public/page-notes.js:137` |
 | `5a2b73968b36` | certain | Blocker # | `modules/hall-ui/public/blockers.js:364` |
 | `5a2b73968b36` | certain | Blocker # | `modules/hall-ui/public/blockers.js:368` |
 | `5a2b73968b36` | certain | Blocker # | `modules/hall-ui/public/blockers.js:371` |
@@ -223,7 +225,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `da910fee01d7` | certain | Browse goals → | `modules/hall-ui/public/goals.js:83` |
 | `1596210cea76` | certain | Build from your own machine — clone the repository, run the platform locally, and sign in from the terminal. | `modules/hall-ui/public/hall-render.js:810` |
 | `08bfcc9198ba` | certain | Builder id | `modules/hall-ui/public/government.html:109` |
-| `fd1903586e8e` | certain | Builders hall · this session | `modules/hall-ui/public/craft-mode.js:285` |
+| `fd1903586e8e` | certain | Builders hall · this session | `modules/hall-ui/public/craft-mode.js:341` |
 | `306bc316184d` | certain | Builders you may know | `modules/hall-ui/public/profile-connections.js:158` |
 | `60b248791dc3` | certain | Builders — {{worldName}} | `modules/hall-ui/public/roster.html:6` |
 | `60b248791dc3` | certain | Builders — {{worldName}} | `modules/hall-ui/public/roster.html:6` |
@@ -269,7 +271,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `6bf684ebc1c3` | certain | Choose the skills for {…} | `modules/hall-ui/public/settings-specialities.js:180` |
 | `2b504633779f` | certain | Choose which goals your own runner works while you are away. You can only choose from the goals the project al | `modules/hall-ui/public/settings.html:182` |
 | `6c88cdf417f1` | certain | Choose which sound plays for each build event — one when Claude waits for your input, another when a task ship | `modules/hall-ui/public/settings.html:387` |
-| `f7d8c25af75d` | certain | Choose your mode | `modules/hall-ui/public/craft-mode.js:203` |
+| `f7d8c25af75d` | certain | Choose your mode | `modules/hall-ui/public/craft-mode.js:259` |
 | `b7d5648b66db` | certain | Claim it | `modules/hall-ui/public/task.js:714` |
 | `b7d5648b66db` | certain | Claim it | `modules/hall-ui/public/task.js:843` |
 | `c10806b50c61` | certain | Claim task {…} | `modules/hall-ui/public/builders.js:973` |
@@ -287,7 +289,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `d12a2fb5730d` | certain | Close this flag | `modules/hall-ui/public/copy-desk.html:116` |
 | `9b9c2abeae90` | certain | Close this stage | `modules/hall-ui/public/genesis-home.js:209` |
 | `e6f1842afde1` | certain | Close transcript | `modules/hall-ui/public/sessions.html:99` |
-| `29e8c5e30095` | certain | Close without choosing | `modules/hall-ui/public/craft-mode.js:283` |
+| `29e8c5e30095` | certain | Close without choosing | `modules/hall-ui/public/craft-mode.js:339` |
 | `3d148e19e03a` | certain | Closed. | `modules/hall-ui/public/copy-desk.js:510` |
 | `2654dc3ded21` | certain | Closing is a judgement too — say what you decided, so the next person does not re-litigate it. | `modules/hall-ui/public/copy-desk.js:495` |
 | `e5548861ad79` | certain | Coach the grader | `modules/hall-ui/public/studio.js:211` |
@@ -659,7 +661,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `7c9b7a89353b` | certain | Leave goal | `modules/hall-ui/public/goals-render.js:967` |
 | `6137d2679912` | certain | Leave it off | `modules/hall-ui/public/settings-specialities.js:138` |
 | `f192ff6563f9` | certain | Leave your GitHub username and an Archon will let you in. No coding needed to start — once you're approved, si | `modules/hall-ui/public/hall-render.js:297` |
-| `cb6199ba00a0` | certain | Legacy mode · the hall as it was | `modules/hall-ui/public/craft-mode.js:293` |
+| `cb6199ba00a0` | certain | Legacy mode · the hall as it was | `modules/hall-ui/public/craft-mode.js:349` |
 | `e14ebcf3eec5` | certain | Legislation has passed. Genesis is complete. | `modules/hall-ui/public/genesis-home.js:191` |
 | `d6a78b9e5368` | certain | Let it be for now | `modules/hall-ui/public/studio.js:233` |
 | `d6a78b9e5368` | certain | Let it be for now | `modules/hall-ui/public/studio.js:248` |
@@ -791,6 +793,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `d5cf262e671d` | certain | Nobody is writing this page. Take it, and every line here is yours to type over. | `modules/hall-ui/public/tweak-editor.js:314` |
 | `91c409a4aea5` | certain | Nobody vouched for this name — anyone can file a request naming anyone. Confirm who is asking before you admit | `modules/hall-ui/public/watch.js:397` |
 | `4016b9cf8d57` | certain | None of your asks have been settled yet. | `modules/hall-ui/public/collab.html:134` |
+| `36c97d6094bf` | certain | None yet. Yours will be the first. | `modules/hall-ui/public/page-notes.js:120` |
 | `fdfceec7ff97` | certain | Not backend-only | `modules/hall-ui/public/criterion-uat-ui.js:84` |
 | `428a62539050` | certain | Not checked yet — the runner takes this reading on its own tick. | `modules/hall-ui/public/deploy.js:458` |
 | `c72e0bdb834a` | certain | Not declared in module.json — this is who ships the module. | `modules/hall-ui/public/modules.js:62` |
@@ -862,8 +865,11 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `f6f68ba322be` | certain | Open {…} | `modules/hall-ui/public/goal-inbox.js:53` |
 | `f6f68ba322be` | certain | Open {…} | `modules/hall-ui/public/goal-inbox.js:69` |
 | `f6f68ba322be` | certain | Open {…} | `modules/hall-ui/public/goals.js:67` |
+| `35d46f963cd1` | certain | Opening the doc… | `modules/hall-ui/public/page-notes.js:256` |
 | `7a8dfadb7468` | certain | Opening the rendered page… | `modules/hall-ui/public/approval-queue.js:129` |
 | `62e75a9d0af4` | certain | Opening the reviews… | `modules/hall-ui/public/studio.html:159` |
+| `94f3d9f46098` | certain | Opening your doc… | `modules/hall-ui/public/page-notes.js:89` |
+| `94f3d9f46098` | certain | Opening your doc… | `modules/hall-ui/public/page-notes.js:273` |
 | `a2bd76ae030d` | certain | Opens this project's upgrade{…}: you see what would move, confirm it, and it installs, checks itself, and roll | `modules/hall-ui/public/settings-software-update.js:85` |
 | `569980a263ae` | certain | Optional. This is the ledger link — a copy change ships as a task like every other change. | `modules/hall-ui/public/copy-desk.html:130` |
 | `f2e9e8f21e8e` | certain | Or add someone without asking… | `modules/hall-ui/public/goals-render.js:1264` |
@@ -883,7 +889,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `e1e10dc5e357` | certain | Permissions is the Archon administration surface. The Constitution and the Board Room are yours to read. | `modules/hall-ui/public/government.js:1030` |
 | `6bc03d97457b` | certain | Pick a priority first. | `modules/hall-ui/public/task.js:900` |
 | `fcf996d77050` | certain | Pick a rank to see what it may do. The four ladder ranks ship with the platform; a custom rank is yours to sha | `modules/hall-ui/public/government.html:76` |
-| `4f87d5b17b54` | certain | Pick one. You can switch any time from the top bar. | `modules/hall-ui/public/craft-mode.js:287` |
+| `4f87d5b17b54` | certain | Pick one. You can switch any time from the top bar. | `modules/hall-ui/public/craft-mode.js:343` |
 | `45378ea261f6` | certain | Pick one… | `modules/hall-ui/public/settings.html:257` |
 | `25815a34d246` | certain | Plain speech | `modules/hall-ui/public/sessions.html:78` |
 | `07d7e62640d6` | certain | Post & resolve | `modules/hall-ui/public/collab.js:170` |
@@ -1103,6 +1109,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `490f4bbbc75b` | certain | Sounds are switched off for now. Nothing plays when a task ships, when {{currency}} arrive, or when Claude fin | `modules/hall-ui/public/settings.html:361` |
 | `d03aa6752970` | certain | Specialities this project recommends. Nothing here is switched on — read what each one adds to your sessions,  | `modules/hall-ui/public/settings-specialities.js:384` |
 | `01f1d2b03eb4` | certain | Speciality created. | `modules/hall-ui/public/settings-specialities.js:554` |
+| `aee9d47c6b99` | certain | Splitting your feedback into ideas… | `modules/hall-ui/public/page-notes.js:222` |
 | `f2a4d855d82d` | certain | Stale claims | `modules/hall-ui/public/watch.html:48` |
 | `6d4a7bf5ab0e` | certain | Stale timer is now {…} days. | `modules/hall-ui/public/project-settings.js:176` |
 | `98d037e427b8` | certain | Stale — describes something that changed | `modules/hall-ui/public/copy-desk.html:92` |
@@ -1112,6 +1119,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `eaad12cacb9d` | certain | Start over | `modules/hall-ui/public/studio.js:264` |
 | `b01258e8242a` | certain | Starting government | `modules/hall-ui/public/genesis-home.js:131` |
 | `efe530c0e3a7` | certain | Still open | `modules/hall-ui/public/profile.js:568` |
+| `92f87ca38190` | certain | Still splitting. It will appear in this page's docs when it is done. | `modules/hall-ui/public/page-notes.js:232` |
 | `490a3cbb8c1c` | certain | Still working on core {…}. It keeps going without this page — reload to see where it got to. | `modules/hall-ui/public/deploy.js:764` |
 | `9a4ced1afb6c` | certain | Stop waiting on task {…} | `modules/hall-ui/public/task.js:250` |
 | `b0861c874a2f` | certain | Stopped using it. | `modules/hall-ui/public/settings-specialities.js:457` |
@@ -1176,6 +1184,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `325daac25a9a` | certain | The day the sky is drawn for | `modules/hall-ui/public/goal-map.html:127` |
 | `325daac25a9a` | certain | The day the sky is drawn for | `modules/hall-ui/public/thinking.html:128` |
 | `bac12faf3328` | certain | The developmental ladder: {…}. Formality is adopted only where informal coordination breaks. | `modules/hall-ui/public/government.js:816` |
+| `51633ea53205` | certain | The doc is now this page's reference. Every idea links back to it. | `modules/hall-ui/public/page-notes.js:142` |
 | `239d641c20fa` | certain | The document | `modules/hall-ui/public/settings-specialities.js:354` |
 | `ffaa4df90f66` | certain | The editor could not load. | `modules/hall-ui/public/tweak-editor.js:712` |
 | `6e2554615883` | certain | The event sounds could not be loaded. Reload the page to try again. | `modules/hall-ui/public/settings.js:391` |
@@ -1289,6 +1298,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `9a685b01e2c6` | certain | This page opens at a higher rank. | `modules/hall-ui/public/project-settings.html:36` |
 | `9a685b01e2c6` | certain | This page opens at a higher rank. | `modules/hall-ui/public/watch.html:40` |
 | `e7a289134dc3` | certain | This page shows no words the reader could find. | `modules/hall-ui/public/tweak-editor.js:246` |
+| `d4b3b5556986` | certain | This page's reference docs | `modules/hall-ui/public/page-notes.js:113` |
 | `5bdcbec770dd` | certain | This project has no slash commands yet. | `modules/hall-ui/public/commands.js:38` |
 | `fcd43f045614` | certain | This project is upgraded on the server that runs it: | `modules/hall-ui/public/settings-software-update.js:76` |
 | `3c8aaec39c40` | certain | This project's code expects {…} database change{…} that its database has not applied yet. Anything that relies | `modules/hall-ui/public/deploy.js:582` |
@@ -1308,6 +1318,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `becc35640e42` | certain | Trained on | `modules/hall-ui/public/settings-specialities.js:322` |
 | `1bb6c792ceb9` | certain | Try again | `modules/hall-ui/public/deploy.js:268` |
 | `b50089eda0a4` | certain | Try now | `modules/hall-ui/public/deploy.js:217` |
+| `1edc39bc7120` | certain | Turn into ideas | `modules/hall-ui/public/page-notes.js:107` |
 | `26ec8100bc6f` | certain | Turn it on | `modules/hall-ui/public/settings-specialities.js:138` |
 | `72a29648399b` | certain | Tweak a page | `modules/hall-ui/public/tweak-editor.html:32` |
 | `72a29648399b` | certain | Tweak a page | `modules/hall-ui/public/tweak-editor.html:32` |
@@ -1357,7 +1368,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `c1fcfa9b48c2` | certain | Watch — {{worldName}} | `modules/hall-ui/public/watch.html:6` |
 | `0658f0358ffd` | certain | Welcome back, {…}. | `modules/hall-ui/public/hall-render.js:600` |
 | `04ef2f1bc4c4` | certain | Welcome, {…}. Claim and release tasks and follow work in progress — no terminal needed. | `modules/hall-ui/public/work.js:922` |
-| `60853319f290` | certain | What are you doing now? | `modules/hall-ui/public/craft-mode.js:286` |
+| `60853319f290` | certain | What are you doing now? | `modules/hall-ui/public/craft-mode.js:342` |
 | `d6bae87dc29b` | certain | What builders will see | `modules/hall-ui/public/government.html:86` |
 | `f3d93a872a38` | certain | What counts | `modules/hall-ui/public/drachmae.js:107` |
 | `6bf049a0c943` | certain | What each project costs | `modules/hall-ui/public/fleet.html:35` |
@@ -1375,6 +1386,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `00dc1f0f83e1` | certain | What kind of wrong? | `modules/hall-ui/public/copy-desk.html:87` |
 | `c9a4c6f16433` | certain | What needs changing | `modules/hall-ui/public/approval-queue.js:174` |
 | `9a85f2c19b48` | certain | What should it say? | `modules/hall-ui/public/copy-desk.html:156` |
+| `7c765a4209d1` | certain | What should this page be? | `modules/hall-ui/public/page-notes.js:85` |
 | `2dd116d2d817` | certain | What the current wording gets wrong, and what yours does about it. | `modules/hall-ui/public/copy-desk.html:166` |
 | `e179870922a3` | certain | What the session did, derived from its own transcript: whether it wrote files, used tools, and how many prompt | `modules/hall-ui/public/sessions.html:74` |
 | `868cf4bbe616` | certain | What the start-it markers mean | `modules/hall-ui/public/commands.html:35` |
@@ -1389,6 +1401,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `ecfd34bf5e6f` | certain | What’s stuck (optional) | `modules/hall-ui/public/blockers.js:308` |
 | `a6e102816e92` | certain | When to reach for it | `modules/hall-ui/public/commands-lib.js:100` |
 | `a6e102816e92` | certain | When to reach for it | `modules/hall-ui/public/settings-specialities.js:130` |
+| `8320f40edc52` | certain | When you submit, an AI splits this into separate ideas, filed under your name. The doc stays here as this page | `modules/hall-ui/public/page-notes.js:106` |
 | `5d73558dae0e` | certain | Where do you begin? | `modules/hall-ui/public/goal-map.html:110` |
 | `5d73558dae0e` | certain | Where do you begin? | `modules/hall-ui/public/goal-map.html:112` |
 | `ec1a438eee3f` | certain | Where each comes from and where each goes. {{Currency}} = credits; karma is a separate peer-trust signal, not  | `modules/hall-ui/public/diagrams.html:68` |
@@ -1416,7 +1429,9 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `0e6b8e8f26cc` | certain | Works completed | `modules/hall-ui/public/profile.html:148` |
 | `52e5fe3c6075` | certain | Write a Full Idea | `modules/hall-ui/public/ideas.html:145` |
 | `ad1e1ab1ecac` | certain | Write a reply… | `modules/hall-ui/public/collab.js:175` |
+| `a79ca1e2463b` | certain | Write another | `modules/hall-ui/public/page-notes.js:143` |
 | `47f61e576454` | certain | Write the wording you want instead. | `modules/hall-ui/public/copy-desk.js:436` |
+| `a9e68066f26c` | certain | Write what you see on this page and what it should be. Long is fine: each separate point becomes its own idea. | `modules/hall-ui/public/page-notes.js:95` |
 | `b6b0fcb2bcee` | certain | You already have a pending request or invitation for this goal. | `modules/hall-ui/public/goals-render.js:1398` |
 | `52e93bbc07a6` | certain | You are already a member of this goal. | `modules/hall-ui/public/goals-render.js:1399` |
 | `46b1265ef172` | certain | You are not a member of this goal. | `modules/hall-ui/public/goals-render.js:1355` |
@@ -1437,6 +1452,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `f96bc227dba0` | certain | Your choice | `modules/hall-ui/public/settings.html:348` |
 | `44a68d05519e` | certain | Your choices for {…} | `modules/hall-ui/public/settings-specialities.js:152` |
 | `909b0b7c6ffa` | certain | Your display name | `modules/hall-ui/public/settings.html:87` |
+| `75d3d7bb3c60` | certain | Your feedback | `modules/hall-ui/public/page-notes.js:94` |
 | `dc9cfd1519a4` | certain | Your file was not saved. | `modules/hall-ui/public/tweak-editor.html:122` |
 | `466457c34316` | certain | Your handle, bio and links, whether your profile page is public, whether recruiters can find you, and whether  | `modules/hall-ui/public/settings.html:104` |
 | `a47f15b6a33c` | certain | Your image-generation key settings could not be loaded. Reload the page to try again. | `modules/hall-ui/public/settings.js:1038` |
@@ -1842,6 +1858,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `de8fa5223aee` | certain | ‹ Prev | `modules/hall-ui/public/hall-kit.js:74` |
 | `d4b84b7fbdeb` | certain | ← All goals | `modules/hall-ui/public/goals.html:75` |
 | `9159687c73ff` | certain | ← All modules | `modules/hall-ui/public/modules.html:85` |
+| `d063a7b9c83e` | certain | ← Back | `modules/hall-ui/public/page-notes.js:260` |
 | `7926e30955d2` | certain | ← Back to goal | `modules/hall-ui/public/goals.html:194` |
 | `7926e30955d2` | certain | ← Back to goal | `modules/hall-ui/public/goals.html:205` |
 | `7926e30955d2` | certain | ← Back to goal | `modules/hall-ui/public/goals.html:217` |

package/docs/copy-registry.json

@@ -3,17 +3,17 @@
   "generator": "scripts/gds/copy-inventory.js",
   "goal": 1000074,
   "counts": {
-    "strings": 2424,
-    "unique_ids": 2107,
-    "certain": 2424,
+    "strings": 2441,
+    "unique_ids": 2123,
+    "certain": 2441,
     "heuristic": 0,
-    "duplicate_ids": 220
+    "duplicate_ids": 221
   },
   "surfaces": {
     "builders-hall": {
       "at": "modules/hall-ui/public",
-      "files": 131,
-      "strings": 1775
+      "files": 132,
+      "strings": 1792
     },
     "status-dashboard": {
       "at": "modules/status-ui/public",
@@ -1405,6 +1405,16 @@
         "modules/hall-ui/public/genesis-home.js:206"
       ]
     },
+    {
+      "id": "94f3d9f46098",
+      "surface": "builders-hall",
+      "text": "Opening your doc…",
+      "occurrences": 2,
+      "at": [
+        "modules/hall-ui/public/page-notes.js:89",
+        "modules/hall-ui/public/page-notes.js:273"
+      ]
+    },
     {
       "id": "5b08da0632c7",
       "surface": "builders-hall",
@@ -2922,6 +2932,15 @@
       "origin": "js-markup",
       "confidence": "certain"
     },
+    {
+      "id": "a70b72ec4dcc",
+      "surface": "builders-hall",
+      "text": "Add images",
+      "file": "modules/hall-ui/public/page-notes.js",
+      "line": 97,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
     {
       "id": "da8659b0099b",
       "surface": "builders-hall",
@@ -3242,7 +3261,7 @@
       "surface": "builders-hall",
       "text": "Artists start on Artistry.",
       "file": "modules/hall-ui/public/craft-mode.js",
-      "line": 292,
+      "line": 348,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -3269,7 +3288,7 @@
       "surface": "builders-hall",
       "text": "Ask me again next session",
       "file": "modules/hall-ui/public/craft-mode.js",
-      "line": 290,
+      "line": 346,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -3453,6 +3472,15 @@
       "origin": "js-markup",
       "confidence": "certain"
     },
+    {
+      "id": "02d9d01d5c8b",
+      "surface": "builders-hall",
+      "text": "Being split into ideas…",
+      "file": "modules/hall-ui/public/page-notes.js",
+      "line": 137,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
     {
       "id": "5a2b73968b36",
       "surface": "builders-hall",
@@ -3611,7 +3639,7 @@
       "surface": "builders-hall",
       "text": "Builders hall · this session",
       "file": "modules/hall-ui/public/craft-mode.js",
-      "line": 285,
+      "line": 341,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -4025,7 +4053,7 @@
       "surface": "builders-hall",
       "text": "Choose your mode",
       "file": "modules/hall-ui/public/craft-mode.js",
-      "line": 203,
+      "line": 259,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -4187,7 +4215,7 @@
       "surface": "builders-hall",
       "text": "Close without choosing",
       "file": "modules/hall-ui/public/craft-mode.js",
-      "line": 283,
+      "line": 339,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -7535,7 +7563,7 @@
       "surface": "builders-hall",
       "text": "Legacy mode · the hall as it was",
       "file": "modules/hall-ui/public/craft-mode.js",
-      "line": 293,
+      "line": 349,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -8718,6 +8746,15 @@
       "origin": "html-text",
       "confidence": "certain"
     },
+    {
+      "id": "36c97d6094bf",
+      "surface": "builders-hall",
+      "text": "None yet. Yours will be the first.",
+      "file": "modules/hall-ui/public/page-notes.js",
+      "line": 120,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
     {
       "id": "fdfceec7ff97",
       "surface": "builders-hall",
@@ -9357,6 +9394,15 @@
       "origin": "js-markup",
       "confidence": "certain"
     },
+    {
+      "id": "35d46f963cd1",
+      "surface": "builders-hall",
+      "text": "Opening the doc…",
+      "file": "modules/hall-ui/public/page-notes.js",
+      "line": 256,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
     {
       "id": "7a8dfadb7468",
       "surface": "builders-hall",
@@ -9375,6 +9421,24 @@
       "origin": "html-text",
       "confidence": "certain"
     },
+    {
+      "id": "94f3d9f46098",
+      "surface": "builders-hall",
+      "text": "Opening your doc…",
+      "file": "modules/hall-ui/public/page-notes.js",
+      "line": 89,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
+    {
+      "id": "94f3d9f46098",
+      "surface": "builders-hall",
+      "text": "Opening your doc…",
+      "file": "modules/hall-ui/public/page-notes.js",
+      "line": 273,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
     {
       "id": "a2bd76ae030d",
       "surface": "builders-hall",
@@ -9551,7 +9615,7 @@
       "surface": "builders-hall",
       "text": "Pick one. You can switch any time from the top bar.",
       "file": "modules/hall-ui/public/craft-mode.js",
-      "line": 287,
+      "line": 343,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -11526,6 +11590,15 @@
       "origin": "js-notice",
       "confidence": "certain"
     },
+    {
+      "id": "aee9d47c6b99",
+      "surface": "builders-hall",
+      "text": "Splitting your feedback into ideas…",
+      "file": "modules/hall-ui/public/page-notes.js",
+      "line": 222,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
     {
       "id": "f2a4d855d82d",
       "surface": "builders-hall",
@@ -11607,6 +11680,15 @@
       "origin": "js-markup",
       "confidence": "certain"
     },
+    {
+      "id": "92f87ca38190",
+      "surface": "builders-hall",
+      "text": "Still splitting. It will appear in this page's docs when it is done.",
+      "file": "modules/hall-ui/public/page-notes.js",
+      "line": 232,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
     {
       "id": "490a3cbb8c1c",
       "surface": "builders-hall",
@@ -12183,6 +12265,15 @@
       "origin": "js-markup",
       "confidence": "certain"
     },
+    {
+      "id": "51633ea53205",
+      "surface": "builders-hall",
+      "text": "The doc is now this page's reference. Every idea links back to it.",
+      "file": "modules/hall-ui/public/page-notes.js",
+      "line": 142,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
     {
       "id": "239d641c20fa",
       "surface": "builders-hall",
@@ -13200,6 +13291,15 @@
       "origin": "js-markup",
       "confidence": "certain"
     },
+    {
+      "id": "d4b3b5556986",
+      "surface": "builders-hall",
+      "text": "This page's reference docs",
+      "file": "modules/hall-ui/public/page-notes.js",
+      "line": 113,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
     {
       "id": "5bdcbec770dd",
       "surface": "builders-hall",
@@ -13371,6 +13471,15 @@
       "origin": "js-markup",
       "confidence": "certain"
     },
+    {
+      "id": "1edc39bc7120",
+      "surface": "builders-hall",
+      "text": "Turn into ideas",
+      "file": "modules/hall-ui/public/page-notes.js",
+      "line": 107,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
     {
       "id": "26ec8100bc6f",
       "surface": "builders-hall",
@@ -13817,7 +13926,7 @@
       "surface": "builders-hall",
       "text": "What are you doing now?",
       "file": "modules/hall-ui/public/craft-mode.js",
-      "line": 286,
+      "line": 342,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -13974,6 +14083,15 @@
       "origin": "html-text",
       "confidence": "certain"
     },
+    {
+      "id": "7c765a4209d1",
+      "surface": "builders-hall",
+      "text": "What should this page be?",
+      "file": "modules/hall-ui/public/page-notes.js",
+      "line": 85,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
     {
       "id": "2dd116d2d817",
       "surface": "builders-hall",
@@ -14100,6 +14218,15 @@
       "origin": "js-markup",
       "confidence": "certain"
     },
+    {
+      "id": "8320f40edc52",
+      "surface": "builders-hall",
+      "text": "When you submit, an AI splits this into separate ideas, filed under your name. The doc stays here as this page's reference.",
+      "file": "modules/hall-ui/public/page-notes.js",
+      "line": 106,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
     {
       "id": "5d73558dae0e",
       "surface": "builders-hall",
@@ -14343,6 +14470,15 @@
       "origin": "js-markup",
       "confidence": "certain"
     },
+    {
+      "id": "a79ca1e2463b",
+      "surface": "builders-hall",
+      "text": "Write another",
+      "file": "modules/hall-ui/public/page-notes.js",
+      "line": 143,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
     {
       "id": "47f61e576454",
       "surface": "builders-hall",
@@ -14352,6 +14488,15 @@
       "origin": "js-text-assign",
       "confidence": "certain"
     },
+    {
+      "id": "a9e68066f26c",
+      "surface": "builders-hall",
+      "text": "Write what you see on this page and what it should be. Long is fine: each separate point becomes its own idea.",
+      "file": "modules/hall-ui/public/page-notes.js",
+      "line": 95,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
     {
       "id": "b6b0fcb2bcee",
       "surface": "builders-hall",
@@ -14532,6 +14677,15 @@
       "origin": "html-attr:placeholder",
       "confidence": "certain"
     },
+    {
+      "id": "75d3d7bb3c60",
+      "surface": "builders-hall",
+      "text": "Your feedback",
+      "file": "modules/hall-ui/public/page-notes.js",
+      "line": 94,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
     {
       "id": "dc9cfd1519a4",
       "surface": "builders-hall",
@@ -18177,6 +18331,15 @@
       "origin": "html-text",
       "confidence": "certain"
     },
+    {
+      "id": "d063a7b9c83e",
+      "surface": "builders-hall",
+      "text": "← Back",
+      "file": "modules/hall-ui/public/page-notes.js",
+      "line": 260,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
     {
       "id": "7926e30955d2",
       "surface": "builders-hall",

package/docs/file-map.md

@@ -114,6 +114,7 @@
 │   ├── hall-ui/                ← CORE-DOMAIN WEB-SURFACE carve (BV1.R85, default-on): the authenticated builders' hall at builders.<apex>, moved from public-builders/ (~13k LOC, the largest). NO routes/db/port — declares contributes.webSurfaces:[{host:"builders.",dir:"public"}] for discovery, but UNLIKE status-ui keeps its DEDICATED serving block in serve-internal (the /builders shim + canonical redirects + citizen/Archon page gates + asset-stamping + hall-widget injection), partitioned out of the generic web-surface loop and served from BUILDERS_DIR. CLAUDE.md, module.json, records/ (one file per page family — what each family's redesign settled; CLAUDE.md points at them, and a new record is a new file there so concurrent hall tasks stop colliding on one insertion point, task 1003499), public/{index.html,builders.js,style.css,work,watch,gate,settings,ranks,sessions,primer,diagrams,atlas,...}.{html,js},cursors/,chime.wav. Four ARCHETYPE sheets sit beside the per-page ones: `record.css` (the task + idea records, task 1003305), `room.css` (the READING ROOMS — the primer + the diagrams index, task 1003306: the reading measure and rhythm, the table of contents, the progress hairline and the framed figure diagram-viewer.js upgrades on both pages), `oversight.css` (the OVERSIGHT family — government, watch, gate, task 1003469 (harbor was its fourth until task 1003890 removed the dev box): the row, the figure band inside a panel, the group head, the inline form, the grant toggle and the shared confirm modal; named oversight because the vocabulary wall bans "governance" on the government surface) and `panel.css` (the PANEL family — settings, profile, task 1003308 (pair was its third until task 1003890 removed the dev box): the row, the switch, the field with its label above, the chip control, the four voices and the sign-in gate; the hall's my-projects page was DELETED in the same task — "my projects" is the hub's user-level page, and the hall keeps no link or redirect; the family's fourth page `not-ready.html` was deleted by task 1003450, along with the emptied `requireNonXenosPage` gate that was the only thing redirecting to it). A page sheet then holds only what one page has and the others do not — `primer.css` the acknowledge gate, `diagrams.css` the legend strip, `gate.css` the hold reasons and file chips, `watch.css` the severities, the report reader and the grade trend, `settings.css` the rail layout, the group head, the token ladder and the voices grid, `profile.css` the identity band and the shelf, `roster.css` the Builders roster's identity cell (was `people.css`, shared with the cross-project `/people` directory until task 1003444 deleted that page — `/people` and its legacy door `/scouting` now 302 to `/roster`), `thinking.css` THE SKY's one sheet (task 1004231 / sky part 3 — `thinking.html` at `/thinking` is the prototype the owner adopted as the design of record, `docs/design/mocks/sky/`, built over `GET /sky` + `GET /sky/mine`; its script is the seven `sky-*.js` files on one shared `window.OTBSky`; it replaced THE ROOM of task 1004098, which survives as the list drawer, and the old `/sky` page, whose URL 301s here; `idea-objects.js` beside it is the shared five-object vocabulary).
 │   ├── lifecycle/               ← CORE-DOMAIN carve (BV1.R86, default-on): the build state machine — tasks · claims · versions · done-when · goals · dependencies · claim→ship→grade→credit · github-push + merge-lock + conflict-resolve + publish-reconciler. The LAST, most-coupled carve; registers the `lifecycle` kernel port (createTask, classifyTaskKind, tallyPeerVotes, work-tracking reads). CLAUDE.md, module.json, routes/{tasks,claims,versions,done-when,goals,dependencies,gate-approvals,analytics}.js, lifecycle.js, github-push.js, merge-lock.js, conflict-resolve.js, publish-reconciler.js, task-visuals.js + task-visual-db.js + routes/visuals.js (the optional ship-time visual, task 1003109 — the route file is NOT named task-*.js on purpose; see the module CLAUDE.md).
 │   ├── copy-desk/               ← CORE-DOMAIN module (task 1003113 / R02 of goal 1000074, default-on): the COPY half of the design contract — ADR 0081 gave design TOKENS a repo-owned source of truth, text had none. Owns the FLAG (anyone in any role marks a string or a whole surface as needing an artist's attention, with a reason required in BOTH the route and a CHECK constraint) and the QUEUE an artist reads it from. READS R01's committed registry (docs/copy-registry.json, generated by scripts/gds/copy-inventory.js) and never writes it. NO LIVE CMS is the hard non-goal: no column here could hold replacement text, and copy_no_cms.mjs pins that. Key is `copy-desk`, not `copy` — the branding contract already owns a `copy` block, so the bare word reds the "core carries no module code" fitness check. R03 (task 1003114, ADR 0233) added the PROPOSAL: an artist writes the replacement wording and it becomes a Bongos task carrying a fenced copy-proposal patch — no row, NO second migration (a proposals table is the forbidden column with extra steps), and scripts/gds/copy-apply.js lands it as a real diff under a claim. BV2.TW05 (task 1004316, ADR 0341 D8) added Tweak Mode's three derived READS — GET /copy-desk/pages, /copy-desk/pages/:pageId, /copy-desk/tally: page status and count, changelog, drift, "N of M tweaked" per surface, and the artist's tally — over the page-tweak tasks (lifecycle port), docs/page-inventory.json and docs/page-readings.json (both now in the publish manifest), with no status table. BV2.TW06 (task 1004317, ADR 0341 D2, D5, D6) added its first two page WRITES: POST /copy-desk/pages/:pageId/claim (an artist-craft builder opens or takes the page's tweak round as a web-claimed task, through the lifecycle port's webClaimPageTweak, under an advisory lock on the page) and POST /copy-desk/pages/:pageId/asks (anyone files a page ask, a copy_desk_flags row with scope 'page', added by copy_desk_002_page_asks.sql). CLAUDE.md, module.json, registry.js, flags.js, proposals.js, pages.js (the page-tweak block format), page-status.js (the pure derivation), page-data.js (the page artifacts' read side), routes/copy-desk.js, migrations/copy_desk_001_flags.sql, migrations/copy_desk_002_page_asks.sql, tests/{copy_flags,copy_queue,copy_no_cms,copy_proposals,copy_page_status}.mjs + tests/fixtures/page-tweak.cjs. Its hall surface lives with hall-ui (public/copy-desk.{html,js,css}), per the one-key-per-web-surface precedent. skills/tweak/SKILL.md is the /tweak skill (contributes.skills; moved out of .claude/skills/ in task 1004471, hidden from the model listing, typed as /tweak).
+│   ├── page-notes/              ← the artist's page feedback docs (task 1004496, default-on): the Artistry palette button's store. A doc about one hall page, with up to eight reference images (stored in the DB, images only), turned into ideas by an AI split on submit and kept as the page's reference (?note=N). Apart from copy-desk, which may hold no wording. module.json, CLAUDE.md, notes.js (pure), split.js, db.js, routes/, migrations/.
 │   ├── npm-release/             ← the deploy page for a project that publishes an npm package from GitHub (task 1002622, default-OFF — on only in the Bongos hall, which publishes @bongos/core). "Where the work is": every task finished in the last 14 days, placed in the stage it has actually reached (not merged · merged, no version yet · published, not running here · running here, not released · released · in no version), plus the version history — each version's tasks. The version↔task join reads the release-notes.json the package itself carries (scripts/gds/release-notes.js writes it at pack time), streamed out of the NEWEST version's npm tarball in-process (no child process, no sync call) when the running core's own copy stops short. module.json, work.js (the reading + the stage placement — the packument, tarball stream and tar reader it uses are the core's src/bongos/package-registry.js, reached through the doorway's readPackageRegistry since task 1004296), routes/work.js (GET /npm-release/work, gated core.pin.move like the page), public/work.{js,css} (the two sections /deploy lends it: #nr-work, #nr-versions). Task 1004301 added the same line on a task's own page: routes/task-where.js (GET /npm-release/task/:id, any signed-in builder — it shows nothing not already public) + public/task-widget.js, injected into task.html by the loader's uiSections seam (hallWidgetScripts file task-widget.js) to fill #task-contrib on otb:task-shown. Tests sit at the repo root — tests/npm_release_{work,page}.mjs — because a default-off module's own tests/ is skipped by the unit runner.
 │   ├── render-deploy/           ← the deploy page for a project whose app deploys through Render (task 1004270, default-OFF). The service's Render deploys, each tied to its commit and the Bongos tasks in it, what is live now, and deploy + roll back behind a two-step confirm the server also holds. The owner's Render key is never stored: it rides each request in a header. Uses the one Render client, scripts/gds/render-api.js, and its ownerId guard. `deploys.js` (shaping + ledger), `render.js` (key + client), `routes/` (app, history, act), `public/deploy.js` (the page, mounted in /deploy), `migrations/` (one two-id table)
 │   ├── ui-design/               ← CORE-DOMAIN module (task 1003324 / ADR 0197, default-on): the design capability every builder on every instance gets — ships METHOD, never a world. Absorbs ADR 0081's layer: adapters/{claude-design,figma}/index.js (moved from src/ui/adapters/), scripts/{design-sync,figma-design-sync,validate-design}.js (moved from scripts/gds/, which keeps thin shims), docs/design-contract.md (moved from docs/). Declaration-only: contributes.skills design (the /design playbook, new) + design-sync + figma-design-sync; no routes/port/migrations, so disabling it touches no served surface. CLAUDE.md separates the platform FLOORS (the Fifteen Rule, the dark twins, no page :root, the 24px floor, AA in both modes, the kill switch) from the instance's WORLD (its packs + DESIGN.md). kit/ (task 1003320) is the look-before-you-ship kit: lib.js (the floors, the states/probes contracts, the action + expectation vocabularies, the WCAG maths, the stub spawner), serve.js (any surface through the doorway's real transforms + fixtures/), render.js (states × 1440/390/320 × dark/light, audited), probe.js (PASS/FAIL contracts), check-mock.js (platform rules + the instance's DESIGN.md taste bans, then the detector), tells.js (task 1003329 / ADR 0223: the anti-pattern detector as two tiers — floors FAIL, craft tells WARN, kit-ignore waivers per file; the rendered twins live in lib.js factsInPage), contrast.js + png.js; a page's <page>.states.json / <page>.probes.json sit BESIDE the surface (modules/public-landing/public/, modules/hall-ui/public/). Recipe: docs/recipes/ui-look-before-you-ship.md. The thirteen design-style skills that lived in skills/ are the opt-in design-styles module since task 1004470 (below); design-taste-frontend-v1 was deleted. styles/ (task 1003323 / ADR 0219) is the style library: <name>/pack.json (the theme.ui overlay, exactly the fifteen) + DESIGN.md (the look's derived recipes, thirteen in lockstep with the pack) + mock.html (the specimen); chrome-world (pinned to the neutral pack), expedition, grove, blueprint (the first cool look, authored through /style at task 1003475); STYLE=<name> on the kit lays a look over the instance's pack through GDS_BRANDING_FILE; tests/ui_design_styles.mjs runs the world/cosmos/hall token suites once per alternate (UI_DESIGN_PACK). config/design-tokens.* + design-sources.json STAY in config/ as the host boundary; public-landing keeps its own key (first customer, not owner).