@bleedingdev/modern-js-create 3.4.0-ultramodern.8 → 3.5.0-ultramodern.0

package/README.md

@@ -35,10 +35,11 @@ domains to delete. It generates:
 - `apps/shell-super-app` as the Module Federation host and topology owner.
 - `verticals/*` empty until a real domain is added with `--vertical`.
 - `packages/shared-*` placeholders for shared contracts, tokens, and Effect
-  API support.
-- `.modernjs/ultramodern-generated-contract.json` with Module Federation,
-  Effect, i18n, federated CSS, Cloudflare, route publicness, generated
-  public-surface, and Zephyr dependency metadata.
+API support.
+- `.modernjs/ultramodern.json` as compact generator provenance, package-source
+  config, app topology, bridge, deploy, Module Federation, and tooling config.
+- `topology/*` as app-owned topology, ownership, and local development overlay
+  JSON.
 
 Validate the generated workspace before making application changes:
 
@@ -80,8 +81,8 @@ such as Module Federation DTS generation, and use `@effect/tsgo` plus
 `@typescript/native-preview` as tooling for `pnpm typecheck`. Generated
 app/package source must not depend on compiler API internals. Existing compiler
 API tests in this package use the stable TypeScript 6 package. If a future AST
-utility is needed, keep it behind a dedicated compatibility module and test it
-against stable `typescript`, not native-preview internals.
+utility is needed, keep it behind a dedicated stable-TypeScript adapter and test
+it against stable `typescript`, not native-preview internals.
 
 Generated CI does not call the local aggregate. It runs format, lint,
 typecheck, skills, i18n boundary validation, contract validation, and build as
@@ -136,7 +137,7 @@ const vertical = addUltramodernVertical({
 
 Workspace generation returns `operation`, `workspaceRoot`, `packageScope`,
 `packageSource`, `createdApps`, `createdPaths`, `rewrittenPaths`,
-`assignedPorts`, `moduleFederationNames`, `effectApiPrefixes`,
+`assignedPorts`, `moduleFederationNames`, `apiPrefixes`,
 `generatedContractPath`, and `warnings`. MicroVertical addition returns the
 same shape for the new vertical and all rewritten integration surfaces.
 
@@ -150,7 +151,7 @@ pnpm dlx @bleedingdev/modern-js-create --vertical-name new-vertical --dry-run
 ```
 
 The dry-run object adds `dryRun: true`, `selectedPort`,
-`moduleFederationRemote`, `effectApiPrefix`, `jsonMutations`,
+`moduleFederationRemote`, `apiPrefix`, `jsonMutations`,
 `shellDependencyChanges`, and `generatedContractChanges`. It still validates
 the workspace before returning a plan.
 
@@ -161,11 +162,11 @@ contract so automation can stop safely:
 | --- | --- | --- |
 | Fresh input | Invalid or missing vertical name | Use `<name> --vertical`, `--vertical=<name>`, or `--vertical-name <name>` |
 | Existing topology | Duplicate app ID, package suffix, path, Module Federation name, port, API prefix, or manifest key | Choose a new vertical name or repair the existing topology/local overlay first |
-| Workspace files | Missing or non-object topology, ownership, package-source, local overlay, or generated contract JSON | Restore the generated contract file from source control or rerun from a valid workspace |
+| Workspace files | Missing or non-object compact UltraModern config, topology, ownership, or local overlay JSON | Restore the generated config files from source control or rerun from a valid workspace |
 | Tailwind prefix | Existing app already owns the generated CSS prefix | Rename the vertical before generation |
 | Output path | A generated path already exists | Treat it as an existing vertical and do not overwrite it |
 
-Package source is explicit and recorded in `.modernjs/ultramodern-package-source.json`.
+Package source is explicit and recorded in `.modernjs/ultramodern.json`.
 
 | Strategy | Use when | CLI |
 | --- | --- | --- |
@@ -177,7 +178,7 @@ Package source is explicit and recorded in `.modernjs/ultramodern-package-source
 Older generated repos should move by adopting one published BleedingDev cohort
 at a time. Start with a dry-run vertical addition so validation reports
 topology, ownership, package-source, overlay, Tailwind prefix, Module Federation,
-and generated-contract conflicts before files are written:
+and compact UltraModern config conflicts before files are written:
 
 ```bash
 pnpm dlx @bleedingdev/modern-js-create@latest catalog --vertical --dry-run
@@ -192,9 +193,9 @@ Use `--ultramodern-package-source=install` for published cohort proof and pin a
 specific release with `--ultramodern-package-version` when CI must prove an
 exact framework version. Keep `--workspace` only for local monorepo testing
 against unpublished packages. After install, run the generated
-`scripts/validate-ultramodern-workspace.mjs` contract check and fix ownership
-conflicts in the owning JSON/config files instead of editing generated package
-metadata by hand.
+`scripts/validate-ultramodern-workspace.mts` contract check and fix ownership
+conflicts in the owning JSON/config files instead of editing generated metadata
+by hand.
 
 ## CodeSmith Adapter And Overlays
 
@@ -257,8 +258,8 @@ addUltramodernVertical({
 
 Overlay config receives `workspaceRoot`, `packageScope`, `operation`,
 `generatedApp`, `generatedApps`, `assignedPort`, `assignedPorts`,
-`moduleFederationName`, `moduleFederationNames`, `effectApiPrefix`,
-`effectApiPrefixes`, `packageSource`, and `generationResult`. Overlays extend
+`moduleFederationName`, `moduleFederationNames`, `apiPrefix`,
+`apiPrefixes`, `packageSource`, and `generationResult`. Overlays extend
 the generated output after base generation; they do not replace, inherit, or
 shadow the base templates. Overlay failures stop the command with an
 `UltraModern CodeSmith overlay failed` error and do not report base generation
@@ -268,7 +269,7 @@ as fully successful.
 
 Use the workspace add flow from the UltraModern workspace root. It derives the
 package path, package name, port, Module Federation name, topology entry, local
-overlay, ownership entry, Effect BFF surface, and root `dev:*` script from the
+overlay, ownership entry, strict Effect HttpApi surface, and root `dev:*` script from the
 requested vertical name.
 
 ```bash
@@ -298,7 +299,7 @@ exported by the vertical packages.
 
 Route metadata is route-owned and colocated in
 `src/routes/**/route.meta.ts`. The scaffold regenerates
-`src/routes/ultramodern-route-metadata.ts` as a compatibility manifest for
+`src/routes/ultramodern-route-metadata.ts` as a generated route manifest for
 Modern.js config, i18n, public head, and public surface contracts; authors
 should not hand-maintain it. Locale JSON is served from
 `/locales/{{lng}}/{{ns}}.json`; Czech and English routes are generated from the
@@ -322,7 +323,7 @@ Dynamic public routes can expand sitemap entries through route-owned,
 Node-safe ESM providers, normally `route.sitemap.mjs` beside the route
 metadata. The public-surface generator discovers those providers for dynamic
 public routes and still honors explicit `routes.publicSurface.contentSources`
-entries in the generated compatibility manifest. Providers may export
+entries in the generated route manifest. Providers may export
 `entries`, `entries()`, or a default entries/loader returning sitemap entries;
 draft entries and `indexable: false` entries are omitted.
 
@@ -348,7 +349,7 @@ updating workspaces.
 | --- | --- | --- |
 | `MODERN_PUBLIC_SITE_URL` | Canonical site origin for public SEO output only | Canonical, hreflang, sitemap `<loc>`, robots `Sitemap:` |
 | `MODERN_ASSET_PREFIX` | Preferred JS/CSS/static asset prefix | Modern/Rspack-emitted asset URLs |
-| `ULTRAMODERN_ASSET_PREFIX` | UltraModern compatibility asset prefix | Modern/Rspack-emitted asset URLs when `MODERN_ASSET_PREFIX` is unset |
+| `ULTRAMODERN_ASSET_PREFIX` | UltraModern asset prefix fallback | Modern/Rspack-emitted asset URLs when `MODERN_ASSET_PREFIX` is unset |
 | `ULTRAMODERN_PUBLIC_URL_<APP_ID>` | Per-app deployment/proof URL | Cloudflare proof inputs and Module Federation remote URLs |
 
 Asset URLs use this precedence: `MODERN_ASSET_PREFIX` →
@@ -371,12 +372,13 @@ Each generated workspace app has:
 
 - `cloudflare:build`, `cloudflare:deploy`, `cloudflare:preview`, and
   `cloudflare:proof` scripts.
-- Cloudflare metadata in `.modernjs/ultramodern-generated-contract.json`.
+- Cloudflare Worker deploy config from Modern config plus
+  `.modernjs/ultramodern.json`.
 - `zephyr:dependencies` for any consumed verticals.
 - `zephyr-rspack-plugin` wired through the generated Modern.js Rspack bridge.
 
 Deploy first, then pass each deployed app's generated public URL env key into
-the proof step. The proof script reads the generated contract and checks the
+the proof step. The proof script reads the compact UltraModern config and checks the
 Cloudflare Worker surface, including public-route sitemap/robots consistency,
 preview noindex behavior, unknown-route status, asset headers, byte budgets,
 and public sourcemap exposure. Shell-only workspaces only need the shell URL;
@@ -401,7 +403,7 @@ proven.
 | Package cohort mismatch | Regenerate with one package source strategy, run `mise install`, then rerun `pnpm install` from the activated shell. | Generated workspace package source metadata |
 | Install failure | Check the active Node/pnpm from `mise install`; rerun `pnpm install` after the shell sees the pinned versions. | Toolchain setup |
 | Build failure | Run the matching primitive gate (`pnpm lint`, `pnpm typecheck`, `pnpm i18n:boundaries`, `pnpm contract:check`) before `pnpm build`; fix the owning failure first. | Owning package or generated contract |
-| Missing public URL | Set the env key from `.modernjs/ultramodern-generated-contract.json`, for example `ULTRAMODERN_PUBLIC_URL_SHELL_SUPER_APP`. | Deployment operator |
+| Missing public URL | Set the app public URL env key recorded in `.modernjs/ultramodern.json`, for example `ULTRAMODERN_PUBLIC_URL_SHELL_SUPER_APP`. | Deployment operator |
 | Cloudflare credentials | Confirm Wrangler credentials before `pnpm cloudflare:deploy`; local checks do not prove live Worker access. | Deployment operator |
 | Asset or CSS 404 | Rebuild with `pnpm build` or `pnpm cloudflare:deploy` and inspect emitted Modern/Rspack asset paths instead of hardcoding CSS URLs. | Framework/runtime asset pipeline |
 | Federation manifest failure | Run the shell and vertical build scripts, then check each deployed `/mf-manifest.json` URL used by the shell. | Module Federation owner |

package/dist/cjs/index.cjs

@@ -39,7 +39,9 @@ const external_node_url_namespaceObject = require("node:url");
 const external_create_package_root_cjs_namespaceObject = require("./create-package-root.cjs");
 const index_cjs_namespaceObject = require("./locale/index.cjs");
 const external_ultramodern_package_source_cjs_namespaceObject = require("./ultramodern-package-source.cjs");
+const commands_cjs_namespaceObject = require("./ultramodern-tooling/commands.cjs");
 const external_ultramodern_workspace_index_cjs_namespaceObject = require("./ultramodern-workspace/index.cjs");
+const bridge_config_cjs_namespaceObject = require("./ultramodern-workspace/bridge-config.cjs");
 const src_dirname = external_node_path_default().dirname((0, external_node_url_namespaceObject.fileURLToPath)(__rslib_import_meta_url__));
 const createPackageRoot = (0, external_create_package_root_cjs_namespaceObject.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.-]+)?$/;
@@ -117,6 +119,16 @@ function showHelp() {
     console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionUltramodernPackageRegistry));
     console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionUltramodernPackageScope));
     console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionUltramodernPackageNamePrefix));
+    console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionBridge));
+    console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionBridgeParentRoot));
+    console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionBridgeWorkspacePackage));
+    console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionBridgeWorkspacePackageName));
+    console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionBridgeTestAlias));
+    console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionBridgeDependency));
+    console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionBridgeLockfilePolicy));
+    console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionBridgeGate));
+    console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionBridgeGateCwd));
+    console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionBridgeReactSingleton));
     console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionVertical));
     console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionVerticalName));
     console.log(index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.help.optionDryRun));
@@ -205,7 +217,7 @@ function detectBffRuntime(args) {
         process.exit(1);
     }
     if (!SUPPORTED_BFF_RUNTIMES.includes(runtime)) {
-        console.error(`Unsupported BFF runtime "${runtime}". UltraModern workspaces scaffold an Effect BFF for every MicroVertical (supported: ${SUPPORTED_BFF_RUNTIMES.join(', ')}).`);
+        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;
@@ -230,7 +242,8 @@ function collectPositionalArgs(args) {
         '--ultramodern-package-scope',
         '--ultramodern-package-name-prefix',
         VERTICAL_NAME_FLAG,
-        CODESMITH_OVERLAY_FLAG
+        CODESMITH_OVERLAY_FLAG,
+        ...bridge_config_cjs_namespaceObject.ultramodernBridgeCliValueFlags
     ]);
     const optionWithoutValue = new Set([
         '--help',
@@ -243,7 +256,8 @@ function collectPositionalArgs(args) {
         WORKSPACE_PROTOCOL_FLAG,
         DRY_RUN_FLAG,
         VERTICAL_FLAG,
-        LEGACY_MODERN_JS_FLAG
+        LEGACY_MODERN_JS_FLAG,
+        ...bridge_config_cjs_namespaceObject.ultramodernBridgeCliBooleanFlags
     ]);
     const positionalArgs = [];
     for(let i = 0; i < args.length; i++){
@@ -253,7 +267,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}=`) || bridge_config_cjs_namespaceObject.ultramodernBridgeCliBooleanFlags.some((flag)=>arg.startsWith(`${flag}=`)) || bridge_config_cjs_namespaceObject.ultramodernBridgeCliValueFlags.some((flag)=>arg.startsWith(`${flag}=`)))) positionalArgs.push(arg);
         }
     }
     return positionalArgs;
@@ -369,6 +383,14 @@ function detectCodeSmithOverlays(args) {
     }
     return overlays.length > 0 ? overlays : void 0;
 }
+function readBridgeCliOptions(args) {
+    try {
+        return (0, bridge_config_cjs_namespaceObject.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, [
@@ -578,6 +600,10 @@ async function getProjectName() {
 }
 async function main() {
     const args = process.argv.slice(2);
+    if ('ultramodern' === args[0]) {
+        process.exitCode = await (0, commands_cjs_namespaceObject.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)) {
@@ -589,10 +615,16 @@ async function main() {
     const dryRun = detectDryRunFlag(args);
     const verticalInput = resolveVerticalCliInput(args);
     const overlays = detectCodeSmithOverlays(args);
+    const bridgeRequested = (0, bridge_config_cjs_namespaceObject.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${index_cjs_namespaceObject.i18n.t(index_cjs_namespaceObject.localeKeys.message.welcome)}\n`);
     const createPackage = readCreatePackageJson();
     const version = createPackage.version || 'latest';
@@ -633,6 +665,7 @@ async function main() {
         packageName: generatedPackageName,
         modernVersion: version,
         enableTailwind: detectTailwindFlag(),
+        bridge,
         overlays,
         packageSource
     });

package/dist/cjs/locale/en.cjs

@@ -47,7 +47,7 @@ const EN_LOCALE = {
         step1: 'cd {projectName}',
         step2: 'pnpm install',
         step3: 'pnpm dev',
-        legacyModernJsWarning: "!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\nBRUTAL WARNING: YOU ARE OPTING OUT OF ULTRAMODERN.JS DEFAULTS.\nThe unattended default is the best UltraModern.js configuration:\na structured SuperApp workspace, presetUltramodern, TanStack Router,\nEffect BFF, Tailwind CSS v4, and the BleedingDev package cohort.\nThe original Modern.js setup is a dangerous opt-in path.\n!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
+        legacyModernJsWarning: "!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\nBRUTAL WARNING: YOU ARE OPTING OUT OF ULTRAMODERN.JS DEFAULTS.\nThe unattended default is the best UltraModern.js configuration:\na structured SuperApp workspace, presetUltramodern, TanStack Router,\na strict Effect API runtime, Tailwind CSS v4, and the BleedingDev package cohort.\nThe original Modern.js setup is a dangerous opt-in path.\n!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
     },
     help: {
         title: '🚀 UltraModern.js Project Creator',
@@ -59,7 +59,7 @@ const EN_LOCALE = {
         optionVersion: '  -v, --version  Display version information',
         optionLang: '  -l, --lang     Set the language (en default; zh opt-in)',
         optionTailwind: '      --no-tailwind Disable default Tailwind CSS v4 workspace styling',
-        optionBff: '      --bff Keep the default Effect BFF scaffolding (every MicroVertical ships an Effect BFF)',
+        optionBff: '      --bff Keep the default strict Effect API runtime (every MicroVertical ships one)',
         optionBffRuntime: '      --bff-runtime Select the BFF runtime for scaffolded MicroVerticals (supported: effect; default: effect)',
         optionWorkspace: '      --workspace Use workspace protocol for @modern-js dependencies (for local monorepo testing)',
         optionUltramodernPackageSource: '      --ultramodern-package-source Select UltraModern package source (workspace or install; BleedingDev defaults to install aliases)',
@@ -67,6 +67,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/cjs/locale/zh.cjs

@@ -47,7 +47,7 @@ const ZH_LOCALE = {
         step1: 'cd {projectName}',
         step2: 'pnpm install',
         step3: 'pnpm dev',
-        legacyModernJsWarning: "!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n严重警告：你正在退出 ULTRAMODERN.JS 默认配置。\n免交互默认值是最佳 UltraModern.js 配置：\n结构化 SuperApp 工作区、presetUltramodern、TanStack Router、\nEffect BFF、Tailwind CSS v4，以及 BleedingDev 包版本队列。\n原始 Modern.js 初始化是危险的显式选择路径。\n!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
+        legacyModernJsWarning: "!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n严重警告：你正在退出 ULTRAMODERN.JS 默认配置。\n免交互默认值是最佳 UltraModern.js 配置：\n结构化 SuperApp 工作区、presetUltramodern、TanStack Router、\n严格 Effect API 运行时、Tailwind CSS v4，以及 BleedingDev 包版本队列。\n原始 Modern.js 初始化是危险的显式选择路径。\n!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
     },
     help: {
         title: '🚀 UltraModern.js 项目创建工具',
@@ -59,7 +59,7 @@ const ZH_LOCALE = {
         optionVersion: '  -v, --version  显示版本信息',
         optionLang: '  -l, --lang     设置语言 (默认 en；zh 需显式选择)',
         optionTailwind: '      --no-tailwind 禁用默认 Tailwind CSS v4 工作区样式',
-        optionBff: '      --bff 保留默认的 Effect BFF 脚手架（每个 MicroVertical 自带 Effect BFF）',
+        optionBff: '      --bff 保留默认的严格 Effect API 运行时（每个 MicroVertical 自带一个）',
         optionBffRuntime: '      --bff-runtime 选择 MicroVertical 脚手架的 BFF 运行时（支持: effect；默认: effect）',
         optionWorkspace: '      --workspace 对 @modern-js 依赖使用 workspace 协议（用于本地 monorepo 联调）',
         optionUltramodernPackageSource: '      --ultramodern-package-source 选择 UltraModern 依赖来源（workspace 或 install；BleedingDev 默认使用 install alias）',
@@ -67,6 +67,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/cjs/ultramodern-tooling/commands.cjs

@@ -0,0 +1,185 @@
+"use strict";
+const __rslib_import_meta_url__ = /*#__PURE__*/ function() {
+    return "u" < typeof document ? new (require('url'.replace('', ''))).URL('file:' + __filename).href : document.currentScript && document.currentScript.src || new URL('main.js', document.baseURI).href;
+}();
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.n = (module)=>{
+        var getter = module && module.__esModule ? ()=>module['default'] : ()=>module;
+        __webpack_require__.d(getter, {
+            a: getter
+        });
+        return getter;
+    };
+})();
+(()=>{
+    __webpack_require__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    runUltramodernToolingCli: ()=>runUltramodernToolingCli
+});
+const external_node_child_process_namespaceObject = require("node:child_process");
+const external_node_fs_namespaceObject = require("node:fs");
+var external_node_fs_default = /*#__PURE__*/ __webpack_require__.n(external_node_fs_namespaceObject);
+const external_node_os_namespaceObject = require("node:os");
+var external_node_os_default = /*#__PURE__*/ __webpack_require__.n(external_node_os_namespaceObject);
+const external_node_path_namespaceObject = require("node:path");
+var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_namespaceObject);
+const external_node_url_namespaceObject = require("node:url");
+const external_create_package_root_cjs_namespaceObject = require("../create-package-root.cjs");
+const mf_validation_cjs_namespaceObject = require("../ultramodern-workspace/mf-validation.cjs");
+const workspace_scripts_cjs_namespaceObject = require("../ultramodern-workspace/workspace-scripts.cjs");
+const external_config_cjs_namespaceObject = require("./config.cjs");
+const commands_dirname = external_node_path_default().dirname((0, external_node_url_namespaceObject.fileURLToPath)(__rslib_import_meta_url__));
+const createPackageRoot = (0, external_create_package_root_cjs_namespaceObject.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 = external_node_path_default().join(createPackageRoot, relativeScriptPath);
+    const result = (0, external_node_child_process_namespaceObject.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 = external_node_fs_default().mkdtempSync(external_node_path_default().join(external_node_os_default().tmpdir(), 'ultramodern-tool-'));
+    const tempFile = external_node_path_default().join(tempDir, 'command.mjs');
+    try {
+        external_node_fs_default().writeFileSync(tempFile, source, 'utf-8');
+        const result = (0, external_node_child_process_namespaceObject.spawnSync)(process.execPath, [
+            tempFile
+        ], {
+            cwd: context.workspaceRoot,
+            stdio: 'inherit'
+        });
+        if (result.error) throw result.error;
+        return result.status ?? 1;
+    } finally{
+        external_node_fs_default().rmSync(tempDir, {
+            force: true,
+            recursive: true
+        });
+    }
+}
+function runValidate(context) {
+    const config = (0, external_config_cjs_namespaceObject.readUltramodernConfig)(context.workspaceRoot);
+    const apps = (0, external_config_cjs_namespaceObject.workspaceAppsFromToolingConfig)(config);
+    const remotes = apps.filter((app)=>'shell' !== app.kind);
+    const source = (0, workspace_scripts_cjs_namespaceObject.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;
+    }
+    (0, mf_validation_cjs_namespaceObject.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: external_node_path_default().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;
+    }
+}
+exports.runUltramodernToolingCli = __webpack_exports__.runUltramodernToolingCli;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "runUltramodernToolingCli"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});