at-builder 1.2.8 → 1.3.3

package/DEVELOPMENT.md

@@ -0,0 +1,164 @@
+# Local Development
+
+Notes-to-self on how to test `at-builder` against a real consumer project before publishing to npm. Not for end users — this is internal.
+
+---
+
+## TL;DR
+
+```bash
+# one-time setup in this repo
+yarn link
+yarn build:atb:dev &              # leave running; recompiles TS on save
+
+# work against the bundled test/ sandbox (already gitignored, pre-populated)
+cd test
+atb doctor
+atb new
+atb dev --browser
+# ... etc
+```
+
+When done:
+
+```bash
+# in at-builder
+yarn unlink
+```
+
+---
+
+## Two patterns
+
+### 1. `yarn link` — active iteration
+
+Symlinks the global `atb` binary to this repo. Edits to source are picked up on the next invocation (after rebuild for TypeScript).
+
+```bash
+# in at-builder
+yarn link        # or: npm link
+```
+
+`atb` is now a global command pointing at this repo. Run it from any directory.
+
+To remove the symlink later:
+
+```bash
+yarn unlink                  # in at-builder
+yarn unlink at-builder       # in any project that also linked it (rarely needed)
+```
+
+### 2. `npm pack` — pre-publish verification
+
+`yarn link` uses symlinks, which can paper over packaging issues — forgotten `.npmignore` exclusions, missing bundled assets (like `at-builder-*.vsix`), files declared in `package.json` but not actually present, etc. Before `npm publish`, do this to test the **actual artifact** npm will ship:
+
+```bash
+# in at-builder
+yarn build:atb                # ensure bin/ is fresh
+npm pack                      # produces at-builder-<version>.tgz
+
+# in a clean throwaway directory
+mkdir /tmp/atb-publish-test && cd /tmp/atb-publish-test
+npm install -g /path/to/at-builder/at-builder-<version>.tgz
+
+# verify the published surface
+which atb
+atb --version
+atb install-extension --editor code   # confirms the bundled .vsix actually shipped
+atb init
+# ... exercise other commands
+
+# cleanup
+npm uninstall -g at-builder
+rm /path/to/at-builder/at-builder-<version>.tgz
+```
+
+If anything's missing from the tarball, this catches it before users do.
+
+---
+
+## What needs rebuilding
+
+The single thing that bites people most often:
+
+| You edit | Rebuild needed? |
+|---|---|
+| `src/**/*.ts` (CLI surface) | **Yes** — `yarn build:atb` (one-shot) or `yarn build:atb:dev` (`tsc -w`) running in another terminal |
+| `lib/at-deploy.js`, `lib/at-sync.js` | No — plain JS, picked up directly on next `atb` invocation |
+| `puppeteer.js` | No |
+| `webpack.config.js` | No |
+| `.plop/generators/*`, `.plop/templates/*` | No |
+| `babel.config.js`, `eslint.config.js`, `tsconfig.json` | No |
+
+Easiest workflow: open a second terminal in this repo and leave `yarn build:atb:dev` running. Then any `src/` edit is reflected on the next `atb` invocation in your test project.
+
+---
+
+## The bundled `test/` sandbox
+
+This repo ships a `test/` directory (gitignored) pre-populated with `.env`, `adobe.config.js`, `.gitignore`, and `package.json` — basically what `atb init` would create. Use it as a throwaway consumer project:
+
+```bash
+cd test
+atb doctor                    # exercises all checks
+atb doctor --fix              # exercises all auto-fixes (incl. watch-config migration)
+atb new                       # exercise the prompts (AB/XT, page names)
+atb sync                      # if you've set activityInfo.id
+atb dev --browser             # exercise the puppeteer fixes
+atb deploy --dry-run          # test deploy logic without PUTting to AT
+atb install-extension         # test the .vsix install flow
+```
+
+If `test/` ever gets corrupted, just delete its contents and re-run `atb init` — it'll regenerate from scratch.
+
+---
+
+## Publishing checklist
+
+Before `npm publish`:
+
+1. `yarn build:atb` — ensure `bin/` is fresh and committed.
+2. Bump `version` in `package.json`. Use semver:
+   - **patch** — bug fixes, doc changes
+   - **minor** — new commands, new flags, backwards-compatible features
+   - **major** — breaking schema changes (e.g. requiring fields, renaming commands)
+3. `npm pack` and run the verification block above.
+4. `git tag v<version>` + `git push --tags`.
+5. `npm publish`.
+
+---
+
+## Common gotchas
+
+- **`atb` runs the wrong copy (link vs global)** — you have at-builder installed globally from npm AND linked locally. Run `which atb` and `atb --version`; if it doesn't match the local repo, `yarn unlink at-builder` (in linked consumer dirs) and `npm uninstall -g at-builder` to clear stale globals before re-linking.
+- **`atb` resolves to a stale install in a *different* npm prefix** — distinct from the link-vs-global case above. It's easy to end up with at-builder installed at multiple locations (e.g. `/usr/local/lib/node_modules/at-builder` from a system npm AND `~/.nvm/versions/node/<v>/lib/node_modules/at-builder` from nvm). `npm install -g` only writes to the prefix the *currently-active* `npm` uses; a stale install in the *other* prefix can still come first on PATH. Diagnose:
+
+  ```bash
+  which -a atb                       # every atb on PATH
+  npm config get prefix              # where the active npm installs
+  ls -la $(which atb)                # see where the symlink points
+  ```
+
+  If `which -a` lists multiple entries, remove the stale one(s):
+
+  ```bash
+  # active prefix is nvm but a stale /usr/local install is shadowing it:
+  rm -f /usr/local/bin/atb
+  rm -rf /usr/local/lib/node_modules/at-builder
+
+  # or the reverse:
+  rm -f ~/.nvm/versions/node/<v>/bin/atb
+  rm -rf ~/.nvm/versions/node/<v>/lib/node_modules/at-builder
+  ```
+
+  Then reinstall once: `npm install -g /path/to/at-builder-<version>.tgz`.
+
+- **`atb --version` shows the same number after re-packing** — `npm pack` honors whatever's in `package.json`; it doesn't bump for you. If you forgot to update the version before packing, the tarball reports the same number as the previously-published release and `atb --version` looks like nothing changed even though the code did. Always bump `package.json` first (see the publishing checklist for the semver rules), then re-pack. Verify before installing:
+
+  ```bash
+  tar xzOf at-builder-<version>.tgz package/package.json | grep '"version"'
+  ```
+
+- **Edits to `src/` not reflected** — `bin/` is stale. Run `yarn build:atb` or check `yarn build:atb:dev` is actually running.
+- **`npm install` exits 1** — historical issue, the `postinstall` script referenced a missing `bin/postinstall.js`. Already fixed (commit `d3fe05e`); if it resurfaces, drop the `postinstall` line from `package.json` again.
+- **`.vsix` not in tarball** — verify with `npm pack --dry-run` before publishing. The `.vsix` lives at the repo root and is included by default (no `files` field, no `.npmignore` excluding it). If you ever add a `files` field, remember to whitelist `at-builder-*.vsix`.

package/README.md

@@ -64,8 +64,10 @@ atb deploy
 | `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 |
+| `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 |
 
 ### **Examples**
 
@@ -88,6 +90,18 @@ atb dev --browser
 # Deploy to Adobe Target
 atb deploy
 
+# Deploy in dry-run mode (no PUT to Adobe Target)
+atb deploy --dry-run
+
+# Force deploy and skip the 60s cooldown lock
+atb deploy --force
+
+# Sync build.config.json from Adobe Target
+atb sync
+
+# Sync and auto-create any missing variation folders
+atb sync --scaffold
+
 # Check project configuration
 atb doctor
 
@@ -142,6 +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 Target Configuration (adobe.config.js)**

package/bin/constants/config.js

@@ -1,28 +1,75 @@
 "use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getENV = exports.setupEnv = exports.getHelpInfo = exports.getVersion = void 0;
-const path_1 = __importDefault(require("path"));
-const fs_1 = __importDefault(require("fs"));
-const cli_color_1 = __importDefault(require("cli-color"));
+exports.getENV = exports.GITIGNORE_TEMPLATE = exports.setupEnv = exports.getHelpInfo = exports.getVersion = void 0;
+var path_1 = __importDefault(require("path"));
+var fs_1 = __importDefault(require("fs"));
+var cli_color_1 = __importDefault(require("cli-color"));
 /**
  * Reads and returns the version from package.json
  * @returns {Promise<string>} The version of the package
  */
-const getVersion = async () => {
-    const packageJSONPath = path_1.default.resolve(__dirname, "../../package.json");
-    try {
-        const content = await fs_1.default.promises.readFile(packageJSONPath, { encoding: "utf8" });
-        const config = JSON.parse(content);
-        return config.version;
-    }
-    catch (error) {
-        console.error(cli_color_1.default.red("Error reading package.json or parsing JSON"));
-        process.exit(1); // Exit the process if package.json is not found or malformed
-    }
-};
+var getVersion = function () { return __awaiter(void 0, void 0, void 0, function () {
+    var packageJSONPath, content, config, error_1;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0:
+                packageJSONPath = path_1.default.resolve(__dirname, "../../package.json");
+                _a.label = 1;
+            case 1:
+                _a.trys.push([1, 3, , 4]);
+                return [4 /*yield*/, fs_1.default.promises.readFile(packageJSONPath, { encoding: "utf8" })];
+            case 2:
+                content = _a.sent();
+                config = JSON.parse(content);
+                return [2 /*return*/, config.version];
+            case 3:
+                error_1 = _a.sent();
+                console.error(cli_color_1.default.red("Error reading package.json or parsing JSON"));
+                process.exit(1); // Exit the process if package.json is not found or malformed
+                return [3 /*break*/, 4];
+            case 4: return [2 /*return*/];
+        }
+    });
+}); };
 exports.getVersion = getVersion;
 exports.getVersion = exports.getVersion;
 /**
@@ -33,10 +80,13 @@ exports.getVersion = exports.getVersion;
  * @param {boolean} underline Whether to underline the text
  * @returns {string} The formatted text
  */
-const formatText = (text, color = "white", bold = false, underline = false) => {
-    let formattedText = text;
+var formatText = function (text, color, bold, underline) {
+    if (color === void 0) { color = "white"; }
+    if (bold === void 0) { bold = false; }
+    if (underline === void 0) { underline = false; }
+    var formattedText = text;
     // Apply color
-    const colorFn = cli_color_1.default[color];
+    var colorFn = cli_color_1.default[color];
     if (typeof colorFn === 'function') {
         formattedText = colorFn(text);
     }
@@ -51,116 +101,72 @@ const formatText = (text, color = "white", bold = false, underline = false) => {
  * Returns help information with commands and usage
  * @returns {Promise<string>} The help text
  */
-const getHelpInfo = async () => {
-    const version = await (0, exports.getVersion)();
-    return `
-${formatText(`🎯 at-builder`, 'cyan', true)} ${formatText(`v${version}`, 'gray')}
-
-${formatText("Adobe Target Activity Development CLI", 'white', true)}
-
-A streamlined command-line tool for creating, building, and deploying Adobe Target 
-A/B testing activities with modern web technologies.
-
-${formatText("USAGE", 'yellow', true)}
-    ${formatText("atb", 'cyan')} ${formatText("<command> [options]", 'gray')}
-
-${formatText("COMMANDS", 'yellow', true)}
-    ${formatText("init", 'cyan', true)}           Initialize project with .env configuration and templates
-    ${formatText("new", 'cyan', true)}            Create a new Adobe Target activity with variations
-    ${formatText("build", 'cyan', true)}          Build activity for development
-    ${formatText("build --prod", 'cyan', true)}   Build for production deployment
-    ${formatText("dev", 'cyan', true)}            Start development server with file watching
-    ${formatText("dev --browser", 'cyan', true)}  Start development server and open in browser
-    ${formatText("deploy", 'cyan', true)}         Deploy activity to Adobe Target
-    ${formatText("deploy --dry-run", 'cyan', true)} Deploy in dry-run mode without actual deployment
-    ${formatText("doctor", 'cyan', true)}         Diagnose and fix project configuration issues
-    ${formatText("doctor --fix", 'cyan', true)}   Automatically fix detected configuration issues
-    
-${formatText("GLOBAL OPTIONS", 'yellow', true)}
-    ${formatText("-v, --verbose", 'green')}       Enable detailed logging
-    ${formatText("-V, --version", 'green')}       Display version information
-    ${formatText("-h, --help", 'green')}          Show help information
-
-${formatText("EXAMPLES", 'yellow', true)}
-    ${formatText("# Initialize new project", 'gray')}
-    ${formatText("atb init", 'white')}
-    
-    ${formatText("# Create new activity", 'gray')}
-    ${formatText("atb new", 'white')}
-    
-    ${formatText("# Development build with hot reload", 'gray')}
-    ${formatText("atb build", 'white')}
-    
-    ${formatText("# Production build for Adobe Target deployment", 'gray')}
-    ${formatText("atb build --prod", 'white')}
-    
-    ${formatText("# Development server with browser", 'gray')}
-    ${formatText("atb dev --browser", 'white')}
-    
-    ${formatText("# Deploy to Adobe Target", 'gray')}
-    ${formatText("atb deploy", 'white')}
-    
-    ${formatText("# Deploy in dry-run mode", 'gray')}
-    ${formatText("atb deploy --dry-run", 'white')}
-    
-    ${formatText("# Check project configuration", 'gray')}
-    ${formatText("atb doctor", 'white')}
-    
-    ${formatText("# Auto-fix configuration issues", 'gray')}
-    ${formatText("atb doctor --fix", 'white')}
-
-${formatText("WORKFLOW", 'yellow', true)}
-    ${formatText("1.", 'cyan')} Run ${formatText("atb init", 'white')} to set up project configuration
-    ${formatText("2.", 'cyan')} Run ${formatText("atb new", 'white')} to create activity templates  
-    ${formatText("3.", 'cyan')} Develop variations in ${formatText("/Activities/{name}/Variation-*/", 'gray')}
-    ${formatText("4.", 'cyan')} Run ${formatText("atb build", 'white')} for development testing
-    ${formatText("5.", 'cyan')} Run ${formatText("atb build --prod", 'white')} for Adobe Target deployment
-    ${formatText("6.", 'cyan')} Run ${formatText("atb deploy", 'white')} to deploy to Adobe Target
-
-${formatText("SUPPORT", 'yellow', true)}
-    Repository: ${formatText("https://github.com/upesenga/at-builder", 'blue')}
-    Issues:     ${formatText("https://github.com/upesenga/at-builder/issues", 'blue')}
-    License:    ${formatText("MIT", 'green')}
-`;
-};
+var getHelpInfo = function () { return __awaiter(void 0, void 0, void 0, function () {
+    var version;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            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")];
+        }
+    });
+}); };
 exports.getHelpInfo = getHelpInfo;
-const setupEnv = async (basePath) => {
-    // Path to the .env file
-    const envPath = path_1.default.join(basePath, '.env');
-    // Check if the .env file exists
-    if (!fs_1.default.existsSync(envPath)) {
-        // Define the content of the .env file
-        const envContent = `
-ACTIVITIES_BASE_FOLDER="Activities"
-ACTIVITY_FOLDER_NAME=""
-PUPPETEER_LANDING_PAGE=""
-TARGET_URL=""
-LOGIN_URL=""
-VARIATION="Variation-1"
-NODE_ENV="development"
-VERBOSE=false
-
-# Adobe Target Deployment Configuration
-ADOBE_CLIENT_ID=""
-ADOBE_CLIENT_SECRET=""
-    `;
-        // Write the content to the .env file
-        fs_1.default.writeFileSync(envPath, envContent.trim(), 'utf8');
-        console.log('.env file created successfully!');
+var setupEnv = function (basePath) { return __awaiter(void 0, void 0, void 0, function () {
+    var envPath, envContent;
+    return __generator(this, function (_a) {
+        envPath = path_1.default.join(basePath, '.env');
+        // Check if the .env file exists
+        if (!fs_1.default.existsSync(envPath)) {
+            envContent = "\nACTIVITIES_BASE_FOLDER=\"Activities\"\nACTIVITY_FOLDER_NAME=\"\"\nPUPPETEER_LANDING_PAGE=\"\"\nTARGET_URL=\"\"\nLOGIN_URL=\"\"\n\n# Dev-server selection (used by `atb dev --browser`).\n# Edit and save while puppeteer is running to hot-swap the previewed bundle.\n# PAGE is only meaningful for multi-page activities \u2014 leave empty otherwise.\nVARIATION=\"Variation-1\"\nPAGE=\"\"\n\nNODE_ENV=\"development\"\nVERBOSE=false\n\n# Adobe Target Deployment Configuration\n# ADOBE_TENANT is your AT tenant slug \u2014 find it in the AT URL after \"mc.adobe.io/\".\nADOBE_TENANT=\"\"\nADOBE_CLIENT_ID=\"\"\nADOBE_CLIENT_SECRET=\"\"\n    ";
+            // Write the content to the .env file
+            fs_1.default.writeFileSync(envPath, envContent.trim(), 'utf8');
+            console.log('.env file created successfully!');
+        }
+        else {
+            console.log('.env file already exists!');
+        }
+        // watch-config.json is no longer scaffolded by `atb init` — VARIATION/PAGE
+        // now live in .env. Existing projects with a watch-config.json keep working
+        // (puppeteer.js prefers it with a deprecation warning); `atb doctor --fix`
+        // migrates the values into .env and deletes the legacy file.
+        createAdobeConfig(basePath);
+        createGitignore(basePath);
+        return [2 /*return*/];
+    });
+}); };
+exports.setupEnv = setupEnv;
+/**
+ * Default .gitignore content for at-builder consumer projects.
+ *
+ * Shared between `atb init` (via setupEnv) and `atb doctor --fix` so the two
+ * paths stay in lockstep. Covers secrets, deploy-runtime artifacts, build
+ * output, and OS noise. Does NOT ignore the Activities folder — those are the
+ * user's source files and should be committed.
+ */
+exports.GITIGNORE_TEMPLATE = "# Dependencies\nnode_modules/\n\n# Environment / secrets \u2014 never commit\n.env\n.env.local\n\n# Adobe Target deploy runtime (cooldown lock written by `atb deploy`)\n.deploy-lock\n\n# Build output (regenerated by `atb build`)\ndist/\n\n# OS noise\n.DS_Store\n\n# Editor / local-history\n.history/\n\n# Logs\n*.log\nnpm-debug.log*\n";
+var createGitignore = function (basePath) {
+    var gitignorePath = path_1.default.join(basePath, '.gitignore');
+    if (!fs_1.default.existsSync(gitignorePath)) {
+        fs_1.default.writeFileSync(gitignorePath, exports.GITIGNORE_TEMPLATE, 'utf8');
+        console.log('.gitignore file created successfully!');
     }
     else {
-        console.log('.env file already exists!');
+        console.log('.gitignore file already exists!');
     }
-    createWatchConfig(basePath);
-    createAdobeConfig(basePath);
 };
-exports.setupEnv = setupEnv;
-const createWatchConfig = (basePath) => {
+var createWatchConfig = function (basePath) {
     // Path to the watch-config.json file
-    const watchConfigPath = path_1.default.join(basePath, 'watch-config.json');
-    // Default content for watch-config.json
-    const watchConfigContent = {
-        "VARIATION": "Variation-1"
+    var watchConfigPath = path_1.default.join(basePath, 'watch-config.json');
+    // Default content for watch-config.json.
+    //   VARIATION : which variation/experience to preview in `atb dev --browser`
+    //   PAGE      : leave empty for single-page activities; set to the page
+    //               subfolder name (e.g. "Global", "Cart") for multi-page.
+    //               Editing this file mid-session hot-swaps the preview.
+    var watchConfigContent = {
+        "VARIATION": "Variation-1",
+        "PAGE": ""
     };
     // Check if the watch-config.json file already exists
     if (!fs_1.default.existsSync(watchConfigPath)) {
@@ -171,23 +177,11 @@ const createWatchConfig = (basePath) => {
         console.log('watch-config.json file already exists!');
     }
 };
-const createAdobeConfig = (basePath) => {
+var createAdobeConfig = function (basePath) {
     // Path to the adobe.config.js file
-    const adobeConfigPath = path_1.default.join(basePath, 'adobe.config.js');
+    var adobeConfigPath = path_1.default.join(basePath, 'adobe.config.js');
     // Default content for adobe.config.js
-    const adobeConfigContent = `/**
- * Adobe Target API Configuration
- * 
- * Configuration constants for Adobe Target API integration.
- * These values are used by the deployment script to connect to Adobe Target.
- */
-
-module.exports = {
-    BASE_URL_NEW: 'https://mc.adobe.io/ups/target/',
-    BASE_URL: 'https://mc.adobe.io/ups/target/activities/ab/',
-    IMS_TOKEN_URL: 'https://ims-na1.adobelogin.com/ims/token/v3',
-    IMS_SCOPE: 'openid,AdobeID,target_sdk,additional_info.projectedProductContext'
-};`;
+    var adobeConfigContent = "/**\n * Adobe Target API Configuration\n *\n * Used by at-sync.js and at-deploy.js. BASE_URL is the activities root \u2014\n * callers append `${activityType}/${activityId}` (e.g. ab/12345, xt/67890).\n *\n * ADOBE_TENANT comes from the consumer .env. Both at-sync and at-deploy load\n * dotenv before requiring this file, so process.env is populated by the time\n * BASE_URL is built.\n */\n\nconst TENANT = process.env.ADOBE_TENANT || 'YOUR_TENANT';\n\nmodule.exports = {\n    BASE_URL: `https://mc.adobe.io/${TENANT}/target/activities/`,\n    IMS_TOKEN_URL: 'https://ims-na1.adobelogin.com/ims/token/v3',\n    IMS_SCOPE: 'openid,AdobeID,target_sdk,additional_info.projectedProductContext'\n};";
     // Check if the adobe.config.js file already exists
     if (!fs_1.default.existsSync(adobeConfigPath)) {
         fs_1.default.writeFileSync(adobeConfigPath, adobeConfigContent, 'utf8');
@@ -202,34 +196,42 @@ module.exports = {
  * @param {string} basePath - The base path where the .env file is located
  * @returns {Promise<Object>} Object containing environment variables
  */
-const getENV = async (basePath) => {
-    const envPath = path_1.default.join(basePath, '.env');
-    try {
-        // Check if .env file exists
-        if (!fs_1.default.existsSync(envPath)) {
-            throw new Error('.env file not found');
-        }
-        // Read the .env file
-        const envContent = await fs_1.default.promises.readFile(envPath, { encoding: 'utf8' });
-        // Parse the .env file content
-        const envVars = {};
-        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');
+var getENV = function (basePath) { return __awaiter(void 0, void 0, void 0, function () {
+    var envPath, envContent, envVars_1, error_2;
+    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 envVars;
-    }
-    catch (error) {
-        console.error(cli_color_1.default.red(`Error reading .env file: ${error.message}`));
-        throw error;
-    }
-};
+                return [4 /*yield*/, fs_1.default.promises.readFile(envPath, { encoding: 'utf8' })];
+            case 2:
+                envContent = _a.sent();
+                envVars_1 = {};
+                envContent.split('\n').forEach(function (line) {
+                    line = line.trim();
+                    // Skip empty lines and comments
+                    if (line && !line.startsWith('#')) {
+                        var _a = line.split('='), key = _a[0], valueParts = _a.slice(1);
+                        if (key) {
+                            var value = valueParts.join('=').trim();
+                            // Remove quotes if present
+                            envVars_1[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*/];
+        }
+    });
+}); };
 exports.getENV = getENV;