clementine-agent 1.6.2 → 1.7.0

package/dist/agent/assistant.js

@@ -411,10 +411,24 @@ Routing rule: if the fact is something the agent should *always know* (not just
 ## Rules:
 - Only save genuinely NEW facts not already present in the Current Memory above.
 - If updating an existing topic, use memory_write(action="update_memory") to REPLACE the section, not append duplicates.
+- If a stored fact is now wrong (user corrected it, situation changed), use memory_write(action="supersede", supersedes_chunk_id=N, reason="…") instead of appending — the old chunk becomes invisible to retrieval, provenance is preserved.
 - If there's nothing new to save, respond "No new facts." and exit — do NOT call any tools.
 - Use the MCP tools (user_model, memory_write, note_create, task_add, note_take).
 - NEVER respond to ${OWNER}. You are invisible. Just save facts and exit.
 
+## Salience hint, confidence, reason (memory_write):
+Every memory_write call may include \`salience_hint\` (0.5–2.0), \`confidence\` (0–1), and \`reason\` (one short sentence). Use them — retrieval prioritizes high-salience, deprioritizes low-confidence, and reasons make the memory system explainable.
+
+salience_hint:
+- 0.5 — tentative, single-mention, may not be durable
+- 1.0 — normal (default; equivalent to omitting)
+- 1.5 — durable preference, decision, or strong stated opinion
+- 2.0 — identity-level fact (rare): role, name, foundational stance
+
+confidence: 1.0 = certain (default), 0.7 = probable, 0.5 = uncertain or heard secondhand, 0.3 = tentative. Lowers retrieval ranking without hiding.
+
+reason: one sentence answering "why is this worth keeping?" — e.g. "user just stated firm preference for plain .env over keychain after being burned by it." Skip routine cases.
+
 ## Behavioral Correction Detection:
 If ${OWNER} corrects HOW the assistant behaved (not a factual correction), output a JSON block:
 \`\`\`json-behavioral

package/dist/agent/hooks.d.ts

@@ -48,6 +48,8 @@ export interface AuditEvent {
  */
 export declare function logAuditJsonl(event: AuditEvent): void;
 export declare function setHeartbeatMode(active: boolean, tier2Allowed?: boolean): void;
+export declare function resetBrowserHarnessApproval(): void;
+export declare function isBrowserHarnessApproved(): boolean;
 export declare function setApprovalCallback(cb: ((desc: string) => Promise<boolean>) | null): void;
 export declare function setProfileTier(tier: number | null): void;
 export declare function setProfileAllowedTools(tools: string[] | null): void;

package/dist/agent/hooks.js

@@ -120,6 +120,16 @@ export function setHeartbeatMode(active, tier2Allowed = false) {
     heartbeatActive = active;
     heartbeatTier2Allowed = tier2Allowed;
 }
+// Session-scoped approval for browser harness T3 actions. Once the user
+// approves a session, subsequent T3 calls within that session auto-allow.
+// Resets on daemon restart (in-memory) and on explicit revoke.
+let browserHarnessSessionApproved = false;
+export function resetBrowserHarnessApproval() {
+    browserHarnessSessionApproved = false;
+}
+export function isBrowserHarnessApproved() {
+    return browserHarnessSessionApproved;
+}
 export function setApprovalCallback(cb) {
     approvalCallback = cb;
 }
@@ -197,11 +207,23 @@ export function logToolUse(toolName, toolInput) {
 // These apply to actual heartbeats and tier-1 cron jobs (read-only).
 // Tier 2+ cron jobs and unleashed tasks bypass these restrictions.
 const HEARTBEAT_DISALLOWED_TIER2 = ['Write', 'Edit', 'Bash'];
+// Browser harness write-class tools — drive the user's real Chrome with their
+// live cookies/sessions. NEVER run these without interactive approval. The
+// MCP server name is "browser-harness" so the SDK exposes them as
+// mcp__browser-harness__<tool>.
+const BROWSER_HARNESS_T3_TOOLS = [
+    'mcp__browser-harness__browser_click_xy',
+    'mcp__browser-harness__browser_type_text',
+    'mcp__browser-harness__browser_press_key',
+    'mcp__browser-harness__browser_scroll',
+    'mcp__browser-harness__browser_run_python',
+];
 const HEARTBEAT_DISALLOWED_ALWAYS = [
     'Bash', // No raw shell in low-tier autonomous mode
     'Task', // No sub-agents in heartbeats (too short to benefit)
     'Skill', // Skill packs load heavy context and waste turns
     'TodoWrite', // Internal bookkeeping wastes autonomous turns
+    ...BROWSER_HARNESS_T3_TOOLS, // Browser writes never run unsupervised
 ];
 export function getHeartbeatDisallowedTools() {
     const disallowed = [...HEARTBEAT_DISALLOWED_ALWAYS];
@@ -315,6 +337,42 @@ export async function enforceToolPermissions(toolName, toolInput, sourceOverride
             };
         }
     }
+    // ── Browser harness T3 — never autonomous, approve once per session ─
+    // These tools click/type/scroll/run-python in the user's REAL Chrome
+    // with their live cookies. They must never run without explicit consent.
+    const effectiveSourceForBrowser = sourceOverride ?? interactionSource;
+    if (BROWSER_HARNESS_T3_TOOLS.includes(toolName)) {
+        // Hard block during any autonomous context (cron tier-2, unleashed,
+        // heartbeat, member-channel sources). Heartbeat block is also handled
+        // above via getHeartbeatDisallowedTools, but this catches tier-2 cron
+        // and unleashed where heartbeatActive=false.
+        if (heartbeatActive || effectiveSourceForBrowser === 'autonomous') {
+            appendAuditFile(`[BROWSER-HARNESS] DENIED autonomous: ${toolName}`);
+            return {
+                behavior: 'deny',
+                message: `${toolName} controls your live browser — blocked during autonomous execution. Run interactively instead.`,
+            };
+        }
+        // Interactive: ask once per session. Subsequent T3 calls auto-allow
+        // until daemon restart (or explicit revoke via resetBrowserHarnessApproval).
+        if (!browserHarnessSessionApproved) {
+            if (approvalCallback) {
+                const approved = await approvalCallback('Allow Clementine to control your browser this session? Clicks, types, and key presses will run in your real Chrome with your live cookies and logins.');
+                if (!approved) {
+                    return { behavior: 'deny', message: 'Browser control denied by user.' };
+                }
+                browserHarnessSessionApproved = true;
+                appendAuditFile('[BROWSER-HARNESS] Session approval granted');
+            }
+            else {
+                // No approval callback wired — be safe, deny.
+                return {
+                    behavior: 'deny',
+                    message: 'Browser control requires interactive approval, but no approval callback is set in this context.',
+                };
+            }
+        }
+    }
     // ── Profile tier restrictions (restrict, never elevate) ────────
     if (activeProfileTier !== null) {
         if (activeProfileTier < 2 && ['Bash', 'Write', 'Edit'].includes(toolName)) {

package/dist/cli/dashboard.js

@@ -3160,6 +3160,7 @@ export async function cmdDashboard(opts) {
                 import('../dashboard/builder/events.js'),
             ]);
             const slug = body.name.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '').slice(0, 64) || 'workflow';
+            const agentSlug = body.agent ? (String(body.agent).trim() || undefined) : undefined;
             const wf = {
                 name: body.name,
                 description: body.description ?? '',
@@ -3174,8 +3175,9 @@ export async function cmdDashboard(opts) {
                         maxTurns: 15,
                     }],
                 sourceFile: '',
+                agentSlug,
             };
-            const id = workflowId(slug);
+            const id = workflowId(slug, agentSlug);
             const result = saveWorkflow(id, wf);
             if (!result.ok) {
                 res.status(400).json({ error: result.error });
@@ -5391,6 +5393,72 @@ If the tool returns nothing or errors, return an empty array \`[]\`.`,
     // content out of search results.
     // Memory Health snapshot — single endpoint feeding the dashboard tab.
     // Read-only aggregate over the existing tables; no caching needed (cheap).
+    // Self-correction stats — supersession provenance. Powers the
+    // "Self-correction (supersedes)" card on Brain → Health.
+    app.get('/api/memory/supersedes', async (_req, res) => {
+        try {
+            const gateway = await getGateway();
+            const store = gateway.assistant?.memoryStore;
+            if (!store?.getSupersedeStats) {
+                res.status(503).json({ error: 'Memory store not available' });
+                return;
+            }
+            res.json({ ok: true, stats: store.getSupersedeStats() });
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // Knowledge graph signals — wikilink density + per-match-type recall
+    // contribution. Powers the "Knowledge graph signals" card.
+    app.get('/api/memory/graph-stats', async (_req, res) => {
+        try {
+            const gateway = await getGateway();
+            const store = gateway.assistant?.memoryStore;
+            if (!store?.getGraphStats) {
+                res.status(503).json({ error: 'Memory store not available' });
+                return;
+            }
+            res.json({ ok: true, stats: store.getGraphStats({ topN: 12, lookbackHours: 24 * 7 }) });
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // Cross-channel session bridge — recent session summaries grouped by
+    // channel. Powers the "Cross-channel handoff" card.
+    app.get('/api/memory/session-bridge', async (_req, res) => {
+        try {
+            const gateway = await getGateway();
+            const store = gateway.assistant?.memoryStore;
+            if (!store?.getRecentSummariesByChannel) {
+                res.status(503).json({ error: 'Memory store not available' });
+                return;
+            }
+            res.json({ ok: true, grouped: store.getRecentSummariesByChannel(3) });
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
+    // Recent writes — what the agent has been capturing, including reason and
+    // salience hint when supplied. Powers the Brain → Health "Recent writes" panel.
+    app.get('/api/memory/writes/recent', async (req, res) => {
+        try {
+            const limit = Math.min(Number(req.query.limit) || 50, 200);
+            const gateway = await getGateway();
+            const store = gateway.assistant?.memoryStore;
+            if (!store?.getRecentWrites) {
+                res.status(503).json({ error: 'Memory store not available' });
+                return;
+            }
+            const writes = store.getRecentWrites(limit);
+            res.json({ ok: true, writes });
+        }
+        catch (err) {
+            res.status(500).json({ error: String(err) });
+        }
+    });
     app.get('/api/memory/health', async (_req, res) => {
         try {
             const gateway = await getGateway();
@@ -5428,6 +5496,25 @@ If the tool returns nothing or errors, return an empty array \`[]\`.`,
                 res.json({ ok: true, action, report });
                 return;
             }
+            if (action === 'reembed-dense') {
+                // Run backfill in the background — first call also pays the model
+                // load cost (~440MB download on first ever run). We respond immediately
+                // so the UI doesn't time out; the user re-polls /api/memory/health.
+                const limit = Number(req.body?.limit) > 0 ? Number(req.body.limit) : 200;
+                const embeddings = await import('../memory/embeddings.js');
+                const ready = await embeddings.probeDenseReady();
+                if (!ready) {
+                    res.status(503).json({ error: 'Dense embedding model failed to load' });
+                    return;
+                }
+                // Fire-and-forget; surface progress via subsequent /api/memory/health polls.
+                store.backfillDenseEmbeddings({ limit }).catch((err) => {
+                    // eslint-disable-next-line no-console
+                    console.error('[dashboard] reembed-dense failed', err);
+                });
+                res.json({ ok: true, action, started: true, limit });
+                return;
+            }
             res.status(400).json({ error: 'Unknown action: ' + action });
         }
         catch (err) {
@@ -12315,6 +12402,10 @@ if('serviceWorker' in navigator){navigator.serviceWorker.getRegistrations().then
           <option value="agent">agent</option>
           <option value="workflow">workflow</option>
         </select>
+        <label style="font-size:11px;color:var(--text-muted);font-weight:500;letter-spacing:0.04em;text-transform:uppercase">Owner</label>
+        <select id="builder-owner" onchange="onBuilderOwnerChange()" title="Filter and create scoped to this owner" style="padding:4px 8px;border:1px solid var(--border);border-radius:6px;background:var(--bg-secondary);color:var(--text-primary);font-size:12px;min-width:160px">
+          <option value="">Clementine (global)</option>
+        </select>
         <span id="builder-agent-label" style="padding:0;font-size:13px;color:var(--text-secondary);font-weight:500"></span>
         <input type="hidden" id="builder-agent" value="">
         <span style="flex:1"></span>
@@ -12771,6 +12862,42 @@ if('serviceWorker' in navigator){navigator.serviceWorker.getRegistrations().then
           <div id="memory-health-content">
             <div class="skel-block"><div class="skel-row med"></div><div class="skel-row"></div><div class="skel-row short"></div></div>
           </div>
+          <div class="card" style="margin-top:18px">
+            <div class="card-header" style="display:flex;align-items:center;justify-content:space-between">
+              <span>Recent writes</span>
+              <span style="font-size:11px;color:var(--text-muted)">What the agent captured, with reason &amp; salience</span>
+            </div>
+            <div class="card-body" id="panel-recent-writes" style="padding:0">
+              <div class="skel-block" style="padding:14px"><div class="skel-row med"></div><div class="skel-row short"></div></div>
+            </div>
+          </div>
+          <div class="card" style="margin-top:18px">
+            <div class="card-header" style="display:flex;align-items:center;justify-content:space-between">
+              <span>Self-correction (supersedes)</span>
+              <span style="font-size:11px;color:var(--text-muted)">Old facts the agent has explicitly replaced</span>
+            </div>
+            <div class="card-body" id="panel-supersedes" style="padding:0">
+              <div class="skel-block" style="padding:14px"><div class="skel-row med"></div><div class="skel-row short"></div></div>
+            </div>
+          </div>
+          <div class="card" style="margin-top:18px">
+            <div class="card-header" style="display:flex;align-items:center;justify-content:space-between">
+              <span>Knowledge graph signals</span>
+              <span style="font-size:11px;color:var(--text-muted)">Wikilink density &amp; which retrieval signal earns its keep (last 7d)</span>
+            </div>
+            <div class="card-body" id="panel-graph-stats" style="padding:0">
+              <div class="skel-block" style="padding:14px"><div class="skel-row med"></div><div class="skel-row short"></div></div>
+            </div>
+          </div>
+          <div class="card" style="margin-top:18px">
+            <div class="card-header" style="display:flex;align-items:center;justify-content:space-between">
+              <span>Cross-channel handoff</span>
+              <span style="font-size:11px;color:var(--text-muted)">Recent session summaries by channel — proves continuity</span>
+            </div>
+            <div class="card-body" id="panel-session-bridge" style="padding:0">
+              <div class="skel-block" style="padding:14px"><div class="skel-row med"></div><div class="skel-row short"></div></div>
+            </div>
+          </div>
           <div class="card" style="margin-top:18px">
             <div class="card-header" style="display:flex;align-items:center;justify-content:space-between">
               <span>Trust &amp; claim verification</span>
@@ -15050,6 +15177,10 @@ function navigateTo(page, opts) {
       try { switchTab('intelligence', intelTab); } catch (e) { /* */ }
       if (bt === 'health') {
         if (typeof refreshMemoryHealth === 'function') refreshMemoryHealth();
+        if (typeof refreshRecentWrites === 'function') refreshRecentWrites();
+        if (typeof refreshSupersedes === 'function') refreshSupersedes();
+        if (typeof refreshGraphStats === 'function') refreshGraphStats();
+        if (typeof refreshSessionBridge === 'function') refreshSessionBridge();
         if (typeof refreshClaims === 'function') refreshClaims();
         if (typeof refreshRoutingAudit === 'function') refreshRoutingAudit();
       }
@@ -15392,6 +15523,10 @@ function switchTab(group, tab) {
     if (tab === 'files' && typeof refreshVaultFiles === 'function') refreshVaultFiles();
     if (tab === 'health') {
       if (typeof refreshMemoryHealth === 'function') refreshMemoryHealth();
+      if (typeof refreshRecentWrites === 'function') refreshRecentWrites();
+      if (typeof refreshSupersedes === 'function') refreshSupersedes();
+      if (typeof refreshGraphStats === 'function') refreshGraphStats();
+      if (typeof refreshSessionBridge === 'function') refreshSessionBridge();
       if (typeof refreshClaims === 'function') refreshClaims();
       if (typeof refreshRoutingAudit === 'function') refreshRoutingAudit();
     }
@@ -20625,12 +20760,220 @@ function formatBytes(n) {
   return (n / 1024 / 1024 / 1024).toFixed(2) + ' GB';
 }
 
-async function memoryHealthAction(action) {
-  var labels = { 'janitor': 'cleanup', 'rebuild-fts': 'FTS rebuild', 'fix-orphans': 'orphan fix' };
+async function refreshSupersedes() {
+  var el = document.getElementById('panel-supersedes');
+  if (!el) return;
+  try {
+    var r = await apiFetch('/api/memory/supersedes');
+    var d = await r.json();
+    if (!d.ok || !d.stats) {
+      el.innerHTML = '<div class="empty-state" style="padding:14px">' + esc(d.error || 'No data') + '</div>';
+      return;
+    }
+    var s = d.stats;
+    if (!s.recent || s.recent.length === 0) {
+      el.innerHTML = '<div class="empty-state" style="padding:14px">No supersedes yet. The agent will record corrections here when it explicitly replaces a stale fact.</div>';
+      return;
+    }
+    var html = '<div style="padding:10px 14px;font-size:12px;color:var(--text-muted)">Total: <b>' + (s.superseded || 0) + '</b> chunks superseded.</div>';
+    html += '<table class="data-table" style="width:100%"><thead><tr>'
+      + '<th style="width:140px">When</th>'
+      + '<th style="width:90px">Old → New</th>'
+      + '<th>Reason</th></tr></thead><tbody>';
+    for (var i = 0; i < s.recent.length; i++) {
+      var sup = s.recent[i];
+      var when = '';
+      try { when = new Date(sup.supersededAt + 'Z').toLocaleString(); } catch { when = sup.supersededAt; }
+      html += '<tr>'
+        + '<td style="font-size:11px;color:var(--text-muted)">' + esc(when) + '</td>'
+        + '<td style="font-size:12px"><code>#' + sup.oldId + '</code> → <code>#' + sup.newId + '</code></td>'
+        + '<td style="font-size:12px">' + (sup.reason ? esc(sup.reason) : '<span style="color:var(--text-muted);opacity:0.6">no reason recorded</span>') + '</td>'
+        + '</tr>';
+    }
+    html += '</tbody></table>';
+    el.innerHTML = html;
+  } catch (err) {
+    el.innerHTML = '<div class="empty-state" style="padding:14px">Failed to load: ' + esc(String(err)) + '</div>';
+  }
+}
+
+async function refreshGraphStats() {
+  var el = document.getElementById('panel-graph-stats');
+  if (!el) return;
+  try {
+    var r = await apiFetch('/api/memory/graph-stats');
+    var d = await r.json();
+    if (!d.ok || !d.stats) {
+      el.innerHTML = '<div class="empty-state" style="padding:14px">' + esc(d.error || 'No data') + '</div>';
+      return;
+    }
+    var s = d.stats;
+    var cb = s.recallContributionByType || {};
+    var totalMatches = 0;
+    for (var k in cb) totalMatches += (cb[k] || 0);
+
+    var html = '<div style="padding:12px 14px;display:grid;grid-template-columns:1fr 1fr;gap:14px">';
+    html += '<div>';
+    html += '<div style="font-size:12px;color:var(--text-muted);margin-bottom:8px">Wikilinks</div>';
+    html += '<div style="font-size:24px;font-weight:700;margin-bottom:8px">' + (s.wikilinkCount || 0).toLocaleString() + '</div>';
+    if (s.topLinkedTargets && s.topLinkedTargets.length > 0) {
+      html += '<div style="font-size:11px;color:var(--text-muted);margin-bottom:4px">Top-linked entities</div>';
+      html += '<table style="width:100%;font-size:12px"><tbody>';
+      for (var i = 0; i < s.topLinkedTargets.length; i++) {
+        var t = s.topLinkedTargets[i];
+        html += '<tr><td style="padding:2px 0">' + esc(t.target) + '</td><td style="text-align:right;color:var(--text-muted);padding:2px 0">' + t.count + '</td></tr>';
+      }
+      html += '</tbody></table>';
+    } else {
+      html += '<div class="empty-state" style="font-size:12px">No wikilinks yet — add [[Name]] refs in vault notes to grow the graph.</div>';
+    }
+    html += '</div>';
+
+    html += '<div>';
+    html += '<div style="font-size:12px;color:var(--text-muted);margin-bottom:8px">Recall contribution (last 7d, ' + (s.tracesAnalyzed || 0) + ' traces)</div>';
+    if (totalMatches === 0) {
+      html += '<div class="empty-state" style="font-size:12px">No recall traces yet. Run a chat to populate.</div>';
+    } else {
+      var order = ['fts', 'vector', 'graph', 'recency'];
+      var labels = { fts: 'Lexical (FTS5)', vector: 'Semantic (dense)', graph: 'Graph (wikilinks)', recency: 'Recency' };
+      var colors = { fts: '#60a5fa', vector: '#10b981', graph: '#f59e0b', recency: '#9ca3af' };
+      html += '<table style="width:100%;font-size:12px"><tbody>';
+      for (var j = 0; j < order.length; j++) {
+        var key = order[j];
+        var cnt = cb[key] || 0;
+        var pct = totalMatches > 0 ? Math.round((cnt / totalMatches) * 100) : 0;
+        html += '<tr><td style="padding:3px 8px 3px 0;width:140px">' + labels[key] + '</td>'
+          + '<td style="padding:3px 0">'
+          + '<div style="display:flex;align-items:center;gap:8px">'
+          + '<div style="flex:1;background:var(--bg-secondary, #1a1a1a);border-radius:3px;overflow:hidden;height:14px">'
+          + '<div style="width:' + pct + '%;background:' + colors[key] + ';height:100%"></div>'
+          + '</div>'
+          + '<span style="font-variant-numeric:tabular-nums;width:50px;text-align:right;color:var(--text-muted)">' + pct + '%</span>'
+          + '</div>'
+          + '</td></tr>';
+      }
+      html += '</tbody></table>';
+    }
+    html += '</div></div>';
+    el.innerHTML = html;
+  } catch (err) {
+    el.innerHTML = '<div class="empty-state" style="padding:14px">Failed to load: ' + esc(String(err)) + '</div>';
+  }
+}
+
+async function refreshSessionBridge() {
+  var el = document.getElementById('panel-session-bridge');
+  if (!el) return;
+  try {
+    var r = await apiFetch('/api/memory/session-bridge');
+    var d = await r.json();
+    if (!d.ok || !d.grouped) {
+      el.innerHTML = '<div class="empty-state" style="padding:14px">' + esc(d.error || 'No data') + '</div>';
+      return;
+    }
+    var channels = Object.keys(d.grouped).sort();
+    if (channels.length === 0) {
+      el.innerHTML = '<div class="empty-state" style="padding:14px">No session summaries yet. They populate as conversations end.</div>';
+      return;
+    }
+    var html = '<div style="padding:12px 14px;display:grid;grid-template-columns:repeat(auto-fit,minmax(260px,1fr));gap:14px">';
+    for (var ci = 0; ci < channels.length; ci++) {
+      var ch = channels[ci];
+      var summaries = d.grouped[ch] || [];
+      html += '<div style="border:1px solid var(--border);border-radius:6px;padding:10px;background:var(--bg-secondary, transparent)">';
+      html += '<div style="font-size:11px;color:var(--text-muted);margin-bottom:6px;text-transform:uppercase;letter-spacing:0.05em">' + esc(ch) + ' &middot; ' + summaries.length + ' recent</div>';
+      for (var si = 0; si < summaries.length; si++) {
+        var ss = summaries[si];
+        var when = '';
+        try { when = new Date(ss.createdAt + 'Z').toLocaleString(); } catch { when = ss.createdAt; }
+        var preview = (ss.summary || '').slice(0, 200);
+        html += '<div style="font-size:12px;margin-bottom:8px;padding-bottom:8px;border-bottom:1px solid var(--border)">'
+          + '<div style="color:var(--text-muted);font-size:10px;margin-bottom:2px">' + esc(when) + ' &middot; ' + ss.exchangeCount + ' exchanges</div>'
+          + esc(preview) + (ss.summary && ss.summary.length > 200 ? '…' : '')
+          + '</div>';
+      }
+      html += '</div>';
+    }
+    html += '</div>';
+    el.innerHTML = html;
+  } catch (err) {
+    el.innerHTML = '<div class="empty-state" style="padding:14px">Failed to load: ' + esc(String(err)) + '</div>';
+  }
+}
+
+async function refreshRecentWrites() {
+  var el = document.getElementById('panel-recent-writes');
+  if (!el) return;
+  try {
+    var r = await apiFetch('/api/memory/writes/recent?limit=30');
+    var d = await r.json();
+    if (!d.ok || !Array.isArray(d.writes)) {
+      el.innerHTML = '<div class="empty-state" style="padding:14px">' + esc(d.error || 'No data') + '</div>';
+      return;
+    }
+    if (d.writes.length === 0) {
+      el.innerHTML = '<div class="empty-state" style="padding:14px">No writes captured yet. The agent will start logging memory_write activity here once Phase 2 reaches her.</div>';
+      return;
+    }
+    var html = '<table class="data-table" style="width:100%">';
+    html += '<thead><tr>'
+      + '<th style="width:120px">When</th>'
+      + '<th style="width:80px">Agent</th>'
+      + '<th style="width:120px">Action</th>'
+      + '<th>Where</th>'
+      + '<th style="width:60px;text-align:right">Sal</th>'
+      + '<th>Reason</th>'
+      + '<th style="width:90px">Status</th>'
+      + '</tr></thead><tbody>';
+    for (var i = 0; i < d.writes.length; i++) {
+      var w = d.writes[i];
+      var when = '';
+      try { when = new Date(w.extractedAt + 'Z').toLocaleString(); } catch { when = w.extractedAt; }
+      var where = w.section ? esc(w.section) : (w.filePath ? esc(w.filePath) : '—');
+      var sal = (w.salienceHint != null) ? Number(w.salienceHint).toFixed(1) : '—';
+      var salColor = (w.salienceHint != null && w.salienceHint > 1.0) ? 'var(--success, #10b981)'
+        : (w.salienceHint != null && w.salienceHint < 1.0) ? 'var(--text-muted)' : 'var(--text-primary)';
+      var statusBadge = w.status === 'dedup_skipped'
+        ? '<span style="color:var(--text-muted);font-size:11px">deduped</span>'
+        : w.status === 'active'
+        ? '<span style="color:var(--success, #10b981);font-size:11px">written</span>'
+        : '<span style="font-size:11px">' + esc(w.status) + '</span>';
+      html += '<tr>'
+        + '<td style="font-size:11px;color:var(--text-muted)">' + esc(when) + '</td>'
+        + '<td style="font-size:11px">' + esc(w.agentSlug || 'global') + '</td>'
+        + '<td style="font-size:12px"><code>' + esc(w.action || w.toolName) + '</code></td>'
+        + '<td style="font-size:12px">' + where + '</td>'
+        + '<td style="text-align:right;font-weight:600;color:' + salColor + '">' + sal + '</td>'
+        + '<td style="font-size:12px;color:var(--text-muted)">' + (w.reason ? esc(w.reason) : '<span style="opacity:0.5">no reason given</span>') + '</td>'
+        + '<td>' + statusBadge + '</td>'
+        + '</tr>';
+    }
+    html += '</tbody></table>';
+    el.innerHTML = html;
+  } catch (err) {
+    el.innerHTML = '<div class="empty-state" style="padding:14px">Failed to load: ' + esc(String(err)) + '</div>';
+  }
+}
+
+async function memoryHealthAction(action, extra) {
+  var labels = { 'janitor': 'cleanup', 'rebuild-fts': 'FTS rebuild', 'fix-orphans': 'orphan fix', 'reembed-dense': 'dense embedding backfill' };
   if (!confirm('Run ' + (labels[action] || action) + ' now?')) return;
   try {
-    var r = await apiJson('POST', '/api/memory/health/action', { action: action });
+    var body = Object.assign({ action: action }, extra || {});
+    var r = await apiJson('POST', '/api/memory/health/action', body);
     if (r.error) { toast('Action failed: ' + r.error, 'error'); return; }
+    if (action === 'reembed-dense' && r.started) {
+      toast('Backfill started in background (' + (r.limit || '?') + ' chunks). Refreshing every 10s…', 'info');
+      // Poll coverage updates so the user sees progress without manually refreshing.
+      var pollCount = 0;
+      var poll = setInterval(function() {
+        refreshMemoryHealth();
+        pollCount++;
+        if (pollCount >= 12) clearInterval(poll); // ~2 minutes
+      }, 10000);
+      refreshMemoryHealth();
+      return;
+    }
     var detail = '';
     if (r.result) detail = ' — ' + Object.entries(r.result).slice(0, 4).map(function(p) { return p[0] + ':' + p[1]; }).join(', ');
     if (r.report) detail = ' — orphans nulled: ' + (r.report.orphanRefsNulled || 0) + ', FTS rebuilds: ' + (r.report.ftsRebuilds || 0);
@@ -20857,8 +21200,38 @@ async function refreshMemoryHealth() {
     html += '<div class="metric-hero"><div class="metric-hero-value">' + formatBytes(h.dbSizeBytes)
       + '</div><div class="metric-hero-label">DB File Size</div>'
       + '<div class="metric-hero-sub">last vacuum: ' + esc(h.lastVacuumAt || 'never') + '</div></div>';
+
+    // Dense embedding coverage — the leading indicator for retrieval quality.
+    // <50% means the agent is mostly searching on TF-IDF and missing semantic matches.
+    var de = h.denseEmbeddings || { withDense: 0, total: 0, models: [], currentModel: '', ready: false };
+    var densePct = de.total > 0 ? ((de.withDense / de.total) * 100).toFixed(1) : '0.0';
+    var denseColor = de.total === 0 ? 'var(--text-muted)'
+      : (de.withDense / Math.max(1, de.total)) >= 0.95 ? 'var(--success, #10b981)'
+      : (de.withDense / Math.max(1, de.total)) >= 0.5 ? 'var(--warning, #f59e0b)'
+      : 'var(--danger, #ef4444)';
+    var modelLabel = de.currentModel ? de.currentModel.split('/').pop() : '—';
+    html += '<div class="metric-hero" style="border-left:3px solid ' + denseColor + '">'
+      + '<div class="metric-hero-value" style="color:' + denseColor + '">' + densePct + '%</div>'
+      + '<div class="metric-hero-label">Semantic Coverage</div>'
+      + '<div class="metric-hero-sub">' + (de.withDense || 0) + ' of ' + (de.total || 0)
+      + ' chunks &middot; ' + esc(modelLabel) + '</div></div>';
+
     html += '</div>';
 
+    // Coverage call-to-action — only render when there's work to do.
+    if (de.total > 0 && de.withDense < de.total) {
+      var missing = de.total - de.withDense;
+      html += '<div class="card" style="margin-bottom:16px;border-left:3px solid ' + denseColor + '">';
+      html += '<div class="card-body" style="padding:14px;display:flex;align-items:center;gap:14px;flex-wrap:wrap">';
+      html += '<div style="flex:1;min-width:240px">';
+      html += '<div style="font-weight:600;margin-bottom:4px">Retrieval running on sparse vectors for ' + missing.toLocaleString() + ' chunks</div>';
+      html += '<div style="font-size:12px;color:var(--text-muted)">Backfill builds 768-dim neural embeddings for semantic search. First run downloads ~440MB.</div>';
+      html += '</div>';
+      html += '<button class="btn-sm" onclick="memoryHealthAction(\'reembed-dense\', { limit: 200 })" title="Embed up to 200 chunks now">Backfill 200</button>';
+      html += '<button class="btn-sm" onclick="memoryHealthAction(\'reembed-dense\', { limit: 2000 })" title="Embed up to 2000 chunks now (slower)">Backfill 2000</button>';
+      html += '</div></div>';
+    }
+
     // Two-column layout: categories + table sizes on left, top cited on right.
     html += '<div style="display:grid;grid-template-columns:1fr 1fr;gap:16px">';
 

package/dist/dashboard/builder/serializer.d.ts

@@ -15,15 +15,24 @@
  * unless edited through this module, and edits preserve unrelated fields.
  */
 import type { WorkflowDefinition, CronJobDefinition, BuilderWorkflowSummary, WorkflowOriginKind } from '../../types.js';
-export declare function cronId(name: string): string;
-export declare function workflowId(filename: string): string;
-export declare function parseBuilderId(id: string): {
+export declare function cronId(name: string, agentSlug?: string): string;
+export declare function workflowId(filename: string, agentSlug?: string): string;
+export type ParsedBuilderId = {
     origin: WorkflowOriginKind;
+    scope: 'global';
     key: string;
-} | null;
+} | {
+    origin: WorkflowOriginKind;
+    scope: 'agent';
+    agentSlug: string;
+    key: string;
+};
+export declare function parseBuilderId(id: string): ParsedBuilderId | null;
 export declare function listAllForBuilder(): BuilderWorkflowSummary[];
 export declare function readWorkflow(id: string): WorkflowDefinition | null;
-export declare function cronJobToWorkflow(job: CronJobDefinition): WorkflowDefinition;
+export declare function cronJobToWorkflow(job: CronJobDefinition, opts?: {
+    sourceFile?: string;
+}): WorkflowDefinition;
 /** True if a workflow is shaped like a CRON.md entry (single prompt step + cron schedule). */
 export declare function isCronShape(wf: WorkflowDefinition): boolean;
 export declare function saveWorkflow(id: string, wf: WorkflowDefinition): {
@@ -32,11 +41,8 @@ export declare function saveWorkflow(id: string, wf: WorkflowDefinition): {
     ok: false;
     error: string;
 };
-/** Resolve the on-disk file path for a builder id (cron entries all share CRON_FILE). */
-export declare function sourceFileForId(id: string, parsedHint?: {
-    origin: WorkflowOriginKind;
-    key: string;
-}): string | null;
+/** Resolve the on-disk file path for a builder id. */
+export declare function sourceFileForId(id: string, parsedHint?: ParsedBuilderId): string | null;
 /** Drawflow node shape (subset we use). */
 interface DrawflowNode {
     id: number;