@bleedingdev/modern-js-ultramodern-create 3.9.0-ultramodern.2 → 3.9.0-ultramodern.21

package/dist/cjs/ultramodern-workspace/write-workspace.cjs

@@ -37,12 +37,12 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
-    createCompactUltramodernConfig: ()=>createCompactUltramodernConfig,
     generateUltramodernWorkspace: ()=>generateUltramodernWorkspace,
     writeApp: ()=>external_write_app_cjs_namespaceObject.writeApp
 });
 const external_node_fs_namespaceObject = require("node:fs");
 var external_node_fs_default = /*#__PURE__*/ __webpack_require__.n(external_node_fs_namespaceObject);
+const external_ultramodern_package_source_cjs_namespaceObject = require("../ultramodern-package-source.cjs");
 const external_ultramodern_release_cohort_cjs_namespaceObject = require("../ultramodern-release-cohort.cjs");
 const transaction_cjs_namespaceObject = require("./add-vertical/transaction.cjs");
 const external_app_files_cjs_namespaceObject = require("./app-files.cjs");
@@ -55,7 +55,6 @@ const external_naming_cjs_namespaceObject = require("./naming.cjs");
 const external_overlays_cjs_namespaceObject = require("./overlays.cjs");
 const external_package_json_cjs_namespaceObject = require("./package-json.cjs");
 const external_package_source_cjs_namespaceObject = require("./package-source.cjs");
-const external_policy_cjs_namespaceObject = require("./policy.cjs");
 const external_versions_cjs_namespaceObject = require("./versions.cjs");
 const external_workspace_scripts_cjs_namespaceObject = require("./workspace-scripts.cjs");
 const external_write_app_cjs_namespaceObject = require("./write-app.cjs");
@@ -63,9 +62,9 @@ const external_zerops_cjs_namespaceObject = require("./zerops.cjs");
 function hasExplicitInstallRequest(options) {
     return void 0 !== options.packageSource && 'workspace' !== options.packageSource.strategy;
 }
-function writeSharedPackages(targetDir, scope) {
+function writeSharedPackages(targetDir, scope, packageSource) {
     for (const sharedPackage of external_descriptors_cjs_namespaceObject.sharedPackages){
-        (0, external_fs_io_cjs_namespaceObject.writeJson)(targetDir, `${sharedPackage.directory}/package.json`, (0, external_package_json_cjs_namespaceObject.createSharedPackage)(scope, sharedPackage.id, sharedPackage.description));
+        (0, external_fs_io_cjs_namespaceObject.writeJson)(targetDir, `${sharedPackage.directory}/package.json`, (0, external_package_json_cjs_namespaceObject.createSharedPackage)(scope, sharedPackage.id, sharedPackage.description, packageSource));
         (0, external_fs_io_cjs_namespaceObject.writeJson)(targetDir, `${sharedPackage.directory}/tsconfig.json`, (0, external_package_json_cjs_namespaceObject.createSharedPackageTsConfig)(sharedPackage.directory));
     }
     (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, 'packages/shared-contracts/src/index.ts', (0, external_package_json_cjs_namespaceObject.createSharedContractsIndex)());
@@ -79,30 +78,25 @@ function writeSharedPackages(targetDir, scope) {
 `);
     (0, external_fs_io_cjs_namespaceObject.writeFile)(targetDir, 'packages/shared-design-tokens/src/tokens.css', (0, external_app_files_cjs_namespaceObject.createSharedDesignTokensCss)());
 }
-function createCompactRootPackageJson(scope, packageSource, remotes, bridge) {
-    const rootPackage = (0, external_package_json_cjs_namespaceObject.createRootPackageJson)(scope, packageSource, remotes, bridge);
-    if (rootPackage.modernjs?.packageSource && 'object' == typeof rootPackage.modernjs.packageSource) rootPackage.modernjs.packageSource.config = `./${external_descriptors_cjs_namespaceObject.ULTRAMODERN_CONFIG_PATH}`;
-    return rootPackage;
+function renderCatalogPolicy(packageSource) {
+    if ('install' !== packageSource.strategy) return '';
+    const catalog = external_ultramodern_package_source_cjs_namespaceObject.ULTRAMODERN_WORKSPACE_MODERN_PACKAGES.map((name)=>`    ${JSON.stringify(name)}: ${JSON.stringify((0, external_ultramodern_package_source_cjs_namespaceObject.modernPackageSpecifier)(name, packageSource))}`).join('\n');
+    const cohort = (0, external_ultramodern_release_cohort_cjs_namespaceObject.hasCreateReleaseCohort)() ? (0, external_ultramodern_release_cohort_cjs_namespaceObject.readCreateReleaseCohort)() : void 0;
+    const pinsShippedCohort = cohort?.packages.every((item)=>(0, external_ultramodern_package_source_cjs_namespaceObject.modernPackageSpecifier)(item.sourceName, packageSource) === `npm:${item.targetName}@${item.version}`);
+    const exclude = cohort && pinsShippedCohort ? `minimumReleaseAgeExclude:\n${(0, external_ultramodern_release_cohort_cjs_namespaceObject.releaseCohortSelectors)(cohort).map((selector)=>`  - ${JSON.stringify(selector)}`).join('\n')}\n\n` : '';
+    return `catalogs:\n  ultramodern:\n${catalog}\n\n${exclude}`;
 }
-function createCompactUltramodernConfig(scope, modernVersion, packageSource, apps = [
-    (0, external_descriptors_cjs_namespaceObject.createShellHost)()
-], enableTailwind = true, bridge, additionalShells = [], primaryShell) {
-    const config = (0, external_contracts_cjs_namespaceObject.createUltramodernConfig)(scope, modernVersion, packageSource, apps, enableTailwind, bridge, additionalShells, primaryShell);
-    if (config.packageSource && 'object' == typeof config.packageSource && !Array.isArray(config.packageSource)) delete config.packageSource.metadata;
-    return config;
-}
-function writePnpmWorkspacePackages(targetDir, bridge) {
-    if (!bridge) return;
+function writePnpmWorkspacePackages(targetDir, bridge, packageSource) {
     const pnpmWorkspacePath = `${targetDir}/pnpm-workspace.yaml`;
     const pnpmWorkspace = external_node_fs_default().readFileSync(pnpmWorkspacePath, 'utf-8');
     const packages = [
         'apps/*',
         'verticals/*',
         'packages/*',
-        ...bridge.workspacePackages.map((entry)=>entry.pattern)
+        ...bridge?.workspacePackages.map((entry)=>entry.pattern) ?? []
     ];
     const renderedPackages = packages.map((pattern)=>`  - ${pattern}`).join('\n');
-    (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(targetDir, 'pnpm-workspace.yaml', pnpmWorkspace.replace(/^packages:\r?\n(?: {2}- .+\r?\n)+/u, `packages:\n${renderedPackages}\n`));
+    (0, external_fs_io_cjs_namespaceObject.writeFileReplacing)(targetDir, 'pnpm-workspace.yaml', `${renderCatalogPolicy(packageSource)}${pnpmWorkspace.replace(/^packages:\r?\n(?: {2}- .+\r?\n)+/u, `packages:\n${renderedPackages}\n`)}`);
 }
 function generateUltramodernWorkspace(options) {
     const result = (0, transaction_cjs_namespaceObject.runFreshWorkspaceTransaction)(options.targetDir, (stagingRoot)=>generateUltramodernWorkspaceInPlace({
@@ -115,19 +109,15 @@ function generateUltramodernWorkspaceInPlace(options, logicalWorkspaceRoot = opt
     const beforeFiles = (0, external_generation_result_cjs_namespaceObject.createFileSnapshot)(options.targetDir);
     const scope = (0, external_naming_cjs_namespaceObject.toPackageScope)(options.packageName);
     let packageSource;
-    let releaseCohort;
     if ((0, external_ultramodern_release_cohort_cjs_namespaceObject.isCreatePackageSourceCheckout)()) {
-        if (hasExplicitInstallRequest(options)) throw new Error('A local @modern-js/ultramodern-create source checkout cannot satisfy an explicit install package source. Use workspace mode locally or run the packed published package with its authenticated release cohort projection.');
+        if (hasExplicitInstallRequest(options)) throw new Error('A local @modern-js/ultramodern-create source checkout cannot satisfy an explicit install package source. Use workspace mode locally or run the packed published package.');
         packageSource = (0, external_package_source_cjs_namespaceObject.resolvePackageSource)({
             ...options,
             packageSource: {
                 strategy: 'workspace'
             }
         });
-    } else {
-        packageSource = (0, external_package_source_cjs_namespaceObject.resolvePackageSource)(options);
-        if ('install' === packageSource.strategy) releaseCohort = (0, external_ultramodern_release_cohort_cjs_namespaceObject.readCreateReleaseCohort)();
-    }
+    } else packageSource = (0, external_package_source_cjs_namespaceObject.resolvePackageSource)(options);
     const bridge = (0, external_bridge_config_cjs_namespaceObject.normalizeUltramodernBridgeConfig)(options.bridge);
     const enableTailwind = false !== options.enableTailwind;
     const initialVerticals = [];
@@ -142,13 +132,9 @@ function generateUltramodernWorkspaceInPlace(options, logicalWorkspaceRoot = opt
     external_node_fs_default().mkdirSync(options.targetDir, {
         recursive: true
     });
-    const minimumReleaseAgeExclude = (0, external_policy_cjs_namespaceObject.renderMinimumReleaseAgeExclude)({
-        packageSource,
-        releaseCohort
-    });
     const workspacePackageLinkingPolicy = (0, external_package_source_cjs_namespaceObject.resolveWorkspacePackageLinkingPolicy)(packageSource);
     const excludedRootTemplates = new Set([
-        external_ultramodern_release_cohort_cjs_namespaceObject.RELEASE_COHORT_PROJECTION_PATH
+        "scripts/setup-agent-reference-repos.mjs"
     ]);
     if (false === options.generateAgentFiles) {
         excludedRootTemplates.add('AGENTS.md.handlebars');
@@ -159,37 +145,23 @@ function generateUltramodernWorkspaceInPlace(options, logicalWorkspaceRoot = opt
         packageScope: scope,
         nodeVersion: external_versions_cjs_namespaceObject.NODE_VERSION,
         pnpmVersion: external_versions_cjs_namespaceObject.PNPM_VERSION,
-        nodeFetchVersion: external_versions_cjs_namespaceObject.NODE_FETCH_VERSION,
-        drizzleOrmVersion: external_versions_cjs_namespaceObject.DRIZZLE_ORM_VERSION,
         effectVersion: external_versions_cjs_namespaceObject.EFFECT_VERSION,
-        effectVitestVersion: external_versions_cjs_namespaceObject.EFFECT_VITEST_VERSION,
         i18nextVersion: external_versions_cjs_namespaceObject.I18NEXT_VERSION,
-        moduleFederationVersion: external_versions_cjs_namespaceObject.MODULE_FEDERATION_VERSION,
-        msgpackrVersion: external_versions_cjs_namespaceObject.MSGPACKR_VERSION,
-        zodVersion: external_versions_cjs_namespaceObject.ZOD_VERSION,
-        tanstackHistoryVersion: external_versions_cjs_namespaceObject.TANSTACK_HISTORY_VERSION,
-        tanstackRouterCoreVersion: external_versions_cjs_namespaceObject.TANSTACK_ROUTER_CORE_VERSION,
-        tanstackRouterVersion: external_versions_cjs_namespaceObject.TANSTACK_ROUTER_VERSION,
-        typescriptVersion: external_versions_cjs_namespaceObject.TYPESCRIPT_VERSION,
-        wranglerVersion: external_versions_cjs_namespaceObject.WRANGLER_VERSION,
-        minimumReleaseAgeExcludeYaml: 0 === minimumReleaseAgeExclude.length ? ' []' : `\n${minimumReleaseAgeExclude.map((selector)=>`  - '${selector}'`).join('\n')}`,
         workspacePackageLinkingYaml: Object.entries(workspacePackageLinkingPolicy).map(([key, value])=>`${key}: ${String(value)}\n`).join(''),
         tailwindEnabled: String(enableTailwind)
     }, excludedRootTemplates);
-    if (releaseCohort) (0, external_ultramodern_release_cohort_cjs_namespaceObject.copyCreateReleaseCohort)(options.targetDir);
-    writePnpmWorkspacePackages(options.targetDir, bridge);
-    (0, external_fs_io_cjs_namespaceObject.writeJson)(options.targetDir, 'package.json', createCompactRootPackageJson(scope, packageSource, initialVerticals, bridge));
+    writePnpmWorkspacePackages(options.targetDir, bridge, packageSource);
+    (0, external_fs_io_cjs_namespaceObject.writeJson)(options.targetDir, 'package.json', (0, external_package_json_cjs_namespaceObject.createRootPackageJson)(scope, packageSource, initialVerticals, bridge));
     if (initialVerticals.length > 0) (0, external_fs_io_cjs_namespaceObject.writeFile)(options.targetDir, 'zerops.yaml', `${(0, external_zerops_cjs_namespaceObject.createZeropsYaml)(scope, createdApps)}\n`);
     (0, external_fs_io_cjs_namespaceObject.writeJson)(options.targetDir, 'tsconfig.base.json', (0, external_package_json_cjs_namespaceObject.createTsConfigBase)());
     (0, external_fs_io_cjs_namespaceObject.writeJson)(options.targetDir, 'tsconfig.json', (0, external_package_json_cjs_namespaceObject.createRootTsConfig)(createdApps));
     (0, external_fs_io_cjs_namespaceObject.writeJson)(options.targetDir, 'topology/reference-topology.json', (0, external_contracts_cjs_namespaceObject.createTopology)(scope, initialVerticals));
     (0, external_fs_io_cjs_namespaceObject.writeJson)(options.targetDir, 'topology/ownership.json', (0, external_contracts_cjs_namespaceObject.createOwnership)(scope, initialVerticals));
     (0, external_fs_io_cjs_namespaceObject.writeJson)(options.targetDir, 'topology/local-overlays/development.json', (0, external_contracts_cjs_namespaceObject.createDevelopmentOverlay)(scope, initialVerticals));
-    (0, external_fs_io_cjs_namespaceObject.writeJson)(options.targetDir, external_descriptors_cjs_namespaceObject.ULTRAMODERN_CONFIG_PATH, createCompactUltramodernConfig(scope, options.modernVersion, packageSource, createdApps, enableTailwind, bridge));
     (0, external_write_app_cjs_namespaceObject.writeApp)(options.targetDir, scope, external_descriptors_cjs_namespaceObject.shellApp, packageSource, enableTailwind, initialVerticals, bridge);
     for (const remote of initialVerticals)(0, external_write_app_cjs_namespaceObject.writeApp)(options.targetDir, scope, remote, packageSource, enableTailwind, initialVerticals, bridge);
-    writeSharedPackages(options.targetDir, scope);
-    (0, external_workspace_scripts_cjs_namespaceObject.writeGeneratedWorkspaceScripts)(options.targetDir, scope, enableTailwind, initialVerticals, releaseCohort);
+    writeSharedPackages(options.targetDir, scope, packageSource);
+    (0, external_workspace_scripts_cjs_namespaceObject.writeGeneratedWorkspaceScripts)(options.targetDir);
     const preliminaryAfterFiles = (0, external_generation_result_cjs_namespaceObject.createFileSnapshot)(options.targetDir);
     const preliminaryDiff = (0, external_generation_result_cjs_namespaceObject.diffFileSnapshots)(beforeFiles, preliminaryAfterFiles);
     const preliminaryResult = (0, external_generation_result_cjs_namespaceObject.createGenerationResult)({
@@ -219,11 +191,9 @@ function generateUltramodernWorkspaceInPlace(options, logicalWorkspaceRoot = opt
         rewrittenPaths
     });
 }
-exports.createCompactUltramodernConfig = __webpack_exports__.createCompactUltramodernConfig;
 exports.generateUltramodernWorkspace = __webpack_exports__.generateUltramodernWorkspace;
 exports.writeApp = __webpack_exports__.writeApp;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
-    "createCompactUltramodernConfig",
     "generateUltramodernWorkspace",
     "writeApp"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];

package/dist/cjs/ultramodern-workspace/zerops.cjs

@@ -63,6 +63,8 @@ function createZeropsService(scope, app) {
         `  - setup: ${quoteYamlString(app.id)}`,
         '    build:',
         `      base: ${quoteYamlString(zeropsNodeRuntime)}`,
+        '      envVariables:',
+        `        ZE_FAIL_BUILD: ${quoteYamlString('true')}`,
         '      buildCommands:',
         '        - |',
         ...commands.map((command)=>`          ${command}`),

package/dist/esm/cli/package-source.js

@@ -2,7 +2,7 @@ import node_fs from "node:fs";
 import node_path from "node:path";
 import { fileURLToPath } from "node:url";
 import { resolveCreatePackageRoot } from "../create-package-root.js";
-import { BLEEDINGDEV_CREATE_PACKAGE, BLEEDINGDEV_FRAMEWORK_VERSION_ENV, BLEEDINGDEV_PACKAGE_NAME_PREFIX, BLEEDINGDEV_PACKAGE_SCOPE, LEGACY_BLEEDINGDEV_CREATE_PACKAGE, ULTRAMODERN_FRAMEWORK_VERSION_ENV, WORKSPACE_PACKAGE_VERSION } from "../ultramodern-package-source.js";
+import { BLEEDINGDEV_CREATE_PACKAGE, BLEEDINGDEV_PACKAGE_NAME_PREFIX, BLEEDINGDEV_PACKAGE_SCOPE, ULTRAMODERN_FRAMEWORK_VERSION_ENV, WORKSPACE_PACKAGE_VERSION } from "../ultramodern-package-source.js";
 import { isCreatePackageSourceCheckout } from "../ultramodern-release-cohort.js";
 import { WORKSPACE_PROTOCOL_FLAG, getOptionValue } from "./flags.js";
 import { runSetupCommand } from "./project-setup.js";
@@ -15,7 +15,7 @@ function readCreatePackageJson() {
     return JSON.parse(node_fs.readFileSync(createPackageJson, 'utf-8'));
 }
 function isBleedingDevCreatePackage(createPackage) {
-    return createPackage.name === BLEEDINGDEV_CREATE_PACKAGE || createPackage.name === LEGACY_BLEEDINGDEV_CREATE_PACKAGE;
+    return createPackage.name === BLEEDINGDEV_CREATE_PACKAGE;
 }
 function getBleedingDevFrameworkVersion(createPackage, fallbackVersion) {
     const frameworkVersion = createPackage.ultramodern?.frameworkVersion;
@@ -56,7 +56,7 @@ function hasExplicitUltramodernPackageSource(args, value) {
     return value ? configuredValue === value : void 0 !== configuredValue;
 }
 function readBleedingDevFrameworkVersionFromRegistry(fallbackVersion) {
-    const envVersion = (process.env[ULTRAMODERN_FRAMEWORK_VERSION_ENV] ?? process.env[BLEEDINGDEV_FRAMEWORK_VERSION_ENV])?.trim();
+    const envVersion = process.env[ULTRAMODERN_FRAMEWORK_VERSION_ENV]?.trim();
     if (envVersion) {
         if (!semverPattern.test(envVersion)) {
             console.error(`${ULTRAMODERN_FRAMEWORK_VERSION_ENV} must be a valid semver version`);

package/dist/esm/cli/project-setup.js

@@ -42,7 +42,7 @@ function isInsideGitWorkTree(targetDir) {
 }
 function initializeGeneratedGitRepository(targetDir) {
     assertGitAvailableForGeneratedProject();
-    if (isInsideGitWorkTree(targetDir)) return;
+    if (isInsideGitWorkTree(targetDir)) return false;
     try {
         runSetupCommand('git', [
             'init',
@@ -68,27 +68,7 @@ function initializeGeneratedGitRepository(targetDir) {
             stdio: 'inherit'
         });
     }
-    runSetupCommand('git', [
-        'add',
-        '-A'
-    ], {
-        cwd: targetDir,
-        stdio: 'inherit'
-    });
-    runSetupCommand('git', [
-        '-c',
-        'user.name=UltraModern',
-        '-c',
-        'user.email=ultramodern@bleedingdev.dev',
-        '-c',
-        'commit.gpgsign=false',
-        'commit',
-        '-m',
-        'chore: initial UltraModern scaffold'
-    ], {
-        cwd: targetDir,
-        stdio: 'inherit'
-    });
+    return true;
 }
 function isDirectoryEmpty(dirPath) {
     if (!node_fs.existsSync(dirPath)) return false;

package/dist/esm/index.js

@@ -2,7 +2,7 @@ import node_fs from "node:fs";
 import node_path from "node:path";
 import { fileURLToPath } from "node:url";
 import { runAgentsMd } from "./agents-md.js";
-import { DRY_RUN_FLAG, VERTICAL_FLAG, detectApiProtocolFlag, detectBffRuntime, detectCodeSmithOverlays, detectDryRunFlag, detectExplicitTailwindFlag, detectHorizontalRemoteFlag, detectLanguage, detectPresetFlag, detectTailwindFlag, readBridgeCliOptions, resolveVerticalCliInput } from "./cli/flags.js";
+import { DRY_RUN_FLAG, VERTICAL_FLAG, collectPositionalArgs, detectApiProtocolFlag, detectBffRuntime, detectCodeSmithOverlays, detectDryRunFlag, detectExplicitTailwindFlag, detectHorizontalRemoteFlag, detectLanguage, detectPresetFlag, 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";
@@ -10,6 +10,7 @@ import { getProjectName } from "./cli/prompts.js";
 import { i18n, localeKeys } from "./locale/index.js";
 import { runUltramodernToolingCli } from "./ultramodern-tooling/commands.js";
 import { addUltramodernVertical, generateUltramodernWorkspace, planUltramodernVertical } from "./ultramodern-workspace/index.js";
+import { recoverFreshWorkspaceTransactions } from "./ultramodern-workspace/add-vertical/transaction.js";
 import { hasUltramodernBridgeCliOptions } from "./ultramodern-workspace/bridge-config.js";
 const src_dirname = node_path.dirname(fileURLToPath(import.meta.url));
 const templateDir = [
@@ -90,9 +91,11 @@ async function main() {
         console.log(`${dim}   pnpm check${reset}\n`);
         return;
     }
+    if (0 === collectPositionalArgs(args).length) recoverFreshWorkspaceTransactions(process.cwd());
     const { name: projectName, useCurrentDir } = await getProjectName();
     const targetDir = useCurrentDir ? process.cwd() : node_path.isAbsolute(projectName) ? projectName : node_path.resolve(process.cwd(), projectName);
     const generatedPackageName = useCurrentDir || node_path.isAbsolute(projectName) ? node_path.basename(targetDir) : projectName;
+    recoverFreshWorkspaceTransactions(targetDir);
     if (node_fs.existsSync(targetDir)) {
         const files = node_fs.readdirSync(targetDir);
         if (files.length > 0) {
@@ -114,7 +117,7 @@ async function main() {
         packageSource,
         generateAgentFiles
     });
-    initializeGeneratedGitRepository(targetDir);
+    const initializedGitRepository = initializeGeneratedGitRepository(targetDir);
     const dim = '\x1b[2m\x1b[3m';
     const reset = '\x1b[0m';
     console.log(`${i18n.t(localeKeys.message.success)}\n`);
@@ -125,6 +128,11 @@ async function main() {
     })}${reset}`);
     console.log(`${dim}   ${i18n.t(localeKeys.message.step2)}${reset}`);
     console.log(`${dim}   pnpm check${reset}`);
+    if (initializedGitRepository) {
+        console.log(i18n.t(localeKeys.message.initialCommit));
+        console.log(`${dim}   git add .${reset}`);
+        console.log(`${dim}   git commit -m "chore: initial UltraModern scaffold"${reset}`);
+    }
     console.log(`${dim}   ${i18n.t(localeKeys.message.step3)}${reset}\n`);
 }
 main().catch((error)=>{

package/dist/esm/locale/en.js

@@ -17,7 +17,8 @@ const EN_LOCALE = {
         nextSteps: '📋 Next steps:',
         step1: 'cd {projectName}',
         step2: 'pnpm install',
-        step3: 'pnpm dev'
+        step3: 'pnpm dev',
+        initialCommit: 'Commit the checked scaffold before starting development or CI builds. Git uses your configured identity and hooks.'
     },
     agentsCmd: {
         created: '✔ Created {file}',

package/dist/esm/locale/zh.js

@@ -17,7 +17,8 @@ const ZH_LOCALE = {
         nextSteps: '📋 下一步：',
         step1: 'cd {projectName}',
         step2: 'pnpm install',
-        step3: 'pnpm dev'
+        step3: 'pnpm dev',
+        initialCommit: '启动开发或 CI 构建前，请提交已检查的项目。Git 将使用你配置的身份和钩子。'
     },
     agentsCmd: {
         created: '✔ 已创建 {file}',

package/dist/esm/ultramodern-package-source.js

@@ -1,11 +1,9 @@
 const WORKSPACE_PACKAGE_VERSION = 'workspace:*';
 const ULTRAMODERN_CREATE_PACKAGE = '@modern-js/ultramodern-create';
 const BLEEDINGDEV_CREATE_PACKAGE = '@bleedingdev/modern-js-ultramodern-create';
-const LEGACY_BLEEDINGDEV_CREATE_PACKAGE = '@bleedingdev/modern-js-create';
 const BLEEDINGDEV_PACKAGE_SCOPE = 'bleedingdev';
 const BLEEDINGDEV_PACKAGE_NAME_PREFIX = 'modern-js-';
 const ULTRAMODERN_FRAMEWORK_VERSION_ENV = 'ULTRAMODERN_CREATE_FRAMEWORK_VERSION';
-const BLEEDINGDEV_FRAMEWORK_VERSION_ENV = 'MODERN_CREATE_ULTRAMODERN_FRAMEWORK_VERSION';
 const ULTRAMODERN_SINGLE_APP_MODERN_PACKAGES = [
     ULTRAMODERN_CREATE_PACKAGE,
     '@modern-js/code-tools',
@@ -15,16 +13,28 @@ const ULTRAMODERN_SINGLE_APP_MODERN_PACKAGES = [
     '@modern-js/plugin-i18n',
     '@modern-js/plugin-tanstack',
     '@modern-js/plugin-bff',
+    '@modern-js/plugin-bff-build-extensions',
+    '@modern-js/plugin-bff-extensions',
     '@modern-js/adapter-rstest'
 ];
 const ULTRAMODERN_WORKSPACE_MODERN_PACKAGES = [
+    '@modern-js/bff-effect',
+    '@modern-js/boundary-debugger',
     ULTRAMODERN_CREATE_PACKAGE,
     '@modern-js/code-tools',
     '@modern-js/app-tools',
     '@modern-js/plugin-bff',
+    '@modern-js/plugin-bff-build-extensions',
+    '@modern-js/plugin-bff-extensions',
     '@modern-js/plugin-i18n',
+    '@modern-js/i18n-integration',
     '@modern-js/plugin-tanstack',
-    '@modern-js/runtime'
+    '@modern-js/runtime',
+    '@modern-js/runtime-extensions',
+    '@modern-js/runtime-renderer-extensions',
+    '@modern-js/federation-runtime',
+    '@modern-js/app-tools-extensions',
+    '@modern-js/ultramodern-app-tools'
 ];
 function modernPackageVersion(packageSource) {
     return 'install' === packageSource.strategy ? packageSource.modernPackageVersion : WORKSPACE_PACKAGE_VERSION;
@@ -40,4 +50,4 @@ function modernPackageSpecifier(packageName, packageSource) {
     if (!packageSource.aliasScope) return packageSource.modernPackageVersion;
     return `npm:${modernAliasPackageName(packageName, packageSource)}@${packageSource.modernPackageVersion}`;
 }
-export { BLEEDINGDEV_CREATE_PACKAGE, BLEEDINGDEV_FRAMEWORK_VERSION_ENV, BLEEDINGDEV_PACKAGE_NAME_PREFIX, BLEEDINGDEV_PACKAGE_SCOPE, LEGACY_BLEEDINGDEV_CREATE_PACKAGE, ULTRAMODERN_CREATE_PACKAGE, ULTRAMODERN_FRAMEWORK_VERSION_ENV, ULTRAMODERN_SINGLE_APP_MODERN_PACKAGES, ULTRAMODERN_WORKSPACE_MODERN_PACKAGES, WORKSPACE_PACKAGE_VERSION, modernPackageSpecifier, modernPackageVersion };
+export { BLEEDINGDEV_CREATE_PACKAGE, BLEEDINGDEV_PACKAGE_NAME_PREFIX, BLEEDINGDEV_PACKAGE_SCOPE, ULTRAMODERN_CREATE_PACKAGE, ULTRAMODERN_FRAMEWORK_VERSION_ENV, ULTRAMODERN_SINGLE_APP_MODERN_PACKAGES, ULTRAMODERN_WORKSPACE_MODERN_PACKAGES, WORKSPACE_PACKAGE_VERSION, modernPackageSpecifier, modernPackageVersion };

package/dist/esm/ultramodern-release-cohort.js

@@ -1,7 +1,7 @@
 import node_fs from "node:fs";
 import node_path from "node:path";
-import { createPackageRoot, writeFile } from "./ultramodern-workspace/fs-io.js";
-const RELEASE_COHORT_PROJECTION_PATH = '.modernjs/release-cohort.json';
+import { createPackageRoot } from "./ultramodern-workspace/fs-io.js";
+const RELEASE_COHORT_PATH = 'release-cohort.json';
 const RELEASE_COHORT_PROJECTION_SCHEMA = 'bleedingdev.ultramodern.release-cohort';
 const RELEASE_COHORT_PROJECTION_SCHEMA_VERSION = 1;
 function assert(condition, message) {
@@ -98,23 +98,14 @@ function readCohortFile(filePath) {
     return parseUltramodernReleaseCohort(value);
 }
 function readCreateReleaseCohort() {
-    return readCohortFile(node_path.join(createPackageRoot, 'template-workspace', RELEASE_COHORT_PROJECTION_PATH));
+    return readCohortFile(node_path.join(createPackageRoot, RELEASE_COHORT_PATH));
 }
 function hasCreateReleaseCohort() {
-    return node_fs.existsSync(node_path.join(createPackageRoot, 'template-workspace', RELEASE_COHORT_PROJECTION_PATH));
+    return node_fs.existsSync(node_path.join(createPackageRoot, RELEASE_COHORT_PATH));
 }
 function isCreatePackageSourceCheckout() {
     return node_fs.existsSync(node_path.join(createPackageRoot, 'src'));
 }
-function readWorkspaceReleaseCohort(workspaceRoot) {
-    return readCohortFile(node_path.join(workspaceRoot, RELEASE_COHORT_PROJECTION_PATH));
-}
-function copyCreateReleaseCohort(workspaceRoot) {
-    const sourcePath = node_path.join(createPackageRoot, 'template-workspace', RELEASE_COHORT_PROJECTION_PATH);
-    const cohort = readCohortFile(sourcePath);
-    writeFile(workspaceRoot, RELEASE_COHORT_PROJECTION_PATH, node_fs.readFileSync(sourcePath, 'utf8'));
-    return cohort;
-}
 function assertReleaseCohortPackageSource(cohort, packageSource) {
     if ('install' !== packageSource.strategy) return;
     assert(packageSource.modernPackageVersion === cohort.release.version, `Package source release ${packageSource.modernPackageVersion} does not match authenticated release cohort ${cohort.release.version}.`);
@@ -130,4 +121,4 @@ function assertReleaseCohortPackageSource(cohort, packageSource) {
 function releaseCohortSelectors(cohort) {
     return cohort.packages.map((item)=>`${item.targetName}@${item.version}`).sort();
 }
-export { RELEASE_COHORT_PROJECTION_PATH, assertReleaseCohortPackageSource, copyCreateReleaseCohort, hasCreateReleaseCohort, isCreatePackageSourceCheckout, parseUltramodernReleaseCohort, readCreateReleaseCohort, readWorkspaceReleaseCohort, releaseCohortSelectors };
+export { RELEASE_COHORT_PATH, assertReleaseCohortPackageSource, hasCreateReleaseCohort, isCreatePackageSourceCheckout, parseUltramodernReleaseCohort, readCreateReleaseCohort, releaseCohortSelectors };

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

@@ -1,7 +1,18 @@
+import { createRequire } from "node:module";
 import node_path from "node:path";
+import { createCloudflarePublicUrlEnv } from "../../ultramodern-workspace/descriptors.js";
 import { readUltramodernConfig, workspaceAppsFromToolingConfig } from "../config.js";
-import { runRenderedModule } from "./context.js";
 import { readOption } from "./options.js";
+const REQUIRE_PUBLIC_URLS_FLAG = '--require-public-urls';
+const missingPublicUrl = ({ label, publicUrlEnv })=>{
+    if (!publicUrlEnv) return `${REQUIRE_PUBLIC_URLS_FLAG} needs --app, not --output (${label}).`;
+    const names = [
+        publicUrlEnv,
+        'MODERN_PUBLIC_SITE_URL',
+        'ULTRAMODERN_CLOUDFLARE_WORKERS_DEV_SUBDOMAIN'
+    ];
+    return names.some((name)=>process.env[name]?.trim()) ? void 0 : `Cloudflare deploy for ${label} needs ${names.join(', ')}.`;
+};
 const resolveCloudflareOutputVerifyTargets = (args, context)=>{
     const outputDirectory = readOption(args, '--output');
     const appId = readOption(args, '--app');
@@ -11,74 +22,56 @@ const resolveCloudflareOutputVerifyTargets = (args, context)=>{
             label: outputDirectory,
             outputDirectory: node_path.resolve(context.invocationCwd, outputDirectory)
         }
-    ] : workspaceAppsFromToolingConfig(readUltramodernConfig(context.workspaceRoot)).filter((app)=>!appId || app.id === appId).map((app)=>({
+    ] : workspaceAppsFromToolingConfig(readUltramodernConfig(context.workspaceRoot), context.workspaceRoot).filter((app)=>!appId || app.id === appId).map((app)=>({
             label: app.id,
-            outputDirectory: node_path.join(context.workspaceRoot, app.directory, '.output')
+            outputDirectory: node_path.join(context.workspaceRoot, app.directory, '.output'),
+            publicUrlEnv: createCloudflarePublicUrlEnv(app)
         }));
     if (0 === targets.length) throw new Error(`No generated UltraModern app matched ${appId}.`);
     return targets;
 };
-const renderCloudflareOutputVerifyModule = ({ workspaceRoot, targets, excludePaths })=>`
-import { createRequire } from 'node:module';
-import path from 'node:path';
-
-const workspaceRoot = ${JSON.stringify(workspaceRoot)};
-const targets = ${JSON.stringify(targets, null, 2)};
-const scanRoots = [workspaceRoot];
-const excludePaths = ${JSON.stringify(excludePaths)};
-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: true,
-  });
-  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, excludePaths });
-  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) {
+async function runCloudflareOutputVerify(args, context) {
     if (args.includes('--help') || args.includes('-h')) {
         process.stdout.write(`Usage:
-  ultramodern-create ultramodern cloudflare-output-verify [--app <id> | --output <dir>]
+  ultramodern-create ultramodern cloudflare-output-verify [--app <id> | --output <dir>] [--require-public-urls]
 
 Verifies generated Cloudflare output against the UltraModern worker contract.
 Without --app or --output, every generated workspace app is verified.
+--require-public-urls also fails an app that has no public URL to deploy to.
 `);
         return 0;
     }
-    const source = renderCloudflareOutputVerifyModule({
-        workspaceRoot: context.workspaceRoot,
-        targets: resolveCloudflareOutputVerifyTargets(args, context),
-        excludePaths: [
-            node_path.join(context.workspaceRoot, "scripts", 'validate-ultramodern-workspace.mts')
-        ]
+    const targets = resolveCloudflareOutputVerifyTargets(args, context);
+    if (args.includes(REQUIRE_PUBLIC_URLS_FLAG)) {
+        const missing = targets.map(missingPublicUrl).filter((message)=>Boolean(message));
+        if (missing.length > 0) throw new Error(missing.join('\n'));
+    }
+    const verifierRequire = createRequire(node_path.join(context.workspaceRoot, 'package.json'));
+    const { verifyCloudflareOutput, verifyCloudflareOutputMutationPolicy } = verifierRequire('@modern-js/app-tools-extensions/cloudflare-output-verifier');
+    let failed = false;
+    for (const target of targets){
+        const result = await verifyCloudflareOutput({
+            outputDirectory: target.outputDirectory,
+            importWorker: true
+        });
+        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})` : ''}`);
+        }
+    }
+    const policyResult = await verifyCloudflareOutputMutationPolicy({
+        scanRoots: [
+            context.workspaceRoot
+        ],
+        excludePaths: []
     });
-    return runRenderedModule(source, context);
+    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})` : ''}`);
+    }
+    return failed ? 1 : 0;
 }
 export { runCloudflareOutputVerify };

package/dist/esm/ultramodern-tooling/commands/context.js

@@ -1,17 +1,21 @@
 import { spawnSync } from "node:child_process";
-import node_fs from "node:fs";
-import node_os from "node:os";
+import { constants } from "node:os";
 import node_path from "node:path";
 import { fileURLToPath } from "node:url";
 import { resolveCreatePackageRoot } from "../../create-package-root.js";
 import { generatedToolingCommandList, generatedToolingCommands } from "../../ultramodern-workspace/tooling-command-catalog.js";
 const context_dirname = node_path.dirname(fileURLToPath(import.meta.url));
 const createPackageRoot = resolveCreatePackageRoot(context_dirname);
+const AD_HOC_TOOLING_COMMANDS = {
+    syncDeliveryUnit: 'sync-delivery-unit',
+    skills: 'skills'
+};
 function printHelp() {
     const commands = [
         ...generatedToolingCommandList().map((command)=>`  ${command}`),
-        '  skills install',
-        '  skills check'
+        `  ${AD_HOC_TOOLING_COMMANDS.syncDeliveryUnit}`,
+        `  ${AD_HOC_TOOLING_COMMANDS.skills} install`,
+        `  ${AD_HOC_TOOLING_COMMANDS.skills} check`
     ].join('\n');
     process.stdout.write(`Usage:
   ultramodern-create ultramodern <command> [args]
@@ -34,7 +38,7 @@ function spawnNodeScript(relativeScriptPath, args, context, options = {}) {
         stdio: 'inherit'
     });
     if (result.error) throw result.error;
-    return result.status ?? 1;
+    return result.status ?? (result.signal ? 128 + constants.signals[result.signal] : 1);
 }
 function runTemplateBackedToolingCommand(command, args, context) {
     const toolingCommand = generatedToolingCommands.find((candidate)=>candidate.command === command);
@@ -43,24 +47,4 @@ function runTemplateBackedToolingCommand(command, args, context) {
         cwd: 'invocation' === toolingCommand.cwd ? context.invocationCwd : context.workspaceRoot
     });
 }
-function runRenderedModule(source, context) {
-    const tempDir = node_fs.mkdtempSync(node_path.join(node_os.tmpdir(), 'ultramodern-tool-'));
-    const tempFile = node_path.join(tempDir, 'command.mjs');
-    try {
-        node_fs.writeFileSync(tempFile, source, 'utf-8');
-        const result = spawnSync(process.execPath, [
-            tempFile
-        ], {
-            cwd: context.workspaceRoot,
-            stdio: 'inherit'
-        });
-        if (result.error) throw result.error;
-        return result.status ?? 1;
-    } finally{
-        node_fs.rmSync(tempDir, {
-            force: true,
-            recursive: true
-        });
-    }
-}
-export { createPackageRoot, printHelp, runRenderedModule, runTemplateBackedToolingCommand, spawnNodeScript };
+export { AD_HOC_TOOLING_COMMANDS, createPackageRoot, printHelp, runTemplateBackedToolingCommand, spawnNodeScript };

package/dist/esm/ultramodern-tooling/commands/routes-generate-app.js

@@ -0,0 +1,35 @@
+import { createRequire } from "node:module";
+import node_path from "node:path";
+import { pathToFileURL } from "node:url";
+async function main() {
+    const [appDirectory, label, mode] = process.argv.slice(2);
+    try {
+        if (!appDirectory || !label) throw new Error('Route generation requires an app directory and label.');
+        const appRequire = createRequire(node_path.join(appDirectory, 'package.json'));
+        const pluginUrl = pathToFileURL(appRequire.resolve('@modern-js/plugin-tanstack')).href;
+        const plugin = await import(pluginUrl);
+        if ('manifest' === mode) {
+            await plugin.writeRouteMetadataManifest({
+                appDirectory
+            });
+            console.log(`[ultramodern] Route metadata manifest generated: ${label}`);
+        } else {
+            await plugin.generateTanstackRouteArtifacts({
+                appDirectory
+            });
+            console.log(`[ultramodern] TanStack route artifacts generated: ${label}`);
+        }
+    } catch (error) {
+        process.exitCode = 1;
+        console.error(`[ultramodern] TanStack route generation failed: ${label}`);
+        let current = error;
+        let depth = 0;
+        while(current){
+            const detail = current instanceof Error ? current.stack ?? `${current.name}: ${current.message}` : String(current);
+            console.error(`${0 === depth ? '-' : '  caused by:'} ${detail}`);
+            current = current instanceof Error ? current.cause : void 0;
+            depth += 1;
+        }
+    }
+}
+main();