@metamesh/cli 0.13.0 → 0.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (69) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/README.md +22 -7
  3. package/dist/authoring/artifacts.d.ts +4 -0
  4. package/dist/authoring/artifacts.d.ts.map +1 -1
  5. package/dist/authoring/artifacts.js +4 -0
  6. package/dist/authoring/artifacts.js.map +1 -1
  7. package/dist/authoring/check.d.ts +1 -0
  8. package/dist/authoring/check.d.ts.map +1 -1
  9. package/dist/authoring/check.js +1 -0
  10. package/dist/authoring/check.js.map +1 -1
  11. package/dist/authoring/environment.d.ts +10 -0
  12. package/dist/authoring/environment.d.ts.map +1 -1
  13. package/dist/authoring/environment.js +9 -0
  14. package/dist/authoring/environment.js.map +1 -1
  15. package/dist/authoring/errors.d.ts +2 -0
  16. package/dist/authoring/errors.d.ts.map +1 -1
  17. package/dist/authoring/errors.js +2 -0
  18. package/dist/authoring/errors.js.map +1 -1
  19. package/dist/authoring/render.js +2 -2
  20. package/dist/authoring/render.js.map +1 -1
  21. package/dist/authoring/run.d.ts +4 -0
  22. package/dist/authoring/run.d.ts.map +1 -1
  23. package/dist/authoring/run.js +4 -0
  24. package/dist/authoring/run.js.map +1 -1
  25. package/dist/authoring/types.d.ts +40 -3
  26. package/dist/authoring/types.d.ts.map +1 -1
  27. package/dist/authoring/types.js +1 -0
  28. package/dist/authoring/types.js.map +1 -1
  29. package/dist/docs/guides/agent-authoring.md +64 -7
  30. package/dist/docs/guides/package.md +22 -7
  31. package/dist/docs/manifest.json +29 -29
  32. package/dist/docs/reference/authoring/AUTHORING_PROTOCOL_VERSION.md +2 -2
  33. package/dist/docs/reference/authoring/AuthoringDiagnostic.md +5 -2
  34. package/dist/docs/reference/authoring/AuthoringEnvironment.md +3 -2
  35. package/dist/docs/reference/authoring/AuthoringError.md +3 -2
  36. package/dist/docs/reference/authoring/AuthoringFailure-type.md +5 -2
  37. package/dist/docs/reference/authoring/AuthoringKind.md +3 -2
  38. package/dist/docs/reference/authoring/AuthoringPhase.md +3 -2
  39. package/dist/docs/reference/authoring/CapturedBuffer.md +3 -2
  40. package/dist/docs/reference/authoring/CapturedGeometry.md +3 -2
  41. package/dist/docs/reference/authoring/CapturedPart.md +7 -4
  42. package/dist/docs/reference/authoring/CapturedResource.md +3 -2
  43. package/dist/docs/reference/authoring/CapturedRun.md +3 -2
  44. package/dist/docs/reference/authoring/CapturedRunManifest.md +4 -2
  45. package/dist/docs/reference/authoring/CheckOptions.md +6 -2
  46. package/dist/docs/reference/authoring/CheckSuccess.md +3 -2
  47. package/dist/docs/reference/authoring/DocumentationEntry.md +4 -2
  48. package/dist/docs/reference/authoring/DocumentationManifest.md +3 -2
  49. package/dist/docs/reference/authoring/DocumentationSearchResult.md +3 -2
  50. package/dist/docs/reference/authoring/InstalledAuthoringPackage.md +3 -2
  51. package/dist/docs/reference/authoring/RenderCamera.md +1 -1
  52. package/dist/docs/reference/authoring/RenderFormat.md +1 -1
  53. package/dist/docs/reference/authoring/RenderOptions.md +1 -1
  54. package/dist/docs/reference/authoring/RenderResult.md +1 -1
  55. package/dist/docs/reference/authoring/RenderView.md +1 -1
  56. package/dist/docs/reference/authoring/RenderedImage.md +1 -1
  57. package/dist/docs/reference/authoring/RunOptions.md +10 -2
  58. package/dist/docs/reference/authoring/RunSuccess.md +3 -2
  59. package/dist/docs/reference/authoring/authoringFailure-value.md +3 -2
  60. package/dist/docs/reference/authoring/checkAuthoringSource.md +3 -2
  61. package/dist/docs/reference/authoring/discoverAuthoringEnvironment.md +6 -2
  62. package/dist/docs/reference/authoring/inspectCapturedRun.md +6 -2
  63. package/dist/docs/reference/authoring/installAuthoringBrowser.md +1 -1
  64. package/dist/docs/reference/authoring/readCapturedRun.md +1 -1
  65. package/dist/docs/reference/authoring/renderCapturedRun.md +1 -1
  66. package/dist/docs/reference/authoring/runAuthoringSource.md +6 -2
  67. package/dist/docs/reference/authoring/searchAuthoringDocumentation.md +6 -2
  68. package/dist/docs/reference/authoring/showAuthoringDocumentation.md +3 -2
  69. package/package.json +6 -6
@@ -1,16 +1,19 @@
1
1
  # AuthoringDiagnostic
2
2
 
3
- AuthoringDiagnostic exported from @metamesh/cli/authoring.
3
+ A structured issue with optional source location, parameter association, and geometry context.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
+ /** A structured issue with optional source location, parameter association, and geometry context. */
8
9
  export interface AuthoringDiagnostic {
9
10
  readonly code: string;
10
11
  readonly message: string;
11
12
  readonly severity: "error" | "warning";
12
13
  readonly file?: string;
14
+ /** One-based source line, when available. */
13
15
  readonly line?: number;
16
+ /** One-based source column, when available. */
14
17
  readonly column?: number;
15
18
  readonly parameterId?: string;
16
19
  readonly path?: readonly (number | string)[];
@@ -1,10 +1,11 @@
1
1
  # AuthoringEnvironment
2
2
 
3
- AuthoringEnvironment exported from @metamesh/cli/authoring.
3
+ The selected project's supported protocol, matching package releases, and available workflows.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
+ /** The selected project's supported protocol, matching package releases, and available workflows. */
8
9
  export interface AuthoringEnvironment {
9
10
  readonly authoringProtocolVersion: typeof AUTHORING_PROTOCOL_VERSION;
10
11
  readonly project: string;
@@ -1,10 +1,11 @@
1
1
  # AuthoringError
2
2
 
3
- AuthoringError exported from @metamesh/cli/authoring.
3
+ A classified authoring exception retaining its workflow phase, stable code, and exit status.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
+ /** A classified authoring exception retaining its workflow phase, stable code, and exit status. */
8
9
  export declare class AuthoringError extends Error {
9
10
  readonly phase: AuthoringPhase;
10
11
  readonly code: string;
@@ -1,15 +1,18 @@
1
1
  # AuthoringFailure
2
2
 
3
- AuthoringFailure exported from @metamesh/cli/authoring.
3
+ An unsuccessful command outcome; a failure directory does not establish a complete capture.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
+ /** An unsuccessful command outcome; a failure directory does not establish a complete capture. */
8
9
  export interface AuthoringFailure {
9
10
  readonly success: false;
10
11
  readonly phase: AuthoringPhase;
12
+ /** 1 for source or generation failures; 2 for invocation, environment, artifact, or tooling failures. */
11
13
  readonly exitCode: 1 | 2;
12
14
  readonly diagnostics: readonly AuthoringDiagnostic[];
15
+ /** This attempt's directory, when created; read its failure metadata instead of inspecting geometry. */
13
16
  readonly runDirectory?: string;
14
17
  }
15
18
  ```
@@ -1,9 +1,10 @@
1
1
  # AuthoringKind
2
2
 
3
- AuthoringKind exported from @metamesh/cli/authoring.
3
+ Selects a standalone ModelProgram entry or an SDK Generator module with a definition.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
+ /** Selects a standalone ModelProgram entry or an SDK Generator module with a definition. */
8
9
  export type AuthoringKind = "model" | "generator";
9
10
  ```
@@ -1,9 +1,10 @@
1
1
  # AuthoringPhase
2
2
 
3
- AuthoringPhase exported from @metamesh/cli/authoring.
3
+ The workflow stage that rejected an invocation, source, asset, or captured artifact.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
+ /** The workflow stage that rejected an invocation, source, asset, or captured artifact. */
8
9
  export type AuthoringPhase = "invocation" | "environment" | "check" | "parameters" | "assets" | "bundle" | "execute" | "artifact" | "render";
9
10
  ```
@@ -1,10 +1,11 @@
1
1
  # CapturedBuffer
2
2
 
3
- CapturedBuffer exported from @metamesh/cli/authoring.
3
+ A captured file's relative path, byte length, and SHA-256 integrity digest.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
+ /** A captured file's relative path, byte length, and SHA-256 integrity digest. */
8
9
  export interface CapturedBuffer {
9
10
  readonly path: string;
10
11
  readonly bytes: number;
@@ -1,10 +1,11 @@
1
1
  # CapturedGeometry
2
2
 
3
- CapturedGeometry exported from @metamesh/cli/authoring.
3
+ Validated local-space mesh buffers loaded from a completed captured resource.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
+ /** Validated local-space mesh buffers loaded from a completed captured resource. */
8
9
  export interface CapturedGeometry {
9
10
  readonly id: string;
10
11
  readonly positions: Float32Array;
@@ -1,15 +1,18 @@
1
1
  # CapturedPart
2
2
 
3
- CapturedPart exported from @metamesh/cli/authoring.
3
+ Semantic part identity and appearance referencing a shared mesh with separate placement.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
+ /** Semantic part identity and appearance referencing a shared mesh with separate placement. */
8
9
  export interface CapturedPart {
9
10
  readonly id: string;
10
11
  readonly resourceId: string;
11
- readonly position: Vector3;
12
- readonly rotation: Vector3;
12
+ /** World translation in millimetres, applied after rotation. */
13
+ readonly position: Vector3Tuple;
14
+ /** Global XYZ rotation in degrees, applied once to local geometry. */
15
+ readonly rotation: Vector3Tuple;
13
16
  readonly color?: string;
14
17
  readonly measurements: SnapshotPart["measurements"];
15
18
  }
@@ -1,10 +1,11 @@
1
1
  # CapturedResource
2
2
 
3
- CapturedResource exported from @metamesh/cli/authoring.
3
+ A shared local-space mesh resource and its measurements, before per-part placement.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
+ /** A shared local-space mesh resource and its measurements, before per-part placement. */
8
9
  export interface CapturedResource {
9
10
  readonly id: string;
10
11
  readonly positions: CapturedBuffer;
@@ -1,10 +1,11 @@
1
1
  # CapturedRun
2
2
 
3
- CapturedRun exported from @metamesh/cli/authoring.
3
+ A validated successful capture with its manifest and shared local geometry buffers.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
+ /** A validated successful capture with its manifest and shared local geometry buffers. */
8
9
  export interface CapturedRun {
9
10
  readonly directory: string;
10
11
  readonly manifest: CapturedRunManifest;
@@ -1,16 +1,18 @@
1
1
  # CapturedRunManifest
2
2
 
3
- CapturedRunManifest exported from @metamesh/cli/authoring.
3
+ A completed attempt's provenance, effective inputs, diagnostics, and captured geometry.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
+ /** A completed attempt's provenance, effective inputs, diagnostics, and captured geometry. */
8
9
  export interface CapturedRunManifest {
9
10
  readonly formatVersion: 1;
10
11
  readonly status: "complete";
11
12
  readonly runId: string;
12
13
  readonly createdAt: string;
13
14
  readonly kind: AuthoringKind;
15
+ /** Project-relative entry and fingerprint of bundled local source files. */
14
16
  readonly source: {
15
17
  readonly entry: string;
16
18
  readonly fingerprint: string;
@@ -1,14 +1,18 @@
1
1
  # CheckOptions
2
2
 
3
- CheckOptions exported from @metamesh/cli/authoring.
3
+ Source entry contract and project-local resolution settings for semantic checking.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
+ /** Source entry contract and project-local resolution settings for semantic checking. */
8
9
  export interface CheckOptions {
10
+ /** Entry path, resolved from project. */
9
11
  readonly entry: string;
10
12
  readonly kind: AuthoringKind;
13
+ /** Package and path resolution root; defaults to the current working directory. */
11
14
  readonly project?: string;
15
+ /** Explicit configuration path relative to project; otherwise the entry's nearest tsconfig is used. */
12
16
  readonly tsconfig?: string;
13
17
  }
14
18
  ```
@@ -1,10 +1,11 @@
1
1
  # CheckSuccess
2
2
 
3
- CheckSuccess exported from @metamesh/cli/authoring.
3
+ A successful semantic check; source has not been evaluated and no geometry is captured.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
+ /** A successful semantic check; source has not been evaluated and no geometry is captured. */
8
9
  export interface CheckSuccess {
9
10
  readonly success: true;
10
11
  readonly entry: string;
@@ -1,14 +1,16 @@
1
1
  # DocumentationEntry
2
2
 
3
- DocumentationEntry exported from @metamesh/cli/authoring.
3
+ Metadata for one installed Markdown guide or public API symbol.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
+ /** Metadata for one installed Markdown guide or public API symbol. */
8
9
  export interface DocumentationEntry {
9
10
  readonly id: string;
10
11
  readonly title: string;
11
12
  readonly summary: string;
13
+ /** Forward-slash relative path beside the owning documentation manifest. */
12
14
  readonly path: string;
13
15
  readonly importPath: string;
14
16
  readonly availability: string;
@@ -1,10 +1,11 @@
1
1
  # DocumentationManifest
2
2
 
3
- DocumentationManifest exported from @metamesh/cli/authoring.
3
+ Exact-package-version index exposed through the package's docs/manifest.json export.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
+ /** Exact-package-version index exposed through the package's docs/manifest.json export. */
8
9
  export interface DocumentationManifest {
9
10
  readonly formatVersion: 1;
10
11
  readonly packageName: string;
@@ -1,10 +1,11 @@
1
1
  # DocumentationSearchResult
2
2
 
3
- DocumentationSearchResult exported from @metamesh/cli/authoring.
3
+ An installed documentation match carrying the exact package identity that owns it.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
+ /** An installed documentation match carrying the exact package identity that owns it. */
8
9
  export interface DocumentationSearchResult extends DocumentationEntry {
9
10
  readonly packageName: string;
10
11
  readonly packageVersion: string;
@@ -1,10 +1,11 @@
1
1
  # InstalledAuthoringPackage
2
2
 
3
- InstalledAuthoringPackage exported from @metamesh/cli/authoring.
3
+ A project-local MetaMesh package and its verified documentation index.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
+ /** A project-local MetaMesh package and its verified documentation index. */
8
9
  export interface InstalledAuthoringPackage {
9
10
  readonly name: string;
10
11
  readonly version: string;
@@ -2,7 +2,7 @@
2
2
 
3
3
  Recorded orthographic camera, expressed in millimetres and world coordinates.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
8
  /** Recorded orthographic camera, expressed in millimetres and world coordinates. */
@@ -2,7 +2,7 @@
2
2
 
3
3
  Image encodings; WebP is always lossless.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
8
  /** Image encodings; WebP is always lossless. */
@@ -2,7 +2,7 @@
2
2
 
3
3
  Options for rendering a previously captured model, without executing author code.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
8
  /** Options for rendering a previously captured model, without executing author code. */
@@ -2,7 +2,7 @@
2
2
 
3
3
  Images always belong to one captured run and one unique output directory.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
8
  /** Images always belong to one captured run and one unique output directory. */
@@ -2,7 +2,7 @@
2
2
 
3
3
  Standard orthographic views in MetaMesh's Z-up coordinate system.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
8
  /** Standard orthographic views in MetaMesh's Z-up coordinate system. */
@@ -2,7 +2,7 @@
2
2
 
3
3
  A view and its provenance, also written beside the image as JSON.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
8
  /** A view and its provenance, also written beside the image as JSON. */
@@ -1,17 +1,25 @@
1
1
  # RunOptions
2
2
 
3
- RunOptions exported from @metamesh/cli/authoring.
3
+ Inputs and bounded execution policy for one checked, trusted local source attempt.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
+ /** Inputs and bounded execution policy for one checked, trusted local source attempt. */
8
9
  export interface RunOptions extends CheckOptions {
10
+ /** Generator overrides merged with definition defaults, or the standalone model's raw parameter map. */
9
11
  readonly params?: Readonly<Record<string, unknown>>;
12
+ /** Local font descriptor JSON path relative to project; no assets are downloaded. */
10
13
  readonly fontFixtures?: string;
14
+ /** Parent for a unique attempt directory; defaults to .metamesh/runs beneath project. */
11
15
  readonly output?: string;
16
+ /** Child execution deadline in milliseconds, from 1 to 3600000; defaults to 30000. */
12
17
  readonly timeoutMs?: number;
18
+ /** Engine resource ceilings may be lowered from their defaults, never raised. */
13
19
  readonly limits?: Partial<ModelingLimits>;
20
+ /** Export the completed snapshot as 3MF in this run; defaults to false. */
14
21
  readonly export3mf?: boolean;
22
+ /** Receives combined child stdout/stderr, truncated after 64 KiB. */
15
23
  readonly onLog?: (text: string) => void;
16
24
  }
17
25
  ```
@@ -1,10 +1,11 @@
1
1
  # RunSuccess
2
2
 
3
- RunSuccess exported from @metamesh/cli/authoring.
3
+ A successful checked execution; use this exact directory for subsequent inspection and rendering.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
+ /** A successful checked execution; use this exact directory for subsequent inspection and rendering. */
8
9
  export interface RunSuccess {
9
10
  readonly success: true;
10
11
  readonly runDirectory: string;
@@ -1,9 +1,10 @@
1
1
  # authoringFailure
2
2
 
3
- authoringFailure exported from @metamesh/cli/authoring.
3
+ Converts a thrown value to a failure envelope, preserving classified authoring diagnostics.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
+ /** Converts a thrown value to a failure envelope, preserving classified authoring diagnostics. */
8
9
  export declare function authoringFailure(error: unknown, fallbackPhase?: AuthoringPhase): AuthoringFailure;
9
10
  ```
@@ -1,9 +1,10 @@
1
1
  # checkAuthoringSource
2
2
 
3
- checkAuthoringSource exported from @metamesh/cli/authoring.
3
+ Checks strict TypeScript and the selected entry-module contract without evaluating author source.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
+ /** Checks strict TypeScript and the selected entry-module contract without evaluating author source. */
8
9
  export declare function checkAuthoringSource(options: CheckOptions): Promise<CheckSuccess | AuthoringFailure>;
9
10
  ```
@@ -1,9 +1,13 @@
1
1
  # discoverAuthoringEnvironment
2
2
 
3
- discoverAuthoringEnvironment exported from @metamesh/cli/authoring.
3
+ Discovers project-local Modeling, CLI, and optional SDK/Testkit documentation. Rejects missing required packages, stale manifests, and mixed exact package versions.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
+ /**
9
+ * Discovers project-local Modeling, CLI, and optional SDK/Testkit documentation.
10
+ * Rejects missing required packages, stale manifests, and mixed exact package versions.
11
+ */
8
12
  export declare function discoverAuthoringEnvironment(project?: string): Promise<AuthoringEnvironment>;
9
13
  ```
@@ -1,10 +1,14 @@
1
1
  # inspectCapturedRun
2
2
 
3
- inspectCapturedRun exported from @metamesh/cli/authoring.
3
+ 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.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
+ /**
9
+ * Validates a completed capture and returns its manifest with an optional semantic part selection.
10
+ * Original source is never evaluated; incomplete captures and unknown part IDs reject.
11
+ */
8
12
  export declare function inspectCapturedRun(directory: string, partId?: string): Promise<Omit<CapturedRun, "resources"> & {
9
13
  readonly selectedPart?: CapturedPart;
10
14
  }>;
@@ -2,7 +2,7 @@
2
2
 
3
3
  Explicit installation of this package's pinned Chromium. Never called by render.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
8
  /** Explicit installation of this package's pinned Chromium. Never called by render. */
@@ -2,7 +2,7 @@
2
2
 
3
3
  Reads only immutable captured files. It never imports or executes original author source.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
8
  /** Reads only immutable captured files. It never imports or executes original author source. */
@@ -2,7 +2,7 @@
2
2
 
3
3
  Render validated persisted local geometry and placements. Source code is never imported, and a fresh capture directory prevents overlapping calls from overwriting evidence.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
8
  /**
@@ -1,9 +1,13 @@
1
1
  # runAuthoringSource
2
2
 
3
- runAuthoringSource exported from @metamesh/cli/authoring.
3
+ 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.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
+ /**
9
+ * Checks and executes trusted local source in a disposable child, then captures its finalized geometry.
10
+ * Returns a success or failure envelope for this fresh attempt; failed attempts cannot be rendered.
11
+ */
8
12
  export declare function runAuthoringSource(options: RunOptions): Promise<RunSuccess | AuthoringFailure>;
9
13
  ```
@@ -1,10 +1,14 @@
1
1
  # searchAuthoringDocumentation
2
2
 
3
- searchAuthoringDocumentation exported from @metamesh/cli/authoring.
3
+ 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.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
+ /**
9
+ * Ranks installed topic and symbol metadata without loading every document's body.
10
+ * Returns up to limit matches, defaulting to 10; supported limits are 1 through 50.
11
+ */
8
12
  export declare function searchAuthoringDocumentation(query: string, options?: {
9
13
  readonly project?: string;
10
14
  readonly limit?: number;
@@ -1,10 +1,11 @@
1
1
  # showAuthoringDocumentation
2
2
 
3
- showAuthoringDocumentation exported from @metamesh/cli/authoring.
3
+ Reads one exact-version installed Markdown topic by its discovered ID, without executing source.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.13.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
6
6
 
7
7
  ```ts
8
+ /** Reads one exact-version installed Markdown topic by its discovered ID, without executing source. */
8
9
  export declare function showAuthoringDocumentation(id: string, project?: string): Promise<DocumentationSearchResult & {
9
10
  readonly markdown: string;
10
11
  }>;
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@metamesh/cli",
3
3
  "description": "Local MetaMesh authoring CLI and reusable Node tools for checking, captured generation, inspection, and rendering.",
4
- "version": "0.13.0",
4
+ "version": "0.14.0",
5
5
  "license": "Apache-2.0",
6
6
  "repository": {
7
7
  "type": "git",
@@ -33,7 +33,7 @@
33
33
  "./docs/manifest.json": "./dist/docs/manifest.json"
34
34
  },
35
35
  "dependencies": {
36
- "@metamesh/testkit": "0.13.0",
36
+ "@metamesh/testkit": "0.14.0",
37
37
  "commander": "15.0.0",
38
38
  "esbuild": "^0.28.2",
39
39
  "playwright": "1.64.1",
@@ -41,8 +41,8 @@
41
41
  "typescript": "6.0.3"
42
42
  },
43
43
  "peerDependencies": {
44
- "@metamesh/generator-sdk": "0.13.0",
45
- "@metamesh/modeling": "0.13.0"
44
+ "@metamesh/generator-sdk": "0.14.0",
45
+ "@metamesh/modeling": "0.14.0"
46
46
  },
47
47
  "peerDependenciesMeta": {
48
48
  "@metamesh/generator-sdk": {
@@ -51,8 +51,8 @@
51
51
  },
52
52
  "devDependencies": {
53
53
  "@metamesh/config": "0.0.0",
54
- "@metamesh/generator-sdk": "0.13.0",
55
- "@metamesh/modeling": "0.13.0",
54
+ "@metamesh/generator-sdk": "0.14.0",
55
+ "@metamesh/modeling": "0.14.0",
56
56
  "vitest": "^5.0.5",
57
57
  "@types/node": "^24.19.2",
58
58
  "@types/three": "0.186.0"