@cortexmemory/cli 0.26.2 → 0.27.3

package/dist/commands/deploy.js

@@ -3,14 +3,17 @@
  *
  * Top-level commands for deploying and updating Cortex projects:
  * - deploy: Deploy schema and functions to Convex
- * - update: Update @cortexmemory/sdk and convex packages
+ * - update: Update @cortexmemory/sdk and convex packages across deployments and apps
  */
 import ora from "ora";
+import path from "path";
+import fs from "fs-extra";
 import { resolveConfig, loadConfig } from "../utils/config.js";
-import { selectDeployment } from "../utils/deployment-selector.js";
+import { selectDeployment, getEnabledDeployments, } from "../utils/deployment-selector.js";
 import { getDeploymentInfo } from "../utils/client.js";
 import { printSuccess, printError, printWarning, printInfo, printSection, } from "../utils/formatting.js";
 import { execCommand, execCommandLive } from "../utils/shell.js";
+import { syncAppTemplate, checkTemplateSync, printTemplateSyncResult, } from "../utils/app-template-sync.js";
 import pc from "picocolors";
 /**
  * Build environment for Convex commands, removing inherited CONVEX_* vars
@@ -136,195 +139,819 @@ export function registerDeployCommands(program, _config) {
     // cortex update
     program
         .command("update")
-        .description("Update @cortexmemory/sdk and convex packages")
-        .option("-d, --deployment <name>", "Target deployment")
+        .description("Update @cortexmemory/sdk and convex packages across all enabled deployments and apps")
+        .option("-d, --deployment <name>", "Target a specific deployment only")
+        .option("-a, --app <name>", "Target a specific app only")
+        .option("--apps-only", "Only update apps (skip deployments)", false)
+        .option("--deployments-only", "Only update deployments (skip apps)", false)
+        .option("--dev", "Use dev mode (link to local SDK via CORTEX_SDK_DEV_PATH)", false)
+        .option("--sync-template", "Sync app template files (components, routes, etc.)", false)
         .option("--sdk-version <version>", "Specific Cortex SDK version to install")
         .option("--convex-version <version>", "Specific Convex version to install")
+        .option("--provider-version <version>", "Specific vercel-ai-provider version to install")
         .option("-y, --yes", "Auto-accept all updates", false)
         .action(async (options) => {
         const currentConfig = await loadConfig();
-        const selection = await selectDeployment(currentConfig, options, "update packages");
-        if (!selection)
+        // Check for dev mode
+        const devPath = process.env.CORTEX_SDK_DEV_PATH;
+        const isDevMode = options.dev || !!devPath;
+        if (isDevMode && !devPath) {
+            console.log(pc.red("\n   Dev mode requires CORTEX_SDK_DEV_PATH environment variable"));
+            console.log(pc.dim("   Set it to the path of your local Project-Cortex repo:"));
+            console.log(pc.dim("   export CORTEX_SDK_DEV_PATH=/path/to/Project-Cortex\n"));
             return;
-        const { deployment } = selection;
-        const projectPath = deployment.projectPath || process.cwd();
-        const spinner = ora("Checking for updates...").start();
-        try {
-            // Get current Cortex SDK version
-            let currentSdkVersion = "not installed";
+        }
+        // If -a flag is provided, use single app mode
+        if (options.app) {
+            const app = currentConfig.apps?.[options.app];
+            if (!app) {
+                console.log(pc.red(`\n   App "${options.app}" not found`));
+                const appNames = Object.keys(currentConfig.apps || {});
+                if (appNames.length > 0) {
+                    console.log(pc.dim(`   Available: ${appNames.join(", ")}`));
+                }
+                else {
+                    console.log(pc.dim("   No apps configured. Run 'cortex init' to add one."));
+                }
+                return;
+            }
             try {
-                const result = await execCommand("npm", ["list", "@cortexmemory/sdk", "--json"], { quiet: true, cwd: projectPath });
-                const data = JSON.parse(result.stdout);
-                currentSdkVersion =
-                    data.dependencies?.["@cortexmemory/sdk"]?.version ??
-                        "not installed";
+                await updateApp(options.app, app, {
+                    ...options,
+                    devPath: isDevMode ? devPath : undefined,
+                    syncTemplate: options.syncTemplate,
+                });
             }
-            catch {
-                // Ignore errors
+            catch (error) {
+                printError(`Failed to update app "${options.app}": ${error instanceof Error ? error.message : "Unknown error"}`);
             }
-            // Get latest Cortex SDK version from npm
-            let latestSdkVersion = "unknown";
+            return;
+        }
+        // If -d flag is provided, use single deployment mode (existing behavior)
+        if (options.deployment) {
+            const selection = await selectDeployment(currentConfig, options, "update packages");
+            if (!selection)
+                return;
+            const { name, deployment } = selection;
             try {
-                const result = await execCommand("npm", ["view", "@cortexmemory/sdk", "version"], { quiet: true });
-                latestSdkVersion = result.stdout.trim();
+                await updateDeployment(name, deployment, options);
             }
-            catch {
-                // Ignore errors
+            catch (error) {
+                printError(`Failed to update deployment "${name}": ${error instanceof Error ? error.message : "Unknown error"}`);
             }
-            // Get current Convex version
-            let currentConvexVersion = "not installed";
+            return;
+        }
+        // Determine what to update based on flags
+        const updateDeployments = !options.appsOnly;
+        const updateApps = !options.deploymentsOnly;
+        // Get enabled deployments and apps
+        const { deployments: enabledDeployments } = getEnabledDeployments(currentConfig);
+        const enabledApps = Object.entries(currentConfig.apps || {})
+            .filter(([, app]) => app.enabled)
+            .map(([name, app]) => ({ name, app }));
+        const hasDeployments = enabledDeployments.length > 0;
+        const hasApps = enabledApps.length > 0;
+        if (updateDeployments && !hasDeployments && !options.appsOnly) {
+            console.log(pc.yellow("\n   No enabled deployments found"));
+        }
+        if (updateApps && !hasApps && !options.deploymentsOnly) {
+            console.log(pc.yellow("\n   No enabled apps found"));
+        }
+        if ((!updateDeployments || !hasDeployments) && (!updateApps || !hasApps)) {
+            console.log(pc.red("\n   Nothing to update"));
+            console.log(pc.dim("   Run 'cortex init' to configure deployments and apps\n"));
+            return;
+        }
+        // Single deployment + no apps - proceed directly (backwards compatibility)
+        if (updateDeployments && enabledDeployments.length === 1 && (!updateApps || !hasApps)) {
+            const { name, deployment } = enabledDeployments[0];
+            console.log(pc.dim(`   Using: ${name}`));
+            await updateDeployment(name, deployment, options);
+            return;
+        }
+        // Multiple targets or apps - show status dashboard
+        console.log();
+        const spinner = ora("Checking package versions...").start();
+        // Get latest versions once (shared across all targets)
+        let latestSdkVersion = "unknown";
+        let latestConvexVersion = "unknown";
+        let latestProviderVersion = "unknown";
+        let latestAiVersion = "unknown";
+        let sdkConvexPeerDep = "unknown";
+        try {
+            const [sdkResult, convexResult, providerResult, aiResult, peerDepResult] = await Promise.all([
+                execCommand("npm", ["view", "@cortexmemory/sdk", "version"], {
+                    quiet: true,
+                }).catch(() => ({ stdout: "unknown" })),
+                execCommand("npm", ["view", "convex", "version"], {
+                    quiet: true,
+                }).catch(() => ({ stdout: "unknown" })),
+                execCommand("npm", ["view", "@cortexmemory/vercel-ai-provider", "version"], {
+                    quiet: true,
+                }).catch(() => ({ stdout: "unknown" })),
+                execCommand("npm", ["view", "ai", "version"], {
+                    quiet: true,
+                }).catch(() => ({ stdout: "unknown" })),
+                execCommand("npm", ["view", "@cortexmemory/sdk", "peerDependencies", "--json"], { quiet: true }).catch(() => ({ stdout: "{}" })),
+            ]);
+            latestSdkVersion = sdkResult.stdout.trim() || "unknown";
+            latestConvexVersion = convexResult.stdout.trim() || "unknown";
+            latestProviderVersion = providerResult.stdout.trim() || "unknown";
+            latestAiVersion = aiResult.stdout.trim() || "unknown";
             try {
-                const result = await execCommand("npm", ["list", "convex", "--json"], { quiet: true, cwd: projectPath });
-                const data = JSON.parse(result.stdout);
-                currentConvexVersion =
-                    data.dependencies?.convex?.version ?? "not installed";
+                const peerDeps = JSON.parse(peerDepResult.stdout);
+                sdkConvexPeerDep = peerDeps?.convex ?? "unknown";
             }
             catch {
-                // Ignore errors
+                // Ignore parse errors
+            }
+        }
+        catch {
+            // Ignore errors
+        }
+        const deploymentInfos = [];
+        const appInfos = [];
+        // Check deployments
+        if (updateDeployments && hasDeployments) {
+            for (const { name, deployment, projectPath } of enabledDeployments) {
+                let currentSdkVersion = "not installed";
+                let currentConvexVersion = "not installed";
+                try {
+                    const result = await execCommand("npm", ["list", "@cortexmemory/sdk", "--json"], { quiet: true, cwd: projectPath });
+                    const data = JSON.parse(result.stdout);
+                    currentSdkVersion =
+                        data.dependencies?.["@cortexmemory/sdk"]?.version ??
+                            "not installed";
+                }
+                catch {
+                    // Ignore errors
+                }
+                try {
+                    const result = await execCommand("npm", ["list", "convex", "--json"], {
+                        quiet: true,
+                        cwd: projectPath,
+                    });
+                    const data = JSON.parse(result.stdout);
+                    currentConvexVersion =
+                        data.dependencies?.convex?.version ?? "not installed";
+                }
+                catch {
+                    // Ignore errors
+                }
+                const targetSdkVersion = options.sdkVersion ?? latestSdkVersion;
+                const needsUpdate = currentSdkVersion !== targetSdkVersion ||
+                    currentSdkVersion === "not installed";
+                deploymentInfos.push({
+                    name,
+                    deployment,
+                    projectPath,
+                    currentSdkVersion,
+                    currentConvexVersion,
+                    needsUpdate,
+                });
+            }
+        }
+        // Check apps
+        if (updateApps && hasApps) {
+            for (const { name, app } of enabledApps) {
+                const appPath = path.join(app.projectPath, app.path);
+                let currentSdkVersion = "not installed";
+                let currentProviderVersion = "not installed";
+                let currentConvexVersion = "not installed";
+                let currentAiVersion = "not installed";
+                let isDevLinked = false;
+                // Check package.json for file: references (dev linked)
+                try {
+                    const packageJsonPath = path.join(appPath, "package.json");
+                    if (await fs.pathExists(packageJsonPath)) {
+                        const pkg = await fs.readJson(packageJsonPath);
+                        const sdkDep = pkg.dependencies?.["@cortexmemory/sdk"];
+                        const providerDep = pkg.dependencies?.["@cortexmemory/vercel-ai-provider"];
+                        isDevLinked = sdkDep?.startsWith("file:") || providerDep?.startsWith("file:");
+                    }
+                }
+                catch {
+                    // Ignore errors
+                }
+                // Get installed versions
+                try {
+                    const result = await execCommand("npm", ["list", "@cortexmemory/sdk", "@cortexmemory/vercel-ai-provider", "convex", "ai", "--json"], { quiet: true, cwd: appPath });
+                    const data = JSON.parse(result.stdout);
+                    currentSdkVersion =
+                        data.dependencies?.["@cortexmemory/sdk"]?.version ?? "not installed";
+                    currentProviderVersion =
+                        data.dependencies?.["@cortexmemory/vercel-ai-provider"]?.version ?? "not installed";
+                    currentConvexVersion =
+                        data.dependencies?.convex?.version ?? "not installed";
+                    currentAiVersion =
+                        data.dependencies?.ai?.version ?? "not installed";
+                }
+                catch {
+                    // Ignore errors
+                }
+                const targetSdkVersion = isDevMode ? "dev" : (options.sdkVersion ?? latestSdkVersion);
+                const needsUpdate = isDevMode
+                    ? !isDevLinked // Dev mode: needs update if not already dev-linked
+                    : (currentSdkVersion !== targetSdkVersion || currentSdkVersion === "not installed");
+                // Check template sync status if --sync-template is enabled
+                let templateFilesToUpdate = 0;
+                let templateFilesToAdd = 0;
+                let needsTemplateSync = false;
+                if (options.syncTemplate) {
+                    try {
+                        const templateStatus = await checkTemplateSync(app);
+                        templateFilesToUpdate = templateStatus.filesOutdated.length;
+                        templateFilesToAdd = templateStatus.filesMissing.length;
+                        needsTemplateSync = templateStatus.needsSync;
+                    }
+                    catch {
+                        // Ignore errors
+                    }
+                }
+                appInfos.push({
+                    name,
+                    app,
+                    appPath,
+                    currentSdkVersion,
+                    currentProviderVersion,
+                    currentConvexVersion,
+                    currentAiVersion,
+                    needsUpdate,
+                    isDevLinked,
+                    templateFilesToUpdate,
+                    templateFilesToAdd,
+                    needsTemplateSync,
+                });
+            }
+        }
+        spinner.stop();
+        // Display status dashboard
+        if (isDevMode) {
+            console.log(pc.magenta("  ═══ DEV MODE ═══"));
+            console.log(pc.dim(`  SDK path: ${devPath}`));
+            console.log();
+        }
+        console.log(pc.bold("  Latest versions:"));
+        console.log(`    @cortexmemory/sdk: ${pc.cyan(latestSdkVersion)}`);
+        console.log(`    @cortexmemory/vercel-ai-provider: ${pc.cyan(latestProviderVersion)}`);
+        console.log(`    convex: ${pc.cyan(latestConvexVersion)}`);
+        console.log(`    ai: ${pc.cyan(latestAiVersion)}`);
+        if (sdkConvexPeerDep !== "unknown") {
+            console.log(`    SDK requires convex: ${pc.dim(sdkConvexPeerDep)}`);
+        }
+        console.log();
+        // Show deployment status
+        if (deploymentInfos.length > 0) {
+            printSection("Deployments", {});
+            console.log();
+            for (const info of deploymentInfos) {
+                const isDefault = info.name === currentConfig.default;
+                const defaultBadge = isDefault ? pc.cyan(" (default)") : "";
+                const statusIcon = info.needsUpdate
+                    ? pc.yellow("●")
+                    : pc.green("●");
+                console.log(`  ${statusIcon} ${pc.bold(info.name)}${defaultBadge}`);
+                console.log(pc.dim(`      Path: ${info.projectPath}`));
+                console.log(`      SDK: ${info.currentSdkVersion === latestSdkVersion ? pc.green(info.currentSdkVersion) : pc.yellow(info.currentSdkVersion)}`);
+                console.log(`      Convex: ${info.currentConvexVersion === latestConvexVersion ? pc.green(info.currentConvexVersion) : pc.yellow(info.currentConvexVersion)}`);
+                console.log();
             }
-            // Get latest Convex version from npm
-            let latestConvexVersion = "unknown";
+        }
+        // Show app status
+        if (appInfos.length > 0) {
+            printSection("Apps", {});
+            console.log();
+            for (const info of appInfos) {
+                const devBadge = info.isDevLinked ? pc.magenta(" [DEV]") : "";
+                const needsAnyUpdate = info.needsUpdate || info.needsTemplateSync;
+                const statusIcon = needsAnyUpdate
+                    ? pc.yellow("●")
+                    : pc.green("●");
+                console.log(`  ${statusIcon} ${pc.bold(info.name)}${devBadge}`);
+                console.log(pc.dim(`      Path: ${info.appPath}`));
+                console.log(`      SDK: ${info.isDevLinked ? pc.magenta("file:...") : (info.currentSdkVersion === latestSdkVersion ? pc.green(info.currentSdkVersion) : pc.yellow(info.currentSdkVersion))}`);
+                console.log(`      Provider: ${info.isDevLinked ? pc.magenta("file:...") : (info.currentProviderVersion === latestProviderVersion ? pc.green(info.currentProviderVersion) : pc.yellow(info.currentProviderVersion))}`);
+                console.log(`      AI: ${info.currentAiVersion === latestAiVersion ? pc.green(info.currentAiVersion) : pc.yellow(info.currentAiVersion)}`);
+                console.log(`      Convex: ${info.currentConvexVersion === latestConvexVersion ? pc.green(info.currentConvexVersion) : pc.yellow(info.currentConvexVersion)}`);
+                // Show template sync status if --sync-template is enabled
+                if (options.syncTemplate) {
+                    const totalTemplateChanges = info.templateFilesToUpdate + info.templateFilesToAdd;
+                    if (totalTemplateChanges > 0) {
+                        console.log(`      Template: ${pc.yellow(`${totalTemplateChanges} file(s) to sync`)}`);
+                    }
+                    else {
+                        console.log(`      Template: ${pc.green("up to date")}`);
+                    }
+                }
+                console.log();
+            }
+        }
+        // Count updates needed
+        const deploymentsNeedingUpdate = deploymentInfos.filter((d) => d.needsUpdate);
+        const appsNeedingUpdate = appInfos.filter((a) => a.needsUpdate || (options.syncTemplate && a.needsTemplateSync));
+        const totalNeedingUpdate = deploymentsNeedingUpdate.length + appsNeedingUpdate.length;
+        // Check if any updates needed
+        if (totalNeedingUpdate === 0) {
+            printSuccess("Everything is up to date!");
+            return;
+        }
+        // Prompt for confirmation
+        const updateParts = [];
+        if (deploymentsNeedingUpdate.length > 0) {
+            updateParts.push(`${deploymentsNeedingUpdate.length} deployment(s)`);
+        }
+        if (appsNeedingUpdate.length > 0) {
+            updateParts.push(`${appsNeedingUpdate.length} app(s)`);
+        }
+        console.log(pc.cyan(`  ${updateParts.join(" and ")} need updates`));
+        console.log();
+        let shouldProceed = options.yes;
+        if (!shouldProceed) {
+            const { default: prompts } = await import("prompts");
+            const response = await prompts({
+                type: "confirm",
+                name: "proceed",
+                message: `Update all ${totalNeedingUpdate} target(s)?`,
+                initial: true,
+            });
+            shouldProceed = response.proceed;
+        }
+        if (!shouldProceed) {
+            console.log(pc.yellow("\n   Operation cancelled\n"));
+            console.log(pc.dim("   Tip: Use '-d <name>' for deployments or '-a <name>' for apps\n"));
+            return;
+        }
+        // Perform updates
+        console.log();
+        let deploymentSuccessCount = 0;
+        let deploymentFailCount = 0;
+        let appSuccessCount = 0;
+        let appFailCount = 0;
+        // Update deployments
+        for (const info of deploymentsNeedingUpdate) {
+            console.log(pc.bold(`\n━━━ Updating deployment: ${info.name} ━━━\n`));
             try {
-                const result = await execCommand("npm", ["view", "convex", "version"], { quiet: true });
-                latestConvexVersion = result.stdout.trim();
+                await updateDeployment(info.name, info.deployment, {
+                    ...options,
+                    yes: true,
+                });
+                deploymentSuccessCount++;
             }
-            catch {
-                // Ignore errors
+            catch (error) {
+                printError(`Failed to update ${info.name}: ${error instanceof Error ? error.message : "Unknown error"}`);
+                deploymentFailCount++;
             }
-            // Get Cortex SDK's peer dependency on Convex
-            let sdkConvexPeerDep = "unknown";
+        }
+        // Update apps
+        for (const info of appsNeedingUpdate) {
+            console.log(pc.bold(`\n━━━ Updating app: ${info.name} ━━━\n`));
             try {
-                const result = await execCommand("npm", ["view", "@cortexmemory/sdk", "peerDependencies", "--json"], { quiet: true });
-                const peerDeps = JSON.parse(result.stdout);
-                sdkConvexPeerDep = peerDeps?.convex ?? "unknown";
+                await updateApp(info.name, info.app, {
+                    ...options,
+                    devPath: isDevMode ? devPath : undefined,
+                    syncTemplate: options.syncTemplate,
+                    yes: true,
+                });
+                appSuccessCount++;
             }
-            catch {
-                // Ignore errors
+            catch (error) {
+                printError(`Failed to update ${info.name}: ${error instanceof Error ? error.message : "Unknown error"}`);
+                appFailCount++;
             }
-            spinner.stop();
-            // Display current status
-            console.log();
-            printSection("Package Status", {
-                "Project Path": projectPath,
+        }
+        // Summary
+        console.log();
+        console.log(pc.bold("━━━ Summary ━━━"));
+        console.log();
+        if (deploymentSuccessCount > 0) {
+            printSuccess(`${deploymentSuccessCount} deployment(s) updated successfully`);
+        }
+        if (deploymentFailCount > 0) {
+            printWarning(`${deploymentFailCount} deployment(s) failed to update`);
+        }
+        if (appSuccessCount > 0) {
+            printSuccess(`${appSuccessCount} app(s) updated successfully`);
+        }
+        if (appFailCount > 0) {
+            printWarning(`${appFailCount} app(s) failed to update`);
+        }
+    });
+}
+/**
+ * Update packages for a single deployment
+ */
+async function updateDeployment(name, deployment, options) {
+    const projectPath = deployment.projectPath || process.cwd();
+    const spinner = ora("Checking for updates...").start();
+    try {
+        // Get current Cortex SDK version
+        let currentSdkVersion = "not installed";
+        try {
+            const result = await execCommand("npm", ["list", "@cortexmemory/sdk", "--json"], { quiet: true, cwd: projectPath });
+            const data = JSON.parse(result.stdout);
+            currentSdkVersion =
+                data.dependencies?.["@cortexmemory/sdk"]?.version ?? "not installed";
+        }
+        catch {
+            // Ignore errors
+        }
+        // Get latest Cortex SDK version from npm
+        let latestSdkVersion = "unknown";
+        try {
+            const result = await execCommand("npm", ["view", "@cortexmemory/sdk", "version"], { quiet: true });
+            latestSdkVersion = result.stdout.trim();
+        }
+        catch {
+            // Ignore errors
+        }
+        // Get current Convex version
+        let currentConvexVersion = "not installed";
+        try {
+            const result = await execCommand("npm", ["list", "convex", "--json"], {
+                quiet: true,
+                cwd: projectPath,
+            });
+            const data = JSON.parse(result.stdout);
+            currentConvexVersion =
+                data.dependencies?.convex?.version ?? "not installed";
+        }
+        catch {
+            // Ignore errors
+        }
+        // Get latest Convex version from npm
+        let latestConvexVersion = "unknown";
+        try {
+            const result = await execCommand("npm", ["view", "convex", "version"], {
+                quiet: true,
             });
+            latestConvexVersion = result.stdout.trim();
+        }
+        catch {
+            // Ignore errors
+        }
+        // Get Cortex SDK's peer dependency on Convex
+        let sdkConvexPeerDep = "unknown";
+        try {
+            const result = await execCommand("npm", ["view", "@cortexmemory/sdk", "peerDependencies", "--json"], { quiet: true });
+            const peerDeps = JSON.parse(result.stdout);
+            sdkConvexPeerDep = peerDeps?.convex ?? "unknown";
+        }
+        catch {
+            // Ignore errors
+        }
+        spinner.stop();
+        // Display current status
+        console.log();
+        printSection("Package Status", {
+            Deployment: name,
+            "Project Path": projectPath,
+        });
+        console.log();
+        console.log(pc.bold("  @cortexmemory/sdk"));
+        console.log(`    Current: ${currentSdkVersion === latestSdkVersion ? pc.green(currentSdkVersion) : pc.yellow(currentSdkVersion)}`);
+        console.log(`    Latest:  ${latestSdkVersion}`);
+        console.log();
+        console.log(pc.bold("  convex"));
+        console.log(`    Current: ${currentConvexVersion === latestConvexVersion ? pc.green(currentConvexVersion) : pc.yellow(currentConvexVersion)}`);
+        console.log(`    Latest:  ${latestConvexVersion}`);
+        if (sdkConvexPeerDep !== "unknown") {
+            console.log(`    SDK requires: ${pc.dim(sdkConvexPeerDep)}`);
+        }
+        console.log();
+        // Determine what needs updating
+        const targetSdkVersion = options.sdkVersion ?? latestSdkVersion;
+        const sdkNeedsUpdate = currentSdkVersion !== targetSdkVersion &&
+            currentSdkVersion !== "not installed";
+        const sdkNeedsInstall = currentSdkVersion === "not installed";
+        // Check if Convex has a patch update available beyond what SDK requires
+        const parseVersion = (v) => {
+            const match = v.match(/^(\d+)\.(\d+)\.(\d+)/);
+            if (!match)
+                return null;
+            return {
+                major: parseInt(match[1]),
+                minor: parseInt(match[2]),
+                patch: parseInt(match[3]),
+            };
+        };
+        const currentConvex = parseVersion(currentConvexVersion);
+        const latestConvex = parseVersion(latestConvexVersion);
+        let convexPatchAvailable = false;
+        if (currentConvex && latestConvex) {
+            // Patch update = same major.minor, higher patch
+            convexPatchAvailable =
+                currentConvex.major === latestConvex.major &&
+                    currentConvex.minor === latestConvex.minor &&
+                    currentConvex.patch < latestConvex.patch;
+        }
+        const targetConvexVersion = options.convexVersion ??
+            (convexPatchAvailable ? latestConvexVersion : null);
+        const convexNeedsUpdate = targetConvexVersion && currentConvexVersion !== targetConvexVersion;
+        // Nothing to update
+        if (!sdkNeedsUpdate &&
+            !sdkNeedsInstall &&
+            !convexNeedsUpdate &&
+            !convexPatchAvailable) {
+            printSuccess("All packages are up to date!");
+            return;
+        }
+        // Update Cortex SDK if needed
+        if (sdkNeedsUpdate || sdkNeedsInstall) {
             console.log();
-            console.log(pc.bold("  @cortexmemory/sdk"));
-            console.log(`    Current: ${currentSdkVersion === latestSdkVersion ? pc.green(currentSdkVersion) : pc.yellow(currentSdkVersion)}`);
-            console.log(`    Latest:  ${latestSdkVersion}`);
+            printInfo(`${sdkNeedsInstall ? "Installing" : "Updating"} @cortexmemory/sdk@${targetSdkVersion}...`);
             console.log();
-            console.log(pc.bold("  convex"));
-            console.log(`    Current: ${currentConvexVersion === latestConvexVersion ? pc.green(currentConvexVersion) : pc.yellow(currentConvexVersion)}`);
-            console.log(`    Latest:  ${latestConvexVersion}`);
-            if (sdkConvexPeerDep !== "unknown") {
-                console.log(`    SDK requires: ${pc.dim(sdkConvexPeerDep)}`);
+            const exitCode = await execCommandLive("npm", ["install", `@cortexmemory/sdk@${targetSdkVersion}`], { cwd: projectPath });
+            if (exitCode === 0) {
+                printSuccess(`${sdkNeedsInstall ? "Installed" : "Updated"} @cortexmemory/sdk to ${targetSdkVersion}`);
+            }
+            else {
+                printError("SDK update failed");
+                throw new Error("SDK update failed");
             }
+        }
+        else if (currentSdkVersion !== "not installed") {
+            printSuccess("@cortexmemory/sdk is already up to date");
+        }
+        // Check for Convex patch update
+        if (convexPatchAvailable && !options.convexVersion) {
             console.log();
-            // Determine what needs updating
-            const targetSdkVersion = options.sdkVersion ?? latestSdkVersion;
-            const sdkNeedsUpdate = currentSdkVersion !== targetSdkVersion &&
-                currentSdkVersion !== "not installed";
-            const sdkNeedsInstall = currentSdkVersion === "not installed";
-            // Check if Convex has a patch update available beyond what SDK requires
-            const parseVersion = (v) => {
-                const match = v.match(/^(\d+)\.(\d+)\.(\d+)/);
-                if (!match)
-                    return null;
-                return {
-                    major: parseInt(match[1]),
-                    minor: parseInt(match[2]),
-                    patch: parseInt(match[3]),
-                };
-            };
-            const currentConvex = parseVersion(currentConvexVersion);
-            const latestConvex = parseVersion(latestConvexVersion);
-            let convexPatchAvailable = false;
-            if (currentConvex && latestConvex) {
-                // Patch update = same major.minor, higher patch
-                convexPatchAvailable =
-                    currentConvex.major === latestConvex.major &&
-                        currentConvex.minor === latestConvex.minor &&
-                        currentConvex.patch < latestConvex.patch;
-            }
-            const targetConvexVersion = options.convexVersion ??
-                (convexPatchAvailable ? latestConvexVersion : null);
-            const convexNeedsUpdate = targetConvexVersion && currentConvexVersion !== targetConvexVersion;
-            // Nothing to update
-            if (!sdkNeedsUpdate &&
-                !sdkNeedsInstall &&
-                !convexNeedsUpdate &&
-                !convexPatchAvailable) {
-                printSuccess("All packages are up to date!");
-                return;
+            console.log(pc.cyan(`  Convex patch update available: ${currentConvexVersion} → ${latestConvexVersion}`));
+            let shouldUpdate = options.yes;
+            if (!shouldUpdate) {
+                const { default: prompts } = await import("prompts");
+                const response = await prompts({
+                    type: "confirm",
+                    name: "update",
+                    message: "Update Convex to latest patch version?",
+                    initial: true,
+                });
+                shouldUpdate = response.update;
             }
-            // Update Cortex SDK if needed
-            if (sdkNeedsUpdate || sdkNeedsInstall) {
+            if (shouldUpdate) {
                 console.log();
-                printInfo(`${sdkNeedsInstall ? "Installing" : "Updating"} @cortexmemory/sdk@${targetSdkVersion}...`);
+                printInfo(`Updating convex@${latestConvexVersion}...`);
                 console.log();
-                const exitCode = await execCommandLive("npm", ["install", `@cortexmemory/sdk@${targetSdkVersion}`], { cwd: projectPath });
+                const exitCode = await execCommandLive("npm", ["install", `convex@${latestConvexVersion}`], { cwd: projectPath });
                 if (exitCode === 0) {
-                    printSuccess(`${sdkNeedsInstall ? "Installed" : "Updated"} @cortexmemory/sdk to ${targetSdkVersion}`);
+                    printSuccess(`Updated convex to ${latestConvexVersion}`);
                 }
                 else {
-                    printError("SDK update failed");
-                    process.exit(1);
+                    printWarning("Convex update failed, but SDK update was successful");
                 }
             }
-            else if (currentSdkVersion !== "not installed") {
-                printSuccess("@cortexmemory/sdk is already up to date");
+            else {
+                console.log(pc.dim("  Skipping Convex update"));
+            }
+        }
+        else if (options.convexVersion) {
+            // Explicit version requested
+            console.log();
+            printInfo(`Updating convex@${options.convexVersion}...`);
+            console.log();
+            const exitCode = await execCommandLive("npm", ["install", `convex@${options.convexVersion}`], { cwd: projectPath });
+            if (exitCode === 0) {
+                printSuccess(`Updated convex to ${options.convexVersion}`);
+            }
+            else {
+                printWarning("Convex update failed");
+            }
+        }
+        console.log();
+        printSuccess("Update complete!");
+    }
+    catch (error) {
+        spinner.stop();
+        throw error;
+    }
+}
+/**
+ * Update packages for a single app
+ */
+async function updateApp(name, app, options) {
+    const appPath = path.join(app.projectPath, app.path);
+    const isDevMode = !!options.devPath;
+    if (!await fs.pathExists(appPath)) {
+        printError(`App path not found: ${appPath}`);
+        throw new Error(`App path not found: ${appPath}`);
+    }
+    const spinner = ora("Checking for updates...").start();
+    try {
+        // Read package.json
+        const packageJsonPath = path.join(appPath, "package.json");
+        if (!await fs.pathExists(packageJsonPath)) {
+            spinner.stop();
+            printError(`No package.json found at ${appPath}`);
+            throw new Error(`No package.json found at ${appPath}`);
+        }
+        const pkg = await fs.readJson(packageJsonPath);
+        // Check current versions
+        let currentSdkVersion = "not installed";
+        let currentProviderVersion = "not installed";
+        let currentConvexVersion = "not installed";
+        let currentAiVersion = "not installed";
+        let isDevLinked = false;
+        // Check if already dev-linked
+        const sdkDep = pkg.dependencies?.["@cortexmemory/sdk"];
+        const providerDep = pkg.dependencies?.["@cortexmemory/vercel-ai-provider"];
+        isDevLinked = sdkDep?.startsWith("file:") || providerDep?.startsWith("file:");
+        // Get installed versions
+        try {
+            const result = await execCommand("npm", ["list", "@cortexmemory/sdk", "@cortexmemory/vercel-ai-provider", "convex", "ai", "--json"], { quiet: true, cwd: appPath });
+            const data = JSON.parse(result.stdout);
+            currentSdkVersion =
+                data.dependencies?.["@cortexmemory/sdk"]?.version ?? "not installed";
+            currentProviderVersion =
+                data.dependencies?.["@cortexmemory/vercel-ai-provider"]?.version ?? "not installed";
+            currentConvexVersion =
+                data.dependencies?.convex?.version ?? "not installed";
+            currentAiVersion =
+                data.dependencies?.ai?.version ?? "not installed";
+        }
+        catch {
+            // Ignore errors
+        }
+        // Get latest versions from npm
+        let latestSdkVersion = "unknown";
+        let latestProviderVersion = "unknown";
+        let latestConvexVersion = "unknown";
+        let latestAiVersion = "unknown";
+        try {
+            const [sdkResult, providerResult, convexResult, aiResult] = await Promise.all([
+                execCommand("npm", ["view", "@cortexmemory/sdk", "version"], { quiet: true }).catch(() => ({ stdout: "unknown" })),
+                execCommand("npm", ["view", "@cortexmemory/vercel-ai-provider", "version"], { quiet: true }).catch(() => ({ stdout: "unknown" })),
+                execCommand("npm", ["view", "convex", "version"], { quiet: true }).catch(() => ({ stdout: "unknown" })),
+                execCommand("npm", ["view", "ai", "version"], { quiet: true }).catch(() => ({ stdout: "unknown" })),
+            ]);
+            latestSdkVersion = sdkResult.stdout.trim() || "unknown";
+            latestProviderVersion = providerResult.stdout.trim() || "unknown";
+            latestConvexVersion = convexResult.stdout.trim() || "unknown";
+            latestAiVersion = aiResult.stdout.trim() || "unknown";
+        }
+        catch {
+            // Ignore errors
+        }
+        spinner.stop();
+        // Display current status
+        console.log();
+        printSection("App Package Status", {
+            App: name,
+            Type: app.type,
+            Path: appPath,
+        });
+        if (isDevMode) {
+            console.log();
+            console.log(pc.magenta("  ═══ DEV MODE ═══"));
+            console.log(pc.dim(`  Will link to: ${options.devPath}`));
+        }
+        console.log();
+        console.log(pc.bold("  @cortexmemory/sdk"));
+        if (isDevLinked) {
+            console.log(`    Current: ${pc.magenta("file:... (dev linked)")}`);
+        }
+        else {
+            console.log(`    Current: ${currentSdkVersion === latestSdkVersion ? pc.green(currentSdkVersion) : pc.yellow(currentSdkVersion)}`);
+        }
+        console.log(`    Latest:  ${latestSdkVersion}`);
+        console.log();
+        console.log(pc.bold("  @cortexmemory/vercel-ai-provider"));
+        if (isDevLinked) {
+            console.log(`    Current: ${pc.magenta("file:... (dev linked)")}`);
+        }
+        else {
+            console.log(`    Current: ${currentProviderVersion === latestProviderVersion ? pc.green(currentProviderVersion) : pc.yellow(currentProviderVersion)}`);
+        }
+        console.log(`    Latest:  ${latestProviderVersion}`);
+        console.log();
+        console.log(pc.bold("  convex"));
+        console.log(`    Current: ${currentConvexVersion === latestConvexVersion ? pc.green(currentConvexVersion) : pc.yellow(currentConvexVersion)}`);
+        console.log(`    Latest:  ${latestConvexVersion}`);
+        console.log();
+        console.log(pc.bold("  ai (Vercel AI SDK)"));
+        console.log(`    Current: ${currentAiVersion === latestAiVersion ? pc.green(currentAiVersion) : pc.yellow(currentAiVersion)}`);
+        console.log(`    Latest:  ${latestAiVersion}`);
+        console.log();
+        // Determine update strategy
+        if (isDevMode) {
+            // Dev mode: update package.json with file: references
+            if (isDevLinked) {
+                printSuccess("App is already dev-linked. Running npm install to refresh...");
+            }
+            else {
+                printInfo("Switching to dev mode with local SDK...");
             }
-            // Check for Convex patch update
-            if (convexPatchAvailable && !options.convexVersion) {
+            // Update package.json with file: references
+            const devSdkPath = options.devPath;
+            const devProviderPath = path.join(devSdkPath, "packages", "vercel-ai-provider");
+            pkg.dependencies = pkg.dependencies || {};
+            pkg.dependencies["@cortexmemory/sdk"] = `file:${devSdkPath}`;
+            pkg.dependencies["@cortexmemory/vercel-ai-provider"] = `file:${devProviderPath}`;
+            await fs.writeJson(packageJsonPath, pkg, { spaces: 2 });
+            console.log(pc.cyan("   Updated package.json with file: references"));
+            // Run npm install
+            console.log();
+            printInfo("Running npm install...");
+            console.log();
+            const exitCode = await execCommandLive("npm", ["install", "--legacy-peer-deps"], { cwd: appPath });
+            if (exitCode === 0) {
                 console.log();
-                console.log(pc.cyan(`  Convex patch update available: ${currentConvexVersion} → ${latestConvexVersion}`));
-                let shouldUpdate = options.yes;
-                if (!shouldUpdate) {
-                    const { default: prompts } = await import("prompts");
-                    const response = await prompts({
-                        type: "confirm",
-                        name: "update",
-                        message: "Update Convex to latest patch version?",
-                        initial: true,
-                    });
-                    shouldUpdate = response.update;
-                }
-                if (shouldUpdate) {
-                    console.log();
-                    printInfo(`Updating convex@${latestConvexVersion}...`);
-                    console.log();
-                    const exitCode = await execCommandLive("npm", ["install", `convex@${latestConvexVersion}`], { cwd: projectPath });
-                    if (exitCode === 0) {
-                        printSuccess(`Updated convex to ${latestConvexVersion}`);
-                    }
-                    else {
-                        printWarning("Convex update failed, but SDK update was successful");
-                    }
-                }
-                else {
-                    console.log(pc.dim("  Skipping Convex update"));
-                }
+                printSuccess("Dev mode linking complete!");
+                console.log(pc.dim(`   SDK linked to: ${devSdkPath}`));
+                console.log(pc.dim(`   Provider linked to: ${devProviderPath}`));
+            }
+            else {
+                printError("npm install failed");
+                throw new Error("npm install failed");
             }
-            else if (options.convexVersion) {
-                // Explicit version requested
+        }
+        else {
+            // Normal mode: update to latest versions from npm
+            const targetSdkVersion = options.sdkVersion ?? latestSdkVersion;
+            const targetProviderVersion = options.providerVersion ?? latestProviderVersion;
+            // Check if we need to remove dev links first
+            if (isDevLinked) {
+                printInfo("Removing dev links and switching to npm packages...");
+                pkg.dependencies["@cortexmemory/sdk"] = `^${targetSdkVersion}`;
+                pkg.dependencies["@cortexmemory/vercel-ai-provider"] = `^${targetProviderVersion}`;
+                await fs.writeJson(packageJsonPath, pkg, { spaces: 2 });
+                console.log(pc.cyan("   Updated package.json with npm versions"));
+            }
+            // Determine what needs updating
+            const sdkNeedsUpdate = currentSdkVersion !== targetSdkVersion || isDevLinked;
+            const providerNeedsUpdate = currentProviderVersion !== targetProviderVersion || isDevLinked;
+            // Nothing to update
+            if (!sdkNeedsUpdate && !providerNeedsUpdate) {
+                printSuccess("All packages are up to date!");
+                return;
+            }
+            // Build install command
+            const packagesToInstall = [];
+            if (sdkNeedsUpdate) {
+                packagesToInstall.push(`@cortexmemory/sdk@${targetSdkVersion}`);
+            }
+            if (providerNeedsUpdate) {
+                packagesToInstall.push(`@cortexmemory/vercel-ai-provider@${targetProviderVersion}`);
+            }
+            if (packagesToInstall.length > 0) {
                 console.log();
-                printInfo(`Updating convex@${options.convexVersion}...`);
+                printInfo(`Installing: ${packagesToInstall.join(", ")}...`);
                 console.log();
-                const exitCode = await execCommandLive("npm", ["install", `convex@${options.convexVersion}`], { cwd: projectPath });
+                const exitCode = await execCommandLive("npm", ["install", ...packagesToInstall, "--legacy-peer-deps"], { cwd: appPath });
                 if (exitCode === 0) {
-                    printSuccess(`Updated convex to ${options.convexVersion}`);
+                    printSuccess("Packages updated successfully");
                 }
                 else {
-                    printWarning("Convex update failed");
+                    printError("Package update failed");
+                    throw new Error("Package update failed");
                 }
             }
             console.log();
-            printSuccess("Update complete!");
+            printSuccess("Package update complete!");
         }
-        catch (error) {
-            spinner.stop();
-            printError(error instanceof Error ? error.message : "Update failed");
-            process.exit(1);
+        // Template sync (if enabled)
+        if (options.syncTemplate) {
+            console.log();
+            printSection("Template Sync", {});
+            console.log();
+            try {
+                const templateResult = await syncAppTemplate(app, { dryRun: false });
+                if (templateResult.error) {
+                    printWarning(`Template sync skipped: ${templateResult.error}`);
+                }
+                else if (templateResult.synced) {
+                    printTemplateSyncResult(templateResult);
+                    // Run npm install if package.json was updated with new dependencies
+                    if (templateResult.packageJsonUpdated) {
+                        const totalNewDeps = templateResult.depsAdded.length + templateResult.devDepsAdded.length;
+                        if (totalNewDeps > 0) {
+                            console.log();
+                            printInfo(`Installing ${totalNewDeps} new dependencies...`);
+                            console.log(pc.dim(`   Running in: ${templateResult.appPath}`));
+                            console.log();
+                            const exitCode = await execCommandLive("npm", ["install", "--legacy-peer-deps"], { cwd: templateResult.appPath });
+                            if (exitCode === 0) {
+                                printSuccess("Dependencies installed");
+                            }
+                            else {
+                                printWarning("npm install failed - you may need to run it manually");
+                            }
+                        }
+                    }
+                }
+                else {
+                    console.log(pc.dim("   Template files are up to date"));
+                }
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                printWarning(`Template sync failed: ${message}`);
+            }
         }
-    });
+        console.log();
+        printSuccess("Update complete!");
+    }
+    catch (error) {
+        spinner.stop();
+        throw error;
+    }
 }
 //# sourceMappingURL=deploy.js.map