@lanonasis/cli 1.1.0 → 1.2.0

package/README.md

@@ -1,14 +1,20 @@
 # Lanonasis CLI - Enterprise Infrastructure Management
 
+[![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)
+
 🚀 **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 Integration**: Full Model Context Protocol support for AI agents
-- **Hybrid Mode**: Seamless switching between local MCP and remote API
+- **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
 
@@ -145,35 +151,90 @@ maas list --type knowledge  # MaaS command
 
 The CLI now includes full MCP support for AI agent integration:
 
+### Start MCP Server Mode
+
 ```bash
-# Connect to MCP server
-lanonasis mcp connect          # Auto-detect mode
-lanonasis mcp connect --remote  # Use cloud API
-lanonasis mcp connect --local   # Use local server
+# 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
 
-# Check MCP status
-lanonasis mcp status
+# Or use npx without installation
+npx -y @lanonasis/cli mcp start
+```
 
-# List available tools
-lanonasis mcp tools
+### 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"
+      }
+    }
+  }
+}
+```
 
-# Memory operations via MCP
-lanonasis mcp memory create -t "Title" -c "Content"
-lanonasis mcp memory search "query"
+**Cursor/Windsurf** (Settings):
+```json
+{
+  "mcp.servers": {
+    "memory-service": {
+      "command": "lanonasis",
+      "args": ["mcp", "start"],
+      "env": {
+        "LANONASIS_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
 
-# Stream real-time updates
-lanonasis memory-mcp stream
+### MCP Commands
 
-# Configure MCP preferences
-lanonasis mcp config --prefer-remote
+```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:
-- **Unified Interface**: Same commands for local/remote backends
-- **Auto-Connect**: Automatically connects based on auth status
-- **Tool Discovery**: Dynamic listing of available MCP tools
-- **Real-time SSE**: Live updates when using remote mode
-- **Hybrid Mode**: Seamless fallback between MCP and REST API
+- **🔌 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
 
@@ -284,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/memory.js

@@ -6,6 +6,7 @@ import wrap from 'word-wrap';
 import { format } from 'date-fns';
 import { apiClient } from '../utils/api.js';
 import { formatBytes, truncateText } from '../utils/formatting.js';
+// Using GetMemoriesParams from api.ts
 export function memoryCommands(program) {
     // Create memory
     program
@@ -101,25 +102,26 @@ export function memoryCommands(program) {
         try {
             const spinner = ora('Fetching memories...').start();
             const params = {
-                page: parseInt(options.page || '1'),
+                offset: (parseInt(options.page || '1') - 1) * parseInt(options.limit || '20'),
                 limit: parseInt(options.limit || '20'),
-                sort: options.sort || 'created_at',
-                order: options.order || 'desc'
+                sort_by: (options.sort || 'created_at'),
+                sort_order: (options.order || 'desc')
             };
             if (options.type)
                 params.memory_type = options.type;
             if (options.tags)
-                params.tags = options.tags;
-            if (options.userId)
-                params.user_id = options.userId;
+                params.tags = options.tags.split(',').map(t => t.trim());
+            // Note: user_id filtering removed as it's handled by authentication
             const result = await apiClient.getMemories(params);
             spinner.stop();
-            if (result.memories.length === 0) {
+            if (result.data.length === 0) {
                 console.log(chalk.yellow('No memories found'));
                 return;
             }
             console.log(chalk.blue.bold(`\n📚 Memories (${result.pagination.total} total)`));
-            console.log(chalk.gray(`Page ${result.pagination.page} of ${result.pagination.pages}`));
+            const currentPage = Math.floor(result.pagination.offset / result.pagination.limit) + 1;
+            const totalPages = Math.ceil(result.pagination.total / result.pagination.limit);
+            console.log(chalk.gray(`Page ${currentPage} of ${totalPages}`));
             console.log();
             const outputFormat = process.env.CLI_OUTPUT_FORMAT || 'table';
             if (outputFormat === 'json') {
@@ -127,7 +129,7 @@ export function memoryCommands(program) {
             }
             else {
                 // Table format
-                const tableData = result.memories.map((memory) => [
+                const tableData = result.data.map((memory) => [
                     truncateText(memory.title, 30),
                     memory.memory_type,
                     memory.tags.slice(0, 3).join(', '),
@@ -135,7 +137,6 @@ export function memoryCommands(program) {
                     memory.access_count
                 ]);
                 const tableConfig = {
-                    header: ['Title', 'Type', 'Tags', 'Created', 'Access'],
                     columnDefault: {
                         width: 20,
                         wrapWord: true
@@ -148,10 +149,12 @@ export function memoryCommands(program) {
                         { width: 8 }
                     ]
                 };
-                console.log(table([tableConfig.header, ...tableData], tableConfig));
+                const tableHeaders = ['Title', 'Type', 'Tags', 'Created', 'Access'];
+                console.log(table([tableHeaders, ...tableData], tableConfig));
                 // Pagination info
-                if (result.pagination.pages > 1) {
-                    console.log(chalk.gray(`\nUse --page ${result.pagination.page + 1} for next page`));
+                if (result.pagination.has_more) {
+                    const nextPage = currentPage + 1;
+                    console.log(chalk.gray(`\nUse --page ${nextPage} for next page`));
                 }
             }
         }
@@ -185,14 +188,14 @@ export function memoryCommands(program) {
             }
             const result = await apiClient.searchMemories(query, searchOptions);
             spinner.stop();
-            if (result.results.length === 0) {
+            if (result.data.length === 0) {
                 console.log(chalk.yellow('No memories found matching your search'));
                 return;
             }
-            console.log(chalk.blue.bold(`\n🔍 Search Results (${result.total_results} found)`));
-            console.log(chalk.gray(`Query: "${query}" | Search time: ${result.search_time_ms}ms`));
+            console.log(chalk.blue.bold(`\n🔍 Search Results (${result.pagination.total} found)`));
+            console.log(chalk.gray(`Query: "${query}"`));
             console.log();
-            result.results.forEach((memory, index) => {
+            result.data.forEach((memory, index) => {
                 const score = (memory.relevance_score * 100).toFixed(1);
                 console.log(chalk.green(`${index + 1}. ${memory.title}`) + chalk.gray(` (${score}% match)`));
                 console.log(chalk.white(`   ${truncateText(memory.content, 100)}`));

package/dist/commands/topics.js

@@ -117,7 +117,6 @@ export function topicCommands(program) {
                     topic.parent_topic_id ? '✓' : ''
                 ]);
                 const tableConfig = {
-                    header: ['Name', 'Description', 'Color', 'Created', 'Child'],
                     columnDefault: {
                         width: 20,
                         wrapWord: true
@@ -130,7 +129,8 @@ export function topicCommands(program) {
                         { width: 8 }
                     ]
                 };
-                console.log(table([tableConfig.header, ...tableData], tableConfig));
+                const tableHeaders = ['Name', 'Description', 'System', 'Created'];
+                console.log(table([tableHeaders, ...tableData], tableConfig));
             }
         }
         catch (error) {

package/dist/index.js

@@ -46,7 +46,7 @@ program
                 }
             }
         }
-        catch (error) {
+        catch {
             if (process.env.CLI_VERBOSE === 'true') {
                 console.log(chalk.yellow('MCP auto-connect failed, using direct API'));
             }
@@ -198,8 +198,7 @@ program
 // Help customization
 program.configureHelp({
     formatHelp: (cmd, helper) => {
-        const term = helper.termWidth || 80;
-        const helpWidth = Math.min(term - 2, 80);
+        // Get terminal width for formatting (currently using default helper formatting)
         let help = chalk.blue.bold('🧠 Memory as a Service CLI\n\n');
         help += helper.commandUsage(cmd) + '\n\n';
         if (cmd.description()) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lanonasis/cli",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Lanonasis Enterprise CLI - Memory as a Service and Infrastructure Management",
   "main": "dist/index-simple.js",
   "bin": {