@bongos/core 1.21.105 → 1.21.107

package/modules/public-landing/public/projects.probes.json

@@ -167,12 +167,12 @@
     { "name": "part 02 (task 1004648): Change opens a row in place and reads Done, opening another closes it, and nothing needs confirming", "auth": true, "width": 1440, "url": "/projects?view=new",
       "steps": [["wait",600],["fill","#newName","Mercury"],["click","#typeCards .tpill[data-type=\"game\"]"],["fill","#f-desc","A co-op farming game where the seasons never repeat."],["select","#physCountry","US"],["wait",100],["click","[data-phys=\"builder_geography\"][data-val=\"global\"]"],["click","[data-phys=\"minors_on_board\"][data-val=\"false\"]"],["click","[data-phys=\"entity\"][data-val=\"intent-solo\"]"],["wait",300],["click","#reviewRows .setRow[data-row=\"team\"] [data-row-chg]"],["wait",200],["click","[data-phys-solo=\"many\"]"],["wait",600],["click","#reviewRows .setRow[data-row=\"run\"] [data-row-chg]"],["wait",300]],
       "expect": {"visible":["#reviewRows .setRow[data-row=\"rewards\"]","#reviewRows .setRow.open[data-row=\"run\"] .opts"],"hidden":["#reviewRows .setRow[data-row=\"team\"] .opts"],"text":[["#reviewRows .setRow[data-row=\"run\"] [data-row-chg]","Done"],["#reviewRows .setRow[data-row=\"team\"] [data-row-chg]","Change"]]} },
-    { "name": "the wizard driver (task 1004648): part 01, the checks, the address row (the dotless stub host takes a domain the founder owns), the tick, then Create — part 03 goes live with the checklist, the cloud hop and its status line", "auth": true, "width": 1440, "url": "/projects?view=new",
+    { "name": "the wizard driver (task 1004648): part 01, the checks, the address row (the dotless stub host takes a domain the founder owns), the tick, then Create — part 03 goes live as Getting <name> ready: one sentence, the checked facts, and the cloud hop behind its link", "auth": true, "width": 1440, "url": "/projects?view=new",
       "steps": [["wait",600],["fill","#newName","Mercury"],["click","#typeCards .tpill[data-type=\"game\"]"],["fill","#f-desc","A co-op farming game where the seasons never repeat."],["select","#physCountry","US"],["wait",100],["click","[data-phys=\"builder_geography\"][data-val=\"global\"]"],["click","[data-phys=\"minors_on_board\"][data-val=\"false\"]"],["click","[data-phys=\"entity\"][data-val=\"intent-solo\"]"],["wait",300],["click","#reviewRows .setRow[data-row=\"address\"] [data-row-chg]"],["wait",200],["fill","#f-slug","mercury"],["wait",900],["fill","#f-domain","mercury.example.com"],["wait",200],["click","#reviewRows .setRow[data-row=\"address\"] [data-row-chg]"],["wait",200],["click","#termsAck"],["wait",100],["click","#doCreate"],["wait",1500]],
-      "expect": {"visible":["#panel-done","#humanSteps","#hop","#hopCanvas","#hopStatus","#hopJump"],"hidden":["#wizParts","#liveProgress"],"text":[["#done-h","Setting up Mercury"],["#hopStatus","Raising the server, database, and address — nothing needed from you."]]} },
+      "expect": {"visible":["#panel-done","#setupNow","#homeFacts","#ghFacts","#hopLink"],"hidden":["#wizParts","#hop","#doneAlive"],"text":[["#donePartT","Getting Mercury ready"]]} },
     { "name": "the wizard driver at 320 (narrower than a 375 phone): the page stacks, nothing scrolls sideways, and the walk still reaches part 03", "auth": true, "width": 320, "url": "/projects?view=new",
       "steps": [["wait",600],["fill","#newName","Mercury"],["click","#typeCards .tpill[data-type=\"game\"]"],["fill","#f-desc","A co-op farming game where the seasons never repeat."],["select","#physCountry","US"],["wait",100],["click","[data-phys=\"builder_geography\"][data-val=\"global\"]"],["click","[data-phys=\"minors_on_board\"][data-val=\"false\"]"],["click","[data-phys=\"entity\"][data-val=\"intent-solo\"]"],["wait",300],["click","#reviewRows .setRow[data-row=\"address\"] [data-row-chg]"],["wait",200],["fill","#f-slug","mercury"],["wait",900],["fill","#f-domain","mercury.example.com"],["wait",200],["click","#reviewRows .setRow[data-row=\"address\"] [data-row-chg]"],["wait",200],["click","#termsAck"],["wait",100],["click","#doCreate"],["wait",1500]],
-      "expect": {"noOverflow":true,"visible":["#panel-done","#humanSteps"],"hidden":["#wizParts"]} },
+      "expect": {"noOverflow":true,"visible":["#panel-done","#homeFacts","#ghFacts"],"hidden":["#wizParts"]} },
     { "name": "invite a guild (task 1002303, R27): a /g/ address gives one pending line per member on its public page, each a link to the hall", "auth": true, "width": 1440, "url": "/projects?view=manage&id=101",
       "steps": [["wait",900],["fill","#mInviteGuild","/g/forge-crew"],["click","#mInvite [data-invite-guild]"],["wait",400]],
       "expect": { "count": [["#mInviteList li", 4]], "value": [["#mInviteGuild", ""]],

package/modules/public-landing/public/projects.states.json

@@ -56,7 +56,7 @@
     "in-new-look": {"auth":true,"url":"/projects?view=new","actions":[["wait",600],["fill","#newName","Mercury"],["click","#typeCards .tpill[data-type=\"game\"]"],["fill","#f-desc","A co-op farming game where the seasons never repeat."],["select","#physCountry","US"],["wait",100],["click","[data-phys=\"builder_geography\"][data-val=\"global\"]"],["click","[data-phys=\"minors_on_board\"][data-val=\"false\"]"],["click","[data-phys=\"entity\"][data-val=\"intent-solo\"]"],["wait",300],["click","#reviewRows .setRow[data-row=\"look\"] [data-row-chg]"],["wait",400]],"expect":{"visible":["#reviewRows .setRow.open[data-row=\"look\"] .opts","#wizLook"]}},
     "in-new-look-custom": {"auth":true,"url":"/projects?view=new","actions":[["wait",600],["fill","#newName","Mercury"],["click","#typeCards .tpill[data-type=\"game\"]"],["fill","#f-desc","A co-op farming game where the seasons never repeat."],["select","#physCountry","US"],["wait",100],["click","[data-phys=\"builder_geography\"][data-val=\"global\"]"],["click","[data-phys=\"minors_on_board\"][data-val=\"false\"]"],["click","[data-phys=\"entity\"][data-val=\"intent-solo\"]"],["wait",300],["click","#reviewRows .setRow[data-row=\"look\"] [data-row-chg]"],["wait",400],["click","#wizLook-custom"],["wait",200]],"expect":{"visible":["#reviewRows .setRow.open[data-row=\"look\"] .opts","#wizLook","#wizAccent","#wizAccentNote"]}},
     "in-new-create-blocked": {"auth":true,"url":"/projects?view=new","actions":[["wait",600],["fill","#newName","Mercury"],["click","#typeCards .tpill[data-type=\"game\"]"],["fill","#f-desc","A co-op farming game where the seasons never repeat."],["click","#termsAck"],["wait",100],["click","#doCreate"],["wait",400]],"expect":{"visible":["#reviewRows .setRow.open[data-row=\"address\"] .opts","#h-domain"],"hidden":["#doneBody"],"text":[["#createWhy","Fix the row that’s open, then create."]]}},
-    "in-new-done": {"auth":true,"url":"/projects?view=new","actions":[["wait",600],["fill","#newName","Mercury"],["click","#typeCards .tpill[data-type=\"game\"]"],["fill","#f-desc","A co-op farming game where the seasons never repeat."],["select","#physCountry","US"],["wait",100],["click","[data-phys=\"builder_geography\"][data-val=\"global\"]"],["click","[data-phys=\"minors_on_board\"][data-val=\"false\"]"],["click","[data-phys=\"entity\"][data-val=\"intent-solo\"]"],["wait",300],["click","#reviewRows .setRow[data-row=\"address\"] [data-row-chg]"],["wait",200],["fill","#f-slug","mercury"],["wait",900],["fill","#f-domain","mercury.example.com"],["wait",200],["click","#reviewRows .setRow[data-row=\"address\"] [data-row-chg]"],["wait",200],["click","#termsAck"],["wait",100],["click","#doCreate"],["wait",1500]],"expect":{"visible":["#panel-done","#doneBody","#humanSteps","#hop","#hopCanvas","#hopStatus","#hopJump","#wizRecap"],"hidden":["#wizParts","#qWrap","#wizInvite","#liveProgress","#wizInviteLater"],"attr":[["#doCreate","disabled",""],["#wizRoom","data-screen","done"]],"text":[["#done-h","Setting up Mercury"],["#doCreate","Created"]]}},
+    "in-new-done": {"auth":true,"url":"/projects?view=new","actions":[["wait",600],["fill","#newName","Mercury"],["click","#typeCards .tpill[data-type=\"game\"]"],["fill","#f-desc","A co-op farming game where the seasons never repeat."],["select","#physCountry","US"],["wait",100],["click","[data-phys=\"builder_geography\"][data-val=\"global\"]"],["click","[data-phys=\"minors_on_board\"][data-val=\"false\"]"],["click","[data-phys=\"entity\"][data-val=\"intent-solo\"]"],["wait",300],["click","#reviewRows .setRow[data-row=\"address\"] [data-row-chg]"],["wait",200],["fill","#f-slug","mercury"],["wait",900],["fill","#f-domain","mercury.example.com"],["wait",200],["click","#reviewRows .setRow[data-row=\"address\"] [data-row-chg]"],["wait",200],["click","#termsAck"],["wait",100],["click","#doCreate"],["wait",1500]],"expect":{"visible":["#panel-done","#doneBody","#setupNow","#homeFacts","#ghFacts","#hopLink","#wizRecap"],"hidden":["#wizParts","#qWrap","#wizInvite","#hop","#doneAlive"],"attr":[["#doCreate","disabled",""],["#wizRoom","data-screen","done"]],"text":[["#donePartT","Getting Mercury ready"],["#doCreate","Created"]]}},
     "in-new-resume-offer": {"auth":true,"url":"/projects?view=new","actions":[["wait",600],["fill","#newName","Mercury"],["click","#typeCards .tpill[data-type=\"game\"]"],["fill","#f-desc","A co-op farming game where the seasons never repeat."],["select","#physCountry","US"],["wait",100],["click","[data-phys=\"builder_geography\"][data-val=\"global\"]"],["click","[data-phys=\"minors_on_board\"][data-val=\"false\"]"],["click","[data-phys=\"entity\"][data-val=\"intent-solo\"]"],["wait",300],["click","#reviewRows .setRow[data-row=\"address\"] [data-row-chg]"],["wait",200],["fill","#f-slug","mercury"],["wait",900],["fill","#f-domain","mercury.example.com"],["wait",200],["click","#reviewRows .setRow[data-row=\"address\"] [data-row-chg]"],["wait",200],["click","#termsAck"],["wait",100],["click","#doCreate"],["wait",1500],["click","#projTrig"],["wait",350],["click","#menuProjects [data-nav=\"new\"]"],["wait",500]],"expect":{"visible":["#panel-page","#wizResume","#wizResumeGo","#wizParts"],"hidden":["#doneBody"],"text":[["#wizResumeName","Mercury"]]}},
     "out-new": {"auth":false,"url":"/projects?view=new","expect":{"visible":["#panel-gate","#wizSignin"],"hidden":["#qWrap","#panel-page"]}},
     "out-map-projects": { "auth": false, "actions": [["click", "#projTrig"], ["wait", 350]], "expect": { "expanded": true, "hidden": ["#menuProjects [data-nav=\"mine\"]"] } },

package/modules/ui-design/kit/fixtures/provisioning-instances-hall-live.json

@@ -1,5 +1,5 @@
 {
-  "_": "The owner's projects for the kit (task 1003345): four states the mine list and the manage page render — live, standing up, snagged, torn down. Timestamps written \"$now-3m\" / \"$now-1d\" are resolved by the stub at request time so \"checked 3m ago\" stays true. Mooring (task 1003345, the grade's finding): live but unreachable since its last probe, so the restart door renders and the restart probe has a row to drive.",
+  "_": "The owner's projects for the kit (task 1003345): four states the mine list and the manage page render — live, standing up, snagged, torn down. Timestamps written \"$now-3m\" / \"$now-1d\" are resolved by the stub at request time so \"checked 3m ago\" stays true. Mooring (task 1003345, the grade's finding): live but unreachable since its last probe, so the restart door renders and the restart probe has a row to drive. Mercury (102) also carries the owner read's GitHub halves (github_app, github_setup), produced by the REAL projections with the app approved, installed and signed in, so part 03 reaches every required fact done (task 1004683).",
   "instances": [
     {
       "id": 101,
@@ -44,7 +44,27 @@
         "state": "running",
         "created_at": "$now-6m"
       },
-      "dns_resolves": true
+      "dns_resolves": true,
+      "github_app": {
+        "status": "done",
+        "app_slug": "mercury-cloudbongos-com",
+        "failure": null,
+        "started_at": "2026-10-09T12:52:53.145Z"
+      },
+      "github_setup": {
+        "checklist": {
+          "approve": "done",
+          "install": "done",
+          "sign_in": "done",
+          "device_flow": "later",
+          "connected": true
+        },
+        "install_url": null,
+        "repo": "builder/mercury",
+        "verifying": true,
+        "pick_up": null,
+        "app_org": null
+      }
     },
     {
       "id": 103,

package/modules/ui-design/kit/fixtures/provisioning-instances-setup.json

@@ -0,0 +1,195 @@
+{
+  "_": "Part 03 after Create, one project per scenario of the design of record docs/design/mocks/day-night-rooms/setup-status.html (task 1004683): 201 just created, 202 waiting on GitHub, 203 installing, 204 stopped (the install never confirmed, the checking window over), 205 all done. Each row carries the github_app and github_setup halves of the owner's instance read, produced by the REAL projections (manifest-truth publicGithubApp, github-setup githubSetupRead); serve.js hands them out beside the instance on the single read. Regenerate the GitHub halves rather than hand-editing them.",
+  "instances": [
+    {
+      "id": 201,
+      "slug": "kestrel",
+      "domain": "kestrel.cloudbongos.com",
+      "target_ref": "founder/kestrel",
+      "hosting_shape": "cloud-host",
+      "onboard_mode": "greenfield",
+      "error_note": null,
+      "dns_note": null,
+      "torn_down_at": null,
+      "open_intent": null,
+      "status": "provisioning",
+      "created_at": "$now-1m",
+      "provisioned_at": null,
+      "updated_at": "$now-1m",
+      "last_verified_at": null,
+      "last_verified_up": null,
+      "dns_resolves": false,
+      "github_app": null,
+      "github_setup": {
+        "checklist": {
+          "approve": "todo",
+          "install": "todo",
+          "sign_in": "todo",
+          "device_flow": "todo",
+          "connected": false
+        },
+        "install_url": null,
+        "repo": "founder/kestrel",
+        "verifying": false,
+        "app_org": null,
+        "pick_up": null
+      }
+    },
+    {
+      "id": 202,
+      "slug": "heron",
+      "domain": "heron.cloudbongos.com",
+      "target_ref": "founder/heron",
+      "hosting_shape": "cloud-host",
+      "onboard_mode": "greenfield",
+      "error_note": null,
+      "dns_note": null,
+      "torn_down_at": null,
+      "open_intent": null,
+      "status": "active",
+      "created_at": "$now-9m",
+      "provisioned_at": "$now-6m",
+      "updated_at": "$now-6m",
+      "last_verified_at": null,
+      "last_verified_up": null,
+      "dns_resolves": false,
+      "github_app": {
+        "status": "pending",
+        "app_slug": null,
+        "failure": null,
+        "started_at": "2026-10-09T12:48:57.326Z"
+      },
+      "github_setup": {
+        "checklist": {
+          "approve": "now",
+          "install": "todo",
+          "sign_in": "todo",
+          "device_flow": "todo",
+          "connected": false
+        },
+        "install_url": null,
+        "repo": "founder/heron",
+        "verifying": false,
+        "pick_up": "reopen",
+        "app_org": null
+      }
+    },
+    {
+      "id": 203,
+      "slug": "plover",
+      "domain": "plover.cloudbongos.com",
+      "target_ref": "founder/plover",
+      "hosting_shape": "cloud-host",
+      "onboard_mode": "greenfield",
+      "error_note": null,
+      "dns_note": null,
+      "torn_down_at": null,
+      "open_intent": null,
+      "status": "active",
+      "created_at": "$now-14m",
+      "provisioned_at": "$now-11m",
+      "updated_at": "$now-11m",
+      "last_verified_at": "$now-9s",
+      "last_verified_up": true,
+      "dns_resolves": true,
+      "github_app": {
+        "status": "converting",
+        "app_slug": "plover-cloudbongos-com",
+        "failure": null,
+        "started_at": "2026-10-09T12:45:57.326Z"
+      },
+      "github_setup": {
+        "checklist": {
+          "approve": "done",
+          "install": "now",
+          "sign_in": "now",
+          "device_flow": "todo",
+          "connected": false
+        },
+        "install_url": "https://github.com/apps/plover-cloudbongos-com/installations/new",
+        "repo": "founder/plover",
+        "verifying": true,
+        "pick_up": null,
+        "app_org": null
+      }
+    },
+    {
+      "id": 204,
+      "slug": "tern",
+      "domain": "tern.cloudbongos.com",
+      "target_ref": "founder/tern",
+      "hosting_shape": "cloud-host",
+      "onboard_mode": "greenfield",
+      "error_note": null,
+      "dns_note": null,
+      "torn_down_at": null,
+      "open_intent": null,
+      "status": "active",
+      "created_at": "$now-4h",
+      "provisioned_at": "$now-235m",
+      "updated_at": "$now-235m",
+      "last_verified_at": "$now-9s",
+      "last_verified_up": true,
+      "dns_resolves": true,
+      "github_app": {
+        "status": "done",
+        "app_slug": "tern-cloudbongos-com",
+        "failure": null,
+        "started_at": "2026-10-09T08:59:57.326Z"
+      },
+      "github_setup": {
+        "checklist": {
+          "approve": "done",
+          "install": "now",
+          "sign_in": "done",
+          "device_flow": "later",
+          "connected": false
+        },
+        "install_url": "https://github.com/apps/tern-cloudbongos-com/installations/new",
+        "repo": "founder/tern",
+        "verifying": false,
+        "pick_up": "check",
+        "app_org": null
+      }
+    },
+    {
+      "id": 205,
+      "slug": "wren",
+      "domain": "wren.cloudbongos.com",
+      "target_ref": "founder/wren",
+      "hosting_shape": "cloud-host",
+      "onboard_mode": "greenfield",
+      "error_note": null,
+      "dns_note": null,
+      "torn_down_at": null,
+      "open_intent": null,
+      "status": "active",
+      "created_at": "$now-30m",
+      "provisioned_at": "$now-27m",
+      "updated_at": "$now-27m",
+      "last_verified_at": "$now-3s",
+      "last_verified_up": true,
+      "dns_resolves": true,
+      "github_app": {
+        "status": "done",
+        "app_slug": "wren-cloudbongos-com",
+        "failure": null,
+        "started_at": "2026-10-09T12:25:57.326Z"
+      },
+      "github_setup": {
+        "checklist": {
+          "approve": "done",
+          "install": "done",
+          "sign_in": "done",
+          "device_flow": "later",
+          "connected": true
+        },
+        "install_url": null,
+        "repo": "founder/wren",
+        "verifying": true,
+        "pick_up": null,
+        "app_org": null
+      }
+    }
+  ]
+}

package/modules/ui-design/kit/serve.js

@@ -309,12 +309,27 @@ function instances(res, id, settings) {
   if (FAIL.has(name)) return json(res, 500, { error: { code: 'stub_failure', message: `FAIL=${name}` } });
   const file = path.join(FIXTURES, (ALIAS[name] || name) + '.json');
   if (!fs.existsSync(file)) return json(res, 404, { error: { code: 'no_fixture', message: name } });
-  const list = stamp((JSON.parse(fs.readFileSync(file, 'utf8')).instances || []).map(withAsk).map(withPlanet));
+  // a fixture row may carry the owner read's two GitHub halves (github_app, github_setup —
+  // the shapes modules/provisioning/routes/provisioning.js adds, task 1004683); they ride
+  // the single read beside the instance, never inside it, and never the list
+  const rows = stamp((JSON.parse(fs.readFileSync(file, 'utf8')).instances || []).map(withAsk).map(withPlanet));
+  const bare = (i) => { const { github_app, github_setup, ...rest } = i; return rest; };
+  const list = rows.map(bare);
   if (id === null) return json(res, 200, { instances: list });
-  const inst = list.find((i) => String(i.id) === String(id));
-  if (!inst) return json(res, 404, { error: { code: 'not_found', message: 'no such instance' } });
+  const row = rows.find((i) => String(i.id) === String(id));
+  if (!row) return json(res, 404, { error: { code: 'not_found', message: 'no such instance' } });
+  const inst = bare(row);
   if (settings) return json(res, 200, { settings: { platform_visibility: 'public', joinability: 'open', visibility: 'public' }, planet: PLANETS.get(String(id)) || NO_PLANET, options: { platform_visibility: ['public', 'gated'], joinability: ['open', 'apply', 'invite_only'], visibility: ['public', 'private', 'stealth'] } });
-  return json(res, 200, { instance: inst, open_intent: inst.open_intent || null });
+  return json(res, 200, { instance: inst, open_intent: inst.open_intent || null, github_app: row.github_app || null, github_setup: row.github_setup || null });
+}
+// GET /provisioning/github-app/resume?id=N — the route's resume record (routes/github-setup.js
+// resumeRecord) for a fixture project, so a render can open part 03 on it by URL alone
+function resumeAnswer(res, id) {
+  const file = path.join(FIXTURES, (ALIAS['provisioning-instances'] || 'provisioning-instances') + '.json');
+  const rows = fs.existsSync(file) ? (JSON.parse(fs.readFileSync(file, 'utf8')).instances || []) : [];
+  const inst = id ? rows.find((i) => String(i.id) === String(id)) : null;
+  const repo = inst && /^[A-Za-z0-9][A-Za-z0-9-]{0,38}\/[A-Za-z0-9._-]{1,100}$/.test(String(inst.target_ref || '')) ? inst.target_ref : null;
+  return json(res, 200, { ok: true, project: inst ? { id: inst.id, slug: inst.slug, domain: inst.domain || null, onboard_mode: inst.onboard_mode || 'greenfield', repo } : null });
 }
 // A project's art in the featured fixture may be root-relative (the surface's
 // own /assets/…, served by this stub) — the page accepts only an http(s) art
@@ -644,6 +659,9 @@ const server = http.createServer((req, res) => {
     if (/^\/provisioning\/instances\/\d+\/invite-suggestions$/.test(rest) && req.method === 'GET') {
       return AUTH ? json(res, 200, { suggested: [], seeking: null, reason: null }) : json(res, 401, UNAUTH);
     }
+    if (rest === '/provisioning/github-app/resume' && req.method === 'GET') {
+      return AUTH ? resumeAnswer(res, u.searchParams.get('id')) : json(res, 401, UNAUTH);
+    }
     const one = rest.match(/^\/provisioning\/instances\/(\d+)(\/settings)?$/);
     if (one && req.method === 'GET') return AUTH ? instances(res, one[1], !!one[2]) : json(res, 401, UNAUTH);
     // the hub's own cross-project surface (task 1003774): the requested/leave/

package/package-lock.json

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

package/package.json

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

package/release-notes.json

@@ -9476,5 +9476,17 @@
       "id": "1004666",
       "text": "A check that is still running is no longer reported as a failed one. Before, a project whose test service posts a \"still working\" status would see its change called broken and trigger a pointless repair attempt; now it is corr"
     }
+  ],
+  "1.21.106": [
+    {
+      "id": "1004683",
+      "text": "After pressing Create, a founder now sees \"Getting <name> ready\" with a plain count (\"4 of 6 done\", or \"ready\" with a tick) and one sentence saying what is happening and whether it is their turn. Below it are two short lists,"
+    }
+  ],
+  "1.21.107": [
+    {
+      "id": "1004677",
+      "text": "A project now has a switch for letting a runner pick up submitted page tweaks on its own, off by default, with a monthly limit of 20 rounds. The server enforces the limit when the work is claimed, so two runners can never both"
+    }
   ]
 }

package/scripts/gds/government-walk.js

@@ -70,6 +70,7 @@ const BAD = 'x';
 const REQUESTS = Object.freeze({
   'PATCH /project-settings/rot-days': ['PATCH', '/project-settings/rot-days', { days: 'soon' }],
   'PATCH /project-settings/ship-mode': ['PATCH', '/project-settings/ship-mode', { mode: 'sometimes' }],
+  'PATCH /project-settings/tweak-autopickup': ['PATCH', '/project-settings/tweak-autopickup', { mode: 'sometimes' }],
   'PATCH /work-categories/:id': ['PATCH', `/work-categories/${BAD}`, {}],
   'POST /security/reports/:id/confirm': ['POST', `/security/reports/${BAD}/confirm`, {}],
   'POST /security/reports/:id/dispute': ['POST', `/security/reports/${BAD}/dispute`, {}],

package/scripts/gds/run-unit-tests.js

@@ -121,6 +121,9 @@ const INTEGRATION = new Set([
   // index actually refuses the commingling INSERT and still allows the parallel
   // -worktree case. It self-skips without a DB, and refuses any database that
   // has a `builders` table, since it TRUNCATEs claims.
+  // task 1004677: two marked auto-pickup claims racing for the last slot of the
+  // monthly cap; only real connections prove the advisory lock. Scratch DB only.
+  'autopickup_cap_db',
   'claims_requested_worktree_db',
   'clawback_confirmed_backlog',
   // task 1003113: the copy_desk_flags schema half. The module's own tests are

package/src/bongos/project-settings.js

@@ -50,6 +50,8 @@ const SETTING_KEYS = {
   ROT_DAYS: 'attention.rot_days',
   FOCUS_VERSION: 'roadmap.focus_version',
   SHIP_MODE: 'ship.mode',
+  TWEAK_AUTOPICKUP: 'tweak.autopickup',
+  TWEAK_AUTOPICKUP_CAP: 'tweak.autopickup_monthly_cap',
 };
 
 // SHIP MODE (task 1004628, ADR 0369) — WHO starts a ship, never HOW it lands.
@@ -278,6 +280,75 @@ function describeShipMode(resolved) {
   return `${what}${how}`;
 }
 
+
+// TWEAK AUTO-PICKUP (task 1004677, ADR 0371 D3/D5). Whether the Autobongos runner's
+// tweak lane may pick up a submitted page round on its own, and how many rounds it
+// may pick up per calendar month. Off by default: a project that never turns it on
+// keeps today's queue exactly. The cap is ENFORCED by the server at claim time
+// (modules/lifecycle/autopickup.js); this file only resolves the numbers.
+const AUTOPICKUP_MODES = Object.freeze(['off', 'on']);
+const DEFAULT_AUTOPICKUP = 'off';
+// 20 rounds: a grade costs the project a few dollars, so 20 is a bounded, legible
+// monthly spend at about the level of one active artist (ADR 0371 D5).
+const DEFAULT_AUTOPICKUP_CAP = 20;
+// Past 1000 the cap is an off switch typed as a big number; that should be asked
+// for out loud, the same reasoning as MAX_ROT_DAYS.
+const MAX_AUTOPICKUP_CAP = 1000;
+
+function parseAutopickup(raw) {
+  if (raw == null || String(raw).trim() === '') return { reason: 'empty' };
+  const v = String(raw).trim().toLowerCase();
+  if (!AUTOPICKUP_MODES.includes(v)) return { reason: `must be one of ${AUTOPICKUP_MODES.join(' | ')}` };
+  return { mode: v };
+}
+
+function parseAutopickupCap(raw) {
+  if (raw == null || raw === '') return { reason: 'empty' };
+  const n = Number(raw);
+  if (!Number.isFinite(n)) return { reason: 'not a number' };
+  if (!Number.isInteger(n)) return { reason: 'must be a whole number of rounds' };
+  if (n <= 0) return { reason: 'must be positive' };
+  if (n > MAX_AUTOPICKUP_CAP) return { reason: `out of range (1..${MAX_AUTOPICKUP_CAP})` };
+  return { cap: n };
+}
+
+// One knob through its parser: { value, source, invalid }. Never throws; an
+// unreadable database answers the default, the resolveShipMode posture.
+async function resolveOne(key, parse, pick, fallback) {
+  let row = null;
+  try {
+    row = await getSetting(key);
+  } catch (err) {
+    logger.error(`project_settings read failed; falling back to the default ${key}: ${err && err.message}`);
+    return { value: fallback, source: 'default', invalid: null };
+  }
+  if (row && row.value != null && row.value !== '') {
+    const got = parse(row.value);
+    if (pick(got) != null) return { value: pick(got), source: 'project_settings', invalid: null };
+    return { value: fallback, source: 'default', invalid: { where: `project_settings['${key}']`, raw: String(row.value), reason: got.reason } };
+  }
+  return { value: fallback, source: 'default', invalid: null };
+}
+
+// resolveTweakAutopickup() — { mode, cap, source: { mode, cap }, invalid: [...] }.
+// mode is always 'off' or 'on', cap always a usable positive integer.
+async function resolveTweakAutopickup() {
+  const m = await resolveOne(SETTING_KEYS.TWEAK_AUTOPICKUP, parseAutopickup, (g) => g.mode, DEFAULT_AUTOPICKUP);
+  const c = await resolveOne(SETTING_KEYS.TWEAK_AUTOPICKUP_CAP, parseAutopickupCap, (g) => g.cap, DEFAULT_AUTOPICKUP_CAP);
+  return {
+    mode: m.value,
+    cap: c.value,
+    source: { mode: m.source, cap: c.source },
+    invalid: [m.invalid, c.invalid].filter(Boolean),
+  };
+}
+
+function describeTweakAutopickup(resolved) {
+  const r = resolved || {};
+  if (r.mode !== 'on') return 'Off: a submitted page waits until a person runs /tweak for it.';
+  return `On: a running Autobongos runner applies submitted pages on its own, up to ${r.cap} a month. The artist still approves every one.`;
+}
+
 // parseDays is exported for the tests only — the range check and the default are
 // asserted against the SAME constants the resolver reads, because a test that
 // re-typed 30 or 365 would be the second copy of the number this file exists to
@@ -299,4 +370,12 @@ module.exports = {
   parseShipMode,
   resolveShipMode,
   describeShipMode,
+  AUTOPICKUP_MODES,
+  DEFAULT_AUTOPICKUP,
+  DEFAULT_AUTOPICKUP_CAP,
+  MAX_AUTOPICKUP_CAP,
+  parseAutopickup,
+  parseAutopickupCap,
+  resolveTweakAutopickup,
+  describeTweakAutopickup,
 };

package/src/module-api.js

@@ -75,7 +75,7 @@ const { responsibilityFor, ROLE_RESPONSIBILITIES } = require('./role-responsibil
 // MAJOR (see allowBoxScope below): passes the request through untouched.
 function deprecatedNoopMiddleware(_req, _res, next) { next(); }
 
-const CORE_VERSION = '1.21.105'; // CI auto-patch carrier (ADR 0161); changelog: docs/module-api-changelog.md
+const CORE_VERSION = '1.21.107'; // CI auto-patch carrier (ADR 0161); changelog: docs/module-api-changelog.md
 
 // A namespaced logger so a module's log lines are attributable + consistent.
 // Usage: const log = api.logger('discord'); log.info('mounted');
@@ -474,6 +474,13 @@ module.exports = {
     get parseShipMode() { return require('./bongos/project-settings').parseShipMode; },
     get resolveShipMode() { return require('./bongos/project-settings').resolveShipMode; },
     get describeShipMode() { return require('./bongos/project-settings').describeShipMode; },
+    // Tweak auto-pickup (task 1004677, ADR 0371 D3/D5): the switch and the monthly cap.
+    get AUTOPICKUP_MODES() { return require('./bongos/project-settings').AUTOPICKUP_MODES; },
+    get MAX_AUTOPICKUP_CAP() { return require('./bongos/project-settings').MAX_AUTOPICKUP_CAP; },
+    get parseAutopickup() { return require('./bongos/project-settings').parseAutopickup; },
+    get parseAutopickupCap() { return require('./bongos/project-settings').parseAutopickupCap; },
+    get resolveTweakAutopickup() { return require('./bongos/project-settings').resolveTweakAutopickup; },
+    get describeTweakAutopickup() { return require('./bongos/project-settings').describeTweakAutopickup; },
   },
   readConfigFileSync: instanceConfig.readConfigFileSync,
   configHome: instanceConfig.configHome,