convex 1.34.0 → 1.35.0

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

@@ -0,0 +1,193 @@
+"use strict";
+import * as Sentry from "@sentry/node";
+import path from "path";
+import { promises as fs } from "fs";
+import { chalkStderr } from "chalk";
+import { logMessage } from "../../../bundler/log.js";
+import { promptYesNo } from "../utils/prompts.js";
+import { aiDirForConvexDir } from "./paths.js";
+import {
+  installGuidelinesFile,
+  hasGuidelinesInstalled
+} from "./guidelinesmd.js";
+import {
+  attemptReadAiState,
+  readAiStateOrDefault,
+  writeAiState,
+  hasAiState
+} from "./state.js";
+import { exhaustiveCheck, isInInteractiveTerminal } from "./utils.js";
+import {
+  hasAgentsMdInstalled,
+  applyAgentsMdSection,
+  attemptToRemoveAgentsMdSection
+} from "./agentsmd.js";
+import {
+  hasClaudeMdInstalled,
+  applyClaudeMdSection,
+  attemptToRemoveClaudeMdSection
+} from "./claudemd.js";
+import { installSkills, removeInstalledSkills } from "./skills.js";
+import { removeLegacyCursorRulesFile as removeLegacyCursorRules } from "./cursorrules.js";
+async function hasExistingAiFilesArtifacts({
+  projectDir,
+  convexDir
+}) {
+  return await hasGuidelinesInstalled(convexDir) || await hasAgentsMdInstalled(projectDir) || await hasClaudeMdInstalled(projectDir);
+}
+export async function installAiFiles({
+  projectDir,
+  convexDir,
+  aiFilesConfig
+}) {
+  const convexDirName = path.relative(projectDir, convexDir);
+  const state = await readAiStateOrDefault(convexDir);
+  await installGuidelinesFile({ convexDir, state });
+  await applyAgentsMdSection({ projectDir, state, convexDirName });
+  await applyClaudeMdSection({ projectDir, state, convexDirName });
+  await installSkills({ projectDir, state, aiFilesConfig });
+  await removeLegacyCursorRules(projectDir);
+  await writeAiState({ state, convexDir });
+}
+async function attemptToInstallAiFiles(opts) {
+  try {
+    await installAiFiles(opts);
+  } catch (error) {
+    Sentry.captureException(error);
+  }
+}
+export function isAiFilesDisabled(aiFilesConfig) {
+  if (aiFilesConfig?.enabled !== void 0)
+    return aiFilesConfig.enabled === false;
+  return aiFilesConfig?.disableStalenessMessage === true;
+}
+async function determineAiFilesStaleness({
+  canonicalGuidelinesHash,
+  canonicalAgentSkillsSha,
+  aiFilesConfig,
+  projectDir,
+  convexDir
+}) {
+  if (isAiFilesDisabled(aiFilesConfig)) return "silent";
+  const result = await attemptReadAiState(convexDir);
+  if (result.kind === "no-file" || result.kind === "parse-error") {
+    const hasArtifacts = await hasExistingAiFilesArtifacts({
+      projectDir,
+      convexDir
+    });
+    return hasArtifacts ? "silent" : "not-installed";
+  }
+  if (result.kind === "ok") {
+    const { state } = result;
+    if (canonicalGuidelinesHash === null && canonicalAgentSkillsSha === null)
+      return "silent";
+    const guidelinesStale = canonicalGuidelinesHash !== null && state.guidelinesHash !== null && state.guidelinesHash !== canonicalGuidelinesHash;
+    const skillsStale = canonicalAgentSkillsSha !== null && state.agentSkillsSha !== null && state.agentSkillsSha !== canonicalAgentSkillsSha;
+    return guidelinesStale || skillsStale ? "stale" : "silent";
+  }
+  return exhaustiveCheck(result);
+}
+export async function checkAiFilesStalenessAndLog(opts) {
+  const status = await determineAiFilesStaleness(opts);
+  if (status === "not-installed") {
+    logMessage(
+      chalkStderr.yellow(
+        `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.`
+      )
+    );
+    return;
+  }
+  if (status === "stale") {
+    logMessage(
+      chalkStderr.yellow(
+        `Your Convex AI files are out of date. Run ${chalkStderr.bold(`npx convex ai-files update`)} to get the latest.`
+      )
+    );
+    return;
+  }
+  if (status === "silent") return;
+  exhaustiveCheck(status);
+}
+export async function enableAiFiles({
+  projectDir,
+  convexDir,
+  aiFilesConfig
+}) {
+  await installAiFiles({ projectDir, convexDir, aiFilesConfig });
+  const { disableStalenessMessage: _, ...rest } = aiFilesConfig ?? {};
+  return { ...rest, enabled: true };
+}
+export function disableAiFiles(aiFilesConfig) {
+  const { disableStalenessMessage: _, ...rest } = aiFilesConfig ?? {};
+  return { ...rest, enabled: false };
+}
+export async function removeAiFiles({
+  projectDir,
+  convexDir
+}) {
+  const result = await attemptReadAiState(convexDir);
+  const installedSkillNames = result.kind === "ok" ? result.state.installedSkillNames : result.kind === "no-file" || result.kind === "parse-error" ? [] : exhaustiveCheck(result);
+  const removals = [
+    await attemptToRemoveAgentsMdSection(projectDir),
+    await attemptToRemoveClaudeMdSection(projectDir),
+    await removeInstalledSkills({
+      projectDir,
+      skillNames: installedSkillNames
+    }),
+    await removeLegacyCursorRules(projectDir),
+    await attemptToDeleteAiDir({ projectDir, convexDir })
+  ];
+  if (removals.some(Boolean)) logMessage("Convex AI files removed.");
+  else logMessage("No Convex AI files found \u2014 nothing to remove.");
+}
+async function attemptToDeleteAiDir({
+  projectDir,
+  convexDir
+}) {
+  const aiDir = aiDirForConvexDir(convexDir);
+  const relPath = path.relative(projectDir, aiDir);
+  try {
+    await fs.rm(aiDir, { recursive: true });
+    logMessage(`${chalkStderr.green("\u2714")} Deleted ${relPath}/`);
+    return true;
+  } catch (error) {
+    if (error.code === "ENOENT") return false;
+    Sentry.captureException(error);
+    logMessage(
+      chalkStderr.yellow(`Could not delete ${relPath}/. Remove it manually.`)
+    );
+    return false;
+  }
+}
+async function hasAiFilesBeenInstalledBefore({
+  projectDir,
+  convexDir,
+  aiFilesConfig
+}) {
+  if (isAiFilesDisabled(aiFilesConfig)) return false;
+  return await hasAiState(convexDir) || await hasExistingAiFilesArtifacts({ projectDir, convexDir });
+}
+export async function attemptSetupAiFiles({
+  ctx,
+  convexDir,
+  projectDir,
+  aiFilesConfig
+}) {
+  if (!isInInteractiveTerminal()) return;
+  if (isAiFilesDisabled(aiFilesConfig)) return;
+  if (await hasAiFilesBeenInstalledBefore({
+    projectDir,
+    convexDir,
+    aiFilesConfig
+  })) {
+    await attemptToInstallAiFiles({ projectDir, convexDir, aiFilesConfig });
+    return;
+  }
+  const shouldInstall = await promptYesNo(ctx, {
+    message: "Set up Convex AI files? (guidelines, AGENTS.md, agent skills)",
+    default: true
+  });
+  if (shouldInstall)
+    await attemptToInstallAiFiles({ projectDir, convexDir, aiFilesConfig });
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/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  attemptReadAiState,\n  readAiStateOrDefault,\n  writeAiState,\n  hasAiState,\n} from \"./state.js\";\nimport { type AiFilesProjectConfig } from \"../config.js\";\nimport { exhaustiveCheck, isInInteractiveTerminal } from \"./utils.js\";\nimport {\n  hasAgentsMdInstalled,\n  applyAgentsMdSection,\n  attemptToRemoveAgentsMdSection,\n} from \"./agentsmd.js\";\nimport {\n  hasClaudeMdInstalled,\n  applyClaudeMdSection,\n  attemptToRemoveClaudeMdSection,\n} from \"./claudemd.js\";\nimport { installSkills, removeInstalledSkills } from \"./skills.js\";\nimport { removeLegacyCursorRulesFile as removeLegacyCursorRules } from \"./cursorrules.js\";\n\nasync function hasExistingAiFilesArtifacts({\n  projectDir,\n  convexDir,\n}: AiFilesPaths): Promise<boolean> {\n  return (\n    (await hasGuidelinesInstalled(convexDir)) ||\n    (await hasAgentsMdInstalled(projectDir)) ||\n    (await hasClaudeMdInstalled(projectDir))\n  );\n}\n\n/**\n * Install or refresh all Convex AI files.\n *\n * Reads the existing state if present, or starts from a blank one for a\n * fresh install.\n */\nexport async function installAiFiles({\n  projectDir,\n  convexDir,\n  aiFilesConfig,\n}: AiFilesPaths & {\n  aiFilesConfig?: AiFilesProjectConfig | undefined;\n}): Promise<void> {\n  const convexDirName = path.relative(projectDir, convexDir);\n  const state = await readAiStateOrDefault(convexDir);\n\n  await installGuidelinesFile({ convexDir, state });\n  await applyAgentsMdSection({ projectDir, state, convexDirName });\n  await applyClaudeMdSection({ projectDir, state, convexDirName });\n  await installSkills({ projectDir, state, aiFilesConfig });\n  await removeLegacyCursorRules(projectDir);\n  await writeAiState({ state, convexDir });\n}\n\nasync function attemptToInstallAiFiles(\n  opts: Parameters<typeof installAiFiles>[0],\n): Promise<void> {\n  try {\n    await installAiFiles(opts);\n  } catch (error) {\n    Sentry.captureException(error);\n  }\n}\n\ntype AiFilesStalenessStatus = \"not-installed\" | \"stale\" | \"silent\";\n\nexport function isAiFilesDisabled(\n  aiFilesConfig: AiFilesProjectConfig | undefined,\n): boolean {\n  if (aiFilesConfig?.enabled !== undefined)\n    return aiFilesConfig.enabled === false;\n  return aiFilesConfig?.disableStalenessMessage === true;\n}\n\nasync function determineAiFilesStaleness({\n  canonicalGuidelinesHash,\n  canonicalAgentSkillsSha,\n  aiFilesConfig,\n  projectDir,\n  convexDir,\n}: {\n  canonicalGuidelinesHash: string | null;\n  canonicalAgentSkillsSha: string | null;\n  aiFilesConfig?: AiFilesProjectConfig | undefined;\n} & AiFilesPaths): Promise<AiFilesStalenessStatus> {\n  if (isAiFilesDisabled(aiFilesConfig)) return \"silent\";\n\n  const result = await attemptReadAiState(convexDir);\n\n  if (result.kind === \"no-file\" || result.kind === \"parse-error\") {\n    const hasArtifacts = await hasExistingAiFilesArtifacts({\n      projectDir,\n      convexDir,\n    });\n    return hasArtifacts ? \"silent\" : \"not-installed\";\n  }\n\n  if (result.kind === \"ok\") {\n    const { state } = result;\n\n    if (canonicalGuidelinesHash === null && canonicalAgentSkillsSha === null)\n      return \"silent\";\n\n    const guidelinesStale =\n      canonicalGuidelinesHash !== null &&\n      state.guidelinesHash !== null &&\n      state.guidelinesHash !== canonicalGuidelinesHash;\n\n    const skillsStale =\n      canonicalAgentSkillsSha !== null &&\n      state.agentSkillsSha !== null &&\n      state.agentSkillsSha !== canonicalAgentSkillsSha;\n\n    return guidelinesStale || skillsStale ? \"stale\" : \"silent\";\n  }\n\n  return exhaustiveCheck(result);\n}\n\n/**\n * Check whether the Convex AI files are out of date and log a nag message\n * if so.\n */\nexport async function checkAiFilesStalenessAndLog(\n  opts: {\n    canonicalGuidelinesHash: string | null;\n    canonicalAgentSkillsSha: string | null;\n    aiFilesConfig?: AiFilesProjectConfig | undefined;\n  } & AiFilesPaths,\n): Promise<void> {\n  const status = await determineAiFilesStaleness(opts);\n\n  if (status === \"not-installed\") {\n    logMessage(\n      chalkStderr.yellow(\n        `Convex AI files are not installed. Run ${chalkStderr.bold(`npx convex ai-files install`)} to get started or ${chalkStderr.bold(`npx convex ai-files disable`)} to hide this message.`,\n      ),\n    );\n    return;\n  }\n\n  if (status === \"stale\") {\n    logMessage(\n      chalkStderr.yellow(\n        `Your Convex AI files are out of date. Run ${chalkStderr.bold(`npx convex ai-files update`)} to get the latest.`,\n      ),\n    );\n    return;\n  }\n\n  if (status === \"silent\") return;\n\n  exhaustiveCheck(status);\n}\n\n/**\n * Installs AI files and returns the aiFiles config to write.\n */\nexport async function enableAiFiles({\n  projectDir,\n  convexDir,\n  aiFilesConfig,\n}: AiFilesPaths & {\n  aiFilesConfig?: AiFilesProjectConfig | undefined;\n}): Promise<AiFilesProjectConfig> {\n  await installAiFiles({ projectDir, convexDir, aiFilesConfig });\n  // Deleting the deprecated disableStalenessMessage key\n  const { disableStalenessMessage: _, ...rest } = aiFilesConfig ?? {};\n  return { ...rest, enabled: true };\n}\n\n/**\n * Returns the aiFiles config to write when disabling AI files.\n */\nexport function disableAiFiles(\n  aiFilesConfig?: AiFilesProjectConfig | undefined,\n): AiFilesProjectConfig {\n  // Deleting the deprecated disableStalenessMessage key\n  const { disableStalenessMessage: _, ...rest } = aiFilesConfig ?? {};\n  return { ...rest, enabled: false };\n}\n\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 result = await attemptReadAiState(convexDir);\n\n  // Skill names are only known when the state file exists and parses.\n  // All other artifacts (AGENTS.md, CLAUDE.md sections, ai dir) can exist\n  // independently, so we always attempt their removal.\n  const installedSkillNames =\n    result.kind === \"ok\"\n      ? result.state.installedSkillNames\n      : result.kind === \"no-file\" || result.kind === \"parse-error\"\n        ? []\n        : exhaustiveCheck(result);\n\n  const removals = [\n    await attemptToRemoveAgentsMdSection(projectDir),\n    await attemptToRemoveClaudeMdSection(projectDir),\n    await removeInstalledSkills({\n      projectDir,\n      skillNames: installedSkillNames,\n    }),\n    await removeLegacyCursorRules(projectDir),\n    await attemptToDeleteAiDir({ projectDir, convexDir }),\n  ];\n\n  if (removals.some(Boolean)) logMessage(\"Convex AI files removed.\");\n  else logMessage(\"No Convex AI files found \u2014 nothing to remove.\");\n}\n\nasync function attemptToDeleteAiDir({\n  projectDir,\n  convexDir,\n}: AiFilesPaths): Promise<boolean> {\n  const aiDir = aiDirForConvexDir(convexDir);\n  const relPath = path.relative(projectDir, aiDir);\n  try {\n    await fs.rm(aiDir, { recursive: true });\n    logMessage(`${chalkStderr.green(\"\u2714\")} Deleted ${relPath}/`);\n    return true;\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return false;\n    Sentry.captureException(error);\n    logMessage(\n      chalkStderr.yellow(`Could not delete ${relPath}/. Remove it manually.`),\n    );\n    return false;\n  }\n}\n\nasync function hasAiFilesBeenInstalledBefore({\n  projectDir,\n  convexDir,\n  aiFilesConfig,\n}: AiFilesPaths & {\n  aiFilesConfig?: AiFilesProjectConfig | undefined;\n}): Promise<boolean> {\n  if (isAiFilesDisabled(aiFilesConfig)) return false;\n  return (\n    (await hasAiState(convexDir)) ||\n    (await hasExistingAiFilesArtifacts({ projectDir, convexDir }))\n  );\n}\n\nexport async function attemptSetupAiFiles({\n  ctx,\n  convexDir,\n  projectDir,\n  aiFilesConfig,\n}: {\n  ctx: Context;\n  aiFilesConfig?: AiFilesProjectConfig | undefined;\n} & AiFilesPaths): Promise<void> {\n  if (!isInInteractiveTerminal()) return;\n  if (isAiFilesDisabled(aiFilesConfig)) return;\n\n  if (\n    await hasAiFilesBeenInstalledBefore({\n      projectDir,\n      convexDir,\n      aiFilesConfig,\n    })\n  ) {\n    await attemptToInstallAiFiles({ projectDir, convexDir, aiFilesConfig });\n    return;\n  }\n\n  const shouldInstall = await promptYesNo(ctx, {\n    message: \"Set up Convex AI files? (guidelines, AGENTS.md, agent skills)\",\n    default: true,\n  });\n\n  if (shouldInstall)\n    await attemptToInstallAiFiles({ projectDir, convexDir, aiFilesConfig });\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/esm/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,OAAO,UAAU;AAOjB,MAAM,sBAAsB;AAC5B,MAAM,eAAe;AAEd,gBAAS,kBAAkB,WAA2B;AAC3D,SAAO,KAAK,KAAK,WAAW,qBAAqB,YAAY;AAC/D;AAEO,gBAAS,2BAA2B,WAA2B;AACpE,SAAO,KAAK,KAAK,kBAAkB,SAAS,GAAG,eAAe;AAChE;AAEO,gBAAS,6BAA6B,WAA2B;AACtE,SAAO,KAAK,KAAK,kBAAkB,SAAS,GAAG,qBAAqB;AACtE;AAEO,gBAAS,aAAa,YAA6B;AACxD,SAAO,KAAK,KAAK,cAAc,QAAQ,IAAI,GAAG,WAAW;AAC3D;AAEO,gBAAS,aAAa,YAA6B;AACxD,SAAO,KAAK,KAAK,cAAc,QAAQ,IAAI,GAAG,WAAW;AAC3D;",
+  "names": []
+}

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

@@ -0,0 +1,163 @@
+"use strict";
+import child_process from "child_process";
+import path from "path";
+import { promises as fs } from "fs";
+import { chalkStderr } from "chalk";
+import { logMessage } from "../../../bundler/log.js";
+import { getVersion, fetchAgentSkillsSha } from "../versionApi.js";
+import { exhaustiveCheck, iife, readFileOrNull } from "./utils.js";
+async function readInstalledSkillNames(projectDir) {
+  const skillsDir = path.join(projectDir, ".agents", "skills");
+  const entries = await iife(async () => {
+    try {
+      const dirents = await fs.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 = path.join(skillsDir, entry, "SKILL.md");
+    const content = await readFileOrNull(skillMdPath);
+    if (content === null) continue;
+    const match = content.match(/^---[\s\S]*?^name:\s*(.+?)\s*$/m);
+    if (match) {
+      names.push(match[1]);
+    }
+  }
+  return names;
+}
+function configuredSkillAgents(aiFilesConfig) {
+  const defaultAgents = ["claude-code", "codex"];
+  return aiFilesConfig?.skills?.agents ?? defaultAgents;
+}
+function runSkillsAdd(cwd, agents) {
+  const args = ["add", "get-convex/agent-skills", "--yes"];
+  for (const agent of agents) {
+    args.push("--agent", agent);
+  }
+  return runSkillsCommand(cwd, args);
+}
+function runSkillsRemove({
+  cwd,
+  skillNames
+}) {
+  return runSkillsCommand(cwd, ["remove", ...skillNames, "--yes"]);
+}
+async function shouldRunSkillsCli() {
+  const versionData = await getVersion();
+  if (versionData.kind === "error") return true;
+  if (versionData.kind === "ok") {
+    if (versionData.data.disableSkillsCli) {
+      logMessage(chalkStderr.yellow(`Agent skills are temporarily disabled.`));
+      return false;
+    }
+    return true;
+  }
+  return exhaustiveCheck(versionData);
+}
+async function removeSkillsLockIfEmpty({
+  projectDir,
+  removedSkillNames
+}) {
+  const lockPath = path.join(projectDir, "skills-lock.json");
+  try {
+    const content = await fs.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 fs.unlink(lockPath);
+      return true;
+    }
+    return false;
+  } catch {
+    return false;
+  }
+}
+export async function installSkills({
+  projectDir,
+  state,
+  aiFilesConfig
+}) {
+  if (!await shouldRunSkillsCli()) return;
+  const agents = configuredSkillAgents(aiFilesConfig);
+  if (agents.length === 0) return;
+  logMessage("Installing Convex agent skills...");
+  const skillsOk = await runSkillsAdd(projectDir, agents);
+  if (!skillsOk) {
+    logMessage(
+      chalkStderr.yellow(
+        "Could not install agent skills. You can retry manually with: npx skills add get-convex/agent-skills"
+      )
+    );
+    return;
+  }
+  const sha = await fetchAgentSkillsSha();
+  if (sha) state.agentSkillsSha = sha;
+  const names = await readInstalledSkillNames(projectDir);
+  if (names.length > 0) state.installedSkillNames = names;
+  logMessage(`${chalkStderr.green("\u2714")} Skills installed`);
+}
+export async function removeInstalledSkills({
+  projectDir,
+  skillNames
+}) {
+  if (skillNames.length === 0) return false;
+  if (!await shouldRunSkillsCli()) return false;
+  logMessage(`Removing Convex agent skills: ${skillNames.join(", ")}`);
+  const skillsOk = await runSkillsRemove({ cwd: projectDir, skillNames });
+  if (!skillsOk) {
+    logMessage(
+      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)
+    logMessage(`${chalkStderr.green("\u2714")} Deleted skills-lock.json.`);
+  return true;
+}
+function runSkillsCommand(cwd, args) {
+  return new Promise((resolve) => {
+    const proc = child_process.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");
+        logMessage(chalkStderr.gray(`skills output (tail):
+${tail}`));
+      }
+      resolve(code === 0);
+    });
+    proc.on("error", () => resolve(false));
+  });
+}
+//# sourceMappingURL=skills.js.map

package/dist/esm/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 AiFilesState } from \"./state.js\";\nimport { exhaustiveCheck, iife, readFileOrNull } from \"./utils.js\";\n\nimport { type AiFilesProjectConfig } from \"../config.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 readFileOrNull(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 * Resolve the configured agent list, falling back to defaults.\n */\nfunction configuredSkillAgents(\n  aiFilesConfig?: AiFilesProjectConfig | undefined,\n): string[] {\n  // We default to the two most popular agents for now, \"codex\" installs to `.agents` which also\n  // covers cursor and many other tools. See: https://github.com/vercel-labs/skills?tab=readme-ov-file#supported-agents\n  const defaultAgents = [\"claude-code\", \"codex\"];\n  return aiFilesConfig?.skills?.agents ?? defaultAgents;\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, agents: string[]): Promise<boolean> {\n  const args = [\"add\", \"get-convex/agent-skills\", \"--yes\"];\n  for (const agent of agents) {\n    args.push(\"--agent\", agent);\n  }\n  return runSkillsCommand(cwd, args);\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.kind === \"ok\") {\n    if (versionData.data.disableSkillsCli) {\n      logMessage(chalkStderr.yellow(`Agent skills are temporarily disabled.`));\n      return false;\n    }\n    return true;\n  }\n\n  return exhaustiveCheck(versionData);\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 state.\n * Handles the kill-switch check and all logging internally.\n */\nexport async function installSkills({\n  projectDir,\n  state,\n  aiFilesConfig,\n}: {\n  projectDir: string;\n  state: AiFilesState;\n  aiFilesConfig?: AiFilesProjectConfig | undefined;\n}): Promise<void> {\n  if (!(await shouldRunSkillsCli())) return;\n  const agents = configuredSkillAgents(aiFilesConfig);\n  if (agents.length === 0) return;\n\n  logMessage(\"Installing Convex agent skills...\");\n  const skillsOk = await runSkillsAdd(projectDir, agents);\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) state.agentSkillsSha = sha;\n\n  const names = await readInstalledSkillNames(projectDir);\n  if (names.length > 0) state.installedSkillNames = names;\n\n  logMessage(`${chalkStderr.green(\"\u2714\")} Skills installed`);\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) return false;\n  if (!(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\n  if (lockRemoved)\n    logMessage(`${chalkStderr.green(\"\u2714\")} Deleted skills-lock.json.`);\n\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": []
+}

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

@@ -0,0 +1,60 @@
+"use strict";
+import * as Sentry from "@sentry/node";
+import { promises as fs } from "fs";
+import { z } from "zod";
+import { aiDirForConvexDir, aiFilesStatePathForConvexDir } from "./paths.js";
+import { attemptReadFile, exhaustiveCheck } from "./utils.js";
+export const aiFilesStateSchema = z.object({
+  guidelinesHash: z.string().nullable(),
+  agentsMdSectionHash: z.string().nullable(),
+  claudeMdHash: z.string().nullable(),
+  // Commit SHA from get-convex/agent-skills that was current when skills were
+  // last installed. Used to detect when newer skills are available.
+  agentSkillsSha: z.string().nullable(),
+  // Names of skills installed by `npx skills add`, used by `remove` to
+  // only remove Convex-managed skills.
+  installedSkillNames: z.array(z.string()).default([])
+});
+const DEFAULT_AI_STATE = {
+  guidelinesHash: null,
+  agentsMdSectionHash: null,
+  claudeMdHash: null,
+  agentSkillsSha: null,
+  installedSkillNames: []
+};
+export async function attemptReadAiState(convexDir) {
+  const result = await attemptReadFile(aiFilesStatePathForConvexDir(convexDir));
+  if (result.kind === "not-found" || result.kind === "empty")
+    return { kind: "no-file" };
+  try {
+    const state = aiFilesStateSchema.parse(JSON.parse(result.content));
+    return { kind: "ok", state };
+  } catch (error) {
+    Sentry.captureException(error);
+    return { kind: "parse-error", error };
+  }
+}
+export async function readAiStateOrDefault(convexDir) {
+  const result = await attemptReadAiState(convexDir);
+  if (result.kind === "ok") return result.state;
+  if (result.kind === "no-file") return { ...DEFAULT_AI_STATE };
+  if (result.kind === "parse-error") return { ...DEFAULT_AI_STATE };
+  return exhaustiveCheck(result);
+}
+export async function hasAiState(convexDir) {
+  const result = await attemptReadAiState(convexDir);
+  return result.kind === "ok";
+}
+export async function writeAiState({
+  state,
+  convexDir
+}) {
+  const validated = aiFilesStateSchema.parse(state);
+  await fs.mkdir(aiDirForConvexDir(convexDir), { recursive: true });
+  await fs.writeFile(
+    aiFilesStatePathForConvexDir(convexDir),
+    JSON.stringify(validated, null, 2) + "\n",
+    "utf8"
+  );
+}
+//# sourceMappingURL=state.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/cli/lib/aiFiles/state.ts"],
+  "sourcesContent": ["import * as Sentry from \"@sentry/node\";\n// Use raw fs (not ctx.fs) so these operations run asynchronously and don't\n// interfere with the file-watcher used by `convex dev`.\n// eslint-disable-next-line no-restricted-imports\nimport { promises as fs } from \"fs\";\nimport { z } from \"zod\";\nimport { aiDirForConvexDir, aiFilesStatePathForConvexDir } from \"./paths.js\";\nimport { attemptReadFile, exhaustiveCheck } from \"./utils.js\";\n\nexport const aiFilesStateSchema = z.object({\n  guidelinesHash: z.string().nullable(),\n  agentsMdSectionHash: z.string().nullable(),\n  claudeMdHash: z.string().nullable(),\n  // Commit SHA from get-convex/agent-skills that was current when skills were\n  // last installed. Used to detect when newer skills are available.\n  agentSkillsSha: z.string().nullable(),\n  // Names of skills installed by `npx skills add`, used by `remove` to\n  // only remove Convex-managed skills.\n  installedSkillNames: z.array(z.string()).default([]),\n});\n\nexport type AiFilesState = z.infer<typeof aiFilesStateSchema>;\n\nconst DEFAULT_AI_STATE: AiFilesState = {\n  guidelinesHash: null,\n  agentsMdSectionHash: null,\n  claudeMdHash: null,\n  agentSkillsSha: null,\n  installedSkillNames: [],\n};\n\nexport type AttemptReadAiStateResult =\n  | { kind: \"no-file\" }\n  | { kind: \"ok\"; state: AiFilesState }\n  | { kind: \"parse-error\"; error: unknown };\n\nexport async function attemptReadAiState(\n  convexDir: string,\n): Promise<AttemptReadAiStateResult> {\n  const result = await attemptReadFile(aiFilesStatePathForConvexDir(convexDir));\n  if (result.kind === \"not-found\" || result.kind === \"empty\")\n    return { kind: \"no-file\" };\n\n  try {\n    const state = aiFilesStateSchema.parse(JSON.parse(result.content));\n    return { kind: \"ok\", state };\n  } catch (error) {\n    Sentry.captureException(error);\n    return { kind: \"parse-error\", error };\n  }\n}\n\nexport async function readAiStateOrDefault(\n  convexDir: string,\n): Promise<AiFilesState> {\n  const result = await attemptReadAiState(convexDir);\n  if (result.kind === \"ok\") return result.state;\n  if (result.kind === \"no-file\") return { ...DEFAULT_AI_STATE };\n  if (result.kind === \"parse-error\") return { ...DEFAULT_AI_STATE };\n  return exhaustiveCheck(result);\n}\n\nexport async function hasAiState(convexDir: string): Promise<boolean> {\n  const result = await attemptReadAiState(convexDir);\n  return result.kind === \"ok\";\n}\n\nexport async function writeAiState({\n  state,\n  convexDir,\n}: {\n  state: AiFilesState;\n  convexDir: string;\n}): Promise<void> {\n  const validated = aiFilesStateSchema.parse(state);\n  await fs.mkdir(aiDirForConvexDir(convexDir), { recursive: true });\n  await fs.writeFile(\n    aiFilesStatePathForConvexDir(convexDir),\n    JSON.stringify(validated, null, 2) + \"\\n\",\n    \"utf8\",\n  );\n}\n"],
+  "mappings": ";AAAA,YAAY,YAAY;AAIxB,SAAS,YAAY,UAAU;AAC/B,SAAS,SAAS;AAClB,SAAS,mBAAmB,oCAAoC;AAChE,SAAS,iBAAiB,uBAAuB;AAE1C,aAAM,qBAAqB,EAAE,OAAO;AAAA,EACzC,gBAAgB,EAAE,OAAO,EAAE,SAAS;AAAA,EACpC,qBAAqB,EAAE,OAAO,EAAE,SAAS;AAAA,EACzC,cAAc,EAAE,OAAO,EAAE,SAAS;AAAA;AAAA;AAAA,EAGlC,gBAAgB,EAAE,OAAO,EAAE,SAAS;AAAA;AAAA;AAAA,EAGpC,qBAAqB,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;AACrD,CAAC;AAID,MAAM,mBAAiC;AAAA,EACrC,gBAAgB;AAAA,EAChB,qBAAqB;AAAA,EACrB,cAAc;AAAA,EACd,gBAAgB;AAAA,EAChB,qBAAqB,CAAC;AACxB;AAOA,sBAAsB,mBACpB,WACmC;AACnC,QAAM,SAAS,MAAM,gBAAgB,6BAA6B,SAAS,CAAC;AAC5E,MAAI,OAAO,SAAS,eAAe,OAAO,SAAS;AACjD,WAAO,EAAE,MAAM,UAAU;AAE3B,MAAI;AACF,UAAM,QAAQ,mBAAmB,MAAM,KAAK,MAAM,OAAO,OAAO,CAAC;AACjE,WAAO,EAAE,MAAM,MAAM,MAAM;AAAA,EAC7B,SAAS,OAAO;AACd,WAAO,iBAAiB,KAAK;AAC7B,WAAO,EAAE,MAAM,eAAe,MAAM;AAAA,EACtC;AACF;AAEA,sBAAsB,qBACpB,WACuB;AACvB,QAAM,SAAS,MAAM,mBAAmB,SAAS;AACjD,MAAI,OAAO,SAAS,KAAM,QAAO,OAAO;AACxC,MAAI,OAAO,SAAS,UAAW,QAAO,EAAE,GAAG,iBAAiB;AAC5D,MAAI,OAAO,SAAS,cAAe,QAAO,EAAE,GAAG,iBAAiB;AAChE,SAAO,gBAAgB,MAAM;AAC/B;AAEA,sBAAsB,WAAW,WAAqC;AACpE,QAAM,SAAS,MAAM,mBAAmB,SAAS;AACjD,SAAO,OAAO,SAAS;AACzB;AAEA,sBAAsB,aAAa;AAAA,EACjC;AAAA,EACA;AACF,GAGkB;AAChB,QAAM,YAAY,mBAAmB,MAAM,KAAK;AAChD,QAAM,GAAG,MAAM,kBAAkB,SAAS,GAAG,EAAE,WAAW,KAAK,CAAC;AAChE,QAAM,GAAG;AAAA,IACP,6BAA6B,SAAS;AAAA,IACtC,KAAK,UAAU,WAAW,MAAM,CAAC,IAAI;AAAA,IACrC;AAAA,EACF;AACF;",
+  "names": []
+}