@bongos/core 1.20.54 → 1.20.55

package/.bongos-core.json

@@ -2,11 +2,11 @@
   "artifact": "bongos-core",
   "manifest_schema": 1,
   "generator": "scripts/gds/package-core.js",
-  "core_version": "1.20.54",
-  "core_contract": "1.20.54",
-  "source_commit": "0fb32cfd989215446812f0ee1f953d35325b8606",
+  "core_version": "1.20.55",
+  "core_contract": "1.20.55",
+  "source_commit": "0fb1d496d093ffd8b5166b91733a65060da69014",
   "source_ref": "HEAD",
-  "built_at": "2026-10-01T05:26:34.110Z",
+  "built_at": "2026-10-01T05:41:11.828Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
     "docs_redacted": 569,
@@ -17,7 +17,7 @@
     "gate": "passed"
   },
   "file_count": 3334,
-  "tree_sha256": "18a0716b2420187019ac58ed948d1c70ab971cc342734b0d628faf68167191ea",
+  "tree_sha256": "9359eda1fabf15c48b2fc4d7c303de23772ed6b0ca09824edf83d8acb6bc78f2",
   "files": [
     {
       "path": ".claude/skills/ask-for-help/SKILL.md",
@@ -2287,12 +2287,12 @@
     {
       "path": "docs/copy-inventory.md",
       "mode": "0000644",
-      "sha256": "432295beaf30da14491132723fe17f9334b21cf323243c4dae889b87065068b9"
+      "sha256": "676131a6c53ccc299f025f6ca641909126234bd9482846e33536e1fabf3fed2e"
     },
     {
       "path": "docs/copy-registry.json",
       "mode": "0000644",
-      "sha256": "36b5e5a089e407b68cbb30eaa3f27955abb90de934c44b3f466529b752e99c2a"
+      "sha256": "576c91e194b6f846f0594493a2b0c26d0b8b2ee1d68e8c4b6ec6fb13fd79623b"
     },
     {
       "path": "docs/design/apex-pass-2-direction.md",
@@ -2797,7 +2797,7 @@
     {
       "path": "docs/module-api-changelog.md",
       "mode": "0000644",
-      "sha256": "a7fa1446d5105ab6ed15cd26c615671b427efc4d55aae6eb9bf47bfe574f390d"
+      "sha256": "a5144c331936e77ad1842a5a105861816b55a9b3afc0b8864bebd2ed7c097291"
     },
     {
       "path": "docs/modules-contract.md",
@@ -2887,7 +2887,7 @@
     {
       "path": "docs/page-readings.json",
       "mode": "0000644",
-      "sha256": "ecc0b9355b0d07faaf9911d22b44db5d9b7652f5e01a45910a5bf2c2cb08eb4f"
+      "sha256": "89370aecc37c029b715409173cabebd147cb63f266c1cd5d083d4b66b90ac75a"
     },
     {
       "path": "docs/project-context.template.md",
@@ -4922,7 +4922,7 @@
     {
       "path": "modules/government/recommendations.js",
       "mode": "0000644",
-      "sha256": "2ae0e7f49aacbf966d466ca75a8dac4ab526496107fa491563890f310a8e24d4"
+      "sha256": "d831ebafe52bf1f3d61e3702a648c418a854e54cb96c4ba6b43ecd20ff5cd5ee"
     },
     {
       "path": "modules/government/resolver.js",
@@ -4932,7 +4932,7 @@
     {
       "path": "modules/government/routes/government.js",
       "mode": "0000644",
-      "sha256": "2e901a13f0d5624c246add50c66ed95e345a1979440d62c027c51d24cab6b16d"
+      "sha256": "8290486f1b25e9bb080911a5f6ed231bd8d1473bca87f8adafcbe01b9d98e962"
     },
     {
       "path": "modules/government/routes/rank-sync.js",
@@ -5487,7 +5487,7 @@
     {
       "path": "modules/hall-ui/public/government.js",
       "mode": "0000644",
-      "sha256": "1d74433b5971c17bfe84c7fd80ff7888ea6fdbea60413e7ad5fc0eca7f36ecc8"
+      "sha256": "fab666dad26e7b9b92d50ba3fb4027da0b9d166bf09291775ddf9c42619ddf38"
     },
     {
       "path": "modules/hall-ui/public/government.states.json",
@@ -9242,12 +9242,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "7f75af0db1642a139e780c4668c28ef7d4dd94d23606688cc932de869c92eb77"
+      "sha256": "402e96b388e6d955089715bb4ec23ffbf406723559a3cd0189d736344932c6d7"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "21aa86d2d5532b61965e866c80e9ccb6bb081f680b2c0ec6ec1c301029924750"
+      "sha256": "5e2b7d9fef83b43a5ed9e63c92e8abac5f19be08bc7efb9c0d304916a9ce59b6"
     },
     {
       "path": "public-docs/index.html",
@@ -9267,7 +9267,7 @@
     {
       "path": "release-notes.json",
       "mode": "0000644",
-      "sha256": "ebfd2ffffb89ec082dc9d5ebda46442a68adc7afab70f78b015f95ed2ba8eb84"
+      "sha256": "8ee955d907ac5a5443f58e71a05f624e61e80880dfecf8e2cc91cab1b760ec27"
     },
     {
       "path": "scripts/bongos-mcp.js",
@@ -11432,7 +11432,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "e894e0d14143f77b8d933b1a192250dc098db1883b839306ac2a40e39719a514"
+      "sha256": "b2916718459f0ffb6b4b6793ff8cc7ea10b56563556cdeb1a9c9db2926e3ab54"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -13347,7 +13347,7 @@
     {
       "path": "tests/government_recommendations.mjs",
       "mode": "0000644",
-      "sha256": "b915086865be9029ccc605a468937434f5916561a51f45a03b34cffeacf4249f"
+      "sha256": "b4d9b0ba70bb40332aff9cb981d4f3571e460191865ae5a7d2895636b8358703"
     },
     {
       "path": "tests/government_require_permission.mjs",
@@ -13362,7 +13362,7 @@
     {
       "path": "tests/government_routes.mjs",
       "mode": "0000644",
-      "sha256": "c04df68f34c55f13c908d4565d6d38116341738e611c14dba6577724725e9e85"
+      "sha256": "caec7484f283e0674b37a46ad24ba47668f58b10a19a07a03709a986e7e2f762"
     },
     {
       "path": "tests/government_seed.mjs",

package/docs/copy-inventory.md

@@ -246,6 +246,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `6d6d626fc518` | certain | Bulk release | `modules/hall-ui/public/work.html:165` |
 | `181cfa50b127` | certain | By the numbers | `modules/hall-ui/public/profile.html:60` |
 | `a015a43bfc7f` | certain | CLI access | `modules/hall-ui/public/settings.html:133` |
+| `09e863eb90af` | certain | Can: {…} | `modules/hall-ui/public/government.js:870` |
 | `084eb64bce72` | certain | Capabilities held by a machine identity, never by a person or a rank. Shown for completeness; nothing here can | `modules/hall-ui/public/government.html:123` |
 | `bdca1f219e6f` | certain | Cast objection | `modules/hall-ui/public/board-room.js:368` |
 | `a974494e44f3` | certain | Catalog at a glance | `modules/hall-ui/public/modules.html:53` |
@@ -1552,7 +1553,6 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `b6ceacaad5e5` | certain | pick another | `modules/hall-ui/public/studio.js:682` |
 | `b6ceacaad5e5` | certain | pick another | `modules/hall-ui/public/tweak-editor.html:105` |
 | `3b22c5af029b` | certain | rank or above, or that it is your own. | `modules/hall-ui/public/copy-desk.html:47` |
-| `a86aeceacc7e` | certain | rank {…} · may: {…} | `modules/hall-ui/public/government.js:870` |
 | `80ddf28baee7` | certain | rank-key (kebab-case) | `modules/hall-ui/public/government.html:82` |
 | `41a4b66c21e5` | certain | reads the control plane's own observation · ADR 0293 · every move is recorded with who asked | `modules/hall-ui/public/deploy.js:704` |
 | `8d810f134b7b` | certain | reconnect GitHub with repository access | `modules/hall-ui/public/deploy.js:416` |

package/docs/copy-registry.json

@@ -3812,6 +3812,15 @@
       "origin": "html-text",
       "confidence": "certain"
     },
+    {
+      "id": "09e863eb90af",
+      "surface": "builders-hall",
+      "text": "Can: {…}",
+      "file": "modules/hall-ui/public/government.js",
+      "line": 870,
+      "origin": "js-markup",
+      "confidence": "certain"
+    },
     {
       "id": "084eb64bce72",
       "surface": "builders-hall",
@@ -15566,15 +15575,6 @@
       "origin": "html-text",
       "confidence": "certain"
     },
-    {
-      "id": "a86aeceacc7e",
-      "surface": "builders-hall",
-      "text": "rank {…} · may: {…}",
-      "file": "modules/hall-ui/public/government.js",
-      "line": 870,
-      "origin": "js-markup",
-      "confidence": "certain"
-    },
     {
       "id": "80ddf28baee7",
       "surface": "builders-hall",

package/docs/module-api-changelog.md

@@ -2765,5 +2765,7 @@ is load-bearing: the script throws rather than guess if it is missing, and
         landed since 1.20.52 with no explicit bump. run 36818406554. (task 1002620)
   1.20.54 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
         landed since 1.20.53 with no explicit bump. run 36819731905. (task 1002620)
+  1.20.55 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
+        landed since 1.20.54 with no explicit bump. run 36820911043. (task 1002620)
 ---------------------------------------------------------------------------
 ```

package/docs/page-readings.json

@@ -1269,8 +1269,8 @@
       "surface": "builders",
       "title": "Government",
       "states_read": ["constitution","out","permissions","board","constitution-tab"],
-      "files_hash": "bbf04524bee9d2db",
-      "reading_hash": "f79ecbcfaec9cd68",
+      "files_hash": "f0884c4c6f7f0dd1",
+      "reading_hash": "7a4c380c5c88d659",
       "counts": {"lines":83,"placed":34,"shared":5,"unplaced":44},
       "omitted": {"data":28},
       "notes": ["board: an action failed (page.click: Timeout 6000ms exceeded.); read as it stood"],
@@ -1330,7 +1330,7 @@
         {"key":"L0053","section":"Recommended for your project","text":"{…} of {…}","placement":"placed","file":"modules/hall-ui/public/sky-panel.js","line":120,"string_id":"73c1372b43d9"},
         {"key":"L0054","section":"Recommended for your project","text":"{…} project{…}","placement":"placed","file":"modules/hall-ui/public/fleet.js","line":39,"string_id":"771bef3d31b5"},
         {"key":"L0055","section":"Recommended for your project","text":"{…} and {…}","placement":"placed","file":"modules/hall-ui/public/profile-nudge.js","line":77,"string_id":"56b00d773232","occurrences":2},
-        {"key":"L0056","section":"Recommended for your project","text":"rank {…} · may: {…}","placement":"placed","file":"modules/hall-ui/public/government.js","line":870,"string_id":"a86aeceacc7e","occurrences":2},
+        {"key":"L0056","section":"Recommended for your project","text":"Can: {…}","placement":"placed","file":"modules/hall-ui/public/government.js","line":870,"string_id":"09e863eb90af","occurrences":2},
         {"key":"L0057","section":"Charter library","text":"Charter library","placement":"placed","file":"modules/hall-ui/public/government.js","line":809,"string_id":"e6982a9ff948"},
         {"key":"L0058","section":"Charter library","text":"The seven government structures, for getting a team up to speed before deciding when to flip a switch.","placement":"placed","file":"modules/hall-ui/public/government.js","line":809,"string_id":"af664a644b13"},
         {"key":"L0059","section":"Charter library","text":"Selectable today","placement":"placed","file":"modules/hall-ui/public/government.js","line":809,"string_id":"ae43a132699b"},

package/modules/government/recommendations.js

@@ -83,6 +83,16 @@ const JOB_GRANTS = freeze({
     'goal.create', 'priority.run']),
 });
 
+// What each job can do, in the words a person would use (task 1004478). The
+// keys above are what the apply route grants; this is what the page shows, so
+// a reader never has to decode a permission key to judge a recommendation.
+// When a job's grants change, change its sentence in the same edit.
+const JOB_CAN = freeze({
+  reviewer: 'Check finished work against what "done" means, vote on tasks, and sort incoming ideas.',
+  lead: 'Write, edit and order tasks, move them into the queue, look after their own goals, sort ideas and check finished work.',
+  council: 'Put proposals to the board, ratify ideas, decide when a goal is met (or reopen it), create goals and set priorities.',
+});
+
 // What each type calls those jobs. The rank key is what gets created, so it is
 // a kebab-case slug the rank API accepts.
 const JOB_NAMES = freeze({
@@ -184,6 +194,7 @@ function recommendedRankSet(type, headcount) {
     label: JOB_NAMES[t][job].label,
     description: JOB_NAMES[t][job].description,
     permissions: JOB_GRANTS[job],
+    can: JOB_CAN[job],
   }));
   const why = ranks.length
     ? `At this size ${projectPhrase(t)} hands out ${ranks.length === 1 ? 'one job' : `${ranks.length} jobs`} beyond the four standard ranks. Each is added as a custom rank you can edit or delete.`
@@ -210,6 +221,7 @@ module.exports = {
   SIZE_BANDS,
   JOB_GRANTS,
   JOB_NAMES,
+  JOB_CAN,
   normalizeType,
   sizeBandFor,
   recommendedCharter,

package/modules/government/routes/government.js

@@ -320,12 +320,12 @@ module.exports = function buildGovernmentRouter() {
     const skipped = [];
     try {
       for (const r of set.ranks) {
-        if (await db.getRankByKey(r.rank_key)) { skipped.push(r.rank_key); continue; }
+        if (await db.getRankByKey(r.rank_key)) { skipped.push({ rank_key: r.rank_key, label: r.label }); continue; }
         let rank;
         try {
           rank = await db.createRank({ rankKey: r.rank_key, label: r.label, description: r.description, createdBy: req.builder.id });
         } catch (err) {
-          if (err && err.code === '23505') { skipped.push(r.rank_key); continue; }
+          if (err && err.code === '23505') { skipped.push({ rank_key: r.rank_key, label: r.label }); continue; }
           throw err;
         }
         const granted = [];

package/modules/hall-ui/public/government.js

@@ -870,7 +870,7 @@
     return `<li class="ov-row"><div class="ov-row__main">
       <span class="ov-row__title">${escapeHtml(r.label)}</span>
       <p class="ov-row__sub">${escapeHtml(r.description)}</p>
-      <p class="gov-charter__how">rank ${escapeHtml(r.rank_key)} · may: ${escapeHtml(r.permissions.join(', '))}</p>
+      <p class="ov-row__sub">Can: ${escapeHtml(r.can)}</p>
     </div></li>`;
   }
 
@@ -926,7 +926,7 @@
     try {
       const r = await sendJson('POST', '/government/rank-sets/apply', { type: reco.type, headcount: reco.headcount });
       const made = (r.created || []).map((c) => c.label);
-      const kept = r.skipped || [];
+      const kept = (r.skipped || []).map((s) => s.label);
       toast(made.length
         ? `Added ${made.join(', ')}.${kept.length ? ` Already here, left as they were: ${kept.join(', ')}.` : ''}`
         : 'Those ranks are already here — nothing changed.');

package/package-lock.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bongos/core",
-  "version": "1.20.54",
+  "version": "1.20.55",
   "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

@@ -8441,5 +8441,11 @@
       "id": "1004400",
       "text": "The Government page now recommends a starting government and a starting set of ranks for your kind of project (game, research, business, non-profit) and its size. It only ever recommends a form you can adopt today. A team of a"
     }
+  ],
+  "1.20.55": [
+    {
+      "id": "1004478",
+      "text": "The recommended ranks on the Government page now say in plain words what each one can do, for example \"Check finished work, vote on tasks, and sort incoming ideas\", instead of listing system codes. The confirmation after addin"
+    }
   ]
 }

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.20.54'; // CI auto-patch carrier (ADR 0161); changelog: docs/module-api-changelog.md
+const CORE_VERSION = '1.20.55'; // 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');

package/tests/government_recommendations.mjs

@@ -117,3 +117,16 @@ test('recommendationsFor carries both answers and the vocabulary to ask about an
   assert.equal(r.project_types.length, TYPES.length);
   for (const b of r.size_bands) assert.equal(reco.sizeBandFor(b.example).key, b.key, 'each size option lands in its own band');
 });
+
+test('the panel says what a recommended rank can do in words, never in permission keys (task 1004478)', () => {
+  for (const job of Object.keys(reco.JOB_GRANTS)) {
+    const can = reco.JOB_CAN[job];
+    assert.ok(typeof can === 'string' && can.length > 20, `job ${job} needs a plain sentence`);
+    assert.ok(!/[a-z]+\.[a-z_]+/.test(can), `job ${job}'s sentence must not spell a permission key`);
+  }
+  for (const r of reco.recommendedRankSet('game', 200).ranks) assert.equal(r.can, reco.JOB_CAN[r.job]);
+  const client = fs.readFileSync(path.join(ROOT, 'modules', 'hall-ui', 'public', 'government.js'), 'utf8');
+  const row = client.slice(client.indexOf('function recoRankRow'), client.indexOf('function recommendationHtml'));
+  assert.match(row, /r\.can/, 'the rank row renders the sentence');
+  assert.doesNotMatch(row, /permissions/, 'the rank row does not render the raw keys');
+});

package/tests/government_routes.mjs

@@ -254,7 +254,7 @@ test('POST /government/rank-sets/apply creates the missing ranks with their gran
   try {
     const r = await call('POST', '/government/rank-sets/apply', { type: 'game', headcount: 20 });
     assert.equal(r.status, 200);
-    assert.deepEqual(r.json.skipped, ['design-lead']);
+    assert.deepEqual(r.json.skipped, [{ rank_key: 'design-lead', label: 'Design lead' }], 'a kept rank is named by its label, not its key (task 1004478)');
     assert.deepEqual(r.json.created.map((c) => c.rank_key), ['playtester']);
     const creates = calls.filter(([k]) => k === 'createRank');
     assert.equal(creates.length, 1);