@vmz/vmz 0.0.3 → 0.1.0

package/dist/index.d.ts

@@ -14,8 +14,8 @@ export declare function expectedProtocol(): {
     pluginProtocol: string;
 };
 /**
- * Resolve native `.node` via the platform optionalDependency only
- * (`@vmz/vmz-<short>` from pnpm workspace or published npm).
+ * Resolve native `.node` via the platform optionalDependency
+ * (`@vmz/vmz-<short>`; transitional fallback `@vmz/vmz-<short>`).
  * @returns {string}
  */
 export declare function resolveNativePath(): any;
@@ -138,14 +138,30 @@ export declare function checkApplicationHostCompositionJson(hostRoot: any, packa
  */
 export declare function checkApplicationDevTestDeployJson(hostRoot: any, packageRoots: any, dirtyPaths?: any[]): any;
 export { createDevSession, listWatchedFiles, srcFingerprint } from './dev-session.js';
+export { findAvailablePort } from './port.js';
 export { runCli, parseArgs, printHelp, printGlobalHelp, printProjectHelp } from './cli.js';
 export { findNearestProjectVmz, getInvocationContext, isGlobalAllowedCommand, isUnderNodeModules, resolveThisPackageRoot, resolveVmzBin, gateGlobalProjectCommand, } from './invocation.js';
 export { resolveWorkspaceDirs, findPackageJson, readPackageMeta } from './resolve.js';
 export { resolvePackageRoot, resolveWorkspacePackages } from './packages.js';
 export { log } from './log.js';
 export { cmdApplication, runCheck as runApplicationCheck } from './application-cmd.js';
+export { cmdArtifact } from './release-cmd.js';
+export { ARTIFACT_DIFF_SCHEMA, DELIVERY_ARTIFACT_MANIFEST_SCHEMA, RELEASE_ENVELOPE_SCHEMA, ROUTE_REALIZATION_TABLE_SCHEMA, atomicWritePointer, canonicalJson, diffArtifacts, loadReleaseEnvelope, packRelease, publishRelease, readPointer, rollbackRelease, sha256File, sha256Hex, } from './release-pack.js';
+export { STATIC_DELIVERY_MANIFEST_SCHEMA, emitWebStatic, } from './static-emit.js';
+export { CONTENT_ADDRESSED_ASSETS_SCHEMA, emitContentAddressedAssets, resolveAssetByDigest, assertSharedAssetPath, contentAddressedAssetsDigest, } from './content-addressed-assets.js';
+export { CDN_POLICY_MANIFEST_SCHEMA, CDN_ADAPTER_PROJECTION_SCHEMA, CACHE_HTML, CACHE_ASSET_IMMUTABLE, CACHE_META, buildCdnPolicyManifest, emitCdnPolicy, projectCdnAdapter, createLocalStaticHandler, listenLocalStaticHost, matchGlob, } from './cdn-policy.js';
+export { SITE_DELIVERY_CONTRACT_SCHEMA, SITE_DELIVERY_RESOLUTION_SCHEMA, defineSite, normalizeSiteDelivery, normalizeSourceProbe, resolveSiteRelease, probeReleaseDirectory, emitSiteDelivery, } from './site-delivery.js';
+export { EMBEDDED_RESOURCE_INDEX_SCHEMA, emitEmbeddedPackaging, } from './embedded-packaging.js';
+export { SERVER_LANG_IDS, SERVER_LANG_ALIASES, SERVER_LANGUAGE_BACKENDS, resolveServerLanguage, assertLangRuntimePair, } from './server-language-backend.js';
+export { DELIVERY_PROFILE_AUTHORING_SCHEMA, BUILD_PROFILE_SELECTION_SCHEMA, ASSEMBLIES, SERVER_RUNTIMES, BUILTIN_PROFILES, pickSiteAuthoring, normalizeDeliveryAuthoring, selectBuildProfile, semanticIdsForAssembly, } from './delivery-profile.js';
+export { PACK_MANIFEST_SCHEMA, packFromDeploymentIr, ensureRuntimeCompanions } from './pack.js';
+export { SERVER_ARTIFACT_SCHEMA, HTTP_CONTRACT_SCHEMA, SERVER_RUNTIME_ADAPTER_SCHEMA, emitServerArtifact, projectServerRuntimeAdapter, } from './server-artifact.js';
+export { BUILD_PROOF_SCHEMA, ASSEMBLE_MANIFEST_SCHEMA, assembleDelivery, emitBuildProof, } from './build-assemble.js';
+export { PRODUCTION_SCENARIO_PACK_SCHEMA, PRODUCTION_CI_PROFILE_SCHEMA, PRODUCTION_TEST_REPORT_SCHEMA, browserProductionScenarioPack, browserProductionCiProfile, normalizeScenarioPack, normalizeCiProfile, scenarioPackDigest, ciProfileDigest, buildProductionTestReport, productionTestReportDigest, emitProductionTestArtifacts, assertNoForbiddenRunners, } from './production-test-pack.js';
+export { PRODUCTION_OBSERVABILITY_SCHEMA, PRODUCTION_TRACE_SCHEMA, REQUIRED_TRACE_FACETS, browserProductionObservability, normalizeObservability, redactSensitive, validateProductionTrace, buildCoveringProductionTrace, checkProductionBudgets, checkCapabilityClosure, applySecurityHeadersToCdnPolicy, measureDistBudgets, emitProductionObservability, observabilityDigest, } from './production-observability.js';
 export { buildApplicationContext, buildFormatterContext, checkLocaleRuntime, checkSsrClientParity, createLocaleSession, formatMessageTemplate, formatterContextDigest, negotiateLocale, resolveMessageVariant, validateFormatterContext, } from './locale-runtime.js';
-export { absoluteUrl, assertLocaleCacheKey, buildLocalePageMeta, buildLocaleRouteRealizationTable, checkLocaleRouter, commitLocaleRouteMetaTransition, localeAwareCacheKey, parseLocaleFromPath, planLocalePathNavigation, realizeRoutePath, resolveLinkHref, } from './locale-router.js';
+export { absoluteUrl, assertLocaleCacheKey, buildLocalePageMeta, buildLocaleRouteRealizationTable, checkLocaleRouter, commitLocaleRouteMetaTransition, localeAwareCacheKey, localizeBodyLinks, localizeSameAppHref, parseLocaleFromPath, planLocalePathNavigation, realizeRoutePath, resolveLinkHref, } from './locale-router.js';
+export { LOCALE_ROUTE_REALIZATION_ARTIFACT_SCHEMA, emitLocaleRouteRealization, } from './locale-route-emit.js';
 export { assertHostMessageInvariant, assertServerErrorEnvelope, assertServerFormatContext, buildLocaleDeliveryResolution, checkLocaleDelivery, fallbackDigest, messageCatalogHash, proveMiniPackageMessages, validateNativeLocalePack, } from './locale-delivery.js';
 export { checkLocaleConformance, diffLocaleCatalogs, explainLocaleMessage, extractHardcodedText, pseudoLocalizeCatalog, } from './locale-tooling.js';
 export { applyPlugins, contentHash, defineConfig, definePlugin, loadVmzConfig, } from './plugin-host.js';

package/dist/index.js

@@ -52,32 +52,34 @@ function platformShort(triple = platformTriple()) {
     return triple;
 }
 /**
- * Resolve native `.node` via the platform optionalDependency only
- * (`@vmz/vmz-<short>` from pnpm workspace or published npm).
+ * Resolve native `.node` via the platform optionalDependency
+ * (`@vmz/vmz-<short>`; transitional fallback `@vmz/vmz-<short>`).
  * @returns {string}
  */
 export function resolveNativePath() {
     const triple = platformTriple();
     const short = platformShort(triple);
-    const name = `@vmz/vmz-${short}`;
+    const names = [`@vmz/vmz-${short}`, `@vmz/vmz-${short}`];
     /** @type {string[]} */
     const candidates = [];
-    try {
-        const resolved = require.resolve(`${name}/package.json`);
-        const dir = path.dirname(resolved);
-        // Prefer platform-named binary; plain `vmz.node` is legacy-only.
-        candidates.push(path.join(dir, `vmz.${triple}.node`), path.join(dir, 'vmz.node'));
-    }
-    catch {
-        /* optional dep not installed */
+    for (const name of names) {
+        try {
+            const resolved = require.resolve(`${name}/package.json`);
+            const dir = path.dirname(resolved);
+            // Prefer platform-named binary; plain `vmz.node` is legacy-only.
+            candidates.push(path.join(dir, `vmz.${triple}.node`), path.join(dir, 'vmz.node'));
+        }
+        catch {
+            /* optional dep not installed */
+        }
+        // pnpm may nest under the @vmz/vmz package's node_modules
+        candidates.push(path.join(pkgRoot, 'node_modules', name, `vmz.${triple}.node`), path.join(pkgRoot, 'node_modules', name, 'vmz.node'));
     }
-    // pnpm may nest under the vmz package's node_modules
-    candidates.push(path.join(pkgRoot, 'node_modules', name, `vmz.${triple}.node`), path.join(pkgRoot, 'node_modules', name, 'vmz.node'));
     for (const p of candidates) {
         if (existsSync(p))
             return p;
     }
-    throw new Error(`vmz native addon not found for ${name}. Run: pnpm napi:build (writes packages/runtimes/vmz-${short}/)\n` +
+    throw new Error(`vmz native addon not found for @vmz/vmz-${short}. Run: pnpm napi:build (writes packages/runtimes/vmz-${short}/)\n` +
         `Looked in:\n${candidates.map((c) => `  - ${c}`).join('\n')}`);
 }
 let _native;
@@ -316,14 +318,32 @@ export function checkApplicationDevTestDeployJson(hostRoot, packageRoots, dirtyP
     return native.checkApplicationDevTestDeployJson(hostRoot, packageRoots, dirtyPaths);
 }
 export { createDevSession, listWatchedFiles, srcFingerprint } from './dev-session.js';
+export { findAvailablePort } from './port.js';
 export { runCli, parseArgs, printHelp, printGlobalHelp, printProjectHelp } from './cli.js';
 export { findNearestProjectVmz, getInvocationContext, isGlobalAllowedCommand, isUnderNodeModules, resolveThisPackageRoot, resolveVmzBin, gateGlobalProjectCommand, } from './invocation.js';
 export { resolveWorkspaceDirs, findPackageJson, readPackageMeta } from './resolve.js';
 export { resolvePackageRoot, resolveWorkspacePackages } from './packages.js';
 export { log } from './log.js';
 export { cmdApplication, runCheck as runApplicationCheck } from './application-cmd.js';
+export { cmdArtifact } from './release-cmd.js';
+export { ARTIFACT_DIFF_SCHEMA, DELIVERY_ARTIFACT_MANIFEST_SCHEMA, RELEASE_ENVELOPE_SCHEMA, ROUTE_REALIZATION_TABLE_SCHEMA, atomicWritePointer, canonicalJson, diffArtifacts, loadReleaseEnvelope, packRelease, publishRelease, readPointer, rollbackRelease, sha256File, sha256Hex, } from './release-pack.js';
+// APPLICATION_ARTIFACT_SCHEMA lives in @vmz/protocol (already re-exported above);
+// release-pack keeps a local constant for envelope writes — do not dual-export the name.
+export { STATIC_DELIVERY_MANIFEST_SCHEMA, emitWebStatic, } from './static-emit.js';
+export { CONTENT_ADDRESSED_ASSETS_SCHEMA, emitContentAddressedAssets, resolveAssetByDigest, assertSharedAssetPath, contentAddressedAssetsDigest, } from './content-addressed-assets.js';
+export { CDN_POLICY_MANIFEST_SCHEMA, CDN_ADAPTER_PROJECTION_SCHEMA, CACHE_HTML, CACHE_ASSET_IMMUTABLE, CACHE_META, buildCdnPolicyManifest, emitCdnPolicy, projectCdnAdapter, createLocalStaticHandler, listenLocalStaticHost, matchGlob, } from './cdn-policy.js';
+export { SITE_DELIVERY_CONTRACT_SCHEMA, SITE_DELIVERY_RESOLUTION_SCHEMA, defineSite, normalizeSiteDelivery, normalizeSourceProbe, resolveSiteRelease, probeReleaseDirectory, emitSiteDelivery, } from './site-delivery.js';
+export { EMBEDDED_RESOURCE_INDEX_SCHEMA, emitEmbeddedPackaging, } from './embedded-packaging.js';
+export { SERVER_LANG_IDS, SERVER_LANG_ALIASES, SERVER_LANGUAGE_BACKENDS, resolveServerLanguage, assertLangRuntimePair, } from './server-language-backend.js';
+export { DELIVERY_PROFILE_AUTHORING_SCHEMA, BUILD_PROFILE_SELECTION_SCHEMA, ASSEMBLIES, SERVER_RUNTIMES, BUILTIN_PROFILES, pickSiteAuthoring, normalizeDeliveryAuthoring, selectBuildProfile, semanticIdsForAssembly, } from './delivery-profile.js';
+export { PACK_MANIFEST_SCHEMA, packFromDeploymentIr, ensureRuntimeCompanions } from './pack.js';
+export { SERVER_ARTIFACT_SCHEMA, HTTP_CONTRACT_SCHEMA, SERVER_RUNTIME_ADAPTER_SCHEMA, emitServerArtifact, projectServerRuntimeAdapter, } from './server-artifact.js';
+export { BUILD_PROOF_SCHEMA, ASSEMBLE_MANIFEST_SCHEMA, assembleDelivery, emitBuildProof, } from './build-assemble.js';
+export { PRODUCTION_SCENARIO_PACK_SCHEMA, PRODUCTION_CI_PROFILE_SCHEMA, PRODUCTION_TEST_REPORT_SCHEMA, browserProductionScenarioPack, browserProductionCiProfile, normalizeScenarioPack, normalizeCiProfile, scenarioPackDigest, ciProfileDigest, buildProductionTestReport, productionTestReportDigest, emitProductionTestArtifacts, assertNoForbiddenRunners, } from './production-test-pack.js';
+export { PRODUCTION_OBSERVABILITY_SCHEMA, PRODUCTION_TRACE_SCHEMA, REQUIRED_TRACE_FACETS, browserProductionObservability, normalizeObservability, redactSensitive, validateProductionTrace, buildCoveringProductionTrace, checkProductionBudgets, checkCapabilityClosure, applySecurityHeadersToCdnPolicy, measureDistBudgets, emitProductionObservability, observabilityDigest, } from './production-observability.js';
 export { buildApplicationContext, buildFormatterContext, checkLocaleRuntime, checkSsrClientParity, createLocaleSession, formatMessageTemplate, formatterContextDigest, negotiateLocale, resolveMessageVariant, validateFormatterContext, } from './locale-runtime.js';
-export { absoluteUrl, assertLocaleCacheKey, buildLocalePageMeta, buildLocaleRouteRealizationTable, checkLocaleRouter, commitLocaleRouteMetaTransition, localeAwareCacheKey, parseLocaleFromPath, planLocalePathNavigation, realizeRoutePath, resolveLinkHref, } from './locale-router.js';
+export { absoluteUrl, assertLocaleCacheKey, buildLocalePageMeta, buildLocaleRouteRealizationTable, checkLocaleRouter, commitLocaleRouteMetaTransition, localeAwareCacheKey, localizeBodyLinks, localizeSameAppHref, parseLocaleFromPath, planLocalePathNavigation, realizeRoutePath, resolveLinkHref, } from './locale-router.js';
+export { LOCALE_ROUTE_REALIZATION_ARTIFACT_SCHEMA, emitLocaleRouteRealization, } from './locale-route-emit.js';
 export { assertHostMessageInvariant, assertServerErrorEnvelope, assertServerFormatContext, buildLocaleDeliveryResolution, checkLocaleDelivery, fallbackDigest, messageCatalogHash, proveMiniPackageMessages, validateNativeLocalePack, } from './locale-delivery.js';
 export { checkLocaleConformance, diffLocaleCatalogs, explainLocaleMessage, extractHardcodedText, pseudoLocalizeCatalog, } from './locale-tooling.js';
 export { applyPlugins, contentHash, defineConfig, definePlugin, loadVmzConfig, } from './plugin-host.js';

package/dist/invocation.d.ts

@@ -1,58 +1,40 @@
 /**
  * `vmz` CLI invocation modes (JS gate only; Rust binary stays full).
  *
+ * Product install face: workspace `vmz` / publish `@vmz/vmz` (bin still `vmz`).
+ *
  * Three modes — do not collapse them:
  * - **developer**: monorepo source checkout (`packages/runtimes/vmz`, not under node_modules)
- * - **project**: app's `node_modules/vmz` or `node_modules/@vmz/vmz` (pnpm/npm/yarn)
+ * - **project**: app's nearest `node_modules/vmz` or `node_modules/@vmz/vmz`
  * - **global**: npm/pnpm global (or any install under node_modules that is not the nearest project one)
  *
  */
-/** @typedef {'developer' | 'project' | 'global'} InvocationMode */
 /**
- * Package root of the running `vmz` / `@vmz/vmz` install (`…/vmz`, not `…/vmz/dist`).
+ * Package root of the running `vmz` / `@vmz/vmz` install.
  * @param {string} [fromUrl]
  */
 export declare function resolveThisPackageRoot(fromUrl?: string): string;
 /**
- * Walk from `startDir` for nearest project `vmz` / `@vmz/vmz` package root.
+ * Walk from `startDir` for nearest project CLI package root.
  * @param {string} startDir
- * @returns {string | null} realpath of package root
+ * @returns {string | null}
  */
 export declare function findNearestProjectVmz(startDir: any): string;
 /**
- * Resolve CLI entry for a `vmz` package root (`bin/vmz.js`).
+ * Resolve CLI entry (`bin/vmz.js`).
  * @param {string} packageRoot
  * @returns {string | null}
  */
 export declare function resolveVmzBin(packageRoot: any): string;
 /**
- * Install lives under a `node_modules` tree (npm -g, pnpm store link, etc.).
- * Workspace source checkout (`packages/runtimes/vmz`) does not → developer mode.
  * @param {string} packageRoot
  */
 export declare function isUnderNodeModules(packageRoot: any): boolean;
 /**
- * Classify how this process was launched.
- *
- * | mode | thisPackageRoot | rule |
- * |-------------|-----------------------------------------|-------------------------------------------|
- * | developer | monorepo `packages/runtimes/vmz` | not under `node_modules` |
- * | project | app `node_modules/(@vmz/)vmz` | under node_modules ∧ equals nearest |
- * | global | global / unrelated node_modules install | under node_modules ∧ not nearest project |
- *
  * @param {{
  * cwd?: string,
  * thisPackageRoot?: string,
  * }} [opts]
- * @returns {{
- * mode: InvocationMode,
- * cwd: string,
- * thisPackageRoot: string,
- * nearestProjectVmz: string | null,
- * isDeveloper: boolean,
- * isProjectLocal: boolean,
- * isGlobalLike: boolean,
- * }}
  */
 export declare function getInvocationContext(opts?: {}): {
     mode: any;
@@ -65,21 +47,16 @@ export declare function getInvocationContext(opts?: {}): {
     isGlobalLike: boolean;
 };
 /**
- * Commands allowed in **global** mode without re-exec / refusal.
- * Developer + project modes allow the full CLI.
  * @param {string | undefined} cmd
  */
 export declare function isGlobalAllowedCommand(cmd: any): boolean;
 /**
  * @param {string} bin
- * @param {string[]} argv full argv including command (e.g. `['check', '.']`)
+ * @param {string[]} argv
  * @returns {Promise<number>}
  */
 export declare function reexecProjectVmz(bin: any, argv: any): Promise<unknown>;
 /**
- * Guard for project-only commands when the current install is **global** mode.
- * Developer / project → proceed. Global + local present → re-exec. Global alone → refuse.
- *
  * @returns {Promise<{ action: 'proceed' } | { action: 'exit', code: number }>}
  */
 export declare function gateGlobalProjectCommand(opts: any): Promise<{

package/dist/invocation.js

@@ -2,9 +2,11 @@
 /**
  * `vmz` CLI invocation modes (JS gate only; Rust binary stays full).
  *
+ * Product install face: workspace `vmz` / publish `@vmz/vmz` (bin still `vmz`).
+ *
  * Three modes — do not collapse them:
  * - **developer**: monorepo source checkout (`packages/runtimes/vmz`, not under node_modules)
- * - **project**: app's `node_modules/vmz` or `node_modules/@vmz/vmz` (pnpm/npm/yarn)
+ * - **project**: app's nearest `node_modules/vmz` or `node_modules/@vmz/vmz`
  * - **global**: npm/pnpm global (or any install under node_modules that is not the nearest project one)
  *
  */
@@ -13,8 +15,9 @@ import { existsSync, realpathSync } from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 /** @typedef {'developer' | 'project' | 'global'} InvocationMode */
+const PROJECT_PKG_SEGMENTS = [['@vmz', 'vmz'], ['vmz']];
 /**
- * Package root of the running `vmz` / `@vmz/vmz` install (`…/vmz`, not `…/vmz/dist`).
+ * Package root of the running `vmz` / `@vmz/vmz` install.
  * @param {string} [fromUrl]
  */
 export function resolveThisPackageRoot(fromUrl = import.meta.url) {
@@ -32,15 +35,15 @@ function tryRealpath(p) {
     }
 }
 /**
- * Walk from `startDir` for nearest project `vmz` / `@vmz/vmz` package root.
+ * Walk from `startDir` for nearest project CLI package root.
  * @param {string} startDir
- * @returns {string | null} realpath of package root
+ * @returns {string | null}
  */
 export function findNearestProjectVmz(startDir) {
     let dir = path.resolve(startDir);
     for (;;) {
-        const candidates = [path.join(dir, 'node_modules', 'vmz'), path.join(dir, 'node_modules', '@vmz', 'vmz')];
-        for (const candidate of candidates) {
+        for (const segments of PROJECT_PKG_SEGMENTS) {
+            const candidate = path.join(dir, 'node_modules', ...segments);
             const pkgJson = path.join(candidate, 'package.json');
             if (existsSync(pkgJson)) {
                 return tryRealpath(candidate);
@@ -53,7 +56,7 @@ export function findNearestProjectVmz(startDir) {
     }
 }
 /**
- * Resolve CLI entry for a `vmz` package root (`bin/vmz.js`).
+ * Resolve CLI entry (`bin/vmz.js`).
  * @param {string} packageRoot
  * @returns {string | null}
  */
@@ -64,8 +67,6 @@ export function resolveVmzBin(packageRoot) {
     return null;
 }
 /**
- * Install lives under a `node_modules` tree (npm -g, pnpm store link, etc.).
- * Workspace source checkout (`packages/runtimes/vmz`) does not → developer mode.
  * @param {string} packageRoot
  */
 export function isUnderNodeModules(packageRoot) {
@@ -74,27 +75,10 @@ export function isUnderNodeModules(packageRoot) {
     return parts.includes('node_modules');
 }
 /**
- * Classify how this process was launched.
- *
- * | mode | thisPackageRoot | rule |
- * |-------------|-----------------------------------------|-------------------------------------------|
- * | developer | monorepo `packages/runtimes/vmz` | not under `node_modules` |
- * | project | app `node_modules/(@vmz/)vmz` | under node_modules ∧ equals nearest |
- * | global | global / unrelated node_modules install | under node_modules ∧ not nearest project |
- *
  * @param {{
  * cwd?: string,
  * thisPackageRoot?: string,
  * }} [opts]
- * @returns {{
- * mode: InvocationMode,
- * cwd: string,
- * thisPackageRoot: string,
- * nearestProjectVmz: string | null,
- * isDeveloper: boolean,
- * isProjectLocal: boolean,
- * isGlobalLike: boolean,
- * }}
  */
 export function getInvocationContext(opts = {}) {
     const cwd = path.resolve(opts.cwd ?? process.cwd());
@@ -124,8 +108,6 @@ export function getInvocationContext(opts = {}) {
     };
 }
 /**
- * Commands allowed in **global** mode without re-exec / refusal.
- * Developer + project modes allow the full CLI.
  * @param {string | undefined} cmd
  */
 export function isGlobalAllowedCommand(cmd) {
@@ -142,7 +124,7 @@ export function isGlobalAllowedCommand(cmd) {
 }
 /**
  * @param {string} bin
- * @param {string[]} argv full argv including command (e.g. `['check', '.']`)
+ * @param {string[]} argv
  * @returns {Promise<number>}
  */
 export function reexecProjectVmz(bin, argv) {
@@ -161,9 +143,6 @@ export function reexecProjectVmz(bin, argv) {
     });
 }
 /**
- * Guard for project-only commands when the current install is **global** mode.
- * Developer / project → proceed. Global + local present → re-exec. Global alone → refuse.
- *
  * @returns {Promise<{ action: 'proceed' } | { action: 'exit', code: number }>}
  */
 export async function gateGlobalProjectCommand(opts) {
@@ -175,7 +154,7 @@ export async function gateGlobalProjectCommand(opts) {
     if (ctx.nearestProjectVmz && ctx.nearestProjectVmz !== ctx.thisPackageRoot) {
         const bin = resolveVmzBin(ctx.nearestProjectVmz);
         if (!bin) {
-            logError('found project `@vmz/vmz` / `vmz` but bin/vmz.js is missing.');
+            logError('found project `vmz` / `@vmz/vmz` but bin/vmz.js is missing.');
             return { action: 'exit', code: 1 };
         }
         const code = await reexec(bin, argv);

package/dist/locale-check.d.ts

@@ -80,6 +80,22 @@ export declare function scanLocaleUsages(projectRoot: any): {
  * @param {string} outDir
  */
 export declare function emitLocaleTypedModules(report: any, outDir: any): any[];
+/**
+ * Emit runtime `#locales/<catalog>.js` into application `dist/` and rewrite
+ * client imports from `#locales/...` to relative ESM paths.
+ *
+ * Variant pick reads `html[data-locale]` (else defaultLocale). Thin bridge until
+ * host LocaleTransition reloads locale-scoped chunks (I2/I4).
+ *
+ * @param {string} projectRoot
+ * @param {string} distDir
+ * @returns {{ ok: boolean, written: string[], diagnostics: any[] }}
+ */
+export declare function emitLocaleRuntimeModules(projectRoot: any, distDir: any): {
+    ok: boolean;
+    written: any[];
+    diagnostics: any;
+};
 /**
  * MessageId rename plan — WorkspaceEdit-shaped, no parallel rename IR.
  * @param {ReturnType<typeof checkLocales>} report

package/dist/locale-check.js

@@ -250,10 +250,12 @@ export function checkLocales(opts) {
     const manifestPathJson = path.join(localesRoot, 'locales.json');
     const manifestPath = fs.existsSync(manifestPathJson5) ? manifestPathJson5 : fs.existsSync(manifestPathJson) ? manifestPathJson : null;
     if (!fs.existsSync(localesRoot) || !manifestPath) {
+        // Discipline nudge: i18n is first-class — missing policy is never silent.
+        // Soft for now (warning); production profiles may elevate to error later.
         diagnostics.push({
             code: DIAG_MANIFEST_MISSING,
-            severity: 'error',
-            message: 'locales/locales.json5 missing (LocaleId policy truth source)',
+            severity: 'warning',
+            message: 'locales/locales.json5 missing — declare LocaleId policy under /locales (native i18n, not an afterthought)',
             path: 'locales/locales.json5',
         });
         return emptyReport(projectRoot, diagnostics);
@@ -586,9 +588,10 @@ function paramSignature(params) {
         .join(',');
 }
 function emptyReport(projectRoot, diagnostics) {
+    const hasErrors = (diagnostics || []).some((d) => d.severity === 'error');
     return {
         schema: LOCALE_CHECK_SCHEMA,
-        status: 'failed',
+        status: hasErrors ? 'failed' : 'ready',
         root: projectRoot,
         localesRoot: 'locales',
         manifest: null,
@@ -694,6 +697,131 @@ export function emitLocaleTypedModules(report, outDir) {
     fs.writeFileSync(path.join(outDir, 'index.json'), `${JSON.stringify(index, null, 2)}\n`, 'utf8');
     return written;
 }
+/**
+ * Emit runtime `#locales/<catalog>.js` into application `dist/` and rewrite
+ * client imports from `#locales/...` to relative ESM paths.
+ *
+ * Variant pick reads `html[data-locale]` (else defaultLocale). Thin bridge until
+ * host LocaleTransition reloads locale-scoped chunks (I2/I4).
+ *
+ * @param {string} projectRoot
+ * @param {string} distDir
+ * @returns {{ ok: boolean, written: string[], diagnostics: any[] }}
+ */
+export function emitLocaleRuntimeModules(projectRoot, distDir) {
+    const report = checkLocales({ projectRoot, checkUnused: false });
+    if (localeHasErrors(report)) {
+        return { ok: false, written: [], diagnostics: report.diagnostics || [] };
+    }
+    // Missing locales.json5 is warning-only for now — surface diagnostics, skip emit.
+    if (!report.manifest) {
+        return { ok: true, written: [], diagnostics: report.diagnostics || [] };
+    }
+    const defaultLocale = report.manifest.defaultLocale || 'zh-hans';
+    const byId = new Map((report.messageCatalog?.messages || []).map((m) => [m.messageId, m]));
+    /** @type {string[]} */
+    const written = [];
+    const localesOut = path.join(distDir, 'locales');
+    fs.mkdirSync(localesOut, { recursive: true });
+    for (const mod of report.typedModules || []) {
+        const lines = [
+            `/** Generated ${mod.module} — runtime LocalizedText (defaultLocale=${defaultLocale}) */`,
+            `const __vmzDefaultLocale = ${JSON.stringify(defaultLocale)};`,
+            `function __vmzLocaleId() {`,
+            `  try {`,
+            `    const stored = localStorage.getItem("vmz.locale");`,
+            `    if (stored) return stored;`,
+            `  } catch {}`,
+            `  if (typeof document !== "undefined") {`,
+            `    const d = document.documentElement?.getAttribute("data-locale");`,
+            `    if (d) return d;`,
+            `    const lang = document.documentElement?.lang;`,
+            `    if (lang === "en" || lang === "en-US" || lang === "en-us") return "en-us";`,
+            `    if (lang === "zh" || lang === "zh-CN" || lang === "zh-Hans" || lang === "zh-hans") return "zh-hans";`,
+            `  }`,
+            `  return __vmzDefaultLocale;`,
+            `}`,
+            `function __vmzFormat(template, args) {`,
+            `  if (!args) return String(template ?? "");`,
+            `  return String(template ?? "").replace(/\\{(\\w+)(?:,\\s*\\w+)?\\}/g, (m, name) =>`,
+            `    Object.prototype.hasOwnProperty.call(args, name) ? String(args[name]) : m`,
+            `  );`,
+            `}`,
+            `function __vmzPick(variants, args) {`,
+            `  const id = __vmzLocaleId();`,
+            `  const template = variants[id] ?? variants[__vmzDefaultLocale] ?? "";`,
+            `  return __vmzFormat(template, args);`,
+            `}`,
+            '',
+        ];
+        for (const exp of mod.exports || []) {
+            const node = byId.get(exp.messageId);
+            const variants = {};
+            if (node?.variants) {
+                for (const [loc, v] of Object.entries(node.variants)) {
+                    variants[loc] = v.template;
+                }
+            }
+            const lit = JSON.stringify(variants);
+            if ((exp.params || []).length) {
+                lines.push(`export function ${exp.exportName}(args) { return __vmzPick(${lit}, args); }`);
+            }
+            else {
+                lines.push(`export function ${exp.exportName}() { return __vmzPick(${lit}); }`);
+            }
+        }
+        lines.push('');
+        const file = path.join(localesOut, `${mod.catalogId}.js`);
+        fs.mkdirSync(path.dirname(file), { recursive: true });
+        fs.writeFileSync(file, lines.join('\n'), 'utf8');
+        written.push(file);
+    }
+    rewriteLocaleImportsInDist(distDir);
+    return { ok: true, written, diagnostics: report.diagnostics || [] };
+}
+/**
+ * @param {string} distDir
+ */
+function rewriteLocaleImportsInDist(distDir) {
+    /** @type {string[]} */
+    const files = [];
+    walkDistJs(distDir, (file) => files.push(file));
+    for (const file of files) {
+        let text = fs.readFileSync(file, 'utf8');
+        if (!text.includes('#locales/'))
+            continue;
+        const fromDir = path.dirname(file);
+        // Emit path is dist/locales/*.js — `#` cannot appear in ESM file URLs (fragment).
+        const next = text.replace(/from\s*(["'])#locales\/([^"']+)\1/g, (_m, quote, id) => {
+            const target = path.join(distDir, 'locales', `${id}.js`);
+            let rel = path.relative(fromDir, target).replace(/\\/g, '/');
+            if (!rel.startsWith('.'))
+                rel = `./${rel}`;
+            return `from ${quote}${rel}${quote}`;
+        });
+        if (next !== text)
+            fs.writeFileSync(file, next, 'utf8');
+    }
+}
+/**
+ * @param {string} dir
+ * @param {(file: string) => void} fn
+ */
+function walkDistJs(dir, fn) {
+    if (!fs.existsSync(dir))
+        return;
+    for (const ent of fs.readdirSync(dir, { withFileTypes: true })) {
+        const full = path.join(dir, ent.name);
+        if (ent.isDirectory()) {
+            if (ent.name === 'node_modules')
+                continue;
+            walkDistJs(full, fn);
+        }
+        else if (ent.name.endsWith('.js') || ent.name.endsWith('.mjs')) {
+            fn(full);
+        }
+    }
+}
 /**
  * MessageId rename plan — WorkspaceEdit-shaped, no parallel rename IR.
  * @param {ReturnType<typeof checkLocales>} report

package/dist/locale-cmd.js

@@ -117,8 +117,8 @@ function cmdLocaleList(args) {
     const projectRoot = resolveProject(args);
     const report = checkLocales({ projectRoot, checkUnused: false });
     if (!report.manifest) {
-        log.error('locales.json5 missing');
-        return 1;
+        console.warn('vmz warn vmz::locale::manifest_missing: locales/locales.json5 missing');
+        return localeHasErrors(report) ? 1 : 0;
     }
     for (const loc of report.manifest.locales) {
         const mark = loc.id === report.manifest.defaultLocale ? ' (default)' : '';

package/dist/locale-route-emit.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Emit RouteId × LocaleId realization (+ PageMeta / hreflang seed) into dist/_vmz.
+ * Consumed by serve-host + static-emit; LocaleId stays out of stable RouteId.
+ */
+export declare const LOCALE_ROUTE_REALIZATION_ARTIFACT_SCHEMA = "vmz.locale.route_realization.v0";
+/**
+ * @param {string} projectRoot
+ * @param {string} distDir
+ * @param {{ origin?: string }} [opts]
+ */
+export declare function emitLocaleRouteRealization(projectRoot: any, distDir: any, opts?: {}): {
+    ok: boolean;
+    written: any[];
+    diagnostics: any;
+    artifact: any;
+} | {
+    ok: boolean;
+    written: string[];
+    artifact: {
+        schema: string;
+        defaultLocale: any;
+        locales: any;
+        routing: {
+            strategy: any;
+            defaultPrefix: any;
+            defaultLocale: any;
+        };
+        origin: string;
+        routes: any;
+        realizations: any[];
+        pageMetas: any[];
+    };
+    diagnostics: any[];
+};