@bongos/core 1.21.12 → 1.21.14

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

@@ -0,0 +1,697 @@
+// modules/hall-ui/public/street-card.js — THE MATTER CARD THAT ACTS (task
+// 1004528, goal 1000125; R06 of the Governor City).
+//
+// WHAT THIS IS. The prototype's card() (docs/design/mocks/governor-city/
+// Street.dc.html) over the real docket: where · when, the title, the proposer in
+// their own words, the exact wording change (struck and inserted, plus the
+// revision when a returned sitting came back), the seats filling with the tally
+// and what it needs, the voices against (and who is for), a counsel note, a
+// result line and up to two actions, with the quiet text actions under them
+// (abstain, revise it this way and sit again). The street's pin opens it
+// (street.js); GovStreet.cardFor() (street-draw.js) still gives the short card's
+// where/when/title/href, and this file builds the rest.
+//
+// FOUR PARTS, all here so the street page loads one file for the card:
+//   model()    pure: the card for one matter, from the docket matter and, for a
+//              board sitting, the Board Room's own read (GET /government/board/
+//              items) and the constitution in force (GET /government/constitution).
+//   request()  pure: the act → the EXISTING route it calls, or null when the act
+//              records nothing (abstain, hold). Every request goes through that
+//              route's own permission checks; there is no other path.
+//   answer()   pure: what the street says and does after an act succeeds — the
+//              toast, which building rises or lights, whether the card closes.
+//   render()   DOM: the card's body as created nodes. No innerHTML: every docket
+//              and ballot string lands as text.
+//
+// WHERE THE REAL DATA BENDS THE DESIGN (said once here and in the ship notes):
+//  * Objection sections. The server keeps one closed vocabulary of sections an
+//    objection may name (board.js FULL_IDEA_SECTION_KEYS, a DB CHECK). A sitting
+//    that is not a Full Idea offers five of those keys in plain words ("what it
+//    changes", ...). A Full Idea is voted on in the Board Room, where its
+//    sections are in front of the voter (ADR 0175 §8) — the card links there.
+//  * Abstain. The ballot has yes and no and nothing else, so abstaining records
+//    nothing: the card says so and the matter still waits on you.
+//  * Counsel. There is no model behind it: the note is written from the sitting's
+//    own rule, tally and objections (what it needs, what an objection does under
+//    this rule, what would answer it), so it can never say something the ballot
+//    does not.
+//  * Revise and sit again. A returned sitting is re-filed through the route that
+//    filed it — an amendment with its revised words, a who-decides change with
+//    its rows, a building's matter with its revised detail. The constitution's own
+//    fields are changed in the Board Room's amendment form, not here.
+//  * Release. An override and a PR held at the gate are released from the card
+//    through their own decide routes. A newer CORE is not: moving the live pin
+//    runs its dry-run check first, on its own page, so the card's release goes
+//    there.
+
+(function (root) {
+  'use strict';
+
+  var API = '/api/bongos';
+
+  // The keys the server accepts for an objection, in plain words, for a sitting
+  // that has no sections of its own. Every key is in board.js
+  // FULL_IDEA_SECTION_KEYS (tests/hall_matter_card.mjs holds them inside it).
+  var SECTIONS = [
+    { key: 'scope', label: 'what it changes' },
+    { key: 'purpose', label: 'what it is for' },
+    { key: 'why_matters', label: 'why it matters' },
+    { key: 'fit', label: 'how it fits the rest' },
+    { key: 'success', label: 'how we will know it worked' },
+  ];
+  var SECTION_WORDS = {};
+  SECTIONS.forEach(function (s) { SECTION_WORDS[s.key] = s.label; });
+
+  var PASS_WORDS = {
+    first_ratifier: 'the first yes decides',
+    consent: 'passes unless someone objects',
+    majority: 'more than half must say yes',
+    unanimous: 'everyone has to agree',
+  };
+  var FIELD_WORDS = {
+    membership: 'who sits',
+    pass_rule: 'how it passes',
+    window_minutes: 'how long it sits',
+    close_early_on_full_turnout: 'closes once everyone has voted',
+  };
+  var RULE_WORDS = {
+    decide: 'decides alone', first: 'first yes wins', consent: 'passes unless someone objects',
+    majority: 'majority vote', unanimous: 'everyone agrees', signoff: 'signed off by someone who did not build it',
+    vacant: 'no one holds this yet', rule: 'settled by a rule',
+  };
+  var BUILDING_NAMES = {
+    charter: 'Charter', rules: 'Rules', disputes: 'Disputes', people: 'People', planning: 'Planning',
+    automation: 'Automation', review: 'Review', release: 'Release', treasury: 'Treasury',
+  };
+
+  // ---------- small words ----------
+  function str(v) { return v == null ? '' : String(v); }
+  function personName(p) { return p ? str(p.display_name || p.name || p.github_login || p.login) : ''; }
+  function firstName(n) { return str(n).split(/\s+/)[0] || ''; }
+  function initial(n) { var c = str(n).replace(/^[^A-Za-z0-9]+/, '').charAt(0); return c ? c.toUpperCase() : '?'; }
+  function list(names) {
+    if (names.length <= 1) return names.join('');
+    return names.slice(0, -1).join(', ') + ' and ' + names[names.length - 1];
+  }
+  function clip(s, n) {
+    var t = str(s).replace(/\s+/g, ' ').trim();
+    return t.length > n ? t.slice(0, n - 1).replace(/\s+\S*$/, '') + '…' : t;
+  }
+  // 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);
+    return paras[0] || '';
+  }
+  function memberWords(m) {
+    var s = str(m);
+    var one = /^rank:([a-z][a-z0-9-]*)$/.exec(s);
+    if (one) return 'the ' + one[1] + ' rank';
+    var up = /^rank:([a-z][a-z0-9-]*)\+$/.exec(s);
+    if (up) return up[1] + ' and above';
+    var many = /^rank:([a-z0-9,-]+)$/.exec(s);
+    if (many) return list(many[1].split(',').filter(Boolean));
+    if (s === 'gate') return 'as it is decided today';
+    if (s === 'nobody') return 'no one yet';
+    return s;
+  }
+  function windowWords(w) {
+    if (w == null) return 'no clock';
+    var n = Number(w);
+    if (!isFinite(n)) return str(w);
+    if (n % 1440 === 0) return n / 1440 + (n === 1440 ? ' day' : ' days');
+    if (n % 60 === 0) return n / 60 + (n === 60 ? ' hour' : ' hours');
+    return n + ' minutes';
+  }
+  function fieldValue(k, v) {
+    if (k === 'membership') return memberWords(v);
+    if (k === 'pass_rule') return PASS_WORDS[v] || str(v);
+    if (k === 'window_minutes') return windowWords(v);
+    if (typeof v === 'boolean') return v ? 'yes' : 'no';
+    if (v == null) return 'none';
+    return typeof v === 'object' ? JSON.stringify(v) : str(v);
+  }
+  function safeHref(h) { return typeof h === 'string' && h.charAt(0) === '/' && h.charAt(1) !== '/' ? h : null; }
+
+  function findMatter(docket, key) {
+    var ms = docket && Array.isArray(docket.matters) ? docket.matters : [];
+    for (var i = 0; i < ms.length; i++) if (ms[i] && String(ms[i].id) === String(key)) return ms[i];
+    return null;
+  }
+  function findItem(room, id) {
+    if (!room) return null;
+    var all = [].concat(room.open || [], room.closed || []);
+    for (var i = 0; i < all.length; i++) if (all[i] && String(all[i].id) === String(id)) return all[i];
+    return null;
+  }
+  // Which board item a docket matter is, or null when it is not a sitting.
+  function itemIdOf(m) {
+    if (!m || m.source !== 'board') return null;
+    if (m.ref && m.ref.type === 'board_item' && m.ref.id != null) return String(m.ref.id);
+    var hit = /^board:(.+)$/.exec(str(m.id));
+    return hit ? hit[1] : null;
+  }
+  function needsRoom(m) { return itemIdOf(m) != null; }
+
+  function areaOf(item) {
+    var t = str(item && item.subject_type);
+    var hit = /^([a-z]+)_matter$/.exec(t);
+    return hit ? hit[1] : null;
+  }
+  function subjectKind(item) {
+    if (!item) return null;
+    if (item.subject_type === 'full_idea') return 'idea';
+    if (item.subject_type === 'genesis_stage') return 'genesis';
+    if (areaOf(item)) return 'matter';
+    if (item.subject && item.subject.kind === 'decision_rules') return 'rules';
+    return 'amendment';
+  }
+  // The proposer's own words for a sitting.
+  function proposerWords(item) {
+    var s = item && item.subject;
+    if (!s) return '';
+    var k = subjectKind(item);
+    if (k === 'amendment' || k === 'rules') return firstPara(s.rationale_md);
+    if (k === 'matter') return firstPara(s.detail_md);
+    if (k === 'idea') {
+      var f = s.field_values || {};
+      return firstPara(f.purpose || f.why_had || f.scope || '');
+    }
+    return '';
+  }
+
+  // ---------- the wording change ----------
+  function decisionRow(docket, area) {
+    var bs = docket && Array.isArray(docket.buildings) ? docket.buildings : [];
+    for (var i = 0; i < bs.length; i++) if (bs[i] && bs[i].key === area) return bs[i].decision || null;
+    return null;
+  }
+  function changeOf(item, docket, constitution) {
+    var k = subjectKind(item);
+    var s = item && item.subject;
+    if (!s) return null;
+    if (k === 'rules') {
+      var rows = (s.proposed && Array.isArray(s.proposed.decision_rules) ? s.proposed.decision_rules : []).map(function (r) {
+        var today = decisionRow(docket, r.area);
+        return {
+          label: BUILDING_NAMES[r.area] || str(r.area),
+          struck: today ? [today.who, today.rule_words].filter(Boolean).join(', ') : '',
+          inserted: [r.who || memberWords(r.decided_by), r.rule ? RULE_WORDS[r.rule] || r.rule : (r.decided_by === 'gate' ? 'as today' : '')].filter(Boolean).join(', '),
+        };
+      });
+      return rows.length ? { rows: rows } : null;
+    }
+    if (k === 'amendment') {
+      var live = constitution && constitution.board ? constitution.board : null;
+      var p = s.proposed || {};
+      var out = [];
+      Object.keys(p).forEach(function (f) {
+        var was = live ? live[f] : undefined;
+        if (live && JSON.stringify(was) === JSON.stringify(p[f])) return;
+        out.push({ label: FIELD_WORDS[f] || f.replace(/_/g, ' '), struck: live ? fieldValue(f, was) : '', inserted: fieldValue(f, p[f]) });
+      });
+      return out.length ? { rows: out } : null;
+    }
+    return null;
+  }
+
+  // The sitting this one revises: the newest RETURNED sitting by the same author
+  // on the same subject, closed before this one opened. Its words are struck and
+  // this sitting's inserted, when they differ.
+  function revisionOf(item, room) {
+    if (!item || !room || !item.subject) return null;
+    var author = str(item.subject.author_id);
+    if (!author) return null;
+    var opened = Date.parse(item.opened_at) || 0;
+    var k = subjectKind(item), area = areaOf(item);
+    var prev = (room.closed || []).filter(function (c) {
+      return c && c.id !== item.id && c.outcome === 'returned' && c.subject && str(c.subject.author_id) === author
+        && subjectKind(c) === k && areaOf(c) === area && c.subject_type === item.subject_type
+        && (Date.parse(c.closed_at) || 0) <= (opened || Infinity);
+    }).sort(function (a, b) { return (Date.parse(b.closed_at) || 0) - (Date.parse(a.closed_at) || 0); })[0];
+    if (!prev) return null;
+    var was = proposerWords(prev), now = proposerWords(item);
+    if (!was || !now || was === now) return null;
+    return { struck: clip(was, 240), inserted: clip(now, 240) };
+  }
+
+  // ---------- the ballot ----------
+  function ballotOf(item, m, viewerId) {
+    var viewer = str(viewerId);
+    var votes = (item && item.votes) || [];
+    var t = (m && m.tally) || {};
+    var mine = null;
+    var seats = [];
+    votes.forEach(function (v) {
+      var name = personName(v);
+      var isYou = str(v.voter_id) === viewer;
+      if (isYou) mine = v;
+      seats.push({ key: isYou ? 'you' : 'v' + str(v.voter_id), init: isYou ? 'you' : initial(name), name: isYou ? 'you' : name, pos: v.direction === 'yes' ? 'for' : 'against' });
+    });
+    var open = Math.max(0, Number(t.open) || 0);
+    var isAuthor = !!(item && item.subject && str(item.subject.author_id) === viewer);
+    var youOpen = !mine && !item.closed_at && !item.expired && (m.state === 'needs' || (m.state === 'moving' && !isAuthor));
+    if (youOpen) { seats.push({ key: 'you', init: 'you', name: 'you', pos: 'you' }); open -= 1; }
+    for (var i = 0; i < Math.max(0, open) && seats.length < 9; i++) seats.push({ key: 'o' + i, init: '', name: 'an open seat', pos: 'open' });
+    var forN = votes.filter(function (v) { return v.direction === 'yes'; }).length;
+    var againstN = votes.length - forN;
+    var tally = forN + ' for · ' + againstN + ' against' + (t.needs ? ' · ' + t.needs : '');
+    return { seats: seats, tally: tally, mine: mine, isAuthor: isAuthor, youOpen: youOpen, forN: forN, againstN: againstN, members: votes.length + Math.max(0, Number(t.open) || 0) };
+  }
+
+  function sectionWords(k) { return SECTION_WORDS[k] || str(k).replace(/_/g, ' ') || 'it'; }
+
+  function voicesOf(item) {
+    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) });
+    });
+    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) });
+    return out;
+  }
+
+  // Counsel, written from the rule, the tally and the objections.
+  function counselOf(item, b, rule, proposer) {
+    var votes = (item && item.votes) || [];
+    var no = votes.filter(function (v) { return v.direction === 'no'; })[0];
+    var noBy = no ? firstName(personName(no)) : '';
+    var noAt = no ? sectionWords(no.section_key) : '';
+    var kind = subjectKind(item);
+    if (item.closed_at) {
+      if (item.outcome === 'returned' && b.isAuthor && kind !== 'idea' && kind !== 'genesis') {
+        return { words: no
+          ? noBy + ' objected to ' + noAt + ': “' + clip(no.reason_md, 160) + '” Answer that in the wording, and the sitting can carry.'
+          : 'It did not carry. Change the wording so it can, and put it to the sitting again.', revise: true };
+      }
+      return null;
+    }
+    if (no && rule === 'majority') return { words: noBy + ' objects to ' + noAt + '. Under a majority an objection is on the record but does not stop it: more than half of the seats must still say yes.', revise: false };
+    if (!b.youOpen || kind === 'idea') return null;
+    if (rule === 'unanimous') return { words: 'Everyone who votes has to agree, so one objection sends it back to ' + (proposer || 'its author') + ' to revise. If you object, say what would answer it.', revise: false };
+    if (rule === 'majority') {
+      var need = Math.floor(b.members / 2) + 1;
+      var left = Math.max(0, need - b.forN);
+      return { words: 'More than half of the ' + b.members + ' seats must say yes. It has ' + b.forN + (left ? '; ' + left + ' more ' + (left === 1 ? 'yes carries' : 'carry') + ' it.' : '.'), revise: false };
+    }
+    if (rule === 'consent') return { words: 'It passes unless someone objects. Saying nothing is saying yes; an objection sends it back to ' + (proposer || 'its author') + '.', revise: false };
+    if (rule === 'first') return { words: 'The first yes decides it.', revise: false };
+    return null;
+  }
+
+  function act(key, label, tone, extra) {
+    var a = { key: key, label: label, tone: tone };
+    if (extra) Object.keys(extra).forEach(function (k) { a[k] = extra[k]; });
+    return a;
+  }
+
+  // ---------- the card for a board sitting ----------
+  function boardCard(cv, m, item, ctx) {
+    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) };
+    cv.change = changeOf(item, ctx.docket, ctx.constitution);
+    cv.revision = revisionOf(item, ctx.room);
+    var b = ballotOf(item, m, ctx.viewerId);
+    cv.seats = b.seats;
+    cv.tally = b.tally;
+    cv.voices = voicesOf(item);
+    var rule = m.rule || null;
+    cv.counsel = counselOf(item, b, rule, proposer);
+    cv.subject = { kind: kind, itemId: String(item.id), area: areaOf(item), title: item.subject ? str(item.subject.title) : '', proposed: item.subject ? item.subject.proposed || null : null, action: item.subject ? item.subject.action || null : null, words: words };
+
+    if (item.closed_at) {
+      cv.readOnly = true;
+      if (item.outcome === 'passed') cv.result = 'Passed ' + b.forN + '–' + b.againstN + '. In force from ' + str(item.closed_at).slice(0, 10) + '.';
+      else if (b.isAuthor && cv.counsel && cv.counsel.revise) { cv.result = 'It came back to you.'; cv.readOnly = false; cv.reviseForm = { text: words, label: kind === 'matter' ? 'the matter, in your words' : 'why, in your words' }; }
+      else cv.result = 'It went back to ' + (proposer || 'its author') + ' to revise.';
+      return cv;
+    }
+    if (item.expired) { cv.readOnly = true; cv.result = 'Its time is up. It closes on the next sweep.'; return cv; }
+    if (b.mine) {
+      cv.readOnly = true;
+      if (b.mine.direction === 'yes') {
+        var tail = '';
+        if (rule === 'majority') { var left = Math.max(0, Math.floor(b.members / 2) + 1 - b.forN); tail = left ? ' It needs ' + left + ' more yes.' : ' It has its majority.'; }
+        else if (rule === 'unanimous') tail = ' It passes unless someone objects before it closes.';
+        else if (rule === 'consent') tail = ' It passes unless someone objects.';
+        cv.result = 'You voted for.' + tail;
+      } else cv.result = 'You objected to ' + sectionWords(b.mine.section_key) + '. It is on the record.';
+      return cv;
+    }
+    if (kind === 'idea') {
+      cv.readOnly = true;
+      cv.result = m.state === 'needs' ? 'Read the idea in the Board Room and vote there, with its sections in front of you.' : 'Not yours to vote on.';
+      return cv;
+    }
+    if (b.youOpen) {
+      cv.actions = [act('for', 'vote for', 'primary'), act('object', 'object', 'quiet')];
+      cv.textActions = [act('abstain', 'abstain', 'text')];
+      cv.objectForm = { sections: SECTIONS.slice() };
+      cv.result = '';
+      return cv;
+    }
+    cv.readOnly = true;
+    cv.result = b.isAuthor ? 'Yours. It is with the sitting now.' : 'Not yours to vote on. You will see how it ends.';
+    return cv;
+  }
+
+  // ---------- the card for every other source ----------
+  var READ_ONLY_WORDS = {
+    criteria_uat: 'Someone who did not build it tries it and signs it off.',
+    blockers: 'It holds work until someone decides. It is decided where it lives.',
+    removal_proposals: 'A proposal to take work out of a goal. It is decided where it lives.',
+    redteam_reports: 'A report on the project\'s own walls. It is judged where it lives.',
+    autobongos_fence: 'Whether work is built while no one is watching. It is switched where it lives.',
+    module_rechecks: 'A module waits for its re-check. It is decided where it lives.',
+  };
+  function joinGoalId(m) { var hit = /goal\/(\d+)/.exec(str(m.href)); return hit ? hit[1] : null; }
+
+  function sourceCard(cv, m) {
+    var id = m.ref && m.ref.id != null ? String(m.ref.id) : str(m.id).replace(/^[^:]*:/, '');
+    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';
+    if (m.source === 'access_requests') {
+      if (who) cv.quote = { by: '', words: 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; }
+      cv.result = 'The call is yours. Fine by you lets them in; an objection keeps them out.';
+      cv.actions = [act('fine', 'fine by me', 'primary'), act('refuse', 'object', 'quiet')];
+      return cv;
+    }
+    if (m.source === 'goal_join_requests') {
+      if (who) cv.quote = { by: '', words: who + ' asked to join this goal\'s team.' };
+      if (!mine || !cv.subject.goalId) { cv.readOnly = true; cv.result = mine ? 'Decide it on the goal\'s page.' : 'You asked. The goal\'s owner decides.'; return cv; }
+      cv.result = 'The goal\'s team is yours to keep. Fine by you lets them in.';
+      cv.actions = [act('fine', 'fine by me', 'primary'), act('refuse', 'object', 'quiet')];
+      return cv;
+    }
+    if (m.source === 'override_requests' || m.source === 'gate_approvals') {
+      if (who) cv.quote = { by: '', words: 'Raised by ' + who + '.' };
+      if (!mine) { cv.readOnly = true; cv.result = 'Someone who may decide it will.'; return cv; }
+      cv.result = m.source === 'gate_approvals'
+        ? 'It is held at the gate. Releasing it lets it merge and go live. The call is yours.'
+        : 'It failed a check or a grade. Releasing it lets it go live anyway. The call is yours.';
+      cv.actions = [act('release', 'release', 'primary'), act('hold', 'hold', 'quiet')];
+      return cv;
+    }
+    if (m.source === 'core_update') {
+      if (!mine) { cv.readOnly = true; cv.result = 'Someone who may move the core will.'; return cv; }
+      cv.result = 'A newer core is out. Taking it moves the live pin, so it runs its check first, where the pin is moved.';
+      cv.actions = [act('release', 'release, with its check', 'primary', { go: safeHref(m.href) || '/settings#software-update' }), act('hold', 'hold', 'quiet')];
+      return cv;
+    }
+    cv.readOnly = true;
+    cv.result = READ_ONLY_WORDS[m.source] || (mine ? 'This waits on you, where it lives.' : 'This is moving without you.');
+    return cv;
+  }
+
+  // The whole card for one matter. ctx: { docket, key, room, constitution, viewerId, now }.
+  // null for an unknown key. A board sitting the room has not been read for yet
+  // is the short card with `loading: true`.
+  function model(ctx) {
+    var c = ctx || {};
+    var Street = root.GovStreet;
+    var short = Street && Street.cardFor ? Street.cardFor(c.docket, c.key, c.now || 0) : null;
+    if (!short) return null;
+    var cv = {
+      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: [], objectForm: null, reviseForm: null, readOnly: false, loading: false, lines: short.lines || [], subject: null,
+    };
+    if (short.key === 'queue') { cv.source = 'queue'; cv.readOnly = true; return 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);
+    var itemId = itemIdOf(m);
+    if (itemId != null) {
+      var item = findItem(c.room, itemId);
+      if (!item) {
+        cv.loading = !c.room;
+        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 boardCard(cv, m, item, { docket: c.docket, room: c.room, constitution: c.constitution, viewerId: viewerId });
+    }
+    return sourceCard(cv, m);
+  }
+
+  // ---------- act → route ----------
+  function post(url, body) { return { method: 'POST', url: API + url, body: body || {} }; }
+  // input: { reason, section } for object; { text } for revise.
+  function request(cv, key, input) {
+    if (!cv || !cv.subject) return null;
+    var s = cv.subject, inp = input || {};
+    var enc = encodeURIComponent;
+    if (s.itemId != null) {
+      if (key === 'for') return post('/government/board/items/' + enc(s.itemId) + '/votes', { direction: 'yes' });
+      if (key === 'object') return post('/government/board/items/' + enc(s.itemId) + '/votes', { direction: 'no', reason_md: str(inp.reason).trim(), section_key: str(inp.section) });
+      if (key === 'revise') {
+        var text = str(inp.text).trim();
+        if (s.kind === 'amendment') return post('/government/board/items', { subject_type: 'constitutional_amendment', proposal: s.proposed, rationale_md: text });
+        if (s.kind === 'rules') return post('/government/board/decision-rules', { rules: (s.proposed && s.proposed.decision_rules) || [], rationale_md: text });
+        if (s.kind === 'matter') {
+          var body = { area: s.area, title: s.title || cv.title, detail_md: text };
+          if (s.action) body.action = s.action;
+          return post('/government/board/matters', body);
+        }
+      }
+      return null; // abstain records nothing
+    }
+    if (s.kind === 'access_requests') {
+      if (key === 'fine') return { method: 'PATCH', url: API + '/access-requests/' + enc(s.id), body: { status: 'invited' } };
+      if (key === 'refuse') return { method: 'PATCH', url: API + '/access-requests/' + enc(s.id), body: { status: 'dismissed' } };
+    }
+    if (s.kind === 'goal_join_requests' && s.goalId) {
+      if (key === 'fine') return post('/goals/' + enc(s.goalId) + '/requests/' + enc(s.id) + '/respond', { action: 'approve' });
+      if (key === 'refuse') return post('/goals/' + enc(s.goalId) + '/requests/' + enc(s.id) + '/respond', { action: 'deny' });
+    }
+    if (s.kind === 'override_requests' && key === 'release') return post('/override-requests/' + enc(s.id) + '/decide', { decision: 'approve' });
+    if (s.kind === 'gate_approvals' && key === 'release') return post('/gate-approvals/' + enc(s.id) + '/approve', {});
+    return null; // hold, abstain and the core's release (a link) record nothing here
+  }
+
+  // Before a request: the refusal the server would give, said first.
+  function check(cv, key, input) {
+    var inp = input || {};
+    if (key === 'object' && cv && cv.subject && cv.subject.itemId != null) {
+      if (!str(inp.reason).trim()) return 'Say why. The reason goes on the record for the author to answer.';
+      if (!SECTION_WORDS[inp.section]) return 'Pick the part you object to.';
+    }
+    if (key === 'revise' && !str(inp.text).trim()) return 'Write the revised words first.';
+    return null;
+  }
+
+  // ---------- what the street does after an act ----------
+  // kind: 'rise' (something passed or went live), 'light' (a vote or a revision
+  // is in), 'settle' (it went back, or was turned away). close: the card closes.
+  function answer(cv, key, res) {
+    var r = res || {};
+    var who = cv && cv.subject && cv.subject.who ? cv.subject.who : 'They';
+    var b = cv ? cv.building : null;
+    if (key === 'for') {
+      if (r.item_closed && r.outcome === 'passed') return { toast: 'Passed. It is in force from today.', building: b, kind: 'rise', close: false };
+      if (r.item_closed) return { toast: 'The sitting closed: it went back to its author.', building: b, kind: 'settle', close: false };
+      return { toast: r.already_voted ? 'Your vote was already on the record.' : 'Your yes is on the record.', building: b, kind: 'light', close: false };
+    }
+    if (key === 'object') return { toast: r.item_closed ? 'Your objection is on the record. It goes back to its author to revise.' : 'Your objection is on the record.', building: b, kind: 'settle', close: false };
+    if (key === 'abstain') return { toast: 'Noted. Nothing goes on the record, and it still waits for your vote until it closes.', building: null, kind: null, close: true };
+    if (key === 'revise') return { toast: 'Revised. It sits again on the new wording.', building: b, kind: 'light', close: true };
+    if (key === 'hold') return { toast: 'Held. It waits for you.', building: null, kind: null, close: true };
+    if (key === 'release') return { toast: cv && cv.source === 'gate_approvals' ? 'Released from the gate. It merges and goes live.' : 'Released. It goes live.', building: b, kind: 'rise', close: true };
+    if (key === 'fine') return { toast: cv && cv.source === 'goal_join_requests' ? 'Noted. ' + who + ' joins the team.' : 'Noted. ' + who + ' is invited in.', building: b, kind: 'rise', close: false };
+    if (key === 'refuse') return { toast: 'Noted. ' + who + ' is not let in.', building: b, kind: 'settle', close: false };
+    return { toast: '', building: null, kind: null, close: false };
+  }
+
+  // A refused act, in words. The server's own message wins when it has one.
+  var REFUSALS = {
+    not_board_member: 'Only the members of this sitting may vote on it.',
+    item_closed: 'This sitting has closed.',
+    vote_window_expired: 'Its time ran out before your vote.',
+    objection_needs_reason: 'An objection must say why.',
+    objection_needs_section: 'An objection must name the part it objects to.',
+    request_not_open: 'Someone already decided this.',
+    not_pending: 'Someone already decided this.',
+    override_owner_only: 'Releasing this is the project owner\'s call alone.',
+    publish_unconfigured: 'The server cannot reach GitHub to release it.',
+    proposer_would_lose_their_seat: 'Re-filing this would take your own seat. Change it in the Board Room.',
+    no_change: 'That already is how it works.',
+    preview_readonly: 'This preview records nothing.',
+  };
+  function refusal(status, body) {
+    var e = body && body.error ? body.error : {};
+    var code = e.code || (body && body.code) || '';
+    if (REFUSALS[code]) return REFUSALS[code];
+    if (status === 403) return 'That is not yours to do.';
+    return e.message && e.message !== code ? String(e.message) : 'It could not be done just now.';
+  }
+
+  // ---------- the DOM ----------
+  function el(doc, tag, cls, text) {
+    var n = doc.createElement(tag);
+    if (cls) n.className = cls;
+    if (text != null) n.textContent = String(text);
+    return n;
+  }
+  function label(doc, text) { return el(doc, 'span', 'street-label', text); }
+  function button(doc, cls, text, key, onClick, busy) {
+    var b = el(doc, 'button', cls, text);
+    b.setAttribute('type', 'button');
+    b.setAttribute('data-act', key);
+    if (busy) b.setAttribute('disabled', '');
+    b.addEventListener('click', onClick);
+    return b;
+  }
+
+  // Build the card's body into `host` (emptied first). on: { act(key, input), openForm(name) }.
+  // ui: { form: 'object'|'revise'|null, error: '', busy: false, fresh: seatKey|null }.
+  function render(doc, host, cv, on, ui) {
+    var u = ui || {};
+    while (host.firstChild) host.removeChild(host.firstChild);
+    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');
+      cv.lines.forEach(function (t) { ul.appendChild(el(doc, 'li', '', t)); });
+      host.appendChild(ul);
+    }
+    if (cv.change && cv.change.rows.length) {
+      var ch = el(doc, 'div', 'mcard-change');
+      ch.appendChild(label(doc, 'the change'));
+      cv.change.rows.forEach(function (r) {
+        var row = el(doc, 'p', 'mcard-change__row');
+        row.appendChild(el(doc, 'span', 'mcard-change__label', r.label));
+        if (r.struck) row.appendChild(el(doc, 'del', 'mcard-del', r.struck));
+        row.appendChild(el(doc, 'ins', 'mcard-ins', r.inserted));
+        ch.appendChild(row);
+      });
+      host.appendChild(ch);
+    }
+    if (cv.revision) {
+      var rv = el(doc, 'div', 'mcard-change');
+      rv.appendChild(label(doc, 'revised'));
+      var rr = el(doc, 'p', 'mcard-change__row');
+      rr.appendChild(el(doc, 'del', 'mcard-del', cv.revision.struck));
+      rr.appendChild(el(doc, 'ins', 'mcard-ins', cv.revision.inserted));
+      rv.appendChild(rr);
+      host.appendChild(rv);
+    }
+    if (cv.seats.length || cv.tally) {
+      var sw = el(doc, 'div', 'mcard-seats');
+      var seats = el(doc, 'div', 'mcard-seats__row');
+      seats.setAttribute('role', 'list');
+      seats.setAttribute('aria-label', 'The seats');
+      cv.seats.forEach(function (s) {
+        var chip = el(doc, 'span', 'mcard-seat mcard-seat--' + s.pos + (u.fresh && u.fresh === s.key ? ' mcard-seat--fresh' : ''), s.init);
+        chip.setAttribute('role', 'listitem');
+        var said = s.pos === 'for' ? ', for' : s.pos === 'against' ? ', against' : s.pos === 'you' ? ', waiting for your vote' : '';
+        chip.setAttribute('title', s.name + said);
+        chip.setAttribute('aria-label', s.name + said);
+        seats.appendChild(chip);
+      });
+      sw.appendChild(seats);
+      if (cv.tally) sw.appendChild(el(doc, 'span', 'mcard-tally', cv.tally));
+      host.appendChild(sw);
+    }
+    cv.voices.forEach(function (v) {
+      var vo = el(doc, 'div', 'mcard-voice mcard-voice--' + v.side);
+      vo.appendChild(el(doc, 'span', 'mcard-voice__by', v.by));
+      vo.appendChild(el(doc, 'span', 'mcard-voice__words', v.words));
+      host.appendChild(vo);
+    });
+    if (cv.counsel) {
+      var co = el(doc, 'div', 'mcard-counsel');
+      co.appendChild(label(doc, 'counsel'));
+      co.appendChild(el(doc, 'span', 'mcard-counsel__words', cv.counsel.words));
+      if (cv.counsel.revise && cv.reviseForm && u.form !== 'revise') {
+        co.appendChild(button(doc, 'mcard-textbtn mcard-textbtn--accent', 'revise it this way and sit again', 'revise-open', function () { on.openForm('revise'); }, false));
+      }
+      host.appendChild(co);
+    }
+    if (cv.result) host.appendChild(el(doc, 'p', 'street-card__result', cv.result));
+    if (u.form === 'object' && cv.objectForm) host.appendChild(objectForm(doc, cv, on, u));
+    else if (u.form === 'revise' && cv.reviseForm) host.appendChild(reviseForm(doc, cv, on, u));
+    else {
+      if (cv.actions.length) {
+        var row = el(doc, 'div', 'mcard-actions');
+        cv.actions.forEach(function (a) {
+          var btn;
+          if (a.go) { btn = el(doc, 'a', 'mcard-btn mcard-btn--' + a.tone, a.label); btn.setAttribute('href', a.go); btn.setAttribute('data-act', a.key); }
+          else btn = button(doc, 'mcard-btn mcard-btn--' + a.tone, a.label, a.key, function () { if (a.key === 'object') on.openForm('object'); else on.act(a.key, {}); }, u.busy);
+          row.appendChild(btn);
+        });
+        host.appendChild(row);
+      }
+      if (cv.textActions.length) {
+        var tr = el(doc, 'div', 'mcard-actions mcard-actions--text');
+        cv.textActions.forEach(function (a) { tr.appendChild(button(doc, 'mcard-textbtn', a.label, a.key, function () { on.act(a.key, {}); }, u.busy)); });
+        host.appendChild(tr);
+      }
+    }
+    if (u.error) {
+      var er = el(doc, 'p', 'mcard-error', u.error);
+      er.setAttribute('role', 'alert');
+      host.appendChild(er);
+    }
+    return host;
+  }
+
+  function formShell(doc, name, labelText, field, fieldId) {
+    var f = el(doc, 'div', 'mcard-form');
+    f.setAttribute('data-form', name);
+    var lab = el(doc, 'label', 'mcard-form__label', labelText);
+    lab.setAttribute('for', fieldId);
+    f.appendChild(lab);
+    f.appendChild(field);
+    return f;
+  }
+  function textArea(doc, id, rows, value) {
+    var ta = el(doc, 'textarea', 'mcard-form__text');
+    ta.setAttribute('id', id);
+    ta.setAttribute('rows', String(rows));
+    ta.setAttribute('maxlength', '5000');
+    if (value) ta.value = value;
+    return ta;
+  }
+
+  function objectForm(doc, cv, on, u) {
+    var ta = textArea(doc, 'mcardReason', 3, '');
+    var f = formShell(doc, 'object', 'why you object (it goes on the record)', ta, 'mcardReason');
+    var sel = el(doc, 'select', 'mcard-form__select');
+    sel.setAttribute('id', 'mcardSection');
+    var none = el(doc, 'option', '', 'pick one');
+    none.setAttribute('value', '');
+    sel.appendChild(none);
+    cv.objectForm.sections.forEach(function (s) { var o = el(doc, 'option', '', s.label); o.setAttribute('value', s.key); sel.appendChild(o); });
+    var sl = el(doc, 'label', 'mcard-form__label', 'the part you object to');
+    sl.setAttribute('for', 'mcardSection');
+    f.appendChild(sl);
+    f.appendChild(sel);
+    var row = el(doc, 'div', 'mcard-actions');
+    row.appendChild(button(doc, 'mcard-btn mcard-btn--danger', 'put it on the record', 'object-send', function () { on.act('object', { reason: ta.value, section: sel.value }); }, u.busy));
+    row.appendChild(button(doc, 'mcard-btn mcard-btn--quiet', 'not now', 'form-close', function () { on.openForm(null); }, false));
+    f.appendChild(row);
+    return f;
+  }
+
+  function reviseForm(doc, cv, on, u) {
+    var ta = textArea(doc, 'mcardRevise', 4, cv.reviseForm.text || '');
+    var f = formShell(doc, 'revise', cv.reviseForm.label, ta, 'mcardRevise');
+    var row = el(doc, 'div', 'mcard-actions');
+    row.appendChild(button(doc, 'mcard-btn mcard-btn--primary', 'sit again', 'revise', function () { on.act('revise', { text: ta.value }); }, u.busy));
+    row.appendChild(button(doc, 'mcard-btn mcard-btn--quiet', 'not now', 'form-close', function () { on.openForm(null); }, false));
+    f.appendChild(row);
+    return f;
+  }
+
+  var api = {
+    API: API, SECTIONS: SECTIONS, needsRoom: needsRoom, itemIdOf: itemIdOf, subjectKind: subjectKind,
+    model: model, request: request, check: check, answer: answer, refusal: refusal, render: render,
+    memberWords: memberWords, windowWords: windowWords,
+  };
+  root.GovMatterCard = api;
+  if (typeof module !== 'undefined' && module.exports) module.exports = api;
+}(typeof window !== 'undefined' ? window : globalThis));