@vmz/vmz 0.3.5 → 0.3.6

package/README.md

@@ -1,55 +1,55 @@
-# `@vmz/vmz` (bin: `vmz`)
-
-CLI / N-API toolchain host. Runtime mental entry is **`@vmz/core`**; optional official UI is **`@vmz/ui`**; plugins are
-**`@vmz/plugin-*`**. Shelved umbrella name: `@vmz/vmz`.
-
-When a project reaches the point where it has a browser surface, SSR, server work, documents, tests, and several
-deployment concerns, the usual workflow becomes a chain of tools that each see a different version of the application. A
-build may pass while a route boundary is wrong; a browser test may pass while SSR work is replayed; a plugin may
-transform code without anyone being able to explain the delivery result.
-
-`vmz` is the command-line home for a different workflow. Development, checking, building, serving, testing, document
-generation, and deployment output all begin from VMZ's understanding of the same application. The useful unit is not
-only a module graph. It is a program with state reads and writes, control regions, routes, server capabilities,
-ownership, and delivery boundaries.
-
-That means the CLI can grow into something more useful than a collection of commands: it can say why a change affects a
-region, why code was placed on the client, why a conservative boundary was used, or why a route and its server work
-belong together. ⚡
-
-With VMZ, a normal workflow is expected to answer all of these from the same source program:
-
-- **Develop:** which application regions are affected by a change?
-- **Check:** which state, route, server, or lifecycle boundary is unsafe?
-- **Build:** what belongs in browser, SSR, resume, and server output?
-- **Test:** what did a user interaction actually cause?
-- **Explain:** why did the compiler make that decision?
-
-Use it when you are adopting VMZ as the application model. The CLI targets VMZ-native source and semantics; Vue, React,
-and legacy VDOM ecosystems keep their own toolchains.
-
-## One tool, several views of the same program
-
-| Workflow    | The question it should answer                                      |
-|-------------|--------------------------------------------------------------------|
-| Development | What changed, and which application regions are affected?          |
-| Checking    | Which state, route, server, or lifetime boundary cannot be proven? |
-| Building    | What belongs in browser, SSR, resume, and server output?           |
-| Testing     | Did the application behave correctly and avoid unrelated work?     |
-| Documents   | Are project documents connected, localized, and deployable?        |
-
-### Designed for the npm world
-
-VMZ does not ask users to abandon JavaScript packaging. Node remains the npm, plugin, development-server, and
-orchestration host. A long-lived N-API bridge connects that ecosystem to Rust and oxc without reducing semantic analysis
-to a sequence of tiny file transforms.
-
-### More than pass or fail
-
-The interesting future of the CLI is explanation. A useful compiler should expose the source span, graph edge, owner,
-deployment boundary, and fallback reason behind a decision. That is a better developer experience than adding more
-colored output to an opaque build. 🧭
-
-## License
-
-MIT
+# `@vmz/vmz` (bin: `vmz`)
+
+CLI / N-API toolchain host. Runtime mental entry is **`@vmz/core`**; optional official UI is **`@vmz/ui`**; plugins are
+**`@vmz/plugin-*`**. Shelved umbrella name: `@vmz/vmz`.
+
+When a project reaches the point where it has a browser surface, SSR, server work, documents, tests, and several
+deployment concerns, the usual workflow becomes a chain of tools that each see a different version of the application. A
+build may pass while a route boundary is wrong; a browser test may pass while SSR work is replayed; a plugin may
+transform code without anyone being able to explain the delivery result.
+
+`vmz` is the command-line home for a different workflow. Development, checking, building, serving, testing, document
+generation, and deployment output all begin from VMZ's understanding of the same application. The useful unit is not
+only a module graph. It is a program with state reads and writes, control regions, routes, server capabilities,
+ownership, and delivery boundaries.
+
+That means the CLI can grow into something more useful than a collection of commands: it can say why a change affects a
+region, why code was placed on the client, why a conservative boundary was used, or why a route and its server work
+belong together. ⚡
+
+With VMZ, a normal workflow is expected to answer all of these from the same source program:
+
+- **Develop:** which application regions are affected by a change?
+- **Check:** which state, route, server, or lifecycle boundary is unsafe?
+- **Build:** what belongs in browser, SSR, resume, and server output?
+- **Test:** what did a user interaction actually cause?
+- **Explain:** why did the compiler make that decision?
+
+Use it when you are adopting VMZ as the application model. The CLI targets VMZ-native source and semantics; Vue, React,
+and legacy VDOM ecosystems keep their own toolchains.
+
+## One tool, several views of the same program
+
+| Workflow    | The question it should answer                                      |
+|-------------|--------------------------------------------------------------------|
+| Development | What changed, and which application regions are affected?          |
+| Checking    | Which state, route, server, or lifetime boundary cannot be proven? |
+| Building    | What belongs in browser, SSR, resume, and server output?           |
+| Testing     | Did the application behave correctly and avoid unrelated work?     |
+| Documents   | Are project documents connected, localized, and deployable?        |
+
+### Designed for the npm world
+
+VMZ does not ask users to abandon JavaScript packaging. Node remains the npm, plugin, development-server, and
+orchestration host. A long-lived N-API bridge connects that ecosystem to Rust and oxc without reducing semantic analysis
+to a sequence of tiny file transforms.
+
+### More than pass or fail
+
+The interesting future of the CLI is explanation. A useful compiler should expose the source span, graph edge, owner,
+deployment boundary, and fallback reason behind a decision. That is a better developer experience than adding more
+colored output to an opaque build. 🧭
+
+## License
+
+MIT

package/delivery-runtime-files.json

@@ -1,38 +1,38 @@
-{
-    "schema": "vmz.delivery-runtime-files.v0",
-    "note": "Browser/SSR runtime companions copied into app delivery dist. Consumed by vmz-compiler emit_runtime_js and pack ensureRuntimeCompanions.",
-    "flatBarrels": [
-        { "src": "faces/server.js", "out": "vmz-runtime.js" },
-        { "src": "faces/dom.js", "out": "vmz-dom.js" },
-        { "src": "browser/dom-core.js", "out": "dom-core.js" },
-        { "src": "ssr/dom-ssr.js", "out": "dom-ssr.js" },
-        { "src": "faces/dom.client.js", "out": "dom.client.js" },
-        { "src": "faces/dom.browser.js", "out": "dom.browser.js" },
-        { "src": "browser/direct-host-box.js", "out": "direct-host-box.js" },
-        { "src": "browser/unknown-component.js", "out": "unknown-component.js" },
-        { "src": "shared/dom-attr-normalize.js", "out": "dom-attr-normalize.js" },
-        { "src": "faces/http.js", "out": "vmz-http.js" },
-        { "src": "browser/client-nav.js", "out": "vmz-client-nav.js" }
-    ],
-    "nested": [
-        { "src": "browser/diagnostics/precision-trace.js", "out": "browser/diagnostics/precision-trace.js" },
-        { "src": "browser/dom/attributes.js", "out": "browser/dom/attributes.js" },
-        { "src": "browser/dom/component.js", "out": "browser/dom/component.js" },
-        { "src": "browser/dom/direct-api.js", "out": "browser/dom/direct-api.js" },
-        { "src": "browser/dom/lifecycle.js", "out": "browser/dom/lifecycle.js" },
-        { "src": "browser/dom/registry.js", "out": "browser/dom/registry.js" },
-        { "src": "browser/reactivity/patch-scheduler.js", "out": "browser/reactivity/patch-scheduler.js" },
-        { "src": "browser/reactivity/write-barrier.js", "out": "browser/reactivity/write-barrier.js" },
-        { "src": "browser/navigation/client-navigation.js", "out": "browser/navigation/client-navigation.js" },
-        { "src": "browser/navigation/extract-html.js", "out": "browser/navigation/extract-html.js" },
-        { "src": "browser/navigation/layout-retain.js", "out": "browser/navigation/layout-retain.js" },
-        { "src": "browser/navigation/locale-transition.js", "out": "browser/navigation/locale-transition.js" },
-        { "src": "browser/navigation/scroll-focus.js", "out": "browser/navigation/scroll-focus.js" },
-        { "src": "browser/resume/adopt.js", "out": "browser/resume/adopt.js" },
-        { "src": "browser/resume/hydrate.js", "out": "browser/resume/hydrate.js" },
-        { "src": "browser/resume/resume.js", "out": "browser/resume/resume.js" },
-        { "src": "ssr/render.js", "out": "ssr/render.js" },
-        { "src": "ssr/serialize.js", "out": "ssr/serialize.js" },
-        { "src": "ssr/document.js", "out": "ssr/document.js" }
-    ]
-}
+{
+    "schema": "vmz.delivery-runtime-files.v0",
+    "note": "Browser/SSR runtime companions copied into app delivery dist. Consumed by vmz-compiler emit_runtime_js and pack ensureRuntimeCompanions.",
+    "flatBarrels": [
+        { "src": "faces/server.js", "out": "vmz-runtime.js" },
+        { "src": "faces/dom.js", "out": "vmz-dom.js" },
+        { "src": "browser/dom-core.js", "out": "dom-core.js" },
+        { "src": "ssr/dom-ssr.js", "out": "dom-ssr.js" },
+        { "src": "faces/dom.client.js", "out": "dom.client.js" },
+        { "src": "faces/dom.browser.js", "out": "dom.browser.js" },
+        { "src": "browser/direct-host-box.js", "out": "direct-host-box.js" },
+        { "src": "browser/unknown-component.js", "out": "unknown-component.js" },
+        { "src": "shared/dom-attr-normalize.js", "out": "dom-attr-normalize.js" },
+        { "src": "faces/http.js", "out": "vmz-http.js" },
+        { "src": "browser/client-nav.js", "out": "vmz-client-nav.js" }
+    ],
+    "nested": [
+        { "src": "browser/diagnostics/precision-trace.js", "out": "browser/diagnostics/precision-trace.js" },
+        { "src": "browser/dom/attributes.js", "out": "browser/dom/attributes.js" },
+        { "src": "browser/dom/component.js", "out": "browser/dom/component.js" },
+        { "src": "browser/dom/direct-api.js", "out": "browser/dom/direct-api.js" },
+        { "src": "browser/dom/lifecycle.js", "out": "browser/dom/lifecycle.js" },
+        { "src": "browser/dom/registry.js", "out": "browser/dom/registry.js" },
+        { "src": "browser/reactivity/patch-scheduler.js", "out": "browser/reactivity/patch-scheduler.js" },
+        { "src": "browser/reactivity/write-barrier.js", "out": "browser/reactivity/write-barrier.js" },
+        { "src": "browser/navigation/client-navigation.js", "out": "browser/navigation/client-navigation.js" },
+        { "src": "browser/navigation/extract-html.js", "out": "browser/navigation/extract-html.js" },
+        { "src": "browser/navigation/layout-retain.js", "out": "browser/navigation/layout-retain.js" },
+        { "src": "browser/navigation/locale-transition.js", "out": "browser/navigation/locale-transition.js" },
+        { "src": "browser/navigation/scroll-focus.js", "out": "browser/navigation/scroll-focus.js" },
+        { "src": "browser/resume/adopt.js", "out": "browser/resume/adopt.js" },
+        { "src": "browser/resume/hydrate.js", "out": "browser/resume/hydrate.js" },
+        { "src": "browser/resume/resume.js", "out": "browser/resume/resume.js" },
+        { "src": "ssr/render.js", "out": "ssr/render.js" },
+        { "src": "ssr/serialize.js", "out": "ssr/serialize.js" },
+        { "src": "ssr/document.js", "out": "ssr/document.js" }
+    ]
+}

package/dist/cli/cli.js

@@ -46,6 +46,9 @@ function buildProductCli(opts = {}) {
     const cli = createCli('vmz')
         .locales(resolveCliLocalesRoot(), {
         envKeys: ['VMZ_LOCALE', 'LOCALE', 'LANG', 'LC_ALL'],
+    })
+        .onDiagnostic((diagnostic, context) => {
+        log.diagnostic(diagnostic, { locale: context.locale });
     })
         .intro(introId);
     // Global install: only version (help is derived). Project commands need a project bin.

package/dist/document/document-build.js

@@ -195,20 +195,20 @@ function buildDocumentSlotHtml({ nav, bodyHtml, headings, htmlRel, route, routin
             .map((h) => `      <li class="h${h.level}"><a href="#${esc(h.id)}">${esc(h.text)}</a></li>`)
             .join('\n')}\n    </ol>\n  </nav>\n`
         : '';
-    const docsNav = `  <nav aria-label="Documents" class="doc-subnav">
-    <ul>
-${navItems}
-    </ul>
+    const docsNav = `  <nav aria-label="Documents" class="doc-subnav">
+    <ul>
+${navItems}
+    </ul>
   </nav>`;
-    return `    <aside class="doc-sidebar">
-${docsNav}
-${searchShellHtml}
-    </aside>
-    <div class="doc-content">
-  ${toc}<main id="main">
-${bodyHtml}
-${playgroundShellHtml}
-  </main>
+    return `    <aside class="doc-sidebar">
+${docsNav}
+${searchShellHtml}
+    </aside>
+    <div class="doc-content">
+  ${toc}<main id="main">
+${bodyHtml}
+${playgroundShellHtml}
+  </main>
     </div>`;
 }
 /**
@@ -242,17 +242,17 @@ function renderStaticHtml({ title, locale, route, nav, bodyHtml, headings, desig
                 .map((h) => `      <li class="h${h.level}"><a href="#${esc(h.id)}">${esc(h.text)}</a></li>`)
                 .join('\n')}\n    </ol>\n  </nav>\n`
             : '';
-        bodyInner = `  <a class="skip-link" href="#main">Skip to content</a>
-  <nav aria-label="Documents" class="doc-subnav">
-    <ul>
-${navItems}
-    </ul>
-  </nav>
-${searchShellHtml}
-  ${toc}<main id="main">
-${bodyHtml}
-${playgroundShellHtml}
-  </main>
+        bodyInner = `  <a class="skip-link" href="#main">Skip to content</a>
+  <nav aria-label="Documents" class="doc-subnav">
+    <ul>
+${navItems}
+    </ul>
+  </nav>
+${searchShellHtml}
+  ${toc}<main id="main">
+${bodyHtml}
+${playgroundShellHtml}
+  </main>
 `;
     }
     const native = requireNativeAddon();

package/dist/document/document-integrate.js

@@ -9,6 +9,8 @@ import { resolveDocumentsRoot } from './document-check.js';
 import { pageHtmlRel } from './document-enrich.js';
 import { loadLocalesRouting } from './document-routing-config.js';
 import { ensureLocaleImportsRewritten } from '../locale/locale-check.js';
+import { ensureRuntimeCompanions } from '../workspace/pack.js';
+import { resolveCoreRuntimeDist } from '../workspace/runtime-dist.js';
 import { log } from '../workspace/log.js';
 import { requireNativeAddon } from '../workspace/native-addon.js';
 export function projectHasDocuments(projectRoot) {
@@ -30,6 +32,10 @@ export async function buildIntegratedDocuments(opts) {
             log.error(locales.error || 'locale import rewrite incomplete');
             return { ok: false, error: locales.error || 'locale rewrite', pages: 0 };
         }
+        // Document layout chunks import the delivery runtime (dom-core.js) at mount
+        // time, but pack only materializes it afterwards. Ensure companions first so
+        // a clean or partially-written outDir does not fail with an opaque module error.
+        ensureRuntimeCompanions(outDir, resolveCoreRuntimeDist());
         const result = await buildDocuments({
             projectRoot,
             outDir,

package/dist/workspace/log.d.ts

@@ -16,6 +16,7 @@ export type DiagnosticLike = {
 export type DiagnosticLogOptions = {
     denyWarnings?: boolean;
     level?: CliLogLevel;
+    locale?: string;
 };
 export declare const log: {
     info(...args: unknown[]): void;
@@ -25,6 +26,7 @@ export declare const log: {
     errorId(id: string, args?: Record<string, string>): void;
     diagnostic(d: DiagnosticLike, opts?: {
         level?: CliLogLevel;
+        locale?: string;
     }): boolean;
     /** Failing count: errors, and warnings when `denyWarnings` (independent of print level). */
     diagnostics(diagnostics: DiagnosticLike[] | null | undefined, opts?: DiagnosticLogOptions): number;

package/dist/workspace/log.js

@@ -38,7 +38,7 @@ export const log = {
             return false;
         const hasCode = Boolean(d.code && String(d.code).length);
         const code = hasCode ? String(d.code) : 'diag.message';
-        const locale = resolveVmzLocale();
+        const locale = opts.locale ?? resolveVmzLocale();
         const catalog = loadCliCatalog(locale);
         const path = d.path || '';
         const style = getCliLogStyle();
@@ -68,7 +68,7 @@ export const log = {
         const items = diagnostics ?? [];
         const visible = items.filter((d) => diagnosticVisible(normalizeSeverity(d.severity), level));
         for (let i = 0; i < visible.length; i += 1) {
-            this.diagnostic(visible[i], { level });
+            this.diagnostic(visible[i], { level, locale: opts.locale });
             if (style === 'pretty' && i + 1 < visible.length)
                 console.error('');
         }

package/dist/workspace/plugin-host.js

@@ -289,17 +289,17 @@ function buildMathFacade(defaultEngine, engines) {
         return `  <${tag} ${kw}="(engine || ${defaultLit}) === ${engLit}" :tex="tex" :display="display" />`;
     })
         .join('\n');
-    return `<template>
-${branches}
-</template>
-
-<script client>
-export default class Math {
-  public tex: string = '';
-  public display: boolean = false;
-  public engine: string | null = null;
-}
-</script>
+    return `<template>
+${branches}
+</template>
+
+<script client>
+export default class Math {
+  public tex: string = '';
+  public display: boolean = false;
+  public engine: string | null = null;
+}
+</script>
 `;
 }
 /**
@@ -316,18 +316,18 @@ function buildCodeFacade(defaultEngine, engines) {
         return `  <${tag} ${kw}="(engine || ${defaultLit}) === ${engLit}" :code="code" :lang="lang" :theme="theme" />`;
     })
         .join('\n');
-    return `<template>
-${branches}
-</template>
-
-<script client>
-export default class Code {
-  public code: string = '';
-  public lang: string = 'text';
-  public theme: string | null = null;
-  public engine: string | null = null;
-}
-</script>
+    return `<template>
+${branches}
+</template>
+
+<script client>
+export default class Code {
+  public code: string = '';
+  public lang: string = 'text';
+  public theme: string | null = null;
+  public engine: string | null = null;
+}
+</script>
 `;
 }
 /**
@@ -344,16 +344,16 @@ function buildMarkdownFacade(defaultEngine, engines) {
         return `  <${tag} ${kw}="(engine || ${defaultLit}) === ${engLit}" :source="source" />`;
     })
         .join('\n');
-    return `<template>
-${branches}
-</template>
-
-<script client>
-export default class Markdown {
-  public source: string = '';
-  public engine: string | null = null;
-}
-</script>
+    return `<template>
+${branches}
+</template>
+
+<script client>
+export default class Markdown {
+  public source: string = '';
+  public engine: string | null = null;
+}
+</script>
 `;
 }
 /** Embed a JS string literal inside a double-quoted Vue attribute. */

package/locales/en-US/cli.json

@@ -1,126 +1,126 @@
-{
-    "cli.intro.project": "vmz — Node toolchain host (`@vmz/vmz`, N-API)",
-    "cli.intro.global": "vmz — global install (help/version only). Pin `@vmz/vmz` in the app (`pnpm add -D @vmz/vmz`) and run `pnpm exec vmz <command>`. A global `vmz` re-execs the nearest project bin when present.",
-    "cli.cmd.check": "Check project via Workspace",
-    "cli.cmd.build": "Build project via Workspace",
-    "cli.cmd.serve": "Serve dist (optional --build)",
-    "cli.cmd.dev": "Rebuild session",
-    "cli.cmd.format": "Format workspace surfaces and .vmz via vmz.config format",
-    "cli.opt.format-no-javascript": "Skip JS/TS workspace format",
-    "cli.opt.format-no-rust": "Skip cargo fmt",
-    "cli.opt.format-no-vmz": "Skip .vmz author format",
-    "cli.cmd.lint": "Lint (= check) via N-API",
-    "cli.cmd.test": "Native test discover / report",
-    "cli.cmd.document": "Project /documents domain",
-    "cli.cmd.document.check": "Check locale tree + links/anchors + evidence",
-    "cli.cmd.document.build": "Static HTML + view + evidence + designs CSS",
-    "cli.cmd.locale": "Locale domain",
-    "cli.cmd.locale.check": "Check locales.json5 + catalogs + param contracts",
-    "cli.cmd.locale.list": "List LocaleIds",
-    "cli.cmd.locale.emit-types": "Emit #locales/* .d.ts stubs",
-    "cli.cmd.locale.rename": "MessageId rename plan",
-    "cli.cmd.locale.runtime-check": "LocaleContext / FormatterContext / SSR parity",
-    "cli.cmd.locale.router-check": "Route realization / canonical / hreflang",
-    "cli.cmd.locale.delivery-check": "Multi-host LocaleDeliveryResolution",
-    "cli.cmd.locale.explain": "Explain MessageId",
-    "cli.cmd.locale.diff": "Diff two locales",
-    "cli.cmd.locale.extract": "Hardcoded text sink check",
-    "cli.cmd.locale.pseudo": "Pseudo-localize catalog",
-    "cli.cmd.locale.conformance": "Cross-host MessageId/hash conformance",
-    "cli.cmd.application": "Application Collection / Mount",
-    "cli.cmd.application.check": "Validate descriptors + applications.config.json5",
-    "cli.cmd.application.list": "List ApplicationIds / collections / mounts",
-    "cli.cmd.application.schemas": "Print frozen protocol catalog JSON",
-    "cli.cmd.application.relocatable": "ApplicationBase / non_relocatable_url proof",
-    "cli.cmd.application.relocate": "Apply ApplicationBase to relocation manifest",
-    "cli.cmd.application.artifacts": "ApplicationArtifact + MountTable boundary",
-    "cli.cmd.application.isolation": "Isolation namespaces + failure containment",
-    "cli.cmd.application.composition": "Catalog consumption + cross-app Link hrefs",
-    "cli.cmd.application.dev": "Sessions / affected / proxy / mounted tests",
-    "cli.cmd.artifact": "Release pack / publish / rollback / diff",
-    "cli.cmd.artifact.pack": "Write dist/_vmz manifests + envelope",
-    "cli.cmd.artifact.publish": "Pack + publish under dist/releases",
-    "cli.cmd.artifact.rollback": "Restore PREVIOUS pointer",
-    "cli.cmd.artifact.current": "Print CURRENT digest",
-    "cli.cmd.artifact.diff": "Structured file digest diff",
-    "cli.cmd.refactor": "DX rename plans / apply",
-    "cli.cmd.refactor.rename": "Plan or apply a workspace rename",
-    "cli.cmd.explain": "DX causal explain",
-    "cli.cmd.github-actions": "Monitor GitHub Actions via Rust GitHub REST monitor (status|wait)",
-    "cli.cmd.plan": "Dump frozen Rust plans via N-API",
-    "cli.cmd.plan.locale": "LocalePlan from locales/",
-    "cli.cmd.plan.document-route": "DocumentRoutePlan from documents/",
-    "cli.cmd.version": "Show host + native protocol versions",
-    "cli.opt.out-dir": "Workspace output root (default: dist)",
-    "cli.opt.release": "Release build (omit serve-host; pack minify; proof)",
-    "cli.opt.profile": "Delivery profile id",
-    "cli.opt.target": "browser | mini-program-wechat (or test affected alias)",
-    "cli.opt.origin": "Site origin for web-static",
-    "cli.opt.host": "Listen host",
-    "cli.opt.port": "Listen port",
-    "cli.opt.poll-ms": "Dev watch poll interval",
-    "cli.opt.build": "Build before serve",
-    "cli.opt.check": "Format check-only / extract fail on CJK",
-    "cli.opt.deny-warnings": "Treat warnings as errors",
-    "cli.opt.level": "Diagnostic verbosity: error | warn | info (default warn)",
-    "cli.opt.info-level": "Show advice diagnostics and progress (same as --level info)",
-    "cli.opt.diag-style": "Diagnostic layout: pretty | compact (default pretty)",
-    "cli.opt.json": "Write JSON to stdout or file",
-    "cli.opt.root": "Project root",
-    "cli.opt.out": "Output directory",
-    "cli.opt.strict": "Strict coverage / require defaultLocale",
-    "cli.opt.list": "List discovered tests",
-    "cli.opt.mode": "compile|logic|browser|ssr|resume|deployment|all",
-    "cli.opt.filter": "Filter by test id or file",
-    "cli.opt.application": "Run only tests for ApplicationId",
-    "cli.opt.mounted": "Relocation + host-boundary tests for ApplicationId",
-    "cli.opt.affected": "Select tests from dirty VPG units",
-    "cli.opt.locale": "Requested locale id",
-    "cli.opt.delivery": "Delivery id",
-    "cli.opt.timezone": "Formatter time zone",
-    "cli.opt.production": "Fail pseudo in production",
-    "cli.opt.base": "ApplicationBase path",
-    "cli.opt.dirty": "Dirty file path for affected planning (repeatable)",
-    "cli.opt.releases": "Releases root directory",
-    "cli.opt.app-id": "applicationId for envelope",
-    "cli.opt.refactor.kind": "route_id|field|method|component|capability",
-    "cli.opt.refactor.from": "Rename from id",
-    "cli.opt.refactor.to": "Rename to id",
-    "cli.opt.refactor.scope": "Optional chunk scope",
-    "cli.opt.apply": "Apply workspace edit plan",
-    "cli.opt.explain": "Include rename explain chain",
-    "cli.opt.explain.target": "Generic Workspace.explain target",
-    "cli.opt.gha.mode": "status (one-shot) or wait (poll until completed)",
-    "cli.opt.gha.workflow": "Workflow file name (e.g. ci.yml) or numeric id",
-    "cli.opt.gha.run-id": "Watch a specific workflow run id",
-    "cli.opt.gha.ref": "Commit SHA filter (head_sha)",
-    "cli.opt.gha.branch": "Branch name filter",
-    "cli.opt.gha.owner": "Repository owner (default GITHUB_REPOSITORY)",
-    "cli.opt.gha.repo": "Repository name (default GITHUB_REPOSITORY)",
-    "cli.opt.gha.token": "GitHub token (default GITHUB_TOKEN / GH_TOKEN)",
-    "cli.opt.gha.timeout-minutes": "Max wait minutes for mode=wait",
-    "cli.opt.gha.interval-seconds": "Poll interval seconds for mode=wait",
-    "cli.opt.gha.required-conclusion": "Required conclusion when mode=wait (default success)",
-    "cli.err.unknown_plan_kind": "unknown plan kind `{kind}` (locale | document-route)",
-    "cli.err.gha.mode": "unknown --mode {mode} (status | wait)",
-    "cli.err.gha.repo": "set --owner/--repo or GITHUB_REPOSITORY (owner/repo)",
-    "cli.err.invalid_level": "unknown --level `{level}` (error | warn | info)",
-    "cli.err.invalid_style": "unknown --style `{style}` (pretty | compact)",
-    "cli.err.unknown_target": "unknown --target {target} (browser | mini-program-wechat)",
-    "cli.err.document_build_aborted": "document build aborted due to diagnostics",
-    "cli.err.locale_rename_usage": "usage: vmz locale rename <from-message-id> <to-message-id>",
-    "cli.err.locale_explain_usage": "usage: vmz locale explain <message-id> [project]",
-    "cli.err.locale_diff_usage": "usage: vmz locale diff <base-locale> <target-locale> [project]",
-    "cli.err.locale_pseudo_usage": "usage: vmz locale pseudo <source-locale> [project]",
-    "cli.err.application_relocate_manifest": "relocate requires a relocation manifest JSON path",
-    "cli.err.application_relocate_base": "relocate requires --base <ApplicationBase>",
-    "cli.err.artifact_diff_usage": "artifact diff requires <aDigest> <bDigest>",
-    "cli.err.refactor_rename_usage": "rename requires --kind, --from, and --to",
-    "cli.err.explain_style_usage": "usage: vmz explain style <node> [path]",
-    "cli.err.explain_usage": "usage: vmz explain style <node> [path] | vmz explain <target> [path]",
-    "cli.err.project_bin_missing": "found project `vmz` / `@vmz/vmz` but bin/vmz.js is missing.",
-    "cli.err.global_needs_project": "this `vmz` is a global install (mode=global); project commands need a project install.",
-    "cli.err.global_install_hint": "Install in the app:  pnpm add -D @vmz/vmz",
-    "cli.err.global_run_hint": "Then run:            pnpm exec vmz <command>",
-    "cli.err.global_developer_hint": "(developer mode: run from vmz-framework packages/runtimes/vmz source — full CLI)"
-}
+{
+    "cli.intro.project": "vmz — Node toolchain host (`@vmz/vmz`, N-API)",
+    "cli.intro.global": "vmz — global install (help/version only). Pin `@vmz/vmz` in the app (`pnpm add -D @vmz/vmz`) and run `pnpm exec vmz <command>`. A global `vmz` re-execs the nearest project bin when present.",
+    "cli.cmd.check": "Check project via Workspace",
+    "cli.cmd.build": "Build project via Workspace",
+    "cli.cmd.serve": "Serve dist (optional --build)",
+    "cli.cmd.dev": "Rebuild session",
+    "cli.cmd.format": "Format workspace surfaces and .vmz via vmz.config format",
+    "cli.opt.format-no-javascript": "Skip JS/TS workspace format",
+    "cli.opt.format-no-rust": "Skip cargo fmt",
+    "cli.opt.format-no-vmz": "Skip .vmz author format",
+    "cli.cmd.lint": "Lint (= check) via N-API",
+    "cli.cmd.test": "Native test discover / report",
+    "cli.cmd.document": "Project /documents domain",
+    "cli.cmd.document.check": "Check locale tree + links/anchors + evidence",
+    "cli.cmd.document.build": "Static HTML + view + evidence + designs CSS",
+    "cli.cmd.locale": "Locale domain",
+    "cli.cmd.locale.check": "Check locales.json5 + catalogs + param contracts",
+    "cli.cmd.locale.list": "List LocaleIds",
+    "cli.cmd.locale.emit-types": "Emit #locales/* .d.ts stubs",
+    "cli.cmd.locale.rename": "MessageId rename plan",
+    "cli.cmd.locale.runtime-check": "LocaleContext / FormatterContext / SSR parity",
+    "cli.cmd.locale.router-check": "Route realization / canonical / hreflang",
+    "cli.cmd.locale.delivery-check": "Multi-host LocaleDeliveryResolution",
+    "cli.cmd.locale.explain": "Explain MessageId",
+    "cli.cmd.locale.diff": "Diff two locales",
+    "cli.cmd.locale.extract": "Hardcoded text sink check",
+    "cli.cmd.locale.pseudo": "Pseudo-localize catalog",
+    "cli.cmd.locale.conformance": "Cross-host MessageId/hash conformance",
+    "cli.cmd.application": "Application Collection / Mount",
+    "cli.cmd.application.check": "Validate descriptors + applications.config.json5",
+    "cli.cmd.application.list": "List ApplicationIds / collections / mounts",
+    "cli.cmd.application.schemas": "Print frozen protocol catalog JSON",
+    "cli.cmd.application.relocatable": "ApplicationBase / non_relocatable_url proof",
+    "cli.cmd.application.relocate": "Apply ApplicationBase to relocation manifest",
+    "cli.cmd.application.artifacts": "ApplicationArtifact + MountTable boundary",
+    "cli.cmd.application.isolation": "Isolation namespaces + failure containment",
+    "cli.cmd.application.composition": "Catalog consumption + cross-app Link hrefs",
+    "cli.cmd.application.dev": "Sessions / affected / proxy / mounted tests",
+    "cli.cmd.artifact": "Release pack / publish / rollback / diff",
+    "cli.cmd.artifact.pack": "Write dist/_vmz manifests + envelope",
+    "cli.cmd.artifact.publish": "Pack + publish under dist/releases",
+    "cli.cmd.artifact.rollback": "Restore PREVIOUS pointer",
+    "cli.cmd.artifact.current": "Print CURRENT digest",
+    "cli.cmd.artifact.diff": "Structured file digest diff",
+    "cli.cmd.refactor": "DX rename plans / apply",
+    "cli.cmd.refactor.rename": "Plan or apply a workspace rename",
+    "cli.cmd.explain": "DX causal explain",
+    "cli.cmd.github-actions": "Monitor GitHub Actions via Rust GitHub REST monitor (status|wait)",
+    "cli.cmd.plan": "Dump frozen Rust plans via N-API",
+    "cli.cmd.plan.locale": "LocalePlan from locales/",
+    "cli.cmd.plan.document-route": "DocumentRoutePlan from documents/",
+    "cli.cmd.version": "Show host + native protocol versions",
+    "cli.opt.out-dir": "Workspace output root (default: dist)",
+    "cli.opt.release": "Release build (omit serve-host; pack minify; proof)",
+    "cli.opt.profile": "Delivery profile id",
+    "cli.opt.target": "browser | mini-program-wechat (or test affected alias)",
+    "cli.opt.origin": "Site origin for web-static",
+    "cli.opt.host": "Listen host",
+    "cli.opt.port": "Listen port",
+    "cli.opt.poll-ms": "Dev watch poll interval",
+    "cli.opt.build": "Build before serve",
+    "cli.opt.check": "Format check-only / extract fail on CJK",
+    "cli.opt.deny-warnings": "Treat warnings as errors",
+    "cli.opt.level": "Diagnostic verbosity: error | warn | info (default warn)",
+    "cli.opt.info-level": "Show advice diagnostics and progress (same as --level info)",
+    "cli.opt.diag-style": "Diagnostic layout: pretty | compact (default pretty)",
+    "cli.opt.json": "Write JSON to stdout or file",
+    "cli.opt.root": "Project root",
+    "cli.opt.out": "Output directory",
+    "cli.opt.strict": "Strict coverage / require defaultLocale",
+    "cli.opt.list": "List discovered tests",
+    "cli.opt.mode": "compile|logic|browser|ssr|resume|deployment|all",
+    "cli.opt.filter": "Filter by test id or file",
+    "cli.opt.application": "Run only tests for ApplicationId",
+    "cli.opt.mounted": "Relocation + host-boundary tests for ApplicationId",
+    "cli.opt.affected": "Select tests from dirty VPG units",
+    "cli.opt.locale": "Requested locale id",
+    "cli.opt.delivery": "Delivery id",
+    "cli.opt.timezone": "Formatter time zone",
+    "cli.opt.production": "Fail pseudo in production",
+    "cli.opt.base": "ApplicationBase path",
+    "cli.opt.dirty": "Dirty file path for affected planning (repeatable)",
+    "cli.opt.releases": "Releases root directory",
+    "cli.opt.app-id": "applicationId for envelope",
+    "cli.opt.refactor.kind": "route_id|field|method|component|capability",
+    "cli.opt.refactor.from": "Rename from id",
+    "cli.opt.refactor.to": "Rename to id",
+    "cli.opt.refactor.scope": "Optional chunk scope",
+    "cli.opt.apply": "Apply workspace edit plan",
+    "cli.opt.explain": "Include rename explain chain",
+    "cli.opt.explain.target": "Generic Workspace.explain target",
+    "cli.opt.gha.mode": "status (one-shot) or wait (poll until completed)",
+    "cli.opt.gha.workflow": "Workflow file name (e.g. ci.yml) or numeric id",
+    "cli.opt.gha.run-id": "Watch a specific workflow run id",
+    "cli.opt.gha.ref": "Commit SHA filter (head_sha)",
+    "cli.opt.gha.branch": "Branch name filter",
+    "cli.opt.gha.owner": "Repository owner (default GITHUB_REPOSITORY)",
+    "cli.opt.gha.repo": "Repository name (default GITHUB_REPOSITORY)",
+    "cli.opt.gha.token": "GitHub token (default GITHUB_TOKEN / GH_TOKEN)",
+    "cli.opt.gha.timeout-minutes": "Max wait minutes for mode=wait",
+    "cli.opt.gha.interval-seconds": "Poll interval seconds for mode=wait",
+    "cli.opt.gha.required-conclusion": "Required conclusion when mode=wait (default success)",
+    "cli.err.unknown_plan_kind": "unknown plan kind `{kind}` (locale | document-route)",
+    "cli.err.gha.mode": "unknown --mode {mode} (status | wait)",
+    "cli.err.gha.repo": "set --owner/--repo or GITHUB_REPOSITORY (owner/repo)",
+    "cli.err.invalid_level": "unknown --level `{level}` (error | warn | info)",
+    "cli.err.invalid_style": "unknown --style `{style}` (pretty | compact)",
+    "cli.err.unknown_target": "unknown --target {target} (browser | mini-program-wechat)",
+    "cli.err.document_build_aborted": "document build aborted due to diagnostics",
+    "cli.err.locale_rename_usage": "usage: vmz locale rename <from-message-id> <to-message-id>",
+    "cli.err.locale_explain_usage": "usage: vmz locale explain <message-id> [project]",
+    "cli.err.locale_diff_usage": "usage: vmz locale diff <base-locale> <target-locale> [project]",
+    "cli.err.locale_pseudo_usage": "usage: vmz locale pseudo <source-locale> [project]",
+    "cli.err.application_relocate_manifest": "relocate requires a relocation manifest JSON path",
+    "cli.err.application_relocate_base": "relocate requires --base <ApplicationBase>",
+    "cli.err.artifact_diff_usage": "artifact diff requires <aDigest> <bDigest>",
+    "cli.err.refactor_rename_usage": "rename requires --kind, --from, and --to",
+    "cli.err.explain_style_usage": "usage: vmz explain style <node> [path]",
+    "cli.err.explain_usage": "usage: vmz explain style <node> [path] | vmz explain <target> [path]",
+    "cli.err.project_bin_missing": "found project `vmz` / `@vmz/vmz` but bin/vmz.js is missing.",
+    "cli.err.global_needs_project": "this `vmz` is a global install (mode=global); project commands need a project install.",
+    "cli.err.global_install_hint": "Install in the app:  pnpm add -D @vmz/vmz",
+    "cli.err.global_run_hint": "Then run:            pnpm exec vmz <command>",
+    "cli.err.global_developer_hint": "(developer mode: run from vmz-framework packages/runtimes/vmz source — full CLI)"
+}

package/locales/en-US/diag.json

@@ -1,6 +1,7 @@
 {
     "diag.message": "{message}",
     "diag.detail": "{detail}",
+    "commander::action_failed": "Command failed: {message}",
 
     "vmz::template::illegal_directive": "Illegal or unsupported directive in `<template>`: {detail}",
     "vmz::template::parse_failed": "Failed to parse `<template>`: {detail}",

package/locales/zh-CN/diag.json

@@ -1,6 +1,7 @@
 {
     "diag.message": "{message}",
     "diag.detail": "{detail}",
+    "commander::action_failed": "命令执行失败：{message}",
 
     "vmz::template::illegal_directive": "`<template>` 中存在非法或不支持的指令：{detail}",
     "vmz::template::parse_failed": "解析 `<template>` 失败：{detail}",

package/package.json

@@ -3,24 +3,24 @@
     "vmz": "./bin/vmz.js"
   },
   "dependencies": {
-    "@vmz/commander": "0.3.5",
-    "@vmz/core": "0.3.5",
-    "@vmz/diagnostic": "0.3.5",
-    "@vmz/plugin": "0.3.5",
-    "@vmz/protocol": "0.3.5",
+    "@vmz/commander": "0.3.6",
+    "@vmz/core": "0.3.6",
+    "@vmz/diagnostic": "0.3.6",
+    "@vmz/plugin": "0.3.6",
+    "@vmz/protocol": "0.3.6",
     "jiti": "^2.6.1"
   },
   "description": "VMZ Node toolchain — N-API workspace session + CLI (publish name @vmz/vmz)",
   "devDependencies": {
     "@types/node": "^22.15.0",
-    "@vmz/plugin": "0.3.5",
-    "@vmz/plugin-katex": "0.3.5",
-    "@vmz/plugin-markdown-it": "0.3.5",
-    "@vmz/plugin-shiki": "0.3.5",
-    "@vmz/test": "0.3.5",
+    "@vmz/plugin": "0.3.6",
+    "@vmz/plugin-katex": "0.3.6",
+    "@vmz/plugin-markdown-it": "0.3.6",
+    "@vmz/plugin-shiki": "0.3.6",
+    "@vmz/test": "0.3.6",
     "linkedom": "^0.18.13",
     "typescript": "^5.8.3",
-    "vmz-plugin-conformance": "0.3.5"
+    "vmz-plugin-conformance": "0.3.6"
   },
   "exports": {
     ".": {
@@ -78,16 +78,16 @@
   "main": "./dist/index.js",
   "name": "@vmz/vmz",
   "optionalDependencies": {
-    "@vmz/vmz-darwin-arm64": "0.3.5",
-    "@vmz/vmz-darwin-x64": "0.3.5",
-    "@vmz/vmz-linux-arm64": "0.3.5",
-    "@vmz/vmz-linux-x64": "0.3.5",
-    "@vmz/vmz-win32-arm64": "0.3.5",
-    "@vmz/vmz-win32-x64": "0.3.5"
+    "@vmz/vmz-darwin-arm64": "0.3.6",
+    "@vmz/vmz-darwin-x64": "0.3.6",
+    "@vmz/vmz-linux-arm64": "0.3.6",
+    "@vmz/vmz-linux-x64": "0.3.6",
+    "@vmz/vmz-win32-arm64": "0.3.6",
+    "@vmz/vmz-win32-x64": "0.3.6"
   },
   "peerDependencies": {
-    "@vmz/plugin-markdown-it": "0.3.5",
-    "@vmz/test": "0.3.5",
+    "@vmz/plugin-markdown-it": "0.3.6",
+    "@vmz/test": "0.3.6",
     "typescript": "^5.8.3"
   },
   "peerDependenciesMeta": {
@@ -120,5 +120,5 @@
   },
   "type": "module",
   "types": "./dist/index.d.ts",
-  "version": "0.3.5"
+  "version": "0.3.6"
 }