@bongos/core 1.20.81 → 1.20.83

package/.bongos-core.json

@@ -2,22 +2,22 @@
   "artifact": "bongos-core",
   "manifest_schema": 1,
   "generator": "scripts/gds/package-core.js",
-  "core_version": "1.20.81",
-  "core_contract": "1.20.81",
-  "source_commit": "d6ef4856972d5c5a7e7703bd45f01ec0849c069b",
+  "core_version": "1.20.83",
+  "core_contract": "1.20.83",
+  "source_commit": "980e604cbc632354d35c59435b102b7a3d89310f",
   "source_ref": "HEAD",
-  "built_at": "2026-10-01T21:27:07.217Z",
+  "built_at": "2026-10-01T22:31:25.403Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
     "docs_redacted": 576,
     "agent_docs_stubbed": 27,
-    "functional_verbatim": 2821,
+    "functional_verbatim": 2826,
     "rules": 3,
     "gate_literals": 3,
     "gate": "passed"
   },
-  "file_count": 3425,
-  "tree_sha256": "e444eb67a6df0ff7aab7c5fc7de0916bfb5354584eb6155046cfb3711dafafe8",
+  "file_count": 3430,
+  "tree_sha256": "d2ce3028f6211f9c9dd38c0961cd5268376abe20dacd81ecba630b90c3354a94",
   "files": [
     {
       "path": ".claude/skills/ask-for-help/SKILL.md",
@@ -317,12 +317,12 @@
     {
       "path": "clients/bongos-client/README.md",
       "mode": "0000644",
-      "sha256": "919544dc4b2def77506cb38e86ba7c15930f5b3624533eae69dfa73676c988b4"
+      "sha256": "1329cdc1c3ef977db985e17cf96f791e457191d35bad17e43238026a268cce41"
     },
     {
       "path": "clients/bongos-client/bongos-client.global.js",
       "mode": "0000644",
-      "sha256": "f543230e9d7773b8fb27bf843526eb5958155cf4186b42e8f5364a69f86f93c2"
+      "sha256": "3208c5a437ea5112801bd88a9884909c95dfbd27f6c52e455ec5a2086d46781e"
     },
     {
       "path": "clients/bongos-client/examples/hello-world.mjs",
@@ -332,17 +332,17 @@
     {
       "path": "clients/bongos-client/index.cjs",
       "mode": "0000644",
-      "sha256": "a5ee1df452885d8bd5b5ecc7d07722dd1f268bb45c7a16dcfe5eaa84aaa61928"
+      "sha256": "3c5dff19927becaaaf6687c23896820dfce87a4aa14c1645fa6cfc604ceb2804"
     },
     {
       "path": "clients/bongos-client/index.d.ts",
       "mode": "0000644",
-      "sha256": "43a2dc73f4181c3fbc42b53fde43f2be9570f6e9e373f7c9bb222ce8a26d1c18"
+      "sha256": "110465f8ef7d65c9c532d893f3d957f28b8aa8dcf227b61c9d44193a9c1b430e"
     },
     {
       "path": "clients/bongos-client/index.mjs",
       "mode": "0000644",
-      "sha256": "8665a05369948fe349d67287cec06207d03f498f88443db0b48ce5ebe88a8abe"
+      "sha256": "3043d6d324cef1b326124ff81b8ddfa021042670cd35044e48ef14d4da17febc"
     },
     {
       "path": "clients/bongos-client/package.json",
@@ -2277,12 +2277,12 @@
     {
       "path": "docs/api-reference.md",
       "mode": "0000644",
-      "sha256": "b7a163039e96c4740ce7baa236df8c9cd45349ff4f6e37e46a3dffcc62880072"
+      "sha256": "a647cda41191405e9d90bfec0ccdbe014372af2a154d49ad88901c8fcbd38e96"
     },
     {
       "path": "docs/api/openapi.json",
       "mode": "0000644",
-      "sha256": "2d32366fe6080f6f98e2b64c39d0b7e487f6b196e10666adf5439862628648ae"
+      "sha256": "e0fa3c6bd16797194d3f03d0e9dd06fa43f4ff1872f61da976b01377f6be471f"
     },
     {
       "path": "docs/architecture.md",
@@ -2307,12 +2307,12 @@
     {
       "path": "docs/copy-inventory.md",
       "mode": "0000644",
-      "sha256": "cdc3231ad0057ba261d9318c1ede6b6a2fa583ca16e951d2ca8a8569be107efc"
+      "sha256": "aba1ea9afb6b87635070b18355c1f4aa13aefcba6bc4859daae2be701231e1a7"
     },
     {
       "path": "docs/copy-registry.json",
       "mode": "0000644",
-      "sha256": "e032d7af3d98fb910bccc79fb8e48f370e11426240dc0346d30c8ed4be985ff6"
+      "sha256": "c7147962507d0dfd7e8df65eb39c465cf7925b836662f9245fcbc2649f3b6358"
     },
     {
       "path": "docs/design/apex-pass-2-direction.md",
@@ -2817,7 +2817,7 @@
     {
       "path": "docs/module-api-changelog.md",
       "mode": "0000644",
-      "sha256": "8881da2805ed000328ea89c9ee5ecab8c5c02636627590dde6e0545ea1e0dc9c"
+      "sha256": "b404ba3341028a75274dbb74618dfdfaa9b1c5ba13cd5ad127d20c8d9c6bd813"
     },
     {
       "path": "docs/modules-contract.md",
@@ -2907,7 +2907,7 @@
     {
       "path": "docs/page-readings.json",
       "mode": "0000644",
-      "sha256": "5494e8e64ce929e2f5e7be57e895718e9e398d5bc46832b6c61410853b5b30f7"
+      "sha256": "a1b858af582c178617ceddb6fb9ef3882cb038f3666b522bd4f61d1151a1cc00"
     },
     {
       "path": "docs/project-context.template.md",
@@ -4704,6 +4704,11 @@
       "mode": "0000644",
       "sha256": "71a5f0a524f31491d5d2160d5473667cf5826ab7f61c79d5d748b1ebe3d4d8dc"
     },
+    {
+      "path": "modules/economy/earnings.js",
+      "mode": "0000644",
+      "sha256": "81c8abcd71c4f4a31af8048e42d296a5ca1601062118fc3f684423f3208cc5a8"
+    },
     {
       "path": "modules/economy/idea-brightness.js",
       "mode": "0000644",
@@ -4727,7 +4732,7 @@
     {
       "path": "modules/economy/module.json",
       "mode": "0000644",
-      "sha256": "95928fdaff3a61ac6493b41e43d710a936eeb391170104ab7c29a5d41f542e00"
+      "sha256": "e36af77e91866ceefcf1d9e1d5e7cda9b85c20cf2b87b0673e3cca457c789ce8"
     },
     {
       "path": "modules/economy/policy.js",
@@ -4754,6 +4759,11 @@
       "mode": "0000644",
       "sha256": "e77f52c26e388ca208c61a1062d2e7fbce9d36c78047e23cf06b025e4355c6cb"
     },
+    {
+      "path": "modules/economy/routes/earnings.js",
+      "mode": "0000644",
+      "sha256": "836ca1e5dfeefa4a6f353368da36673e823fb2c4074b6ca5a0af278c9180f474"
+    },
     {
       "path": "modules/economy/routes/leaderboard.js",
       "mode": "0000644",
@@ -5462,17 +5472,17 @@
     {
       "path": "modules/hall-ui/public/gate.css",
       "mode": "0000644",
-      "sha256": "de3cf55f2243a24ce084aaa675979c8abf2e6a55196061e602ae27ce1e76e1b8"
+      "sha256": "2e59b94574717aa5d14754353c39f3fb78796fa45a95d95abbca7f66e0ae2913"
     },
     {
       "path": "modules/hall-ui/public/gate.html",
       "mode": "0000644",
-      "sha256": "1021d8c396e4c125d5ac64cfdb30b8728e86b5466dd8076103aebd7df8fa8591"
+      "sha256": "c6378b1b5600ac4039589ac618f67a11d3f711d46fae3996868357b4a280cd3c"
     },
     {
       "path": "modules/hall-ui/public/gate.js",
       "mode": "0000644",
-      "sha256": "a3ce7ef226cfda5475a00ec8cdde4c638238a851f2b50a8058f047f62b1bda05"
+      "sha256": "37bdd2e3773a13b7bb05782daa3e5837b4157d69b4cb4e0a8c908c363187abb6"
     },
     {
       "path": "modules/hall-ui/public/gate.states.json",
@@ -5777,7 +5787,7 @@
     {
       "path": "modules/hall-ui/public/profile-charts.js",
       "mode": "0000644",
-      "sha256": "456f477da6893e61f66778ea5cb6a15dc3c21ea4038f0a8184a4deca840f237c"
+      "sha256": "0150bc46d6a676c1b9eb9475f7193ae90360a1e4580440705c3a03a573def47d"
     },
     {
       "path": "modules/hall-ui/public/profile-connections.js",
@@ -5802,7 +5812,7 @@
     {
       "path": "modules/hall-ui/public/profile.css",
       "mode": "0000644",
-      "sha256": "2c320b6a22f7a047f33bb523032da3b671375cb5910df576cff30e70196539ce"
+      "sha256": "c60a49d74731ec615b1102a3f96d5c6ce3b208bcba7168c31898bd2c67338d21"
     },
     {
       "path": "modules/hall-ui/public/profile.html",
@@ -5812,12 +5822,12 @@
     {
       "path": "modules/hall-ui/public/profile.js",
       "mode": "0000644",
-      "sha256": "ba8fd7c2df7f46c9fd491c6666a159128b57b894bc09d74e3748c0c3185924a7"
+      "sha256": "60fd754839fb7f73434a8c894f810a807ef11f5f8dbc9a8e6a90bc846b451b11"
     },
     {
       "path": "modules/hall-ui/public/profile.states.json",
       "mode": "0000644",
-      "sha256": "82e6a2d240b504c667637254eb25ec14d7afe2d9e5137f4520d6c1b310be17a7"
+      "sha256": "aa4929777dace88179b256e16735c23e84450c06cbefd523aa65723f0bb1f0c1"
     },
     {
       "path": "modules/hall-ui/public/project-settings.css",
@@ -6247,7 +6257,7 @@
     {
       "path": "modules/hall-ui/records/profile-roles.md",
       "mode": "0000644",
-      "sha256": "0fb34cced8e81add68b5204108f07a912d12072d5036a28632c4feddcbfb9a97"
+      "sha256": "c28b5b3917a951c5ff3e4247283f91f500971988d297f172a1ed74af65d86777"
     },
     {
       "path": "modules/hall-ui/records/reading-rooms.md",
@@ -6587,7 +6597,7 @@
     {
       "path": "modules/lifecycle/db-goals.js",
       "mode": "0000644",
-      "sha256": "405501ea6a190c2c0f35daa813a5fc48ff236015cfa90d6e52e358cc834cdb30"
+      "sha256": "062bfd34829de884511622316fb733744998342a83c654a6a505e55d0d23725d"
     },
     {
       "path": "modules/lifecycle/db-grade.js",
@@ -6627,7 +6637,7 @@
     {
       "path": "modules/lifecycle/db-versions.js",
       "mode": "0000644",
-      "sha256": "fabce70430933abba2b984421d799555be53c86ef9770b0db88845e692486c9b"
+      "sha256": "7ffd6ca56a6621a933abf854589e836260cd749c6148a278542ab4ae89eb6b13"
     },
     {
       "path": "modules/lifecycle/db.js",
@@ -6647,7 +6657,7 @@
     {
       "path": "modules/lifecycle/done-when.js",
       "mode": "0000644",
-      "sha256": "9b97fc9a8aeea5d4e85e549ae3df9f9900ff28cda457d4c600f94adeef4261d3"
+      "sha256": "bd5dc2082f80376369596c6d8615f134e064dc8689085c31b57a9fd199ffd821"
     },
     {
       "path": "modules/lifecycle/est-advisory.js",
@@ -6684,6 +6694,11 @@
       "mode": "0000644",
       "sha256": "db3c71498cf0c6d8fae8ebab3084104e0d9f4e587472815eec75e48b24727720"
     },
+    {
+      "path": "modules/lifecycle/goal-close-sweep.js",
+      "mode": "0000644",
+      "sha256": "693e05cbe76e7f95da771bb3688b079b90107536506acb45756b8ded4d4d5c4d"
+    },
     {
       "path": "modules/lifecycle/goal-conflicts.js",
       "mode": "0000644",
@@ -7772,7 +7787,7 @@
     {
       "path": "modules/provisioning/app-status.js",
       "mode": "0000644",
-      "sha256": "bda32ab37371c6ae883a183abfc99a08ce4d7ce5efc7a43ad79135b18cec403d"
+      "sha256": "7a36a65ad9d0b54ab9793efc4da12f9ae50c10f7e2229f980d8c751bb8c2effa"
     },
     {
       "path": "modules/provisioning/capacity-gate.js",
@@ -8822,7 +8837,7 @@
     {
       "path": "modules/public-landing/public/projects.html",
       "mode": "0000644",
-      "sha256": "1f301433101482faa6ae2c7abfcd9314d73275bec22a7ed05da789758ce7a6e3"
+      "sha256": "c0bfb8fb21472d26b099f4374cf3f7abdca7f1517a669e3f9d3e66fb9d5ceb23"
     },
     {
       "path": "modules/public-landing/public/projects.probes.json",
@@ -9527,12 +9542,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "77e6e63c9ee13975c2c1df375edd00c8e859339c0fa77a125be648b753c644b0"
+      "sha256": "cf7fdf27d152b1b848b391c4faf64692b6f22afb3ead4a273de774ef3a996e67"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "46e0c2ecf8df6ffc59c6c576ad2aca62426a40000abda72ba235b4fbb93d6aeb"
+      "sha256": "dcfd94f662fbcece5bfa0fd1202eaadc8a439a08b30728b63473ab1ffb535531"
     },
     {
       "path": "public-docs/index.html",
@@ -9552,7 +9567,7 @@
     {
       "path": "release-notes.json",
       "mode": "0000644",
-      "sha256": "158aab8f18eee1f4a99de4fb60b5a1f1c320d8f6c1dd0cbc9ec66ac415231d66"
+      "sha256": "0fb50a613d2c0c5c5feba19216d13fb2811f168c3ab0f94f83a8353c37b60ada"
     },
     {
       "path": "scripts/bongos-mcp.js",
@@ -11302,7 +11317,7 @@
     {
       "path": "scripts/hall-preview/server.js",
       "mode": "0000644",
-      "sha256": "1d9a4b5f5692592e2a991c737e8fdf8474ded90dfed6275fc0517df45229392f"
+      "sha256": "88c7f4fed6a2e7b3dad1e3101290fcba19176ded996d40fef2c67e7f33a4e79d"
     },
     {
       "path": "scripts/hall-preview/task-visual.js",
@@ -11752,7 +11767,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "a48d485ffa452b86fe813cb612c23a372789056b9f424242cae7e5b09eb19c6a"
+      "sha256": "729dd2a3712dc8626174358db32d768a2e00f7349029021dcd37bf0f7db429db"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -12197,7 +12212,7 @@
     {
       "path": "tests/auto_satisfy_criteria.mjs",
       "mode": "0000644",
-      "sha256": "121d5d7458015f3a6337512b566fc303232f4f37e8622eb826d7496fc496acd2"
+      "sha256": "2ad1e7f9f3699f56ce3a6a5e97a312b99a20a20028d96742e9734ac19d801865"
     },
     {
       "path": "tests/autobongos_cadence.mjs",
@@ -12237,7 +12252,7 @@
     {
       "path": "tests/autonomy_builder_scope.mjs",
       "mode": "0000644",
-      "sha256": "083bd1cc9841b2c5d1487e72a31b9534db668bde790120112d53009537b26a64"
+      "sha256": "82595217140d807abb19ffac63ce36727fbde50b8de83e48a90d4032c87fede6"
     },
     {
       "path": "tests/autonomy_digest.mjs",
@@ -12247,7 +12262,7 @@
     {
       "path": "tests/autonomy_fence_priority.mjs",
       "mode": "0000644",
-      "sha256": "44fc7e49ab8da304df105bcb82d3e232504c813546836496fd40a92b9ecdcd51"
+      "sha256": "5bb8707d762967e77100e531fc8914f76d9401393ecbaa354beb31956a133c66"
     },
     {
       "path": "tests/autonomy_gate.mjs",
@@ -12267,7 +12282,7 @@
     {
       "path": "tests/autonomy_runner_identity.mjs",
       "mode": "0000644",
-      "sha256": "2bc963a47a41a90711bec4d23fef9e4a51203136f446a0abab272d78d2f6f6bf"
+      "sha256": "1c1c7b862d134033ef8cdfef8288f989be6a25c25dade657c5b57e4f1bd2c46c"
     },
     {
       "path": "tests/backfill_sessions.mjs",
@@ -12802,7 +12817,7 @@
     {
       "path": "tests/criterion_goal_attach.mjs",
       "mode": "0000644",
-      "sha256": "58a0685287cb34b1cad88d0b0d0024e801068f8a7f07f53702857076c554bcad"
+      "sha256": "6cf361f2ab0914a85b1c7556717c39802fa4c267a1d73fdaa5aee78d230ebcb5"
     },
     {
       "path": "tests/criterion_progress.mjs",
@@ -13389,10 +13404,15 @@
       "mode": "0000644",
       "sha256": "8d1f3511b8ecd0bb88f75a936ee29035d9f789a2be4f6aedabb46b9be5bd2385"
     },
+    {
+      "path": "tests/goal_close_cancels_requests.mjs",
+      "mode": "0000644",
+      "sha256": "c7b87edf2f93d718ebad4d0ba48dcdb7fb4e6611dbdb90a6c6c27b41c3ac55eb"
+    },
     {
       "path": "tests/goal_closure_invariants.mjs",
       "mode": "0000644",
-      "sha256": "e5f937b9ce3264b6b4bb3a9ca57fa000b2190fe49c3ba6d70acdd9d26f55423c"
+      "sha256": "d14224d4b727e646cbd73d02b3dcab85694021f439af99401aefd5e84a4164cc"
     },
     {
       "path": "tests/goal_conflicts.mjs",
@@ -14007,7 +14027,7 @@
     {
       "path": "tests/hall_profile_world.mjs",
       "mode": "0000644",
-      "sha256": "ee65158c22b2f2a7011b6e1336f7c2d70f8fc5913621a5c9bcbda5bddbc1e4bd"
+      "sha256": "52df6f29c1eee5eac825b54e9b55021be0832ee702c999fabf3a2b366b22e86b"
     },
     {
       "path": "tests/hall_reading_world.mjs",
@@ -15304,6 +15324,11 @@
       "mode": "0000644",
       "sha256": "566e7a937337f753d45f32e1cdc8b1c63e76ab2bfadedfde46c669cddad543a0"
     },
+    {
+      "path": "tests/profile_earnings.mjs",
+      "mode": "0000644",
+      "sha256": "f6d853c7c9d75027fb7f64cba76242726a68f69be8d0a3501d4b80d8b6ee32a3"
+    },
     {
       "path": "tests/profile_fields.mjs",
       "mode": "0000644",
@@ -15447,7 +15472,7 @@
     {
       "path": "tests/projects_hub_app_status.mjs",
       "mode": "0000644",
-      "sha256": "7502f3b5ad3a77ff5134875d4de0e9e76c82b956b12c22a52f32854df33ba778"
+      "sha256": "b1431ce48bddac224fe1cfa56bb3e0270634bd17d26a51091dd9319e3c9ea2ce"
     },
     {
       "path": "tests/projects_hub_app_step.mjs",
@@ -15562,7 +15587,7 @@
     {
       "path": "tests/provisioning_app_status.mjs",
       "mode": "0000644",
-      "sha256": "75d80e2400834591149a6cc94cfb299c10fa5b2db65bd94b40049ead0a70e9ad"
+      "sha256": "c580e4f5bf7b416ce72d57b0221f39beef77235ee5b939691f5b7f0c60522793"
     },
     {
       "path": "tests/provisioning_callback_page.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`)
-- 493 operations across 73 resource groups
+- 494 operations across 73 resource groups
 
 ## Use it from your project
 

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

@@ -221,6 +221,8 @@ function createClient(opts = {}) {
     "builders": {
       // GET /builders/{builderId}/credits — rank: metic+archon — GET /builders/:builderId/credits
       getBuildersBuilderIdCredits: (args) => request("GET", "/builders/{builderId}/credits", { hasBody: false }, args),
+      // GET /builders/{builderId}/earnings — rank: any-builder — GET /builders/:builderId/earnings
+      getBuildersBuilderIdEarnings: (args) => request("GET", "/builders/{builderId}/earnings", { hasBody: false }, args),
       // GET /builders/{id}/active-claims — rank: metic+archon — GET /builders/:id/active-claims
       getBuildersIdActiveClaims: (args) => request("GET", "/builders/{id}/active-claims", { hasBody: false }, args),
       // GET /builders/{id}/activity — rank: any-builder — GET /builders/:id/activity

package/clients/bongos-client/index.cjs

@@ -220,6 +220,8 @@ function createClient(opts = {}) {
     "builders": {
       // GET /builders/{builderId}/credits — rank: metic+archon — GET /builders/:builderId/credits
       getBuildersBuilderIdCredits: (args) => request("GET", "/builders/{builderId}/credits", { hasBody: false }, args),
+      // GET /builders/{builderId}/earnings — rank: any-builder — GET /builders/:builderId/earnings
+      getBuildersBuilderIdEarnings: (args) => request("GET", "/builders/{builderId}/earnings", { hasBody: false }, args),
       // GET /builders/{id}/active-claims — rank: metic+archon — GET /builders/:id/active-claims
       getBuildersIdActiveClaims: (args) => request("GET", "/builders/{id}/active-claims", { hasBody: false }, args),
       // GET /builders/{id}/activity — rank: any-builder — GET /builders/:id/activity

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

@@ -678,6 +678,8 @@ export interface BongosClient {
   "builders": {
     /** GET /builders/{builderId}/credits — rank: metic+archon */
     getBuildersBuilderIdCredits(args?: RequestArgs): Promise<ApiResponse>;
+    /** GET /builders/{builderId}/earnings — rank: any-builder */
+    getBuildersBuilderIdEarnings(args?: RequestArgs): Promise<ApiResponse>;
     /** GET /builders/{id}/active-claims — rank: metic+archon */
     getBuildersIdActiveClaims(args?: RequestArgs): Promise<GetBuildersIdActiveClaimsResponse>;
     /** GET /builders/{id}/activity — rank: any-builder */

package/clients/bongos-client/index.mjs

@@ -217,6 +217,8 @@ export function createClient(opts = {}) {
     "builders": {
       // GET /builders/{builderId}/credits — rank: metic+archon — GET /builders/:builderId/credits
       getBuildersBuilderIdCredits: (args) => request("GET", "/builders/{builderId}/credits", { hasBody: false }, args),
+      // GET /builders/{builderId}/earnings — rank: any-builder — GET /builders/:builderId/earnings
+      getBuildersBuilderIdEarnings: (args) => request("GET", "/builders/{builderId}/earnings", { hasBody: false }, args),
       // GET /builders/{id}/active-claims — rank: metic+archon — GET /builders/:id/active-claims
       getBuildersIdActiveClaims: (args) => request("GET", "/builders/{id}/active-claims", { hasBody: false }, args),
       // GET /builders/{id}/activity — rank: any-builder — GET /builders/:id/activity

package/docs/api/openapi.json

@@ -2869,6 +2869,51 @@
         ]
       }
     },
+    "/builders/{builderId}/earnings": {
+      "get": {
+        "operationId": "get_builders_builderId_earnings",
+        "tags": [
+          "builders"
+        ],
+        "summary": "GET /builders/:builderId/earnings",
+        "description": "any signed-in builder may read any builder's earnings by kind, as the profile's other signed-in sections are; a stranger gets the sign-in line. The param names the builder (`:builderId`), the credits route's convention, because this route deliberately reads someone else.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/economy/routes/earnings.js",
+        "parameters": [
+          {
+            "name": "builderId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Path parameter `builderId`."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success."
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/builders/{id}/active-claims": {
       "get": {
         "operationId": "get_builders_id_active_claims",
@@ -31547,7 +31592,7 @@
       "description": "A required dependency/feature is not configured or is temporarily down."
     }
   },
-  "x-endpoint-count": 493,
+  "x-endpoint-count": 494,
   "x-schema-count": 524,
   "x-undocumented-bodies": 12,
   "x-response-schemas": 349,

package/docs/api-reference.md

@@ -2,7 +2,7 @@
 
 # Bongos API reference
 
-> **Generated from the live route files** — the route file is authoritative. 493 endpoints across 91 route files.
+> **Generated from the live route files** — the route file is authoritative. 494 endpoints across 92 route files.
 > Machine-readable spec: [`docs/api/openapi.json`](api/openapi.json) (OpenAPI 3.1). Rendered docs site: **`/docs`** (e.g. `cloudbongos.com/docs`).
 
 Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust-boundary-server-enforced-permissions.md)): `public` < `any-builder` < `metic+archon` < `archon`.
@@ -122,11 +122,12 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 |---|---|---|---|---|
 | GET | `/api/bongos/bug-attachments/:name` | `any-builder` | — | GET /api/bongos/bug-attachments/:name — stream one stored image. |
 
-## `builders` (11)
+## `builders` (12)
 
 | Method | Path | Rank | Body | Description |
 |---|---|---|---|---|
 | GET | `/api/bongos/builders/:builderId/credits` | `metic+archon` | — | GET /builders/:builderId/credits — another builder's ledger. |
+| GET | `/api/bongos/builders/:builderId/earnings` | `any-builder` | — | any signed-in builder may read any builder's earnings by kind, as the profile's other signed-in sections are; a stranger gets the sign-in… |
 | GET | `/api/bongos/builders/:id/active-claims` | `metic+archon` | — | GET /builders/:id/active-claims — V3.R14 (task 238). |
 | GET | `/api/bongos/builders/:id/activity` | `any-builder` | — | GET /builders/:id/activity — the profile's PER-CRAFT activity log (task 1003281, goal 1000072, criterion legibility-activity-by-role). |
 | PATCH | `/api/bongos/builders/:id/budget` | `metic+archon` | `monthly_budget_usd` | PATCH /builders/:id/budget — set or clear a builder's monthly spend ceiling (V3.R84 task 302, criterion C3). |