helixevo 0.2.0 → 0.2.1

package/dashboard/app/network/page.tsx

@@ -0,0 +1,68 @@
+import { loadGraph, loadSkillContent, loadHistory, listProjects, getProjectSkills } from '@/lib/data'
+import NetworkClient from './client'
+
+export const dynamic = 'force-dynamic'
+
+export default function SkillNetworkPage() {
+  const graph = loadGraph()
+  const history = loadHistory()
+  const projects = listProjects()
+
+  const generalized = graph.nodes.filter(n =>
+    graph.edges.some(e => e.type === 'inherits' && e.from === n.id)
+  )
+  const evolved = graph.nodes.filter(n =>
+    n.generation > 0 && !generalized.some(g => g.id === n.id)
+  )
+  const original = graph.nodes.filter(n =>
+    n.generation === 0 && !generalized.some(g => g.id === n.id)
+  )
+
+  // Build evolution history per skill
+  const evolutionBySkill: Record<string, {
+    id: string; timestamp: string; action: string; description: string
+    outcome: string; outcomeReason: string; task: number; align: number; sideEffect: number
+  }[]> = {}
+  for (const iter of history.iterations) {
+    for (const p of iter.proposals) {
+      if (!evolutionBySkill[p.targetSkill]) evolutionBySkill[p.targetSkill] = []
+      evolutionBySkill[p.targetSkill].push({
+        id: p.id, timestamp: iter.timestamp, action: p.action,
+        description: p.description, outcome: p.outcome, outcomeReason: p.outcomeReason,
+        task: p.judges.taskCompletion.score, align: p.judges.correctionAlignment.score,
+        sideEffect: p.judges.sideEffectCheck.score,
+      })
+    }
+  }
+
+  // Load skill contents
+  const skillContents: Record<string, string> = {}
+  for (const n of graph.nodes) {
+    const raw = loadSkillContent(n.id)
+    if (raw) skillContents[n.id] = raw.match(/^---\n[\s\S]*?\n---\n([\s\S]*)$/)?.[1]?.trim() ?? raw
+  }
+
+  // Build project data
+  const projectData = projects.map(p => ({ name: p, ...getProjectSkills(p) }))
+
+  return (
+    <NetworkClient
+      allNodes={graph.nodes}
+      generalized={generalized}
+      evolved={evolved}
+      original={original}
+      edges={graph.edges}
+      evolutionBySkill={evolutionBySkill}
+      skillContents={skillContents}
+      projects={projectData}
+      stats={{
+        nodes: graph.nodes.length,
+        edges: graph.edges.length,
+        clusters: graph.clusters.length,
+        generalized: generalized.length,
+        evolved: evolved.length,
+        original: original.length,
+      }}
+    />
+  )
+}

package/dashboard/app/page.tsx

@@ -0,0 +1,147 @@
+import { getDashboardSummary, loadFrontier, loadHistory, loadGraph } from '@/lib/data'
+
+export const dynamic = 'force-dynamic'
+
+function StatCard({ value, label, color, sub, accent }: { value: string | number; label: string; color: string; sub?: string; accent?: string }) {
+  return (
+    <div className="stat-card">
+      <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'flex-start' }}>
+        <div>
+          <div className="stat-value" style={{ color }}>{value}</div>
+          <div className="stat-label">{label}</div>
+          {sub && <div style={{ fontSize: 10, color: 'var(--text-muted)', marginTop: 2 }}>{sub}</div>}
+        </div>
+        {accent && (
+          <div style={{
+            width: 36, height: 36, borderRadius: 10,
+            background: `${color}12`, display: 'flex', alignItems: 'center', justifyContent: 'center',
+            color, fontSize: 16,
+          }}>{accent}</div>
+        )}
+      </div>
+    </div>
+  )
+}
+
+export default function Overview() {
+  const s = getDashboardSummary()
+  const frontier = loadFrontier()
+  const history = loadHistory()
+  const graph = loadGraph()
+  const recent = history.iterations.slice(-5).reverse()
+
+  return (
+    <div>
+      <div className="page-header">
+        <h1 className="page-title">Dashboard</h1>
+        <p className="page-desc">
+          Overview of your self-evolving skill ecosystem
+        </p>
+      </div>
+
+      {/* Stats */}
+      <div className="grid-5" style={{ marginBottom: 28 }}>
+        <StatCard value={s.skills.total} label="Total Skills" color="var(--purple)" sub={`${s.skills.evolved} evolved`} accent="◆" />
+        <StatCard value={s.evolution.accepted} label="Accepted" color="var(--green)" sub={`${s.evolution.rejected} rejected`} accent="✓" />
+        <StatCard value={s.failures.unresolved} label="Unresolved" color="var(--yellow)" sub={`of ${s.failures.total} total`} accent="!" />
+        <StatCard value={s.buffer.discoveries} label="Discoveries" color="var(--blue)" sub={`${s.buffer.drafts} drafts`} accent="◎" />
+        <StatCard value={frontier.programs.length} label="Frontier" color="var(--text-secondary)" sub={`/${frontier.capacity} capacity`} accent="▲" />
+      </div>
+
+      <div className="grid-2">
+        {/* Frontier */}
+        <div className="card">
+          <div className="card-body">
+            <div className="card-header-label">Pareto Frontier</div>
+            {frontier.programs.map((p, i) => (
+              <div key={`${p.id}-${i}`} style={{
+                padding: '12px 0',
+                borderBottom: i < frontier.programs.length - 1 ? '1px solid var(--border-subtle)' : 'none',
+              }}>
+                <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center', marginBottom: 6 }}>
+                  <span style={{ fontSize: 13, fontWeight: 600 }}>{p.id}</span>
+                  <span style={{
+                    fontSize: 20, fontWeight: 800, lineHeight: 1,
+                    color: p.score >= 0.8 ? 'var(--green)' : 'var(--yellow)',
+                  }}>
+                    {(p.score * 100).toFixed(0)}
+                  </span>
+                </div>
+                <div style={{ display: 'flex', gap: 6, fontSize: 11 }}>
+                  <span className="score-pill" style={{ color: 'var(--green)' }}>T:{(p.scores.taskCompletion * 10).toFixed(0)}</span>
+                  <span className="score-pill" style={{ color: 'var(--blue)' }}>A:{(p.scores.correctionAlignment * 10).toFixed(0)}</span>
+                  <span className="score-pill" style={{ color: 'var(--purple)' }}>S:{(p.scores.sideEffectFree * 10).toFixed(0)}</span>
+                </div>
+                <div style={{ fontSize: 11, color: 'var(--text-dim)', marginTop: 4, lineHeight: 1.4 }}>
+                  {p.changesDescription.slice(0, 80)}
+                </div>
+              </div>
+            ))}
+          </div>
+        </div>
+
+        {/* Recent Evolution */}
+        <div className="card">
+          <div className="card-body">
+            <div className="card-header-label">Recent Evolution</div>
+            {recent.map(iter => (
+              <div key={iter.id} style={{
+                padding: '10px 0',
+                borderBottom: '1px solid var(--border-subtle)',
+              }}>
+                <div style={{ display: 'flex', justifyContent: 'space-between', fontSize: 11, marginBottom: 8 }}>
+                  <span style={{ fontWeight: 600, color: 'var(--text)' }}>{iter.id}</span>
+                  <span style={{ color: 'var(--text-muted)' }}>{new Date(iter.timestamp).toLocaleDateString()}</span>
+                </div>
+                {iter.proposals.map(p => (
+                  <div key={p.id} style={{
+                    display: 'flex', alignItems: 'center', gap: 8, fontSize: 12, marginBottom: 4,
+                    padding: '4px 0',
+                  }}>
+                    <span style={{
+                      width: 8, height: 8, borderRadius: '50%', flexShrink: 0,
+                      background: p.outcome === 'accepted' ? 'var(--green)' : 'var(--red)',
+                    }} />
+                    <span style={{ fontWeight: 500 }}>{p.targetSkill}</span>
+                    <span className="badge badge-gray" style={{ fontSize: 9 }}>{p.action}</span>
+                  </div>
+                ))}
+              </div>
+            ))}
+          </div>
+        </div>
+      </div>
+
+      {/* All Skills Summary */}
+      <div className="card" style={{ marginTop: 16 }}>
+        <div className="card-body">
+          <div className="card-header-label">All Skills</div>
+          <div className="grid-2" style={{ gap: 6 }}>
+            {graph.nodes.sort((a, b) => b.score - a.score).map(n => (
+              <div key={n.id} style={{
+                display: 'flex', alignItems: 'center', justifyContent: 'space-between',
+                padding: '8px 12px', borderRadius: 8, background: 'var(--bg-section)',
+              }}>
+                <div style={{ display: 'flex', alignItems: 'center', gap: 8, minWidth: 0 }}>
+                  <span style={{ fontSize: 13, fontWeight: 500, overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' }}>{n.name}</span>
+                  {n.generation > 0 && <span className="badge badge-green" style={{ fontSize: 9 }}>gen {n.generation}</span>}
+                </div>
+                <div style={{ display: 'flex', alignItems: 'center', gap: 6, minWidth: 90, flexShrink: 0 }}>
+                  <div className="score-track" style={{ width: 50 }}>
+                    <div className="score-fill" style={{
+                      width: `${n.score * 100}%`,
+                      background: n.score >= 0.8 ? 'var(--green)' : n.score >= 0.6 ? 'var(--yellow)' : 'var(--red)',
+                    }} />
+                  </div>
+                  <span style={{ fontSize: 12, fontWeight: 600, color: n.score >= 0.8 ? 'var(--green)' : 'var(--yellow)' }}>
+                    {(n.score * 100).toFixed(0)}
+                  </span>
+                </div>
+              </div>
+            ))}
+          </div>
+        </div>
+      </div>
+    </div>
+  )
+}

package/dashboard/app/research/page.tsx

@@ -0,0 +1,124 @@
+import { loadBuffer } from '@/lib/data'
+
+export const dynamic = 'force-dynamic'
+
+export default function ResearchPage() {
+  const buffer = loadBuffer()
+
+  return (
+    <div>
+      <div className="page-header">
+        <h1 className="page-title">Proactive Research</h1>
+        <p className="page-desc">
+          Web search discoveries and skill drafts from the knowledge buffer
+        </p>
+      </div>
+
+      {/* Summary Stats */}
+      <div className="grid-3" style={{ marginBottom: 28 }}>
+        <div className="stat-card">
+          <div className="stat-value" style={{ color: 'var(--blue)' }}>{buffer.discoveries.length}</div>
+          <div className="stat-label">Discoveries</div>
+          <div style={{ fontSize: 10, color: 'var(--text-muted)', marginTop: 2 }}>of 50 capacity</div>
+        </div>
+        <div className="stat-card">
+          <div className="stat-value" style={{ color: 'var(--yellow)' }}>{buffer.drafts.length}</div>
+          <div className="stat-label">Drafts</div>
+          <div style={{ fontSize: 10, color: 'var(--text-muted)', marginTop: 2 }}>of 10 capacity</div>
+        </div>
+        <div className="stat-card">
+          <div className="stat-value" style={{ color: 'var(--green)' }}>
+            {buffer.drafts.filter(d => d.passRate >= 0.67).length}
+          </div>
+          <div className="stat-label">Near-Pass Drafts</div>
+          <div style={{ fontSize: 10, color: 'var(--text-muted)', marginTop: 2 }}>≥67% pass rate</div>
+        </div>
+      </div>
+
+      <div className="grid-2">
+        {/* Discoveries */}
+        <div className="card">
+          <div className="card-body">
+            <div className="card-header-label">Discoveries ({buffer.discoveries.length}/50)</div>
+            {buffer.discoveries.length === 0 ? (
+              <div className="empty-state" style={{ padding: 32 }}>
+                <div className="empty-state-icon">
+                  <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.5">
+                    <path d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z" />
+                  </svg>
+                </div>
+                <div className="empty-state-title">No discoveries yet</div>
+                <div className="empty-state-desc">Run <code>helixevo research</code> to start proactive web research</div>
+              </div>
+            ) : (
+              buffer.discoveries.sort((a, b) => b.score - a.score).map(d => (
+                <div key={d.id} style={{
+                  padding: '12px 0',
+                  borderBottom: '1px solid var(--border-subtle)',
+                }}>
+                  <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'flex-start', marginBottom: 4 }}>
+                    <span style={{ fontSize: 13, fontWeight: 600, lineHeight: 1.3 }}>{d.title}</span>
+                    <span className="score-pill" style={{ color: 'var(--blue)', flexShrink: 0, marginLeft: 8 }}>
+                      {(d.score * 100).toFixed(0)}%
+                    </span>
+                  </div>
+                  <div style={{ fontSize: 11, color: 'var(--text-secondary)', lineHeight: 1.5, marginBottom: 6 }}>
+                    {d.summary.slice(0, 140)}
+                  </div>
+                  <span className="badge badge-blue">{d.gap}</span>
+                </div>
+              ))
+            )}
+          </div>
+        </div>
+
+        {/* Drafts */}
+        <div className="card">
+          <div className="card-body">
+            <div className="card-header-label">Drafts ({buffer.drafts.length}/10)</div>
+            {buffer.drafts.length === 0 ? (
+              <div className="empty-state" style={{ padding: 32 }}>
+                <div className="empty-state-icon">
+                  <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.5">
+                    <path d="M11 5H6a2 2 0 00-2 2v11a2 2 0 002 2h11a2 2 0 002-2v-5m-1.414-9.414a2 2 0 112.828 2.828L11.828 15H9v-2.828l8.586-8.586z" />
+                  </svg>
+                </div>
+                <div className="empty-state-title">No drafts yet</div>
+                <div className="empty-state-desc">Near-pass proposals are automatically saved here for future iteration</div>
+              </div>
+            ) : (
+              buffer.drafts.sort((a, b) => b.avgScore - a.avgScore).map(d => (
+                <div key={d.id} style={{
+                  padding: '12px 0',
+                  borderBottom: '1px solid var(--border-subtle)',
+                }}>
+                  <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'flex-start', marginBottom: 4 }}>
+                    <span style={{ fontSize: 13, fontWeight: 600 }}>{d.skillName}</span>
+                    <span className={`badge ${d.avgScore >= 6 ? 'badge-green' : 'badge-yellow'}`}>
+                      {d.avgScore.toFixed(1)}/10 · iter {d.iteration}
+                    </span>
+                  </div>
+                  <div style={{ fontSize: 11, color: 'var(--text-secondary)', lineHeight: 1.5, marginBottom: 6 }}>
+                    {d.hypothesis.slice(0, 140)}
+                  </div>
+                  <div style={{ display: 'flex', alignItems: 'center', gap: 8 }}>
+                    <span style={{ fontSize: 11, color: 'var(--text-dim)' }}>Pass rate:</span>
+                    <div className="score-track" style={{ width: 60, height: 4 }}>
+                      <div className="score-fill" style={{
+                        width: `${d.passRate * 100}%`,
+                        background: d.passRate >= 0.67 ? 'var(--green)' : 'var(--yellow)',
+                      }} />
+                    </div>
+                    <b style={{ fontSize: 11, color: d.passRate >= 0.67 ? 'var(--green)' : 'var(--yellow)' }}>
+                      {(d.passRate * 100).toFixed(0)}%
+                    </b>
+                  </div>
+                </div>
+              ))
+            )}
+          </div>
+        </div>
+      </div>
+    </div>
+  )
+}

package/dashboard/components/SkillFlowNode.tsx

@@ -0,0 +1,192 @@
+'use client'
+
+import { memo } from 'react'
+import { Handle, Position } from '@xyflow/react'
+
+interface SkillNodeData {
+  name: string
+  score: number
+  generation: number
+  category: 'generalized' | 'evolved' | 'original' | 'project'
+  layer: string
+  description: string
+  inheritsFrom: string[]
+  children: string[]
+  enhances: string[]
+  conflicts: string[]
+  evolutionSummary: string[]
+  tags: string[]
+}
+
+const CATEGORY_STYLES = {
+  generalized: {
+    border: '#c4b5fd',
+    bg: 'linear-gradient(180deg, #faf5ff 0%, #f5f0ff 100%)',
+    headerBg: '#ede9fe',
+    accent: '#7c3aed',
+    label: 'GENERALIZED',
+  },
+  evolved: {
+    border: '#86efac',
+    bg: 'linear-gradient(180deg, #f0fdf4 0%, #ecfdf5 100%)',
+    headerBg: '#dcfce7',
+    accent: '#16a34a',
+    label: 'EVOLVED',
+  },
+  original: {
+    border: '#d1d5db',
+    bg: 'linear-gradient(180deg, #fafafa 0%, #f5f5f5 100%)',
+    headerBg: '#f3f4f6',
+    accent: '#6b7280',
+    label: 'ORIGINAL',
+  },
+  project: {
+    border: '#fcd34d',
+    bg: 'linear-gradient(180deg, #fffbeb 0%, #fef3c7 100%)',
+    headerBg: '#fef3c7',
+    accent: '#b45309',
+    label: 'PROJECT',
+  },
+}
+
+function SkillFlowNode({ data }: { data: SkillNodeData }) {
+  const style = CATEGORY_STYLES[data.category]
+  const scorePercent = Math.round(data.score * 100)
+  const scoreColor = data.score >= 0.8 ? '#059669' : data.score >= 0.6 ? '#d97706' : '#dc2626'
+
+  return (
+    <div style={{
+      background: style.bg,
+      border: `1.5px solid ${style.border}`,
+      borderRadius: 14,
+      width: 280,
+      fontFamily: '-apple-system, BlinkMacSystemFont, SF Pro Display, system-ui, sans-serif',
+      boxShadow: '0 2px 8px rgba(0,0,0,0.06), 0 0px 1px rgba(0,0,0,0.04)',
+      overflow: 'hidden',
+      transition: 'box-shadow 0.2s ease',
+    }}>
+      <Handle type="target" position={Position.Top} style={{ background: style.border, width: 8, height: 8, border: '2px solid #fff' }} />
+      <Handle type="source" position={Position.Bottom} style={{ background: style.border, width: 8, height: 8, border: '2px solid #fff' }} />
+      <Handle type="target" position={Position.Left} id="left" style={{ background: style.border, width: 6, height: 6, border: '2px solid #fff' }} />
+      <Handle type="source" position={Position.Right} id="right" style={{ background: style.border, width: 6, height: 6, border: '2px solid #fff' }} />
+
+      {/* Header */}
+      <div style={{
+        padding: '10px 16px',
+        background: style.headerBg,
+        borderBottom: `1px solid ${style.border}40`,
+        display: 'flex',
+        justifyContent: 'space-between',
+        alignItems: 'flex-start',
+      }}>
+        <div style={{ flex: 1, minWidth: 0 }}>
+          <div style={{
+            fontSize: 9,
+            fontWeight: 700,
+            letterSpacing: 1.5,
+            color: style.accent,
+            textTransform: 'uppercase',
+            marginBottom: 3,
+          }}>
+            {style.label}
+          </div>
+          <div style={{
+            fontSize: 14,
+            fontWeight: 700,
+            color: '#1a1d2e',
+            lineHeight: 1.3,
+            overflow: 'hidden',
+            textOverflow: 'ellipsis',
+            whiteSpace: 'nowrap',
+          }}>
+            {data.name}
+          </div>
+        </div>
+        <div style={{
+          display: 'flex',
+          flexDirection: 'column',
+          alignItems: 'center',
+          marginLeft: 10,
+          flexShrink: 0,
+        }}>
+          <div style={{
+            fontSize: 20,
+            fontWeight: 800,
+            color: scoreColor,
+            lineHeight: 1,
+          }}>
+            {scorePercent}
+          </div>
+          <div style={{ fontSize: 8, color: '#9ca3af', marginTop: 1, fontWeight: 500 }}>SCORE</div>
+        </div>
+      </div>
+
+      {/* Body */}
+      <div style={{ padding: '10px 16px 12px' }}>
+        {/* Score Bar */}
+        <div style={{ display: 'flex', alignItems: 'center', gap: 8, marginBottom: 8 }}>
+          <div style={{ flex: 1, height: 4, background: '#e5e7eb', borderRadius: 2, overflow: 'hidden' }}>
+            <div style={{ width: `${scorePercent}%`, height: '100%', background: `linear-gradient(90deg, ${style.accent}80, ${scoreColor})`, borderRadius: 2, transition: 'width 0.5s ease' }} />
+          </div>
+          {data.generation > 0 && (
+            <span style={{
+              fontSize: 9, fontWeight: 700, padding: '1px 6px', borderRadius: 4,
+              background: '#dcfce7', color: '#059669',
+            }}>gen {data.generation}</span>
+          )}
+        </div>
+
+        {/* Evolution Summary or Description */}
+        {data.evolutionSummary.length > 0 ? (
+          <div style={{ marginBottom: 8 }}>
+            {data.evolutionSummary.slice(0, 2).map((s, i) => (
+              <div key={i} style={{
+                fontSize: 10, color: '#4b5563', lineHeight: 1.4, marginBottom: 3,
+                paddingLeft: 8, borderLeft: `2px solid ${style.accent}40`,
+              }}>
+                {s.slice(0, 70)}{s.length > 70 ? '...' : ''}
+              </div>
+            ))}
+          </div>
+        ) : data.description ? (
+          <div style={{ fontSize: 10, color: '#6b7280', lineHeight: 1.4, marginBottom: 8 }}>
+            {data.description.slice(0, 90)}{data.description.length > 90 ? '...' : ''}
+          </div>
+        ) : null}
+
+        {/* Connection Indicators */}
+        {(data.inheritsFrom.length > 0 || data.children.length > 0 || data.enhances.length > 0 || data.conflicts.length > 0) && (
+          <div style={{ display: 'flex', gap: 6, marginBottom: 6, flexWrap: 'wrap' }}>
+            {data.inheritsFrom.length > 0 && (
+              <span style={{ fontSize: 9, color: '#818cf8', fontWeight: 500 }}>↑ {data.inheritsFrom.length}</span>
+            )}
+            {data.children.length > 0 && (
+              <span style={{ fontSize: 9, color: '#818cf8', fontWeight: 500 }}>↓ {data.children.length}</span>
+            )}
+            {data.enhances.length > 0 && (
+              <span style={{ fontSize: 9, color: '#22c55e', fontWeight: 500 }}>↔ {data.enhances.length}</span>
+            )}
+            {data.conflicts.length > 0 && (
+              <span style={{ fontSize: 9, color: '#ef4444', fontWeight: 500 }}>⚡ {data.conflicts.length}</span>
+            )}
+          </div>
+        )}
+
+        {/* Tags */}
+        {data.tags.length > 0 && (
+          <div style={{ display: 'flex', gap: 3, flexWrap: 'wrap' }}>
+            {data.tags.slice(0, 4).map(t => (
+              <span key={t} style={{
+                fontSize: 9, padding: '1px 6px', borderRadius: 4,
+                background: `${style.accent}10`, color: style.accent, fontWeight: 500,
+                border: `1px solid ${style.accent}20`,
+              }}>{t}</span>
+            ))}
+          </div>
+        )}
+      </div>
+    </div>
+  )
+}
+
+export default memo(SkillFlowNode)

package/dashboard/lib/data.ts

@@ -0,0 +1,146 @@
+import { readFileSync, existsSync, readdirSync } from 'fs'
+import { join } from 'path'
+import { homedir } from 'os'
+
+const SG_DIR = join(homedir(), '.helix')
+
+function readJson<T>(filename: string, fallback: T): T {
+  const path = join(SG_DIR, filename)
+  if (!existsSync(path)) return fallback
+  return JSON.parse(readFileSync(path, 'utf-8'))
+}
+
+function readJsonl<T>(filename: string): T[] {
+  const path = join(SG_DIR, filename)
+  if (!existsSync(path)) return []
+  return readFileSync(path, 'utf-8').trim().split('\n').filter(Boolean).map(l => JSON.parse(l))
+}
+
+// ─── Types ──────────────────────────────────────────────────────
+
+export interface SkillNode {
+  id: string; name: string; layer: string; score: number
+  generation: number; status: string; tags: string[]
+  failureCount: number; lastEvolved: string; project?: string
+}
+
+export interface SkillEdge {
+  from: string; to: string
+  type: 'inherits' | 'depends' | 'enhances' | 'conflicts' | 'co-evolves'
+  strength: number; detectedBy: string
+}
+
+export interface SkillGraph {
+  updated: string; nodes: SkillNode[]; edges: SkillEdge[]
+  clusters: { id: string; name: string; skills: string[]; cohesion: number }[]
+}
+
+export interface Failure {
+  id: string; sessionId: string; timestamp: string; project: string | null
+  userRequest: string; agentAction: string; correction: string
+  correctionType: string; skillsActive: string[]; resolved?: boolean
+}
+
+export interface Frontier {
+  capacity: number; programs: {
+    id: string; generation: number; score: number
+    scores: { taskCompletion: number; correctionAlignment: number; sideEffectFree: number }
+    changesDescription: string; createdAt: string
+  }[]
+}
+
+export interface Proposal {
+  id: string; targetSkill: string; action: string; description: string
+  judges: { taskCompletion: { score: number }; correctionAlignment: { score: number }; sideEffectCheck: { score: number } }
+  consensus: boolean; outcome: string; outcomeReason: string
+  regressionResult: { total: number; passed: number; passRate: number }
+}
+
+export interface Iteration {
+  id: string; timestamp: string; trigger: string; failureCount: number
+  proposals: Proposal[]
+  failureClusters: { type: string; count: number }[]
+}
+
+export interface KnowledgeBuffer {
+  discoveries: { id: string; title: string; summary: string; score: number; gap: string; lastAccessed: string }[]
+  drafts: { id: string; skillName: string; avgScore: number; passRate: number; iteration: number; hypothesis: string }[]
+}
+
+export interface CanaryEntry {
+  skillSlug: string; version: string; deployedAt: string; expiresAt: string
+}
+
+// ─── Loaders ────────────────────────────────────────────────────
+
+export function loadGraph(): SkillGraph {
+  return readJson<SkillGraph>('skill-graph.json', { updated: '', nodes: [], edges: [], clusters: [] })
+}
+
+export function loadFailures(): Failure[] {
+  return readJsonl<Failure>('failures.jsonl')
+}
+
+export function loadFrontier(): Frontier {
+  return readJson<Frontier>('frontier.json', { capacity: 5, programs: [] })
+}
+
+export function loadHistory(): { iterations: Iteration[] } {
+  return readJson<{ iterations: Iteration[] }>('evolution-history.json', { iterations: [] })
+}
+
+export function loadGoldenCases(): { id: string; skill: string; input: string }[] {
+  return readJsonl('golden-cases.jsonl')
+}
+
+export function loadBuffer(): KnowledgeBuffer {
+  return readJson<KnowledgeBuffer>('knowledge-buffer.json', { discoveries: [], drafts: [] })
+}
+
+export function loadCanaries(): { entries: CanaryEntry[] } {
+  return readJson<{ entries: CanaryEntry[] }>('canary-registry.json', { entries: [] })
+}
+
+export function loadSkillContent(slug: string): string {
+  const path = join(SG_DIR, 'general', slug, 'SKILL.md')
+  if (!existsSync(path)) return ''
+  return readFileSync(path, 'utf-8')
+}
+
+export function listProjects(): string[] {
+  const failures = loadFailures()
+  const projects = [...new Set(failures.map(f => f.project).filter(Boolean))] as string[]
+  return projects
+}
+
+export function getProjectSkills(project: string): { failures: Failure[]; skills: string[] } {
+  const failures = loadFailures().filter(f => f.project === project)
+  const skills = [...new Set(failures.flatMap(f => f.skillsActive))]
+  return { failures, skills }
+}
+
+export function getDashboardSummary() {
+  const graph = loadGraph()
+  const failures = loadFailures()
+  const frontier = loadFrontier()
+  const history = loadHistory()
+  const buffer = loadBuffer()
+  const canaries = loadCanaries()
+  const goldenCases = loadGoldenCases()
+
+  const evolved = graph.nodes.filter(n => n.generation > 0)
+  const totalProposals = history.iterations.flatMap(i => i.proposals)
+  const accepted = totalProposals.filter(p => p.outcome === 'accepted')
+  const rejected = totalProposals.filter(p => p.outcome === 'rejected')
+
+  return {
+    skills: { total: graph.nodes.length, evolved: evolved.length, original: graph.nodes.length - evolved.length },
+    graph: { nodes: graph.nodes.length, edges: graph.edges.length, clusters: graph.clusters.length },
+    failures: { total: failures.length, unresolved: failures.filter(f => !f.resolved).length },
+    frontier: { size: frontier.programs.length, capacity: frontier.capacity, topScore: frontier.programs[0]?.score ?? 0 },
+    evolution: { runs: history.iterations.length, accepted: accepted.length, rejected: rejected.length },
+    buffer: { discoveries: buffer.discoveries.length, drafts: buffer.drafts.length },
+    canaries: canaries.entries.length,
+    goldenCases: goldenCases.length,
+  }
+}