@vocoder/cli 0.1.16 → 0.1.17

package/dist/bin.mjs

@@ -5,7 +5,7 @@ import {
   detectLocalEcosystem,
   getPackagesToInstall,
   getSetupSnippets
-} from "./chunk-KPIT5ETY.mjs";
+} from "./chunk-3QBORM6T.mjs";
 
 // src/bin.ts
 import { Command } from "commander";
@@ -420,7 +420,7 @@ var VocoderAPI = class {
       organizationName: data.organizationName,
       sourceLocale: data.sourceLocale,
       targetLocales: data.targetLocales,
-      branchTriggers: data.branchTriggers ?? [],
+      targetBranches: data.targetBranches ?? ["main"],
       primaryBranch: data.primaryBranch,
       syncPolicy: {
         blockingBranches: data.syncPolicy?.blockingBranches ?? ["main", "master"],
@@ -480,7 +480,8 @@ var VocoderAPI = class {
         ...typeof options?.requestedMaxWaitMs === "number" ? { requestedMaxWaitMs: options.requestedMaxWaitMs } : {},
         ...options?.clientRunId ? { clientRunId: options.clientRunId } : {},
         ...repoIdentity?.repoCanonical ? { repoCanonical: repoIdentity.repoCanonical } : {},
-        ...repoIdentity?.repoScopePath !== void 0 ? { repoScopePath: repoIdentity.repoScopePath } : {}
+        ...repoIdentity?.repoAppDir !== void 0 ? { repoAppDir: repoIdentity.repoAppDir } : {},
+        ...repoIdentity?.commitSha ? { commitSha: repoIdentity.commitSha } : {}
       })
     }, "Translation submission failed");
   }
@@ -700,6 +701,25 @@ var VocoderAPI = class {
     const result = payload;
     return result.projects;
   }
+  async regenerateProjectApiKey(userToken, projectId) {
+    const response = await fetch(`${this.apiUrl}/api/cli/project/regenerate-key`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${userToken}`
+      },
+      body: JSON.stringify({ projectId })
+    });
+    const payload = await readPayload(response);
+    if (!response.ok) {
+      throw new VocoderAPIError({
+        message: extractErrorMessage(payload, `Failed to regenerate API key (${response.status})`),
+        status: response.status,
+        payload
+      });
+    }
+    return payload;
+  }
   // ── CLI GitHub endpoints ──────────────────────────────────────────────────────
   async startCliGitHubInstall(userToken, params) {
     const response = await fetch(`${this.apiUrl}/api/cli/github/install/start`, {
@@ -842,7 +862,7 @@ var VocoderAPI = class {
         headers: { "Content-Type": "application/json" },
         body: JSON.stringify({
           repo: params.repoCanonical,
-          scopePath: params.scopePath
+          appDir: params.appDir
         })
       });
       if (!response.ok) {
@@ -886,6 +906,15 @@ import { config as loadEnv } from "dotenv";
 // src/utils/git-identity.ts
 import { execSync } from "child_process";
 import { relative, resolve } from "path";
+var SHA_REGEX = /^[0-9a-f]{40}$/i;
+function detectCommitSha() {
+  if (process.env.VOCODER_COMMIT_SHA && SHA_REGEX.test(process.env.VOCODER_COMMIT_SHA)) {
+    return process.env.VOCODER_COMMIT_SHA;
+  }
+  const knownSha = process.env.GITHUB_SHA || process.env.VERCEL_GIT_COMMIT_SHA || process.env.CI_COMMIT_SHA || process.env.BITBUCKET_COMMIT || process.env.CIRCLE_SHA1 || process.env.RENDER_GIT_COMMIT;
+  if (knownSha && SHA_REGEX.test(knownSha)) return knownSha;
+  return safeExec("git rev-parse HEAD");
+}
 function safeExec(command) {
   try {
     const output = execSync(command, {
@@ -956,16 +985,16 @@ function resolveGitRepositoryIdentity() {
   }
   const repositoryRoot = safeExec("git rev-parse --show-toplevel");
   const currentDirectory = process.cwd();
-  let repoScopePath = "";
+  let repoAppDir = "";
   if (repositoryRoot) {
     const relativePath = relative(resolve(repositoryRoot), resolve(currentDirectory)).replace(/\\/g, "/").trim();
     if (relativePath && relativePath !== "." && !relativePath.startsWith("..")) {
-      repoScopePath = relativePath;
+      repoAppDir = relativePath;
     }
   }
   return {
     repoCanonical: toCanonical(parsed.host, parsed.ownerRepoPath),
-    repoScopePath
+    repoAppDir
   };
 }
 function resolveGitContext() {
@@ -1249,7 +1278,7 @@ function filterItems(items, query) {
   const lower = query.toLowerCase();
   return items.filter((i) => i.value.toLowerCase().includes(lower));
 }
-function buildList2(filtered, cursor, scrollOffset, selected, filter, customPatterns, addCursor, optional = false) {
+function buildList2(filtered, cursor, scrollOffset, selected, filter, customPatterns, addCursor, optional = false, excludedPatterns = /* @__PURE__ */ new Set()) {
   const lines = [];
   const end = Math.min(filtered.length, scrollOffset + MAX_VISIBLE2);
   for (let i = scrollOffset; i < end; i++) {
@@ -1265,7 +1294,7 @@ function buildList2(filtered, cursor, scrollOffset, selected, filter, customPatt
   const allItems = [...filtered];
   const isNewPattern = trimmed.length > 0 && !allItems.some((i) => i.value === trimmed) && !customPatterns.includes(trimmed);
   if (isNewPattern) {
-    const err = validateBranchPattern(trimmed);
+    const err = validateBranchPattern(trimmed) ?? (excludedPatterns.has(trimmed) ? "Already used for automatic translation" : null);
     const icon = addCursor ? grn2("\u25FB") : dim2("\u25FB");
     const label = err ? `${ylw2("+")}  ${dim2(`"${trimmed}" \u2014 ${err}`)}` : `${grn2("+")}  Add "${trimmed}" as branch pattern`;
     lines.push(`${cyan2(S_BAR2)}  ${icon}  ${label}`);
@@ -1284,6 +1313,7 @@ function buildList2(filtered, cursor, scrollOffset, selected, filter, customPatt
 async function filterableBranchSelect(params) {
   const { message, branches, defaultBranch } = params;
   const optional = params.optional ?? false;
+  const excludedSet = new Set(params.excludedPatterns ?? []);
   let filter = "";
   let cursor = 0;
   let scrollOffset = 0;
@@ -1331,7 +1361,7 @@ ${symbol2(this.state)}  ${message}
             return [
               hdr.trimEnd(),
               `${ylw2(S_BAR2)}  ${dim2("/")} ${hint}`,
-              buildList2(filtered, cursor, scrollOffset, selected, filter, customPatterns, addCursor, optional),
+              buildList2(filtered, cursor, scrollOffset, selected, filter, customPatterns, addCursor, optional, excludedSet),
               `${ylw2(S_BAR_END2)}  ${ylw2(this.error)}`,
               ""
             ].join("\n");
@@ -1339,7 +1369,7 @@ ${symbol2(this.state)}  ${message}
             return [
               hdr.trimEnd(),
               `${cyan2(S_BAR2)}  ${dim2("/")} ${hint}`,
-              buildList2(filtered, cursor, scrollOffset, selected, filter, customPatterns, addCursor, optional),
+              buildList2(filtered, cursor, scrollOffset, selected, filter, customPatterns, addCursor, optional, excludedSet),
               `${cyan2(S_BAR_END2)}`,
               ""
             ].join("\n");
@@ -1380,7 +1410,7 @@ ${symbol2(this.state)}  ${message}
       case "space":
         if (addCursor) {
           const t = filter.trim();
-          const err = validateBranchPattern(t);
+          const err = validateBranchPattern(t) ?? (excludedSet.has(t) ? "Already used for automatic translation" : null);
           if (!err) {
             customPatterns.push(t);
             selected.add(t);
@@ -1441,10 +1471,10 @@ async function runProjectCreate(params) {
   }
   const languageOptions = buildLanguageOptions(rawLocales);
   const localeOptions = buildLocaleOptions(rawLocales);
-  let scopePath;
-  if (params.defaultScopePath) {
-    scopePath = params.defaultScopePath;
-    p3.log.success(`App directory: ${chalk4.bold(scopePath)}`);
+  let appDir;
+  if (params.defaultAppDir) {
+    appDir = params.defaultAppDir;
+    p3.log.success(`App directory: ${chalk4.bold(appDir)}`);
   } else {
     const rawScope = await p3.text({
       message: "App directory (leave blank for the entire repo)",
@@ -1458,7 +1488,7 @@ async function runProjectCreate(params) {
       }
     });
     if (p3.isCancel(rawScope)) return null;
-    scopePath = (rawScope ?? "").trim();
+    appDir = (rawScope ?? "").trim();
   }
   const sourceLocale = await searchSelectLocale(
     languageOptions,
@@ -1482,7 +1512,7 @@ async function runProjectCreate(params) {
     let initial = initialBranches;
     while (pushBranches.length === 0) {
       const result = await filterableBranchSelect({
-        message: "Translate on push \u2014 which branches?",
+        message: "Which branches should trigger translations?",
         branches: detected.branches,
         defaultBranch: detected.defaultBranch,
         initialValues: initial
@@ -1496,59 +1526,15 @@ async function runProjectCreate(params) {
       }
     }
   }
-  const prResult = await filterableBranchSelect({
-    message: "Translate on pull requests \u2014 which branches? (optional)",
-    branches: detected.branches,
-    defaultBranch: detected.defaultBranch,
-    initialValues: [],
-    optional: true
-  });
-  if (prResult === null) return null;
-  const prBranches = prResult;
-  const autoSet = /* @__PURE__ */ new Set([...pushBranches, ...prBranches]);
-  const manualResult = await filterableBranchSelect({
-    message: `Manual-only branches \u2014 translate via \`vocoder sync\` only (optional)`,
-    branches: detected.branches.filter((b) => !autoSet.has(b)),
-    defaultBranch: detected.defaultBranch,
-    initialValues: [],
-    optional: true
-  });
-  if (manualResult === null) return null;
-  const manualBranches = manualResult.filter((b) => {
-    if (autoSet.has(b)) {
-      p3.log.warn(`"${b}" is already configured for automatic translation \u2014 skipping from manual.`);
-      return false;
-    }
-    return true;
-  });
-  if (pushBranches.length === 0 && prBranches.length === 0 && manualBranches.length === 0) {
-    p3.log.error("At least one branch must be configured.");
-    return null;
-  }
-  const triggerMap = /* @__PURE__ */ new Map();
-  for (const b of pushBranches) {
-    if (!triggerMap.has(b)) triggerMap.set(b, /* @__PURE__ */ new Set());
-    triggerMap.get(b).add("push");
-  }
-  for (const b of prBranches) {
-    if (!triggerMap.has(b)) triggerMap.set(b, /* @__PURE__ */ new Set());
-    triggerMap.get(b).add("pull_request");
-  }
-  for (const b of manualBranches) {
-    triggerMap.set(b, /* @__PURE__ */ new Set(["manual"]));
-  }
-  const branchTriggers = Array.from(triggerMap.entries()).map(([pattern, triggers]) => ({
-    pattern,
-    triggers: Array.from(triggers)
-  }));
+  const targetBranches = pushBranches;
   try {
     const result = await api.createProject(userToken, {
       organizationId,
       name: projectName,
       sourceLocale,
       targetLocales,
-      branchTriggers,
-      scopePaths: scopePath ? [scopePath] : [],
+      targetBranches,
+      appDirs: appDir ? [appDir] : [],
       repoCanonical
     });
     p3.log.success(`Project ${chalk4.bold(result.projectName)} created!`);
@@ -1561,7 +1547,7 @@ async function runProjectCreate(params) {
 }
 async function runProjectAppCreate(params) {
   const { api, userToken, projectId, projectName, repoCanonical } = params;
-  const existingScopes = new Set(params.existingApps.map((a) => a.scopePath));
+  const existingScopes = new Set(params.existingApps.map((a) => a.appDir));
   let rawLocales;
   try {
     rawLocales = await api.listLocales(userToken);
@@ -1571,20 +1557,20 @@ async function runProjectAppCreate(params) {
   }
   const languageOptions = buildLanguageOptions(rawLocales);
   const localeOptions = buildLocaleOptions(rawLocales);
-  let scopePath;
-  if (params.defaultScopePath && !existingScopes.has(params.defaultScopePath)) {
-    scopePath = params.defaultScopePath;
-    p3.log.success(`App directory: ${chalk4.bold(scopePath)}`);
+  let appDir;
+  if (params.defaultAppDir && !existingScopes.has(params.defaultAppDir)) {
+    appDir = params.defaultAppDir;
+    p3.log.success(`App directory: ${chalk4.bold(appDir)}`);
   } else {
     if (params.existingApps.length > 0) {
-      const configuredList = params.existingApps.map((a) => chalk4.dim(a.scopePath || "(entire repo)")).join(", ");
+      const configuredList = params.existingApps.map((a) => chalk4.dim(a.appDir || "(entire repo)")).join(", ");
       p3.log.info(`Already configured: ${configuredList}`);
     }
     const hasWholeRepoApp = existingScopes.has("");
     const rawScope = await p3.text({
       message: "App directory for this new app",
       placeholder: "e.g. apps/backend",
-      initialValue: params.defaultScopePath ?? "",
+      initialValue: params.defaultAppDir ?? "",
       validate(value) {
         const v = value.trim();
         if (!v && hasWholeRepoApp) return "This project already covers the entire repo.";
@@ -1595,7 +1581,7 @@ async function runProjectAppCreate(params) {
       }
     });
     if (p3.isCancel(rawScope)) return null;
-    scopePath = (rawScope ?? "").trim();
+    appDir = (rawScope ?? "").trim();
   }
   const sourceLocale = await searchSelectLocale(
     languageOptions,
@@ -1618,7 +1604,7 @@ async function runProjectAppCreate(params) {
     let initial = [detectedApp.defaultBranch];
     while (appPushBranches.length === 0) {
       const result = await filterableBranchSelect({
-        message: "Translate on push \u2014 which branches?",
+        message: "Which branches should trigger translations?",
         branches: detectedApp.branches,
         defaultBranch: detectedApp.defaultBranch,
         initialValues: initial
@@ -1632,64 +1618,25 @@ async function runProjectAppCreate(params) {
       }
     }
   }
-  const appPrResult = await filterableBranchSelect({
-    message: "Translate on pull requests \u2014 which branches? (optional)",
-    branches: detectedApp.branches,
-    defaultBranch: detectedApp.defaultBranch,
-    initialValues: [],
-    optional: true
-  });
-  if (appPrResult === null) return null;
-  const appAutoSet = /* @__PURE__ */ new Set([...appPushBranches, ...appPrResult]);
-  const appManualResult = await filterableBranchSelect({
-    message: "Manual-only branches (optional)",
-    branches: detectedApp.branches.filter((b) => !appAutoSet.has(b)),
-    defaultBranch: detectedApp.defaultBranch,
-    initialValues: [],
-    optional: true
-  });
-  if (appManualResult === null) return null;
-  const appManualBranches = appManualResult.filter((b) => {
-    if (appAutoSet.has(b)) {
-      p3.log.warn(`"${b}" is already configured for automatic translation \u2014 skipping from manual.`);
-      return false;
-    }
-    return true;
-  });
-  const appTriggerMap = /* @__PURE__ */ new Map();
-  for (const b of appPushBranches) {
-    if (!appTriggerMap.has(b)) appTriggerMap.set(b, /* @__PURE__ */ new Set());
-    appTriggerMap.get(b).add("push");
-  }
-  for (const b of appPrResult) {
-    if (!appTriggerMap.has(b)) appTriggerMap.set(b, /* @__PURE__ */ new Set());
-    appTriggerMap.get(b).add("pull_request");
-  }
-  for (const b of appManualBranches) {
-    appTriggerMap.set(b, /* @__PURE__ */ new Set(["manual"]));
-  }
-  const branchTriggers = Array.from(appTriggerMap.entries()).map(([pattern, triggers]) => ({
-    pattern,
-    triggers: Array.from(triggers)
-  }));
+  const targetBranches = appPushBranches;
   try {
     const result = await api.createProjectApp(userToken, {
       projectId,
-      scopePath,
+      appDir,
       sourceLocale,
       targetLocales,
-      branchTriggers,
+      targetBranches,
       repoCanonical: repoCanonical ?? ""
     });
-    p3.log.success(`App ${chalk4.bold(scopePath)} added to ${chalk4.bold(projectName)}!`);
+    p3.log.success(`App ${chalk4.bold(appDir)} added to ${chalk4.bold(projectName)}!`);
     return {
       projectId: result.projectId,
       projectName: result.projectName,
       apiKey: result.apiKey,
-      scopePath: result.scopePath,
+      appDir: result.appDir,
       sourceLocale,
       targetLocales,
-      branchTriggers
+      targetBranches
     };
   } catch (error) {
     const message = error instanceof Error ? error.message : "Unknown error";
@@ -1799,9 +1746,7 @@ function printPlanLimitMessage(apiUrl, message) {
   p5.log.info(`Manage subscription: ${getSubscriptionSettingsUrl(apiUrl)}`);
 }
 function runScaffold(params) {
-  const { projectName, organizationName, sourceLocale, branchTriggers } = params;
-  p5.log.info(`Project:   ${chalk6.bold(projectName)}`);
-  p5.log.info(`Workspace: ${chalk6.bold(organizationName)}`);
+  const { sourceLocale, targetBranches } = params;
   const detection = detectLocalEcosystem();
   if (detection.ecosystem) {
     const frameworkLabel = detection.framework ?? detection.ecosystem;
@@ -1828,7 +1773,7 @@ function runScaffold(params) {
     framework: detection.framework,
     ecosystem: detection.ecosystem,
     sourceLocale,
-    branchTriggers
+    targetBranches
   });
   let stepNum = 1;
   if (snippets.pluginStep) {
@@ -2037,7 +1982,7 @@ async function runAuthFlow(api, options, reauth = false, repoCanonical) {
 }
 async function init(options = {}) {
   const apiUrl = options.apiUrl || process.env.VOCODER_API_URL || "https://vocoder.app";
-  p5.intro("Vocoder Setup");
+  p5.intro(chalk6.bold("Vocoder Setup"));
   try {
     const gitContext = resolveGitContext();
     const identity = gitContext.identity;
@@ -2053,28 +1998,43 @@ async function init(options = {}) {
       const anonApi = new VocoderAPI({ apiUrl, apiKey: "" });
       const lookup = await anonApi.lookupProjectByRepo({
         repoCanonical: identity.repoCanonical,
-        scopePath: identity.repoScopePath
+        appDir: identity.repoAppDir
       });
       if (lookup.exactMatch) {
         const { exactMatch } = lookup;
-        runScaffold({
-          projectName: exactMatch.projectName,
-          organizationName: exactMatch.organizationName,
-          sourceLocale: exactMatch.sourceLocale ?? "en",
-          branchTriggers: exactMatch.branchTriggers ?? [{ pattern: "main", triggers: ["push"] }]
+        p5.log.success(`Project: ${chalk6.bold(exactMatch.projectName)}`);
+        p5.log.info(`Branches: ${chalk6.cyan((exactMatch.targetBranches ?? ["main"]).join(", "))}`);
+        const needsKey = await p5.confirm({
+          message: "Need to regenerate your API key?"
         });
+        if (!p5.isCancel(needsKey) && needsKey) {
+          const anonApi2 = new VocoderAPI({ apiUrl, apiKey: "" });
+          const authResult = await runAuthFlow(
+            anonApi2,
+            options,
+            /* reauth */
+            true
+          );
+          if (!authResult) return 1;
+          const spinner4 = p5.spinner();
+          spinner4.start("Generating new API key...");
+          try {
+            const { apiKey } = await anonApi2.regenerateProjectApiKey(authResult.token, exactMatch.projectId);
+            spinner4.stop("New API key generated");
+            printMcpSetup(apiKey);
+          } catch {
+            spinner4.stop("Failed to generate key");
+            p5.log.error("Could not generate API key. Try again or generate one from the dashboard.");
+            return 1;
+          }
+        }
         p5.outro("Vocoder is already set up for this repository.");
         return 0;
       }
       if (lookup.hasWholeRepoApp) {
-        const wholeRepo = lookup.existingApps.find((a) => a.scopePath === "");
+        const wholeRepo = lookup.existingApps.find((a) => a.appDir === "");
         if (wholeRepo) {
-          runScaffold({
-            projectName: wholeRepo.projectName,
-            organizationName: wholeRepo.organizationName,
-            sourceLocale: "en",
-            branchTriggers: [{ pattern: "main", triggers: ["push"] }]
-          });
+          p5.log.success(`Project: ${chalk6.bold(wholeRepo.projectName)}`);
           p5.outro("Vocoder is already set up for this repository.");
           return 0;
         }
@@ -2090,7 +2050,6 @@ async function init(options = {}) {
     let userEmail;
     let userName;
     let authOrganizationId;
-    let authDiscoveryReady = false;
     const stored = readAuthData();
     if (stored && stored.apiUrl === apiUrl) {
       const verified = await verifyStoredToken(api, stored.token);
@@ -2118,7 +2077,6 @@ async function init(options = {}) {
         userEmail = authResult.email;
         userName = authResult.name;
         authOrganizationId = authResult.organizationId;
-        authDiscoveryReady = authResult.discoveryReady ?? false;
         writeAuthData({
           token: userToken,
           apiUrl,
@@ -2360,7 +2318,7 @@ async function init(options = {}) {
     if (repoProjectId && repoProjectName && existingAppsForRepo.length > 0) {
       p5.log.info(
         `${chalk6.bold(repoProjectName)} is already set up for this repo.
-  Configured apps: ${existingAppsForRepo.map((a) => chalk6.cyan(a.scopePath || "(entire repo)")).join(", ")}`
+  Configured apps: ${existingAppsForRepo.map((a) => chalk6.cyan(a.appDir || "(entire repo)")).join(", ")}`
       );
       const appResult = await runProjectAppCreate({
         api,
@@ -2369,7 +2327,7 @@ async function init(options = {}) {
         projectName: repoProjectName,
         organizationName: selectedWorkspaceName,
         repoCanonical: identity?.repoCanonical,
-        defaultScopePath: identity?.repoScopePath,
+        defaultAppDir: identity?.repoAppDir,
         existingApps: existingAppsForRepo
       });
       if (!appResult) {
@@ -2377,10 +2335,8 @@ async function init(options = {}) {
         return 1;
       }
       runScaffold({
-        projectName: appResult.projectName,
-        organizationName: selectedWorkspaceName,
         sourceLocale: appResult.sourceLocale,
-        branchTriggers: appResult.branchTriggers
+        targetBranches: appResult.targetBranches
       });
       p5.outro("You're all set.");
       return 0;
@@ -2439,7 +2395,7 @@ async function init(options = {}) {
           projectName: chosen.name,
           organizationName: selectedWorkspaceName,
           repoCanonical: identity?.repoCanonical,
-          defaultScopePath: identity?.repoScopePath,
+          defaultAppDir: identity?.repoAppDir,
           existingApps: []
         });
         if (!appResult) {
@@ -2447,10 +2403,8 @@ async function init(options = {}) {
           return 1;
         }
         runScaffold({
-          projectName: appResult.projectName,
-          organizationName: selectedWorkspaceName,
           sourceLocale: appResult.sourceLocale,
-          branchTriggers: appResult.branchTriggers
+          targetBranches: appResult.targetBranches
         });
         p5.outro("You're all set.");
         return 0;
@@ -2465,7 +2419,7 @@ async function init(options = {}) {
       defaultSourceLocale: "en",
       repoCanonical: identity?.repoCanonical,
       defaultBranches: ["main"],
-      defaultScopePath: identity?.repoScopePath
+      defaultAppDir: identity?.repoAppDir
     });
     if (!projectResult) {
       p5.log.error("Project creation failed. Run `vocoder init` again.");
@@ -2484,10 +2438,8 @@ Translations won't run automatically until you grant access.
       );
     }
     runScaffold({
-      projectName: projectResult.projectName,
-      organizationName: selectedWorkspaceName,
       sourceLocale: projectResult.sourceLocale,
-      branchTriggers: projectResult.branchTriggers
+      targetBranches: projectResult.targetBranches
     });
     printMcpSetup(projectResult.apiKey);
     p5.outro("You're all set.");
@@ -2606,8 +2558,11 @@ function validateLocalConfig(config) {
   if (!config.apiKey || config.apiKey.length === 0) {
     throw new Error("VOCODER_API_KEY is required. Set it in your .env file.");
   }
-  if (!config.apiKey.startsWith("vc_")) {
-    throw new Error("Invalid API key format. Expected format: vc_...");
+  if (!config.apiKey.startsWith("vcp_")) {
+    if (config.apiKey.startsWith("vco_") || config.apiKey.startsWith("vcu_")) {
+      throw new Error("VOCODER_API_KEY must be a project-scoped key (starts with vcp_). Got an org or user key.");
+    }
+    throw new Error("Invalid API key format. Expected a project API key starting with vcp_.");
   }
   if (!config.apiUrl || !config.apiUrl.startsWith("http")) {
     throw new Error("Invalid API URL");
@@ -2615,7 +2570,7 @@ function validateLocalConfig(config) {
 }
 async function getMergedConfig(cliOptions, verbose = false, _startDir) {
   const configSources = {
-    extractionPattern: "default",
+    includePattern: "default",
     excludePattern: "default",
     apiKey: "environment",
     apiUrl: "default",
@@ -2624,29 +2579,53 @@ async function getMergedConfig(cliOptions, verbose = false, _startDir) {
     noFallback: "default"
   };
   const defaults = {
-    extractionPattern: ["src/**/*.{tsx,jsx,ts,js}"],
-    excludePattern: [],
+    includePattern: ["**/*.{tsx,jsx,ts,js}"],
+    excludePattern: [
+      "**/node_modules/**",
+      "**/.next/**",
+      "**/.nuxt/**",
+      "**/.svelte-kit/**",
+      "**/.output/**",
+      "**/dist/**",
+      "**/build/**",
+      "**/out/**",
+      "**/.vite/**",
+      "**/.turbo/**",
+      "**/coverage/**",
+      "**/.cache/**",
+      "**/*.min.js",
+      "**/*.min.ts",
+      "**/__generated__/**",
+      "**/*.test.*",
+      "**/*.spec.*",
+      "**/*.stories.*",
+      "**/__tests__/**"
+    ],
     apiUrl: "https://vocoder.app"
   };
-  const envExtractionPattern = process.env.VOCODER_EXTRACTION_PATTERN;
+  const envExtractionPattern = process.env.VOCODER_INCLUDE_PATTERN;
+  const envExcludePattern = process.env.VOCODER_EXCLUDE_PATTERN;
   const envApiUrl = process.env.VOCODER_API_URL;
   const envSyncMode = process.env.VOCODER_SYNC_MODE;
   const envSyncMaxWaitMs = process.env.VOCODER_SYNC_MAX_WAIT_MS;
   const envSyncNoFallback = process.env.VOCODER_SYNC_NO_FALLBACK;
-  let extractionPattern;
+  let includePattern;
   if (cliOptions.include && cliOptions.include.length > 0) {
-    extractionPattern = cliOptions.include;
-    configSources.extractionPattern = "CLI flag";
+    includePattern = cliOptions.include;
+    configSources.includePattern = "CLI flag";
   } else if (envExtractionPattern) {
-    extractionPattern = [envExtractionPattern];
-    configSources.extractionPattern = "environment";
+    includePattern = [envExtractionPattern];
+    configSources.includePattern = "environment";
   } else {
-    extractionPattern = defaults.extractionPattern;
+    includePattern = defaults.includePattern;
   }
   let excludePattern;
   if (cliOptions.exclude && cliOptions.exclude.length > 0) {
     excludePattern = cliOptions.exclude;
     configSources.excludePattern = "CLI flag";
+  } else if (envExcludePattern) {
+    excludePattern = envExcludePattern.split(",").map((p9) => p9.trim()).filter(Boolean);
+    configSources.excludePattern = "environment";
   } else {
     excludePattern = defaults.excludePattern;
   }
@@ -2692,7 +2671,7 @@ async function getMergedConfig(cliOptions, verbose = false, _startDir) {
   }
   if (verbose) {
     console.log(chalk7.dim("\n   Configuration sources:"));
-    console.log(chalk7.dim(`     Include patterns: ${configSources.extractionPattern}`));
+    console.log(chalk7.dim(`     Include patterns: ${configSources.includePattern}`));
     if (excludePattern.length > 0) {
       console.log(chalk7.dim(`     Exclude patterns: ${configSources.excludePattern}`));
     }
@@ -2707,7 +2686,7 @@ async function getMergedConfig(cliOptions, verbose = false, _startDir) {
 `));
   }
   return {
-    extractionPattern,
+    includePattern,
     excludePattern,
     apiKey,
     apiUrl,
@@ -2721,6 +2700,20 @@ async function getMergedConfig(cliOptions, verbose = false, _startDir) {
 // src/commands/sync.ts
 import chalk8 from "chalk";
 import { join as join2 } from "path";
+function computeStringsHash(texts) {
+  const sorted = [...texts].sort();
+  return createHash("sha256").update(sorted.join("\0")).digest("hex").slice(0, 16);
+}
+function readCachedStringsHash(projectRoot, branch) {
+  const filePath = getCacheFilePath(projectRoot, branch);
+  if (!existsSync(filePath)) return null;
+  try {
+    const raw = JSON.parse(readFileSync2(filePath, "utf-8"));
+    if (isRecord(raw) && typeof raw.stringsHash === "string") return raw.stringsHash;
+  } catch {
+  }
+  return null;
+}
 function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -2765,10 +2758,8 @@ function parseTranslations(value) {
   return Object.keys(translations).length > 0 ? translations : null;
 }
 function getCacheFilePath(projectRoot, branch) {
-  const slug = branch.replace(/[^a-zA-Z0-9._-]+/g, "_").replace(/^_+|_+$/g, "").slice(0, 40);
   const branchHash = createHash("sha1").update(branch).digest("hex").slice(0, 12);
-  const filename = `${slug || "branch"}-${branchHash}.json`;
-  return join2(projectRoot, "node_modules", ".vocoder", "cache", "sync", filename);
+  return join2(projectRoot, "node_modules", ".vocoder", "cache", "sync", `${branchHash}.json`);
 }
 function readLocalSnapshotCache(params) {
   const candidateBranches = params.branch === "main" ? ["main"] : [params.branch, "main"];
@@ -2813,6 +2804,7 @@ function writeLocalSnapshotCache(params) {
     sourceLocale: params.sourceLocale,
     targetLocales: params.targetLocales,
     savedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    ...params.stringsHash ? { stringsHash: params.stringsHash } : {},
     ...params.snapshotBatchId ? { snapshotBatchId: params.snapshotBatchId } : {},
     ...params.completedAt ? { completedAt: params.completedAt } : {},
     ...params.localeMetadata ? { localeMetadata: params.localeMetadata } : {},
@@ -2994,7 +2986,7 @@ async function sync(options = {}) {
     const config = {
       ...localConfig,
       ...apiConfig,
-      extractionPattern: mergedConfig.extractionPattern,
+      includePattern: mergedConfig.includePattern,
       excludePattern: mergedConfig.excludePattern,
       timeout: waitTimeoutMs
     };
@@ -3008,11 +3000,11 @@ async function sync(options = {}) {
       p7.outro("");
       return 0;
     }
-    const patternsDisplay = Array.isArray(config.extractionPattern) ? config.extractionPattern.join(", ") : config.extractionPattern;
+    const patternsDisplay = Array.isArray(config.includePattern) ? config.includePattern.join(", ") : config.includePattern;
     spinner4.start(`Extracting strings from ${patternsDisplay}`);
     const extractor = new StringExtractor();
     const extractedStrings = await extractor.extractFromProject(
-      config.extractionPattern,
+      config.includePattern,
       projectRoot,
       config.excludePattern
     );
@@ -3053,6 +3045,7 @@ async function sync(options = {}) {
         "Could not detect git remote origin. Sync will continue without repo metadata."
       );
     }
+    const commitSha = detectCommitSha() ?? void 0;
     const stringEntries = buildStringEntries(extractedStrings);
     const sourceStrings = stringEntries.map((entry) => entry.text);
     if (options.verbose && stringEntries.length !== extractedStrings.length) {
@@ -3060,6 +3053,15 @@ async function sync(options = {}) {
         `Deduped ${extractedStrings.length} extracted entries into ${stringEntries.length} unique source strings`
       );
     }
+    const currentHash = computeStringsHash(sourceStrings);
+    if (!options.force) {
+      const cachedHash = readCachedStringsHash(projectRoot, branch);
+      if (cachedHash && cachedHash === currentHash) {
+        const duration2 = ((Date.now() - startTime) / 1e3).toFixed(1);
+        p7.outro(`Up to date (${duration2}s)`);
+        return 0;
+      }
+    }
     spinner4.start("Submitting strings to Vocoder API");
     const batchResponse = await api.submitTranslation(
       branch,
@@ -3070,7 +3072,7 @@ async function sync(options = {}) {
         requestedMaxWaitMs: waitTimeoutMs,
         clientRunId: randomUUID()
       },
-      repoIdentity ?? void 0
+      repoIdentity ? { ...repoIdentity, commitSha } : { commitSha }
     );
     spinner4.stop(`Submitted to API - Batch ${chalk8.cyan(batchResponse.batchId)}`);
     const effectiveMode = batchResponse.effectiveMode ?? resolveEffectiveModeFromPolicy({
@@ -3204,6 +3206,7 @@ async function sync(options = {}) {
         targetLocales: config.targetLocales,
         translations: finalTranslations,
         localeMetadata: artifacts.localeMetadata,
+        stringsHash: currentHash,
         snapshotBatchId: artifacts.snapshotBatchId ?? (artifacts.source === "fresh" ? batchResponse.batchId : batchResponse.latestCompletedBatchId),
         completedAt: artifacts.completedAt ?? (artifacts.source === "fresh" ? (/* @__PURE__ */ new Date()).toISOString() : null)
       });
@@ -3224,8 +3227,6 @@ async function sync(options = {}) {
     }
     const duration = ((Date.now() - startTime) / 1e3).toFixed(1);
     p7.outro(`Sync complete! (${duration}s)`);
-    p7.log.info("Translations will be injected at build time by @vocoder/unplugin.");
-    p7.log.info("Just use <VocoderProvider> and <T> \u2014 no manual imports needed.");
     return 0;
   } catch (error) {
     spinner4.stop();