claude-memory-layer 1.0.40 → 1.0.42

package/dist/ui/assets/js/bootstrap.js

@@ -77,8 +77,12 @@ function setupEventListeners() {
       });
       await loadKpiData();
       await loadMemoryUsefulnessData();
+      await loadOperationsStatsData();
+      await loadPerspectiveStatsData();
       updateKpiCardsUI();
       updateMemoryUsefulnessUI();
+      updateOperationsStatsUI();
+      updatePerspectiveStatsUI();
       renderKpiTrendChart();
     });
   });
@@ -151,6 +155,11 @@ function setupEventListeners() {
     refreshBtn.addEventListener('click', refreshData);
   }
 
+  const vectorHealthRecoverBtn = document.getElementById('vector-health-recover-btn');
+  if (vectorHealthRecoverBtn) {
+    vectorHealthRecoverBtn.addEventListener('click', recoverVectorHealth);
+  }
+
   // Stat cards
   document.querySelectorAll('.stat-card[data-stat]').forEach(card => {
     card.addEventListener('click', () => {

package/dist/ui/assets/js/overview.js

@@ -10,6 +10,28 @@ async function loadMemoryUsefulnessData() {
     .catch(() => null);
 }
 
+function operationStatsWindowDays() {
+  return state.kpiWindow === '30d' ? 30 : 7;
+}
+
+async function loadOperationsStatsData() {
+  state.operationsStats = await fetch(apiUrl(`${API_BASE}/stats/operations`, { windowDays: operationStatsWindowDays() }))
+    .then(r => r.ok ? r.json() : null)
+    .catch(() => null);
+}
+
+async function loadPerspectiveStatsData() {
+  state.perspectiveStats = await fetch(apiUrl(`${API_BASE}/stats/perspective`, { windowDays: operationStatsWindowDays() }))
+    .then(r => r.ok ? r.json() : null)
+    .catch(() => null);
+}
+
+async function loadVectorHealthData() {
+  state.vectorHealth = await fetch(apiUrl(`${API_BASE}/health`))
+    .then(r => r.ok ? r.json() : null)
+    .catch(() => null);
+}
+
 async function refreshData() {
   const btn = document.getElementById('refresh-btn');
   if(btn) btn.classList.add('loading');
@@ -19,7 +41,7 @@ async function refreshData() {
   const kpiWindowAtStart = state.kpiWindow;
 
   try {
-    const [stats, shared, mostAccessed, helpfulness, memoryUsefulness, retrievalTraces, retrievalReviewQueue, adherenceSummary] = await Promise.all([
+    const [stats, shared, mostAccessed, helpfulness, memoryUsefulness, retrievalTraces, retrievalReviewQueue, operationsStats, perspectiveStats, adherenceSummary, vectorHealth] = await Promise.all([
       fetch(apiUrl(`${API_BASE}/stats`)).then(r => r.json()).catch(() => null),
       fetch(apiUrl(`${API_BASE}/stats/shared`)).then(r => r.json()).catch(() => null),
       fetch(apiUrl(`${API_BASE}/stats/most-accessed`, { limit: 10 })).then(r => r.json()).catch(() => null),
@@ -27,7 +49,10 @@ async function refreshData() {
       fetch(apiUrl(`${API_BASE}/stats/usefulness`, { window: state.kpiWindow })).then(r => r.json()).catch(() => null),
       fetch(apiUrl(`${API_BASE}/stats/retrieval-traces`, { limit: 20 })).then(r => r.json()).catch(() => null),
       fetch(apiUrl(`${API_BASE}/stats/retrieval-review-queue`, { limit: 10 })).then(r => r.json()).catch(() => null),
-      fetchAdherenceSummary().catch(() => null)
+      fetch(apiUrl(`${API_BASE}/stats/operations`, { windowDays: operationStatsWindowDays() })).then(r => r.ok ? r.json() : null).catch(() => null),
+      fetch(apiUrl(`${API_BASE}/stats/perspective`, { windowDays: operationStatsWindowDays() })).then(r => r.ok ? r.json() : null).catch(() => null),
+      fetchAdherenceSummary().catch(() => null),
+      fetch(apiUrl(`${API_BASE}/health`)).then(r => r.ok ? r.json() : null).catch(() => null)
     ]);
 
     if (
@@ -45,7 +70,10 @@ async function refreshData() {
     state.memoryUsefulness = memoryUsefulness;
     state.retrievalTraces = retrievalTraces;
     state.retrievalReviewQueue = retrievalReviewQueue;
+    state.operationsStats = operationsStats;
+    state.perspectiveStats = perspectiveStats;
     state.adherenceSummary = adherenceSummary;
+    state.vectorHealth = vectorHealth;
 
     await loadKpiData();
     if (refreshRequestId !== state.refreshRequestId) return;
@@ -365,6 +393,523 @@ function updateMemoryUsageUI() {
   updateTopAccessedEventsUI();
   updateAdherenceSummaryUI();
   updateRetrievalTraceUI();
+  updateVectorHealthUI();
+  updateOperationsStatsUI();
+  updatePerspectiveStatsUI();
+}
+
+function vectorHealthCount(value) {
+  const count = Number(value || 0);
+  return Number.isFinite(count) && count > 0 ? count : 0;
+}
+
+function vectorHealthEmpty(message) {
+  return `<div style="padding:12px; text-align:center; color:var(--text-muted); font-size:13px;">${escapeHtml(message)}</div>`;
+}
+
+function vectorOutboxTotals(outbox) {
+  const embedding = outbox?.embedding || {};
+  const vector = outbox?.vector || {};
+  const providedTotals = outbox?.totals || null;
+  return {
+    pending: vectorHealthCount(providedTotals?.pending ?? (vectorHealthCount(embedding.pending) + vectorHealthCount(vector.pending))),
+    processing: vectorHealthCount(providedTotals?.processing ?? (vectorHealthCount(embedding.processing) + vectorHealthCount(vector.processing))),
+    failed: vectorHealthCount(providedTotals?.failed ?? (vectorHealthCount(embedding.failed) + vectorHealthCount(vector.failed))),
+    stuckProcessing: vectorHealthCount(providedTotals?.stuckProcessing ?? (vectorHealthCount(embedding.stuckProcessing) + vectorHealthCount(vector.stuckProcessing))),
+    oldestProcessingAgeMs: providedTotals?.oldestProcessingAgeMs ?? maxNullableHealthAge(embedding.oldestProcessingAgeMs, vector.oldestProcessingAgeMs)
+  };
+}
+
+function maxNullableHealthAge(a, b) {
+  const values = [a, b]
+    .map(value => Number(value))
+    .filter(value => Number.isFinite(value) && value >= 0);
+  return values.length > 0 ? Math.max(...values) : null;
+}
+
+function formatVectorHealthAge(ms) {
+  const value = Number(ms);
+  if (!Number.isFinite(value) || value <= 0) return 'none';
+  const seconds = Math.floor(value / 1000);
+  if (seconds < 60) return `${seconds}s`;
+  const minutes = Math.floor(seconds / 60);
+  if (minutes < 60) return `${minutes}m`;
+  const hours = Math.floor(minutes / 60);
+  if (hours < 48) return `${hours}h`;
+  return `${Math.floor(hours / 24)}d`;
+}
+
+function vectorOutboxQueueRow(label, stats) {
+  const pending = vectorHealthCount(stats?.pending);
+  const processing = vectorHealthCount(stats?.processing);
+  const failed = vectorHealthCount(stats?.failed);
+  const stuck = vectorHealthCount(stats?.stuckProcessing);
+  const total = vectorHealthCount(stats?.total);
+  const age = formatVectorHealthAge(stats?.oldestProcessingAgeMs);
+  const statusColor = failed > 0 || stuck > 0 ? 'var(--warning)' : 'var(--success)';
+  return `
+    <div class="shared-item">
+      <div class="shared-info" style="flex-direction:column; align-items:flex-start; gap:2px; min-width:0;">
+        <span style="font-size:12px; color:var(--text-secondary);">${escapeHtml(label)}</span>
+        <span style="font-size:10px; color:var(--text-muted);">pending ${formatNumber(pending)} · processing ${formatNumber(processing)} · failed ${formatNumber(failed)} · stuck ${formatNumber(stuck)} · oldest ${age}</span>
+      </div>
+      <div style="display:flex; flex-direction:column; align-items:flex-end; gap:2px; min-width:48px;">
+        <span style="font-size:15px; font-weight:700; color:${statusColor};">${formatNumber(total)}</span>
+        <span style="font-size:10px; color:var(--text-muted);">total</span>
+      </div>
+    </div>
+  `;
+}
+
+function recoveryBucketTotal(bucket) {
+  return vectorHealthCount(bucket?.recoveredProcessing) + vectorHealthCount(bucket?.retriedFailed);
+}
+
+function renderVectorHealthRecovery() {
+  const recoveryEl = document.getElementById('vector-health-recovery-result');
+  if (!recoveryEl) return;
+
+  const recovery = state.vectorHealthRecovery;
+  const recoveryProject = state.vectorHealthRecoveryProject;
+  if (recovery && recoveryProject !== null && recoveryProject !== (state.currentProject || '')) {
+    recoveryEl.innerHTML = '<span style="color:var(--text-muted);">No recovery run in this dashboard session.</span>';
+    return;
+  }
+  if (!recovery) {
+    recoveryEl.innerHTML = '<span style="color:var(--text-muted);">No recovery run in this dashboard session.</span>';
+    return;
+  }
+
+  if (recovery.status && recovery.status !== 'ok') {
+    recoveryEl.innerHTML = '<span style="color:var(--warning);">Last recovery request failed. No private error details are shown.</span>';
+    return;
+  }
+
+  const embeddingTotal = recoveryBucketTotal(recovery.recovered?.embedding);
+  const vectorTotal = recoveryBucketTotal(recovery.recovered?.vector);
+  const timestamp = recovery.timestamp ? new Date(recovery.timestamp).toLocaleString() : 'just now';
+  recoveryEl.innerHTML = `
+    <span style="color:var(--text-secondary);">Last recovery ${escapeHtml(timestamp)}</span>
+    <span style="color:var(--text-muted); margin-left:6px;">embedding=${formatNumber(embeddingTotal)} · vector=${formatNumber(vectorTotal)} · total=${formatNumber(embeddingTotal + vectorTotal)}</span>
+  `;
+}
+
+function updateVectorHealthUI() {
+  const payload = state.vectorHealth;
+  const summaryEl = document.getElementById('vector-health-summary');
+  const queueEl = document.getElementById('vector-health-queue-list');
+  const recoveryEl = document.getElementById('vector-health-recovery-result');
+  if (!summaryEl && !queueEl && !recoveryEl) return;
+
+  if (!payload) {
+    if (summaryEl) summaryEl.innerHTML = '<span style="color:var(--text-muted);">Vector health unavailable</span>';
+    if (queueEl) queueEl.innerHTML = vectorHealthEmpty('Vector health aggregate data unavailable');
+    renderVectorHealthRecovery();
+    return;
+  }
+
+  const status = payload.status || 'unknown';
+  const outbox = payload.outbox || {};
+  const totals = vectorOutboxTotals(outbox);
+  const vectorCount = vectorHealthCount(payload.storage?.vectorCount);
+  const statusColor = status === 'ok' ? 'var(--success)' : (status === 'needs-attention' ? 'var(--warning)' : 'var(--text-muted)');
+
+  if (summaryEl) {
+    summaryEl.innerHTML = `
+      <div style="display:flex; gap:10px; flex-wrap:wrap; font-size:13px; color:var(--text-secondary);">
+        <span><strong style="color:${statusColor};">${escapeHtml(status)}</strong></span>
+        <span><strong>${formatNumber(vectorCount)} vectors</strong></span>
+        <span><strong>${formatNumber(totals.pending)} pending</strong></span>
+        <span><strong>${formatNumber(totals.processing)} processing</strong></span>
+        <span><strong>${formatNumber(totals.failed)} failed</strong></span>
+        <span><strong>${formatNumber(totals.stuckProcessing)} stuck</strong></span>
+        <span><strong>${formatVectorHealthAge(totals.oldestProcessingAgeMs)} oldest processing</strong></span>
+      </div>
+    `;
+  }
+
+  if (queueEl) {
+    queueEl.innerHTML = [
+      vectorOutboxQueueRow('Embedding Outbox', outbox.embedding),
+      vectorOutboxQueueRow('Vector Outbox', outbox.vector)
+    ].join('');
+  }
+
+  renderVectorHealthRecovery();
+}
+
+function healthPayloadFromRecovery(payload) {
+  const after = payload?.after || {};
+  if (!after.storage && !after.outbox) return null;
+  const totals = vectorOutboxTotals(after.outbox || {});
+  const status = totals.failed > 0 || totals.stuckProcessing > 0 ? 'needs-attention' : (payload.status || 'ok');
+  return {
+    status,
+    timestamp: payload.timestamp || new Date().toISOString(),
+    storage: after.storage || {},
+    outbox: after.outbox || {},
+    levelStats: []
+  };
+}
+
+async function recoverVectorHealth() {
+  const button = document.getElementById('vector-health-recover-btn');
+  if (state.isVectorRecoveryRunning) return;
+  state.isVectorRecoveryRunning = true;
+  if (button) button.disabled = true;
+
+  try {
+    const response = await fetch(apiUrl(`${API_BASE}/health/recover`), {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({})
+    });
+    if (!response.ok) throw new Error('recovery failed');
+    const payload = await response.json();
+    state.vectorHealthRecovery = payload;
+    state.vectorHealthRecoveryProject = state.currentProject || '';
+    const health = healthPayloadFromRecovery(payload);
+    if (health) state.vectorHealth = health;
+    updateVectorHealthUI();
+  } catch {
+    state.vectorHealthRecovery = {
+      status: 'error',
+      timestamp: new Date().toISOString(),
+      recovered: {
+        embedding: { recoveredProcessing: 0, retriedFailed: 0 },
+        vector: { recoveredProcessing: 0, retriedFailed: 0 }
+      }
+    };
+    state.vectorHealthRecoveryProject = state.currentProject || '';
+    updateVectorHealthUI();
+  } finally {
+    state.isVectorRecoveryRunning = false;
+    if (button) button.disabled = false;
+  }
+}
+
+function operationCount(value) {
+  const count = Number(value || 0);
+  return Number.isFinite(count) && count > 0 ? count : 0;
+}
+
+function operationEmpty(message) {
+  return `<div style="padding:12px; text-align:center; color:var(--text-muted); font-size:13px;">${escapeHtml(message)}</div>`;
+}
+
+function operationRows(rows, labelKey, countKey, emptyMessage, labelFormatter) {
+  const safeRows = Array.isArray(rows) ? rows : [];
+  if (safeRows.length === 0) return operationEmpty(emptyMessage);
+  return safeRows.map(row => {
+    const label = labelFormatter ? labelFormatter(row) : row?.[labelKey];
+    return `
+      <div class="shared-item">
+        <div class="shared-info" style="min-width:0;">
+          <span style="font-size:12px; color:var(--text-secondary); white-space:nowrap; overflow:hidden; text-overflow:ellipsis;">${escapeHtml(label || 'unknown')}</span>
+        </div>
+        <div class="shared-count">${formatNumber(operationCount(row?.[countKey]))}</div>
+      </div>
+    `;
+  }).join('');
+}
+
+function updateOperationsStatsUI() {
+  const payload = state.operationsStats;
+  const summaryEl = document.getElementById('operations-stats-summary');
+  const facetsEl = document.getElementById('operations-facets-list');
+  const actionsEl = document.getElementById('operations-actions-list');
+  const leasesEl = document.getElementById('operations-leases-list');
+  const retentionEl = document.getElementById('operations-retention-list');
+  const governanceEl = document.getElementById('operations-governance-list');
+  const lessonsEl = document.getElementById('operations-lessons-list');
+
+  if (!summaryEl && !facetsEl && !actionsEl && !leasesEl && !retentionEl && !governanceEl && !lessonsEl) return;
+
+  if (!payload) {
+    if (summaryEl) summaryEl.innerHTML = '<span style="color:var(--text-muted);">Operation aggregates unavailable</span>';
+    if (facetsEl) facetsEl.innerHTML = operationEmpty('Operation aggregate data unavailable');
+    if (actionsEl) actionsEl.innerHTML = operationEmpty('Operation aggregate data unavailable');
+    if (leasesEl) leasesEl.innerHTML = operationEmpty('Operation aggregate data unavailable');
+    if (retentionEl) retentionEl.innerHTML = operationEmpty('Operation aggregate data unavailable');
+    if (governanceEl) governanceEl.innerHTML = operationEmpty('Operation aggregate data unavailable');
+    if (lessonsEl) lessonsEl.innerHTML = operationEmpty('Operation aggregate data unavailable');
+    return;
+  }
+
+  const available = payload.projection?.available !== false && payload.projection?.databaseExists !== false;
+  if (summaryEl) {
+    if (!available) {
+      summaryEl.innerHTML = '<span style="color:var(--text-muted);">Operation projections unavailable</span>';
+    } else {
+      summaryEl.innerHTML = `
+        <div style="display:flex; gap:10px; flex-wrap:wrap; font-size:13px; color:var(--text-secondary);">
+          <span><strong>${formatNumber(operationCount(payload.facets?.totalAssignments))} facets</strong></span>
+          <span><strong>${formatNumber(operationCount(payload.actions?.total))} actions</strong></span>
+          <span><strong>${formatNumber(operationCount(payload.leases?.totalActive))} active leases</strong></span>
+          <span><strong>${formatNumber(operationCount(payload.retention?.total))} retention decisions</strong></span>
+          <span><strong>${formatNumber(operationCount(payload.governanceAudit?.total))} audits</strong></span>
+          <span><strong>${formatNumber(operationCount(payload.lessons?.total))} lessons</strong></span>
+        </div>
+      `;
+    }
+  }
+
+  if (!available) {
+    if (facetsEl) facetsEl.innerHTML = operationEmpty('No facet aggregates');
+    if (actionsEl) actionsEl.innerHTML = operationEmpty('No action status data');
+    if (leasesEl) leasesEl.innerHTML = operationEmpty('No active leases');
+    if (retentionEl) retentionEl.innerHTML = operationEmpty('No retention decisions');
+    if (governanceEl) governanceEl.innerHTML = operationEmpty('No governance audit activity');
+    if (lessonsEl) lessonsEl.innerHTML = operationEmpty('No lesson confidence data');
+    return;
+  }
+
+  if (facetsEl) {
+    const distributions = Array.isArray(payload.facets?.distribution) ? payload.facets.distribution : [];
+    facetsEl.innerHTML = distributions.length === 0
+      ? operationEmpty('No facet aggregates')
+      : distributions.map(item => {
+          const valueCount = Array.isArray(item?.values) ? item.values.reduce((sum, row) => sum + operationCount(row?.count), 0) : 0;
+          const otherCount = operationCount(item?.other);
+          const bucketCount = (Array.isArray(item?.values) ? item.values.length : 0) + (otherCount > 0 ? 1 : 0);
+          return `
+            <div class="shared-item">
+              <div class="shared-info" style="min-width:0;">
+                <span style="font-size:12px; color:var(--text-secondary); white-space:nowrap; overflow:hidden; text-overflow:ellipsis;">${escapeHtml(item?.dimension || 'unknown')}</span>
+              </div>
+              <div style="display:flex; flex-direction:column; align-items:flex-end; gap:2px; min-width:72px;">
+                <span style="font-size:15px; font-weight:700; color:var(--accent-primary);">${formatNumber(valueCount + otherCount)}</span>
+                <span style="font-size:10px; color:var(--text-muted);">${bucketCount} value buckets</span>
+              </div>
+            </div>
+          `;
+        }).join('');
+  }
+
+  if (actionsEl) actionsEl.innerHTML = operationRows(payload.actions?.byStatus, 'status', 'count', 'No action status data');
+  if (leasesEl) leasesEl.innerHTML = operationRows(payload.leases?.activeByTargetType, 'targetType', 'count', 'No active leases');
+  if (retentionEl) retentionEl.innerHTML = operationRows(payload.retention?.byDecision, 'decision', 'count', 'No retention decisions');
+  if (governanceEl) {
+    const days = Array.isArray(payload.governanceAudit?.operationsByDay) ? payload.governanceAudit.operationsByDay : [];
+    governanceEl.innerHTML = days.length === 0
+      ? operationEmpty('No governance audit activity')
+      : days.map(day => {
+          const operations = (Array.isArray(day?.operations) ? day.operations : [])
+            .map(op => `${escapeHtml(op?.operation || 'unknown')}: ${formatNumber(operationCount(op?.count))}`)
+            .join(' · ');
+          return `
+            <div class="shared-item">
+              <div class="shared-info" style="flex-direction:column; align-items:flex-start; gap:2px; min-width:0;">
+                <span style="font-size:12px; color:var(--text-secondary);">${escapeHtml(day?.date || 'unknown')}</span>
+                <span style="font-size:10px; color:var(--text-muted); white-space:nowrap; overflow:hidden; text-overflow:ellipsis; max-width:220px;">${operations || 'no operations'}</span>
+              </div>
+              <div class="shared-count">${formatNumber(operationCount(day?.total))}</div>
+            </div>
+          `;
+        }).join('');
+  }
+  if (lessonsEl) lessonsEl.innerHTML = operationRows(payload.lessons?.confidenceBuckets, 'bucket', 'count', 'No lesson confidence data');
+}
+
+function perspectiveLevelRows(rows, emptyMessage) {
+  return operationRows(rows, 'level', 'count', emptyMessage);
+}
+
+function perspectiveGraphRows(edges) {
+  const safeEdges = Array.isArray(edges) ? edges : [];
+  if (safeEdges.length === 0) return operationEmpty('No perspective graph edges');
+  return safeEdges.map(edge => {
+    const confidence = `${(Number(edge?.averageConfidence || 0) * 100).toFixed(0)}% avg confidence`;
+    const levels = (Array.isArray(edge?.levelCounts) ? edge.levelCounts : [])
+      .map(level => `${escapeHtml(level?.level || 'unknown')}: ${formatNumber(operationCount(level?.count))}`)
+      .join(' · ');
+    return `
+      <div class="shared-item">
+        <div class="shared-info" style="flex-direction:column; align-items:flex-start; gap:2px; min-width:0;">
+          <span style="font-size:12px; color:var(--text-secondary); white-space:nowrap; overflow:hidden; text-overflow:ellipsis; max-width:240px;">${escapeHtml(edge?.observerActorId || 'unknown')} → ${escapeHtml(edge?.observedActorId || 'unknown')}</span>
+          <span style="font-size:10px; color:var(--text-muted);">${formatNumber(operationCount(edge?.observationCount))} observations · ${formatNumber(operationCount(edge?.actorCardCount))} actor cards · ${confidence}</span>
+          <span style="font-size:10px; color:var(--text-muted);">sources: ${formatNumber(operationCount(edge?.sourceEventCount))} events · ${formatNumber(operationCount(edge?.sourceObservationCount))} observations</span>
+          <span style="font-size:10px; color:var(--text-muted); white-space:nowrap; overflow:hidden; text-overflow:ellipsis; max-width:240px;">${levels || 'no levels'}</span>
+        </div>
+        <div class="shared-count">${formatNumber(operationCount(edge?.observationCount))}</div>
+      </div>
+    `;
+  }).join('');
+}
+
+function perspectiveSourceEvidenceRows(sourceEvidence) {
+  const rows = Array.isArray(sourceEvidence?.byLevel) ? sourceEvidence.byLevel : [];
+  const summary = sourceEvidence?.summary || {};
+  if (rows.length === 0) return operationEmpty('No source evidence aggregates');
+  return `
+    <div class="shared-item">
+      <div class="shared-info" style="flex-direction:column; align-items:flex-start; gap:2px; min-width:0;">
+        <span style="font-size:12px; color:var(--text-secondary);">Evidence coverage</span>
+        <span style="font-size:10px; color:var(--text-muted);">${formatNumber(operationCount(summary.totalSourceEvents))} source events · ${formatNumber(operationCount(summary.totalSourceObservations))} source observations · ${formatNumber(operationCount(summary.observationsMissingEvidence))} missing evidence</span>
+      </div>
+      <div class="shared-count">${formatNumber(operationCount(summary.totalObservations))}</div>
+    </div>
+    ${rows.map(row => `
+      <div class="shared-item">
+        <div class="shared-info" style="flex-direction:column; align-items:flex-start; gap:2px; min-width:0;">
+          <span style="font-size:12px; color:var(--text-secondary);">${escapeHtml(row?.level || 'unknown')}</span>
+          <span style="font-size:10px; color:var(--text-muted);">sources: ${formatNumber(operationCount(row?.sourceEventCount))} events · ${formatNumber(operationCount(row?.sourceObservationCount))} observations · missing: ${formatNumber(operationCount(row?.missingEvidenceCount))}</span>
+        </div>
+        <div class="shared-count">${formatNumber(operationCount(row?.count))}</div>
+      </div>
+    `).join('')}
+  `;
+}
+
+function updatePerspectiveStatsUI() {
+  const payload = state.perspectiveStats;
+  const summaryEl = document.getElementById('perspective-stats-summary');
+  const actorsEl = document.getElementById('perspective-actors-list');
+  const cardsEl = document.getElementById('perspective-cards-list');
+  const observationsEl = document.getElementById('perspective-observations-list');
+  const graphEl = document.getElementById('perspective-graph-list');
+  const evidenceEl = document.getElementById('perspective-evidence-list');
+  const contradictionsEl = document.getElementById('perspective-contradictions-list');
+  const activityEl = document.getElementById('perspective-activity-list');
+
+  if (!summaryEl && !actorsEl && !cardsEl && !observationsEl && !graphEl && !evidenceEl && !contradictionsEl && !activityEl) return;
+
+  if (!payload) {
+    if (summaryEl) summaryEl.innerHTML = '<span style="color:var(--text-muted);">Perspective aggregates unavailable</span>';
+    if (actorsEl) actorsEl.innerHTML = operationEmpty('Perspective aggregate data unavailable');
+    if (cardsEl) cardsEl.innerHTML = operationEmpty('Perspective aggregate data unavailable');
+    if (observationsEl) observationsEl.innerHTML = operationEmpty('Perspective aggregate data unavailable');
+    if (graphEl) graphEl.innerHTML = operationEmpty('Perspective aggregate data unavailable');
+    if (evidenceEl) evidenceEl.innerHTML = operationEmpty('Perspective aggregate data unavailable');
+    if (contradictionsEl) contradictionsEl.innerHTML = operationEmpty('Perspective aggregate data unavailable');
+    if (activityEl) activityEl.innerHTML = operationEmpty('Perspective aggregate data unavailable');
+    return;
+  }
+
+  const available = payload.projection?.available !== false && payload.projection?.databaseExists !== false;
+  if (summaryEl) {
+    if (!available) {
+      summaryEl.innerHTML = '<span style="color:var(--text-muted);">Perspective projections unavailable</span>';
+    } else {
+      summaryEl.innerHTML = `
+        <div style="display:flex; gap:10px; flex-wrap:wrap; font-size:13px; color:var(--text-secondary);">
+          <span><strong>${formatNumber(operationCount(payload.actors?.total))} actors</strong></span>
+          <span><strong>${formatNumber(operationCount(payload.sessionActors?.total))} session actors</strong></span>
+          <span><strong>${formatNumber(operationCount(payload.actorCards?.total))} actor cards</strong></span>
+          <span><strong>${formatNumber(operationCount(payload.observations?.total))} observations</strong></span>
+          <span><strong>${formatNumber(operationCount(payload.perspectiveGraph?.summary?.totalEdges))} perspective edges</strong></span>
+          <span><strong>${formatNumber(operationCount(payload.contradictions?.summary?.total))} contradictions</strong></span>
+        </div>
+      `;
+    }
+  }
+
+  if (!available) {
+    if (actorsEl) actorsEl.innerHTML = operationEmpty('No actor kind data');
+    if (cardsEl) cardsEl.innerHTML = operationEmpty('No actor card aggregates');
+    if (observationsEl) observationsEl.innerHTML = operationEmpty('No perspective observation data');
+    if (graphEl) graphEl.innerHTML = operationEmpty('No perspective graph edges');
+    if (evidenceEl) evidenceEl.innerHTML = operationEmpty('No source evidence aggregates');
+    if (contradictionsEl) contradictionsEl.innerHTML = operationEmpty('No contradictions queued');
+    if (activityEl) activityEl.innerHTML = operationEmpty('No perspective activity');
+    return;
+  }
+
+  if (actorsEl) {
+    const kindRows = operationRows(payload.actors?.byKind, 'kind', 'count', 'No actor kind data');
+    const roleRows = operationRows(payload.sessionActors?.byRole, 'role', 'count', 'No session actor roles');
+    actorsEl.innerHTML = `
+      <div class="section-label" style="font-size:11px; margin-bottom:6px;">Actor Kinds</div>
+      ${kindRows}
+      <div class="section-label" style="font-size:11px; margin:12px 0 6px;">Session Roles</div>
+      ${roleRows}
+      <div style="font-size:10px; color:var(--text-muted); padding:8px 0;">observe self: ${formatNumber(operationCount(payload.sessionActors?.observeSelfEnabled))} · observe others: ${formatNumber(operationCount(payload.sessionActors?.observeOthersEnabled))}</div>
+    `;
+  }
+
+  if (cardsEl) {
+    const totalCards = operationCount(payload.actorCards?.total);
+    if (totalCards === 0) {
+      cardsEl.innerHTML = operationEmpty('No actor card aggregates');
+    } else {
+      cardsEl.innerHTML = `
+        <div class="shared-item">
+          <div class="shared-info"><span style="font-size:12px; color:var(--text-secondary);">Total cards</span></div>
+          <div class="shared-count">${formatNumber(totalCards)}</div>
+        </div>
+        <div class="shared-item">
+          <div class="shared-info"><span style="font-size:12px; color:var(--text-secondary);">Card entries</span></div>
+          <div class="shared-count">${formatNumber(operationCount(payload.actorCards?.totalEntries))} entries</div>
+        </div>
+        <div class="shared-item">
+          <div class="shared-info"><span style="font-size:12px; color:var(--text-secondary);">Average entries</span></div>
+          <div class="shared-count">${Number(payload.actorCards?.averageEntries || 0).toFixed(2)}</div>
+        </div>
+        <div class="shared-item">
+          <div class="shared-info"><span style="font-size:12px; color:var(--text-secondary);">Full cards</span></div>
+          <div class="shared-count">${formatNumber(operationCount(payload.actorCards?.fullCards))} full cards</div>
+        </div>
+      `;
+    }
+  }
+
+  if (observationsEl) {
+    const byLevel = perspectiveLevelRows(payload.observations?.byLevel, 'No perspective observation data');
+    const byCreatedBy = operationRows(payload.observations?.byCreatedBy, 'createdBy', 'count', 'No observation creator data');
+    observationsEl.innerHTML = `
+      <div class="section-label" style="font-size:11px; margin-bottom:6px;">Timeline / Levels</div>
+      ${byLevel}
+      <div class="section-label" style="font-size:11px; margin:12px 0 6px;">Created By</div>
+      ${byCreatedBy}
+    `;
+  }
+
+  if (graphEl) {
+    graphEl.innerHTML = perspectiveGraphRows(payload.perspectiveGraph?.edges);
+  }
+
+  if (evidenceEl) {
+    evidenceEl.innerHTML = perspectiveSourceEvidenceRows(payload.sourceEvidence);
+  }
+
+  if (contradictionsEl) {
+    const items = Array.isArray(payload.contradictions?.items) ? payload.contradictions.items : [];
+    contradictionsEl.innerHTML = items.length === 0
+      ? operationEmpty('No contradictions queued')
+      : items.map(item => {
+          const confidence = `${(Number(item?.confidence || 0) * 100).toFixed(0)}%`;
+          return `
+            <div class="shared-item">
+              <div class="shared-info" style="flex-direction:column; align-items:flex-start; gap:2px; min-width:0;">
+                <span style="font-size:12px; color:var(--text-secondary); white-space:nowrap; overflow:hidden; text-overflow:ellipsis; max-width:220px;">${escapeHtml(item?.observationId || 'unknown')}</span>
+                <span style="font-size:10px; color:var(--text-muted);">${escapeHtml(item?.observerActorId || 'unknown')} → ${escapeHtml(item?.observedActorId || 'unknown')}</span>
+                <span style="font-size:10px; color:var(--text-muted);">sources: ${formatNumber(operationCount(item?.sourceEventCount))} events · ${formatNumber(operationCount(item?.sourceObservationCount))} observations</span>
+              </div>
+              <div class="shared-count">${confidence}</div>
+            </div>
+          `;
+        }).join('');
+  }
+
+  if (activityEl) {
+    const days = Array.isArray(payload.recentActivity?.byDay) ? payload.recentActivity.byDay : [];
+    activityEl.innerHTML = days.length === 0
+      ? operationEmpty('No perspective activity')
+      : days.map(day => {
+          const levels = (Array.isArray(day?.levels) ? day.levels : [])
+            .map(level => `${escapeHtml(level?.level || 'unknown')}: ${formatNumber(operationCount(level?.count))}`)
+            .join(' · ');
+          return `
+            <div class="shared-item">
+              <div class="shared-info" style="flex-direction:column; align-items:flex-start; gap:2px; min-width:0;">
+                <span style="font-size:12px; color:var(--text-secondary);">${escapeHtml(day?.date || 'unknown')}</span>
+                <span style="font-size:10px; color:var(--text-muted); white-space:nowrap; overflow:hidden; text-overflow:ellipsis; max-width:220px;">${levels || 'no levels'}</span>
+              </div>
+              <div class="shared-count">${formatNumber(operationCount(day?.total))}</div>
+            </div>
+          `;
+        }).join('');
+  }
 }
 
 function adherenceWindowToMs(window) {

package/dist/ui/assets/js/state.js

@@ -14,6 +14,12 @@ const state = {
   memoryUsefulness: null,
   retrievalTraces: null,
   retrievalReviewQueue: null,
+  operationsStats: null,
+  perspectiveStats: null,
+  vectorHealth: null,
+  vectorHealthRecovery: null,
+  vectorHealthRecoveryProject: null,
+  isVectorRecoveryRunning: false,
   adherenceSummary: null,
   adherenceWindow: '24h',
   userPromptSearchQuery: '',