@bongos/core 1.19.948 → 1.19.949

package/.bongos-core.json

@@ -2,22 +2,22 @@
   "artifact": "bongos-core",
   "manifest_schema": 1,
   "generator": "scripts/gds/package-core.js",
-  "core_version": "1.19.948",
-  "core_contract": "1.19.948",
-  "source_commit": "7e37e772b13a12d362d065e4717077968a833700",
+  "core_version": "1.19.949",
+  "core_contract": "1.19.949",
+  "source_commit": "b167833627e1c0360613322d616a6e288ea083a0",
   "source_ref": "HEAD",
-  "built_at": "2026-09-22T00:24:59.637Z",
+  "built_at": "2026-09-22T01:20:15.264Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
-    "docs_redacted": 512,
+    "docs_redacted": 513,
     "agent_docs_stubbed": 26,
-    "functional_verbatim": 2349,
+    "functional_verbatim": 2347,
     "rules": 3,
     "gate_literals": 3,
     "gate": "passed"
   },
-  "file_count": 2887,
-  "tree_sha256": "05aa6d17f1fc467a3da4bc029194d33bba69296024f1359ac1f8622f1278ad50",
+  "file_count": 2886,
+  "tree_sha256": "76d08b0cd0d4045e4ecadf3d9571fbcbc63cf5aebc7d33edf787c30a0c7978de",
   "files": [
     {
       "path": ".claude/skills/ask-for-help/SKILL.md",
@@ -2109,10 +2109,15 @@
       "mode": "0000644",
       "sha256": "8fa6ef943e3fc0855d15f83baefaabf810994b80da2ecdbbcc28d752ed0498f3"
     },
+    {
+      "path": "docs/adr/0324-the-public-npm-cli-channel-is-retired.md",
+      "mode": "0000644",
+      "sha256": "c1993ab3ca464c5aa7256301343e7b963914d085043638faa46c440e0511de08"
+    },
     {
       "path": "docs/adr/README.md",
       "mode": "0000644",
-      "sha256": "eef598f074ff3e22a4748b9092eb83d04235205c34e66db6bbe76547f050843d"
+      "sha256": "cd7aa240e31f48b0f0fa897af0ee90a4e51a0bf670bfec3071e31eae7caea6de"
     },
     {
       "path": "docs/api-reference.md",
@@ -2672,7 +2677,7 @@
     {
       "path": "docs/file-map.md",
       "mode": "0000644",
-      "sha256": "d3afe58f6c7608ae2c56744c86567f24347b71cb20a7ee268e44651d87206ec8"
+      "sha256": "ca43a028309885e4375a3fa216fc2636d33262d3038bf9e65a15f6e8b68f354d"
     },
     {
       "path": "docs/handoff-template.md",
@@ -2682,7 +2687,7 @@
     {
       "path": "docs/module-api-changelog.md",
       "mode": "0000644",
-      "sha256": "3f21cd6d53ac515244ae5be6d14bcf36898e487b4638a51bf4611e735c823c9f"
+      "sha256": "29e0651fa0f5cb469d61cc13ff096ef772a07006f2e8d53e2d6119b3b3f194fb"
     },
     {
       "path": "docs/modules-contract.md",
@@ -2937,7 +2942,7 @@
     {
       "path": "docs/recipes/windows-builders.md",
       "mode": "0000644",
-      "sha256": "dba962c19bf22e5773fd05eb6667581d15f62ecda7292a37f83b12227ad14049"
+      "sha256": "2608bea40745e61407454eb73ff3dc19d2c088a986741fb243001a1a0848ee00"
     },
     {
       "path": "docs/research/cursor-competitive-analysis.md",
@@ -5687,7 +5692,7 @@
     {
       "path": "modules/lifecycle/criterion-ref.js",
       "mode": "0000644",
-      "sha256": "c79a34e577df14c4c54d426e60789c5e30bc2e81fd4005a283f21936b9f0aba7"
+      "sha256": "5ae49c40d6f7ec8a1bb62f038b405e7c4e69b844ea204a50bded2eddef29faae"
     },
     {
       "path": "modules/lifecycle/criterion-suggest.js",
@@ -5712,7 +5717,7 @@
     {
       "path": "modules/lifecycle/db-deps-criteria.js",
       "mode": "0000644",
-      "sha256": "e921d48860af27f836252fa7e44e1bdae25be5b940c25e9272f1cf368805d132"
+      "sha256": "80c0d3ab5d905880309282446d1cd59645868e7de8aae962e01f46997fe5e469"
     },
     {
       "path": "modules/lifecycle/db-executor.js",
@@ -8037,12 +8042,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "987a8459bed5c80b510ed385e8eadc8109c42abf0deadf9c08b3f83da31eb42d"
+      "sha256": "c2e5171010f3ceab561e381ba14d2d76649b8bca170450a8db18edde40bf6228"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "66e973de72ac31b96eca16d6f7fe34dd833d515fb5cf04c32a66bce743518a25"
+      "sha256": "f7988eef8fb6aceffb3357949ab178209d7e340281f00f926334fd3456ef57c1"
     },
     {
       "path": "public-docs/index.html",
@@ -8344,11 +8349,6 @@
       "mode": "0000644",
       "sha256": "6a696f9291da2d071d8a8aa0f92bf0be08445569a73196f9204f696bf6cb6cb5"
     },
-    {
-      "path": "scripts/gds/build-cli-package.js",
-      "mode": "0000644",
-      "sha256": "a7a19db7b156f7e411e2a77146c2f9418b5b9ff7fa52be1e3dca56848307f98d"
-    },
     {
       "path": "scripts/gds/bump-version.js",
       "mode": "0000644",
@@ -8407,7 +8407,7 @@
     {
       "path": "scripts/gds/cli-lib.js",
       "mode": "0000644",
-      "sha256": "cbe71309f4e100b096eee7d91b90a4cc9e549caa3df51473f2ca3029ca4c8ba5"
+      "sha256": "a6c486243cf675fe9929997b09160616cbd05607423b1b6a823d2d57efba7619"
     },
     {
       "path": "scripts/gds/client-baseurl-guard.js",
@@ -8667,7 +8667,7 @@
     {
       "path": "scripts/gds/gen-api-client.js",
       "mode": "0000644",
-      "sha256": "00f267a8f3ceb040fa217d85f89b6e464ca6366f74b016c888d297ee900e816f"
+      "sha256": "6274411b4b43d0fc5ef8aa072d22123745d21268748fb32e55646aa2cb4fd01c"
     },
     {
       "path": "scripts/gds/gen-api-docs.js",
@@ -9087,7 +9087,7 @@
     {
       "path": "scripts/gds/release.js",
       "mode": "0000644",
-      "sha256": "997c4c4f45d360b765877e3583038be21b52267112b7b33e9c673ab245d682fc"
+      "sha256": "b7de35b15fef0cd61da00c4c7263920c82fcc0606d9ff787951be6fc1377406e"
     },
     {
       "path": "scripts/gds/rename-goals.js",
@@ -10047,7 +10047,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "d657538880551de9fb84c31218b01511298d620cb611f78bc4de93ae4acfb978"
+      "sha256": "3fbfb8061f3fdf5fbc1d7426db7eb5dd6b8ec4acaab02eab9489c0d443792b09"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -10849,11 +10849,6 @@
       "mode": "0000644",
       "sha256": "d0ea5b273c24527190f6ed01555ddb6b022a6ea94f3efcc7bdbd17f834c7d2ad"
     },
-    {
-      "path": "tests/cli_package.mjs",
-      "mode": "0000644",
-      "sha256": "e7839e6ac47b12fe4decd50e31d37fba3bad7ac475e8f24e948bb49b52a3e83e"
-    },
     {
       "path": "tests/cli_sessions.mjs",
       "mode": "0000644",
@@ -10862,7 +10857,7 @@
     {
       "path": "tests/cli_surface.mjs",
       "mode": "0000644",
-      "sha256": "cc10440e148e19a157cd18f0325e121f5492484e09550578e98870dba61090a9"
+      "sha256": "90427212f57df834e9e64e6423d38f2b2878eb8bea16c3874b3e30159db1ebd9"
     },
     {
       "path": "tests/cli_token_reissue.mjs",
@@ -12032,7 +12027,7 @@
     {
       "path": "tests/home_isolation_guard.mjs",
       "mode": "0000644",
-      "sha256": "b42c0338476c2fc7be72888b2eec1a79fcfb3ff1c27e85eff605d3248b2780e4"
+      "sha256": "193381e177d20129516ab0cc6482b24934bc3461f113c63cd3eca2ae6b6188d2"
     },
     {
       "path": "tests/hook_core_resolve.mjs",
@@ -12492,7 +12487,7 @@
     {
       "path": "tests/main_worktree_busy_reason.mjs",
       "mode": "0000644",
-      "sha256": "f74a3764214b67cb560e1e349624ac5e2ce419a6ae9af7389af4f0e70c8459f2"
+      "sha256": "097cca33e5d9973726a19a29e2105bf40edf4e1712d3128eeae1bd838e00ec2b"
     },
     {
       "path": "tests/maintenance_goal.mjs",
@@ -12872,7 +12867,7 @@
     {
       "path": "tests/plain_cards.mjs",
       "mode": "0000644",
-      "sha256": "7549965b77f59c63fc2ac5fe5eb6cb4d292da9140bff5d589c47f99b784ab579"
+      "sha256": "e7a255bdb636adb6206c9e34bafa007eb7c815a9fe65337aefd79fcc719e3182"
     },
     {
       "path": "tests/planning_session_skill.mjs",

package/docs/adr/0324-the-public-npm-cli-channel-is-retired.md

@@ -0,0 +1,89 @@
+# ADR 0324 — The public npm CLI channel is retired
+
+- **Status:** accepted
+- **Date:** 2026-09-22
+- **Task:** [task 1004144](https://cloudbongos.com/builders#/task/1004144) (goal 1000091 — working area 5, Module distribution & economy)
+- **Deciders:** Lars (Archon) — the owner deleted the package and confirmed the retirement; Claude scoped the consequences and executed the cleanup.
+- **Supersedes:** [ADR 0258](0258-the-public-cli-is-a-generated-client-package-not-the-published-core.md) · [ADR 0292](0292-both-install-paths-stay-and-vendoring-is-the-production-one.md) §2
+- **Related:** [ADR 0134](0134-private-first-npm-distribution.md) · [ADR 0283](0283-the-core-publishes-publicly-because-access-was-never-the-thing-protecting-it.md) (the public flip that removed this package's original reason) · [ADR 0269](0269-the-cli-session-store-is-host-keyed-at-a-fixed-anchor.md) (cites the package in an example)
+
+## Context
+
+`@cloudbongos/cli` was a generated, server-free npm package — the public front door, so a
+newcomer could reach an instance's board with `npx` and no checkout, no credential and no
+46 MB core download.
+
+**The owner removed it from the registry on 2026-09-22.** Verified: `npm view
+@cloudbongos/cli` answers E404, and `npm access list packages @cloudbongos` returns an
+empty scope.
+
+This ADR exists because that reverses a decision the project had already argued and
+settled — twice, in opposite directions:
+
+- **[ADR 0258](0258-the-public-cli-is-a-generated-client-package-not-the-published-core.md)**
+  established the channel: a generated client package rather than the published core,
+  deliberately excluding `claim` and `ship` because "a half-working claim that cannot
+  materialize into a checkout is worse than one that explains where to go".
+- **[ADR 0292](0292-both-install-paths-stay-and-vendoring-is-the-production-one.md) §2** is
+  titled *"`@cloudbongos/cli` STAYS, on a new justification"*. It was written **because**
+  task 1003872 proposed removing it once [ADR 0283](0283-the-core-publishes-publicly-because-access-was-never-the-thing-protecting-it.md)
+  made the core public and dissolved the original "no private-registry credential" reason.
+  0292 agreed the original reason was gone and kept the package anyway, on a measured one:
+  roughly half a megabyte for the front door, versus pulling the whole core — a web server
+  and a Postgres driver included — to print a task list.
+
+**That measured argument is still true.** Nothing about it was found wrong. What changed is
+the owner's decision about carrying a public distribution channel at all, which is a
+judgement about what this project wants to maintain and support, not a correction to 0292's
+arithmetic. The record should say that plainly rather than retro-fitting a technical fault.
+
+## Decision
+
+### 1. The public npm channel is retired. Nothing in the repo generates or advertises it.
+
+`scripts/gds/build-cli-package.js` and `tests/cli_package.mjs` are deleted. No document
+offers `npx @cloudbongos/cli` as a route in.
+
+### 2. The way in is the hall, or a checkout.
+
+A newcomer reaches an instance at its own address — `<origin>/builders` — which needs
+nothing installed at all and was always the lower-friction path for *reading* the board.
+Writing code still needs a checkout of the project repo, where the full CLI already is.
+This is the same answer [ADR 0258](0258-the-public-cli-is-a-generated-client-package-not-the-published-core.md)'s
+`CHECKOUT_ONLY` refusal gave for `claim` and `ship`; it is now the answer for every verb.
+
+### 3. The COMPILED binary channel is untouched, and is a different thing.
+
+Two separate artifacts were both called "the bongos CLI", and conflating them would delete
+a live surface:
+
+| | retired here | untouched |
+| --- | --- | --- |
+| built by | `scripts/gds/build-cli-package.js` | `scripts/gds/build-bongos.js` |
+| artifact | the `@cloudbongos/cli` npm package | per-platform compiled binaries |
+| served by | npm | `src/bongos-downloads.js` → `/downloads/bongos/*`, from `config/bongos-cli.json` |
+
+`/downloads/bongos/*`, `src/bongos-downloads.js`, `build-bongos.js` and
+`config/bongos-cli.json` are all unaffected. (Task 1003889 flagged this same near-twin when
+it warned "Keep `src/bongos-downloads.js`" while deleting the dev-box download surface.)
+
+### 4. Nothing is republished to fill the gap.
+
+Publishing is the owner's action ([ADR 0258](0258-the-public-cli-is-a-generated-client-package-not-the-published-core.md)),
+and no replacement package is planned. If a public channel is ever wanted again, it needs a
+new ADR and a fresh justification — 0292 §2's is spent.
+
+## Consequences
+
+**Positive.** One fewer artifact to build, version, redact and publish, and one fewer way for
+the repo to describe a thing that does not exist — which it had been doing since the deletion.
+It also closes a class: `@bongos/client` (removed 2026-09-09) and now `@cloudbongos/cli` both
+outlived their registry entries in the repo's prose, and neither leaves a generator behind.
+
+**Negative.** The zero-install on-ramp is gone. A newcomer with only a terminal can no longer
+reach the board without either a browser or a checkout, and the ~0.5 MB versus 46 MB gap 0292
+measured is a real cost now being paid. Accepted with open eyes.
+
+**Neutral.** No test fetched the registry, so nothing in CI depended on the package existing;
+three tests used its FILES manifest as a stand-in for "what a terminal user can run" and now
+read `bin/bongos.js`'s verb table, which is what that set always actually meant.

package/docs/adr/README.md

@@ -415,3 +415,4 @@ This keeps the decision history honest and traceable.
 | 0321 | [**Brightness is a payout-weighted share, and a removal's targets are rows** ([task 1004099](https://cloudbongos.com/builders#/task/1004099), goal 1000095 — BONGOS-V2). Size is an idea's total ideator payout and never falls; brightness is how much of that work is still alive, and the pair is what lets a thought whose version was torn out draw LARGE AND DARK rather than merging with one that never mattered. Two things had to be settled. **The removal facts were stored in the wrong direction**: [ADR 0319](0319-a-removal-verdict-is-a-row-beside-the-question.md) gave a confirmed removal a row carrying the verdict and `ship_task_id` — the task whose merge DELETED the files — and deliberately left out the tasks whose work was removed, saying brightness would design its own storage when it needed one. Those are different rows under different ideas, so reading one as the other dims the wrong star while looking like a working query. `<redacted>` stores `(proposal_task_id, removed_task_id, paths)` at PROPOSAL time, from the SAME derivation objects the proposal body renders as prose — one derivation, two renderings, so they cannot disagree and `removal-proposals.js` keeps its refusal to parse a body back. Proposal time and not verdict time because the attribution comes from capped, rate-limited GitHub commit-history reads that only exist while the cascade runs. NOT a runner fan-out ([ADR 0242](0242-a-cascade-is-a-declaration-table-on-the-event-that-already-exists.md)): the rule still files one task; this records a side fact about it. `ON CONFLICT DO NOTHING`, never `DO UPDATE`, since a degraded second walk finds FEWER paths and must not erase a good first read — and the writer runs on the cascade's SKIPPED row too, so a re-ship repairs what a derivation outage missed. **The share is weighted by PAYOUT, not by task count**, or deleting a one-line fix dims a star as hard as deleting the feature; weighting by what each hop earned also makes 'large and dead' exact, and makes the two channels a share of ONE number rather than two unrelated measurements. Basis is paid + estimated to match size, which required `priceDescentForIdea`/`ideaSizes` to return a per-task `byTask` summing EXACTLY to `credits` — including ledger payments for tasks the descent no longer reaches, which `idea-size.js` keeps in `credits` so size cannot fall and which would otherwise make the parts sum to less than the whole. Three edges, each silent: an idea that earned nothing is `share: 1, hasWork: false`, because zero over zero is not zero and a protostar is not a remnant (the BV2.R19 distinction); an unreadable removal port gives `share: null, attributable: false`, because 'could not look' is not 'nothing was removed'; and a CONFIRMED removal naming no target dims nothing at all — brightness cannot know which idea — so `countUnattributedConfirmed()` exists to say the gap out loud instead of quietly brightening the sky. Brightness lives in `economy` beside size and reaches lifecycle through the new `lifecycle.removals` port, resolved OPTIONALLY and NOT declared in `consumes` (declaring it would turn 'lifecycle off' into 'instance will not start' — the `ideas.descent` precedent). **No credit is clawed back and nothing here writes**: ADR 0313 stands, `shipped` is terminal, only the picture changes. Rejected: parsing the proposal body (ADR 0319 already refused it — a human-facing line shape fails silently when reworded); re-deriving at verdict time; treating `ship_task_id` as the removed task; counting tasks rather than payouts; clamping the share at the top, which would hide the anomaly it claims to prevent.](0321-brightness-is-a-weighted-share-and-the-targets-are-a-row.md) | ideas / economy |
 | 0322 | [**The five states are derived once, and a remnant needs evidence** ([task 1004103](https://cloudbongos.com/builders#/task/1004103), goal 1000095 — BONGOS-V2). The ideator surface draws a thought as one of five objects — star, protostar, satellite, remnant, cold body — and three surfaces are about to draw them (the room, the descent, the sky). Every fact already existed: `idea_inbox.status` (`core_195`), [ADR 0321](0321-brightness-is-a-weighted-share-and-the-targets-are-a-row.md)’s `hasWork` / `share` / `attributable`, and `tasks.goal_id` + `tasks.status`. What was missing was ONE place that reads them: a state inferred in three renderers is three states, and the sky can say a thought went out while the room beside it still calls it alive, with nothing erroring. **Decision:** one pure resolver (`modules/ideas/idea-state.js`), brightness exposed on the `reward` port (ideas may not reach `credit_log` any other way — [ADR 0083](0083-modular-architecture-strangler-build-plan.md) rule 1 — and already declares `reward` in `consumes`), and the ORDER of the tests IS the decision. **MERGED wins over everything:** a folded thought keeps its own money (`trail-size.js` is emphatic) but is no longer its own point in the sky, so letting work win draws one idea twice, beside the thought that absorbed it. **WORK beats a DISCARD:** a cold body “never ignited, so it has no size at all” is a stated PROPERTY, and testing work first makes it true by construction — triage really can discard a duplicate whose twin already routed and paid, and `updateIdea` never touches the ledger. **A REMNANT needs EVIDENCE, never the absence of an answer:** `share: 0` is a confirmed removal, `share: null` is an unreadable one, and ADR 0321 pays for that distinction upstream — so an idea with work and no readable facts is a STAR carrying `attributable: false`, because reading a falsy share as death turns one unmounted module into a sky of hollow rings. **A PROTOSTAR is the absence of WORK, not of a status:** ignition is being PAID for something, so a promoted-but-unshipped idea is still unignited, which is exactly what the nod queue exists for. **Position is a second axis** (`well` / `open-space` / `awaitingNod`) because the design says the object alone cannot carry it, and the nod is asked of EVERY task, not only the one that named the well. **`suggested_goal_id` is deliberately NOT a well** — `projection.js` records it as strictly advisory, the routing hint on a filing that did not convert, so reading it would put a thought in a nod queue with no task to promote; the binding `tasks.goal_id` now rides on both of the trail’s task joins at no extra round trip. The page reads the ledger ONCE: the state attach hands economy back the `byTask` breakdown size just computed, all of them or none (a partial map reads a missing entry as “no work” and draws a paid star as a protostar). An absent `reward` port does not empty the sky — states still resolve, flagged unattributable. Nothing writes; ADR 0313 stands. Rejected: resolving in each renderer; deriving from `share` alone (it merges a protostar with a remnant, the exact BV2.R19 distinction); treating an unreadable share as zero; status-first ordering; reading the hint as a home; a sixth object for “unknown brightness” (the vocabulary is the owner’s and is five — the uncertainty is a flag on the answer, not a new thing in the sky).](0322-a-remnant-needs-evidence-and-merged-wins.md) | ideas / economy |
 | 0323 | [**Hosting is three shapes, and we are not the landlord** ([task 1004140](https://cloudbongos.com/builders#/task/1004140), goal 1000106 — BONGOS-V2). Five projects ran as one Node process each on the control-plane droplet, about $0.80/month apiece — the cheapest arrangement available, bought with ~4,600 lines of `provision*.js` that write systemd units, create unix accounts, render Caddy snippets, `createdb`, install backup timers and count memory against a ceiling. That is the cost nobody priced: **we are a landlord.** The owner reframed the question — build on what others maintain, and let an owner keep the deployment platform they already use. **Seven decisions.** The shapes become `byo-host` (the owner runs it), `cloud-host` (we stand it up for them) and `dedicated-cloud-host` (the same path, larger plan); `co-tenant` is **retired, not renamed**, because it means *a process on our box from our checkout* — the opposite of bring-your-own-host, so reusing the name would make every existing comment lie. **DigitalOcean hosts hubs only**, which closes [ADR 0145](0145-free-hosted-project-tier-isolation-and-domain-separation.md) Finding 1 by removing its precondition rather than hardening the cookie: with no customer code on a `cloudbongos.com` subdomain there is no tenant to receive the hub session. **Render is the default** — its Postgres carries PITR and automated backups on every paid tier; Fly's managed Postgres starts ~$38/mo and Railway's is explicitly unmanaged, which is the exact responsibility being shed. **Cloudflare is the front door, not the compute**: Workers is a V8-isolate runtime that would require rewriting Express and `pg`, and Containers is built for bursty workloads that sleep, which a hall with background sweeps and a live event stream does not survive. **No deployment-platform adapter is built at all** — their application already deploys itself from the repository, so the platform we do not talk to is the platform we do not have to add. **Secrets: the platform is the system of record and Bongos stores names, never values** — a manifest of name, purpose and environment, no application secret, no platform API token, no "is it set?" probe, because each of those makes us custodian of other companies' credentials for convenience the manifest already delivers; `byo-host` marks the manifest unverifiable rather than opening an exception. **The free tier becomes a capped trial**, since ~$14/project cannot be subsidised indefinitely. Per-project cost rises ~17×, which is the price of not being a landlord and the reason metering stops being deferred work. Mostly a DELETION: [ADR 0306](0306-instance-supervision-is-a-seam-with-systemd-as-the-default.md)'s supervision seam is not extended (Render supervises its own processes), [ADR 0285](0285-a-shared-box-holds-about-twelve-projects-per-gb-and-memory-is-the-wall.md) stays true and stops being load-bearing with its queued resize held rather than spent, and the hub's offsite backup becomes the highest-consequence open item. Rejected: AWS/GCP (2–3× the cost for a bare instance, plus an IAM and billing surface to learn — maintenance added where the goal is to remove it); keeping the shared box and fixing only the cookie (cheaper, closes the finding, leaves the landlord runner and answers nothing else); a Vercel/Netlify/Render adapter layer (speculative pluggability); Bongos as the secrets vault pushing values through platform APIs.](0323-hosting-is-three-shapes-and-we-are-not-the-landlord.md) | hosting / provisioning / cost |
+| 0324 | [**The public npm CLI channel is retired** ([task 1004144](https://cloudbongos.com/builders#/task/1004144), goal 1000091 — BONGOS-V2). The owner deleted `@cloudbongos/cli` from the registry on 2026-09-22 (`npm view` → E404; the `@cloudbongos` scope is empty). This supersedes [ADR 0258](0258-the-public-cli-is-a-generated-client-package-not-the-published-core.md) and [ADR 0292](0292-both-install-paths-stay-and-vendoring-is-the-production-one.md) §2 — the latter titled "`@cloudbongos/cli` STAYS, on a new justification" and written *because* task 1003872 proposed removing it once the public core flip dissolved its original reason. 0292's measured argument (~0.5 MB front door vs a 46 MB core pull to print a task list) is still true and is NOT what changed; the owner's decision about carrying a public channel at all is. `scripts/gds/build-cli-package.js` + `tests/cli_package.mjs` are deleted, no doc offers `npx @cloudbongos/cli`, and the way in is the hall at `<origin>/builders` or a checkout. The COMPILED binary channel (`build-bongos.js` → `/downloads/bongos/*` via `config/bongos-cli.json`) is a different artifact and is untouched — the same near-twin task 1003889 warned about. Three tests used the package's FILES manifest as a stand-in for "what a terminal user can run" and now read `bin/bongos.js`'s verb table, which is what that set always meant.](0324-the-public-npm-cli-channel-is-retired.md) | distribution / CLI |

package/docs/file-map.md

@@ -174,7 +174,6 @@
 │       ├── ship.js              ← resolve claim as shipped, award credits (`/builder-ship`); also uploads a secret-scrubbed session digest to the corpus (6D.1, ADR 0027); on a dev box runs the sandbox-first review gate before resolving (#927, ADR 0046)
 │       ├── ship-visual.js       ← the OPTIONAL `--visual <image> [--visual-alt "…"]` leg of a ship (task 1003109): screens the file BEFORE the claim resolves (bad input costs no claim), uploads it AFTER (a failed picture never fails a ship)
 │       ├── package-core.js      ← package the core as a versioned, installable artifact + pin manifest (`bongos package-core`; R84, ADR 0100 §1, [#1688](https://example.com/builders#/task/1688)): isPublishable() selection + mirror redaction + fail-closed no-leak gate → dist/bongos-core-<version>.{tgz,manifest.json}; version = src/module-api CORE_VERSION. Recipe: docs/recipes/packaging-the-core.md
-│       ├── build-cli-package.js ← generate the PUBLIC, client-only `@cloudbongos/cli` npm package from this repo (task 1003679, ADR 0258): declared FILES manifest (no server/routes/auth/pool/provisioning) + generated dispatcher, README and package.json whose `files` array is DERIVED from the manifest; refuses to emit on a relative `import()` the manifest omits, and on a redaction hit (non-loopback IPv4, token/key shapes, instance domains + owner login read from config/branding.json). Sibling of package-core.js, opposite audience: that one packages the private core for an instance, this one packages the client surface for the public. Proven by tests/cli_package.mjs, which installs the packed tarball into an empty dir and runs every verb. `npm publish` is the OWNER's step, never a builder's → dist/cloudbongos-cli/
 │       ├── surface.js         ← who the CLI output is FOR: agent (default) or terminal (task 1003680). The `bongos` dispatcher sets BONGOS_SURFACE=terminal when a person types a verb; the skills and the card hook run `node scripts/gds/<verb>.js` directly and keep the agent card byte-identical. Never inferred from isTTY — a session's stdout is not a TTY either, so sniffing would invert it. Helpers: action() (/builder-ship N vs bongos ship N), taskRef(), strong()/em()/code(), table() (markdown vs aligned columns). Guarded by tests/cli_surface.mjs
 │       ├── sandbox-stage.js     ← stage the working tree on the live game preview (box OR local) for browser review before ship; resolvePreviewContext picks the context (`/builder-stage`; #927, ADR 0046; local: task 1056)
 │       ├── local-preview.js     ← builder CLI for the LOCAL sandbox: start/stop/status/restart/logs/url of the game-only preview at http://localhost:3100 (`npm run preview`; task 1056)

package/docs/module-api-changelog.md

@@ -2370,5 +2370,7 @@ is load-bearing: the script throws rather than guess if it is missing, and
         landed since 1.19.946 with no explicit bump. run 35671409094. (task 1002620)
   1.19.948 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
         landed since 1.19.947 with no explicit bump. run 35671807404. (task 1002620)
+  1.19.949 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
+        landed since 1.19.948 with no explicit bump. run 35675336642. (task 1002620)
 ---------------------------------------------------------------------------
 ```

package/docs/recipes/windows-builders.md

@@ -220,7 +220,7 @@ caught a real bug during task 1003548, so read its assertion before blaming the
 ## Four Windows traps that make a test lie — all four found in one pass (task 1003529)
 
 Four of the suites that pass turned green came back to **real product bugs, not test noise** —
-including `build-cli-package.js`, which could not build at all on Windows. When a suite fails only
+including the since-retired `build-cli-package.js` (ADR 0324), which could not build at all on Windows. When a suite fails only
 here, suspect these before assuming the platform is at fault:
 
 - **`fs.realpathSync` does NOT expand 8.3 short names; `fs.realpathSync.native` does.** Where TEMP
@@ -231,7 +231,7 @@ here, suspect these before assuming the platform is at fault:
 - **A REPO-relative path must be POSIX on every platform** — it goes into a task's `touches[]`, a
   version row, or a generated manifest. `path.join`/`path.relative` emit `\` here. Use
   `path.posix.*`, or the house spelling `.split(path.sep).join('/')`. This was the bug in
-  `version-close.js`, the Figma adapter and `build-cli-package.js`; the giveaway is a function
+  `version-close.js` and the Figma adapter; the giveaway is a function
   whose own fallback branch hard-codes `/`.
 - **Node 24 refuses to spawn a `.cmd`**: bare `npm` is `ENOENT` and `npm.cmd` is `EINVAL` (the
   CVE-2024-27980 mitigation), both surfacing as an inscrutable `null !== 0` from `spawnSync`.

package/modules/lifecycle/criterion-ref.js

@@ -3,8 +3,8 @@
 //
 // WHY THIS FILE EXISTS. `parseCriterionRef` lived inside db-deps-criteria.js,
 // which requires ../../src/module-api and therefore a database pool. The read
-// side — scripts/gds/status.js, which is public, unauthenticated, and shipped in
-// the @cloudbongos/cli package with no server present — could not require it, so
+// side — scripts/gds/status.js, which is public and unauthenticated — could not
+// require it, so
 // it grew its own parser: `Number(ref.slice(1))`, positional only. The system
 // ended up PRINTING an identifier its own write path refuses as unsafe, because
 // the two sides never shared a definition of what a ref is. Carving the pure

package/modules/lifecycle/db-deps-criteria.js

@@ -282,8 +282,7 @@ async function removeDependency(fromKind, fromId, toKind, toId) {
 //
 // The DEFINITION lives in ./criterion-ref.js, which requires nothing at all —
 // because the READ side needs the same vocabulary and cannot pay for a pool.
-// scripts/gds/status.js is public, unauthenticated and shipped inside the
-// server-free @cloudbongos/cli, so while this classifier sat behind
+// scripts/gds/status.js is public and unauthenticated, so while this classifier sat behind
 // ../../src/module-api it was unreachable from there and the CLI grew its own
 // positional-only parser (`Number(ref.slice(1))`). The system ended up PRINTING
 // and REQUIRING the very ref shape resolveCriterionIds below refuses as unsafe

package/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@bongos/core",
-  "version": "1.19.948",
+  "version": "1.19.949",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@bongos/core",
-      "version": "1.19.948",
+      "version": "1.19.949",
       "license": "AGPL-3.0-or-later",
       "dependencies": {
         "express": "^4.21.2",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bongos/core",
-  "version": "1.19.948",
+  "version": "1.19.949",
   "description": "Cloud Bongos — the AI-first build platform core (GDS + platform surfaces + module system), installed as a versioned dependency (ADR 0108).",
   "license": "AGPL-3.0-or-later",
   "main": "src/platform-server.js",

package/scripts/gds/cli-lib.js

@@ -272,7 +272,8 @@ async function loadSession() {
 //
 // WHY A FIXED ANCHOR. configHome() is brand-derived, and the brand is read out of whatever checkout
 // the process is standing in. That gave the CLI exactly one session slot, and the slot MOVED: run
-// standalone (the public @cloudbongos/cli's whole situation) the brand cannot resolve, so every
+// standalone (the then-public @cloudbongos/cli's whole situation; ADR 0324 retired it) the brand
+// cannot resolve, so every
 // instance shared one gds-session.json and signing into a second DESTROYED the first; run from
 // inside an instance repo and the session landed in ~/.config/<slug>/ where the standalone CLI
 // could never find it. The owner's own config dir carries a hand-made `hermeslines-clobber` backup

package/scripts/gds/gen-api-client.js

@@ -394,8 +394,8 @@ function renderPackageJson(spec) {
     // updated while the API it is generated FROM moved 500+ core versions. It had zero consumers
     // the whole time: nothing across the core or any instance repo ever declared it as a
     // dependency — every consumer VENDORS a copy instead. That was two places when this was
-    // written; task 1003891 deleted the Dev Box Electron app, so build-cli-package.js vendoring
-    // it into @cloudbongos/cli (which could not depend on it anyway) is now the only one. The
+    // written; task 1003891 deleted the Dev Box Electron app and ADR 0324 retired
+    // @cloudbongos/cli, so there is now no vendoring consumer left at all. The
     // owner removed it from the registry on 2026-09-09.
     //
     // The manifest itself stays: `main`/`types`/`exports` are what make the vendored copy and a

package/scripts/gds/release.js

@@ -22,11 +22,13 @@ const { plainCardLines } = require('./plain-cards');
 // string. (Found by the grader on this task, and it was right: the first cut
 // interpolated the path into a shell string.)
 //
-// Kept local rather than imported from ship-git.js on purpose: release.js ships
-// in the PUBLIC client-only @cloudbongos/cli package, and nothing in the ship-*
-// family is in that manifest. tests/cli_package.mjs installs the tarball and RUNS
-// every verb, so an import from outside it is a crash at require time, not a
-// lint-level nit — that is exactly how this file broke once already.
+// Kept local rather than imported from ship-git.js. The original reason was that
+// release.js shipped in the public @cloudbongos/cli package, which carried no ship-*
+// file, so an import from that family crashed at require time — that is how this file
+// broke once already. That package was retired (ADR 0324), so the constraint is no
+// longer enforced by anything; the duplication is left as-is rather than quietly
+// re-coupled inside a packaging change. Re-joining them is now a free choice, not a
+// forbidden one.
 function gitAt(args, cwd) {
   try {
     return execFileSync('git', args, { cwd, encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] }).trim();

package/src/module-api.js

@@ -71,7 +71,7 @@ const { responsibilityFor, ROLE_RESPONSIBILITIES } = require('./role-responsibil
 // there. scripts/gds/bump-version.js still rewrites the literal below; it appends
 // the entry to that file. Look for a version's history there, not here.
 // ---------------------------------------------------------------------------
-const CORE_VERSION = '1.19.948'; // CI auto-patch carrier (ADR 0161); changelog: docs/module-api-changelog.md
+const CORE_VERSION = '1.19.949'; // CI auto-patch carrier (ADR 0161); changelog: docs/module-api-changelog.md
 
 // A namespaced logger so a module's log lines are attributable + consistent.
 // Usage: const log = api.logger('dev-box'); log.info('mounted');

package/tests/cli_surface.mjs

@@ -132,9 +132,8 @@ test('only the dispatchers declare the terminal surface', () => {
   assert.ok(execLine, 'could not find the exec spawn');
   assert.ok(!execLine.includes('BONGOS_SURFACE'), '`bongos exec` must stay on the agent surface');
 
-  const builder = fs.readFileSync(path.join(REPO_ROOT, 'scripts', 'gds', 'build-cli-package.js'), 'utf8');
-  assert.match(builder, /BONGOS_SURFACE: 'terminal'/, 'the generated dispatcher must mark spawns as terminal');
-  assert.match(builder, /'scripts\/gds\/surface\.js'/, 'surface.js must ship in the package');
+  // The generated public dispatcher was asserted here too; @cloudbongos/cli was retired
+  // (task 1004144), so bin/bongos.js above is now the only dispatcher there is.
 });
 
 test('the skills still invoke the scripts directly, which is what keeps agents on the agent surface', () => {
@@ -154,13 +153,27 @@ test('the skills still invoke the scripts directly, which is what keeps agents o
 import { spawnSync } from 'node:child_process';
 import fs from 'node:fs';
 
-// Every .js the public package ships, read out of the build manifest so a newly-shipped script
-// is covered the day it is added rather than the day someone remembers to list it here.
+// Every script a TERMINAL reader can actually invoke, read out of bin/bongos.js's verb
+// table so a newly-added verb is covered the day it lands.
+//
+// This used to read the FILES manifest of scripts/gds/build-cli-package.js. That package
+// (@cloudbongos/cli) was retired with the manifest (task 1004144), but the rule it fed
+// did not go with it: a script that prints a `/builder-*` slash command to someone in a
+// terminal is telling them to run something they do not have.
+//
+// The verb table is the right heir, not `readdirSync` of scripts/gds/. What made the old
+// set meaningful was never "these files were published" — it was "a terminal user can
+// reach these", and the dispatcher's VERBS is exactly that set today. Scanning the whole
+// directory instead looks stricter and is actually a different test: it immediately
+// flagged six scripts (backfill-sessions, box-auth-check, box, local-preview,
+// sandbox-stage, ship-flow) that no terminal reader can invoke, which is six unrelated
+// findings imported into a packaging task rather than a stronger guard.
 function shippedScripts() {
-  const src = fs.readFileSync(path.join(REPO_ROOT, 'scripts', 'gds', 'build-cli-package.js'), 'utf8');
-  const block = src.match(/const FILES = \[([\s\S]*?)\n\];/);
-  assert.ok(block, 'could not read the FILES manifest out of build-cli-package.js');
-  return [...block[1].matchAll(/'([^']+\.js)'/g)].map((m) => m[1]);
+  const src = fs.readFileSync(path.join(REPO_ROOT, 'bin', 'bongos.js'), 'utf8');
+  const out = [...new Set([...src.matchAll(/script:\s*'([A-Za-z0-9._-]+\.js)'/g)].map((m) => `scripts/gds/${m[1]}`))].sort();
+  // A scan that matches nothing passes every assertion below for free.
+  assert.ok(out.length > 10, `only ${out.length} verb script(s) found in bin/bongos.js — the scan is reading the wrong shape`);
+  return out;
 }
 
 // Run one cli-lib guidance printer in a child process (they all call process.exit) and return

package/tests/home_isolation_guard.mjs

@@ -86,10 +86,13 @@ test('every allowlisted file exists and still means HOME differently', () => {
   }
 });
 
-test('the two sites this task fixed are actually fixed', () => {
-  const src = readFileSync(path.join(REPO_ROOT, 'tests', 'cli_package.mjs'), 'utf8');
-  assert.deepEqual(offendingLines(src), []);
-  assert.match(src, /USERPROFILE/, 'cli_package must set USERPROFILE alongside HOME');
+// Task 1003763 fixed TWO sites. tests/cli_package.mjs was the other one; it was deleted
+// with the @cloudbongos/cli package it tested (ADR 0324), so only the surviving site is
+// pinned here. The rule itself is unchanged — a test that points HOME at a sandbox
+// without also setting USERPROFILE isolates nothing on win32 — and the allowlist test
+// above still watches every other file that touches HOME.
+test('the site this task fixed is actually fixed', () => {
   const surface = readFileSync(path.join(REPO_ROOT, 'tests', 'cli_surface.mjs'), 'utf8');
+  assert.match(surface, /HOME/, 'cli_surface no longer sets HOME — this guard is watching the wrong file');
   assert.deepEqual(offendingLines(surface), []);
 });

package/tests/main_worktree_busy_reason.mjs

@@ -150,18 +150,10 @@ t('release.js never interpolates a path into a git command string', () => {
   assert.ok(src.length > 500, `comment-stripping left only ${src.length} chars — the scan is reading nothing`);
 });
 
-t('release.js imports nothing outside the published CLI package', () => {
-  const src = readFileSync(path.join(ROOT, 'scripts', 'gds', 'release.js'), 'utf8');
-  const manifest = readFileSync(path.join(ROOT, 'scripts', 'gds', 'build-cli-package.js'), 'utf8');
-  const locals = [...src.matchAll(/require\('\.\/([A-Za-z0-9._-]+)'\)/g)].map((m) => m[1]);
-  assert.ok(locals.length > 0, 'no local requires found — this guard is reading the wrong shape');
-  for (const name of locals) {
-    const file = name.endsWith('.js') ? name : `${name}.js`;
-    assert.ok(manifest.includes(`scripts/gds/${file}`),
-      `release.js requires ./${name}, which is not in the CLI package FILES list — `
-      + '`bongos release` would crash at require time in the published package (it did once already)');
-  }
-});
+// A test here asserted release.js imported nothing outside the published CLI
+// package's FILES manifest. @cloudbongos/cli was retired (task 1004144), so there
+// is no manifest to be outside of.
 
 console.log(`\nmain_worktree_busy_reason: ${passed} passed, ${failed} failed`);
 process.exit(failed === 0 ? 0 : 1);
+

package/tests/plain_cards.mjs

@@ -213,9 +213,9 @@ test('the four lifecycle skills tell the agent how to use the card', () => {
   assert.match(read('.claude/skills/builder-claim/SKILL.md'), /never look for a way round it/);
 });
 
-test('the public CLI package ships the card file its scripts require', () => {
-  assert.ok(read('scripts/gds/build-cli-package.js').includes("'scripts/gds/plain-cards.js'"));
-});
+// A test here asserted the public @cloudbongos/cli package shipped plain-cards.js.
+// That package was retired (task 1004144); there is no package to ship it in, and
+// the in-repo callers are covered by the wiring test above.
 
 console.log(`\nplain cards (task 1003989) tests: ${passed} passed, ${failed} failed`);
 process.exitCode = failed > 0 ? 1 : 0;