@bongos/core 1.21.86 → 1.21.87

package/.bongos-core.json

@@ -2,22 +2,22 @@
   "artifact": "bongos-core",
   "manifest_schema": 1,
   "generator": "scripts/gds/package-core.js",
-  "core_version": "1.21.86",
-  "core_contract": "1.21.86",
-  "source_commit": "7183f6e501a4de2ea256ffa4c2d19ccc62d7fdc1",
+  "core_version": "1.21.87",
+  "core_contract": "1.21.87",
+  "source_commit": "3a000da66e4b7ed910b59eb0e1843e81a7e3f7fd",
   "source_ref": "HEAD",
-  "built_at": "2026-10-09T04:48:08.126Z",
+  "built_at": "2026-10-09T05:06:35.756Z",
   "redaction": {
     "model": "docs-redacted+functional-verbatim",
     "docs_redacted": 590,
     "agent_docs_stubbed": 28,
-    "functional_verbatim": 2998,
+    "functional_verbatim": 3000,
     "rules": 3,
     "gate_literals": 3,
     "gate": "passed"
   },
-  "file_count": 3617,
-  "tree_sha256": "391c304f1f86515a2c812e6764e83ba98b5fe6a67757909baf15d8e88009694b",
+  "file_count": 3619,
+  "tree_sha256": "94cb33a270055b9c3e008a1a26ad2e66038572aae76148fccb2f9b3bf2bbecf9",
   "files": [
     {
       "path": ".claude/skills/ask-for-help/SKILL.md",
@@ -2432,7 +2432,7 @@
     {
       "path": "docs/design/project-startup-direction.md",
       "mode": "0000644",
-      "sha256": "8b95dbb81af5cad9a85d3ffe9532d60391329cc957d5c79327e187bbfb3551de"
+      "sha256": "8cac194bfa4e7e0cfa6785ff72fd141980eb2abed6497ce56e42585c2f4a918c"
     },
     {
       "path": "docs/design/projects-hub-direction-v2.md",
@@ -2862,7 +2862,7 @@
     {
       "path": "docs/module-api-changelog.md",
       "mode": "0000644",
-      "sha256": "007f5683bb299be37f78f220958ae14bb8a8069fc59b81cc6fb94a12c5b3712f"
+      "sha256": "39126044930a9015689ba736100232d99d1d13d43d723ec95a15dbe505c4390d"
     },
     {
       "path": "docs/modules-contract.md",
@@ -10097,12 +10097,12 @@
     {
       "path": "package-lock.json",
       "mode": "0000644",
-      "sha256": "9d3ecc5f558e51dc8e4e66a6f3f0a6e9773e517ce9571ae4ec130b33128536ff"
+      "sha256": "6953a80922eac656bc533d17e921f49228e939cacb64da8e56d1a90fa5f358db"
     },
     {
       "path": "package.json",
       "mode": "0000644",
-      "sha256": "ce90ad007650b7bcf0705bf0743acf66507496e0a043d7d6c2d9b84795b94f9b"
+      "sha256": "be88b7b575574dc07cbf071c639c419a4365cd89e7ed0b7bba058de98982b443"
     },
     {
       "path": "public-docs/index.html",
@@ -10122,7 +10122,7 @@
     {
       "path": "release-notes.json",
       "mode": "0000644",
-      "sha256": "99cc3e08c1384339c868c499061c081eade1bcb0a996c47d3e644066d22ca536"
+      "sha256": "ba7ae503bc8f34ef8244b2fb989462283e4128b6ea03ac066d050acfb35edbc5"
     },
     {
       "path": "scripts/cron/style_guide_audit.sh",
@@ -11734,10 +11734,15 @@
       "mode": "0000644",
       "sha256": "9f6ce80e5325f4cfe68cfa6cb82bec52d594af7e461b6734724819b23cbb0d37"
     },
+    {
+      "path": "scripts/gds/start-goals.js",
+      "mode": "0000644",
+      "sha256": "8c4e1f1c7871c82b0fefd5402c93888831543dcd776a1e761e7b1238b3afafaa"
+    },
     {
       "path": "scripts/gds/start.js",
       "mode": "0000644",
-      "sha256": "4bc438bb7859c7a405088b2e386b33fb550532a71dbe66866d711e5b1d4b3e69"
+      "sha256": "181f07b8d62f03ae001d08dd5e5b15a65b33f512fb548e55401b97f7f484f31f"
     },
     {
       "path": "scripts/gds/status.js",
@@ -12372,7 +12377,7 @@
     {
       "path": "src/module-api.js",
       "mode": "0000644",
-      "sha256": "2fd52ee0afe6fc9ade992a558ebb0fc3ad5904f876f7c5093dd60ea5d201b448"
+      "sha256": "3ba47cbdc5c1c0dc86af2cf1302a6ffc3c9966a7646f88bd2a004f5dd67b0ded"
     },
     {
       "path": "src/module-loader/catalog.js",
@@ -17529,6 +17534,11 @@
       "mode": "0000644",
       "sha256": "39e62a5fc50113e719cdaacf15e6fd054f38f8703fc64137eddee7901b374f16"
     },
+    {
+      "path": "tests/start_goal_first.mjs",
+      "mode": "0000644",
+      "sha256": "a3addba1547bf0a9ce95f5d6c2ea676f63495669154e2f4c161cb8cc543b30bf"
+    },
     {
       "path": "tests/start_inbox_count.mjs",
       "mode": "0000644",

package/docs/design/project-startup-direction.md

@@ -10,7 +10,64 @@ This document is what every build task in goal 1000121 cites. Name a screen by i
 - **what the new design ADDS**;
 - the decisions that govern both.
 
-## The blended flow — supersedes the hub-side screens (owner, 2026-10-01)
+## One-page flow — supersedes the blended six screens (owner, 2026-10-08)
+
+> *Summary wins, do it in the night-room look, if it's day time let's make a day view, and likewise, same for the artist page.* Then: *approved.* — the owner, 2026-10-08.
+
+The owner found the six-screen flow still overcomplicated, and the GitHub steps after Create still failing. The mockup in [`mocks/day-night-rooms/`](mocks/day-night-rooms/README.md) is now the design of record for **every hub-side creation screen and for the artist studio's room**. Where it disagrees with the blended flow below, the mockup wins. Genesis (part 2) and the blend rule are unchanged.
+
+### The owner's decisions
+
+1. **One page, three parts.** Sign-in stays the gate in front. Then one page:
+   - **01 Your project:** name, kind, the optional sentence, and the four quick checks (country, anyone under 18, where builders will be, who's behind it). The screening stop still fires before anything is created.
+   - **02 How it's run:** a summary to skim. Each row (code, address, team, extras, rewards, hosting, we run, look) has a **Change** link that opens the real control in place.
+   - **03 Connect GitHub:** opens once the project exists, below **Create my project**.
+2. **The summary wins.** No row needs confirming and Create is not gated on the rows. This **replaces** the blended flow's "the review must not be skippable" rule. The terms stay a required checkbox above Create, and the terms version stamp still records the acceptance.
+3. **GitHub in one trip (option A).** One click: approve the project's app on GitHub, go straight on to installing it on the repo, and land back on the page. A checklist ticks itself from what the server has verified (approve the app · install it on your repo · builders can sign in · command-line sign-in is on). Coming back works from any tab or device. The founder chooses a personal or an organisation account. A failure says what stopped, and "Pick up where it stopped" resumes without making a second app.
+4. **Day room and night room, by the viewer's own clock.** Day from 07:00 to 18:59 local time, night otherwise. The day room is the same drawing in daylight: a sunny sky with clouds, a sun for the moon, lighter towers with unlit windows, a warm wall and floor, the lamp off and a patch of sun on the floor. Its palette is the mockup's `[data-sky="day"]` tokens. **The artist studio gets the same day room**, and its greeting follows the time of day.
+5. **The demo is a small link** under the heading, not its own screen.
+
+### Nothing the live wizard does is lost
+
+This table replaces the blended flow's table below for every hub-side capability. The mockup draws the simple path; each row's capability is a reveal or sits behind a summary row's **Change**.
+
+| Today | In the one-page flow |
+|---|---|
+| Q1 new or existing, and what already exists | Part 02's Code row: "A repo I already have" reveals what already exists and the adopt path. |
+| Adopt: GitHub repo picker, manual fallback, conflict pre-flight, backlog import | Behind the Code row's Change, unchanged. |
+| Q2 geography | Part 01's "Where are you?", with state or province revealed beside the country for the countries that need it, and "Where will builders be?". |
+| Q3 under-18s and the age tiers | Part 01; "Yes" reveals the tiers and the guardian rules in place. |
+| Q4 entity, new intent or existing legal type | Part 01's "Who's behind it?"; a company or nonprofit reveals the full entity list. |
+| The screening stop | Unchanged: an answer the platform cannot serve stops the page before Create, with the reason in place. |
+| Q5 one or many, count, growth guess | Part 02's Team row; Change opens the count, the growth guess and how people join. |
+| Q6 rewards | Part 02's Rewards row (pick several). |
+| Q7 framing A–D and the hybrid suite | Part 02's **We run** row ("Everything, for you" by default); "Some of it" reveals the service checklist. |
+| Auto-fill from my account | Kept, as an offer at the top of part 01 when the account has a last project. |
+| Resume a saved draft | Kept, as an offer at the top of the page (there is no fork screen any more). |
+| Type and About | Part 01's Kind and "In a sentence". |
+| Modules picker and search | Part 02's Extras row; Change opens the searchable picker. |
+| Address: handle, own domain, no address | Part 02's Address row (PS19: shown on every path, the demo included). |
+| App: Render key check, workspace, runtime, commands, plan, database | Part 02's Hosting row; Render opens today's settings in place. |
+| Look, logo, night tint | Part 02's Look row; Change opens the look picker, the logo and the night tint. |
+| Terms acknowledgement | The required checkbox above Create; the terms version stamp still records it. |
+| Review | Part 02 itself, plus the one-line recap beside Create. Nothing is gated on confirming rows. |
+| Done: standup strip, the owner-only steps, invite | Part 03 on the same page: the GitHub checklist replaces the paged owner-only steps, then "is alive" with the invite box (once the hall is live, PS15) and the genesis door. |
+| Demo: fit check, settings, teammates, 30-day notice | The "Try a small demo instead" link opens the demo's people, hours, idea and teammates in place at the top of part 01, marks the page "demo", and shows the fit sentence; the rest of the page is unchanged. |
+
+### Who builds it
+
+| Task | Builds |
+|---|---|
+| task 1004647 | This record and the mockup. |
+| task 1004648 | The one page, the day room on it, and removing the old panels. |
+| task 1004649 | GitHub in one trip, with the self-ticking checklist. |
+| task 1004650 | The hand-back from any tab or device, and checking while the page is hidden. |
+| task 1004651 | A personal or organisation account for the app. |
+| task 1004652 | Resuming a stopped step, and a fixing button for every failure. |
+| task 1004653 | The end-to-end walk, day and night, desktop and phone. |
+| task 1004654 | The artist studio's day room and time-of-day greeting. |
+
+## The blended flow — superseded by the one-page flow above (owner, 2026-10-01)
 
 > *Go for this as the design of record.* — the owner, approving the blended mockup (task 1004515).
 

package/docs/module-api-changelog.md

@@ -3004,5 +3004,7 @@ is load-bearing: the script throws rather than guess if it is missing, and
         landed since 1.21.84 with no explicit bump. run 37884200093. (task 1002620)
   1.21.86 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
         landed since 1.21.85 with no explicit bump. run 37885516955. (task 1002620)
+  1.21.87 — CI auto-patch (publish-on-merge, ADR 0161): carrier for merges
+        landed since 1.21.86 with no explicit bump. run 37886940909. (task 1002620)
 ---------------------------------------------------------------------------
 ```

package/package-lock.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bongos/core",
-  "version": "1.21.86",
+  "version": "1.21.87",
   "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

@@ -9342,5 +9342,15 @@
       "id": "1004399",
       "text": "Published module packages are now kept in the project's own data folder instead of inside the installed core, so a core upgrade no longer deletes them; any already stored in the old place are moved over when the server starts."
     }
+  ],
+  "1.21.87": [
+    {
+      "id": "1004647",
+      "text": "The new project creation design is now on record for every builder: one page in three parts instead of seven screens, a skimmable summary instead of confirming every row, GitHub in a single trip with a checklist that ticks its"
+    },
+    {
+      "id": "1002852",
+      "text": "The task list a builder sees at the start of a session now opens with the goals they have joined and how much work in each is ready, and groups the tasks under their goals, with the builder's own goals first and anything witho"
+    }
   ]
 }

package/scripts/gds/start-goals.js

@@ -0,0 +1,102 @@
+// scripts/gds/start-goals.js — /builder-start, goal-first (task 1002852).
+//
+// WHY. Work is organised in goals, but /builder-start opened on a flat list of
+// tasks, so a builder saw "task 1002852" and never which goal it served or which of
+// their own goals had work waiting. This leads with the goals the builder has
+// JOINED, then shows the same claimable table grouped under each task's goal.
+//
+// The owner's two rules (2026-10-08, WA6 chain kickoff):
+//   - the goals sit ABOVE the claimable table and never replace it, so nothing
+//     claimable is hidden from a builder who has joined no goal;
+//   - a task with no goal is listed under "Other work". Nothing is backfilled.
+//
+// PURE: no I/O. start.js fetches GET /goals (best-effort: a failed read groups by
+// goal id with a generic name and lists no joined goals) and hands both lists in.
+
+'use strict';
+
+const OTHER_WORK = 'Other work';
+const JOINED_SHOWN = 5;
+
+// The open goals this builder is a member of, in the board's own order (version,
+// sort order). `viewer_is_member` is the server's answer, never re-derived here.
+function joinedGoals(goals) {
+  return (Array.isArray(goals) ? goals : [])
+    .filter((g) => g && g.viewer_is_member === true && g.status === 'open');
+}
+
+function goalName(id, byId) {
+  const g = byId.get(String(id));
+  return (g && g.title) || `Goal ${id}`;
+}
+
+// Group claimable rows by goal, keeping each row's place in the server's order
+// (priority, then estimate) inside its group. Groups run: the builder's joined
+// goals first (board order), then every other goal by its first row, then
+// "Other work" last. Every row lands in exactly one group, so the grouped table
+// lists precisely the rows the flat one did.
+function groupByGoal(rows, goals) {
+  const list = Array.isArray(rows) ? rows : [];
+  const byId = new Map((Array.isArray(goals) ? goals : []).map((g) => [String(g.id), g]));
+  const joinedOrder = joinedGoals(goals).map((g) => String(g.id));
+  const groups = new Map();
+  for (const t of list) {
+    const key = t.goal_id == null ? null : String(t.goal_id);
+    if (!groups.has(key)) {
+      groups.set(key, {
+        goal_id: key,
+        title: key == null ? OTHER_WORK : goalName(key, byId),
+        joined: key != null && joinedOrder.includes(key),
+        rows: [],
+      });
+    }
+    groups.get(key).rows.push(t);
+  }
+  const all = [...groups.values()];
+  const joined = joinedOrder.map((id) => groups.get(id)).filter(Boolean);
+  const others = all.filter((g) => g.goal_id != null && !g.joined);
+  const other = groups.get(null);
+  return [...joined, ...others, ...(other ? [other] : [])];
+}
+
+// The "Your goals" lines above the table: each joined goal and how many tasks in
+// it are claimable for this builder right now (from the FULL filtered set, not
+// the capped card rows, so a count never under-reports). Empty when the builder
+// has joined no open goal; the table below still lists everything.
+function yourGoals(goals, claimable) {
+  const counts = new Map();
+  for (const t of Array.isArray(claimable) ? claimable : []) {
+    if (t.goal_id == null) continue;
+    const k = String(t.goal_id);
+    counts.set(k, (counts.get(k) || 0) + 1);
+  }
+  const joined = joinedGoals(goals);
+  return {
+    goals: joined.slice(0, JOINED_SHOWN).map((g) => ({
+      id: String(g.id),
+      title: g.title || `Goal ${g.id}`,
+      claimable: counts.get(String(g.id)) || 0,
+    })),
+    more: Math.max(0, joined.length - JOINED_SHOWN),
+  };
+}
+
+// Goal-first ordering for the capped card: rows in a goal the builder joined come
+// first, everything else after, each half keeping the server's order. Without it
+// the card's top rows were the board's top rows and a builder's own goals could
+// show "5 to claim" above a table holding none of them. A stable partition, so it
+// only moves rows, never drops one.
+function joinedFirst(rows, goals) {
+  const list = Array.isArray(rows) ? rows : [];
+  const joined = new Set(joinedGoals(goals).map((g) => String(g.id)));
+  const mine = [];
+  const rest = [];
+  for (const t of list) (t.goal_id != null && joined.has(String(t.goal_id)) ? mine : rest).push(t);
+  return mine.concat(rest);
+}
+
+function claimableWord(n) {
+  return n === 0 ? 'nothing to claim right now' : `${n} to claim`;
+}
+
+module.exports = { OTHER_WORK, joinedGoals, joinedFirst, groupByGoal, yourGoals, claimableWord };

package/scripts/gds/start.js

@@ -233,23 +233,30 @@ function whatItIs(t) {
 // Ids are emitted as hall links (renders as a clean #N) — a bare "#NNN" in a
 // relayed chat message autolinks to GitHub and 404s (CLAUDE.md ref rule).
 const surface = require('./surface');
+const startGoals = require('./start-goals');
 const HALL_TASK = `${hallBase()}#/task/`;
-function claimableTable(rows, rewardFromServer) {
+function claimableTable(rows, rewardFromServer, goals) {
   // On a cost-plus-only instance the Reward column is an advertised estimate that
   // is never paid — say so in the header so the column can't read as a promise,
   // and footnote what IS paid below the table (task 1002469).
   const perTask = rewardPolicy(rewardFromServer).perTaskCredit;
   const rewardHead = perTask ? 'Reward' : 'Reward (est.)';
   const headers = ['#', 'Version', ROLE_AXIS_LABEL, rewardHead, 'Est.', 'What it is'];
-  const body = rows.map((t) => [
+  const rowCells = (t) => [
     surface.taskRef(t.id, HALL_TASK),
     cell(t.version_id || '?'),
     cell(roleLabel(t) || '—'),
     `${t.credits_reward ?? 0}c`,
     estimateShort(t),
     cell(whatItIs(t)),
-  ]);
-  const out = [surface.table(headers, body)];
+  ];
+  // task 1002852: one table per goal, each under its goal's name; goal-less work
+  // last under "Other work". An empty goal list (a failed read) still groups by id.
+  const out = [];
+  for (const g of startGoals.groupByGoal(rows, goals)) {
+    if (out.length) out.push('');
+    out.push(surface.strong(g.title) + (g.joined ? ' · your goal' : ''), surface.table(headers, g.rows.map(rowCells)));
+  }
   const cpNote = costPlusOnlyNote(rewardFromServer);
   if (cpNote) out.push('', surface.em(cpNote));
   return out.join('\n');
@@ -374,6 +381,7 @@ const WIDGET_STYLE = `<style>
 .bs-thead{text-align:left;color:var(--color-text-tertiary);font-size:12px;}
 .bs-th{padding:0 6px 4px;font-weight:400;}
 .bs-tr{cursor:pointer;}
+.bs-group td{padding:10px 0 4px;font-size:12px;font-weight:500;color:var(--color-text-secondary);}
 .bs-td{padding:7px 6px;border-top:0.5px solid var(--color-border-tertiary);}
 .bs-id{color:var(--color-text-secondary);font-family:var(--font-mono);font-size:12px;}
 .bs-nowrap{white-space:nowrap;}
@@ -384,7 +392,7 @@ const WIDGET_STYLE = `<style>
 .bs-foot{font-size:13px;color:var(--color-text-tertiary);margin-top:12px;}
 </style>`;
 
-function renderWidget({ builder, claims, claimable, total, streak, recommendations, header, routingByPreference, preferred, filters, readyToClose, needsRebaseTasks }) {
+function renderWidget({ builder, claims, claimable, total, streak, recommendations, header, routingByPreference, preferred, filters, readyToClose, needsRebaseTasks, goals, yourGoals }) {
   const b = builder || {};
   // ADR 0120 part 5: the owed-rebase gate warning, rendered at the top of the
   // card (before status/holdings) since it blocks new claims. '' when none owed.
@@ -443,7 +451,7 @@ function renderWidget({ builder, claims, claimable, total, streak, recommendatio
 
   // rows — click to claim. Columns: # / Version / Type / Reward /
   // Est. / What it is (the work lane is its own column, not baked into the title).
-  const rows = claimable.map((t) => {
+  const taskRow = (t) => {
     const claimMsg = jsq(`Claim task ${t.id}`);
     const titleAttr = hesc(`Claim #${t.id}: ${t.title || ''}`);
     const d = t.discipline;
@@ -458,7 +466,16 @@ function renderWidget({ builder, claims, claimable, total, streak, recommendatio
       + TD(hesc(estimateShort(t)), 'bs-sub')
       + TD(hesc(t.title || ''), 'bs-ellip')
       + `</tr>`;
-  }).join('');
+  };
+  // task 1002852: the same rows, grouped under each task's goal ("Other work" last).
+  const rows = startGoals.groupByGoal(claimable, goals).map((g) =>
+    `<tr class="bs-group"><td colspan="6">${hesc(g.title)}${g.joined ? '<span class="bs-sub"> · your goal</span>' : ''}</td></tr>`
+    + g.rows.map(taskRow).join('')).join('');
+  // task 1002852: the goals this builder joined, ABOVE the table (never instead of it).
+  const goalsBlock = yourGoals.goals.length
+    ? `<div class="bs-menuh">Your goals</div>${yourGoals.goals.map((g) =>
+      `<div class="bs-line"><i class="ti ti-target" aria-hidden="true"></i>${hesc(clip(g.title, 60))}<span class="bs-dot"> · </span><span class="bs-sub">${hesc(startGoals.claimableWord(g.claimable))}</span></div>`).join('')}${yourGoals.more ? `<div class="bs-line bs-sub">and ${yourGoals.more} more</div>` : ''}`
+    : '';
 
   const menu = claimable.length
     ? `<table class="bs-table">
@@ -495,6 +512,7 @@ function renderWidget({ builder, claims, claimable, total, streak, recommendatio
   ${statusRow}
   ${holdings}
   ${closeBanner}
+  ${goalsBlock}
   <div class="bs-menuh">Claim one to start — ${total || claimable.length} ready for you right now${matched}${fNote}</div>
   ${menu}
   <div class="bs-foot">Click a task to claim it${moreLink}${crossLane}</div>
@@ -679,9 +697,9 @@ async function main() {
   // endpoint fails, that widget degrades to "N/A" rather than killing
   // /builder-start.
   const api = await cliClient();
-  let me, r, closeRes, progressRes, costRes, recentRes, inboxRes, blockersRes;
+  let me, r, closeRes, progressRes, costRes, recentRes, inboxRes, blockersRes, goalsRes;
   try {
-    [me, r, closeRes, progressRes, costRes, recentRes, inboxRes, blockersRes] = await Promise.all([
+    [me, r, closeRes, progressRes, costRes, recentRes, inboxRes, blockersRes, goalsRes] = await Promise.all([
       api.me.getMe(),
       api.tasks.getTasksClaimable({ query: claimableQuery }),
       api.versions.getVersionsCloseSuggestions(),
@@ -690,6 +708,8 @@ async function main() {
       api.public.getPublicRecentShipped(),
       api.inbox.getInbox({ query: { status: 'open' } }),
       api.blockers.getBlockers(),
+      // task 1002852: best-effort — a failed goals read leaves the table flat-grouped by id.
+      api.goals.getGoals({ query: { status: 'open' } }).catch(() => ({ ok: false })),
     ]);
   } catch (err) {
     // A fresh-clone instance that was never brought up refuses the connection.
@@ -741,7 +761,10 @@ async function main() {
   const filtered = routingByPreference
     ? rawClaimable.filter((t) => preferred.includes(t.discipline))
     : rawClaimable;
-  const claimable = filtered.slice(0, limit);
+  // task 1002852: goal-first. The open goals (with the server's viewer_is_member)
+  // group the table and put the builder's joined goals' rows ahead of the cap.
+  const goals = goalsRes && goalsRes.ok && Array.isArray(goalsRes.data?.goals) ? goalsRes.data.goals : [];
+  const claimable = startGoals.joinedFirst(filtered, goals).slice(0, limit);
 
   // "You might enjoy" — up to 3 claimable tasks outside the builder's lanes.
   // Computed from the FULL set so it can reach across disciplines. Suppressed
@@ -758,6 +781,7 @@ async function main() {
     ? closeRes.data.suggestions
     : [];
   const readyToClose = closeSuggestions.filter((s) => s.ready);
+  const yourGoals = startGoals.yourGoals(goals, filtered);
 
   // Header widget data (each independently optional).
   const progress = progressRes.ok && Array.isArray(progressRes.data?.progress) ? progressRes.data.progress : null;
@@ -781,6 +805,7 @@ async function main() {
         me: me.data,
         claimable,
         recommendations,
+        your_goals: yourGoals.goals,
         discipline_routing: {
           preferred_disciplines: preferred,
           applied: routingByPreference,
@@ -836,6 +861,8 @@ async function main() {
       filters: { version, discipline, fit },
       readyToClose,
       needsRebaseTasks,
+      goals,
+      yourGoals,
     }) + '\n');
     return;
   }
@@ -951,11 +978,18 @@ async function main() {
     fit && `fit=${fit}`,
   ].filter(Boolean);
   const filterNote = filterBits.length ? ` (${filterBits.join(', ')})` : '';
+  // task 1002852: the goals this builder joined, above the table (never instead of it).
+  if (yourGoals.goals.length) {
+    console.log(surface.strong('Your goals'));
+    for (const g of yourGoals.goals) console.log(`  ${clip(g.title, 60)} · ${startGoals.claimableWord(g.claimable)}`);
+    if (yourGoals.more) console.log(`  and ${yourGoals.more} more`);
+    console.log('');
+  }
   console.log(`${surface.strong('Claim one to start')} — ${filtered.length} ready for you right now${matched}${filterNote}:`);
   console.log('');
   if (claimable.length) {
     const cardRows = claimable.slice(0, CARD_ROWS);
-    console.log(claimableTable(cardRows, me.ok ? me.data?.reward : null));
+    console.log(claimableTable(cardRows, me.ok ? me.data?.reward : null, goals));
     const moreN = filtered.length - cardRows.length;
     if (moreN > 0) {
       console.log('');
@@ -1012,6 +1046,8 @@ async function main() {
         filters: { version, discipline, fit },
         readyToClose,
         needsRebaseTasks,
+        goals,
+        yourGoals,
       })
       : null;
     const markdown = captureLog(emitMarkdownCard).join('\n');

package/src/module-api.js

@@ -75,7 +75,7 @@ const { responsibilityFor, ROLE_RESPONSIBILITIES } = require('./role-responsibil
 // MAJOR (see allowBoxScope below): passes the request through untouched.
 function deprecatedNoopMiddleware(_req, _res, next) { next(); }
 
-const CORE_VERSION = '1.21.86'; // CI auto-patch carrier (ADR 0161); changelog: docs/module-api-changelog.md
+const CORE_VERSION = '1.21.87'; // 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/start_goal_first.mjs

@@ -0,0 +1,90 @@
+// tests/start_goal_first.mjs — /builder-start leads with the builder's goals
+// (task 1002852).
+//
+// The owner's rules (2026-10-08): the joined goals sit ABOVE the claimable table
+// and never replace it, and a task with no goal is listed under "Other work".
+// These drive the pure helpers in scripts/gds/start-goals.js and the real table
+// renderer start.js uses, so the property that matters — every claimable row is
+// still listed, exactly once — is checked on what the builder actually sees.
+
+import { strict as assert } from 'node:assert';
+import { createRequire } from 'node:module';
+import { makeRunner } from './helpers.mjs';
+
+const require = createRequire(import.meta.url);
+const { test, summary } = makeRunner();
+const sg = require('../scripts/gds/start-goals.js');
+
+const GOALS = [
+  { id: 10, title: 'Alpha', status: 'open', viewer_is_member: false },
+  { id: 20, title: 'Mine', status: 'open', viewer_is_member: true },
+  { id: 30, title: 'Done one', status: 'achieved', viewer_is_member: true },
+  { id: 40, title: 'Also mine', status: 'open', viewer_is_member: true },
+];
+const ROWS = [
+  { id: 1, goal_id: 10, title: 'a1' },
+  { id: 2, goal_id: null, title: 'loose' },
+  { id: 3, goal_id: 20, title: 'm1' },
+  { id: 4, goal_id: 99, title: 'unknown goal' },
+  { id: 5, goal_id: 20, title: 'm2' },
+];
+
+await test('joined goals are the open ones the server says the viewer is a member of', () => {
+  assert.deepEqual(sg.joinedGoals(GOALS).map((g) => g.id), [20, 40]);
+});
+
+await test('groups: joined goals first, then other goals, then "Other work" last; every row exactly once', () => {
+  const groups = sg.groupByGoal(ROWS, GOALS);
+  assert.deepEqual(groups.map((g) => g.title), ['Mine', 'Alpha', 'Goal 99', sg.OTHER_WORK]);
+  assert.deepEqual(groups[0].rows.map((r) => r.id), [3, 5], 'server order kept inside a group');
+  assert.equal(groups[0].joined, true);
+  assert.equal(groups[3].goal_id, null);
+  const ids = groups.flatMap((g) => g.rows.map((r) => r.id)).sort();
+  assert.deepEqual(ids, [1, 2, 3, 4, 5]);
+});
+
+await test('with no goal list (a failed read) nothing is hidden: goals by id, goal-less under Other work', () => {
+  const groups = sg.groupByGoal(ROWS, []);
+  assert.equal(groups.flatMap((g) => g.rows).length, ROWS.length);
+  assert.equal(groups.at(-1).title, sg.OTHER_WORK);
+  assert.ok(groups.every((g) => !g.joined));
+});
+
+await test('joinedFirst moves the joined goals\' rows ahead of the cap and drops nothing', () => {
+  const out = sg.joinedFirst(ROWS, GOALS);
+  assert.deepEqual(out.map((r) => r.id), [3, 5, 1, 2, 4]);
+  assert.deepEqual(sg.joinedFirst(ROWS, []).map((r) => r.id), [1, 2, 3, 4, 5], 'no joined goal: order unchanged');
+});
+
+await test('"Your goals" counts claimable work per joined goal from the full set', () => {
+  const y = sg.yourGoals(GOALS, ROWS);
+  assert.deepEqual(y.goals, [
+    { id: '20', title: 'Mine', claimable: 2 },
+    { id: '40', title: 'Also mine', claimable: 0 },
+  ]);
+  assert.equal(y.more, 0);
+  assert.equal(sg.claimableWord(0), 'nothing to claim right now');
+  assert.equal(sg.claimableWord(2), '2 to claim');
+});
+
+await test('a builder in no goal gets no goals list, and the table still lists everything', () => {
+  const none = GOALS.map((g) => ({ ...g, viewer_is_member: false }));
+  assert.deepEqual(sg.yourGoals(none, ROWS).goals, []);
+  assert.equal(sg.groupByGoal(ROWS, none).flatMap((g) => g.rows).length, ROWS.length);
+});
+
+await test('start.js renders "Your goals" ABOVE the table and groups the table by goal (the wiring)', () => {
+  const fs = require('node:fs');
+  const src = fs.readFileSync(require.resolve('../scripts/gds/start.js'), 'utf8');
+  const goalsAt = src.indexOf("surface.strong('Your goals')");
+  const tableAt = src.indexOf("surface.strong('Claim one to start')");
+  assert.ok(goalsAt > 0 && goalsAt < tableAt, 'markdown: goals before the table');
+  const wGoals = src.indexOf('${goalsBlock}');
+  const wMenu = src.indexOf('<div class="bs-menuh">Claim one to start');
+  assert.ok(wGoals > 0 && wGoals < wMenu, 'widget: goals before the table');
+  assert.match(src, /claimableTable\(cardRows, [^)]*, goals\)/, 'the markdown table is grouped');
+  assert.equal((src.match(/\n\s+goals,\n\s+yourGoals,\n/g) || []).length, 2, 'both widget calls carry the goals');
+  assert.match(src, /startGoals\.joinedFirst\(filtered, goals\)\.slice\(0, limit\)/);
+});
+
+summary();