@lanonasis/cli 1.0.1 → 1.2.0

package/README.md

@@ -1,8 +1,20 @@
 # Lanonasis CLI - Enterprise Infrastructure Management
 
-🚀 **Professional CLI for Lanonasis Platform Services**
+[![npm version](https://img.shields.io/npm/v/@lanonasis/cli)](https://www.npmjs.com/package/@lanonasis/cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![MCP Integration](https://img.shields.io/badge/MCP-Model%20Context%20Protocol-purple)](https://modelcontextprotocol.com)
 
-The Lanonasis CLI provides a powerful command-line interface for interacting with the entire Lanonasis ecosystem, including Memory as a Service (MaaS), infrastructure management, and multi-service orchestration. Manage your memories, search through knowledge bases, organize your thoughts, and control your infrastructure - all from the terminal.
+🚀 **Professional CLI for Lanonasis Platform Services with MCP Integration**
+
+The Lanonasis CLI provides a powerful command-line interface for interacting with the entire Lanonasis ecosystem, including Memory as a Service (MaaS), infrastructure management, and multi-service orchestration. Now with **Model Context Protocol (MCP)** integration for unified AI-agent communication. Manage your memories, search through knowledge bases, organize your thoughts, and control your infrastructure - all from the terminal.
+
+## 🆕 New in v1.1.0
+- **MCP Server Mode**: Run as MCP server for AI assistants (Claude, Cursor, Windsurf)
+- **Hybrid Architecture**: Seamless switching between local MCP and remote API
+- **Real-time Updates**: SSE streaming for live memory synchronization
+- **Tool Discovery**: Dynamic MCP tool listing for AI agents
+- **Unified Interface**: Same commands work with local or cloud backends
+- **Auto-detection**: Intelligently chooses best connection mode
 
 ## ⚡ Quick Start
 
@@ -135,6 +147,95 @@ memory search "my query"  # Direct memory command
 maas list --type knowledge  # MaaS command
 ```
 
+## 🤖 MCP Integration (Model Context Protocol)
+
+The CLI now includes full MCP support for AI agent integration:
+
+### Start MCP Server Mode
+
+```bash
+# Start as MCP server for AI assistants
+lanonasis mcp start                 # Default port 3002
+lanonasis mcp start --port 8080     # Custom port
+lanonasis mcp start --mode server   # Explicit server mode
+
+# Or use npx without installation
+npx -y @lanonasis/cli mcp start
+```
+
+### Configure AI Assistants
+
+**Claude Desktop** (`~/Library/Application Support/Claude/claude_desktop_config.json`):
+```json
+{
+  "mcpServers": {
+    "memory-service": {
+      "command": "npx",
+      "args": ["-y", "@lanonasis/cli", "mcp", "start"],
+      "env": {
+        "LANONASIS_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+**Cursor/Windsurf** (Settings):
+```json
+{
+  "mcp.servers": {
+    "memory-service": {
+      "command": "lanonasis",
+      "args": ["mcp", "start"],
+      "env": {
+        "LANONASIS_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+### MCP Commands
+
+```bash
+# Server operations
+lanonasis mcp start            # Start MCP server
+lanonasis mcp stop             # Stop MCP server
+lanonasis mcp status           # Check server status
+lanonasis mcp logs             # View server logs
+
+# Tool discovery
+lanonasis mcp tools            # List all available MCP tools
+lanonasis mcp tools --json     # Output as JSON
+
+# Test connectivity
+lanonasis mcp test             # Test MCP connection
+lanonasis mcp test --tool <name> # Test specific tool
+```
+
+### Available MCP Tools
+
+- `memory_create_memory` - Create new memories with embeddings
+- `memory_search_memories` - Semantic search across memories
+- `memory_list_memories` - List and filter memories
+- `memory_get_memory` - Retrieve specific memory
+- `memory_update_memory` - Update existing memories
+- `memory_delete_memory` - Delete memories
+- `memory_bulk_create` - Batch create multiple memories
+- `memory_bulk_delete` - Batch delete memories
+- `memory_get_stats` - Get memory statistics
+- `memory_export_data` - Export memories (JSON/CSV/YAML)
+- `memory_import_data` - Import memories from files
+
+### MCP Features:
+- **🔌 WebSocket Server**: Real-time bidirectional communication
+- **🔄 Hybrid Mode**: Automatic fallback between local/remote
+- **🔐 Secure Auth**: API key and JWT token support
+- **📊 Real-time SSE**: Live updates in remote mode
+- **🛠️ Tool Discovery**: Dynamic tool listing for AI agents
+- **🎯 Auto-detection**: Intelligently chooses best mode
+- **📝 Full Memory API**: All operations exposed as MCP tools
+
 ## 🌐 MaaS Service Integration
 
 This CLI is designed to work with Memory as a Service platforms that provide:
@@ -181,11 +282,43 @@ node dist/index-simple.js help
 - **Configuration** - Flexible service setup
 - **Help System** - Comprehensive documentation
 
+## 📦 SDK & Related Packages
+
+### Memory Client SDK
+Install the TypeScript/JavaScript SDK for application integration:
+
+```bash
+# Install SDK for your applications
+npm install @lanonasis/memory-client
+
+# Use in your code
+import { createMemoryClient } from '@lanonasis/memory-client';
+
+const client = createMemoryClient({
+  baseURL: 'https://api.lanonasis.com',
+  apiKey: 'your-api-key-here'
+});
+```
+
+### Complete Installation for Developers
+```bash
+# Install CLI globally for command-line usage
+npm install -g @lanonasis/cli
+
+# Install SDK locally for application development
+npm install @lanonasis/memory-client
+
+# Now you have both CLI and SDK available!
+lanonasis --help                    # CLI commands
+# SDK available for import in your code
+```
+
 ## 🔗 Related Projects
 
-- **Memory Service Backend** - Full MaaS API server
-- **Memory SDK** - JavaScript/TypeScript SDK for developers
-- **Memory Visualizer** - Interactive memory exploration
+- **Memory Service Backend** - Full MaaS API server ([GitHub](https://github.com/thefixer3x/vibe-memory))
+- **Memory Client SDK** - JavaScript/TypeScript SDK (`@lanonasis/memory-client`)
+- **Memory Visualizer** - Interactive memory exploration (included in backend)
+- **VSCode Extension** - IDE integration (coming soon)
 
 ## 📄 License
 
@@ -212,6 +345,33 @@ MIT License - see LICENSE file for details
 - **Research Organization** - Academic and research note-taking
 - **API Integration** - Programmatic memory management
 
+## 🏆 Production Ready Features
+
+### Enterprise Capabilities
+- **🔐 Secure Authentication** - API key and JWT token support
+- **🌐 Multi-tenant Support** - Isolated memory spaces per user/org
+- **📊 Rate Limiting** - Built-in request throttling
+- **🔄 Retry Logic** - Automatic retry with exponential backoff
+- **📝 Comprehensive Logging** - Debug and audit trails
+- **🚀 Performance Optimized** - Minimal overhead, fast responses
+
+### Commercial Use Cases
+- **💼 Enterprise Knowledge Management** - Company-wide memory system
+- **🤝 Team Collaboration** - Shared project memories
+- **🎓 Educational Platforms** - Student/teacher memory sharing
+- **🏥 Healthcare Systems** - Patient context management
+- **💰 Financial Services** - Transaction memory and audit trails
+- **🛒 E-commerce** - Customer interaction history
+
+### Integration Ready
+- **REST API** - Standard HTTP/JSON interface
+- **MCP Protocol** - AI assistant integration
+- **WebSocket** - Real-time updates
+- **SSE Streaming** - Live data synchronization
+- **SDK Available** - TypeScript/JavaScript client library
+
 ---
 
-**Built with ❤️ for the Memory as a Service ecosystem**
+**Built with ❤️ for the Memory as a Service ecosystem**
+
+🚀 **Ready for Production** | 📚 [Documentation](https://docs.lanonasis.com) | 🌐 [Platform](https://api.lanonasis.com)

package/dist/commands/auth.d.ts

@@ -1 +1,6 @@
-export declare function loginCommand(options: any): Promise<void>;
+interface LoginOptions {
+    email?: string;
+    password?: string;
+}
+export declare function loginCommand(options: LoginOptions): Promise<void>;
+export {};

package/dist/commands/auth.js

@@ -49,7 +49,9 @@ export async function loginCommand(options) {
     }
     catch (error) {
         spinner.fail('Login failed');
-        if (error.response?.status === 401) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        const errorResponse = error && typeof error === 'object' && 'response' in error ? error.response : null;
+        if (errorResponse && typeof errorResponse === 'object' && 'status' in errorResponse && errorResponse.status === 401) {
             console.error(chalk.red('✖ Invalid email or password'));
             // Ask if they want to register
             const answer = await inquirer.prompt([
@@ -65,7 +67,7 @@ export async function loginCommand(options) {
             }
         }
         else {
-            console.error(chalk.red('✖ Login failed:'), error.message);
+            console.error(chalk.red('✖ Login failed:'), errorMessage);
         }
         process.exit(1);
     }
@@ -98,7 +100,7 @@ async function registerFlow(defaultEmail) {
             message: 'Confirm password:',
             mask: '*',
             validate: (input, answers) => {
-                return input === answers.password || 'Passwords do not match';
+                return input === answers?.password || 'Passwords do not match';
             }
         },
         {
@@ -124,7 +126,8 @@ async function registerFlow(defaultEmail) {
     }
     catch (error) {
         spinner.fail('Registration failed');
-        console.error(chalk.red('✖ Registration failed:'), error.message);
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        console.error(chalk.red('✖ Registration failed:'), errorMessage);
         process.exit(1);
     }
 }

package/dist/commands/config.js

@@ -3,6 +3,65 @@ import inquirer from 'inquirer';
 import { CLIConfig } from '../utils/config.js';
 import { apiClient } from '../utils/api.js';
 export function configCommands(program) {
+    // Generic config set command
+    program
+        .command('set <key> <value>')
+        .description('Set configuration value')
+        .action(async (key, value) => {
+        const config = new CLIConfig();
+        await config.init();
+        // Handle special cases
+        switch (key) {
+            case 'api-url':
+                await config.setApiUrl(value);
+                console.log(chalk.green('✓ API URL updated:'), value);
+                break;
+            case 'ai-integration':
+                if (value === 'claude-mcp') {
+                    config.set('mcpEnabled', true);
+                    config.set('aiIntegration', 'claude-mcp');
+                    console.log(chalk.green('✓ AI integration set to Claude MCP'));
+                    console.log(chalk.cyan('  MCP will be automatically initialized for memory operations'));
+                    console.log(chalk.cyan('  Run "lanonasis mcp-server init" to test the connection'));
+                }
+                else {
+                    console.log(chalk.yellow('⚠️  Unknown AI integration:'), value);
+                    console.log(chalk.gray('  Currently supported: claude-mcp'));
+                }
+                break;
+            case 'mcp-use-remote':
+                config.set('mcpUseRemote', value === 'true');
+                console.log(chalk.green('✓ MCP remote mode:'), value === 'true' ? 'enabled' : 'disabled');
+                break;
+            case 'mcp-server-path':
+                config.set('mcpServerPath', value);
+                console.log(chalk.green('✓ MCP server path updated:'), value);
+                break;
+            case 'mcp-server-url':
+                config.set('mcpServerUrl', value);
+                console.log(chalk.green('✓ MCP server URL updated:'), value);
+                break;
+            default:
+                // Generic config set
+                config.set(key, value);
+                console.log(chalk.green(`✓ ${key} set to:`), value);
+        }
+    });
+    // Generic config get command
+    program
+        .command('get <key>')
+        .description('Get configuration value')
+        .action(async (key) => {
+        const config = new CLIConfig();
+        await config.init();
+        const value = config.get(key);
+        if (value !== undefined) {
+            console.log(chalk.green(`${key}:`), value);
+        }
+        else {
+            console.log(chalk.yellow(`⚠️  ${key} is not set`));
+        }
+    });
     // Show current configuration
     program
         .command('show')
@@ -26,6 +85,29 @@ export function configCommands(program) {
             }
         }
     });
+    // List all configuration options
+    program
+        .command('list')
+        .description('List all configuration options')
+        .action(async () => {
+        const config = new CLIConfig();
+        await config.init();
+        console.log(chalk.blue.bold('📋 Configuration Options'));
+        console.log();
+        const configOptions = [
+            { key: 'api-url', description: 'API endpoint URL', current: config.getApiUrl() },
+            { key: 'ai-integration', description: 'AI integration mode', current: config.get('aiIntegration') || 'none' },
+            { key: 'mcp-use-remote', description: 'Use remote MCP server', current: config.get('mcpUseRemote') || false },
+            { key: 'mcp-server-path', description: 'Local MCP server path', current: config.get('mcpServerPath') || 'default' },
+            { key: 'mcp-server-url', description: 'Remote MCP server URL', current: config.get('mcpServerUrl') || 'https://api.lanonasis.com' },
+            { key: 'mcpEnabled', description: 'MCP integration enabled', current: config.get('mcpEnabled') || false }
+        ];
+        configOptions.forEach(opt => {
+            console.log(chalk.green(opt.key.padEnd(20)), chalk.gray(opt.description.padEnd(30)), chalk.yellow(String(opt.current)));
+        });
+        console.log();
+        console.log(chalk.gray('Use "lanonasis config set <key> <value>" to update any option'));
+    });
     // Set API URL
     program
         .command('set-url')
@@ -72,24 +154,26 @@ export function configCommands(program) {
             console.log(chalk.green('✓ Connection successful'));
             console.log(`Status: ${health.status}`);
             console.log(`Version: ${health.version}`);
-            console.log(`Uptime: ${Math.round(health.uptime)}s`);
             if (health.dependencies) {
                 console.log();
                 console.log(chalk.yellow('Dependencies:'));
                 Object.entries(health.dependencies).forEach(([name, info]) => {
                     const status = info.status === 'healthy' ? chalk.green('✓') : chalk.red('✖');
-                    console.log(`  ${status} ${name}: ${info.status} (${info.response_time}ms)`);
+                    const responseTime = info.response_time || info.latency_ms || 0;
+                    console.log(`  ${status} ${name}: ${info.status} (${responseTime}ms)`);
                 });
             }
         }
         catch (error) {
             console.log(chalk.red('✖ Connection failed'));
-            if (error.code === 'ECONNREFUSED') {
+            const errorCode = error && typeof error === 'object' && 'code' in error ? error.code : null;
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            if (errorCode === 'ECONNREFUSED') {
                 console.error(chalk.red('Cannot connect to API server'));
                 console.log(chalk.yellow('Make sure the API server is running'));
             }
             else {
-                console.error(chalk.red('Error:'), error.message);
+                console.error(chalk.red('Error:'), errorMessage);
             }
             process.exit(1);
         }

package/dist/commands/init.d.ts

@@ -1 +1,5 @@
-export declare function initCommand(options: any): Promise<void>;
+interface InitOptions {
+    force?: boolean;
+}
+export declare function initCommand(options: InitOptions): Promise<void>;
+export {};

package/dist/commands/mcp.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function mcpCommands(program: Command): void;