@mondaydotcomorg/z2h-cli 0.15.0 → 0.15.1

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;

package/src/migrations/auto-migrate.ts

@@ -1,217 +0,0 @@
-import { createRequire } from 'node:module';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { pathExists, readJson, writeFile, writeJson } from 'fs-extra';
-import { execa } from 'execa';
-import semver from 'semver';
-import { errorLog, info, warn } from '../util/logger';
-import { getWorkspaceHome, isZ2hWorkspace } from '../util/workspace';
-
-const STATE_FILE = '.z2h-migrations-state.json';
-const NX_JSON_CONTENT = '{\n  "extends": "@mondaydotcomorg/trident-monorepo/presets/nx.json"\n}\n';
-
-interface MigrationState {
-  lastMigratedVersion: string;
-}
-
-interface MigrationEntry {
-  version: string;
-  description: string;
-  migrate: string;
-}
-
-interface MigrationsJson {
-  migrations: Record<string, MigrationEntry>;
-}
-
-// ─── Helpers ───
-
-async function readState(workspaceHome: string): Promise<MigrationState | null> {
-  const statePath = path.join(workspaceHome, STATE_FILE);
-  if (!(await pathExists(statePath))) {
-    return null;
-  }
-  try {
-    return (await readJson(statePath)) as MigrationState;
-  } catch {
-    return null;
-  }
-}
-
-async function writeState(workspaceHome: string, state: MigrationState): Promise<void> {
-  const statePath = path.join(workspaceHome, STATE_FILE);
-  await writeJson(statePath, state, { spaces: 2 });
-}
-
-async function yarnInstall(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 '*';
-  }
-}
-
-// ─── Workspace bootstrap ───
-
-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;
-  }
-}
-
-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 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 ───
-
-export async function autoMigrate(cliVersion: string, dryRun = false): Promise<void> {
-  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)) as MigrationsJson;
-
-  // 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') as {
-    FsTree: new (root: string, isVerbose: boolean) => import('@nx/devkit').Tree & {
-      listChanges(): { type: string; path: string }[];
-    };
-    flushChanges: (root: string, changes: { type: string; path: string; content?: Buffer | null }[]) => void;
-  };
-
-  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 as Error).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.');
-}