convex 1.34.0 → 1.35.0

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

@@ -0,0 +1,178 @@
+"use strict";
+import path from "path";
+import { chalkStderr } from "chalk";
+import { logMessage } from "../../../bundler/log.js";
+import {
+  AGENTS_MD_START_MARKER,
+  AGENTS_MD_END_MARKER,
+  agentsMdConvexSection
+} from "../../codegen_templates/agentsmd.js";
+import {
+  CLAUDE_MD_START_MARKER,
+  CLAUDE_MD_END_MARKER,
+  claudeMdConvexSection
+} from "../../codegen_templates/claudemd.js";
+import { getVersion } from "../versionApi.js";
+import { hashSha256 } from "../utils/hash.js";
+import {
+  agentsMdPath,
+  claudeMdPath,
+  guidelinesPathForConvexDir
+} from "./paths.js";
+import { attemptReadAiState } from "./state.js";
+import { isAiFilesDisabled } from "./index.js";
+import { readFileOrNull } from "./utils.js";
+function logGuidelinesStatus({
+  guidelinesFile,
+  guidelinesRelPath,
+  state,
+  canonicalGuidelinesHash,
+  networkAvailable
+}) {
+  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 = 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 && 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")}`
+    );
+    return;
+  }
+  logMessage(
+    `  ${chalkStderr.green("\u2714")} ${guidelinesRelPath}: installed${networkAvailable ? ", up to date" : ""}`
+  );
+}
+function logAgentsMdStatus({
+  agentsContent,
+  state,
+  convexDirName
+}) {
+  const hasSection = agentsContent !== null && agentsContent.includes(AGENTS_MD_START_MARKER) && agentsContent.includes(AGENTS_MD_END_MARKER);
+  if (!hasSection) {
+    logMessage(
+      `  ${chalkStderr.yellow("\u26A0")} AGENTS.md: Convex section missing \u2014 run ${chalkStderr.bold("npx convex ai-files install")} to reinstall`
+    );
+    return;
+  }
+  const currentHash = hashSha256(agentsMdConvexSection(convexDirName));
+  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")}`
+    );
+  } else {
+    logMessage(
+      `  ${chalkStderr.green("\u2714")} AGENTS.md: Convex section present, up to date`
+    );
+  }
+}
+function logClaudeMdStatus({
+  claudeContent,
+  state,
+  convexDirName
+}) {
+  const hasSection = claudeContent !== null && claudeContent.includes(CLAUDE_MD_START_MARKER) && claudeContent.includes(CLAUDE_MD_END_MARKER);
+  if (!hasSection) {
+    if (claudeContent === null) {
+      logMessage(
+        `  ${chalkStderr.yellow("\u26A0")} CLAUDE.md: missing - run ${chalkStderr.bold("npx convex ai-files install")} to create it`
+      );
+    } else {
+      logMessage(
+        `  ${chalkStderr.yellow("\u26A0")} CLAUDE.md: no Convex section present - run ${chalkStderr.bold("npx convex ai-files update")} to add it`
+      );
+    }
+    return;
+  }
+  const currentHash = hashSha256(claudeMdConvexSection(convexDirName));
+  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")}`
+    );
+  } else {
+    logMessage(
+      `  ${chalkStderr.green("\u2714")} CLAUDE.md: Convex section present, up to date`
+    );
+  }
+}
+function logSkillsStatus({
+  state,
+  canonicalAgentSkillsSha,
+  networkAvailable
+}) {
+  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 = 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")}`
+    );
+  } else {
+    logMessage(
+      `  ${chalkStderr.green("\u2714")} Agent skills: ${skillsList}${networkAvailable ? " (up to date)" : ""}`
+    );
+  }
+}
+export async function statusAiFiles({
+  projectDir,
+  convexDir,
+  aiFilesConfig
+}) {
+  const convexDirName = path.relative(projectDir, convexDir);
+  const guidelinesRelPath = path.relative(
+    projectDir,
+    guidelinesPathForConvexDir(convexDir)
+  );
+  if (isAiFilesDisabled(aiFilesConfig)) {
+    logMessage(`Convex AI files: ${chalkStderr.yellow("disabled")}`);
+    logMessage(
+      `  Run ${chalkStderr.bold("npx convex ai-files enable")} to re-enable.`
+    );
+    return;
+  }
+  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 install")} to get started.`
+    );
+    return;
+  }
+  const { state } = stateResult;
+  logMessage(`Convex AI files: ${chalkStderr.green("enabled")}`);
+  const [versionData, guidelinesFile, agentsContent, claudeContent] = await Promise.all([
+    getVersion(),
+    readFileOrNull(guidelinesPathForConvexDir(convexDir)),
+    readFileOrNull(agentsMdPath(projectDir)),
+    readFileOrNull(claudeMdPath(projectDir))
+  ]);
+  const networkAvailable = versionData.kind === "ok";
+  const canonicalGuidelinesHash = networkAvailable ? versionData.data.guidelinesHash : null;
+  const canonicalAgentSkillsSha = networkAvailable ? versionData.data.agentSkillsSha : null;
+  logGuidelinesStatus({
+    guidelinesFile,
+    guidelinesRelPath,
+    state,
+    canonicalGuidelinesHash,
+    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

@@ -0,0 +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 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

@@ -0,0 +1,97 @@
+"use strict";
+import { promises as fs } from "fs";
+import { chalkStderr } from "chalk";
+import { logMessage } from "../../../bundler/log.js";
+import { hashSha256 } from "../utils/hash.js";
+export function isInInteractiveTerminal() {
+  return process.stdin.isTTY === true;
+}
+export async function attemptReadFile(filePath) {
+  try {
+    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);
+    return true;
+  } catch {
+    return false;
+  }
+}
+export const iife = (fn) => fn();
+export async function injectManagedSection(opts) {
+  const { filePath, startMarker, endMarker, section } = opts;
+  const existing = await readFileOrNull(filePath) ?? "";
+  const startIdx = existing.indexOf(startMarker);
+  const endIdx = existing.indexOf(endMarker);
+  const updated = iife(() => {
+    if (startIdx !== -1 && endIdx !== -1)
+      return existing.slice(0, startIdx) + section + existing.slice(endIdx + endMarker.length);
+    if (existing.length > 0)
+      return existing.trimEnd() + "\n\n" + section + "\n";
+    return section + "\n";
+  });
+  const didWrite = updated !== existing;
+  if (didWrite) await fs.writeFile(filePath, updated, "utf8");
+  return { sectionHash: hashSha256(section), didWrite };
+}
+export async function attemptToStripManagedSection(opts) {
+  const { filePath, startMarker, endMarker } = opts;
+  const content = await readFileOrNull(filePath);
+  if (content === null) return "none";
+  const startIdx = content.indexOf(startMarker);
+  const endIdx = content.indexOf(endMarker);
+  if (startIdx === -1 || endIdx === -1) {
+    return "none";
+  }
+  const before = content.slice(0, startIdx).trimEnd();
+  const after = content.slice(endIdx + endMarker.length).trimStart();
+  const updated = [before, after].filter(Boolean).join("\n\n");
+  if (!updated.trim()) {
+    await safelyDeleteFile(filePath);
+    return "file";
+  }
+  await fs.writeFile(filePath, updated + "\n", "utf8");
+  return "section";
+}
+export function exhaustiveCheck(_param) {
+  throw new Error("Internal error: exhaustive check failed.");
+}
+export async function attemptToRemoveMarkdownSection({
+  projectDir,
+  strip,
+  fileName
+}) {
+  const result = await strip(projectDir);
+  if (result === "section") {
+    logMessage(
+      `${chalkStderr.green("\u2714")} Removed Convex section from ${fileName}.`
+    );
+    return true;
+  }
+  if (result === "file") {
+    logMessage(`${chalkStderr.green("\u2714")} Deleted ${fileName}.`);
+    return true;
+  }
+  if (result === "none") return false;
+  return exhaustiveCheck(result);
+}
+export async function hasManagedSection(opts) {
+  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

@@ -0,0 +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 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