convex 1.34.0 → 1.34.1

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

@@ -0,0 +1,51 @@
+"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) {
+  return await (0, import_utils.readFileSafe)((0, import_paths.guidelinesPathForConvexDir)(convexDir)) !== null;
+}
+async function installGuidelinesFile({
+  convexDir,
+  config
+}) {
+  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.writeFile((0, import_paths.guidelinesPathForConvexDir)(convexDir), guidelines, "utf8");
+  config.guidelinesHash = (0, import_hash.hashSha256)(guidelines);
+}
+//# 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 { guidelinesPathForConvexDir } from \"./paths.js\";\nimport { readFileSafe } from \"./utils.js\";\nimport { type AiFilesConfig } from \"./config.js\";\n\nexport async function hasGuidelinesInstalled(\n  convexDir: string,\n): Promise<boolean> {\n  return (await readFileSafe(guidelinesPathForConvexDir(convexDir))) !== null;\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  config,\n}: {\n  convexDir: string;\n  config: AiFilesConfig;\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.writeFile(guidelinesPathForConvexDir(convexDir), guidelines, \"utf8\");\n  config.guidelinesHash = hashSha256(guidelines);\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,gBAA+B;AAC/B,mBAA4B;AAC5B,iBAA2B;AAC3B,wBAAmC;AACnC,kBAA2B;AAC3B,mBAA2C;AAC3C,mBAA6B;AAG7B,eAAsB,uBACpB,WACkB;AAClB,SAAQ,UAAM,+BAAa,yCAA2B,SAAS,CAAC,MAAO;AACzE;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,cAAU,yCAA2B,SAAS,GAAG,YAAY,MAAM;AAC5E,SAAO,qBAAiB,wBAAW,UAAU;AAC/C;",
+  "names": ["fs"]
+}

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

@@ -0,0 +1,231 @@
+"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 aiFiles_exports = {};
+__export(aiFiles_exports, {
+  checkAiFilesStaleness: () => checkAiFilesStaleness,
+  enableAiFiles: () => enableAiFiles,
+  installAiFiles: () => installAiFiles,
+  maybeSetupAiFiles: () => maybeSetupAiFiles,
+  removeAiFiles: () => removeAiFiles,
+  safelyAttemptToDisableAiFiles: () => safelyAttemptToDisableAiFiles
+});
+module.exports = __toCommonJS(aiFiles_exports);
+var Sentry = __toESM(require("@sentry/node"), 1);
+var import_path = __toESM(require("path"), 1);
+var import_fs = require("fs");
+var import_chalk = require("chalk");
+var import_log = require("../../../bundler/log.js");
+var import_prompts = require("../utils/prompts.js");
+var import_paths = require("./paths.js");
+var import_guidelinesmd = require("./guidelinesmd.js");
+var import_config = require("./config.js");
+var import_utils = require("./utils.js");
+var import_agentsmd = require("./agentsmd.js");
+var import_claudemd = require("./claudemd.js");
+var import_skills = require("./skills.js");
+var import_cursorrules = require("./cursorrules.js");
+async function hasExistingAiFilesArtifacts({
+  projectDir,
+  convexDir
+}) {
+  return await (0, import_guidelinesmd.hasGuidelinesInstalled)(convexDir) || await (0, import_agentsmd.hasAgentsMdInstalled)(projectDir) || await (0, import_claudemd.hasClaudeMdInstalled)(projectDir);
+}
+async function installAiFiles({
+  projectDir,
+  convexDir,
+  shouldWriteGuidelines = true,
+  shouldWriteAgentsMd = true,
+  shouldWriteClaudeMd = true,
+  shouldWriteSkills = true
+}) {
+  await import_fs.promises.mkdir((0, import_paths.aiDirForConvexDir)(convexDir), { recursive: true });
+  const config = await (0, import_config.readAiConfig)({
+    projectDir,
+    convexDir
+  }) ?? {
+    enabled: true,
+    guidelinesHash: null,
+    agentsMdSectionHash: null,
+    claudeMdHash: null,
+    agentSkillsSha: null,
+    installedSkillNames: []
+  };
+  if (shouldWriteGuidelines) await (0, import_guidelinesmd.installGuidelinesFile)({ convexDir, config });
+  const convexDirName = import_path.default.relative(projectDir, convexDir);
+  if (shouldWriteAgentsMd)
+    await (0, import_agentsmd.applyAgentsMdSection)({ projectDir, config, convexDirName });
+  if (shouldWriteClaudeMd)
+    await (0, import_claudemd.applyClaudeMdSection)({ projectDir, config, convexDirName });
+  if (shouldWriteSkills) await (0, import_skills.installSkills)({ projectDir, config });
+  await (0, import_cursorrules.removeLegacyCursorRulesFile)(projectDir);
+  await (0, import_config.writeAiConfig)({ config, projectDir, convexDir });
+  (0, import_log.logMessage)(`${import_chalk.chalkStderr.green("\u2714")} Convex AI files installed.`);
+}
+async function attemptToInstallAiFiles(opts) {
+  try {
+    await installAiFiles(opts);
+  } catch (error) {
+    Sentry.captureException(error);
+  }
+}
+async function determineAiFilesStaleness({
+  canonicalGuidelinesHash,
+  canonicalAgentSkillsSha,
+  projectDir,
+  convexDir
+}) {
+  const config = await (0, import_config.readAiConfig)({ projectDir, convexDir });
+  if (config === null) {
+    const hasArtifacts = await hasExistingAiFilesArtifacts({
+      projectDir,
+      convexDir
+    });
+    return hasArtifacts ? "has-artifacts" : "not-installed";
+  }
+  if (!config.enabled) return "disabled";
+  if (canonicalGuidelinesHash === null && canonicalAgentSkillsSha === null)
+    return "up-to-date";
+  const guidelinesStale = canonicalGuidelinesHash !== null && config.guidelinesHash !== null && config.guidelinesHash !== canonicalGuidelinesHash;
+  const skillsStale = canonicalAgentSkillsSha !== null && config.agentSkillsSha !== null && config.agentSkillsSha !== canonicalAgentSkillsSha;
+  return guidelinesStale || skillsStale ? "stale" : "up-to-date";
+}
+async function checkAiFilesStaleness(opts) {
+  const status = await determineAiFilesStaleness(opts);
+  if (status === "not-installed") {
+    (0, import_log.logMessage)(
+      import_chalk.chalkStderr.yellow(
+        `Convex AI files are not installed. Run ${import_chalk.chalkStderr.bold(`npx convex ai-files install`)} to get started or ${import_chalk.chalkStderr.bold(`npx convex ai-files disable`)} to hide this message.`
+      )
+    );
+  }
+  if (status === "stale") {
+    (0, import_log.logMessage)(
+      import_chalk.chalkStderr.yellow(
+        `Your Convex AI files are out of date. Run ${import_chalk.chalkStderr.bold(`npx convex ai-files update`)} to get the latest.`
+      )
+    );
+  }
+}
+async function enableAiFiles({
+  projectDir,
+  convexDir
+}) {
+  await installAiFiles({ projectDir, convexDir });
+  const config = await (0, import_config.readAiConfig)({ projectDir, convexDir });
+  if (config === null) return;
+  config.enabled = true;
+  await (0, import_config.writeAiConfig)({
+    config,
+    projectDir,
+    convexDir,
+    options: { persistEnabledPreference: "always" }
+  });
+}
+async function removeAiFiles({
+  projectDir,
+  convexDir
+}) {
+  const config = await (0, import_config.readAiConfig)({ projectDir, convexDir });
+  if (config === null) {
+    (0, import_log.logMessage)("No Convex AI files found \u2014 nothing to remove.");
+    return;
+  }
+  const removals = [
+    await (0, import_agentsmd.removeAgentsMdSection)(projectDir),
+    await (0, import_claudemd.removeClaudeMdSection)(projectDir),
+    await (0, import_skills.removeInstalledSkills)({
+      projectDir,
+      skillNames: config.installedSkillNames
+    }),
+    await (0, import_cursorrules.removeLegacyCursorRulesFile)(projectDir),
+    await attemptToDeleteAiDir({ projectDir, convexDir })
+  ];
+  if (removals.some(Boolean)) (0, import_log.logMessage)("Convex AI files removed.");
+}
+async function safelyAttemptToDisableAiFiles(projectDir) {
+  try {
+    await (0, import_config.writeAiEnabledToProjectConfig)({
+      projectDir,
+      enabled: false
+    });
+    (0, import_log.logMessage)(
+      `${import_chalk.chalkStderr.green(`\u2714`)} Convex AI files disabled. Run ${import_chalk.chalkStderr.bold(`npx convex ai-files enable`)} to re-enable.`
+    );
+  } catch (error) {
+    Sentry.captureException(error);
+    (0, import_log.logMessage)(
+      import_chalk.chalkStderr.yellow(
+        "Could not write AI message suppression config. Message may reappear."
+      )
+    );
+  }
+}
+async function attemptToDeleteAiDir({
+  projectDir,
+  convexDir
+}) {
+  const aiDir = (0, import_paths.aiDirForConvexDir)(convexDir);
+  const relPath = import_path.default.relative(projectDir, aiDir);
+  try {
+    await import_fs.promises.rm(aiDir, { recursive: true, force: true });
+    (0, import_log.logMessage)(`${import_chalk.chalkStderr.green("\u2714")} Deleted ${relPath}/`);
+    return true;
+  } catch (error) {
+    Sentry.captureException(error);
+    (0, import_log.logMessage)(
+      import_chalk.chalkStderr.yellow(`Could not delete ${relPath}/. Remove it manually.`)
+    );
+    return false;
+  }
+}
+async function hasAiFilesBeenInstalledBefore({
+  projectDir,
+  convexDir
+}) {
+  return await (0, import_config.hasAiFilesConfig)({ projectDir, convexDir }) || await hasExistingAiFilesArtifacts({ projectDir, convexDir });
+}
+async function maybeSetupAiFiles({
+  ctx,
+  convexDir,
+  projectDir
+}) {
+  if (!(0, import_utils.isInInteractiveTerminal)()) return;
+  const config = await (0, import_config.readAiConfig)({ projectDir, convexDir });
+  if (config !== null && !config.enabled) return;
+  if (await hasAiFilesBeenInstalledBefore({ projectDir, convexDir })) {
+    await attemptToInstallAiFiles({ projectDir, convexDir });
+    return;
+  }
+  const shouldInstall = await (0, import_prompts.promptYesNo)(ctx, {
+    message: "Set up Convex AI files? (guidelines, AGENTS.md, agent skills)",
+    default: true
+  });
+  if (shouldInstall) await attemptToInstallAiFiles({ projectDir, convexDir });
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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 { type AiFilesPaths, aiDirForConvexDir } from \"./paths.js\";\nimport {\n  installGuidelinesFile,\n  hasGuidelinesInstalled,\n} from \"./guidelinesmd.js\";\nimport {\n  type AiFilesConfig,\n  hasAiFilesConfig,\n  readAiConfig,\n  writeAiConfig,\n  writeAiEnabledToProjectConfig,\n} from \"./config.js\";\nimport { isInInteractiveTerminal } from \"./utils.js\";\nimport {\n  hasAgentsMdInstalled,\n  applyAgentsMdSection,\n  removeAgentsMdSection,\n} from \"./agentsmd.js\";\nimport {\n  hasClaudeMdInstalled,\n  applyClaudeMdSection,\n  removeClaudeMdSection,\n} from \"./claudemd.js\";\nimport { installSkills, removeInstalledSkills } from \"./skills.js\";\nimport { removeLegacyCursorRulesFile as removeLegacyCursorRules } from \"./cursorrules.js\";\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 config if present, or starts from a blank one for a\n * fresh install. Each component can be individually skipped via the optional\n * flags (all default to true).\n */\nexport async function installAiFiles({\n  projectDir,\n  convexDir,\n  shouldWriteGuidelines = true,\n  shouldWriteAgentsMd = true,\n  shouldWriteClaudeMd = true,\n  shouldWriteSkills = true,\n}: AiFilesPaths & {\n  shouldWriteGuidelines?: boolean;\n  shouldWriteAgentsMd?: boolean;\n  shouldWriteClaudeMd?: boolean;\n  shouldWriteSkills?: boolean;\n}): Promise<void> {\n  await fs.mkdir(aiDirForConvexDir(convexDir), { recursive: true });\n\n  const config: AiFilesConfig = (await readAiConfig({\n    projectDir,\n    convexDir,\n  })) ?? {\n    enabled: true,\n    guidelinesHash: null,\n    agentsMdSectionHash: null,\n    claudeMdHash: null,\n    agentSkillsSha: null,\n    installedSkillNames: [],\n  };\n\n  if (shouldWriteGuidelines) await installGuidelinesFile({ convexDir, config });\n\n  const convexDirName = path.relative(projectDir, convexDir);\n\n  if (shouldWriteAgentsMd)\n    await applyAgentsMdSection({ projectDir, config, convexDirName });\n\n  if (shouldWriteClaudeMd)\n    await applyClaudeMdSection({ projectDir, config, convexDirName });\n\n  if (shouldWriteSkills) await installSkills({ projectDir, config });\n\n  await removeLegacyCursorRules(projectDir);\n  await writeAiConfig({ config, projectDir, convexDir });\n\n  logMessage(`${chalkStderr.green(\"\u2714\")} Convex AI files installed.`);\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 =\n  | \"not-installed\" // no config AND no artifacts \u2014 show install nag\n  | \"has-artifacts\" // no config but files exist on disk (e.g. fresh checkout) \u2014 stay quiet\n  | \"disabled\" // user opted out of nag messages\n  | \"stale\" // one or more files are out of date\n  | \"up-to-date\"; // everything looks fine\n\nasync function determineAiFilesStaleness({\n  canonicalGuidelinesHash,\n  canonicalAgentSkillsSha,\n  projectDir,\n  convexDir,\n}: {\n  canonicalGuidelinesHash: string | null;\n  canonicalAgentSkillsSha: string | null;\n} & AiFilesPaths): Promise<AiFilesStalenessStatus> {\n  const config = await readAiConfig({ projectDir, convexDir });\n\n  if (config === null) {\n    const hasArtifacts = await hasExistingAiFilesArtifacts({\n      projectDir,\n      convexDir,\n    });\n    return hasArtifacts ? \"has-artifacts\" : \"not-installed\";\n  }\n\n  if (!config.enabled) return \"disabled\";\n\n  if (canonicalGuidelinesHash === null && canonicalAgentSkillsSha === null)\n    return \"up-to-date\";\n\n  const guidelinesStale =\n    canonicalGuidelinesHash !== null &&\n    config.guidelinesHash !== null &&\n    config.guidelinesHash !== canonicalGuidelinesHash;\n\n  const skillsStale =\n    canonicalAgentSkillsSha !== null &&\n    config.agentSkillsSha !== null &&\n    config.agentSkillsSha !== canonicalAgentSkillsSha;\n\n  return guidelinesStale || skillsStale ? \"stale\" : \"up-to-date\";\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 checkAiFilesStaleness(\n  opts: {\n    canonicalGuidelinesHash: string | null;\n    canonicalAgentSkillsSha: string | null;\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  }\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  }\n}\n\nexport async function enableAiFiles({\n  projectDir,\n  convexDir,\n}: AiFilesPaths): Promise<void> {\n  await installAiFiles({ projectDir, convexDir });\n  const config = await readAiConfig({ projectDir, convexDir });\n  if (config === null) return;\n  config.enabled = true;\n  await writeAiConfig({\n    config,\n    projectDir,\n    convexDir,\n    options: { persistEnabledPreference: \"always\" },\n  });\n}\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<void> {\n  const config = await readAiConfig({ projectDir, convexDir });\n  if (config === null) {\n    logMessage(\"No Convex AI files found \u2014 nothing to remove.\");\n    return;\n  }\n\n  const removals = [\n    await removeAgentsMdSection(projectDir),\n    await removeClaudeMdSection(projectDir),\n    await removeInstalledSkills({\n      projectDir,\n      skillNames: config.installedSkillNames,\n    }),\n    await removeLegacyCursorRules(projectDir),\n    await attemptToDeleteAiDir({ projectDir, convexDir }),\n  ];\n\n  if (removals.some(Boolean)) logMessage(\"Convex AI files removed.\");\n}\n\n/**\n * Called by `npx convex ai-files disable`.\n *\n * Writes a suppression flag into `convex.json` so `npx convex dev` stops\n * showing AI files install/staleness messages. Files are left in place.\n */\nexport async function safelyAttemptToDisableAiFiles(\n  projectDir: string,\n): Promise<void> {\n  try {\n    await writeAiEnabledToProjectConfig({\n      projectDir,\n      enabled: false,\n    });\n    logMessage(\n      `${chalkStderr.green(`\u2714`)} Convex AI files disabled. Run ${chalkStderr.bold(`npx convex ai-files enable`)} to re-enable.`,\n    );\n  } catch (error) {\n    Sentry.captureException(error);\n    logMessage(\n      chalkStderr.yellow(\n        \"Could not write AI message suppression config. Message may reappear.\",\n      ),\n    );\n  }\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, force: true });\n    logMessage(`${chalkStderr.green(\"\u2714\")} Deleted ${relPath}/`);\n    return true;\n  } catch (error) {\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}: AiFilesPaths): Promise<boolean> {\n  return (\n    (await hasAiFilesConfig({ projectDir, convexDir })) ||\n    (await hasExistingAiFilesArtifacts({ projectDir, convexDir }))\n  );\n}\n\nexport async function maybeSetupAiFiles({\n  ctx,\n  convexDir,\n  projectDir,\n}: {\n  ctx: Context;\n} & AiFilesPaths): Promise<void> {\n  if (!isInInteractiveTerminal()) return;\n\n  const config = await readAiConfig({ projectDir, convexDir });\n  if (config !== null && !config.enabled) return;\n\n  if (await hasAiFilesBeenInstalledBefore({ projectDir, convexDir })) {\n    await attemptToInstallAiFiles({ projectDir, convexDir });\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) await attemptToInstallAiFiles({ projectDir, convexDir });\n}\n"],
+  "mappings": "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",
+  "names": ["fs", "path", "removeLegacyCursorRules"]
+}

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/cli/lib/aiFiles/paths.ts"],
+  "sourcesContent": ["import path from \"path\";\n\nexport type AiFilesPaths = {\n  projectDir: string;\n  convexDir: string;\n};\n\nconst AI_FILES_PARENT_DIR = \"_generated\";\nconst AI_FILES_DIR = \"ai\";\n\nexport function aiDirForConvexDir(convexDir: string): string {\n  return path.join(convexDir, AI_FILES_PARENT_DIR, AI_FILES_DIR);\n}\n\nexport function guidelinesPathForConvexDir(convexDir: string): string {\n  return path.join(aiDirForConvexDir(convexDir), \"guidelines.md\");\n}\n\nexport function aiFilesStatePathForConvexDir(convexDir: string): string {\n  return path.join(aiDirForConvexDir(convexDir), \"ai-files.state.json\");\n}\n\nexport function agentsMdPath(projectDir?: string): string {\n  return path.join(projectDir ?? process.cwd(), \"AGENTS.md\");\n}\n\nexport function claudeMdPath(projectDir?: string): string {\n  return path.join(projectDir ?? process.cwd(), \"CLAUDE.md\");\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAAiB;AAOjB,MAAM,sBAAsB;AAC5B,MAAM,eAAe;AAEd,SAAS,kBAAkB,WAA2B;AAC3D,SAAO,YAAAA,QAAK,KAAK,WAAW,qBAAqB,YAAY;AAC/D;AAEO,SAAS,2BAA2B,WAA2B;AACpE,SAAO,YAAAA,QAAK,KAAK,kBAAkB,SAAS,GAAG,eAAe;AAChE;AAEO,SAAS,6BAA6B,WAA2B;AACtE,SAAO,YAAAA,QAAK,KAAK,kBAAkB,SAAS,GAAG,qBAAqB;AACtE;AAEO,SAAS,aAAa,YAA6B;AACxD,SAAO,YAAAA,QAAK,KAAK,cAAc,QAAQ,IAAI,GAAG,WAAW;AAC3D;AAEO,SAAS,aAAa,YAA6B;AACxD,SAAO,YAAAA,QAAK,KAAK,cAAc,QAAQ,IAAI,GAAG,WAAW;AAC3D;",
+  "names": ["path"]
+}

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

@@ -0,0 +1,180 @@
+"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 skills_exports = {};
+__export(skills_exports, {
+  installSkills: () => installSkills,
+  removeInstalledSkills: () => removeInstalledSkills
+});
+module.exports = __toCommonJS(skills_exports);
+var import_child_process = __toESM(require("child_process"), 1);
+var import_path = __toESM(require("path"), 1);
+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_utils = require("./utils.js");
+async function readInstalledSkillNames(projectDir) {
+  const skillsDir = import_path.default.join(projectDir, ".agents", "skills");
+  const entries = await (0, import_utils.iife)(async () => {
+    try {
+      const dirents = await import_fs.promises.readdir(skillsDir, { withFileTypes: true });
+      return dirents.filter((d) => d.isDirectory() || d.isSymbolicLink()).map((d) => d.name);
+    } catch {
+      return [];
+    }
+  });
+  if (entries.length === 0) return [];
+  const names = [];
+  for (const entry of entries) {
+    const skillMdPath = import_path.default.join(skillsDir, entry, "SKILL.md");
+    const content = await (0, import_utils.readFileSafe)(skillMdPath);
+    if (content === null) continue;
+    const match = content.match(/^---[\s\S]*?^name:\s*(.+?)\s*$/m);
+    if (match) {
+      names.push(match[1]);
+    }
+  }
+  return names;
+}
+function runSkillsAdd(cwd) {
+  return runSkillsCommand(cwd, ["add", "get-convex/agent-skills", "--yes"]);
+}
+function runSkillsRemove({
+  cwd,
+  skillNames
+}) {
+  return runSkillsCommand(cwd, ["remove", ...skillNames, "--yes"]);
+}
+async function shouldRunSkillsCli() {
+  const versionData = await (0, import_versionApi.getVersion)();
+  if (versionData.kind === "error") return true;
+  if (versionData.data.disableSkillsCli) {
+    (0, import_log.logMessage)(import_chalk.chalkStderr.yellow(`Agent skills are temporarily disabled.`));
+    return false;
+  }
+  return true;
+}
+async function removeSkillsLockIfEmpty({
+  projectDir,
+  removedSkillNames
+}) {
+  const lockPath = import_path.default.join(projectDir, "skills-lock.json");
+  try {
+    const content = await import_fs.promises.readFile(lockPath, "utf8");
+    const lock = JSON.parse(content);
+    if (!lock || typeof lock !== "object" || !lock.skills || typeof lock.skills !== "object") {
+      return false;
+    }
+    const remainingSkills = Object.keys(lock.skills).filter(
+      (name) => !removedSkillNames.includes(name)
+    );
+    if (remainingSkills.length === 0) {
+      await import_fs.promises.unlink(lockPath);
+      return true;
+    }
+    return false;
+  } catch {
+    return false;
+  }
+}
+async function installSkills({
+  projectDir,
+  config
+}) {
+  if (!await shouldRunSkillsCli()) return;
+  (0, import_log.logMessage)("Installing Convex agent skills...");
+  const skillsOk = await runSkillsAdd(projectDir);
+  if (!skillsOk) {
+    (0, import_log.logMessage)(
+      import_chalk.chalkStderr.yellow(
+        "Could not install agent skills. You can retry manually with: npx skills add get-convex/agent-skills"
+      )
+    );
+    return;
+  }
+  const sha = await (0, import_versionApi.fetchAgentSkillsSha)();
+  if (sha) config.agentSkillsSha = sha;
+  const names = await readInstalledSkillNames(projectDir);
+  if (names.length > 0) config.installedSkillNames = names;
+}
+async function removeInstalledSkills({
+  projectDir,
+  skillNames
+}) {
+  if (skillNames.length === 0 || !await shouldRunSkillsCli()) return false;
+  (0, import_log.logMessage)(`Removing Convex agent skills: ${skillNames.join(", ")}`);
+  const skillsOk = await runSkillsRemove({ cwd: projectDir, skillNames });
+  if (!skillsOk) {
+    (0, import_log.logMessage)(
+      import_chalk.chalkStderr.yellow(
+        "Could not remove agent skills automatically. Remove them manually with: npx skills remove"
+      )
+    );
+    return false;
+  }
+  const lockRemoved = await removeSkillsLockIfEmpty({
+    projectDir,
+    removedSkillNames: skillNames
+  });
+  if (lockRemoved)
+    (0, import_log.logMessage)(`${import_chalk.chalkStderr.green("\u2714")} Deleted skills-lock.json.`);
+  return true;
+}
+function runSkillsCommand(cwd, args) {
+  return new Promise((resolve) => {
+    const proc = import_child_process.default.spawn(
+      "npx",
+      ["--yes", "skills@latest", ...args],
+      {
+        cwd,
+        stdio: "pipe",
+        // .cmd files on Windows require shell execution.
+        shell: process.platform === "win32"
+      }
+    );
+    let capturedOutput = "";
+    proc.stdout?.on("data", (chunk) => {
+      capturedOutput += chunk.toString();
+    });
+    proc.stderr?.on("data", (chunk) => {
+      capturedOutput += chunk.toString();
+    });
+    proc.on("close", (code) => {
+      if (code !== 0 && capturedOutput.trim().length > 0) {
+        const lines = capturedOutput.trim().split(/\r?\n/);
+        const tail = lines.slice(-10).join("\n");
+        (0, import_log.logMessage)(import_chalk.chalkStderr.gray(`skills output (tail):
+${tail}`));
+      }
+      resolve(code === 0);
+    });
+    proc.on("error", () => resolve(false));
+  });
+}
+//# sourceMappingURL=skills.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/cli/lib/aiFiles/skills.ts"],
+  "sourcesContent": ["import child_process from \"child_process\";\nimport path from \"path\";\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 { getVersion, fetchAgentSkillsSha } from \"../versionApi.js\";\nimport { type AiFilesConfig } from \"./config.js\";\nimport { iife, readFileSafe } from \"./utils.js\";\n\n/**\n * Read the frontmatter `name:` values from skills installed by the skills CLI.\n */\nasync function readInstalledSkillNames(projectDir: string): Promise<string[]> {\n  const skillsDir = path.join(projectDir, \".agents\", \"skills\");\n  const entries = await iife(async () => {\n    try {\n      const dirents = await fs.readdir(skillsDir, { withFileTypes: true });\n      return dirents\n        .filter((d) => d.isDirectory() || d.isSymbolicLink())\n        .map((d) => d.name);\n    } catch {\n      return [] as string[];\n    }\n  });\n  if (entries.length === 0) return [];\n\n  const names: string[] = [];\n  for (const entry of entries) {\n    const skillMdPath = path.join(skillsDir, entry, \"SKILL.md\");\n    const content = await readFileSafe(skillMdPath);\n    if (content === null) continue;\n    const match = content.match(/^---[\\s\\S]*?^name:\\s*(.+?)\\s*$/m);\n    if (match) {\n      names.push(match[1]);\n    }\n  }\n  return names;\n}\n\n/**\n * Runs `npx skills add get-convex/agent-skills --yes` in the given directory.\n * Returns true on success, false if the process fails or cannot be started.\n */\nfunction runSkillsAdd(cwd: string): Promise<boolean> {\n  return runSkillsCommand(cwd, [\"add\", \"get-convex/agent-skills\", \"--yes\"]);\n}\n\n/**\n * Runs `npx skills remove <name...> --yes` to surgically remove only the\n * Convex-managed skills, leaving any skills from other sources intact.\n */\nfunction runSkillsRemove({\n  cwd,\n  skillNames,\n}: {\n  cwd: string;\n  skillNames: string[];\n}): Promise<boolean> {\n  return runSkillsCommand(cwd, [\"remove\", ...skillNames, \"--yes\"]);\n}\n\n/**\n * This function exists so we have a way to disable skills installs without pushing a new\n * version of the convex CLI\n */\nasync function shouldRunSkillsCli(): Promise<boolean> {\n  const versionData = await getVersion();\n\n  if (versionData.kind === \"error\") return true;\n\n  if (versionData.data.disableSkillsCli) {\n    logMessage(chalkStderr.yellow(`Agent skills are temporarily disabled.`));\n    return false;\n  }\n\n  return true;\n}\n\n/**\n * Remove the skills-lock.json file if it only contains skills that we\n * are removing. The `npx skills remove` command leaves the lockfile behind\n * even when it's logically empty.\n */\nasync function removeSkillsLockIfEmpty({\n  projectDir,\n  removedSkillNames,\n}: {\n  projectDir: string;\n  removedSkillNames: string[];\n}): Promise<boolean> {\n  const lockPath = path.join(projectDir, \"skills-lock.json\");\n  try {\n    const content = await fs.readFile(lockPath, \"utf8\");\n    const lock = JSON.parse(content);\n\n    if (\n      !lock ||\n      typeof lock !== \"object\" ||\n      !lock.skills ||\n      typeof lock.skills !== \"object\"\n    ) {\n      return false;\n    }\n\n    const remainingSkills = Object.keys(lock.skills).filter(\n      (name) => !removedSkillNames.includes(name),\n    );\n\n    if (remainingSkills.length === 0) {\n      await fs.unlink(lockPath);\n      return true;\n    }\n    return false;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Install Convex agent skills and record the SHA and names into the config.\n * Handles the kill-switch check and all logging internally.\n */\nexport async function installSkills({\n  projectDir,\n  config,\n}: {\n  projectDir: string;\n  config: AiFilesConfig;\n}): Promise<void> {\n  if (!(await shouldRunSkillsCli())) return;\n\n  logMessage(\"Installing Convex agent skills...\");\n  const skillsOk = await runSkillsAdd(projectDir);\n  if (!skillsOk) {\n    logMessage(\n      chalkStderr.yellow(\n        \"Could not install agent skills. You can retry manually with: npx skills add get-convex/agent-skills\",\n      ),\n    );\n    return;\n  }\n\n  const sha = await fetchAgentSkillsSha();\n  if (sha) config.agentSkillsSha = sha;\n\n  const names = await readInstalledSkillNames(projectDir);\n  if (names.length > 0) config.installedSkillNames = names;\n}\n\n/**\n * Remove Convex-managed agent skills and clean up the lock file if empty.\n * Returns true if any removal occurred.\n */\nexport async function removeInstalledSkills({\n  projectDir,\n  skillNames,\n}: {\n  projectDir: string;\n  skillNames: string[];\n}): Promise<boolean> {\n  if (skillNames.length === 0 || !(await shouldRunSkillsCli())) return false;\n\n  logMessage(`Removing Convex agent skills: ${skillNames.join(\", \")}`);\n  const skillsOk = await runSkillsRemove({ cwd: projectDir, skillNames });\n  if (!skillsOk) {\n    logMessage(\n      chalkStderr.yellow(\n        \"Could not remove agent skills automatically. Remove them manually with: npx skills remove\",\n      ),\n    );\n    return false;\n  }\n\n  const lockRemoved = await removeSkillsLockIfEmpty({\n    projectDir,\n    removedSkillNames: skillNames,\n  });\n  if (lockRemoved)\n    logMessage(`${chalkStderr.green(\"\u2714\")} Deleted skills-lock.json.`);\n  return true;\n}\n\nfunction runSkillsCommand(cwd: string, args: string[]): Promise<boolean> {\n  return new Promise((resolve) => {\n    const proc = child_process.spawn(\n      \"npx\",\n      [\"--yes\", \"skills@latest\", ...args],\n      {\n        cwd,\n        stdio: \"pipe\",\n        // .cmd files on Windows require shell execution.\n        shell: process.platform === \"win32\",\n      },\n    );\n    let capturedOutput = \"\";\n    proc.stdout?.on(\"data\", (chunk) => {\n      capturedOutput += chunk.toString();\n    });\n    proc.stderr?.on(\"data\", (chunk) => {\n      capturedOutput += chunk.toString();\n    });\n    proc.on(\"close\", (code) => {\n      if (code !== 0 && capturedOutput.trim().length > 0) {\n        const lines = capturedOutput.trim().split(/\\r?\\n/);\n        const tail = lines.slice(-10).join(\"\\n\");\n        logMessage(chalkStderr.gray(`skills output (tail):\\n${tail}`));\n      }\n      resolve(code === 0);\n    });\n    proc.on(\"error\", () => resolve(false));\n  });\n}\n"],
+  "mappings": "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",
+  "names": ["path", "fs", "child_process"]
+}