helixevo 0.2.25 → 0.2.27

package/dashboard/components/update-banner.tsx

@@ -3,7 +3,7 @@
 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
+const CHECK_INTERVAL_MS = 60 * 60 * 1000
 
 function compareVersions(current: string, latest: string): boolean {
   const c = current.split('.').map(Number)
@@ -15,7 +15,7 @@ function compareVersions(current: string, latest: string): boolean {
   return false
 }
 
-type UpdateState = 'idle' | 'updating' | 'success' | 'error'
+type UpdateState = 'idle' | 'updating' | 'installed' | 'error'
 
 export function UpdateBanner({ currentVersion }: { currentVersion: string }) {
   const [latestVersion, setLatestVersion] = useState<string | null>(null)
@@ -23,10 +23,10 @@ export function UpdateBanner({ currentVersion }: { currentVersion: string }) {
   const [state, setState] = useState<UpdateState>('idle')
   const [newVersion, setNewVersion] = useState<string | null>(null)
   const [errorMsg, setErrorMsg] = useState<string | null>(null)
+  const [copied, setCopied] = useState(false)
 
   useEffect(() => {
     let mounted = true
-
     async function check() {
       try {
         const res = await fetch(REGISTRY_URL)
@@ -37,7 +37,6 @@ export function UpdateBanner({ currentVersion }: { currentVersion: string }) {
         }
       } catch {}
     }
-
     check()
     const interval = setInterval(check, CHECK_INTERVAL_MS)
     return () => { mounted = false; clearInterval(interval) }
@@ -54,49 +53,35 @@ export function UpdateBanner({ currentVersion }: { currentVersion: string }) {
       const data = await res.json()
 
       if (data.success) {
-        setState('success')
+        setState('installed')
         setNewVersion(data.version)
-
-        // Tell server to restart, then wait and reload
-        try {
-          await fetch('/api/restart', { method: 'POST' })
-        } catch {}
-
-        // Wait for: shutdown (2s) + port release (2s) + restart + compile (~8s)
-        // Then try to reload, retrying if server isn't ready
-        await new Promise(r => setTimeout(r, 6000))
-
-        for (let attempt = 0; attempt < 20; attempt++) {
-          try {
-            const check = await fetch('/?_bust=' + Date.now(), { cache: 'no-store' })
-            if (check.ok) {
-              window.location.href = window.location.pathname + '?updated=' + Date.now()
-              return
-            }
-          } catch {}
-          await new Promise(r => setTimeout(r, 2000))
-        }
-
-        // Final fallback
-        window.location.href = window.location.pathname + '?updated=' + Date.now()
       } else {
         setState('error')
         setErrorMsg(data.error ?? 'Update failed')
       }
-    } catch (err) {
+    } catch {
       setState('error')
       setErrorMsg('Network error — try running: npm install -g helixevo@latest')
     }
   }
 
+  const restartCmd = 'helixevo dashboard'
+  const handleCopy = async () => {
+    try {
+      await navigator.clipboard.writeText(restartCmd)
+      setCopied(true)
+      setTimeout(() => setCopied(false), 2000)
+    } catch {}
+  }
+
   return (
     <div style={{
       position: 'fixed',
       bottom: 20,
       right: 20,
-      width: 320,
+      width: 340,
       background: 'var(--bg-card)',
-      border: `1px solid ${state === 'success' ? 'var(--green-border)' : state === 'error' ? 'var(--red-border)' : 'var(--purple-border)'}`,
+      border: `1px solid ${state === 'installed' ? 'var(--green-border)' : state === 'error' ? 'var(--red-border)' : 'var(--purple-border)'}`,
       borderRadius: 'var(--radius-lg)',
       boxShadow: 'var(--shadow-xl)',
       padding: '16px 18px',
@@ -123,7 +108,7 @@ export function UpdateBanner({ currentVersion }: { currentVersion: string }) {
       <div style={{ display: 'flex', alignItems: 'center', gap: 8, marginBottom: 12 }}>
         <div style={{
           width: 28, height: 28, borderRadius: '50%',
-          background: state === 'success' ? 'var(--green-light)'
+          background: state === 'installed' ? 'var(--green-light)'
             : state === 'error' ? 'var(--red-light)'
             : 'var(--purple-light)',
           display: 'flex',
@@ -135,7 +120,7 @@ export function UpdateBanner({ currentVersion }: { currentVersion: string }) {
               borderTopColor: 'var(--purple)', borderRadius: '50%',
               animation: 'updateSpin 0.8s linear infinite',
             }} />
-          ) : state === 'success' ? (
+          ) : state === 'installed' ? (
             <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="var(--green)" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round">
               <path d="M20 6L9 17l-5-5" />
             </svg>
@@ -151,21 +136,21 @@ export function UpdateBanner({ currentVersion }: { currentVersion: string }) {
         </div>
         <div>
           <div style={{ fontSize: 13, fontWeight: 700, color: 'var(--text)', letterSpacing: -0.2 }}>
-            {state === 'updating' ? 'Updating...'
-              : state === 'success' ? 'Updated!'
+            {state === 'updating' ? 'Installing...'
+              : state === 'installed' ? 'Installed!'
               : state === 'error' ? 'Update Failed'
               : 'Update Available'}
           </div>
           <div style={{ fontSize: 11, color: 'var(--text-dim)' }}>
-            {state === 'success'
-              ? <>Now on <span style={{ color: 'var(--green)', fontWeight: 600 }}>v{newVersion}</span> — restarting...</>
+            {state === 'installed'
+              ? <>v{newVersion} is ready</>
               : <>v{currentVersion} &rarr; <span style={{ color: 'var(--green)', fontWeight: 600 }}>v{latestVersion}</span></>
             }
           </div>
         </div>
       </div>
 
-      {/* Action area */}
+      {/* Idle — Update Now button */}
       {state === 'idle' && (
         <button
           onClick={handleUpdate}
@@ -183,18 +168,16 @@ export function UpdateBanner({ currentVersion }: { currentVersion: string }) {
             alignItems: 'center',
             justifyContent: 'center',
             gap: 6,
-            transition: 'opacity 0.15s',
           }}
-          onMouseOver={e => (e.currentTarget.style.opacity = '0.9')}
-          onMouseOut={e => (e.currentTarget.style.opacity = '1')}
         >
           <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
-            <path d="M21 12a9 9 0 01-9 9m9-9a9 9 0 00-9-9m9 9H3m9 9a9 9 0 01-9-9m9 9c1.657 0 3-4.03 3-9s-1.343-9-3-9m0 18c-1.657 0-3-4.03-3-9s1.343-9 3-9" />
+            <path d="M12 19V5m-7 7l7-7 7 7" />
           </svg>
           Update Now
         </button>
       )}
 
+      {/* Updating spinner */}
       {state === 'updating' && (
         <div style={{
           width: '100%',
@@ -209,21 +192,52 @@ export function UpdateBanner({ currentVersion }: { currentVersion: string }) {
         </div>
       )}
 
-      {state === 'success' && (
-        <div style={{
-          width: '100%',
-          padding: '9px 16px',
-          background: 'var(--green-light)',
-          borderRadius: 'var(--radius)',
-          fontSize: 12,
-          color: 'var(--green)',
-          textAlign: 'center',
-          fontWeight: 600,
-        }}>
-          Restarting dashboard...
+      {/* Installed — restart instructions */}
+      {state === 'installed' && (
+        <div>
+          <div style={{
+            padding: '10px 14px',
+            background: 'var(--green-light)',
+            borderRadius: 'var(--radius)',
+            fontSize: 12,
+            color: 'var(--green)',
+            fontWeight: 600,
+            marginBottom: 10,
+            textAlign: 'center',
+          }}>
+            v{newVersion} installed successfully
+          </div>
+          <div style={{ fontSize: 11, color: 'var(--text-dim)', marginBottom: 8, lineHeight: 1.5 }}>
+            Restart the dashboard to load the new version:
+          </div>
+          <div style={{ display: 'flex', flexDirection: 'column', gap: 6 }}>
+            <div style={{ fontSize: 11, color: 'var(--text-dim)' }}>
+              1. Press <kbd style={{ padding: '1px 5px', background: 'var(--bg-section)', borderRadius: 3, fontFamily: 'var(--font-mono)', fontSize: 10, border: '1px solid var(--border)' }}>Ctrl+C</kbd> in the terminal running the dashboard
+            </div>
+            <div style={{ fontSize: 11, color: 'var(--text-dim)' }}>
+              2. Run:
+            </div>
+            <div
+              onClick={handleCopy}
+              style={{
+                display: 'flex', justifyContent: 'space-between', alignItems: 'center',
+                padding: '7px 12px',
+                background: 'var(--bg-section)', border: '1px solid var(--border)',
+                borderRadius: 'var(--radius)',
+                fontFamily: 'var(--font-mono)', fontSize: 11,
+                color: 'var(--text)', cursor: 'pointer',
+              }}
+            >
+              <span>$ {restartCmd}</span>
+              <span style={{ fontSize: 10, color: copied ? 'var(--green)' : 'var(--purple)', fontWeight: 600, fontFamily: 'var(--font)' }}>
+                {copied ? 'Copied!' : 'Copy'}
+              </span>
+            </div>
+          </div>
         </div>
       )}
 
+      {/* Error */}
       {state === 'error' && (
         <>
           <div style={{

package/dist/cli.js

@@ -9808,7 +9808,7 @@ init_llm();
 import { join as join7 } from "node:path";
 
 // src/prompts/cluster.ts
-function buildClusterPrompt(failures, skills) {
+function buildClusterPrompt(failures, skills, graph) {
   const failuresJson = failures.map((f) => ({
     id: f.id,
     project: f.project,
@@ -9819,6 +9819,29 @@ function buildClusterPrompt(failures, skills) {
   }));
   const skillsList = skills.map((s) => `- ${s.slug}: ${s.meta.description}`).join(`
 `);
+  let graphSection = "";
+  if (graph && graph.edges.length > 0) {
+    const edgesList = graph.edges.map((e) => `- ${e.from} --[${e.type}]--> ${e.to} (strength: ${e.strength})`).join(`
+`);
+    const clustersList = graph.clusters.map((c) => `- ${c.name}: [${c.skills.join(", ")}] (cohesion: ${c.cohesion})`).join(`
+`);
+    graphSection = `
+## Skill Network Graph
+The following relationships exist between skills. Use this to identify when failures might affect multiple related skills.
+
+### Relationships
+${edgesList}
+
+### Clusters
+${clustersList}
+
+When clustering failures, consider:
+- Failures in skills that are in the same cluster likely share root causes
+- "inherits" edges mean a child skill should follow parent skill rules
+- "enhances" edges mean skills complement each other
+- "conflicts" edges mean skills may have contradictory rules
+`;
+  }
   return `You are a failure pattern analyst.
 
 ## Task
@@ -9829,7 +9852,7 @@ ${JSON.stringify(failuresJson, null, 2)}
 
 ## Current Skills
 ${skillsList}
-
+${graphSection}
 ## Output Requirements
 Return a JSON object with this exact structure:
 {
@@ -9846,7 +9869,8 @@ Return a JSON object with this exact structure:
 - Do not create clusters with only 1 record (unless truly unique)
 - Maximum 8 clusters
 - Each record belongs to exactly one cluster
-- Cluster names should be specific (e.g., "WCAG color contrast violations", not "UI issues")`;
+- Cluster names should be specific (e.g., "WCAG color contrast violations", not "UI issues")
+- If skill graph is available, use relationships to identify which skills should be targeted together`;
 }
 function parseClusterOutput(raw) {
   const data = raw;
@@ -9857,7 +9881,7 @@ function parseClusterOutput(raw) {
 }
 
 // src/prompts/proposer.ts
-function buildProposerPrompt(clusterType, failures, relevantSkill, relatedProposals) {
+function buildProposerPrompt(clusterType, failures, relevantSkill, relatedProposals, graphContext) {
   const failureDetails = failures.map((f) => `- [${f.id}] User asked: "${f.userRequest}" → Agent did: "${f.agentAction}" → User corrected: "${f.correction}"`).join(`
 `);
   const skillContent = relevantSkill ? `### ${relevantSkill.slug}
@@ -9866,6 +9890,37 @@ ${relevantSkill.content}
 \`\`\`` : "No existing skill covers this area.";
   const historySection = relatedProposals.length > 0 ? relatedProposals.map((p) => `- [${p.id}] ${p.description} → ${p.outcome} (${p.outcomeReason})`).join(`
 `) : "No prior proposals for this area.";
+  let graphSection = "";
+  if (graphContext && graphContext.relatedSkills.length > 0) {
+    const relatedEdges = relevantSkill ? graphContext.edges.filter((e) => e.from === relevantSkill.slug || e.to === relevantSkill.slug).map((e) => {
+      const other = e.from === relevantSkill.slug ? e.to : e.from;
+      const direction = e.from === relevantSkill.slug ? "outgoing" : "incoming";
+      return `  - ${e.type} (${direction}): ${other} (strength: ${e.strength})`;
+    }).join(`
+`) : "";
+    const relatedSkillSummaries = graphContext.relatedSkills.map((s) => {
+      const preview = s.content.slice(0, 200).replace(/\n/g, " ");
+      return `  - ${s.slug} (score: ${s.meta.score ?? "N/A"}, gen: ${s.meta.generation ?? 0}): ${preview}...`;
+    }).join(`
+`);
+    const clusterInfo = graphContext.cluster ? `This skill belongs to the "${graphContext.cluster.name}" cluster (cohesion: ${graphContext.cluster.cohesion}) with: ${graphContext.cluster.skills.join(", ")}` : "";
+    graphSection = `
+## Skill Network Context
+${relevantSkill?.slug ?? "New skill"} has the following relationships in the skill graph:
+${relatedEdges || "  No edges yet"}
+
+${clusterInfo}
+
+### Related Skills (summaries)
+${relatedSkillSummaries}
+
+## Graph-Aware Guidelines
+- If this skill "inherits" from a parent, ensure your changes are consistent with the parent skill's rules
+- If this skill "enhances" another, check that your changes don't conflict with the enhanced skill
+- If related skills in the same cluster share similar rules, consider whether the fix should be applied at a more abstract level
+- If the correction addresses a pattern common across multiple related skills, note this in your justification — it may warrant propagation
+`;
+  }
   return `You are a skill evolution expert. Analyze failures and propose a concrete skill improvement.
 
 ## Failure Cluster: "${clusterType}"
@@ -9876,12 +9931,13 @@ ${skillContent}
 
 ## Prior Proposals (avoid repeating rejected approaches)
 ${historySection}
-
+${graphSection}
 ## Instructions
 1. Analyze the root cause shared by these failures
 2. Determine: edit existing skill or create new one?
-3. Generate the exact SKILL.md content (complete file if create, or a unified diff if edit)
+3. Generate the exact SKILL.md content (complete file with frontmatter)
 4. Explain why this is better than any rejected prior proposals
+5. If graph context is available, consider whether the improvement should be structured hierarchically (core principles at top, specific rules below)
 
 ## Output
 Return JSON:
@@ -9891,14 +9947,19 @@ Return JSON:
   "proposedSkillMd": "full SKILL.md content with frontmatter",
   "diff": "human-readable description of changes",
   "justification": "why this addresses the root cause",
-  "relatedIterations": ["prop_id"] // related prior proposal IDs
+  "relatedIterations": ["prop_id"],
+  "propagationSuggestions": ["skill-slug"] // skills that might benefit from similar changes (optional)
 }
 
 ## Constraints
 - YAGNI: every rule must map to a specific failure
 - One skill at a time
 - Preserve all existing effective rules when editing
-- Be specific — no vague "consider doing X" rules`;
+- Be specific — no vague "consider doing X" rules
+- When graph context shows skill relationships, organize content hierarchically:
+  1. Inherited/shared principles (from parent skills)
+  2. Core rules (this skill's domain)
+  3. Specific patterns (from failures)`;
 }
 
 // src/prompts/replay.ts
@@ -10398,9 +10459,17 @@ async function evolveCommand(options) {
   console.log(`  Processing ${batch.length} failures (${failures.length} total unresolved)
 `);
   const skills = loadAllGeneralSkills();
-  if (verbose)
-    console.log(`  Skills loaded: ${skills.map((s) => s.slug).join(", ")}
-`);
+  const graph = loadSkillGraph();
+  const hasGraph = graph.nodes.length > 0 && graph.edges.length > 0;
+  if (verbose) {
+    console.log(`  Skills loaded: ${skills.map((s) => s.slug).join(", ")}`);
+    if (hasGraph) {
+      console.log(`  Graph: ${graph.nodes.length} nodes, ${graph.edges.length} edges, ${graph.clusters.length} clusters`);
+    } else {
+      console.log(`  Graph: not built yet (run "helixevo graph --rebuild" for graph-aware evolution)`);
+    }
+    console.log();
+  }
   const stagnation = getStagnationCount();
   if (stagnation >= config.evolution.stopAfterNoImprovement) {
     console.log(`  ⚠ Stagnation detected (${stagnation} rounds with no improvement).`);
@@ -10408,7 +10477,7 @@ async function evolveCommand(options) {
 `);
   }
   console.log("  Step 1: Clustering failures...");
-  const clusterPrompt = buildClusterPrompt(batch, skills);
+  const clusterPrompt = buildClusterPrompt(batch, skills, hasGraph ? graph : undefined);
   const clusterResult = await chatJson({ prompt: clusterPrompt });
   const clusters = parseClusterOutput(clusterResult);
   console.log(`  → ${clusters.clusters.length} cluster(s) found
@@ -10436,7 +10505,10 @@ async function evolveCommand(options) {
     });
     const related = findRelatedProposals(relevantSkill?.slug ?? "", cluster.type);
     console.log("  Step 3: Generating proposal...");
-    const proposerPrompt = buildProposerPrompt(cluster.type, clusterFailures, relevantSkill, related);
+    const relatedSkillSlugs = hasGraph && relevantSkill ? graph.edges.filter((e) => e.from === relevantSkill.slug || e.to === relevantSkill.slug).map((e) => e.from === relevantSkill.slug ? e.to : e.from) : [];
+    const relatedSkillContents = relatedSkillSlugs.map((slug) => skills.find((s) => s.slug === slug)).filter((s) => s !== null);
+    const skillCluster = hasGraph ? graph.clusters.find((c) => c.skills.includes(relevantSkill?.slug ?? "")) : undefined;
+    const proposerPrompt = buildProposerPrompt(cluster.type, clusterFailures, relevantSkill, related, hasGraph ? { relatedSkills: relatedSkillContents, edges: graph.edges, cluster: skillCluster } : undefined);
     const proposalOutput = await chatJson({ prompt: proposerPrompt });
     if (verbose) {
       console.log(`    Action: ${proposalOutput.action}`);
@@ -10554,8 +10626,15 @@ async function evolveCommand(options) {
         if (evicted)
           console.log(`    Evicted: ${evicted.id} (score: ${evicted.score.toFixed(2)})`);
       }
+      if (proposalOutput.propagationSuggestions?.length) {
+        console.log(`  ↗ Propagation suggested to: ${proposalOutput.propagationSuggestions.join(", ")}`);
+        console.log("    (Run evolve again or generalize to apply these)");
+      }
     } else if (finalAccepted && dryRun) {
       console.log(`  [DRY RUN] Would apply: ${proposal.targetSkill}`);
+      if (proposalOutput.propagationSuggestions?.length) {
+        console.log(`  ↗ Would propagate to: ${proposalOutput.propagationSuggestions.join(", ")}`);
+      }
     }
     proposals.push(proposal);
     proposalCount++;
@@ -10569,7 +10648,25 @@ async function evolveCommand(options) {
     proposals
   };
   addIteration(iteration);
-  console.log("  Step 7: Network health assessment...");
+  if (hasGraph) {
+    const accepted2 = proposals.filter((p) => p.outcome === "accepted");
+    if (accepted2.length > 0) {
+      console.log("  Step 7: Updating skill graph...");
+      for (const p of accepted2) {
+        const node = graph.nodes.find((n) => n.id === p.targetSkill);
+        if (node) {
+          node.generation = generation;
+          node.score = (p.judges.taskCompletion.score + p.judges.correctionAlignment.score + p.judges.sideEffectCheck.score) / 30;
+          node.lastEvolved = new Date().toISOString();
+        }
+      }
+      graph.updated = new Date().toISOString();
+      saveSkillGraph(graph);
+      console.log(`  ✓ Graph updated (${accepted2.length} node(s) evolved)
+`);
+    }
+  }
+  console.log("  Step 8: Network health assessment...");
   const health = await assessNetworkHealth(verbose);
   if (verbose)
     printHealthReport(health);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "helixevo",
-  "version": "0.2.25",
+  "version": "0.2.27",
   "description": "Self-evolving skill ecosystem for AI agents. Skills and projects co-evolve through multi-judge evaluation and a Pareto frontier.",
   "type": "module",
   "bin": {