@cortexmemory/cli 0.1.0 → 0.22.0

package/dist/utils/init/convex-setup.js

@@ -0,0 +1,225 @@
+/**
+ * Convex setup handlers
+ *
+ * Handles setting up Convex for the init wizard.
+ */
+import fs from "fs-extra";
+import path from "path";
+import prompts from "prompts";
+import { execCommandLive, commandExists } from "../shell.js";
+import pc from "picocolors";
+import ora from "ora";
+// Note: execCommand is not used in this file anymore but keeping ora for setupNewConvex/setupExistingConvex
+/**
+ * Setup new Convex database (cloud)
+ */
+export async function setupNewConvex(projectPath) {
+    console.log(pc.cyan("\n   Setting up new Convex database..."));
+    // Clean up any existing Convex state that might interfere
+    // This prevents "DeploymentNotFound" errors from old cached state
+    const convexStatePath = path.join(projectPath, ".convex");
+    if (await fs.pathExists(convexStatePath)) {
+        console.log(pc.dim("   Cleaning up old Convex state..."));
+        await fs.remove(convexStatePath);
+    }
+    // Also clean up .env.local which may have old CONVEX_DEPLOYMENT reference
+    const envLocalPath = path.join(projectPath, ".env.local");
+    if (await fs.pathExists(envLocalPath)) {
+        console.log(pc.dim("   Removing old .env.local (will be recreated)..."));
+        await fs.remove(envLocalPath);
+    }
+    // Check if convex CLI is available
+    const hasConvex = await commandExists("convex");
+    if (!hasConvex) {
+        console.log(pc.yellow("   Convex CLI not found globally, will use npx"));
+    }
+    const spinner = ora("Initializing Convex...").start();
+    try {
+        // Run convex dev --once --until-success
+        spinner.stop();
+        console.log(pc.dim("   Running Convex setup (this may prompt for login)..."));
+        console.log(pc.dim("   Follow the prompts to create your Convex project\n"));
+        const command = hasConvex ? "convex" : "npx";
+        const args = hasConvex
+            ? ["dev", "--once", "--until-success"]
+            : ["convex", "dev", "--once", "--until-success"];
+        // Override any inherited Convex env vars that might interfere with fresh setup
+        // (e.g., from parent directory's .env.local being injected by dotenv)
+        // Setting to empty string effectively clears them for the child process
+        const cleanConvexEnv = {
+            CONVEX_URL: "",
+            CONVEX_DEPLOYMENT: "",
+            CONVEX_DEPLOY_KEY: "",
+        };
+        const exitCode = await execCommandLive(command, args, {
+            cwd: projectPath,
+            env: cleanConvexEnv,
+        });
+        if (exitCode !== 0) {
+            throw new Error(`Convex setup failed with exit code ${exitCode}`);
+        }
+        // Read the generated .env.local to get CONVEX_URL
+        const envLocalPath = path.join(projectPath, ".env.local");
+        let convexUrl = "";
+        let deployKey = "";
+        try {
+            const envContent = await fs.readFile(envLocalPath, "utf-8");
+            const urlMatch = envContent.match(/CONVEX_URL=(.+)/);
+            const keyMatch = envContent.match(/CONVEX_DEPLOY_KEY=(.+)/);
+            if (urlMatch) {
+                convexUrl = urlMatch[1].trim();
+            }
+            if (keyMatch) {
+                deployKey = keyMatch[1].trim();
+            }
+        }
+        catch (error) {
+            const err = error;
+            if (err.code !== "ENOENT") {
+                throw error;
+            }
+        }
+        if (!convexUrl) {
+            // Fallback: prompt user for URL
+            const response = await prompts({
+                type: "text",
+                name: "url",
+                message: "Enter your Convex deployment URL:",
+                validate: (value) => value.includes("convex.cloud") || value.includes("convex.site")
+                    ? true
+                    : "Please enter a valid Convex URL",
+            });
+            convexUrl = response.url;
+        }
+        console.log(pc.green("\n   Convex database configured"));
+        console.log(pc.dim(`   URL: ${convexUrl}`));
+        return {
+            convexUrl,
+            deployKey: deployKey || undefined,
+        };
+    }
+    catch (error) {
+        spinner.stop();
+        throw new Error(`Failed to setup Convex: ${error}`);
+    }
+}
+/**
+ * Setup with existing Convex database
+ */
+export async function setupExistingConvex() {
+    console.log(pc.cyan("\n   Configuring existing Convex database..."));
+    const response = await prompts([
+        {
+            type: "text",
+            name: "convexUrl",
+            message: "Enter your Convex deployment URL:",
+            validate: (value) => {
+                if (!value)
+                    return "URL is required";
+                if (!value.startsWith("http"))
+                    return "Please enter a valid URL";
+                return true;
+            },
+        },
+        {
+            type: "text",
+            name: "deployKey",
+            message: "Enter your Convex deploy key (optional, press Enter to skip):",
+        },
+    ]);
+    if (!response.convexUrl) {
+        throw new Error("Convex URL is required");
+    }
+    // Validate connection
+    const spinner = ora("Validating Convex connection...").start();
+    try {
+        const isValid = response.convexUrl.includes("convex.cloud") ||
+            response.convexUrl.includes("convex.site") ||
+            response.convexUrl.includes("localhost");
+        if (!isValid) {
+            spinner.fail("Invalid Convex URL format");
+            throw new Error("Invalid Convex URL");
+        }
+        spinner.succeed("Convex connection validated");
+        console.log(pc.dim(`   URL: ${response.convexUrl}`));
+        return {
+            convexUrl: response.convexUrl,
+            deployKey: response.deployKey || undefined,
+        };
+    }
+    catch (error) {
+        spinner.fail("Failed to validate Convex connection");
+        throw error;
+    }
+}
+/**
+ * Setup local Convex for development
+ *
+ * Note: Convex's --local flag requires a cloud project to be set up first.
+ * So we create the cloud project during init, then the user can run
+ * `cortex start --local` or `convex dev --local` for local development.
+ */
+export async function setupLocalConvex() {
+    console.log(pc.cyan("\n   Setting up Convex for local development..."));
+    console.log(pc.yellow("   Note: A Convex cloud project will be created first"));
+    console.log(pc.dim("   After setup, run 'cortex start --local' for local development"));
+    console.log(pc.dim("   Local mode: faster iteration, but no vector search\n"));
+    // Return empty config - the actual URL will come from convex dev
+    return {
+        convexUrl: "", // Will be filled in after convex dev runs
+    };
+}
+/**
+ * Deploy Cortex backend functions to Convex
+ *
+ * Note: We don't use --local flag during init because Convex requires
+ * a cloud project to exist first. Users can run --local after setup.
+ */
+export async function deployToConvex(projectPath, config, _isLocal = false) {
+    console.log(pc.cyan("\n   Deploying Cortex backend to Convex..."));
+    console.log(pc.dim("   This may prompt for configuration on first run\n"));
+    try {
+        // Check if convex CLI is available
+        const hasConvex = await commandExists("convex");
+        // Build command and args based on whether convex is installed globally
+        let command;
+        let args;
+        if (hasConvex) {
+            command = "convex";
+            args = ["dev", "--once", "--until-success"];
+        }
+        else {
+            command = "npx";
+            args = ["convex", "dev", "--once", "--until-success"];
+        }
+        // Note: We don't add --local here because:
+        // 1. Convex requires a cloud project to exist first
+        // 2. --local on a fresh project causes "DeploymentNotFound" errors
+        // Users can run `cortex start --local` after setup completes
+        // Set environment for deployment (only if URL is provided)
+        const env = {
+            ...process.env,
+        };
+        if (config.convexUrl) {
+            env.CONVEX_URL = config.convexUrl;
+        }
+        if (config.deployKey) {
+            env.CONVEX_DEPLOY_KEY = config.deployKey;
+        }
+        // Run convex dev --once with live output (allows interactive prompts)
+        const exitCode = await execCommandLive(command, args, {
+            cwd: projectPath,
+            env,
+        });
+        if (exitCode !== 0) {
+            throw new Error("Failed to deploy Cortex backend");
+        }
+        console.log(pc.green("\n   Backend deployed to Convex"));
+        console.log(pc.dim("   All functions and schema are deployed"));
+    }
+    catch (error) {
+        console.error(pc.red("\n   Deployment failed"));
+        throw error;
+    }
+}
+//# sourceMappingURL=convex-setup.js.map

package/dist/utils/init/convex-setup.js.map

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

package/dist/utils/init/env-generator.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Environment file generator
+ *
+ * Generates .env.local and docker-compose files for init wizard.
+ */
+import type { WizardConfig } from "./types.js";
+/**
+ * Generate .env.local file content based on wizard configuration
+ */
+export declare function generateEnvFile(config: WizardConfig): string;
+/**
+ * Write .env.local file to project
+ *
+ * IMPORTANT: If Convex CLI has already created .env.local (with CONVEX_URL,
+ * CONVEX_DEPLOYMENT, etc.), we preserve those lines and only add our
+ * additional configuration (graph DB, OpenAI, etc.)
+ */
+export declare function createEnvFile(projectPath: string, config: WizardConfig): Promise<void>;
+/**
+ * Append graph database configuration to existing .env.local
+ * Called after Convex deployment which may have modified .env.local
+ */
+export declare function appendGraphEnvVars(projectPath: string, config: {
+    graphUri: string;
+    graphUsername: string;
+    graphPassword: string;
+}): Promise<void>;
+/**
+ * Create docker-compose.yml for local graph database
+ */
+export declare function createGraphDockerCompose(projectPath: string, graphType: "neo4j" | "memgraph"): Promise<void>;
+//# sourceMappingURL=env-generator.d.ts.map

package/dist/utils/init/env-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-generator.d.ts","sourceRoot":"","sources":["../../../src/utils/init/env-generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CA+C5D;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,IAAI,CAAC,CAgEf;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE;IACN,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB,GACA,OAAO,CAAC,IAAI,CAAC,CAkCf;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,OAAO,GAAG,UAAU,GAC9B,OAAO,CAAC,IAAI,CAAC,CAkDf"}

package/dist/utils/init/env-generator.js

@@ -0,0 +1,210 @@
+/**
+ * Environment file generator
+ *
+ * Generates .env.local and docker-compose files for init wizard.
+ */
+import fs from "fs-extra";
+import path from "path";
+import pc from "picocolors";
+/**
+ * Generate .env.local file content based on wizard configuration
+ */
+export function generateEnvFile(config) {
+    let env = `# Cortex Memory SDK Configuration
+# Generated by cortex init on ${new Date().toISOString()}
+
+# =============================================================================
+# Convex Configuration
+# =============================================================================
+`;
+    // Add Convex configuration based on setup type
+    if (config.convexSetupType === "local") {
+        env += `# Local Development
+LOCAL_CONVEX_URL=http://127.0.0.1:3210
+LOCAL_CONVEX_DEPLOYMENT=anonymous:anonymous-${config.projectName}
+CONVEX_URL=http://127.0.0.1:3210
+`;
+    }
+    else {
+        env += `# Convex Cloud
+CONVEX_URL=${config.convexUrl || ""}
+`;
+        if (config.deployKey) {
+            env += `CONVEX_DEPLOY_KEY=${config.deployKey}
+`;
+        }
+    }
+    // Add graph database configuration if enabled
+    if (config.graphEnabled && config.graphType !== "skip") {
+        env += `
+# =============================================================================
+# Graph Database Configuration (Optional)
+# =============================================================================
+NEO4J_URI=${config.graphUri || "bolt://localhost:7687"}
+NEO4J_USERNAME=${config.graphUsername || "neo4j"}
+NEO4J_PASSWORD=${config.graphPassword || "cortex-password"}
+`;
+    }
+    env += `
+# =============================================================================
+# OpenAI API Key (Optional - for embeddings)
+# =============================================================================
+# OPENAI_API_KEY=sk-...
+
+`;
+    return env;
+}
+/**
+ * Write .env.local file to project
+ *
+ * IMPORTANT: If Convex CLI has already created .env.local (with CONVEX_URL,
+ * CONVEX_DEPLOYMENT, etc.), we preserve those lines and only add our
+ * additional configuration (graph DB, OpenAI, etc.)
+ */
+export async function createEnvFile(projectPath, config) {
+    const envPath = path.join(projectPath, ".env.local");
+    // Check if .env.local already exists (likely created by convex dev)
+    let existingContent = "";
+    let hasExistingConvexConfig = false;
+    try {
+        existingContent = await fs.readFile(envPath, "utf-8");
+        // Check if Convex has already configured this file
+        hasExistingConvexConfig = existingContent.includes("CONVEX_URL=") ||
+            existingContent.includes("CONVEX_DEPLOYMENT=");
+    }
+    catch {
+        // File doesn't exist, will create new
+    }
+    if (hasExistingConvexConfig) {
+        // Preserve the Convex-generated content, just add our header and optional extras
+        console.log(pc.dim("   Preserving Convex configuration in .env.local"));
+        // Add header if not present
+        let finalContent = existingContent;
+        if (!existingContent.includes("# Cortex Memory SDK Configuration")) {
+            finalContent = `# Cortex Memory SDK Configuration
+# Generated by cortex init on ${new Date().toISOString()}
+
+${existingContent}`;
+        }
+        // Add OpenAI placeholder if not present
+        if (!existingContent.includes("OPENAI_API_KEY")) {
+            finalContent += `
+# =============================================================================
+# OpenAI API Key (Optional - for embeddings)
+# =============================================================================
+# OPENAI_API_KEY=sk-...
+`;
+        }
+        await fs.writeFile(envPath, finalContent);
+        console.log(pc.green("   Updated .env.local"));
+    }
+    else {
+        // No existing Convex config, create fresh file
+        const envContent = generateEnvFile(config);
+        // Backup any existing file first
+        try {
+            const backupPath = path.join(projectPath, `.env.local.backup.${Date.now()}`);
+            await fs.move(envPath, backupPath);
+            console.log(pc.yellow("   Existing .env.local backed up"));
+            console.log(pc.dim(`   Backed up to ${path.basename(backupPath)}`));
+        }
+        catch (error) {
+            const err = error;
+            if (err.code !== "ENOENT") {
+                throw error;
+            }
+        }
+        await fs.writeFile(envPath, envContent);
+        console.log(pc.green("   Created .env.local"));
+    }
+}
+/**
+ * Append graph database configuration to existing .env.local
+ * Called after Convex deployment which may have modified .env.local
+ */
+export async function appendGraphEnvVars(projectPath, config) {
+    const envPath = path.join(projectPath, ".env.local");
+    const graphEnvVars = `
+# =============================================================================
+# Graph Database Configuration
+# =============================================================================
+NEO4J_URI=${config.graphUri}
+NEO4J_USERNAME=${config.graphUsername}
+NEO4J_PASSWORD=${config.graphPassword}
+`;
+    try {
+        // Read existing content
+        let existingContent = "";
+        try {
+            existingContent = await fs.readFile(envPath, "utf-8");
+        }
+        catch {
+            // File doesn't exist, will create new
+        }
+        // Check if graph vars already exist
+        if (existingContent.includes("NEO4J_URI=")) {
+            console.log(pc.dim("   Graph env vars already present in .env.local"));
+            return;
+        }
+        // Append graph vars
+        await fs.writeFile(envPath, existingContent + graphEnvVars);
+        console.log(pc.green("   Added graph database env vars to .env.local"));
+    }
+    catch {
+        console.warn(pc.yellow("   Warning: Could not update .env.local with graph config"));
+        console.log(pc.dim(`   Please add manually:\n${graphEnvVars}`));
+    }
+}
+/**
+ * Create docker-compose.yml for local graph database
+ */
+export async function createGraphDockerCompose(projectPath, graphType) {
+    const dockerComposePath = path.join(projectPath, "docker-compose.graph.yml");
+    let dockerCompose = "";
+    if (graphType === "neo4j") {
+        dockerCompose = `services:
+  neo4j:
+    image: neo4j:5-community
+    container_name: cortex-neo4j
+    ports:
+      - "7474:7474"  # HTTP
+      - "7687:7687"  # Bolt
+    environment:
+      - NEO4J_AUTH=neo4j/cortex-password
+      - NEO4J_PLUGINS=["apoc"]
+      - NEO4J_dbms_security_procedures_unrestricted=apoc.*
+    volumes:
+      - neo4j_data:/data
+      - neo4j_logs:/logs
+    restart: unless-stopped
+
+volumes:
+  neo4j_data:
+  neo4j_logs:
+`;
+    }
+    else if (graphType === "memgraph") {
+        dockerCompose = `services:
+  memgraph:
+    image: memgraph/memgraph-platform:latest
+    container_name: cortex-memgraph
+    ports:
+      - "7687:7687"  # Bolt
+      - "3000:3000"  # Memgraph Lab
+      - "7444:7444"  # Memgraph Lab secure
+    environment:
+      - MEMGRAPH="--log-level=TRACE"
+    volumes:
+      - memgraph_data:/var/lib/memgraph
+      - memgraph_logs:/var/log/memgraph
+    restart: unless-stopped
+
+volumes:
+  memgraph_data:
+  memgraph_logs:
+`;
+    }
+    await fs.writeFile(dockerComposePath, dockerCompose);
+    console.log(pc.dim(`   Created docker-compose.graph.yml for ${graphType}`));
+}
+//# sourceMappingURL=env-generator.js.map

package/dist/utils/init/env-generator.js.map

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

package/dist/utils/init/file-operations.d.ts

@@ -0,0 +1,22 @@
+/**
+ * File operations for init wizard
+ *
+ * Handles copying templates and deploying Cortex backend functions.
+ */
+/**
+ * Copy Cortex backend functions from SDK to user project
+ */
+export declare function deployCortexBackend(projectPath: string): Promise<void>;
+/**
+ * Create or update convex.json configuration
+ */
+export declare function createConvexJson(projectPath: string): Promise<void>;
+/**
+ * Copy project template files
+ */
+export declare function copyTemplate(templateName: string, targetPath: string, projectName: string, convexVersion?: string): Promise<void>;
+/**
+ * Create .gitignore if it doesn't exist
+ */
+export declare function ensureGitignore(projectPath: string): Promise<void>;
+//# sourceMappingURL=file-operations.d.ts.map

package/dist/utils/init/file-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-operations.d.ts","sourceRoot":"","sources":["../../../src/utils/init/file-operations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgF5E;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASzE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CA0Gf;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6CxE"}