@bongos/core 1.24.20 → 1.24.22

package/modules/autonomy/governor-docket.js

@@ -58,6 +58,9 @@ function fenceDocketMatters(project, mayManage) {
     tally: null,
     href: '/watch',
     ref: { type: 'autonomy_fence', id: 'project' },
+    context: project.enabled === false
+      ? 'Unattended building lets AI runners claim and build tasks on their own, with nobody at the keyboard. It is switched off, so no runner builds anything until someone turns it on.'
+      : 'Unattended building lets AI runners claim and build tasks on their own. It is on, but no goal is on its allowed list, so the runners have nothing they may work on yet.',
     ...(detail ? { detail } : {}),
     // The floor desk's acts (task 1004559), only for the switch's own atom.
     ...(mayManage ? { acts: project.enabled === false ? [{ key: 'switch_on' }] : [{ key: 'allow', pick: 'open_goals', except: [] }, { key: 'switch_off', options: OFF_REASONS }] } : {}),

package/modules/government/docket.js

@@ -165,12 +165,44 @@ function tally(t) {
   };
 }
 
+// WHAT A CARD IS ABOUT (task 1005013). A matter may carry `context`: a few plain
+// sentences from the module that owns it saying what kind of thing this is, what
+// it belongs to (a goal, a task, a module, by name), why it waits and what
+// answering does — so a card is never only a bare title. A matter that brings
+// none gets its source's sentence below; every source the design names has one.
+// It may also carry `question`: the plain question a card asks when no agent
+// stored an ask, in place of the raw title.
+const SOURCE_CONTEXT = Object.freeze({
+  board: 'A sitting of the board. Its members vote, and the result is decided by the rule in the charter.',
+  blockers: 'A blocker: work that cannot go on until a person decides something. Deciding it releases the work that waits on it.',
+  access_requests: 'Someone asked to join this project as a builder. Admitting them lets them sign in and claim work; nobody joins until someone with the right says yes.',
+  goal_join_requests: 'Someone asked to join a goal team. Members of a goal may claim its tasks.',
+  override_requests: 'A request to let finished work through although it failed its automatic check or grade. Approving it treats the work as passed.',
+  removal_proposals: 'A later change deleted work that had already shipped. A person confirms whether that work is really gone, or keeps it counted.',
+  redteam_reports: 'A security report: someone says they found a flaw in the project itself. Confirming it means the flaw is real and needs a fix; disputing it means it is not.',
+  criteria_uat: 'A done-when promise of a goal. The work for it has shipped; a person checks it on the live site and signs it off, which closes the promise.',
+  core_update: 'A newer version of Bongos, the software this project runs on, is available. Taking it updates the project to that version.',
+  autobongos_fence: 'The switch for unattended building: whether AI runners may build on their own, and which goals they may work on.',
+  module_rechecks: 'A module (an add-on to the project) is being checked again for safety. One that failed waits for someone to run the check again.',
+  treasury_spending: 'A goal has used up its money for the month and asks to borrow from the reserve so its work can go on.',
+});
+const MAX_CONTEXT = 600;
+const MAX_QUESTION = 160;
+function clip(v, max) {
+  if (typeof v !== 'string') return null;
+  const t = v.replace(/\s+/g, ' ').trim();
+  if (!t) return null;
+  return t.length <= max ? t : t.slice(0, max - 1).replace(/\s+\S*$/, '') + '…';
+}
+
 // One matter as a contributor handed it → the docket's one shape. Pure. Unknown
 // rule → null (the card says so), unknown state → 'moving' (never a false
 // "needs you"), unknown building → the source's own building.
 function normalizeMatter(raw, { source, building }) {
   if (!raw || typeof raw !== 'object' || raw.id == null || !raw.title) return null;
   const b = vocab.BUILDING_KEYS.includes(raw.building) ? raw.building : building;
+  const context = clip(raw.context, MAX_CONTEXT) || SOURCE_CONTEXT[source] || null;
+  const question = clip(raw.question, MAX_QUESTION);
   return {
     id: `${source}:${raw.id}`,
     source,
@@ -186,6 +218,8 @@ function normalizeMatter(raw, { source, building }) {
     tally: tally(raw.tally),
     href: raw.href ? String(raw.href) : null,
     ref: raw.ref && typeof raw.ref === 'object' ? { type: String(raw.ref.type), id: String(raw.ref.id) } : null,
+    ...(context ? { context } : {}),
+    ...(question ? { question } : {}),
     ...actsField(raw.acts),
     ...detailField(raw.detail),
   };
@@ -364,6 +398,13 @@ const PASS_RULE_NEEDS = Object.freeze({
   majority: 'needs more than half',
   unanimous: 'needs everyone who votes',
 });
+// the same rule as the last sentence of a sitting's context (task 1005013)
+const PASS_RULE_SENTENCE = Object.freeze({
+  first_ratifier: 'One yes decides it.',
+  consent: 'It passes unless someone objects.',
+  majority: 'It needs a yes from more than half the members.',
+  unanimous: 'It needs a yes from everyone who votes.',
+});
 
 // One open or recently closed sitting, for one viewer. Pure.
 //
@@ -402,6 +443,14 @@ function boardMatter(item, { viewerId, members }) {
     : item.subject_type === 'constitutional_amendment' ? 'charter · amendment'
     : item.subject_type === 'genesis_stage' ? 'charter · founding'
       : 'planning · idea to ratify';
+  const passWords = PASS_RULE_SENTENCE[constitution.pass_rule] ? ' ' + PASS_RULE_SENTENCE[constitution.pass_rule] : '';
+  const context = (matterArea
+    ? `A decision put to a vote at ${building}: the charter says matters here are decided by a sitting, not by one person acting alone. A yes carries out what it proposes.`
+    : item.subject_type === 'constitutional_amendment'
+      ? 'A proposed change to the charter, the rules for who decides what in this project. If it passes, the new rule takes effect at once.'
+      : item.subject_type === 'genesis_stage'
+        ? 'A founding stage of this project has finished its work. Closing it moves the project on to the next stage.'
+        : 'A full idea someone wrote up, put to the board. If it passes, it becomes part of the plan: a new goal or a done-when promise of one.') + passWords;
   const forN = votes.filter((v) => v.direction === 'yes').length;
   const againstN = votes.filter((v) => v.direction === 'no').length;
   const castIds = new Set(votes.map((v) => String(v.voter_id)));
@@ -433,6 +482,7 @@ function boardMatter(item, { viewerId, members }) {
     tally: { for: forN, against: againstN, open: isOpen ? open : 0, needs: PASS_RULE_NEEDS[constitution.pass_rule] || null },
     href: `/board-room?item=${encodeURIComponent(item.id)}`,
     ref: { type: 'board_item', id: item.id },
+    context,
   };
 }
 
@@ -962,6 +1012,7 @@ module.exports = {
   normalizeDeskRow,
   loadGovernment,
   normalizeMatter,
+  SOURCE_CONTEXT,
   gateAllows,
   homeLine,
   boardMatter,

package/modules/government/treasury.js

@@ -227,6 +227,8 @@ function borrowMatter(borrow, { title, canAnswer = false } = {}) {
     deadline: null,
     href: `/goal/${b.goal_id}`,
     ref: { type: 'pot_borrow', id: b.id },
+    question: `Lend ${name} ${usd(b.amount_usd)} from the reserve?`,
+    context: `Each goal gets a monthly pot of money for its AI work. ${name} has spent ${usd(b.spent_usd)} of its ${usd(b.budget_usd)} this month, so its work stops until it gets more. Lending from the reserve lets it go on; saying no pauses it until next month.`,
     detail: `${name} has spent ${usd(b.spent_usd)} of its ${usd(b.budget_usd)} pot this month and asks the reserve for ${usd(b.amount_usd)}.`,
     ...(canAnswer ? { acts: [{ key: ACT_KEY, options: [
       { key: 'lend', label: `Lend ${usd(b.amount_usd)}` }, { key: 'half', label: `Lend ${usd(half)}` }, { key: 'no', label: 'Say no' },

package/modules/hall-ui/public/city-decide.js

@@ -83,6 +83,7 @@
     var lines = ['I need to make a decision in my project and want help understanding it.', ''];
     lines.push('Where: the ' + str(cv.buildingName) + ' building' + (cv.waits ? ' (' + str(cv.waits) + ')' : '') + '.');
     lines.push('The question: ' + str(cv.question));
+    if (cv.context) lines.push('What it is: ' + str(cv.context));
     if (cv.said) lines.push('What it says: ' + str(cv.said));
     var card = cv.card || {};
     var more = card.more && card.more.text ? str(card.more.text) : str(card.fact || '');
@@ -255,8 +256,10 @@
   function drawCard(doc, K, cv, on, o) {
     var shown = answerable(cv);
     var matter = matterOf(on.docket && on.docket(), cv.id);
-    // the question in full: a matter with no stored card is titled by its own words, cut to fit the deck
-    if (matter && !cv.askReal && matter.title) shown.question = questionOf(matter.title);
+    // the question in full: a matter with no stored card asks its own plain question
+    // when it wrote one (task 1005013), else is titled by its own words, cut to fit the deck
+    if (matter && !cv.askReal && matter.question) shown.question = questionOf(matter.question);
+    else if (matter && !cv.askReal && matter.title) shown.question = questionOf(matter.title);
     var art = K.drawAsk(doc, shown, on, o);
     // and everything else it says, one tap away rather than cut
     var full = fullText(matter, shown);

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

@@ -231,6 +231,7 @@ html[data-fullscreen="on"] .city-top { right: 184px; }
 .city-card .city-ask.ask { padding: 14px 16px; gap: 10px; }
 .city-card .city-ask .ask__q { font-size: 17px; line-height: 1.3; font-weight: 400; }
 .city-card .city-ask .ask__said { font-size: 13px; }
+.city-card .city-ask .ask__ctx { font-size: 13px; line-height: 1.45; }
 .city-card .city-ask .ask__opt { min-height: 44px; padding: 6px 12px 6px 10px; border-radius: 14px; }
 .city-card .city-ask .ask__label { font-size: 14px; }
 .city-card .city-ask .ask__result { font-size: 12px; }

package/modules/hall-ui/public/gov-living.js

@@ -338,6 +338,9 @@
 
   // ---------- one ask card ----------
   const STATE_ORDER = Object.freeze({ needs: 1, moving: 2, settled: 3 });
+  // a blocker read straight from GET /blockers carries no docket context; this is
+  // the docket's own sentence for one (modules/government/docket.js SOURCE_CONTEXT)
+  const BLOCKER_CONTEXT = 'A blocker: work that cannot go on until a person decides something. Deciding it releases the work that waits on it.';
   function makeAsk(base, human, ctx, sources) {
     const opened = time(base.opened_at);
     const deadline = time(base.deadline);
@@ -375,7 +378,8 @@
       href: base.href || null,
       acts: base.acts || [],
       tally: base.tally || null,
-      raw: { title: str(base.raw_title), detail: str(base.raw_detail), slop: slopScore(rawText) },
+      // what the card is about and the plain question it asks (task 1005013)
+      raw: { title: str(base.raw_title), detail: str(base.raw_detail), slop: slopScore(rawText), context: str(base.raw_context), question: str(base.raw_question) },
       human: human || null,
       format,
       shown: format.ok ? human : null,
@@ -661,7 +665,7 @@
       const stored = storedOf(m.ask);
       asks.push(makeAsk({
         id: m.id, source: m.source, building, state: m.state, opened_at: m.opened_at, deadline: m.deadline,
-        rule: m.rule, ref: m.ref, href: m.href, acts: m.acts, tally: m.tally, raw_title: m.title, raw_detail: m.detail, from_docket: true, ask_real: !!stored, route: m.route,
+        rule: m.rule, ref: m.ref, href: m.href, acts: m.acts, tally: m.tally, raw_title: m.title, raw_detail: m.detail, raw_context: m.context, raw_question: m.question, from_docket: true, ask_real: !!stored, route: m.route,
       }, humanOf(stored), ctx, ASK_SOURCES));
     });
     arr(o.blockers, 'blockers').forEach((b) => {
@@ -672,7 +676,7 @@
       const stored = storedOf(b.ask);
       asks.push(makeAsk({
         id, source: 'blockers', building: 'planning', state: 'needs', opened_at: b.created_at, deadline: null,
-        rule: 'decide', ref: { type: 'blocker', id: String(b.id) }, href: '/blockers#blocker-' + b.id, acts: [], raw_title: b.title, raw_detail: b.body_md, ask_real: !!stored,
+        rule: 'decide', ref: { type: 'blocker', id: String(b.id) }, href: '/blockers#blocker-' + b.id, acts: [], raw_title: b.title, raw_detail: b.body_md, raw_context: BLOCKER_CONTEXT, ask_real: !!stored,
       }, humanOf(stored), ctx, ASK_SOURCES));
     });
     asks.sort(compareAsks);

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

@@ -123,6 +123,8 @@ body[data-page="street"] .street-toast { z-index: 13; }
    it is not a control, so it draws no ring */
 .ask__q:focus, .ask__q:focus-visible { outline: none; box-shadow: none; }
 .ask__said { margin: -4px 0 0; font-size: 15.5px; line-height: 1.5; color: var(--ink-soft); }
+/* what the card is about, under its question (task 1005013) */
+.ask__ctx { margin: -4px 0 0; font-size: 14.5px; line-height: 1.5; color: var(--ink); overflow-wrap: anywhere; }
 .ask__likes { margin: -2px 0 0; padding: 0; list-style: none; display: flex; flex-direction: column; gap: 6px; }
 .ask__likes li { display: flex; gap: 10px; font-size: 14.5px; line-height: 1.4; color: var(--ink); }
 .ask__likes li::before { content: ""; flex: none; width: 5px; height: 5px; margin-top: 8px; border-radius: 50%; background: var(--ink-faint); }
@@ -160,6 +162,7 @@ body[data-page="street"] .street-toast { z-index: 13; }
 .ask--here { gap: 14px; padding: 18px 18px 16px; border-radius: 22px; background: var(--gov-chip); border: 1px solid var(--gov-chip-edge); }
 .ask--here .ask__q { font-size: 23px; }
 .ask--here .ask__said { font-size: 14.5px; }
+.ask--here .ask__ctx { font-size: 14px; }
 .ask--here .ask__opt { min-height: 54px; border-radius: 15px; }
 
 /* a building's card on the street: glass beside its pin */

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

@@ -213,11 +213,14 @@
       routing: shown && shown.routing_note ? str(shown.routing_note) : '', tally: ask.tally || null, kind: ask.kind || null,
       // a board's vote shows its seats, one pip each, lit as the sitting's tally says
       seats: boardSeats(c.docket, ask.waits_on ? str(ask.waits_on.seat) : ''),
+      // what this is and what it belongs to, in plain words (task 1005013)
+      context: ask.raw ? plain(ask.raw.context) : '',
       card: cv,
     };
     if (!shown) {
       // no stored ask: the matter in its own words, and its floor's desk, where its acts are
-      view.question = fit(plain(ask.raw ? ask.raw.title : ''), 90);
+      // the matter's own plain question when it wrote one, else its title (task 1005013)
+      view.question = ask.raw && ask.raw.question ? fit(plain(ask.raw.question), 120) : fit(plain(ask.raw ? ask.raw.title : ''), 90);
       view.desk = '/builders/street#building=' + str(ask.building);
       view.foot = footOf(ask, '');
       return view;
@@ -436,6 +439,7 @@
     q.setAttribute('tabindex', '-1');
     if (o.qid) q.setAttribute('id', o.qid);
     card.appendChild(q);
+    if (cv.context) card.appendChild(h('p', 'ask__ctx', cv.context));
     if (cv.batch && cv.likes) {
       const list = h('ul', 'ask__likes');
       cv.likes.forEach((l) => list.appendChild(h('li', '', l.question)));

package/modules/ideas/governor-docket.js

@@ -45,6 +45,9 @@ function blockerDocketMatter(b, mayResolve) {
     tally: null,
     href: `/blockers#blocker-${b.id}`,
     ref: { type: 'blocker', id: b.id },
+    context: holds
+      ? `A blocker: ${holds === 1 ? 'one task is' : `${holds} tasks are`} stopped until a person decides this. Deciding it lets that work go on.`
+      : 'A blocker: an AI session or a builder is stuck until a person decides this. Deciding it lets the work go on.',
     // the card's "more" (task 1004566): the body GET /blockers shows everyone
     detail: b.body_md || null,
     // the floor desk's one act (task 1004560): decide, by one of its options

package/modules/lifecycle/governor-docket.js

@@ -41,6 +41,8 @@ function overrideMatter(r, mayDecide) {
     tally: null,
     href: `/task/${encodeURIComponent(r.task_id)}`,
     ref: { type: 'override_request', id: r.id },
+    question: 'Let this work through although it failed its check?',
+    context: `${r.requester_display_name || r.requester_login || 'A builder'} asks to let the task "${r.task_title || r.task_id}" through. Its automatic check or grade failed it, so it cannot land on its own. Approving treats the work as passed; holding it keeps it out until it is fixed.`,
     // the card's "more" (task 1004566): the reason GET /override-requests shows
     detail: r.rationale || null,
   };
@@ -60,6 +62,8 @@ function removalMatter(r) {
     tally: null,
     href: `/task/${encodeURIComponent(r.proposal_task_id)}`,
     ref: { type: 'task', id: r.proposal_task_id },
+    question: 'Is this shipped work really gone?',
+    context: `A later change deleted files that earlier shipped work put there${r.goal_title ? `, in the goal "${r.goal_title}"` : ''}. Moves and rewrites can look like deletions, so a person decides: Remove means that work no longer counts as alive; Keep means it still does. Nothing is undone either way.`,
     // the card's "more" (task 1004566): the proposal's own text, from the same read
     detail: r.description || null,
     // POST /removal-proposals/:id/decide, the docket source's own atom (task 1004559)
@@ -84,12 +88,31 @@ function uatActs(c, { force = false } = {}) {
   return acts;
 }
 
+// What a Review card says (task 1005013): the promise in quotes, the goal it
+// belongs to, that its work shipped, and what the sign-off closes. Pure.
+function quoteOf(md) {
+  // the promise's own last full stop goes: the sentence around it supplies one
+  const t = String(md || '').replace(/[*_`#>]+/g, '').replace(/\s+/g, ' ').trim().replace(/\.+$/, '');
+  return t.length <= 220 ? t : t.slice(0, 219).replace(/\s+\S*$/, '') + '…';
+}
+function uatContext(c) {
+  const n = Number(c.shipped_total) || 0;
+  const goal = c.goal_title ? `the goal "${c.goal_title}"` : 'this version';
+  const built = n === 1 ? 'The one task built for it has shipped.' : n > 1 ? `All ${n} tasks built for it have shipped.` : 'Its work has shipped.';
+  const how = c.backend_only === true
+    ? 'It has nothing to see on screen, so check it works and sign it off.'
+    : "Try it on the live site, then record a short video of it working and sign it off on the goal's page.";
+  return `The promise: "${quoteOf(c.criterion_md)}". It is one of the done-when promises of ${goal}. ${built} ${how} That closes the promise; the goal is achieved once all its promises are closed.`;
+}
+
 function uatMatter(c, opts) {
   return {
     id: c.id,
     rule: 'signoff',
     state: 'needs',
     title: c.criterion_md,
+    question: c.backend_only === true ? 'Is this promise kept? Check it and sign it off.' : 'Does this work on the live site now?',
+    context: uatContext(c),
     short: 'waiting for a tester',
     where: c.goal_title ? `review · ${c.goal_title}` : 'review · a promise to sign off',
     opened_at: null,
@@ -118,6 +141,9 @@ function joinRequestMatter(r, mine) {
     tally: null,
     href: r.goal_id ? `/goals#/goal/${encodeURIComponent(r.goal_id)}` : '/goals',
     ref: { type: 'goal_membership_request', id: r.id },
+    context: mine
+      ? `You asked to join the team of the goal "${r.goal_title || r.goal_id}". Its lead decides; once you are in, you can claim its tasks.`
+      : `${r.display_name || r.github_login || 'Someone'} asks to join the team of the goal "${r.goal_title || r.goal_id}". Members of a goal may claim its tasks; its lead decides who joins.`,
   };
 }
 

package/modules/onboarding/routes/access-requests.js

@@ -258,6 +258,8 @@ function accessRequestDocketMatter(r) {
     tally: null,
     href: '/watch',
     ref: { type: 'access_request', id: r.id },
+    question: `Let ${r.display_name || r.github_login} join this project?`,
+    context: `${r.display_name || r.github_login} (GitHub: ${r.github_login}) asked to join this project as a builder${r.vouched ? ', signed in through Bongos so the name is really theirs' : ''}. Admitting them lets them sign in and claim work; declining keeps them out.`,
     // the card's "more" (task 1004566): their note, as GET /access-requests shows it
     detail: r.note || null,
   };

package/modules/provisioning/routes/provisioning.js

@@ -357,7 +357,7 @@ module.exports = function provisioningRoutes() {
       // exactly the set the panel preselected. An explicit [] is the different
       // answer "none of them". maxItems is a sanity ceiling well above a catalog
       // that is three modules wide today.
-      modules: { type: 'array', itemsType: 'string', maxItems: 50 }, terms_acknowledged: { type: 'boolean' }, demo: { type: 'object' }, ship_mode: { type: 'string', enum: ['auto', 'manual'] },   // the wizard's terms tick (task 1004417, ../terms-ack.js); the demo route's { people, hours_each } (task 1004420, ../demo.js)
+      modules: { type: 'array', itemsType: 'string', maxItems: 50 }, terms_acknowledged: { type: 'boolean' }, demo: { type: 'object' }, ship_mode: { type: 'string', enum: ['auto', 'manual'] }, genesis: { type: 'boolean' },   // the wizard's terms tick (task 1004417, ../terms-ack.js); the demo route's { people, hours_each } (task 1004420, ../demo.js)
     })) return;
     const body = req.body || {};
     const detailFault = badProjectDetail(body.detail);
@@ -472,7 +472,9 @@ module.exports = function provisioningRoutes() {
       // Born into genesis (task 1004506, ../birth.js): only the row this request MADE, and before the
       // provision intent exists, so the runner's web.env already carries the marker and the demo's box.
       // Best-effort: a project that misses its marker opens as an ordinary hall; the create still stands.
-      if (created) await birth.stampBirth(pool, instance.id).catch((err) => log.error('[provisioning] birth marker not stamped', err));
+      // Genesis is OFF by default (owner, 2026-11-01): a new project opens as the full hall. Only a demo (its
+      // time box lives on the birth marker) or an explicit `genesis: true` (the test toggle) is born into it.
+      if (created && (demoAsk.demo || body.genesis === true)) await birth.stampBirth(pool, instance.id).catch((err) => log.error('[provisioning] birth marker not stamped', err));
       // The wizard's ship mode (task 1004629) rides beside it; a miss means the project asks at its first ship.
       if (created) await birth.stampShipMode(pool, instance.id, body.ship_mode).catch((err) => log.error('[provisioning] ship mode not stamped', err));
       const demoRow = created && demoAsk.demo ? await demo.startDemoProject(pool, provisioning, instance.id, demoAsk.demo) : null;

package/modules/security/routes/reports.js

@@ -56,6 +56,8 @@ function redteamDocketMatter(r) {
     tally: null,
     href: '/watch',
     ref: { type: 'vulnerability_report', id: r.id },
+    question: 'Is this security flaw real?',
+    context: `A security report: someone found what they say is a flaw in this project itself${r.target ? ` (in ${r.target})` : ''}${r.severity ? `, rated ${r.severity}` : ''}. "${r.title}". ${r.status === 'repro_attempted' ? 'Someone has tried to reproduce it. ' : ''}Confirm it if it is real, so it is fixed and the reporter earns the bounty; dispute it if it is not.`,
     // the card's "more" (task 1004566): what GET /security/reports shows this
     // same atom — what it targets and the report's description
     detail: [r.target ? `Target: ${r.target}` : '', r.description || ''].filter(Boolean).join('\n\n') || null,

package/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@bongos/core",
-  "version": "1.24.20",
+  "version": "1.24.22",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@bongos/core",
-      "version": "1.24.20",
+      "version": "1.24.22",
       "license": "AGPL-3.0-or-later",
       "dependencies": {
         "express": "^4.21.2",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bongos/core",
-  "version": "1.24.20",
+  "version": "1.24.22",
   "description": "Cloud Bongos — the AI-first build platform core (GDS + platform surfaces + module system), installed as a versioned dependency (ADR 0108).",
   "license": "AGPL-3.0-or-later",
   "main": "src/platform-server.js",

package/release-notes.json

@@ -11009,5 +11009,17 @@
       "id": "1005032",
       "text": "The Builders page now has the circuit-trace divider from the owner's Studio idea between the column headings and the first row, in light and dark and on phones."
     }
+  ],
+  "1.24.21": [
+    {
+      "id": "1005013",
+      "text": "Every card in the city now says what it is. Under each question sits a short plain explanation: what kind of thing it is, which goal, task, person or module it belongs to, and what answering does. A Review card used to show a"
+    }
+  ],
+  "1.24.22": [
+    {
+      "id": "1005034",
+      "text": "New projects now open as the full hall instead of starting in the guided setup (genesis and founding mode). The guided setup is paused for now and stays available for demo projects and for test projects that ask for it. Projec"
+    }
   ]
 }

package/src/bongos/module-rechecks.js

@@ -77,6 +77,9 @@ function moduleRecheckMatter(r, mayRerun) {
     proposer: null,
     tally: null,
     href: '/modules',
+    context: failed
+      ? `${r.module_key} is a module (an add-on to this project). Version ${r.version} failed its automatic security check, so it is held back until someone runs the check again.`
+      : `${r.module_key} is a module (an add-on to this project). Version ${r.version} is being checked again for safety; nothing is needed unless the check fails.`,
     // "<key>@<version>": the reassess route's two path parts (task 1004566)
     ref: { type: 'module_version', id: `${r.module_key}@${r.version}` },
     // the one act a governor takes on it, under the reassess route's own atom,

package/src/bongos/routes/core-update.js

@@ -143,6 +143,8 @@ function coreUpdateDocketMatters(update) {
     tally: null,
     href: '/settings#software-update',
     ref: { type: 'core_version', id: String(update.latest) },
+    question: `Update Bongos to ${update.latest}?`,
+    context: `Bongos is the software this project runs on. This project runs ${update.running}; ${update.latest} is out. Taking it moves the project to the new version on its next restart.`,
   }];
 }
 // The running core, or null when it cannot be named. Read lazily and fail-soft,

package/src/module-api.js

@@ -81,7 +81,7 @@ const { sleep } = require('./sleep');
 // MAJOR (see allowBoxScope below): passes the request through untouched.
 function deprecatedNoopMiddleware(_req, _res, next) { next(); }
 
-const CORE_VERSION = '1.24.20'; // CI auto-patch carrier (ADR 0161); changelog: docs/module-api-changelog.md
+const CORE_VERSION = '1.24.22'; // CI auto-patch carrier (ADR 0161); changelog: docs/module-api-changelog.md
 
 // A namespaced logger so a module's log lines are attributable + consistent.
 // Usage: const log = api.logger('discord'); log.info('mounted');

package/tests/city_card_context.mjs

@@ -0,0 +1,139 @@
+// tests/city_card_context.mjs — EVERY CITY CARD SAYS WHAT IT IS (task 1005013).
+//
+// The owner, 2026-10-29: the cards "exist without context". A Review card showed a
+// done-when criterion's raw wording with no question; a security card "Security
+// report: <title>". What this pins:
+//   * the docket passes a matter's own `context` and `question` through, bounded,
+//     and gives every source the design names a plain sentence of its own when a
+//     matter brought none — no card is ever only a bare title;
+//   * every source's mapper writes context naming what it belongs to (the goal,
+//     the task, the person, the module) — the Review card names its goal, its
+//     shipped tasks and what the sign-off closes, and asks a real question;
+//   * the hall carries both to the card, and the one card drawing (drawAsk: deck,
+//     street, interior, city) shows the context under the question.
+//
+// Run:  node --test tests/city_card_context.mjs
+
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { createRequire } from 'node:module';
+
+const require = createRequire(import.meta.url);
+const docket = require('../modules/government/docket.js');
+const lifecycleDocket = require('../modules/lifecycle/governor-docket.js');
+const ideasDocket = require('../modules/ideas/governor-docket.js');
+const reportsRoute = require('../modules/security/routes/reports.js');
+const accessRoute = require('../modules/onboarding/routes/access-requests.js');
+const coreUpdate = require('../src/bongos/routes/core-update.js');
+const moduleRechecks = require('../src/bongos/module-rechecks.js');
+const treasury = require('../modules/government/treasury.js');
+const living = require('../modules/hall-ui/public/gov-living.js');
+const deck = require('../modules/hall-ui/public/street-deck.js');
+
+const at = { source: 'criteria_uat', building: 'review' };
+
+test('every source the design names has its own plain sentence, used when a matter brings none', () => {
+  for (const s of docket.EXPECTED_SOURCES) {
+    const words = docket.SOURCE_CONTEXT[s.source];
+    assert.ok(typeof words === 'string' && words.length > 40, `${s.source} has a sentence`);
+    assert.equal(docket.normalizeMatter({ id: 1, title: 't' }, { source: s.source, building: s.building }).context, words);
+  }
+});
+
+test('a matter\'s own context and question win, bounded and on one line; junk is dropped', () => {
+  const m = docket.normalizeMatter({ id: 1, title: 't', context: '  Its   own\nwords.  ', question: ' Does it work? ' }, at);
+  assert.equal(m.context, 'Its own words.');
+  assert.equal(m.question, 'Does it work?');
+  const long = docket.normalizeMatter({ id: 1, title: 't', context: 'word '.repeat(400), question: 'q '.repeat(200) }, at);
+  assert.ok(long.context.length <= 600 && long.context.endsWith('…'));
+  assert.ok(long.question.length <= 160);
+  for (const bad of [null, '', '   ', 42, { x: 1 }]) {
+    const n = docket.normalizeMatter({ id: 1, title: 't', context: bad, question: bad }, at);
+    assert.equal(n.context, docket.SOURCE_CONTEXT.criteria_uat, 'falls back to the source sentence');
+    assert.ok(!('question' in n));
+  }
+  assert.equal(docket.normalizeMatter({ id: 1, title: 't' }, { source: 'nobody_named', building: 'review' }).context, undefined, 'an unknown source invents nothing');
+});
+
+test('the Review card asks a real question and names the goal, the shipped work and what the sign-off closes', () => {
+  const c = { id: 9, criterion_md: 'Builders can sign in with **Google**', goal_id: 7, goal_title: 'Google sign-in', shipped_total: 3, backend_only: false };
+  const m = lifecycleDocket.uatMatter(c, {});
+  assert.equal(m.question, 'Does this work on the live site now?');
+  assert.match(m.context, /The promise: "Builders can sign in with Google"/);
+  assert.match(m.context, /done-when promises of the goal "Google sign-in"/);
+  assert.match(m.context, /All 3 tasks built for it have shipped/);
+  assert.match(m.context, /record a short video/);
+  assert.match(m.context, /the goal is achieved once all its promises are closed/);
+  assert.equal(m.title, c.criterion_md, 'the title stays the promise itself (desks and the street list read it)');
+  const back = lifecycleDocket.uatMatter({ ...c, backend_only: true, shipped_total: 1, goal_title: null }, {});
+  assert.match(back.question, /Check it and sign it off/);
+  assert.match(back.context, /nothing to see on screen/);
+  assert.match(back.context, /The one task built for it has shipped/);
+  assert.match(back.context, /of this version/);
+});
+
+test('every other source names what it belongs to', () => {
+  const lc = lifecycleDocket;
+  assert.match(lc.overrideMatter({ id: 1, task_id: 4, task_title: 'Fix login', requester_login: 'kai' }, true).context, /"Fix login".*failed/);
+  assert.match(lc.removalMatter({ proposal_task_id: 2, title: 'x', goal_title: 'Docs' }).context, /goal "Docs"/);
+  assert.match(lc.joinRequestMatter({ id: 3, goal_id: 5, goal_title: 'Maps', display_name: 'Ana' }, false).context, /Ana asks to join the team of the goal "Maps"/);
+  assert.match(lc.joinRequestMatter({ id: 3, goal_id: 5, goal_title: 'Maps' }, true).context, /^You asked to join/);
+  assert.match(ideasDocket.blockerDocketMatter({ id: 1, title: 'x', blocking_task_ids: [1, 2] }, true).context, /2 tasks are stopped/);
+  const r = reportsRoute.redteamDocketMatter({ id: 2, title: 'No limit on tries', status: 'open', target: '/login', severity: 'high' });
+  assert.equal(r.question, 'Is this security flaw real?');
+  assert.match(r.context, /flaw in this project itself \(in \/login\), rated high\. "No limit on tries"/);
+  const a = accessRoute.accessRequestDocketMatter({ id: 1, github_login: 'kai', display_name: 'Kai', vouched: true });
+  assert.equal(a.question, 'Let Kai join this project?');
+  assert.match(a.context, /GitHub: kai/);
+  const [u] = coreUpdate.coreUpdateDocketMatters({ reading: 'ok', behind: true, latest: '1.25.0', running: '1.24.1' });
+  assert.match(u.context, /runs 1\.24\.1; 1\.25\.0 is out/);
+  assert.match(moduleRechecks.moduleRecheckMatter({ version_id: 7, module_key: 'image-tools', version: '1.2.0', security_failed: true }, true).context, /image-tools is a module.*failed its automatic security check/);
+  const b = treasury.borrowMatter({ id: 1, goal_id: 3, spent_usd: 20, budget_usd: 20, amount_usd: 10, filed_at: null }, { title: 'Maps' });
+  assert.match(b.context, /Maps has spent \$20/);
+  assert.match(b.question, /^Lend Maps/);
+});
+
+test('board sittings say what is being decided and by what rule', () => {
+  const item = (subject_type, pass_rule) => ({ id: 1, subject_type, subject_id: 1, subject: { title: 'An idea', author_id: 9 }, constitution: { pass_rule }, votes: [], closed_at: null });
+  assert.match(docket.boardMatter(item('full_idea', 'first_ratifier'), { viewerId: 1, members: [] }).context, /becomes part of the plan.*One yes decides it\./);
+  assert.match(docket.boardMatter(item('constitutional_amendment', 'majority'), { viewerId: 1, members: [] }).context, /change to the charter.*more than half/);
+  assert.match(docket.boardMatter(item('genesis_stage', 'consent'), { viewerId: 1, members: [] }).context, /founding stage.*unless someone objects/);
+});
+
+// a DOM just big enough for drawAsk
+function fakeDoc() {
+  const make = (tag) => ({
+    tag, className: '', textContent: '', children: [], attrs: {},
+    setAttribute(k, v) { this.attrs[k] = v; }, appendChild(c) { this.children.push(c); return c; }, addEventListener() {},
+  });
+  return { createElement: make, createTextNode: (t) => ({ tag: '#text', textContent: t, children: [] }) };
+}
+function find(node, cls) {
+  if (node.className && String(node.className).split(' ').includes(cls)) return node;
+  for (const c of node.children || []) { const hit = find(c, cls); if (hit) return hit; }
+  return null;
+}
+
+test('the hall carries context and question to the card, and the card draws the context under its question', () => {
+  const matter = docket.normalizeMatter(lifecycleDocket.uatMatter({ id: 9, criterion_md: 'Builders can sign in with Google', goal_title: 'Google sign-in', shipped_total: 3 }, {}), at);
+  const model = living.livingModel({ docket: { matters: [matter] }, now: Date.now() });
+  const ask = model.city.asks.find((x) => x.id === matter.id);
+  assert.ok(ask, 'the matter is an ask');
+  assert.equal(ask.raw.question, 'Does this work on the live site now?');
+  assert.equal(ask.raw.context, matter.context);
+  const cv = deck.cardView(ask, {});
+  assert.equal(cv.question, 'Does this work on the live site now?');
+  assert.equal(cv.context, matter.context);
+  const card = deck.drawAsk(fakeDoc(), cv, {}, {});
+  const q = find(card, 'ask__q');
+  const ctx = find(card, 'ask__ctx');
+  assert.ok(q && ctx, 'question and context are both drawn');
+  assert.equal(ctx.textContent, matter.context);
+  assert.ok(card.children.indexOf(ctx) === card.children.indexOf(q) + 1, 'the context sits right under the question');
+});
+
+test('a blocker read straight from GET /blockers carries the docket\'s blocker sentence', () => {
+  const model = living.livingModel({ blockers: [{ id: 4, title: 'Pick a host', status: 'open', created_at: '2026-10-01T00:00:00Z' }], now: Date.now() });
+  const ask = model.city.asks.find((x) => x.id === 'blockers:4');
+  assert.equal(ask.raw.context, docket.SOURCE_CONTEXT.blockers, 'the two copies of the sentence agree');
+});

package/tests/government_treasury.mjs

@@ -67,7 +67,7 @@ function project({ pots = [], borrows = [], cap = null, spend = {}, lastMonth =
       return { rows: [{ month: params[0], total_usd: thisMonth }, ...(st.lastMonth ? [{ month: params[1], total_usd: st.lastMonth }] : [])] };
     }
     if (/^SELECT t\.goal_id, COALESCE\(SUM\(cl\.amount_usd\), 0\) AS total_usd FROM cost_log cl JOIN tasks t/.test(s)) {
-      assert.equal(params[0], '2026-10');
+      assert.match(params[0], /^\d{4}-\d{2}$/); // the month asked for: NOW's in the direct cases (pinned by t.month below), the real clock's over the route
       return { rows: Object.entries(st.spend).map(([goal_id, total_usd]) => ({ goal_id, total_usd })) };
     }
     if (/^SELECT goal_id, budget_usd, set_by, set_at FROM government_pots/.test(s)) return { rows: st.pots };

package/tests/governor_docket.mjs

@@ -98,7 +98,9 @@ test('normalizeMatter: the one shape, prefixed id, ISO dates', () => {
   assert.deepEqual(m.proposer, { id: '3', login: 'theo', name: null });
   assert.deepEqual(m.tally, { for: 2, against: 1, open: 2, needs: 'x' });
   assert.deepEqual(m.ref, { type: 'a', id: '5' });
-  assert.deepEqual(Object.keys(m).sort(), ['building', 'deadline', 'href', 'id', 'opened_at', 'proposer', 'ref', 'rule', 'short', 'source', 'state', 'tally', 'title', 'where'].sort());
+  // `context` is the source's own sentence when the matter brought none (task 1005013)
+  assert.deepEqual(Object.keys(m).sort(), ['building', 'context', 'deadline', 'href', 'id', 'opened_at', 'proposer', 'ref', 'rule', 'short', 'source', 'state', 'tally', 'title', 'where'].sort());
+  assert.equal(m.context, docket.SOURCE_CONTEXT.access_requests);
 });
 
 test('normalizeMatter carries a matter\'s detail for the card\'s "more" only as bounded text (task 1004566)', () => {

package/tests/hall_gov_real_site.mjs

@@ -425,7 +425,7 @@ test('the decision deck on a real site: the docket\'s own asks in their own word
   noPrototype(p, 'deck');
   const deck = p.byId.get('streetDeck');
   assert.equal(deck.hidden, false, 'the deck opens');
-  const docketTitles = fx('government__docket').matters.map((m) => m.title).concat(fx('blockers').blockers.map((b) => b.title));
+  const docketTitles = fx('government__docket').matters.flatMap((m) => [m.title, m.question]).filter(Boolean).concat(fx('blockers').blockers.map((b) => b.title));
   assert.ok(docketTitles.some((t) => deck.textContent.includes(t)), 'a real ask, as its source words it');
   // the format's refusal is the prototype's: a real ask goes to its floor's desk, where its real acts are
   assert.doesNotMatch(deck.textContent, /sent back|until its agent writes it|prototype data|pass it on/, 'no refusal, no key, no seats to pass to');

package/tests/hall_street_depth.mjs

@@ -52,6 +52,12 @@ require(path.join(PUB, 'street-desk.js')); // the line rule's fit, on the global
 const read = (f) => fs.readFileSync(path.join(PUB, f), 'utf8');
 const fx = (name) => JSON.parse(fs.readFileSync(path.join(FX, name + '.json'), 'utf8'));
 const NOW = Date.parse('2026-10-09T14:00:00.000Z');
+// The page reads the clock itself (street-depth.js, GovFeeds.model(raw, Date.now())), and the fixtures are
+// October's: pin the page's clock to NOW so a later real month does not read them as stale and hide a tile.
+class PinnedDate extends Date {
+  constructor(...a) { super(...(a.length ? a : [NOW])); }
+  static now() { return NOW; }
+}
 const clone = (o) => JSON.parse(JSON.stringify(o));
 
 function feeds(over = {}) {
@@ -475,7 +481,7 @@ async function bootPage({ withLiving = true } = {}) {
   const window = { innerWidth: 1440, innerHeight: 900, location: { hash: '' }, localStorage: { getItem: () => 'dark', setItem() {} }, matchMedia: () => ({ matches: true, addEventListener() {} }), addEventListener() {} };
   class MutationObserver { observe() {} }
   window.fetch = fetch;
-  const ctx = vm.createContext({ window, document, fetch, Promise, Math, String, Number, Array, Object, JSON, Date, console, encodeURIComponent, decodeURIComponent, isNaN, isFinite, MutationObserver, Set });
+  const ctx = vm.createContext({ window, document, fetch, Promise, Math, String, Number, Array, Object, JSON, Date: PinnedDate, console, encodeURIComponent, decodeURIComponent, isNaN, isFinite, MutationObserver, Set });
   ctx.globalThis = ctx;
   for (const f of (withLiving ? ['gov-living.js', 'gov-feeds.js'] : []).concat(['city-draw.js', 'street-draw.js', 'street-card.js', 'street-inside.js', 'street-depth.js', 'street-desk.js', 'street.js'])) vm.runInContext(read(f), ctx);
   await window.GovStreetPage.ready;