@bongos/core 1.21.1 → 1.21.3

package/modules/economy/credits.js

@@ -429,9 +429,21 @@ async function bookIdeaSplit(client, { payees, reason, taskId = null, describe }
     if (rowCount > 0) credited += p.delta;
     booked.push({ ...p, booked: rowCount > 0 });
   }
+  // task 1004438: an idea credit is an ideator's moment (First Thought Ignited,
+  // First Full Idea, Ratified by the Board, A Thought That Built Ten), and it is
+  // booked inside someone else's ship, so the shipper's reconcile never reaches
+  // the payee. Every idea stream books through here; each payee just paid is
+  // reconciled, and the hook can never fail the payment.
+  for (const p of booked) {
+    if (p.booked) await craftAchievements().reconcileAfterCraftCredit(client, p.builderId, { taskId });
+  }
   return { credited, payees: booked };
 }
 
+// Lazy: achievements.js sits beside this file and requires nothing of it, but a
+// load-time require would make the two files' load order matter for no reason.
+function craftAchievements() { return require('./achievements'); }
+
 // Stream 2 (ADR 0172 / IC2): a Full Idea with a passing completeness score pays
 // its author IDEA_FULL_PASS_CREDIT, ONCE. Transaction-participant like the rest
 // of the reward port — the caller passes its `client` (a pool works too, since
@@ -1243,6 +1255,10 @@ async function awardArtistPageCredit(client, { taskId, config = rewardConfig() }
     [t.artist_id, taskId, priced.effective, reason,
       `Approved page tweak, task #${taskId}: ${priced.description} to its artist (artist lane, ADR 0341 D10)`]
   );
+  // task 1004438: an approved page is the artist's moment (First Page Approved,
+  // Ten Pages Approved, A Whole Surface). Reconciled here as well as at ship, so
+  // a re-sweep that pays the round outside the ship still reaches the shelf.
+  if (rowCount > 0) await craftAchievements().reconcileAfterCraftCredit(client, t.artist_id, { taskId });
   return rowCount > 0
     ? { credited: priced.effective, reason: 'paid', artistId: t.artist_id, delta: priced.effective }
     : { credited: 0, reason: 'already_paid', artistId: t.artist_id, delta: priced.effective };

package/modules/economy/reward.js

@@ -55,6 +55,9 @@ module.exports = {
   // fires on EVERY ship path (incl. confirmTask / grader_bypass, which never
   // evaluated achievements before, so most builders only ever got first-claim).
   reconcileBuilderAchievements: (...a) => achievements.reconcileBuilderAchievements(...a),
+  // task 1004438: the craft badges a migration cannot backfill ("A Whole Surface"
+  // needs the page inventory, a file) — the lifecycle's sweep runs this once per start.
+  backfillCraftAchievements: (...a) => achievements.backfillCraftAchievements(...a),
   // pure helpers + constants (display / tests)
   applyKindMultiplier: (...a) => credits.applyKindMultiplier(...a),
   computeSessionTokenReward: (...a) => credits.computeSessionTokenReward(...a),

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

@@ -1174,7 +1174,7 @@
       getJSON(`${API}/achievements`),
       getJSON(`${API}/me/recent-ships?limit=all`),
       getJSON(`${API}/versions`),
-      getJSON(`${API}/leaderboard`),
+      getJSON(`${API}/public/leaderboard`), // task 1004437: the list with each builder's roles
       getJSON(`${API}/public/progress`), // task 1003464: "<version> is N percent shipped"
     ]);
 

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

@@ -578,6 +578,7 @@
           <span>Member since ${fmtDate(builder.created_at)}</span>
           <span title="${escapeHtml(karmaTooltip)}">${karmaTrend.replace(' in 30d', ' karma in 30d')}</span>
           ${rollPlace ? `<span title="Your place on the leaderboard (top ${rollPlace.total}), ranked by ${curLabel()}.">#${rollPlace.place} on the leaderboard</span>` : ''}
+          ${rolePlaceText(rollPlace) ? `<span title="Your place among the ${rollPlace.role.total} builders shown as ${ROLE_AS[rollPlace.role.craft]}, ranked by the ${curLabel()} that role earned.">${rolePlaceText(rollPlace)}</span>` : ''}
         </div>
         <div class="profile__disciplines">
           <span class="profile__disc-label">Preferred work:</span>
@@ -611,7 +612,7 @@
     setText('stat-karma-sub', karmaTrendText);
     const statRank = document.getElementById('stat-rank');
     if (statRank) statRank.innerHTML = builder.rank ? renderRankBadge(normalizeRank(builder.rank), { tip: false }) : '—';
-    setText('stat-rank-sub', rollPlace ? `#${rollPlace.place} on the leaderboard` : '');
+    setText('stat-rank-sub', rollPlace ? [`#${rollPlace.place} on the leaderboard`, rolePlaceText(rollPlace)].filter(Boolean).join(' · ') : '');
     const statsSection = document.getElementById('home-stats');
     if (statsSection && !ctx.newcomerGated) statsSection.hidden = false;
 
@@ -1274,7 +1275,28 @@
       (a, b) => (Number(b.total_credits) || 0) - (Number(a.total_credits) || 0),
     );
     const idx = ranked.findIndex((r) => r.github_login === login);
-    return idx === -1 ? null : { place: idx + 1, total: ranked.length };
+    if (idx === -1) return null;
+    // task 1004437: the place inside the builder's MAIN role too, the roster's
+    // role toggle read the same way (credits earned in that craft, among the
+    // builders it is shown for), so an artist's card can say where they stand
+    // as an artist and not only beside every engineer's session pay.
+    const me = ranked[idx];
+    const main = me.roles && me.roles.main;
+    let role = null;
+    if (main && me.roles.credits_by_craft) {
+      const credit = (r) => Number(r.roles && r.roles.credits_by_craft && r.roles.credits_by_craft[main]) || 0;
+      const peers = ranked.filter((r) => r.roles && Array.isArray(r.roles.shown) && r.roles.shown.includes(main));
+      const order = peers.map((r, i) => ({ r, i })).sort((a, b) => (credit(b.r) - credit(a.r)) || (a.i - b.i));
+      const at = order.findIndex((x) => x.r === me);
+      if (at !== -1) role = { craft: main, place: at + 1, total: peers.length };
+    }
+    return { place: idx + 1, total: ranked.length, role };
+  }
+  const ROLE_AS = { engineer: 'an engineer', artist: 'an artist', ideator: 'an ideator' };
+  // "#2 as an artist" — only when it says something the overall place does not.
+  function rolePlaceText(p) {
+    if (!p || !p.role || !ROLE_AS[p.role.craft] || p.role.place === p.place) return '';
+    return `#${p.role.place} as ${ROLE_AS[p.role.craft]}`;
   }
 
   // task 1003459 — the Claim button on each Home "Next up" row, through the

package/modules/hall-ui/public/roster.css

@@ -22,6 +22,27 @@
 .dir-who__t { display: flex; flex-direction: column; gap: 1px; min-width: 132px; }
 .dir-name { font-weight: 500; color: var(--ink); overflow-wrap: anywhere; }
 .dir-login { font-family: var(--font-mono); font-size: 11.5px; color: var(--ink-faint); }
+/* ---- the roles (task 1004437, the approved mock's leaderboard) -------------
+   The toggle: pill chips on the glass, the pressed one filled in ink (the mock's
+   .chip). The roles column: one pill per role shown, the main one a step
+   stronger (the mock's .role / .role--lead, the profile header's chips). */
+.roster-roles { display: flex; flex-wrap: wrap; gap: 6px; margin: 0 0 var(--sp-sm); }
+.roster-role {
+  min-height: 34px; padding: 0 14px; border: 0; border-radius: var(--radius-pill);
+  background: var(--glass); color: var(--ink-soft);
+  font: inherit; font-size: 13px; cursor: pointer;
+}
+.roster-role:hover { color: var(--ink); background: var(--glass-strong); }
+.roster-role[aria-pressed="true"] { background: var(--ink); color: var(--bg-card); }
+.lb-roles { display: inline-flex; flex-wrap: wrap; gap: 4px; }
+.lb-role {
+  display: inline-flex; align-items: center; min-height: 24px; padding: 0 9px;
+  border-radius: var(--radius-pill); background: var(--glass);
+  font-size: 12.5px; color: var(--ink-soft); white-space: nowrap;
+}
+.lb-role--lead { background: var(--glass-strong); color: var(--ink); }
+.lb-roles--none, .lb-none { color: var(--ink-faint); }
+
 /* The roster's place cell carries two facts: the place, and under it the
    builder's number in the same mono/faint voice the login uses (task
    1002837). Block display so the id never wraps up beside the place. */

package/modules/hall-ui/public/roster.html

@@ -34,6 +34,9 @@
              link into index.html. It is a page now; /#leaderboard redirects here. -->
         <section class="scroll" id="roster-scroll" aria-labelledby="roster-h">
           <h2 id="roster-h" class="scroll__h">The roster<span class="count-pill" id="roster-count" hidden></span></h2>
+          <!-- The role toggle (task 1004437, owner decision (b)): Everyone, then one
+               chip per craft; a craft ranks by the credits earned in it. -->
+          <div class="roster-roles" id="roster-roles" role="group" aria-label="Show"></div>
           <div id="roster-filters"></div>
           <div id="roster-body">
             <div class="profile__placeholder">Loading the roster…</div>

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

@@ -14,7 +14,7 @@
 // marked `private` still appears on the roster of a project they build on
 // (owner, 2026-08-30; ADR 0225, task 1003443).
 //
-// The laurels (ACH_EMOJI + achRowHtml) and the sort lenses MOVED here from
+// The laurels (ACH + achRowHtml) and the sort lenses MOVED here from
 // hall-render.js rather than being copied — the leaderboard row was their only
 // caller, so the home page is left carrying no dead renderer.
 (function () {
@@ -43,23 +43,36 @@
     return '<span class="rank-badge ' + variant + '" aria-label="' + esc(aria) + '">' + esc(rankLabel(rank)) + '</span>';
   }
 
-  var ACH_EMOJI = {
-    'first-ship': '\u{1F6A2}',
-    'first-claim': '\u{1FA99}',
-    'first-parallel-claim': '⚓',
-    'streak-3': '\u{1F525}',
-    'streak-7': '\u{1F30B}',
-    'art-pipeline-shipper': '\u{1F3A8}',
-    'gds-shipper': '⚙️',
-    'breaking-the-100c-bar': '\u{1F4AF}',
+  // Each laurel's emoji AND its catalog name (the achievements table's `name`,
+  // migrations 006/019/031/core_270), so a hover and a screen reader say what the
+  // badge is called (task 1004532) — never the id, and never words derived from it,
+  // which disagree with the catalog the moment a badge is renamed.
+  // tests/craft_achievements.mjs holds every row to the catalog.
+  var ACH = {
+    'first-ship': ['\u{1F6A2}', 'First Ship'],
+    'first-claim': ['\u{1FA99}', 'First Claim'],
+    'first-parallel-claim': ['⚓', 'First Parallel Claim'],
+    'streak-3': ['\u{1F525}', 'Streak: 3 Nights'],
+    'streak-7': ['\u{1F30B}', 'Streak: 7 Nights'],
+    // task 1004438: renamed Art Pipeline Engineer; the palette is the artist's now
+    'art-pipeline-shipper': ['\u{1F6E0}\u{FE0F}', 'Art Pipeline Engineer'],
+    'subtractor': ['\u{1FA93}', 'Subtractor'],
+    'gds-shipper': ['⚙️', 'Bongos Shipper'],
+    'breaking-the-100c-bar': ['\u{1F4AF}', 'Breaking the 100c Bar'],
+    'first-thought-ignited': ['\u{1F4A1}', 'First Thought Ignited'],
+    'first-full-idea': ['\u{1F4DC}', 'First Full Idea'],
+    'first-board-ratification': ['\u{1F3DB}\u{FE0F}', 'Ratified by the Board'],
+    'thought-built-ten': ['\u{1F31F}', 'A Thought That Built Ten'],
+    'first-page-approved': ['\u{1F3A8}', 'First Page Approved'],
+    'ten-pages-approved': ['\u{1F5BC}\u{FE0F}', 'Ten Pages Approved'],
+    'whole-surface-tweaked': ['\u{1F5FA}\u{FE0F}', 'A Whole Surface'],
   };
   function achRowHtml(ids) {
     if (!Array.isArray(ids) || !ids.length) return '';
     var inner = ids.map(function (id) {
-      var emoji = ACH_EMOJI[id];
-      // Title is the achievement id (kebab) — terse enough that hover discloses
-      // the laurel without overstating the prose.
-      return emoji ? '<span class="lb-ach" title="' + esc(id) + '" aria-label="' + esc(id) + '">' + emoji + '</span>' : '';
+      var a = ACH[id];
+      // The title is the badge's catalog name: what a hover shows and a screen reader says.
+      return a ? '<span class="lb-ach" title="' + esc(a[1]) + '" aria-label="' + esc(a[1]) + '">' + a[0] + '</span>' : '';
     }).join('');
     return inner ? '<span class="lb-ach-row" aria-label="achievements">' + inner + '</span>' : '';
   }
@@ -94,9 +107,34 @@
     return '<span class="dir-who">' + avatar + '<span class="dir-who__t">' + nameHtml + login + '</span></span>';
   }
 
+  // task 1004437 (WA6.RP07): the roles. Each row's `roles` block is the public
+  // list's own (src/bongos/role-stats.js readRolesForBuilders): `shown` is the
+  // main role first, then every craft the builder has EARNED in — evidence of
+  // work, not only what they declared — and `credits_by_craft` is the ledger
+  // split. Owner decision (b): a column naming them AND the role toggle above,
+  // which ranks by the credits earned in that craft. The figure a role ranks by
+  // is in the row (ADR 0255: a public list is ordered only by what it publishes).
+  var CRAFTS = ['engineer', 'artist', 'ideator'];
+  var CRAFT_WORD = { engineer: 'Engineer', artist: 'Artist', ideator: 'Ideator' };
+  var ROLE_CHIPS = [['', 'Everyone'], ['engineer', 'Engineers'], ['artist', 'Artists'], ['ideator', 'Ideators']];
+  function shownOf(b) { return (b.roles && Array.isArray(b.roles.shown)) ? b.roles.shown : []; }
+  function craftCredits(b, craft) {
+    var by = b.roles && b.roles.credits_by_craft;
+    return by ? (Number(by[craft]) || 0) : 0;
+  }
+  function creditOf(b) { return role ? craftCredits(b, role) : (Number(b.total_credits) || 0); }
+  function rolesHtml(b) {
+    var shown = shownOf(b);
+    if (!shown.length) return '<span class="lb-roles lb-roles--none">—</span>';
+    return '<span class="lb-roles">' + shown.map(function (c, i) {
+      return '<span class="lb-role' + (i === 0 ? ' lb-role--lead' : '') + '">' + esc(CRAFT_WORD[c] || c) + '</span>';
+    }).join('') + '</span>';
+  }
+
   var all = [];
   var query = '';
   var sortBy = '';
+  var role = '';
 
   // PLACE IS CANONICAL, not the row's position in the current sort.
   // hall-render's leaderboardPlace() already defines a builder's place as
@@ -108,6 +146,16 @@
     rows.slice()
       .sort(function (a, b) { return (Number(b.total_credits) || 0) - (Number(a.total_credits) || 0); })
       .forEach(function (b, i) { b.__place = i + 1; });
+    // A role's place is the same idea inside that role: credits earned in the
+    // craft, descending, among the builders it is shown for. Stamped once too,
+    // so the place under a role toggle does not renumber under a search.
+    rows.forEach(function (b) { b.__placeBy = {}; });
+    CRAFTS.forEach(function (c) {
+      rows.filter(function (b) { return shownOf(b).indexOf(c) !== -1; })
+        .map(function (b, i) { return { b: b, i: i }; })
+        .sort(function (x, y) { return (craftCredits(y.b, c) - craftCredits(x.b, c)) || (x.i - y.i); })
+        .forEach(function (x, i) { x.b.__placeBy[c] = i + 1; });
+    });
     // The efficiency title is stamped here too, so the division and the string
     // work happen ONCE per load rather than per visible row per render (every
     // sort, search keystroke and page turn re-renders).
@@ -116,6 +164,7 @@
   }
 
   function matches(b) {
+    if (role && shownOf(b).indexOf(role) === -1) return false;
     if (!query) return true;
     var hay = ((b.github_login || '') + ' ' + (b.display_name || '')).toLowerCase();
     return hay.indexOf(query) !== -1;
@@ -130,7 +179,8 @@
     tokens: function (b) { return -(Number(b.tokens_used) || 0); },
   };
   function ordered(rows) {
-    var key = SORTS[sortBy];
+    // The default lens is credits; under a role it is the credits that role earned.
+    var key = SORTS[sortBy] || (role ? function (b) { return -craftCredits(b, role); } : null);
     if (!key) return rows;
     return rows.map(function (b, i) { return { b: b, i: i }; })
       .sort(function (x, y) { return (key(x.b) - key(y.b)) || (x.i - y.i); })
@@ -140,7 +190,14 @@
   var pager = kit.makePager('roster', 'hall-roster-per-page', { defaultPerPage: 25 });
   var ledger = null;
 
+  // Tokens only mean something for AI sessions. A builder who works in the
+  // browser (an artist in the studio, an ideator in the room) records none, and
+  // a 0 beside them reads as "did nothing" (task 1004437): their cell says so in
+  // words instead, and the tokens-per-credit figure is offered only where there
+  // are tokens to divide.
+  function hasTokens(b) { return (Number(b.tokens_used) || 0) > 0; }
   function efficiencyTitle(b) {
+    if (!hasTokens(b)) return 'No AI sessions recorded — this builder’s work is not measured in tokens';
     var credits = Number(b.total_credits) || 0;
     var one = currencyLabel().toLowerCase().replace(/s$/, '');
     if (credits <= 0) return 'no ' + currencyLabel().toLowerCase() + ' earned yet';
@@ -168,20 +225,69 @@
   }
 
   function rowHtml(b) {
+    var place = role ? (b.__placeBy && b.__placeBy[role]) : b.__place;
+    var tokens = hasTokens(b)
+      ? esc(fmtInt(b.tokens_used))
+      : '<span class="lb-none" aria-label="No AI sessions">—</span>';
     return '<tr>'
-      + '<td class="ledger__num ledger__place">' + esc(String(b.__place || '—')) + idHtml(b) + '</td>'
+      + '<td class="ledger__num ledger__place">' + esc(String(place || '—')) + idHtml(b) + '</td>'
       + '<td>' + whoHtml(b) + foundingHtml(b) + achRowHtml(b.achievements) + '</td>'
+      + '<td class="ledger__roles">' + rolesHtml(b) + '</td>'
       + '<td class="ledger__rank">' + rankBadgeHtml(b.rank) + '</td>'
-      + '<td class="ledger__num">' + esc(fmtInt(b.total_credits)) + '</td>'
+      + '<td class="ledger__num">' + esc(fmtInt(creditOf(b))) + '</td>'
       + '<td class="ledger__num">' + esc(fmtInt(b.karma)) + '</td>'
-      + '<td class="ledger__num" title="' + esc(b.__eff || '') + '">' + esc(fmtInt(b.tokens_used)) + '</td>'
+      + '<td class="ledger__num" title="' + esc(b.__eff || '') + '">' + tokens + '</td>'
       + '</tr>';
   }
 
+  function columns() {
+    return ['Place', 'Builder', 'Roles', 'Rank',
+      { label: role ? currencyLabel() + ' as ' + CRAFT_WORD[role].toLowerCase() : currencyLabel(), class: 'ledger__num' },
+      { label: 'Karma', class: 'ledger__num' },
+      { label: 'Tokens', class: 'ledger__num' }];
+  }
+
+  function makeRosterLedger() {
+    body.textContent = '';
+    body.className = '';
+    ledger = kit.makeLedger({
+      mount: body,
+      columns: columns(),
+      rowHtml: rowHtml,
+      emptyMsg: role
+        ? 'No builder on the roster has earned as ' + CRAFT_WORD[role].toLowerCase() + ' yet, or none matches that search.'
+        : 'No builder on the roster matches that search.',
+      pager: pager,
+    });
+  }
+
   function rerender() {
     if (ledger) ledger.render(ordered(all.filter(matches)));
   }
 
+  // The role toggle (owner decision (b)): Everyone, then one per craft. A pressed
+  // chip ranks by the credits that craft earned and shows only the builders it
+  // is shown for. The ledger is rebuilt so the credits header names the craft.
+  function roleChipsHtml() {
+    return ROLE_CHIPS.map(function (c) {
+      return '<button type="button" class="roster-role" data-role="' + esc(c[0]) + '" aria-pressed="' + (c[0] === role) + '">' + esc(c[1]) + '</button>';
+    }).join('');
+  }
+  function mountRoleChips() {
+    var mount = document.getElementById('roster-roles');
+    if (!mount) return;
+    mount.innerHTML = roleChipsHtml();
+    mount.addEventListener('click', function (e) {
+      var btn = e.target.closest('[data-role]');
+      if (!btn || btn.dataset.role === role) return;
+      role = btn.dataset.role;
+      mount.querySelectorAll('[data-role]').forEach(function (b) { b.setAttribute('aria-pressed', String(b.dataset.role === role)); });
+      pager.page = 1;
+      makeRosterLedger();
+      rerender();
+    });
+  }
+
   function notice(msg) {
     body.innerHTML = '';
     body.className = 'note';
@@ -221,23 +327,16 @@
         rerender();
       },
     });
-    body.textContent = '';
-    body.className = '';
-    ledger = kit.makeLedger({
-      mount: body,
-      columns: ['Place', 'Builder', 'Rank',
-        { label: currencyLabel(), class: 'ledger__num' },
-        { label: 'Karma', class: 'ledger__num' },
-        { label: 'Tokens', class: 'ledger__num' }],
-      rowHtml: rowHtml,
-      emptyMsg: 'No builder on the roster matches that search.',
-      pager: pager,
-    });
+    mountRoleChips();
+    makeRosterLedger();
     rerender();
   }
 
   var foundingLoad = window.OTBFounding ? window.OTBFounding.load() : Promise.resolve([]);
-  fetch('/api/bongos/leaderboard', { headers: { Accept: 'application/json' } })
+  // The PUBLIC list (task 1004437): the same rows the authed /leaderboard
+  // carries plus each builder's roles, and the one the status page reads, so
+  // the hall and the public page cannot rank a role differently.
+  fetch('/api/bongos/public/leaderboard', { headers: { Accept: 'application/json' } })
     .then(function (r) {
       if (!r.ok) throw new Error('http ' + r.status);
       return r.json();

package/modules/hall-ui/public/roster.states.json

@@ -1,5 +1,5 @@
 {
-  "_": "Builders — this project's OWN roster, ranked by credits earned (task 1003441, goal 1000075). Was the #leaderboard hash view on index.html; /#leaderboard now redirects here. Deliberately UNGATED, because its one data source (GET /leaderboard) is deliberately unauthenticated and mirrors the public status surface — so unlike a gated page's states file the `out` state below renders the real page rather than a seal. Populated look: the hall-preview harness (scripts/hall-preview/fixtures/leaderboard.json carries thirteen builders with avatars, ranks, karma and tokens).",
+  "_": "Builders — this project's OWN roster, ranked by credits earned (task 1003441, goal 1000075). Was the #leaderboard hash view on index.html; /#leaderboard now redirects here. Deliberately UNGATED, because its one data source (GET /leaderboard) is deliberately unauthenticated and mirrors the public status surface — so unlike a gated page's states file the `out` state below renders the real page rather than a seal. Populated look: the hall-preview harness (scripts/hall-preview/fixtures/public__leaderboard.json, since task 1004437 the list the page reads: fifteen builders with avatars, ranks, karma, tokens and each one's roles, including an artist and an ideator with no AI sessions).",
   "page": "/builders/roster",
   "surface": "hall-ui",
   "stub": {
@@ -44,6 +44,31 @@
         ]
       }
     },
+    "artists": {
+      "_": "The role toggle with Artists pressed (task 1004437, owner decision (b)): only the builders shown as artists, ranked by the credits that craft earned, the credits header naming the craft. Against the harness the browser-only artist (2001) leads, with a dash where an AI builder's tokens would be. The harness serves public__leaderboard.json, which carries the roles.",
+      "auth": true,
+      "actions": [
+        [
+          "wait",
+          700
+        ],
+        [
+          "click",
+          "[data-role=\"artist\"]"
+        ],
+        [
+          "wait",
+          200
+        ]
+      ],
+      "expect": {
+        "visible": [
+          "#roster-scroll",
+          "#roster-roles",
+          ".lb-roles"
+        ]
+      }
+    },
     "search": {
       "auth": true,
       "actions": [

package/modules/hall-ui/records/builders-roster.md

@@ -8,3 +8,23 @@
 - **It is deliberately UNGATED,** and `tests/hall_page_gate_map.mjs` spells that out rather than defaulting. Its one data source, `GET /leaderboard`, is deliberately unauthenticated and mirrors the public status surface; a page must not be gated tighter than the API it fronts, and it was already reachable to a stranger as a view on the ungated index. No visibility predicate is applied and that is correct — privacy suppresses cross-project surfaces only, so a `private` builder still appears on the roster of a project they build on (ADR 0225).
 
 Pinned by `tests/hall_nav.mjs` (the Community group's middle id is `roster`) and `tests/hall_page_gate_map.mjs`. Measured through `roster.states.json` — whose `out` state renders the REAL page, since the page is ungated.
+
+## The roles (task 1004437, WA6.RP07)
+
+Owner decision (b), 2026-09-30: the leaderboard gets BOTH a column naming each builder's roles and the Everyone / Engineers / Artists / Ideators toggle above it. The approved mock is `docs/design/mocks/profile-roles/` (`?state=board`, `?state=board-artists`).
+
+- **The roster now reads `GET /public/leaderboard`,** the list the status page reads, which carries each row's `roles` (`src/bongos/role-stats.js` `readRolesForBuilders`: the profile's own main/shown rules, two reads for the whole page) and, since this task, `karma`. The hall and the public page cannot rank a role differently. The authed `/leaderboard` is unchanged and no longer read by the hall.
+- **Roles column:** one pill per role in `roles.shown`, the main one a step stronger. `shown` is the main role plus every craft the builder has EARNED in, so it is evidence of work, not only a declared preference.
+- **The toggle** keeps the builders a craft is shown for and ranks them by the credits that craft earned (`roles.credits_by_craft`, in the row: ADR 0255). The place column becomes the place inside that craft, the credits header says "Credits as artist", and the karma/rank/tokens lenses still apply on top.
+- **Tokens only where they apply.** A builder with no recorded AI session (an artist in the studio, an ideator in the room) reads a dash, and the cell's tooltip says no AI sessions were recorded, instead of a 0 and a "0 tokens per credit" figure that read as "did nothing".
+- **Home's Standing card** reads the same list and adds "#N as an artist" beside "#N on the leaderboard" when the place inside the builder's main role differs from the overall one (`hall-render.js` `rolePlaceText`).
+- **The status page** names each builder's roles under their name, on that page's own palette (`status.js` `renderRoles`).
+
+Pinned by `tests/leaderboard_roles.mjs` (the read, the route, the REAL roster.js over the harness fixture with the toggle clicked, the Standing card's place and the status renderer, run). The `artists` state in `roster.states.json` renders the toggle pressed.
+
+### Deliberate differences from the mock (RP07)
+
+- **No "Best known for" column.** Each row's headline count (works shipped, pages approved, thoughts ignited) is a per-builder read in three different modules; the list would pay three more reads for every page of builders. The profile, one click away, leads with exactly that number.
+- **The roster keeps its live columns**: place with the builder's number, rank, karma and tokens, the founding mark and the laurels, and its search and sort lenses. The mock draws the leaderboard bare; the live hall's chrome wins (the blend rule).
+- **The column is "Roles", not "Preferred roles"**: it lists roles the builder has earned in as well as the one they chose, so "preferred" would understate it.
+- **The status page has the roles but not the toggle.** It is a one-glance public dashboard of the top builders on its own palette; the toggle lives on the roster, which is the leaderboard a builder works from.

package/modules/lifecycle/publish-reconciler.js

@@ -944,6 +944,29 @@ async function runPromotionSweep(deps = {}) {
   }
 }
 
+// The craft-achievement backfill (task 1004438, WA6.RP08): the one badge a
+// migration cannot backfill, "A Whole Surface", needs the page inventory, which is
+// a file the database never sees. Run ONCE per process start, on the first tick,
+// through the reward port (economy is optional; no port, no sweep). Pure DB and
+// idempotent, so a restart that runs it again unlocks nothing twice; a failure is
+// logged and never touches the other sweeps.
+let craftBackfillDone = false;
+async function runCraftAchievementBackfill(deps = {}) {
+  const { logFn, errFn } = loggers(deps);
+  if (craftBackfillDone && !deps.forceCraftBackfill) return { skipped: 'already_ran' };
+  craftBackfillDone = true;
+  const reward = deps.reward || seams.resolveOptional('reward');
+  if (!reward || typeof reward.backfillCraftAchievements !== 'function') return { skipped: 'unsupported' };
+  try {
+    const out = await reward.backfillCraftAchievements({});
+    if (out && out.unlocked) logFn(`[publish-reconciler] craft achievements: ${out.unlocked} unlocked across ${out.checked} builder(s)`);
+    return out;
+  } catch (e) {
+    errFn(`[publish-reconciler] craft achievement backfill (non-blocking): ${e && e.message}`);
+    return { skipped: 'error', error: e && e.message };
+  }
+}
+
 // Start the periodic sweep. Idempotent (a second call is a no-op). Kill-switched
 // by PUBLISH_RECONCILER_DISABLED=1 (purely additive bookkeeping, so it's ON by
 // default whenever a push credential is configured; the route's getPublishStatus
@@ -964,6 +987,7 @@ function start(deps = {}) {
     runCostSweep(deps).catch(crashHandler('cost sweep'));
     runCriterionSweep(deps).catch(crashHandler('criterion sweep'));
     runPromotionSweep(deps).catch(crashHandler('promotion sweep'));
+    runCraftAchievementBackfill(deps).catch(crashHandler('craft achievement backfill'));
   };
 
   firstTimer = setTimeout(tick, FIRST_SWEEP_DELAY_MS);
@@ -1002,6 +1026,7 @@ module.exports = {
   runCostSweep,
   runPromotionSweep,
   runCriterionSweep,
+  runCraftAchievementBackfill,
   couldBeStaleGenerated,
   describeTarget,
   INTERVAL_MS,

package/modules/status-ui/public/status.js

@@ -1076,19 +1076,31 @@ function updateHeadlineShippedFromItems() {
 
 // ---------- leaderboard ----------
 
-// Set is locked at 8 for V2 (per limitations/pms-v2.md), so hardcoding the
-// emoji map here is cheaper than another API round-trip per page load.
-// Mirrors public-builders/builders.js — keep both in sync if the catalog
-// ever shifts (would require an ADR + version bump per the V2 contract).
-const ACH_EMOJI = {
-  'first-ship': '🚢',
-  'first-claim': '🪙',
-  'first-parallel-claim': '⚓',
-  'streak-3': '🔥',
-  'streak-7': '🌋',
-  'art-pipeline-shipper': '🎨',
-  'gds-shipper': '⚙️',
-  'breaking-the-100c-bar': '💯',
+// The catalog is small and changes only by migration (the latest: the seven
+// craft achievements of task 1004438, migrations/core_270), so hardcoding it here
+// is cheaper than another API round-trip per page load. Each laurel carries its
+// emoji AND its catalog name (task 1004532), so a hover and a screen reader say
+// what the badge is called — never the id, and never words derived from it.
+// Mirrors modules/hall-ui/public/roster.js ACH — tests/craft_achievements.mjs
+// holds both maps to the catalog's ids, icons and names.
+const ACH = {
+  'first-ship': ['🚢', 'First Ship'],
+  'first-claim': ['🪙', 'First Claim'],
+  'first-parallel-claim': ['⚓', 'First Parallel Claim'],
+  'streak-3': ['🔥', 'Streak: 3 Nights'],
+  'streak-7': ['🌋', 'Streak: 7 Nights'],
+  // task 1004438: renamed Art Pipeline Engineer; the palette is the artist's now
+  'art-pipeline-shipper': ['🛠️', 'Art Pipeline Engineer'],
+  'subtractor': ['🪓', 'Subtractor'],
+  'gds-shipper': ['⚙️', 'Bongos Shipper'],
+  'breaking-the-100c-bar': ['💯', 'Breaking the 100c Bar'],
+  'first-thought-ignited': ['💡', 'First Thought Ignited'],
+  'first-full-idea': ['📜', 'First Full Idea'],
+  'first-board-ratification': ['🏛️', 'Ratified by the Board'],
+  'thought-built-ten': ['🌟', 'A Thought That Built Ten'],
+  'first-page-approved': ['🎨', 'First Page Approved'],
+  'ten-pages-approved': ['🖼️', 'Ten Pages Approved'],
+  'whole-surface-tweaked': ['🗺️', 'A Whole Surface'],
 };
 
 function renderAchievementRow(ids) {
@@ -1097,18 +1109,37 @@ function renderAchievementRow(ids) {
   row.className = 'leader__achievements';
   row.setAttribute('aria-label', 'achievements');
   for (const id of ids) {
-    const emoji = ACH_EMOJI[id];
-    if (!emoji) continue;
+    const a = ACH[id];
+    if (!a) continue;
     const span = document.createElement('span');
     span.className = 'leader__ach';
-    span.title = id;
-    span.setAttribute('aria-label', id);
-    span.textContent = emoji;
+    span.title = a[1];
+    span.setAttribute('aria-label', a[1]);
+    span.textContent = a[0];
     row.appendChild(span);
   }
   return row.children.length > 0 ? row : null;
 }
 
+// task 1004437 (WA6.RP07): each row names its roles, main first — the crafts
+// the builder has EARNED in, from the row's own `roles.shown`, not only what
+// they declared. The same words the hall's roster uses. Text only, never markup.
+const ROLE_WORD = { engineer: 'Engineer', artist: 'Artist', ideator: 'Ideator' };
+function renderRoles(roles) {
+  const shown = roles && Array.isArray(roles.shown) ? roles.shown.filter((c) => ROLE_WORD[c]) : [];
+  if (!shown.length) return null;
+  const row = document.createElement('span');
+  row.className = 'leader__roles';
+  row.setAttribute('aria-label', 'roles');
+  shown.forEach((c, i) => {
+    const chip = document.createElement('span');
+    chip.className = i === 0 ? 'leader__role leader__role--lead' : 'leader__role';
+    chip.textContent = ROLE_WORD[c];
+    row.appendChild(chip);
+  });
+  return row;
+}
+
 async function loadLeaderboard() {
   const data = await fetchJson('/api/bongos/public/leaderboard');
   const rows = data.leaderboard || [];
@@ -1138,6 +1169,8 @@ async function loadLeaderboard() {
     login.className = 'leader__login';
     login.textContent = `@${b.github_login}`;
     name.appendChild(login);
+    const roles = renderRoles(b.roles);
+    if (roles) name.appendChild(roles);
     const badges = renderAchievementRow(b.achievements);
     if (badges) name.appendChild(badges);
     const credits = document.createElement('div');

package/modules/status-ui/public/style.css

@@ -749,6 +749,30 @@ main {
   letter-spacing: 0;
 }
 
+/* The roles under each builder's name (task 1004437): one small tag per role
+   the builder has earned in, the main one a step stronger, as the hall's
+   roster and the approved mock draw them, on this page's own palette. */
+.leader__roles {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 4px;
+  margin-top: 4px;
+}
+.leader__role {
+  display: inline-flex;
+  align-items: center;
+  min-height: 22px;
+  padding: 0 8px;
+  border: 1px solid var(--rule-soft);
+  font-family: var(--font-body);
+  font-size: 0.78rem;
+  font-weight: 400;
+  letter-spacing: 0;
+  color: var(--ink-soft);
+  text-transform: none;
+}
+.leader__role--lead { color: var(--ink); border-color: var(--rule); }
+
 /* Inline laurels next to each architect's name. Slightly dimmed so the
    name still leads the row; emoji glyphs would otherwise punch above the
    marble palette. PMS-V2 #54 */