@cortexmemory/cli 0.1.0

package/dist/utils/config.js

@@ -0,0 +1,261 @@
+/**
+ * Configuration Management
+ *
+ * Handles loading, saving, and managing CLI configuration from multiple sources:
+ * 1. CLI flags (highest priority)
+ * 2. Environment variables
+ * 3. Project config (./cortex.config.json)
+ * 4. User config (~/.cortexrc)
+ */
+import { cosmiconfig } from "cosmiconfig";
+import { readFile, writeFile, mkdir } from "fs/promises";
+import { existsSync } from "fs";
+import { homedir } from "os";
+import { join, dirname } from "path";
+/**
+ * Default configuration
+ */
+const DEFAULT_CONFIG = {
+    deployments: {
+        local: {
+            url: "http://127.0.0.1:3210",
+            deployment: "anonymous:anonymous-cortex-sdk-local",
+        },
+    },
+    default: "local",
+    format: "table",
+    confirmDangerous: true,
+};
+/**
+ * Explorer for loading configuration from various sources
+ */
+const explorer = cosmiconfig("cortex", {
+    searchPlaces: [
+        "cortex.config.json",
+        "cortex.config.js",
+        ".cortexrc",
+        ".cortexrc.json",
+        "package.json",
+    ],
+});
+/**
+ * Get the path to the user config file
+ */
+export function getUserConfigPath() {
+    return join(homedir(), ".cortexrc");
+}
+/**
+ * Get the path to the project config file
+ */
+export function getProjectConfigPath() {
+    return join(process.cwd(), "cortex.config.json");
+}
+/**
+ * Load configuration from all sources
+ */
+export async function loadConfig() {
+    let config = { ...DEFAULT_CONFIG };
+    // Try to load from cosmiconfig (searches up directory tree)
+    try {
+        const result = await explorer.search();
+        if (result && result.config) {
+            config = mergeConfig(config, result.config);
+        }
+    }
+    catch {
+        // No config file found, use defaults
+    }
+    // Try to load user config from ~/.cortexrc
+    const userConfigPath = getUserConfigPath();
+    if (existsSync(userConfigPath)) {
+        try {
+            const userConfigContent = await readFile(userConfigPath, "utf-8");
+            const userConfig = JSON.parse(userConfigContent);
+            config = mergeConfig(config, userConfig);
+        }
+        catch {
+            // Invalid user config, skip
+        }
+    }
+    // Override with environment variables
+    config = applyEnvOverrides(config);
+    return config;
+}
+/**
+ * Merge two configurations, with source overriding target
+ */
+function mergeConfig(target, source) {
+    return {
+        deployments: {
+            ...target.deployments,
+            ...source.deployments,
+        },
+        default: source.default ?? target.default,
+        format: source.format ?? target.format,
+        confirmDangerous: source.confirmDangerous ?? target.confirmDangerous,
+    };
+}
+/**
+ * Apply environment variable overrides
+ */
+function applyEnvOverrides(config) {
+    // If CONVEX_URL is set, create/update a deployment called "env"
+    const convexUrl = process.env.CONVEX_URL;
+    const convexKey = process.env.CONVEX_DEPLOY_KEY;
+    if (convexUrl) {
+        config.deployments.env = {
+            url: convexUrl,
+            key: convexKey,
+        };
+        // If no default is set, use env
+        if (!config.default || config.default === "local") {
+            config.default = "env";
+        }
+    }
+    // Check for local-specific env vars
+    const localUrl = process.env.LOCAL_CONVEX_URL;
+    const localDeployment = process.env.LOCAL_CONVEX_DEPLOYMENT;
+    if (localUrl) {
+        config.deployments.local = {
+            url: localUrl,
+            deployment: localDeployment,
+        };
+    }
+    // Check for cloud-specific env vars
+    const cloudUrl = process.env.CLOUD_CONVEX_URL;
+    const cloudKey = process.env.CLOUD_CONVEX_DEPLOY_KEY;
+    if (cloudUrl) {
+        config.deployments.cloud = {
+            url: cloudUrl,
+            key: cloudKey,
+        };
+    }
+    return config;
+}
+/**
+ * Save configuration to user config file
+ */
+export async function saveUserConfig(config) {
+    const configPath = getUserConfigPath();
+    const configDir = dirname(configPath);
+    // Ensure directory exists
+    if (!existsSync(configDir)) {
+        await mkdir(configDir, { recursive: true });
+    }
+    await writeFile(configPath, JSON.stringify(config, null, 2), "utf-8");
+}
+/**
+ * Save configuration to project config file
+ */
+export async function saveProjectConfig(config) {
+    const configPath = getProjectConfigPath();
+    await writeFile(configPath, JSON.stringify(config, null, 2), "utf-8");
+}
+/**
+ * Get a specific deployment configuration
+ */
+export function getDeployment(config, name) {
+    const deploymentName = name ?? config.default;
+    return config.deployments[deploymentName] ?? null;
+}
+/**
+ * Resolve final configuration from global options and config
+ */
+export function resolveConfig(config, options) {
+    // CLI flags have highest priority
+    if (options.url) {
+        return {
+            url: options.url,
+            key: options.key,
+            format: options.format ?? config.format,
+            quiet: options.quiet ?? false,
+            debug: options.debug ?? false,
+        };
+    }
+    // Look up deployment from config
+    const deploymentConfig = getDeployment(config, options.deployment);
+    if (!deploymentConfig) {
+        throw new Error(`Deployment "${options.deployment ?? config.default}" not found in configuration. ` +
+            `Run 'cortex setup' to configure deployments.`);
+    }
+    return {
+        url: deploymentConfig.url,
+        key: deploymentConfig.key ?? options.key,
+        deployment: deploymentConfig.deployment,
+        format: options.format ?? config.format,
+        quiet: options.quiet ?? false,
+        debug: options.debug ?? false,
+    };
+}
+/**
+ * Update a single deployment in the config
+ */
+export async function updateDeployment(name, deployment, saveToUser = true) {
+    const config = await loadConfig();
+    config.deployments[name] = deployment;
+    if (saveToUser) {
+        await saveUserConfig(config);
+    }
+    return config;
+}
+/**
+ * Set the default deployment
+ */
+export async function setDefaultDeployment(name) {
+    const config = await loadConfig();
+    if (!config.deployments[name]) {
+        throw new Error(`Deployment "${name}" not found`);
+    }
+    config.default = name;
+    await saveUserConfig(config);
+}
+/**
+ * Set a configuration value
+ */
+export async function setConfigValue(key, value) {
+    const config = await loadConfig();
+    switch (key) {
+        case "default":
+            if (!config.deployments[value]) {
+                throw new Error(`Deployment "${value}" not found`);
+            }
+            config.default = value;
+            break;
+        case "format":
+            if (!["table", "json", "csv"].includes(value)) {
+                throw new Error(`Invalid format: ${value}. Use table, json, or csv`);
+            }
+            config.format = value;
+            break;
+        case "confirmDangerous":
+            config.confirmDangerous = value === "true";
+            break;
+        case "convex-url":
+            config.deployments[config.default] = {
+                ...config.deployments[config.default],
+                url: value,
+            };
+            break;
+        case "convex-key":
+            config.deployments[config.default] = {
+                ...config.deployments[config.default],
+                key: value,
+            };
+            break;
+        default:
+            throw new Error(`Unknown config key: ${key}`);
+    }
+    await saveUserConfig(config);
+}
+/**
+ * List all deployments
+ */
+export function listDeployments(config) {
+    return Object.entries(config.deployments).map(([name, deployment]) => ({
+        name,
+        url: deployment.url,
+        isDefault: name === config.default,
+        hasKey: Boolean(deployment.key),
+    }));
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

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

package/dist/utils/formatting.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Output Formatting Utilities
+ *
+ * Handles formatting data for display in various formats:
+ * - Table (default, human-readable)
+ * - JSON (machine-readable)
+ * - CSV (for exports)
+ */
+import type { OutputFormat } from "../types.js";
+/**
+ * Format data based on the specified format
+ */
+export declare function formatOutput(data: unknown, format: OutputFormat, options?: {
+    headers?: string[];
+    title?: string;
+}): string;
+/**
+ * Format data as JSON
+ */
+export declare function formatJSON(data: unknown): string;
+/**
+ * Format data as CSV
+ */
+export declare function formatCSV(data: unknown, headers?: string[]): string;
+/**
+ * Format data as a table
+ */
+export declare function formatTable(data: unknown, headers?: string[], title?: string): string;
+/**
+ * Format a timestamp for display
+ */
+export declare function formatTimestamp(timestamp: number): string;
+/**
+ * Format a relative time (e.g., "2 hours ago")
+ */
+export declare function formatRelativeTime(timestamp: number): string;
+/**
+ * Format bytes to human-readable size
+ */
+export declare function formatBytes(bytes: number): string;
+/**
+ * Format a count with proper pluralization
+ */
+export declare function formatCount(count: number, singular: string, plural?: string): string;
+/**
+ * Print a success message
+ */
+export declare function printSuccess(message: string): void;
+/**
+ * Print an error message
+ */
+export declare function printError(message: string): void;
+/**
+ * Print a warning message
+ */
+export declare function printWarning(message: string): void;
+/**
+ * Print an info message
+ */
+export declare function printInfo(message: string): void;
+/**
+ * Print a header/title
+ */
+export declare function printHeader(title: string): void;
+/**
+ * Print a key-value pair
+ */
+export declare function printKeyValue(key: string, value: unknown): void;
+/**
+ * Print a section with key-value pairs
+ */
+export declare function printSection(title: string, data: Record<string, unknown>): void;
+/**
+ * Print a divider line
+ */
+export declare function printDivider(): void;
+/**
+ * Create a simple progress indicator
+ */
+export declare function createProgressText(current: number, total: number): string;
+//# sourceMappingURL=formatting.d.ts.map

package/dist/utils/formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../src/utils/formatting.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE;IACR,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACA,MAAM,CAUR;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAkCnE;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,MAAM,EAAE,EAClB,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CAuCR;AAwCD;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAmB5D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAWjD;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAGR;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAElD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEhD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAElD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAI/C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAE/D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,IAAI,CAMN;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAKzE"}

package/dist/utils/formatting.js

@@ -0,0 +1,239 @@
+/**
+ * Output Formatting Utilities
+ *
+ * Handles formatting data for display in various formats:
+ * - Table (default, human-readable)
+ * - JSON (machine-readable)
+ * - CSV (for exports)
+ */
+import Table from "cli-table3";
+import pc from "picocolors";
+/**
+ * Format data based on the specified format
+ */
+export function formatOutput(data, format, options) {
+    switch (format) {
+        case "json":
+            return formatJSON(data);
+        case "csv":
+            return formatCSV(data, options?.headers);
+        case "table":
+        default:
+            return formatTable(data, options?.headers, options?.title);
+    }
+}
+/**
+ * Format data as JSON
+ */
+export function formatJSON(data) {
+    return JSON.stringify(data, null, 2);
+}
+/**
+ * Format data as CSV
+ */
+export function formatCSV(data, headers) {
+    if (!Array.isArray(data)) {
+        data = [data];
+    }
+    const rows = data;
+    if (rows.length === 0) {
+        return "";
+    }
+    // Determine headers from first row if not provided
+    const columnHeaders = headers ?? Object.keys(rows[0]);
+    // Create CSV content
+    const csvRows = [
+        columnHeaders.join(","),
+        ...rows.map((row) => columnHeaders
+            .map((header) => {
+            const value = row[header];
+            // Handle values that need quoting
+            if (typeof value === "string" &&
+                (value.includes(",") || value.includes('"') || value.includes("\n"))) {
+                return `"${value.replace(/"/g, '""')}"`;
+            }
+            return String(value ?? "");
+        })
+            .join(",")),
+    ];
+    return csvRows.join("\n");
+}
+/**
+ * Format data as a table
+ */
+export function formatTable(data, headers, title) {
+    if (!Array.isArray(data)) {
+        data = [data];
+    }
+    const rows = data;
+    if (rows.length === 0) {
+        return pc.dim("No data to display");
+    }
+    // Determine headers from first row if not provided
+    const columnHeaders = headers ?? Object.keys(rows[0]);
+    // Create table
+    const table = new Table({
+        head: columnHeaders.map((h) => pc.cyan(h)),
+        style: {
+            head: [],
+            border: [],
+        },
+    });
+    // Add rows
+    for (const row of rows) {
+        table.push(columnHeaders.map((header) => {
+            const value = row[header];
+            return formatValue(value);
+        }));
+    }
+    let output = "";
+    if (title) {
+        output += pc.bold(pc.white(title)) + "\n\n";
+    }
+    output += table.toString();
+    return output;
+}
+/**
+ * Format a single value for display
+ */
+function formatValue(value) {
+    if (value === null || value === undefined) {
+        return pc.dim("-");
+    }
+    if (typeof value === "boolean") {
+        return value ? pc.green("✓") : pc.red("✗");
+    }
+    if (typeof value === "number") {
+        return pc.yellow(String(value));
+    }
+    if (value instanceof Date) {
+        return formatTimestamp(value.getTime());
+    }
+    if (typeof value === "object") {
+        if (Array.isArray(value)) {
+            if (value.length === 0) {
+                return pc.dim("[]");
+            }
+            return value.slice(0, 3).join(", ") + (value.length > 3 ? "..." : "");
+        }
+        return pc.dim("[object]");
+    }
+    const str = String(value);
+    // Truncate long strings
+    if (str.length > 50) {
+        return str.substring(0, 47) + "...";
+    }
+    return str;
+}
+/**
+ * Format a timestamp for display
+ */
+export function formatTimestamp(timestamp) {
+    const date = new Date(timestamp);
+    return date.toLocaleString();
+}
+/**
+ * Format a relative time (e.g., "2 hours ago")
+ */
+export function formatRelativeTime(timestamp) {
+    const now = Date.now();
+    const diff = now - timestamp;
+    const seconds = Math.floor(diff / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    const days = Math.floor(hours / 24);
+    if (days > 0) {
+        return `${days}d ago`;
+    }
+    if (hours > 0) {
+        return `${hours}h ago`;
+    }
+    if (minutes > 0) {
+        return `${minutes}m ago`;
+    }
+    return "just now";
+}
+/**
+ * Format bytes to human-readable size
+ */
+export function formatBytes(bytes) {
+    const units = ["B", "KB", "MB", "GB", "TB"];
+    let unitIndex = 0;
+    let size = bytes;
+    while (size >= 1024 && unitIndex < units.length - 1) {
+        size /= 1024;
+        unitIndex++;
+    }
+    return `${size.toFixed(1)} ${units[unitIndex]}`;
+}
+/**
+ * Format a count with proper pluralization
+ */
+export function formatCount(count, singular, plural) {
+    const word = count === 1 ? singular : (plural ?? `${singular}s`);
+    return `${count.toLocaleString()} ${word}`;
+}
+/**
+ * Print a success message
+ */
+export function printSuccess(message) {
+    console.log(pc.green(`✔ ${message}`));
+}
+/**
+ * Print an error message
+ */
+export function printError(message) {
+    console.error(pc.red(`✖ ${message}`));
+}
+/**
+ * Print a warning message
+ */
+export function printWarning(message) {
+    console.warn(pc.yellow(`⚠ ${message}`));
+}
+/**
+ * Print an info message
+ */
+export function printInfo(message) {
+    console.log(pc.blue(`ℹ ${message}`));
+}
+/**
+ * Print a header/title
+ */
+export function printHeader(title) {
+    console.log();
+    console.log(pc.bold(pc.white(title)));
+    console.log(pc.dim("─".repeat(title.length)));
+}
+/**
+ * Print a key-value pair
+ */
+export function printKeyValue(key, value) {
+    console.log(`  ${pc.cyan(key)}: ${formatValue(value)}`);
+}
+/**
+ * Print a section with key-value pairs
+ */
+export function printSection(title, data) {
+    printHeader(title);
+    for (const [key, value] of Object.entries(data)) {
+        printKeyValue(key, value);
+    }
+    console.log();
+}
+/**
+ * Print a divider line
+ */
+export function printDivider() {
+    console.log(pc.dim("─".repeat(40)));
+}
+/**
+ * Create a simple progress indicator
+ */
+export function createProgressText(current, total) {
+    const percentage = Math.round((current / total) * 100);
+    const filled = Math.round(percentage / 5);
+    const bar = "█".repeat(filled) + "░".repeat(20 - filled);
+    return `[${bar}] ${percentage}%`;
+}
+//# sourceMappingURL=formatting.js.map

package/dist/utils/formatting.js.map

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

package/dist/utils/validation.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Input Validation Utilities
+ *
+ * Provides validation functions for CLI inputs
+ */
+import type { MemorySpaceType, MemorySpaceStatus, FactType, OutputFormat } from "../types.js";
+/**
+ * Validation error
+ */
+export declare class ValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Validate a memory space ID
+ */
+export declare function validateMemorySpaceId(id: string): void;
+/**
+ * Validate a user ID
+ */
+export declare function validateUserId(id: string): void;
+/**
+ * Validate a memory ID
+ */
+export declare function validateMemoryId(id: string): void;
+/**
+ * Validate a conversation ID
+ */
+export declare function validateConversationId(id: string): void;
+/**
+ * Validate a fact ID
+ */
+export declare function validateFactId(id: string): void;
+/**
+ * Validate memory space type
+ */
+export declare function validateMemorySpaceType(type: string): MemorySpaceType;
+/**
+ * Validate memory space status
+ */
+export declare function validateMemorySpaceStatus(status: string): MemorySpaceStatus;
+/**
+ * Validate fact type
+ */
+export declare function validateFactType(type: string): FactType;
+/**
+ * Validate output format
+ */
+export declare function validateOutputFormat(format: string): OutputFormat;
+/**
+ * Validate a limit (pagination)
+ */
+export declare function validateLimit(limit: number, max?: number): number;
+/**
+ * Validate a URL
+ */
+export declare function validateUrl(url: string): void;
+/**
+ * Validate file path
+ */
+export declare function validateFilePath(path: string): void;
+/**
+ * Validate search query
+ */
+export declare function validateSearchQuery(query: string): void;
+/**
+ * Require confirmation for dangerous operations
+ */
+export declare function requireConfirmation(message: string, options?: {
+    confirmDangerous?: boolean;
+}): Promise<boolean>;
+/**
+ * Require exact text confirmation for very dangerous operations
+ */
+export declare function requireExactConfirmation(expectedText: string, message?: string): Promise<boolean>;
+/**
+ * Parse array argument from comma-separated string
+ */
+export declare function parseArrayArg(value: string): string[];
+/**
+ * Parse key-value pairs from "key=value" format
+ */
+export declare function parseKeyValueArg(value: string): Record<string, string>;
+//# sourceMappingURL=validation.d.ts.map