@bongos/core 1.21.1 → 1.21.2

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

@@ -49,17 +49,31 @@
     'first-parallel-claim': '⚓',
     'streak-3': '\u{1F525}',
     'streak-7': '\u{1F30B}',
-    'art-pipeline-shipper': '\u{1F3A8}',
+    // task 1004438: renamed Art Pipeline Engineer; the palette is the artist's now
+    'art-pipeline-shipper': '\u{1F6E0}\u{FE0F}',
+    'first-thought-ignited': '\u{1F4A1}',
+    'first-full-idea': '\u{1F4DC}',
+    'first-board-ratification': '\u{1F3DB}\u{FE0F}',
+    'thought-built-ten': '\u{1F31F}',
+    'first-page-approved': '\u{1F3A8}',
+    'ten-pages-approved': '\u{1F5BC}\u{FE0F}',
+    'whole-surface-tweaked': '\u{1F5FA}\u{FE0F}',
     'gds-shipper': '⚙️',
     'breaking-the-100c-bar': '\u{1F4AF}',
   };
+  // An achievement id as a sentence: "first-page-approved" → "First page approved".
+  function achWords(id) {
+    var s = String(id || '').replace(/-/g, ' ');
+    return s.charAt(0).toUpperCase() + s.slice(1);
+  }
   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>' : '';
+      // The title is the achievement's name as words ("First page approved"), not
+      // its id slug (task 1004438): it is what a hover shows and a screen reader says.
+      var words = achWords(id);
+      return emoji ? '<span class="lb-ach" title="' + esc(words) + '" aria-label="' + esc(words) + '">' + emoji + '</span>' : '';
     }).join('');
     return inner ? '<span class="lb-ach-row" aria-label="achievements">' + inner + '</span>' : '';
   }
@@ -94,9 +108,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 +147,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 +165,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 +180,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 +191,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 +226,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 +328,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,17 +1076,26 @@ 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).
+// The catalog is small and changes only by migration (the latest: the seven
+// craft achievements of task 1004438, migrations/core_270), so hardcoding the
+// emoji map here is cheaper than another API round-trip per page load. Mirrors
+// modules/hall-ui/public/roster.js ACH_EMOJI — tests/craft_achievements.mjs
+// holds both maps to the migration's ids and icons.
 const ACH_EMOJI = {
   'first-ship': '🚢',
   'first-claim': '🪙',
   'first-parallel-claim': '⚓',
   'streak-3': '🔥',
   'streak-7': '🌋',
-  'art-pipeline-shipper': '🎨',
+  // task 1004438: renamed Art Pipeline Engineer; the palette is the artist's now
+  'art-pipeline-shipper': '🛠️',
+  'first-thought-ignited': '💡',
+  'first-full-idea': '📜',
+  'first-board-ratification': '🏛️',
+  'thought-built-ten': '🌟',
+  'first-page-approved': '🎨',
+  'ten-pages-approved': '🖼️',
+  'whole-surface-tweaked': '🗺️',
   'gds-shipper': '⚙️',
   'breaking-the-100c-bar': '💯',
 };
@@ -1101,14 +1110,35 @@ function renderAchievementRow(ids) {
     if (!emoji) continue;
     const span = document.createElement('span');
     span.className = 'leader__ach';
-    span.title = id;
-    span.setAttribute('aria-label', id);
+    // the name as words ("First page approved"), not the id slug (task 1004438)
+    const words = String(id).replace(/-/g, ' ');
+    span.title = words.charAt(0).toUpperCase() + words.slice(1);
+    span.setAttribute('aria-label', span.title);
     span.textContent = emoji;
     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 +1168,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 */

package/package-lock.json

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

package/package.json

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

@@ -8662,6 +8662,10 @@
   ],
   "1.21.0": [],
   "1.21.1": [
+    {
+      "id": "1004437",
+      "text": "The builders list now shows each person's roles (Engineer, Artist, Ideator, main one first), counting a role once the person has earned credits in it. Buttons above it (Everyone, Engineers, Artists, Ideators) rank people by th"
+    },
     {
       "id": "1004522",
       "text": "The Governor City design now lives in the project itself, not only in a private design canvas. This is the design where a governor's home is a small animated city and each part of the government is a building. All six design f"
@@ -8694,5 +8698,11 @@
       "id": "1004505",
       "text": "A new project's address now works the first time you open it. The platform creates the address before anything else, and the hub only links it once the platform has seen it answer. Before, an early click could leave your home"
     }
+  ],
+  "1.21.2": [
+    {
+      "id": "1004438",
+      "text": "Artists and ideators now earn achievements for their own work, not only for shipping code. Ideators: First Thought Ignited, First Full Idea, Ratified by the Board, and A Thought That Built Ten. Artists: First Page Approved, Te"
+    }
   ]
 }