@metamesh/cli 0.13.0 → 0.14.0

package/dist/authoring/types.d.ts

@@ -1,60 +1,79 @@
-import type { Bounds3, FinalizedModel, GenerationDiagnostic, ModelingLimits, Vector3 } from "@metamesh/modeling";
+import type { Bounds3, FinalizedModel, GenerationDiagnostic, ModelingLimits, Vector3Tuple } from "@metamesh/modeling";
 import type { ModelDependencies, SnapshotPart } from "@metamesh/modeling/engine";
+/** Version of the CLI authoring protocol, independent of package SemVer and engine compatibility. */
 export declare const AUTHORING_PROTOCOL_VERSION = 1;
+/** Selects a standalone ModelProgram entry or an SDK Generator module with a definition. */
 export type AuthoringKind = "model" | "generator";
+/** The workflow stage that rejected an invocation, source, asset, or captured artifact. */
 export type AuthoringPhase = "invocation" | "environment" | "check" | "parameters" | "assets" | "bundle" | "execute" | "artifact" | "render";
+/** A structured issue with optional source location, parameter association, and geometry context. */
 export interface AuthoringDiagnostic {
     readonly code: string;
     readonly message: string;
     readonly severity: "error" | "warning";
     readonly file?: string;
+    /** One-based source line, when available. */
     readonly line?: number;
+    /** One-based source column, when available. */
     readonly column?: number;
     readonly parameterId?: string;
     readonly path?: readonly (number | string)[];
     readonly context?: Readonly<Record<string, unknown>>;
 }
+/** An unsuccessful command outcome; a failure directory does not establish a complete capture. */
 export interface AuthoringFailure {
     readonly success: false;
     readonly phase: AuthoringPhase;
+    /** 1 for source or generation failures; 2 for invocation, environment, artifact, or tooling failures. */
     readonly exitCode: 1 | 2;
     readonly diagnostics: readonly AuthoringDiagnostic[];
+    /** This attempt's directory, when created; read its failure metadata instead of inspecting geometry. */
     readonly runDirectory?: string;
 }
+/** Metadata for one installed Markdown guide or public API symbol. */
 export interface DocumentationEntry {
     readonly id: string;
     readonly title: string;
     readonly summary: string;
+    /** Forward-slash relative path beside the owning documentation manifest. */
     readonly path: string;
     readonly importPath: string;
     readonly availability: string;
     readonly canonical: string;
     readonly keywords: readonly string[];
 }
+/** Exact-package-version index exposed through the package's docs/manifest.json export. */
 export interface DocumentationManifest {
     readonly formatVersion: 1;
     readonly packageName: string;
     readonly packageVersion: string;
     readonly documents: readonly DocumentationEntry[];
 }
+/** A project-local MetaMesh package and its verified documentation index. */
 export interface InstalledAuthoringPackage {
     readonly name: string;
     readonly version: string;
     readonly manifestPath: string;
     readonly documentCount: number;
 }
+/** The selected project's supported protocol, matching package releases, and available workflows. */
 export interface AuthoringEnvironment {
     readonly authoringProtocolVersion: typeof AUTHORING_PROTOCOL_VERSION;
     readonly project: string;
     readonly packages: readonly InstalledAuthoringPackage[];
     readonly capabilities: readonly string[];
 }
+/** Source entry contract and project-local resolution settings for semantic checking. */
 export interface CheckOptions {
+    /** Entry path, resolved from project. */
     readonly entry: string;
     readonly kind: AuthoringKind;
+    /** Package and path resolution root; defaults to the current working directory. */
     readonly project?: string;
+    /** Explicit configuration path relative to project; otherwise the entry's nearest tsconfig is used. */
     readonly tsconfig?: string;
 }
+/** A successful semantic check; source has not been evaluated and no geometry is captured. */
 export interface CheckSuccess {
     readonly success: true;
     readonly entry: string;
@@ -62,40 +81,55 @@ export interface CheckSuccess {
     readonly tsconfig?: string;
     readonly diagnostics: readonly AuthoringDiagnostic[];
 }
+/** Inputs and bounded execution policy for one checked, trusted local source attempt. */
 export interface RunOptions extends CheckOptions {
+    /** Generator overrides merged with definition defaults, or the standalone model's raw parameter map. */
     readonly params?: Readonly<Record<string, unknown>>;
+    /** Local font descriptor JSON path relative to project; no assets are downloaded. */
     readonly fontFixtures?: string;
+    /** Parent for a unique attempt directory; defaults to .metamesh/runs beneath project. */
     readonly output?: string;
+    /** Child execution deadline in milliseconds, from 1 to 3600000; defaults to 30000. */
     readonly timeoutMs?: number;
+    /** Engine resource ceilings may be lowered from their defaults, never raised. */
     readonly limits?: Partial<ModelingLimits>;
+    /** Export the completed snapshot as 3MF in this run; defaults to false. */
     readonly export3mf?: boolean;
+    /** Receives combined child stdout/stderr, truncated after 64 KiB. */
     readonly onLog?: (text: string) => void;
 }
+/** A captured file's relative path, byte length, and SHA-256 integrity digest. */
 export interface CapturedBuffer {
     readonly path: string;
     readonly bytes: number;
     readonly sha256: string;
 }
+/** A shared local-space mesh resource and its measurements, before per-part placement. */
 export interface CapturedResource {
     readonly id: string;
     readonly positions: CapturedBuffer;
     readonly indices: CapturedBuffer;
     readonly measurements: SnapshotPart["measurements"];
 }
+/** Semantic part identity and appearance referencing a shared mesh with separate placement. */
 export interface CapturedPart {
     readonly id: string;
     readonly resourceId: string;
-    readonly position: Vector3;
-    readonly rotation: Vector3;
+    /** World translation in millimetres, applied after rotation. */
+    readonly position: Vector3Tuple;
+    /** Global XYZ rotation in degrees, applied once to local geometry. */
+    readonly rotation: Vector3Tuple;
     readonly color?: string;
     readonly measurements: SnapshotPart["measurements"];
 }
+/** A completed attempt's provenance, effective inputs, diagnostics, and captured geometry. */
 export interface CapturedRunManifest {
     readonly formatVersion: 1;
     readonly status: "complete";
     readonly runId: string;
     readonly createdAt: string;
     readonly kind: AuthoringKind;
+    /** Project-relative entry and fingerprint of bundled local source files. */
     readonly source: {
         readonly entry: string;
         readonly fingerprint: string;
@@ -120,16 +154,19 @@ export interface CapturedRunManifest {
     readonly parts: readonly CapturedPart[];
     readonly export3mf?: CapturedBuffer;
 }
+/** Validated local-space mesh buffers loaded from a completed captured resource. */
 export interface CapturedGeometry {
     readonly id: string;
     readonly positions: Float32Array;
     readonly indices: Uint32Array;
 }
+/** A validated successful capture with its manifest and shared local geometry buffers. */
 export interface CapturedRun {
     readonly directory: string;
     readonly manifest: CapturedRunManifest;
     readonly resources: readonly CapturedGeometry[];
 }
+/** A successful checked execution; use this exact directory for subsequent inspection and rendering. */
 export interface RunSuccess {
     readonly success: true;
     readonly runDirectory: string;

package/dist/authoring/types.d.ts.map

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

package/dist/authoring/types.js

@@ -1,2 +1,3 @@
+/** Version of the CLI authoring protocol, independent of package SemVer and engine compatibility. */
 export const AUTHORING_PROTOCOL_VERSION = 1;
 //# sourceMappingURL=types.js.map

package/dist/authoring/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/authoring/types.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/authoring/types.ts"],"names":[],"mappings":"AASA,qGAAqG;AACrG,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC"}

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

@@ -14,18 +14,26 @@ Install Modeling for your model code and the CLI for the local authoring workflo
 ```bash
 pnpm add @metamesh/modeling
 pnpm add -D @metamesh/cli
-pnpm exec metamesh environment
+pnpm exec metamesh environment --json
 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.
+and `authoringProtocolVersion: 1`. An agent integration should check that protocol value before
+using the commands. Missing packages, mismatched releases, or an unsupported protocol need an
+environment fix before authoring.
 
 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.
 
+| Component                 | Responsibility                                                                                |
+| ------------------------- | --------------------------------------------------------------------------------------------- |
+| `@metamesh/modeling`      | Geometry operations, synchronous generation, engine sessions, and completed snapshots         |
+| `@metamesh/generator-sdk` | Serializable controls, parameter types and validation, and Generator module envelopes         |
+| `@metamesh/cli`           | Installed documentation lookup, TypeScript checking, captured runs, inspection, and rendering |
+| `@metamesh/testkit`       | Test runners, fixtures, and assertions used by your existing test framework                   |
+
 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:
@@ -38,6 +46,24 @@ 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.
 
+### Give an agent the same workflow
+
+`setup` prints skill installation guidance and a project-instruction snippet for review. It does
+not modify files, install a skill, or initialize a model. The optional `metamesh-developer` skill
+describes the authoring and verification workflow; `metamesh-docs` supports documentation work.
+Both are maintained separately in `metamesh-studio/metamesh-skills`.
+
+Use a reviewed skill snapshot provided by your project or installed through your agent's skill
+tooling. The printed GitHub installation source must be published before that command can work;
+a skill is optional for the CLI workflow below. Skills teach the process. The installed npm
+documentation owns exact signatures, import paths, units, lifecycle, and availability.
+
+Project instructions should ask the agent to discover the environment, look up relevant installed
+topics, check and run the current source, then inspect measurements and render useful views from
+that same run directory. Include the commands and required checks that belong to your project.
+When targeting another project directory, pass `--project PATH` consistently so discovery, lookup,
+checking, and execution resolve the same installation.
+
 ## Model entries
 
 A model entry default-exports an ordinary `ModelProgram`. It imports the real package; Studio's
@@ -164,10 +190,41 @@ Install Testkit separately when you want assertions and fixtures for your existi
 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.
+Use `createGeneratorTestRunner(definition, runtime)` for a Generator's persistent generation
+session. Its `execute` method returns a discriminated result: handle `type: "invalid"` before
+reading a generated `model`. Dispose each successful `model` when finished and dispose the runner
+separately; snapshots remain usable after the runner is disposed.
+Unexpected execution or malformed-output errors reject instead of returning an `invalid` result.
+For an ordinary `ModelProgram`, use an [engine session](https://metamesh.studio/docs/engine/hosting) and the same assertions
+against its completed snapshot.
+
+The runner normalizes saved values. To probe deliberately invalid typed inputs without that
+recovery, call `runner.validate(parameters, { normalize: false })`. Validation checks declarations
+and reached assertions without finalizing output; execute representative valid combinations too.
+The CLI's strict overrides serve a different purpose: they reject invalid or unknown values
+before execution instead of recovering saved state.
+
+| Helper                         | What to check                                                      |
+| ------------------------------ | ------------------------------------------------------------------ |
+| `expectSerializableDefinition` | Strict definition parsing and a canonical JSON round trip          |
+| `expectValidDefaults`          | Strict parameter decoding and agreement with defaults              |
+| `expectValidPresets`           | Serializable preset metadata; execute presets for domain rules     |
+| `expectValidParts`             | Part metadata, closed oriented topology, and native reconstruction |
+| `expectMeshMeasurements`       | Bounds, area, signed volume, and connected-component count         |
+
+Compare physical measurements with explicit absolute tolerances; bounds use millimetres, area
+square millimetres, and volume cubic millimetres. Component counts are exact. Rendered views
+complement those assertions. A valid solid alone does not prove a suitable fit or manufacturable
+wall thickness.
+
+For Font controls, supply the runner's `prepareServices` option using checked-in licensed bytes.
+`prepareFontTestServices` from `@metamesh/testkit/fonts` verifies immutable font revisions and
+prepares services without catalog downloads. Modeling's optional font peers are still required.
+Use installed documentation for the exact runner and fixture signatures:
+
+```bash
+pnpm exec metamesh docs show testkit/guide/testing
+```
 
 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

package/dist/docs/guides/package.md

@@ -8,7 +8,7 @@ Node-only `/authoring` functions use the production engine and version-matched i
 
 ## Installation
 
-Install matching releases in the project where you author models:
+Install the same exact release of each MetaMesh package in the project where you author models:
 
 ```bash
 pnpm add @metamesh/modeling
@@ -24,7 +24,7 @@ Chromium is installed separately and never downloaded by checking or generation.
 ## Local workflow
 
 ```bash
-pnpm exec metamesh environment
+pnpm exec metamesh environment --json
 pnpm exec metamesh docs search "extrude"
 pnpm exec metamesh docs show TOPIC_ID
 pnpm exec metamesh check model.ts --kind model
@@ -34,6 +34,12 @@ pnpm exec metamesh browser install
 pnpm exec metamesh render RUN_DIRECTORY --views isometric,front,top,right
 ```
 
+`environment` reports `authoringProtocolVersion: 1`, installed package versions, capabilities,
+and documentation manifest paths. Mixed package versions or stale documentation fail before
+generation. Commands resolve packages and relative paths from the current project; pass
+`--project PATH` to select another project explicitly. `TOPIC_ID` comes from documentation search;
+`RUN_DIRECTORY` comes from a successful run.
+
 `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
@@ -49,7 +55,10 @@ receive no injected services. Both support normal local imports and installed de
 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.
+`metamesh setup` prints installation guidance for `metamesh-developer` from the canonical
+`metamesh-studio/metamesh-skills` repository and a project-instruction suggestion without modifying
+files. Its printed GitHub installation command becomes usable when that repository is published;
+the skill supplies the workflow, while installed package documentation supplies exact API facts.
 
 ## Programmatic API and documentation
 
@@ -62,10 +71,16 @@ if (result.success) {
 }
 ```
 
-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.
+Resolve `@metamesh/cli/docs/manifest.json` for the installed Markdown reference, or run
+`pnpm exec metamesh docs show cli/guide/agent-authoring` for the complete authoring workflow.
+The [authoring guide source](https://github.com/JasonKoolman/metamesh/blob/main/apps/web/content/docs/develop/agent-authoring.mdx)
+also covers local font fixtures, artifacts, rendering, and agent integration. Until the public
+documentation site launches, use installed documentation, repository sources, or
+[run the docs locally](https://github.com/JasonKoolman/metamesh/blob/main/apps/web/README.md#local-use).
+
+The reusable authoring functions and command implementation stay in this package; geometry and
+Generator contracts retain their existing owners. Testing assertions and font-fixture adapters
+remain in Testkit.
 
 ## License
 

package/dist/docs/manifest.json

@@ -1,7 +1,7 @@
 {
   "formatVersion": 1,
   "packageName": "@metamesh/cli",
-  "packageVersion": "0.13.0",
+  "packageVersion": "0.14.0",
   "documents": [
     {
       "id": "cli/guide/agent-authoring",
@@ -35,7 +35,7 @@
     {
       "id": "cli/reference/authoring/AUTHORING_PROTOCOL_VERSION",
       "title": "AUTHORING_PROTOCOL_VERSION",
-      "summary": "AUTHORING_PROTOCOL_VERSION exported from @metamesh/cli/authoring.",
+      "summary": "Version of the CLI authoring protocol, independent of package SemVer and engine compatibility.",
       "path": "reference/authoring/AUTHORING_PROTOCOL_VERSION.md",
       "importPath": "@metamesh/cli/authoring",
       "availability": "Local Node authoring",
@@ -49,7 +49,7 @@
     {
       "id": "cli/reference/authoring/AuthoringDiagnostic",
       "title": "AuthoringDiagnostic",
-      "summary": "AuthoringDiagnostic exported from @metamesh/cli/authoring.",
+      "summary": "A structured issue with optional source location, parameter association, and geometry context.",
       "path": "reference/authoring/AuthoringDiagnostic.md",
       "importPath": "@metamesh/cli/authoring",
       "availability": "Local Node authoring",
@@ -63,7 +63,7 @@
     {
       "id": "cli/reference/authoring/AuthoringEnvironment",
       "title": "AuthoringEnvironment",
-      "summary": "AuthoringEnvironment exported from @metamesh/cli/authoring.",
+      "summary": "The selected project's supported protocol, matching package releases, and available workflows.",
       "path": "reference/authoring/AuthoringEnvironment.md",
       "importPath": "@metamesh/cli/authoring",
       "availability": "Local Node authoring",
@@ -77,7 +77,7 @@
     {
       "id": "cli/reference/authoring/AuthoringError",
       "title": "AuthoringError",
-      "summary": "AuthoringError exported from @metamesh/cli/authoring.",
+      "summary": "A classified authoring exception retaining its workflow phase, stable code, and exit status.",
       "path": "reference/authoring/AuthoringError.md",
       "importPath": "@metamesh/cli/authoring",
       "availability": "Local Node authoring",
@@ -91,7 +91,7 @@
     {
       "id": "cli/reference/authoring/authoringFailure",
       "title": "authoringFailure",
-      "summary": "authoringFailure exported from @metamesh/cli/authoring.",
+      "summary": "Converts a thrown value to a failure envelope, preserving classified authoring diagnostics.",
       "path": "reference/authoring/authoringFailure-value.md",
       "importPath": "@metamesh/cli/authoring",
       "availability": "Local Node authoring",
@@ -105,7 +105,7 @@
     {
       "id": "cli/reference/authoring/AuthoringFailure",
       "title": "AuthoringFailure",
-      "summary": "AuthoringFailure exported from @metamesh/cli/authoring.",
+      "summary": "An unsuccessful command outcome; a failure directory does not establish a complete capture.",
       "path": "reference/authoring/AuthoringFailure-type.md",
       "importPath": "@metamesh/cli/authoring",
       "availability": "Local Node authoring",
@@ -119,7 +119,7 @@
     {
       "id": "cli/reference/authoring/AuthoringKind",
       "title": "AuthoringKind",
-      "summary": "AuthoringKind exported from @metamesh/cli/authoring.",
+      "summary": "Selects a standalone ModelProgram entry or an SDK Generator module with a definition.",
       "path": "reference/authoring/AuthoringKind.md",
       "importPath": "@metamesh/cli/authoring",
       "availability": "Local Node authoring",
@@ -133,7 +133,7 @@
     {
       "id": "cli/reference/authoring/AuthoringPhase",
       "title": "AuthoringPhase",
-      "summary": "AuthoringPhase exported from @metamesh/cli/authoring.",
+      "summary": "The workflow stage that rejected an invocation, source, asset, or captured artifact.",
       "path": "reference/authoring/AuthoringPhase.md",
       "importPath": "@metamesh/cli/authoring",
       "availability": "Local Node authoring",
@@ -147,7 +147,7 @@
     {
       "id": "cli/reference/authoring/CapturedBuffer",
       "title": "CapturedBuffer",
-      "summary": "CapturedBuffer exported from @metamesh/cli/authoring.",
+      "summary": "A captured file's relative path, byte length, and SHA-256 integrity digest.",
       "path": "reference/authoring/CapturedBuffer.md",
       "importPath": "@metamesh/cli/authoring",
       "availability": "Local Node authoring",
@@ -161,7 +161,7 @@
     {
       "id": "cli/reference/authoring/CapturedGeometry",
       "title": "CapturedGeometry",
-      "summary": "CapturedGeometry exported from @metamesh/cli/authoring.",
+      "summary": "Validated local-space mesh buffers loaded from a completed captured resource.",
       "path": "reference/authoring/CapturedGeometry.md",
       "importPath": "@metamesh/cli/authoring",
       "availability": "Local Node authoring",
@@ -175,7 +175,7 @@
     {
       "id": "cli/reference/authoring/CapturedPart",
       "title": "CapturedPart",
-      "summary": "CapturedPart exported from @metamesh/cli/authoring.",
+      "summary": "Semantic part identity and appearance referencing a shared mesh with separate placement.",
       "path": "reference/authoring/CapturedPart.md",
       "importPath": "@metamesh/cli/authoring",
       "availability": "Local Node authoring",
@@ -189,7 +189,7 @@
     {
       "id": "cli/reference/authoring/CapturedResource",
       "title": "CapturedResource",
-      "summary": "CapturedResource exported from @metamesh/cli/authoring.",
+      "summary": "A shared local-space mesh resource and its measurements, before per-part placement.",
       "path": "reference/authoring/CapturedResource.md",
       "importPath": "@metamesh/cli/authoring",
       "availability": "Local Node authoring",
@@ -203,7 +203,7 @@
     {
       "id": "cli/reference/authoring/CapturedRun",
       "title": "CapturedRun",
-      "summary": "CapturedRun exported from @metamesh/cli/authoring.",
+      "summary": "A validated successful capture with its manifest and shared local geometry buffers.",
       "path": "reference/authoring/CapturedRun.md",
       "importPath": "@metamesh/cli/authoring",
       "availability": "Local Node authoring",
@@ -217,7 +217,7 @@
     {
       "id": "cli/reference/authoring/CapturedRunManifest",
       "title": "CapturedRunManifest",
-      "summary": "CapturedRunManifest exported from @metamesh/cli/authoring.",
+      "summary": "A completed attempt's provenance, effective inputs, diagnostics, and captured geometry.",
       "path": "reference/authoring/CapturedRunManifest.md",
       "importPath": "@metamesh/cli/authoring",
       "availability": "Local Node authoring",
@@ -231,7 +231,7 @@
     {
       "id": "cli/reference/authoring/checkAuthoringSource",
       "title": "checkAuthoringSource",
-      "summary": "checkAuthoringSource exported from @metamesh/cli/authoring.",
+      "summary": "Checks strict TypeScript and the selected entry-module contract without evaluating author source.",
       "path": "reference/authoring/checkAuthoringSource.md",
       "importPath": "@metamesh/cli/authoring",
       "availability": "Local Node authoring",
@@ -245,7 +245,7 @@
     {
       "id": "cli/reference/authoring/CheckOptions",
       "title": "CheckOptions",
-      "summary": "CheckOptions exported from @metamesh/cli/authoring.",
+      "summary": "Source entry contract and project-local resolution settings for semantic checking.",
       "path": "reference/authoring/CheckOptions.md",
       "importPath": "@metamesh/cli/authoring",
       "availability": "Local Node authoring",
@@ -259,7 +259,7 @@
     {
       "id": "cli/reference/authoring/CheckSuccess",
       "title": "CheckSuccess",
-      "summary": "CheckSuccess exported from @metamesh/cli/authoring.",
+      "summary": "A successful semantic check; source has not been evaluated and no geometry is captured.",
       "path": "reference/authoring/CheckSuccess.md",
       "importPath": "@metamesh/cli/authoring",
       "availability": "Local Node authoring",
@@ -273,7 +273,7 @@
     {
       "id": "cli/reference/authoring/discoverAuthoringEnvironment",
       "title": "discoverAuthoringEnvironment",
-      "summary": "discoverAuthoringEnvironment exported from @metamesh/cli/authoring.",
+      "summary": "Discovers project-local Modeling, CLI, and optional SDK/Testkit documentation. Rejects missing required packages, stale manifests, and mixed exact package versions.",
       "path": "reference/authoring/discoverAuthoringEnvironment.md",
       "importPath": "@metamesh/cli/authoring",
       "availability": "Local Node authoring",
@@ -287,7 +287,7 @@
     {
       "id": "cli/reference/authoring/DocumentationEntry",
       "title": "DocumentationEntry",
-      "summary": "DocumentationEntry exported from @metamesh/cli/authoring.",
+      "summary": "Metadata for one installed Markdown guide or public API symbol.",
       "path": "reference/authoring/DocumentationEntry.md",
       "importPath": "@metamesh/cli/authoring",
       "availability": "Local Node authoring",
@@ -301,7 +301,7 @@
     {
       "id": "cli/reference/authoring/DocumentationManifest",
       "title": "DocumentationManifest",
-      "summary": "DocumentationManifest exported from @metamesh/cli/authoring.",
+      "summary": "Exact-package-version index exposed through the package's docs/manifest.json export.",
       "path": "reference/authoring/DocumentationManifest.md",
       "importPath": "@metamesh/cli/authoring",
       "availability": "Local Node authoring",
@@ -315,7 +315,7 @@
     {
       "id": "cli/reference/authoring/DocumentationSearchResult",
       "title": "DocumentationSearchResult",
-      "summary": "DocumentationSearchResult exported from @metamesh/cli/authoring.",
+      "summary": "An installed documentation match carrying the exact package identity that owns it.",
       "path": "reference/authoring/DocumentationSearchResult.md",
       "importPath": "@metamesh/cli/authoring",
       "availability": "Local Node authoring",
@@ -329,7 +329,7 @@
     {
       "id": "cli/reference/authoring/inspectCapturedRun",
       "title": "inspectCapturedRun",
-      "summary": "inspectCapturedRun exported from @metamesh/cli/authoring.",
+      "summary": "Validates a completed capture and returns its manifest with an optional semantic part selection. Original source is never evaluated; incomplete captures and unknown part IDs reject.",
       "path": "reference/authoring/inspectCapturedRun.md",
       "importPath": "@metamesh/cli/authoring",
       "availability": "Local Node authoring",
@@ -357,7 +357,7 @@
     {
       "id": "cli/reference/authoring/InstalledAuthoringPackage",
       "title": "InstalledAuthoringPackage",
-      "summary": "InstalledAuthoringPackage exported from @metamesh/cli/authoring.",
+      "summary": "A project-local MetaMesh package and its verified documentation index.",
       "path": "reference/authoring/InstalledAuthoringPackage.md",
       "importPath": "@metamesh/cli/authoring",
       "availability": "Local Node authoring",
@@ -483,7 +483,7 @@
     {
       "id": "cli/reference/authoring/runAuthoringSource",
       "title": "runAuthoringSource",
-      "summary": "runAuthoringSource exported from @metamesh/cli/authoring.",
+      "summary": "Checks and executes trusted local source in a disposable child, then captures its finalized geometry. Returns a success or failure envelope for this fresh attempt; failed attempts cannot be rendered.",
       "path": "reference/authoring/runAuthoringSource.md",
       "importPath": "@metamesh/cli/authoring",
       "availability": "Local Node authoring",
@@ -497,7 +497,7 @@
     {
       "id": "cli/reference/authoring/RunOptions",
       "title": "RunOptions",
-      "summary": "RunOptions exported from @metamesh/cli/authoring.",
+      "summary": "Inputs and bounded execution policy for one checked, trusted local source attempt.",
       "path": "reference/authoring/RunOptions.md",
       "importPath": "@metamesh/cli/authoring",
       "availability": "Local Node authoring",
@@ -511,7 +511,7 @@
     {
       "id": "cli/reference/authoring/RunSuccess",
       "title": "RunSuccess",
-      "summary": "RunSuccess exported from @metamesh/cli/authoring.",
+      "summary": "A successful checked execution; use this exact directory for subsequent inspection and rendering.",
       "path": "reference/authoring/RunSuccess.md",
       "importPath": "@metamesh/cli/authoring",
       "availability": "Local Node authoring",
@@ -525,7 +525,7 @@
     {
       "id": "cli/reference/authoring/searchAuthoringDocumentation",
       "title": "searchAuthoringDocumentation",
-      "summary": "searchAuthoringDocumentation exported from @metamesh/cli/authoring.",
+      "summary": "Ranks installed topic and symbol metadata without loading every document's body. Returns up to limit matches, defaulting to 10; supported limits are 1 through 50.",
       "path": "reference/authoring/searchAuthoringDocumentation.md",
       "importPath": "@metamesh/cli/authoring",
       "availability": "Local Node authoring",
@@ -539,7 +539,7 @@
     {
       "id": "cli/reference/authoring/showAuthoringDocumentation",
       "title": "showAuthoringDocumentation",
-      "summary": "showAuthoringDocumentation exported from @metamesh/cli/authoring.",
+      "summary": "Reads one exact-version installed Markdown topic by its discovered ID, without executing source.",
       "path": "reference/authoring/showAuthoringDocumentation.md",
       "importPath": "@metamesh/cli/authoring",
       "availability": "Local Node authoring",

package/dist/docs/reference/authoring/AUTHORING_PROTOCOL_VERSION.md

@@ -1,8 +1,8 @@
 # AUTHORING_PROTOCOL_VERSION
 
-AUTHORING_PROTOCOL_VERSION exported from @metamesh/cli/authoring.
+Version of the CLI authoring protocol, independent of package SemVer and engine compatibility.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
 
 ```ts
 AUTHORING_PROTOCOL_VERSION = 1