convex 1.34.0 → 1.35.0

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

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../../src/cli/lib/ai/index.ts"],
-  "sourcesContent": ["import * as Sentry from \"@sentry/node\";\nimport child_process from \"child_process\";\nimport path from \"path\";\nimport { Context } from \"../../../bundler/context.js\";\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 { 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_END_MARKER,\n  CLAUDE_MD_START_MARKER,\n  claudeMdConvexSection,\n} from \"../../codegen_templates/claudemd.js\";\nimport {\n  downloadGuidelines,\n  fetchAgentSkillsSha,\n  getVersion,\n} from \"../versionApi.js\";\nimport { promptYesNo } from \"../utils/prompts.js\";\nimport { hashSha256 } from \"../utils/hash.js\";\nimport {\n  aiDirForConvexDir,\n  agentsMdPath,\n  claudeMdPath,\n  guidelinesPathForConvexDir,\n} from \"./paths.js\";\nimport {\n  type AiFilesConfig,\n  readAiConfig,\n  writeAiConfig,\n  writeAiDisabledToProjectConfig,\n} from \"./config.js\";\n\nfunction isAgentMode(): boolean {\n  return process.env.CONVEX_AGENT_MODE !== undefined;\n}\n\n// ---------------------------------------------------------------------------\n// AGENTS.md helpers\n// ---------------------------------------------------------------------------\n\nexport async function injectAgentsMdSection(\n  section: string,\n  projectDir?: string,\n): Promise<string | null> {\n  const filePath = agentsMdPath(projectDir);\n  let existing = \"\";\n  try {\n    existing = await fs.readFile(filePath, \"utf8\");\n  } catch {\n    // File doesn't exist \u2014 we'll create it.\n  }\n\n  let updated: string;\n  const startIdx = existing.indexOf(AGENTS_MD_START_MARKER);\n  const endIdx = existing.indexOf(AGENTS_MD_END_MARKER);\n\n  if (startIdx !== -1 && endIdx !== -1) {\n    // Replace existing Convex section.\n    updated =\n      existing.slice(0, startIdx) +\n      section +\n      existing.slice(endIdx + AGENTS_MD_END_MARKER.length);\n  } else if (existing.length > 0) {\n    // Append to existing file (with a blank line separator).\n    updated = existing.trimEnd() + \"\\n\\n\" + section + \"\\n\";\n  } else {\n    // Create new file.\n    updated = section + \"\\n\";\n  }\n\n  await fs.writeFile(filePath, updated, \"utf8\");\n  return hashSha256(section);\n}\n\ntype InjectClaudeSectionResult = {\n  sectionHash: string;\n  didWrite: boolean;\n};\n\nexport async function injectClaudeMdSection(\n  section: string,\n  projectDir?: string,\n): Promise<InjectClaudeSectionResult> {\n  const filePath = claudeMdPath(projectDir);\n  let existing = \"\";\n  try {\n    existing = await fs.readFile(filePath, \"utf8\");\n  } catch {\n    // File doesn't exist - we'll create it.\n  }\n\n  let updated: string;\n  const startIdx = existing.indexOf(CLAUDE_MD_START_MARKER);\n  const endIdx = existing.indexOf(CLAUDE_MD_END_MARKER);\n\n  if (startIdx !== -1 && endIdx !== -1) {\n    // Replace existing Convex section.\n    updated =\n      existing.slice(0, startIdx) +\n      section +\n      existing.slice(endIdx + CLAUDE_MD_END_MARKER.length);\n  } else if (existing.length > 0) {\n    // Append to existing file (with a blank line separator).\n    updated = existing.trimEnd() + \"\\n\\n\" + section + \"\\n\";\n  } else {\n    // Create new file.\n    updated = section + \"\\n\";\n  }\n\n  const didWrite = updated !== existing;\n  if (didWrite) {\n    await fs.writeFile(filePath, updated, \"utf8\");\n  }\n  return {\n    sectionHash: hashSha256(section),\n    didWrite,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Write/update all Convex AI files (guidelines, AGENTS.md, CLAUDE.md, skills).\n *\n * @param convexDir - absolute path to the project's convex functions directory\n *   (e.g. `/home/user/myapp/convex`). Used to build the `_generated/ai/` subdirectory.\n */\nexport async function writeAiFiles(\n  convexDir: string,\n  installSkills: boolean = false,\n  skillsOutputMode: \"verbose\" | \"quiet\" = \"verbose\",\n  projectDirOverride?: string,\n): Promise<void> {\n  const projectDir = path.resolve(\n    projectDirOverride ?? path.dirname(convexDir),\n  );\n\n  try {\n    // Ensure convex/_generated/ai/ directory exists.\n    await fs.mkdir(aiDirForConvexDir(convexDir), { recursive: true });\n\n    const config: AiFilesConfig = {\n      disableStalenessMessage: false,\n      guidelinesHash: null,\n      agentsMdSectionHash: null,\n      claudeMdHash: null,\n      agentSkillsSha: null,\n      installedSkillNames: [],\n    };\n\n    // Write guidelines.\n    const guidelines = await downloadGuidelines();\n    if (guidelines !== null) {\n      await fs.writeFile(\n        guidelinesPathForConvexDir(convexDir),\n        guidelines,\n        \"utf8\",\n      );\n      config.guidelinesHash = hashSha256(guidelines);\n    } else {\n      logMessage(\n        chalkStderr.yellow(\n          \"Could not download Convex AI guidelines right now. You can retry with: npx convex ai-files install\",\n        ),\n      );\n    }\n\n    // Inject Convex section into AGENTS.md.\n    const convexDirName = path.relative(projectDir, convexDir);\n    const section = agentsMdConvexSection(convexDirName);\n    config.agentsMdSectionHash = await injectAgentsMdSection(\n      section,\n      projectDir,\n    );\n\n    // Inject Convex section into CLAUDE.md.\n    const claudeSection = claudeMdConvexSection(convexDirName);\n    const claudeInjectResult = await injectClaudeMdSection(\n      claudeSection,\n      projectDir,\n    );\n    config.claudeMdHash = claudeInjectResult.sectionHash;\n\n    if (installSkills) {\n      if (await shouldRunSkillsCli()) {\n        logMessage(\"Installing Convex agent skills...\");\n        const skillsOk = await runSkillsAdd(projectDir, skillsOutputMode);\n        if (skillsOk) {\n          // Record the canonical SHA for staleness detection.\n          const sha = await fetchAgentSkillsSha();\n          if (sha) {\n            config.agentSkillsSha = sha;\n          }\n          const names = await readInstalledSkillNames(projectDir);\n          if (names.length > 0) {\n            config.installedSkillNames = names;\n          }\n        } else {\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        }\n      }\n    }\n\n    // Clean up the legacy `.cursor/rules/convex_rules.mdc` file if present.\n    // It was written by the old cursor rules auto-update and is now superseded\n    // by `convex/_generated/ai/guidelines.md`.\n    const removedLegacy = await removeLegacyCursorRulesFile(projectDir);\n    if (removedLegacy) {\n      logMessage(\n        `${chalkStderr.green(`\u2714`)} Removed legacy .cursor/rules/convex_rules.mdc (superseded by convex/_generated/ai/guidelines.md).`,\n      );\n    }\n\n    await writeAiConfig(config, projectDir, convexDir);\n\n    logMessage(\n      `${chalkStderr.green(`\u2714`)} Wrote Convex AI files to ${path.relative(projectDir, aiDirForConvexDir(convexDir))}/`,\n    );\n  } catch (error) {\n    Sentry.captureException(error);\n    // Non-fatal \u2014 don't break the init flow.\n  }\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  canonicalGuidelinesHash: string | null,\n  canonicalAgentSkillsSha: string | null,\n  projectDir: string,\n  convexDir: string,\n): Promise<void> {\n  const config = await readAiConfig(projectDir, convexDir);\n\n  if (config === null) {\n    // No state file means AI files have not been set up yet. Keep nudging until\n    // the user either installs them or explicitly disables the nag with\n    // `npx convex ai-files disable`.\n    logMessage(\n      chalkStderr.yellow(\n        isAgentMode()\n          ? `Convex AI files are not installed. If you are an agent tell the human to run ${chalkStderr.bold(`npx convex ai-files install`)} to get started or ${chalkStderr.bold(`npx convex ai-files disable`)} to hide this message.`\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 (config.disableStalenessMessage) {\n    // User explicitly suppressed staleness/install messages.\n    return;\n  }\n\n  // No version data from server \u2014 skip staleness check (non-fatal).\n  if (canonicalGuidelinesHash === null && canonicalAgentSkillsSha === null) {\n    return;\n  }\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  if (guidelinesStale || skillsStale) {\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\n/**\n * Update all Convex AI files to their latest versions.\n *\n * Files the user has modified (detected via hash comparison) are skipped\n * with a warning rather than silently overwritten.\n *\n * @param projectDir - absolute path to the project root directory.\n * @param convexDir - absolute path to the Convex functions directory.\n */\nexport async function updateAiFiles(\n  projectDir: string,\n  convexDir: string,\n): Promise<void> {\n  const config = await readAiConfig(projectDir, convexDir);\n  if (config === null) {\n    // No config yet \u2014 run the full init and install skills.\n    await writeAiFiles(convexDir, true, \"verbose\", projectDir);\n    return;\n  }\n\n  // Config can exist (for example, disableStalenessMessage in convex.json) even\n  // when convex/_generated/ai/ was removed. Recreate it so reinstall/update\n  // paths do not fail when writing guidelines/state.\n  await fs.mkdir(aiDirForConvexDir(convexDir), { recursive: true });\n\n  let updatedCount = 0;\n  let skippedCount = 0;\n\n  // Update guidelines.\n  const guidelines = await downloadGuidelines();\n  if (guidelines !== null) {\n    const newHash = hashSha256(guidelines);\n    if (newHash === config.guidelinesHash) {\n      logMessage(\"Convex AI guidelines are already up to date.\");\n    } else {\n      const currentContent = await readFileSafe(\n        guidelinesPathForConvexDir(convexDir),\n      );\n      if (\n        currentContent !== null &&\n        config.guidelinesHash !== null &&\n        hashSha256(currentContent) !== config.guidelinesHash\n      ) {\n        logMessage(\n          chalkStderr.yellow(\n            `Skipping ${path.relative(projectDir, guidelinesPathForConvexDir(convexDir))} \u2014 file has been modified locally.`,\n          ),\n        );\n        skippedCount++;\n      } else {\n        await fs.writeFile(\n          guidelinesPathForConvexDir(convexDir),\n          guidelines,\n          \"utf8\",\n        );\n        config.guidelinesHash = newHash;\n        updatedCount++;\n      }\n    }\n  } else {\n    logMessage(\n      chalkStderr.yellow(\n        \"Could not download Convex AI guidelines right now. Keeping your existing guidelines file.\",\n      ),\n    );\n  }\n\n  // Update AGENTS.md section. The dir name is hardcoded to match paths.ts\n  // (the only non-standard case was create-react-app which is dead).\n  const convexDirName = path.relative(projectDir, convexDir);\n  const section = agentsMdConvexSection(convexDirName);\n  const newSectionHash = hashSha256(section);\n\n  if (newSectionHash !== config.agentsMdSectionHash) {\n    config.agentsMdSectionHash = await injectAgentsMdSection(\n      section,\n      projectDir,\n    );\n    updatedCount++;\n  }\n\n  // The skills CLI streams its own output, so we don't count this in\n  // updatedCount.\n  if (await shouldRunSkillsCli()) {\n    logMessage(\"Installing Convex agent skills...\");\n    const skillsOk = await runSkillsAdd(projectDir);\n    if (skillsOk) {\n      // Record the canonical SHA for staleness detection.\n      const sha = await fetchAgentSkillsSha();\n      if (sha) {\n        config.agentSkillsSha = sha;\n      }\n      // Track installed skill names so `convex ai-files remove` can pass them\n      // to `npx skills remove`.\n      const names = await readInstalledSkillNames(projectDir);\n      if (names.length > 0) {\n        config.installedSkillNames = names;\n      }\n    } else {\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    }\n  }\n\n  // Clean up the legacy `.cursor/rules/convex_rules.mdc` file if present.\n  // It was written by the old cursor rules auto-update and is now superseded\n  // by `convex/_generated/ai/guidelines.md`.\n  const removedLegacy = await removeLegacyCursorRulesFile(projectDir);\n  if (removedLegacy) {\n    logMessage(\n      `${chalkStderr.green(`\u2714`)} Removed legacy .cursor/rules/convex_rules.mdc (superseded by convex/_generated/ai/guidelines.md).`,\n    );\n    updatedCount++;\n  }\n\n  // Update/inject the Convex-managed CLAUDE.md section.\n  const claudeSection = claudeMdConvexSection(convexDirName);\n  const claudeInjectResult = await injectClaudeMdSection(\n    claudeSection,\n    projectDir,\n  );\n  config.claudeMdHash = claudeInjectResult.sectionHash;\n  if (claudeInjectResult.didWrite) {\n    updatedCount++;\n  }\n\n  await writeAiConfig(config, projectDir, convexDir);\n\n  if (updatedCount > 0) {\n    logMessage(\n      `${chalkStderr.green(`\u2714`)} Updated ${updatedCount} Convex AI file${updatedCount === 1 ? \"\" : \"s\"}.`,\n    );\n  }\n  if (skippedCount > 0) {\n    logMessage(\n      chalkStderr.yellow(\n        `Skipped ${skippedCount} file${skippedCount === 1 ? \"\" : \"s\"} with local modifications.`,\n      ),\n    );\n  }\n  if (updatedCount === 0 && skippedCount === 0) {\n    logMessage(\"Convex AI files are already up to date.\");\n  }\n}\n\nexport async function enableAiFiles(\n  projectDir: string,\n  convexDir: string,\n): Promise<void> {\n  await updateAiFiles(projectDir, convexDir);\n  const config = await readAiConfig(projectDir, convexDir);\n  if (config === null) {\n    return;\n  }\n  config.disableStalenessMessage = false;\n  await writeAiConfig(config, projectDir, convexDir, {\n    persistDisabledPreference: \"always\",\n  });\n}\n\n/**\n * Remove the Convex-managed section from AGENTS.md (between the start/end\n * markers). If the file becomes empty or only whitespace after removal it is\n * deleted. Returns true if a section was found and removed.\n */\nasync function stripAgentsMdSection(projectDir: string): Promise<boolean> {\n  const filePath = agentsMdPath(projectDir);\n  let content: string;\n  try {\n    content = await fs.readFile(filePath, \"utf8\");\n  } catch {\n    return false;\n  }\n  const startIdx = content.indexOf(AGENTS_MD_START_MARKER);\n  const endIdx = content.indexOf(AGENTS_MD_END_MARKER);\n  if (startIdx === -1 || endIdx === -1) {\n    return false;\n  }\n  const before = content.slice(0, startIdx).trimEnd();\n  const after = content.slice(endIdx + AGENTS_MD_END_MARKER.length).trimStart();\n  const updated = [before, after].filter(Boolean).join(\"\\n\\n\");\n\n  if (!updated.trim()) {\n    try {\n      await fs.unlink(filePath);\n    } catch {\n      // Ignore errors\n    }\n  } else {\n    await fs.writeFile(filePath, updated + \"\\n\", \"utf8\");\n  }\n  return true;\n}\n\n/**\n * Remove the Convex-managed section from CLAUDE.md (between start/end markers).\n * If the file becomes empty after removal, delete it.\n */\nasync function stripClaudeMdSection(\n  projectDir: string,\n): Promise<\"none\" | \"section\" | \"file\"> {\n  const filePath = claudeMdPath(projectDir);\n  let content: string;\n  try {\n    content = await fs.readFile(filePath, \"utf8\");\n  } catch {\n    return \"none\";\n  }\n  const startIdx = content.indexOf(CLAUDE_MD_START_MARKER);\n  const endIdx = content.indexOf(CLAUDE_MD_END_MARKER);\n  if (startIdx === -1 || endIdx === -1) {\n    return \"none\";\n  }\n  const before = content.slice(0, startIdx).trimEnd();\n  const after = content.slice(endIdx + CLAUDE_MD_END_MARKER.length).trimStart();\n  const updated = [before, after].filter(Boolean).join(\"\\n\\n\");\n\n  if (!updated.trim()) {\n    try {\n      await fs.unlink(filePath);\n    } catch {\n      // Ignore errors.\n    }\n    return \"file\";\n  }\n  await fs.writeFile(filePath, updated + \"\\n\", \"utf8\");\n  return \"section\";\n}\n\n/**\n * Remove all Convex AI files from the project.\n * Called by `npx convex ai-files remove`.\n *\n * - Strips the Convex section from AGENTS.md (deletes file if empty)\n * - Strips the Convex section from CLAUDE.md (deletes file if empty)\n * - Runs `npx skills remove <name...> --yes` for each tracked skill\n * - Deletes the `convex/_generated/ai/` directory\n */\nexport async function removeAiFiles(\n  projectDir: string,\n  convexDir: string,\n): Promise<void> {\n  const config = await readAiConfig(projectDir, convexDir);\n\n  if (config === null) {\n    logMessage(\"No Convex AI files found \u2014 nothing to remove.\");\n    return;\n  }\n\n  let removedCount = 0;\n\n  // Strip Convex section from AGENTS.md.\n  const stripped = await stripAgentsMdSection(projectDir);\n  if (stripped) {\n    logMessage(\n      `${chalkStderr.green(`\u2714`)} Removed Convex section from AGENTS.md.`,\n    );\n    removedCount++;\n  }\n\n  // Strip Convex section from CLAUDE.md if present.\n  // If the file is empty after stripping, it's deleted automatically.\n  const strippedClaude = await stripClaudeMdSection(projectDir);\n  if (strippedClaude === \"section\") {\n    logMessage(\n      `${chalkStderr.green(`\u2714`)} Removed Convex section from CLAUDE.md.`,\n    );\n    removedCount++;\n  } else if (strippedClaude === \"file\") {\n    logMessage(`${chalkStderr.green(`\u2714`)} Deleted CLAUDE.md.`);\n    removedCount++;\n  }\n\n  // Remove installed skills via the skills CLI.\n  if (config.installedSkillNames.length > 0) {\n    if (await shouldRunSkillsCli()) {\n      logMessage(\n        `Removing Convex agent skills: ${config.installedSkillNames.join(\", \")}`,\n      );\n      const skillsOk = await runSkillsRemove(\n        projectDir,\n        config.installedSkillNames,\n      );\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      } else {\n        const removedLock = await removeSkillsLockIfEmpty(\n          projectDir,\n          config.installedSkillNames,\n        );\n        if (removedLock) {\n          logMessage(`${chalkStderr.green(`\u2714`)} Deleted skills-lock.json.`);\n          removedCount++;\n        }\n      }\n    }\n  }\n\n  // Clean up the legacy `.cursor/rules/convex_rules.mdc` file if present.\n  const removedLegacy = await removeLegacyCursorRulesFile(projectDir);\n  if (removedLegacy) {\n    logMessage(\n      `${chalkStderr.green(`\u2714`)} Removed legacy .cursor/rules/convex_rules.mdc.`,\n    );\n    removedCount++;\n  }\n\n  // Delete the convex/_generated/ai/ directory.\n  try {\n    await fs.rm(aiDirForConvexDir(convexDir), { recursive: true, force: true });\n    logMessage(\n      `${chalkStderr.green(`\u2714`)} Deleted ${path.relative(projectDir, aiDirForConvexDir(convexDir))}/`,\n    );\n    removedCount++;\n  } catch (error) {\n    Sentry.captureException(error);\n    logMessage(\n      chalkStderr.yellow(\n        `Could not delete ${path.relative(projectDir, aiDirForConvexDir(convexDir))}/. Remove it manually.`,\n      ),\n    );\n  }\n\n  if (removedCount > 0) {\n    logMessage(\"Convex AI files removed.\");\n  }\n}\n\n/**\n * Called by `npx convex ai-files disable`.\n *\n * Writes a suppression flag into `convex.json` (`aiFiles.disableStalenessMessage`) so\n * `npx convex dev` stops showing AI files install/staleness messages.\n * Files are left in place - use `remove` to delete them.\n * The user can re-enable at any time with `npx convex ai-files enable`.\n */\nexport async function disableAiFiles(projectDir: string): Promise<void> {\n  try {\n    await writeAiDisabledToProjectConfig(true, projectDir);\n    logMessage(\n      `${chalkStderr.green(`\u2714`)} Convex AI file staleness/install messages 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\n/**\n * Print the current status of Convex AI files to the terminal.\n */\nexport async function statusAiFiles(\n  projectDir: string,\n  convexDir: string,\n): 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 silence this message.`,\n    );\n    return;\n  }\n\n  if (config.disableStalenessMessage) {\n    logMessage(\n      `Convex AI files: ${chalkStderr.yellow(\"staleness/install messages disabled\")}`,\n    );\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  // Fetch canonical version data in parallel with the file reads below\n  // (best-effort \u2014 network may be unavailable in CI or offline envs).\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 canonicalGuidelinesHash = versionData?.guidelinesHash ?? null;\n  const canonicalAgentSkillsSha = versionData?.agentSkillsSha ?? null;\n  const networkAvailable = versionData !== null;\n\n  // --- convex/_generated/ai/guidelines.md ---\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  } else if (\n    config.guidelinesHash !== null &&\n    hashSha256(guidelinesFile) !== config.guidelinesHash\n  ) {\n    logMessage(\n      `  ${chalkStderr.yellow(\"\u26A0\")} ${guidelinesRelPath}: installed, modified locally (Convex updates will be skipped)`,\n    );\n  } else if (\n    networkAvailable &&\n    canonicalGuidelinesHash !== null &&\n    config.guidelinesHash !== null &&\n    config.guidelinesHash !== canonicalGuidelinesHash\n  ) {\n    logMessage(\n      `  ${chalkStderr.yellow(\"\u26A0\")} ${guidelinesRelPath}: installed, out of date \u2014 run ${chalkStderr.bold(\"npx convex ai-files update\")}`,\n    );\n  } else {\n    logMessage(\n      `  ${chalkStderr.green(\"\u2714\")} ${guidelinesRelPath}: installed${networkAvailable ? \", up to date\" : \"\"}`,\n    );\n  }\n\n  // --- AGENTS.md (Convex section) ---\n  const hasAgentsSection =\n    agentsContent !== null &&\n    agentsContent.includes(AGENTS_MD_START_MARKER) &&\n    agentsContent.includes(AGENTS_MD_END_MARKER);\n\n  if (!hasAgentsSection) {\n    logMessage(\n      `  ${chalkStderr.yellow(\"\u26A0\")} AGENTS.md: Convex section missing \u2014 run ${chalkStderr.bold(\"npx convex ai-files install\")} to reinstall`,\n    );\n  } else {\n    // Staleness is locally computable from the template \u2014 no network needed.\n    const currentSectionHash = hashSha256(agentsMdConvexSection(convexDirName));\n    if (\n      config.agentsMdSectionHash !== null &&\n      config.agentsMdSectionHash !== currentSectionHash\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\n  // --- CLAUDE.md (Convex section) ---\n  const hasClaudeSection =\n    claudeContent !== null &&\n    claudeContent.includes(CLAUDE_MD_START_MARKER) &&\n    claudeContent.includes(CLAUDE_MD_END_MARKER);\n\n  if (!hasClaudeSection) {\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  } else {\n    // Staleness is locally computable from the template \u2014 no network needed.\n    const currentSectionHash = hashSha256(claudeMdConvexSection(convexDirName));\n    if (\n      config.claudeMdHash !== null &&\n      config.claudeMdHash !== currentSectionHash\n    ) {\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\n  // --- Agent skills ---\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  } else {\n    const skillsStale =\n      networkAvailable &&\n      canonicalAgentSkillsSha !== null &&\n      config.agentSkillsSha !== null &&\n      config.agentSkillsSha !== canonicalAgentSkillsSha;\n    const skillsList = config.installedSkillNames.join(\", \");\n    if (skillsStale) {\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}\n\nexport async function maybeSetupAiFiles(\n  ctx: Context,\n  convexDir: string,\n  projectDir: string,\n): Promise<void> {\n  if (isAgentMode()) {\n    return;\n  }\n\n  // Non-interactive (no TTY) is almost always an AI agent, not CI\n  // (CI uses `npx convex deploy`). Default to installing so agents\n  // get context automatically.\n  let wantsAiFiles = true;\n  if (process.stdin.isTTY) {\n    wantsAiFiles = await promptYesNo(ctx, {\n      message: \"Set up Convex AI files? (guidelines, AGENTS.md, agent skills)\",\n      default: true,\n    });\n  }\n  if (wantsAiFiles) {\n    await writeAiFiles(convexDir, true, \"quiet\", projectDir);\n  }\n}\n\n/**\n * Remove the legacy `.cursor/rules/convex_rules.mdc` file if it exists.\n * This file was written by the old cursor rules auto-update feature (removed\n * in favour of the AI files system). We clean it up unconditionally\n * during `writeAiFiles`, `convex ai-files update`, and `convex ai-files remove` since it was always\n * auto-managed and is now superseded by `convex/_generated/ai/guidelines.md`.\n */\nasync function removeLegacyCursorRulesFile(\n  projectDir: string,\n): Promise<boolean> {\n  const filePath = path.join(\n    projectDir,\n    \".cursor\",\n    \"rules\",\n    \"convex_rules.mdc\",\n  );\n  try {\n    await fs.unlink(filePath);\n    return true;\n  } catch {\n    return false;\n  }\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: 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 the file doesn't match the expected structure, leave it alone.\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\nasync 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 * 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  let entries: string[];\n  try {\n    const dirents = await fs.readdir(skillsDir, { withFileTypes: true });\n    entries = dirents\n      .filter((d) => d.isDirectory() || d.isSymbolicLink())\n      .map((d) => d.name);\n  } catch {\n    return [];\n  }\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    // Extract `name: <value>` from YAML frontmatter (between the --- delimiters).\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 * Output mode controls whether the skills CLI output is streamed live.\n * Returns true on success, false if the process fails or cannot be started.\n */\nfunction runSkillsAdd(\n  cwd: string,\n  outputMode: \"verbose\" | \"quiet\" = \"verbose\",\n): Promise<boolean> {\n  return runSkillsCommand(\n    cwd,\n    [\"add\", \"get-convex/agent-skills\", \"--yes\"],\n    outputMode,\n  );\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(cwd: string, skillNames: string[]): Promise<boolean> {\n  return runSkillsCommand(cwd, [\"remove\", ...skillNames, \"--yes\"]);\n}\n\nasync function shouldRunSkillsCli(): Promise<boolean> {\n  const versionData = await getVersion();\n  if (versionData === null || versionData === undefined) {\n    logMessage(chalkStderr.yellow(`Agent skills are temporarily disabled.`));\n    return false;\n  }\n  if (versionData.disableSkillsCli) {\n    logMessage(chalkStderr.yellow(`Agent skills are temporarily disabled.`));\n    return false;\n  }\n  return true;\n}\n\nfunction runSkillsCommand(\n  cwd: string,\n  args: string[],\n  outputMode: \"verbose\" | \"quiet\" = \"verbose\",\n): Promise<boolean> {\n  return new Promise((resolve) => {\n    const quiet = outputMode === \"quiet\";\n    const proc = child_process.spawn(\"npx\", [\"skills@latest\", ...args], {\n      cwd,\n      stdio: quiet ? \"pipe\" : \"inherit\",\n      // shell: true is required on Windows to resolve `npx` from PATH.\n      shell: process.platform === \"win32\",\n    });\n    let capturedOutput = \"\";\n    if (quiet) {\n      proc.stdout?.on(\"data\", (chunk) => {\n        capturedOutput += chunk.toString();\n      });\n      proc.stderr?.on(\"data\", (chunk) => {\n        capturedOutput += chunk.toString();\n      });\n    }\n    proc.on(\"close\", (code) => {\n      if (quiet && 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/ai/paths.js.map

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

package/dist/esm-types/cli/lib/ai/config.d.ts

@@ -1,50 +0,0 @@
-import { z } from "zod";
-declare const aiFilesStateSchema: z.ZodObject<{
-    guidelinesHash: z.ZodNullable<z.ZodString>;
-    agentsMdSectionHash: z.ZodNullable<z.ZodString>;
-    claudeMdHash: z.ZodNullable<z.ZodString>;
-    agentSkillsSha: z.ZodNullable<z.ZodString>;
-    installedSkillNames: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-}, "strip", z.ZodTypeAny, {
-    guidelinesHash: string | null;
-    agentsMdSectionHash: string | null;
-    claudeMdHash: string | null;
-    agentSkillsSha: string | null;
-    installedSkillNames: string[];
-}, {
-    guidelinesHash: string | null;
-    agentsMdSectionHash: string | null;
-    claudeMdHash: string | null;
-    agentSkillsSha: string | null;
-    installedSkillNames?: string[] | undefined;
-}>;
-export declare const aiFilesSchema: z.ZodObject<{
-    guidelinesHash: z.ZodNullable<z.ZodString>;
-    agentsMdSectionHash: z.ZodNullable<z.ZodString>;
-    claudeMdHash: z.ZodNullable<z.ZodString>;
-    agentSkillsSha: z.ZodNullable<z.ZodString>;
-    installedSkillNames: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-}, "strip", z.ZodTypeAny, {
-    guidelinesHash: string | null;
-    agentsMdSectionHash: string | null;
-    claudeMdHash: string | null;
-    agentSkillsSha: string | null;
-    installedSkillNames: string[];
-}, {
-    guidelinesHash: string | null;
-    agentsMdSectionHash: string | null;
-    claudeMdHash: string | null;
-    agentSkillsSha: string | null;
-    installedSkillNames?: string[] | undefined;
-}>;
-type AiFilesState = z.infer<typeof aiFilesStateSchema>;
-export type AiFilesConfig = AiFilesState & {
-    disableStalenessMessage: boolean;
-};
-export declare function writeAiDisabledToProjectConfig(disableStalenessMessage: boolean, projectDir: string): Promise<void>;
-export declare function readAiConfig(projectDir: string, convexDir: string): Promise<AiFilesConfig | null>;
-export declare function writeAiConfig(config: AiFilesConfig, projectDir: string, convexDir: string, options?: {
-    persistDisabledPreference?: "ifTrue" | "always" | "never";
-}): Promise<void>;
-export {};
-//# sourceMappingURL=config.d.ts.map

package/dist/esm-types/cli/lib/ai/config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../../src/cli/lib/ai/config.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;EAUtB,CAAC;AAYH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;EAAqB,CAAC;AAEhD,KAAK,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACvD,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG;IACzC,uBAAuB,EAAE,OAAO,CAAC;CAClC,CAAC;AA4BF,wBAAsB,8BAA8B,CAClD,uBAAuB,EAAE,OAAO,EAChC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAED,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CA0B/B;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;IAAE,yBAAyB,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAA;CAAE,GACtE,OAAO,CAAC,IAAI,CAAC,CAuBf"}

package/dist/esm-types/cli/lib/ai/config.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=config.test.d.ts.map

package/dist/esm-types/cli/lib/ai/config.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.test.d.ts","sourceRoot":"","sources":["../../../../../src/cli/lib/ai/config.test.ts"],"names":[],"mappings":""}

package/dist/esm-types/cli/lib/ai/index.d.ts

@@ -1,56 +0,0 @@
-import { Context } from "../../../bundler/context.js";
-export declare function injectAgentsMdSection(section: string, projectDir?: string): Promise<string | null>;
-type InjectClaudeSectionResult = {
-    sectionHash: string;
-    didWrite: boolean;
-};
-export declare function injectClaudeMdSection(section: string, projectDir?: string): Promise<InjectClaudeSectionResult>;
-/**
- * Write/update all Convex AI files (guidelines, AGENTS.md, CLAUDE.md, skills).
- *
- * @param convexDir - absolute path to the project's convex functions directory
- *   (e.g. `/home/user/myapp/convex`). Used to build the `_generated/ai/` subdirectory.
- */
-export declare function writeAiFiles(convexDir: string, installSkills?: boolean, skillsOutputMode?: "verbose" | "quiet", projectDirOverride?: string): Promise<void>;
-/**
- * Check whether the Convex AI files are out of date and log a nag message
- * if so.
- */
-export declare function checkAiFilesStaleness(canonicalGuidelinesHash: string | null, canonicalAgentSkillsSha: string | null, projectDir: string, convexDir: string): Promise<void>;
-/**
- * Update all Convex AI files to their latest versions.
- *
- * Files the user has modified (detected via hash comparison) are skipped
- * with a warning rather than silently overwritten.
- *
- * @param projectDir - absolute path to the project root directory.
- * @param convexDir - absolute path to the Convex functions directory.
- */
-export declare function updateAiFiles(projectDir: string, convexDir: string): Promise<void>;
-export declare function enableAiFiles(projectDir: string, convexDir: string): Promise<void>;
-/**
- * Remove all Convex AI files from the project.
- * Called by `npx convex ai-files remove`.
- *
- * - Strips the Convex section from AGENTS.md (deletes file if empty)
- * - Strips the Convex section from CLAUDE.md (deletes file if empty)
- * - Runs `npx skills remove <name...> --yes` for each tracked skill
- * - Deletes the `convex/_generated/ai/` directory
- */
-export declare function removeAiFiles(projectDir: string, convexDir: string): Promise<void>;
-/**
- * Called by `npx convex ai-files disable`.
- *
- * Writes a suppression flag into `convex.json` (`aiFiles.disableStalenessMessage`) so
- * `npx convex dev` stops showing AI files install/staleness messages.
- * Files are left in place - use `remove` to delete them.
- * The user can re-enable at any time with `npx convex ai-files enable`.
- */
-export declare function disableAiFiles(projectDir: string): Promise<void>;
-/**
- * Print the current status of Convex AI files to the terminal.
- */
-export declare function statusAiFiles(projectDir: string, convexDir: string): Promise<void>;
-export declare function maybeSetupAiFiles(ctx: Context, convexDir: string, projectDir: string): Promise<void>;
-export {};
-//# sourceMappingURL=index.d.ts.map

package/dist/esm-types/cli/lib/ai/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/cli/lib/ai/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AA6CtD,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA6BxB;AAED,KAAK,yBAAyB,GAAG;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,yBAAyB,CAAC,CAmCpC;AAMD;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,aAAa,GAAE,OAAe,EAC9B,gBAAgB,GAAE,SAAS,GAAG,OAAmB,EACjD,kBAAkB,CAAC,EAAE,MAAM,GAC1B,OAAO,CAAC,IAAI,CAAC,CA8Ff;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,uBAAuB,EAAE,MAAM,GAAG,IAAI,EACtC,uBAAuB,EAAE,MAAM,GAAG,IAAI,EACtC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CA4Cf;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAsIf;AAED,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAUf;AAuED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAyFf;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CActE;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAyJf;AAED,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,OAAO,EACZ,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAkBf"}

package/dist/esm-types/cli/lib/ai/index.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../../../../src/cli/lib/ai/index.test.ts"],"names":[],"mappings":""}

package/dist/esm-types/cli/lib/ai/integration.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"integration.test.d.ts","sourceRoot":"","sources":["../../../../../src/cli/lib/ai/integration.test.ts"],"names":[],"mappings":""}

package/dist/esm-types/cli/lib/ai/paths.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../../../src/cli/lib/ai/paths.ts"],"names":[],"mappings":"AAKA,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/esm-types/cli/lib/ai/prompt.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"prompt.test.d.ts","sourceRoot":"","sources":["../../../../../src/cli/lib/ai/prompt.test.ts"],"names":[],"mappings":""}

package/src/cli/lib/ai/config.test.ts

@@ -1,338 +0,0 @@
-import { describe, test, expect, vi, beforeEach, afterEach } from "vitest";
-import * as Sentry from "@sentry/node";
-import { promises as fs } from "fs";
-import {
-  aiFilesSchema,
-  readAiConfig,
-  writeAiConfig,
-  writeAiDisabledToProjectConfig,
-} from "./config.js";
-
-vi.mock("@sentry/node", () => ({
-  captureException: vi.fn(),
-  captureMessage: vi.fn(),
-}));
-
-vi.mock("fs", () => ({
-  promises: {
-    readFile: vi.fn(),
-    writeFile: vi.fn(),
-  },
-}));
-
-const mockFs = vi.mocked(fs);
-const mockCaptureException = vi.mocked(Sentry.captureException);
-
-const dummyProjectDir = "/tmp/test-project";
-const dummyConvexDir = "/tmp/test-project/convex";
-
-describe("aiFilesSchema", () => {
-  test("accepts a fully populated valid state object", () => {
-    const result = aiFilesSchema.safeParse({
-      guidelinesHash: "abc123",
-      agentsMdSectionHash: "def456",
-      claudeMdHash: "ghi789",
-      agentSkillsSha: "deadbeef",
-      installedSkillNames: ["convex-migrations", "convex-perf-review"],
-    });
-    expect(result.success).toBe(true);
-  });
-
-  test("accepts null hashes", () => {
-    const result = aiFilesSchema.safeParse({
-      guidelinesHash: null,
-      agentsMdSectionHash: null,
-      claudeMdHash: null,
-      agentSkillsSha: null,
-    });
-    expect(result.success).toBe(true);
-  });
-
-  test("applies default for installedSkillNames when absent", () => {
-    const result = aiFilesSchema.safeParse({
-      guidelinesHash: "abc",
-      agentsMdSectionHash: null,
-      claudeMdHash: null,
-      agentSkillsSha: null,
-    });
-    expect(result.success).toBe(true);
-    if (result.success) {
-      expect(result.data.installedSkillNames).toEqual([]);
-    }
-  });
-
-  test("rejects a number where a string hash is expected", () => {
-    const result = aiFilesSchema.safeParse({
-      guidelinesHash: 123,
-      agentsMdSectionHash: null,
-      claudeMdHash: null,
-      agentSkillsSha: null,
-    });
-    expect(result.success).toBe(false);
-  });
-
-  test("rejects missing required fields", () => {
-    const result = aiFilesSchema.safeParse({
-      guidelinesHash: "abc",
-    });
-    expect(result.success).toBe(false);
-  });
-});
-
-describe("readAiConfig", () => {
-  beforeEach(() => vi.clearAllMocks());
-  afterEach(() => vi.resetAllMocks());
-
-  test("returns null when the file does not exist", async () => {
-    mockFs.readFile.mockRejectedValue(
-      Object.assign(new Error("ENOENT"), { code: "ENOENT" }),
-    );
-
-    const result = await readAiConfig(dummyProjectDir, dummyConvexDir);
-
-    expect(result).toBeNull();
-    expect(mockCaptureException).not.toHaveBeenCalled();
-  });
-
-  test("returns parsed state with disableStalenessMessage=false when convex.json is missing", async () => {
-    mockFs.readFile
-      .mockRejectedValueOnce(
-        Object.assign(new Error("ENOENT"), { code: "ENOENT" }),
-      )
-      .mockResolvedValueOnce(
-        JSON.stringify({
-          guidelinesHash: "abc",
-          agentsMdSectionHash: "def",
-          claudeMdHash: null,
-          agentSkillsSha: null,
-        }),
-      );
-
-    const result = await readAiConfig(dummyProjectDir, dummyConvexDir);
-
-    expect(result).toEqual({
-      guidelinesHash: "abc",
-      agentsMdSectionHash: "def",
-      claudeMdHash: null,
-      agentSkillsSha: null,
-      installedSkillNames: [],
-      disableStalenessMessage: false,
-    });
-  });
-
-  test("returns empty disabled config when state file is missing and convex.json disables nags", async () => {
-    mockFs.readFile
-      .mockResolvedValueOnce(
-        JSON.stringify({ aiFiles: { disableStalenessMessage: true } }),
-      )
-      .mockRejectedValueOnce(
-        Object.assign(new Error("ENOENT"), { code: "ENOENT" }),
-      );
-
-    const result = await readAiConfig(dummyProjectDir, dummyConvexDir);
-
-    expect(result).toEqual({
-      guidelinesHash: null,
-      agentsMdSectionHash: null,
-      claudeMdHash: null,
-      agentSkillsSha: null,
-      installedSkillNames: [],
-      disableStalenessMessage: true,
-    });
-  });
-
-  test("returns null and captures exception when JSON is invalid", async () => {
-    mockFs.readFile
-      .mockResolvedValueOnce(
-        JSON.stringify({ aiFiles: { disableStalenessMessage: false } }),
-      )
-      .mockResolvedValueOnce("not valid json {{{}");
-
-    const result = await readAiConfig(dummyProjectDir, dummyConvexDir);
-
-    expect(result).toBeNull();
-    expect(mockCaptureException).toHaveBeenCalledWith(expect.any(Error));
-  });
-
-  test("returns null and captures exception when schema validation fails", async () => {
-    mockFs.readFile
-      .mockResolvedValueOnce(
-        JSON.stringify({ aiFiles: { disableStalenessMessage: false } }),
-      )
-      .mockResolvedValueOnce(
-        JSON.stringify({
-          guidelinesHash: 99,
-          agentsMdSectionHash: null,
-        }),
-      );
-
-    const result = await readAiConfig(dummyProjectDir, dummyConvexDir);
-
-    expect(result).toBeNull();
-    expect(mockCaptureException).toHaveBeenCalledWith(expect.any(Error));
-  });
-
-  test("returns parsed state and reads disableStalenessMessage from convex.json", async () => {
-    const stored = {
-      guidelinesHash: "abc",
-      agentsMdSectionHash: "def",
-      claudeMdHash: null,
-      agentSkillsSha: "deadbeef",
-    };
-    mockFs.readFile
-      .mockResolvedValueOnce(
-        JSON.stringify({ aiFiles: { disableStalenessMessage: true } }),
-      )
-      .mockResolvedValueOnce(JSON.stringify(stored));
-
-    const result = await readAiConfig(dummyProjectDir, dummyConvexDir);
-
-    expect(result).toEqual({
-      ...stored,
-      installedSkillNames: [],
-      disableStalenessMessage: true,
-    });
-  });
-});
-
-describe("writeAiConfig", () => {
-  beforeEach(() => vi.clearAllMocks());
-  afterEach(() => vi.resetAllMocks());
-
-  test("writes state file and does not persist disableStalenessMessage=false by default", async () => {
-    mockFs.writeFile.mockResolvedValue(undefined);
-
-    const config = {
-      disableStalenessMessage: false,
-      guidelinesHash: "abc",
-      agentsMdSectionHash: "def",
-      claudeMdHash: null,
-      agentSkillsSha: null,
-      installedSkillNames: ["convex-migrations"],
-    };
-
-    await writeAiConfig(config, dummyProjectDir, dummyConvexDir);
-
-    expect(mockFs.writeFile).toHaveBeenCalledTimes(1);
-    expect(mockFs.writeFile).toHaveBeenCalledWith(
-      expect.stringContaining("ai-files.state.json"),
-      JSON.stringify(
-        {
-          guidelinesHash: "abc",
-          agentsMdSectionHash: "def",
-          claudeMdHash: null,
-          agentSkillsSha: null,
-          installedSkillNames: ["convex-migrations"],
-        },
-        null,
-        2,
-      ) + "\n",
-      "utf8",
-    );
-  });
-
-  test("persists disableStalenessMessage=false when requested explicitly", async () => {
-    mockFs.writeFile.mockResolvedValue(undefined);
-    mockFs.readFile.mockResolvedValue("{}");
-
-    await writeAiConfig(
-      {
-        disableStalenessMessage: false,
-        guidelinesHash: null,
-        agentsMdSectionHash: null,
-        claudeMdHash: null,
-        agentSkillsSha: null,
-        installedSkillNames: [],
-      },
-      dummyProjectDir,
-      dummyConvexDir,
-      { persistDisabledPreference: "always" },
-    );
-
-    expect(mockFs.writeFile).toHaveBeenNthCalledWith(
-      2,
-      expect.stringContaining("convex.json"),
-      JSON.stringify(
-        {
-          $schema: "node_modules/convex/schemas/convex.schema.json",
-          aiFiles: {
-            disableStalenessMessage: false,
-          },
-        },
-        null,
-        2,
-      ) + "\n",
-      "utf8",
-    );
-  });
-
-  test("persists to convex.json by default when disableStalenessMessage is true", async () => {
-    mockFs.writeFile.mockResolvedValue(undefined);
-    mockFs.readFile.mockResolvedValue("{}");
-
-    await writeAiConfig(
-      {
-        disableStalenessMessage: true,
-        guidelinesHash: null,
-        agentsMdSectionHash: null,
-        claudeMdHash: null,
-        agentSkillsSha: null,
-        installedSkillNames: [],
-      },
-      dummyProjectDir,
-      dummyConvexDir,
-    );
-
-    expect(mockFs.writeFile).toHaveBeenCalledTimes(2);
-    expect(mockFs.writeFile).toHaveBeenNthCalledWith(
-      2,
-      expect.stringContaining("convex.json"),
-      expect.stringContaining('"disableStalenessMessage": true'),
-      "utf8",
-    );
-  });
-
-  test("never writes to convex.json when persistDisabledPreference is 'never'", async () => {
-    mockFs.writeFile.mockResolvedValue(undefined);
-
-    await writeAiConfig(
-      {
-        disableStalenessMessage: true,
-        guidelinesHash: null,
-        agentsMdSectionHash: null,
-        claudeMdHash: null,
-        agentSkillsSha: null,
-        installedSkillNames: [],
-      },
-      dummyProjectDir,
-      dummyConvexDir,
-      { persistDisabledPreference: "never" },
-    );
-
-    expect(mockFs.writeFile).toHaveBeenCalledTimes(1);
-    expect(mockFs.writeFile).toHaveBeenCalledWith(
-      expect.stringContaining("ai-files.state.json"),
-      expect.any(String),
-      "utf8",
-    );
-  });
-});
-
-describe("writeAiDisabledToProjectConfig", () => {
-  beforeEach(() => vi.clearAllMocks());
-  afterEach(() => vi.resetAllMocks());
-
-  test("writes only convex.json with disableStalenessMessage=true", async () => {
-    mockFs.readFile.mockResolvedValue("{}");
-    mockFs.writeFile.mockResolvedValue(undefined);
-
-    await writeAiDisabledToProjectConfig(true, dummyProjectDir);
-
-    expect(mockFs.writeFile).toHaveBeenCalledTimes(1);
-    expect(mockFs.writeFile).toHaveBeenCalledWith(
-      expect.stringContaining("convex.json"),
-      expect.stringContaining('"disableStalenessMessage": true'),
-      "utf8",
-    );
-  });
-});