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

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

@@ -0,0 +1,135 @@
+"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__, {
+    updateGeneratedToolchainFiles: ()=>updateGeneratedToolchainFiles,
+    updateRootPackageToolchain: ()=>updateRootPackageToolchain,
+    updateUltramodernConfigToolchain: ()=>updateUltramodernConfigToolchain
+});
+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 policy_cjs_namespaceObject = require("../../../ultramodern-workspace/policy.cjs");
+const { toolchain } = policy_cjs_namespaceObject.ULTRAMODERN_WORKSPACE_POLICY;
+const retiredRootToolingDependencies = [
+    "@typescript/typescript6"
+];
+function isRecord(value) {
+    return Boolean(value) && 'object' == typeof value && !Array.isArray(value);
+}
+function ensureRecord(parent, key, label) {
+    const value = parent[key];
+    if (void 0 === value) {
+        const created = {};
+        parent[key] = created;
+        return created;
+    }
+    if (!isRecord(value)) throw new Error(`${label} must be an object.`);
+    return value;
+}
+function updateUltramodernConfigToolchain(config) {
+    const workspace = ensureRecord(config, 'workspace', 'workspace');
+    const packageManager = ensureRecord(workspace, 'packageManager', 'workspace.packageManager');
+    packageManager.name = toolchain.packageManager.name;
+    packageManager.version = toolchain.packageManager.version;
+    const node = ensureRecord(workspace, 'node', 'workspace.node');
+    node.version = toolchain.node.version;
+    node.engineRange = toolchain.node.engineRange;
+}
+function updateRootPackageToolchain(packageJson) {
+    packageJson.packageManager = `${toolchain.packageManager.name}@${toolchain.packageManager.version}`;
+    const engines = ensureRecord(packageJson, 'engines', 'package.json engines');
+    engines.node = toolchain.node.engineRange;
+    engines.pnpm = toolchain.packageManager.engineRange;
+    const devDependencies = ensureRecord(packageJson, 'devDependencies', 'package.json devDependencies');
+    for (const packageName of retiredRootToolingDependencies)delete devDependencies[packageName];
+    devDependencies["@typescript/native"] = policy_cjs_namespaceObject.ULTRAMODERN_PACKAGE_PINS.rootDevDependencies["@typescript/native"];
+    devDependencies.miniflare = policy_cjs_namespaceObject.ULTRAMODERN_PACKAGE_PINS.rootDevDependencies.miniflare;
+}
+function updateMiseTools(content) {
+    const lines = content.replace(/\r\n/gu, '\n').split('\n');
+    if ('' === lines.at(-1)) lines.pop();
+    let toolsStart = lines.findIndex((line)=>/^\s*\[tools\]\s*(?:#.*)?$/u.test(line));
+    if (-1 === toolsStart) {
+        if (lines.length > 0) lines.push('');
+        toolsStart = lines.length;
+        lines.push('[tools]');
+    }
+    const nextSection = lines.findIndex((line, index)=>index > toolsStart && /^\s*\[[^\]]+\]\s*(?:#.*)?$/u.test(line));
+    let toolsEnd = -1 === nextSection ? lines.length : nextSection;
+    const upsertTool = (name, version)=>{
+        const pattern = new RegExp(`^\\s*${name}\\s*=`, 'u');
+        const line = `${name} = "${version}"`;
+        const indexes = lines.flatMap((candidate, candidateIndex)=>candidateIndex > toolsStart && candidateIndex < toolsEnd && pattern.test(candidate) ? [
+                candidateIndex
+            ] : []);
+        if (indexes.length > 1) throw new Error(`.mise.toml [tools] contains duplicate ${name} pins.`);
+        const index = indexes[0];
+        if (void 0 === index) {
+            lines.splice(toolsEnd, 0, line);
+            toolsEnd += 1;
+            return;
+        }
+        lines[index] = line;
+    };
+    upsertTool('node', toolchain.node.version);
+    upsertTool('pnpm', toolchain.packageManager.version);
+    return `${lines.join('\n')}\n`;
+}
+function updateGeneratedToolchainFiles(io) {
+    const misePath = external_node_path_default().join(io.workspaceRoot, '.mise.toml');
+    const miseContent = external_node_fs_default().existsSync(misePath) ? external_node_fs_default().readFileSync(misePath, 'utf-8') : '';
+    io.write(misePath, updateMiseTools(miseContent));
+    const workflowPath = external_node_path_default().join(io.workspaceRoot, '.github/workflows/ultramodern-workspace-gates.yml');
+    if (!external_node_fs_default().existsSync(workflowPath)) return;
+    const workflow = external_node_fs_default().readFileSync(workflowPath, 'utf-8');
+    const updatedWorkflow = workflow.replace(/^(\s*)node-version\s*:\s*.*$/mu, `$1node-version: '${toolchain.node.version}'`);
+    io.write(workflowPath, updatedWorkflow);
+}
+exports.updateGeneratedToolchainFiles = __webpack_exports__.updateGeneratedToolchainFiles;
+exports.updateRootPackageToolchain = __webpack_exports__.updateRootPackageToolchain;
+exports.updateUltramodernConfigToolchain = __webpack_exports__.updateUltramodernConfigToolchain;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "updateGeneratedToolchainFiles",
+    "updateRootPackageToolchain",
+    "updateUltramodernConfigToolchain"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

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

@@ -0,0 +1,454 @@
+"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 declaration_patches_cjs_namespaceObject = require("./migrate-strict-effect/declaration-patches.cjs");
+const dependency_usage_cjs_namespaceObject = require("./migrate-strict-effect/dependency-usage.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 react_router_retirement_cjs_namespaceObject = require("./migrate-strict-effect/react-router-retirement.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) && 'id' in 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);
+    (0, react_router_retirement_cjs_namespaceObject.preflightModuleFederationBridgeRouter)(io.workspaceRoot, (0, external_config_cjs_namespaceObject.allWorkspaceAppsFromToolingConfig)(current));
+    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.writeGenerated(external_node_path_default().join(io.workspaceRoot, artifact.relativePath), artifact.content);
+    }
+    io.writeGenerated(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);
+    const canRetireLegacyOxfmtCliExclusion = (0, generated_artifacts_cjs_namespaceObject.ensureGeneratedOxfmtIgnorePatterns)(io);
+    const rootScripts = (0, io_cjs_namespaceObject.readJsonFile)(external_node_path_default().join(io.workspaceRoot, 'package.json')).scripts;
+    const hasLegacyOxfmtCliExclusion = rootScripts && 'object' == typeof rootScripts && !Array.isArray(rootScripts) && Object.values(rootScripts).some((script)=>'string' == typeof script && /\boxfmt(?: --check)? \. '!repos\/\*\*'(?:\s*&&|$)/u.test(script));
+    if (hasLegacyOxfmtCliExclusion && !canRetireLegacyOxfmtCliExclusion) throw new Error("Cannot replace the legacy Oxfmt '!repos/**' CLI exclusion until oxfmt.config.ts has a static ignorePatterns array containing 'repos/**'.");
+    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);
+        const ownsGeneratedScripts = 'package.json' === relativePackageFile || allMigratedApps.some((app)=>`${app.directory}/package.json` === relativePackageFile);
+        (0, package_cohort_cjs_namespaceObject.updateGeneratedToolingDependencies)(packageJson, {
+            ownsGeneratedScripts
+        });
+        (0, package_cohort_cjs_namespaceObject.ensureBffEffectDependencies)(packageJson);
+        const retiredReactRouter = (0, react_router_retirement_cjs_namespaceObject.removeRetiredReactRouterDependency)(packageJson, external_node_path_default().join(io.workspaceRoot, external_node_path_default().dirname(relativePackageFile)));
+        if ('preserved' === retiredReactRouter) io.log(`${relativePackageFile} keeps its react-router dependency: authored source imports React Router directly, so its generated Module Federation config keeps bridge.enableBridgeRouter: true.`);
+        else if ('removed' === retiredReactRouter) io.log(`${relativePackageFile} dropped its obsolete react-router dependency: no authored source imports React Router.`);
+        (0, package_cohort_cjs_namespaceObject.updateGeneratedPackageScripts)(packageJson, {
+            relativePackageFile,
+            apps: allMigratedApps,
+            shellOnly,
+            canRetireLegacyOxfmtCliExclusion,
+            onPreserveScript: (scriptName)=>io.log(`${relativePackageFile} script ${JSON.stringify(scriptName)} was preserved: an existing command is mixed consumer/framework ownership.`)
+        });
+        (0, io_cjs_namespaceObject.writeJsonFile)(io, packageFile, packageJson);
+    }
+    (0, generated_artifacts_cjs_namespaceObject.updateGeneratedModernConfigs)(io, migrated);
+    (0, react_router_retirement_cjs_namespaceObject.ensureGeneratedModuleFederationBridgeRouterOptOut)(io, allMigratedApps);
+    (0, pnpm_policy_cjs_namespaceObject.updateGeneratedPnpmWorkspacePolicy)(io, packageSource, {
+        releaseCohort
+    });
+    (0, toolchain_pins_cjs_namespaceObject.updateGeneratedToolchainFiles)(io);
+    const drizzleOrmPatch = policy_cjs_namespaceObject.ULTRAMODERN_WORKSPACE_POLICY.pnpm.patchedDependencies.conditional.find((patch)=>'drizzle-orm' === patch.packageName);
+    (0, declaration_patches_cjs_namespaceObject.ensureGeneratedDeclarationPatches)(io, {
+        includeDrizzleOrmPatch: void 0 !== drizzleOrmPatch && (0, dependency_usage_cjs_namespaceObject.workspaceUsesDependency)(io.workspaceRoot, drizzleOrmPatch.packageName, drizzleOrmPatch.version)
+    });
+    (0, generated_artifacts_cjs_namespaceObject.ensureGeneratedOxlintComponentStyle)(io);
+    if (!skipInstall) return io.withStagedWorkspace((stagedWorkspaceRoot)=>{
+        external_node_fs_default().rmSync(external_node_path_default().join(stagedWorkspaceRoot, 'pnpm-lock.yaml'), {
+            force: true
+        });
+        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 runMigration = (io, migrationContext)=>io.transaction(()=>migrateStrictEffect(args, migrationContext, io, dryRun, skipInstall), {
+            commitWhen: (migrationResult)=>0 === migrationResult.status
+        });
+    const migration = dryRun ? (0, io_cjs_namespaceObject.withStagedDryRunMigrationIo)(context.workspaceRoot, (io)=>{
+        const invocationRelativePath = external_node_path_default().relative(context.workspaceRoot, context.invocationCwd);
+        const invocationIsOutsideWorkspace = '..' === invocationRelativePath || invocationRelativePath.startsWith(`..${external_node_path_default().sep}`) || external_node_path_default().isAbsolute(invocationRelativePath);
+        return runMigration(io, {
+            workspaceRoot: io.workspaceRoot,
+            invocationCwd: invocationIsOutsideWorkspace ? context.invocationCwd : external_node_path_default().join(io.workspaceRoot, invocationRelativePath)
+        });
+    }) : runMigration((0, io_cjs_namespaceObject.createMigrationIo)(context.workspaceRoot, false), context);
+    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
+});