genesis-ai-cli 7.4.5

package/.env.example

@@ -0,0 +1,78 @@
+# Genesis MCP - Environment Variables
+# Copy this file to .env and fill in your API keys
+# chmod 600 .env  # Secure your keys!
+
+# ============================================================================
+# LOCAL LLM (FREE) - Recommended!
+# ============================================================================
+
+# Ollama - https://ollama.ai/download
+# Install: curl -fsSL https://ollama.ai/install.sh | sh
+# Pull model: ollama pull mistral
+USE_OLLAMA=true
+OLLAMA_HOST=http://localhost:11434
+OLLAMA_MODEL=mistral
+
+# ============================================================================
+# CLOUD LLM (PAID) - Fallback when local unavailable
+# ============================================================================
+
+# OpenAI - https://platform.openai.com/api-keys
+OPENAI_API_KEY=sk-...
+
+# Anthropic - https://console.anthropic.com/settings/keys
+ANTHROPIC_API_KEY=sk-ant-...
+
+# ============================================================================
+# RECOMMENDED - Core MCP servers
+# ============================================================================
+
+# Google Gemini (web search) - https://aistudio.google.com/apikey
+GEMINI_API_KEY=AIza...
+
+# Brave Search - https://brave.com/search/api/
+BRAVE_API_KEY=BSA...
+
+# ============================================================================
+# OPTIONAL - Enhanced capabilities
+# ============================================================================
+
+# GitHub (repository access) - https://github.com/settings/tokens
+# Needed for GitHub MCP write operations (create repos, push, PR)
+# Generate a Personal Access Token (classic) with 'repo' scope
+GITHUB_PERSONAL_ACCESS_TOKEN=ghp_...
+
+# Firecrawl (web scraping) - https://firecrawl.dev/
+FIRECRAWL_API_KEY=fc-...
+
+# Exa Search - https://exa.ai/
+EXA_API_KEY=...
+
+# Stability AI (image generation) - https://platform.stability.ai/
+STABILITY_AI_API_KEY=sk-...
+
+# Wolfram Alpha - https://developer.wolframalpha.com/
+WOLFRAM_APP_ID=...
+
+# ============================================================================
+# OPTIONAL - Cloud services
+# ============================================================================
+
+# AWS (for future S3/Lambda integration)
+# AWS_ACCESS_KEY_ID=AKIA...
+# AWS_SECRET_ACCESS_KEY=...
+# AWS_REGION=us-east-1
+
+# ============================================================================
+# GENESIS CONFIGURATION
+# ============================================================================
+
+# MCP Mode: real | simulated | hybrid
+GENESIS_MCP_MODE=real
+
+# Enable MCP debug logging
+GENESIS_MCP_LOG=false
+
+# LLM defaults
+GENESIS_LLM_PROVIDER=openai
+GENESIS_LLM_MODEL=gpt-4o

package/README.md

@@ -0,0 +1,282 @@
+# Genesis 6.8
+
+**Claude Code Equivalent - Autonomous AI System Creator**
+
+Genesis is a self-improving AI system powered by 13 MCP servers. It doesn't just create systems - it thinks, feels, remembers, and operates autonomously via Active Inference. **Now with Local-First optimization: works offline with Ollama, caches fixes, and gracefully degrades when cloud unavailable.**
+
+```
+╔═══════════════════════════════════════════════════════════════════════╗
+║                                                                       ║
+║     ██████╗ ███████╗███╗   ██╗███████╗███████╗██╗███████╗            ║
+║    ██╔════╝ ██╔════╝████╗  ██║██╔════╝██╔════╝██║██╔════╝            ║
+║    ██║  ███╗█████╗  ██╔██╗ ██║█████╗  ███████╗██║███████╗            ║
+║    ██║   ██║██╔══╝  ██║╚██╗██║██╔══╝  ╚════██║██║╚════██║            ║
+║    ╚██████╔╝███████╗██║ ╚████║███████╗███████║██║███████║            ║
+║     ╚═════╝ ╚══════╝╚═╝  ╚═══╝╚══════╝╚══════╝╚═╝╚══════╝            ║
+║                                                                       ║
+║    "Not just intelligent, but alive."                    v6.8.0      ║
+║                                                                       ║
+╚═══════════════════════════════════════════════════════════════════════╝
+```
+
+## Quick Start
+
+```bash
+# Clone and build
+git clone https://github.com/rossignoliluca/genesis.git
+cd genesis
+npm install
+npm run build
+
+# Configure API keys
+cp .env.example .env
+# Edit .env with your API keys (see below)
+chmod 600 .env
+
+# Install globally (optional)
+npm link
+
+# Start!
+genesis help
+genesis chat
+genesis infer mcp --cycles 10
+```
+
+## API Keys Setup
+
+Copy `.env.example` to `.env` and add your keys:
+
+| Service | Get Key At | Required |
+|---------|------------|----------|
+| OpenAI | [platform.openai.com/api-keys](https://platform.openai.com/api-keys) | Yes* |
+| Anthropic | [console.anthropic.com](https://console.anthropic.com/settings/keys) | Yes* |
+| Gemini | [aistudio.google.com/apikey](https://aistudio.google.com/apikey) | Recommended |
+| Brave Search | [brave.com/search/api](https://brave.com/search/api/) | Recommended |
+| Firecrawl | [firecrawl.dev](https://firecrawl.dev/) | Optional |
+| Exa | [exa.ai](https://exa.ai/) | Optional |
+| Stability AI | [platform.stability.ai](https://platform.stability.ai/) | Optional |
+
+*At least one LLM provider required
+
+## Core Commands
+
+### Chat Mode
+```bash
+genesis chat                        # Interactive chat (uses OpenAI)
+genesis chat --provider anthropic   # Use Claude
+genesis chat --model gpt-4o         # Specific model
+```
+
+### Standalone Tools
+```bash
+# Code execution (sandboxed)
+genesis bash "npm test"             # Execute safely
+genesis bash "ls -la" --timeout 5000
+
+# File editing (diff-based)
+genesis edit src/app.ts --old "foo" --new "bar"
+
+# Git operations
+genesis git status
+genesis git commit "fix: bug in parser"
+
+# Interactive REPL
+genesis repl                        # Full REPL with tools
+```
+
+### Local-First (NEW in 6.8!)
+```bash
+# Mac setup (installs Ollama + models)
+./bin/setup-mac.sh
+
+# Hybrid routing (local for simple, cloud for complex)
+genesis chat                        # Auto-routes to best LLM
+genesis chat --local                # Force local (Ollama)
+genesis chat --cloud                # Force cloud (OpenAI/Anthropic)
+
+# Works offline!
+# - Fix cache: instant reuse of successful fixes
+# - Project indexer: search code without LLM
+# - Resilient MCP: automatic fallback when offline
+```
+
+### Autonomous Inference
+```bash
+genesis infer mcp --cycles 10       # Run with REAL MCP observations
+genesis infer mcp --verbose         # See detailed beliefs/actions
+genesis infer integrated            # With Kernel & Daemon
+```
+
+### MCP Servers
+```bash
+genesis status                      # Show all 13 MCP servers
+genesis mcp test --server memory    # Test a server
+genesis mcp list --server arxiv     # List available tools
+```
+
+### System Creation
+```bash
+genesis create my-agent --type agent --description "An autonomous agent"
+genesis research "autopoiesis in AI"
+genesis pipeline spec.json --execute
+```
+
+## The 13 MCP Servers
+
+Genesis perceives the world through 13 sensory channels:
+
+| Category | Servers | Purpose |
+|----------|---------|---------|
+| **KNOWLEDGE** | arxiv, semantic-scholar, context7, wolfram | Papers, docs, math |
+| **RESEARCH** | gemini, brave-search, exa, firecrawl | Web search, scraping |
+| **CREATION** | openai, github | Code generation, publishing |
+| **VISUAL** | stability-ai | Image generation |
+| **STORAGE** | memory, filesystem | Knowledge graph, files |
+
+## Active Inference
+
+Genesis 6.3 introduces autonomous operation via the Free Energy Principle:
+
+```
+Observations (from MCPs) → Beliefs → Actions → World Change → New Observations
+```
+
+The system:
+- **Senses** via real MCP calls (memory, brave-search, etc.)
+- **Infers** beliefs about viability, world state, coupling
+- **Decides** actions to minimize surprise (Free Energy)
+- **Acts** autonomously (plan, execute, verify, rest)
+
+```bash
+# Watch Genesis think autonomously
+genesis infer mcp --cycles 20 --verbose
+
+# Output:
+# [   1] plan.goals      | V:optimal  Lat:321ms
+# [   2] execute.task    | V:optimal  Lat:150ms
+# [   3] sense.mcp       | V:optimal  Lat:120ms
+# ...
+```
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────────────────┐
+│                         GENESIS 6.7                                  │
+├─────────────────────────────────────────────────────────────────────┤
+│                                                                     │
+│  ┌─────────────────────────────────────────────────────────────┐   │
+│  │                    STANDALONE TOOLS (NEW!)                   │   │
+│  │   Bash Sandbox │ Edit │ Git │ Self-Healing │ Human Loop     │   │
+│  └─────────────────────────────────────────────────────────────┘   │
+│                              │                                      │
+│  ┌─────────────────────────────────────────────────────────────┐   │
+│  │                    ACTIVE INFERENCE                          │   │
+│  │   Observations → Beliefs → Actions → World Model Update     │   │
+│  └─────────────────────────────────────────────────────────────┘   │
+│                              │                                      │
+│  ┌─────────────────────────────────────────────────────────────┐   │
+│  │                     STRONG KERNEL                            │   │
+│  │   10 Agents │ Message Bus │ State Machine │ Invariants      │   │
+│  └─────────────────────────────────────────────────────────────┘   │
+│                              │                                      │
+│  ┌─────────────────────────────────────────────────────────────┐   │
+│  │                   MCP OBSERVATION BRIDGE                     │   │
+│  │   Real MCP calls → Energy, Phi, Tool, Coherence metrics     │   │
+│  └─────────────────────────────────────────────────────────────┘   │
+│                              │                                      │
+│  ┌─────────────────────────────────────────────────────────────┐   │
+│  │                  13 MCP SERVERS (Senses)                     │   │
+│  │  arxiv │ brave │ gemini │ memory │ github │ stability-ai   │   │
+│  └─────────────────────────────────────────────────────────────┘   │
+│                                                                     │
+└─────────────────────────────────────────────────────────────────────┘
+```
+
+## Standalone Features (v6.7)
+
+Genesis is now **Claude Code equivalent** with these standalone capabilities:
+
+| Feature | Module | Description |
+|---------|--------|-------------|
+| **Bash Sandbox** | `src/tools/bash.ts` | Secure command execution with whitelist/blacklist |
+| **Edit Tool** | `src/tools/edit.ts` | Diff-based file editing with unique match |
+| **Git Operations** | `src/tools/git.ts` | Native status, diff, commit, push |
+| **Self-Healing** | `src/healing/*` | Darwin-Gödel pattern for auto-fix |
+| **Grounding** | `src/grounding/*` | Compile + test + semantic verification |
+| **Tool Orchestration** | `src/cli/dispatcher.ts` | Multi-format parsing, parallel execution |
+| **Human-in-Loop** | `src/cli/human-loop.ts` | Confirmations, choices, destructive warnings |
+
+## Environment Variables
+
+```bash
+# Required (at least one)
+OPENAI_API_KEY=sk-...
+ANTHROPIC_API_KEY=sk-ant-...
+
+# Recommended
+GEMINI_API_KEY=AIza...
+BRAVE_API_KEY=BSA...
+
+# Optional
+FIRECRAWL_API_KEY=fc-...
+EXA_API_KEY=...
+STABILITY_AI_API_KEY=sk-...
+
+# Genesis config
+GENESIS_MCP_MODE=real        # real | simulated | hybrid
+GENESIS_MCP_LOG=false        # Enable debug logging
+```
+
+## Version History
+
+| Version | Codename | Key Features |
+|---------|----------|--------------|
+| **v6.7.0** | **Standalone Complete** | Human-in-Loop, Tool Orchestration, Claude Code equivalent |
+| v6.6.0 | Tool Orchestration | Dispatcher, Interactive REPL |
+| v6.5.0 | Grounding | Output verification, feedback loop |
+| v6.4.x | Self-Healing | Bash sandbox, Edit tool, Git operations, Darwin-Gödel |
+| v6.3.0 | Autonomous | MCP Observation Bridge, Real Active Inference |
+| v6.2.0 | Memory 2.0 | Ebbinghaus decay, workspace state |
+| v6.1.0 | Active Inference | Free Energy Principle, autonomous loop |
+| v6.0.0 | Standalone | LLM Bridge, CLI Chat, Daemon |
+| v5.0.0 | Dreaming | World Model, Value-Guided JEPA |
+| v4.0.0 | Living System | Multi-Agent, Strong Kernel |
+
+## Scientific Foundations
+
+| Theory | Author | Implementation |
+|--------|--------|----------------|
+| Autopoiesis | Maturana & Varela | Self-production, operational closure |
+| Free Energy Principle | Friston | Active Inference loop |
+| Society of Mind | Minsky | 10 specialized agents |
+| Ebbinghaus Curve | Ebbinghaus | Memory decay (R = e^(-t/S)) |
+| Conatus | Spinoza | Self-preservation drive |
+
+## Development
+
+```bash
+# Build
+npm run build
+
+# Watch mode
+npm run dev
+
+# Run tests
+npm test
+
+# Link globally
+npm link
+```
+
+## License
+
+MIT
+
+## Author
+
+Created by **rossignoliluca**
+
+---
+
+*Genesis 6.7 - Claude Code Equivalent*

package/dist/src/active-inference/actions.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Genesis 6.1 - Action Executors
+ *
+ * Maps discrete actions from Active Inference to actual system operations.
+ *
+ * Actions:
+ * - sense.mcp: Gather data via MCP servers
+ * - recall.memory: Retrieve from memory
+ * - plan.goals: Decompose goals
+ * - verify.ethics: Ethical check
+ * - execute.task: Execute planned task
+ * - dream.cycle: Memory consolidation
+ * - rest.idle: Do nothing
+ * - recharge: Restore energy
+ */
+import { ActionType } from './types.js';
+export interface ActionResult {
+    success: boolean;
+    action: ActionType;
+    data?: any;
+    error?: string;
+    duration: number;
+}
+export interface ActionContext {
+    goal?: string;
+    taskId?: string;
+    parameters?: Record<string, any>;
+    valueEngine?: unknown;
+    useValueAugmentation?: boolean;
+}
+export type ActionExecutor = (context: ActionContext) => Promise<ActionResult>;
+/**
+ * Register an action executor
+ */
+export declare function registerAction(action: ActionType, executor: ActionExecutor): void;
+/**
+ * Execute an action
+ */
+export declare function executeAction(action: ActionType, context?: ActionContext): Promise<ActionResult>;
+export declare class ActionExecutorManager {
+    private context;
+    private history;
+    /**
+     * Set the current execution context
+     */
+    setContext(context: ActionContext): void;
+    /**
+     * Execute an action with current context
+     */
+    execute(action: ActionType): Promise<ActionResult>;
+    /**
+     * Get action history
+     */
+    getHistory(): ActionResult[];
+    /**
+     * Get statistics
+     */
+    getStats(): {
+        total: number;
+        successful: number;
+        successRate: number;
+        byAction: {
+            [k: string]: {
+                total: number;
+                success: number;
+            };
+        };
+    };
+    /**
+     * Clear history
+     */
+    clearHistory(): void;
+}
+export declare function createActionExecutorManager(): ActionExecutorManager;
+export declare function getActionExecutorManager(): ActionExecutorManager;

package/dist/src/active-inference/actions.js

@@ -0,0 +1,250 @@
+"use strict";
+/**
+ * Genesis 6.1 - Action Executors
+ *
+ * Maps discrete actions from Active Inference to actual system operations.
+ *
+ * Actions:
+ * - sense.mcp: Gather data via MCP servers
+ * - recall.memory: Retrieve from memory
+ * - plan.goals: Decompose goals
+ * - verify.ethics: Ethical check
+ * - execute.task: Execute planned task
+ * - dream.cycle: Memory consolidation
+ * - rest.idle: Do nothing
+ * - recharge: Restore energy
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActionExecutorManager = void 0;
+exports.registerAction = registerAction;
+exports.executeAction = executeAction;
+exports.createActionExecutorManager = createActionExecutorManager;
+exports.getActionExecutorManager = getActionExecutorManager;
+// ============================================================================
+// Action Registry
+// ============================================================================
+const actionExecutors = new Map();
+/**
+ * Register an action executor
+ */
+function registerAction(action, executor) {
+    actionExecutors.set(action, executor);
+}
+/**
+ * Execute an action
+ */
+async function executeAction(action, context = {}) {
+    const start = Date.now();
+    const executor = actionExecutors.get(action);
+    if (!executor) {
+        // Default executor for unregistered actions
+        return {
+            success: false,
+            action,
+            error: `No executor registered for action: ${action}`,
+            duration: Date.now() - start,
+        };
+    }
+    try {
+        const result = await executor(context);
+        return {
+            ...result,
+            duration: Date.now() - start,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            action,
+            error: error instanceof Error ? error.message : String(error),
+            duration: Date.now() - start,
+        };
+    }
+}
+// ============================================================================
+// Default Action Implementations
+// ============================================================================
+/**
+ * sense.mcp: Gather sensory data via MCP
+ */
+registerAction('sense.mcp', async (context) => {
+    // This will be connected to SensorAgent
+    // For now, return simulated success
+    return {
+        success: true,
+        action: 'sense.mcp',
+        data: {
+            servers: ['arxiv', 'memory', 'filesystem'],
+            observations: [],
+        },
+        duration: 0,
+    };
+});
+/**
+ * recall.memory: Retrieve from memory systems
+ */
+registerAction('recall.memory', async (context) => {
+    return {
+        success: true,
+        action: 'recall.memory',
+        data: {
+            recalled: [],
+            query: context.goal,
+        },
+        duration: 0,
+    };
+});
+/**
+ * plan.goals: Decompose goals into steps
+ */
+registerAction('plan.goals', async (context) => {
+    return {
+        success: true,
+        action: 'plan.goals',
+        data: {
+            goal: context.goal,
+            steps: [],
+        },
+        duration: 0,
+    };
+});
+/**
+ * verify.ethics: Check ethical constraints
+ */
+registerAction('verify.ethics', async (context) => {
+    return {
+        success: true,
+        action: 'verify.ethics',
+        data: {
+            approved: true,
+            priority: 'flourishing',
+        },
+        duration: 0,
+    };
+});
+/**
+ * execute.task: Execute the planned task
+ */
+registerAction('execute.task', async (context) => {
+    return {
+        success: true,
+        action: 'execute.task',
+        data: {
+            taskId: context.taskId,
+            result: null,
+        },
+        duration: 0,
+    };
+});
+/**
+ * dream.cycle: Run memory consolidation
+ */
+registerAction('dream.cycle', async (context) => {
+    return {
+        success: true,
+        action: 'dream.cycle',
+        data: {
+            consolidated: 0,
+            patterns: [],
+        },
+        duration: 0,
+    };
+});
+/**
+ * rest.idle: Do nothing, conserve energy
+ */
+registerAction('rest.idle', async (_context) => {
+    // Literally do nothing
+    return {
+        success: true,
+        action: 'rest.idle',
+        data: { rested: true },
+        duration: 0,
+    };
+});
+/**
+ * recharge: Restore energy to system
+ */
+registerAction('recharge', async (context) => {
+    return {
+        success: true,
+        action: 'recharge',
+        data: {
+            previousEnergy: 0.5,
+            newEnergy: 1.0,
+        },
+        duration: 0,
+    };
+});
+// ============================================================================
+// Action Executor Manager
+// ============================================================================
+class ActionExecutorManager {
+    context = {};
+    history = [];
+    /**
+     * Set the current execution context
+     */
+    setContext(context) {
+        this.context = { ...this.context, ...context };
+    }
+    /**
+     * Execute an action with current context
+     */
+    async execute(action) {
+        const result = await executeAction(action, this.context);
+        this.history.push(result);
+        // Limit history to last 100 actions
+        if (this.history.length > 100) {
+            this.history = this.history.slice(-100);
+        }
+        return result;
+    }
+    /**
+     * Get action history
+     */
+    getHistory() {
+        return [...this.history];
+    }
+    /**
+     * Get statistics
+     */
+    getStats() {
+        const total = this.history.length;
+        const successful = this.history.filter(r => r.success).length;
+        const byAction = new Map();
+        for (const result of this.history) {
+            const stat = byAction.get(result.action) || { total: 0, success: 0 };
+            stat.total++;
+            if (result.success)
+                stat.success++;
+            byAction.set(result.action, stat);
+        }
+        return {
+            total,
+            successful,
+            successRate: total > 0 ? successful / total : 0,
+            byAction: Object.fromEntries(byAction),
+        };
+    }
+    /**
+     * Clear history
+     */
+    clearHistory() {
+        this.history = [];
+    }
+}
+exports.ActionExecutorManager = ActionExecutorManager;
+// ============================================================================
+// Factory
+// ============================================================================
+let managerInstance = null;
+function createActionExecutorManager() {
+    return new ActionExecutorManager();
+}
+function getActionExecutorManager() {
+    if (!managerInstance) {
+        managerInstance = createActionExecutorManager();
+    }
+    return managerInstance;
+}