convex 1.34.0 → 1.35.0

package/dist/cjs/cli/dev.js

@@ -22,6 +22,7 @@ __export(dev_exports, {
 });
 module.exports = __toCommonJS(dev_exports);
 var import_extra_typings = require("@commander-js/extra-typings");
+var import_chalk = require("chalk");
 var import_context = require("../bundler/context.js");
 var import_log = require("../bundler/log.js");
 var import_configure = require("./configure.js");
@@ -32,7 +33,7 @@ var import_utils = require("./lib/utils/utils.js");
 var import_deploymentSelection = require("./lib/deploymentSelection.js");
 var import_updates = require("./lib/updates.js");
 const dev = new import_extra_typings.Command("dev").summary("Develop against a dev deployment, watching for changes").description(
-  "Develop against a dev deployment, watching for changes\n\n  1. Configures a new or existing project (if needed)\n  2. Updates generated types and pushes code to the configured dev deployment\n  3. Runs the provided command (if `--run` or `--run-sh` is used)\n  4. Watches for file changes, and repeats step 2\n"
+  "Develop against a dev deployment, watching for changes\n\n  1. Configures a new or existing project (if needed)\n  2. Updates generated types and pushes code to the configured dev deployment\n  3. Runs the provided command (if `--start` or `--run` is used)\n  4. Watches for file changes, and repeats step 2\n"
 ).allowExcessArguments(false).option("-v, --verbose", "Show full listing of changes").addOption(
   new import_extra_typings.Option(
     "--typecheck <mode>",
@@ -57,19 +58,21 @@ const dev = new import_extra_typings.Command("dev").summary("Develop against a d
   "--until-success",
   "Execute only the first 3 steps, on failure watch for local and remote changes and retry steps 2 and 3",
   false
+).addOption(
+  new import_extra_typings.Option(
+    "--start <command>",
+    "Start a long-running command alongside `convex dev`, like a frontend dev server. The command inherits stdin/stdout so you can interact with it directly. Example: npx convex dev --start 'vite --open'"
+  ).conflicts(["--run", "--run-sh"])
+).addOption(
+  new import_extra_typings.Option("--run-sh <command>", "Deprecated: use --start instead.").conflicts(["--start", "--run"]).hideHelp()
 ).addOption(
   new import_extra_typings.Option(
     "--run <functionName>",
     "The identifier of the function to run in step 3, like `api.init.createData` or `myDir/myFile:myFunction`"
-  ).conflicts(["--run-sh"])
+  ).conflicts(["--start"])
 ).option(
   "--run-component <functionName>",
   "If --run is used and the function is in a component, the path the component tree defined in convex.config.ts. Components are a beta feature. This flag is unstable and may change in subsequent releases."
-).addOption(
-  new import_extra_typings.Option(
-    "--run-sh <command>",
-    "A shell command to run in step 3, like `node myScript.js`. If you just want to run a Convex function, use `--run` instead."
-  ).conflicts(["--run"])
 ).addOption(
   new import_extra_typings.Option(
     "--tail-logs [mode]",
@@ -79,7 +82,7 @@ const dev = new import_extra_typings.Command("dev").summary("Develop against a d
   new import_extra_typings.Option(
     "--configure [choice]",
     "Ignore existing configuration and configure new or existing project, interactively or set by --team <team_slug>, --project <project_slug>, and --dev-deployment local|cloud"
-  ).choices(["new", "existing"]).conflicts(["--local", "--cloud"])
+  ).choices(["new", "existing"]).conflicts(["--local", "--cloud", "--url", "--admin-key", "--env-file"])
 ).addOption(
   new import_extra_typings.Option(
     "--team <team_slug>",
@@ -105,7 +108,7 @@ const dev = new import_extra_typings.Command("dev").summary("Develop against a d
     "--env-file <envFile>",
     `Path to a custom file of environment variables, for choosing the deployment, e.g. ${import_utils.CONVEX_DEPLOYMENT_ENV_VAR_NAME} or ${import_utils.CONVEX_SELF_HOSTED_URL_VAR_NAME}. Same format as .env.local or .env files, and overrides them.`
   )
-).addOption(new import_extra_typings.Option("--skip-push").default(false).hideHelp()).addOption(new import_extra_typings.Option("--admin-key <adminKey>").hideHelp()).addOption(new import_extra_typings.Option("--url <url>").hideHelp()).addOption(new import_extra_typings.Option("--override-auth-url <url>").hideHelp()).addOption(new import_extra_typings.Option("--override-auth-client <id>").hideHelp()).addOption(new import_extra_typings.Option("--override-auth-username <username>").hideHelp()).addOption(new import_extra_typings.Option("--override-auth-password <password>").hideHelp()).addOption(new import_extra_typings.Option("--local-cloud-port <port>").hideHelp()).addOption(new import_extra_typings.Option("--local-site-port <port>").hideHelp()).addOption(new import_extra_typings.Option("--local-backend-version <version>").hideHelp()).addOption(new import_extra_typings.Option("--local-force-upgrade").default(false).hideHelp()).addOption(
+).addOption(new import_extra_typings.Option("--skip-push").default(false).hideHelp()).addOption(new import_extra_typings.Option("--admin-key <adminKey>").hideHelp()).addOption(new import_extra_typings.Option("--url <url>").hideHelp()).addOption(new import_extra_typings.Option("--override-auth-url <url>").hideHelp()).addOption(new import_extra_typings.Option("--override-auth-client <id>").hideHelp()).addOption(new import_extra_typings.Option("--override-auth-username <username>").hideHelp()).addOption(new import_extra_typings.Option("--override-auth-password <password>").hideHelp()).addOption(new import_extra_typings.Option("--local-cloud-port <port>").hideHelp()).addOption(new import_extra_typings.Option("--local-site-port <port>").hideHelp()).addOption(new import_extra_typings.Option("--local-backend-version <version>").hideHelp()).addOption(new import_extra_typings.Option("--local-force-upgrade").default(false).hideHelp()).addOption(new import_extra_typings.Option("--deployment <deployment>").hideHelp()).addOption(
   new import_extra_typings.Option(
     "--local",
     "Use local deployment regardless of last used backend. DB data will not be downloaded from any cloud deployment."
@@ -121,6 +124,16 @@ const dev = new import_extra_typings.Command("dev").summary("Develop against a d
     (0, import_log.logVerbose)("Received SIGINT, cleaning up...");
     await ctx.flushAndExit(-2);
   });
+  if (cmdOptions.deployment !== void 0) {
+    return await ctx.crash({
+      exitCode: 1,
+      errorType: "fatal",
+      printedMessage: "`--deployment` can\u2019t be used with `npx convex dev`. \n\n  To select this deployment for development, run: \n" + import_chalk.chalkStderr.bold(
+        `      npx convex deployment select ${cmdOptions.deployment}
+`
+      ) + "  Then, run `npx convex dev` again."
+    });
+  }
   const devOptions = await (0, import_command.normalizeDevOptions)(ctx, cmdOptions);
   if (cmdOptions.configure === void 0) {
     if (cmdOptions.team || cmdOptions.project || cmdOptions.devDeployment)
@@ -157,7 +170,13 @@ const dev = new import_extra_typings.Command("dev").summary("Develop against a d
     localOptions["forceUpgrade"] = cmdOptions.localForceUpgrade;
   }
   const configure = cmdOptions.configure === true ? "ask" : cmdOptions.configure ?? null;
-  const deploymentSelection = await (0, import_deploymentSelection.getDeploymentSelection)(ctx, cmdOptions);
+  const deploymentSelection = configure !== null ? {
+    kind: "chooseProject",
+    selectionWithinProject: {
+      // For backwards compatibility, allow `--configure --prod`
+      kind: cmdOptions.prod ? "prod" : "unspecified"
+    }
+  } : await (0, import_deploymentSelection.getDeploymentSelection)(ctx, cmdOptions);
   const credentials = await (0, import_configure.deploymentCredentialsOrConfigure)(
     ctx,
     deploymentSelection,
@@ -184,7 +203,7 @@ const dev = new import_extra_typings.Command("dev").summary("Develop against a d
     ] : [],
     ...credentials.deploymentFields !== null ? [
       (0, import_usage.usageStateWarning)(ctx, credentials.deploymentFields.deploymentName),
-      (0, import_updates.checkVersion)(ctx)
+      (0, import_updates.checkVersionAndAiFilesStaleness)(ctx)
     ] : []
   ]);
 });

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/cli/dev.ts"],
-  "sourcesContent": ["import { Command, Option } from \"@commander-js/extra-typings\";\nimport { oneoffContext } from \"../bundler/context.js\";\nimport { logVerbose } from \"../bundler/log.js\";\nimport { deploymentCredentialsOrConfigure } from \"./configure.js\";\nimport { usageStateWarning } from \"./lib/usage.js\";\nimport { normalizeDevOptions } from \"./lib/command.js\";\nimport { devAgainstDeployment } from \"./lib/dev.js\";\nimport {\n  CONVEX_DEPLOYMENT_ENV_VAR_NAME,\n  CONVEX_SELF_HOSTED_URL_VAR_NAME,\n} from \"./lib/utils/utils.js\";\nimport { getDeploymentSelection } from \"./lib/deploymentSelection.js\";\nimport { checkVersion } from \"./lib/updates.js\";\n\nexport const dev = new Command(\"dev\")\n  .summary(\"Develop against a dev deployment, watching for changes\")\n  .description(\n    \"Develop against a dev deployment, watching for changes\\n\\n\" +\n      \"  1. Configures a new or existing project (if needed)\\n\" +\n      \"  2. Updates generated types and pushes code to the configured dev deployment\\n\" +\n      \"  3. Runs the provided command (if `--run` or `--run-sh` is used)\\n\" +\n      \"  4. Watches for file changes, and repeats step 2\\n\",\n  )\n  .allowExcessArguments(false)\n  .option(\"-v, --verbose\", \"Show full listing of changes\")\n  .addOption(\n    new Option(\n      \"--typecheck <mode>\",\n      `Check TypeScript files with \\`tsc --noEmit\\`.`,\n    )\n      .choices([\"enable\", \"try\", \"disable\"] as const)\n      .default(\"try\" as const),\n  )\n  .option(\n    \"--typecheck-components\",\n    \"Check TypeScript files within component implementations with `tsc --noEmit`.\",\n    false,\n  )\n  .addOption(\n    new Option(\"--codegen <mode>\", \"Regenerate code in `convex/_generated/`\")\n      .choices([\"enable\", \"disable\"] as const)\n      .default(\"enable\" as const),\n  )\n  .addOption(\n    new Option(\n      \"--push-all-modules\",\n      \"Push all modules without checking for unchanged module hashes from the server\",\n    )\n      .default(false)\n      .hideHelp(),\n  )\n  .option(\n    \"--once\",\n    \"Execute only the first 3 steps, stop on any failure\",\n    false,\n  )\n  .option(\n    \"--until-success\",\n    \"Execute only the first 3 steps, on failure watch for local and remote changes and retry steps 2 and 3\",\n    false,\n  )\n  .addOption(\n    new Option(\n      \"--run <functionName>\",\n      \"The identifier of the function to run in step 3, \" +\n        \"like `api.init.createData` or `myDir/myFile:myFunction`\",\n    ).conflicts([\"--run-sh\"]),\n  )\n  .option(\n    \"--run-component <functionName>\",\n    \"If --run is used and the function is in a component, the path the component tree defined in convex.config.ts. \" +\n      \"Components are a beta feature. This flag is unstable and may change in subsequent releases.\",\n  )\n  .addOption(\n    new Option(\n      \"--run-sh <command>\",\n      \"A shell command to run in step 3, like `node myScript.js`. \" +\n        \"If you just want to run a Convex function, use `--run` instead.\",\n    ).conflicts([\"--run\"]),\n  )\n  .addOption(\n    new Option(\n      \"--tail-logs [mode]\",\n      \"Choose whether to tail Convex function logs in this terminal\",\n    )\n      .choices([\"always\", \"pause-on-deploy\", \"disable\"] as const)\n      .default(\"pause-on-deploy\"),\n  )\n  .addOption(new Option(\"--trace-events\").default(false).hideHelp())\n  .addOption(new Option(\"--debug-bundle-path <path>\").hideHelp())\n  .addOption(new Option(\"--debug-node-apis\").hideHelp())\n  .addOption(new Option(\"--live-component-sources\").hideHelp())\n  .addOption(\n    new Option(\n      \"--configure [choice]\",\n      \"Ignore existing configuration and configure new or existing project, interactively or set by --team <team_slug>, --project <project_slug>, and --dev-deployment local|cloud\",\n    )\n      .choices([\"new\", \"existing\"] as const)\n      .conflicts([\"--local\", \"--cloud\"]),\n  )\n  .addOption(\n    new Option(\n      \"--team <team_slug>\",\n      \"The team you'd like to use for this project\",\n    ).hideHelp(),\n  )\n  .addOption(\n    new Option(\n      \"--project <project_slug>\",\n      \"The name of the project you'd like to configure\",\n    ).hideHelp(),\n  )\n  .addOption(\n    new Option(\n      \"--dev-deployment <mode>\",\n      \"Use a local or cloud deployment for dev for this project\",\n    )\n      .choices([\"cloud\", \"local\"] as const)\n      .conflicts([\"--prod\"])\n      .hideHelp(),\n  )\n  .addOption(\n    new Option(\n      \"--prod\",\n      \"Develop live against this project's production deployment.\",\n    )\n      .default(false)\n      .hideHelp(),\n  )\n  .addOption(\n    new Option(\n      \"--env-file <envFile>\",\n      `Path to a custom file of environment variables, for choosing the \\\ndeployment, e.g. ${CONVEX_DEPLOYMENT_ENV_VAR_NAME} or ${CONVEX_SELF_HOSTED_URL_VAR_NAME}. \\\nSame format as .env.local or .env files, and overrides them.`,\n    ),\n  )\n  .addOption(new Option(\"--skip-push\").default(false).hideHelp())\n  .addOption(new Option(\"--admin-key <adminKey>\").hideHelp())\n  .addOption(new Option(\"--url <url>\").hideHelp())\n  // Options for testing\n  .addOption(new Option(\"--override-auth-url <url>\").hideHelp())\n  .addOption(new Option(\"--override-auth-client <id>\").hideHelp())\n  .addOption(new Option(\"--override-auth-username <username>\").hideHelp())\n  .addOption(new Option(\"--override-auth-password <password>\").hideHelp())\n  .addOption(new Option(\"--local-cloud-port <port>\").hideHelp())\n  .addOption(new Option(\"--local-site-port <port>\").hideHelp())\n  .addOption(new Option(\"--local-backend-version <version>\").hideHelp())\n  .addOption(new Option(\"--local-force-upgrade\").default(false).hideHelp())\n  .addOption(\n    new Option(\n      \"--local\",\n      \"Use local deployment regardless of last used backend. DB data will not be downloaded from any cloud deployment.\",\n    )\n      .default(false)\n      .conflicts([\"--prod\", \"--url\", \"--admin-key\", \"--cloud\"])\n      .hideHelp(),\n  )\n  .addOption(\n    new Option(\n      \"--cloud\",\n      \"Use cloud deployment regardles of last used backend. DB data will not be uploaded from local.\",\n    )\n      .default(false)\n      .conflicts([\"--prod\", \"--url\", \"--admin-key\", \"--local\"])\n      .hideHelp(),\n  )\n  .showHelpAfterError()\n  .action(async (cmdOptions) => {\n    const ctx = await oneoffContext(cmdOptions);\n    process.on(\"SIGINT\", async () => {\n      logVerbose(\"Received SIGINT, cleaning up...\");\n      await ctx.flushAndExit(-2);\n    });\n\n    const devOptions = await normalizeDevOptions(ctx, cmdOptions);\n\n    if (cmdOptions.configure === undefined) {\n      if (cmdOptions.team || cmdOptions.project || cmdOptions.devDeployment)\n        return await ctx.crash({\n          exitCode: 1,\n          errorType: \"fatal\",\n          printedMessage:\n            \"`--team, --project, and --dev-deployment can can only be used with `--configure`.\",\n        });\n    }\n\n    const localOptions: {\n      ports?: { cloud: number; site: number };\n      backendVersion?: string | undefined;\n      forceUpgrade: boolean;\n    } = { forceUpgrade: false };\n    if (!cmdOptions.local && cmdOptions.devDeployment !== \"local\") {\n      if (\n        cmdOptions.localCloudPort !== undefined ||\n        cmdOptions.localSitePort !== undefined ||\n        cmdOptions.localBackendVersion !== undefined ||\n        cmdOptions.localForceUpgrade === true\n      ) {\n        return await ctx.crash({\n          exitCode: 1,\n          errorType: \"fatal\",\n          printedMessage:\n            \"`--local-*` options can only be used with `--configure --dev-deployment local` or `--local`.\",\n        });\n      }\n    } else {\n      if (cmdOptions.localCloudPort !== undefined) {\n        if (cmdOptions.localSitePort === undefined) {\n          return await ctx.crash({\n            exitCode: 1,\n            errorType: \"fatal\",\n            printedMessage:\n              \"`--local-cloud-port` requires `--local-site-port` to be set.\",\n          });\n        }\n        localOptions[\"ports\"] = {\n          cloud: parseInt(cmdOptions.localCloudPort),\n          site: parseInt(cmdOptions.localSitePort),\n        };\n      }\n      localOptions[\"backendVersion\"] = cmdOptions.localBackendVersion;\n      localOptions[\"forceUpgrade\"] = cmdOptions.localForceUpgrade;\n    }\n\n    const configure =\n      cmdOptions.configure === true ? \"ask\" : (cmdOptions.configure ?? null);\n    const deploymentSelection = await getDeploymentSelection(ctx, cmdOptions);\n    const credentials = await deploymentCredentialsOrConfigure(\n      ctx,\n      deploymentSelection,\n      configure,\n      {\n        ...cmdOptions,\n        localOptions,\n      },\n    );\n\n    await Promise.all([\n      ...(!cmdOptions.skipPush\n        ? [\n            devAgainstDeployment(\n              ctx,\n              {\n                url: credentials.url,\n                adminKey: credentials.adminKey,\n                deploymentName:\n                  credentials.deploymentFields?.deploymentName ?? null,\n                ...(credentials.deploymentFields?.deploymentType !== undefined\n                  ? {\n                      deploymentType:\n                        credentials.deploymentFields.deploymentType,\n                    }\n                  : {}),\n              },\n              devOptions,\n            ),\n          ]\n        : []),\n      ...(credentials.deploymentFields !== null\n        ? [\n            usageStateWarning(ctx, credentials.deploymentFields.deploymentName),\n            checkVersion(ctx),\n          ]\n        : []),\n    ]);\n  });\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { Command, Option } from \"@commander-js/extra-typings\";\nimport { chalkStderr } from \"chalk\";\nimport { oneoffContext } from \"../bundler/context.js\";\nimport { logVerbose } from \"../bundler/log.js\";\nimport { deploymentCredentialsOrConfigure } from \"./configure.js\";\nimport { usageStateWarning } from \"./lib/usage.js\";\nimport { normalizeDevOptions } from \"./lib/command.js\";\nimport { devAgainstDeployment } from \"./lib/dev.js\";\nimport {\n  CONVEX_DEPLOYMENT_ENV_VAR_NAME,\n  CONVEX_SELF_HOSTED_URL_VAR_NAME,\n} from \"./lib/utils/utils.js\";\nimport {\n  getDeploymentSelection,\n  type DeploymentSelection,\n} from \"./lib/deploymentSelection.js\";\nimport { checkVersionAndAiFilesStaleness } from \"./lib/updates.js\";\n\nexport const dev = new Command(\"dev\")\n  .summary(\"Develop against a dev deployment, watching for changes\")\n  .description(\n    \"Develop against a dev deployment, watching for changes\\n\\n\" +\n      \"  1. Configures a new or existing project (if needed)\\n\" +\n      \"  2. Updates generated types and pushes code to the configured dev deployment\\n\" +\n      \"  3. Runs the provided command (if `--start` or `--run` is used)\\n\" +\n      \"  4. Watches for file changes, and repeats step 2\\n\",\n  )\n  .allowExcessArguments(false)\n  .option(\"-v, --verbose\", \"Show full listing of changes\")\n  .addOption(\n    new Option(\n      \"--typecheck <mode>\",\n      `Check TypeScript files with \\`tsc --noEmit\\`.`,\n    )\n      .choices([\"enable\", \"try\", \"disable\"] as const)\n      .default(\"try\" as const),\n  )\n  .option(\n    \"--typecheck-components\",\n    \"Check TypeScript files within component implementations with `tsc --noEmit`.\",\n    false,\n  )\n  .addOption(\n    new Option(\"--codegen <mode>\", \"Regenerate code in `convex/_generated/`\")\n      .choices([\"enable\", \"disable\"] as const)\n      .default(\"enable\" as const),\n  )\n  .addOption(\n    new Option(\n      \"--push-all-modules\",\n      \"Push all modules without checking for unchanged module hashes from the server\",\n    )\n      .default(false)\n      .hideHelp(),\n  )\n  .option(\n    \"--once\",\n    \"Execute only the first 3 steps, stop on any failure\",\n    false,\n  )\n  .option(\n    \"--until-success\",\n    \"Execute only the first 3 steps, on failure watch for local and remote changes and retry steps 2 and 3\",\n    false,\n  )\n  .addOption(\n    new Option(\n      \"--start <command>\",\n      \"Start a long-running command alongside `convex dev`, like a frontend \" +\n        \"dev server. The command inherits stdin/stdout so you can interact \" +\n        \"with it directly. Example: npx convex dev --start 'vite --open'\",\n    ).conflicts([\"--run\", \"--run-sh\"]),\n  )\n  .addOption(\n    new Option(\"--run-sh <command>\", \"Deprecated: use --start instead.\")\n      .conflicts([\"--start\", \"--run\"])\n      .hideHelp(),\n  )\n  .addOption(\n    new Option(\n      \"--run <functionName>\",\n      \"The identifier of the function to run in step 3, \" +\n        \"like `api.init.createData` or `myDir/myFile:myFunction`\",\n    ).conflicts([\"--start\"]),\n  )\n  .option(\n    \"--run-component <functionName>\",\n    \"If --run is used and the function is in a component, the path the component tree defined in convex.config.ts. \" +\n      \"Components are a beta feature. This flag is unstable and may change in subsequent releases.\",\n  )\n  .addOption(\n    new Option(\n      \"--tail-logs [mode]\",\n      \"Choose whether to tail Convex function logs in this terminal\",\n    )\n      .choices([\"always\", \"pause-on-deploy\", \"disable\"] as const)\n      .default(\"pause-on-deploy\"),\n  )\n  .addOption(new Option(\"--trace-events\").default(false).hideHelp())\n  .addOption(new Option(\"--debug-bundle-path <path>\").hideHelp())\n  .addOption(new Option(\"--debug-node-apis\").hideHelp())\n  .addOption(new Option(\"--live-component-sources\").hideHelp())\n  .addOption(\n    new Option(\n      \"--configure [choice]\",\n      \"Ignore existing configuration and configure new or existing project, interactively or set by --team <team_slug>, --project <project_slug>, and --dev-deployment local|cloud\",\n    )\n      .choices([\"new\", \"existing\"] as const)\n      .conflicts([\"--local\", \"--cloud\", \"--url\", \"--admin-key\", \"--env-file\"]),\n  )\n  .addOption(\n    new Option(\n      \"--team <team_slug>\",\n      \"The team you'd like to use for this project\",\n    ).hideHelp(),\n  )\n  .addOption(\n    new Option(\n      \"--project <project_slug>\",\n      \"The name of the project you'd like to configure\",\n    ).hideHelp(),\n  )\n  .addOption(\n    new Option(\n      \"--dev-deployment <mode>\",\n      \"Use a local or cloud deployment for dev for this project\",\n    )\n      .choices([\"cloud\", \"local\"] as const)\n      .conflicts([\"--prod\"])\n      .hideHelp(),\n  )\n  .addOption(\n    new Option(\n      \"--prod\",\n      \"Develop live against this project's production deployment.\",\n    )\n      .default(false)\n      .hideHelp(),\n  )\n  .addOption(\n    new Option(\n      \"--env-file <envFile>\",\n      `Path to a custom file of environment variables, for choosing the \\\ndeployment, e.g. ${CONVEX_DEPLOYMENT_ENV_VAR_NAME} or ${CONVEX_SELF_HOSTED_URL_VAR_NAME}. \\\nSame format as .env.local or .env files, and overrides them.`,\n    ),\n  )\n  .addOption(new Option(\"--skip-push\").default(false).hideHelp())\n  .addOption(new Option(\"--admin-key <adminKey>\").hideHelp())\n  .addOption(new Option(\"--url <url>\").hideHelp())\n  // Options for testing\n  .addOption(new Option(\"--override-auth-url <url>\").hideHelp())\n  .addOption(new Option(\"--override-auth-client <id>\").hideHelp())\n  .addOption(new Option(\"--override-auth-username <username>\").hideHelp())\n  .addOption(new Option(\"--override-auth-password <password>\").hideHelp())\n  .addOption(new Option(\"--local-cloud-port <port>\").hideHelp())\n  .addOption(new Option(\"--local-site-port <port>\").hideHelp())\n  .addOption(new Option(\"--local-backend-version <version>\").hideHelp())\n  .addOption(new Option(\"--local-force-upgrade\").default(false).hideHelp())\n  .addOption(new Option(\"--deployment <deployment>\").hideHelp())\n  .addOption(\n    new Option(\n      \"--local\",\n      \"Use local deployment regardless of last used backend. DB data will not be downloaded from any cloud deployment.\",\n    )\n      .default(false)\n      .conflicts([\"--prod\", \"--url\", \"--admin-key\", \"--cloud\"])\n      .hideHelp(),\n  )\n  .addOption(\n    new Option(\n      \"--cloud\",\n      \"Use cloud deployment regardles of last used backend. DB data will not be uploaded from local.\",\n    )\n      .default(false)\n      .conflicts([\"--prod\", \"--url\", \"--admin-key\", \"--local\"])\n      .hideHelp(),\n  )\n  .showHelpAfterError()\n  .action(async (cmdOptions) => {\n    const ctx = await oneoffContext(cmdOptions);\n    process.on(\"SIGINT\", async () => {\n      logVerbose(\"Received SIGINT, cleaning up...\");\n      await ctx.flushAndExit(-2);\n    });\n\n    if (cmdOptions.deployment !== undefined) {\n      return await ctx.crash({\n        exitCode: 1,\n        errorType: \"fatal\",\n        printedMessage:\n          \"`--deployment` can\u2019t be used with `npx convex dev`. \\n\\n\" +\n          \"  To select this deployment for development, run: \\n\" +\n          chalkStderr.bold(\n            `      npx convex deployment select ${cmdOptions.deployment}\\n`,\n          ) +\n          \"  Then, run `npx convex dev` again.\",\n      });\n    }\n\n    const devOptions = await normalizeDevOptions(ctx, cmdOptions);\n\n    if (cmdOptions.configure === undefined) {\n      if (cmdOptions.team || cmdOptions.project || cmdOptions.devDeployment)\n        return await ctx.crash({\n          exitCode: 1,\n          errorType: \"fatal\",\n          printedMessage:\n            \"`--team, --project, and --dev-deployment can can only be used with `--configure`.\",\n        });\n    }\n\n    const localOptions: {\n      ports?: { cloud: number; site: number };\n      backendVersion?: string | undefined;\n      forceUpgrade: boolean;\n    } = { forceUpgrade: false };\n    if (!cmdOptions.local && cmdOptions.devDeployment !== \"local\") {\n      if (\n        cmdOptions.localCloudPort !== undefined ||\n        cmdOptions.localSitePort !== undefined ||\n        cmdOptions.localBackendVersion !== undefined ||\n        cmdOptions.localForceUpgrade === true\n      ) {\n        return await ctx.crash({\n          exitCode: 1,\n          errorType: \"fatal\",\n          printedMessage:\n            \"`--local-*` options can only be used with `--configure --dev-deployment local` or `--local`.\",\n        });\n      }\n    } else {\n      if (cmdOptions.localCloudPort !== undefined) {\n        if (cmdOptions.localSitePort === undefined) {\n          return await ctx.crash({\n            exitCode: 1,\n            errorType: \"fatal\",\n            printedMessage:\n              \"`--local-cloud-port` requires `--local-site-port` to be set.\",\n          });\n        }\n        localOptions[\"ports\"] = {\n          cloud: parseInt(cmdOptions.localCloudPort),\n          site: parseInt(cmdOptions.localSitePort),\n        };\n      }\n      localOptions[\"backendVersion\"] = cmdOptions.localBackendVersion;\n      localOptions[\"forceUpgrade\"] = cmdOptions.localForceUpgrade;\n    }\n\n    const configure =\n      cmdOptions.configure === true ? \"ask\" : (cmdOptions.configure ?? null);\n    // --configure means \"pick a project\" \u2014 skip deployment selection entirely\n    const deploymentSelection =\n      configure !== null\n        ? ({\n            kind: \"chooseProject\",\n            selectionWithinProject: {\n              // For backwards compatibility, allow `--configure --prod`\n              kind: cmdOptions.prod ? \"prod\" : \"unspecified\",\n            },\n          } satisfies DeploymentSelection)\n        : await getDeploymentSelection(ctx, cmdOptions);\n    const credentials = await deploymentCredentialsOrConfigure(\n      ctx,\n      deploymentSelection,\n      configure,\n      {\n        ...cmdOptions,\n        localOptions,\n      },\n    );\n\n    await Promise.all([\n      ...(!cmdOptions.skipPush\n        ? [\n            devAgainstDeployment(\n              ctx,\n              {\n                url: credentials.url,\n                adminKey: credentials.adminKey,\n                deploymentName:\n                  credentials.deploymentFields?.deploymentName ?? null,\n                ...(credentials.deploymentFields?.deploymentType !== undefined\n                  ? {\n                      deploymentType:\n                        credentials.deploymentFields.deploymentType,\n                    }\n                  : {}),\n              },\n              devOptions,\n            ),\n          ]\n        : []),\n      ...(credentials.deploymentFields !== null\n        ? [\n            usageStateWarning(ctx, credentials.deploymentFields.deploymentName),\n            checkVersionAndAiFilesStaleness(ctx),\n          ]\n        : []),\n    ]);\n  });\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/cjs/cli/docs.js

@@ -58,7 +58,7 @@ const docs = new import_extra_typings.Command("docs").description("Open the docs
     `get_cookie/${configuredDeployment}`,
     import_utils.BIG_BRAIN_URL
   );
-  const fetch = await (0, import_utils.bigBrainFetch)(ctx);
+  const fetch = (0, import_utils.bigBrainFetch)(ctx);
   try {
     const res = await fetch(getCookieUrl);
     (0, import_utils.deprecationCheckWarning)(ctx, res);

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/cli/docs.ts"],
-  "sourcesContent": ["import { Command } from \"@commander-js/extra-typings\";\nimport { chalkStderr } from \"chalk\";\nimport open from \"open\";\nimport { Context, oneoffContext } from \"../bundler/context.js\";\nimport { logMessage } from \"../bundler/log.js\";\nimport {\n  BIG_BRAIN_URL,\n  bigBrainFetch,\n  deprecationCheckWarning,\n} from \"./lib/utils/utils.js\";\nimport {\n  getDeploymentSelection,\n  deploymentNameFromSelection,\n} from \"./lib/deploymentSelection.js\";\n\nexport const docs = new Command(\"docs\")\n  .description(\"Open the docs in the browser\")\n  .allowExcessArguments(false)\n  .option(\"--no-open\", \"Print docs URL instead of opening it in your browser\")\n  .action(async (options) => {\n    const ctx = await oneoffContext({\n      url: undefined,\n      adminKey: undefined,\n      envFile: undefined,\n    });\n    const deploymentSelection = await getDeploymentSelection(ctx, {\n      url: undefined,\n      adminKey: undefined,\n      envFile: undefined,\n    });\n    const configuredDeployment =\n      deploymentNameFromSelection(deploymentSelection);\n    if (configuredDeployment === null) {\n      await openDocs(ctx, options.open);\n      return;\n    }\n    const getCookieUrl = new URL(\n      `get_cookie/${configuredDeployment}`,\n      BIG_BRAIN_URL,\n    );\n    const fetch = await bigBrainFetch(ctx);\n    try {\n      const res = await fetch(getCookieUrl);\n      deprecationCheckWarning(ctx, res);\n      const { cookie } = await res.json();\n      await openDocs(ctx, options.open, cookie);\n    } catch {\n      await openDocs(ctx, options.open);\n    }\n  });\n\nasync function openDocs(ctx: Context, toOpen: boolean, cookie?: string) {\n  let docsUrl = \"https://docs.convex.dev\";\n  if (cookie !== undefined) {\n    docsUrl += \"/?t=\" + cookie;\n  }\n  if (toOpen) {\n    await open(docsUrl);\n    logMessage(chalkStderr.green(\"Docs have launched! Check your browser.\"));\n  } else {\n    logMessage(chalkStderr.green(`Find Convex docs here: ${docsUrl}`));\n  }\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,2BAAwB;AACxB,mBAA4B;AAC5B,kBAAiB;AACjB,qBAAuC;AACvC,iBAA2B;AAC3B,mBAIO;AACP,iCAGO;AAEA,MAAM,OAAO,IAAI,6BAAQ,MAAM,EACnC,YAAY,8BAA8B,EAC1C,qBAAqB,KAAK,EAC1B,OAAO,aAAa,sDAAsD,EAC1E,OAAO,OAAO,YAAY;AACzB,QAAM,MAAM,UAAM,8BAAc;AAAA,IAC9B,KAAK;AAAA,IACL,UAAU;AAAA,IACV,SAAS;AAAA,EACX,CAAC;AACD,QAAM,sBAAsB,UAAM,mDAAuB,KAAK;AAAA,IAC5D,KAAK;AAAA,IACL,UAAU;AAAA,IACV,SAAS;AAAA,EACX,CAAC;AACD,QAAM,2BACJ,wDAA4B,mBAAmB;AACjD,MAAI,yBAAyB,MAAM;AACjC,UAAM,SAAS,KAAK,QAAQ,IAAI;AAChC;AAAA,EACF;AACA,QAAM,eAAe,IAAI;AAAA,IACvB,cAAc,oBAAoB;AAAA,IAClC;AAAA,EACF;AACA,QAAM,QAAQ,UAAM,4BAAc,GAAG;AACrC,MAAI;AACF,UAAM,MAAM,MAAM,MAAM,YAAY;AACpC,8CAAwB,KAAK,GAAG;AAChC,UAAM,EAAE,OAAO,IAAI,MAAM,IAAI,KAAK;AAClC,UAAM,SAAS,KAAK,QAAQ,MAAM,MAAM;AAAA,EAC1C,QAAQ;AACN,UAAM,SAAS,KAAK,QAAQ,IAAI;AAAA,EAClC;AACF,CAAC;AAEH,eAAe,SAAS,KAAc,QAAiB,QAAiB;AACtE,MAAI,UAAU;AACd,MAAI,WAAW,QAAW;AACxB,eAAW,SAAS;AAAA,EACtB;AACA,MAAI,QAAQ;AACV,cAAM,YAAAA,SAAK,OAAO;AAClB,+BAAW,yBAAY,MAAM,yCAAyC,CAAC;AAAA,EACzE,OAAO;AACL,+BAAW,yBAAY,MAAM,0BAA0B,OAAO,EAAE,CAAC;AAAA,EACnE;AACF;",
+  "sourcesContent": ["import { Command } from \"@commander-js/extra-typings\";\nimport { chalkStderr } from \"chalk\";\nimport open from \"open\";\nimport { Context, oneoffContext } from \"../bundler/context.js\";\nimport { logMessage } from \"../bundler/log.js\";\nimport {\n  BIG_BRAIN_URL,\n  bigBrainFetch,\n  deprecationCheckWarning,\n} from \"./lib/utils/utils.js\";\nimport {\n  getDeploymentSelection,\n  deploymentNameFromSelection,\n} from \"./lib/deploymentSelection.js\";\n\nexport const docs = new Command(\"docs\")\n  .description(\"Open the docs in the browser\")\n  .allowExcessArguments(false)\n  .option(\"--no-open\", \"Print docs URL instead of opening it in your browser\")\n  .action(async (options) => {\n    const ctx = await oneoffContext({\n      url: undefined,\n      adminKey: undefined,\n      envFile: undefined,\n    });\n    const deploymentSelection = await getDeploymentSelection(ctx, {\n      url: undefined,\n      adminKey: undefined,\n      envFile: undefined,\n    });\n    const configuredDeployment =\n      deploymentNameFromSelection(deploymentSelection);\n    if (configuredDeployment === null) {\n      await openDocs(ctx, options.open);\n      return;\n    }\n    const getCookieUrl = new URL(\n      `get_cookie/${configuredDeployment}`,\n      BIG_BRAIN_URL,\n    );\n    const fetch = bigBrainFetch(ctx);\n    try {\n      const res = await fetch(getCookieUrl);\n      deprecationCheckWarning(ctx, res);\n      const { cookie } = await res.json();\n      await openDocs(ctx, options.open, cookie);\n    } catch {\n      await openDocs(ctx, options.open);\n    }\n  });\n\nasync function openDocs(ctx: Context, toOpen: boolean, cookie?: string) {\n  let docsUrl = \"https://docs.convex.dev\";\n  if (cookie !== undefined) {\n    docsUrl += \"/?t=\" + cookie;\n  }\n  if (toOpen) {\n    await open(docsUrl);\n    logMessage(chalkStderr.green(\"Docs have launched! Check your browser.\"));\n  } else {\n    logMessage(chalkStderr.green(`Find Convex docs here: ${docsUrl}`));\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,2BAAwB;AACxB,mBAA4B;AAC5B,kBAAiB;AACjB,qBAAuC;AACvC,iBAA2B;AAC3B,mBAIO;AACP,iCAGO;AAEA,MAAM,OAAO,IAAI,6BAAQ,MAAM,EACnC,YAAY,8BAA8B,EAC1C,qBAAqB,KAAK,EAC1B,OAAO,aAAa,sDAAsD,EAC1E,OAAO,OAAO,YAAY;AACzB,QAAM,MAAM,UAAM,8BAAc;AAAA,IAC9B,KAAK;AAAA,IACL,UAAU;AAAA,IACV,SAAS;AAAA,EACX,CAAC;AACD,QAAM,sBAAsB,UAAM,mDAAuB,KAAK;AAAA,IAC5D,KAAK;AAAA,IACL,UAAU;AAAA,IACV,SAAS;AAAA,EACX,CAAC;AACD,QAAM,2BACJ,wDAA4B,mBAAmB;AACjD,MAAI,yBAAyB,MAAM;AACjC,UAAM,SAAS,KAAK,QAAQ,IAAI;AAChC;AAAA,EACF;AACA,QAAM,eAAe,IAAI;AAAA,IACvB,cAAc,oBAAoB;AAAA,IAClC;AAAA,EACF;AACA,QAAM,YAAQ,4BAAc,GAAG;AAC/B,MAAI;AACF,UAAM,MAAM,MAAM,MAAM,YAAY;AACpC,8CAAwB,KAAK,GAAG;AAChC,UAAM,EAAE,OAAO,IAAI,MAAM,IAAI,KAAK;AAClC,UAAM,SAAS,KAAK,QAAQ,MAAM,MAAM;AAAA,EAC1C,QAAQ;AACN,UAAM,SAAS,KAAK,QAAQ,IAAI;AAAA,EAClC;AACF,CAAC;AAEH,eAAe,SAAS,KAAc,QAAiB,QAAiB;AACtE,MAAI,UAAU;AACd,MAAI,WAAW,QAAW;AACxB,eAAW,SAAS;AAAA,EACtB;AACA,MAAI,QAAQ;AACV,cAAM,YAAAA,SAAK,OAAO;AAClB,+BAAW,yBAAY,MAAM,yCAAyC,CAAC;AAAA,EACzE,OAAO;AACL,+BAAW,yBAAY,MAAM,0BAA0B,OAAO,EAAE,CAAC;AAAA,EACnE;AACF;",
   "names": ["open"]
 }

package/dist/cjs/cli/init.js

@@ -52,7 +52,7 @@ const init = new import_extra_typings.Command("init").description(
   if (credentials.deploymentFields !== null) {
     await Promise.all([
       (0, import_usage.usageStateWarning)(ctx, credentials.deploymentFields.deploymentName),
-      (0, import_updates.checkVersion)(ctx)
+      (0, import_updates.checkVersionAndAiFilesStaleness)(ctx)
     ]);
   }
   await ctx.flushAndExit(0);

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/cli/init.ts"],
-  "sourcesContent": ["import { Command } from \"@commander-js/extra-typings\";\nimport { oneoffContext } from \"../bundler/context.js\";\nimport { logVerbose } from \"../bundler/log.js\";\nimport { deploymentCredentialsOrConfigure } from \"./configure.js\";\nimport { getDeploymentSelection } from \"./lib/deploymentSelection.js\";\nimport { checkVersion } from \"./lib/updates.js\";\nimport { usageStateWarning } from \"./lib/usage.js\";\n\n// Equivalent to `npx convex dev --once --skip-push`.\nexport const init = new Command(\"init\")\n  .description(\n    \"Ensures a Convex project is configured and initialized in the current directory. Does nothing if one is already configured. Unlike `npx convex dev`, it will not push code or typecheck.\\nTypically you can skip this and run `npx convex dev` directly which will both initialize and continously deploy code. \\n\\nTo initialize an agent: `export CONVEX_AGENT_MODE=anonymous && npx convex init && npx convex env set < .env.defaults && npx convex dev`.\",\n  )\n  .summary(\n    \"Ensures a Convex project is configured. Does not push code. No-ops if already configured.\",\n  )\n  .allowExcessArguments(false)\n  .action(async () => {\n    const ctx = await oneoffContext({\n      url: undefined,\n      adminKey: undefined,\n      envFile: undefined,\n    });\n    process.on(\"SIGINT\", async () => {\n      logVerbose(\"Received SIGINT, cleaning up...\");\n      await ctx.flushAndExit(-2);\n    });\n\n    const deploymentSelection = await getDeploymentSelection(ctx, {});\n    const credentials = await deploymentCredentialsOrConfigure(\n      ctx,\n      deploymentSelection,\n      null,\n      { prod: false, localOptions: { forceUpgrade: false } },\n    );\n\n    if (credentials.deploymentFields !== null) {\n      await Promise.all([\n        usageStateWarning(ctx, credentials.deploymentFields.deploymentName),\n        checkVersion(ctx),\n      ]);\n    }\n\n    await ctx.flushAndExit(0);\n  });\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,2BAAwB;AACxB,qBAA8B;AAC9B,iBAA2B;AAC3B,uBAAiD;AACjD,iCAAuC;AACvC,qBAA6B;AAC7B,mBAAkC;AAG3B,MAAM,OAAO,IAAI,6BAAQ,MAAM,EACnC;AAAA,EACC;AACF,EACC;AAAA,EACC;AACF,EACC,qBAAqB,KAAK,EAC1B,OAAO,YAAY;AAClB,QAAM,MAAM,UAAM,8BAAc;AAAA,IAC9B,KAAK;AAAA,IACL,UAAU;AAAA,IACV,SAAS;AAAA,EACX,CAAC;AACD,UAAQ,GAAG,UAAU,YAAY;AAC/B,+BAAW,iCAAiC;AAC5C,UAAM,IAAI,aAAa,EAAE;AAAA,EAC3B,CAAC;AAED,QAAM,sBAAsB,UAAM,mDAAuB,KAAK,CAAC,CAAC;AAChE,QAAM,cAAc,UAAM;AAAA,IACxB;AAAA,IACA;AAAA,IACA;AAAA,IACA,EAAE,MAAM,OAAO,cAAc,EAAE,cAAc,MAAM,EAAE;AAAA,EACvD;AAEA,MAAI,YAAY,qBAAqB,MAAM;AACzC,UAAM,QAAQ,IAAI;AAAA,UAChB,gCAAkB,KAAK,YAAY,iBAAiB,cAAc;AAAA,UAClE,6BAAa,GAAG;AAAA,IAClB,CAAC;AAAA,EACH;AAEA,QAAM,IAAI,aAAa,CAAC;AAC1B,CAAC;",
+  "sourcesContent": ["import { Command } from \"@commander-js/extra-typings\";\nimport { oneoffContext } from \"../bundler/context.js\";\nimport { logVerbose } from \"../bundler/log.js\";\nimport { deploymentCredentialsOrConfigure } from \"./configure.js\";\nimport { getDeploymentSelection } from \"./lib/deploymentSelection.js\";\nimport { checkVersionAndAiFilesStaleness } from \"./lib/updates.js\";\nimport { usageStateWarning } from \"./lib/usage.js\";\n\n// Equivalent to `npx convex dev --once --skip-push`.\nexport const init = new Command(\"init\")\n  .description(\n    \"Ensures a Convex project is configured and initialized in the current directory. Does nothing if one is already configured. Unlike `npx convex dev`, it will not push code or typecheck.\\nTypically you can skip this and run `npx convex dev` directly which will both initialize and continously deploy code. \\n\\nTo initialize an agent: `export CONVEX_AGENT_MODE=anonymous && npx convex init && npx convex env set < .env.defaults && npx convex dev`.\",\n  )\n  .summary(\n    \"Ensures a Convex project is configured. Does not push code. No-ops if already configured.\",\n  )\n  .allowExcessArguments(false)\n  .action(async () => {\n    const ctx = await oneoffContext({\n      url: undefined,\n      adminKey: undefined,\n      envFile: undefined,\n    });\n    process.on(\"SIGINT\", async () => {\n      logVerbose(\"Received SIGINT, cleaning up...\");\n      await ctx.flushAndExit(-2);\n    });\n\n    const deploymentSelection = await getDeploymentSelection(ctx, {});\n    const credentials = await deploymentCredentialsOrConfigure(\n      ctx,\n      deploymentSelection,\n      null,\n      { prod: false, localOptions: { forceUpgrade: false } },\n    );\n\n    if (credentials.deploymentFields !== null) {\n      await Promise.all([\n        usageStateWarning(ctx, credentials.deploymentFields.deploymentName),\n        checkVersionAndAiFilesStaleness(ctx),\n      ]);\n    }\n\n    await ctx.flushAndExit(0);\n  });\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,2BAAwB;AACxB,qBAA8B;AAC9B,iBAA2B;AAC3B,uBAAiD;AACjD,iCAAuC;AACvC,qBAAgD;AAChD,mBAAkC;AAG3B,MAAM,OAAO,IAAI,6BAAQ,MAAM,EACnC;AAAA,EACC;AACF,EACC;AAAA,EACC;AACF,EACC,qBAAqB,KAAK,EAC1B,OAAO,YAAY;AAClB,QAAM,MAAM,UAAM,8BAAc;AAAA,IAC9B,KAAK;AAAA,IACL,UAAU;AAAA,IACV,SAAS;AAAA,EACX,CAAC;AACD,UAAQ,GAAG,UAAU,YAAY;AAC/B,+BAAW,iCAAiC;AAC5C,UAAM,IAAI,aAAa,EAAE;AAAA,EAC3B,CAAC;AAED,QAAM,sBAAsB,UAAM,mDAAuB,KAAK,CAAC,CAAC;AAChE,QAAM,cAAc,UAAM;AAAA,IACxB;AAAA,IACA;AAAA,IACA;AAAA,IACA,EAAE,MAAM,OAAO,cAAc,EAAE,cAAc,MAAM,EAAE;AAAA,EACvD;AAEA,MAAI,YAAY,qBAAqB,MAAM;AACzC,UAAM,QAAQ,IAAI;AAAA,UAChB,gCAAkB,KAAK,YAAY,iBAAiB,cAAc;AAAA,UAClE,gDAAgC,GAAG;AAAA,IACrC,CAAC;AAAA,EACH;AAEA,QAAM,IAAI,aAAa,CAAC;AAC1B,CAAC;",
   "names": []
 }

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

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

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/cli/lib/aiFiles/agentsmd.ts"],
+  "sourcesContent": ["import {\n  AGENTS_MD_START_MARKER,\n  AGENTS_MD_END_MARKER,\n  agentsMdConvexSection,\n} from \"../../codegen_templates/agentsmd.js\";\nimport { agentsMdPath } from \"./paths.js\";\nimport { type AiFilesState } from \"./state.js\";\nimport {\n  type ManagedSectionTarget,\n  type InjectResult,\n  type StripResult,\n  injectManagedSection,\n  attemptToStripManagedSection,\n  hasManagedSection,\n  attemptToRemoveMarkdownSection,\n} from \"./utils.js\";\nimport { logMessage } from \"../../../bundler/log.js\";\nimport { chalkStderr } from \"chalk\";\n\nfunction target(projectDir?: string): ManagedSectionTarget {\n  return {\n    filePath: agentsMdPath(projectDir),\n    startMarker: AGENTS_MD_START_MARKER,\n    endMarker: AGENTS_MD_END_MARKER,\n  };\n}\n\nexport async function injectAgentsMdSection({\n  section,\n  projectDir,\n}: {\n  section: string;\n  projectDir?: string;\n}): Promise<InjectResult> {\n  return injectManagedSection({ ...target(projectDir), section });\n}\n\nexport async function attemptToStripAgentsMdSection(\n  projectDir: string,\n): Promise<StripResult> {\n  return attemptToStripManagedSection(target(projectDir));\n}\n\nexport async function attemptToRemoveAgentsMdSection(\n  projectDir: string,\n): Promise<boolean> {\n  return attemptToRemoveMarkdownSection({\n    projectDir,\n    strip: attemptToStripAgentsMdSection,\n    fileName: \"AGENTS.md\",\n  });\n}\n\nexport async function hasAgentsMdInstalled(\n  projectDir: string,\n): Promise<boolean> {\n  return hasManagedSection(target(projectDir));\n}\n\n/**\n * Inject (or update) the Convex section in AGENTS.md and record the hash.\n * Returns true if the file was actually written.\n */\nexport async function applyAgentsMdSection({\n  projectDir,\n  state,\n  convexDirName,\n}: {\n  projectDir: string;\n  state: AiFilesState;\n  convexDirName: string;\n}): Promise<boolean> {\n  const result = await injectAgentsMdSection({\n    section: agentsMdConvexSection(convexDirName),\n    projectDir,\n  });\n  if (result.didWrite)\n    logMessage(`${chalkStderr.green(\"\u2714\")} AGENTS.md written`);\n  state.agentsMdSectionHash = result.sectionHash;\n  return result.didWrite;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sBAIO;AACP,mBAA6B;AAE7B,mBAQO;AACP,iBAA2B;AAC3B,mBAA4B;AAE5B,SAAS,OAAO,YAA2C;AACzD,SAAO;AAAA,IACL,cAAU,2BAAa,UAAU;AAAA,IACjC,aAAa;AAAA,IACb,WAAW;AAAA,EACb;AACF;AAEA,eAAsB,sBAAsB;AAAA,EAC1C;AAAA,EACA;AACF,GAG0B;AACxB,aAAO,mCAAqB,EAAE,GAAG,OAAO,UAAU,GAAG,QAAQ,CAAC;AAChE;AAEA,eAAsB,8BACpB,YACsB;AACtB,aAAO,2CAA6B,OAAO,UAAU,CAAC;AACxD;AAEA,eAAsB,+BACpB,YACkB;AAClB,aAAO,6CAA+B;AAAA,IACpC;AAAA,IACA,OAAO;AAAA,IACP,UAAU;AAAA,EACZ,CAAC;AACH;AAEA,eAAsB,qBACpB,YACkB;AAClB,aAAO,gCAAkB,OAAO,UAAU,CAAC;AAC7C;AAMA,eAAsB,qBAAqB;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AACF,GAIqB;AACnB,QAAM,SAAS,MAAM,sBAAsB;AAAA,IACzC,aAAS,uCAAsB,aAAa;AAAA,IAC5C;AAAA,EACF,CAAC;AACD,MAAI,OAAO;AACT,+BAAW,GAAG,yBAAY,MAAM,QAAG,CAAC,oBAAoB;AAC1D,QAAM,sBAAsB,OAAO;AACnC,SAAO,OAAO;AAChB;",
+  "names": []
+}

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

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

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/cli/lib/aiFiles/claudemd.ts"],
+  "sourcesContent": ["import {\n  CLAUDE_MD_END_MARKER,\n  CLAUDE_MD_START_MARKER,\n  claudeMdConvexSection,\n} from \"../../codegen_templates/claudemd.js\";\nimport { claudeMdPath } from \"./paths.js\";\nimport { type AiFilesState } from \"./state.js\";\nimport {\n  type ManagedSectionTarget,\n  type InjectResult,\n  type StripResult,\n  injectManagedSection,\n  attemptToStripManagedSection,\n  hasManagedSection,\n  attemptToRemoveMarkdownSection,\n} from \"./utils.js\";\nimport { logMessage } from \"../../../bundler/log.js\";\nimport { chalkStderr } from \"chalk\";\n\nfunction target(projectDir?: string): ManagedSectionTarget {\n  return {\n    filePath: claudeMdPath(projectDir),\n    startMarker: CLAUDE_MD_START_MARKER,\n    endMarker: CLAUDE_MD_END_MARKER,\n  };\n}\n\nexport async function injectClaudeMdSection({\n  section,\n  projectDir,\n}: {\n  section: string;\n  projectDir?: string;\n}): Promise<InjectResult> {\n  return injectManagedSection({ ...target(projectDir), section });\n}\n\nexport async function attemptToStripClaudeMdSection(\n  projectDir: string,\n): Promise<StripResult> {\n  return attemptToStripManagedSection(target(projectDir));\n}\n\nexport async function attemptToRemoveClaudeMdSection(\n  projectDir: string,\n): Promise<boolean> {\n  return attemptToRemoveMarkdownSection({\n    projectDir,\n    strip: attemptToStripClaudeMdSection,\n    fileName: \"CLAUDE.md\",\n  });\n}\n\nexport async function hasClaudeMdInstalled(\n  projectDir: string,\n): Promise<boolean> {\n  return hasManagedSection(target(projectDir));\n}\n\n/**\n * Inject (or update) the Convex section in CLAUDE.md and record the hash.\n * Returns true if the file was actually written.\n */\nexport async function applyClaudeMdSection({\n  projectDir,\n  state,\n  convexDirName,\n}: {\n  projectDir: string;\n  state: AiFilesState;\n  convexDirName: string;\n}): Promise<boolean> {\n  const result = await injectClaudeMdSection({\n    section: claudeMdConvexSection(convexDirName),\n    projectDir,\n  });\n  if (result.didWrite)\n    logMessage(`${chalkStderr.green(\"\u2714\")} CLAUDE.md written`);\n  state.claudeMdHash = result.sectionHash;\n  return result.didWrite;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sBAIO;AACP,mBAA6B;AAE7B,mBAQO;AACP,iBAA2B;AAC3B,mBAA4B;AAE5B,SAAS,OAAO,YAA2C;AACzD,SAAO;AAAA,IACL,cAAU,2BAAa,UAAU;AAAA,IACjC,aAAa;AAAA,IACb,WAAW;AAAA,EACb;AACF;AAEA,eAAsB,sBAAsB;AAAA,EAC1C;AAAA,EACA;AACF,GAG0B;AACxB,aAAO,mCAAqB,EAAE,GAAG,OAAO,UAAU,GAAG,QAAQ,CAAC;AAChE;AAEA,eAAsB,8BACpB,YACsB;AACtB,aAAO,2CAA6B,OAAO,UAAU,CAAC;AACxD;AAEA,eAAsB,+BACpB,YACkB;AAClB,aAAO,6CAA+B;AAAA,IACpC;AAAA,IACA,OAAO;AAAA,IACP,UAAU;AAAA,EACZ,CAAC;AACH;AAEA,eAAsB,qBACpB,YACkB;AAClB,aAAO,gCAAkB,OAAO,UAAU,CAAC;AAC7C;AAMA,eAAsB,qBAAqB;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AACF,GAIqB;AACnB,QAAM,SAAS,MAAM,sBAAsB;AAAA,IACzC,aAAS,uCAAsB,aAAa;AAAA,IAC5C;AAAA,EACF,CAAC;AACD,MAAI,OAAO;AACT,+BAAW,GAAG,yBAAY,MAAM,QAAG,CAAC,oBAAoB;AAC1D,QAAM,eAAe,OAAO;AAC5B,SAAO,OAAO;AAChB;",
+  "names": []
+}

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

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

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

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

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

@@ -0,0 +1,58 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var guidelinesmd_exports = {};
+__export(guidelinesmd_exports, {
+  hasGuidelinesInstalled: () => hasGuidelinesInstalled,
+  installGuidelinesFile: () => installGuidelinesFile
+});
+module.exports = __toCommonJS(guidelinesmd_exports);
+var import_fs = require("fs");
+var import_chalk = require("chalk");
+var import_log = require("../../../bundler/log.js");
+var import_versionApi = require("../versionApi.js");
+var import_hash = require("../utils/hash.js");
+var import_paths = require("./paths.js");
+var import_utils = require("./utils.js");
+async function hasGuidelinesInstalled(convexDir) {
+  const result = await (0, import_utils.attemptReadFile)((0, import_paths.guidelinesPathForConvexDir)(convexDir));
+  if (result.kind === "content") return true;
+  if (result.kind === "empty" || result.kind === "not-found") return false;
+  return (0, import_utils.exhaustiveCheck)(result);
+}
+async function installGuidelinesFile({
+  convexDir,
+  state
+}) {
+  const guidelines = await (0, import_versionApi.downloadGuidelines)();
+  if (guidelines === null) {
+    (0, import_log.logMessage)(
+      import_chalk.chalkStderr.yellow(
+        "Could not download Convex AI guidelines right now. You can retry with: npx convex ai-files install"
+      )
+    );
+    return;
+  }
+  await import_fs.promises.mkdir((0, import_paths.aiDirForConvexDir)(convexDir), { recursive: true });
+  await import_fs.promises.writeFile((0, import_paths.guidelinesPathForConvexDir)(convexDir), guidelines, "utf8");
+  state.guidelinesHash = (0, import_hash.hashSha256)(guidelines);
+  (0, import_log.logMessage)(
+    `${import_chalk.chalkStderr.green("\u2714")} ${(0, import_paths.guidelinesPathForConvexDir)(convexDir)} written`
+  );
+}
+//# sourceMappingURL=guidelinesmd.js.map

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

@@ -0,0 +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": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,gBAA+B;AAC/B,mBAA4B;AAC5B,iBAA2B;AAC3B,wBAAmC;AACnC,kBAA2B;AAC3B,mBAA8D;AAC9D,mBAAiD;AAGjD,eAAsB,uBACpB,WACkB;AAClB,QAAM,SAAS,UAAM,kCAAgB,yCAA2B,SAAS,CAAC;AAC1E,MAAI,OAAO,SAAS,UAAW,QAAO;AACtC,MAAI,OAAO,SAAS,WAAW,OAAO,SAAS,YAAa,QAAO;AACnE,aAAO,8BAAgB,MAAM;AAC/B;AAOA,eAAsB,sBAAsB;AAAA,EAC1C;AAAA,EACA;AACF,GAGkB;AAChB,QAAM,aAAa,UAAM,sCAAmB;AAC5C,MAAI,eAAe,MAAM;AACvB;AAAA,MACE,yBAAY;AAAA,QACV;AAAA,MACF;AAAA,IACF;AACA;AAAA,EACF;AAEA,QAAM,UAAAA,SAAG,UAAM,gCAAkB,SAAS,GAAG,EAAE,WAAW,KAAK,CAAC;AAChE,QAAM,UAAAA,SAAG,cAAU,yCAA2B,SAAS,GAAG,YAAY,MAAM;AAC5E,QAAM,qBAAiB,wBAAW,UAAU;AAE5C;AAAA,IACE,GAAG,yBAAY,MAAM,QAAG,CAAC,QAAI,yCAA2B,SAAS,CAAC;AAAA,EACpE;AACF;",
+  "names": ["fs"]
+}