@bongos/core 1.24.10 → 1.24.11

package/.bongos-core.json

@@ -2,22 +2,22 @@
   "artifact": "bongos-core",
   "manifest_schema": 1,
   "generator": "scripts/bongos/package-core.js",
-  "core_version": "1.24.10",
-  "core_contract": "1.24.10",
-  "source_commit": "34bba5895307e737786b9b76f81a42dcbe2ca892",
+  "core_version": "1.24.11",
+  "core_contract": "1.24.11",
+  "source_commit": "0f85afc89cbcab23d402a439c728696980cc5cf3",
   "source_ref": "HEAD",
-  "built_at": "2026-10-30T09:59:13.558Z",
+  "built_at": "2026-10-30T10:49:40.533Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
     "docs_redacted": 629,
     "agent_docs_stubbed": 32,
-    "functional_verbatim": 3747,
+    "functional_verbatim": 3751,
     "rules": 3,
     "gate_literals": 3,
     "gate": "passed"
   },
-  "file_count": 4409,
-  "tree_sha256": "2fd410a70b2fdd86e65ca5adf8f19c9668a4930b95c056164fb50e355f5117d1",
+  "file_count": 4413,
+  "tree_sha256": "6dbaddc967f3ae8de8ee96a736e45eb4fa33f4732169836fe7bc5d999e6c12bb",
   "files": [
     {
       "path": ".claude/skills/ask-for-help/SKILL.md",
@@ -327,12 +327,12 @@
     {
       "path": "clients/bongos-client/README.md",
       "mode": "0000644",
-      "sha256": "ab634ea0457202eaf97cc25a2b4f15ee90e4644df7a9a3aa326c540e24bf3895"
+      "sha256": "54fa3d2516f4095891db50ca2e6722f30b083a6f782d5d83768472751238872d"
     },
     {
       "path": "clients/bongos-client/bongos-client.global.js",
       "mode": "0000644",
-      "sha256": "ba9b52d661f7ecc08f390401a2c3eecd01a13cded1d3bc902c196f25b6caa252"
+      "sha256": "d7ca7c5f90e10d9831390c44b48f083d3001e25765e1266e5b3e3091c9f4bd41"
     },
     {
       "path": "clients/bongos-client/examples/hello-world.mjs",
@@ -342,17 +342,17 @@
     {
       "path": "clients/bongos-client/index.cjs",
       "mode": "0000644",
-      "sha256": "025963a5170717981d0df7d0b583bafa497f1e9c44f5c849df337b2f541c926f"
+      "sha256": "43307876194957fad2d87de576fee3b0daff54aaca6e76a191663494145ca1c4"
     },
     {
       "path": "clients/bongos-client/index.d.ts",
       "mode": "0000644",
-      "sha256": "26147b2420580754957aa3ad4cd5a8a70c86e5e62e1a948ddac8d81727f412fc"
+      "sha256": "d9b97f43d54f9f483a5249ea139ce72a2e99dda37020069a5750026d4fb46daf"
     },
     {
       "path": "clients/bongos-client/index.mjs",
       "mode": "0000644",
-      "sha256": "81a134502f7b526d651478f8f3b52fbf483f36433f3b9f57f2fbe66e34c0517d"
+      "sha256": "16c9de0860b75098953af7ac76abefda94314d6aa347fa0ef457bb63828add1f"
     },
     {
       "path": "clients/bongos-client/package.json",
@@ -2447,17 +2447,17 @@
     {
       "path": "docs/api-reference.md",
       "mode": "0000644",
-      "sha256": "3720a4cb83a3d7ea831707d517af3681b43186094a15f5ad7fb4d3e411c3b0c2"
+      "sha256": "9178e55a680b093cea30c75282d1d8d74c248723f87857f49d3fe9ba426902a8"
     },
     {
       "path": "docs/api/openapi.json",
       "mode": "0000644",
-      "sha256": "bc3b9ba98481b3b9a3dc7f6d67d2d82ffa6b24857a511fe0e313b6164ebd44a2"
+      "sha256": "d2f60403e3eb1ad448901e491899d6925feacf81ff288bcbdd66236bad694285"
     },
     {
       "path": "docs/architecture.md",
       "mode": "0000644",
-      "sha256": "95f3a2b4c7bbbf3527c59cc176732022dfc98238c191c00dab1e0857461fbc34"
+      "sha256": "7c852997f1364f38835d8856180daf308f73bcd068e44f1202a865d852c8dd37"
     },
     {
       "path": "docs/branding-contract.md",
@@ -2477,12 +2477,12 @@
     {
       "path": "docs/copy-inventory.md",
       "mode": "0000644",
-      "sha256": "3e7ea07b1838d4d1846c9f71f5c43bc0973639c2b4fd629d45e95f753c73726c"
+      "sha256": "e012225cca71b38bb639318fb41674e0ad3f3098e615b5042cf70652acf0b3bb"
     },
     {
       "path": "docs/copy-registry.json",
       "mode": "0000644",
-      "sha256": "77bd20ae4a813611580cf6597f55b57766f259cc8596c1896f9b9a3388b33b86"
+      "sha256": "28bda0daa236eca2f52acdff90979f96e27a9672f1e5889dfb5ef49b64fa4635"
     },
     {
       "path": "docs/design/apex-pass-2-direction.md",
@@ -2992,7 +2992,7 @@
     {
       "path": "docs/module-api-changelog.md",
       "mode": "0000644",
-      "sha256": "6f1a18a7f26eaf3e1d7a9f2f44ef0c7c1af8cc4361810f734dc5e1bf90a1fcc7"
+      "sha256": "d6bd0ff893a42742f1eaee6a772efbfe5b55268b4ddb463c97334e187d75e066"
     },
     {
       "path": "docs/modules-contract.md",
@@ -3082,7 +3082,7 @@
     {
       "path": "docs/page-readings.json",
       "mode": "0000644",
-      "sha256": "1d1b3aead24222e2f686a774a1db46eb48ea4caf97796b98f529218d9b597fb3"
+      "sha256": "b0ab5b7fb6457ed102dacad123d130c10aba2eee092ec7670afc267fcf507c0b"
     },
     {
       "path": "docs/project-context.template.md",
@@ -5347,7 +5347,7 @@
     {
       "path": "modules/government/decision-rules.js",
       "mode": "0000644",
-      "sha256": "adba77e3af1da714230fb08f4729db04a697d502d3c1bb76a7f01bade3734f66"
+      "sha256": "49128cfa99db804ea7bd07097e86f72d74daa2c845b3b0c93d49e1f80a7e33d8"
     },
     {
       "path": "modules/government/docket-floors.js",
@@ -6722,7 +6722,7 @@
     {
       "path": "modules/hall-ui/public/project-settings.css",
       "mode": "0000644",
-      "sha256": "d554081a9d5d8c702a00e3f305b9927a3e9b72c1c34757876e874f0ab6ed61f4"
+      "sha256": "d628173de0c1d5e7e109bf322370fc635dd563e559e1aa5536172f592d617edf"
     },
     {
       "path": "modules/hall-ui/public/project-settings.html",
@@ -6732,7 +6732,7 @@
     {
       "path": "modules/hall-ui/public/project-settings.js",
       "mode": "0000644",
-      "sha256": "3730c8ed127d44dc9dab5c60f57c6dfdf045b13ed7a99dc704c1515173295ac4"
+      "sha256": "a6ec54623fcf19ee6070ca5f06b38c6e9746ba86d5fe24f48ed3c4c451f86d45"
     },
     {
       "path": "modules/hall-ui/public/ranks-founding.states.json",
@@ -7077,7 +7077,7 @@
     {
       "path": "modules/hall-ui/public/task.js",
       "mode": "0000644",
-      "sha256": "a34f2ad2fac9f9dad2c5cb7a7110c877a5cd25ba40244a28d7ea0c17726a7b37"
+      "sha256": "1dcf247258c670bb496969a65f9aa38319213639af25d028ece2b32812c5d60f"
     },
     {
       "path": "modules/hall-ui/public/task.states.json",
@@ -8024,6 +8024,11 @@
       "mode": "0000644",
       "sha256": "47cb5fac80a94bb458f8078794ed2a382144e5503771e3db09bb65487113ee1a"
     },
+    {
+      "path": "modules/lifecycle/migrations/lifecycle_018_pay_terms.sql",
+      "mode": "0000644",
+      "sha256": "48dd805da15cdda9fcb2b716b8f5231b0f958e1ad3c2a6ae2e8ec9a6ba3a0047"
+    },
     {
       "path": "modules/lifecycle/mingle.js",
       "mode": "0000644",
@@ -8084,6 +8089,11 @@
       "mode": "0000644",
       "sha256": "c6b5cb868778d1043029c0f17640caa4e2124e13783319e33cbdb56b0135ba45"
     },
+    {
+      "path": "modules/lifecycle/pay-terms.js",
+      "mode": "0000644",
+      "sha256": "32e743a3db33d6102c4e88e481e49ffae51f18bddd753067032b9bfc99e019f8"
+    },
     {
       "path": "modules/lifecycle/pg-constraint-fail.js",
       "mode": "0000644",
@@ -8222,7 +8232,7 @@
     {
       "path": "modules/lifecycle/routes/project-settings.js",
       "mode": "0000644",
-      "sha256": "8579902eadcfa94f425c840b71db943928d4c7d4f2cb6a6b89506767853ef311"
+      "sha256": "4f0a0e2ec6fc703c9683595c83d448069b29bf85dc507f3960e6dcf2c72da4e8"
     },
     {
       "path": "modules/lifecycle/routes/recommendations.js",
@@ -8257,7 +8267,7 @@
     {
       "path": "modules/lifecycle/routes/task-write-routes.js",
       "mode": "0000644",
-      "sha256": "df24d82db034006f4993dd0888f726bec6a2e1265b6f1a7fafe2d198f089b757"
+      "sha256": "2cb57c7fafd7d62337c99309c1ea92bb03f89c18da577b0f19ec983c6bb9960c"
     },
     {
       "path": "modules/lifecycle/routes/tasks.js",
@@ -11527,12 +11537,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "9688d4c934651f929dca89c8abb20d57e87d64908806ee70695e848d645f249e"
+      "sha256": "3c012d104affe4df40fc07077a841281ca63f61d9019fdf69dfab810c08bd5bd"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "a321ad1cdd9c1b6240b2b35c0f2b6963b65d925038989ee23e19773e3a046310"
+      "sha256": "ca628e7aee36246d6f09e64c1eb371967ca4bb0f8cf10ee881d59b046487a9e5"
     },
     {
       "path": "public-docs/index.html",
@@ -11552,7 +11562,7 @@
     {
       "path": "release-notes.json",
       "mode": "0000644",
-      "sha256": "57302535e8b5e1bf8902674a628abdf182bf632843fbd22422ba89cf97a9a6a6"
+      "sha256": "124ce8ea3af7ef1bdaa604915fd8b825bd863c24c61d5c573d7d04e539bb0ae1"
     },
     {
       "path": "scripts/bongos/CLAUDE.md",
@@ -12192,7 +12202,7 @@
     {
       "path": "scripts/bongos/government-walk.js",
       "mode": "0000644",
-      "sha256": "d20763a3e5d87f5617a42a7e312c25a16ab8f125a1baab51cf2a4324729bffcf"
+      "sha256": "024c5d3568db22b752cafc1de249f7abe487dbbca91a0f78dad7d8e5b93b81a5"
     },
     {
       "path": "scripts/bongos/grade-correlation-audit.js",
@@ -12777,7 +12787,7 @@
     {
       "path": "scripts/bongos/run-unit-tests.js",
       "mode": "0000644",
-      "sha256": "59bce9b896eb24b1650ce546b16c28111e148a22b33d58db3a75c48b221ac48f"
+      "sha256": "f1503d132b13cc5e49c4f08272c43a23a1c1fe76b1bfcefa89690d22104b3c0a"
     },
     {
       "path": "scripts/bongos/runner-drift.js",
@@ -13052,7 +13062,7 @@
     {
       "path": "scripts/bongos/start.js",
       "mode": "0000644",
-      "sha256": "b8e687691bbf3d0773051a893acd986924464d06d2a6795104d565bf42cf10c1"
+      "sha256": "7d7be325ec46149fad15e0a71d4f00d310e7f53fbfa0ff926d8f4c7aba3a8c68"
     },
     {
       "path": "scripts/bongos/status.js",
@@ -15397,7 +15407,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "8f018c582864b12bc3f2eca367041b4e7cabf639a0553fe964b007134d3bbc53"
+      "sha256": "9ff528e554e5c850f0bb28d26249518ccf236a2cbc4273b54bb5d5f8e9f4ccd4"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -17602,7 +17612,7 @@
     {
       "path": "tests/government_act_alone_buildings.mjs",
       "mode": "0000644",
-      "sha256": "8583a2f565f9d7d52fa4f3c06e61268b54b9995603d8fe24afcf6760b6e4e562"
+      "sha256": "ffb269cb08f61a0cafa046bd96d45b5fb72165da342768735a4e1e0604505e07"
     },
     {
       "path": "tests/government_agent_asks.mjs",
@@ -19832,7 +19842,7 @@
     {
       "path": "tests/patch_gate_ordering.mjs",
       "mode": "0000644",
-      "sha256": "db5e934ef61ddc8dc5804f25a9c84c04f30570db708fd6c77a157e101c69b4d4"
+      "sha256": "0186451ede29e3f203b57050b6a6022eb368403d50f68abdb11e0d941c91f5bc"
     },
     {
       "path": "tests/patch_value_summary_e2e.mjs",
@@ -19849,6 +19859,16 @@
       "mode": "0000644",
       "sha256": "6c623a5abe9aadf4821ad8ca291fb5d7805a7a5bc874bfc3cd7e51e83de289d2"
     },
+    {
+      "path": "tests/pay_terms.mjs",
+      "mode": "0000644",
+      "sha256": "c00d9fde876ac7a97db701d38bac64eb01a8f5b658e0ff5b65dfdb8e0a296c18"
+    },
+    {
+      "path": "tests/pay_terms_db.mjs",
+      "mode": "0000644",
+      "sha256": "75c0665877d50f2c25c3bfd17dad1b1b7bd140d9e557ad312683d7ca2e945640"
+    },
     {
       "path": "tests/payout_approvals.mjs",
       "mode": "0000644",
@@ -20092,7 +20112,7 @@
     {
       "path": "tests/project_settings_page.mjs",
       "mode": "0000644",
-      "sha256": "8bffff24ae3ab30ff7304a697dd993293b4506de9effbc21361ae73021fb2bce"
+      "sha256": "d88fb15fef98b9cc74170223e9b1208abfc27c8382f1ae63ef676bfbc1ba6003"
     },
     {
       "path": "tests/project_settings_spend_cap_route.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`)
-- 647 operations across 80 resource groups
+- 649 operations across 81 resource groups
 
 ## Use it from your project
 

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

@@ -1012,6 +1012,10 @@ function createClient(opts = {}) {
       // GET /page-notes/site — rank: any-builder — GET /page-notes/site
       getPageNotesSite: (args) => request("GET", "/page-notes/site", { hasBody: false }, args),
     },
+    "payTerms": {
+      // GET /pay-terms — rank: any-builder — GET /pay-terms
+      getPayTerms: (args) => request("GET", "/pay-terms", { hasBody: false }, args),
+    },
     "payouts": {
       // POST /payouts/age-records — rank: archon — POST /payouts/age-records
       postPayoutsAgeRecords: (args) => request("POST", "/payouts/age-records", { hasBody: true }, args),
@@ -1057,6 +1061,8 @@ function createClient(opts = {}) {
     "projectSettings": {
       // GET /project-settings — rank: metic+archon — GET /project-settings
       getProjectSettings: (args) => request("GET", "/project-settings", { hasBody: false }, args),
+      // PATCH /project-settings/pay-terms — rank: metic+archon — PATCH /project-settings/pay-terms
+      patchProjectSettingsPayTerms: (args) => request("PATCH", "/project-settings/pay-terms", { hasBody: true }, args),
       // PATCH /project-settings/rot-days — rank: metic+archon — PATCH /project-settings/rot-days
       patchProjectSettingsRotDays: (args) => request("PATCH", "/project-settings/rot-days", { hasBody: true }, args),
       // GET /project-settings/ship-mode — rank: any-builder — GET /project-settings/ship-mode

package/clients/bongos-client/index.cjs

@@ -1011,6 +1011,10 @@ function createClient(opts = {}) {
       // GET /page-notes/site — rank: any-builder — GET /page-notes/site
       getPageNotesSite: (args) => request("GET", "/page-notes/site", { hasBody: false }, args),
     },
+    "payTerms": {
+      // GET /pay-terms — rank: any-builder — GET /pay-terms
+      getPayTerms: (args) => request("GET", "/pay-terms", { hasBody: false }, args),
+    },
     "payouts": {
       // POST /payouts/age-records — rank: archon — POST /payouts/age-records
       postPayoutsAgeRecords: (args) => request("POST", "/payouts/age-records", { hasBody: true }, args),
@@ -1056,6 +1060,8 @@ function createClient(opts = {}) {
     "projectSettings": {
       // GET /project-settings — rank: metic+archon — GET /project-settings
       getProjectSettings: (args) => request("GET", "/project-settings", { hasBody: false }, args),
+      // PATCH /project-settings/pay-terms — rank: metic+archon — PATCH /project-settings/pay-terms
+      patchProjectSettingsPayTerms: (args) => request("PATCH", "/project-settings/pay-terms", { hasBody: true }, args),
       // PATCH /project-settings/rot-days — rank: metic+archon — PATCH /project-settings/rot-days
       patchProjectSettingsRotDays: (args) => request("PATCH", "/project-settings/rot-days", { hasBody: true }, args),
       // GET /project-settings/ship-mode — rank: any-builder — GET /project-settings/ship-mode

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

@@ -141,6 +141,7 @@ export interface GetPageNotesIdResponse { note: unknown; images: unknown; ideas:
 export interface GetPageNotesIdeasResponse { page_path: unknown; ideas: unknown }
 export interface GetPageNotesResponse { page_id: unknown; notes: unknown }
 export interface GetPageNotesSiteResponse { notes: unknown }
+export interface GetPayTermsResponse { pay_terms: unknown }
 export interface GetPayoutsApprovalsResponse { approvals: unknown }
 export interface GetPayoutsGatesBuilderIdResponse { gate: unknown }
 export interface GetPayoutsRulesResponse { rules: unknown }
@@ -264,6 +265,8 @@ export interface PatchNotesIdRequest { kind: string }
 export interface PatchNotesIdResponse { ok: boolean; note: unknown }
 export interface PatchPageNotesIdRequest { body_md: string }
 export interface PatchPageNotesIdResponse { ok: boolean; updated_at: unknown }
+export interface PatchProjectSettingsPayTermsRequest { terms: unknown }
+export interface PatchProjectSettingsPayTermsResponse { ok: boolean; row: unknown }
 export interface PatchProjectSettingsRotDaysRequest { days: number }
 export interface PatchProjectSettingsRotDaysResponse { ok: boolean; rot_days: unknown; source: unknown; describe: unknown }
 export interface PatchProjectSettingsShipModeRequest { mode: string }
@@ -285,7 +288,7 @@ export interface PatchSpecialitiesIdRequest { name?: string; summary?: string; c
 export interface PatchSpecialitiesIdResponse { speciality: unknown }
 export interface PatchTaskRecommendationsIdRequest { status: "declined" | "withdrawn" }
 export interface PatchTaskRecommendationsIdResponse { ok: boolean; recommendation: unknown }
-export interface PatchTasksIdRequest { kind?: string; discipline?: string; requires_rank?: string; module_key?: string; goal_id?: number; parent_task_id?: StringifiableId; parallel_safe?: unknown; newcomer_friendly?: boolean; xenos_claimable?: boolean; security_sensitive?: boolean; automation_tag?: string; needs?: unknown; needs_migration?: boolean; description?: string; title?: string; priority?: unknown; value_summary?: string; status?: unknown }
+export interface PatchTasksIdRequest { kind?: string; discipline?: string; requires_rank?: string; module_key?: string; goal_id?: number; parent_task_id?: StringifiableId; parallel_safe?: unknown; newcomer_friendly?: boolean; xenos_claimable?: boolean; security_sensitive?: boolean; automation_tag?: string; needs?: unknown; needs_migration?: boolean; description?: string; title?: string; priority?: unknown; value_summary?: string; status?: unknown; pay_terms?: unknown }
 export interface PostAccessRequestsInviteRequest { github_login: string; note?: string }
 export interface PostAccessRequestsInviteResponse { ok: boolean; already_invited?: boolean; github_login?: unknown; request?: unknown }
 export interface PostAccessRequestsRequest { github_login: string; display_name?: string; note?: string }
@@ -1638,6 +1641,10 @@ export interface BongosClient {
     /** GET /page-notes/site — rank: any-builder */
     getPageNotesSite(args?: RequestArgs): Promise<GetPageNotesSiteResponse>;
   };
+  "payTerms": {
+    /** GET /pay-terms — rank: any-builder */
+    getPayTerms(args?: RequestArgs): Promise<GetPayTermsResponse>;
+  };
   "payouts": {
     /** POST /payouts/age-records — rank: archon */
     postPayoutsAgeRecords(args: RequestArgs & { body: PostPayoutsAgeRecordsRequest }): Promise<PostPayoutsAgeRecordsResponse>;
@@ -1683,6 +1690,8 @@ export interface BongosClient {
   "projectSettings": {
     /** GET /project-settings — rank: metic+archon */
     getProjectSettings(args?: RequestArgs): Promise<GetProjectSettingsResponse>;
+    /** PATCH /project-settings/pay-terms — rank: metic+archon */
+    patchProjectSettingsPayTerms(args: RequestArgs & { body: PatchProjectSettingsPayTermsRequest }): Promise<PatchProjectSettingsPayTermsResponse>;
     /** PATCH /project-settings/rot-days — rank: metic+archon */
     patchProjectSettingsRotDays(args: RequestArgs & { body: PatchProjectSettingsRotDaysRequest }): Promise<PatchProjectSettingsRotDaysResponse>;
     /** GET /project-settings/ship-mode — rank: any-builder */

package/clients/bongos-client/index.mjs

@@ -1008,6 +1008,10 @@ export function createClient(opts = {}) {
       // GET /page-notes/site — rank: any-builder — GET /page-notes/site
       getPageNotesSite: (args) => request("GET", "/page-notes/site", { hasBody: false }, args),
     },
+    "payTerms": {
+      // GET /pay-terms — rank: any-builder — GET /pay-terms
+      getPayTerms: (args) => request("GET", "/pay-terms", { hasBody: false }, args),
+    },
     "payouts": {
       // POST /payouts/age-records — rank: archon — POST /payouts/age-records
       postPayoutsAgeRecords: (args) => request("POST", "/payouts/age-records", { hasBody: true }, args),
@@ -1053,6 +1057,8 @@ export function createClient(opts = {}) {
     "projectSettings": {
       // GET /project-settings — rank: metic+archon — GET /project-settings
       getProjectSettings: (args) => request("GET", "/project-settings", { hasBody: false }, args),
+      // PATCH /project-settings/pay-terms — rank: metic+archon — PATCH /project-settings/pay-terms
+      patchProjectSettingsPayTerms: (args) => request("PATCH", "/project-settings/pay-terms", { hasBody: true }, args),
       // PATCH /project-settings/rot-days — rank: metic+archon — PATCH /project-settings/rot-days
       patchProjectSettingsRotDays: (args) => request("PATCH", "/project-settings/rot-days", { hasBody: true }, args),
       // GET /project-settings/ship-mode — rank: any-builder — GET /project-settings/ship-mode

package/docs/api/openapi.json

@@ -241,6 +241,10 @@
       "name": "page-notes",
       "description": "Endpoints under `/api/bongos/page-notes`."
     },
+    {
+      "name": "pay-terms",
+      "description": "Endpoints under `/api/bongos/pay-terms`."
+    },
     {
       "name": "payouts",
       "description": "Endpoints under `/api/bongos/payouts`."
@@ -19113,6 +19117,44 @@
         ]
       }
     },
+    "/pay-terms": {
+      "get": {
+        "operationId": "get_pay_terms",
+        "tags": [
+          "pay-terms"
+        ],
+        "summary": "GET /pay-terms",
+        "description": "GET /pay-terms?task_ids=1,2,3 — what each task pays, in the project's words (task 1004990, ADR 0385 D3), for a list of tasks in one read: the hall task page and `bongos start` show it so a builder sees the pay BEFORE claiming. Each entry is { source: 'task' | 'project' | 'none', terms, set_by, set_at }; a task with none of its own shows the project's standing terms (set below), and a self-managed term carries its \"Bongos does not move or guarantee this money\" label. Records only — no amount here is a Bongos figure. It lives beside the standing-terms write because both serve the one pay-terms table pair. rank: any-builder — the same task metadata GET /tasks/:id serves; nothing changed.\n\n**Rank:** `any-builder` — Any authenticated builder (row-level ownership enforced in-handler).",
+        "x-rank": "any-builder",
+        "x-source": "modules/lifecycle/routes/project-settings.js",
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetPayTermsResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/payouts/age-records": {
       "post": {
         "operationId": "post_payouts_age_records",
@@ -20050,6 +20092,58 @@
         ]
       }
     },
+    "/project-settings/pay-terms": {
+      "patch": {
+        "operationId": "patch_project_settings_pay_terms",
+        "tags": [
+          "project-settings"
+        ],
+        "summary": "PATCH /project-settings/pay-terms",
+        "description": "PATCH /project-settings/pay-terms — body { terms: [{ pay_type, amount?, unit?, note? }] } (task 1004990; ADR 0385 decision 3 and the owner's 2026-10-29 ruling). The project's STANDING pay terms: what a builder is shown on any task that carries none of its own. The whole list replaces the current set; [] means none. Every change is a new row naming who set it and when, and the old sets stay, so the table is the audit trail the owner asked for. Bongos fills nothing in. rank: project.settings.manage (metic+, government_010), the same atom as the other writes on this page.\n\n**Rank:** `metic+archon` — Metic or Archon rank (review/triage powers).\n\n**Permissions:** `project.settings.manage` (all required).",
+        "x-rank": "metic+archon",
+        "x-source": "modules/lifecycle/routes/project-settings.js",
+        "x-permissions": [
+          "project.settings.manage"
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PatchProjectSettingsPayTermsRequest"
+              }
+            }
+          },
+          "x-validated": true
+        },
+        "responses": {
+          "200": {
+            "description": "Success.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PatchProjectSettingsPayTermsResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/ValidationFailed"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          }
+        },
+        "security": [
+          {
+            "builderSession": []
+          }
+        ]
+      }
+    },
     "/project-settings/rot-days": {
       "patch": {
         "operationId": "patch_project_settings_rot_days",
@@ -27822,7 +27916,7 @@
           "tasks"
         ],
         "summary": "POST /tasks",
-        "description": "Task create/promote/edit (plan/scope mutation) is Metic+ as of ADR 0090 (owner decision 2026-06-26): a Metic who can run idea-triage may also seed + shape tasks. Was Archon-only (task task 106 / ADR 0016; three-rank model task 360 / ADR 0018). A Xenos/Thetes still cannot author — they file ideas. Setting rank and closing versions stay Archon. The every-route audit is task task 231 (V3.R06). rank: metic+archon — create work (plan/scope mutation); ADR 0090 (was ADR 0016/0018 archon).\n\n**Rank:** `metic+archon` — Metic or Archon rank (review/triage powers).\n\n**Permissions:** `task.create` (all required).",
+        "description": "Task create/promote/edit (plan/scope mutation) is Metic+ as of ADR 0090 (owner decision 2026-06-26): a Metic who can run idea-triage may also seed + shape tasks. Was Archon-only (task task 106 / ADR 0016; three-rank model task 360 / ADR 0018). A Xenos/Thetes still cannot author — they file ideas. Setting rank and closing versions stay Archon. The every-route audit is task task 231 (V3.R06). NO pay_terms HERE, on purpose (task 1004990): the task's rule is that only someone who may EDIT a task sets its pay terms, and this route is gated on task.create, not task.edit — so terms are set with PATCH /tasks/:id right after create, under that route's task.edit gate. The strict validator refuses the field here rather than letting a create quietly widen who may set pay. rank: metic+archon — create work (plan/scope mutation); ADR 0090 (was ADR 0016/0018 archon).\n\n**Rank:** `metic+archon` — Metic or Archon rank (review/triage powers).\n\n**Permissions:** `task.create` (all required).",
         "x-rank": "metic+archon",
         "x-source": "modules/lifecycle/routes/task-write-routes.js",
         "x-permissions": [
@@ -32052,6 +32146,15 @@
           "notes"
         ]
       },
+      "GetPayTermsResponse": {
+        "type": "object",
+        "properties": {
+          "pay_terms": {}
+        },
+        "required": [
+          "pay_terms"
+        ]
+      },
       "GetPayoutsApprovalsResponse": {
         "type": "object",
         "properties": {
@@ -33641,6 +33744,29 @@
           "updated_at"
         ]
       },
+      "PatchProjectSettingsPayTermsRequest": {
+        "type": "object",
+        "properties": {
+          "terms": {}
+        },
+        "required": [
+          "terms"
+        ],
+        "additionalProperties": false
+      },
+      "PatchProjectSettingsPayTermsResponse": {
+        "type": "object",
+        "properties": {
+          "ok": {
+            "type": "boolean"
+          },
+          "row": {}
+        },
+        "required": [
+          "ok",
+          "row"
+        ]
+      },
       "PatchProjectSettingsRotDaysRequest": {
         "type": "object",
         "properties": {
@@ -34026,7 +34152,8 @@
             "minLength": 1,
             "maxLength": 1000
           },
-          "status": {}
+          "status": {},
+          "pay_terms": {}
         },
         "additionalProperties": false
       },
@@ -40980,9 +41107,9 @@
       "description": "A required dependency/feature is not configured or is temporarily down."
     }
   },
-  "x-endpoint-count": 647,
-  "x-schema-count": 693,
+  "x-endpoint-count": 649,
+  "x-schema-count": 696,
   "x-undocumented-bodies": 12,
-  "x-response-schemas": 444,
+  "x-response-schemas": 446,
   "x-generated-by": "scripts/bongos/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. 647 endpoints across 108 route files.
+> **Generated from the live route files** — the route file is authoritative. 649 endpoints across 108 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`.
@@ -691,6 +691,12 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | GET | `/api/bongos/page-notes/images/:id` | `any-builder` | — |  |
 | GET | `/api/bongos/page-notes/site` | `any-builder` | — | The public site's reviews (task 1004499), for the Studio's list. |
 
+## `pay-terms` (1)
+
+| Method | Path | Rank | Body | Description |
+|---|---|---|---|---|
+| GET | `/api/bongos/pay-terms` | `any-builder` | — | GET /pay-terms?task_ids=1,2,3 — what each task pays, in the project's words (task 1004990, ADR 0385 D3), for a list of tasks in one read:… |
+
 ## `payouts` (16)
 
 | Method | Path | Rank | Body | Description |
@@ -724,11 +730,12 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 |---|---|---|---|---|
 | GET | `/api/bongos/project/manage-link` | `archon` | — | GET /project/manage-link — the hub's page for THIS project, where its owner takes it offline or disconnects it (task 1004570). |
 
-## `project-settings` (7)
+## `project-settings` (8)
 
 | Method | Path | Rank | Body | Description |
 |---|---|---|---|---|
 | GET | `/api/bongos/project-settings` | `metic+archon` | — | GET /project-settings — all five rows in ONE read. |
+| PATCH | `/api/bongos/project-settings/pay-terms` | `metic+archon` | `terms` | PATCH /project-settings/pay-terms — body { terms: [{ pay_type, amount?, unit?, note? }] } (task 1004990; ADR 0385 decision 3 and the owne… |
 | PATCH | `/api/bongos/project-settings/rot-days` | `metic+archon` | `days` | PATCH /project-settings/rot-days — body { days }. |
 | GET | `/api/bongos/project-settings/ship-mode` | `any-builder` | — | GET /project-settings/ship-mode — the ship mode alone, for the CLI and the AI. |
 | PATCH | `/api/bongos/project-settings/ship-mode` | `metic+archon` | `mode` | PATCH /project-settings/ship-mode — body { mode: 'auto' \| 'manual' }. |
@@ -997,7 +1004,7 @@ Base path: `/api/bongos`. Ranks (enforced server-side, [ADR 0016](adr/0016-trust
 | GET | `/api/bongos/tasks` | `any-builder` | — |  |
 | POST | `/api/bongos/tasks` | `metic+archon` | `version_id`, `title`, `description`, `status`, `touches`, `est_minutes`, `est_cost_usd`, `manual_degree`, `priority`, `automation_tag`, `credits_reward`, `source`, `source_ref`, `value_summary`, `kind`, `discipline`, `parallel_safe`, `newcomer_friendly`, `security_sensitive`, `requires_rank`, `needs`, `auto_detect_touches`, `criterion_ids`, `module_key`, `goal_id` | Task create/promote/edit (plan/scope mutation) is Metic+ as of ADR 0090 (owner decision 2026-06-26): a Metic who can run idea-triage may … |
 | GET | `/api/bongos/tasks/:id` | `any-builder` | — | single-task read; preserved per CRITICAL §4 (supervisor hot path). |
-| PATCH | `/api/bongos/tasks/:id` | `metic+archon` | `kind`, `discipline`, `requires_rank`, `module_key`, `goal_id`, `parent_task_id`, `parallel_safe`, `newcomer_friendly`, `xenos_claimable`, `security_sensitive`, `automation_tag`, `needs`, `needs_migration`, `description`, `title`, `priority`, `value_summary`, `status` | PATCH /tasks/:id — supports body.parent_task_id (V2 C2), body.kind (V2 B1), body.discipline (mig 014), body.parallel_safe (mig 028), and … |
+| PATCH | `/api/bongos/tasks/:id` | `metic+archon` | `kind`, `discipline`, `requires_rank`, `module_key`, `goal_id`, `parent_task_id`, `parallel_safe`, `newcomer_friendly`, `xenos_claimable`, `security_sensitive`, `automation_tag`, `needs`, `needs_migration`, `description`, `title`, `priority`, `value_summary`, `status`, `pay_terms` | PATCH /tasks/:id — supports body.parent_task_id (V2 C2), body.kind (V2 B1), body.discipline (mig 014), body.parallel_safe (mig 028), and … |
 | POST | `/api/bongos/tasks/:id/abandon` | `any-builder` | — | POST /tasks/:id/abandon — terminal "retire this task" transition (task 987). |
 | POST | `/api/bongos/tasks/:id/attest-gate` | `any-builder` | `head_sha` | POST /tasks/:id/attest-gate — body: { head_sha }. |
 | POST | `/api/bongos/tasks/:id/confirm` | `any-builder` | `verified` |  |