npm - coxpit - Versions diffs - 4.1.0 → 4.3.0 - Mend

coxpit 4.1.0 → 4.3.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

@@ -110,7 +110,7 @@ One daemon, one SQLite file, zero external services. Machines are reached over S
 ## Status
-`v4.1` — fleet, two providers (Claude Code · Codex) with per-launch model choice, compare/merge + AI review + doc mode with settle-time snapshots, 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 that render documents, a close guard, and per-repo base branch override — all shipped and e2e-tested (35 checks). Roadmap: ROADMAP.md.
+`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.
 ## License

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "coxpit",
-  "version": "4.1.0",
+  "version": "4.3.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,33 @@ 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}
+  /* ── active/archive view seg + archive list ── */
+  .view-seg{padding:2px;gap:2px}
+  .view-seg .seg-opt{padding:4px 12px;font-size:11.5px}
+  .view-seg .seg-hint{color:var(--faint);margin-left:4px}
+  .arch-bar{display:flex;gap:8px;margin-bottom:12px}
+  .arch-bar input{flex:1}
+  .arch-bar select{flex:0 0 auto}
+  .arch-row{display:flex;align-items:center;gap:14px;padding:10px 14px;border:1px solid var(--line);
+    border-radius:9px;background:var(--surface);margin-bottom:7px;cursor:pointer;transition:border-color .15s}
+  .arch-row:hover{border-color:var(--line-hi)}
+  .ar-title{flex:1;font-weight:600;font-size:13px;overflow:hidden;white-space:nowrap;text-overflow:ellipsis}
+  .ar-runs{font-family:var(--mono);font-size:11px;color:var(--muted);flex:0 1 auto;overflow:hidden;white-space:nowrap;text-overflow:ellipsis;max-width:34%}
+  .ar-repo{font-family:var(--mono);font-size:11px;color:var(--faint);flex:0 0 auto}
+  .ar-date{font-family:var(--mono);font-size:11px;color:var(--faint);flex:0 0 auto}
+  .arch-empty{color:var(--faint);font-family:var(--mono);font-size:12px;padding:30px 0;text-align:center}
+  @media (max-width:860px){.ar-repo{display:none}.ar-runs{max-width:44%}}
   .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}
@@ -372,6 +399,10 @@ export const BOARD_HTML = /* html */ `<!doctype html>
   <button class="btn-ghost sm menu-btn" id="menuBtn" aria-label="open launcher">☰</button>
   <div class="brand"><span class="mark">coxpit</span><span class="sub">fleet console</span></div>
   <span class="daemon-badge" id="daemonBadge" style="display:none"></span>
+  <div class="seg view-seg" id="viewSeg">
+    <button type="button" class="seg-opt on" data-view="active">Active</button>
+    <button type="button" class="seg-opt" data-view="archive">Archive <span id="archN" class="seg-hint"></span></button>
+  </div>
   <div class="ws"><span class="dot" id="wsdot"></span><span id="wstext">connecting</span></div>
   <button class="btn-ghost sm" id="bell" title="notify when a run settles">🔕</button>
   <div class="machines" id="machines"></div>
@@ -457,6 +488,14 @@ export const BOARD_HTML = /* html */ `<!doctype html>
       <span>No runs yet</span>
       <span style="color:#3d4657">register a repo, write a task, hit Run fleet</span>
     </div>
+    <div id="archive" hidden>
+      <div class="arch-bar">
+        <input id="archQ" placeholder="search title…" autocomplete="off" />
+        <select id="archRepo"><option value="">all repos</option></select>
+      </div>
+      <div id="archList"></div>
+      <div style="text-align:center;margin-top:14px"><button class="btn-ghost sm" id="archMore" hidden>load 50 more</button></div>
+    </div>
   </main>
 </div>
@@ -625,6 +664,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);
@@ -828,15 +868,127 @@ 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(){
+  if (boardView==='archive') return;   // 아카이브 뷰는 자체 리스트 — grid 안 건드림
   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();   // 터미널 열려있으면 세션 탭도 동기화
 }
+/* ── active / archive view ─────────────────────────────── */
+let boardView = 'active';
+let archOffset = 0, archTotal = 0;
+const ARCH_LIMIT = 50;
+function setView(v){
+  boardView = v;
+  document.querySelectorAll('#viewSeg .seg-opt').forEach(b=>{
+    const on = b.dataset.view===v;
+    b.classList.toggle('on', on); b.setAttribute('aria-pressed', on?'true':'false');
+  });
+  const archive = v==='archive';
+  $('archive').hidden = !archive;
+  $('grid').style.display = archive ? 'none' : '';
+  $('empty').style.display = archive ? 'none' : ($('grid').innerHTML ? 'none' : 'flex');
+  document.querySelector('.toolbar').style.display = archive ? 'none' : '';
+  if (archive){ paintArchRepos(); archFetch(true); }
+  else render();
+}
+document.querySelectorAll('#viewSeg .seg-opt').forEach(b=>b.addEventListener('click', ()=>setView(b.dataset.view)));
+function paintArchRepos(){
+  const sel = $('archRepo'); const cur = sel.value;
+  sel.innerHTML = '<option value="">all repos</option>' + repos.map(r=>'<option value="'+r.id+'">'+esc(r.name)+'</option>').join('');
+  sel.value = cur;
+}
+function archRowHTML(row){
+  const runs = row.runs.map(r=>'r'+r.id+' '+r.status).join(' · ');
+  const d = row.closedAt ? new Date(row.closedAt*1000) : null;
+  const date = d ? (String(d.getMonth()+1).padStart(2,'0')+'-'+String(d.getDate()).padStart(2,'0')) : '';
+  const grp = row.groupTitle ? '<span class="ar-repo" title="group">⌁ '+esc(row.groupTitle.slice(0,24))+'</span>' : '';
+  return '<div class="arch-row" data-t="'+row.taskId+'">'
+    + '<span class="ar-title">'+esc(row.title)+'</span>'
+    + '<span class="ar-runs">'+esc(runs)+'</span>'+grp
+    + '<span class="ar-repo">'+esc(row.repoName)+'</span>'
+    + '<span class="ar-date">'+date+'</span></div>';
+}
+async function archFetch(reset){
+  if (reset){ archOffset = 0; $('archList').innerHTML = '<div class="arch-empty">loading…</div>'; }
+  const q = encodeURIComponent($('archQ').value.trim());
+  const repo = $('archRepo').value;
+  const url = '/api/archive?offset='+archOffset+'&limit='+ARCH_LIMIT
+    + (q?'&q='+q:'') + (repo?'&repo='+repo:'');
+  try{
+    const j = await fetch(url).then(x=>x.json());
+    archTotal = j.total||0;
+    const rows = (j.rows||[]).map(archRowHTML).join('');
+    if (reset) $('archList').innerHTML = rows || '<div class="arch-empty">no closed tasks match</div>';
+    else $('archList').insertAdjacentHTML('beforeend', rows);
+    archOffset += (j.rows||[]).length;
+    $('archMore').hidden = archOffset >= archTotal || !(j.rows||[]).length;
+  }catch{ $('archList').innerHTML = '<div class="arch-empty">archive failed</div>'; }
+}
+$('archMore').addEventListener('click', ()=>archFetch(false));
+let archTimer = null;
+$('archQ').addEventListener('input', ()=>{ clearTimeout(archTimer); archTimer = setTimeout(()=>archFetch(true), 300); });
+$('archRepo').addEventListener('change', ()=>archFetch(true));
+$('archList').addEventListener('click', async (e)=>{
+  const row = e.target.closest('.arch-row'); if(!row) return;
+  const tid = Number(row.dataset.t);
+  try{
+    const j = await fetch('/api/tasks/'+tid).then(x=>x.json());
+    if (!j.task || !(j.runs||[]).length){ toast('task has no runs', 'error'); return; }
+    tasks.set(j.task.id, j.task);
+    j.runs.forEach(rn => { if(!runs.has(rn.id)) runs.set(rn.id, { ...rn, events: [] }); });
+    openModal(j.runs.map(r=>r.id).sort((a,b)=>a-b)[0]);
+  }catch{ toast('could not open task', 'error'); }
+});
 /* ── first-run onboarding (빈 보드 = 준비 상태 점검 + 시작 안내) ── */
 let readiness = null, probing = false;
 async function probeFirstMachine(){
@@ -898,6 +1050,7 @@ function cardHTML(r){
     + '<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)
@@ -916,10 +1069,13 @@ function upsertRun(patch){
 }
 async function hydrate(){
-  const r = await fetch('/api/fleet').then(x=>x.json());
+  const r = await fetch('/api/fleet?view=active').then(x=>x.json());
   machines = r.machines||[]; repos = r.repos||[]; captures = r.captures||[];
+  if (r.counts){ const n = r.counts.closedTasks||0; $('archN').textContent = n ? '· '+n : ''; }
   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) {
@@ -1033,22 +1189,27 @@ function connectWS(){
   ws.onclose = ()=>{ $('wsdot').classList.remove('on'); $('wstext').textContent='reconnecting'; setTimeout(connectWS,1500); };
   ws.onmessage = (m)=>{
     let ev; try{ ev = JSON.parse(m.data); }catch{ return; }
+    // 아카이브 뷰는 정적 스냅샷 — 라이브 갱신으로 뒤엎지 않는다.
+    if (boardView==='archive' && (ev.type==='run'||ev.type==='event'||ev.type==='task')) return;
     if (ev.type==='run'){
-      const known = runs.has(ev.runId ?? ev.id);
+      const rid = ev.runId ?? ev.id;
+      const known = runs.has(rid);
+      // 아카이브된(맵에 없는) run 의 뒤늦은 echo 는 무시 — 신규는 항상 pending 으로 먼저 온다.
+      if (!known && ev.status && ev.status!=='pending') return;
       upsertRun(ev);
       if (!known && ev.taskId==null){ hydrate(); return; }
       if (ev.taskId!=null && !tasks.has(ev.taskId)) hydrate(); // 통합 태스크 등 신규 태스크 동기화
-      render(); flash(ev.runId ?? ev.id); paintModal();
-      if (openRunId===(ev.runId??ev.id) && ['done','failed','error','stopped'].includes(ev.status)) loadDiff();
+      render(); flash(rid); paintModal();
+      if (openRunId===rid && ['done','failed','error','stopped'].includes(ev.status)) loadDiff();
       if (cmpTaskId!=null && ['done','failed','error','stopped','merged'].includes(ev.status)) paintCompare();
       if (['done','failed','error','stopped'].includes(ev.status)) notifySettleUI(ev);
     } else if (ev.type==='event'){
-      const r = runs.get(ev.runId); if(!r){ hydrate(); return; }
+      const r = runs.get(ev.runId); if(!r) return;   // 아카이브 run 의 이벤트는 무시(맵에 없으면 resurrect X)
       r.events = r.events||[]; r.events.push({ kind:ev.kind, payload:ev.payload });
       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();
     }
@@ -1139,11 +1300,16 @@ $('mDiffWrap').addEventListener('click', (e)=>{
   $('steerInput').value = (f ? f+': ' : '') + '"'+line+'" — ';
   $('steerInput').focus();
 });
-function openModal(id){
+async function openModal(id){
   openRunId = id;
   if (docMode){ docMode=false; $('mDocsTgl').textContent='Rendered'; $('mDiffWrap').innerHTML='<pre class="diff" id="mDiff">loading…</pre>'; }
   $('mDocsTgl').hidden = true;
   paintModal(); $('overlay').classList.add('open'); loadDiff();
+  // fleet 는 run 당 최근 40 이벤트만 내림 — 모달은 전체 타임라인을 다시 가져온다.
+  try{
+    const j = await fetch('/api/runs/'+id).then(x=>x.json());
+    if (j.run){ const r = runs.get(id); if (r){ r.events = j.events||[]; if (openRunId===id) paintModal(); } }
+  }catch{}
 }
 function closeModal(){ openRunId=null; $('overlay').classList.remove('open'); }
 /* ── select mode (integrate) ── */
@@ -1174,6 +1340,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-',''));

package/src/db/index.ts CHANGED Viewed

@@ -83,6 +83,12 @@ export async function ensureSchema(): Promise<void> {
       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 */ }
@@ -90,4 +96,6 @@ export async function ensureSchema(): Promise<void> {
   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 */ }
+  try { await client.execute('ALTER TABLE tasks ADD COLUMN closed_at 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,8 @@ 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)
+  closedAt: integer('closed_at', { mode: 'timestamp' }), // 닫힌 시각(아카이브 정렬·표시)
   createdAt: integer('created_at', { mode: 'timestamp' }),
 });

package/src/orchestrator.ts CHANGED Viewed

@@ -8,7 +8,7 @@ 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, docSnapshots } 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';
@@ -134,9 +134,17 @@ 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[] = [];
@@ -714,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]!;

package/src/server.ts CHANGED Viewed

@@ -6,11 +6,11 @@ import { createRequire } from 'node:module';
 import { randomBytes } from 'node:crypto';
 import Fastify, { type FastifyInstance } from 'fastify';
 import websocket from '@fastify/websocket';
-import { eq } from 'drizzle-orm';
+import { eq, inArray, and, like, desc } 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, loadRunDocs, mergeRun, getRunTermInfo, steerRun, exportRun, prRun, integrateRuns, planFanout, reviewTask, syncRun, openWorkbench, spawnSubtasks, listSubtasks, resolveAgentToken, taskCloseRisk } from './orchestrator';
@@ -170,15 +170,27 @@ export async function buildServer(): Promise<FastifyInstance> {
   app.get('/', async (_req, reply) => reply.type('text/html').send(BOARD_HTML));
   // 보드 하이드레이션 — machines/repos/tasks/runs(+events)/captures 한 방에.
-  app.get('/api/fleet', async () => {
-    const [ms, rs, ts, rns, evs, dcs] = await Promise.all([
+  // 기본 view=active: 닫힌 태스크·그 run·이벤트 전량을 내리지 않는다(수백 run 시 페이로드 폭발 방지).
+  // 이벤트는 활성 run 당 최근 40개만(카드는 8, 모달은 전량 refetch). view=all 은 구버전 전량.
+  const EVENT_CAP = 40;
+  app.get('/api/fleet', async (req) => {
+    const view = ((req.query ?? {}) as { view?: string }).view === 'all' ? 'all' : 'active';
+    const [ms, rs, allTasks, 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 activeTasks = allTasks.filter((t) => t.status !== 'closed');
+    const closedCount = allTasks.length - activeTasks.length;
+    const ts = view === 'all' ? allTasks : activeTasks;
+    const taskIds = new Set(ts.map((t) => t.id));
+    const allRuns = await db.select().from(agentRuns);
+    const rns = view === 'all' ? allRuns : allRuns.filter((r) => taskIds.has(r.taskId));
+    const runIds = rns.map((r) => r.id);
+    // 이벤트는 대상 run 으로 스코프한 뒤 로드(전량 로드 후 슬라이스 = 고치려는 그 버그).
+    const evs = runIds.length ? await db.select().from(agentEvents).where(inArray(agentEvents.runId, runIds)) : [];
     const byRun = new Map<number, Array<{ kind: string; payload: string }>>();
     for (const e of evs) {
       const arr = byRun.get(e.runId) ?? [];
@@ -186,14 +198,45 @@ export async function buildServer(): Promise<FastifyInstance> {
       byRun.set(e.runId, arr);
     }
     return {
-      machines: ms, repos: rs, tasks: ts, captures: dcs,
-      runs: rns.map((r) => ({ ...r, events: byRun.get(r.id) ?? [] })),
+      machines: ms, repos: rs, tasks: ts, captures: dcs, groups: gs,
+      runs: rns.map((r) => ({ ...r, events: (byRun.get(r.id) ?? []).slice(-EVENT_CAP) })),
+      counts: { activeTasks: activeTasks.length, closedTasks: closedCount },
       // 보드 헤더 "어느 데몬에 붙어 있나" 표시용 (인증 뒤라 dbPath 노출 가능)
       daemon: { version: config.version, pid: process.pid, port: config.port, dbPath: config.dbPath },
       providers: listProviders(),
     };
   });
+  // 아카이브 — 닫힌 태스크 목록(최신순, 페이지네이션·필터). 카드가 아니라 한 줄 행.
+  app.get('/api/archive', async (req) => {
+    const q = (req.query ?? {}) as { offset?: string; limit?: string; q?: string; repo?: string; status?: string };
+    const offset = Math.max(0, Number(q.offset) || 0);
+    const limit = Math.min(100, Math.max(1, Number(q.limit) || 50));
+    const conds = [eq(tasks.status, 'closed')];
+    if (q.q) conds.push(like(tasks.title, `%${q.q}%`));
+    if (q.repo) conds.push(eq(tasks.repoId, Number(q.repo)));
+    const where = conds.length === 1 ? conds[0] : and(...conds);
+    let closed = await db.select().from(tasks).where(where).orderBy(desc(tasks.id));
+    // status 필터 = 태스크의 run 중 그 상태를 가진 게 있어야 함(런 로드 후 필터)
+    const repoName = new Map((await db.select().from(repos)).map((r) => [r.id, r.name]));
+    const grpTitle = new Map((await db.select().from(taskGroups)).map((g) => [g.id, g.title]));
+    const total0 = closed.length;
+    const page = closed.slice(offset, offset + limit);
+    const rows = [];
+    for (const t of page) {
+      const rs = await db.select().from(agentRuns).where(eq(agentRuns.taskId, t.id));
+      if (q.status && !rs.some((r) => r.status === q.status)) continue;
+      rows.push({
+        taskId: t.id, title: t.title, repoName: repoName.get(t.repoId) ?? '?',
+        groupTitle: t.groupId != null ? grpTitle.get(t.groupId) ?? null : null,
+        closedAt: t.closedAt ? Math.floor(t.closedAt.getTime() / 1000) : (t.createdAt ? Math.floor(t.createdAt.getTime() / 1000) : 0),
+        runs: rs.map((r) => ({ id: r.id, status: r.status, filesChanged: r.filesChanged, agent: r.agent, model: r.model })),
+      });
+    }
+    // status 필터가 있으면 total 은 근사(페이지 내 필터) — UI 는 rows 로만 판단하니 total0 유지.
+    return { total: total0, rows };
+  });
   // ─── 머신 레지스트리 ────────────────────────────────────────────
   app.get('/api/machines', async () => ({ machines: await db.select().from(machines) }));
@@ -539,7 +582,7 @@ export async function buildServer(): Promise<FastifyInstance> {
     const cleanups = [];
     for (const r of trs) cleanups.push({ runId: r.id, ...(await cleanupRun(r.id)) });
-    await db.update(tasks).set({ status: 'closed' }).where(eq(tasks.id, id));
+    await db.update(tasks).set({ status: 'closed', closedAt: new Date() }).where(eq(tasks.id, id));
     broadcast({ type: 'task', taskId: id, status: 'closed' });
     return { ok: true, taskId: id, cleanups };
   });