@reepoe/plugin 1.1.0

package/README.md

@@ -0,0 +1,223 @@
+# @reepoe/plugin
+
+> **ReePoe AI Code Manager** - Install in any codebase for instant AI agent integration
+
+Transform your codebase into an AI-optimized workspace in 30 seconds. ReePoe provides intelligent context management, token optimization, and seamless AI agent integration.
+
+## 🚀 Quick Start
+
+```bash
+# Install globally
+npm install -g @reepoe/plugin
+
+# Navigate to your project
+cd /path/to/your/project
+
+# Start ReePoe
+reepoe-start
+
+# Query your codebase
+reepoe query "what does this codebase do?"
+```
+
+That's it! ReePoe automatically:
+- ✅ Detects your project type (Node.js, Python, Go, etc.)
+- ✅ Scans your codebase
+- ✅ Starts API server
+- ✅ Optimizes context for AI agents
+
+## 📦 What's Included
+
+- **Multi-Language Support** - JavaScript, TypeScript, Python, Go, Rust, Java, and more
+- **Smart Context** - Intelligent code analysis and context optimization
+- **MiniRAG** - Pattern-based instant responses
+- **Token Optimization** - 90%+ token reduction
+- **API Server** - RESTful API for AI agent integration
+- **Dashboard** - Real-time metrics and analytics
+
+## 🛠️ Commands
+
+### Server Management
+```bash
+reepoe-start   # Start ReePoe server in background
+reepoe-stop    # Stop ReePoe server
+reepoe-status  # Check server status and health
+```
+
+### Queries
+```bash
+reepoe query "show me all API endpoints"
+reepoe query "find all test files"
+reepoe query "explain the authentication system"
+reepoe query "what's the project structure?"
+```
+
+## 📡 API Endpoints
+
+Once started, ReePoe exposes:
+
+```
+GET  /health              - Health check
+GET  /describe            - Full capability description
+POST /query               - Natural language queries
+GET  /metrics             - Performance analytics
+GET  /token-analytics     - Token usage details
+```
+
+## 🎯 Use Cases
+
+### For AI Agents
+```javascript
+// Claude, ChatGPT, or custom agents can query ReePoe
+const response = await fetch('http://localhost:8000/query', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({
+        instruction: 'analyze this codebase architecture'
+    })
+});
+```
+
+### For Developers
+```bash
+# Quick codebase insights
+reepoe query "what external APIs are used?"
+reepoe query "show me database models"
+reepoe query "find security-related code"
+```
+
+### For Code Reviews
+```bash
+# Automated analysis
+reepoe query "find all TODO comments"
+reepoe query "show me recent changes to auth system"
+reepoe query "what tests exist for the API?"
+```
+
+## 🔧 Configuration
+
+ReePoe auto-configures on first start, but you can customize:
+
+```json
+// reepoe.config.json (auto-generated)
+{
+  "project": {
+    "name": "my-awesome-app",
+    "type": "javascript",
+    "framework": "Express"
+  },
+  "api": {
+    "port": 8000,
+    "host": "127.0.0.1"
+  },
+  "mini_rag": {
+    "enabled": true,
+    "cta_whitelist": ["run_tests", "search_symbols"]
+  }
+}
+```
+
+## 📊 Supported Languages
+
+| Language | Support Level | Symbol Extraction |
+|----------|---------------|-------------------|
+| JavaScript/TypeScript | ✅ Full | Functions, Classes, Interfaces, Types |
+| Python | ✅ Full | Functions, Classes, Methods, Decorators |
+| Go | ✅ Full | Functions, Structs, Interfaces, Methods |
+| Rust | ⚠️  Generic | Functions, Structs, Traits |
+| Java | ⚠️  Generic | Classes, Methods, Interfaces |
+| C/C++ | ⚠️  Generic | Functions, Classes, Structs |
+
+## 🏗️ Architecture
+
+```
+┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
+│   AI Agents     │────│   ReePoe API    │────│  LLM Providers  │
+│ (Claude, GPT)   │    │                 │    │  (OpenRouter)   │
+└─────────────────┘    └─────────────────┘    └─────────────────┘
+                              │
+                       ┌──────▼────────┐
+                       │  Your Codebase │
+                       │  (Any Language)│
+                       └────────────────┘
+```
+
+## 💡 Features
+
+### Intelligent Context Management
+- Automatic codebase indexing
+- Symbol-level navigation
+- Context slicing and optimization
+- Reference-based loading
+
+### Token Optimization
+- 90%+ token reduction
+- Smart context compression
+- Pattern-based caching (MiniRAG)
+- Real-time usage tracking
+
+### AI Agent Integration
+- Standard REST API
+- MCP (Model Context Protocol) support
+- Auto-discovery via `/describe`
+- Comprehensive onboarding
+
+## 🐛 Troubleshooting
+
+### Server won't start
+```bash
+# Check status
+reepoe-status
+
+# Check if port is in use
+lsof -i :8000
+
+# Try different port
+# Edit reepoe.config.json and change api.port
+```
+
+### Binary permissions (Unix/Linux)
+```bash
+chmod +x ~/.npm-global/lib/node_modules/@reepoe/plugin/binaries/reepoe-*
+```
+
+### Reset configuration
+```bash
+rm reepoe.config.json
+reepoe-start  # Will regenerate
+```
+
+## 📝 Requirements
+
+- **Node.js** 16.0.0 or higher
+- **Operating Systems:** macOS, Linux, Windows
+- **Architecture:** x64, arm64
+
+## 🔒 Security
+
+- Runs locally on your machine
+- No data sent to external servers (except configured LLM APIs)
+- Closed-source binary distribution
+- Whitelist-based CTA execution
+
+## 📈 Performance
+
+- **Install time:** < 60 seconds
+- **Startup time:** < 3 seconds
+- **Query latency:** < 2 seconds
+- **Memory usage:** < 500MB
+
+## 🆘 Support
+
+- **Documentation:** https://reepoe.com/docs
+- **Issues:** https://github.com/MarcAndre72/ReePoe/issues
+- **API Reference:** http://localhost:8000/describe (after starting)
+
+## 📄 License
+
+Proprietary - See LICENSE file for details
+
+---
+
+**ReePoe** - Making AI agents smarter, one codebase at a time 🚀
+

package/bin/admin.js

@@ -0,0 +1,286 @@
+#!/usr/bin/env node
+/**
+ * ReePoe Admin CLI - Administrative tools
+ */
+
+const ActivationClient = require('../lib/activation-client');
+const readline = require('readline');
+const fs = require('fs');
+
+const client = new ActivationClient();
+
+async function promptInput(question) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout
+    });
+    
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+
+async function adminLogin() {
+    console.log('\n╔═══════════════════════════════════════════════════════════════╗');
+    console.log('║  🔐 ReePoe Admin Login                                        ║');
+    console.log('╚═══════════════════════════════════════════════════════════════╝\n');
+    
+    const email = await promptInput('📧 Admin Email: ');
+    const adminCode = await promptInput('🔑 Admin Code: ');
+    
+    console.log('\n⏳ Authenticating...\n');
+    
+    try {
+        const result = await client.adminLogin(email, adminCode);
+        
+        if (result.success) {
+            console.log('✅ Admin access granted!');
+            console.log(`   Token valid for: 1 hour`);
+            console.log(`   Permissions: Full admin access\n`);
+            console.log('Commands available:');
+            console.log('   reepoe admin users list');
+            console.log('   reepoe admin codes generate');
+            console.log('   reepoe admin metrics\n');
+        } else {
+            console.log(`❌ Login failed: ${result.message || 'Invalid credentials'}\n`);
+            process.exit(1);
+        }
+    } catch (error) {
+        console.error(`❌ Login error: ${error.message}\n`);
+        process.exit(1);
+    }
+}
+
+async function listUsers(options = {}) {
+    try {
+        const result = await client.adminListUsers(options.status, options.limit || 50);
+        
+        console.log('\n╔═══════════════════════════════════════════════════════════════╗');
+        console.log(`║  👥 Users (${result.total} total)${' '.repeat(47 - result.total.toString().length)}║`);
+        console.log('╚═══════════════════════════════════════════════════════════════╝\n');
+        
+        if (result.users.length === 0) {
+            console.log('No users found.\n');
+            return;
+        }
+        
+        // Table header
+        console.log('Email                      Status    Queries  Tokens Saved  Expires');
+        console.log('─────────────────────────────────────────────────────────────────');
+        
+        for (const user of result.users) {
+            const email = user.email.substring(0, 25).padEnd(26);
+            const status = user.status.padEnd(9);
+            const queries = String(user.total_queries || 0).padStart(7);
+            const tokens = String(user.total_tokens_saved || 0).padStart(13);
+            
+            let expires = '    -   ';
+            if (user.expires_at) {
+                const expDate = new Date(user.expires_at);
+                const days = Math.ceil((expDate - new Date()) / (1000 * 60 * 60 * 24));
+                expires = `${days}d`.padStart(8);
+            }
+            
+            console.log(`${email}${status}${queries} ${tokens}${expires}`);
+        }
+        
+        console.log('\n💡 Commands:');
+        console.log('   reepoe admin users extend <email> +30d');
+        console.log('   reepoe admin users revoke <email>\n');
+        
+    } catch (error) {
+        console.error(`\n❌ Failed to list users: ${error.message}\n`);
+        process.exit(1);
+    }
+}
+
+async function generateCodes(count, options = {}) {
+    try {
+        const codeType = options.type || 'ALPHA';
+        const notes = options.notes;
+        const adminEmail = 'admin';  // TODO: Get from admin session
+        
+        console.log('\n╔═══════════════════════════════════════════════════════════════╗');
+        console.log('║  🔑 Generating Activation Codes                               ║');
+        console.log('╚═══════════════════════════════════════════════════════════════╝\n');
+        
+        console.log(`Type: ${codeType}`);
+        console.log(`Count: ${count}`);
+        console.log(`Expires: 30 days from now\n`);
+        
+        console.log('⏳ Generating...\n');
+        
+        const result = await client.adminGenerateCodes(count, codeType, adminEmail, notes);
+        
+        if (result.success) {
+            console.log(`✅ Generated ${result.count} codes!\n`);
+            
+            console.log('Codes:');
+            result.codes.forEach((code, i) => {
+                console.log(`   ${i + 1}. ${code}`);
+            });
+            
+            // Save to file
+            const filename = `alpha_codes_${Date.now()}.txt`;
+            fs.writeFileSync(filename, result.codes.join('\n'));
+            
+            console.log(`\n📄 Saved to: ${filename}`);
+            console.log(`\n💡 Share these codes with alpha testers!\n`);
+        } else {
+            console.log(`❌ Failed to generate codes\n`);
+        }
+        
+    } catch (error) {
+        console.error(`\n❌ Code generation failed: ${error.message}\n`);
+        process.exit(1);
+    }
+}
+
+async function extendUser(email, days) {
+    try {
+        const adminEmail = 'admin';  // TODO: Get from admin session
+        
+        console.log(`\n⏳ Extending ${email} by ${days} days...\n`);
+        
+        const result = await client.adminExtendUser(email, days, adminEmail);
+        
+        if (result.success) {
+            console.log(`✅ ${result.message}`);
+            console.log(`   New expiration: ${new Date(result.new_expires_at).toLocaleDateString()}\n`);
+        } else {
+            console.log(`❌ Extension failed: ${result.error}\n`);
+        }
+        
+    } catch (error) {
+        console.error(`\n❌ Extension error: ${error.message}\n`);
+        process.exit(1);
+    }
+}
+
+// Parse command line arguments
+const args = process.argv.slice(2);
+const command = args[0];
+const subcommand = args[1];
+
+async function showUserMetrics(email) {
+    const axios = require('axios');
+    
+    try {
+        console.log(`\n📊 Loading metrics for ${email}...\n`);
+        
+        // Get aggregate metrics (same as dashboard)
+        const API_URL = process.env.REEPOE_API_URL || 'http://localhost:8000';
+        const res = await axios.get(`${API_URL}/metrics`);
+        const data = res.data;
+        
+        console.log('╔═══════════════════════════════════════════════════════════════╗');
+        console.log(`║  📊 User Metrics - ${email.substring(0, 42).padEnd(42)}║`);
+        console.log('╚═══════════════════════════════════════════════════════════════╝\n');
+        
+        console.log('ALL TIME (Aggregate):');
+        console.log('─────────────────────────────────────────────────────');
+        console.log(`   Total Queries:     ${data.lifetime?.total_queries || 0}`);
+        console.log(`   Tokens Saved:      ${(data.lifetime?.tokens_saved || 0).toLocaleString()}`);
+        console.log(`   MiniRAG Hits:      ${data.lifetime?.mini_rag_hits || 0}`);
+        console.log(`   Cache Hit Rate:    ${((data.performance?.cache_hit_rate || 0) * 100).toFixed(1)}%`);
+        console.log('\n💡 Note: Showing aggregate metrics (per-user tracking in Phase 3C)\n');
+        
+    } catch (error) {
+        console.error(`\n❌ Failed to load metrics: ${error.message}\n`);
+        process.exit(1);
+    }
+}
+
+async function showAggregateMetrics() {
+    const axios = require('axios');
+    
+    try {
+        console.log('\n📊 Loading aggregate metrics...\n');
+        
+        // Get users and metrics
+        const users = await client.adminListUsers();
+        const API_URL = process.env.REEPOE_API_URL || 'http://localhost:8000';
+        const res = await axios.get(`${API_URL}/metrics`);
+        const data = res.data;
+        
+        console.log('╔═══════════════════════════════════════════════════════════════╗');
+        console.log('║  📊 ReePoe Admin Dashboard - Aggregate Metrics                ║');
+        console.log('╚═══════════════════════════════════════════════════════════════╝\n');
+        
+        console.log('USERS');
+        console.log('─────────────────────────────────────────────────────');
+        const activeUsers = users.users.filter(u => u.status === 'active').length;
+        const waitlistUsers = users.users.filter(u => u.status === 'waitlist').length;
+        console.log(`   Total:             ${users.total || 0}`);
+        console.log(`   Active:            ${activeUsers}`);
+        console.log(`   Waitlist:          ${waitlistUsers}`);
+        
+        console.log('\nUSAGE (ALL USERS)');
+        console.log('─────────────────────────────────────────────────────');
+        console.log(`   Total Queries:     ${data.lifetime?.total_queries || 0}`);
+        console.log(`   Tokens Saved:      ${(data.lifetime?.tokens_saved || 0).toLocaleString()}`);
+        console.log(`   MiniRAG Hits:      ${data.lifetime?.mini_rag_hits || 0}`);
+        console.log(`   Cache Hit Rate:    ${((data.performance?.cache_hit_rate || 0) * 100).toFixed(1)}%`);
+        
+        console.log('\nPERFORMANCE');
+        console.log('─────────────────────────────────────────────────────');
+        console.log(`   Token Savings Rate: ${((data.performance?.token_savings_rate || 0) * 100).toFixed(1)}%`);
+        console.log(`   Avg Response Time:  ${(data.performance?.avg_response_time_ms || 0).toFixed(0)}ms`);
+        
+        console.log('\n🌐 Dashboard: https://reepoe.com\n');
+        
+    } catch (error) {
+        console.error(`\n❌ Failed to load metrics: ${error.message}\n`);
+        process.exit(1);
+    }
+}
+
+async function main() {
+    if (command === 'login') {
+        await adminLogin();
+    } else if (command === 'users') {
+        if (subcommand === 'list') {
+            await listUsers({ status: args[2] });
+        } else if (subcommand === 'extend' && args[2]) {
+            const email = args[2];
+            const days = parseInt(args[3]) || 30;
+            await extendUser(email, days);
+        } else if (subcommand === 'metrics' && args[2]) {
+            const email = args[2];
+            await showUserMetrics(email);
+        } else {
+            console.log('\nUsage:');
+            console.log('   reepoe admin users list [status]');
+            console.log('   reepoe admin users extend <email> <days>');
+            console.log('   reepoe admin users metrics <email>\n');
+        }
+    } else if (command === 'codes') {
+        if (subcommand === 'generate' && args[2]) {
+            const count = parseInt(args[2]);
+            await generateCodes(count);
+        } else {
+            console.log('\nUsage:');
+            console.log('   reepoe admin codes generate <count>\n');
+        }
+    } else if (command === 'metrics') {
+        await showAggregateMetrics();
+    } else {
+        console.log('\n╔═══════════════════════════════════════════════════════════════╗');
+        console.log('║  🔐 ReePoe Admin CLI                                          ║');
+        console.log('╚═══════════════════════════════════════════════════════════════╝\n');
+        console.log('Commands:');
+        console.log('   reepoe admin login');
+        console.log('   reepoe admin users list');
+        console.log('   reepoe admin users extend <email> <days>');
+        console.log('   reepoe admin codes generate <count>\n');
+    }
+}
+
+main().catch(error => {
+    console.error(`❌ Error: ${error.message}`);
+    process.exit(1);
+});
+

package/bin/extend-request.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+/**
+ * ReePoe Extension Request - User requests access extension
+ */
+
+const ActivationClient = require('../lib/activation-client');
+const readline = require('readline');
+
+async function requestExtension() {
+    const client = new ActivationClient();
+    
+    // Load activation
+    const activation = client.loadActivation();
+    
+    if (!activation) {
+        console.log('\n❌ No activation found');
+        console.log('   Please activate ReePoe first: reepoe-start\n');
+        process.exit(1);
+    }
+    
+    console.log('\n╔═══════════════════════════════════════════════════════════════╗');
+    console.log('║  📧 Request Access Extension                                  ║');
+    console.log('╚═══════════════════════════════════════════════════════════════╝\n');
+    
+    console.log(`Your current access expires:`);
+    if (activation.expires_at) {
+        const expiresDate = new Date(activation.expires_at);
+        const daysRemaining = Math.ceil((expiresDate - new Date()) / (1000 * 60 * 60 * 24));
+        console.log(`   ${expiresDate.toLocaleDateString()} (${daysRemaining} days remaining)\n`);
+    } else {
+        console.log('   Lifetime access\n');
+    }
+    
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout
+    });
+    
+    const reason = await new Promise((resolve) => {
+        rl.question('💬 Reason for extension (optional): ', (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+    
+    console.log('\n⏳ Sending extension request...\n');
+    
+    try {
+        const result = await client.requestExtension(activation.email, reason || 'Standard extension request');
+        
+        if (result.success) {
+            console.log('╔═══════════════════════════════════════════════════════════════╗');
+            console.log('║  ✅ Extension Request Sent!                                   ║');
+            console.log('╚═══════════════════════════════════════════════════════════════╝\n');
+            console.log('Your request has been sent to the admin team.');
+            console.log('You\'ll be notified when it\'s reviewed.\n');
+            console.log('💡 Typically reviewed within 24-48 hours.\n');
+        } else {
+            console.log(`❌ Request failed: ${result.message}\n`);
+        }
+        
+    } catch (error) {
+        console.error(`\n❌ Error: ${error.message}\n`);
+        process.exit(1);
+    }
+}
+
+requestExtension();
+

package/bin/metrics.js

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+/**
+ * ReePoe Metrics - Display user's personal statistics
+ */
+
+const ActivationClient = require('../lib/activation-client');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+async function showMetrics() {
+    const axios = require('axios');
+    const client = new ActivationClient();
+    
+    // Load activation to get email
+    const activation = client.loadActivation();
+    
+    if (!activation) {
+        console.log('\n❌ No activation found');
+        console.log('   Please activate ReePoe first: reepoe-start\n');
+        process.exit(1);
+    }
+    
+    console.log('\n📊 Loading your ReePoe metrics...\n');
+    
+    try {
+        // Use per-user metrics endpoint (NOT aggregate)
+        const API_URL = process.env.REEPOE_API_URL || 'http://localhost:8000';
+        const res = await axios.get(`${API_URL}/api/metrics/user/${activation.email}`);
+        const data = res.data;
+        
+        // Per-user endpoint returns the correct structure already
+        const metrics = {
+            metrics: data.metrics,  // Already has today, week, alltime
+            account: data.account   // Already has activated_at, expires_at, status
+        };
+        
+        console.log('╔═══════════════════════════════════════════════════════════════╗');
+        console.log(`║  📊 ReePoe Metrics - ${activation.email.padEnd(39)}║`);
+        console.log('╚═══════════════════════════════════════════════════════════════╝\n');
+        
+        console.log('TODAY');
+        console.log('─────────────────────────────────────────────────────');
+        console.log(`   Queries:           ${metrics.metrics.today.queries || 0}`);
+        console.log(`   Tokens Saved:      ${(metrics.metrics.today.tokens_saved || 0).toLocaleString()}`);
+        console.log(`   Cost Saved:        $${(metrics.metrics.today.cost_saved || 0).toFixed(2)}`);
+        
+        console.log('\nTHIS WEEK');
+        console.log('─────────────────────────────────────────────────────');
+        console.log(`   Queries:           ${metrics.metrics.week.queries || 0}`);
+        console.log(`   Tokens Saved:      ${(metrics.metrics.week.tokens_saved || 0).toLocaleString()}`);
+        console.log(`   Cost Saved:        $${(metrics.metrics.week.cost_saved || 0).toFixed(2)}`);
+        
+        console.log('\nALL TIME');
+        console.log('─────────────────────────────────────────────────────');
+        console.log(`   Queries:           ${metrics.metrics.alltime.queries || 0}`);
+        console.log(`   Tokens Saved:      ${(metrics.metrics.alltime.tokens_saved || 0).toLocaleString()}`);
+        console.log(`   Cost Saved:        $${(metrics.metrics.alltime.cost_saved || 0).toFixed(2)}`);
+        console.log(`   Patterns Learned:  ${metrics.metrics.alltime.patterns_learned || 0}`);
+        console.log(`   Patterns Active:   ${metrics.metrics.alltime.patterns_active || 0}`);
+        
+        console.log('\nACCOUNT INFO');
+        console.log('─────────────────────────────────────────────────────');
+        console.log(`   Status:            ✅ ${metrics.account.status}`);
+        
+        if (metrics.account.expires_at) {
+            const expiresDate = new Date(metrics.account.expires_at);
+            const daysRemaining = Math.ceil((expiresDate - new Date()) / (1000 * 60 * 60 * 24));
+            console.log(`   Expires:           ${expiresDate.toLocaleDateString()}`);
+            console.log(`   Days Remaining:    ${daysRemaining}`);
+        }
+        
+        console.log('\n💡 Your Impact:');
+        console.log(`   You've saved ${metrics.metrics.alltime.tokens_saved.toLocaleString()} tokens!`);
+        if (metrics.metrics.alltime.patterns_active > 0) {
+            console.log(`   ${metrics.metrics.alltime.patterns_active} query types are now instant (0 tokens)\n`);
+        }
+        
+    } catch (error) {
+        console.error(`\n❌ Failed to load metrics: ${error.message}\n`);
+        process.exit(1);
+    }
+}
+
+showMetrics().catch(error => {
+    console.error(`❌ Error: ${error.message}`);
+    process.exit(1);
+});
+