@bleedingdev/modern-js-ultramodern-create 3.8.3-ultramodern.2

package/template-workspace/.codex/skills/rstest-best-practices/SKILL.md

@@ -0,0 +1,133 @@
+---
+name: rstest-best-practices
+description: Rstest best practices for config, CLI workflow, test writing, mocking, snapshot testing, DOM testing, coverage, multi-project setup, CI integration, performance and debugging. Use when writing, reviewing, or troubleshooting Rstest test projects.
+---
+
+# Rstest Best Practices
+
+Apply these rules when writing or reviewing Rstest test projects.
+
+## Configuration
+
+- Use `rstest.config.ts` and `defineConfig` from `@rstest/core`
+- Prefer explicit imports `import { test, expect, describe } from '@rstest/core'` over `globals: true`
+- For Rsbuild projects, use `@rstest/adapter-rsbuild` with `extends: withRsbuildConfig()` to reuse build config
+- For Rslib projects, use `@rstest/adapter-rslib` with `extends: withRslibConfig()` to reuse build config
+- Use `setupFiles` for shared test setup (e.g., custom matchers, cleanup hooks)
+- When using Rsbuild plugins (e.g., `@rsbuild/plugin-react`), add them via the `plugins` field
+- For deep-level or advanced build configuration needs, use `tools.rspack` or `tools.bundlerChain`
+
+## CLI
+
+- Use `rstest` or `rstest run` to run tests (`run` disables watch mode, suitable for CI)
+- Use `rstest --watch` or `rstest watch` for local development with file watching
+- Use `rstest list` to list all test files and test names
+- Use `rstest -u` to update snapshots
+- Use `--reporter=verbose` when debugging test failures for detailed output
+- Use `--config` (`-c`) to specify a custom config file path
+
+## Test writing
+
+- Import test APIs from `@rstest/core`: `test`, `describe`, `expect`, `beforeEach`, `afterEach`, etc.
+- Use `test` or `it` for test cases; use `describe` for grouping related tests
+- Use `.only` to focus on specific tests during development, but never commit `.only` to the codebase
+- Use `.skip` or `.todo` to mark incomplete or temporarily skipped tests
+- Prefer small, focused test cases that test a single behavior
+- For async error paths, prefer `await expect(fn()).rejects.toThrow(ErrorClass)` (or `.rejects.toMatchObject({ ... })`) over `try/catch` with `expect.fail` or `.catch(e => e)` patterns — the matcher form fails clearly if the promise unexpectedly resolves, keeps the assertion in one chain, and avoids forgetting to assert the throw at all
+- For async happy paths, use `await expect(fn()).resolves.toEqual(...)` for the same reason
+- Use `includeSource` for in-source testing of small utility functions (Rust-style `import.meta.rstest`)
+- For in-source tests, wrap test code in `if (import.meta.rstest) { ... }` and define `import.meta.rstest` as `false` in production build config
+
+## Test environment
+
+- Use `testEnvironment: 'node'` (default) for Node.js / server-side code
+- Use `testEnvironment: 'jsdom'` or `testEnvironment: 'happy-dom'` for DOM / browser API testing
+- Install `jsdom` or `happy-dom` as a dev dependency when using DOM environments
+- Prefer `happy-dom` for faster DOM testing; use `jsdom` when better browser API compatibility is needed
+- For real browser testing, use `@rstest/browser` with Playwright
+- Use inline project configs to run different test environments within one project (e.g., `node` and `jsdom` projects)
+
+## React / Vue testing
+
+- For React: use `@rsbuild/plugin-react` plugin and `@testing-library/react` for component testing
+- For Vue: use `@rsbuild/plugin-vue` plugin and `@testing-library/vue` for component testing
+- Create a `rstest.setup.ts` with `expect.extend(jestDomMatchers)` and `afterEach(() => cleanup())` for Testing Library
+- Add the setup file to `setupFiles` in config
+- For SSR testing, use `testEnvironment: 'node'` and test with `react-dom/server` or framework-specific SSR APIs
+
+## Mocking
+
+- Use `rs.mock('./module')` to mock modules
+- Use `rs.fn()` to create mock functions
+- Use `rs.spyOn(object, 'method')` to spy on methods
+- Prefer `clearMocks`, `resetMocks`, or `restoreMocks` config options to automatically clean up mocks between tests
+- Use factory functions in `rs.mock('./module', () => ({ ... }))` to provide mock implementations
+
+## Snapshot testing
+
+- Use `toMatchSnapshot()` for general snapshot testing
+- Use `toMatchInlineSnapshot()` for small, readable inline snapshots
+- Use `toMatchFileSnapshot()` for large or structured outputs (e.g., HTML, generated code)
+- Keep snapshots concise — only include relevant data, avoid timestamps and session IDs
+- Use `expect.addSnapshotSerializer()` to mask paths or sensitive data in snapshots
+- Use `path-serializer` to normalize file paths across platforms
+- Review snapshot changes carefully in code review
+
+## Coverage
+
+- Enable coverage with `--coverage` CLI flag or `coverage.enabled: true` in config
+- Install `@rstest/coverage-istanbul` for the Istanbul coverage provider
+- Use `coverage.include` to specify source files for coverage (e.g., `['src/**/*.{js,ts,tsx}']`)
+- Use `coverage.thresholds` to enforce minimum coverage requirements
+- Use `coverage.reporters` to generate reports in different formats (e.g., `text`, `lcov`, `html`)
+
+## Multi-project testing
+
+- Use `projects` field in root config to define multiple test projects
+- For monorepos, use glob patterns like `'packages/*'` to auto-discover sub-projects
+- Use `defineProject` helper in sub-project configs
+- Extract shared config and use `mergeRstestConfig` to compose project configs
+- Global options (`reporters`, `pool`, `isolate`, `coverage`, `bail`) must be set at the root level, not in projects
+
+## CI integration
+
+- Use `rstest run` (not `rstest watch`) in CI
+- Use `--shard` for parallel test execution across CI machines (e.g., `--shard 1/3`)
+- Use `--reporter=blob` with `rstest merge-reports` to combine sharded results
+- Use `--reporter=junit` with `outputPath` for CI report integration
+- The `github-actions` reporter is auto-enabled in GitHub Actions for inline error annotations
+- Use `--bail` to stop early on first failure when appropriate
+
+## Performance
+
+- Disable `isolate` (`--no-isolate`) when tests have no side effects for faster execution via module cache reuse
+- Use `pool.maxWorkers` to control parallelism based on available resources
+- Keep test build fast by avoiding unnecessary Rspack plugins in test config
+- Use test filtering (`rstest <pattern>` or `-t <name>`) to run only relevant tests during development
+- Leverage watch mode's incremental re-runs for fast local feedback
+
+## Debugging
+
+- Run with `DEBUG=rstest` to enable debug mode, which writes final configs and build outputs to disk
+- Read generated files in `dist/.rstest-temp/.rsbuild/` to confirm final Rstest/Rsbuild/Rspack config
+- Use VS Code's JavaScript Debug Terminal to run `rstest` with breakpoints
+- Use `--reporter=verbose` for detailed per-test output
+- Use `--printConsoleTrace` to trace console calls to their source
+- Add VS Code launch config for debugging specific test files with `@rstest/core/bin/rstest.js`
+
+## Profiling
+
+- Use Rsdoctor with `RSDOCTOR=true rstest run` to analyze test build performance
+- Use `samply` for native profiling of both main and worker processes
+- Use Node.js `--heap-prof` for memory profiling
+
+## Toolchain integration
+
+- Use the official VS Code extension (`rstack.rstest`) for in-editor test running and debugging
+- For Rslib libraries, use `@rstest/adapter-rslib` for config reuse
+- For Rsbuild apps, use `@rstest/adapter-rsbuild` for config reuse
+- Use `process.env.RSTEST` to detect test environment and apply test-specific config
+
+## Documentation
+
+- For the latest Rstest docs, read https://rstest.rs/llms.txt

package/template-workspace/.codex/skills-lock.json

@@ -0,0 +1,114 @@
+{
+  "schemaVersion": 1,
+  "source": {
+    "repository": "https://github.com/rstackjs/agent-skills",
+    "commit": "61c948b42512e223bad44b83af4080eba48b2677",
+    "license": "MIT",
+    "licensePath": ".codex/rstackjs-agent-skills-LICENSE"
+  },
+  "installDir": ".codex/skills",
+  "sources": [
+    {
+      "id": "rstack-agent-skills",
+      "visibility": "public",
+      "repository": "https://github.com/rstackjs/agent-skills",
+      "commit": "61c948b42512e223bad44b83af4080eba48b2677",
+      "license": "MIT",
+      "licensePath": ".codex/rstackjs-agent-skills-LICENSE",
+      "install": "vendored"
+    },
+    {
+      "id": "module-federation-agent-skills",
+      "visibility": "public",
+      "repository": "https://github.com/module-federation/agent-skills",
+      "commit": "07bb5b6c43ad457609e00c081b72d4c42508ec76",
+      "install": "clone",
+      "baseline": [
+        {
+          "name": "mf",
+          "path": ".codex/skills/mf",
+          "reason": "Module Federation docs, config inspection, type checking, shared dependency checks, and observability troubleshooting"
+        }
+      ]
+    },
+    {
+      "id": "techsiocz-private",
+      "visibility": "private",
+      "repository": "https://github.com/TechsioCZ/skills",
+      "install": "clone-if-authorized",
+      "baseline": [
+        {
+          "name": "plan-graph",
+          "reason": "Build and validate DAGs from .plan.md files"
+        },
+        {
+          "name": "dag",
+          "reason": "Inspect current plan frontiers and blocked lanes"
+        },
+        {
+          "name": "subagent-graph",
+          "reason": "Design dependency-aware multi-agent launch graphs"
+        },
+        {
+          "name": "helm",
+          "reason": "Steer already-running multi-agent work"
+        },
+        {
+          "name": "debugger-mode",
+          "reason": "Run hypothesis-driven debugging with runtime evidence"
+        }
+      ]
+    }
+  ],
+  "baseline": [
+    {
+      "name": "rsbuild-best-practices",
+      "path": ".codex/skills/rsbuild-best-practices",
+      "reason": "Modern.js application build configuration and Rsbuild troubleshooting"
+    },
+    {
+      "name": "rspack-best-practices",
+      "path": ".codex/skills/rspack-best-practices",
+      "reason": "Rspack bundling, CSS, asset, profiling, and production behavior"
+    },
+    {
+      "name": "rspack-tracing",
+      "path": ".codex/skills/rspack-tracing",
+      "reason": "Trace-backed Rspack failure and performance debugging"
+    },
+    {
+      "name": "rsdoctor-analysis",
+      "path": ".codex/skills/rsdoctor-analysis",
+      "reason": "Evidence-backed bundle composition, duplication, and retained-module analysis"
+    },
+    {
+      "name": "rslib-best-practices",
+      "path": ".codex/skills/rslib-best-practices",
+      "reason": "Rslib shared package and design-system library authoring"
+    },
+    {
+      "name": "rslib-modern-package",
+      "path": ".codex/skills/rslib-modern-package",
+      "reason": "Modern package contracts, exports, declarations, side effects, and release readiness"
+    },
+    {
+      "name": "rstest-best-practices",
+      "path": ".codex/skills/rstest-best-practices",
+      "reason": "Rstest configuration, test writing, mocking, snapshots, coverage, and CI behavior"
+    },
+    {
+      "name": "mf",
+      "path": ".codex/skills/mf",
+      "reason": "Module Federation docs, config inspection, type checking, shared dependency checks, and observability troubleshooting"
+    }
+  ],
+  "excludedByDefault": [
+    "migrate-to-rsbuild",
+    "migrate-to-rslib",
+    "migrate-to-rslint",
+    "migrate-to-rstest",
+    "rsbuild-v2-upgrade",
+    "rspack-v2-upgrade",
+    "rspress-v2-upgrade"
+  ]
+}

package/template-workspace/.github/renovate.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+  "extends": ["config:recommended", "helpers:pinGitHubActionDigests"],
+  "dependencyDashboard": true,
+  "minimumReleaseAge": "1 day",
+  "prConcurrentLimit": 5,
+  "prHourlyLimit": 2,
+  "rangeStrategy": "bump",
+  "schedule": ["before 5am on monday"],
+  "timezone": "Etc/UTC",
+  "packageRules": [
+    {
+      "matchManagers": ["github-actions"],
+      "groupName": "github-actions",
+      "labels": ["dependencies", "github-actions", "security"]
+    },
+    {
+      "matchManagers": ["npm"],
+      "matchUpdateTypes": ["patch", "minor"],
+      "groupName": "npm minor and patch updates",
+      "labels": ["dependencies", "npm"]
+    },
+    {
+      "matchUpdateTypes": ["major"],
+      "dependencyDashboardApproval": true,
+      "labels": ["dependencies", "major"]
+    }
+  ]
+}

package/template-workspace/.github/workflows/ultramodern-workspace-gates.yml.handlebars

@@ -0,0 +1,71 @@
+name: Ultramodern Workspace Gates
+
+on:
+  push:
+  pull_request:
+
+permissions:
+  contents: read
+
+defaults:
+  run:
+    shell: bash
+
+concurrency:
+  group: ultramodern-workspace-gates-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  workspace-gate:
+    name: ${{ matrix.name }}
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - name: Format
+            command: pnpm format:check
+          - name: Lint
+            command: pnpm lint
+          - name: Typecheck
+            command: pnpm typecheck
+          - name: Skills
+            command: pnpm skills:check
+          - name: I18n Boundaries
+            command: pnpm i18n:boundaries
+          - name: API Boundaries
+            command: pnpm api:check
+          - name: Contract
+            command: pnpm contract:check
+          - name: Build
+            command: pnpm build
+    steps:
+      - name: Harden Runner
+        uses: step-security/harden-runner@ab7a9404c0f3da075243ca237b5fac12c98deaa5 # v2
+        with:
+          egress-policy: audit
+
+      - name: Checkout
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          fetch-depth: 1
+          persist-credentials: false
+
+      - name: Setup Node.js
+        uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
+        with:
+          node-version: "{{nodeVersion}}"
+
+      - name: Setup mise
+        uses: jdx/mise-action@7e36c90d9ab29c415a2384db3006f3ec8a8cc654 # v4.2.4
+        with:
+          version: 2026.8.3
+
+      - name: Install Dependencies
+        run: mise exec -- pnpm install --frozen-lockfile
+
+      - name: Run ${{ matrix.name }}
+        env:
+          MODERN_PUBLIC_SITE_URL: http://localhost:8080
+        run: mise exec -- ${{ matrix.command }}

package/template-workspace/.gitignore.handlebars

@@ -0,0 +1,16 @@
+node_modules/
+dist/
+dist-cloudflare/
+.output/
+**/.output/
+build/
+.modernjs/cache/
+.modern-js/
+**/.modern-js/
+**/src/modern-tanstack/
+**/.tsgo.*.resolved.json
+.mf/
+**/.mf/
+.modernjs/agent-reference-repos-tmp/
+.codex/reports/
+.zerops/runtime/

package/template-workspace/.mise.toml.handlebars

@@ -0,0 +1,3 @@
+[tools]
+node = "{{nodeVersion}}"
+pnpm = "{{pnpmVersion}}"

package/template-workspace/.modernjs/release-cohort.json

@@ -0,0 +1,244 @@
+{
+  "aliases": {
+    "@modern-js/adapter-rstest": "@bleedingdev/modern-js-adapter-rstest",
+    "@modern-js/app-tools": "@bleedingdev/modern-js-app-tools",
+    "@modern-js/app-tools-extensions": "@bleedingdev/modern-js-app-tools-extensions",
+    "@modern-js/bff-core": "@bleedingdev/modern-js-bff-core",
+    "@modern-js/bff-effect": "@bleedingdev/modern-js-bff-effect",
+    "@modern-js/bff-runtime": "@bleedingdev/modern-js-bff-runtime",
+    "@modern-js/builder": "@bleedingdev/modern-js-builder",
+    "@modern-js/code-tools": "@bleedingdev/modern-js-code-tools",
+    "@modern-js/create-request": "@bleedingdev/modern-js-create-request",
+    "@modern-js/i18n-runtime-extensions": "@bleedingdev/modern-js-i18n-runtime-extensions",
+    "@modern-js/i18n-utils": "@bleedingdev/modern-js-i18n-utils",
+    "@modern-js/image": "@bleedingdev/modern-js-image",
+    "@modern-js/main-doc": "@bleedingdev/modern-js-main-doc",
+    "@modern-js/plugin": "@bleedingdev/modern-js-plugin",
+    "@modern-js/plugin-bff": "@bleedingdev/modern-js-plugin-bff",
+    "@modern-js/plugin-bff-extensions": "@bleedingdev/modern-js-plugin-bff-extensions",
+    "@modern-js/plugin-data-loader": "@bleedingdev/modern-js-plugin-data-loader",
+    "@modern-js/plugin-i18n": "@bleedingdev/modern-js-plugin-i18n",
+    "@modern-js/plugin-polyfill": "@bleedingdev/modern-js-plugin-polyfill",
+    "@modern-js/plugin-ssg": "@bleedingdev/modern-js-plugin-ssg",
+    "@modern-js/plugin-styled-components": "@bleedingdev/modern-js-plugin-styled-components",
+    "@modern-js/plugin-tanstack": "@bleedingdev/modern-js-plugin-tanstack",
+    "@modern-js/prod-server": "@bleedingdev/modern-js-prod-server",
+    "@modern-js/render": "@bleedingdev/modern-js-render",
+    "@modern-js/runtime": "@bleedingdev/modern-js-runtime",
+    "@modern-js/runtime-extensions": "@bleedingdev/modern-js-runtime-extensions",
+    "@modern-js/runtime-utils": "@bleedingdev/modern-js-runtime-utils",
+    "@modern-js/sandpack-react": "@bleedingdev/modern-js-sandpack-react",
+    "@modern-js/server": "@bleedingdev/modern-js-server",
+    "@modern-js/server-core": "@bleedingdev/modern-js-server-core",
+    "@modern-js/server-runtime": "@bleedingdev/modern-js-server-runtime",
+    "@modern-js/server-runtime-extensions": "@bleedingdev/modern-js-server-runtime-extensions",
+    "@modern-js/server-utils": "@bleedingdev/modern-js-server-utils",
+    "@modern-js/tsconfig": "@bleedingdev/modern-js-tsconfig",
+    "@modern-js/types": "@bleedingdev/modern-js-types",
+    "@modern-js/ultramodern-create": "@bleedingdev/modern-js-ultramodern-create",
+    "@modern-js/ultramodern-sandpack-profile": "@bleedingdev/modern-js-ultramodern-sandpack-profile",
+    "@modern-js/utils": "@bleedingdev/modern-js-utils"
+  },
+  "packages": [
+    {
+      "sourceName": "@modern-js/adapter-rstest",
+      "targetName": "@bleedingdev/modern-js-adapter-rstest",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/app-tools",
+      "targetName": "@bleedingdev/modern-js-app-tools",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/app-tools-extensions",
+      "targetName": "@bleedingdev/modern-js-app-tools-extensions",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/bff-core",
+      "targetName": "@bleedingdev/modern-js-bff-core",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/bff-effect",
+      "targetName": "@bleedingdev/modern-js-bff-effect",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/bff-runtime",
+      "targetName": "@bleedingdev/modern-js-bff-runtime",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/builder",
+      "targetName": "@bleedingdev/modern-js-builder",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/code-tools",
+      "targetName": "@bleedingdev/modern-js-code-tools",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/create-request",
+      "targetName": "@bleedingdev/modern-js-create-request",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/i18n-runtime-extensions",
+      "targetName": "@bleedingdev/modern-js-i18n-runtime-extensions",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/i18n-utils",
+      "targetName": "@bleedingdev/modern-js-i18n-utils",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/image",
+      "targetName": "@bleedingdev/modern-js-image",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/main-doc",
+      "targetName": "@bleedingdev/modern-js-main-doc",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/plugin",
+      "targetName": "@bleedingdev/modern-js-plugin",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/plugin-bff",
+      "targetName": "@bleedingdev/modern-js-plugin-bff",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/plugin-bff-extensions",
+      "targetName": "@bleedingdev/modern-js-plugin-bff-extensions",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/plugin-data-loader",
+      "targetName": "@bleedingdev/modern-js-plugin-data-loader",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/plugin-i18n",
+      "targetName": "@bleedingdev/modern-js-plugin-i18n",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/plugin-polyfill",
+      "targetName": "@bleedingdev/modern-js-plugin-polyfill",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/plugin-ssg",
+      "targetName": "@bleedingdev/modern-js-plugin-ssg",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/plugin-styled-components",
+      "targetName": "@bleedingdev/modern-js-plugin-styled-components",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/plugin-tanstack",
+      "targetName": "@bleedingdev/modern-js-plugin-tanstack",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/prod-server",
+      "targetName": "@bleedingdev/modern-js-prod-server",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/render",
+      "targetName": "@bleedingdev/modern-js-render",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/runtime",
+      "targetName": "@bleedingdev/modern-js-runtime",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/runtime-extensions",
+      "targetName": "@bleedingdev/modern-js-runtime-extensions",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/runtime-utils",
+      "targetName": "@bleedingdev/modern-js-runtime-utils",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/sandpack-react",
+      "targetName": "@bleedingdev/modern-js-sandpack-react",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/server",
+      "targetName": "@bleedingdev/modern-js-server",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/server-core",
+      "targetName": "@bleedingdev/modern-js-server-core",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/server-runtime",
+      "targetName": "@bleedingdev/modern-js-server-runtime",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/server-runtime-extensions",
+      "targetName": "@bleedingdev/modern-js-server-runtime-extensions",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/server-utils",
+      "targetName": "@bleedingdev/modern-js-server-utils",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/tsconfig",
+      "targetName": "@bleedingdev/modern-js-tsconfig",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/types",
+      "targetName": "@bleedingdev/modern-js-types",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/ultramodern-create",
+      "targetName": "@bleedingdev/modern-js-ultramodern-create",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/ultramodern-sandpack-profile",
+      "targetName": "@bleedingdev/modern-js-ultramodern-sandpack-profile",
+      "version": "3.8.3-ultramodern.2"
+    },
+    {
+      "sourceName": "@modern-js/utils",
+      "targetName": "@bleedingdev/modern-js-utils",
+      "version": "3.8.3-ultramodern.2"
+    }
+  ],
+  "release": {
+    "tag": "latest",
+    "version": "3.8.3-ultramodern.2"
+  },
+  "schema": "bleedingdev.ultramodern.release-cohort",
+  "schemaVersion": 1,
+  "source": {
+    "commit": "147a7fd0cb902f33e014faf72cc1742dbda3752f",
+    "repository": "BleedingDev/ultramodern.js"
+  }
+}

package/template-workspace/AGENTS.md.handlebars

@@ -0,0 +1,30 @@
+# UltraModern.js Workspace
+
+This UltraModern.js SuperApp has a composition shell and owned MicroVerticals.
+
+## Work here
+
+- Use Node `>=26` and pnpm `{{pnpmVersion}}`.
+- Keep business features out of the shell. Follow [README.md](./README.md) when
+  adding a MicroVertical.
+- Run `pnpm check`; also run `pnpm build` for runtime, routing, build, or deploy
+  changes.
+- Use a matching skill under [`.codex/skills`](./.codex/skills), reading its
+  `SKILL.md` and references only as needed.
+
+<!-- BEGIN:modernjs-agent-rules -->
+
+# Modern.js documentation
+
+Read `node_modules/@modern-js/app-tools/docs/llms.txt` before changing Modern.js
+configuration, APIs, routes, or conventions. These packaged docs match the
+installed version and are the source of truth.
+
+You can skip them for:
+
+- Writing ordinary React components (not route components)
+- Editing CSS or style files
+- Adding utility functions or business logic
+- Installing ordinary npm packages (unrelated to Modern.js)
+
+<!-- END:modernjs-agent-rules -->

package/template-workspace/CLAUDE.md.handlebars

@@ -0,0 +1 @@
+@AGENTS.md