@bongos/core 1.19.984 → 1.19.985

package/.bongos-core.json

@@ -2,11 +2,11 @@
   "artifact": "bongos-core",
   "manifest_schema": 1,
   "generator": "scripts/gds/package-core.js",
-  "core_version": "1.19.984",
-  "core_contract": "1.19.984",
-  "source_commit": "b25c4e8c52129a3c0710d5f8e3c34336fbce056e",
+  "core_version": "1.19.985",
+  "core_contract": "1.19.985",
+  "source_commit": "83b55732b7a45bc4ac27e3f8b4872570c2453a43",
   "source_ref": "HEAD",
-  "built_at": "2026-09-23T18:10:46.744Z",
+  "built_at": "2026-09-23T18:23:03.534Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
     "docs_redacted": 518,
@@ -17,7 +17,7 @@
     "gate": "passed"
   },
   "file_count": 2933,
-  "tree_sha256": "859af3630cbdafa3a20f7080579d49e9b45d4b33dda7298c2484900c697b1afa",
+  "tree_sha256": "a3e334e9c129ec8270c4874ec1df68f400624469cfb9652714507b7049ec07f5",
   "files": [
     {
       "path": ".claude/skills/ask-for-help/SKILL.md",
@@ -2177,12 +2177,12 @@
     {
       "path": "docs/copy-inventory.md",
       "mode": "0000644",
-      "sha256": "359b12acabf9e1befa1a6d940ac1df5392da54ae575afc2d678690d73341f83c"
+      "sha256": "4c03ef54c19fb90810ecf5fe16be7fa65c0966031fecc8a2496cd4bbcb7bed33"
     },
     {
       "path": "docs/copy-registry.json",
       "mode": "0000644",
-      "sha256": "cc0c80c9a929b6cb3e1b964de7483bdfe6ab10aec307bd41eb2081385e7b8509"
+      "sha256": "a269cd95254b4e6dace3b2c48becbb1e67d1516bb7387971f760505fee0e4464"
     },
     {
       "path": "docs/design/apex-pass-2-direction.md",
@@ -2712,7 +2712,7 @@
     {
       "path": "docs/module-api-changelog.md",
       "mode": "0000644",
-      "sha256": "c77d5612257b8efc9a4e87537512485f46ddde94cb2709c49d739243cd2cffb3"
+      "sha256": "9a567bebe4a58d5b7efeb164ea93f3e134dc7859c12316e2319787ac3e22235c"
     },
     {
       "path": "docs/modules-contract.md",
@@ -4922,12 +4922,12 @@
     {
       "path": "modules/hall-ui/public/goal-forest-lib.js",
       "mode": "0000644",
-      "sha256": "ea6258a241922dbf8e3782e01c60a3b03a8c7d9213cdfeddb7bcb91be3227d14"
+      "sha256": "a6e105100fcc8d1e6f15510bb44a8c8a86c5a652924629dfa846474d488637fc"
     },
     {
       "path": "modules/hall-ui/public/goal-forest-render.js",
       "mode": "0000644",
-      "sha256": "b39c5544c30fedfc0a42b7cc6c59b6d630b03fd543d5c5bcc34172c494a0addc"
+      "sha256": "69b010afbc63268d446dd1341261a2a3c611562bd28eea81dfc0505928ec5d8e"
     },
     {
       "path": "modules/hall-ui/public/goal-inbox.js",
@@ -8157,12 +8157,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "fcb023f6492a00c6658961aa61c4c6c45ceffc1fa44e31f247560c5da25ba172"
+      "sha256": "e56dc24d5e58a71b9768ab10c269e8fb9fd40691fd92e8a205e6e0200204393b"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "bfe3f4dd5da3a4007ed4c60941597593a602a47ce324e7b037f0d4fa0e3cad99"
+      "sha256": "e8489984d076fec6055a6c04a71ea53fe859deac7c8bd7c50acb59e45a00c748"
     },
     {
       "path": "public-docs/index.html",
@@ -10187,7 +10187,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "09853cbe41b452b48612612661f45c506d9841baf8a70aefb052b9afaef79162"
+      "sha256": "ee0aba3198c03fa51608e06ce5d5f483335085a1aded69fef7afd71f600dfea5"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -11672,12 +11672,12 @@
     {
       "path": "tests/goal_forest_lib.mjs",
       "mode": "0000644",
-      "sha256": "3b309358c195469bee0ab1ce95242914fbc0b1b3def0bb7de3d51dc09dd29c6a"
+      "sha256": "ecced35bef62920319c038ee7d21f7d0914219c7b8640a39b219990fce3357ca"
     },
     {
       "path": "tests/goal_forest_page.mjs",
       "mode": "0000644",
-      "sha256": "5c173e79de212e014860f9e3e9b26099decbce4ab675c0f8614e6c1ebdf2a2da"
+      "sha256": "f2fa1534f8a0dc3e4e8eee69f95407eea328584f6b25a4d8ca13e2445a42caa8"
     },
     {
       "path": "tests/goal_graph.mjs",

package/docs/copy-inventory.md

@@ -368,7 +368,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `278e8281c82f` | certain | Could not vote: {…} | `modules/hall-ui/public/board-room.js:391` |
 | `a48e9f098392` | certain | Could not {…} just now. | `modules/hall-ui/public/goals-render.js:1348` |
 | `cb09ee26014f` | certain | Could not {…}: {…} | `modules/hall-ui/public/government.js:314` |
-| `f53f7aaa189f` | certain | Couldn’t load this goal’s task dependencies right now. | `modules/hall-ui/public/goal-forest-render.js:85` |
+| `f53f7aaa189f` | certain | Couldn’t load this goal’s task dependencies right now. | `modules/hall-ui/public/goal-forest-render.js:110` |
 | `737bef533845` | certain | Couldn’t refresh the queue — try reloading the page. | `modules/hall-ui/public/blockers.js:285` |
 | `28ec06f6060a` | certain | Counted, not judged: each question is worth the same, and earns its share in proportion to how much real text  | `modules/hall-ui/public/ideas.html:194` |
 | `38827a954f3b` | certain | Create a custom rank first. | `modules/hall-ui/public/government.js:459` |
@@ -650,7 +650,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `ae84ebe1d735` | certain | Name cannot be blank. | `modules/hall-ui/public/settings.js:761` |
 | `31e91ee6ce03` | certain | Name must be {…} characters or fewer. | `modules/hall-ui/public/settings.js:766` |
 | `5e8199266a8a` | certain | Name unvouched | `modules/hall-ui/public/watch.js:374` |
-| `83197947ee8d` | certain | Needed by | `modules/hall-ui/public/goal-forest-render.js:120` |
+| `83197947ee8d` | certain | Needed by | `modules/hall-ui/public/goal-forest-render.js:145` |
 | `3970d299c95a` | certain | Needs work | `modules/hall-ui/public/studio.js:162` |
 | `7def635421ea` | certain | Needs your attention | `modules/hall-ui/public/goal-inbox.js:559` |
 | `87f09d983f6c` | certain | New category label | `modules/hall-ui/public/project-settings.js:138` |
@@ -688,7 +688,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `bef9fe43ba84` | certain | No sessions recorded yet. They land here as builders ship and end sessions. | `modules/hall-ui/public/sessions.js:146` |
 | `084748fd85b4` | certain | No shipped work is recorded between core {…} and {…}. | `modules/hall-ui/public/deploy.js:340` |
 | `4485497d87bb` | certain | No specialities yet. Create one below — it takes a name and a craft, and you can train it afterwards. | `modules/hall-ui/public/settings-specialities.js:169` |
-| `545dc44ad427` | certain | No task in this goal depends on another task in this goal. | `modules/hall-ui/public/goal-forest-render.js:100` |
+| `545dc44ad427` | certain | No task in this goal depends on another task in this goal. | `modules/hall-ui/public/goal-forest-render.js:125` |
 | `712b64d8273f` | certain | No tasks match these filters. Try widening them. | `modules/hall-ui/public/work.js:417` |
 | `78f78d1d1e1f` | certain | No version is in flight right now. | `modules/hall-ui/public/roadmap.js:409` |
 | `c9800f8b6bc8` | certain | No versions declared yet. | `modules/hall-ui/public/roadmap.js:427` |
@@ -975,7 +975,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `4894b1d9b0de` | certain | System oversight: people, operations and security. | `modules/hall-ui/public/watch.js:1335` |
 | `e604fc3ace79` | certain | Task # | `modules/hall-ui/public/blockers.js:139` |
 | `a0f384b022fd` | certain | Task dependencies | `modules/hall-ui/public/goals.html:140` |
-| `91576eb7c880` | certain | Task dependency forest — scrolls sideways inside this box | `modules/hall-ui/public/goal-forest-render.js:120` |
+| `91576eb7c880` | certain | Task dependency forest — scrolls sideways inside this box | `modules/hall-ui/public/goal-forest-render.js:145` |
 | `dfc967a63d57` | certain | Task lifecycle from backlog to shipped, showing states and transitions and the edge where credits are awarded. | `modules/hall-ui/public/diagrams.html:51` |
 | `10cc12f37636` | certain | Task sections | `modules/hall-ui/public/work.html:53` |
 | `0e636ea41b29` | certain | Task status | `modules/hall-ui/public/goals-render.js:354` |
@@ -1125,7 +1125,7 @@ Identical copy within one surface. Sometimes right (a repeated button), sometime
 | `b1e63e33f739` | certain | Vulnerability reports, engagement reports, override requests, and the audit log. | `modules/hall-ui/public/watch.html:122` |
 | `411b2ff58094` | certain | Wait for task | `modules/hall-ui/public/task.js:611` |
 | `f2e019bfdbe8` | certain | Waiting to be developed | `modules/hall-ui/public/ideas.html:41` |
-| `8e4f0179e1d3` | certain | Waits on | `modules/hall-ui/public/goal-forest-render.js:120` |
+| `8e4f0179e1d3` | certain | Waits on | `modules/hall-ui/public/goal-forest-render.js:145` |
 | `3a9cd9a27a84` | certain | Walk the full ladder → | `modules/hall-ui/public/hall-render.js:84` |
 | `18f2f54de2a8` | certain | Watch sections | `modules/hall-ui/public/watch.html:54` |
 | `c1fcfa9b48c2` | certain | Watch — {{worldName}} | `modules/hall-ui/public/watch.html:6` |

package/docs/copy-registry.json

@@ -4481,7 +4481,7 @@
       "surface": "builders-hall",
       "text": "Couldn’t load this goal’s task dependencies right now.",
       "file": "modules/hall-ui/public/goal-forest-render.js",
-      "line": 85,
+      "line": 110,
       "origin": "js-text-assign",
       "confidence": "certain"
     },
@@ -7019,7 +7019,7 @@
       "surface": "builders-hall",
       "text": "Needed by",
       "file": "modules/hall-ui/public/goal-forest-render.js",
-      "line": 120,
+      "line": 145,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -7361,7 +7361,7 @@
       "surface": "builders-hall",
       "text": "No task in this goal depends on another task in this goal.",
       "file": "modules/hall-ui/public/goal-forest-render.js",
-      "line": 100,
+      "line": 125,
       "origin": "js-text-assign",
       "confidence": "certain"
     },
@@ -9944,7 +9944,7 @@
       "surface": "builders-hall",
       "text": "Task dependency forest — scrolls sideways inside this box",
       "file": "modules/hall-ui/public/goal-forest-render.js",
-      "line": 120,
+      "line": 145,
       "origin": "js-markup",
       "confidence": "certain"
     },
@@ -11294,7 +11294,7 @@
       "surface": "builders-hall",
       "text": "Waits on",
       "file": "modules/hall-ui/public/goal-forest-render.js",
-      "line": 120,
+      "line": 145,
       "origin": "js-markup",
       "confidence": "certain"
     },

package/docs/module-api-changelog.md

@@ -2442,5 +2442,7 @@ is load-bearing: the script throws rather than guess if it is missing, and
         landed since 1.19.982 with no explicit bump. run 35896466235. (task 1002620)
   1.19.984 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
         landed since 1.19.983 with no explicit bump. run 35900593334. (task 1002620)
+  1.19.985 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
+        landed since 1.19.984 with no explicit bump. run 35902000024. (task 1002620)
 ---------------------------------------------------------------------------
 ```

package/modules/hall-ui/public/goal-forest-lib.js

@@ -31,17 +31,61 @@
   'use strict';
 
   var NODE_W = 168;
-  var NODE_H = 52;
+  var NODE_H = 66;
   var GAP_X = 52;
   var GAP_Y = 14;
   var PAD = 16;
-  var TITLE_CHARS = 24;
+  var TEXT_INSET = 16;
+  var TITLE_LINES = 2;
 
   function num(id) { return Number(id); }
   function byNumericId(a, b) { return num(a) - num(b); }
-  function clip(text, max) {
+
+  // Titles are fitted to MEASURED width, not a character budget (task 1004200):
+  // proportional glyphs vary too much for any fixed count to fit a fixed box.
+  // `measure` is always the caller's, so this file stays DOM-free.
+
+  // The longest code-point prefix of `chars` that measures within maxWidth with
+  // `suffix` appended ('' if none does). Code points, so an emoji is never split.
+  function longestPrefix(chars, maxWidth, measure, suffix) {
+    var best = '';
+    var lo = 1;
+    var hi = chars.length;
+    while (lo <= hi) {
+      var mid = (lo + hi) >> 1;
+      var cand = chars.slice(0, mid).join('').replace(/\s+$/, '');
+      if (measure(cand + suffix) <= maxWidth) { best = cand; lo = mid + 1; } else { hi = mid - 1; }
+    }
+    return best;
+  }
+
+  // fitText — `text` whole if it fits, else its longest prefix that fits with an ellipsis.
+  function fitText(text, maxWidth, measure) {
     var t = String(text == null ? '' : text);
-    return t.length > max ? t.slice(0, max - 1).replace(/\s+$/, '') + '…' : t;
+    if (measure(t) <= maxWidth) return t;
+    return longestPrefix(Array.from(t), maxWidth, measure, '…') + '…';
+  }
+
+  // fitLines — `text` wrapped at spaces into at most `maxLines` lines of maxWidth,
+  // the last ellipsised when the rest will not fit. A word wider than a whole
+  // line is broken where it runs out of room, the way the browser would.
+  function fitLines(text, maxWidth, maxLines, measure) {
+    var rest = String(text == null ? '' : text).replace(/\s+/g, ' ').trim();
+    var lines = [];
+    while (rest && lines.length < maxLines - 1 && measure(rest) > maxWidth) {
+      var words = rest.split(' ');
+      var line = '';
+      for (var i = 0; i < words.length; i++) {
+        var next = line ? line + ' ' + words[i] : words[i];
+        if (measure(next) > maxWidth) break;
+        line = next;
+      }
+      if (!line) line = longestPrefix(Array.from(words[0]), maxWidth, measure, '') || Array.from(words[0])[0];
+      lines.push(line);
+      rest = rest.slice(line.length).trim();
+    }
+    if (rest) lines.push(fitText(rest, maxWidth, measure));
+    return lines;
   }
   function plural(n, one, many) { return n + ' ' + (n === 1 ? one : (many || one + 's')); }
 
@@ -224,6 +268,7 @@
 
   return {
     analyse: analyse, layout: layout, tableRows: tableRows, describe: describe,
-    clip: clip, plural: plural, priorityLabel: priorityLabel, TITLE_CHARS: TITLE_CHARS,
+    fitText: fitText, fitLines: fitLines, plural: plural, priorityLabel: priorityLabel,
+    TEXT_INSET: TEXT_INSET, TITLE_LINES: TITLE_LINES,
   };
 }));

package/modules/hall-ui/public/goal-forest-render.js

@@ -48,7 +48,21 @@
       t.textContent = content;
       return t;
     }
-    function drawForest(a, lay) {
+    // Node text baselines: the title's lines, then the priority · status line.
+    const TITLE_Y = 21;
+    const LINE_H = 15;
+    const SUB_Y = 52;
+    // Titles wrap to the card's measured inner width (task 1004200), which needs
+    // the svg in the document — so drawForest collects each node's line elements
+    // into `names` and the caller fits them after appending.
+    function fitNames(names, maxWidth) {
+      names.forEach(({ els, full }) => {
+        const measure = (s) => { els[0].textContent = s; return els[0].getComputedTextLength(); };
+        const lines = lib.fitLines(full, maxWidth, els.length, measure);
+        els.forEach((el, i) => { el.textContent = lines[i] || ''; });
+      });
+    }
+    function drawForest(a, lay, names) {
       const svg = svgEl('svg', {
         class: 'gf-svg', viewBox: `0 0 ${lay.width} ${lay.height}`, width: lay.width, height: lay.height,
         role: 'img', 'aria-labelledby': 'goal-deps-h', focusable: 'false',
@@ -56,6 +70,10 @@
       const defs = svgEl('defs', {}, svg);
       const marker = svgEl('marker', { id: 'gf-arrow', viewBox: '0 0 10 10', refX: 9, refY: 5, markerWidth: 7, markerHeight: 7, orient: 'auto' }, defs);
       svgEl('path', { class: 'gf-arrowhead', d: 'M0 0 L10 5 L0 10 z' }, marker);
+      // The hard guarantee for a title that could not be measured (drawn while
+      // hidden): it is cut at the card's edge instead of running past it.
+      const clip = svgEl('clipPath', { id: 'gf-name-clip' }, defs);
+      svgEl('rect', { width: lay.nodeW, height: lay.nodeH }, clip);
 
       const edges = svgEl('g', { class: 'gf-edges' }, svg);
       lay.edges.forEach((e) => {
@@ -71,8 +89,15 @@
         const g = svgEl('g', { class: 'gf-node', transform: `translate(${p.x} ${p.y})` }, nodes);
         svgEl('title', {}, g).textContent = `#${p.id} ${n.title || ''} — ${n.status || ''} — waits on ${n.depends_on || 0}, needed by ${n.depended_on_by || 0}`;
         svgEl('rect', { class: 'gf-card', width: p.w, height: p.h, rx: 8 }, g);
-        text(g, 'gf-name', 16, 21, `#${p.id} ${lib.clip(n.title || '', lib.TITLE_CHARS)}`);
-        text(g, 'gf-sub', 16, 37, `${lib.priorityLabel(n.priority)} · ${n.status || ''}`);
+        const full = `#${p.id} ${n.title || ''}`;
+        const els = [];
+        for (let i = 0; i < lib.TITLE_LINES; i++) {
+          const line = text(g, 'gf-name', lib.TEXT_INSET, TITLE_Y + i * LINE_H, i ? '' : full);
+          line.setAttribute('clip-path', 'url(#gf-name-clip)');
+          els.push(line);
+        }
+        names.push({ els, full });
+        text(g, 'gf-sub', lib.TEXT_INSET, SUB_Y, `${lib.priorityLabel(n.priority)} · ${n.status || ''}`);
       });
       return svg;
     }
@@ -125,7 +150,13 @@
           <thead><tr><th>Task</th><th>Status</th><th>Priority</th><th>Waits on</th><th>Needed by</th><th>Chain</th></tr></thead>
           <tbody>${rows.map(rowHtml).join('')}</tbody>
         </table>`;
-      body.querySelector('.gf-scroll').appendChild(drawForest(a, lib.layout(a)));
+      const lay = lib.layout(a);
+      const names = [];
+      body.querySelector('.gf-scroll').appendChild(drawForest(a, lay, names));
+      const fit = () => fitNames(names, lay.nodeW - 2 * lib.TEXT_INSET);
+      fit();
+      // A web font that lands after the first fit changes every width.
+      if (document.fonts && document.fonts.status !== 'loaded') document.fonts.ready.then(fit);
     }
 
     async function loadDependencyForest(goalId) {

package/package-lock.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bongos/core",
-  "version": "1.19.984",
+  "version": "1.19.985",
   "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/src/module-api.js

@@ -71,7 +71,7 @@ const { responsibilityFor, ROLE_RESPONSIBILITIES } = require('./role-responsibil
 // there. scripts/gds/bump-version.js still rewrites the literal below; it appends
 // the entry to that file. Look for a version's history there, not here.
 // ---------------------------------------------------------------------------
-const CORE_VERSION = '1.19.984'; // CI auto-patch carrier (ADR 0161); changelog: docs/module-api-changelog.md
+const CORE_VERSION = '1.19.985'; // 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('dev-box'); log.info('mounted');

package/tests/goal_forest_lib.mjs

@@ -141,6 +141,67 @@ await test('describe states the numbers plainly, and an empty forest says so', (
   assert.equal(L.describe(L.analyse({})), 'No task in this goal depends on another task in this goal.');
 });
 
+// ---- fitting a title to its card (task 1004200) ------------------------------------
+
+// A proportional fake: wide capitals cost three times a narrow letter, so any
+// character budget that fits one title overflows the other.
+const WIDTHS = { W: 12, M: 11, i: 3, '…': 8, '🚀': 14 };
+const measure = (s) => Array.from(s).reduce((w, c) => w + (WIDTHS[c] ?? 6), 0);
+
+await test('fitText leaves a title that fits untouched', () => {
+  assert.equal(L.fitText('#7 Fix', 136, measure), '#7 Fix');
+});
+
+await test('fitText cuts to the MEASURED width, so wide glyphs keep fewer characters than narrow ones', () => {
+  const wide = L.fitText('W'.repeat(40), 136, measure);
+  const narrow = L.fitText('i'.repeat(80), 136, measure);
+  for (const s of [wide, narrow]) {
+    assert.ok(measure(s) <= 136, `${s} measures ${measure(s)}, past the box`);
+    assert.ok(s.endsWith('…'), 'a cut title says it was cut');
+  }
+  assert.ok(Array.from(narrow).length > 3 * Array.from(wide).length, 'no fixed character count could produce both');
+  assert.equal(wide, 'W'.repeat(10) + '…', 'the LONGEST prefix that fits: 10 W + … = 128px, 11 would be 140px');
+});
+
+await test('fitText never ends on a dangling space and never splits an emoji', () => {
+  const spaced = L.fitText('ab cd ef gh ij kl mn op qr', 62, measure);
+  assert.doesNotMatch(spaced, /\s…$/);
+  const emoji = L.fitText('🚀'.repeat(30), 60, measure);
+  assert.equal(/[\uD800-\uDBFF](?![\uDC00-\uDFFF])/.test(emoji), false, 'no lone high surrogate');
+});
+
+await test('fitText returns a bare ellipsis when not even one character fits', () => {
+  assert.equal(L.fitText('WWW', 10, measure), '…');
+});
+
+await test('fitLines keeps a short title on one line, whole', () => {
+  assert.deepEqual(L.fitLines('#7 Fix', 136, 2, measure), ['#7 Fix']);
+});
+
+await test('fitLines wraps at a space, and a second line that fits is left whole', () => {
+  assert.deepEqual(L.fitLines('aaaa bbbb cccc dddd', 60, 2, measure), ['aaaa bbbb', 'cccc dddd']);
+  assert.deepEqual(L.fitLines('a   b\n c', 60, 2, measure), ['a b c'], 'runs of whitespace read as one space');
+});
+
+await test('fitLines ellipsises the LAST line when the title outruns every line, and no line overflows', () => {
+  const lines = L.fitLines('BV1.R26 — Real governance: the constitution becomes enforceable at last', 136, 2, measure);
+  assert.equal(lines.length, 2);
+  for (const l of lines) assert.ok(measure(l) <= 136, `"${l}" measures ${measure(l)}`);
+  assert.ok(lines[1].endsWith('…'));
+  assert.ok(!lines[0].endsWith('…'), 'only the last line is cut');
+});
+
+await test('fitLines breaks a word wider than a whole line instead of overflowing, and always finishes', () => {
+  const lines = L.fitLines('W'.repeat(40), 136, 2, measure);
+  assert.deepEqual(lines, ['W'.repeat(11), 'W'.repeat(10) + '…']);
+  assert.ok(L.fitLines('WWW', 5, 2, measure).length <= 2, 'a box narrower than one glyph still terminates');
+});
+
+await test('fitLines with one line is fitText', () => {
+  const t = 'Move the remaining hall pages onto the kit';
+  assert.deepEqual(L.fitLines(t, 90, 1, measure), [L.fitText(t, 90, measure)]);
+});
+
 // ---- purity -----------------------------------------------------------------------
 
 await test('the lib is pure: no DOM, no fetch, no cross-goal input', () => {

package/tests/goal_forest_page.mjs

@@ -18,6 +18,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import vm from 'node:vm';
 import { fileURLToPath } from 'node:url';
+import { createRequire } from 'node:module';
 import { makeRunner, makeEl, walk } from './helpers.mjs';
 
 const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
@@ -45,6 +46,8 @@ async function boot({ status = 200, fail = false, payload = { nodes: [], edges:
       const el = makeEl(tag);
       const orig = el.setAttribute.bind(el);
       el.setAttribute = (k, v) => { orig(k, v); if (k === 'class') el.className = String(v); if (k === 'id') el.id = String(v); };
+      // A proportional fake of SVGTextElement's measurement: a W is twice a letter.
+      if (tag === 'text') el.getComputedTextLength = () => Array.from(el.textContent).reduce((w, c) => w + (c === 'W' ? 12 : 6), 0);
       return el;
     },
   };
@@ -149,6 +152,31 @@ await test('a populated forest draws a role=img figure with no focus stops, and
   assert.equal(h.$('goal-deps-count').textContent, '2');
 });
 
+await test('a node title wraps to two lines by MEASURED width, clipped as a backstop, and kept whole in the tooltip (task 1004200)', async () => {
+  const wide = 'W'.repeat(60);
+  const words = 'Move the remaining hall pages onto the kit and retire the aliases';
+  const h = await boot({ payload: { nodes: [t(1, { title: wide }), t(2, { title: 'Fix' }), t(3, { title: words })], edges: [e(2, 1), e(3, 1)] } });
+  await h.renderers.loadDependencyForest(7);
+  const svg = h.$('goal-deps-body').querySelector('svg');
+  const lib = createRequire(import.meta.url)(path.join(HALL, 'goal-forest-lib.js'));
+  const inner = lib.layout(lib.analyse({ nodes: [t(1), t(2)], edges: [e(2, 1)] })).nodeW - 2 * lib.TEXT_INSET;
+  const lines = (id) => svg.querySelectorAll('.gf-node').find((g) => g.attrs.transform && g.querySelector('title').textContent.startsWith(`#${id} `))
+    .querySelectorAll('.gf-name').map((l) => l.textContent);
+  for (const n of svg.querySelectorAll('.gf-name')) {
+    assert.ok(n.getComputedTextLength() <= inner, `"${n.textContent}" measures ${n.getComputedTextLength()}px, past the card's ${inner}px`);
+    assert.equal(n.getAttribute('clip-path'), 'url(#gf-name-clip)');
+  }
+  assert.equal(lines(1).length, lib.TITLE_LINES);
+  assert.deepEqual(lines(2), ['#2 Fix', ''], 'a title that fits is left whole, on one line');
+  const [first, second] = lines(3);
+  assert.ok(words.startsWith(first.replace(/^#3 /, '')) && !first.endsWith('…'), 'line one breaks at a space, uncut');
+  assert.ok(second.endsWith('…') && words.includes(second.slice(0, -1)), 'line two continues the title and says it was cut');
+  assert.ok(lines(1)[1].endsWith('…'), 'an unbreakable run is cut on the last line, never run past the card');
+  assert.ok(svg.querySelector('#gf-name-clip'), 'the clip the lines point at exists');
+  const tip = svg.querySelectorAll('title').find((x) => x.textContent.startsWith('#1 '));
+  assert.ok(tip.textContent.includes(wide), 'the full title is still readable on hover');
+});
+
 await test('the picture scrolls inside its own region and names both overflow axes', async () => {
   const h = await boot({ payload: { nodes: [t(1), t(2)], edges: [e(2, 1)] } });
   await h.renderers.loadDependencyForest(7);