firebase-tools 15.10.0 → 15.10.1

package/lib/apphosting/utils.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getEnvironmentName = getEnvironmentName;
 exports.promptForAppHostingYaml = promptForAppHostingYaml;
+exports.getAutoinitEnvVars = getAutoinitEnvVars;
 const error_1 = require("../error");
 const config_1 = require("./config");
 const prompt = require("../prompt");
@@ -36,3 +37,16 @@ async function promptForAppHostingYaml(apphostingFileNameToPathMap, promptMessag
     });
     return fileToExportPath;
 }
+function getAutoinitEnvVars(webappConfig) {
+    if (!webappConfig) {
+        return {};
+    }
+    return {
+        FIREBASE_WEBAPP_CONFIG: JSON.stringify(webappConfig),
+        FIREBASE_CONFIG: JSON.stringify({
+            databaseURL: webappConfig.databaseURL,
+            storageBucket: webappConfig.storageBucket,
+            projectId: webappConfig.projectId,
+        }),
+    };
+}

package/lib/apptesting/parseTestFiles.js

@@ -27,8 +27,8 @@ async function parseTestFiles(dir, targetUri, filePattern, namePattern) {
         }
         return accumulator;
     }, {});
-    const fileFilterFn = createFilter(filePattern);
-    const nameFilterFn = createFilter(namePattern);
+    const fileFilterFn = createFilter(filePattern, "file pattern");
+    const nameFilterFn = createFilter(namePattern, "test name pattern");
     const filteredInvocations = files
         .filter((file) => fileFilterFn(file.path))
         .flatMap((file) => file.invocations)
@@ -61,9 +61,18 @@ async function parseTestFiles(dir, targetUri, filePattern, namePattern) {
         };
     });
 }
-function createFilter(pattern) {
-    const regex = pattern ? new RegExp(pattern) : undefined;
-    return (s) => !regex || regex.test(s);
+function createFilter(pattern, context) {
+    try {
+        const regex = pattern ? new RegExp(pattern) : undefined;
+        return (s) => !regex || regex.test(s);
+    }
+    catch (ex) {
+        if (ex instanceof SyntaxError) {
+            const errMsg = context ? `Invalid ${context} regex: ${pattern}` : `Invalid regex: ${pattern}`;
+            throw new error_1.FirebaseError(errMsg, { original: (0, error_1.getError)(ex) });
+        }
+        throw ex;
+    }
 }
 async function parseTestFilesRecursive(params) {
     const testDir = params.testDir;

package/lib/commands/apptesting.js

@@ -3,14 +3,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.command = void 0;
 const requireAuth_1 = require("../requireAuth");
 const command_1 = require("../command");
-const logger_1 = require("../logger");
-const clc = require("colorette");
 const parseTestFiles_1 = require("../apptesting/parseTestFiles");
 const ora = require("ora");
 const error_1 = require("../error");
 const client_1 = require("../appdistribution/client");
 const distribution_1 = require("../appdistribution/distribution");
 const options_parser_util_1 = require("../appdistribution/options-parser-util");
+const utils = require("../utils");
+const fsutils_1 = require("../fsutils");
+const path = require("path");
 const defaultDevices = [
     {
         model: "MediumPhone.arm",
@@ -24,35 +25,44 @@ exports.command = new command_1.Command("apptesting:execute <release-binary-file
     .option("--app <app_id>", "The app id of your Firebase web app. Optional if the project contains exactly one web app.")
     .option("--test-file-pattern <pattern>", "Test file pattern. Only tests contained in files that match this pattern will be executed.")
     .option("--test-name-pattern <pattern>", "Test name pattern. Only tests with names that match this pattern will be executed.")
-    .option("--test-dir <test_dir>", "Directory where tests can be found.")
-    .option("--test-devices <string>", "semicolon-separated list of devices to run automated tests on, in the format 'model=<model-id>,version=<os-version-id>,locale=<locale>,orientation=<orientation>'. Run 'gcloud firebase test android|ios models list' to see available devices. Note: This feature is in beta.")
-    .option("--test-devices-file <string>", "path to file containing a list of semicolon- or newline-separated devices to run automated tests on, in the format 'model=<model-id>,version=<os-version-id>,locale=<locale>,orientation=<orientation>'. Run 'gcloud firebase test android|ios models list' to see available devices. Note: This feature is in beta.")
+    .option("--test-dir <test_dir>", "Directory where tests can be found. Defaults to './tests'.")
+    .option("--test-devices <string>", "Semicolon-separated list of devices to run automated tests on, in the format 'model=<model-id>,version=<os-version-id>,locale=<locale>,orientation=<orientation>'. Run 'gcloud firebase test android|ios models list' to see available devices. Note: This feature is in beta.")
+    .option("--test-devices-file <string>", "Path to file containing a list of semicolon- or newline-separated devices to run automated tests on, in the format 'model=<model-id>,version=<os-version-id>,locale=<locale>,orientation=<orientation>'. Run 'gcloud firebase test android|ios models list' to see available devices. Note: This feature is in beta.")
+    .option("--test-non-blocking", "Run automated tests without waiting for them to complete. Visit the Firebase console for the test results.")
     .before(requireAuth_1.requireAuth)
     .action(async (target, options) => {
     const appName = (0, options_parser_util_1.getAppName)(options);
-    const testDir = options.testDir || "tests";
+    const testDir = path.resolve(options.testDir || "tests");
+    if (!(0, fsutils_1.dirExistsSync)(testDir)) {
+        throw new error_1.FirebaseError(`Tests directory not found: ${testDir}. Use the --test-dir flag to choose a different directory.`);
+    }
     const tests = await (0, parseTestFiles_1.parseTestFiles)(testDir, undefined, options.testFilePattern, options.testNamePattern);
     const testDevices = (0, options_parser_util_1.parseTestDevices)(options.testDevices, options.testDevicesFile);
     if (!tests.length) {
         throw new error_1.FirebaseError("No tests found");
     }
     const invokeSpinner = ora("Requesting test execution");
+    const client = new client_1.AppDistributionClient();
     let releaseTests;
     let release;
     try {
-        const client = new client_1.AppDistributionClient();
         release = await (0, distribution_1.upload)(client, appName, new distribution_1.Distribution(target));
         invokeSpinner.start();
         releaseTests = await invokeTests(client, release.name, tests, !testDevices.length ? defaultDevices : testDevices);
-        invokeSpinner.text = "Test execution requested";
+        invokeSpinner.text = `${pluralizeTests(releaseTests.length)} started successfully!`;
         invokeSpinner.succeed();
     }
     catch (ex) {
         invokeSpinner.fail("Failed to request test execution");
         throw ex;
     }
-    logger_1.logger.info(clc.bold(`\n${clc.white("===")} Running ${pluralizeTests(releaseTests.length)}`));
-    logger_1.logger.info(`View progress and results in the Firebase Console:\n${release.firebaseConsoleUri}`);
+    if (options.testNonBlocking) {
+        utils.logBullet(`View progress and results in the Firebase Console:\n${release.firebaseConsoleUri}`);
+    }
+    else {
+        await (0, distribution_1.awaitTestResults)(releaseTests, client);
+        utils.logBullet(`View detailed results in the Firebase Console:\n${release.firebaseConsoleUri}`);
+    }
 });
 function pluralizeTests(numTests) {
     return `${numTests} test${numTests === 1 ? "" : "s"}`;

package/lib/commands/index.js

@@ -33,6 +33,11 @@ function load(client) {
     client.appdistribution.testCases = {};
     client.appdistribution.testCases.export = loadCommand("appdistribution-testcases-export");
     client.appdistribution.testCases.import = loadCommand("appdistribution-testcases-import");
+    client.apptesting = {};
+    client.apptesting.execute = loadCommand("apptesting");
+    if (experiments.isEnabled("apptesting")) {
+        client.apptesting.wata = loadCommand("apptesting-wata");
+    }
     client.apps = {};
     client.apps.create = loadCommand("apps-create");
     client.apps.list = loadCommand("apps-list");
@@ -254,11 +259,6 @@ function load(client) {
     client.target.clear = loadCommand("target-clear");
     client.target.remove = loadCommand("target-remove");
     client.use = loadCommand("use");
-    client.apptesting = {};
-    client.apptesting.execute = loadCommand("apptesting");
-    if (experiments.isEnabled("apptesting")) {
-        client.apptesting.wata = loadCommand("apptesting-wata");
-    }
     const t1 = process.hrtime.bigint();
     const diffMS = (t1 - t0) / BigInt(1e6);
     if (diffMS > 100) {

package/lib/deploy/apphosting/util.js

@@ -35,7 +35,7 @@ async function createArchive(config, rootDir, targetSubDir) {
         await pipeAsync(archive, fileStream);
     }
     catch (err) {
-        throw new error_1.FirebaseError("Could not read source directory. Remove links and shortcuts and try again.", { original: err, exit: 1 });
+        throw new error_1.FirebaseError(`Could not read source directory. Remove links and shortcuts and try again. Original: ${err}`, { original: err, exit: 1 });
     }
     return tmpFile;
 }

package/lib/deploy/functions/prepareFunctionsUpload.js

@@ -98,7 +98,7 @@ async function packageSource(projectDir, sourceDir, config, additionalSources, r
         if (err instanceof error_1.FirebaseError) {
             throw err;
         }
-        throw new error_1.FirebaseError("Could not read source directory. Remove links and shortcuts and try again.", {
+        throw new error_1.FirebaseError(`Could not read source directory. Remove links and shortcuts and try again. Original: ${err}`, {
             original: err,
             exit: 1,
         });

package/lib/emulator/apphosting/serve.js

@@ -20,9 +20,10 @@ const utils_1 = require("../../utils");
 const apphosting = require("../../gcp/apphosting");
 const constants_2 = require("../constants");
 const fetchWebSetup_1 = require("../../fetchWebSetup");
-const apps_1 = require("../../management/apps");
 const child_process_1 = require("child_process");
 const semver_1 = require("semver");
+const utils_2 = require("../../apphosting/utils");
+const apps_1 = require("../../management/apps");
 const secretResourceRegex = /^projects\/([^/]+)\/secrets\/([^/]+)(?:\/versions\/((?:latest)|\d+))?$/;
 const secretShorthandRegex = /^([^/@]+)(?:@((?:latest)|\d+))?$/;
 async function loadSecret(project, name) {
@@ -81,6 +82,15 @@ async function start(options) {
         startCommand = await (0, developmentServer_1.detectPackageManagerStartCommand)(backendRoot);
         developmentServer_2.logger.logLabeled("BULLET", types_1.Emulators.APPHOSTING, `starting app with: '${startCommand}'`);
     }
+    const packageManager = await (0, developmentServer_1.detectPackageManager)(backendRoot).catch(() => undefined);
+    let autoinitEnvVars = {};
+    if (packageManager === "pnpm") {
+        (0, utils_1.logLabeledWarning)("apphosting", "Firebase JS SDK autoinit does not currently support PNPM.");
+    }
+    else {
+        const webappConfig = await getBackendAppConfig(options?.projectId, options?.backendId);
+        autoinitEnvVars = (0, utils_2.getAutoinitEnvVars)(webappConfig);
+    }
     const apphostingLocalConfig = await (0, config_1.getLocalAppHostingConfiguration)(backendRoot);
     const resolveEnv = Object.entries(apphostingLocalConfig.env).map(async ([key, value]) => [
         key,
@@ -88,6 +98,7 @@ async function start(options) {
     ]);
     const environmentVariablesToInject = {
         NODE_ENV: process.env.NODE_ENV,
+        ...autoinitEnvVars,
         ...getEmulatorEnvs(),
         ...Object.fromEntries(await Promise.all(resolveEnv)),
         FIREBASE_APP_HOSTING: "1",
@@ -96,20 +107,7 @@ async function start(options) {
         PROJECT_ID: options?.projectId,
         PORT: port.toString(),
     };
-    const packageManager = await (0, developmentServer_1.detectPackageManager)(backendRoot).catch(() => undefined);
-    if (packageManager === "pnpm") {
-        (0, utils_1.logLabeledWarning)("apphosting", `Firebase JS SDK autoinit does not currently support PNPM.`);
-    }
-    else {
-        const webappConfig = await getBackendAppConfig(options?.projectId, options?.backendId);
-        if (webappConfig) {
-            environmentVariablesToInject["FIREBASE_WEBAPP_CONFIG"] || (environmentVariablesToInject["FIREBASE_WEBAPP_CONFIG"] = JSON.stringify(webappConfig));
-            environmentVariablesToInject["FIREBASE_CONFIG"] || (environmentVariablesToInject["FIREBASE_CONFIG"] = JSON.stringify({
-                databaseURL: webappConfig.databaseURL,
-                storageBucket: webappConfig.storageBucket,
-                projectId: webappConfig.projectId,
-            }));
-        }
+    if (packageManager !== "pnpm") {
         await tripFirebasePostinstall(backendRoot, environmentVariablesToInject);
     }
     (0, spawn_1.spawnWithCommandString)(startCommand, backendRoot, environmentVariablesToInject)

package/lib/emulator/downloadableEmulatorInfo.json

@@ -44,13 +44,13 @@
         }
     },
     "pubsub": {
-        "version": "0.8.27",
-        "expectedSize": 52924291,
-        "expectedChecksum": "cb0d35db6aa1bb5e3f7e2a5a690c631d",
-        "expectedChecksumSHA256": "0b793b420b608b68c200a0d15123c63967ac2863bbd9545ecb087d5b28871339",
-        "remoteUrl": "https://storage.googleapis.com/firebase-preview-drop/emulator/pubsub-emulator-0.8.27.zip",
-        "downloadPathRelativeToCacheDir": "pubsub-emulator-0.8.27.zip",
-        "binaryPathRelativeToCacheDir": "pubsub-emulator-0.8.27/pubsub-emulator/bin/cloud-pubsub-emulator"
+        "version": "0.8.29",
+        "expectedSize": 52906482,
+        "expectedChecksum": "8345b0a923dda5634dd56a25f913cf37",
+        "expectedChecksumSHA256": "31228112fb95a6818d13a88e801f4be6fb5ea5b601175b74528cc61823ea5507",
+        "remoteUrl": "https://storage.googleapis.com/firebase-preview-drop/emulator/pubsub-emulator-0.8.29.zip",
+        "downloadPathRelativeToCacheDir": "pubsub-emulator-0.8.29.zip",
+        "binaryPathRelativeToCacheDir": "pubsub-emulator-0.8.29/pubsub-emulator/bin/cloud-pubsub-emulator"
     },
     "dataconnect": {
         "darwin": {

package/lib/firebase_studio/migrate.js

@@ -16,7 +16,7 @@ const secrets_1 = require("../apphosting/secrets");
 const env = require("../functions/env");
 const error_1 = require("../error");
 const os = require("os");
-async function setupAntigravityMcpServer(rootPath) {
+async function setupAntigravityMcpServer(rootPath, appType) {
     const mcpConfigDir = path.join(os.homedir(), ".gemini", "antigravity");
     const mcpConfigPath = path.join(mcpConfigDir, "mcp_config.json");
     let mcpConfig = { mcpServers: {} };
@@ -36,16 +36,39 @@ async function setupAntigravityMcpServer(rootPath) {
                 mcpConfig.mcpServers = {};
             }
         }
-        if (mcpConfig.mcpServers["firebase"]) {
+        let updated = false;
+        if (!mcpConfig.mcpServers["firebase"]) {
+            mcpConfig.mcpServers["firebase"] = {
+                command: "npx",
+                args: ["-y", "firebase-tools@latest", "mcp", "--dir", path.resolve(rootPath)],
+            };
+            updated = true;
+            logger_1.logger.info(`✅ Configured Firebase MCP server in ${mcpConfigPath}`);
+        }
+        else {
             logger_1.logger.info("ℹ️ Firebase MCP server already configured in Antigravity, skipping.");
-            return;
         }
-        mcpConfig.mcpServers["firebase"] = {
-            command: "npx",
-            args: ["-y", "firebase-tools@latest", "mcp", "--dir", path.resolve(rootPath)],
-        };
-        await fs.writeFile(mcpConfigPath, JSON.stringify(mcpConfig, null, 2));
-        logger_1.logger.info(`✅ Configured Firebase MCP server in ${mcpConfigPath}`);
+        if (appType === "FLUTTER") {
+            if (utils.commandExistsSync("dart")) {
+                if (!mcpConfig.mcpServers["dart"]) {
+                    mcpConfig.mcpServers["dart"] = {
+                        command: "dart",
+                        args: ["mcp-server"],
+                    };
+                    updated = true;
+                    logger_1.logger.info(`✅ Configured Dart MCP server in ${mcpConfigPath}`);
+                }
+                else {
+                    logger_1.logger.info("ℹ️ Dart MCP server already configured in Antigravity, skipping.");
+                }
+            }
+            else {
+                utils.logWarning("Couldn't find Dart/Flutter on PATH. Install Flutter by following the instruction at https://docs.flutter.dev/install.");
+            }
+        }
+        if (updated) {
+            await fs.writeFile(mcpConfigPath, JSON.stringify(mcpConfig, null, 2));
+        }
     }
     catch (err) {
         const message = err instanceof Error ? err.message : String(err);
@@ -89,40 +112,23 @@ async function detectAppType(rootPath) {
     }
     return "OTHER";
 }
-async function downloadGitHubDir(apiUrl, localPath) {
-    const response = await fetch(apiUrl);
-    if (!response.ok) {
-        throw new Error(`Failed to fetch directory listing: ${apiUrl}`);
-    }
-    const items = (await response.json());
-    await fs.mkdir(localPath, { recursive: true });
-    for (const item of items) {
-        const itemLocalPath = path.join(localPath, item.name);
-        if (item.type === "dir") {
-            await downloadGitHubDir(item.url, itemLocalPath);
-        }
-        else if (item.type === "file") {
-            const fileResponse = await fetch(item.download_url);
-            if (fileResponse.ok) {
-                const content = await fileResponse.arrayBuffer();
-                await fs.writeFile(itemLocalPath, Buffer.from(content));
-            }
-        }
-    }
-}
 const isValidFirebaseProjectId = (projectId) => {
     const projectIdRegex = /^[a-z][a-z0-9-]{4,28}[a-z0-9]$/;
     return projectIdRegex.test(projectId);
 };
 async function extractMetadata(rootPath, overrideProjectId) {
+    const studioJsonPath = path.join(rootPath, "studio.json");
     const metadataPath = path.join(rootPath, "metadata.json");
     let metadata = {};
-    try {
-        const metadataContent = await fs.readFile(metadataPath, "utf8");
-        metadata = JSON.parse(metadataContent);
-    }
-    catch (err) {
-        logger_1.logger.debug(`Could not read metadata.json at ${metadataPath}: ${err}`);
+    for (const metadataFile of [metadataPath, studioJsonPath]) {
+        try {
+            const metadataContent = await fs.readFile(metadataFile, "utf8");
+            metadata = JSON.parse(metadataContent);
+            logger_1.logger.info(`✅ Read ${metadataFile}`);
+        }
+        catch (err) {
+            logger_1.logger.debug(`Could not read metadata at ${metadataFile}: ${err}`);
+        }
     }
     logger_1.logger.debug(`overrideProjectId ${overrideProjectId}`);
     logger_1.logger.debug(`metadata.projectId ${metadata.projectId}`);
@@ -146,14 +152,13 @@ async function extractMetadata(rootPath, overrideProjectId) {
         logger_1.logger.info(`✅ Using Firebase Project: ${projectId}`);
     }
     else {
-        logger_1.logger.info(`❌ Failed to determine the Firebase Project ID. You can set a project later with 'firebase use <project-id>' or by setting the '--project' flag.`);
+        logger_1.logger.debug(`❌ Failed to determine the Firebase Project ID. You can set a project later by setting the '--project' flag.`);
     }
     let appName = "firebase-studio-export";
-    let blueprintContent = "";
     const blueprintPath = path.join(rootPath, "docs", "blueprint.md");
     try {
-        blueprintContent = await fs.readFile(blueprintPath, "utf8");
-        const nameMatch = blueprintContent.match(/# \*\*App Name\*\*: (.*)/);
+        const content = await fs.readFile(blueprintPath, "utf8");
+        const nameMatch = content.match(/# \*\*App Name\*\*: (.*)/);
         if (nameMatch && nameMatch[1]) {
             appName = nameMatch[1].trim();
         }
@@ -164,15 +169,34 @@ async function extractMetadata(rootPath, overrideProjectId) {
     if (appName !== "firebase-studio-export") {
         logger_1.logger.info(`✅ Detected App Name: ${appName}`);
     }
-    return { projectId, appName, blueprintContent };
+    return { projectId, appName };
 }
-async function updateReadme(rootPath, blueprintContent, appName) {
+async function updateReadme(rootPath, framework) {
     const readmePath = path.join(rootPath, "README.md");
     const readmeTemplate = await (0, templates_1.readTemplate)("firebase-studio-export/readme_template.md");
-    const newReadme = readmeTemplate
-        .replace(/\${appName}/g, appName)
+    const frameworkConfigs = {
+        NEXT_JS: { startCommand: "npm run dev", localUrl: "http://localhost:9002" },
+        ANGULAR: { startCommand: "npm run start", localUrl: "http://localhost:4200" },
+        FLUTTER: {
+            startCommand: "flutter run -d chrome --web-port=8080",
+            localUrl: "http://localhost:8080",
+        },
+        OTHER: { startCommand: "npm run dev", localUrl: "http://localhost:9002" },
+    };
+    const { startCommand, localUrl } = frameworkConfigs[framework];
+    let existingReadme = "";
+    try {
+        existingReadme = await fs.readFile(readmePath, "utf8");
+    }
+    catch (err) {
+    }
+    let newReadme = readmeTemplate
         .replace("${exportDate}", new Date().toISOString().split("T")[0])
-        .replace("${blueprintContent}", blueprintContent.replace(/# \*\*App Name\*\*: .*/, "").trim());
+        .replace("${startCommand}", startCommand)
+        .replace("${localUrl}", localUrl);
+    if (existingReadme.trim()) {
+        newReadme += `\n\n---\n\n## Previous README.md contents:\n\n${existingReadme}`;
+    }
     await fs.writeFile(readmePath, newReadme);
     logger_1.logger.info("✅ Updated README.md with project details and origin info");
 }
@@ -184,39 +208,31 @@ async function injectAntigravityContext(rootPath, projectId, appName) {
     await fs.mkdir(rulesDir, { recursive: true });
     await fs.mkdir(workflowsDir, { recursive: true });
     await fs.mkdir(skillsDir, { recursive: true });
-    logger_1.logger.info("⏳ Fetching Antigravity skills from firebase/agent-skills...");
+    logger_1.logger.info("⏳ Adding Antigravity skills...");
     try {
-        const skillsResponse = await fetch("https://api.github.com/repos/firebase/agent-skills/contents/skills");
-        if (!skillsResponse.ok) {
-            throw new Error(`GitHub API returned ${skillsResponse.status}`);
-        }
-        const skillsData = (await skillsResponse.json());
-        if (Array.isArray(skillsData)) {
-            for (const item of skillsData) {
-                if (item.type === "dir") {
-                    const skillName = item.name;
-                    const skillDir = path.join(skillsDir, skillName);
-                    await downloadGitHubDir(item.url, skillDir);
-                }
-            }
+        const result = (0, child_process_1.spawnSync)("npx", ["-y", "skills", "add", "firebase/agent-skills", "-a", "antigravity", "--skill", "*", "-y"], {
+            cwd: rootPath,
+            stdio: "ignore",
+            shell: process.platform === "win32",
+        });
+        if (result.error) {
+            throw result.error;
         }
-        else {
-            utils.logWarning("GitHub API response for skills is not an array.");
+        if (result.status !== 0) {
+            throw new Error(`npx skills add exited with code ${result.status}`);
         }
-        logger_1.logger.info(`✅ Downloaded Firebase skills`);
+        logger_1.logger.info(`✅ Added Antigravity skills`);
     }
     catch (err) {
-        utils.logWarning(`Could not download Antigravity skills, skipping. ${err}`);
+        utils.logWarning(`Could not add Antigravity skills, skipping. ${err}`);
     }
     const systemInstructionsTemplate = await (0, templates_1.readTemplate)("firebase-studio-export/system_instructions_template.md");
-    const systemInstructions = systemInstructionsTemplate
-        .replace("${projectId}", projectId || "None")
-        .replace("${appName}", appName);
+    const systemInstructions = systemInstructionsTemplate.replace("${appName}", appName);
     await fs.writeFile(path.join(rulesDir, "migration-context.md"), systemInstructions);
     logger_1.logger.info("✅ Injected Antigravity rules");
     try {
-        const startupWorkflow = await (0, templates_1.readTemplate)("firebase-studio-export/workflows/startup_workflow.md");
-        await fs.writeFile(path.join(workflowsDir, "startup.md"), startupWorkflow);
+        const cleanupWorkflow = await (0, templates_1.readTemplate)("firebase-studio-export/workflows/cleanup.md");
+        await fs.writeFile(path.join(workflowsDir, "cleanup.md"), cleanupWorkflow);
         logger_1.logger.info("✅ Created Antigravity startup workflow");
     }
     catch (err) {
@@ -282,12 +298,35 @@ async function createFirebaseConfigs(rootPath, projectId) {
             const backendsData = await apphosting.listBackends(projectId, "-");
             const backends = backendsData.backends || [];
             if (backends.length > 0) {
+                const backendIds = backends.map((b) => b.name.split("/").pop());
                 const studioBackend = backends.find((b) => b.name.endsWith("/studio") || b.name.toLowerCase().includes("studio"));
+                let selectedBackendId = "";
                 if (studioBackend) {
-                    backendId = studioBackend.name.split("/").pop();
+                    selectedBackendId = studioBackend.name.split("/").pop();
+                }
+                else {
+                    selectedBackendId = backendIds[0];
+                }
+                const confirmBackend = await prompt.confirm({
+                    message: `Would you like to use the App Hosting backend "${selectedBackendId}"?`,
+                    default: true,
+                    nonInteractive: process.env.NODE_ENV === "test",
+                });
+                if (confirmBackend) {
+                    backendId = selectedBackendId;
                 }
                 else {
-                    backendId = backends[0].name.split("/").pop();
+                    logger_1.logger.info("Available App Hosting backends:");
+                    for (const id of backendIds) {
+                        logger_1.logger.info(`  - ${id}`);
+                    }
+                    const inputBackendId = await prompt.input({
+                        message: "Please enter the name of the backend you would like to use:",
+                    });
+                    if (!backendIds.includes(inputBackendId)) {
+                        throw new error_1.FirebaseError(`Invalid backend selected: ${inputBackendId}`, { exit: 1 });
+                    }
+                    backendId = inputBackendId;
                 }
                 logger_1.logger.info(`✅ Selected App Hosting backend: ${backendId}`);
             }
@@ -317,20 +356,33 @@ async function createFirebaseConfigs(rootPath, projectId) {
         logger_1.logger.info(`✅ Created firebase.json with backendId: ${backendId}`);
     }
 }
-async function writeAntigravityConfigs(rootPath) {
+async function writeAntigravityConfigs(rootPath, framework) {
     const vscodeDir = path.join(rootPath, ".vscode");
     await fs.mkdir(vscodeDir, { recursive: true });
     const tasksJson = {
         version: "2.0.0",
-        tasks: [
-            {
-                label: "npm-install",
-                type: "shell",
-                command: "npm install",
-                problemMatcher: [],
-            },
-        ],
+        tasks: [],
     };
+    if (framework === "FLUTTER") {
+        tasksJson.tasks.push({
+            label: "flutter-pub-get",
+            type: "shell",
+            command: "flutter pub get",
+            problemMatcher: [],
+            group: {
+                kind: "build",
+                isDefault: true,
+            },
+        });
+    }
+    else {
+        tasksJson.tasks.push({
+            label: "npm-install",
+            type: "shell",
+            command: "npm install",
+            problemMatcher: [],
+        });
+    }
     await fs.writeFile(path.join(vscodeDir, "tasks.json"), JSON.stringify(tasksJson, null, 2));
     logger_1.logger.info("✅ Created .vscode/tasks.json");
     const settingsPath = path.join(vscodeDir, "settings.json");
@@ -354,19 +406,43 @@ async function writeAntigravityConfigs(rootPath) {
     logger_1.logger.info("✅ Updated .vscode/settings.json with startup preferences");
     const launchJson = {
         version: "0.2.0",
-        configurations: [
-            {
-                type: "node",
-                request: "launch",
-                name: "Next.js: debug server-side",
-                runtimeExecutable: "npm",
-                runtimeArgs: ["run", "dev"],
-                port: 9002,
-                console: "integratedTerminal",
-                preLaunchTask: "npm-install",
-            },
-        ],
+        configurations: [],
     };
+    if (framework === "ANGULAR") {
+        launchJson.configurations.push({
+            type: "node",
+            request: "launch",
+            name: "Angular: debug server-side",
+            runtimeExecutable: "npm",
+            runtimeArgs: ["run", "start"],
+            port: 4200,
+            console: "integratedTerminal",
+            preLaunchTask: "npm-install",
+        });
+    }
+    else if (framework === "NEXT_JS") {
+        launchJson.configurations.push({
+            type: "node",
+            request: "launch",
+            name: "Next.js: debug server-side",
+            runtimeExecutable: "npm",
+            runtimeArgs: ["run", "dev"],
+            port: 9002,
+            console: "integratedTerminal",
+            preLaunchTask: "npm-install",
+        });
+    }
+    else if (framework === "FLUTTER") {
+        launchJson.configurations.push({
+            name: "Flutter",
+            request: "launch",
+            type: "dart",
+            preLaunchTask: "flutter-pub-get",
+        });
+    }
+    else {
+        return;
+    }
     await fs.writeFile(path.join(vscodeDir, "launch.json"), JSON.stringify(launchJson, null, 2));
     logger_1.logger.info("✅ Created .vscode/launch.json");
 }
@@ -392,6 +468,46 @@ async function cleanupUnusedFiles(rootPath) {
         const message = err instanceof Error ? err.message : String(err);
         logger_1.logger.debug(`Could not delete ${modifiedPath}: ${message}`);
     }
+    const mcpJsonPath = path.join(rootPath, ".idx", "mcp.json");
+    try {
+        await fs.unlink(mcpJsonPath);
+        logger_1.logger.info("✅ Cleaned up .idx/mcp.json");
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        logger_1.logger.debug(`Could not delete ${mcpJsonPath}: ${message}`);
+    }
+}
+async function upgradeGenkitVersion(rootPath) {
+    const packageJsonPath = path.join(rootPath, "package.json");
+    try {
+        const packageJsonContent = await fs.readFile(packageJsonPath, "utf8");
+        const packageJson = JSON.parse(packageJsonContent);
+        let modified = false;
+        const upgradeDeps = (deps) => {
+            if (!deps) {
+                return;
+            }
+            for (const [name, version] of Object.entries(deps)) {
+                if (name === "genkit" || name === "genkit-cli" || name.startsWith("@genkit-ai/")) {
+                    if (version !== "1.29") {
+                        deps[name] = "1.29";
+                        modified = true;
+                    }
+                }
+            }
+        };
+        upgradeDeps(packageJson.dependencies);
+        upgradeDeps(packageJson.devDependencies);
+        if (modified) {
+            await fs.writeFile(packageJsonPath, JSON.stringify(packageJson, null, 2) + "\n");
+            logger_1.logger.info("✅ Upgraded Genkit version to 1.29 in package.json");
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        logger_1.logger.debug(`Could not upgrade Genkit version: ${message}`);
+    }
 }
 async function uploadSecrets(rootPath, projectId) {
     if (!projectId) {
@@ -453,17 +569,36 @@ async function askToOpenAntigravity(rootPath, appName, startAntigravity) {
         }
     }
 }
+async function checkDirectoryExists(dir) {
+    try {
+        const stat = await fs.stat(dir);
+        if (!stat.isDirectory()) {
+            throw new error_1.FirebaseError(`The path ${dir} is not a directory.`, { exit: 1 });
+        }
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            throw new error_1.FirebaseError(`The directory ${dir} does not exist.`, { exit: 1 });
+        }
+        throw err;
+    }
+}
 async function migrate(rootPath, options = { startAntigravity: true }) {
+    await checkDirectoryExists(rootPath);
     const appType = await detectAppType(rootPath);
     void track.trackGA4("firebase_studio_migrate", { app_type: appType, result: "started" });
     logger_1.logger.info("🚀 Starting Firebase Studio to Antigravity migration...");
-    const { projectId, appName, blueprintContent } = await extractMetadata(rootPath, options.project);
-    await updateReadme(rootPath, blueprintContent, appName);
+    const { projectId, appName } = await extractMetadata(rootPath, options.project);
+    if (appType) {
+        logger_1.logger.info(`✅ Detected framework: ${appType}`);
+    }
+    await updateReadme(rootPath, appType);
     await createFirebaseConfigs(rootPath, projectId);
     await uploadSecrets(rootPath, projectId);
+    await upgradeGenkitVersion(rootPath);
     await injectAntigravityContext(rootPath, projectId, appName);
-    await writeAntigravityConfigs(rootPath);
-    await setupAntigravityMcpServer(rootPath);
+    await writeAntigravityConfigs(rootPath, appType);
+    await setupAntigravityMcpServer(rootPath, appType);
     await cleanupUnusedFiles(rootPath);
     const currentFolderName = path.basename(rootPath);
     if (currentFolderName === "download") {

package/lib/mcp/index.js

@@ -135,7 +135,7 @@ class FirebaseMcpServer {
         this.logger.debug("detecting active features of Firebase MCP server...");
         const projectId = (await this.getProjectId()) || "";
         const accountEmail = await this.getAuthenticatedUser();
-        const isBillingEnabled = projectId ? await (0, cloudbilling_1.checkBillingEnabled)(projectId) : false;
+        const isBillingEnabled = projectId ? await this.safeCheckBillingEnabled(projectId) : false;
         const ctx = this._createMcpContext(projectId, accountEmail, isBillingEnabled);
         const detected = await Promise.all(types_1.SERVER_FEATURES.map(async (f) => {
             const availabilityCheck = (0, availability_1.getDefaultFeatureAvailabilityCheck)(f);
@@ -171,7 +171,7 @@ class FirebaseMcpServer {
     async getAvailableTools() {
         const projectId = (await this.getProjectId()) || "";
         const accountEmail = await this.getAuthenticatedUser();
-        const isBillingEnabled = projectId ? await (0, cloudbilling_1.checkBillingEnabled)(projectId) : false;
+        const isBillingEnabled = projectId ? await this.safeCheckBillingEnabled(projectId) : false;
         const ctx = this._createMcpContext(projectId, accountEmail, isBillingEnabled);
         return (0, index_2.availableTools)(ctx, this.activeFeatures, this.detectedFeatures, this.enabledTools);
     }
@@ -182,7 +182,7 @@ class FirebaseMcpServer {
     async getAvailablePrompts() {
         const projectId = (await this.getProjectId()) || "";
         const accountEmail = await this.getAuthenticatedUser();
-        const isBillingEnabled = projectId ? await (0, cloudbilling_1.checkBillingEnabled)(projectId) : false;
+        const isBillingEnabled = projectId ? await this.safeCheckBillingEnabled(projectId) : false;
         const ctx = this._createMcpContext(projectId, accountEmail, isBillingEnabled);
         return (0, index_1.availablePrompts)(ctx, this.activeFeatures, this.detectedFeatures);
     }
@@ -276,7 +276,7 @@ class FirebaseMcpServer {
         if (tool.mcp._meta?.requiresAuth && !accountEmail) {
             return (0, errors_1.mcpAuthError)(skipAutoAuthForStudio);
         }
-        const isBillingEnabled = projectId ? await (0, cloudbilling_1.checkBillingEnabled)(projectId) : false;
+        const isBillingEnabled = projectId ? await this.safeCheckBillingEnabled(projectId) : false;
         const toolsCtx = this._createMcpContext(projectId, accountEmail, isBillingEnabled);
         try {
             const res = await tool.fn(toolArgs, toolsCtx);
@@ -327,7 +327,7 @@ class FirebaseMcpServer {
         projectId = projectId || "";
         const skipAutoAuthForStudio = (0, env_1.isFirebaseStudio)();
         const accountEmail = await this.getAuthenticatedUser(skipAutoAuthForStudio);
-        const isBillingEnabled = projectId ? await (0, cloudbilling_1.checkBillingEnabled)(projectId) : false;
+        const isBillingEnabled = projectId ? await this.safeCheckBillingEnabled(projectId) : false;
         const promptsCtx = this._createMcpContext(projectId, accountEmail, isBillingEnabled);
         try {
             const messages = await prompt.fn(promptArgs, promptsCtx);
@@ -362,7 +362,7 @@ class FirebaseMcpServer {
         projectId = projectId || "";
         const skipAutoAuthForStudio = (0, env_1.isFirebaseStudio)();
         const accountEmail = await this.getAuthenticatedUser(skipAutoAuthForStudio);
-        const isBillingEnabled = projectId ? await (0, cloudbilling_1.checkBillingEnabled)(projectId) : false;
+        const isBillingEnabled = projectId ? await this.safeCheckBillingEnabled(projectId) : false;
         const resourceCtx = this._createMcpContext(projectId, accountEmail, isBillingEnabled);
         const resolved = await (0, resources_1.resolveResource)(req.params.uri, resourceCtx);
         if (!resolved) {
@@ -376,6 +376,18 @@ class FirebaseMcpServer {
             : new stdio_js_1.StdioServerTransport();
         await this.server.connect(transport);
     }
+    async safeCheckBillingEnabled(projectId) {
+        try {
+            return await (0, cloudbilling_1.checkBillingEnabled)(projectId);
+        }
+        catch (e) {
+            this.logger.debug("[mcp] Error on billingInfo for " +
+                projectId +
+                ", failing open (assuming false): " +
+                (e.message || e));
+            return false;
+        }
+    }
     get logger() {
         const logAtLevel = (level, message) => {
             let data = message;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firebase-tools",
-  "version": "15.10.0",
+  "version": "15.10.1",
   "description": "Command-Line Interface for Firebase",
   "main": "./lib/index.js",
   "mcpName": "io.github.firebase/firebase-mcp",

package/templates/firebase-studio-export/readme_template.md

@@ -1,11 +1,15 @@
-# ${appName}
+# Welcome to Antigravity!
 
-This project was migrated from Firebase Studio.
-**Previous Name:** ${appName}
-**Export Date:** ${exportDate}
+Welcome to your new developer home! Your Firebase Studio project has been successfully migrated to Antigravity.
 
-${blueprintContent}
+Antigravity is our next-generation, agent-first IDE designed for high-velocity, autonomous development. Because Antigravity runs locally on your machine, you now have access to powerful local workflows and fully integrated AI editing capabilities that go beyond a cloud-based web IDE.
 
----
+## Getting Started
+- **Run Locally**: Use the **Run and Debug** menu on the left sidebar to start your local development server.
+  - Or in a terminal run `${startCommand}` and visit `${localUrl}`.
+- **Deploy**: You can deploy your changes to Firebase App Hosting by using the integrated terminal and standard Firebase CLI commands, just as you did in Firebase Studio.
+- **Cleanup**: Cleanup unused artifacts with the @cleanup workflow.
 
-To get started, run \`npm run dev\` and visit \`http://localhost:9002\`.
+Enjoy the next era of AI-driven development!
+
+**Firebase Studio Export Date:** ${exportDate}

package/templates/firebase-studio-export/system_instructions_template.md

@@ -20,6 +20,20 @@ DO NOT try to deploy to Firebase Hosting.
 
 - When asked to add AI features, use Genkit (as already configured in `src/ai/`).
 
+# Understanding backend.json
+
+- `docs/backend.json` if it exists, is a description of the data structure of this application used by the model at the time it was generated.
+- The `backend.json` file is **NOT** a deployment script, a configuration file, or a source of truth for live cloud resources.
+  * **It is a BLUEPRINT, not the building.** It describes a *plan* for the data structure. It does **NOT** represent the currently deployed state. Think of it as an architect's drawing, not the physical house.
+  * **It has NO EFFECT on the backend.** The file's existence or content does not deploy, modify, or secure any cloud resources. Its sole purpose is to act as a static data source to ensure consistency during code generation.
+  * **It is NOT like Terraform.** Unlike a Terraform state file, this IR can be out of sync with the actual deployed resources. You must treat it as a self-contained, isolated definition and never assume it reflects reality.
+- **What's inside:**
+  * `entities`: JSON Schema definitions for the application's data models.
+  * `auth`: Supported authentication providers.
+  * `firestore.structure`: Maps database paths to entities, including path wildcards (e.g., `{userId}`).
+  * `firestore.reasoning`: Explains the architectural decisions, such as denormalization and security rule strategies.
+- **How to use it:** Use this file as a reference when creating or modifying Firestore security rules, data fetching logic, or when you need to understand the intended relationships between data entities.
+
 # Important
 
 Never display, log, or commit sensitive credentials, .env files, or service account keys.

package/templates/firebase-studio-export/workflows/cleanup.md

@@ -0,0 +1,20 @@
+---
+name: Cleanup
+description: Run initial checks and clean up dead files.
+---
+
+# Step 1: Check Compilation
+
+Run \`npm run build\` (depending on the app type) to ensure the project is in a healthy state.
+
+# Step 2: Cleanup Genkit config
+
+Check to see if genkit is otherwise unused in this project, ask the user if they'd like to remove the configuration in src/ai/genkit.ts and remove related dependencies in package.json.
+
+# Step 3: Cleanup dev.nix
+
+Ask the developer if they'd like to remove the .idx/dev.nix file. Most times this file will be unused but the developer may have added some configurations that they'd like to keep.
+
+# Step 4: Cleanup GEMINI.md
+
+Check for the existence of GEMINI.md. The GEMINI.md (if it exists) was written for a Firebase Studio context. Much of this information is no longer relevant. Ask the user if they'd like you to update the contents or remove the file entirely so they can start with a fresh GEMINI.md.

package/templates/init/apphosting/apphosting.yaml

@@ -18,6 +18,7 @@ runConfig:
   #     - RUNTIME
 
   # Grant access to secrets in Cloud Secret Manager.
+  # You can create secrets with the CLI command `firebase apphosting:secrets:set <secretName>`.
   # See https://firebase.google.com/docs/app-hosting/configure#secret-parameters
   # - variable: MY_SECRET
   #   secret: mySecretRef

package/templates/firebase-studio-export/workflows/startup_workflow.md

@@ -1,12 +0,0 @@
----
-name: Initial Project Setup
-description: Run initial checks and fix common migration issues
----
-
-# Step 1: Check Compilation
-
-Run \`npm run typecheck\` and \`npm run build\` (depending on the app type) to ensure the project is in a healthy state.
-
-# Step 2: Cleanup Genkit config
-
-If genkit is otherwise unused in this project, ask the user if they'd like to remove the configuration in src/ai/genkit.ts and remove related dependencies in package.json.