@mondaydotcomorg/z2h-cli 0.15.0 → 0.15.1

package/dist/esm/index.mjs

@@ -17,7 +17,7 @@ import { migrateCommand } from './commands/migrate.mjs';
 import { tagCommand } from './commands/tag.mjs';
 import { editCommand } from './commands/edit.mjs';
 import { doctorCommand } from './commands/doctor.mjs';
-import { fail, errorLog, getOutputMode } from './util/logger.mjs';
+import { fail, errorLog, setOutputMode, getOutputMode } from './util/logger.mjs';
 import { trackDuration } from './util/tracker.mjs';
 import { getCwdAppName } from './util/app-name.mjs';
 
@@ -61,14 +61,19 @@ async function main() {
         '  1  user-resolvable error (bad cwd, invalid package.json, lock held)',
         '  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) {
+            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) => {
+        .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.message}`, { command: 'build' }, 2);
@@ -78,7 +83,6 @@ async function main() {
         .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) => {
         try {
             await devCommand(opts);
@@ -90,10 +94,9 @@ async function main() {
     program
         .command('clean')
         .description('Delete <consumer>/.zth/ and <consumer>/build/')
-        .option('--json', 'emit structured JSON on stdout')
-        .action(async (opts) => {
+        .action(async () => {
         try {
-            await cleanCommand(opts);
+            await cleanCommand();
         }
         catch (err) {
             await fail(`clean failed: ${err.message}`, { command: 'clean' }, 2);
@@ -103,7 +106,6 @@ async function main() {
         .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.')
         .option('--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) => {
@@ -120,7 +122,6 @@ async function main() {
         .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, opts) => {
         try {
             await trackDuration('z2h_app_tag_success', () => tagCommand(appName, opts), {
@@ -134,10 +135,9 @@ async function main() {
     program
         .command('create-workspace')
         .description(`Bootstrap the ${getWorkspaceHome()}/ yarn workspace (one-time setup)`)
-        .option('--json', 'emit structured JSON on stdout')
-        .action(async (opts) => {
+        .action(async () => {
         try {
-            await createWorkspaceCommand(opts);
+            await createWorkspaceCommand();
         }
         catch (err) {
             await fail(`create-workspace failed: ${err.message}`, { command: 'create-workspace' }, 1);
@@ -148,7 +148,6 @@ async function main() {
         .description('Open the bigbrain.me token page, capture the token via a loopback callback, and persist it to ~/.zth/auth.json')
         .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) => {
         try {
             await generateZ2HTokenCommand(opts);
@@ -164,7 +163,6 @@ async function main() {
         .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, opts) => {
         try {
             await trackDuration('z2h_app_created', () => createCommand(appName, opts), {
@@ -180,10 +178,9 @@ async function main() {
     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, opts) => {
+        .action(async (appName) => {
         try {
-            await trackDuration('z2h_app_edit_pulled', () => editCommand(appName, opts), {
+            await trackDuration('z2h_app_edit_pulled', () => editCommand(appName), {
                 app_name: appName,
             });
         }
@@ -196,7 +193,6 @@ async function main() {
         .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, opts) => {
         try {
             await grantCommand(email, opts);
@@ -209,7 +205,6 @@ async function main() {
         .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, opts) => {
         try {
             await revokeCommand(email, opts);
@@ -221,10 +216,9 @@ async function main() {
     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, opts) => {
+        .action(async (email) => {
         try {
-            await transferOwnerCommand(email, opts);
+            await transferOwnerCommand(email);
         }
         catch (err) {
             await fail(`transfer-owner failed: ${err.message}`, { command: 'transfer-owner' }, 1);
@@ -234,7 +228,6 @@ async function main() {
         .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) => {
         try {
             await trackDuration('z2h_app_delete_success', () => deleteCommand(opts), {
@@ -249,7 +242,6 @@ async function main() {
         .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) => {
         try {
             await migrateCommand(version, opts);
@@ -261,10 +253,9 @@ async function main() {
     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) => {
+        .action(async () => {
         try {
-            await doctorCommand(opts);
+            await doctorCommand();
         }
         catch (err) {
             await fail(`doctor failed: ${err.message}`, { command: 'doctor' }, 1);

package/dist/esm/util/workspace.d.ts

@@ -17,4 +17,7 @@ export declare function isZ2hWorkspace(dir: string): Promise<boolean>;
  * throws an Error pointing the user at `z2h-cli create-workspace`.
  */
 export declare function assertWorkspace(): Promise<string>;
+export declare function runYarnInstall(workspaceHome: string, context: string): Promise<boolean>;
+export declare function isNxAvailable(workspaceHome: string): boolean;
+export declare function ensureWorkspaceNx(workspaceHome: string): Promise<boolean>;
 //# sourceMappingURL=workspace.d.ts.map

package/dist/esm/util/workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../src/util/workspace.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AACjD,eAAO,MAAM,sBAAsB,iBAAiB,CAAC;AAErD;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAMD;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAWlE;AAED;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CASvD"}
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../src/util/workspace.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AACjD,eAAO,MAAM,sBAAsB,iBAAiB,CAAC;AAErD;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAMD;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAWlE;AAED;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CASvD;AAED,wBAAsB,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAU7F;AAWD,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAQ5D;AAID,wBAAsB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAoC/E"}

package/dist/esm/util/workspace.mjs

@@ -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.mjs';
 
 const WORKSPACE_DIR_NAME = 'zth-projects';
 const WORKSPACE_MARKER_FIELD = 'z2hWorkspace';
@@ -42,5 +45,64 @@ async function assertWorkspace() {
     throw new Error(`No Z2H workspace at ${home}. Run "z2h-cli create-workspace" first ` +
         `(or set Z2H_WORKSPACE_HOME if you keep the workspace elsewhere).`);
 }
+async function runYarnInstall(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 '*';
+    }
+}
+function isNxAvailable(workspaceHome) {
+    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';
+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 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;
+}
 
-export { WORKSPACE_DIR_NAME, WORKSPACE_MARKER_FIELD, assertWorkspace, getWorkspaceHome, isZ2hWorkspace };
+export { WORKSPACE_DIR_NAME, WORKSPACE_MARKER_FIELD, assertWorkspace, ensureWorkspaceNx, getWorkspaceHome, isNxAvailable, isZ2hWorkspace, runYarnInstall };

package/dist/index.js

@@ -67,14 +67,19 @@ async function main() {
         '  1  user-resolvable error (bad cwd, invalid package.json, lock held)',
         '  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) {
+            util_logger.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) => {
+        .action(async () => {
         try {
-            await util_tracker.trackDuration('z2h_app_build_success', () => commands_build.buildCommand(opts), { app_name: util_appName.getCwdAppName() });
+            await util_tracker.trackDuration('z2h_app_build_success', () => commands_build.buildCommand(), { app_name: util_appName.getCwdAppName() });
         }
         catch (err) {
             await util_logger.fail(`build failed: ${err.message}`, { command: 'build' }, 2);
@@ -84,7 +89,6 @@ async function main() {
         .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) => {
         try {
             await commands_dev.devCommand(opts);
@@ -96,10 +100,9 @@ async function main() {
     program
         .command('clean')
         .description('Delete <consumer>/.zth/ and <consumer>/build/')
-        .option('--json', 'emit structured JSON on stdout')
-        .action(async (opts) => {
+        .action(async () => {
         try {
-            await commands_clean.cleanCommand(opts);
+            await commands_clean.cleanCommand();
         }
         catch (err) {
             await util_logger.fail(`clean failed: ${err.message}`, { command: 'clean' }, 2);
@@ -109,7 +112,6 @@ async function main() {
         .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.')
         .option('--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) => {
@@ -126,7 +128,6 @@ async function main() {
         .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, opts) => {
         try {
             await util_tracker.trackDuration('z2h_app_tag_success', () => commands_tag.tagCommand(appName, opts), {
@@ -140,10 +141,9 @@ async function main() {
     program
         .command('create-workspace')
         .description(`Bootstrap the ${util_workspace.getWorkspaceHome()}/ yarn workspace (one-time setup)`)
-        .option('--json', 'emit structured JSON on stdout')
-        .action(async (opts) => {
+        .action(async () => {
         try {
-            await commands_createWorkspace.createWorkspaceCommand(opts);
+            await commands_createWorkspace.createWorkspaceCommand();
         }
         catch (err) {
             await util_logger.fail(`create-workspace failed: ${err.message}`, { command: 'create-workspace' }, 1);
@@ -154,7 +154,6 @@ async function main() {
         .description('Open the bigbrain.me token page, capture the token via a loopback callback, and persist it to ~/.zth/auth.json')
         .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) => {
         try {
             await commands_generateZ2hToken.generateZ2HTokenCommand(opts);
@@ -170,7 +169,6 @@ async function main() {
         .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, opts) => {
         try {
             await util_tracker.trackDuration('z2h_app_created', () => commands_create.createCommand(appName, opts), {
@@ -186,10 +184,9 @@ async function main() {
     program
         .command('edit <app-name>')
         .description(`Pull the latest version of an app into ${util_workspace.getWorkspaceHome()}/<app-name>, cloning it first if needed`)
-        .option('--json', 'emit structured JSON on stdout')
-        .action(async (appName, opts) => {
+        .action(async (appName) => {
         try {
-            await util_tracker.trackDuration('z2h_app_edit_pulled', () => commands_edit.editCommand(appName, opts), {
+            await util_tracker.trackDuration('z2h_app_edit_pulled', () => commands_edit.editCommand(appName), {
                 app_name: appName,
             });
         }
@@ -202,7 +199,6 @@ async function main() {
         .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, opts) => {
         try {
             await commands_grant.grantCommand(email, opts);
@@ -215,7 +211,6 @@ async function main() {
         .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, opts) => {
         try {
             await commands_grant.revokeCommand(email, opts);
@@ -227,10 +222,9 @@ async function main() {
     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, opts) => {
+        .action(async (email) => {
         try {
-            await commands_grant.transferOwnerCommand(email, opts);
+            await commands_grant.transferOwnerCommand(email);
         }
         catch (err) {
             await util_logger.fail(`transfer-owner failed: ${err.message}`, { command: 'transfer-owner' }, 1);
@@ -240,7 +234,6 @@ async function main() {
         .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) => {
         try {
             await util_tracker.trackDuration('z2h_app_delete_success', () => commands_delete.deleteCommand(opts), {
@@ -255,7 +248,6 @@ async function main() {
         .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) => {
         try {
             await commands_migrate.migrateCommand(version, opts);
@@ -267,10 +259,9 @@ async function main() {
     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) => {
+        .action(async () => {
         try {
-            await commands_doctor.doctorCommand(opts);
+            await commands_doctor.doctorCommand();
         }
         catch (err) {
             await util_logger.fail(`doctor failed: ${err.message}`, { command: 'doctor' }, 1);

package/dist/util/workspace.d.ts

@@ -17,4 +17,7 @@ export declare function isZ2hWorkspace(dir: string): Promise<boolean>;
  * throws an Error pointing the user at `z2h-cli create-workspace`.
  */
 export declare function assertWorkspace(): Promise<string>;
+export declare function runYarnInstall(workspaceHome: string, context: string): Promise<boolean>;
+export declare function isNxAvailable(workspaceHome: string): boolean;
+export declare function ensureWorkspaceNx(workspaceHome: string): Promise<boolean>;
 //# sourceMappingURL=workspace.d.ts.map

package/dist/util/workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/util/workspace.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AACjD,eAAO,MAAM,sBAAsB,iBAAiB,CAAC;AAErD;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAMD;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAWlE;AAED;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CASvD"}
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/util/workspace.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AACjD,eAAO,MAAM,sBAAsB,iBAAiB,CAAC;AAErD;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAMD;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAWlE;AAED;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CASvD;AAED,wBAAsB,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAU7F;AAWD,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAQ5D;AAID,wBAAsB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAoC/E"}

package/dist/util/workspace.js

@@ -2,7 +2,10 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 const path = require('node:path');
 const os = require('node:os');
+const node_module = require('node:module');
 const fs = require('fs-extra');
+const execa = require('execa');
+const util_logger = require('./logger.js');
 
 const _interopDefault = e => e && e.__esModule ? e : { default: e };
 
@@ -49,9 +52,71 @@ async function assertWorkspace() {
     throw new Error(`No Z2H workspace at ${home}. Run "z2h-cli create-workspace" first ` +
         `(or set Z2H_WORKSPACE_HOME if you keep the workspace elsewhere).`);
 }
+async function runYarnInstall(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 '*';
+    }
+}
+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;
+    }
+}
+const NX_JSON_CONTENT = '{\n  "extends": "@mondaydotcomorg/trident-monorepo/presets/nx.json"\n}\n';
+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 runYarnInstall(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;
+}
 
 exports.WORKSPACE_DIR_NAME = WORKSPACE_DIR_NAME;
 exports.WORKSPACE_MARKER_FIELD = WORKSPACE_MARKER_FIELD;
 exports.assertWorkspace = assertWorkspace;
+exports.ensureWorkspaceNx = ensureWorkspaceNx;
 exports.getWorkspaceHome = getWorkspaceHome;
+exports.isNxAvailable = isNxAvailable;
 exports.isZ2hWorkspace = isZ2hWorkspace;
+exports.runYarnInstall = runYarnInstall;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mondaydotcomorg/z2h-cli",
-  "version": "0.15.0",
+  "version": "0.15.1",
   "bin": "./bin/z2h-cli.js",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/src/commands/__tests__/doctor.test.ts

@@ -4,6 +4,7 @@ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 import { execa } from 'execa';
 import { pathExists, readJson } from 'fs-extra';
 import { tryReadAuthTokenSync } from '../../util/auth/auth-store';
+import { getOutputMode, setOutputMode } from '../../util/logger';
 import { doctorCommand } from '../doctor';
 
 vi.mock('execa', () => ({ execa: vi.fn() }));
@@ -402,10 +403,16 @@ describe('doctorCommand', () => {
   // ── JSON output ───────────────────────────────────────────────────────────
 
   it('emits structured JSON when --json flag is set', async () => {
-    const jsonLine = await captureStdout(() => doctorCommand({ json: true }));
-    const parsed = JSON.parse(jsonLine.trim()) as { ok: boolean; checks: unknown[] };
-    expect(parsed.ok).toBe(true);
-    expect(Array.isArray(parsed.checks)).toBe(true);
-    expect(parsed.checks.length).toBeGreaterThan(0);
+    const currentOutputMode = getOutputMode();
+    try {
+      setOutputMode('json');
+      const jsonLine = await captureStdout(() => doctorCommand());
+      const parsed = JSON.parse(jsonLine.trim()) as { ok: boolean; checks: unknown[] };
+      expect(parsed.ok).toBe(true);
+      expect(Array.isArray(parsed.checks)).toBe(true);
+      expect(parsed.checks.length).toBeGreaterThan(0);
+    } finally {
+      setOutputMode(currentOutputMode);
+    }
   });
 });

package/src/commands/build.ts

@@ -1,19 +1,14 @@
 import { pathExists } from 'fs-extra';
 import { execa } from 'execa';
-import { info, output, setOutputMode } from '../util/logger';
+import { info, output } from '../util/logger';
 import { prepareShadow } from '../shadow/prepare';
 
 export interface BuildOptions {
-  json?: boolean;
   publicUrl?: string;
 }
 
 // Should be run from the consumer app directory — uses process.cwd() to locate it.
 export async function buildCommand(opts: BuildOptions = {}): Promise<void> {
-  if (opts.json) {
-    setOutputMode('json');
-  }
-
   const ctx = await prepareShadow();
 
   // Typecheck against the shadow's tsconfig (the consumer dir has none).

package/src/commands/clean.ts

@@ -1,16 +1,9 @@
 import { pathExists, remove } from 'fs-extra';
-import { info, output, setOutputMode } from '../util/logger';
+import { info, output } from '../util/logger';
 import { resolveConsumerPaths } from '../shadow/paths';
 
-export interface CleanOptions {
-  json?: boolean;
-}
-
 // Should be run from the consumer app directory — uses process.cwd() to locate it.
-export async function cleanCommand(opts: CleanOptions = {}): Promise<void> {
-  if (opts.json) {
-    setOutputMode('json');
-  }
+export async function cleanCommand(): Promise<void> {
   const paths = resolveConsumerPaths(process.cwd());
 
   const existed = await pathExists(paths.shadowDir);

package/src/commands/create-workspace.ts

@@ -1,21 +1,13 @@
 import path from 'node:path';
 import { readFile } from 'node:fs/promises';
 import { ensureDir, writeFile, pathExists, readdir, copy } from 'fs-extra';
-import { info, output, setOutputMode } from '../util/logger';
+import { info, output } from '../util/logger';
 import { getWorkspaceHome } from '../util/workspace';
 import { getTemplatesDir } from '../util/templates';
 import { runYarnInstall } from '../util/npm/install';
 import { workspaceNpmrcContents, workspaceYarnrcContents } from '../util/npm/broker-config';
 
-export interface CreateWorkspaceOptions {
-  json?: boolean;
-}
-
-export async function createWorkspaceCommand(opts: CreateWorkspaceOptions = {}): Promise<void> {
-  if (opts.json) {
-    setOutputMode('json');
-  }
-
+export async function createWorkspaceCommand(): Promise<void> {
   const home = getWorkspaceHome();
   const templatesDir = getTemplatesDir();
   const wsTemplatesDir = path.join(templatesDir, 'workspace');

package/src/commands/create.ts

@@ -1,7 +1,7 @@
 import path from 'node:path';
 import { readFile } from 'node:fs/promises';
 import { ensureDir, pathExists, readdir, writeFile, copy } from 'fs-extra';
-import { info, warn, output, setOutputMode } from '../util/logger';
+import { info, warn, output } from '../util/logger';
 import { assertWorkspace } from '../util/workspace';
 import { getTemplatesDir, renderTemplate, APP_TEMPLATES, type AppTemplate } from '../util/templates';
 import { APP_NAME_PATTERN } from '../constants';
@@ -19,7 +19,6 @@ export interface CreateOptions {
   htmlFile?: string;
   remote?: RemoteType;
   repoUrl?: string;
-  json?: boolean;
 }
 
 // Names reserved by the host MF (mf-bigbrain-zth) for platform pages under
@@ -50,10 +49,6 @@ async function isDirEmpty(dir: string): Promise<boolean> {
 }
 
 export async function createCommand(appName: string, opts: CreateOptions = {}): Promise<void> {
-  if (opts.json) {
-    setOutputMode('json');
-  }
-
   // Validate workspace.
   const workspace = await assertWorkspace();