convex 1.34.1 → 1.35.0

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

@@ -11,21 +11,21 @@ import {
   hasGuidelinesInstalled
 } from "./guidelinesmd.js";
 import {
-  hasAiFilesConfig,
-  readAiConfig,
-  writeAiConfig,
-  writeAiEnabledToProjectConfig
-} from "./config.js";
-import { isInInteractiveTerminal } from "./utils.js";
+  attemptReadAiState,
+  readAiStateOrDefault,
+  writeAiState,
+  hasAiState
+} from "./state.js";
+import { exhaustiveCheck, isInInteractiveTerminal } from "./utils.js";
 import {
   hasAgentsMdInstalled,
   applyAgentsMdSection,
-  removeAgentsMdSection
+  attemptToRemoveAgentsMdSection
 } from "./agentsmd.js";
 import {
   hasClaudeMdInstalled,
   applyClaudeMdSection,
-  removeClaudeMdSection
+  attemptToRemoveClaudeMdSection
 } from "./claudemd.js";
 import { installSkills, removeInstalledSkills } from "./skills.js";
 import { removeLegacyCursorRulesFile as removeLegacyCursorRules } from "./cursorrules.js";
@@ -38,33 +38,16 @@ async function hasExistingAiFilesArtifacts({
 export async function installAiFiles({
   projectDir,
   convexDir,
-  shouldWriteGuidelines = true,
-  shouldWriteAgentsMd = true,
-  shouldWriteClaudeMd = true,
-  shouldWriteSkills = true
+  aiFilesConfig
 }) {
-  await fs.mkdir(aiDirForConvexDir(convexDir), { recursive: true });
-  const config = await readAiConfig({
-    projectDir,
-    convexDir
-  }) ?? {
-    enabled: true,
-    guidelinesHash: null,
-    agentsMdSectionHash: null,
-    claudeMdHash: null,
-    agentSkillsSha: null,
-    installedSkillNames: []
-  };
-  if (shouldWriteGuidelines) await installGuidelinesFile({ convexDir, config });
   const convexDirName = path.relative(projectDir, convexDir);
-  if (shouldWriteAgentsMd)
-    await applyAgentsMdSection({ projectDir, config, convexDirName });
-  if (shouldWriteClaudeMd)
-    await applyClaudeMdSection({ projectDir, config, convexDirName });
-  if (shouldWriteSkills) await installSkills({ projectDir, config });
+  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 writeAiConfig({ config, projectDir, convexDir });
-  logMessage(`${chalkStderr.green("\u2714")} Convex AI files installed.`);
+  await writeAiState({ state, convexDir });
 }
 async function attemptToInstallAiFiles(opts) {
   try {
@@ -73,28 +56,38 @@ async function attemptToInstallAiFiles(opts) {
     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
 }) {
-  const config = await readAiConfig({ projectDir, convexDir });
-  if (config === null) {
+  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 ? "has-artifacts" : "not-installed";
+    return hasArtifacts ? "silent" : "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";
+  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 checkAiFilesStaleness(opts) {
+export async function checkAiFilesStalenessAndLog(opts) {
   const status = await determineAiFilesStaleness(opts);
   if (status === "not-installed") {
     logMessage(
@@ -102,6 +95,7 @@ export async function checkAiFilesStaleness(opts) {
         `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(
@@ -109,61 +103,42 @@ export async function checkAiFilesStaleness(opts) {
         `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
+  convexDir,
+  aiFilesConfig
 }) {
-  await installAiFiles({ projectDir, convexDir });
-  const config = await readAiConfig({ projectDir, convexDir });
-  if (config === null) return;
-  config.enabled = true;
-  await writeAiConfig({
-    config,
-    projectDir,
-    convexDir,
-    options: { persistEnabledPreference: "always" }
-  });
+  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 config = await readAiConfig({ projectDir, convexDir });
-  if (config === null) {
-    logMessage("No Convex AI files found \u2014 nothing to remove.");
-    return;
-  }
+  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 removeAgentsMdSection(projectDir),
-    await removeClaudeMdSection(projectDir),
+    await attemptToRemoveAgentsMdSection(projectDir),
+    await attemptToRemoveClaudeMdSection(projectDir),
     await removeInstalledSkills({
       projectDir,
-      skillNames: config.installedSkillNames
+      skillNames: installedSkillNames
     }),
     await removeLegacyCursorRules(projectDir),
     await attemptToDeleteAiDir({ projectDir, convexDir })
   ];
   if (removals.some(Boolean)) logMessage("Convex AI files removed.");
-}
-export async function safelyAttemptToDisableAiFiles(projectDir) {
-  try {
-    await writeAiEnabledToProjectConfig({
-      projectDir,
-      enabled: false
-    });
-    logMessage(
-      `${chalkStderr.green(`\u2714`)} Convex AI files disabled. Run ${chalkStderr.bold(`npx convex ai-files enable`)} to re-enable.`
-    );
-  } catch (error) {
-    Sentry.captureException(error);
-    logMessage(
-      chalkStderr.yellow(
-        "Could not write AI message suppression config. Message may reappear."
-      )
-    );
-  }
+  else logMessage("No Convex AI files found \u2014 nothing to remove.");
 }
 async function attemptToDeleteAiDir({
   projectDir,
@@ -172,10 +147,11 @@ async function attemptToDeleteAiDir({
   const aiDir = aiDirForConvexDir(convexDir);
   const relPath = path.relative(projectDir, aiDir);
   try {
-    await fs.rm(aiDir, { recursive: true, force: true });
+    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.`)
@@ -185,26 +161,33 @@ async function attemptToDeleteAiDir({
 }
 async function hasAiFilesBeenInstalledBefore({
   projectDir,
-  convexDir
+  convexDir,
+  aiFilesConfig
 }) {
-  return await hasAiFilesConfig({ projectDir, convexDir }) || await hasExistingAiFilesArtifacts({ projectDir, convexDir });
+  if (isAiFilesDisabled(aiFilesConfig)) return false;
+  return await hasAiState(convexDir) || await hasExistingAiFilesArtifacts({ projectDir, convexDir });
 }
-export async function maybeSetupAiFiles({
+export async function attemptSetupAiFiles({
   ctx,
   convexDir,
-  projectDir
+  projectDir,
+  aiFilesConfig
 }) {
   if (!isInInteractiveTerminal()) return;
-  const config = await readAiConfig({ projectDir, convexDir });
-  if (config !== null && !config.enabled) return;
-  if (await hasAiFilesBeenInstalledBefore({ projectDir, convexDir })) {
-    await attemptToInstallAiFiles({ projectDir, convexDir });
+  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 });
+  if (shouldInstall)
+    await attemptToInstallAiFiles({ projectDir, convexDir, aiFilesConfig });
 }
 //# sourceMappingURL=index.js.map

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/cli/lib/aiFiles/index.ts"],
-  "sourcesContent": ["import * as Sentry from \"@sentry/node\";\nimport path from \"path\";\nimport { Context } from \"../../../bundler/context.js\";\n// eslint-disable-next-line no-restricted-imports\nimport { promises as fs } from \"fs\";\nimport { chalkStderr } from \"chalk\";\nimport { logMessage } from \"../../../bundler/log.js\";\nimport { promptYesNo } from \"../utils/prompts.js\";\nimport { 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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",
+  "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/skills.js

@@ -5,7 +5,7 @@ import { promises as fs } from "fs";
 import { chalkStderr } from "chalk";
 import { logMessage } from "../../../bundler/log.js";
 import { getVersion, fetchAgentSkillsSha } from "../versionApi.js";
-import { iife, readFileSafe } from "./utils.js";
+import { exhaustiveCheck, iife, readFileOrNull } from "./utils.js";
 async function readInstalledSkillNames(projectDir) {
   const skillsDir = path.join(projectDir, ".agents", "skills");
   const entries = await iife(async () => {
@@ -20,7 +20,7 @@ async function readInstalledSkillNames(projectDir) {
   const names = [];
   for (const entry of entries) {
     const skillMdPath = path.join(skillsDir, entry, "SKILL.md");
-    const content = await readFileSafe(skillMdPath);
+    const content = await readFileOrNull(skillMdPath);
     if (content === null) continue;
     const match = content.match(/^---[\s\S]*?^name:\s*(.+?)\s*$/m);
     if (match) {
@@ -29,8 +29,16 @@ async function readInstalledSkillNames(projectDir) {
   }
   return names;
 }
-function runSkillsAdd(cwd) {
-  return runSkillsCommand(cwd, ["add", "get-convex/agent-skills", "--yes"]);
+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,
@@ -41,11 +49,14 @@ function runSkillsRemove({
 async function shouldRunSkillsCli() {
   const versionData = await getVersion();
   if (versionData.kind === "error") return true;
-  if (versionData.data.disableSkillsCli) {
-    logMessage(chalkStderr.yellow(`Agent skills are temporarily disabled.`));
-    return false;
+  if (versionData.kind === "ok") {
+    if (versionData.data.disableSkillsCli) {
+      logMessage(chalkStderr.yellow(`Agent skills are temporarily disabled.`));
+      return false;
+    }
+    return true;
   }
-  return true;
+  return exhaustiveCheck(versionData);
 }
 async function removeSkillsLockIfEmpty({
   projectDir,
@@ -72,11 +83,14 @@ async function removeSkillsLockIfEmpty({
 }
 export async function installSkills({
   projectDir,
-  config
+  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);
+  const skillsOk = await runSkillsAdd(projectDir, agents);
   if (!skillsOk) {
     logMessage(
       chalkStderr.yellow(
@@ -86,15 +100,17 @@ export async function installSkills({
     return;
   }
   const sha = await fetchAgentSkillsSha();
-  if (sha) config.agentSkillsSha = sha;
+  if (sha) state.agentSkillsSha = sha;
   const names = await readInstalledSkillNames(projectDir);
-  if (names.length > 0) config.installedSkillNames = names;
+  if (names.length > 0) state.installedSkillNames = names;
+  logMessage(`${chalkStderr.green("\u2714")} Skills installed`);
 }
 export async function removeInstalledSkills({
   projectDir,
   skillNames
 }) {
-  if (skillNames.length === 0 || !await shouldRunSkillsCli()) return false;
+  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) {

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

@@ -1,7 +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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",
+  "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": []
+}