@bongos/core 1.19.781 → 1.19.783

package/modules/builder-settings/builder-needs.js

@@ -110,12 +110,18 @@ function helpRequestsNeed(ctx) {
   const verb = n === 1 ? 'has' : 'have';
   return {
     id: 'help_requests',
+    // The number, machine-readable (task 1003942) — the field boardVotesNeed
+    // already carries, and the whole badge contract: shell.js names this need's
+    // id on the Collab nav item and reads this count into the badge.
+    count: n,
     title: n === 1 ? 'Someone asked for your help' : 'People asked for your help',
     what: 'A builder who is stuck addressed a request to your craft, or to you by name.',
     state: 'action_needed',
     severity: 'info',
     message: `${people} ${verb} asked for help you can give. Answering is optional and declining costs nothing.`,
-    action: { label: n === 1 ? 'See the request' : 'See the requests', href: '/#/collab' },
+    // Collab is its own page since task 1003172; the retired '/#/collab' hash
+    // form pointed at a view the index no longer routes.
+    action: { label: n === 1 ? 'See the request' : 'See the requests', href: '/collab' },
   };
 }
 
@@ -152,7 +158,7 @@ function taskRecommendationsNeed(ctx) {
     state: 'action_needed',
     severity: 'info',
     message: `${subject} ${verb} recommended to you. Nothing has been assigned — you would still claim it yourself, and declining costs nothing.`,
-    action: { label: n === 1 ? 'See the recommendation' : 'See the recommendations', href: '/#/collab' },
+    action: { label: n === 1 ? 'See the recommendation' : 'See the recommendations', href: '/collab' },
   };
 }
 
@@ -230,7 +236,7 @@ function mingleIntroductionsNeed(ctx) {
     severity: 'info',
     message: `${subject} waiting on you. Saying no costs nothing at all — no rank, no karma, no streak, `
       + 'and it does not change how often you are paired again.',
-    action: { label: n === 1 ? 'See the introduction' : 'See the introductions', href: '/#/collab' },
+    action: { label: n === 1 ? 'See the introduction' : 'See the introductions', href: '/collab' },
   };
 }
 

package/modules/dev-box/app/src/vendor/bongos-client.cjs

@@ -468,6 +468,8 @@ function createClient(opts = {}) {
       getHealthz: (args) => request("GET", "/healthz", { hasBody: false }, args),
     },
     "helpRequests": {
+      // GET /help-requests — rank: any-builder — GET /help-requests
+      getHelpRequests: (args) => request("GET", "/help-requests", { hasBody: false }, args),
       // POST /help-requests — rank: any-builder — POST /help-requests
       postHelpRequests: (args) => request("POST", "/help-requests", { hasBody: true }, args),
       // PATCH /help-requests/{id} — rank: any-builder — PATCH /help-requests/:id

package/modules/hall-ui/public/collab-lib.js

@@ -128,10 +128,102 @@
     return { id: 'other', label: 'asked' };
   }
 
+  // ---- the FACES (task 1003942, owner report: "doesn't feel collaborative") ----
+  //
+  // A board of builders reaching builders should read as people before it reads
+  // as prose, so every row now leads with a face and the top strip stacks the
+  // faces of everyone waiting. These are the pure halves: which person a row
+  // leads with, what to draw when there is no picture, and the figure strip's
+  // numbers. collab.js only turns the result into markup.
+
+  // Defence in depth on an avatar src (roster.js's rule): escaping alone cannot
+  // stop a non-http scheme reaching an attribute the browser resolves, so a src
+  // this page did not vouch for renders as the initial instead.
+  function httpUrl(u) {
+    return /^https?:\/\//i.test(String(u || '')) ? String(u) : null;
+  }
+
+  // The letter a faceless person shows: the first character of their name,
+  // uppercased, with a leading @ or # dropped. Never empty — '?' stands in.
+  function initialOf(name) {
+    var n = String(name == null ? '' : name).replace(/^[@#]/, '').trim();
+    return (n.charAt(0) || '?').toUpperCase();
+  }
+
+  // The person a row LEADS with. Incoming ('in') is always the asker — the
+  // human waiting on an answer. Outgoing ('out') is who you asked: the one
+  // person on a by-name ask, else the craft, drawn as a lettered disc so a craft
+  // ask never borrows a person's face. Same dir contract as directionLine.
+  function faceOf(req, dir) {
+    if (!req) return null;
+    if (dir === 'out') {
+      if (req.needs_builder_id != null) {
+        var to = req.needs_builder_name || req.needs_builder_login || '';
+        return {
+          kind: 'person', id: req.needs_builder_id, name: to,
+          avatar: httpUrl(req.needs_builder_avatar_url), initial: initialOf(to),
+        };
+      }
+      var craft = req.needs_craft ? String(req.needs_craft) : '';
+      return { kind: 'craft', id: null, name: craft ? craft + 's' : 'anyone', avatar: null, initial: craft ? initialOf(craft) : '?' };
+    }
+    var who = askerOf(req);
+    return {
+      kind: 'person', id: req.requested_by != null ? req.requested_by : null, name: who,
+      avatar: httpUrl(req.requested_by_avatar_url), initial: initialOf(who),
+    };
+  }
+
+  // The DISTINCT people asking, in list order — the face stack in the top strip.
+  // Two asks from one person are one face; keyed by id when the server sent one,
+  // by name otherwise, so an older server still dedupes.
+  function askers(rows) {
+    var seen = {};
+    var out = [];
+    for (var i = 0; i < (rows || []).length; i += 1) {
+      var f = faceOf(rows[i], 'in');
+      if (!f) continue;
+      var key = f.id != null ? 'id:' + f.id : 'name:' + f.name;
+      if (seen[key]) continue;
+      seen[key] = true;
+      out.push(f);
+    }
+    return out;
+  }
+
+  // Newest first — the order the three-block board reads in (owner direction,
+  // task 1003942: "only show the three most recent, then expand"). The ageing
+  // criterion is still met by the band on every row; this is a display order,
+  // and the oldest-first comparator stays for the callers that want risk first.
+  function byNewestFirst(a, b) {
+    return byAgeOldestFirst(b, a);
+  }
+
+  // The first N rows are shown, the rest wait behind "show all": a pure split so
+  // the count on the button and the rows it reveals come from one place.
+  function splitShown(rows, n) {
+    var list = rows || [];
+    var cap = typeof n === 'number' && n >= 0 ? n : list.length;
+    return { shown: list.slice(0, cap), hidden: list.slice(cap) };
+  }
+
+  // The THIRD-PERSON line, for the board of everyone's asks: neither "you" nor
+  // "asked you". "Gamma asked builders" / "Alpha asked Beta by name".
+  function boardLine(req) {
+    if (!req) return '';
+    var who = askerOf(req) || 'Someone';
+    if (req.needs_builder_id != null) {
+      var to = req.needs_builder_name || req.needs_builder_login;
+      return to ? who + ' asked ' + to + ' by name' : who + ' asked one person';
+    }
+    return req.needs_craft ? who + ' asked ' + req.needs_craft + 's' : who + ' asked';
+  }
+
   window.OTBCollabLib = {
-    BANDS: BANDS, ageBand: ageBand, byAgeOldestFirst: byAgeOldestFirst,
+    BANDS: BANDS, ageBand: ageBand, byAgeOldestFirst: byAgeOldestFirst, byNewestFirst: byNewestFirst,
     askerOf: askerOf, contextOf: contextOf,
-    directionLine: directionLine,
+    directionLine: directionLine, boardLine: boardLine,
     titleOf: titleOf, groupOf: groupOf,
+    httpUrl: httpUrl, initialOf: initialOf, faceOf: faceOf, askers: askers, splitShown: splitShown,
   };
 })();

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

@@ -1,11 +1,18 @@
 /* modules/hall-ui/public/collab.css — the Collab page (task 1003172 / C02),
-   rebuilt on the hall's row archetype by task 1003471: the panel is the shell's
-   .scroll, the row is oversight.css's .ov-row, the age is a .fact-pill, the
-   context a .fact-chip. This sheet holds only what Collab has and no other
-   page does — the colour of each age band.
+   rebuilt on the hall's row archetype by task 1003471, and made a THREE-BLOCK
+   room of people by task 1003942 (owner direction: "way too text heavy, doesn't
+   feel collaborative" — asked of you left, your asks right, every open ask
+   below, each condensed to the newest three with a show-all). The panel is the
+   shell's .scroll, the two-up is the shell's .view-zone--band, the row is
+   oversight.css's .ov-row--lead (a face, then the words, then the state), the
+   age is a .fact-pill, the context a .fact-chip, the expander the shell's
+   .btn-ghost. This sheet holds only what Collab has and no other page does: the
+   colour of each age band, the faces, the block head, the lit personal call, and
+   the foot.
    Tokens only from style.css's real set: inventing one renders as nothing,
    which is how copy-desk.css once ended up with invisible fallbacks (idea
-   1000821). */
+   1000821). Every colour here is a var() of the fifteen or the hall's measured
+   status vocabulary, so the dark tier needs no twin in this file. */
 
 /* THE AGEING SIGNAL. The criterion asks that a request nobody takes be visibly
    aging rather than silently dead — so the age is a state pill in the row's
@@ -18,3 +25,101 @@
 .cb-age--waiting { color: var(--ink-soft); }
 .cb-age--aging   { color: var(--warn); }
 .cb-age--stale   { color: var(--danger); font-weight: 600; }
+
+/* ---- the blocks ------------------------------------------------------------------
+   The top band is the shell's two-up grid (it stacks to one column at the
+   shell's phone breakpoint). A block is the shell's panel with a head row: the
+   heading, its count in mono, and the faces of whoever is asking on the right. */
+.cb-band { margin: 0 0 var(--sp-md); }
+.cb-block__head { display: flex; align-items: center; gap: 12px; flex-wrap: wrap; margin: 0 0 6px; }
+.cb-block__head .scroll__h { margin: 0; }
+.cb-block__n {
+  font-family: var(--font-mono);
+  font-size: 13px;
+  font-weight: 400;
+  letter-spacing: 0;
+  color: var(--ink-faint);
+  font-variant-numeric: tabular-nums;
+  margin-left: 6px;
+}
+.cb-block__head .cb-faces { margin-left: auto; }
+
+/* "Show all N" / "Show fewer": the shell's ghost pill, on its own line under
+   the rows, so the condensed block ends on its door to the rest. */
+.cb-more { margin-top: 12px; }
+
+/* ---- the face -----------------------------------------------------------------
+   A row leads with WHO: a 36px disc, the picture when the server sent one, the
+   initial on the glass when it did not (people.css's .dir-avatar, at the row's
+   size). A craft ask wears the craft's letter in the label face, so it never
+   passes for a person. Decorative — the name beside it is the door. */
+.cb-face {
+  width: 36px; height: 36px; flex: none;
+  border-radius: 50%;
+  object-fit: cover;
+  background: var(--skeleton);
+  border: 1px solid var(--rule);
+  margin-top: 1px;
+}
+.cb-face--initial {
+  display: inline-grid; place-items: center;
+  font-size: 14px; font-weight: 500; line-height: 1;
+  color: var(--ink-soft);
+  background: var(--glass-strong);
+}
+.cb-face--craft {
+  font-family: var(--label-face);
+  font-size: 12px;
+  letter-spacing: 0;
+  color: var(--ink-faint);
+  background: none;
+  border-style: dashed;
+}
+
+/* The stack of everyone asking: 24px faces at -7px overlap, each ringed in the
+   panel ground (the poster card's face-row grammar). */
+.cb-faces { display: inline-flex; align-items: center; }
+.cb-faces .cb-face {
+  width: 24px; height: 24px;
+  margin: 0 0 0 -7px;
+  border: 2px solid var(--bg-card);
+  font-size: 10px;
+}
+.cb-faces .cb-face:first-child { margin-left: 0; }
+.cb-faces .cb-face--initial { background: var(--glass-strong); }
+
+/* ---- the personal call ------------------------------------------------------------
+   An ask addressed to you BY NAME is the one live thing on the board — the
+   personal call this reader owes an answer — so its direction line takes the
+   accent ink. Accent goes only on what is live, and this is. */
+.cb-row--live .ov-row__facts > .ov-fact { color: var(--accent-ink); }
+
+/* ---- the rows, as people -------------------------------------------------------
+   The archetype's --lead grid puts the face in its own column. A row lights on
+   hover with the glass the family's button rows use, so the board feels awake
+   without any motion; the Kill Switch has nothing to kill here. */
+.cb-row { padding-left: 10px; padding-right: 10px; margin: 0 -10px; border-radius: var(--radius-sm); }
+.cb-row:hover { background: var(--glass); }
+.cb-row .ov-row__facts a { color: var(--accent-ink); }
+/* Inside the two condensed blocks a row has half the page: the state and the
+   actions drop UNDER the words as one line (the archetype's own phone shape),
+   the date yields to the age pill, and the two-up itself becomes one column
+   before the shell's phone breakpoint, at the width where two half-rows stop
+   holding a sentence. The wide block below keeps the archetype's two columns. */
+.cb-band .ov-row--lead { grid-template-columns: auto minmax(0, 1fr); row-gap: 8px; }
+.cb-band .ov-row--lead > .ov-row__right {
+  grid-column: 2;
+  flex-direction: row;
+  flex-wrap: wrap;
+  align-items: center;
+  text-align: left;
+}
+.cb-band .ov-row__actions { justify-content: flex-start; }
+.cb-band .ov-row__when { display: none; }
+@media (max-width: 1100px) {
+  .cb-band { grid-template-columns: 1fr; }
+}
+
+/* ---- empties and the foot -------------------------------------------------- */
+.cb-empty p { font-size: 14px; }
+.cb-foot { margin: var(--sp-sm) 0 0; font-size: 12.5px; color: var(--ink-faint); max-width: var(--measure); }

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

@@ -4,7 +4,7 @@
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1">
   <title>Collab — {{worldName}}</title>
-  <meta name="description" content="Requests for help addressed to your craft or to you by name, and the asks you have open — with how long each has been waiting.">
+  <meta name="description" content="Builders asking builders for help: what is waiting on you, what you asked, and every open ask across the project.">
   <link rel="icon" href="data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'><text x='16' y='24' font-size='24' text-anchor='middle' font-family='sans-serif'>⌂</text></svg>">
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
@@ -20,30 +20,53 @@
   <div class="app-body">
     <header class="app-topbar" id="app-topbar"></header>
     <div class="app-content">
-      <!-- The board page head: the page's own name in the LABEL voice, not a
-           display line — on a working surface it is the least interesting
-           thing on it. -->
+      <!-- The board page head: the page's own name in the LABEL voice. The sub
+           line is the one sentence of orientation the page keeps: who reaches
+           you, written by collab.js. -->
       <div class="page-head page-head--board">
         <h1 class="page-head__h">Collab</h1>
         <p class="page-head__sub" id="cb-sub">Loading…</p>
       </div>
 
+      <!-- THREE BLOCKS (owner direction, task 1003942). Top: ASKED OF YOU on the
+           left and YOUR ASKS on the right, each condensed to the three newest
+           with a "show all" that reveals the rest. Below, one wide block: every
+           open ask in the project. Each block's head carries its count and,
+           where people are asking, their faces. The rows are the hall's row
+           archetype (oversight.css) led by a face; collab.js fills them. -->
       <main id="hall-main">
-        <!-- ASKED OF YOU comes first: it is the half where someone is waiting on a
-             human. Your own asks are below, because they are a status check, not a
-             call to act. The rows are the hall's row archetype (oversight.css);
-             collab.js fills the mount with one run per addressee. -->
-        <section class="scroll" aria-labelledby="cb-for-me-h">
-          <h2 class="scroll__h" id="cb-for-me-h">Asked of you</h2>
-          <p class="scroll__lede" id="cb-for-me-note">
-            Requests addressed to your craft, or to you by name. Answering is optional
-            and declining costs nothing — nobody is assigned by being asked.
-          </p>
-          <div id="cb-for-me"></div>
-          <div class="empty-state" id="cb-for-me-empty" hidden>
-            <p>Nothing is waiting on you. Requests reach you by your craft — set yours in
-            <a href="/builders/settings">Settings</a> if this stays empty.</p>
+        <div class="view-zone view-zone--band cb-band">
+          <section class="scroll cb-block" aria-labelledby="cb-for-me-h">
+            <div class="cb-block__head">
+              <h2 class="scroll__h" id="cb-for-me-h">Asked of you <span class="cb-block__n" id="cb-for-me-n"></span></h2>
+              <span class="cb-faces" id="cb-for-me-faces" aria-hidden="true"></span>
+            </div>
+            <ul class="ov-rows" id="cb-for-me"></ul>
+            <div class="empty-state cb-empty" id="cb-for-me-empty" hidden>
+              <p>Nobody is waiting on you. Requests reach you by craft —
+              <a href="/builders/settings">set yours in Settings</a>.</p>
+            </div>
+            <button class="btn-ghost cb-more" id="cb-for-me-more" type="button" aria-expanded="false" aria-controls="cb-for-me" hidden></button>
+          </section>
+
+          <section class="scroll cb-block" aria-labelledby="cb-mine-h">
+            <div class="cb-block__head">
+              <h2 class="scroll__h" id="cb-mine-h">Your asks <span class="cb-block__n" id="cb-mine-n"></span></h2>
+            </div>
+            <ul class="ov-rows" id="cb-mine"></ul>
+            <div class="empty-state cb-empty" id="cb-mine-empty" hidden><p>You have no open asks.</p></div>
+            <button class="btn-ghost cb-more" id="cb-mine-more" type="button" aria-expanded="false" aria-controls="cb-mine" hidden></button>
+          </section>
+        </div>
+
+        <section class="scroll cb-block cb-block--all" aria-labelledby="cb-all-h">
+          <div class="cb-block__head">
+            <h2 class="scroll__h" id="cb-all-h">All open asks <span class="cb-block__n" id="cb-all-n"></span></h2>
+            <span class="cb-faces" id="cb-all-faces" aria-hidden="true"></span>
           </div>
+          <ul class="ov-rows" id="cb-all"></ul>
+          <div class="empty-state cb-empty" id="cb-all-empty" hidden><p>Nobody has an open ask right now.</p></div>
+          <button class="btn-ghost cb-more" id="cb-all-more" type="button" aria-expanded="false" aria-controls="cb-all" hidden></button>
         </section>
 
         <!-- SOCIAL MODE ONLY (task 1003178 / C08). Not a page and not a nav item:
@@ -52,28 +75,19 @@
              from /me, and collab.js reveals this section from that. With social
              off the page is exactly what it was, which is the point: the hall
              changes, it does not gain a destination. -->
-        <section class="scroll" id="cb-mingle-section" aria-labelledby="cb-mingle-h" hidden>
+        <section class="scroll cb-block" id="cb-mingle-section" aria-labelledby="cb-mingle-h" hidden>
           <h2 class="scroll__h" id="cb-mingle-h">Introductions</h2>
-          <p class="scroll__lede" id="cb-mingle-note">
-            Mingle pairs you with someone from a different craft. Saying no costs nothing
-            at all — no rank, no karma, no streak, and it does not change how often you
-            are paired again.
-          </p>
+          <p class="scroll__lede" id="cb-mingle-note">Mingle pairs you with someone from another craft. Saying no costs nothing.</p>
           <ul class="ov-rows" id="cb-mingle"></ul>
-          <div class="empty-state" id="cb-mingle-empty" hidden>
-            <p>No introductions right now. You will see one here when a pairing round runs.</p>
+          <div class="empty-state cb-empty" id="cb-mingle-empty" hidden>
+            <p>No introductions right now. One appears here when a pairing round runs.</p>
           </div>
         </section>
 
-        <section class="scroll" aria-labelledby="cb-mine-h">
-          <h2 class="scroll__h" id="cb-mine-h">Your asks</h2>
-          <p class="scroll__lede">
-            Only you can settle your own request — mark it answered when someone
-            helped, or withdraw it when you no longer need it.
-          </p>
-          <ul class="ov-rows" id="cb-mine"></ul>
-          <div class="empty-state" id="cb-mine-empty" hidden><p>You have no open asks.</p></div>
-        </section>
+        <!-- The one sentence of rules, said ONCE, at the foot. Answering is
+             optional by design (ADR 0187 §3), and the page still says so; it
+             just stops saying it first. -->
+        <p class="cb-foot">Answering is optional and declining costs nothing. Nobody is assigned by being asked.</p>
       </main>
     </div>
   </div>
@@ -84,7 +98,7 @@
 <script src="/builders/shell.js?v=2026-07-02-shell1"></script>
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-23-contrib"></script>
-<script src="/builders/collab-lib.js?v=2026-09-01-redesign"></script>
-<script src="/builders/collab.js?v=2026-09-01-redesign"></script>
+<script src="/builders/collab-lib.js?v=2026-09-16-blocks"></script>
+<script src="/builders/collab.js?v=2026-09-16-blocks"></script>
 </body>
 </html>