@cortexmemory/cli 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Cortex CLI Types
+ */
+/**
+ * Output format options
+ */
+export type OutputFormat = "table" | "json" | "csv";
+/**
+ * CLI configuration stored in ~/.cortexrc or ./cortex.config.json
+ */
+export interface CLIConfig {
+    deployments: Record<string, DeploymentConfig>;
+    default: string;
+    format: OutputFormat;
+    confirmDangerous: boolean;
+}
+/**
+ * Configuration for a single deployment
+ */
+export interface DeploymentConfig {
+    url: string;
+    key?: string;
+    deployment?: string;
+}
+/**
+ * Global CLI options that can be passed to any command
+ */
+export interface GlobalOptions {
+    deployment?: string;
+    url?: string;
+    key?: string;
+    format?: OutputFormat;
+    quiet?: boolean;
+    debug?: boolean;
+}
+/**
+ * Memory space types
+ */
+export type MemorySpaceType = "personal" | "team" | "project" | "custom";
+/**
+ * Memory space status
+ */
+export type MemorySpaceStatus = "active" | "archived";
+/**
+ * Fact types
+ */
+export type FactType = "preference" | "identity" | "knowledge" | "relationship" | "event" | "observation" | "custom";
+/**
+ * Source types for memories
+ */
+export type SourceType = "conversation" | "system" | "tool" | "a2a" | "fact-extraction";
+/**
+ * Statistics result for memory spaces
+ */
+export interface SpaceStats {
+    memorySpaceId: string;
+    conversationCount: number;
+    memoryCount: number;
+    factCount: number;
+    participantCount: number;
+    lastActivity?: number;
+}
+/**
+ * Database statistics
+ */
+export interface DatabaseStats {
+    memorySpaces: number;
+    conversations: number;
+    memories: number;
+    facts: number;
+    users: number;
+    immutableRecords: number;
+    mutableRecords: number;
+    contexts: number;
+}
+/**
+ * Backup data structure
+ */
+export interface BackupData {
+    version: string;
+    timestamp: number;
+    deployment: string;
+    data: {
+        memorySpaces?: unknown[];
+        conversations?: unknown[];
+        memories?: unknown[];
+        facts?: unknown[];
+        users?: unknown[];
+        immutable?: unknown[];
+        mutable?: unknown[];
+        contexts?: unknown[];
+    };
+}
+/**
+ * Result of a delete operation
+ */
+export interface DeleteResult {
+    deleted: boolean;
+    count: number;
+    ids: string[];
+}
+/**
+ * Result of a cascade deletion
+ */
+export interface CascadeDeleteResult {
+    deleted: boolean;
+    memoriesDeleted: number;
+    conversationsDeleted: number;
+    factsDeleted: number;
+    contextsDeleted: number;
+    totalDeleted: number;
+}
+/**
+ * User delete result with GDPR cascade
+ */
+export interface UserDeleteResult {
+    userId: string;
+    deletedAt: number;
+    conversationsDeleted: number;
+    conversationMessagesDeleted: number;
+    immutableRecordsDeleted: number;
+    mutableKeysDeleted: number;
+    vectorMemoriesDeleted: number;
+    factsDeleted: number;
+    graphNodesDeleted?: number;
+    verification: {
+        complete: boolean;
+        issues: string[];
+    };
+    totalDeleted: number;
+    deletedLayers: string[];
+}
+/**
+ * Command handler context
+ */
+export interface CommandContext {
+    config: CLIConfig;
+    convexUrl: string;
+    convexKey?: string;
+    format: OutputFormat;
+    quiet: boolean;
+    debug: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Cortex CLI Types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/utils/__tests__/config.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Config Utilities Tests
+ */
+export {};
+//# sourceMappingURL=config.test.d.ts.map

package/dist/utils/__tests__/config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.d.ts","sourceRoot":"","sources":["../../../src/utils/__tests__/config.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/utils/__tests__/config.test.js

@@ -0,0 +1,127 @@
+/**
+ * Config Utilities Tests
+ */
+import { describe, it, expect, beforeEach, afterEach } from "@jest/globals";
+import { getDeployment, resolveConfig, listDeployments } from "../config.js";
+describe("config utilities", () => {
+    const mockConfig = {
+        deployments: {
+            local: {
+                url: "http://127.0.0.1:3210",
+                deployment: "anonymous:local",
+            },
+            staging: {
+                url: "https://staging.convex.cloud",
+                key: "staging-key",
+            },
+            production: {
+                url: "https://prod.convex.cloud",
+                key: "prod-key",
+            },
+        },
+        default: "local",
+        format: "table",
+        confirmDangerous: true,
+    };
+    describe("getDeployment", () => {
+        it("should return deployment by name", () => {
+            const deployment = getDeployment(mockConfig, "staging");
+            expect(deployment).toEqual({
+                url: "https://staging.convex.cloud",
+                key: "staging-key",
+            });
+        });
+        it("should return default deployment when name not provided", () => {
+            const deployment = getDeployment(mockConfig);
+            expect(deployment).toEqual({
+                url: "http://127.0.0.1:3210",
+                deployment: "anonymous:local",
+            });
+        });
+        it("should return null for non-existent deployment", () => {
+            const deployment = getDeployment(mockConfig, "nonexistent");
+            expect(deployment).toBeNull();
+        });
+    });
+    describe("resolveConfig", () => {
+        it("should use URL from options if provided", () => {
+            const resolved = resolveConfig(mockConfig, {
+                url: "http://custom:3000",
+                key: "custom-key",
+            });
+            expect(resolved.url).toBe("http://custom:3000");
+            expect(resolved.key).toBe("custom-key");
+        });
+        it("should use deployment from options", () => {
+            const resolved = resolveConfig(mockConfig, {
+                deployment: "production",
+            });
+            expect(resolved.url).toBe("https://prod.convex.cloud");
+            expect(resolved.key).toBe("prod-key");
+        });
+        it("should use default deployment when no options", () => {
+            const resolved = resolveConfig(mockConfig, {});
+            expect(resolved.url).toBe("http://127.0.0.1:3210");
+            expect(resolved.deployment).toBe("anonymous:local");
+        });
+        it("should throw for non-existent deployment", () => {
+            expect(() => resolveConfig(mockConfig, { deployment: "nonexistent" })).toThrow('Deployment "nonexistent" not found');
+        });
+        it("should use format from options", () => {
+            const resolved = resolveConfig(mockConfig, { format: "json" });
+            expect(resolved.format).toBe("json");
+        });
+        it("should use format from config when not in options", () => {
+            const resolved = resolveConfig(mockConfig, {});
+            expect(resolved.format).toBe("table");
+        });
+        it("should handle quiet option", () => {
+            const resolved = resolveConfig(mockConfig, { quiet: true });
+            expect(resolved.quiet).toBe(true);
+        });
+        it("should handle debug option", () => {
+            const resolved = resolveConfig(mockConfig, { debug: true });
+            expect(resolved.debug).toBe(true);
+        });
+    });
+    describe("listDeployments", () => {
+        it("should list all deployments", () => {
+            const deployments = listDeployments(mockConfig);
+            expect(deployments).toHaveLength(3);
+        });
+        it("should include deployment names", () => {
+            const deployments = listDeployments(mockConfig);
+            const names = deployments.map((d) => d.name);
+            expect(names).toContain("local");
+            expect(names).toContain("staging");
+            expect(names).toContain("production");
+        });
+        it("should mark default deployment", () => {
+            const deployments = listDeployments(mockConfig);
+            const defaultDeployment = deployments.find((d) => d.isDefault);
+            expect(defaultDeployment?.name).toBe("local");
+        });
+        it("should indicate which deployments have keys", () => {
+            const deployments = listDeployments(mockConfig);
+            const local = deployments.find((d) => d.name === "local");
+            const staging = deployments.find((d) => d.name === "staging");
+            expect(local?.hasKey).toBe(false);
+            expect(staging?.hasKey).toBe(true);
+        });
+    });
+});
+describe("environment variable overrides", () => {
+    const originalEnv = process.env;
+    beforeEach(() => {
+        process.env = { ...originalEnv };
+    });
+    afterEach(() => {
+        process.env = originalEnv;
+    });
+    it("should be tested in integration tests with actual config loading", () => {
+        // Environment overrides are applied during loadConfig()
+        // These should be tested in integration tests
+        expect(true).toBe(true);
+    });
+});
+//# sourceMappingURL=config.test.js.map

package/dist/utils/__tests__/config.test.js.map

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

package/dist/utils/__tests__/formatting.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Formatting Utilities Tests
+ */
+export {};
+//# sourceMappingURL=formatting.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.test.d.ts","sourceRoot":"","sources":["../../../src/utils/__tests__/formatting.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/utils/__tests__/formatting.test.js

@@ -0,0 +1,132 @@
+/**
+ * Formatting Utilities Tests
+ */
+import { describe, it, expect } from "@jest/globals";
+import { formatJSON, formatCSV, formatTimestamp, formatRelativeTime, formatBytes, formatCount, } from "../formatting.js";
+describe("formatting utilities", () => {
+    describe("formatJSON", () => {
+        it("should format objects as pretty JSON", () => {
+            const data = { key: "value", num: 42 };
+            const result = formatJSON(data);
+            expect(result).toBe(JSON.stringify(data, null, 2));
+        });
+        it("should format arrays", () => {
+            const data = [1, 2, 3];
+            const result = formatJSON(data);
+            expect(result).toBe(JSON.stringify(data, null, 2));
+        });
+        it("should handle null", () => {
+            expect(formatJSON(null)).toBe("null");
+        });
+        it("should handle strings", () => {
+            expect(formatJSON("test")).toBe('"test"');
+        });
+    });
+    describe("formatCSV", () => {
+        it("should format array of objects as CSV", () => {
+            const data = [
+                { name: "Alice", age: 30 },
+                { name: "Bob", age: 25 },
+            ];
+            const result = formatCSV(data);
+            expect(result).toContain("name,age");
+            expect(result).toContain("Alice,30");
+            expect(result).toContain("Bob,25");
+        });
+        it("should handle custom headers", () => {
+            const data = [{ name: "Test", extra: "ignored" }];
+            const result = formatCSV(data, ["name"]);
+            expect(result).toContain("name");
+            expect(result).not.toContain("extra");
+        });
+        it("should escape values with commas", () => {
+            const data = [{ text: "hello, world" }];
+            const result = formatCSV(data);
+            expect(result).toContain('"hello, world"');
+        });
+        it("should escape values with quotes", () => {
+            const data = [{ text: 'say "hello"' }];
+            const result = formatCSV(data);
+            expect(result).toContain('"say ""hello"""');
+        });
+        it("should handle empty array", () => {
+            expect(formatCSV([])).toBe("");
+        });
+        it("should wrap single object in array", () => {
+            const data = { name: "Test" };
+            const result = formatCSV(data);
+            expect(result).toContain("name");
+            expect(result).toContain("Test");
+        });
+    });
+    describe("formatTimestamp", () => {
+        it("should format timestamp as locale string", () => {
+            const timestamp = new Date("2025-01-15T10:30:00Z").getTime();
+            const result = formatTimestamp(timestamp);
+            expect(result).toBeTruthy();
+            expect(typeof result).toBe("string");
+        });
+        it("should handle current timestamp", () => {
+            const result = formatTimestamp(Date.now());
+            expect(result).toBeTruthy();
+        });
+    });
+    describe("formatRelativeTime", () => {
+        it('should format recent time as "just now"', () => {
+            const timestamp = Date.now() - 30000; // 30 seconds ago
+            const result = formatRelativeTime(timestamp);
+            expect(result).toBe("just now");
+        });
+        it("should format minutes ago", () => {
+            const timestamp = Date.now() - 5 * 60 * 1000; // 5 minutes ago
+            const result = formatRelativeTime(timestamp);
+            expect(result).toBe("5m ago");
+        });
+        it("should format hours ago", () => {
+            const timestamp = Date.now() - 3 * 60 * 60 * 1000; // 3 hours ago
+            const result = formatRelativeTime(timestamp);
+            expect(result).toBe("3h ago");
+        });
+        it("should format days ago", () => {
+            const timestamp = Date.now() - 2 * 24 * 60 * 60 * 1000; // 2 days ago
+            const result = formatRelativeTime(timestamp);
+            expect(result).toBe("2d ago");
+        });
+    });
+    describe("formatBytes", () => {
+        it("should format bytes", () => {
+            expect(formatBytes(500)).toBe("500.0 B");
+        });
+        it("should format kilobytes", () => {
+            expect(formatBytes(1024)).toBe("1.0 KB");
+            expect(formatBytes(2048)).toBe("2.0 KB");
+        });
+        it("should format megabytes", () => {
+            expect(formatBytes(1024 * 1024)).toBe("1.0 MB");
+        });
+        it("should format gigabytes", () => {
+            expect(formatBytes(1024 * 1024 * 1024)).toBe("1.0 GB");
+        });
+        it("should handle zero", () => {
+            expect(formatBytes(0)).toBe("0.0 B");
+        });
+    });
+    describe("formatCount", () => {
+        it("should format singular", () => {
+            expect(formatCount(1, "memory", "memories")).toBe("1 memory");
+            expect(formatCount(1, "user")).toBe("1 user");
+        });
+        it("should format plural", () => {
+            expect(formatCount(5, "memory", "memories")).toBe("5 memories");
+            expect(formatCount(0, "memory", "memories")).toBe("0 memories");
+        });
+        it("should auto-pluralize without explicit plural", () => {
+            expect(formatCount(2, "user")).toBe("2 users");
+        });
+        it("should format large numbers with commas", () => {
+            expect(formatCount(1000, "item")).toBe("1,000 items");
+            expect(formatCount(1000000, "record")).toBe("1,000,000 records");
+        });
+    });
+});
+//# sourceMappingURL=formatting.test.js.map

package/dist/utils/__tests__/formatting.test.js.map

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

package/dist/utils/__tests__/validation.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Validation Utilities Tests
+ */
+export {};
+//# sourceMappingURL=validation.test.d.ts.map

package/dist/utils/__tests__/validation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.test.d.ts","sourceRoot":"","sources":["../../../src/utils/__tests__/validation.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}