npm - coxpit - Versions diffs - 4.5.0 → 4.6.0 - Mend

coxpit 4.5.0 → 4.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/README.md CHANGED Viewed

@@ -114,7 +114,15 @@ One daemon, one SQLite file, zero external services. Machines are reached over S
 ## Status
-`v4.3` — everything in v4.2 plus **the logbook**: the board is Active-first (closed tasks leave the grid), an Archive view lists them as searchable rows, and `/api/fleet` now scopes to active work and caps events per run so it stays fast at hundreds of runs. Opening an archived task still renders its documents — from the v4.1 snapshot. All shipped and e2e-tested (38 checks). ⚠️ `/api/fleet` defaults to `view=active` now — pass `?view=all` for the previous everything-payload. Roadmap: ROADMAP.md.
+`v4.5` — **greenfield + remote access**. Point Coxpit at an empty folder and a fleet scaffolds a brand-new project across N agents on an empty initial commit — compare the foundations, keep the best (existing folders are never touched). Remote access detects your Tailscale and puts the board on `https://<machine>.<tailnet>.ts.net` in one click (Funnel for public, behind a warning; copy-paste Cloudflare/Caddy recipes otherwise) — Coxpit drives the tool, never hosts a relay. Builds on v4.3's Active-first board + Archive. All shipped and e2e-tested (45 checks). Roadmap: ROADMAP.md.
+## Contributing
+Issues and PRs are welcome. Start with **[CONTRIBUTING.md](CONTRIBUTING.md)** for
+dev setup (`COXPIT_AUTH_DISABLED=1 npm run dev`), the verify gate (`npm run
+typecheck` + `bash test/e2e.sh`), and the house rules. Please read the
+[non-goals](ROADMAP.md#non-goals) before proposing a feature, and report security
+issues privately per **[SECURITY.md](SECURITY.md)** (Coxpit exposes shells).
 ## License

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "coxpit",
-  "version": "4.5.0",
+  "version": "4.6.0",
   "description": "Self-hosted cockpit for running a fleet of AI coding agents across your own machines — parallel worktree runs, live board, compare & merge, web terminal, design capture.",
   "type": "module",
   "license": "MIT",

package/src/board.ts CHANGED Viewed

@@ -152,6 +152,56 @@ export const BOARD_HTML = /* html */ `<!doctype html>
   .gband.folded .gband-grid{display:none}
   .gband-grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(360px,1fr));gap:14px}
   .attempt{color:var(--brand);opacity:.8}
+  /* ── goal workroom (v4.6) — 한 goal 을 여는 단일 방 ── */
+  .gband-open{margin-left:2px}
+  .room{width:min(920px,96vw);max-height:90vh;background:var(--surface);border:1px solid var(--line);
+    border-radius:16px;display:flex;flex-direction:column;overflow:hidden;box-shadow:var(--shadow)}
+  .rh{display:flex;align-items:center;gap:10px;padding:14px 18px;border-bottom:1px solid var(--line);
+    background:linear-gradient(180deg,var(--brand-dim),transparent)}
+  .rh .rh-glyph{color:var(--brand);font-family:var(--mono);font-size:15px}
+  .rh .rh-t{font-weight:600;font-size:14px;flex:1;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+  .rh .rh-n{font-family:var(--mono);font-size:11px;color:var(--faint)}
+  .rh .x{background:transparent;border:none;color:var(--muted);font-size:19px;cursor:pointer;
+    padding:2px 9px;border-radius:6px;line-height:1}
+  .rh .x:hover{color:var(--ink);background:var(--surface2)}
+  .chips{display:flex;flex-wrap:wrap;gap:7px;padding:12px 18px;border-bottom:1px solid var(--line)}
+  .room .chip{cursor:pointer;transition:border-color .15s,filter .15s}
+  .room .chip:hover{filter:brightness(1.15)}
+  .room .chip .cid{font-weight:600}
+  .room .chip .cmeta{opacity:.7;text-transform:none;letter-spacing:0}
+  .room .chip.new{border-style:dashed}
+  .body{overflow:auto;flex:1;min-height:120px}
+  .feed{display:flex;flex-direction:column;gap:6px;padding:12px 18px;font-family:var(--mono);font-size:11.5px}
+  .feed .fl{display:flex;gap:9px;align-items:baseline;min-width:0}
+  .feed .fl .who{min-width:52px;flex:none;opacity:.9}
+  .feed .fl .ft{color:var(--muted);word-break:break-word;flex:1}
+  .feed .fl.mark .who{color:var(--brand)}
+  .feed .empty-note{color:var(--faint)}
+  .conv{display:flex;flex-direction:column;gap:12px;padding:12px 18px;font-size:12.5px}
+  .conv .empty-note{color:var(--faint);font-family:var(--mono);font-size:11.5px}
+  .conv .turn{display:flex;flex-direction:column;gap:3px}
+  .conv .turn .role{font-family:var(--mono);font-size:9.5px;font-weight:600;text-transform:uppercase;letter-spacing:.06em}
+  .conv .turn.you .role{color:var(--muted)}
+  .conv .turn.coord .role{color:var(--brand)}
+  .conv .turn .msg{color:var(--ink);white-space:pre-wrap;word-break:break-word;line-height:1.55}
+  .conv .turn.you .msg{color:var(--muted)}
+  .conv .turn .ro-note{font-family:var(--mono);font-size:9.5px;color:var(--faint);letter-spacing:.02em}
+  .send-only{display:flex;gap:8px;align-items:center}
+  .send-only .ro-hint{flex:1;font-family:var(--mono);font-size:10px;color:var(--faint);letter-spacing:.02em}
+  .composer{border-top:1px solid var(--line);padding:12px 18px;display:flex;flex-direction:column;gap:8px}
+  .composer .comp-seg{flex:0 0 auto}
+  .composer .comp-hint{font-family:var(--mono);font-size:10.5px;color:var(--faint);letter-spacing:.02em}
+  .composer textarea{min-height:52px}
+  .verbs{display:flex;gap:8px;align-items:center}
+  .verbs .grow{flex:1}
+  .conv-menu{position:relative}
+  .conv-pop{position:absolute;bottom:calc(100% + 6px);right:0;z-index:5;background:var(--surface2);
+    border:1px solid var(--line-hi);border-radius:9px;box-shadow:var(--shadow);padding:4px;min-width:200px;display:none}
+  .conv-menu.open .conv-pop{display:block}
+  .conv-pop button{display:block;width:100%;text-align:left;background:transparent;border:none;
+    color:var(--muted);font-size:12.5px;padding:8px 10px;border-radius:6px;cursor:pointer}
+  .conv-pop button:hover{background:var(--surface);color:var(--ink)}
   /* ── active/archive view seg + archive list ── */
   .view-seg{padding:2px;gap:2px}
   .view-seg .seg-opt{padding:4px 12px;font-size:11.5px}
@@ -589,6 +639,46 @@ export const BOARD_HTML = /* html */ `<!doctype html>
   </div>
 </div>
+<div class="overlay" id="groupRoomOverlay">
+  <div class="room">
+    <div class="rh">
+      <span class="rh-glyph">⌒</span>
+      <span class="rh-t" id="roomTitle">Goal</span>
+      <span class="rh-n" id="roomCount"></span>
+      <button class="x" id="roomClose" aria-label="close">×</button>
+    </div>
+    <div class="chips" id="roomChips"></div>
+    <div class="body">
+      <div class="feed" id="roomFeed"></div>
+      <div class="conv" id="roomConv" hidden></div>
+    </div>
+    <div class="composer">
+      <div class="seg comp-seg" id="roomSeg" role="group" aria-label="workroom mode">
+        <button type="button" class="seg-opt on" data-rmode="work">✎ Work</button>
+        <button type="button" class="seg-opt" data-rmode="ask">? Ask</button>
+      </div>
+      <div class="comp-hint" id="roomHint"></div>
+      <textarea id="roomInput" placeholder="New attempt prompt, or a broadcast to the settled runs…"></textarea>
+      <div class="verbs" id="roomVerbs">
+        <button type="button" class="btn-ghost sm" id="roomNew">＋ New attempt</button>
+        <button type="button" class="btn-ghost sm" id="roomBroadcast">→ Broadcast</button>
+        <span class="grow"></span>
+        <div class="conv-menu" id="roomConvMenu">
+          <button type="button" class="btn sm" id="roomConverge">Converge ▾</button>
+          <div class="conv-pop">
+            <button type="button" id="roomReview">Review group</button>
+            <button type="button" id="roomIntegrate">Select runs to integrate</button>
+          </div>
+        </div>
+      </div>
+      <div class="send-only" id="roomSend" hidden>
+        <span class="ro-hint">read-only — switch to Work to act</span>
+        <button type="button" class="btn sm" id="roomAsk">Ask</button>
+      </div>
+    </div>
+  </div>
+</div>
 <div class="overlay" id="cmpOverlay">
   <div class="modal wide">
     <div class="modal-h">
@@ -636,9 +726,14 @@ export const BOARD_HTML = /* html */ `<!doctype html>
     </div>
     <div class="brw-list" id="brwList"></div>
     <div class="brw-f">
-      <span class="hint">folders with a <span style="color:var(--brand)">git</span> badge are repositories — hit Register</span>
+      <span class="hint"><span style="color:var(--brand)">git</span> badge = repo (Register) · empty folder = Start here</span>
+      <button class="btn-ghost sm" id="brwNewFolder">＋ New folder here</button>
       <button class="btn sm" id="brwRegHere" style="display:none">Register this folder</button>
     </div>
+    <form class="brw-f" id="brwNewForm" hidden>
+      <input id="brwNewName" placeholder="new-project-folder-name" style="flex:1" />
+      <button class="btn sm" type="submit" id="brwNewGo">Create &amp; start</button>
+    </form>
   </div>
 </div>
@@ -809,7 +904,8 @@ async function brwGo(p){
     (d.error ? '<div class="brw-row"><span class="nm" style="color:var(--s-failed)">'+esc(d.error)+'</span></div>' : '')
     + (d.dirs.map(x =>
         '<div class="brw-row" data-n="'+esc(x.name)+'"><span class="ico">▸</span><span class="nm">'+esc(x.name)+'</span>'
-        + (x.isRepo ? '<span class="gitchip">git</span><button type="button" class="btn sm" data-reg="'+esc(x.name)+'">Register</button>' : '')
+        + (x.isRepo ? '<span class="gitchip">git</span><button type="button" class="btn sm" data-reg="'+esc(x.name)+'">Register</button>'
+           : x.isEmpty ? '<button type="button" class="btn-ghost sm" data-start="'+esc(x.name)+'">Start here</button>' : '')
         + '</div>').join('')
       || '<div class="brw-row"><span class="nm" style="color:var(--faint)">no folders here</span></div>');
 }
@@ -834,18 +930,42 @@ async function brwRegister(fullPath){
 $('repoBrowse').addEventListener('click', ()=>{
   const m = machines.find(x=>x.slug===$('repoMachine').value);
   if (m && m.address){ toast('remote machine — type the path manually for now', 'error'); return; }
+  $('brwNewForm').hidden = true; $('brwNewName').value = '';
   $('brwOverlay').classList.add('open');
   brwGo(brwCur || '');
 });
 $('brwList').addEventListener('click',(e)=>{
   const reg = e.target.closest('button[data-reg]');
   if (reg){ brwRegister(brwCur.replace(/\\/$/,'')+'/'+reg.dataset.reg); return; }
+  const start = e.target.closest('button[data-start]');
+  if (start){ brwStartHere(brwCur.replace(/\\/$/,'')+'/'+start.dataset.start); return; }
   const row = e.target.closest('.brw-row[data-n]');
   if (row) brwGo(brwCur.replace(/\\/$/,'')+'/'+row.dataset.n);
 });
 $('brwUp').addEventListener('click',(e)=>brwGo(e.currentTarget.dataset.p));
 $('brwHome').addEventListener('click',(e)=>brwGo(e.currentTarget.dataset.p));
 $('brwRegHere').addEventListener('click',()=>brwRegister(brwCur));
+/* 빈 폴더 행의 Start here — 클릭한 폴더에 greenfield 씨앗 심고 등록 */
+async function brwStartHere(fullPath){
+  if (await createNewProject(fullPath)) $('brwOverlay').classList.remove('open');
+}
+/* ＋ New folder here — 현재 탐색 위치에 새 폴더명만 받아 생성+시작 (절대경로 타이핑 불필요) */
+$('brwNewFolder').addEventListener('click', ()=>{
+  const f = $('brwNewForm'); f.hidden = !f.hidden; if(!f.hidden) $('brwNewName').focus();
+});
+$('brwNewForm').addEventListener('submit', async (e)=>{
+  e.preventDefault();
+  const name = $('brwNewName').value.trim();
+  if (!name){ toast('enter a folder name', 'error'); return; }
+  if (name.includes('/')){ toast('folder name cannot contain /', 'error'); return; }
+  const go = $('brwNewGo'); go.disabled = true; go.textContent = 'Creating…';
+  try{
+    if (await createNewProject(brwCur.replace(/\\/$/,'')+'/'+name)){
+      $('brwNewName').value=''; $('brwNewForm').hidden=true;
+      $('brwOverlay').classList.remove('open');
+    }
+  } finally { go.disabled=false; go.textContent='Create & start'; }
+});
 $('brwClose').addEventListener('click',()=>$('brwOverlay').classList.remove('open'));
 $('brwOverlay').addEventListener('click',(e)=>{ if(e.target===$('brwOverlay')) $('brwOverlay').classList.remove('open'); });
@@ -985,6 +1105,7 @@ function bandHTML(g, grpRuns){
     + '<span class="gband-t">'+title+'</span>'
     + '<span class="gband-n">'+taskIds.length+' task'+(taskIds.length>1?'s':'')+' · '+settled+' settled</span>'
     + '<span class="gband-sp"></span>'
+    + '<button class="btn-ghost sm gband-open" data-groom="'+g.id+'">⌒ Open workroom</button>'
     + '<button class="btn-ghost sm" data-gsel="'+g.id+'">Select runs</button>'
     + '<button class="btn-ghost sm" data-gclose="'+g.id+'">Close group</button>'
     + '<button class="gband-fold" data-gfold="'+g.id+'" title="fold">'+(folded?'▸':'▾')+'</button></div>'
@@ -1285,6 +1406,7 @@ function connectWS(){
     let ev; try{ ev = JSON.parse(m.data); }catch{ return; }
     // 아카이브 뷰는 정적 스냅샷 — 라이브 갱신으로 뒤엎지 않는다.
     if (boardView==='archive' && (ev.type==='run'||ev.type==='event'||ev.type==='task')) return;
+    roomOnWS(ev);   // 워크룸이 열려있으면 그룹 소속 run/event 를 방에 반영
     if (ev.type==='run'){
       const rid = ev.runId ?? ev.id;
       const known = runs.has(rid);
@@ -1436,6 +1558,8 @@ $('selGo').addEventListener('click', async ()=>{
 /* ── 그룹 밴드 액션 (fold / Select runs / Close group) ── */
 $('grid').addEventListener('click', async (e)=>{
+  const groom = e.target.closest('[data-groom]');
+  if (groom){ openRoom(Number(groom.dataset.groom)); return; }
   const fold = e.target.closest('[data-gfold]');
   if (fold){ const g=Number(fold.dataset.gfold); if(gfold.has(g)) gfold.delete(g); else gfold.add(g); saveGfold(); render(); return; }
   const gsel = e.target.closest('[data-gsel]');
@@ -1496,7 +1620,7 @@ $('grid').addEventListener('click',(e)=>{
 });
 $('mClose').addEventListener('click', closeModal);
 $('overlay').addEventListener('click',(e)=>{ if(e.target===$('overlay')) closeModal(); });
-document.addEventListener('keydown',(e)=>{ if(e.key==='Escape'){ closeDropdowns(); cfmClose(false); $('brwOverlay').classList.remove('open'); $('expOverlay').classList.remove('open'); $('ghOverlay').classList.remove('open'); $('npOverlay').classList.remove('open'); $('brOverlay').classList.remove('open'); $('remoteOverlay').classList.remove('open'); closeTerm(); closeModal(); cmpTaskId=null; $('cmpOverlay').classList.remove('open'); } });
+document.addEventListener('keydown',(e)=>{ if(e.key==='Escape'){ closeDropdowns(); cfmClose(false); $('brwOverlay').classList.remove('open'); $('expOverlay').classList.remove('open'); $('ghOverlay').classList.remove('open'); $('npOverlay').classList.remove('open'); $('brOverlay').classList.remove('open'); $('remoteOverlay').classList.remove('open'); closeRoom(); closeTerm(); closeModal(); cmpTaskId=null; $('cmpOverlay').classList.remove('open'); } });
 $('mRefreshDiff').addEventListener('click', loadDiff);
 $('mExport').addEventListener('click', ()=>{
   if (openRunId==null) return;
@@ -1698,6 +1822,254 @@ $('mCompare').addEventListener('click', ()=>{
   closeModal(); openCompare(r.taskId);
 });
+/* ── goal workroom (v4.6 L1) — 한 goal 을 여는 단일 방 ── */
+let roomGroupId = null;               // 열려있는 그룹 id (null = 닫힘)
+const roomRunSet = new Set();         // 이 그룹에 속한 runId — WS 필터용
+let roomRuns = [];                    // 마지막 aggregate 의 runs (chips/scope hint)
+const roomExtra = [];                 // goal-level 마커(spawn/broadcast) — 피드에 섞음
+const roomTurns = [];                 // Ask 대화 턴 [{role:'you'|'coord', text}] — 읽기 전용
+let roomMode = 'work';                // 'work' | 'ask' — 방 composer 모드(스틸모드와 무관, 방 전용)
+/* run → 상태색 (chip / who) */
+function roomStatusColor(s){ return statusColor(s); }
+function roomChipHTML(r){
+  const s = r.status||'pending';
+  const meta = ['done','failed','stopped','merged'].includes(s)
+    ? (r.filesChanged? '+'+r.filesChanged+'f' : 'no changes')
+    : (r.agent||'agent')+(s==='running'?' · editing…':'');
+  return '<span class="chip'+(s==='running'?' running':'')+(r.isNew?' new':'')+'" data-roomrun="'+r.runId+'"'
+    + ' style="color:'+roomStatusColor(s)+';border-color:'+roomStatusColor(s)+'">'
+    + '<i></i><span class="cid">r'+r.runId+'</span> <span class="cmeta">'+esc(meta)+'</span></span>';
+}
+function roomRenderChips(){
+  $('roomChips').innerHTML = roomRuns.length
+    ? roomRuns.map(roomChipHTML).join('')
+    : '<span style="color:var(--faint);font-family:var(--mono);font-size:11.5px">no runs yet</span>';
+}
+function roomFeedLine(who, whoStatus, text, mark){
+  return '<div class="fl'+(mark?' mark':'')+'"><span class="who" style="color:'
+    + (mark?'var(--brand)':roomStatusColor(whoStatus))+'">'+esc(who)+'</span>'
+    + '<span class="ft">'+esc(text)+'</span></div>';
+}
+function roomRenderFeed(events){
+  // run 이벤트 + goal-level 마커를 시간(id/순서)대로. 간단히: 이벤트 먼저, 마커는 append.
+  const statusOf = (rid)=>{ const r = roomRuns.find(x=>x.runId===rid); return r? r.status : 'pending'; };
+  const rows = [];
+  for (const e of (events||[])){
+    const h = humanize({ kind:e.kind, payload:e.payload });
+    if (!h) continue;
+    const list = Array.isArray(h) ? h : [h];
+    for (const x of list) rows.push(roomFeedLine('r'+e.runId, statusOf(e.runId), x.k+' · '+x.t, false));
+  }
+  for (const m of roomExtra){
+    rows.push(roomFeedLine(m.who, 'pending', m.text, true));
+  }
+  $('roomFeed').innerHTML = rows.length ? rows.join('')
+    : '<div class="empty-note">no activity yet — spawn an attempt or wait for runs to report</div>';
+  $('roomFeed').scrollTop = $('roomFeed').scrollHeight;
+}
+/* Ask 대화(읽기 전용) — you / coordinator 턴. 코디네이터 답 아래 read-only 노트. */
+function roomRenderConv(){
+  if (!roomTurns.length){
+    $('roomConv').innerHTML = '<div class="empty-note">read-only coordinator — ask what these attempts are doing. it never acts.</div>';
+    return;
+  }
+  $('roomConv').innerHTML = roomTurns.map(t=>{
+    const role = t.role==='you' ? 'you' : 'coordinator';
+    const note = t.role==='coord'
+      ? '<span class="ro-note">read-only — switch to Work to act</span>' : '';
+    return '<div class="turn '+t.role+'"><span class="role">'+esc(role)+'</span>'
+      + '<span class="msg">'+esc(t.text)+'</span>'+note+'</div>';
+  }).join('');
+  $('roomConv').scrollTop = $('roomConv').scrollHeight;
+}
+function roomRenderHeaderAndHint(){
+  const g = groups.get(roomGroupId) || {};
+  const done = roomRuns.filter(r=>['done','failed','stopped','merged'].includes(r.status)).length;
+  const running = roomRuns.filter(r=>r.live).length;
+  $('roomTitle').textContent = 'Goal: '+(g.title||'');
+  $('roomCount').textContent = '· '+roomRuns.length+' run'+(roomRuns.length===1?'':'s')
+    +' · '+done+' done · '+running+' running';
+  roomRenderHint();
+}
+/* Work=정직한 steer 스코프, Ask=읽기 전용 안내. 모드에 따라 힌트/뷰/composer 전환. */
+function roomRenderHint(){
+  if (roomMode==='ask'){
+    $('roomHint').textContent = 'read-only coordinator · reads run diffs, never acts';
+    return;
+  }
+  const running = roomRuns.filter(r=>r.live).length;
+  const steerable = roomRuns.filter(r=>r.steerable).length;
+  $('roomHint').textContent = steerable+' steerable now · '+running+' still running';
+}
+/* feed↔conv, verbs↔send-only 를 roomMode 로 스왑. */
+function roomApplyMode(){
+  const ask = roomMode==='ask';
+  $('roomFeed').hidden = ask;
+  $('roomConv').hidden = !ask;
+  $('roomVerbs').hidden = ask;
+  $('roomSend').hidden = !ask;
+  $('roomInput').placeholder = ask
+    ? 'Ask the coordinator about these attempts (read-only)…'
+    : 'New attempt prompt, or a broadcast to the settled runs…';
+  document.querySelectorAll('#roomSeg .seg-opt').forEach(x=>x.classList.toggle('on', x.dataset.rmode===roomMode));
+  roomRenderHint();
+  if (ask) roomRenderConv();
+}
+async function openRoom(groupId){
+  roomGroupId = groupId;
+  roomExtra.length = 0; roomRunSet.clear(); roomRuns = []; roomTurns.length = 0;
+  roomMode = 'work';
+  $('roomInput').value = '';
+  $('roomChips').innerHTML = '<span style="color:var(--faint);font-family:var(--mono);font-size:11.5px">loading…</span>';
+  $('roomFeed').innerHTML = '';
+  $('roomConv').innerHTML = '';
+  $('roomTitle').textContent = 'Goal';
+  $('roomCount').textContent = '';
+  $('roomHint').textContent = '';
+  roomApplyMode();
+  $('groupRoomOverlay').classList.add('open');
+  await roomLoad();
+}
+async function roomLoad(){
+  if (roomGroupId==null) return;
+  let j;
+  try{ j = await fetch('/api/groups/'+roomGroupId).then(x=>x.json()); }
+  catch{ toast('workroom load failed', 'error'); return; }
+  if (!j || !j.group){ toast('group not found', 'error'); return; }
+  if (!groups.has(j.group.id)) groups.set(j.group.id, j.group);
+  roomRuns = j.runs||[];
+  roomRunSet.clear();
+  roomRuns.forEach(r=>roomRunSet.add(r.runId));
+  roomRenderChips();
+  roomRenderHeaderAndHint();
+  roomRenderFeed(j.events||[]);
+}
+function closeRoom(){ roomGroupId = null; $('groupRoomOverlay').classList.remove('open'); }
+/* chip 클릭 → 그 run 을 기존 run 모달로 */
+$('roomChips').addEventListener('click',(e)=>{
+  const c = e.target.closest('[data-roomrun]'); if(!c) return;
+  const rid = Number(c.dataset.roomrun);
+  closeRoom();
+  if (runs.has(rid)) openModal(rid);
+  else { // 아카이브 등 맵에 없는 run — 태스크로 하이드레이트 후 연다
+    fetch('/api/runs/'+rid).then(x=>x.json()).then(d=>{ if(d.run){ runs.set(rid, {...d.run, events:d.events||[]}); openModal(rid); } }).catch(()=>{});
+  }
+});
+$('roomClose').addEventListener('click', closeRoom);
+$('groupRoomOverlay').addEventListener('click',(e)=>{ if(e.target===$('groupRoomOverlay')) closeRoom(); });
+/* ＋ New attempt — 같은 그룹에 새 시도 발사 (현재 dry/real 토글 반영) */
+$('roomNew').addEventListener('click', async ()=>{
+  if (roomGroupId==null) return;
+  const prompt = $('roomInput').value.trim();
+  if (!prompt){ toast('write a prompt for the new attempt', 'error'); return; }
+  const real = $('taskReal').checked;
+  const btn = $('roomNew'); btn.disabled = true;
+  try{
+    const res = await fetch('/api/groups/'+roomGroupId+'/spawn',{method:'POST',
+      headers:{'content-type':'application/json'}, body:JSON.stringify({prompt, real})});
+    const j = await res.json().catch(()=>({}));
+    if (res.ok){
+      $('roomInput').value='';
+      (j.tasks||[]).forEach(t=>{ roomExtra.push({ who:'goal ＋', text:'new attempt r'+t.runId+' — '+prompt.slice(0,60) }); roomRunSet.add(t.runId); });
+      toast((j.tasks||[]).length+' attempt(s) launched'+(real?'':' (dry)'), 'ok');
+      roomRenderFeed([]); await roomLoad(); hydrate();
+    } else toast('spawn: '+(j.error||res.status), 'error');
+  } finally { btn.disabled = false; }
+});
+/* → Broadcast — 그룹의 정착 steerable run 전부에 후속 지시(라이브/드라이는 정직하게 skip) */
+$('roomBroadcast').addEventListener('click', async ()=>{
+  if (roomGroupId==null) return;
+  const message = $('roomInput').value.trim();
+  if (!message){ toast('write a broadcast message', 'error'); return; }
+  const btn = $('roomBroadcast'); btn.disabled = true;
+  try{
+    const res = await fetch('/api/groups/'+roomGroupId+'/steer',{method:'POST',
+      headers:{'content-type':'application/json'}, body:JSON.stringify({message, mode:roomMode})});
+    const j = await res.json().catch(()=>({}));
+    if (res.ok){
+      $('roomInput').value='';
+      roomExtra.push({ who:'goal →', text:message.slice(0,80)+'  ('+j.detail+')' });
+      toast('broadcast: '+j.detail, (j.skipped&&j.skipped.length)?undefined:'ok');
+      roomRenderFeed([]); await roomLoad();
+    } else toast('broadcast: '+(j.error||res.status), 'error');
+  } finally { btn.disabled = false; }
+});
+/* Converge ▾ — 기존 review/integrate 를 노출(재구현 아님) */
+$('roomConverge').addEventListener('click',(e)=>{ e.stopPropagation(); $('roomConvMenu').classList.toggle('open'); });
+document.addEventListener('click',()=>$('roomConvMenu').classList.remove('open'));
+$('roomReview').addEventListener('click', ()=>{
+  $('roomConvMenu').classList.remove('open');
+  // 그룹 태스크가 여럿이면 각 태스크가 자체 비교/리뷰를 가짐 — 첫 태스크의 Compare 로 진입.
+  const first = roomRuns[0];
+  if (!first){ toast('no runs to review', 'error'); return; }
+  closeRoom(); openCompare(first.taskId);
+});
+$('roomIntegrate').addEventListener('click', ()=>{
+  $('roomConvMenu').classList.remove('open');
+  const g = roomGroupId; closeRoom();
+  if (!selectMode) setSelectMode(true);
+  // 그룹의 정착·변경 run 전부 사전 선택(기존 밴드 Select runs 와 동일 규칙)
+  const tids = new Set([...tasks.values()].filter(t=>t.groupId===g).map(t=>t.id));
+  for (const r of [...runs.values()].sort((a,b)=>a.id-b.id)){
+    if (!tids.has(r.taskId)) continue;
+    const ok = ['done','failed','stopped'].includes(r.status) && (r.filesChanged||0)>0 && r.status!=='merged';
+    if (ok && !selected.has(r.id)){ selected.add(r.id); selOrder.push(r.id); }
+  }
+  $('selCnt').textContent = selected.size + ' selected';
+  render();
+  if (!selected.size) toast('no settled runs with changes in this group yet', 'error');
+});
+/* Work | Ask 세그 — Work=행동(spawn/broadcast/converge), Ask=읽기 전용 코디네이터. 방 전용 모드. */
+document.querySelectorAll('#roomSeg .seg-opt').forEach(b=>{
+  b.addEventListener('click', ()=>{
+    roomMode = b.dataset.rmode;
+    roomApplyMode();
+  });
+});
+/* ? Ask — 그룹 스코프 읽기 전용 코디네이터. 절대 발사·steer·쓰기 없음 (POST /ask). */
+$('roomAsk').addEventListener('click', async ()=>{
+  if (roomGroupId==null) return;
+  const message = $('roomInput').value.trim();
+  if (!message){ toast('write a question for the coordinator', 'error'); return; }
+  const real = $('taskReal').checked;
+  const btn = $('roomAsk'); btn.disabled = true;
+  roomTurns.push({ role:'you', text:message });
+  roomRenderConv();
+  $('roomInput').value='';
+  try{
+    const res = await fetch('/api/groups/'+roomGroupId+'/ask',{method:'POST',
+      headers:{'content-type':'application/json'}, body:JSON.stringify({message, real})});
+    const j = await res.json().catch(()=>({}));
+    if (res.ok && j.answer){
+      roomTurns.push({ role:'coord', text:j.answer });
+    } else {
+      roomTurns.push({ role:'coord', text:'(ask failed — '+(j.error||res.status)+')' });
+      toast('ask: '+(j.error||res.status), 'error');
+    }
+    roomRenderConv();
+  } catch { toast('ask request failed', 'error'); }
+  finally { btn.disabled = false; }
+});
+/* WS 라이브 — 그룹 소속 run/event 만 방에 반영 (connectWS 가 호출) */
+function roomOnWS(ev){
+  if (roomGroupId==null) return;
+  if (ev.type==='run'){
+    const rid = ev.runId ?? ev.id;
+    if (!roomRunSet.has(rid)) return;   // 이 방 소속만
+    roomLoad();                          // 상태·steerable 재계산은 aggregate 로 (정확)
+  } else if (ev.type==='event'){
+    if (!roomRunSet.has(ev.runId)) return;
+    const h = humanize({ kind:ev.kind, payload:ev.payload });
+    if (h){
+      const r = roomRuns.find(x=>x.runId===ev.runId);
+      const list = Array.isArray(h) ? h : [h];
+      const frag = list.map(x=>roomFeedLine('r'+ev.runId, r?r.status:'pending', x.k+' · '+x.t, false)).join('');
+      $('roomFeed').insertAdjacentHTML('beforeend', frag);
+      $('roomFeed').scrollTop = $('roomFeed').scrollHeight;
+    }
+  }
+}
 /* ── terminal — 초기크기 접속·자동 재연결(백오프)·unicode11·CJK 폰트 ── */
 let termWS = null, termObj = null, fitAddon = null, termResizeObs = null;
 let termRunId = null, termClosing = false, termRetry = 0, termRetryTimer = null;

package/src/db/index.ts CHANGED Viewed

@@ -98,4 +98,5 @@ export async function ensureSchema(): Promise<void> {
   try { await client.execute("ALTER TABLE agent_runs ADD COLUMN model TEXT NOT NULL DEFAULT ''"); } catch { /* exists */ }
   try { await client.execute('ALTER TABLE tasks ADD COLUMN group_id INTEGER'); } catch { /* exists */ }
   try { await client.execute('ALTER TABLE tasks ADD COLUMN closed_at INTEGER'); } catch { /* exists */ }
+  try { await client.execute("ALTER TABLE task_groups ADD COLUMN coord_session_id TEXT NOT NULL DEFAULT ''"); } catch { /* exists */ }
 }

package/src/db/schema.ts CHANGED Viewed

@@ -37,6 +37,7 @@ export const taskGroups = sqliteTable('task_groups', {
   id: integer('id').primaryKey({ autoIncrement: true }),
   kind: text('kind').notNull().default('goal'), // 'goal' | 'swarm'
   title: text('title').notNull(),
+  coordSessionId: text('coord_session_id').notNull().default(''), // L2 — 읽기전용 Ask 코디네이터의 재개 세션(--resume 키)
   createdAt: integer('created_at', { mode: 'timestamp' }),
 });

package/src/orchestrator.ts CHANGED Viewed

@@ -59,6 +59,11 @@ export function resolveAgentToken(token: string): number | null {
   return agentTokens.get(token) ?? null;
 }
+/** run 이 지금 살아 있는가(자식 프로세스 보유). aggregate 뷰의 live/steerable 판정용. */
+export function isRunLive(runId: number): boolean {
+  return liveChildren.has(runId);
+}
 /** 에이전트 프롬프트에 붙는 능력 고지 — 독립 하위작업을 병렬 서브런으로 뺄 수 있다.
  * 파일 기반: 기본 권한(claude acceptEdits · codex workspace-write)이 네트워크를 막아도
  * 파일 쓰기는 되므로, spawn 요청을 워크트리의 .coxpit/spawn.json 으로 받는다. */
@@ -668,6 +673,25 @@ export async function openWorkbench(repoId: number, title: string): Promise<{
   return { ok: true, detail: 'workbench open', taskId: task.id, runId };
 }
+/**
+ * 그룹에 속한 태스크 1개를 만들고 run 1개를 발사한다(공용 helper).
+ * planFanout(plan 형제) 과 /api/groups/:id/spawn(＋New attempt) 이 공유하는
+ * "태스크 생성(groupId 각인) → run 생성 → 브로드캐스트 → launchRun" 몸통.
+ */
+export async function launchGroupTask(
+  groupId: number, repoId: number, title: string, prompt: string, real: boolean,
+): Promise<{ id: number; title: string; runId: number }> {
+  const rp = await db.select().from(repos).where(eq(repos.id, repoId)).limit(1);
+  const machineId = rp[0]!.machineId;
+  const tIns = await db.insert(tasks).values({ repoId, title: title.slice(0, 140), prompt, groupId }).returning();
+  const task = tIns[0]!;
+  const rIns = await db.insert(agentRuns).values({ taskId: task.id, machineId, agent: 'claude-code', status: 'pending' }).returning();
+  const run = rIns[0]!;
+  broadcast({ type: 'run', runId: run.id, taskId: task.id, status: 'pending', agent: run.agent, branch: '', filesChanged: 0 });
+  void launchRun(run.id, real);
+  return { id: task.id, title: task.title, runId: run.id };
+}
 /**
  * Plan fan-out — 스웜의 입구. 목표 하나를 받아 플래너 에이전트가 repo 를 읽고
  * 독립 실행 가능한 하위 태스크들로 분해 → 각 태스크를 count 1 로 자동 발사한다.
@@ -728,13 +752,7 @@ export async function planFanout(repoId: number, goal: string, real: boolean): P
   const created: Array<{ id: number; title: string; runId: number }> = [];
   for (const t of plan) {
-    const tIns = await db.insert(tasks).values({ repoId, title: t.title, prompt: t.prompt, groupId }).returning();
-    const task = tIns[0]!;
-    const rIns = await db.insert(agentRuns).values({ taskId: task.id, machineId: m.id, agent: 'claude-code', status: 'pending' }).returning();
-    const run = rIns[0]!;
-    broadcast({ type: 'run', runId: run.id, taskId: task.id, status: 'pending', agent: run.agent, branch: '', filesChanged: 0 });
-    void launchRun(run.id, real);
-    created.push({ id: task.id, title: t.title, runId: run.id });
+    created.push(await launchGroupTask(groupId, repoId, t.title, t.prompt, real));
   }
   return { ok: true, detail: `${created.length} task(s) launched`, tasks: created };
 }
@@ -795,6 +813,117 @@ export async function reviewTask(taskId: number, real: boolean): Promise<{ ok: b
   }
 }
+/**
+ * Ask 코디네이터 — 읽기 전용, 재개 가능한 그룹 스코프 Q&A.
+ * 그룹의 형제 run 들에서 {title,status,agent,filesChanged} + 정착 run 의 bounded diff 요약을
+ * 모아 컨텍스트로 주고, 질문에 답만 한다. worktree 를 열지도, run 을 발사하지도, 파일을 쓰지도,
+ * steer 하지도 않는다 — getRunDiff(읽기)와 텍스트 반환뿐. (reviewTask 를 대화형·재개형으로 변형)
+ *
+ * 세션: 첫 호출은 1회용(`bin -p <prompt> --output-format json`)으로 session_id 를 캡처해
+ * task_groups.coord_session_id 에 저장. 이후 호출은 provider.resumeCmd 로 진짜 대화를 잇는다.
+ * 드라이(real=false / COXPIT_AGENT_REAL off)는 결정적 mock + 합성 세션 id 반환(크레딧 0, e2e 안전).
+ */
+export async function askGroupCoordinator(
+  groupId: number, message: string, real: boolean,
+): Promise<{ ok: boolean; detail: string; answer?: string }> {
+  const gr = await db.select().from(taskGroups).where(eq(taskGroups.id, groupId)).limit(1);
+  const group = gr[0];
+  if (!group) return { ok: false, detail: 'group not found' };
+  const msg = message.trim();
+  if (!msg) return { ok: false, detail: 'empty message' };
+  // 그룹의 형제 run 들(태스크 조인) — bounded 컨텍스트만.
+  const gts = await db.select().from(tasks).where(eq(tasks.groupId, groupId));
+  const rows: Array<{ run: typeof agentRuns.$inferSelect; task: typeof tasks.$inferSelect }> = [];
+  for (const t of gts) {
+    const trs = await db.select().from(agentRuns).where(eq(agentRuns.taskId, t.id));
+    for (const run of trs) rows.push({ run, task: t });
+  }
+  rows.sort((a, b) => a.run.id - b.run.id);
+  // repo/machine 은 그룹의 아무 태스크에서 상속(형제는 같은 repo 공유). read-only 는 repo 본체에서.
+  const anyTask = rows[0]?.task ?? gts[0];
+  let machine: MachineTarget | null = null;
+  let repoPath = '';
+  if (anyTask) {
+    const rp = await db.select().from(repos).where(eq(repos.id, anyTask.repoId)).limit(1);
+    const repo = rp[0];
+    if (repo) {
+      repoPath = repo.path;
+      const mr = await db.select().from(machines).where(eq(machines.id, repo.machineId)).limit(1);
+      const m = mr[0];
+      if (m) machine = { slug: m.slug, kind: m.kind, address: m.address, sshUser: m.sshUser };
+    }
+  }
+  // bounded 컨텍스트: run 요약 + 정착 run 의 diff 요약(각 ~1500자, 합 ~12k 상한).
+  const SETTLED = ['done', 'failed', 'stopped', 'merged'];
+  const sections: string[] = [];
+  let budget = 12000;
+  for (const { run, task } of rows) {
+    let sec = `### run r${run.id} — ${task.title.slice(0, 80)}\n`
+      + `status: ${run.status} · agent: ${run.agent} · files changed: ${run.filesChanged}`;
+    if (SETTLED.includes(run.status) && budget > 0) {
+      const d = await getRunDiff(run.id).catch(() => ({ ok: false, diff: '', stat: '' }));
+      const raw = (d.ok ? (d.diff || d.stat || '(no changes)') : '(worktree gone — diff unavailable)');
+      const cap = Math.min(1500, Math.max(0, budget));
+      const clip = raw.slice(0, cap);
+      budget -= clip.length;
+      sec += `\nDiff summary:\n\`\`\`diff\n${clip}\n\`\`\``;
+    }
+    sections.push(sec);
+  }
+  const preamble =
+    `You are a READ-ONLY coordinator for a goal with these parallel attempts. `
+    + `Answer the question about their state and diffs. Do NOT propose running commands, `
+    + `do NOT modify files, do NOT suggest editing anything — you can only observe and explain.`;
+  const context = `Goal: ${group.title}\n\n${sections.join('\n\n') || '(no runs yet)'}`;
+  // 드라이: 결정적 mock 답변 + 합성 세션 id(첫 호출 시 저장, 이후 재사용). e2e 크레딧 0.
+  if (!real) {
+    const done = rows.filter((r) => SETTLED.includes(r.run.status)).length;
+    const running = rows.filter((r) => r.run.status === 'running').length;
+    const answer = `[dry coordinator] ${rows.length} attempt(s) · ${done} settled · ${running} running.\n`
+      + `Q: ${msg.slice(0, 120)}\n`
+      + `(rehearsal answer — read-only; run with Real agent for a substantive reply.)`;
+    if (!group.coordSessionId) {
+      const synth = 'dry-coord-' + randomBytes(6).toString('hex');
+      await db.update(taskGroups).set({ coordSessionId: synth }).where(eq(taskGroups.id, groupId));
+    }
+    return { ok: true, detail: 'rehearsal answer', answer };
+  }
+  if (!machine || !repoPath) return { ok: false, detail: 'group has no repo to run the coordinator from' };
+  // 첫 호출 = 1회용(session_id 캡처), 이후 = resume(대화 이어가기). 둘 다 파일 미변경 read-only.
+  const provider = getProvider('claude-code');
+  let cmd: string;
+  const resuming = !!group.coordSessionId;
+  if (resuming) {
+    // resume 은 stream-json 을 내지만 여기선 마지막 result 만 필요 — json 으로 강제 재래핑 불가하므로
+    // 세션 id 는 이미 있으니 resumeCmd(대화)로 잇고, 최종 텍스트는 result 라인에서 추출한다.
+    cmd = `cd ${shq(repoPath)} && ${provider.resumeCmd(group.coordSessionId, `${preamble}\n\n${context}\n\nQuestion: ${msg}`)} --output-format json`;
+  } else {
+    const oneShot = `${preamble}\n\n${context}\n\nQuestion: ${msg}`;
+    cmd = `cd ${shq(repoPath)} && ${config.agent.bin} -p ${shq(oneShot)} --output-format json`;
+  }
+  const r = await runShellOn(machine, cmd, 300000);
+  if (!r.ok) return { ok: false, detail: 'coordinator failed: ' + (r.stderr || r.stdout).trim().slice(0, 300) };
+  try {
+    const envelope = JSON.parse(r.stdout.trim()) as { result?: string; session_id?: string };
+    const answer = (envelope.result ?? '').trim();
+    if (!answer) throw new Error('empty answer');
+    // 첫 호출에서만 세션 각인(이후엔 유지). resume 응답도 같은 세션이라 덮어써도 무해.
+    if (typeof envelope.session_id === 'string' && envelope.session_id && envelope.session_id !== group.coordSessionId) {
+      await db.update(taskGroups).set({ coordSessionId: envelope.session_id }).where(eq(taskGroups.id, groupId));
+    }
+    return { ok: true, detail: resuming ? 'resumed' : 'answered', answer };
+  } catch (e) {
+    return { ok: false, detail: 'could not parse coordinator answer: ' + String(e).slice(0, 200) };
+  }
+}
 export interface IntegrateResult {
   runId: number;
   status: 'merged' | 'conflict' | 'skipped';

package/src/server.ts CHANGED Viewed

@@ -13,7 +13,7 @@ import { db } from './db';
 import { machines, repos, tasks, agentRuns, agentEvents, designCaptures, shareLinks, taskGroups } from './db/schema';
 import { BOOKMARKLET_JS } from './design';
 import { runShellOn, shq } from './exec';
-import { launchRun, cleanupRun, stopRun, getRunDiff, loadRunDocs, mergeRun, getRunTermInfo, steerRun, exportRun, prRun, integrateRuns, planFanout, reviewTask, syncRun, openWorkbench, spawnSubtasks, listSubtasks, resolveAgentToken, taskCloseRisk } from './orchestrator';
+import { launchRun, cleanupRun, stopRun, getRunDiff, loadRunDocs, mergeRun, getRunTermInfo, steerRun, exportRun, prRun, integrateRuns, planFanout, reviewTask, syncRun, openWorkbench, spawnSubtasks, listSubtasks, resolveAgentToken, taskCloseRisk, launchGroupTask, isRunLive, askGroupCoordinator } from './orchestrator';
 import { openTerm } from './term';
 import { addSink, removeSink, broadcast } from './hub';
 import { getProvider, listProviders } from './providers';
@@ -481,13 +481,19 @@ export async function buildServer(): Promise<FastifyInstance> {
     const q = (req.query ?? {}) as { path?: string };
     const start = q.path && q.path.startsWith('/') ? q.path : homedir();
     const p = presolve(start);
-    let dirs: Array<{ name: string; isRepo: boolean }> = [];
+    let dirs: Array<{ name: string; isRepo: boolean; isEmpty: boolean }> = [];
     let error: string | undefined;
     try {
       const entries = await readdir(p, { withFileTypes: true });
       for (const e of entries) {
         if (!e.isDirectory() || e.name.startsWith('.')) continue;
-        dirs.push({ name: e.name, isRepo: existsSync(pjoin(p, e.name, '.git')) });
+        const full = pjoin(p, e.name);
+        const isRepo = existsSync(pjoin(full, '.git'));
+        // 빈 폴더면 greenfield "Start here" 대상 — 서버 EMPTYDIR 판정(ls -A)과 동일하게
+        // 모든 엔트리(닷파일 포함) 0개일 때만. repo 폴더는 Register 로 다루므로 계산 생략.
+        let isEmpty = false;
+        if (!isRepo) { try { isEmpty = (await readdir(full)).length === 0; } catch { isEmpty = false; } }
+        dirs.push({ name: e.name, isRepo, isEmpty });
         if (dirs.length >= 300) break;
       }
       dirs.sort((a, b) => (b.isRepo ? 1 : 0) - (a.isRepo ? 1 : 0) || a.name.localeCompare(b.name));
@@ -755,6 +761,113 @@ export async function buildServer(): Promise<FastifyInstance> {
     return reply.code(202).send(res);
   });
+  // ─── Goal workroom (v4.6 L1) — 한 그룹(goal/swarm)을 한 방에서 몰기 ────────
+  // steerable = 정착(done/failed/stopped) + sessionId 보유 + worktree 살아있음.
+  // (steerRun 전제 그대로 — 라이브 run 은 steer 불가, 드라이런은 세션 없음.)
+  const groupRuns = async (groupId: number): Promise<{
+    group: typeof taskGroups.$inferSelect;
+    rows: Array<{ run: typeof agentRuns.$inferSelect; task: typeof tasks.$inferSelect }>;
+  } | null> => {
+    const gr = await db.select().from(taskGroups).where(eq(taskGroups.id, groupId)).limit(1);
+    if (!gr[0]) return null;
+    const gts = await db.select().from(tasks).where(eq(tasks.groupId, groupId));
+    const rows: Array<{ run: typeof agentRuns.$inferSelect; task: typeof tasks.$inferSelect }> = [];
+    for (const t of gts) {
+      const trs = await db.select().from(agentRuns).where(eq(agentRuns.taskId, t.id));
+      for (const run of trs) rows.push({ run, task: t });
+    }
+    rows.sort((a, b) => a.run.id - b.run.id);
+    return { group: gr[0], rows };
+  };
+  const isSteerable = (r: typeof agentRuns.$inferSelect): boolean =>
+    !isRunLive(r.id) && ['done', 'failed', 'stopped'].includes(r.status) && !!r.sessionId && !!r.worktreePath;
+  // B1 — 애그리게이트 뷰(방의 chips + 최근 타임라인). 페이로드 다이어트: 최근 200 이벤트만.
+  app.get('/api/groups/:id', async (req, reply) => {
+    const id = Number((req.params as { id: string }).id);
+    const g = await groupRuns(id);
+    if (!g) return reply.code(404).send({ error: 'group not found' });
+    const runs = g.rows.map(({ run, task }) => ({
+      runId: run.id, taskId: task.id, title: task.title, status: run.status,
+      agent: run.agent, model: run.model, branch: run.branch, filesChanged: run.filesChanged,
+      live: isRunLive(run.id), steerable: isSteerable(run),
+    }));
+    const runIds = g.rows.map((x) => x.run.id);
+    // 이벤트: 그룹 run 전체에서 최근 200개(id 순, 오래된 것 먼저 — 방 피드는 append-only).
+    const evs = runIds.length
+      ? (await db.select().from(agentEvents).where(inArray(agentEvents.runId, runIds)))
+          .sort((a, b) => a.id - b.id).slice(-200)
+      : [];
+    return {
+      group: { id: g.group.id, kind: g.group.kind, title: g.group.title, coordSessionId: g.group.coordSessionId },
+      runs,
+      events: evs.map((e) => ({ runId: e.runId, kind: e.kind, payload: e.payload, ts: e.ts })),
+    };
+  });
+  // B2 — "＋ New attempt": 그룹에 새 시도(들)를 발사. repo 는 그룹의 기존 태스크에서 상속.
+  app.post('/api/groups/:id/spawn', async (req, reply) => {
+    const id = Number((req.params as { id: string }).id);
+    const b = (req.body ?? {}) as { title?: string; prompt?: string; count?: number; real?: boolean };
+    const prompt = (b.prompt ?? '').trim();
+    if (!prompt) return reply.code(400).send({ error: 'prompt required' });
+    const g = await groupRuns(id);
+    if (!g) return reply.code(404).send({ error: 'group not found' });
+    if (!g.rows[0]) return reply.code(409).send({ error: 'group has no tasks to inherit a repo from' });
+    const repoId = g.rows[0].task.repoId; // 형제는 같은 repo 를 공유
+    const title = (b.title ?? '').trim() || prompt.slice(0, 40);
+    const count = Math.max(1, Math.min(5, Number(b.count) || 1));
+    const created: Array<{ id: number; title: string; runId: number }> = [];
+    for (let i = 0; i < count; i++) {
+      created.push(await launchGroupTask(id, repoId, title, prompt, b.real === true));
+    }
+    return reply.code(201).send({ ok: true, tasks: created });
+  });
+  // B3 — "→ Broadcast": 그룹의 정착·steerable run 전부에 후속 지시. 라이브/드라이는 정직하게 skip.
+  app.post('/api/groups/:id/steer', async (req, reply) => {
+    const id = Number((req.params as { id: string }).id);
+    const b = (req.body ?? {}) as { message?: string; mode?: string };
+    const message = (b.message ?? '').trim();
+    if (!message) return reply.code(400).send({ error: 'message required' });
+    const g = await groupRuns(id);
+    if (!g) return reply.code(404).send({ error: 'group not found' });
+    const mode = b.mode === 'ask' ? 'ask' : 'work';
+    let steered = 0;
+    const skipped: Array<{ runId: number; reason: string }> = [];
+    let running = 0, noSession = 0;
+    // 그룹 규모가 작아 순차 for 루프로 충분(폭주 fan-out 없음).
+    for (const { run } of g.rows) {
+      const res = await steerRun(run.id, message, mode);
+      if (res.ok) { steered++; continue; }
+      skipped.push({ runId: run.id, reason: res.detail });
+      if (/still running/.test(res.detail)) running++;
+      else if (/no agent session/.test(res.detail)) noSession++;
+    }
+    const parts = [`${steered} steered`];
+    if (running) parts.push(`${running} still running (steer after they settle)`);
+    if (noSession) parts.push(`${noSession} no session`);
+    const otherSkips = skipped.length - running - noSession;
+    if (otherSkips > 0) parts.push(`${otherSkips} skipped`);
+    return { ok: true, steered, skipped, detail: parts.join(' · ') };
+  });
+  // NOTE(v4.6): queuing a broadcast to apply to running runs once they settle is
+  // explicitly out of scope for L1 — running runs are reported as skipped, not queued.
+  // B4 (L2) — "? Ask": 그룹 스코프 읽기 전용 코디네이터. run 발사·steer·파일 쓰기 절대 없음.
+  // askGroupCoordinator 는 getRunDiff(읽기)와 텍스트 반환뿐 — launch/steer/write 경로를 부르지 않는다.
+  app.post('/api/groups/:id/ask', async (req, reply) => {
+    const id = Number((req.params as { id: string }).id);
+    const b = (req.body ?? {}) as { message?: string; real?: boolean };
+    const message = (b.message ?? '').trim();
+    if (!message) return reply.code(400).send({ error: 'message required' });
+    const g = await groupRuns(id);
+    if (!g) return reply.code(404).send({ error: 'group not found' });
+    const res = await askGroupCoordinator(id, message, b.real === true);
+    if (!res.ok) return reply.code(422).send({ error: res.detail });
+    return { ok: true, answer: res.answer };
+  });
   // 통합 — 여러 run(태스크 무관)을 base 에 순차 머지, 충돌은 통합 에이전트 자동 발사.
   app.post('/api/integrate', async (req, reply) => {
     const b = (req.body ?? {}) as { runIds?: number[]; real?: boolean };