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

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

@@ -1,13 +1,13 @@
 import { appHasEffectApi, effectApiPrefix, effectApiStem, verticalEffectApps } from "./descriptors.js";
 import { packageName, toCamelCase, toPascalCase } from "./naming.js";
 function verticalEffectApiExport(service) {
-    return `${toCamelCase(effectApiStem(service))}EffectApi`;
+    return `${toCamelCase(effectApiStem(service))}Api`;
 }
 function verticalEffectGroupName(service) {
     return toCamelCase(effectApiStem(service));
 }
 function verticalEffectApiName(service) {
-    return `${toPascalCase(effectApiStem(service))}EffectApi`;
+    return `${toPascalCase(effectApiStem(service))}Api`;
 }
 function verticalEffectSchemaExport(service) {
     return `${toCamelCase(effectApiStem(service))}ItemSchema`;
@@ -89,24 +89,24 @@ function createCheckoutCartEndpointDefinitions(service) {
     if (!serviceHasCheckoutCartState(service)) return '';
     return `
     .add(
-      HttpApiEndpoint.get('getCart', '/effect/checkout/cart', {
+      HttpApiEndpoint.get('getCart', '/checkout/cart', {
         success: checkoutCartSchema,
       }),
     )
     .add(
-      HttpApiEndpoint.post('addCartItem', '/effect/checkout/cart/items', {
+      HttpApiEndpoint.post('addCartItem', '/checkout/cart/items', {
         payload: checkoutAddCartItemPayloadSchema,
         success: checkoutCartSchema,
       }),
     )
     .add(
-      HttpApiEndpoint.post('removeCartItem', '/effect/checkout/cart/remove', {
+      HttpApiEndpoint.post('removeCartItem', '/checkout/cart/remove', {
         payload: checkoutRemoveCartItemPayloadSchema,
         success: checkoutCartSchema,
       }),
     )
     .add(
-      HttpApiEndpoint.post('clearCart', '/effect/checkout/cart/clear', {
+      HttpApiEndpoint.post('clearCart', '/checkout/cart/clear', {
         success: checkoutCartSchema,
       }),
     )`;
@@ -119,31 +119,31 @@ function createCheckoutCartOperationContexts(service) {
   addCartItem: {
     method: 'POST',
     operationId: '${apiName}:${groupName}:addCartItem',
-    routePath: '/effect/checkout/cart/items',
+    routePath: '/checkout/cart/items',
     source: 'generated-client',
   },
   clearCart: {
     method: 'POST',
     operationId: '${apiName}:${groupName}:clearCart',
-    routePath: '/effect/checkout/cart/clear',
+    routePath: '/checkout/cart/clear',
     source: 'generated-client',
   },
   getCart: {
     method: 'GET',
     operationId: '${apiName}:${groupName}:getCart',
-    routePath: '/effect/checkout/cart',
+    routePath: '/checkout/cart',
     source: 'generated-client',
   },
   removeCartItem: {
     method: 'POST',
     operationId: '${apiName}:${groupName}:removeCartItem',
-    routePath: '/effect/checkout/cart/remove',
+    routePath: '/checkout/cart/remove',
     source: 'generated-client',
   },`;
 }
 function createCheckoutCartApiContractFields(service) {
     if (!serviceHasCheckoutCartState(service)) return '';
-    return `  checkoutCartPath: '${effectApiPrefix(service)}/effect/checkout/cart',
+    return `  checkoutCartPath: '${effectApiPrefix(service)}/checkout/cart',
 `;
 }
 function createCheckoutCartServerState(service) {
@@ -179,7 +179,7 @@ function createCheckoutCartServerHandlers(service) {
     return `
       .handle('getCart', () =>
         Effect.sync(() => createCheckoutCartSnapshot()).pipe(
-          Effect.withSpan('ultramodern.effect.${groupName}.checkout.getCart', {
+          Effect.withSpan('ultramodern.api.${groupName}.checkout.getCart', {
             attributes: operationAttributes(${groupName}OperationContexts.getCart),
             kind: 'server',
           }),
@@ -197,7 +197,7 @@ function createCheckoutCartServerHandlers(service) {
           });
           return createCheckoutCartSnapshot();
         }).pipe(
-          Effect.withSpan('ultramodern.effect.${groupName}.checkout.addCartItem', {
+          Effect.withSpan('ultramodern.api.${groupName}.checkout.addCartItem', {
             attributes: operationAttributes(${groupName}OperationContexts.addCartItem),
             kind: 'server',
           }),
@@ -208,7 +208,7 @@ function createCheckoutCartServerHandlers(service) {
           checkoutCartLines.delete(payload.sku);
           return createCheckoutCartSnapshot();
         }).pipe(
-          Effect.withSpan('ultramodern.effect.${groupName}.checkout.removeCartItem', {
+          Effect.withSpan('ultramodern.api.${groupName}.checkout.removeCartItem', {
             attributes: operationAttributes(${groupName}OperationContexts.removeCartItem),
             kind: 'server',
           }),
@@ -219,7 +219,7 @@ function createCheckoutCartServerHandlers(service) {
           checkoutCartLines.clear();
           return createCheckoutCartSnapshot();
         }).pipe(
-          Effect.withSpan('ultramodern.effect.${groupName}.checkout.clearCart', {
+          Effect.withSpan('ultramodern.api.${groupName}.checkout.clearCart', {
             attributes: operationAttributes(${groupName}OperationContexts.clearCart),
             kind: 'server',
           }),
@@ -356,7 +356,7 @@ export interface ${itemType} {
 
 export interface ${readinessType} {
   readonly checks: {
-    readonly effectBff: 'ready';
+    readonly api: 'ready';
     readonly moduleFederation: 'ready';
     readonly ssr: 'ready';
     readonly translations: 'ready';
@@ -400,7 +400,7 @@ export const ${schemaExport}: Schema.Codec<${itemType}> = Schema.Struct({
 
 export const ${readinessSchemaExport}: Schema.Codec<${readinessType}> = Schema.Struct({
   checks: Schema.Struct({
-    effectBff: Schema.Literal('ready'),
+    api: Schema.Literal('ready'),
     moduleFederation: Schema.Literal('ready'),
     ssr: Schema.Literal('ready'),
     translations: Schema.Literal('ready'),
@@ -437,7 +437,7 @@ export interface OperationContext {
 export const ${apiExport} = HttpApi.make('${apiName}').add(
   HttpApiGroup.make('${groupName}')
     .add(
-      HttpApiEndpoint.get('list', '/effect/${stem}', {
+      HttpApiEndpoint.get('list', '/${stem}', {
         query: {
           limit: Schema.optional(Schema.FiniteFromString),
         },
@@ -447,12 +447,12 @@ export const ${apiExport} = HttpApi.make('${apiName}').add(
       }),
     )
     .add(
-      HttpApiEndpoint.get('readiness', '/effect/${stem}/readiness', {
+      HttpApiEndpoint.get('readiness', '/${stem}/readiness', {
         success: ${readinessSchemaExport},
       }),
     )
     .add(
-      HttpApiEndpoint.get('get', '/effect/${stem}/:id', {
+      HttpApiEndpoint.get('get', '/${stem}/:id', {
         error: ${notFoundSchemaExport},
         params: {
           id: Schema.String,
@@ -461,7 +461,7 @@ export const ${apiExport} = HttpApi.make('${apiName}').add(
       }),
     )
     .add(
-      HttpApiEndpoint.post('create', '/effect/${stem}', {
+      HttpApiEndpoint.post('create', '/${stem}', {
         payload: ${createPayloadSchemaExport},
         success: Schema.Struct({
           item: ${schemaExport},
@@ -474,34 +474,34 @@ export const ${groupName}OperationContexts = {
 ${checkoutCartOperationContextEntries}  create: {
     method: 'POST',
     operationId: '${apiName}:${groupName}:create',
-    routePath: '/effect/${stem}',
+    routePath: '/${stem}',
     source: 'generated-client',
   },
   get: {
     method: 'GET',
     operationId: '${apiName}:${groupName}:get',
-    routePath: '/effect/${stem}/:id',
+    routePath: '/${stem}/:id',
     source: 'generated-client',
   },
   list: {
     method: 'GET',
     operationId: '${apiName}:${groupName}:list',
-    routePath: '/effect/${stem}',
+    routePath: '/${stem}',
     source: 'generated-client',
   },
   readiness: {
     method: 'GET',
     operationId: '${apiName}:${groupName}:readiness',
-    routePath: '/effect/${stem}/readiness',
+    routePath: '/${stem}/readiness',
     source: 'generated-client',
   },
 } satisfies Record<string, OperationContext>;
 
 export const ${groupName}ApiContract = {
   apiPrefix: '${apiPrefix}',
-  basePath: '${apiPrefix}/effect/${stem}',
+  basePath: '${apiPrefix}/${stem}',
 ${createCheckoutCartApiContractFields(service)}  ownerId: '${service.id}',
-  readinessPath: '${apiPrefix}/effect/${stem}/readiness',
+  readinessPath: '${apiPrefix}/${stem}/readiness',
 } as const;
 `;
 }
@@ -525,7 +525,7 @@ import type {
   EffectBffRuntime,
   EffectRuntimeLayer,
 } from '@modern-js/plugin-bff/effect-edge';
-import { ultramodernApiMarker } from '../../shared/ultramodern-build.ts';
+import { ultramodernApiMarker } from '../shared/ultramodern-build.ts';
 import {
   ${apiExport},
   ${groupName}OperationContexts,
@@ -566,7 +566,7 @@ const ${groupName}Layer = HttpApiBuilder.group(
               ? ${groupName}Items.slice(0, query.limit)
               : ${groupName}Items,
         }).pipe(
-          Effect.withSpan('ultramodern.effect.${groupName}.list', {
+          Effect.withSpan('ultramodern.api.${groupName}.list', {
             attributes: operationAttributes(${groupName}OperationContexts.list),
             kind: 'server',
           }),
@@ -575,7 +575,7 @@ const ${groupName}Layer = HttpApiBuilder.group(
       .handle('readiness', () =>
         Effect.succeed({
           checks: {
-            effectBff: 'ready' as const,
+            api: 'ready' as const,
             moduleFederation: 'ready' as const,
             ssr: 'ready' as const,
             translations: 'ready' as const,
@@ -584,7 +584,7 @@ const ${groupName}Layer = HttpApiBuilder.group(
           status: 'ready' as const,
           versionSkew: 'none' as const,
         }).pipe(
-          Effect.withSpan('ultramodern.effect.${groupName}.readiness', {
+          Effect.withSpan('ultramodern.api.${groupName}.readiness', {
             attributes: operationAttributes(${groupName}OperationContexts.readiness),
             kind: 'server',
           }),
@@ -604,7 +604,7 @@ const ${groupName}Layer = HttpApiBuilder.group(
             : Effect.succeed(matchedItem);
 
         return result.pipe(
-            Effect.withSpan('ultramodern.effect.${groupName}.get', {
+            Effect.withSpan('ultramodern.api.${groupName}.get', {
               attributes: operationAttributes(${groupName}OperationContexts.get),
               kind: 'server',
             }),
@@ -621,7 +621,7 @@ const ${groupName}Layer = HttpApiBuilder.group(
             title: payload.title,
           },
         }).pipe(
-          Effect.withSpan('ultramodern.effect.${groupName}.create', {
+          Effect.withSpan('ultramodern.api.${groupName}.create', {
             attributes: operationAttributes(${groupName}OperationContexts.create),
             kind: 'server',
           }),
@@ -633,13 +633,13 @@ const layer = HttpApiBuilder.layer(${apiExport}).pipe(
   Layer.provide(${groupName}Layer),
 ) satisfies EffectRuntimeLayer;
 
-const effectBff: EffectBffDefinition<typeof ${apiExport}, EffectRuntimeLayer> &
+const apiRuntime: EffectBffDefinition<typeof ${apiExport}, EffectRuntimeLayer> &
   EffectBffRuntime<typeof ${apiExport}, EffectRuntimeLayer> = defineEffectBff({
   api: ${apiExport},
   layer,
 });
 
-export default effectBff;
+export default apiRuntime;
 `;
 }
 function createEffectClient(service, contractImportPath) {
@@ -691,7 +691,7 @@ import type {
 
 export { Effect, runEffectRequest };
 
-type ${pascalStem}EffectGroups = typeof ${apiExport} extends HttpApi.HttpApi<
+type ${pascalStem}ApiGroups = typeof ${apiExport} extends HttpApi.HttpApi<
   infer _ApiId,
   infer Groups
 >
@@ -699,7 +699,7 @@ type ${pascalStem}EffectGroups = typeof ${apiExport} extends HttpApi.HttpApi<
   : never;
 
 export type ${clientTypeName} = HttpApiClient.Client<
-  Extract<${pascalStem}EffectGroups, HttpApiGroup.Any>,
+  Extract<${pascalStem}ApiGroups, HttpApiGroup.Any>,
   never,
   never
 >;
@@ -809,7 +809,7 @@ ${checkoutCartExports}  create${pascalSingular},
   get${pascalStem}Readiness,
   list${pascalStem},
   type ${pascalStem}ClientOptions,
-} from '${packageName(scope, remote.packageSuffix)}/effect/client';`;
+} from '${packageName(scope, remote.packageSuffix)}/api/client';`;
     }).join('\n\n');
     return exports ? `${exports}\n` : `export const ultramodernVerticalClients = [] as const;
 `;
@@ -817,7 +817,7 @@ ${checkoutCartExports}  create${pascalSingular},
 function createEffectReadinessContract(app) {
     const stem = effectApiStem(app);
     return {
-        endpoint: `/effect/${stem}/readiness`,
+        endpoint: `/${stem}/readiness`,
         marker: {
             ui: 'ultramodernUiMarker',
             api: 'ultramodernApiMarker',
@@ -827,7 +827,7 @@ function createEffectReadinessContract(app) {
             'moduleFederation',
             'ssr',
             'translations',
-            'effectBff'
+            'api'
         ]
     };
 }
@@ -842,39 +842,39 @@ function createEffectRequestContextContract() {
             'x-ultramodern-env',
             'x-vertical-version-id'
         ],
-        source: 'shell-to-vertical-effect-client'
+        source: 'shell-to-vertical-api-client'
     };
 }
 function createEffectDomainOperations(app) {
     const stem = effectApiStem(app);
     const group = verticalEffectGroupName(app);
-    const basePath = `/effect/${stem}`;
+    const basePath = `/${stem}`;
     const checkoutCartOperations = serviceHasCheckoutCartState(app) ? {
         checkoutCartAddItem: {
             client: 'addCheckoutCartItem',
             method: 'POST',
-            path: '/effect/checkout/cart/items',
+            path: '/checkout/cart/items',
             resource: 'checkout-cart',
             owner: app.id
         },
         checkoutCartClear: {
             client: 'clearCheckoutCart',
             method: 'POST',
-            path: '/effect/checkout/cart/clear',
+            path: '/checkout/cart/clear',
             resource: 'checkout-cart',
             owner: app.id
         },
         checkoutCartRead: {
             client: 'getCheckoutCart',
             method: 'GET',
-            path: '/effect/checkout/cart',
+            path: '/checkout/cart',
             resource: 'checkout-cart',
             owner: app.id
         },
         checkoutCartRemoveItem: {
             client: 'removeCheckoutCartItem',
             method: 'POST',
-            path: '/effect/checkout/cart/remove',
+            path: '/checkout/cart/remove',
             resource: 'checkout-cart',
             owner: app.id
         }
@@ -907,27 +907,26 @@ function createEffectDomainOperations(app) {
 function effectApiTopologyMetadata(app) {
     if (!appHasEffectApi(app)) return;
     return {
-        effect: {
-            runtime: 'effect',
-            bff: {
-                prefix: app.effectApi.prefix,
-                openapi: '/openapi.json'
-            },
-            contract: {
-                export: './shared/effect/api',
-                path: `${app.directory}/shared/effect/api.ts`
-            },
-            client: {
-                export: './effect/client',
-                path: `${app.directory}/src/effect/${app.effectApi.stem}-client.ts`
-            },
-            serverEntry: `${app.directory}/api/effect/index.ts`,
-            basePath: `${app.effectApi.prefix}/effect/${app.effectApi.stem}`,
-            consumedBy: app.effectApi.consumedBy,
-            readiness: createEffectReadinessContract(app),
-            requestContext: createEffectRequestContextContract(),
-            domainOperations: createEffectDomainOperations(app)
-        }
+        runtime: 'effect',
+        bff: {
+            prefix: app.effectApi.prefix,
+            openapi: '/openapi.json',
+            strictEffectApproach: true
+        },
+        contract: {
+            export: './api',
+            path: `${app.directory}/shared/api.ts`
+        },
+        client: {
+            export: './api/client',
+            path: `${app.directory}/src/api/${app.effectApi.stem}-client.ts`
+        },
+        serverEntry: `${app.directory}/api/index.ts`,
+        basePath: `${app.effectApi.prefix}/${app.effectApi.stem}`,
+        consumedBy: app.effectApi.consumedBy,
+        readiness: createEffectReadinessContract(app),
+        requestContext: createEffectRequestContextContract(),
+        domainOperations: createEffectDomainOperations(app)
     };
 }
 function createEffectOperationContract(target) {
@@ -935,22 +934,22 @@ function createEffectOperationContract(target) {
     const checkoutCartOperations = serviceHasCheckoutCartState(target) ? {
         addCartItem: {
             method: 'POST',
-            path: '/effect/checkout/cart/items',
+            path: '/checkout/cart/items',
             source: 'generated-client'
         },
         clearCart: {
             method: 'POST',
-            path: '/effect/checkout/cart/clear',
+            path: '/checkout/cart/clear',
             source: 'generated-client'
         },
         getCart: {
             method: 'GET',
-            path: '/effect/checkout/cart',
+            path: '/checkout/cart',
             source: 'generated-client'
         },
         removeCartItem: {
             method: 'POST',
-            path: '/effect/checkout/cart/remove',
+            path: '/checkout/cart/remove',
             source: 'generated-client'
         }
     } : {};
@@ -961,22 +960,22 @@ function createEffectOperationContract(target) {
             ...checkoutCartOperations,
             list: {
                 method: 'GET',
-                path: `/effect/${stem}`,
+                path: `/${stem}`,
                 source: 'generated-client'
             },
             readiness: {
                 method: 'GET',
-                path: `/effect/${stem}/readiness`,
+                path: `/${stem}/readiness`,
                 source: 'generated-client'
             },
             get: {
                 method: 'GET',
-                path: `/effect/${stem}/:id`,
+                path: `/${stem}/:id`,
                 source: 'generated-client'
             },
             create: {
                 method: 'POST',
-                path: `/effect/${stem}`,
+                path: `/${stem}`,
                 source: 'generated-client'
             }
         }

package/dist/esm/ultramodern-workspace/mf-validation.js

@@ -3,8 +3,7 @@ import node_path from "node:path";
 const moduleFederationConfigFile = 'module-federation.config.ts';
 const mfTypesArchive = 'dist/@mf-types.zip';
 const generatedMetadataPaths = [
-    '.modernjs/ultramodern.json',
-    '.modernjs/ultramodern-generated-contract.json'
+    '.modernjs/ultramodern.json'
 ];
 const defaultAppRootDirs = [
     'apps',

package/dist/esm/ultramodern-workspace/module-federation.js

@@ -8,10 +8,11 @@ function createAppModernConfig(scope, app) {
     const bffImport = appHasEffectApi(app) ? "import { bffPlugin } from '@modern-js/plugin-bff';\n" : '';
     const bffConfig = appHasEffectApi(app) ? `      bff: {
         effect: {
-          entry: './api/effect/index',
+          entry: './api/index',
           openapi: {
             path: '/openapi.json',
           },
+          strictEffectApproach: true,
         },
         prefix: '${effectApiPrefix(app)}',
         runtimeFramework: 'effect',
@@ -395,7 +396,7 @@ export const ultramodernUiMarker = {
 
 export const ultramodernApiMarker = {
   ...ultramodernVerticalIdentity,
-  surface: 'effect-bff',
+  surface: 'api',
 } as const;
 `;
 }

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

@@ -179,10 +179,11 @@ function createRootPackageJson(scope, packageSource, remotes = [], bridge) {
             'mf:types': "node ./scripts/assert-mf-types.mjs",
             'performance:readiness': "node ./scripts/ultramodern-performance-readiness.mjs",
             'contract:check': "node ./scripts/validate-ultramodern-workspace.mjs",
+            'api:check': "node ./scripts/check-ultramodern-api-boundaries.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${bridgeCheck}`
+            check: `pnpm format:check && pnpm lint && pnpm typecheck && pnpm skills:check && pnpm i18n:boundaries && pnpm api:check && pnpm contract:check && pnpm performance:readiness${bridgeCheck}`
         },
         engines: {
             node: '>=26',
@@ -382,7 +383,7 @@ function createAppPackage(scope, app, packageSource, enableTailwind, remotes = [
             appId: app.id,
             topology: `${relativeRootFor(app.directory)}/topology/reference-topology.json`,
             ...appHasEffectApi(app) ? {
-                apiRuntime: 'effect-bff'
+                apiRuntime: 'effect'
             } : {}
         },
         'zephyr:dependencies': createZephyrDependencies(scope, app, remotes),
@@ -390,11 +391,11 @@ function createAppPackage(scope, app, packageSource, enableTailwind, remotes = [
         devDependencies: appDevDependencies(packageSource, enableTailwind)
     };
     if (appHasEffectApi(app)) Object.assign(packageExports, {
-        './effect/client': `./src/effect/${app.effectApi.stem}-client.ts`,
-        './shared/effect/api': './shared/effect/api.ts'
+        './api': './shared/api.ts',
+        './api/client': `./src/api/${app.effectApi.stem}-client.ts`
     });
     else if ('shell' === app.kind) Object.assign(packageExports, {
-        './effect/clients': './src/effect/vertical-clients.ts'
+        './api/clients': './src/api/vertical-clients.ts'
     });
     if (Object.keys(packageExports).length > 0) packageJson.exports = packageExports;
     return packageJson;

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

@@ -16,7 +16,7 @@ function createCloudflareProofRoute(app) {
         mfManifest: '/mf-manifest.json',
         locale: `/locales/en/${appI18nNamespace(app)}.json`,
         ...appHasEffectApi(app) ? {
-            effectReadiness: `${effectApiPrefix(app)}/effect/${effectApiStem(app)}/readiness`
+            apiReadiness: `${effectApiPrefix(app)}/${effectApiStem(app)}/readiness`
         } : {}
     };
 }

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

@@ -127,6 +127,9 @@ function createWorkspaceValidationScript(scope, enableTailwind, remotes = []) {
 function createWorkspaceI18nBoundaryValidationScript() {
     return readFileTemplate("workspace-scripts/check-ultramodern-i18n-boundaries.mjs");
 }
+function createWorkspaceApiBoundaryValidationScript() {
+    return readFileTemplate("workspace-scripts/check-ultramodern-api-boundaries.mjs");
+}
 function createPerformanceReadinessConfigScript() {
     return readFileTemplate("workspace-scripts/ultramodern-performance-readiness.config.mjs");
 }
@@ -134,6 +137,7 @@ function writeGeneratedWorkspaceScripts(targetDir, _scope, _enableTailwind, _rem
     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/check-ultramodern-api-boundaries.mjs", createWorkspaceApiBoundaryValidationScript());
     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());
@@ -141,4 +145,4 @@ function writeGeneratedWorkspaceScripts(targetDir, _scope, _enableTailwind, _rem
     writeFileReplacing(targetDir, "scripts/ultramodern-typecheck.mjs", createToolWrapperScript('typecheck'));
     writeFileReplacing(targetDir, "scripts/bootstrap-agent-skills.mjs", createSkillsToolWrapperScript());
 }
-export { createPerformanceReadinessConfigScript, createWorkspaceI18nBoundaryValidationScript, createWorkspaceValidationScript, writeGeneratedWorkspaceScripts };
+export { createPerformanceReadinessConfigScript, createWorkspaceApiBoundaryValidationScript, createWorkspaceI18nBoundaryValidationScript, createWorkspaceValidationScript, writeGeneratedWorkspaceScripts };

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

@@ -50,12 +50,12 @@ function writeApp(targetDir, scope, app, packageSource, enableTailwind, remotes
     if ('shell' === resolvedApp.kind) {
         writeAppFile('src/routes/vertical-components.tsx', createShellRemoteComponents(scope, remotes));
         writeAppFile('src/routes/shell-frame.tsx', createShellFrameComponent());
-        writeFile(targetDir, `${resolvedApp.directory}/src/effect/vertical-clients.ts`, createShellEffectClient(scope, remotes));
+        writeFile(targetDir, `${resolvedApp.directory}/src/api/vertical-clients.ts`, createShellEffectClient(scope, remotes));
     }
     if (appHasEffectApi(resolvedApp)) {
-        writeFile(targetDir, `${resolvedApp.directory}/shared/effect/api.ts`, createEffectSharedApi(resolvedApp));
-        writeFile(targetDir, `${resolvedApp.directory}/api/effect/index.ts`, createEffectServiceEntry(resolvedApp, '../../shared/effect/api.ts'));
-        writeFile(targetDir, `${resolvedApp.directory}/src/effect/${resolvedApp.effectApi.stem}-client.ts`, createEffectClient(resolvedApp, '../../shared/effect/api'));
+        writeFile(targetDir, `${resolvedApp.directory}/shared/api.ts`, createEffectSharedApi(resolvedApp));
+        writeFile(targetDir, `${resolvedApp.directory}/api/index.ts`, createEffectServiceEntry(resolvedApp, '../shared/api.ts'));
+        writeFile(targetDir, `${resolvedApp.directory}/src/api/${resolvedApp.effectApi.stem}-client.ts`, createEffectClient(resolvedApp, '../../shared/api'));
     }
     if ('vertical' === resolvedApp.kind) {
         writeAppFile('src/federation-entry.tsx', createRemoteEntry(resolvedApp));

package/dist/esm-node/index.js

@@ -185,7 +185,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/esm-node/locale/en.js

@@ -19,7 +19,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',
@@ -31,7 +31,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/esm-node/locale/zh.js

@@ -19,7 +19,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 项目创建工具',
@@ -31,7 +31,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）',