@lanonasis/cli 1.5.0 → 1.5.2

package/README.md

@@ -1,680 +1,378 @@
-# Lanonasis CLI - Enterprise AI Infrastructure Platform
+# @lanonasis/cli v1.5.2 - Onasis-Core Golden Contract CLI
 
-<div align="center">
+[![NPM Version](https://img.shields.io/npm/v/@lanonasis/cli)](https://www.npmjs.com/package/@lanonasis/cli)
+[![Downloads](https://img.shields.io/npm/dt/@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)
+[![Golden Contract](https://img.shields.io/badge/Onasis--Core-v0.1%20Compliant-gold)](https://api.lanonasis.com/.well-known/onasis.json)
 
-[![npm version](https://img.shields.io/npm/v/@lanonasis/cli?style=for-the-badge)](https://www.npmjs.com/package/@lanonasis/cli)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)
-[![Security: SOC 2](https://img.shields.io/badge/Security-SOC%202%20Type%20II-red?style=for-the-badge)](https://security.lanonasis.com)
-[![Compliance: ISO 27001](https://img.shields.io/badge/ISO-27001%20Certified-green?style=for-the-badge)](https://security.lanonasis.com)
-[![MCP Integration](https://img.shields.io/badge/MCP-Model%20Context%20Protocol-purple?style=for-the-badge)](https://modelcontextprotocol.com)
-[![Enterprise Ready](https://img.shields.io/badge/Enterprise-Ready-orange?style=for-the-badge)]()
+Professional command-line interface for LanOnasis Memory as a Service (MaaS) platform with **Golden Contract compliance**, comprehensive authentication, and enterprise-grade features.
 
-</div>
+## 🚀 Quick Start
 
-<div align="center">
-  <h3>🚀 Enterprise-Grade CLI for AI-Driven Infrastructure & Memory Management</h3>
-  <p>Unified command-line interface for Lanonasis ecosystem: Memory as a Service (MaaS), AI orchestration, and multi-tenant infrastructure management. Built for enterprise scale with Model Context Protocol (MCP) integration.</p>
-</div>
-
----
+### Installation
+```bash
+# Global installation (recommended)
+npm install -g @lanonasis/cli
 
-## 🏢 Enterprise Features
-
-<table>
-<tr>
-<td width="50%">
-
-### 🔐 Security & Compliance
-- **Zero Trust Architecture**: Never trust, always verify
-- **End-to-end Encryption**: AES-256 + TLS 1.3 with PFS
-- **Multi-factor Authentication**: FIDO2/WebAuthn + TOTP
-- **Role-Based Access Control**: Granular permissions & least privilege
-- **SOC 2 Type II + ISO 27001**: Independently audited
-- **24/7 Security Operations**: Real-time threat monitoring
-
-</td>
-<td width="50%">
-
-### 🚀 Performance & Scale
-- **High Availability**: 99.99% uptime SLA
-- **Global CDN**: Sub-100ms latency worldwide
-- **Horizontal Scaling**: Handle millions of requests
-- **Real-time Sync**: WebSocket & SSE support
-- **Batch Operations**: Process thousands of items
-
-</td>
-</tr>
-</table>
-
-## 🆕 New in v1.5.0
-- **OAuth Web Authentication**: Browser-based authentication with multiple providers
-- **Multiple Authentication Methods**: Username/password, OAuth, and API keys
-- **Tab Completions**: Intelligent shell completions for bash and zsh
-- **Core Gateway Integration**: Centralized authentication through Lanonasis Core
-- **Connections Listing**: View all available functions and services
-- **Enhanced CLI UX**: Better help system and short command aliases
-- **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
-
-## ⚡ Quick Start
+# Verify installation
+lanonasis --version  # or onasis --version
+```
 
+### First Steps
 ```bash
-# Install globally
-npm install -g @lanonasis/cli
+# Interactive guided setup (recommended for new users)
+onasis guide
 
-# Or use with npx (no installation needed)
-npx -y @lanonasis/cli init
+# Quick manual setup
+onasis init                                    # Initialize configuration
+onasis login --vendor-key pk_xxx.sk_xxx      # Authenticate with vendor key
+onasis health                                 # Verify system health
 
-# Short command aliases
-onasis -h                    # Help with short alias
-lanonasis -h                 # Help with full name
+# Create your first memory
+onasis memory create --title "Welcome" --content "My first memory"
+```
 
-# Initialize and authenticate (choose your method)
-lanonasis init
-lanonasis login              # Interactive login with method choice
+## 🎯 Command Aliases
 
-# API key authentication (for automation/AI agents)
-export LANONASIS_API_KEY=your_api_key
-lanonasis memory list
-# Or inline:
-lanonasis --api-key=your_key memory search "query"
-npx -y @lanonasis/cli --api-key=your_key memory list
+The CLI supports multiple command aliases for different use cases:
 
-# View all available connections and functions
-lanonasis list               # Show all available services
-lanonasis ls --type memory   # Focus on memory services
+| Command | Purpose | Golden Contract |
+|---------|---------|-----------------|
+| `onasis` | Golden Contract compliant interface | ✅ Yes |
+| `lanonasis` | Standard LanOnasis interface | ✅ Yes |
+| `memory` | Memory-focused operations | ✅ Yes |
+| `maas` | Memory as a Service operations | ✅ Yes |
 
-# Memory operations (also available as 'memory' and 'maas' commands)
-lanonasis memory create -t "My First Memory" -c "This is the content of my memory"
-lanonasis memory search "search query"
+```bash
+# All of these are equivalent:
+onasis memory list
 lanonasis memory list
+memory list
+maas memory list
+```
 
-# Install shell completions
-lanonasis install-completion --shell bash   # or zsh
+## 🔐 Authentication Methods
+
+### 1. Vendor Key Authentication (Recommended)
+Best for API integrations and automation:
+```bash
+onasis login --vendor-key pk_xxxxx.sk_xxxxx
 ```
 
-## 🚀 Installation
+### 2. OAuth Browser Authentication
+Secure browser-based authentication:
+```bash
+onasis login --oauth
+```
 
-### Global Installation (Recommended)
+### 3. Interactive Credentials
+Traditional username/password authentication:
 ```bash
-npm install -g @lanonasis/cli
+onasis login  # Will prompt for email and password
 ```
 
-### NPX Usage (No Installation)
+### Authentication Status
 ```bash
-npx -y @lanonasis/cli --help
-npx -y @lanonasis/cli init
+onasis auth status    # Check current authentication
+onasis auth logout    # Logout from current session
 ```
 
-### Local Installation
+## 💻 Shell Completions
+
+### Installation Guide
 ```bash
-npm install @lanonasis/cli
-npx lanonasis --help
-```
-
-## 📋 Available Commands
-
-### 🔧 Setup & Configuration
-- `lanonasis init` - Initialize CLI and show setup instructions
-- `lanonasis config set <key> <value>` - Set configuration values
-- `lanonasis config get <key>` - Get configuration value
-- `lanonasis config list` - List all configuration options
-- `lanonasis status` - Show CLI status and configuration
-
-### 🔐 Authentication
-- `lanonasis login` - Interactive login with method choice
-- `lanonasis auth login` - Authenticate with your services
-- `lanonasis auth logout` - Sign out
-- `lanonasis auth status` - Check authentication status
-
-### 📝 Memory Operations
-- `lanonasis memory create -t "Title" -c "Content" [--type <type>]` - Create new memory
-- `lanonasis memory search <query> [-l <limit>]` - Search memories
-- `lanonasis memory list [-l <limit>] [--type <type>]` - List memories
-- `lanonasis list` - Show all available connections and functions
-- `lanonasis help` - Show detailed help
-
-#### Alternative Commands & Aliases
-- `memory <command>` - Direct memory operations
-- `maas <command>` - Memory as a Service operations  
-- `onasis <command>` - Short alias for lanonasis
-- `lanonasis ls` - Alias for list command
-
-### 🔗 Connections & Functions
-- `lanonasis list` - Show all available services and functions
-- `lanonasis ls --type memory` - Focus on memory services only
-- `lanonasis ls --type api` - Show API connections
-- `lanonasis ls --type mcp` - Show MCP tools
-
-### 🎯 Shell Completions
-- `lanonasis completion --shell bash` - Generate bash completions
-- `lanonasis completion --shell zsh` - Generate zsh completions
-- `lanonasis install-completion` - Install completions for current shell
-
-## 🧠 Memory Types
-
-The CLI supports the following memory types:
-- **conversation** - Chat and dialogue context
-- **knowledge** - Educational and reference content
-- **project** - Project-specific documentation
-- **context** - General contextual information
-- **reference** - Quick reference materials
-
-## ⚙️ Configuration
-
-Configure your CLI to connect to your Lanonasis services:
+onasis completion  # Shows installation instructions for all shells
+```
 
+### Direct Installation
 ```bash
-# Set your service endpoint
-lanonasis config set api-url https://your-lanonasis-service.com
+# Bash
+echo 'source <(onasis --completion bash)' >> ~/.bashrc
+
+# Zsh
+echo 'source <(onasis --completion zsh)' >> ~/.zshrc
 
-# View current configuration
-lanonasis config list
+# Fish
+echo 'onasis --completion fish | source' >> ~/.config/fish/config.fish
 ```
 
-## 🔒 Authentication
+### Features
+- ✅ Command and subcommand completion
+- ✅ Option and flag completion  
+- ✅ Context-aware suggestions
+- ✅ Dynamic completion data via JSON API
+- ✅ Support for all command aliases
 
-The CLI supports multiple authentication methods for different use cases:
+## 📚 Core Commands
 
-### Interactive Authentication
+### System Management
 ```bash
-# Choose your preferred method (username/password or OAuth)
-lanonasis login
-
-# Traditional method-specific login
-lanonasis auth login
+onasis health           # Comprehensive system health check
+onasis status          # Quick status overview  
+onasis init            # Initialize CLI configuration
+onasis guide           # Interactive setup guide
+onasis quickstart      # Essential commands reference
 ```
 
-**Available Methods:**
-- **🔑 Username/Password**: Direct login with email and password
-- **🌐 OAuth/Web Browser**: Secure browser-based authentication with multiple providers
+### Memory Management
+```bash
+# List memories
+onasis memory list
+onasis memory list --memory-type context --limit 20 --sort-by created_at
+
+# Create memories
+onasis memory create --title "Project Notes" --content "Important information"
+onasis memory create --title "Reference" --memory-type reference --tags "docs,api"
+
+# Search memories
+onasis memory search "api integration"
+onasis memory search "meeting notes" --memory-types context,reference
+
+# Memory operations
+onasis memory get <id>                    # Get specific memory
+onasis memory update <id> --title "New Title"
+onasis memory delete <id>                 # Delete memory
+onasis memory stats                       # Memory statistics
+```
 
-### API Key Authentication (for Automation)
+### Topic Management
 ```bash
-# Environment variable (recommended for scripts)
-export LANONASIS_API_KEY=your_api_key_here
-lanonasis memory list
+onasis topic list                         # List all topics
+onasis topic create --name "Development" --color blue --icon "💻"
+onasis topic get <id>                     # Get specific topic
+onasis topic update <id> --description "New description"
+onasis topic delete <id>                  # Delete topic
+```
 
-# Command-line option
-lanonasis --api-key=your_key memory search "query"
+### API Key Management
+```bash
+onasis api-keys list                      # List API keys
+onasis api-keys create --name "Integration Key" --scope "memory:read"
+onasis api-keys revoke <id>               # Revoke API key
+onasis api-keys rotate <id>               # Rotate API key
+```
 
-# NPX usage with API key (for AI agents)
-npx -y @lanonasis/cli --api-key=your_key memory list
+### MCP Integration
+```bash
+onasis mcp status                         # MCP server status
+onasis mcp connect --remote              # Connect to remote MCP server
+onasis mcp disconnect                     # Disconnect from MCP
+onasis mcp tools                          # List available MCP tools
+onasis mcp resources                      # List MCP resources
 ```
 
-### Authentication Status
+### Configuration Management  
 ```bash
-# Check current authentication
-lanonasis auth status
+onasis config list                        # List all configuration
+onasis config get <key>                   # Get configuration value
+onasis config set <key> <value>           # Set configuration value
+onasis config reset                       # Reset configuration
+```
 
-# Logout (clears all auth methods)
-lanonasis auth logout
+### Service Management
+```bash
+onasis service list                       # List all services
+onasis service status                     # Service status overview
+onasis service restart <service>          # Restart specific service
+onasis deploy status                      # Deployment status
+onasis deploy health                      # Deployment health check
 ```
 
-## 📖 Usage Examples
+## ⚙️ Global Options
 
 ```bash
-# Create different types of memories
-lanonasis create -t "Meeting Notes" -c "Project kickoff discussion" --type project
-lanonasis create -t "API Reference" -c "POST /api/memories endpoint" --type reference
-lanonasis create -t "Learning Notes" -c "Vector embeddings concepts" --type knowledge
+# Available for all commands
+--help              # Show command help
+--version           # Show version information
+--verbose           # Enable verbose logging
+--output <format>   # Output format: table, json, yaml, csv
+--api-url <url>     # Override API URL
+--no-mcp           # Disable MCP and use direct API
+```
 
-# Using npx (no installation)
-npx -y @lanonasis/cli create -t "Quick Note" -c "NPX usage example"
+## 🎯 Advanced Usage
 
-# Search with different options
-lanonasis search "API endpoints" -l 5
-lanonasis search "project meeting"
+### JSON Output for Automation
+```bash
+onasis memory list --output json | jq '.data[].title'
+onasis health --output json | jq '.status'
+```
 
-# List with filters
-lanonasis list --type project -l 10
-lanonasis list -l 20
+### Environment Variables
+```bash
+export MEMORY_API_URL="https://api.lanonasis.com/api/v1"
+export CLI_OUTPUT_FORMAT="json"
+export CLI_VERBOSE="true"
+```
 
-# Alternative command usage
-memory search "my query"  # Direct memory command
-maas list --type knowledge  # MaaS command
+### Configuration File
+Location: `~/.maas/config.json`
+```json
+{
+  "apiUrl": "https://api.lanonasis.com/api/v1",
+  "defaultOutputFormat": "table",
+  "mcpPreference": "auto",
+  "vendorKey": "pk_xxxxx.sk_xxxxx"
+}
 ```
 
-## 🤖 MCP Integration (Model Context Protocol)
+## 🔧 Development & Debugging
 
-The CLI now includes full MCP support for AI agent integration:
+### Verbose Mode
+```bash
+onasis --verbose memory list    # Detailed operation logs
+onasis -V health               # Short flag version
+```
 
-### Start MCP Server Mode
+### Configuration Debugging
+```bash
+onasis config list             # Check current configuration
+onasis auth status            # Verify authentication
+onasis health --verbose       # Detailed health information
+```
 
+### MCP Debugging
 ```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
+onasis mcp status --verbose    # Detailed MCP diagnostics
+onasis --no-mcp memory list   # Bypass MCP, use direct API
+```
+
+## 🌐 Golden Contract Compliance
+
+### Onasis-Core v0.1 Standards
+- ✅ Service discovery via `/.well-known/onasis.json`
+- ✅ Vendor key authentication (`pk_*.sk_*` format)
+- ✅ Request correlation with UUID tracking
+- ✅ Enhanced CORS security compliance
+- ✅ Uniform error envelope standardization
+- ✅ WebSocket path alignment (`/mcp/ws`)
 
-# Or use npx without installation
-npx -y @lanonasis/cli mcp start
+### Service Discovery Integration
+The CLI automatically discovers service endpoints:
+```bash
+# Service discovery happens automatically
+onasis health  # Uses discovered endpoints for health checks
 ```
 
-### Configure AI Assistants
+### Request Correlation
+Every API request includes correlation headers:
+- `X-Request-ID`: UUID for request tracking
+- `X-Project-Scope`: Project scope validation
+- `X-Auth-Method`: Authentication method used
 
-**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"
-      }
-    }
-  }
-}
+## 🧪 Testing & Quality
+
+### Command Validation
+```bash
+onasis --help                  # Validate CLI installation
+onasis completion              # Test completion system
+onasis guide                   # Test interactive guidance
 ```
 
-**Cursor/Windsurf** (Settings):
-```json
-{
-  "mcp.servers": {
-    "memory-service": {
-      "command": "lanonasis",
-      "args": ["mcp", "start"],
-      "env": {
-        "LANONASIS_API_KEY": "your-api-key-here"
-      }
-    }
-  }
-}
+### API Integration Testing
+```bash
+onasis health                  # Test API connectivity
+onasis memory list --limit 1  # Test memory service
+onasis mcp status             # Test MCP integration
 ```
 
-### MCP Commands
+## 🚨 Troubleshooting
 
+### Common Issues
+
+#### Authentication Failures
 ```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:
-- RESTful API endpoints
-- JWT or API key authentication
-- Vector-based memory search
-- Multi-tenant memory storage
-
-### Setting up your MaaS Service
-
-1. **Deploy** a MaaS service using the provided backend
-2. **Configure** the CLI with your service endpoint
-3. **Authenticate** using your service credentials
-4. **Start** managing your memories!
-
-## 🛠️ Development
-
-### Prerequisites
-- Node.js 18+
-- npm or yarn
-
-### Local Development
-```bash
-git clone <repository-url>
-cd memory-cli
-npm install
+# Check authentication status
+onasis auth status
 
-# Development mode
-npm run dev
+# Re-authenticate
+onasis auth logout
+onasis login --vendor-key pk_xxx.sk_xxx
+```
 
-# Build
-npm run build
+#### Connection Issues
+```bash
+# Check system health
+onasis health --verbose
 
-# Test locally
-node dist/index-simple.js help
+# Test API connectivity
+onasis --api-url https://api.lanonasis.com/api/v1 health
 ```
 
-## 📦 What's Included
+#### MCP Connection Issues
+```bash
+# Check MCP status
+onasis mcp status --verbose
 
-- **Full CLI Interface** - Complete command-line tool
-- **Memory Management** - Create, search, list memories
-- **Type System** - Organized memory categorization
-- **Authentication** - Secure service integration
-- **Configuration** - Flexible service setup
-- **Help System** - Comprehensive documentation
+# Disable MCP temporarily
+onasis --no-mcp memory list
+```
 
-## 📦 SDK & Related Packages
+### Debug Mode
+```bash
+# Enable maximum verbosity
+CLI_VERBOSE=true onasis --verbose health
+```
 
-### Memory Client SDK
-Install the TypeScript/JavaScript SDK for application integration:
+## 🤝 Contributing
 
+### Development Setup
 ```bash
-# Install SDK for your applications
-npm install @lanonasis/memory-client
+# Clone CLI source
+git clone https://github.com/lanonasis/lanonasis-maas.git
+cd lanonasis-maas/cli
 
-# Use in your code
-import { createMemoryClient } from '@lanonasis/memory-client';
+# Install dependencies
+npm install
 
-const client = createMemoryClient({
-  baseURL: 'https://api.lanonasis.com',
-  apiKey: 'your-api-key-here'
-});
+# Build CLI
+npm run build
+
+# Link for local development
+npm link
 ```
 
-### Complete Installation for Developers
+### Testing Changes
 ```bash
-# Install CLI globally for command-line usage
-npm install -g @lanonasis/cli
-
-# Install SDK locally for application development
-npm install @lanonasis/memory-client
+# Test build
+npm run build
 
-# Now you have both CLI and SDK available!
-lanonasis --help                    # CLI commands
-# SDK available for import in your code
+# Test CLI functionality
+onasis --help
+onasis health
 ```
 
-## 🔗 Related Projects
+## 📝 Version History
 
-- **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)
+### v1.5.2 (Current)
+- ✅ Golden Contract compliance (Onasis-Core v0.1)
+- ✅ Professional shell completions (bash/zsh/fish)
+- ✅ Enhanced authentication (vendor keys, OAuth, credentials)
+- ✅ Interactive user guidance system
+- ✅ Dual command support (lanonasis/onasis)
+- ✅ Service discovery integration
+- ✅ Request correlation and enhanced security
+
+### Previous Versions
+- v1.4.x: Basic CLI functionality
+- v1.3.x: MCP integration
+- v1.2.x: Memory management
+- v1.1.x: Initial authentication
+- v1.0.x: Core CLI framework
 
 ## 📄 License
 
-MIT License - see LICENSE file for details
+MIT License - see [LICENSE](../LICENSE) for details.
 
-## 🤝 Contributing
+## 🔗 Related Links
 
-1. Fork the repository
-2. Create your feature branch (`git checkout -b feature/amazing-feature`)
-3. Commit your changes (`git commit -m 'Add amazing feature'`)
-4. Push to the branch (`git push origin feature/amazing-feature`)
-5. Open a Pull Request
-
-## 🐛 Support
-
-- **Issues**: [GitHub Issues](https://github.com/seyederick/memory-cli/issues)
-- **Documentation**: [CLI Documentation](https://github.com/seyederick/memory-cli)
-
-## 🎯 Use Cases
-
-- **Personal Knowledge Management** - Organize your thoughts and notes
-- **Team Knowledge Sharing** - Collaborative memory management
-- **Project Documentation** - Context-aware project memories
-- **Research Organization** - Academic and research note-taking
-- **API Integration** - Programmatic memory management
-
-## 🏆 Enterprise Deployment
-
-### 📊 Performance Benchmarks
-
-<table>
-<tr>
-<th>Metric</th>
-<th>Performance</th>
-<th>Scale</th>
-</tr>
-<tr>
-<td>Request Latency</td>
-<td><strong>&lt; 50ms</strong> p99</td>
-<td>Global average</td>
-</tr>
-<tr>
-<td>Memory Search</td>
-<td><strong>&lt; 100ms</strong></td>
-<td>1M+ vectors</td>
-</tr>
-<tr>
-<td>Concurrent Users</td>
-<td><strong>100K+</strong></td>
-<td>Per instance</td>
-</tr>
-<tr>
-<td>API Throughput</td>
-<td><strong>10K RPS</strong></td>
-<td>Per node</td>
-</tr>
-<tr>
-<td>Data Retention</td>
-<td><strong>Unlimited</strong></td>
-<td>With archival</td>
-</tr>
-</table>
-
-### 🏗️ Architecture
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                    Lanonasis CLI v1.5.0                     │
-├─────────────────┬───────────────────┬──────────────────────┤
-│   Auth Layer    │   Command Layer   │    Transport Layer   │
-├─────────────────┼───────────────────┼──────────────────────┤
-│ • OAuth 2.0     │ • Memory CRUD     │ • REST API          │
-│ • API Keys      │ • Vector Search   │ • WebSocket         │
-│ • JWT Tokens    │ • Batch Ops       │ • SSE Streaming     │
-│ • MFA Support   │ • Admin Tools     │ • MCP Protocol      │
-└─────────────────┴───────────────────┴──────────────────────┘
-                           ↓
-┌─────────────────────────────────────────────────────────────┐
-│                  Lanonasis Core Gateway                     │
-├─────────────────────────────────────────────────────────────┤
-│        PostgreSQL + pgvector | Redis | OpenAI API          │
-└─────────────────────────────────────────────────────────────┘
-```
-
-### 🚀 Commercial Deployments
-
-#### Industry Solutions
-
-<table>
-<tr>
-<td width="33%">
-
-**🏦 Financial Services**
-- Transaction context tracking
-- Compliance audit trails
-- Risk assessment memory
-- Customer interaction history
-
-</td>
-<td width="33%">
-
-**🏥 Healthcare**
-- Patient context management
-- Treatment history tracking
-- Clinical decision support
-- HIPAA compliant storage
-
-</td>
-<td width="33%">
-
-**🎓 Education**
-- Student learning paths
-- Knowledge retention tracking
-- Collaborative research
-- Academic memory sharing
-
-</td>
-</tr>
-</table>
-
-### 🔒 Security & Compliance
-
-<table>
-<tr>
-<td width="50%">
-
-#### 🏛️ Certifications & Standards
-- **ISO 27001:2013** - Information Security Management
-- **SOC 2 Type II** - Service Organization Controls
-- **ISO 27017** - Cloud Security Controls
-- **ISO 27018** - Cloud Privacy Protection
-- **FedRAMP Moderate** - US Government Cloud Security
-- **CSA STAR Level 2** - Cloud Security Alliance
-
-#### 🌍 Regional Compliance
-- **GDPR** (EU) - General Data Protection Regulation
-- **CCPA** (California) - Consumer Privacy Act
-- **PIPEDA** (Canada) - Personal Information Protection
-- **LGPD** (Brazil) - Lei Geral de Proteção de Dados
-- **PDPA** (Singapore) - Personal Data Protection Act
-
-</td>
-<td width="50%">
-
-#### 🏥 Industry Standards
-- **HIPAA** - Healthcare Information Portability
-- **PCI DSS Level 1** - Payment Card Industry Security
-- **FISMA** - Federal Information Security Management
-- **NIST Cybersecurity Framework** - Risk Management
-- **HITRUST CSF** - Healthcare Security Framework
-- **21 CFR Part 11** - FDA Electronic Records
-
-#### 🔐 Security Controls
-- **Zero Trust Architecture** - Never trust, always verify
-- **End-to-End Encryption** - AES-256 + TLS 1.3
-- **Multi-Factor Authentication** - FIDO2/WebAuthn support
-- **Role-Based Access Control** - Least privilege principle
-- **Security Monitoring** - 24/7 SOC with SIEM
-- **Penetration Testing** - Quarterly by certified firms
-
-</td>
-</tr>
-</table>
-
-#### 🛡️ Data Protection Guarantees
-
-| Security Feature | Implementation | Audit Frequency |
-|------------------|----------------|-----------------|
-| **Encryption at Rest** | AES-256 with FIPS 140-2 HSMs | Continuous |
-| **Encryption in Transit** | TLS 1.3 with Perfect Forward Secrecy | Real-time |
-| **Key Management** | AWS KMS + Azure Key Vault | Monthly |
-| **Access Logging** | Immutable audit trails | Daily review |
-| **Data Backup** | 3-2-1 strategy with geo-replication | Weekly verification |
-| **Incident Response** | <15 min detection, <1hr response | Quarterly drills |
-
-#### 🎖️ Security Partnerships
-
-<table>
-<tr>
-<td align="center" width="25%">
-<strong>AWS Security</strong><br/>
-Advanced Technology Partner
-</td>
-<td align="center" width="25%">
-<strong>Microsoft Security</strong><br/>
-Gold Cloud Platform Partner
-</td>
-<td align="center" width="25%">
-<strong>Okta Verified</strong><br/>
-Identity & Access Management
-</td>
-<td align="center" width="25%">
-<strong>CrowdStrike</strong><br/>
-Endpoint Protection Partner
-</td>
-</tr>
-</table>
-
-### 📈 Enterprise Support
-
-| Plan | Response Time | Support Level | Price |
-|------|--------------|---------------|-------|
-| **Starter** | 24 hours | Email | Free |
-| **Professional** | 4 hours | Email + Chat | $299/mo |
-| **Enterprise** | 30 minutes | 24/7 Phone + Dedicated | Custom |
-
-### 🌍 Global Infrastructure
-
-- **6 Regions**: US East/West, EU, APAC, SA, AF
-- **99.99% Uptime** SLA guarantee
-- **Automatic Failover** across regions
-- **Data Residency** options available
-- **Edge Caching** via global CDN
+- **NPM Package**: [https://www.npmjs.com/package/@lanonasis/cli](https://www.npmjs.com/package/@lanonasis/cli)
+- **Main Repository**: [https://github.com/lanonasis/lanonasis-maas](https://github.com/lanonasis/lanonasis-maas)
+- **Documentation**: [https://docs.lanonasis.com/cli](https://docs.lanonasis.com/cli)
+- **API Documentation**: [https://api.lanonasis.com/docs](https://api.lanonasis.com/docs)
+- **Service Discovery**: [https://api.lanonasis.com/.well-known/onasis.json](https://api.lanonasis.com/.well-known/onasis.json)
+- **Dashboard**: [https://api.lanonasis.com/dashboard](https://api.lanonasis.com/dashboard)
 
 ---
 
-<div align="center">
-
-### 🎯 Trusted by Industry Leaders
-
-<table>
-<tr>
-<td align="center">
-<strong>10M+</strong><br/>
-API Calls Daily
-</td>
-<td align="center">
-<strong>500K+</strong><br/>
-Active Users
-</td>
-<td align="center">
-<strong>99.99%</strong><br/>
-Uptime SLA
-</td>
-<td align="center">
-<strong>50ms</strong><br/>
-Avg Latency
-</td>
-</tr>
-</table>
-
-### 🛡️ Security & Vulnerability Disclosure
-
-We take security seriously. If you discover a security vulnerability, please follow our responsible disclosure process:
-
-**🚨 Security Contact**: security@lanonasis.com  
-**🔒 PGP Key**: [Download Public Key](https://security.lanonasis.com/pgp)  
-**⏱️ Response Time**: 24 hours for critical, 72 hours for non-critical  
-**💰 Bug Bounty**: Up to $10,000 for critical vulnerabilities  
-
-#### Security Reporting Guidelines
-- **DO**: Report vulnerabilities privately to our security team
-- **DO**: Provide detailed reproduction steps and impact assessment
-- **DO**: Allow reasonable time for patching before public disclosure
-- **DON'T**: Access user data or disrupt service operations
-- **DON'T**: Perform automated scanning without prior authorization
-
-### 📞 Enterprise Contact
-
-🔗 **Sales**: enterprise@lanonasis.com  
-📚 **Documentation**: [docs.lanonasis.com](https://docs.lanonasis.com)  
-🛟 **Support**: [support.lanonasis.com](https://support.lanonasis.com)  
-🌐 **Platform**: [api.lanonasis.com](https://api.lanonasis.com)  
-🛡️ **Security**: [security.lanonasis.com](https://security.lanonasis.com)  
-
-<br/>
-
-**© 2024 Lanonasis Corporation. All rights reserved.**
-
-</div>
+*Professional CLI for Enterprise Memory as a Service - Golden Contract Compliant*