@deepblend/dsh-blender-host 0.9.0 → 0.11.0

package/lib/assembly-changes.js

@@ -0,0 +1,21 @@
+/** Describe saved object-origin moves and changed generators, not surface clearances. */
+import { canonicalStringify } from '@deepblend/dsh-blender-contracts'
+export function assemblyPlacementChanges(before, after, fromRevision, toRevision) {
+  const previous = new Map(before.entities.map(entity => [entity.id, entity]))
+  const groups = new Map()
+  const generatorChangedEntityIds = []
+  for (const entity of after.entities) {
+    const original = previous.get(entity.id)
+    if (!original) continue
+    if (canonicalStringify(entity.generator) !== canonicalStringify(original.generator)) generatorChangedEntityIds.push(entity.id)
+    const from = original.transform?.location ?? [0, 0, 0]
+    const to = entity.transform?.location ?? [0, 0, 0]
+    const deltaMm = to.map((value, axis) => Number(((value - from[axis]) * 1000).toFixed(9)))
+    if (deltaMm.every(value => value === 0)) continue
+    const key = JSON.stringify(deltaMm)
+    if (!groups.has(key)) groups.set(key, { deltaMm, entityIds: [] })
+    groups.get(key).entityIds.push(entity.id)
+  }
+  return { source: 'saved-scene-spec', coordinateField: 'entity.transform.location',
+    fromRevision, toRevision, groups: [...groups.values()], generatorChangedEntityIds }
+}

package/lib/geometry-inspection.js

@@ -63,16 +63,29 @@ export async function inspectRevisionGeometry(host, projectId, revision, selecti
     if (fileSha256(snapshot) !== expected) refuse(BlenderErrorCode.SCENE_VALIDATION_FAILED, 'the staged native input differs from the saved source.')
     const result = await host.runtime.inspectGeometry(request)
     cancelled(signal)
+    if (selection.surfaceSamples !== undefined && result?.report?.schemaVersion === 'deepblend.geometry-inspection/v1') {
+      refuse(BlenderErrorCode.RUNTIME_UNAVAILABLE, 'the runtime does not support local surface samples; upgrade DeepBlend. Ordinary native geometry reads remain available.')
+    }
     const native = verifyGeometryReport(result?.report, request)
     verifySource()
-    return { schemaVersion: 'deepblend.scene-geometry/v1', projectId, sourceRevision: revision,
+    const hasSamples = selection.surfaceSamples !== undefined
+    return { schemaVersion: hasSamples ? 'deepblend.scene-geometry/v2' : 'deepblend.scene-geometry/v1', projectId, sourceRevision: revision,
       sourceDigest: digest, sourceSpecHash: manifest.specHashAfter, sourceCheckpointSha256: expected,
       sourceUnchanged: true, frame: native.frame, objects: native.objects, blenderVersion: native.blenderVersion,
-      excludedMeasurements: ['wallThickness', 'shellToLinerClearance', 'minimumClearance', 'collision'],
+      ...(hasSamples ? { surfaceSamples: native.surfaceSamples } : {}),
+      excludedMeasurements: hasSamples ? ['globalWallThickness', 'assemblyClearance', 'minimumClearance', 'collision', 'selfIntersection'] :
+        ['wallThickness', 'shellToLinerClearance', 'minimumClearance', 'collision'],
       execution: { transport: 'batch' }, limitations: [
         'World-axis spans include rotations, handles and protrusions; they are not intrinsic body dimensions.',
         'This evaluates saved native mesh geometry, not shader displacement or rendered pixels.',
-        'No wall thickness, clearance, collision, topology or artistic approval is established.',
+        ...(hasSamples ? [
+          'Surface samples are finite local chords along evaluated triangle-face normals, not shader or smoothed shading normals.',
+          'The normalSurfaceChordMm runs from source entry to source exit. Target normalRaySeparationMm runs from source EXIT to target entry along that inward normal and excludes the source chord. Other scene objects are not checked; this is not full assembly free clearance.',
+          'Closed connected consistently wound positive-volume geometry is required, but absence of self-intersections is not certified.',
+          'No global minimum wall thickness, minimum clearance, collision absence, manufacturing safety or artistic approval is established.',
+          'Unmeasured, missed, overlapping, occluded or unsupported samples must remain unavailable, never be replaced by zero or inferred from bounds.',
+          'Search distance is explicitly requested (0.01–500 mm); chord and target search limits are each 100 mm. Epsilon is 0.0001 mm; distances at or below twice epsilon are unavailable.',
+        ] : ['No wall thickness, clearance, collision, topology or artistic approval is established.']),
         'Do not subtract shell and liner extents or radii to report a gap: both bounds describe outer surfaces, and their difference includes wall material and depends on curvature and orientation.',
         'Unchanged height, position or scale does not prove that wall thickness or clearance was preserved. Report those conditions as unmeasured unless a separate surface measurement verifies them.',
       ] }

package/lib/index.js

@@ -27,6 +27,7 @@
 
 import { assertRuntimeSceneFeatures } from './runtime-scene-features.js'
 import { readRecipeContext } from './recipe-state.js'
+import { assemblyPlacementChanges } from './assembly-changes.js'
 import { instantiateRecipeLock, planRecipeGeometryEdit, recipeGeometryParameters } from '@deepblend/dsh-blender-contracts'
 import { Service } from '@deepseek-ai/cordis'
 import z from '@deepseek-ai/schemastery'
@@ -671,7 +672,7 @@ export default class BlenderStudio extends Service {
     const digest = sceneSpecDigest(spec)
     return {
       ...toCanonicalProjectSummary({
-        record: { ...record, goal: spec.project.goal ?? null },
+        record: { ...record, projectsRoot: this.projectsRoot, goal: spec.project.goal ?? null },
         revisionCount: record.revisionCount ?? this.store.listRevisions(projectId).length,
         sceneSummary: summarizeSceneSpec(spec, {
           revision,
@@ -679,6 +680,7 @@ export default class BlenderStudio extends Service {
           digest,
         }),
       }),
+      projectDirectory: this.store.projectDirectory(projectId),
       revisions: this.store.listRevisions(projectId).map(id => {
         const manifest = this.store.readRevisionManifest(projectId, id)
         return {
@@ -710,7 +712,7 @@ export default class BlenderStudio extends Service {
    * whole spec on every turn spends its context on fields it is not changing.
    *
    * @param {string} projectId
-   * @param {{ revision?: string, full?: boolean, geometry?: { entityIds: string[], frame: number }, signal?: AbortSignal }} [options]
+   * @param {{ revision?: string, full?: boolean, geometry?: { entityIds: string[], frame: number, surfaceSamples?: object[] }, signal?: AbortSignal }} [options]
    * @returns {Promise<Record<string, unknown>>}
    */
   async getScene(projectId, options = {}) {
@@ -792,8 +794,14 @@ export default class BlenderStudio extends Service {
     const locked = context.state ? { ...context.lock, values: context.state.values,
       valuesSha256: context.state.valuesSha256 } : context.lock
     const resolved = instantiateRecipeLock(locked)
+    const currentSpec = this.store.readRevisionSpec(projectId, revision)
+    const animatedBindings = definitions.flatMap(parameter => parameter.bindings).filter(binding => binding.offsetAnimation === true)
+    const linkedAnimationTracks = (currentSpec.animationTracks ?? []).filter(track => (track.targetKind ?? 'entity') === 'entity'
+      && animatedBindings.some(binding => binding.entityId === track.targetEntityId && track.property === `location.${binding.axis}`))
+      .map(track => ({ id: track.id, targetEntityId: track.targetEntityId, property: track.property,
+        keyframes: structuredClone(track.keyframes) }))
     let conflicts = []
-    try { planRecipeGeometryEdit(context.lock, this.store.readRevisionSpec(projectId, revision), context.state ?? undefined, {}) }
+    try { planRecipeGeometryEdit(context.lock, currentSpec, context.state ?? undefined, {}) }
     catch (error) {
       if (error.code !== 'RECIPE_PARAMETER_CONFLICT') throw error
       conflicts = error.details.conflicts
@@ -802,7 +810,7 @@ export default class BlenderStudio extends Service {
       recipe: { id: context.lock.id, version: context.lock.version }, valuesSha256: resolved.recipe.valuesSha256,
       parameters: definitions.map(parameter => ({ id: parameter.id, title: parameter.title, type: parameter.type,
         minimum: parameter.minimum, maximum: parameter.maximum, default: parameter.default, value: resolved.values[parameter.id] })),
-      conflicts }
+      conflicts, linkedAnimationTracks, animationSource: 'saved-scene-spec' }
   }
 
   async updateRecipeParameters(request) {
@@ -818,9 +826,13 @@ export default class BlenderStudio extends Service {
       throw new BlenderError('REVISION_CONFLICT', 'The active project store changed; read the selected work again')
     }
     const outcome = await this.transactions.applyRecipeParameters(input, { signal })
+    const placementChanges = assemblyPlacementChanges(
+      this.store.readRevisionSpec(input.projectId, input.baseRevision),
+      this.store.readRevisionSpec(input.projectId, outcome.revision.revision),
+      input.baseRevision, outcome.revision.revision)
     return { ...toCanonicalRevisionSummary({ manifest: outcome.revision, checkpointPath: outcome.revision.checkpoint }),
       unchanged: outcome.unchanged === true, idempotentReplay: outcome.idempotentReplay === true,
-      parameterState: outcome.parameterState, preservedCameraIds: outcome.preservedCameraIds,
+      parameterState: outcome.parameterState, preservedCameraIds: outcome.preservedCameraIds, placementChanges,
       parameters: await this.getRecipeParameters(input.projectId, { revision: outcome.revision.revision }),
       ...(outcome.job ? { job: toCanonicalJobRecord(outcome.job) } : {}) }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepblend/dsh-blender-host",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "type": "module",
   "description": "DeepBlend Host service: the blenderStudio business facade over the BlenderRuntime seam.",
   "main": "lib/index.js",
@@ -20,7 +20,7 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@deepblend/dsh-blender-contracts": "0.9.0",
+    "@deepblend/dsh-blender-contracts": "0.11.0",
     "sharp": "0.35.5"
   },
   "license": "MIT",