@bongos/core 1.19.492 → 1.19.493

package/docs/api-reference.md

@@ -2,7 +2,7 @@
 
 # Bongos API reference
 
-> **Generated from the live route files** — the route file is authoritative. 344 endpoints across 56 route files.
+> **Generated from the live route files** — the route file is authoritative. 345 endpoints across 56 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/<redacted>.md)): `public` < `any-builder` < `metic+archon` < `archon`.
@@ -166,12 +166,13 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/<redacted>
 | GET | `/api/bongos/connections/degree/:handle` | `any-builder` | — | the degree label between the CALLER and one handle, plus the mutuals it was computed from (own-scope read, D4 §4). |
 | GET | `/api/bongos/connections/requests` | `any-builder` | — | MY pending requests, both directions (own data). |
 
-## `copy-desk` (4)
+## `copy-desk` (5)
 
 | Method | Path | Rank | Body | Description |
 |---|---|---|---|---|
 | POST | `/api/bongos/copy-desk/flags` | `any-builder` | `scope`, `surface`, `string_id`, `reason`, `kind` | ------------------------------------------------------------------------- POST /copy-desk/flags — file a flag. |
 | POST | `/api/bongos/copy-desk/flags/:id/close` | `any-builder` | `status`, `resolution_note`, `resolved_task_id` | ------------------------------------------------------------------------- POST /copy-desk/flags/:id/close — resolve or dismiss. |
+| POST | `/api/bongos/copy-desk/proposals` | `any-builder` | `string_id`, `proposed_text`, `why`, `file`, `line`, `flag_id` | ------------------------------------------------------------------------- POST /copy-desk/proposals — an artist proposes new wording, and… |
 | GET | `/api/bongos/copy-desk/queue` | `any-builder` | — | ------------------------------------------------------------------------- GET /copy-desk/queue — the artist's working list. |
 | GET | `/api/bongos/copy-desk/strings` | `any-builder` | — | ------------------------------------------------------------------------- GET /copy-desk/strings — search the inventory, to find somethin… |
 

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).
 
-**1600 strings** across 3 surfaces · 1391 distinct pieces of copy · 1600 certain, 0 heuristic · 150 shown in more than one place.
+**1612 strings** across 3 surfaces · 1403 distinct pieces of copy · 1612 certain, 0 heuristic · 150 shown in more than one place.
 
 ## Surfaces
 
 | surface | lives at | files | strings |
 |---|---|---|---|
-| `builders-hall` | `modules/hall-ui/public` | 73 | 1157 |
+| `builders-hall` | `modules/hall-ui/public` | 73 | 1169 |
 | `status-dashboard` | `modules/status-ui/public` | 4 | 98 |
 | `landing` | `modules/public-landing/public` | 5 | 345 |
 
@@ -78,7 +78,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `563d29ed86d8` | 2x | Bulk actions | modules/hall-ui/public/goals.html:172, modules/hall-ui/public/work.html:129 |
 | … | | _110 more in the JSON registry_ | |
 
-## `builders-hall` — 1157 strings
+## `builders-hall` — 1169 strings
 
 | id | conf | text | where |
 |---|---|---|---|
@@ -116,7 +116,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `3e5a62bc4887` | certain | A GitHub username is needed. | `modules/hall-ui/public/hall-render.js:361` |
 | `3e5a62bc4887` | certain | A GitHub username is needed. | `modules/hall-ui/public/watch.js:279` |
 | `2c23271d5d71` | certain | A device is asking to act as you | `modules/hall-ui/public/pair.html:32` |
-| `a22df5ebbd5e` | certain | A flag needs a reason an artist can act on. What is wrong with it, and what would better look like? | `modules/hall-ui/public/copy-desk.js:334` |
+| `a22df5ebbd5e` | certain | A flag needs a reason an artist can act on. What is wrong with it, and what would better look like? | `modules/hall-ui/public/copy-desk.js:372` |
 | `634738746b81` | certain | A fresh box has a | `modules/hall-ui/public/harbor.js:125` |
 | `df5eb70b5a05` | certain | A higher rank. Its details are hidden until you reach the rank directly below it. | `modules/hall-ui/public/ranks.js:125` |
 | `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` |
@@ -138,7 +138,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `62eded408097` | certain | Add {…} | `modules/hall-ui/public/profile-nudge.js:68` |
 | `8b736e365191` | certain | All builders | `modules/hall-ui/public/hall-render.js:1132` |
 | `b5e03617b319` | certain | All goals | `modules/hall-ui/public/goals.html:53` |
-| `bea7817e57a4` | certain | All surfaces | `modules/hall-ui/public/copy-desk.js:263` |
+| `bea7817e57a4` | certain | All surfaces | `modules/hall-ui/public/copy-desk.js:301` |
 | `627c683a5e5d` | certain | All time | `modules/hall-ui/public/hall-widgets.js:130` |
 | `b38c01691857` | certain | All your work → | `modules/hall-ui/public/hall-widgets.js:110` |
 | `e99cc5d37404` | certain | Already a member? | `modules/hall-ui/public/hall-render.js:330` |
@@ -227,8 +227,8 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `512ab32e3bf2` | certain | Close box | `modules/hall-ui/public/box-panel.js:226` |
 | `70f6a704d504` | certain | Close it | `modules/hall-ui/public/copy-desk.html:140` |
 | `d12a2fb5730d` | certain | Close this flag | `modules/hall-ui/public/copy-desk.html:116` |
-| `3d148e19e03a` | certain | Closed. | `modules/hall-ui/public/copy-desk.js:393` |
-| `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:378` |
+| `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` |
 | `f8a914076098` | certain | Closing the terminal tab keeps your session running — reopen to resume right where you left off. To shut the b | `modules/hall-ui/public/box-panel.js:226` |
 | `cfe0f4c4fcc2` | certain | Closing your box… (a few seconds) | `modules/hall-ui/public/box-panel.js:265` |
 | `cfe0f4c4fcc2` | certain | Closing your box… (a few seconds) | `modules/hall-ui/public/box-panel.js:370` |
@@ -395,6 +395,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `647513e4838a` | certain | Everything this builder has shipped. Seen one craft 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` |
 | `d629e152f074` | certain | Expires {…} · refreshes on use. | `modules/hall-ui/public/settings.js:992` |
+| `0c4632f983db` | certain | File the change | `modules/hall-ui/public/copy-desk.html:173` |
 | `536a7e99640a` | certain | File the flag | `modules/hall-ui/public/copy-desk.html:108` |
 | `077cf99f49f6` | certain | File this idea | `modules/hall-ui/public/ideas.html:90` |
 | `1def0e7c716e` | certain | Find something to flag | `modules/hall-ui/public/copy-desk.html:64` |
@@ -407,8 +408,8 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `78107a76a755` | certain | Five diagrams that show, at a glance, how work flows through {{worldName}}'s development system. | `modules/hall-ui/public/diagrams.html:33` |
 | `18ab1be9d3ad` | certain | Five questions, and a score that counts how much of each you actually answered. | `modules/hall-ui/public/ideas.js:448` |
 | `b9267033b1f1` | certain | Flag this copy | `modules/hall-ui/public/copy-desk.html:83` |
-| `82149b1deacd` | certain | Flag this… | `modules/hall-ui/public/copy-desk.js:146` |
-| `448d00771dc8` | certain | Flagged. It is in the queue. | `modules/hall-ui/public/copy-desk.js:353` |
+| `82149b1deacd` | certain | Flag this… | `modules/hall-ui/public/copy-desk.js:164` |
+| `448d00771dc8` | certain | Flagged. It is in the queue. | `modules/hall-ui/public/copy-desk.js:391` |
 | `6149e9ca69f7` | certain | Fleet summary | `modules/hall-ui/public/harbor.html:44` |
 | `617f13fa3fdb` | certain | Flip the switch. | `modules/hall-ui/public/hall-render.js:744` |
 | `42cee5cb3584` | certain | Fold this idea into # | `modules/hall-ui/public/task-detail.js:457` |
@@ -494,6 +495,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `2bfc5a50ce88` | certain | Jump to a page or record | `modules/hall-ui/public/shell.js:344` |
 | `eba610d25523` | certain | Jump to… | `modules/hall-ui/public/shell.js:346` |
 | `bc779353aa0c` | certain | Karma — peer recognition and approvals, a separate counter from {…}. | `modules/hall-ui/public/profile.js:65` |
+| `de0e1590667f` | certain | Keep all {…} {…} — they are the values the code drops in, and the change cannot land without them. | `modules/hall-ui/public/copy-desk.js:442` |
 | `32d25ef2182d` | certain | Keep box | `modules/hall-ui/public/box-panel.js:164` |
 | `fbe40b5818a3` | certain | Key removed. | `modules/hall-ui/public/settings.js:1193` |
 | `93c17262bacf` | certain | Key storage is being set up by an Archon — check back shortly. {…} | `modules/hall-ui/public/settings.js:1072` |
@@ -598,6 +600,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `2c19f41704b9` | certain | Not yet available — {{worldName}} | `modules/hall-ui/public/not-ready.html:6` |
 | `571b9b22dbda` | certain | Not yet ready — blocked by dependencies or awaiting promotion. These become claimable when their blockers ship | `modules/hall-ui/public/work.html:98` |
 | `0c59d118db9b` | certain | Note (optional) | `modules/hall-ui/public/task-detail.js:460` |
+| `cd652d04d616` | certain | Nothing changes yet. This files a task carrying your wording; whoever claims it lands the diff, and it ships g | `modules/hall-ui/public/copy-desk.html:168` |
 | `fec5d78497e8` | certain | Nothing in the backlog right now. | `modules/hall-ui/public/work.js:1055` |
 | `2c6e0dfbd781` | certain | Nothing is waiting on you. Requests reach you by your craft — set yours in | `modules/hall-ui/public/collab.html:44` |
 | `2ec0fbb20a42` | certain | Nothing is waiting. A spark appears here when its author offers a quick idea up for development. | `modules/hall-ui/public/ideas.js:365` |
@@ -669,6 +672,8 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `dd4bc23c7759` | certain | Prompt for #{…} copied to your clipboard. | `modules/hall-ui/public/work.js:550` |
 | `cd7dc83871b6` | certain | Prompt for #{…} copied. | `modules/hall-ui/public/goals-page.js:373` |
 | `cd7dc83871b6` | certain | Prompt for #{…} copied. | `modules/hall-ui/public/work.js:561` |
+| `fe7f3488fda8` | certain | Propose new wording | `modules/hall-ui/public/copy-desk.html:152` |
+| `abee9a18325d` | certain | Propose wording… | `modules/hall-ui/public/copy-desk.js:179` |
 | `3f85bdc47099` | certain | Protected module scope — join by request; an Archon admits members | `modules/hall-ui/public/goals-render.js:792` |
 | `e5c292c8b361` | certain | Provides (seams) | `modules/hall-ui/public/atlas.js:288` |
 | `b9c6def6b120` | certain | Rank set to {…}. | `modules/hall-ui/public/watch.js:625` |
@@ -739,8 +744,9 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `11486793742e` | certain | Saves the moment you toggle; applies from your next session. | `modules/hall-ui/public/settings.html:284` |
 | `e8e4e49fe8f4` | certain | Saves when you press Save; shows everywhere at once. | `modules/hall-ui/public/settings.html:88` |
 | `42cbc20a6ec8` | certain | Saves when you press Save; your next | `modules/hall-ui/public/settings.html:136` |
+| `fc9d783ed0f5` | certain | Say why it is better. Whoever reviews this decides it from your reason, without asking you. | `modules/hall-ui/public/copy-desk.js:446` |
 | `46711f7bc3df` | certain | Search every string the product shows a person, by what it says or the file it lives in. | `modules/hall-ui/public/copy-desk.html:65` |
-| `5d2ba8e72fa1` | certain | Search failed. | `modules/hall-ui/public/copy-desk.js:305` |
+| `5d2ba8e72fa1` | certain | Search failed. | `modules/hall-ui/public/copy-desk.js:343` |
 | `373a7639bcb9` | certain | Sections in this primer | `modules/hall-ui/public/primer.html:52` |
 | `00ca4e3c7c7d` | certain | Sections in this reference | `modules/hall-ui/public/drachmae.html:49` |
 | `ab8af800f2bb` | certain | Security reports | `modules/hall-ui/public/watch.html:47` |
@@ -825,6 +831,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `44579eef0c8d` | certain | Tasks — {{worldName}} | `modules/hall-ui/public/work.html:6` |
 | `2f4f047dc1b4` | certain | Text size | `modules/hall-ui/public/shell.js:349` |
 | `545c59c1deb7` | certain | That is the session you are using right now. Ending it signs you out of this page. | `modules/hall-ui/public/settings-sessions.js:74` |
+| `282c3fa2d456` | certain | That is the wording it already has. Change something, or file a flag instead if you only want to mark it. | `modules/hall-ui/public/copy-desk.js:438` |
 | `c0e28f30524d` | certain | That project's own standing, as reported by that project. | `modules/hall-ui/public/profile.js:285` |
 | `e99d4a811e92` | certain | That request is no longer available. | `modules/hall-ui/public/profile-connections.js:270` |
 | `50198c465225` | certain | The 16-value rank enum in three bands, which ranks are live, and the permissions each rank holds. | `modules/hall-ui/public/diagrams.html:59` |
@@ -871,7 +878,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `7d016f4a65bf` | certain | The system is mid-build. These diagrams deliberately separate what stands today from what is yet planned, so t | `modules/hall-ui/public/diagrams.html:40` |
 | `198ba9353bf6` | certain | The task feed did not answer. Nothing on the record has changed, only the read failed. Try again in a moment,  | `modules/hall-ui/public/task.js:632` |
 | `34555793f33e` | certain | The task list could not be loaded right now. | `modules/hall-ui/public/work.js:1215` |
-| `a42a37c43bfb` | certain | The words this project shows people — what has been flagged, and what nobody has looked at. | `modules/hall-ui/public/copy-desk.js:290` |
+| `a42a37c43bfb` | certain | The words this project shows people — what has been flagged, and what nobody has looked at. | `modules/hall-ui/public/copy-desk.js:328` |
 | `bcdbded93d4e` | certain | The work board failed to load. Reload to try again. | `modules/hall-ui/public/work.js:1401` |
 | `25794c439321` | certain | Then copy the project onto your machine and run the one-shot bootstrap (it checks your setup, installs depende | `modules/hall-ui/public/hall-render.js:811` |
 | `df316c3484de` | certain | Then drive it however you like: | `modules/hall-ui/public/hall-render.js:744` |
@@ -897,6 +904,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/watch.html:40` |
 | `87f1c2e07790` | certain | This page unlocks as you advance. | `modules/hall-ui/public/not-ready.html:26` |
 | `69e8beced2ff` | certain | This sends the idea back to its author. Say why, and which section. | `modules/hall-ui/public/government.js:962` |
+| `09256febc32d` | certain | This sentence has {…} {…} where a value is dropped in when it is shown. | `modules/hall-ui/public/copy-desk.js:422` |
 | `c9e50a67988a` | certain | This task has shipped and its credits have landed. Neither Ship it nor Confirm is available. | `modules/hall-ui/public/task.js:568` |
 | `7217c4f1769d` | certain | This will {…} | `modules/hall-ui/public/harbor.js:125` |
 | `2ad5823d2cd7` | certain | Three dials, all settings rather than code: | `modules/hall-ui/public/government.html:55` |
@@ -933,6 +941,8 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `70dc106494cf` | certain | What is wrong with it, and what would better look like? | `modules/hall-ui/public/copy-desk.html:101` |
 | `ae44a375e814` | certain | What it unlocks | `modules/hall-ui/public/ranks.js:109` |
 | `00dc1f0f83e1` | certain | What kind of wrong? | `modules/hall-ui/public/copy-desk.html:87` |
+| `9a85f2c19b48` | certain | What should it say? | `modules/hall-ui/public/copy-desk.html:156` |
+| `2dd116d2d817` | certain | What the current wording gets wrong, and what yours does about it. | `modules/hall-ui/public/copy-desk.html:166` |
 | `5f2b989bbf6a` | certain | What this builder has done, seen one craft at a time. | `modules/hall-ui/public/profile.html:134` |
 | `32d675a2b022` | certain | What this rank is for (optional) | `modules/hall-ui/public/government.html:92` |
 | `3dade88f0584` | certain | What your box would cost: | `modules/hall-ui/public/box-panel.js:235` |
@@ -947,6 +957,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `fe85463560e0` | certain | Who builds on this project, ranked by work shipped. This project's own ledger — unlike the cross-project direc | `modules/hall-ui/public/roster.html:28` |
 | `7dbdb882e967` | certain | Who can find you. Your profile page can be public or private, and recruiters looking for builders are allowed  | `modules/hall-ui/public/settings.html:111` |
 | `045c629729b7` | certain | Who’s on this goal, and what they’ve contributed to it. | `modules/hall-ui/public/goals.html:198` |
+| `62ab2e60f629` | certain | Why is this better? | `modules/hall-ui/public/copy-desk.html:164` |
 | `fbd8a815b808` | certain | Why — the reason the author will act on | `modules/hall-ui/public/government.js:962` |
 | `a3ac116b499a` | certain | Why? | `modules/hall-ui/public/copy-desk.html:99` |
 | `0dcb485477b6` | certain | Windows (ARM) | `modules/hall-ui/public/hall-render.js:744` |
@@ -957,6 +968,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `0e6b8e8f26cc` | certain | Works completed | `modules/hall-ui/public/profile.html:140` |
 | `52e5fe3c6075` | certain | Write a Full Idea | `modules/hall-ui/public/ideas.html:52` |
 | `7664f4373d1f` | certain | Write one | `modules/hall-ui/public/idea.js:258` |
+| `47f61e576454` | certain | Write the wording you want instead. | `modules/hall-ui/public/copy-desk.js:436` |
 | `c368b56ecf40` | certain | Xenos builders start with a focused set of pages — ship your first | `modules/hall-ui/public/not-ready.html:31` |
 | `b6b0fcb2bcee` | certain | You already have a pending request or invitation for this goal. | `modules/hall-ui/public/goals-render.js:1059` |
 | `52e93bbc07a6` | certain | You are already a member of this goal. | `modules/hall-ui/public/goals-render.js:1060` |
@@ -1040,7 +1052,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `df941da50c7c` | certain | fell short | `modules/hall-ui/public/builders.js:568` |
 | `31735e119a04` | certain | first vote | `modules/hall-ui/public/government.js:584` |
 | `9563bd9f4971` | certain | first — your username is all we need. | `modules/hall-ui/public/hall-render.js:278` |
-| `2e111f3a4912` | certain | flagged by | `modules/hall-ui/public/copy-desk.js:130` |
+| `2e111f3a4912` | certain | flagged by | `modules/hall-ui/public/copy-desk.js:148` |
 | `1874087e6d87` | certain | for Mac or Windows, sign in with your | `modules/hall-ui/public/hall-render.js:744` |
 | `836646d95f03` | certain | for a link that runs this session in Claude's own web/app interface, the same UI you'd use on a computer. | `modules/hall-ui/public/hall-render.js:744` |
 | `50eb308666b2` | certain | for version-level progress and goals. | `modules/hall-ui/public/work.html:84` |
@@ -1110,7 +1122,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `f83f0a9d6b6a` | certain | recorded, on the Operations tab | `modules/hall-ui/public/watch.html:49` |
 | `26da1df6fd4a` | certain | reflects it. | `modules/hall-ui/public/settings.html:136` |
 | `594962dc9ec3` | certain | s into the view containers below (falling back to | `modules/hall-ui/public/index.html:52` |
-| `2a42549b34ae` | certain | said, when flagged: | `modules/hall-ui/public/copy-desk.js:120` |
+| `2a42549b34ae` | certain | said, when flagged: | `modules/hall-ui/public/copy-desk.js:124` |
 | `9bec9eb4829e` | certain | scope: {…} | `modules/hall-ui/public/goals-render.js:774` |
 | `a6f55d7aa6f7` | certain | shipped (live) | `modules/hall-ui/public/roadmap.js:273` |
 | `026ba1289d4d` | certain | shipped · | `modules/hall-ui/public/goals-render.js:696` |
@@ -1119,7 +1131,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `0215b2cdca8c` | certain | submit for review | `modules/hall-ui/public/modules.js:132` |
 | `da30b952a60b` | certain | system / unattributed | `modules/hall-ui/public/goals-page.js:249` |
 | `da30b952a60b` | certain | system / unattributed | `modules/hall-ui/public/work.js:498` |
-| `a6e803a31a4d` | certain | task #{…} | `modules/hall-ui/public/copy-desk.js:101` |
+| `a6e803a31a4d` | certain | task #{…} | `modules/hall-ui/public/copy-desk.js:105` |
 | `4d8ee7d68974` | certain | task {…} | `modules/hall-ui/public/gate.js:142` |
 | `4d8ee7d68974` | certain | task {…} | `modules/hall-ui/public/hall-render.js:599` |
 | `4d8ee7d68974` | certain | task {…} | `modules/hall-ui/public/idea.js:207` |

package/docs/copy-registry.json

@@ -3,9 +3,9 @@
   "generator": "scripts/gds/copy-inventory.js",
   "goal": 1000074,
   "counts": {
-    "strings": 1600,
-    "unique_ids": 1391,
-    "certain": 1600,
+    "strings": 1612,
+    "unique_ids": 1403,
+    "certain": 1612,
     "heuristic": 0,
     "duplicate_ids": 150
   },
@@ -13,7 +13,7 @@
     "builders-hall": {
       "at": "modules/hall-ui/public",
       "files": 73,
-      "strings": 1157
+      "strings": 1169
     },
     "status-dashboard": {
       "at": "modules/status-ui/public",
@@ -1910,7 +1910,7 @@
       "surface": "builders-hall",
       "text": "A flag needs a reason an artist can act on. What is wrong with it, and what would better look like?",
       "file": "modules/hall-ui/public/copy-desk.js",
-      "line": 334,
+      "line": 372,
       "origin": "js-text-assign",
       "confidence": "certain"
     },
@@ -2108,7 +2108,7 @@
       "surface": "builders-hall",
       "text": "All surfaces",
       "file": "modules/hall-ui/public/copy-desk.js",
-      "line": 263,
+      "line": 301,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -2909,7 +2909,7 @@
       "surface": "builders-hall",
       "text": "Closed.",
       "file": "modules/hall-ui/public/copy-desk.js",
-      "line": 393,
+      "line": 510,
       "origin": "js-notice",
       "confidence": "certain"
     },
@@ -2918,7 +2918,7 @@
       "surface": "builders-hall",
       "text": "Closing is a judgement too — say what you decided, so the next person does not re-litigate it.",
       "file": "modules/hall-ui/public/copy-desk.js",
-      "line": 378,
+      "line": 495,
       "origin": "js-text-assign",
       "confidence": "certain"
     },
@@ -4416,6 +4416,15 @@
       "origin": "js-markup",
       "confidence": "certain"
     },
+    {
+      "id": "0c4632f983db",
+      "surface": "builders-hall",
+      "text": "File the change",
+      "file": "modules/hall-ui/public/copy-desk.html",
+      "line": 173,
+      "origin": "html-text",
+      "confidence": "certain"
+    },
     {
       "id": "536a7e99640a",
       "surface": "builders-hall",
@@ -4529,7 +4538,7 @@
       "surface": "builders-hall",
       "text": "Flag this…",
       "file": "modules/hall-ui/public/copy-desk.js",
-      "line": 146,
+      "line": 164,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -4538,7 +4547,7 @@
       "surface": "builders-hall",
       "text": "Flagged. It is in the queue.",
       "file": "modules/hall-ui/public/copy-desk.js",
-      "line": 353,
+      "line": 391,
       "origin": "js-notice",
       "confidence": "certain"
     },
@@ -5307,6 +5316,15 @@
       "origin": "js-markup",
       "confidence": "certain"
     },
+    {
+      "id": "de0e1590667f",
+      "surface": "builders-hall",
+      "text": "Keep all {…} {…} — they are the values the code drops in, and the change cannot land without them.",
+      "file": "modules/hall-ui/public/copy-desk.js",
+      "line": 442,
+      "origin": "js-text-assign",
+      "confidence": "certain"
+    },
     {
       "id": "32d25ef2182d",
       "surface": "builders-hall",
@@ -6243,6 +6261,15 @@
       "origin": "js-markup",
       "confidence": "certain"
     },
+    {
+      "id": "cd652d04d616",
+      "surface": "builders-hall",
+      "text": "Nothing changes yet. This files a task carrying your wording; whoever claims it lands the diff, and it ships graded like every other change.",
+      "file": "modules/hall-ui/public/copy-desk.html",
+      "line": 168,
+      "origin": "html-text",
+      "confidence": "certain"
+    },
     {
       "id": "fec5d78497e8",
       "surface": "builders-hall",
@@ -6882,6 +6909,24 @@
       "origin": "js-notice",
       "confidence": "certain"
     },
+    {
+      "id": "fe7f3488fda8",
+      "surface": "builders-hall",
+      "text": "Propose new wording",
+      "file": "modules/hall-ui/public/copy-desk.html",
+      "line": 152,
+      "origin": "html-text",
+      "confidence": "certain"
+    },
+    {
+      "id": "abee9a18325d",
+      "surface": "builders-hall",
+      "text": "Propose wording…",
+      "file": "modules/hall-ui/public/copy-desk.js",
+      "line": 179,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
     {
       "id": "3f85bdc47099",
       "surface": "builders-hall",
@@ -7512,6 +7557,15 @@
       "origin": "html-text",
       "confidence": "certain"
     },
+    {
+      "id": "fc9d783ed0f5",
+      "surface": "builders-hall",
+      "text": "Say why it is better. Whoever reviews this decides it from your reason, without asking you.",
+      "file": "modules/hall-ui/public/copy-desk.js",
+      "line": 446,
+      "origin": "js-text-assign",
+      "confidence": "certain"
+    },
     {
       "id": "46711f7bc3df",
       "surface": "builders-hall",
@@ -7526,7 +7580,7 @@
       "surface": "builders-hall",
       "text": "Search failed.",
       "file": "modules/hall-ui/public/copy-desk.js",
-      "line": 305,
+      "line": 343,
       "origin": "js-text-assign",
       "confidence": "certain"
     },
@@ -8286,6 +8340,15 @@
       "origin": "js-notice",
       "confidence": "certain"
     },
+    {
+      "id": "282c3fa2d456",
+      "surface": "builders-hall",
+      "text": "That is the wording it already has. Change something, or file a flag instead if you only want to mark it.",
+      "file": "modules/hall-ui/public/copy-desk.js",
+      "line": 438,
+      "origin": "js-text-assign",
+      "confidence": "certain"
+    },
     {
       "id": "c0e28f30524d",
       "surface": "builders-hall",
@@ -8705,7 +8768,7 @@
       "surface": "builders-hall",
       "text": "The words this project shows people — what has been flagged, and what nobody has looked at.",
       "file": "modules/hall-ui/public/copy-desk.js",
-      "line": 290,
+      "line": 328,
       "origin": "js-text-assign",
       "confidence": "certain"
     },
@@ -8934,6 +8997,15 @@
       "origin": "js-markup",
       "confidence": "certain"
     },
+    {
+      "id": "09256febc32d",
+      "surface": "builders-hall",
+      "text": "This sentence has {…} {…} where a value is dropped in when it is shown.",
+      "file": "modules/hall-ui/public/copy-desk.js",
+      "line": 422,
+      "origin": "js-text-assign",
+      "confidence": "certain"
+    },
     {
       "id": "c9e50a67988a",
       "surface": "builders-hall",
@@ -9258,6 +9330,24 @@
       "origin": "html-text",
       "confidence": "certain"
     },
+    {
+      "id": "9a85f2c19b48",
+      "surface": "builders-hall",
+      "text": "What should it say?",
+      "file": "modules/hall-ui/public/copy-desk.html",
+      "line": 156,
+      "origin": "html-text",
+      "confidence": "certain"
+    },
+    {
+      "id": "2dd116d2d817",
+      "surface": "builders-hall",
+      "text": "What the current wording gets wrong, and what yours does about it.",
+      "file": "modules/hall-ui/public/copy-desk.html",
+      "line": 166,
+      "origin": "html-attr:placeholder",
+      "confidence": "certain"
+    },
     {
       "id": "5f2b989bbf6a",
       "surface": "builders-hall",
@@ -9384,6 +9474,15 @@
       "origin": "html-text",
       "confidence": "certain"
     },
+    {
+      "id": "62ab2e60f629",
+      "surface": "builders-hall",
+      "text": "Why is this better?",
+      "file": "modules/hall-ui/public/copy-desk.html",
+      "line": 164,
+      "origin": "html-text",
+      "confidence": "certain"
+    },
     {
       "id": "fbd8a815b808",
       "surface": "builders-hall",
@@ -9474,6 +9573,15 @@
       "origin": "js-markup",
       "confidence": "certain"
     },
+    {
+      "id": "47f61e576454",
+      "surface": "builders-hall",
+      "text": "Write the wording you want instead.",
+      "file": "modules/hall-ui/public/copy-desk.js",
+      "line": 436,
+      "origin": "js-text-assign",
+      "confidence": "certain"
+    },
     {
       "id": "c368b56ecf40",
       "surface": "builders-hall",
@@ -10226,7 +10334,7 @@
       "surface": "builders-hall",
       "text": "flagged by",
       "file": "modules/hall-ui/public/copy-desk.js",
-      "line": 130,
+      "line": 148,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -10856,7 +10964,7 @@
       "surface": "builders-hall",
       "text": "said, when flagged:",
       "file": "modules/hall-ui/public/copy-desk.js",
-      "line": 120,
+      "line": 124,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -10937,7 +11045,7 @@
       "surface": "builders-hall",
       "text": "task #{…}",
       "file": "modules/hall-ui/public/copy-desk.js",
-      "line": 101,
+      "line": 105,
       "origin": "js-markup",
       "confidence": "certain"
     },

package/docs/file-map.md

@@ -132,7 +132,7 @@
 │   ├── status-ui/              ← CORE-DOMAIN WEB-SURFACE carve (BV1.R84, default-on): the public status dashboard at status.<apex>, moved from public-status/. NO routes/db/port — declares contributes.webSurfaces:[{host:"status.",dir:"public"}], served by the loader web-surface seam (moduleWebSurfaces → serve-internal). CLAUDE.md, module.json, public/{index.html,status.js,style.css,cursors/,snapshots/}.
 │   ├── 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, public/{index.html,builders.js,style.css,work,watch,harbor,gate,pair,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, harbor, gate, task 1003469: 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, pair, not-ready, task 1003308: 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). 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, `pair.css` the device row, `people.css` the directory's identity cell (task 1003470 made the legacy door `/scouting` ship the same body and script as `/people`; task 1003440 then deleted the door — `scouting.html` and `scouting.states.json` are gone and the URL 301s to `/people`).
 │   ├── 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. CLAUDE.md, module.json, registry.js, flags.js, routes/copy-desk.js, migrations/copy_desk_001_flags.sql, tests/{copy_flags,copy_queue,copy_no_cms}.mjs. Its hall surface lives with hall-ui (public/copy-desk.{html,js,css}), per the one-key-per-web-surface precedent.
+│   ├── 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 GDS 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. CLAUDE.md, module.json, registry.js, flags.js, proposals.js, routes/copy-desk.js, migrations/copy_desk_001_flags.sql, tests/{copy_flags,copy_queue,copy_no_cms,copy_proposals}.mjs. Its hall surface lives with hall-ui (public/copy-desk.{html,js,css}), per the one-key-per-web-surface precedent.
 │   ├── 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. skills/ (task 1003321 / ADR 0198) is the vendoring policy: policy.json (licence allowlist, verdicts that may land, sidecar fields, preamble markers), PREAMBLE.md (the platform preamble every vendored SKILL.md opens with), README.md (the roster — both origins scanned dangerous on 2026-08-28, landed as rebuild specs; nothing vendored — and the landing recipe); a landable copy goes under skills/vendor/<name>/ with PROVENANCE.md + LICENSE and is materialised into an instance's .claude/skills/ by claude-materialize.js step 1b. skills/<name>/ (task 1003325 / ADR 0220) are the in-house rebuilds from the specs, first-party and counted: design-taste-frontend (the default taste skill), design-taste-frontend-v1 (the earlier generation, kept distinct), high-end-visual-design (the polish pass), redesign-existing-projects (the in-place upgrade); each opens with the same preamble and carries a "Rebuilt from" section instead of a sidecar. impeccable/ (task 1003326 / ADR 0221) is the design-craft method as ONE skill with sub-commands: SKILL.md (the router, the menu, the craft floor, the bounded finish) + reference/<sub-command>.md (eighteen playbooks, one loaded per request); no hooks, no bypass agent, no telemetry, no live server. minimalist-ui/, industrial-brutalist-ui/, gpt-taste/, stitch-design-taste/ (task 1003327 / ADR 0230) are the four looks, composition grammars with no colours of their own: the palette is the instance's pack and the texture is a named entry in styles/; a substrate is an archetype that still ships both modes, gpt-taste's selection is derived from the route rather than rolled, and stitch-design-taste writes a DESIGN.md-shaped contract document whose thirteen are transcribed from the pack. image-to-code/, imagegen-frontend-web/, imagegen-frontend-mobile/, brandkit/ (task 1003328 / ADR 0222) are the image family under the hero-only rule: plates and hero objects only, the pair (JPEG dark plate + WebP alpha cutout) with a <file>.json sidecar beside each, through the instance's art pipeline key; the grove specimen's styles/grove/assets/ is the worked example. style/ (task 1003475 / ADR 0231) is the module's first FIRST-PARTY skill (no upstream, so a `## First party` section instead of `## Rebuilt from`): the /style session in which an owner authors their own look in four bounded steps, rendering the nearest library entries before asking, drafting inside the contract, retuning by measurement, and handing over the one-step adoption without ever writing config/branding.json. 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).
 │   ├── character-anim/          ← consistent-character generative animation (ADR 0088) — graded painterly frame sets + manifest, the otb-character-review skill. CLAUDE.md, module.json.
 │   ├── provisioning/            ← stands up + operates a Cloud Bongos instance's own infra (server/DB/domain/DNS/TLS) via the API (ADR 0111); web-tier request+state only, no cloud tokens — a separate control-plane runner drains the intents. Distinct from the `hosting` module (ADR 0092), which brokers compute workloads. CLAUDE.md, module.json.
@@ -194,6 +194,7 @@
 │       ├── docs-entropy.js      ← ([#…] docs-entropy) markdown-corpus linter: broken internal links + cross-file duplicate-prose detector across every tracked `.md`; `--verbose` / `--file-ideas`
 │       ├── doc-comment-coverage.js ← ADR 0095 / task 1001654: the ADVISORY doc-comment nudge (fitness Check 28) — reports source files under src/·scripts/·modules/ that open with no module header. Never hard-fails: a doc-comment gate that blocks a ship buys filler prose, and making it blocking needs owner sign-off + its own ADR. CRLF-safe (unlike docs-entropy.js); an empty enumeration throws as a scan defect
 │       ├── copy-inventory.js  ← R01 of goal 1000074 (the artist's loop): the COPY REGISTRY — every user-facing string across the hall / status / landing surfaces, each row naming the render path that shows it (html-text · html-attr · js-markup · js-notice · js-text-assign) + a stable id that survives a move. Writes docs/copy-registry.json + docs/copy-inventory.md; `--check` fails on drift. Precision over recall: a JS literal with no render path is not listed
+│       ├── copy-apply.js     ← R03 of goal 1000074 (ADR 0233): lands a copy proposal as a REAL DIFF under a claim — the design half’s adapter.export() applied to text. Reads the fenced copy-proposal patch off a task (--task N; --dry-run, --patch-file), RE-DERIVES the string’s position by re-running copy-inventory’s own extractor over the working tree (the registry commits no offsets — they go stale, the id does not), re-injects the source’s own ${expr} into the proposal’s {…} holes, writes, regenerates the registry and verifies its own edit. Refuses BY NAME on target_gone / ambiguous_target / no_exact_span / placeholder_mismatch / path_outside_surface. The ONLY writer in the copy feature, and deliberately a command rather than a route
 │       ├── gen-diagrams.js      ← generates the 5 onboarding diagrams (`.mmd`/`.svg`/`.png` + `assertions.json`) from templates in this file — never hand-edit a `.mmd`/assertions.json; runs on deploy
 │       ├── gen-api-docs.js      ← ADR 0109: generates `docs/api/openapi.json` + `docs/api-reference.md` from the live route files via `route-rank-check.js` introspection, so the API reference cannot drift from what the server actually mounts
 │       ├── architect-audit.js   ← MAS Phase 5 (ADR 0024): the Architect's bounded first-principles `--scope`/`--paths` audit CLI → `docs/audits/`

package/docs/module-api-changelog.md

@@ -1421,5 +1421,7 @@ is load-bearing: the script throws rather than guess if it is missing, and
         landed since 1.19.490 with no explicit bump. run 33692191645. (task 1002620)
   1.19.492 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
         landed since 1.19.491 with no explicit bump. run 33693742388. (task 1002620)
+  1.19.493 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
+        landed since 1.19.492 with no explicit bump. run 33694576680. (task 1002620)
 ---------------------------------------------------------------------------
 ```

package/modules/copy-desk/module.json

@@ -1,11 +1,11 @@
 {
   "key": "copy-desk",
   "title": "Copy desk (the artist's loop over user-facing text)",
-  "description": "The COPY half of the design contract (goal 1000074, the artist's loop). Named for the editorial desk copy passes over before it is published — which is exactly the job, and which keeps the module key off the generic word 'copy' that the branding contract already owns (branding.copy.tagline/hallName/notFound). ADR 0081 made the repo the source of truth for design TOKENS and component surfaces; there was no equivalent for user-facing TEXT. This module owns that half: the FLAG — anyone, in any role, marks a string or a whole surface as needing an artist's attention, with a required reason — and the QUEUE an artist reads it from. The inventory a flag points at is the committed registry docs/copy-registry.json, generated by scripts/gds/copy-inventory.js (R01); this module reads it and never writes it. NO LIVE CMS is the goal's hard non-goal: nothing here can change a rendered string. A flag is a work request; the fix ships as a claimed, graded GDS task like every other change. default-on — every instance shows a person words, so every instance can flag them.",
+  "description": "The COPY half of the design contract (goal 1000074, the artist's loop). Named for the editorial desk copy passes over before it is published — which is exactly the job, and which keeps the module key off the generic word 'copy' that the branding contract already owns (branding.copy.tagline/hallName/notFound). ADR 0081 made the repo the source of truth for design TOKENS and component surfaces; there was no equivalent for user-facing TEXT. This module owns that half: the FLAG — anyone, in any role, marks a string or a whole surface as needing an artist's attention, with a required reason — and the QUEUE an artist reads it from. The inventory a flag points at is the committed registry docs/copy-registry.json, generated by scripts/gds/copy-inventory.js (R01); this module reads it and never writes it. R03 (task 1003114) added the PROPOSAL: an artist writes the replacement wording and it becomes a GDS task carrying a patch, which scripts/gds/copy-apply.js lands as a real diff under a claim — the design half's adapter.export() contract (ADR 0081) applied to text. NO LIVE CMS is the goal's hard non-goal: nothing here can change a rendered string. A flag is a work request; a proposal is a work request with a suggested fix; the fix ships as a claimed, graded GDS task like every other change. default-on — every instance shows a person words, so every instance can flag them.",
   "coreVersion": "^1.8.0",
   "default": true,
   "maintenance": { "status": "core-maintained" },
   "contributes": { "routes": ["copy-desk"], "migrations": true },
   "provides": [],
-  "consumes": []
+  "consumes": ["lifecycle"]
 }