@metamesh/cli 0.0.0-stage → 0.14.0

package/dist/docs/manifest.json

@@ -0,0 +1,554 @@
+{
+  "formatVersion": 1,
+  "packageName": "@metamesh/cli",
+  "packageVersion": "0.14.0",
+  "documents": [
+    {
+      "id": "cli/guide/agent-authoring",
+      "title": "Author and inspect models with an agent",
+      "summary": "Find installed documentation, check TypeScript, generate a captured model, and inspect its measurements and rendered views locally.",
+      "path": "guides/agent-authoring.md",
+      "importPath": "@metamesh/cli/authoring",
+      "availability": "Local Node authoring",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring",
+      "keywords": [
+        "guide",
+        "agent-authoring",
+        "engine",
+        "how-to"
+      ]
+    },
+    {
+      "id": "cli/guide/authoring",
+      "title": "Check, run, and inspect local models",
+      "summary": "Local MetaMesh authoring CLI and reusable Node tools for checking, captured generation, inspection, and rendering.",
+      "path": "guides/package.md",
+      "importPath": "@metamesh/cli/authoring",
+      "availability": "Local Node authoring",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "guide",
+        "installation",
+        "cli"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/AUTHORING_PROTOCOL_VERSION",
+      "title": "AUTHORING_PROTOCOL_VERSION",
+      "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",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "AUTHORING_PROTOCOL_VERSION"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/AuthoringDiagnostic",
+      "title": "AuthoringDiagnostic",
+      "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",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "AuthoringDiagnostic"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/AuthoringEnvironment",
+      "title": "AuthoringEnvironment",
+      "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",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "AuthoringEnvironment"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/AuthoringError",
+      "title": "AuthoringError",
+      "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",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "AuthoringError"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/authoringFailure",
+      "title": "authoringFailure",
+      "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",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "authoringFailure"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/AuthoringFailure",
+      "title": "AuthoringFailure",
+      "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",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "AuthoringFailure"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/AuthoringKind",
+      "title": "AuthoringKind",
+      "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",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "AuthoringKind"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/AuthoringPhase",
+      "title": "AuthoringPhase",
+      "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",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "AuthoringPhase"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/CapturedBuffer",
+      "title": "CapturedBuffer",
+      "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",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "CapturedBuffer"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/CapturedGeometry",
+      "title": "CapturedGeometry",
+      "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",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "CapturedGeometry"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/CapturedPart",
+      "title": "CapturedPart",
+      "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",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "CapturedPart"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/CapturedResource",
+      "title": "CapturedResource",
+      "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",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "CapturedResource"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/CapturedRun",
+      "title": "CapturedRun",
+      "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",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "CapturedRun"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/CapturedRunManifest",
+      "title": "CapturedRunManifest",
+      "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",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "CapturedRunManifest"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/checkAuthoringSource",
+      "title": "checkAuthoringSource",
+      "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",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "checkAuthoringSource"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/CheckOptions",
+      "title": "CheckOptions",
+      "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",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "CheckOptions"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/CheckSuccess",
+      "title": "CheckSuccess",
+      "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",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "CheckSuccess"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/discoverAuthoringEnvironment",
+      "title": "discoverAuthoringEnvironment",
+      "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",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "discoverAuthoringEnvironment"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/DocumentationEntry",
+      "title": "DocumentationEntry",
+      "summary": "Metadata for one installed Markdown guide or public API symbol.",
+      "path": "reference/authoring/DocumentationEntry.md",
+      "importPath": "@metamesh/cli/authoring",
+      "availability": "Local Node authoring",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "DocumentationEntry"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/DocumentationManifest",
+      "title": "DocumentationManifest",
+      "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",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "DocumentationManifest"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/DocumentationSearchResult",
+      "title": "DocumentationSearchResult",
+      "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",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "DocumentationSearchResult"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/inspectCapturedRun",
+      "title": "inspectCapturedRun",
+      "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",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "inspectCapturedRun"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/installAuthoringBrowser",
+      "title": "installAuthoringBrowser",
+      "summary": "Explicit installation of this package's pinned Chromium. Never called by render.",
+      "path": "reference/authoring/installAuthoringBrowser.md",
+      "importPath": "@metamesh/cli/authoring",
+      "availability": "Local Node authoring",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "installAuthoringBrowser"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/InstalledAuthoringPackage",
+      "title": "InstalledAuthoringPackage",
+      "summary": "A project-local MetaMesh package and its verified documentation index.",
+      "path": "reference/authoring/InstalledAuthoringPackage.md",
+      "importPath": "@metamesh/cli/authoring",
+      "availability": "Local Node authoring",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "InstalledAuthoringPackage"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/readCapturedRun",
+      "title": "readCapturedRun",
+      "summary": "Reads only immutable captured files. It never imports or executes original author source.",
+      "path": "reference/authoring/readCapturedRun.md",
+      "importPath": "@metamesh/cli/authoring",
+      "availability": "Local Node authoring",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "readCapturedRun"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/RenderCamera",
+      "title": "RenderCamera",
+      "summary": "Recorded orthographic camera, expressed in millimetres and world coordinates.",
+      "path": "reference/authoring/RenderCamera.md",
+      "importPath": "@metamesh/cli/authoring",
+      "availability": "Local Node authoring",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "RenderCamera"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/renderCapturedRun",
+      "title": "renderCapturedRun",
+      "summary": "Render validated persisted local geometry and placements. Source code is never imported, and a fresh capture directory prevents overlapping calls from overwriting evidence.",
+      "path": "reference/authoring/renderCapturedRun.md",
+      "importPath": "@metamesh/cli/authoring",
+      "availability": "Local Node authoring",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "renderCapturedRun"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/RenderedImage",
+      "title": "RenderedImage",
+      "summary": "A view and its provenance, also written beside the image as JSON.",
+      "path": "reference/authoring/RenderedImage.md",
+      "importPath": "@metamesh/cli/authoring",
+      "availability": "Local Node authoring",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "RenderedImage"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/RenderFormat",
+      "title": "RenderFormat",
+      "summary": "Image encodings; WebP is always lossless.",
+      "path": "reference/authoring/RenderFormat.md",
+      "importPath": "@metamesh/cli/authoring",
+      "availability": "Local Node authoring",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "RenderFormat"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/RenderOptions",
+      "title": "RenderOptions",
+      "summary": "Options for rendering a previously captured model, without executing author code.",
+      "path": "reference/authoring/RenderOptions.md",
+      "importPath": "@metamesh/cli/authoring",
+      "availability": "Local Node authoring",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "RenderOptions"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/RenderResult",
+      "title": "RenderResult",
+      "summary": "Images always belong to one captured run and one unique output directory.",
+      "path": "reference/authoring/RenderResult.md",
+      "importPath": "@metamesh/cli/authoring",
+      "availability": "Local Node authoring",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "RenderResult"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/RenderView",
+      "title": "RenderView",
+      "summary": "Standard orthographic views in MetaMesh's Z-up coordinate system.",
+      "path": "reference/authoring/RenderView.md",
+      "importPath": "@metamesh/cli/authoring",
+      "availability": "Local Node authoring",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "RenderView"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/runAuthoringSource",
+      "title": "runAuthoringSource",
+      "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",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "runAuthoringSource"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/RunOptions",
+      "title": "RunOptions",
+      "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",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "RunOptions"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/RunSuccess",
+      "title": "RunSuccess",
+      "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",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "RunSuccess"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/searchAuthoringDocumentation",
+      "title": "searchAuthoringDocumentation",
+      "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",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "searchAuthoringDocumentation"
+      ]
+    },
+    {
+      "id": "cli/reference/authoring/showAuthoringDocumentation",
+      "title": "showAuthoringDocumentation",
+      "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",
+      "canonical": "https://metamesh.studio/docs/develop/agent-authoring#install-and-discover-the-environment",
+      "keywords": [
+        "reference",
+        "authoring",
+        "showAuthoringDocumentation"
+      ]
+    }
+  ]
+}

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

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

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

@@ -0,0 +1,22 @@
+# AuthoringDiagnostic
+
+A structured issue with optional source location, parameter association, and geometry context.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/** 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>>;
+}
+```

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

@@ -0,0 +1,15 @@
+# AuthoringEnvironment
+
+The selected project's supported protocol, matching package releases, and available workflows.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/** 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[];
+}
+```

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

@@ -0,0 +1,16 @@
+# AuthoringError
+
+A classified authoring exception retaining its workflow phase, stable code, and exit status.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/** A classified authoring exception retaining its workflow phase, stable code, and exit status. */
+export declare class AuthoringError extends Error {
+    readonly phase: AuthoringPhase;
+    readonly code: string;
+    readonly exitCode: 1 | 2;
+    readonly diagnostics?: readonly AuthoringDiagnostic[] | undefined;
+    constructor(phase: AuthoringPhase, code: string, message: string, exitCode?: 1 | 2, diagnostics?: readonly AuthoringDiagnostic[] | undefined);
+}
+```

package/dist/docs/reference/authoring/AuthoringFailure-type.md

@@ -0,0 +1,18 @@
+# AuthoringFailure
+
+An unsuccessful command outcome; a failure directory does not establish a complete capture.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/** 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;
+}
+```

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

@@ -0,0 +1,10 @@
+# AuthoringKind
+
+Selects a standalone ModelProgram entry or an SDK Generator module with a definition.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/** Selects a standalone ModelProgram entry or an SDK Generator module with a definition. */
+export type AuthoringKind = "model" | "generator";
+```

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

@@ -0,0 +1,10 @@
+# AuthoringPhase
+
+The workflow stage that rejected an invocation, source, asset, or captured artifact.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/** The workflow stage that rejected an invocation, source, asset, or captured artifact. */
+export type AuthoringPhase = "invocation" | "environment" | "check" | "parameters" | "assets" | "bundle" | "execute" | "artifact" | "render";
+```