at-builder 1.4.0 → 1.4.3

package/.claude/settings.local.json

@@ -51,7 +51,26 @@
       "Bash(ls -la \"$\\(yarn global bin\\)/atb\")",
       "Bash(ls -la \"$\\(yarn global dir \\)/node_modules/at-builder\")",
       "Bash(git commit -m 'fix: surface ESLint error detail and clean up atb deploy build-failure exit *)",
-      "Bash(git commit -m 'fix\\(webpack\\): emit correct `variation=` attribute on at-build.html script tag *)"
+      "Bash(git commit -m 'fix\\(webpack\\): emit correct `variation=` attribute on at-build.html script tag *)",
+      "Bash(yarn install *)",
+      "Bash(git rm *)",
+      "Bash(git commit -m 'chore\\(deps\\): drop unused/deprecated deps + migrate qs to URLSearchParams *)",
+      "Bash(git commit -m 'fix\\(config\\): stop printing red \"Error reading .env\" on every atb invocation *)",
+      "Bash(yarn why *)",
+      "Bash(git commit -m 'fix\\(plop\\): trim whitespace on all atb new text prompts *)",
+      "Bash(atb install-extension *)",
+      "Bash(git commit -m 'feat\\(install-extension\\): first-class support for Antigravity IDE \\(agy\\) *)",
+      "Bash(npm whoami *)",
+      "Bash(npm view *)",
+      "Bash(git tag *)",
+      "Bash(git push *)",
+      "Bash(npm publish *)",
+      "Bash(git commit -m 'feat\\(eslint\\): honor consumer .eslintrc.* via FlatCompat *)",
+      "Bash(atb build *)",
+      "Bash(ACTIVITY_FOLDER_NAME=\"UPSDDO - 7313 - AB-26.3.1 - Left Hand Navigation With Flyout - Dashboard - EWS - FWS - Tracking - Support Portal - Billing - Pickup - Claims\" atb build --prod)",
+      "Bash(grep -oE \"\\\\\\([a-z-]+\\\\\\)$\")",
+      "Bash(awk '/^ERROR in/{flag=1; next} /^WARNING in/{flag=0; next} flag')",
+      "Bash(git commit -m 'fix\\(eslint\\): honor consumer ESLint config as sole authority + 2 FlatCompat bugs *)"
     ]
   }
 }

package/.plop/generators/prompts.js

@@ -19,6 +19,11 @@ const prompts = function (inquirer) {
     console.log(kleur.cyan().bold('  🧪 Create a new Adobe Target activity'));
     console.log(kleur.gray('  ─ scaffolds variation folders + shared/build.config.json\n'));
 
+    // All text inputs go through the same trim filter so downstream code never
+    // has to deal with stray leading/trailing whitespace (which would otherwise
+    // become folder names with trailing spaces, etc.).
+    const trim = (input) => (input || '').trim();
+
     return inquirer.prompt([
         {
             type: PROMPT_TYPE_LIST,
@@ -35,7 +40,8 @@ const prompts = function (inquirer) {
             name: 'testName',
             prefix: kleur.cyan('›'),
             message: ask('Activity name', 'folder name, e.g. TEST-1234 hero-banner'),
-            validate: (input) => input && input.trim()
+            filter: trim,
+            validate: (input) => input
                 ? true
                 : 'Activity name cannot be empty.'
         },
@@ -46,7 +52,8 @@ const prompts = function (inquirer) {
             message: (answers) => answers.activityType === 'xt'
                 ? ask('How many experiences?')
                 : ask('How many variations?', 'control is added automatically'),
-            validate: (input) => /^[1-9]\d*$/.test(String(input).trim())
+            filter: trim,
+            validate: (input) => /^[1-9]\d*$/.test(input)
                 ? true
                 : 'Enter a positive integer (1, 2, 3, ...).'
         },
@@ -55,7 +62,7 @@ const prompts = function (inquirer) {
             name: 'pageNames',
             prefix: kleur.cyan('›'),
             message: ask('Page names', 'comma-separated for multi-page, blank for single-page'),
-            filter: (input) => (input || '').trim()
+            filter: trim
         }
     ]);
 };

package/.plop/templates/analytics.hbs

@@ -28,6 +28,6 @@
         }  
     }
     catch (err){
-        console.log(err);
+        console.error(err);
     }
 }());

package/.plop/utils/index.js

@@ -1,8 +1,28 @@
-const _camelCase = require('lodash/camelCase');
-const _startCase = require('lodash/startCase');
-
+/**
+ * Convert an arbitrary string to PascalCase. Drop-in replacement for the
+ * previous `_startCase(_camelCase(str)).replace(/ /g, '')` lodash chain so we
+ * don't pull in 70KB+ of lodash for two trivial string ops.
+ *
+ * Handles the input shapes plop prompts actually receive:
+ *   "hello world"          → "HelloWorld"
+ *   "kebab-case-name"      → "KebabCaseName"
+ *   "snake_case_name"      → "SnakeCaseName"
+ *   "FOO_BAR"              → "FooBar"
+ *   "UPSDDO-1234 my-test"  → "Upsddo1234MyTest"
+ *   "alreadyCamel"         → "AlreadyCamel"
+ *   "MyComponent"          → "MyComponent"
+ */
 exports.toPascalCase = str => {
-  return _startCase(_camelCase(str)).replace(/ /g, '');
+    if (!str) return '';
+    return String(str)
+        // insert space at lower→Upper boundary: "fooBar" → "foo Bar"
+        .replace(/([a-z\d])([A-Z])/g, '$1 $2')
+        // insert space at UPPER→Upperlower boundary: "FOOBar" → "FOO Bar"
+        .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2')
+        .split(/[^a-zA-Z0-9]+/)
+        .filter(Boolean)
+        .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join('');
 };
 
 /**

package/README.md

@@ -67,7 +67,7 @@ atb deploy
 | `atb deploy`            | Deploy activity to Adobe Target                                           | `--dry-run` for testing, `--force` to override the 60s cooldown      |
 | `atb sync`              | Sync `build.config.json` with the AT activity (pages, experiences, names) | `--scaffold` to auto-create missing variation folders                |
 | `atb doctor`            | Diagnose and fix configuration issues                                     | `--fix` to auto-fix                                                  |
-| `atb install-extension` | Install the at-builder VSCode extension from the Marketplace             | `--editor cursor` (or `codium`, etc.) to use a non-VSCode editor CLI |
+| `atb install-extension` | Install the at-builder extension from the Marketplace (defaults to the VSCode `code` CLI) | `--editor agy` for Antigravity IDE; `--editor cursor`, `--editor codium`, or any VSCode-fork CLI on `PATH`        |
 
 ### **Examples**
 

package/bin/constants/config.js

@@ -108,7 +108,7 @@ var getHelpInfo = function () { return __awaiter(void 0, void 0, void 0, functio
             case 0: return [4 /*yield*/, (0, exports.getVersion)()];
             case 1:
                 version = _a.sent();
-                return [2 /*return*/, "\n".concat(formatText("\uD83C\uDFAF at-builder", 'cyan', true), " ").concat(formatText("v".concat(version), 'gray'), "\n\n").concat(formatText("Adobe Target Activity Development CLI", 'white', true), "\n\nA streamlined command-line tool for creating, building, and deploying Adobe Target \nA/B testing activities with modern web technologies.\n\n").concat(formatText("USAGE", 'yellow', true), "\n    ").concat(formatText("atb", 'cyan'), " ").concat(formatText("<command> [options]", 'gray'), "\n\n").concat(formatText("COMMANDS", 'yellow', true), "\n    ").concat(formatText("init", 'cyan', true), "           Initialize project with .env configuration and templates\n    ").concat(formatText("new", 'cyan', true), "            Create a new Adobe Target activity with variations\n    ").concat(formatText("build", 'cyan', true), "          Build activity for development\n    ").concat(formatText("build --prod", 'cyan', true), "   Build for production deployment\n    ").concat(formatText("dev", 'cyan', true), "            Start development server with file watching\n    ").concat(formatText("dev --browser", 'cyan', true), "  Start development server and open in browser\n    ").concat(formatText("deploy", 'cyan', true), "         Deploy activity to Adobe Target\n    ").concat(formatText("deploy --dry-run", 'cyan', true), " Deploy in dry-run mode without actual deployment\n    ").concat(formatText("deploy --force", 'cyan', true), "   Override the 60s post-deploy cooldown lock\n    ").concat(formatText("sync", 'cyan', true), "           Sync build.config.json with the AT activity (pages, experiences, names)\n    ").concat(formatText("sync --scaffold", 'cyan', true), "  Sync and auto-create any missing variation folders with boilerplate\n    ").concat(formatText("doctor", 'cyan', true), "         Diagnose and fix project configuration issues\n    ").concat(formatText("doctor --fix", 'cyan', true), "   Automatically fix detected configuration issues\n    ").concat(formatText("install-extension", 'cyan', true), "  Install the bundled at-builder VSCode extension (.vsix)\n    \n").concat(formatText("GLOBAL OPTIONS", 'yellow', true), "\n    ").concat(formatText("-v, --verbose", 'green'), "       Enable detailed logging\n    ").concat(formatText("-V, --version", 'green'), "       Display version information\n    ").concat(formatText("-h, --help", 'green'), "          Show help information\n\n").concat(formatText("EXAMPLES", 'yellow', true), "\n    ").concat(formatText("# Initialize new project", 'gray'), "\n    ").concat(formatText("atb init", 'white'), "\n    \n    ").concat(formatText("# Create new activity", 'gray'), "\n    ").concat(formatText("atb new", 'white'), "\n    \n    ").concat(formatText("# Development build with hot reload", 'gray'), "\n    ").concat(formatText("atb build", 'white'), "\n    \n    ").concat(formatText("# Production build for Adobe Target deployment", 'gray'), "\n    ").concat(formatText("atb build --prod", 'white'), "\n    \n    ").concat(formatText("# Development server with browser", 'gray'), "\n    ").concat(formatText("atb dev --browser", 'white'), "\n    \n    ").concat(formatText("# Deploy to Adobe Target", 'gray'), "\n    ").concat(formatText("atb deploy", 'white'), "\n    \n    ").concat(formatText("# Deploy in dry-run mode", 'gray'), "\n    ").concat(formatText("atb deploy --dry-run", 'white'), "\n\n    ").concat(formatText("# Sync build.config.json from Adobe Target", 'gray'), "\n    ").concat(formatText("atb sync", 'white'), "\n\n    ").concat(formatText("# Sync and scaffold missing variation folders", 'gray'), "\n    ").concat(formatText("atb sync --scaffold", 'white'), "\n\n    ").concat(formatText("# Check project configuration", 'gray'), "\n    ").concat(formatText("atb doctor", 'white'), "\n    \n    ").concat(formatText("# Auto-fix configuration issues", 'gray'), "\n    ").concat(formatText("atb doctor --fix", 'white'), "\n\n").concat(formatText("WORKFLOW", 'yellow', true), "\n    ").concat(formatText("1.", 'cyan'), " Run ").concat(formatText("atb init", 'white'), " to set up project configuration\n    ").concat(formatText("2.", 'cyan'), " Run ").concat(formatText("atb new", 'white'), " to create activity templates  \n    ").concat(formatText("3.", 'cyan'), " Develop variations in ").concat(formatText("/Activities/{name}/Variation-*/", 'gray'), "\n    ").concat(formatText("4.", 'cyan'), " Run ").concat(formatText("atb build", 'white'), " for development testing\n    ").concat(formatText("5.", 'cyan'), " Run ").concat(formatText("atb build --prod", 'white'), " for Adobe Target deployment\n    ").concat(formatText("6.", 'cyan'), " Run ").concat(formatText("atb deploy", 'white'), " to deploy to Adobe Target\n\n").concat(formatText("SUPPORT", 'yellow', true), "\n    Repository: ").concat(formatText("https://github.com/upesenga/at-builder", 'blue'), "\n    Issues:     ").concat(formatText("https://github.com/upesenga/at-builder/issues", 'blue'), "\n    License:    ").concat(formatText("MIT", 'green'), "\n")];
+                return [2 /*return*/, "\n".concat(formatText("\uD83C\uDFAF at-builder", 'cyan', true), " ").concat(formatText("v".concat(version), 'gray'), "\n\n").concat(formatText("Adobe Target Activity Development CLI", 'white', true), "\n\nA streamlined command-line tool for creating, building, and deploying Adobe Target \nA/B testing activities with modern web technologies.\n\n").concat(formatText("USAGE", 'yellow', true), "\n    ").concat(formatText("atb", 'cyan'), " ").concat(formatText("<command> [options]", 'gray'), "\n\n").concat(formatText("COMMANDS", 'yellow', true), "\n    ").concat(formatText("init", 'cyan', true), "           Initialize project with .env configuration and templates\n    ").concat(formatText("new", 'cyan', true), "            Create a new Adobe Target activity with variations\n    ").concat(formatText("build", 'cyan', true), "          Build activity for development\n    ").concat(formatText("build --prod", 'cyan', true), "   Build for production deployment\n    ").concat(formatText("dev", 'cyan', true), "            Start development server with file watching\n    ").concat(formatText("dev --browser", 'cyan', true), "  Start development server and open in browser\n    ").concat(formatText("deploy", 'cyan', true), "         Deploy activity to Adobe Target\n    ").concat(formatText("deploy --dry-run", 'cyan', true), " Deploy in dry-run mode without actual deployment\n    ").concat(formatText("deploy --force", 'cyan', true), "   Override the 60s post-deploy cooldown lock\n    ").concat(formatText("sync", 'cyan', true), "           Sync build.config.json with the AT activity (pages, experiences, names)\n    ").concat(formatText("sync --scaffold", 'cyan', true), "  Sync and auto-create any missing variation folders with boilerplate\n    ").concat(formatText("doctor", 'cyan', true), "         Diagnose and fix project configuration issues\n    ").concat(formatText("doctor --fix", 'cyan', true), "   Automatically fix detected configuration issues\n    ").concat(formatText("install-extension", 'cyan', true), "  Install the at-builder extension from the Marketplace (default: VSCode)\n    ").concat(formatText("install-extension --editor agy", 'cyan', true), "  Install into Antigravity IDE (also: cursor, codium, etc.)\n    \n").concat(formatText("GLOBAL OPTIONS", 'yellow', true), "\n    ").concat(formatText("-v, --verbose", 'green'), "       Enable detailed logging\n    ").concat(formatText("-V, --version", 'green'), "       Display version information\n    ").concat(formatText("-h, --help", 'green'), "          Show help information\n\n").concat(formatText("EXAMPLES", 'yellow', true), "\n    ").concat(formatText("# Initialize new project", 'gray'), "\n    ").concat(formatText("atb init", 'white'), "\n    \n    ").concat(formatText("# Create new activity", 'gray'), "\n    ").concat(formatText("atb new", 'white'), "\n    \n    ").concat(formatText("# Development build with hot reload", 'gray'), "\n    ").concat(formatText("atb build", 'white'), "\n    \n    ").concat(formatText("# Production build for Adobe Target deployment", 'gray'), "\n    ").concat(formatText("atb build --prod", 'white'), "\n    \n    ").concat(formatText("# Development server with browser", 'gray'), "\n    ").concat(formatText("atb dev --browser", 'white'), "\n    \n    ").concat(formatText("# Deploy to Adobe Target", 'gray'), "\n    ").concat(formatText("atb deploy", 'white'), "\n    \n    ").concat(formatText("# Deploy in dry-run mode", 'gray'), "\n    ").concat(formatText("atb deploy --dry-run", 'white'), "\n\n    ").concat(formatText("# Sync build.config.json from Adobe Target", 'gray'), "\n    ").concat(formatText("atb sync", 'white'), "\n\n    ").concat(formatText("# Sync and scaffold missing variation folders", 'gray'), "\n    ").concat(formatText("atb sync --scaffold", 'white'), "\n\n    ").concat(formatText("# Check project configuration", 'gray'), "\n    ").concat(formatText("atb doctor", 'white'), "\n    \n    ").concat(formatText("# Auto-fix configuration issues", 'gray'), "\n    ").concat(formatText("atb doctor --fix", 'white'), "\n\n").concat(formatText("WORKFLOW", 'yellow', true), "\n    ").concat(formatText("1.", 'cyan'), " Run ").concat(formatText("atb init", 'white'), " to set up project configuration\n    ").concat(formatText("2.", 'cyan'), " Run ").concat(formatText("atb new", 'white'), " to create activity templates  \n    ").concat(formatText("3.", 'cyan'), " Develop variations in ").concat(formatText("/Activities/{name}/Variation-*/", 'gray'), "\n    ").concat(formatText("4.", 'cyan'), " Run ").concat(formatText("atb build", 'white'), " for development testing\n    ").concat(formatText("5.", 'cyan'), " Run ").concat(formatText("atb build --prod", 'white'), " for Adobe Target deployment\n    ").concat(formatText("6.", 'cyan'), " Run ").concat(formatText("atb deploy", 'white'), " to deploy to Adobe Target\n\n").concat(formatText("SUPPORT", 'yellow', true), "\n    Repository: ").concat(formatText("https://github.com/upesenga/at-builder", 'blue'), "\n    Issues:     ").concat(formatText("https://github.com/upesenga/at-builder/issues", 'blue'), "\n    License:    ").concat(formatText("MIT", 'green'), "\n")];
         }
     });
 }); };
@@ -192,27 +192,28 @@ var createAdobeConfig = function (basePath) {
     }
 };
 /**
- * Reads and returns environment variables from the specified .env file
- * @param {string} basePath - The base path where the .env file is located
- * @returns {Promise<Object>} Object containing environment variables
+ * Reads and returns environment variables from the specified .env file.
+ *
+ * Throws if the file is missing or unreadable. Callers decide whether
+ * to surface the failure — printing here would spam every `atb` run from
+ * a directory that doesn't have a `.env` (e.g. `atb --version` from /tmp).
+ *
+ * @param basePath - The base path where the .env file is located
+ * @returns Object containing environment variables
  */
 var getENV = function (basePath) { return __awaiter(void 0, void 0, void 0, function () {
-    var envPath, envContent, envVars_1, error_2;
+    var envPath, envContent, envVars;
     return __generator(this, function (_a) {
         switch (_a.label) {
             case 0:
                 envPath = path_1.default.join(basePath, '.env');
-                _a.label = 1;
-            case 1:
-                _a.trys.push([1, 3, , 4]);
-                // Check if .env file exists
                 if (!fs_1.default.existsSync(envPath)) {
                     throw new Error('.env file not found');
                 }
                 return [4 /*yield*/, fs_1.default.promises.readFile(envPath, { encoding: 'utf8' })];
-            case 2:
+            case 1:
                 envContent = _a.sent();
-                envVars_1 = {};
+                envVars = {};
                 envContent.split('\n').forEach(function (line) {
                     line = line.trim();
                     // Skip empty lines and comments
@@ -221,16 +222,11 @@ var getENV = function (basePath) { return __awaiter(void 0, void 0, void 0, func
                         if (key) {
                             var value = valueParts.join('=').trim();
                             // Remove quotes if present
-                            envVars_1[key.trim()] = value.replace(/^["'](.*)["']$/, '$1');
+                            envVars[key.trim()] = value.replace(/^["'](.*)["']$/, '$1');
                         }
                     }
                 });
-                return [2 /*return*/, envVars_1];
-            case 3:
-                error_2 = _a.sent();
-                console.error(cli_color_1.default.red("Error reading .env file: ".concat(error_2.message)));
-                throw error_2;
-            case 4: return [2 /*return*/];
+                return [2 /*return*/, envVars];
         }
     });
 }); };

package/bin/index.js

@@ -230,8 +230,8 @@ var setupCommander = function () { return __awaiter(void 0, void 0, void 0, func
                 }); });
                 program
                     .command('install-extension')
-                    .description('Install the bundled at-builder VSCode extension (.vsix)')
-                    .option('--editor <bin>', 'Editor CLI to use (e.g. code, cursor, codium)', 'code')
+                    .description('Install the at-builder VSCode extension from the Marketplace')
+                    .option('--editor <bin>', 'Editor CLI to use (e.g. code, agy, cursor, codium)', 'code')
                     .action(function (options, command) { return __awaiter(void 0, void 0, void 0, function () {
                     var globalOpts;
                     return __generator(this, function (_a) {
@@ -382,50 +382,41 @@ var handleSync = function (scaffold, verbose) { return __awaiter(void 0, void 0,
 /**
  * Handles the install-extension command.
  *
- * Locates the bundled at-builder-*.vsix in at-builder's install directory
- * (one level up from this compiled file) and installs it via the editor's
- * CLI. Defaults to `code`; users on Cursor/VSCodium can pass --editor.
- *
- * The .vsix lives inside the at-builder package itself, NOT the consumer's
- * project — so it resolves via __dirname, not PWD.
+ * Installs the at-builder VSCode extension from the VS Code Marketplace
+ * using the editor's CLI. Defaults to `code`; users on Cursor/VSCodium
+ * can pass --editor.
+ */
+/**
+ * Per-editor install hints for when the CLI binary isn't on PATH. Each
+ * recognized editor gets a one-line, copy-pasteable suggestion. Anything
+ * else falls back to a generic hint.
  */
+var EDITOR_INSTALL_HINTS = {
+    code: 'Open VSCode and run Command Palette → "Shell Command: Install \'code\' command in PATH".',
+    agy: 'Open Antigravity IDE and run Command Palette → "Shell Command: Install \'agy\' command in PATH".',
+    cursor: 'Open Cursor and run Command Palette → "Shell Command: Install \'cursor\' command in PATH".',
+    codium: 'Open VSCodium and run Command Palette → "Shell Command: Install \'codium\' command in PATH".',
+};
+var reportEditorNotFound = function (editor) {
+    console.error("\u274C \"".concat(editor, "\" CLI not found in PATH."));
+    var hint = EDITOR_INSTALL_HINTS[editor]
+        || "Make sure the \"".concat(editor, "\" CLI is installed and on your PATH, or pass a different --editor.");
+    console.error("\uD83D\uDCA1 ".concat(hint));
+};
 var handleInstallExtension = function (editor, verbose) { return __awaiter(void 0, void 0, void 0, function () {
-    var installRoot, candidates, vsixPath, result;
+    var extensionId, result;
     return __generator(this, function (_a) {
+        extensionId = "UpendraSengar.at-builder";
         if (verbose)
-            logger_1.default.info("verbose", "Installing VSCode extension via ".concat(editor));
-        installRoot = path_1.default.join(__dirname, "..");
-        try {
-            candidates = fs_1.default.readdirSync(installRoot)
-                .filter(function (f) { return /^at-builder-.+\.vsix$/.test(f); })
-                .sort()
-                .reverse(); // latest version first by lexicographic sort
-        }
-        catch (error) {
-            console.error("\u274C Failed to scan at-builder directory: ".concat(error.message));
-            process.exit(1);
-        }
-        if (candidates.length === 0) {
-            console.error("❌ No at-builder VSCode extension (.vsix) found bundled with this install.");
-            console.error("\uD83D\uDCA1 Expected at: ".concat(installRoot, "/at-builder-*.vsix"));
-            process.exit(1);
-        }
-        vsixPath = path_1.default.join(installRoot, candidates[0]);
-        console.log("\uD83D\uDCE6 Installing ".concat(candidates[0], " via \"").concat(editor, "\"..."));
-        result = (0, child_process_1.spawn)(editor, ["--install-extension", vsixPath], {
+            logger_1.default.info("verbose", "Installing ".concat(extensionId, " via ").concat(editor));
+        console.log("\uD83D\uDCE6 Installing ".concat(extensionId, " from the Marketplace via \"").concat(editor, "\"..."));
+        result = (0, child_process_1.spawn)(editor, ["--install-extension", extensionId], {
             stdio: "inherit",
             shell: true
         });
         result.on("error", function (err) {
-            // ENOENT here means the editor binary isn't on PATH.
             if (err.code === "ENOENT") {
-                console.error("\u274C \"".concat(editor, "\" CLI not found in PATH."));
-                if (editor === "code") {
-                    console.error("💡 Open VSCode and run Command Palette → \"Shell Command: Install 'code' command in PATH\".");
-                }
-                else {
-                    console.error("\uD83D\uDCA1 Make sure the \"".concat(editor, "\" CLI is installed and on your PATH, or pass a different --editor."));
-                }
+                reportEditorNotFound(editor);
             }
             else {
                 console.error("\u274C Failed to launch \"".concat(editor, "\": ").concat(err.message));
@@ -440,13 +431,7 @@ var handleInstallExtension = function (editor, verbose) { return __awaiter(void
             // 127 = shell's "command not found". With shell:true the spawn 'error'
             // event never fires for missing CLIs, so we surface the same hint here.
             if (code === 127) {
-                console.error("\u274C \"".concat(editor, "\" CLI not found in PATH."));
-                if (editor === "code") {
-                    console.error("💡 Open VSCode and run Command Palette → \"Shell Command: Install 'code' command in PATH\".");
-                }
-                else {
-                    console.error("\uD83D\uDCA1 Make sure the \"".concat(editor, "\" CLI is installed and on your PATH, or pass a different --editor."));
-                }
+                reportEditorNotFound(editor);
                 process.exit(1);
             }
             console.error("\u274C \"".concat(editor, " --install-extension\" exited with code ").concat(code, "."));

package/lib/at-deploy.js

@@ -47,7 +47,6 @@ dotenv.config({ path: path.join(PWD, '.env'), quiet: true });
 
 const { execFileSync } = require('child_process');
 const axios = require('axios');
-const qs = require('querystring');
 const fs = require('fs');
 
 const { BASE_URL, IMS_TOKEN_URL, IMS_SCOPE } = require(path.join(PWD, 'adobe.config'));
@@ -207,12 +206,12 @@ function getBuildAssets(isMultiPage, allowedVariations) {
 }
 
 async function fetchAdobeToken() {
-    const data = qs.stringify({
+    const data = new URLSearchParams({
         grant_type: 'client_credentials',
         client_id: process.env.ADOBE_CLIENT_ID,
         client_secret: process.env.ADOBE_CLIENT_SECRET,
         scope: IMS_SCOPE
-    });
+    }).toString();
     try {
         const res = await axios.post(IMS_TOKEN_URL, data, {
             headers: { 'Content-Type': 'application/x-www-form-urlencoded' }

package/lib/at-sync.js

@@ -36,7 +36,6 @@
 const path = require('path');
 const fs = require('fs');
 const axios = require('axios');
-const qs = require('querystring');
 const dotenv = require('dotenv');
 
 const PWD = process.env.executionPath || process.cwd();
@@ -81,12 +80,12 @@ const CONFIG_PATHS = [
 
 // ─── Auth ───
 async function fetchToken() {
-    const data = qs.stringify({
+    const data = new URLSearchParams({
         grant_type: 'client_credentials',
         client_id: process.env.ADOBE_CLIENT_ID,
         client_secret: process.env.ADOBE_CLIENT_SECRET,
         scope: IMS_SCOPE
-    });
+    }).toString();
     const res = await axios.post(IMS_TOKEN_URL, data, {
         headers: { 'Content-Type': 'application/x-www-form-urlencoded' }
     });

package/lib/eslint-flat-config-plugin.js

@@ -1,13 +1,95 @@
 /* eslint-disable no-undef */
 const { ESLint } = require('eslint');
 const path = require('path');
+const fs = require('fs');
+
+// Legacy .eslintrc.* names ESLint v8 supported. ESLint v9 dropped them, but a
+// lot of existing consumer projects still ship them — auto-convert via
+// @eslint/eslintrc's FlatCompat shim so those rules are honored.
+const LEGACY_ESLINTRC_NAMES = [
+    '.eslintrc.js',
+    '.eslintrc.cjs',
+    '.eslintrc.json',
+    '.eslintrc'
+];
+
+/**
+ * Find the first .eslintrc.* file in `context`. Returns absolute path or null.
+ */
+function findLegacyEslintrc(context) {
+    for (const name of LEGACY_ESLINTRC_NAMES) {
+        const p = path.join(context, name);
+        if (fs.existsSync(p)) return p;
+    }
+    return null;
+}
+
+/**
+ * Convert a legacy ESLint config (.eslintrc.*) to the flat-config array
+ * format ESLint v9 expects. Uses FlatCompat from @eslint/eslintrc.
+ *
+ * Returns [] (and warns once) if @eslint/eslintrc isn't installed or the
+ * config can't be parsed — better to ship a partial config than to fail
+ * the build outright.
+ */
+function convertLegacyEslintrc(legacyPath, context) {
+    let FlatCompat;
+    try {
+        ({ FlatCompat } = require('@eslint/eslintrc'));
+    } catch (_e) {
+        console.warn(
+            `[at-builder] Found ${path.relative(context, legacyPath)} but @eslint/eslintrc is not installed; ` +
+            'legacy config will be ignored. Migrate to eslint.config.js or report this.'
+        );
+        return [];
+    }
+
+    let legacyConfig;
+    try {
+        if (legacyPath.endsWith('.json') || legacyPath.endsWith('.eslintrc')) {
+            legacyConfig = JSON.parse(fs.readFileSync(legacyPath, 'utf8'));
+        } else {
+            delete require.cache[require.resolve(legacyPath)];
+            legacyConfig = require(legacyPath);
+        }
+    } catch (err) {
+        console.warn(`[at-builder] Failed to read ${path.relative(context, legacyPath)}: ${err.message}`);
+        return [];
+    }
+
+    // recommendedConfig/allConfig are required when the legacy file
+    // `extends: ["eslint:recommended"]` (or "eslint:all"). Without them,
+    // FlatCompat throws "Missing parameter 'recommendedConfig'" because
+    // ESLint v9 no longer ships those built-in strings — they live in the
+    // separate @eslint/js package now.
+    let jsConfigs;
+    try {
+        jsConfigs = require('@eslint/js').configs;
+    } catch (_e) {
+        jsConfigs = {};
+    }
+
+    try {
+        const compat = new FlatCompat({
+            baseDirectory: context,
+            recommendedConfig: jsConfigs.recommended,
+            allConfig: jsConfigs.all
+        });
+        const flatArray = compat.config(legacyConfig);
+        console.log(`[at-builder] Loaded legacy ESLint config from ${path.relative(context, legacyPath)}`);
+        return flatArray;
+    } catch (err) {
+        console.warn(`[at-builder] FlatCompat could not convert ${path.relative(context, legacyPath)}: ${err.message}`);
+        return [];
+    }
+}
 
 class ESLintFlatConfigPlugin {
     constructor(options = {}) {
         this.options = {
             context: options.context || process.cwd(),
             configFile: options.configFile,
-            overrideConfigFiles: options.overrideConfigFiles || [], // Array of additional config files
+            overrideConfigFiles: options.overrideConfigFiles || [], // Array of additional flat-config file paths
             failOnError: options.failOnError !== false,
             failOnWarning: options.failOnWarning || false,
             fix: options.fix || false, // Enable auto-fix
@@ -40,33 +122,52 @@ class ESLintFlatConfigPlugin {
                 if (filesToLint.length === 0) return;
 
                 try {
-                    // Load base config
+                    // Load base config (at-builder's bundled flat config)
                     let baseConfig = [];
-                    if (this.options.configFile && require('fs').existsSync(this.options.configFile)) {
+                    if (this.options.configFile && fs.existsSync(this.options.configFile)) {
                         delete require.cache[require.resolve(this.options.configFile)];
                         baseConfig = require(this.options.configFile);
                     }
 
-                    // Load and merge override configs
+                    // Load consumer flat-config overrides (eslint.config.js etc.)
                     const overrideConfigs = [];
                     for (const configPath of this.options.overrideConfigFiles) {
                         try {
                             const resolvedPath = path.resolve(this.options.context, configPath);
-                            if (require('fs').existsSync(resolvedPath)) {
+                            if (fs.existsSync(resolvedPath)) {
                                 delete require.cache[require.resolve(resolvedPath)];
                                 const config = require(resolvedPath);
                                 overrideConfigs.push(...(Array.isArray(config) ? config : [config]));
                             }
                         } catch (err) {
-                            // Silently skip if config doesn't exist
+                            // Silently skip if config doesn't exist or can't be required
                         }
                     }
 
-                    // Merge all configs (base + overrides)
-                    const mergedConfig = [
-                        ...(Array.isArray(baseConfig) ? baseConfig : [baseConfig]),
-                        ...overrideConfigs
-                    ];
+                    // Auto-discover legacy .eslintrc.* in the consumer project and
+                    // convert it via FlatCompat. Only kicks in if no flat-config
+                    // override was found (flat config wins by convention).
+                    let legacyConfigs = [];
+                    if (overrideConfigs.length === 0) {
+                        const legacyPath = findLegacyEslintrc(this.options.context);
+                        if (legacyPath) {
+                            legacyConfigs = convertLegacyEslintrc(legacyPath, this.options.context);
+                        }
+                    }
+
+                    // When the consumer ships their own ESLint config (flat or
+                    // legacy), it becomes the sole authority — at-builder's
+                    // bundled defaults are NOT merged in. Otherwise consumers
+                    // would have to defensively `'no-console': 'off'` every
+                    // rule at-builder happens to opinionate on. at-builder's
+                    // bundle is a fallback for projects with no ESLint config
+                    // at all, not a baseline that gets merged with theirs.
+                    const consumerHasConfig =
+                        overrideConfigs.length > 0 || legacyConfigs.length > 0;
+
+                    const mergedConfig = consumerHasConfig
+                        ? [...overrideConfigs, ...legacyConfigs]
+                        : (Array.isArray(baseConfig) ? baseConfig : [baseConfig]);
 
                     // overrideConfigFile: true tells ESLint v9 to skip the
                     // cwd-based flat-config lookup entirely and treat
@@ -75,12 +176,23 @@ class ESLintFlatConfigPlugin {
                     // `eslint.config.js` (which they don't have, since at-builder
                     // ships its own) and fails the build with "Could not find
                     // config file." even though we provided everything inline.
+                    // ignore: true (default) respects the consumer's
+                    // ignorePatterns / ignores entries. We previously had
+                    // ignore:false thinking it suppressed ESLint's defaults,
+                    // but it actually disabled ALL ignore handling — including
+                    // the consumer's own patterns — so e.g. `.plop/**` in
+                    // their .eslintrc.js was silently ignored.
+                    //
+                    // warnIgnored:false suppresses ESLint's "File ignored
+                    // because of a matching ignore pattern" warnings — webpack
+                    // happens to walk into ignored files via imports, and we
+                    // don't want to surface a warning for each one.
                     const eslint = new ESLint({
                         cwd: this.options.context,
                         overrideConfigFile: true,
                         overrideConfig: mergedConfig,
-                        ignore: false,  // Don't use default ignore patterns
-                        fix: this.options.fix  // Enable auto-fix if option is set
+                        warnIgnored: false,
+                        fix: this.options.fix
                     });
 
                     const results = await eslint.lintFiles(filesToLint);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "at-builder",
-    "version": "1.4.0",
+    "version": "1.4.3",
     "main": "bin/index.js",
     "bin": {
         "atb": "bin/index.js"
@@ -22,18 +22,14 @@
     "dependencies": {
         "@babel/core": "^7.26.9",
         "@babel/eslint-parser": "^7.26.8",
-        "@babel/plugin-proposal-class-properties": "^7.18.6",
-        "@babel/plugin-syntax-dynamic-import": "^7.8.3",
         "@babel/plugin-transform-runtime": "^7.18.9",
         "@babel/preset-env": "^7.18.9",
-        "@babel/preset-react": "^7.18.6",
+        "@eslint/eslintrc": "^3.2.0",
         "@eslint/js": "^9.20.0",
         "@types/node": "^22.13.2",
         "async": "^3.2.3",
         "axios": "^1.12.2",
         "babel-loader": "^9.2.1",
-        "babel-plugin-transform-async-to-generator": "^6.24.1",
-        "build": "^0.1.4",
         "chokidar": "^4.0.3",
         "cli-color": "^2.0.3",
         "commander": "^13.1.0",
@@ -50,7 +46,6 @@
         "postcss-loader": "^8.1.1",
         "postcss-preset-env": "^10.1.4",
         "puppeteer": "^24.2.0",
-        "querystring": "^0.2.1",
         "readline": "^1.3.0",
         "sass": "^1.53.0",
         "sass-loader": "^16.0.4",

package/src/constants/config.ts

@@ -76,7 +76,8 @@ ${formatText("COMMANDS", 'yellow', true)}
     ${formatText("sync --scaffold", 'cyan', true)}  Sync and auto-create any missing variation folders with boilerplate
     ${formatText("doctor", 'cyan', true)}         Diagnose and fix project configuration issues
     ${formatText("doctor --fix", 'cyan', true)}   Automatically fix detected configuration issues
-    ${formatText("install-extension", 'cyan', true)}  Install the at-builder VSCode extension from the Marketplace
+    ${formatText("install-extension", 'cyan', true)}  Install the at-builder extension from the Marketplace (default: VSCode)
+    ${formatText("install-extension --editor agy", 'cyan', true)}  Install into Antigravity IDE (also: cursor, codium, etc.)
     
 ${formatText("GLOBAL OPTIONS", 'yellow', true)}
     ${formatText("-v, --verbose", 'green')}       Enable detailed logging
@@ -278,39 +279,36 @@ module.exports = {
 }
 
 /**
- * Reads and returns environment variables from the specified .env file
- * @param {string} basePath - The base path where the .env file is located
- * @returns {Promise<Object>} Object containing environment variables
+ * Reads and returns environment variables from the specified .env file.
+ *
+ * Throws if the file is missing or unreadable. Callers decide whether
+ * to surface the failure — printing here would spam every `atb` run from
+ * a directory that doesn't have a `.env` (e.g. `atb --version` from /tmp).
+ *
+ * @param basePath - The base path where the .env file is located
+ * @returns Object containing environment variables
  */
 export const getENV = async (basePath: string) => {
     const envPath = path.join(basePath, '.env');
-    try {
-        // Check if .env file exists
-        if (!fs.existsSync(envPath)) {
-            throw new Error('.env file not found');
-        }
+    if (!fs.existsSync(envPath)) {
+        throw new Error('.env file not found');
+    }
 
-        // Read the .env file
-        const envContent = await fs.promises.readFile(envPath, { encoding: 'utf8' });
-        
-        // Parse the .env file content
-        const envVars: { [key: string]: string } = {};
-        envContent.split('\n').forEach(line => {
-            line = line.trim();
-            // Skip empty lines and comments
-            if (line && !line.startsWith('#')) {
-                const [key, ...valueParts] = line.split('=');
-                if (key) {
-                    const value = valueParts.join('=').trim();
-                    // Remove quotes if present
-                    envVars[key.trim()] = value.replace(/^["'](.*)["']$/, '$1');
-                }
+    const envContent = await fs.promises.readFile(envPath, { encoding: 'utf8' });
+
+    const envVars: { [key: string]: string } = {};
+    envContent.split('\n').forEach(line => {
+        line = line.trim();
+        // Skip empty lines and comments
+        if (line && !line.startsWith('#')) {
+            const [key, ...valueParts] = line.split('=');
+            if (key) {
+                const value = valueParts.join('=').trim();
+                // Remove quotes if present
+                envVars[key.trim()] = value.replace(/^["'](.*)["']$/, '$1');
             }
-        });
+        }
+    });
 
-        return envVars;
-    } catch (error) {
-        console.error(clc.red(`Error reading .env file: ${error.message}`));
-        throw error;
-    }
+    return envVars;
 };

package/src/index.ts

@@ -114,7 +114,7 @@ const setupCommander = async () => {
     program
         .command('install-extension')
         .description('Install the at-builder VSCode extension from the Marketplace')
-        .option('--editor <bin>', 'Editor CLI to use (e.g. code, cursor, codium)', 'code')
+        .option('--editor <bin>', 'Editor CLI to use (e.g. code, agy, cursor, codium)', 'code')
         .action(async (options, command) => {
             const globalOpts = command.parent.opts();
             await handleInstallExtension(options.editor, globalOpts.verbose);
@@ -250,6 +250,25 @@ const handleSync = async (scaffold: boolean, verbose: boolean): Promise<void> =>
  * using the editor's CLI. Defaults to `code`; users on Cursor/VSCodium
  * can pass --editor.
  */
+/**
+ * Per-editor install hints for when the CLI binary isn't on PATH. Each
+ * recognized editor gets a one-line, copy-pasteable suggestion. Anything
+ * else falls back to a generic hint.
+ */
+const EDITOR_INSTALL_HINTS: Record<string, string> = {
+    code: 'Open VSCode and run Command Palette → "Shell Command: Install \'code\' command in PATH".',
+    agy: 'Open Antigravity IDE and run Command Palette → "Shell Command: Install \'agy\' command in PATH".',
+    cursor: 'Open Cursor and run Command Palette → "Shell Command: Install \'cursor\' command in PATH".',
+    codium: 'Open VSCodium and run Command Palette → "Shell Command: Install \'codium\' command in PATH".',
+};
+
+const reportEditorNotFound = (editor: string): void => {
+    console.error(`❌ "${editor}" CLI not found in PATH.`);
+    const hint = EDITOR_INSTALL_HINTS[editor]
+        || `Make sure the "${editor}" CLI is installed and on your PATH, or pass a different --editor.`;
+    console.error(`💡 ${hint}`);
+};
+
 const handleInstallExtension = async (editor: string, verbose: boolean): Promise<void> => {
     const extensionId = "UpendraSengar.at-builder";
 
@@ -264,12 +283,7 @@ const handleInstallExtension = async (editor: string, verbose: boolean): Promise
 
     result.on("error", (err) => {
         if ((err as NodeJS.ErrnoException).code === "ENOENT") {
-            console.error(`❌ "${editor}" CLI not found in PATH.`);
-            if (editor === "code") {
-                console.error("💡 Open VSCode and run Command Palette → \"Shell Command: Install 'code' command in PATH\".");
-            } else {
-                console.error(`💡 Make sure the "${editor}" CLI is installed and on your PATH, or pass a different --editor.`);
-            }
+            reportEditorNotFound(editor);
         } else {
             console.error(`❌ Failed to launch "${editor}": ${err.message}`);
         }
@@ -281,13 +295,10 @@ const handleInstallExtension = async (editor: string, verbose: boolean): Promise
             console.log("✅ Extension installed. Reload your editor window to activate.");
             return;
         }
+        // 127 = shell's "command not found". With shell:true the spawn 'error'
+        // event never fires for missing CLIs, so we surface the same hint here.
         if (code === 127) {
-            console.error(`❌ "${editor}" CLI not found in PATH.`);
-            if (editor === "code") {
-                console.error("💡 Open VSCode and run Command Palette → \"Shell Command: Install 'code' command in PATH\".");
-            } else {
-                console.error(`💡 Make sure the "${editor}" CLI is installed and on your PATH, or pass a different --editor.`);
-            }
+            reportEditorNotFound(editor);
             process.exit(1);
         }
         console.error(`❌ "${editor} --install-extension" exited with code ${code}.`);