@bongos/core 1.20.74 → 1.20.76

package/.bongos-core.json

@@ -2,22 +2,22 @@
   "artifact": "bongos-core",
   "manifest_schema": 1,
   "generator": "scripts/gds/package-core.js",
-  "core_version": "1.20.74",
-  "core_contract": "1.20.74",
-  "source_commit": "eb1d4850d76f6db32a57b9dce00da1d3eb47254f",
+  "core_version": "1.20.76",
+  "core_contract": "1.20.76",
+  "source_commit": "22aa5667e2545e7ba865c282b945d19fe4d06503",
   "source_ref": "HEAD",
-  "built_at": "2026-10-01T16:22:03.505Z",
+  "built_at": "2026-10-01T17:22:20.999Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
-    "docs_redacted": 573,
+    "docs_redacted": 574,
     "agent_docs_stubbed": 27,
-    "functional_verbatim": 2803,
+    "functional_verbatim": 2806,
     "rules": 3,
     "gate_literals": 3,
     "gate": "passed"
   },
-  "file_count": 3404,
-  "tree_sha256": "1c4cce121c1de975205357e900f8071000c4bdc96266e65f2a70d5edbfde42df",
+  "file_count": 3408,
+  "tree_sha256": "90606fc311280b0894e28da5be357c96ba3adeaae94f154f7e24743342511e02",
   "files": [
     {
       "path": ".claude/skills/ask-for-help/SKILL.md",
@@ -317,12 +317,12 @@
     {
       "path": "clients/bongos-client/README.md",
       "mode": "0000644",
-      "sha256": "85cd4ad5c84b8ff0607a73a22af4e75fe50f2b155f2be6cda09813472ca6bbba"
+      "sha256": "4bf36ecd7ca2902d45d201a77871242c61842f882ade087c4f71d96da14bac37"
     },
     {
       "path": "clients/bongos-client/bongos-client.global.js",
       "mode": "0000644",
-      "sha256": "bf3a7bf2dcf840e6f045bfe8bde50ad27a503c3b580ea1ee7d2631e384e87806"
+      "sha256": "daf38ceea63ecdc6656b3fa9f9abd061bcd102b8093c55b476cc96f01bb8a8ec"
     },
     {
       "path": "clients/bongos-client/examples/hello-world.mjs",
@@ -332,17 +332,17 @@
     {
       "path": "clients/bongos-client/index.cjs",
       "mode": "0000644",
-      "sha256": "44274ba25258fdab686c0a7cc0874ed45b985024c061719b8720bfb406224be6"
+      "sha256": "422e9c335817f0efe3b63309ae34a5b8d09989d01a22063e6c0dcdb96fb9d650"
     },
     {
       "path": "clients/bongos-client/index.d.ts",
       "mode": "0000644",
-      "sha256": "a21a4ea4ba80966475f02785193ee0f5f5c9ce8644836073bea468bf08a21295"
+      "sha256": "1f8f7512aa121a86c11b39b9015257d9bbd0ab74ea68afd3bba783cd7c840177"
     },
     {
       "path": "clients/bongos-client/index.mjs",
       "mode": "0000644",
-      "sha256": "64b14dca138ecf2e7ebc04c45354eabeff3caad37031eac547b1afe506d447fb"
+      "sha256": "3c9d7a8facab420b2b6eec54469b04d95ee9e37f9447f81c7700b356d408c11c"
     },
     {
       "path": "clients/bongos-client/package.json",
@@ -2267,12 +2267,12 @@
     {
       "path": "docs/api-reference.md",
       "mode": "0000644",
-      "sha256": "c8f3ce40db00caa1f508fd15e8bfff78bbc17ee50ca6968d2349379ef4a1c1f6"
+      "sha256": "77dcae770dc22649b8ecfffc81e06e912053d4a471cb84f9c14cc33f1ccbc342"
     },
     {
       "path": "docs/api/openapi.json",
       "mode": "0000644",
-      "sha256": "fc15bc8d73b5092c16bc0b43c173f18a7915dd67e0d96c268d677b3c2ecc4c19"
+      "sha256": "2306770ff4d240498043ace210b9476065674c0a953e09f1b1fdc7ccd72ce1cb"
     },
     {
       "path": "docs/architecture.md",
@@ -2297,12 +2297,12 @@
     {
       "path": "docs/copy-inventory.md",
       "mode": "0000644",
-      "sha256": "89e2971b3e1f240fba7c1f63e06a97c135bd91e8f532f280cfbb40309c73b47c"
+      "sha256": "4c3a0fbab04692b8aebf540d3582b7a0904745750d950c495ca6a37bdbf50e4f"
     },
     {
       "path": "docs/copy-registry.json",
       "mode": "0000644",
-      "sha256": "49df590e6fa172ef2971371f6944da186c8dc12585d22080df61f97f22cbea85"
+      "sha256": "578b5e2cfc6a475bee754f7dc2df10847aab85ff2b5c9a6da7d3bc5a3ac688d2"
     },
     {
       "path": "docs/design/apex-pass-2-direction.md",
@@ -2807,7 +2807,7 @@
     {
       "path": "docs/module-api-changelog.md",
       "mode": "0000644",
-      "sha256": "45e9c2b5bd53525b3eca32b497de9c69da21100f6eb95fc658614bb79b7f395c"
+      "sha256": "765ceffdf8811aeb7a01dbfd8b80480e993246eda10160f601485a435b7fd449"
     },
     {
       "path": "docs/modules-contract.md",
@@ -2892,12 +2892,12 @@
     {
       "path": "docs/page-inventory.json",
       "mode": "0000644",
-      "sha256": "0265f1008ef98e820054de96ff63474302ea9ed8cbdbf4c0999922575ebf5078"
+      "sha256": "067d0c32185db47048911cd713d1197401d0b05471d57bbcea6b06c8f5982ce2"
     },
     {
       "path": "docs/page-readings.json",
       "mode": "0000644",
-      "sha256": "119a7e0f259453ec65e5caaf5136fbed97b979b9383d6c3ad00794aa6957f1de"
+      "sha256": "9e4ec61d67d50f2095258130cc2a3d4d2e662e4ded9b85fe753c3a30980c09f6"
     },
     {
       "path": "docs/project-context.template.md",
@@ -5764,25 +5764,30 @@
       "mode": "0000644",
       "sha256": "4eb4aadb49fdbffb560e16d7d1b1a10c301963245ba3b7d34d5660cbf8cd2581"
     },
+    {
+      "path": "modules/hall-ui/public/profile-roles.js",
+      "mode": "0000644",
+      "sha256": "18c74c851c4495383b536cf33b3090cac68a34bc7bd6b368a53cebf049b47b52"
+    },
     {
       "path": "modules/hall-ui/public/profile.css",
       "mode": "0000644",
-      "sha256": "00324b1682f02e426b3ae009c441f288e4e6d224240479c63d8e180d0394e5a7"
+      "sha256": "5489cb918f74216e2f5c320bb14cc7390dbb843d8fd382b1ac518434c5f15622"
     },
     {
       "path": "modules/hall-ui/public/profile.html",
       "mode": "0000644",
-      "sha256": "458731741731fe9fa56b4974fdd013088ab56b1457a23eb5ac58c64b93609b55"
+      "sha256": "6683cf6a41e3569261ff4fd48f39d8fc37f08485e1f07be2e074881da120959d"
     },
     {
       "path": "modules/hall-ui/public/profile.js",
       "mode": "0000644",
-      "sha256": "d5ccda2a84c90610c322e9918b87bfdc743ae3b06e47a009b1dca45cc395c07d"
+      "sha256": "cecc17d5e89e864be43c15000b34492cb047f14bb701b3f7cb8807b23357fec4"
     },
     {
       "path": "modules/hall-ui/public/profile.states.json",
       "mode": "0000644",
-      "sha256": "3df74097937e52577f25255a4612b7be93effc491bc32f2f6bc81ddb91b28929"
+      "sha256": "8da53f3321a0a25b104a2dbeccebbc6d94675071e89431f3f9f83d1741835a6c"
     },
     {
       "path": "modules/hall-ui/public/project-settings.css",
@@ -6204,6 +6209,11 @@
       "mode": "0000644",
       "sha256": "ea6521eec734a0c8d20ad8128398c5d9c85cf074060fdb9a85181dff2270ef5c"
     },
+    {
+      "path": "modules/hall-ui/records/profile-roles.md",
+      "mode": "0000644",
+      "sha256": "95e79f2a252081ee12acd0faa093460ffe38e0269526693f62d63d632224a635"
+    },
     {
       "path": "modules/hall-ui/records/reading-rooms.md",
       "mode": "0000644",
@@ -8082,7 +8092,7 @@
     {
       "path": "modules/provisioning/routes/provisioning.js",
       "mode": "0000644",
-      "sha256": "d0efd18cd1774d02434b974ee4214bb310fd2392170d3767e0e17bdc4b76cb77"
+      "sha256": "a07a5ad18a55708ade714a79e155c1dd44596b7379ce43d0405db1211d75278a"
     },
     {
       "path": "modules/provisioning/routes/render-standup.js",
@@ -8397,7 +8407,7 @@
     {
       "path": "modules/public-landing/public/assets/cosmos.css",
       "mode": "0000644",
-      "sha256": "525b32944a931953cbd8c7c949c388a547489c6f930e14137da3dad4e9e2c76b"
+      "sha256": "778b28f1d35d9f6966c8bdf84daffa2ed5cf96bbc5faf5a8fdd5c1f323bc8f22"
     },
     {
       "path": "modules/public-landing/public/assets/verro-medallion.png",
@@ -8762,17 +8772,17 @@
     {
       "path": "modules/public-landing/public/projects.html",
       "mode": "0000644",
-      "sha256": "c82f4f81a22c79c82a01a965a7814f4dc93995e7ee4fd75446ed69fa0c77fa09"
+      "sha256": "438766969f1b61bf1e3da7d6df5603b0569efc4264bc20b720fb27e9c6fe2f11"
     },
     {
       "path": "modules/public-landing/public/projects.probes.json",
       "mode": "0000644",
-      "sha256": "0495d05bc905faf1f0ef669d3403c4de656f9e8c2784cdae4e439a70185c8ac6"
+      "sha256": "99c3b8ea90bd81ac583a34d56f182036d573392b8f489dcb799cb31bac836f03"
     },
     {
       "path": "modules/public-landing/public/projects.states.json",
       "mode": "0000644",
-      "sha256": "73fbf81a0608fd266fd8389fcc1f6edba48eaccfd04c8b43068eaed3cc7dc8de"
+      "sha256": "5a7ce6e71227e224dc1dc09509ab0dcf738e3bd411e6a73a5e4750d81f241d93"
     },
     {
       "path": "modules/public-landing/public/terms.html",
@@ -9312,7 +9322,7 @@
     {
       "path": "modules/ui-design/kit/lib.js",
       "mode": "0000644",
-      "sha256": "4cdaadcbccaa2aa6c5e5f783723e7a10e2ddab136253a3f234a6fd3c5ab7ef10"
+      "sha256": "328b06d37869647a55d2cacef899d81b602593eb2399c1ca7c21e13cd3d9dfae"
     },
     {
       "path": "modules/ui-design/kit/png.js",
@@ -9332,7 +9342,7 @@
     {
       "path": "modules/ui-design/kit/serve.js",
       "mode": "0000644",
-      "sha256": "84115a4463d1799bad2f0b142f448ba953283e935464afed2049c44deed1744d"
+      "sha256": "12ece23ed5730bd59de0d68af75f8be08a6fc268242d7426b23878a5c9893594"
     },
     {
       "path": "modules/ui-design/kit/tells.js",
@@ -9467,12 +9477,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "cdd9bc54a6d46c2bf23d2cbe2f53ab328278496636f2f589eeccc7f403e179c7"
+      "sha256": "721c21514c8d764e04523fbf4290b10ab5261ddfacc7409e1ec676128f7dcdf0"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "bfafaf25062d15f53265ed155a90de3e640290b95145fcec676b3e62e936682e"
+      "sha256": "18ab70ed289f208b60af0e17bb33864e807e611fbcd08081c2f422d8dde5b627"
     },
     {
       "path": "public-docs/index.html",
@@ -9492,7 +9502,7 @@
     {
       "path": "release-notes.json",
       "mode": "0000644",
-      "sha256": "14086dee98a7516d597d2232f2c0f08816e6ccc76f7eee7754f003cb86960af5"
+      "sha256": "6aaafc3a02d323f1665f6071ffa1d07ea000c55764f41b0b91f5aaa11d1b2eaa"
     },
     {
       "path": "scripts/bongos-mcp.js",
@@ -11687,7 +11697,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "941d3e63ecc3d74e53428855942c85dc9d013da1e09e0ec4d40213dcb37dbd82"
+      "sha256": "c1f0721166626eaf1e0a3d561b45fbe85fc6dc78a4102539f4da6674163d082b"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -13182,7 +13192,7 @@
     {
       "path": "tests/founding_builders.mjs",
       "mode": "0000644",
-      "sha256": "788f7af74b52ee23178b75bc9be305b405ef97bbbf42e6137e7321d1006dc148"
+      "sha256": "81a78948ae8f16165739597aad0410d4ed94be24cb44c4e9e60875f91ec8d54a"
     },
     {
       "path": "tests/founding_mode.mjs",
@@ -14027,7 +14037,7 @@
     {
       "path": "tests/helpers.mjs",
       "mode": "0000644",
-      "sha256": "c540cd2d5dce0051e1a1afd6988f2f18f53011d0971cd7e32578016524f1fd76"
+      "sha256": "a9b030d0f3e49f552fa4eb41adf1f6a7c60179c1200c4a723fbaac703f297c5d"
     },
     {
       "path": "tests/hierarchy-config.mjs",
@@ -15244,6 +15254,11 @@
       "mode": "0000644",
       "sha256": "f5e664627bf60830c241539cd001b5eebc55a5786c191154bdd6b6f3dbd745ed"
     },
+    {
+      "path": "tests/profile_role_headline.mjs",
+      "mode": "0000644",
+      "sha256": "8e2ee205bb812c0d7b8ca5c23f61e7288e2a5fd7ebd19ae8c72c3d5a30f4790c"
+    },
     {
       "path": "tests/profile_role_stats.mjs",
       "mode": "0000644",
@@ -15262,7 +15277,7 @@
     {
       "path": "tests/profile_ui_cross_project.mjs",
       "mode": "0000644",
-      "sha256": "d9f469cfb3623c9725e29ac67a507b0e325f0840efdc01310b1d820b65198e6b"
+      "sha256": "40976072c0a3a28496963edc4008cf8a3d32a3a87333436cec679627886dd540"
     },
     {
       "path": "tests/project_admin_console_model.mjs",
@@ -15352,32 +15367,32 @@
     {
       "path": "tests/projects_hub.mjs",
       "mode": "0000644",
-      "sha256": "c5909e5f01df6d2f83cb29ea9b912199bd82e6e06674146734ed11d7bb838ded"
+      "sha256": "b8a6cfca70f84ed904ca6a44d1f045fd2337ea3407143ae0e1b7c05118d83668"
     },
     {
       "path": "tests/projects_hub_app_status.mjs",
       "mode": "0000644",
-      "sha256": "820ae8aea30073853b2dbd15a443bdeb9341bbc9beec6f1204432808635a01ea"
+      "sha256": "7502f3b5ad3a77ff5134875d4de0e9e76c82b956b12c22a52f32854df33ba778"
     },
     {
       "path": "tests/projects_hub_app_step.mjs",
       "mode": "0000644",
-      "sha256": "f387eaf1f5dad1ed8f5cf360bc64820f8e27e6606a507952099d8f11f1630e13"
+      "sha256": "89a3babbba90538cdbfc52673651388eee0172592bdbf8d37a9cbf507173449c"
     },
     {
       "path": "tests/projects_hub_look.mjs",
       "mode": "0000644",
-      "sha256": "02460c4082005a04c8ed12f5e70d58d6c1e29a174241cf88d4340b2e459a64c5"
+      "sha256": "2156371a4e0dc4f97536a553ba8805bb3ca4675f95d0e808c9604066186a09a5"
     },
     {
       "path": "tests/projects_hub_module_picker.mjs",
       "mode": "0000644",
-      "sha256": "9e7cc27990398c936706894e6ac6edd824a8c0a57bff9670ab863d05d876a127"
+      "sha256": "42f6e51a23db4d42414603b4e549fb4fad0b7d95ac709fc653a6f806b590d0a6"
     },
     {
       "path": "tests/projects_hub_pre_uat.mjs",
       "mode": "0000644",
-      "sha256": "00f0adb1a3aa0add4d908fc41c9eb4f2925b6ee139da570e2edd2a2a6af319dc"
+      "sha256": "f65e3a53e3700aff4d45a9cbb0056560b17622ae4d1b7b5e41b565aa6c8eb2b8"
     },
     {
       "path": "tests/projects_hub_render_connect.mjs",
@@ -16977,22 +16992,27 @@
     {
       "path": "tests/wizard_demo.mjs",
       "mode": "0000644",
-      "sha256": "2654d5dad8d1d7ada929ed2107406ddc59094145a2c1d2be1598e93db692b497"
+      "sha256": "6f5945a590a851e83d388afd2e50b4c34187b153d017ed82215dc2a3e4f62ea2"
     },
     {
       "path": "tests/wizard_draft_resume.mjs",
       "mode": "0000644",
-      "sha256": "68ca5c55993203f6a4ab91ea79de4647fccae9008a1cef1a28853515396219b2"
+      "sha256": "625fa61619c02324c09afc05b71471d91a7aeb6aaf82449e0b25d36a09fde103"
     },
     {
       "path": "tests/wizard_front_door.mjs",
       "mode": "0000644",
-      "sha256": "ba94f9a0c317357facdccc94b954a388302c4983094e712c27ddff246dda3a11"
+      "sha256": "de1717a0e40cf430b5c13f7bee1f7e29f3f2d074bf20b0bf04f8d9d4a624b18e"
     },
     {
       "path": "tests/wizard_intent_resume.mjs",
       "mode": "0000644",
-      "sha256": "38843b8b0a8f5e9f907bdb99eba819a24e9f0ef39bf33be727a0074e898721b3"
+      "sha256": "976db1a1bd5290f59dd1ca7ea011478cbc503eb0466b81cb76acea3301c3fd79"
+    },
+    {
+      "path": "tests/wizard_physics.mjs",
+      "mode": "0000644",
+      "sha256": "7b96f175088a5e37940336f6eead501a0d3c72b9614674d8192e9761dd40ea74"
     },
     {
       "path": "tests/wizard_preselect_why.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`)
-- 487 operations across 73 resource groups
+- 488 operations across 73 resource groups
 
 ## Use it from your project
 

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

@@ -887,6 +887,8 @@ function createClient(opts = {}) {
       getProvisioningLogosFile: (args) => request("GET", "/provisioning/logos/{file}", { hasBody: false }, args),
       // GET /provisioning/onboard-plan — rank: public — GET /provisioning/onboard-plan
       getProvisioningOnboardPlan: (args) => request("GET", "/provisioning/onboard-plan", { hasBody: false }, args),
+      // POST /provisioning/physics-check — rank: any-builder — POST /provisioning/physics-check
+      postProvisioningPhysicsCheck: (args) => request("POST", "/provisioning/physics-check", { hasBody: true }, args),
       // GET /provisioning/recommendations — rank: public — GET /provisioning/recommendations
       getProvisioningRecommendations: (args) => request("GET", "/provisioning/recommendations", { hasBody: false }, args),
       // POST /provisioning/render/lookup — rank: any-builder — POST /provisioning/render/lookup

package/clients/bongos-client/index.cjs

@@ -886,6 +886,8 @@ function createClient(opts = {}) {
       getProvisioningLogosFile: (args) => request("GET", "/provisioning/logos/{file}", { hasBody: false }, args),
       // GET /provisioning/onboard-plan — rank: public — GET /provisioning/onboard-plan
       getProvisioningOnboardPlan: (args) => request("GET", "/provisioning/onboard-plan", { hasBody: false }, args),
+      // POST /provisioning/physics-check — rank: any-builder — POST /provisioning/physics-check
+      postProvisioningPhysicsCheck: (args) => request("POST", "/provisioning/physics-check", { hasBody: true }, args),
       // GET /provisioning/recommendations — rank: public — GET /provisioning/recommendations
       getProvisioningRecommendations: (args) => request("GET", "/provisioning/recommendations", { hasBody: false }, args),
       // POST /provisioning/render/lookup — rank: any-builder — POST /provisioning/render/lookup

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

@@ -423,6 +423,8 @@ export interface PostProvisioningInstancesIdRepoPrivateResponse { ok: boolean; q
 export interface PostProvisioningInstancesIdRestartResponse { ok: boolean; queued: unknown; action: unknown; status: unknown; message: unknown }
 export interface PostProvisioningInstancesIdTeardownResponse { ok: boolean; queued: unknown; action: unknown; status: unknown; superseded: unknown; message: unknown }
 export interface PostProvisioningInstancesRequest { slug: string; target_ref?: string; hosting_shape?: string; domain?: string; no_address?: boolean; tier?: string; onboard_mode?: string; type?: string; description?: string; detail?: Record<string, unknown>; modules?: string[]; terms_acknowledged?: boolean; demo?: Record<string, unknown> }
+export interface PostProvisioningPhysicsCheckRequest { description?: string; detail?: Record<string, unknown> }
+export interface PostProvisioningPhysicsCheckResponse { stop: boolean; message: unknown; soft_limits: unknown }
 export interface PostProvisioningRenderLookupRequest { key: string; owner_id?: string }
 export interface PostRemovalProposalsIdDecideRequest { verdict: string; note?: string }
 export interface PostRenderDeployActRequest { action?: string; deployId?: string; confirm?: unknown; expectLiveDeployId?: unknown }
@@ -1336,6 +1338,8 @@ export interface BongosClient {
     getProvisioningLogosFile(args?: RequestArgs): Promise<ApiResponse>;
     /** GET /provisioning/onboard-plan — rank: public */
     getProvisioningOnboardPlan(args?: RequestArgs): Promise<GetProvisioningOnboardPlanResponse>;
+    /** POST /provisioning/physics-check — rank: any-builder */
+    postProvisioningPhysicsCheck(args?: RequestArgs & { body?: PostProvisioningPhysicsCheckRequest }): Promise<PostProvisioningPhysicsCheckResponse>;
     /** GET /provisioning/recommendations — rank: public */
     getProvisioningRecommendations(args?: RequestArgs): Promise<GetProvisioningRecommendationsResponse>;
     /** POST /provisioning/render/lookup — rank: any-builder */

package/clients/bongos-client/index.mjs

@@ -883,6 +883,8 @@ export function createClient(opts = {}) {
       getProvisioningLogosFile: (args) => request("GET", "/provisioning/logos/{file}", { hasBody: false }, args),
       // GET /provisioning/onboard-plan — rank: public — GET /provisioning/onboard-plan
       getProvisioningOnboardPlan: (args) => request("GET", "/provisioning/onboard-plan", { hasBody: false }, args),
+      // POST /provisioning/physics-check — rank: any-builder — POST /provisioning/physics-check
+      postProvisioningPhysicsCheck: (args) => request("POST", "/provisioning/physics-check", { hasBody: true }, args),
       // GET /provisioning/recommendations — rank: public — GET /provisioning/recommendations
       getProvisioningRecommendations: (args) => request("GET", "/provisioning/recommendations", { hasBody: false }, args),
       // POST /provisioning/render/lookup — rank: any-builder — POST /provisioning/render/lookup

package/docs/api/openapi.json

@@ -16533,6 +16533,55 @@
         "security": []
       }
     },
+    "/provisioning/physics-check": {
+      "post": {
+        "operationId": "post_provisioning_physics_check",
+        "tags": [
+          "provisioning"
+        ],
+        "summary": "POST /provisioning/physics-check",
+        "description": "POST /provisioning/physics-check — the planet-physics questions' read BEFORE anything exists (task 1004418, BV2.PS07). The create wizard asks it as the founder answers: would this description stop at the screening screen, and which options do the answers so far hide, grey or annotate (the PS02 soft-limit table, spec D6)? It is the same screen and the same table the create runs, so the screens can never disagree with the Create. Writes nothing, and the soft limits stay advice (`enforced: false`); the create still re-checks everything itself.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/provisioning/routes/provisioning.js",
+        "requestBody": {
+          "required": false,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PostProvisioningPhysicsCheckRequest"
+              }
+            }
+          },
+          "x-validated": true
+        },
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PostProvisioningPhysicsCheckResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/ValidationFailed"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/provisioning/recommendations": {
       "get": {
         "operationId": "get_provisioning_recommendations",
@@ -29283,6 +29332,33 @@
         ],
         "additionalProperties": false
       },
+      "PostProvisioningPhysicsCheckRequest": {
+        "type": "object",
+        "properties": {
+          "description": {
+            "type": "string"
+          },
+          "detail": {
+            "type": "object"
+          }
+        },
+        "additionalProperties": false
+      },
+      "PostProvisioningPhysicsCheckResponse": {
+        "type": "object",
+        "properties": {
+          "stop": {
+            "type": "boolean"
+          },
+          "message": {},
+          "soft_limits": {}
+        },
+        "required": [
+          "stop",
+          "message",
+          "soft_limits"
+        ]
+      },
       "PostProvisioningRenderLookupRequest": {
         "type": "object",
         "properties": {
@@ -31150,9 +31226,9 @@
       "description": "A required dependency/feature is not configured or is temporarily down."
     }
   },
-  "x-endpoint-count": 487,
-  "x-schema-count": 516,
+  "x-endpoint-count": 488,
+  "x-schema-count": 518,
   "x-undocumented-bodies": 12,
-  "x-response-schemas": 345,
+  "x-response-schemas": 346,
   "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. 487 endpoints across 89 route files.
+> **Generated from the live route files** — the route file is authoritative. 488 endpoints across 89 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`.
@@ -588,7 +588,7 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | GET | `/api/bongos/projects/featured` | `public` | — | the public map of projects; no auth by design. |
 | POST | `/api/bongos/projects/invite` | `metic+archon` | `client_id`, `github_login` | own-or-metic in effect: where to invite a builder into a project, asked by a `project.curate` holder OR the project's OWN OWNER (task 100… |
 
-## `provisioning` (41)
+## `provisioning` (42)
 
 | Method | Path | Rank | Body | Description |
 |---|---|---|---|---|
@@ -628,6 +628,7 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | POST | `/api/bongos/provisioning/instances/:id/update-channel` | `archon` | — | POST /provisioning/instances/:id/update-channel — set the project's update rule (task 1004445). |
 | GET | `/api/bongos/provisioning/logos/:file` | `public` | — | a logo is shown on a public hall, and its address is its own sha256, so it names no project and cannot be guessed. |
 | GET | `/api/bongos/provisioning/onboard-plan` | `public` | — | GET /provisioning/onboard-plan?mode=greenfield\|adopt&domain=<host> — the CANONICAL onboarding step sequence (task 2085; goal 35 / criteri… |
+| POST | `/api/bongos/provisioning/physics-check` | `any-builder` | `description`, `detail` | POST /provisioning/physics-check — the planet-physics questions' read BEFORE anything exists (task 1004418, BV2.PS07). |
 | GET | `/api/bongos/provisioning/recommendations` | `public` | — | GET /provisioning/recommendations?type=<project type>&team_shape=<interview answer> — the RULE-BASED recommendation for one set of creati… |
 | POST | `/api/bongos/provisioning/render/lookup` | `any-builder` | `key`, `owner_id` | POST /provisioning/render/lookup — rank: any authenticated builder. |
 | GET | `/api/bongos/provisioning/slug-available` | `any-builder` | — | GET /provisioning/slug-available?slug=<handle> — is this handle free to create under? rank: any authenticated builder (same gate as the c… |