@bongos/core 1.21.48 → 1.21.49

package/docs/copy-registry.json

@@ -3,17 +3,17 @@
   "generator": "scripts/gds/copy-inventory.js",
   "goal": 1000074,
   "counts": {
-    "strings": 2452,
-    "unique_ids": 2133,
-    "certain": 2452,
+    "strings": 2454,
+    "unique_ids": 2134,
+    "certain": 2454,
     "heuristic": 0,
-    "duplicate_ids": 222
+    "duplicate_ids": 223
   },
   "surfaces": {
     "builders-hall": {
       "at": "modules/hall-ui/public",
       "files": 133,
-      "strings": 1803
+      "strings": 1805
     },
     "status-dashboard": {
       "at": "modules/status-ui/public",
@@ -841,7 +841,7 @@
       "text": "Connect Discord & join the server",
       "occurrences": 2,
       "at": [
-        "modules/hall-ui/public/hall-render.js:956",
+        "modules/hall-ui/public/hall-render.js:958",
         "modules/hall-ui/public/settings.js:722"
       ]
     },
@@ -2075,6 +2075,16 @@
         "modules/hall-ui/public/roadmap.js:341"
       ]
     },
+    {
+      "id": "e2c643fbf4d6",
+      "surface": "builders-hall",
+      "text": "npm install",
+      "occurrences": 2,
+      "at": [
+        "modules/hall-ui/public/hall-render.js:810",
+        "modules/hall-ui/public/hall-render.js:898"
+      ]
+    },
     {
       "id": "af3a8e0fe6a8",
       "surface": "builders-hall",
@@ -2430,14 +2440,23 @@
       "confidence": "certain"
     },
     {
-      "id": "a4614c0b8eb5",
+      "id": "ca72c792ea50",
       "surface": "builders-hall",
-      "text": "(or use the Claude Code CLI) and open the project.",
+      "text": "(or use the Claude Code CLI), open the project, and run",
       "file": "modules/hall-ui/public/hall-render.js",
       "line": 810,
       "origin": "js-markup",
       "confidence": "certain"
     },
+    {
+      "id": "553dbe6ede26",
+      "surface": "builders-hall",
+      "text": "(version 22 or newer) and",
+      "file": "modules/hall-ui/public/hall-render.js",
+      "line": 834,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
     {
       "id": "c7aecadc8133",
       "surface": "builders-hall",
@@ -3010,7 +3029,7 @@
       "surface": "builders-hall",
       "text": "All builders",
       "file": "modules/hall-ui/public/hall-render.js",
-      "line": 1181,
+      "line": 1183,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -3127,7 +3146,7 @@
       "surface": "builders-hall",
       "text": "Analytics scope",
       "file": "modules/hall-ui/public/hall-render.js",
-      "line": 1179,
+      "line": 1181,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -3627,9 +3646,9 @@
       "confidence": "certain"
     },
     {
-      "id": "1596210cea76",
+      "id": "25b4ab94728a",
       "surface": "builders-hall",
-      "text": "Build from your own machine — clone the repository, run the platform locally, and sign in from the terminal.",
+      "text": "Build from your own machine — get a copy of the project, sign in once, then work in Claude.",
       "file": "modules/hall-ui/public/hall-render.js",
       "line": 810,
       "origin": "js-markup",
@@ -4126,7 +4145,7 @@
       "surface": "builders-hall",
       "text": "Claude Code",
       "file": "modules/hall-ui/public/hall-render.js",
-      "line": 833,
+      "line": 834,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -4167,11 +4186,11 @@
       "confidence": "certain"
     },
     {
-      "id": "bbe07ccbc2e4",
+      "id": "34624d39ff29",
       "surface": "builders-hall",
-      "text": "Clone the project to your machine. The build commands live inside the repo, so this comes first. The remaining steps below are tracked automatically.",
+      "text": "Clone the project to your machine and run",
       "file": "modules/hall-ui/public/hall-render.js",
-      "line": 896,
+      "line": 898,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -4333,7 +4352,7 @@
       "surface": "builders-hall",
       "text": "Connect Discord & join the server",
       "file": "modules/hall-ui/public/hall-render.js",
-      "line": 956,
+      "line": 958,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -6079,7 +6098,7 @@
       "surface": "builders-hall",
       "text": "First install",
       "file": "modules/hall-ui/public/hall-render.js",
-      "line": 833,
+      "line": 834,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -6088,7 +6107,7 @@
       "surface": "builders-hall",
       "text": "First — obtain the repo",
       "file": "modules/hall-ui/public/hall-render.js",
-      "line": 896,
+      "line": 898,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -6282,9 +6301,9 @@
       "confidence": "certain"
     },
     {
-      "id": "647bcfcfdb03",
+      "id": "36ecb5d3686c",
       "surface": "builders-hall",
-      "text": "Fresh CLI token issued. Paste it in your terminal:",
+      "text": "Fresh CLI token issued. Paste this into a terminal in your project folder:",
       "file": "modules/hall-ui/public/settings.js",
       "line": 795,
       "origin": "js-text-assign",
@@ -7492,7 +7511,7 @@
       "surface": "builders-hall",
       "text": "Kind of work",
       "file": "modules/hall-ui/public/hall-render.js",
-      "line": 1146,
+      "line": 1148,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -7501,7 +7520,7 @@
       "surface": "builders-hall",
       "text": "Kinds of work shipped",
       "file": "modules/hall-ui/public/hall-render.js",
-      "line": 1259,
+      "line": 1261,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -8046,9 +8065,9 @@
       "confidence": "certain"
     },
     {
-      "id": "64e91044df43",
+      "id": "638bfd6405ce",
       "surface": "builders-hall",
-      "text": "Mint a fresh CLI token using this browser session and paste it into your terminal — the quick way back in when a",
+      "text": "Mint a fresh CLI token using this browser session and paste the command it gives you into a terminal in your project folder — the quick way back in when a",
       "file": "modules/hall-ui/public/settings.html",
       "line": 142,
       "origin": "html-text",
@@ -8500,7 +8519,7 @@
       "surface": "builders-hall",
       "text": "No onboarding steps recorded yet.",
       "file": "modules/hall-ui/public/hall-render.js",
-      "line": 884,
+      "line": 886,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -9071,15 +9090,6 @@
       "origin": "js-markup",
       "confidence": "certain"
     },
-    {
-      "id": "b89ad49770e7",
-      "surface": "builders-hall",
-      "text": "On Windows, run",
-      "file": "modules/hall-ui/public/hall-render.js",
-      "line": 833,
-      "origin": "js-markup",
-      "confidence": "certain"
-    },
     {
       "id": "11a1905c76b2",
       "surface": "builders-hall",
@@ -10975,7 +10985,7 @@
       "surface": "builders-hall",
       "text": "See the work board →",
       "file": "modules/hall-ui/public/hall-render.js",
-      "line": 946,
+      "line": 948,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -11191,7 +11201,7 @@
       "surface": "builders-hall",
       "text": "Set up your machine / get the code",
       "file": "modules/hall-ui/public/hall-render.js",
-      "line": 833,
+      "line": 834,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -12743,6 +12753,15 @@
       "origin": "html-text",
       "confidence": "certain"
     },
+    {
+      "id": "8d3aa9aa4915",
+      "surface": "builders-hall",
+      "text": "The same commands work on Mac, Windows and Linux. New to the steps? The",
+      "file": "modules/hall-ui/public/hall-render.js",
+      "line": 834,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
     {
       "id": "dd6a926b8137",
       "surface": "builders-hall",
@@ -13068,11 +13087,11 @@
       "confidence": "certain"
     },
     {
-      "id": "25794c439321",
+      "id": "996d2aa0e2f0",
       "surface": "builders-hall",
-      "text": "Then copy the project onto your machine and run the one-shot bootstrap (it checks your setup, installs dependencies, and signs you in):",
+      "text": "Then copy the project onto your machine, install its dependencies, and sign in:",
       "file": "modules/hall-ui/public/hall-render.js",
-      "line": 833,
+      "line": 834,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -15430,7 +15449,7 @@
       "surface": "builders-hall",
       "text": "command says your session expired.",
       "file": "modules/hall-ui/public/settings.html",
-      "line": 144,
+      "line": 145,
       "origin": "html-text",
       "confidence": "certain"
     },
@@ -15866,6 +15885,15 @@
       "origin": "js-markup",
       "confidence": "certain"
     },
+    {
+      "id": "7b7d61e05adf",
+      "surface": "builders-hall",
+      "text": "in it. The build commands live inside the repo, so this comes first. The remaining steps below are tracked automatically.",
+      "file": "modules/hall-ui/public/hall-render.js",
+      "line": 898,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
     {
       "id": "b2b399fdd6a4",
       "surface": "builders-hall",
@@ -15894,11 +15922,11 @@
       "confidence": "certain"
     },
     {
-      "id": "275e222d5448",
+      "id": "a75031550a6d",
       "surface": "builders-hall",
-      "text": "instead of the last line. New to the steps? The",
+      "text": "in that folder to sign this machine in.",
       "file": "modules/hall-ui/public/hall-render.js",
-      "line": 833,
+      "line": 810,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -16091,6 +16119,15 @@
       "origin": "html-text",
       "confidence": "certain"
     },
+    {
+      "id": "dfaec940ded4",
+      "surface": "builders-hall",
+      "text": "no GitHub code to type in.",
+      "file": "modules/hall-ui/public/settings.html",
+      "line": 149,
+      "origin": "html-text",
+      "confidence": "certain"
+    },
     {
       "id": "b9f2e0d43c94",
       "surface": "builders-hall",
@@ -16154,15 +16191,6 @@
       "origin": "js-text-assign",
       "confidence": "certain"
     },
-    {
-      "id": "739a4bd6bd83",
-      "surface": "builders-hall",
-      "text": "node scripts/setup-builder.js",
-      "file": "modules/hall-ui/public/hall-render.js",
-      "line": 833,
-      "origin": "js-markup",
-      "confidence": "certain"
-    },
     {
       "id": "61f0f4b2f4ab",
       "surface": "builders-hall",
@@ -16271,6 +16299,24 @@
       "origin": "js-markup",
       "confidence": "certain"
     },
+    {
+      "id": "e2c643fbf4d6",
+      "surface": "builders-hall",
+      "text": "npm install",
+      "file": "modules/hall-ui/public/hall-render.js",
+      "line": 898,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
+    {
+      "id": "f3733d6a021e",
+      "surface": "builders-hall",
+      "text": "npx bongos setup",
+      "file": "modules/hall-ui/public/hall-render.js",
+      "line": 810,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
     {
       "id": "e90b5601ce16",
       "surface": "builders-hall",
@@ -16442,15 +16488,6 @@
       "origin": "js-text-assign",
       "confidence": "certain"
     },
-    {
-      "id": "25d2c940e672",
-      "surface": "builders-hall",
-      "text": "paste it into your terminal — bypasses Device Flow.",
-      "file": "modules/hall-ui/public/settings.html",
-      "line": 149,
-      "origin": "html-text",
-      "confidence": "certain"
-    },
     {
       "id": "2fb1dad96280",
       "surface": "builders-hall",
@@ -17144,15 +17181,6 @@
       "origin": "js-markup",
       "confidence": "certain"
     },
-    {
-      "id": "d70c287bcd7f",
-      "surface": "builders-hall",
-      "text": "to authenticate this machine, then",
-      "file": "modules/hall-ui/public/hall-render.js",
-      "line": 810,
-      "origin": "js-markup",
-      "confidence": "certain"
-    },
     {
       "id": "65702f92a8c8",
       "surface": "builders-hall",
@@ -17347,7 +17375,7 @@
       "surface": "builders-hall",
       "text": "walks the whole path in plain language.",
       "file": "modules/hall-ui/public/hall-render.js",
-      "line": 833,
+      "line": 834,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -17617,7 +17645,7 @@
       "surface": "builders-hall",
       "text": "{…} Your standing is {…}.",
       "file": "modules/hall-ui/public/hall-render.js",
-      "line": 845,
+      "line": 847,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -17824,7 +17852,7 @@
       "surface": "builders-hall",
       "text": "{…} of {…} steps cleared.",
       "file": "modules/hall-ui/public/hall-render.js",
-      "line": 980,
+      "line": 982,
       "origin": "js-text-assign",
       "confidence": "certain"
     },
@@ -18265,7 +18293,7 @@
       "surface": "builders-hall",
       "text": "— that's all the tooling you need up front.",
       "file": "modules/hall-ui/public/hall-render.js",
-      "line": 833,
+      "line": 834,
       "origin": "js-markup",
       "confidence": "certain"
     },

package/docs/module-api-changelog.md

@@ -2923,5 +2923,7 @@ is load-bearing: the script throws rather than guess if it is missing, and
         landed since 1.21.46 with no explicit bump. run 37236095022. (task 1002620)
   1.21.48 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
         landed since 1.21.47 with no explicit bump. run 37237206637. (task 1002620)
+  1.21.49 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
+        landed since 1.21.48 with no explicit bump. run 37238186340. (task 1002620)
 ---------------------------------------------------------------------------
 ```

package/docs/onboarding/primer.md

@@ -156,22 +156,29 @@ Take them in order — each one sets up the next, from "I'm admitted" to "I'm lo
    
    Once it finishes, that folder **is** the project. **One catch worth knowing:** the `/builder-*` commands came down *with* the code, but Claude Code only loads them when a session *starts* on a folder that already contains them — and this session started on an *empty* folder. So before the next step, **start a fresh Claude Code session on this same folder**: end this session and open a new one pointing at the folder. (Starting fresh is the clean way — the new session scans the folder from scratch, and the `/builder-*` commands will all be there.)
 
-**4. Enrol yourself and begin.** In the **fresh** session, type `/builder-setup` — or just say *"set up builder"* in plain English — and follow the prompts. It signs you in with GitHub once and registers you in Bongos so the commands know who you are. Then type `/builder-start` to see the works you can claim right now.
-
-If a `/builder-*` command ever says "no Bongos session," just run `/builder-setup` again — that re-links you. And if `/builder-setup` itself comes back **"unknown command,"** you're almost certainly still in the session that did the cloning — start a fresh session on the folder (end of step 3) and it'll be there.
-
-> **Prefer a terminal? (the quicker path if you're technical.)** Steps 3–4 above are the no-terminal route. If you're comfortable on a command line, skip them — clone the repo yourself, `cd` into it, and run the bootstrap:
->
-> **Before you start**, have three things ready: **Git** (check `git --version`; get it from [git-scm.com](https://git-scm.com/downloads)), the **Claude Code** desktop app ([claude.com/download](https://claude.com/download)), and a **GitHub account that's been invited to this private repo** (accept the emailed invite from step 2). Node ≥ 22 and Python ≥ 3.10 are checked by the bootstrap script — it prints the install command if either is missing, so you don't need them before cloning.
->
-> **Step 0 — get the project onto your machine.** Clone the repo and `cd` into the folder it creates:
->
-> ```sh
-> git clone https://github.com/example-owner/example.git
-> cd example
-> ```
->
-> **Then bootstrap** from inside that folder: `./scripts/setup-builder.sh` (macOS/Linux) — or `node scripts/setup-builder.js` (Windows, or any OS). It checks your toolchain, installs dependencies, and runs the same GitHub sign-in in one shot — no Claude-session juggling. Either route lands you in the same place.
+**4. Enrol yourself and begin.** In the **fresh** session, send this one message — *Install this project's dependencies, then run npx bongos setup.* — and follow the prompts. Installing the dependencies needs **Node** (version 22 or newer) on your computer; if Claude says it's missing, let it walk you through installing it from [nodejs.org](https://nodejs.org). `npx bongos setup` is the sign-in command: it signs you in with GitHub once and registers you in Bongos so the commands know who you are. Then type `/builder-start` to see the works you can claim right now.
+
+If a `/builder-*` command ever says "no Bongos session," run `npx bongos setup` again — that re-links you. And if `/builder-start` comes back **"unknown command,"** you're almost certainly still in the session that did the cloning — start a fresh session on the folder (end of step 3) and it'll be there.
+
+**Prefer a terminal? (the quicker path if you're technical.)** Steps 3–4 above are the no-terminal route. If you're comfortable on a command line, skip them — clone the repo yourself, `cd` into it, and sign in.
+
+**Before you start**, have four things ready: **Git** (check `git --version`; get it from [git-scm.com](https://git-scm.com/downloads)), **Node ≥ 22** (check `node --version`; get it from [nodejs.org](https://nodejs.org) — it provides the `npm` and `npx` commands below), the **Claude Code** desktop app ([claude.com/download](https://claude.com/download)), and a **GitHub account that's been invited to this private repo** (accept the emailed invite from step 2).
+
+**Step 0 — get the project onto your machine.** Clone the repo and `cd` into the folder it creates:
+
+```sh
+git clone https://github.com/example-owner/example.git
+cd example
+```
+
+**Then sign in** from inside that folder — the same two lines on Mac, Windows and Linux:
+
+```sh
+npm install
+npx bongos setup
+```
+
+`npm install` fetches the project's dependencies; `npx bongos setup` checks your toolchain and runs the same GitHub sign-in — no Claude-session juggling. Either route lands you in the same place.
 
 ## Your first task