@bleedingdev/modern-js-create 3.5.0-ultramodern.9 → 3.5.0-ultramodern.90

package/dist/esm/ultramodern-workspace/write-app.js

@@ -0,0 +1,105 @@
+import { createApiClient, createApiServiceEntry, createBackendEffectApiExpose, createSharedApi, createShellApiClient } from "./api.js";
+import { createRpcClientFile, createRpcContractFile } from "./api/rpc.js";
+import { createAppEnvDts, createAppRuntimeConfig, createAppStyles, createShellFrameComponent, createTailwindConfig } from "./app-files.js";
+import { createBackendFederationContractFile } from "./backend-federation.js";
+import { createFederatedComponentsRegistry, createLayout, createRemoteEntry, createRemoteExposeComponent, createRemoteExposeFragmentPage, createRemotePage, createShellPage, createShellRemoteComponents, createShellWorkerRemoteComponents, remoteComponentOutputPath } from "./demo-components.js";
+import { appEmitsBrowserUi, appHasApi, appI18nNamespace, createShellHost, distributedSsrExposes, distributedSsrFragmentSlug, resolveApiProtocol, resolveRemoteRefs } from "./descriptors.js";
+import { writeFile, writeFileReplacing, writeJson } from "./fs-io.js";
+import { createAppPublicLocaleMessages } from "./locales.js";
+import { createAppModernConfig, createBackendModuleFederationConfig, createRemoteModuleFederationConfig, createShellModuleFederationConfig, createUltramodernBuildArtifactJson, createUltramodernBuildModule, createUltramodernBuildReexportModule } from "./module-federation.js";
+import { createAppMfTypesTsConfig, createAppPackage, createAppTsConfig } from "./package-json.js";
+import { createPublicWebAppArtifacts } from "./public-surface.js";
+function writeApp(targetDir, scope, app, packageSource, enableTailwind, remotes = [], bridge, devPorts) {
+    const resolvedApp = 'shell' === app.kind && app.id === createShellHost(remotes).id ? createShellHost(remotes) : app;
+    const emitsUi = appEmitsBrowserUi(resolvedApp);
+    const appTailwind = enableTailwind && emitsUi;
+    const resolvedRemotes = 'shell' === resolvedApp.kind ? resolveRemoteRefs(resolvedApp, remotes) : remotes;
+    const publicWeb = createPublicWebAppArtifacts(resolvedApp);
+    const writeAppFile = (relativePath, content)=>{
+        writeFile(targetDir, `${resolvedApp.directory}/${relativePath}`, content);
+    };
+    const context = {
+        targetDir,
+        scope,
+        resolvedApp,
+        packageSource,
+        enableTailwind: appTailwind,
+        emitsUi,
+        remotes: resolvedRemotes,
+        bridge,
+        devPorts,
+        publicWeb,
+        writeAppFile
+    };
+    writeAppConfigFiles(context);
+    writeAppLocaleAndStyleFiles(context);
+    writeAppFederationConfigFiles(context);
+    writeAppRouteAndShellFiles(context);
+    writeAppApiAndRemoteExposeFiles(context);
+}
+function rewriteAppModernConfig(targetDir, scope, app, remotes, enableTailwind, devPorts) {
+    writeFileReplacing(targetDir, `${app.directory}/modern.config.ts`, createAppModernConfig(scope, app, remotes, enableTailwind, devPorts));
+}
+function writeAppConfigFiles({ targetDir, scope, resolvedApp, packageSource, enableTailwind, emitsUi, remotes, bridge, devPorts, publicWeb }) {
+    writeJson(targetDir, `${resolvedApp.directory}/package.json`, createAppPackage(scope, resolvedApp, packageSource, enableTailwind, remotes, bridge));
+    writeJson(targetDir, `${resolvedApp.directory}/tsconfig.json`, createAppTsConfig(resolvedApp, remotes));
+    writeJson(targetDir, `${resolvedApp.directory}/tsconfig.mf-types.json`, createAppMfTypesTsConfig(resolvedApp));
+    writeFile(targetDir, `${resolvedApp.directory}/src/modern-app-env.d.ts`, createAppEnvDts(resolvedApp, remotes, scope));
+    writeFile(targetDir, `${resolvedApp.directory}/src/ultramodern-build.ts`, createUltramodernBuildReexportModule());
+    writeFile(targetDir, `${resolvedApp.directory}/shared/ultramodern-build.ts`, createUltramodernBuildModule(scope, resolvedApp));
+    writeFile(targetDir, `${resolvedApp.directory}/shared/ultramodern-build.json`, createUltramodernBuildArtifactJson(scope, resolvedApp));
+    if (emitsUi) {
+        writeFile(targetDir, publicWeb.jsonLdHelperFile.path, publicWeb.jsonLdHelperFile.content);
+        writeFile(targetDir, publicWeb.routeMetadataFile.path, publicWeb.routeMetadataFile.content);
+        writeFile(targetDir, publicWeb.routeHeadFile.path, publicWeb.routeHeadFile.content);
+    }
+    writeFile(targetDir, `${resolvedApp.directory}/modern.config.ts`, createAppModernConfig(scope, resolvedApp, remotes, enableTailwind, devPorts));
+    writeFile(targetDir, `${resolvedApp.directory}/src/modern.runtime.ts`, createAppRuntimeConfig(resolvedApp, scope, remotes));
+}
+function writeAppLocaleAndStyleFiles({ targetDir, scope, resolvedApp, enableTailwind, emitsUi, remotes }) {
+    writeJson(targetDir, `${resolvedApp.directory}/locales/en/translation.json`, createAppPublicLocaleMessages(resolvedApp, 'en', remotes));
+    writeJson(targetDir, `${resolvedApp.directory}/locales/en/${appI18nNamespace(resolvedApp)}.json`, createAppPublicLocaleMessages(resolvedApp, 'en', remotes));
+    writeJson(targetDir, `${resolvedApp.directory}/locales/cs/translation.json`, createAppPublicLocaleMessages(resolvedApp, 'cs', remotes));
+    writeJson(targetDir, `${resolvedApp.directory}/locales/cs/${appI18nNamespace(resolvedApp)}.json`, createAppPublicLocaleMessages(resolvedApp, 'cs', remotes));
+    if (emitsUi) writeFile(targetDir, `${resolvedApp.directory}/src/routes/index.css`, createAppStyles(enableTailwind, scope, resolvedApp));
+    if (enableTailwind) writeFile(targetDir, `${resolvedApp.directory}/tailwind.config.ts`, createTailwindConfig());
+}
+function writeAppFederationConfigFiles({ targetDir, scope, resolvedApp, emitsUi, remotes }) {
+    if (emitsUi) writeFile(targetDir, `${resolvedApp.directory}/module-federation.config.ts`, 'shell' === resolvedApp.kind ? createShellModuleFederationConfig(scope, resolvedApp, remotes) : createRemoteModuleFederationConfig(scope, resolvedApp, remotes));
+    if (appHasApi(resolvedApp)) writeFile(targetDir, `${resolvedApp.directory}/backend-federation.config.ts`, createBackendModuleFederationConfig(resolvedApp));
+}
+function writeAppRouteAndShellFiles({ targetDir, scope, resolvedApp, emitsUi, remotes, publicWeb, writeAppFile }) {
+    if (!emitsUi) return;
+    if ((resolvedApp.verticalRefs?.length ?? 0) > 0) {
+        writeAppFile('src/federated-components.tsx', createFederatedComponentsRegistry(scope, resolvedApp, remotes));
+        writeAppFile('src/federated-components.worker.tsx', createFederatedComponentsRegistry(scope, resolvedApp, remotes, true));
+    }
+    writeAppFile('src/routes/layout.tsx', createLayout(resolvedApp.id));
+    writeAppFile('src/routes/[lang]/page.tsx', 'shell' === resolvedApp.kind ? createShellPage(resolvedApp, remotes.filter(appEmitsBrowserUi)) : createRemotePage(resolvedApp));
+    for (const generatedFile of publicWeb.routeMetaFiles)writeFile(targetDir, generatedFile.path, generatedFile.content);
+    for (const generatedFile of publicWeb.routeAliasFiles)writeFile(targetDir, generatedFile.path, generatedFile.content);
+    if ('shell' === resolvedApp.kind) {
+        writeAppFile('src/routes/vertical-components.tsx', createShellRemoteComponents(resolvedApp, remotes.filter(appEmitsBrowserUi)));
+        writeAppFile('src/routes/vertical-components.worker.tsx', createShellWorkerRemoteComponents(resolvedApp, remotes.filter(appEmitsBrowserUi)));
+        writeAppFile('src/routes/shell-frame.tsx', createShellFrameComponent(resolvedApp));
+        writeFile(targetDir, `${resolvedApp.directory}/src/api/vertical-clients.ts`, createShellApiClient(scope, remotes));
+    } else for (const expose of distributedSsrExposes(resolvedApp))writeAppFile(`src/routes/[lang]/_mf/fragment/${distributedSsrFragmentSlug(expose)}/page.tsx`, createRemoteExposeFragmentPage(resolvedApp, expose));
+}
+function writeAppApiAndRemoteExposeFiles({ targetDir, scope, resolvedApp, emitsUi, writeAppFile }) {
+    if (appHasApi(resolvedApp)) {
+        const rpcProtocol = 'rpc' === resolveApiProtocol(resolvedApp);
+        rpcProtocol ? writeFile(targetDir, `${resolvedApp.directory}/shared/rpc.ts`, createRpcContractFile(resolvedApp)) : writeFile(targetDir, `${resolvedApp.directory}/shared/api.ts`, createSharedApi(resolvedApp));
+        writeFile(targetDir, `${resolvedApp.directory}/api/index.ts`, createApiServiceEntry(resolvedApp, rpcProtocol ? '../shared/rpc.ts' : '../shared/api.ts'));
+        writeFile(targetDir, `${resolvedApp.directory}/api/backend-federation.ts`, createBackendFederationContractFile(resolvedApp));
+        writeFile(targetDir, `${resolvedApp.directory}/api/effect-api.ts`, createBackendEffectApiExpose(scope, resolvedApp));
+        rpcProtocol ? writeFile(targetDir, `${resolvedApp.directory}/src/api/${resolvedApp.api.stem}-rpc-client.ts`, createRpcClientFile(resolvedApp)) : writeFile(targetDir, `${resolvedApp.directory}/src/api/${resolvedApp.api.stem}-client.ts`, createApiClient(resolvedApp, '../../shared/api'));
+    }
+    if ('vertical' === resolvedApp.kind && emitsUi) {
+        writeAppFile('src/federation-entry.tsx', createRemoteEntry(resolvedApp));
+        for (const expose of Object.keys(resolvedApp.exposes ?? {})){
+            const outputPath = remoteComponentOutputPath(resolvedApp, expose);
+            if (outputPath) writeAppFile(outputPath.slice(resolvedApp.directory.length + 1), createRemoteExposeComponent(resolvedApp, expose));
+        }
+    }
+}
+export { rewriteAppModernConfig, writeApp };

package/dist/esm/ultramodern-workspace/write-workspace.js

@@ -1,69 +1,22 @@
 import node_fs from "node:fs";
-import { createApiClient, createApiServiceEntry, createSharedApi, createShellApiClient } from "./api.js";
-import { createAppEnvDts, createAppRuntimeConfig, createAppStyles, createPostcssConfig, createSharedDesignTokensCss, createShellFrameComponent, createTailwindConfig } from "./app-files.js";
+import { RELEASE_COHORT_PROJECTION_PATH, copyCreateReleaseCohort, isCreatePackageSourceCheckout, readCreateReleaseCohort } from "../ultramodern-release-cohort.js";
+import { createSharedDesignTokensCss } from "./app-files.js";
 import { normalizeUltramodernBridgeConfig } from "./bridge-config.js";
 import { createDevelopmentOverlay, createOwnership, createTopology, createUltramodernConfig } from "./contracts.js";
-import { createLayout, createRemoteEntry, createRemoteExposeComponent, createRemotePage, createShellPage, createShellRemoteComponents, remoteComponentOutputPath } from "./demo-components.js";
-import { ULTRAMODERN_CONFIG_PATH, appHasApi, appI18nNamespace, createShellHost, sharedPackages, shellApp } from "./descriptors.js";
+import { ULTRAMODERN_CONFIG_PATH, createShellHost, sharedPackages, shellApp } from "./descriptors.js";
 import { copyRootTemplate, formatGeneratedWorkspaceFiles, writeFile, writeFileReplacing, writeJson } from "./fs-io.js";
 import { createFileSnapshot, createGenerationResult, diffFileSnapshots } from "./generation-result.js";
-import { createAppPublicLocaleMessages } from "./locales.js";
-import { createAppModernConfig, createRemoteModuleFederationConfig, createShellModuleFederationConfig, createUltramodernBuildModule, createUltramodernBuildReexportModule } from "./module-federation.js";
 import { assertUniqueTailwindPrefixes, toPackageScope } from "./naming.js";
 import { runCodeSmithOverlays } from "./overlays.js";
-import { createAppMfTypesTsConfig, createAppPackage, createAppTsConfig, createRootPackageJson, createRootTsConfig, createSharedContractsIndex, createSharedPackage, createSharedPackageTsConfig, createTsConfigBase } from "./package-json.js";
-import { resolvePackageSource } from "./package-source.js";
-import { createPublicWebAppArtifacts } from "./public-surface.js";
-import { EFFECT_VERSION, EFFECT_VITEST_VERSION, NODE_FETCH_VERSION, NODE_VERSION, PNPM_VERSION, TANSTACK_ROUTER_CORE_VERSION, TANSTACK_ROUTER_VERSION, TYPESCRIPT_VERSION } from "./versions.js";
+import { createRootPackageJson, createRootTsConfig, createSharedContractsIndex, createSharedPackage, createSharedPackageTsConfig, createTsConfigBase } from "./package-json.js";
+import { resolvePackageSource, resolveWorkspacePackageLinkingPolicy } from "./package-source.js";
+import { renderMinimumReleaseAgeExclude } from "./policy.js";
+import { DRIZZLE_ORM_VERSION, EFFECT_VERSION, EFFECT_VITEST_VERSION, I18NEXT_VERSION, MODULE_FEDERATION_VERSION, NODE_FETCH_VERSION, NODE_VERSION, PNPM_VERSION, TANSTACK_ROUTER_CORE_VERSION, TANSTACK_ROUTER_VERSION, TYPESCRIPT_VERSION, WRANGLER_VERSION } from "./versions.js";
 import { writeGeneratedWorkspaceScripts } from "./workspace-scripts.js";
-function writeApp(targetDir, scope, app, packageSource, enableTailwind, remotes = [], bridge) {
-    const resolvedApp = 'shell' === app.kind ? createShellHost(remotes) : app;
-    const publicWeb = createPublicWebAppArtifacts(resolvedApp);
-    const writeAppFile = (relativePath, content)=>{
-        writeFile(targetDir, `${resolvedApp.directory}/${relativePath}`, content);
-    };
-    writeJson(targetDir, `${resolvedApp.directory}/package.json`, createAppPackage(scope, resolvedApp, packageSource, enableTailwind, remotes, bridge));
-    writeJson(targetDir, `${resolvedApp.directory}/tsconfig.json`, createAppTsConfig(resolvedApp, remotes));
-    writeJson(targetDir, `${resolvedApp.directory}/tsconfig.mf-types.json`, createAppMfTypesTsConfig(resolvedApp));
-    writeFile(targetDir, `${resolvedApp.directory}/src/modern-app-env.d.ts`, createAppEnvDts(resolvedApp, remotes));
-    writeFile(targetDir, `${resolvedApp.directory}/src/ultramodern-build.ts`, createUltramodernBuildReexportModule());
-    writeFile(targetDir, `${resolvedApp.directory}/shared/ultramodern-build.ts`, createUltramodernBuildModule(scope, resolvedApp));
-    writeFile(targetDir, publicWeb.jsonLdHelperFile.path, publicWeb.jsonLdHelperFile.content);
-    writeFile(targetDir, publicWeb.routeMetadataFile.path, publicWeb.routeMetadataFile.content);
-    writeFile(targetDir, publicWeb.routeHeadFile.path, publicWeb.routeHeadFile.content);
-    writeFile(targetDir, `${resolvedApp.directory}/modern.config.ts`, createAppModernConfig(scope, resolvedApp));
-    writeFile(targetDir, `${resolvedApp.directory}/src/modern.runtime.ts`, createAppRuntimeConfig(resolvedApp, scope, remotes));
-    writeJson(targetDir, `${resolvedApp.directory}/locales/en/translation.json`, createAppPublicLocaleMessages(resolvedApp, 'en', remotes));
-    writeJson(targetDir, `${resolvedApp.directory}/locales/en/${appI18nNamespace(resolvedApp)}.json`, createAppPublicLocaleMessages(resolvedApp, 'en', remotes));
-    writeJson(targetDir, `${resolvedApp.directory}/locales/cs/translation.json`, createAppPublicLocaleMessages(resolvedApp, 'cs', remotes));
-    writeJson(targetDir, `${resolvedApp.directory}/locales/cs/${appI18nNamespace(resolvedApp)}.json`, createAppPublicLocaleMessages(resolvedApp, 'cs', remotes));
-    writeFile(targetDir, `${resolvedApp.directory}/src/routes/index.css`, createAppStyles(enableTailwind, scope, resolvedApp));
-    if (enableTailwind) {
-        writeFile(targetDir, `${resolvedApp.directory}/postcss.config.mjs`, createPostcssConfig());
-        writeFile(targetDir, `${resolvedApp.directory}/tailwind.config.ts`, createTailwindConfig());
-    }
-    writeFile(targetDir, `${resolvedApp.directory}/module-federation.config.ts`, 'shell' === resolvedApp.kind ? createShellModuleFederationConfig(scope, remotes) : createRemoteModuleFederationConfig(scope, resolvedApp, remotes));
-    writeAppFile('src/routes/layout.tsx', createLayout(resolvedApp.id));
-    writeAppFile('src/routes/[lang]/page.tsx', 'shell' === resolvedApp.kind ? createShellPage(remotes) : createRemotePage(resolvedApp));
-    for (const generatedFile of publicWeb.routeMetaFiles)writeFile(targetDir, generatedFile.path, generatedFile.content);
-    for (const generatedFile of publicWeb.routeAliasFiles)writeFile(targetDir, generatedFile.path, generatedFile.content);
-    if ('shell' === resolvedApp.kind) {
-        writeAppFile('src/routes/vertical-components.tsx', createShellRemoteComponents(scope, remotes));
-        writeAppFile('src/routes/shell-frame.tsx', createShellFrameComponent());
-        writeFile(targetDir, `${resolvedApp.directory}/src/api/vertical-clients.ts`, createShellApiClient(scope, remotes));
-    }
-    if (appHasApi(resolvedApp)) {
-        writeFile(targetDir, `${resolvedApp.directory}/shared/api.ts`, createSharedApi(resolvedApp));
-        writeFile(targetDir, `${resolvedApp.directory}/api/index.ts`, createApiServiceEntry(resolvedApp, '../shared/api.ts'));
-        writeFile(targetDir, `${resolvedApp.directory}/src/api/${resolvedApp.api.stem}-client.ts`, createApiClient(resolvedApp, '../../shared/api'));
-    }
-    if ('vertical' === resolvedApp.kind) {
-        writeAppFile('src/federation-entry.tsx', createRemoteEntry(resolvedApp));
-        for (const expose of Object.keys(resolvedApp.exposes ?? {})){
-            const outputPath = remoteComponentOutputPath(resolvedApp, expose);
-            if (outputPath) writeAppFile(outputPath.slice(resolvedApp.directory.length + 1), createRemoteExposeComponent(resolvedApp, expose));
-        }
-    }
+import { writeApp } from "./write-app.js";
+import { createZeropsYaml } from "./zerops.js";
+function hasExplicitInstallRequest(options) {
+    return void 0 !== options.packageSource && 'workspace' !== options.packageSource.strategy;
 }
 function writeSharedPackages(targetDir, scope) {
     for (const sharedPackage of sharedPackages){
@@ -88,8 +41,8 @@ function createCompactRootPackageJson(scope, packageSource, remotes, bridge) {
 }
 function createCompactUltramodernConfig(scope, modernVersion, packageSource, apps = [
     createShellHost()
-], enableTailwind = true, bridge) {
-    const config = createUltramodernConfig(scope, modernVersion, packageSource, apps, enableTailwind, bridge);
+], enableTailwind = true, bridge, additionalShells = [], primaryShell) {
+    const config = createUltramodernConfig(scope, modernVersion, packageSource, apps, enableTailwind, bridge, additionalShells, primaryShell);
     if (config.packageSource && 'object' == typeof config.packageSource && !Array.isArray(config.packageSource)) delete config.packageSource.metadata;
     return config;
 }
@@ -104,12 +57,25 @@ function writePnpmWorkspacePackages(targetDir, bridge) {
         ...bridge.workspacePackages.map((entry)=>entry.pattern)
     ];
     const renderedPackages = packages.map((pattern)=>`  - ${pattern}`).join('\n');
-    writeFileReplacing(targetDir, 'pnpm-workspace.yaml', pnpmWorkspace.replace(/^packages:\n(?: {2}- .+\n)+/u, `packages:\n${renderedPackages}\n`));
+    writeFileReplacing(targetDir, 'pnpm-workspace.yaml', pnpmWorkspace.replace(/^packages:\r?\n(?: {2}- .+\r?\n)+/u, `packages:\n${renderedPackages}\n`));
 }
 function generateUltramodernWorkspace(options) {
     const beforeFiles = createFileSnapshot(options.targetDir);
     const scope = toPackageScope(options.packageName);
-    const packageSource = resolvePackageSource(options);
+    let packageSource;
+    let releaseCohort;
+    if (isCreatePackageSourceCheckout()) {
+        if (hasExplicitInstallRequest(options)) throw new Error('A local @modern-js/create source checkout cannot satisfy an explicit install package source. Use workspace mode locally or run the packed published package with its authenticated release cohort projection.');
+        packageSource = resolvePackageSource({
+            ...options,
+            packageSource: {
+                strategy: 'workspace'
+            }
+        });
+    } else {
+        packageSource = resolvePackageSource(options);
+        if ('install' === packageSource.strategy) releaseCohort = readCreateReleaseCohort();
+    }
     const bridge = normalizeUltramodernBridgeConfig(options.bridge);
     const enableTailwind = false !== options.enableTailwind;
     const initialVerticals = [];
@@ -124,31 +90,46 @@ function generateUltramodernWorkspace(options) {
     node_fs.mkdirSync(options.targetDir, {
         recursive: true
     });
+    const minimumReleaseAgeExclude = renderMinimumReleaseAgeExclude({
+        packageSource,
+        releaseCohort
+    });
+    const workspacePackageLinkingPolicy = resolveWorkspacePackageLinkingPolicy(packageSource);
     copyRootTemplate(options.targetDir, {
         packageName: options.packageName,
         packageScope: scope,
         nodeVersion: NODE_VERSION,
         pnpmVersion: PNPM_VERSION,
         nodeFetchVersion: NODE_FETCH_VERSION,
+        drizzleOrmVersion: DRIZZLE_ORM_VERSION,
         effectVersion: EFFECT_VERSION,
         effectVitestVersion: EFFECT_VITEST_VERSION,
+        i18nextVersion: I18NEXT_VERSION,
+        moduleFederationVersion: MODULE_FEDERATION_VERSION,
         tanstackRouterCoreVersion: TANSTACK_ROUTER_CORE_VERSION,
         tanstackRouterVersion: TANSTACK_ROUTER_VERSION,
         typescriptVersion: TYPESCRIPT_VERSION,
+        wranglerVersion: WRANGLER_VERSION,
+        minimumReleaseAgeExcludeYaml: 0 === minimumReleaseAgeExclude.length ? ' []' : `\n${minimumReleaseAgeExclude.map((selector)=>`  - '${selector}'`).join('\n')}`,
+        workspacePackageLinkingYaml: Object.entries(workspacePackageLinkingPolicy).map(([key, value])=>`${key}: ${String(value)}\n`).join(''),
         tailwindEnabled: String(enableTailwind)
-    });
+    }, new Set([
+        RELEASE_COHORT_PROJECTION_PATH
+    ]));
+    if (releaseCohort) copyCreateReleaseCohort(options.targetDir);
     writePnpmWorkspacePackages(options.targetDir, bridge);
     writeJson(options.targetDir, 'package.json', createCompactRootPackageJson(scope, packageSource, initialVerticals, bridge));
+    writeFile(options.targetDir, 'zerops.yaml', `${createZeropsYaml(scope, createdApps)}\n`);
     writeJson(options.targetDir, 'tsconfig.base.json', createTsConfigBase());
     writeJson(options.targetDir, 'tsconfig.json', createRootTsConfig(createdApps));
     writeJson(options.targetDir, 'topology/reference-topology.json', createTopology(scope, initialVerticals));
     writeJson(options.targetDir, 'topology/ownership.json', createOwnership(scope, initialVerticals));
-    writeJson(options.targetDir, 'topology/local-overlays/development.json', createDevelopmentOverlay(initialVerticals));
+    writeJson(options.targetDir, 'topology/local-overlays/development.json', createDevelopmentOverlay(scope, initialVerticals));
     writeJson(options.targetDir, ULTRAMODERN_CONFIG_PATH, createCompactUltramodernConfig(scope, options.modernVersion, packageSource, createdApps, enableTailwind, bridge));
     writeApp(options.targetDir, scope, shellApp, packageSource, enableTailwind, initialVerticals, bridge);
     for (const remote of initialVerticals)writeApp(options.targetDir, scope, remote, packageSource, enableTailwind, initialVerticals, bridge);
     writeSharedPackages(options.targetDir, scope);
-    writeGeneratedWorkspaceScripts(options.targetDir, scope, enableTailwind, initialVerticals);
+    writeGeneratedWorkspaceScripts(options.targetDir, scope, enableTailwind, initialVerticals, releaseCohort);
     const preliminaryAfterFiles = createFileSnapshot(options.targetDir);
     const preliminaryDiff = diffFileSnapshots(beforeFiles, preliminaryAfterFiles);
     const preliminaryResult = createGenerationResult({
@@ -178,4 +159,4 @@ function generateUltramodernWorkspace(options) {
         rewrittenPaths
     });
 }
-export { createCompactUltramodernConfig, generateUltramodernWorkspace, writeApp, writeSharedPackages };
+export { createCompactUltramodernConfig, generateUltramodernWorkspace, writeApp };

package/dist/esm/ultramodern-workspace/zerops.js

@@ -0,0 +1,70 @@
+import { appHasApi, resolveApiPrefix, resolveApiProtocol, resolveApiStem } from "./descriptors.js";
+import { packageName } from "./naming.js";
+import { NODE_VERSION } from "./versions.js";
+const zeropsNodeRuntime = `nodejs@${NODE_VERSION.split('.')[0]}`;
+function quoteYamlString(value) {
+    return `'${value.replace(/'/gu, "''")}'`;
+}
+function quoteShellValue(value) {
+    return `'${value.replace(/'/gu, "'\\''")}'`;
+}
+function readinessPath(app) {
+    if (!appHasApi(app)) return '/';
+    return `${resolveApiPrefix(app)}/${resolveApiStem(app)}/readiness`;
+}
+function hasHttpReadiness(app) {
+    return !appHasApi(app) || 'rest' === resolveApiProtocol(app);
+}
+function createZeropsService(scope, app) {
+    const runtimeDirectory = `.zerops/runtime/${app.id}`;
+    const appPackageName = packageName(scope, app.packageSuffix);
+    const commands = [
+        'curl https://mise.run | sh',
+        '~/.local/bin/mise install',
+        '~/.local/bin/mise exec -- pnpm install --frozen-lockfile',
+        `~/.local/bin/mise exec -- pnpm --filter ${quoteShellValue(appPackageName)} run build`,
+        `~/.local/bin/mise exec -- pnpm run zerops:materialize -- --app ${quoteShellValue(app.id)} --package ${quoteShellValue(appPackageName)} --package-dir ${quoteShellValue(app.directory)}`,
+        `cp ${quoteShellValue('topology/reference-topology.json')} ${quoteShellValue(`${runtimeDirectory}/topology.json`)}`,
+        `cp ${quoteShellValue('topology/local-overlays/development.json')} ${quoteShellValue(`${runtimeDirectory}/local-overlay.json`)}`
+    ];
+    return [
+        `  - setup: ${quoteYamlString(app.id)}`,
+        '    build:',
+        `      base: ${quoteYamlString(zeropsNodeRuntime)}`,
+        '      buildCommands:',
+        '        - |',
+        ...commands.map((command)=>`          ${command}`),
+        '      deployFiles:',
+        `        - ${quoteYamlString(runtimeDirectory)}`,
+        '    deploy:',
+        '      temporaryShutdown: false',
+        ...hasHttpReadiness(app) ? [
+            '      readinessCheck:',
+            '        httpGet:',
+            `          port: ${app.port}`,
+            `          path: ${quoteYamlString(readinessPath(app))}`,
+            '        failureTimeout: 120',
+            '        retryPeriod: 10'
+        ] : [],
+        '    run:',
+        `      base: ${quoteYamlString(zeropsNodeRuntime)}`,
+        '      ports:',
+        `        - port: ${app.port}`,
+        '          protocol: TCP',
+        '          httpSupport: true',
+        '      envVariables:',
+        '        NODE_ENV: production',
+        `        ${app.portEnv}: ${quoteYamlString(String(app.port))}`,
+        `        ULTRAMODERN_ZEROPS_SERVICE: ${quoteYamlString(app.id)}`,
+        `      start: cd ${quoteShellValue(runtimeDirectory)} && npm run serve`
+    ].join('\n');
+}
+function createZeropsYaml(scope, apps) {
+    return [
+        '# Generated by Modern.js UltraModern workspace tooling.',
+        '# Zerops runs each full-stack MicroVertical as a package-owned Node service.',
+        'zerops:',
+        ...apps.map((app)=>createZeropsService(scope, app))
+    ].join('\n\n');
+}
+export { createZeropsYaml };

package/dist/esm-node/cli/flags.js

@@ -0,0 +1,263 @@
+import "node:module";
+import { i18n, localeKeys } from "../locale/index.js";
+import { parseUltramodernBridgeCliOptions, ultramodernBridgeCliBooleanFlags, ultramodernBridgeCliValueFlags } from "../ultramodern-workspace/bridge-config.js";
+const WORKSPACE_PROTOCOL_FLAG = '--workspace';
+const DRY_RUN_FLAG = '--dry-run';
+const VERTICAL_FLAG = '--vertical';
+const VERTICAL_NAME_FLAG = '--vertical-name';
+const CODESMITH_OVERLAY_FLAG = '--codesmith-overlay';
+const PRESET_FLAG = '--preset';
+const API_PROTOCOL_FLAG = '--api-protocol';
+const HORIZONTAL_REMOTE_FLAG = '--horizontal-remote';
+const SUPPORTED_PRESETS = [
+    'full-stack',
+    'api-only',
+    'ui-only'
+];
+const SUPPORTED_API_PROTOCOLS = [
+    'rest',
+    'rpc'
+];
+const BFF_FLAG = '--bff';
+const BFF_RUNTIME_OPTION = '--bff-runtime';
+const SUPPORTED_BFF_RUNTIMES = [
+    'effect'
+];
+function getOptionValue(args, names) {
+    for (const name of names){
+        const prefix = `${name}=`;
+        const byEquals = args.find((arg)=>arg.startsWith(prefix));
+        if (byEquals) return byEquals.slice(prefix.length);
+        const index = args.findIndex((arg)=>arg === name);
+        if (-1 !== index && args[index + 1] && !args[index + 1].startsWith('-')) return args[index + 1];
+    }
+}
+const detectLanguage = ()=>{
+    const lang = getOptionValue(process.argv.slice(2), [
+        '--lang',
+        '-l'
+    ]);
+    if ('zh' === lang) return 'zh';
+    return 'en';
+};
+function detectBffRuntime(args) {
+    if (args.some((arg)=>arg.startsWith(`${BFF_FLAG}=`))) {
+        console.error(`${BFF_FLAG} does not accept a value. Use: ${BFF_RUNTIME_OPTION} <runtime>`);
+        process.exit(1);
+    }
+    const runtimeRequested = args.some((arg)=>arg === BFF_RUNTIME_OPTION || arg.startsWith(`${BFF_RUNTIME_OPTION}=`));
+    if (!runtimeRequested) return 'effect';
+    const runtime = getOptionValue(args, [
+        BFF_RUNTIME_OPTION
+    ]);
+    if (!runtime) {
+        console.error(`${BFF_RUNTIME_OPTION} requires a value (supported: ${SUPPORTED_BFF_RUNTIMES.join(', ')})`);
+        process.exit(1);
+    }
+    if (!SUPPORTED_BFF_RUNTIMES.includes(runtime)) {
+        console.error(`Unsupported BFF runtime "${runtime}". UltraModern workspaces scaffold a strict Effect API runtime for every MicroVertical (supported: ${SUPPORTED_BFF_RUNTIMES.join(', ')}).`);
+        process.exit(1);
+    }
+    return runtime;
+}
+function detectTailwindFlag() {
+    const args = process.argv.slice(2);
+    return !args.includes('--no-tailwind');
+}
+function detectExplicitTailwindFlag() {
+    const args = process.argv.slice(2);
+    if (args.includes('--no-tailwind')) return false;
+    if (args.includes('--tailwind')) return true;
+}
+function collectPositionalArgs(args) {
+    const optionWithValue = new Set([
+        '--lang',
+        '-l',
+        BFF_RUNTIME_OPTION,
+        '--ultramodern-package-source',
+        '--ultramodern-package-version',
+        '--ultramodern-package-registry',
+        '--ultramodern-package-scope',
+        '--ultramodern-package-name-prefix',
+        VERTICAL_NAME_FLAG,
+        CODESMITH_OVERLAY_FLAG,
+        PRESET_FLAG,
+        API_PROTOCOL_FLAG,
+        ...ultramodernBridgeCliValueFlags
+    ]);
+    const optionWithoutValue = new Set([
+        '--help',
+        '-h',
+        '--version',
+        '-v',
+        '--tailwind',
+        '--no-tailwind',
+        BFF_FLAG,
+        WORKSPACE_PROTOCOL_FLAG,
+        DRY_RUN_FLAG,
+        VERTICAL_FLAG,
+        HORIZONTAL_REMOTE_FLAG,
+        ...ultramodernBridgeCliBooleanFlags
+    ]);
+    const positionalArgs = [];
+    for(let i = 0; i < args.length; i++){
+        const arg = args[i];
+        if (!optionWithoutValue.has(arg)) {
+            if (optionWithValue.has(arg)) {
+                i += 1;
+                continue;
+            }
+            if (!(arg.startsWith('--lang=') || arg.startsWith(`${BFF_RUNTIME_OPTION}=`) || arg.startsWith('--ultramodern-package-source=') || arg.startsWith('--ultramodern-package-version=') || arg.startsWith('--ultramodern-package-registry=') || arg.startsWith('--ultramodern-package-scope=') || arg.startsWith('--ultramodern-package-name-prefix=') || arg.startsWith(`${VERTICAL_FLAG}=`) || arg.startsWith(`${VERTICAL_NAME_FLAG}=`) || arg.startsWith(`${CODESMITH_OVERLAY_FLAG}=`) || arg.startsWith(`${PRESET_FLAG}=`) || arg.startsWith(`${API_PROTOCOL_FLAG}=`) || ultramodernBridgeCliBooleanFlags.some((flag)=>arg.startsWith(`${flag}=`)) || ultramodernBridgeCliValueFlags.some((flag)=>arg.startsWith(`${flag}=`)))) positionalArgs.push(arg);
+        }
+    }
+    return positionalArgs;
+}
+function readRequiredVerticalNameValue(args, index) {
+    const value = args[index + 1];
+    if (!value || value.startsWith('-')) {
+        console.error(i18n.t(localeKeys.error.verticalNameMissing));
+        process.exit(1);
+    }
+    return value;
+}
+function resolveVerticalCliInput(args) {
+    const candidates = [];
+    let addVertical = false;
+    for(let i = 0; i < args.length; i++){
+        const arg = args[i];
+        if (arg === VERTICAL_FLAG) {
+            addVertical = true;
+            continue;
+        }
+        if (arg.startsWith(`${VERTICAL_FLAG}=`)) {
+            addVertical = true;
+            candidates.push({
+                value: arg.slice(`${VERTICAL_FLAG}=`.length),
+                source: `${VERTICAL_FLAG}=<name>`
+            });
+            continue;
+        }
+        if (arg === VERTICAL_NAME_FLAG) {
+            addVertical = true;
+            candidates.push({
+                value: readRequiredVerticalNameValue(args, i),
+                source: VERTICAL_NAME_FLAG
+            });
+            i += 1;
+            continue;
+        }
+        if (arg.startsWith(`${VERTICAL_NAME_FLAG}=`)) {
+            addVertical = true;
+            candidates.push({
+                value: arg.slice(`${VERTICAL_NAME_FLAG}=`.length),
+                source: `${VERTICAL_NAME_FLAG}=<name>`
+            });
+        }
+    }
+    if (!addVertical) return {
+        addVertical: false
+    };
+    const positionalArgs = collectPositionalArgs(args);
+    if (positionalArgs.length > 1) {
+        console.error(`Unexpected positional argument: ${positionalArgs[1]}`);
+        process.exit(1);
+    }
+    if (positionalArgs[0]) candidates.push({
+        value: positionalArgs[0],
+        source: 'positional argument'
+    });
+    const emptyCandidate = candidates.find((candidate)=>'' === candidate.value);
+    if (!candidates.length || emptyCandidate) {
+        console.error(i18n.t(localeKeys.error.verticalNameMissing));
+        process.exit(1);
+    }
+    const [firstCandidate] = candidates;
+    const disagreement = candidates.find((candidate)=>candidate.value !== firstCandidate.value);
+    if (disagreement) {
+        console.error(i18n.t(localeKeys.error.verticalNameAmbiguous, {
+            firstName: firstCandidate.value,
+            firstSource: firstCandidate.source,
+            secondName: disagreement.value,
+            secondSource: disagreement.source
+        }));
+        process.exit(1);
+    }
+    return {
+        addVertical: true,
+        name: firstCandidate.value
+    };
+}
+function detectDryRunFlag(args) {
+    if (args.some((arg)=>arg.startsWith(`${DRY_RUN_FLAG}=`))) {
+        console.error(`${DRY_RUN_FLAG} does not accept a value.`);
+        process.exit(1);
+    }
+    return args.includes(DRY_RUN_FLAG);
+}
+function detectCodeSmithOverlays(args) {
+    const overlays = [];
+    for(let i = 0; i < args.length; i++){
+        const arg = args[i];
+        if (arg === CODESMITH_OVERLAY_FLAG) {
+            const generator = args[i + 1];
+            if (!generator || generator.startsWith('-')) {
+                console.error(`${CODESMITH_OVERLAY_FLAG} requires a package or path.`);
+                process.exit(1);
+            }
+            overlays.push({
+                generator
+            });
+            i += 1;
+            continue;
+        }
+        if (arg.startsWith(`${CODESMITH_OVERLAY_FLAG}=`)) {
+            const generator = arg.slice(`${CODESMITH_OVERLAY_FLAG}=`.length);
+            if (!generator) {
+                console.error(`${CODESMITH_OVERLAY_FLAG} requires a package or path.`);
+                process.exit(1);
+            }
+            overlays.push({
+                generator
+            });
+        }
+    }
+    return overlays.length > 0 ? overlays : void 0;
+}
+function detectHorizontalRemoteFlag(args) {
+    if (args.some((arg)=>arg.startsWith(`${HORIZONTAL_REMOTE_FLAG}=`))) {
+        console.error(`${HORIZONTAL_REMOTE_FLAG} does not accept a value.`);
+        process.exit(1);
+    }
+    return args.includes(HORIZONTAL_REMOTE_FLAG);
+}
+function detectPresetFlag(args) {
+    const value = getOptionValue(args, [
+        PRESET_FLAG
+    ]);
+    if (void 0 === value) return;
+    if (!SUPPORTED_PRESETS.includes(value)) {
+        console.error(`Unsupported ${PRESET_FLAG} "${value}" (supported: ${SUPPORTED_PRESETS.join(', ')}).`);
+        process.exit(1);
+    }
+    return value;
+}
+function detectApiProtocolFlag(args) {
+    const value = getOptionValue(args, [
+        API_PROTOCOL_FLAG
+    ]);
+    if (void 0 === value) return;
+    if (!SUPPORTED_API_PROTOCOLS.includes(value)) {
+        console.error(`Unsupported ${API_PROTOCOL_FLAG} "${value}" (supported: ${SUPPORTED_API_PROTOCOLS.join(', ')}).`);
+        process.exit(1);
+    }
+    return value;
+}
+function readBridgeCliOptions(args) {
+    try {
+        return parseUltramodernBridgeCliOptions(args);
+    } catch (error) {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}
+export { API_PROTOCOL_FLAG, CODESMITH_OVERLAY_FLAG, DRY_RUN_FLAG, HORIZONTAL_REMOTE_FLAG, PRESET_FLAG, VERTICAL_FLAG, WORKSPACE_PROTOCOL_FLAG, collectPositionalArgs, detectApiProtocolFlag, detectBffRuntime, detectCodeSmithOverlays, detectDryRunFlag, detectExplicitTailwindFlag, detectHorizontalRemoteFlag, detectLanguage, detectPresetFlag, detectTailwindFlag, getOptionValue, readBridgeCliOptions, resolveVerticalCliInput };