@hueyexe/opencode-ensemble 0.20.0 → 0.21.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hueyexe/opencode-ensemble",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "Agent teams for OpenCode — parallel agents with peer-to-peer communication, shared tasks, and coordinated execution",
   "module": "src/index.ts",
   "main": "dist/index.js",

package/src/config.ts

@@ -17,6 +17,8 @@ export interface EnsembleConfig {
   rateLimitCapacity?: number
   /** Dashboard server port (default: 4747, 0 to disable) */
   dashboardPort?: number
+  /** Dashboard bind address (default: 127.0.0.1) */
+  dashboardHost?: string
   /** Max peer messages per agent per window before nudge (default: 5, 0 to disable) */
   peerMessageLimit?: number
   /** Time window for peer message rate limiting in ms (default: 300000 = 5 min) */
@@ -31,6 +33,18 @@ export interface EnsembleConfig {
   modelAssignment?: "default" | "rotate" | "random"
   /** Lead asks user about model preferences before spawning (default: false) */
   promptForModels?: boolean
+  /** Max task dependency depth (default: 0 = unlimited). Roots count as depth 1. */
+  taskDepthLimit?: number
+  /** What to do when a task would exceed taskDepthLimit (default: "lead_resolve"). */
+  taskDepthLimitOverflowAction?: "lead_resolve" | "user_resolve"
+  /**
+   * How much live team state to inject into the system prompt:
+   * "full" (default) includes statuses, tasks, and message payloads;
+   * "state-only" drops message payloads (use team_results);
+   * "off" injects only stable role/workflow guidance.
+   * Lower settings avoid invalidating provider prefix caches on every change.
+   */
+  systemPromptTeamState?: "full" | "state-only" | "off"
 }
 
 /** Default configuration values. */
@@ -42,6 +56,7 @@ export const DEFAULT_CONFIG: Required<EnsembleConfig> = {
   timeoutMs: 30 * 60 * 1000,
   rateLimitCapacity: 10,
   dashboardPort: 4747,
+  dashboardHost: "127.0.0.1",
   peerMessageLimit: 5,
   peerMessageWindowMs: 300_000,
   defaultModel: "",
@@ -49,6 +64,9 @@ export const DEFAULT_CONFIG: Required<EnsembleConfig> = {
   modelsByAgent: {},
   modelAssignment: "default",
   promptForModels: false,
+  systemPromptTeamState: "full",
+  taskDepthLimit: 0,
+  taskDepthLimitOverflowAction: "lead_resolve",
 }
 
 /** Read a JSON config file, returning an empty object on missing/invalid. */
@@ -65,6 +83,7 @@ function readConfigFile(filePath: string): Partial<EnsembleConfig> {
     if (typeof raw.timeoutMs === "number") result.timeoutMs = raw.timeoutMs
     if (typeof raw.rateLimitCapacity === "number") result.rateLimitCapacity = raw.rateLimitCapacity
     if (typeof raw.dashboardPort === "number") result.dashboardPort = raw.dashboardPort
+    if (typeof raw.dashboardHost === "string") result.dashboardHost = raw.dashboardHost
     if (typeof raw.peerMessageLimit === "number") result.peerMessageLimit = raw.peerMessageLimit
     if (typeof raw.peerMessageWindowMs === "number") result.peerMessageWindowMs = raw.peerMessageWindowMs
     if (typeof raw.defaultModel === "string") result.defaultModel = raw.defaultModel
@@ -75,6 +94,20 @@ function readConfigFile(filePath: string): Partial<EnsembleConfig> {
     }
     if (typeof raw.modelAssignment === "string" && ["default", "rotate", "random"].includes(raw.modelAssignment)) result.modelAssignment = raw.modelAssignment as "default" | "rotate" | "random"
     if (typeof raw.promptForModels === "boolean") result.promptForModels = raw.promptForModels
+    if (typeof raw.systemPromptTeamState === "string" && ["full", "state-only", "off"].includes(raw.systemPromptTeamState)) {
+      result.systemPromptTeamState = raw.systemPromptTeamState as "full" | "state-only" | "off"
+    }
+    // Accept the issue #42 snake_case spellings as aliases; camelCase wins.
+    const depthLimit = typeof raw.taskDepthLimit === "number" ? raw.taskDepthLimit : raw.depth_limit
+    if (typeof depthLimit === "number" && Number.isInteger(depthLimit) && depthLimit >= 0) {
+      result.taskDepthLimit = depthLimit
+    }
+    const overflow = typeof raw.taskDepthLimitOverflowAction === "string"
+      ? raw.taskDepthLimitOverflowAction
+      : raw.depth_limit_overflow_action
+    if (overflow === "lead_resolve" || overflow === "user_resolve") {
+      result.taskDepthLimitOverflowAction = overflow
+    }
     return result
   } catch (err) {
     if (err && typeof err === "object" && "code" in err && err.code === "ENOENT") return {}

package/src/dashboard-html.ts

@@ -32,6 +32,27 @@ select{-webkit-appearance:none;appearance:none;background-image:url("data:image/
 #content.nav-collapsed{grid-template-columns:2rem minmax(0,1fr)}
 #projects[hidden]{display:none!important}
 #project-rail[hidden]{display:none!important}
+.dashboard-panel[hidden]{display:none!important}
+.dashboard-tabs{display:flex;gap:24px;border-bottom:1px solid #2a3144;margin-bottom:16px}
+.dashboard-tab{background:none;border:0;border-bottom:2px solid transparent;padding:8px 0 10px;color:#8a96aa;font-size:12px}
+.dashboard-tab[aria-selected="true"]{color:#e2e8f0;border-bottom-color:#60a5fa}
+.graph-toolbar{display:flex;align-items:center;justify-content:space-between;gap:12px;margin-bottom:12px;flex-wrap:wrap}
+.graph-scroll{overflow:auto;max-height:65vh;border:1px solid #1e2433;border-radius:8px;background:#0f131c}
+.graph-canvas{position:relative;background-image:radial-gradient(#2a314480 1px,transparent 1px);background-size:22px 22px}
+.graph-edges{position:absolute;inset:0;pointer-events:none}
+.graph-card{position:absolute;width:280px;height:172px;background:#141822;border:1px solid #2a3144;border-radius:8px;padding:12px;text-align:left;color:#e2e8f0;font-size:12px;cursor:pointer}
+.graph-card:hover{border-color:#60a5fa}.graph-card[aria-pressed="true"]{outline:2px solid #60a5fa;outline-offset:1px}
+.graph-card.graph-running{border-color:#3b82f680}.graph-card.graph-done{border-color:#22c55e60}.graph-card.graph-blocked{border-color:#f59e0b60}
+.graph-card-head{display:flex;align-items:center;gap:6px;min-width:0}.graph-card-name{font-family:monospace;font-weight:600;font-size:13px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;flex:1}
+.graph-card-task{font-size:13px;line-height:18px;height:54px;margin:8px 0 4px;display:-webkit-box;-webkit-line-clamp:3;-webkit-box-orient:vertical;overflow:hidden}
+.graph-card-meta{color:#8a96aa;font-size:10px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;margin-top:3px}
+.graph-card-foot{display:flex;align-items:center;gap:6px;margin-top:5px;white-space:nowrap}
+.graph-warning{border:1px solid #f59e0b60;background:#f59e0b0d;color:#fbbf24;padding:10px 12px;margin-bottom:10px;border-radius:6px;font-size:12px;overflow-wrap:anywhere}
+.graph-detail{border:1px solid #1e2433;background:#141822;border-radius:8px;padding:14px;margin-top:12px;font-size:12px;overflow-wrap:anywhere}
+.graph-detail-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:16px;margin-top:12px}
+.graph-detail-link{display:block;text-align:left;color:#c1c9d9;margin-top:6px;text-decoration:underline;text-underline-offset:3px}
+.graph-legend{display:flex;flex-wrap:wrap;gap:14px;margin-top:10px;color:#8a96aa;font-size:11px}
+@media(max-width:640px){.graph-detail-grid{grid-template-columns:1fr}.graph-scroll{max-height:55vh}}
 .xp{max-height:0;overflow:hidden;transition:max-height .3s ease-out}.xp-open{max-height:3000px;transition:max-height .5s ease-in}
 .card-sel{outline:2px solid rgba(59,130,246,.4);outline-offset:1px}
 .md pre{background:#1a1f2e;border:1px solid #1e2433;border-radius:6px;padding:8px 12px;overflow-x:auto;margin:6px 0;font-size:12px;line-height:1.5}
@@ -76,13 +97,25 @@ select{-webkit-appearance:none;appearance:none;background-image:url("data:image/
 <aside id="projects" aria-label="Project navigation" class="bg-base-950/60 border-r border-base-800/70 pr-3 lg:sticky lg:top-[88px]"></aside>
 <div class="min-w-0">
 <section id="attention" aria-label="Team attention" class="mb-3"></section>
-<div class="grid grid-cols-1 xl:grid-cols-[minmax(360px,1.35fr)_minmax(320px,.8fr)] gap-4 items-start">
+<div role="tablist" aria-label="Dashboard views" class="dashboard-tabs">
+<button id="tab-overview" type="button" role="tab" aria-selected="true" aria-controls="panel-overview" class="dashboard-tab" data-dashboard-tab="overview">Overview</button>
+<button id="tab-dependencies" type="button" role="tab" aria-selected="false" aria-controls="panel-dependencies" tabindex="-1" class="dashboard-tab" data-dashboard-tab="dependencies">Dependency graph</button>
+</div>
+<div id="panel-overview" role="tabpanel" aria-labelledby="tab-overview" class="dashboard-panel grid grid-cols-1 xl:grid-cols-[minmax(360px,1.35fr)_minmax(320px,.8fr)] gap-4 items-start">
 <section aria-label="Agent roster"><div id="agents" class="grid gap-2" style="grid-template-columns:repeat(auto-fill,minmax(300px,1fr))"></div></section>
 <div class="grid grid-cols-1 gap-4">
 <section aria-label="Task board"><div id="tasks" class="bg-base-900 rounded-lg p-3 border border-base-800/50"></div></section>
 <section aria-label="Activity feed"><div id="activity" class="bg-base-900 rounded-lg p-3 border border-base-800/50"></div></section>
 </div>
 </div>
+<section id="panel-dependencies" role="tabpanel" aria-labelledby="tab-dependencies" class="dashboard-panel" hidden>
+<div class="graph-toolbar"><div><h2 class="text-[14px] font-semibold">Task dependencies</h2><p id="graph-description" class="text-[11px] text-txt-400 mt-1">Prerequisite → dependent · Select a task to inspect its agent and dependencies</p></div><button type="button" id="graph-reset" class="text-[11px] text-txt-300 border border-base-700 rounded px-2 py-1">Reset view</button></div>
+<div id="graph-content">
+<div id="graph-scroll" class="graph-scroll scroll" tabindex="0" aria-label="Task dependency graph" aria-describedby="graph-description"></div>
+<div class="graph-legend"><span class="text-emerald-400">✓ Completed prerequisite</span><span class="text-blue-400">● In progress</span><span class="text-amber-400">○ Blocked</span><span>→ Dependency direction</span></div>
+<div id="graph-detail" class="graph-detail" aria-live="polite"></div>
+</div>
+</section>
 </div>
 </div>
 </main>

package/src/dashboard-js-events.ts

@@ -47,6 +47,7 @@ function render(){
   applyNavCollapse();
   const p=curProject();document.getElementById('crumb').textContent=p?' / '+projectLabel(p)+' / '+t.name:'';
   rHealth(t);rSum(t);rAttention(t);rAgents(t);rTasks(t);rActivity(t);rTimeline(t);
+  rGraph(t);
 }
 
 function selectProject(id){selProjectId=id;const p=S?.projects?.find(p=>p.id===id);const t=(p?.teams||[]).filter(t=>t.status==='active').sort((a,b)=>b.timeUpdated-a.timeUpdated)[0]||(p?.teams||[])[0];if(t)selId=t.id;selCard=-1;render()}
@@ -99,6 +100,12 @@ setInterval(function(){var t=cur();if(t)rClock(t);if(fails<3)conn(true)},1000);
 setInterval(poll,2500);
 
 document.addEventListener('click',function(e){
+  const button=e.target.closest?.('button');
+  if(button?.dataset.dashboardTab){selectDashboardTab(button.dataset.dashboardTab);return}
+  if(button?.id==='graph-reset'){resetGraphView();return}
+  if(button?.dataset.graphTask!==undefined){selectGraphTask(button.dataset.graphTask);return}
+  if(button?.dataset.graphSelect!==undefined){selectGraphTask(button.dataset.graphSelect);return}
+  if(button?.dataset.graphAgent!==undefined){openDrawer(button.dataset.graphAgent);return}
   const id=e.target&&e.target.id;
   if(id!=='nav-toggle'&&id!=='nav-expand')return;
   navCollapsed=id==='nav-toggle';
@@ -115,6 +122,8 @@ document.addEventListener('keydown',function(e){
   if(drawerOpen&&e.key==='Escape'){e.preventDefault();closeDrawer();return}
   if(drawerOpen&&e.key==='?'){e.preventDefault();return}
   if(e.target.tagName==='INPUT'||e.target.tagName==='SELECT'||e.target.tagName==='TEXTAREA')return;
+  if(e.target.closest?.('[role="tablist"]')){graphTabKeydown(e);return}
+  if(e.target.closest?.('#panel-dependencies')&&e.key!=='Escape'&&e.key!=='?')return;
   var t=cur();if(!t)return;
   var mm=[...(t.members||[])].sort((a,b)=>rankAgent(a,b,t));
   if(e.key==='?'){e.preventDefault();shortcutsOpen?closeShortcuts():openShortcuts();return}

package/src/dashboard-js-graph-layout.ts

@@ -0,0 +1,40 @@
+/** Dashboard JS — deterministic task dependency layout, shared with graph rendering. */
+export const DASHBOARD_JS_GRAPH_LAYOUT = `
+const GRAPH_CARD_WIDTH=280,GRAPH_CARD_HEIGHT=172,GRAPH_GAP_X=88,GRAPH_GAP_Y=32,GRAPH_PADDING=24;
+function graphDependencies(task){return [...new Set(Array.isArray(task.dependsOn)?task.dependsOn:[])]}
+function graphLayout(tasks){
+  const byId=new Map(tasks.map(task=>[task.id,task])),edges=[],missing=[];
+  const degree=new Map(),children=new Map(),depth=new Map();
+  tasks.forEach(task=>{degree.set(task.id,0);children.set(task.id,[]);depth.set(task.id,0)});
+  tasks.forEach(task=>{
+    graphDependencies(task).forEach(id=>{
+      if(!byId.has(id)){missing.push({taskId:task.id,dependencyId:id});return}
+      edges.push({from:id,to:task.id});
+      degree.set(task.id,degree.get(task.id)+1);
+      children.get(id).push(task.id);
+    });
+  });
+  const queue=tasks.filter(task=>degree.get(task.id)===0).map(task=>task.id);
+  let head=0;
+  while(head<queue.length){
+    const id=queue[head++];
+    children.get(id).forEach(child=>{
+      depth.set(child,Math.max(depth.get(child),depth.get(id)+1));
+      degree.set(child,degree.get(child)-1);
+      if(degree.get(child)===0)queue.push(child);
+    });
+  }
+  const cyclic=tasks.filter(task=>degree.get(task.id)>0).map(task=>task.id);
+  const fallback=queue.reduce((max,id)=>Math.max(max,depth.get(id)+1),0);
+  cyclic.forEach(id=>depth.set(id,fallback));
+  const rows=new Map();
+  const nodes=tasks.map(task=>{
+    const column=depth.get(task.id),row=rows.get(column)||0;
+    rows.set(column,row+1);
+    return {task,x:GRAPH_PADDING+column*(GRAPH_CARD_WIDTH+GRAPH_GAP_X),y:GRAPH_PADDING+row*(GRAPH_CARD_HEIGHT+GRAPH_GAP_Y)};
+  });
+  const width=nodes.reduce((max,node)=>Math.max(max,node.x+GRAPH_CARD_WIDTH+GRAPH_PADDING),GRAPH_CARD_WIDTH+2*GRAPH_PADDING);
+  const height=nodes.reduce((max,node)=>Math.max(max,node.y+GRAPH_CARD_HEIGHT+GRAPH_PADDING),GRAPH_CARD_HEIGHT+2*GRAPH_PADDING);
+  return {nodes,edges,missing,cyclic,width,height};
+}
+`;

package/src/dashboard-js-graph.ts

@@ -0,0 +1,99 @@
+/** Dashboard JS — dependency graph view, task inspection, and tab interactions. */
+export const DASHBOARD_JS_GRAPH = `
+let dashboardTab='overview',graphSelectedId=null,graphTeamId=null,graphRenderedMarkup=null;
+function selectDashboardTab(view){
+  dashboardTab=view==='dependencies'?'dependencies':'overview';
+  ['overview','dependencies'].forEach(name=>{
+    const active=dashboardTab===name,tab=document.getElementById('tab-'+name);
+    tab.setAttribute('aria-selected',String(active));tab.tabIndex=active?0:-1;
+    document.getElementById('panel-'+name).hidden=!active;
+  });
+  const team=cur();if(team)rGraph(team);
+}
+function graphTabKeydown(e){
+  if(!['ArrowLeft','ArrowRight','Home','End'].includes(e.key))return;
+  e.preventDefault();
+  const view=e.key==='Home'?'overview':e.key==='End'?'dependencies':e.target.id==='tab-overview'?'dependencies':'overview';
+  selectDashboardTab(view);document.getElementById('tab-'+view).focus();
+}
+function rGraph(team){
+  const switched=graphTeamId!==team.id;
+  if(switched){graphTeamId=team.id;graphSelectedId=null;graphRenderedMarkup=null;resetGraphView()}
+  if(graphSelectedId!==null&&!(team.tasks||[]).some(task=>task.id===graphSelectedId))graphSelectedId=null;
+  if(dashboardTab!=='dependencies')return;
+  const root=document.getElementById('graph-content'),scroll=document.getElementById('graph-scroll');
+  const left=scroll.scrollLeft,top=scroll.scrollTop,focused=document.activeElement;
+  const focusData=root.contains(focused)?{task:focused.dataset?.graphTask,select:focused.dataset?.graphSelect,agent:focused.dataset?.graphAgent,scroll:focused.id==='graph-scroll'}:null;
+  const html=graphMarkup(team,graphLayout(team.tasks||[]),graphSelectedId);
+  // SVG serialization expands self-closing paths; compare generated markup, not DOM HTML.
+  if(graphRenderedMarkup===html)return;
+  patch(root,html);graphRenderedMarkup=html;
+  if(focusData){
+    const target=focusData.scroll?document.getElementById('graph-scroll'):[...root.querySelectorAll('button')].find(button=>
+      (focusData.task!==undefined&&button.dataset.graphTask===focusData.task)||
+      (focusData.select!==undefined&&button.dataset.graphSelect===focusData.select)||
+      (focusData.agent!==undefined&&button.dataset.graphAgent===focusData.agent));
+    if(target)target.focus({preventScroll:true});else document.getElementById('graph-scroll').focus({preventScroll:true});
+  }
+  const nextScroll=document.getElementById('graph-scroll');nextScroll.scrollLeft=left;nextScroll.scrollTop=top;
+}
+function selectGraphTask(id){const team=cur();if(!team||!(team.tasks||[]).some(task=>task.id===id))return;rGraph(team);graphSelectedId=id;rGraph(team)}
+function resetGraphView(){const scroll=document.getElementById('graph-scroll');if(scroll){scroll.scrollLeft=0;scroll.scrollTop=0}}
+function graphTaskInfo(task,byId){
+  const deps=graphDependencies(task),waiting=deps.filter(id=>!['completed','cancelled'].includes(byId.get(id)?.status));
+  const terminal=task.status==='completed'||task.status==='cancelled',blocked=!terminal&&(task.status==='blocked'||waiting.length>0);
+  const color=task.status==='completed'?'green':blocked?'amber':task.status==='in_progress'?'blue':'muted';
+  return {deps,waiting,blocked,color,hint:terminal?'':waiting.length?'Blocked by '+waiting.length+' prerequisite'+(waiting.length===1?'':'s'):deps.length?'Prerequisites satisfied':'No prerequisites'};
+}
+function graphCard(node,team,byId,selectedId,cyclic){
+  const task=node.task,member=(team.members||[]).find(m=>m.name===task.assignee),info=graphTaskInfo(task,byId);
+  const state=member?si(member.status):null;
+  const tone=task.status==='completed'?'graph-done':info.blocked?'graph-blocked':task.status==='in_progress'?'graph-running':'';
+  return '<button type="button" class="graph-card '+tone+'" style="left:'+node.x+'px;top:'+node.y+'px" data-graph-task="'+E(task.id)+'" aria-pressed="'+String(task.id===selectedId)+'" title="'+E(task.content)+'">'+
+    '<div class="graph-card-head"><span class="graph-card-name">'+E(task.assignee||'Unassigned')+'</span>'+(state?chip('agent '+state.l,member.status==='busy'?'blue':member.status==='error'?'red':'muted'):'')+'</div>'+
+    '<div class="graph-card-task">'+E(task.content)+'</div>'+
+    '<div class="graph-card-meta">'+E(member?[member.agent,member.model].filter(Boolean).join(' · '):task.assignee?'Agent not in roster':'No agent assigned')+'</div>'+
+    '<div class="graph-card-foot">'+chip(E(String(task.status).replace(/_/g,' ')),info.color)+chip(E(task.priority||'medium'),'muted')+(cyclic?chip('cycle affected','amber'):'')+'</div>'+
+    '<div class="graph-card-meta" title="'+E(task.id)+'">'+E(info.hint||task.id)+'</div></button>';
+}
+function graphDetail(team,byId,selectedId){
+  const task=byId.get(selectedId);
+  if(!task)return '<div id="graph-detail" class="graph-detail" aria-live="polite"><h3 class="text-txt-200 font-semibold">Inspect a task</h3><p class="text-txt-400 mt-1">Select a card to see prerequisites, dependents, and its assigned agent.</p></div>';
+  const member=(team.members||[]).find(m=>m.name===task.assignee),info=graphTaskInfo(task,byId);
+  function links(ids){return ids.length?ids.map(id=>{
+    const linked=byId.get(id);
+    return linked?'<button type="button" class="graph-detail-link" data-graph-select="'+E(id)+'">'+E(linked.content)+' '+chip(E(String(linked.status).replace(/_/g,' ')),'muted')+'</button>':'<div class="text-amber-400 mt-1">Missing prerequisite: '+E(id)+'</div>';
+  }).join(''):'<div class="text-txt-500 mt-1">None</div>'}
+  const dependents=(team.tasks||[]).filter(t=>graphDependencies(t).includes(task.id)).map(t=>t.id);
+  return '<div id="graph-detail" class="graph-detail" aria-live="polite">'+
+    '<h3 class="text-txt-100 font-semibold">'+E(task.content)+'</h3><div class="text-txt-400 mt-1">'+E(task.id)+' · '+chip(E(String(task.status).replace(/_/g,' ')),info.color)+'</div>'+
+    '<div class="mt-2">Agent: '+(member?'<button type="button" class="text-blue-400 underline" data-graph-agent="'+E(member.name)+'">'+E(member.name)+' — open agent detail</button>':E(task.assignee||'Unassigned'))+'</div>'+
+    '<div class="graph-detail-grid"><div><h4 class="text-txt-300 font-semibold">Prerequisites</h4>'+links(info.deps)+'</div><div><h4 class="text-txt-300 font-semibold">Dependents</h4>'+links(dependents)+'</div></div></div>';
+}
+function graphMarkup(team,layout,selectedId){
+  const tasks=team.tasks||[],byId=new Map(tasks.map(task=>[task.id,task])),nodes=new Map(layout.nodes.map(node=>[node.task.id,node]));
+  if(!tasks.length)return '<div id="graph-scroll" class="graph-scroll scroll" tabindex="0" aria-label="Task dependency graph"><div class="text-center text-txt-400 text-[13px] py-12">No tasks yet<div class="text-[11px] text-txt-500 mt-2">Add tasks with <code class="font-mono">team_tasks_add</code> to see their dependencies.</div></div></div>'+graphDetail(team,byId,null);
+  let warning='';
+  if(layout.cyclic.length)warning+='<div class="graph-warning">Cyclic dependencies: '+layout.cyclic.length+' task'+(layout.cyclic.length===1?'':'s')+' affected. Cycle-affected tasks are shown in a fallback column.</div>';
+  if(layout.missing.length)warning+='<div class="graph-warning">Missing prerequisite'+(layout.missing.length===1?'':'s')+': '+layout.missing.map(item=>E(byId.get(item.taskId)?.content||item.taskId)+' → '+E(item.dependencyId)).join('; ')+'</div>';
+  const skipped=layout.edges.filter(edge=>nodes.get(edge.to).x-nodes.get(edge.from).x>GRAPH_CARD_WIDTH+GRAPH_GAP_X).length;
+  const height=layout.height+(skipped?16+skipped*12:0);
+  let lane=0;
+  const edges=layout.edges.map(edge=>{
+    const from=nodes.get(edge.from),to=nodes.get(edge.to),done=from.task.status==='completed';
+    const x1=from.x+GRAPH_CARD_WIDTH,y1=from.y+GRAPH_CARD_HEIGHT/2;
+    const forward=to.x>from.x,x2=forward?to.x:to.x+GRAPH_CARD_WIDTH,y2=forward?to.y+GRAPH_CARD_HEIGHT/2:to.y+16;
+    const bend=forward?(x1+x2)/2:x1+20;
+    const skipsColumn=to.x-from.x>GRAPH_CARD_WIDTH+GRAPH_GAP_X;
+    const routeY=layout.height+8+lane*12;
+    if(skipsColumn)lane++;
+    const path=skipsColumn?'M '+x1+' '+y1+' H '+(x1+24)+' V '+routeY+' H '+(x2-24)+' V '+y2+' H '+x2:
+      'M '+x1+' '+y1+' C '+bend+' '+y1+', '+bend+' '+y2+', '+x2+' '+y2;
+    return '<path data-edge-from="'+E(edge.from)+'" data-edge-to="'+E(edge.to)+'" d="'+path+'" fill="none" stroke="'+(done?'#4ade80':'#64748b')+'" stroke-width="2" marker-end="url(#graph-arrow-'+(done?'done':'pending')+')"/>';
+  }).join('');
+  const svg='<svg class="graph-edges" width="'+layout.width+'" height="'+height+'" aria-hidden="true"><defs>'+['done','pending'].map(name=>'<marker id="graph-arrow-'+name+'" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto"><path d="M0 0L10 5L0 10z" fill="'+(name==='done'?'#4ade80':'#64748b')+'"/></marker>').join('')+'</defs>'+edges+'</svg>';
+  const cyclic=new Set(layout.cyclic),cards=layout.nodes.map(node=>graphCard(node,team,byId,selectedId,cyclic.has(node.task.id))).join('');
+  return warning+'<div id="graph-scroll" class="graph-scroll scroll" tabindex="0" aria-label="Task dependency graph" aria-describedby="graph-description"><div class="graph-canvas" style="width:'+layout.width+'px;height:'+height+'px">'+svg+cards+'</div></div>'+
+    '<div class="graph-legend"><span class="text-emerald-400">✓ Completed prerequisite</span><span class="text-blue-400">● In progress</span><span class="text-amber-400">○ Blocked</span><span>→ Dependency direction</span></div>'+graphDetail(team,byId,selectedId);
+}
+`;

package/src/dashboard.ts

@@ -4,13 +4,16 @@ import type { Database } from "./db"
 import { DASHBOARD_HEAD } from "./dashboard-html"
 import { DASHBOARD_JS_CORE } from "./dashboard-js-core"
 import { DASHBOARD_JS_EVENTS } from "./dashboard-js-events"
+import { DASHBOARD_JS_GRAPH_LAYOUT } from "./dashboard-js-graph-layout"
+import { DASHBOARD_JS_GRAPH } from "./dashboard-js-graph"
 import { DASHBOARD_JS_RENDER } from "./dashboard-js-render"
+import { parseTaskDependencies } from "./task-graph"
 import { log } from "./log"
 import type { ActivityBuffer, ActivityEntry } from "./activity"
 import type { PluginClient } from "./types"
 
 /** Assemble the full dashboard HTML from parts. */
-const DASHBOARD_HTML = DASHBOARD_HEAD + "\n<script>" + DASHBOARD_JS_CORE + DASHBOARD_JS_RENDER + DASHBOARD_JS_EVENTS + "<\/script>\n</body></html>"
+const DASHBOARD_HTML = DASHBOARD_HEAD + "\n<script>" + DASHBOARD_JS_CORE + DASHBOARD_JS_GRAPH_LAYOUT + DASHBOARD_JS_RENDER + DASHBOARD_JS_GRAPH + DASHBOARD_JS_EVENTS + "<\/script>\n</body></html>"
 
 interface TeamRow {
   id: string
@@ -72,21 +75,6 @@ interface MessageRow {
   time_created: number
 }
 
-function parseDependsOn(value: string | null): string[] {
-  if (!value) return []
-
-  try {
-    const parsed: unknown = JSON.parse(value)
-
-    if (Array.isArray(parsed)) return parsed.filter((item): item is string => typeof item === "string")
-    if (typeof parsed === "string") return [parsed]
-  } catch {
-    return [value]
-  }
-
-  return []
-}
-
 /**
  * Bare-integer version of the `/api/state` response shape. Bump on any
  * breaking change to the payload (field removed/renamed/retyped, not
@@ -154,7 +142,7 @@ function buildState(db: Database): EnsembleDashboardState {
         status: tk.status,
         priority: tk.priority,
         assignee: tk.assignee,
-        dependsOn: parseDependsOn(tk.depends_on),
+        dependsOn: parseTaskDependencies(tk.depends_on),
         timeCreated: tk.time_created,
         timeUpdated: tk.time_updated,
       })),
@@ -207,6 +195,8 @@ export interface DashboardServer {
 
 /** Optional dependencies for the dashboard server. */
 export interface DashboardOptions {
+  /** Network interface to bind (defaults to loopback). */
+  host?: string
   /** In-memory activity buffer for real-time per-session events. */
   activityBuffer?: ActivityBuffer
   /** SDK client for on-demand session message retrieval. */
@@ -216,7 +206,6 @@ export interface DashboardOptions {
 function sendJson(res: ServerResponse, data: unknown): void {
   res.writeHead(200, {
     "Content-Type": "application/json",
-    "Access-Control-Allow-Origin": "*",
   })
   res.end(JSON.stringify(data))
 }
@@ -424,7 +413,7 @@ export async function startDashboard(db: Database, port: number, options?: Dashb
       resolve(null)
     })
 
-    server.listen(port, () => {
+    server.listen(port, options?.host ?? "127.0.0.1", () => {
       log(`dashboard:started port=${port} url=http://localhost:${port}`)
       resolve(toDashboardServer(server))
     })

package/src/hooks.ts

@@ -242,9 +242,9 @@ export interface SessionErrorPayload {
  * as a system message to the lead, so otherwise-silent failures are visible.
  *
  * The lead is actively woken via notifyLead so the message is delivered even
- * when the errored teammate was the last busy member (the "all done" gate in
- * the passive wake path would otherwise strand the message). The teammate
- * itself is NOT auto-resumed — recovery is left to the lead's judgement.
+ * when the errored teammate was the last busy member (the passive wake path
+ * only retries on the lead's next idle event). The teammate itself is NOT
+ * auto-resumed — recovery is left to the lead's judgement.
  *
  * Ignored when:
  * - sessionID is undefined

package/src/index.ts

@@ -14,6 +14,7 @@ import { handleSessionStatusEvent, handleSessionCreatedEvent, checkToolIsolation
 import { notifyTeamEvent, notifyWorkingProgress, notifyLead } from "./notify"
 import { hasReportedCompletion } from "./messaging"
 import { getMemberModel } from "./member-model"
+import { wakeLeadIfPending } from "./wake"
 import { buildLeadSystemPrompt, buildTeammateSystemPrompt, buildTeamCompactionContext } from "./system-prompt"
 import { log, initLog } from "./log"
 import { findTeamBySession } from "./types"
@@ -64,8 +65,6 @@ const plugin: Plugin = async (input) => {
   const nudgedMembers = new Set<string>()
   const progressTracker = new ProgressTracker()
   const activityBuffer = new ActivityBuffer()
-  const wakeLeadTimestamps = new Map<string, number>()
-  const WAKE_LEAD_COOLDOWN_MS = 5000
 
   // Extract the working HeyAPI transport from the plugin-provided v1 client and pass it
   // to the v2 OpencodeClient. The plugin framework provides a v1 client which stores its
@@ -131,7 +130,7 @@ const plugin: Plugin = async (input) => {
 
     // Start dashboard server (main instance only, not worktree instances)
     if (config.dashboardPort !== 0) {
-      startDashboard(db, config.dashboardPort, { activityBuffer, client }).catch((err) => {
+      startDashboard(db, config.dashboardPort, { activityBuffer, client, host: config.dashboardHost }).catch((err) => {
         log(`init:dashboard:failed err=${err instanceof Error ? err.message : String(err)}`)
       })
     }
@@ -271,27 +270,16 @@ const plugin: Plugin = async (input) => {
           await notifyWorkingProgress(client, db, transition.teamId)
         }
 
-        // Wake the lead when it goes idle and has pending messages.
+        // Wake the lead when it goes idle and has unseen messages.
         // The system prompt transform delivers the actual message content.
         if (statusType === "idle") {
           const team = db.query("SELECT id FROM team WHERE lead_session_id = ? AND status = 'active'").get(sessionID) as { id: string } | null
           if (team) {
-            const pending = db.query("SELECT COUNT(*) as c FROM team_message WHERE team_id = ? AND to_name = 'lead' AND delivered = 0").get(team.id) as { c: number }
-            // Skip wake if all teammates are done or if we woke recently (issue #3 — breaks completion loop)
-            const allDone = (db.query(
-              "SELECT COUNT(*) as c FROM team_member WHERE team_id = ? AND status NOT IN ('ready', 'shutdown', 'error')"
-            ).get(team.id) as { c: number }).c === 0
-            const lastWake = wakeLeadTimestamps.get(team.id) ?? 0
-            if (pending.c > 0 && !allDone && Date.now() - lastWake > WAKE_LEAD_COOLDOWN_MS) {
-              wakeLeadTimestamps.set(team.id, Date.now())
-              log(`wake-lead: ${pending.c} pending messages, sending promptAsync`)
-              client.session.promptAsync({
-                sessionID,
-                parts: [{ type: "text", text: `[System: ${pending.c} new team message(s) available]` }],
-              }).catch((err) => {
-                log(`wake-lead:failed err=${err instanceof Error ? err.message : String(err)}`)
-              })
-            }
+            // Guarded/coalesced: skips if the team was archived or the inbox
+            // was already drained while this idle event was in flight (#48, #57).
+            wakeLeadIfPending(client, db, team.id).catch((err) => {
+              log(`wake-lead:failed err=${err instanceof Error ? err.message : String(err)}`)
+            })
           }
 
           // Also flush peer messages for teammates that just went idle
@@ -304,14 +292,14 @@ const plugin: Plugin = async (input) => {
           if (member && !hasReportedCompletion(db, member.team_id, member.name)) {
             const staleThreshold = Date.now() - 5000
             const peerMsgs = db.query(
-              "SELECT COUNT(*) as c FROM team_message WHERE team_id = ? AND to_name = ? AND delivered = 0 AND time_created < ?"
+              "SELECT COUNT(*) as c FROM team_message WHERE team_id = ? AND to_name = ? AND read = 0 AND delivered = 0 AND time_created < ?"
             ).get(member.team_id, member.name, staleThreshold) as { c: number }
             if (peerMsgs.c > 0) {
               log(`wake-peer: ${member.name} has ${peerMsgs.c} pending peer messages`)
               const peerModel = getMemberModel(db, member.team_id, member.name)
               client.session.promptAsync({
                 sessionID,
-                parts: [{ type: "text", text: `[System: ${peerMsgs.c} new message(s) from teammates]` }],
+                parts: [{ type: "text", text: `[System: ${peerMsgs.c} new message(s) from teammates — use team_results to read them]` }],
                 ...(peerModel ? { model: peerModel } : {}),
               }).catch((err) => {
                 log(`wake-peer:failed err=${err instanceof Error ? err.message : String(err)}`)
@@ -386,7 +374,7 @@ const plugin: Plugin = async (input) => {
       log(`system-prompt:transform role=${teamInfo.role} session=${input.sessionID}`)
       const prompt = teamInfo.role === "lead"
         ? buildLeadSystemPrompt(db, teamInfo.teamId, config)
-        : buildTeammateSystemPrompt(db, teamInfo.teamId, teamInfo.memberName ?? "unknown")
+        : buildTeammateSystemPrompt(db, teamInfo.teamId, teamInfo.memberName ?? "unknown", config)
       log(`system-prompt:injected role=${teamInfo.role} len=${prompt.length}`)
       output.system.push(prompt)
     },

package/src/member-model.ts

@@ -1,20 +1,41 @@
 import type { Database } from "./db"
+import type { PluginClient } from "./types"
 
 /** A parsed provider/model pair, as accepted by session.promptAsync. */
 export interface ParsedModel {
   providerID: string
   modelID: string
+  variant?: string
+}
+
+/** A session's current agent and model selection. Either may be unknown. */
+export interface SessionSelection {
+  agent?: string
+  model?: ParsedModel
+}
+
+/** Format a parsed model back into "provider/model" (with "#variant" when set). */
+export function formatModelId(model: ParsedModel): string {
+  return `${model.providerID}/${model.modelID}${model.variant ? `#${model.variant}` : ""}`
 }
 
 /**
  * Parse a "provider/model" string into { providerID, modelID } for the SDK.
  * Returns undefined if the string is not in "provider/model" form (empty
  * provider or empty model). The model portion may itself contain slashes.
+ * A trailing "#variant" selects a model variant, e.g. "openai/gpt-6.1-terra#max".
  */
 export function parseModelId(model: string): ParsedModel | undefined {
-  const slash = model.indexOf("/")
-  if (slash <= 0 || slash === model.length - 1) return undefined
-  return { providerID: model.slice(0, slash), modelID: model.slice(slash + 1) }
+  const hash = model.indexOf("#")
+  const variant = hash === -1 ? undefined : model.slice(hash + 1) || undefined
+  const base = hash === -1 ? model : model.slice(0, hash)
+  const slash = base.indexOf("/")
+  if (slash <= 0 || slash === base.length - 1) return undefined
+  return {
+    providerID: base.slice(0, slash),
+    modelID: base.slice(slash + 1),
+    ...(variant ? { variant } : {}),
+  }
 }
 
 /**
@@ -28,3 +49,86 @@ export function getMemberModel(db: Database, teamId: string, memberName: string)
   if (!row?.model) return undefined
   return parseModelId(row.model)
 }
+
+/** Text prefixes used by Ensemble-injected wake/delivery messages. */
+const ENSEMBLE_MESSAGE_PREFIXES = [
+  "[System:",
+  "[System]",
+  "[Team message from ",
+  "[Recovered team message from ",
+]
+
+/** Whether every text part in a message is an Ensemble-injected notification. */
+function isEnsembleInjected(parts: unknown[]): boolean {
+  const textParts = parts.filter((part): part is { type: "text"; text: string } => {
+    if (!part || typeof part !== "object") return false
+    const candidate = part as { type?: unknown; text?: unknown }
+    return candidate.type === "text" && typeof candidate.text === "string"
+  })
+  if (textParts.length === 0) return false
+  return textParts.every(part => ENSEMBLE_MESSAGE_PREFIXES.some(prefix => part.text.startsWith(prefix)))
+}
+
+/** Accept both V1 ({ providerID, modelID }) and V2 ({ providerID, id }) model refs. */
+function parseSessionModel(value: unknown): ParsedModel | undefined {
+  if (!value || typeof value !== "object") return undefined
+  const raw = value as Record<string, unknown>
+  const providerID = typeof raw.providerID === "string" ? raw.providerID : undefined
+  const modelID = typeof raw.modelID === "string"
+    ? raw.modelID
+    : typeof raw.id === "string"
+      ? raw.id
+      : undefined
+  const variant = typeof raw.variant === "string" && raw.variant.length > 0 ? raw.variant : undefined
+  if (!providerID || !modelID) return undefined
+  return { providerID, modelID, ...(variant ? { variant } : {}) }
+}
+
+/**
+ * Best-effort lookup of a session's current agent and model selection.
+ *
+ * V2 exposes both directly on session.get. V1 does not, so it falls back to
+ * the most recent real user message (skipping Ensemble's own wake messages,
+ * which are injected as user turns on V1). Never throws: unknown selection
+ * simply returns an empty object so delivery can proceed with defaults.
+ */
+export async function getSessionSelection(client: PluginClient, sessionID: string): Promise<SessionSelection> {
+  let agent: string | undefined
+  let model: ParsedModel | undefined
+
+  // V2 fast path. `client.agent` is only present on the V2 adapter.
+  if (client.agent) {
+    try {
+      const result = await client.session.get({ sessionID })
+      const data = result.data as { agent?: unknown; model?: unknown } | undefined
+      if (typeof data?.agent === "string") agent = data.agent
+      model = parseSessionModel(data?.model)
+    } catch {
+      // Fall through to the message-based lookup.
+    }
+  }
+
+  if (!agent || !model) {
+    try {
+      const result = await client.session.messages({ sessionID, limit: 100 })
+      const messages = result.data ?? []
+      for (let i = messages.length - 1; i >= 0; i--) {
+        const message = messages[i]
+        if (!message) continue
+        const info = message.info as { role?: unknown; agent?: unknown; model?: unknown } | undefined
+        if (info?.role !== "user") continue
+        if (isEnsembleInjected(message.parts)) continue
+        if (!agent && typeof info.agent === "string") agent = info.agent
+        if (!model) model = parseSessionModel(info.model)
+        if (agent && model) break
+      }
+    } catch {
+      // Best effort only.
+    }
+  }
+
+  return {
+    ...(agent ? { agent } : {}),
+    ...(model ? { model } : {}),
+  }
+}

package/src/messaging.ts

@@ -62,11 +62,13 @@ export function broadcastMessage(db: Database, input: BroadcastMessageInput): st
 }
 
 /**
- * Get all undelivered messages for a team.
+ * Get all undelivered messages for a team. Messages already read via
+ * team_results are excluded — re-injecting or re-sending them would duplicate
+ * content the recipient has already seen.
  */
 export function getUndeliveredMessages(db: Database, teamId: string): MessageRow[] {
   return db.query(
-    "SELECT * FROM team_message WHERE team_id = ? AND delivered = 0 ORDER BY time_created ASC"
+    "SELECT * FROM team_message WHERE team_id = ? AND read = 0 AND delivered = 0 ORDER BY time_created ASC"
   ).all(teamId) as MessageRow[]
 }