npm - coxpit - Versions diffs - 4.0.0 → 4.2.0 - Mend

coxpit 4.0.0 → 4.2.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 (8) hide show

package/README.md CHANGED Viewed

@@ -22,7 +22,8 @@ Your machines. Your auth. Your code never leaves your network.
 - **Design Mode** — drag the `⌖ coxpit inspect` bookmarklet to your bar, click it on your running app, click any element: its selector, HTML and computed styles are captured and injected into the agents' prompt as design context.
 - **Self-orchestrating agents** — every local run can spawn its own sub-agents by writing `.coxpit/spawn.json` in its worktree (works under default permissions — no network, no escalation). The daemon launches each subtask as an isolated sub-run and maintains `.coxpit/subtasks.json` with live status. Orchestration moves inside the agent's own reasoning loop.
 - **Start from GitHub** — paste an issue/PR URL and the task form drafts itself from its title and body (gh CLI for private repos, public API otherwise). You review, pick a provider, Run fleet.
-- **Share a run** — one click mints a read-only snapshot link (timeline + diff, no auth, no actions). Show your fleet's work without opening your cockpit.
+- **Share a run** — one click mints a read-only snapshot link (timeline + diff, and the rendered docs, no auth, no actions). Show your fleet's work without opening your cockpit.
+- **The library** — a run's changed documents (Markdown/HTML) are snapshotted when it settles, so the Rendered view survives merge and Close task. Pick a model per launch (any name your CLI accepts), and a close guard warns before it deletes unmerged, unexported output.
 External tools are spawned, never vendored: `git`, `tmux`, your agent CLI. No editor bundled — terminal-first.
@@ -109,7 +110,7 @@ One daemon, one SQLite file, zero external services. Machines are reached over S
 ## Status
-`v4.0` — fleet, two providers (Claude Code · Codex), compare/merge + AI review + doc mode, terminal (full-screen, session tabs, mobile input bar), swarm (plan fan-out · integrate · agent self-orchestration), sessions (steer/ask · resume), mobile board with deep links, GitHub import, read-only share links — all shipped and e2e-tested (30 checks). Roadmap: ROADMAP.md.
+`v4.2` — everything in v4.1 plus **run grouping**: goal fan-outs and agent swarms cluster into bands on the board (title · N tasks · M settled, with fold, group Select runs, and Close group), and multi-run tasks get `run i/n` attempt counters so same-title cards read as attempts, not duplicates. All shipped and e2e-tested (36 checks). Roadmap: ROADMAP.md.
 ## License

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "coxpit",
-  "version": "4.0.0",
+  "version": "4.2.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

@@ -141,6 +141,17 @@ export const BOARD_HTML = /* html */ `<!doctype html>
   /* ── run cards ──────────────────────────── */
   .grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(360px,1fr));gap:14px}
+  /* ── group bands (goal/swarm 형제 묶음) — 점선 클러스터, 좌측 액센트 바·채움 금지 ── */
+  .gband{grid-column:1/-1;border:1px dashed var(--line-hi);border-radius:14px;padding:12px;margin-bottom:0}
+  .gband-h{display:flex;align-items:center;gap:10px;margin-bottom:10px;font-family:var(--mono)}
+  .gband-glyph{color:var(--brand);font-size:13px}
+  .gband-t{color:var(--ink);font-size:12.5px;font-weight:600;overflow:hidden;white-space:nowrap;text-overflow:ellipsis;max-width:40%}
+  .gband-n{color:var(--faint);font-size:11px}
+  .gband-sp{flex:1}
+  .gband-fold{background:none;border:none;color:var(--muted);cursor:pointer;font-size:12px}
+  .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}
   .card{border:1px solid var(--line);border-radius:var(--r-card);background:var(--surface);
     overflow:hidden;display:flex;flex-direction:column;cursor:pointer;
     transition:border-color .18s,transform .18s,box-shadow .18s}
@@ -164,6 +175,15 @@ export const BOARD_HTML = /* html */ `<!doctype html>
   .ev{display:flex;gap:9px;align-items:baseline;min-width:0}
   .ev .k{color:var(--brand);min-width:78px;flex:none;opacity:.85}
   .ev .t{color:var(--muted);white-space:nowrap;overflow:hidden;text-overflow:ellipsis;flex:1}
+  /* ── closed card — 죽은 카드는 확실히 죽어 보이게(빗금 + CLOSED 스탬프) ── */
+  .card.closed{opacity:.6;filter:saturate(.45)}
+  .card.closed .log{position:relative}
+  .card.closed .log::after{content:'';position:absolute;inset:0;pointer-events:none;
+    background:repeating-linear-gradient(135deg,transparent 0 9px,rgba(255,255,255,.035) 9px 11px)}
+  .card.closed .log::before{content:'CLOSED';position:absolute;top:50%;left:50%;z-index:1;
+    transform:translate(-50%,-50%) rotate(-7deg);font-family:var(--mono);font-size:15px;
+    letter-spacing:.34em;color:var(--faint);border:1px solid var(--line-hi);
+    border-radius:6px;padding:4px 14px;background:rgba(11,13,18,.72)}
   /* ── select mode (integrate) ── */
   .toolbar{display:flex;justify-content:flex-end;gap:8px;margin-bottom:12px}
   .card.selmode{cursor:copy}
@@ -291,6 +311,7 @@ export const BOARD_HTML = /* html */ `<!doctype html>
   .cmp-review p{margin:0 0 8px}
   /* ── doc mode (rendered output) ─────────── */
+  .doc-src{font-family:var(--mono);font-size:10.5px;color:var(--faint);margin-bottom:10px}
   .doc-h{font-family:var(--mono);font-size:10.5px;color:var(--brand);padding:8px 0 4px;
     border-bottom:1px solid var(--line);margin-bottom:8px;word-break:break-all}
   .doc-md{font-size:13px;line-height:1.65;color:var(--muted);margin-bottom:16px;font-family:var(--sans)}
@@ -378,6 +399,7 @@ export const BOARD_HTML = /* html */ `<!doctype html>
       <div class="row">
         <button type="button" class="btn-ghost sm" id="repoBrowse" style="flex:1">Browse…</button>
         <button type="button" class="btn-ghost sm" id="repoManual" style="flex:0 0 auto" title="type an absolute path">Path</button>
+        <button type="button" class="btn-ghost sm" id="repoBranch" style="flex:0 0 auto" title="change the base branch — merges, Sync base and PRs all target it">⎇</button>
         <button type="button" class="btn-ghost sm" id="repoRemove" style="flex:0 0 auto" title="remove selected repository from coxpit">×</button>
       </div>
       <form id="repoForm" hidden>
@@ -404,6 +426,9 @@ export const BOARD_HTML = /* html */ `<!doctype html>
             <button type="button" class="seg-opt on" data-agent="claude-code">Claude</button>
             <button type="button" class="seg-opt" data-agent="codex">Codex</button>
           </div>
+          <p class="flabel">model · optional</p>
+          <input id="taskModel" placeholder="CLI default" list="modelHist" autocomplete="off" />
+          <datalist id="modelHist"></datalist>
           <p class="flabel">design capture · optional</p>
           <select id="taskCapture"><option value="">no design capture</option></select>
         </div>
@@ -565,6 +590,21 @@ export const BOARD_HTML = /* html */ `<!doctype html>
   </div>
 </div>
+<div class="overlay" id="brOverlay">
+  <div class="cfm">
+    <div class="cfm-b">
+      <div class="m">Base branch for this repository</div>
+      <div class="s">Merge, Sync base and PR mode all target this branch. Set it to match your repo's flow (e.g. <span style="color:var(--brand);font-family:var(--mono)">develop</span>). Must already exist in the repo.</div>
+      <p class="flabel" style="margin-top:12px">branch name</p>
+      <input id="brInput" placeholder="main" />
+    </div>
+    <div class="cfm-f">
+      <button class="btn-ghost sm" id="brCancel">Cancel</button>
+      <button class="btn sm" id="brOk">Save</button>
+    </div>
+  </div>
+</div>
 <div class="overlay" id="expOverlay">
   <div class="cfm">
     <div class="cfm-b">
@@ -596,6 +636,7 @@ export const BOARD_HTML = /* html */ `<!doctype html>
 <script>
 const runs = new Map();      // runId -> run object
 const tasks = new Map();     // taskId -> task
+const groups = new Map();    // groupId -> {id, kind, title}
 let repos = [], machines = [], captures = [];
 const $ = (id) => document.getElementById(id);
@@ -799,12 +840,56 @@ function chipHTML(status){
   return '<span class="chip '+(s==='running'?'running':'')+'" style="color:'+statusColor(s)+';border-color:'+statusColor(s)+'">'
     + '<i></i>'+esc(s)+'</span>';
 }
+/* 같은 태스크에 run 이 여럿이면 "run i/n" — 같은 제목 카드가 중복이 아니라 시도로 읽히게 */
+function attemptHTML(r){
+  const sib = [...runs.values()].filter(x=>x.taskId===r.taskId).sort((a,b)=>a.id-b.id);
+  if (sib.length<2) return '';
+  const i = sib.findIndex(x=>x.id===r.id)+1;
+  return '<span class="attempt" title="attempt within this task">run '+i+'/'+sib.length+'</span>';
+}
+/* ── group fold 상태(기기별, WS 재렌더에도 유지) ── */
+let gfold = new Set();
+try{ gfold = new Set(JSON.parse(localStorage.getItem('coxpit.gfold')||'[]')); }catch{}
+function saveGfold(){ try{ localStorage.setItem('coxpit.gfold', JSON.stringify([...gfold])); }catch{} }
+/* 태스크의 모든 run 이 정착했는가 */
+function taskSettled(taskId){
+  const rs = [...runs.values()].filter(r=>r.taskId===taskId);
+  return rs.length>0 && rs.every(r=>['done','failed','stopped','merged'].includes(r.status));
+}
+function bandHTML(g, grpRuns){
+  const glyph = g.kind==='swarm' ? '↳' : '⌁';
+  const title = g.kind==='swarm' ? 'swarm of: '+esc(g.title) : esc(g.title);
+  const taskIds = [...new Set(grpRuns.map(r=>r.taskId))];
+  const settled = taskIds.filter(taskSettled).length;
+  const folded = gfold.has(g.id);
+  const cards = grpRuns.slice().sort((a,b)=>a.id-b.id).map(cardHTML).join('');
+  return '<div class="gband'+(folded?' folded':'')+'" data-g="'+g.id+'">'
+    + '<div class="gband-h"><span class="gband-glyph">'+glyph+'</span>'
+    + '<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" 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>'
+    + '<div class="gband-grid">'+cards+'</div></div>';
+}
 function render(){
   const list = [...runs.values()].sort((a,b)=>b.id-a.id);
   $('empty').style.display = list.length ? 'none' : 'flex';
-  if (!list.length) paintOnboarding();
-  $('grid').innerHTML = list.map(cardHTML).join('');
+  if (!list.length){ paintOnboarding(); $('grid').innerHTML=''; return; }
+  // 그룹 파티션 — grouped run 은 밴드로 클러스터, ungrouped 는 뒤에 flat.
+  const byGroup = new Map(); const flat = [];
+  for (const r of list){
+    const t = tasks.get(r.taskId);
+    const gid = t && t.groupId!=null && groups.has(t.groupId) ? t.groupId : null;
+    if (gid==null) flat.push(r);
+    else { if(!byGroup.has(gid)) byGroup.set(gid, []); byGroup.get(gid).push(r); }
+  }
+  let html = '';
+  for (const gid of [...byGroup.keys()].sort((a,b)=>b-a)) html += bandHTML(groups.get(gid), byGroup.get(gid));
+  html += flat.map(cardHTML).join('');
+  $('grid').innerHTML = html;
   if (termRunId!=null) termTabsRender();   // 터미널 열려있으면 세션 탭도 동기화
 }
@@ -862,13 +947,15 @@ function cardHTML(r){
   const evs = humanLines(r.events).slice(-8).map(h =>
     '<div class="ev"><span class="k">'+esc(h.k)+'</span><span class="t">'+esc(h.t).slice(0,140)+'</span></div>'
   ).join('') || '<div class="ev"><span class="t" style="color:var(--faint)">waiting…</span></div>';
-  const selCls = (selectMode?' selmode':'') + (selected.has(r.id)?' selected':'');
+  const selCls = (selectMode?' selmode':'') + (selected.has(r.id)?' selected':'') + (closed?' closed':'');
   return '<div class="card'+selCls+'" id="card-'+r.id+'">'
     + '<div class="card-h"><span class="rid">r'+r.id+'</span><span class="title">'+title+'</span>'
     + '<span class="selbox">✓</span>'+chipHTML(r.status)+'</div>'
     + '<div class="meta"><span>branch <b>'+esc(r.branch||'—')+'</b></span>'
     + '<span>files <b>'+(r.filesChanged??0)+'</b></span>'
     + '<span>'+esc(r.agent||'')+'</span>'
+    + attemptHTML(r)
+    + (r.model ? '<span title="model">⚙ '+esc(r.model)+'</span>' : '')
     + (task && task.parentRunId ? '<span title="spawned by agent r'+task.parentRunId+'">↳ by r'+task.parentRunId+'</span>' : '')
     + (r.sessionId && ['done','failed','stopped'].includes(r.status)
         ? '<span class="resumable" title="agent session preserved — open the run and Send a next instruction to continue">↻ resumable</span>' : '')
@@ -890,6 +977,8 @@ async function hydrate(){
   machines = r.machines||[]; repos = r.repos||[]; captures = r.captures||[];
   tasks.clear();
   (r.tasks||[]).forEach(t => tasks.set(t.id, t));
+  groups.clear();
+  (r.groups||[]).forEach(g => groups.set(g.id, g));
   runs.clear();
   (r.runs||[]).forEach(rn => runs.set(rn.id, { ...rn, events: rn.events||[] }));
   if (r.daemon) {
@@ -942,6 +1031,26 @@ $('repoRemove').addEventListener('click', async ()=>{
   if (res.ok){ toast('repo removed', 'ok'); hydrate(); }
   else toast('remove: '+(j.detail||res.status), 'error');
 });
+/* ── 기본 브랜치 변경 ── */
+$('repoBranch').addEventListener('click', ()=>{
+  const rid = $('taskRepo').value;
+  if (!rid){ toast('no repository selected', 'error'); return; }
+  const repo = repos.find(r=>String(r.id)===String(rid));
+  $('brInput').value = repo ? repo.defaultBranch : '';
+  $('brOverlay').classList.add('open'); $('brInput').focus();
+});
+$('brCancel').addEventListener('click', ()=>$('brOverlay').classList.remove('open'));
+$('brOverlay').addEventListener('click',(e)=>{ if(e.target===$('brOverlay')) $('brOverlay').classList.remove('open'); });
+async function brSave(){
+  const rid = $('taskRepo').value; const branch = $('brInput').value.trim();
+  if (!rid || !branch) return;
+  const res = await fetch('/api/repos/'+rid,{method:'PATCH',headers:{'content-type':'application/json'},body:JSON.stringify({defaultBranch:branch})});
+  const j = await res.json().catch(()=>({}));
+  if (res.ok){ $('brOverlay').classList.remove('open'); toast('base branch → '+j.defaultBranch, 'ok'); hydrate(); }
+  else toast('branch: '+(j.error||res.status), 'error');
+}
+$('brOk').addEventListener('click', brSave);
+$('brInput').addEventListener('keydown',(e)=>{ if(e.key==='Enter') brSave(); });
 $('repoManual').addEventListener('click', ()=>{
   const f = $('repoForm'); f.hidden = !f.hidden;
   if (!f.hidden) $('repoPath').focus();
@@ -998,7 +1107,7 @@ function connectWS(){
       render(); flash(ev.runId); paintModal();
     } else if (ev.type==='task'){
       const t = tasks.get(ev.taskId);
-      if (t){ t.status = ev.status; render(); paintModal(); } else { hydrate(); }
+      if (t){ if (ev.status!=null) t.status = ev.status; if (ev.groupId!=null) t.groupId = ev.groupId; render(); paintModal(); } else { hydrate(); }
     } else if (ev.type==='capture'){
       captures.push(ev.capture); paintSidebar();
     }
@@ -1028,17 +1137,31 @@ function paintModal(){
 async function loadDiff(){
   if (openRunId==null || docMode) return;
   const pre = $('mDiff'); if (!pre) return;
+  const rid = openRunId;
   pre.textContent = 'loading…'; $('mStat').textContent='';
   try{
-    const d = await fetch('/api/runs/'+openRunId+'/diff').then(x=>x.json());
-    if (!d.ok){ pre.textContent = d.stat||'no worktree'; return; }
+    const d = await fetch('/api/runs/'+rid+'/diff').then(x=>x.json());
+    if (!d.ok){
+      pre.textContent = d.stat||'no worktree';
+      // worktree 는 없지만 스냅샷 문서가 있으면 Rendered 토글 노출(머지·Close 후 뷰어)
+      maybeShowDocsToggle(rid);
+      return;
+    }
     const files = d.stat ? d.stat.split('\\n').filter(Boolean).length : 0;
     $('mStat').textContent = files ? '· '+files+' file'+(files>1?'s':'') : '· clean';
-    // 변경분에 문서(md/html)가 있으면 Rendered 토글 노출
-    $('mDocsTgl').hidden = !/\\.(md|markdown|html?|htm)$/im.test(d.stat||'');
     pre.innerHTML = diffHTML(d.diff||'');
+    // 변경분에 문서(md/html)가 있으면 즉시 노출, 없으면 스냅샷 확인
+    if (/\\.(md|markdown|html?|htm)$/im.test(d.stat||'')) $('mDocsTgl').hidden = false;
+    else maybeShowDocsToggle(rid);
   }catch{ pre.textContent = 'diff failed'; }
 }
+/* worktree 에 라이브 문서가 없을 때만 — 스냅샷이라도 있으면 토글을 켠다 */
+async function maybeShowDocsToggle(rid){
+  try{
+    const j = await fetch('/api/runs/'+rid+'/docs').then(x=>x.json());
+    if (rid===openRunId && (j.docs||[]).length) $('mDocsTgl').hidden = false;
+  }catch{}
+}
 /* ── doc 모드 — diff 대신 렌더된 문서 산출물 ── */
 let docMode = false;
 function docsHTML(docs){
@@ -1053,7 +1176,9 @@ async function paintDocs(){
   $('mDiffWrap').innerHTML = '<span style="color:var(--faint)">rendering…</span>';
   try{
     const d = await fetch('/api/runs/'+openRunId+'/docs').then(x=>x.json());
-    $('mDiffWrap').innerHTML = docsHTML(d.docs||[]);
+    const src = d.source==='snapshot'
+      ? '<div class="doc-src">worktree gone — snapshot taken at settle</div>' : '';
+    $('mDiffWrap').innerHTML = src + docsHTML(d.docs||[]);
   }catch{ $('mDiffWrap').textContent = 'docs failed'; }
 }
 function setDocMode(on){
@@ -1108,6 +1233,51 @@ $('selGo').addEventListener('click', async ()=>{
   } else toast('integrate: '+(j.error||res.status), 'error');
 });
+/* ── 그룹 밴드 액션 (fold / Select runs / Close group) ── */
+$('grid').addEventListener('click', async (e)=>{
+  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]');
+  if (gsel){
+    const g=Number(gsel.dataset.gsel);
+    if (!selectMode) setSelectMode(true);
+    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');
+    return;
+  }
+  const gclose = e.target.closest('[data-gclose]');
+  if (gclose){ await closeGroup(Number(gclose.dataset.gclose)); return; }
+});
+async function closeGroup(g){
+  const tids = [...tasks.values()].filter(t=>t.groupId===g && t.status!=='closed').map(t=>t.id);
+  if (!tids.length){ toast('nothing open in this group', 'ok'); return; }
+  const grp = groups.get(g)||{};
+  const yes = await confirmUI('Close this whole group?',
+    { sub: (grp.title||'group')+' — stops and cleans every worktree/branch of '+tids.length+' task(s).', danger:true, okLabel:'Close group' });
+  if (!yes) return;
+  const closeOne = (id,force)=>fetch('/api/tasks/'+id+'/close',{method:'POST',headers:{'content-type':'application/json'},body:JSON.stringify({force})});
+  const risky = [];
+  for (const id of tids){
+    const res = await closeOne(id,false);
+    if (res.status===409){ const j=await res.json().catch(()=>({})); (j.atRisk||[]).forEach(a=>risky.push(a)); }
+  }
+  if (risky.length){
+    const list = risky.map(a=>'r'+a.runId+' · '+a.filesChanged+' file'+(a.filesChanged>1?'s':'')).join(' · ');
+    const ok = await confirmUI('Close and delete unmerged output?',
+      { danger:true, sub: list+' — not merged, not exported. Worktrees are deleted on close.', okLabel:'Close anyway' });
+    if (!ok){ await hydrate(); return; }
+    for (const id of tids) await closeOne(id,true);
+  }
+  toast('closed '+tids.length+' task'+(tids.length>1?'s':'')+' in the group', 'ok');
+  await hydrate();
+}
 $('grid').addEventListener('click',(e)=>{
   const card = e.target.closest('.card'); if(!card) return;
   const id = Number(card.id.replace('card-',''));
@@ -1125,7 +1295,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'); 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'); $('brOverlay').classList.remove('open'); closeTerm(); closeModal(); cmpTaskId=null; $('cmpOverlay').classList.remove('open'); } });
 $('mRefreshDiff').addEventListener('click', loadDiff);
 $('mExport').addEventListener('click', ()=>{
   if (openRunId==null) return;
@@ -1195,7 +1365,18 @@ $('mCloseTask').addEventListener('click', async ()=>{
   const yes = await confirmUI('Close this task?',
     { sub: 'Stops any live runs and removes every worktree and branch of the task.', danger: true, okLabel: 'Close task' });
   if (!yes) return;
-  await fetch('/api/tasks/'+r.taskId+'/close',{method:'POST'});
+  const close = (force)=>fetch('/api/tasks/'+r.taskId+'/close',{method:'POST',
+    headers:{'content-type':'application/json'}, body:JSON.stringify({force})});
+  let res = await close(false);
+  if (res.status===409){
+    const j = await res.json().catch(()=>({}));
+    const risk = (j.atRisk||[]).map(a=>'r'+a.runId+' · '+a.filesChanged+' file'+(a.filesChanged>1?'s':'')).join(' · ');
+    const ok = await confirmUI('Close and delete unmerged output?',
+      { danger:true, sub: risk+' — not merged, not exported. Worktrees are deleted on close.', okLabel:'Close anyway' });
+    if (!ok) return;
+    res = await close(true);
+  }
+  if (!res.ok){ toast('close failed ('+res.status+')', 'error'); return; }
   toast('task closed — all runs cleaned', 'ok');
   closeModal(); hydrate();
 });
@@ -1511,11 +1692,28 @@ $('taskForm').addEventListener('submit', async (e)=>{
     body:JSON.stringify({repoId,title,prompt:$('taskPrompt').value,designCaptureId:capId})}).then(x=>x.json());
   if (!t.ok){ toast('task create failed', 'error'); return; }
   tasks.set(t.task.id, t.task);
+  const model = $('taskModel').value.trim();
   await fetch('/api/tasks/'+t.task.id+'/run',{method:'POST',headers:{'content-type':'application/json'},
-    body:JSON.stringify({count:Number($('taskCount').value)||1, real: $('taskReal').checked, agent: selAgent})});
+    body:JSON.stringify({count:Number($('taskCount').value)||1, real: $('taskReal').checked, agent: selAgent, model})});
+  if (model) rememberModel(model);
   $('taskTitle').value=''; $('taskPrompt').value='';
 });
+/* ── model 최근값 기억(기기별, 최대 5) ── */
+function rememberModel(m){
+  try{
+    const h = JSON.parse(localStorage.getItem('coxpit.models')||'[]');
+    localStorage.setItem('coxpit.models', JSON.stringify([m, ...h.filter(x=>x!==m)].slice(0,5)));
+  }catch{}
+  paintModelHist();
+}
+function paintModelHist(){
+  let h = [];
+  try{ h = JSON.parse(localStorage.getItem('coxpit.models')||'[]'); }catch{}
+  $('modelHist').innerHTML = h.map(m=>'<option value="'+escA(m)+'"></option>').join('');
+}
+paintModelHist();
 /* ── agent mode segmented control (mirrors hidden #taskReal) ── */
 const segOpts = Array.from(document.querySelectorAll('#modeSeg .seg-opt'));
 function setMode(real, persist){

package/src/db/index.ts CHANGED Viewed

@@ -75,10 +75,26 @@ export async function ensureSchema(): Promise<void> {
       token TEXT NOT NULL UNIQUE,
       created_at INTEGER DEFAULT (unixepoch())
     );
+    CREATE TABLE IF NOT EXISTS doc_snapshots (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      run_id INTEGER NOT NULL,
+      path TEXT NOT NULL,
+      kind TEXT NOT NULL,
+      content TEXT NOT NULL DEFAULT '',
+      created_at INTEGER DEFAULT (unixepoch())
+    );
+    CREATE TABLE IF NOT EXISTS task_groups (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      kind TEXT NOT NULL DEFAULT 'goal',
+      title TEXT NOT NULL,
+      created_at INTEGER DEFAULT (unixepoch())
+    );
   `);
   // 기존 DB 마이그레이션(멱등)
   try { await client.execute('ALTER TABLE tasks ADD COLUMN design_capture_id INTEGER'); } catch { /* exists */ }
   try { await client.execute("ALTER TABLE agent_runs ADD COLUMN session_id TEXT NOT NULL DEFAULT ''"); } catch { /* exists */ }
   try { await client.execute("ALTER TABLE agent_runs ADD COLUMN pr_url TEXT NOT NULL DEFAULT ''"); } catch { /* exists */ }
   try { await client.execute('ALTER TABLE tasks ADD COLUMN parent_run_id INTEGER'); } catch { /* exists */ }
+  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 */ }
 }

package/src/db/schema.ts CHANGED Viewed

@@ -32,6 +32,14 @@ export const designCaptures = sqliteTable('design_captures', {
   createdAt: integer('created_at', { mode: 'timestamp' }),
 });
+/** 태스크 그룹 — 한 goal(plan fan-out)·한 swarm(에이전트 서브태스크)에서 난 형제들. */
+export const taskGroups = sqliteTable('task_groups', {
+  id: integer('id').primaryKey({ autoIncrement: true }),
+  kind: text('kind').notNull().default('goal'), // 'goal' | 'swarm'
+  title: text('title').notNull(),
+  createdAt: integer('created_at', { mode: 'timestamp' }),
+});
 /** 하나의 요청. 여러 AgentRun 으로 병렬 시도됨. */
 export const tasks = sqliteTable('tasks', {
   id: integer('id').primaryKey({ autoIncrement: true }),
@@ -41,6 +49,17 @@ export const tasks = sqliteTable('tasks', {
   status: text('status').notNull().default('open'), // open | done
   designCaptureId: integer('design_capture_id'), // 선택 — 프롬프트에 DESIGN CONTEXT 주입
   parentRunId: integer('parent_run_id'), // 에이전트 셀프 오케스트레이션 — 이 태스크를 발사한 run
+  groupId: integer('group_id'), // task_groups — goal/swarm 형제 묶음(수동 태스크는 NULL)
+  createdAt: integer('created_at', { mode: 'timestamp' }),
+});
+/** 정착·정리 시점에 회수한 문서(md/html) 스냅샷 — worktree 소멸 후에도 렌더 뷰 유지. */
+export const docSnapshots = sqliteTable('doc_snapshots', {
+  id: integer('id').primaryKey({ autoIncrement: true }),
+  runId: integer('run_id').notNull(),
+  path: text('path').notNull(),
+  kind: text('kind').notNull(), // 'md' | 'html'
+  content: text('content').notNull().default(''),
   createdAt: integer('created_at', { mode: 'timestamp' }),
 });
@@ -64,6 +83,7 @@ export const agentRuns = sqliteTable('agent_runs', {
   status: text('status').notNull().default('pending'), // pending | running | waiting | done | error
   sessionId: text('session_id').notNull().default(''), // 에이전트 세션(steer 용 --resume 키)
   prUrl: text('pr_url').notNull().default(''), // PR 모드로 올린 pull request URL
+  model: text('model').notNull().default(''), // 런치별 모델 지정(빈값 = CLI 기본)
   filesChanged: integer('files_changed').notNull().default(0),
   startedAt: integer('started_at', { mode: 'timestamp' }),
   endedAt: integer('ended_at', { mode: 'timestamp' }),

package/src/orchestrator.ts CHANGED Viewed

@@ -8,14 +8,14 @@ import type { ChildProcess } from 'node:child_process';
 import { eq } from 'drizzle-orm';
 import { config } from './config';
 import { db } from './db';
-import { agentRuns, agentEvents, tasks, repos, machines, designCaptures } from './db/schema';
+import { agentRuns, agentEvents, tasks, repos, machines, designCaptures, docSnapshots, taskGroups } from './db/schema';
 import { runShellOn, spawnShellOn, shq, type MachineTarget } from './exec';
 import { broadcast } from './hub';
 import { getProvider, type Provider } from './providers';
 /** 에이전트 실행 커맨드. 드라이런=모의 stream-json + 실제 파일 1건 변경. */
-function agentCommand(provider: Provider, prompt: string, real: boolean): string {
-  if (real) return provider.launchCmd(prompt);
+function agentCommand(provider: Provider, prompt: string, real: boolean, model = ''): string {
+  if (real) return provider.launchCmd(prompt, model || undefined);
   // 모의: init → assistant → (파일 변경) → result. claude stream-json 라인 형태
   // (드라이런은 프로바이더 불문 배관 리허설 — claude 파서가 처리한다).
   return [
@@ -134,15 +134,23 @@ export async function spawnSubtasks(parentRunId: number, title: string, prompt:
   // 폭주 가드 — 한 부모가 만들 수 있는 하위 태스크 상한
   const siblings = await db.select().from(tasks).where(eq(tasks.parentRunId, parentRunId));
   if (siblings.length >= 8) return { ok: false, detail: 'subtask limit reached (8 per run)' };
+  // 그룹 — 부모가 이미 그룹에 속하면 그 그룹, 아니면 swarm 그룹 생성 후 부모까지 백필.
+  let groupId = pt.groupId ?? null;
+  if (groupId == null) {
+    const gIns = await db.insert(taskGroups).values({ kind: 'swarm', title: pt.title.slice(0, 140) }).returning();
+    groupId = gIns[0]!.id;
+    await db.update(tasks).set({ groupId }).where(eq(tasks.id, pt.id));
+    broadcast({ type: 'task', taskId: pt.id, groupId });
+  }
   const n = Math.max(1, Math.min(4, count || 1));
   const tIns = await db.insert(tasks).values({
-    repoId: pt.repoId, title: title.slice(0, 140), prompt, parentRunId,
+    repoId: pt.repoId, title: title.slice(0, 140), prompt, parentRunId, groupId,
   }).returning();
   const task = tIns[0]!;
   const runIds: number[] = [];
   for (let i = 0; i < n; i++) {
     const rIns = await db.insert(agentRuns).values({
-      taskId: task.id, machineId: pr.machineId, agent: pr.agent, status: 'pending',
+      taskId: task.id, machineId: pr.machineId, agent: pr.agent, model: pr.model, status: 'pending',
     }).returning();
     const run = rIns[0]!;
     broadcast({ type: 'run', runId: run.id, taskId: task.id, status: 'pending', agent: run.agent, branch: '', filesChanged: 0 });
@@ -198,6 +206,7 @@ interface RunContext {
   prompt: string;
   real: boolean;
   agent: string;
+  model: string;
 }
 async function loadContext(runId: number): Promise<RunContext | null> {
@@ -237,6 +246,7 @@ async function loadContext(runId: number): Promise<RunContext | null> {
     prompt,
     real: config.agent.real,
     agent: run.agent,
+    model: run.model,
   };
 }
@@ -293,7 +303,7 @@ export async function launchRun(runId: number, real?: boolean): Promise<void> {
       envPrefix = `export COXPIT_API=${shq(`http://127.0.0.1:${config.port}`)} COXPIT_TOKEN=${shq(tok)}; `;
       prompt += orchestrationNote();
     }
-    const cmd = `cd ${shq(wtPath)} && ${envPrefix}${pidPrefix}{ ${agentCommand(provider, prompt, useReal)}; }`;
+    const cmd = `cd ${shq(wtPath)} && ${envPrefix}${pidPrefix}{ ${agentCommand(provider, prompt, useReal, ctx.model)}; }`;
     // 파일 오케스트레이션 — 로컬 run 이 사는 동안 .coxpit/spawn.json 감시.
     // .coxpit/ 는 repo exclude 에 넣어 diff/머지를 오염시키지 않는다(멱등).
     let orchTimer: NodeJS.Timeout | null = null;
@@ -353,9 +363,33 @@ async function runAgentChild(runId: number, machine: MachineTarget, wtPath: stri
   const status = wasStopped ? 'stopped' : code === 0 ? 'done' : 'failed';
   const exitSummary = wasStopped ? 'stopped by user' : lastResult ? lastResult.slice(0, 500) : `exit ${code}`;
   await setRun(runId, { status, endedAt: new Date(), filesChanged, exitSummary });
+  // 문서 산출물을 정착 시점에 스냅샷 — worktree 소멸(머지·Close) 후에도 렌더 뷰 유지. best-effort.
+  if (filesChanged > 0) void snapshotRunDocs(runId);
   void notifySettle(runId, status, filesChanged, exitSummary);
 }
+/**
+ * 변경 문서(md/html)를 DB 에 스냅샷. 최신 우선(기존 행 삭제 후 재삽입).
+ * 빈 읽기(worktree 이미 소멸 등)는 기존 스냅샷을 지우지 않는다.
+ */
+export async function snapshotRunDocs(runId: number): Promise<void> {
+  const d = await getRunDocs(runId).catch(() => null);
+  if (!d?.ok || d.docs.length === 0) return;
+  await db.delete(docSnapshots).where(eq(docSnapshots.runId, runId));
+  for (const doc of d.docs) await db.insert(docSnapshots).values({ runId, path: doc.path, kind: doc.kind, content: doc.content });
+}
+/** worktree(라이브) → 스냅샷 폴백 공용 로더. server 의 /api/runs/:id/docs·/share 가 사용. */
+export async function loadRunDocs(runId: number): Promise<{
+  docs: Array<{ path: string; kind: string; content: string }>; source: 'worktree' | 'snapshot';
+}> {
+  const live = await getRunDocs(runId).catch(() => null);
+  if (live?.ok && live.docs.length > 0) return { docs: live.docs, source: 'worktree' };
+  const snap = await db.select().from(docSnapshots).where(eq(docSnapshots.runId, runId));
+  if (snap.length > 0) return { docs: snap.map((s) => ({ path: s.path, kind: s.kind, content: s.content })), source: 'snapshot' };
+  return { docs: [], source: 'worktree' };
+}
 /** run 정착 웹훅(선택) — COXPIT_WEBHOOK_URL 로 JSON POST. 실패는 무해. */
 async function notifySettle(runId: number, status: string, filesChanged: number, exitSummary: string): Promise<void> {
   if (!config.webhookUrl) return;
@@ -409,7 +443,7 @@ export async function steerRun(runId: number, message: string, mode: 'work' | 'a
   const envPrefix = (!isRemote && config.agentOrch)
     ? `export COXPIT_API=${shq(`http://127.0.0.1:${config.port}`)} COXPIT_TOKEN=${shq(issueAgentToken(runId))}; `
     : '';
-  const resume = provider.resumeCmd(run.sessionId, finalMessage);
+  const resume = provider.resumeCmd(run.sessionId, finalMessage, run.model || undefined);
   const cmd = `cd ${shq(wt)} && ${envPrefix}${pidPrefix}{ ${resume}; }`;
   if (!isRemote && config.agentOrch) {
     const orchTimer = startOrchWatch(runId, wt, true);
@@ -688,9 +722,13 @@ export async function planFanout(repoId: number, goal: string, real: boolean): P
     if (plan.length < 1) return { ok: false, detail: 'planner returned no tasks' };
   }
+  // 이 goal 의 형제들을 한 그룹으로 묶는다(보드 밴드). 드라이 리허설도 동일.
+  const gIns = await db.insert(taskGroups).values({ kind: 'goal', title: goal.slice(0, 140) }).returning();
+  const groupId = gIns[0]!.id;
   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 }).returning();
+    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]!;
@@ -907,11 +945,30 @@ export async function reconcileOrphanRuns(): Promise<number> {
   return stale.length;
 }
+/**
+ * Close 가드 — 태스크 닫으면 worktree 가 삭제되므로, 아직 살릴 곳 없는 산출물을 경고.
+ * 위험 = 정착(done/failed/stopped) ∧ 변경있음 ∧ 미머지 ∧ export·PR 이벤트 없음.
+ */
+export async function taskCloseRisk(taskId: number): Promise<Array<{ runId: number; filesChanged: number }>> {
+  const trs = await db.select().from(agentRuns).where(eq(agentRuns.taskId, taskId));
+  const atRisk: Array<{ runId: number; filesChanged: number }> = [];
+  for (const r of trs) {
+    if (!['done', 'failed', 'stopped'].includes(r.status)) continue;
+    if (r.filesChanged <= 0) continue;
+    const evs = await db.select().from(agentEvents).where(eq(agentEvents.runId, r.id));
+    if (evs.some((e) => e.kind === 'export' || e.kind === 'pr')) continue; // 산출물이 이미 탈출함
+    atRisk.push({ runId: r.id, filesChanged: r.filesChanged });
+  }
+  return atRisk;
+}
 export async function cleanupRun(runId: number): Promise<{ ok: boolean; detail: string }> {
   const ctx = await loadContext(runId);
   const rr = await db.select().from(agentRuns).where(eq(agentRuns.id, runId)).limit(1);
   const run = rr[0];
   if (!ctx || !run || !run.worktreePath) return { ok: false, detail: 'no worktree' };
+  // worktree 를 지우기 전에 문서 스냅샷(정착 안 하는 워크벤치·수정편집도 포착). best-effort.
+  await snapshotRunDocs(runId).catch(() => { /* 스냅샷 실패는 정리를 막지 않음 */ });
   // 원격에 잔존 에이전트가 있으면 worktree 제거 전에 죽인다(파일 잠금·좀비 방지).
   if (ctx.machine.kind !== 'local' && ctx.machine.address !== '') {
     await runShellOn(ctx.machine, remoteKillScript(run.worktreePath), 15000);

package/src/providers.ts CHANGED Viewed

@@ -24,8 +24,9 @@ export interface Provider {
   id: string;
   label: string;
   bin: string;
-  launchCmd(prompt: string): string;
-  resumeCmd(sessionId: string, message: string): string;
+  /** model 비었으면 CLI 기본값 사용(플래그 미첨부). */
+  launchCmd(prompt: string, model?: string): string;
+  resumeCmd(sessionId: string, message: string, model?: string): string;
   /** null = 저장하지 않는 라인(스트림 잡음) */
   parseLine(raw: string): ParsedEvent | null;
 }
@@ -52,13 +53,14 @@ const claudeProvider: Provider = {
   id: 'claude-code',
   label: 'Claude Code',
   get bin() { return config.agent.bin; },
-  launchCmd(prompt: string): string {
+  launchCmd(prompt: string, model?: string): string {
     return `${config.agent.bin} -p ${shq(prompt)} --output-format stream-json --verbose` +
-      ` --permission-mode ${config.agent.perm}`;
+      ` --permission-mode ${config.agent.perm}` + (model ? ` --model ${shq(model)}` : '');
   },
-  resumeCmd(sessionId: string, message: string): string {
+  resumeCmd(sessionId: string, message: string, model?: string): string {
     return `${config.agent.bin} -p --resume ${shq(sessionId)} ${shq(message)}` +
-      ` --output-format stream-json --verbose --permission-mode ${config.agent.perm}`;
+      ` --output-format stream-json --verbose --permission-mode ${config.agent.perm}` +
+      (model ? ` --model ${shq(model)}` : '');
   },
   parseLine(raw: string): ParsedEvent | null {
     const s = raw.trim();
@@ -116,12 +118,14 @@ const codexProvider: Provider = {
   id: 'codex',
   label: 'Codex',
   get bin() { return config.codex.bin; },
-  launchCmd(prompt: string): string {
-    return `${config.codex.bin} exec --json --sandbox ${config.codex.sandbox} ${shq(prompt)}`;
+  launchCmd(prompt: string, model?: string): string {
+    return `${config.codex.bin} exec --json --sandbox ${config.codex.sandbox}` +
+      (model ? ` -m ${shq(model)}` : '') + ` ${shq(prompt)}`;
   },
-  resumeCmd(sessionId: string, message: string): string {
-    // --sandbox 는 exec 의 플래그(resume 서브커맨드는 안 받음) — 반드시 resume 앞에.
-    return `${config.codex.bin} exec --json --sandbox ${config.codex.sandbox} resume ${shq(sessionId)} ${shq(message)}`;
+  resumeCmd(sessionId: string, message: string, model?: string): string {
+    // --sandbox·-m 는 exec 의 플래그(resume 서브커맨드는 안 받음) — 반드시 resume 앞에.
+    return `${config.codex.bin} exec --json --sandbox ${config.codex.sandbox}` +
+      (model ? ` -m ${shq(model)}` : '') + ` resume ${shq(sessionId)} ${shq(message)}`;
   },
   parseLine(raw: string): ParsedEvent | null {
     const s = raw.trim();

package/src/server.ts CHANGED Viewed

@@ -10,10 +10,10 @@ import { eq } from 'drizzle-orm';
 import { authGate } from './auth';
 import { config } from './config';
 import { db } from './db';
-import { machines, repos, tasks, agentRuns, agentEvents, designCaptures, shareLinks } from './db/schema';
+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, getRunDocs, mergeRun, getRunTermInfo, steerRun, exportRun, prRun, integrateRuns, planFanout, reviewTask, syncRun, openWorkbench, spawnSubtasks, listSubtasks, resolveAgentToken } from './orchestrator';
+import { launchRun, cleanupRun, stopRun, getRunDiff, loadRunDocs, mergeRun, getRunTermInfo, steerRun, exportRun, prRun, integrateRuns, planFanout, reviewTask, syncRun, openWorkbench, spawnSubtasks, listSubtasks, resolveAgentToken, taskCloseRisk } from './orchestrator';
 import { openTerm } from './term';
 import { addSink, removeSink, broadcast } from './hub';
 import { getProvider, listProviders } from './providers';
@@ -33,6 +33,31 @@ const VENDOR: Record<string, { pkg: string; rel: string; type: string }> = {
 const escH = (x: unknown): string =>
   String(x ?? '').replace(/[&<>"]/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' }[c]!));
+/** 경량 마크다운 → HTML (보드 mdLite 의 서버측 판, 동일 문법). 입력은 먼저 escH. */
+function mdLiteHTML(src: string): string {
+  let s = escH(src);
+  s = s.replace(/```[a-z]*\n([\s\S]*?)```/g, (_m, c: string) =>
+    '<pre style="background:#0e1118;border:1px solid #222835;border-radius:7px;padding:8px 10px;overflow-x:auto">' + c + '</pre>');
+  s = s.replace(/^### (.+)$/gm, '<h3>$1</h3>');
+  s = s.replace(/^## (.+)$/gm, '<h2>$1</h2>');
+  s = s.replace(/^# (.+)$/gm, '<h2>$1</h2>');
+  s = s.replace(/\*\*([^*]+)\*\*/g, '<strong>$1</strong>');
+  s = s.replace(/`([^`]+)`/g, '<code>$1</code>');
+  s = s.replace(/^[-*] (.+)$/gm, '<li>$1</li>');
+  s = s.replace(/(<li>[\s\S]*?<\/li>)(?!\s*<li>)/g, '<ul>$1</ul>');
+  s = s.split(/\n{2,}/).map((b) => /^<(h2|h3|ul|pre)/.test(b.trim()) ? b : (b.trim() ? '<p>' + b.replace(/\n/g, '<br>') + '</p>' : '')).join('');
+  return s;
+}
+/** 공유 페이지 Documents 섹션 — md 는 mdLiteHTML, html 은 sandbox iframe. */
+function shareDocsHTML(docs: Array<{ path: string; kind: string; content: string }>): string {
+  if (!docs.length) return '';
+  const body = docs.map((d) => d.kind === 'md'
+    ? `<div class="doc"><div class="doc-h">${escH(d.path)}</div><div class="doc-b">${mdLiteHTML(d.content)}</div></div>`
+    : `<div class="doc"><div class="doc-h">${escH(d.path)}</div><iframe sandbox="" class="doc-frame" srcdoc="${escH(d.content)}"></iframe></div>`).join('');
+  return `<div class="sec">Documents</div>${body}`;
+}
 /** 보드 humanize 의 서버측 축약판 — 이벤트 한 줄을 {k, t} 로. null = 잡음. */
 function shareLine(kind: string, payload: string): { k: string; t: string } | null {
   if (kind === 'steer') return { k: 'steer', t: '→ ' + payload };
@@ -82,6 +107,7 @@ function sharePageHTML(
   taskTitle: string,
   events: Array<{ kind: string; payload: string }>,
   diff: string,
+  docs: Array<{ path: string; kind: string; content: string }> = [],
 ): string {
   const lines = events.map((e) => shareLine(e.kind, e.payload)).filter((x): x is { k: string; t: string } => !!x);
   const sc: Record<string, string> = { done: '#3fb970', merged: '#4ec9b0', failed: '#e5534b', error: '#e5534b', stopped: '#a371f7', running: '#4184e4', open: '#4ec9b0' };
@@ -107,6 +133,15 @@ function sharePageHTML(
     font-family:ui-monospace,monospace;font-size:11.5px;line-height:1.5;white-space:pre-wrap;word-break:break-all}
   .f{color:#4ec9b0;font-weight:600}.h{color:#4184e4}.a{color:#3fb970}.d{color:#e5534b}
   .sum{background:#12151c;border:1px solid #222835;border-radius:10px;padding:12px 14px;color:#8792a2;font-size:13px}
+  .doc{margin-bottom:18px}
+  .doc-h{font-family:ui-monospace,monospace;font-size:10.5px;color:#4ec9b0;border-bottom:1px solid #222835;padding-bottom:5px;margin-bottom:8px;word-break:break-all}
+  .doc-b{font-size:13.5px;line-height:1.65;color:#8792a2}
+  .doc-b h1,.doc-b h2{font-size:15px;color:#dee4ec;margin:12px 0 6px}
+  .doc-b h3{font-size:13px;color:#dee4ec;margin:10px 0 4px}
+  .doc-b ul{margin:4px 0 8px;padding-left:18px}.doc-b li{margin-bottom:3px}
+  .doc-b strong{color:#dee4ec}.doc-b p{margin:0 0 8px}
+  .doc-b code{font-family:ui-monospace,monospace;font-size:.9em;background:#0e1118;padding:1px 5px;border-radius:4px;color:#4ec9b0}
+  .doc-frame{width:100%;height:420px;border:1px solid #222835;border-radius:8px;background:#fff}
   .ft{margin-top:40px;color:#3d4657;font-size:12px;font-family:ui-monospace,monospace}
   .ft a{color:#4ec9b0;text-decoration:none}
 </style></head><body><div class="wrap">
@@ -114,6 +149,7 @@ function sharePageHTML(
   <h1>${escH(taskTitle)}</h1>
   <div class="meta">branch ${escH(run.branch || '—')} · ${run.filesChanged} file(s) changed · agent ${escH(run.agent)}</div>
   ${run.exitSummary ? `<div class="sum">${escH(run.exitSummary)}</div>` : ''}
+  ${shareDocsHTML(docs)}
   <div class="sec">Timeline</div>
   <div class="tl">${lines.map((l) => `<div><span class="k">${escH(l.k)}</span><span class="t">${escH(l.t.slice(0, 220))}</span></div>`).join('') || '<span style="color:#5c6675">no events</span>'}</div>
   <div class="sec">Diff</div>
@@ -135,13 +171,14 @@ export async function buildServer(): Promise<FastifyInstance> {
   // 보드 하이드레이션 — machines/repos/tasks/runs(+events)/captures 한 방에.
   app.get('/api/fleet', async () => {
-    const [ms, rs, ts, rns, evs, dcs] = await Promise.all([
+    const [ms, rs, ts, rns, evs, dcs, gs] = await Promise.all([
       db.select().from(machines),
       db.select().from(repos),
       db.select().from(tasks),
       db.select().from(agentRuns),
       db.select().from(agentEvents),
       db.select().from(designCaptures),
+      db.select().from(taskGroups),
     ]);
     const byRun = new Map<number, Array<{ kind: string; payload: string }>>();
     for (const e of evs) {
@@ -150,7 +187,7 @@ export async function buildServer(): Promise<FastifyInstance> {
       byRun.set(e.runId, arr);
     }
     return {
-      machines: ms, repos: rs, tasks: ts, captures: dcs,
+      machines: ms, repos: rs, tasks: ts, captures: dcs, groups: gs,
       runs: rns.map((r) => ({ ...r, events: byRun.get(r.id) ?? [] })),
       // 보드 헤더 "어느 데몬에 붙어 있나" 표시용 (인증 뒤라 dbPath 노출 가능)
       daemon: { version: config.version, pid: process.pid, port: config.port, dbPath: config.dbPath },
@@ -304,6 +341,26 @@ export async function buildServer(): Promise<FastifyInstance> {
     return { ok: true };
   });
+  // 기본 브랜치 변경 — merge·Sync base·PR 이 향할 대상. develop-flow repo 대응.
+  app.patch('/api/repos/:id', async (req, reply) => {
+    const id = Number((req.params as { id: string }).id);
+    const b = (req.body ?? {}) as { defaultBranch?: string };
+    const branch = (b.defaultBranch ?? '').trim();
+    if (!/^[\w.\-/]{1,80}$/.test(branch)) return reply.code(400).send({ error: 'invalid branch name' });
+    const rp = await db.select().from(repos).where(eq(repos.id, id)).limit(1);
+    const repo = rp[0];
+    if (!repo) return reply.code(404).send({ error: 'not found' });
+    const mr = await db.select().from(machines).where(eq(machines.id, repo.machineId)).limit(1);
+    const m = mr[0];
+    if (!m) return reply.code(404).send({ error: 'machine not found' });
+    // branch 는 charset 가드 통과(셸 메타문자 없음). 전체 ref 를 인용해 전달.
+    const check = await runShellOn(m,
+      `git -C ${shq(repo.path)} rev-parse --verify --quiet ${shq('refs/heads/' + branch)} >/dev/null && echo OK`, 10000);
+    if (!check.stdout.includes('OK')) return reply.code(400).send({ error: `branch '${branch}' not found in the repository` });
+    await db.update(repos).set({ defaultBranch: branch }).where(eq(repos.id, id));
+    return { ok: true, defaultBranch: branch };
+  });
   // 디렉토리 브라우저 — repo 등록용 파일 피커(로컬 머신 전용, 인증 게이트 뒤).
   app.get('/api/browse', async (req) => {
     const q = (req.query ?? {}) as { path?: string };
@@ -405,7 +462,7 @@ export async function buildServer(): Promise<FastifyInstance> {
   // N개의 에이전트 run 을 만들고 각자 오케스트레이션 시작(fire-and-forget).
   app.post('/api/tasks/:id/run', async (req, reply) => {
     const id = Number((req.params as { id: string }).id);
-    const b = (req.body ?? {}) as { agent?: string; count?: number; real?: boolean };
+    const b = (req.body ?? {}) as { agent?: string; count?: number; real?: boolean; model?: string };
     const tr = await db.select().from(tasks).where(eq(tasks.id, id)).limit(1);
     const task = tr[0];
     if (!task) return reply.code(404).send({ error: 'task not found' });
@@ -415,10 +472,15 @@ export async function buildServer(): Promise<FastifyInstance> {
     const count = Math.max(1, Math.min(8, Number(b.count) || 1));
     // 미지의 값은 기본 프로바이더로 정규화(런처 조작·API 오타 방어)
     const agent = getProvider(b.agent).id;
+    // 모델 지정(선택) — 셸 안전 문자만, 빈값 = CLI 기본
+    const model = (b.model ?? '').trim();
+    if (model && (model.length > 64 || !/^[\w.\-:/]*$/.test(model))) {
+      return reply.code(400).send({ error: 'invalid model name' });
+    }
     const created: Array<typeof agentRuns.$inferSelect> = [];
     for (let i = 0; i < count; i++) {
       const ins = await db.insert(agentRuns)
-        .values({ taskId: id, machineId: rp[0].machineId, agent, status: 'pending' })
+        .values({ taskId: id, machineId: rp[0].machineId, agent, model, status: 'pending' })
         .returning();
       created.push(ins[0]!);
     }
@@ -458,8 +520,14 @@ export async function buildServer(): Promise<FastifyInstance> {
   // 태스크 닫기 — 살아있는 run 중지 후 소속 run 전체 worktree/브랜치 정리.
   app.post('/api/tasks/:id/close', async (req, reply) => {
     const id = Number((req.params as { id: string }).id);
+    const b = (req.body ?? {}) as { force?: boolean };
     const tr = await db.select().from(tasks).where(eq(tasks.id, id)).limit(1);
     if (!tr[0]) return reply.code(404).send({ error: 'task not found' });
+    // Close 가드 — 아직 살릴 곳 없는 산출물(미머지·미export·무PR)이 있으면 확인 요구.
+    if (!b.force) {
+      const atRisk = await taskCloseRisk(id);
+      if (atRisk.length) return reply.code(409).send({ error: 'unmerged output', atRisk });
+    }
     const trs = await db.select().from(agentRuns).where(eq(agentRuns.taskId, id));
     let anyStopped = false;
@@ -603,12 +671,13 @@ export async function buildServer(): Promise<FastifyInstance> {
     return getRunDiff(id);
   });
-  // Doc 모드 — 변경된 문서(md/html)를 내용째 (렌더 비교용, 읽기 전용)
+  // Doc 모드 — 변경된 문서(md/html) 내용째 (렌더 뷰). worktree 라이브 → 스냅샷 폴백.
   app.get('/api/runs/:id/docs', async (req, reply) => {
     const id = Number((req.params as { id: string }).id);
     const rr = await db.select().from(agentRuns).where(eq(agentRuns.id, id)).limit(1);
     if (!rr[0]) return reply.code(404).send({ error: 'not found' });
-    return getRunDocs(id);
+    const { docs, source } = await loadRunDocs(id);
+    return { ok: true, docs, source };
   });
   // ─── 에이전트 셀프 오케스트레이션 (run 별 Bearer 토큰 — authGate 예외, 여기서 자체 검증) ──
@@ -693,7 +762,8 @@ export async function buildServer(): Promise<FastifyInstance> {
     const task = (await db.select().from(tasks).where(eq(tasks.id, run.taskId)).limit(1))[0];
     const evs = await db.select().from(agentEvents).where(eq(agentEvents.runId, run.id));
     const d = await getRunDiff(run.id).catch(() => ({ ok: false, diff: '', stat: '' }));
-    return reply.type('text/html').send(sharePageHTML(run, task?.title ?? `task ${run.taskId}`, evs, d.ok ? d.diff : ''));
+    const { docs } = await loadRunDocs(run.id);
+    return reply.type('text/html').send(sharePageHTML(run, task?.title ?? `task ${run.taskId}`, evs, d.ok ? d.diff : '', docs));
   });
   // 라이브 스트림 좌석 — 오케스트레이터가 run/event 를 여기로 broadcast.