@metamesh/cli 0.0.0-stage → 0.14.0

package/dist/metamesh.js

@@ -0,0 +1,183 @@
+#!/usr/bin/env node
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { Command, CommanderError, InvalidArgumentError, Option } from "commander";
+import { AuthoringError, authoringFailure, isRecord } from "./authoring/errors.js";
+import { AUTHORING_PROTOCOL_VERSION, } from "./authoring/types.js";
+/** Keep the repository's strict scalar-option policy without importing unpublished tools. */
+function valueOption(flags, description, choices) {
+    const option = new Option(flags, description);
+    if (choices)
+        option.choices([...choices]);
+    const parse = option.parseArg;
+    return option.argParser((value, previous) => {
+        if (previous !== undefined)
+            throw new InvalidArgumentError("option may only be provided once");
+        return parse ? parse(value, previous) : value;
+    });
+}
+const projectFor = (options) => resolve(options.project ?? process.cwd());
+const entryOptions = (options, entry) => ({
+    entry,
+    kind: options.kind, // Commander requires and validates this option before the action.
+    project: projectFor(options),
+    ...(options.tsconfig === undefined ? {} : { tsconfig: options.tsconfig }),
+});
+async function readObject(project, file) {
+    if (file === undefined)
+        return undefined;
+    const value = JSON.parse(await readFile(resolve(project, file), "utf8"));
+    if (!isRecord(value))
+        throw new AuthoringError("invocation", "INVALID_JSON_INPUT", "Parameter and limit files must contain JSON objects.");
+    return value;
+}
+function humanResult(command, result) {
+    if (isRecord(result) && result.success === false && Array.isArray(result.diagnostics))
+        return `${result.diagnostics.map((issue) => `${issue.code}: ${issue.message}`).join("\n")}${typeof result.runDirectory === "string" ? `\nAttempt: ${result.runDirectory}` : ""}\n`;
+    if (command === "environment") {
+        const environment = result;
+        return `MetaMesh authoring protocol ${environment.authoringProtocolVersion}\nProject: ${environment.project}\n${environment.packages.map((pkg) => `${pkg.name} ${pkg.version} (${pkg.documentCount} topics)\n  ${pkg.manifestPath}`).join("\n")}\n`;
+    }
+    if (command === "docs" && Array.isArray(result))
+        return `${result.map(({ id, summary }) => `${id}\n  ${summary}`).join("\n")}\n`;
+    if (isRecord(result) && typeof result.markdown === "string")
+        return `${result.markdown}\n`;
+    if (command === "check" && isRecord(result) && result.success === true)
+        return `TypeScript check passed: ${String(result.entry)}\n`;
+    if ((command === "run" || command === "inspect") &&
+        isRecord(result) &&
+        isRecord(result.manifest)) {
+        const manifest = result.manifest;
+        return `${manifest.parts.length} parts; ${manifest.stats.vertices} vertices; ${manifest.stats.triangles} triangles; ${manifest.stats.volumeMm3.toFixed(3)} mm³\nCaptured: ${String(result.runDirectory ?? result.directory)}\n${manifest.diagnostics.map(({ severity, message }) => `${severity}: ${message}\n`).join("")}${isRecord(result.selectedPart) ? `Part: ${JSON.stringify(result.selectedPart)}\n` : ""}`;
+    }
+    return `${JSON.stringify(result, null, 2)}\n`;
+}
+async function main() {
+    const args = process.argv.slice(2);
+    const json = args.includes("--json");
+    let help = "";
+    const program = new Command("metamesh")
+        .description("Check, generate, inspect, and render local MetaMesh models.")
+        .option("--json", "emit one structured result on stdout")
+        .addOption(valueOption("--project <directory>", "resolve packages and paths from this project"))
+        .allowExcessArguments(false)
+        .configureHelp({ showGlobalOptions: true })
+        .configureOutput({
+        writeOut: (text) => {
+            help += text;
+        },
+        writeErr: () => { },
+    })
+        .addHelpText("after", "\nLocal author source executes with your account's permissions; this is not a sandbox.")
+        .exitOverride();
+    program.action(() => {
+        program.help();
+    });
+    const command = (parent, name, description) => parent.command(name).description(description).allowExcessArguments(false);
+    const action = (target, handler, format = target.name()) => {
+        target.action(async () => {
+            const result = await handler(target.optsWithGlobals(), target.args);
+            if (isRecord(result) && result.success === false)
+                process.exitCode = typeof result.exitCode === "number" ? result.exitCode : 2;
+            process.stdout.write(json ? `${JSON.stringify(result)}\n` : humanResult(format, result));
+        });
+    };
+    const entryCommand = (name, description) => command(program, name, description)
+        .argument("<entry>", "local TypeScript module")
+        .addOption(valueOption("--kind <kind>", "entry module contract", [
+        "model",
+        "generator",
+    ]).makeOptionMandatory())
+        .addOption(valueOption("--tsconfig <file>", "override the nearest TypeScript configuration"));
+    action(command(program, "environment", "discover installed packages and documentation"), async (options) => (await import("./authoring/environment.js")).discoverAuthoringEnvironment(projectFor(options)));
+    const docs = command(program, "docs", "search and read installed version-matched documentation");
+    docs.action(() => {
+        docs.help();
+    });
+    action(command(docs, "search", "search bounded topic and symbol metadata")
+        .argument("<query...>")
+        .addOption(valueOption("--limit <count>", "maximum results, 1–50 (default: 10)")), async (options, query) => (await import("./authoring/environment.js")).searchAuthoringDocumentation(query.join(" "), {
+        project: projectFor(options),
+        ...(options.limit === undefined ? {} : { limit: Number(options.limit) }),
+    }), "docs");
+    action(command(docs, "show", "read one installed topic").argument("<id>"), async (options, [id]) => (await import("./authoring/environment.js")).showAuthoringDocumentation(id, projectFor(options)));
+    action(entryCommand("check", "check TypeScript without evaluating source"), async (options, [entry]) => (await import("./authoring/check.js")).checkAuthoringSource(entryOptions(options, entry)));
+    action(entryCommand("run", "check, execute, and capture a fresh result")
+        .addOption(valueOption("--params <file>", "JSON parameter overrides (default: {})"))
+        .addOption(valueOption("--font-fixtures <file>", "local immutable font descriptors"))
+        .addOption(valueOption("--output <parent>", "parent for a unique run directory"))
+        .addOption(valueOption("--timeout <milliseconds>", "execution deadline (default: 30000)"))
+        .addOption(valueOption("--limits <file>", "JSON overrides lowering engine resource limits"))
+        .option("--export-3mf", "export this captured snapshot as 3MF"), async (options, [entry]) => {
+        const project = projectFor(options);
+        const limits = await readObject(project, options.limits);
+        return (await import("./authoring/run.js")).runAuthoringSource({
+            ...entryOptions(options, entry),
+            params: (await readObject(project, options.params)) ?? {},
+            ...(limits === undefined ? {} : { limits }),
+            ...(options.fontFixtures === undefined ? {} : { fontFixtures: options.fontFixtures }),
+            ...(options.output === undefined ? {} : { output: options.output }),
+            ...(options.timeout === undefined ? {} : { timeoutMs: Number(options.timeout) }),
+            export3mf: options.export3mf ?? false,
+            onLog: (text) => process.stderr.write(text),
+        });
+    });
+    action(command(program, "inspect", "read captured measurements and provenance")
+        .argument("<run-directory>")
+        .addOption(valueOption("--part <id>", "select a semantic part ID")), async (options, [directory]) => (await import("./authoring/artifacts.js")).inspectCapturedRun(resolve(projectFor(options), directory), options.part));
+    action(command(program, "render", "render captured geometry without executing author code")
+        .argument("<run-directory>")
+        .addOption(valueOption("--views <views>", "comma-separated isometric,front,top,right (default: isometric)"))
+        .addOption(valueOption("--width <pixels>", "image width (default: 1024)"))
+        .addOption(valueOption("--height <pixels>", "image height (default: 1024)"))
+        .addOption(valueOption("--format <format>", "image encoding (default: png)", ["png", "webp"]))
+        .option("--transparent", "use a transparent background")
+        .addOption(valueOption("--background <hex-color>", "six-digit RGB background").conflicts("transparent"))
+        .addOption(valueOption("--output <parent>", "parent for a unique capture directory")), async (options, [directory]) => (await import("./authoring/render.js")).renderCapturedRun(resolve(projectFor(options), directory), {
+        ...(options.views === undefined
+            ? {}
+            : { views: options.views.split(",") }),
+        ...(options.width === undefined ? {} : { width: Number(options.width) }),
+        ...(options.height === undefined ? {} : { height: Number(options.height) }),
+        ...(options.format === undefined ? {} : { format: options.format }),
+        ...(options.transparent
+            ? { background: "transparent" }
+            : options.background === undefined
+                ? {}
+                : { background: options.background }),
+        ...(options.output === undefined
+            ? {}
+            : { outputDirectory: resolve(projectFor(options), options.output) }),
+    }));
+    const browser = command(program, "browser", "set up the optional pinned capture browser");
+    browser.action(() => {
+        browser.help();
+    });
+    action(command(browser, "install", "explicitly install pinned Chromium"), async () => (await import("./authoring/render.js")).installAuthoringBrowser());
+    action(command(program, "setup", "print skill installation and project-instruction guidance"), () => ({
+        success: true,
+        authoringProtocolVersion: AUTHORING_PROTOCOL_VERSION,
+        installation: "pnpm dlx skills@1.5.22 add https://github.com/metamesh-studio/metamesh-skills --skill metamesh-developer",
+        publication: "The operator must publish the canonical skills repository before this GitHub installation command is available.",
+        instructions: "Use the metamesh-developer skill. Run metamesh environment --json in this project, consult installed docs with metamesh docs search/show, then check, run, and inspect the captured result. Render relevant views before declaring geometry work complete.",
+    }));
+    try {
+        await program.parseAsync(args, { from: "user" });
+    }
+    catch (error) {
+        if (error instanceof CommanderError && error.exitCode === 0) {
+            process.stdout.write(json ? `${JSON.stringify({ success: true, help })}\n` : help);
+            return;
+        }
+        const failure = authoringFailure(error instanceof CommanderError
+            ? new AuthoringError("invocation", "INVALID_ARGUMENTS", error.message.replace(/^error:\s*/i, ""))
+            : error, "invocation");
+        process.exitCode = failure.exitCode;
+        if (json)
+            process.stdout.write(`${JSON.stringify(failure)}\n`);
+        else
+            process.stderr.write(`${failure.diagnostics.map(({ code, message }) => `${code}: ${message}`).join("\n")}\n`);
+    }
+}
+await main();
+//# sourceMappingURL=metamesh.js.map

package/dist/metamesh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metamesh.js","sourceRoot":"","sources":["../src/metamesh.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,66 @@
 {
   "name": "@metamesh/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "description": "Local MetaMesh authoring CLI and reusable Node tools for checking, captured generation, inspection, and rendering.",
+  "version": "0.14.0",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/JasonKoolman/metamesh.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/JasonKoolman/metamesh#readme",
+  "bugs": {
+    "url": "https://github.com/JasonKoolman/metamesh/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "CHANGELOG.md",
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "bin": {
+    "metamesh": "./dist/metamesh.js"
+  },
+  "exports": {
+    "./authoring": {
+      "types": "./dist/authoring.d.ts",
+      "import": "./dist/authoring.js"
+    },
+    "./docs/manifest.json": "./dist/docs/manifest.json"
+  },
+  "dependencies": {
+    "@metamesh/testkit": "0.14.0",
+    "commander": "15.0.0",
+    "esbuild": "^0.28.2",
+    "playwright": "1.64.1",
+    "three": "0.186.1",
+    "typescript": "6.0.3"
+  },
+  "peerDependencies": {
+    "@metamesh/generator-sdk": "0.14.0",
+    "@metamesh/modeling": "0.14.0"
+  },
+  "peerDependenciesMeta": {
+    "@metamesh/generator-sdk": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@metamesh/config": "0.0.0",
+    "@metamesh/generator-sdk": "0.14.0",
+    "@metamesh/modeling": "0.14.0",
+    "vitest": "^5.0.5",
+    "@types/node": "^24.19.2",
+    "@types/three": "0.186.0"
+  },
+  "scripts": {
+    "build": "node ../../scripts/clean-dist.mjs && tsc -p tsconfig.build.json && node scripts/build-renderer.mjs && node ../../scripts/package-docs/build.mjs cli",
+    "lint": "eslint .",
+    "test": "vitest run src",
+    "typecheck": "tsc --noEmit --pretty false"
+  }
 }