@cortexmemory/cli 0.1.0 → 0.22.0

package/dist/utils/init/file-operations.js

@@ -0,0 +1,211 @@
+/**
+ * File operations for init wizard
+ *
+ * Handles copying templates and deploying Cortex backend functions.
+ */
+import fs from "fs-extra";
+import path from "path";
+import { fileURLToPath } from "url";
+import { dirname } from "path";
+import { getSDKPath } from "../shell.js";
+import pc from "picocolors";
+// ES module equivalents of __dirname
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Copy Cortex backend functions from SDK to user project
+ */
+export async function deployCortexBackend(projectPath) {
+    // Look for SDK in the newly created project's node_modules
+    const sdkPath = getSDKPath(projectPath);
+    if (!sdkPath) {
+        // Debug: Check what's actually in node_modules
+        const nodeModulesPath = path.join(projectPath, "node_modules", "@cortexmemory");
+        const exists = fs.existsSync(nodeModulesPath);
+        throw new Error(`Could not locate @cortexmemory/sdk package. ` +
+            `Checked: ${path.join(projectPath, "node_modules", "@cortexmemory", "sdk")} ` +
+            `(@cortexmemory folder exists: ${exists})`);
+    }
+    const convexDevPath = path.join(sdkPath, "convex-dev");
+    const targetConvexPath = path.join(projectPath, "convex");
+    // Check if convex-dev exists in SDK
+    if (!fs.existsSync(convexDevPath)) {
+        throw new Error(`Convex backend functions not found at ${convexDevPath}. ` +
+            "Please ensure you are using @cortexmemory/sdk v0.8.1 or later.");
+    }
+    // Backup existing convex/ folder if it exists
+    try {
+        const backupPath = path.join(projectPath, `convex.backup.${Date.now()}`);
+        await fs.move(targetConvexPath, backupPath);
+        console.log(pc.yellow("   Existing convex/ folder backed up"));
+        console.log(pc.dim(`   Backed up to ${path.basename(backupPath)}`));
+    }
+    catch (error) {
+        const err = error;
+        if (err.code !== "ENOENT") {
+            throw error;
+        }
+    }
+    // Copy all files from convex-dev to convex
+    console.log(pc.dim("   Copying Cortex backend functions..."));
+    await fs.copy(convexDevPath, targetConvexPath, {
+        overwrite: true,
+        errorOnExist: false,
+    });
+    // List of critical files to verify
+    const criticalFiles = [
+        "schema.ts",
+        "conversations.ts",
+        "immutable.ts",
+        "mutable.ts",
+        "memories.ts",
+        "facts.ts",
+        "contexts.ts",
+        "memorySpaces.ts",
+        "users.ts",
+        "agents.ts",
+        "graphSync.ts",
+    ];
+    // Verify all critical files were copied
+    const missingFiles = criticalFiles.filter((file) => !fs.existsSync(path.join(targetConvexPath, file)));
+    if (missingFiles.length > 0) {
+        throw new Error(`Failed to copy some backend functions: ${missingFiles.join(", ")}`);
+    }
+    console.log(pc.green(`   Copied ${criticalFiles.length} backend functions`));
+}
+/**
+ * Create or update convex.json configuration
+ */
+export async function createConvexJson(projectPath) {
+    const convexJsonPath = path.join(projectPath, "convex.json");
+    const convexConfig = {
+        functions: "convex/",
+    };
+    await fs.writeJson(convexJsonPath, convexConfig, { spaces: 2 });
+    console.log(pc.dim("   Created convex.json"));
+}
+/**
+ * Copy project template files
+ */
+export async function copyTemplate(templateName, targetPath, projectName, convexVersion) {
+    // When running from npm/npx, templates are relative to the package root
+    // Try multiple possible locations
+    const possiblePaths = [
+        path.join(__dirname, "../../../templates", templateName), // From dist/utils/init/
+        path.join(__dirname, "../../../../templates", templateName), // From dist/utils/init/subdir
+        path.join(process.cwd(), "node_modules", "@cortexmemory", "cli", "templates", templateName), // From installed package
+    ];
+    let templatePath = null;
+    for (const tryPath of possiblePaths) {
+        if (fs.existsSync(tryPath)) {
+            templatePath = tryPath;
+            break;
+        }
+    }
+    console.log(pc.dim("   Looking for template..."));
+    if (!templatePath) {
+        throw new Error(`Template ${templateName} not found. Tried:\n` +
+            possiblePaths.map((p) => `  - ${p}`).join("\n"));
+    }
+    console.log(pc.dim(`   Found at: ${templatePath}`));
+    console.log(pc.dim(`   Copying to: ${targetPath}`));
+    // List what's in the template
+    const templateFiles = await fs.readdir(templatePath, { recursive: true });
+    console.log(pc.dim(`   Template has ${templateFiles.length} items`));
+    // Copy template files
+    console.log(pc.dim("   Starting fs.copy..."));
+    try {
+        await fs.copy(templatePath, targetPath, {
+            overwrite: true,
+            errorOnExist: false,
+            filter: (src) => {
+                const relativeSrc = path.relative(templatePath, src) || ".";
+                // Only skip if node_modules/dist are IN the template itself
+                const skip = relativeSrc.includes("node_modules") || relativeSrc.includes("dist");
+                console.log(pc.dim(`     Filter: ${relativeSrc} -> ${skip ? "SKIP" : "COPY"}`));
+                return !skip;
+            },
+        });
+        console.log(pc.dim("   fs.copy completed"));
+    }
+    catch (error) {
+        console.error(pc.red(`   fs.copy error: ${error}`));
+        throw new Error(`fs.copy failed: ${error}`);
+    }
+    // Verify key files were copied
+    const keyFiles = ["package.json", "src/index.ts", "tsconfig.json"];
+    const missing = keyFiles.filter((f) => !fs.existsSync(path.join(targetPath, f)));
+    if (missing.length > 0) {
+        throw new Error(`Failed to copy template files: ${missing.join(", ")} not found`);
+    }
+    // Replace template variables in package.json
+    const packageJsonPath = path.join(targetPath, "package.json");
+    try {
+        const packageJsonContent = await fs.readFile(packageJsonPath, "utf-8");
+        const packageJson = JSON.parse(packageJsonContent);
+        // Replace project name
+        packageJson.name = projectName;
+        // Update Convex version if provided
+        if (convexVersion && packageJson.dependencies?.convex) {
+            packageJson.dependencies.convex = convexVersion;
+            console.log(pc.dim(`   Using Convex ${convexVersion} (from SDK metadata)`));
+        }
+        // Write back with proper formatting
+        await fs.writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2) + "\n");
+    }
+    catch (error) {
+        const err = error;
+        if (err.code !== "ENOENT") {
+            throw error;
+        }
+    }
+}
+/**
+ * Create .gitignore if it doesn't exist
+ */
+export async function ensureGitignore(projectPath) {
+    const gitignorePath = path.join(projectPath, ".gitignore");
+    const gitignoreContent = `# Dependencies
+node_modules/
+
+# Build output
+dist/
+build/
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Convex
+.convex/
+`;
+    // Use atomic file operation to avoid race condition
+    try {
+        await fs.writeFile(gitignorePath, gitignoreContent, { flag: "wx" });
+        console.log(pc.dim("   Created .gitignore"));
+    }
+    catch (error) {
+        const err = error;
+        if (err.code !== "EEXIST") {
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=file-operations.js.map

package/dist/utils/init/file-operations.js.map

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

package/dist/utils/init/graph-setup.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Graph database setup
+ *
+ * Handles setting up Neo4j or Memgraph for the init wizard.
+ */
+import type { GraphConfig } from "./types.js";
+/**
+ * Get graph database configuration (prompts only, no file creation)
+ */
+export declare function getGraphConfig(): Promise<GraphConfig | null>;
+/**
+ * Create graph database files (docker-compose, etc.)
+ */
+export declare function setupGraphFiles(projectPath: string, config: GraphConfig): Promise<void>;
+/**
+ * Start graph database containers
+ */
+export declare function startGraphContainers(projectPath: string, graphType: "neo4j" | "memgraph"): Promise<boolean>;
+/**
+ * Stop graph database containers
+ */
+export declare function stopGraphContainers(projectPath: string): Promise<boolean>;
+/**
+ * Check if graph containers are running
+ */
+export declare function isGraphRunning(graphType: "neo4j" | "memgraph"): Promise<boolean>;
+/**
+ * Add graph database dependencies to package.json
+ */
+export declare function addGraphDependencies(projectPath: string): Promise<void>;
+/**
+ * Create example graph initialization file
+ */
+export declare function createGraphExample(projectPath: string): Promise<void>;
+//# sourceMappingURL=graph-setup.d.ts.map

package/dist/utils/init/graph-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-setup.d.ts","sourceRoot":"","sources":["../../../src/utils/init/graph-setup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAmE9C;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAmFlE;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CAKf;AA+BD;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,OAAO,GAAG,UAAU,GAC9B,OAAO,CAAC,OAAO,CAAC,CAyFlB;AA4CD;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,CA2BlB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,OAAO,GAAG,UAAU,GAC9B,OAAO,CAAC,OAAO,CAAC,CAWlB;AAoDD;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB7E;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuE3E"}

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

@@ -0,0 +1,413 @@
+/**
+ * Graph database setup
+ *
+ * Handles setting up Neo4j or Memgraph for the init wizard.
+ */
+import fs from "fs-extra";
+import path from "path";
+import prompts from "prompts";
+import ora from "ora";
+import pc from "picocolors";
+import { createGraphDockerCompose } from "./env-generator.js";
+import { execCommand } from "../shell.js";
+/**
+ * Check if Docker is installed
+ */
+async function checkDockerInstalled() {
+    try {
+        const result = await execCommand("docker", ["--version"], { quiet: true });
+        return result.code === 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Show Docker installation instructions
+ */
+function showDockerInstructions() {
+    console.log(pc.yellow("\n   Docker Desktop is not installed\n"));
+    console.log(pc.bold("To use local graph database, please install Docker Desktop:\n"));
+    const platform = process.platform;
+    if (platform === "darwin") {
+        console.log(pc.cyan("macOS:"));
+        console.log(pc.dim("  1. Download Docker Desktop: https://www.docker.com/products/docker-desktop"));
+        console.log(pc.dim("  2. Install and start Docker Desktop"));
+        console.log(pc.dim("  3. Run the wizard again\n"));
+    }
+    else if (platform === "win32") {
+        console.log(pc.cyan("Windows:"));
+        console.log(pc.dim("  1. Download Docker Desktop: https://www.docker.com/products/docker-desktop"));
+        console.log(pc.dim("  2. Install and start Docker Desktop"));
+        console.log(pc.dim("  3. Run the wizard again\n"));
+    }
+    else {
+        console.log(pc.cyan("Linux:"));
+        console.log(pc.dim("  1. Install Docker Engine: https://docs.docker.com/engine/install/"));
+        console.log(pc.dim("  2. Install Docker Compose: https://docs.docker.com/compose/install/"));
+        console.log(pc.dim("  3. Run the wizard again\n"));
+    }
+    console.log(pc.dim('Or choose "Cloud/Existing instance" to use a remote graph database.\n'));
+}
+/**
+ * Get graph database configuration (prompts only, no file creation)
+ */
+export async function getGraphConfig() {
+    console.log(pc.cyan("\n   Graph Database Setup"));
+    console.log(pc.dim("   Graph databases enable advanced relationship queries"));
+    console.log(pc.dim("   Recommended for production use\n"));
+    const { enableGraph } = await prompts({
+        type: "confirm",
+        name: "enableGraph",
+        message: "Enable graph database integration?",
+        initial: true,
+    });
+    if (!enableGraph) {
+        console.log(pc.dim("   Skipping graph database setup"));
+        return null;
+    }
+    const { graphType } = await prompts({
+        type: "select",
+        name: "graphType",
+        message: "Which graph database would you like to use?",
+        choices: [
+            { title: "Neo4j (Most popular, enterprise-ready)", value: "neo4j" },
+            {
+                title: "Memgraph (High-performance, analytics-focused)",
+                value: "memgraph",
+            },
+            { title: "Skip for now", value: "skip" },
+        ],
+        initial: 0,
+    });
+    if (!graphType || graphType === "skip") {
+        return null;
+    }
+    // Check for Docker if user wants local deployment
+    const hasDocker = await checkDockerInstalled();
+    const deploymentChoices = [
+        { title: "Local (Docker Compose)", value: "local", disabled: !hasDocker },
+        { title: "Cloud/Existing instance", value: "cloud" },
+    ];
+    if (!hasDocker) {
+        console.log(pc.yellow("   Docker not detected - local deployment unavailable"));
+    }
+    const { deploymentType } = await prompts({
+        type: "select",
+        name: "deploymentType",
+        message: `How would you like to run ${graphType === "neo4j" ? "Neo4j" : "Memgraph"}?`,
+        choices: deploymentChoices,
+        initial: hasDocker ? 0 : 1,
+    });
+    if (!deploymentType) {
+        return null;
+    }
+    // If local was selected but Docker isn't installed, show instructions
+    if (deploymentType === "local" && !hasDocker) {
+        showDockerInstructions();
+        return null;
+    }
+    let config;
+    if (deploymentType === "local") {
+        config = await getLocalGraphConfig(graphType);
+    }
+    else {
+        config = await getCloudGraphConfig(graphType);
+    }
+    console.log(pc.green("\n   Graph database configured"));
+    console.log(pc.dim(`   Type: ${config.type}`));
+    console.log(pc.dim(`   URI: ${config.uri}`));
+    return config;
+}
+/**
+ * Create graph database files (docker-compose, etc.)
+ */
+export async function setupGraphFiles(projectPath, config) {
+    // Only create docker-compose for local deployments
+    if (config.uri.includes("localhost") || config.uri.includes("127.0.0.1")) {
+        await createGraphDockerCompose(projectPath, config.type);
+    }
+}
+/**
+ * Get local graph database configuration
+ */
+async function getLocalGraphConfig(graphType) {
+    const defaultPort = 7687;
+    const defaultPassword = "cortex-password";
+    console.log(pc.cyan(`\n   Local ${graphType} will be configured with Docker Compose`));
+    if (graphType === "neo4j") {
+        console.log(pc.dim("   Neo4j Browser: http://localhost:7474"));
+        console.log(pc.dim("   Bolt: bolt://localhost:7687\n"));
+    }
+    else {
+        console.log(pc.dim("   Memgraph Lab: http://localhost:3000"));
+        console.log(pc.dim("   Bolt: bolt://localhost:7687\n"));
+    }
+    return {
+        type: graphType,
+        uri: `bolt://localhost:${defaultPort}`,
+        username: graphType === "neo4j" ? "neo4j" : "memgraph",
+        password: defaultPassword,
+    };
+}
+/**
+ * Start graph database containers
+ */
+export async function startGraphContainers(projectPath, graphType) {
+    const dockerComposePath = path.join(projectPath, "docker-compose.graph.yml");
+    if (!fs.existsSync(dockerComposePath)) {
+        console.log(pc.yellow("   docker-compose.graph.yml not found"));
+        return false;
+    }
+    const spinner = ora(`Starting ${graphType} containers...`).start();
+    const containerName = `cortex-${graphType}`;
+    try {
+        // Check if containers are already running
+        const checkResult = await execCommand("docker", ["ps", "--filter", `name=${containerName}`, "--format", "{{.Status}}"], { cwd: projectPath, quiet: true });
+        if (checkResult.stdout.includes("Up")) {
+            spinner.succeed(`${graphType} is already running`);
+            showGraphConnectionInfo(graphType);
+            return true;
+        }
+        // Check if container exists but is stopped (from a previous run)
+        const existsResult = await execCommand("docker", ["ps", "-a", "--filter", `name=${containerName}`, "--format", "{{.Names}}"], { cwd: projectPath, quiet: true });
+        if (existsResult.stdout.includes(containerName)) {
+            // Container exists, try to start it first
+            spinner.text = `Starting existing ${graphType} container...`;
+            const startResult = await execCommand("docker", ["start", containerName], { cwd: projectPath, quiet: true });
+            if (startResult.code === 0) {
+                await waitForGraphReady(spinner, graphType);
+                spinner.succeed(`${graphType} is running`);
+                showGraphConnectionInfo(graphType);
+                return true;
+            }
+            // If start failed, remove the old container and recreate
+            spinner.text = `Removing old ${graphType} container...`;
+            await execCommand("docker", ["rm", "-f", containerName], { cwd: projectPath, quiet: true });
+        }
+        // Pull images first (may take time on first run)
+        spinner.text = `Pulling ${graphType} image (this may take a few minutes on first run)...`;
+        await execCommand("docker", ["compose", "-f", "docker-compose.graph.yml", "pull"], { cwd: projectPath, quiet: true });
+        // Start containers
+        spinner.text = `Starting ${graphType} containers...`;
+        const result = await execCommand("docker", ["compose", "-f", "docker-compose.graph.yml", "up", "-d"], { cwd: projectPath, quiet: true });
+        if (result.code !== 0) {
+            spinner.fail(`Failed to start ${graphType}`);
+            console.log(pc.dim(`   Error: ${result.stderr}`));
+            return false;
+        }
+        // Wait for container to be healthy
+        await waitForGraphReady(spinner, graphType);
+        spinner.succeed(`${graphType} is running`);
+        showGraphConnectionInfo(graphType);
+        return true;
+    }
+    catch (error) {
+        spinner.fail(`Failed to start ${graphType}`);
+        console.log(pc.dim(`   Error: ${error}`));
+        return false;
+    }
+}
+/**
+ * Wait for graph database to be ready
+ */
+async function waitForGraphReady(spinner, graphType) {
+    spinner.text = `Waiting for ${graphType} to be ready...`;
+    const maxWait = 60; // seconds
+    const startTime = Date.now();
+    while ((Date.now() - startTime) / 1000 < maxWait) {
+        const healthCheck = await execCommand("docker", ["ps", "--filter", `name=cortex-${graphType}`, "--format", "{{.Status}}"], { quiet: true });
+        if (healthCheck.stdout.includes("Up")) {
+            // Give it a moment to fully initialize
+            await new Promise((resolve) => setTimeout(resolve, 3000));
+            return;
+        }
+        await new Promise((resolve) => setTimeout(resolve, 2000));
+    }
+}
+/**
+ * Show graph database connection info
+ */
+function showGraphConnectionInfo(graphType) {
+    if (graphType === "neo4j") {
+        console.log(pc.dim("     Browser: http://localhost:7474"));
+        console.log(pc.dim("     Bolt: bolt://localhost:7687"));
+        console.log(pc.dim("     Default login: neo4j / cortex-password"));
+    }
+    else {
+        console.log(pc.dim("     Memgraph Lab: http://localhost:3000"));
+        console.log(pc.dim("     Bolt: bolt://localhost:7687"));
+    }
+}
+/**
+ * Stop graph database containers
+ */
+export async function stopGraphContainers(projectPath) {
+    const dockerComposePath = path.join(projectPath, "docker-compose.graph.yml");
+    if (!fs.existsSync(dockerComposePath)) {
+        return false;
+    }
+    const spinner = ora("Stopping graph database containers...").start();
+    try {
+        const result = await execCommand("docker", ["compose", "-f", "docker-compose.graph.yml", "down"], { cwd: projectPath, quiet: true });
+        if (result.code === 0) {
+            spinner.succeed("Graph database containers stopped");
+            return true;
+        }
+        else {
+            spinner.fail("Failed to stop containers");
+            return false;
+        }
+    }
+    catch {
+        spinner.fail("Failed to stop containers");
+        return false;
+    }
+}
+/**
+ * Check if graph containers are running
+ */
+export async function isGraphRunning(graphType) {
+    try {
+        const result = await execCommand("docker", ["ps", "--filter", `name=cortex-${graphType}`, "--format", "{{.Status}}"], { quiet: true });
+        return result.stdout.includes("Up");
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get cloud/existing graph database configuration
+ */
+async function getCloudGraphConfig(graphType) {
+    console.log(pc.cyan("\n   Enter your graph database connection details:"));
+    const response = await prompts([
+        {
+            type: "text",
+            name: "uri",
+            message: "Database URI (e.g., bolt://localhost:7687):",
+            initial: "bolt://localhost:7687",
+            validate: (value) => {
+                if (!value)
+                    return "URI is required";
+                if (!value.startsWith("bolt://") && !value.startsWith("neo4j://")) {
+                    return "URI must start with bolt:// or neo4j://";
+                }
+                return true;
+            },
+        },
+        {
+            type: "text",
+            name: "username",
+            message: "Username:",
+            initial: graphType === "neo4j" ? "neo4j" : "memgraph",
+        },
+        {
+            type: "password",
+            name: "password",
+            message: "Password:",
+        },
+    ]);
+    if (!response.uri || !response.username || !response.password) {
+        throw new Error("All connection details are required");
+    }
+    console.log(pc.green("   Connection details saved"));
+    console.log(pc.dim("   Connection will be tested when you start your app"));
+    return {
+        type: graphType,
+        uri: response.uri,
+        username: response.username,
+        password: response.password,
+    };
+}
+/**
+ * Add graph database dependencies to package.json
+ */
+export async function addGraphDependencies(projectPath) {
+    const packageJsonPath = path.join(projectPath, "package.json");
+    if (!fs.existsSync(packageJsonPath)) {
+        throw new Error("package.json not found");
+    }
+    const packageJson = await fs.readJson(packageJsonPath);
+    // Add neo4j-driver if not present
+    if (!packageJson.dependencies) {
+        packageJson.dependencies = {};
+    }
+    if (!packageJson.dependencies["neo4j-driver"]) {
+        packageJson.dependencies["neo4j-driver"] = "^6.0.0";
+        await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
+        console.log(pc.dim("   Added neo4j-driver to dependencies"));
+    }
+}
+/**
+ * Create example graph initialization file
+ */
+export async function createGraphExample(projectPath) {
+    const examplePath = path.join(projectPath, "src", "graph-init.example.ts");
+    const exampleCode = `/**
+ * Graph Database Initialization Example
+ * 
+ * This file shows how to initialize and use the graph database
+ * with Cortex Memory SDK.
+ */
+
+import { Cortex } from '@cortexmemory/sdk';
+import { CypherGraphAdapter, initializeGraphSchema } from '@cortexmemory/sdk/graph';
+
+async function initializeGraph() {
+  // 1. Create graph adapter
+  const graphAdapter = new CypherGraphAdapter();
+  
+  // 2. Connect to graph database
+  await graphAdapter.connect({
+    uri: process.env.NEO4J_URI || 'bolt://localhost:7687',
+    username: process.env.NEO4J_USERNAME || 'neo4j',
+    password: process.env.NEO4J_PASSWORD || 'cortex-password',
+  });
+
+  // 3. Initialize schema (constraints and indexes)
+  await initializeGraphSchema(graphAdapter);
+
+  // 4. Initialize Cortex with graph integration
+  const cortex = new Cortex({
+    convexUrl: process.env.CONVEX_URL!,
+    graph: {
+      adapter: graphAdapter,
+      orphanCleanup: true,
+    },
+  });
+
+  return { cortex, graphAdapter };
+}
+
+// Example usage
+async function main() {
+  const { cortex, graphAdapter } = await initializeGraph();
+
+  try {
+    // Use Cortex normally - graph sync happens automatically!
+    await cortex.memory.remember({
+      memorySpaceId: 'my-agent',
+      conversationId: 'conv-1',
+      userMessage: 'Hello, Cortex with graph!',
+      agentResponse: 'Ready to remember with enhanced graph capabilities!',
+      userId: 'user-1',
+      userName: 'User',
+    });
+
+    console.log('Memory stored with graph enrichment!');
+  } finally {
+    // Cleanup
+    cortex.close();
+    await graphAdapter.disconnect();
+  }
+}
+
+// Uncomment to run:
+// main().catch(console.error);
+`;
+    await fs.ensureDir(path.dirname(examplePath));
+    await fs.writeFile(examplePath, exampleCode);
+    console.log(pc.dim(`   Created example: ${path.relative(projectPath, examplePath)}`));
+}
+//# sourceMappingURL=graph-setup.js.map