@bleedingdev/modern-js-create 3.4.0-ultramodern.19 → 3.4.0-ultramodern.20

package/dist/cjs/index.cjs

@@ -217,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;

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)',

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）',

package/dist/cjs/ultramodern-tooling/config.cjs

@@ -47,8 +47,6 @@ var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_no
 const bridge_config_cjs_namespaceObject = require("../ultramodern-workspace/bridge-config.cjs");
 const descriptors_cjs_namespaceObject = require("../ultramodern-workspace/descriptors.cjs");
 const naming_cjs_namespaceObject = require("../ultramodern-workspace/naming.cjs");
-const PACKAGE_SOURCE_METADATA_PATH = '.modernjs/ultramodern-package-source.json';
-const DEVELOPMENT_OVERLAY_PATH = 'topology/local-overlays/development.json';
 function readJsonObject(filePath) {
     const value = JSON.parse(external_node_fs_default().readFileSync(filePath, 'utf-8'));
     if (null === value || 'object' != typeof value || Array.isArray(value)) throw new Error(`UltraModern config must contain a JSON object: ${filePath}`);
@@ -57,45 +55,18 @@ function readJsonObject(filePath) {
 function readOptionalJsonObject(filePath) {
     return external_node_fs_default().existsSync(filePath) ? readJsonObject(filePath) : {};
 }
-function packageScopeFromRoot(workspaceRoot) {
-    const rootPackage = readOptionalJsonObject(external_node_path_default().join(workspaceRoot, 'package.json'));
-    return 'string' == typeof rootPackage.name && rootPackage.name.length > 0 ? rootPackage.name : external_node_path_default().basename(workspaceRoot);
+function packageScopeFromRoot(workspaceRoot1) {
+    const rootPackage = readOptionalJsonObject(external_node_path_default().join(workspaceRoot1, 'package.json'));
+    return 'string' == typeof rootPackage.name && rootPackage.name.length > 0 ? rootPackage.name : external_node_path_default().basename(workspaceRoot1);
 }
-function packageSourceFromMetadata(workspaceRoot) {
-    const metadataPath = external_node_path_default().join(workspaceRoot, PACKAGE_SOURCE_METADATA_PATH);
-    if (!external_node_fs_default().existsSync(metadataPath)) return;
-    const metadata = readJsonObject(metadataPath);
-    const aliases = metadata.modernPackages?.aliases ?? {};
-    const firstAlias = Object.values(aliases).find((value)=>'string' == typeof value);
-    const firstPackage = Object.keys(aliases)[0];
-    const aliasScope = firstAlias?.match(/^@([^/]+)\//)?.[1];
-    const unscopedName = firstPackage?.split('/').at(-1) ?? '';
-    const aliasUnscopedName = firstAlias?.split('/').at(-1) ?? '';
-    const aliasPackageNamePrefix = aliasUnscopedName && unscopedName && aliasUnscopedName.endsWith(unscopedName) ? aliasUnscopedName.slice(0, -unscopedName.length) : void 0;
-    return {
-        strategy: 'install' === metadata.strategy ? 'install' : 'workspace',
-        modernPackageVersion: 'string' == typeof metadata.modernPackages?.specifier ? metadata.modernPackages.specifier : 'workspace:*',
-        registry: 'string' == typeof metadata.modernPackages?.registry ? metadata.modernPackages.registry : void 0,
-        aliasScope,
-        aliasPackageNamePrefix
-    };
-}
-function readOverlayPorts(workspaceRoot) {
-    const overlayPath = external_node_path_default().join(workspaceRoot, DEVELOPMENT_OVERLAY_PATH);
-    if (!external_node_fs_default().existsSync(overlayPath)) return {};
-    const overlay = readJsonObject(overlayPath);
-    const ports = overlay.ports;
-    if (null === ports || 'object' != typeof ports || Array.isArray(ports)) return {};
-    return Object.fromEntries(Object.entries(ports).filter((entry)=>'number' == typeof entry[1]));
-}
-function normalizeCompactConfig(workspaceRoot, sourcePath, config) {
+function normalizeCompactConfig(sourcePath, config) {
     const packageSource = config.packageSource && 'object' == typeof config.packageSource ? {
         strategy: 'install' === config.packageSource.strategy ? 'install' : 'workspace',
         modernPackageVersion: 'string' == typeof config.packageSource.modernPackageVersion ? config.packageSource.modernPackageVersion : 'workspace:*',
         registry: 'string' == typeof config.packageSource.registry ? config.packageSource.registry : void 0,
         aliasScope: 'string' == typeof config.packageSource.aliasScope ? config.packageSource.aliasScope : void 0,
         aliasPackageNamePrefix: 'string' == typeof config.packageSource.aliasPackageNamePrefix ? config.packageSource.aliasPackageNamePrefix : void 0
-    } : packageSourceFromMetadata(workspaceRoot);
+    } : void 0;
     return {
         schemaVersion: 'number' == typeof config.schemaVersion ? config.schemaVersion : 1,
         profile: 'string' == typeof config.profile ? config.profile : void 0,
@@ -141,63 +112,10 @@ function normalizeCompactConfig(workspaceRoot, sourcePath, config) {
         }
     };
 }
-function adaptLegacyContract(workspaceRoot, sourcePath, contract) {
-    const ports = readOverlayPorts(workspaceRoot);
-    const apps = Array.isArray(contract.apps) ? contract.apps : [];
-    const shell = apps.find((app)=>app?.id === descriptors_cjs_namespaceObject.shellApp.id);
-    return {
-        schemaVersion: 'number' == typeof contract.schemaVersion ? contract.schemaVersion : 1,
-        profile: 'string' == typeof contract.profile ? contract.profile : void 0,
-        source: 'legacy',
-        sourcePath,
-        workspace: {
-            packageScope: packageScopeFromRoot(workspaceRoot)
-        },
-        packageSource: packageSourceFromMetadata(workspaceRoot),
-        features: {
-            tailwind: shell?.styling?.tailwind !== false
-        },
-        topology: {
-            apps: apps.map((app)=>{
-                const id = String(app.id);
-                const appPath = 'string' == typeof app.path ? app.path : id === descriptors_cjs_namespaceObject.shellApp.id ? descriptors_cjs_namespaceObject.shellApp.directory : `verticals/${(0, naming_cjs_namespaceObject.toKebabCase)(id)}`;
-                const domain = 'string' == typeof app.i18n?.namespace && 'shell' !== app.i18n.namespace ? app.i18n.namespace : appPath.split('/').at(-1);
-                return {
-                    id,
-                    kind: 'vertical' === app.kind ? 'vertical' : 'shell',
-                    path: appPath,
-                    package: 'string' == typeof app.package ? app.package : void 0,
-                    packageSuffix: 'string' == typeof app.package ? app.package.split('/').at(-1) : appPath.split('/').at(-1),
-                    displayName: id === descriptors_cjs_namespaceObject.shellApp.id ? descriptors_cjs_namespaceObject.shellApp.displayName : void 0,
-                    domain,
-                    port: ports[id],
-                    moduleFederation: app.moduleFederation && 'object' == typeof app.moduleFederation ? {
-                        role: 'vertical' === app.kind ? 'remote' : 'host',
-                        name: 'string' == typeof app.moduleFederation.name ? app.moduleFederation.name : void 0,
-                        exposes: Array.isArray(app.moduleFederation.exposes) ? app.moduleFederation.exposes.filter((expose)=>'string' == typeof expose) : void 0,
-                        verticalRefs: Array.isArray(app.moduleFederation.verticalRefs) ? app.moduleFederation.verticalRefs.filter((ref)=>'string' == typeof ref) : void 0,
-                        hostOnly: 'vertical' !== app.kind
-                    } : void 0,
-                    effectApi: app.effect && 'object' == typeof app.effect ? {
-                        stem: 'string' == typeof app.effect.prefix ? app.effect.prefix.split('/').filter(Boolean).at(-1) ?? domain ?? id : domain ?? id,
-                        prefix: 'string' == typeof app.effect.prefix ? app.effect.prefix : `/${domain ?? id}-api`,
-                        consumedBy: [
-                            descriptors_cjs_namespaceObject.shellApp.id,
-                            id
-                        ]
-                    } : void 0
-                };
-            })
-        },
-        legacyContract: contract
-    };
-}
-function readUltramodernConfig(workspaceRoot = process.cwd()) {
-    const compactPath = external_node_path_default().join(workspaceRoot, descriptors_cjs_namespaceObject.ULTRAMODERN_CONFIG_PATH);
-    if (external_node_fs_default().existsSync(compactPath)) return normalizeCompactConfig(workspaceRoot, compactPath, readJsonObject(compactPath));
-    const legacyPath = external_node_path_default().join(workspaceRoot, descriptors_cjs_namespaceObject.GENERATED_CONTRACT_PATH);
-    if (external_node_fs_default().existsSync(legacyPath)) return adaptLegacyContract(workspaceRoot, legacyPath, readJsonObject(legacyPath));
-    throw new Error(`Missing UltraModern config. Expected ${descriptors_cjs_namespaceObject.ULTRAMODERN_CONFIG_PATH} or ${descriptors_cjs_namespaceObject.GENERATED_CONTRACT_PATH}.`);
+function readUltramodernConfig(workspaceRoot1 = process.cwd()) {
+    const compactPath = external_node_path_default().join(workspaceRoot1, descriptors_cjs_namespaceObject.ULTRAMODERN_CONFIG_PATH);
+    if (external_node_fs_default().existsSync(compactPath)) return normalizeCompactConfig(compactPath, readJsonObject(compactPath));
+    throw new Error(`Missing UltraModern config. Expected ${descriptors_cjs_namespaceObject.ULTRAMODERN_CONFIG_PATH}.`);
 }
 function workspaceAppsFromToolingConfig(config) {
     return config.topology.apps.map((app)=>{

package/dist/cjs/ultramodern-workspace/add-vertical.cjs

@@ -83,7 +83,6 @@ const FIRST_VERTICAL_PORT = 4101;
 const TOPOLOGY_PATH = 'topology/reference-topology.json';
 const OWNERSHIP_PATH = 'topology/ownership.json';
 const DEVELOPMENT_OVERLAY_PATH = 'topology/local-overlays/development.json';
-const PACKAGE_SOURCE_METADATA_PATH = '.modernjs/ultramodern-package-source.json';
 function existingPackageSource(workspaceRoot, modernVersion, packageSource) {
     if (packageSource) return (0, external_package_source_cjs_namespaceObject.resolvePackageSource)({
         targetDir: workspaceRoot,
@@ -96,37 +95,12 @@ function existingPackageSource(workspaceRoot, modernVersion, packageSource) {
         const compactConfig = (0, config_cjs_namespaceObject.readUltramodernConfig)(workspaceRoot);
         if (compactConfig.packageSource) return compactConfig.packageSource;
     }
-    const metadataPath = external_node_path_default().join(workspaceRoot, PACKAGE_SOURCE_METADATA_PATH);
-    if (!external_node_fs_default().existsSync(metadataPath)) return (0, external_package_source_cjs_namespaceObject.resolvePackageSource)({
-        targetDir: workspaceRoot,
-        packageName: external_node_path_default().basename(workspaceRoot),
-        modernVersion
-    });
-    const metadata = (0, external_fs_io_cjs_namespaceObject.readJsonFile)(metadataPath);
-    const aliases = metadata.modernPackages?.aliases ?? {};
-    const firstAlias = Object.values(aliases).find((value)=>'string' == typeof value);
-    const firstPackage = Object.keys(aliases)[0];
-    const aliasScope = firstAlias?.match(/^@([^/]+)\//)?.[1];
-    const unscopedName = firstPackage?.split('/').at(-1) ?? '';
-    const aliasUnscopedName = firstAlias?.split('/').at(-1) ?? '';
-    const aliasPackageNamePrefix = aliasUnscopedName && unscopedName && aliasUnscopedName.endsWith(unscopedName) ? aliasUnscopedName.slice(0, -unscopedName.length) : void 0;
-    return {
-        strategy: 'install' === metadata.strategy ? 'install' : 'workspace',
-        modernPackageVersion: 'string' == typeof metadata.modernPackages?.specifier ? metadata.modernPackages.specifier : modernVersion,
-        registry: metadata.modernPackages?.registry,
-        aliasScope,
-        aliasPackageNamePrefix
-    };
+    throw new Error(`Missing UltraModern workspace file: ${compactPath}`);
 }
 function existingTailwindEnabled(workspaceRoot) {
     const compactPath = external_node_path_default().join(workspaceRoot, external_descriptors_cjs_namespaceObject.ULTRAMODERN_CONFIG_PATH);
     if (external_node_fs_default().existsSync(compactPath)) return (0, config_cjs_namespaceObject.readUltramodernConfig)(workspaceRoot).features.tailwind;
-    const contractPath = external_node_path_default().join(workspaceRoot, external_descriptors_cjs_namespaceObject.GENERATED_CONTRACT_PATH);
-    if (!external_node_fs_default().existsSync(contractPath)) return true;
-    const contract = (0, external_fs_io_cjs_namespaceObject.readJsonFile)(contractPath);
-    const apps = (0, external_types_cjs_namespaceObject.isRecord)(contract) && Array.isArray(contract.apps) ? contract.apps : [];
-    const shell = apps.find((app)=>(0, external_types_cjs_namespaceObject.isRecord)(app) && app.id === external_descriptors_cjs_namespaceObject.shellApp.id);
-    return shell?.styling && (0, external_types_cjs_namespaceObject.isRecord)(shell.styling) ? false !== shell.styling.tailwind : true;
+    throw new Error(`Missing UltraModern workspace file: ${compactPath}`);
 }
 function existingBridgeConfig(workspaceRoot) {
     const compactPath = external_node_path_default().join(workspaceRoot, external_descriptors_cjs_namespaceObject.ULTRAMODERN_CONFIG_PATH);
@@ -172,7 +146,7 @@ function rewriteShellAppFiles(workspaceRoot, scope, packageSource, enableTailwin
     (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(workspaceRoot, `${external_descriptors_cjs_namespaceObject.shellApp.directory}/src/routes/[lang]/page.tsx`, (0, external_demo_components_cjs_namespaceObject.createShellPage)(remotes));
     (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(workspaceRoot, `${external_descriptors_cjs_namespaceObject.shellApp.directory}/src/routes/vertical-components.tsx`, (0, external_demo_components_cjs_namespaceObject.createShellRemoteComponents)(scope, remotes));
     (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(workspaceRoot, `${external_descriptors_cjs_namespaceObject.shellApp.directory}/src/routes/shell-frame.tsx`, (0, external_app_files_cjs_namespaceObject.createShellFrameComponent)());
-    (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(workspaceRoot, `${external_descriptors_cjs_namespaceObject.shellApp.directory}/src/effect/vertical-clients.ts`, (0, external_effect_api_cjs_namespaceObject.createShellEffectClient)(scope, remotes));
+    (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(workspaceRoot, `${external_descriptors_cjs_namespaceObject.shellApp.directory}/src/api/vertical-clients.ts`, (0, external_effect_api_cjs_namespaceObject.createShellEffectClient)(scope, remotes));
 }
 function addShellZephyrDependency(workspaceRoot, scope, remote) {
     const packagePath = external_node_path_default().join(workspaceRoot, external_descriptors_cjs_namespaceObject.shellApp.directory, 'package.json');
@@ -228,10 +202,11 @@ function verticalsFromTopology(topology, ports) {
     return (topology.verticals ?? []).map((vertical)=>{
         const domain = vertical.domain ?? String(vertical.id);
         const packageSuffix = vertical.package?.split('/').at(-1) ?? domain;
-        const effectApi = vertical.api?.effect ? {
-            stem: 'string' == typeof vertical.api.effect.basePath ? vertical.api.effect.basePath.split('/').filter(Boolean).at(-1) ?? domain : domain,
-            prefix: vertical.api.effect.bff?.prefix ?? `/${domain}-api`,
-            consumedBy: Array.isArray(vertical.api.effect.consumedBy) ? vertical.api.effect.consumedBy : [
+        const apiTopology = vertical.api;
+        const effectApi = apiTopology?.runtime === 'effect' ? {
+            stem: 'string' == typeof apiTopology.basePath ? apiTopology.basePath.split('/').filter(Boolean).at(-1) ?? domain : domain,
+            prefix: apiTopology.bff?.prefix ?? `/${domain}-api`,
+            consumedBy: Array.isArray(apiTopology.consumedBy) ? apiTopology.consumedBy : [
                 external_descriptors_cjs_namespaceObject.shellApp.id,
                 vertical.id
             ]
@@ -325,9 +300,7 @@ function readRequiredJsonObject(filePath) {
 }
 function readRequiredWorkspaceConfig(workspaceRoot) {
     const compactPath = external_node_path_default().join(workspaceRoot, external_descriptors_cjs_namespaceObject.ULTRAMODERN_CONFIG_PATH);
-    if (external_node_fs_default().existsSync(compactPath)) return void readRequiredJsonObject(compactPath);
-    readRequiredJsonObject(external_node_path_default().join(workspaceRoot, external_descriptors_cjs_namespaceObject.GENERATED_CONTRACT_PATH));
-    readRequiredJsonObject(external_node_path_default().join(workspaceRoot, PACKAGE_SOURCE_METADATA_PATH));
+    readRequiredJsonObject(compactPath);
 }
 function assertOptionalJsonObject(value, label, filePath) {
     if (void 0 !== value && !(0, external_types_cjs_namespaceObject.isRecord)(value)) throw new Error(`${label} in ${filePath} must be a JSON object`);
@@ -348,8 +321,8 @@ function validateWorkspaceAppDescriptors(apps) {
         if ('number' != typeof app.port || !Number.isFinite(app.port) || app.port <= 0) throw new Error(`Invalid development port for ${appLabel}`);
         assertNonEmptyString(app.mfName, `Module Federation name for ${appLabel}`);
         if (app.effectApi) {
-            assertNonEmptyString(app.effectApi.prefix, `Effect API prefix for ${appLabel}`);
-            if (!app.effectApi.prefix.startsWith('/')) throw new Error(`Effect API prefix for ${appLabel} must start with "/"`);
+            assertNonEmptyString(app.effectApi.prefix, `API prefix for ${appLabel}`);
+            if (!app.effectApi.prefix.startsWith('/')) throw new Error(`API prefix for ${appLabel} must start with "/"`);
         }
     }
 }
@@ -359,7 +332,7 @@ function validateUniqueWorkspaceAppDescriptors(apps) {
     assertUniqueAppField(apps, 'output path', (app)=>(0, external_naming_cjs_namespaceObject.normalizePath)(app.directory));
     assertUniqueAppField(apps, 'Module Federation name', (app)=>app.mfName);
     assertUniqueAppField(apps, 'development port', (app)=>String(app.port));
-    assertUniqueAppField(apps, 'Effect API prefix', (app)=>app.effectApi?.prefix);
+    assertUniqueAppField(apps, 'API prefix', (app)=>app.effectApi?.prefix);
     assertUniqueAppField(apps, 'manifest environment name', (app)=>'vertical' === app.kind ? (0, external_descriptors_cjs_namespaceObject.createRemoteManifestEnv)(app) : void 0);
 }
 function assertUniqueAppField(apps, label, readValue) {
@@ -448,7 +421,7 @@ function createDryRunJsonMutations(preflight, manifestUrl) {
         {
             path: DEVELOPMENT_OVERLAY_PATH,
             pointer: `/apis/${vertical.id}`,
-            description: `Add local Effect API URL for ${vertical.id}`,
+            description: `Add local API URL for ${vertical.id}`,
             value: `http://localhost:${vertical.port}${(0, external_descriptors_cjs_namespaceObject.effectApiPrefix)(vertical)}`
         }
     ] : [];

package/dist/cjs/ultramodern-workspace/contracts.cjs

@@ -95,6 +95,7 @@ function createTopology(scope, remotes = []) {
             script: "scripts/validate-ultramodern-workspace.mjs",
             commands: [
                 'pnpm i18n:boundaries',
+                'pnpm api:check',
                 'pnpm contract:check'
             ]
         }
@@ -288,6 +289,7 @@ function createUltramodernConfig(scope, modernVersion, packageSource, apps = [
                 publicSurface: "scripts/generate-public-surface-assets.mjs",
                 cloudflareProof: "scripts/proof-cloudflare-version.mjs",
                 performanceReadiness: "scripts/ultramodern-performance-readiness.mjs",
+                apiBoundaries: "scripts/check-ultramodern-api-boundaries.mjs",
                 skills: "scripts/bootstrap-agent-skills.mjs"
             }
         }

package/dist/cjs/ultramodern-workspace/demo-components.cjs

@@ -248,36 +248,36 @@ ${showcaseItems}
 }
 function createRemotePage(app) {
     const tw = (0, external_naming_cjs_namespaceObject.createTw)((0, external_naming_cjs_namespaceObject.tailwindPrefixForApp)(app));
-    const listEffectItems = `list${(0, external_naming_cjs_namespaceObject.toPascalCase)((0, external_descriptors_cjs_namespaceObject.effectApiStem)(app))}`;
-    const effectBffImport = (0, external_descriptors_cjs_namespaceObject.appHasEffectApi)(app) ? `import { useModernI18n } from '@modern-js/plugin-i18n/runtime';
+    const listApiItems = `list${(0, external_naming_cjs_namespaceObject.toPascalCase)((0, external_descriptors_cjs_namespaceObject.effectApiStem)(app))}`;
+    const apiImport = (0, external_descriptors_cjs_namespaceObject.appHasEffectApi)(app) ? `import { useModernI18n } from '@modern-js/plugin-i18n/runtime';
 import { Link } from '@modern-js/plugin-tanstack/runtime';
 import { useEffect, useState } from 'react';
 import {
   Effect,
-  ${listEffectItems},
+  ${listApiItems},
   runEffectRequest,
-} from '../../effect/${(0, external_descriptors_cjs_namespaceObject.effectApiStem)(app)}-client';
+} from '../../api/${(0, external_descriptors_cjs_namespaceObject.effectApiStem)(app)}-client';
 import { UltramodernRouteHead } from '../ultramodern-route-head';
 import { ultramodernUiMarker } from '../../ultramodern-build';
 ` : "import { useModernI18n } from '@modern-js/plugin-i18n/runtime';\nimport { Link } from '@modern-js/plugin-tanstack/runtime';\nimport { UltramodernRouteHead } from '../ultramodern-route-head';\nimport { ultramodernUiMarker } from '../../ultramodern-build';\n";
-    const effectBffState = (0, external_descriptors_cjs_namespaceObject.appHasEffectApi)(app) ? `  const [effectApiStatus, setEffectApiStatus] = useState('pending');
+    const apiState = (0, external_descriptors_cjs_namespaceObject.appHasEffectApi)(app) ? `  const [apiStatus, setApiStatus] = useState('pending');
 
   useEffect(() => {
     let cancelled = false;
     void runEffectRequest(
-      ${listEffectItems}({ limit: 1 }).pipe(
+      ${listApiItems}({ limit: 1 }).pipe(
         Effect.match({
           onFailure: () => {
             if (cancelled) {
               return;
             }
-            setEffectApiStatus('unavailable');
+            setApiStatus('unavailable');
           },
           onSuccess: data => {
             if (cancelled) {
               return;
             }
-            setEffectApiStatus(data.items.at(0)?.title ?? 'empty');
+            setApiStatus(data.items.at(0)?.title ?? 'empty');
           },
         }),
       ),
@@ -289,12 +289,12 @@ import { ultramodernUiMarker } from '../../ultramodern-build';
   }, []);
 
 ` : '';
-    const effectBffMarkup = (0, external_descriptors_cjs_namespaceObject.appHasEffectApi)(app) ? `      <p data-testid="effect-bff-status">{effectApiStatus}</p>
+    const apiMarkup = (0, external_descriptors_cjs_namespaceObject.appHasEffectApi)(app) ? `      <p data-testid="api-status">{apiStatus}</p>
 ` : '';
-    return `${effectBffImport}
+    return `${apiImport}
 export default function ${(0, external_naming_cjs_namespaceObject.toPascalCase)(app.id)}Home() {
   const { language, supportedLanguages, t } = useModernI18n();
-${effectBffState}  return (
+${apiState}  return (
     <main className="${tw('min-h-screen bg-um-canvas px-4 py-6 text-um-foreground sm:px-8')}">
       <UltramodernRouteHead />
       <nav aria-label={t('${app.domain}.language.switcher')} className="${tw('flex gap-3')}">
@@ -315,7 +315,7 @@ ${effectBffState}  return (
       <p className="${tw('sr-only')}" data-build-marker={ultramodernUiMarker.build} data-testid="ultramodern-ui-marker">
         {ultramodernUiMarker.appId}:{ultramodernUiMarker.version}
       </p>
-${effectBffMarkup}    </main>
+${apiMarkup}    </main>
   );
 }
 `;

package/dist/cjs/ultramodern-workspace/descriptors.cjs

@@ -28,7 +28,6 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
-    GENERATED_CONTRACT_PATH: ()=>GENERATED_CONTRACT_PATH,
     ULTRAMODERN_CONFIG_PATH: ()=>ULTRAMODERN_CONFIG_PATH,
     appHasEffectApi: ()=>appHasEffectApi,
     appI18nNamespace: ()=>appI18nNamespace,
@@ -49,7 +48,6 @@ __webpack_require__.d(__webpack_exports__, {
     zephyrRemoteDependency: ()=>zephyrRemoteDependency
 });
 const external_naming_cjs_namespaceObject = require("./naming.cjs");
-const GENERATED_CONTRACT_PATH = '.modernjs/ultramodern-generated-contract.json';
 const ULTRAMODERN_CONFIG_PATH = '.modernjs/ultramodern.json';
 const shellApp = {
     id: 'shell-super-app',
@@ -181,7 +179,6 @@ function createCloudflarePublicUrlEnv(app) {
 function appI18nNamespace(app) {
     return 'shell' === app.kind ? 'shell' : app.domain ?? app.id;
 }
-exports.GENERATED_CONTRACT_PATH = __webpack_exports__.GENERATED_CONTRACT_PATH;
 exports.ULTRAMODERN_CONFIG_PATH = __webpack_exports__.ULTRAMODERN_CONFIG_PATH;
 exports.appHasEffectApi = __webpack_exports__.appHasEffectApi;
 exports.appI18nNamespace = __webpack_exports__.appI18nNamespace;
@@ -201,7 +198,6 @@ exports.shellApp = __webpack_exports__.shellApp;
 exports.verticalEffectApps = __webpack_exports__.verticalEffectApps;
 exports.zephyrRemoteDependency = __webpack_exports__.zephyrRemoteDependency;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
-    "GENERATED_CONTRACT_PATH",
     "ULTRAMODERN_CONFIG_PATH",
     "appHasEffectApi",
     "appI18nNamespace",