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

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

@@ -179,6 +179,7 @@ function createRootPackageJson(scope, packageSource, remotes = [], bridge) {
             'agents:refs:check': "node ./scripts/setup-agent-reference-repos.mts --check",
             'mf:types': "node ./scripts/assert-mf-types.mts",
             'performance:readiness': "node ./scripts/ultramodern-performance-readiness.mts",
+            'migrate:strict-effect': "node ./scripts/migrate-strict-effect.mts",
             'contract:check': "node ./scripts/validate-ultramodern-workspace.mts",
             'api:check': "node ./scripts/check-ultramodern-api-boundaries.mts",
             'i18n:boundaries': "node ./scripts/check-ultramodern-i18n-boundaries.mts",

package/dist/esm-node/ultramodern-workspace/versions.js

@@ -9,12 +9,14 @@ const CLOUDFLARE_COMPATIBILITY_DATE = '2026-06-02';
 const TAILWIND_VERSION = '4.3.1';
 const TAILWIND_POSTCSS_VERSION = '4.3.1';
 const POSTCSS_VERSION = '8.5.15';
+const EFFECT_VERSION = '4.0.0-beta.91';
+const EFFECT_VITEST_VERSION = '4.0.0-beta.91';
 const EFFECT_TSGO_VERSION = '0.14.6';
 const TYPESCRIPT_STABLE_VERSION = '6.0.3';
-const TYPESCRIPT_NATIVE_PREVIEW_VERSION = '7.0.0-dev.20260624.1';
+const TYPESCRIPT_NATIVE_PREVIEW_VERSION = '7.0.0-dev.20260628.1';
 const TYPESCRIPT_VERSION = TYPESCRIPT_STABLE_VERSION;
 const OXLINT_VERSION = '1.71.0';
-const OXFMT_VERSION = '0.55.0';
+const OXFMT_VERSION = '0.56.0';
 const ULTRACITE_VERSION = '7.8.3';
 const LEFTHOOK_VERSION = '^2.1.9';
 const I18NEXT_VERSION = '26.3.1';
@@ -32,7 +34,9 @@ const ultramodernWorkspaceVersions = {
     tanstackRouter: TANSTACK_ROUTER_VERSION,
     tanstackRouterCore: TANSTACK_ROUTER_CORE_VERSION,
     moduleFederation: MODULE_FEDERATION_VERSION,
+    effect: EFFECT_VERSION,
+    effectVitest: EFFECT_VITEST_VERSION,
     tailwind: TAILWIND_VERSION,
     tailwindPostcss: TAILWIND_POSTCSS_VERSION
 };
-export { CLOUDFLARE_COMPATIBILITY_DATE, EFFECT_TSGO_VERSION, I18NEXT_VERSION, LEFTHOOK_VERSION, MODULE_FEDERATION_AGENT_SKILLS_COMMIT, MODULE_FEDERATION_VERSION, NODE_FETCH_VERSION, NODE_VERSION, OXFMT_VERSION, OXLINT_VERSION, PNPM_VERSION, POSTCSS_VERSION, REACT_DOM_VERSION, REACT_ROUTER_VERSION, REACT_VERSION, RSTACK_AGENT_SKILLS_COMMIT, TAILWIND_POSTCSS_VERSION, TAILWIND_VERSION, TANSTACK_ROUTER_CORE_VERSION, TANSTACK_ROUTER_VERSION, TYPESCRIPT_NATIVE_PREVIEW_VERSION, TYPESCRIPT_STABLE_VERSION, TYPESCRIPT_VERSION, TYPES_REACT_DOM_VERSION, TYPES_REACT_VERSION, ULTRACITE_VERSION, WRANGLER_VERSION, ZEPHYR_AGENT_VERSION, ZEPHYR_RSPACK_PLUGIN_VERSION, ultramodernWorkspaceVersions };
+export { CLOUDFLARE_COMPATIBILITY_DATE, EFFECT_TSGO_VERSION, EFFECT_VERSION, EFFECT_VITEST_VERSION, I18NEXT_VERSION, LEFTHOOK_VERSION, MODULE_FEDERATION_AGENT_SKILLS_COMMIT, MODULE_FEDERATION_VERSION, NODE_FETCH_VERSION, NODE_VERSION, OXFMT_VERSION, OXLINT_VERSION, PNPM_VERSION, POSTCSS_VERSION, REACT_DOM_VERSION, REACT_ROUTER_VERSION, REACT_VERSION, RSTACK_AGENT_SKILLS_COMMIT, TAILWIND_POSTCSS_VERSION, TAILWIND_VERSION, TANSTACK_ROUTER_CORE_VERSION, TANSTACK_ROUTER_VERSION, TYPESCRIPT_NATIVE_PREVIEW_VERSION, TYPESCRIPT_STABLE_VERSION, TYPESCRIPT_VERSION, TYPES_REACT_DOM_VERSION, TYPES_REACT_VERSION, ULTRACITE_VERSION, WRANGLER_VERSION, ZEPHYR_AGENT_VERSION, ZEPHYR_RSPACK_PLUGIN_VERSION, ultramodernWorkspaceVersions };

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

@@ -163,6 +163,7 @@ function writeGeneratedWorkspaceScripts(targetDir, _scope, _enableTailwind, _rem
     writeWorkspaceOwnedMtsScript(targetDir, 'proof-cloudflare-version', createToolWrapperScript('cloudflare-proof'));
     writeFileReplacing(targetDir, "scripts/ultramodern-performance-readiness.config.mjs", createPerformanceReadinessConfigScript());
     writeWorkspaceOwnedMtsScript(targetDir, 'ultramodern-performance-readiness', createToolWrapperScript('performance-readiness'));
+    writeWorkspaceOwnedMtsScript(targetDir, 'migrate-strict-effect', createToolWrapperScript('migrate-strict-effect'));
     writeWorkspaceOwnedMtsScript(targetDir, 'ultramodern-typecheck', createToolWrapperScript('typecheck'));
     writeWorkspaceOwnedMtsScript(targetDir, 'bootstrap-agent-skills', createSkillsToolWrapperScript());
     migrateCopiedWorkspaceScriptToMts(targetDir, 'setup-agent-reference-repos');

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

@@ -15,7 +15,7 @@ import { runCodeSmithOverlays } from "./overlays.js";
 import { createAppMfTypesTsConfig, createAppPackage, createAppTsConfig, createRootPackageJson, createRootTsConfig, createSharedContractsIndex, createSharedPackage, createSharedPackageTsConfig, createTsConfigBase } from "./package-json.js";
 import { resolvePackageSource } from "./package-source.js";
 import { createPublicWebAppArtifacts } from "./public-surface.js";
-import { NODE_FETCH_VERSION, NODE_VERSION, PNPM_VERSION, TANSTACK_ROUTER_CORE_VERSION, TANSTACK_ROUTER_VERSION, TYPESCRIPT_VERSION } from "./versions.js";
+import { EFFECT_VERSION, EFFECT_VITEST_VERSION, NODE_FETCH_VERSION, NODE_VERSION, PNPM_VERSION, TANSTACK_ROUTER_CORE_VERSION, TANSTACK_ROUTER_VERSION, TYPESCRIPT_VERSION } from "./versions.js";
 import { writeGeneratedWorkspaceScripts } from "./workspace-scripts.js";
 function writeApp(targetDir, scope, app, packageSource, enableTailwind, remotes = [], bridge) {
     const resolvedApp = 'shell' === app.kind ? createShellHost(remotes) : app;
@@ -131,6 +131,8 @@ function generateUltramodernWorkspace(options) {
         nodeVersion: NODE_VERSION,
         pnpmVersion: PNPM_VERSION,
         nodeFetchVersion: NODE_FETCH_VERSION,
+        effectVersion: EFFECT_VERSION,
+        effectVitestVersion: EFFECT_VITEST_VERSION,
         tanstackRouterCoreVersion: TANSTACK_ROUTER_CORE_VERSION,
         tanstackRouterVersion: TANSTACK_ROUTER_VERSION,
         typescriptVersion: TYPESCRIPT_VERSION,

package/dist/types/ultramodern-workspace/versions.d.ts

@@ -13,12 +13,14 @@ export declare const CLOUDFLARE_COMPATIBILITY_DATE = "2026-06-02";
 export declare const TAILWIND_VERSION = "4.3.1";
 export declare const TAILWIND_POSTCSS_VERSION = "4.3.1";
 export declare const POSTCSS_VERSION = "8.5.15";
+export declare const EFFECT_VERSION = "4.0.0-beta.91";
+export declare const EFFECT_VITEST_VERSION = "4.0.0-beta.91";
 export declare const EFFECT_TSGO_VERSION = "0.14.6";
 export declare const TYPESCRIPT_STABLE_VERSION = "6.0.3";
-export declare const TYPESCRIPT_NATIVE_PREVIEW_VERSION = "7.0.0-dev.20260624.1";
+export declare const TYPESCRIPT_NATIVE_PREVIEW_VERSION = "7.0.0-dev.20260628.1";
 export declare const TYPESCRIPT_VERSION = "6.0.3";
 export declare const OXLINT_VERSION = "1.71.0";
-export declare const OXFMT_VERSION = "0.55.0";
+export declare const OXFMT_VERSION = "0.56.0";
 export declare const ULTRACITE_VERSION = "7.8.3";
 export declare const LEFTHOOK_VERSION = "^2.1.9";
 export declare const I18NEXT_VERSION = "26.3.1";
@@ -36,6 +38,8 @@ export declare const ultramodernWorkspaceVersions: {
     tanstackRouter: string;
     tanstackRouterCore: string;
     moduleFederation: string;
+    effect: string;
+    effectVitest: string;
     tailwind: string;
     tailwindPostcss: string;
 };

package/package.json

@@ -21,7 +21,7 @@
   "engines": {
     "node": ">=20"
   },
-  "version": "3.5.0-ultramodern.0",
+  "version": "3.5.0-ultramodern.2",
   "types": "./dist/types/index.d.ts",
   "main": "./dist/esm-node/index.js",
   "bin": {
@@ -75,14 +75,14 @@
   ],
   "dependencies": {
     "@modern-js/codesmith": "2.6.9",
-    "oxfmt": "0.55.0",
+    "oxfmt": "0.56.0",
     "ultracite": "7.8.3",
-    "@modern-js/i18n-utils": "npm:@bleedingdev/modern-js-i18n-utils@3.5.0-ultramodern.0"
+    "@modern-js/i18n-utils": "npm:@bleedingdev/modern-js-i18n-utils@3.5.0-ultramodern.2"
   },
   "devDependencies": {
-    "@rslib/core": "0.23.0",
+    "@rslib/core": "0.23.1",
     "@types/node": "^26.0.1",
-    "@typescript/native-preview": "7.0.0-dev.20260624.1",
+    "@typescript/native-preview": "7.0.0-dev.20260628.1",
     "tsx": "^4.22.4",
     "typescript": "^6.0.3",
     "@scripts/rstest-config": "2.66.0"
@@ -99,6 +99,6 @@
     "test": "rm -rf dist && rslib build -c rslibconfig.mts && rstest --passWithNoTests"
   },
   "ultramodern": {
-    "frameworkVersion": "3.5.0-ultramodern.0"
+    "frameworkVersion": "3.5.0-ultramodern.2"
   }
 }

package/template-workspace/README.md.handlebars

@@ -69,7 +69,7 @@ typecheck, skills, i18n boundary validation, contract validation, and build as
 separate matrix jobs so failures are isolated and parallelizable.
 
 Type checking is TS7-first. `pnpm typecheck` runs
-`scripts/ultramodern-typecheck.mjs` in TS-Go build mode over
+`scripts/ultramodern-typecheck.mts` in TS-Go build mode over
 `tsconfig.json` project references, with native-preview `--checkers` and
 `--builders` enabled by default. `@typescript/native-preview` is the TS7 latest
 dev compiler lane. The classic `typescript` package is pinned to latest TS6
@@ -147,11 +147,50 @@ ULTRAMODERN_PUBLIC_URL_SHELL_SUPER_APP=https://shell-super-app.example.workers.d
 pnpm cloudflare:proof -- --require-public-urls
 ```
 
+## Strict Effect API
+
+Generated HTTP APIs use the direct strict Effect topology only:
+
+- API contracts live at `shared/api.ts`.
+- Runtime entries live at `api/index.ts`.
+- Browser clients live under `src/api/*-client.ts`.
+- `modern.config.ts` uses `bff.runtimeFramework: 'effect'`,
+  `bff.effect.entry: './api/index'`, and
+  `bff.effect.strictEffectApproach: true`.
+
+Do not add `api/effect`, `api/lambda`, `shared/effect`, `src/effect`, Hono
+server imports, raw request handlers, manual `request.json()` parsing, or
+manual `new Response(...)` construction inside generated API modules.
+`pnpm api:check` and Oxlint enforce this. Model requests, responses, and typed
+errors with concrete Effect `Schema` values; generic JSON shortcuts such as
+`Schema.UnknownFromJsonString`, `Schema.Unknown`, and `Schema.Any` are rejected
+in API modules.
+
+Generated pnpm overrides pin the framework-compatible Effect cohort. Keep
+`effect` and `@effect/vitest` aligned with `pnpm-workspace.yaml`; do not add
+new direct package-level Effect versions unless the whole UltraModern cohort is
+upgraded.
+
+For older generated workspaces, run the framework migration command first:
+
+```bash
+pnpm dlx @bleedingdev/modern-js-create@3.5.0-ultramodern.2 ultramodern \
+  migrate-strict-effect --version 3.5.0-ultramodern.2
+pnpm api:check
+pnpm contract:check
+```
+
+The command updates generated package-source metadata, Modern package aliases,
+direct API topology metadata, and the lockfile. Remaining failures are source
+migration work; fix the owning API files instead of adding compatibility shims.
+
 ## Troubleshooting
 
 | Symptom | Current check | Owner |
 | --- | --- | --- |
 | 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 |
+| Effect runtime cohort mismatch | Keep `effect` and `@effect/vitest` on the generated pnpm override versions, then rerun `pnpm install`. | Generated workspace dependency policy |
+| Old nested API path | Run `pnpm api:check`, move code to `api/index.ts`, `shared/api.ts`, and `src/api/*`, then delete `api/effect`, `api/lambda`, `shared/effect`, and `src/effect`. | API owner |
 | 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 app public URL env key recorded in `.modernjs/ultramodern.json`, for example `ULTRAMODERN_PUBLIC_URL_SHELL_SUPER_APP`. | Deployment operator |

package/template-workspace/pnpm-workspace.yaml.handlebars

@@ -37,11 +37,14 @@ peerDependencyRules:
     '@module-federation/enhanced>typescript': '{{typescriptVersion}}'
     '@module-federation/modern-js-v3>typescript': '{{typescriptVersion}}'
     '@module-federation/rspack>typescript': '{{typescriptVersion}}'
+    '@effect/vitest>effect': '{{effectVersion}}'
     'i18next>typescript': '{{typescriptVersion}}'
 
 overrides:
   '@tanstack/react-router': {{tanstackRouterVersion}}
   '@tanstack/router-core': {{tanstackRouterCoreVersion}}
+  '@effect/vitest': {{effectVitestVersion}}
+  effect: {{effectVersion}}
   node-fetch: '{{nodeFetchVersion}}'
 
 allowBuilds:

package/templates/workspace-scripts/check-ultramodern-api-boundaries.mts

@@ -97,7 +97,12 @@ function assertNotContains(relativePath, content, pattern, message) {
 }
 
 for (const forbiddenPath of [
-  'apps/shell-super-app/src/effect',
+  ...listDirectories('apps').flatMap(appPath => [
+    `${appPath}/api/effect`,
+    `${appPath}/api/lambda`,
+    `${appPath}/shared/effect`,
+    `${appPath}/src/effect`,
+  ]),
   ...listDirectories('verticals').flatMap(verticalPath => [
     `${verticalPath}/api/effect`,
     `${verticalPath}/api/lambda`,
@@ -148,6 +153,12 @@ for (const file of textFiles) {
       /\bcreateHandler\s*[:=]\s*(?!defineEffectBff\b)/u,
       'API modules must not define unbranded handler factories; use defineEffectBff(...).',
     );
+    assertNotContains(
+      file,
+      content,
+      /\bSchema\.(?:UnknownFromJsonString|Unknown|Any)\b/u,
+      'API modules must use concrete request, response and error schemas; Schema.UnknownFromJsonString, Schema.Unknown and Schema.Any are forbidden in UltraModern API code.',
+    );
   }
 
   assertNotContains(
@@ -170,17 +181,18 @@ for (const file of textFiles) {
   );
 }
 
+const verticalDirectories = listDirectories('verticals');
 const shellClient = 'apps/shell-super-app/src/api/vertical-clients.ts';
-if (exists('apps/shell-super-app')) {
+if (exists('apps/shell-super-app') && verticalDirectories.length > 0) {
   assert(exists(shellClient), `${shellClient} must aggregate vertical API clients.`);
 }
 
-for (const verticalPath of listDirectories('verticals')) {
-  const apiEntry = `${verticalPath}/api/index.ts`;
-  const sharedApi = `${verticalPath}/shared/api.ts`;
-  const srcApiDirectory = `${verticalPath}/src/api`;
-  const modernConfig = `${verticalPath}/modern.config.ts`;
-  const packageJsonPath = `${verticalPath}/package.json`;
+function assertApiSurface(appPath) {
+  const apiEntry = `${appPath}/api/index.ts`;
+  const sharedApi = `${appPath}/shared/api.ts`;
+  const srcApiDirectory = `${appPath}/src/api`;
+  const modernConfig = `${appPath}/modern.config.ts`;
+  const packageJsonPath = `${appPath}/package.json`;
 
   assert(exists(apiEntry), `${apiEntry} is required.`);
   assert(exists(sharedApi), `${sharedApi} is required.`);
@@ -288,6 +300,16 @@ for (const verticalPath of listDirectories('verticals')) {
   }
 }
 
+for (const appPath of listDirectories('apps')) {
+  if (exists(`${appPath}/api/index.ts`) || exists(`${appPath}/shared/api.ts`)) {
+    assertApiSurface(appPath);
+  }
+}
+
+for (const verticalPath of verticalDirectories) {
+  assertApiSurface(verticalPath);
+}
+
 if (exists('apps/shell-super-app/package.json')) {
   const shellPackageJson = JSON.parse(
     readText('apps/shell-super-app/package.json'),

package/templates/workspace-scripts/validate-ultramodern-workspace.mjs.handlebars

@@ -1701,6 +1701,7 @@ assert(
 assert(rootPackage.scripts?.['mf:types'] === 'node ./scripts/assert-mf-types.mts', 'Root must expose mf:types');
 assert(rootPackage.scripts?.['cloudflare:deploy'] === expectedCloudflareDeployScript, 'Root must expose cloudflare:deploy');
 assert(rootPackage.scripts?.['cloudflare:proof'] === 'node ./scripts/proof-cloudflare-version.mts --out .codex/reports/cloudflare-version-proof/public-url-proof.json', 'Root must expose cloudflare:proof');
+assert(rootPackage.scripts?.['migrate:strict-effect'] === 'node ./scripts/migrate-strict-effect.mts', 'Root must expose migrate:strict-effect');
 assert(rootPackage.scripts?.['skills:install'] === 'node ./scripts/bootstrap-agent-skills.mts', 'Root must expose skills:install');
 assert(rootPackage.scripts?.['skills:check'] === 'node ./scripts/bootstrap-agent-skills.mts --check', 'Root must expose skills:check');
 assert(rootPackage.scripts?.postinstall === "oxfmt . '!repos/**' && node ./scripts/bootstrap-agent-skills.mts --postinstall", 'Root postinstall must format, run the default-on Codex skills bootstrap, and leave reference repository installs explicit');
@@ -1709,6 +1710,7 @@ const agentSkillsBootstrap = readText('scripts/bootstrap-agent-skills.mts');
 assertToolWrapper('scripts/assert-mf-types.mts', 'mf-types');
 assertToolWrapper('scripts/generate-public-surface-assets.mts', 'public-surface');
 assertToolWrapper('scripts/proof-cloudflare-version.mts', 'cloudflare-proof');
+assertToolWrapper('scripts/migrate-strict-effect.mts', 'migrate-strict-effect');
 assertToolWrapper('scripts/bootstrap-agent-skills.mts', 'skills');
 assert(!agentSkillsBootstrap.includes("run('brew'") && !agentSkillsBootstrap.includes('runShell('), 'Agent skills bootstrap must never invoke system package managers');
 const agentReferenceRepoSetup = readText('scripts/setup-agent-reference-repos.mts');