@memnexus-ai/cli 0.1.0

package/dist/lib/validators.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Validation result type
+ */
+export interface ValidationResult {
+    valid: boolean;
+    error?: string;
+}
+/**
+ * Validate URL format
+ * @param url - URL string to validate
+ * @returns Validation result with helpful error message
+ */
+export declare function validateUrl(url: string): ValidationResult;
+/**
+ * Validate number within range
+ * @param value - Value to validate
+ * @param min - Minimum value (inclusive)
+ * @param max - Maximum value (inclusive)
+ * @param fieldName - Name of the field for error messages
+ * @returns Validation result with helpful error message
+ */
+export declare function validateNumber(value: any, min?: number, max?: number, fieldName?: string): ValidationResult;
+/**
+ * Validate integer within range
+ * @param value - Value to validate
+ * @param min - Minimum value (inclusive)
+ * @param max - Maximum value (inclusive)
+ * @param fieldName - Name of the field for error messages
+ * @returns Validation result with helpful error message
+ */
+export declare function validateInteger(value: any, min?: number, max?: number, fieldName?: string): ValidationResult;
+/**
+ * Validate confidence score (0-1)
+ * @param value - Confidence score to validate
+ * @returns Validation result with helpful error message
+ */
+export declare function validateConfidence(value: any): ValidationResult;
+/**
+ * Validate JSON string
+ * @param jsonString - JSON string to validate
+ * @param fieldName - Name of the field for error messages
+ * @returns Validation result with helpful error message and parsed object
+ */
+export declare function validateJson(jsonString: string, fieldName?: string): ValidationResult & {
+    parsed?: any;
+};
+/**
+ * Validate output format
+ * @param format - Output format to validate
+ * @returns Validation result with helpful error message
+ */
+export declare function validateOutputFormat(format: string): ValidationResult;
+/**
+ * Validate page number
+ * @param page - Page number to validate
+ * @returns Validation result with helpful error message
+ */
+export declare function validatePage(page: any): ValidationResult;
+/**
+ * Validate limit/page size
+ * @param limit - Limit to validate
+ * @returns Validation result with helpful error message
+ */
+export declare function validateLimit(limit: any): ValidationResult;
+/**
+ * Validate required string field
+ * @param value - Value to validate
+ * @param fieldName - Name of the field for error messages
+ * @param minLength - Minimum length (default: 1)
+ * @returns Validation result with helpful error message
+ */
+export declare function validateRequiredString(value: any, fieldName: string, minLength?: number): ValidationResult;
+/**
+ * Validate enum value
+ * @param value - Value to validate
+ * @param allowedValues - Array of allowed values
+ * @param fieldName - Name of the field for error messages
+ * @returns Validation result with helpful error message
+ */
+export declare function validateEnum(value: any, allowedValues: string[], fieldName: string): ValidationResult;
+/**
+ * Print validation error with formatting
+ * @param error - Error message to print
+ */
+export declare function printValidationError(error: string): void;
+/**
+ * Validate and throw if invalid
+ * @param result - Validation result
+ * @throws Error if validation fails
+ */
+export declare function assertValid(result: ValidationResult): void;
+//# sourceMappingURL=validators.d.ts.map

package/dist/lib/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/lib/validators.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CA0BzD;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,GAAG,EACV,GAAG,CAAC,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,MAAM,EACZ,SAAS,GAAE,MAAgB,GAC1B,gBAAgB,CAyBlB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,GAAG,EACV,GAAG,CAAC,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,MAAM,EACZ,SAAS,GAAE,MAAgB,GAC1B,gBAAgB,CAyBlB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,GAAG,GAAG,gBAAgB,CAW/D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,EAClB,SAAS,GAAE,MAAe,GACzB,gBAAgB,GAAG;IAAE,MAAM,CAAC,EAAE,GAAG,CAAA;CAAE,CAkBrC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAoBrE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,GAAG,GAAG,gBAAgB,CAExD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,gBAAgB,CAE1D;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,GAAG,EACV,SAAS,EAAE,MAAM,EACjB,SAAS,GAAE,MAAU,GACpB,gBAAgB,CAyBlB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,GAAG,EACV,aAAa,EAAE,MAAM,EAAE,EACvB,SAAS,EAAE,MAAM,GAChB,gBAAgB,CAgBlB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAGxD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAK1D"}

package/dist/lib/validators.js

@@ -0,0 +1,257 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateUrl = validateUrl;
+exports.validateNumber = validateNumber;
+exports.validateInteger = validateInteger;
+exports.validateConfidence = validateConfidence;
+exports.validateJson = validateJson;
+exports.validateOutputFormat = validateOutputFormat;
+exports.validatePage = validatePage;
+exports.validateLimit = validateLimit;
+exports.validateRequiredString = validateRequiredString;
+exports.validateEnum = validateEnum;
+exports.printValidationError = printValidationError;
+exports.assertValid = assertValid;
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * Validate URL format
+ * @param url - URL string to validate
+ * @returns Validation result with helpful error message
+ */
+function validateUrl(url) {
+    if (!url || url.trim().length === 0) {
+        return {
+            valid: false,
+            error: 'URL cannot be empty',
+        };
+    }
+    try {
+        const urlObj = new URL(url);
+        // Check for valid protocol
+        if (!['http:', 'https:'].includes(urlObj.protocol)) {
+            return {
+                valid: false,
+                error: `Invalid protocol "${urlObj.protocol}". Must be http: or https:\nExample: https://api.memnexus.ai`,
+            };
+        }
+        return { valid: true };
+    }
+    catch (error) {
+        return {
+            valid: false,
+            error: `Invalid URL format\nExample: https://api.memnexus.ai\nProvided: ${url}`,
+        };
+    }
+}
+/**
+ * Validate number within range
+ * @param value - Value to validate
+ * @param min - Minimum value (inclusive)
+ * @param max - Maximum value (inclusive)
+ * @param fieldName - Name of the field for error messages
+ * @returns Validation result with helpful error message
+ */
+function validateNumber(value, min, max, fieldName = 'Value') {
+    const num = typeof value === 'string' ? parseFloat(value) : value;
+    if (isNaN(num)) {
+        return {
+            valid: false,
+            error: `${fieldName} must be a valid number\nProvided: ${value}`,
+        };
+    }
+    if (min !== undefined && num < min) {
+        return {
+            valid: false,
+            error: `${fieldName} must be at least ${min}\nProvided: ${num}`,
+        };
+    }
+    if (max !== undefined && num > max) {
+        return {
+            valid: false,
+            error: `${fieldName} must be at most ${max}\nProvided: ${num}`,
+        };
+    }
+    return { valid: true };
+}
+/**
+ * Validate integer within range
+ * @param value - Value to validate
+ * @param min - Minimum value (inclusive)
+ * @param max - Maximum value (inclusive)
+ * @param fieldName - Name of the field for error messages
+ * @returns Validation result with helpful error message
+ */
+function validateInteger(value, min, max, fieldName = 'Value') {
+    const num = typeof value === 'string' ? parseInt(value, 10) : value;
+    if (isNaN(num) || !Number.isInteger(num)) {
+        return {
+            valid: false,
+            error: `${fieldName} must be a valid integer\nProvided: ${value}`,
+        };
+    }
+    if (min !== undefined && num < min) {
+        return {
+            valid: false,
+            error: `${fieldName} must be at least ${min}\nProvided: ${num}`,
+        };
+    }
+    if (max !== undefined && num > max) {
+        return {
+            valid: false,
+            error: `${fieldName} must be at most ${max}\nProvided: ${num}`,
+        };
+    }
+    return { valid: true };
+}
+/**
+ * Validate confidence score (0-1)
+ * @param value - Confidence score to validate
+ * @returns Validation result with helpful error message
+ */
+function validateConfidence(value) {
+    const result = validateNumber(value, 0, 1, 'Confidence score');
+    if (!result.valid) {
+        return {
+            valid: false,
+            error: `${result.error}\nConfidence must be between 0 and 1 (e.g., 0.85 for 85% confidence)`,
+        };
+    }
+    return { valid: true };
+}
+/**
+ * Validate JSON string
+ * @param jsonString - JSON string to validate
+ * @param fieldName - Name of the field for error messages
+ * @returns Validation result with helpful error message and parsed object
+ */
+function validateJson(jsonString, fieldName = 'JSON') {
+    if (!jsonString || jsonString.trim().length === 0) {
+        return {
+            valid: false,
+            error: `${fieldName} cannot be empty`,
+        };
+    }
+    try {
+        const parsed = JSON.parse(jsonString);
+        return { valid: true, parsed };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            valid: false,
+            error: `Invalid ${fieldName} format: ${errorMessage}\nExample: {"key": "value"}`,
+        };
+    }
+}
+/**
+ * Validate output format
+ * @param format - Output format to validate
+ * @returns Validation result with helpful error message
+ */
+function validateOutputFormat(format) {
+    const validFormats = ['json', 'table', 'yaml'];
+    if (!format || format.trim().length === 0) {
+        return {
+            valid: false,
+            error: 'Output format cannot be empty',
+        };
+    }
+    const normalizedFormat = format.toLowerCase();
+    if (!validFormats.includes(normalizedFormat)) {
+        return {
+            valid: false,
+            error: `Invalid output format: ${format}\nValid formats: ${validFormats.join(', ')}`,
+        };
+    }
+    return { valid: true };
+}
+/**
+ * Validate page number
+ * @param page - Page number to validate
+ * @returns Validation result with helpful error message
+ */
+function validatePage(page) {
+    return validateInteger(page, 0, undefined, 'Page number');
+}
+/**
+ * Validate limit/page size
+ * @param limit - Limit to validate
+ * @returns Validation result with helpful error message
+ */
+function validateLimit(limit) {
+    return validateInteger(limit, 1, 1000, 'Limit');
+}
+/**
+ * Validate required string field
+ * @param value - Value to validate
+ * @param fieldName - Name of the field for error messages
+ * @param minLength - Minimum length (default: 1)
+ * @returns Validation result with helpful error message
+ */
+function validateRequiredString(value, fieldName, minLength = 1) {
+    if (value === undefined || value === null) {
+        return {
+            valid: false,
+            error: `${fieldName} is required`,
+        };
+    }
+    const str = String(value).trim();
+    if (str.length === 0) {
+        return {
+            valid: false,
+            error: `${fieldName} cannot be empty`,
+        };
+    }
+    if (str.length < minLength) {
+        return {
+            valid: false,
+            error: `${fieldName} must be at least ${minLength} characters\nProvided: ${str.length} characters`,
+        };
+    }
+    return { valid: true };
+}
+/**
+ * Validate enum value
+ * @param value - Value to validate
+ * @param allowedValues - Array of allowed values
+ * @param fieldName - Name of the field for error messages
+ * @returns Validation result with helpful error message
+ */
+function validateEnum(value, allowedValues, fieldName) {
+    if (!value || value.trim().length === 0) {
+        return {
+            valid: false,
+            error: `${fieldName} is required\nAllowed values: ${allowedValues.join(', ')}`,
+        };
+    }
+    if (!allowedValues.includes(value)) {
+        return {
+            valid: false,
+            error: `Invalid ${fieldName}: ${value}\nAllowed values: ${allowedValues.join(', ')}`,
+        };
+    }
+    return { valid: true };
+}
+/**
+ * Print validation error with formatting
+ * @param error - Error message to print
+ */
+function printValidationError(error) {
+    console.log(chalk_1.default.red('❌ Validation Error:'));
+    console.log(chalk_1.default.yellow(error));
+}
+/**
+ * Validate and throw if invalid
+ * @param result - Validation result
+ * @throws Error if validation fails
+ */
+function assertValid(result) {
+    if (!result.valid && result.error) {
+        printValidationError(result.error);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=validators.js.map

package/dist/lib/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/lib/validators.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -0,0 +1,13 @@
+export type * from '@memnexus-ai/mx-typescript-sdk';
+export interface CLIConfig {
+    apiUrl: string;
+    apiKey?: string;
+    defaultFormat: 'json' | 'table' | 'yaml';
+    defaultPageSize: number;
+}
+export interface CommandOptions {
+    format?: 'json' | 'table' | 'yaml';
+    verbose?: boolean;
+}
+export type OutputFormat = 'json' | 'table' | 'yaml';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AACA,mBAAmB,gCAAgC,CAAC;AAGpD,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IACzC,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/docs/README.md

@@ -0,0 +1,219 @@
+# MemNexus CLI Documentation
+
+Welcome to the mx-cli documentation! This directory contains comprehensive planning and strategy documents for building and maintaining the CLI.
+
+## Core Documents
+
+### 📋 [Product Requirements Document (PRD)](./prd.md)
+**Complete specification for the CLI project**
+
+What's inside:
+- Technology stack and dependencies
+- Architecture and system design
+- All CLI commands and features
+- Development roadmap (4-week plan)
+- Testing strategy
+- Distribution via GitHub Packages
+
+**Start here** if you want to understand what the CLI does and how it's built.
+
+---
+
+### 🔄 [CLI-API Sync Strategy](./sync-strategy.md)
+**How to keep CLI in sync with API changes**
+
+What's inside:
+- OpenAPI as single source of truth
+- Automated SDK generation workflow
+- Contract testing with Dredd/Prism
+- Version management (SemVer)
+- CI/CD integration
+- Breaking change detection
+
+**Read this** to understand how type safety and API compatibility is maintained.
+
+---
+
+### 🤖 [Code Generation Strategy](./code-generation-strategy.md)
+**How CLI commands are created when APIs change**
+
+What's inside:
+- Why full auto-generation doesn't work for CLIs
+- Hybrid approach: scaffolding + manual implementation
+- Coverage detection to catch missing commands
+- Command scaffold generator (future)
+- Metadata-driven commands via OpenAPI extensions
+
+**Read this** to understand why CLI commands are manual in v1.0 and the roadmap for semi-automation.
+
+---
+
+## Quick Reference
+
+### The Three-Layer Architecture
+
+```
+┌─────────────────────────────────┐
+│  OpenAPI Specification          │  Single source of truth
+└────────────┬────────────────────┘
+             │ generates
+             ▼
+┌─────────────────────────────────┐
+│  @memnexus-ai/contracts         │  TypeScript SDK
+│  - Auto-generated types         │  (Auto-sync)
+│  - API client methods           │
+└────────────┬────────────────────┘
+             │ dependency
+             ▼
+┌─────────────────────────────────┐
+│  @memnexus-ai/cli               │  CLI tool
+│  - Commands (manual)            │  (Manual for v1.0)
+│  - Business logic               │
+└─────────────────────────────────┘
+```
+
+### What's Automated vs. Manual
+
+| Aspect | Status | Tool/Process |
+|--------|--------|-------------|
+| **TypeScript types** | ✅ Automated | `openapi-typescript` |
+| **API client methods** | ✅ Automated | `@memnexus-ai/contracts` build |
+| **Breaking change detection** | ✅ Automated | `oasdiff` (future) |
+| **Dependency updates** | ✅ Automated | Dependabot (future) |
+| **Contract testing** | ✅ Automated | Dredd/Prism (future) |
+| **CLI command structure** | ❌ Manual | Developer writes code |
+| **Business logic** | ❌ Manual | Developer writes code |
+| **Help text** | ❌ Manual | Developer writes code |
+| **Output formatting** | ❌ Manual | Developer writes code |
+
+### Key Decisions
+
+1. **TypeScript + Node.js** - Leverage existing codebase and contracts package
+2. **Via API Gateway** - All requests go through Kong (production/staging)
+3. **Exact version pinning** - Pin `@memnexus-ai/contracts` version in v1.0 for stability
+4. **Manual commands for v1.0** - Build scaffolding generator after patterns stabilize
+5. **GitHub Packages** - Primary distribution method
+
+### Development Workflow
+
+**When an API endpoint is added/changed:**
+
+```mermaid
+graph LR
+    A[Change API] --> B[Update OpenAPI]
+    B --> C[Publish contracts]
+    C --> D[Update CLI dependency]
+    D --> E[Implement command]
+    E --> F[Test & publish CLI]
+```
+
+**Detailed steps**:
+1. Developer changes mx-core-api code
+2. Developer updates OpenAPI spec (`contracts/openapi.yaml`)
+3. Contracts package auto-generates types and publishes
+4. CLI updates `@memnexus-ai/contracts` dependency
+5. **Developer manually implements CLI command** (for v1.0)
+6. CLI is tested and published via GitHub Actions
+
+### Phased Automation Plan
+
+#### Phase 1: Manual (Weeks 1-4) ✅ Current
+- Use contracts for types
+- Write commands manually
+- Establish patterns
+
+#### Phase 2: Detection (Weeks 5-6) 🎯 Next
+- Build coverage checker
+- Alert on missing commands
+- CI/CD integration
+
+#### Phase 3: Scaffolding (Month 2) ⏸️ Future
+- Build command generator
+- Auto-create skeletons
+- Developer fills in logic
+
+#### Phase 4: Metadata-Driven (Month 3+) ⏸️ Future
+- OpenAPI extensions for CLI
+- Auto-generate help text
+- Near-automatic updates
+
+## Common Questions
+
+### Q: Do types update automatically when the API changes?
+**A**: Yes! When `@memnexus-ai/contracts` is updated, you get new TypeScript types automatically.
+
+### Q: Do CLI commands update automatically?
+**A**: No (for v1.0). Developers must manually implement new commands. However:
+- Coverage detection will alert when commands are missing (Phase 2)
+- Scaffolding generator will create boilerplate (Phase 3)
+- Metadata-driven approach will minimize manual work (Phase 4)
+
+### Q: Why not fully auto-generate CLI commands?
+**A**:
+- No mature tools for TypeScript/Commander.js generation
+- Generated code loses flexibility and polish
+- Help text, examples, and UX require human touch
+- Business logic is unique per endpoint
+
+See [Code Generation Strategy](./code-generation-strategy.md#evaluated-solutions) for detailed analysis.
+
+### Q: How do I know if the CLI is out of sync with the API?
+**A**:
+- **v1.0**: Manual tracking
+- **Phase 2+**: Automated coverage checks in CI/CD
+- **Future**: GitHub bot creates PRs when endpoints are added
+
+### Q: What happens when there's a breaking API change?
+**A**:
+1. `oasdiff` detects breaking change in CI/CD
+2. Contracts package bumps MAJOR version (e.g., 1.0.0 → 2.0.0)
+3. CLI must update code to handle new contract
+4. CLI bumps MAJOR version too
+5. Migration guide documents changes
+
+See [Sync Strategy - Breaking Changes](./sync-strategy.md#detecting-breaking-changes).
+
+### Q: Can I point the CLI directly at mx-core-api instead of the gateway?
+**A**: Yes! For local development:
+```bash
+export MX_API_URL=http://localhost:3000
+mx memories list
+```
+
+Default is API Gateway (`https://api.memnexus.io` in production).
+
+## Next Steps
+
+### For Contributors
+1. Read [PRD](./prd.md) to understand the project
+2. Check [Development Plan](./prd.md#development-plan) for current priorities
+3. See [Sync Strategy](./sync-strategy.md) for workflow details
+
+### For Maintainers
+1. Implement Phase 2 coverage detection after v1.0
+2. Monitor contracts package updates
+3. Keep documentation in sync with implementation
+
+### For Users
+- Installation and usage docs will be in `../README.md` (root of mx-cli)
+- API reference will be in `../docs/api-reference.md` (future)
+- Examples will be in `../examples/` (future)
+
+## Document Status
+
+| Document | Version | Last Updated | Status |
+|----------|---------|--------------|--------|
+| [prd.md](./prd.md) | 1.0 | 2025-11-13 | ✅ Complete |
+| [sync-strategy.md](./sync-strategy.md) | 1.0 | 2025-11-13 | ✅ Complete |
+| [code-generation-strategy.md](./code-generation-strategy.md) | 1.0 | 2025-11-13 | ✅ Complete |
+
+## Contributing
+
+Found an issue or have a suggestion? Please:
+1. Open an issue in the GitHub repository
+2. Reference the relevant document
+3. Propose specific changes
+
+---
+
+**Questions?** Open an issue or reach out to the MemNexus team.