helixevo 0.2.8 → 0.2.9

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 = [
@@ -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
@@ -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/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

@@ -9576,7 +9576,7 @@ 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";
 
@@ -9605,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 = [];
@@ -9628,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);
       }
@@ -9641,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;
@@ -9653,6 +9661,30 @@ async function initCommand(options) {
   console.log(`
   Imported ${imported} new skills
 `);
+  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 skill tests...
@@ -9773,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) {
@@ -10123,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();
@@ -10140,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 });
   }
@@ -10222,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 = [];
@@ -10291,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)`);
@@ -10488,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();
@@ -10576,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;
@@ -10635,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({
@@ -10651,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);
 }
@@ -10753,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");
@@ -10837,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(`
@@ -10849,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;
@@ -10912,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)
 `);
@@ -11020,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;
@@ -11091,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})
 `);
@@ -11189,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
@@ -11542,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}`);
 }
@@ -11923,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`);
@@ -11988,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;
@@ -12104,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)
 `);
@@ -12152,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}
@@ -12314,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) {
@@ -12330,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" });
@@ -12341,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,
@@ -12366,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;
     }
   }
@@ -12388,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,
@@ -12529,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);
@@ -12581,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();
@@ -12771,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}`);
@@ -12925,9 +12981,95 @@ 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.8").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
@@ -12963,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.8",
+  "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",