convex 1.34.0 → 1.34.1

package/dist/cjs/cli/configure.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/cli/configure.ts"],
-  "sourcesContent": ["import { chalkStderr } from \"chalk\";\nimport { Context } from \"../bundler/context.js\";\nimport {\n  logFailure,\n  logFinishedStep,\n  logMessage,\n  logWarning,\n  showSpinner,\n} from \"../bundler/log.js\";\nimport {\n  DeploymentType,\n  DeploymentName,\n  fetchDeploymentCredentialsProvisioningDevOrProdMaybeThrows,\n  createProject,\n  loadSelectedDeploymentCredentials,\n  checkAccessToSelectedProject,\n  DeploymentSelectionWithinProject,\n} from \"./lib/api.js\";\nimport { readProjectConfig, writeProjectConfig } from \"./lib/config.js\";\nimport {\n  DeploymentDetails,\n  eraseDeploymentEnvVar,\n  writeDeploymentEnvVar,\n} from \"./lib/deployment.js\";\nimport { finalizeConfiguration } from \"./lib/init.js\";\nimport {\n  CONVEX_DEPLOYMENT_ENV_VAR_NAME,\n  functionsDir,\n  hasProjects,\n  logAndHandleFetchError,\n  selectDevDeploymentType,\n  selectRegionOrUseDefault,\n  validateOrSelectProject,\n  validateOrSelectTeam,\n} from \"./lib/utils/utils.js\";\nimport { writeUrlsToEnvFile } from \"./lib/envvars.js\";\nimport path from \"path\";\nimport { projectDashboardUrl } from \"./lib/dashboard.js\";\nimport { doInitConvexFolder } from \"./lib/codegen.js\";\nimport { handleLocalDeployment } from \"./lib/localDeployment/localDeployment.js\";\nimport {\n  promptOptions,\n  promptString,\n  promptYesNo,\n} from \"./lib/utils/prompts.js\";\nimport { readGlobalConfig } from \"./lib/utils/globalConfig.js\";\nimport { maybeSetupAiFiles } from \"./lib/ai/index.js\";\nimport {\n  DeploymentSelection,\n  deploymentNameFromSelection,\n  shouldAllowAnonymousDevelopment,\n} from \"./lib/deploymentSelection.js\";\nimport { ensureLoggedIn } from \"./lib/login.js\";\nimport { handleAnonymousDeployment } from \"./lib/localDeployment/anonymous.js\";\nimport { fetchDeploymentCanonicalSiteUrl } from \"./lib/env.js\";\ntype DeploymentCredentials = {\n  url: string;\n  adminKey: string;\n};\n\ntype ChosenConfiguration =\n  // `--configure new`\n  | \"new\"\n  // `--configure existing`\n  | \"existing\"\n  // `--configure`\n  | \"ask\"\n  // `--configure` was not specified\n  | null;\n\ntype ConfigureCmdOptions = {\n  prod: boolean;\n  localOptions: {\n    ports?: {\n      cloud: number;\n      site: number;\n    };\n    backendVersion?: string | undefined;\n    dashboardVersion?: string | undefined;\n    forceUpgrade: boolean;\n  };\n  team?: string | undefined;\n  project?: string | undefined;\n  devDeployment?: \"cloud\" | \"local\" | undefined;\n  local?: boolean | undefined;\n  cloud?: boolean | undefined;\n  url?: string | undefined;\n  adminKey?: string | undefined;\n  envFile?: string | undefined;\n  overrideAuthUrl?: string | undefined;\n  overrideAuthClient?: string | undefined;\n  overrideAuthUsername?: string | undefined;\n  overrideAuthPassword?: string | undefined;\n};\n\n/**\n * As of writing, this is used by:\n * - `npx convex dev`\n * - `npx convex codegen`\n *\n * But is not used by `npx convex deploy` or other commands.\n */\nexport async function deploymentCredentialsOrConfigure(\n  ctx: Context,\n  deploymentSelection: DeploymentSelection,\n  chosenConfiguration: ChosenConfiguration,\n  cmdOptions: ConfigureCmdOptions,\n): Promise<\n  DeploymentCredentials & {\n    deploymentFields: {\n      deploymentName: DeploymentName;\n      deploymentType: DeploymentType;\n      projectSlug: string | null;\n      teamSlug: string | null;\n      siteUrl: string | null;\n    } | null;\n  }\n> {\n  const selectedDeployment = await _deploymentCredentialsOrConfigure(\n    ctx,\n    deploymentSelection,\n    chosenConfiguration,\n    cmdOptions,\n  );\n  const siteUrl = await fetchDeploymentCanonicalSiteUrl(ctx, {\n    adminKey: selectedDeployment.adminKey,\n    deploymentUrl: selectedDeployment.url,\n  });\n\n  if (selectedDeployment.deploymentFields !== null) {\n    // Set the `CONVEX_DEPLOYMENT` env var + the `CONVEX_URL` env var\n    await updateEnvAndConfigForDeploymentSelection(\n      ctx,\n      {\n        url: selectedDeployment.url,\n        siteUrl,\n        deploymentName: selectedDeployment.deploymentFields.deploymentName,\n        teamSlug: selectedDeployment.deploymentFields.teamSlug,\n        projectSlug: selectedDeployment.deploymentFields.projectSlug,\n        deploymentType: selectedDeployment.deploymentFields.deploymentType,\n      },\n      deploymentNameFromSelection(deploymentSelection),\n    );\n  } else {\n    // Clear the `CONVEX_DEPLOYMENT` env var + set the `CONVEX_URL` and\n    // `CONVEX_SITE_URL` env vars.\n    await handleManuallySetUrlAndAdminKey(ctx, {\n      url: selectedDeployment.url,\n      siteUrl,\n      adminKey: selectedDeployment.adminKey,\n    });\n  }\n  return {\n    url: selectedDeployment.url,\n    adminKey: selectedDeployment.adminKey,\n    deploymentFields:\n      selectedDeployment.deploymentFields === null\n        ? null\n        : { ...selectedDeployment.deploymentFields, siteUrl: siteUrl },\n  };\n}\n\nexport async function _deploymentCredentialsOrConfigure(\n  ctx: Context,\n  deploymentSelection: DeploymentSelection,\n  chosenConfiguration: ChosenConfiguration,\n  cmdOptions: ConfigureCmdOptions,\n): Promise<\n  DeploymentCredentials & {\n    deploymentFields: {\n      deploymentName: DeploymentName;\n      deploymentType: DeploymentType;\n      projectSlug: string | null;\n      teamSlug: string | null;\n    } | null;\n  }\n> {\n  const config = readGlobalConfig(ctx);\n  const globallyForceCloud = !!config?.optOutOfLocalDevDeploymentsUntilBetaOver;\n  if (globallyForceCloud && cmdOptions.local) {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage:\n        \"Can't specify --local when local deployments are disabled on this machine. Run `npx convex disable-local-deployments --undo-global` to allow use of --local.\",\n    });\n  }\n\n  switch (deploymentSelection.kind) {\n    case \"existingDeployment\":\n      return {\n        url: deploymentSelection.deploymentToActOn.url,\n        adminKey: deploymentSelection.deploymentToActOn.adminKey,\n        deploymentFields:\n          deploymentSelection.deploymentToActOn.deploymentFields,\n      };\n    case \"chooseProject\": {\n      await ensureLoggedIn(ctx, {\n        overrideAuthUrl: cmdOptions.overrideAuthUrl,\n        overrideAuthClient: cmdOptions.overrideAuthClient,\n        overrideAuthUsername: cmdOptions.overrideAuthUsername,\n        overrideAuthPassword: cmdOptions.overrideAuthPassword,\n      });\n      return await handleChooseProject(\n        ctx,\n        chosenConfiguration,\n        deploymentSelection.selectionWithinProject,\n        {\n          globallyForceCloud,\n        },\n        cmdOptions,\n      );\n    }\n    case \"preview\":\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage: \"Use `npx convex deploy` to use preview deployments.\",\n      });\n    case \"deploymentWithinProject\": {\n      return await handleDeploymentWithinProject(ctx, {\n        chosenConfiguration,\n        deploymentSelection,\n        cmdOptions,\n        globallyForceCloud,\n      });\n    }\n    case \"anonymous\": {\n      const hasAuth = ctx.bigBrainAuth() !== null;\n      const isAgentMode = process.env.CONVEX_AGENT_MODE === \"anonymous\";\n      if (\n        !isAgentMode &&\n        hasAuth &&\n        deploymentSelection.deploymentName !== null\n      ) {\n        const shouldConfigure =\n          chosenConfiguration !== null ||\n          (await promptYesNo(ctx, {\n            message: `${CONVEX_DEPLOYMENT_ENV_VAR_NAME} is configured with deployment ${deploymentSelection.deploymentName}, which is not linked with your account. Would you like to link it now?`,\n          }));\n        if (!shouldConfigure) {\n          return await ctx.crash({\n            exitCode: 0,\n            errorType: \"fatal\",\n            printedMessage: `Run \\`npx convex login --link-deployments\\` first to link this deployment to your account, and then run \\`npx convex dev\\` again.`,\n          });\n        }\n        return await handleChooseProject(\n          ctx,\n          chosenConfiguration,\n          deploymentSelection.selectionWithinProject,\n          {\n            globallyForceCloud,\n          },\n          cmdOptions,\n        );\n      }\n      const alreadyHasConfiguredAnonymousDeployment =\n        deploymentSelection.deploymentName !== null &&\n        chosenConfiguration === null;\n      if (isAgentMode) {\n        logWarning(\n          chalkStderr.yellow.bold(\n            \"CONVEX_AGENT_MODE=anonymous mode is in beta, functionality may change in the future.\",\n          ),\n        );\n      }\n\n      const shouldPromptForLogin = isAgentMode\n        ? \"no\"\n        : alreadyHasConfiguredAnonymousDeployment\n          ? \"no\"\n          : await promptOptions(ctx, {\n              message:\n                \"Welcome to Convex! Would you like to login to your account?\",\n              choices: [\n                {\n                  name: \"Start without an account (run Convex locally)\",\n                  value: \"no\",\n                },\n                { name: \"Login or create an account\", value: \"yes\" },\n              ],\n              default: \"no\",\n            });\n      if (shouldPromptForLogin === \"no\") {\n        const result = await handleAnonymousDeployment(ctx, {\n          chosenConfiguration,\n          deploymentName: deploymentSelection.deploymentName,\n          ...cmdOptions.localOptions,\n        });\n        return {\n          adminKey: result.adminKey,\n          url: result.deploymentUrl,\n          deploymentFields: {\n            deploymentName: result.deploymentName,\n            deploymentType: \"anonymous\",\n            projectSlug: null,\n            teamSlug: null,\n          },\n        };\n      }\n      return await handleChooseProject(\n        ctx,\n        chosenConfiguration,\n        deploymentSelection.selectionWithinProject,\n        {\n          globallyForceCloud,\n        },\n        cmdOptions,\n      );\n    }\n  }\n}\n\nasync function handleDeploymentWithinProject(\n  ctx: Context,\n  {\n    chosenConfiguration,\n    deploymentSelection,\n    cmdOptions,\n    globallyForceCloud,\n  }: {\n    chosenConfiguration: ChosenConfiguration;\n    deploymentSelection: DeploymentSelection & {\n      kind: \"deploymentWithinProject\";\n    };\n    cmdOptions: ConfigureCmdOptions;\n    globallyForceCloud: boolean;\n  },\n) {\n  const hasAuth = ctx.bigBrainAuth() !== null;\n  const loginMessage =\n    hasAuth && shouldAllowAnonymousDevelopment()\n      ? undefined\n      : \"Tip: You can try out Convex without creating an account by clearing the \" +\n        `${CONVEX_DEPLOYMENT_ENV_VAR_NAME} environment variable (often in .env.local).`;\n  await ensureLoggedIn(ctx, {\n    message: loginMessage,\n    overrideAuthUrl: cmdOptions.overrideAuthUrl,\n    overrideAuthClient: cmdOptions.overrideAuthClient,\n    overrideAuthUsername: cmdOptions.overrideAuthUsername,\n    overrideAuthPassword: cmdOptions.overrideAuthPassword,\n  });\n  if (chosenConfiguration !== null) {\n    const result = await handleChooseProject(\n      ctx,\n      chosenConfiguration,\n      deploymentSelection.selectionWithinProject,\n      {\n        globallyForceCloud,\n      },\n      cmdOptions,\n    );\n    return result;\n  }\n\n  const accessResult = await checkAccessToSelectedProject(\n    ctx,\n    deploymentSelection.targetProject,\n  );\n  if (accessResult.kind === \"noAccess\") {\n    logMessage(\"You don't have access to the selected project.\");\n    const result = await handleChooseProject(\n      ctx,\n      chosenConfiguration,\n      deploymentSelection.selectionWithinProject,\n      {\n        globallyForceCloud,\n      },\n      cmdOptions,\n    );\n    return result;\n  }\n\n  const selectedDeployment = await loadSelectedDeploymentCredentials(\n    ctx,\n    deploymentSelection,\n    // We'll start running it below\n    { ensureLocalRunning: false },\n  );\n  if (\n    selectedDeployment.deploymentFields !== null &&\n    selectedDeployment.deploymentFields.deploymentType === \"local\"\n  ) {\n    // Start running the local backend\n    await handleLocalDeployment(ctx, {\n      teamSlug: selectedDeployment.deploymentFields.teamSlug!,\n      projectSlug: selectedDeployment.deploymentFields.projectSlug!,\n      forceUpgrade: cmdOptions.localOptions.forceUpgrade,\n      ports: cmdOptions.localOptions.ports,\n      backendVersion: cmdOptions.localOptions.backendVersion,\n    });\n  }\n  return {\n    url: selectedDeployment.url,\n    adminKey: selectedDeployment.adminKey,\n    deploymentFields: selectedDeployment.deploymentFields,\n  };\n}\n\nasync function handleChooseProject(\n  ctx: Context,\n  chosenConfiguration: ChosenConfiguration,\n  selectionWithinProject: DeploymentSelectionWithinProject,\n  args: {\n    globallyForceCloud: boolean;\n  },\n  cmdOptions: ConfigureCmdOptions,\n): Promise<\n  DeploymentCredentials & {\n    deploymentFields: {\n      deploymentName: DeploymentName;\n      deploymentType: DeploymentType;\n      projectSlug: string;\n      teamSlug: string;\n    };\n  }\n> {\n  await ensureLoggedIn(ctx, {\n    overrideAuthUrl: cmdOptions.overrideAuthUrl,\n    overrideAuthClient: cmdOptions.overrideAuthClient,\n    overrideAuthUsername: cmdOptions.overrideAuthUsername,\n    overrideAuthPassword: cmdOptions.overrideAuthPassword,\n  });\n  const project = await selectProject(ctx, chosenConfiguration, {\n    team: cmdOptions.team,\n    project: cmdOptions.project,\n    devDeployment: cmdOptions.devDeployment,\n    local: args.globallyForceCloud ? false : cmdOptions.local,\n    cloud: args.globallyForceCloud ? true : cmdOptions.cloud,\n  });\n  // TODO complain about any non-default cmdOptions.localOptions here\n  // because we're ignoring them if this isn't a local development.\n\n  const deploymentOptions: DeploymentOptions =\n    selectionWithinProject.kind === \"prod\"\n      ? { kind: \"prod\" }\n      : project.devDeployment === \"local\"\n        ? { kind: \"local\", ...cmdOptions.localOptions }\n        : { kind: \"dev\" };\n  const {\n    deploymentName,\n    deploymentUrl: url,\n    adminKey,\n  } = await ensureDeploymentProvisioned(ctx, {\n    teamSlug: project.teamSlug,\n    projectSlug: project.projectSlug,\n    deploymentOptions,\n  });\n  return {\n    url,\n    adminKey,\n    deploymentFields: {\n      deploymentName,\n      deploymentType: deploymentOptions.kind,\n      projectSlug: project.projectSlug,\n      teamSlug: project.teamSlug,\n    },\n  };\n}\n\nasync function handleManuallySetUrlAndAdminKey(\n  ctx: Context,\n  cmdOptions: { url: string; siteUrl: string; adminKey: string },\n) {\n  const { url, siteUrl, adminKey } = cmdOptions;\n  const didErase = await eraseDeploymentEnvVar(ctx);\n  if (didErase) {\n    logMessage(\n      chalkStderr.yellowBright(\n        `Removed the CONVEX_DEPLOYMENT environment variable from .env.local`,\n      ),\n    );\n  }\n  const envFileConfig = await writeUrlsToEnvFile(ctx, {\n    convexUrl: url,\n    siteUrl,\n  });\n  if (\n    envFileConfig !== null &&\n    (envFileConfig.convexUrlEnvVar || envFileConfig.siteUrlEnvVar)\n  ) {\n    // Join both names with \" and \" if both exist, otherwise just use one of them.\n    const updatedVars = [\n      envFileConfig.convexUrlEnvVar,\n      envFileConfig.siteUrlEnvVar,\n    ]\n      .filter(Boolean)\n      .join(\" and \");\n    logMessage(\n      chalkStderr.green(`Saved ${updatedVars} to ${envFileConfig.envFile}`),\n    );\n  }\n  return { url, adminKey };\n}\n\nexport async function selectProject(\n  ctx: Context,\n  chosenConfiguration: ChosenConfiguration,\n  cmdOptions: {\n    team?: string | undefined;\n    project?: string | undefined;\n    devDeployment?: \"cloud\" | \"local\" | undefined;\n    local?: boolean | undefined;\n    cloud?: boolean | undefined;\n    defaultProjectName?: string | undefined;\n  },\n): Promise<{\n  teamSlug: string;\n  projectSlug: string;\n  devDeployment: \"cloud\" | \"local\";\n}> {\n  // Prompt the user to select a project.\n  const choice =\n    chosenConfiguration !== \"ask\" && chosenConfiguration !== null\n      ? chosenConfiguration\n      : await askToConfigure(ctx);\n  switch (choice) {\n    case \"new\":\n      return selectNewProject(ctx, chosenConfiguration, cmdOptions);\n    case \"existing\":\n      return selectExistingProject(ctx, chosenConfiguration, cmdOptions);\n    default:\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage: \"No project selected.\",\n      });\n  }\n}\n\nconst cwd = path.basename(process.cwd());\nasync function selectNewProject(\n  ctx: Context,\n  chosenConfiguration: ChosenConfiguration,\n  config: {\n    team?: string | undefined;\n    project?: string | undefined;\n    devDeployment?: \"cloud\" | \"local\" | undefined;\n    cloud?: boolean | undefined;\n    local?: boolean | undefined;\n    defaultProjectName?: string | undefined;\n  },\n) {\n  const { team: selectedTeam, chosen: didChooseBetweenTeams } =\n    await validateOrSelectTeam(ctx, config.team, \"Team:\");\n  let projectName: string = config.project || cwd;\n  let choseProjectInteractively = false;\n  if (!config.project) {\n    projectName = await promptString(ctx, {\n      message: \"Project name:\",\n      default: config.defaultProjectName || cwd,\n    });\n    choseProjectInteractively = true;\n  }\n\n  const { devDeployment } = await selectDevDeploymentType(ctx, {\n    chosenConfiguration,\n    newOrExisting: \"new\",\n    teamSlug: selectedTeam.slug,\n    userHasChosenSomethingInteractively:\n      didChooseBetweenTeams || choseProjectInteractively,\n    projectSlug: undefined,\n    devDeploymentFromFlag: config.devDeployment,\n    forceDevDeployment: config.local\n      ? \"local\"\n      : config.cloud\n        ? \"cloud\"\n        : undefined,\n  });\n\n  const region =\n    devDeployment === \"cloud\"\n      ? await selectRegionOrUseDefault(ctx, selectedTeam, \"dev\")\n      : null;\n\n  showSpinner(\"Creating new Convex project...\");\n\n  const deploymentToProvision =\n    devDeployment === \"cloud\"\n      ? {\n          deploymentType: \"dev\" as const,\n          region,\n        }\n      : null;\n\n  let projectSlug, teamSlug, projectsRemaining;\n  try {\n    ({ projectSlug, teamSlug, projectsRemaining } = await createProject(ctx, {\n      teamSlug: selectedTeam.slug,\n      projectName,\n      deploymentToProvision,\n    }));\n  } catch (err) {\n    logFailure(\"Unable to create project.\");\n    return await logAndHandleFetchError(ctx, err);\n  }\n  const teamMessage = didChooseBetweenTeams\n    ? \" in team \" + chalkStderr.bold(teamSlug)\n    : \"\";\n  logFinishedStep(\n    `Created project ${chalkStderr.bold(\n      projectSlug,\n    )}${teamMessage}, manage it at ${chalkStderr.bold(\n      projectDashboardUrl(teamSlug, projectSlug),\n    )}`,\n  );\n\n  if (projectsRemaining <= 2) {\n    logWarning(\n      chalkStderr.yellow.bold(\n        `Your account now has ${projectsRemaining} project${\n          projectsRemaining === 1 ? \"\" : \"s\"\n        } remaining.`,\n      ),\n    );\n  }\n\n  await doInitConvexFolder(ctx);\n  const { configPath, projectConfig } = await readProjectConfig(ctx);\n  const folder = functionsDir(configPath, projectConfig);\n  await maybeSetupAiFiles(\n    ctx,\n    path.resolve(folder),\n    path.resolve(path.dirname(configPath)),\n  );\n  return { teamSlug, projectSlug, devDeployment };\n}\n\nasync function selectExistingProject(\n  ctx: Context,\n  chosenConfiguration: ChosenConfiguration,\n  config: {\n    team?: string | undefined;\n    project?: string | undefined;\n    devDeployment?: \"cloud\" | \"local\" | undefined;\n    local?: boolean | undefined;\n    cloud?: boolean | undefined;\n  },\n): Promise<{\n  teamSlug: string;\n  projectSlug: string;\n  devDeployment: \"cloud\" | \"local\";\n}> {\n  const {\n    team: { slug: teamSlug },\n    chosen,\n  } = await validateOrSelectTeam(ctx, config.team, \"Team:\");\n\n  const projectSlug = await validateOrSelectProject(\n    ctx,\n    config.project,\n    teamSlug,\n    \"Configure project\",\n    \"Project:\",\n  );\n  if (projectSlug === null) {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage: \"Run the command again to create a new project instead.\",\n    });\n  }\n  const { devDeployment } = await selectDevDeploymentType(ctx, {\n    chosenConfiguration,\n    newOrExisting: \"existing\",\n    teamSlug,\n    projectSlug,\n    userHasChosenSomethingInteractively: chosen || !config.project,\n    devDeploymentFromFlag: config.devDeployment,\n    forceDevDeployment: config.local\n      ? \"local\"\n      : config.cloud\n        ? \"cloud\"\n        : undefined,\n  });\n\n  logFinishedStep(`Reinitialized project ${chalkStderr.bold(projectSlug)}`);\n\n  const { configPath, projectConfig } = await readProjectConfig(ctx);\n  const folder = functionsDir(configPath, projectConfig);\n  await maybeSetupAiFiles(\n    ctx,\n    path.resolve(folder),\n    path.resolve(path.dirname(configPath)),\n  );\n\n  return { teamSlug, projectSlug, devDeployment };\n}\n\nasync function askToConfigure(ctx: Context): Promise<\"new\" | \"existing\"> {\n  if (!(await hasProjects(ctx))) {\n    return \"new\";\n  }\n  return await promptOptions(ctx, {\n    message: \"What would you like to configure?\",\n    default: \"new\",\n    choices: [\n      { name: \"create a new project\", value: \"new\" },\n      { name: \"choose an existing project\", value: \"existing\" },\n    ],\n  });\n}\n\ntype DeploymentOptions =\n  | {\n      kind: \"prod\";\n    }\n  | { kind: \"dev\" }\n  | {\n      kind: \"local\";\n      ports?:\n        | {\n            cloud: number;\n            site: number;\n          }\n        | undefined;\n      backendVersion?: string | undefined;\n      forceUpgrade: boolean;\n    };\n\n/**\n * This method assumes that the member has access to the selected project.\n */\nasync function ensureDeploymentProvisioned(\n  ctx: Context,\n  options: {\n    teamSlug: string;\n    projectSlug: string;\n    deploymentOptions: DeploymentOptions;\n  },\n): Promise<DeploymentDetails> {\n  switch (options.deploymentOptions.kind) {\n    case \"dev\":\n    case \"prod\": {\n      const credentials =\n        await fetchDeploymentCredentialsProvisioningDevOrProdMaybeThrows(\n          ctx,\n          {\n            kind: \"teamAndProjectSlugs\",\n            teamSlug: options.teamSlug,\n            projectSlug: options.projectSlug,\n          },\n          options.deploymentOptions.kind,\n        );\n      return {\n        ...credentials,\n        onActivity: null,\n      };\n    }\n    case \"local\": {\n      const credentials = await handleLocalDeployment(ctx, {\n        teamSlug: options.teamSlug,\n        projectSlug: options.projectSlug,\n        ...options.deploymentOptions,\n      });\n      return credentials;\n    }\n    default:\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage: `Invalid deployment type: ${(options.deploymentOptions as any).kind}`,\n        errForSentry: `Invalid deployment type: ${(options.deploymentOptions as any).kind}`,\n      });\n  }\n}\n\nexport async function updateEnvAndConfigForDeploymentSelection(\n  ctx: Context,\n  options: {\n    url: string;\n    siteUrl?: string | null;\n    deploymentName: string;\n    teamSlug: string | null;\n    projectSlug: string | null;\n    deploymentType: DeploymentType;\n  },\n  existingValue: string | null,\n) {\n  const { configPath, projectConfig } = await readProjectConfig(ctx);\n\n  const { wroteToGitIgnore, changedDeploymentEnvVar } =\n    await writeDeploymentEnvVar(\n      ctx,\n      options.deploymentType,\n      {\n        team: options.teamSlug,\n        project: options.projectSlug,\n        deploymentName: options.deploymentName,\n      },\n      existingValue,\n    );\n  await writeProjectConfig(ctx, projectConfig);\n  await finalizeConfiguration(ctx, {\n    deploymentType: options.deploymentType,\n    deploymentName: options.deploymentName,\n    url: options.url,\n    siteUrl: options.siteUrl,\n    wroteToGitIgnore,\n    changedDeploymentEnvVar,\n    functionsPath: functionsDir(configPath, projectConfig),\n  });\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { chalkStderr } from \"chalk\";\nimport { Context } from \"../bundler/context.js\";\nimport {\n  logFailure,\n  logFinishedStep,\n  logMessage,\n  logWarning,\n  showSpinner,\n} from \"../bundler/log.js\";\nimport {\n  DeploymentType,\n  DeploymentName,\n  fetchDeploymentCredentialsProvisioningDevOrProdMaybeThrows,\n  createProject,\n  loadSelectedDeploymentCredentials,\n  checkAccessToSelectedProject,\n  DeploymentSelectionWithinProject,\n} from \"./lib/api.js\";\nimport { readProjectConfig, writeProjectConfig } from \"./lib/config.js\";\nimport {\n  DeploymentDetails,\n  eraseDeploymentEnvVar,\n  writeDeploymentEnvVar,\n} from \"./lib/deployment.js\";\nimport { finalizeConfiguration } from \"./lib/init.js\";\nimport {\n  CONVEX_DEPLOYMENT_ENV_VAR_NAME,\n  functionsDir,\n  hasProjects,\n  logAndHandleFetchError,\n  selectDevDeploymentType,\n  selectRegionOrUseDefault,\n  validateOrSelectProject,\n  validateOrSelectTeam,\n} from \"./lib/utils/utils.js\";\nimport { writeUrlsToEnvFile } from \"./lib/envvars.js\";\nimport path from \"path\";\nimport { projectDashboardUrl } from \"./lib/dashboard.js\";\nimport { doInitConvexFolder } from \"./lib/codegen.js\";\nimport { handleLocalDeployment } from \"./lib/localDeployment/localDeployment.js\";\nimport {\n  promptOptions,\n  promptString,\n  promptYesNo,\n} from \"./lib/utils/prompts.js\";\nimport { readGlobalConfig } from \"./lib/utils/globalConfig.js\";\nimport { maybeSetupAiFiles } from \"./lib/aiFiles/index.js\";\nimport {\n  DeploymentSelection,\n  deploymentNameFromSelection,\n  shouldAllowAnonymousDevelopment,\n} from \"./lib/deploymentSelection.js\";\nimport { ensureLoggedIn } from \"./lib/login.js\";\nimport { handleAnonymousDeployment } from \"./lib/localDeployment/anonymous.js\";\nimport { fetchDeploymentCanonicalSiteUrl } from \"./lib/env.js\";\ntype DeploymentCredentials = {\n  url: string;\n  adminKey: string;\n};\n\ntype ChosenConfiguration =\n  // `--configure new`\n  | \"new\"\n  // `--configure existing`\n  | \"existing\"\n  // `--configure`\n  | \"ask\"\n  // `--configure` was not specified\n  | null;\n\ntype ConfigureCmdOptions = {\n  prod: boolean;\n  localOptions: {\n    ports?: {\n      cloud: number;\n      site: number;\n    };\n    backendVersion?: string | undefined;\n    dashboardVersion?: string | undefined;\n    forceUpgrade: boolean;\n  };\n  team?: string | undefined;\n  project?: string | undefined;\n  devDeployment?: \"cloud\" | \"local\" | undefined;\n  local?: boolean | undefined;\n  cloud?: boolean | undefined;\n  url?: string | undefined;\n  adminKey?: string | undefined;\n  envFile?: string | undefined;\n  overrideAuthUrl?: string | undefined;\n  overrideAuthClient?: string | undefined;\n  overrideAuthUsername?: string | undefined;\n  overrideAuthPassword?: string | undefined;\n};\n\n/**\n * As of writing, this is used by:\n * - `npx convex dev`\n * - `npx convex codegen`\n *\n * But is not used by `npx convex deploy` or other commands.\n */\nexport async function deploymentCredentialsOrConfigure(\n  ctx: Context,\n  deploymentSelection: DeploymentSelection,\n  chosenConfiguration: ChosenConfiguration,\n  cmdOptions: ConfigureCmdOptions,\n): Promise<\n  DeploymentCredentials & {\n    deploymentFields: {\n      deploymentName: DeploymentName;\n      deploymentType: DeploymentType;\n      projectSlug: string | null;\n      teamSlug: string | null;\n      siteUrl: string | null;\n    } | null;\n  }\n> {\n  const selectedDeployment = await _deploymentCredentialsOrConfigure(\n    ctx,\n    deploymentSelection,\n    chosenConfiguration,\n    cmdOptions,\n  );\n  const siteUrl = await fetchDeploymentCanonicalSiteUrl(ctx, {\n    adminKey: selectedDeployment.adminKey,\n    deploymentUrl: selectedDeployment.url,\n  });\n\n  if (selectedDeployment.deploymentFields !== null) {\n    // Set the `CONVEX_DEPLOYMENT` env var + the `CONVEX_URL` env var\n    await updateEnvAndConfigForDeploymentSelection(\n      ctx,\n      {\n        url: selectedDeployment.url,\n        siteUrl,\n        deploymentName: selectedDeployment.deploymentFields.deploymentName,\n        teamSlug: selectedDeployment.deploymentFields.teamSlug,\n        projectSlug: selectedDeployment.deploymentFields.projectSlug,\n        deploymentType: selectedDeployment.deploymentFields.deploymentType,\n      },\n      deploymentNameFromSelection(deploymentSelection),\n    );\n  } else {\n    // Clear the `CONVEX_DEPLOYMENT` env var + set the `CONVEX_URL` and\n    // `CONVEX_SITE_URL` env vars.\n    await handleManuallySetUrlAndAdminKey(ctx, {\n      url: selectedDeployment.url,\n      siteUrl,\n      adminKey: selectedDeployment.adminKey,\n    });\n  }\n  return {\n    url: selectedDeployment.url,\n    adminKey: selectedDeployment.adminKey,\n    deploymentFields:\n      selectedDeployment.deploymentFields === null\n        ? null\n        : { ...selectedDeployment.deploymentFields, siteUrl: siteUrl },\n  };\n}\n\nexport async function _deploymentCredentialsOrConfigure(\n  ctx: Context,\n  deploymentSelection: DeploymentSelection,\n  chosenConfiguration: ChosenConfiguration,\n  cmdOptions: ConfigureCmdOptions,\n): Promise<\n  DeploymentCredentials & {\n    deploymentFields: {\n      deploymentName: DeploymentName;\n      deploymentType: DeploymentType;\n      projectSlug: string | null;\n      teamSlug: string | null;\n    } | null;\n  }\n> {\n  const config = readGlobalConfig(ctx);\n  const globallyForceCloud = !!config?.optOutOfLocalDevDeploymentsUntilBetaOver;\n  if (globallyForceCloud && cmdOptions.local) {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage:\n        \"Can't specify --local when local deployments are disabled on this machine. Run `npx convex disable-local-deployments --undo-global` to allow use of --local.\",\n    });\n  }\n\n  switch (deploymentSelection.kind) {\n    case \"existingDeployment\":\n      return {\n        url: deploymentSelection.deploymentToActOn.url,\n        adminKey: deploymentSelection.deploymentToActOn.adminKey,\n        deploymentFields:\n          deploymentSelection.deploymentToActOn.deploymentFields,\n      };\n    case \"chooseProject\": {\n      await ensureLoggedIn(ctx, {\n        overrideAuthUrl: cmdOptions.overrideAuthUrl,\n        overrideAuthClient: cmdOptions.overrideAuthClient,\n        overrideAuthUsername: cmdOptions.overrideAuthUsername,\n        overrideAuthPassword: cmdOptions.overrideAuthPassword,\n      });\n      return await handleChooseProject(\n        ctx,\n        chosenConfiguration,\n        deploymentSelection.selectionWithinProject,\n        {\n          globallyForceCloud,\n        },\n        cmdOptions,\n      );\n    }\n    case \"preview\":\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage: \"Use `npx convex deploy` to use preview deployments.\",\n      });\n    case \"deploymentWithinProject\": {\n      return await handleDeploymentWithinProject(ctx, {\n        chosenConfiguration,\n        deploymentSelection,\n        cmdOptions,\n        globallyForceCloud,\n      });\n    }\n    case \"anonymous\": {\n      const hasAuth = ctx.bigBrainAuth() !== null;\n      const isAgentMode = process.env.CONVEX_AGENT_MODE === \"anonymous\";\n      if (\n        !isAgentMode &&\n        hasAuth &&\n        deploymentSelection.deploymentName !== null\n      ) {\n        const shouldConfigure =\n          chosenConfiguration !== null ||\n          (await promptYesNo(ctx, {\n            message: `${CONVEX_DEPLOYMENT_ENV_VAR_NAME} is configured with deployment ${deploymentSelection.deploymentName}, which is not linked with your account. Would you like to link it now?`,\n          }));\n        if (!shouldConfigure) {\n          return await ctx.crash({\n            exitCode: 0,\n            errorType: \"fatal\",\n            printedMessage: `Run \\`npx convex login --link-deployments\\` first to link this deployment to your account, and then run \\`npx convex dev\\` again.`,\n          });\n        }\n        return await handleChooseProject(\n          ctx,\n          chosenConfiguration,\n          deploymentSelection.selectionWithinProject,\n          {\n            globallyForceCloud,\n          },\n          cmdOptions,\n        );\n      }\n      const alreadyHasConfiguredAnonymousDeployment =\n        deploymentSelection.deploymentName !== null &&\n        chosenConfiguration === null;\n      if (isAgentMode) {\n        logWarning(\n          chalkStderr.yellow.bold(\n            \"CONVEX_AGENT_MODE=anonymous mode is in beta, functionality may change in the future.\",\n          ),\n        );\n      }\n\n      const shouldPromptForLogin = isAgentMode\n        ? \"no\"\n        : alreadyHasConfiguredAnonymousDeployment\n          ? \"no\"\n          : await promptOptions(ctx, {\n              message:\n                \"Welcome to Convex! Would you like to login to your account?\",\n              choices: [\n                {\n                  name: \"Start without an account (run Convex locally)\",\n                  value: \"no\",\n                },\n                { name: \"Login or create an account\", value: \"yes\" },\n              ],\n              default: \"no\",\n            });\n      if (shouldPromptForLogin === \"no\") {\n        const result = await handleAnonymousDeployment(ctx, {\n          chosenConfiguration,\n          deploymentName: deploymentSelection.deploymentName,\n          ...cmdOptions.localOptions,\n        });\n        return {\n          adminKey: result.adminKey,\n          url: result.deploymentUrl,\n          deploymentFields: {\n            deploymentName: result.deploymentName,\n            deploymentType: \"anonymous\",\n            projectSlug: null,\n            teamSlug: null,\n          },\n        };\n      }\n      return await handleChooseProject(\n        ctx,\n        chosenConfiguration,\n        deploymentSelection.selectionWithinProject,\n        {\n          globallyForceCloud,\n        },\n        cmdOptions,\n      );\n    }\n  }\n}\n\nasync function handleDeploymentWithinProject(\n  ctx: Context,\n  {\n    chosenConfiguration,\n    deploymentSelection,\n    cmdOptions,\n    globallyForceCloud,\n  }: {\n    chosenConfiguration: ChosenConfiguration;\n    deploymentSelection: DeploymentSelection & {\n      kind: \"deploymentWithinProject\";\n    };\n    cmdOptions: ConfigureCmdOptions;\n    globallyForceCloud: boolean;\n  },\n) {\n  const hasAuth = ctx.bigBrainAuth() !== null;\n  const loginMessage =\n    hasAuth && shouldAllowAnonymousDevelopment()\n      ? undefined\n      : \"Tip: You can try out Convex without creating an account by clearing the \" +\n        `${CONVEX_DEPLOYMENT_ENV_VAR_NAME} environment variable (often in .env.local).`;\n  await ensureLoggedIn(ctx, {\n    message: loginMessage,\n    overrideAuthUrl: cmdOptions.overrideAuthUrl,\n    overrideAuthClient: cmdOptions.overrideAuthClient,\n    overrideAuthUsername: cmdOptions.overrideAuthUsername,\n    overrideAuthPassword: cmdOptions.overrideAuthPassword,\n  });\n  if (chosenConfiguration !== null) {\n    const result = await handleChooseProject(\n      ctx,\n      chosenConfiguration,\n      deploymentSelection.selectionWithinProject,\n      {\n        globallyForceCloud,\n      },\n      cmdOptions,\n    );\n    return result;\n  }\n\n  const accessResult = await checkAccessToSelectedProject(\n    ctx,\n    deploymentSelection.targetProject,\n  );\n  if (accessResult.kind === \"noAccess\") {\n    logMessage(\"You don't have access to the selected project.\");\n    const result = await handleChooseProject(\n      ctx,\n      chosenConfiguration,\n      deploymentSelection.selectionWithinProject,\n      {\n        globallyForceCloud,\n      },\n      cmdOptions,\n    );\n    return result;\n  }\n\n  const selectedDeployment = await loadSelectedDeploymentCredentials(\n    ctx,\n    deploymentSelection,\n    // We'll start running it below\n    { ensureLocalRunning: false },\n  );\n  if (\n    selectedDeployment.deploymentFields !== null &&\n    selectedDeployment.deploymentFields.deploymentType === \"local\"\n  ) {\n    // Start running the local backend, which may bind to different ports\n    // than what was saved from a previous run.\n    const localDeployment = await handleLocalDeployment(ctx, {\n      teamSlug: selectedDeployment.deploymentFields.teamSlug!,\n      projectSlug: selectedDeployment.deploymentFields.projectSlug!,\n      forceUpgrade: cmdOptions.localOptions.forceUpgrade,\n      ports: cmdOptions.localOptions.ports,\n      backendVersion: cmdOptions.localOptions.backendVersion,\n    });\n    return {\n      url: localDeployment.deploymentUrl,\n      adminKey: localDeployment.adminKey,\n      deploymentFields: selectedDeployment.deploymentFields,\n    };\n  }\n  return {\n    url: selectedDeployment.url,\n    adminKey: selectedDeployment.adminKey,\n    deploymentFields: selectedDeployment.deploymentFields,\n  };\n}\n\nasync function handleChooseProject(\n  ctx: Context,\n  chosenConfiguration: ChosenConfiguration,\n  selectionWithinProject: DeploymentSelectionWithinProject,\n  args: {\n    globallyForceCloud: boolean;\n  },\n  cmdOptions: ConfigureCmdOptions,\n): Promise<\n  DeploymentCredentials & {\n    deploymentFields: {\n      deploymentName: DeploymentName;\n      deploymentType: DeploymentType;\n      projectSlug: string;\n      teamSlug: string;\n    };\n  }\n> {\n  await ensureLoggedIn(ctx, {\n    overrideAuthUrl: cmdOptions.overrideAuthUrl,\n    overrideAuthClient: cmdOptions.overrideAuthClient,\n    overrideAuthUsername: cmdOptions.overrideAuthUsername,\n    overrideAuthPassword: cmdOptions.overrideAuthPassword,\n  });\n  const project = await selectProject(ctx, chosenConfiguration, {\n    team: cmdOptions.team,\n    project: cmdOptions.project,\n    devDeployment: cmdOptions.devDeployment,\n    local: args.globallyForceCloud ? false : cmdOptions.local,\n    cloud: args.globallyForceCloud ? true : cmdOptions.cloud,\n  });\n  // TODO complain about any non-default cmdOptions.localOptions here\n  // because we're ignoring them if this isn't a local development.\n\n  const deploymentOptions: DeploymentOptions =\n    selectionWithinProject.kind === \"prod\"\n      ? { kind: \"prod\" }\n      : project.devDeployment === \"local\"\n        ? { kind: \"local\", ...cmdOptions.localOptions }\n        : { kind: \"dev\" };\n  const {\n    deploymentName,\n    deploymentUrl: url,\n    adminKey,\n  } = await ensureDeploymentProvisioned(ctx, {\n    teamSlug: project.teamSlug,\n    projectSlug: project.projectSlug,\n    deploymentOptions,\n  });\n  return {\n    url,\n    adminKey,\n    deploymentFields: {\n      deploymentName,\n      deploymentType: deploymentOptions.kind,\n      projectSlug: project.projectSlug,\n      teamSlug: project.teamSlug,\n    },\n  };\n}\n\nasync function handleManuallySetUrlAndAdminKey(\n  ctx: Context,\n  cmdOptions: { url: string; siteUrl: string; adminKey: string },\n) {\n  const { url, siteUrl, adminKey } = cmdOptions;\n  const didErase = await eraseDeploymentEnvVar(ctx);\n  if (didErase) {\n    logMessage(\n      chalkStderr.yellowBright(\n        `Removed the CONVEX_DEPLOYMENT environment variable from .env.local`,\n      ),\n    );\n  }\n  const envFileConfig = await writeUrlsToEnvFile(ctx, {\n    convexUrl: url,\n    siteUrl,\n  });\n  if (\n    envFileConfig !== null &&\n    (envFileConfig.convexUrlEnvVar || envFileConfig.siteUrlEnvVar)\n  ) {\n    // Join both names with \" and \" if both exist, otherwise just use one of them.\n    const updatedVars = [\n      envFileConfig.convexUrlEnvVar,\n      envFileConfig.siteUrlEnvVar,\n    ]\n      .filter(Boolean)\n      .join(\" and \");\n    logMessage(\n      chalkStderr.green(`Saved ${updatedVars} to ${envFileConfig.envFile}`),\n    );\n  }\n  return { url, adminKey };\n}\n\nexport async function selectProject(\n  ctx: Context,\n  chosenConfiguration: ChosenConfiguration,\n  cmdOptions: {\n    team?: string | undefined;\n    project?: string | undefined;\n    devDeployment?: \"cloud\" | \"local\" | undefined;\n    local?: boolean | undefined;\n    cloud?: boolean | undefined;\n    defaultProjectName?: string | undefined;\n  },\n): Promise<{\n  teamSlug: string;\n  projectSlug: string;\n  devDeployment: \"cloud\" | \"local\";\n}> {\n  // Prompt the user to select a project.\n  const choice =\n    chosenConfiguration !== \"ask\" && chosenConfiguration !== null\n      ? chosenConfiguration\n      : await askToConfigure(ctx);\n  switch (choice) {\n    case \"new\":\n      return selectNewProject(ctx, chosenConfiguration, cmdOptions);\n    case \"existing\":\n      return selectExistingProject(ctx, chosenConfiguration, cmdOptions);\n    default:\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage: \"No project selected.\",\n      });\n  }\n}\n\nconst cwd = path.basename(process.cwd());\nasync function selectNewProject(\n  ctx: Context,\n  chosenConfiguration: ChosenConfiguration,\n  config: {\n    team?: string | undefined;\n    project?: string | undefined;\n    devDeployment?: \"cloud\" | \"local\" | undefined;\n    cloud?: boolean | undefined;\n    local?: boolean | undefined;\n    defaultProjectName?: string | undefined;\n  },\n) {\n  const { team: selectedTeam, chosen: didChooseBetweenTeams } =\n    await validateOrSelectTeam(ctx, config.team, \"Team:\");\n  let projectName: string = config.project || cwd;\n  let choseProjectInteractively = false;\n  if (!config.project) {\n    projectName = await promptString(ctx, {\n      message: \"Project name:\",\n      default: config.defaultProjectName || cwd,\n    });\n    choseProjectInteractively = true;\n  }\n\n  const { devDeployment } = await selectDevDeploymentType(ctx, {\n    chosenConfiguration,\n    newOrExisting: \"new\",\n    teamSlug: selectedTeam.slug,\n    userHasChosenSomethingInteractively:\n      didChooseBetweenTeams || choseProjectInteractively,\n    projectSlug: undefined,\n    devDeploymentFromFlag: config.devDeployment,\n    forceDevDeployment: config.local\n      ? \"local\"\n      : config.cloud\n        ? \"cloud\"\n        : undefined,\n  });\n\n  const region =\n    devDeployment === \"cloud\"\n      ? await selectRegionOrUseDefault(ctx, selectedTeam, \"dev\")\n      : null;\n\n  showSpinner(\"Creating new Convex project...\");\n\n  const deploymentToProvision =\n    devDeployment === \"cloud\"\n      ? {\n          deploymentType: \"dev\" as const,\n          region,\n        }\n      : null;\n\n  let projectSlug, teamSlug, projectsRemaining;\n  try {\n    ({ projectSlug, teamSlug, projectsRemaining } = await createProject(ctx, {\n      teamSlug: selectedTeam.slug,\n      projectName,\n      deploymentToProvision,\n    }));\n  } catch (err) {\n    logFailure(\"Unable to create project.\");\n    return await logAndHandleFetchError(ctx, err);\n  }\n  const teamMessage = didChooseBetweenTeams\n    ? \" in team \" + chalkStderr.bold(teamSlug)\n    : \"\";\n  logFinishedStep(\n    `Created project ${chalkStderr.bold(\n      projectSlug,\n    )}${teamMessage}, manage it at ${chalkStderr.bold(\n      projectDashboardUrl(teamSlug, projectSlug),\n    )}`,\n  );\n\n  if (projectsRemaining <= 2) {\n    logWarning(\n      chalkStderr.yellow.bold(\n        `Your account now has ${projectsRemaining} project${\n          projectsRemaining === 1 ? \"\" : \"s\"\n        } remaining.`,\n      ),\n    );\n  }\n\n  await doInitConvexFolder(ctx);\n  const { configPath, projectConfig } = await readProjectConfig(ctx);\n  const folder = functionsDir(configPath, projectConfig);\n  await maybeSetupAiFiles({\n    ctx,\n    convexDir: path.resolve(folder),\n    projectDir: path.resolve(path.dirname(configPath)),\n  });\n  return { teamSlug, projectSlug, devDeployment };\n}\n\nasync function selectExistingProject(\n  ctx: Context,\n  chosenConfiguration: ChosenConfiguration,\n  config: {\n    team?: string | undefined;\n    project?: string | undefined;\n    devDeployment?: \"cloud\" | \"local\" | undefined;\n    local?: boolean | undefined;\n    cloud?: boolean | undefined;\n  },\n): Promise<{\n  teamSlug: string;\n  projectSlug: string;\n  devDeployment: \"cloud\" | \"local\";\n}> {\n  const {\n    team: { slug: teamSlug },\n    chosen,\n  } = await validateOrSelectTeam(ctx, config.team, \"Team:\");\n\n  const projectSlug = await validateOrSelectProject(\n    ctx,\n    config.project,\n    teamSlug,\n    \"Configure project\",\n    \"Project:\",\n  );\n  if (projectSlug === null) {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage: \"Run the command again to create a new project instead.\",\n    });\n  }\n  const { devDeployment } = await selectDevDeploymentType(ctx, {\n    chosenConfiguration,\n    newOrExisting: \"existing\",\n    teamSlug,\n    projectSlug,\n    userHasChosenSomethingInteractively: chosen || !config.project,\n    devDeploymentFromFlag: config.devDeployment,\n    forceDevDeployment: config.local\n      ? \"local\"\n      : config.cloud\n        ? \"cloud\"\n        : undefined,\n  });\n\n  logFinishedStep(`Reinitialized project ${chalkStderr.bold(projectSlug)}`);\n\n  const { configPath, projectConfig } = await readProjectConfig(ctx);\n  const folder = functionsDir(configPath, projectConfig);\n  await maybeSetupAiFiles({\n    ctx,\n    convexDir: path.resolve(folder),\n    projectDir: path.resolve(path.dirname(configPath)),\n  });\n\n  return { teamSlug, projectSlug, devDeployment };\n}\n\nasync function askToConfigure(ctx: Context): Promise<\"new\" | \"existing\"> {\n  if (!(await hasProjects(ctx))) {\n    return \"new\";\n  }\n  return await promptOptions(ctx, {\n    message: \"What would you like to configure?\",\n    default: \"new\",\n    choices: [\n      { name: \"create a new project\", value: \"new\" },\n      { name: \"choose an existing project\", value: \"existing\" },\n    ],\n  });\n}\n\ntype DeploymentOptions =\n  | {\n      kind: \"prod\";\n    }\n  | { kind: \"dev\" }\n  | {\n      kind: \"local\";\n      ports?:\n        | {\n            cloud: number;\n            site: number;\n          }\n        | undefined;\n      backendVersion?: string | undefined;\n      forceUpgrade: boolean;\n    };\n\n/**\n * This method assumes that the member has access to the selected project.\n */\nasync function ensureDeploymentProvisioned(\n  ctx: Context,\n  options: {\n    teamSlug: string;\n    projectSlug: string;\n    deploymentOptions: DeploymentOptions;\n  },\n): Promise<DeploymentDetails> {\n  switch (options.deploymentOptions.kind) {\n    case \"dev\":\n    case \"prod\": {\n      const credentials =\n        await fetchDeploymentCredentialsProvisioningDevOrProdMaybeThrows(\n          ctx,\n          {\n            kind: \"teamAndProjectSlugs\",\n            teamSlug: options.teamSlug,\n            projectSlug: options.projectSlug,\n          },\n          options.deploymentOptions.kind,\n        );\n      return {\n        ...credentials,\n        onActivity: null,\n      };\n    }\n    case \"local\": {\n      const credentials = await handleLocalDeployment(ctx, {\n        teamSlug: options.teamSlug,\n        projectSlug: options.projectSlug,\n        ...options.deploymentOptions,\n      });\n      return credentials;\n    }\n    default:\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage: `Invalid deployment type: ${(options.deploymentOptions as any).kind}`,\n        errForSentry: `Invalid deployment type: ${(options.deploymentOptions as any).kind}`,\n      });\n  }\n}\n\nexport async function updateEnvAndConfigForDeploymentSelection(\n  ctx: Context,\n  options: {\n    url: string;\n    siteUrl?: string | null;\n    deploymentName: string;\n    teamSlug: string | null;\n    projectSlug: string | null;\n    deploymentType: DeploymentType;\n  },\n  existingValue: string | null,\n) {\n  const { configPath, projectConfig } = await readProjectConfig(ctx);\n\n  const { wroteToGitIgnore, changedDeploymentEnvVar } =\n    await writeDeploymentEnvVar(\n      ctx,\n      options.deploymentType,\n      {\n        team: options.teamSlug,\n        project: options.projectSlug,\n        deploymentName: options.deploymentName,\n      },\n      existingValue,\n    );\n  await writeProjectConfig(ctx, projectConfig);\n  await finalizeConfiguration(ctx, {\n    deploymentType: options.deploymentType,\n    deploymentName: options.deploymentName,\n    url: options.url,\n    siteUrl: options.siteUrl,\n    wroteToGitIgnore,\n    changedDeploymentEnvVar,\n    functionsPath: functionsDir(configPath, projectConfig),\n  });\n}\n"],
+  "mappings": "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",
   "names": ["path"]
 }

package/dist/cjs/cli/lib/aiFiles/agentsmd.js

@@ -0,0 +1,69 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target2, all) => {
+  for (var name in all)
+    __defProp(target2, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var agentsmd_exports = {};
+__export(agentsmd_exports, {
+  applyAgentsMdSection: () => applyAgentsMdSection,
+  hasAgentsMdInstalled: () => hasAgentsMdInstalled,
+  injectAgentsMdSection: () => injectAgentsMdSection,
+  removeAgentsMdSection: () => removeAgentsMdSection,
+  stripAgentsMdSection: () => stripAgentsMdSection
+});
+module.exports = __toCommonJS(agentsmd_exports);
+var import_agentsmd = require("../../codegen_templates/agentsmd.js");
+var import_paths = require("./paths.js");
+var import_utils = require("./utils.js");
+function target(projectDir) {
+  return {
+    filePath: (0, import_paths.agentsMdPath)(projectDir),
+    startMarker: import_agentsmd.AGENTS_MD_START_MARKER,
+    endMarker: import_agentsmd.AGENTS_MD_END_MARKER
+  };
+}
+async function injectAgentsMdSection({
+  section,
+  projectDir
+}) {
+  return (0, import_utils.injectManagedSection)({ ...target(projectDir), section });
+}
+async function stripAgentsMdSection(projectDir) {
+  return (0, import_utils.stripManagedSection)(target(projectDir));
+}
+async function removeAgentsMdSection(projectDir) {
+  return (0, import_utils.removeMarkdownSection)({
+    projectDir,
+    strip: stripAgentsMdSection,
+    fileName: "AGENTS.md"
+  });
+}
+async function hasAgentsMdInstalled(projectDir) {
+  return (0, import_utils.hasManagedSection)(target(projectDir));
+}
+async function applyAgentsMdSection({
+  projectDir,
+  config,
+  convexDirName
+}) {
+  const result = await injectAgentsMdSection({
+    section: (0, import_agentsmd.agentsMdConvexSection)(convexDirName),
+    projectDir
+  });
+  config.agentsMdSectionHash = result.sectionHash;
+  return result.didWrite;
+}
+//# sourceMappingURL=agentsmd.js.map

package/dist/cjs/cli/lib/aiFiles/agentsmd.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/cli/lib/aiFiles/agentsmd.ts"],
+  "sourcesContent": ["import {\n  AGENTS_MD_START_MARKER,\n  AGENTS_MD_END_MARKER,\n  agentsMdConvexSection,\n} from \"../../codegen_templates/agentsmd.js\";\nimport { agentsMdPath } from \"./paths.js\";\nimport { type AiFilesConfig } from \"./config.js\";\nimport {\n  type ManagedSectionTarget,\n  type InjectResult,\n  type StripResult,\n  injectManagedSection,\n  stripManagedSection,\n  hasManagedSection,\n  removeMarkdownSection,\n} from \"./utils.js\";\n\nfunction target(projectDir?: string): ManagedSectionTarget {\n  return {\n    filePath: agentsMdPath(projectDir),\n    startMarker: AGENTS_MD_START_MARKER,\n    endMarker: AGENTS_MD_END_MARKER,\n  };\n}\n\nexport async function injectAgentsMdSection({\n  section,\n  projectDir,\n}: {\n  section: string;\n  projectDir?: string;\n}): Promise<InjectResult> {\n  return injectManagedSection({ ...target(projectDir), section });\n}\n\nexport async function stripAgentsMdSection(\n  projectDir: string,\n): Promise<StripResult> {\n  return stripManagedSection(target(projectDir));\n}\n\nexport async function removeAgentsMdSection(\n  projectDir: string,\n): Promise<boolean> {\n  return removeMarkdownSection({\n    projectDir,\n    strip: stripAgentsMdSection,\n    fileName: \"AGENTS.md\",\n  });\n}\n\nexport async function hasAgentsMdInstalled(\n  projectDir: string,\n): Promise<boolean> {\n  return hasManagedSection(target(projectDir));\n}\n\n/**\n * Inject (or update) the Convex section in AGENTS.md and record the hash.\n * Returns true if the file was actually written.\n */\nexport async function applyAgentsMdSection({\n  projectDir,\n  config,\n  convexDirName,\n}: {\n  projectDir: string;\n  config: AiFilesConfig;\n  convexDirName: string;\n}): Promise<boolean> {\n  const result = await injectAgentsMdSection({\n    section: agentsMdConvexSection(convexDirName),\n    projectDir,\n  });\n  config.agentsMdSectionHash = result.sectionHash;\n  return result.didWrite;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sBAIO;AACP,mBAA6B;AAE7B,mBAQO;AAEP,SAAS,OAAO,YAA2C;AACzD,SAAO;AAAA,IACL,cAAU,2BAAa,UAAU;AAAA,IACjC,aAAa;AAAA,IACb,WAAW;AAAA,EACb;AACF;AAEA,eAAsB,sBAAsB;AAAA,EAC1C;AAAA,EACA;AACF,GAG0B;AACxB,aAAO,mCAAqB,EAAE,GAAG,OAAO,UAAU,GAAG,QAAQ,CAAC;AAChE;AAEA,eAAsB,qBACpB,YACsB;AACtB,aAAO,kCAAoB,OAAO,UAAU,CAAC;AAC/C;AAEA,eAAsB,sBACpB,YACkB;AAClB,aAAO,oCAAsB;AAAA,IAC3B;AAAA,IACA,OAAO;AAAA,IACP,UAAU;AAAA,EACZ,CAAC;AACH;AAEA,eAAsB,qBACpB,YACkB;AAClB,aAAO,gCAAkB,OAAO,UAAU,CAAC;AAC7C;AAMA,eAAsB,qBAAqB;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AACF,GAIqB;AACnB,QAAM,SAAS,MAAM,sBAAsB;AAAA,IACzC,aAAS,uCAAsB,aAAa;AAAA,IAC5C;AAAA,EACF,CAAC;AACD,SAAO,sBAAsB,OAAO;AACpC,SAAO,OAAO;AAChB;",
+  "names": []
+}

package/dist/cjs/cli/lib/aiFiles/claudemd.js

@@ -0,0 +1,69 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target2, all) => {
+  for (var name in all)
+    __defProp(target2, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var claudemd_exports = {};
+__export(claudemd_exports, {
+  applyClaudeMdSection: () => applyClaudeMdSection,
+  hasClaudeMdInstalled: () => hasClaudeMdInstalled,
+  injectClaudeMdSection: () => injectClaudeMdSection,
+  removeClaudeMdSection: () => removeClaudeMdSection,
+  stripClaudeMdSection: () => stripClaudeMdSection
+});
+module.exports = __toCommonJS(claudemd_exports);
+var import_claudemd = require("../../codegen_templates/claudemd.js");
+var import_paths = require("./paths.js");
+var import_utils = require("./utils.js");
+function target(projectDir) {
+  return {
+    filePath: (0, import_paths.claudeMdPath)(projectDir),
+    startMarker: import_claudemd.CLAUDE_MD_START_MARKER,
+    endMarker: import_claudemd.CLAUDE_MD_END_MARKER
+  };
+}
+async function injectClaudeMdSection({
+  section,
+  projectDir
+}) {
+  return (0, import_utils.injectManagedSection)({ ...target(projectDir), section });
+}
+async function stripClaudeMdSection(projectDir) {
+  return (0, import_utils.stripManagedSection)(target(projectDir));
+}
+async function removeClaudeMdSection(projectDir) {
+  return (0, import_utils.removeMarkdownSection)({
+    projectDir,
+    strip: stripClaudeMdSection,
+    fileName: "CLAUDE.md"
+  });
+}
+async function hasClaudeMdInstalled(projectDir) {
+  return (0, import_utils.hasManagedSection)(target(projectDir));
+}
+async function applyClaudeMdSection({
+  projectDir,
+  config,
+  convexDirName
+}) {
+  const result = await injectClaudeMdSection({
+    section: (0, import_claudemd.claudeMdConvexSection)(convexDirName),
+    projectDir
+  });
+  config.claudeMdHash = result.sectionHash;
+  return result.didWrite;
+}
+//# sourceMappingURL=claudemd.js.map

package/dist/cjs/cli/lib/aiFiles/claudemd.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/cli/lib/aiFiles/claudemd.ts"],
+  "sourcesContent": ["import {\n  CLAUDE_MD_END_MARKER,\n  CLAUDE_MD_START_MARKER,\n  claudeMdConvexSection,\n} from \"../../codegen_templates/claudemd.js\";\nimport { claudeMdPath } from \"./paths.js\";\nimport { type AiFilesConfig } from \"./config.js\";\nimport {\n  type ManagedSectionTarget,\n  type InjectResult,\n  type StripResult,\n  injectManagedSection,\n  stripManagedSection,\n  hasManagedSection,\n  removeMarkdownSection,\n} from \"./utils.js\";\n\nfunction target(projectDir?: string): ManagedSectionTarget {\n  return {\n    filePath: claudeMdPath(projectDir),\n    startMarker: CLAUDE_MD_START_MARKER,\n    endMarker: CLAUDE_MD_END_MARKER,\n  };\n}\n\nexport async function injectClaudeMdSection({\n  section,\n  projectDir,\n}: {\n  section: string;\n  projectDir?: string;\n}): Promise<InjectResult> {\n  return injectManagedSection({ ...target(projectDir), section });\n}\n\nexport async function stripClaudeMdSection(\n  projectDir: string,\n): Promise<StripResult> {\n  return stripManagedSection(target(projectDir));\n}\n\nexport async function removeClaudeMdSection(\n  projectDir: string,\n): Promise<boolean> {\n  return removeMarkdownSection({\n    projectDir,\n    strip: stripClaudeMdSection,\n    fileName: \"CLAUDE.md\",\n  });\n}\n\nexport async function hasClaudeMdInstalled(\n  projectDir: string,\n): Promise<boolean> {\n  return hasManagedSection(target(projectDir));\n}\n\n/**\n * Inject (or update) the Convex section in CLAUDE.md and record the hash.\n * Returns true if the file was actually written.\n */\nexport async function applyClaudeMdSection({\n  projectDir,\n  config,\n  convexDirName,\n}: {\n  projectDir: string;\n  config: AiFilesConfig;\n  convexDirName: string;\n}): Promise<boolean> {\n  const result = await injectClaudeMdSection({\n    section: claudeMdConvexSection(convexDirName),\n    projectDir,\n  });\n  config.claudeMdHash = result.sectionHash;\n  return result.didWrite;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sBAIO;AACP,mBAA6B;AAE7B,mBAQO;AAEP,SAAS,OAAO,YAA2C;AACzD,SAAO;AAAA,IACL,cAAU,2BAAa,UAAU;AAAA,IACjC,aAAa;AAAA,IACb,WAAW;AAAA,EACb;AACF;AAEA,eAAsB,sBAAsB;AAAA,EAC1C;AAAA,EACA;AACF,GAG0B;AACxB,aAAO,mCAAqB,EAAE,GAAG,OAAO,UAAU,GAAG,QAAQ,CAAC;AAChE;AAEA,eAAsB,qBACpB,YACsB;AACtB,aAAO,kCAAoB,OAAO,UAAU,CAAC;AAC/C;AAEA,eAAsB,sBACpB,YACkB;AAClB,aAAO,oCAAsB;AAAA,IAC3B;AAAA,IACA,OAAO;AAAA,IACP,UAAU;AAAA,EACZ,CAAC;AACH;AAEA,eAAsB,qBACpB,YACkB;AAClB,aAAO,gCAAkB,OAAO,UAAU,CAAC;AAC7C;AAMA,eAAsB,qBAAqB;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AACF,GAIqB;AACnB,QAAM,SAAS,MAAM,sBAAsB;AAAA,IACzC,aAAS,uCAAsB,aAAa;AAAA,IAC5C;AAAA,EACF,CAAC;AACD,SAAO,eAAe,OAAO;AAC7B,SAAO,OAAO;AAChB;",
+  "names": []
+}

package/dist/cjs/cli/lib/{ai → aiFiles}/config.js

@@ -28,10 +28,11 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var config_exports = {};
 __export(config_exports, {
-  aiFilesSchema: () => aiFilesSchema,
+  aiFilesStateSchema: () => aiFilesStateSchema,
+  hasAiFilesConfig: () => hasAiFilesConfig,
   readAiConfig: () => readAiConfig,
   writeAiConfig: () => writeAiConfig,
-  writeAiDisabledToProjectConfig: () => writeAiDisabledToProjectConfig
+  writeAiEnabledToProjectConfig: () => writeAiEnabledToProjectConfig
 });
 module.exports = __toCommonJS(config_exports);
 var Sentry = __toESM(require("@sentry/node"), 1);
@@ -39,6 +40,7 @@ var import_fs = require("fs");
 var import_path = __toESM(require("path"), 1);
 var import_zod = require("zod");
 var import_paths = require("./paths.js");
+var import_utils = require("./utils.js");
 const aiFilesStateSchema = import_zod.z.object({
   guidelinesHash: import_zod.z.string().nullable(),
   agentsMdSectionHash: import_zod.z.string().nullable(),
@@ -52,10 +54,15 @@ const aiFilesStateSchema = import_zod.z.object({
 });
 const aiFilesProjectConfigSchema = import_zod.z.object({
   aiFiles: import_zod.z.object({
-    disableStalenessMessage: import_zod.z.boolean().default(false)
-  }).default({ disableStalenessMessage: false })
+    // `enabled` is the canonical field. When present it takes full
+    // precedence - `enabled: true` will re-enable even if the legacy
+    // disableStalenessMessage field is still `true` in the file.
+    enabled: import_zod.z.boolean().optional(),
+    // @deprecated - use `enabled` instead. Read for backward compat;
+    // new writes always emit `enabled` and drop this key.
+    disableStalenessMessage: import_zod.z.boolean().optional()
+  }).default({})
 }).passthrough();
-const aiFilesSchema = aiFilesStateSchema;
 const EMPTY_AI_STATE = {
   guidelinesHash: null,
   agentsMdSectionHash: null,
@@ -63,64 +70,85 @@ const EMPTY_AI_STATE = {
   agentSkillsSha: null,
   installedSkillNames: []
 };
-async function readAiDisabledFromProjectConfig(projectDir) {
-  let raw;
-  try {
-    raw = await import_fs.promises.readFile(import_path.default.join(projectDir, "convex.json"), "utf8");
-  } catch {
-    return false;
-  }
+async function readAiEnabledFromProjectConfig(projectDir) {
+  const raw = await (0, import_utils.readFileSafe)(import_path.default.join(projectDir, "convex.json"));
+  if (raw === null) return true;
   try {
     const parsed = aiFilesProjectConfigSchema.parse(JSON.parse(raw));
-    return parsed.aiFiles.disableStalenessMessage;
+    if (parsed.aiFiles.enabled !== void 0) return parsed.aiFiles.enabled;
+    return !(parsed.aiFiles.disableStalenessMessage ?? false);
   } catch (err) {
     Sentry.captureException(err);
-    return false;
+    return true;
   }
 }
-async function writeAiDisabledToProjectConfig(disableStalenessMessage, projectDir) {
+async function writeAiEnabledToProjectConfig({
+  projectDir,
+  enabled
+}) {
   const filePath = import_path.default.join(projectDir, "convex.json");
-  let existing = {};
-  try {
-    existing = JSON.parse(await import_fs.promises.readFile(filePath, "utf8"));
-  } catch {
-  }
+  const existing = await (0, import_utils.iife)(async () => {
+    try {
+      return JSON.parse(await import_fs.promises.readFile(filePath, "utf8"));
+    } catch {
+      return {};
+    }
+  });
   const base = existing !== null && typeof existing === "object" && !Array.isArray(existing) ? existing : {};
   const aiFilesValue = base.aiFiles !== null && typeof base.aiFiles === "object" && !Array.isArray(base.aiFiles) ? base.aiFiles : {};
   const { $schema, ...rest } = base;
+  const { disableStalenessMessage: _legacy, ...restAiFiles } = aiFilesValue;
   const next = {
     $schema: $schema ?? "node_modules/convex/schemas/convex.schema.json",
     ...rest,
-    aiFiles: {
-      ...aiFilesValue,
-      disableStalenessMessage
-    }
+    aiFiles: { ...restAiFiles, enabled }
   };
   await import_fs.promises.writeFile(filePath, JSON.stringify(next, null, 2) + "\n", "utf8");
 }
-async function readAiConfig(projectDir, convexDir) {
-  const disableStalenessMessage = await readAiDisabledFromProjectConfig(projectDir);
-  let rawState;
-  try {
-    rawState = await import_fs.promises.readFile(
-      (0, import_paths.aiFilesStatePathForConvexDir)(convexDir),
-      "utf8"
-    );
-  } catch {
-    return disableStalenessMessage ? { ...EMPTY_AI_STATE, disableStalenessMessage } : null;
+async function readAiConfig({
+  projectDir,
+  convexDir
+}) {
+  const enabled = await readAiEnabledFromProjectConfig(projectDir);
+  const rawState = await (0, import_utils.readFileSafe)((0, import_paths.aiFilesStatePathForConvexDir)(convexDir));
+  if (rawState === null) {
+    return !enabled ? { ...EMPTY_AI_STATE, enabled } : null;
   }
   try {
     const state = aiFilesStateSchema.parse(JSON.parse(rawState));
-    return {
-      ...state,
-      disableStalenessMessage
-    };
+    return { ...state, enabled };
   } catch (err) {
     Sentry.captureException(err);
     return null;
   }
 }
-async function writeAiConfig(config, projectDir, convexDir, options) {
+async function hasAiFilesConfig({
+  projectDir,
+  convexDir
+}) {
+  if (!await readAiEnabledFromProjectConfig(projectDir)) {
+    return true;
+  }
+  try {
+    const rawState = await import_fs.promises.readFile(
+      (0, import_paths.aiFilesStatePathForConvexDir)(convexDir),
+      "utf8"
+    );
+    aiFilesStateSchema.parse(JSON.parse(rawState));
+    return true;
+  } catch (err) {
+    if (err.code !== "ENOENT") {
+      Sentry.captureException(err);
+    }
+    return false;
+  }
+}
+async function writeAiConfig({
+  config,
+  projectDir,
+  convexDir,
+  options
+}) {
   const state = aiFilesStateSchema.parse({
     guidelinesHash: config.guidelinesHash,
     agentsMdSectionHash: config.agentsMdSectionHash,
@@ -133,12 +161,11 @@ async function writeAiConfig(config, projectDir, convexDir, options) {
     JSON.stringify(state, null, 2) + "\n",
     "utf8"
   );
-  const persistMode = options?.persistDisabledPreference ?? "ifTrue";
-  if (persistMode === "always" || persistMode === "ifTrue" && config.disableStalenessMessage) {
-    await writeAiDisabledToProjectConfig(
-      config.disableStalenessMessage,
-      projectDir
-    );
-  }
+  const persistMode = options?.persistEnabledPreference ?? "ifFalse";
+  if (persistMode === "always" || persistMode === "ifFalse" && !config.enabled)
+    await writeAiEnabledToProjectConfig({
+      projectDir,
+      enabled: config.enabled
+    });
 }
 //# sourceMappingURL=config.js.map

package/dist/cjs/cli/lib/aiFiles/config.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/cli/lib/aiFiles/config.ts"],
+  "sourcesContent": ["import * as Sentry from \"@sentry/node\";\n// Use raw fs (not ctx.fs) so these operations run asynchronously and don't\n// interfere with the file-watcher used by `convex dev`.\n// eslint-disable-next-line no-restricted-imports\nimport { promises as fs } from \"fs\";\nimport path from \"path\";\nimport { z } from \"zod\";\nimport { aiFilesStatePathForConvexDir } from \"./paths.js\";\nimport { iife, readFileSafe } from \"./utils.js\";\n\nexport const aiFilesStateSchema = z.object({\n  guidelinesHash: z.string().nullable(),\n  agentsMdSectionHash: z.string().nullable(),\n  claudeMdHash: z.string().nullable(),\n  // Commit SHA from get-convex/agent-skills that was current when skills were\n  // last installed. Used to detect when newer skills are available.\n  agentSkillsSha: z.string().nullable(),\n  // Names of skills installed by `npx skills add`, used by `remove` to\n  // only remove Convex-managed skills.\n  installedSkillNames: z.array(z.string()).default([]),\n});\n\nconst aiFilesProjectConfigSchema = z\n  .object({\n    aiFiles: z\n      .object({\n        // `enabled` is the canonical field. When present it takes full\n        // precedence - `enabled: true` will re-enable even if the legacy\n        // disableStalenessMessage field is still `true` in the file.\n        enabled: z.boolean().optional(),\n        // @deprecated - use `enabled` instead. Read for backward compat;\n        // new writes always emit `enabled` and drop this key.\n        disableStalenessMessage: z.boolean().optional(),\n      })\n      .default({}),\n  })\n  .passthrough();\n\ntype AiFilesState = z.infer<typeof aiFilesStateSchema>;\nexport type AiFilesConfig = AiFilesState & {\n  enabled: boolean;\n};\n\nconst EMPTY_AI_STATE: AiFilesState = {\n  guidelinesHash: null,\n  agentsMdSectionHash: null,\n  claudeMdHash: null,\n  agentSkillsSha: null,\n  installedSkillNames: [],\n};\n\nasync function readAiEnabledFromProjectConfig(\n  projectDir: string,\n): Promise<boolean> {\n  const raw = await readFileSafe(path.join(projectDir, \"convex.json\"));\n  if (raw === null) return true;\n  try {\n    const parsed = aiFilesProjectConfigSchema.parse(JSON.parse(raw));\n    // `enabled` takes full precedence when explicitly set.\n    if (parsed.aiFiles.enabled !== undefined) return parsed.aiFiles.enabled;\n    // Legacy `disableStalenessMessage` - invert it.\n    return !(parsed.aiFiles.disableStalenessMessage ?? false);\n  } catch (err) {\n    Sentry.captureException(err);\n    return true;\n  }\n}\n\nexport async function writeAiEnabledToProjectConfig({\n  projectDir,\n  enabled,\n}: {\n  projectDir: string;\n  enabled: boolean;\n}): Promise<void> {\n  const filePath = path.join(projectDir, \"convex.json\");\n  const existing = await iife(async () => {\n    try {\n      return JSON.parse(await fs.readFile(filePath, \"utf8\")) as unknown;\n    } catch {\n      return {} as unknown;\n    }\n  });\n  const base =\n    existing !== null &&\n    typeof existing === \"object\" &&\n    !Array.isArray(existing)\n      ? (existing as Record<string, unknown>)\n      : {};\n  const aiFilesValue =\n    base.aiFiles !== null &&\n    typeof base.aiFiles === \"object\" &&\n    !Array.isArray(base.aiFiles)\n      ? (base.aiFiles as Record<string, unknown>)\n      : {};\n  const { $schema, ...rest } = base;\n  // Remove legacy keys on every write.\n  const { disableStalenessMessage: _legacy, ...restAiFiles } = aiFilesValue;\n  const next: Record<string, unknown> = {\n    $schema: $schema ?? \"node_modules/convex/schemas/convex.schema.json\",\n    ...rest,\n    aiFiles: { ...restAiFiles, enabled },\n  };\n  await fs.writeFile(filePath, JSON.stringify(next, null, 2) + \"\\n\", \"utf8\");\n}\n\nexport async function readAiConfig({\n  projectDir,\n  convexDir,\n}: {\n  projectDir: string;\n  convexDir: string;\n}): Promise<AiFilesConfig | null> {\n  const enabled = await readAiEnabledFromProjectConfig(projectDir);\n  const rawState = await readFileSafe(aiFilesStatePathForConvexDir(convexDir));\n  if (rawState === null) {\n    // No state file means AI files are not installed, unless the user has\n    // explicitly disabled in convex.json.\n    return !enabled ? { ...EMPTY_AI_STATE, enabled } : null;\n  }\n  try {\n    const state = aiFilesStateSchema.parse(JSON.parse(rawState));\n    return { ...state, enabled };\n  } catch (err) {\n    Sentry.captureException(err);\n    return null;\n  }\n}\n\nexport async function hasAiFilesConfig({\n  projectDir,\n  convexDir,\n}: {\n  projectDir: string;\n  convexDir: string;\n}): Promise<boolean> {\n  if (!(await readAiEnabledFromProjectConfig(projectDir))) {\n    return true;\n  }\n  try {\n    const rawState = await fs.readFile(\n      aiFilesStatePathForConvexDir(convexDir),\n      \"utf8\",\n    );\n    aiFilesStateSchema.parse(JSON.parse(rawState));\n    return true;\n  } catch (err) {\n    if ((err as NodeJS.ErrnoException).code !== \"ENOENT\") {\n      Sentry.captureException(err);\n    }\n    return false;\n  }\n}\n\nexport async function writeAiConfig({\n  config,\n  projectDir,\n  convexDir,\n  options,\n}: {\n  config: AiFilesConfig;\n  projectDir: string;\n  convexDir: string;\n  options?: { persistEnabledPreference?: \"ifFalse\" | \"always\" | \"never\" };\n}): Promise<void> {\n  const state = aiFilesStateSchema.parse({\n    guidelinesHash: config.guidelinesHash,\n    agentsMdSectionHash: config.agentsMdSectionHash,\n    claudeMdHash: config.claudeMdHash,\n    agentSkillsSha: config.agentSkillsSha,\n    installedSkillNames: config.installedSkillNames,\n  });\n  await fs.writeFile(\n    aiFilesStatePathForConvexDir(convexDir),\n    JSON.stringify(state, null, 2) + \"\\n\",\n    \"utf8\",\n  );\n\n  const persistMode = options?.persistEnabledPreference ?? \"ifFalse\";\n  if (\n    persistMode === \"always\" ||\n    (persistMode === \"ifFalse\" && !config.enabled)\n  )\n    await writeAiEnabledToProjectConfig({\n      projectDir,\n      enabled: config.enabled,\n    });\n}\n"],
+  "mappings": "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",
+  "names": ["path", "fs"]
+}

package/dist/cjs/cli/lib/aiFiles/cursorrules.js

@@ -0,0 +1,48 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var cursorrules_exports = {};
+__export(cursorrules_exports, {
+  removeLegacyCursorRulesFile: () => removeLegacyCursorRulesFile
+});
+module.exports = __toCommonJS(cursorrules_exports);
+var import_path = __toESM(require("path"), 1);
+var import_chalk = require("chalk");
+var import_log = require("../../../bundler/log.js");
+var import_utils = require("./utils.js");
+async function removeLegacyCursorRulesFile(projectDir) {
+  const removed = await (0, import_utils.safelyDeleteFile)(
+    import_path.default.join(projectDir, ".cursor", "rules", "convex_rules.mdc")
+  );
+  if (removed)
+    (0, import_log.logMessage)(
+      `${import_chalk.chalkStderr.green("\u2714")} Removed legacy .cursor/rules/convex_rules.mdc (superseded by convex/_generated/ai/guidelines.md).`
+    );
+  return removed;
+}
+//# sourceMappingURL=cursorrules.js.map

package/dist/cjs/cli/lib/aiFiles/cursorrules.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/cli/lib/aiFiles/cursorrules.ts"],
+  "sourcesContent": ["import path from \"path\";\nimport { chalkStderr } from \"chalk\";\nimport { logMessage } from \"../../../bundler/log.js\";\nimport { safelyDeleteFile } from \"./utils.js\";\n\n/**\n * Remove the legacy `.cursor/rules/convex_rules.mdc` file if it exists.\n * This file was written by the old cursor rules auto-update feature (removed\n * in favour of the AI files system). We clean it up unconditionally\n * during `writeAiFiles`, `convex ai-files update`, and `convex ai-files remove`\n * since it was always auto-managed and is now superseded by\n * `convex/_generated/ai/guidelines.md`.\n */\nexport async function removeLegacyCursorRulesFile(\n  projectDir: string,\n): Promise<boolean> {\n  const removed = await safelyDeleteFile(\n    path.join(projectDir, \".cursor\", \"rules\", \"convex_rules.mdc\"),\n  );\n  if (removed)\n    logMessage(\n      `${chalkStderr.green(\"\u2714\")} Removed legacy .cursor/rules/convex_rules.mdc (superseded by convex/_generated/ai/guidelines.md).`,\n    );\n  return removed;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAAiB;AACjB,mBAA4B;AAC5B,iBAA2B;AAC3B,mBAAiC;AAUjC,eAAsB,4BACpB,YACkB;AAClB,QAAM,UAAU,UAAM;AAAA,IACpB,YAAAA,QAAK,KAAK,YAAY,WAAW,SAAS,kBAAkB;AAAA,EAC9D;AACA,MAAI;AACF;AAAA,MACE,GAAG,yBAAY,MAAM,QAAG,CAAC;AAAA,IAC3B;AACF,SAAO;AACT;",
+  "names": ["path"]
+}