@mondaydotcomorg/z2h-cli 0.3.0 → 0.4.0

package/dist/commands/create-workspace.js

@@ -37,7 +37,7 @@ async function createWorkspaceCommand(opts) {
     if (await fsExtra.pathExists(home)) {
         const entries = await fsExtra.readdir(home);
         if (entries.length > 0) {
-            throw new Error(`${home} is non-empty. Wipe it before running create-workspace.`);
+            throw new Error(`Workspace already exists at ${home}. Remove it and try again.`);
         }
     }
     else {
@@ -66,12 +66,12 @@ async function createWorkspaceCommand(opts) {
         fsExtra.copy(path__default.default.join(wsTemplatesDir, 'README.md'), path__default.default.join(home, 'README.md')),
         fsExtra.copy(path__default.default.join(wsTemplatesDir, 'yarn-releases', 'yarn-4.5.1.cjs'), path__default.default.join(home, '.yarn', 'releases', 'yarn-4.5.1.cjs')),
     ]);
-    util_logger.info(`bootstrapping workspace at ${home}`);
+    util_logger.info(`setting up your Z2H workspace — this may take a minute...`);
     await execa.execa('yarn', ['install'], {
         cwd: home,
         stdio: 'inherit',
     });
-    util_logger.output(`[z2h-cli] workspace ready at ${home}`, {
+    util_logger.output(`Your workspace is ready! 🚀 Apps will live at ${home}`, {
         ok: true,
         workspace: home,
         z2hCliVersion: cliVersion,

package/dist/commands/create.js

@@ -95,7 +95,7 @@ async function createCommand(appName, opts) {
     if (template === 'html-embed' && opts.htmlFile) {
         await fsExtra.copy(opts.htmlFile, path__default.default.join(appDir, 'src', 'page.html'));
     }
-    util_logger.info(`installing into workspace at ${workspace}`);
+    util_logger.info(`installing dependencies for ${appName}...`);
     await execa.execa('yarn', ['install'], {
         cwd: workspace,
         stdio: 'inherit',

package/dist/esm/commands/create-workspace.mjs

@@ -31,7 +31,7 @@ async function createWorkspaceCommand(opts) {
     if (await pathExists(home)) {
         const entries = await readdir(home);
         if (entries.length > 0) {
-            throw new Error(`${home} is non-empty. Wipe it before running create-workspace.`);
+            throw new Error(`Workspace already exists at ${home}. Remove it and try again.`);
         }
     }
     else {
@@ -60,12 +60,12 @@ async function createWorkspaceCommand(opts) {
         copy(path.join(wsTemplatesDir, 'README.md'), path.join(home, 'README.md')),
         copy(path.join(wsTemplatesDir, 'yarn-releases', 'yarn-4.5.1.cjs'), path.join(home, '.yarn', 'releases', 'yarn-4.5.1.cjs')),
     ]);
-    info(`bootstrapping workspace at ${home}`);
+    info(`setting up your Z2H workspace — this may take a minute...`);
     await execa('yarn', ['install'], {
         cwd: home,
         stdio: 'inherit',
     });
-    output(`[z2h-cli] workspace ready at ${home}`, {
+    output(`Your workspace is ready! 🚀 Apps will live at ${home}`, {
         ok: true,
         workspace: home,
         z2hCliVersion: cliVersion,

package/dist/esm/commands/create.mjs

@@ -89,7 +89,7 @@ async function createCommand(appName, opts) {
     if (template === 'html-embed' && opts.htmlFile) {
         await copy(opts.htmlFile, path.join(appDir, 'src', 'page.html'));
     }
-    info(`installing into workspace at ${workspace}`);
+    info(`installing dependencies for ${appName}...`);
     await execa('yarn', ['install'], {
         cwd: workspace,
         stdio: 'inherit',

package/dist/esm/index.mjs

@@ -1,3 +1,4 @@
+import { createRequire } from 'node:module';
 import { Command } from 'commander';
 import { devCommand } from './commands/dev.mjs';
 import { buildCommand } from './commands/build.mjs';
@@ -8,6 +9,7 @@ import { createCommand } from './commands/create.mjs';
 import { generateZ2HTokenCommand } from './commands/generate-z2h-token.mjs';
 import { errorLog, fail } from './util/logger.mjs';
 
+const { version } = createRequire(import.meta.url)('../package.json');
 async function main() {
     const program = new Command();
     program
@@ -24,7 +26,7 @@ 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('0.0.0');
+        .version(version);
     program
         .command('build')
         .description('Build the consumer into its .zth/ shadow and copy artifacts to ./build/')

package/dist/index.js

@@ -1,3 +1,4 @@
+const node_module = require('node:module');
 const commander = require('commander');
 const commands_dev = require('./commands/dev.js');
 const commands_build = require('./commands/build.js');
@@ -8,6 +9,8 @@ const commands_create = require('./commands/create.js');
 const commands_generateZ2hToken = require('./commands/generate-z2h-token.js');
 const util_logger = require('./util/logger.js');
 
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+const { version } = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.js', document.baseURI).href)))('../package.json');
 async function main() {
     const program = new commander.Command();
     program
@@ -24,7 +27,7 @@ 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('0.0.0');
+        .version(version);
     program
         .command('build')
         .description('Build the consumer into its .zth/ shadow and copy artifacts to ./build/')

package/package.json

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

package/src/commands/__tests__/create-workspace.test.ts

@@ -57,7 +57,7 @@ describe('create-workspace', () => {
     await ensureDir(tmp);
     await writeJson(path.join(tmp, 'somefile.json'), { hello: 'world' });
 
-    await expect(createWorkspaceCommand({})).rejects.toThrow(/non-empty/);
+    await expect(createWorkspaceCommand({})).rejects.toThrow(/Workspace already exists/);
     expect(execa).not.toHaveBeenCalled();
   });
 

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

@@ -77,11 +77,7 @@ describe('create', () => {
     expect(content).toContain('export default function DemoApp()');
     expect(content).not.toContain('__APP_COMPONENT__');
 
-    expect(execa).toHaveBeenCalledWith(
-      'yarn',
-      expect.arrayContaining(['install']),
-      expect.objectContaining({ cwd: tmp })
-    );
+    expect(execa).toHaveBeenCalledWith('yarn', ['install'], expect.any(Object));
   });
 
   it('scaffolds an html-embed app and copies the html file', async () => {

package/src/commands/create-workspace.ts

@@ -38,7 +38,7 @@ export async function createWorkspaceCommand(opts: CreateWorkspaceOptions): Prom
   if (await pathExists(home)) {
     const entries = await readdir(home);
     if (entries.length > 0) {
-      throw new Error(`${home} is non-empty. Wipe it before running create-workspace.`);
+      throw new Error(`Workspace already exists at ${home}. Remove it and try again.`);
     }
   } else {
     await ensureDir(home);
@@ -72,13 +72,13 @@ export async function createWorkspaceCommand(opts: CreateWorkspaceOptions): Prom
     ),
   ]);
 
-  info(`bootstrapping workspace at ${home}`);
+  info(`setting up your Z2H workspace — this may take a minute...`);
   await execa('yarn', ['install'], {
     cwd: home,
     stdio: 'inherit',
   });
 
-  output(`[z2h-cli] workspace ready at ${home}`, {
+  output(`Your workspace is ready! 🚀 Apps will live at ${home}`, {
     ok: true,
     workspace: home,
     z2hCliVersion: cliVersion,

package/src/commands/create.ts

@@ -115,7 +115,7 @@ export async function createCommand(appName: string, opts: CreateOptions): Promi
     await copy(opts.htmlFile, path.join(appDir, 'src', 'page.html'));
   }
 
-  info(`installing into workspace at ${workspace}`);
+  info(`installing dependencies for ${appName}...`);
   await execa('yarn', ['install'], {
     cwd: workspace,
     stdio: 'inherit',

package/src/index.ts

@@ -1,3 +1,4 @@
+import { createRequire } from 'node:module';
 import { Command } from 'commander';
 import { devCommand } from './commands/dev';
 import { buildCommand } from './commands/build';
@@ -8,6 +9,8 @@ import { createCommand } from './commands/create';
 import { generateZ2HTokenCommand } from './commands/generate-z2h-token';
 import { errorLog, fail } from './util/logger';
 
+const { version } = createRequire(import.meta.url)('../package.json') as { version: string };
+
 async function main(): Promise<void> {
   const program = new Command();
   program
@@ -26,7 +29,7 @@ async function main(): Promise<void> {
         '  2  system error (yarn install or trident build failed)',
       ].join('\n')
     )
-    .version('0.0.0');
+    .version(version);
 
   program
     .command('build')

package/src/templates/app/CLAUDE.md

@@ -25,15 +25,9 @@ The orchestrator routes to `z2h:feature-development`, which handles the typechec
 
 ---
 
-## 🌟 Prefer Frontend Over Backend
+## 🌟 Data-Fetching Hierarchy
 
-If a request *could* be solved in this app using existing backend endpoints — do that. Backend changes go through a slow PR + Harmony pipeline; frontend changes ship in seconds via `z2h-cli deploy`.
-
-When uncertain, ask:
-
-> "Can we do this in the app with existing endpoints, or does it need a backend change?"
-
-Only escalate to `z2h:backend-feature-development` for genuinely new persisted entities, schemas, write paths, or server-side rules.
+When a request needs data, follow `z2h:coding-standards-mf` §0: write a `runQuery` helper for Snowflake data (TS module using `getBigBrainAPI()` for React apps; vanilla `<script>` using `window.location.origin` for html-embed apps), write a client-side fetch for other browser-accessible sources, or tell the user to reach out at `#zero-to-hero` if the data needs an API key or server-side access. Backend changes to `bigbrain-zth` are not in scope.
 
 ---
 

package/src/templates/workspace/package.json.tmpl

@@ -12,7 +12,7 @@
     "react-error-boundary": "^3.1.3"
   },
   "devDependencies": {
-    "@mondaydotcomorg/bigbrain-types": "^0.3.3",
+    "@mondaydotcomorg/bigbrain-types": "^0.3.4",
     "@mondaydotcomorg/mf-api-types": "^0.1.1",
     "@mondaydotcomorg/trident-toolkit": "^2.9.25",
     "@mondaydotcomorg/z2h-cli": "__Z2H_CLI_VERSION__",