@bleedingdev/modern-js-main-doc 3.5.0-ultramodern.6 → 3.5.0-ultramodern.9

package/docs/en/configure/app/bff/effect.mdx

@@ -197,7 +197,7 @@ The generated `api.client.*` API only exists for loader-materialized `@api/index
 ## Effect cohort
 
 UltraModern-generated workspaces pin the framework-compatible Effect cohort
-through `pnpm-workspace.yaml` overrides. For `3.5.0-ultramodern.6`, generated
+through `pnpm-workspace.yaml` overrides. For `3.5.0-ultramodern.9`, generated
 apps use:
 
 ```yaml

package/docs/en/configure/app/performance/build-cache.mdx

@@ -28,6 +28,11 @@ type BuildCacheConfig =
 
 Controls the caching behavior during the build process.
 
+When persistent Rspack cache is enabled, Modern.js treats `cacheDirectory` as a
+base directory and stores each Rsbuild/Rspack environment in its own child
+directory, such as `client`, `server`, or `workerSSR`. This avoids concurrent
+environment compilers writing to the same filesystem cache root.
+
 Modern.js will enable build cache by default to improve the compile speed. You can disable the build cache by setting it to `false`:
 
 ```js

package/docs/en/guides/get-started/ultramodern.mdx

@@ -78,20 +78,20 @@ mise exec -- pnpm check
 mise exec -- pnpm build
 ```
 
-Strict generated API migration requires `3.5.0-ultramodern.6` or newer.
+Strict generated API migration requires `3.5.0-ultramodern.9` or newer.
 `3.4.0-ultramodern.20` and earlier cohorts do not include this full direct
 `api/index.ts` generator, generated `.mts` checks, strict Oxlint boundary rule
 set, Effect cohort overrides, and strict Effect migration command. Agents that
 cannot install that BleedingDev cohort yet should use the local Modern.js
-workspace for migration validation; otherwise pin `3.5.0-ultramodern.6` or
+workspace for migration validation; otherwise pin `3.5.0-ultramodern.9` or
 newer with `--ultramodern-package-version`.
 
 Before hand-editing package aliases or generated metadata, run the framework
 migration command from the target workspace:
 
 ```bash
-pnpm dlx @bleedingdev/modern-js-create@3.5.0-ultramodern.6 ultramodern \
-  migrate-strict-effect --version 3.5.0-ultramodern.6
+pnpm dlx @bleedingdev/modern-js-create@3.5.0-ultramodern.9 ultramodern \
+  migrate-strict-effect --version 3.5.0-ultramodern.9
 pnpm api:check
 pnpm contract:check
 ```
@@ -189,9 +189,9 @@ instead of patching generated output by hand.
 Cloudflare D1 bindings are first-class on `deploy.worker.d1Databases`; use that
 config instead of app-local postprocessing when a generated app owns D1
 migrations. Cloudflare public output excludes server-only `api` and `shared`
-directories by default, and generated Modern/Rspack caches are isolated per app
-and build target so local `build` and `cloudflare:build` runs do not share the
-same Rspack cache directory.
+directories by default, and generated Modern/Rspack caches are isolated per app,
+build target, and Rspack environment so local `build`, `cloudflare:build`, and
+multi-environment compilers do not share the same filesystem cache directory.
 
 ## Human Workflow
 

package/docs/zh/configure/app/bff/effect.mdx

@@ -195,7 +195,7 @@ export default defineConfig({
 ## Effect 版本组
 
 UltraModern 生成的 workspace 会通过 `pnpm-workspace.yaml` overrides 锁定与框架兼容的
-Effect 版本组。`3.5.0-ultramodern.6` 使用：
+Effect 版本组。`3.5.0-ultramodern.9` 使用：
 
 ```yaml
 minimumReleaseAgeExclude:

package/docs/zh/configure/app/performance/build-cache.mdx

@@ -28,6 +28,10 @@ type BuildCacheConfig =
 
 控制 Modern.js 在构建过程中的缓存行为。
 
+启用 Rspack 持久化缓存时，Modern.js 会把 `cacheDirectory` 视为基础目录，并为每个
+Rsbuild/Rspack environment 写入独立子目录，例如 `client`、`server` 或
+`workerSSR`。这样可以避免并发 environment compiler 写入同一个文件系统 cache 根目录。
+
 在构建时，Modern.js 默认会开启构建缓存来提升二次构建的速度。如果不希望缓存，你可以将 `buildCache` 置为 `false` 将其禁用掉：
 
 ```js

package/docs/zh/guides/get-started/ultramodern.mdx

@@ -71,18 +71,18 @@ mise exec -- pnpm check
 mise exec -- pnpm build
 ```
 
-严格生成 API 迁移要求 `3.5.0-ultramodern.6` 或更新版本。
+严格生成 API 迁移要求 `3.5.0-ultramodern.9` 或更新版本。
 `3.4.0-ultramodern.20` 及更早 cohort 还没有这套完整的直接
 `api/index.ts` 生成器、生成的 `.mts` 检查、严格 Oxlint 边界规则、Effect 版本组
 overrides 和严格 Effect 迁移命令。还不能安装该 BleedingDev cohort 的 agent 应使用本地
 Modern.js workspace 做迁移校验；否则用 `--ultramodern-package-version` 固定
-`3.5.0-ultramodern.6` 或更新版本。
+`3.5.0-ultramodern.9` 或更新版本。
 
 手写 package alias 或生成 metadata 之前，先在目标 workspace 运行框架迁移命令：
 
 ```bash
-pnpm dlx @bleedingdev/modern-js-create@3.5.0-ultramodern.6 ultramodern \
-  migrate-strict-effect --version 3.5.0-ultramodern.6
+pnpm dlx @bleedingdev/modern-js-create@3.5.0-ultramodern.9 ultramodern \
+  migrate-strict-effect --version 3.5.0-ultramodern.9
 pnpm api:check
 pnpm contract:check
 ```
@@ -161,8 +161,9 @@ Federation 冲突，都应在对应归属文件中修复，不要手写补丁覆
 
 Cloudflare D1 绑定使用一等配置 `deploy.worker.d1Databases`；生成 app 拥有 D1
 migration 时不要再用 app 本地 postprocess。Cloudflare public output 默认排除服务端
-`api` 和 `shared` 目录，并且生成的 Modern/Rspack cache 会按 app 与构建目标隔离，避免
-本地 `build` 与 `cloudflare:build` 共享同一个 Rspack cache 目录。
+`api` 和 `shared` 目录，并且生成的 Modern/Rspack cache 会按 app、构建目标和 Rspack
+environment 隔离，避免本地 `build`、`cloudflare:build` 以及多 environment compiler
+共享同一个文件系统 cache 目录。
 
 ## 人类工作流
 

package/package.json

@@ -19,14 +19,14 @@
     "modern.js",
     "ultramodern.js"
   ],
-  "version": "3.5.0-ultramodern.6",
+  "version": "3.5.0-ultramodern.9",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
   "dependencies": {
     "mermaid": "^11.16.0",
-    "@modern-js/sandpack-react": "npm:@bleedingdev/modern-js-sandpack-react@3.5.0-ultramodern.6"
+    "@modern-js/sandpack-react": "npm:@bleedingdev/modern-js-sandpack-react@3.5.0-ultramodern.9"
   },
   "devDependencies": {
     "@rsbuild/plugin-sass": "2.0.0",