@bleedingdev/modern-js-create 3.5.0-ultramodern.9 → 3.5.0-ultramodern.90

package/dist/cjs/ultramodern-tooling/commands/migrate-strict-effect.cjs

@@ -0,0 +1,425 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.n = (module)=>{
+        var getter = module && module.__esModule ? ()=>module['default'] : ()=>module;
+        __webpack_require__.d(getter, {
+            a: getter
+        });
+        return getter;
+    };
+})();
+(()=>{
+    __webpack_require__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    runMigrateStrictEffect: ()=>runMigrateStrictEffect
+});
+const external_node_fs_namespaceObject = require("node:fs");
+var external_node_fs_default = /*#__PURE__*/ __webpack_require__.n(external_node_fs_namespaceObject);
+const external_node_path_namespaceObject = require("node:path");
+var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_namespaceObject);
+const external_ultramodern_release_cohort_cjs_namespaceObject = require("../../ultramodern-release-cohort.cjs");
+const contracts_cjs_namespaceObject = require("../../ultramodern-workspace/contracts.cjs");
+const delivery_unit_stamp_cjs_namespaceObject = require("../../ultramodern-workspace/delivery-unit-stamp.cjs");
+const policy_cjs_namespaceObject = require("../../ultramodern-workspace/policy.cjs");
+const shells_cjs_namespaceObject = require("../../ultramodern-workspace/shells.cjs");
+const workspace_scripts_cjs_namespaceObject = require("../../ultramodern-workspace/workspace-scripts.cjs");
+const external_config_cjs_namespaceObject = require("../config.cjs");
+const api_metadata_cjs_namespaceObject = require("./migrate-strict-effect/api-metadata.cjs");
+const generated_artifacts_cjs_namespaceObject = require("./migrate-strict-effect/generated-artifacts.cjs");
+const help_cjs_namespaceObject = require("./migrate-strict-effect/help.cjs");
+const install_cjs_namespaceObject = require("./migrate-strict-effect/install.cjs");
+const io_cjs_namespaceObject = require("./migrate-strict-effect/io.cjs");
+const package_cohort_cjs_namespaceObject = require("./migrate-strict-effect/package-cohort.cjs");
+const package_source_cjs_namespaceObject = require("./migrate-strict-effect/package-source.cjs");
+const pnpm_policy_cjs_namespaceObject = require("./migrate-strict-effect/pnpm-policy.cjs");
+const toolchain_pins_cjs_namespaceObject = require("./migrate-strict-effect/toolchain-pins.cjs");
+const external_options_cjs_namespaceObject = require("./options.cjs");
+const retiredMetadataPaths = [
+    '.modernjs/ultramodern-generated-contract.json',
+    '.modernjs/ultramodern-package-source.json',
+    '.modernjs/ultramodern-workspace-template-manifest.json'
+];
+const rootPackageSourceOwnedKeys = [
+    ...policy_cjs_namespaceObject.ULTRAMODERN_WORKSPACE_POLICY.metadata.packageSource.ownedKeys,
+    'config'
+];
+function requireRecord(value, label) {
+    if (!value || 'object' != typeof value || Array.isArray(value)) throw new Error(`${label} must be an object.`);
+    return value;
+}
+function synchronizeMigrationDeliveryUnitMetadata(io, raw, packageSource) {
+    const normalized = (0, external_config_cjs_namespaceObject.normalizeCompactUltramodernConfig)(io.workspaceRoot, raw);
+    const apps = (0, external_config_cjs_namespaceObject.workspaceAppsFromToolingConfig)(normalized);
+    const appById = new Map(apps.map((app)=>[
+            app.id,
+            app
+        ]));
+    const scope = normalized.workspace.packageScope;
+    apps.filter((app)=>'shell' !== app.kind);
+    const primaryShell = apps.find((app)=>'shell' === app.kind);
+    const canonicalCompact = requireRecord((0, contracts_cjs_namespaceObject.createUltramodernConfig)(scope, packageSource.modernPackageVersion, packageSource, apps, normalized.features.tailwind, normalized.bridge, (0, external_config_cjs_namespaceObject.additionalShellsFromToolingConfig)(normalized), primaryShell), 'Generated compact config');
+    const canonicalCompactApps = new Map((canonicalCompact.topology?.apps ?? []).map((entry)=>[
+            String(entry.id),
+            entry
+        ]));
+    for (const entry of raw.topology?.apps ?? []){
+        if (!entry || 'object' != typeof entry || Array.isArray(entry)) continue;
+        const app = appById.get(String(entry.id));
+        if (app) {
+            (0, delivery_unit_stamp_cjs_namespaceObject.stampDeliveryUnitIdentity)(entry, scope, app);
+            const canonicalEntry = canonicalCompactApps.get(app.id);
+            if (canonicalEntry) {
+                entry.moduleFederation = canonicalEntry.moduleFederation;
+                entry.backendFederation = canonicalEntry.backendFederation;
+                entry.api = canonicalEntry.api;
+            }
+        }
+    }
+    (0, io_cjs_namespaceObject.writeJsonFile)(io, external_node_path_default().join(io.workspaceRoot, '.modernjs/ultramodern.json'), raw);
+    const topologyPath = external_node_path_default().join(io.workspaceRoot, 'topology/reference-topology.json');
+    if (!external_node_fs_default().existsSync(topologyPath)) return;
+    const topology = (0, io_cjs_namespaceObject.readJsonFile)(topologyPath);
+    const synchronizedConfig = (0, external_config_cjs_namespaceObject.normalizeCompactUltramodernConfig)(io.workspaceRoot, raw);
+    const synchronizedApps = (0, external_config_cjs_namespaceObject.workspaceAppsFromToolingConfig)(synchronizedConfig);
+    const synchronizedRemotes = synchronizedApps.filter((app)=>'shell' !== app.kind);
+    const synchronizedPrimaryShell = synchronizedApps.find((app)=>'shell' === app.kind);
+    const canonicalTopology = requireRecord((0, contracts_cjs_namespaceObject.createTopology)(scope, synchronizedRemotes, synchronizedPrimaryShell), 'Generated reference topology');
+    for (const key of [
+        'schemaVersion',
+        'id',
+        "description",
+        'preset',
+        'sharedPackages',
+        'validation'
+    ])topology[key] = canonicalTopology[key];
+    const canonicalTopologyApps = new Map([
+        canonicalTopology.shell,
+        ...canonicalTopology.verticals ?? []
+    ].map((entry)=>[
+            String(entry.id),
+            entry
+        ]));
+    for (const entry of [
+        topology.shell,
+        ...topology.verticals ?? []
+    ]){
+        if (!entry || 'object' != typeof entry || Array.isArray(entry)) continue;
+        const app = appById.get(String(entry.id));
+        if (app) {
+            (0, delivery_unit_stamp_cjs_namespaceObject.stampDeliveryUnitIdentity)(entry, scope, app);
+            const canonicalEntry = canonicalTopologyApps.get(app.id);
+            if (canonicalEntry) for (const key of [
+                'moduleFederation',
+                'backendFederation',
+                'api',
+                'cloudflare',
+                'ownership'
+            ])if (Object.hasOwn(canonicalEntry, key)) entry[key] = canonicalEntry[key];
+            else delete entry[key];
+        }
+    }
+    (0, io_cjs_namespaceObject.writeJsonFile)(io, topologyPath, topology);
+}
+const compactPolicyKeys = [
+    'schemaVersion',
+    'profile',
+    'workspace',
+    'features',
+    'deploy',
+    'moduleFederation',
+    'backendFederation',
+    'agentSkills',
+    'tooling'
+];
+function synchronizeMigrationCompactPolicy(io, raw, packageSource) {
+    const migrated = (0, external_config_cjs_namespaceObject.normalizeCompactUltramodernConfig)(io.workspaceRoot, raw);
+    const apps = (0, external_config_cjs_namespaceObject.workspaceAppsFromToolingConfig)(migrated);
+    apps.filter((app)=>'shell' !== app.kind);
+    const canonical = requireRecord((0, contracts_cjs_namespaceObject.createUltramodernConfig)(migrated.workspace.packageScope, packageSource.modernPackageVersion, packageSource, apps, migrated.features.tailwind, migrated.bridge, (0, external_config_cjs_namespaceObject.additionalShellsFromToolingConfig)(migrated), apps.find((app)=>'shell' === app.kind)), 'Generated compact policy');
+    for (const key of compactPolicyKeys)raw[key] = canonical[key];
+    (0, io_cjs_namespaceObject.writeJsonFile)(io, external_node_path_default().join(io.workspaceRoot, '.modernjs/ultramodern.json'), raw);
+}
+function reconcileRootPackageSourceMetadata(packageJson, packageSource) {
+    const modernjs = void 0 === packageJson.modernjs ? {} : requireRecord(packageJson.modernjs, 'package.json modernjs');
+    packageJson.modernjs = modernjs;
+    modernjs.packageSource = (0, api_metadata_cjs_namespaceObject.reconcilePackageSourceMetadata)(modernjs.packageSource, {
+        canonical: {
+            strategy: packageSource.strategy,
+            config: './.modernjs/ultramodern.json'
+        },
+        label: 'package.json modernjs.packageSource',
+        ownedKeys: rootPackageSourceOwnedKeys
+    });
+}
+function requireString(value, label) {
+    if ('string' != typeof value || 0 === value.length) throw new Error(`${label} must be a non-empty string.`);
+    return value;
+}
+function assertUnique(values, label) {
+    if (new Set(values).size !== values.length) throw new Error(`${label} contains duplicate identities.`);
+}
+function deriveValidationContractInputs(workspaceRoot, migrated, migratedApps) {
+    const rootPackage = (0, io_cjs_namespaceObject.readJsonFile)(external_node_path_default().join(workspaceRoot, 'package.json'));
+    const scope = requireString(rootPackage.name, 'Root package name');
+    if (migrated.workspace.packageScope !== scope) throw new Error(`Compact package scope ${migrated.workspace.packageScope} does not match root package ${scope}.`);
+    const topologyPath = external_node_path_default().join(workspaceRoot, 'topology/reference-topology.json');
+    if (!external_node_fs_default().existsSync(topologyPath)) throw new Error('Cannot render the migration validation contract without topology/reference-topology.json.');
+    const topology = (0, io_cjs_namespaceObject.readJsonFile)(topologyPath);
+    const shell = requireRecord(topology.shell, 'Reference topology shell');
+    if (!Array.isArray(topology.verticals)) throw new Error('Reference topology verticals must be an array.');
+    const verticals = topology.verticals.map((value, index)=>requireRecord(value, `Reference topology verticals[${index}]`));
+    const expectedApps = [
+        {
+            id: requireString(shell.id, 'Reference topology shell.id'),
+            kind: 'shell',
+            packageName: requireString(shell.package, 'Reference topology shell.package'),
+            path: void 0,
+            hasApi: false
+        },
+        ...verticals.map((vertical, index)=>({
+                id: requireString(vertical.id, `Reference topology verticals[${index}].id`),
+                kind: 'vertical',
+                packageName: requireString(vertical.package, `Reference topology verticals[${index}].package`),
+                path: requireString(vertical.path, `Reference topology verticals[${index}].path`),
+                hasApi: void 0 !== vertical.api
+            }))
+    ];
+    assertUnique(expectedApps.map((app)=>app.id), 'Reference topology app cohort');
+    assertUnique(expectedApps.map((app)=>app.packageName), 'Reference topology package cohort');
+    const migratedById = new Map(migratedApps.map((app)=>[
+            app.id,
+            app
+        ]));
+    assertUnique(migratedApps.map((app)=>app.id), 'Compact topology app cohort');
+    const expectedIds = expectedApps.map((app)=>app.id).sort();
+    const migratedIds = migratedApps.map((app)=>app.id).sort();
+    if (JSON.stringify(expectedIds) !== JSON.stringify(migratedIds)) throw new Error(`Compact topology app cohort ${migratedIds.join(', ')} does not match reference topology ${expectedIds.join(', ')}.`);
+    const appPackageFiles = (0, io_cjs_namespaceObject.listWorkspacePackageFiles)(workspaceRoot).filter((relativePath)=>relativePath.startsWith('apps/') || relativePath.startsWith('verticals/'));
+    const manifests = appPackageFiles.map((relativePath)=>({
+            relativePath,
+            packageJson: (0, io_cjs_namespaceObject.readJsonFile)(external_node_path_default().join(workspaceRoot, relativePath))
+        }));
+    const manifestsByName = new Map();
+    for (const manifest of manifests){
+        const name = requireString(manifest.packageJson.name, `${manifest.relativePath} name`);
+        if (manifestsByName.has(name)) throw new Error(`Duplicate workspace app package name ${name}.`);
+        manifestsByName.set(name, manifest);
+    }
+    const tailwindStates = [];
+    for (const expected of expectedApps){
+        const app = migratedById.get(expected.id);
+        if (!app || app.kind !== expected.kind) throw new Error(`Compact topology app ${expected.id} does not match reference kind ${expected.kind}.`);
+        if (Boolean(app.api) !== expected.hasApi) throw new Error(`Compact topology app ${expected.id} API presence does not match reference topology.`);
+        const manifest = manifestsByName.get(expected.packageName);
+        if (!manifest) throw new Error(`Reference topology package ${expected.packageName} has no workspace manifest.`);
+        const expectedManifestPath = `${app.directory}/package.json`;
+        if (manifest.relativePath !== expectedManifestPath) throw new Error(`${expected.packageName} is at ${manifest.relativePath}, expected ${expectedManifestPath}.`);
+        if (expected.path && expected.path !== app.directory) throw new Error(`Compact topology app ${expected.id} path ${app.directory} does not match reference path ${expected.path}.`);
+        tailwindStates.push(Object.hasOwn(requireRecord(manifest.packageJson.devDependencies ?? {}, `${manifest.relativePath} devDependencies`), '@rsbuild/plugin-tailwindcss'));
+    }
+    if (1 !== new Set(tailwindStates).size) throw new Error('Generated app package manifests disagree on the Tailwind feature state.');
+    const enableTailwind = tailwindStates[0] ?? false;
+    if (migrated.features.tailwind !== enableTailwind) throw new Error(`Compact Tailwind state ${migrated.features.tailwind} does not match package manifests ${enableTailwind}.`);
+    return {
+        scope,
+        enableTailwind,
+        remotes: migratedApps.filter((app)=>'shell' !== app.kind),
+        primaryShell: migratedApps.find((app)=>'shell' === app.kind),
+        additionalShells: (0, external_config_cjs_namespaceObject.additionalShellsFromToolingConfig)(migrated)
+    };
+}
+function reconcileAdditionalShellConfig(raw, migrated, migratedApps, io) {
+    const additionalShells = (0, external_config_cjs_namespaceObject.additionalShellsFromToolingConfig)(migrated);
+    if (0 === additionalShells.length) return migrated;
+    const existingShells = new Map((Array.isArray(raw.shells) ? raw.shells : []).filter((entry)=>null !== entry && 'object' == typeof entry && !Array.isArray(entry) && 'string' == typeof entry.id).map((entry)=>[
+            entry.id,
+            entry
+        ]));
+    const remotes = migratedApps.filter((app)=>'shell' !== app.kind);
+    raw.shells = additionalShells.map((shell)=>({
+            ...existingShells.get(shell.id),
+            ...(0, shells_cjs_namespaceObject.createAdditionalShellConfigEntry)(migrated.workspace.packageScope, shell, remotes)
+        }));
+    (0, io_cjs_namespaceObject.writeJsonFile)(io, external_node_path_default().join(io.workspaceRoot, '.modernjs/ultramodern.json'), raw);
+    return (0, external_config_cjs_namespaceObject.normalizeCompactUltramodernConfig)(io.workspaceRoot, raw);
+}
+function synchronizeMigrationDevelopmentOverlay(io, migrated, migratedApps) {
+    const overlayPath = external_node_path_default().join(io.workspaceRoot, 'topology/local-overlays/development.json');
+    const existing = external_node_fs_default().existsSync(overlayPath) ? requireRecord((0, io_cjs_namespaceObject.readJsonFile)(overlayPath), 'Development topology overlay') : {};
+    const canonical = requireRecord((0, contracts_cjs_namespaceObject.createDevelopmentOverlay)(migrated.workspace.packageScope, migratedApps.filter((app)=>'shell' !== app.kind)), 'Generated development topology overlay');
+    canonical.ports = Object.fromEntries(migratedApps.map((app)=>[
+            app.id,
+            app.port
+        ]));
+    const frameworkOwnedKeys = new Set(Object.keys(canonical));
+    const reconciled = Object.fromEntries(Object.entries(existing).filter(([key])=>!frameworkOwnedKeys.has(key)));
+    Object.assign(reconciled, canonical);
+    (0, io_cjs_namespaceObject.writeJsonFile)(io, overlayPath, reconciled);
+    return reconciled;
+}
+function migrateStrictEffect(args, context, io, dryRun, skipInstall) {
+    const compactPath = external_node_path_default().join(io.workspaceRoot, '.modernjs/ultramodern.json');
+    let raw;
+    if (external_node_fs_default().existsSync(compactPath)) raw = (0, io_cjs_namespaceObject.readJsonFile)(compactPath);
+    else {
+        const synthesized = (0, external_config_cjs_namespaceObject.synthesizeCompactUltramodernConfig)(io.workspaceRoot);
+        if (!synthesized) throw new Error("Missing .modernjs/ultramodern.json and no legacy UltraModern metadata (.modernjs/ultramodern-generated-contract.json) was found to synthesize it from.");
+        raw = synthesized.compact;
+        io.log(`Synthesized .modernjs/ultramodern.json from legacy metadata: ${synthesized.sources.join(', ')}.`);
+        if (synthesized.missing.length > 0) io.log(`Legacy metadata not found (using defaults): ${synthesized.missing.join(', ')}.`);
+    }
+    const current = (0, external_config_cjs_namespaceObject.normalizeCompactUltramodernConfig)(io.workspaceRoot, raw);
+    const packageSource = (0, package_source_cjs_namespaceObject.createMigrationPackageSource)(args, current);
+    const result = (status)=>({
+            status,
+            version: packageSource.modernPackageVersion
+        });
+    const releaseCohort = 'install' === packageSource.strategy ? (0, external_ultramodern_release_cohort_cjs_namespaceObject.readCreateReleaseCohort)() : void 0;
+    (0, api_metadata_cjs_namespaceObject.reconcileCompactPackageSourceMetadata)(raw.packageSource, packageSource);
+    reconcileRootPackageSourceMetadata((0, io_cjs_namespaceObject.readJsonFile)(external_node_path_default().join(io.workspaceRoot, 'package.json')), packageSource);
+    (0, pnpm_policy_cjs_namespaceObject.updateGeneratedPnpmWorkspacePolicy)((0, io_cjs_namespaceObject.createMigrationIo)(io.workspaceRoot, true), packageSource, {
+        releaseCohort
+    });
+    (0, api_metadata_cjs_namespaceObject.updateUltramodernConfig)(io, raw, packageSource);
+    if (releaseCohort) io.write(external_node_path_default().join(io.workspaceRoot, external_ultramodern_release_cohort_cjs_namespaceObject.RELEASE_COHORT_PROJECTION_PATH), `${JSON.stringify(releaseCohort, null, 2)}\n`);
+    (0, api_metadata_cjs_namespaceObject.updateReferenceTopology)(io);
+    synchronizeMigrationDeliveryUnitMetadata(io, raw, packageSource);
+    synchronizeMigrationCompactPolicy(io, raw, packageSource);
+    let migrated = (0, external_config_cjs_namespaceObject.normalizeCompactUltramodernConfig)(io.workspaceRoot, raw);
+    let migratedApps = (0, external_config_cjs_namespaceObject.workspaceAppsFromToolingConfig)(migrated);
+    migrated = reconcileAdditionalShellConfig(raw, migrated, migratedApps, io);
+    migratedApps = (0, external_config_cjs_namespaceObject.workspaceAppsFromToolingConfig)(migrated);
+    const allMigratedApps = (0, external_config_cjs_namespaceObject.allWorkspaceAppsFromToolingConfig)(migrated);
+    const developmentOverlay = synchronizeMigrationDevelopmentOverlay(io, migrated, allMigratedApps);
+    const validationContractInputs = deriveValidationContractInputs(io.workspaceRoot, migrated, migratedApps);
+    const verticalApps = migrated.topology.apps.filter((app)=>'shell' !== app.kind);
+    const hasBackendSurface = verticalApps.some((app)=>app.api);
+    const shellOnly = 0 === verticalApps.length;
+    if (shellOnly) {
+        io.log('Shell-only workspace: skipping backend-federation and Zerops runtime stages.');
+        for (const relativePath of [
+            "scripts/generate-node-backend-federation.mts",
+            "scripts/generate-node-backend-federation.mjs",
+            "scripts/proof-node-backend-federation.mts",
+            "scripts/proof-node-backend-federation.mjs",
+            "scripts/materialize-zerops-runtime.mjs",
+            'zerops.yaml'
+        ])(0, generated_artifacts_cjs_namespaceObject.removeGeneratedFileIfExists)(io, relativePath);
+    } else {
+        if (hasBackendSurface) {
+            (0, generated_artifacts_cjs_namespaceObject.removeStaleBackendFederationArtifacts)(io, migrated);
+            (0, generated_artifacts_cjs_namespaceObject.updateGeneratedBackendFederationContractFiles)(io, migrated);
+        } else for (const relativePath of [
+            "scripts/generate-node-backend-federation.mts",
+            "scripts/generate-node-backend-federation.mjs",
+            "scripts/proof-node-backend-federation.mts",
+            "scripts/proof-node-backend-federation.mjs"
+        ])(0, generated_artifacts_cjs_namespaceObject.removeGeneratedFileIfExists)(io, relativePath);
+        (0, generated_artifacts_cjs_namespaceObject.updateGeneratedZeropsArtifacts)(io, migrated);
+    }
+    for (const artifact of (0, workspace_scripts_cjs_namespaceObject.migratedWorkspaceScriptArtifacts)({
+        shellOnly,
+        hasBackendSurface
+    }))if ("scripts/validate-ultramodern-workspace.mts" !== artifact.relativePath) {
+        if (artifact.legacyPath) io.remove(external_node_path_default().join(io.workspaceRoot, artifact.legacyPath));
+        io.write(external_node_path_default().join(io.workspaceRoot, artifact.relativePath), artifact.content);
+    }
+    io.write(external_node_path_default().join(io.workspaceRoot, "scripts/validate-ultramodern-workspace.mts"), (0, workspace_scripts_cjs_namespaceObject.createWorkspaceValidationScript)(validationContractInputs.scope, validationContractInputs.enableTailwind, validationContractInputs.remotes, releaseCohort, validationContractInputs.additionalShells, validationContractInputs.primaryShell, raw, external_node_fs_default().existsSync(external_node_path_default().join(io.workspaceRoot, 'topology/ownership.json')) ? requireRecord((0, io_cjs_namespaceObject.readJsonFile)(external_node_path_default().join(io.workspaceRoot, 'topology/ownership.json')), 'Ownership topology') : void 0, developmentOverlay));
+    for (const relativePath of retiredMetadataPaths)io.remove(external_node_path_default().join(io.workspaceRoot, relativePath));
+    (0, generated_artifacts_cjs_namespaceObject.updateGeneratedBuildIdentityModules)(io, migrated);
+    (0, generated_artifacts_cjs_namespaceObject.updateGeneratedTypeScriptSurfaces)(io, migrated);
+    (0, generated_artifacts_cjs_namespaceObject.updateGeneratedModernConfigs)(io, migrated);
+    for (const relativePackageFile of (0, io_cjs_namespaceObject.listWorkspacePackageFiles)(io.workspaceRoot)){
+        const packageFile = external_node_path_default().join(io.workspaceRoot, relativePackageFile);
+        const packageJson = (0, io_cjs_namespaceObject.readJsonFile)(packageFile);
+        if ('package.json' === relativePackageFile) {
+            reconcileRootPackageSourceMetadata(packageJson, packageSource);
+            (0, toolchain_pins_cjs_namespaceObject.updateRootPackageToolchain)(packageJson);
+        }
+        (0, package_cohort_cjs_namespaceObject.updateModernDependencies)(packageJson, packageSource);
+        (0, package_cohort_cjs_namespaceObject.updateGeneratedToolingDependencies)(packageJson);
+        (0, package_cohort_cjs_namespaceObject.updateGeneratedPackageScripts)(packageJson, {
+            relativePackageFile,
+            apps: allMigratedApps,
+            shellOnly
+        });
+        (0, io_cjs_namespaceObject.writeJsonFile)(io, packageFile, packageJson);
+    }
+    (0, pnpm_policy_cjs_namespaceObject.updateGeneratedPnpmWorkspacePolicy)(io, packageSource, {
+        releaseCohort
+    });
+    (0, toolchain_pins_cjs_namespaceObject.updateGeneratedToolchainFiles)(io);
+    (0, pnpm_policy_cjs_namespaceObject.ensureGeneratedDeclarationPatches)(io, {
+        includeDrizzleOrmPatch: (0, pnpm_policy_cjs_namespaceObject.workspaceUsesDependency)(io.workspaceRoot, 'drizzle-orm')
+    });
+    (0, generated_artifacts_cjs_namespaceObject.ensureGeneratedOxfmtIgnorePatterns)(io);
+    if (!skipInstall) return io.withStagedWorkspace((stagedWorkspaceRoot)=>{
+        const status = (0, install_cjs_namespaceObject.runPnpmLockfileRefresh)({
+            ...context,
+            workspaceRoot: stagedWorkspaceRoot
+        });
+        if (0 !== status) return result(status);
+        return (0, pnpm_policy_cjs_namespaceObject.validateGeneratedPnpmLockReleaseAgePolicy)(stagedWorkspaceRoot, packageSource, {
+            releaseCohort
+        }).then(()=>{
+            io.write(external_node_path_default().join(io.workspaceRoot, 'pnpm-lock.yaml'), external_node_fs_default().readFileSync(external_node_path_default().join(stagedWorkspaceRoot, 'pnpm-lock.yaml'), 'utf-8'));
+            return result(0);
+        });
+    });
+    if (dryRun) {
+        for (const line of io.plan)process.stdout.write(`${line}\n`);
+        process.stdout.write(`[dry-run] migrate-strict-effect would migrate UltraModern strict Effect metadata to ${packageSource.modernPackageVersion}.\n`);
+    }
+    return result(0);
+}
+function runMigrateStrictEffect(args, context) {
+    if (args.includes('--help') || args.includes('-h')) {
+        process.stdout.write(help_cjs_namespaceObject.migrateStrictEffectHelp);
+        return 0;
+    }
+    const dryRun = (0, external_options_cjs_namespaceObject.hasFlag)(args, '--dry-run');
+    const skipInstall = dryRun || (0, external_options_cjs_namespaceObject.hasFlag)(args, '--skip-install');
+    const io = (0, io_cjs_namespaceObject.createMigrationIo)(context.workspaceRoot, dryRun);
+    const migration = io.transaction(()=>migrateStrictEffect(args, context, io, dryRun, skipInstall), {
+        commitWhen: (migrationResult)=>0 === migrationResult.status
+    });
+    const report = (migrationResult)=>{
+        if (0 === migrationResult.status && !dryRun) process.stdout.write(`UltraModern strict Effect metadata migrated to ${migrationResult.version}. Run pnpm api:check && pnpm contract:check next.\n`);
+        return migrationResult.status;
+    };
+    if (migration instanceof Promise) return migration.then(report);
+    return report(migration);
+}
+exports.runMigrateStrictEffect = __webpack_exports__.runMigrateStrictEffect;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "runMigrateStrictEffect"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/cjs/ultramodern-tooling/commands/options.cjs

@@ -0,0 +1,59 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+function readOption(args, name) {
+    const prefix = `${name}=`;
+    const inline = args.find((arg)=>arg.startsWith(prefix));
+    if (inline) {
+        const value = inline.slice(prefix.length);
+        if (!value) throw new Error(`${name} needs a value.`);
+        return value;
+    }
+    const index = args.indexOf(name);
+    if (-1 === index) return;
+    const value = args[index + 1];
+    if (!value || value.startsWith('--')) throw new Error(`${name} needs a value.`);
+    return value;
+}
+function hasFlag(args, name) {
+    return args.includes(name);
+}
+__webpack_require__.d(__webpack_exports__, {
+    hasFlag: ()=>hasFlag,
+    readOption: ()=>readOption
+});
+exports.hasFlag = __webpack_exports__.hasFlag;
+exports.readOption = __webpack_exports__.readOption;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "hasFlag",
+    "readOption"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/cjs/ultramodern-tooling/commands/routes-generate.cjs

@@ -0,0 +1,122 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.n = (module)=>{
+        var getter = module && module.__esModule ? ()=>module['default'] : ()=>module;
+        __webpack_require__.d(getter, {
+            a: getter
+        });
+        return getter;
+    };
+})();
+(()=>{
+    __webpack_require__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    runRoutesGenerate: ()=>runRoutesGenerate
+});
+const external_node_path_namespaceObject = require("node:path");
+var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_namespaceObject);
+const external_config_cjs_namespaceObject = require("../config.cjs");
+const external_context_cjs_namespaceObject = require("./context.cjs");
+const external_options_cjs_namespaceObject = require("./options.cjs");
+const resolveRoutesGenerateTargets = (args, context)=>{
+    const appId = (0, external_options_cjs_namespaceObject.readOption)(args, '--app');
+    const targets = (0, external_config_cjs_namespaceObject.workspaceAppsFromToolingConfig)((0, external_config_cjs_namespaceObject.readUltramodernConfig)(context.workspaceRoot)).filter((app)=>!appId || app.id === appId).map((app)=>({
+            label: app.id,
+            appDirectory: external_node_path_default().join(context.workspaceRoot, app.directory)
+        }));
+    if (0 === targets.length) throw new Error(`No generated UltraModern app matched ${appId ?? '<any>'}.`);
+    return targets;
+};
+const renderRoutesGenerateModule = ({ workspaceRoot, targets })=>`
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+
+const workspaceRoot = ${JSON.stringify(workspaceRoot)};
+const targets = ${JSON.stringify(targets, null, 2)};
+const appRequire = createRequire(path.join(workspaceRoot, 'package.json'));
+const pluginUrl = pathToFileURL(
+  appRequire.resolve('@modern-js/plugin-tanstack'),
+).href;
+const { generateTanstackRouteArtifacts } = await import(pluginUrl);
+
+let failed = false;
+// Sequential — the app-tools cli singleton is not re-entrant.
+for (const target of targets) {
+  try {
+    await generateTanstackRouteArtifacts({ appDirectory: target.appDirectory });
+    console.log(\`[ultramodern] TanStack route artifacts generated: \${target.label}\`);
+  } catch (error) {
+    failed = true;
+    console.error(\`[ultramodern] TanStack route generation failed: \${target.label}\`);
+    // Print the full underlying failure, including the cause chain. The
+    // route-generate crash is often an opaque node error thrown deep inside
+    // app-tools/plugin (e.g. a path TypeError), so surfacing only
+    // \`error.message\` swallows the stack that points at the real culprit.
+    let current = error;
+    let depth = 0;
+    while (current) {
+      const label = depth === 0 ? '-' : '  caused by:';
+      const detail =
+        current instanceof Error
+          ? current.stack ?? \`\${current.name}: \${current.message}\`
+          : String(current);
+      console.error(\`\${label} \${detail}\`);
+      current = current instanceof Error ? current.cause : undefined;
+      depth += 1;
+    }
+  }
+}
+
+process.exit(failed ? 1 : 0);
+`;
+function runRoutesGenerate(args, context) {
+    if (args.includes('--help') || args.includes('-h')) {
+        process.stdout.write(`Usage:
+  modern-js-create ultramodern routes-generate [--app <id>]
+
+Regenerates TanStack route artifacts (router.gen.ts, register.gen.d.ts) for
+generated UltraModern apps without running dev or build. Without --app, every
+generated workspace app is regenerated.
+`);
+        return 0;
+    }
+    const source = renderRoutesGenerateModule({
+        workspaceRoot: context.workspaceRoot,
+        targets: resolveRoutesGenerateTargets(args, context)
+    });
+    return (0, external_context_cjs_namespaceObject.runRenderedModule)(source, context);
+}
+exports.runRoutesGenerate = __webpack_exports__.runRoutesGenerate;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "runRoutesGenerate"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/cjs/ultramodern-tooling/commands/skills.cjs

@@ -0,0 +1,49 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    runSkills: ()=>runSkills
+});
+const external_context_cjs_namespaceObject = require("./context.cjs");
+function runSkills(args, context) {
+    const [subcommand, ...rest] = args;
+    if ('install' === subcommand) return (0, external_context_cjs_namespaceObject.spawnNodeScript)("template-workspace/scripts/bootstrap-agent-skills.mjs", rest, context);
+    if ('check' === subcommand) return (0, external_context_cjs_namespaceObject.spawnNodeScript)("template-workspace/scripts/bootstrap-agent-skills.mjs", [
+        '--check',
+        ...rest
+    ], context);
+    throw new Error('Usage: modern-js-create ultramodern skills <install|check>');
+}
+exports.runSkills = __webpack_exports__.runSkills;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "runSkills"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});