@mondaydotcomorg/z2h-cli 0.15.0 → 0.15.2-feat-eitantsh-z2h-admin-panel-package-388aad6

package/src/index.ts

@@ -17,7 +17,7 @@ import { migrateCommand } from './commands/migrate';
 import { tagCommand } from './commands/tag';
 import { editCommand } from './commands/edit';
 import { doctorCommand } from './commands/doctor';
-import { errorLog, fail, getOutputMode } from './util/logger';
+import { errorLog, fail, getOutputMode, setOutputMode } from './util/logger';
 import { trackDuration } from './util/tracker';
 import { getCwdAppName } from './util/app-name';
 
@@ -69,15 +69,20 @@ async function main(): Promise<void> {
         '  2  system error (yarn install or trident build failed)',
       ].join('\n')
     )
-    .version(version);
+    .version(version)
+    .option('--json', 'emit structured JSON on stdout')
+    .hook('preAction', (_thisCommand, actionCommand) => {
+      if (actionCommand.optsWithGlobals<{ json?: boolean }>().json) {
+        setOutputMode('json');
+      }
+    });
 
   program
     .command('build')
     .description('Build the consumer into its .zth/ shadow and copy artifacts to ./build/')
-    .option('--json', 'emit structured JSON on stdout')
-    .action(async (opts: { json?: boolean }) => {
+    .action(async () => {
       try {
-        await trackDuration('z2h_app_build_success', () => buildCommand(opts), { app_name: getCwdAppName() });
+        await trackDuration('z2h_app_build_success', () => buildCommand(), { app_name: getCwdAppName() });
       } catch (err) {
         await fail(`build failed: ${(err as Error).message}`, { command: 'build' }, 2);
       }
@@ -87,8 +92,7 @@ async function main(): Promise<void> {
     .command('dev')
     .description('Start the Trident dev server against .zth/ with native Vite HMR')
     .option('--open', 'open the browser automatically when the dev server is ready')
-    .option('--json', 'emit structured JSON on stdout')
-    .action(async (opts: { open?: boolean; json?: boolean }) => {
+    .action(async (opts: { open?: boolean }) => {
       try {
         await devCommand(opts);
       } catch (err) {
@@ -99,10 +103,9 @@ async function main(): Promise<void> {
   program
     .command('clean')
     .description('Delete <consumer>/.zth/ and <consumer>/build/')
-    .option('--json', 'emit structured JSON on stdout')
-    .action(async (opts: { json?: boolean }) => {
+    .action(async () => {
       try {
-        await cleanCommand(opts);
+        await cleanCommand();
       } catch (err) {
         await fail(`clean failed: ${(err as Error).message}`, { command: 'clean' }, 2);
       }
@@ -112,7 +115,6 @@ async function main(): Promise<void> {
     .command('deploy')
     .description('Build, upload to S3, and register the app with the Z2H backend')
     .option('--dry-run', 'print what would happen without uploading anything')
-    .option('--json', 'emit structured JSON on stdout')
     .option(
       '--remote <type>',
       'First deploy only: source control remote to initialise — s3 (shared storage) or github (your repo). Error if the app already has a git remote.'
@@ -121,7 +123,7 @@ async function main(): Promise<void> {
       '--repo-url <url>',
       'First deploy only: GitHub repo URL — required when --remote=github. Error if the app already has a git remote.'
     )
-    .action(async (opts: { dryRun?: boolean; json?: boolean; remote?: string; repoUrl?: string }) => {
+    .action(async (opts: { dryRun?: boolean; remote?: string; repoUrl?: string }) => {
       try {
         await trackDuration(
           'z2h_app_deploy_success',
@@ -139,8 +141,7 @@ async function main(): Promise<void> {
     .command('tag [app-name]')
     .description("Set an app's category tags — app type & team (interactive unless --tag or --json is given)")
     .option('--tag <tag>', 'set a tag (repeatable); full-replaces the tag set non-interactively', collectTag, [])
-    .option('--json', "read-only: print the popular catalog + the app's current tags as JSON (no prompt)")
-    .action(async (appName: string | undefined, opts: { tag?: string[]; json?: boolean }) => {
+    .action(async (appName: string | undefined, opts: { tag?: string[] }) => {
       try {
         await trackDuration('z2h_app_tag_success', () => tagCommand(appName, opts), {
           app_name: appName ?? getCwdAppName(),
@@ -153,10 +154,9 @@ async function main(): Promise<void> {
   program
     .command('create-workspace')
     .description(`Bootstrap the ${getWorkspaceHome()}/ yarn workspace (one-time setup)`)
-    .option('--json', 'emit structured JSON on stdout')
-    .action(async (opts: { json?: boolean }) => {
+    .action(async () => {
       try {
-        await createWorkspaceCommand(opts);
+        await createWorkspaceCommand();
       } catch (err) {
         await fail(`create-workspace failed: ${(err as Error).message}`, { command: 'create-workspace' }, 1);
       }
@@ -169,8 +169,7 @@ async function main(): Promise<void> {
     )
     .option('--no-browser', "don't auto-open the browser; print the URL and prompt for manual paste")
     .option('--url <url>', 'Override the token page URL (e.g. for staging)')
-    .option('--json', 'emit structured JSON on stdout')
-    .action(async (opts: { noBrowser?: boolean; url?: string; json?: boolean }) => {
+    .action(async (opts: { noBrowser?: boolean; url?: string }) => {
       try {
         await generateZ2HTokenCommand(opts);
       } catch (err) {
@@ -185,12 +184,8 @@ async function main(): Promise<void> {
     .option('--html-file <path>', 'Path to an HTML file to embed (implies --template html-embed)')
     .option('--remote <type>', 'Source control remote: s3 (shared storage) or github (your repo)')
     .option('--repo-url <url>', 'GitHub repo URL — required when --remote=github')
-    .option('--json', 'emit structured JSON on stdout')
     .action(
-      async (
-        appName: string,
-        opts: { template?: string; htmlFile?: string; remote?: string; repoUrl?: string; json?: boolean }
-      ) => {
+      async (appName: string, opts: { template?: string; htmlFile?: string; remote?: string; repoUrl?: string }) => {
         try {
           await trackDuration('z2h_app_created', () => createCommand(appName, opts as CreateOptions), {
             app_name: appName,
@@ -206,10 +201,9 @@ async function main(): Promise<void> {
   program
     .command('edit <app-name>')
     .description(`Pull the latest version of an app into ${getWorkspaceHome()}/<app-name>, cloning it first if needed`)
-    .option('--json', 'emit structured JSON on stdout')
-    .action(async (appName: string, opts: { json?: boolean }) => {
+    .action(async (appName: string) => {
       try {
-        await trackDuration('z2h_app_edit_pulled', () => editCommand(appName, opts), {
+        await trackDuration('z2h_app_edit_pulled', () => editCommand(appName), {
           app_name: appName,
         });
       } catch (err) {
@@ -222,8 +216,7 @@ async function main(): Promise<void> {
     .description('Grant access to the current app (email, --public, or both)')
     .option('--public', 'make the app visible to all monday.com employees')
     .option('--level <level>', 'access level for user grants: owner, editor, or viewer (default: viewer)')
-    .option('--json', 'emit structured JSON on stdout')
-    .action(async (email: string | undefined, opts: { public?: boolean; level?: string; json?: boolean }) => {
+    .action(async (email: string | undefined, opts: { public?: boolean; level?: string }) => {
       try {
         await grantCommand(email, opts as Parameters<typeof grantCommand>[1]);
       } catch (err) {
@@ -235,8 +228,7 @@ async function main(): Promise<void> {
     .command('revoke [email]')
     .description('Revoke access to the current app (email or --public; owners/admins only)')
     .option('--public', 'remove the public grant, making the app visible to owners/admins only')
-    .option('--json', 'emit structured JSON on stdout')
-    .action(async (email: string | undefined, opts: { public?: boolean; json?: boolean }) => {
+    .action(async (email: string | undefined, opts: { public?: boolean }) => {
       try {
         await revokeCommand(email, opts as Parameters<typeof revokeCommand>[1]);
       } catch (err) {
@@ -247,10 +239,9 @@ async function main(): Promise<void> {
   program
     .command('transfer-owner [email]')
     .description('Transfer ownership of the current app to another monday.com user')
-    .option('--json', 'emit structured JSON on stdout')
-    .action(async (email: string | undefined, opts: { json?: boolean }) => {
+    .action(async (email: string | undefined) => {
       try {
-        await transferOwnerCommand(email, opts);
+        await transferOwnerCommand(email);
       } catch (err) {
         await fail(`transfer-owner failed: ${(err as Error).message}`, { command: 'transfer-owner' }, 1);
       }
@@ -260,8 +251,7 @@ async function main(): Promise<void> {
     .command('delete')
     .description('Permanently delete the current app and take it offline (owners/admins only)')
     .option('--yes', 'skip the confirmation prompt (required for --json / non-interactive)')
-    .option('--json', 'emit structured JSON on stdout')
-    .action(async (opts: { yes?: boolean; json?: boolean }) => {
+    .action(async (opts: { yes?: boolean }) => {
       try {
         await trackDuration('z2h_app_delete_success', () => deleteCommand(opts), {
           app_name: getCwdAppName(),
@@ -275,8 +265,7 @@ async function main(): Promise<void> {
     .command('migrate')
     .description('Run pending workspace migrations')
     .option('--dry-run', 'show pending migrations without applying any changes')
-    .option('--json', 'emit structured JSON on stdout')
-    .action(async (opts: { dryRun?: boolean; json?: boolean }) => {
+    .action(async (opts: { dryRun?: boolean }) => {
       try {
         await migrateCommand(version, opts);
       } catch (err) {
@@ -287,10 +276,9 @@ async function main(): Promise<void> {
   program
     .command('doctor')
     .description('Check that all Z2H tools, auth, workspace, and plugins are correctly set up')
-    .option('--json', 'emit structured JSON on stdout')
-    .action(async (opts: { json?: boolean }) => {
+    .action(async () => {
       try {
-        await doctorCommand(opts);
+        await doctorCommand();
       } catch (err) {
         await fail(`doctor failed: ${(err as Error).message}`, { command: 'doctor' }, 1);
       }

package/src/util/tracker.ts

@@ -1,11 +1,16 @@
 import os from 'node:os';
 
 const DOORMAN_URL = 'https://track-int.bigbrain.me/prod/event';
+const DOORMAN_URL_STAGING = 'https://track-int.bigbrainstaging.me/stage/event';
 
 const username = os.userInfo().username;
 
+const isStaging = process.env.NODE_ENV === 'staging';
+
 export async function trackEvent(name: string, data: Record<string, unknown>): Promise<void> {
-  await fetch(DOORMAN_URL, {
+  const doormanUrl = isStaging ? DOORMAN_URL_STAGING : DOORMAN_URL;
+
+  await fetch(doormanUrl, {
     method: 'POST',
     headers: { 'Content-Type': 'application/json' },
     body: JSON.stringify({ name, source: 'z2h-cli', data: { user_name: username, ...data } }),

package/src/util/workspace.ts

@@ -1,6 +1,9 @@
 import path from 'node:path';
 import os from 'node:os';
-import { pathExists, readJson } from 'fs-extra';
+import { createRequire } from 'node:module';
+import { pathExists, readJson, writeFile, writeJson } from 'fs-extra';
+import { execa } from 'execa';
+import { info, warn } from './logger';
 
 export const WORKSPACE_DIR_NAME = 'zth-projects';
 export const WORKSPACE_MARKER_FIELD = 'z2hWorkspace';
@@ -50,3 +53,74 @@ export async function assertWorkspace(): Promise<string> {
       `(or set Z2H_WORKSPACE_HOME if you keep the workspace elsewhere).`
   );
 }
+
+export async function runYarnInstall(workspaceHome: string, context: string): Promise<boolean> {
+  info(`${context} — running yarn install...`);
+  try {
+    await execa('yarn', ['install'], { cwd: workspaceHome, stdio: 'pipe' });
+    return true;
+  } catch (err) {
+    const stderr = (err as { stderr?: string }).stderr || (err as Error).message;
+    warn(`yarn install failed: ${stderr}`);
+    return false;
+  }
+}
+
+async function getLatestTrientMonorepoVersion(): Promise<string> {
+  try {
+    const { stdout } = await execa('npm', ['view', '@mondaydotcomorg/trident-monorepo', 'version']);
+    return `^${stdout.trim()}`;
+  } catch {
+    return '*';
+  }
+}
+
+export function isNxAvailable(workspaceHome: string): boolean {
+  try {
+    const wsRequire = createRequire(path.join(workspaceHome, 'package.json'));
+    wsRequire.resolve('nx/src/generators/tree');
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+const NX_JSON_CONTENT = '{\n  "extends": "@mondaydotcomorg/trident-monorepo/presets/nx.json"\n}\n';
+
+export async function ensureWorkspaceNx(workspaceHome: string): Promise<boolean> {
+  const nxJsonPath = path.join(workspaceHome, 'nx.json');
+  const pkgPath = path.join(workspaceHome, 'package.json');
+
+  if (!(await pathExists(nxJsonPath))) {
+    await writeFile(nxJsonPath, NX_JSON_CONTENT);
+    info('added nx.json to workspace');
+  }
+
+  const pkg = (await readJson(pkgPath)) as {
+    devDependencies?: Record<string, string>;
+    scripts?: Record<string, string>;
+  };
+
+  if (!pkg.devDependencies?.['@mondaydotcomorg/trident-monorepo']) {
+    pkg.devDependencies = pkg.devDependencies ?? {};
+    pkg.devDependencies['@mondaydotcomorg/trident-monorepo'] = await getLatestTrientMonorepoVersion();
+  }
+
+  if (!pkg.scripts?.nx) {
+    pkg.scripts = pkg.scripts ?? {};
+    pkg.scripts.nx = 'nx';
+  }
+
+  await writeJson(pkgPath, pkg, { spaces: 2 });
+
+  // Only install if NX isn't already importable from the workspace
+  if (!isNxAvailable(workspaceHome)) {
+    const ok = await runYarnInstall(workspaceHome, 'NX not found, installing');
+    if (!ok) {
+      warn('workspace migrations require NX. Fix the install error and run "z2h-cli migrate" to retry.');
+      return false;
+    }
+  }
+
+  return true;
+}

package/dist/esm/migrations/auto-migrate.d.ts

@@ -1,2 +0,0 @@
-export declare function autoMigrate(cliVersion: string, dryRun?: boolean): Promise<void>;
-//# sourceMappingURL=auto-migrate.d.ts.map

package/dist/esm/migrations/auto-migrate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"auto-migrate.d.ts","sourceRoot":"","sources":["../../../src/migrations/auto-migrate.ts"],"names":[],"mappings":"AAsHA,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAkGnF"}

package/dist/esm/migrations/auto-migrate.mjs

@@ -1,169 +0,0 @@
-import { createRequire } from 'node:module';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { pathExists, readJson, writeJson, writeFile } from 'fs-extra';
-import { execa } from 'execa';
-import semver from 'semver';
-import { warn, info, errorLog } from '../util/logger.mjs';
-import { getWorkspaceHome, isZ2hWorkspace } from '../util/workspace.mjs';
-
-const STATE_FILE = '.z2h-migrations-state.json';
-const NX_JSON_CONTENT = '{\n  "extends": "@mondaydotcomorg/trident-monorepo/presets/nx.json"\n}\n';
-// ─── Helpers ───
-async function readState(workspaceHome) {
-    const statePath = path.join(workspaceHome, STATE_FILE);
-    if (!(await pathExists(statePath))) {
-        return null;
-    }
-    try {
-        return (await readJson(statePath));
-    }
-    catch {
-        return null;
-    }
-}
-async function writeState(workspaceHome, state) {
-    const statePath = path.join(workspaceHome, STATE_FILE);
-    await writeJson(statePath, state, { spaces: 2 });
-}
-async function yarnInstall(workspaceHome, context) {
-    info(`${context} — running yarn install...`);
-    try {
-        await execa('yarn', ['install'], { cwd: workspaceHome, stdio: 'pipe' });
-        return true;
-    }
-    catch (err) {
-        const stderr = err.stderr || err.message;
-        warn(`yarn install failed: ${stderr}`);
-        return false;
-    }
-}
-async function getLatestTrientMonorepoVersion() {
-    try {
-        const { stdout } = await execa('npm', ['view', '@mondaydotcomorg/trident-monorepo', 'version']);
-        return `^${stdout.trim()}`;
-    }
-    catch {
-        return '*';
-    }
-}
-// ─── Workspace bootstrap ───
-function isNxAvailable(workspaceHome) {
-    try {
-        const wsRequire = createRequire(path.join(workspaceHome, 'package.json'));
-        wsRequire.resolve('nx/src/generators/tree');
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-async function ensureWorkspaceNx(workspaceHome) {
-    const nxJsonPath = path.join(workspaceHome, 'nx.json');
-    const pkgPath = path.join(workspaceHome, 'package.json');
-    if (!(await pathExists(nxJsonPath))) {
-        await writeFile(nxJsonPath, NX_JSON_CONTENT);
-        info('added nx.json to workspace');
-    }
-    const pkg = (await readJson(pkgPath));
-    if (!pkg.devDependencies?.['@mondaydotcomorg/trident-monorepo']) {
-        pkg.devDependencies = pkg.devDependencies ?? {};
-        pkg.devDependencies['@mondaydotcomorg/trident-monorepo'] = await getLatestTrientMonorepoVersion();
-    }
-    if (!pkg.scripts?.nx) {
-        pkg.scripts = pkg.scripts ?? {};
-        pkg.scripts.nx = 'nx';
-    }
-    await writeJson(pkgPath, pkg, { spaces: 2 });
-    // Only install if NX isn't already importable from the workspace
-    if (!isNxAvailable(workspaceHome)) {
-        const ok = await yarnInstall(workspaceHome, 'NX not found, installing');
-        if (!ok) {
-            warn('workspace migrations require NX. Fix the install error and run "z2h-cli migrate" to retry.');
-            return false;
-        }
-    }
-    return true;
-}
-// ─── Main ───
-async function autoMigrate(cliVersion, dryRun = false) {
-    const workspaceHome = getWorkspaceHome();
-    if (!(await isZ2hWorkspace(workspaceHome))) {
-        warn('no Z2H workspace found');
-        return;
-    }
-    const state = await readState(workspaceHome);
-    const lastVersion = state?.lastMigratedVersion ?? '0.0.0';
-    if (!semver.gt(cliVersion, lastVersion)) {
-        info('workspace is up to date — no migrations pending');
-        return;
-    }
-    info(`migrating workspace from v${lastVersion} → v${cliVersion}...`);
-    // migrations.json is at the package root — two dirs up from dist/migrations/
-    const thisDir = path.dirname(fileURLToPath(import.meta.url));
-    const migrationsJsonPath = path.resolve(thisDir, '..', '..', 'migrations.json');
-    if (!(await pathExists(migrationsJsonPath))) {
-        warn('migrations.json not found — skipping migrations');
-        return;
-    }
-    const migrationsJson = (await readJson(migrationsJsonPath));
-    // Filter to pending migrations (version > lastVersion AND <= cliVersion).
-    // CONVENTION: a migration's `version` field must equal the CLI release it
-    // ships with (not the feature branch version). This ensures the `gt` check
-    // always catches a migration on the exact upgrade that introduces it.
-    const pending = Object.entries(migrationsJson.migrations)
-        .filter(([, entry]) => semver.gt(entry.version, lastVersion) && semver.lte(entry.version, cliVersion))
-        .sort(([, a], [, b]) => semver.compare(a.version, b.version));
-    if (dryRun) {
-        info(`${pending.length} pending migration(s) (dry-run — no changes will be applied):`);
-        for (const [, entry] of pending) {
-            info(`  - ${entry.description} (v${entry.version})`);
-        }
-        return;
-    }
-    if (pending.length === 0) {
-        await writeState(workspaceHome, { lastMigratedVersion: cliVersion });
-        return;
-    }
-    const nxReady = await ensureWorkspaceNx(workspaceHome);
-    if (!nxReady) {
-        return;
-    }
-    info(`applying ${pending.length} workspace migration(s)...`);
-    // Resolve NX from the workspace's node_modules (not from CLI's own deps)
-    const wsRequire = createRequire(path.join(workspaceHome, 'package.json'));
-    const { FsTree, flushChanges } = wsRequire('nx/src/generators/tree');
-    let needsInstall = false;
-    for (const [name, entry] of pending) {
-        const tree = new FsTree(workspaceHome, false);
-        try {
-            const factoryPath = path.resolve(path.dirname(migrationsJsonPath), entry.migrate);
-            const mod = require(factoryPath);
-            const fn = mod.default || mod;
-            fn(tree);
-            const changes = tree.listChanges();
-            if (changes.length > 0) {
-                if (changes.some(c => c.path.endsWith('package.json'))) {
-                    needsInstall = true;
-                }
-                flushChanges(workspaceHome, changes);
-                info(`  ✓ ${entry.description}`);
-            }
-            else {
-                info(`  ○ ${entry.description} (no changes needed)`);
-            }
-        }
-        catch (err) {
-            const errorMessage = `migration "${name}" failed: ${err.message}`;
-            errorLog(`${errorMessage}\nSkipping remaining migrations — run "z2h-cli migrate" to retry.`);
-            throw new Error(errorMessage);
-        }
-    }
-    if (needsInstall) {
-        await yarnInstall(workspaceHome, 'package.json changed');
-    }
-    await writeState(workspaceHome, { lastMigratedVersion: cliVersion });
-    info('workspace migrations complete.');
-}
-
-export { autoMigrate };

package/dist/migrations/auto-migrate.d.ts

@@ -1,2 +0,0 @@
-export declare function autoMigrate(cliVersion: string, dryRun?: boolean): Promise<void>;
-//# sourceMappingURL=auto-migrate.d.ts.map

package/dist/migrations/auto-migrate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"auto-migrate.d.ts","sourceRoot":"","sources":["../../src/migrations/auto-migrate.ts"],"names":[],"mappings":"AAsHA,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAkGnF"}

package/dist/migrations/auto-migrate.js

@@ -1,177 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-
-const node_module = require('node:module');
-const path = require('node:path');
-const node_url = require('node:url');
-const fs = require('fs-extra');
-const execa = require('execa');
-const semver = require('semver');
-const util_logger = require('../util/logger.js');
-const util_workspace = require('../util/workspace.js');
-
-var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
-const _interopDefault = e => e && e.__esModule ? e : { default: e };
-
-const path__default = /*#__PURE__*/_interopDefault(path);
-const semver__default = /*#__PURE__*/_interopDefault(semver);
-
-const STATE_FILE = '.z2h-migrations-state.json';
-const NX_JSON_CONTENT = '{\n  "extends": "@mondaydotcomorg/trident-monorepo/presets/nx.json"\n}\n';
-// ─── Helpers ───
-async function readState(workspaceHome) {
-    const statePath = path__default.default.join(workspaceHome, STATE_FILE);
-    if (!(await fs.pathExists(statePath))) {
-        return null;
-    }
-    try {
-        return (await fs.readJson(statePath));
-    }
-    catch {
-        return null;
-    }
-}
-async function writeState(workspaceHome, state) {
-    const statePath = path__default.default.join(workspaceHome, STATE_FILE);
-    await fs.writeJson(statePath, state, { spaces: 2 });
-}
-async function yarnInstall(workspaceHome, context) {
-    util_logger.info(`${context} — running yarn install...`);
-    try {
-        await execa.execa('yarn', ['install'], { cwd: workspaceHome, stdio: 'pipe' });
-        return true;
-    }
-    catch (err) {
-        const stderr = err.stderr || err.message;
-        util_logger.warn(`yarn install failed: ${stderr}`);
-        return false;
-    }
-}
-async function getLatestTrientMonorepoVersion() {
-    try {
-        const { stdout } = await execa.execa('npm', ['view', '@mondaydotcomorg/trident-monorepo', 'version']);
-        return `^${stdout.trim()}`;
-    }
-    catch {
-        return '*';
-    }
-}
-// ─── Workspace bootstrap ───
-function isNxAvailable(workspaceHome) {
-    try {
-        const wsRequire = node_module.createRequire(path__default.default.join(workspaceHome, 'package.json'));
-        wsRequire.resolve('nx/src/generators/tree');
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-async function ensureWorkspaceNx(workspaceHome) {
-    const nxJsonPath = path__default.default.join(workspaceHome, 'nx.json');
-    const pkgPath = path__default.default.join(workspaceHome, 'package.json');
-    if (!(await fs.pathExists(nxJsonPath))) {
-        await fs.writeFile(nxJsonPath, NX_JSON_CONTENT);
-        util_logger.info('added nx.json to workspace');
-    }
-    const pkg = (await fs.readJson(pkgPath));
-    if (!pkg.devDependencies?.['@mondaydotcomorg/trident-monorepo']) {
-        pkg.devDependencies = pkg.devDependencies ?? {};
-        pkg.devDependencies['@mondaydotcomorg/trident-monorepo'] = await getLatestTrientMonorepoVersion();
-    }
-    if (!pkg.scripts?.nx) {
-        pkg.scripts = pkg.scripts ?? {};
-        pkg.scripts.nx = 'nx';
-    }
-    await fs.writeJson(pkgPath, pkg, { spaces: 2 });
-    // Only install if NX isn't already importable from the workspace
-    if (!isNxAvailable(workspaceHome)) {
-        const ok = await yarnInstall(workspaceHome, 'NX not found, installing');
-        if (!ok) {
-            util_logger.warn('workspace migrations require NX. Fix the install error and run "z2h-cli migrate" to retry.');
-            return false;
-        }
-    }
-    return true;
-}
-// ─── Main ───
-async function autoMigrate(cliVersion, dryRun = false) {
-    const workspaceHome = util_workspace.getWorkspaceHome();
-    if (!(await util_workspace.isZ2hWorkspace(workspaceHome))) {
-        util_logger.warn('no Z2H workspace found');
-        return;
-    }
-    const state = await readState(workspaceHome);
-    const lastVersion = state?.lastMigratedVersion ?? '0.0.0';
-    if (!semver__default.default.gt(cliVersion, lastVersion)) {
-        util_logger.info('workspace is up to date — no migrations pending');
-        return;
-    }
-    util_logger.info(`migrating workspace from v${lastVersion} → v${cliVersion}...`);
-    // migrations.json is at the package root — two dirs up from dist/migrations/
-    const thisDir = path__default.default.dirname(node_url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('migrations/auto-migrate.js', document.baseURI).href))));
-    const migrationsJsonPath = path__default.default.resolve(thisDir, '..', '..', 'migrations.json');
-    if (!(await fs.pathExists(migrationsJsonPath))) {
-        util_logger.warn('migrations.json not found — skipping migrations');
-        return;
-    }
-    const migrationsJson = (await fs.readJson(migrationsJsonPath));
-    // Filter to pending migrations (version > lastVersion AND <= cliVersion).
-    // CONVENTION: a migration's `version` field must equal the CLI release it
-    // ships with (not the feature branch version). This ensures the `gt` check
-    // always catches a migration on the exact upgrade that introduces it.
-    const pending = Object.entries(migrationsJson.migrations)
-        .filter(([, entry]) => semver__default.default.gt(entry.version, lastVersion) && semver__default.default.lte(entry.version, cliVersion))
-        .sort(([, a], [, b]) => semver__default.default.compare(a.version, b.version));
-    if (dryRun) {
-        util_logger.info(`${pending.length} pending migration(s) (dry-run — no changes will be applied):`);
-        for (const [, entry] of pending) {
-            util_logger.info(`  - ${entry.description} (v${entry.version})`);
-        }
-        return;
-    }
-    if (pending.length === 0) {
-        await writeState(workspaceHome, { lastMigratedVersion: cliVersion });
-        return;
-    }
-    const nxReady = await ensureWorkspaceNx(workspaceHome);
-    if (!nxReady) {
-        return;
-    }
-    util_logger.info(`applying ${pending.length} workspace migration(s)...`);
-    // Resolve NX from the workspace's node_modules (not from CLI's own deps)
-    const wsRequire = node_module.createRequire(path__default.default.join(workspaceHome, 'package.json'));
-    const { FsTree, flushChanges } = wsRequire('nx/src/generators/tree');
-    let needsInstall = false;
-    for (const [name, entry] of pending) {
-        const tree = new FsTree(workspaceHome, false);
-        try {
-            const factoryPath = path__default.default.resolve(path__default.default.dirname(migrationsJsonPath), entry.migrate);
-            const mod = require(factoryPath);
-            const fn = mod.default || mod;
-            fn(tree);
-            const changes = tree.listChanges();
-            if (changes.length > 0) {
-                if (changes.some(c => c.path.endsWith('package.json'))) {
-                    needsInstall = true;
-                }
-                flushChanges(workspaceHome, changes);
-                util_logger.info(`  ✓ ${entry.description}`);
-            }
-            else {
-                util_logger.info(`  ○ ${entry.description} (no changes needed)`);
-            }
-        }
-        catch (err) {
-            const errorMessage = `migration "${name}" failed: ${err.message}`;
-            util_logger.errorLog(`${errorMessage}\nSkipping remaining migrations — run "z2h-cli migrate" to retry.`);
-            throw new Error(errorMessage);
-        }
-    }
-    if (needsInstall) {
-        await yarnInstall(workspaceHome, 'package.json changed');
-    }
-    await writeState(workspaceHome, { lastMigratedVersion: cliVersion });
-    util_logger.info('workspace migrations complete.');
-}
-
-exports.autoMigrate = autoMigrate;