@bongos/core 1.19.373 → 1.19.374

package/.bongos-core.json

@@ -2,22 +2,22 @@
   "artifact": "bongos-core",
   "manifest_schema": 1,
   "generator": "scripts/gds/package-core.js",
-  "core_version": "1.19.373",
-  "core_contract": "1.19.373",
-  "source_commit": "fbe2ff6cdfb5154f956f0a473085ad2f55a9e7e2",
+  "core_version": "1.19.374",
+  "core_contract": "1.19.374",
+  "source_commit": "ef487914ca1cc1439cbbe614d215ac0bcc4a7a11",
   "source_ref": "HEAD",
-  "built_at": "2026-08-25T22:26:30.155Z",
+  "built_at": "2026-08-25T22:31:01.224Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
     "docs_redacted": 334,
     "agent_docs_stubbed": 22,
-    "functional_verbatim": 1545,
+    "functional_verbatim": 1549,
     "rules": 3,
     "gate_literals": 3,
     "gate": "passed"
   },
-  "file_count": 1901,
-  "tree_sha256": "028f3591a335092742ce9ca6791ae17cc69d690bbe3895e09e10742a648eb04e",
+  "file_count": 1905,
+  "tree_sha256": "7a78e601f7e02412f566e605aed571ee145c0daa03911d7f8ad188e9369fd34f",
   "files": [
     {
       "path": ".claude/skills/blocker-review/SKILL.md",
@@ -347,12 +347,12 @@
     {
       "path": "clients/bongos-client/README.md",
       "mode": "0000644",
-      "sha256": "fc26e581e9ba06ec9fd798e982539f0bd8dc4c27a5f6c248b395f62214daaf78"
+      "sha256": "4855d865dbe79d1d6b9d774c8cbf480c36c6a3eae28392845850efb0689a6997"
     },
     {
       "path": "clients/bongos-client/bongos-client.global.js",
       "mode": "0000644",
-      "sha256": "e50696e5b7b9c1abab280665dd57ab6f8f8883d3bfd0f2701a45ee7d9a6fb728"
+      "sha256": "e5bde7c338fc07f45f8f58dec2fa8826c0ea11d85c33146c9b6e7bdcc7049ba2"
     },
     {
       "path": "clients/bongos-client/examples/hello-world.mjs",
@@ -362,17 +362,17 @@
     {
       "path": "clients/bongos-client/index.cjs",
       "mode": "0000644",
-      "sha256": "b13e62181adbc47a9ba6d3349a4abcb63fca123f3b0202414a1f7a2ba5e7d088"
+      "sha256": "8f3092af15067a6ed54092a10b4d43cd64eda7ae8fec0e50fe43de91428c9157"
     },
     {
       "path": "clients/bongos-client/index.d.ts",
       "mode": "0000644",
-      "sha256": "bebe9282f7f60c62dc554c24bbec1fb7c9a8453e98015d5207c3b70260bcbb56"
+      "sha256": "70cc0227b4003bf47a6942656c8ce652c9884022cee81006c0c73e552eec6361"
     },
     {
       "path": "clients/bongos-client/index.mjs",
       "mode": "0000644",
-      "sha256": "d4f2e6c3b376c35679416efcd30bbe54bae396cbaa8ee1e4078c56b6175da3d4"
+      "sha256": "819100f31cb468e82a0f2684a0e16b5ae1252cf91ef30b1923398af968ee5170"
     },
     {
       "path": "clients/bongos-client/package.json",
@@ -1472,12 +1472,12 @@
     {
       "path": "docs/api-reference.md",
       "mode": "0000644",
-      "sha256": "544b25f700d89d7f51dd84cb4faa740bc1c9bb4bf52853470e7d645040215033"
+      "sha256": "5972f14220674de9bcb4fbcdbe6859f208555bf0adc3de70ccefd64544545344"
     },
     {
       "path": "docs/api/openapi.json",
       "mode": "0000644",
-      "sha256": "dbc90270a1754caf816ce9fde9cde35af21e977da08309f56c4d96dbf7cad9bf"
+      "sha256": "342d1060be381a873d917c47037097e9f2561546900c4ca16986aed10913c553"
     },
     {
       "path": "docs/architecture.md",
@@ -1502,12 +1502,12 @@
     {
       "path": "docs/copy-inventory.md",
       "mode": "0000644",
-      "sha256": "23502315ff7f5e758ad3171a7bd28f8861ccb6640be93bd6a3a3f681c1ff0606"
+      "sha256": "5805bd8d2f443b028c4f6934ce1619254d3e6dc47f2ebc3f24ced87f5614066f"
     },
     {
       "path": "docs/copy-registry.json",
       "mode": "0000644",
-      "sha256": "85ead9ad5f556a449495e0e7f7af09a29fb9e54e663ef3fbf9f1fe1c390bc8d6"
+      "sha256": "11839e3afac4b57f3a230f32bfa004a08ed34d0315ec94096cd0f83949b104a5"
     },
     {
       "path": "docs/design-contract.md",
@@ -2609,6 +2609,11 @@
       "mode": "0000644",
       "sha256": "5d79d4f6f0e24b0ae9731a31ebabadc43faa3b6a423d31800b664960dc16145c"
     },
+    {
+      "path": "modules/builder-settings/profile-nudge-prefs.js",
+      "mode": "0000644",
+      "sha256": "26935726b1b388fb90793145d22f95641b2222a7b8ee29b2ed418bb2725f9fba"
+    },
     {
       "path": "modules/builder-settings/render-prefs.js",
       "mode": "0000644",
@@ -2617,7 +2622,7 @@
     {
       "path": "modules/builder-settings/routes/settings.js",
       "mode": "0000644",
-      "sha256": "c5198a5fb915be1015eec09ca0b614c96d820fdf491cb56d1c735b8839a441c0"
+      "sha256": "e1de49abd66d5dece54d5a794bb1af28469028903b022f3d7b1e2c453ea0b851"
     },
     {
       "path": "modules/builder-settings/settings.js",
@@ -2907,7 +2912,7 @@
     {
       "path": "modules/dev-box/app/src/vendor/bongos-client.cjs",
       "mode": "0000644",
-      "sha256": "b13e62181adbc47a9ba6d3349a4abcb63fca123f3b0202414a1f7a2ba5e7d088"
+      "sha256": "8f3092af15067a6ed54092a10b4d43cd64eda7ae8fec0e50fe43de91428c9157"
     },
     {
       "path": "modules/dev-box/app/test/unit.mjs",
@@ -3557,7 +3562,7 @@
     {
       "path": "modules/hall-ui/public/goal-inbox.js",
       "mode": "0000644",
-      "sha256": "ede756a5c11c8c6a9eca4c841f2110a5e05293b0fbd6d34a5c90a05dc02943c4"
+      "sha256": "71836d70e751ea8c7363c3217931a2cdfaeea38b770b90e564baf69cfe75f40f"
     },
     {
       "path": "modules/hall-ui/public/goals-lib.js",
@@ -3667,7 +3672,7 @@
     {
       "path": "modules/hall-ui/public/index.html",
       "mode": "0000644",
-      "sha256": "6564fe67e5987fbc25a4dd84d0288302ddcd81050e6afa1e5ab1b1dea873c0d8"
+      "sha256": "78cb8c70e92e70d996a8f1694b7b01bf893f6aa3f210bc297e48cdd961b971ae"
     },
     {
       "path": "modules/hall-ui/public/md-reader.js",
@@ -3754,6 +3759,11 @@
       "mode": "0000644",
       "sha256": "40f6f44283aa7dba25a2c983d77b6e6f53f40eefef3394122d34f7f42fc5f676"
     },
+    {
+      "path": "modules/hall-ui/public/profile-nudge.js",
+      "mode": "0000644",
+      "sha256": "b86a8a2b12e30671cc00a4495fbc9789967d38622ce803f1ffc2d95ae45b7d03"
+    },
     {
       "path": "modules/hall-ui/public/profile.html",
       "mode": "0000644",
@@ -4902,12 +4912,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "01e0ec5418014e61e5a0bdf1781ea84ee46c4c8bfc1b63b0e55bb6397ec06498"
+      "sha256": "eb5cb1b57d8467f5d70ced6de47f1963a802fe5ae00bbaf960befcf5000efa75"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "f38add7db0b96f5b469c5127f7e06336ef5626edc93d61f797d3439e0ca51760"
+      "sha256": "61856d92a07e11bb5aa53a7ab2be103c7cf31e555a616086f603fdea79485344"
     },
     {
       "path": "public-docs/index.html",
@@ -5587,7 +5597,7 @@
     {
       "path": "scripts/gds/fitness-checks-write-validation.js",
       "mode": "0000644",
-      "sha256": "7ee041817c06a56d4801f4367a618384ad856235a5034d3abdafa9f9344bff0b"
+      "sha256": "7501680e8b657a1002c185750951f16af1b2e7e30c04c72a3f03a94d286e02c4"
     },
     {
       "path": "scripts/gds/fitness-lib.js",
@@ -6257,7 +6267,7 @@
     {
       "path": "scripts/gds/ship-land.js",
       "mode": "0000644",
-      "sha256": "e091557b4cc29c081cb82f9cd650b4c110f1dede4e72b704893f8397cd7bbaf2"
+      "sha256": "72efd4268060fb5ddf8a176d91baf01353dc1e82594d70feef029c45f748d8f9"
     },
     {
       "path": "scripts/gds/ship-memory-sync.js",
@@ -6792,7 +6802,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "88ea06ed6759765c78ff0fc67ddd0a65041e7b8fda60e0f18b5809c44107ad7d"
+      "sha256": "abace193194919c4b75a9c461890b24be8e8c06093311c956c91894305980725"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -8704,6 +8714,11 @@
       "mode": "0000644",
       "sha256": "ff73579dd2416a81648d85dcd5d1a77cb776c32047bd0cc7897dff132cbae5b7"
     },
+    {
+      "path": "tests/profile_nudge_prefs.mjs",
+      "mode": "0000644",
+      "sha256": "a7f70fa612494593438565f4bd1e3d454a3dbca862c8396a7dcb252d38e3e489"
+    },
     {
       "path": "tests/profile_rollup_consent.mjs",
       "mode": "0000644",
@@ -9219,6 +9234,11 @@
       "mode": "0000644",
       "sha256": "5c0d5961408ac202eb53fe648c4c8b00e5552b231b35f39a39e006b705cb34f1"
     },
+    {
+      "path": "tests/ship_push_diagnosis.mjs",
+      "mode": "0000644",
+      "sha256": "d69bad6c8b3a01434b4fd5230f2b781bbe7fd9938df3d96b2a4ef34906287e54"
+    },
     {
       "path": "tests/ship_resume.mjs",
       "mode": "0000644",
@@ -9292,7 +9312,7 @@
     {
       "path": "tests/sound_player.mjs",
       "mode": "0000644",
-      "sha256": "42398e730349be5f10e07eb3ec42aa47c9a024371f2f95f96802b990ff0e6f80"
+      "sha256": "5b42ae4236e203c69feb3b8885ebec3a5f2b0d7f6880128536dfe5b8088fd4e8"
     },
     {
       "path": "tests/sound_prefs.mjs",

package/clients/bongos-client/README.md

@@ -5,7 +5,7 @@ A **generated**, zero-dependency typed client for the Bongos API — produced fr
 by hand; it regenerates when the spec changes, so it can never drift from the routes.
 
 - API version: **v1** (served at `/api/bongos/v1`)
-- 318 operations across 52 resource groups
+- 320 operations across 52 resource groups
 
 ## Install
 

package/clients/bongos-client/bongos-client.global.js

@@ -501,6 +501,10 @@ function createClient(opts = {}) {
       patchMeModelAllocation: (args) => request("PATCH", "/me/model-allocation", { hasBody: true }, args),
       // PATCH /me/profile — rank: any-builder — PATCH /me/profile
       patchMeProfile: (args) => request("PATCH", "/me/profile", { hasBody: true }, args),
+      // GET /me/profile-nudge — rank: any-builder — GET /me/profile-nudge
+      getMeProfileNudge: (args) => request("GET", "/me/profile-nudge", { hasBody: false }, args),
+      // PATCH /me/profile-nudge — rank: any-builder — PATCH /me/profile-nudge
+      patchMeProfileNudge: (args) => request("PATCH", "/me/profile-nudge", { hasBody: true }, args),
       // GET /me/recent-ships — rank: any-builder — GET /me/recent-ships
       getMeRecentShips: (args) => request("GET", "/me/recent-ships", { hasBody: false }, args),
       // GET /me/render — rank: any-builder — GET /me/render

package/clients/bongos-client/index.cjs

@@ -500,6 +500,10 @@ function createClient(opts = {}) {
       patchMeModelAllocation: (args) => request("PATCH", "/me/model-allocation", { hasBody: true }, args),
       // PATCH /me/profile — rank: any-builder — PATCH /me/profile
       patchMeProfile: (args) => request("PATCH", "/me/profile", { hasBody: true }, args),
+      // GET /me/profile-nudge — rank: any-builder — GET /me/profile-nudge
+      getMeProfileNudge: (args) => request("GET", "/me/profile-nudge", { hasBody: false }, args),
+      // PATCH /me/profile-nudge — rank: any-builder — PATCH /me/profile-nudge
+      patchMeProfileNudge: (args) => request("PATCH", "/me/profile-nudge", { hasBody: true }, args),
       // GET /me/recent-ships — rank: any-builder — GET /me/recent-ships
       getMeRecentShips: (args) => request("GET", "/me/recent-ships", { hasBody: false }, args),
       // GET /me/render — rank: any-builder — GET /me/render

package/clients/bongos-client/index.d.ts

@@ -787,6 +787,10 @@ export interface BongosClient {
     patchMeModelAllocation(args?: RequestArgs): Promise<ApiResponse>;
     /** PATCH /me/profile — rank: any-builder */
     patchMeProfile(args?: RequestArgs & { body?: PatchMeProfileRequest }): Promise<PatchMeProfileResponse>;
+    /** GET /me/profile-nudge — rank: any-builder */
+    getMeProfileNudge(args?: RequestArgs): Promise<ApiResponse>;
+    /** PATCH /me/profile-nudge — rank: any-builder */
+    patchMeProfileNudge(args?: RequestArgs): Promise<ApiResponse>;
     /** GET /me/recent-ships — rank: any-builder */
     getMeRecentShips(args?: RequestArgs): Promise<GetMeRecentShipsResponse>;
     /** GET /me/render — rank: any-builder */

package/clients/bongos-client/index.mjs

@@ -497,6 +497,10 @@ export function createClient(opts = {}) {
       patchMeModelAllocation: (args) => request("PATCH", "/me/model-allocation", { hasBody: true }, args),
       // PATCH /me/profile — rank: any-builder — PATCH /me/profile
       patchMeProfile: (args) => request("PATCH", "/me/profile", { hasBody: true }, args),
+      // GET /me/profile-nudge — rank: any-builder — GET /me/profile-nudge
+      getMeProfileNudge: (args) => request("GET", "/me/profile-nudge", { hasBody: false }, args),
+      // PATCH /me/profile-nudge — rank: any-builder — PATCH /me/profile-nudge
+      patchMeProfileNudge: (args) => request("PATCH", "/me/profile-nudge", { hasBody: true }, args),
       // GET /me/recent-ships — rank: any-builder — GET /me/recent-ships
       getMeRecentShips: (args) => request("GET", "/me/recent-ships", { hasBody: false }, args),
       // GET /me/render — rank: any-builder — GET /me/render

package/docs/api/openapi.json

@@ -8204,6 +8204,79 @@
         ]
       }
     },
+    "/me/profile-nudge": {
+      "get": {
+        "operationId": "get_me_profile_nudge",
+        "tags": [
+          "me"
+        ],
+        "summary": "GET /me/profile-nudge",
+        "description": "The \"Complete your profile\" nudge dismissal (task 1002802 / P06). The nudge itself is a DISMISSIBLE line item in the hall's needs-attention inbox — the replacement for the profile-setup wizard Decision 2 rejected. These two routes own only the dismissal FLAG; whether anything is actually missing is composed by the caller, which already holds both inputs (preferred_disciplines from GET /me, bio from GET /me/cross-project — bio lives on the platform identity account, and this module must never reach across to that one). rank: any-builder — own profile config; same posture as /me/render.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/builder-settings/routes/settings.js",
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      },
+      "patch": {
+        "operationId": "patch_me_profile_nudge",
+        "tags": [
+          "me"
+        ],
+        "summary": "PATCH /me/profile-nudge",
+        "description": "PATCH the dismissal. Body: { dismissed: <bool> | null } — null clears the override so the nudge can come back (the undismiss path). Sibling behavior keys are preserved by applyPatch.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/builder-settings/routes/settings.js",
+        "requestBody": {
+          "required": false,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "additionalProperties": true
+              }
+            }
+          },
+          "x-validated": false,
+          "x-body-undocumented": true
+        },
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/me/recent-ships": {
       "get": {
         "operationId": "get_me_recent_ships",
@@ -20079,9 +20152,9 @@
       "description": "A required dependency/feature is not configured or is temporarily down."
     }
   },
-  "x-endpoint-count": 318,
+  "x-endpoint-count": 320,
   "x-schema-count": 353,
-  "x-undocumented-bodies": 8,
+  "x-undocumented-bodies": 9,
   "x-response-schemas": 237,
   "x-generated-by": "scripts/gds/gen-api-docs.js"
 }

package/docs/api-reference.md

@@ -2,7 +2,7 @@
 
 # Bongos API reference
 
-> **Generated from the live route files** — the route file is authoritative. 318 endpoints across 52 route files.
+> **Generated from the live route files** — the route file is authoritative. 320 endpoints across 52 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`.
@@ -327,7 +327,7 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/<redacted>
 | POST | `/api/bongos/llm-cache/lookup` | `metic+archon` | `cache_key`, `tokens_saved_est` | POST /llm-cache/lookup — hit/miss + atomic hit_count bump. |
 | POST | `/api/bongos/llm-cache/store` | `metic+archon` | `spec`, `result_stdout`, `result_cost_usd` | POST /llm-cache/store — upsert a freshly-produced result. |
 
-## `me` (25)
+## `me` (27)
 
 | Method | Path | Rank | Body | Description |
 |---|---|---|---|---|
@@ -347,6 +347,8 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/<redacted>
 | GET | `/api/bongos/me/model-allocation` | `any-builder` | — |  |
 | PATCH | `/api/bongos/me/model-allocation` | `any-builder` | _undocumented_ | PATCH the model allocation. |
 | PATCH | `/api/bongos/me/profile` | `any-builder` | `display_name`, `bio`, `links` | the caller's OWN profile fields (P02, task 1002798; spec Decision 4): bio, typed links, account display name. |
+| GET | `/api/bongos/me/profile-nudge` | `any-builder` | — | The "Complete your profile" nudge dismissal (task 1002802 / P06). |
+| PATCH | `/api/bongos/me/profile-nudge` | `any-builder` | _undocumented_ | PATCH the dismissal. |
 | GET | `/api/bongos/me/recent-ships` | `any-builder` | — | Tasks this builder has shipped, most recent first. |
 | GET | `/api/bongos/me/render` | `any-builder` | — | Per-builder "render widgets" knob (task 1279, shares the behavior_prefs jsonb / migration 119). |
 | PATCH | `/api/bongos/me/render` | `any-builder` | _undocumented_ | PATCH the render knob. |
@@ -587,5 +589,5 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/<redacted>
 
 ---
 
-> 8 write endpoint(s) take a JSON body with no declared validator schema — their fields are not yet machine-documented. Adding a `validateOrRespond` schema (`src/bongos/routes/_helpers.js`) surfaces them here automatically.
+> 9 write endpoint(s) take a JSON body with no declared validator schema — their fields are not yet machine-documented. Adding a `validateOrRespond` schema (`src/bongos/routes/_helpers.js`) surfaces them here automatically.
 

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).
 
-**1400 strings** across 3 surfaces · 1241 distinct pieces of copy · 1400 certain, 0 heuristic · 129 shown in more than one place.
+**1403 strings** across 3 surfaces · 1244 distinct pieces of copy · 1403 certain, 0 heuristic · 129 shown in more than one place.
 
 ## Surfaces
 
 | surface | lives at | files | strings |
 |---|---|---|---|
-| `builders-hall` | `modules/hall-ui/public` | 70 | 1110 |
+| `builders-hall` | `modules/hall-ui/public` | 71 | 1113 |
 | `status-dashboard` | `modules/status-ui/public` | 4 | 98 |
 | `landing` | `public-landing` | 2 | 192 |
 
@@ -78,7 +78,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `3837f6d586a3` | 2x | Copy the task prompt to your clipboard | modules/hall-ui/public/goals-render.js:266, modules/hall-ui/public/work.js:362 |
 | … | | _89 more in the JSON registry_ | |
 
-## `builders-hall` — 1110 strings
+## `builders-hall` — 1113 strings
 
 | id | conf | text | where |
 |---|---|---|---|
@@ -136,6 +136,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `303f8d90266f` | certain | Achievements could not be loaded. | `modules/hall-ui/public/builders.js:1136` |
 | `6ca31dd5eb91` | certain | Acknowledge the primer | `modules/hall-ui/public/primer.html:65` |
 | `4461b13f95c2` | certain | Actions apply at once. Closing stops and deletes the box; you can start a fresh one anytime. | `modules/hall-ui/public/settings.html:162` |
+| `62eded408097` | certain | Add {…} | `modules/hall-ui/public/profile-nudge.js:68` |
 | `7cf0163d4cde` | certain | Aggregate totals across every recorded work session. | `modules/hall-ui/public/sessions.html:35` |
 | `8b736e365191` | certain | All builders | `modules/hall-ui/public/hall-render.js:998` |
 | `b5e03617b319` | certain | All goals | `modules/hall-ui/public/goals.html:41` |
@@ -238,6 +239,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `530d83153e17` | certain | Codebase detail | `modules/hall-ui/public/atlas.html:41` |
 | `c72c97dc33fe` | certain | Collab — {{worldName}} | `modules/hall-ui/public/collab.html:6` |
 | `c72c97dc33fe` | certain | Collab — {{worldName}} | `modules/hall-ui/public/collab.html:6` |
+| `cfc287c42263` | certain | Complete your profile | `modules/hall-ui/public/profile-nudge.js:62` |
 | `2867c85d196d` | certain | Confirm that verification for #{…} actually passed? | `modules/hall-ui/public/task.js:327` |
 | `9b16a22bf24c` | certain | Connect Discord & join the server | `modules/hall-ui/public/hall-render.js:814` |
 | `9b16a22bf24c` | certain | Connect Discord & join the server | `modules/hall-ui/public/settings.js:826` |
@@ -770,6 +772,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `14d32a35c15f` | certain | Show my cross-project record | `modules/hall-ui/public/settings.js:579` |
 | `dc0f9fe50a65` | certain | Show the setup guide again | `modules/hall-ui/public/index.html:55` |
 | `2af4c0f2b4b9` | certain | Showing {…} of {…}. | `modules/hall-ui/public/ideas.js:369` |
+| `838b17fa8d93` | certain | Shown on your public profile — it helps others know what you work on. | `modules/hall-ui/public/profile-nudge.js:69` |
 | `2f12d46f96ca` | certain | Sign in from the app. | `modules/hall-ui/public/hall-render.js:609` |
 | `19ab56cc3932` | certain | Sign in to filter to your goals | `modules/hall-ui/public/goals-page.js:821` |
 | `b057dfbf49c5` | certain | Sign in when Claude prompts you. | `modules/hall-ui/public/hall-render.js:609` |

package/docs/copy-registry.json

@@ -3,17 +3,17 @@
   "generator": "scripts/gds/copy-inventory.js",
   "goal": 1000074,
   "counts": {
-    "strings": 1400,
-    "unique_ids": 1241,
-    "certain": 1400,
+    "strings": 1403,
+    "unique_ids": 1244,
+    "certain": 1403,
     "heuristic": 0,
     "duplicate_ids": 129
   },
   "surfaces": {
     "builders-hall": {
       "at": "modules/hall-ui/public",
-      "files": 70,
-      "strings": 1110
+      "files": 71,
+      "strings": 1113
     },
     "status-dashboard": {
       "at": "modules/status-ui/public",
@@ -1846,6 +1846,15 @@
       "origin": "html-text",
       "confidence": "certain"
     },
+    {
+      "id": "62eded408097",
+      "surface": "builders-hall",
+      "text": "Add {…}",
+      "file": "modules/hall-ui/public/profile-nudge.js",
+      "line": 68,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
     {
       "id": "7cf0163d4cde",
       "surface": "builders-hall",
@@ -2764,6 +2773,15 @@
       "origin": "html-title",
       "confidence": "certain"
     },
+    {
+      "id": "cfc287c42263",
+      "surface": "builders-hall",
+      "text": "Complete your profile",
+      "file": "modules/hall-ui/public/profile-nudge.js",
+      "line": 62,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
     {
       "id": "2867c85d196d",
       "surface": "builders-hall",
@@ -7552,6 +7570,15 @@
       "origin": "js-markup",
       "confidence": "certain"
     },
+    {
+      "id": "838b17fa8d93",
+      "surface": "builders-hall",
+      "text": "Shown on your public profile — it helps others know what you work on.",
+      "file": "modules/hall-ui/public/profile-nudge.js",
+      "line": 69,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
     {
       "id": "2f12d46f96ca",
       "surface": "builders-hall",

package/modules/builder-settings/profile-nudge-prefs.js

@@ -0,0 +1,125 @@
+// modules/builder-settings/profile-nudge-prefs.js — the "Complete your profile"
+// nudge dismissal (task 1002802 / P06, goal 1000045).
+//
+// WHY A KNOB AND NOT A WIZARD. Decision 2 of the builder-profile spec
+// (docs/specs/bongos-v1-builder-profile-page.md) rejected a profile-setup
+// wizard: profiles are auto-created at first sign-in and enriched
+// progressively, and an interstitial between sign-in and the hall adds friction
+// at exactly the drop-off point. The replacement is a DISMISSIBLE line item in
+// the needs-attention inbox — the hall's placement rule (modules/hall-ui/
+// CLAUDE.md → Placement: an action awaiting the builder is an inbox line, never
+// a new Home card).
+//
+// Dismissible has to mean dismissed-for-good, across devices: a builder who has
+// decided not to write a bio should not be asked again on their laptop. So the
+// flag is SERVER-side, not localStorage.
+//
+// Storage: one reserved key ('profile_nudge_dismissed') inside the
+// `behavior_prefs` jsonb on `builders` (migration 119 — the same blob the
+// wandering/render/interaction knobs use), so this adds NO migration. Value is
+// a scalar boolean; a missing key means "not dismissed", which keeps the column
+// sparse. applyPatch leaves sibling keys alone.
+//
+// This module is the single source of truth: GET/PATCH /api/gds/me/profile-nudge
+// read and write it, and the hall's attention-card slice reads the resolved
+// boolean to decide whether to render the line at all.
+
+const RESERVED_KEY = 'profile_nudge_dismissed';
+const DEFAULT_DISMISSED = false; // never dismissed until the builder says so
+
+// ---- pure helpers ----
+
+// The raw override a builder has stored, or null when unset/invalid. Kept
+// separate from the effective value so a caller can tell "chose to keep it" from
+// "never answered" (mirrors render-prefs' overrideEnabled).
+function overrideDismissed(behaviorPrefs) {
+  const raw = behaviorPrefs && behaviorPrefs[RESERVED_KEY];
+  return typeof raw === 'boolean' ? raw : null;
+}
+
+// The resolved boolean — the value the hall acts on.
+function nudgeDismissed(behaviorPrefs) {
+  const o = overrideDismissed(behaviorPrefs);
+  return o === null ? DEFAULT_DISMISSED : o;
+}
+
+// Which profile fields are still empty. PURE over the two inputs the nudge
+// cares about, so the decision is testable without a DB or an HTTP round-trip.
+// `bio` lives on the platform-identity account (hub-side), `preferred_disciplines`
+// on `builders` — the caller passes both; this file never reaches for either.
+// Whitespace-only bio counts as empty: a space is not a bio.
+function missingProfileFields({ bio, preferredDisciplines } = {}) {
+  const missing = [];
+  if (typeof bio !== 'string' || bio.trim() === '') missing.push('bio');
+  if (!Array.isArray(preferredDisciplines) || preferredDisciplines.length === 0) missing.push('disciplines');
+  return missing;
+}
+
+// Should the nudge render? Only when something is actually missing AND the
+// builder has not dismissed it. The two halves are deliberately separate above
+// so a caller can say WHAT is missing even when the nudge is dismissed.
+function shouldNudge({ behaviorPrefs, bio, preferredDisciplines } = {}) {
+  if (nudgeDismissed(behaviorPrefs)) return false;
+  return missingProfileFields({ bio, preferredDisciplines }).length > 0;
+}
+
+// Everything the API + the hall slice need in one object.
+function describeForApi(behaviorPrefs, { bio, preferredDisciplines } = {}) {
+  const missing = missingProfileFields({ bio, preferredDisciplines });
+  return {
+    dismissed: nudgeDismissed(behaviorPrefs),
+    default_dismissed: DEFAULT_DISMISSED,
+    override: overrideDismissed(behaviorPrefs),
+    missing,
+    show: !nudgeDismissed(behaviorPrefs) && missing.length > 0,
+  };
+}
+
+// Validate a PATCH body: { dismissed: <bool> | null }. `null` clears the
+// override (back to not-dismissed, so the nudge can return — the "undismiss"
+// path a Settings toggle would use). Unknown keys / non-booleans → 422. An empty
+// body is a valid no-op.
+function validatePatch(body) {
+  if (body == null || typeof body !== 'object' || Array.isArray(body)) {
+    return { ok: false, errors: [{ error: 'body_must_be_object' }] };
+  }
+  const errors = [];
+  const patch = {};
+  for (const [key, value] of Object.entries(body)) {
+    if (key !== 'dismissed') {
+      errors.push({ key, error: 'unknown_key', allowed: ['dismissed'] });
+      continue;
+    }
+    if (value === null || typeof value === 'boolean') {
+      patch[RESERVED_KEY] = value; // null = clear → default (not dismissed)
+      continue;
+    }
+    errors.push({ key, error: 'invalid_value', value, allowed: 'boolean or null' });
+  }
+  if (errors.length > 0) return { ok: false, errors };
+  return { ok: true, patch };
+}
+
+// Apply a validated patch to a builder's existing behavior_prefs. Pure. null
+// deletes the key; a boolean overwrites. Sibling keys (wandering, widgets,
+// interaction) are left untouched.
+function applyPatch(existing, patch) {
+  const next = { ...(existing || {}) };
+  for (const [key, value] of Object.entries(patch)) {
+    if (value === null) delete next[key];
+    else next[key] = value;
+  }
+  return next;
+}
+
+module.exports = {
+  RESERVED_KEY,
+  DEFAULT_DISMISSED,
+  overrideDismissed,
+  nudgeDismissed,
+  missingProfileFields,
+  shouldNudge,
+  describeForApi,
+  validatePatch,
+  applyPatch,
+};