@bongos/core 1.21.76 → 1.21.78

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

@@ -31,7 +31,7 @@
   // below reads exactly as before; the single copy lives in task-lib.js.
   const {
     priorityRank, touchesConflict, rankTagHtml, deHashRefs,
-    creditsPerMinute, buildPromptForTask, friendlyBatchReason,
+    creditsPerMinute, buildPromptForTask, buildPlanPromptForGoal, friendlyBatchReason,
   } = window.OTBTaskLib;
   // Shared component kit (hall-kit.js, task 2166): pager, filter bar, tabs,
   // empty/skeleton states — adopted here by task 2171.
@@ -404,6 +404,18 @@
       } catch (_e) { return false; }
     }
   }
+  // task 1004587 (ADR 0366 D4) — the optional "Plan with Claude" hand-off; every planning form works without it.
+  async function planWithClaude() {
+    const d = state.details.get(String(state.current));
+    if (!d) return;
+    // The spec task is found in the goal's task list, so wait for it: copying early would hand back the fallback prompt for a goal that has a spec task.
+    if (!state.workLoaded) return toast("Still loading this goal's tasks. Try again in a moment.");
+    const g = d.goal;
+    const ok = await copyText(buildPlanPromptForGoal(g, state.work.todo));
+    toast(ok ? 'Prompt copied. Paste it into a Claude Code session to plan this goal.' : 'Could not copy to the clipboard. Try again.');
+  }
+  // The button is drawn by renderActions (which re-draws it), so the click is delegated.
+  document.addEventListener('click', (e) => { if (e.target.closest && e.target.closest('#goal-plan-btn')) planWithClaude(); });
   async function copyPromptForTask(taskId, btn) {
     const t = state.work.todo.find((x) => String(x.id) === String(taskId));
     if (!t) return;

package/modules/hall-ui/public/goals-render.js

@@ -962,7 +962,7 @@
     if (canManage && g.status === 'open') {
       parts.push('<button class="btn-ghost" id="goal-archive-btn" type="button" title="Retire this goal — you will be asked what happens to any unfinished work">Archive goal</button>');
     }
-    if (g.status === 'open') {
+    if (g.status === 'open') { parts.push('<button class="btn-ghost" id="goal-plan-btn" type="button" title="Copies a prompt to paste into a Claude Code session">Plan with Claude</button>'); // task 1004587
       if (joined) {
         parts.push('<button class="btn-ghost" id="goal-leave-btn" type="button">Leave goal</button>');
       } else if ((g.visibility === 'private' || g.scope_protected) && !isArchon()) {

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

@@ -497,7 +497,11 @@ body::after {
   z-index: var(--z-sidebar);
   display: flex;
   flex-direction: column;
-  background: var(--glass);
+  /* Glass laid over a solid ground: the rail opens OVER the top bar and the
+     content, and --glass in light is a 5% tint with no blur, so bare glass let
+     the page title read straight through the brand ("Builders' Hall" on top of
+     "profile"). Same fix as the board's bar. */
+  background: linear-gradient(var(--glass), var(--glass)), var(--bg);
   border-right: 1px solid var(--glass-edge);
   backdrop-filter: blur(var(--glass-blur));
   -webkit-backdrop-filter: blur(var(--glass-blur));

package/modules/hall-ui/public/task-lib.js

@@ -109,10 +109,15 @@
     return c / m;
   }
 
+  // Where the hall lives: the builders. subdomain's own origin, else the apex /builders tree.
+  function hallBaseUrl() {
+    return location.hostname.startsWith('builders.') ? location.origin : `${location.origin}/builders`;
+  }
+
   // The paste-into-your-agent prompt for one task.
   function buildPromptForTask(t) {
     const desc = deHashRefs((t.description || '').trim());
-    const hallBase = location.hostname.startsWith('builders.') ? location.origin : `${location.origin}/builders`;
+    const hallBase = hallBaseUrl();
     const hallUrl = `${hallBase}#/task/${t.id}`;
     return [
       `I am working on Bongos task ${t.id} (${t.title}) — ${hallUrl}`,
@@ -123,6 +128,20 @@
     ].join('\n');
   }
 
+  // task 1004587 (ADR 0366 D4) — the "Plan with Claude" prompt for one goal. When the
+  // goal has an unshipped spec task (source_ref goal-<id>-spec, made by the hall form)
+  // the prompt is that task's; otherwise it asks a session to run /goal-create against
+  // the goal. `todoTasks` is the goal's unshipped tasks. An extra, never a requirement.
+  function buildPlanPromptForGoal(goal, todoTasks) {
+    const spec = (todoTasks || []).find((t) => t.source_ref === `goal-${goal.id}-spec`);
+    if (spec) return buildPromptForTask(spec);
+    const hallBase = hallBaseUrl();
+    return [
+      `I want to plan Bongos goal ${goal.id} (${deHashRefs(goal.title || '')}) — ${hallBase}#/goal/${goal.id}`,
+      `Run /goal-create against this existing goal to add its seed tasks. Do not create a new goal.`,
+    ].join('\n');
+  }
+
   // Turn a batch-claim refusal into a sentence. THE DEFAULT MATTERS: an unmapped
   // code falls through to the raw string, which is how the missing MODULE_CONFLICT
   // case leaked a machine code into the Goals page UI. Adding a server-side reason
@@ -195,7 +214,7 @@
     focusVersionDefault,
     msOf, taskActivityMs, STALE_CHOICES, isStale,
     priorityRank, touchesConflict, conflictPeers, conflictChipHtml, rankTagHtml, deHashRefs,
-    creditsPerMinute, buildPromptForTask, friendlyBatchReason,
+    creditsPerMinute, buildPromptForTask, buildPlanPromptForGoal, friendlyBatchReason,
   };
   if (typeof window !== 'undefined') window.OTBTaskLib = api;
   if (typeof module !== 'undefined' && module.exports) module.exports = api;

package/package-lock.json

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

package/package.json

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

@@ -9266,5 +9266,17 @@
       "id": "1004499",
       "text": "Artists can now review the public website while looking at it. A signed-in builder on cloudbongos.com's public pages (home, projects, account, guilds, invitations, privacy, terms, contact) sees a Review button in the top bar,"
     }
+  ],
+  "1.21.77": [
+    {
+      "id": "1004638",
+      "text": "The hall sidebar now has a solid background, so the page title no longer shows through the Builders' Hall name in light mode."
+    }
+  ],
+  "1.21.78": [
+    {
+      "id": "1004587",
+      "text": "Goal pages now have a Plan with Claude button that copies a ready-made planning prompt."
+    }
   ]
 }

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.76'; // CI auto-patch carrier (ADR 0161); changelog: docs/module-api-changelog.md
+const CORE_VERSION = '1.21.78'; // 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/goal_plan_with_claude.mjs

@@ -0,0 +1,41 @@
+// tests/goal_plan_with_claude.mjs — the goal page's "Plan with Claude" hand-off (task 1004587, ADR 0366 D4).
+//
+// Run:  node --test tests/goal_plan_with_claude.mjs
+
+import assert from 'node:assert/strict';
+import { test } from 'node:test';
+import { readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+
+const require = createRequire(import.meta.url);
+globalThis.location = { hostname: 'builders.example.com', origin: 'https://builders.example.com' };
+const { buildPlanPromptForGoal, buildPromptForTask } = require('../modules/hall-ui/public/task-lib.js');
+const src = (rel) => readFileSync(new URL('../' + rel, import.meta.url), 'utf8');
+
+const goal = { id: 42, title: 'Ship the thing' };
+const spec = { id: 900, title: 'Spec goal 42: its scope', description: 'Do the interview.', source_ref: 'goal-42-spec' };
+const other = { id: 901, title: 'Other', description: 'x', source_ref: null };
+
+test('with an unshipped spec task the prompt is that task\'s', () => {
+  assert.equal(buildPlanPromptForGoal(goal, [other, spec]), buildPromptForTask(spec));
+});
+
+test('another goal\'s spec task is not this goal\'s', () => {
+  const p = buildPlanPromptForGoal(goal, [{ ...spec, source_ref: 'goal-43-spec' }]);
+  assert.match(p, /\/goal-create/);
+});
+
+test('without a spec task the prompt asks for /goal-create against the goal', () => {
+  const p = buildPlanPromptForGoal(goal, [other]);
+  assert.match(p, /\/goal-create/);
+  assert.match(p, /goal 42/);
+  assert.match(p, /#\/goal\/42/);
+  assert.equal(buildPlanPromptForGoal(goal, undefined), p);
+});
+
+test('the button is on the goal page and copies the goal prompt', () => {
+  const r = src('modules/hall-ui/public/goals-render.js');
+  const pg = src('modules/hall-ui/public/goals-page.js');
+  assert.match(r, /id="goal-plan-btn"/);
+  assert.ok(pg.includes('buildPlanPromptForGoal(g, state.work.todo)'));
+});