@mondaydotcomorg/z2h-cli 0.1.0

package/README.md

@@ -0,0 +1,16 @@
+# z2h-cli
+
+CLI for the Zero-to-Hero microfrontend workflow. Handles local dev and deployment to S3.
+
+## Commands
+
+```bash
+z2h dev      # start a local Trident dev server; open at /bigbrain-vibe/<app>?zth_local=<port>
+z2h deploy   # build and upload to S3, bump the manifest version
+z2h build    # build only (no upload)
+z2h clean    # remove the .zth shadow directory
+```
+
+## Deploy
+
+Requires standard AWS credentials in the environment. The CLI writes directly to S3 (`BUCKET_WRITE_URL`) and reads the shared manifest through the CDN (`BUCKET_READ_DNS_URL`). See `src/util/s3/client.ts` for the bucket and domain values.

package/bin/z2h-cli.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../dist/index.js');

package/dist/commands/build.d.ts

@@ -0,0 +1,5 @@
+export interface BuildOptions {
+    json?: boolean;
+}
+export declare function buildCommand(opts: BuildOptions): Promise<void>;
+//# sourceMappingURL=build.d.ts.map

package/dist/commands/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAgCpE"}

package/dist/commands/build.js

@@ -0,0 +1,37 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const fsExtra = require('fs-extra');
+const execa = require('execa');
+const util_logger = require('../util/logger.js');
+const shadow_prepare = require('../shadow/prepare.js');
+
+async function buildCommand(opts) {
+    if (opts.json) {
+        util_logger.setOutputMode('json');
+    }
+    const ctx = await shadow_prepare.prepareShadow();
+    // Typecheck against the shadow's tsconfig (the consumer dir has none).
+    // Errors fail the build before we waste time on the Trident pipeline.
+    // preferLocal=true makes execa prepend the consumer's node_modules/.bin
+    // to PATH, so `tsc` resolves to the version hoisted from .zth's
+    // trident-toolkit dep — no npx overhead, no extra template deps.
+    util_logger.info(`type-checking "${ctx.appName}"`);
+    await execa.execa('tsc', ['--noEmit', '-p', ctx.paths.shadowTsconfig], {
+        cwd: ctx.paths.consumerDir,
+        preferLocal: true,
+        stdio: 'inherit',
+    });
+    util_logger.info(`building "${ctx.appName}" via trident`);
+    await execa.execa('yarn', ['build'], { cwd: ctx.paths.shadowDir, stdio: 'inherit' });
+    if (!(await fsExtra.pathExists(ctx.paths.shadowBuild))) {
+        throw new Error(`Expected build output at ${ctx.paths.shadowBuild} — not found.`);
+    }
+    util_logger.output(`[z2h-cli] build complete — artifacts at ${ctx.paths.shadowBuild}`, {
+        ok: true,
+        appName: ctx.appName,
+        port: ctx.port,
+        buildDir: ctx.paths.shadowBuild,
+    });
+}
+
+exports.buildCommand = buildCommand;

package/dist/commands/clean.d.ts

@@ -0,0 +1,5 @@
+export interface CleanOptions {
+    json?: boolean;
+}
+export declare function cleanCommand(opts: CleanOptions): Promise<void>;
+//# sourceMappingURL=clean.d.ts.map

package/dist/commands/clean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.d.ts","sourceRoot":"","sources":["../../src/commands/clean.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBpE"}

package/dist/commands/clean.js

@@ -0,0 +1,24 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const fsExtra = require('fs-extra');
+const util_logger = require('../util/logger.js');
+const shadow_paths = require('../shadow/paths.js');
+
+async function cleanCommand(opts) {
+    if (opts.json) {
+        util_logger.setOutputMode('json');
+    }
+    const paths = shadow_paths.resolveConsumerPaths(process.cwd());
+    const existed = await fsExtra.pathExists(paths.shadowDir);
+    if (existed) {
+        util_logger.info(`removing ${paths.shadowDir}`);
+        await fsExtra.remove(paths.shadowDir);
+    }
+    util_logger.output(existed ? `[z2h-cli] cleaned shadow at ${paths.shadowDir}` : '[z2h-cli] nothing to clean', {
+        ok: true,
+        shadowDir: paths.shadowDir,
+        removed: existed,
+    });
+}
+
+exports.cleanCommand = cleanCommand;

package/dist/commands/deploy.d.ts

@@ -0,0 +1,6 @@
+export interface DeployOptions {
+    dryRun?: boolean;
+    json?: boolean;
+}
+export declare function deployCommand(opts: DeployOptions): Promise<void>;
+//# sourceMappingURL=deploy.d.ts.map

package/dist/commands/deploy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAaD,wBAAsB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA6EtE"}

package/dist/commands/deploy.js

@@ -0,0 +1,92 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const path = require('node:path');
+const fsExtra = require('fs-extra');
+require('execa');
+const util_logger = require('../util/logger.js');
+const shadow_paths = require('../shadow/paths.js');
+const util_manifest = require('../util/manifest.js');
+const util_s3_upload = require('../util/s3/upload.js');
+const util_s3_client = require('../util/s3/client.js');
+const util_appName = require('../util/app-name.js');
+const commands_build = require('./build.js');
+
+const _interopDefault = e => e && e.__esModule ? e : { default: e };
+
+const path__default = /*#__PURE__*/_interopDefault(path);
+
+const APONO_BUNDLE = '<APONO_BUNDLE_NAME>'; // TODO: replace with actual bundle name once infra setup is complete
+async function requestAponoAccess() {
+    {
+        util_logger.warn(`skipping Apono request — APONO_BUNDLE is still a placeholder ("${APONO_BUNDLE}"). Set it in deploy.ts before relying on auto-grant.`);
+        return;
+    }
+}
+async function deployCommand(opts) {
+    if (opts.json) {
+        util_logger.setOutputMode('json');
+    }
+    util_logger.info('checking S3 bucket');
+    await util_s3_client.assertBucketExists();
+    util_logger.info('building');
+    await commands_build.buildCommand({ json: opts.json });
+    const paths = shadow_paths.resolveConsumerPaths(process.cwd());
+    const consumerPkg = (await fsExtra.readJson(paths.consumerPkg));
+    if (!consumerPkg.name) {
+        throw new Error('Consumer package.json must have a "name" field');
+    }
+    const appName = util_appName.mfAppName(consumerPkg.name);
+    if (!(await fsExtra.pathExists(paths.shadowBuild))) {
+        throw new Error(`No build output at ${paths.shadowBuild} after build step.`);
+    }
+    // Trident emits the canonical per-MF manifest at build/asset-manifest.json.
+    const assetManifestPath = path__default.default.join(paths.shadowBuild, 'asset-manifest.json');
+    if (!(await fsExtra.pathExists(assetManifestPath))) {
+        throw new Error(`Missing asset-manifest.json at ${assetManifestPath}.`);
+    }
+    const assetManifest = (await fsExtra.readJson(assetManifestPath));
+    util_logger.info('reading current Z2H manifest');
+    const manifest = await util_manifest.readManifest();
+    const version = util_manifest.nextVersion(manifest, appName);
+    const keyPrefix = `${appName}/${version}`;
+    const url = `${util_s3_client.BUCKET_READ_DNS_URL}/${keyPrefix}`;
+    if (opts.dryRun) {
+        util_logger.output(`[z2h-cli] dry-run: would upload to s3://${util_s3_client.BUCKET_WRITE_NAME}/${keyPrefix}/ as v${version}`, {
+            ok: true,
+            dryRun: true,
+            appName,
+            version,
+            bucket: util_s3_client.BUCKET_WRITE_NAME,
+            keyPrefix,
+            url,
+            entry: { ...assetManifest, version, url },
+        });
+        return;
+    }
+    await requestAponoAccess();
+    util_logger.info(`uploading build → s3://${util_s3_client.BUCKET_WRITE_NAME}/${keyPrefix}/`);
+    await util_s3_upload.uploadDir(paths.shadowBuild, keyPrefix);
+    const entry = {
+        ...assetManifest,
+        version,
+        url,
+    };
+    util_logger.info(`updating manifest entry "${appName}" → v${version}`);
+    await util_manifest.writeManifest(util_manifest.upsertEntry(manifest, appName, entry));
+    // The host MF parses the app name from the URL and prepends `mf-` itself
+    // before looking it up in the manifest. So the user-facing URL must use
+    // the consumer's de-scoped package name (no `mf-` prefix, no `@scope/`).
+    const liveUrl = `https://bigbrain.me/bigbrain-vibe/${util_appName.cleanAppName(consumerPkg.name)}`;
+    util_logger.output(`[z2h-cli] deployed ✅\n  app:     ${appName}\n  version: ${version}\n  open:    ${liveUrl}`, {
+        ok: true,
+        appName,
+        version,
+        bucket: util_s3_client.BUCKET_WRITE_NAME,
+        keyPrefix,
+        url,
+        liveUrl,
+        entry,
+    });
+}
+
+exports.deployCommand = deployCommand;

package/dist/commands/dev.d.ts

@@ -0,0 +1,5 @@
+export interface DevOptions {
+    json?: boolean;
+}
+export declare function devCommand(opts: DevOptions): Promise<void>;
+//# sourceMappingURL=dev.d.ts.map

package/dist/commands/dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAID,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAgDhE"}

package/dist/commands/dev.js

@@ -0,0 +1,58 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+const fsExtra = require('fs-extra');
+const chokidar = require('chokidar');
+const execa = require('execa');
+const util_logger = require('../util/logger.js');
+const shadow_prepare = require('../shadow/prepare.js');
+const shadow_consumerPkg = require('../shadow/consumer-pkg.js');
+const shadow_sync = require('../shadow/sync.js');
+
+const TRIDENT_READY_PATTERN = /Server started at/i;
+async function devCommand(opts) {
+    if (opts.json) {
+        util_logger.setOutputMode('json');
+    }
+    const ctx = await shadow_prepare.prepareShadow();
+    const { port } = ctx;
+    const url = `https://bigbrain.me/bigbrain-vibe/${ctx.appName}?zth_local=${port}`;
+    util_logger.info('starting z2h app');
+    // stdout is piped so we can detect trident's ready banner before printing
+    // our own ready line. stdin/stderr stay inherited so colored errors and
+    // interactive prompts still flow naturally.
+    const server = execa.execa('yarn', ['start'], {
+        cwd: ctx.paths.shadowDir,
+        stdio: ['inherit', 'pipe', 'inherit'],
+    });
+    let readyPrinted = false;
+    server.stdout?.on('data', (chunk) => {
+        process.stdout.write(chunk);
+        if (!readyPrinted && TRIDENT_READY_PATTERN.test(chunk.toString())) {
+            readyPrinted = true;
+            util_logger.output(`\n[z2h-cli] ready — open:\n  ${url}\n`, {
+                ok: true,
+                appName: ctx.appName,
+                port,
+                url,
+            });
+        }
+    });
+    // Only watch consumer package.json. Source changes flow through Vite's
+    // native import graph — the wrapper imports consumer src via relative
+    // path, so Vite's HMR picks up edits without any rsync.
+    const pkgWatcher = chokidar.watch(ctx.paths.consumerPkg, { ignoreInitial: true });
+    pkgWatcher.on('change', async () => {
+        util_logger.warn('consumer package.json changed — re-checking deps');
+        try {
+            const raw = (await fsExtra.readJson(ctx.paths.consumerPkg));
+            const { pkg } = await shadow_consumerPkg.ensureConsumerPkg(ctx.paths.consumerPkg, raw);
+            await shadow_sync.syncShadow(ctx.paths, pkg);
+        }
+        catch (err) {
+            util_logger.errorLog(`re-prepare failed: ${err.message}`);
+        }
+    });
+    await server;
+}
+
+exports.devCommand = devCommand;

package/dist/constants.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Cross-file constants. Narrowly-used literals (templates, prefixes used in
+ * one place) stay local to their file to keep this index small.
+ */
+export declare const SHADOW_DIR_NAME = ".zth";
+/**
+ * Protected runtime deps that MUST resolve to a single instance across the
+ * wrapper (.zth) and the consumer's src. Declared as peerDependencies in
+ * the shadow pkg so yarn hoists them from the workspace root — which is
+ * why we enforce their presence in the consumer's own package.json.
+ */
+export declare const PROTECTED_DEPS: Record<string, string>;
+/**
+ * Protected dev deps. Same idempotent treatment as PROTECTED_DEPS but live
+ * in the consumer's `devDependencies`. These give the LLM-authored consumer
+ * code access to monday.com platform types out of the box.
+ */
+export declare const PROTECTED_DEV_DEPS: Record<string, string>;
+export declare const WORKSPACE_DEV_DEPS: Record<string, string>;
+export declare const SHADOW_SCRIPTS: Record<string, string>;
+export declare const MIN_PORT = 13000;
+export declare const MAX_PORT = 19999;
+export declare const GITIGNORE_ENTRIES: string[];
+export declare const YARNRC_LINES: string[];
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,eAAO,MAAM,eAAe,SAAS,CAAC;AAGtC;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMjD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAGrD,CAAC;AAIF,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKrD,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAGjD,CAAC;AAMF,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAG9B,eAAO,MAAM,iBAAiB,UAAY,CAAC;AAG3C,eAAO,MAAM,YAAY,UAIxB,CAAC"}

package/dist/constants.js

@@ -0,0 +1,67 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+/**
+ * Cross-file constants. Narrowly-used literals (templates, prefixes used in
+ * one place) stay local to their file to keep this index small.
+ */
+// ─────────── Shadow dir layout ───────────
+const SHADOW_DIR_NAME = '.zth';
+// ─────────── Consumer pkg enforcement ──────
+/**
+ * Protected runtime deps that MUST resolve to a single instance across the
+ * wrapper (.zth) and the consumer's src. Declared as peerDependencies in
+ * the shadow pkg so yarn hoists them from the workspace root — which is
+ * why we enforce their presence in the consumer's own package.json.
+ */
+const PROTECTED_DEPS = {
+    react: '^18.2.0',
+    'react-dom': '^18.2.0',
+    'react-error-boundary': '^3.1.3',
+    '@mondaydotcomorg/trident-runtime': '^1.24.1',
+    '@vibe/core': '^4.0.1',
+};
+/**
+ * Protected dev deps. Same idempotent treatment as PROTECTED_DEPS but live
+ * in the consumer's `devDependencies`. These give the LLM-authored consumer
+ * code access to monday.com platform types out of the box.
+ */
+const PROTECTED_DEV_DEPS = {
+    '@mondaydotcomorg/mf-api-types': '^0.1.1',
+    '@mondaydotcomorg/bigbrain-types': '^0.3.3',
+};
+// ─────────── Shadow pkg template ───────────
+// TODO — Add trident mf-types / bigbrain-types opt-in.
+const WORKSPACE_DEV_DEPS = {
+    '@mondaydotcomorg/trident-toolkit': '^2.9.25',
+    '@types/react': '^18.0.14',
+    '@types/react-dom': '^18.0.5',
+    typescript: '^5.7.2',
+};
+const SHADOW_SCRIPTS = {
+    start: 'trident start',
+    build: 'trident build',
+};
+// ─────────── Auto-allocated dev port range ────
+// High enough to dodge common dev defaults (3000 Next, 5173 Vite, 8080).
+// Collisions within the 7k-port pool are rare for POC; if trident can't
+// bind, the user sees a clear bind error from the dev server and re-runs.
+const MIN_PORT = 13000;
+const MAX_PORT = 19999;
+// ─────────── Gitignore entries auto-appended to the consumer's file ────
+const GITIGNORE_ENTRIES = ['.zth/'];
+// ─────────── .yarnrc.yml written to new consumer apps ────
+const YARNRC_LINES = [
+    'nodeLinker: node-modules',
+    "npmAuthToken: '${NPM_TOKEN}'",
+    "npmRegistryServer: 'https://registry.npmjs.org/'",
+];
+
+exports.GITIGNORE_ENTRIES = GITIGNORE_ENTRIES;
+exports.MAX_PORT = MAX_PORT;
+exports.MIN_PORT = MIN_PORT;
+exports.PROTECTED_DEPS = PROTECTED_DEPS;
+exports.PROTECTED_DEV_DEPS = PROTECTED_DEV_DEPS;
+exports.SHADOW_DIR_NAME = SHADOW_DIR_NAME;
+exports.SHADOW_SCRIPTS = SHADOW_SCRIPTS;
+exports.WORKSPACE_DEV_DEPS = WORKSPACE_DEV_DEPS;
+exports.YARNRC_LINES = YARNRC_LINES;

package/dist/esm/commands/build.d.ts

@@ -0,0 +1,5 @@
+export interface BuildOptions {
+    json?: boolean;
+}
+export declare function buildCommand(opts: BuildOptions): Promise<void>;
+//# sourceMappingURL=build.d.ts.map

package/dist/esm/commands/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/commands/build.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAgCpE"}

package/dist/esm/commands/build.mjs

@@ -0,0 +1,35 @@
+import { pathExists } from 'fs-extra';
+import { execa } from 'execa';
+import { setOutputMode, info, output } from '../util/logger.mjs';
+import { prepareShadow } from '../shadow/prepare.mjs';
+
+async function buildCommand(opts) {
+    if (opts.json) {
+        setOutputMode('json');
+    }
+    const ctx = await prepareShadow();
+    // Typecheck against the shadow's tsconfig (the consumer dir has none).
+    // Errors fail the build before we waste time on the Trident pipeline.
+    // preferLocal=true makes execa prepend the consumer's node_modules/.bin
+    // to PATH, so `tsc` resolves to the version hoisted from .zth's
+    // trident-toolkit dep — no npx overhead, no extra template deps.
+    info(`type-checking "${ctx.appName}"`);
+    await execa('tsc', ['--noEmit', '-p', ctx.paths.shadowTsconfig], {
+        cwd: ctx.paths.consumerDir,
+        preferLocal: true,
+        stdio: 'inherit',
+    });
+    info(`building "${ctx.appName}" via trident`);
+    await execa('yarn', ['build'], { cwd: ctx.paths.shadowDir, stdio: 'inherit' });
+    if (!(await pathExists(ctx.paths.shadowBuild))) {
+        throw new Error(`Expected build output at ${ctx.paths.shadowBuild} — not found.`);
+    }
+    output(`[z2h-cli] build complete — artifacts at ${ctx.paths.shadowBuild}`, {
+        ok: true,
+        appName: ctx.appName,
+        port: ctx.port,
+        buildDir: ctx.paths.shadowBuild,
+    });
+}
+
+export { buildCommand };

package/dist/esm/commands/clean.d.ts

@@ -0,0 +1,5 @@
+export interface CleanOptions {
+    json?: boolean;
+}
+export declare function cleanCommand(opts: CleanOptions): Promise<void>;
+//# sourceMappingURL=clean.d.ts.map

package/dist/esm/commands/clean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.d.ts","sourceRoot":"","sources":["../../../src/commands/clean.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBpE"}

package/dist/esm/commands/clean.mjs

@@ -0,0 +1,22 @@
+import { pathExists, remove } from 'fs-extra';
+import { setOutputMode, info, output } from '../util/logger.mjs';
+import { resolveConsumerPaths } from '../shadow/paths.mjs';
+
+async function cleanCommand(opts) {
+    if (opts.json) {
+        setOutputMode('json');
+    }
+    const paths = resolveConsumerPaths(process.cwd());
+    const existed = await pathExists(paths.shadowDir);
+    if (existed) {
+        info(`removing ${paths.shadowDir}`);
+        await remove(paths.shadowDir);
+    }
+    output(existed ? `[z2h-cli] cleaned shadow at ${paths.shadowDir}` : '[z2h-cli] nothing to clean', {
+        ok: true,
+        shadowDir: paths.shadowDir,
+        removed: existed,
+    });
+}
+
+export { cleanCommand };

package/dist/esm/commands/deploy.d.ts

@@ -0,0 +1,6 @@
+export interface DeployOptions {
+    dryRun?: boolean;
+    json?: boolean;
+}
+export declare function deployCommand(opts: DeployOptions): Promise<void>;
+//# sourceMappingURL=deploy.d.ts.map

package/dist/esm/commands/deploy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../../src/commands/deploy.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAaD,wBAAsB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA6EtE"}

package/dist/esm/commands/deploy.mjs

@@ -0,0 +1,86 @@
+import path from 'node:path';
+import { readJson, pathExists } from 'fs-extra';
+import 'execa';
+import { setOutputMode, info, output, warn } from '../util/logger.mjs';
+import { resolveConsumerPaths } from '../shadow/paths.mjs';
+import { readManifest, nextVersion, writeManifest, upsertEntry } from '../util/manifest.mjs';
+import { uploadDir } from '../util/s3/upload.mjs';
+import { assertBucketExists, BUCKET_WRITE_NAME, BUCKET_READ_DNS_URL } from '../util/s3/client.mjs';
+import { mfAppName, cleanAppName } from '../util/app-name.mjs';
+import { buildCommand } from './build.mjs';
+
+const APONO_BUNDLE = '<APONO_BUNDLE_NAME>'; // TODO: replace with actual bundle name once infra setup is complete
+async function requestAponoAccess() {
+    {
+        warn(`skipping Apono request — APONO_BUNDLE is still a placeholder ("${APONO_BUNDLE}"). Set it in deploy.ts before relying on auto-grant.`);
+        return;
+    }
+}
+async function deployCommand(opts) {
+    if (opts.json) {
+        setOutputMode('json');
+    }
+    info('checking S3 bucket');
+    await assertBucketExists();
+    info('building');
+    await buildCommand({ json: opts.json });
+    const paths = resolveConsumerPaths(process.cwd());
+    const consumerPkg = (await readJson(paths.consumerPkg));
+    if (!consumerPkg.name) {
+        throw new Error('Consumer package.json must have a "name" field');
+    }
+    const appName = mfAppName(consumerPkg.name);
+    if (!(await pathExists(paths.shadowBuild))) {
+        throw new Error(`No build output at ${paths.shadowBuild} after build step.`);
+    }
+    // Trident emits the canonical per-MF manifest at build/asset-manifest.json.
+    const assetManifestPath = path.join(paths.shadowBuild, 'asset-manifest.json');
+    if (!(await pathExists(assetManifestPath))) {
+        throw new Error(`Missing asset-manifest.json at ${assetManifestPath}.`);
+    }
+    const assetManifest = (await readJson(assetManifestPath));
+    info('reading current Z2H manifest');
+    const manifest = await readManifest();
+    const version = nextVersion(manifest, appName);
+    const keyPrefix = `${appName}/${version}`;
+    const url = `${BUCKET_READ_DNS_URL}/${keyPrefix}`;
+    if (opts.dryRun) {
+        output(`[z2h-cli] dry-run: would upload to s3://${BUCKET_WRITE_NAME}/${keyPrefix}/ as v${version}`, {
+            ok: true,
+            dryRun: true,
+            appName,
+            version,
+            bucket: BUCKET_WRITE_NAME,
+            keyPrefix,
+            url,
+            entry: { ...assetManifest, version, url },
+        });
+        return;
+    }
+    await requestAponoAccess();
+    info(`uploading build → s3://${BUCKET_WRITE_NAME}/${keyPrefix}/`);
+    await uploadDir(paths.shadowBuild, keyPrefix);
+    const entry = {
+        ...assetManifest,
+        version,
+        url,
+    };
+    info(`updating manifest entry "${appName}" → v${version}`);
+    await writeManifest(upsertEntry(manifest, appName, entry));
+    // The host MF parses the app name from the URL and prepends `mf-` itself
+    // before looking it up in the manifest. So the user-facing URL must use
+    // the consumer's de-scoped package name (no `mf-` prefix, no `@scope/`).
+    const liveUrl = `https://bigbrain.me/bigbrain-vibe/${cleanAppName(consumerPkg.name)}`;
+    output(`[z2h-cli] deployed ✅\n  app:     ${appName}\n  version: ${version}\n  open:    ${liveUrl}`, {
+        ok: true,
+        appName,
+        version,
+        bucket: BUCKET_WRITE_NAME,
+        keyPrefix,
+        url,
+        liveUrl,
+        entry,
+    });
+}
+
+export { deployCommand };

package/dist/esm/commands/dev.d.ts

@@ -0,0 +1,5 @@
+export interface DevOptions {
+    json?: boolean;
+}
+export declare function devCommand(opts: DevOptions): Promise<void>;
+//# sourceMappingURL=dev.d.ts.map

package/dist/esm/commands/dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../../src/commands/dev.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAID,wBAAsB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAgDhE"}

package/dist/esm/commands/dev.mjs

@@ -0,0 +1,56 @@
+import { readJson } from 'fs-extra';
+import { watch } from 'chokidar';
+import { execa } from 'execa';
+import { setOutputMode, info, output, warn, errorLog } from '../util/logger.mjs';
+import { prepareShadow } from '../shadow/prepare.mjs';
+import { ensureConsumerPkg } from '../shadow/consumer-pkg.mjs';
+import { syncShadow } from '../shadow/sync.mjs';
+
+const TRIDENT_READY_PATTERN = /Server started at/i;
+async function devCommand(opts) {
+    if (opts.json) {
+        setOutputMode('json');
+    }
+    const ctx = await prepareShadow();
+    const { port } = ctx;
+    const url = `https://bigbrain.me/bigbrain-vibe/${ctx.appName}?zth_local=${port}`;
+    info('starting z2h app');
+    // stdout is piped so we can detect trident's ready banner before printing
+    // our own ready line. stdin/stderr stay inherited so colored errors and
+    // interactive prompts still flow naturally.
+    const server = execa('yarn', ['start'], {
+        cwd: ctx.paths.shadowDir,
+        stdio: ['inherit', 'pipe', 'inherit'],
+    });
+    let readyPrinted = false;
+    server.stdout?.on('data', (chunk) => {
+        process.stdout.write(chunk);
+        if (!readyPrinted && TRIDENT_READY_PATTERN.test(chunk.toString())) {
+            readyPrinted = true;
+            output(`\n[z2h-cli] ready — open:\n  ${url}\n`, {
+                ok: true,
+                appName: ctx.appName,
+                port,
+                url,
+            });
+        }
+    });
+    // Only watch consumer package.json. Source changes flow through Vite's
+    // native import graph — the wrapper imports consumer src via relative
+    // path, so Vite's HMR picks up edits without any rsync.
+    const pkgWatcher = watch(ctx.paths.consumerPkg, { ignoreInitial: true });
+    pkgWatcher.on('change', async () => {
+        warn('consumer package.json changed — re-checking deps');
+        try {
+            const raw = (await readJson(ctx.paths.consumerPkg));
+            const { pkg } = await ensureConsumerPkg(ctx.paths.consumerPkg, raw);
+            await syncShadow(ctx.paths, pkg);
+        }
+        catch (err) {
+            errorLog(`re-prepare failed: ${err.message}`);
+        }
+    });
+    await server;
+}
+
+export { devCommand };

package/dist/esm/constants.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Cross-file constants. Narrowly-used literals (templates, prefixes used in
+ * one place) stay local to their file to keep this index small.
+ */
+export declare const SHADOW_DIR_NAME = ".zth";
+/**
+ * Protected runtime deps that MUST resolve to a single instance across the
+ * wrapper (.zth) and the consumer's src. Declared as peerDependencies in
+ * the shadow pkg so yarn hoists them from the workspace root — which is
+ * why we enforce their presence in the consumer's own package.json.
+ */
+export declare const PROTECTED_DEPS: Record<string, string>;
+/**
+ * Protected dev deps. Same idempotent treatment as PROTECTED_DEPS but live
+ * in the consumer's `devDependencies`. These give the LLM-authored consumer
+ * code access to monday.com platform types out of the box.
+ */
+export declare const PROTECTED_DEV_DEPS: Record<string, string>;
+export declare const WORKSPACE_DEV_DEPS: Record<string, string>;
+export declare const SHADOW_SCRIPTS: Record<string, string>;
+export declare const MIN_PORT = 13000;
+export declare const MAX_PORT = 19999;
+export declare const GITIGNORE_ENTRIES: string[];
+export declare const YARNRC_LINES: string[];
+//# sourceMappingURL=constants.d.ts.map

package/dist/esm/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,eAAO,MAAM,eAAe,SAAS,CAAC;AAGtC;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMjD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAGrD,CAAC;AAIF,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKrD,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAGjD,CAAC;AAMF,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAG9B,eAAO,MAAM,iBAAiB,UAAY,CAAC;AAG3C,eAAO,MAAM,YAAY,UAIxB,CAAC"}