@staix/agent-hub 0.28.0 → 0.30.0

package/src/ui/index.html

@@ -257,6 +257,7 @@ details.settings-group .row:last-child{border-bottom:0}
 
 .office-scene{display:block;max-width:100%;height:auto;margin-inline:auto;font-family:system-ui,sans-serif;font-size:1px}.office-scene :is(rect,path,line,polygon,circle){vector-effect:non-scaling-stroke;stroke-width:1px}.office-room{fill:var(--panel-soft);stroke:var(--line)}.office-room-title{fill:var(--ink);font-size:1.083333px;font-weight:600}.office-room-count{fill:var(--ink);font-size:1px;font-family:ui-monospace,monospace;font-variant-numeric:tabular-nums}.office-header-surface{fill:var(--panel);stroke:var(--line)}.office-count-pill{fill:var(--panel);stroke:var(--line)}.office-desk-surface{fill:var(--panel);stroke:var(--line)}.office-desk.office-dimmed .office-avatar{opacity:.55}.office-name{fill:var(--ink);font-size:1.083333px;font-weight:600}.office-state,.office-meta,.office-empty{fill:var(--muted);font-size:1px}.office-glyph,.office-hand{font-size:1px}.office-idle .office-glyph{fill:var(--green)}.office-busy .office-glyph{fill:var(--amber)}.office-offline .office-glyph,.office-unknown .office-glyph{fill:var(--muted)}.office-paused .office-glyph{fill:var(--amber)}.office-waiting .office-glyph{fill:var(--red)}.office-hand{fill:var(--red)}.office-bubble{fill:var(--panel);stroke:var(--blue)}.office-bubble-text{fill:var(--ink);font-size:1px}.office-mode{fill:var(--muted);font-size:1px;font-family:ui-monospace,monospace}.office-card{fill:var(--control);stroke:var(--control-border)}.office-card-text{fill:var(--ink);font-size:1px}.office-card-id{font-family:ui-monospace,monospace}.office-card-accent{fill:var(--line)}.office-waiting-card .office-card-accent{fill:var(--waiting)}.office-rework-card .office-card-accent{fill:var(--red)}.office-card-checking .office-card-accent{fill:var(--blue)}.office-more{fill:var(--blue);font-size:1px}.office-scene .office-spotlight .office-desk-surface,.office-scene .office-spotlight .office-card,.office-scene [role="button"]:focus-visible > .office-card{stroke:var(--focus);stroke-width:2px}.office-card-hit{fill:transparent;stroke:none;pointer-events:all}.office-card-focus:focus-visible{outline:none}.row.spotlight{background:var(--hover)}
 
+.office-plan-shape{fill:none;stroke:var(--muted)}.office-reserved{fill:var(--peer-color);stroke:none}.office-dock-progress{fill:var(--blue);stroke:none}.office-release-dock:focus-visible .office-room{stroke:var(--focus);stroke-width:2px}
 .office-movable{transition:transform .8s ease}.office-arc .office-arc-path{fill:none;stroke:var(--blue);stroke-width:1px}.office-arc .office-arc-head{fill:var(--blue)}.office-arc-important .office-arc-path{stroke:var(--amber)}.office-arc-important .office-arc-head{fill:var(--amber)}.office-arc-dropped .office-arc-path{stroke:var(--red);stroke-dasharray:.6 .4}.office-arc-dropped .office-arc-head{fill:var(--red)}.office-arc-label{fill:var(--muted);font-size:1px}.office-alert{fill:var(--red);font-size:1px}.office-latch{fill:var(--amber);font-size:1px}.office-link-line{fill:none;stroke-width:1px;stroke-dasharray:.8 .5}.office-link-overlap .office-link-line{stroke:var(--amber)}.office-link-conflict .office-link-line{stroke:var(--red)}.office-link-cohort .office-link-line{stroke:var(--blue)}.office-link-label{font-size:1px;fill:var(--muted)}.office-link-conflict .office-link-label{fill:var(--red)}.office-link-overlap .office-link-label{fill:var(--amber)}.office-link-cohort .office-link-label{fill:var(--blue)}.office-checking{fill:var(--blue);font-size:.916667px}
 .office-avatar{fill:var(--muted)}.office-idle .office-avatar{fill:var(--dot-ok)}.office-busy .office-avatar{fill:var(--dot-warn)}.office-offline .office-avatar{fill:var(--dot)}.office-paused .office-avatar{fill:var(--dot-warn)}.office-waiting .office-avatar{fill:var(--amber)}.office-waiting .office-desk-surface{stroke:var(--amber)}.office-glyph-shape{fill:none;stroke-width:1px}.office-idle .office-glyph-shape{stroke:var(--dot-ok)}.office-busy .office-glyph-shape{stroke:var(--dot-warn);fill:var(--dot-warn)}.office-paused .office-glyph-shape{stroke:var(--dot-warn);fill:var(--dot-warn)}.office-offline .office-glyph-shape{stroke:var(--dot)}.office-handshape{fill:none;stroke:var(--dot-err);stroke-width:1px}.office-desk-leg{fill:var(--panel-soft);stroke:var(--line);stroke-width:1px}.office-nameplate{fill:var(--control);stroke:var(--control-border);stroke-width:1px}.office-room-wire{fill:none;stroke:var(--line);stroke-width:1px}.office-divider{fill:none;stroke:var(--line);stroke-width:1px}.office-shelf{fill:var(--panel-soft);stroke:var(--line);stroke-width:1px}.office-shelf-card{fill:var(--green-soft);stroke:var(--green);stroke-width:1px}.office-box-top{fill:var(--control);stroke:var(--control-border);stroke-width:1px}.office-box-left{fill:var(--panel-soft);stroke:var(--line);stroke-width:1px}.office-box-right{fill:var(--panel);stroke:var(--line);stroke-width:1px}.office-busy .office-glyph,.office-hand{animation:office-pulse 1.2s ease-in-out infinite}.office-appear{animation:office-appear .5s ease-out}.office-leaving{pointer-events:none;animation:office-fade .4s linear forwards}.office-fadeout{animation-name:office-fade;animation-duration:1s;animation-timing-function:linear;animation-fill-mode:forwards}.office-settle .office-movable{transition:none}.office-settle .office-appear{animation:none}
 @keyframes office-pulse{50%{opacity:.45}}@keyframes office-appear{from{opacity:0}}@keyframes office-fade{to{opacity:0}}
@@ -498,12 +499,14 @@ main[data-stale]>:not(#notice):not(#disconnected){opacity:.6;transition:opacity
 </div>
 </div>
 </section>
+<section id="worktrees-section" aria-labelledby="worktrees-title" data-view="agents" hidden><div class="section-head"><h2 id="worktrees-title">Worktrees</h2><span id="worktrees-count" class="meta"></span></div><div id="worktrees"></div></section>
 <section aria-labelledby="bench-title" data-view="agents" hidden><div class="section-head"><h2 id="bench-title">Benchmarks</h2><span id="bench-count" class="meta"></span></div><div id="bench"></div></section>
 </div>
 </main>
 </div>
 </div>
 <dialog id="plan-dialog" aria-labelledby="plan-title"><div class="dialog-head"><h2 id="plan-title">Plan</h2><button type="button" id="plan-close" aria-label="Close plan sheet"><svg class="icon" aria-hidden="true" focusable="false"><use href="#i-close"/></svg></button></div>
+<section class="plan-block" aria-labelledby="plan-h-intake"><h3 id="plan-h-intake">Capture a request</h3><form id="intake"><div class="field"><label for="intake-text">What should the team do?</label><textarea id="intake-text" required maxlength="7000" aria-describedby="intake-help intake-result"></textarea></div><div class="field"><label for="intake-sources">Source IDs (optional)</label><input id="intake-sources" maxlength="400" aria-describedby="intake-help intake-result"></div><p id="intake-help" class="meta">Creates draft Backlog cards, held until approval. Use registered src: IDs separated by spaces or commas. Approve or discard with ahub intake in a terminal.</p><button id="intake-submit" class="primary" data-mutation="project" type="submit">Create draft</button><p id="intake-result" class="meta" role="status" aria-live="polite" tabindex="-1"></p></form><div class="field"><h4>Registered sources (read-only)</h4><div id="sources" class="content"><p class="empty">Waiting for a project snapshot.</p></div></div></section>
 <section class="plan-block" aria-labelledby="plan-h-plan"><h3 id="plan-h-plan">Plan a task</h3><form id="planning"><div class="field"><label for="planning-task">Task</label><select id="planning-task"><option value="">Select task</option></select></div><div class="split"><label>Priority<select id="planning-priority"><option value="">Default</option><option value="0">P0</option><option value="1">P1</option><option value="2">P2</option><option value="3">P3</option></select></label><label>Order<input id="planning-rank" type="number" min="0" step="1"></label><label>Release<select id="planning-release"><option value="">No release</option></select></label><label>Planned start<input id="planning-start" type="datetime-local" step="any"></label><label>Due<input id="planning-due" type="datetime-local" step="any"></label></div><label><input id="planning-pinned" type="checkbox">Pin against planner changes</label><label>Reason<input id="planning-reason" maxlength="1000" required></label><div class="actions"><button id="planning-save" type="submit" data-mutation="project">Save plan</button><button id="planning-undo" type="button" data-mutation="project">Undo latest plan</button><button id="planning-reload" type="button">Reload current values</button></div><p id="planning-version" class="meta"></p></form></section><section id="split-panel" class="plan-block" aria-labelledby="plan-h-split" hidden><h3 id="plan-h-split">Split the selected backlog task</h3><form id="split-backlog"><label>Part titles, one per line<textarea id="split-titles" maxlength="2408" required></textarea></label><label><input id="split-sequential" type="checkbox">Each part waits for the previous part</label><label>Reason<input id="split-reason" maxlength="1000" required></label><p class="meta">Two to eight parts. The original task retains integration and acceptance. Unused parts can be undone from its current plan.</p><button id="split-save" type="submit" data-mutation="project">Stage parts</button></form></section><section class="plan-block" aria-labelledby="plan-h-releases"><h3 id="plan-h-releases">Releases</h3><div id="releases" class="content"></div><form id="release-new"><div class="split"><label>Name<input id="release-name" maxlength="64" required></label><label>Order<input id="release-order" type="number" min="0" value="0" step="1" required></label></div><label>Goal<input id="release-goal" maxlength="1000" required></label><button type="submit" data-mutation="project">Create release</button></form><form id="release-plan"><label>Release<select id="release-edit"><option value="">Select release</option></select></label><div class="split"><label>Planned start<input id="release-start" type="datetime-local" step="any"></label><label>Cut<input id="release-cut" type="datetime-local" step="any"></label><label>Ship<input id="release-ship" type="datetime-local" step="any"></label></div><button id="release-save" type="submit" data-mutation="project">Save dates</button><button id="release-reload" type="button">Reload current release</button><p id="release-version" class="meta"></p></form></section><section id="delivery" class="plan-block" aria-labelledby="plan-h-delivery"><h3 id="plan-h-delivery">Delivery evidence (read-only)</h3><div class="field"><label for="delivery-repo">GitHub repository</label><input id="delivery-repo" maxlength="200" placeholder="owner/repository"></div><div class="field"><label for="delivery-live">Live verification issue IDs (optional)</label><input id="delivery-live" maxlength="300" placeholder="Comma-separated issue numbers"></div><div class="actions"><button id="delivery-queue" type="button">Read merge queue</button><button id="delivery-release" type="button">Read release checklist</button></div><pre id="delivery-report" class="body" aria-live="polite"></pre></section><section class="plan-block" aria-labelledby="plan-h-propose"><h3 id="plan-h-propose">Propose a task</h3><form id="propose"><div class="field"><label for="title">Title</label><input id="title" name="title" required maxlength="300" placeholder="What should the team do?"></div><div class="field"><label for="detail">Details (optional)</label><textarea id="detail" name="detail" maxlength="8000"></textarea></div><div class="split"><div class="field"><label for="class">Class</label><select id="class" name="class"><option>implement</option><option>plan</option><option>bulk_edit</option><option>test</option><option>review</option><option>summarize</option><option>triage</option></select></div><div class="field"><label for="owner">Owner</label><select id="owner" name="owner"><option value="">Automatic</option></select></div></div><label><input id="backlog-proposal" type="checkbox"> Add to Backlog without offering</label><button class="primary" data-mutation="project" type="submit">Propose task</button></form></section>
 </dialog>
 <dialog id="task-detail-dialog" aria-labelledby="task-detail-title"><div class="dialog-head"><h2 id="task-detail-title">Task details</h2><button id="task-detail-close" type="button" autofocus>Close details</button></div><div id="task-detail-content"></div></dialog>
@@ -675,6 +678,7 @@ function saveDraft() {
   const previous = drafts.get(selectedProjectId) || {};
   drafts.set(selectedProjectId, {message:$('message').value, recipient:draftChoicesPending ? previous.recipient || '' : $('recipient').value,
     ...($('backlog-proposal')?.checked ? {backlog:true} : {}), title:$('title').value, detail:$('detail').value, class:$('class').value, owner:draftChoicesPending ? previous.owner || '' : $('owner').value});
+  drafts.get(selectedProjectId).intake = $('intake-text').value; drafts.get(selectedProjectId).intakeSources = $('intake-sources').value;
 }
 function restoreDraft(choices = false) {
   const draft = drafts.get(selectedProjectId) || {};
@@ -682,6 +686,7 @@ function restoreDraft(choices = false) {
   if (choices) {
     for (const id of ['recipient','owner']) $(id).value = Array.from($(id).options).some((o) => o.value === draft[id]) ? draft[id] : '';
   } else { $('message').value = draft.message || ''; $('title').value = draft.title || ''; $('detail').value = draft.detail || ''; $('class').value = draft.class || 'implement'; }
+  if (!choices) { $('intake-text').value = draft.intake || ''; $('intake-sources').value = draft.intakeSources || ''; }
 }
 function syncMutationControls() { document.querySelectorAll('button[data-mutation="project"]').forEach((b) => { b.disabled = pendingButtons.has(b) || Boolean(b.dataset.startKey && pendingStarts.has(b.dataset.startKey)) || (managerMode && !snapshotValid); }); }
 // The first-load blocks the page ships in #tasks and #peers (#296): a project switch puts copies of them back and update() replaces them
@@ -703,9 +708,10 @@ function resetView(id, instance) {
   $('split-titles').value='';$('split-reason').value='';$('split-sequential').checked=false;
   $('release-name').value='';$('release-goal').value='';$('release-order').value='0';
   $('delivery-report').textContent = ''; $('delivery-repo').value = ''; $('delivery-live').value = '';
+  $('intake-result').textContent = ''; $('intake-text').setAttribute('aria-invalid', 'false'); $('intake-sources').setAttribute('aria-invalid', 'false');
   // A project with a running instance is polled next, so the board and the peers show loading; "No project selected" is for no project.
   const loading = Boolean(id && instance) && typeof firstLoad !== 'undefined';
-  for (const [id, text] of [['memory-list','No project selected.'],['memory-graph',''],['memory-detail',''],['peers','No project selected.'],['tasks','No project selected.'],['task-progress','No project selected.'],['permissions','No project selected.'],['budget','No project selected.'],['settings','No project selected.']]) {
+  for (const [id, text] of [['memory-list','No project selected.'],['memory-graph',''],['memory-detail',''],['peers','No project selected.'],['tasks','No project selected.'],['task-progress','No project selected.'],['permissions','No project selected.'],['budget','No project selected.'],['settings','No project selected.'],['sources','No project selected.']]) {
     $(id).replaceChildren();
     if (loading && firstLoad[id]?.length) $(id).replaceChildren(...firstLoad[id].map((node) => node.cloneNode(true)));
     else if (text) empty($(id), text);
@@ -1457,6 +1463,44 @@ function renderBoard(snapshot, peers, ids) {
   });
   refreshTaskDetail();
 }
+function renderSources(sources) {
+  update('sources', sources ?? null, target => {
+    if (!Array.isArray(sources)) return empty(target, 'Source list unavailable for this project snapshot.');
+    if (!sources.length) return empty(target, 'No registered sources. Register a file or URL with ahub source add.');
+    for (const source of sources) {
+      const row = el('div', undefined, 'row'), head = el('div', undefined, 'row-head');
+      head.append(el('code', source.id, 'label'), el('span', source.kind, 'meta'));
+      const registered = Number.isSafeInteger(source.added_at) ? new Date(source.added_at).toLocaleString() : 'unknown';
+      row.append(head, el('p', source.bytes + ' bytes · hash ' + source.hashPrefix + ' · registered ' + registered, 'meta'));
+      target.append(row);
+    }
+  });
+}
+function intakeFeedback(text, error = false) {
+  const result = $('intake-result'); result.textContent = text; result.classList.toggle('error', error);
+}
+async function submitIntake(event) {
+  event.preventDefault();
+  const submit = event.submitter || $('intake-submit');
+  if (pendingButtons.has(submit) || stopped) return;
+  const text = $('intake-text').value.trim(), sourceText = $('intake-sources').value.trim();
+  const sources = sourceText ? sourceText.split(/[\s,]+/).filter(Boolean) : [];
+  $('intake-text').setAttribute('aria-invalid', 'false'); $('intake-sources').setAttribute('aria-invalid', 'false');
+  const invalid = !text || text.length > 7000 ? 'intake-text' : sources.length > 16 || new Set(sources).size !== sources.length || sources.some(id => !/^src:[0-9a-f]{16}$/.test(id)) ? 'intake-sources' : '';
+  if (invalid) {
+    intakeFeedback(invalid === 'intake-text' ? 'Enter a request of 1 to 7000 characters.' : 'Use at most 16 distinct registered src: IDs; run ahub source list to check them.', true);
+    $(invalid).setAttribute('aria-invalid', 'true'); $(invalid).focus(); return;
+  }
+  const captured = context();
+  intakeFeedback('Creating draft. Waiting for the hub result...');
+  const accepted = await action({action:'intake', text, sources}, submit);
+  const current = context();
+  if (stopped || captured.generation !== current.generation || captured.projectId !== current.projectId || captured.instanceId !== current.instanceId) return;
+  if (accepted) {
+    if ($('intake-text').value.trim() === text && $('intake-sources').value.trim() === sourceText) { $('intake-text').value = ''; $('intake-sources').value = ''; }
+    intakeFeedback('Draft saved to Backlog. Inspect it there; approve or discard with ahub intake in a terminal.');
+  } else intakeFeedback('Intake was not confirmed. Read the notice and check Backlog before submitting again.', true);
+}
 const attentionBaseTitle = typeof document === 'undefined' ? 'agent-hub | Local dashboard' : document.title;
 let attentionSignature = '', attentionFirst;
 function reachAttention() {
@@ -1745,7 +1789,7 @@ function render(snapshot) {
       const current = (snapshot.boardLegend || []).find(item => item.peer === id)?.activeTasks, summary = el('p', undefined, 'peer-summary');
       summary.append(el('span', peer.queued + ' queued' + (peer.queuedImportant ? ' (' + peer.queuedImportant + ' important)' : ''), 'meta'), el('span', Array.isArray(current) && current.length ? 'Working on ' + current.map(task => '#' + task).join(', ') : 'No active task', 'meta'));
       // #878: the session title or current plan item the hub observed, already screened (a stub while private).
-      if (typeof peer.doing?.text === 'string' && peer.doing.text) summary.append(el('span', 'Doing: ' + peer.doing.text, 'meta'));
+      if (typeof peer.doing?.text === 'string' && peer.doing.text) summary.append(el('span', (peer.doing.source === 'label' ? 'Unnamed session: ' : 'Doing: ') + peer.doing.text, 'meta'));
       row.append(head, summary);
       // A status notice asks a person to act (for example, reattach a native session): it stays visible, never folded away.
       if (typeof peer.statusNotice?.message === 'string' && peer.statusNotice.message) row.append(el('p', peer.statusNotice.message, 'meta notice-warn'));
@@ -1783,6 +1827,7 @@ function render(snapshot) {
   const peerSignature = JSON.stringify([ids, assignable]);
   if (signatures.get('peer-options') !== peerSignature) { signatures.set('peer-options', peerSignature); peerOptions($('owner'), assignable, 'Automatic'); peerOptions($('recipient'), ids, 'All peers'); if (draftChoicesPending) { restoreDraft(true); draftChoicesPending = false; } }
   renderBoard(snapshot, peers, ids);
+  renderSources(snapshot.sources);
   renderApprovals(snapshot.permissions);
   update('budget', snapshot.budget, (target) => {
     if (!Object.keys(snapshot.budget).length) return empty(target, 'No usage readings yet. Usage appears when a peer reports it.');
@@ -1810,6 +1855,7 @@ function render(snapshot) {
     }
   });
   renderBench(snapshot.bench);
+  renderWorktrees(snapshot.worktrees);
   renderMemory(snapshot.memory);
   renderSettings(snapshot.settings, snapshot.roster);
   renderUsage(snapshot.usage, snapshot.tasks, snapshot.budget);
@@ -1879,7 +1925,7 @@ function officeTile(w, h, cls) {
 }
 function officeViewBox(w, h, model) {
   if (officeProjection !== 'iso') return '0 0 ' + w + ' ' + h;
-  const corners = model ? [...model.rooms, ...model.desks].flatMap(tile => [officeProject(tile.x, tile.y), officeProject(tile.x + tile.w, tile.y), officeProject(tile.x, tile.y + tile.h), officeProject(tile.x + tile.w, tile.y + tile.h)].map(([x, y]) => [x, y + (model.rooms.includes(tile) ? officeRoomOffset : 0)])) : [officeProject(0, 0), officeProject(w, 0), officeProject(0, h), officeProject(w, h)];
+  const corners = model ? [...model.rooms, ...(model.docks || []), ...model.desks].flatMap(tile => [officeProject(tile.x, tile.y), officeProject(tile.x + tile.w, tile.y), officeProject(tile.x, tile.y + tile.h), officeProject(tile.x + tile.w, tile.y + tile.h)].map(([x, y]) => [x, y + (model.desks.includes(tile) ? 0 : officeRoomOffset)])) : [officeProject(0, 0), officeProject(w, 0), officeProject(0, h), officeProject(w, h)];
   const xs = corners.map((p) => p[0]), ys = corners.map((p) => p[1]), m = 3;
   const minX = Math.min(...xs), minY = Math.min(...ys);
   return (minX - m) + ' ' + (minY - 6) + ' ' + (Math.max(...xs) - minX + 2 * m) + ' ' + (Math.max(...ys) - minY + 9);
@@ -1934,16 +1980,16 @@ function officeClip(text, max) {
 }
 let officeClipSerial = 0;
 let officeMeasureContext;
-function officeTextWidth(value, monospace) {
+function officeTextWidth(value, monospace, size = OFFICE_SCALE, weight = '') {
   if (officeMeasureContext === undefined) {
     try { officeMeasureContext = document.createElement('canvas').getContext?.('2d') || null; } catch { officeMeasureContext = null; }
   }
   if (officeMeasureContext) {
-    officeMeasureContext.font = OFFICE_SCALE + 'px ' + (monospace ? 'ui-monospace,monospace' : 'system-ui,sans-serif');
+    officeMeasureContext.font = (weight ? weight + ' ' : '') + size + 'px ' + (monospace ? 'ui-monospace,monospace' : 'system-ui,sans-serif');
     return officeMeasureContext.measureText(value).width;
   }
   // Non-browser fixtures or unavailable canvas: conservative glyph widths; clipPath is the hard boundary.
-  return [...value].reduce((width, char) => width + (!/^[ -~]$/.test(char) ? 1 : monospace ? 0.6 : /[MW@#%]/.test(char) ? 0.9 : /[ilI., ']/.test(char) ? 0.3 : 0.55), 0) * OFFICE_SCALE;
+  return [...value].reduce((width, char) => width + (!/^[ -~]$/.test(char) ? 1 : monospace ? 0.6 : /[MW@#%]/.test(char) ? 0.9 : /[ilI., ']/.test(char) ? 0.3 : 0.55), 0) * size;
 }
 function officeCardLabel(card, width) {
   const prefix = '#' + card.id, rest = String(card.label).slice(prefix.length);
@@ -1990,6 +2036,7 @@ function spotlightRow(row) { if (spotlitRow && spotlitRow !== row) spotlitRow.cl
 function activateOfficePeer(id) { switchView('agents'); const row = peerRows.get(id); if (!row) return; spotlightRow(row); row.scrollIntoView({ block: 'nearest' }); row.focus?.(); }
 function activateOfficeTask(id) { setColumnFocus(null); if (!taskRows.has(id)) officeFilter(''); const row = taskRows.get(id); if (!row) return; spotlightRow(row); row.scrollIntoView({ block: 'nearest' }); openTaskDetail(id); }
 function officeFilter(state) { $('task-filter').value = state; $('task-peer-filter').value = ''; $('task-release-filter').value = ''; if (!stopped && snapshotValid && lastSnapshot) render(lastSnapshot); }
+function officeRelease(id) { setColumnFocus(null); $('task-filter').value = ''; $('task-peer-filter').value = ''; $('task-release-filter').value = id == null ? '' : String(id); if(id == null)$('task-lanes').value = 'releases'; if (!stopped && snapshotValid && lastSnapshot) render(lastSnapshot); switchView('board'); $('tasks').scrollIntoView({block:'nearest'}); }
 // Fade timing for a transient mark: it holds, then fades over the final second so it is gone at `until`.
 // Applied once at creation; later renders leave the running animation alone.
 function officeFade(node, until, now) {
@@ -2006,16 +2053,25 @@ function officeFade(node, until, now) {
 function officeCardPaint(node, card) {
   node.setAttribute('class', 'office-card-node office-movable' + (card.waiting ? ' office-waiting-card' : '') + (card.rework ? ' office-rework-card' : '') + (card.checking ? ' office-card-checking' : ''));
   node.setAttribute('aria-label', card.name);
-  const innerWidth = Math.max(0.1, card.w - 1.6 - (card.checking ? 1 : 0));
+  const innerWidth = Math.max(0.1, card.w - 1.6 - (card.checking ? 1 : 0) - (card.releaseTag ? 1.8 : 0));
   const label = officeCardLabel(card, innerWidth * OFFICE_SCALE), prefix = '#' + card.id, clipId = node.dataset.officeClipId || (node.dataset.officeClipId = 'office-card-clip-' + (++officeClipSerial));
   const clip = officeNode('clipPath', { id: clipId, clipPathUnits: 'userSpaceOnUse' });
   clip.append(officeNode('rect', { x: 0.8, y: 0, width: innerWidth, height: card.h }));
   const text = officeNode('text', { x: 0.8, y: card.h / 2 + 0.33, class: 'office-card-text', 'clip-path': 'url(#' + clipId + ')' });
+  const marked = card.reserved || card.pinned || card.waiting && card.state === 'backlog';
+  if(marked)text.setAttribute('y','0.95');
   text.append(officeNode('tspan', { class: 'office-card-id' }, prefix), officeNode('tspan', {}, label.slice(prefix.length)));
   const children = [officeNode('title', {}, card.label), clip,
     officeNode('rect', { x: 0, y: 0, width: card.w, height: card.h, rx: 0.5, class: 'office-card' }),
     officeNode('rect', { x: 0.15, y: 0.25, width: 0.2, height: Math.max(0.4, card.h - 0.5), rx: 0.1, class: 'office-card-accent' }), text];
   if (card.checking) children.push(officeIcon('i-check', card.w - 1.5, card.h / 2 - 0.46, 0.92, 'office-checking'));
+  const marks=[]; let mx=0.8;
+  const mark=(shape,label)=>{const g=officeNode('g',{});shape.setAttribute('transform','translate('+mx+',1.35)');g.append(shape,officeNode('text',{x:mx+0.85,y:2.05,class:'office-meta'},label));marks.push(g);mx+=0.85+officeTextWidth(label,false)/OFFICE_SCALE+0.6;};
+  if(card.reserved){const key=Object.hasOwn(peerPalette,card.reserved)?card.reserved:'other';mark(officeNode('circle',{cx:0.3,cy:0.3,r:0.25,class:'office-reserved peer-'+key}),officeClip(card.reserved,8));}
+  if(card.pinned)mark(officeNode('path',{d:'M0 0H.6L.45 .4H.15ZM.3 .4V.8',class:'office-plan-shape'}),'pin');
+  if(card.waiting && card.state==='backlog')mark(officeNode('path',{d:'M.3 0 .65 .65H0Z',class:'office-plan-shape'}),'waits'+(card.plannedDate?' '+card.plannedDate:''));
+  if(marks.length){const group=officeNode('g',{'clip-path':'url(#'+clipId+')',class:'office-card-marks'});group.append(...marks);children.push(group);}
+  if(card.releaseTag)children.push(officeNode('text',{x:card.w-0.6,y:marked?0.95:card.h/2+0.33,'text-anchor':'end',class:'office-meta'},'R'+card.releaseTag.ordinal));
   node.replaceChildren(...children);
 }
 function officeDeskPaint(node, desk) {
@@ -2064,6 +2120,7 @@ function officeDeskPaint(node, desk) {
   if (desk.tray.needsReview) tray.push(desk.tray.needsReview + ' to review');
   if (desk.tray.heldBy) tray.push('held by ' + desk.tray.heldBy);
   if (tray.length) children.push(officeNode('text', { x: 1, y: line, class: 'office-meta' }, officeClip(tray.join(' / '), 38)));
+  if(desk.planner){const badge=officeNode('g',{class:'office-planner','aria-label':'planner, '+desk.unplanned+' unplanned backlog cards'});badge.append(officeNode('path',{d:'M7 5H8V6H7ZM7.5 6V6.5',class:'office-plan-shape'}),officeNode('text',{x:8.4,y:6,class:'office-meta'},String(desk.unplanned)));children.push(badge);}
   node.replaceChildren(...children);
 }
 // More is a sibling of the desk button, so assistive technology exposes both targets.
@@ -2082,6 +2139,7 @@ function officeRoomHeader(node, room) {
   node.replaceChildren(...(iso ? [officeNode('rect', { x: -0.5, y: -2.55, width: 12.5, height: 2, rx: 0.5, class: 'office-header-surface' })] : []), officeNode('text', { x: iso ? 0 : 1, y, class: 'office-room-title' }, room.label),
     officeNode('rect', { x: right - 3, y: y - 1.35, width: 3, height: 2, rx: 0.5, class: 'office-count-pill' }),
     officeNode('text', { x: right - 1.5, y, 'text-anchor': 'middle', class: 'office-room-count' }, String(room.count)));
+  if(room.unplanned!==undefined)node.append(officeNode('text',{x:iso?0:1,y:y+1.15,class:'office-meta'},room.unplanned+' unplanned'));
 }
 function officeRoomPaint(node, room) {
   node.setAttribute('class', 'office-roombox office-roombox-' + room.id);
@@ -2095,12 +2153,21 @@ function officeRoomPaint(node, room) {
     const at = iso ? officeIsoLocal(room.w / 2, room.h - 1.5) : [1, room.h - 1];
     const more = officeNode('g', { tabindex: '0', role: 'button', 'aria-label': 'Show ' + room.overflow + ' more ' + room.filterState.replaceAll('_', ' ') + ' tasks in the task list' });
     more.append(officeNode('text', { x: at[0], y: at[1], 'text-anchor': iso ? 'middle' : 'start', class: 'office-more' }, '+' + room.overflow + ' more'));
-    const open = () => officeFilter(room.filterState);
+    const open = () => { setColumnFocus(null); officeFilter(room.filterState); switchView('board'); };
     more.addEventListener('click', open);
     more.addEventListener('keydown', (event) => officeKeys(event, open));
     node.append(more);
   }
 }
+function officeDockPaint(node,dock) {
+  officePlace(node,dock.x,dock.y,true);node.setAttribute('class','office-release-dock');node.setAttribute('aria-label','Release '+dock.ordinal+': '+dock.name+', '+dock.state+', '+dock.approved+' / '+dock.scope+' approved'+(dock.cut?', cut '+dock.cut:''));
+  const iso=officeProjection==='iso',at=iso?officeIsoLocal(dock.w/2,7):[1,5],x=at[0],y=at[1],align=iso?'middle':'start';
+  const full='R'+dock.ordinal+' '+dock.name,width=dock.w-2,chars=[...full],measure=value=>officeTextWidth(value,false,13,'600');let title=full;
+  if(measure(title)>width*OFFICE_SCALE){let low=0,high=chars.length;while(low<high){const mid=Math.ceil((low+high)/2);if(measure(chars.slice(0,mid).join('')+'...')<=width*OFFICE_SCALE)low=mid;else high=mid-1;}title=chars.slice(0,low).join('').trimEnd()+'...';}
+  const clipId=node.dataset.officeDockClipId || (node.dataset.officeDockClipId='office-dock-clip-'+(++officeClipSerial)),clip=officeNode('clipPath',{id:clipId,clipPathUnits:'userSpaceOnUse'});clip.append(officeNode('rect',{x:iso?x-width/2:x,y:y-1.15,width,height:1.5}));
+  node.replaceChildren(officeTile(dock.w,dock.h,'office-room'),officeNode('title',{},full),clip,officeNode('text',{x,y,'text-anchor':align,class:'office-room-title office-dock-title','clip-path':'url(#'+clipId+')'},title),officeNode('text',{x,y:y+1.5,'text-anchor':align,class:'office-meta'},dock.state+' · '+dock.approved+' / '+dock.scope),officeNode('rect',{x:iso?x-5:1,y:y+2.3,width:10,height:0.3,class:'office-count-pill'}),officeNode('rect',{x:iso?x-5:1,y:y+2.3,width:10*dock.ratio,height:0.3,class:'office-dock-progress'}));
+  if(dock.cut)node.append(officeNode('text',{x,y:y+4,'text-anchor':align,class:'office-meta'},'Cut '+dock.cut));
+}
 let officeScene = null;
 function officeEnsure(target) {
   if (officeScene) return officeScene;
@@ -2163,6 +2230,11 @@ function drawOffice(target, model) {
     const visible = roomCards.get(original.id), room = { ...original, cards: visible, overflow: original.overflow + original.cards.length - visible.length };
     keep('room:' + room.id, JSON.stringify({ ...room, cards: undefined, visibleCount: room.cards.length }), scene.layers.rooms, (node) => officeRoomPaint(node, room), false);
   }
+  for(const dock of model.docks || []){
+    const {node,fresh}=keep('dock:'+dock.id,JSON.stringify(dock),scene.layers.rooms,n=>officeDockPaint(n,dock),false);
+    if(fresh&&!node.getAttribute('tabindex')){node.setAttribute('tabindex','0');node.setAttribute('role','button');const open=()=>officeRelease(dock.id);node.addEventListener('click',open);node.addEventListener('keydown',event=>officeKeys(event,open));}
+  }
+  if(model.extraReleases>0 && model.docks.length){const dock=model.docks.at(-1);const {node,fresh}=keep('dock:more',JSON.stringify([dock,model.extraReleases]),scene.layers.headers,n=>{officePlace(n,dock.x,dock.y,true);n.setAttribute('aria-label','Show '+model.extraReleases+' more releases');const at=officeProjection==='iso'?officeIsoLocal(dock.w/2,dock.h-2):[1,dock.h-2];n.replaceChildren(officeNode('text',{x:at[0],y:at[1],class:'office-more'},'+'+model.extraReleases+' releases'));},false);if(fresh&&!node.getAttribute('tabindex')){node.setAttribute('tabindex','0');node.setAttribute('role','button');const open=()=>officeRelease(null);node.addEventListener('click',open);node.addEventListener('keydown',event=>officeKeys(event,open));}}
   const deskCards = new Map(model.desks.map(desk => [desk.id, officeDeskCards(desk)]));
   for (const original of model.desks) {
     const visible = deskCards.get(original.id), desk = { ...original, cards: visible, extraCards: original.extraCards + original.cards.length - visible.length };
@@ -2194,7 +2266,7 @@ function drawOffice(target, model) {
   };
   const paintNodes = [], focusNodes = [];
   for (const card of cards) {
-    const { node } = keep('paint:card:' + card.id, JSON.stringify([card.label, card.name, card.waiting, card.rework, card.checking, card.w, card.h]), scene.layers.cards, n => { officeCardPaint(n, card); n.setAttribute('aria-hidden', 'true'); });
+    const { node } = keep('paint:card:' + card.id, JSON.stringify([card.label, card.name, card.waiting, card.rework, card.checking, card.reserved, card.pinned, card.plannedDate, card.releaseTag, card.w, card.h]), scene.layers.cards, n => { officeCardPaint(n, card); n.setAttribute('aria-hidden', 'true'); });
     paintNodes.push(node); placeCard(node, card);
   }
   for (const card of focusCards) {
@@ -2211,7 +2283,7 @@ function drawOffice(target, model) {
     focusNodes.push(node); placeCard(node, card);
   }
   officeOrderNodes(scene.layers.cards, paintNodes); officeOrderNodes(scene.layers.cardFocus, focusNodes);
-  for (const room of model.rooms) keep('header:' + room.id, JSON.stringify([room.x, room.y, room.w, room.count, room.label]), scene.layers.headers, node => officeRoomHeader(node, room), false);
+  for (const room of model.rooms) keep('header:' + room.id, JSON.stringify([room.x, room.y, room.w, room.count, room.label,room.unplanned]), scene.layers.headers, node => officeRoomHeader(node, room), false);
   if (model.extraPeers > 0) {
     keep('extra:peers', String(model.extraPeers) + ':' + model.width, scene.layers.marks,
       (node) => { officePlace(node, model.width, 0); node.replaceChildren(officeNode('text', { x: 0, y: 1.8, 'text-anchor': 'end', class: 'office-meta' }, '+' + model.extraPeers + ' peers')); }, false);
@@ -2299,6 +2371,56 @@ let streamFilter = '';
 function applyStreamFilter(node) { node.hidden = streamFilter !== '' && node.dataset.kind !== streamFilter; }
 function refreshStreamEmpty() { const has = $('stream').querySelector('.event:not([hidden])') !== null, any = $('stream').querySelector('.event') !== null; $('stream-empty').hidden = has || !any; }
 // #251: benchmark runs on this machine and arm comparisons per suite. Every bar carries its number as text.
+/* #1057: the worktree shelf. A panel refresh reads nothing from GitHub: the rows come from the hub's cached facts, and only the explicit 'Refresh PR states' button asks it to read PR states. Removal is never a button: the panel shows the command to run in a terminal. */
+function renderWorktrees(shelf) {
+  const live = shelf && Array.isArray(shelf.live) ? shelf.live : [], settled = shelf && Array.isArray(shelf.settled) ? shelf.settled : [];
+  const known = Boolean(shelf) && !shelf.unavailable && !shelf.pending;
+  $('worktrees-count').textContent = known ? live.length + ' live, ' + settled.length + ' settled' : '';
+  update('worktrees', shelf === undefined ? null : shelf, (target) => {
+    if (shelf === undefined) return empty(target, 'Worktrees are shown on a current snapshot.');
+    if (shelf.pending) return empty(target, 'Reading worktrees...');
+    if (shelf.unavailable) return empty(target, 'Worktrees unavailable: git could not list this project\'s worktrees, or the hub is restarting.');
+    const reasonText = {merged: 'PR merged', closed: 'PR closed', quiet: 'quiet for ' + (shelf.quietDays || 0) + '+ days', parked: 'parked by you'};
+    const group = (title, rows, isSettled) => {
+      const block = el('div', undefined, 'row'), head = el('div', undefined, 'row-head');
+      head.append(el('span', title + ' (' + rows.length + ')', 'label'));
+      block.append(head);
+      if (!rows.length) block.append(el('p', isSettled ? 'Nothing settled.' : 'No live worktrees.', 'meta'));
+      for (const item of rows) {
+        const line = el('div', undefined, 'row-head'), name = el('span', String(item.path), 'label');
+        line.append(name);
+        if (item.branch) line.append(el('span', String(item.branch), 'meta'));
+        if (item.task !== undefined) line.append(badge('#' + item.task + (item.taskState ? ' ' + item.taskState : '')));
+        if (item.pr !== undefined) line.append(badge('PR ' + item.pr));
+        if (isSettled && item.reason) line.append(badge(reasonText[item.reason] || String(item.reason), item.reason === 'parked' ? '' : 'ok'));
+        if (item.outside) line.append(badge('outside project'));
+        // `rel` and `data-ts` take epoch milliseconds (refreshRelativeTimes reads Number(dataset.ts)), never an ISO string.
+        const stamp = el('span'); if (item.lastActiveAt) { stamp.dataset.ts = String(item.lastActiveAt); stamp.title = time(item.lastActiveAt); stamp.textContent = 'active ' + rel(item.lastActiveAt); } else stamp.textContent = 'activity unknown'; line.append(stamp);
+        // Park moves a live row to the shelf and Pin keeps a settled row live; both are the person's call and the only writes here. 'Unset' returns the row to what the rules derive.
+        if (!item.fixed) line.append(button(isSettled ? 'Pin' : 'Park', {action: 'worktree_override_set', path: String(item.path), value: isSettled ? 'active' : 'settled'}));
+        else line.append(badge('never shelved'));
+        if (item.reason === 'parked') line.append(button('Unset', {action: 'worktree_override_clear', path: String(item.path)}));
+        block.append(line);
+      }
+      return block;
+    };
+    target.append(group('Live', live, false), group('Settled', settled, true));
+    if (shelf.complete === false) target.append(el('p', 'Some worktrees could not be read in time; they are listed as live. The next refresh tries again.', 'meta'));
+    const tools = el('div', undefined, 'row-head');
+    const readNote = el('span', undefined, 'meta');
+    if (shelf.prsReadAt) { readNote.append('PR states read '); const when = el('span'); when.dataset.ts = String(shelf.prsReadAt); when.title = time(shelf.prsReadAt); when.textContent = rel(shelf.prsReadAt); readNote.append(when); }
+    else readNote.textContent = 'PR states not read yet: merged work shows as merged only after a guarded merge or a refresh.';
+    tools.append(button('Refresh PR states', {action: 'worktrees_refresh_prs'}), readNote);
+    const foot = el('div', undefined, 'row');
+    foot.append(tools);
+    if (settled.length) {
+      const tidy = el('p', 'To remove settled worktrees safely, run in a terminal (it previews first and removes only after you confirm): ', 'meta');
+      tidy.append(el('code', 'ahub worktrees tidy'));
+      foot.append(tidy);
+    }
+    target.append(foot);
+  });
+}
 function renderBench(bench) {
   const pct = (v) => v === null || v === undefined ? '-' : Math.round(v * 100) + '%';
   const num = (v) => v === null || v === undefined ? '-' : String(Math.round(v));
@@ -2541,6 +2663,7 @@ function renderStreamChips() {
     group.append(chip);
   }
 }
+$('intake').addEventListener('submit', submitIntake);
 $('planning-task').addEventListener('change',loadPlanning);$('planning-reload').addEventListener('click',loadPlanning);$('release-edit').addEventListener('change',loadReleasePlanning);$('release-reload').addEventListener('click',loadReleasePlanning);
 $('planning').addEventListener('submit',async event=>{event.preventDefault();if(!planningEdit || !sameBoardContext(planningEdit.context) || boardViewState?.snapshot.planningCapabilities?.enabled!==true)return notice('Select a task from its current board.',true);
   const fields={priority:$('planning-priority').value===''?null:Number($('planning-priority').value),rank:$('planning-rank').value===''?null:Number($('planning-rank').value),release:$('planning-release').value===''?null:Number($('planning-release').value),plannedStart:plannedDateInput('planning-start'),due:plannedDateInput('planning-due'),pinned:$('planning-pinned').checked};

package/src/ui/office-model.ts

@@ -33,6 +33,16 @@ export interface OfficeTaskInput {
   deps?: readonly number[];
   /** Optional (phase 3): the task's check is running; the task stays in_progress meanwhile. */
   checking?: boolean;
+  rank?: number | null;
+  priority?: number | null;
+  reserved?: string | null;
+  release?: number | null;
+  pinned?: boolean;
+  plannedStart?: number | null;
+}
+export interface OfficeReleaseInput {
+  id: number; name?: string; state?: string; order?: number; cut?: number | null;
+  tasks?: readonly { id: number; state?: string; deps?: readonly number[] }[];
 }
 /** Optional (phase 3): a warning line between desks. Task and peer ids only, never paths or symbols. */
 export interface OfficeLinkInput {
@@ -55,7 +65,8 @@ export interface OfficeEventInput {
   };
 }
 export interface OfficeSnapshotInput {
-  status?: { peers?: Record<string, OfficePeerInput> };
+  status?: { peers?: Record<string, OfficePeerInput>; roleInfo?: Record<string, { flowRoles?: readonly string[] }> };
+  releases?: readonly OfficeReleaseInput[];
   tasks?: readonly OfficeTaskInput[];
   permissions?: readonly { peer?: string }[];
   budget?: Record<string, { paused?: { reason?: string; resetsAt?: number | null } | null; [key: string]: unknown }>;
@@ -84,6 +95,10 @@ export interface OfficeCard {
   rework: boolean;
   /** The task's check is running; the card stays at its owner's desk. */
   checking: boolean;
+  reserved: string;
+  pinned: boolean;
+  plannedDate: string;
+  releaseTag?: { ordinal: number; name: string };
   /** Visible text: "#id public title". */
   label: string;
   /** Accessible name: "#id class: public title (state)", plus waiting/rework/review marks. */
@@ -114,6 +129,8 @@ export interface OfficeDesk {
   breakResetsAt: number | null;
   cards: OfficeCard[];
   extraCards: number;
+  planner: boolean;
+  unplanned: number;
 }
 export interface OfficeRoom {
   id: string;
@@ -123,6 +140,12 @@ export interface OfficeRoom {
   count: number;
   cards: OfficeCard[];
   overflow: number;
+  unplanned?: number;
+  x: number; y: number; w: number; h: number;
+}
+export interface OfficeDock {
+  id: number; name: string; state: string; ordinal: number;
+  approved: number; scope: number; ratio: number; cut: string;
   x: number; y: number; w: number; h: number;
 }
 export interface OfficeTransitions {
@@ -158,6 +181,8 @@ export interface OfficeScene {
   desks: OfficeDesk[];
   extraPeers: number;
   rooms: OfficeRoom[];
+  docks: OfficeDock[];
+  extraReleases: number;
   counts: OfficeCounts;
   transitions: OfficeTransitions;
   links: OfficeLink[];
@@ -168,7 +193,7 @@ export interface OfficeScene {
    * every `cards` list. Zero geometry: the dashboard never draws it, acon Space maps it. Same allowlisted fields as `cards`.
    */
   attributedCards: OfficeCard[];
-  /** Task id -> placement ("room:todo" | "room:work" | "room:review" | "shelf:done" | "desk:<peer>" | "counted:unknown"). */
+  /** Task id -> placement ("room:backlog" | "room:todo" | "room:work" | "room:review" | "shelf:done" | "desk:<peer>" | "counted:unknown"). */
   placed: Record<string, string>;
   arcs: OfficeArc[];
   alerts: OfficeAlert[];
@@ -204,6 +229,17 @@ export function officeModel(snapshot: OfficeSnapshotInput, previous: OfficeScene
   const tasks = Array.isArray(snapshot?.tasks) ? snapshot.tasks.filter((task) => task && typeof task.id === "number") : [];
   const permissions = Array.isArray(snapshot?.permissions) ? snapshot.permissions : [];
   const budget = snapshot?.budget && typeof snapshot.budget === "object" ? snapshot.budget : {};
+  const date = (value: unknown) => {
+    if (typeof value !== "number" || !Number.isFinite(value) || value <= 0 || value > 8_640_000_000_000_000) return "";
+    const local = new Date(value);
+    return `${local.getFullYear()}-${String(local.getMonth() + 1).padStart(2, "0")}-${String(local.getDate()).padStart(2, "0")}`;
+  };
+  const rank = (value: unknown) => typeof value === "number" && Number.isFinite(value) ? value : Infinity;
+  const backlog = tasks.filter(task => task.state === "backlog").sort((a, b) => (rank(a.rank) - rank(b.rank)) || (rank(a.priority) - rank(b.priority)) || a.id - b.id);
+  const unplanned = backlog.filter(task => rank(task.rank) === Infinity && !text(task.reserved)).length;
+  const releases: OfficeReleaseInput[] = (Array.isArray(snapshot?.releases) ? snapshot.releases : []).filter(row => row && Number.isSafeInteger(row.id) && row.id > 0 && ["planning", "active", "frozen"].includes(text(row.state)))
+    .sort((a, b) => (rank(a.order) - rank(b.order)) || a.id - b.id);
+  const docked = releases.slice(0, 3);
 
   // State counts mirror taskProgress (src/ui/task-progress.ts) exactly, including the waiting
   // rule on deps; test/office-model.test.ts pins the equality so a drift fails there.
@@ -272,17 +308,24 @@ export function officeModel(snapshot: OfficeSnapshotInput, previous: OfficeScene
   const card = (task: OfficeTaskInput, x: number, y: number, w: number, h: number): OfficeCard => {
     const state = text(task.state) || "unknown";
     const taskClass = text(task.class) || "task";
-    const waiting = waitingById.get(task.id) === true;
+    const plannedDate = state === "backlog" && date(task.plannedStart) && task.plannedStart! > now ? date(task.plannedStart) : "";
+    const waiting = waitingById.get(task.id) === true || state === "backlog" && ((task.deps ?? []).some(id => states.get(id) !== "approved") || !!plannedDate);
     const rework = state === "changes_requested";
     const checking = task.checking === true;
     const owner = text(task.owner);
     const reviewer = text(task.reviewer);
+    const reserved = state === "backlog" ? text(task.reserved) : "", pinned = state === "backlog" && task.pinned === true;
+    const releaseIndex = docked.findIndex(row => row.id === task.release);
+    const releaseTag = releaseIndex < 0 ? undefined : { ordinal: releaseIndex + 1, name: text(docked[releaseIndex]!.name) || "[withheld]" };
     let name = `#${task.id} ${taskClass}: ${text(task.title)} (${state.replaceAll("_", " ")})`;
-    if (waiting) name += ", waiting on dependencies";
+    if (waiting) name += state === "backlog" ? ", waits" + (plannedDate ? ` until ${plannedDate}` : "") : ", waiting on dependencies";
+    if (reserved) name += `, reserved for ${reserved}`;
+    if (pinned) name += ", pinned";
+    if (releaseTag) name += `, release ${releaseTag.ordinal}: ${releaseTag.name}`;
     if (rework) name += ", rework";
     if (checking) name += ", check running";
     if (state === "in_review") name += `, ${owner || "unassigned"} reviewed by ${reviewer || "unassigned"}`;
-    return { id: task.id, taskClass, state, owner, reviewer, waiting, rework, checking, label: `#${task.id} ${text(task.title)}`, name, x, y, w, h };
+    return { id: task.id, taskClass, state, owner, reviewer, waiting, rework, checking, reserved, pinned, plannedDate, ...(releaseTag ? { releaseTag } : {}), label: `#${task.id} ${text(task.title)}`, name, x, y, w, h };
   };
 
   const desks: OfficeDesk[] = shownIds.map((id) => {
@@ -320,6 +363,8 @@ export function officeModel(snapshot: OfficeSnapshotInput, previous: OfficeScene
     if (finishing) parts.push("finishing a turn");
     if (condition !== "waiting" && count > 0) parts.push(`${count} approval${count === 1 ? "" : "s"} waiting`);
     if (!attached) parts.push("disconnected, work retained");
+    const planner = Array.isArray(snapshot.status?.roleInfo?.[id]?.flowRoles) && snapshot.status!.roleInfo![id]!.flowRoles!.includes("planner");
+    if (planner) parts.push(`planner, ${unplanned} unplanned backlog cards`);
     // An over-full desk shows two chips and a "+N more" line in the third slot.
     const shown = work.length > DESK_CARDS ? work.slice(0, DESK_CARDS - 1) : work;
     return {
@@ -331,12 +376,14 @@ export function officeModel(snapshot: OfficeSnapshotInput, previous: OfficeScene
       finishing,
       cards: shown.map((task, index) => card(task, x + 0.8, y + 8.5 + index * 2.5, DESK_W - 1.6, 2)),
       extraCards: work.length - shown.length,
+      planner, unplanned: planner ? unplanned : 0,
     };
   });
 
   const desksBottom = Math.max(0, ...desks.map(desk => desk.y + desk.h));
   const roomsY = desksBottom ? desksBottom + 2 : 0;
   const roomDefs = [
+    { id: "backlog", label: "Backlog", filterState: "backlog", list: backlog, count: counts.backlog ?? 0 },
     { id: "todo", label: "To do", filterState: "proposed", list: todo, count: counts.proposed + counts.waiting },
     { id: "work", label: "Work floor", filterState: "work", list: workUnplaced, count: counts.in_progress + counts.changes_requested },
     { id: "review", label: "Review", filterState: "in_review", list: review, count: counts.in_review },
@@ -347,12 +394,20 @@ export function officeModel(snapshot: OfficeSnapshotInput, previous: OfficeScene
     const y = roomsY + Math.floor(index / cols) * ROOM_DY;
     return {
       id: def.id, label: def.label, filterState: def.filterState, count: def.count,
+      ...(def.id === "backlog" && !desks.some(desk => desk.planner) ? { unplanned } : {}),
       // One column at 12 px per unit: 28 px cards, 6 px gaps, eight cards at most.
       cards: def.list.slice(0, ROOM_CARDS).map((task, row) => card(task, x + 1, y + 3.4 + row * (ROOM_CARD_H + ROOM_CARD_GAP), ROOM_W - 2, ROOM_CARD_H)),
       overflow: Math.max(0, def.list.length - ROOM_CARDS),
       x, y, w: ROOM_W, h: ROOM_H,
     };
   });
+  const docks: OfficeDock[] = docked.map((row, index) => {
+    const scope: NonNullable<OfficeReleaseInput["tasks"]> = Array.isArray(row.tasks) ? row.tasks.filter((task: NonNullable<OfficeReleaseInput["tasks"]>[number]) => task && Number.isSafeInteger(task.id) && task.id > 0) : [];
+    const approved = scope.filter(task => task.state === "approved").length, position = roomDefs.length + index;
+    return { id: row.id, name: text(row.name) || "[withheld]", state: text(row.state), ordinal: index + 1, approved, scope: scope.length,
+      ratio: scope.length ? approved / scope.length : 0, cut: date(row.cut), x: (position % cols) * ROOM_DX,
+      y: roomsY + Math.floor(position / cols) * ROOM_DY, w: ROOM_W, h: ROOM_H };
+  });
 
   const placed: Record<string, string> = {};
   for (const task of tasks) {    const state = text(task.state);
@@ -362,7 +417,7 @@ export function officeModel(snapshot: OfficeSnapshotInput, previous: OfficeScene
       : state === "approved" ? "shelf:done"
       : state === "cancelled" ? "counted:cancelled"
       : state === "in_progress" || state === "changes_requested" ? (owner && shownSet.has(owner) ? `desk:${owner}` : "room:work")
-      : state === "backlog" ? "counted:backlog" : "counted:unknown";
+      : state === "backlog" ? "room:backlog" : "counted:unknown";
   }
   // A bubble's attributed task may sit past the rendering cut; keep its public card so a consumer that draws more cards than the page can.
   const drawn = new Set<number>([...desks.flatMap((desk) => desk.cards), ...rooms.flatMap((room) => room.cards)].map((entry) => entry.id));
@@ -454,9 +509,10 @@ export function officeModel(snapshot: OfficeSnapshotInput, previous: OfficeScene
   }
   return {
     cols,
-    width: Math.max(desksWidth, ...rooms.map(room => room.x + room.w), 1),
-    height: Math.max(desksBottom, ...rooms.map(room => room.y + room.h), 1),
+    width: Math.max(desksWidth, ...[...rooms, ...docks].map(room => room.x + room.w), 1),
+    height: Math.max(desksBottom, ...[...rooms, ...docks].map(room => room.y + room.h), 1),
     desks, extraPeers, rooms, counts, transitions, slots, placed, attributedCards,
+    docks, extraReleases: Math.max(0, releases.length - docks.length),
     links,
     arcs: keptArcs, alerts: keptAlerts, latched, settle, at, eventTime, lastSeq,
   };

package/src/ui/office-space.ts

@@ -21,6 +21,7 @@ export interface SpaceScene {
 }
 
 const ZONES: Record<string, { kind: ZoneKind; title: string }> = {
+  backlog: { kind: "queue", title: "Backlog" },
   todo: { kind: "queue", title: "To do" }, work: { kind: "work", title: "Work floor" },
   review: { kind: "review", title: "Review" }, done: { kind: "done", title: "Done" },
 };

package/src/ui/plugin.ts

@@ -46,10 +46,10 @@ export interface ConsolePlugin {
 
 const TITLES: Record<(typeof DASHBOARD_VIEWS)[number], string> = { board: "Board", office: "Office", stream: "Stream", agents: "Agents", message: "Message", memory: "Memory", settings: "Settings" };
 /** The dashboard's own actions plus the inbox verbs; the manager whitelist is still applied to each forwarded call. */
-const FORWARDED = ["start", "stop", "send", "pause", "resume", "permit", "propose", "assign", "backlog_pull", "backlog_return", "planning", "planning_undo", "planner_pull", "backlog_split", "release_new", "release_change", "setting", "setting_undo", "setting_preview", "setting_reload", "config_edit_preview", "config_edit_apply", "start_peer", "sdlc_queue", "sdlc_release"] as const;
+const FORWARDED = ["start", "stop", "send", "pause", "resume", "permit", "propose", "intake", "assign", "backlog_pull", "backlog_return", "planning", "planning_undo", "planner_pull", "backlog_split", "release_new", "release_change", "setting", "setting_undo", "setting_preview", "setting_reload", "config_edit_preview", "config_edit_apply", "start_peer", "sdlc_queue", "sdlc_release", "worktree_override_set", "worktree_override_clear", "worktrees_refresh_prs"] as const;
 const INBOX_VERBS = ["approve", "deny", "open"] as const;
 /** Outward or destructive: answered needsConfirm first (agent-console AGENTS.md); previews are read-only and stay direct. */
-const CONFIRMED = new Set(["stop", "permit", "setting", "setting_undo", "setting_reload", "config_edit_apply", "start_peer", "backlog_split", "send", "approve", "deny"]);
+const CONFIRMED = new Set(["stop", "permit", "setting", "setting_undo", "setting_reload", "config_edit_apply", "start_peer", "backlog_split", "send", "approve", "deny", "worktree_override_set", "worktrees_refresh_prs"]);
 const fingerprintOf = (input: Record<string, unknown>) => {
   const { confirmed: _c, fingerprint: _f, reason: _r, ...rest } = input;
   return createHash("sha256").update(JSON.stringify(Object.keys(rest).sort().map((key) => [key, rest[key]]))).digest("hex");
@@ -176,6 +176,17 @@ export function createProvider(options: { home: string; registry?: Registry; lif
           verbs: [...(allow ? [{ id: "approve", label: "Allow once", primary: true }] : []), ...(deny ? [{ id: "deny", label: "Deny", destructive: true }] : [])],
           link: { panel: "agents", params: { project: project.id } } });
       }
+      // #1057 D4: one alert when the shelf holds more settled worktrees than `worktrees.alert_over` (0 = never). Counts only: no path, branch or title, and no action
+      // beyond opening the panel, because removal is the person's `ahub worktrees tidy` and never a button.
+      const shelf = snap.worktrees as { settled?: unknown[]; alertOver?: number } | undefined;
+      const settledCount = Array.isArray(shelf?.settled) ? shelf!.settled.length : 0;
+      if (typeof shelf?.alertOver === "number" && shelf.alertOver > 0 && settledCount > shelf.alertOver) {
+        const id = `worktrees:${project.id}`;
+        const at = seen.get(id) ?? new Date().toISOString();
+        seen.set(id, at);
+        items.push({ id, group: "alert", kind: "worktrees", title: `${settledCount} settled worktrees`, detail: `More than ${shelf.alertOver}. Review them in Agents, then run ahub worktrees tidy.`, project: name, at,
+          chip: { text: "worktrees", tone: "warn" }, verbs: [{ id: "open", label: "Open Agents", primary: true }], link: { panel: "agents", params: { project: project.id } } });
+      }
       for (const t of (snap.tasks as { id: number; title: string; state: string; reviewer: string | null; owner: string | null }[] | undefined) ?? []) {
         if (t.state !== "in_review" || t.reviewer !== "user") continue;
         const id = `review:${project.id}:${t.id}`;
@@ -231,7 +242,7 @@ export function createProvider(options: { home: string; registry?: Registry; lif
   /** approve/deny resolve to the hub's own `permit` with the request's option; nothing else is reachable from an item. */
   async function inboxVerb(input: Record<string, unknown>): Promise<ActionResult> {
     const m = typeof input.id === "string" ? /^perm:([^:]+):(.+)$/.exec(input.id) : null;
-    if (input.action === "open") return { ok: true, message: "Open the Board panel to review." };
+    if (input.action === "open") return { ok: true, message: typeof input.id === "string" && input.id.startsWith("worktrees:") ? "Open the Agents panel to review the shelf." : "Open the Board panel to review." };
     if (!m) return { ok: false, error: "unknown inbox item" };
     const project = (await running()).find((p) => p.id === m[1]);
     if (!project) return { ok: false, error: "project is not running" };