@vmz/vmz 0.1.16 → 0.1.18

package/dist/application-cmd.d.ts

@@ -1,21 +1,11 @@
 /**
- * `vmz application` — Application Collection / Mount .
+ * `vmz application` — registered on `@vmz/commander`.
  */
-/**
- * @param {string[]} argv
- * @returns {Promise<number>}
- */
-export declare function cmdApplication(argv: any): Promise<number>;
-/**
- * @param {string} pathArg
- */
-export declare function runCheck(pathArg: any): {
+import type { Command } from '@vmz/commander';
+export declare function registerApplicationCommands(parent: Command): void;
+export declare function runCheck(pathArg: string): {
     project: string;
-    json: any;
+    json: string;
     data: any;
 };
-/**
- * @param {string} hostRoot
- * @returns {boolean}
- */
-export declare function hasApplicationsConfig(hostRoot: any): boolean;
+export declare function hasApplicationsConfig(hostRoot: string): boolean;

package/dist/application-cmd.js

@@ -1,6 +1,5 @@
-// @ts-nocheck
 /**
- * `vmz application` — Application Collection / Mount .
+ * `vmz application` — registered on `@vmz/commander`.
  */
 import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import path from 'node:path';
@@ -8,106 +7,18 @@ import { loadNative } from './index.js';
 import { log } from './log.js';
 import { resolveWorkspacePackages } from './packages.js';
 import { resolveWorkspaceDirs } from './resolve.js';
-/**
- * @param {string[]} argv
- * @returns {Promise<number>}
- */
-export async function cmdApplication(argv) {
-    const [sub, ...rest] = argv;
-    if (!sub || sub === 'help' || sub === '-h' || sub === '--help') {
-        printHelp();
-        return 0;
-    }
-    if (sub === 'check')
-        return cmdCheck(rest);
-    if (sub === 'list')
-        return cmdList(rest);
-    if (sub === 'schemas' || sub === 'protocol')
-        return cmdSchemas();
-    if (sub === 'relocatable')
-        return cmdRelocatable(rest);
-    if (sub === 'relocate')
-        return cmdRelocate(rest);
-    if (sub === 'artifacts')
-        return cmdArtifacts(rest);
-    if (sub === 'isolation')
-        return cmdIsolation(rest);
-    if (sub === 'composition' || sub === 'compose' || sub === 'host')
-        return cmdComposition(rest);
-    if (sub === 'dev' || sub === 'sessions' || sub === 'm5')
-        return cmdDev(rest);
-    log.error(`unknown application subcommand \`${sub}\``);
-    printHelp();
-    return 1;
-}
-function printHelp() {
-    console.log(`vmz application — Application Collection / Mount
-
-Usage:
-  vmz application check [host]              Validate descriptors + applications.config.json5
-  vmz application list [host]               List resolved ApplicationIds / collections / mounts
-  vmz application schemas                   Print frozen protocol catalog JSON
-  vmz application relocatable [pkg]          ApplicationBase / non_relocatable_url proof
-  vmz application relocate <manifest.json>  apply ApplicationBase to relocation manifest
-  vmz application artifacts [host]          ApplicationArtifact + MountTable boundary
-  vmz application isolation [host]          isolation namespaces + failure containment
-  vmz application composition [host]        catalog consumption + cross-app Link hrefs
-  vmz application dev [host]                sessions / affected / proxy / mounted tests / deploy
-
-Options:
-  --json [file]    Emit report JSON to stdout or file
-  --base <path>    ApplicationBase for relocatable / relocate (e.g. /examples/counter)
-  --dirty <path>   Dirty file path for affected planning (repeatable)
-`);
-}
-/**
- * @param {string[]} argv
- */
-function parseRest(argv) {
-    /** @type {Record<string, string | boolean | string[]> & { _: string[] }} */
-    const out = { _: [] };
-    for (let i = 0; i < argv.length; i++) {
-        const a = argv[i];
-        if (a.startsWith('--')) {
-            const key = a.slice(2);
-            const next = argv[i + 1];
-            if (key === 'json') {
-                if (next && !next.startsWith('-')) {
-                    out.json = next;
-                    i += 1;
-                }
-                else {
-                    out.json = true;
-                }
-                continue;
-            }
-            if (key === 'dirty') {
-                if (!Array.isArray(out.dirty))
-                    out.dirty = [];
-                if (next && !next.startsWith('-')) {
-                    out.dirty.push(next);
-                    i += 1;
-                }
-                continue;
-            }
-            if (next && !next.startsWith('-')) {
-                out[key] = next;
-                i += 1;
-            }
-            else {
-                out[key] = true;
-            }
-            continue;
-        }
-        out._.push(a);
-    }
-    return out;
+export function registerApplicationCommands(parent) {
+    const withCommon = (cmd) => cmd.option('--json [file]', 'cli.opt.json').option('--base <path>', 'cli.opt.base').option('--dirty <path>...', 'cli.opt.dirty');
+    withCommon(parent.command('check', 'cli.cmd.application.check')).action((o) => cmdCheck(o));
+    withCommon(parent.command('list', 'cli.cmd.application.list')).action((o) => cmdList(o));
+    parent.command('schemas|protocol', 'cli.cmd.application.schemas').action(() => cmdSchemas());
+    withCommon(parent.command('relocatable', 'cli.cmd.application.relocatable')).action((o) => cmdRelocatable(o));
+    withCommon(parent.command('relocate', 'cli.cmd.application.relocate')).action((o) => cmdRelocate(o));
+    withCommon(parent.command('artifacts', 'cli.cmd.application.artifacts')).action((o) => cmdArtifacts(o));
+    withCommon(parent.command('isolation', 'cli.cmd.application.isolation')).action((o) => cmdIsolation(o));
+    withCommon(parent.command('composition|compose|host', 'cli.cmd.application.composition')).action((o) => cmdComposition(o));
+    withCommon(parent.command('dev|sessions|m5', 'cli.cmd.application.dev')).action((o) => cmdDev(o));
 }
-/**
- * @param {{ json?: string | boolean }} args
- * @param {string} json
- * @param {(data: any) => void} [printHuman]
- */
 function emitJson(args, json, printHuman) {
     if (typeof args.json === 'string') {
         writeFileSync(args.json, `${json}\n`, 'utf8');
@@ -127,27 +38,16 @@ function cmdSchemas() {
     console.log(native.queryApplicationProtocolCatalog);
     return 0;
 }
-/**
- * @param {string[]} argv
- */
-function cmdCheck(argv) {
-    const args = parseRest(argv);
+function cmdCheck(args) {
     const report = runCheck(args._[0] ?? '.');
     emitJson(args, report.json, (data) => {
         const errors = data.diagnostics.filter((d) => d.severity === 'error');
         log.info(`application check: descriptors=${data.descriptors.length} collections=${data.collections.length} mounts=${data.mounts.length} errors=${errors.length}`);
-        for (const d of data.diagnostics) {
-            const fn = d.severity === 'error' ? log.error : log.warn;
-            fn(`${d.code}: ${d.path}: ${d.message}`);
-        }
+        log.diagnostics(data.diagnostics ?? []);
     });
     return report.data.diagnostics.some((d) => d.severity === 'error') ? 1 : 0;
 }
-/**
- * @param {string[]} argv
- */
-function cmdList(argv) {
-    const args = parseRest(argv);
+function cmdList(args) {
     const report = runCheck(args._[0] ?? '.');
     emitJson(args, report.json, (data) => {
         for (const d of data.descriptors) {
@@ -163,11 +63,7 @@ function cmdList(argv) {
     });
     return report.data.diagnostics.some((d) => d.severity === 'error') ? 1 : 0;
 }
-/**
- * @param {string[]} argv
- */
-function cmdRelocatable(argv) {
-    const args = parseRest(argv);
+function cmdRelocatable(args) {
     const { project } = resolveWorkspaceDirs({ path: args._[0] ?? '.' });
     const native = loadNative();
     if (typeof native.checkApplicationRelocatableJson !== 'function') {
@@ -179,25 +75,18 @@ function cmdRelocatable(argv) {
     emitJson(args, json, () => {
         const errors = data.diagnostics.filter((d) => d.severity === 'error');
         log.info(`application relocatable: entries=${data.manifest?.entries?.length ?? 0} errors=${errors.length}`);
-        for (const d of data.diagnostics) {
-            const fn = d.severity === 'error' ? log.error : log.warn;
-            fn(`${d.code}: ${d.path}: ${d.message}`);
-        }
+        log.diagnostics(data.diagnostics ?? []);
     });
     return data.diagnostics.some((d) => d.severity === 'error') ? 1 : 0;
 }
-/**
- * @param {string[]} argv
- */
-function cmdRelocate(argv) {
-    const args = parseRest(argv);
+function cmdRelocate(args) {
     const manifestPath = args._[0];
     if (!manifestPath) {
-        log.error('relocate requires a relocation manifest JSON path');
+        log.errorId('cli.err.application_relocate_manifest');
         return 1;
     }
     if (typeof args.base !== 'string' || !args.base) {
-        log.error('relocate requires --base <ApplicationBase>');
+        log.errorId('cli.err.application_relocate_base');
         return 1;
     }
     const native = loadNative();
@@ -209,43 +98,25 @@ function cmdRelocate(argv) {
     emitJson(args, json);
     return 0;
 }
-/**
- * @param {string[]} argv
- */
-function cmdArtifacts(argv) {
-    const args = parseRest(argv);
+function cmdArtifacts(args) {
     const report = runHostPackageReport(args._[0] ?? '.', 'checkApplicationArtifactBoundaryJson');
     emitJson(args, report.json, (data) => {
         const errors = data.diagnostics.filter((d) => d.severity === 'error');
         log.info(`application artifacts: artifacts=${data.artifacts?.length ?? 0} mounts=${data.mountTable?.mounts?.length ?? 0} errors=${errors.length}`);
-        for (const d of data.diagnostics) {
-            const fn = d.severity === 'error' ? log.error : log.warn;
-            fn(`${d.code}: ${d.path}: ${d.message}`);
-        }
+        log.diagnostics(data.diagnostics ?? []);
     });
     return report.data.diagnostics.some((d) => d.severity === 'error') ? 1 : 0;
 }
-/**
- * @param {string[]} argv
- */
-function cmdIsolation(argv) {
-    const args = parseRest(argv);
+function cmdIsolation(args) {
     const report = runHostPackageReport(args._[0] ?? '.', 'checkApplicationIsolationJson');
     emitJson(args, report.json, (data) => {
         const errors = data.diagnostics.filter((d) => d.severity === 'error');
         log.info(`application isolation: namespaces=${data.namespaces?.length ?? 0} containment=${data.failureContainment?.length ?? 0} errors=${errors.length}`);
-        for (const d of data.diagnostics) {
-            const fn = d.severity === 'error' ? log.error : log.warn;
-            fn(`${d.code}: ${d.path}: ${d.message}`);
-        }
+        log.diagnostics(data.diagnostics ?? []);
     });
     return report.data.diagnostics.some((d) => d.severity === 'error') ? 1 : 0;
 }
-/**
- * @param {string[]} argv
- */
-function cmdComposition(argv) {
-    const args = parseRest(argv);
+function cmdComposition(args) {
     const report = runHostPackageReport(args._[0] ?? '.', 'checkApplicationHostCompositionJson');
     emitJson(args, report.json, (data) => {
         const errors = data.diagnostics.filter((d) => d.severity === 'error');
@@ -253,25 +124,23 @@ function cmdComposition(argv) {
         for (const link of data.crossApplicationLinks ?? []) {
             console.log(`link ${link.applicationId}\t${link.routeId}\t${link.href ?? '(unresolved)'}\tdocumentNavigation=${link.documentNavigation}`);
         }
-        for (const d of data.diagnostics) {
-            const fn = d.severity === 'error' ? log.error : log.warn;
-            fn(`${d.code}: ${d.path}: ${d.message}`);
-        }
+        log.diagnostics(data.diagnostics ?? []);
     });
     return report.data.diagnostics.some((d) => d.severity === 'error') ? 1 : 0;
 }
-/**
- * @param {string[]} argv
- */
-function cmdDev(argv) {
-    const args = parseRest(argv);
+function cmdDev(args) {
     const pathArg = args._[0] ?? '.';
     const { project } = resolveWorkspaceDirs({ path: pathArg });
     const packages = resolveWorkspacePackages(project);
     const roots = packages.map((p) => p.root);
     if (!roots.includes(project))
         roots.unshift(project);
-    const dirty = Array.isArray(args.dirty) ? args.dirty.map((d) => path.resolve(project, String(d))) : [];
+    const dirtyRaw = args.dirty;
+    const dirty = Array.isArray(dirtyRaw)
+        ? dirtyRaw.map((d) => path.resolve(project, String(d)))
+        : typeof dirtyRaw === 'string'
+            ? [path.resolve(project, dirtyRaw)]
+            : [];
     const native = loadNative();
     if (typeof native.checkApplicationDevTestDeployJson !== 'function') {
         log.error('checkApplicationDevTestDeployJson missing — rebuild native (`pnpm napi:build`)');
@@ -295,17 +164,10 @@ function cmdDev(argv) {
         for (const c of report.proxy?.cases ?? []) {
             console.log(`proxy ${c.url}\t${c.applicationId ?? '-'}\t${c.status}\t${c.reason ?? ''}`);
         }
-        for (const d of report.diagnostics || []) {
-            const fn = d.severity === 'error' ? log.error : log.warn;
-            fn(`${d.code}: ${d.path}: ${d.message}`);
-        }
+        log.diagnostics(report.diagnostics || []);
     });
     return data.diagnostics.some((d) => d.severity === 'error') ? 1 : 0;
 }
-/**
- * @param {string} pathArg
- * @param {string} nativeFn
- */
 function runHostPackageReport(pathArg, nativeFn) {
     const { project } = resolveWorkspaceDirs({ path: pathArg });
     const packages = resolveWorkspacePackages(project);
@@ -320,14 +182,10 @@ function runHostPackageReport(pathArg, nativeFn) {
     const data = JSON.parse(json);
     return { project, json, data };
 }
-/**
- * @param {string} pathArg
- */
 export function runCheck(pathArg) {
     const { project } = resolveWorkspaceDirs({ path: pathArg });
     const packages = resolveWorkspacePackages(project);
     const roots = packages.map((p) => p.root);
-    // Always include host root so a local package.json#vmz.application is visible.
     if (!roots.includes(project))
         roots.unshift(project);
     const native = loadNative();
@@ -338,10 +196,6 @@ export function runCheck(pathArg) {
     const data = JSON.parse(json);
     return { project, json, data };
 }
-/**
- * @param {string} hostRoot
- * @returns {boolean}
- */
 export function hasApplicationsConfig(hostRoot) {
     return existsSync(path.join(hostRoot, 'applications.config.json5'));
 }

package/dist/author-input.d.ts

@@ -1,19 +1,40 @@
-/**
- * Degrade author JSON5/JSON text to a plain object via Rust (not a semantic plan API).
- * @param {string} source
- * @returns {any}
- */
-export declare function parseAuthorInput(source: any): any;
-/**
- * @param {string} projectRoot
- */
-export declare function loadLocalePlan(projectRoot: any): any;
-/**
- * @param {string} projectRoot
- */
-export declare function loadDocumentRoutePlan(projectRoot: any): any;
-/**
- * Map Rust ReportedDiagnostic rows into host `{ code, severity, message, path }` rows.
- * @param {Array<{ code?: string, severity?: string, message?: string, path?: string }>} rows
- */
-export declare function mapPlanDiagnostics(rows: any): any;
+export interface PlanDiagnostic {
+    code?: string;
+    severity?: string;
+    message?: string;
+    path?: string;
+}
+export interface MappedPlanDiagnostic {
+    code: string;
+    severity: string;
+    message: string;
+    path: string | undefined;
+}
+export interface LocalePlan {
+    diagnostics?: PlanDiagnostic[];
+    routing?: {
+        strategy?: string;
+        defaultPrefix?: string;
+    };
+    defaultLocale?: string;
+}
+export interface DocumentRouteCollection {
+    id: string;
+    sourceRoot?: string;
+    routeBase?: string;
+}
+/** Normalized documents route plan from Rust (author JSON5/JSON/declaration). */
+export interface DocumentRoutePlan {
+    diagnostics?: PlanDiagnostic[];
+    sourcePath?: string | null;
+    defaultLocale?: string | null;
+    localeLabels?: Record<string, string>;
+    collections?: DocumentRouteCollection[];
+    silentFallbackRequested?: boolean;
+}
+/** Degrade author JSON5/JSON text to a plain object via Rust (not a semantic plan API). */
+export declare function parseAuthorInput(source: string): unknown;
+export declare function loadLocalePlan(projectRoot: string): LocalePlan;
+export declare function loadDocumentRoutePlan(projectRoot: string): DocumentRoutePlan;
+/** Map Rust ReportedDiagnostic rows into host `{ code, severity, message, path }` rows. */
+export declare function mapPlanDiagnostics(rows: PlanDiagnostic[] | null | undefined): MappedPlanDiagnostic[];

package/dist/author-input.js

@@ -1,4 +1,3 @@
-// @ts-nocheck
 /**
  * Author declaration input via Rust N-API (no JS JSON5 package).
  *
@@ -6,11 +5,7 @@
  * Catalogs / transitional tables: parseAuthorInput → Rust degrade → JSON.parse.
  */
 import { requireNativeAddon } from './native-addon.js';
-/**
- * Degrade author JSON5/JSON text to a plain object via Rust (not a semantic plan API).
- * @param {string} source
- * @returns {any}
- */
+/** Degrade author JSON5/JSON text to a plain object via Rust (not a semantic plan API). */
 export function parseAuthorInput(source) {
     const native = requireNativeAddon();
     if (typeof native.authorJson5ToCanonicalJson !== 'function') {
@@ -18,9 +13,6 @@ export function parseAuthorInput(source) {
     }
     return JSON.parse(native.authorJson5ToCanonicalJson(String(source)));
 }
-/**
- * @param {string} projectRoot
- */
 export function loadLocalePlan(projectRoot) {
     const native = requireNativeAddon();
     if (typeof native.loadLocalePlan !== 'function') {
@@ -28,9 +20,6 @@ export function loadLocalePlan(projectRoot) {
     }
     return JSON.parse(native.loadLocalePlan(String(projectRoot)));
 }
-/**
- * @param {string} projectRoot
- */
 export function loadDocumentRoutePlan(projectRoot) {
     const native = requireNativeAddon();
     if (typeof native.loadDocumentRoutePlan !== 'function') {
@@ -38,10 +27,7 @@ export function loadDocumentRoutePlan(projectRoot) {
     }
     return JSON.parse(native.loadDocumentRoutePlan(String(projectRoot)));
 }
-/**
- * Map Rust ReportedDiagnostic rows into host `{ code, severity, message, path }` rows.
- * @param {Array<{ code?: string, severity?: string, message?: string, path?: string }>} rows
- */
+/** Map Rust ReportedDiagnostic rows into host `{ code, severity, message, path }` rows. */
 export function mapPlanDiagnostics(rows) {
     return (rows || []).map((d) => ({
         code: d.code || 'vmz::unknown',

package/dist/build-assemble.d.ts

@@ -3,50 +3,72 @@
  */
 export declare const BUILD_PROOF_SCHEMA = "vmz.build.proof.v0";
 export declare const ASSEMBLE_MANIFEST_SCHEMA = "vmz.assemble.manifest.v0";
-/**
- * @param {string} outDir
- * @param {any} ctx
- */
-export declare function assembleDelivery(outDir: any, ctx: any): Promise<{
-    manifest: {
+interface AssembleStep {
+    kind: string;
+    digest?: string;
+    status?: string;
+    note?: string;
+    reason?: string;
+    htmlFiles?: number;
+    skipped?: number;
+    publicRoutes?: number;
+    internalCapabilities?: number;
+    httpContractDigest?: string;
+    objectCount?: number;
+}
+interface AssembleManifest {
+    schema: string;
+    profileId: unknown;
+    assembly: unknown;
+    serverRuntime: unknown;
+    steps: AssembleStep[];
+    staticDelivery?: {
+        digest: string;
+        htmlFiles: unknown;
+        skipped: unknown;
+    };
+    serverArtifact?: {
+        digest: string;
+        httpContractDigest: string;
         schema: string;
-        profileId: any;
-        assembly: any;
-        serverRuntime: any;
-        steps: any[];
+        selectedRuntime: string;
     };
-    path: string;
-}>;
-/**
- * @param {string} outDir
- * @param {any} ctx
- */
-export declare function emitBuildProof(outDir: any, ctx: any): {
-    proof: {
+    siteDelivery?: {
+        digest: string;
+        schema: string;
+    };
+    embeddedPackaging?: {
+        digest: string;
+        objectCount: number;
         schema: string;
-        profileId: any;
-        assembly: any;
-        selectionDigest: any;
-        packDigest: any;
-        assembleDigest: any;
-        release: boolean;
-        semanticIds: string[];
-        slots: {
-            'server-host': {
-                status: string;
-            };
-            'static-delivery': {
-                status: string;
-            };
-            'site-fallback': {
-                status: string;
-            };
-            'asset-graph': {
-                status: string;
-            };
-        };
-        productionReadyClaim: boolean;
-        note: string;
     };
+    packDigest?: string | null;
+    assembleDigest?: string;
+}
+interface BuildProofSlot {
+    status: string;
+    detail?: string;
+}
+interface BuildProofBody {
+    schema: string;
+    profileId: unknown;
+    assembly: unknown;
+    selectionDigest: unknown;
+    packDigest: string | null;
+    assembleDigest: string | null;
+    release: boolean;
+    semanticIds: string[];
+    slots: Record<string, BuildProofSlot>;
+    productionReadyClaim: boolean;
+    note: string;
+    proofDigest?: string;
+}
+export declare function assembleDelivery(outDir: string, ctx: Record<string, unknown>): Promise<{
+    manifest: AssembleManifest;
+    path: string;
+}>;
+export declare function emitBuildProof(outDir: string, ctx: Record<string, unknown>): {
+    proof: BuildProofBody;
     path: string;
 };
+export {};