@bleedingdev/modern-js-create 3.5.0-ultramodern.3 → 3.5.0-ultramodern.31

package/dist/esm/index.js

@@ -1,570 +1,17 @@
-import { execFileSync } from "node:child_process";
 import node_fs from "node:fs";
 import node_path from "node:path";
-import node_readline from "node:readline";
-import { fileURLToPath } from "node:url";
-import { resolveCreatePackageRoot } from "./create-package-root.js";
+import { DRY_RUN_FLAG, VERTICAL_FLAG, detectBffRuntime, detectCodeSmithOverlays, detectDryRunFlag, detectExplicitTailwindFlag, detectLanguage, detectLegacyModernJsFlag, detectTailwindFlag, readBridgeCliOptions, resolveVerticalCliInput } from "./cli/flags.js";
+import { showHelp, showVersion } from "./cli/help.js";
+import { detectUltramodernPackageSource, getBleedingDevFrameworkVersion, isBleedingDevCreatePackage, readCreatePackageJson, resolveWorkspacePackageSource } from "./cli/package-source.js";
+import { initializeGeneratedGitRepository } from "./cli/project-setup.js";
+import { confirmLegacyModernJsSetup, getProjectName } from "./cli/prompts.js";
 import { i18n, localeKeys } from "./locale/index.js";
-import { BLEEDINGDEV_CREATE_PACKAGE, BLEEDINGDEV_FRAMEWORK_VERSION_ENV, BLEEDINGDEV_PACKAGE_NAME_PREFIX, BLEEDINGDEV_PACKAGE_SCOPE, WORKSPACE_PACKAGE_VERSION } from "./ultramodern-package-source.js";
 import { runUltramodernToolingCli } from "./ultramodern-tooling/commands.js";
 import { addUltramodernVertical, generateUltramodernWorkspace, planUltramodernVertical } from "./ultramodern-workspace/index.js";
-import { hasUltramodernBridgeCliOptions, parseUltramodernBridgeCliOptions, ultramodernBridgeCliBooleanFlags, ultramodernBridgeCliValueFlags } from "./ultramodern-workspace/bridge-config.js";
-const src_dirname = node_path.dirname(fileURLToPath(import.meta.url));
-const createPackageRoot = resolveCreatePackageRoot(src_dirname);
-const semverPattern = /^(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/;
-const LEGACY_MODERN_JS_FLAG = '--legacy-modern-js';
-const LEGACY_MODERN_JS_CONFIRMATION = 'USE LEGACY MODERN.JS';
-const WORKSPACE_PROTOCOL_FLAG = '--workspace';
-const DRY_RUN_FLAG = '--dry-run';
-const VERTICAL_FLAG = '--vertical';
-const VERTICAL_NAME_FLAG = '--vertical-name';
-const CODESMITH_OVERLAY_FLAG = '--codesmith-overlay';
-const BFF_FLAG = '--bff';
-const BFF_RUNTIME_OPTION = '--bff-runtime';
-const SUPPORTED_BFF_RUNTIMES = [
-    'effect'
-];
-const REGISTRY_LOOKUP_TIMEOUT_MS = 15000;
-function getOptionValue(args, names) {
-    for (const name of names){
-        const prefix = `${name}=`;
-        const byEquals = args.find((arg)=>arg.startsWith(prefix));
-        if (byEquals) return byEquals.slice(prefix.length);
-        const index = args.findIndex((arg)=>arg === name);
-        if (-1 !== index && args[index + 1] && !args[index + 1].startsWith('-')) return args[index + 1];
-    }
-}
-const detectLanguage = ()=>{
-    const lang = getOptionValue(process.argv.slice(2), [
-        '--lang',
-        '-l'
-    ]);
-    if ('zh' === lang) return 'zh';
-    return 'en';
-};
+import { hasUltramodernBridgeCliOptions } from "./ultramodern-workspace/bridge-config.js";
 i18n.changeLanguage({
     locale: detectLanguage()
 });
-function readCreatePackageJson() {
-    const createPackageJson = node_path.join(createPackageRoot, 'package.json');
-    return JSON.parse(node_fs.readFileSync(createPackageJson, 'utf-8'));
-}
-function isBleedingDevCreatePackage(createPackage) {
-    return createPackage.name === BLEEDINGDEV_CREATE_PACKAGE;
-}
-function getBleedingDevFrameworkVersion(createPackage, fallbackVersion) {
-    const frameworkVersion = createPackage.ultramodern?.frameworkVersion;
-    return 'string' == typeof frameworkVersion && frameworkVersion.length > 0 ? frameworkVersion : fallbackVersion;
-}
-function showVersion() {
-    const createPackage = readCreatePackageJson();
-    const name = createPackage.name || '@modern-js/create';
-    const version = createPackage.version || 'unknown';
-    console.log(i18n.t(localeKeys.version.message, {
-        name,
-        version
-    }));
-    process.exit(0);
-}
-function showHelp() {
-    console.log(i18n.t(localeKeys.help.title));
-    console.log(i18n.t(localeKeys.help.description));
-    console.log('');
-    console.log(i18n.t(localeKeys.help.usage));
-    console.log(i18n.t(localeKeys.help.usageExample));
-    console.log('');
-    console.log(i18n.t(localeKeys.help.options));
-    console.log(i18n.t(localeKeys.help.optionHelp));
-    console.log(i18n.t(localeKeys.help.optionVersion));
-    console.log(i18n.t(localeKeys.help.optionLang));
-    console.log(i18n.t(localeKeys.help.optionTailwind));
-    console.log(i18n.t(localeKeys.help.optionBff));
-    console.log(i18n.t(localeKeys.help.optionBffRuntime));
-    console.log(i18n.t(localeKeys.help.optionWorkspace));
-    console.log(i18n.t(localeKeys.help.optionUltramodernPackageSource));
-    console.log(i18n.t(localeKeys.help.optionUltramodernPackageVersion));
-    console.log(i18n.t(localeKeys.help.optionUltramodernPackageRegistry));
-    console.log(i18n.t(localeKeys.help.optionUltramodernPackageScope));
-    console.log(i18n.t(localeKeys.help.optionUltramodernPackageNamePrefix));
-    console.log(i18n.t(localeKeys.help.optionBridge));
-    console.log(i18n.t(localeKeys.help.optionBridgeParentRoot));
-    console.log(i18n.t(localeKeys.help.optionBridgeWorkspacePackage));
-    console.log(i18n.t(localeKeys.help.optionBridgeWorkspacePackageName));
-    console.log(i18n.t(localeKeys.help.optionBridgeTestAlias));
-    console.log(i18n.t(localeKeys.help.optionBridgeDependency));
-    console.log(i18n.t(localeKeys.help.optionBridgeLockfilePolicy));
-    console.log(i18n.t(localeKeys.help.optionBridgeGate));
-    console.log(i18n.t(localeKeys.help.optionBridgeGateCwd));
-    console.log(i18n.t(localeKeys.help.optionBridgeReactSingleton));
-    console.log(i18n.t(localeKeys.help.optionVertical));
-    console.log(i18n.t(localeKeys.help.optionVerticalName));
-    console.log(i18n.t(localeKeys.help.optionDryRun));
-    console.log(i18n.t(localeKeys.help.optionCodeSmithOverlay));
-    console.log(i18n.t(localeKeys.help.optionLegacyModernJs));
-    console.log('');
-    console.log(i18n.t(localeKeys.help.examples));
-    console.log(i18n.t(localeKeys.help.example1));
-    console.log(i18n.t(localeKeys.help.example2));
-    console.log(i18n.t(localeKeys.help.example3));
-    console.log(i18n.t(localeKeys.help.example4));
-    console.log(i18n.t(localeKeys.help.example5));
-    console.log(i18n.t(localeKeys.help.example6));
-    console.log(i18n.t(localeKeys.help.example7));
-    console.log(i18n.t(localeKeys.help.example8));
-    console.log(i18n.t(localeKeys.help.example9));
-    console.log(i18n.t(localeKeys.help.example10));
-    console.log('');
-    console.log(i18n.t(localeKeys.help.moreInfo));
-    console.log('');
-    process.exit(0);
-}
-function promptInput(question) {
-    const rl = node_readline.createInterface({
-        input: process.stdin,
-        output: process.stdout
-    });
-    return new Promise((resolve)=>{
-        rl.question(question, (answer)=>{
-            rl.close();
-            resolve(answer.trim());
-        });
-    });
-}
-function detectLegacyModernJsFlag(args) {
-    if (args.some((arg)=>arg.startsWith(`${LEGACY_MODERN_JS_FLAG}=`))) {
-        console.error(`${LEGACY_MODERN_JS_FLAG} does not accept a value.`);
-        process.exit(1);
-    }
-    return args.includes(LEGACY_MODERN_JS_FLAG);
-}
-function stripLegacyModernJsArgs(args) {
-    return args.filter((arg)=>arg !== LEGACY_MODERN_JS_FLAG);
-}
-async function confirmLegacyModernJsSetup() {
-    console.error('');
-    console.error(i18n.t(localeKeys.message.legacyModernJsWarning));
-    console.error('');
-    const answer = await promptInput(i18n.t(localeKeys.prompt.legacyModernJsConfirmation, {
-        confirmation: LEGACY_MODERN_JS_CONFIRMATION
-    }));
-    if (answer !== LEGACY_MODERN_JS_CONFIRMATION) {
-        console.error(i18n.t(localeKeys.error.legacyModernJsNotConfirmed));
-        process.exit(1);
-    }
-}
-function delegateLegacyModernJsSetup(args) {
-    const forwardedArgs = stripLegacyModernJsArgs(args);
-    if (commandExists('pnpm')) return void runSetupCommand('pnpm', [
-        'dlx',
-        '@modern-js/create',
-        ...forwardedArgs
-    ], {
-        stdio: 'inherit'
-    });
-    if (commandExists('npx')) return void runSetupCommand('npx', [
-        '@modern-js/create',
-        ...forwardedArgs
-    ], {
-        stdio: 'inherit'
-    });
-    throw new Error('Legacy Modern.js setup requires pnpm or npx to run @modern-js/create.');
-}
-function detectBffRuntime(args) {
-    if (args.some((arg)=>arg.startsWith(`${BFF_FLAG}=`))) {
-        console.error(`${BFF_FLAG} does not accept a value. Use: ${BFF_RUNTIME_OPTION} <runtime>`);
-        process.exit(1);
-    }
-    const runtimeRequested = args.some((arg)=>arg === BFF_RUNTIME_OPTION || arg.startsWith(`${BFF_RUNTIME_OPTION}=`));
-    if (!runtimeRequested) return 'effect';
-    const runtime = getOptionValue(args, [
-        BFF_RUNTIME_OPTION
-    ]);
-    if (!runtime) {
-        console.error(`${BFF_RUNTIME_OPTION} requires a value (supported: ${SUPPORTED_BFF_RUNTIMES.join(', ')})`);
-        process.exit(1);
-    }
-    if (!SUPPORTED_BFF_RUNTIMES.includes(runtime)) {
-        console.error(`Unsupported BFF runtime "${runtime}". UltraModern workspaces scaffold a strict Effect API runtime for every MicroVertical (supported: ${SUPPORTED_BFF_RUNTIMES.join(', ')}).`);
-        process.exit(1);
-    }
-    return runtime;
-}
-function detectTailwindFlag() {
-    const args = process.argv.slice(2);
-    return !args.includes('--no-tailwind');
-}
-function detectExplicitTailwindFlag() {
-    const args = process.argv.slice(2);
-    if (args.includes('--no-tailwind')) return false;
-    if (args.includes('--tailwind')) return true;
-}
-function collectPositionalArgs(args) {
-    const optionWithValue = new Set([
-        '--lang',
-        '-l',
-        BFF_RUNTIME_OPTION,
-        '--ultramodern-package-source',
-        '--ultramodern-package-version',
-        '--ultramodern-package-registry',
-        '--ultramodern-package-scope',
-        '--ultramodern-package-name-prefix',
-        VERTICAL_NAME_FLAG,
-        CODESMITH_OVERLAY_FLAG,
-        ...ultramodernBridgeCliValueFlags
-    ]);
-    const optionWithoutValue = new Set([
-        '--help',
-        '-h',
-        '--version',
-        '-v',
-        '--tailwind',
-        '--no-tailwind',
-        BFF_FLAG,
-        WORKSPACE_PROTOCOL_FLAG,
-        DRY_RUN_FLAG,
-        VERTICAL_FLAG,
-        LEGACY_MODERN_JS_FLAG,
-        ...ultramodernBridgeCliBooleanFlags
-    ]);
-    const positionalArgs = [];
-    for(let i = 0; i < args.length; i++){
-        const arg = args[i];
-        if (!optionWithoutValue.has(arg)) {
-            if (optionWithValue.has(arg)) {
-                i += 1;
-                continue;
-            }
-            if (!(arg.startsWith('--lang=') || arg.startsWith(`${BFF_RUNTIME_OPTION}=`) || arg.startsWith('--ultramodern-package-source=') || arg.startsWith('--ultramodern-package-version=') || arg.startsWith('--ultramodern-package-registry=') || arg.startsWith('--ultramodern-package-scope=') || arg.startsWith('--ultramodern-package-name-prefix=') || arg.startsWith(`${VERTICAL_FLAG}=`) || arg.startsWith(`${VERTICAL_NAME_FLAG}=`) || arg.startsWith(`${CODESMITH_OVERLAY_FLAG}=`) || ultramodernBridgeCliBooleanFlags.some((flag)=>arg.startsWith(`${flag}=`)) || ultramodernBridgeCliValueFlags.some((flag)=>arg.startsWith(`${flag}=`)))) positionalArgs.push(arg);
-        }
-    }
-    return positionalArgs;
-}
-function readRequiredVerticalNameValue(args, index) {
-    const value = args[index + 1];
-    if (!value || value.startsWith('-')) {
-        console.error(i18n.t(localeKeys.error.verticalNameMissing));
-        process.exit(1);
-    }
-    return value;
-}
-function resolveVerticalCliInput(args) {
-    const candidates = [];
-    let addVertical = false;
-    for(let i = 0; i < args.length; i++){
-        const arg = args[i];
-        if (arg === VERTICAL_FLAG) {
-            addVertical = true;
-            continue;
-        }
-        if (arg.startsWith(`${VERTICAL_FLAG}=`)) {
-            addVertical = true;
-            candidates.push({
-                value: arg.slice(`${VERTICAL_FLAG}=`.length),
-                source: `${VERTICAL_FLAG}=<name>`
-            });
-            continue;
-        }
-        if (arg === VERTICAL_NAME_FLAG) {
-            addVertical = true;
-            candidates.push({
-                value: readRequiredVerticalNameValue(args, i),
-                source: VERTICAL_NAME_FLAG
-            });
-            i += 1;
-            continue;
-        }
-        if (arg.startsWith(`${VERTICAL_NAME_FLAG}=`)) {
-            addVertical = true;
-            candidates.push({
-                value: arg.slice(`${VERTICAL_NAME_FLAG}=`.length),
-                source: `${VERTICAL_NAME_FLAG}=<name>`
-            });
-        }
-    }
-    if (!addVertical) return {
-        addVertical: false
-    };
-    const positionalArgs = collectPositionalArgs(args);
-    if (positionalArgs.length > 1) {
-        console.error(`Unexpected positional argument: ${positionalArgs[1]}`);
-        process.exit(1);
-    }
-    if (positionalArgs[0]) candidates.push({
-        value: positionalArgs[0],
-        source: 'positional argument'
-    });
-    const emptyCandidate = candidates.find((candidate)=>'' === candidate.value);
-    if (!candidates.length || emptyCandidate) {
-        console.error(i18n.t(localeKeys.error.verticalNameMissing));
-        process.exit(1);
-    }
-    const [firstCandidate] = candidates;
-    const disagreement = candidates.find((candidate)=>candidate.value !== firstCandidate.value);
-    if (disagreement) {
-        console.error(i18n.t(localeKeys.error.verticalNameAmbiguous, {
-            firstName: firstCandidate.value,
-            firstSource: firstCandidate.source,
-            secondName: disagreement.value,
-            secondSource: disagreement.source
-        }));
-        process.exit(1);
-    }
-    return {
-        addVertical: true,
-        name: firstCandidate.value
-    };
-}
-function detectDryRunFlag(args) {
-    if (args.some((arg)=>arg.startsWith(`${DRY_RUN_FLAG}=`))) {
-        console.error(`${DRY_RUN_FLAG} does not accept a value.`);
-        process.exit(1);
-    }
-    return args.includes(DRY_RUN_FLAG);
-}
-function detectCodeSmithOverlays(args) {
-    const overlays = [];
-    for(let i = 0; i < args.length; i++){
-        const arg = args[i];
-        if (arg === CODESMITH_OVERLAY_FLAG) {
-            const generator = args[i + 1];
-            if (!generator || generator.startsWith('-')) {
-                console.error(`${CODESMITH_OVERLAY_FLAG} requires a package or path.`);
-                process.exit(1);
-            }
-            overlays.push({
-                generator
-            });
-            i += 1;
-            continue;
-        }
-        if (arg.startsWith(`${CODESMITH_OVERLAY_FLAG}=`)) {
-            const generator = arg.slice(`${CODESMITH_OVERLAY_FLAG}=`.length);
-            if (!generator) {
-                console.error(`${CODESMITH_OVERLAY_FLAG} requires a package or path.`);
-                process.exit(1);
-            }
-            overlays.push({
-                generator
-            });
-        }
-    }
-    return overlays.length > 0 ? overlays : void 0;
-}
-function readBridgeCliOptions(args) {
-    try {
-        return parseUltramodernBridgeCliOptions(args);
-    } catch (error) {
-        console.error(error instanceof Error ? error.message : String(error));
-        process.exit(1);
-    }
-}
-function detectUltramodernPackageSource(args, defaultPackageVersion, createPackage) {
-    const bleedingDevDefaults = isBleedingDevCreatePackage(createPackage);
-    const strategy = getOptionValue(args, [
-        '--ultramodern-package-source'
-    ]) ?? (bleedingDevDefaults ? 'install' : 'workspace');
-    if ('workspace' !== strategy && 'install' !== strategy) {
-        console.error('--ultramodern-package-source must be "workspace" or "install"');
-        process.exit(1);
-    }
-    const packageSourceStrategy = strategy;
-    const explicitRegistry = getOptionValue(args, [
-        '--ultramodern-package-registry'
-    ]);
-    const aliasScope = getOptionValue(args, [
-        '--ultramodern-package-scope'
-    ]) ?? (bleedingDevDefaults && 'install' === packageSourceStrategy && !explicitRegistry ? BLEEDINGDEV_PACKAGE_SCOPE : void 0);
-    return {
-        strategy: packageSourceStrategy,
-        modernPackageVersion: getOptionValue(args, [
-            '--ultramodern-package-version'
-        ]) ?? defaultPackageVersion,
-        registry: explicitRegistry,
-        aliasScope,
-        aliasPackageNamePrefix: getOptionValue(args, [
-            '--ultramodern-package-name-prefix'
-        ]) ?? (aliasScope ? BLEEDINGDEV_PACKAGE_NAME_PREFIX : void 0)
-    };
-}
-function hasExplicitUltramodernPackageSource(args, value) {
-    const configuredValue = getOptionValue(args, [
-        '--ultramodern-package-source'
-    ]);
-    return value ? configuredValue === value : void 0 !== configuredValue;
-}
-function readBleedingDevFrameworkVersionFromRegistry(fallbackVersion) {
-    const envVersion = process.env[BLEEDINGDEV_FRAMEWORK_VERSION_ENV]?.trim();
-    if (envVersion) {
-        if (!semverPattern.test(envVersion)) {
-            console.error(`${BLEEDINGDEV_FRAMEWORK_VERSION_ENV} must be a valid semver version`);
-            process.exit(1);
-        }
-        return envVersion;
-    }
-    try {
-        const rawVersion = runSetupCommand('npm', [
-            'view',
-            `${BLEEDINGDEV_CREATE_PACKAGE}@latest`,
-            'ultramodern.frameworkVersion',
-            '--json'
-        ], {
-            timeoutMs: REGISTRY_LOOKUP_TIMEOUT_MS
-        }).trim();
-        const version = JSON.parse(rawVersion);
-        if ('string' == typeof version && semverPattern.test(version)) return version;
-    } catch  {}
-    console.warn([
-        `Could not resolve ${BLEEDINGDEV_CREATE_PACKAGE}@latest ultramodern.frameworkVersion from the npm registry.`,
-        `Falling back to the packaged framework version ${fallbackVersion}.`,
-        `Pass ${WORKSPACE_PROTOCOL_FLAG} to use local workspace protocol dependencies,`,
-        'or pass --ultramodern-package-version with the exact BleedingDev framework cohort.'
-    ].join(' '));
-    return fallbackVersion;
-}
-function resolveInstallBackedPackageSource(args, createPackage, packageSource) {
-    const explicitVersion = getOptionValue(args, [
-        '--ultramodern-package-version'
-    ]);
-    const explicitRegistry = getOptionValue(args, [
-        '--ultramodern-package-registry'
-    ]);
-    const aliasScope = getOptionValue(args, [
-        '--ultramodern-package-scope'
-    ]) ?? packageSource.aliasScope ?? (explicitRegistry ? void 0 : BLEEDINGDEV_PACKAGE_SCOPE);
-    return {
-        ...packageSource,
-        strategy: 'install',
-        modernPackageVersion: explicitVersion ?? (isBleedingDevCreatePackage(createPackage) ? packageSource.modernPackageVersion : readBleedingDevFrameworkVersionFromRegistry(packageSource.modernPackageVersion)),
-        aliasScope,
-        aliasPackageNamePrefix: getOptionValue(args, [
-            '--ultramodern-package-name-prefix'
-        ]) ?? packageSource.aliasPackageNamePrefix ?? (aliasScope ? BLEEDINGDEV_PACKAGE_NAME_PREFIX : void 0)
-    };
-}
-function resolveWorkspacePackageSource(args, createPackage, packageSource) {
-    const workspaceProtocolRequested = args.includes(WORKSPACE_PROTOCOL_FLAG);
-    if (workspaceProtocolRequested && hasExplicitUltramodernPackageSource(args, 'install')) {
-        console.error(`${WORKSPACE_PROTOCOL_FLAG} conflicts with --ultramodern-package-source=install`);
-        process.exit(1);
-    }
-    if (workspaceProtocolRequested || hasExplicitUltramodernPackageSource(args, 'workspace')) return {
-        ...packageSource,
-        strategy: 'workspace',
-        modernPackageVersion: WORKSPACE_PACKAGE_VERSION
-    };
-    return resolveInstallBackedPackageSource(args, createPackage, packageSource);
-}
-function runSetupCommand(command, args, options = {}) {
-    return execFileSync(command, args, {
-        cwd: options.cwd,
-        encoding: 'utf-8',
-        stdio: options.stdio ?? [
-            'ignore',
-            'pipe',
-            'pipe'
-        ],
-        timeout: options.timeoutMs
-    });
-}
-function commandExists(command) {
-    try {
-        runSetupCommand(command, [
-            '--version'
-        ], {
-            stdio: 'ignore'
-        });
-        return true;
-    } catch  {
-        return false;
-    }
-}
-function assertGitAvailableForGeneratedProject() {
-    if (commandExists('git')) return;
-    throw new Error('Git is required for UltraModern setup. Install git yourself (for example "brew install git" or "sudo apt-get install git") and rerun create. This tool never installs system packages on your behalf.');
-}
-function isInsideGitWorkTree(targetDir) {
-    try {
-        return 'true' === runSetupCommand('git', [
-            'rev-parse',
-            '--is-inside-work-tree'
-        ], {
-            cwd: targetDir
-        }).trim();
-    } catch  {
-        return false;
-    }
-}
-function initializeGeneratedGitRepository(targetDir) {
-    assertGitAvailableForGeneratedProject();
-    if (isInsideGitWorkTree(targetDir)) return;
-    try {
-        runSetupCommand('git', [
-            'init',
-            '-b',
-            'main'
-        ], {
-            cwd: targetDir,
-            stdio: 'inherit'
-        });
-    } catch  {
-        runSetupCommand('git', [
-            'init'
-        ], {
-            cwd: targetDir,
-            stdio: 'inherit'
-        });
-        runSetupCommand('git', [
-            'branch',
-            '-M',
-            'main'
-        ], {
-            cwd: targetDir,
-            stdio: 'inherit'
-        });
-    }
-}
-function isDirectoryEmpty(dirPath) {
-    if (!node_fs.existsSync(dirPath)) return false;
-    try {
-        const files = node_fs.readdirSync(dirPath);
-        return 0 === files.length;
-    } catch  {
-        return false;
-    }
-}
-async function getProjectName() {
-    const args = process.argv.slice(2);
-    const positionalArgs = collectPositionalArgs(args);
-    if (positionalArgs.length > 1) {
-        console.error(`Unexpected positional argument: ${positionalArgs[1]}`);
-        process.exit(1);
-    }
-    const projectNameArg = positionalArgs[0];
-    if (projectNameArg) {
-        if ('.' === projectNameArg) return {
-            name: node_path.basename(process.cwd()),
-            useCurrentDir: true
-        };
-        return {
-            name: projectNameArg,
-            useCurrentDir: false
-        };
-    }
-    const currentDir = process.cwd();
-    if (isDirectoryEmpty(currentDir)) return {
-        name: node_path.basename(currentDir),
-        useCurrentDir: true
-    };
-    const projectName = await promptInput(i18n.t(localeKeys.prompt.projectName));
-    if (!projectName) {
-        console.error(i18n.t(localeKeys.error.projectNameEmpty));
-        process.exit(1);
-    }
-    return {
-        name: projectName,
-        useCurrentDir: false
-    };
-}
 async function main() {
     const args = process.argv.slice(2);
     if ('ultramodern' === args[0]) {

package/dist/esm/ultramodern-tooling/commands/cloudflare-output-verify.js

@@ -0,0 +1,84 @@
+import node_path from "node:path";
+import { readUltramodernConfig, workspaceAppsFromToolingConfig } from "../config.js";
+import { runRenderedModule } from "./context.js";
+import { hasFlag, readOption } from "./options.js";
+const resolveCloudflareOutputVerifyTargets = (args, context)=>{
+    const outputDirectory = readOption(args, '--output');
+    const appId = readOption(args, '--app');
+    if (outputDirectory && appId) throw new Error('Use either --app or --output, not both.');
+    const targets = outputDirectory ? [
+        {
+            label: outputDirectory,
+            outputDirectory: node_path.resolve(context.invocationCwd, outputDirectory)
+        }
+    ] : workspaceAppsFromToolingConfig(readUltramodernConfig(context.workspaceRoot)).filter((app)=>!appId || app.id === appId).map((app)=>({
+            label: app.id,
+            outputDirectory: node_path.join(context.workspaceRoot, app.directory, '.output')
+        }));
+    if (0 === targets.length) throw new Error(`No generated UltraModern app matched ${appId}.`);
+    return targets;
+};
+const renderCloudflareOutputVerifyModule = ({ workspaceRoot, targets, scanRoots, importWorker })=>`
+import { createRequire } from 'node:module';
+import path from 'node:path';
+
+const workspaceRoot = ${JSON.stringify(workspaceRoot)};
+const targets = ${JSON.stringify(targets, null, 2)};
+const scanRoots = ${JSON.stringify(scanRoots)};
+const verifierRequire = createRequire(path.join(workspaceRoot, 'package.json'));
+const {
+  verifyCloudflareOutput,
+  verifyCloudflareOutputMutationPolicy,
+} = verifierRequire('@modern-js/app-tools/cloudflare-output-verifier');
+
+let failed = false;
+for (const target of targets) {
+  const result = await verifyCloudflareOutput({
+    outputDirectory: target.outputDirectory,
+    importWorker: ${JSON.stringify(importWorker)},
+  });
+  if (result.ok) {
+    console.log(\`[ultramodern] Cloudflare output verified: \${target.label}\`);
+  } else {
+    failed = true;
+    console.error(\`[ultramodern] Cloudflare output failed: \${target.label}\`);
+    for (const issue of result.issues) {
+      console.error(\`- \${issue.code}: \${issue.message}\${issue.path ? \` (\${issue.path})\` : ''}\`);
+    }
+  }
+}
+
+if (scanRoots.length > 0) {
+  const policyResult = await verifyCloudflareOutputMutationPolicy({ scanRoots });
+  if (!policyResult.ok) {
+    failed = true;
+    console.error('[ultramodern] generated-output mutation policy failed');
+    for (const issue of policyResult.issues) {
+      console.error(\`- \${issue.code}: \${issue.message}\${issue.path ? \` (\${issue.path})\` : ''}\`);
+    }
+  }
+}
+
+process.exit(failed ? 1 : 0);
+`;
+function runCloudflareOutputVerify(args, context) {
+    if (args.includes('--help') || args.includes('-h')) {
+        process.stdout.write(`Usage:
+  modern-js-create ultramodern cloudflare-output-verify [--app <id> | --output <dir>] [--no-import-worker] [--no-source-scan]
+
+Verifies generated Cloudflare output against the UltraModern worker contract.
+Without --app or --output, every generated workspace app is verified.
+`);
+        return 0;
+    }
+    const source = renderCloudflareOutputVerifyModule({
+        workspaceRoot: context.workspaceRoot,
+        targets: resolveCloudflareOutputVerifyTargets(args, context),
+        scanRoots: hasFlag(args, '--no-source-scan') ? [] : [
+            context.workspaceRoot
+        ],
+        importWorker: !hasFlag(args, '--no-import-worker')
+    });
+    return runRenderedModule(source, context);
+}
+export { runCloudflareOutputVerify };