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

package/dist/esm-node/ultramodern-workspace/write-workspace.js

@@ -1,28 +1,28 @@
 import "node:module";
 import node_fs from "node:fs";
-import { RELEASE_COHORT_PROJECTION_PATH, copyCreateReleaseCohort, isCreatePackageSourceCheckout, readCreateReleaseCohort } from "../ultramodern-release-cohort.js";
+import { ULTRAMODERN_WORKSPACE_MODERN_PACKAGES, modernPackageSpecifier } from "../ultramodern-package-source.js";
+import { hasCreateReleaseCohort, isCreatePackageSourceCheckout, readCreateReleaseCohort, releaseCohortSelectors } from "../ultramodern-release-cohort.js";
 import { runFreshWorkspaceTransaction } from "./add-vertical/transaction.js";
 import { createSharedDesignTokensCss } from "./app-files.js";
 import { normalizeUltramodernBridgeConfig } from "./bridge-config.js";
-import { createDevelopmentOverlay, createOwnership, createTopology, createUltramodernConfig } from "./contracts.js";
-import { ULTRAMODERN_CONFIG_PATH, createShellHost, sharedPackages, shellApp } from "./descriptors.js";
+import { createDevelopmentOverlay, createOwnership, createTopology } from "./contracts.js";
+import { createShellHost, sharedPackages, shellApp } from "./descriptors.js";
 import { copyRootTemplate, formatGeneratedWorkspaceFiles, writeFile, writeFileReplacing, writeJson } from "./fs-io.js";
 import { createFileSnapshot, createGenerationResult, diffFileSnapshots } from "./generation-result.js";
 import { assertUniqueTailwindPrefixes, toPackageScope } from "./naming.js";
 import { runCodeSmithOverlays } from "./overlays.js";
 import { createRootPackageJson, createRootTsConfig, createSharedContractsIndex, createSharedPackage, createSharedPackageTsConfig, createTsConfigBase } from "./package-json.js";
 import { resolvePackageSource, resolveWorkspacePackageLinkingPolicy } from "./package-source.js";
-import { renderMinimumReleaseAgeExclude } from "./policy.js";
-import { DRIZZLE_ORM_VERSION, EFFECT_VERSION, EFFECT_VITEST_VERSION, I18NEXT_VERSION, MODULE_FEDERATION_VERSION, MSGPACKR_VERSION, NODE_FETCH_VERSION, NODE_VERSION, PNPM_VERSION, TANSTACK_HISTORY_VERSION, TANSTACK_ROUTER_CORE_VERSION, TANSTACK_ROUTER_VERSION, TYPESCRIPT_VERSION, WRANGLER_VERSION, ZOD_VERSION } from "./versions.js";
+import { EFFECT_VERSION, I18NEXT_VERSION, NODE_VERSION, PNPM_VERSION } from "./versions.js";
 import { writeGeneratedWorkspaceScripts } from "./workspace-scripts.js";
 import { writeApp } from "./write-app.js";
 import { createZeropsYaml } from "./zerops.js";
 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 sharedPackages){
-        writeJson(targetDir, `${sharedPackage.directory}/package.json`, createSharedPackage(scope, sharedPackage.id, sharedPackage.description));
+        writeJson(targetDir, `${sharedPackage.directory}/package.json`, createSharedPackage(scope, sharedPackage.id, sharedPackage.description, packageSource));
         writeJson(targetDir, `${sharedPackage.directory}/tsconfig.json`, createSharedPackageTsConfig(sharedPackage.directory));
     }
     writeFile(targetDir, 'packages/shared-contracts/src/index.ts', createSharedContractsIndex());
@@ -36,30 +36,25 @@ function writeSharedPackages(targetDir, scope) {
 `);
     writeFile(targetDir, 'packages/shared-design-tokens/src/tokens.css', createSharedDesignTokensCss());
 }
-function createCompactRootPackageJson(scope, packageSource, remotes, bridge) {
-    const rootPackage = createRootPackageJson(scope, packageSource, remotes, bridge);
-    if (rootPackage.modernjs?.packageSource && 'object' == typeof rootPackage.modernjs.packageSource) rootPackage.modernjs.packageSource.config = `./${ULTRAMODERN_CONFIG_PATH}`;
-    return rootPackage;
+function renderCatalogPolicy(packageSource) {
+    if ('install' !== packageSource.strategy) return '';
+    const catalog = ULTRAMODERN_WORKSPACE_MODERN_PACKAGES.map((name)=>`    ${JSON.stringify(name)}: ${JSON.stringify(modernPackageSpecifier(name, packageSource))}`).join('\n');
+    const cohort = hasCreateReleaseCohort() ? readCreateReleaseCohort() : void 0;
+    const pinsShippedCohort = cohort?.packages.every((item)=>modernPackageSpecifier(item.sourceName, packageSource) === `npm:${item.targetName}@${item.version}`);
+    const exclude = cohort && pinsShippedCohort ? `minimumReleaseAgeExclude:\n${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 = [
-    createShellHost()
-], enableTailwind = true, bridge, additionalShells = [], primaryShell) {
-    const config = 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 = node_fs.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');
-    writeFileReplacing(targetDir, 'pnpm-workspace.yaml', pnpmWorkspace.replace(/^packages:\r?\n(?: {2}- .+\r?\n)+/u, `packages:\n${renderedPackages}\n`));
+    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 = runFreshWorkspaceTransaction(options.targetDir, (stagingRoot)=>generateUltramodernWorkspaceInPlace({
@@ -72,19 +67,15 @@ function generateUltramodernWorkspaceInPlace(options, logicalWorkspaceRoot = opt
     const beforeFiles = createFileSnapshot(options.targetDir);
     const scope = toPackageScope(options.packageName);
     let packageSource;
-    let releaseCohort;
     if (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 = resolvePackageSource({
             ...options,
             packageSource: {
                 strategy: 'workspace'
             }
         });
-    } else {
-        packageSource = resolvePackageSource(options);
-        if ('install' === packageSource.strategy) releaseCohort = readCreateReleaseCohort();
-    }
+    } else packageSource = resolvePackageSource(options);
     const bridge = normalizeUltramodernBridgeConfig(options.bridge);
     const enableTailwind = false !== options.enableTailwind;
     const initialVerticals = [];
@@ -99,13 +90,9 @@ function generateUltramodernWorkspaceInPlace(options, logicalWorkspaceRoot = opt
     node_fs.mkdirSync(options.targetDir, {
         recursive: true
     });
-    const minimumReleaseAgeExclude = renderMinimumReleaseAgeExclude({
-        packageSource,
-        releaseCohort
-    });
     const workspacePackageLinkingPolicy = resolveWorkspacePackageLinkingPolicy(packageSource);
     const excludedRootTemplates = new Set([
-        RELEASE_COHORT_PROJECTION_PATH
+        "scripts/setup-agent-reference-repos.mjs"
     ]);
     if (false === options.generateAgentFiles) {
         excludedRootTemplates.add('AGENTS.md.handlebars');
@@ -116,37 +103,23 @@ function generateUltramodernWorkspaceInPlace(options, logicalWorkspaceRoot = opt
         packageScope: scope,
         nodeVersion: NODE_VERSION,
         pnpmVersion: PNPM_VERSION,
-        nodeFetchVersion: NODE_FETCH_VERSION,
-        drizzleOrmVersion: DRIZZLE_ORM_VERSION,
         effectVersion: EFFECT_VERSION,
-        effectVitestVersion: EFFECT_VITEST_VERSION,
         i18nextVersion: I18NEXT_VERSION,
-        moduleFederationVersion: MODULE_FEDERATION_VERSION,
-        msgpackrVersion: MSGPACKR_VERSION,
-        zodVersion: ZOD_VERSION,
-        tanstackHistoryVersion: TANSTACK_HISTORY_VERSION,
-        tanstackRouterCoreVersion: TANSTACK_ROUTER_CORE_VERSION,
-        tanstackRouterVersion: TANSTACK_ROUTER_VERSION,
-        typescriptVersion: TYPESCRIPT_VERSION,
-        wranglerVersion: 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) copyCreateReleaseCohort(options.targetDir);
-    writePnpmWorkspacePackages(options.targetDir, bridge);
-    writeJson(options.targetDir, 'package.json', createCompactRootPackageJson(scope, packageSource, initialVerticals, bridge));
+    writePnpmWorkspacePackages(options.targetDir, bridge, packageSource);
+    writeJson(options.targetDir, 'package.json', createRootPackageJson(scope, packageSource, initialVerticals, bridge));
     if (initialVerticals.length > 0) writeFile(options.targetDir, 'zerops.yaml', `${createZeropsYaml(scope, createdApps)}\n`);
     writeJson(options.targetDir, 'tsconfig.base.json', createTsConfigBase());
     writeJson(options.targetDir, 'tsconfig.json', createRootTsConfig(createdApps));
     writeJson(options.targetDir, 'topology/reference-topology.json', createTopology(scope, initialVerticals));
     writeJson(options.targetDir, 'topology/ownership.json', createOwnership(scope, initialVerticals));
     writeJson(options.targetDir, 'topology/local-overlays/development.json', createDevelopmentOverlay(scope, initialVerticals));
-    writeJson(options.targetDir, ULTRAMODERN_CONFIG_PATH, createCompactUltramodernConfig(scope, options.modernVersion, packageSource, createdApps, enableTailwind, bridge));
     writeApp(options.targetDir, scope, shellApp, packageSource, enableTailwind, initialVerticals, bridge);
     for (const remote of initialVerticals)writeApp(options.targetDir, scope, remote, packageSource, enableTailwind, initialVerticals, bridge);
-    writeSharedPackages(options.targetDir, scope);
-    writeGeneratedWorkspaceScripts(options.targetDir, scope, enableTailwind, initialVerticals, releaseCohort);
+    writeSharedPackages(options.targetDir, scope, packageSource);
+    writeGeneratedWorkspaceScripts(options.targetDir);
     const preliminaryAfterFiles = createFileSnapshot(options.targetDir);
     const preliminaryDiff = diffFileSnapshots(beforeFiles, preliminaryAfterFiles);
     const preliminaryResult = createGenerationResult({
@@ -176,4 +149,4 @@ function generateUltramodernWorkspaceInPlace(options, logicalWorkspaceRoot = opt
         rewrittenPaths
     });
 }
-export { createCompactUltramodernConfig, generateUltramodernWorkspace, writeApp };
+export { generateUltramodernWorkspace, writeApp };

package/dist/esm-node/ultramodern-workspace/zerops.js

@@ -32,6 +32,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/types/cli/project-setup.d.ts

@@ -4,5 +4,5 @@ export declare function runSetupCommand(command: string, args: string[], options
     timeoutMs?: number;
 }): string;
 export declare function commandExists(command: string): boolean;
-export declare function initializeGeneratedGitRepository(targetDir: string): void;
+export declare function initializeGeneratedGitRepository(targetDir: string): boolean;
 export declare function isDirectoryEmpty(dirPath: string): boolean;

package/dist/types/locale/en.d.ts

@@ -18,6 +18,7 @@ export declare const EN_LOCALE: {
         step1: string;
         step2: string;
         step3: string;
+        initialCommit: string;
     };
     agentsCmd: {
         created: string;

package/dist/types/locale/index.d.ts

@@ -20,6 +20,7 @@ declare const localeKeys: {
         step1: string;
         step2: string;
         step3: string;
+        initialCommit: string;
     };
     agentsCmd: {
         created: string;
@@ -106,6 +107,7 @@ declare const localeKeys: {
         step1: string;
         step2: string;
         step3: string;
+        initialCommit: string;
     };
     agentsCmd: {
         created: string;

package/dist/types/locale/zh.d.ts

@@ -18,6 +18,7 @@ export declare const ZH_LOCALE: {
         step1: string;
         step2: string;
         step3: string;
+        initialCommit: string;
     };
     agentsCmd: {
         created: string;

package/dist/types/ultramodern-package-source.d.ts

@@ -1,13 +1,11 @@
 export declare const WORKSPACE_PACKAGE_VERSION = "workspace:*";
 export declare const ULTRAMODERN_CREATE_PACKAGE = "@modern-js/ultramodern-create";
 export declare const BLEEDINGDEV_CREATE_PACKAGE = "@bleedingdev/modern-js-ultramodern-create";
-export declare const LEGACY_BLEEDINGDEV_CREATE_PACKAGE = "@bleedingdev/modern-js-create";
 export declare const BLEEDINGDEV_PACKAGE_SCOPE = "bleedingdev";
 export declare const BLEEDINGDEV_PACKAGE_NAME_PREFIX = "modern-js-";
 export declare const ULTRAMODERN_FRAMEWORK_VERSION_ENV = "ULTRAMODERN_CREATE_FRAMEWORK_VERSION";
-export declare const BLEEDINGDEV_FRAMEWORK_VERSION_ENV = "MODERN_CREATE_ULTRAMODERN_FRAMEWORK_VERSION";
-export declare const ULTRAMODERN_SINGLE_APP_MODERN_PACKAGES: readonly ["@modern-js/ultramodern-create", '@modern-js/code-tools', '@modern-js/runtime', '@modern-js/app-tools', '@modern-js/tsconfig', '@modern-js/plugin-i18n', '@modern-js/plugin-tanstack', '@modern-js/plugin-bff', '@modern-js/adapter-rstest'];
-export declare const ULTRAMODERN_WORKSPACE_MODERN_PACKAGES: readonly ["@modern-js/ultramodern-create", '@modern-js/code-tools', '@modern-js/app-tools', '@modern-js/plugin-bff', '@modern-js/plugin-i18n', '@modern-js/plugin-tanstack', '@modern-js/runtime'];
+export declare const ULTRAMODERN_SINGLE_APP_MODERN_PACKAGES: readonly ["@modern-js/ultramodern-create", '@modern-js/code-tools', '@modern-js/runtime', '@modern-js/app-tools', '@modern-js/tsconfig', '@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'];
+export declare const ULTRAMODERN_WORKSPACE_MODERN_PACKAGES: readonly ['@modern-js/bff-effect', '@modern-js/boundary-debugger', "@modern-js/ultramodern-create", '@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-extensions', '@modern-js/runtime-renderer-extensions', '@modern-js/federation-runtime', '@modern-js/app-tools-extensions', '@modern-js/ultramodern-app-tools'];
 export type UltramodernPackageSourceStrategy = 'workspace' | 'install';
 export type ResolvedUltramodernPackageSource = {
     strategy: UltramodernPackageSourceStrategy;

package/dist/types/ultramodern-release-cohort.d.ts

@@ -1,5 +1,5 @@
 import type { ResolvedUltramodernPackageSource } from './ultramodern-package-source.js';
-export declare const RELEASE_COHORT_PROJECTION_PATH = ".modernjs/release-cohort.json";
+export declare const RELEASE_COHORT_PATH = "release-cohort.json";
 type ReleaseCohortPackage = {
     sourceName: string;
     targetName: string;
@@ -23,8 +23,6 @@ export declare function parseUltramodernReleaseCohort(value: unknown): Ultramode
 export declare function readCreateReleaseCohort(): UltramodernReleaseCohort;
 export declare function hasCreateReleaseCohort(): boolean;
 export declare function isCreatePackageSourceCheckout(): boolean;
-export declare function readWorkspaceReleaseCohort(workspaceRoot: string): UltramodernReleaseCohort;
-export declare function copyCreateReleaseCohort(workspaceRoot: string): UltramodernReleaseCohort;
 export declare function assertReleaseCohortPackageSource(cohort: UltramodernReleaseCohort, packageSource: ResolvedUltramodernPackageSource): UltramodernReleaseCohort | undefined;
 export declare function releaseCohortSelectors(cohort: UltramodernReleaseCohort): string[];
 export {};

package/dist/types/ultramodern-tooling/commands/cloudflare-output-verify.d.ts

@@ -1,2 +1,2 @@
-import { type CommandContext } from './context.js';
-export declare function runCloudflareOutputVerify(args: string[], context: CommandContext): number;
+import type { CommandContext } from './context.js';
+export declare function runCloudflareOutputVerify(args: string[], context: CommandContext): Promise<0 | 1>;

package/dist/types/ultramodern-tooling/commands/context.d.ts

@@ -3,9 +3,12 @@ export type CommandContext = {
     workspaceRoot: string;
     invocationCwd: string;
 };
+export declare const AD_HOC_TOOLING_COMMANDS: {
+    readonly syncDeliveryUnit: 'sync-delivery-unit';
+    readonly skills: 'skills';
+};
 export declare function printHelp(): void;
 export declare function spawnNodeScript(relativeScriptPath: string, args: string[], context: CommandContext, options?: {
     cwd?: string;
 }): number;
 export declare function runTemplateBackedToolingCommand(command: string, args: string[], context: CommandContext): number | undefined;
-export declare function runRenderedModule(source: string, context: CommandContext): number;

package/dist/types/ultramodern-tooling/commands/routes-generate-app.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/ultramodern-tooling/commands/routes-generate.d.ts

@@ -1,2 +1,2 @@
 import { type CommandContext } from './context.js';
-export declare function runRoutesGenerate(args: string[], context: CommandContext): number;
+export declare function runRoutesGenerate(args: string[], context: CommandContext): 0 | 1;

package/dist/types/ultramodern-tooling/commands/validate.d.ts

@@ -1,2 +1,2 @@
-import { type CommandContext } from './context.js';
+import type { CommandContext } from './context.js';
 export declare function runValidate(context: CommandContext): number;

package/dist/types/ultramodern-tooling/config/index.d.ts

@@ -1,7 +1,5 @@
-export * from './constants.js';
 export * from './json.js';
 export * from './load.js';
 export * from './metadata.js';
 export * from './normalize.js';
-export * from './synthesize.js';
 export * from './types.js';

package/dist/types/ultramodern-tooling/config/load.d.ts

@@ -1,2 +1,10 @@
-import type { UltramodernToolingConfig } from './types.js';
-export declare function readUltramodernConfig(workspaceRoot?: string): UltramodernToolingConfig;
+import { type UltramodernWorkspaceInputs } from './normalize.js';
+export declare function readUltramodernConfig(workspaceRoot?: string): import("./types.js").UltramodernToolingConfig;
+export declare function readUltramodernWorkspaceInputs(workspaceRoot?: string, inputs?: Partial<UltramodernWorkspaceInputs>): {
+    raw: UltramodernWorkspaceInputs;
+    config: import("./types.js").UltramodernToolingConfig;
+    apps: import("../../ultramodern-workspace/types.js").WorkspaceApp[];
+    primaryShell: import("../../ultramodern-workspace/types.js").WorkspaceApp;
+    verticals: import("../../ultramodern-workspace/types.js").WorkspaceApp[];
+    additionalShells: import("../../ultramodern-workspace/types.js").WorkspaceApp[];
+};

package/dist/types/ultramodern-tooling/config/metadata.d.ts

@@ -1,4 +1,4 @@
 import type { ResolvedPackageSource } from '../../ultramodern-workspace/types.js';
 export declare function packageScopeFromRoot(workspaceRoot: string): string;
-export declare function packageSourceFromMetadata(workspaceRoot: string): ResolvedPackageSource | undefined;
-export declare function readOverlayPorts(workspaceRoot: string): Record<string, number>;
+/** Native dependency requests own the source; no application config is loaded. */
+export declare function readWorkspacePackageSource(workspaceRoot: string): ResolvedPackageSource;

package/dist/types/ultramodern-tooling/config/normalize.d.ts

@@ -1,22 +1,22 @@
 import type { WorkspaceApp } from '../../ultramodern-workspace/types.js';
 import type { UltramodernToolingConfig } from './types.js';
-type UnsupportedUltramodernConfigIssue = {
-    field: 'schemaVersion';
-    value: unknown;
-    reason: 'missing' | 'non-integer' | 'unsupported';
-} | {
-    field: 'topology.apps.kind';
-    index: number;
-    value: unknown;
+export type UltramodernWorkspaceInputs = {
+    topology: Record<string, any>;
+    overlay: Record<string, any>;
 };
-export declare class UnsupportedUltramodernConfigError extends Error {
-    readonly sourcePath: string;
-    readonly issue: UnsupportedUltramodernConfigIssue;
-    constructor(sourcePath: string, issue: UnsupportedUltramodernConfigIssue);
-}
-export declare function normalizeCompactConfig(workspaceRoot: string, sourcePath: string, config: Record<string, any>): UltramodernToolingConfig;
-export declare function normalizeCompactUltramodernConfig(workspaceRoot: string, compact: Record<string, any>): UltramodernToolingConfig;
-export declare function workspaceAppsFromToolingConfig(config: UltramodernToolingConfig): WorkspaceApp[];
-export declare function additionalShellsFromToolingConfig(config: UltramodernToolingConfig): WorkspaceApp[];
-export declare function allWorkspaceAppsFromToolingConfig(config: UltramodernToolingConfig): WorkspaceApp[];
-export {};
+/** Resolve declarative application membership without executing application code. */
+export declare function normalizeWorkspaceInputs(workspaceRoot: string, inputs: UltramodernWorkspaceInputs): {
+    raw: UltramodernWorkspaceInputs;
+    config: UltramodernToolingConfig;
+    apps: WorkspaceApp[];
+    primaryShell: WorkspaceApp;
+    verticals: WorkspaceApp[];
+    additionalShells: WorkspaceApp[];
+};
+export declare function workspaceAppsFromToolingConfig(config: UltramodernToolingConfig, _workspaceRoot?: string): WorkspaceApp[];
+export declare function allWorkspaceAppsFromToolingConfig(config: UltramodernToolingConfig, workspaceRoot?: string): WorkspaceApp[];
+/** Refresh only exact former generated URLs; authored overlay choices survive. */
+export declare function reconcileGeneratedOverlayUrls(existing: Record<string, any>, previous: Record<string, any>, projected: Record<string, any>): {
+    [k: string]: any;
+};
+export declare function preserveUnknownProjectionFields(current: any, projected: any): any;

package/dist/types/ultramodern-tooling/config/types.d.ts

@@ -1,6 +1,4 @@
-import type { UltramodernBridgeConfig } from '../../ultramodern-workspace/bridge-config/index.js';
 import type { ResolvedPackageSource, VerticalPreset, WorkspaceApi, WorkspaceApp, WorkspaceDeliveryUnitKind } from '../../ultramodern-workspace/types.js';
-export type UltramodernToolingConfigSource = 'compact';
 export type UltramodernToolingConfigApp = {
     id: string;
     kind: WorkspaceApp['kind'];
@@ -11,6 +9,7 @@ export type UltramodernToolingConfigApp = {
     domain?: string;
     surfaceProfile?: VerticalPreset;
     deliveryUnitKind?: WorkspaceDeliveryUnitKind;
+    deliveryUnit?: WorkspaceApp['deliveryUnit'];
     port?: number;
     portEnv?: string;
     moduleFederation?: {
@@ -25,10 +24,6 @@ export type UltramodernToolingConfigApp = {
     api?: WorkspaceApi;
 };
 export type UltramodernToolingConfig = {
-    schemaVersion: number;
-    profile?: string;
-    source: UltramodernToolingConfigSource;
-    sourcePath: string;
     workspace: {
         packageScope: string;
     };
@@ -36,10 +31,8 @@ export type UltramodernToolingConfig = {
     features: {
         tailwind: boolean;
     };
-    bridge?: UltramodernBridgeConfig;
+    inheritedWorkspaceDependencies: Record<string, string>;
     topology: {
         apps: UltramodernToolingConfigApp[];
     };
-    /** Additional shells live in the additive compact-config collection. */
-    shells?: Array<Record<string, unknown>>;
 };

package/dist/types/ultramodern-workspace/add-shell.d.ts

@@ -7,7 +7,7 @@ import type { AddUltramodernShellOptions, UltramodernGenerationResult, Ultramode
 export declare function addUltramodernShell(options: AddUltramodernShellOptions): UltramodernGenerationResult;
 /**
  * Dry-run parity for {@link addUltramodernShell} (G28). Applies the operation
- * against a throwaway copy of the workspace and returns the planned result
+ * through the shared transaction preparation path and returns the planned result
  * (created/rewritten paths, delivery-unit identity) without touching the real
  * workspace.
  */

package/dist/types/ultramodern-workspace/add-vertical/execute.d.ts

@@ -7,3 +7,4 @@ import type { AddUltramodernVerticalOptions, UltramodernGenerationResult } from
  * pre-call state and the error is rethrown.
  */
 export declare function addUltramodernVertical(options: AddUltramodernVerticalOptions): UltramodernGenerationResult;
+export declare function executeAddUltramodernVertical(options: AddUltramodernVerticalOptions, logicalWorkspaceRoot?: string): UltramodernGenerationResult;

package/dist/types/ultramodern-workspace/add-vertical/preflight.d.ts

@@ -1,3 +1,4 @@
+import { normalizeWorkspaceInputs } from '../../ultramodern-tooling/config/index.js';
 import type { UltramodernBridgeConfig } from '../bridge-config/index.js';
 import type { AddUltramodernVerticalOptions, ResolvedPackageSource, WorkspaceApp } from '../types.js';
 export type AddUltramodernVerticalPreflight = {
@@ -13,7 +14,7 @@ export type AddUltramodernVerticalPreflight = {
     packageSource: ResolvedPackageSource;
     enableTailwind: boolean;
     bridge?: UltramodernBridgeConfig;
-    config: Record<string, any>;
+    config: ReturnType<typeof normalizeWorkspaceInputs>['config'];
     primaryShell: WorkspaceApp;
     additionalShells: WorkspaceApp[];
     targetShell: WorkspaceApp;
@@ -29,7 +30,7 @@ export type UnknownUltramodernShellIssue = {
 };
 /**
  * Typed preflight rejection for an add-vertical request whose shell target is
- * not present in the workspace's additive config.shells collection.
+ * not present in the workspace topology's shells collection.
  */
 export declare class UnknownUltramodernShellError extends Error {
     readonly sourcePath: string;
@@ -38,5 +39,5 @@ export declare class UnknownUltramodernShellError extends Error {
     constructor(sourcePath: string, requestedShellId: string, available: string[]);
 }
 export declare function prepareAddUltramodernVertical(options: AddUltramodernVerticalOptions): AddUltramodernVerticalPreflight;
-export declare function createPrimaryShellDescriptor(topology: Record<string, any>, config: Record<string, any>): WorkspaceApp;
+export declare function readRequiredJsonObject(filePath: string): Record<string, any>;
 export declare function assertNonEmptyString(value: unknown, label: string): void;

package/dist/types/ultramodern-workspace/add-vertical/preview.d.ts

@@ -0,0 +1,4 @@
+import type { UltramodernJsonMutation } from '../types.js';
+import type { WorkspaceChange } from './transaction.js';
+/** Describe the prepared bytes, so preview cannot invent writes that apply omits. */
+export declare function describeJsonChanges(changes: readonly WorkspaceChange[]): UltramodernJsonMutation[];

package/dist/types/ultramodern-workspace/add-vertical/shell-files.d.ts

@@ -1,4 +1,9 @@
 import type { UltramodernBridgeConfig } from '../bridge-config/index.js';
 import type { ResolvedPackageSource, WorkspaceApp } from '../types.js';
-export declare function updateRootWorkspaceScripts(workspaceRoot: string, scope: string, packageSource: ResolvedPackageSource, remotes: WorkspaceApp[], bridge?: UltramodernBridgeConfig, additionalShells?: WorkspaceApp[]): void;
-export declare function rewriteShellAppFiles(workspaceRoot: string, scope: string, packageSource: ResolvedPackageSource, enableTailwind: boolean, remotes: WorkspaceApp[], bridge?: UltramodernBridgeConfig, shell?: WorkspaceApp, devPorts?: number[]): void;
+export declare function updateRootWorkspaceScripts(workspaceRoot: string, scope: string, packageSource: ResolvedPackageSource, remotes: WorkspaceApp[], bridge?: UltramodernBridgeConfig, additionalShells?: WorkspaceApp[], previousRemotes?: WorkspaceApp[], _primaryShell?: WorkspaceApp, previousAdditionalShells?: WorkspaceApp[]): void;
+export declare function rewriteShellAppFiles(workspaceRoot: string, scope: string, packageSource: ResolvedPackageSource, enableTailwind: boolean, remotes: WorkspaceApp[], bridge?: UltramodernBridgeConfig, shell?: WorkspaceApp, devPorts?: number[], previous?: {
+    shell: WorkspaceApp;
+    remotes: WorkspaceApp[];
+    devPorts?: number[];
+    enableTailwind?: boolean;
+}): void;

package/dist/types/ultramodern-workspace/add-vertical/transaction.d.ts

@@ -1,3 +1,13 @@
+type WorkspaceFile = {
+    content: Buffer;
+    mode: number;
+    symlink?: true;
+};
+export type WorkspaceChange = {
+    relativePath: string;
+    before?: WorkspaceFile;
+    after?: WorkspaceFile;
+};
 export declare class WorkspaceTransactionConflictError extends Error {
     readonly code: 'workspace-transaction-conflict';
     constructor(message: string, options?: {
@@ -20,6 +30,11 @@ export declare const __transactionTestHooks: {
         workspaceRoot: string;
         relativePath: string;
     }) => void;
+    afterPublishPath?: (details: {
+        workspaceRoot: string;
+        relativePath: string;
+        index: number;
+    }) => void;
     beforeFreshPublish?: (details: {
         workspaceRoot: string;
     }) => void;
@@ -31,19 +46,30 @@ export declare const __transactionTestHooks: {
  * observably wrong after a successful transaction.
  */
 export declare function relocateStagedWorkspaceReferences(stagingRoot: string, workspaceRoot: string): void;
+/** Creation only recovers receipts from an interrupted empty-target creation. */
+export declare function recoverFreshWorkspaceTransactions(root: string): void;
+/** Recover only our validated durable publication receipts, never unknown stages. */
+export declare function recoverWorkspaceTransactions(root: string, purpose?: 'update' | 'fresh-empty'): void;
 /**
  * Run an existing-workspace mutation against a private sibling. Only the
  * semantic file changes produced there are published, and every owned target
  * must still match its exact preimage. Unrelated workspace files are never
  * copied back, so concurrent consumer work is conserved without a lock.
+ * Preview prepares and inspects the same change set, then discards its stage;
+ * it never publishes or recovers an earlier transaction into the live tree.
  */
-export declare function runWorkspaceTransaction<T>(root: string, mutate: (stagingRoot: string) => T): T;
+export declare function runWorkspaceTransaction<T>(root: string, mutate: (stagingRoot: string) => T, options?: {
+    mode?: 'publish' | 'preview';
+    commitWhen?: (result: Awaited<T>) => boolean;
+    inspectChanges?: (changes: readonly WorkspaceChange[]) => void;
+}): T;
 /**
  * Fully stage a fresh workspace beside its resolved target and publish the
- * complete tree with one directory rename. An already-empty target needs a
- * narrow empty-directory swap (the canonical path is briefly absent) so CLI
- * generation in an empty cwd retains its contract without exposing a partial
- * tree. Node has no portable no-replace directory rename, so an external
- * process can still win the narrow final preflight-to-rename race.
+ * complete tree with one directory rename, except for an empty Windows cwd,
+ * whose held directory is retained by the recoverable per-file publisher.
+ * Other already-empty targets use a narrow empty-directory swap (the canonical
+ * path is briefly absent). Node has no portable no-replace directory rename,
+ * so an external process can still win the final preflight-to-rename race.
  */
 export declare function runFreshWorkspaceTransaction<T>(targetDir: string, generate: (stagingRoot: string) => T): T;
+export {};

package/dist/types/ultramodern-workspace/add-vertical/workspace-state.d.ts

@@ -1,11 +1,14 @@
-import type { UltramodernBridgeConfig } from '../bridge-config/index.js';
-import type { ResolvedPackageSource, UltramodernWorkspaceOptions, WorkspaceApp } from '../types.js';
-export declare function existingPackageSource(workspaceRoot: string, modernVersion: string, packageSource?: UltramodernWorkspaceOptions['packageSource']): ResolvedPackageSource;
-export declare function existingTailwindEnabled(workspaceRoot: string): boolean;
-export declare function existingBridgeConfig(workspaceRoot: string): UltramodernBridgeConfig | undefined;
+import type { UltramodernToolingConfig } from '../../ultramodern-tooling/config/index.js';
+import type { AddUltramodernShellOptions, WorkspaceApp } from '../types.js';
+/** Resolve command overrides against the already normalized input snapshot. */
+export declare function workspaceOperationSettings(options: AddUltramodernShellOptions, config: UltramodernToolingConfig): {
+    packageSource: import("../../ultramodern-package-source.js").ResolvedUltramodernPackageSource;
+    enableTailwind: boolean;
+    bridge: undefined;
+};
 export declare function assertValidVerticalName(name: string): string;
-export declare function configuredDevelopmentPorts(ports: Record<string, unknown>, additionalShells?: WorkspaceApp[]): number[];
-export declare function assertGlobalPortUniqueness(ports: Record<string, unknown>, additionalShells?: WorkspaceApp[]): void;
+export declare function configuredDevelopmentPorts(ports: Record<string, unknown>, _additionalShells?: WorkspaceApp[]): number[];
+export declare function assertGlobalPortUniqueness(ports: Record<string, unknown>, _additionalShells?: WorkspaceApp[]): void;
 /**
  * Allocate from the one workspace-wide port set. The caller supplies the
  * lower bound for its app class (verticals start at 4101; additional shells at

package/dist/types/ultramodern-workspace/add-vertical.d.ts

@@ -4,4 +4,4 @@ export type { AddUltramodernVerticalPreflight } from './add-vertical/preflight.j
 export { prepareAddUltramodernVertical } from './add-vertical/preflight.js';
 export { rewriteShellAppFiles, updateRootWorkspaceScripts, } from './add-vertical/shell-files.js';
 export { ownershipEntry, verticalsFromTopology, verticalTopologyEntry, } from './add-vertical/topology.js';
-export { assertCanCreate, assertValidVerticalName, existingBridgeConfig, existingPackageSource, existingTailwindEnabled, nextAvailablePort, } from './add-vertical/workspace-state.js';
+export { assertCanCreate, assertValidVerticalName, nextAvailablePort, } from './add-vertical/workspace-state.js';

package/dist/types/ultramodern-workspace/api/client.d.ts

@@ -2,5 +2,7 @@ import type { WorkspaceApi, WorkspaceApp } from '../types.js';
 export declare function createApiClient(service: {
     id: string;
     api?: WorkspaceApi;
-}, contractImportPath: string): string;
+}, contractImportPath: string, options?: {
+    readonly scope: string;
+}): string;
 export declare function createShellApiClient(scope: string, remotes?: WorkspaceApp[]): string;

package/dist/types/ultramodern-workspace/api/rpc.d.ts

@@ -37,5 +37,5 @@ export declare function createRpcApiServiceEntry(service: ApiService): string;
  * Generate the RPC client file (`src/api/${stem}-rpc-client.ts`) built from the
  * shared `RpcGroup` through Effect BFF's public HTTP RPC client primitive.
  */
-export declare function createRpcClientFile(service: ApiService): string;
+export declare function createRpcClientFile(service: ApiService, contractImportPath?: string): string;
 export {};

package/dist/types/ultramodern-workspace/api/service.d.ts

@@ -2,5 +2,7 @@ import type { WorkspaceApi, WorkspaceApp } from '../types.js';
 export declare function createApiServiceEntry(service: {
     id: string;
     api?: WorkspaceApi;
-}, contractImportPath: string): string;
+}, contractImportPath: string, options?: {
+    readonly scope: string;
+}): string;
 export declare function createBackendEffectApiExpose(scope: string, service: WorkspaceApp): string;

package/dist/types/ultramodern-workspace/api/shared.d.ts

@@ -2,4 +2,6 @@ import type { WorkspaceApi } from '../types.js';
 export declare function createSharedApi(service: {
     id: string;
     api?: WorkspaceApi;
+}, options?: {
+    readonly scope: string;
 }): string;

package/dist/types/ultramodern-workspace/backend-federation.d.ts

@@ -1,4 +1,4 @@
-import { BACKEND_FEDERATION_CONTRACT_VERSION, BACKEND_FEDERATION_NODE_ADAPTER_VERSION } from '@modern-js/utils/universal';
+import { BACKEND_FEDERATION_CONTRACT_VERSION, BACKEND_FEDERATION_NODE_ADAPTER_VERSION } from '@modern-js/backend-federation-contracts';
 import type { JsonValue, WorkspaceApp } from './types.js';
 export { BACKEND_FEDERATION_CONTRACT_VERSION, BACKEND_FEDERATION_NODE_ADAPTER_VERSION, };
 export declare function createWorkerBindingName(app: WorkspaceApp): string;

package/dist/types/ultramodern-workspace/contracts.d.ts

@@ -1,6 +1,4 @@
-import type { UltramodernBridgeConfig } from './bridge-config/index.js';
-import type { JsonValue, ResolvedPackageSource, WorkspaceApp } from './types.js';
+import type { JsonValue, WorkspaceApp } from './types.js';
 export declare function createTopology(scope: string, remotes?: WorkspaceApp[], primaryShell?: WorkspaceApp): JsonValue;
 export declare function createOwnership(scope: string, remotes?: WorkspaceApp[]): JsonValue;
 export declare function createDevelopmentOverlay(scope: string, remotes?: WorkspaceApp[]): JsonValue;
-export declare function createUltramodernConfig(scope: string, modernVersion: string, packageSource: ResolvedPackageSource, apps?: WorkspaceApp[], enableTailwind?: boolean, bridge?: UltramodernBridgeConfig, additionalShells?: WorkspaceApp[], primaryShell?: WorkspaceApp): JsonValue;