@bleedingdev/modern-js-create 3.4.0-ultramodern.12 → 3.4.0-ultramodern.13

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

@@ -80,7 +80,7 @@ const effectDiagnostics = [
     'unnecessaryPipe',
     'unnecessaryPipeChain'
 ];
-function appDependencies(scope, packageSource, app, remotes = []) {
+function appDependencies(scope, packageSource, app, remotes = [], bridge) {
     const dependencies = {
         '@modern-js/plugin-tanstack': modernPackageSpecifier('@modern-js/plugin-tanstack', packageSource),
         '@modern-js/plugin-i18n': modernPackageSpecifier('@modern-js/plugin-i18n', packageSource),
@@ -97,6 +97,7 @@ function appDependencies(scope, packageSource, app, remotes = []) {
         'react-dom': REACT_DOM_VERSION,
         'react-router': REACT_ROUTER_VERSION
     };
+    for (const dependency of bridge?.dependencies ?? [])dependencies[dependency] = WORKSPACE_PACKAGE_VERSION;
     if ('shell' === app.kind) {
         dependencies['@modern-js/plugin-bff'] = modernPackageSpecifier('@modern-js/plugin-bff', packageSource);
         for (const remote of verticalEffectApps(remotes))dependencies[packageName(scope, remote.packageSuffix)] = WORKSPACE_PACKAGE_VERSION;
@@ -123,12 +124,28 @@ function appDevDependencies(packageSource, enableTailwind) {
         wrangler: WRANGLER_VERSION
     };
 }
-function createRootPackageJson(scope, packageSource, remotes = []) {
+function createRootPackageJson(scope, packageSource, remotes = [], bridge) {
     const shellFilter = `--filter ${packageName(scope, shellApp.packageSuffix)}`;
     const remoteFilters = remotes.map((remote)=>`--filter ${packageName(scope, remote.packageSuffix)}`);
     const remoteBuildPrefix = remotes.length > 0 ? 'ULTRAMODERN_ZEPHYR=false pnpm -r --filter "./verticals/*" run build && ' : '';
     const remoteCloudflareBuildPrefix = remotes.length > 0 ? 'pnpm -r --filter "./verticals/*" run cloudflare:build && ' : '';
     const remoteCloudflareDeployPrefix = remotes.length > 0 ? 'pnpm -r --filter "./verticals/*" run cloudflare:deploy && ' : '';
+    const generatedPackageTypecheck = 'pnpm -r --filter "./apps/*" --filter "./verticals/*" --filter "./packages/*" run typecheck';
+    const typecheck = bridge ? generatedPackageTypecheck : "node ./scripts/ultramodern-typecheck.mjs --build tsconfig.json";
+    const bridgeScripts = bridge ? {
+        ...Object.fromEntries(bridge.gates.map((gate)=>[
+                `bridge:${gate.name}`,
+                `${gate.cwd ? `cd ${gate.cwd} && ` : ''}${gate.command}`
+            ])),
+        'bridge:check': bridge.gates.map((gate)=>`pnpm run bridge:${gate.name}`).join(' && ')
+    } : {};
+    const bridgeCheck = bridge ? ' && pnpm bridge:check' : '';
+    const workspacePackages = [
+        'apps/*',
+        'verticals/*',
+        'packages/*',
+        ...bridge?.workspacePackages.map((entry)=>entry.pattern) ?? []
+    ];
     return {
         private: true,
         name: scope,
@@ -150,7 +167,7 @@ function createRootPackageJson(scope, packageSource, remotes = []) {
             'format:check': "oxfmt --check . '!repos/**'",
             lint: 'oxlint apps verticals packages',
             'lint:fix': 'oxlint apps verticals packages --fix',
-            typecheck: "node ./scripts/ultramodern-typecheck.mjs --build tsconfig.json",
+            typecheck,
             'cloudflare:build': `${remoteCloudflareBuildPrefix}pnpm --filter "./apps/shell-super-app" run cloudflare:build && pnpm mf:types`,
             'cloudflare:deploy': `${remoteCloudflareDeployPrefix}pnpm --filter "./apps/shell-super-app" run cloudflare:deploy`,
             'cloudflare:proof': "node ./scripts/proof-cloudflare-version.mjs --out .codex/reports/cloudflare-version-proof/public-url-proof.json",
@@ -162,18 +179,15 @@ function createRootPackageJson(scope, packageSource, remotes = []) {
             'performance:readiness': "node ./scripts/ultramodern-performance-readiness.mjs",
             'contract:check': "node ./scripts/validate-ultramodern-workspace.mjs",
             'i18n:boundaries': "node ./scripts/check-ultramodern-i18n-boundaries.mjs",
+            ...bridgeScripts,
             postinstall: "oxfmt . '!repos/**' && node ./scripts/bootstrap-agent-skills.mjs --postinstall",
-            check: 'pnpm format:check && pnpm lint && pnpm typecheck && pnpm skills:check && pnpm i18n:boundaries && pnpm contract:check && pnpm performance:readiness'
+            check: `pnpm format:check && pnpm lint && pnpm typecheck && pnpm skills:check && pnpm i18n:boundaries && pnpm contract:check && pnpm performance:readiness${bridgeCheck}`
         },
         engines: {
             node: '>=26',
             pnpm: '>=11'
         },
-        workspaces: [
-            'apps/*',
-            'verticals/*',
-            'packages/*'
-        ],
+        workspaces: workspacePackages,
         modernjs: {
             preset: 'presetUltramodern',
             workspace: 'ultramodern-superapp',
@@ -181,7 +195,7 @@ function createRootPackageJson(scope, packageSource, remotes = []) {
             ownership: './topology/ownership.json',
             packageSource: {
                 strategy: packageSource.strategy,
-                config: './.modernjs/ultramodern-package-source.json'
+                config: './.modernjs/ultramodern.json#packageSource'
             }
         },
         devDependencies: {
@@ -339,7 +353,7 @@ function createRootTsConfig(apps = []) {
         ]
     };
 }
-function createAppPackage(scope, app, packageSource, enableTailwind, remotes = []) {
+function createAppPackage(scope, app, packageSource, enableTailwind, remotes = [], bridge) {
     const publicSurfaceBuildCommand = createPublicSurfaceGenerationCommand(app, 'dist');
     const publicSurfaceCloudflareBuildCommand = createPublicSurfaceGenerationCommand(app, 'dist');
     const publicSurfaceCloudflareOutputCommand = createPublicSurfaceGenerationCommand(app, 'cloudflare');
@@ -371,7 +385,7 @@ function createAppPackage(scope, app, packageSource, enableTailwind, remotes = [
             } : {}
         },
         'zephyr:dependencies': createZephyrDependencies(scope, app, remotes),
-        dependencies: appDependencies(scope, packageSource, app, remotes),
+        dependencies: appDependencies(scope, packageSource, app, remotes, bridge),
         devDependencies: appDevDependencies(packageSource, enableTailwind)
     };
     if (appHasEffectApi(app)) Object.assign(packageExports, {

package/dist/esm/ultramodern-workspace/public-api.js

@@ -1,2 +1,3 @@
 export { addUltramodernVertical, planUltramodernVertical } from "./add-vertical.js";
+export { normalizeUltramodernBridgeConfig } from "./bridge-config.js";
 export { generateUltramodernWorkspace } from "./write-workspace.js";

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

@@ -7,10 +7,73 @@ import { createCloudflareSecurityContract } from "./policy.js";
 import { publicSurfaceManagedSourceAssetPaths } from "./public-surface.js";
 import { createLocalisedUrlsMap, createRouteMetaFilePath, createRouteOwnedI18nPaths, createRoutePageFilePath } from "./routes.js";
 import { CLOUDFLARE_COMPATIBILITY_DATE, NODE_VERSION, PNPM_VERSION } from "./versions.js";
-function createAssertMfTypesScript(remotes = []) {
-    return renderFileTemplate("workspace-scripts/assert-mf-types.mjs", {
-        defaultAppDirsJson: JSON.stringify(remotes.map((remote)=>remote.directory), null, 2)
+function createToolWrapperScript(command, extraArgs = []) {
+    const commandJson = JSON.stringify(command);
+    const extraArgsJson = JSON.stringify(extraArgs);
+    return `#!/usr/bin/env node
+import { spawnSync } from 'node:child_process';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const createBin = process.env.ULTRAMODERN_CREATE_BIN;
+const forwardedArgs = process.argv.slice(2);
+const workspaceRoot =
+  process.env.ULTRAMODERN_WORKSPACE_ROOT ??
+  path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const ultramodernArgs = ['ultramodern', ${commandJson}, ...${extraArgsJson}, ...forwardedArgs];
+const result = createBin
+  ? spawnSync(process.execPath, [createBin, ...ultramodernArgs], {
+      env: { ...process.env, ULTRAMODERN_WORKSPACE_ROOT: workspaceRoot },
+      stdio: 'inherit',
+    })
+  : spawnSync('modern-js-create', ultramodernArgs, {
+      env: { ...process.env, ULTRAMODERN_WORKSPACE_ROOT: workspaceRoot },
+      shell: process.platform === 'win32',
+      stdio: 'inherit',
     });
+
+if (result.error) {
+  console.error(result.error.message);
+  process.exit(1);
+}
+
+process.exit(result.status ?? 1);
+`;
+}
+function createSkillsToolWrapperScript() {
+    return `#!/usr/bin/env node
+import { spawnSync } from 'node:child_process';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const createBin = process.env.ULTRAMODERN_CREATE_BIN;
+const forwardedArgs = process.argv.slice(2);
+const workspaceRoot =
+  process.env.ULTRAMODERN_WORKSPACE_ROOT ??
+  path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const checkOnly = forwardedArgs.includes('--check');
+const skillArgs = checkOnly
+  ? ['skills', 'check', ...forwardedArgs.filter(arg => arg !== '--check')]
+  : ['skills', 'install', ...forwardedArgs];
+const ultramodernArgs = ['ultramodern', ...skillArgs];
+const result = createBin
+  ? spawnSync(process.execPath, [createBin, ...ultramodernArgs], {
+      env: { ...process.env, ULTRAMODERN_WORKSPACE_ROOT: workspaceRoot },
+      stdio: 'inherit',
+    })
+  : spawnSync('modern-js-create', ultramodernArgs, {
+      env: { ...process.env, ULTRAMODERN_WORKSPACE_ROOT: workspaceRoot },
+      shell: process.platform === 'win32',
+      stdio: 'inherit',
+    });
+
+if (result.error) {
+  console.error(result.error.message);
+  process.exit(1);
+}
+
+process.exit(result.status ?? 1);
+`;
 }
 function createWorkspaceValidationScript(scope, enableTailwind, remotes = []) {
     const verticals = remotes.filter(appHasEffectApi).map((remote)=>({
@@ -64,33 +127,18 @@ function createWorkspaceValidationScript(scope, enableTailwind, remotes = []) {
 function createWorkspaceI18nBoundaryValidationScript() {
     return readFileTemplate("workspace-scripts/check-ultramodern-i18n-boundaries.mjs");
 }
-function createPublicSurfaceAssetsScript() {
-    return readFileTemplate("workspace-scripts/generate-public-surface-assets.mjs");
-}
-function createCloudflareProofHelperScript() {
-    return readFileTemplate("workspace-scripts/ultramodern-cloudflare-proof.mjs");
-}
-function createCloudflareVersionProofScript() {
-    return readFileTemplate("workspace-scripts/proof-cloudflare-version.mjs");
-}
 function createPerformanceReadinessConfigScript() {
     return readFileTemplate("workspace-scripts/ultramodern-performance-readiness.config.mjs");
 }
-function createPerformanceReadinessScript() {
-    return readFileTemplate("workspace-scripts/ultramodern-performance-readiness.mjs");
-}
-function createUltramodernTypecheckScript() {
-    return readFileTemplate("workspace-scripts/ultramodern-typecheck.mjs");
-}
-function writeGeneratedWorkspaceScripts(targetDir, scope, enableTailwind, remotes = []) {
-    writeFileReplacing(targetDir, "scripts/assert-mf-types.mjs", createAssertMfTypesScript(remotes));
-    writeFileReplacing(targetDir, "scripts/validate-ultramodern-workspace.mjs", createWorkspaceValidationScript(scope, enableTailwind, remotes));
+function writeGeneratedWorkspaceScripts(targetDir, _scope, _enableTailwind, _remotes = []) {
+    writeFileReplacing(targetDir, "scripts/assert-mf-types.mjs", createToolWrapperScript('mf-types'));
+    writeFileReplacing(targetDir, "scripts/validate-ultramodern-workspace.mjs", createToolWrapperScript('validate'));
     writeFileReplacing(targetDir, "scripts/check-ultramodern-i18n-boundaries.mjs", createWorkspaceI18nBoundaryValidationScript());
-    writeFileReplacing(targetDir, "scripts/generate-public-surface-assets.mjs", createPublicSurfaceAssetsScript());
-    writeFileReplacing(targetDir, "scripts/ultramodern-cloudflare-proof.mjs", createCloudflareProofHelperScript());
-    writeFileReplacing(targetDir, "scripts/proof-cloudflare-version.mjs", createCloudflareVersionProofScript());
+    writeFileReplacing(targetDir, "scripts/generate-public-surface-assets.mjs", createToolWrapperScript('public-surface'));
+    writeFileReplacing(targetDir, "scripts/proof-cloudflare-version.mjs", createToolWrapperScript('cloudflare-proof'));
     writeFileReplacing(targetDir, "scripts/ultramodern-performance-readiness.config.mjs", createPerformanceReadinessConfigScript());
-    writeFileReplacing(targetDir, "scripts/ultramodern-performance-readiness.mjs", createPerformanceReadinessScript());
-    writeFileReplacing(targetDir, "scripts/ultramodern-typecheck.mjs", createUltramodernTypecheckScript());
+    writeFileReplacing(targetDir, "scripts/ultramodern-performance-readiness.mjs", createToolWrapperScript('performance-readiness'));
+    writeFileReplacing(targetDir, "scripts/ultramodern-typecheck.mjs", createToolWrapperScript('typecheck'));
+    writeFileReplacing(targetDir, "scripts/bootstrap-agent-skills.mjs", createSkillsToolWrapperScript());
 }
-export { createAssertMfTypesScript, createCloudflareProofHelperScript, createCloudflareVersionProofScript, createPerformanceReadinessConfigScript, createPerformanceReadinessScript, createPublicSurfaceAssetsScript, createUltramodernTypecheckScript, createWorkspaceI18nBoundaryValidationScript, createWorkspaceValidationScript, writeGeneratedWorkspaceScripts };
+export { createPerformanceReadinessConfigScript, createWorkspaceI18nBoundaryValidationScript, createWorkspaceValidationScript, writeGeneratedWorkspaceScripts };

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

@@ -1,10 +1,11 @@
 import node_fs from "node:fs";
 import { createAppEnvDts, createAppRuntimeConfig, createAppStyles, createPostcssConfig, createSharedDesignTokensCss, createShellFrameComponent, createTailwindConfig } from "./app-files.js";
-import { createDevelopmentOverlay, createGeneratedContract, createOwnership, createPackageSourceMetadata, createTemplateManifest, createTopology } from "./contracts.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 { GENERATED_CONTRACT_PATH, appHasEffectApi, appI18nNamespace, createShellHost, sharedPackages, shellApp } from "./descriptors.js";
+import { ULTRAMODERN_CONFIG_PATH, appHasEffectApi, appI18nNamespace, createShellHost, sharedPackages, shellApp } from "./descriptors.js";
 import { createEffectClient, createEffectServiceEntry, createEffectSharedApi, createShellEffectClient } from "./effect-api.js";
-import { copyRootTemplate, writeFile, writeJson } from "./fs-io.js";
+import { copyRootTemplate, 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";
@@ -15,13 +16,13 @@ import { resolvePackageSource } from "./package-source.js";
 import { createPublicWebAppArtifacts } from "./public-surface.js";
 import { NODE_FETCH_VERSION, NODE_VERSION, PNPM_VERSION, TANSTACK_ROUTER_CORE_VERSION, TANSTACK_ROUTER_VERSION, TYPESCRIPT_VERSION } from "./versions.js";
 import { writeGeneratedWorkspaceScripts } from "./workspace-scripts.js";
-function writeApp(targetDir, scope, app, packageSource, enableTailwind, remotes = []) {
+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));
+    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));
@@ -80,10 +81,36 @@ function writeSharedPackages(targetDir, scope) {
 `);
     writeFile(targetDir, 'packages/shared-design-tokens/src/tokens.css', createSharedDesignTokensCss());
 }
+function createCompactRootPackageJson(scope, packageSource, remotes, bridge) {
+    const rootPackage = createRootPackageJson(scope, packageSource, remotes, bridge);
+    if (rootPackage.modernjs?.packageSource && 'object' == typeof rootPackage.modernjs.packageSource) rootPackage.modernjs.packageSource.config = `./${ULTRAMODERN_CONFIG_PATH}`;
+    return rootPackage;
+}
+function createCompactUltramodernConfig(scope, modernVersion, packageSource, apps = [
+    createShellHost()
+], enableTailwind = true, bridge) {
+    const config = createUltramodernConfig(scope, modernVersion, packageSource, apps, enableTailwind, bridge);
+    if (config.packageSource && 'object' == typeof config.packageSource && !Array.isArray(config.packageSource)) delete config.packageSource.metadata;
+    return config;
+}
+function writePnpmWorkspacePackages(targetDir, bridge) {
+    if (!bridge) return;
+    const pnpmWorkspacePath = `${targetDir}/pnpm-workspace.yaml`;
+    const pnpmWorkspace = node_fs.readFileSync(pnpmWorkspacePath, 'utf-8');
+    const packages = [
+        'apps/*',
+        'verticals/*',
+        'packages/*',
+        ...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`));
+}
 function generateUltramodernWorkspace(options) {
     const beforeFiles = createFileSnapshot(options.targetDir);
     const scope = toPackageScope(options.packageName);
     const packageSource = resolvePackageSource(options);
+    const bridge = normalizeUltramodernBridgeConfig(options.bridge);
     const enableTailwind = false !== options.enableTailwind;
     const initialVerticals = [];
     const createdApps = [
@@ -108,17 +135,16 @@ function generateUltramodernWorkspace(options) {
         typescriptVersion: TYPESCRIPT_VERSION,
         tailwindEnabled: String(enableTailwind)
     });
-    writeJson(options.targetDir, 'package.json', createRootPackageJson(scope, packageSource, initialVerticals));
+    writePnpmWorkspacePackages(options.targetDir, bridge);
+    writeJson(options.targetDir, 'package.json', createCompactRootPackageJson(scope, packageSource, initialVerticals, bridge));
     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, '.modernjs/ultramodern-workspace-template-manifest.json', createTemplateManifest(options.modernVersion, packageSource));
-    writeJson(options.targetDir, '.modernjs/ultramodern-package-source.json', createPackageSourceMetadata(scope, packageSource));
-    writeJson(options.targetDir, GENERATED_CONTRACT_PATH, createGeneratedContract(scope, createdApps, enableTailwind));
-    writeApp(options.targetDir, scope, shellApp, packageSource, enableTailwind, initialVerticals);
-    for (const remote of initialVerticals)writeApp(options.targetDir, scope, remote, packageSource, enableTailwind, 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);
     const afterFiles = createFileSnapshot(options.targetDir);
@@ -139,4 +165,4 @@ function generateUltramodernWorkspace(options) {
     });
     return result;
 }
-export { generateUltramodernWorkspace, writeApp, writeSharedPackages };
+export { createCompactUltramodernConfig, generateUltramodernWorkspace, writeApp, writeSharedPackages };

package/dist/esm-node/index.js

@@ -7,7 +7,9 @@ import { fileURLToPath } from "node:url";
 import { resolveCreatePackageRoot } from "./create-package-root.js";
 import { i18n, localeKeys } from "./locale/index.js";
 import { BLEEDINGDEV_CREATE_PACKAGE, BLEEDINGDEV_FRAMEWORK_VERSION_ENV, BLEEDINGDEV_PACKAGE_NAME_PREFIX, BLEEDINGDEV_PACKAGE_SCOPE, WORKSPACE_PACKAGE_VERSION } from "./ultramodern-package-source.js";
+import { runUltramodernToolingCli } from "./ultramodern-tooling/commands.js";
 import { addUltramodernVertical, generateUltramodernWorkspace, planUltramodernVertical } from "./ultramodern-workspace/index.js";
+import { hasUltramodernBridgeCliOptions, parseUltramodernBridgeCliOptions, ultramodernBridgeCliBooleanFlags, ultramodernBridgeCliValueFlags } from "./ultramodern-workspace/bridge-config.js";
 const src_dirname = node_path.dirname(fileURLToPath(import.meta.url));
 const createPackageRoot = resolveCreatePackageRoot(src_dirname);
 const semverPattern = /^(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/;
@@ -85,6 +87,16 @@ function showHelp() {
     console.log(i18n.t(localeKeys.help.optionUltramodernPackageRegistry));
     console.log(i18n.t(localeKeys.help.optionUltramodernPackageScope));
     console.log(i18n.t(localeKeys.help.optionUltramodernPackageNamePrefix));
+    console.log(i18n.t(localeKeys.help.optionBridge));
+    console.log(i18n.t(localeKeys.help.optionBridgeParentRoot));
+    console.log(i18n.t(localeKeys.help.optionBridgeWorkspacePackage));
+    console.log(i18n.t(localeKeys.help.optionBridgeWorkspacePackageName));
+    console.log(i18n.t(localeKeys.help.optionBridgeTestAlias));
+    console.log(i18n.t(localeKeys.help.optionBridgeDependency));
+    console.log(i18n.t(localeKeys.help.optionBridgeLockfilePolicy));
+    console.log(i18n.t(localeKeys.help.optionBridgeGate));
+    console.log(i18n.t(localeKeys.help.optionBridgeGateCwd));
+    console.log(i18n.t(localeKeys.help.optionBridgeReactSingleton));
     console.log(i18n.t(localeKeys.help.optionVertical));
     console.log(i18n.t(localeKeys.help.optionVerticalName));
     console.log(i18n.t(localeKeys.help.optionDryRun));
@@ -198,7 +210,8 @@ function collectPositionalArgs(args) {
         '--ultramodern-package-scope',
         '--ultramodern-package-name-prefix',
         VERTICAL_NAME_FLAG,
-        CODESMITH_OVERLAY_FLAG
+        CODESMITH_OVERLAY_FLAG,
+        ...ultramodernBridgeCliValueFlags
     ]);
     const optionWithoutValue = new Set([
         '--help',
@@ -211,7 +224,8 @@ function collectPositionalArgs(args) {
         WORKSPACE_PROTOCOL_FLAG,
         DRY_RUN_FLAG,
         VERTICAL_FLAG,
-        LEGACY_MODERN_JS_FLAG
+        LEGACY_MODERN_JS_FLAG,
+        ...ultramodernBridgeCliBooleanFlags
     ]);
     const positionalArgs = [];
     for(let i = 0; i < args.length; i++){
@@ -221,7 +235,7 @@ function collectPositionalArgs(args) {
                 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}=`))) positionalArgs.push(arg);
+            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}=`) || ultramodernBridgeCliBooleanFlags.some((flag)=>arg.startsWith(`${flag}=`)) || ultramodernBridgeCliValueFlags.some((flag)=>arg.startsWith(`${flag}=`)))) positionalArgs.push(arg);
         }
     }
     return positionalArgs;
@@ -337,6 +351,14 @@ function detectCodeSmithOverlays(args) {
     }
     return overlays.length > 0 ? overlays : void 0;
 }
+function readBridgeCliOptions(args) {
+    try {
+        return parseUltramodernBridgeCliOptions(args);
+    } catch (error) {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}
 function detectUltramodernPackageSource(args, defaultPackageVersion, createPackage) {
     const bleedingDevDefaults = isBleedingDevCreatePackage(createPackage);
     const strategy = getOptionValue(args, [
@@ -546,6 +568,10 @@ async function getProjectName() {
 }
 async function main() {
     const args = process.argv.slice(2);
+    if ('ultramodern' === args[0]) {
+        process.exitCode = await runUltramodernToolingCli(args.slice(1));
+        return;
+    }
     if (args.includes('--help') || args.includes('-h')) return void showHelp();
     if (args.includes('--version') || args.includes('-v')) return void showVersion();
     if (detectLegacyModernJsFlag(args)) {
@@ -557,10 +583,16 @@ async function main() {
     const dryRun = detectDryRunFlag(args);
     const verticalInput = resolveVerticalCliInput(args);
     const overlays = detectCodeSmithOverlays(args);
+    const bridgeRequested = hasUltramodernBridgeCliOptions(args);
     if (dryRun && !verticalInput.addVertical) {
         console.error(`${DRY_RUN_FLAG} is currently supported only with ${VERTICAL_FLAG}`);
         process.exit(1);
     }
+    if (verticalInput.addVertical && bridgeRequested) {
+        console.error('Bridge options are supported only when creating a new UltraModern workspace.');
+        process.exit(1);
+    }
+    const bridge = readBridgeCliOptions(args);
     if (!dryRun) console.log(`\n${i18n.t(localeKeys.message.welcome)}\n`);
     const createPackage = readCreatePackageJson();
     const version = createPackage.version || 'latest';
@@ -601,6 +633,7 @@ async function main() {
         packageName: generatedPackageName,
         modernVersion: version,
         enableTailwind: detectTailwindFlag(),
+        bridge,
         overlays,
         packageSource
     });

package/dist/esm-node/locale/en.js

@@ -39,6 +39,16 @@ const EN_LOCALE = {
         optionUltramodernPackageRegistry: '      --ultramodern-package-registry npm registry URL used for install package sources',
         optionUltramodernPackageScope: '      --ultramodern-package-scope Publish scope for npm alias installs (for example bleedingdev)',
         optionUltramodernPackageNamePrefix: '      --ultramodern-package-name-prefix Prefix for npm alias package names (default: modern-js-)',
+        optionBridge: '      --bridge Enable explicit nested parent-monorepo bridge mode for new workspaces',
+        optionBridgeParentRoot: '      --bridge-parent-root <path> Parent monorepo root for bridge mode',
+        optionBridgeWorkspacePackage: '      --bridge-workspace-package <glob> Parent workspace package glob consumed by generated apps',
+        optionBridgeWorkspacePackageName: '      --bridge-workspace-package-name <glob=package[,package]> Package names covered by a bridge workspace glob',
+        optionBridgeTestAlias: '      --bridge-test-alias <glob:alias=target> Test/source alias for a bridge workspace package glob',
+        optionBridgeDependency: '      --bridge-dependency <package[,package]> Explicit parent package dependency consumed by generated apps',
+        optionBridgeLockfilePolicy: '      --bridge-lockfile-policy <nested|parent> Bridge lockfile ownership policy (default: nested)',
+        optionBridgeGate: '      --bridge-gate <name=command> Delegated parent workspace gate command for bridge packages',
+        optionBridgeGateCwd: '      --bridge-gate-cwd <name=cwd> Working directory for a named bridge gate',
+        optionBridgeReactSingleton: '      --bridge-react-singleton <package[,package]> React singleton package expectation (default: react,react-dom)',
         optionVertical: '      --vertical[=<name>] Mutate the current existing UltraModern workspace and wire a MicroVertical',
         optionVerticalName: '      --vertical-name <name> Explicit MicroVertical name for automation-friendly workspace mutation',
         optionDryRun: '      --dry-run Preview a MicroVertical mutation plan without writing files (supported with --vertical)',

package/dist/esm-node/locale/zh.js

@@ -39,6 +39,16 @@ const ZH_LOCALE = {
         optionUltramodernPackageRegistry: '      --ultramodern-package-registry install 依赖来源使用的 npm registry 地址',
         optionUltramodernPackageScope: '      --ultramodern-package-scope npm alias 安装使用的发布 scope（例如 bleedingdev）',
         optionUltramodernPackageNamePrefix: '      --ultramodern-package-name-prefix npm alias 包名前缀（默认：modern-js-）',
+        optionBridge: '      --bridge 为新工作区启用显式的嵌套父 monorepo 桥接模式',
+        optionBridgeParentRoot: '      --bridge-parent-root <路径> 桥接模式使用的父 monorepo 根目录',
+        optionBridgeWorkspacePackage: '      --bridge-workspace-package <glob> 生成应用消费的父工作区包 glob',
+        optionBridgeWorkspacePackageName: '      --bridge-workspace-package-name <glob=包名[,包名]> 桥接工作区 glob 覆盖的包名',
+        optionBridgeTestAlias: '      --bridge-test-alias <glob:别名=目标> 桥接工作区包 glob 的测试/源码 alias',
+        optionBridgeDependency: '      --bridge-dependency <包名[,包名]> 生成应用显式消费的父包依赖',
+        optionBridgeLockfilePolicy: '      --bridge-lockfile-policy <nested|parent> 桥接 lockfile 归属策略（默认：nested）',
+        optionBridgeGate: '      --bridge-gate <名称=命令> 桥接包委托给父工作区执行的 gate 命令',
+        optionBridgeGateCwd: '      --bridge-gate-cwd <名称=目录> 指定桥接 gate 的工作目录',
+        optionBridgeReactSingleton: '      --bridge-react-singleton <包名[,包名]> React 单例包预期（默认：react,react-dom）',
         optionVertical: '      --vertical[=<名称>] 修改当前已有的 UltraModern 工作区，并接入 MicroVertical',
         optionVerticalName: '      --vertical-name <名称> 为自动化工作流显式指定 MicroVertical 名称',
         optionDryRun: '      --dry-run 预览 MicroVertical 修改计划但不写入文件（与 --vertical 一起使用）',

package/dist/esm-node/ultramodern-tooling/commands.js

@@ -0,0 +1,133 @@
+import "node:module";
+import { spawnSync } from "node:child_process";
+import node_fs from "node:fs";
+import node_os from "node:os";
+import node_path from "node:path";
+import { fileURLToPath } from "node:url";
+import { resolveCreatePackageRoot } from "../create-package-root.js";
+import { validateModuleFederationTypes } from "../ultramodern-workspace/mf-validation.js";
+import { createWorkspaceValidationScript } from "../ultramodern-workspace/workspace-scripts.js";
+import { readUltramodernConfig, workspaceAppsFromToolingConfig } from "./config.js";
+const commands_dirname = node_path.dirname(fileURLToPath(import.meta.url));
+const createPackageRoot = resolveCreatePackageRoot(commands_dirname);
+function printHelp() {
+    process.stdout.write(`Usage:
+  modern-js-create ultramodern <command> [args]
+
+Commands:
+  validate
+  typecheck
+  mf-types
+  public-surface
+  cloudflare-proof
+  performance-readiness
+  skills install
+  skills check
+`);
+}
+function spawnNodeScript(relativeScriptPath, args, context, options = {}) {
+    const scriptPath = node_path.join(createPackageRoot, relativeScriptPath);
+    const result = spawnSync(process.execPath, [
+        scriptPath,
+        ...args
+    ], {
+        cwd: options.cwd ?? context.workspaceRoot,
+        env: {
+            ...process.env,
+            ULTRAMODERN_WORKSPACE_ROOT: context.workspaceRoot
+        },
+        stdio: 'inherit'
+    });
+    if (result.error) throw result.error;
+    return result.status ?? 1;
+}
+function runRenderedModule(source, context) {
+    const tempDir = node_fs.mkdtempSync(node_path.join(node_os.tmpdir(), 'ultramodern-tool-'));
+    const tempFile = node_path.join(tempDir, 'command.mjs');
+    try {
+        node_fs.writeFileSync(tempFile, source, 'utf-8');
+        const result = spawnSync(process.execPath, [
+            tempFile
+        ], {
+            cwd: context.workspaceRoot,
+            stdio: 'inherit'
+        });
+        if (result.error) throw result.error;
+        return result.status ?? 1;
+    } finally{
+        node_fs.rmSync(tempDir, {
+            force: true,
+            recursive: true
+        });
+    }
+}
+function runValidate(context) {
+    const config = readUltramodernConfig(context.workspaceRoot);
+    const apps = workspaceAppsFromToolingConfig(config);
+    const remotes = apps.filter((app)=>'shell' !== app.kind);
+    const source = createWorkspaceValidationScript(config.workspace.packageScope, config.features.tailwind, remotes);
+    return runRenderedModule(source, context);
+}
+function runMfTypes(args, context) {
+    if (args.includes('--help') || args.includes('-h')) {
+        process.stdout.write(`Usage:
+  modern-js-create ultramodern mf-types [app-dir...]
+
+Checks real Module Federation config files and DTS archives for exposed apps.
+`);
+        return 0;
+    }
+    validateModuleFederationTypes({
+        workspaceRoot: context.workspaceRoot,
+        appDirs: args.length > 0 ? args : void 0
+    });
+    return 0;
+}
+function runSkills(args, context) {
+    const [subcommand, ...rest] = args;
+    if ('install' === subcommand) return spawnNodeScript("template-workspace/scripts/bootstrap-agent-skills.mjs", rest, context);
+    if ('check' === subcommand) return spawnNodeScript("template-workspace/scripts/bootstrap-agent-skills.mjs", [
+        '--check',
+        ...rest
+    ], context);
+    throw new Error('Usage: modern-js-create ultramodern skills <install|check>');
+}
+async function runUltramodernToolingCli(args, workspaceRoot = process.env.ULTRAMODERN_WORKSPACE_ROOT ?? process.cwd()) {
+    try {
+        const [command, ...rest] = args;
+        const context = {
+            workspaceRoot: node_path.resolve(workspaceRoot),
+            invocationCwd: process.cwd()
+        };
+        switch(command){
+            case void 0:
+            case '--help':
+            case '-h':
+                printHelp();
+                return 0;
+            case 'validate':
+                return runValidate(context);
+            case 'typecheck':
+                return spawnNodeScript("templates/workspace-scripts/ultramodern-typecheck.mjs", rest, context, {
+                    cwd: context.invocationCwd
+                });
+            case 'mf-types':
+                return runMfTypes(rest, context);
+            case 'public-surface':
+                return spawnNodeScript("templates/workspace-scripts/generate-public-surface-assets.mjs", rest, context);
+            case 'cloudflare-proof':
+                return spawnNodeScript("templates/workspace-scripts/proof-cloudflare-version.mjs", rest, context);
+            case 'performance-readiness':
+                return spawnNodeScript("templates/workspace-scripts/ultramodern-performance-readiness.mjs", rest, context);
+            case 'skills':
+                return runSkills(rest, context);
+            default:
+                throw new Error(`Unknown UltraModern command: ${command}`);
+        }
+    } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        process.stderr.write(`[ultramodern] ${message}\n`);
+        return 1;
+    }
+}
+export { runUltramodernToolingCli };