@bongos/core 1.21.40 → 1.21.42

package/modules/hall-ui/public/page-notes.js

@@ -0,0 +1,320 @@
+// page-notes.js — the Artistry palette's feedback doc (task 1004496, goal
+// 1000095 WA6). Loaded on demand by craft-mode.js: when the palette button is
+// pressed (open) or a page arrives with ?note=N (openNote). Never on page load.
+//
+// A side sheet over the page: write a doc about THIS page (as long as it needs
+// to be), add reference images, and "Turn into ideas" — the server's AI split
+// files each point as its own idea under your name, and the doc stays as the
+// page's reference. Below the writing area, the page's earlier docs; each opens
+// in place. The draft saves as you type, so closing loses nothing.
+//
+// The walls are the server's (modules/page-notes): a draft is its author's, a
+// submitted doc is any signed-in builder's. This file only draws.
+(function () {
+  'use strict';
+
+  var API = '/api/bongos/page-notes';
+  var IMAGE_RE = /!\[([^\]\n]{0,120})\]\(\/api\/bongos\/page-notes\/images\/(\d{1,18})\)/g;
+  var MAX_IMAGE_BYTES = 4 * 1024 * 1024;
+  var MAX_IMAGES = 8;
+  var TYPES = ['image/png', 'image/jpeg', 'image/gif', 'image/webp'];
+
+  var sheet = null, returnFocus = null, state = null, saveTimer = null, pollTimer = null;
+
+  function esc(s) {
+    return String(s == null ? '' : s).replace(/[&<>"']/g, function (c) {
+      return { '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' }[c];
+    });
+  }
+  function page() {
+    var b = document.body || { dataset: {} };
+    var slug = String((b.dataset && b.dataset.page) || 'home').toLowerCase().replace(/[^a-z0-9_-]/g, '-').slice(0, 64) || 'home';
+    var title = (b.dataset && b.dataset.pageTitle) || String(document.title || '').split(/\s[—-]\s/)[0] || slug;
+    var path = String((window.location && window.location.pathname) || '/').replace(/[^A-Za-z0-9/_.-]/g, '').slice(0, 200) || '/';
+    return { id: 'builders:' + slug, path: path, title: title.slice(0, 120) };
+  }
+  function api(method, path, body) {
+    var opts = { method: method, credentials: 'same-origin', headers: {} };
+    if (body !== undefined) { opts.headers['content-type'] = 'application/json'; opts.body = JSON.stringify(body); }
+    return fetch(API + path, opts).then(function (r) {
+      return r.json().catch(function () { return {}; }).then(function (j) {
+        if (!r.ok) {
+          var e = new Error((j && j.error && j.error.message) || (r.status === 401 ? 'Sign in to write page feedback.' : 'That did not work. Try again in a moment.'));
+          e.status = r.status;
+          throw e;
+        }
+        return j;
+      });
+    });
+  }
+  function day(iso) {
+    var d = iso ? new Date(iso) : null;
+    return d && !isNaN(d) ? d.toLocaleDateString(undefined, { month: 'short', day: 'numeric' }) : '';
+  }
+  function plural(n, one, many) { return n + ' ' + (n === 1 ? one : many); }
+
+  // The doc, read: headings, lists, paragraphs, and only this module's own images.
+  function renderBody(md) {
+    var out = [], para = [], list = [];
+    function flushPara() { if (para.length) { out.push('<p>' + para.join('<br>') + '</p>'); para = []; } }
+    function flushList() { if (list.length) { out.push('<ul>' + list.map(function (x) { return '<li>' + x + '</li>'; }).join('') + '</ul>'); list = []; } }
+    function inline(line) {
+      return esc(line).replace(IMAGE_RE, function (_m, alt, id) {
+        return '<img class="pn-doc__img" src="' + API + '/images/' + id + '" alt="' + alt + '" loading="lazy">';
+      });
+    }
+    String(md || '').split('\n').forEach(function (raw) {
+      var line = raw.replace(/\s+$/, '');
+      var h = /^(#{1,3})\s+(.*)$/.exec(line);
+      var li = /^\s*[-*]\s+(.*)$/.exec(line);
+      if (!line.trim()) { flushPara(); flushList(); return; }
+      if (h) { flushPara(); flushList(); out.push('<h3 class="pn-doc__h">' + inline(h[2]) + '</h3>'); return; }
+      if (li) { flushPara(); list.push(inline(li[1])); return; }
+      flushList();
+      para.push(inline(line));
+    });
+    flushPara(); flushList();
+    return out.join('');
+  }
+
+  // ---------- the sheet ----------
+  function shellHtml(p) {
+    return '<div class="pn__panel" role="dialog" aria-modal="true" aria-labelledby="pn-title">' +
+      '<div class="pn__head">' +
+        '<p class="pn__eyebrow">Page feedback · ' + esc(p.title) + '</p>' +
+        '<h2 class="pn__title" id="pn-title">What should this page be?</h2>' +
+        '<button class="pn__close" type="button" data-pn-close aria-label="Close">' +
+          '<svg viewBox="0 0 18 18" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" aria-hidden="true"><path d="M5 5l8 8M13 5l-8 8"/></svg></button>' +
+      '</div>' +
+      '<div class="pn__body" id="pn-body"><p class="pn__quiet">Opening your doc…</p></div>' +
+    '</div>';
+  }
+  function writeHtml() {
+    var n = state.note, imgs = state.images;
+    return '<label class="pn__label" for="pn-text">Your feedback</label>' +
+      '<textarea class="pn__text" id="pn-text" rows="14" placeholder="Write what you see on this page and what it should be. Long is fine: each separate point becomes its own idea.">' + esc(n.body_md) + '</textarea>' +
+      '<div class="pn__tools">' +
+        '<label class="pn__add"><input type="file" id="pn-file" accept="' + TYPES.join(',') + '" multiple>Add images</label>' +
+        '<span class="pn__quiet" id="pn-count">' + imgs.length + ' of ' + MAX_IMAGES + ' images</span>' +
+        '<span class="pn__quiet pn__saved" id="pn-saved" aria-live="polite"></span>' +
+      '</div>' +
+      (imgs.length ? '<div class="pn__thumbs">' + imgs.map(function (i) {
+        return '<img class="pn__thumb" src="' + esc(i.url) + '" alt="' + esc(i.name || 'reference image') + '">';
+      }).join('') + '</div>' : '') +
+      '<p class="pn__error" id="pn-error" role="alert"></p>' +
+      '<div class="pn__foot">' +
+        '<p class="pn__hint">When you submit, an AI splits this into separate ideas, filed under your name. The doc stays here as this page\'s reference.</p>' +
+        '<button class="pn__submit" type="button" data-pn-submit>Turn into ideas</button>' +
+      '</div>' +
+      listHtml();
+  }
+  function listHtml() {
+    var rows = state.list || [];
+    return '<section class="pn__list" aria-labelledby="pn-list-h"><h3 class="pn__list-h" id="pn-list-h">This page\'s reference docs</h3>' +
+      (rows.length ? '<ul class="pn__rows">' + rows.map(function (r) {
+        return '<li><button class="pn__row" type="button" data-pn-note="' + esc(r.id) + '">' +
+          '<span class="pn__row-meta">' + esc(r.author_name) + ' · ' + esc(day(r.submitted_at)) + ' · ' +
+            (r.status === 'filed' ? esc(plural(r.idea_count, 'idea', 'ideas')) : 'splitting…') + '</span>' +
+          '<span class="pn__row-text">' + esc(String(r.excerpt || '').replace(IMAGE_RE, '[image]').replace(/\s+/g, ' ').slice(0, 160)) + '</span>' +
+        '</button></li>';
+      }).join('') + '</ul>' : '<p class="pn__quiet">None yet. Yours will be the first.</p>') +
+    '</section>';
+  }
+  function ideasHtml(ideas) {
+    if (!ideas || !ideas.length) return '';
+    return '<ul class="pn__ideas">' + ideas.map(function (i) {
+      return '<li><a href="/#/idea/' + esc(i.id) + '">' + esc(i.title) + '</a></li>';
+    }).join('') + '</ul>';
+  }
+  function readHtml(doc) {
+    var n = doc.note;
+    var filed = n.status === 'filed';
+    return '<button class="pn__back" type="button" data-pn-back>← ' + (state && state.note ? 'Back to your doc' : 'This page\'s docs') + '</button>' +
+      '<p class="pn__row-meta">' + esc(n.author_name) + ' · ' + esc(day(n.submitted_at)) + ' · ' + esc(n.page_title || n.page_id) + '</p>' +
+      '<div class="pn-doc">' + renderBody(n.body_md) + '</div>' +
+      (filed
+        ? '<h3 class="pn__list-h">It became ' + esc(plural(doc.ideas.length, 'idea', 'ideas')) + '</h3>' + ideasHtml(doc.ideas)
+        : '<p class="pn__quiet">Being split into ideas…</p>');
+  }
+  function doneHtml(doc) {
+    return '<p class="pn__done">Filed as ' + esc(plural(doc.ideas.length, 'idea', 'ideas')) + ' under your name.</p>' +
+      ideasHtml(doc.ideas) +
+      '<p class="pn__hint">The doc is now this page\'s reference. Every idea links back to it.</p>' +
+      '<button class="pn__back" type="button" data-pn-new>Write another</button>';
+  }
+
+  function body() { return sheet && sheet.querySelector('#pn-body'); }
+  function setError(msg) { var e = sheet && sheet.querySelector('#pn-error'); if (e) e.textContent = msg || ''; }
+  function setSaved(msg) { var e = sheet && sheet.querySelector('#pn-saved'); if (e) e.textContent = msg || ''; }
+
+  function setTitle(text) { var h = sheet && sheet.querySelector('#pn-title'); if (h) h.textContent = text; }
+  function showWrite() {
+    var b = body();
+    if (!b) return;
+    setTitle('What should this page be?');
+    b.innerHTML = writeHtml();
+    var t = b.querySelector('#pn-text');
+    if (t) { t.addEventListener('input', queueSave); t.focus(); }
+    var f = b.querySelector('#pn-file');
+    if (f) f.addEventListener('change', function () { addImages(Array.prototype.slice.call(f.files || [])); f.value = ''; });
+  }
+  function currentText() { var t = sheet && sheet.querySelector('#pn-text'); return t ? t.value : (state && state.note ? state.note.body_md : ''); }
+  function queueSave() {
+    setSaved('');
+    if (saveTimer) clearTimeout(saveTimer);
+    saveTimer = setTimeout(save, 700);
+  }
+  function save() {
+    if (saveTimer) { clearTimeout(saveTimer); saveTimer = null; }
+    if (!state || !state.note || state.note.status !== 'draft') return Promise.resolve();
+    var text = currentText();
+    if (text === state.note.body_md) return Promise.resolve();
+    return api('PATCH', '/' + state.note.id, { body_md: text }).then(function () {
+      state.note.body_md = text;
+      setSaved('Saved');
+    }, function (e) { setError(e.message); });
+  }
+  function readFile(file) {
+    return new Promise(function (resolve, reject) {
+      var r = new FileReader();
+      r.onload = function () { resolve(String(r.result || '')); };
+      r.onerror = function () { reject(new Error('That file could not be read.')); };
+      r.readAsDataURL(file);
+    });
+  }
+  function addImages(files) {
+    setError('');
+    var chain = Promise.resolve();
+    files.forEach(function (file) {
+      chain = chain.then(function () {
+        if (TYPES.indexOf(file.type) === -1) throw new Error('Images only: PNG, JPG, GIF or WebP.');
+        if (file.size > MAX_IMAGE_BYTES) throw new Error('Each image can be up to 4 MB.');
+        if (state.images.length >= MAX_IMAGES) throw new Error('A doc can carry up to ' + MAX_IMAGES + ' images.');
+        return readFile(file).then(function (data) {
+          return api('POST', '/' + state.note.id + '/images', { content_type: file.type, data: data, name: String(file.name || '').slice(0, 120) });
+        }).then(function (j) {
+          state.images.push(j.image);
+          var name = String(j.image.name || 'image').replace(/[\]\[()]/g, '');
+          var t = sheet.querySelector('#pn-text');
+          var text = t ? t.value : '';
+          var at = t && typeof t.selectionStart === 'number' ? t.selectionStart : text.length;
+          var md = (at && text[at - 1] !== '\n' ? '\n' : '') + '![' + name + '](' + j.image.url + ')\n';
+          state.note.body_md = text;
+          var next = text.slice(0, at) + md + text.slice(at);
+          return api('PATCH', '/' + state.note.id, { body_md: next }).then(function () {
+            state.note.body_md = next;
+            showWrite();
+            setSaved('Saved');
+          });
+        });
+      });
+    });
+    chain.catch(function (e) { setError(e.message); });
+  }
+  function submit() {
+    setError('');
+    var btn = sheet.querySelector('[data-pn-submit]');
+    if (btn) btn.disabled = true;
+    save().then(function () {
+      return api('POST', '/' + state.note.id + '/submit');
+    }).then(function () {
+      var b = body();
+      if (b) b.innerHTML = '<p class="pn__done" aria-live="polite">Splitting your feedback into ideas…</p>';
+      poll(state.note.id, 0);
+    }, function (e) { if (btn) btn.disabled = false; setError(e.message); });
+  }
+  function poll(id, tries) {
+    pollTimer = setTimeout(function () {
+      api('GET', '/' + id).then(function (doc) {
+        if (!sheet) return;
+        if (doc.note.status === 'filed') { state.note = null; body().innerHTML = doneHtml(doc); refreshList(); return; }
+        if (tries < 60) poll(id, tries + 1);
+        else body().innerHTML = '<p class="pn__quiet">Still splitting. It will appear in this page\'s docs when it is done.</p>';
+      }, function () { if (tries < 60) poll(id, tries + 1); });
+    }, tries ? 2000 : 1200);
+  }
+  function refreshList() {
+    return api('GET', '?page_id=' + encodeURIComponent(page().id)).then(function (j) { if (state) state.list = j.notes || []; }, function () { /* the list is a convenience */ });
+  }
+  function openDraft() {
+    var p = page();
+    return Promise.all([
+      api('POST', '', { page_id: p.id, page_path: p.path, page_title: p.title }),
+      refreshList(),
+    ]).then(function (r) {
+      state.note = r[0].note;
+      state.images = r[0].images || [];
+      showWrite();
+    }, function (e) {
+      var b = body();
+      if (b) b.innerHTML = '<p class="pn__error" role="alert">' + esc(e.message) + '</p>';
+    });
+  }
+  function showNote(id) {
+    var b = body();
+    setTitle('Feedback on this page');
+    if (b) b.innerHTML = '<p class="pn__quiet">Opening the doc…</p>';
+    return save().then(function () { return api('GET', '/' + id); }).then(function (doc) {
+      if (b) { b.innerHTML = readHtml(doc); var back = b.querySelector('[data-pn-back]'); if (back) back.focus(); }
+    }, function (e) {
+      if (b) b.innerHTML = '<p class="pn__error" role="alert">' + esc(e.message) + '</p><button class="pn__back" type="button" data-pn-back>← Back</button>';
+    });
+  }
+
+  function onClick(e) {
+    if (e.target === sheet) { close(); return; }
+    var btn = e.target.closest && e.target.closest('button');
+    if (!btn) return;
+    if (btn.hasAttribute('data-pn-close')) close();
+    else if (btn.hasAttribute('data-pn-submit')) submit();
+    else if (btn.hasAttribute('data-pn-note')) showNote(btn.getAttribute('data-pn-note'));
+    else if (btn.hasAttribute('data-pn-back') || btn.hasAttribute('data-pn-new')) {
+      if (state.note && !btn.hasAttribute('data-pn-new')) showWrite();
+      else { body().innerHTML = '<p class="pn__quiet">Opening your doc…</p>'; openDraft(); }
+    }
+  }
+  function onKey(e) {
+    if (!sheet) return;
+    if (e.key === 'Escape') { e.preventDefault(); close(); return; }
+    if (e.key !== 'Tab') return;
+    var f = Array.prototype.slice.call(sheet.querySelectorAll('button, textarea, input, a[href]')).filter(function (x) { return !x.disabled; });
+    if (!f.length) return;
+    if (e.shiftKey && document.activeElement === f[0]) { e.preventDefault(); f[f.length - 1].focus(); }
+    else if (!e.shiftKey && document.activeElement === f[f.length - 1]) { e.preventDefault(); f[0].focus(); }
+  }
+  function mountSheet() {
+    if (sheet) return false;
+    returnFocus = document.activeElement;
+    state = { note: null, images: [], list: [] };
+    sheet = document.createElement('div');
+    sheet.className = 'pn';
+    sheet.id = 'page-notes';
+    sheet.innerHTML = shellHtml(page());
+    sheet.addEventListener('click', onClick);
+    document.addEventListener('keydown', onKey, true);
+    document.body.appendChild(sheet);
+    document.documentElement.classList.add('pn-open');
+    var c = sheet.querySelector('[data-pn-close]');
+    if (c) c.focus();
+    return true;
+  }
+  function close() {
+    if (!sheet) return;
+    save();
+    if (pollTimer) { clearTimeout(pollTimer); pollTimer = null; }
+    document.removeEventListener('keydown', onKey, true);
+    if (sheet.parentNode) sheet.parentNode.removeChild(sheet);
+    sheet = null;
+    document.documentElement.classList.remove('pn-open');
+    if (returnFocus && returnFocus.focus) { try { returnFocus.focus(); } catch (_) { /* gone */ } }
+    returnFocus = null;
+  }
+
+  window.OTBPageNotes = {
+    open: function () { if (mountSheet()) openDraft(); },
+    openNote: function (id) { if (mountSheet()) refreshList().then(function () { return showNote(id); }); },
+    close: close,
+    renderBody: renderBody,
+    page: page,
+  };
+})();

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

@@ -115,9 +115,9 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell-trail.js?v=2026-10-03-looks"></script>
-<script src="/builders/craft-mode.js?v=2026-10-03-looks"></script>
-<script src="/builders/shell.js?v=2026-10-03-looks"></script>
+<script src="/builders/shell-trail.js?v=2026-10-04-palette"></script>
+<script src="/builders/craft-mode.js?v=2026-10-04-palette"></script>
+<script src="/builders/shell.js?v=2026-10-04-palette"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- the shared markdown reader (window.OTBMdReader) — primer.js renders through

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

@@ -206,9 +206,9 @@
 
 <!-- The app shell (sidebar + top bar). Dependency-free; loaded FIRST so the
      chrome exists before the page script runs. -->
-<script src="/builders/shell-trail.js?v=2026-10-03-looks"></script>
-<script src="/builders/craft-mode.js?v=2026-10-03-looks"></script>
-<script src="/builders/shell.js?v=2026-10-03-looks"></script>
+<script src="/builders/shell-trail.js?v=2026-10-04-palette"></script>
+<script src="/builders/craft-mode.js?v=2026-10-04-palette"></script>
+<script src="/builders/shell.js?v=2026-10-04-palette"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- shared frontend toolkit (window.OTB) — loaded before profile.js, which pulls from it. -->

package/modules/hall-ui/public/project-settings.html

@@ -58,9 +58,9 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell-trail.js?v=2026-10-03-looks"></script>
-<script src="/builders/craft-mode.js?v=2026-10-03-looks"></script>
-<script src="/builders/shell.js?v=2026-10-03-looks"></script>
+<script src="/builders/shell-trail.js?v=2026-10-04-palette"></script>
+<script src="/builders/craft-mode.js?v=2026-10-04-palette"></script>
+<script src="/builders/shell.js?v=2026-10-04-palette"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-16-gate"></script>

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

@@ -77,9 +77,9 @@
 
 <!-- The app shell (sidebar + top bar). Dependency-free; loaded FIRST so the
      chrome exists before the page script runs. -->
-<script src="/builders/shell-trail.js?v=2026-10-03-looks"></script>
-<script src="/builders/craft-mode.js?v=2026-10-03-looks"></script>
-<script src="/builders/shell.js?v=2026-10-03-looks"></script>
+<script src="/builders/shell-trail.js?v=2026-10-04-palette"></script>
+<script src="/builders/craft-mode.js?v=2026-10-04-palette"></script>
+<script src="/builders/shell.js?v=2026-10-04-palette"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- shared frontend toolkit (window.OTB) — loaded before ranks.js, which pulls from it. -->

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

@@ -41,9 +41,9 @@
 
 <div id="toast" class="toast" role="status" aria-live="polite" data-visible="0"></div>
 
-<script src="/builders/shell-trail.js?v=2026-10-03-looks"></script>
-<script src="/builders/craft-mode.js?v=2026-10-03-looks"></script>
-<script src="/builders/shell.js?v=2026-10-03-looks"></script>
+<script src="/builders/shell-trail.js?v=2026-10-04-palette"></script>
+<script src="/builders/craft-mode.js?v=2026-10-04-palette"></script>
+<script src="/builders/shell.js?v=2026-10-04-palette"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <script src="/builders/dom-utils.js?v=2026-06-14-domutils"></script>

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

@@ -53,9 +53,9 @@
 
 <!-- The app shell (sidebar + top bar). Dependency-free; loaded FIRST so the
      chrome exists before the page script runs. -->
-<script src="/builders/shell-trail.js?v=2026-10-03-looks"></script>
-<script src="/builders/craft-mode.js?v=2026-10-03-looks"></script>
-<script src="/builders/shell.js?v=2026-10-03-looks"></script>
+<script src="/builders/shell-trail.js?v=2026-10-04-palette"></script>
+<script src="/builders/craft-mode.js?v=2026-10-04-palette"></script>
+<script src="/builders/shell.js?v=2026-10-04-palette"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- shared frontend toolkit (window.OTB — rank labels, number formats) + the

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

@@ -111,9 +111,9 @@
 
 <!-- The app shell (sidebar + top bar). Dependency-free; loaded FIRST so the
      chrome exists before the page script runs. -->
-<script src="/builders/shell-trail.js?v=2026-10-03-looks"></script>
-<script src="/builders/craft-mode.js?v=2026-10-03-looks"></script>
-<script src="/builders/shell.js?v=2026-10-03-looks"></script>
+<script src="/builders/shell-trail.js?v=2026-10-04-palette"></script>
+<script src="/builders/craft-mode.js?v=2026-10-04-palette"></script>
+<script src="/builders/shell.js?v=2026-10-04-palette"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- shared frontend toolkit (window.OTB) — loaded BEFORE sessions.js so it can pull from it. -->

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

@@ -435,9 +435,9 @@
 
 <!-- The app shell (sidebar + top bar). Dependency-free; loaded FIRST so the
      chrome exists before the page scripts run. -->
-<script src="/builders/shell-trail.js?v=2026-10-03-looks"></script>
-<script src="/builders/craft-mode.js?v=2026-10-03-looks"></script>
-<script src="/builders/shell.js?v=2026-10-03-looks"></script>
+<script src="/builders/shell-trail.js?v=2026-10-04-palette"></script>
+<script src="/builders/craft-mode.js?v=2026-10-04-palette"></script>
+<script src="/builders/shell.js?v=2026-10-04-palette"></script>
 <!-- jump palette (Ctrl/Cmd-K). Optional by design: without it the shell's slot stays hidden. -->
 <script src="/builders/palette.js" defer></script>
 <!-- shared frontend toolkit (window.OTB) — loaded before consuming IIFEs. -->

package/modules/hall-ui/public/street-card.css

@@ -22,6 +22,19 @@ body[data-page="street"] {
 
 .street-card__body { display: flex; flex-direction: column; gap: 11px; }
 
+/* sized to its words (task 1004568): no min-height anywhere, and every part
+   of the compact card is held to its lines. The model cuts at a word boundary
+   (street-card.js LINE); these are the net under that, so a wide run of glyphs
+   can never push a part onto another line and stretch the card. The kicker
+   gives way to "when" and the close. The title is cut to about two lines;
+   its clamp at three is only the net, for a run of wide glyphs. */
+.street-card__head .street-label { min-width: 0; overflow: hidden; white-space: nowrap; text-overflow: ellipsis; }
+.street-card__head #streetCardWhen { flex: none; }
+.street-card__title { overflow-wrap: anywhere; display: -webkit-box; -webkit-box-orient: vertical; -webkit-line-clamp: 3; line-clamp: 3; overflow: hidden; flex: none; }
+.mcard-fact { margin: 0; font-size: 14px; line-height: 1.4; color: var(--ink-soft); overflow: hidden; white-space: nowrap; text-overflow: ellipsis; }
+.street-card__lines li { overflow: hidden; white-space: nowrap; text-overflow: ellipsis; }
+.mcard-voice__words { overflow-wrap: anywhere; }
+
 .mcard-quote { margin: 0; font-size: 14px; line-height: 1.45; color: var(--ink-soft); }
 
 /* the wording change: struck, then inserted */

package/modules/hall-ui/public/street-card.js

@@ -101,10 +101,25 @@
     if (names.length <= 1) return names.join('');
     return names.slice(0, -1).join(', ') + ' and ' + names[names.length - 1];
   }
+  // a text as one run of words: every whitespace run is one space
+  function norm(s) { return str(s).replace(/\s+/g, ' ').trim(); }
   function clip(s, n) {
-    var t = str(s).replace(/\s+/g, ' ').trim();
+    var t = norm(s);
     return t.length > n ? t.slice(0, n - 1).replace(/\s+\S*$/, '') + '…' : t;
   }
+  // THE COMPACT CARD'S LINE RULE (task 1004568). The card is only as tall as
+  // its words need: every part of it has a cap, and anything longer is cut at
+  // a word boundary with an ellipsis (clip(): the desk's line rule, GovDesk.fit(),
+  // but never mid-word), with the whole text under "more". The caps are
+  // characters at the card's 390px width: the kicker, the fact and a listed
+  // line are one line; the title two; a voice's reason two; the proposer's
+  // words three.
+  var LINE = { where: 40, title: 64, fact: 44, line: 44, reason: 96, quote: 132 };
+  // the first line of a text, as words (a fact is one line of it)
+  function firstLine(s) {
+    var lines = str(s).split(/\r?\n/).map(function (l) { return l.replace(/^[#>*\-\s]+/, '').replace(/\s+/g, ' ').trim(); }).filter(Boolean);
+    return lines[0] || '';
+  }
   // the first paragraph of a markdown text, as words
   function firstPara(md) {
     var paras = str(md).split(/\r?\n\s*\r?\n/).map(function (p) { return p.replace(/^[#>*\-\s]+/gm, '').replace(/\s+/g, ' ').trim(); }).filter(Boolean);
@@ -273,7 +288,7 @@
     var votes = (item && item.votes) || [];
     var out = [];
     votes.filter(function (v) { return v.direction === 'no'; }).forEach(function (v) {
-      out.push({ side: 'against', by: firstName(personName(v)) + ' · objects to ' + sectionWords(v.section_key), words: str(v.reason_md) });
+      out.push({ side: 'against', by: firstName(personName(v)) + ' · objects to ' + sectionWords(v.section_key), words: norm(v.reason_md) });
     });
     var yes = votes.filter(function (v) { return v.direction === 'yes'; }).map(function (v) { return firstName(personName(v)); });
     if (yes.length && out.length) out.unshift({ side: 'for', by: 'for', words: list(yes) });
@@ -319,7 +334,7 @@
     var kind = subjectKind(item);
     var proposer = m.proposer ? firstName(m.proposer.name || m.proposer.login) : '';
     var words = proposerWords(item);
-    if (words) cv.quote = { by: proposer, words: clip(words, 200) };
+    if (words) cv.quote = { by: proposer, words: words };
     cv.change = changeOf(item, ctx.docket, ctx.constitution);
     cv.revision = revisionOf(item, ctx.room);
     var b = ballotOf(item, m, ctx.viewerId);
@@ -399,6 +414,9 @@
     var who = m.proposer ? str(m.proposer.name || m.proposer.login) : '';
     cv.subject = { kind: m.source, id: id, who: who, goalId: m.source === 'goal_join_requests' ? joinGoalId(m) : null };
     var mine = m.state === 'needs';
+    // its one fact (task 1004568): the first line of the matter's detail (the
+    // switch's reason, a blocker's body), cut by compact(); "more" has it whole
+    if (m.detail) cv.fact = firstLine(m.detail);
     if (m.source === 'access_requests') {
       if (who) cv.asked = who + ' asked to join as a builder' + (/vouched/.test(str(m.where)) ? ', and someone vouched for them.' : '.');
       if (!mine) { cv.readOnly = true; cv.result = 'Not yours to decide.'; return cv; }
@@ -470,7 +488,7 @@
       if (cv.revision) history.push('an earlier sitting sent it back to be revised');
       (item.votes || []).slice().sort(function (a, b) { return (Date.parse(a.cast_at) || 0) - (Date.parse(b.cast_at) || 0); }).forEach(function (v) {
         var by = personName(v) || 'someone';
-        var said = v.direction === 'yes' ? by + ' voted for' : by + ' objected to ' + sectionWords(v.section_key) + (v.reason_md ? ': ' + clip(str(v.reason_md).replace(/\s+/g, ' ').trim(), 160) : '');
+        var said = v.direction === 'yes' ? by + ' voted for' : by + ' objected to ' + sectionWords(v.section_key) + (v.reason_md ? ': ' + bound(str(v.reason_md).replace(/\s+/g, ' ').trim()) : '');
         history.push([dayOf(v.cast_at), said].filter(Boolean).join(' · '));
       });
     } else if (m) {
@@ -497,9 +515,9 @@
       key: short.key, building: short.building, where: short.where, when: short.when, title: short.title, href: short.href,
       source: null, quote: null, change: null, revision: null, seats: [], tally: '', voices: [], counsel: null,
       result: short.result, actions: [], textActions: [], reviseForm: null, readOnly: false, loading: false, lines: short.lines || [], subject: null,
-      more: null, row: null,
+      more: null, row: null, fact: '',
     };
-    if (short.key === 'queue') { cv.source = 'queue'; cv.readOnly = true; return cv; }
+    if (short.key === 'queue') { cv.source = 'queue'; cv.readOnly = true; return compact(cv); }
     var m = findMatter(c.docket, c.key);
     cv.source = m.source;
     var viewerId = c.viewerId != null ? c.viewerId : (c.docket && c.docket.viewer ? c.docket.viewer.id : null);
@@ -511,14 +529,47 @@
         cv.readOnly = true;
         cv.tally = short.tally;
         cv.result = c.room ? 'This sitting could not be read just now.' : 'Reading the sitting…';
-        return cv;
+        return compact(cv);
       }
       boardCard(cv, m, item, { docket: c.docket, room: c.room, constitution: c.constitution, viewerId: viewerId });
       cv.more = moreOf(cv, m, item);
-      return cv;
+      return compact(cv);
     }
     sourceCard(cv, m);
     cv.more = moreOf(cv, m, null);
+    return compact(cv);
+  }
+
+  // Every part of the compact card under the line rule (task 1004568): the
+  // kicker, the title, the fact, the proposer's words, the listed lines and a
+  // voice's reason. What
+  // was cut and is not already in "more" is added there whole, so nothing a
+  // cut hides is lost.
+  function compact(cv) {
+    var whole = [];
+    function cut(s, n) {
+      var t = norm(s);
+      var c = clip(t, n);
+      if (c !== t) whole.push(t);
+      return c;
+    }
+    cv.where = cut(cv.where, LINE.where);
+    cv.title = cut(cv.title, LINE.title);
+    cv.fact = cut(cv.fact, LINE.fact);
+    if (cv.quote && cv.quote.words) cv.quote = { by: cv.quote.by, words: cut(cv.quote.words, LINE.quote) };
+    cv.lines = (cv.lines || []).map(function (l) { return cut(l, LINE.line); });
+    cv.voices = (cv.voices || []).map(function (v) {
+      var w = cut(v.words, LINE.reason);
+      return w === v.words ? v : { side: v.side, by: v.by, words: w };
+    });
+    if (whole.length) {
+      var mo = cv.more || { text: [], who: '', when: '', history: [] };
+      var have = mo.text.map(function (x) { return x.words; }).concat(mo.history).join('\n');
+      // compared as "more" holds it: bound() may have shortened a long text there
+      var add = whole.filter(function (t) { return have.indexOf(bound(t).replace(/…$/, '')) < 0; }).map(function (t) { return { label: '', words: bound(t) }; });
+      mo.text = add.concat(mo.text);
+      cv.more = mo;
+    }
     return cv;
   }
 
@@ -807,6 +858,7 @@
   function render(doc, host, cv, on, ui) {
     var u = ui || {};
     while (host.firstChild) host.removeChild(host.firstChild);
+    if (cv.fact) host.appendChild(el(doc, 'p', 'mcard-fact', cv.fact));
     if (cv.quote && cv.quote.words) host.appendChild(el(doc, 'p', 'mcard-quote', (cv.quote.by ? cv.quote.by + ': ' : '') + cv.quote.words));
     if (cv.lines && cv.lines.length) {
       var ul = el(doc, 'ul', 'street-card__lines');
@@ -997,7 +1049,7 @@
   var api = {
     API: API, SECTIONS: SECTIONS, needsRoom: needsRoom, itemIdOf: itemIdOf, subjectKind: subjectKind,
     model: model, actsCard: actsCard, moreOf: moreOf, request: request, orderRequest: orderRequest, check: check, answer: answer, refusal: refusal, render: render,
-    memberWords: memberWords, windowWords: windowWords,
+    memberWords: memberWords, windowWords: windowWords, LINE: LINE, compact: compact,
     // the wording change, for a drafted amendment's struck and inserted text (task 1004530)
     change: changeOf,
   };