@metamesh/cli 0.0.0-stage → 0.13.0

package/dist/authoring/worker.js.map

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

package/dist/authoring.d.ts

@@ -0,0 +1,12 @@
+/** Node-only authoring tools for trusted local MetaMesh source. */
+export { AUTHORING_PROTOCOL_VERSION } from "./authoring/types.js";
+export type { AuthoringDiagnostic, AuthoringEnvironment, AuthoringFailure, AuthoringKind, AuthoringPhase, CapturedBuffer, CapturedGeometry, CapturedPart, CapturedResource, CapturedRun, CapturedRunManifest, CheckOptions, CheckSuccess, DocumentationEntry, DocumentationManifest, InstalledAuthoringPackage, RunOptions, RunSuccess, } from "./authoring/types.js";
+export { AuthoringError, authoringFailure } from "./authoring/errors.js";
+export { discoverAuthoringEnvironment, searchAuthoringDocumentation, showAuthoringDocumentation, } from "./authoring/environment.js";
+export type { DocumentationSearchResult } from "./authoring/environment.js";
+export { checkAuthoringSource } from "./authoring/check.js";
+export { runAuthoringSource } from "./authoring/run.js";
+export { inspectCapturedRun, readCapturedRun } from "./authoring/artifacts.js";
+export { renderCapturedRun, installAuthoringBrowser } from "./authoring/render.js";
+export type { RenderOptions, RenderResult, RenderView, RenderFormat, RenderCamera, RenderedImage, } from "./authoring/render-types.js";
+//# sourceMappingURL=authoring.d.ts.map

package/dist/authoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring.d.ts","sourceRoot":"","sources":["../src/authoring.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClE,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EACrB,yBAAyB,EACzB,UAAU,EACV,UAAU,GACX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACnF,YAAY,EACV,aAAa,EACb,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,6BAA6B,CAAC"}

package/dist/authoring.js

@@ -0,0 +1,9 @@
+/** Node-only authoring tools for trusted local MetaMesh source. */
+export { AUTHORING_PROTOCOL_VERSION } from "./authoring/types.js";
+export { AuthoringError, authoringFailure } from "./authoring/errors.js";
+export { discoverAuthoringEnvironment, searchAuthoringDocumentation, showAuthoringDocumentation, } from "./authoring/environment.js";
+export { checkAuthoringSource } from "./authoring/check.js";
+export { runAuthoringSource } from "./authoring/run.js";
+export { inspectCapturedRun, readCapturedRun } from "./authoring/artifacts.js";
+export { renderCapturedRun, installAuthoringBrowser } from "./authoring/render.js";
+//# sourceMappingURL=authoring.js.map

package/dist/authoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring.js","sourceRoot":"","sources":["../src/authoring.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAqBlE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,EAC5B,0BAA0B,GAC3B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/docs/guides/agent-authoring.md

@@ -0,0 +1,183 @@
+# Author and inspect models with an agent
+
+Find installed documentation, check TypeScript, generate a captured model, and inspect its measurements and rendered views locally.
+
+The `metamesh` CLI gives coding agents and developers the same local workflow: look up the
+installed API, check source, execute the real engine, and inspect a captured result. It runs trusted
+local TypeScript with your ordinary Node permissions. The child process is disposable; it is not a
+security sandbox.
+
+## Install and discover the environment
+
+Install Modeling for your model code and the CLI for the local authoring workflow:
+
+```bash
+pnpm add @metamesh/modeling
+pnpm add -D @metamesh/cli
+pnpm exec metamesh environment
+pnpm exec metamesh setup
+```
+
+`environment` reports project-resolved versions, documentation locations, available capabilities,
+and `authoringProtocolVersion: 1`. `setup` prints skill installation guidance and a project-instruction
+snippet for you to review. It does not modify your project or install anything.
+
+Add the Generator SDK as a direct dependency when defining Generators, and Testkit when writing
+automated tests. A project that only runs ordinary models needs Modeling and the CLI as its direct
+dependencies. Keep installed MetaMesh packages on matching releases.
+
+Every public package exposes its offline documentation manifest through `./docs/manifest.json`.
+The CLI searches the packages installed in the selected project. Find a topic in the bounded index,
+then read the returned document ID:
+
+```bash
+pnpm exec metamesh docs search "cylinder"
+pnpm exec metamesh docs show modeling/reference/model/cylinder
+```
+
+Documentation is resolved from the selected project through package exports. No global installation
+or documentation fetched from a moving Git branch replaces the installed version.
+
+## Model entries
+
+A model entry default-exports an ordinary `ModelProgram`. It imports the real package; Studio's
+virtual `@metamesh/project` module is not available in local Node projects.
+
+
+
+```ts
+import { box, cylinder, generate } from "@metamesh/modeling";
+
+export default generate<Record<never, never>>(({ part }) => {
+  const body = box({ size: [30, 20, 6] });
+  const bore = cylinder({ height: 8, radius: 3, sizing: "face" });
+  return part("plate", body.subtract([bore]));
+});
+```
+
+
+
+Save this as `model.ts`, then check and run it:
+
+```bash
+pnpm exec metamesh check model.ts --kind model
+pnpm exec metamesh run model.ts --kind model --export-3mf
+```
+
+Both commands perform semantic TypeScript checking. They use the nearest project TypeScript
+configuration, or an explicit `--tsconfig`, with strict checking enforced. Ordinary local imports
+and installed dependencies are supported. `check` does not evaluate your source.
+
+Use `--params values.json` for a model's JSON parameter map; the default is `{}`. Models do not
+receive injected Generator services. A standalone module can prepare licensed local fonts before
+constructing its synchronous generation program.
+
+For standalone font provenance, also pass `--font-fixtures fonts.json`. The CLI verifies those local
+bytes and records their declared font selections and immutable revisions in the capture; the model
+still prepares its own fonts and receives no injected services. Arbitrary filesystem or network
+reads are not intercepted, so their asset identities cannot be inferred. The source fingerprint
+covers bundled source, while fixture descriptors provide explicit asset provenance.
+
+## Generator entries
+
+Install the Generator contract layer in addition to Modeling and the CLI:
+
+```bash
+pnpm add @metamesh/generator-sdk
+```
+
+A Generator entry named-exports `definition` and default-exports its module envelope:
+
+
+
+```ts
+import {
+  defineGenerator,
+  defineGeneratorModule,
+  type GeneratorParams,
+} from "@metamesh/generator-sdk";
+import { box, generate } from "@metamesh/modeling";
+
+export const definition = defineGenerator({
+  id: "plate",
+  version: "0.1.0",
+  title: "Plate",
+  groups: [],
+  parameters: [{ id: "width", label: "Width", type: "number", default: 30, min: 1 }],
+});
+
+const model = generate<GeneratorParams<typeof definition>>(({ params, part }) =>
+  part("plate", box({ size: [params.width, 20, 6] }))
+);
+
+export default defineGeneratorModule({ definition, generate: model });
+```
+
+
+
+```bash
+pnpm exec metamesh check generator.ts --kind generator
+pnpm exec metamesh run generator.ts --kind generator --params values.json
+```
+
+Generator runs merge declared defaults with explicit overrides, then validate strictly. Unknown
+keys, invalid values, and unsupported combinations produce diagnostics. They are not silently
+clamped or repaired. Use assertions for relationships between parameters.
+
+Generators with Font controls supply a local font-fixture descriptor with `--font-fixtures fonts.json`.
+Fixtures resolve beside that descriptor and must match their immutable revisions. Missing
+bytes and revision mismatches fail before generation; the CLI does not fetch catalog fonts.
+
+## Inspect the captured result
+
+Each run creates a unique directory under `.metamesh/runs`, or the explicit output parent. Use the
+run directory reported by that command as `RUN_DIRECTORY` below:
+
+```bash
+pnpm exec metamesh inspect RUN_DIRECTORY
+pnpm exec metamesh inspect RUN_DIRECTORY --part plate
+pnpm exec metamesh browser install
+pnpm exec metamesh render RUN_DIRECTORY
+pnpm exec metamesh render RUN_DIRECTORY --views top --format webp --transparent
+```
+
+Inspection reads finalized geometry facts, including semantic part IDs, placements, colors,
+measurements, diagnostics, and execution provenance. Rendering reads the same captured buffers
+without executing the model again. Artifacts remain usable after the engine session is disposed or
+the run directory is moved. Corrupt or incomplete artifacts reject.
+
+Rendering requires the separately installed pinned Chromium. It is never downloaded implicitly;
+checking, generation, and inspection work without it. Standard orthographic views are isometric,
+front, top, and right. The default is an isometric 1024 × 1024 PNG on a neutral background. WebP is
+lossless; PNG and WebP both support explicit transparent output. Images record their run, camera,
+renderer, and browser versions. Compare pixels only within the pinned capture environment.
+
+`--export-3mf` exports that run's finalized snapshot. A failed attempt never exposes an older
+successful result as its output. Match the captured parameters and source fingerprint to the
+revision you intended to verify.
+
+## Test models
+
+Install Testkit separately when you want assertions and fixtures for your existing test runner:
+
+```bash
+pnpm add -D @metamesh/testkit
+```
+
+Use its assertions to check dimensions, topology, defaults,
+presets, and parameter variations. Compare physical measurements with explicit tolerances;
+rendered views complement those checks. A valid solid alone does not prove a suitable fit or
+manufacturable wall thickness.
+
+Testkit has no compiler, renderer, or browser dependencies. The CLI owns those tools and its
+reusable Node functions under `@metamesh/cli/authoring`; integrations can call them without
+spawning the command.
+
+## Command results
+
+The CLI defaults to concise human output. Add `--json` for one structured stdout result, with
+bounded author logs on stderr. Exit status is `0` for success, `1` for source, parameter, or
+generation failure, and `2` for invocation, environment, artifact, or tooling failure. Runs have a
+30-second default execution deadline and can lower engine resource ceilings.
+
+Modeling and the Generator SDK remain independent of the CLI and its local Node tooling.

package/dist/docs/guides/package.md

@@ -0,0 +1,72 @@
+# `@metamesh/cli`
+
+Check, execute, inspect, and render trusted local MetaMesh source. The `metamesh` executable and
+Node-only `/authoring` functions use the production engine and version-matched installed documentation.
+
+> **Preview:** `0.x` minor releases may break compatibility. Patches remain compatible within the
+> same minor line.
+
+## Installation
+
+Install matching releases in the project where you author models:
+
+```bash
+pnpm add @metamesh/modeling
+pnpm add -D @metamesh/cli
+```
+
+Add `@metamesh/generator-sdk` when your source defines Generators. Add `@metamesh/testkit` as a
+development dependency when importing testing helpers. CLI internally reuses Testkit font fixtures
+and its SDK contracts; neither package needs to be directly declared for standalone model authoring.
+The compiler, bundler, Three renderer, and Playwright belong to CLI; Testkit does not install them.
+Chromium is installed separately and never downloaded by checking or generation.
+
+## Local workflow
+
+```bash
+pnpm exec metamesh environment
+pnpm exec metamesh docs search "extrude"
+pnpm exec metamesh docs show TOPIC_ID
+pnpm exec metamesh check model.ts --kind model
+pnpm exec metamesh run model.ts --kind model
+pnpm exec metamesh inspect RUN_DIRECTORY
+pnpm exec metamesh browser install
+pnpm exec metamesh render RUN_DIRECTORY --views isometric,front,top,right
+```
+
+`run` includes semantic TypeScript checking and executes in a disposable child process with a
+30-second default deadline. It saves each attempt beneath `.metamesh/runs` with source identity,
+parameters, diagnostics, measurements, and hashed geometry buffers. `inspect` and `render` validate
+those captured buffers without importing the original source. Use `--json` for one structured stdout
+result; bounded author logs go to stderr. Exit codes are 0 for success, 1 for source or generation
+failure, and 2 for invocation, environment, artifact, or tooling failure. This executes trusted local
+code and is not a security sandbox.
+
+For Generators, use `--kind generator`. Entries named-export `definition` and default-export the
+Generator module envelope. Defaults merge with `--params parameters.json`, then strict validation
+rejects unknown or invalid overrides. Standalone model entries default-export a `ModelProgram` and
+receive no injected services. Both support normal local imports and installed dependencies; Studio's
+virtual `@metamesh/project` module is unavailable.
+
+Use `--help` on each command for parameters, fonts, resource limits, export, and image options.
+`metamesh setup` prints skill installation and project-instruction guidance without modifying files.
+
+## Programmatic API and documentation
+
+```ts
+import { inspectCapturedRun, runAuthoringSource } from "@metamesh/cli/authoring";
+
+const result = await runAuthoringSource({ entry: "model.ts", kind: "model" });
+if (result.success) {
+  console.log(await inspectCapturedRun(result.runDirectory));
+}
+```
+
+Resolve `@metamesh/cli/docs/manifest.json` for the installed Markdown reference. The
+[authoring guide](https://metamesh.studio/docs/develop/agent-authoring) explains local font fixtures,
+artifacts, rendering, and agent integration. The reusable authoring functions and command
+implementation stay in this package; geometry and Generator contracts retain their existing owners.
+
+## License
+
+[Apache-2.0](https://github.com/JasonKoolman/metamesh/blob/main/packages/cli/LICENSE).