RubyGems - maf - Versions diffs - 0.1.0 - Mend

maf 0.1.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 (136) hide show

checksums.yaml +7 -0
data/CHANGELOG.md +11 -0
data/LICENSE.txt +21 -0
data/README.md +411 -0
data/assets/agents-contract.md +80 -0
data/assets/analyst +240 -0
data/assets/coord +2936 -0
data/assets/dashboard +553 -0
data/assets/dashboard.html +341 -0
data/assets/dispatcher +1687 -0
data/assets/doc-graph-refresh +286 -0
data/assets/env.sh +6 -0
data/assets/git-hooks/post-commit +7 -0
data/assets/git-hooks/post-merge +7 -0
data/assets/git-hooks/pre-commit +32 -0
data/assets/harness-hooks/board-watch-opencode.js +87 -0
data/assets/harness-hooks/board-watch.rb +286 -0
data/assets/harness-hooks/context-watch.rb +268 -0
data/assets/harness-hooks/next-task-hermes.sh +48 -0
data/assets/harness-hooks/next-task.rb +97 -0
data/assets/harness-hooks/session-guard.rb +128 -0
data/assets/taskrc.append +11 -0
data/assets/vault +224 -0
data/assets/worktree-env.example.rb +26 -0
data/exe/maf +14 -0
data/install.md +326 -0
data/lib/maf/bootstrap/claude_settings.rb +55 -0
data/lib/maf/bootstrap/dependencies.rb +37 -0
data/lib/maf/bootstrap/git_hook_planner.rb +68 -0
data/lib/maf/bootstrap/global_taskrc_warning.rb +33 -0
data/lib/maf/bootstrap/graph_home.rb +62 -0
data/lib/maf/bootstrap/hook_merger.rb +53 -0
data/lib/maf/bootstrap/installer.rb +66 -0
data/lib/maf/bootstrap/layout_planner.rb +18 -0
data/lib/maf/bootstrap/marked_block.rb +44 -0
data/lib/maf/bootstrap/memory_branch.rb +77 -0
data/lib/maf/bootstrap/options.rb +34 -0
data/lib/maf/bootstrap/project.rb +77 -0
data/lib/maf/bootstrap/script_planner.rb +81 -0
data/lib/maf/bootstrap/text_planner.rb +42 -0
data/lib/maf/bootstrap/vault_starter.rb +41 -0
data/lib/maf/bootstrap/writer.rb +69 -0
data/lib/maf/bootstrap.rb +162 -0
data/lib/maf/budget.rb +59 -0
data/lib/maf/cli.rb +135 -0
data/lib/maf/env_exclude.rb +23 -0
data/lib/maf/flow/agent_links.rb +79 -0
data/lib/maf/flow/bootstrapper.rb +36 -0
data/lib/maf/flow/codex_hooks.rb +50 -0
data/lib/maf/flow/generator.rb +63 -0
data/lib/maf/flow/harness_linker.rb +37 -0
data/lib/maf/flow/hermes_hook.rb +48 -0
data/lib/maf/flow/hermes_hook_setup.rb +69 -0
data/lib/maf/flow/hook_files.rb +16 -0
data/lib/maf/flow/hook_installer.rb +33 -0
data/lib/maf/flow/legacy_codex_hook.rb +71 -0
data/lib/maf/flow/manifest.rb +51 -0
data/lib/maf/flow/mcp_config.rb +72 -0
data/lib/maf/flow/mcp_installer.rb +45 -0
data/lib/maf/flow/models.rb +61 -0
data/lib/maf/flow/options.rb +65 -0
data/lib/maf/flow/prompt_builder.rb +85 -0
data/lib/maf/flow/prompt_text.rb +263 -0
data/lib/maf/flow/report.rb +89 -0
data/lib/maf/flow/role_catalog.rb +40 -0
data/lib/maf/flow/role_files.rb +72 -0
data/lib/maf/flow/role_stub.rb +38 -0
data/lib/maf/flow/roster.rb +28 -0
data/lib/maf/flow/validator.rb +38 -0
data/lib/maf/flow/workflow.rb +28 -0
data/lib/maf/flow.rb +84 -0
data/lib/maf/local_exclude.rb +53 -0
data/lib/maf/menu.rb +101 -0
data/lib/maf/migrate/moves.rb +44 -0
data/lib/maf/migrate/rewrites.rb +53 -0
data/lib/maf/migrate/role_files.rb +35 -0
data/lib/maf/migrate/runner.rb +66 -0
data/lib/maf/migrate/worktrees.rb +65 -0
data/lib/maf/migrate.rb +62 -0
data/lib/maf/prompt.rb +40 -0
data/lib/maf/retire.rb +116 -0
data/lib/maf/role_limits.rb +49 -0
data/lib/maf/setup_agent/args.rb +57 -0
data/lib/maf/setup_agent/dispatch.rb +44 -0
data/lib/maf/setup_agent/hermes_launcher.rb +34 -0
data/lib/maf/setup_agent/hermes_skill.rb +26 -0
data/lib/maf/setup_agent/launcher.rb +85 -0
data/lib/maf/setup_agent/manifest.rb +35 -0
data/lib/maf/setup_agent/project.rb +9 -0
data/lib/maf/setup_agent/role_file.rb +30 -0
data/lib/maf/setup_agent/runtime_hooks.rb +37 -0
data/lib/maf/setup_agent/worktree.rb +50 -0
data/lib/maf/setup_agent.rb +111 -0
data/lib/maf/shared/git_exclude.rb +33 -0
data/lib/maf/shared/git_identity.rb +41 -0
data/lib/maf/shared/peak_rate.rb +20 -0
data/lib/maf/shared/processes.rb +31 -0
data/lib/maf/shared/project.rb +34 -0
data/lib/maf/shared/roles.rb +19 -0
data/lib/maf/team.rb +114 -0
data/lib/maf/team_command.rb +73 -0
data/lib/maf/uninstall/claude_settings.rb +40 -0
data/lib/maf/uninstall/codex_hooks.rb +18 -0
data/lib/maf/uninstall/commit_guard.rb +16 -0
data/lib/maf/uninstall/coordination.rb +15 -0
data/lib/maf/uninstall/doc_graph_hooks.rb +38 -0
data/lib/maf/uninstall/git.rb +13 -0
data/lib/maf/uninstall/local_files.rb +33 -0
data/lib/maf/uninstall/manifest.rb +29 -0
data/lib/maf/uninstall/marked_files.rb +37 -0
data/lib/maf/uninstall/mcp_entries.rb +43 -0
data/lib/maf/uninstall/notes.rb +31 -0
data/lib/maf/uninstall/owned.rb +12 -0
data/lib/maf/uninstall/role_files.rb +51 -0
data/lib/maf/uninstall/runner.rb +67 -0
data/lib/maf/uninstall/scripts.rb +35 -0
data/lib/maf/uninstall/vault_watcher.rb +21 -0
data/lib/maf/uninstall/worktrees.rb +30 -0
data/lib/maf/uninstall.rb +59 -0
data/lib/maf/untrack.rb +90 -0
data/lib/maf/version.rb +5 -0
data/lib/maf/worker_archive.rb +63 -0
data/lib/maf/worker_control.rb +137 -0
data/lib/maf/workers.rb +37 -0
data/lib/maf.rb +5 -0
data/templates/claude.md.erb +16 -0
data/templates/codex.md.erb +7 -0
data/templates/hermes.md.erb +12 -0
data/templates/opencode.md.erb +24 -0
data/templates/role-stub.yml.erb +15 -0
data/templates/roles.yml +289 -0
data/templates/workflows/panel.md +20 -0
data/templates/workflows/plan-review.md +9 -0
data/templates/workflows/simple.md +4 -0
data/templates/workflows/tdd.md +8 -0
metadata +193 -0

data/assets/dashboard.html ADDED Viewed

@@ -0,0 +1,341 @@
+<!DOCTYPE html>
+<!-- dashboard.html - page of the maf dashboard. The installer copies it next to the dashboard script. -->
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <title>Flow Board</title>
+  <style>
+    :root{--bg:#0f1117;--surface:#1a1d27;--border:#2a2d3a;--text:#e2e8f0;--muted:#64748b;
+      --ok:#22c55e;--warn:#f59e0b;--danger:#ef4444;--info:#3b82f6}
+    *{box-sizing:border-box;margin:0;padding:0}
+    body{background:var(--bg);color:var(--text);font:13px/1.5 'SF Mono',Consolas,monospace;padding:16px}
+    header{display:flex;align-items:center;gap:12px;margin-bottom:14px;flex-wrap:wrap}
+    h1{font-size:16px;font-weight:700}
+    .muted{color:var(--muted);font-size:11px}
+    #pbtn{margin-left:auto;background:var(--surface);border:1px solid var(--border);
+      color:var(--text);padding:3px 10px;border-radius:4px;cursor:pointer;font-size:11px}
+    .alerts{display:flex;flex-direction:column;gap:6px;margin-bottom:14px}
+    .alert{padding:7px 12px;border-radius:5px;border-left:3px solid var(--danger);
+      background:#1f1a1a;font-size:12px}
+    .alert.warn{border-color:var(--warn);background:#1f1c16}
+    .alert.hint{border-color:var(--info);background:#161b22;display:flex;gap:10px;align-items:center}
+    .stats{display:flex;gap:10px;margin-bottom:14px;flex-wrap:wrap}
+    .stat{background:var(--surface);border:1px solid var(--border);border-radius:7px;
+      padding:10px 14px;min-width:90px}
+    .sv{font-size:22px;font-weight:700}
+    .sl{font-size:10px;color:var(--muted);text-transform:uppercase;letter-spacing:.05em}
+    .grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(280px,1fr));
+      gap:10px;margin-bottom:14px}
+    .card{background:var(--surface);border:1px solid var(--border);border-radius:7px;padding:11px}
+    .card h3{font-size:11px;font-weight:700;margin-bottom:8px;color:var(--muted);
+      text-transform:uppercase;letter-spacing:.05em}
+    .row{padding:5px 0;border-bottom:1px solid var(--border);font-size:12px}
+    .row:last-child{border-bottom:none}
+    .meta{color:var(--muted);font-size:11px}
+    .b{display:inline-block;padding:1px 5px;border-radius:3px;font-size:10px;font-weight:700;
+      text-transform:uppercase}
+    .b-ok{background:#052e0f;color:var(--ok)}
+    .b-warn{background:#2d1f02;color:var(--warn)}
+    .b-danger{background:#2d0909;color:var(--danger)}
+    .b-info{background:#0a1929;color:var(--info)}
+    .two{display:grid;grid-template-columns:1fr 1fr;gap:10px;margin-bottom:14px}
+    .er{display:flex;gap:8px;padding:4px 0;border-bottom:1px solid var(--border);font-size:12px}
+    .er:last-child{border-bottom:none}
+    .ets{color:var(--muted);flex-shrink:0;font-size:11px;min-width:48px}
+    .ea{font-weight:600;min-width:62px}
+    .ac{color:var(--info)}.ad{color:var(--ok)}.au{color:var(--warn)}.am{color:#a78bfa}
+    @media(max-width:600px){.two{grid-template-columns:1fr}}
+    table{width:100%;border-collapse:collapse;font-size:12px}
+    th{text-align:left;color:var(--muted);font-size:10px;text-transform:uppercase;font-weight:600;
+      padding:4px 6px;border-bottom:1px solid var(--border)}
+    td{padding:6px;border-bottom:1px solid var(--border);vertical-align:top}
+    .act{background:var(--bg);border:1px solid var(--border);color:var(--text);padding:2px 8px;
+      border-radius:4px;cursor:pointer;font-size:11px;margin:0 2px 2px 0}
+    .act:hover{border-color:var(--info)}
+    .log{white-space:pre-wrap;color:var(--muted);font-size:10px;max-width:420px}
+  </style>
+</head>
+<body>
+  <header>
+    <h1 id="proj">Flow Board</h1>
+    <span class="muted" id="upd">Loading...</span>
+    <button id="pbtn" onclick="togglePause()">Pause</button>
+  </header>
+  <div id="alerts" class="alerts"></div>
+  <div id="hints" class="alerts"></div>
+  <div id="stats" class="stats"></div>
+  <div class="card" style="margin-bottom:10px"><h3>Workers</h3><div id="workers"></div></div>
+  <div class="card" style="margin-bottom:10px"><h3>Knowledge graph</h3><div id="graph"></div></div>
+  <div id="roles" class="grid"></div>
+  <div class="two">
+    <div class="card"><h3>Recent Events</h3><div id="events"></div></div>
+    <div>
+      <div class="card" style="margin-bottom:10px"><h3>Inboxes</h3><div id="inboxes"></div></div>
+      <div class="card"><h3>Locks</h3><div id="locks"></div></div>
+    </div>
+  </div>
+  <script>
+    let paused = false, INTERVAL = 5, timer = null;
+    const TOKEN = '__TOKEN__';
+    const $ = id => document.getElementById(id);
+    const meta = text => `<div class="meta">${text}</div>`;
+    const muted = text => `<div class="muted">${text}</div>`;
+    function k(n) {
+      if (n == null) return '-';
+      if (n >= 1e6) return (n / 1e6).toFixed(1) + 'M';
+      return n >= 1e3 ? Math.round(n / 1e3) + 'k' : String(n);
+    }
+    function ago(iso) {
+      const s = Math.round((Date.now() - new Date(iso)) / 1000);
+      if (s < 60) return s + 's';
+      if (s < 3600) return Math.floor(s / 60) + 'm';
+      return Math.floor(s / 3600) + 'h ' + Math.floor((s % 3600) / 60) + 'm';
+    }
+    function esc(s) {
+      return String(s ?? '').replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;').replace(/'/g, '&#39;');
+    }
+    // A value as a JS argument in an onclick attribute. JSON quotes it. esc keeps the attribute closed.
+    function arg(v) { return esc(JSON.stringify(v)); }
+    function b(t, l) { return `<span class="b b-${l}">${t}</span>`; }
+    function ac(a) {
+      const classes = { done: 'ad', claim: 'ac', unclaim: 'au', msg: 'am', broadcast: 'am' };
+      return classes[a] || '';
+    }
+    function togglePause() {
+      paused = !paused;
+      $('pbtn').textContent = paused ? 'Resume' : 'Pause';
+      if (!paused) refresh();
+    }
+    async function act(id, action, limits) {
+      const what = action + ' ' + id + (limits ? ' with ' + limitText(limits) : '');
+      const asks = action === 'stop' || action === 'restart';
+      if (asks && !confirm(what + '? A running agent finishes its run first.')) return;
+      const headers = { 'Content-Type': 'application/json', 'X-Maf-Token': TOKEN };
+      const body = JSON.stringify({ worker: id, action: action, limits: limits || {} });
+      const r = await fetch('/action', { method: 'POST', headers: headers, body: body })
+        .then(r => r.json()).catch(e => ({ error: e.message }));
+      if (r.error) alert(r.error);
+      refresh(true);
+    }
+    function state(w) {
+      const s = w.status || {};
+      if (!w.live) return b('stopped', 'danger');
+      if (!w.dispatch) return b('live', 'ok');
+      return s.running ? b('run ' + ago(s.run_started_at), 'info') : b('idle', 'ok');
+    }
+    function ctx(w) {
+      const s = w.status || {};
+      if (s.context_tokens == null) return '-';
+      const pct = s.context_window ? ' (' + Math.round(100 * s.context_tokens / s.context_window) + '%)' : '';
+      const over = s.context_limit && s.context_tokens >= s.context_limit;
+      return (over ? b('over limit', 'warn') + ' ' : '') + k(s.context_tokens) + pct;
+    }
+    // A run that ended with status blocked or needs_review waits for someone else. It did not fail.
+    function runBadge(r) {
+      if (r.success) return b('ok', 'ok');
+      return r.outcome === 'waiting' ? b('waiting', 'warn') : b('failed', 'danger');
+    }
+    function lastRun(w) {
+      const r = (w.status || {}).last_run;
+      if (!r) return '-';
+      const badge = runBadge(r);
+      return badge + ' ' + ago(r.finished_at) + ' ago<div class="log">' + esc(r.detail) + '</div>';
+    }
+    function buttons(w) {
+      if (!w.dispatch && !w.live) return '<div class="log">cd ' + esc(w.dir) + ' &amp;&amp; maf start</div>';
+      const acts = w.dispatch ? (w.live ? ['stop', 'restart'] : ['start']) : ['stop'];
+      return acts.concat(['analyze'])
+        .map(a => `<button class="act" onclick="act(${arg(w.id)}, ${arg(a)})">${a}</button>`).join('');
+    }
+    function logLines(w) {
+      const lines = (w.dispatch ? w.log : []).concat(w.action.length ? ['action: ' + w.action.at(-1)] : []);
+      return lines.length ? '<div class="log">' + esc(lines.join('\n')) + '</div>' : '';
+    }
+    function tokens(w) {
+      const u = w.usage || {};
+      const hit = u.input_tokens ? Math.round(100 * (u.cached_input_tokens || 0) / u.input_tokens) : 0;
+      const rest = `${k(u.cached_input_tokens)} cached (${hit}%) &middot; ${k(u.cache_write_input_tokens)} written`
+        + ` &middot; ${k(u.output_tokens)} out`
+        + ` &middot; ${u.runs || 0} runs`;
+      return k(u.input_tokens) + ' in' + meta(rest);
+    }
+    function taskCell(w, tasks) {
+      const cur = tasks.find(t => t.worker === w.id && t.start);
+      return cur ? esc(cur.description) + meta(esc(cur.uuid.slice(0, 8))) : '-';
+    }
+    function workerRow(w, tasks) {
+      const s = w.status || {};
+      const runs = s.session_runs != null ? meta('session run ' + (s.session_runs + 1)) : '';
+      const cells = [
+        `<strong>${esc(w.id)}</strong>` + meta(esc(w.role)),
+        esc(w.harness) + meta(w.dispatch ? 'dispatch' : 'interactive'),
+        esc(s.model || w.model || 'harness default') + runs,
+        state(w) + (w.last_event ? meta('event ' + ago(w.last_event) + ' ago') : ''),
+        ctx(w) + (w.handoff_at ? meta('note ' + ago(w.handoff_at) + ' ago') : ''),
+        taskCell(w, tasks), lastRun(w), tokens(w), buttons(w) + logLines(w)
+      ];
+      return '<tr>' + cells.map(c => `<td>${c}</td>`).join('') + '</tr>';
+    }
+    function renderWorkers(ws, tasks) {
+      const names = ['Worker', 'Harness', 'Model', 'State', 'Context', 'Task', 'Last run', 'Tokens', 'Actions'];
+      const head = '<tr>' + names.map(n => `<th>${n}</th>`).join('') + '</tr>';
+      const rows = ws.map(w => workerRow(w, tasks)).join('');
+      $('workers').innerHTML = ws.length ? '<table>' + head + rows + '</table>'
+        : muted('no workers yet. Run maf prepare or maf start.');
+    }
+    function taskAlerts(d) {
+      const t = d.tasks, alerts = [];
+      const add = (list, l, text) => { if ((list || []).length) alerts.push({ l: l, m: list.length + text }); };
+      add(t.stale, 'danger', ' claimed task(s) with expired lease — likely crashed worker');
+      add(t.orphaned, 'danger', ' task(s) assigned to roles nobody is running');
+      add(t.escalated, 'danger', ' task(s) escalated to the project manager — waiting for a decision');
+      add(t.in_review, 'warn', ' goal pull request(s) wait for your review on GitHub');
+      add(t.conflicts, 'warn', ' scope conflict(s) between pending tasks');
+      return alerts;
+    }
+    function otherAlerts(d) {
+      const alerts = [];
+      Object.entries(d.inboxes || {}).filter(([, msgs]) => msgs.length)
+        .forEach(([role, msgs]) => alerts.push({ l: 'warn', m: `${role} inbox: ${msgs.length} unread messages` }));
+      (d.locks || []).filter(l => l.stale).forEach(l =>
+        alerts.push({ l: 'danger', m: 'Stale lock: ' + l.name + ' held by ' + (l.worker || '?') + ', expired' }));
+      return alerts;
+    }
+    function workerAlerts(ws) {
+      const stopped = ws.filter(w => !w.live && w.dispatch)
+        .map(w => ({ l: 'danger', m: 'Dispatched worker ' + w.id + ' is stopped' }));
+      const run = w => (w.status || {}).last_run || {};
+      const failed = ws.filter(w => run(w).success === false && run(w).outcome !== 'waiting')
+        .map(w => ({ l: 'warn', m: `Last run of ${w.id} failed: ${(run(w).detail || '').slice(0, 100)}` }));
+      return stopped.concat(failed);
+    }
+    function limitText(limits) {
+      return Object.entries(limits).map(([key, value]) => key + '=' + value).join(' ');
+    }
+    // A hint suggests a better session limit. Its button restarts the worker with that limit.
+    // An analysis hint comes from the analyst model (the analyze button). The other hints come from rules.
+    function renderHints(hints) {
+      const button = h => h.limits
+        ? `<button class="act" onclick="act(${arg(h.worker)}, 'restart', ${arg(h.limits)})">`
+          + 'restart with ' + esc(limitText(h.limits)) + '</button>'
+        : h.action === 'stop' ? `<button class="act" onclick="act(${arg(h.worker)}, 'stop')">stop</button>` : '';
+      const tag = h => h.level === 'analysis' ? b('analysis', 'info') + (h.at ? meta(ago(h.at) + ' ago') : '') : '';
+      $('hints').innerHTML = (hints || [])
+        .map(h => `<div class="alert hint">&#x1F4A1; ${tag(h)}<span>${esc(h.text)}</span>${button(h)}</div>`)
+        .join('');
+    }
+    function renderAlerts(alerts) {
+      const html = a => `<div class="alert ${a.l === 'warn' ? 'warn' : ''}">&#x26A0; ${esc(a.m)}</div>`;
+      $('alerts').innerHTML = alerts.map(html).join('');
+    }
+    function waiting(t, now) { return t.wait && new Date(t.wait) > now; }
+    function renderStats(d, tasks, now) {
+      const stale = d.tasks.stale || [];
+      const stats = [
+        { v: tasks.length, l: 'Pending' }, { v: tasks.filter(t => t.start).length, l: 'In Progress', c: 'info' },
+        { v: tasks.filter(t => !t.start && !waiting(t, now)).length, l: 'Backlog' },
+        { v: tasks.filter(t => waiting(t, now)).length, l: 'Waiting' },
+        { v: stale.length, l: 'Stale', c: stale.length ? 'danger' : '' },
+        { v: (d.declared_roles || []).length, l: 'Roles' }, { v: (d.workers || []).length, l: 'Workers' }
+      ];
+      const color = s => s.c ? ` style="color:var(--${s.c})"` : '';
+      const html = s => `<div class="stat"><div class="sv"${color(s)}>${s.v}</div>`
+        + `<div class="sl">${s.l}</div></div>`;
+      $('stats').innerHTML = stats.map(html).join('');
+    }
+    function renderGraph(g) {
+      if (!g) return $('graph').innerHTML = muted('graph age unknown');
+      const age = g.commits == null ? 'no age' : g.commits + ' commits since build';
+      $('graph').innerHTML = `<div class="row">${b(g.state, g.state === 'fresh' ? 'ok' : 'warn')} `
+        + `<span class="meta">${age}</span></div>`;
+    }
+    function taskRow(badge, t, detail) {
+      return `<div class="row">${badge} <strong>${esc(t.description)}</strong>` + meta(detail) + '</div>';
+    }
+    function claimedRow(t, staleIds) {
+      const badge = staleIds.has(t.uuid) ? b('stale', 'danger') : b('claimed', 'info');
+      const scope = t.scope ? ' &middot; ' + esc(t.scope) : '';
+      return taskRow(badge, t, `${esc(t.worker || '')} &middot; ${ago(t.start)} ago${scope}`);
+    }
+    function groupByRole(roles, tasks, now) {
+      const byRole = {};
+      const group = r => byRole[r] = byRole[r] || { c: [], bl: [], w: [] };
+      roles.forEach(group);
+      tasks.forEach(t => {
+        const g = group(t.role || 'unassigned');
+        (waiting(t, now) ? g.w : t.start ? g.c : g.bl).push(t);
+      });
+      return byRole;
+    }
+    function renderRoles(d, tasks, now) {
+      const roles = d.declared_roles || [];
+      const staleIds = new Set((d.tasks.stale || []).map(t => t.uuid));
+      $('roles').innerHTML = Object.entries(groupByRole(roles, tasks, now)).map(([role, g]) => {
+        const orphan = roles.length > 0 && role !== 'goal' && !roles.includes(role);
+        const rows = g.c.map(t => claimedRow(t, staleIds))
+          .concat(g.bl.map(t => taskRow(b('backlog', 'ok'), t, esc(t.scope || ''))))
+          .concat(g.w.map(t => taskRow(b('waiting', 'warn'), t, esc(t.scope || ''))));
+        return `<div class="card"><h3>${esc(role)}${orphan ? ' ' + b('no runner', 'danger') : ''}</h3>`
+          + (rows.join('') || muted('no tasks')) + '</div>';
+      }).join('');
+    }
+    function renderEvents(events) {
+      const row = e => `<div class="er"><span class="ets">${ago(e.ts)} ago</span>`
+        + `<span class="ea ${ac(e.action)}">${esc(e.action)}</span>`
+        + `<span>${esc(e.worker)} ${e.detail ? '&mdash; ' + esc(e.detail.slice(0, 55)) : ''}</span></div>`;
+      const recent = (events || []).slice().reverse().slice(0, 25);
+      $('events').innerHTML = recent.map(row).join('') || muted('no events yet');
+    }
+    function renderInboxes(inboxes) {
+      const message = m => `<div class="row" style="padding-left:10px">`
+        + `<span class="meta">${esc(m.from || '?')}${m.at ? ' &middot; ' + ago(m.at) + ' ago' : ''}</span>`
+        + `<div>${esc(m.preview)}</div></div>`;
+      const box = ([role, msgs]) => `<div class="row"><span>${esc(role)}</span> `
+        + `${msgs.length ? b(msgs.length + ' unread', 'warn') : b('clear', 'ok')}</div>`
+        + msgs.map(message).join('');
+      const list = Object.entries(inboxes || {});
+      $('inboxes').innerHTML = list.length ? list.map(box).join('') : muted('no inboxes');
+    }
+    function renderLocks(locks) {
+      const badge = l => l.stale ? b('stale', 'danger') : b('held', 'info');
+      const row = l => `<div class="row"><span>${esc(l.name)}</span> ${badge(l)} `
+        + `<span class="meta" style="margin-left:4px">${esc(l.worker || '')} &middot; `
+        + `expires ${ago(l.expires_at)}</span></div>`;
+      $('locks').innerHTML = (locks || []).length ? locks.map(row).join('') : muted('no active locks');
+    }
+    function render(d) {
+      INTERVAL = d.refresh_interval || 5;
+      $('proj').textContent = d.project + ' — Flow Board';
+      $('upd').textContent = 'Updated ' + ago(d.generated_at) + ' | lease ' + Math.round(d.lease_ttl / 3600) + 'h';
+      const tasks = d.tasks.all || [], now = new Date(), ws = d.workers || [];
+      renderAlerts(taskAlerts(d).concat(otherAlerts(d), workerAlerts(ws)));
+      renderHints(d.hints);
+      renderStats(d, tasks, now);
+      renderWorkers(ws, tasks);
+      renderGraph(d.graph);
+      renderRoles(d, tasks, now);
+      renderEvents(d.events);
+      renderInboxes(d.inboxes);
+      renderLocks(d.locks);
+    }
+    async function refresh(now) {
+      if (paused && !now) return;
+      clearTimeout(timer);
+      try { render(await fetch('/data').then(r => r.json())); }
+      catch (e) { $('upd').textContent = 'Error: ' + e.message; }
+      timer = setTimeout(refresh, INTERVAL * 1000);
+    }
+    refresh();
+  </script>
+</body>
+</html>