@bongos/core 1.23.10 → 1.23.12

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

@@ -120,6 +120,7 @@
       <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/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>
     </ul>
   </div>
 </div>
@@ -130,7 +131,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"><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>
     </ul>
   </div>
 </div>

package/modules/public-landing/public/assets/hub-bar.js

@@ -7,8 +7,9 @@
    the three footer doors (/privacy, /terms, /contact). Each page keeps the bar's
    MARKUP (real markup, pinned byte-equal to the hub's); this file is the one copy
    of what makes it work there:
-     - the chip, filled from GET /me — signed out there is no chip and no
-       Your-projects item, and the sign-in door takes the chip's slot;
+     - the chip, filled from GET /me — signed out there is no chip, no
+       Your-projects item and no Builders-you-may-know item, and the sign-in
+       door takes the chip's slot;
      - the bands' disclosure: a trigger toggles its band, opening one closes the
        other, Escape closes and returns focus to the trigger, a click outside or
        Tab out closes, the arrows walk the items, an item activated closes it;
@@ -33,6 +34,7 @@
     $('who').hidden = !me;
     $('signinTop').hidden = !!me;
     $('mineCell').hidden = !me;
+    Array.prototype.forEach.call(document.querySelectorAll('.knowCell'), function (c) { c.hidden = !me; });
     [['whoImg', 'whoLogin'], ['bandWhoImg', 'bandWhoLogin']].forEach(function (ids) {
       $(ids[0]).hidden = !avatar;
       if (avatar) $(ids[0]).src = avatar;

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

@@ -0,0 +1,16 @@
+{
+  "_": "The community leaderboard for a builder who owns two projects (task 1002292): GET /my-projects answers Mercury and Tidepool (fixtures/my-projects-owner-two.json), so a labelled \"Recruit to\" choice sits above the rows, and picking Tidepool re-points every row's Recruit link at Tidepool's hall invite box.",
+  "page": "/community",
+  "surface": "public-landing",
+  "modes": ["dark"],
+  "modeQuery": false,
+  "stub": { "fixtures": { "my-projects": "my-projects-owner-two" } },
+  "ignoreRequests": ["/api/(gds|bongos)/me$", "/me/guild-", "/scouting$"],
+  "ignoreConsole": ["/api/(gds|bongos)/me", "/scouting", "\\b40[13]\\b", "Unauthorized", "Forbidden"],
+  "ignoreControls": [".vh"],
+  "states": {
+    "in-owner-two": { "auth": true, "actions": [["wait", 600]], "expect": { "visible": ["#boardFor", "#boardForPick"], "value": [["#boardForPick", "0"]], "count": [["#boardForPick option", 2], ["#boardList a.commRecruit", 6]], "href": [["#boardList .commRow:first-child .commRecruit", "https://mercury.example.test/builders/watch?invite=priyanair"]] } },
+    "in-owner-two-picked": { "auth": true, "actions": [["wait", 600], ["select", "#boardForPick", "1"], ["wait", 200]], "expect": { "value": [["#boardForPick", "1"]], "href": [["#boardList .commRow:first-child .commRecruit", "https://tidepool.example.test/builders/watch?invite=priyanair"]], "attr": [["#boardList .commRow:first-child .commRecruit", "aria-label", "Recruit Priya Nair to Tidepool (opens in a new tab)"]] } }
+  },
+  "reducedMotion": { "auth": true, "actions": [["wait", 600]] }
+}

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

@@ -0,0 +1,16 @@
+{
+  "_": "The community pages for a project owner (task 1002292; spec D6, owner 2026-10-27): GET /my-projects answers one owned project (fixtures/my-projects-owner.json), so every leaderboard and search row carries a Recruit link to Mercury's hall invite box with the GitHub login filled in, and a line above the rows says what it opens. The rows are the ones everyone sees.",
+  "page": "/community",
+  "surface": "public-landing",
+  "modes": ["dark"],
+  "modeQuery": false,
+  "stub": { "fixtures": { "my-projects": "my-projects-owner" } },
+  "ignoreRequests": ["/api/(gds|bongos)/me$", "/me/guild-", "/scouting$"],
+  "ignoreConsole": ["/api/(gds|bongos)/me", "/scouting", "\\b40[13]\\b", "Unauthorized", "Forbidden"],
+  "ignoreControls": [".vh"],
+  "states": {
+    "in-owner": { "auth": true, "actions": [["wait", 600]], "expect": { "visible": ["#board", "#boardFor", "#who"], "hidden": ["#find", "#recruit", "#boardFailed"], "count": [["#boardList .commRow", 6], ["#boardList a.commRecruit", 6]], "text": [["#boardFor", "Recruit opens Mercury’s hall with their name filled in, and you send the invite there."], ["#boardList .commRow:first-child .commRecruit", "Recruit"]], "href": [["#boardList .commRow:first-child .commRecruit", "https://mercury.example.test/builders/watch?invite=priyanair"]] } },
+    "in-owner-find": { "auth": true, "url": "/community/find", "actions": [["wait", 600], ["fill", "#findQ", "pri"], ["click", "#findBtn"], ["wait", 300]], "expect": { "visible": ["#find", "#findFor"], "hidden": ["#board", "#recruit"], "count": [["#findList .mineRow", 2], ["#findList .mineRow__actions a.commRecruit", 2]], "href": [["#findList .mineRow:first-child .commRecruit", "https://mercury.example.test/builders/watch?invite=priyanair"]] } }
+  },
+  "reducedMotion": { "auth": true, "actions": [["wait", 600]] }
+}

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

@@ -16,6 +16,11 @@
      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
      this page's (scouting-authz.js). A 401 or 403 draws no row.
+     THE RECRUIT DOOR (task 1002292; spec D6, owner 2026-10-27): a project OWNER (GET
+     /my-projects `owned`) gets a Recruit link on each leaderboard and search row. The hub
+     cannot read a project's project.recruit, which lives on that project (ADR 0335 D1), so
+     ownership stands in. The link only opens the project's own hall invite box with the
+     login filled in (ADR 0353); the project decides. The rows themselves never change.
      Hub-only, like /account: platform-server.js serves /community only where
      platform-identity is on. noindex until the SEO goal decides (owner, 2026-10-27).
      Server-stamped like the footer doors: {{…}} tokens filled by landingPage(). -->
@@ -69,19 +74,29 @@
 .connAv{width:36px;height:36px;border-radius:50%;flex:none;object-fit:cover;background:color-mix(in srgb,var(--ink) 12%,transparent);}
 .commRow .mineRow__name,.connWho .mineRow__name{overflow-wrap:anywhere;}
 /* the two dropdowns (the window, the search's craft): the field's pill */
-.commWhen select,.commFind select{flex:0 1 auto;min-height:44px;padding:0 14px;font:inherit;font-size:14.5px;color:var(--ink);
+.commWhen select,.commFind select,.commFor select{flex:0 1 auto;min-height:44px;padding:0 14px;font:inherit;font-size:14.5px;color:var(--ink);
   background:var(--bg-card);border:1px solid var(--ctl-line);border-radius:var(--radius-pill);cursor:pointer;}
-.commWhen select:focus-visible,.commFind input:focus-visible,.commFind select:focus-visible{outline:2px solid var(--focus);outline-offset:3px;box-shadow:0 0 0 8px var(--bg);}
+.commWhen select:focus-visible,.commFind input:focus-visible,.commFind select:focus-visible,.commFor select:focus-visible{outline:2px solid var(--focus);outline-offset:3px;box-shadow:0 0 0 8px var(--bg);}
 #findStatus{margin-top:8px;}
+/* the Recruit door, a project owner's only (task 1002292): what it opens, or which
+   project it recruits to; then a fifth column after the credits, where your own row
+   keeps an invisible twin so every row's credits line up */
+.commFor{display:flex;flex-wrap:wrap;align-items:center;gap:6px 10px;margin:6px 0 4px;max-width:62ch;font-size:13.5px;line-height:1.5;color:var(--ink-soft);}
+#findFor{margin-top:12px;}
+.commRows.canRecruit .commRow{grid-template-columns:3ch 36px minmax(0,1fr) auto auto;}
+.commGap{visibility:hidden;}
 /* the recruiter list, signed out: the account page's door */
 .commDoor{padding:8px 0 10px;max-width:62ch;}
 .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;}
 @media (max-width:480px){
-  .commRow{grid-template-columns:3ch 32px minmax(0,1fr) auto;gap:0 10px;}
+  .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;}
+  /* no room for a fifth column: Recruit drops under the name, as a row's actions do */
+  .commRow .commRecruit{grid-column:3/-1;justify-self:start;margin-top:8px;}
+  .commGap{display:none;}
 }
 </style>
 </head>
@@ -119,6 +134,7 @@
       <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/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>
     </ul>
   </div>
 </div>
@@ -129,7 +145,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"><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>
     </ul>
   </div>
 </div>
@@ -175,6 +191,7 @@
         </div>
       </div>
       <p class="commNote" id="boardNote">{{Currency}} earned across every project, since each builder started.</p>
+      <div class="commFor" id="boardFor" hidden></div>
       <p class="commMsg" id="boardLoading" role="status">Reading the leaderboard…</p>
       <p class="projMsg err" id="boardFailed" role="alert" hidden></p>
       <p class="commMsg" id="boardEmpty" hidden></p>
@@ -200,6 +217,7 @@
         </select>
         <button id="findBtn" type="submit" class="btn small">Search</button>
       </form>
+      <div class="commFor" id="findFor" hidden></div>
       <p class="projMsg" id="findStatus" role="status" aria-live="polite"></p>
       <ul class="mineRows" id="findList"></ul>
     </section>
@@ -258,8 +276,9 @@
   var UNIT = $('boardList').getAttribute('data-unit') || 'credits';
 
   /* THREE THINGS THESE PAGES MUST NOT DO (ADR 0217 D1, ADR 0337 D4.1, ADR 0255):
-       1. differ for a viewer anywhere but the recruiter list — the leaderboard and the
-          search are drawn from viewer-independent reads, and neither asks /me;
+       1. differ for a viewer anywhere but the recruiter list and the Recruit door — the
+          leaderboard and the search rows come from viewer-independent reads, and a
+          project owner only gains a link on each (task 1002292, spec D6);
        2. draw a recruiter row from anything but a 200 of GET /scouting, or draw more of a
           name-only row than its name, face and login;
        3. re-rank, re-filter or re-count what the server sent — rows are drawn in the
@@ -316,6 +335,36 @@
     return arr(list).map(function (d) { return CRAFT_WORD[d] || String(d); }).join(' · ');
   }
 
+  // ── the Recruit door: a project owner's link on each row (task 1002292) ─────
+  // Who sees it is GET /my-projects' `owned` (owner, 2026-10-27): the hub cannot read a
+  // project's project.recruit. Where it goes is invite-notices.js hallInviteUrl's shape,
+  // the project's hall invite box, which only fills the name in; the project decides.
+  var recruit = { to: [], pick: 0, me: '' };
+  function originOf(raw) {
+    try {
+      var u = new URL(String(raw));
+      return (u.protocol === 'https:' || u.protocol === 'http:') ? u.origin : '';
+    } catch (e) { return ''; }
+  }
+  // `keepPlace`: a board row keeps an invisible twin on your own row, so its credits line up
+  function recruitCell(r, keepPlace) {
+    var p = recruit.to[recruit.pick];
+    if (!p) return null;
+    var login = String(r.github_login || '');
+    if (!login || login.toLowerCase() === recruit.me) {
+      if (!keepPlace) return null;
+      var gap = el('span', 'btn small ghost commRecruit commGap', 'Recruit');
+      gap.setAttribute('aria-hidden', 'true');
+      return gap;
+    }
+    var a = el('a', 'btn small ghost commRecruit', 'Recruit');
+    a.setAttribute('href', p.origin + '/builders/watch?invite=' + encodeURIComponent(login));
+    a.setAttribute('target', '_blank');
+    a.setAttribute('rel', 'noopener');
+    a.setAttribute('aria-label', 'Recruit ' + (r.display_name || r.handle || login) + ' to ' + p.name + ' (opens in a new tab)');
+    return a;
+  }
+
   // ── the leaderboard ─────────────────────────────────────────────────────────
   var board = { window: 'all', craft: '' };
   var boardSeq = 0;
@@ -337,6 +386,8 @@
     credits.appendChild(el('span', 'commNum', num(r.credits).toLocaleString()));
     credits.appendChild(el('span', 'commUnit', UNIT));
     li.appendChild(credits);
+    var door = recruitCell(r, true);
+    if (door) li.appendChild(door);
     return li;
   }
   function emptyText() {
@@ -344,8 +395,11 @@
     if (board.window === 'all') return 'No ' + who + ' on the leaderboard yet.';
     return 'No ' + who + ' earned ' + UNIT + ' in this window yet.';
   }
+  var boardShown = null; // the last board drawn, redrawn when the Recruit door changes
   function paintBoard(results) {
     var list = $('boardList');
+    boardShown = results;
+    list.className = 'commRows' + (recruit.to.length ? ' canRecruit' : '');
     list.textContent = '';
     results.forEach(function (r) { if (r) list.appendChild(boardRow(r)); });
     $('boardEmpty').textContent = list.children.length ? '' : emptyText();
@@ -365,6 +419,7 @@
       if (seq !== boardSeq) return; // a later pick answered first; its rows win
       $('boardLoading').hidden = true;
       if (!r.ok) {
+        boardShown = null;
         $('boardList').textContent = '';
         $('boardEmpty').hidden = true;
         $('boardFailed').textContent = failText(r.status, 'The leaderboard');
@@ -402,23 +457,35 @@
     if (c) main.appendChild(el('p', 'mineRow__hint', c));
     who.appendChild(main);
     li.appendChild(who);
+    var door = recruitCell(r, false);
+    if (door) {
+      var acts = el('div', 'mineRow__actions');
+      acts.appendChild(door);
+      li.appendChild(acts);
+    }
     return li;
   }
+  var found = null; // the last results drawn, redrawn when the Recruit door changes
+  function paintFound(results) {
+    var list = $('findList');
+    found = results;
+    list.textContent = '';
+    if (results) results.forEach(function (p) { if (p) list.appendChild(findRow(p)); });
+  }
   function find() {
     var q = String($('findQ').value || '').trim();
     var craft = $('findCraft').value || '';
     var list = $('findList');
-    if (q.length < QUERY_MIN) { list.textContent = ''; say('Type at least ' + QUERY_MIN + ' letters of a name.', 'err'); return Promise.resolve(); }
-    if (q.length > QUERY_MAX) { list.textContent = ''; say('A search is at most ' + QUERY_MAX + ' characters.', 'err'); return Promise.resolve(); }
+    if (q.length < QUERY_MIN) { paintFound(null); say('Type at least ' + QUERY_MIN + ' letters of a name.', 'err'); return Promise.resolve(); }
+    if (q.length > QUERY_MAX) { paintFound(null); say('A search is at most ' + QUERY_MAX + ' characters.', 'err'); return Promise.resolve(); }
     var btn = $('findBtn');
     btn.disabled = true;
     say('Searching…');
     var path = '/community/search?q=' + encodeURIComponent(q) + (craft ? '&discipline=' + encodeURIComponent(craft) : '');
     return read(path).then(function (r) {
       btn.disabled = false;
-      list.textContent = '';
-      if (!r.ok) { say(failText(r.status, 'The search'), 'err'); return; }
-      arr(r.data.results).forEach(function (p) { if (p) list.appendChild(findRow(p)); });
+      if (!r.ok) { paintFound(null); say(failText(r.status, 'The search'), 'err'); return; }
+      paintFound(arr(r.data.results));
       var n = list.children.length;
       say(n ? plural(n, 'builder') + ' found.' : 'No builder by that name' + (craft ? ' in that role' : '') + '.');
     });
@@ -448,6 +515,51 @@
     });
   }
 
+  // ── the Recruit door's line, and the rows redrawn with it ───────────────────
+  function repaintRows() {
+    if (boardShown) paintBoard(boardShown);
+    if (found) paintFound(found);
+  }
+  // One project: what Recruit opens. Several: which one it recruits to, drawn once, so a
+  // pick redraws only the rows and the choice keeps the focus.
+  function paintFor(box) {
+    box.textContent = '';
+    box.hidden = false;
+    if (recruit.to.length === 1) {
+      box.textContent = 'Recruit opens ' + recruit.to[0].name + '’s hall with their name filled in, and you send the invite there.';
+      return;
+    }
+    var id = box.id + 'Pick';
+    var label = el('label', null, 'Recruit to');
+    label.setAttribute('for', id);
+    var pick = el('select', 'commForPick');
+    pick.id = id;
+    recruit.to.forEach(function (p, i) { var o = el('option', null, p.name); o.value = String(i); pick.appendChild(o); });
+    pick.value = String(recruit.pick);
+    pick.addEventListener('change', function () {
+      var i = Number(pick.value);
+      if (!recruit.to[i] || i === recruit.pick) return;
+      recruit.pick = i;
+      repaintRows();
+    });
+    box.appendChild(label);
+    box.appendChild(pick);
+    box.appendChild(el('span', null, 'Recruit opens its hall with their name filled in, and you send the invite there.'));
+  }
+  // A failed or empty read is no door at all: viewing never waits on it.
+  function loadOwned(me, box) {
+    return read('/my-projects').then(function (r) {
+      if (!r.ok) return;
+      recruit.me = String(me.github_login || '').toLowerCase();
+      recruit.to = arr(r.data.owned).map(function (p) {
+        return { name: String((p && (p.name || p.client_id)) || 'your project'), origin: originOf(p && p.origin) };
+      }).filter(function (p) { return p.origin; });
+      if (!recruit.to.length) return;
+      paintFor(box);
+      repaintRows();
+    });
+  }
+
   // ── the sub-page the path names: shown, named, marked current, and read ──────
   var VIEW = viewOf(window.location.pathname);
   var view = VIEWS[VIEW];
@@ -460,6 +572,7 @@
   $('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'); });
+  else bar.ready.then(function (me) { if (me) loadOwned(me, $(VIEW === 'find' ? 'findFor' : 'boardFor')); });
 })();
 </script>
 <script src="/assets/invite-badge.js"></script>

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

@@ -11,7 +11,9 @@
     "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-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": { "count": [["#menuCommunity .bandCell", 3]], "attr": [["#menuCommunity a[href=\"/community\"]", "aria-current", "page"]] } },
+    "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"]] } },
+    "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-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"]] } },

package/modules/public-landing/public/connections-nosuggest.states.json

@@ -0,0 +1,15 @@
+{
+  "_": "The connections page with nothing to suggest, opened by the Community menu's \"Builders you may know\" item (task 1004256): the graph is fixtures/connections-nosuggest.json, so the panel stands with its one empty line instead of vanishing. Any other visit keeps \"no suggestions, no empty shell\".",
+  "page": "/connections",
+  "surface": "public-landing",
+  "modes": ["dark"],
+  "modeQuery": false,
+  "stub": { "fixtures": { "connections": "connections-nosuggest" } },
+  "ignoreRequests": ["/api/(gds|bongos)/me$", "/my-projects", "/me/guild-"],
+  "ignoreConsole": ["/api/(gds|bongos)/me", "\\b401\\b", "Unauthorized"],
+  "ignoreControls": [".vh"],
+  "states": {
+    "in-suggest-none": { "auth": true, "url": "/connections#connSuggest", "actions": [["wait", 500]], "expect": { "visible": ["#connSuggest", "#suggestNone"], "count": [["#suggestList .mineRow", 0]] } },
+    "in-plain-none": { "auth": true, "actions": [["wait", 500]], "expect": { "visible": ["#connBody"], "hidden": ["#connSuggest"] } }
+  }
+}

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

@@ -55,6 +55,8 @@
    rows; a row with ONE button (Remove, Connect, Withdraw) keeps it beside the name */
 @media (max-width:480px){.mineRow.connOne{flex-wrap:nowrap;}.connOne .mineRow__actions{flex-basis:auto;margin-top:0;}}
 .connSub{margin:26px 0 4px;font-size:14px;font-weight:600;color:var(--ink-soft);}
+/* opened as /connections#connSuggest, the panel's heading clears the fixed bar */
+#connSuggest{scroll-margin-top:calc(var(--top-h) + 16px);}
 </style>
 </head>
 <body>
@@ -91,6 +93,7 @@
       <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/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>
     </ul>
   </div>
 </div>
@@ -101,7 +104,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"><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>
     </ul>
   </div>
 </div>
@@ -157,9 +160,11 @@
 
     <!-- "Builders you may know" (ADR 0202 D5, ADR 0337 D4.2): the server's own
          suggestions and their one-line reasons, rendered as they come. One panel:
-         the hub community page links here rather than drawing a second one. -->
+         the Community menu's "Builders you may know" item opens it here
+         (#connSuggest, task 1004256) rather than drawing a second one. -->
     <section id="connSuggest" aria-labelledby="connSuggestH" hidden>
       <h2 id="connSuggestH">Builders you may know</h2>
+      <p class="mineEmpty" id="suggestNone" hidden>No one to suggest yet. Suggestions come from the connections and projects you have in common with other builders.</p>
       <ul class="mineRows" id="suggestList"></ul>
     </section>
 
@@ -333,7 +338,11 @@
       p.row.className += ' connOne';
       sug.appendChild(p.row);
     });
-    $('connSuggest').hidden = !sug.children.length;
+    // Arriving by the Community menu's item, an empty panel says so instead of
+    // vanishing; any other visit keeps "no suggestions, no empty shell".
+    var asked = location.hash === '#connSuggest' && lists.suggestionsRead;
+    $('suggestNone').hidden = !!sug.children.length || !asked;
+    $('connSuggest').hidden = !sug.children.length && !asked;
 
     var out = $('outgoingList');
     out.textContent = '';
@@ -351,6 +360,7 @@
     $('sentH').hidden = !outgoing.length;
   }
 
+  var landed = false;
   function load() {
     return Promise.all([read('/connections'), read('/connections/requests'), read('/connections/suggestions')]).then(function (r) {
       var list = r[0], reqs = r[1], sugg = r[2];
@@ -365,7 +375,11 @@
         outgoing: arr(reqs.data.outgoing),
         // additive, never load-bearing: a failed suggestions read only omits that panel
         suggestions: sugg.ok ? arr(sugg.data.suggestions) : [],
+        suggestionsRead: sugg.ok,
       });
+      // the panel draws after the browser's own jump to #connSuggest, so make it once
+      if (!landed && location.hash === '#connSuggest' && !$('connSuggest').hidden) $('connSuggest').scrollIntoView();
+      landed = true;
     });
   }
 
@@ -446,6 +460,12 @@
     if (id !== 'connBody') $('connMsg').hidden = true;
   }
   function showDoor() { show('door'); }
+  // the menu item pressed while already here moves only the hash: answer it as an arrival
+  window.addEventListener('hashchange', function () {
+    if (location.hash !== '#connSuggest' || $('connBody').hidden) return;
+    landed = false;
+    load();
+  });
   bar.ready.then(function (me) {
     if (!me) { showDoor(); return; }
     load();

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

@@ -10,6 +10,7 @@
   "states": {
     "out": { "auth": false, "actions": [["wait", 300]], "expect": { "visible": ["#door", "#signin", "#signinTop", "#projTrig"], "hidden": ["#connBody", "#who", "#loading", "#inactive", "#readFailed"] } },
     "in": { "auth": true, "actions": [["wait", 500]], "expect": { "visible": ["#connBody", "#connAsks", "#connSuggest", "#sentH", "#askHandle", "#askBtn", "#who"], "hidden": ["#door", "#loading", "#inactive", "#readFailed", "#menuProfile"], "count": [["#incomingList .mineRow", 2], ["#connList .mineRow", 3], ["#suggestList .mineRow", 3], ["#outgoingList .mineRow", 1]], "text": [["#connCount", "3 connections."], ["#incomingList .mineRow:first-child .mineRow__name", "Priya Nair"], ["#incomingList .mineRow:first-child .connNote", "We were both on the Tidepool hall last month. Good working with you."], ["#suggestList .mineRow:first-child .mineRow__hint", "2 connections in common"], ["#outgoingList .mineRow:first-child .mineRow__hint", "Request sent"]] } },
+    "in-suggest-linked": { "auth": true, "url": "/connections#connSuggest", "actions": [["wait", 500]], "expect": { "visible": ["#connSuggest"], "hidden": ["#suggestNone"], "count": [["#suggestList .mineRow", 3]] } },
     "in-profile-band": { "auth": true, "actions": [["wait", 400], ["click", "#who"], ["wait", 300]], "expect": { "visible": ["#menuProfile"], "hidden": ["#menuProjects"], "text": [["#bandWhoLogin", "builder"], ["#menuProfile [aria-current=\"page\"]", "Connections"]] } },
     "in-ask-filled": { "auth": true, "actions": [["wait", 500], ["fill", "#askHandle", "nadia"], ["fill", "#askNote", "We met on the Tidepool hall."]], "expect": { "value": [["#askHandle", "nadia"], ["#askNote", "We met on the Tidepool hall."]] } }
   },

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

@@ -73,6 +73,7 @@
       <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/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>
     </ul>
   </div>
 </div><!--apex-only:end-->
@@ -83,7 +84,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>
-      <!--apex-only:start--><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><!--apex-only:end-->
+      <!--apex-only:start--><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><!--apex-only:end-->
     </ul>
   </div>
 </div>

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

@@ -148,6 +148,7 @@
       <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/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>
     </ul>
   </div>
 </div>
@@ -158,7 +159,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"><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>
     </ul>
   </div>
 </div>

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

@@ -170,6 +170,8 @@ main:focus{outline:none;box-shadow:none}
    room for it (the New account pill and the chip), so its three items fold into the
    Projects band as its last cells; above 900 those cells are not drawn */
 .bandFold{display:none}
+/* no global [hidden] rule on the landing: a signed-in-only fold cell stays down when the fold shows */
+.bandFold[hidden]{display:none}
 .whoSlot{display:inline-flex;align-items:center}
 .who{gap:9px}
 .who img{width:26px;height:26px;border-radius:var(--radius-pill);object-fit:cover;flex:none;border:1px solid var(--rule)}
@@ -720,6 +722,7 @@ composition A; landing composition v3, picked by the owner 2026-08-27. No roll,
       <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/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>
     </ul>
   </div>
 </div><!--apex-only:end-->
@@ -730,7 +733,7 @@ composition A; landing composition v3, picked by the owner 2026-08-27. No roll,
       <li class="bandCell"><a class="bandT" href="/projects?view=map&amp;sub=table">Table</a><span class="bandC">sky project directory</span></li>
       <li class="bandCell" id="mineCell" hidden><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">+ Create New Project</a><span class="bandC">fresh start/fresh idea</span></li>
-      <!--apex-only:start--><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><!--apex-only:end-->
+      <!--apex-only:start--><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><!--apex-only:end-->
     </ul>
     <!-- About and Docs are site pages, not project views: they live in the footer row with
          Privacy / Terms / Contact (owner, 2026-08-28; task 1003332). -->
@@ -1053,9 +1056,10 @@ composition A; landing composition v3, picked by the owner 2026-08-27. No roll,
     chip.appendChild(cv);
     slot.appendChild(chip);
     wireTrigger(chip);
-    /* a member sees the Your-projects cell of the Projects band */
+    /* a member sees the Your-projects cell of the Projects band, and Builders you may know */
     var mine = document.getElementById('mineCell');
     if (mine) mine.hidden = false;
+    document.querySelectorAll('.knowCell').forEach(function (c) { c.hidden = false; });
   });
   /* the sign-out anchor keeps its honest href; the click is the real POST */
   var signout = document.querySelector('#menuProfile a.signout');

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

@@ -103,6 +103,7 @@
       <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/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>
     </ul>
   </div>
 </div>
@@ -113,7 +114,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"><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>
     </ul>
   </div>
 </div>

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

@@ -72,6 +72,7 @@
       <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/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>
     </ul>
   </div>
 </div><!--apex-only:end-->
@@ -82,7 +83,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>
-      <!--apex-only:start--><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><!--apex-only:end-->
+      <!--apex-only:start--><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><!--apex-only:end-->
     </ul>
   </div>
 </div>