sceneview-mcp 4.0.10 → 4.0.12

package/README.md

@@ -45,6 +45,17 @@ Restart Claude Desktop after saving.
 
 ### Claude Code
 
+Two options.
+
+**Recommended — install the [SceneView Claude Code plugin](https://github.com/sceneview/claude-marketplace)** to get this MCP server **plus** 11 namespaced contributor commands and cross-platform reminder hooks in one shot:
+
+```bash
+/plugin marketplace add sceneview/claude-marketplace
+/plugin install sceneview@sceneview
+```
+
+**Or — just the MCP server** (lighter, no commands or hooks):
+
 ```bash
 claude mcp add sceneview -- npx -y sceneview-mcp
 ```

package/dist/analyze-project.js

@@ -21,9 +21,16 @@
  */
 import { promises as fs } from "node:fs";
 import path from "node:path";
+import { LATEST_SCENEVIEW_RELEASE } from "./generated/version.js";
 // ─── Constants ───────────────────────────────────────────────────────────────
-/** The latest SceneView release known to this build of the MCP. */
-export const LATEST_SCENEVIEW_VERSION = "4.0.0";
+/**
+ * The latest SceneView release known to this build of the MCP, snapshotted
+ * from the root `gradle.properties:VERSION_NAME` at build time via
+ * `scripts/generate-version.js`. See #941 — pre-fix this was hardcoded to
+ * "4.0.0" and never bumped, so every install of every MCP version told the
+ * LLM that "4.0.0" was current even when the real SDK was at 4.0.9.
+ */
+export const LATEST_SCENEVIEW_VERSION = LATEST_SCENEVIEW_RELEASE;
 /** Hard cap on the number of source files inspected per call. */
 export const MAX_FILES_SCANNED = 30;
 /** Hard cap on total bytes read across all source files per call (500 KB). */

package/dist/artifact.js

@@ -12,7 +12,7 @@
 //   - scene: multi-model 3D scene with lighting and environment (Filament.js)
 //   - product-360: product turntable with hotspot annotations (Filament.js)
 // ─── Constants ───────────────────────────────────────────────────────────────
-const FILAMENT_CDN = "https://cdn.jsdelivr.net/npm/filament@1.70.1/filament.js";
+const FILAMENT_CDN = "https://cdn.jsdelivr.net/npm/filament@1.70.2/filament.js";
 const DEFAULT_MODEL = "https://raw.githubusercontent.com/KhronosGroup/glTF-Sample-Assets/main/Models/DamagedHelmet/glTF-Binary/DamagedHelmet.glb";
 const DEFAULT_COLORS = [
     "#4285F4", "#EA4335", "#FBBC04", "#34A853", "#FF6D01",

package/dist/debug-issue.js

@@ -1,9 +1,4 @@
-/**
- * debug-issue.ts
- *
- * Targeted debugging guide for common SceneView issues.
- * Given a symptom, returns a focused diagnostic checklist.
- */
+import { LATEST_SCENEVIEW_RELEASE } from "./generated/version.js";
 export const DEBUG_CATEGORIES = [
     "model-not-showing",
     "ar-not-working",
@@ -305,7 +300,7 @@ fun DebugModelViewer() {
         title: "Build / Gradle Errors",
         guide: `## Debugging: Build Errors
 
-### "Cannot resolve io.github.sceneview:sceneview:4.0.0"
+### "Cannot resolve io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}"
 
 1. Check repositories in \`settings.gradle.kts\`:
    \`\`\`kotlin
@@ -348,7 +343,7 @@ SceneView bundles Filament. If you also depend on Filament directly:
 \`\`\`kotlin
 // Remove direct Filament dependency — SceneView includes it
 // implementation("com.google.android.filament:filament-android:1.x.x") // REMOVE
-implementation("io.github.sceneview:sceneview:4.0.0") // This includes Filament
+implementation("io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}") // This includes Filament
 \`\`\`
 
 ### "Cannot find Filament material"
@@ -672,10 +667,40 @@ export function autoDetectIssue(description) {
     if (lower.includes("wrong thread") || lower.includes("off main thread") || lower.includes("dispatchers.io") || lower.includes("background thread")) {
         return "crash";
     }
-    if (lower.includes("not showing") || lower.includes("invisible") || lower.includes("can't see") || lower.includes("model doesn't appear") || lower.includes("model not visible") || lower.includes("nothing shows up") || lower.includes("model is null") || lower.includes("remembermodelinstance returns null")) {
+    if (lower.includes("not showing") || lower.includes("invisible") || lower.includes("can't see") || lower.includes("model doesn't appear") || lower.includes("model not visible") || lower.includes("nothing shows up") || lower.includes("model is null") || lower.includes("remembermodelinstance returns null") || lower.includes("no model")) {
         return "model-not-showing";
     }
-    if (lower.includes("ar not") || lower.includes("ar doesn't") || lower.includes("arcore") || lower.includes("plane") || lower.includes("anchor") || lower.includes("camera permission") || lower.includes("augmented reality") || lower.includes("hit test") || lower.includes("hitresult")) {
+    // AR-not-working catches "the AR camera feed is dark" and the half-dozen
+    // ways a user describes a non-functional AR session. Pre-#940 only "ar not",
+    // "ar doesn't", and the technical terms (arcore/plane/anchor/hit test)
+    // matched — the natural phrasings "ar camera is black", "my AR is black",
+    // "ARScene shows nothing", etc. fell through to null.
+    //
+    // The regex `\b(ar|arscene|arsceneview|arcore)\b.*\b(black|dark)\b` catches
+    // any sentence where "AR" (in any of its forms) and a "no signal" keyword
+    // both appear, independent of the connecting words ("is", "feed is",
+    // "camera was", etc.). "dark" is added per the #940 review — "AR mode is
+    // dark" / "AR feed dimmed" are common synonyms users reach for.
+    //
+    // The bare `\bcamera\b.*\b(black|dark)\b` check is NOW gated on the
+    // sentence containing an AR-flavoured token — without that gate it
+    // false-positives on "the orbit camera in my 3D scene renders a black
+    // background" (a 3D-only issue that should route to model-not-showing
+    // or material). Caught by the #940 follow-up review.
+    const hasArContext = /\b(ar|arscene|arsceneview|arcore|arkit|arcore)\b/.test(lower)
+        || lower.includes("augmented reality");
+    const arBlackHints = (hasArContext && /\b(black|dark|dimmed)\b/.test(lower))
+        || /\b(ar|arscene|arsceneview|arcore)\b.*\b(black|dark|dimmed)\b/.test(lower);
+    if (lower.includes("ar not") ||
+        lower.includes("ar doesn't") ||
+        lower.includes("arcore") ||
+        lower.includes("plane") ||
+        lower.includes("anchor") ||
+        lower.includes("camera permission") ||
+        lower.includes("augmented reality") ||
+        lower.includes("hit test") ||
+        lower.includes("hitresult") ||
+        arBlackHints) {
         return "ar-not-working";
     }
     if (lower.includes("crash") || lower.includes("sigabrt") || lower.includes("native crash") || lower.includes("fatal") || lower.includes("exception") || lower.includes("destroy") || lower.includes("double free") || lower.includes("segfault") || (lower.includes("oom") && !lower.includes("zoom")) || lower.includes("out of memory") || lower.includes("nullpointerexception") || lower.includes("npe")) {

package/dist/extra-guides.js

@@ -3,6 +3,7 @@
  *
  * Material, collision, model optimization, and web rendering guides.
  */
+import { LATEST_SCENEVIEW_RELEASE } from "./generated/version.js";
 // ─── Material Guide ─────────────────────────────────────────────────────────
 export const MATERIAL_GUIDE = `# SceneView Material & Shader Guide
 
@@ -406,7 +407,7 @@ export const WEB_RENDERING_GUIDE = `# SceneView Web Rendering Guide (Filament.js
 
 ## Architecture
 
-SceneView Web uses **Filament.js v1.70.1** — Google's Filament engine compiled to WebAssembly. This is the **same PBR rendering engine** as SceneView Android, ensuring visual parity.
+SceneView Web uses **Filament.js v1.70.2** — Google's Filament engine compiled to WebAssembly. This is the **same PBR rendering engine** as SceneView Android, ensuring visual parity.
 
 \`\`\`
 Browser → WebGL2 → Filament.js (WASM) → GPU
@@ -419,7 +420,7 @@ Browser → WebGL2 → Filament.js (WASM) → GPU
 ### Using sceneview.js (npm or local)
 \`\`\`html
 <!-- Option 1: npm CDN -->
-<script src="https://cdn.jsdelivr.net/npm/sceneview-web@4.0.0/sceneview.js"></script>
+<script src="https://cdn.jsdelivr.net/npm/sceneview-web@${LATEST_SCENEVIEW_RELEASE}/sceneview-web.js"></script>
 
 <!-- Option 2: local hosting (recommended for production) -->
 <!-- Copy js/filament/ directory to your server for faster WASM loading -->
@@ -517,7 +518,7 @@ camera {
 
 | Feature | SceneView (Filament.js) | model-viewer |
 |---------|------------------------|--------------|
-| **Engine** | Filament v1.70.1 WASM | Filament WASM (same engine) |
+| **Engine** | Filament v1.70.2 WASM | Filament WASM (same engine) |
 | **Bundle size** | ~215KB JS + 3.3MB WASM | ~800 KB (subset) |
 | **Procedural geometry** | Yes (cubes, spheres, etc.) | No |
 | **Custom materials** | Yes (full Filament API) | Limited |

package/dist/generate-scene.js

@@ -1,11 +1,3 @@
-/**
- * generate-scene.ts
- *
- * Generates a complete SceneView{} or ARSceneView{} composable from a text description.
- * Maps common objects/concepts to SceneView node types and builds compilable code.
- *
- * All generated code targets SceneView v4.0.0 API and is verified against llms.txt.
- */
 const OBJECT_MAPPINGS = [
     // Furniture
     { keywords: ["table"], nodeType: "CubeNode", geometryType: "cube", defaultScale: 1.0, defaultPosition: [0, 0.4, 0], color: "Color(0.55f, 0.35f, 0.17f)", comment: "Table (flat cube)" },
@@ -245,7 +237,7 @@ export function generateScene(description) {
     }
     // Build the code
     const isAR = parsed.isAR;
-    dependencies.push(isAR ? "io.github.sceneview:arsceneview:4.0.0" : "io.github.sceneview:sceneview:4.0.0");
+    dependencies.push(isAR ? "io.github.sceneview:arsceneview:${LATEST_SCENEVIEW_RELEASE}" : "io.github.sceneview:sceneview:${LATEST_SCENEVIEW_RELEASE}");
     // Build model instance declarations
     const modelElements = elements.filter((e) => e.type === "model");
     const uniqueModels = new Map();