📚 Move API Documentation to Libraries/API

.gitignore

@@ -0,0 +1 @@
+node_modules/

.iris/.gitignore

@@ -0,0 +1,15 @@
+# FoxRuv Intelligence Backend
+
+# Logs (exclude from version control)
+logs/
+tmp/
+
+# Cache (rebuild as needed)
+cache/
+
+# AgentDB (local learning - optional to commit)
+agentdb/
+
+# Keep config files (commit these)
+!config/
+!mcp/registry.json

.iris/README.md

@@ -0,0 +1,28 @@
+# .iris - FoxRuv Intelligence Backend
+
+This folder contains all FoxRuv agent learning infrastructure.
+
+## Structure
+
+.iris/
+├── config/          # Configuration files
+├── agentdb/         # AgentDB storage (learning/memory)
+├── cache/           # Cached MCP responses and embeddings
+├── logs/            # MCP calls, Claude sessions, Iris evaluations
+├── learning/        # Discovered patterns and optimizations
+├── mcp/             # MCP installations and wrappers
+└── tmp/             # Temporary execution artifacts
+
+## Key Files
+
+- **config/settings.json** - User preferences and settings
+- **config/mcp-servers.json** - MCP server configurations
+- **config/claude-contexts.json** - Active CLAUDE.md contexts
+- **mcp/registry.json** - Available MCPs catalog
+
+## Usage
+
+This folder is managed by npx iris CLI. Do not edit manually unless you know what you're doing.
+
+See docs/guides/FOXRUV_FOLDER_GUIDE.md for details.
+

.iris/config/claude-contexts.json

@@ -0,0 +1,6 @@
+{
+  "active_contexts": [],
+  "merge_strategy": "additive",
+  "current_working_directory": "/tmp/Zeeeepa/analyzer",
+  "applicable_contexts": []
+}

.iris/config/mcp-servers.json

@@ -0,0 +1,5 @@
+{
+  "servers": {},
+  "global_mcps_disabled": false,
+  "last_sync": "2025-12-14T08:52:53.150Z"
+}

.iris/config/settings.json

@@ -0,0 +1,37 @@
+{
+  "version": "0.6.0",
+  "project_name": "analyzer",
+  "user_id": "user_1765702373149",
+  "execution": {
+    "use_agentic_flow": true,
+    "use_agentdb": true,
+    "swarm_topology": "mesh",
+    "max_agents": 5,
+    "enable_learning": true,
+    "enable_caching": true,
+    "track_all_operations": true
+  },
+  "preferences": {
+    "auto_track_mcps": true,
+    "enable_agentdb": true,
+    "enable_supabase": false,
+    "cache_mcp_responses": true,
+    "max_cache_age_hours": 24
+  },
+  "claude_contexts": {
+    "strategy": "hierarchical_merge",
+    "auto_detect": true,
+    "priority_order": [
+      "local",
+      "parent",
+      "root"
+    ]
+  },
+  "iris_prime": {
+    "auto_evaluate": true,
+    "evaluation_interval_hours": 24,
+    "drift_threshold": 0.15,
+    "auto_optimize_wrappers": true,
+    "generate_compound_skills": true
+  }
+}

.iris/learning/skills/optimization.md

@@ -0,0 +1,44 @@
+# Iris Optimization Skill
+
+## Context
+This project has the `@foxruv/iris` optimization engine installed. This engine provides a pluggable architecture for hyperparameter and prompt optimization, prioritizing:
+1. **Ax (Bayesian Optimization)** - For numeric/structural parameters.
+2. **DSPy (MIPROv2)** - For prompt/LLM optimization.
+3. **Grid Search** - For simple fallbacks.
+
+## Your Role
+When the user mentions "optimization", "tuning", or "improving performance", you must:
+
+1. **Analyze the Target:**
+   - Identify the script or function needing optimization.
+   - Look for an exported `evaluate(params)` function.
+
+2. **Check Configuration (`iris-config.yaml`):**
+   - If no config exists, propose creating one using the template below.
+   - Respect the `strategy` order (default: `['ax', 'dspy', 'grid']`).
+
+3. **Select the Strategy:**
+   - **Prefer Ax** if the project has a Python environment and numeric parameters.
+   - **Prefer DSPy** if optimizing prompts/text.
+   - **Use Grid** if the search space is small (<20 combinations) or dependencies are missing.
+
+4. **Execute:**
+   - Use the CLI: `npx iris optimize --config <config.yaml> --target <script.ts>`
+   - Do NOT write custom optimization loops unless the CLI is insufficient.
+
+## Configuration Template
+```yaml
+optimization:
+  strategy: ['ax', 'grid']
+  searchSpace:
+    parameters:
+      - name: "learning_rate"
+        type: "range"
+        bounds: [0.0001, 0.1]
+        log_scale: true
+```
+
+## Dependency Check
+Before running Ax or DSPy, verify dependencies:
+- Ax: `pip install ax-platform` (Python service must be running).
+- DSPy: `pip install dspy-ai`.

.iris/mcp/registry.json

@@ -0,0 +1,153 @@
+{
+  "version": "1.0.0",
+  "mcps": {
+    "filesystem-mcp": {
+      "name": "Filesystem MCP",
+      "description": "File operations with AI-powered editing (Morph)",
+      "category": "development",
+      "author": "anthropic",
+      "npm_package": "@anthropic/filesystem-mcp",
+      "version": "1.0.0",
+      "verified": true,
+      "security_audit": "2024-11-01",
+      "required_env": [],
+      "tools": [
+        "read_file",
+        "write_file",
+        "list_directory",
+        "morph_edit"
+      ]
+    },
+    "context7-mcp": {
+      "name": "Context7 MCP",
+      "description": "Semantic codebase search and understanding",
+      "category": "development",
+      "author": "context7",
+      "npm_package": "@context7/mcp",
+      "version": "1.0.0",
+      "verified": true,
+      "security_audit": "2024-11-15",
+      "required_env": [
+        "CONTEXT7_API_KEY"
+      ],
+      "tools": [
+        "search_code",
+        "get_context",
+        "understand_codebase"
+      ]
+    },
+    "supabase-mcp": {
+      "name": "Supabase MCP",
+      "description": "Database, auth, storage, and realtime",
+      "category": "database",
+      "author": "supabase",
+      "npm_package": "@supabase/mcp",
+      "version": "1.0.0",
+      "verified": true,
+      "security_audit": "2024-11-01",
+      "required_env": [
+        "SUPABASE_URL",
+        "SUPABASE_SERVICE_ROLE_KEY"
+      ],
+      "tools": [
+        "query",
+        "insert",
+        "update",
+        "delete",
+        "storage_upload"
+      ]
+    },
+    "neo4j-mcp": {
+      "name": "Neo4j Graph Database MCP",
+      "description": "Query and manage Neo4j graph databases",
+      "category": "database",
+      "author": "foxruv",
+      "npm_package": "@foxruv/neo4j-mcp",
+      "version": "0.3.0",
+      "verified": true,
+      "security_audit": "2024-11-15",
+      "required_env": [
+        "NEO4J_URI",
+        "NEO4J_USER",
+        "NEO4J_PASSWORD"
+      ],
+      "tools": [
+        "run_query",
+        "get_schema",
+        "create_node"
+      ]
+    },
+    "stripe-mcp": {
+      "name": "Stripe MCP Server",
+      "description": "Interact with Stripe API for payments",
+      "category": "payments",
+      "author": "stripe",
+      "npm_package": "stripe-mcp-server",
+      "version": "1.2.0",
+      "verified": true,
+      "security_audit": "2024-11-01",
+      "required_env": [
+        "STRIPE_API_KEY"
+      ],
+      "tools": [
+        "create_customer",
+        "create_subscription",
+        "cancel_subscription"
+      ]
+    },
+    "slack-mcp": {
+      "name": "Slack MCP",
+      "description": "Send messages and interact with Slack",
+      "category": "communication",
+      "author": "slack",
+      "npm_package": "@slack/mcp",
+      "version": "1.0.0",
+      "verified": true,
+      "security_audit": "2024-11-01",
+      "required_env": [
+        "SLACK_BOT_TOKEN"
+      ],
+      "tools": [
+        "send_message",
+        "list_channels",
+        "get_thread"
+      ]
+    },
+    "brave-search-mcp": {
+      "name": "Brave Search MCP",
+      "description": "Web search with Brave Search API",
+      "category": "search",
+      "author": "brave",
+      "npm_package": "@anthropic/brave-search-mcp",
+      "version": "1.0.0",
+      "verified": true,
+      "security_audit": "2024-11-01",
+      "required_env": [
+        "BRAVE_API_KEY"
+      ],
+      "tools": [
+        "web_search",
+        "news_search"
+      ]
+    }
+  },
+  "categories": {
+    "development": [
+      "filesystem-mcp",
+      "context7-mcp"
+    ],
+    "database": [
+      "supabase-mcp",
+      "neo4j-mcp"
+    ],
+    "payments": [
+      "stripe-mcp"
+    ],
+    "communication": [
+      "slack-mcp"
+    ],
+    "search": [
+      "brave-search-mcp"
+    ]
+  }
+}

CLAUDE.md

@@ -0,0 +1,37 @@
+---
+context_type: root
+priority: 0
+---
+
+# Project AI Guide - Root Context
+
+This is the root CLAUDE.md file. Subdirectories may have their own CLAUDE.md files with context-specific information.
+
+## Context System
+
+This project uses **hierarchical context merging**:
+- Subdirectory CLAUDE.md files EXTEND this root context
+- They don't replace it - contexts are additive
+- More specific contexts have higher priority
+
+## FoxRuv Intelligence
+
+This project uses @foxruv/iris for:
+- **AgentDB** - Learning and memory
+- **MCP Skills** - On-demand tool loading
+- **Iris** - Autonomous optimization
+
+## Available Contexts
+
+Check subdirectories for domain-specific CLAUDE.md files:
+- database/CLAUDE.md - Database schemas and tools
+- api/CLAUDE.md - API specifications and tools
+- ml/CLAUDE.md - ML model specifications
+
+See .iris/config/claude-contexts.json for active contexts.
+
+
+
+## Optimization Engine
+Reference 
+.iris/learning/skills/optimization.md` for optimization instructions (Ax/DSPy).