@lanonasis/cli 1.5.1 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,403 +1,387 @@
1
- # Lanonasis CLI - Enterprise Infrastructure Management
1
+ # @lanonasis/cli v2.0.0 - Enhanced Interactive CLI Experience
2
2
 
3
- [![npm version](https://img.shields.io/npm/v/@lanonasis/cli)](https://www.npmjs.com/package/@lanonasis/cli)
3
+ [![NPM Version](https://img.shields.io/npm/v/@lanonasis/cli)](https://www.npmjs.com/package/@lanonasis/cli)
4
+ [![Downloads](https://img.shields.io/npm/dt/@lanonasis/cli)](https://www.npmjs.com/package/@lanonasis/cli)
4
5
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
5
- [![MCP Integration](https://img.shields.io/badge/MCP-Model%20Context%20Protocol-purple)](https://modelcontextprotocol.com)
6
-
7
- 🚀 **Professional CLI for Lanonasis Platform Services with MCP Integration**
8
-
9
- 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.
10
-
11
- ## 🆕 New in v1.2.0 - API Key Management Integration
12
- - **API Key Management**: Complete CLI commands for secure API key lifecycle management
13
- - **MCP Tool Registration**: Register and manage MCP tools with scoped API access
14
- - **Analytics & Security**: Track usage patterns and monitor security events
15
- - **Project-based Organization**: Group API keys by projects for better organization
16
- - **Zero-trust Security**: Encrypted key storage with proxy token generation
17
- - **MCP Server Mode**: Run as MCP server for AI assistants (Claude, Cursor, Windsurf)
18
- - **Hybrid Architecture**: Seamless switching between local MCP and remote API
19
- - **Real-time Updates**: SSE streaming for live memory synchronization
20
-
21
- ## 🆕 New in v1.2.1 - Enhanced CLI Experience
22
- - **🎨 Colorful VPS-style Interface**: Beautiful terminal output with intuitive color coding
23
- - **📊 Enhanced System Status**: Comprehensive health checks and service monitoring
24
- - **🔍 Improved Version Management**: Better version tracking and update notifications
25
- - **⚡ Performance Optimizations**: Faster command execution and response times
26
- - **🛡️ Enhanced Security Checks**: Real-time API endpoint validation
27
- - **📈 Usage Statistics**: Track your CLI usage patterns and command history
28
- - **🌈 Color-coded Output**: Error states, success messages, and warnings in vibrant colors
29
- - **🔄 Auto-update Notifications**: Get notified when new versions are available
30
-
31
- ## ⚡ Quick Start
6
+ [![Golden Contract](https://img.shields.io/badge/Onasis--Core-v0.1%20Compliant-gold)](https://api.lanonasis.com/.well-known/onasis.json)
32
7
 
8
+ 🚀 **NEW IN v2.0**: Revolutionary interactive CLI experience with guided workflows, smart suggestions, achievement system, and power user mode. Professional command-line interface for LanOnasis Memory as a Service (MaaS) platform with **Golden Contract compliance**.
9
+
10
+ ## 🚀 Quick Start
11
+
12
+ ### Installation
33
13
  ```bash
34
- # Install globally
14
+ # Global installation (recommended)
35
15
  npm install -g @lanonasis/cli
36
16
 
37
- # Or use with npx (no installation needed)
38
- npx -y @lanonasis/cli init
17
+ # Verify installation
18
+ lanonasis --version # or onasis --version
19
+ ```
39
20
 
40
- # Initialize Lanonasis services
41
- lanonasis init
21
+ ### First Steps
22
+ ```bash
23
+ # Interactive guided setup (recommended for new users)
24
+ onasis guide
42
25
 
43
- # Configure your services
44
- lanonasis config set api-url https://your-lanonasis-service.com
26
+ # Quick manual setup
27
+ onasis init # Initialize configuration
28
+ onasis login --vendor-key pk_xxx.sk_xxx # Authenticate with vendor key
29
+ onasis health # Verify system health
45
30
 
46
- # Authenticate
47
- lanonasis auth login
31
+ # Create your first memory
32
+ onasis memory create --title "Welcome" --content "My first memory"
33
+ ```
48
34
 
49
- # Memory operations (also available as 'memory' and 'maas' commands)
50
- lanonasis memory create -t "My First Memory" -c "This is the content of my memory"
51
- lanonasis memory search "search query"
52
- lanonasis memory list
35
+ ## 🎯 Command Aliases
53
36
 
54
- # Infrastructure management (future services)
55
- lanonasis deploy status
56
- lanonasis services list
57
- ```
37
+ The CLI supports multiple command aliases for different use cases:
58
38
 
59
- ## 🚀 Installation
39
+ | Command | Purpose | Golden Contract |
40
+ |---------|---------|-----------------|
41
+ | `onasis` | Golden Contract compliant interface | ✅ Yes |
42
+ | `lanonasis` | Standard LanOnasis interface | ✅ Yes |
43
+ | `memory` | Memory-focused operations | ✅ Yes |
44
+ | `maas` | Memory as a Service operations | ✅ Yes |
60
45
 
61
- ### Global Installation (Recommended)
62
46
  ```bash
63
- npm install -g @lanonasis/cli
47
+ # All of these are equivalent:
48
+ onasis memory list
49
+ lanonasis memory list
50
+ memory list
51
+ maas memory list
64
52
  ```
65
53
 
66
- ### NPX Usage (No Installation)
54
+ ## 🔐 Authentication Methods
55
+
56
+ ### 1. Vendor Key Authentication (Recommended)
57
+ Best for API integrations and automation:
67
58
  ```bash
68
- npx -y @lanonasis/cli --help
69
- npx -y @lanonasis/cli init
59
+ onasis login --vendor-key pk_xxxxx.sk_xxxxx
70
60
  ```
71
61
 
72
- ### Local Installation
62
+ ### 2. OAuth Browser Authentication
63
+ Secure browser-based authentication:
73
64
  ```bash
74
- npm install @lanonasis/cli
75
- npx lanonasis --help
76
- ```
77
-
78
- ## 📋 Available Commands
79
-
80
- ### 🔧 Setup & Configuration
81
- - `lanonasis init` - Initialize CLI and show setup instructions
82
- - `lanonasis config set <key> <value>` - Set configuration values
83
- - `lanonasis config get <key>` - Get configuration value
84
- - `lanonasis config list` - List all configuration options
85
- - `lanonasis status` - Show CLI status and configuration
86
-
87
- ### 🔐 Authentication
88
- - `lanonasis auth login` - Authenticate with your services
89
- - `lanonasis auth logout` - Sign out
90
- - `lanonasis auth status` - Check authentication status
91
-
92
- ### 📝 Memory Operations
93
- - `lanonasis create -t "Title" -c "Content" [--type <type>]` - Create new memory
94
- - `lanonasis search <query> [-l <limit>]` - Search memories
95
- - `lanonasis list [-l <limit>] [--type <type>]` - List memories
96
- - `lanonasis help` - Show detailed help
97
-
98
- ### 🔑 API Key Management (NEW in v1.2.0)
99
- - `lanonasis api-keys create` - Create a new API key with secure encryption
100
- - `lanonasis api-keys list` - List all API keys with usage statistics
101
- - `lanonasis api-keys get <keyId>` - Get details of a specific API key
102
- - `lanonasis api-keys update <keyId>` - Update API key name, tags, or rotation policy
103
- - `lanonasis api-keys delete <keyId>` - Securely delete an API key
104
- - `lanonasis api-keys projects create` - Create a project for organizing keys
105
- - `lanonasis api-keys projects list` - List all API key projects
106
- - `lanonasis api-keys mcp register-tool` - Register MCP tools for API access
107
- - `lanonasis api-keys mcp list-tools` - List registered MCP tools
108
- - `lanonasis api-keys mcp request-access` - Request access to API keys via MCP
109
- - `lanonasis api-keys analytics usage` - View API key usage analytics
110
- - `lanonasis api-keys analytics security-events` - Monitor security events
111
-
112
- #### Alternative Commands (Backwards Compatibility)
113
- - `memory <command>` - Direct memory operations
114
- - `maas <command>` - Memory as a Service operations
115
-
116
- ## 🧠 Memory Types
117
-
118
- The CLI supports the following memory types:
119
- - **conversation** - Chat and dialogue context
120
- - **knowledge** - Educational and reference content
121
- - **project** - Project-specific documentation
122
- - **context** - General contextual information
123
- - **reference** - Quick reference materials
124
-
125
- ## ⚙️ Configuration
126
-
127
- Configure your CLI to connect to your Lanonasis services:
65
+ onasis login --oauth
66
+ ```
128
67
 
68
+ ### 3. Interactive Credentials
69
+ Traditional username/password authentication:
129
70
  ```bash
130
- # Set your service endpoint
131
- lanonasis config set api-url https://your-lanonasis-service.com
71
+ onasis login # Will prompt for email and password
72
+ ```
132
73
 
133
- # View current configuration
134
- lanonasis config list
74
+ ### Authentication Status
75
+ ```bash
76
+ onasis auth status # Check current authentication
77
+ onasis auth logout # Logout from current session
135
78
  ```
136
79
 
137
- ## 🔒 Authentication
80
+ ## 💻 Shell Completions
138
81
 
139
- Authenticate with your Lanonasis platform:
82
+ ### Installation Guide
83
+ ```bash
84
+ onasis completion # Shows installation instructions for all shells
85
+ ```
140
86
 
87
+ ### Direct Installation
141
88
  ```bash
142
- # Login to your service
143
- lanonasis auth login
89
+ # Bash
90
+ echo 'source <(onasis --completion bash)' >> ~/.bashrc
144
91
 
145
- # Check authentication status
146
- lanonasis auth status
92
+ # Zsh
93
+ echo 'source <(onasis --completion zsh)' >> ~/.zshrc
147
94
 
148
- # Logout
149
- lanonasis auth logout
95
+ # Fish
96
+ echo 'onasis --completion fish | source' >> ~/.config/fish/config.fish
150
97
  ```
151
98
 
152
- ## 📖 Usage Examples
99
+ ### Features
100
+ - ✅ Command and subcommand completion
101
+ - ✅ Option and flag completion
102
+ - ✅ Context-aware suggestions
103
+ - ✅ Dynamic completion data via JSON API
104
+ - ✅ Support for all command aliases
105
+
106
+ ## 📚 Core Commands
153
107
 
108
+ ### System Management
154
109
  ```bash
155
- # Create different types of memories
156
- lanonasis create -t "Meeting Notes" -c "Project kickoff discussion" --type project
157
- lanonasis create -t "API Reference" -c "POST /api/memories endpoint" --type reference
158
- lanonasis create -t "Learning Notes" -c "Vector embeddings concepts" --type knowledge
110
+ onasis health # Comprehensive system health check
111
+ onasis status # Quick status overview
112
+ onasis init # Initialize CLI configuration
113
+ onasis guide # Interactive setup guide
114
+ onasis quickstart # Essential commands reference
115
+ ```
159
116
 
160
- # Using npx (no installation)
161
- npx -y @lanonasis/cli create -t "Quick Note" -c "NPX usage example"
117
+ ### Memory Management
118
+ ```bash
119
+ # List memories
120
+ onasis memory list
121
+ onasis memory list --memory-type context --limit 20 --sort-by created_at
122
+
123
+ # Create memories
124
+ onasis memory create --title "Project Notes" --content "Important information"
125
+ onasis memory create --title "Reference" --memory-type reference --tags "docs,api"
126
+
127
+ # Search memories
128
+ onasis memory search "api integration"
129
+ onasis memory search "meeting notes" --memory-types context,reference
130
+
131
+ # Memory operations
132
+ onasis memory get <id> # Get specific memory
133
+ onasis memory update <id> --title "New Title"
134
+ onasis memory delete <id> # Delete memory
135
+ onasis memory stats # Memory statistics
136
+ ```
162
137
 
163
- # Search with different options
164
- lanonasis search "API endpoints" -l 5
165
- lanonasis search "project meeting"
138
+ ### Topic Management
139
+ ```bash
140
+ onasis topic list # List all topics
141
+ onasis topic create --name "Development" --color blue --icon "💻"
142
+ onasis topic get <id> # Get specific topic
143
+ onasis topic update <id> --description "New description"
144
+ onasis topic delete <id> # Delete topic
145
+ ```
166
146
 
167
- # List with filters
168
- lanonasis list --type project -l 10
169
- lanonasis list -l 20
147
+ ### API Key Management
148
+ ```bash
149
+ onasis api-keys list # List API keys
150
+ onasis api-keys create --name "Integration Key" --scope "memory:read"
151
+ onasis api-keys revoke <id> # Revoke API key
152
+ onasis api-keys rotate <id> # Rotate API key
153
+ ```
170
154
 
171
- # Alternative command usage
172
- memory search "my query" # Direct memory command
173
- maas list --type knowledge # MaaS command
155
+ ### MCP Integration
156
+ ```bash
157
+ onasis mcp status # MCP server status
158
+ onasis mcp connect --remote # Connect to remote MCP server
159
+ onasis mcp disconnect # Disconnect from MCP
160
+ onasis mcp tools # List available MCP tools
161
+ onasis mcp resources # List MCP resources
174
162
  ```
175
163
 
176
- ## 🤖 MCP Integration (Model Context Protocol)
164
+ ### Configuration Management
165
+ ```bash
166
+ onasis config list # List all configuration
167
+ onasis config get <key> # Get configuration value
168
+ onasis config set <key> <value> # Set configuration value
169
+ onasis config reset # Reset configuration
170
+ ```
177
171
 
178
- The CLI now includes full MCP support for AI agent integration:
172
+ ### Service Management
173
+ ```bash
174
+ onasis service list # List all services
175
+ onasis service status # Service status overview
176
+ onasis service restart <service> # Restart specific service
177
+ onasis deploy status # Deployment status
178
+ onasis deploy health # Deployment health check
179
+ ```
179
180
 
180
- ### Start MCP Server Mode
181
+ ## ⚙️ Global Options
181
182
 
182
183
  ```bash
183
- # Start as MCP server for AI assistants
184
- lanonasis mcp start # Default port 3002
185
- lanonasis mcp start --port 8080 # Custom port
186
- lanonasis mcp start --mode server # Explicit server mode
184
+ # Available for all commands
185
+ --help # Show command help
186
+ --version # Show version information
187
+ --verbose # Enable verbose logging
188
+ --output <format> # Output format: table, json, yaml, csv
189
+ --api-url <url> # Override API URL
190
+ --no-mcp # Disable MCP and use direct API
191
+ ```
192
+
193
+ ## 🎯 Advanced Usage
187
194
 
188
- # Or use npx without installation
189
- npx -y @lanonasis/cli mcp start
195
+ ### JSON Output for Automation
196
+ ```bash
197
+ onasis memory list --output json | jq '.data[].title'
198
+ onasis health --output json | jq '.status'
190
199
  ```
191
200
 
192
- ### Configure AI Assistants
201
+ ### Environment Variables
202
+ ```bash
203
+ export MEMORY_API_URL="https://api.lanonasis.com/api/v1"
204
+ export CLI_OUTPUT_FORMAT="json"
205
+ export CLI_VERBOSE="true"
206
+ ```
193
207
 
194
- **Claude Desktop** (`~/Library/Application Support/Claude/claude_desktop_config.json`):
208
+ ### Configuration File
209
+ Location: `~/.maas/config.json`
195
210
  ```json
196
211
  {
197
- "mcpServers": {
198
- "memory-service": {
199
- "command": "npx",
200
- "args": ["-y", "@lanonasis/cli", "mcp", "start"],
201
- "env": {
202
- "LANONASIS_API_KEY": "your-api-key-here"
203
- }
204
- }
205
- }
212
+ "apiUrl": "https://api.lanonasis.com/api/v1",
213
+ "defaultOutputFormat": "table",
214
+ "mcpPreference": "auto",
215
+ "vendorKey": "pk_xxxxx.sk_xxxxx"
206
216
  }
207
217
  ```
208
218
 
209
- **Cursor/Windsurf** (Settings):
210
- ```json
211
- {
212
- "mcp.servers": {
213
- "memory-service": {
214
- "command": "lanonasis",
215
- "args": ["mcp", "start"],
216
- "env": {
217
- "LANONASIS_API_KEY": "your-api-key-here"
218
- }
219
- }
220
- }
221
- }
219
+ ## 🔧 Development & Debugging
220
+
221
+ ### Verbose Mode
222
+ ```bash
223
+ onasis --verbose memory list # Detailed operation logs
224
+ onasis -V health # Short flag version
222
225
  ```
223
226
 
224
- ### MCP Commands
227
+ ### Configuration Debugging
228
+ ```bash
229
+ onasis config list # Check current configuration
230
+ onasis auth status # Verify authentication
231
+ onasis health --verbose # Detailed health information
232
+ ```
225
233
 
234
+ ### MCP Debugging
226
235
  ```bash
227
- # Server operations
228
- lanonasis mcp start # Start MCP server
229
- lanonasis mcp stop # Stop MCP server
230
- lanonasis mcp status # Check server status
231
- lanonasis mcp logs # View server logs
232
-
233
- # Tool discovery
234
- lanonasis mcp tools # List all available MCP tools
235
- lanonasis mcp tools --json # Output as JSON
236
-
237
- # Test connectivity
238
- lanonasis mcp test # Test MCP connection
239
- lanonasis mcp test --tool <name> # Test specific tool
240
- ```
241
-
242
- ### Available MCP Tools
243
-
244
- - `memory_create_memory` - Create new memories with embeddings
245
- - `memory_search_memories` - Semantic search across memories
246
- - `memory_list_memories` - List and filter memories
247
- - `memory_get_memory` - Retrieve specific memory
248
- - `memory_update_memory` - Update existing memories
249
- - `memory_delete_memory` - Delete memories
250
- - `memory_bulk_create` - Batch create multiple memories
251
- - `memory_bulk_delete` - Batch delete memories
252
- - `memory_get_stats` - Get memory statistics
253
- - `memory_export_data` - Export memories (JSON/CSV/YAML)
254
- - `memory_import_data` - Import memories from files
255
-
256
- ### MCP Features:
257
- - **🔌 WebSocket Server**: Real-time bidirectional communication
258
- - **🔄 Hybrid Mode**: Automatic fallback between local/remote
259
- - **🔐 Secure Auth**: API key and JWT token support
260
- - **📊 Real-time SSE**: Live updates in remote mode
261
- - **🛠️ Tool Discovery**: Dynamic tool listing for AI agents
262
- - **🎯 Auto-detection**: Intelligently chooses best mode
263
- - **📝 Full Memory API**: All operations exposed as MCP tools
264
-
265
- ## 🌐 MaaS Service Integration
266
-
267
- This CLI is designed to work with Memory as a Service platforms that provide:
268
- - RESTful API endpoints
269
- - JWT or API key authentication
270
- - Vector-based memory search
271
- - Multi-tenant memory storage
272
-
273
- ### Setting up your MaaS Service
274
-
275
- 1. **Deploy** a MaaS service using the provided backend
276
- 2. **Configure** the CLI with your service endpoint
277
- 3. **Authenticate** using your service credentials
278
- 4. **Start** managing your memories!
279
-
280
- ## 🛠️ Development
281
-
282
- ### Prerequisites
283
- - Node.js 18+
284
- - npm or yarn
285
-
286
- ### Local Development
236
+ onasis mcp status --verbose # Detailed MCP diagnostics
237
+ onasis --no-mcp memory list # Bypass MCP, use direct API
238
+ ```
239
+
240
+ ## 🌐 Golden Contract Compliance
241
+
242
+ ### Onasis-Core v0.1 Standards
243
+ - Service discovery via `/.well-known/onasis.json`
244
+ - Vendor key authentication (`pk_*.sk_*` format)
245
+ - ✅ Request correlation with UUID tracking
246
+ - Enhanced CORS security compliance
247
+ - Uniform error envelope standardization
248
+ - WebSocket path alignment (`/mcp/ws`)
249
+
250
+ ### Service Discovery Integration
251
+ The CLI automatically discovers service endpoints:
287
252
  ```bash
288
- git clone <repository-url>
289
- cd memory-cli
290
- npm install
253
+ # Service discovery happens automatically
254
+ onasis health # Uses discovered endpoints for health checks
255
+ ```
291
256
 
292
- # Development mode
293
- npm run dev
257
+ ### Request Correlation
258
+ Every API request includes correlation headers:
259
+ - `X-Request-ID`: UUID for request tracking
260
+ - `X-Project-Scope`: Project scope validation
261
+ - `X-Auth-Method`: Authentication method used
294
262
 
295
- # Build
296
- npm run build
263
+ ## 🧪 Testing & Quality
297
264
 
298
- # Test locally
299
- node dist/index-simple.js help
265
+ ### Command Validation
266
+ ```bash
267
+ onasis --help # Validate CLI installation
268
+ onasis completion # Test completion system
269
+ onasis guide # Test interactive guidance
300
270
  ```
301
271
 
302
- ## 📦 What's Included
272
+ ### API Integration Testing
273
+ ```bash
274
+ onasis health # Test API connectivity
275
+ onasis memory list --limit 1 # Test memory service
276
+ onasis mcp status # Test MCP integration
277
+ ```
278
+
279
+ ## 🚨 Troubleshooting
280
+
281
+ ### Common Issues
282
+
283
+ #### Authentication Failures
284
+ ```bash
285
+ # Check authentication status
286
+ onasis auth status
303
287
 
304
- - **Full CLI Interface** - Complete command-line tool
305
- - **Memory Management** - Create, search, list memories
306
- - **Type System** - Organized memory categorization
307
- - **Authentication** - Secure service integration
308
- - **Configuration** - Flexible service setup
309
- - **Help System** - Comprehensive documentation
288
+ # Re-authenticate
289
+ onasis auth logout
290
+ onasis login --vendor-key pk_xxx.sk_xxx
291
+ ```
310
292
 
311
- ## 📦 SDK & Related Packages
293
+ #### Connection Issues
294
+ ```bash
295
+ # Check system health
296
+ onasis health --verbose
312
297
 
313
- ### Memory Client SDK
314
- Install the TypeScript/JavaScript SDK for application integration:
298
+ # Test API connectivity
299
+ onasis --api-url https://api.lanonasis.com/api/v1 health
300
+ ```
315
301
 
302
+ #### MCP Connection Issues
316
303
  ```bash
317
- # Install SDK for your applications
318
- npm install @lanonasis/memory-client
304
+ # Check MCP status
305
+ onasis mcp status --verbose
319
306
 
320
- # Use in your code
321
- import { createMemoryClient } from '@lanonasis/memory-client';
307
+ # Disable MCP temporarily
308
+ onasis --no-mcp memory list
309
+ ```
322
310
 
323
- const client = createMemoryClient({
324
- baseURL: 'https://api.lanonasis.com',
325
- apiKey: 'your-api-key-here'
326
- });
311
+ ### Debug Mode
312
+ ```bash
313
+ # Enable maximum verbosity
314
+ CLI_VERBOSE=true onasis --verbose health
327
315
  ```
328
316
 
329
- ### Complete Installation for Developers
317
+ ## 🤝 Contributing
318
+
319
+ ### Development Setup
330
320
  ```bash
331
- # Install CLI globally for command-line usage
332
- npm install -g @lanonasis/cli
321
+ # Clone CLI source
322
+ git clone https://github.com/lanonasis/lanonasis-maas.git
323
+ cd lanonasis-maas/cli
333
324
 
334
- # Install SDK locally for application development
335
- npm install @lanonasis/memory-client
325
+ # Install dependencies
326
+ npm install
327
+
328
+ # Build CLI
329
+ npm run build
336
330
 
337
- # Now you have both CLI and SDK available!
338
- lanonasis --help # CLI commands
339
- # SDK available for import in your code
331
+ # Link for local development
332
+ npm link
340
333
  ```
341
334
 
342
- ## 🔗 Related Projects
335
+ ### Testing Changes
336
+ ```bash
337
+ # Test build
338
+ npm run build
343
339
 
344
- - **Memory Service Backend** - Full MaaS API server ([GitHub](https://github.com/thefixer3x/vibe-memory))
345
- - **Memory Client SDK** - JavaScript/TypeScript SDK (`@lanonasis/memory-client`)
346
- - **Memory Visualizer** - Interactive memory exploration (included in backend)
347
- - **VSCode Extension** - IDE integration (coming soon)
340
+ # Test CLI functionality
341
+ onasis --help
342
+ onasis health
343
+ ```
344
+
345
+ ## 📝 Version History
346
+
347
+ ### v2.0.0 (Current)
348
+ - 🎯 **Interactive Dashboard**: Central command center for all operations
349
+ - 🎉 **Welcome Experience**: Guided onboarding for new users
350
+ - ⚡ **Power Mode**: Streamlined interface for expert users
351
+ - 🤖 **Smart Suggestions**: Context-aware command recommendations
352
+ - 🏆 **Achievement System**: Gamification to track progress
353
+ - 🛡️ **Enhanced Error Handling**: Intelligent error messages with recovery
354
+ - 📊 **Progress Indicators**: Visual feedback for operations
355
+
356
+ ### v1.5.2
357
+ - ✅ Golden Contract compliance (Onasis-Core v0.1)
358
+ - ✅ Professional shell completions (bash/zsh/fish)
359
+ - ✅ Enhanced authentication (vendor keys, OAuth, credentials)
360
+ - ✅ Interactive user guidance system
361
+ - ✅ Dual command support (lanonasis/onasis)
362
+ - ✅ Service discovery integration
363
+ - ✅ Request correlation and enhanced security
364
+
365
+ ### Previous Versions
366
+ - v1.4.x: Basic CLI functionality
367
+ - v1.3.x: MCP integration
368
+ - v1.2.x: Memory management
369
+ - v1.1.x: Initial authentication
370
+ - v1.0.x: Core CLI framework
348
371
 
349
372
  ## 📄 License
350
373
 
351
- MIT License - see LICENSE file for details
374
+ MIT License - see [LICENSE](../LICENSE) for details.
352
375
 
353
- ## 🤝 Contributing
376
+ ## 🔗 Related Links
354
377
 
355
- 1. Fork the repository
356
- 2. Create your feature branch (`git checkout -b feature/amazing-feature`)
357
- 3. Commit your changes (`git commit -m 'Add amazing feature'`)
358
- 4. Push to the branch (`git push origin feature/amazing-feature`)
359
- 5. Open a Pull Request
360
-
361
- ## 🐛 Support
362
-
363
- - **Issues**: [GitHub Issues](https://github.com/seyederick/memory-cli/issues)
364
- - **Documentation**: [CLI Documentation](https://github.com/seyederick/memory-cli)
365
-
366
- ## 🎯 Use Cases
367
-
368
- - **Personal Knowledge Management** - Organize your thoughts and notes
369
- - **Team Knowledge Sharing** - Collaborative memory management
370
- - **Project Documentation** - Context-aware project memories
371
- - **Research Organization** - Academic and research note-taking
372
- - **API Integration** - Programmatic memory management
373
-
374
- ## 🏆 Production Ready Features
375
-
376
- ### Enterprise Capabilities
377
- - **🔐 Secure Authentication** - API key and JWT token support
378
- - **🌐 Multi-tenant Support** - Isolated memory spaces per user/org
379
- - **📊 Rate Limiting** - Built-in request throttling
380
- - **🔄 Retry Logic** - Automatic retry with exponential backoff
381
- - **📝 Comprehensive Logging** - Debug and audit trails
382
- - **🚀 Performance Optimized** - Minimal overhead, fast responses
383
-
384
- ### Commercial Use Cases
385
- - **💼 Enterprise Knowledge Management** - Company-wide memory system
386
- - **🤝 Team Collaboration** - Shared project memories
387
- - **🎓 Educational Platforms** - Student/teacher memory sharing
388
- - **🏥 Healthcare Systems** - Patient context management
389
- - **💰 Financial Services** - Transaction memory and audit trails
390
- - **🛒 E-commerce** - Customer interaction history
391
-
392
- ### Integration Ready
393
- - **REST API** - Standard HTTP/JSON interface
394
- - **MCP Protocol** - AI assistant integration
395
- - **WebSocket** - Real-time updates
396
- - **SSE Streaming** - Live data synchronization
397
- - **SDK Available** - TypeScript/JavaScript client library
378
+ - **NPM Package**: [https://www.npmjs.com/package/@lanonasis/cli](https://www.npmjs.com/package/@lanonasis/cli)
379
+ - **Main Repository**: [https://github.com/lanonasis/lanonasis-maas](https://github.com/lanonasis/lanonasis-maas)
380
+ - **Documentation**: [https://docs.lanonasis.com/cli](https://docs.lanonasis.com/cli)
381
+ - **API Documentation**: [https://api.lanonasis.com/docs](https://api.lanonasis.com/docs)
382
+ - **Service Discovery**: [https://api.lanonasis.com/.well-known/onasis.json](https://api.lanonasis.com/.well-known/onasis.json)
383
+ - **Dashboard**: [https://api.lanonasis.com/dashboard](https://api.lanonasis.com/dashboard)
398
384
 
399
385
  ---
400
386
 
401
- **Built with ❤️ for the Memory as a Service ecosystem**
402
-
403
- 🚀 **Ready for Production** | 📚 [Documentation](https://docs.lanonasis.com) | 🌐 [Platform](https://api.lanonasis.com)
387
+ *Professional CLI for Enterprise Memory as a Service - Golden Contract Compliant*