forgecad 0.9.13 → 0.9.14

package/dist-cli/forgecad.js

@@ -4,6 +4,7 @@ import {
   CLI_DEFAULT_BACKEND,
   COMPILER_REGRESSION_CORPUS,
   FILLET_EDGE_WORKFLOW_CODE,
+  MathUtils,
   OCCTUnsupportedError,
   Rectangle2D,
   Sculpt,
@@ -11,6 +12,7 @@ import {
   Shape,
   ShapeGroup,
   Transform,
+  Vector3,
   activateBackend,
   addPolygon,
   addRect,
@@ -119,7 +121,7 @@ import {
   union2d,
   updateConstraintValue,
   wrapOCCTShapeBackend
-} from "./chunk-RY43WF46.js";
+} from "./chunk-EXWGNL6K.js";
 
 // cli/forgecad.ts
 import { Command, Flags, Help, flush as flushOclif, handle as handleOclif, run as runOclif } from "@oclif/core";
@@ -7141,7 +7143,7 @@ var RENDER_STYLES = new Set(RENDER_STYLE_NAMES);
 var RENDER_STYLE_LABEL = RENDER_STYLE_NAMES.join("|");
 var SCAN_GRANULARITY_MIN = 12;
 var SCAN_GRANULARITY_DEFAULT = 32;
-var SCAN_GRANULARITY_MAX = 72;
+var SCAN_GRANULARITY_MAX = 144;
 var COMPARISON_VIEW_MODES = /* @__PURE__ */ new Set(["difference-only"]);
 function evidenceNameForChannel(channel) {
   return INSPECT_EVIDENCE_BY_CHANNEL.get(channel)?.name ?? channel;
@@ -19106,6 +19108,281 @@ async function runGcodeExportCli(argv) {
   console.log(`  Bounds: [${tp.bounds.min.map((v) => v.toFixed(1)).join(", ")}] \u2192 [${tp.bounds.max.map((v) => v.toFixed(1)).join(", ")}]`);
 }
 
+// src/forge/targets.ts
+var cleanSceneTargetPathSegments = (segments) => (segments ?? []).map((segment) => segment.trim()).filter((segment) => segment.length > 0);
+function getSceneObjectTreePath(object) {
+  const explicitTreePath = cleanSceneTargetPathSegments(object.treePath);
+  if (explicitTreePath.length > 0) return explicitTreePath;
+  const name = object.name.trim() || object.id;
+  const groupName = object.groupName?.trim();
+  if (!groupName) return [name];
+  const groupPath = groupName.split(".").map((segment) => segment.trim()).filter((segment) => segment.length > 0);
+  const prefixedLeaf = `${groupName}.`;
+  if (name.startsWith(prefixedLeaf)) {
+    const leafName = name.slice(prefixedLeaf.length).trim();
+    return [...groupPath, leafName || name];
+  }
+  return [...groupPath, name];
+}
+function getSceneObjectKind(object) {
+  if (object.mock) return "mock";
+  if (object.sketch) return "sketch";
+  if (object.toolpath) return "toolpath";
+  if (object.sdf) return "sdf";
+  if (object.shape) return "shape";
+  return "object";
+}
+function buildSceneTargetEntries(objects) {
+  return objects.map((object) => {
+    const pathSegments = getSceneObjectTreePath(object);
+    return {
+      id: object.id,
+      name: object.name,
+      kind: getSceneObjectKind(object),
+      pathSegments,
+      path: pathSegments.join("/"),
+      dottedPath: pathSegments.join("."),
+      group: object.groupName?.trim() || void 0,
+      tags: object.tags ?? [],
+      mock: object.mock === true,
+      object
+    };
+  });
+}
+function formatSceneTargetPath(entry) {
+  return entry.path || entry.name;
+}
+function resolveSceneTargets(entries, selector) {
+  const needle = normalizeTargetText(selector);
+  if (!needle) throw new Error("Target selector must not be empty.");
+  const hasGlob = /[*?]/.test(selector);
+  if (hasGlob) {
+    const pattern = globToRegExp(needle);
+    const matches = entries.filter((entry) => targetCandidateTexts(entry).some((candidate) => pattern.test(candidate)));
+    if (matches.length > 0) return matches;
+    throw targetNotFound(selector, entries);
+  }
+  const idMatches = entries.filter((entry) => normalizeTargetText(entry.id) === needle);
+  if (idMatches.length > 0) return idMatches;
+  const exactPathMatches = entries.filter(
+    (entry) => normalizeTargetText(entry.path) === needle || normalizeTargetText(entry.dottedPath) === needle
+  );
+  if (exactPathMatches.length > 0) return exactPathMatches;
+  const groupMatches = entries.filter((entry) => {
+    const groupPath = entry.pathSegments.slice(0, -1);
+    return normalizeTargetText(groupPath.join("/")) === needle || normalizeTargetText(groupPath.join(".")) === needle;
+  });
+  if (groupMatches.length > 0) return groupMatches;
+  const nameMatches2 = entries.filter(
+    (entry) => normalizeTargetText(entry.name) === needle || normalizeTargetText(entry.pathSegments[entry.pathSegments.length - 1] ?? "") === needle
+  );
+  if (nameMatches2.length === 1) return nameMatches2;
+  if (nameMatches2.length > 1) throw ambiguousTarget(selector, nameMatches2);
+  throw targetNotFound(selector, entries);
+}
+function suggestSceneTargets(selector, entries, limit = 8) {
+  const needle = normalizeTargetText(selector);
+  if (!needle) return entries.slice(0, limit);
+  return entries.map((entry) => ({ entry, score: scoreTarget(entry, needle) })).filter((ranked) => ranked.score > 0).sort((a, b) => b.score - a.score || a.entry.path.localeCompare(b.entry.path)).slice(0, limit).map((ranked) => ranked.entry);
+}
+function targetCandidateTexts(entry) {
+  return [
+    entry.id,
+    entry.name,
+    entry.path,
+    entry.dottedPath,
+    entry.group ?? "",
+    entry.pathSegments[entry.pathSegments.length - 1] ?? ""
+  ].map(normalizeTargetText);
+}
+function normalizeTargetText(value) {
+  return value.trim().replace(/\\/g, "/").replace(/\s*\/\s*/g, "/").replace(/\s*\.\s*/g, ".").toLowerCase();
+}
+function globToRegExp(value) {
+  const escaped = value.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*").replace(/\?/g, ".");
+  return new RegExp(`^${escaped}$`, "i");
+}
+function scoreTarget(entry, needle) {
+  const candidates = targetCandidateTexts(entry);
+  if (candidates.some((candidate) => candidate === needle)) return 100;
+  if (candidates.some((candidate) => candidate.startsWith(needle))) return 60;
+  if (candidates.some((candidate) => candidate.includes(needle))) return 30;
+  const tokens = needle.split(/[\s/._-]+/).filter(Boolean);
+  if (tokens.length > 0 && tokens.every((token) => candidates.some((candidate) => candidate.includes(token)))) return 15;
+  return 0;
+}
+function targetSummary(entry) {
+  return `${formatSceneTargetPath(entry)} (${entry.kind}, ${entry.id})`;
+}
+function targetNotFound(selector, entries) {
+  const suggestions = suggestSceneTargets(selector, entries);
+  const detail = suggestions.length > 0 ? `
+Did you mean:
+${suggestions.map((entry) => `  ${targetSummary(entry)}`).join("\n")}` : "";
+  return new Error(`Target "${selector}" matched no scene objects.${detail}`);
+}
+function ambiguousTarget(selector, matches) {
+  return new Error(
+    `Target "${selector}" is ambiguous.
+Use a full path:
+${matches.map((entry) => `  ${targetSummary(entry)}`).join("\n")}`
+  );
+}
+
+// cli/forge-ls.ts
+var TARGET_KINDS = ["shape", "sketch", "sdf", "toolpath", "mock", "object"];
+function usage12() {
+  return [
+    "Usage: forgecad ls <model.forge.js|asset.stl|asset.obj|asset.3mf|asset.step|asset.stp> [target] [--tree] [--long] [--json] [--kind shape,sketch,mock] [--param Key=Value] [--backend manifold|occt|truck] [--quality live|default|high]"
+  ].join("\n");
+}
+function parseKindFilter(raw) {
+  const values = raw.split(",").map((value) => value.trim()).filter(Boolean);
+  const kinds = /* @__PURE__ */ new Set();
+  for (const value of values) {
+    if (!TARGET_KINDS.includes(value)) {
+      throw new Error(`Invalid --kind value: ${value}. Expected one of ${TARGET_KINDS.join(", ")}.`);
+    }
+    kinds.add(value);
+  }
+  if (kinds.size === 0) throw new Error("--kind requires at least one kind.");
+  return kinds;
+}
+function parseLsOptions(argv) {
+  if (argv.length === 0 || argv.includes("-h") || argv.includes("--help")) {
+    console.log(usage12());
+    process.exit(0);
+  }
+  const { overrides: _paramOverrides, consumed: paramConsumed } = parseParamFlags(argv);
+  const { backend, consumed: backendConsumed } = parseBackendArg(argv);
+  const { quality, consumed: qualityConsumed } = parseQualityArg(argv);
+  const consumed = /* @__PURE__ */ new Set([...paramConsumed, ...backendConsumed, ...qualityConsumed]);
+  let json = false;
+  let compact = false;
+  let tree = false;
+  let long = false;
+  let kinds = null;
+  for (let i = 0; i < argv.length; i += 1) {
+    if (consumed.has(i)) continue;
+    const arg = argv[i];
+    if (arg === "--json") {
+      json = true;
+      consumed.add(i);
+    } else if (arg === "--compact") {
+      compact = true;
+      consumed.add(i);
+    } else if (arg === "--tree") {
+      tree = true;
+      consumed.add(i);
+    } else if (arg === "--long") {
+      long = true;
+      consumed.add(i);
+    } else if (arg === "--kind") {
+      const raw = argv[i + 1];
+      if (!raw || raw.startsWith("--")) throw new Error("--kind requires a comma-separated value.");
+      kinds = parseKindFilter(raw);
+      consumed.add(i);
+      consumed.add(i + 1);
+      i += 1;
+    } else if (arg.startsWith("--")) {
+      throw new Error(`Unknown option: ${arg}`);
+    }
+  }
+  const positionals = argv.filter((_, index) => !consumed.has(index));
+  if (!positionals[0]) throw new Error("Missing input path.");
+  if (positionals.length > 2) throw new Error(`Unexpected argument: ${positionals[2]}`);
+  return { scriptPath: positionals[0], selector: positionals[1], json, compact, tree, long, kinds, backend, quality, consumed };
+}
+function filteredTargets(entries, options) {
+  let targets = options.selector ? resolveSceneTargets(entries, options.selector) : entries;
+  if (options.kinds) targets = targets.filter((entry) => options.kinds?.has(entry.kind));
+  return targets;
+}
+function formatNumber(value, digits = 1) {
+  if (!Number.isFinite(value)) return String(value);
+  return value.toFixed(digits).replace(/\.0$/, "");
+}
+function formatBounds(min, max) {
+  return `[${min.map((v) => formatNumber(v)).join(",")}]..[${max.map((v) => formatNumber(v)).join(",")}]`;
+}
+function targetMetrics(entry) {
+  const object = entry.object;
+  if (object.shape) {
+    const bounds2 = object.shape.boundingBox();
+    return {
+      volume: object.shape.volume(),
+      triangles: object.shape.numTri(),
+      bodies: object.shape.numBodies(),
+      bounds: { min: bounds2.min, max: bounds2.max }
+    };
+  }
+  if (object.sketch) return { area: object.sketch.area(), regions: object.sketch.regions().length };
+  if (object.sdf) return { bounds: object.sdf.bounds };
+  return null;
+}
+function targetJson(entry, includeMetrics) {
+  return {
+    id: entry.id,
+    path: entry.path,
+    name: entry.name,
+    kind: entry.kind,
+    group: entry.group ?? null,
+    tags: entry.tags,
+    mock: entry.mock,
+    ...includeMetrics ? { metrics: targetMetrics(entry) } : {}
+  };
+}
+function printLineList(entries, long) {
+  for (const entry of entries) {
+    const base = `${entry.kind.padEnd(8)} ${formatSceneTargetPath(entry)}`;
+    if (!long) {
+      console.log(base);
+      continue;
+    }
+    const metrics = targetMetrics(entry);
+    const detail = metrics && "volume" in metrics ? ` id=${entry.id} vol=${formatNumber(metrics.volume)} tris=${metrics.triangles.toLocaleString()} bodies=${metrics.bodies} bbox=${formatBounds(metrics.bounds.min, metrics.bounds.max)}` : metrics && "area" in metrics ? ` id=${entry.id} area=${formatNumber(metrics.area)} regions=${metrics.regions}` : ` id=${entry.id}`;
+    console.log(`${base}${detail}`);
+  }
+}
+function printTree(entries) {
+  const printedGroups = /* @__PURE__ */ new Set();
+  for (const entry of entries) {
+    for (let depth = 1; depth < entry.pathSegments.length; depth += 1) {
+      const groupPath = entry.pathSegments.slice(0, depth).join("/");
+      if (printedGroups.has(groupPath)) continue;
+      printedGroups.add(groupPath);
+      console.log(`${"  ".repeat(depth - 1)}${entry.pathSegments[depth - 1]}/`);
+    }
+    const indent = "  ".repeat(Math.max(0, entry.pathSegments.length - 1));
+    const label = entry.pathSegments[entry.pathSegments.length - 1] ?? entry.name;
+    console.log(`${indent}${entry.kind.padEnd(8)} ${label}`);
+  }
+}
+async function runLsCli(argv = process.argv.slice(2)) {
+  let options;
+  try {
+    options = parseLsOptions(argv);
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : String(error));
+    console.error(usage12());
+    process.exit(1);
+  }
+  const { overrides } = parseParamFlags(argv);
+  const result = await runModelForInspect(options.scriptPath, options.backend, options.quality, overrides);
+  if (result.error) {
+    console.error("ERROR:", result.error);
+    process.exit(1);
+  }
+  const entries = filteredTargets(buildSceneTargetEntries(result.objects), options);
+  if (options.json) {
+    const body = { script: options.scriptPath, count: entries.length, targets: entries.map((entry) => targetJson(entry, options.long)) };
+    console.log(JSON.stringify(body, null, options.compact ? 0 : 2));
+    return;
+  }
+  if (options.tree) printTree(entries);
+  else printLineList(entries, options.long);
+}
+
 // cli/forge-mesh.ts
 import { writeFileSync as writeFileSync7 } from "fs";
 import { extname as extname6, resolve as resolve20 } from "path";
@@ -19409,6 +19686,74 @@ import { execSync as execSync2, spawnSync } from "child_process";
 import { tmpdir as tmpdir2 } from "os";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
+// cli/framing-diagnostics.ts
+var DEFAULT_PERSPECTIVE_FIT_MARGIN = 1.1;
+var DEFAULT_MIN_CAMERA_DISTANCE = 1;
+function bboxCorners(bbox) {
+  const [minX, minY, minZ] = bbox.min;
+  const [maxX, maxY, maxZ] = bbox.max;
+  return [
+    new Vector3(minX, minY, minZ),
+    new Vector3(minX, minY, maxZ),
+    new Vector3(minX, maxY, minZ),
+    new Vector3(minX, maxY, maxZ),
+    new Vector3(maxX, minY, minZ),
+    new Vector3(maxX, minY, maxZ),
+    new Vector3(maxX, maxY, minZ),
+    new Vector3(maxX, maxY, maxZ)
+  ];
+}
+function bboxCenter(bbox) {
+  return new Vector3((bbox.min[0] + bbox.max[0]) * 0.5, (bbox.min[1] + bbox.max[1]) * 0.5, (bbox.min[2] + bbox.max[2]) * 0.5);
+}
+function finitePositive(value, label) {
+  if (!Number.isFinite(value) || value <= 0) {
+    throw new Error(`${label} must be a positive finite number.`);
+  }
+  return value;
+}
+function cameraRightFor(backward, up) {
+  const normalizedUp = up.lengthSq() > 1e-8 ? up.clone().normalize() : new Vector3(0, 0, 1);
+  let right = new Vector3().crossVectors(normalizedUp, backward);
+  if (right.lengthSq() > 1e-8) return right.normalize();
+  const fallbackUp = Math.abs(backward.z) > 0.92 ? new Vector3(0, 1, 0) : new Vector3(0, 0, 1);
+  right = new Vector3().crossVectors(fallbackUp, backward);
+  if (right.lengthSq() > 1e-8) return right.normalize();
+  return new Vector3(1, 0, 0);
+}
+function perspectiveCameraDistanceForBounds(bbox, directionFromTargetToCamera, options) {
+  const backward = new Vector3(...directionFromTargetToCamera);
+  if (backward.lengthSq() <= 1e-8) {
+    throw new Error("directionFromTargetToCamera must be a non-zero vector.");
+  }
+  backward.normalize();
+  const fovDeg = finitePositive(options.fovDeg, "fovDeg");
+  if (fovDeg >= 180) {
+    throw new Error("fovDeg must be less than 180 degrees.");
+  }
+  const aspect = finitePositive(options.aspect ?? 1, "aspect");
+  const margin = finitePositive(options.margin ?? DEFAULT_PERSPECTIVE_FIT_MARGIN, "margin");
+  const minDistance = finitePositive(options.minDistance ?? DEFAULT_MIN_CAMERA_DISTANCE, "minDistance");
+  const tanHalfVerticalFov = Math.tan(MathUtils.degToRad(fovDeg) * 0.5);
+  const tanHalfHorizontalFov = tanHalfVerticalFov * aspect;
+  const right = cameraRightFor(backward, new Vector3(...options.up ?? [0, 0, 1]));
+  const screenUp = new Vector3().crossVectors(backward, right).normalize();
+  const center = bboxCenter(bbox);
+  let requiredDistance = minDistance;
+  for (const corner of bboxCorners(bbox)) {
+    const offset = corner.sub(center);
+    const depthOffset = offset.dot(backward);
+    const horizontalOffset = Math.abs(offset.dot(right));
+    const verticalOffset = Math.abs(offset.dot(screenUp));
+    requiredDistance = Math.max(
+      requiredDistance,
+      horizontalOffset * margin / tanHalfHorizontalFov + depthOffset,
+      verticalOffset * margin / tanHalfVerticalFov + depthOffset
+    );
+  }
+  return requiredDistance;
+}
+
 // cli/render-camera-tokens.ts
 var CAMERA_TOKEN_DIRECTIONS = {
   front: [0, -1, 0.2],
@@ -19442,17 +19787,13 @@ function parseCameraToken(token) {
     `Unknown camera "${token}". Use a preset (front, back, side, right, top, iso) or azimuth:elevation in degrees (e.g. 45:30).`
   );
 }
-function cameraStateFromToken(token, center, defaultDistance, fov) {
+function cameraStateFromToken(token, center, defaultDistance, fov, bounds2) {
   const parsed = parseCameraToken(token);
   const dir = normalizeCameraDirection(parsed.dir);
-  const distance2 = parsed.distance ?? defaultDistance;
+  const distance2 = parsed.distance ?? (bounds2 ? perspectiveCameraDistanceForBounds(bounds2, dir, { fovDeg: fov }) : defaultDistance);
   return {
     projectionMode: "perspective",
-    position: [
-      center[0] + dir[0] * distance2,
-      center[1] + dir[1] * distance2,
-      center[2] + dir[2] * distance2
-    ],
+    position: [center[0] + dir[0] * distance2, center[1] + dir[1] * distance2, center[2] + dir[2] * distance2],
     target: center,
     up: [0, 0, 1],
     fov
@@ -19710,17 +20051,17 @@ function computeMeshCameraFrame(objects) {
   const min = [Number.POSITIVE_INFINITY, Number.POSITIVE_INFINITY, Number.POSITIVE_INFINITY];
   const max = [Number.NEGATIVE_INFINITY, Number.NEGATIVE_INFINITY, Number.NEGATIVE_INFINITY];
   for (const obj of objects) {
-    const bbox = obj.shape.boundingBox();
+    const bbox2 = obj.shape.boundingBox();
     for (let axis = 0; axis < 3; axis += 1) {
-      min[axis] = Math.min(min[axis], bbox.min[axis]);
-      max[axis] = Math.max(max[axis], bbox.max[axis]);
+      min[axis] = Math.min(min[axis], bbox2.min[axis]);
+      max[axis] = Math.max(max[axis], bbox2.max[axis]);
     }
   }
   const center = [(min[0] + max[0]) * 0.5, (min[1] + max[1]) * 0.5, (min[2] + max[2]) * 0.5];
-  const maxDim = Math.max(1, max[0] - min[0], max[1] - min[1], max[2] - min[2]);
   const fov = 45;
-  const distance2 = maxDim / (2 * Math.tan(fov * Math.PI / 360)) * 1.6;
-  return { center, distance: distance2, fov };
+  const bbox = { min, max };
+  const distance2 = perspectiveCameraDistanceForBounds(bbox, [0, -1, 0.32], { fovDeg: fov });
+  return { center, distance: distance2, fov, bbox };
 }
 function sceneConfigCameraToViewportCamera(sceneConfig, frame) {
   const camera = sceneConfig.camera;
@@ -19737,7 +20078,10 @@ function resolveHqCamera(args, sceneConfig, meshObjects) {
   const frame = computeMeshCameraFrame(meshObjects);
   if (args.scene?.camera) return args.scene.camera;
   if (args.viewName) return resolveNamedSceneViewCamera(sceneConfig, args.viewName);
-  if (args.cameraToken) return cameraStateFromToken(args.cameraToken, frame.center, frame.distance, sceneConfig?.camera?.fov ?? frame.fov);
+  if (args.cameraToken) {
+    const fov = sceneConfig?.camera?.fov ?? frame.fov;
+    return cameraStateFromToken(args.cameraToken, frame.center, frame.distance, fov, frame.bbox);
+  }
   if (sceneConfig) return sceneConfigCameraToViewportCamera(sceneConfig, frame);
   return null;
 }
@@ -19881,12 +20225,12 @@ import { basename as basename9, resolve as resolve23 } from "path";
 function defaultPngOutput(scriptPath) {
   return scriptPath.replace(/\.(forge|sketch)\.js$/, ".png").replace(/\.js$/, ".png");
 }
-function usage12() {
+function usage13() {
   console.error("Usage: forgecad render sketch <script.forge.js> [output.png] [--size <px>] [--chrome-path <path>]");
   process.exit(1);
 }
 function parseCli2(argv) {
-  if (argv.length === 0 || argv.includes("-h") || argv.includes("--help")) usage12();
+  if (argv.length === 0 || argv.includes("-h") || argv.includes("--help")) usage13();
   let scriptPath;
   let outputPath;
   let size = 1024;
@@ -19911,7 +20255,7 @@ function parseCli2(argv) {
     else if (!outputPath) outputPath = arg;
     else throw new Error(`Unexpected argument: ${arg}`);
   }
-  if (!scriptPath) usage12();
+  if (!scriptPath) usage13();
   if (!Number.isFinite(size) || size < 128 || size > 4096) throw new Error(`--size must be between 128 and 4096 (got ${size})`);
   return {
     scriptPath,
@@ -19927,7 +20271,7 @@ async function runRender2dCli(argv = process.argv.slice(2)) {
     options = parseCli2(argv);
   } catch (err) {
     console.error(String(err));
-    usage12();
+    usage13();
   }
   const chromePath = findChromePath(options.chromePath);
   if (!chromePath) {
@@ -20046,13 +20390,13 @@ function formatSheetCutList(input) {
 }
 
 // cli/forge-cut-list.ts
-function usage13() {
+function usage14() {
   console.error("Usage: forgecad cut-list <script.forge.js>");
   process.exit(1);
 }
 async function runCutListCli(argv = process.argv.slice(2)) {
   const scriptPath = argv[0];
-  if (!scriptPath) usage13();
+  if (!scriptPath) usage14();
   const source = await readFile2(resolve24(scriptPath), "utf-8");
   const { allFiles, fileName } = collectProjectFiles(scriptPath);
   await init();
@@ -20085,7 +20429,7 @@ function hasFlag(argv, name) {
   const prefix = `${name}=`;
   return argv.some((arg) => arg === name || arg.startsWith(prefix));
 }
-function usage14() {
+function usage15() {
   console.error(
     "Usage: forgecad export cutting-layout <script.forge.js> [output.pdf|output.dxf]\n         [--format pdf|dxf] [--sheet-width <mm>] [--sheet-height <mm>] [--kerf <mm>]"
   );
@@ -20149,7 +20493,7 @@ function smartDefaults(entries) {
 }
 async function runCuttingLayoutCli(argv = process.argv.slice(2)) {
   const scriptPath = argv[0];
-  if (!scriptPath) usage14();
+  if (!scriptPath) usage15();
   const explicitOutputPath = outputPathArg(argv);
   const formatArg = argValue(argv, "--format");
   if (hasFlag(argv, "--format") && formatArg == null) {
@@ -20212,7 +20556,7 @@ function argValue2(argv, name) {
   if (idx === -1) return void 0;
   return argv[idx + 1];
 }
-function usage15() {
+function usage16() {
   console.error(
     "Usage: forgecad export report <model.forge.js|asset.stl|asset.obj|asset.3mf|asset.step|asset.stp> [output.pdf] [--dim-angle-tol <deg>]"
   );
@@ -20220,7 +20564,7 @@ function usage15() {
 }
 async function runReportCli(argv = process.argv.slice(2)) {
   const scriptPath = argv[0];
-  if (!scriptPath) usage15();
+  if (!scriptPath) usage16();
   const defaultOut = replaceCliInputExtension(scriptPath, ".report.pdf");
   const outputPath = argv[1] && !argv[1].startsWith("--") ? argv[1] : defaultOut;
   const toleranceArg = argValue2(argv, "--dim-angle-tol");
@@ -20284,16 +20628,16 @@ function mmToM(valueMm) {
 function degToRad(valueDeg) {
   return valueDeg * Math.PI / 180;
 }
-function formatNumber(value, digits = 6) {
+function formatNumber2(value, digits = 6) {
   if (!Number.isFinite(value)) return "0";
   const normalized = Math.abs(value) < 1e-12 ? 0 : value;
   return normalized.toFixed(digits).replace(/\.?0+$/, "");
 }
 function formatPose(parts) {
-  return [...parts.xyzM.map((value) => formatNumber(value, 6)), ...parts.rpyRad.map((value) => formatNumber(value, 6))].join(" ");
+  return [...parts.xyzM.map((value) => formatNumber2(value, 6)), ...parts.rpyRad.map((value) => formatNumber2(value, 6))].join(" ");
 }
 function axisToText(axis) {
-  return axis.map((value) => formatNumber(value, 6)).join(" ");
+  return axis.map((value) => formatNumber2(value, 6)).join(" ");
 }
 function transformToPose(transform) {
   const m = transform.toArray();
@@ -20439,15 +20783,15 @@ function inertiaFromBounds(geometry, massKg) {
 }
 function jointTypeLimitUnits(joint2, value) {
   if (value === void 0) return null;
-  if (joint2.type === "revolute") return formatNumber(degToRad(value), 6);
-  if (joint2.type === "prismatic") return formatNumber(mmToM(value), 6);
+  if (joint2.type === "revolute") return formatNumber2(degToRad(value), 6);
+  if (joint2.type === "prismatic") return formatNumber2(mmToM(value), 6);
   return null;
 }
 function jointVelocityUnits(joint2, value) {
   if (value === void 0) return null;
-  if (joint2.type === "revolute") return formatNumber(degToRad(value), 6);
-  if (joint2.type === "prismatic") return formatNumber(mmToM(value), 6);
-  return formatNumber(value, 6);
+  if (joint2.type === "revolute") return formatNumber2(degToRad(value), 6);
+  if (joint2.type === "prismatic") return formatNumber2(mmToM(value), 6);
+  return formatNumber2(value, 6);
 }
 function sRgbFloat(hex) {
   if (!hex || !/^#([0-9a-f]{6})$/i.test(hex)) return null;
@@ -20476,14 +20820,14 @@ function demoWorldName(world, modelName) {
 }
 function keyboardPluginXml(cmdVelTopic, linearStep, angularStep) {
   const bindings = [
-    { key: 87, twist: `linear: {x: ${formatNumber(linearStep, 3)}}, angular: {z: 0.0}` },
-    { key: 88, twist: `linear: {x: ${formatNumber(-linearStep, 3)}}, angular: {z: 0.0}` },
-    { key: 65, twist: `linear: {x: 0.0}, angular: {z: ${formatNumber(angularStep, 3)}}` },
-    { key: 68, twist: `linear: {x: 0.0}, angular: {z: ${formatNumber(-angularStep, 3)}}` },
-    { key: 81, twist: `linear: {x: ${formatNumber(linearStep, 3)}}, angular: {z: ${formatNumber(angularStep, 3)}}` },
-    { key: 69, twist: `linear: {x: ${formatNumber(linearStep, 3)}}, angular: {z: ${formatNumber(-angularStep, 3)}}` },
-    { key: 90, twist: `linear: {x: ${formatNumber(-linearStep, 3)}}, angular: {z: ${formatNumber(angularStep, 3)}}` },
-    { key: 67, twist: `linear: {x: ${formatNumber(-linearStep, 3)}}, angular: {z: ${formatNumber(-angularStep, 3)}}` },
+    { key: 87, twist: `linear: {x: ${formatNumber2(linearStep, 3)}}, angular: {z: 0.0}` },
+    { key: 88, twist: `linear: {x: ${formatNumber2(-linearStep, 3)}}, angular: {z: 0.0}` },
+    { key: 65, twist: `linear: {x: 0.0}, angular: {z: ${formatNumber2(angularStep, 3)}}` },
+    { key: 68, twist: `linear: {x: 0.0}, angular: {z: ${formatNumber2(-angularStep, 3)}}` },
+    { key: 81, twist: `linear: {x: ${formatNumber2(linearStep, 3)}}, angular: {z: ${formatNumber2(angularStep, 3)}}` },
+    { key: 69, twist: `linear: {x: ${formatNumber2(linearStep, 3)}}, angular: {z: ${formatNumber2(-angularStep, 3)}}` },
+    { key: 90, twist: `linear: {x: ${formatNumber2(-linearStep, 3)}}, angular: {z: ${formatNumber2(angularStep, 3)}}` },
+    { key: 67, twist: `linear: {x: ${formatNumber2(-linearStep, 3)}}, angular: {z: ${formatNumber2(-angularStep, 3)}}` },
     { key: 83, twist: "linear: {x: 0.0}, angular: {z: 0.0}" },
     { key: 32, twist: "linear: {x: 0.0}, angular: {z: 0.0}" }
   ];
@@ -20643,12 +20987,12 @@ ${keyboardGuiPluginXml()}` : "";
 function demoWorldXml(worldName, modelName, cmdVelTopic, world) {
   const spawnPose = world?.spawnPose ?? [0, 0, 120, 0, 0, 0];
   const spawnPoseText = [
-    formatNumber(mmToM(spawnPose[0]), 6),
-    formatNumber(mmToM(spawnPose[1]), 6),
-    formatNumber(mmToM(spawnPose[2]), 6),
-    formatNumber(degToRad(spawnPose[3]), 6),
-    formatNumber(degToRad(spawnPose[4]), 6),
-    formatNumber(degToRad(spawnPose[5]), 6)
+    formatNumber2(mmToM(spawnPose[0]), 6),
+    formatNumber2(mmToM(spawnPose[1]), 6),
+    formatNumber2(mmToM(spawnPose[2]), 6),
+    formatNumber2(degToRad(spawnPose[3]), 6),
+    formatNumber2(degToRad(spawnPose[4]), 6),
+    formatNumber2(degToRad(spawnPose[5]), 6)
   ].join(" ");
   const keyboardEnabled = world?.keyboardTeleop?.enabled ?? true;
   const linearStep = world?.keyboardTeleop?.linearStep ?? 0.9;
@@ -20818,28 +21162,28 @@ function modelXml(spec, modelName, linkNameMap, jointNameMap, geometries, linkWo
     const color = sRgbFloat(geometry.shapes[0]?.colorHex);
     const materialXml = color ? `
         <material>
-          <ambient>${formatNumber(color[0], 3)} ${formatNumber(color[1], 3)} ${formatNumber(color[2], 3)} 1</ambient>
-          <diffuse>${formatNumber(color[0], 3)} ${formatNumber(color[1], 3)} ${formatNumber(color[2], 3)} 1</diffuse>
+          <ambient>${formatNumber2(color[0], 3)} ${formatNumber2(color[1], 3)} ${formatNumber2(color[2], 3)} 1</ambient>
+          <diffuse>${formatNumber2(color[0], 3)} ${formatNumber2(color[1], 3)} ${formatNumber2(color[2], 3)} 1</diffuse>
         </material>` : "";
     return `    <link name="${escapeXml(sdfLinkName)}">
       <pose relative_to="__model__">${formatPose(worldPose)}</pose>
       <inertial>
         <pose>${formatPose(inertia.pose)}</pose>
-        <mass>${formatNumber(massKg, 6)}</mass>
+        <mass>${formatNumber2(massKg, 6)}</mass>
         <inertia>
-          <ixx>${formatNumber(inertia.ixx, 8)}</ixx>
-          <ixy>${formatNumber(inertia.ixy, 8)}</ixy>
-          <ixz>${formatNumber(inertia.ixz, 8)}</ixz>
-          <iyy>${formatNumber(inertia.iyy, 8)}</iyy>
-          <iyz>${formatNumber(inertia.iyz, 8)}</iyz>
-          <izz>${formatNumber(inertia.izz, 8)}</izz>
+          <ixx>${formatNumber2(inertia.ixx, 8)}</ixx>
+          <ixy>${formatNumber2(inertia.ixy, 8)}</ixy>
+          <ixz>${formatNumber2(inertia.ixz, 8)}</ixz>
+          <iyy>${formatNumber2(inertia.iyy, 8)}</iyy>
+          <iyz>${formatNumber2(inertia.iyz, 8)}</iyz>
+          <izz>${formatNumber2(inertia.izz, 8)}</izz>
         </inertia>
       </inertial>
       <visual name="${escapeXml(sdfLinkName)}_visual">
         <geometry>
           <mesh>
             <uri>${escapeXml(meshPath)}</uri>
-            <scale>${formatNumber(STL_SCALE_METERS, 6)} ${formatNumber(STL_SCALE_METERS, 6)} ${formatNumber(STL_SCALE_METERS, 6)}</scale>
+            <scale>${formatNumber2(STL_SCALE_METERS, 6)} ${formatNumber2(STL_SCALE_METERS, 6)} ${formatNumber2(STL_SCALE_METERS, 6)}</scale>
           </mesh>
         </geometry>${materialXml}
       </visual>${(() => {
@@ -20849,7 +21193,7 @@ function modelXml(spec, modelName, linkNameMap, jointNameMap, geometries, linkWo
         <geometry>
           <mesh>
             <uri>${escapeXml(meshPath)}</uri>
-            <scale>${formatNumber(STL_SCALE_METERS, 6)} ${formatNumber(STL_SCALE_METERS, 6)} ${formatNumber(STL_SCALE_METERS, 6)}</scale>
+            <scale>${formatNumber2(STL_SCALE_METERS, 6)} ${formatNumber2(STL_SCALE_METERS, 6)} ${formatNumber2(STL_SCALE_METERS, 6)}</scale>
           </mesh>
         </geometry>
       </collision>`;
@@ -20861,7 +21205,7 @@ function modelXml(spec, modelName, linkNameMap, jointNameMap, geometries, linkWo
         <geometry>
           <mesh>
             <uri>${escapeXml(collisionMeshPath)}</uri>
-            <scale>${formatNumber(STL_SCALE_METERS, 6)} ${formatNumber(STL_SCALE_METERS, 6)} ${formatNumber(STL_SCALE_METERS, 6)}</scale>
+            <scale>${formatNumber2(STL_SCALE_METERS, 6)} ${formatNumber2(STL_SCALE_METERS, 6)} ${formatNumber2(STL_SCALE_METERS, 6)}</scale>
           </mesh>
         </geometry>
       </collision>`;
@@ -20875,9 +21219,9 @@ function modelXml(spec, modelName, linkNameMap, jointNameMap, geometries, linkWo
         const bCz = mmToM((geometry.bboxMin[2] + geometry.bboxMax[2]) * 0.5);
         return `
       <collision name="${escapeXml(sdfLinkName)}_collision">
-        <pose>${formatNumber(bCx, 6)} ${formatNumber(bCy, 6)} ${formatNumber(bCz, 6)} 0 0 0</pose>
+        <pose>${formatNumber2(bCx, 6)} ${formatNumber2(bCy, 6)} ${formatNumber2(bCz, 6)} 0 0 0</pose>
         <geometry>
-          <box><size>${formatNumber(bDx, 6)} ${formatNumber(bDy, 6)} ${formatNumber(bDz, 6)}</size></box>
+          <box><size>${formatNumber2(bDx, 6)} ${formatNumber2(bDy, 6)} ${formatNumber2(bDz, 6)}</size></box>
         </geometry>
       </collision>`;
       }
@@ -20904,8 +21248,8 @@ function modelXml(spec, modelName, linkNameMap, jointNameMap, geometries, linkWo
       const leaderSdfName = jointNameMap.get(`${primary.joint}_joint`);
       mimicXml = `
         <mimic joint="${escapeXml(leaderSdfName)}">
-          <multiplier>${formatNumber(primary.ratio, 6)}</multiplier>
-          <offset>${formatNumber(coupling.offset, 6)}</offset>
+          <multiplier>${formatNumber2(primary.ratio, 6)}</multiplier>
+          <offset>${formatNumber2(coupling.offset, 6)}</offset>
         </mimic>`;
       if (coupling.terms.length > 1) {
         warnings.push(
@@ -20922,12 +21266,12 @@ function modelXml(spec, modelName, linkNameMap, jointNameMap, geometries, linkWo
         <limit>${limitLower !== null ? `
           <lower>${limitLower}</lower>` : ""}${limitUpper !== null ? `
           <upper>${limitUpper}</upper>` : ""}${effort !== void 0 ? `
-          <effort>${formatNumber(effort, 6)}</effort>` : ""}${velocity !== null ? `
+          <effort>${formatNumber2(effort, 6)}</effort>` : ""}${velocity !== null ? `
           <velocity>${velocity}</velocity>` : ""}
         </limit>` : ""}${damping !== void 0 || friction !== void 0 ? `
         <dynamics>${damping !== void 0 ? `
-          <damping>${formatNumber(damping, 6)}</damping>` : ""}${friction !== void 0 ? `
-          <friction>${formatNumber(friction, 6)}</friction>` : ""}
+          <damping>${formatNumber2(damping, 6)}</damping>` : ""}${friction !== void 0 ? `
+          <friction>${formatNumber2(friction, 6)}</friction>` : ""}
         </dynamics>` : ""}
       </axis>` : ""}
     </joint>`;
@@ -20937,17 +21281,17 @@ function modelXml(spec, modelName, linkNameMap, jointNameMap, geometries, linkWo
     plugins.push(`    <plugin filename="gz-sim-diff-drive-system" name="gz::sim::systems::DiffDrive">
       ${spec.plugins.diffDrive.leftJoints.map((jointName) => `<left_joint>${escapeXml(jointNameMap.get(`${jointName}_joint`))}</left_joint>`).join("\n      ")}
       ${spec.plugins.diffDrive.rightJoints.map((jointName) => `<right_joint>${escapeXml(jointNameMap.get(`${jointName}_joint`))}</right_joint>`).join("\n      ")}
-      <wheel_separation>${formatNumber(mmToM(spec.plugins.diffDrive.wheelSeparationMm), 6)}</wheel_separation>
-      <wheel_radius>${formatNumber(mmToM(spec.plugins.diffDrive.wheelRadiusMm), 6)}</wheel_radius>
+      <wheel_separation>${formatNumber2(mmToM(spec.plugins.diffDrive.wheelSeparationMm), 6)}</wheel_separation>
+      <wheel_radius>${formatNumber2(mmToM(spec.plugins.diffDrive.wheelRadiusMm), 6)}</wheel_radius>
       <topic>${escapeXml(cmdVelTopic)}</topic>${spec.plugins.diffDrive.odomTopic ? `
       <odom_topic>${escapeXml(spec.plugins.diffDrive.odomTopic)}</odom_topic>` : ""}${spec.plugins.diffDrive.tfTopic ? `
       <tf_topic>${escapeXml(spec.plugins.diffDrive.tfTopic)}</tf_topic>` : ""}${spec.plugins.diffDrive.frameId ? `
       <frame_id>${escapeXml(spec.plugins.diffDrive.frameId)}</frame_id>` : ""}${spec.plugins.diffDrive.odomFrameId ? `
       <odom_frame>${escapeXml(spec.plugins.diffDrive.odomFrameId)}</odom_frame>` : ""}${spec.plugins.diffDrive.maxLinearVelocity !== void 0 ? `
-      <max_linear_velocity>${formatNumber(spec.plugins.diffDrive.maxLinearVelocity, 6)}</max_linear_velocity>` : ""}${spec.plugins.diffDrive.maxAngularVelocity !== void 0 ? `
-      <max_angular_velocity>${formatNumber(spec.plugins.diffDrive.maxAngularVelocity, 6)}</max_angular_velocity>` : ""}${spec.plugins.diffDrive.linearAcceleration !== void 0 ? `
-      <linear_acceleration>${formatNumber(spec.plugins.diffDrive.linearAcceleration, 6)}</linear_acceleration>` : ""}${spec.plugins.diffDrive.angularAcceleration !== void 0 ? `
-      <angular_acceleration>${formatNumber(spec.plugins.diffDrive.angularAcceleration, 6)}</angular_acceleration>` : ""}
+      <max_linear_velocity>${formatNumber2(spec.plugins.diffDrive.maxLinearVelocity, 6)}</max_linear_velocity>` : ""}${spec.plugins.diffDrive.maxAngularVelocity !== void 0 ? `
+      <max_angular_velocity>${formatNumber2(spec.plugins.diffDrive.maxAngularVelocity, 6)}</max_angular_velocity>` : ""}${spec.plugins.diffDrive.linearAcceleration !== void 0 ? `
+      <linear_acceleration>${formatNumber2(spec.plugins.diffDrive.linearAcceleration, 6)}</linear_acceleration>` : ""}${spec.plugins.diffDrive.angularAcceleration !== void 0 ? `
+      <angular_acceleration>${formatNumber2(spec.plugins.diffDrive.angularAcceleration, 6)}</angular_acceleration>` : ""}
     </plugin>`);
   }
   const jointState = spec.plugins.jointStatePublisher;
@@ -20957,7 +21301,7 @@ function modelXml(spec, modelName, linkNameMap, jointNameMap, geometries, linkWo
       (jointName) => `
       <joint_name>${escapeXml(jointNameMap.get(`${jointName}_joint`))}</joint_name>`
     ).join("")}${jointState?.updateRate !== void 0 ? `
-      <update_rate>${formatNumber(jointState.updateRate, 6)}</update_rate>` : ""}
+      <update_rate>${formatNumber2(jointState.updateRate, 6)}</update_rate>` : ""}
     </plugin>`);
   }
   const rootNames = spec.assembly.parts.filter((part) => !spec.assembly.joints.some((joint2) => joint2.child === part.name)).map((part) => linkNameMap.get(part.name));
@@ -21149,6 +21493,129 @@ async function runSdfCli(argv = process.argv.slice(2)) {
   }
 }
 
+// cli/forge-show.ts
+var FORWARDED_VALUE_OPTIONS = /* @__PURE__ */ new Set([
+  "--camera",
+  "--camera-json",
+  "--view",
+  "--scene",
+  "--background",
+  "--render-style",
+  "--edges",
+  "--size",
+  "--port",
+  "--chrome-path",
+  "--backend",
+  "--param",
+  "-p",
+  "--render-mode",
+  "--scan-granularity"
+]);
+var FORWARDED_FLAG_OPTIONS = /* @__PURE__ */ new Set(["--fresh-server"]);
+var CAMERA_SOURCE_OPTIONS = /* @__PURE__ */ new Set(["--camera", "--camera-json", "--view", "--scene"]);
+function usage17() {
+  return [
+    "Usage: forgecad show <model.forge.js|asset.stl|asset.obj|asset.3mf|asset.step|asset.stp> [target] [output.png] [--from front|back|side|right|top|iso|az:el|az:el:dist] [--out output.png] [--param Key=Value] [--backend manifold|occt|truck] [render options]"
+  ].join("\n");
+}
+function isImageOutput(value) {
+  return /\.(png|jpg|jpeg|webp)$/i.test(value);
+}
+function readValue6(argv, index, flag) {
+  const value = argv[index + 1];
+  if (!value || value.startsWith("--")) throw new Error(`${flag} requires a value.`);
+  return value;
+}
+function parseShowOptions(argv) {
+  if (argv.length === 0 || argv.includes("-h") || argv.includes("--help")) {
+    console.log(usage17());
+    process.exit(0);
+  }
+  const consumed = /* @__PURE__ */ new Set();
+  const renderArgs = [];
+  let output;
+  let from;
+  let hasRenderCameraSource = false;
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (arg === "--from") {
+      from = readValue6(argv, i, arg);
+      consumed.add(i);
+      consumed.add(i + 1);
+      i += 1;
+      continue;
+    }
+    if (arg === "--out" || arg === "--output") {
+      output = readValue6(argv, i, arg);
+      consumed.add(i);
+      consumed.add(i + 1);
+      i += 1;
+      continue;
+    }
+    if (FORWARDED_VALUE_OPTIONS.has(arg)) {
+      const value = readValue6(argv, i, arg);
+      renderArgs.push(arg, value);
+      if (CAMERA_SOURCE_OPTIONS.has(arg)) hasRenderCameraSource = true;
+      consumed.add(i);
+      consumed.add(i + 1);
+      i += 1;
+      continue;
+    }
+    if (FORWARDED_FLAG_OPTIONS.has(arg)) {
+      renderArgs.push(arg);
+      consumed.add(i);
+      continue;
+    }
+    if (arg.startsWith("--")) throw new Error(`Unknown option: ${arg}`);
+  }
+  if (from && hasRenderCameraSource) throw new Error("Use either --from or an explicit render camera option, not both.");
+  const positionals = argv.filter((_, index) => !consumed.has(index));
+  const scriptPath = positionals[0];
+  if (!scriptPath) throw new Error("Missing input path.");
+  let target;
+  if (positionals.length === 2) {
+    if (!output && isImageOutput(positionals[1])) output = positionals[1];
+    else target = positionals[1];
+  } else if (positionals.length === 3) {
+    target = positionals[1];
+    if (output) throw new Error("Pass output either positionally or with --out, not both.");
+    output = positionals[2];
+  } else if (positionals.length > 3) {
+    throw new Error(`Unexpected argument: ${positionals[3]}`);
+  }
+  return { scriptPath, target, output, from, renderArgs, consumed };
+}
+function renderFocusForTargetNames(names) {
+  return names.join(",");
+}
+async function runShowCli(argv = process.argv.slice(2)) {
+  let options;
+  try {
+    options = parseShowOptions(argv);
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : String(error));
+    console.error(usage17());
+    process.exit(1);
+  }
+  const renderArgs = [options.scriptPath];
+  if (options.output) renderArgs.push(options.output);
+  if (options.from) renderArgs.push("--camera", options.from);
+  renderArgs.push(...options.renderArgs);
+  if (options.target) {
+    const { overrides } = parseParamFlags(argv);
+    const { backend } = parseBackendArg(argv);
+    const result = await runModelForInspect(options.scriptPath, backend, void 0, overrides);
+    if (result.error) {
+      console.error("ERROR:", result.error);
+      process.exit(1);
+    }
+    const targets = resolveSceneTargets(buildSceneTargetEntries(result.objects), options.target);
+    renderArgs.push("--focus", renderFocusForTargetNames(targets.map((target) => target.name)));
+    console.log(`Target: ${targets.map(formatSceneTargetPath).join(", ")}`);
+  }
+  await runRenderCli(renderArgs);
+}
+
 // cli/forge-sketch-pdf.ts
 import { readFile as readFile4, writeFile as writeFile7 } from "fs/promises";
 import { basename as basename12, resolve as resolve28 } from "path";
@@ -21708,7 +22175,7 @@ function generateSketchPdf(meta, options) {
 }
 
 // cli/forge-sketch-pdf.ts
-function usage16() {
+function usage18() {
   console.error("Usage: forgecad export sketch-pdf <script.forge.js> [output.pdf]");
   process.exit(1);
 }
@@ -21717,7 +22184,7 @@ function defaultPdfOutput(scriptPath) {
 }
 async function runSketchPdfCli(argv = process.argv.slice(2)) {
   const scriptPath = argv[0];
-  if (!scriptPath) usage16();
+  if (!scriptPath) usage18();
   const outputPath = argv[1] || defaultPdfOutput(scriptPath);
   if (resolve28(outputPath) === resolve28(scriptPath)) {
     console.error(`ERROR: output path would overwrite the input script. Specify an explicit output path.`);
@@ -22157,7 +22624,7 @@ function getServerUrl() {
 }
 function cliAuthRequiredMessage() {
   return [
-    "ForgeCAD CLI commands require a ForgeCAD account.",
+    "This ForgeCAD CLI command requires a ForgeCAD account.",
     "",
     "  New account:          forgecad signup",
     "  Interactive sign-in:  forgecad login",
@@ -23545,7 +24012,7 @@ data: ${JSON.stringify(data)}
 }
 
 // cli/forge-studio.ts
-function usage17() {
+function usage19() {
   console.error(`ForgeCAD Studio
 
 Usage:
@@ -23575,7 +24042,7 @@ function parseStudioArgs(argv) {
   if (argv.length === 0) {
     throw new Error("Missing project path. Use `forgecad studio <project-path> [project-path ...]`.");
   }
-  if (argv.includes("-h") || argv.includes("--help")) usage17();
+  if (argv.includes("-h") || argv.includes("--help")) usage19();
   const options = { open: false, strictPort: false, projectPaths: [] };
   for (let i = 0; i < argv.length; i += 1) {
     const arg = argv[i];
@@ -23650,7 +24117,7 @@ async function runStudioCli(argv = process.argv.slice(2)) {
 // cli/forge-svg.ts
 import { readFile as readFile5, writeFile as writeFile8 } from "fs/promises";
 import { basename as basename13, resolve as resolve31 } from "path";
-function usage18() {
+function usage20() {
   console.error("Usage: forgecad export svg <script.forge.js> [output.svg]");
   process.exit(1);
 }
@@ -23659,7 +24126,7 @@ function defaultSvgOutput(scriptPath) {
 }
 async function runSvgCli(argv = process.argv.slice(2)) {
   const scriptPath = argv[0];
-  if (!scriptPath) usage18();
+  if (!scriptPath) usage20();
   const outputPath = argv[1] || defaultSvgOutput(scriptPath);
   if (resolve31(outputPath) === resolve31(scriptPath)) {
     console.error(`ERROR: output path would overwrite the input script. Specify an explicit output path.`);
@@ -23727,7 +24194,7 @@ function mmToM2(valueMm) {
 function degToRad2(valueDeg) {
   return valueDeg * Math.PI / 180;
 }
-function formatNumber2(value, digits = 6) {
+function formatNumber3(value, digits = 6) {
   if (!Number.isFinite(value)) return "0";
   const normalized = Math.abs(value) < 1e-12 ? 0 : value;
   return normalized.toFixed(digits).replace(/\.?0+$/, "");
@@ -23850,7 +24317,7 @@ function transformToOrigin(transform) {
     yaw = Math.atan2(r10, r00);
   }
   const x = mmToM2(m[12]), y = mmToM2(m[13]), z = mmToM2(m[14]);
-  return `xyz="${formatNumber2(x)} ${formatNumber2(y)} ${formatNumber2(z)}" rpy="${formatNumber2(roll)} ${formatNumber2(pitch)} ${formatNumber2(yaw)}"`;
+  return `xyz="${formatNumber3(x)} ${formatNumber3(y)} ${formatNumber3(z)}" rpy="${formatNumber3(roll)} ${formatNumber3(pitch)} ${formatNumber3(yaw)}"`;
 }
 function sRgbFloat2(hex) {
   if (!hex || !/^#([0-9a-f]{6})$/i.test(hex)) return null;
@@ -23911,7 +24378,7 @@ function urdfXml(spec, modelName, linkNameMap, jointNameMap, geometries, _linkWo
     const color = sRgbFloat2(geometry.shapes[0]?.colorHex);
     const materialXml = color ? `
         <material name="${escapeXml2(urdfLinkName)}_material">
-          <color rgba="${formatNumber2(color[0], 3)} ${formatNumber2(color[1], 3)} ${formatNumber2(color[2], 3)} 1"/>
+          <color rgba="${formatNumber3(color[0], 3)} ${formatNumber3(color[1], 3)} ${formatNumber3(color[2], 3)} 1"/>
         </material>` : "";
     let collisionXml = "";
     if (collisionMode === "visual") {
@@ -23940,17 +24407,17 @@ function urdfXml(spec, modelName, linkNameMap, jointNameMap, geometries, _linkWo
       const bCz = mmToM2((geometry.bboxMin[2] + geometry.bboxMax[2]) * 0.5);
       collisionXml = `
     <collision>
-      <origin xyz="${formatNumber2(bCx)} ${formatNumber2(bCy)} ${formatNumber2(bCz)}" rpy="0 0 0"/>
+      <origin xyz="${formatNumber3(bCx)} ${formatNumber3(bCy)} ${formatNumber3(bCz)}" rpy="0 0 0"/>
       <geometry>
-        <box size="${formatNumber2(bDx)} ${formatNumber2(bDy)} ${formatNumber2(bDz)}"/>
+        <box size="${formatNumber3(bDx)} ${formatNumber3(bDy)} ${formatNumber3(bDz)}"/>
       </geometry>
     </collision>`;
     }
     return `  <link name="${escapeXml2(urdfLinkName)}">
     <inertial>
-      <origin xyz="${formatNumber2(comX)} ${formatNumber2(comY)} ${formatNumber2(comZ)}" rpy="0 0 0"/>
-      <mass value="${formatNumber2(massKg, 6)}"/>
-      <inertia ixx="${formatNumber2(ixx, 8)}" ixy="${formatNumber2(ixy, 8)}" ixz="${formatNumber2(ixz, 8)}" iyy="${formatNumber2(iyy, 8)}" iyz="${formatNumber2(iyz, 8)}" izz="${formatNumber2(izz, 8)}"/>
+      <origin xyz="${formatNumber3(comX)} ${formatNumber3(comY)} ${formatNumber3(comZ)}" rpy="0 0 0"/>
+      <mass value="${formatNumber3(massKg, 6)}"/>
+      <inertia ixx="${formatNumber3(ixx, 8)}" ixy="${formatNumber3(ixy, 8)}" ixz="${formatNumber3(ixz, 8)}" iyy="${formatNumber3(iyy, 8)}" iyz="${formatNumber3(iyz, 8)}" izz="${formatNumber3(izz, 8)}"/>
     </inertial>
     <visual>
       <geometry>
@@ -23967,7 +24434,7 @@ function urdfXml(spec, modelName, linkNameMap, jointNameMap, geometries, _linkWo
     const jType = urdfJointHasContinuous(joint2) ? "continuous" : urdfJointType(joint2.type);
     const originAttr = transformToOrigin(joint2.frame);
     const axisXml = joint2.type !== "fixed" ? `
-    <axis xyz="${joint2.axis.map((v) => formatNumber2(v)).join(" ")}"/>` : "";
+    <axis xyz="${joint2.axis.map((v) => formatNumber3(v)).join(" ")}"/>` : "";
     let limitXml = "";
     if (joint2.type !== "fixed" && jType !== "continuous") {
       const lower2 = joint2.min !== void 0 ? joint2.type === "revolute" ? degToRad2(joint2.min) : mmToM2(joint2.min) : void 0;
@@ -23976,20 +24443,20 @@ function urdfXml(spec, modelName, linkNameMap, jointNameMap, geometries, _linkWo
       const velocity = sourceOverrides?.velocity ?? joint2.velocity;
       const vel = velocity !== void 0 ? joint2.type === "revolute" ? degToRad2(velocity) : mmToM2(velocity) : 10;
       limitXml = `
-    <limit${lower2 !== void 0 ? ` lower="${formatNumber2(lower2)}"` : ""}${upper !== void 0 ? ` upper="${formatNumber2(upper)}"` : ""} effort="${formatNumber2(effort)}" velocity="${formatNumber2(vel)}"/>`;
+    <limit${lower2 !== void 0 ? ` lower="${formatNumber3(lower2)}"` : ""}${upper !== void 0 ? ` upper="${formatNumber3(upper)}"` : ""} effort="${formatNumber3(effort)}" velocity="${formatNumber3(vel)}"/>`;
     } else if (jType === "continuous") {
       const effort = sourceOverrides?.effort ?? joint2.effort ?? 100;
       const velocity = sourceOverrides?.velocity ?? joint2.velocity;
       const vel = velocity !== void 0 ? degToRad2(velocity) : 10;
       limitXml = `
-    <limit effort="${formatNumber2(effort)}" velocity="${formatNumber2(vel)}"/>`;
+    <limit effort="${formatNumber3(effort)}" velocity="${formatNumber3(vel)}"/>`;
     }
     let dynamicsXml = "";
     const damping = sourceOverrides?.damping ?? joint2.damping;
     const friction = sourceOverrides?.friction ?? joint2.friction;
     if (damping !== void 0 || friction !== void 0) {
       dynamicsXml = `
-    <dynamics${damping !== void 0 ? ` damping="${formatNumber2(damping)}"` : ""}${friction !== void 0 ? ` friction="${formatNumber2(friction)}"` : ""}/>`;
+    <dynamics${damping !== void 0 ? ` damping="${formatNumber3(damping)}"` : ""}${friction !== void 0 ? ` friction="${formatNumber3(friction)}"` : ""}/>`;
     }
     let mimicXml = "";
     const coupling = couplingByJoint.get(joint2.name);
@@ -23997,7 +24464,7 @@ function urdfXml(spec, modelName, linkNameMap, jointNameMap, geometries, _linkWo
       const primary = coupling.terms.reduce((a, b) => Math.abs(a.ratio) >= Math.abs(b.ratio) ? a : b);
       const leaderUrdfName = jointNameMap.get(`${primary.joint}_joint`);
       mimicXml = `
-    <mimic joint="${escapeXml2(leaderUrdfName)}" multiplier="${formatNumber2(primary.ratio)}" offset="${formatNumber2(coupling.offset)}"/>`;
+    <mimic joint="${escapeXml2(leaderUrdfName)}" multiplier="${formatNumber3(primary.ratio)}" offset="${formatNumber3(coupling.offset)}"/>`;
       if (coupling.terms.length > 1) {
         warnings.push(
           `Joint "${joint2.name}" coupling has ${coupling.terms.length} terms but URDF mimic only supports 1. Using primary term (ratio=${primary.ratio} from "${primary.joint}").`
@@ -25932,13 +26399,13 @@ function findCollisions(entries) {
   }
   return collisions;
 }
-function usage19() {
+function usage21() {
   console.error("Usage: forgecad check params <script.forge.js> [--samples N]");
   process.exit(1);
 }
 async function runParamCheckCli(argv = process.argv.slice(2)) {
   const scriptPath = argv[0];
-  if (!scriptPath) usage19();
+  if (!scriptPath) usage21();
   const samplesArg = argv.indexOf("--samples");
   const numSamples = samplesArg >= 0 ? parseInt(argv[samplesArg + 1], 10) : 8;
   const code = readFileSync21(resolve35(scriptPath), "utf-8");
@@ -26618,7 +27085,7 @@ function buildPrintCheckReport(objects, verifications, options) {
 }
 
 // cli/print-check.ts
-function usage20() {
+function usage22() {
   console.error(
     "Usage: forgecad check print <model.forge.js|asset.stl|asset.obj|asset.3mf|asset.step|asset.stp> [--json] [--output report.json] [--profile fdm-pla-0.4mm] [--param Key=Value]"
   );
@@ -26745,7 +27212,7 @@ function parseArgs10(argv) {
   }
   const positional = argv.filter((arg, index) => !consumed.has(index) && !arg.startsWith("-"));
   const scriptPath = positional[0];
-  if (!scriptPath) usage20();
+  if (!scriptPath) usage22();
   return {
     scriptPath,
     json,
@@ -27651,25 +28118,7 @@ async function writeSolverDebugIndex(root, scriptPath, bundles) {
 }
 
 // cli/test-run.ts
-var DEFAULT_EXACT_SPATIAL_OBJECT_LIMIT = 250;
-var SPATIAL_BBOX_PADDING = 0.1;
-var MAX_SPATIAL_COLLISION_LINES = 50;
 var MAX_COMPACT_OBJECT_NAMES = 24;
-function parseSpatialMode(argv, defaultMode) {
-  const consumed = /* @__PURE__ */ new Set();
-  const idx = argv.indexOf("--spatial");
-  if (idx === -1) return { mode: defaultMode, consumed, explicit: false };
-  consumed.add(idx);
-  const raw = argv[idx + 1];
-  if (!raw || raw.startsWith("-")) {
-    console.error("Missing value for --spatial. Expected bounded, exact, or off.");
-    process.exit(1);
-  }
-  consumed.add(idx + 1);
-  if (raw === "bounded" || raw === "exact" || raw === "off") return { mode: raw, consumed, explicit: true };
-  console.error(`Invalid --spatial value: ${raw}. Expected bounded, exact, or off.`);
-  process.exit(1);
-}
 function buildJourneyInspection(journeys) {
   return {
     journeys: Object.entries(journeys ?? {}).map(([id, journey]) => ({
@@ -27807,137 +28256,6 @@ function formatFeatureSummary(counts) {
   collect("imports", imports);
   return groups.join("  |  ");
 }
-function analyzeSpatial(entries, mode) {
-  const lines = [];
-  const _axisLabel = ["X", "Y", "Z"];
-  const dirLabels = {
-    0: ["LEFT of", "RIGHT of"],
-    1: ["IN FRONT of", "BEHIND"],
-    2: ["BELOW", "ABOVE"]
-  };
-  const allMin = [Infinity, Infinity, Infinity];
-  const allMax = [-Infinity, -Infinity, -Infinity];
-  for (const s of entries) {
-    for (let ax = 0; ax < 3; ax++) {
-      allMin[ax] = Math.min(allMin[ax], s.min[ax]);
-      allMax[ax] = Math.max(allMax[ax], s.max[ax]);
-    }
-  }
-  const sceneSize = Math.max(...allMax.map((v, i) => v - allMin[i]));
-  const proximityThreshold = sceneSize * 0.15;
-  const exactCollisionChecksEnabled = mode === "exact" || entries.length <= DEFAULT_EXACT_SPATIAL_OBJECT_LIMIT;
-  const collisionReport = analyzeCollisionIntersections(entries, {
-    bboxPadding: SPATIAL_BBOX_PADDING,
-    skipIntraGroup: true,
-    skipMockPairs: true,
-    includeBBoxCandidates: false,
-    ...exactCollisionChecksEnabled ? {} : { maxCandidatePairs: 0 }
-  });
-  if (!exactCollisionChecksEnabled && collisionReport.candidatePairCount > 0) {
-    lines.push(
-      `  Exact collision checks skipped for ${collisionReport.candidatePairCount} bbox-overlapping pair(s) in this ${entries.length}-object scene. Re-run with --spatial exact for exhaustive pairwise intersections.`
-    );
-  } else if (collisionReport.candidatePairCount > 0 && exactCollisionChecksEnabled) {
-    lines.push(
-      `  Exact collision checks: ${collisionReport.testedPairCount} bbox-overlapping pair(s) tested in ${collisionReport.exactCheckMs.toFixed(0)}ms.`
-    );
-  }
-  for (const collision of collisionReport.collisions.slice(0, MAX_SPATIAL_COLLISION_LINES)) {
-    lines.push(`  \u26A0 COLLISION: ${collision.sourceName} \u2229 ${collision.targetName} (shared vol: ${collision.overlapVolume.toFixed(1)}mm\xB3)`);
-  }
-  if (collisionReport.collisionCount > MAX_SPATIAL_COLLISION_LINES) {
-    lines.push(
-      `  ... ${collisionReport.collisionCount - MAX_SPATIAL_COLLISION_LINES} more collision(s) omitted; use --focus/--hide or inspect fit interference to narrow the scene.`
-    );
-  }
-  for (const warning of collisionReport.warnings) {
-    if (warning.includes("maxCandidatePairs=0")) continue;
-    lines.push(`  Warning: ${warning}`);
-  }
-  for (let i = 0; i < entries.length; i++) {
-    const a = entries[i];
-    const nearest = Array.from({ length: 6 }, () => ({ idx: -1, gap: Infinity }));
-    for (let j = 0; j < entries.length; j++) {
-      if (i === j) continue;
-      const b = entries[j];
-      for (let ax = 0; ax < 3; ax++) {
-        if (a.max[ax] < b.min[ax]) {
-          const gap = b.min[ax] - a.max[ax];
-          const d = ax * 2;
-          if (gap < nearest[d].gap) nearest[d] = { idx: j, gap };
-        } else if (b.max[ax] < a.min[ax]) {
-          const gap = a.min[ax] - b.max[ax];
-          const d = ax * 2 + 1;
-          if (gap < nearest[d].gap) nearest[d] = { idx: j, gap };
-        }
-      }
-    }
-    for (let d = 0; d < 6; d++) {
-      const n = nearest[d];
-      if (n.idx === -1 || n.gap > proximityThreshold) continue;
-      const b = entries[n.idx];
-      const ax = Math.floor(d / 2);
-      const isPositive = d % 2 === 0;
-      const label = isPositive ? dirLabels[ax][0] : dirLabels[ax][1];
-      lines.push(`  ${a.name} is ${label} ${b.name} (gap: ${n.gap.toFixed(0)}mm)`);
-    }
-  }
-  const seen = /* @__PURE__ */ new Set();
-  const deduped = [];
-  for (const line of lines) {
-    if (line.includes("COLLISION")) {
-      deduped.push(line);
-      continue;
-    }
-    const match = line.match(/^\s+(.+?) is (?:LEFT of|RIGHT of|IN FRONT of|BEHIND|BELOW|ABOVE) (.+?) \(gap: (\d+)mm\)/);
-    if (match) {
-      const key = [match[1], match[2]].sort().join("|") + "|" + match[3];
-      if (!seen.has(key)) {
-        seen.add(key);
-        deduped.push(line);
-      }
-    } else {
-      deduped.push(line);
-    }
-  }
-  const groups = /* @__PURE__ */ new Map();
-  for (const e of entries) {
-    if (!e.groupName) continue;
-    const g = groups.get(e.groupName) || { min: [Infinity, Infinity, Infinity], max: [-Infinity, -Infinity, -Infinity] };
-    for (let ax = 0; ax < 3; ax++) {
-      g.min[ax] = Math.min(g.min[ax], e.min[ax]);
-      g.max[ax] = Math.max(g.max[ax], e.max[ax]);
-    }
-    groups.set(e.groupName, g);
-  }
-  if (groups.size > 1) {
-    deduped.push("");
-    deduped.push("  Groups:");
-    const groupNames = [...groups.keys()];
-    for (let i = 0; i < groupNames.length; i++) {
-      const aName = groupNames[i], a = groups.get(aName);
-      for (let j = i + 1; j < groupNames.length; j++) {
-        const bName = groupNames[j], b = groups.get(bName);
-        for (let ax = 0; ax < 3; ax++) {
-          if (a.max[ax] < b.min[ax]) {
-            const gap = b.min[ax] - a.max[ax];
-            if (gap <= proximityThreshold) {
-              const label = dirLabels[ax][0];
-              deduped.push(`  ${aName} is ${label} ${bName} (gap: ${gap.toFixed(0)}mm)`);
-            }
-          } else if (b.max[ax] < a.min[ax]) {
-            const gap = a.min[ax] - b.max[ax];
-            if (gap <= proximityThreshold) {
-              const label = dirLabels[ax][1];
-              deduped.push(`  ${aName} is ${label} ${bName} (gap: ${gap.toFixed(0)}mm)`);
-            }
-          }
-        }
-      }
-    }
-  }
-  return deduped;
-}
 function parseParamFlags2(argv) {
   const overrides = {};
   const consumed = /* @__PURE__ */ new Set();
@@ -27956,9 +28274,9 @@ function parseParamFlags2(argv) {
   }
   return { overrides, consumed };
 }
-function usage21() {
+function usage23() {
   console.error(
-    "Usage: forgecad run <model.forge.js|asset.stl|asset.obj|asset.3mf|asset.step|asset.stp> [--details] [--history] [--features] [--connectivity] [--connectivity-tolerance <mm>] [--spatial bounded|exact|off] [--param Key=Value] [--debug-imports] [--verbose|-v] [--backend manifold|occt|truck] [--quality live|default|high] [--solver-profile] [--solver-debug-out <dir>]"
+    "Usage: forgecad run <model.forge.js|asset.stl|asset.obj|asset.3mf|asset.step|asset.stp> [--details] [--history] [--features] [--connectivity] [--connectivity-tolerance <mm>] [--param Key=Value] [--debug-imports] [--verbose|-v] [--backend manifold|occt|truck] [--quality live|default|high] [--solver-profile] [--solver-debug-out <dir>]"
   );
   process.exit(1);
 }
@@ -28115,7 +28433,13 @@ function printCompactObjectSummary(objects, focusSummary) {
 async function runScriptCli(argv = process.argv.slice(2)) {
   if (argv.includes("--full")) {
     console.error("`forgecad run --full` has been removed.");
-    console.error("Use explicit diagnostics: `--details --history --features --solver-profile --spatial bounded`.");
+    console.error("Use explicit diagnostics: `--details --history --features --solver-profile`.");
+    process.exit(1);
+  }
+  const removedSpatialFlag = argv.find((arg) => arg === "--spatial" || arg.startsWith("--spatial="));
+  if (removedSpatialFlag) {
+    console.error("`forgecad run --spatial` has been removed.");
+    console.error("Use `forgecad inspect fit interference <model>` for collision evidence or `forgecad inspect physical gaps <model>` for spatial gap evidence.");
     process.exit(1);
   }
   const { overrides: paramCliOverrides, consumed: paramConsumed } = parseParamFlags2(argv);
@@ -28142,12 +28466,11 @@ async function runScriptCli(argv = process.argv.slice(2)) {
   const explicitBackend = parseBackendArg2(argv);
   const quality = parseQualityArg2(argv);
   const solverDebugOut = parseRequiredArg(argv, "--solver-debug-out");
-  const { mode: spatialMode, consumed: spatialConsumed, explicit: spatialExplicit } = parseSpatialMode(argv, "off");
   const positional = argv.filter(
-    (arg, i) => !paramConsumed.has(i) && !focusConsumed.has(i) && !connectivityConsumed.has(i) && !spatialConsumed.has(i) && arg !== "--details" && arg !== "--history" && arg !== "--features" && arg !== "--solver-profile" && arg !== "--debug-imports" && arg !== "--journeys" && arg !== "--journeys-json" && arg !== "--verbose" && arg !== "-v" && arg !== "--backend" && argv[i - 1] !== "--backend" && arg !== "--quality" && argv[i - 1] !== "--quality" && arg !== "-q" && argv[i - 1] !== "-q" && arg !== "--solver-debug-out" && argv[i - 1] !== "--solver-debug-out"
+    (arg, i) => !paramConsumed.has(i) && !focusConsumed.has(i) && !connectivityConsumed.has(i) && arg !== "--details" && arg !== "--history" && arg !== "--features" && arg !== "--solver-profile" && arg !== "--debug-imports" && arg !== "--journeys" && arg !== "--journeys-json" && arg !== "--verbose" && arg !== "-v" && arg !== "--backend" && argv[i - 1] !== "--backend" && arg !== "--quality" && argv[i - 1] !== "--quality" && arg !== "-q" && argv[i - 1] !== "-q" && arg !== "--solver-debug-out" && argv[i - 1] !== "--solver-debug-out"
   );
   const scriptPath = positional[0];
-  if (!scriptPath) usage21();
+  if (!scriptPath) usage23();
   let activeBackend = CLI_DEFAULT_BACKEND;
   try {
     if (solverDebugOut) {
@@ -28319,8 +28642,7 @@ async function runScriptCli(argv = process.argv.slice(2)) {
         console.log(`  ${log.args.join(" ")}`);
       }
     }
-    const needsShapeEntries = connectivityEnabled || spatialMode !== "off";
-    const entries = needsShapeEntries ? visibleObjects.filter((o) => o.shape).map((o) => {
+    const entries = connectivityEnabled ? visibleObjects.filter((o) => o.shape).map((o) => {
       const bb = o.shape.boundingBox();
       return {
         id: o.id,
@@ -28340,18 +28662,6 @@ async function runScriptCli(argv = process.argv.slice(2)) {
       const connectivity = analyzePhysicalConnectivity2(entries, connectivityOptions);
       for (const line of formatPhysicalConnectivity(connectivity)) console.log(line);
     }
-    if (entries.length > 1 && spatialMode !== "off") {
-      console.log(`
-\u2713 Spatial analysis:`);
-      const spatialLines = analyzeSpatial(entries, spatialMode);
-      for (const line of spatialLines) console.log(line);
-      if (spatialLines.length === 0) {
-        console.log(`  (no collisions, all objects well-separated)`);
-      }
-    } else if (spatialExplicit && visibleObjects.filter((o) => o.shape).length > 1 && spatialMode === "off") {
-      console.log(`
-\u2713 Spatial analysis: skipped (--spatial off)`);
-    }
     console.log(
       `\u2713 Params: ${result.params.map((p) => {
         const label = p.choices ? `${p.choices[p.value]}` : `${p.value}`;
@@ -28512,7 +28822,7 @@ async function runScriptCli(argv = process.argv.slice(2)) {
 // cli/forge-render-section.ts
 import { writeFile as writeFile10 } from "fs/promises";
 import { basename as basename16, extname as extname11, resolve as resolve39 } from "path";
-function usage22() {
+function usage24() {
   console.error(
     "Usage: forgecad render section <model.forge.js|asset.stl|asset.obj|asset.3mf|asset.step|asset.stp> [output.svg|.png] [--param Key=Value] [--plane XY|XZ|YZ] [--offset <number>] [--size <px>] [--edges <off|thin|bold>] [--chrome-path <path>] [--background <color>]"
   );
@@ -28573,12 +28883,12 @@ async function runRenderSectionCli(argv = process.argv.slice(2)) {
       background = argv[++i];
     } else if (argv[i].startsWith("-")) {
       console.error(`Unknown option: ${argv[i]}`);
-      usage22();
+      usage24();
     } else {
       args.push(argv[i]);
     }
   }
-  if (args.length === 0) usage22();
+  if (args.length === 0) usage24();
   scriptPath = args[0];
   const wantsPng = args[1] ? extname11(args[1]).toLowerCase() === ".png" : false;
   outputPath = args[1] || defaultOutput(scriptPath, wantsPng ? "png" : "svg");
@@ -28919,7 +29229,7 @@ var RENDER_OPTIONS = [
     valueLabel: "<classic|studio|fast|glass|inspection|precision|hybrid|scan>",
     values: RENDER_STYLE_VALUES
   },
-  { name: "--scan-granularity", description: "Scan cells across the scene longest axis", argument: "required", valueLabel: "<12-72>" },
+  { name: "--scan-granularity", description: "Scan cells across the scene longest axis", argument: "required", valueLabel: "<12-144>" },
   { name: "--port", description: "Vite dev server port", argument: "required", valueLabel: "<n>" },
   { name: "--fresh-server", description: "Start a fresh renderer instead of reusing an existing one" },
   {
@@ -28931,6 +29241,51 @@ var RENDER_OPTIONS = [
   },
   { name: "--output", description: "Output file path", argument: "required", valueLabel: "<path>", valueKind: "png" }
 ];
+var LS_OPTIONS = [
+  { name: "--tree", description: "Print targets as a compact object tree" },
+  { name: "--long", description: "Include geometry metrics such as bounds, volume, area, bodies, and triangle counts" },
+  { name: "--json", description: "Print machine-readable target inventory" },
+  { name: "--compact", description: "Minify JSON output" },
+  {
+    name: "--kind",
+    description: "Filter targets by kind",
+    argument: "required",
+    valueLabel: "<shape|sketch|sdf|toolpath|mock|object>"
+  },
+  ...PARAM_OPTIONS,
+  {
+    name: "--backend",
+    description: "Geometry backend",
+    argument: "required",
+    valueLabel: "<manifold|occt|truck>",
+    values: BACKEND_VALUES
+  },
+  {
+    name: "--quality",
+    description: "Geometry quality preset",
+    argument: "required",
+    valueLabel: "<live|default|high>",
+    values: QUALITY_VALUES
+  }
+];
+var SHOW_OPTIONS = [
+  {
+    name: "--from",
+    description: "Quick camera direction",
+    argument: "required",
+    valueLabel: "<front|back|side|right|top|iso|az:el|az:el:dist>",
+    values: RENDER_ANGLE_VALUES
+  },
+  { name: "--out", description: "Output file path", argument: "required", valueLabel: "<path>", valueKind: "png" },
+  {
+    name: "--backend",
+    description: "Geometry backend",
+    argument: "required",
+    valueLabel: "<manifold|occt|truck>",
+    values: BACKEND_VALUES
+  },
+  ...RENDER_OPTIONS.filter((option) => option.name !== "--focus" && option.name !== "--hide")
+];
 var INSPECT_EVIDENCE_OPTIONS = [
   ...PARAM_OPTIONS,
   {
@@ -29972,13 +30327,61 @@ var commands = [
     hidden: true,
     run: async (args) => runHiddenCompletionCli(args, commands)
   },
+  {
+    group: "Modeling",
+    path: ["ls"],
+    summary: "List targetable scene objects for a model.",
+    description: "Runs the model headlessly and prints the exact object paths that CLI tools can target. Use this before focused renders or inspections when object names, groups, or assembly paths are not obvious.\n\nThe default output is a compact line-oriented list. Use `--tree` for an indented hierarchy, `--long` for geometry metrics, or `--json` for automation.",
+    usage: [
+      "forgecad ls <model.forge.js|asset.stl|asset.obj|asset.3mf|asset.step|asset.stp> [target] [--tree] [--long] [--json] [--kind shape,sketch,mock] [--param Key=Value] [--backend manifold|occt|truck] [--quality live|default|high]"
+    ],
+    examples: [
+      "forgecad ls examples/api/static-assembly-connectors.forge.js",
+      "forgecad ls examples/api/static-assembly-connectors.forge.js --tree",
+      "forgecad ls examples/api/static-assembly-connectors.forge.js Bench",
+      'forgecad ls examples/api/static-assembly-connectors.forge.js "Bench/Slat0" --long',
+      "forgecad ls examples/api/static-assembly-connectors.forge.js --json"
+    ],
+    completion: {
+      options: LS_OPTIONS,
+      positionals: [
+        { description: "Forge script or CAD asset", valueKind: "renderable" },
+        { description: "optional target path, object name, id, group, or glob" }
+      ]
+    },
+    run: runLsCli
+  },
+  {
+    group: "Modeling",
+    path: ["show"],
+    summary: "Render a quick target-focused viewport PNG.",
+    description: "The main quick visual path for agents. Pass a model and, optionally, a target path from `forgecad ls`; ForgeCAD resolves the target and renders that object or group through the existing viewport renderer. Use `--from` for fast camera directions, or pass the lower-level render camera flags when you need exact reproducibility.\n\nWithout a target, `show` renders the whole scene and behaves like a shorter, intent-first wrapper around `render 3d`.",
+    usage: [
+      "forgecad show <model.forge.js|asset.stl|asset.obj|asset.3mf|asset.step|asset.stp> [target] [output.png] [--from front|back|side|right|top|iso|az:el|az:el:dist] [--out output.png] [--param Key=Value] [--backend manifold|occt|truck] [render options]"
+    ],
+    examples: [
+      "forgecad show examples/api/static-assembly-connectors.forge.js",
+      "forgecad show examples/api/static-assembly-connectors.forge.js Bench",
+      'forgecad show examples/api/static-assembly-connectors.forge.js "Bench/Slat0" --from front --out slat-front.png',
+      'forgecad show model.forge.js --camera "proj=perspective;pos=200,-160,120;target=0,0,20;up=0,0,1;fov=38"'
+    ],
+    completion: {
+      options: SHOW_OPTIONS,
+      positionals: [
+        { description: "Forge script or CAD asset", valueKind: "renderable" },
+        { description: "optional target path, object name, id, group, or glob" },
+        { description: "output PNG path", valueKind: "png" }
+      ]
+    },
+    run: runShowCli
+  },
   {
     group: "Modeling",
     path: ["run"],
-    summary: "Execute a Forge script quickly and print the inner-loop build summary: returned objects, verification results, parameters, and timing.",
-    description: "The fast validation command. Runs your script with the real geometry kernel (no browser needed) and reports whether it built, which objects came back, any `verify.*` results, parameter values, script logs, and elapsed script time. This is the command agents should run frequently while editing a model.\n\n**Fast by default** \u2014 a bare `forgecad run model.forge.js` does not compute per-object volumes, bounding boxes, construction history, feature tallies, spatial relationships, collision intersections, or solver profiles. Those diagnostics are useful, but they are no longer part of the hot path.\n\n**Opt-in diagnostics** \u2014 use `--details` for volume/bounding-box/object geometry summaries, `--history` for the construction tree, `--features` for feature tallies, or `--solver-profile` for constraint solver timing. Use `--spatial bounded|exact` only when you want directional relationships and collision intersections from the run command itself.\n\n**Verification results** \u2014 runs any `verify.*` checks in the script and reports pass/fail with expected vs actual values. Verification failures remain non-fatal so the model can still render and be inspected.\n\n**Physical connectivity** \u2014 pass `--connectivity` to list physically connected components across visible objects. Overlapping bbox candidates are checked with exact geometry by default, while bbox-only contact is treated as evidence rather than proof of one connected component. This helps answer whether the model is one continuous assembly or several separate islands.\n\n**Quality preset** \u2014 pass `--quality live|default|high` to select the same geometry quality profile used by the editor and export tools. `live` is the fastest preset for large audit models.\n\n**Direct CAD inputs** \u2014 pass `.stl`, `.obj`, `.3mf`, `.step`, or `.stp` directly when you just want to inspect an external asset. Mesh files are imported with `importMesh(...)`; STEP/STP files are imported with `importStep(...)` and auto-select OCCT unless you pass `--backend`.\n\nFor deeper confidence gates, prefer `forgecad inspect mechanical-integrity`, `forgecad check print`, or targeted evidence commands such as `forgecad inspect fit interference` instead of turning `run` back into a catch-all audit command.",
+    summary: "Execute a Forge script quickly and print the inner-loop build summary: build count, verification results, parameters, and timing.",
+    description: "The fast validation command. Runs your script with the real geometry kernel (no browser needed) and reports whether it built, how many objects came back, any `verify.*` results, parameter values, script logs, and elapsed script time. This is the command agents should run frequently while editing a model.\n\n**Fast by default** \u2014 a bare `forgecad run model.forge.js` does not compute per-object volumes, bounding boxes, construction history, feature tallies, or solver profiles. Those run diagnostics are useful, but they are no longer part of the hot path.\n\n**Opt-in diagnostics** \u2014 use `--details` for volume/bounding-box/object geometry summaries, `--history` for the construction tree, `--features` for feature tallies, or `--solver-profile` for constraint solver timing. Use `inspect fit interference`, `inspect physical gaps`, or `inspect mechanical-integrity --collisions` for spatial and collision evidence.\n\n**Verification results** \u2014 runs any `verify.*` checks in the script and reports pass/fail with expected vs actual values. Verification failures remain non-fatal so the model can still render and be inspected.\n\n**Physical connectivity** \u2014 pass `--connectivity` to list physically connected components across visible objects. Overlapping bbox candidates are checked with exact geometry by default, while bbox-only contact is treated as evidence rather than proof of one connected component. This helps answer whether the model is one continuous assembly or several separate islands.\n\n**Quality preset** \u2014 pass `--quality live|default|high` to select the same geometry quality profile used by the editor and export tools. `live` is the fastest preset for large audit models.\n\n**Direct CAD inputs** \u2014 pass `.stl`, `.obj`, `.3mf`, `.step`, or `.stp` directly when you just want to inspect an external asset. Mesh files are imported with `importMesh(...)`; STEP/STP files are imported with `importStep(...)` and auto-select OCCT unless you pass `--backend`.\n\nFor deeper confidence gates, prefer `forgecad inspect mechanical-integrity`, `forgecad check print`, or targeted evidence commands such as `forgecad inspect fit interference` instead of turning `run` back into a catch-all audit command.",
     usage: [
-      "forgecad run <model.forge.js|asset.stl|asset.obj|asset.3mf|asset.step|asset.stp> [--details] [--history] [--features] [--connectivity] [--connectivity-tolerance <mm>] [--spatial bounded|exact|off] [--focus [names]] [--hide names] [--journeys] [--journeys-json] [--param Key=Value] [--debug-imports] [--verbose] [--backend manifold|occt|truck] [--quality live|default|high] [--solver-profile] [--solver-debug-out <dir>]"
+      "forgecad run <model.forge.js|asset.stl|asset.obj|asset.3mf|asset.step|asset.stp> [--details] [--history] [--features] [--connectivity] [--connectivity-tolerance <mm>] [--focus [names]] [--hide names] [--journeys] [--journeys-json] [--param Key=Value] [--debug-imports] [--verbose] [--backend manifold|occt|truck] [--quality live|default|high] [--solver-profile] [--solver-debug-out <dir>]"
     ],
     examples: [
       "forgecad run examples/api/static-assembly-connectors.forge.js",
@@ -29986,7 +30389,6 @@ var commands = [
       'forgecad run examples/api/static-assembly-connectors.forge.js --focus "Bench.Slat*"',
       'forgecad run examples/api/static-assembly-connectors.forge.js --hide "Bench.Slat0,Bench.Slat1"',
       "forgecad run examples/api/static-assembly-connectors.forge.js --details --history",
-      "forgecad run examples/api/static-assembly-connectors.forge.js --spatial bounded",
       "forgecad run examples/products/cup.forge.js --connectivity",
       "forgecad run examples/products/cup.forge.js --journeys",
       "forgecad run examples/products/cup.forge.js --backend occt",
@@ -30017,17 +30419,6 @@ var commands = [
           argument: "required",
           valueLabel: "<mm>"
         },
-        {
-          name: "--spatial",
-          description: "Spatial diagnostics mode (default: off)",
-          argument: "required",
-          valueLabel: "<bounded|exact|off>",
-          values: [
-            { value: "bounded", description: "Exact checks only for bounded scene sizes" },
-            { value: "exact", description: "Exhaustive pairwise exact collision intersections" },
-            { value: "off", description: "Skip spatial diagnostics" }
-          ]
-        },
         { name: "--debug-imports", description: "Print the import trace" },
         { name: "--journeys", description: "Print model journey summaries declared with scene({ journeys })" },
         { name: "--journeys-json", description: "Emit machine-readable journey metadata and diagnostics only" },
@@ -30147,7 +30538,9 @@ var commands = [
     path: ["render", "wireframe"],
     summary: "Render a Forge scene as a wireframe (edges only, no shading).",
     description: "Same as `render 3d` but renders only the edge geometry \u2014 no shaded surfaces. Useful for construction-style documentation or highlighting structural features without material detail.",
-    usage: ["forgecad render wireframe <model.forge.js|asset.stl|asset.obj|asset.3mf|asset.step|asset.stp> [output.png] [--param Key=Value] [options]"],
+    usage: [
+      "forgecad render wireframe <model.forge.js|asset.stl|asset.obj|asset.3mf|asset.step|asset.stp> [output.png] [--param Key=Value] [options]"
+    ],
     examples: [
       "forgecad render wireframe examples/products/cup.forge.js",
       "forgecad render wireframe examples/products/cup.forge.js --camera iso"
@@ -30198,7 +30591,9 @@ var commands = [
     path: ["render", "hq"],
     summary: "High-quality render via Blender Cycles \u2014 path-traced, HDRI, material presets.",
     description: "Exports the scene to Blender and renders with Cycles (path tracer). Requires Blender installed and on PATH.\n\nChoose a `--preset` for the look: `studio` (neutral product shot), `dramatic` (high-contrast), `clay` (matte, no color), `glass`, `metallic`, `toon`, `xray`, `normals`, `silhouette`, and more. Control quality vs speed with `--samples` (default 256). Use `--view`, `--camera`, `--camera-json`, or `--scene <file>` for still camera control, matching `render 3d`. Use `--transparent` for a transparent background (compositing-ready).\n\nOutput defaults to `<script-name>-hq.png`. Great for documentation, marketing renders, and social media.",
-    usage: ["forgecad render hq <model.forge.js|asset.stl|asset.obj|asset.3mf|asset.step|asset.stp> [output.png] [--param Key=Value] [options]"],
+    usage: [
+      "forgecad render hq <model.forge.js|asset.stl|asset.obj|asset.3mf|asset.step|asset.stp> [output.png] [--param Key=Value] [options]"
+    ],
     examples: [
       "forgecad render hq examples/products/cup.forge.js",
       "forgecad render hq examples/products/cup.forge.js hero.png --preset dramatic --samples 1024",
@@ -31461,7 +31856,9 @@ var commands = [
     path: ["inspect", "replay"],
     summary: "Replay a saved section inspection result on a source model.",
     description: "Reads a previous `forgecad inspect section` result, reruns the same section and ray rulers on the requested source, and writes a fresh unique result directory with measurement deltas against the original.",
-    usage: ["forgecad inspect replay <result.json> --source <model.forge.js|asset.stl|asset.obj|asset.3mf|asset.step|asset.stp> [--param Key=Value] [options]"],
+    usage: [
+      "forgecad inspect replay <result.json> --source <model.forge.js|asset.stl|asset.obj|asset.3mf|asset.step|asset.stp> [--param Key=Value] [options]"
+    ],
     examples: [
       "forgecad inspect replay outputs/inspect/2026-05-28T14-32-09.184Z__section__bearing__a8f3c1/result.json --source submission/main.forge.js"
     ],
@@ -31671,7 +32068,7 @@ var commands = [
         { name: "--update", description: "Regenerate compiler snapshots" }
       ]
     },
-    run: async (args) => (await import("./check-compiler-LOXCPEOI.js")).runCheckCompilerCli(args)
+    run: async (args) => (await import("./check-compiler-U5SOPN7X.js")).runCheckCompilerCli(args)
   },
   {
     group: "Checks",
@@ -31694,7 +32091,7 @@ var commands = [
         { name: "--update", description: "Regenerate query-propagation snapshots" }
       ]
     },
-    run: async (args) => (await import("./check-query-propagation-BAKNVWXR.js")).runCheckQueryPropagationCli(args)
+    run: async (args) => (await import("./check-query-propagation-XOKNSSYU.js")).runCheckQueryPropagationCli(args)
   },
   {
     group: "Checks",
@@ -31929,64 +32326,37 @@ function readVersion() {
     return "0.0.0";
   }
 }
-var AUTH_EXEMPT_COMMANDS = /* @__PURE__ */ new Set([
-  "signup",
-  "login",
-  "logout",
-  "whoami",
-  "completion",
-  "__complete",
-  "doctor",
-  "studio",
-  "dev",
-  "web",
-  // Local model validation must stay available to agents and CI-like repo workflows
-  // without requiring a hosted account. Hosted project, publish, and paid export
-  // commands still go through the auth/tier path.
-  "run",
-  "render",
-  "render 3d",
-  "render wireframe",
-  "render views",
-  "render section",
-  "render sketch",
-  "compare 3d",
-  "debug assembly",
-  "debug compiler",
-  "debug dimensions",
-  "debug faces",
-  "check print",
-  "inspect",
-  "inspect evidence",
-  "inspect history",
-  "inspect design-trace",
-  "inspect section",
-  "inspect replay",
-  "inspect visual",
-  "inspect visual image",
-  "inspect visual cutaway",
-  "inspect visual depth",
-  "inspect visual normals",
-  "inspect visual objects",
-  "inspect surface",
-  "inspect surface zebra",
-  "inspect surface roughness",
-  "inspect physical",
-  "inspect physical components",
-  "inspect physical floating",
-  "inspect physical gaps",
-  "inspect fit",
-  "inspect fit interference",
-  "inspect manufacture",
-  "inspect manufacture thickness",
-  "inspect compare",
-  "inspect compare overlay",
-  "inspect sections at",
-  "inspect sections stack",
-  "inspect sections sample",
-  "inspect mechanical-integrity",
-  "project file",
-  "project shares"
+var AUTH_REQUIRED_COMMANDS = /* @__PURE__ */ new Set([
+  // Hosted project, publish, token, and account-license mutations touch ForgeCAD server state.
+  // Local modeling, inspection, export, and skill setup commands stay available without sign-in.
+  "project init",
+  "project clone",
+  "project pull",
+  "project push",
+  "project status",
+  "project list",
+  "project publish",
+  "project info",
+  "project rename",
+  "project set-visibility",
+  "project delete",
+  "project members",
+  "project add-member",
+  "project remove-member",
+  "project set-role",
+  "project file list",
+  "project file read",
+  "project file save",
+  "project file delete",
+  "project file rename",
+  "project file mkdir",
+  "project file copy",
+  "project shares list",
+  "project shares delete",
+  "token create",
+  "token list",
+  "token revoke",
+  "license activate"
 ]);
 var LONG_RUNNING_COMMANDS = /* @__PURE__ */ new Set(["dev", "studio", "web"]);
 var INTERNAL_CHECK_COMMANDS = /* @__PURE__ */ new Set([
@@ -32036,6 +32406,8 @@ var TOPIC_DESCRIPTIONS = {
 };
 var ROOT_WORKFLOWS = [
   ["forgecad run <model.forge.js>", "Execute a model and print the inner-loop build summary."],
+  ["forgecad ls <model.forge.js>", "List targetable object paths before narrowing a render or inspection."],
+  ["forgecad show <model.forge.js> [target]", "Render a quick viewport PNG for the whole scene or a target."],
   ["forgecad check print <model.forge.js>", "Catch printability problems before export."],
   ["forgecad render 3d <model.forge.js> --output preview.png", "Render a viewport PNG."],
   ["forgecad export step <model.forge.js> --output part.step", "Export exact CAD for downstream tools."],
@@ -32045,7 +32417,7 @@ var ROOT_HELP_GROUPS = [
   { heading: "Studio", paths: [["studio"], ["dev"], ["web"]] },
   {
     heading: "Modeling",
-    paths: [["run"], ["render"], ["capture"], ["check"], ["compare"], ["inspect"]]
+    paths: [["run"], ["ls"], ["show"], ["render"], ["capture"], ["check"], ["compare"], ["inspect"]]
   },
   { heading: "Export", paths: [["export"], ["cut-list"], ["link"]] },
   {
@@ -32073,7 +32445,7 @@ function commandKey(commandPath) {
   return commandPath.join(" ");
 }
 function commandRequiresCliAuth(commandPath) {
-  return !AUTH_EXEMPT_COMMANDS.has(commandKey(commandPath));
+  return AUTH_REQUIRED_COMMANDS.has(commandKey(commandPath));
 }
 function isLongRunningCommand(commandPath) {
   return LONG_RUNNING_COMMANDS.has(commandKey(commandPath));
@@ -32505,7 +32877,11 @@ function printMovedSharesTopicMessage(argv) {
 }
 function printRemovedRunFullFlagMessage() {
   console.error("`forgecad run --full` has been removed.");
-  console.error("Use explicit diagnostics: `--details --history --features --solver-profile --spatial bounded`.");
+  console.error("Use explicit diagnostics: `--details --history --features --solver-profile`.");
+}
+function printRemovedRunSpatialFlagMessage() {
+  console.error("`forgecad run --spatial` has been removed.");
+  console.error("Use `forgecad inspect fit interference <model>` for collision evidence or `forgecad inspect physical gaps <model>` for spatial gap evidence.");
 }
 function printInternalCheckCommandMessage(commandName) {
   if (commandName === "params") {
@@ -32618,6 +32994,11 @@ async function runForgeCadCli(argv = process.argv.slice(2)) {
     process.exitCode = 1;
     return;
   }
+  if (argv[0] === "run" && argv.some((arg) => arg === "--spatial" || arg.startsWith("--spatial=")) && !argv.some(isHelpFlag)) {
+    printRemovedRunSpatialFlagMessage();
+    process.exitCode = 1;
+    return;
+  }
   const wantsHelp = argv.some(isHelpFlag);
   const wantsVersion = argv[0] === "-v" || argv[0] === "--version";
   const skipUpdateMachinery = argv[0] === "__complete" || argv[0] === "completion" || wantsVersion || wantsHelp;