at-builder 1.3.3 → 1.4.1

package/.claude/settings.local.json

@@ -51,7 +51,20 @@
       "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 *)"
     ]
   }
 }

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

@@ -58,16 +58,16 @@ atb deploy
 
 ### **Core Commands**
 
-| Command | Description | Options |
-|---------|-------------|---------|
-| `atb init` | Initialize project with configuration files | |
-| `atb new` | Create new Adobe Target activity with variations | |
-| `atb build` | Build activity for development | `--prod` for production |
-| `atb dev` | Start development server with file watching | `--browser` to open browser |
-| `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 bundled at-builder VSCode extension (.vsix) | `--editor cursor` (or `codium`, etc.) to use a non-VSCode editor CLI |
+| Command                 | Description                                                               | Options                                                              |
+| ----------------------- | ------------------------------------------------------------------------- | -------------------------------------------------------------------- |
+| `atb init`              | Initialize project with configuration files                               |                                                                      |
+| `atb new`               | Create new Adobe Target activity with variations                          |                                                                      |
+| `atb build`             | Build activity for development                                            | `--prod` for production                                              |
+| `atb dev`               | Start development server with file watching                               | `--browser` to open browser                                          |
+| `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 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**
 
@@ -156,7 +156,7 @@ VARIATION="Variation-1"
 # Adobe Target Deployment
 ADOBE_CLIENT_ID="your-client-id"
 ADOBE_CLIENT_SECRET="your-client-secret"
-ADOBE_TENANT=""           # Optional. Your Adobe org slug (e.g. "ups"). Enables clickable AT UI links in deploy/sync output.
+ADOBE_TENANT=""           # Optional. Your Adobe org slug (e.g."tst123"). Enables clickable AT UI links in deploy/sync output.
 ```
 
 ### **Adobe Target Configuration (adobe.config.js)**

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/package.json

@@ -1,6 +1,6 @@
 {
     "name": "at-builder",
-    "version": "1.3.3",
+    "version": "1.4.1",
     "main": "bin/index.js",
     "bin": {
         "atb": "bin/index.js"
@@ -22,18 +22,13 @@
     "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/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 +45,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 bundled at-builder VSCode extension (.vsix)
+    ${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

@@ -113,8 +113,8 @@ const setupCommander = async () => {
 
     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(async (options, command) => {
             const globalOpts = command.parent.opts();
             await handleInstallExtension(options.editor, globalOpts.verbose);
@@ -246,52 +246,44 @@ const handleSync = async (scaffold: boolean, verbose: boolean): Promise<void> =>
 /**
  * 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.
  */
-const handleInstallExtension = async (editor: string, verbose: boolean): Promise<void> => {
-    if (verbose) logger.info("verbose", `Installing VSCode extension via ${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 installRoot = path.join(__dirname, "..");
+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}`);
+};
 
-    let candidates: string[];
-    try {
-        candidates = fs.readdirSync(installRoot)
-            .filter(f => /^at-builder-.+\.vsix$/.test(f))
-            .sort()
-            .reverse(); // latest version first by lexicographic sort
-    } catch (error) {
-        console.error(`❌ Failed to scan at-builder directory: ${error.message}`);
-        process.exit(1);
-    }
+const handleInstallExtension = async (editor: string, verbose: boolean): Promise<void> => {
+    const extensionId = "UpendraSengar.at-builder";
 
-    if (candidates.length === 0) {
-        console.error("❌ No at-builder VSCode extension (.vsix) found bundled with this install.");
-        console.error(`💡 Expected at: ${installRoot}/at-builder-*.vsix`);
-        process.exit(1);
-    }
+    if (verbose) logger.info("verbose", `Installing ${extensionId} via ${editor}`);
 
-    const vsixPath = path.join(installRoot, candidates[0]);
-    console.log(`📦 Installing ${candidates[0]} via "${editor}"...`);
+    console.log(`📦 Installing ${extensionId} from the Marketplace via "${editor}"...`);
 
-    const result = spawn(editor, ["--install-extension", vsixPath], {
+    const result = spawn(editor, ["--install-extension", extensionId], {
         stdio: "inherit",
         shell: true
     });
 
     result.on("error", (err) => {
-        // ENOENT here means the editor binary isn't on PATH.
         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}`);
         }
@@ -306,12 +298,7 @@ const handleInstallExtension = async (editor: string, verbose: boolean): Promise
         // 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}.`);