@metamesh/cli 0.14.0 → 0.16.0

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

@@ -1,11 +1,10 @@
 # Author and inspect models with an agent
 
-Find installed documentation, check TypeScript, generate a captured model, and inspect its measurements and rendered views locally.
+Use the CLI to find installed docs, check TypeScript, capture a model, and inspect measurements and rendered views.
 
-The `metamesh` CLI gives coding agents and developers the same local workflow: look up the
-installed API, check source, execute the real engine, and inspect a captured result. It runs trusted
-local TypeScript with your ordinary Node permissions. The child process is disposable; it is not a
-security sandbox.
+Use the `metamesh` CLI to look up the installed API, check TypeScript, generate a model, and inspect
+the captured result. It runs trusted local source with your ordinary Node permissions. Its
+disposable child process is not a security sandbox.
 
 ## Install and discover the environment
 
@@ -24,45 +23,52 @@ using the commands. Missing packages, mismatched releases, or an unsupported pro
 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.
+automated tests.
+Ordinary models need only Modeling and the CLI as 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                   |
+| `@metamesh/testkit`       | Generation runners, fixtures, and assertions for your 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:
 
 ```bash
+pnpm exec metamesh docs show modeling/guide/standalone-model
 pnpm exec metamesh docs search "cylinder"
 pnpm exec metamesh docs show modeling/reference/model/cylinder
 ```
 
+The [standalone model example](https://metamesh.studio/docs/develop/standalone-model) is a short starting point.
+Use the [construction map](https://metamesh.studio/docs/develop/geometry-package#choose-a-modeling-path) to choose an
+approach, or search for a shape or symbol and read its recipe or reference. Search matches distinct
+words in titles, headings, keywords, and summaries. Exact titles, IDs, and imports take priority;
+equally complete intent matches favor guides.
+
 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`.
+`setup` prints skill installation guidance and a project-instruction snippet for review without
+modifying files, installing skills, or initializing a model. The optional `metamesh-developer` skill
+covers authoring and verification; `metamesh-docs` covers documentation. Both are maintained 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.
+Project instructions should require environment discovery, relevant documentation lookup, source
+checking and execution, then measurement inspection and useful rendered views from that same run.
+Include your project’s commands and required checks. Pass `--project PATH` consistently when
+targeting another directory so every step resolves the same installation.
 
 ## Model entries
 
@@ -167,10 +173,10 @@ pnpm exec metamesh render RUN_DIRECTORY
 pnpm exec metamesh render RUN_DIRECTORY --views top --format webp --transparent
 ```
 
-Inspection reads finalized geometry facts, including semantic part IDs, placements, colors,
-measurements, diagnostics, and execution provenance. Rendering reads the same captured buffers
-without executing the model again. Artifacts remain usable after the engine session is disposed or
-the run directory is moved. Corrupt or incomplete artifacts reject.
+Inspection reads finalized part IDs, placements, colors, measurements, diagnostics, and execution
+provenance. Rendering uses the same captured buffers without rerunning the model. Captures remain
+usable after the engine session is disposed or the directory moves. Corrupt or incomplete
+artifacts reject.
 
 Rendering requires the separately installed pinned Chromium. It is never downloaded implicitly;
 checking, generation, and inspection work without it. Standard orthographic views are isometric,
@@ -232,9 +238,13 @@ spawning the command.
 
 ## Command results
 
-The CLI defaults to concise human output. Add `--json` for one structured stdout result, with
-bounded author logs on stderr. Exit status is `0` for success, `1` for source, parameter, or
-generation failure, and `2` for invocation, environment, artifact, or tooling failure. Runs have a
-30-second default execution deadline and can lower engine resource ceilings.
+Add `--json` for one structured result on stdout; bounded author logs go to stderr. The default
+output is concise text. Exit codes are:
+
+- `0`: success;
+- `1`: source, parameter, or generation failure;
+- `2`: invocation, environment, artifact, or tooling failure.
+
+Runs default to a 30-second execution deadline and can lower engine resource ceilings.
 
 Modeling and the Generator SDK remain independent of the CLI and its local Node tooling.

package/dist/docs/guides/package.md

@@ -25,6 +25,7 @@ Chromium is installed separately and never downloaded by checking or generation.
 
 ```bash
 pnpm exec metamesh environment --json
+pnpm exec metamesh docs show modeling/guide/concepts
 pnpm exec metamesh docs search "extrude"
 pnpm exec metamesh docs show TOPIC_ID
 pnpm exec metamesh check model.ts --kind model
@@ -40,6 +41,10 @@ generation. Commands resolve packages and relative paths from the current projec
 `--project PATH` to select another project explicitly. `TOPIC_ID` comes from documentation search;
 `RUN_DIRECTORY` comes from a successful run.
 
+The concepts guide starts with a compact construction map. Search matches distinct words in
+titles, guide headings, keywords, and summaries. Exact titles, topic IDs, and import paths take
+priority; equally complete intent matches favor guides over reference entries.
+
 `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

package/dist/docs/manifest.json

@@ -1,12 +1,12 @@
 {
   "formatVersion": 1,
   "packageName": "@metamesh/cli",
-  "packageVersion": "0.14.0",
+  "packageVersion": "0.16.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.",
+      "summary": "Use the CLI to find installed docs, check TypeScript, capture a model, and inspect measurements and rendered views.",
       "path": "guides/agent-authoring.md",
       "importPath": "@metamesh/cli/authoring",
       "availability": "Local Node authoring",
@@ -15,7 +15,15 @@
         "guide",
         "agent-authoring",
         "engine",
-        "how-to"
+        "how-to",
+        "author-and-inspect-models-with-an-agent",
+        "install-and-discover-the-environment",
+        "give-an-agent-the-same-workflow",
+        "model-entries",
+        "generator-entries",
+        "inspect-the-captured-result",
+        "test-models",
+        "command-results"
       ]
     },
     {
@@ -525,7 +533,7 @@
     {
       "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.",
+      "summary": "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.",
       "path": "reference/authoring/searchAuthoringDocumentation.md",
       "importPath": "@metamesh/cli/authoring",
       "availability": "Local Node authoring",

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

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

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

@@ -2,7 +2,7 @@
 
 A structured issue with optional source location, parameter association, and geometry context.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /** A structured issue with optional source location, parameter association, and geometry context. */

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

@@ -2,7 +2,7 @@
 
 The selected project's supported protocol, matching package releases, and available workflows.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /** The selected project's supported protocol, matching package releases, and available workflows. */

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

@@ -2,7 +2,7 @@
 
 A classified authoring exception retaining its workflow phase, stable code, and exit status.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /** A classified authoring exception retaining its workflow phase, stable code, and exit status. */

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

@@ -2,7 +2,7 @@
 
 An unsuccessful command outcome; a failure directory does not establish a complete capture.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /** An unsuccessful command outcome; a failure directory does not establish a complete capture. */

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

@@ -2,7 +2,7 @@
 
 Selects a standalone ModelProgram entry or an SDK Generator module with a definition.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /** Selects a standalone ModelProgram entry or an SDK Generator module with a definition. */

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

@@ -2,7 +2,7 @@
 
 The workflow stage that rejected an invocation, source, asset, or captured artifact.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /** The workflow stage that rejected an invocation, source, asset, or captured artifact. */

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

@@ -2,7 +2,7 @@
 
 A captured file's relative path, byte length, and SHA-256 integrity digest.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /** A captured file's relative path, byte length, and SHA-256 integrity digest. */

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

@@ -2,7 +2,7 @@
 
 Validated local-space mesh buffers loaded from a completed captured resource.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /** Validated local-space mesh buffers loaded from a completed captured resource. */

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

@@ -2,7 +2,7 @@
 
 Semantic part identity and appearance referencing a shared mesh with separate placement.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /** Semantic part identity and appearance referencing a shared mesh with separate placement. */
@@ -10,9 +10,9 @@ export interface CapturedPart {
     readonly id: string;
     readonly resourceId: string;
     /** World translation in millimetres, applied after rotation. */
-    readonly position: Vector3Tuple;
+    readonly position: Vector3Data;
     /** Global XYZ rotation in degrees, applied once to local geometry. */
-    readonly rotation: Vector3Tuple;
+    readonly rotation: Vector3Data;
     readonly color?: string;
     readonly measurements: SnapshotPart["measurements"];
 }

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

@@ -2,7 +2,7 @@
 
 A shared local-space mesh resource and its measurements, before per-part placement.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /** A shared local-space mesh resource and its measurements, before per-part placement. */

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

@@ -2,7 +2,7 @@
 
 A validated successful capture with its manifest and shared local geometry buffers.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /** A validated successful capture with its manifest and shared local geometry buffers. */

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

@@ -2,7 +2,7 @@
 
 A completed attempt's provenance, effective inputs, diagnostics, and captured geometry.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /** A completed attempt's provenance, effective inputs, diagnostics, and captured geometry. */
@@ -30,7 +30,7 @@ export interface CapturedRunManifest {
         readonly limits: ModelingLimits;
     };
     readonly diagnostics: readonly GenerationDiagnostic[];
-    readonly bounds: Bounds3;
+    readonly bounds: Bounds3Data;
     readonly stats: FinalizedModel["stats"];
     readonly dependencies: ModelDependencies;
     readonly resources: readonly CapturedResource[];

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

@@ -2,7 +2,7 @@
 
 Source entry contract and project-local resolution settings for semantic checking.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /** Source entry contract and project-local resolution settings for semantic checking. */

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

@@ -2,7 +2,7 @@
 
 A successful semantic check; source has not been evaluated and no geometry is captured.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /** A successful semantic check; source has not been evaluated and no geometry is captured. */

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

@@ -2,7 +2,7 @@
 
 Metadata for one installed Markdown guide or public API symbol.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /** Metadata for one installed Markdown guide or public API symbol. */

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

@@ -2,7 +2,7 @@
 
 Exact-package-version index exposed through the package's docs/manifest.json export.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /** Exact-package-version index exposed through the package's docs/manifest.json export. */

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

@@ -2,7 +2,7 @@
 
 An installed documentation match carrying the exact package identity that owns it.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /** An installed documentation match carrying the exact package identity that owns it. */

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

@@ -2,7 +2,7 @@
 
 A project-local MetaMesh package and its verified documentation index.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /** A project-local MetaMesh package and its verified documentation index. */

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

@@ -2,7 +2,7 @@
 
 Recorded orthographic camera, expressed in millimetres and world coordinates.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /** Recorded orthographic camera, expressed in millimetres and world coordinates. */

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

@@ -2,7 +2,7 @@
 
 Image encodings; WebP is always lossless.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /** Image encodings; WebP is always lossless. */

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

@@ -2,7 +2,7 @@
 
 Options for rendering a previously captured model, without executing author code.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /** Options for rendering a previously captured model, without executing author code. */

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

@@ -2,7 +2,7 @@
 
 Images always belong to one captured run and one unique output directory.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /** Images always belong to one captured run and one unique output directory. */

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

@@ -2,7 +2,7 @@
 
 Standard orthographic views in MetaMesh's Z-up coordinate system.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /** Standard orthographic views in MetaMesh's Z-up coordinate system. */

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

@@ -2,7 +2,7 @@
 
 A view and its provenance, also written beside the image as JSON.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /** A view and its provenance, also written beside the image as JSON. */

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

@@ -2,7 +2,7 @@
 
 Inputs and bounded execution policy for one checked, trusted local source attempt.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /** Inputs and bounded execution policy for one checked, trusted local source attempt. */

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

@@ -2,7 +2,7 @@
 
 A successful checked execution; use this exact directory for subsequent inspection and rendering.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /** A successful checked execution; use this exact directory for subsequent inspection and rendering. */

package/dist/docs/reference/authoring/authoringFailure-value.md

@@ -2,7 +2,7 @@
 
 Converts a thrown value to a failure envelope, preserving classified authoring diagnostics.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /** Converts a thrown value to a failure envelope, preserving classified authoring diagnostics. */

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

@@ -2,7 +2,7 @@
 
 Checks strict TypeScript and the selected entry-module contract without evaluating author source.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /** Checks strict TypeScript and the selected entry-module contract without evaluating author source. */

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

@@ -2,7 +2,7 @@
 
 Discovers project-local Modeling, CLI, and optional SDK/Testkit documentation. Rejects missing required packages, stale manifests, and mixed exact package versions.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /**

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

@@ -2,7 +2,7 @@
 
 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.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /**

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

@@ -2,7 +2,7 @@
 
 Explicit installation of this package's pinned Chromium. Never called by render.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /** Explicit installation of this package's pinned Chromium. Never called by render. */

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

@@ -2,7 +2,7 @@
 
 Reads only immutable captured files. It never imports or executes original author source.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /** Reads only immutable captured files. It never imports or executes original author source. */

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

@@ -2,7 +2,7 @@
 
 Render validated persisted local geometry and placements. Source code is never imported, and a fresh capture directory prevents overlapping calls from overwriting evidence.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /**

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

@@ -2,7 +2,7 @@
 
 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.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /**

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

@@ -1,12 +1,13 @@
 # searchAuthoringDocumentation
 
-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.
+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.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /**
- * Ranks installed topic and symbol metadata without loading every document's body.
+ * 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.
  */
 export declare function searchAuthoringDocumentation(query: string, options?: {

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

@@ -2,7 +2,7 @@
 
 Reads one exact-version installed Markdown topic by its discovered ID, without executing source.
 
-Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.16.0).
 
 ```ts
 /** Reads one exact-version installed Markdown topic by its discovered ID, without executing source. */

package/dist/metamesh.js

@@ -31,9 +31,15 @@ async function readObject(project, file) {
         throw new AuthoringError("invocation", "INVALID_JSON_INPUT", "Parameter and limit files must contain JSON objects.");
     return value;
 }
+function humanDiagnostic(issue) {
+    const location = [issue.file, issue.line, issue.column]
+        .filter((value) => value !== undefined)
+        .join(":");
+    return `${location === "" ? "" : `${location}: `}${issue.severity} ${issue.code}: ${issue.message}`;
+}
 function humanResult(command, result) {
     if (isRecord(result) && result.success === false && Array.isArray(result.diagnostics))
-        return `${result.diagnostics.map((issue) => `${issue.code}: ${issue.message}`).join("\n")}${typeof result.runDirectory === "string" ? `\nAttempt: ${result.runDirectory}` : ""}\n`;
+        return `${result.diagnostics.map(humanDiagnostic).join("\n")}${typeof result.runDirectory === "string" ? `\nAttempt: ${result.runDirectory}` : ""}\n`;
     if (command === "environment") {
         const environment = result;
         return `MetaMesh authoring protocol ${environment.authoringProtocolVersion}\nProject: ${environment.project}\n${environment.packages.map((pkg) => `${pkg.name} ${pkg.version} (${pkg.documentCount} topics)\n  ${pkg.manifestPath}`).join("\n")}\n`;
@@ -48,7 +54,7 @@ function humanResult(command, result) {
         isRecord(result) &&
         isRecord(result.manifest)) {
         const manifest = result.manifest;
-        return `${manifest.parts.length} parts; ${manifest.stats.vertices} vertices; ${manifest.stats.triangles} triangles; ${manifest.stats.volumeMm3.toFixed(3)} mm³\nCaptured: ${String(result.runDirectory ?? result.directory)}\n${manifest.diagnostics.map(({ severity, message }) => `${severity}: ${message}\n`).join("")}${isRecord(result.selectedPart) ? `Part: ${JSON.stringify(result.selectedPart)}\n` : ""}`;
+        return `${manifest.stats.partCount} parts; ${manifest.stats.vertexCount} vertices; ${manifest.stats.triangleCount} triangles; ${manifest.stats.volumeMm3.toFixed(3)} mm³\nCaptured: ${String(result.runDirectory ?? result.directory)}\n${manifest.diagnostics.map(({ severity, message }) => `${severity}: ${message}\n`).join("")}${isRecord(result.selectedPart) ? `Part: ${JSON.stringify(result.selectedPart)}\n` : ""}`;
     }
     return `${JSON.stringify(result, null, 2)}\n`;
 }
@@ -176,7 +182,7 @@ async function main() {
         if (json)
             process.stdout.write(`${JSON.stringify(failure)}\n`);
         else
-            process.stderr.write(`${failure.diagnostics.map(({ code, message }) => `${code}: ${message}`).join("\n")}\n`);
+            process.stderr.write(`${failure.diagnostics.map(humanDiagnostic).join("\n")}\n`);
     }
 }
 await main();