@bongos/core 1.19.1044 → 1.19.1046

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

@@ -1,321 +0,0 @@
-// people.js — the People page: the cross-project builder directory (task
-// 1002577; ADR 0141 §4 is the data's design of record), served at /people —
-// task 1003470 first made its legacy door /scouting render this same script,
-// and task 1003440 deleted that door (the URL 301s here), because the
-// same /api/bongos/scouting rollup was being drawn three
-// different ways (a kit ledger here, a hand-built table there, and the same
-// columns in a different order). The endpoint is gated server-side on
-// 'project.curate' OR being a project owner (R14, ADR 0210); this page is
-// gated in serve-internal.js on that same pair, so a visitor who is neither
-// never sees this shell.
-//
-// What a directory row is (task 1003470): WHO — the avatar the API returns and
-// both pages dropped, the display name, the login under it as the door (GitHub
-// is the identity the platform account is keyed on, and the one page every
-// listed builder has: the directory is cross-project, so no local profile id
-// exists); then the four figures in tabular columns, the crafts as chips, and
-// when they were last seen. Search, a sort and a craft lens are the kit's
-// filter bar; the rows page through the kit's pager.
-//
-// THE SECOND TIER (task 1002291, ADR 0334). The response also carries
-// `name_only`: builders who hid their cross-project record but are still open to
-// recruiting, which privacy spec D2 lists "name-only". They get their own panel
-// of identity cells because they have no record to rank, sort or filter by role:
-// the lenses below leave them alphabetical, a search reads their name, and a
-// role filter never matches them.
-// All network values render through OTBKit.esc — never raw innerHTML.
-(function () {
-  'use strict';
-  var kit = window.OTBKit;
-  var OTB = window.OTB;
-  var esc = kit.esc;
-  var body = document.getElementById('people-body');
-  var sub = document.getElementById('people-sub');
-  var countPill = document.getElementById('people-count');
-  var foot = document.getElementById('people-foot');
-  var namedScroll = document.getElementById('people-named-scroll');
-  var namedCount = document.getElementById('people-named-count');
-  var namedBody = document.getElementById('people-named-body');
-  var namedFoot = document.getElementById('people-named-foot');
-
-  function fmtRecency(iso) {
-    if (!iso) return '—';
-    var t = Date.parse(iso);
-    if (isNaN(t)) return '—';
-    var days = Math.floor((Date.now() - t) / 86400000);
-    if (days <= 0) return 'today';
-    if (days === 1) return '1 day ago';
-    if (days < 30) return days + ' days ago';
-    return Math.floor(days / 30) + ' mo ago';
-  }
-  var fmtInt = function (n) { return OTB && OTB.fmtInt ? OTB.fmtInt(n) : String(n == null ? 0 : n); };
-  var rankLabel = function (r) { return OTB && OTB.rankLabel ? OTB.rankLabel(r) : r; };
-  // A ROW TAG TAKES roleLabel() (dom-utils.js, task 1004041). Without it the Directory
-  // printed the column: lowercase 'engineer', 'ui' instead of 'UI', and — for a builder
-  // who has set no role — 'unclassified', which is the example V2 names, in the exact
-  // place it names it. Same defensive shape as rankLabel above: the pack may be absent.
-  var roleLabel = function (d) { return OTB && OTB.roleLabel ? OTB.roleLabel(d) : String(d); };
-  var currencyLabel = function () {
-    var b = window.OTBBranding;
-    return (b && b.currencyLabel && b.currencyLabel({ caps: true })) || 'Credits';
-  };
-
-  function builderName(b) {
-    return b.display_name || b.github_login || ('#' + b.github_id);
-  }
-  function initialOf(b) {
-    var n = String(builderName(b)).replace(/^[@#]/, '');
-    return (n.charAt(0) || '?').toUpperCase();
-  }
-
-  // The identity cell. The name is the shell's .lb-name (a door that reads as
-  // text until hovered) when a login exists to open; the login sits under it in
-  // mono so the door's destination is never a surprise.
-  function whoHtml(b) {
-    var name = esc(builderName(b));
-    var avatar = b.avatar_url
-      ? '<img class="dir-avatar" src="' + esc(b.avatar_url) + '" alt="" loading="lazy">'
-      : '<span class="dir-avatar dir-avatar--initial" aria-hidden="true">' + esc(initialOf(b)) + '</span>';
-    var nameHtml = b.github_login
-      ? '<a class="lb-name dir-name" href="https://github.com/' + encodeURIComponent(b.github_login) + '" rel="noopener">' + name + '</a>'
-      : '<span class="dir-name">' + name + '</span>';
-    var login = b.github_login ? '<span class="dir-login">@' + esc(b.github_login) + '</span>' : '';
-    return '<span class="dir-who">' + avatar + '<span class="dir-who__t">' + nameHtml + login + '</span></span>';
-  }
-  function craftsHtml(b) {
-    var list = Array.isArray(b.disciplines) ? b.disciplines : [];
-    if (!list.length) return '<span class="dir-none">—</span>';
-    return '<span class="dir-crafts">' + list.map(function (d) {
-      return '<span class="fact-chip">' + esc(roleLabel(d)) + '</span>';
-    }).join('') + '</span>';
-  }
-
-  // THE DIRECTORY ASKS FOR THE ENDPOINT MAXIMUM, so a full response is the only
-  // truncation signal that exists. `GET /scouting` clamps at parsePagination
-  // maxLimit: 500, takes no offset, and `listScoutingRollup` returns rows with no
-  // count of the whole set — so `length === DIRECTORY_LIMIT` means "at least this
-  // many", never "exactly this many", and there is nothing else to read it from.
-  // ONE constant feeds the request AND every sentence written about it, so the
-  // number a reader is shown can never drift from the number that was asked for.
-  //
-  // This is part 1 of task 1003110 — the honest half, which removes the
-  // silent-lie property whatever the real count turns out to be. Part 2 is
-  // server-offset paging, and it is deliberately NOT here: the kit has carried
-  // the mode since task 1003281 (`makeLedger({ serverPager, onPage })`), but the
-  // ROUTE cannot serve it — no offset parameter, no total, a hard 500 ceiling —
-  // so paging this page is a server change first. Its trigger is a directory
-  // approaching ~400; a read on 2026-09-16 returned far fewer.
-  var DIRECTORY_LIMIT = 500;
-
-  var all = [];
-  var named = [];
-  var query = '';
-  var craft = '';
-  var sortBy = '';
-
-  function matches(b) {
-    if (craft && !(Array.isArray(b.disciplines) && b.disciplines.indexOf(craft) !== -1)) return false;
-    if (!query) return true;
-    var hay = ((b.github_login || '') + ' ' + (b.display_name || '') + ' ' +
-      (Array.isArray(b.disciplines) ? b.disciplines.join(' ') : '')).toLowerCase();
-    return hay.indexOf(query) !== -1;
-  }
-  // A name-only row carries no roles (they are part of the hidden record), so a
-  // role filter never matches it; a search reads the name.
-  function matchesNamed(b) {
-    if (craft) return false;
-    if (!query) return true;
-    return ((b.github_login || '') + ' ' + (b.display_name || '')).toLowerCase().indexOf(query) !== -1;
-  }
-  // A count that cannot overstate a clipped read: a full response means "at least".
-  function countText(n) {
-    return n >= DIRECTORY_LIMIT ? fmtInt(DIRECTORY_LIMIT) + '+' : fmtInt(n);
-  }
-  // The server's order IS "track record" (ADR 0141 §4 ranks the rollup); the
-  // other lenses re-order the loaded set client-side, ties keeping that order.
-  var SORTS = {
-    '': null,
-    ships: function (b) { return -(b.total_tasks_shipped || 0); },
-    credits: function (b) { return -(b.total_credits || 0); },
-    karma: function (b) { return -(b.total_karma || 0); },
-    projects: function (b) { return -(b.project_count || 0); },
-    recent: function (b) { var t = Date.parse(b.last_active || ''); return isNaN(t) ? Infinity : -t; },
-  };
-  function ordered(rows) {
-    var key = SORTS[sortBy];
-    if (!key) return rows;
-    return rows.map(function (b, i) { return { b: b, i: i }; })
-      .sort(function (x, y) { return (key(x.b) - key(y.b)) || (x.i - y.i); })
-      .map(function (x) { return x.b; });
-  }
-
-  var pager = kit.makePager('people', 'hall-people-per-page');
-  var ledger = null;
-  var namedPager = kit.makePager('people-named', 'hall-people-named-per-page');
-  var namedLedger = null;
-
-  function rowHtml(b) {
-    return '<tr>' +
-      '<td>' + whoHtml(b) + '</td>' +
-      '<td class="ledger__num">' + esc(fmtInt(b.project_count != null ? b.project_count : 0)) + '</td>' +
-      '<td class="ledger__num">' + esc(fmtInt(b.total_tasks_shipped != null ? b.total_tasks_shipped : 0)) + '</td>' +
-      '<td class="ledger__num">' + esc(fmtInt(b.total_credits != null ? b.total_credits : 0)) + '</td>' +
-      '<td class="ledger__num">' + esc(fmtInt(b.total_karma != null ? b.total_karma : 0)) + '</td>' +
-      '<td>' + craftsHtml(b) + '</td>' +
-      '<td class="ledger__date">' + esc(fmtRecency(b.last_active)) + '</td>' +
-      '</tr>';
-  }
-
-  // The identity cell and nothing else: every other column is the record hidden.
-  function namedRowHtml(b) {
-    return '<tr><td>' + whoHtml(b) + '</td></tr>';
-  }
-
-  function rerender() {
-    if (ledger) ledger.render(ordered(all.filter(matches)));
-    if (namedLedger) namedLedger.render(named.filter(matchesNamed));
-  }
-
-  function mountNamed() {
-    if (!namedScroll || !named.length) return;
-    namedScroll.hidden = false;
-    if (namedCount) {
-      namedCount.textContent = countText(named.length);
-      namedCount.hidden = false;
-    }
-    // The ranked footnote's rule, for the one lens that reads this list: a full
-    // response is clipped, and a search cannot find a builder it never loaded.
-    var namedClipped = named.length >= DIRECTORY_LIMIT;
-    if (namedFoot) {
-      namedFoot.textContent = namedClipped
-        ? 'This list is clipped at the first ' + fmtInt(DIRECTORY_LIMIT) + ' by login. Search only reads what this page loaded, so a builder past that ' + fmtInt(DIRECTORY_LIMIT) + ' will not appear in it.'
-        : '';
-      namedFoot.hidden = !namedClipped;
-    }
-    namedLedger = kit.makeLedger({
-      mount: namedBody,
-      columns: ['Builder'],
-      rowHtml: namedRowHtml,
-      emptyMsg: 'No builder listed by name only matches these filters.',
-      pager: namedPager,
-    });
-  }
-
-  function mountDirectory(builders, nameOnly) {
-    all = Array.isArray(builders) ? builders : [];
-    named = Array.isArray(nameOnly) ? nameOnly : [];
-    if (namedScroll) namedScroll.hidden = true;
-    // An EMPTY directory is almost never missing data — it is ADR 0171's
-    // fail-closed consent boundary doing exactly what it was ratified to do.
-    // `listScoutingRollup` filters on `profile_state = 'active'`, every account
-    // starts `'provisional'`, and an account activates ONLY when its human signs
-    // in at the hub itself (P03, ratified by the owner 2026-08-16: no backfill
-    // activation). This builders hall predates the hub flow, so its builders stay
-    // unlisted until each has signed in there once.
-    //
-    // Reporting that as "no cross-project activity reported yet" is actively
-    // misleading — the activity exists and is visible on every project's own
-    // leaderboard; the accounts simply are not publicly listed — and that wrong
-    // explanation is why an empty directory got filed as a bug (task 1002937).
-    // Say which of the two it is, so the page is never mistaken for broken.
-    if (!all.length && !named.length) {
-      notice('Nobody is publicly listed here yet. A builder joins this directory once they have '
-        + 'signed in on the main platform site at least once — accounts stay unlisted until then, '
-        + 'and none are listed without it. Their work still shows on each project’s own ledger.');
-      return;
-    }
-    // A FULL PAGE IS A CLIPPED PAGE. Every sentence below has to hedge when this
-    // is true, because each of them otherwise states a total the page cannot know.
-    var clipped = all.length >= DIRECTORY_LIMIT;
-    // The second tier, named in the same sentence so the ranked count is never
-    // read as everyone the directory lists.
-    var namedPart = named.length ? '; ' + countText(named.length) + ' more by name only' : '';
-    if (countPill) {
-      countPill.textContent = clipped ? fmtInt(DIRECTORY_LIMIT) + '+' : String(all.length);
-      countPill.hidden = false;
-    }
-    if (sub) {
-      var listed = clipped
-        ? 'Showing the first ' + fmtInt(DIRECTORY_LIMIT) + ' builders across hosted projects, ranked by track record — there are more than this page can load' + namedPart
-        : all.length
-          ? fmtInt(all.length) + ' builder' + (all.length === 1 ? '' : 's') + ' listed across hosted projects, ranked by track record' + namedPart
-          // Nobody ranked yet: "0 builders ranked; 2 more by name only" would read as a count of nothing.
-          : countText(named.length) + ' builder' + (named.length === 1 ? '' : 's') + ' listed across hosted projects by name only';
-      sub.textContent = listed + '. Descriptive only — cross-project numbers never carry authority here.';
-    }
-    // THE LENSES LIE HARDER THAN THE COUNT DOES, and that is worth its own
-    // sentence. Search, sort and the craft filter all re-order the set this page
-    // already loaded (see SORTS above) — so on a clipped directory "most karma"
-    // is the most karma AMONG THE TOP 500 BY TRACK RECORD, and a builder outside
-    // that 500 cannot be found by any of them. A reader who is told only that the
-    // list is long would still trust the search.
-    if (foot) {
-      foot.textContent = clipped
-        ? 'The directory is clipped at the first ' + fmtInt(DIRECTORY_LIMIT) + ' by track record. Search and the sort lenses only re-order what this page loaded, so a builder outside that ' + fmtInt(DIRECTORY_LIMIT) + ' will not appear in them.'
-        : '';
-      foot.hidden = !clipped;
-    }
-    var crafts = [];
-    all.forEach(function (b) {
-      (Array.isArray(b.disciplines) ? b.disciplines : []).forEach(function (d) {
-        if (crafts.indexOf(d) === -1) crafts.push(d);
-      });
-    });
-    crafts.sort();
-    kit.makeFilterBar({
-      mount: document.getElementById('people-filters'),
-      search: { id: 'people-q', label: 'Search', placeholder: `name or ${window.OTB.roleAxisLabel().toLowerCase()}` },
-      primary: [
-        { id: 'people-sort', label: 'Sort', options: [
-          { value: '', label: 'track record' }, { value: 'ships', label: 'most ships' },
-          { value: 'credits', label: 'most ' + currencyLabel().toLowerCase() }, { value: 'karma', label: 'most karma' },
-          { value: 'projects', label: 'most projects' }, { value: 'recent', label: 'most recently active' }] },
-        { id: 'people-craft', label: window.OTB.roleAxisLabel(), options: [{ value: '', label: '— any —' }].concat(crafts.map((c) => ({ value: c, label: window.OTB.roleLabel(c) }))) },
-      ],
-      onChange: function (vals) {
-        query = String(vals['people-q'] || '').trim().toLowerCase();
-        craft = String(vals['people-craft'] || '');
-        sortBy = String(vals['people-sort'] || '');
-        pager.page = 1;
-        namedPager.page = 1;
-        rerender();
-      },
-    });
-    body.textContent = '';
-    body.className = '';
-    ledger = kit.makeLedger({
-      mount: body,
-      columns: ['Builder', { label: 'Projects', class: 'ledger__num' }, { label: 'Ships', class: 'ledger__num' },
-        { label: currencyLabel(), class: 'ledger__num' }, { label: 'Karma', class: 'ledger__num' }, `${window.OTB.roleAxisLabel()}s`, 'Last active'],
-      rowHtml: rowHtml,
-      // With ranked builders, reached only when the lenses excluded them all;
-      // without, the directory lists hidden builders alone (the panel below) —
-      // the fully empty case returns above with its own explanation.
-      emptyMsg: all.length ? 'No listed builder matches that search.' : 'No builder with a public track record is listed yet.',
-      pager: pager,
-    });
-    mountNamed();
-    rerender();
-  }
-
-  function notice(msg) {
-    body.innerHTML = '';
-    body.className = 'note';
-    body.textContent = msg;
-  }
-
-  fetch('/api/bongos/scouting?limit=' + DIRECTORY_LIMIT, { headers: { Accept: 'application/json' } })
-    .then(function (r) {
-      if (r.status === 403 || r.status === 401) { throw { gated: true }; }
-      if (!r.ok) throw new Error('http ' + r.status);
-      return r.json();
-    })
-    .then(function (data) { mountDirectory(data && data.builders, data && data.name_only); })
-    .catch(function (e) {
-      // The floor is the pack's label for metic, never a hardcoded rank name —
-      // and the page used to say "Archon-only", which was wrong since ADR 0210.
-      notice(e && e.gated
-        ? 'The directory opens at the ' + rankLabel('metic') + ' rank, or to a project’s owner.'
-        : 'Couldn’t load the directory right now.');
-    });
-}());

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

@@ -1,89 +0,0 @@
-{
-  "_": "People — the cross-project directory behind requireProjectCuratePage (metic+ via project.curate, or a project owner). Descriptive only; it grants no authority, and the page says so above the fold. Written with the re-skin (task 1003307); the redesign (task 1003470) added the identity cell, the sort and craft lenses, and the `search` state. Its legacy door /scouting was deleted in task 1003440; the URL 301s here. Populated look: the hall-preview harness (scripts/hall-preview/fixtures/scouting.json carries five builders, three with avatars, plus two listed by name only — task 1002291 added that second panel; the `search` state shows its empty case).",
-  "page": "/builders/people",
-  "surface": "hall-ui",
-  "stub": {
-    "prefix": "/builders/"
-  },
-  "modeQuery": false,
-  "_feeds": "The kit's own stub carries no feed for this page, so against it the page renders its EMPTY and SKELETON states — which is the point: those are states the floors must hold in. Against the hall-preview harness the same states render populated. Every declared 404 below is a fixture the harness does not carry, named rather than hidden.",
-  "ignoreRequests": [
-    "/api/(gds|bongos)/me$",
-    "/api/(gds|bongos)/me/",
-    "/api/(gds|bongos)/goals",
-    "/api/(gds|bongos)/inbox/",
-    "/api/(gds|bongos)/versions",
-    "/api/(gds|bongos)/builders",
-    "/api/(gds|bongos)/scouting",
-    "/api/(gds|bongos)/public/"
-  ],
-  "ignoreConsole": [
-    "/api/(gds|bongos)/",
-    "\\b401\\b",
-    "\\b403\\b",
-    "\\b404\\b",
-    "\\b501\\b",
-    "Unauthorized",
-    "Forbidden",
-    "Not Found",
-    "Not Implemented",
-    "load failed"
-  ],
-  "states": {
-    "directory": {
-      "auth": true,
-      "actions": [
-        [
-          "wait",
-          700
-        ]
-      ],
-      "expect": {
-        "visible": [
-          "#people-scroll"
-        ]
-      }
-    },
-    "search": {
-      "auth": true,
-      "actions": [
-        [
-          "wait",
-          700
-        ],
-        [
-          "fill",
-          "#people-q",
-          "hyp"
-        ],
-        [
-          "wait",
-          200
-        ]
-      ],
-      "expect": {
-        "visible": [
-          "#people-scroll"
-        ],
-        "value": [
-          [
-            "#people-q",
-            "hyp"
-          ]
-        ]
-      }
-    },
-    "out": {
-      "auth": false
-    }
-  },
-  "reducedMotion": {
-    "auth": true,
-    "actions": [
-      [
-        "wait",
-        600
-      ]
-    ]
-  }
-}