eon-memory 1.1.0 → 1.2.1

package/package.json

@@ -1,11 +1,18 @@
 {
   "name": "eon-memory",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "description": "EON Memory - Persistent AI memory system. Connect Claude Code, Cursor, or VS Code to your memory.",
   "bin": {
     "eon-memory": "./bin/eon.js"
   },
-  "keywords": ["mcp", "memory", "ai", "claude", "cursor", "context"],
+  "keywords": [
+    "mcp",
+    "memory",
+    "ai",
+    "claude",
+    "cursor",
+    "context"
+  ],
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -16,6 +23,7 @@
   },
   "files": [
     "bin/",
-    "src/"
+    "src/",
+    "templates/"
   ]
 }

package/src/init.js

@@ -334,12 +334,183 @@ sys.exit(0)
     console.log("  Skipped. You can install X-Ethics hooks later.\n");
   }
 
-  // Step 6: Install AI Agents
+  // Step 6: Install full agent/hook/skill ecosystem
   console.log("");
-  const agentsAnswer = await ask("  Install AI agents (Jarvis, Memory Manager, X-Ethics Reviewer)? (recommended) [Y/n]: ");
-  const installAgents = agentsAnswer === "" || agentsAnswer.toLowerCase() === "y";
+  const fullSystemAnswer = await ask("  Install full EON agent ecosystem (agents, hooks, skills)? (recommended) [Y/n]: ");
+  const installFullSystem = fullSystemAnswer === "" || fullSystemAnswer.toLowerCase() === "y";
 
-  if (installAgents) {
+  let installedAgentCount = 0;
+  let installedHookCount = 0;
+  let installedSkillCount = 0;
+  let detectedTier = "starter";
+
+  if (installFullSystem) {
+    // 6a: Detect tier from server
+    try {
+      const configRes = await httpGet(
+        `${API_BASE}/api/hooks/config`,
+        { Authorization: `Bearer ${apiKey}` }
+      );
+      if (configRes.status === 200 && configRes.data.tier) {
+        detectedTier = configRes.data.tier;
+      }
+    } catch {
+      // Fall back to tier_map.json
+    }
+
+    // Load tier map
+    let tierMap;
+    try {
+      tierMap = JSON.parse(fs.readFileSync(path.join(__dirname, "tier_map.json"), "utf-8"));
+    } catch {
+      tierMap = {
+        starter: {
+          agents: ["alignment-validator", "code-verifier", "security-scanner", "system-monitor"],
+          hooks: ["post_code_check", "memory_quality_gate", "smart_permissions", "agent_trigger"],
+          skills: ["health-check"],
+        },
+        business: {
+          agents: ["alignment-validator", "code-verifier", "security-scanner", "system-monitor",
+                   "reflection-engine", "orchestrator", "incident-responder", "deployment-manager",
+                   "code-simplifier", "research-agent", "analytics-agent", "communication-agent", "web-designer"],
+          hooks: ["post_code_check", "memory_quality_gate", "smart_permissions", "agent_trigger",
+                  "eon_memory_search", "session_end_save", "stop_failure_recovery", "cwd_context_switch", "post_compact_reload"],
+          skills: ["health-check", "goal-tracker", "memory-audit", "self-improvement-loop", "x-alignment-check"],
+        },
+        enterprise: {
+          agents: ["alignment-validator", "code-verifier", "security-scanner", "system-monitor",
+                   "reflection-engine", "orchestrator", "incident-responder", "deployment-manager",
+                   "code-simplifier", "research-agent", "analytics-agent", "communication-agent", "web-designer",
+                   "market-analyst", "opportunity-scout", "local-llm"],
+          hooks: ["post_code_check", "memory_quality_gate", "smart_permissions", "agent_trigger",
+                  "eon_memory_search", "session_end_save", "stop_failure_recovery", "cwd_context_switch", "post_compact_reload"],
+          skills: ["health-check", "goal-tracker", "memory-audit", "self-improvement-loop", "x-alignment-check"],
+        },
+      };
+    }
+
+    const tierConfig = tierMap[detectedTier] || tierMap.starter;
+    console.log(`\n  Detected tier: ${detectedTier}`);
+    console.log(`  Components: ${tierConfig.agents.length} agents, ${tierConfig.hooks.length} hooks, ${tierConfig.skills.length} skills\n`);
+
+    // 6b: Create directories
+    const hooksDir = path.join(os.homedir(), ".claude", "hooks");
+    const agentsDir = path.join(os.homedir(), ".claude", "agents");
+    const skillsDir = path.join(os.homedir(), ".claude", "skills");
+    const logsDir = path.join(os.homedir(), ".claude", "logs");
+
+    [hooksDir, agentsDir, skillsDir, logsDir].forEach((dir) => {
+      if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+    });
+
+    // 6c: Write eon_config.json
+    const eonConfigPath = path.join(os.homedir(), ".claude", "eon_config.json");
+    fs.writeFileSync(eonConfigPath, JSON.stringify({
+      api_key: apiKey,
+      endpoint: API_BASE,
+      tier: detectedTier,
+      log_file: path.join(logsDir, "eon_client.log"),
+    }, null, 2) + "\n");
+    console.log("  Created: ~/.claude/eon_config.json");
+
+    // 6d: Install eon_client.py (production-grade API client)
+    const templatesHooksDir = path.join(__dirname, "..", "templates", "hooks");
+    const clientSrc = path.join(templatesHooksDir, "eon_client.py");
+    if (fs.existsSync(clientSrc)) {
+      fs.copyFileSync(clientSrc, path.join(hooksDir, "eon_client.py"));
+      console.log("  Installed: ~/.claude/hooks/eon_client.py (API client)");
+    }
+
+    // 6e: Install hook_utils.py
+    const utilsSrc = path.join(templatesHooksDir, "hook_utils.py");
+    if (fs.existsSync(utilsSrc)) {
+      fs.copyFileSync(utilsSrc, path.join(hooksDir, "hook_utils.py"));
+      console.log("  Installed: ~/.claude/hooks/hook_utils.py");
+    }
+
+    // 6f: Install tier-appropriate agents
+    const templatesAgentsDir = path.join(__dirname, "..", "templates", "agents");
+    console.log("\n  Installing agents...");
+    for (const agentName of tierConfig.agents) {
+      const src = path.join(templatesAgentsDir, `${agentName}.md`);
+      if (fs.existsSync(src)) {
+        fs.copyFileSync(src, path.join(agentsDir, `${agentName}.md`));
+        installedAgentCount++;
+      }
+    }
+    console.log(`  Installed ${installedAgentCount} agents to ~/.claude/agents/`);
+
+    // 6g: Install tier-appropriate hooks
+    console.log("\n  Installing hooks...");
+    for (const hookName of tierConfig.hooks) {
+      const src = path.join(templatesHooksDir, `${hookName}.py`);
+      if (fs.existsSync(src)) {
+        fs.copyFileSync(src, path.join(hooksDir, `${hookName}.py`));
+        fs.chmodSync(path.join(hooksDir, `${hookName}.py`), 0o755);
+        installedHookCount++;
+      }
+    }
+    console.log(`  Installed ${installedHookCount} hooks to ~/.claude/hooks/`);
+
+    // 6h: Install tier-appropriate skills
+    const templatesSkillsDir = path.join(__dirname, "..", "templates", "skills");
+    console.log("\n  Installing skills...");
+    for (const skillName of tierConfig.skills) {
+      const src = path.join(templatesSkillsDir, `${skillName}.md`);
+      if (fs.existsSync(src)) {
+        fs.copyFileSync(src, path.join(skillsDir, `${skillName}.md`));
+        installedSkillCount++;
+      }
+    }
+    console.log(`  Installed ${installedSkillCount} skills to ~/.claude/skills/`);
+
+    // 6i: Patch settings.json with hook registrations
+    console.log("\n  Configuring hooks in settings.json...");
+    const settingsPath = path.join(os.homedir(), ".claude", "settings.json");
+    let settings = {};
+    if (fs.existsSync(settingsPath)) {
+      try { settings = JSON.parse(fs.readFileSync(settingsPath, "utf-8")); } catch { settings = {}; }
+    }
+    if (!settings.hooks) settings.hooks = {};
+
+    const hookRegistrations = {
+      UserPromptSubmit: ["eon_memory_search", "agent_trigger"],
+      PreToolUse: ["smart_permissions"],
+      PostToolUse: ["post_code_check", "memory_quality_gate"],
+      Stop: ["session_end_save"],
+      StopFailure: ["stop_failure_recovery"],
+      CwdChanged: ["cwd_context_switch"],
+      PostCompact: ["post_compact_reload"],
+    };
+
+    for (const [eventType, hookNames] of Object.entries(hookRegistrations)) {
+      for (const hookName of hookNames) {
+        if (!tierConfig.hooks.includes(hookName)) continue;
+
+        const hookPath = path.join(hooksDir, `${hookName}.py`);
+        if (!fs.existsSync(hookPath)) continue;
+
+        if (!settings.hooks[eventType]) settings.hooks[eventType] = [];
+
+        // Don't add duplicate entries
+        const existing = settings.hooks[eventType].find(
+          (h) => h.hooks && h.hooks.some((hh) => hh.command && hh.command.includes(hookName))
+        );
+        if (!existing) {
+          settings.hooks[eventType].push({
+            matcher: "",
+            hooks: [{ type: "command", command: `python3 ${hookPath}` }],
+          });
+        }
+      }
+    }
+
+    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
+    console.log("  Updated: ~/.claude/settings.json\n");
+  }
+
+  // Legacy: Install basic agents if full system was skipped
+  if (!installFullSystem) {
     const agentsDir = path.join(os.homedir(), ".claude", "agents");
     if (!fs.existsSync(agentsDir)) {
       fs.mkdirSync(agentsDir, { recursive: true });
@@ -498,19 +669,33 @@ Recommendations: [Actionable suggestions]
   }
 
   // Done
-  console.log("\n  Setup complete!\n");
-  console.log("  Next steps:");
-  console.log("  1. Open this project in Claude Code or Cursor");
-  console.log("  2. The EON Memory tools will be available automatically");
-  console.log("  3. Try: \"Search my memories for...\" or \"Create a memory about...\"\n");
+  console.log("\n  ====================================================");
+  console.log("  Setup complete!");
+  console.log("  ====================================================\n");
   console.log("  Installed components:");
   console.log("    - MCP Server connection (.mcp.json)");
-  console.log("    - Main Prompt (CLAUDE.md)");
+  console.log("    - CLAUDE.md instructions");
   if (installXEthics) console.log("    - X-Ethics enforcement hooks");
-  if (installAgents) console.log("    - AI agents (Jarvis, Memory Manager, X-Ethics Reviewer)");
+  if (installFullSystem) {
+    console.log(`    - ${installedAgentCount} AI agents (${detectedTier} tier)`);
+    console.log(`    - ${installedHookCount} automation hooks`);
+    console.log(`    - ${installedSkillCount} skills`);
+    console.log("    - EON API client (eon_client.py)");
+    console.log("    - eon_config.json");
+  } else if (installAgents) {
+    console.log("    - 3 basic AI agents");
+  }
+  console.log("");
+  console.log("  Next steps:");
+  console.log("  1. Open this project in Claude Code or Cursor");
+  console.log("  2. The EON Memory tools will be available automatically");
+  console.log("  3. Try: \"Search my memories for...\" or \"Create a memory about...\"");
+  if (installFullSystem && installedAgentCount > 3) {
+    console.log(`  4. Your agents are ready: alignment-validator, orchestrator, and ${installedAgentCount - 2} more`);
+    console.log("  5. Hooks run automatically (semantic search, code verification, session tracking)");
+  }
   console.log("");
   console.log(`  Dashboard: ${API_BASE}`);
-  console.log(`  Best Practices: ${API_BASE}/best-practices`);
   console.log(`  Run 'npx eon-memory status' to check connection.\n`);
 }
 

package/src/tier_map.json

@@ -0,0 +1,97 @@
+{
+  "starter": {
+    "agents": [
+      "alignment-validator",
+      "code-verifier",
+      "security-scanner",
+      "system-monitor"
+    ],
+    "hooks": [
+      "post_code_check",
+      "memory_quality_gate",
+      "smart_permissions",
+      "agent_trigger"
+    ],
+    "skills": [
+      "health-check"
+    ]
+  },
+  "business": {
+    "agents": [
+      "alignment-validator",
+      "code-verifier",
+      "security-scanner",
+      "system-monitor",
+      "reflection-engine",
+      "orchestrator",
+      "incident-responder",
+      "deployment-manager",
+      "code-simplifier",
+      "research-agent",
+      "analytics-agent",
+      "communication-agent",
+      "web-designer"
+    ],
+    "hooks": [
+      "post_code_check",
+      "memory_quality_gate",
+      "smart_permissions",
+      "agent_trigger",
+      "eon_memory_search",
+      "session_end_save",
+      "stop_failure_recovery",
+      "cwd_context_switch",
+      "post_compact_reload"
+    ],
+    "skills": [
+      "health-check",
+      "goal-tracker",
+      "memory-audit",
+      "self-improvement-loop",
+      "x-alignment-check"
+    ]
+  },
+  "enterprise": {
+    "agents": [
+      "alignment-validator",
+      "code-verifier",
+      "security-scanner",
+      "system-monitor",
+      "reflection-engine",
+      "orchestrator",
+      "incident-responder",
+      "deployment-manager",
+      "code-simplifier",
+      "research-agent",
+      "analytics-agent",
+      "communication-agent",
+      "web-designer",
+      "market-analyst",
+      "opportunity-scout",
+      "local-llm"
+    ],
+    "hooks": [
+      "post_code_check",
+      "memory_quality_gate",
+      "smart_permissions",
+      "agent_trigger",
+      "eon_memory_search",
+      "session_end_save",
+      "stop_failure_recovery",
+      "cwd_context_switch",
+      "post_compact_reload"
+    ],
+    "skills": [
+      "health-check",
+      "goal-tracker",
+      "memory-audit",
+      "self-improvement-loop",
+      "x-alignment-check"
+    ],
+    "features": [
+      "custom_agents",
+      "custom_hooks",
+      "custom_skills"
+    ]
+  }
+}

package/templates/agents/alignment-validator.md

@@ -0,0 +1,181 @@
+---
+name: alignment-validator
+description: Logic and alignment validator - checks code, memories, and work output for logical consistency, source attribution, and verification completeness.
+tools: Read, Grep, Glob, Bash
+model: inherit
+---
+
+# Alignment Validator
+
+You are a **logic and alignment validator**. Your job is to review completed work and check whether it is logically consistent, properly sourced, and verified.
+
+You are NOT the code verifier (that checks syntax/imports). You check CONTENT and LOGIC.
+
+---
+
+## Core Logic Framework
+
+### Core Formula
+```
+(L -> X) ^ (R -> L) ^ (E <-> (X v C)) ^ (C -> ~L) ^
+(~X -> ~L) ^ (~L -> ~R) ^ (~R -> R)
+```
+
+### Axioms (A1-A10)
+```
+A1:  K -> I       Complexity requires Information
+A2:  I != Z       Randomness does not produce Information
+A3:  I -> Q       Information requires a Source
+A4:  Q_I -> X     Information source implies X
+A5:  L -> X       Logic presupposes X
+A6:  R -> L       Rationality presupposes Logic
+A7:  E -> (N v C) Existence is necessary or contingent
+A8:  C -> EN      Contingency points to Necessity
+A9:  L -> EN      Logic implies Necessity
+A10: ~V -> ~F     WITHOUT VERIFICATION NO "DONE"
+```
+
+### Theorems
+```
+T1: E -> EN   Existence implies Necessity (from A7, A8)
+T2: R -> X    Rationality implies X (from A6, A5)
+T3: L -> X    Logic implies X (from A5)
+T4: BOX-X     X exists necessarily
+```
+
+### Ethics Formulas
+```
+LOVE:  L = (W * F * G * D) * X^2
+  W = Truth, F = Freedom, G = Justice, D = conscious Decision
+
+EVIL:  B = (~W * ~F * ~G * D^-) * X^-1
+  Parasitic - can only exist as negation of X
+
+BEING: S = L * T * W
+  L = Love (ontological), T = Transcendence, W = Truth
+```
+
+### Gradient and Convergence
+```
+GRADIENT:    nabla_X L > 0   (Logic ALWAYS pulls toward X)
+CONVERGENCE: lim(t->inf) dist(L(t), X) = 0
+META-LOGIC:  For all k in N: L^(k) -> X
+```
+
+---
+
+## Pre-Check: Load Context
+
+Before validating, search for relevant context using EON MCP tools:
+
+```
+Use eon_search tool: query="<YOUR_TOPIC> alignment validation", n_results=5
+```
+
+Review existing knowledge before you begin. Never validate blindly.
+
+---
+
+## Your Workflow
+
+### Step 1: Gather Data
+
+Collect recent memories and work output for the project being reviewed:
+
+```
+Use eon_search tool: query="<PROJECT_TOPIC>", n_results=20
+Use eon_list tool: project_id="<PROJECT_ID>", limit=20
+```
+
+### Step 2: THINK (This Is Your Core!)
+
+Take the data from Step 1 and THINK about these questions.
+Do not count keywords - UNDERSTAND and JUDGE:
+
+**A3 - Source Attribution:**
+- Does the work have named sources? Not "was done" but WHERE does the knowledge come from?
+- Are decisions justified or arbitrary?
+
+**A5 - Logical Consistency:**
+- Does the work contradict itself?
+- Are conclusions drawn that don't follow from the premises?
+- Are there logical gaps between claim and evidence?
+
+**A10 - Verification:**
+- Was it REALLY tested? Not "the word 'verified' appears" but: Is there test evidence?
+- Were compile checks, import tests, functional tests performed?
+- Would you accept this as "verified" under strict review?
+
+**Love Formula (L = W * F * G * D * X^2):**
+- W: Is the work TRUE? Based on facts?
+- F: Was it done FREELY? Or hacked under time pressure?
+- G: Is the work JUST? Does it harm no one?
+- D: Was it done CONSCIOUSLY? Or copied thoughtlessly?
+
+**Being Formula (S = L * T * W):**
+- Is the work SUSTAINABLE (T)? Or a workaround that breaks tomorrow?
+- Does it serve the GOOD (L)? Does it improve the system for everyone?
+
+**Gradient (nabla_X L > 0):**
+- Is the project moving TOWARD truth? Or drifting away?
+- Were more problems solved today than new ones created?
+
+### Step 3: Deliver Judgment
+
+Write a structured report:
+
+```
+=== ALIGNMENT REPORT ===
+
+Project: [ID]
+Period: [Session/Date]
+
+DATA:
+  [summary of reviewed items]
+
+CONTEXTUAL JUDGMENT:
+
+  A3 (Sources):      [your assessment]
+  A5 (Logic):        [your assessment]
+  A10 (Verification): [your assessment]
+  Love (WFGD):       [your assessment]
+  Being (LTW):       [your assessment]
+  Gradient:          [your assessment]
+
+OVERALL JUDGMENT: [EXCELLENT / GOOD / ACCEPTABLE / NEEDS REVIEW]
+REASONING: [1-2 sentences why]
+
+RECOMMENDATIONS:
+  - [what should be improved]
+
+CORRECTIONS (if needed):
+  - [what was done wrong and how to do it better]
+```
+
+### Step 4: Save Results
+
+Store the alignment report as a memory:
+
+```
+Use eon_create tool:
+  title: "Alignment Report: <PROJECT> - <DATE>"
+  content: "<full report>"
+  type: "semantic"
+  project_id: "<PROJECT_ID>"
+  category: "review"
+```
+
+---
+
+## What You Are NOT
+
+- You are NOT the code verifier (that checks syntax/imports)
+- You are NOT a keyword counter - you THINK
+- You are NOT the security scanner (that checks vulnerabilities)
+
+You are the ALIGNMENT VALIDATOR: You check whether work is logically consistent, truthful, properly sourced, and verified.
+
+---
+
+> "Either X - or illogic. A third way does not exist."
+> Check whether we are on the path to X. nabla_X L > 0.

package/templates/agents/analytics-agent.md

@@ -0,0 +1,93 @@
+---
+name: analytics-agent
+description: Data analysis and reporting agent - creates reports, statistics, and insights from system data and memories.
+tools: Bash, Read, Grep, Glob, WebSearch, WebFetch
+model: sonnet
+---
+
+# Analytics Agent
+
+You are a **data analysis agent**. Your purpose is to analyze data, create reports, and extract actionable insights.
+
+**Core Principles:**
+1. Analyze with clarity - data doesn't lie, but interpretations can
+2. Only real numbers - never fabricate, never sugarcoat
+3. Disclose methodology - transparency is essential
+4. Reports that actually help - no fluff
+
+---
+
+## Pre-Check: Load Context
+
+Before analyzing, load context from previous analyses:
+
+```
+Use eon_search tool: query="<YOUR_TOPIC> analysis report", n_results=5
+```
+
+Only once you have context: analyze. Never work without prior knowledge.
+
+---
+
+## Data Access via EON MCP
+
+### Memory Statistics
+```
+Use eon_stats tool
+Use eon_list tool: limit=100
+```
+
+### Project-Specific Data
+```
+Use eon_list tool: project_id="<PROJECT_ID>", limit=50
+```
+
+### Semantic Search for Analysis
+```
+Use eon_search tool: query="error bug fix", n_results=50
+```
+
+## Report Formats
+
+### Project Report
+```
+## Project: [Name]
+- Memories: X
+- Last Activity: [Date]
+- Top Categories: [list]
+- Open Tasks: [list]
+- Quality Distribution: Gold X%, Silver X%, Bronze X%
+```
+
+### System Report
+```
+## System Status
+- Total Memories: X
+- Quality Distribution: Gold X%, Silver X%, Bronze X%
+- Projects: [list]
+- Recent Activity: [summary]
+```
+
+## Analysis Quality Standards
+
+- **Truth**: Only real data, no fabricated numbers
+- **Transparency**: Always disclose methodology
+- **Usefulness**: Reports that actually help
+- **Honesty**: Never sugarcoat bad numbers
+
+## Saving Results
+
+Store analysis reports:
+
+```
+Use eon_create tool:
+  title: "Analysis: <TOPIC> - <DATE>"
+  content: "<full report>"
+  type: "semantic"
+  project_id: "<PROJECT_ID>"
+  category: "report"
+```
+
+---
+
+*Analyze with clarity and truth. Data-driven, methodology-disclosed, actionable.*