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

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

@@ -1,32 +1,8 @@
-import { ULTRAMODERN_WORKSPACE_MODERN_PACKAGES, WORKSPACE_PACKAGE_VERSION, createModernPackagesMetadata, modernPackageVersion } from "../ultramodern-package-source.js";
-import { appHasEffectApi, appI18nNamespace, createCloudflarePublicUrlEnv, createCloudflareWorkerName, createModuleFederationRemoteContracts, createShellHost, effectApiPrefix, sharedPackages, shellApp, verticalEffectApps } from "./descriptors.js";
-import { createEffectDomainOperations, createEffectOperationContract, createEffectReadinessContract, createEffectRequestContextContract, effectApiTopologyMetadata } from "./effect-api.js";
-import { fileTemplatesDir, hashTemplateTree, workspaceTemplateDir } from "./fs-io.js";
-import { createBuildMarker } from "./module-federation.js";
-import { createRspackChunkLoadingGlobal, createRspackUniqueName, packageName, tailwindPrefixForApp } from "./naming.js";
-import { createCloudflareDeployContract, createCloudflareSecurityContract } from "./policy.js";
-import { createPublicWebAppArtifacts } from "./public-surface.js";
-import { createLocalisedUrlsMap, createPublicRouteMetadata, createRouteOwnedI18nPaths } from "./routes.js";
-import { CLOUDFLARE_COMPATIBILITY_DATE, I18NEXT_VERSION, MODULE_FEDERATION_AGENT_SKILLS_COMMIT, MODULE_FEDERATION_VERSION, NODE_VERSION, PNPM_VERSION, RSTACK_AGENT_SKILLS_COMMIT, TANSTACK_ROUTER_VERSION, TYPESCRIPT_NATIVE_PREVIEW_VERSION, TYPESCRIPT_VERSION, WRANGLER_VERSION, ZEPHYR_AGENT_VERSION, ZEPHYR_RSPACK_PLUGIN_VERSION } from "./versions.js";
-const baselineAgentSkills = [
-    'rsbuild-best-practices',
-    'rspack-best-practices',
-    'rspack-tracing',
-    'rsdoctor-analysis',
-    'rslib-best-practices',
-    'rslib-modern-package',
-    'rstest-best-practices'
-];
-const moduleFederationAgentSkills = [
-    'mf'
-];
-const privateAgentSkills = [
-    'plan-graph',
-    'dag',
-    'subagent-graph',
-    'helm',
-    'debugger-mode'
-];
+import { createModuleFederationRemoteContracts, createShellHost, effectApiPrefix, sharedPackages, shellApp, verticalEffectApps } from "./descriptors.js";
+import { effectApiTopologyMetadata } from "./effect-api.js";
+import { packageName } from "./naming.js";
+import { createCloudflareDeployContract } from "./policy.js";
+import { CLOUDFLARE_COMPATIBILITY_DATE, NODE_VERSION, PNPM_VERSION } from "./versions.js";
 function createTopology(scope, remotes = []) {
     const shellHost = createShellHost(remotes);
     return {
@@ -84,6 +60,7 @@ function createTopology(scope, remotes = []) {
             script: "scripts/validate-ultramodern-workspace.mjs",
             commands: [
                 'pnpm i18n:boundaries',
+                'pnpm api:check',
                 'pnpm contract:check'
             ]
         }
@@ -144,599 +121,143 @@ function createDevelopmentOverlay(remotes = []) {
             ]))
     };
 }
-function createPackageSourceMetadata(scope, packageSource) {
-    return {
-        schemaVersion: 1,
-        strategy: packageSource.strategy,
-        modernPackages: createModernPackagesMetadata(ULTRAMODERN_WORKSPACE_MODERN_PACKAGES, packageSource),
-        generatedWorkspacePackages: {
-            packages: sharedPackages.map((sharedPackage)=>packageName(scope, sharedPackage.id)),
-            specifier: WORKSPACE_PACKAGE_VERSION
-        },
-        validation: {
-            validator: "scripts/validate-ultramodern-workspace.mjs",
-            strategyAwareChecks: [
-                'generated-validator'
-            ]
-        }
-    };
-}
-function createAppConfigContract(app) {
-    return {
-        preset: 'presetUltramodern',
-        plugins: [
-            'appTools',
-            'tanstackRouterPlugin',
-            'i18nPlugin',
-            ...appHasEffectApi(app) ? [
-                'bffPlugin'
-            ] : [],
-            'moduleFederationPlugin',
-            'zephyrRspackPlugin'
-        ],
-        dev: {
-            assetPrefix: '/'
-        },
-        output: {
-            assetPrefix: {
-                envFallbackOrder: [
-                    'MODERN_ASSET_PREFIX',
-                    'ULTRAMODERN_ASSET_PREFIX'
-                ],
-                default: '/'
-            },
-            disableTsChecker: false,
-            distPath: {
-                html: './'
-            },
-            polyfill: 'off',
-            splitRouteChunks: true
-        },
-        performance: {
-            readinessDiagnostics: {
-                default: 'enabled',
-                optOut: {
-                    env: 'ULTRAMODERN_PERFORMANCE_READINESS_DIAGNOSTICS=false',
-                    config: "scripts/ultramodern-performance-readiness.config.mjs"
-                },
-                report: '.codex/reports/performance-readiness/ultramodern-performance-readiness.json',
-                failOn: 'framework-invariant'
-            },
-            rsdoctor: {
-                enabledByEnv: 'ULTRAMODERN_RSDOCTOR=true',
-                disableClientServer: true
-            }
-        },
-        rspack: {
-            output: {
-                uniqueName: createRspackUniqueName(app),
-                chunkLoadingGlobal: createRspackChunkLoadingGlobal(app)
-            }
-        },
-        html: {
-            outputStructure: 'flat'
-        },
-        source: {
-            mainEntryName: 'index',
-            siteUrl: {
-                envFallbackOrder: [
-                    'MODERN_PUBLIC_SITE_URL',
-                    createCloudflarePublicUrlEnv(app),
-                    'ULTRAMODERN_CLOUDFLARE_WORKERS_DEV_SUBDOMAIN',
-                    app.portEnv
-                ],
-                defaultLocalhostPort: app.port
-            },
-            siteUrlGlobal: 'ULTRAMODERN_SITE_URL'
-        },
-        ...appHasEffectApi(app) ? {
-            bff: {
-                runtimeFramework: 'effect',
-                prefix: app.effectApi.prefix,
-                openapi: '/openapi.json'
-            }
-        } : {}
-    };
-}
-function createPerformanceReadinessContract() {
+function createUltramodernConfig(scope, modernVersion, packageSource, apps = [
+    createShellHost()
+], enableTailwind = true, bridge) {
+    const remotes = apps.filter((app)=>'shell' !== app.kind);
+    const shellHost = createShellHost(remotes);
     return {
         schemaVersion: 1,
-        default: 'enabled',
-        mode: 'diagnostic',
-        scope: 'ultramodern-generated-and-framework-owned',
-        report: {
-            script: "scripts/ultramodern-performance-readiness.mjs",
-            config: "scripts/ultramodern-performance-readiness.config.mjs",
-            defaultPath: '.codex/reports/performance-readiness/ultramodern-performance-readiness.json',
-            deterministic: true
-        },
-        optOut: {
-            env: 'ULTRAMODERN_PERFORMANCE_READINESS_DIAGNOSTICS=false',
-            config: {
-                path: "scripts/ultramodern-performance-readiness.config.mjs",
-                field: 'enabled',
-                value: false
-            }
-        },
-        failurePolicy: {
-            defaultFailOn: 'framework-invariant',
-            allowedValues: [
-                'framework-invariant',
-                'never'
-            ],
-            rejects: [
-                'accessibility-certification',
-                'product-ui-scoring',
-                'marketing-copy-scoring',
-                'broad-compliance-engine',
-                'rsdoctor-artifact-revival'
-            ]
+        profile: 'cloudflare-ssr-mf-effect-v1',
+        generator: {
+            package: '@modern-js/create',
+            version: modernVersion
         },
-        signals: [
-            {
-                id: 'bfcache',
-                title: 'BFCache diagnostics',
-                ownedCheck: 'generated-runtime-static-analysis',
-                invariant: 'Generated UltraModern files must not install beforeunload or unload handlers.'
-            },
-            {
-                id: 'core-web-vitals-rum',
-                title: 'Core Web Vitals/RUM readiness',
-                ownedCheck: 'preset-telemetry-contract',
-                invariant: 'UltraModern preset telemetry must remain enabled by default without requiring local collectors.'
+        workspace: {
+            packageScope: scope,
+            packageManager: {
+                name: 'pnpm',
+                version: PNPM_VERSION
             },
-            {
-                id: 'duplicate-prefetch-warmup',
-                title: 'Duplicate prefetch/warmup waste',
-                ownedCheck: 'topology-and-route-contract',
-                invariant: 'Generated route URLs, remote refs, and manifest URLs must stay deterministic and duplicate-free.'
-            },
-            {
-                id: 'cache-policy-sanity',
-                title: 'Cache policy sanity',
-                ownedCheck: 'generated-cloudflare-contract',
-                invariant: 'Generated Cloudflare contracts must retain CSS cache-control and public-surface cache expectations.'
-            },
-            {
-                id: 'save-data-behavior',
-                title: 'Save-Data behavior',
-                ownedCheck: 'framework-router-contract',
-                invariant: 'Automatic framework warmup must remain skippable by browser Save-Data policy.'
-            },
-            {
-                id: 'cloudflare-ssr-cache-hints',
-                title: 'Cloudflare SSR response and caching hints',
-                ownedCheck: 'generated-cloudflare-proof-contract',
-                invariant: 'Generated Cloudflare SSR proof routes and response/cache hint contracts must be present.'
+            node: {
+                version: NODE_VERSION,
+                engineRange: '>=26'
             }
-        ]
-    };
-}
-function cssLayerName(app) {
-    if ('shell' === app.kind) return 'ultramodern-shell-base';
-    return `ultramodern-vertical-${app.domain ?? app.id}`;
-}
-function cssRole(app) {
-    if ('shell' === app.kind) return 'shell-base-overlay';
-    return 'vertical-css';
-}
-function cssClassPrefix(app) {
-    return `${tailwindPrefixForApp(app)}:`;
-}
-function createCssDedupeContract(scope) {
-    return {
-        strategy: 'shared-token-package-plus-css-content-hash',
-        sharedPackage: packageName(scope, 'shared-design-tokens'),
-        sharedLayers: [
-            'ultramodern-shared-tokens'
-        ],
-        runtimeLoad: 'once-per-content-hash',
-        duplicateBaseStylesAllowed: false
-    };
-}
-function createCssSsrContract(app) {
-    return {
-        cloudflare: true,
-        firstPaintRequired: true,
-        linkEmission: 'modern-ssr-css-assets',
-        verticalCss: 'shell' === app.kind ? 'host-preloads-shell-and-shared-css' : 'federated-manifest-owned-css'
-    };
-}
-function createAppCssFederationContract(scope, app) {
-    const ownedLayers = 'shell' === app.kind ? [
-        'ultramodern-shell-base',
-        'ultramodern-shell-overlay'
-    ] : [
-        cssLayerName(app)
-    ];
-    return {
-        owner: {
-            id: app.id,
-            package: packageName(scope, app.packageSuffix),
-            team: app.ownership.team
         },
-        role: cssRole(app),
-        rootSelector: `[data-app-id="${app.id}"]`,
-        classPrefix: cssClassPrefix(app),
-        layers: {
-            shared: [
-                'ultramodern-shared-tokens'
-            ],
-            owned: ownedLayers,
-            imports: 'shell' === app.kind ? [
-                'ultramodern-shared-tokens'
-            ] : [
-                'ultramodern-shared-tokens'
-            ]
-        },
-        entrypoints: {
-            layoutImport: 'src/routes/layout.tsx',
-            css: [
-                'src/routes/index.css'
-            ],
-            ...'shell' !== app.kind ? {
-                federationEntry: 'src/federation-entry.tsx'
+        packageSource: {
+            strategy: packageSource.strategy,
+            modernPackageVersion: packageSource.modernPackageVersion,
+            ...packageSource.registry ? {
+                registry: packageSource.registry
+            } : {},
+            ...packageSource.aliasScope ? {
+                aliasScope: packageSource.aliasScope
+            } : {},
+            ...packageSource.aliasPackageNamePrefix ? {
+                aliasPackageNamePrefix: packageSource.aliasPackageNamePrefix
             } : {}
         },
-        assets: {
-            shared: [
-                `${packageName(scope, 'shared-design-tokens')}/tokens.css`
-            ],
-            owned: [
-                'src/routes/index.css'
-            ],
-            emittedBy: 'modern-rspack-css-extraction',
-            contentHash: true
+        features: {
+            tailwind: enableTailwind
         },
-        dedupe: createCssDedupeContract(scope),
-        ssr: createCssSsrContract(app)
-    };
-}
-function createCssFederationContract(scope) {
-    return {
-        schemaVersion: 1,
-        sharedDesignTokens: {
-            owner: {
-                id: 'shared-design-tokens',
-                package: packageName(scope, 'shared-design-tokens'),
-                team: 'super-app-platform'
-            },
-            role: 'shared-design-tokens',
-            rootSelector: ':root',
-            classPrefix: '--um-',
-            layers: {
-                owned: [
-                    'ultramodern-shared-tokens'
-                ]
-            },
-            entrypoints: {
-                css: [
-                    'packages/shared-design-tokens/src/tokens.css'
-                ],
-                typescript: [
-                    'packages/shared-design-tokens/src/index.ts'
-                ]
-            },
-            assets: {
-                exports: [
-                    './tokens.css'
-                ],
-                css: [
-                    'packages/shared-design-tokens/src/tokens.css'
-                ]
-            },
-            dedupe: createCssDedupeContract(scope),
-            ssr: {
-                cloudflare: true,
-                firstPaintRequired: true,
-                importedByApps: true
-            }
+        topology: {
+            source: './topology/reference-topology.json',
+            apps: apps.map((app)=>({
+                    id: app.id,
+                    kind: app.kind,
+                    package: packageName(scope, app.packageSuffix),
+                    packageSuffix: app.packageSuffix,
+                    displayName: app.displayName,
+                    path: app.directory,
+                    ...app.domain ? {
+                        domain: app.domain
+                    } : {},
+                    port: app.port,
+                    portEnv: app.portEnv,
+                    moduleFederation: {
+                        role: 'shell' === app.kind ? 'host' : 'remote',
+                        name: app.mfName,
+                        exposes: Object.keys(app.exposes ?? {}),
+                        ...'shell' === app.kind ? {
+                            verticalRefs: shellHost.verticalRefs,
+                            remotes: createModuleFederationRemoteContracts(shellHost, remotes)
+                        } : app.verticalRefs?.length ? {
+                            verticalRefs: app.verticalRefs,
+                            remotes: createModuleFederationRemoteContracts(app, remotes)
+                        } : {},
+                        ssr: true,
+                        dts: {
+                            compilerInstance: 'tsgo',
+                            tsConfigPath: './tsconfig.mf-types.json'
+                        }
+                    },
+                    ...app.effectApi ? {
+                        effectApi: {
+                            stem: app.effectApi.stem,
+                            prefix: app.effectApi.prefix,
+                            consumedBy: app.effectApi.consumedBy
+                        }
+                    } : {}
+                }))
         },
-        ownershipRules: {
-            shell: [
-                'base',
-                'overlay'
-            ],
-            verticals: [
-                'vertical-css'
-            ],
-            forbiddenVerticalLayers: [
-                'ultramodern-shell-base',
-                'ultramodern-shell-overlay'
+        bridge: bridge ?? {
+            enabled: false,
+            workspacePackages: [],
+            dependencies: [],
+            lockfilePolicy: 'nested',
+            gates: [],
+            reactSingletons: [
+                'react',
+                'react-dom'
             ]
-        }
-    };
-}
-function createStylingContract(scope, app, enableTailwind) {
-    return {
-        tailwind: enableTailwind,
-        ...enableTailwind ? {
-            postcssPlugins: [
-                '@tailwindcss/postcss'
-            ],
-            prefix: tailwindPrefixForApp(app),
-            source: '..',
-            sourceMode: 'source(none)'
-        } : {},
-        federation: createAppCssFederationContract(scope, app)
-    };
-}
-function createAppGeneratedContract(scope, app, apps, enableTailwind) {
-    const appWithResolvedRefs = 'shell' === app.kind ? {
-        ...app,
-        verticalRefs: apps.filter((candidate)=>'shell' !== candidate.kind).map((candidate)=>candidate.id)
-    } : app;
-    const publicWeb = createPublicWebAppArtifacts(app);
-    const consumedRemotes = createModuleFederationRemoteContracts(appWithResolvedRefs, apps);
-    return {
-        id: app.id,
-        package: packageName(scope, app.packageSuffix),
-        path: app.directory,
-        kind: app.kind,
-        config: createAppConfigContract(app),
-        styling: createStylingContract(scope, app, enableTailwind),
+        },
         deploy: {
-            target: 'cloudflare',
-            cloudflare: createCloudflareDeployContract(scope, app),
             worker: {
-                compatibilityDate: CLOUDFLARE_COMPATIBILITY_DATE,
-                name: createCloudflareWorkerName(scope, app),
-                security: createCloudflareSecurityContract(),
-                ssr: true
-            },
-            output: {
-                flat: true,
-                htmlDistPath: './'
-            }
-        },
-        ssr: {
-            mode: 'string',
-            moduleFederationAppSSR: true
-        },
-        i18n: {
-            plugin: '@modern-js/plugin-i18n',
-            backend: {
-                enabled: true,
-                loadPath: '/locales/{{lng}}/{{ns}}.json'
-            },
-            reactI18next: false,
-            languages: [
-                'en',
-                'cs'
-            ],
-            fallbackLanguage: 'en',
-            namespace: appI18nNamespace(app),
-            namespaces: [
-                appI18nNamespace(app),
-                'translation'
-            ],
-            publicDir: [
-                './locales',
-                './assets'
-            ],
-            localisedUrls: createLocalisedUrlsMap(app),
-            resourceOwnership: {
-                ownerAppId: app.id,
-                source: 'route-owned',
-                staticJson: `./locales/{lng}/${appI18nNamespace(app)}.json`
-            }
-        },
-        routes: {
-            source: 'route-owned',
-            metadataAuthoring: 'colocated-route-meta',
-            generatedManifest: true,
-            metadataExport: './src/routes/ultramodern-route-metadata',
-            localisedUrls: createLocalisedUrlsMap(app),
-            owned: createRouteOwnedI18nPaths(app),
-            publicRoutes: createPublicRouteMetadata(app),
-            privateByDefault: true,
-            publicnessDefault: 'private-app-screen',
-            generatedRouteMap: true,
-            manualOverrides: [],
-            publicHead: publicWeb.publicHead,
-            publicSurface: publicWeb.publicSurface
-        },
-        moduleFederation: {
-            name: app.mfName,
-            ...appWithResolvedRefs.verticalRefs?.length ? {
-                verticalRefs: appWithResolvedRefs.verticalRefs,
-                remotes: consumedRemotes
-            } : {},
-            exposes: Object.keys(app.exposes ?? {}),
-            dts: {
-                displayErrorInTerminal: true,
-                compilerInstance: 'tsgo'
-            },
-            browserSafeExposesOnly: true,
-            zephyrRspackPlugin: ZEPHYR_RSPACK_PLUGIN_VERSION
-        },
-        marker: {
-            appId: app.id,
-            packageName: packageName(scope, app.packageSuffix),
-            version: '0.1.0',
-            build: createBuildMarker(scope, app),
-            deployProfile: 'cloudflare-ssr-mf-effect-v1',
-            uiSurface: 'ui',
-            ...appHasEffectApi(app) ? {
-                apiSurface: 'effect-bff'
-            } : {}
-        },
-        ...appHasEffectApi(app) ? {
-            effect: {
-                runtime: 'effect',
-                import: '@modern-js/plugin-bff/effect-edge',
-                prefix: app.effectApi.prefix,
-                openapi: '/openapi.json',
-                workerEntry: 'worker/__modern_bff_effect.js',
-                contract: './shared/effect/api',
-                client: './effect/client',
-                readiness: createEffectReadinessContract(app),
-                requestContext: createEffectRequestContextContract(),
-                domainOperations: createEffectDomainOperations(app),
-                ...createEffectOperationContract(app)
-            }
-        } : {}
-    };
-}
-function createGeneratedContract(scope, apps = [
-    createShellHost()
-], enableTailwind = true) {
-    return {
-        schemaVersion: 1,
-        profile: 'cloudflare-ssr-mf-effect-v1',
-        packageManager: {
-            source: 'package.json',
-            manager: 'pnpm',
-            version: PNPM_VERSION,
-            toolchain: 'mise'
-        },
-        node: {
-            source: 'package.json engines.node and .mise.toml',
-            version: NODE_VERSION,
-            engineRange: '>=26',
-            toolchain: 'mise'
-        },
-        versions: {
-            typescript: TYPESCRIPT_NATIVE_PREVIEW_VERSION,
-            typescriptCompatibility: TYPESCRIPT_VERSION,
-            typescriptNativePreview: TYPESCRIPT_NATIVE_PREVIEW_VERSION,
-            moduleFederation: MODULE_FEDERATION_VERSION,
-            tanstackRouter: TANSTACK_ROUTER_VERSION,
-            i18next: I18NEXT_VERSION,
-            zephyrRspackPlugin: ZEPHYR_RSPACK_PLUGIN_VERSION,
-            zephyrAgent: ZEPHYR_AGENT_VERSION,
-            wrangler: WRANGLER_VERSION
-        },
-        performanceReadiness: createPerformanceReadinessContract(),
-        cssFederation: createCssFederationContract(scope),
-        apps: apps.map((app)=>createAppGeneratedContract(scope, app, apps, enableTailwind))
-    };
-}
-function createTemplateManifest(modernVersion, packageSource) {
-    return {
-        schemaVersion: 1,
-        template: {
-            id: 'modernjs-ultramodern-superapp-workspace',
-            version: modernVersion,
-            displayName: 'Modern.js UltraModern SuperApp Workspace',
-            description: 'Growable SuperApp shell, shared packages, and topology skeleton.',
-            compatibilityLane: 'ultramodern-mv',
-            minimumModernVersion: modernVersion
-        },
-        source: {
-            type: 'builtin',
-            name: 'modernjs-ultramodern-superapp-workspace',
-            repositoryPath: 'packages/toolkit/create/template-workspace',
-            generator: 'packages/toolkit/create/src/ultramodern-workspace/'
-        },
-        integrity: {
-            checksums: [
-                {
-                    algorithm: 'sha256',
-                    value: hashTemplateTree(workspaceTemplateDir),
-                    scope: 'source-tree'
+                wrangler: {
+                    compatibility_date: CLOUDFLARE_COMPATIBILITY_DATE,
+                    compatibility_flags: [
+                        'nodejs_compat',
+                        'global_fetch_strictly_public'
+                    ]
                 },
-                {
-                    algorithm: 'sha256',
-                    value: hashTemplateTree(fileTemplatesDir),
-                    scope: 'file-templates-tree'
-                }
-            ],
-            provenance: {
-                kind: 'repo-local',
-                issuer: '@modern-js/create',
-                subject: 'packages/toolkit/create/template-workspace'
+                artifacts: [],
+                publicAssetExcludes: []
             }
         },
-        materialization: {
-            targetRoot: 'generated-project-root',
-            allowedPaths: [
-                '.agents/**',
-                '.codex/**',
-                '.github/**',
-                '.gitignore',
-                '.mise.toml',
-                '.modernjs/**',
-                'AGENTS.md',
-                'README.md',
-                'apps/**',
-                'packages/**',
-                'lefthook.yml',
-                'package.json',
-                'oxfmt.config.ts',
-                'oxlint.config.ts',
-                'pnpm-workspace.yaml',
-                "scripts/**",
-                'topology/**',
-                'tsconfig.base.json'
-            ],
-            deniedPaths: [
-                '.git/**',
-                '.npmrc',
-                '.yarnrc',
-                '.env',
-                '.env.*',
-                'node_modules/**',
-                'dist/**'
-            ],
-            overwritePolicy: 'deny-existing'
-        },
-        packageSource: {
-            strategy: packageSource.strategy,
-            config: '.modernjs/ultramodern-package-source.json',
-            modernPackageSpecifier: modernPackageVersion(packageSource),
-            generatedWorkspacePackageSpecifier: WORKSPACE_PACKAGE_VERSION
+        moduleFederation: {
+            apps: apps.map((app)=>({
+                    id: app.id,
+                    path: app.directory,
+                    role: 'shell' === app.kind ? 'host' : 'remote',
+                    name: app.mfName,
+                    exposes: Object.keys(app.exposes ?? {}),
+                    hostOnly: 'shell' === app.kind && 0 === Object.keys(app.exposes ?? {}).length
+                }))
         },
         agentSkills: {
-            installDir: '.agents/skills',
-            source: {
-                repository: 'https://github.com/rstackjs/agent-skills',
-                commit: RSTACK_AGENT_SKILLS_COMMIT,
-                license: 'MIT',
-                licensePath: '.agents/rstackjs-agent-skills-LICENSE'
-            },
-            baseline: baselineAgentSkills,
-            moduleFederationSource: {
-                repository: 'https://github.com/module-federation/agent-skills',
-                commit: MODULE_FEDERATION_AGENT_SKILLS_COMMIT,
-                install: 'clone',
-                baseline: moduleFederationAgentSkills
-            },
-            privateSource: {
-                repository: 'https://github.com/TechsioCZ/skills',
-                install: 'clone-if-authorized',
-                baseline: privateAgentSkills
-            },
-            lockFile: '.agents/skills-lock.json'
-        },
-        validation: {
-            schemaValidation: true,
-            sourceValidation: [
-                'source-type-supported',
-                'checksum-verified',
-                'provenance-present'
-            ],
-            materializationValidation: [
-                'path-boundary-policy',
-                'path-boundary-denylist',
-                'no-path-traversal',
-                'no-absolute-paths',
-                'overwrite-policy-enforced'
-            ],
-            postMaterializationValidation: [
-                'ultramodern-workspace-contract-check',
-                'github-workflow-security-enforced',
-                'pnpm-11-policy-enforced',
-                'template-manifest-retained'
-            ],
-            expectedCommands: [
-                'mise install',
-                'pnpm install',
-                'pnpm run i18n:boundaries',
-                'pnpm run contract:check',
-                'pnpm run performance:readiness'
+            target: 'codex',
+            lockfile: './.codex/skills-lock.json',
+            installDir: './.codex/skills',
+            mode: 'repo-owned-default-on',
+            selfContainedVendoring: true,
+            optOutEnv: [
+                'ULTRAMODERN_SKIP_CODEX_SKILLS=1',
+                'ULTRAMODERN_CODEX_SKILLS=0'
             ]
+        },
+        tooling: {
+            command: 'modern-js-create ultramodern',
+            wrappers: {
+                validate: "scripts/validate-ultramodern-workspace.mjs",
+                typecheck: "scripts/ultramodern-typecheck.mjs",
+                mfTypes: "scripts/assert-mf-types.mjs",
+                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"
+            }
         }
     };
 }
-export { baselineAgentSkills, createAppConfigContract, createAppCssFederationContract, createAppGeneratedContract, createCssDedupeContract, createCssFederationContract, createCssSsrContract, createDevelopmentOverlay, createGeneratedContract, createOwnership, createPackageSourceMetadata, createPerformanceReadinessContract, createStylingContract, createTemplateManifest, createTopology, cssClassPrefix, cssLayerName, cssRole, moduleFederationAgentSkills, privateAgentSkills };
+export { createDevelopmentOverlay, createOwnership, createTopology, createUltramodernConfig };