@superblocksteam/cli 2.0.134 → 2.0.135-next.0

package/dist/{chunk-H4HAQESR.js → chunk-OBQUU6BG.js}

@@ -1,7 +1,7 @@
 if (typeof process === 'object' && process !== null &&
     process.env !== null && typeof process.env === 'object') {
   process.env.DD_GIT_REPOSITORY_URL = 'https://token@github.com/superblocksteam/superblocks.git';
-  process.env.DD_GIT_COMMIT_SHA = 'f1e28f1ffabe82d8faef07ae41298e89d369d0a5';
+  process.env.DD_GIT_COMMIT_SHA = '0698150a5909319509502a0f41058c2df69b3cb5';
 }
 import { createRequire as $dd_createRequire } from 'module';
 import { fileURLToPath as $dd_fileURLToPath } from 'url';
@@ -22,17 +22,17 @@ import {
   require_re,
   require_semver,
   require_valid
-} from "./chunk-3SGXR37R.js";
+} from "./chunk-VLL6QFNR.js";
 import {
   require_dd_trace,
   require_js_yaml,
   require_module_details_from_path,
   require_p_limit,
   require_path_to_regexp
-} from "./chunk-PGX6ZHPJ.js";
+} from "./chunk-2XPGZHLV.js";
 import {
   require_commonjs
-} from "./chunk-REIRMAMQ.js";
+} from "./chunk-VEWZVPCI.js";
 import {
   debounce_default,
   get_default,
@@ -49,13 +49,13 @@ import {
   require_lib,
   require_slugify,
   throttle_default
-} from "./chunk-S2F4DAWG.js";
+} from "./chunk-UALYBXO2.js";
 import {
   require_dc_polyfill
-} from "./chunk-5SRBYGF3.js";
+} from "./chunk-R3B5NAVP.js";
 import {
   require_token_error
-} from "./chunk-62LRAQPC.js";
+} from "./chunk-GHZXP4GM.js";
 import {
   SpanKind,
   SpanStatusCode,
@@ -65,7 +65,7 @@ import {
   init_esm,
   metrics,
   trace
-} from "./chunk-FM7X5MER.js";
+} from "./chunk-BGSL7UBB.js";
 import {
   __commonJS,
   __esm,
@@ -74,7 +74,7 @@ import {
   __toCommonJS,
   __toESM,
   init_cjs_shims
-} from "./chunk-25OBWKP5.js";
+} from "./chunk-V5S5Y76E.js";
 
 // ../../../../node_modules/.pnpm/semver@7.7.4/node_modules/semver/internal/constants.js
 var require_constants3 = __commonJS({
@@ -97080,15 +97080,15 @@ var require_api_files = __commonJS({
     exports.readAppApiYamlFile = readAppApiYamlFile4;
     exports.resolveLanguageSpecificStepContentFromBlocks = resolveLanguageSpecificStepContentFromBlocks2;
     async function writeApiFiles3(...args) {
-      const esmFunction = await import("./api-HT7CPXTG.js");
+      const esmFunction = await import("./api-T2ZXIA6D.js");
       return esmFunction.writeApiFiles(...args);
     }
     async function readAppApiYamlFile4(...args) {
-      const esmFunction = await import("./api-HT7CPXTG.js");
+      const esmFunction = await import("./api-T2ZXIA6D.js");
       return esmFunction.readAppApiYamlFile(...args);
     }
     async function resolveLanguageSpecificStepContentFromBlocks2(...args) {
-      const esmFunction = await import("./api-HT7CPXTG.js");
+      const esmFunction = await import("./api-T2ZXIA6D.js");
       return esmFunction.resolveLanguageSpecificStepContentFromBlocks(...args);
     }
   }
@@ -106720,19 +106720,19 @@ var require_getMachineId = __commonJS({
       if (!getMachineIdImpl) {
         switch (process5.platform) {
           case "darwin":
-            getMachineIdImpl = (await import("./getMachineId-darwin-PN2SN7VN.js")).getMachineId;
+            getMachineIdImpl = (await import("./getMachineId-darwin-CLFWZYDC.js")).getMachineId;
             break;
           case "linux":
-            getMachineIdImpl = (await import("./getMachineId-linux-TZ627TIM.js")).getMachineId;
+            getMachineIdImpl = (await import("./getMachineId-linux-PGL6BQXC.js")).getMachineId;
             break;
           case "freebsd":
-            getMachineIdImpl = (await import("./getMachineId-bsd-GYXQKOBJ.js")).getMachineId;
+            getMachineIdImpl = (await import("./getMachineId-bsd-ZL7Z7V27.js")).getMachineId;
             break;
           case "win32":
-            getMachineIdImpl = (await import("./getMachineId-win-QYFUIFS4.js")).getMachineId;
+            getMachineIdImpl = (await import("./getMachineId-win-MHRL7M2O.js")).getMachineId;
             break;
           default:
-            getMachineIdImpl = (await import("./getMachineId-unsupported-VILNHYLA.js")).getMachineId;
+            getMachineIdImpl = (await import("./getMachineId-unsupported-ETORG73H.js")).getMachineId;
             break;
         }
       }
@@ -115724,19 +115724,19 @@ var require_getMachineId2 = __commonJS({
       if (!getMachineIdImpl) {
         switch (process5.platform) {
           case "darwin":
-            getMachineIdImpl = (await import("./getMachineId-darwin-LF7QM4KL.js")).getMachineId;
+            getMachineIdImpl = (await import("./getMachineId-darwin-ETIUPQ7N.js")).getMachineId;
             break;
           case "linux":
-            getMachineIdImpl = (await import("./getMachineId-linux-DVMBH6J6.js")).getMachineId;
+            getMachineIdImpl = (await import("./getMachineId-linux-LTAT2RSO.js")).getMachineId;
             break;
           case "freebsd":
-            getMachineIdImpl = (await import("./getMachineId-bsd-QI6QDMKP.js")).getMachineId;
+            getMachineIdImpl = (await import("./getMachineId-bsd-C7POTNYV.js")).getMachineId;
             break;
           case "win32":
-            getMachineIdImpl = (await import("./getMachineId-win-5H2EYTLZ.js")).getMachineId;
+            getMachineIdImpl = (await import("./getMachineId-win-ZYK5QKY7.js")).getMachineId;
             break;
           default:
-            getMachineIdImpl = (await import("./getMachineId-unsupported-ML2ZR42I.js")).getMachineId;
+            getMachineIdImpl = (await import("./getMachineId-unsupported-U7JX2S3K.js")).getMachineId;
             break;
         }
       }
@@ -197609,8 +197609,8 @@ var require_get_vercel_oidc_token = __commonJS({
       }
       try {
         const [{ getTokenPayload, isExpired }, { refreshToken }] = await Promise.all([
-          await import("./token-util-2IWUSPWM.js"),
-          await import("./token-BZKN4KET.js")
+          await import("./token-util-FUCX4UTS.js"),
+          await import("./token-BTAJIBV7.js")
         ]);
         if (!token2 || isExpired(getTokenPayload(token2))) {
           await refreshToken();
@@ -453001,7 +453001,7 @@ var require_config_loader = __commonJS({
        * @returns {Promise<{createJiti: Function|undefined, version: string;}>} A promise that fulfills with an object containing the jiti module's createJiti function and version.
        */
       static async loadJiti() {
-        const { createJiti } = await import("./jiti-R62X263L.js");
+        const { createJiti } = await import("./jiti-6TZEY4YV.js");
         const version4 = require_package5().version;
         return { createJiti, version: version4 };
       }
@@ -453330,7 +453330,7 @@ var require_eslint_helpers = __commonJS({
     }
     async function globMatch({ basePath, pattern }) {
       let found = false;
-      const { hfs } = await import("./src-S6KG5MYY.js");
+      const { hfs } = await import("./src-2VDGLEGZ.js");
       const patternToUse = normalizeToPosix(path80.relative(basePath, pattern));
       const matcher = new Minimatch2(patternToUse, MINIMATCH_OPTIONS);
       const walkSettings = {
@@ -453370,7 +453370,7 @@ var require_eslint_helpers = __commonJS({
         return new Minimatch2(patternToUse, MINIMATCH_OPTIONS);
       });
       const unmatchedPatterns = /* @__PURE__ */ new Set([...relativeToPatterns.keys()]);
-      const { hfs } = await import("./src-S6KG5MYY.js");
+      const { hfs } = await import("./src-2VDGLEGZ.js");
       const walk2 = hfs.walk(basePath, {
         async directoryFilter(entry) {
           if (!matchers.some((matcher) => matcher.match(entry.path, true))) {
@@ -509993,7 +509993,7 @@ init_cjs_shims();
 // ../sdk/package.json
 var package_default = {
   name: "@superblocksteam/sdk",
-  version: "2.0.134",
+  version: "2.0.135-next.0",
   description: "Superblocks JS SDK",
   homepage: "https://www.superblocks.com",
   license: "Superblocks Community Software License",
@@ -510371,7 +510371,7 @@ var config = void 0;
 var configured = false;
 var ddTracePromise = void 0;
 async function getDdTrace() {
-  ddTracePromise ??= import("./dd-trace-L65VOLLO.js").then((module) => module.default);
+  ddTracePromise ??= import("./dd-trace-BILJGAUU.js").then((module) => module.default);
   return await ddTracePromise;
 }
 var deploymentType = (() => {
@@ -514823,7 +514823,7 @@ init_cjs_shims();
 
 // ../../../vite-plugin-file-sync/dist/ai-service/index.js
 init_cjs_shims();
-var import_ai17 = __toESM(require_dist9(), 1);
+var import_ai17 = __toESM(require_dist9());
 import { createHash as createHash5, randomUUID as randomUUID5 } from "node:crypto";
 import os6 from "node:os";
 import path51 from "node:path";
@@ -519262,7 +519262,7 @@ init_cjs_shims();
 init_cjs_shims();
 
 // ../../../vite-plugin-file-sync/dist/ai-service/index.js
-var import_shared52 = __toESM(require_dist2(), 1);
+var import_shared52 = __toESM(require_dist2());
 
 // ../../../vite-plugin-file-sync/dist/migration/translation-prompt.js
 init_cjs_shims();
@@ -536633,7 +536633,7 @@ var MAX_ATTRIBUTE_LENGTH = 64e3;
 var LLMObsSpanWriter = null;
 async function loadLLMObsSpanWriter() {
   if (!LLMObsSpanWriter) {
-    const module = await import("./spans-QT56OO5L.js");
+    const module = await import("./spans-PYEDPYFC.js");
     LLMObsSpanWriter = module.default;
   }
   return LLMObsSpanWriter;
@@ -545626,20 +545626,14 @@ function assertApiMigrationItemCanComplete(item) {
 // ../../../vite-plugin-file-sync/dist/ai-service/checklist/persisted-checklist-store.js
 var PERSISTED_CHECKLIST_VERSION = 1;
 var PERSISTED_CHECKLIST_RELATIVE_PATH = CHECKLIST_PERSISTED_RELATIVE_PATH;
-function hasPendingApiMigrationItems(state) {
-  if (!state) {
-    return false;
-  }
-  return state.items.some((item) => isApiMigrationOrigin(item.origin) && (item.status === "pending" || item.status === "in_progress"));
-}
-function isApiMigrationChecklistActive(state) {
+function isV2ToV3MigrationInProgress(state) {
   if (!state) {
     return false;
   }
   if (state.overallStatus === "completed") {
     return false;
   }
-  return hasPendingApiMigrationItems(state);
+  return state.items.some((item) => isApiMigrationOrigin(item.origin));
 }
 var mutationQueues = /* @__PURE__ */ new Map();
 function getMutationQueue(appRootDirPath) {
@@ -547294,6 +547288,30 @@ var McpToolAdapter = class {
   }
 };
 
+// ../../../vite-plugin-file-sync/dist/ai-service/migration-prompt-gating.js
+init_cjs_shims();
+function resolveMigrationPromptGating(input) {
+  const { thirdPartyImportEnabled, v2ToV3MigrationInProgress } = input;
+  return {
+    registerRunMigrationVerification: v2ToV3MigrationInProgress,
+    registerSpawnCodingSubagents: v2ToV3MigrationInProgress || thirdPartyImportEnabled,
+    spawnCodingSubagentsUsesMigrationDescription: v2ToV3MigrationInProgress
+  };
+}
+function buildSystemSkillExclusions(args) {
+  const excludeSkills = [];
+  if (args.sdkApiEnabled) {
+    excludeSkills.push("superblocks-api");
+  }
+  if (!args.thirdPartyImportEnabled) {
+    excludeSkills.push("third-party-migration");
+  }
+  if (!args.v2ToV3MigrationInProgress) {
+    excludeSkills.push("superblocks-migration");
+  }
+  return excludeSkills;
+}
+
 // ../../../vite-plugin-file-sync/dist/ai-service/profiler/tool-profiler.js
 init_cjs_shims();
 
@@ -578661,23 +578679,30 @@ async function runCodingSubagent(args) {
 var MAX_CONCURRENCY2 = 5;
 var MAX_SUBAGENTS = MAX_CONCURRENCY2;
 var TOOL_EXECUTION_TIMEOUT_MS4 = 60 * 60 * 1e3;
-var spawnCodingSubagentsToolFactory = createToolFactory("spawnCodingSubagents", ({ clark, services }) => {
-  const logger23 = getLogger3();
-  return {
-    description: `
+function buildSpawnCodingSubagentsDescription(v2ToV3MigrationInProgress) {
+  const exampleWork = v2ToV3MigrationInProgress ? "e.g. migrating 20 APIs" : "e.g. porting many files in parallel";
+  const checklistSharing = v2ToV3MigrationInProgress ? "- Shares the migration checklist with every other sub-agent and the main\n  agent \u2014 all writes are serialized automatically" : "- Shares the on-disk checklist with every other sub-agent and the main\n  agent when one exists \u2014 all writes are serialized automatically";
+  const availability = v2ToV3MigrationInProgress ? `**Only available during an active migration**: either a v2 \u2192 v3
+migration (migration checklist already present on disk) or a
+third-party app migration (Replit / Lovable / v0 / Next.js \u2014 gated on
+the third-party-import feature flag). Outside of a migration, calling
+this tool will error.` : `**Only available during an active third-party app import**
+(Replit / Lovable / v0 / Next.js \u2014 gated on the third-party-import
+feature flag). Outside of that context, calling this tool will error.`;
+  return `
 Spawn a batch of coding sub-agents in parallel to complete a focused,
 partitioned set of coding tasks. Useful when you have many independent
-chunks of work (e.g. migrating 20 APIs) and want to fan them out.
+chunks of work (${exampleWork}) and want to fan them out.
 
 **CRITICAL \u2014 call this tool ALONE:**
 - This MUST be the ONLY tool call in your assistant turn. Do NOT emit
   any other tool calls alongside it (no file reads, no file writes, no
   checklist updates, nothing). If you do, the main agent and the
   sub-agents will race each other on the shared checklist and corrupt
-  the migration state.
+  shared state.
 - This tool BLOCKS until every spawned sub-agent has finished. Do NOT
-  start doing migration work yourself while waiting \u2014 there is no
-  "waiting"; your next turn only happens after the tool returns.
+  start parallel work yourself while waiting \u2014 there is no "waiting";
+  your next turn only happens after the tool returns.
 - Only after the tool returns may you read the checklist and handle any
   \`failed\` items.
 
@@ -578686,8 +578711,7 @@ Each sub-agent:
 - Gets only the \`instructions\` string you provide as its task
 - Has access to file-edit, file-read, and \`build_manageChecklist\` tools
 - CANNOT spawn further sub-agents, run tests, or run git operations
-- Shares the migration checklist with every other sub-agent and the main
-  agent \u2014 all writes are serialized automatically
+${checklistSharing}
 
 You MUST partition the work yourself: each sub-agent's instructions
 should name the exact items it owns. Do NOT spawn overlapping batches.
@@ -578695,12 +578719,19 @@ should name the exact items it owns. Do NOT spawn overlapping batches.
 The return value summarizes per-sub-agent completion. Read the shared
 checklist to see which items succeeded / failed.
 
-**Only available during an active migration**: either a v2 \u2192 v3
-migration (migration checklist already present on disk) or a
-third-party app migration (Replit / Lovable / v0 / Next.js \u2014 gated on
-the third-party-import feature flag). Outside of a migration, calling
-this tool will error.
-`,
+${availability}
+`;
+}
+function buildSpawnCodingSubagentsApiNamesFieldDescription(v2ToV3MigrationInProgress) {
+  if (v2ToV3MigrationInProgress) {
+    return "Optional list of API names this sub-agent owns. When provided during a v2 \u2192 v3 migration, the spawn tool stamps each `api_<name>` checklist item with this sub-agent's `id` as `workerId` BEFORE fan-out, which lets the migration UI render one batch row per sub-agent in the chat sidebar checklist. Pass the SAME apiNames you list in the sub-agent's instructions.";
+  }
+  return "Optional list of checklist item names this sub-agent owns. Pass the SAME names you list in the sub-agent's instructions.";
+}
+var spawnCodingSubagentsToolFactory = createToolFactory("spawnCodingSubagents", ({ clark, services, v2ToV3MigrationInProgress }) => {
+  const logger23 = getLogger3();
+  return {
+    description: buildSpawnCodingSubagentsDescription(v2ToV3MigrationInProgress),
     // ToolCategory.SUBAGENT is restricted to MAIN in access-control.ts's
     // subagentCategoryMapping — this is what prevents coding sub-agents
     // from recursively spawning more sub-agents.
@@ -578712,12 +578743,13 @@ this tool will error.
       subagents: external_exports.array(external_exports.object({
         id: external_exports.string().min(1).describe("Short, unique label for this sub-agent (e.g. 'worker-1'). Used for logging and the sub-agent's own identification."),
         instructions: external_exports.string().min(1).describe("The complete task for this sub-agent. MUST include the exact list of items (e.g. API names) this sub-agent owns, plus any procedural guidance the sub-agent needs. The sub-agent receives this and nothing else \u2014 it does not see the main chat history."),
-        apiNames: external_exports.array(external_exports.string().min(1)).optional().describe("Optional list of API names this sub-agent owns. When provided during a v2 \u2192 v3 migration, the spawn tool stamps each `api_<name>` checklist item with this sub-agent's `id` as `workerId` BEFORE fan-out, which lets the migration UI render one batch row per sub-agent in the chat sidebar checklist. Pass the SAME apiNames you list in the sub-agent's instructions.")
+        apiNames: external_exports.array(external_exports.string().min(1)).optional().describe(buildSpawnCodingSubagentsApiNamesFieldDescription(v2ToV3MigrationInProgress))
       })).min(1).max(MAX_SUBAGENTS).describe(`Array of sub-agents to spawn (max ${MAX_SUBAGENTS}). Each runs in parallel.`),
       maxStepsPerSubagent: external_exports.number().int().positive().max(200).optional().describe("Optional cap on streaming steps per sub-agent. Defaults to 80.")
     }),
     execute: async ({ subagents, maxStepsPerSubagent }, options8) => {
-      const inMigration = isApiMigrationChecklistActive(await readPersistedChecklist(services.appRootDirPath));
+      const checklist = await readPersistedChecklist(services.appRootDirPath);
+      const inMigration = isV2ToV3MigrationInProgress(checklist);
       const thirdPartyImportEnabled = services.features?.thirdPartyImportEnabled === true;
       if (!inMigration && !thirdPartyImportEnabled) {
         throw new Error("spawnCodingSubagents is only available during an active migration (no migration checklist found and third-party import is not enabled).");
@@ -602599,6 +602631,20 @@ var buildTools = async (clark, services) => {
   const scopeUpdateQueue = new OperationQueue();
   const sendUserMessage = sendUserMessageChannel(clark, services.chatSessionStore);
   const disabledTools = clark.context.llmConfig?.disabledTools;
+  const checklist = await readPersistedChecklist(services.appRootDirPath);
+  const v2ToV3MigrationInProgress = isV2ToV3MigrationInProgress(checklist);
+  const thirdPartyImportEnabled = services.features?.thirdPartyImportEnabled === true;
+  const migrationPromptGating = resolveMigrationPromptGating({
+    thirdPartyImportEnabled,
+    v2ToV3MigrationInProgress
+  });
+  clark.logger.info("[buildTools] migration prompt gating", {
+    registerRunMigrationVerification: migrationPromptGating.registerRunMigrationVerification,
+    registerSpawnCodingSubagents: migrationPromptGating.registerSpawnCodingSubagents,
+    spawnCodingSubagentsUsesMigrationDescription: migrationPromptGating.spawnCodingSubagentsUsesMigrationDescription,
+    thirdPartyImportEnabled,
+    v2ToV3MigrationInProgress
+  });
   const registry2 = services.toolRegistry;
   registry2.setLogger(clark.logger);
   const MIDDLEWARE_STACK_STATE_KEY = Symbol("tool.middleware.stack.state");
@@ -602731,9 +602777,11 @@ var buildTools = async (clark, services) => {
   registry2.addAccessRule(forTools("testApi", async (_tool, _context, input) => {
     return checkTestApiPermissions(services, input, clark);
   }));
-  registry2.addAccessRule(forTools("runMigrationVerification", async (_tool, _context, input) => {
-    return checkRunMigrationVerificationPermissions(services, input);
-  }));
+  if (migrationPromptGating.registerRunMigrationVerification) {
+    registry2.addAccessRule(forTools("runMigrationVerification", async (_tool, _context, input) => {
+      return checkRunMigrationVerificationPermissions(services, input);
+    }));
+  }
   registry2.addAccessRule(forTools("build_deleteFile", async (_tool, _context, input) => {
     return checkDeleteFilePermissions(input);
   }));
@@ -602755,8 +602803,16 @@ var buildTools = async (clark, services) => {
   registry2.register(buildNavigatePreviewToolFactory, { clark, services });
   registry2.register(buildFinalizeToolFactory, { clark, services });
   registry2.register(buildManageChecklistToolFactory, { clark, services });
-  registry2.register(migrationVerificationToolFactory, { clark, services });
-  registry2.register(spawnCodingSubagentsToolFactory, { clark, services });
+  if (migrationPromptGating.registerRunMigrationVerification) {
+    registry2.register(migrationVerificationToolFactory, { clark, services });
+  }
+  if (migrationPromptGating.registerSpawnCodingSubagents) {
+    registry2.register(spawnCodingSubagentsToolFactory, {
+      clark,
+      services,
+      v2ToV3MigrationInProgress: migrationPromptGating.spawnCodingSubagentsUsesMigrationDescription
+    });
+  }
   registry2.register(buildDeleteFileToolFactory, { clark, services });
   registry2.register(buildRenameFileToolFactory, { clark, services });
   registry2.register(buildReloadFileToolFactory, { clark, services });
@@ -630251,7 +630307,7 @@ var PlaywrightMcpServerManager = class {
       this.logger.info(`Starting embedded Playwright MCP server: browser=${options8?.browser || "chromium"}, headless=${options8?.headless !== false}`);
     }
     try {
-      const { startEmbeddedPlaywrightMcpServer } = await import("./embedded-playwright-mcp-server-22VZWGRR.js");
+      const { startEmbeddedPlaywrightMcpServer } = await import("./embedded-playwright-mcp-server-7TWBAR4R.js");
       this.server = await startEmbeddedPlaywrightMcpServer({
         storageStatePath: options8?.storageStatePath,
         jwt: options8?.jwt,
@@ -633350,7 +633406,7 @@ export type ApiRegistry = typeof apis;
 
 // ../../../vite-plugin-file-sync/dist/ai-service/agent/prompts/build-base-system-prompt.js
 var logger18 = getPrefixedLogger("[build-base-system-prompt]");
-var buildBaseSystemPrompt = (config4, mode, factsSection, appKnowledgeSection, onDemandKnowledgeIndex, registryPolicy) => {
+var buildBaseSystemPrompt = (config4, mode, factsSection, appKnowledgeSection, onDemandKnowledgeIndex, registryPolicy, v2ToV3MigrationInProgress = false) => {
   const superblocksDocsGuidance = config4.features.superblocksDocsMcpEnabled ? "For Superblocks product documentation, use the `search_superblocks_docs` tool first for setup, integration, and platform behavior questions. If the docs MCP result is missing or incomplete, then use `web_fetch` against `https://docs.superblocks.com` and, if needed, discover pages via `https://docs.superblocks.com/sitemap.xml`.\nWhen referring to Superblocks pages in your response, always include relative links: [Integrations](/integrations) for the integrations page, or [Integration Name](/integrations/{slug}) for a specific integration (e.g., [Salesforce](/integrations/salesforce), [PostgreSQL](/integrations/postgres))." : "For Superblocks product documentation, prefer `https://docs.superblocks.com` as the primary source. If you need to discover the right page first, use the sitemap at `https://docs.superblocks.com/sitemap.xml`, then fetch the specific docs page you need.";
   let preamble = "";
   if (mode !== void 0) {
@@ -633435,7 +633491,7 @@ If the user asks about committing, deploying, publishing, or version-controlling
   const thirdPartyImportEnabled = config4.features.thirdPartyImportEnabled ?? false;
   const currentDate = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
   const useSkills = config4.features.useSystemSkills;
-  const skillsGuidance = useSkills ? buildSkillsSystemGuidance(sdkApiEnabled, thirdPartyImportEnabled) : null;
+  const skillsGuidance = useSkills ? buildSkillsSystemGuidance(sdkApiEnabled, thirdPartyImportEnabled, v2ToV3MigrationInProgress) : null;
   const skillsLoaded = skillsGuidance !== null;
   const detailedGuidance = skillsLoaded ? "" : buildDetailedGuidanceSections(sdkApiEnabled);
   logger18.info("Building system prompt with knowledge sections", {
@@ -633646,15 +633702,13 @@ function buildKnowledgeBlock(factsSection, appKnowledgeSection) {
   }
   return block;
 }
-function buildSkillsSystemGuidance(sdkApiEnabled, thirdPartyImportEnabled) {
+function buildSkillsSystemGuidance(sdkApiEnabled, thirdPartyImportEnabled, v2ToV3MigrationInProgress) {
   try {
-    const excludeSkills = [];
-    if (sdkApiEnabled) {
-      excludeSkills.push("superblocks-api");
-    }
-    if (!thirdPartyImportEnabled) {
-      excludeSkills.push("third-party-migration");
-    }
+    const excludeSkills = buildSystemSkillExclusions({
+      sdkApiEnabled,
+      thirdPartyImportEnabled,
+      v2ToV3MigrationInProgress
+    });
     const skillsXml = generateSkillsXml(excludeSkills.length > 0 ? { excludeSkills } : void 0);
     if (skillsXml === null) {
       logger18.warn("No system skills found, falling back to detailed guidance sections");
@@ -635194,7 +635248,9 @@ var doLLMGenerating = (clark, services) => {
         } catch (err) {
           clark.logger.warn("[llm-generating] Failed to resolve registry policy (non-blocking)", getErrorMeta2(err));
         }
-        const system = buildBaseSystemPrompt(services, mode, knowledgeSections.systemPromptSection, appKnowledgeSection, knowledgeSections.onDemandSkillIndex, registryPolicy);
+        const migrationChecklist = await readPersistedChecklist(services.appRootDirPath);
+        const v2ToV3MigrationInProgress = isV2ToV3MigrationInProgress(migrationChecklist);
+        const system = buildBaseSystemPrompt(services, mode, knowledgeSections.systemPromptSection, appKnowledgeSection, knowledgeSections.onDemandSkillIndex, registryPolicy, v2ToV3MigrationInProgress);
         void services.logger.info("[llm-generating] System prompt:", {
           systemPromptLength: system.length
         });
@@ -640721,9 +640777,9 @@ ${request.prompt}`;
 // ../../../vite-plugin-file-sync/dist/sync-service/index.js
 init_cjs_shims();
 import { normalizePath as normalizePath8 } from "vite";
-var import_shared58 = __toESM(require_dist2(), 1);
-var import_shared59 = __toESM(require_dist2(), 1);
-var import_shared60 = __toESM(require_dist2(), 1);
+var import_shared58 = __toESM(require_dist2());
+var import_shared59 = __toESM(require_dist2());
+var import_shared60 = __toESM(require_dist2());
 
 // ../../../vite-plugin-file-sync/dist/errors/make-server-error.js
 init_cjs_shims();
@@ -642344,8 +642400,8 @@ var SyncService = class extends import_shared58.TracedEventEmitter {
 
 // ../../../vite-plugin-file-sync/dist/lock-service/index.js
 init_cjs_shims();
-var import_shared61 = __toESM(require_dist2(), 1);
-var import_shared62 = __toESM(require_dist2(), 1);
+var import_shared61 = __toESM(require_dist2());
+var import_shared62 = __toESM(require_dist2());
 
 // ../../../vite-plugin-file-sync/dist/lock-service/activity-tracker.js
 init_cjs_shims();
@@ -667101,7 +667157,7 @@ var parseYaml3;
 async function loadYaml(file2) {
   const content18 = await read_file_default(file2);
   if (!parseYaml3) {
-    ({ __parsePrettierYamlConfig: parseYaml3 } = await import("./yaml-XF5BMURV.js"));
+    ({ __parsePrettierYamlConfig: parseYaml3 } = await import("./yaml-KCHVIIIX.js"));
   }
   try {
     return parseYaml3(content18);
@@ -672495,7 +672551,7 @@ function createParsersAndPrinters(modules) {
 }
 var estreePlugin = createParsersAndPrinters([
   {
-    importPlugin: () => import("./estree-HMI4CHDK.js"),
+    importPlugin: () => import("./estree-YBYR6B7X.js"),
     printers: ["estree", "estree-json"]
   }
 ]);
@@ -672519,11 +672575,11 @@ var languages = [
 ];
 var { parsers: parsers12, printers } = createParsersAndPrinters([
   {
-    importPlugin: () => import("./acorn-UMG4VA47.js"),
+    importPlugin: () => import("./acorn-AJMEZP4Q.js"),
     parsers: ["acorn", "espree"]
   },
   {
-    importPlugin: () => import("./angular-D4XQHYT2.js"),
+    importPlugin: () => import("./angular-MR7TH3M6.js"),
     parsers: [
       "__ng_action",
       "__ng_binding",
@@ -672532,7 +672588,7 @@ var { parsers: parsers12, printers } = createParsersAndPrinters([
     ]
   },
   {
-    importPlugin: () => import("./babel-WDJGVB4N.js"),
+    importPlugin: () => import("./babel-F3NTAAAI.js"),
     parsers: [
       "babel",
       "babel-flow",
@@ -672551,44 +672607,44 @@ var { parsers: parsers12, printers } = createParsersAndPrinters([
     ]
   },
   {
-    importPlugin: () => import("./flow-OLO2S5PW.js"),
+    importPlugin: () => import("./flow-VRVBLM3F.js"),
     parsers: ["flow"]
   },
   {
-    importPlugin: () => import("./glimmer-WNW2FLSA.js"),
+    importPlugin: () => import("./glimmer-GXE2PPNP.js"),
     parsers: ["glimmer"],
     printers: ["glimmer"]
   },
   {
-    importPlugin: () => import("./graphql-MCIZZQOV.js"),
+    importPlugin: () => import("./graphql-GPDNJX6I.js"),
     parsers: ["graphql"],
     printers: ["graphql"]
   },
   {
-    importPlugin: () => import("./html-CR4VVGRG.js"),
+    importPlugin: () => import("./html-HVT4IHD7.js"),
     parsers: ["html", "angular", "vue", "lwc", "mjml"],
     printers: ["html"]
   },
   {
-    importPlugin: () => import("./markdown-4X6BMQKN.js"),
+    importPlugin: () => import("./markdown-4RIEX3ET.js"),
     parsers: ["markdown", "mdx", "remark"],
     printers: ["mdast"]
   },
   {
-    importPlugin: () => import("./meriyah-RSR6D64Q.js"),
+    importPlugin: () => import("./meriyah-JYSNAGRZ.js"),
     parsers: ["meriyah"]
   },
   {
-    importPlugin: () => import("./postcss-GVAQTWMT.js"),
+    importPlugin: () => import("./postcss-37TXNAVX.js"),
     parsers: ["css", "less", "scss"],
     printers: ["postcss"]
   },
   {
-    importPlugin: () => import("./typescript-3EBAA4CI.js"),
+    importPlugin: () => import("./typescript-HCELV6WY.js"),
     parsers: ["typescript"]
   },
   {
-    importPlugin: () => import("./yaml-XF5BMURV.js"),
+    importPlugin: () => import("./yaml-KCHVIIIX.js"),
     parsers: ["yaml"],
     printers: ["yaml"]
   }
@@ -690751,7 +690807,7 @@ async function handleLockConflict(error40, lockSvc, span, logger23) {
 }
 async function readPkgJson(cwd) {
   try {
-    const { readPackage } = await import("./read-pkg-IY6DQWHB.js");
+    const { readPackage } = await import("./read-pkg-BGXWICCF.js");
     return await readPackage({ cwd });
   } catch {
     return null;
@@ -692543,4 +692599,4 @@ serve-static/index.js:
 chokidar/esm/index.js:
   (*! chokidar - MIT License (c) 2012 Paul Miller (paulmillr.com) *)
 */
-//# sourceMappingURL=chunk-H4HAQESR.js.map
+//# sourceMappingURL=chunk-OBQUU6BG.js.map