@bongos/core 1.23.14 → 1.23.15

package/modules/platform-identity/builder-of-the-week.js

@@ -0,0 +1,180 @@
+// modules/platform-identity/builder-of-the-week.js — Builder of the Week (community
+// spec D5, docs/specs/bongos-v1-community-tab.md; task 1002981, goal 1000110 CT5).
+// The read behind GET /community/builder-of-the-week, for the hub's /community/week
+// page and the line above the leaderboard.
+//
+// THE RULE (owner-signed 2026-08-16; the week decided 2026-10-27): of the builders
+// the leaderboard may show (rollupVisibleSql), the one who earned the most credits
+// across every project in the last FULL week — Monday 00:00 to Monday 00:00 UTC —
+// among those who shipped at least one work in it. Ties go to more works shipped,
+// then more karma, then handle/login so the answer is stable.
+//
+// THE WEEK IS READ FROM HISTORY, NOT FROM THE LIVE ROWS. Per (project, builder) it is
+// the last snapshot at-or-before the week's end minus the last at-or-before its start
+// (activity-snapshots.js), summed across projects. With no snapshot before the week, a
+// row counts from zero only if the hub first saw it during the week (first_seen_at,
+// migration 032; owner 2026-10-27): the leaderboard's missing-baseline rule would let a
+// builder last seen before snapshots began win one week with their whole lifetime, and
+// a crown is never corrected. A returning builder's first week back is the cost. A snapshot's reported_at never runs
+// backwards, so once the week has ended its numbers cannot move, and whoever asks
+// first gets the same answer.
+//
+// CROWNED AT RENDER, NO CRON (spec D5). The first read after Monday 00:00 UTC decides
+// the week and writes it to platform_identity_weekly_features (migration 032) with
+// ON CONFLICT DO NOTHING; every later read finds the row. A week nobody won is written
+// too (github_id NULL), so it stays empty. Nothing updates a row.
+//
+// WHO IS SHOWN is decided again on every read: a winner who has since hidden their
+// numbers or gone private is not drawn, on the crown or in the past weeks, and their
+// week is not given to anyone else (spec D8). A hidden winner and an empty week look
+// the same. Viewer-independent; github_id never crosses the projection.
+'use strict';
+
+const { pool: defaultPool } = require('../../src/module-api');
+const { rollupVisibleSql } = require('./account-visibility');
+
+const DAY_MS = 24 * 60 * 60 * 1000;
+const WEEK_MS = 7 * DAY_MS;
+// How many weeks before the current one the past-weeks list shows.
+const ARCHIVE_WEEKS = 12;
+
+// The Monday 00:00 UTC that opens the week `now` is in.
+function mondayOf(now) {
+  const midnight = Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate());
+  const sinceMonday = (new Date(midnight).getUTCDay() + 6) % 7;
+  return new Date(midnight - sinceMonday * DAY_MS);
+}
+
+// The week the crown covers at `now`: the last full week before `now`'s own.
+function crownedWeek(now = new Date()) {
+  const end = mondayOf(now);
+  return { start: new Date(end.getTime() - WEEK_MS), end };
+}
+
+const isoDate = (d) => d.toISOString().slice(0, 10);
+
+// The week's winner among eligible builders, or null. Arithmetic is bigint for the
+// leaderboard's reason: the columns are instance-reported int4.
+async function computeWinner(start, end, pool) {
+  const { rows } = await pool.query(
+    `WITH act AS (
+       SELECT a.client_id, a.github_id, a.first_seen_at, pa.handle, pa.github_login
+         FROM platform_identity_builder_project_activity a
+         JOIN platform_identity_accounts pa ON pa.github_id = a.github_id
+        WHERE ${rollupVisibleSql('pa')}
+     ), per_project AS (
+       SELECT act.github_id, act.handle, act.github_login,
+              COALESCE(e.credits, 0)::bigint - COALESCE(b.credits, 0)             AS credits,
+              COALESCE(e.tasks_shipped, 0)::bigint - COALESCE(b.tasks_shipped, 0) AS tasks_shipped,
+              COALESCE(e.karma, 0)::bigint - COALESCE(b.karma, 0)                 AS karma
+         FROM act
+         LEFT JOIN LATERAL (
+           SELECT s.credits, s.tasks_shipped, s.karma
+             FROM platform_identity_activity_snapshots s
+            WHERE s.client_id = act.client_id AND s.github_id = act.github_id
+              AND s.reported_at <= $2::timestamptz
+            ORDER BY s.reported_at DESC, s.id DESC
+            LIMIT 1
+         ) e ON true
+         LEFT JOIN LATERAL (
+           SELECT s.credits, s.tasks_shipped, s.karma
+             FROM platform_identity_activity_snapshots s
+            WHERE s.client_id = act.client_id AND s.github_id = act.github_id
+              AND s.reported_at <= $1::timestamptz
+            ORDER BY s.reported_at DESC, s.id DESC
+            LIMIT 1
+         ) b ON true
+        WHERE b.credits IS NOT NULL OR act.first_seen_at >= $1::timestamptz
+     )
+     SELECT github_id, sum(credits)::bigint AS credits, sum(tasks_shipped)::bigint AS tasks_shipped
+       FROM per_project
+      GROUP BY github_id, handle, github_login
+     HAVING sum(tasks_shipped) >= 1
+      ORDER BY sum(credits) DESC, sum(tasks_shipped) DESC, sum(karma) DESC,
+               handle COLLATE "C", github_login COLLATE "C"
+      LIMIT 1`,
+    [start, end],
+  );
+  return rows[0] || null;
+}
+
+// One crowning per week per process: concurrent first reads share it, and a week
+// already on record is not asked about again.
+const crowning = new Map();
+let lastCrowned = null;
+
+async function crownWeek(start, end, pool) {
+  const week = isoDate(start);
+  const { rows } = await pool.query(
+    'SELECT 1 FROM platform_identity_weekly_features WHERE week_start = $1::date',
+    [week],
+  );
+  if (rows.length) return;
+  const winner = await computeWinner(start, end, pool);
+  await pool.query(
+    `INSERT INTO platform_identity_weekly_features (week_start, github_id, credits_delta, ships_delta)
+     VALUES ($1::date, $2::bigint, $3::bigint, $4::bigint)
+     ON CONFLICT (week_start) DO NOTHING`,
+    [week, winner ? winner.github_id : null, winner ? winner.credits : 0, winner ? winner.tasks_shipped : 0],
+  );
+}
+
+function ensureCrowned(start, end, pool) {
+  const week = isoDate(start);
+  if (lastCrowned && lastCrowned.week === week && lastCrowned.pool === pool) return Promise.resolve();
+  const inFlight = crowning.get(week);
+  if (inFlight && inFlight.pool === pool) return inFlight.promise;
+  const entry = { pool };
+  entry.promise = crownWeek(start, end, pool)
+    .then(() => { lastCrowned = { week, pool }; })
+    .finally(() => { if (crowning.get(week) === entry) crowning.delete(week); });
+  crowning.set(week, entry);
+  return entry.promise;
+}
+
+function clearCrownMemo() {
+  crowning.clear();
+  lastCrowned = null;
+}
+
+// readBuilderOfTheWeek — crowns the last full week if nobody has yet, then reads it and
+// the weeks before it. Returns { week: { start, end }, winner, past }: dates as
+// YYYY-MM-DD (end is the Monday the week closed on), winner null when nobody is to be
+// shown, past newest first. `now` is injectable so a test can pin the week.
+async function readBuilderOfTheWeek({ now = new Date(), pool = defaultPool } = {}) {
+  const { start, end } = crownedWeek(now);
+  await ensureCrowned(start, end, pool);
+  const { rows } = await pool.query(
+    `SELECT to_char(f.week_start, 'YYYY-MM-DD') AS week_start, f.credits_delta, f.ships_delta,
+            pa.handle, pa.github_login, pa.display_name, pa.avatar_url
+       FROM platform_identity_weekly_features f
+       JOIN platform_identity_accounts pa ON pa.github_id = f.github_id
+      WHERE f.week_start <= $1::date
+        AND ${rollupVisibleSql('pa')}
+      ORDER BY f.week_start DESC
+      LIMIT $2`,
+    [isoDate(start), ARCHIVE_WEEKS + 1],
+  );
+  const shown = rows.map((r) => ({
+    week_start: r.week_start,
+    handle: r.handle,
+    github_login: r.github_login,
+    display_name: r.display_name,
+    avatar_url: r.avatar_url,
+    credits: Number(r.credits_delta),
+    tasks_shipped: Number(r.ships_delta),
+  }));
+  const isThisWeek = shown.length > 0 && shown[0].week_start === isoDate(start);
+  return {
+    week: { start: isoDate(start), end: isoDate(end) },
+    winner: isThisWeek ? shown[0] : null,
+    past: (isThisWeek ? shown.slice(1) : shown).slice(0, ARCHIVE_WEEKS),
+  };
+}
+
+module.exports = {
+  readBuilderOfTheWeek,
+  crownedWeek,
+  clearCrownMemo,
+  ARCHIVE_WEEKS,
+};

package/modules/platform-identity/migrations/platform_identity_032_weekly_features.sql

@@ -0,0 +1,53 @@
+-- platform_identity_032_weekly_features.sql — Builder of the Week, one row per crowned
+-- week (community spec D5, docs/specs/bongos-v1-community-tab.md; task 1002981).
+--
+-- WHY. The crown is computed at render, with no cron: the first read of
+-- GET /community/builder-of-the-week after Monday 00:00 UTC decides the week that just
+-- ended and writes it here. The row is what pins the crown — a builder who goes public
+-- or reports late cannot take a week that was already decided — and what the page's
+-- past-weeks list reads.
+--
+-- THE SHAPE CARRIES THE RULES (owner, 2026-10-27):
+--   * THE KEY IS week_start, the Monday (UTC) the crowned week began, so a week has one
+--     row. The writer is INSERT ... ON CONFLICT (week_start) DO NOTHING, and nothing
+--     updates a row: the first decision stands.
+--   * github_id IS NULL when nobody qualified (no eligible builder shipped a work that
+--     week). The empty week is recorded too, so it stays empty.
+--   * credits_delta / ships_delta are the week's numbers as decided, bigint like the
+--     leaderboard's arithmetic (builder-of-the-week.js).
+--   * NO FOREIGN KEY to platform_identity_accounts, like every github_id column in this
+--     module. Whether a winner may be SHOWN is decided at read time by
+--     rollupVisibleSql (account-visibility.js), never by this row.
+--
+-- AND first_seen_at ON THE ACTIVITY ROWS (owner, 2026-10-27). A week counts a
+-- (project, builder) with no snapshot before it only if the hub first saw that row
+-- during the week: otherwise a builder last seen before snapshots began would bring
+-- their whole lifetime into one week and keep the crown for good. Added with NO
+-- default first, so every existing row stays NULL ("seen before this, history
+-- unknown"); only then the default, so a new row stamps its own first sighting.
+--
+-- NOTHING HERE IS AUTHORITY (ADR 0016 / ADR 0141): descriptive, public analytics.
+--
+-- Additive + platform_identity_-namespaced (ADR 0083 §5). A CREATE and a nullable ADD COLUMN, so the
+-- previous release still runs against this schema. Idempotent.
+
+BEGIN;
+
+CREATE TABLE IF NOT EXISTS platform_identity_weekly_features (
+  week_start    date PRIMARY KEY,
+  github_id     bigint,
+  credits_delta bigint NOT NULL,
+  ships_delta   bigint NOT NULL,
+  crowned_at    timestamptz NOT NULL DEFAULT now()
+);
+
+ALTER TABLE platform_identity_builder_project_activity ADD COLUMN IF NOT EXISTS first_seen_at timestamptz;
+ALTER TABLE platform_identity_builder_project_activity ALTER COLUMN first_seen_at SET DEFAULT now();
+
+COMMENT ON COLUMN platform_identity_builder_project_activity.first_seen_at IS
+  'When the hub first saw this (project, builder) row; NULL for rows older than migration 032. Builder of the Week counts a row with no snapshot before the week only if it was first seen during the week (task 1002981).';
+
+COMMENT ON TABLE platform_identity_weekly_features IS
+  'Builder of the Week, one row per week, keyed on the Monday (UTC) it began (community spec D5, task 1002981). Written once by the first read after the week ends, never updated; github_id NULL = nobody qualified. Whether a winner is shown is decided at read time by the leaderboard''s eligibility predicate.';
+
+COMMIT;

package/modules/platform-identity/routes/community-leaderboard.js

@@ -6,6 +6,8 @@
 // ../community-leaderboard.js; this file is the HTTP shell — validation, the
 // per-IP read cap, the response envelope. It never reads a session, so the
 // board is the same for every viewer.
+// It also serves GET /community/builder-of-the-week (spec D5, task 1002981), the
+// board's weekly crown, from ../builder-of-the-week.js on the same terms.
 //
 // Reaches core only through the doorway (ADR 0083).
 'use strict';
@@ -13,6 +15,7 @@
 const express = require('express');
 const api = require('../../../src/module-api');
 const leaderboard = require('../community-leaderboard');
+const builderOfTheWeek = require('../builder-of-the-week');
 const { createReadRateLimit } = require('../read-rate-limit');
 
 const { pool, corsPublicGet } = api;
@@ -20,6 +23,9 @@ const { pool, corsPublicGet } = api;
 const READ_RATE_LIMIT = 60; // per IP per minute — the community-search budget
 const READ_RATE_SCOPE = 'community-leaderboard-read';
 const leaderboardReadRateLimit = createReadRateLimit({ scope: READ_RATE_SCOPE, limit: READ_RATE_LIMIT });
+// Builder of the Week spends its own budget (ADR 0209: never a shared one).
+const WEEK_READ_RATE_SCOPE = 'builder-of-the-week-read';
+const weekReadRateLimit = createReadRateLimit({ scope: WEEK_READ_RATE_SCOPE, limit: READ_RATE_LIMIT });
 
 module.exports = function communityLeaderboardRoutes() {
   const router = express.Router();
@@ -63,7 +69,25 @@ module.exports = function communityLeaderboardRoutes() {
     }
   });
 
+  router.use('/community/builder-of-the-week', corsPublicGet('/community/builder-of-the-week'));
+
+  // rank: public — Builder of the Week (spec D5; task 1002981): the last full
+  // week's winner and the weeks before it. Takes no parameters. The first read
+  // after Monday 00:00 UTC also records the week (crown at render, no cron), at
+  // most one row per week. Viewer-independent; no-store so a winner who hides
+  // leaves the page on the next read (ADR 0171 D5).
+  router.get('/community/builder-of-the-week', weekReadRateLimit, async (req, res) => {
+    try {
+      const out = await builderOfTheWeek.readBuilderOfTheWeek({ pool });
+      res.set('Cache-Control', 'no-store');
+      res.json(out);
+    } catch (err) {
+      api.logger('platform-identity').error({ err: err && err.message }, 'GET /community/builder-of-the-week failed');
+      res.fail('builder_of_the_week_failed', { status: 500, message: 'internal error' });
+    }
+  });
+
   return router;
 };
 
-module.exports._internals = { READ_RATE_LIMIT, READ_RATE_SCOPE };
+module.exports._internals = { READ_RATE_LIMIT, READ_RATE_SCOPE, WEEK_READ_RATE_SCOPE };

package/modules/public-landing/public/account.html

@@ -118,6 +118,7 @@
   <div class="bandIn">
     <ul class="bandRow">
       <li class="bandCell"><a class="bandT" href="/community">Leaderboard</a><span class="bandC">who earned the most, across every project</span></li>
+      <li class="bandCell"><a class="bandT" href="/community/week">Builder of the week</a><span class="bandC">the top earner of each week, and how it is chosen</span></li>
       <li class="bandCell"><a class="bandT" href="/community/find">Find a builder</a><span class="bandC">anyone building here, by name or role</span></li>
       <li class="bandCell"><a class="bandT" href="/community/recruiters">Open to recruiters</a><span class="bandC">who is open to recruiting, for project owners</span></li>
       <li class="bandCell knowCell" hidden><a class="bandT" href="/connections#connSuggest">Builders you may know</a><span class="bandC">connections or projects in common</span></li>
@@ -131,7 +132,7 @@
       <li class="bandCell"><a class="bandT" href="/projects?view=map&amp;sub=table">Table</a><span class="bandC">the same projects as rows</span></li>
       <li class="bandCell" id="mineCell"><a class="bandT" href="/projects?view=mine">Your projects</a><span class="bandC">the ones you own</span></li>
       <li class="bandCell"><a class="bandT" href="/projects?view=new">New project</a><span class="bandC">five questions and a home</span></li>
-      <li class="bandCell bandFold"><a class="bandT" href="/community">Leaderboard</a><span class="bandC">who earned the most, across every project</span></li><li class="bandCell bandFold"><a class="bandT" href="/community/find">Find a builder</a><span class="bandC">anyone building here, by name or role</span></li><li class="bandCell bandFold"><a class="bandT" href="/community/recruiters">Open to recruiters</a><span class="bandC">who is open to recruiting, for project owners</span></li><li class="bandCell bandFold knowCell" hidden><a class="bandT" href="/connections#connSuggest">Builders you may know</a><span class="bandC">connections or projects in common</span></li>
+      <li class="bandCell bandFold"><a class="bandT" href="/community">Leaderboard</a><span class="bandC">who earned the most, across every project</span></li><li class="bandCell bandFold"><a class="bandT" href="/community/week">Builder of the week</a><span class="bandC">the top earner of each week, and how it is chosen</span></li><li class="bandCell bandFold"><a class="bandT" href="/community/find">Find a builder</a><span class="bandC">anyone building here, by name or role</span></li><li class="bandCell bandFold"><a class="bandT" href="/community/recruiters">Open to recruiters</a><span class="bandC">who is open to recruiting, for project owners</span></li><li class="bandCell bandFold knowCell" hidden><a class="bandT" href="/connections#connSuggest">Builders you may know</a><span class="bandC">connections or projects in common</span></li>
     </ul>
   </div>
 </div>

package/modules/public-landing/public/community-week-none.states.json

@@ -0,0 +1,16 @@
+{
+  "_": "The builder of the week when the last week has no one to show (task 1002981): nobody qualified, or the winner hides their numbers — the two look the same (spec D8). A hub's first week, so no past weeks either (fixtures/community-week-none.json). The page says so in one line; the board draws no crown line.",
+  "page": "/community",
+  "surface": "public-landing",
+  "modes": ["dark"],
+  "modeQuery": false,
+  "stub": { "fixtures": { "community-week": "community-week-none" } },
+  "ignoreRequests": ["/api/(gds|bongos)/me$", "/my-projects", "/me/guild-", "/scouting$"],
+  "ignoreConsole": ["/api/(gds|bongos)/me", "/scouting", "\\b40[13]\\b", "Unauthorized", "Forbidden"],
+  "ignoreControls": [".vh"],
+  "states": {
+    "out-week-none": { "auth": false, "url": "/community/week", "actions": [["wait", 400]], "expect": { "visible": ["#week", "#weekNone", "#weekRuleH"], "hidden": ["#weekCrown", "#weekLoading", "#weekFailed", "#pastH"], "count": [["#weekPast .commRow", 0]], "text": [["#weekNone", "No builder of the week for 19–25 Oct 2026."]] } },
+    "out-board-no-crown": { "auth": false, "actions": [["wait", 400]], "expect": { "visible": ["#board", "#boardList"], "hidden": ["#boardCrown"] } }
+  },
+  "reducedMotion": { "auth": false, "actions": [["wait", 400]] }
+}

package/modules/public-landing/public/community.html

@@ -5,13 +5,15 @@
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <!-- THE COMMUNITY PAGES (task 1003363; ADR 0217 D1, ADR 0337 D1/D3/D4.1, the community
      spec docs/specs/bongos-v1-community-tab.md D1/D3/D4/D8). Who is building, across every
-     project, as three sub-pages of the bar's Community menu (owner, 2026-10-27), all served
-     from this one file: /community is the leaderboard, /community/find the builder search,
-     /community/recruiters the builders who hide their numbers but are open to recruiters.
+     project, as four sub-pages of the bar's Community menu (owner, 2026-10-27), all served
+     from this one file: /community is the leaderboard, /community/week the builder of the
+     week (task 1002981, spec D5), /community/find the builder search, /community/recruiters
+     the builders who hide their numbers but are open to recruiters.
      The script shows the section the path names and marks it current in the menu.
-     VIEWING IS UNGATED (ADR 0217 D1): the leaderboard and the search are the same for every
-     viewer, signed in or not. Both reads are public, viewer-independent routes
-     (modules/platform-identity/routes/community-leaderboard.js, community-search.js),
+     VIEWING IS UNGATED (ADR 0217 D1): the leaderboard, the builder of the week and the search
+     are the same for every viewer, signed in or not. All three reads are public,
+     viewer-independent routes (modules/platform-identity/routes/community-leaderboard.js,
+     which also serves the builder of the week, and community-search.js),
      which decide WHO appears through account-visibility.js; these pages add no rule of
      their own. The one viewer-relative page is the recruiter list: drawn only from a 200 of
      GET /scouting, whose door (a project owner, or project.curate) is the server's, never
@@ -90,7 +92,28 @@
 .commDoor p{margin:0 0 18px;font-size:15px;line-height:1.55;color:var(--ink-soft);}
 .commDoor .gh{width:18px;height:18px;fill:currentColor;}
 .commDoor .btn{text-transform:none;}
+/* Builder of the week (task 1002981): one line on the board, then its own page — the
+   crown, the rule, and the weeks before it as board rows with the week where the place is */
+.commCrownLine{margin:-6px 0 10px;max-width:62ch;font-size:14.5px;line-height:1.5;color:var(--ink-soft);}
+.commCrownLine a{display:inline-block;min-height:24px;padding:3px 0;line-height:18px;color:var(--ink);
+  text-decoration:underline;text-decoration-color:var(--accent);text-underline-offset:4px;}
+.commCrownLine a:focus-visible{outline:2px solid var(--focus);outline-offset:3px;}
+.commCrownLine strong{font-weight:500;color:var(--ink);}
+.commCrown{display:grid;grid-template-columns:minmax(0,1fr) auto;align-items:end;gap:14px 40px;
+  padding:0 0 26px;margin:0 0 6px;border-bottom:1px solid var(--rule-soft);}
+.crownWhen{grid-column:1/-1;margin:0;font-family:var(--label-face);font-size:12.5px;color:var(--ink-faint);}
+.crownWho{display:flex;align-items:center;gap:16px;min-width:0;}
+.crownWho .connAv{width:64px;height:64px;}
+.crownName{font-family:var(--font-display);font-weight:300;font-size:clamp(26px,3.4vw,34px);letter-spacing:-.02em;
+  line-height:1.1;color:var(--ink);overflow-wrap:anywhere;}
+.crownNums{display:flex;gap:0 36px;text-align:right;}
+.commSub{margin:24px 0 4px;font-family:var(--font-body);font-size:14.5px;font-weight:500;color:var(--ink);}
+.weekRows .commRow{grid-template-columns:6.5rem 36px minmax(0,1fr) auto;}
+.weekRows .commPlace{font-family:var(--label-face);}
 @media (max-width:480px){
+  .commCrown{grid-template-columns:minmax(0,1fr);}
+  .crownNums{text-align:left;}
+  .weekRows .commRow{grid-template-columns:7ch 32px minmax(0,1fr) auto;}
   .commRow,.commRows.canRecruit .commRow{grid-template-columns:3ch 32px minmax(0,1fr) auto;gap:0 10px;}
   .commRow .connAv{width:32px;height:32px;}
   .commNum{font-size:19px;}
@@ -132,6 +155,7 @@
   <div class="bandIn">
     <ul class="bandRow">
       <li class="bandCell"><a class="bandT" href="/community">Leaderboard</a><span class="bandC">who earned the most, across every project</span></li>
+      <li class="bandCell"><a class="bandT" href="/community/week">Builder of the week</a><span class="bandC">the top earner of each week, and how it is chosen</span></li>
       <li class="bandCell"><a class="bandT" href="/community/find">Find a builder</a><span class="bandC">anyone building here, by name or role</span></li>
       <li class="bandCell"><a class="bandT" href="/community/recruiters">Open to recruiters</a><span class="bandC">who is open to recruiting, for project owners</span></li>
       <li class="bandCell knowCell" hidden><a class="bandT" href="/connections#connSuggest">Builders you may know</a><span class="bandC">connections or projects in common</span></li>
@@ -145,7 +169,7 @@
       <li class="bandCell"><a class="bandT" href="/projects?view=map&amp;sub=table">Table</a><span class="bandC">the same projects as rows</span></li>
       <li class="bandCell" id="mineCell"><a class="bandT" href="/projects?view=mine">Your projects</a><span class="bandC">the ones you own</span></li>
       <li class="bandCell"><a class="bandT" href="/projects?view=new">New project</a><span class="bandC">five questions and a home</span></li>
-      <li class="bandCell bandFold"><a class="bandT" href="/community">Leaderboard</a><span class="bandC">who earned the most, across every project</span></li><li class="bandCell bandFold"><a class="bandT" href="/community/find">Find a builder</a><span class="bandC">anyone building here, by name or role</span></li><li class="bandCell bandFold"><a class="bandT" href="/community/recruiters">Open to recruiters</a><span class="bandC">who is open to recruiting, for project owners</span></li><li class="bandCell bandFold knowCell" hidden><a class="bandT" href="/connections#connSuggest">Builders you may know</a><span class="bandC">connections or projects in common</span></li>
+      <li class="bandCell bandFold"><a class="bandT" href="/community">Leaderboard</a><span class="bandC">who earned the most, across every project</span></li><li class="bandCell bandFold"><a class="bandT" href="/community/week">Builder of the week</a><span class="bandC">the top earner of each week, and how it is chosen</span></li><li class="bandCell bandFold"><a class="bandT" href="/community/find">Find a builder</a><span class="bandC">anyone building here, by name or role</span></li><li class="bandCell bandFold"><a class="bandT" href="/community/recruiters">Open to recruiters</a><span class="bandC">who is open to recruiting, for project owners</span></li><li class="bandCell bandFold knowCell" hidden><a class="bandT" href="/connections#connSuggest">Builders you may know</a><span class="bandC">connections or projects in common</span></li>
     </ul>
   </div>
 </div>
@@ -164,14 +188,15 @@
 <main class="acct" id="comm">
   <h1 class="vh">Community</h1>
 
-  <!-- THREE SUB-PAGES, ONE FILE: every section is real markup; the script un-hides the one
-       the path names (/community, /community/find, /community/recruiters). -->
+  <!-- FOUR SUB-PAGES, ONE FILE: every section is real markup; the script un-hides the one
+       the path names (/community, /community/week, /community/find, /community/recruiters). -->
   <div class="mineExtra">
     <!-- THE LEADERBOARD (spec D3): GET /community/leaderboard, one window and one craft
          at a time. The server ranks; this page draws its rows in the order and with the
          `place` it was given, and every count it prints is the length of a list. -->
     <section id="board" data-view="leaderboard" aria-labelledby="boardH">
       <h2 id="boardH">Leaderboard</h2>
+      <p class="commCrownLine" id="boardCrown" hidden></p>
       <div class="commFilters">
         <div class="commTabs" id="craftTabs" role="group" aria-label="Role">
           <button class="commTab" type="button" data-craft="" aria-pressed="true">Everyone</button>
@@ -199,6 +224,23 @@
       <p class="commNote" id="boardFine">A project reports a builder’s numbers when they sign in or ship there, so a window counts work when it was reported, not when it was done.</p>
     </section>
 
+    <!-- BUILDER OF THE WEEK (spec D5, task 1002981): GET /community/builder-of-the-week, the
+         last full week's winner and the weeks before it. The server decides the week and
+         records it (builder-of-the-week.js); this page draws what it was sent, the same for
+         every viewer, and states the rule in full (the spec: the formula is public). -->
+    <section id="week" data-view="week" aria-labelledby="weekH" hidden>
+      <h2 id="weekH">Builder of the week</h2>
+      <p class="commMsg" id="weekLoading" role="status">Reading the builder of the week…</p>
+      <p class="projMsg err" id="weekFailed" role="alert" hidden></p>
+      <div class="commCrown" id="weekCrown" hidden></div>
+      <p class="commMsg" id="weekNone" hidden></p>
+      <h3 class="commSub" id="weekRuleH">How it is chosen</h3>
+      <p class="commNote">The builder who earned the most {{currency}} across every project in one week, Monday to Sunday (UTC), among the builders who shipped at least one work that week. A tie goes to whoever shipped more works, then to whoever earned more karma. Builders who hide their numbers or keep their account private are not counted.</p>
+      <p class="commNote">Each week is decided once, the first time anyone opens this page after it ends, and it does not change after that. A project reports a builder’s numbers when they sign in or ship there, so a week counts work when it was reported, not when it was done.</p>
+      <h3 class="commSub" id="pastH" hidden>Past weeks</h3>
+      <ol class="commRows weekRows" id="weekPast" aria-labelledby="pastH"></ol>
+    </section>
+
     <!-- THE SEARCH (spec D4): GET /community/search, a name and an optional craft. A
          builder who hides their numbers is still found by name, and drops out once a
          craft is chosen — the server's rule (builder-search.js), never this page's. -->
@@ -262,10 +304,11 @@
   var QUERY_MIN = 2;
   var QUERY_MAX = 100;
   var CRAFT_WORD = { engineer: 'engineer', artist: 'artist', ideator: 'ideator', ui: 'designer' };
-  // The three sub-pages this file is served as (platform-server.js's /community routes);
+  // The four sub-pages this file is served as (platform-server.js's /community routes);
   // the path picks one, and its menu items are marked current.
   var VIEWS = {
     leaderboard: { path: '/community', section: 'board', title: 'Leaderboard' },
+    week: { path: '/community/week', section: 'week', title: 'Builder of the week' },
     find: { path: '/community/find', section: 'find', title: 'Find a builder' },
     recruiters: { path: '/community/recruiters', section: 'recruit', title: 'Open to recruiters' },
   };
@@ -311,7 +354,7 @@
     return what + ' could not be read. Reload the page to try again.';
   }
   function viewOf(pathname) {
-    var m = String(pathname || '').replace(/\/+$/, '').match(/^\/community(?:\/(find|recruiters))?$/);
+    var m = String(pathname || '').replace(/\/+$/, '').match(/^\/community(?:\/(week|find|recruiters))?$/);
     return m ? (m[1] || 'leaderboard') : 'leaderboard';
   }
 
@@ -442,6 +485,91 @@
     loadBoard();
   });
 
+  // ── the builder of the week (task 1002981, spec D5) ──────────────────────────
+  // The server decides each week and records it; this draws the answer as sent. On the
+  // board it is one line, and a failed or empty read draws nothing there.
+  var MONTHS = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+  // "19–25 Oct" for the Monday a week began on (UTC), the year added when asked
+  function weekSpan(start, withYear) {
+    var a = new Date(String(start) + 'T00:00:00Z');
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(String(start)) || !isFinite(a.getTime())) return '';
+    var b = new Date(a.getTime() + 6 * 24 * 60 * 60 * 1000);
+    var year = function (d) { return withYear ? ' ' + d.getUTCFullYear() : ''; };
+    if (a.getUTCMonth() === b.getUTCMonth()) return a.getUTCDate() + '–' + b.getUTCDate() + ' ' + MONTHS[b.getUTCMonth()] + year(b);
+    var first = a.getUTCDate() + ' ' + MONTHS[a.getUTCMonth()] + (a.getUTCFullYear() === b.getUTCFullYear() ? '' : year(a));
+    return first + ' – ' + b.getUTCDate() + ' ' + MONTHS[b.getUTCMonth()] + year(b);
+  }
+  function crownLine(r) {
+    var line = $('boardCrown');
+    var w = r.ok ? r.data.winner : null;
+    line.textContent = '';
+    line.hidden = !w;
+    if (!w) return;
+    var a = el('a', null, 'Builder of the week');
+    a.setAttribute('href', '/community/week');
+    line.appendChild(a);
+    line.appendChild(el('span', null, ': '));
+    line.appendChild(el('strong', null, w.display_name || w.handle || w.github_login || 'Builder'));
+    var span = weekSpan(r.data.week && r.data.week.start, false);
+    line.appendChild(el('span', null, ', ' + num(w.credits).toLocaleString() + ' ' + UNIT + (span ? ', ' + span : '')));
+  }
+  function stat(value, unit) {
+    var d = el('div');
+    d.appendChild(el('span', 'commNum', value));
+    d.appendChild(el('span', 'commUnit', unit));
+    return d;
+  }
+  function paintCrown(w, span) {
+    var box = $('weekCrown');
+    box.textContent = '';
+    if (span) box.appendChild(el('p', 'crownWhen', span));
+    var who = el('div', 'crownWho');
+    who.appendChild(face(w));
+    var main = el('div', 'mineRow__main');
+    main.appendChild(el('div', 'crownName', w.display_name || w.handle || w.github_login || 'Builder'));
+    if (w.handle) main.appendChild(el('span', 'mineRow__host', '@' + w.handle));
+    who.appendChild(main);
+    box.appendChild(who);
+    var nums = el('div', 'crownNums');
+    var ships = num(w.tasks_shipped);
+    nums.appendChild(stat(num(w.credits).toLocaleString(), UNIT));
+    nums.appendChild(stat(String(ships), ships === 1 ? 'work shipped' : 'works shipped'));
+    box.appendChild(nums);
+    box.hidden = false;
+  }
+  function pastRow(p) {
+    var li = el('li', 'commRow');
+    li.appendChild(el('span', 'commPlace', weekSpan(p.week_start, false)));
+    li.appendChild(face(p));
+    var main = nameBlock(p, p.handle ? '@' + p.handle : '');
+    main.appendChild(el('p', 'mineRow__hint', plural(num(p.tasks_shipped), 'work') + ' shipped'));
+    li.appendChild(main);
+    var credits = el('div', 'commCredits');
+    credits.appendChild(el('span', 'commNum', num(p.credits).toLocaleString()));
+    credits.appendChild(el('span', 'commUnit', UNIT));
+    li.appendChild(credits);
+    return li;
+  }
+  function loadWeek() {
+    return read('/community/builder-of-the-week').then(function (r) {
+      $('weekLoading').hidden = true;
+      if (!r.ok) {
+        $('weekFailed').textContent = failText(r.status, 'The builder of the week');
+        $('weekFailed').hidden = false;
+        return;
+      }
+      var span = weekSpan(r.data.week && r.data.week.start, true);
+      if (r.data.winner) paintCrown(r.data.winner, span);
+      else {
+        $('weekNone').textContent = span ? 'No builder of the week for ' + span + '.' : 'No builder of the week yet.';
+        $('weekNone').hidden = false;
+      }
+      var list = $('weekPast');
+      arr(r.data.past).forEach(function (p) { if (p) list.appendChild(pastRow(p)); });
+      $('pastH').hidden = !list.children.length;
+    });
+  }
+
   // ── the search ──────────────────────────────────────────────────────────────
   function say(text, kind) {
     var s = $('findStatus');
@@ -570,8 +698,9 @@
   });
   document.title = document.title + ' · ' + view.title;
   $('signinTop').setAttribute('href', '/api/bongos/auth/web/start?return=' + view.path + '&repos=1');
-  if (VIEW === 'leaderboard') loadBoard();
-  if (VIEW === 'recruiters') bar.ready.then(function (me) { if (me) loadRecruit(); else showRecruit('recruitDoor'); });
+  if (VIEW === 'leaderboard') { loadBoard(); read('/community/builder-of-the-week').then(crownLine); }
+  if (VIEW === 'week') loadWeek();
+  else if (VIEW === 'recruiters') bar.ready.then(function (me) { if (me) loadRecruit(); else showRecruit('recruitDoor'); });
   else bar.ready.then(function (me) { if (me) loadOwned(me, $(VIEW === 'find' ? 'findFor' : 'boardFor')); });
 })();
 </script>

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

@@ -1,5 +1,5 @@
 {
-  "_": "The community pages' states for modules/ui-design/kit/render.js (task 1003363; ADR 0217 D1, ADR 0337 D4.1): one file served as three sub-pages of the bar's Community menu, each state naming its `url`. The leaderboard and the search are the same for every viewer, from the stub's fixtures (community-leaderboard.json: six builders all time, fewer in each window; community-search.json). The recruiter list signed out is a sign-in door, and signed in it is the default fixture's 403 (most builders own no project); community-recruiter.states.json is a project owner's list, community-empty.states.json a board with nobody on it. Dark only, like every apex page (ADR 0204).",
+  "_": "The community pages' states for modules/ui-design/kit/render.js (task 1003363; ADR 0217 D1, ADR 0337 D4.1): one file served as four sub-pages of the bar's Community menu, each state naming its `url`. The leaderboard, the builder of the week and the search are the same for every viewer, from the stub's fixtures (community-leaderboard.json: six builders all time, fewer in each window; community-week.json: a winner and four past weeks, task 1002981; community-search.json); community-week-none.states.json is a week nobody won. The recruiter list signed out is a sign-in door, and signed in it is the default fixture's 403 (most builders own no project); community-recruiter.states.json is a project owner's list, community-empty.states.json a board with nobody on it. Dark only, like every apex page (ADR 0204).",
   "page": "/community",
   "surface": "public-landing",
   "modes": ["dark"],
@@ -8,13 +8,15 @@
   "ignoreConsole": ["/api/(gds|bongos)/me", "/scouting", "\\b40[13]\\b", "Unauthorized", "Forbidden"],
   "ignoreControls": [".vh"],
   "states": {
-    "out": { "auth": false, "actions": [["wait", 400]], "expect": { "visible": ["#board", "#boardList", "#boardWindow", "#signinTop", "#projTrig"], "hidden": ["#find", "#recruit", "#who", "#boardLoading", "#boardFailed", "#boardEmpty"], "count": [["#boardList .commRow", 6]], "value": [["#boardWindow", "all"]], "attr": [["#craftTabs [data-craft=\"\"]", "aria-pressed", "true"], ["#commTrig", "aria-current", "true"], ["#menuCommunity a[href=\"/community\"]", "aria-current", "page"]], "text": [["#boardList .commRow:first-child .mineRow__name", "Priya Nair"], ["#boardList .commRow:first-child .commNum", "18,420"], ["#boardList .commRow:first-child .mineRow__hint", "212 works shipped · 64 karma"], ["#boardNote", "Credits earned across every project, since each builder started."]] } },
+    "out": { "auth": false, "actions": [["wait", 400]], "expect": { "visible": ["#board", "#boardList", "#boardWindow", "#signinTop", "#projTrig", "#boardCrown"], "hidden": ["#week", "#find", "#recruit", "#who", "#boardLoading", "#boardFailed", "#boardEmpty"], "href": [["#boardCrown a", "/community/week"]], "count": [["#boardList .commRow", 6]], "value": [["#boardWindow", "all"]], "attr": [["#craftTabs [data-craft=\"\"]", "aria-pressed", "true"], ["#commTrig", "aria-current", "true"], ["#menuCommunity a[href=\"/community\"]", "aria-current", "page"]], "text": [["#boardList .commRow:first-child .mineRow__name", "Priya Nair"], ["#boardList .commRow:first-child .commNum", "18,420"], ["#boardList .commRow:first-child .mineRow__hint", "212 works shipped · 64 karma"], ["#boardNote", "Credits earned across every project, since each builder started."], ["#boardCrown", "Builder of the week: Ada Okafor, 1,240 credits, 19–25 Oct"]] } },
     "out-30d": { "auth": false, "actions": [["wait", 400], ["select", "#boardWindow", "30d"], ["wait", 300]], "expect": { "count": [["#boardList .commRow", 3]], "value": [["#boardWindow", "30d"]], "text": [["#boardList .commRow:first-child .mineRow__name", "Ada Okafor"], ["#boardNote", "Credits earned in the last 30 days, across every project."]] } },
     "out-artists": { "auth": false, "actions": [["wait", 400], ["click", "#craftTabs [data-craft=\"artist\"]"], ["wait", 300]], "expect": { "count": [["#boardList .commRow", 1]], "text": [["#boardList .commRow:first-child .mineRow__name", "Ada Okafor"], ["#boardList .commRow:first-child .commPlace", "1"]] } },
-    "out-community-band": { "auth": false, "actions": [["wait", 400], ["clickIfVisible", "#commTrig"], ["wait", 300]], "expect": { "hidden": ["#menuCommunity .knowCell"], "count": [["#menuCommunity .bandCell:not([hidden])", 3]], "attr": [["#menuCommunity a[href=\"/community\"]", "aria-current", "page"]] } },
-    "in-community-band": { "auth": true, "actions": [["wait", 400], ["clickIfVisible", "#commTrig"], ["wait", 300]], "expect": { "count": [["#menuCommunity .bandCell:not([hidden])", 4]], "href": [["#menuCommunity .knowCell a", "/connections#connSuggest"]] } },
+    "out-community-band": { "auth": false, "actions": [["wait", 400], ["clickIfVisible", "#commTrig"], ["wait", 300]], "expect": { "hidden": ["#menuCommunity .knowCell"], "count": [["#menuCommunity .bandCell:not([hidden])", 4]], "attr": [["#menuCommunity a[href=\"/community\"]", "aria-current", "page"]] } },
+    "in-community-band": { "auth": true, "actions": [["wait", 400], ["clickIfVisible", "#commTrig"], ["wait", 300]], "expect": { "count": [["#menuCommunity .bandCell:not([hidden])", 5]], "href": [["#menuCommunity .knowCell a", "/connections#connSuggest"]] } },
     "in-projects-band": { "auth": true, "actions": [["wait", 400], ["click", "#projTrig"], ["wait", 300]], "expect": { "visible": ["#menuProjects"], "count": [["#menuProjects .knowCell:not([hidden])", 1]] } },
     "out-projects-band": { "auth": false, "actions": [["wait", 400], ["click", "#projTrig"], ["wait", 300]], "expect": { "visible": ["#menuProjects"], "attr": [["#menuProjects a[href=\"/community\"]", "aria-current", "page"]] } },
+    "out-week": { "auth": false, "url": "/community/week", "actions": [["wait", 400]], "expect": { "visible": ["#week", "#weekCrown", "#pastH", "#weekPast"], "hidden": ["#board", "#find", "#recruit", "#weekLoading", "#weekFailed", "#weekNone"], "count": [["#weekPast .commRow", 4]], "attr": [["#menuCommunity a[href=\"/community/week\"]", "aria-current", "page"]], "text": [["#weekCrown .crownWhen", "19–25 Oct 2026"], ["#weekCrown .crownName", "Ada Okafor"], ["#weekCrown .crownNums div:first-child .commNum", "1,240"], ["#weekCrown .crownNums div:last-child .commUnit", "works shipped"], ["#weekPast .commRow:first-child .commPlace", "12–18 Oct"], ["#weekPast .commRow:nth-child(3) .commPlace", "28 Sep – 4 Oct"]] } },
+    "in-week": { "auth": true, "url": "/community/week", "actions": [["wait", 600]], "expect": { "visible": ["#week", "#weekCrown", "#who"], "hidden": ["#board", "#signinTop", "#weekFailed"], "count": [["#weekPast .commRow", 4]] } },
     "out-find": { "auth": false, "url": "/community/find", "actions": [["wait", 400]], "expect": { "visible": ["#find", "#findQ", "#findCraft", "#findBtn"], "hidden": ["#board", "#recruit"], "attr": [["#menuCommunity a[href=\"/community/find\"]", "aria-current", "page"]] } },
     "out-find-search": { "auth": false, "url": "/community/find", "actions": [["wait", 400], ["fill", "#findQ", "pri"], ["click", "#findBtn"], ["wait", 300]], "expect": { "count": [["#findList .mineRow", 2]], "text": [["#findStatus", "2 builders found."], ["#findList .mineRow:first-child .mineRow__hint", "engineer · designer"]] } },
     "out-recruiters": { "auth": false, "url": "/community/recruiters", "actions": [["wait", 400]], "expect": { "visible": ["#recruit", "#recruitDoor", "#recruitSignin"], "hidden": ["#board", "#find", "#recruitLoading", "#recruitClosed"], "count": [["#recruitList .mineRow", 0]], "attr": [["#menuCommunity a[href=\"/community/recruiters\"]", "aria-current", "page"]] } },