helixevo 0.2.7 → 0.2.9

package/README.md

@@ -12,7 +12,7 @@ HelixEvo builds on ideas from [EvoSkill](https://arxiv.org/abs/2603.02766) and [
 
 Every proposed change goes through:
 1. **3 independent LLM judges** (Task Completion, Correction Alignment, Side-Effect Check)
-2. **Regression testing** against golden cases
+2. **Regression testing** against skill tests
 3. **3-day canary deployment** with auto-rollback
 
 ## Prerequisites
@@ -57,7 +57,7 @@ npm link
 ## Quick Start
 
 ```bash
-# 1. Initialize — imports existing skills + generates golden cases
+# 1. Initialize — imports existing skills + generates skill tests
 helixevo init
 
 # 2. Capture failures from a session
@@ -80,7 +80,7 @@ helixevo dashboard
 | `helixevo watch` | Always-on learning: auto-capture + auto-evolve |
 | `helixevo metrics` | Correction rates, skill trends, evolution impact |
 | `helixevo health` | Network health: cohesion, coverage, balance, transfer |
-| `helixevo init` | Import existing skills + generate golden cases |
+| `helixevo init` | Import existing skills + generate skill tests |
 | `helixevo capture <session>` | Extract failures from a session file |
 | `helixevo evolve` | Evolve skills from captured failures |
 | `helixevo generalize` | Promote cross-project patterns ↑ |
@@ -126,7 +126,7 @@ All data is stored in `~/.helix/`:
 ├── failures.jsonl           # Captured failures
 ├── frontier.json            # Pareto frontier (top-k configurations)
 ├── evolution-history.json   # All evolution runs + proposals
-├── golden-cases.jsonl       # Regression test cases
+├── skill-tests.jsonl       # Regression test cases
 ├── skill-graph.json         # Cached network (nodes + edges)
 ├── canary-registry.json     # Active canary deployments
 ├── knowledge-buffer.json    # Research discoveries + drafts

package/dashboard/app/api/skills/route.ts

@@ -122,7 +122,7 @@ function analyzeNetworkAdaptation(
       })
       result.suggestions.push({
         type: 'rewire',
-        description: `Review golden cases for [${partners.join(', ')}] after this change`
+        description: `Review skill tests for [${partners.join(', ')}] after this change`
       })
     }
   }

package/dashboard/app/guide/page.tsx

@@ -1,6 +1,7 @@
 'use client'
 
 import { useState, useEffect, useRef } from 'react'
+import { VERSION } from '../../lib/version'
 
 // ─── Table of Contents ──────────────────────────────────────────
 const TOC = [
@@ -148,7 +149,7 @@ function ArchitectureDiagram() {
         <div className="guide-diagram-box guide-diagram-check" style={{ direction: 'ltr' }}>
           <div className="guide-diagram-box-label">Validate</div>
           <div className="guide-diagram-box-title">Regression Tests</div>
-          <div className="guide-diagram-box-desc">Golden cases + cross-skill</div>
+          <div className="guide-diagram-box-desc">Skill tests + cross-skill</div>
         </div>
         <div className="guide-diagram-arrow" style={{ direction: 'ltr' }}>←</div>
         <div className="guide-diagram-box guide-diagram-judge" style={{ direction: 'ltr' }}>
@@ -226,7 +227,7 @@ export default function GuidePage() {
       <nav className="guide-toc">
         <div className="guide-toc-header">
           <div className="guide-toc-title">Documentation</div>
-          <div className="guide-toc-version">v0.2.6</div>
+          <div className="guide-toc-version">v{VERSION}</div>
         </div>
         {TOC.map(item => (
           <a
@@ -317,7 +318,7 @@ cd helixevo && npm install && npm run build && npm link`}</Code>
             <Code title="Terminal">{`helixevo init`}</Code>
             <p className="guide-text-sm">
               This scans your existing SKILL.md files (from <code>~/.agents/skills/</code>), imports them into HelixEvo,
-              and generates golden test cases for each skill. It also creates the data directory at <code>~/.helix/</code>.
+              and generates skill tests for each skill. It also creates the data directory at <code>~/.helix/</code>.
             </p>
           </Step>
 
@@ -370,7 +371,7 @@ helixevo status`}</Code>
               },
               {
                 cmd: 'helixevo init',
-                desc: 'Import existing skills and generate golden test cases. Scans ~/.agents/skills/ and creates the HelixEvo data directory.',
+                desc: 'Import existing skills and generate skill tests. Scans ~/.agents/skills/ and creates the HelixEvo data directory.',
                 flags: ['--verbose'],
               },
               {
@@ -545,7 +546,7 @@ Project B: "Use FlashList not FlatList" (React Native perf)
   → Abstract skill created: "react-native-performance" (domain layer)
   → Project A skill inherits from it
   → Project B skill inherits from it
-  → Domain skill tested against all golden cases
+  → Domain skill tested against all skill tests
   → Deployed if regression passes`}</Code>
           <Callout type="tip">
             Auto-generalization is the key to the <strong>double helix</strong> metaphor: as projects evolve, skills
@@ -601,7 +602,7 @@ Project B: "Use FlashList not FlatList" (React Native perf)
             <div className="guide-pipeline-connector" />
             <PipelineStep
               icon="5" title="Regression Testing" color="var(--red)"
-              desc="The modified skill is tested against all golden cases for that skill AND co-evolved partner skills. Must maintain ≥95% pass rate."
+              desc="The modified skill is tested against all skill tests for that skill AND co-evolved partner skills. Must maintain ≥95% pass rate."
             />
             <div className="guide-pipeline-connector" />
             <PipelineStep
@@ -693,29 +694,29 @@ Project B: "Use FlashList not FlatList" (React Native perf)
         </Section>
 
         {/* ─── Regression Testing ─── */}
-        <Section id="regression" title="Regression Testing" subtitle="Golden cases and cross-skill validation ensure quality.">
-          <h3 className="guide-h3">Golden Cases</h3>
+        <Section id="regression" title="Regression Testing" subtitle="Skill tests and cross-skill validation ensure quality.">
+          <h3 className="guide-h3">Skill Tests</h3>
           <p className="guide-text">
-            Golden cases are regression test scenarios tied to specific skills. They&apos;re created when:
+            Skill tests are regression test scenarios tied to specific skills. They&apos;re created when:
           </p>
           <ul className="guide-list">
             <li><strong>Init:</strong> Automatically generated from existing SKILL.md files during <code>helixevo init</code></li>
-            <li><strong>Evolution:</strong> When a failure is resolved, the scenario is promoted to a golden case</li>
+            <li><strong>Evolution:</strong> When a failure is resolved, the scenario is promoted to a skill test</li>
           </ul>
           <p className="guide-text">
-            Each golden case stores the input, context, and expected behavior. During regression testing,
+            Each skill test stores the input, context, and expected behavior. During regression testing,
             an LLM judge evaluates whether the modified skill would still handle each scenario correctly.
           </p>
 
           <h3 className="guide-h3">Cross-Skill Regression</h3>
           <p className="guide-text">
-            When skill A is modified, HelixEvo also tests golden cases from co-evolved, dependent, and enhancing
+            When skill A is modified, HelixEvo also tests skill tests from co-evolved, dependent, and enhancing
             partner skills. This catches silent incompatibilities where changing one skill breaks a related skill&apos;s behavior.
           </p>
           <Code title="How it works">{`Skill A evolves
   → Load skill graph edges
   → Find partners (co-evolves, depends, enhances)
-  → Test partner golden cases against Skill A's changes
+  → Test partner skill tests against Skill A's changes
   → Block if partner pass rate < 95%`}</Code>
         </Section>
 
@@ -796,10 +797,10 @@ generation: 3
           <div className="guide-params">
             <Param name="quality.judgePassScore" type="number" desc="Minimum judge score to pass (1-10)." def="7" />
             <Param name="quality.judgeConsensusMin" type="number" desc="Minimum judges that must pass." def="2" />
-            <Param name="quality.regressionPassRate" type="number" desc="Minimum golden case pass rate (0-1)." def="0.95" />
+            <Param name="quality.regressionPassRate" type="number" desc="Minimum skill test pass rate (0-1)." def="0.95" />
             <Param name="quality.canaryDurationDays" type="number" desc="Days to monitor canary deployments." def="3" />
             <Param name="quality.autoRollbackThreshold" type="number" desc="Failure rate multiplier triggering rollback." def="1.5" />
-            <Param name="quality.maxGoldenCases" type="number" desc="Maximum golden cases per skill." def="50" />
+            <Param name="quality.maxSkillTests" type="number" desc="Maximum skill tests per skill." def="50" />
           </div>
 
           <Code title="~/.helix/config.json">{`{
@@ -819,7 +820,7 @@ generation: 3
     "regressionPassRate": 0.95,
     "canaryDurationDays": 3,
     "autoRollbackThreshold": 1.5,
-    "maxGoldenCases": 50
+    "maxSkillTests": 50
   }
 }`}</Code>
         </Section>
@@ -831,7 +832,7 @@ generation: 3
 ├── failures.jsonl           # Captured failure records (append-only)
 ├── frontier.json            # Pareto frontier (top-K programs)
 ├── evolution-history.json   # All evolution iterations + proposals
-├── golden-cases.jsonl       # Regression test cases (append-only)
+├── skill-tests.jsonl       # Regression test cases (append-only)
 ├── skill-graph.json         # Cached network (nodes + edges)
 ├── canary-registry.json     # Active canary deployments
 ├── knowledge-buffer.json    # Research discoveries + drafts
@@ -858,7 +859,7 @@ generation: 3
 }`}</Code>
             </div>
             <div className="guide-data-card">
-              <div className="guide-data-title">Golden Case</div>
+              <div className="guide-data-title">Skill Test</div>
               <Code>{`{
   "id": "gc_react_42",
   "skill": "react-patterns",
@@ -949,7 +950,7 @@ generation: 3
           </FAQItem>
           <FAQItem q="How does cross-skill regression work?">
             When Skill A evolves, HelixEvo checks the skill graph for co-evolved, dependent, and enhancing
-            partners. It tests their golden cases against Skill A&apos;s changes. If partner pass rate drops below 95%,
+            partners. It tests their skill tests against Skill A&apos;s changes. If partner pass rate drops below 95%,
             the proposal is rejected.
           </FAQItem>
           <FAQItem q="How does the knowledge buffer work?">
@@ -982,7 +983,7 @@ generation: 3
         {/* Footer */}
         <div className="guide-footer">
           <div className="guide-footer-content">
-            <div style={{ fontSize: 13, fontWeight: 600 }}>HelixEvo v0.2.6</div>
+            <div style={{ fontSize: 13, fontWeight: 600 }}>HelixEvo v{VERSION}</div>
             <div style={{ fontSize: 12, color: 'var(--text-dim)', marginTop: 4 }}>
               Self-evolving skill ecosystem for AI agents · MIT License
             </div>

package/dashboard/app/layout.tsx

@@ -1,6 +1,8 @@
 import './globals.css'
 import type { Metadata } from 'next'
 import Link from 'next/link'
+import { VERSION } from '../lib/version'
+import { UpdateBanner } from '../components/update-banner'
 
 export const metadata: Metadata = {
   title: 'HelixEvo',
@@ -64,7 +66,7 @@ export default function RootLayout({ children }: { children: React.ReactNode })
                 <div style={{ width: 6, height: 6, borderRadius: '50%', background: 'var(--green)' }} />
                 <span>System Active</span>
               </div>
-              <code style={{ fontSize: 10, background: 'var(--bg-section)', padding: '2px 6px', borderRadius: 4 }}>v0.2.0</code>
+              <code style={{ fontSize: 10, background: 'var(--bg-section)', padding: '2px 6px', borderRadius: 4 }}>v{VERSION}</code>
             </div>
           </nav>
 
@@ -73,6 +75,7 @@ export default function RootLayout({ children }: { children: React.ReactNode })
             {children}
           </main>
         </div>
+        <UpdateBanner currentVersion={VERSION} />
       </body>
     </html>
   )

package/dashboard/components/update-banner.tsx

@@ -0,0 +1,149 @@
+'use client'
+
+import { useState, useEffect } from 'react'
+
+const REGISTRY_URL = 'https://registry.npmjs.org/helixevo/latest'
+const CHECK_INTERVAL_MS = 60 * 60 * 1000 // re-check every hour
+
+function compareVersions(current: string, latest: string): boolean {
+  const c = current.split('.').map(Number)
+  const l = latest.split('.').map(Number)
+  for (let i = 0; i < 3; i++) {
+    if ((l[i] ?? 0) > (c[i] ?? 0)) return true
+    if ((l[i] ?? 0) < (c[i] ?? 0)) return false
+  }
+  return false
+}
+
+export function UpdateBanner({ currentVersion }: { currentVersion: string }) {
+  const [latestVersion, setLatestVersion] = useState<string | null>(null)
+  const [dismissed, setDismissed] = useState(false)
+  const [copied, setCopied] = useState(false)
+
+  useEffect(() => {
+    let mounted = true
+
+    async function check() {
+      try {
+        const res = await fetch(REGISTRY_URL)
+        if (!res.ok) return
+        const data = await res.json()
+        if (mounted && data.version && compareVersions(currentVersion, data.version)) {
+          setLatestVersion(data.version)
+        }
+      } catch {}
+    }
+
+    check()
+    const interval = setInterval(check, CHECK_INTERVAL_MS)
+    return () => { mounted = false; clearInterval(interval) }
+  }, [currentVersion])
+
+  if (!latestVersion || dismissed) return null
+
+  const command = 'npm install -g helixevo@latest'
+
+  const handleCopy = async () => {
+    try {
+      await navigator.clipboard.writeText(command)
+      setCopied(true)
+      setTimeout(() => setCopied(false), 2000)
+    } catch {}
+  }
+
+  return (
+    <div style={{
+      position: 'fixed',
+      bottom: 20,
+      right: 20,
+      width: 320,
+      background: 'var(--bg-card)',
+      border: '1px solid var(--purple-border)',
+      borderRadius: 'var(--radius-lg)',
+      boxShadow: 'var(--shadow-xl)',
+      padding: '16px 18px',
+      zIndex: 9999,
+      animation: 'updateSlideIn 0.4s ease-out',
+    }}>
+      {/* Close button */}
+      <button
+        onClick={() => setDismissed(true)}
+        style={{
+          position: 'absolute', top: 8, right: 10,
+          background: 'none', border: 'none', cursor: 'pointer',
+          color: 'var(--text-dim)', fontSize: 18, lineHeight: 1,
+          padding: '2px 4px',
+        }}
+        aria-label="Dismiss"
+      >
+        &times;
+      </button>
+
+      {/* Header */}
+      <div style={{ display: 'flex', alignItems: 'center', gap: 8, marginBottom: 10 }}>
+        <div style={{
+          width: 28, height: 28, borderRadius: '50%',
+          background: 'var(--purple-light)', display: 'flex',
+          alignItems: 'center', justifyContent: 'center',
+        }}>
+          <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="var(--purple)" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round">
+            <path d="M12 19V5m-7 7l7-7 7 7" />
+          </svg>
+        </div>
+        <div>
+          <div style={{ fontSize: 13, fontWeight: 700, color: 'var(--text)', letterSpacing: -0.2 }}>
+            Update Available
+          </div>
+          <div style={{ fontSize: 11, color: 'var(--text-dim)' }}>
+            v{currentVersion} &rarr; <span style={{ color: 'var(--green)', fontWeight: 600 }}>v{latestVersion}</span>
+          </div>
+        </div>
+      </div>
+
+      {/* Command */}
+      <div
+        onClick={handleCopy}
+        style={{
+          background: 'var(--bg-section)',
+          border: '1px solid var(--border)',
+          borderRadius: 'var(--radius)',
+          padding: '8px 12px',
+          fontFamily: 'var(--font-mono)',
+          fontSize: 11,
+          color: 'var(--text-secondary)',
+          cursor: 'pointer',
+          display: 'flex',
+          alignItems: 'center',
+          justifyContent: 'space-between',
+          gap: 8,
+          transition: 'border-color 0.15s',
+        }}
+        title="Click to copy"
+      >
+        <span style={{ overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' }}>
+          $ {command}
+        </span>
+        <span style={{
+          fontSize: 10, fontFamily: 'var(--font)', fontWeight: 600,
+          color: copied ? 'var(--green)' : 'var(--purple)',
+          whiteSpace: 'nowrap',
+          flexShrink: 0,
+        }}>
+          {copied ? 'Copied!' : 'Copy'}
+        </span>
+      </div>
+
+      {/* Subtle hint */}
+      <div style={{ fontSize: 10, color: 'var(--text-muted)', marginTop: 8, textAlign: 'center' }}>
+        Run in terminal, then refresh dashboard
+      </div>
+
+      <style>{`
+        @keyframes updateSlideIn {
+          from { opacity: 0; transform: translateY(16px) scale(0.97); }
+          to { opacity: 1; transform: translateY(0) scale(1); }
+        }
+      `}</style>
+    </div>
+  )
+}

package/dashboard/lib/data.ts

@@ -89,7 +89,9 @@ export function loadHistory(): { iterations: Iteration[] } {
   return readJson<{ iterations: Iteration[] }>('evolution-history.json', { iterations: [] })
 }
 
-export function loadGoldenCases(): { id: string; skill: string; input: string }[] {
+export function loadSkillTests(): { id: string; skill: string; input: string }[] {
+  const newFile = readJsonl('skill-tests.jsonl')
+  if (newFile.length > 0) return newFile
   return readJsonl('golden-cases.jsonl')
 }
 
@@ -126,7 +128,7 @@ export function getDashboardSummary() {
   const history = loadHistory()
   const buffer = loadBuffer()
   const canaries = loadCanaries()
-  const goldenCases = loadGoldenCases()
+  const skillTests = loadSkillTests()
 
   const evolved = graph.nodes.filter(n => n.generation > 0)
   const totalProposals = history.iterations.flatMap(i => i.proposals)
@@ -141,6 +143,6 @@ export function getDashboardSummary() {
     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,
+    skillTests: skillTests.length,
   }
 }

package/dashboard/lib/version.ts

@@ -0,0 +1 @@
+export const VERSION = process.env.HELIXEVO_VERSION ?? '0.0.0'

package/dashboard/next.config.mjs

@@ -0,0 +1,28 @@
+import { readFileSync } from 'fs'
+import { join, dirname } from 'path'
+import { fileURLToPath } from 'url'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+
+function getVersion() {
+  const candidates = [
+    join(__dirname, '..', 'package.json'),   // dev: repo root
+    join(__dirname, 'package.json'),          // fallback
+  ]
+  for (const p of candidates) {
+    try {
+      const pkg = JSON.parse(readFileSync(p, 'utf-8'))
+      if (pkg.name === 'helixevo' && pkg.version) return pkg.version
+    } catch {}
+  }
+  return '0.0.0'
+}
+
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  env: {
+    HELIXEVO_VERSION: getVersion(),
+  },
+}
+
+export default nextConfig

package/dist/cli.js

@@ -2129,7 +2129,7 @@ var init_config = __esm(() => {
       regressionPassRate: 0.95,
       canaryDurationDays: 3,
       autoRollbackThreshold: 1.5,
-      maxGoldenCases: 50
+      maxSkillTests: 50
     },
     reporting: {
       schedule: "0 8 * * *",
@@ -9226,11 +9226,14 @@ function loadHistory() {
 function saveHistory(history) {
   writeJson("evolution-history.json", history);
 }
-function loadGoldenCases() {
+function loadSkillTests() {
+  const newFile = readJsonl("skill-tests.jsonl");
+  if (newFile.length > 0)
+    return newFile;
   return readJsonl("golden-cases.jsonl");
 }
-function appendGoldenCase(gc) {
-  appendJsonl("golden-cases.jsonl", gc);
+function appendSkillTest(gc) {
+  appendJsonl("skill-tests.jsonl", gc);
 }
 function loadSkillGraph() {
   return readJson("skill-graph.json", {
@@ -9573,12 +9576,12 @@ init_config();
 init_skills();
 init_data();
 init_llm();
-import { join as join3 } from "node:path";
+import { join as join4 } from "node:path";
 import { homedir as homedir2 } from "node:os";
 import { existsSync as existsSync4, cpSync } from "node:fs";
 
-// src/prompts/golden-gen.ts
-function buildGoldenGenPrompt(skill) {
+// src/prompts/test-gen.ts
+function buildTestGenPrompt(skill) {
   return `Read this skill and generate 3 typical usage scenarios where the skill should guide correct behavior.
 
 ## Skill: ${skill.meta.name}
@@ -9602,21 +9605,29 @@ Return JSON:
 - Expected behavior should be concrete enough to verify against`;
 }
 
+// src/version.ts
+import { createRequire as createRequire2 } from "node:module";
+import { join as join3, dirname as dirname2 } from "node:path";
+import { fileURLToPath } from "node:url";
+var require2 = createRequire2(import.meta.url);
+var pkg = require2(join3(dirname2(fileURLToPath(import.meta.url)), "..", "package.json"));
+var VERSION = pkg.version;
+
 // src/commands/init.ts
 async function initCommand(options) {
-  console.log(`\uD83E\uDDEC Initializing HelixEvo...
+  console.log(`\uD83E\uDDEC Initializing HelixEvo v${VERSION}...
 `);
   const sgDir = getHelixDir();
   const generalDir = getGeneralSkillsPath();
   ensureDir(sgDir);
   ensureDir(generalDir);
-  if (!existsSync4(join3(sgDir, "config.json"))) {
+  if (!existsSync4(join4(sgDir, "config.json"))) {
     saveConfig(DEFAULT_CONFIG);
     console.log("  ✓ Created config.json");
   }
   const defaultPaths = [
-    join3(homedir2(), ".agents", "skills"),
-    join3(homedir2(), ".craft-agent", "workspaces")
+    join4(homedir2(), ".agents", "skills"),
+    join4(homedir2(), ".craft-agent", "workspaces")
   ];
   const scanPaths = options.skillsPaths ?? defaultPaths;
   const expandedPaths = [];
@@ -9625,7 +9636,7 @@ async function initCommand(options) {
       const { readdirSync: readdirSync2 } = await import("node:fs");
       const workspaces = readdirSync2(p, { withFileTypes: true }).filter((d) => d.isDirectory() && !d.name.startsWith("."));
       for (const ws of workspaces) {
-        const skillsDir = join3(p, ws.name, "skills");
+        const skillsDir = join4(p, ws.name, "skills");
         if (existsSync4(skillsDir))
           expandedPaths.push(skillsDir);
       }
@@ -9638,7 +9649,7 @@ async function initCommand(options) {
 `);
   let imported = 0;
   for (const skill of existingSkills) {
-    const targetDir = join3(generalDir, skill.slug);
+    const targetDir = join4(generalDir, skill.slug);
     if (existsSync4(targetDir)) {
       console.log(`    → ${skill.slug}: already exists, skipping`);
       continue;
@@ -9650,13 +9661,37 @@ async function initCommand(options) {
   console.log(`
   Imported ${imported} new skills
 `);
-  if (!options.skipGolden) {
+  const allSkills = loadAllGeneralSkills();
+  if (allSkills.length > 0) {
+    const nodes = allSkills.map((s) => ({
+      id: s.slug,
+      name: s.slug,
+      layer: "system",
+      score: 0.7,
+      generation: 0,
+      status: "active",
+      tags: [],
+      failureCount: 0,
+      lastEvolved: new Date().toISOString()
+    }));
+    const graph = {
+      updated: new Date().toISOString(),
+      nodes,
+      edges: [],
+      clusters: []
+    };
+    saveSkillGraph(graph);
+    console.log(`  ✓ Generated skill graph (${nodes.length} nodes)`);
+    console.log(`    Run "helixevo graph --rebuild" later for full relationship inference
+`);
+  }
+  if (!options.skipTests) {
     const generalSkills = loadAllGeneralSkills();
-    console.log(`  Generating golden cases...
+    console.log(`  Generating skill tests...
 `);
     for (const skill of generalSkills) {
       try {
-        const prompt = buildGoldenGenPrompt(skill);
+        const prompt = buildTestGenPrompt(skill);
         const output = await chatJson({ prompt });
         for (const c of output.cases) {
           const gc = {
@@ -9671,11 +9706,11 @@ async function initCommand(options) {
             lastResult: "pass",
             consecutivePasses: 1
           };
-          appendGoldenCase(gc);
+          appendSkillTest(gc);
         }
-        console.log(`    ✓ ${skill.slug}: ${output.cases.length} golden cases`);
+        console.log(`    ✓ ${skill.slug}: ${output.cases.length} skill tests`);
       } catch (err) {
-        console.log(`    ✗ ${skill.slug}: failed to generate golden cases (${err})`);
+        console.log(`    ✗ ${skill.slug}: failed to generate skill tests (${err})`);
       }
     }
   }
@@ -9770,7 +9805,7 @@ init_config();
 init_data();
 init_skills();
 init_llm();
-import { join as join6 } from "node:path";
+import { join as join7 } from "node:path";
 
 // src/prompts/cluster.ts
 function buildClusterPrompt(failures, skills) {
@@ -9989,11 +10024,11 @@ init_config();
 init_llm();
 async function runRegression(skillSlug, newSkillContent, verbose = false) {
   const config = loadConfig();
-  const allCases = loadGoldenCases();
+  const allCases = loadSkillTests();
   const cases = allCases.filter((gc) => gc.skill === skillSlug);
   if (cases.length === 0) {
     if (verbose)
-      console.log(`    No golden cases for ${skillSlug}, skipping regression`);
+      console.log(`    No skill tests for ${skillSlug}, skipping regression`);
     return { total: 0, passed: 0, passRate: 1, failures: [] };
   }
   const failures = [];
@@ -10020,7 +10055,7 @@ async function runRegression(skillSlug, newSkillContent, verbose = false) {
     failures
   };
 }
-function promoteToGoldenCase(failure, skillSlug, replayResult) {
+function promoteToSkillTest(failure, skillSlug, replayResult) {
   const gc = {
     id: `gc_${skillSlug}_${Date.now() % 1e5}`,
     addedAt: new Date().toISOString(),
@@ -10033,7 +10068,7 @@ function promoteToGoldenCase(failure, skillSlug, replayResult) {
     lastResult: "pass",
     consecutivePasses: 1
   };
-  appendGoldenCase(gc);
+  appendSkillTest(gc);
 }
 function buildRegressionJudgePrompt(gc, skillContent) {
   return `You are a regression test judge. Determine if a modified skill can still handle this scenario correctly.
@@ -10072,7 +10107,7 @@ async function runCrossSkillRegression(skillSlug, newSkillContent, verbose = fal
     return { total: 0, passed: 0, passRate: 1, testedSkills: [] };
   }
   const config = loadConfig();
-  const allCases = loadGoldenCases();
+  const allCases = loadSkillTests();
   const partnerCases = allCases.filter((gc) => partners.includes(gc.skill));
   if (partnerCases.length === 0) {
     return { total: 0, passed: 0, passRate: 1, testedSkills: partners };
@@ -10120,11 +10155,11 @@ Return JSON: { "score": <number>, "reason": "<one sentence>" }`;
 // src/core/canary.ts
 init_config();
 import { readFileSync as readFileSync5, writeFileSync as writeFileSync4, existsSync as existsSync6, cpSync as cpSync2, rmSync } from "node:fs";
-import { join as join4 } from "node:path";
-var CANARY_DIR = join4(getHelixDir(), "canary");
-var BACKUPS_DIR = join4(getHelixDir(), "backups");
+import { join as join5 } from "node:path";
+var CANARY_DIR = join5(getHelixDir(), "canary");
+var BACKUPS_DIR = join5(getHelixDir(), "backups");
 function getRegistryPath() {
-  return join4(getHelixDir(), "canary-registry.json");
+  return join5(getHelixDir(), "canary-registry.json");
 }
 function loadRegistry() {
   const path = getRegistryPath();
@@ -10137,7 +10172,7 @@ function saveRegistry(registry) {
 }
 function backupSkill(skillPath, slug, version) {
   ensureDir(BACKUPS_DIR);
-  const backupPath = join4(BACKUPS_DIR, `${slug}_${version}_${Date.now()}`);
+  const backupPath = join5(BACKUPS_DIR, `${slug}_${version}_${Date.now()}`);
   if (existsSync6(skillPath)) {
     cpSync2(skillPath, backupPath, { recursive: true });
   }
@@ -10219,7 +10254,7 @@ init_config();
 init_skills();
 init_data();
 init_llm();
-import { join as join5 } from "node:path";
+import { join as join6 } from "node:path";
 async function autoGeneralize(candidates, verbose = false, dryRun = false) {
   const created = [];
   const skipped = [];
@@ -10288,7 +10323,7 @@ Keep it focused and actionable. No filler.`
       meta.lastEvolved = new Date().toISOString();
       meta.tags = [...meta.tags ?? [], "auto-generalized"];
       meta.enhances = candidate.sourceSkills;
-      const skillDir = join5(getGeneralSkillsPath(), candidate.suggestedName);
+      const skillDir = join6(getGeneralSkillsPath(), candidate.suggestedName);
       writeSkill(skillDir, meta, content);
       created.push(candidate.suggestedName);
       console.log(`  ✓ Created: ${candidate.suggestedName} (domain layer)`);
@@ -10485,7 +10520,7 @@ async function evolveCommand(options) {
     if (finalAccepted && !dryRun) {
       const { meta, content } = parseSkillMd(proposalOutput.proposedSkillMd);
       const skillSlug2 = proposalOutput.targetSkill ?? proposal.targetSkill;
-      const skillDir = join6(getGeneralSkillsPath(), skillSlug2);
+      const skillDir = join7(getGeneralSkillsPath(), skillSlug2);
       meta.generation = generation;
       meta.score = avgScore;
       meta.lastEvolved = new Date().toISOString();
@@ -10496,7 +10531,7 @@ async function evolveCommand(options) {
       const skillFailureCount = allFailures.filter((f) => f.skillsActive.includes(skillSlug2)).length;
       deployCanary(skillSlug2, `v${generation}`, backupPath, config.quality.canaryDurationDays, skillFailureCount);
       console.log(`  \uD83D\uDC25 Canary deployed: ${config.quality.canaryDurationDays} day monitoring period`);
-      promoteToGoldenCase(testFailure, skillSlug2, replayResult);
+      promoteToSkillTest(testFailure, skillSlug2, replayResult);
       const program2 = {
         id: `gen${generation}-${skillSlug2}`,
         generation,
@@ -10573,9 +10608,9 @@ init_skills();
 // src/core/knowledge-buffer.ts
 init_config();
 import { readFileSync as readFileSync6, writeFileSync as writeFileSync5, existsSync as existsSync7 } from "node:fs";
-import { join as join7 } from "node:path";
-var BUFFER_PATH = () => join7(getHelixDir(), "knowledge-buffer.json");
-var DRAFTS_DIR = () => join7(getHelixDir(), "drafts");
+import { join as join8 } from "node:path";
+var BUFFER_PATH = () => join8(getHelixDir(), "knowledge-buffer.json");
+var DRAFTS_DIR = () => join8(getHelixDir(), "drafts");
 var MAX_DISCOVERIES = 50;
 var MAX_DRAFTS = 10;
 var DECAY_RATE = 0.1;
@@ -10632,9 +10667,9 @@ function saveDraft(draft) {
       existing.avgScore = draft.avgScore;
       existing.iteration++;
       existing.lastIterated = new Date().toISOString();
-      const draftDir = join7(DRAFTS_DIR(), draft.skillName);
+      const draftDir = join8(DRAFTS_DIR(), draft.skillName);
       ensureDir(draftDir);
-      writeFileSync5(join7(draftDir, "SKILL.md"), draft.skillMd);
+      writeFileSync5(join8(draftDir, "SKILL.md"), draft.skillMd);
     }
   } else {
     buffer.drafts.push({
@@ -10648,9 +10683,9 @@ function saveDraft(draft) {
       iteration: 1,
       lastIterated: new Date().toISOString()
     });
-    const draftDir = join7(DRAFTS_DIR(), draft.skillName);
+    const draftDir = join8(DRAFTS_DIR(), draft.skillName);
     ensureDir(draftDir);
-    writeFileSync5(join7(draftDir, "SKILL.md"), draft.skillMd);
+    writeFileSync5(join8(draftDir, "SKILL.md"), draft.skillMd);
   }
   trimAndSave(buffer);
 }
@@ -10703,7 +10738,7 @@ async function statusCommand() {
   const unresolved = failures.filter((f) => !f.resolved);
   const frontier = loadFrontier();
   const skills = loadAllGeneralSkills();
-  const goldenCases = loadGoldenCases();
+  const skillTests = loadSkillTests();
   const stagnation = getStagnationCount();
   const recentIter = getRecentIterations(7);
   console.log(`\uD83E\uDDEC HelixEvo Status
@@ -10722,7 +10757,7 @@ async function statusCommand() {
   }
   console.log(`
   Failures: ${unresolved.length} unresolved / ${failures.length} total`);
-  console.log(`  Golden cases: ${goldenCases.length}`);
+  console.log(`  Skill tests: ${skillTests.length}`);
   const buffer = getBufferStats();
   console.log(`
   Knowledge Buffer:`);
@@ -10750,7 +10785,7 @@ async function statusCommand() {
 init_data();
 init_skills();
 import { writeFileSync as writeFileSync6 } from "node:fs";
-import { join as join8 } from "node:path";
+import { join as join9 } from "node:path";
 init_config();
 async function reportCommand(options) {
   const days = parseInt(options.days ?? "1");
@@ -10834,8 +10869,8 @@ async function reportCommand(options) {
     report += `- **${s.slug}**${evolved}
 `;
   }
-  const outputPath = options.output ?? join8(getHelixDir(), "reports", `${date}.md`);
-  ensureDir(join8(getHelixDir(), "reports"));
+  const outputPath = options.output ?? join9(getHelixDir(), "reports", `${date}.md`);
+  ensureDir(join9(getHelixDir(), "reports"));
   writeFileSync6(outputPath, report);
   console.log(report);
   console.log(`
@@ -10846,7 +10881,7 @@ async function reportCommand(options) {
 init_config();
 init_skills();
 init_llm();
-import { join as join9 } from "node:path";
+import { join as join10 } from "node:path";
 async function generalizeCommand(options) {
   const verbose = options.verbose ?? false;
   const dryRun = options.dryRun ?? false;
@@ -10909,7 +10944,7 @@ async function generalizeCommand(options) {
       meta.generation = 1;
       meta.score = candidate.confidence;
       meta.lastEvolved = new Date().toISOString();
-      const skillDir = join9(getGeneralSkillsPath(), candidate.suggestedName);
+      const skillDir = join10(getGeneralSkillsPath(), candidate.suggestedName);
       writeSkill(skillDir, meta, content);
       console.log(`    ✓ Created: ${candidate.suggestedName} (${candidate.suggestedLayer} layer)
 `);
@@ -11017,7 +11052,7 @@ Return JSON:
 init_data();
 init_skills();
 init_llm();
-import { join as join10 } from "node:path";
+import { join as join11 } from "node:path";
 async function specializeCommand(options) {
   const verbose = options.verbose ?? false;
   const dryRun = options.dryRun ?? false;
@@ -11088,8 +11123,8 @@ async function specializeCommand(options) {
       meta.generation = 1;
       meta.score = candidate.confidence;
       meta.lastEvolved = new Date().toISOString();
-      const projectSkillsDir = join10(process.cwd(), ".helix", "skills");
-      const skillDir = join10(projectSkillsDir, candidate.suggestedName);
+      const projectSkillsDir = join11(process.cwd(), ".helix", "skills");
+      const skillDir = join11(projectSkillsDir, candidate.suggestedName);
       writeSkill(skillDir, meta, content);
       console.log(`    ✓ Created: ${candidate.suggestedName} (project layer, parent: ${candidate.domainSkill})
 `);
@@ -11186,7 +11221,7 @@ Return JSON:
 // src/commands/graph.ts
 import { writeFileSync as writeFileSync8 } from "node:fs";
 import { execSync } from "node:child_process";
-import { join as join12 } from "node:path";
+import { join as join13 } from "node:path";
 import { tmpdir } from "node:os";
 
 // src/core/network.ts
@@ -11539,29 +11574,29 @@ function detectMergeCandidates(enhances, coEvolves, skills) {
 init_data();
 init_skills();
 import { writeFileSync as writeFileSync7, mkdirSync as mkdirSync3 } from "node:fs";
-import { join as join11 } from "node:path";
+import { join as join12 } from "node:path";
 function syncToObsidian(vaultPath, verbose = false) {
   const graph = loadSkillGraph();
   const skills = loadAllGeneralSkills();
-  const skillsDir = join11(vaultPath, "Skills");
-  const reportsDir = join11(vaultPath, "Reports");
+  const skillsDir = join12(vaultPath, "Skills");
+  const reportsDir = join12(vaultPath, "Reports");
   mkdirSync3(skillsDir, { recursive: true });
   mkdirSync3(reportsDir, { recursive: true });
   for (const node of graph.nodes) {
     const skill = skills.find((s) => s.slug === node.id);
     const note = generateSkillNote(node, graph.edges, skill ?? undefined);
-    const notePath = join11(skillsDir, `${node.id}.md`);
+    const notePath = join12(skillsDir, `${node.id}.md`);
     writeFileSync7(notePath, note);
     if (verbose)
       console.log(`  ✓ ${node.id}.md`);
   }
   const indexNote = generateIndexNote(graph);
-  writeFileSync7(join11(vaultPath, "HelixEvo Index.md"), indexNote);
+  writeFileSync7(join12(vaultPath, "HelixEvo Index.md"), indexNote);
   const recent = getRecentIterations(7);
   if (recent.length > 0) {
     const report = generateEvolutionReport(recent);
     const date = new Date().toISOString().slice(0, 10);
-    writeFileSync7(join11(reportsDir, `Evolution ${date}.md`), report);
+    writeFileSync7(join12(reportsDir, `Evolution ${date}.md`), report);
   }
   console.log(`  ✓ Synced ${graph.nodes.length} skills to ${vaultPath}`);
 }
@@ -11920,7 +11955,7 @@ ${mermaidCode}
   });
 </script>
 </body></html>`;
-  const htmlPath = join12(tmpdir(), "helix-network.html");
+  const htmlPath = join13(tmpdir(), "helix-network.html");
   writeFileSync8(htmlPath, html);
   execSync(`open "${htmlPath}"`);
   console.log(`  ✓ Opened in browser`);
@@ -11985,7 +12020,7 @@ function renderScoreBar(score) {
 init_config();
 init_skills();
 init_llm();
-import { join as join13 } from "node:path";
+import { join as join14 } from "node:path";
 import { readFileSync as readFileSync7, existsSync as existsSync9 } from "node:fs";
 async function researchCommand(options) {
   const verbose = options.verbose ?? false;
@@ -12101,7 +12136,7 @@ Only include discoveries that are NOT already covered by current skills.`
       meta.score = result.avgScore / 10;
       meta.lastEvolved = new Date().toISOString();
       meta.tags = [...meta.tags ?? [], "research-discovered"];
-      const skillDir = join13(getGeneralSkillsPath(), hypothesis.skillName);
+      const skillDir = join14(getGeneralSkillsPath(), hypothesis.skillName);
       writeSkill(skillDir, meta, content);
       console.log(`    ✓ Created: ${hypothesis.skillName} (from research)
 `);
@@ -12149,7 +12184,7 @@ async function understandGoals(projectPath, skills) {
   const paths = projectPath ? [projectPath] : [process.cwd()];
   for (const p of paths) {
     for (const file of ["README.md", "CLAUDE.md", "package.json", ".agents/AGENTS.md"]) {
-      const fullPath = join13(p, file);
+      const fullPath = join14(p, file);
       if (existsSync9(fullPath)) {
         const content = readFileSync7(fullPath, "utf-8").slice(0, 2000);
         context.push(`## ${file}
@@ -12311,12 +12346,12 @@ ${replay.slice(0, 800)}`
 
 // src/commands/dashboard.ts
 import { execSync as execSync2, spawn as spawn2 } from "node:child_process";
-import { join as join14, dirname as dirname2 } from "node:path";
-import { existsSync as existsSync10, cpSync as cpSync3, mkdirSync as mkdirSync4, readdirSync as readdirSync2, statSync as statSync2, rmSync as rmSync2 } from "node:fs";
-import { fileURLToPath } from "node:url";
+import { join as join15, dirname as dirname3 } from "node:path";
+import { existsSync as existsSync10, cpSync as cpSync3, mkdirSync as mkdirSync4, readdirSync as readdirSync2, readFileSync as readFileSync8, rmSync as rmSync2, writeFileSync as writeFileSync9 } from "node:fs";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
 import { homedir as homedir3 } from "node:os";
-var __filename = "/Users/tianchichen/Documents/GitHub/skillgraph/src/commands/dashboard.ts";
-var HELIX_DASHBOARD_DIR = join14(homedir3(), ".helix", "dashboard");
+var __filename = "/Users/tianchichen/Documents/GitHub/helixevo/src/commands/dashboard.ts";
+var HELIX_DASHBOARD_DIR = join15(homedir3(), ".helix", "dashboard");
 async function dashboardCommand() {
   const dir = prepareDashboard();
   if (!dir) {
@@ -12327,7 +12362,7 @@ async function dashboardCommand() {
     console.error("    cd helixevo/dashboard && npm install && npx next dev --port 3847");
     process.exit(1);
   }
-  if (!existsSync10(join14(dir, "node_modules"))) {
+  if (!existsSync10(join15(dir, "node_modules"))) {
     console.log("  Installing dashboard dependencies...");
     try {
       execSync2("npm install --no-audit --no-fund", { cwd: dir, stdio: "inherit" });
@@ -12338,7 +12373,7 @@ async function dashboardCommand() {
       process.exit(1);
     }
   }
-  console.log(`  \uD83C\uDF10 Starting HelixEvo Dashboard at http://localhost:3847
+  console.log(`  \uD83C\uDF10 Starting HelixEvo Dashboard v${VERSION} at http://localhost:3847
 `);
   const child = spawn2("npx", ["next", "dev", "--port", "3847"], {
     cwd: dir,
@@ -12363,20 +12398,20 @@ function prepareDashboard() {
   const npmSource = findNpmDashboard();
   if (npmSource)
     return copyToHelix(npmSource);
-  if (existsSync10(join14(HELIX_DASHBOARD_DIR, "package.json"))) {
+  if (existsSync10(join15(HELIX_DASHBOARD_DIR, "package.json"))) {
     return HELIX_DASHBOARD_DIR;
   }
   return null;
 }
 function findDevDashboard() {
   const candidates = [
-    join14(process.cwd(), "dashboard")
+    join15(process.cwd(), "dashboard")
   ];
   const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
-  candidates.push(join14(home, "Documents", "GitHub", "helixevo", "dashboard"));
-  candidates.push(join14(home, "Documents", "GitHub", "skillgraph", "dashboard"));
+  candidates.push(join15(home, "Documents", "GitHub", "helixevo", "dashboard"));
+  candidates.push(join15(home, "Documents", "GitHub", "skillgraph", "dashboard"));
   for (const dir of candidates) {
-    if (existsSync10(join14(dir, "package.json")) && !dir.includes("node_modules")) {
+    if (existsSync10(join15(dir, "package.json")) && !dir.includes("node_modules")) {
       return dir;
     }
   }
@@ -12385,60 +12420,84 @@ function findDevDashboard() {
 function findNpmDashboard() {
   const candidates = [];
   try {
-    const thisFile = typeof __filename !== "undefined" ? __filename : fileURLToPath(import.meta.url);
-    const pkgRoot = dirname2(dirname2(thisFile));
-    candidates.push(join14(pkgRoot, "dashboard"));
+    const thisFile = typeof __filename !== "undefined" ? __filename : fileURLToPath2(import.meta.url);
+    const pkgRoot = dirname3(dirname3(thisFile));
+    candidates.push(join15(pkgRoot, "dashboard"));
   } catch {}
   try {
     const globalPrefix = execSync2("npm prefix -g", { encoding: "utf-8" }).trim();
-    candidates.push(join14(globalPrefix, "lib", "node_modules", "helixevo", "dashboard"));
-    candidates.push(join14(globalPrefix, "node_modules", "helixevo", "dashboard"));
+    candidates.push(join15(globalPrefix, "lib", "node_modules", "helixevo", "dashboard"));
+    candidates.push(join15(globalPrefix, "node_modules", "helixevo", "dashboard"));
   } catch {}
   for (const dir of candidates) {
-    if (existsSync10(join14(dir, "package.json"))) {
+    if (existsSync10(join15(dir, "package.json"))) {
       return dir;
     }
   }
   return null;
 }
+function getInstalledDashboardVersion() {
+  try {
+    const versionFile = join15(HELIX_DASHBOARD_DIR, ".helixevo-version");
+    if (!existsSync10(versionFile))
+      return null;
+    return readFileSync8(versionFile, "utf-8").trim();
+  } catch {
+    return null;
+  }
+}
 function copyToHelix(sourceDir) {
-  const destPkg = join14(HELIX_DASHBOARD_DIR, "package.json");
-  if (existsSync10(destPkg)) {
-    try {
-      const srcTime = statSync2(join14(sourceDir, "package.json")).mtimeMs;
-      const dstTime = statSync2(destPkg).mtimeMs;
-      if (srcTime <= dstTime) {
-        return HELIX_DASHBOARD_DIR;
-      }
-    } catch {}
+  const installedVersion = getInstalledDashboardVersion();
+  if (installedVersion === VERSION) {
+    return HELIX_DASHBOARD_DIR;
+  }
+  if (installedVersion) {
+    console.log(`  Updating dashboard: v${installedVersion} → v${VERSION}`);
+  } else {
+    console.log("  Setting up dashboard at ~/.helix/dashboard...");
   }
-  console.log("  Setting up dashboard at ~/.helix/dashboard...");
   mkdirSync4(HELIX_DASHBOARD_DIR, { recursive: true });
+  let depsChanged = true;
+  try {
+    const srcDeps = readFileSync8(join15(sourceDir, "package.json"), "utf-8");
+    const dstDeps = readFileSync8(join15(HELIX_DASHBOARD_DIR, "package.json"), "utf-8");
+    const srcPkg = JSON.parse(srcDeps);
+    const dstPkg = JSON.parse(dstDeps);
+    depsChanged = JSON.stringify(srcPkg.dependencies) !== JSON.stringify(dstPkg.dependencies) || JSON.stringify(srcPkg.devDependencies) !== JSON.stringify(dstPkg.devDependencies);
+  } catch {
+    depsChanged = true;
+  }
   const items = readdirSync2(sourceDir, { withFileTypes: true });
   for (const item of items) {
     if (item.name === "node_modules" || item.name === ".next" || item.name === "package-lock.json")
       continue;
-    const src = join14(sourceDir, item.name);
-    const dest = join14(HELIX_DASHBOARD_DIR, item.name);
+    const src = join15(sourceDir, item.name);
+    const dest = join15(HELIX_DASHBOARD_DIR, item.name);
     cpSync3(src, dest, { recursive: true });
   }
-  const oldModules = join14(HELIX_DASHBOARD_DIR, "node_modules");
-  if (existsSync10(oldModules))
-    rmSync2(oldModules, { recursive: true });
-  const oldLock = join14(HELIX_DASHBOARD_DIR, "package-lock.json");
-  if (existsSync10(oldLock))
-    rmSync2(oldLock);
+  if (depsChanged) {
+    const oldModules = join15(HELIX_DASHBOARD_DIR, "node_modules");
+    if (existsSync10(oldModules))
+      rmSync2(oldModules, { recursive: true });
+    const oldLock = join15(HELIX_DASHBOARD_DIR, "package-lock.json");
+    if (existsSync10(oldLock))
+      rmSync2(oldLock);
+  }
+  const nextCache = join15(HELIX_DASHBOARD_DIR, ".next");
+  if (existsSync10(nextCache))
+    rmSync2(nextCache, { recursive: true });
+  writeFileSync9(join15(HELIX_DASHBOARD_DIR, ".helixevo-version"), VERSION);
   return HELIX_DASHBOARD_DIR;
 }
 
 // src/commands/watch.ts
-import { join as join16 } from "node:path";
+import { join as join17 } from "node:path";
 import { existsSync as existsSync13 } from "node:fs";
 
 // src/core/auto-capture.ts
 init_data();
 init_llm();
-import { readFileSync as readFileSync8, existsSync as existsSync11, statSync as statSync3 } from "node:fs";
+import { readFileSync as readFileSync9, existsSync as existsSync11, statSync as statSync2 } from "node:fs";
 var CORRECTION_SIGNALS = [
   /\bno[, ]+(?:that's|thats|that is)\s+(?:wrong|incorrect|not right)/i,
   /\bdon'?t\s+do\s+(?:that|it\s+like\s+that)/i,
@@ -12526,17 +12585,17 @@ If no corrections found, return: { "corrections": [] }`
 }
 function watchEvents(options) {
   const { eventsPath, project, onCapture, onError, pollIntervalMs = 5000 } = options;
-  let lastSize = existsSync11(eventsPath) ? statSync3(eventsPath).size : 0;
+  let lastSize = existsSync11(eventsPath) ? statSync2(eventsPath).size : 0;
   let messageBuffer = [];
   let pendingExtraction = false;
   const interval = setInterval(async () => {
     try {
       if (!existsSync11(eventsPath))
         return;
-      const currentSize = statSync3(eventsPath).size;
+      const currentSize = statSync2(eventsPath).size;
       if (currentSize <= lastSize)
         return;
-      const content = readFileSync8(eventsPath, "utf-8");
+      const content = readFileSync9(eventsPath, "utf-8");
       const lines = content.trim().split(`
 `).filter(Boolean);
       const newLines = lines.slice(messageBuffer.length);
@@ -12578,22 +12637,22 @@ init_data();
 // src/core/metrics.ts
 init_config();
 init_data();
-import { readFileSync as readFileSync9, writeFileSync as writeFileSync9, existsSync as existsSync12 } from "node:fs";
-import { join as join15 } from "node:path";
+import { readFileSync as readFileSync10, writeFileSync as writeFileSync10, existsSync as existsSync12 } from "node:fs";
+import { join as join16 } from "node:path";
 function getMetricsPath() {
-  return join15(getHelixDir(), "metrics.json");
+  return join16(getHelixDir(), "metrics.json");
 }
 function loadMetrics() {
   const path = getMetricsPath();
   if (!existsSync12(path)) {
     return { updated: new Date().toISOString(), skills: [], globalCorrectionRate: [], evolutionImpact: [] };
   }
-  return JSON.parse(readFileSync9(path, "utf-8"));
+  return JSON.parse(readFileSync10(path, "utf-8"));
 }
 function saveMetrics(store) {
   ensureDir(getHelixDir());
   store.updated = new Date().toISOString();
-  writeFileSync9(getMetricsPath(), JSON.stringify(store, null, 2));
+  writeFileSync10(getMetricsPath(), JSON.stringify(store, null, 2));
 }
 function updateMetrics() {
   const failures = loadFailures();
@@ -12768,7 +12827,7 @@ async function watchCommand(options) {
   const verbose = options.verbose ?? false;
   const autoEvolve = options.evolve !== false;
   const project = options.project ?? null;
-  const eventsPath = options.events ?? join16(process.cwd(), "events.jsonl");
+  const eventsPath = options.events ?? join17(process.cwd(), "events.jsonl");
   console.log(`\uD83E\uDDEC HelixEvo Watch Mode — Always-On Learning
 `);
   console.log(`  Events:      ${eventsPath}`);
@@ -12922,14 +12981,100 @@ async function metricsCommand(options) {
   }
 }
 
+// src/utils/update-check.ts
+import { readFileSync as readFileSync11, writeFileSync as writeFileSync11, existsSync as existsSync14, mkdirSync as mkdirSync5 } from "node:fs";
+import { join as join18 } from "node:path";
+import { homedir as homedir4 } from "node:os";
+var HELIX_DIR2 = join18(homedir4(), ".helix");
+var CACHE_PATH = join18(HELIX_DIR2, "update-check.json");
+var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
+var REGISTRY_URL = "https://registry.npmjs.org/helixevo/latest";
+function readCache() {
+  try {
+    if (!existsSync14(CACHE_PATH))
+      return null;
+    return JSON.parse(readFileSync11(CACHE_PATH, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function writeCache(cache) {
+  try {
+    if (!existsSync14(HELIX_DIR2))
+      mkdirSync5(HELIX_DIR2, { recursive: true });
+    writeFileSync11(CACHE_PATH, JSON.stringify(cache));
+  } catch {}
+}
+function compareVersions(current, latest) {
+  const c = current.split(".").map(Number);
+  const l = latest.split(".").map(Number);
+  for (let i = 0;i < 3; i++) {
+    if ((l[i] ?? 0) > (c[i] ?? 0))
+      return true;
+    if ((l[i] ?? 0) < (c[i] ?? 0))
+      return false;
+  }
+  return false;
+}
+async function fetchLatestVersion() {
+  try {
+    const controller = new AbortController;
+    const timeout = setTimeout(() => controller.abort(), 3000);
+    const res = await fetch(REGISTRY_URL, { signal: controller.signal });
+    clearTimeout(timeout);
+    if (!res.ok)
+      return null;
+    const data = await res.json();
+    return data.version ?? null;
+  } catch {
+    return null;
+  }
+}
+async function checkForUpdates() {
+  try {
+    const cache = readCache();
+    if (cache && Date.now() - cache.lastCheck < CHECK_INTERVAL_MS) {
+      if (compareVersions(VERSION, cache.latestVersion)) {
+        printUpdateBanner(cache.latestVersion);
+      }
+      return;
+    }
+    const latest = await fetchLatestVersion();
+    if (!latest)
+      return;
+    writeCache({ lastCheck: Date.now(), latestVersion: latest });
+    if (compareVersions(VERSION, latest)) {
+      printUpdateBanner(latest);
+    }
+  } catch {}
+}
+function printUpdateBanner(latestVersion) {
+  const yellow = "\x1B[33m";
+  const green = "\x1B[32m";
+  const cyan = "\x1B[36m";
+  const bold = "\x1B[1m";
+  const dim = "\x1B[2m";
+  const reset = "\x1B[0m";
+  console.log();
+  console.log(`${yellow}  ╭──────────────────────────────────────────────╮${reset}`);
+  console.log(`${yellow}  │                                              │${reset}`);
+  console.log(`${yellow}  │  ${bold}Update available!${reset}${yellow}  ${dim}v${VERSION}${reset}${yellow} → ${green}${bold}v${latestVersion}${reset}${yellow}          │${reset}`);
+  console.log(`${yellow}  │                                              │${reset}`);
+  console.log(`${yellow}  │  ${reset}Run ${cyan}npm install -g helixevo@latest${reset}${yellow}        │${reset}`);
+  console.log(`${yellow}  │  ${reset}to update${yellow}                                   │${reset}`);
+  console.log(`${yellow}  │                                              │${reset}`);
+  console.log(`${yellow}  ╰──────────────────────────────────────────────╯${reset}`);
+  console.log();
+}
+
 // src/cli.ts
 var program2 = new Command;
-program2.name("helixevo").description("Self-evolving skill ecosystem for AI agents").version("0.2.7").addHelpText("after", `
+program2.name("helixevo").description("Self-evolving skill ecosystem for AI agents").version(VERSION).addHelpText("after", `
 Examples:
   $ helixevo watch                         Always-on learning (auto-capture + auto-evolve)
   $ helixevo watch --project myapp         Watch with project context
   $ helixevo metrics                       Show correction rates and evolution impact
-  $ helixevo init                          Import skills + generate golden cases
+  $ helixevo init                          Import skills + generate skill tests
   $ helixevo status                        Show system health
   $ helixevo evolve --verbose              Evolve skills from failures
   $ helixevo evolve --dry-run              Preview proposals without applying
@@ -12943,7 +13088,7 @@ Examples:
   $ helixevo graph --optimize              Detect merge/split/conflicts
   $ helixevo report --days 7               Weekly evolution report
   $ helixevo capture <session.json>        Extract failures from session`);
-program2.command("init").description("Import existing skills + generate golden cases").option("--skills-paths <paths...>", "Paths to scan for existing skills").option("--skip-golden", "Skip golden case generation").action(initCommand);
+program2.command("init").description("Import existing skills + generate skill tests").option("--skills-paths <paths...>", "Paths to scan for existing skills").option("--skip-tests", "Skip skill test generation").action(initCommand);
 program2.command("capture").description("Capture failures from a Craft Agent session").argument("<sessionPath>", "Path to session conversation file").option("--project <name>", "Project name override").action(captureCommand);
 program2.command("evolve").description("Evolve skills from failures [--dry-run] [--verbose] [--max-proposals <n>]").option("--dry-run", "Show proposals without applying").option("--verbose", "Show detailed LLM interactions").option("--max-proposals <n>", "Max proposals per run", "5").action(evolveCommand);
 program2.command("generalize").description("Promote cross-skill patterns to higher layer ↑ [--dry-run] [--verbose]").option("--dry-run", "Show candidates without applying").option("--verbose", "Show detailed analysis").action(generalizeCommand);
@@ -12960,4 +13105,7 @@ program2.command("health").description("Assess network health: cohesion, coverag
   printHealthReport2(health);
 });
 program2.command("metrics").description("Show correction rates, skill trends, and evolution impact").option("--verbose", "Show detailed per-skill breakdown").action(metricsCommand);
+program2.hook("postAction", () => {
+  checkForUpdates().catch(() => {});
+});
 program2.parse();

package/dist/postinstall.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+
+// src/postinstall.ts
+import { createRequire } from "node:module";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+var require2 = createRequire(import.meta.url);
+var pkg = require2(join(dirname(fileURLToPath(import.meta.url)), "..", "package.json"));
+var green = "\x1B[32m";
+var cyan = "\x1B[36m";
+var bold = "\x1B[1m";
+var dim = "\x1B[2m";
+var reset = "\x1B[0m";
+console.log();
+console.log(`  ${green}✓${reset} ${bold}HelixEvo v${pkg.version}${reset} installed successfully`);
+console.log();
+console.log(`  ${dim}Get started:${reset}`);
+console.log(`    ${cyan}helixevo init${reset}        Import skills + generate skill tests`);
+console.log(`    ${cyan}helixevo dashboard${reset}   Open web dashboard`);
+console.log(`    ${cyan}helixevo watch${reset}       Always-on learning mode`);
+console.log();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "helixevo",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "description": "Self-evolving skill ecosystem for AI agents. Skills and projects co-evolve through multi-judge evaluation and a Pareto frontier.",
   "type": "module",
   "bin": {
@@ -14,15 +14,17 @@
     "dashboard/package.json",
     "dashboard/tsconfig.json",
     "dashboard/next-env.d.ts",
+    "dashboard/next.config.mjs",
     "README.md",
     "LICENSE"
   ],
   "scripts": {
-    "build": "bun build src/cli.ts --outdir dist --target node",
+    "build": "bun build src/cli.ts --outdir dist --target node && bun build src/postinstall.ts --outdir dist --target node --entry-naming postinstall.js",
     "dev": "bun run src/cli.ts",
     "typecheck": "tsc --noEmit",
     "prepare": "npm run build",
-    "prepublishOnly": "npm run typecheck && npm run build"
+    "prepublishOnly": "npm run typecheck && npm run build",
+    "postinstall": "node dist/postinstall.js 2>/dev/null || true"
   },
   "dependencies": {
     "commander": "^13.1.0",