@vmz/vmz 0.1.17 → 0.1.18

package/dist/index.js

@@ -1,4 +1,3 @@
-// @ts-nocheck
 /**
  * VMZ Node host: N-API workspace + npm CLI.
  * Coarse-grained only — no transform hooks / per-AST callbacks.
@@ -13,9 +12,6 @@ import { HOST_PROTOCOL, COMPILER_PROTOCOL, PROGRAM_IR_SCHEMA, PLUGIN_PROTOCOL, D
 const require = createRequire(import.meta.url);
 const here = path.dirname(fileURLToPath(import.meta.url));
 const pkgRoot = path.join(here, '..');
-/**
- * @returns {{ hostProtocol: string, compilerProtocol: string, programIrSchema: string, pluginProtocol: string }}
- */
 export function expectedProtocol() {
     return {
         hostProtocol: HOST_PROTOCOL,
@@ -55,13 +51,11 @@ function platformShort(triple = platformTriple()) {
 /**
  * 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 names = [`@vmz/vmz-${short}`, `@vmz/vmz-${short}`];
-    /** @type {string[]} */
     const candidates = [];
     for (const name of names) {
         try {
@@ -84,9 +78,6 @@ export function resolveNativePath() {
         `Looked in:\n${candidates.map((c) => `  - ${c}`).join('\n')}`);
 }
 let _native;
-/**
- * @returns {typeof import('./index.js') extends never ? any : any}
- */
 export function loadNative() {
     if (_native)
         return _native;
@@ -94,16 +85,6 @@ export function loadNative() {
     _native = require(addonPath);
     return _native;
 }
-/**
- * @typedef {object} ProtocolVersions
- * @property {string} hostProtocol
- * @property {string} compilerProtocol
- * @property {string} programIrSchema
- * @property {string} pluginProtocol
- */
-/**
- * @returns {ProtocolVersions}
- */
 export function getProtocolVersions() {
     const native = loadNative();
     const n = native.getProtocolVersions();
@@ -114,9 +95,6 @@ export function getProtocolVersions() {
         pluginProtocol: n.pluginProtocol,
     };
 }
-/**
- * @param {ProtocolVersions} [host]
- */
 export function handshake(host = expectedProtocol()) {
     const native = loadNative();
     native.handshakeProtocols({
@@ -126,10 +104,7 @@ export function handshake(host = expectedProtocol()) {
         pluginProtocol: host.pluginProtocol,
     });
 }
-/**
- * Resolve `@vmz/core` package `dist/` for runtime JS copies into app outDir.
- * @returns {string | null}
- */
+/** Resolve `@vmz/core` package `dist/` for runtime JS copies into app outDir. */
 export function resolveCoreRuntimeDist() {
     try {
         // Prefer a real export subpath — `package.json` is often blocked by "exports".
@@ -153,11 +128,7 @@ export const SERVE_HOST_RUNTIME_FILES = [
     ['render-host.js', 'render-host.js'],
     ['route-layout-chain.js', 'route-layout-chain.js'],
 ];
-/**
- * Copy serve-host + registry bootstrap modules from `@vmz/core` into app outDir.
- * @param {string} outDir
- * @param {string} [coreDist]
- */
+/** Copy serve-host + registry bootstrap modules from `@vmz/core` into app outDir. */
 export function materializeServeHostRuntime(outDir, coreDist = resolveCoreRuntimeDist()) {
     if (!coreDist) {
         throw new Error('materializeServeHostRuntime: @vmz/core dist not found');
@@ -171,17 +142,7 @@ export function materializeServeHostRuntime(outDir, coreDist = resolveCoreRuntim
         copyFileSync(src, dst);
     }
 }
-/**
- * @typedef {object} WorkspaceOptions
- * @property {string} root
- * @property {string} [outDir]
- * @property {string} [runtimeDist]
- * @property {ProtocolVersions} [protocol]
- */
-/**
- * Create a long-lived compile workspace .
- * @param {WorkspaceOptions} options
- */
+/** Create a long-lived compile workspace. */
 export function createWorkspace(options) {
     const native = loadNative();
     const protocol = options.protocol ?? expectedProtocol();
@@ -217,20 +178,12 @@ export function createWorkspace(options) {
         });
     }
 }
-/**
- * frozen application composition protocol catalog.
- * @returns {string}
- */
+/** frozen application composition protocol catalog. */
 export function queryApplicationProtocolCatalog() {
     const native = loadNative();
     return native.queryApplicationProtocolCatalog();
 }
-/**
- * check host applications.config.json5 against workspace package descriptors.
- * @param {string} hostRoot
- * @param {string[]} packageRoots
- * @returns {string} ApplicationCheckReport JSON
- */
+/** check host applications.config.json5 against workspace package descriptors. */
 export function checkApplicationsJson(hostRoot, packageRoots) {
     const native = loadNative();
     return native.checkApplicationsJson(hostRoot, packageRoots);
@@ -334,63 +287,32 @@ export function checkMultiPlatformContractJson(rootPath) {
     const native = loadNative();
     return native.checkMultiPlatformContractJson(rootPath);
 }
-/**
- * prove independent `/` + non-root ApplicationBase; scan non-relocatable URLs.
- * @param {string} packageRoot
- * @param {string} [relocateBase]
- * @returns {string}
- */
+/** prove independent `/` + non-root ApplicationBase; scan non-relocatable URLs. */
 export function checkApplicationRelocatableJson(packageRoot, relocateBase) {
     const native = loadNative();
     return native.checkApplicationRelocatableJson(packageRoot, relocateBase ?? null);
 }
-/**
- * apply ApplicationBase to a logical relocation manifest.
- * @param {string} manifestJson
- * @param {string} base
- * @returns {string}
- */
+/** apply ApplicationBase to a logical relocation manifest. */
 export function relocateApplicationManifestJson(manifestJson, base) {
     const native = loadNative();
     return native.relocateApplicationManifestJson(manifestJson, base);
 }
-/**
- * independent ApplicationArtifact + MountTable/Catalog boundary (refs only).
- * @param {string} hostRoot
- * @param {string[]} packageRoots
- * @returns {string}
- */
+/** independent ApplicationArtifact + MountTable/Catalog boundary (refs only). */
 export function checkApplicationArtifactBoundaryJson(hostRoot, packageRoots) {
     const native = loadNative();
     return native.checkApplicationArtifactBoundaryJson(hostRoot, packageRoots);
 }
-/**
- * absolute isolation namespaces + failure containment.
- * @param {string} hostRoot
- * @param {string[]} packageRoots
- * @returns {string}
- */
+/** absolute isolation namespaces + failure containment. */
 export function checkApplicationIsolationJson(hostRoot, packageRoots) {
     const native = loadNative();
     return native.checkApplicationIsolationJson(hostRoot, packageRoots);
 }
-/**
- * host catalog consumption + cross-application Link resolution.
- * @param {string} hostRoot
- * @param {string[]} packageRoots
- * @returns {string}
- */
+/** host catalog consumption + cross-application Link resolution. */
 export function checkApplicationHostCompositionJson(hostRoot, packageRoots) {
     const native = loadNative();
     return native.checkApplicationHostCompositionJson(hostRoot, packageRoots);
 }
-/**
- * multi-session affected rebuild + MountTable proxy + mounted tests + deploy adapter.
- * @param {string} hostRoot
- * @param {string[]} packageRoots
- * @param {string[]} [dirtyPaths]
- * @returns {string}
- */
+/** multi-session affected rebuild + MountTable proxy + mounted tests + deploy adapter. */
 export function checkApplicationDevTestDeployJson(hostRoot, packageRoots, dirtyPaths = []) {
     const native = loadNative();
     return native.checkApplicationDevTestDeployJson(hostRoot, packageRoots, dirtyPaths);
@@ -398,13 +320,15 @@ export function checkApplicationDevTestDeployJson(hostRoot, packageRoots, dirtyP
 export { createDevSession, listWatchedFiles, srcFingerprint } from './dev-session.js';
 export { coalesceRootBurst, collectDevWatchRoots, mergeDirtySets, localLinkDependencyRoots, watchRootForSourceFile, } from './dev-watch-roots.js';
 export { findAvailablePort } from './port.js';
-export { runCli, parseArgs, printHelp, printGlobalHelp, printProjectHelp } from './cli.js';
+export { runCli, printHelp, printGlobalHelp, printProjectHelp } from './cli.js';
+export { createCli, formatDiagnostic, formatDiagnostics, t } from './toolchain-dx.js';
+export { VMZ_CLI_CATALOG_EN_US, createVmzCliLocalize, flattenCatalog, loadCliCatalog, loadCliLocalesManifest, resolveCliLocalesRoot, resolveVmzLocale, translateCatalog, vmzCliLocalize, } from './toolchain-dx.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 { registerApplicationCommands, runCheck as runApplicationCheck } from './application-cmd.js';
+export { registerArtifactCommands, runArtifact } 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.
@@ -531,14 +455,6 @@ export default {
     PROFILE_CONFORMANCE_STATE_SNAPSHOT_SCHEMA,
     PROFILE_CONFORMANCE_TRACE_SCHEMA,
     PROFILE_CONFORMANCE_HOST_RUN_SCHEMA,
-    PROFILE_CONFORMANCE_SCENARIO_SCHEMA,
-    PROFILE_CONFORMANCE_CHECK_SCHEMA,
-    PROFILE_CONFORMANCE_SURFACE_ROLES,
-    PROFILE_DIAG_STABLE_ID_DIVERGENCE,
-    PROFILE_DIAG_STATE_RESULT_DIVERGENCE,
-    PROFILE_DIAG_TRACE_INVARIANT_BROKEN,
-    PROFILE_DIAG_CONFORMANCE_HOST_INCOMPLETE,
-    PROFILE_DIAG_CONFORMANCE_SURFACE_ROLE_MISMATCH,
     PROFILE_LIFECYCLE_SCENARIO_SCHEMA,
     PROFILE_LIFECYCLE_RECOVERY_CHECK_SCHEMA,
     PROFILE_LIFECYCLE_HOST_KINDS,
@@ -553,28 +469,9 @@ export default {
     PROFILE_DELIVERY_UPDATE_POLICY_SCHEMA,
     PROFILE_DELIVERY_ARTIFACT_MANIFEST_SCHEMA,
     PROFILE_DELIVERY_PROOF_MANIFEST_SCHEMA,
-    PROFILE_DELIVERY_PROOF_SCENARIO_SCHEMA,
-    PROFILE_DELIVERY_PROOF_CHECK_SCHEMA,
     PROFILE_DELIVERY_UPDATE_CHANNELS,
     PROFILE_DELIVERY_ASSET_STRATEGIES,
-    PROFILE_DIAG_DELIVERY_CONSTRAINT_EXCEEDED,
-    PROFILE_DIAG_HOST_PLAN_VERSION_MISMATCH,
     PROFILE_DIAG_PROOF_MANIFEST_INCOMPLETE,
-    PROFILE_DIAG_PROOF_COPIES_SEMANTIC_IR,
-    PROFILE_DIAG_UPDATE_WITHOUT_REPROOF,
-    PROFILE_DIAG_SECURITY_POLICY_INSECURE,
-    PROFILE_CONFORMANCE_FIXTURE_SCHEMA,
-    PROFILE_CONFORMANCE_STATE_SNAPSHOT_SCHEMA,
-    PROFILE_CONFORMANCE_TRACE_SCHEMA,
-    PROFILE_CONFORMANCE_HOST_RUN_SCHEMA,
-    PROFILE_CONFORMANCE_SCENARIO_SCHEMA,
-    PROFILE_CONFORMANCE_CHECK_SCHEMA,
-    PROFILE_CONFORMANCE_SURFACE_ROLES,
-    PROFILE_DIAG_STABLE_ID_DIVERGENCE,
-    PROFILE_DIAG_STATE_RESULT_DIVERGENCE,
-    PROFILE_DIAG_TRACE_INVARIANT_BROKEN,
-    PROFILE_DIAG_CONFORMANCE_HOST_INCOMPLETE,
-    PROFILE_DIAG_CONFORMANCE_SURFACE_ROLE_MISMATCH,
     PROFILE_SOLVER_CHECK_SCHEMA,
     PROFILE_HOST_RESOLUTION_MANIFEST_SCHEMA,
     PROFILE_EXECUTOR_CHECK_SCHEMA,
@@ -602,22 +499,6 @@ export default {
     PROFILE_SURFACE_KINDS,
     PROFILE_UNIFIED_LIFECYCLE_EVENTS,
     PROFILE_CORE_ID_PREFIX,
-    PROFILE_SOLVER_CHECK_SCHEMA,
-    PROFILE_HOST_RESOLUTION_MANIFEST_SCHEMA,
-    PROFILE_EXECUTOR_CHECK_SCHEMA,
-    PROFILE_EXECUTOR_SCENARIO_SCHEMA,
-    PROFILE_DIAG_SURFACE_NO_MATCH,
-    PROFILE_DIAG_SURFACE_AMBIGUOUS,
-    PROFILE_DIAG_CAPABILITY_UNRESOLVED,
-    PROFILE_DIAG_CAPABILITY_PERMISSION_UNDECLARED,
-    PROFILE_DIAG_ROUTE_UNREALIZABLE,
-    PROFILE_DIAG_STALE_GENERATION,
-    PROFILE_DIAG_MISSING_ENVELOPE_IDS,
-    PROFILE_DIAG_SURFACE_OWNS_STATE,
-    PROFILE_DIAG_PRIVATE_OBJECT_CROSSING,
-    PROFILE_DIAG_SPLIT_TRANSACTION,
-    PROFILE_DIAG_DISPOSE_NOT_AUTHORITATIVE,
-    PROFILE_DIAG_CANCEL_NOT_PROPAGATED,
     profileCatalog,
     localeCatalog,
     queryNativeHostProtocolCatalog,
@@ -666,7 +547,6 @@ export default {
     NATIVE_HOST_DEEP_LINK_SCHEMA,
     NATIVE_HOST_LOCAL_BUNDLE_SCHEMA,
     NATIVE_HOST_DIAG_MISSING_SHELL_HOOK,
-    NATIVE_HOST_DIAG_PLATFORM_SEMANTIC_FORK,
     NATIVE_HOST_DIAG_REMOTE_ENTRY_DEFAULT,
     NATIVE_HOST_DIAG_MISSING_ENTRY_ARTIFACT,
     NATIVE_HOST_REQUIRED_SHELL_HOOKS,

package/dist/invocation.d.ts

@@ -1,5 +1,5 @@
 /**
- * `vmz` CLI invocation modes (JS gate only; Rust binary stays full).
+ * `vmz` CLI invocation modes (JS gate for `@vmz/vmz` only).
  *
  * Product install face: workspace `vmz` / publish `@vmz/vmz` (bin still `vmz`).
  *
@@ -7,62 +7,41 @@
  * - **developer**: monorepo source checkout (`packages/runtimes/vmz`, not under node_modules)
  * - **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)
- *
- */
-/**
- * Package root of the running `vmz` / `@vmz/vmz` install.
- * @param {string} [fromUrl]
  */
+export type InvocationMode = 'developer' | 'project' | 'global';
+/** Package root of the running `vmz` / `@vmz/vmz` install. */
 export declare function resolveThisPackageRoot(fromUrl?: string): string;
-/**
- * Walk from `startDir` for nearest project CLI package root.
- * @param {string} startDir
- * @returns {string | null}
- */
-export declare function findNearestProjectVmz(startDir: any): string;
-/**
- * Resolve CLI entry (`bin/vmz.js`).
- * @param {string} packageRoot
- * @returns {string | null}
- */
-export declare function resolveVmzBin(packageRoot: any): string;
-/**
- * @param {string} packageRoot
- */
-export declare function isUnderNodeModules(packageRoot: any): boolean;
-/**
- * @param {{
- * cwd?: string,
- * thisPackageRoot?: string,
- * }} [opts]
- */
-export declare function getInvocationContext(opts?: {}): {
-    mode: any;
+/** Walk from `startDir` for nearest project CLI package root. */
+export declare function findNearestProjectVmz(startDir: string): string | null;
+/** Resolve CLI entry (`bin/vmz.js`). */
+export declare function resolveVmzBin(packageRoot: string): string | null;
+export declare function isUnderNodeModules(packageRoot: string): boolean;
+export type InvocationContext = {
+    mode: InvocationMode;
     cwd: string;
     thisPackageRoot: string;
-    nearestProjectVmz: string;
+    nearestProjectVmz: string | null;
     isDeveloper: boolean;
     isProjectLocal: boolean;
     /** @deprecated prefer `mode === 'global'`; kept for call sites */
     isGlobalLike: boolean;
 };
-/**
- * @param {string | undefined} cmd
- */
-export declare function isGlobalAllowedCommand(cmd: any): boolean;
-/**
- * @param {string} bin
- * @param {string[]} argv
- * @returns {Promise<number>}
- */
-export declare function reexecProjectVmz(bin: any, argv: any): Promise<unknown>;
-/**
- * @returns {Promise<{ action: 'proceed' } | { action: 'exit', code: number }>}
- */
-export declare function gateGlobalProjectCommand(opts: any): Promise<{
-    action: string;
-    code?: undefined;
+export declare function getInvocationContext(opts?: {
+    cwd?: string;
+    thisPackageRoot?: string;
+}): InvocationContext;
+export declare function isGlobalAllowedCommand(cmd: string | undefined): boolean;
+export declare function reexecProjectVmz(bin: string, argv: string[]): Promise<number>;
+export type GateResult = {
+    action: 'proceed';
 } | {
-    action: string;
-    code: any;
-}>;
+    action: 'exit';
+    code: number;
+};
+export declare function gateGlobalProjectCommand(opts: {
+    argv: string[];
+    cwd?: string;
+    thisPackageRoot?: string;
+    reexec?: (bin: string, argv: string[]) => Promise<number>;
+    logError?: (msg: string) => void;
+}): Promise<GateResult>;

package/dist/invocation.js

@@ -1,6 +1,5 @@
-// @ts-nocheck
 /**
- * `vmz` CLI invocation modes (JS gate only; Rust binary stays full).
+ * `vmz` CLI invocation modes (JS gate for `@vmz/vmz` only).
  *
  * Product install face: workspace `vmz` / publish `@vmz/vmz` (bin still `vmz`).
  *
@@ -8,24 +7,17 @@
  * - **developer**: monorepo source checkout (`packages/runtimes/vmz`, not under node_modules)
  * - **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)
- *
  */
 import { spawn } from 'node:child_process';
 import { existsSync, realpathSync } from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
-/** @typedef {'developer' | 'project' | 'global'} InvocationMode */
+import { vmzCliLocalize } from './cli-localize.js';
 const PROJECT_PKG_SEGMENTS = [['@vmz', 'vmz'], ['vmz']];
-/**
- * Package root of the running `vmz` / `@vmz/vmz` install.
- * @param {string} [fromUrl]
- */
+/** Package root of the running `vmz` / `@vmz/vmz` install. */
 export function resolveThisPackageRoot(fromUrl = import.meta.url) {
     return path.resolve(path.dirname(fileURLToPath(fromUrl)), '..');
 }
-/**
- * @param {string} p
- */
 function tryRealpath(p) {
     try {
         return realpathSync(p);
@@ -34,11 +26,7 @@ function tryRealpath(p) {
         return path.resolve(p);
     }
 }
-/**
- * Walk from `startDir` for nearest project CLI package root.
- * @param {string} startDir
- * @returns {string | null}
- */
+/** Walk from `startDir` for nearest project CLI package root. */
 export function findNearestProjectVmz(startDir) {
     let dir = path.resolve(startDir);
     for (;;) {
@@ -55,37 +43,23 @@ export function findNearestProjectVmz(startDir) {
         dir = parent;
     }
 }
-/**
- * Resolve CLI entry (`bin/vmz.js`).
- * @param {string} packageRoot
- * @returns {string | null}
- */
+/** Resolve CLI entry (`bin/vmz.js`). */
 export function resolveVmzBin(packageRoot) {
     const bin = path.join(packageRoot, 'bin', 'vmz.js');
     if (existsSync(bin))
         return tryRealpath(bin);
     return null;
 }
-/**
- * @param {string} packageRoot
- */
 export function isUnderNodeModules(packageRoot) {
     const norm = path.normalize(packageRoot);
     const parts = norm.split(path.sep);
     return parts.includes('node_modules');
 }
-/**
- * @param {{
- * cwd?: string,
- * thisPackageRoot?: string,
- * }} [opts]
- */
 export function getInvocationContext(opts = {}) {
     const cwd = path.resolve(opts.cwd ?? process.cwd());
     const thisPackageRoot = tryRealpath(opts.thisPackageRoot ?? resolveThisPackageRoot());
     const nearestProjectVmz = findNearestProjectVmz(cwd);
     const underNm = isUnderNodeModules(thisPackageRoot);
-    /** @type {InvocationMode} */
     let mode;
     if (!underNm) {
         mode = 'developer';
@@ -103,30 +77,14 @@ export function getInvocationContext(opts = {}) {
         nearestProjectVmz,
         isDeveloper: mode === 'developer',
         isProjectLocal: mode === 'project',
-        /** @deprecated prefer `mode === 'global'`; kept for call sites */
         isGlobalLike: mode === 'global',
     };
 }
-/**
- * @param {string | undefined} cmd
- */
 export function isGlobalAllowedCommand(cmd) {
     if (!cmd)
         return true;
-    return (cmd === 'help' ||
-        cmd === '-h' ||
-        cmd === '--help' ||
-        cmd === 'version' ||
-        cmd === '-V' ||
-        cmd === '--version' ||
-        cmd === 'new' ||
-        cmd === 'init');
+    return cmd === 'help' || cmd === '-h' || cmd === '--help' || cmd === 'version' || cmd === '-V' || cmd === '--version';
 }
-/**
- * @param {string} bin
- * @param {string[]} argv
- * @returns {Promise<number>}
- */
 export function reexecProjectVmz(bin, argv) {
     return new Promise((resolve) => {
         const child = spawn(process.execPath, [bin, ...argv], {
@@ -142,9 +100,6 @@ export function reexecProjectVmz(bin, argv) {
         });
     });
 }
-/**
- * @returns {Promise<{ action: 'proceed' } | { action: 'exit', code: number }>}
- */
 export async function gateGlobalProjectCommand(opts) {
     const { argv, cwd = process.cwd(), thisPackageRoot, reexec = reexecProjectVmz, logError = (msg) => console.error(msg) } = opts;
     const ctx = getInvocationContext({ cwd, thisPackageRoot });
@@ -154,16 +109,15 @@ 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(vmzCliLocalize.t('cli.err.project_bin_missing'));
             return { action: 'exit', code: 1 };
         }
         const code = await reexec(bin, argv);
         return { action: 'exit', code };
     }
-    logError('this `vmz` is a global install (mode=global); project commands need a project install.');
-    logError('Install in the app:  pnpm add -D @vmz/vmz');
-    logError('Or scaffold:         vmz new <dir>');
-    logError('Then run:            pnpm exec vmz <command>');
-    logError('(developer mode: run from vmz-framework packages/runtimes/vmz source — full CLI)');
+    logError(vmzCliLocalize.t('cli.err.global_needs_project'));
+    logError(vmzCliLocalize.t('cli.err.global_install_hint'));
+    logError(vmzCliLocalize.t('cli.err.global_run_hint'));
+    logError(vmzCliLocalize.t('cli.err.global_developer_hint'));
     return { action: 'exit', code: 1 };
 }