convex 1.48.0-alpha.0 → 1.48.0

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/cli/configure.ts"],
-  "sourcesContent": ["import { chalkStderr } from \"chalk\";\nimport { handleNoAccessToConfiguredProject } from \"./account.js\";\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, ensureConvexFunctionsDir } 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 { attemptSetupAiFiles } 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 { fetchDeploymentCanonicalUrls } from \"./lib/deploy2.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 | undefined;\n      site: number | undefined;\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  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 init`\n *\n * But is not used by `npx convex deploy`, `npx convex codegen`,\n * `npx convex env`, 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      reference: string | null;\n      isDefault: boolean;\n    } | null;\n  }\n> {\n  const selectedDeployment = await _deploymentCredentialsOrConfigure(\n    ctx,\n    deploymentSelection,\n    chosenConfiguration,\n    cmdOptions,\n  );\n  const { convexCloudUrl, convexSiteUrl: siteUrl } =\n    await fetchDeploymentCanonicalUrls(ctx, {\n      adminKey: selectedDeployment.adminKey,\n      deploymentUrl: selectedDeployment.url,\n    });\n  const applicationUrl = deploymentUrlForApplicationEnv(\n    selectedDeployment,\n    convexCloudUrl,\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: applicationUrl,\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 function deploymentUrlForApplicationEnv(\n  selectedDeployment: {\n    url: string;\n    deploymentFields: { deploymentType: DeploymentType } | null;\n  },\n  canonicalCloudUrl: string,\n): string {\n  const deploymentType = selectedDeployment.deploymentFields?.deploymentType;\n  return deploymentType !== undefined &&\n    deploymentType !== \"local\" &&\n    deploymentType !== \"anonymous\"\n    ? canonicalCloudUrl\n    : selectedDeployment.url;\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      reference: string | null;\n      isDefault: boolean;\n    } | null;\n  }\n> {\n  switch (deploymentSelection.kind) {\n    case \"existingDeployment\":\n      await assertLocalOptionsAreDefault(ctx, cmdOptions.localOptions);\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        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      });\n    }\n    case \"anonymous\": {\n      const hasAuth = ctx.bigBrainAuth() !== null;\n      const isAgentMode = process.env.CONVEX_AGENT_MODE === \"anonymous\";\n      if (\n        !isAgentMode &&\n        process.stdin.isTTY &&\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 handleChooseProject(\n            ctx,\n            chosenConfiguration,\n            deploymentSelection.selectionWithinProject,\n            cmdOptions,\n          );\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 =\n        isAgentMode || !process.stdin.isTTY\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            reference: null,\n            isDefault: false,\n          },\n        };\n      }\n      return await handleChooseProject(\n        ctx,\n        chosenConfiguration,\n        deploymentSelection.selectionWithinProject,\n        cmdOptions,\n      );\n    }\n  }\n}\n\nasync function handleDeploymentWithinProject(\n  ctx: Context,\n  {\n    chosenConfiguration,\n    deploymentSelection,\n    cmdOptions,\n  }: {\n    chosenConfiguration: ChosenConfiguration;\n    deploymentSelection: DeploymentSelection & {\n      kind: \"deploymentWithinProject\";\n    };\n    cmdOptions: ConfigureCmdOptions;\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      cmdOptions,\n    );\n    return result;\n  }\n\n  let accessResult = await checkAccessToSelectedProject(\n    ctx,\n    deploymentSelection.targetProject,\n  );\n  while (accessResult.kind === \"noAccess\") {\n    const next =\n      cmdOptions.team !== undefined && cmdOptions.project !== undefined\n        ? \"chooseProject\"\n        : await handleNoAccessToConfiguredProject(\n            ctx,\n            deploymentSelection.targetProject,\n            cmdOptions.envFile,\n          );\n    if (next === \"retry\") {\n      accessResult = await checkAccessToSelectedProject(\n        ctx,\n        deploymentSelection.targetProject,\n      );\n      continue;\n    }\n    logMessage(\"You don't have access to the selected project.\");\n    const result = await handleChooseProject(\n      ctx,\n      chosenConfiguration,\n      deploymentSelection.selectionWithinProject,\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  await assertLocalOptionsAreDefault(ctx, cmdOptions.localOptions);\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  cmdOptions: ConfigureCmdOptions,\n): Promise<\n  DeploymentCredentials & {\n    deploymentFields: {\n      deploymentName: DeploymentName;\n      deploymentType: DeploymentType;\n      projectSlug: string;\n      teamSlug: string;\n      reference: string | null;\n      isDefault: boolean;\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  });\n  if (\n    selectionWithinProject.kind === \"prod\" ||\n    project.devDeployment !== \"local\"\n  ) {\n    await assertLocalOptionsAreDefault(ctx, cmdOptions.localOptions);\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    reference,\n    isDefault,\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      reference,\n      isDefault,\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    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    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  });\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;\n  try {\n    ({ projectSlug } = await createProject(ctx, {\n      teamId: selectedTeam.id,\n      projectName,\n      deploymentToProvision,\n    }));\n  } catch (err) {\n    logFailure(\"Unable to create project.\");\n    return await logAndHandleFetchError(ctx, err);\n  }\n  const teamSlug = selectedTeam.slug;\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  await doInitConvexFolder(ctx);\n  const { configPath, projectConfig } = await readProjectConfig(ctx);\n  const folder = functionsDir(configPath, projectConfig);\n  await attemptSetupAiFiles({\n    ctx,\n    aiFilesConfig: projectConfig.aiFiles,\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  },\n): Promise<{\n  teamSlug: string;\n  projectSlug: string;\n  devDeployment: \"cloud\" | \"local\";\n}> {\n  const {\n    team: { id: teamId, slug: teamSlug },\n    chosen,\n  } = await validateOrSelectTeam(ctx, config.team, \"Team:\");\n\n  const projectSlug = await validateOrSelectProject(\n    ctx,\n    config.project,\n    teamId,\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  });\n\n  logFinishedStep(`Reinitialized project ${chalkStderr.bold(projectSlug)}`);\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        cloud: number | undefined;\n        site: number | undefined;\n      };\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 credentials;\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    options.deploymentType !== \"prod\"\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      : { wroteToGitIgnore: false, changedDeploymentEnvVar: false };\n  await ensureConvexFunctionsDir(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\nasync function assertLocalOptionsAreDefault(\n  ctx: Context,\n  localOptions: ConfigureCmdOptions[\"localOptions\"],\n) {\n  if (localOptions.ports.cloud !== undefined) {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage:\n        \"`--local-cloud-port` can only be used when developing with a local deployment. \" +\n        \"Use `npx convex deployment select local` to use a local deployment.\",\n    });\n  }\n  if (localOptions.ports.site !== undefined) {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage:\n        \"`--local-site-port` can only be used when developing with a local deployment. \" +\n        \"Use `npx convex deployment select local` to use a local deployment.\",\n    });\n  }\n  if (localOptions.backendVersion !== undefined) {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage:\n        \"`--local-backend-version` can only be used when developing with a local deployment. \" +\n        \"Use `npx convex deployment select local` to use a local deployment.\",\n    });\n  }\n  if (localOptions.dashboardVersion !== undefined) {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage:\n        \"`--local-dashboard-version` can only be used when developing with a local deployment. \" +\n        \"Use `npx convex deployment select local` to use a local deployment.\",\n    });\n  }\n  if (localOptions.forceUpgrade === true) {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage:\n        \"`--local-force-upgrade` can only be used when developing with a local deployment. \" +\n        \"Use `npx convex deployment select local` to use a local deployment.\",\n    });\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, ensureConvexFunctionsDir } 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 { attemptSetupAiFiles } 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 { fetchDeploymentCanonicalUrls } from \"./lib/deploy2.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 | undefined;\n      site: number | undefined;\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  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 init`\n *\n * But is not used by `npx convex deploy`, `npx convex codegen`,\n * `npx convex env`, 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      reference: string | null;\n      isDefault: boolean;\n    } | null;\n  }\n> {\n  const selectedDeployment = await _deploymentCredentialsOrConfigure(\n    ctx,\n    deploymentSelection,\n    chosenConfiguration,\n    cmdOptions,\n  );\n  const { convexCloudUrl, convexSiteUrl: siteUrl } =\n    await fetchDeploymentCanonicalUrls(ctx, {\n      adminKey: selectedDeployment.adminKey,\n      deploymentUrl: selectedDeployment.url,\n    });\n  const applicationUrl = deploymentUrlForApplicationEnv(\n    selectedDeployment,\n    convexCloudUrl,\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: applicationUrl,\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 function deploymentUrlForApplicationEnv(\n  selectedDeployment: {\n    url: string;\n    deploymentFields: { deploymentType: DeploymentType } | null;\n  },\n  canonicalCloudUrl: string,\n): string {\n  const deploymentType = selectedDeployment.deploymentFields?.deploymentType;\n  return deploymentType !== undefined &&\n    deploymentType !== \"local\" &&\n    deploymentType !== \"anonymous\"\n    ? canonicalCloudUrl\n    : selectedDeployment.url;\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      reference: string | null;\n      isDefault: boolean;\n    } | null;\n  }\n> {\n  switch (deploymentSelection.kind) {\n    case \"existingDeployment\":\n      await assertLocalOptionsAreDefault(ctx, cmdOptions.localOptions);\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        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      });\n    }\n    case \"anonymous\": {\n      const hasAuth = ctx.bigBrainAuth() !== null;\n      const isAgentMode = process.env.CONVEX_AGENT_MODE === \"anonymous\";\n      if (\n        !isAgentMode &&\n        process.stdin.isTTY &&\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 handleChooseProject(\n            ctx,\n            chosenConfiguration,\n            deploymentSelection.selectionWithinProject,\n            cmdOptions,\n          );\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 =\n        isAgentMode || !process.stdin.isTTY\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            reference: null,\n            isDefault: false,\n          },\n        };\n      }\n      return await handleChooseProject(\n        ctx,\n        chosenConfiguration,\n        deploymentSelection.selectionWithinProject,\n        cmdOptions,\n      );\n    }\n  }\n}\n\nasync function handleDeploymentWithinProject(\n  ctx: Context,\n  {\n    chosenConfiguration,\n    deploymentSelection,\n    cmdOptions,\n  }: {\n    chosenConfiguration: ChosenConfiguration;\n    deploymentSelection: DeploymentSelection & {\n      kind: \"deploymentWithinProject\";\n    };\n    cmdOptions: ConfigureCmdOptions;\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      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      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  await assertLocalOptionsAreDefault(ctx, cmdOptions.localOptions);\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  cmdOptions: ConfigureCmdOptions,\n): Promise<\n  DeploymentCredentials & {\n    deploymentFields: {\n      deploymentName: DeploymentName;\n      deploymentType: DeploymentType;\n      projectSlug: string;\n      teamSlug: string;\n      reference: string | null;\n      isDefault: boolean;\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  });\n  if (\n    selectionWithinProject.kind === \"prod\" ||\n    project.devDeployment !== \"local\"\n  ) {\n    await assertLocalOptionsAreDefault(ctx, cmdOptions.localOptions);\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    reference,\n    isDefault,\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      reference,\n      isDefault,\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    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    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  });\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;\n  try {\n    ({ projectSlug } = await createProject(ctx, {\n      teamId: selectedTeam.id,\n      projectName,\n      deploymentToProvision,\n    }));\n  } catch (err) {\n    logFailure(\"Unable to create project.\");\n    return await logAndHandleFetchError(ctx, err);\n  }\n  const teamSlug = selectedTeam.slug;\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  await doInitConvexFolder(ctx);\n  const { configPath, projectConfig } = await readProjectConfig(ctx);\n  const folder = functionsDir(configPath, projectConfig);\n  await attemptSetupAiFiles({\n    ctx,\n    aiFilesConfig: projectConfig.aiFiles,\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  },\n): Promise<{\n  teamSlug: string;\n  projectSlug: string;\n  devDeployment: \"cloud\" | \"local\";\n}> {\n  const {\n    team: { id: teamId, slug: teamSlug },\n    chosen,\n  } = await validateOrSelectTeam(ctx, config.team, \"Team:\");\n\n  const projectSlug = await validateOrSelectProject(\n    ctx,\n    config.project,\n    teamId,\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  });\n\n  logFinishedStep(`Reinitialized project ${chalkStderr.bold(projectSlug)}`);\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        cloud: number | undefined;\n        site: number | undefined;\n      };\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 credentials;\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    options.deploymentType !== \"prod\"\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      : { wroteToGitIgnore: false, changedDeploymentEnvVar: false };\n  await ensureConvexFunctionsDir(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\nasync function assertLocalOptionsAreDefault(\n  ctx: Context,\n  localOptions: ConfigureCmdOptions[\"localOptions\"],\n) {\n  if (localOptions.ports.cloud !== undefined) {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage:\n        \"`--local-cloud-port` can only be used when developing with a local deployment. \" +\n        \"Use `npx convex deployment select local` to use a local deployment.\",\n    });\n  }\n  if (localOptions.ports.site !== undefined) {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage:\n        \"`--local-site-port` can only be used when developing with a local deployment. \" +\n        \"Use `npx convex deployment select local` to use a local deployment.\",\n    });\n  }\n  if (localOptions.backendVersion !== undefined) {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage:\n        \"`--local-backend-version` can only be used when developing with a local deployment. \" +\n        \"Use `npx convex deployment select local` to use a local deployment.\",\n    });\n  }\n  if (localOptions.dashboardVersion !== undefined) {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage:\n        \"`--local-dashboard-version` can only be used when developing with a local deployment. \" +\n        \"Use `npx convex deployment select local` to use a local deployment.\",\n    });\n  }\n  if (localOptions.forceUpgrade === true) {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage:\n        \"`--local-force-upgrade` can only be used when developing with a local deployment. \" +\n        \"Use `npx convex deployment select local` to use a local deployment.\",\n    });\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/esm/cli/env.js

@@ -119,7 +119,9 @@ const envListCmd = new Command("list").summary("List all environment variables a
     "\u2022 List only variable names (no values): `npx convex env list --names-only`",
     "\u2022 List all variables and their values: `npx convex env list --include-values`",
     "\u2022 Save all variables to a file: `npx convex env list --include-values > .env.convex`",
-    "\u2022 Append to a file: `npx convex env list --include-values >> .env.convex`"
+    "\u2022 Append to a file: `npx convex env list --include-values >> .env.convex`",
+    "",
+    "When an AI agent runs this command (detected from environment variables like AI_AGENT or CLAUDECODE), only names are listed unless --include-values is passed."
   ].join("\n")
 ).option(
   "--names-only",
@@ -127,7 +129,7 @@ const envListCmd = new Command("list").summary("List all environment variables a
 ).addOption(
   new Option(
     "--include-values",
-    "Print each variable's value alongside its name, in .env format (the default). Pass it explicitly in scripts that rely on the values."
+    "Print each variable's value alongside its name, in .env format. This is the default unless an AI agent is detected, so pass it explicitly in scripts that rely on the values."
   ).conflicts("namesOnly")
 ).configureHelp({ showGlobalOptions: true }).allowExcessArguments(false).action(async (cmdOptions, cmd) => {
   const options = cmd.optsWithGlobals();
@@ -139,7 +141,8 @@ const envListCmd = new Command("list").summary("List all environment variables a
     action: async () => {
       const backend = deploymentEnvBackend(ctx, deployment);
       await envList(ctx, backend, {
-        namesOnly: cmdOptions.namesOnly ?? false
+        namesOnly: cmdOptions.namesOnly ?? false,
+        includeValues: cmdOptions.includeValues ?? false
       });
     }
   });

package/dist/esm/cli/env.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/cli/env.ts"],
-  "sourcesContent": ["import { Command, Option } from \"@commander-js/extra-typings\";\nimport { chalkStderr } from \"chalk\";\nimport { Context, oneoffContext } from \"../bundler/context.js\";\nimport {\n  DeploymentSelectionOptions,\n  DetailedDeploymentCredentials,\n  loadSelectedDeploymentCredentials,\n} from \"./lib/api.js\";\nimport { actionDescription } from \"./lib/command.js\";\nimport { ensureHasConvexDependency } from \"./lib/utils/utils.js\";\nimport {\n  deploymentEnvBackend,\n  envGet,\n  envList,\n  envRemove,\n  envSet,\n} from \"./lib/env.js\";\nimport { getDeploymentSelection } from \"./lib/deploymentSelection.js\";\nimport { withRunningBackend } from \"./lib/localDeployment/run.js\";\nimport { envDefault } from \"./envDefault.js\";\n\nconst envSetCmd = new Command(\"set\")\n  // Pretend value is required\n  .usage(\"[options] <name> <value>\")\n  .argument(\"[name]\", \"The name of the environment variable to set.\")\n  .argument(\n    \"[value]\",\n    \"The value to set the variable to. Omit to set it interactively.\",\n  )\n  .summary(\"Set a variable\")\n  .description(\n    [\n      \"Set environment variables on your deployment.\",\n      \"\",\n      \"\u2022 `npx convex env set NAME 'value'`\",\n      \"\u2022 `npx convex env set NAME # omit a value to set one interactively`\",\n      \"\u2022 `npx convex env set NAME --from-file value.txt`\",\n      \"\u2022 `npx convex env set --from-file .env.defaults`\",\n      \"\",\n      \"When setting multiple values, it will refuse all changes if any variables are already set to different values by default. Pass --force to overwrite the provided values.\",\n      \"\",\n      \"To keep secrets out of your shell history, omit the value to pipe it in via stdin, for instance:\",\n      \"\u2022 `pbpaste | npx convex env set API_KEY` (macOS)\",\n      \"\u2022 `Get-Clipboard | npx convex env set API_KEY` (Windows PowerShell)\",\n      \"\",\n      \"To update many variables at once, save them with `npx convex env list --include-values > .env.convex`, edit the file, then reapply the changes with `npx convex env set --force < .env.convex`.\",\n    ].join(\"\\n\"),\n  )\n  .option(\n    \"--from-file <file>\",\n    \"Read environment variables from a .env file. Without --force, fails if any existing variable has a different value.\",\n  )\n  .option(\n    \"--force\",\n    \"When setting multiple variables, overwrite existing environment variable values instead of failing on mismatch.\",\n  )\n  .configureHelp({ showGlobalOptions: true })\n  .allowExcessArguments(false)\n  .action(async (name, value, cmdOptions, cmd) => {\n    // Note: We use `as` here because optsWithGlobals() type inference doesn't\n    // include global options from the parent command (added via addDeploymentSelectionOptions)\n    const options = cmd.optsWithGlobals() as DeploymentSelectionOptions;\n    const { ctx, deployment } = await selectEnvDeployment(options);\n    await ensureHasConvexDependency(ctx, \"env set\");\n    await withRunningBackend({\n      ctx,\n      deployment,\n      action: async () => {\n        const backend = deploymentEnvBackend(ctx, deployment);\n        const didAnything = await envSet(ctx, backend, name, value, cmdOptions);\n        if (didAnything === false) {\n          cmd.outputHelp({ error: true });\n          return await ctx.crash({\n            exitCode: 1,\n            errorType: \"fatal\",\n            printedMessage:\n              \"error: No environment variables specified to be set.\",\n          });\n        }\n      },\n    });\n  });\n\nexport async function selectEnvDeployment(\n  options: DeploymentSelectionOptions,\n): Promise<{\n  ctx: Context;\n  deployment: {\n    deploymentUrl: string;\n    adminKey: string;\n    deploymentNotice: string;\n    deploymentFields: DetailedDeploymentCredentials[\"deploymentFields\"];\n  };\n}> {\n  const ctx = await oneoffContext(options);\n  const deploymentSelection = await getDeploymentSelection(ctx, options);\n  const {\n    adminKey,\n    url: deploymentUrl,\n    deploymentFields,\n  } = await loadSelectedDeploymentCredentials(ctx, deploymentSelection, {\n    ensureLocalRunning: false,\n  });\n\n  const deploymentNotice =\n    deploymentFields !== null\n      ? ` (on ${chalkStderr.bold(deploymentFields.deploymentType)} deployment ${chalkStderr.bold(deploymentFields.deploymentName)})`\n      : \"\";\n  const result = {\n    ctx,\n    deployment: {\n      deploymentUrl,\n      adminKey,\n      deploymentNotice,\n      deploymentFields,\n    },\n  };\n  return result;\n}\n\nconst envGetCmd = new Command(\"get\")\n  .argument(\"<name>\", \"The name of the environment variable to print.\")\n  .summary(\"Print a variable's value\")\n  .description(\"Print a variable's value: `npx convex env get NAME`\")\n  .configureHelp({ showGlobalOptions: true })\n  .allowExcessArguments(false)\n  .action(async (envVarName, _options, cmd) => {\n    const options = cmd.optsWithGlobals();\n    const { ctx, deployment } = await selectEnvDeployment(options);\n    await ensureHasConvexDependency(ctx, \"env get\");\n    await withRunningBackend({\n      ctx,\n      deployment,\n      action: async () => {\n        const backend = deploymentEnvBackend(ctx, deployment);\n        await envGet(ctx, backend, envVarName);\n      },\n    });\n  });\n\nconst envRemoveCmd = new Command(\"remove\")\n  .alias(\"rm\")\n  .alias(\"unset\")\n  .argument(\"<name>\", \"The name of the environment variable to unset.\")\n  .summary(\"Unset a variable\")\n  .description(\n    \"Unset a variable: `npx convex env remove NAME`\\n\" +\n      \"If the variable doesn't exist, the command doesn't do anything and succeeds.\",\n  )\n  .configureHelp({ showGlobalOptions: true })\n  .allowExcessArguments(false)\n  .action(async (name, _options, cmd) => {\n    const options = cmd.optsWithGlobals();\n    const { ctx, deployment } = await selectEnvDeployment(options);\n    await ensureHasConvexDependency(ctx, \"env remove\");\n    await withRunningBackend({\n      ctx,\n      deployment,\n      action: async () => {\n        const backend = deploymentEnvBackend(ctx, deployment);\n        await envRemove(ctx, backend, name);\n      },\n    });\n  });\n\nconst envListCmd = new Command(\"list\")\n  .summary(\"List all environment variables and their values\")\n  .description(\n    [\n      \"\u2022 List only variable names (no values): `npx convex env list --names-only`\",\n      \"\u2022 List all variables and their values: `npx convex env list --include-values`\",\n      \"\u2022 Save all variables to a file: `npx convex env list --include-values > .env.convex`\",\n      \"\u2022 Append to a file: `npx convex env list --include-values >> .env.convex`\",\n    ].join(\"\\n\"),\n  )\n  .option(\n    \"--names-only\",\n    \"List only the names of environment variables, without their values\",\n  )\n  .addOption(\n    new Option(\n      \"--include-values\",\n      \"Print each variable's value alongside its name, in .env format (the default). Pass it explicitly in scripts that rely on the values.\",\n    ).conflicts(\"namesOnly\"),\n  )\n  .configureHelp({ showGlobalOptions: true })\n  .allowExcessArguments(false)\n  .action(async (cmdOptions, cmd) => {\n    // Note: We use `as` here because optsWithGlobals() type inference doesn't\n    // include global options from the parent command (added via addDeploymentSelectionOptions)\n    const options = cmd.optsWithGlobals() as DeploymentSelectionOptions;\n    const { ctx, deployment } = await selectEnvDeployment(options);\n    await ensureHasConvexDependency(ctx, \"env list\");\n    await withRunningBackend({\n      ctx,\n      deployment,\n      action: async () => {\n        const backend = deploymentEnvBackend(ctx, deployment);\n        await envList(ctx, backend, {\n          namesOnly: cmdOptions.namesOnly ?? false,\n        });\n      },\n    });\n  });\n\nexport const env = new Command(\"env\")\n  .summary(\"Set and view environment variables\")\n  .description(\n    [\n      \"Set and view environment variables on your deployment\",\n      \"\",\n      \"\u2022 Set a variable: `npx convex env set NAME 'value'`\",\n      \"\u2022 Set interactively: `npx convex env set NAME`\",\n      \"\u2022 Set multiple from file: `npx convex env set --from-file .env`\",\n      \"\u2022 Unset a variable: `npx convex env remove NAME`\",\n      \"\u2022 List only variable names (no values): `npx convex env list --names-only`\",\n      \"\u2022 List all variables and their values: `npx convex env list --include-values`\",\n      \"\u2022 Print a variable's value: `npx convex env get NAME`\",\n      \"\",\n      \"By default, this sets and views variables on your dev deployment.\",\n      \"\",\n      \"See the environment variables guide (https://docs.convex.dev/production/environment-variables) to learn more.\",\n    ].join(\"\\n\"),\n  )\n  .addCommand(envSetCmd)\n  .addCommand(envGetCmd)\n  .addCommand(envRemoveCmd)\n  .addCommand(envListCmd)\n  .addCommand(envDefault)\n  .helpCommand(false)\n  .addDeploymentSelectionOptions(\n    actionDescription(\"Set and view environment variables on\"),\n  );\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { Command, Option } from \"@commander-js/extra-typings\";\nimport { chalkStderr } from \"chalk\";\nimport { Context, oneoffContext } from \"../bundler/context.js\";\nimport {\n  DeploymentSelectionOptions,\n  DetailedDeploymentCredentials,\n  loadSelectedDeploymentCredentials,\n} from \"./lib/api.js\";\nimport { actionDescription } from \"./lib/command.js\";\nimport { ensureHasConvexDependency } from \"./lib/utils/utils.js\";\nimport {\n  deploymentEnvBackend,\n  envGet,\n  envList,\n  envRemove,\n  envSet,\n} from \"./lib/env.js\";\nimport { getDeploymentSelection } from \"./lib/deploymentSelection.js\";\nimport { withRunningBackend } from \"./lib/localDeployment/run.js\";\nimport { envDefault } from \"./envDefault.js\";\n\nconst envSetCmd = new Command(\"set\")\n  // Pretend value is required\n  .usage(\"[options] <name> <value>\")\n  .argument(\"[name]\", \"The name of the environment variable to set.\")\n  .argument(\n    \"[value]\",\n    \"The value to set the variable to. Omit to set it interactively.\",\n  )\n  .summary(\"Set a variable\")\n  .description(\n    [\n      \"Set environment variables on your deployment.\",\n      \"\",\n      \"\u2022 `npx convex env set NAME 'value'`\",\n      \"\u2022 `npx convex env set NAME # omit a value to set one interactively`\",\n      \"\u2022 `npx convex env set NAME --from-file value.txt`\",\n      \"\u2022 `npx convex env set --from-file .env.defaults`\",\n      \"\",\n      \"When setting multiple values, it will refuse all changes if any variables are already set to different values by default. Pass --force to overwrite the provided values.\",\n      \"\",\n      \"To keep secrets out of your shell history, omit the value to pipe it in via stdin, for instance:\",\n      \"\u2022 `pbpaste | npx convex env set API_KEY` (macOS)\",\n      \"\u2022 `Get-Clipboard | npx convex env set API_KEY` (Windows PowerShell)\",\n      \"\",\n      \"To update many variables at once, save them with `npx convex env list --include-values > .env.convex`, edit the file, then reapply the changes with `npx convex env set --force < .env.convex`.\",\n    ].join(\"\\n\"),\n  )\n  .option(\n    \"--from-file <file>\",\n    \"Read environment variables from a .env file. Without --force, fails if any existing variable has a different value.\",\n  )\n  .option(\n    \"--force\",\n    \"When setting multiple variables, overwrite existing environment variable values instead of failing on mismatch.\",\n  )\n  .configureHelp({ showGlobalOptions: true })\n  .allowExcessArguments(false)\n  .action(async (name, value, cmdOptions, cmd) => {\n    // Note: We use `as` here because optsWithGlobals() type inference doesn't\n    // include global options from the parent command (added via addDeploymentSelectionOptions)\n    const options = cmd.optsWithGlobals() as DeploymentSelectionOptions;\n    const { ctx, deployment } = await selectEnvDeployment(options);\n    await ensureHasConvexDependency(ctx, \"env set\");\n    await withRunningBackend({\n      ctx,\n      deployment,\n      action: async () => {\n        const backend = deploymentEnvBackend(ctx, deployment);\n        const didAnything = await envSet(ctx, backend, name, value, cmdOptions);\n        if (didAnything === false) {\n          cmd.outputHelp({ error: true });\n          return await ctx.crash({\n            exitCode: 1,\n            errorType: \"fatal\",\n            printedMessage:\n              \"error: No environment variables specified to be set.\",\n          });\n        }\n      },\n    });\n  });\n\nexport async function selectEnvDeployment(\n  options: DeploymentSelectionOptions,\n): Promise<{\n  ctx: Context;\n  deployment: {\n    deploymentUrl: string;\n    adminKey: string;\n    deploymentNotice: string;\n    deploymentFields: DetailedDeploymentCredentials[\"deploymentFields\"];\n  };\n}> {\n  const ctx = await oneoffContext(options);\n  const deploymentSelection = await getDeploymentSelection(ctx, options);\n  const {\n    adminKey,\n    url: deploymentUrl,\n    deploymentFields,\n  } = await loadSelectedDeploymentCredentials(ctx, deploymentSelection, {\n    ensureLocalRunning: false,\n  });\n\n  const deploymentNotice =\n    deploymentFields !== null\n      ? ` (on ${chalkStderr.bold(deploymentFields.deploymentType)} deployment ${chalkStderr.bold(deploymentFields.deploymentName)})`\n      : \"\";\n  const result = {\n    ctx,\n    deployment: {\n      deploymentUrl,\n      adminKey,\n      deploymentNotice,\n      deploymentFields,\n    },\n  };\n  return result;\n}\n\nconst envGetCmd = new Command(\"get\")\n  .argument(\"<name>\", \"The name of the environment variable to print.\")\n  .summary(\"Print a variable's value\")\n  .description(\"Print a variable's value: `npx convex env get NAME`\")\n  .configureHelp({ showGlobalOptions: true })\n  .allowExcessArguments(false)\n  .action(async (envVarName, _options, cmd) => {\n    const options = cmd.optsWithGlobals();\n    const { ctx, deployment } = await selectEnvDeployment(options);\n    await ensureHasConvexDependency(ctx, \"env get\");\n    await withRunningBackend({\n      ctx,\n      deployment,\n      action: async () => {\n        const backend = deploymentEnvBackend(ctx, deployment);\n        await envGet(ctx, backend, envVarName);\n      },\n    });\n  });\n\nconst envRemoveCmd = new Command(\"remove\")\n  .alias(\"rm\")\n  .alias(\"unset\")\n  .argument(\"<name>\", \"The name of the environment variable to unset.\")\n  .summary(\"Unset a variable\")\n  .description(\n    \"Unset a variable: `npx convex env remove NAME`\\n\" +\n      \"If the variable doesn't exist, the command doesn't do anything and succeeds.\",\n  )\n  .configureHelp({ showGlobalOptions: true })\n  .allowExcessArguments(false)\n  .action(async (name, _options, cmd) => {\n    const options = cmd.optsWithGlobals();\n    const { ctx, deployment } = await selectEnvDeployment(options);\n    await ensureHasConvexDependency(ctx, \"env remove\");\n    await withRunningBackend({\n      ctx,\n      deployment,\n      action: async () => {\n        const backend = deploymentEnvBackend(ctx, deployment);\n        await envRemove(ctx, backend, name);\n      },\n    });\n  });\n\nconst envListCmd = new Command(\"list\")\n  .summary(\"List all environment variables and their values\")\n  .description(\n    [\n      \"\u2022 List only variable names (no values): `npx convex env list --names-only`\",\n      \"\u2022 List all variables and their values: `npx convex env list --include-values`\",\n      \"\u2022 Save all variables to a file: `npx convex env list --include-values > .env.convex`\",\n      \"\u2022 Append to a file: `npx convex env list --include-values >> .env.convex`\",\n      \"\",\n      \"When an AI agent runs this command (detected from environment variables like AI_AGENT or CLAUDECODE), only names are listed unless --include-values is passed.\",\n    ].join(\"\\n\"),\n  )\n  .option(\n    \"--names-only\",\n    \"List only the names of environment variables, without their values\",\n  )\n  .addOption(\n    new Option(\n      \"--include-values\",\n      \"Print each variable's value alongside its name, in .env format. This is the default unless an AI agent is detected, so pass it explicitly in scripts that rely on the values.\",\n    ).conflicts(\"namesOnly\"),\n  )\n  .configureHelp({ showGlobalOptions: true })\n  .allowExcessArguments(false)\n  .action(async (cmdOptions, cmd) => {\n    // Note: We use `as` here because optsWithGlobals() type inference doesn't\n    // include global options from the parent command (added via addDeploymentSelectionOptions)\n    const options = cmd.optsWithGlobals() as DeploymentSelectionOptions;\n    const { ctx, deployment } = await selectEnvDeployment(options);\n    await ensureHasConvexDependency(ctx, \"env list\");\n    await withRunningBackend({\n      ctx,\n      deployment,\n      action: async () => {\n        const backend = deploymentEnvBackend(ctx, deployment);\n        await envList(ctx, backend, {\n          namesOnly: cmdOptions.namesOnly ?? false,\n          includeValues: cmdOptions.includeValues ?? false,\n        });\n      },\n    });\n  });\n\nexport const env = new Command(\"env\")\n  .summary(\"Set and view environment variables\")\n  .description(\n    [\n      \"Set and view environment variables on your deployment\",\n      \"\",\n      \"\u2022 Set a variable: `npx convex env set NAME 'value'`\",\n      \"\u2022 Set interactively: `npx convex env set NAME`\",\n      \"\u2022 Set multiple from file: `npx convex env set --from-file .env`\",\n      \"\u2022 Unset a variable: `npx convex env remove NAME`\",\n      \"\u2022 List only variable names (no values): `npx convex env list --names-only`\",\n      \"\u2022 List all variables and their values: `npx convex env list --include-values`\",\n      \"\u2022 Print a variable's value: `npx convex env get NAME`\",\n      \"\",\n      \"By default, this sets and views variables on your dev deployment.\",\n      \"\",\n      \"See the environment variables guide (https://docs.convex.dev/production/environment-variables) to learn more.\",\n    ].join(\"\\n\"),\n  )\n  .addCommand(envSetCmd)\n  .addCommand(envGetCmd)\n  .addCommand(envRemoveCmd)\n  .addCommand(envListCmd)\n  .addCommand(envDefault)\n  .helpCommand(false)\n  .addDeploymentSelectionOptions(\n    actionDescription(\"Set and view environment variables on\"),\n  );\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/esm/cli/envDefault.js

@@ -105,6 +105,8 @@ const envDefaultList = addEnvDefaultOptions(
       "\u2022 List only default variable names (no values): `npx convex env default list --names-only`",
       "\u2022 List all default variables and their values: `npx convex env default list --include-values`",
       "",
+      "When an AI agent runs this command (detected from environment variables like AI_AGENT or CLAUDECODE), only names are listed unless --include-values is passed.",
+      "",
       "The deployment type is determined by the current deployment (local maps to dev), or by --type if provided."
     ].join("\n")
   ).option(
@@ -113,7 +115,7 @@ const envDefaultList = addEnvDefaultOptions(
   ).addOption(
     new Option(
       "--include-values",
-      "Print each variable's value alongside its name, in .env format (the default). Pass it explicitly in scripts that rely on the values."
+      "Print each variable's value alongside its name, in .env format. This is the default unless an AI agent is detected, so pass it explicitly in scripts that rely on the values."
     ).conflicts("namesOnly")
   ).configureHelp({ showGlobalOptions: true }).allowExcessArguments(false)
 ).action(async (cmdOptions, cmd) => {
@@ -121,7 +123,8 @@ const envDefaultList = addEnvDefaultOptions(
   const { ctx, backend } = await resolveEnvDefaultBackend(options);
   await ensureHasConvexDependency(ctx, "env default list");
   await envList(ctx, backend, {
-    namesOnly: cmdOptions.namesOnly ?? false
+    namesOnly: cmdOptions.namesOnly ?? false,
+    includeValues: cmdOptions.includeValues ?? false
   });
 });
 export const envDefault = new Command("default").summary("Manage project-level default environment variables").description(

package/dist/esm/cli/envDefault.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/cli/envDefault.ts"],
-  "sourcesContent": ["import { Command, Option } from \"@commander-js/extra-typings\";\nimport {\n  envGet,\n  envList,\n  envRemove,\n  envSet,\n  EnvVarBackend,\n} from \"./lib/env.js\";\nimport { ensureHasConvexDependency } from \"./lib/utils/utils.js\";\nimport { defaultEnvBackend } from \"./lib/defaultEnv.js\";\nimport {\n  CloudDeploymentType,\n  DeploymentSelectionOptions,\n  DeploymentType,\n  fetchTeamAndProject,\n} from \"./lib/api.js\";\nimport { Context, oneoffContext } from \"../bundler/context.js\";\nimport { selectEnvDeployment } from \"./env.js\";\nimport { getProjectDetails } from \"./lib/deploymentSelection.js\";\n\ntype EnvDefaultExtraOptions = {\n  type?: string;\n  project?: string;\n};\n\nfunction addEnvDefaultOptions<T extends Command<any, any>>(cmd: T): T {\n  return cmd\n    .addOption(\n      new Option(\n        \"--type <type>\",\n        \"Manage default env vars for the given deployment type (dev, preview, prod) instead of inferring from the current deployment.\",\n      ),\n    )\n    .addOption(\n      new Option(\n        \"--project <project>\",\n        \"Select a project manually. Accepts `team-slug:project-slug` or just `project-slug` (team inferred from your current project). Requires --type.\",\n      ),\n    ) as T;\n}\n\nconst envDefaultSet = addEnvDefaultOptions(\n  new Command(\"set\")\n    .usage(\"[options] <name> <value>\")\n    .argument(\"[name]\", \"The name of the default environment variable to set.\")\n    .argument(\n      \"[value]\",\n      \"The value to set the variable to. Omit to set it interactively.\",\n    )\n    .summary(\"Set a default variable\")\n    .description(\n      [\n        \"Set default environment variables for your project's deployment type.\",\n        \"\",\n        \"\u2022 `npx convex env default set NAME 'value'`\",\n        \"\u2022 `npx convex env default set NAME # omit a value to set one interactively`\",\n        \"\u2022 `npx convex env default set NAME --from-file value.txt`\",\n        \"\u2022 `npx convex env default set --from-file .env.defaults`\",\n        \"\",\n        \"When setting multiple values, it will refuse all changes if any variables are already set to different values by default. Pass --force to overwrite the provided values.\",\n        \"\",\n        \"The deployment type is determined by the current deployment (local maps to dev), or by --type if provided.\",\n      ].join(\"\\n\"),\n    )\n    .option(\n      \"--from-file <file>\",\n      \"Read environment variables from a .env file. Without --force, fails if any existing variable has a different value.\",\n    )\n    .option(\n      \"--force\",\n      \"When setting multiple variables, overwrite existing environment variable values instead of failing on mismatch.\",\n    )\n    .configureHelp({ showGlobalOptions: true })\n    .allowExcessArguments(false),\n).action(async (name, value, cmdOptions, cmd) => {\n  const options = cmd.optsWithGlobals() as DeploymentSelectionOptions &\n    EnvDefaultExtraOptions;\n  const { ctx, backend } = await resolveEnvDefaultBackend(options);\n  await ensureHasConvexDependency(ctx, \"env default set\");\n  const didAnything = await envSet(ctx, backend, name, value, cmdOptions);\n  if (didAnything === false) {\n    cmd.outputHelp({ error: true });\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage: \"error: No environment variables specified to be set.\",\n    });\n  }\n});\n\nconst envDefaultGet = addEnvDefaultOptions(\n  new Command(\"get\")\n    .argument(\n      \"<name>\",\n      \"The name of the default environment variable to print.\",\n    )\n    .summary(\"Print a default variable's value\")\n    .description(\n      \"Print a default variable's value: `npx convex env default get NAME`\\n\" +\n        \"The deployment type is determined by the current deployment (local maps to dev), or by --type if provided.\",\n    )\n    .configureHelp({ showGlobalOptions: true })\n    .allowExcessArguments(false),\n).action(async (envVarName, _options, cmd) => {\n  const options = cmd.optsWithGlobals() as DeploymentSelectionOptions &\n    EnvDefaultExtraOptions;\n  const { ctx, backend } = await resolveEnvDefaultBackend(options);\n  await ensureHasConvexDependency(ctx, \"env default get\");\n  await envGet(ctx, backend, envVarName);\n});\n\nconst envDefaultRemove = addEnvDefaultOptions(\n  new Command(\"remove\")\n    .alias(\"rm\")\n    .alias(\"unset\")\n    .argument(\n      \"<name>\",\n      \"The name of the default environment variable to unset.\",\n    )\n    .summary(\"Unset a default variable\")\n    .description(\n      [\n        \"Unset a default variable.\",\n        \"\",\n        \"\u2022 `npx convex env default remove NAME`\",\n        \"\",\n        \"If the variable doesn't exist, the command doesn't do anything and succeeds.\",\n        \"\",\n        \"The deployment type is determined by the current deployment (local maps to dev), or by --type if provided.\",\n      ].join(\"\\n\"),\n    )\n    .configureHelp({ showGlobalOptions: true })\n    .allowExcessArguments(false),\n).action(async (name, _options, cmd) => {\n  const options = cmd.optsWithGlobals() as DeploymentSelectionOptions &\n    EnvDefaultExtraOptions;\n  const { ctx, backend } = await resolveEnvDefaultBackend(options);\n  await ensureHasConvexDependency(ctx, \"env default remove\");\n  await envRemove(ctx, backend, name);\n});\n\nconst envDefaultList = addEnvDefaultOptions(\n  new Command(\"list\")\n    .summary(\"List all default environment variables and their values\")\n    .description(\n      [\n        \"\u2022 List only default variable names (no values): `npx convex env default list --names-only`\",\n        \"\u2022 List all default variables and their values: `npx convex env default list --include-values`\",\n        \"\",\n        \"The deployment type is determined by the current deployment (local maps to dev), or by --type if provided.\",\n      ].join(\"\\n\"),\n    )\n    .option(\n      \"--names-only\",\n      \"List only the names of environment variables, without their values\",\n    )\n    .addOption(\n      new Option(\n        \"--include-values\",\n        \"Print each variable's value alongside its name, in .env format (the default). Pass it explicitly in scripts that rely on the values.\",\n      ).conflicts(\"namesOnly\"),\n    )\n    .configureHelp({ showGlobalOptions: true })\n    .allowExcessArguments(false),\n).action(async (cmdOptions, cmd) => {\n  const options = cmd.optsWithGlobals() as DeploymentSelectionOptions &\n    EnvDefaultExtraOptions;\n  const { ctx, backend } = await resolveEnvDefaultBackend(options);\n  await ensureHasConvexDependency(ctx, \"env default list\");\n  await envList(ctx, backend, {\n    namesOnly: cmdOptions.namesOnly ?? false,\n  });\n});\n\nexport const envDefault = new Command(\"default\")\n  .summary(\"Manage project-level default environment variables\")\n  .description(\n    [\n      \"Manage default environment variables for your project.\",\n      \"\",\n      \"The default environment variables read and written to by this command are the ones for the deployment type of the current deployment (i.e. dev in most cases), unless --type is provided.\",\n      \"\",\n      \"\u2022 Set a default variable: `npx convex env default set NAME 'value'`\",\n      \"\u2022 Unset a default variable: `npx convex env default remove NAME`\",\n      \"\u2022 List only default variable names (no values): `npx convex env default list --names-only`\",\n      \"\u2022 List all default variables and their values: `npx convex env default list --include-values`\",\n      \"\u2022 Print a default variable's value: `npx convex env default get NAME`\",\n    ].join(\"\\n\"),\n  )\n  .addCommand(envDefaultSet)\n  .addCommand(envDefaultGet)\n  .addCommand(envDefaultRemove)\n  .addCommand(envDefaultList)\n  .helpCommand(false);\n\ntype ParsedProjectOption =\n  | { kind: \"teamAndProject\"; teamSlug: string; projectSlug: string }\n  | { kind: \"projectOnly\"; projectSlug: string };\n\nasync function resolveEnvDefaultBackend(\n  options: DeploymentSelectionOptions & EnvDefaultExtraOptions,\n): Promise<{ ctx: Context; backend: EnvVarBackend }> {\n  const dtypeOverride = normalizeTypeOption(options.type);\n\n  if (options.project !== undefined) {\n    const parsedProject = parseProjectOption(options.project);\n    if (parsedProject === null) {\n      const ctx = await oneoffContext(options);\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage:\n          \"error: --project must be `team-slug:project-slug` or `project-slug`.\",\n      });\n    }\n    if (dtypeOverride === undefined) {\n      const ctx = await oneoffContext(options);\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage: \"error: --project requires --type to also be set.\",\n      });\n    }\n\n    let ctx: Context;\n    let resolved: { teamSlug: string; projectSlug: string };\n    if (parsedProject.kind === \"teamAndProject\") {\n      ctx = await oneoffContext(options);\n      resolved = {\n        teamSlug: parsedProject.teamSlug,\n        projectSlug: parsedProject.projectSlug,\n      };\n    } else {\n      const selected = await selectEnvDeployment(options);\n      ctx = selected.ctx;\n      if (selected.deployment.deploymentFields === null) {\n        return await ctx.crash({\n          exitCode: 1,\n          errorType: \"fatal\",\n          printedMessage:\n            \"error: --project <project-slug> requires a current cloud deployment to infer the team from. Use `team-slug:project-slug` to specify the team explicitly.\",\n        });\n      }\n      const { team } = await fetchTeamAndProject(\n        ctx,\n        selected.deployment.deploymentFields.deploymentName,\n      );\n      resolved = { teamSlug: team, projectSlug: parsedProject.projectSlug };\n    }\n\n    const details = await getProjectDetails(ctx, {\n      kind: \"teamAndProjectSlugs\",\n      teamSlug: resolved.teamSlug,\n      projectSlug: resolved.projectSlug,\n    });\n    return {\n      ctx,\n      backend: defaultEnvBackend(ctx, details.id, dtypeOverride),\n    };\n  }\n\n  const { ctx, deployment } = await selectEnvDeployment(options);\n  const backend = await resolveDefaultEnvBackend(\n    ctx,\n    deployment.deploymentFields,\n    dtypeOverride,\n  );\n  return { ctx, backend };\n}\n\nfunction normalizeTypeOption(\n  type: string | undefined,\n): CloudDeploymentType | undefined {\n  if (type === undefined) return undefined;\n  if (type === \"development\") return \"dev\";\n  if (type === \"production\") return \"prod\";\n  return type as CloudDeploymentType;\n}\n\nfunction parseProjectOption(value: string): ParsedProjectOption | null {\n  const parts = value.split(\":\");\n  if (parts.length === 1 && parts[0].length > 0) {\n    return { kind: \"projectOnly\", projectSlug: parts[0] };\n  }\n  if (parts.length === 2 && parts[0].length > 0 && parts[1].length > 0) {\n    return {\n      kind: \"teamAndProject\",\n      teamSlug: parts[0],\n      projectSlug: parts[1],\n    };\n  }\n  return null;\n}\n\nexport async function resolveDefaultEnvBackend(\n  ctx: Context,\n  deploymentFields: {\n    deploymentName: string;\n    deploymentType: DeploymentType;\n  } | null,\n  dtypeOverride?: CloudDeploymentType,\n): Promise<EnvVarBackend> {\n  if (deploymentFields === null) {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage:\n        \"Default environment variables are only available for cloud projects.\",\n    });\n  }\n  if (deploymentFields.deploymentType === \"anonymous\") {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage:\n        \"Default environment variables are not available for anonymous deployments.\",\n    });\n  }\n  const dtype =\n    dtypeOverride ?? resolveDefaultEnvDtype(deploymentFields.deploymentType);\n  const { projectId } = await fetchTeamAndProject(\n    ctx,\n    deploymentFields.deploymentName,\n  );\n  return defaultEnvBackend(ctx, projectId, dtype);\n}\n\nfunction resolveDefaultEnvDtype(\n  deploymentType: Exclude<DeploymentType, \"anonymous\">,\n): CloudDeploymentType {\n  if (deploymentType === \"local\") return \"dev\";\n  return deploymentType;\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { Command, Option } from \"@commander-js/extra-typings\";\nimport {\n  envGet,\n  envList,\n  envRemove,\n  envSet,\n  EnvVarBackend,\n} from \"./lib/env.js\";\nimport { ensureHasConvexDependency } from \"./lib/utils/utils.js\";\nimport { defaultEnvBackend } from \"./lib/defaultEnv.js\";\nimport {\n  CloudDeploymentType,\n  DeploymentSelectionOptions,\n  DeploymentType,\n  fetchTeamAndProject,\n} from \"./lib/api.js\";\nimport { Context, oneoffContext } from \"../bundler/context.js\";\nimport { selectEnvDeployment } from \"./env.js\";\nimport { getProjectDetails } from \"./lib/deploymentSelection.js\";\n\ntype EnvDefaultExtraOptions = {\n  type?: string;\n  project?: string;\n};\n\nfunction addEnvDefaultOptions<T extends Command<any, any>>(cmd: T): T {\n  return cmd\n    .addOption(\n      new Option(\n        \"--type <type>\",\n        \"Manage default env vars for the given deployment type (dev, preview, prod) instead of inferring from the current deployment.\",\n      ),\n    )\n    .addOption(\n      new Option(\n        \"--project <project>\",\n        \"Select a project manually. Accepts `team-slug:project-slug` or just `project-slug` (team inferred from your current project). Requires --type.\",\n      ),\n    ) as T;\n}\n\nconst envDefaultSet = addEnvDefaultOptions(\n  new Command(\"set\")\n    .usage(\"[options] <name> <value>\")\n    .argument(\"[name]\", \"The name of the default environment variable to set.\")\n    .argument(\n      \"[value]\",\n      \"The value to set the variable to. Omit to set it interactively.\",\n    )\n    .summary(\"Set a default variable\")\n    .description(\n      [\n        \"Set default environment variables for your project's deployment type.\",\n        \"\",\n        \"\u2022 `npx convex env default set NAME 'value'`\",\n        \"\u2022 `npx convex env default set NAME # omit a value to set one interactively`\",\n        \"\u2022 `npx convex env default set NAME --from-file value.txt`\",\n        \"\u2022 `npx convex env default set --from-file .env.defaults`\",\n        \"\",\n        \"When setting multiple values, it will refuse all changes if any variables are already set to different values by default. Pass --force to overwrite the provided values.\",\n        \"\",\n        \"The deployment type is determined by the current deployment (local maps to dev), or by --type if provided.\",\n      ].join(\"\\n\"),\n    )\n    .option(\n      \"--from-file <file>\",\n      \"Read environment variables from a .env file. Without --force, fails if any existing variable has a different value.\",\n    )\n    .option(\n      \"--force\",\n      \"When setting multiple variables, overwrite existing environment variable values instead of failing on mismatch.\",\n    )\n    .configureHelp({ showGlobalOptions: true })\n    .allowExcessArguments(false),\n).action(async (name, value, cmdOptions, cmd) => {\n  const options = cmd.optsWithGlobals() as DeploymentSelectionOptions &\n    EnvDefaultExtraOptions;\n  const { ctx, backend } = await resolveEnvDefaultBackend(options);\n  await ensureHasConvexDependency(ctx, \"env default set\");\n  const didAnything = await envSet(ctx, backend, name, value, cmdOptions);\n  if (didAnything === false) {\n    cmd.outputHelp({ error: true });\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage: \"error: No environment variables specified to be set.\",\n    });\n  }\n});\n\nconst envDefaultGet = addEnvDefaultOptions(\n  new Command(\"get\")\n    .argument(\n      \"<name>\",\n      \"The name of the default environment variable to print.\",\n    )\n    .summary(\"Print a default variable's value\")\n    .description(\n      \"Print a default variable's value: `npx convex env default get NAME`\\n\" +\n        \"The deployment type is determined by the current deployment (local maps to dev), or by --type if provided.\",\n    )\n    .configureHelp({ showGlobalOptions: true })\n    .allowExcessArguments(false),\n).action(async (envVarName, _options, cmd) => {\n  const options = cmd.optsWithGlobals() as DeploymentSelectionOptions &\n    EnvDefaultExtraOptions;\n  const { ctx, backend } = await resolveEnvDefaultBackend(options);\n  await ensureHasConvexDependency(ctx, \"env default get\");\n  await envGet(ctx, backend, envVarName);\n});\n\nconst envDefaultRemove = addEnvDefaultOptions(\n  new Command(\"remove\")\n    .alias(\"rm\")\n    .alias(\"unset\")\n    .argument(\n      \"<name>\",\n      \"The name of the default environment variable to unset.\",\n    )\n    .summary(\"Unset a default variable\")\n    .description(\n      [\n        \"Unset a default variable.\",\n        \"\",\n        \"\u2022 `npx convex env default remove NAME`\",\n        \"\",\n        \"If the variable doesn't exist, the command doesn't do anything and succeeds.\",\n        \"\",\n        \"The deployment type is determined by the current deployment (local maps to dev), or by --type if provided.\",\n      ].join(\"\\n\"),\n    )\n    .configureHelp({ showGlobalOptions: true })\n    .allowExcessArguments(false),\n).action(async (name, _options, cmd) => {\n  const options = cmd.optsWithGlobals() as DeploymentSelectionOptions &\n    EnvDefaultExtraOptions;\n  const { ctx, backend } = await resolveEnvDefaultBackend(options);\n  await ensureHasConvexDependency(ctx, \"env default remove\");\n  await envRemove(ctx, backend, name);\n});\n\nconst envDefaultList = addEnvDefaultOptions(\n  new Command(\"list\")\n    .summary(\"List all default environment variables and their values\")\n    .description(\n      [\n        \"\u2022 List only default variable names (no values): `npx convex env default list --names-only`\",\n        \"\u2022 List all default variables and their values: `npx convex env default list --include-values`\",\n        \"\",\n        \"When an AI agent runs this command (detected from environment variables like AI_AGENT or CLAUDECODE), only names are listed unless --include-values is passed.\",\n        \"\",\n        \"The deployment type is determined by the current deployment (local maps to dev), or by --type if provided.\",\n      ].join(\"\\n\"),\n    )\n    .option(\n      \"--names-only\",\n      \"List only the names of environment variables, without their values\",\n    )\n    .addOption(\n      new Option(\n        \"--include-values\",\n        \"Print each variable's value alongside its name, in .env format. This is the default unless an AI agent is detected, so pass it explicitly in scripts that rely on the values.\",\n      ).conflicts(\"namesOnly\"),\n    )\n    .configureHelp({ showGlobalOptions: true })\n    .allowExcessArguments(false),\n).action(async (cmdOptions, cmd) => {\n  const options = cmd.optsWithGlobals() as DeploymentSelectionOptions &\n    EnvDefaultExtraOptions;\n  const { ctx, backend } = await resolveEnvDefaultBackend(options);\n  await ensureHasConvexDependency(ctx, \"env default list\");\n  await envList(ctx, backend, {\n    namesOnly: cmdOptions.namesOnly ?? false,\n    includeValues: cmdOptions.includeValues ?? false,\n  });\n});\n\nexport const envDefault = new Command(\"default\")\n  .summary(\"Manage project-level default environment variables\")\n  .description(\n    [\n      \"Manage default environment variables for your project.\",\n      \"\",\n      \"The default environment variables read and written to by this command are the ones for the deployment type of the current deployment (i.e. dev in most cases), unless --type is provided.\",\n      \"\",\n      \"\u2022 Set a default variable: `npx convex env default set NAME 'value'`\",\n      \"\u2022 Unset a default variable: `npx convex env default remove NAME`\",\n      \"\u2022 List only default variable names (no values): `npx convex env default list --names-only`\",\n      \"\u2022 List all default variables and their values: `npx convex env default list --include-values`\",\n      \"\u2022 Print a default variable's value: `npx convex env default get NAME`\",\n    ].join(\"\\n\"),\n  )\n  .addCommand(envDefaultSet)\n  .addCommand(envDefaultGet)\n  .addCommand(envDefaultRemove)\n  .addCommand(envDefaultList)\n  .helpCommand(false);\n\ntype ParsedProjectOption =\n  | { kind: \"teamAndProject\"; teamSlug: string; projectSlug: string }\n  | { kind: \"projectOnly\"; projectSlug: string };\n\nasync function resolveEnvDefaultBackend(\n  options: DeploymentSelectionOptions & EnvDefaultExtraOptions,\n): Promise<{ ctx: Context; backend: EnvVarBackend }> {\n  const dtypeOverride = normalizeTypeOption(options.type);\n\n  if (options.project !== undefined) {\n    const parsedProject = parseProjectOption(options.project);\n    if (parsedProject === null) {\n      const ctx = await oneoffContext(options);\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage:\n          \"error: --project must be `team-slug:project-slug` or `project-slug`.\",\n      });\n    }\n    if (dtypeOverride === undefined) {\n      const ctx = await oneoffContext(options);\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage: \"error: --project requires --type to also be set.\",\n      });\n    }\n\n    let ctx: Context;\n    let resolved: { teamSlug: string; projectSlug: string };\n    if (parsedProject.kind === \"teamAndProject\") {\n      ctx = await oneoffContext(options);\n      resolved = {\n        teamSlug: parsedProject.teamSlug,\n        projectSlug: parsedProject.projectSlug,\n      };\n    } else {\n      const selected = await selectEnvDeployment(options);\n      ctx = selected.ctx;\n      if (selected.deployment.deploymentFields === null) {\n        return await ctx.crash({\n          exitCode: 1,\n          errorType: \"fatal\",\n          printedMessage:\n            \"error: --project <project-slug> requires a current cloud deployment to infer the team from. Use `team-slug:project-slug` to specify the team explicitly.\",\n        });\n      }\n      const { team } = await fetchTeamAndProject(\n        ctx,\n        selected.deployment.deploymentFields.deploymentName,\n      );\n      resolved = { teamSlug: team, projectSlug: parsedProject.projectSlug };\n    }\n\n    const details = await getProjectDetails(ctx, {\n      kind: \"teamAndProjectSlugs\",\n      teamSlug: resolved.teamSlug,\n      projectSlug: resolved.projectSlug,\n    });\n    return {\n      ctx,\n      backend: defaultEnvBackend(ctx, details.id, dtypeOverride),\n    };\n  }\n\n  const { ctx, deployment } = await selectEnvDeployment(options);\n  const backend = await resolveDefaultEnvBackend(\n    ctx,\n    deployment.deploymentFields,\n    dtypeOverride,\n  );\n  return { ctx, backend };\n}\n\nfunction normalizeTypeOption(\n  type: string | undefined,\n): CloudDeploymentType | undefined {\n  if (type === undefined) return undefined;\n  if (type === \"development\") return \"dev\";\n  if (type === \"production\") return \"prod\";\n  return type as CloudDeploymentType;\n}\n\nfunction parseProjectOption(value: string): ParsedProjectOption | null {\n  const parts = value.split(\":\");\n  if (parts.length === 1 && parts[0].length > 0) {\n    return { kind: \"projectOnly\", projectSlug: parts[0] };\n  }\n  if (parts.length === 2 && parts[0].length > 0 && parts[1].length > 0) {\n    return {\n      kind: \"teamAndProject\",\n      teamSlug: parts[0],\n      projectSlug: parts[1],\n    };\n  }\n  return null;\n}\n\nexport async function resolveDefaultEnvBackend(\n  ctx: Context,\n  deploymentFields: {\n    deploymentName: string;\n    deploymentType: DeploymentType;\n  } | null,\n  dtypeOverride?: CloudDeploymentType,\n): Promise<EnvVarBackend> {\n  if (deploymentFields === null) {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage:\n        \"Default environment variables are only available for cloud projects.\",\n    });\n  }\n  if (deploymentFields.deploymentType === \"anonymous\") {\n    return await ctx.crash({\n      exitCode: 1,\n      errorType: \"fatal\",\n      printedMessage:\n        \"Default environment variables are not available for anonymous deployments.\",\n    });\n  }\n  const dtype =\n    dtypeOverride ?? resolveDefaultEnvDtype(deploymentFields.deploymentType);\n  const { projectId } = await fetchTeamAndProject(\n    ctx,\n    deploymentFields.deploymentName,\n  );\n  return defaultEnvBackend(ctx, projectId, dtype);\n}\n\nfunction resolveDefaultEnvDtype(\n  deploymentType: Exclude<DeploymentType, \"anonymous\">,\n): CloudDeploymentType {\n  if (deploymentType === \"local\") return \"dev\";\n  return deploymentType;\n}\n"],
+  "mappings": "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",
   "names": ["ctx"]
 }

package/dist/esm/cli/lib/aiFiles/guidelinesmd.js

@@ -23,7 +23,7 @@ export async function installGuidelinesFile({
         "Could not download Convex AI guidelines right now. You can retry with: npx convex ai-files install"
       )
     );
-    return;
+    return false;
   }
   await fs.mkdir(aiDirForConvexDir(convexDir), { recursive: true });
   await fs.writeFile(guidelinesPathForConvexDir(convexDir), guidelines, "utf8");
@@ -31,5 +31,6 @@ export async function installGuidelinesFile({
   logMessage(
     `${chalkStderr.green("\u2714")} ${guidelinesPathForConvexDir(convexDir)} written`
   );
+  return true;
 }
 //# sourceMappingURL=guidelinesmd.js.map

package/dist/esm/cli/lib/aiFiles/guidelinesmd.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/cli/lib/aiFiles/guidelinesmd.ts"],
-  "sourcesContent": ["// eslint-disable-next-line no-restricted-imports\nimport { promises as fs } from \"fs\";\nimport { chalkStderr } from \"chalk\";\nimport { logMessage } from \"../../../bundler/log.js\";\nimport { downloadGuidelines } from \"../versionApi.js\";\nimport { hashSha256 } from \"../utils/hash.js\";\nimport { aiDirForConvexDir, guidelinesPathForConvexDir } from \"./paths.js\";\nimport { attemptReadFile, exhaustiveCheck } from \"./utils.js\";\nimport { type AiFilesState } from \"./state.js\";\n\nexport async function hasGuidelinesInstalled(\n  convexDir: string,\n): Promise<boolean> {\n  const result = await attemptReadFile(guidelinesPathForConvexDir(convexDir));\n  if (result.kind === \"content\") return true;\n  if (result.kind === \"empty\" || result.kind === \"not-found\") return false;\n  return exhaustiveCheck(result);\n}\n\n/**\n * Download and write the guidelines file.\n * Guidelines live in `_generated/` so local edits are not expected and are\n * not preserved.\n */\nexport async function installGuidelinesFile({\n  convexDir,\n  state,\n}: {\n  convexDir: string;\n  state: AiFilesState;\n}): Promise<void> {\n  const guidelines = await downloadGuidelines();\n  if (guidelines === null) {\n    logMessage(\n      chalkStderr.yellow(\n        \"Could not download Convex AI guidelines right now. You can retry with: npx convex ai-files install\",\n      ),\n    );\n    return;\n  }\n\n  await fs.mkdir(aiDirForConvexDir(convexDir), { recursive: true });\n  await fs.writeFile(guidelinesPathForConvexDir(convexDir), guidelines, \"utf8\");\n  state.guidelinesHash = hashSha256(guidelines);\n\n  logMessage(\n    `${chalkStderr.green(\"\u2714\")} ${guidelinesPathForConvexDir(convexDir)} written`,\n  );\n}\n"],
-  "mappings": ";AACA,SAAS,YAAY,UAAU;AAC/B,SAAS,mBAAmB;AAC5B,SAAS,kBAAkB;AAC3B,SAAS,0BAA0B;AACnC,SAAS,kBAAkB;AAC3B,SAAS,mBAAmB,kCAAkC;AAC9D,SAAS,iBAAiB,uBAAuB;AAGjD,sBAAsB,uBACpB,WACkB;AAClB,QAAM,SAAS,MAAM,gBAAgB,2BAA2B,SAAS,CAAC;AAC1E,MAAI,OAAO,SAAS,UAAW,QAAO;AACtC,MAAI,OAAO,SAAS,WAAW,OAAO,SAAS,YAAa,QAAO;AACnE,SAAO,gBAAgB,MAAM;AAC/B;AAOA,sBAAsB,sBAAsB;AAAA,EAC1C;AAAA,EACA;AACF,GAGkB;AAChB,QAAM,aAAa,MAAM,mBAAmB;AAC5C,MAAI,eAAe,MAAM;AACvB;AAAA,MACE,YAAY;AAAA,QACV;AAAA,MACF;AAAA,IACF;AACA;AAAA,EACF;AAEA,QAAM,GAAG,MAAM,kBAAkB,SAAS,GAAG,EAAE,WAAW,KAAK,CAAC;AAChE,QAAM,GAAG,UAAU,2BAA2B,SAAS,GAAG,YAAY,MAAM;AAC5E,QAAM,iBAAiB,WAAW,UAAU;AAE5C;AAAA,IACE,GAAG,YAAY,MAAM,QAAG,CAAC,IAAI,2BAA2B,SAAS,CAAC;AAAA,EACpE;AACF;",
+  "sourcesContent": ["// eslint-disable-next-line no-restricted-imports\nimport { promises as fs } from \"fs\";\nimport { chalkStderr } from \"chalk\";\nimport { logMessage } from \"../../../bundler/log.js\";\nimport { downloadGuidelines } from \"../versionApi.js\";\nimport { hashSha256 } from \"../utils/hash.js\";\nimport { aiDirForConvexDir, guidelinesPathForConvexDir } from \"./paths.js\";\nimport { attemptReadFile, exhaustiveCheck } from \"./utils.js\";\nimport { type AiFilesState } from \"./state.js\";\n\nexport async function hasGuidelinesInstalled(\n  convexDir: string,\n): Promise<boolean> {\n  const result = await attemptReadFile(guidelinesPathForConvexDir(convexDir));\n  if (result.kind === \"content\") return true;\n  if (result.kind === \"empty\" || result.kind === \"not-found\") return false;\n  return exhaustiveCheck(result);\n}\n\n/**\n * Download and write the guidelines file.\n * Guidelines live in `_generated/` so local edits are not expected and are\n * not preserved.\n *\n * Returns false if the guidelines could not be downloaded.\n */\nexport async function installGuidelinesFile({\n  convexDir,\n  state,\n}: {\n  convexDir: string;\n  state: AiFilesState;\n}): Promise<boolean> {\n  const guidelines = await downloadGuidelines();\n\n  if (guidelines === null) {\n    logMessage(\n      chalkStderr.yellow(\n        \"Could not download Convex AI guidelines right now. You can retry with: npx convex ai-files install\",\n      ),\n    );\n    return false;\n  }\n\n  await fs.mkdir(aiDirForConvexDir(convexDir), { recursive: true });\n  await fs.writeFile(guidelinesPathForConvexDir(convexDir), guidelines, \"utf8\");\n  state.guidelinesHash = hashSha256(guidelines);\n\n  logMessage(\n    `${chalkStderr.green(\"\u2714\")} ${guidelinesPathForConvexDir(convexDir)} written`,\n  );\n\n  return true;\n}\n"],
+  "mappings": ";AACA,SAAS,YAAY,UAAU;AAC/B,SAAS,mBAAmB;AAC5B,SAAS,kBAAkB;AAC3B,SAAS,0BAA0B;AACnC,SAAS,kBAAkB;AAC3B,SAAS,mBAAmB,kCAAkC;AAC9D,SAAS,iBAAiB,uBAAuB;AAGjD,sBAAsB,uBACpB,WACkB;AAClB,QAAM,SAAS,MAAM,gBAAgB,2BAA2B,SAAS,CAAC;AAC1E,MAAI,OAAO,SAAS,UAAW,QAAO;AACtC,MAAI,OAAO,SAAS,WAAW,OAAO,SAAS,YAAa,QAAO;AACnE,SAAO,gBAAgB,MAAM;AAC/B;AASA,sBAAsB,sBAAsB;AAAA,EAC1C;AAAA,EACA;AACF,GAGqB;AACnB,QAAM,aAAa,MAAM,mBAAmB;AAE5C,MAAI,eAAe,MAAM;AACvB;AAAA,MACE,YAAY;AAAA,QACV;AAAA,MACF;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAEA,QAAM,GAAG,MAAM,kBAAkB,SAAS,GAAG,EAAE,WAAW,KAAK,CAAC;AAChE,QAAM,GAAG,UAAU,2BAA2B,SAAS,GAAG,YAAY,MAAM;AAC5E,QAAM,iBAAiB,WAAW,UAAU;AAE5C;AAAA,IACE,GAAG,YAAY,MAAM,QAAG,CAAC,IAAI,2BAA2B,SAAS,CAAC;AAAA,EACpE;AAEA,SAAO;AACT;",
   "names": []
 }

package/dist/esm/cli/lib/aiFiles/index.js

@@ -43,12 +43,23 @@ export async function installAiFiles({
 }) {
   const convexDirName = path.relative(projectDir, convexDir);
   const state = await readAiStateOrDefault(convexDir);
-  await installGuidelinesFile({ convexDir, state });
+  const guidelinesInstalled = await installGuidelinesFile({ convexDir, state });
   await applyAgentsMdSection({ projectDir, state, convexDirName });
   await applyClaudeMdSection({ projectDir, state, convexDirName });
-  await installSkills({ projectDir, state, aiFilesConfig });
+  const skillsInstalled = await installSkills({
+    projectDir,
+    state,
+    aiFilesConfig
+  });
   await removeLegacyCursorRules(projectDir);
   await writeAiState({ state, convexDir });
+  if (!guidelinesInstalled || !skillsInstalled) {
+    return {
+      kind: "error",
+      message: "Some Convex AI files could not be installed. See the messages above."
+    };
+  }
+  return { kind: "success" };
 }
 async function attemptToInstallAiFiles(opts) {
   try {

package/dist/esm/cli/lib/aiFiles/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/cli/lib/aiFiles/index.ts"],
-  "sourcesContent": ["import * as Sentry from \"@sentry/node\";\nimport path from \"path\";\nimport { Context } from \"../../../bundler/context.js\";\n// eslint-disable-next-line no-restricted-imports\nimport { promises as fs } from \"fs\";\nimport { chalkStderr } from \"chalk\";\nimport { logMessage } from \"../../../bundler/log.js\";\nimport { promptYesNo } from \"../utils/prompts.js\";\nimport { fetchAgentSkillsCatalog } from \"../versionApi.js\";\nimport { type AiFilesPaths, aiDirForConvexDir } from \"./paths.js\";\nimport {\n  installGuidelinesFile,\n  hasGuidelinesInstalled,\n} from \"./guidelinesmd.js\";\nimport {\n  attemptReadAiState,\n  readAiStateOrDefault,\n  writeAiState,\n  hasAiState,\n} from \"./state.js\";\nimport { type AiFilesProjectConfig } from \"../config.js\";\nimport { exhaustiveCheck, isInInteractiveTerminal } from \"./utils.js\";\nimport {\n  hasAgentsMdInstalled,\n  applyAgentsMdSection,\n  attemptToRemoveAgentsMdSection,\n} from \"./agentsmd.js\";\nimport {\n  hasClaudeMdInstalled,\n  applyClaudeMdSection,\n  attemptToRemoveClaudeMdSection,\n} from \"./claudemd.js\";\nimport { installSkills, removeInstalledSkills } from \"./skills.js\";\nimport { removeLegacyCursorRulesFile as removeLegacyCursorRules } from \"./cursorrules.js\";\n\nasync function hasExistingAiFilesArtifacts({\n  projectDir,\n  convexDir,\n}: AiFilesPaths): Promise<boolean> {\n  return (\n    (await hasGuidelinesInstalled(convexDir)) ||\n    (await hasAgentsMdInstalled(projectDir)) ||\n    (await hasClaudeMdInstalled(projectDir))\n  );\n}\n\n/**\n * Install or refresh all Convex AI files.\n *\n * Reads the existing state if present, or starts from a blank one for a\n * fresh install.\n */\nexport async function installAiFiles({\n  projectDir,\n  convexDir,\n  aiFilesConfig,\n}: AiFilesPaths & {\n  aiFilesConfig?: AiFilesProjectConfig | undefined;\n}): Promise<void> {\n  const convexDirName = path.relative(projectDir, convexDir);\n  const state = await readAiStateOrDefault(convexDir);\n\n  await installGuidelinesFile({ convexDir, state });\n  await applyAgentsMdSection({ projectDir, state, convexDirName });\n  await applyClaudeMdSection({ projectDir, state, convexDirName });\n  await installSkills({ projectDir, state, aiFilesConfig });\n  await removeLegacyCursorRules(projectDir);\n  await writeAiState({ state, convexDir });\n}\n\nasync function attemptToInstallAiFiles(\n  opts: Parameters<typeof installAiFiles>[0],\n): Promise<void> {\n  try {\n    await installAiFiles(opts);\n  } catch (error) {\n    Sentry.captureException(error);\n  }\n}\n\ntype AiFilesStalenessStatus = \"not-installed\" | \"stale\" | \"silent\";\n\nexport function isAiFilesDisabled(\n  aiFilesConfig: AiFilesProjectConfig | undefined,\n): boolean {\n  if (aiFilesConfig?.enabled !== undefined)\n    return aiFilesConfig.enabled === false;\n  return aiFilesConfig?.disableStalenessMessage === true;\n}\n\nasync function determineAiFilesStaleness({\n  canonicalGuidelinesHash,\n  canonicalAgentSkillsSha,\n  aiFilesConfig,\n  projectDir,\n  convexDir,\n}: {\n  canonicalGuidelinesHash: string | null;\n  canonicalAgentSkillsSha: string | null;\n  aiFilesConfig?: AiFilesProjectConfig | undefined;\n} & AiFilesPaths): Promise<AiFilesStalenessStatus> {\n  if (isAiFilesDisabled(aiFilesConfig)) return \"silent\";\n\n  const result = await attemptReadAiState(convexDir);\n\n  if (result.kind === \"no-file\" || result.kind === \"parse-error\") {\n    const hasArtifacts = await hasExistingAiFilesArtifacts({\n      projectDir,\n      convexDir,\n    });\n    return hasArtifacts ? \"silent\" : \"not-installed\";\n  }\n\n  if (result.kind === \"ok\") {\n    const { state } = result;\n\n    if (canonicalGuidelinesHash === null && canonicalAgentSkillsSha === null)\n      return \"silent\";\n\n    const guidelinesStale =\n      canonicalGuidelinesHash !== null &&\n      state.guidelinesHash !== null &&\n      state.guidelinesHash !== canonicalGuidelinesHash;\n\n    const skillsStale =\n      canonicalAgentSkillsSha !== null &&\n      state.agentSkillsSha !== null &&\n      state.agentSkillsSha !== canonicalAgentSkillsSha;\n\n    return guidelinesStale || skillsStale ? \"stale\" : \"silent\";\n  }\n\n  return exhaustiveCheck(result);\n}\n\n/**\n * Check whether the Convex AI files are out of date and log a nag message\n * if so.\n */\nexport async function checkAiFilesStalenessAndLog(\n  opts: {\n    canonicalGuidelinesHash: string | null;\n    canonicalAgentSkillsSha: string | null;\n    aiFilesConfig?: AiFilesProjectConfig | undefined;\n  } & AiFilesPaths,\n): Promise<void> {\n  const status = await determineAiFilesStaleness(opts);\n\n  if (status === \"not-installed\") {\n    logMessage(\n      chalkStderr.yellow(\n        `Convex AI files are not installed. Run ${chalkStderr.bold(`npx convex ai-files install`)} to get started or ${chalkStderr.bold(`npx convex ai-files disable`)} to hide this message.`,\n      ),\n    );\n    return;\n  }\n\n  if (status === \"stale\") {\n    logMessage(\n      chalkStderr.yellow(\n        `Your Convex AI files are out of date. Run ${chalkStderr.bold(`npx convex ai-files update`)} to get the latest.`,\n      ),\n    );\n    return;\n  }\n\n  if (status === \"silent\") return;\n\n  exhaustiveCheck(status);\n}\n\n/**\n * Installs AI files and returns the aiFiles config to write.\n */\nexport async function enableAiFiles({\n  projectDir,\n  convexDir,\n  aiFilesConfig,\n}: AiFilesPaths & {\n  aiFilesConfig?: AiFilesProjectConfig | undefined;\n}): Promise<AiFilesProjectConfig> {\n  await installAiFiles({ projectDir, convexDir, aiFilesConfig });\n  // Deleting the deprecated disableStalenessMessage key\n  const { disableStalenessMessage: _, ...rest } = aiFilesConfig ?? {};\n  return { ...rest, enabled: true };\n}\n\n/**\n * Returns the aiFiles config to write when disabling AI files.\n */\nexport function disableAiFiles(\n  aiFilesConfig?: AiFilesProjectConfig | undefined,\n): AiFilesProjectConfig {\n  // Deleting the deprecated disableStalenessMessage key\n  const { disableStalenessMessage: _, ...rest } = aiFilesConfig ?? {};\n  return { ...rest, enabled: false };\n}\n\nexport type RemoveAiFilesResult =\n  | { kind: \"success\" }\n  | { kind: \"error\"; message: string };\n\n/**\n * Remove all Convex AI files from the project.\n * Called by `npx convex ai-files remove`.\n */\nexport async function removeAiFiles({\n  projectDir,\n  convexDir,\n}: AiFilesPaths): Promise<RemoveAiFilesResult> {\n  const agentSkillsCatalog = await fetchAgentSkillsCatalog();\n  if (agentSkillsCatalog.kind === \"error\") {\n    return {\n      kind: \"error\",\n      message:\n        \"Could not fetch canonical agent skills from version.convex.dev. Aborting `convex ai-files remove`.\",\n    };\n  }\n\n  const removals = [\n    await attemptToRemoveAgentsMdSection(projectDir),\n    await attemptToRemoveClaudeMdSection(projectDir),\n    (await removeInstalledSkills({\n      projectDir,\n      skillNames: agentSkillsCatalog.data.skills.map(\n        ({ skillName }) => skillName,\n      ),\n    })) === \"removed\",\n    await removeLegacyCursorRules(projectDir),\n    await attemptToDeleteAiDir({ projectDir, convexDir }),\n  ];\n\n  if (removals.some(Boolean)) logMessage(\"Convex AI files removed.\");\n  else logMessage(\"No Convex AI files found \u2014 nothing to remove.\");\n  return { kind: \"success\" };\n}\n\nasync function attemptToDeleteAiDir({\n  projectDir,\n  convexDir,\n}: AiFilesPaths): Promise<boolean> {\n  const aiDir = aiDirForConvexDir(convexDir);\n  const relPath = path.relative(projectDir, aiDir);\n  try {\n    await fs.rm(aiDir, { recursive: true });\n    logMessage(`${chalkStderr.green(\"\u2714\")} Deleted ${relPath}/`);\n    return true;\n  } catch (error) {\n    if ((error as { code?: string }).code === \"ENOENT\") return false;\n    Sentry.captureException(error);\n    logMessage(\n      chalkStderr.yellow(`Could not delete ${relPath}/. Remove it manually.`),\n    );\n    return false;\n  }\n}\n\nasync function hasAiFilesBeenInstalledBefore({\n  projectDir,\n  convexDir,\n  aiFilesConfig,\n}: AiFilesPaths & {\n  aiFilesConfig?: AiFilesProjectConfig | undefined;\n}): Promise<boolean> {\n  if (isAiFilesDisabled(aiFilesConfig)) return false;\n  return (\n    (await hasAiState(convexDir)) ||\n    (await hasExistingAiFilesArtifacts({ projectDir, convexDir }))\n  );\n}\n\nexport async function attemptSetupAiFiles({\n  ctx,\n  convexDir,\n  projectDir,\n  aiFilesConfig,\n}: {\n  ctx: Context;\n  aiFilesConfig?: AiFilesProjectConfig | undefined;\n} & AiFilesPaths): Promise<void> {\n  if (!isInInteractiveTerminal()) return;\n  if (isAiFilesDisabled(aiFilesConfig)) return;\n\n  if (\n    await hasAiFilesBeenInstalledBefore({\n      projectDir,\n      convexDir,\n      aiFilesConfig,\n    })\n  ) {\n    await attemptToInstallAiFiles({ projectDir, convexDir, aiFilesConfig });\n    return;\n  }\n\n  const shouldInstall = await promptYesNo(ctx, {\n    message: \"Set up Convex AI files? (guidelines, AGENTS.md, agent skills)\",\n    default: true,\n  });\n\n  if (shouldInstall)\n    await attemptToInstallAiFiles({ projectDir, convexDir, aiFilesConfig });\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import * as Sentry from \"@sentry/node\";\nimport path from \"path\";\nimport { Context } from \"../../../bundler/context.js\";\n// eslint-disable-next-line no-restricted-imports\nimport { promises as fs } from \"fs\";\nimport { chalkStderr } from \"chalk\";\nimport { logMessage } from \"../../../bundler/log.js\";\nimport { promptYesNo } from \"../utils/prompts.js\";\nimport { fetchAgentSkillsCatalog } from \"../versionApi.js\";\nimport { type AiFilesPaths, aiDirForConvexDir } from \"./paths.js\";\nimport {\n  installGuidelinesFile,\n  hasGuidelinesInstalled,\n} from \"./guidelinesmd.js\";\nimport {\n  attemptReadAiState,\n  readAiStateOrDefault,\n  writeAiState,\n  hasAiState,\n} from \"./state.js\";\nimport { type AiFilesProjectConfig } from \"../config.js\";\nimport { exhaustiveCheck, isInInteractiveTerminal } from \"./utils.js\";\nimport {\n  hasAgentsMdInstalled,\n  applyAgentsMdSection,\n  attemptToRemoveAgentsMdSection,\n} from \"./agentsmd.js\";\nimport {\n  hasClaudeMdInstalled,\n  applyClaudeMdSection,\n  attemptToRemoveClaudeMdSection,\n} from \"./claudemd.js\";\nimport { installSkills, removeInstalledSkills } from \"./skills.js\";\nimport { removeLegacyCursorRulesFile as removeLegacyCursorRules } from \"./cursorrules.js\";\n\nasync function hasExistingAiFilesArtifacts({\n  projectDir,\n  convexDir,\n}: AiFilesPaths): Promise<boolean> {\n  return (\n    (await hasGuidelinesInstalled(convexDir)) ||\n    (await hasAgentsMdInstalled(projectDir)) ||\n    (await hasClaudeMdInstalled(projectDir))\n  );\n}\n\ntype InstallAiFilesResult =\n  | { kind: \"success\" }\n  | { kind: \"error\"; message: string };\n\n/**\n * Install or refresh all Convex AI files.\n *\n * Reads the existing state if present, or starts from a blank one for a\n * fresh install.\n *\n * Writes everything it can even when the guidelines download or the skills\n * install fails, and returns an error if either of them failed.\n */\nexport async function installAiFiles({\n  projectDir,\n  convexDir,\n  aiFilesConfig,\n}: AiFilesPaths & {\n  aiFilesConfig?: AiFilesProjectConfig | undefined;\n}): Promise<InstallAiFilesResult> {\n  const convexDirName = path.relative(projectDir, convexDir);\n  const state = await readAiStateOrDefault(convexDir);\n\n  const guidelinesInstalled = await installGuidelinesFile({ convexDir, state });\n  await applyAgentsMdSection({ projectDir, state, convexDirName });\n  await applyClaudeMdSection({ projectDir, state, convexDirName });\n  const skillsInstalled = await installSkills({\n    projectDir,\n    state,\n    aiFilesConfig,\n  });\n  await removeLegacyCursorRules(projectDir);\n  await writeAiState({ state, convexDir });\n\n  if (!guidelinesInstalled || !skillsInstalled) {\n    return {\n      kind: \"error\",\n      message:\n        \"Some Convex AI files could not be installed. See the messages above.\",\n    };\n  }\n  return { kind: \"success\" };\n}\n\nasync function attemptToInstallAiFiles(\n  opts: Parameters<typeof installAiFiles>[0],\n): Promise<void> {\n  try {\n    await installAiFiles(opts);\n  } catch (error) {\n    Sentry.captureException(error);\n  }\n}\n\ntype AiFilesStalenessStatus = \"not-installed\" | \"stale\" | \"silent\";\n\nexport function isAiFilesDisabled(\n  aiFilesConfig: AiFilesProjectConfig | undefined,\n): boolean {\n  if (aiFilesConfig?.enabled !== undefined)\n    return aiFilesConfig.enabled === false;\n  return aiFilesConfig?.disableStalenessMessage === true;\n}\n\nasync function determineAiFilesStaleness({\n  canonicalGuidelinesHash,\n  canonicalAgentSkillsSha,\n  aiFilesConfig,\n  projectDir,\n  convexDir,\n}: {\n  canonicalGuidelinesHash: string | null;\n  canonicalAgentSkillsSha: string | null;\n  aiFilesConfig?: AiFilesProjectConfig | undefined;\n} & AiFilesPaths): Promise<AiFilesStalenessStatus> {\n  if (isAiFilesDisabled(aiFilesConfig)) return \"silent\";\n\n  const result = await attemptReadAiState(convexDir);\n\n  if (result.kind === \"no-file\" || result.kind === \"parse-error\") {\n    const hasArtifacts = await hasExistingAiFilesArtifacts({\n      projectDir,\n      convexDir,\n    });\n    return hasArtifacts ? \"silent\" : \"not-installed\";\n  }\n\n  if (result.kind === \"ok\") {\n    const { state } = result;\n\n    if (canonicalGuidelinesHash === null && canonicalAgentSkillsSha === null)\n      return \"silent\";\n\n    const guidelinesStale =\n      canonicalGuidelinesHash !== null &&\n      state.guidelinesHash !== null &&\n      state.guidelinesHash !== canonicalGuidelinesHash;\n\n    const skillsStale =\n      canonicalAgentSkillsSha !== null &&\n      state.agentSkillsSha !== null &&\n      state.agentSkillsSha !== canonicalAgentSkillsSha;\n\n    return guidelinesStale || skillsStale ? \"stale\" : \"silent\";\n  }\n\n  return exhaustiveCheck(result);\n}\n\n/**\n * Check whether the Convex AI files are out of date and log a nag message\n * if so.\n */\nexport async function checkAiFilesStalenessAndLog(\n  opts: {\n    canonicalGuidelinesHash: string | null;\n    canonicalAgentSkillsSha: string | null;\n    aiFilesConfig?: AiFilesProjectConfig | undefined;\n  } & AiFilesPaths,\n): Promise<void> {\n  const status = await determineAiFilesStaleness(opts);\n\n  if (status === \"not-installed\") {\n    logMessage(\n      chalkStderr.yellow(\n        `Convex AI files are not installed. Run ${chalkStderr.bold(`npx convex ai-files install`)} to get started or ${chalkStderr.bold(`npx convex ai-files disable`)} to hide this message.`,\n      ),\n    );\n    return;\n  }\n\n  if (status === \"stale\") {\n    logMessage(\n      chalkStderr.yellow(\n        `Your Convex AI files are out of date. Run ${chalkStderr.bold(`npx convex ai-files update`)} to get the latest.`,\n      ),\n    );\n    return;\n  }\n\n  if (status === \"silent\") return;\n\n  exhaustiveCheck(status);\n}\n\n/**\n * Installs AI files and returns the aiFiles config to write.\n */\nexport async function enableAiFiles({\n  projectDir,\n  convexDir,\n  aiFilesConfig,\n}: AiFilesPaths & {\n  aiFilesConfig?: AiFilesProjectConfig | undefined;\n}): Promise<AiFilesProjectConfig> {\n  await installAiFiles({ projectDir, convexDir, aiFilesConfig });\n  // Deleting the deprecated disableStalenessMessage key\n  const { disableStalenessMessage: _, ...rest } = aiFilesConfig ?? {};\n  return { ...rest, enabled: true };\n}\n\n/**\n * Returns the aiFiles config to write when disabling AI files.\n */\nexport function disableAiFiles(\n  aiFilesConfig?: AiFilesProjectConfig | undefined,\n): AiFilesProjectConfig {\n  // Deleting the deprecated disableStalenessMessage key\n  const { disableStalenessMessage: _, ...rest } = aiFilesConfig ?? {};\n  return { ...rest, enabled: false };\n}\n\nexport type RemoveAiFilesResult =\n  | { kind: \"success\" }\n  | { kind: \"error\"; message: string };\n\n/**\n * Remove all Convex AI files from the project.\n * Called by `npx convex ai-files remove`.\n */\nexport async function removeAiFiles({\n  projectDir,\n  convexDir,\n}: AiFilesPaths): Promise<RemoveAiFilesResult> {\n  const agentSkillsCatalog = await fetchAgentSkillsCatalog();\n  if (agentSkillsCatalog.kind === \"error\") {\n    return {\n      kind: \"error\",\n      message:\n        \"Could not fetch canonical agent skills from version.convex.dev. Aborting `convex ai-files remove`.\",\n    };\n  }\n\n  const removals = [\n    await attemptToRemoveAgentsMdSection(projectDir),\n    await attemptToRemoveClaudeMdSection(projectDir),\n    (await removeInstalledSkills({\n      projectDir,\n      skillNames: agentSkillsCatalog.data.skills.map(\n        ({ skillName }) => skillName,\n      ),\n    })) === \"removed\",\n    await removeLegacyCursorRules(projectDir),\n    await attemptToDeleteAiDir({ projectDir, convexDir }),\n  ];\n\n  if (removals.some(Boolean)) logMessage(\"Convex AI files removed.\");\n  else logMessage(\"No Convex AI files found \u2014 nothing to remove.\");\n  return { kind: \"success\" };\n}\n\nasync function attemptToDeleteAiDir({\n  projectDir,\n  convexDir,\n}: AiFilesPaths): Promise<boolean> {\n  const aiDir = aiDirForConvexDir(convexDir);\n  const relPath = path.relative(projectDir, aiDir);\n  try {\n    await fs.rm(aiDir, { recursive: true });\n    logMessage(`${chalkStderr.green(\"\u2714\")} Deleted ${relPath}/`);\n    return true;\n  } catch (error) {\n    if ((error as { code?: string }).code === \"ENOENT\") return false;\n    Sentry.captureException(error);\n    logMessage(\n      chalkStderr.yellow(`Could not delete ${relPath}/. Remove it manually.`),\n    );\n    return false;\n  }\n}\n\nasync function hasAiFilesBeenInstalledBefore({\n  projectDir,\n  convexDir,\n  aiFilesConfig,\n}: AiFilesPaths & {\n  aiFilesConfig?: AiFilesProjectConfig | undefined;\n}): Promise<boolean> {\n  if (isAiFilesDisabled(aiFilesConfig)) return false;\n  return (\n    (await hasAiState(convexDir)) ||\n    (await hasExistingAiFilesArtifacts({ projectDir, convexDir }))\n  );\n}\n\nexport async function attemptSetupAiFiles({\n  ctx,\n  convexDir,\n  projectDir,\n  aiFilesConfig,\n}: {\n  ctx: Context;\n  aiFilesConfig?: AiFilesProjectConfig | undefined;\n} & AiFilesPaths): Promise<void> {\n  if (!isInInteractiveTerminal()) return;\n  if (isAiFilesDisabled(aiFilesConfig)) return;\n\n  if (\n    await hasAiFilesBeenInstalledBefore({\n      projectDir,\n      convexDir,\n      aiFilesConfig,\n    })\n  ) {\n    await attemptToInstallAiFiles({ projectDir, convexDir, aiFilesConfig });\n    return;\n  }\n\n  const shouldInstall = await promptYesNo(ctx, {\n    message: \"Set up Convex AI files? (guidelines, AGENTS.md, agent skills)\",\n    default: true,\n  });\n\n  if (shouldInstall)\n    await attemptToInstallAiFiles({ projectDir, convexDir, aiFilesConfig });\n}\n"],
+  "mappings": ";AAAA,YAAY,YAAY;AACxB,OAAO,UAAU;AAGjB,SAAS,YAAY,UAAU;AAC/B,SAAS,mBAAmB;AAC5B,SAAS,kBAAkB;AAC3B,SAAS,mBAAmB;AAC5B,SAAS,+BAA+B;AACxC,SAA4B,yBAAyB;AACrD;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,iBAAiB,+BAA+B;AACzD;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,eAAe,6BAA6B;AACrD,SAAS,+BAA+B,+BAA+B;AAEvE,eAAe,4BAA4B;AAAA,EACzC;AAAA,EACA;AACF,GAAmC;AACjC,SACG,MAAM,uBAAuB,SAAS,KACtC,MAAM,qBAAqB,UAAU,KACrC,MAAM,qBAAqB,UAAU;AAE1C;AAeA,sBAAsB,eAAe;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AACF,GAEkC;AAChC,QAAM,gBAAgB,KAAK,SAAS,YAAY,SAAS;AACzD,QAAM,QAAQ,MAAM,qBAAqB,SAAS;AAElD,QAAM,sBAAsB,MAAM,sBAAsB,EAAE,WAAW,MAAM,CAAC;AAC5E,QAAM,qBAAqB,EAAE,YAAY,OAAO,cAAc,CAAC;AAC/D,QAAM,qBAAqB,EAAE,YAAY,OAAO,cAAc,CAAC;AAC/D,QAAM,kBAAkB,MAAM,cAAc;AAAA,IAC1C;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACD,QAAM,wBAAwB,UAAU;AACxC,QAAM,aAAa,EAAE,OAAO,UAAU,CAAC;AAEvC,MAAI,CAAC,uBAAuB,CAAC,iBAAiB;AAC5C,WAAO;AAAA,MACL,MAAM;AAAA,MACN,SACE;AAAA,IACJ;AAAA,EACF;AACA,SAAO,EAAE,MAAM,UAAU;AAC3B;AAEA,eAAe,wBACb,MACe;AACf,MAAI;AACF,UAAM,eAAe,IAAI;AAAA,EAC3B,SAAS,OAAO;AACd,WAAO,iBAAiB,KAAK;AAAA,EAC/B;AACF;AAIO,gBAAS,kBACd,eACS;AACT,MAAI,eAAe,YAAY;AAC7B,WAAO,cAAc,YAAY;AACnC,SAAO,eAAe,4BAA4B;AACpD;AAEA,eAAe,0BAA0B;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAImD;AACjD,MAAI,kBAAkB,aAAa,EAAG,QAAO;AAE7C,QAAM,SAAS,MAAM,mBAAmB,SAAS;AAEjD,MAAI,OAAO,SAAS,aAAa,OAAO,SAAS,eAAe;AAC9D,UAAM,eAAe,MAAM,4BAA4B;AAAA,MACrD;AAAA,MACA;AAAA,IACF,CAAC;AACD,WAAO,eAAe,WAAW;AAAA,EACnC;AAEA,MAAI,OAAO,SAAS,MAAM;AACxB,UAAM,EAAE,MAAM,IAAI;AAElB,QAAI,4BAA4B,QAAQ,4BAA4B;AAClE,aAAO;AAET,UAAM,kBACJ,4BAA4B,QAC5B,MAAM,mBAAmB,QACzB,MAAM,mBAAmB;AAE3B,UAAM,cACJ,4BAA4B,QAC5B,MAAM,mBAAmB,QACzB,MAAM,mBAAmB;AAE3B,WAAO,mBAAmB,cAAc,UAAU;AAAA,EACpD;AAEA,SAAO,gBAAgB,MAAM;AAC/B;AAMA,sBAAsB,4BACpB,MAKe;AACf,QAAM,SAAS,MAAM,0BAA0B,IAAI;AAEnD,MAAI,WAAW,iBAAiB;AAC9B;AAAA,MACE,YAAY;AAAA,QACV,0CAA0C,YAAY,KAAK,6BAA6B,CAAC,sBAAsB,YAAY,KAAK,6BAA6B,CAAC;AAAA,MAChK;AAAA,IACF;AACA;AAAA,EACF;AAEA,MAAI,WAAW,SAAS;AACtB;AAAA,MACE,YAAY;AAAA,QACV,6CAA6C,YAAY,KAAK,4BAA4B,CAAC;AAAA,MAC7F;AAAA,IACF;AACA;AAAA,EACF;AAEA,MAAI,WAAW,SAAU;AAEzB,kBAAgB,MAAM;AACxB;AAKA,sBAAsB,cAAc;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AACF,GAEkC;AAChC,QAAM,eAAe,EAAE,YAAY,WAAW,cAAc,CAAC;AAE7D,QAAM,EAAE,yBAAyB,GAAG,GAAG,KAAK,IAAI,iBAAiB,CAAC;AAClE,SAAO,EAAE,GAAG,MAAM,SAAS,KAAK;AAClC;AAKO,gBAAS,eACd,eACsB;AAEtB,QAAM,EAAE,yBAAyB,GAAG,GAAG,KAAK,IAAI,iBAAiB,CAAC;AAClE,SAAO,EAAE,GAAG,MAAM,SAAS,MAAM;AACnC;AAUA,sBAAsB,cAAc;AAAA,EAClC;AAAA,EACA;AACF,GAA+C;AAC7C,QAAM,qBAAqB,MAAM,wBAAwB;AACzD,MAAI,mBAAmB,SAAS,SAAS;AACvC,WAAO;AAAA,MACL,MAAM;AAAA,MACN,SACE;AAAA,IACJ;AAAA,EACF;AAEA,QAAM,WAAW;AAAA,IACf,MAAM,+BAA+B,UAAU;AAAA,IAC/C,MAAM,+BAA+B,UAAU;AAAA,IAC9C,MAAM,sBAAsB;AAAA,MAC3B;AAAA,MACA,YAAY,mBAAmB,KAAK,OAAO;AAAA,QACzC,CAAC,EAAE,UAAU,MAAM;AAAA,MACrB;AAAA,IACF,CAAC,MAAO;AAAA,IACR,MAAM,wBAAwB,UAAU;AAAA,IACxC,MAAM,qBAAqB,EAAE,YAAY,UAAU,CAAC;AAAA,EACtD;AAEA,MAAI,SAAS,KAAK,OAAO,EAAG,YAAW,0BAA0B;AAAA,MAC5D,YAAW,oDAA+C;AAC/D,SAAO,EAAE,MAAM,UAAU;AAC3B;AAEA,eAAe,qBAAqB;AAAA,EAClC;AAAA,EACA;AACF,GAAmC;AACjC,QAAM,QAAQ,kBAAkB,SAAS;AACzC,QAAM,UAAU,KAAK,SAAS,YAAY,KAAK;AAC/C,MAAI;AACF,UAAM,GAAG,GAAG,OAAO,EAAE,WAAW,KAAK,CAAC;AACtC,eAAW,GAAG,YAAY,MAAM,QAAG,CAAC,YAAY,OAAO,GAAG;AAC1D,WAAO;AAAA,EACT,SAAS,OAAO;AACd,QAAK,MAA4B,SAAS,SAAU,QAAO;AAC3D,WAAO,iBAAiB,KAAK;AAC7B;AAAA,MACE,YAAY,OAAO,oBAAoB,OAAO,wBAAwB;AAAA,IACxE;AACA,WAAO;AAAA,EACT;AACF;AAEA,eAAe,8BAA8B;AAAA,EAC3C;AAAA,EACA;AAAA,EACA;AACF,GAEqB;AACnB,MAAI,kBAAkB,aAAa,EAAG,QAAO;AAC7C,SACG,MAAM,WAAW,SAAS,KAC1B,MAAM,4BAA4B,EAAE,YAAY,UAAU,CAAC;AAEhE;AAEA,sBAAsB,oBAAoB;AAAA,EACxC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAGiC;AAC/B,MAAI,CAAC,wBAAwB,EAAG;AAChC,MAAI,kBAAkB,aAAa,EAAG;AAEtC,MACE,MAAM,8BAA8B;AAAA,IAClC;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC,GACD;AACA,UAAM,wBAAwB,EAAE,YAAY,WAAW,cAAc,CAAC;AACtE;AAAA,EACF;AAEA,QAAM,gBAAgB,MAAM,YAAY,KAAK;AAAA,IAC3C,SAAS;AAAA,IACT,SAAS;AAAA,EACX,CAAC;AAED,MAAI;AACF,UAAM,wBAAwB,EAAE,YAAY,WAAW,cAAc,CAAC;AAC1E;",
   "names": []
 }

package/dist/esm/cli/lib/aiFiles/skills.js

@@ -11,7 +11,7 @@ function configuredSkillAgents(aiFilesConfig) {
   return aiFilesConfig?.skills?.agents ?? defaultAgents;
 }
 function runSkillsAdd(cwd, agents) {
-  const args = ["add", "get-convex/agent-skills", "--yes", "--copy"];
+  const args = ["add", "convex/agent-skills", "--yes", "--copy"];
   for (const agent of agents) {
     args.push("--agent", agent);
   }
@@ -67,21 +67,22 @@ export async function installSkills({
   aiFilesConfig
 }) {
   const agents = configuredSkillAgents(aiFilesConfig);
-  if (agents.length === 0) return;
-  if (!await shouldRunSkillsCli()) return;
+  if (agents.length === 0) return true;
+  if (!await shouldRunSkillsCli()) return true;
   logMessage("Installing Convex agent skills...");
   const skillsOk = await runSkillsAdd(projectDir, agents);
   if (!skillsOk) {
     logMessage(
       chalkStderr.yellow(
-        "Could not install agent skills. You can retry manually with: npx skills add get-convex/agent-skills --copy"
+        "Could not install agent skills. You can retry manually with: npx skills add convex/agent-skills --copy"
       )
     );
-    return;
+    return false;
   }
   const sha = await fetchAgentSkillsSha();
   if (sha) state.agentSkillsSha = sha;
   logMessage(`${chalkStderr.green("\u2714")} Skills installed`);
+  return true;
 }
 export async function removeInstalledSkills({
   projectDir,