@bongos/core 1.19.359 → 1.19.360

package/.bongos-core.json

@@ -2,22 +2,22 @@
   "artifact": "bongos-core",
   "manifest_schema": 1,
   "generator": "scripts/gds/package-core.js",
-  "core_version": "1.19.359",
-  "core_contract": "1.19.359",
-  "source_commit": "d23c36fb93e62c5c592d80daf5754eba2fc4dbf5",
+  "core_version": "1.19.360",
+  "core_contract": "1.19.360",
+  "source_commit": "5bf79048217d490a0d571e749290b110875a0bc8",
   "source_ref": "HEAD",
-  "built_at": "2026-08-25T17:25:50.103Z",
+  "built_at": "2026-08-25T17:58:51.325Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
     "docs_redacted": 330,
     "agent_docs_stubbed": 22,
-    "functional_verbatim": 1519,
+    "functional_verbatim": 1523,
     "rules": 3,
     "gate_literals": 3,
     "gate": "passed"
   },
-  "file_count": 1871,
-  "tree_sha256": "48c8596d49b7f313fede9fcbc4f31f0360ca18ba33d5f8dc26e92bb6344c1137",
+  "file_count": 1875,
+  "tree_sha256": "15871fd570e735b51bbfd212b53fcc55faa1479569e51e6d2c7179f407bb58d3",
   "files": [
     {
       "path": ".claude/skills/blocker-review/SKILL.md",
@@ -347,12 +347,12 @@
     {
       "path": "clients/bongos-client/README.md",
       "mode": "0000644",
-      "sha256": "a01f701244efc0295413af22c0d487a82ca64b281c6bfcc056a4c51d4987e448"
+      "sha256": "b94bec08062d2f3374043a6ce93bca31b27073e51da47f9477e67e2602565701"
     },
     {
       "path": "clients/bongos-client/bongos-client.global.js",
       "mode": "0000644",
-      "sha256": "0a4d72fef0cd507f9efa5725d292c6628caefec677da34223cdc987020a3fe32"
+      "sha256": "827ffa492b7035169b0734807208d45dc898d86b7d52570b55f7050d83e0aba3"
     },
     {
       "path": "clients/bongos-client/examples/hello-world.mjs",
@@ -362,17 +362,17 @@
     {
       "path": "clients/bongos-client/index.cjs",
       "mode": "0000644",
-      "sha256": "6815d5cf32acfc8efb36662f6518b2062bb407ca7f7421dc7fb28b569c433d8b"
+      "sha256": "7f601b37bb8acad773f55b5e5200cf1efeb40cdcc2694570b58c336cdcf9b3ad"
     },
     {
       "path": "clients/bongos-client/index.d.ts",
       "mode": "0000644",
-      "sha256": "e1f023e1b393626dd766c7869e64462e599f804773b86d658ee00bfc8634d2ca"
+      "sha256": "3834aed054469417cecbd8c1786cbc5400ec1a0e7871ac3bc41c8044f2f97aae"
     },
     {
       "path": "clients/bongos-client/index.mjs",
       "mode": "0000644",
-      "sha256": "6976836ffb9248c63961cca978c4cb8c1980fa41a820e0a6e99a1339c59aa051"
+      "sha256": "d3f455fe0a335606c10ec92fc151f4767bf37d9c40c423f7635c642dd5b1e298"
     },
     {
       "path": "clients/bongos-client/package.json",
@@ -1452,12 +1452,12 @@
     {
       "path": "docs/api-reference.md",
       "mode": "0000644",
-      "sha256": "d9a54ab07b19d3b9f6ba0cf2a22c14928c0b32b5b1939c42847cbe3caa6b6e00"
+      "sha256": "d076deeab4cc5690b2fd8081b3ea885d2e6c414267ff4cacb43d71e9b3d92d8c"
     },
     {
       "path": "docs/api/openapi.json",
       "mode": "0000644",
-      "sha256": "8748278cc36ace3f8b5b7690ec38307a044f31fbf4a3a675b0425d979c3c2223"
+      "sha256": "88484f046d52c6ff605fbecd5c32d14542279f487586b8c371de3ce6de50e812"
     },
     {
       "path": "docs/architecture.md",
@@ -2877,7 +2877,7 @@
     {
       "path": "modules/dev-box/app/src/vendor/bongos-client.cjs",
       "mode": "0000644",
-      "sha256": "6815d5cf32acfc8efb36662f6518b2062bb407ca7f7421dc7fb28b569c433d8b"
+      "sha256": "7f601b37bb8acad773f55b5e5200cf1efeb40cdcc2694570b58c336cdcf9b3ad"
     },
     {
       "path": "modules/dev-box/app/test/unit.mjs",
@@ -3934,6 +3934,16 @@
       "mode": "0000644",
       "sha256": "3586cc2aa07913870ad99073c534e70ef2e2c5ff6a5ef2ddeb141cfd397269cd"
     },
+    {
+      "path": "modules/lifecycle/closeness-weights.json",
+      "mode": "0000644",
+      "sha256": "76d285de14e43744c5b74fc26c60c48bfc329c297f9b682eaf8abfa69866bc72"
+    },
+    {
+      "path": "modules/lifecycle/closeness.js",
+      "mode": "0000644",
+      "sha256": "f5668020c115a6d356a74603dc4a7229ddfdb8d5015a22f871a35386a869fe58"
+    },
     {
       "path": "modules/lifecycle/conflict-resolve.js",
       "mode": "0000644",
@@ -4097,7 +4107,7 @@
     {
       "path": "modules/lifecycle/module.json",
       "mode": "0000644",
-      "sha256": "0734a4bf5c63eb1a09c38506fb796d8d0c4e6c032536c1b026a8e65b37d21794"
+      "sha256": "30653b4064be8933894679ac4e272711edcc629e151d87017e2b2e45be96d78f"
     },
     {
       "path": "modules/lifecycle/pollers/publish-reconciler.js",
@@ -4119,6 +4129,11 @@
       "mode": "0000644",
       "sha256": "fb5dda00e0c378e2fb8b3190fdeaf4562be65097895bd67b68e67428a14c8297"
     },
+    {
+      "path": "modules/lifecycle/routes/closeness.js",
+      "mode": "0000644",
+      "sha256": "1950ba9d20f925fa1ecbe7fb37d35a5b80045c556c6f76caa90b82e213b7db88"
+    },
     {
       "path": "modules/lifecycle/routes/dependencies.js",
       "mode": "0000644",
@@ -4397,7 +4412,7 @@
     {
       "path": "modules/platform-identity/platform-identity.js",
       "mode": "0000644",
-      "sha256": "a563fb701e62d665d10baf25761f9341678264fa2c6c73f1efeb9eb20ba6a439"
+      "sha256": "8e51d1b28d33534e04dffd0ac139aecb85b9f2a8e1c5a0adbd2847893b650f24"
     },
     {
       "path": "modules/platform-identity/pollers/code-sweep.js",
@@ -4437,7 +4452,7 @@
     {
       "path": "modules/platform-identity/routes/sso.js",
       "mode": "0000644",
-      "sha256": "9b86c847d2b014fb9929fb655097496d6226c0cd1507c6fdf5ffdd2da6f84eb9"
+      "sha256": "68f2b69706f30de35c94749e8733a00da2737ecad37e93ea4965c7a45a6d7e5b"
     },
     {
       "path": "modules/platform-identity/tests/platform-identity.mjs",
@@ -4832,12 +4847,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "e06a1a0d00dd8df697613e06d1806ceb797716c292debd219fe8f0b3a3c896cd"
+      "sha256": "26d9ebcd21d9fa6f7634d877e028131c6beb6e144d3055645e159d81e94c64a3"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "f47e3cf3c97d4ab16fb5fa4cdf59fe3fd20c350114dc587122cc1f5ec5bb9842"
+      "sha256": "2f3161d67426337fc350354987df123ccc867ebbb15ae4bf28e3082f80edbdcd"
     },
     {
       "path": "public-docs/index.html",
@@ -6697,7 +6712,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "0c94e1d2f36bff1e43423ae82fadcd6dbb2013368a3ae1dbba860e486ae7c4a1"
+      "sha256": "4cb8b8e962fd1891d9fbbb446048dba025754a73b1a3c313e2e586f14f843b13"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -7219,6 +7234,11 @@
       "mode": "0000644",
       "sha256": "6cc4e7e38c26ff13644e714dd4bf76bfe0fbde984df9fd37f6b1695ae990a569"
     },
+    {
+      "path": "tests/closeness.mjs",
+      "mode": "0000644",
+      "sha256": "b5c4791d84aa3126714c7b3188320dc4df984e282a086196ded2394f825295d1"
+    },
     {
       "path": "tests/cloud_bongos_pack.mjs",
       "mode": "0000644",

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`)
-- 312 operations across 50 resource groups
+- 315 operations across 51 resource groups
 
 ## Install
 

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

@@ -252,6 +252,14 @@ function createClient(opts = {}) {
       // POST /claims/batch/validate — rank: any-builder — POST /claims/batch/validate
       postClaimsBatchValidate: (args) => request("POST", "/claims/batch/validate", { hasBody: true }, args),
     },
+    "closeness": {
+      // GET /closeness/for-me — rank: any-builder — GET /closeness/for-me
+      getClosenessForMe: (args) => request("GET", "/closeness/for-me", { hasBody: false }, args),
+      // GET /closeness/weights — rank: any-builder — GET /closeness/weights
+      getClosenessWeights: (args) => request("GET", "/closeness/weights", { hasBody: false }, args),
+      // GET /closeness/with/{builderId} — rank: any-builder — GET /closeness/with/:builderId
+      getClosenessWithBuilderId: (args) => request("GET", "/closeness/with/{builderId}", { hasBody: false }, args),
+    },
     "copyDesk": {
       // POST /copy-desk/flags — rank: any-builder — POST /copy-desk/flags
       postCopyDeskFlags: (args) => request("POST", "/copy-desk/flags", { hasBody: true }, args),

package/clients/bongos-client/index.cjs

@@ -251,6 +251,14 @@ function createClient(opts = {}) {
       // POST /claims/batch/validate — rank: any-builder — POST /claims/batch/validate
       postClaimsBatchValidate: (args) => request("POST", "/claims/batch/validate", { hasBody: true }, args),
     },
+    "closeness": {
+      // GET /closeness/for-me — rank: any-builder — GET /closeness/for-me
+      getClosenessForMe: (args) => request("GET", "/closeness/for-me", { hasBody: false }, args),
+      // GET /closeness/weights — rank: any-builder — GET /closeness/weights
+      getClosenessWeights: (args) => request("GET", "/closeness/weights", { hasBody: false }, args),
+      // GET /closeness/with/{builderId} — rank: any-builder — GET /closeness/with/:builderId
+      getClosenessWithBuilderId: (args) => request("GET", "/closeness/with/{builderId}", { hasBody: false }, args),
+    },
     "copyDesk": {
       // POST /copy-desk/flags — rank: any-builder — POST /copy-desk/flags
       postCopyDeskFlags: (args) => request("POST", "/copy-desk/flags", { hasBody: true }, args),

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

@@ -35,6 +35,9 @@ export interface GetBuildersIdOnboardingResponse { builder_id: unknown; onboardi
 export interface GetBuildersIdProfileResponse { builder: unknown; shipped_count: unknown; recent_ships: unknown; achievements: unknown; cross_project?: unknown }
 export interface GetBuildersMePendingRankChangeResponse { change: unknown; greeting?: unknown }
 export interface GetBuildersRosterResponse { builders: unknown; stale_hours: unknown }
+export interface GetClosenessForMeResponse { closeness: unknown; count: unknown }
+export interface GetClosenessWeightsResponse { weights: unknown; window_days: unknown; note: unknown }
+export interface GetClosenessWithBuilderIdResponse { closeness: unknown; why: unknown }
 export interface GetDiscordChannelsPlanResponse { ok: boolean; guild_id: unknown; op_count: unknown; ops: unknown; warnings: unknown }
 export interface GetDoneWhenPendingReviewResponse { criteria: unknown; count: unknown }
 export interface GetGithubRepoResponse { ok: boolean; repo: unknown; private_deployable: boolean }
@@ -535,6 +538,14 @@ export interface BongosClient {
     /** POST /claims/batch/validate — rank: any-builder */
     postClaimsBatchValidate(args: RequestArgs & { body: PostClaimsBatchValidateRequest }): Promise<ApiResponse>;
   };
+  "closeness": {
+    /** GET /closeness/for-me — rank: any-builder */
+    getClosenessForMe(args?: RequestArgs): Promise<GetClosenessForMeResponse>;
+    /** GET /closeness/weights — rank: any-builder */
+    getClosenessWeights(args?: RequestArgs): Promise<GetClosenessWeightsResponse>;
+    /** GET /closeness/with/{builderId} — rank: any-builder */
+    getClosenessWithBuilderId(args?: RequestArgs): Promise<GetClosenessWithBuilderIdResponse>;
+  };
   "copyDesk": {
     /** POST /copy-desk/flags — rank: any-builder */
     postCopyDeskFlags(args: RequestArgs & { body: PostCopyDeskFlagsRequest }): Promise<PostCopyDeskFlagsResponse>;

package/clients/bongos-client/index.mjs

@@ -248,6 +248,14 @@ export function createClient(opts = {}) {
       // POST /claims/batch/validate — rank: any-builder — POST /claims/batch/validate
       postClaimsBatchValidate: (args) => request("POST", "/claims/batch/validate", { hasBody: true }, args),
     },
+    "closeness": {
+      // GET /closeness/for-me — rank: any-builder — GET /closeness/for-me
+      getClosenessForMe: (args) => request("GET", "/closeness/for-me", { hasBody: false }, args),
+      // GET /closeness/weights — rank: any-builder — GET /closeness/weights
+      getClosenessWeights: (args) => request("GET", "/closeness/weights", { hasBody: false }, args),
+      // GET /closeness/with/{builderId} — rank: any-builder — GET /closeness/with/:builderId
+      getClosenessWithBuilderId: (args) => request("GET", "/closeness/with/{builderId}", { hasBody: false }, args),
+    },
     "copyDesk": {
       // POST /copy-desk/flags — rank: any-builder — POST /copy-desk/flags
       postCopyDeskFlags: (args) => request("POST", "/copy-desk/flags", { hasBody: true }, args),

package/docs/api/openapi.json

@@ -73,6 +73,10 @@
       "name": "claims",
       "description": "Endpoints under `/api/bongos/claims`."
     },
+    {
+      "name": "closeness",
+      "description": "Endpoints under `/api/bongos/closeness`."
+    },
     {
       "name": "copy-desk",
       "description": "Endpoints under `/api/bongos/copy-desk`."
@@ -3195,6 +3199,134 @@
         ]
       }
     },
+    "/closeness/for-me": {
+      "get": {
+        "operationId": "get_closeness_for_me",
+        "tags": [
+          "closeness"
+        ],
+        "summary": "GET /closeness/for-me",
+        "description": ", and OWN-SCOPED — your own graph, never someone else's. Reading another builder's graph would expose who THEY are close to, which is a fact about third parties they did not consent to share.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/lifecycle/routes/closeness.js",
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetClosenessForMeResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
+    "/closeness/weights": {
+      "get": {
+        "operationId": "get_closeness_weights",
+        "tags": [
+          "closeness"
+        ],
+        "summary": "GET /closeness/weights",
+        "description": "the MODEL is not private, and publishing it is the whole point of the weights being data. It describes how the system scores people; a builder ranked by it is entitled to read it.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/lifecycle/routes/closeness.js",
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetClosenessWeightsResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
+    "/closeness/with/{builderId}": {
+      "get": {
+        "operationId": "get_closeness_with_builderId",
+        "tags": [
+          "closeness"
+        ],
+        "summary": "GET /closeness/with/:builderId",
+        "description": "One pair — \"why am I close to THEM\", asked directly rather than by paging the graph. Always relative to the CALLER: the pair is (you, them). rank: any-builder.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/lifecycle/routes/closeness.js",
+        "parameters": [
+          {
+            "name": "builderId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "Path parameter `builderId`."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetClosenessWithBuilderIdResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotFound"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/copy-desk/flags": {
       "post": {
         "operationId": "post_copy_desk_flags",
@@ -14620,6 +14752,41 @@
           "stale_hours"
         ]
       },
+      "GetClosenessForMeResponse": {
+        "type": "object",
+        "properties": {
+          "closeness": {},
+          "count": {}
+        },
+        "required": [
+          "closeness",
+          "count"
+        ]
+      },
+      "GetClosenessWeightsResponse": {
+        "type": "object",
+        "properties": {
+          "weights": {},
+          "window_days": {},
+          "note": {}
+        },
+        "required": [
+          "weights",
+          "window_days",
+          "note"
+        ]
+      },
+      "GetClosenessWithBuilderIdResponse": {
+        "type": "object",
+        "properties": {
+          "closeness": {},
+          "why": {}
+        },
+        "required": [
+          "closeness",
+          "why"
+        ]
+      },
       "GetDiscordChannelsPlanResponse": {
         "type": "object",
         "properties": {
@@ -19794,9 +19961,9 @@
       "description": "A required dependency/feature is not configured or is temporarily down."
     }
   },
-  "x-endpoint-count": 312,
-  "x-schema-count": 350,
+  "x-endpoint-count": 315,
+  "x-schema-count": 353,
   "x-undocumented-bodies": 8,
-  "x-response-schemas": 234,
+  "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. 312 endpoints across 51 route files.
+> **Generated from the live route files** — the route file is authoritative. 315 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`.
@@ -143,6 +143,14 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/<redacted>
 | POST | `/api/bongos/claims/batch/release` | `any-builder` | `claim_ids`, `force` | Bulk release (task 1758) — the batch twin of resolve(outcome='abandoned'). |
 | POST | `/api/bongos/claims/batch/validate` | `any-builder` | `task_ids` | Dry-run validate (task 1758) — read-only twin of claimTasksBatch's pre-flight checks. |
 
+## `closeness` (3)
+
+| Method | Path | Rank | Body | Description |
+|---|---|---|---|---|
+| GET | `/api/bongos/closeness/for-me` | `any-builder` | — | , and OWN-SCOPED — your own graph, never someone else's. |
+| GET | `/api/bongos/closeness/weights` | `any-builder` | — | the MODEL is not private, and publishing it is the whole point of the weights being data. |
+| GET | `/api/bongos/closeness/with/:builderId` | `any-builder` | — | One pair — "why am I close to THEM", asked directly rather than by paging the graph. |
+
 ## `copy-desk` (4)
 
 | Method | Path | Rank | Body | Description |

package/modules/dev-box/app/src/vendor/bongos-client.cjs

@@ -251,6 +251,14 @@ function createClient(opts = {}) {
       // POST /claims/batch/validate — rank: any-builder — POST /claims/batch/validate
       postClaimsBatchValidate: (args) => request("POST", "/claims/batch/validate", { hasBody: true }, args),
     },
+    "closeness": {
+      // GET /closeness/for-me — rank: any-builder — GET /closeness/for-me
+      getClosenessForMe: (args) => request("GET", "/closeness/for-me", { hasBody: false }, args),
+      // GET /closeness/weights — rank: any-builder — GET /closeness/weights
+      getClosenessWeights: (args) => request("GET", "/closeness/weights", { hasBody: false }, args),
+      // GET /closeness/with/{builderId} — rank: any-builder — GET /closeness/with/:builderId
+      getClosenessWithBuilderId: (args) => request("GET", "/closeness/with/{builderId}", { hasBody: false }, args),
+    },
     "copyDesk": {
       // POST /copy-desk/flags — rank: any-builder — POST /copy-desk/flags
       postCopyDeskFlags: (args) => request("POST", "/copy-desk/flags", { hasBody: true }, args),

package/modules/lifecycle/closeness-weights.json

@@ -0,0 +1,64 @@
+{
+  "_comment": [
+    "The closeness scoring model, as DATA (task 1003174 / C04, goal 1000075; criterion",
+    "collab-closeness-consented, ADR 0187 §2). The owner's decision was explicit that the",
+    "weights are data rather than constants buried in a function, so they can be reviewed",
+    "and changed without a code-archaeology dig. This file IS that review surface, and it",
+    "is served verbatim by GET /closeness/weights so the number can always be audited",
+    "against the model that produced it.",
+    "",
+    "HOW A SCORE IS BUILT. Each signal counts real events between two builders. That count",
+    "is divided by the signal's `saturation` and clamped to 1, so a signal is 'full' once",
+    "it has happened `saturation` times and no single runaway count can dominate. The",
+    "closeness score is the weighted sum of those clamped values, expressed 0..1.",
+    "",
+    "WEIGHTS ARE RENORMALISED OVER AVAILABLE SIGNALS. A signal with `available: false`",
+    "cannot be measured yet, and its weight is redistributed across the rest rather than",
+    "counted as zero. Counting it as zero would depress every pair's score identically and,",
+    "worse, the explanation would read as 'you never talk' when the truth is 'nothing here",
+    "can see whether you talk'. The explanation names every excluded signal for this reason.",
+    "",
+    "CHANGING A WEIGHT is a product decision about how the system describes real people to",
+    "each other. Weights should sum to 1 across ALL signals (the test asserts it); the",
+    "renormalisation handles the available subset at read time."
+  ],
+
+  "version": 1,
+  "scale": "0..1, rendered as 0..100 on any surface that shows a number",
+
+  "signals": [
+    {
+      "key": "co_claim",
+      "label": "Worked the same goal at the same time",
+      "description": "You each held an active claim on a task in the same goal, and those claims overlapped in time. This is the live version of working alongside someone: you were both holding work in the same place at once.",
+      "weight": 0.3,
+      "saturation": 5,
+      "available": true
+    },
+    {
+      "key": "co_build_session",
+      "label": "Sat down to it in the same stretch",
+      "description": "You logged work sessions on tasks in the same goal that overlapped in time. A claim can sit open for days; a session is the hours actually spent, so this is the closer measure of being present together. The owner's decision (ADR 0187 §3) is that the unit of collaboration is the GOAL, never a shared claim — nobody co-runs a claim, and this signal does not pretend they do.",
+      "weight": 0.3,
+      "saturation": 5,
+      "available": true
+    },
+    {
+      "key": "shipped_together_goal",
+      "label": "Shipped into the same goal",
+      "description": "Distinct goals where you have each shipped at least one task. Unlike the two above, this ignores timing entirely — it is the durable record that you both built the same thing, even months apart.",
+      "weight": 0.25,
+      "saturation": 3,
+      "available": true
+    },
+    {
+      "key": "comms_mention",
+      "label": "Talked to or mentioned each other",
+      "description": "Messages and mentions between you. NOT MEASURABLE YET: this needs the Discord-into-the-hall mirror, which is C06 of this goal (task 1003176) and is still an open decision. Until it lands this signal is unavailable and its weight is redistributed across the others — it is never silently counted as zero, because 'we cannot see your conversations' and 'you never speak' are different facts and only one of them is true.",
+      "weight": 0.15,
+      "saturation": 20,
+      "available": false,
+      "blocked_by": "task 1003176 (C06 — Discord chat mirrors INTO the hall)"
+    }
+  ]
+}