@metamesh/cli 0.19.0 → 0.20.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 (59) hide show
  1. package/CHANGELOG.md +24 -0
  2. package/README.md +6 -4
  3. package/dist/authoring/artifacts.d.ts.map +1 -1
  4. package/dist/authoring/artifacts.js +2 -1
  5. package/dist/authoring/artifacts.js.map +1 -1
  6. package/dist/authoring/render/client-bundle.js +172 -172
  7. package/dist/authoring/render/client-bundle.js.map +4 -4
  8. package/dist/authoring/render/scene.d.ts.map +1 -1
  9. package/dist/authoring/render/scene.js +2 -1
  10. package/dist/authoring/render/scene.js.map +1 -1
  11. package/dist/authoring/types.d.ts +2 -1
  12. package/dist/authoring/types.d.ts.map +1 -1
  13. package/dist/authoring/types.js.map +1 -1
  14. package/dist/docs/guides/agent-authoring.md +45 -245
  15. package/dist/docs/guides/local-authoring.md +216 -0
  16. package/dist/docs/guides/package.md +6 -4
  17. package/dist/docs/manifest.json +74 -56
  18. package/dist/docs/reference/authoring/AUTHORING_PROTOCOL_VERSION.md +1 -1
  19. package/dist/docs/reference/authoring/AuthoringDiagnostic.md +1 -1
  20. package/dist/docs/reference/authoring/AuthoringEnvironment.md +1 -1
  21. package/dist/docs/reference/authoring/AuthoringError.md +1 -1
  22. package/dist/docs/reference/authoring/AuthoringFailure-type.md +1 -1
  23. package/dist/docs/reference/authoring/AuthoringKind.md +1 -1
  24. package/dist/docs/reference/authoring/AuthoringPhase.md +1 -1
  25. package/dist/docs/reference/authoring/CaptureExportFormat.md +1 -1
  26. package/dist/docs/reference/authoring/CaptureExportOptions.md +1 -1
  27. package/dist/docs/reference/authoring/CaptureExportResult.md +1 -1
  28. package/dist/docs/reference/authoring/CapturedBuffer.md +1 -1
  29. package/dist/docs/reference/authoring/CapturedGeometry.md +1 -1
  30. package/dist/docs/reference/authoring/CapturedPart.md +1 -1
  31. package/dist/docs/reference/authoring/CapturedResource.md +1 -1
  32. package/dist/docs/reference/authoring/CapturedRun.md +1 -1
  33. package/dist/docs/reference/authoring/CapturedRunManifest.md +1 -1
  34. package/dist/docs/reference/authoring/CheckOptions.md +1 -1
  35. package/dist/docs/reference/authoring/CheckSuccess.md +1 -1
  36. package/dist/docs/reference/authoring/DocumentationEntry.md +1 -1
  37. package/dist/docs/reference/authoring/DocumentationManifest.md +1 -1
  38. package/dist/docs/reference/authoring/DocumentationSearchResult.md +1 -1
  39. package/dist/docs/reference/authoring/InstalledAuthoringPackage.md +1 -1
  40. package/dist/docs/reference/authoring/RenderCamera.md +1 -1
  41. package/dist/docs/reference/authoring/RenderFormat.md +1 -1
  42. package/dist/docs/reference/authoring/RenderOptions.md +1 -1
  43. package/dist/docs/reference/authoring/RenderResult.md +1 -1
  44. package/dist/docs/reference/authoring/RenderView.md +1 -1
  45. package/dist/docs/reference/authoring/RenderedImage.md +1 -1
  46. package/dist/docs/reference/authoring/RunOptions.md +1 -1
  47. package/dist/docs/reference/authoring/RunSuccess.md +1 -1
  48. package/dist/docs/reference/authoring/authoringFailure-value.md +1 -1
  49. package/dist/docs/reference/authoring/checkAuthoringSource.md +1 -1
  50. package/dist/docs/reference/authoring/discoverAuthoringEnvironment.md +1 -1
  51. package/dist/docs/reference/authoring/exportCapturedRun.md +1 -1
  52. package/dist/docs/reference/authoring/inspectCapturedRun.md +1 -1
  53. package/dist/docs/reference/authoring/installAuthoringBrowser.md +1 -1
  54. package/dist/docs/reference/authoring/readCapturedRun.md +1 -1
  55. package/dist/docs/reference/authoring/renderCapturedRun.md +1 -1
  56. package/dist/docs/reference/authoring/runAuthoringSource.md +1 -1
  57. package/dist/docs/reference/authoring/searchAuthoringDocumentation.md +1 -1
  58. package/dist/docs/reference/authoring/showAuthoringDocumentation.md +1 -1
  59. package/package.json +6 -6
@@ -2,7 +2,7 @@
2
2
 
3
3
  Metadata for one installed Markdown guide or public API symbol.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.19.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.20.0).
6
6
 
7
7
  ```ts
8
8
  /** Metadata for one installed Markdown guide or public API symbol. */
@@ -2,7 +2,7 @@
2
2
 
3
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.19.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.20.0).
6
6
 
7
7
  ```ts
8
8
  /** Exact-package-version index exposed through the package's docs/manifest.json export. */
@@ -2,7 +2,7 @@
2
2
 
3
3
  An installed documentation match carrying the exact package identity that owns it.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.19.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.20.0).
6
6
 
7
7
  ```ts
8
8
  /** An installed documentation match carrying the exact package identity that owns it. */
@@ -2,7 +2,7 @@
2
2
 
3
3
  A project-local MetaMesh package and its verified documentation index.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.19.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.20.0).
6
6
 
7
7
  ```ts
8
8
  /** A project-local MetaMesh package and its verified documentation index. */
@@ -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.19.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.20.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.19.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.20.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.19.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.20.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.19.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.20.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.19.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.20.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.19.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.20.0).
6
6
 
7
7
  ```ts
8
8
  /** A view and its provenance, also written beside the image as JSON. */
@@ -2,7 +2,7 @@
2
2
 
3
3
  Inputs and bounded execution policy for one checked, trusted local source attempt.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.19.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.20.0).
6
6
 
7
7
  ```ts
8
8
  /** Inputs and bounded execution policy for one checked, trusted local source attempt. */
@@ -2,7 +2,7 @@
2
2
 
3
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.19.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.20.0).
6
6
 
7
7
  ```ts
8
8
  /** A successful checked execution; use this exact directory for subsequent inspection and rendering. */
@@ -2,7 +2,7 @@
2
2
 
3
3
  Converts a thrown value to a failure envelope, preserving classified authoring diagnostics.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.19.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.20.0).
6
6
 
7
7
  ```ts
8
8
  /** Converts a thrown value to a failure envelope, preserving classified authoring diagnostics. */
@@ -2,7 +2,7 @@
2
2
 
3
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.19.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.20.0).
6
6
 
7
7
  ```ts
8
8
  /** Checks strict TypeScript and the selected entry-module contract without evaluating author source. */
@@ -2,7 +2,7 @@
2
2
 
3
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.19.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.20.0).
6
6
 
7
7
  ```ts
8
8
  /**
@@ -2,7 +2,7 @@
2
2
 
3
3
  Streams a captured model to an atomically published file using the public mesh writers.
4
4
 
5
- Import from `@metamesh/cli/authoring` (@metamesh/cli@0.19.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.20.0).
6
6
 
7
7
  ```ts
8
8
  /** Streams a captured model to an atomically published file using the public mesh writers. */
@@ -2,7 +2,7 @@
2
2
 
3
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.19.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.20.0).
6
6
 
7
7
  ```ts
8
8
  /**
@@ -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.19.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.20.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.19.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.20.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.19.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.20.0).
6
6
 
7
7
  ```ts
8
8
  /**
@@ -2,7 +2,7 @@
2
2
 
3
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.19.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.20.0).
6
6
 
7
7
  ```ts
8
8
  /**
@@ -2,7 +2,7 @@
2
2
 
3
3
  Ranks distinct intent tokens in installed titles, keywords, and summaries without loading bodies. Exact symbol/topic/import lookup takes priority; equally complete matches favor guides. 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.19.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.20.0).
6
6
 
7
7
  ```ts
8
8
  /**
@@ -2,7 +2,7 @@
2
2
 
3
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.19.0).
5
+ Import from `@metamesh/cli/authoring` (@metamesh/cli@0.20.0).
6
6
 
7
7
  ```ts
8
8
  /** Reads one exact-version installed Markdown topic by its discovered ID, without executing source. */
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.19.0",
4
+ "version": "0.20.0",
5
5
  "license": "Apache-2.0",
6
6
  "repository": {
7
7
  "type": "git",
@@ -36,7 +36,7 @@
36
36
  "./docs/manifest.json": "./dist/docs/manifest.json"
37
37
  },
38
38
  "dependencies": {
39
- "@metamesh/testkit": "0.19.0",
39
+ "@metamesh/testkit": "0.20.0",
40
40
  "commander": "15.0.0",
41
41
  "esbuild": "^0.28.2",
42
42
  "playwright": "1.64.1",
@@ -44,8 +44,8 @@
44
44
  "typescript": "6.0.3"
45
45
  },
46
46
  "peerDependencies": {
47
- "@metamesh/generator-sdk": "0.19.0",
48
- "@metamesh/modeling": "0.19.0"
47
+ "@metamesh/generator-sdk": "0.20.0",
48
+ "@metamesh/modeling": "0.20.0"
49
49
  },
50
50
  "peerDependenciesMeta": {
51
51
  "@metamesh/generator-sdk": {
@@ -54,8 +54,8 @@
54
54
  },
55
55
  "devDependencies": {
56
56
  "@metamesh/config": "0.0.0",
57
- "@metamesh/generator-sdk": "0.19.0",
58
- "@metamesh/modeling": "0.19.0",
57
+ "@metamesh/generator-sdk": "0.20.0",
58
+ "@metamesh/modeling": "0.20.0",
59
59
  "vitest": "^5.0.5",
60
60
  "@types/node": "^24.19.2",
61
61
  "@types/three": "0.186.0"