convex 1.34.1 → 1.35.0

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

@@ -19,29 +19,30 @@ import {
   claudeMdPath,
   guidelinesPathForConvexDir
 } from "./paths.js";
-import { readAiConfig } from "./config.js";
-import { readFileSafe } from "./utils.js";
+import { attemptReadAiState } from "./state.js";
+import { isAiFilesDisabled } from "./index.js";
+import { readFileOrNull } from "./utils.js";
 function logGuidelinesStatus({
   guidelinesFile,
   guidelinesRelPath,
-  config,
+  state,
   canonicalGuidelinesHash,
   networkAvailable
 }) {
-  if (guidelinesFile === null) {
+  if (guidelinesFile === null || guidelinesFile === "") {
     logMessage(
       `  ${chalkStderr.yellow("\u26A0")} ${guidelinesRelPath}: not on disk \u2014 run ${chalkStderr.bold("npx convex ai-files install")} to reinstall`
     );
     return;
   }
-  const isLocallyModified = config.guidelinesHash !== null && hashSha256(guidelinesFile) !== config.guidelinesHash;
+  const isLocallyModified = state.guidelinesHash !== null && hashSha256(guidelinesFile) !== state.guidelinesHash;
   if (isLocallyModified) {
     logMessage(
       `  ${chalkStderr.yellow("\u26A0")} ${guidelinesRelPath}: installed, modified locally (changes will be overwritten on next update)`
     );
     return;
   }
-  const isOutOfDate = networkAvailable && canonicalGuidelinesHash !== null && config.guidelinesHash !== null && config.guidelinesHash !== canonicalGuidelinesHash;
+  const isOutOfDate = networkAvailable && canonicalGuidelinesHash !== null && state.guidelinesHash !== null && state.guidelinesHash !== canonicalGuidelinesHash;
   if (isOutOfDate) {
     logMessage(
       `  ${chalkStderr.yellow("\u26A0")} ${guidelinesRelPath}: installed, out of date \u2014 run ${chalkStderr.bold("npx convex ai-files update")}`
@@ -54,7 +55,7 @@ function logGuidelinesStatus({
 }
 function logAgentsMdStatus({
   agentsContent,
-  config,
+  state,
   convexDirName
 }) {
   const hasSection = agentsContent !== null && agentsContent.includes(AGENTS_MD_START_MARKER) && agentsContent.includes(AGENTS_MD_END_MARKER);
@@ -65,7 +66,7 @@ function logAgentsMdStatus({
     return;
   }
   const currentHash = hashSha256(agentsMdConvexSection(convexDirName));
-  if (config.agentsMdSectionHash !== null && config.agentsMdSectionHash !== currentHash) {
+  if (state.agentsMdSectionHash !== null && state.agentsMdSectionHash !== currentHash) {
     logMessage(
       `  ${chalkStderr.yellow("\u26A0")} AGENTS.md: Convex section out of date \u2014 run ${chalkStderr.bold("npx convex ai-files update")}`
     );
@@ -77,7 +78,7 @@ function logAgentsMdStatus({
 }
 function logClaudeMdStatus({
   claudeContent,
-  config,
+  state,
   convexDirName
 }) {
   const hasSection = claudeContent !== null && claudeContent.includes(CLAUDE_MD_START_MARKER) && claudeContent.includes(CLAUDE_MD_END_MARKER);
@@ -94,7 +95,7 @@ function logClaudeMdStatus({
     return;
   }
   const currentHash = hashSha256(claudeMdConvexSection(convexDirName));
-  if (config.claudeMdHash !== null && config.claudeMdHash !== currentHash) {
+  if (state.claudeMdHash !== null && state.claudeMdHash !== currentHash) {
     logMessage(
       `  ${chalkStderr.yellow("\u26A0")} CLAUDE.md: Convex section out of date - run ${chalkStderr.bold("npx convex ai-files update")}`
     );
@@ -105,18 +106,18 @@ function logClaudeMdStatus({
   }
 }
 function logSkillsStatus({
-  config,
+  state,
   canonicalAgentSkillsSha,
   networkAvailable
 }) {
-  if (config.installedSkillNames.length === 0) {
+  if (state.installedSkillNames.length === 0) {
     logMessage(
       `  ${chalkStderr.yellow("\u26A0")} Agent skills: not installed \u2014 run ${chalkStderr.bold("npx convex ai-files install")} to install`
     );
     return;
   }
-  const skillsList = config.installedSkillNames.join(", ");
-  const isStale = networkAvailable && canonicalAgentSkillsSha !== null && config.agentSkillsSha !== null && config.agentSkillsSha !== canonicalAgentSkillsSha;
+  const skillsList = state.installedSkillNames.join(", ");
+  const isStale = networkAvailable && canonicalAgentSkillsSha !== null && state.agentSkillsSha !== null && state.agentSkillsSha !== canonicalAgentSkillsSha;
   if (isStale) {
     logMessage(
       `  ${chalkStderr.yellow("\u26A0")} Agent skills: ${skillsList} \u2014 out of date, run ${chalkStderr.bold("npx convex ai-files update")}`
@@ -129,34 +130,36 @@ function logSkillsStatus({
 }
 export async function statusAiFiles({
   projectDir,
-  convexDir
+  convexDir,
+  aiFilesConfig
 }) {
   const convexDirName = path.relative(projectDir, convexDir);
   const guidelinesRelPath = path.relative(
     projectDir,
     guidelinesPathForConvexDir(convexDir)
   );
-  const config = await readAiConfig({ projectDir, convexDir });
-  if (config === null) {
-    logMessage(`Convex AI files: ${chalkStderr.yellow("not installed")}`);
+  if (isAiFilesDisabled(aiFilesConfig)) {
+    logMessage(`Convex AI files: ${chalkStderr.yellow("disabled")}`);
     logMessage(
-      `  Run ${chalkStderr.bold("npx convex ai-files install")} to get started, or ${chalkStderr.bold("npx convex ai-files disable")} to opt out.`
+      `  Run ${chalkStderr.bold("npx convex ai-files enable")} to re-enable.`
     );
     return;
   }
-  if (!config.enabled) {
-    logMessage(`Convex AI files: ${chalkStderr.yellow("disabled")}`);
+  const stateResult = await attemptReadAiState(convexDir);
+  if (stateResult.kind !== "ok") {
+    logMessage(`Convex AI files: ${chalkStderr.yellow("not installed")}`);
     logMessage(
-      `  Run ${chalkStderr.bold("npx convex ai-files enable")} to re-enable.`
+      `Run ${chalkStderr.bold("npx convex ai-files install")} to get started.`
     );
     return;
   }
+  const { state } = stateResult;
   logMessage(`Convex AI files: ${chalkStderr.green("enabled")}`);
   const [versionData, guidelinesFile, agentsContent, claudeContent] = await Promise.all([
     getVersion(),
-    readFileSafe(guidelinesPathForConvexDir(convexDir)),
-    readFileSafe(agentsMdPath(projectDir)),
-    readFileSafe(claudeMdPath(projectDir))
+    readFileOrNull(guidelinesPathForConvexDir(convexDir)),
+    readFileOrNull(agentsMdPath(projectDir)),
+    readFileOrNull(claudeMdPath(projectDir))
   ]);
   const networkAvailable = versionData.kind === "ok";
   const canonicalGuidelinesHash = networkAvailable ? versionData.data.guidelinesHash : null;
@@ -164,12 +167,12 @@ export async function statusAiFiles({
   logGuidelinesStatus({
     guidelinesFile,
     guidelinesRelPath,
-    config,
+    state,
     canonicalGuidelinesHash,
     networkAvailable
   });
-  logAgentsMdStatus({ agentsContent, config, convexDirName });
-  logClaudeMdStatus({ claudeContent, config, convexDirName });
-  logSkillsStatus({ config, canonicalAgentSkillsSha, networkAvailable });
+  logAgentsMdStatus({ agentsContent, state, convexDirName });
+  logClaudeMdStatus({ claudeContent, state, convexDirName });
+  logSkillsStatus({ state, canonicalAgentSkillsSha, networkAvailable });
 }
 //# sourceMappingURL=status.js.map

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/cli/lib/aiFiles/status.ts"],
-  "sourcesContent": ["import path from \"path\";\nimport { chalkStderr } from \"chalk\";\nimport { logMessage } from \"../../../bundler/log.js\";\nimport {\n  AGENTS_MD_START_MARKER,\n  AGENTS_MD_END_MARKER,\n  agentsMdConvexSection,\n} from \"../../codegen_templates/agentsmd.js\";\nimport {\n  CLAUDE_MD_START_MARKER,\n  CLAUDE_MD_END_MARKER,\n  claudeMdConvexSection,\n} from \"../../codegen_templates/claudemd.js\";\nimport { getVersion } from \"../versionApi.js\";\nimport { hashSha256 } from \"../utils/hash.js\";\nimport {\n  type AiFilesPaths,\n  agentsMdPath,\n  claudeMdPath,\n  guidelinesPathForConvexDir,\n} from \"./paths.js\";\nimport { type AiFilesConfig, readAiConfig } from \"./config.js\";\nimport { readFileSafe } from \"./utils.js\";\n\nfunction logGuidelinesStatus({\n  guidelinesFile,\n  guidelinesRelPath,\n  config,\n  canonicalGuidelinesHash,\n  networkAvailable,\n}: {\n  guidelinesFile: string | null;\n  guidelinesRelPath: string;\n  config: AiFilesConfig;\n  canonicalGuidelinesHash: string | null;\n  networkAvailable: boolean;\n}): void {\n  if (guidelinesFile === null) {\n    logMessage(\n      `  ${chalkStderr.yellow(\"\u26A0\")} ${guidelinesRelPath}: not on disk \u2014 run ${chalkStderr.bold(\"npx convex ai-files install\")} to reinstall`,\n    );\n    return;\n  }\n\n  const isLocallyModified =\n    config.guidelinesHash !== null &&\n    hashSha256(guidelinesFile) !== config.guidelinesHash;\n\n  if (isLocallyModified) {\n    logMessage(\n      `  ${chalkStderr.yellow(\"\u26A0\")} ${guidelinesRelPath}: installed, modified locally (changes will be overwritten on next update)`,\n    );\n    return;\n  }\n\n  const isOutOfDate =\n    networkAvailable &&\n    canonicalGuidelinesHash !== null &&\n    config.guidelinesHash !== null &&\n    config.guidelinesHash !== canonicalGuidelinesHash;\n\n  if (isOutOfDate) {\n    logMessage(\n      `  ${chalkStderr.yellow(\"\u26A0\")} ${guidelinesRelPath}: installed, out of date \u2014 run ${chalkStderr.bold(\"npx convex ai-files update\")}`,\n    );\n    return;\n  }\n\n  logMessage(\n    `  ${chalkStderr.green(\"\u2714\")} ${guidelinesRelPath}: installed${networkAvailable ? \", up to date\" : \"\"}`,\n  );\n}\n\nfunction logAgentsMdStatus({\n  agentsContent,\n  config,\n  convexDirName,\n}: {\n  agentsContent: string | null;\n  config: AiFilesConfig;\n  convexDirName: string;\n}): void {\n  const hasSection =\n    agentsContent !== null &&\n    agentsContent.includes(AGENTS_MD_START_MARKER) &&\n    agentsContent.includes(AGENTS_MD_END_MARKER);\n\n  if (!hasSection) {\n    logMessage(\n      `  ${chalkStderr.yellow(\"\u26A0\")} AGENTS.md: Convex section missing \u2014 run ${chalkStderr.bold(\"npx convex ai-files install\")} to reinstall`,\n    );\n    return;\n  }\n\n  const currentHash = hashSha256(agentsMdConvexSection(convexDirName));\n  if (\n    config.agentsMdSectionHash !== null &&\n    config.agentsMdSectionHash !== currentHash\n  ) {\n    logMessage(\n      `  ${chalkStderr.yellow(\"\u26A0\")} AGENTS.md: Convex section out of date \u2014 run ${chalkStderr.bold(\"npx convex ai-files update\")}`,\n    );\n  } else {\n    logMessage(\n      `  ${chalkStderr.green(\"\u2714\")} AGENTS.md: Convex section present, up to date`,\n    );\n  }\n}\n\nfunction logClaudeMdStatus({\n  claudeContent,\n  config,\n  convexDirName,\n}: {\n  claudeContent: string | null;\n  config: AiFilesConfig;\n  convexDirName: string;\n}): void {\n  const hasSection =\n    claudeContent !== null &&\n    claudeContent.includes(CLAUDE_MD_START_MARKER) &&\n    claudeContent.includes(CLAUDE_MD_END_MARKER);\n\n  if (!hasSection) {\n    if (claudeContent === null) {\n      logMessage(\n        `  ${chalkStderr.yellow(\"\u26A0\")} CLAUDE.md: missing - run ${chalkStderr.bold(\"npx convex ai-files install\")} to create it`,\n      );\n    } else {\n      logMessage(\n        `  ${chalkStderr.yellow(\"\u26A0\")} CLAUDE.md: no Convex section present - run ${chalkStderr.bold(\"npx convex ai-files update\")} to add it`,\n      );\n    }\n    return;\n  }\n\n  const currentHash = hashSha256(claudeMdConvexSection(convexDirName));\n  if (config.claudeMdHash !== null && config.claudeMdHash !== currentHash) {\n    logMessage(\n      `  ${chalkStderr.yellow(\"\u26A0\")} CLAUDE.md: Convex section out of date - run ${chalkStderr.bold(\"npx convex ai-files update\")}`,\n    );\n  } else {\n    logMessage(\n      `  ${chalkStderr.green(\"\u2714\")} CLAUDE.md: Convex section present, up to date`,\n    );\n  }\n}\n\nfunction logSkillsStatus({\n  config,\n  canonicalAgentSkillsSha,\n  networkAvailable,\n}: {\n  config: AiFilesConfig;\n  canonicalAgentSkillsSha: string | null;\n  networkAvailable: boolean;\n}): void {\n  if (config.installedSkillNames.length === 0) {\n    logMessage(\n      `  ${chalkStderr.yellow(\"\u26A0\")} Agent skills: not installed \u2014 run ${chalkStderr.bold(\"npx convex ai-files install\")} to install`,\n    );\n    return;\n  }\n\n  const skillsList = config.installedSkillNames.join(\", \");\n  const isStale =\n    networkAvailable &&\n    canonicalAgentSkillsSha !== null &&\n    config.agentSkillsSha !== null &&\n    config.agentSkillsSha !== canonicalAgentSkillsSha;\n\n  if (isStale) {\n    logMessage(\n      `  ${chalkStderr.yellow(\"\u26A0\")} Agent skills: ${skillsList} \u2014 out of date, run ${chalkStderr.bold(\"npx convex ai-files update\")}`,\n    );\n  } else {\n    logMessage(\n      `  ${chalkStderr.green(\"\u2714\")} Agent skills: ${skillsList}${networkAvailable ? \" (up to date)\" : \"\"}`,\n    );\n  }\n}\n\nexport async function statusAiFiles({\n  projectDir,\n  convexDir,\n}: AiFilesPaths): Promise<void> {\n  const convexDirName = path.relative(projectDir, convexDir);\n  const guidelinesRelPath = path.relative(\n    projectDir,\n    guidelinesPathForConvexDir(convexDir),\n  );\n\n  const config = await readAiConfig({ projectDir, convexDir });\n\n  if (config === null) {\n    logMessage(`Convex AI files: ${chalkStderr.yellow(\"not installed\")}`);\n    logMessage(\n      `  Run ${chalkStderr.bold(\"npx convex ai-files install\")} to get started, ` +\n        `or ${chalkStderr.bold(\"npx convex ai-files disable\")} to opt out.`,\n    );\n    return;\n  }\n\n  if (!config.enabled) {\n    logMessage(`Convex AI files: ${chalkStderr.yellow(\"disabled\")}`);\n    logMessage(\n      `  Run ${chalkStderr.bold(\"npx convex ai-files enable\")} to re-enable.`,\n    );\n    return;\n  }\n\n  logMessage(`Convex AI files: ${chalkStderr.green(\"enabled\")}`);\n\n  const [versionData, guidelinesFile, agentsContent, claudeContent] =\n    await Promise.all([\n      getVersion(),\n      readFileSafe(guidelinesPathForConvexDir(convexDir)),\n      readFileSafe(agentsMdPath(projectDir)),\n      readFileSafe(claudeMdPath(projectDir)),\n    ]);\n\n  const networkAvailable = versionData.kind === \"ok\";\n  const canonicalGuidelinesHash = networkAvailable\n    ? versionData.data.guidelinesHash\n    : null;\n  const canonicalAgentSkillsSha = networkAvailable\n    ? versionData.data.agentSkillsSha\n    : null;\n\n  logGuidelinesStatus({\n    guidelinesFile,\n    guidelinesRelPath,\n    config,\n    canonicalGuidelinesHash,\n    networkAvailable,\n  });\n  logAgentsMdStatus({ agentsContent, config, convexDirName });\n  logClaudeMdStatus({ claudeContent, config, convexDirName });\n  logSkillsStatus({ config, canonicalAgentSkillsSha, networkAvailable });\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import path from \"path\";\nimport { chalkStderr } from \"chalk\";\nimport { logMessage } from \"../../../bundler/log.js\";\nimport {\n  AGENTS_MD_START_MARKER,\n  AGENTS_MD_END_MARKER,\n  agentsMdConvexSection,\n} from \"../../codegen_templates/agentsmd.js\";\nimport {\n  CLAUDE_MD_START_MARKER,\n  CLAUDE_MD_END_MARKER,\n  claudeMdConvexSection,\n} from \"../../codegen_templates/claudemd.js\";\nimport { getVersion } from \"../versionApi.js\";\nimport { hashSha256 } from \"../utils/hash.js\";\nimport {\n  type AiFilesPaths,\n  agentsMdPath,\n  claudeMdPath,\n  guidelinesPathForConvexDir,\n} from \"./paths.js\";\nimport { type AiFilesState, attemptReadAiState } from \"./state.js\";\nimport { type AiFilesProjectConfig } from \"../config.js\";\nimport { isAiFilesDisabled } from \"./index.js\";\nimport { readFileOrNull } from \"./utils.js\";\n\nfunction logGuidelinesStatus({\n  guidelinesFile,\n  guidelinesRelPath,\n  state,\n  canonicalGuidelinesHash,\n  networkAvailable,\n}: {\n  guidelinesFile: string | null;\n  guidelinesRelPath: string;\n  state: AiFilesState;\n  canonicalGuidelinesHash: string | null;\n  networkAvailable: boolean;\n}): void {\n  if (guidelinesFile === null || guidelinesFile === \"\") {\n    logMessage(\n      `  ${chalkStderr.yellow(\"\u26A0\")} ${guidelinesRelPath}: not on disk \u2014 run ${chalkStderr.bold(\"npx convex ai-files install\")} to reinstall`,\n    );\n    return;\n  }\n\n  const isLocallyModified =\n    state.guidelinesHash !== null &&\n    hashSha256(guidelinesFile) !== state.guidelinesHash;\n\n  if (isLocallyModified) {\n    logMessage(\n      `  ${chalkStderr.yellow(\"\u26A0\")} ${guidelinesRelPath}: installed, modified locally (changes will be overwritten on next update)`,\n    );\n    return;\n  }\n\n  const isOutOfDate =\n    networkAvailable &&\n    canonicalGuidelinesHash !== null &&\n    state.guidelinesHash !== null &&\n    state.guidelinesHash !== canonicalGuidelinesHash;\n\n  if (isOutOfDate) {\n    logMessage(\n      `  ${chalkStderr.yellow(\"\u26A0\")} ${guidelinesRelPath}: installed, out of date \u2014 run ${chalkStderr.bold(\"npx convex ai-files update\")}`,\n    );\n    return;\n  }\n\n  logMessage(\n    `  ${chalkStderr.green(\"\u2714\")} ${guidelinesRelPath}: installed${networkAvailable ? \", up to date\" : \"\"}`,\n  );\n}\n\nfunction logAgentsMdStatus({\n  agentsContent,\n  state,\n  convexDirName,\n}: {\n  agentsContent: string | null;\n  state: AiFilesState;\n  convexDirName: string;\n}): void {\n  const hasSection =\n    agentsContent !== null &&\n    agentsContent.includes(AGENTS_MD_START_MARKER) &&\n    agentsContent.includes(AGENTS_MD_END_MARKER);\n\n  if (!hasSection) {\n    logMessage(\n      `  ${chalkStderr.yellow(\"\u26A0\")} AGENTS.md: Convex section missing \u2014 run ${chalkStderr.bold(\"npx convex ai-files install\")} to reinstall`,\n    );\n    return;\n  }\n\n  const currentHash = hashSha256(agentsMdConvexSection(convexDirName));\n  if (\n    state.agentsMdSectionHash !== null &&\n    state.agentsMdSectionHash !== currentHash\n  ) {\n    logMessage(\n      `  ${chalkStderr.yellow(\"\u26A0\")} AGENTS.md: Convex section out of date \u2014 run ${chalkStderr.bold(\"npx convex ai-files update\")}`,\n    );\n  } else {\n    logMessage(\n      `  ${chalkStderr.green(\"\u2714\")} AGENTS.md: Convex section present, up to date`,\n    );\n  }\n}\n\nfunction logClaudeMdStatus({\n  claudeContent,\n  state,\n  convexDirName,\n}: {\n  claudeContent: string | null;\n  state: AiFilesState;\n  convexDirName: string;\n}): void {\n  const hasSection =\n    claudeContent !== null &&\n    claudeContent.includes(CLAUDE_MD_START_MARKER) &&\n    claudeContent.includes(CLAUDE_MD_END_MARKER);\n\n  if (!hasSection) {\n    if (claudeContent === null) {\n      logMessage(\n        `  ${chalkStderr.yellow(\"\u26A0\")} CLAUDE.md: missing - run ${chalkStderr.bold(\"npx convex ai-files install\")} to create it`,\n      );\n    } else {\n      logMessage(\n        `  ${chalkStderr.yellow(\"\u26A0\")} CLAUDE.md: no Convex section present - run ${chalkStderr.bold(\"npx convex ai-files update\")} to add it`,\n      );\n    }\n    return;\n  }\n\n  const currentHash = hashSha256(claudeMdConvexSection(convexDirName));\n  if (state.claudeMdHash !== null && state.claudeMdHash !== currentHash) {\n    logMessage(\n      `  ${chalkStderr.yellow(\"\u26A0\")} CLAUDE.md: Convex section out of date - run ${chalkStderr.bold(\"npx convex ai-files update\")}`,\n    );\n  } else {\n    logMessage(\n      `  ${chalkStderr.green(\"\u2714\")} CLAUDE.md: Convex section present, up to date`,\n    );\n  }\n}\n\nfunction logSkillsStatus({\n  state,\n  canonicalAgentSkillsSha,\n  networkAvailable,\n}: {\n  state: AiFilesState;\n  canonicalAgentSkillsSha: string | null;\n  networkAvailable: boolean;\n}): void {\n  if (state.installedSkillNames.length === 0) {\n    logMessage(\n      `  ${chalkStderr.yellow(\"\u26A0\")} Agent skills: not installed \u2014 run ${chalkStderr.bold(\"npx convex ai-files install\")} to install`,\n    );\n    return;\n  }\n\n  const skillsList = state.installedSkillNames.join(\", \");\n  const isStale =\n    networkAvailable &&\n    canonicalAgentSkillsSha !== null &&\n    state.agentSkillsSha !== null &&\n    state.agentSkillsSha !== canonicalAgentSkillsSha;\n\n  if (isStale) {\n    logMessage(\n      `  ${chalkStderr.yellow(\"\u26A0\")} Agent skills: ${skillsList} \u2014 out of date, run ${chalkStderr.bold(\"npx convex ai-files update\")}`,\n    );\n  } else {\n    logMessage(\n      `  ${chalkStderr.green(\"\u2714\")} Agent skills: ${skillsList}${networkAvailable ? \" (up to date)\" : \"\"}`,\n    );\n  }\n}\n\nexport async function statusAiFiles({\n  projectDir,\n  convexDir,\n  aiFilesConfig,\n}: AiFilesPaths & {\n  aiFilesConfig?: AiFilesProjectConfig | undefined;\n}): Promise<void> {\n  const convexDirName = path.relative(projectDir, convexDir);\n  const guidelinesRelPath = path.relative(\n    projectDir,\n    guidelinesPathForConvexDir(convexDir),\n  );\n\n  if (isAiFilesDisabled(aiFilesConfig)) {\n    logMessage(`Convex AI files: ${chalkStderr.yellow(\"disabled\")}`);\n    logMessage(\n      `  Run ${chalkStderr.bold(\"npx convex ai-files enable\")} to re-enable.`,\n    );\n    return;\n  }\n\n  const stateResult = await attemptReadAiState(convexDir);\n\n  if (stateResult.kind !== \"ok\") {\n    logMessage(`Convex AI files: ${chalkStderr.yellow(\"not installed\")}`);\n    logMessage(\n      `Run ${chalkStderr.bold(\"npx convex ai-files install\")} to get started.`,\n    );\n    return;\n  }\n\n  const { state } = stateResult;\n\n  logMessage(`Convex AI files: ${chalkStderr.green(\"enabled\")}`);\n\n  const [versionData, guidelinesFile, agentsContent, claudeContent] =\n    await Promise.all([\n      getVersion(),\n      readFileOrNull(guidelinesPathForConvexDir(convexDir)),\n      readFileOrNull(agentsMdPath(projectDir)),\n      readFileOrNull(claudeMdPath(projectDir)),\n    ]);\n\n  const networkAvailable = versionData.kind === \"ok\";\n  const canonicalGuidelinesHash = networkAvailable\n    ? versionData.data.guidelinesHash\n    : null;\n  const canonicalAgentSkillsSha = networkAvailable\n    ? versionData.data.agentSkillsSha\n    : null;\n\n  logGuidelinesStatus({\n    guidelinesFile,\n    guidelinesRelPath,\n    state,\n    canonicalGuidelinesHash,\n    networkAvailable,\n  });\n  logAgentsMdStatus({ agentsContent, state, convexDirName });\n  logClaudeMdStatus({ claudeContent, state, convexDirName });\n  logSkillsStatus({ state, canonicalAgentSkillsSha, networkAvailable });\n}\n"],
+  "mappings": "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",
   "names": []
 }

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

@@ -6,13 +6,24 @@ import { hashSha256 } from "../utils/hash.js";
 export function isInInteractiveTerminal() {
   return process.stdin.isTTY === true;
 }
-export async function readFileSafe(filePath) {
+export async function attemptReadFile(filePath) {
   try {
-    return await fs.readFile(filePath, "utf8");
-  } catch {
-    return null;
+    const content = await fs.readFile(filePath, "utf8");
+    if (content.length === 0) return { kind: "empty" };
+    return { kind: "content", content };
+  } catch (error) {
+    if (error.code === "ENOENT")
+      return { kind: "not-found" };
+    throw error;
   }
 }
+export async function readFileOrNull(filePath) {
+  const result = await attemptReadFile(filePath);
+  if (result.kind === "content") return result.content;
+  if (result.kind === "empty") return "";
+  if (result.kind === "not-found") return null;
+  return exhaustiveCheck(result);
+}
 export async function safelyDeleteFile(filePath) {
   try {
     await fs.unlink(filePath);
@@ -24,7 +35,7 @@ export async function safelyDeleteFile(filePath) {
 export const iife = (fn) => fn();
 export async function injectManagedSection(opts) {
   const { filePath, startMarker, endMarker, section } = opts;
-  const existing = await readFileSafe(filePath) ?? "";
+  const existing = await readFileOrNull(filePath) ?? "";
   const startIdx = existing.indexOf(startMarker);
   const endIdx = existing.indexOf(endMarker);
   const updated = iife(() => {
@@ -38,9 +49,9 @@ export async function injectManagedSection(opts) {
   if (didWrite) await fs.writeFile(filePath, updated, "utf8");
   return { sectionHash: hashSha256(section), didWrite };
 }
-export async function stripManagedSection(opts) {
+export async function attemptToStripManagedSection(opts) {
   const { filePath, startMarker, endMarker } = opts;
-  const content = await readFileSafe(filePath);
+  const content = await readFileOrNull(filePath);
   if (content === null) return "none";
   const startIdx = content.indexOf(startMarker);
   const endIdx = content.indexOf(endMarker);
@@ -57,7 +68,10 @@ export async function stripManagedSection(opts) {
   await fs.writeFile(filePath, updated + "\n", "utf8");
   return "section";
 }
-export async function removeMarkdownSection({
+export function exhaustiveCheck(_param) {
+  throw new Error("Internal error: exhaustive check failed.");
+}
+export async function attemptToRemoveMarkdownSection({
   projectDir,
   strip,
   fileName
@@ -73,10 +87,11 @@ export async function removeMarkdownSection({
     logMessage(`${chalkStderr.green("\u2714")} Deleted ${fileName}.`);
     return true;
   }
-  return false;
+  if (result === "none") return false;
+  return exhaustiveCheck(result);
 }
 export async function hasManagedSection(opts) {
-  const content = await readFileSafe(opts.filePath);
+  const content = await readFileOrNull(opts.filePath);
   return content !== null && content.includes(opts.startMarker) && content.includes(opts.endMarker);
 }
 //# sourceMappingURL=utils.js.map

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/cli/lib/aiFiles/utils.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 { hashSha256 } from \"../utils/hash.js\";\n\nexport function isInInteractiveTerminal(): boolean {\n  return process.stdin.isTTY === true;\n}\n\nexport async function readFileSafe(filePath: string): Promise<string | null> {\n  try {\n    return await fs.readFile(filePath, \"utf8\");\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Attempt to delete a file. Returns `true` if the file was deleted,\n * `false` if it didn't exist or the deletion failed.\n */\nexport async function safelyDeleteFile(filePath: string): Promise<boolean> {\n  try {\n    await fs.unlink(filePath);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Generic managed-section helpers\n//\n// Several files (AGENTS.md, CLAUDE.md) contain a Convex-managed section\n// delimited by start/end markers. These helpers provide the common logic\n// for injecting, stripping, and detecting those sections.\n// ---------------------------------------------------------------------------\n\nexport type ManagedSectionTarget = {\n  filePath: string;\n  startMarker: string;\n  endMarker: string;\n};\n\nexport type InjectResult = {\n  sectionHash: string;\n  didWrite: boolean;\n};\n\nexport const iife = <T>(fn: () => T): T => fn();\n\n/**\n * Inject a managed section into a file. If the file already contains the\n * markers, the section between them is replaced. Otherwise the section is\n * appended (or the file is created). Only writes when content actually\n * changes.\n */\nexport async function injectManagedSection(\n  opts: ManagedSectionTarget & { section: string },\n): Promise<InjectResult> {\n  const { filePath, startMarker, endMarker, section } = opts;\n\n  const existing = (await readFileSafe(filePath)) ?? \"\";\n\n  const startIdx = existing.indexOf(startMarker);\n  const endIdx = existing.indexOf(endMarker);\n\n  const updated = iife(() => {\n    if (startIdx !== -1 && endIdx !== -1)\n      return (\n        existing.slice(0, startIdx) +\n        section +\n        existing.slice(endIdx + endMarker.length)\n      );\n    if (existing.length > 0)\n      return existing.trimEnd() + \"\\n\\n\" + section + \"\\n\";\n\n    return section + \"\\n\";\n  });\n\n  const didWrite = updated !== existing;\n  if (didWrite) await fs.writeFile(filePath, updated, \"utf8\");\n\n  return { sectionHash: hashSha256(section), didWrite };\n}\n\nexport type StripResult = \"none\" | \"section\" | \"file\";\n\n/**\n * Remove the managed section (between start/end markers) from a file.\n * If the file is empty after removal, it is deleted.\n *\n * Returns `\"none\"` if the file doesn't exist or has no markers,\n * `\"section\"` if the section was stripped, or `\"file\"` if the entire\n * file was deleted.\n */\nexport async function stripManagedSection(\n  opts: ManagedSectionTarget,\n): Promise<StripResult> {\n  const { filePath, startMarker, endMarker } = opts;\n\n  const content = await readFileSafe(filePath);\n  if (content === null) return \"none\";\n\n  const startIdx = content.indexOf(startMarker);\n  const endIdx = content.indexOf(endMarker);\n  if (startIdx === -1 || endIdx === -1) {\n    return \"none\";\n  }\n\n  const before = content.slice(0, startIdx).trimEnd();\n  const after = content.slice(endIdx + endMarker.length).trimStart();\n  const updated = [before, after].filter(Boolean).join(\"\\n\\n\");\n\n  if (!updated.trim()) {\n    await safelyDeleteFile(filePath);\n    return \"file\";\n  }\n\n  await fs.writeFile(filePath, updated + \"\\n\", \"utf8\");\n  return \"section\";\n}\n\nexport async function removeMarkdownSection({\n  projectDir,\n  strip,\n  fileName,\n}: {\n  projectDir: string;\n  strip: (dir: string) => Promise<StripResult>;\n  fileName: string;\n}): Promise<boolean> {\n  const result = await strip(projectDir);\n\n  if (result === \"section\") {\n    logMessage(\n      `${chalkStderr.green(\"\u2714\")} Removed Convex section from ${fileName}.`,\n    );\n    return true;\n  }\n\n  if (result === \"file\") {\n    logMessage(`${chalkStderr.green(\"\u2714\")} Deleted ${fileName}.`);\n    return true;\n  }\n\n  return false;\n}\n\n/**\n * Check whether a file contains a managed section (both markers present).\n */\nexport async function hasManagedSection(\n  opts: ManagedSectionTarget,\n): Promise<boolean> {\n  const content = await readFileSafe(opts.filePath);\n  return (\n    content !== null &&\n    content.includes(opts.startMarker) &&\n    content.includes(opts.endMarker)\n  );\n}\n"],
-  "mappings": ";AACA,SAAS,YAAY,UAAU;AAC/B,SAAS,mBAAmB;AAC5B,SAAS,kBAAkB;AAC3B,SAAS,kBAAkB;AAEpB,gBAAS,0BAAmC;AACjD,SAAO,QAAQ,MAAM,UAAU;AACjC;AAEA,sBAAsB,aAAa,UAA0C;AAC3E,MAAI;AACF,WAAO,MAAM,GAAG,SAAS,UAAU,MAAM;AAAA,EAC3C,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAMA,sBAAsB,iBAAiB,UAAoC;AACzE,MAAI;AACF,UAAM,GAAG,OAAO,QAAQ;AACxB,WAAO;AAAA,EACT,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAqBO,aAAM,OAAO,CAAI,OAAmB,GAAG;AAQ9C,sBAAsB,qBACpB,MACuB;AACvB,QAAM,EAAE,UAAU,aAAa,WAAW,QAAQ,IAAI;AAEtD,QAAM,WAAY,MAAM,aAAa,QAAQ,KAAM;AAEnD,QAAM,WAAW,SAAS,QAAQ,WAAW;AAC7C,QAAM,SAAS,SAAS,QAAQ,SAAS;AAEzC,QAAM,UAAU,KAAK,MAAM;AACzB,QAAI,aAAa,MAAM,WAAW;AAChC,aACE,SAAS,MAAM,GAAG,QAAQ,IAC1B,UACA,SAAS,MAAM,SAAS,UAAU,MAAM;AAE5C,QAAI,SAAS,SAAS;AACpB,aAAO,SAAS,QAAQ,IAAI,SAAS,UAAU;AAEjD,WAAO,UAAU;AAAA,EACnB,CAAC;AAED,QAAM,WAAW,YAAY;AAC7B,MAAI,SAAU,OAAM,GAAG,UAAU,UAAU,SAAS,MAAM;AAE1D,SAAO,EAAE,aAAa,WAAW,OAAO,GAAG,SAAS;AACtD;AAYA,sBAAsB,oBACpB,MACsB;AACtB,QAAM,EAAE,UAAU,aAAa,UAAU,IAAI;AAE7C,QAAM,UAAU,MAAM,aAAa,QAAQ;AAC3C,MAAI,YAAY,KAAM,QAAO;AAE7B,QAAM,WAAW,QAAQ,QAAQ,WAAW;AAC5C,QAAM,SAAS,QAAQ,QAAQ,SAAS;AACxC,MAAI,aAAa,MAAM,WAAW,IAAI;AACpC,WAAO;AAAA,EACT;AAEA,QAAM,SAAS,QAAQ,MAAM,GAAG,QAAQ,EAAE,QAAQ;AAClD,QAAM,QAAQ,QAAQ,MAAM,SAAS,UAAU,MAAM,EAAE,UAAU;AACjE,QAAM,UAAU,CAAC,QAAQ,KAAK,EAAE,OAAO,OAAO,EAAE,KAAK,MAAM;AAE3D,MAAI,CAAC,QAAQ,KAAK,GAAG;AACnB,UAAM,iBAAiB,QAAQ;AAC/B,WAAO;AAAA,EACT;AAEA,QAAM,GAAG,UAAU,UAAU,UAAU,MAAM,MAAM;AACnD,SAAO;AACT;AAEA,sBAAsB,sBAAsB;AAAA,EAC1C;AAAA,EACA;AAAA,EACA;AACF,GAIqB;AACnB,QAAM,SAAS,MAAM,MAAM,UAAU;AAErC,MAAI,WAAW,WAAW;AACxB;AAAA,MACE,GAAG,YAAY,MAAM,QAAG,CAAC,gCAAgC,QAAQ;AAAA,IACnE;AACA,WAAO;AAAA,EACT;AAEA,MAAI,WAAW,QAAQ;AACrB,eAAW,GAAG,YAAY,MAAM,QAAG,CAAC,YAAY,QAAQ,GAAG;AAC3D,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAKA,sBAAsB,kBACpB,MACkB;AAClB,QAAM,UAAU,MAAM,aAAa,KAAK,QAAQ;AAChD,SACE,YAAY,QACZ,QAAQ,SAAS,KAAK,WAAW,KACjC,QAAQ,SAAS,KAAK,SAAS;AAEnC;",
+  "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 { hashSha256 } from \"../utils/hash.js\";\n\nexport function isInInteractiveTerminal(): boolean {\n  return process.stdin.isTTY === true;\n}\n\nexport type ReadFileResult =\n  | { kind: \"not-found\" }\n  | { kind: \"empty\" }\n  | { kind: \"content\"; content: string };\n\nexport async function attemptReadFile(\n  filePath: string,\n): Promise<ReadFileResult> {\n  try {\n    const content = await fs.readFile(filePath, \"utf8\");\n    if (content.length === 0) return { kind: \"empty\" };\n    return { kind: \"content\", content };\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === \"ENOENT\")\n      return { kind: \"not-found\" };\n\n    // eslint-disable-next-line no-restricted-syntax\n    throw error;\n  }\n}\n\nexport async function readFileOrNull(filePath: string): Promise<string | null> {\n  const result = await attemptReadFile(filePath);\n  if (result.kind === \"content\") return result.content;\n  if (result.kind === \"empty\") return \"\";\n  if (result.kind === \"not-found\") return null;\n  return exhaustiveCheck(result);\n}\n\n/**\n * Attempt to delete a file. Returns `true` if the file was deleted,\n * `false` if it didn't exist or the deletion failed.\n */\nexport async function safelyDeleteFile(filePath: string): Promise<boolean> {\n  try {\n    await fs.unlink(filePath);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Generic managed-section helpers\n//\n// Several files (AGENTS.md, CLAUDE.md) contain a Convex-managed section\n// delimited by start/end markers. These helpers provide the common logic\n// for injecting, stripping, and detecting those sections.\n// ---------------------------------------------------------------------------\n\nexport type ManagedSectionTarget = {\n  filePath: string;\n  startMarker: string;\n  endMarker: string;\n};\n\nexport type InjectResult = {\n  sectionHash: string;\n  didWrite: boolean;\n};\n\nexport const iife = <T>(fn: () => T): T => fn();\n\n/**\n * Inject a managed section into a file. If the file already contains the\n * markers, the section between them is replaced. Otherwise the section is\n * appended (or the file is created). Only writes when content actually\n * changes.\n */\nexport async function injectManagedSection(\n  opts: ManagedSectionTarget & { section: string },\n): Promise<InjectResult> {\n  const { filePath, startMarker, endMarker, section } = opts;\n\n  const existing = (await readFileOrNull(filePath)) ?? \"\";\n\n  const startIdx = existing.indexOf(startMarker);\n  const endIdx = existing.indexOf(endMarker);\n\n  const updated = iife(() => {\n    if (startIdx !== -1 && endIdx !== -1)\n      return (\n        existing.slice(0, startIdx) +\n        section +\n        existing.slice(endIdx + endMarker.length)\n      );\n    if (existing.length > 0)\n      return existing.trimEnd() + \"\\n\\n\" + section + \"\\n\";\n\n    return section + \"\\n\";\n  });\n\n  const didWrite = updated !== existing;\n  if (didWrite) await fs.writeFile(filePath, updated, \"utf8\");\n\n  return { sectionHash: hashSha256(section), didWrite };\n}\n\nexport type StripResult = \"none\" | \"section\" | \"file\";\n\n/**\n * Remove the managed section (between start/end markers) from a file.\n * If the file is empty after removal, it is deleted.\n *\n * Returns `\"none\"` if the file doesn't exist or has no markers,\n * `\"section\"` if the section was stripped, or `\"file\"` if the entire\n * file was deleted.\n */\nexport async function attemptToStripManagedSection(\n  opts: ManagedSectionTarget,\n): Promise<StripResult> {\n  const { filePath, startMarker, endMarker } = opts;\n\n  const content = await readFileOrNull(filePath);\n  if (content === null) return \"none\";\n\n  const startIdx = content.indexOf(startMarker);\n  const endIdx = content.indexOf(endMarker);\n  if (startIdx === -1 || endIdx === -1) {\n    return \"none\";\n  }\n\n  const before = content.slice(0, startIdx).trimEnd();\n  const after = content.slice(endIdx + endMarker.length).trimStart();\n  const updated = [before, after].filter(Boolean).join(\"\\n\\n\");\n\n  if (!updated.trim()) {\n    await safelyDeleteFile(filePath);\n    return \"file\";\n  }\n\n  await fs.writeFile(filePath, updated + \"\\n\", \"utf8\");\n  return \"section\";\n}\n\nexport function exhaustiveCheck(_param: never): never {\n  // eslint-disable-next-line no-restricted-syntax\n  throw new Error(\"Internal error: exhaustive check failed.\");\n}\n\nexport async function attemptToRemoveMarkdownSection({\n  projectDir,\n  strip,\n  fileName,\n}: {\n  projectDir: string;\n  strip: (dir: string) => Promise<StripResult>;\n  fileName: string;\n}): Promise<boolean> {\n  const result = await strip(projectDir);\n\n  if (result === \"section\") {\n    logMessage(\n      `${chalkStderr.green(\"\u2714\")} Removed Convex section from ${fileName}.`,\n    );\n    return true;\n  }\n\n  if (result === \"file\") {\n    logMessage(`${chalkStderr.green(\"\u2714\")} Deleted ${fileName}.`);\n    return true;\n  }\n\n  if (result === \"none\") return false;\n\n  return exhaustiveCheck(result);\n}\n\n/**\n * Check whether a file contains a managed section (both markers present).\n */\nexport async function hasManagedSection(\n  opts: ManagedSectionTarget,\n): Promise<boolean> {\n  const content = await readFileOrNull(opts.filePath);\n  return (\n    content !== null &&\n    content.includes(opts.startMarker) &&\n    content.includes(opts.endMarker)\n  );\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/esm/cli/lib/api.js

@@ -18,6 +18,7 @@ import { loadAnonymousDeployment } from "./localDeployment/anonymous.js";
 import {
   parseDeploymentSelector
 } from "./deploymentSelector.js";
+import { loadProjectLocalConfig } from "./localDeployment/filePaths.js";
 import { chalkStderr } from "chalk";
 export async function createProject(ctx, {
   teamSlug: selectedTeamSlug,
@@ -58,7 +59,7 @@ export const deploymentSelectionWithinProjectSchema = z.discriminatedUnion(
     z.object({ kind: z.literal("deploymentName"), deploymentName: z.string() }),
     z.object({ kind: z.literal("prod") }),
     z.object({ kind: z.literal("implicitProd") }),
-    z.object({ kind: z.literal("ownDev") }),
+    z.object({ kind: z.literal("unspecified") }),
     z.object({
       kind: z.literal("deploymentSelector"),
       selector: z.string()
@@ -81,10 +82,10 @@ export function deploymentSelectionWithinProjectFromOptions(options) {
   if (options.implicitProd) {
     return { kind: "implicitProd" };
   }
-  return { kind: "ownDev" };
+  return { kind: "unspecified" };
 }
 export async function validateDeploymentSelectionForExistingDeployment(ctx, deploymentSelection, source) {
-  if (deploymentSelection.kind === "ownDev" || deploymentSelection.kind === "implicitProd") {
+  if (deploymentSelection.kind === "unspecified" || deploymentSelection.kind === "implicitProd") {
     return;
   }
   if (deploymentSelection.kind === "deploymentSelector") {
@@ -386,7 +387,7 @@ async function handleDeploymentName(ctx, deploymentName, projectSelection) {
 }
 async function fetchDeploymentCredentialsWithinCurrentProject(ctx, projectSelection, deploymentSelection) {
   switch (deploymentSelection.kind) {
-    case "ownDev": {
+    case "unspecified": {
       return await handleOwnDev(ctx, projectSelection);
     }
     case "implicitProd":
@@ -440,7 +441,7 @@ async function resolveDeploymentNameByReference(ctx, teamSlug, projectSlug, refe
       return await ctx.crash({
         exitCode: 1,
         errorType: "fatal",
-        printedMessage: `Deployment \u201C${reference}\u201D not found. To create a new deployment, use ${chalkStderr.bold(`npx convex deployment create ${reference} --team ${teamSlug} --project ${projectSlug} --select`)}`,
+        printedMessage: `Deployment \u201C${reference}\u201D not found. To create a new deployment, use ${chalkStderr.bold(`npx convex deployment create ${teamSlug}:${projectSlug}:${reference} --select`)}`,
         errForSentry: err
       });
     }
@@ -449,8 +450,26 @@ async function resolveDeploymentNameByReference(ctx, teamSlug, projectSlug, refe
 }
 async function handleRefInProject(ctx, selector, projectSelection) {
   switch (selector.kind) {
-    case "dev":
-      return await handleOwnDev(ctx, projectSelection);
+    case "dev": {
+      const access = await checkAccessToSelectedProject(ctx, projectSelection);
+      if (access.kind !== "hasAccess") {
+        return await ctx.crash({
+          exitCode: 1,
+          errorType: "fatal",
+          printedMessage: "You don't have access to the selected project. Run `npx convex dev` to select a different project."
+        });
+      }
+      const deploymentName = await resolveDefaultCloudDevDeploymentName(
+        ctx,
+        access.teamSlug,
+        access.projectSlug
+      );
+      return await handleDeploymentName(ctx, deploymentName, {
+        kind: "teamAndProjectSlugs",
+        teamSlug: access.teamSlug,
+        projectSlug: access.projectSlug
+      });
+    }
     case "prod":
       return await handleProd(ctx, projectSelection);
     case "reference": {
@@ -481,6 +500,26 @@ async function handleDeploymentSelector(ctx, selector, projectSelection) {
         parsed.deploymentName,
         projectSelection
       );
+    case "local": {
+      const localConfig = loadProjectLocalConfig(ctx);
+      if (localConfig === null) {
+        return ctx.crash({
+          exitCode: 1,
+          errorType: "fatal",
+          printedMessage: `No local deployment found. Run ${chalkStderr.bold("npx convex deployment create local")} to create one.`
+        });
+      }
+      const credentials = await loadLocalDeploymentCredentials(
+        ctx,
+        localConfig.deploymentName
+      );
+      return {
+        deploymentName: localConfig.deploymentName,
+        adminKey: credentials.adminKey,
+        url: credentials.deploymentUrl,
+        deploymentType: "local"
+      };
+    }
     case "inCurrentProject":
       return await handleRefInProject(ctx, parsed.selector, projectSelection);
     case "inProject": {
@@ -670,4 +709,28 @@ export async function getTeamsForUser(ctx) {
   );
   return teams;
 }
+async function resolveDefaultCloudDevDeploymentName(ctx, teamSlug, projectSlug) {
+  try {
+    const result = await typedPlatformClient(ctx, { throw: true }).GET(
+      "/teams/{team_id_or_slug}/projects/{project_slug}/deployment",
+      {
+        params: {
+          path: { team_id_or_slug: teamSlug, project_slug: projectSlug },
+          query: { defaultDev: true }
+        }
+      }
+    );
+    return result.data.name;
+  } catch (err) {
+    if (err instanceof ThrowingFetchError && err.serverErrorData?.code === "DeploymentNotFound") {
+      return await ctx.crash({
+        exitCode: 1,
+        errorType: "fatal",
+        printedMessage: `You don\u2019t have a personal cloud dev deployment in this project. Run ${chalkStderr.bold("npx convex deployment create --type dev --default")} to create one.`,
+        errForSentry: err
+      });
+    }
+    return await logAndHandleFetchError(ctx, err);
+  }
+}
 //# sourceMappingURL=api.js.map