Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel
Refresh guitar presentation from current source
Yuechen Lifa7c2adb3321
diff --git a/docs/public/firmament/glb.md b/docs/public/firmament/glb.mdindex 02c81eea..8adb1a92 100644--- a/docs/public/firmament/glb.md+++ b/docs/public/firmament/glb.md@@ -32,6 +32,8 @@ presentation scenes. `scripts/export-presentation-scene.py` preserves productpositions and polygons, embeds the ATLAS maker label, and bakes the guitar'sexisting procedural sunburst/wood base color. It does not translate generalmaterial graphs or alter guitar geometry. Procedural grain bump is omitted.+The presentation qualifier regenerates the guitar USD and shaded scene from+current Firmament source on every run; it does not reuse a cached guitar `.blend`.ATLAS is an independent Aetheris demo robot. Aetheris is not affiliated with,endorsed by, or associated with Boston Dynamics. The shared name is coincidental.diff --git a/docs/release/PRESENTATION-3D-X0.md b/docs/release/PRESENTATION-3D-X0.mdindex 83dd9ac1..1caef660 100644--- a/docs/release/PRESENTATION-3D-X0.md+++ b/docs/release/PRESENTATION-3D-X0.md@@ -1,6 +1,6 @@# PRESENTATION-3D-X0-Status on 2026-10-02: **Meaningful progression; desktop qualification pending.**+Status on 2026-10-04: **Meaningful progression; desktop qualification pending.**The C# GLB exporter and the existing C# slide writer now produce a two-slide PPTXcontaining physically embedded ATLAS and guitar GLBs. Independent glTF validation@@ -31,7 +31,7 @@ are supported and embedded in the binary buffer. Paths never enter GLB metadata.The final polished witnesses use their established Aetheris USD-derived Blenderscenes. `export-presentation-scene.py` preserves product positions and polygons,-exports the existing ATLAS label texture, and bakes five guitar sunburst/wood+exports the existing ATLAS label texture, and bakes guitar sunburst/woodbase-color surfaces. This is a bounded finishing step, not a general materialgraph translator. Procedural wood-grain bump is omitted; scalar PBR and supportedcoat survive. No guitar geometry work was reopened. Studio floors, lights and@@ -85,15 +85,15 @@ message for the existing 1024×192 label texture; direct display GLBs haveinformational default-matrix messages. Guitar has no validator issues.Blender **5.2.2 LTS** imports the polished assets independently. ATLAS has 61-visible meshes using 25 mesh datablocks, including its printed label. Guitar has-107 visible mesh objects and five embedded 1024×1024 images. Imported normals+visible meshes using 25 mesh datablocks, including its printed label. The current+guitar has 99 visible mesh objects and six embedded 1024×1024 images. Imported normalsare unit length and transforms are positive-handed. Measured physical bounds inBlender's Z-up metres are approximately:| Model | X | Y | Z ||---|---:|---:|---:|| ATLAS | 0.295001 | 0.130000 | 0.340774 |-| Guitar | 0.337550 | 1.039273 | 0.066480 |+| Guitar | 0.337550 | 1.039273 | 0.066340 |`atlas-fallback.png` and `guitar-fallback.png` render the independently importedGLBs. Visual inspection confirms the industrial robot, maker mark, polished@@ -109,11 +109,11 @@ oracle live under ignored `artifacts/local/presentation-3d-x0/`.| Artifact | Bytes ||---|---:|| ATLAS polished GLB | 546,680 |-| Guitar polished GLB | 5,404,940 |+| Guitar polished GLB, refreshed 2026-10-04 | 6,606,296 || Two-slide PPTX before models | 6,526 |-| Embedded two-slide PPTX | 4,779,099 |+| Refreshed two-slide PPTX, 2026-10-04 | 5,870,858 |-Direct .NET GLB lowering took about 60 ms for ATLAS and 96 ms for guitar after+Original October 2 timings: direct .NET GLB lowering took about 60 ms for ATLAS and 96 ms for guitar afterdisplay preparation. Compilation and tessellation took about 4.29 s and 8.90 srespectively. Polished finishing took approximately 0.70 s and 2.09 s. C# slidecompilation took approximately 116 ms. Desktop PowerPoint load time is unmeasured.@@ -126,7 +126,7 @@ witnesses. CLI tests cover valid export and preservation of output after invalidoptions. Three existing/new PPTX tests pass, including Office 2019 validation,exact embedding, multiple model relationships, fallback, deterministic packages,oracle structure and existing drawing functionality. Release build succeeds;-the fast core lane passes 1,005 tests. The complete serial solution lane passes+the fast core lane passes 1,005 tests. The October 2 complete serial solution lane passes4,042 tests with zero failures (`full-tests-closeout.log`), including 1,138 core,1,736 Firmament and 455 CLI tests.@@ -143,12 +143,53 @@ Reproduce the generated assets with:pwsh -File scripts/qualify-presentation-3d-x0.ps1```-This requires the existing qualified `.blend` scenes. If absent, run the existing-industrial ATLAS and guitar qualification scripts with `-Render` first. The-qualifier builds both direct GLBs, finishes both polished scenes, imports/renders-them independently, runs pinned Khronos validation, and calls the C# deck compiler.+This requires the existing qualified ATLAS `.blend` scene. If absent, run the+industrial ATLAS qualification script with `-Render` first. The qualifier rebuilds+the guitar USD from current Firmament code and invokes the existing sunburst+renderer to recreate `guitar-source/guitar-studio.blend` on every run. It builds+both direct GLBs, finishes both polished scenes, imports/renders them independently,+runs pinned Khronos validation, and calls the C# deck compiler.It does not claim desktop acceptance.+## Current-source refresh, 2026-10-04++The original presentation guitar used a September 30 cached studio scene. It+predated the source-owned semicircular tailpiece/string rail and the repaired+headstock/neck connection. The presentation qualifier now recompiles and reshades+the guitar before GLB finishing, so cached geometry cannot conceal those fixes.+The material binding for the widened headstock root was also corrected to its+current full definition identity. Guitar geometry source was not changed.++The current source has 99 visible part occurrences and 56 shared display+definitions, rather than the old scene's 107 visible parts. Refresh evidence is+retained in `guitar-source/` and `refresh-2026-10-04.log` beneath local artifacts.+The refreshed polished GLB imports as 99 mesh objects and 145,728 triangles;+Khronos validation reports zero errors and zero warnings. Its embedded copy in+`interactive-3d-demo-2026-10-04.pptx` matches the current GLB byte-for-byte. The+dated filename avoids overwriting the original deck while it is open in Office.+Use `-DeckName interactive-3d-demo-2026-10-04.pptx` with the qualifier to choose+this output name. Blender invocations now use `--python-exit-code 1`, ensuring+failed finishing cannot silently pass by retaining an old output file.+The refresh log records the original filename's Office lock; the separate+`deck-compile-2026-10-04.json` records successful dated compilation (136 ms).+The dated deck's media are embedded and its relationships are all internal.++`guitar-bridge-detail.png` and `guitar-head-join-detail.png` are closeups rendered+from an independent import of the refreshed GLB. They show the authored 5 mm+semicircular string rail and the solid scarf/neck-to-headstock transition. The+existing engineering witness tests verify the rail diameter sits at z=60 mm+and the string crown at z=65 mm; no presentation-only repair geometry was added.++October 4 validation: the solution Release build succeeds (zero errors, nine+warnings), and the fast core lane passes all 1,005 tests. The full serial lane+records 4,265 passes and one failure in+`ProfileBoundaryAuthoringTests.OverlapIsRejectedAndDisjointEditOrderDoesNotChangeGeometry`+at line 73. It reproduces in isolation using inline rectangular-panel source,+without referencing guitar files, appearances or presentation artifacts. No C#+compiler code was modified in this refresh. Both the full failure and focused+diagnostic are retained as `refresh-full-tests.log` and+`refresh-profile-boundary-diagnostic.log`; the full suite is not claimed green.+## ATLAS disclaimerATLAS is an independent Aetheris demo robot. Aetheris is not affiliated with,diff --git a/fixtures/Canonical/AssemblyInterfaces/GuitarX0/preview-materials.json b/fixtures/Canonical/AssemblyInterfaces/GuitarX0/preview-materials.jsonindex dbc10781..98e227c2 100644--- a/fixtures/Canonical/AssemblyInterfaces/GuitarX0/preview-materials.json+++ b/fixtures/Canonical/AssemblyInterfaces/GuitarX0/preview-materials.json@@ -48,7 +48,7 @@"metallic": 0,"roughness": 0.4},- "Head<H:14mm>": {+ "Head<H:14mm,RootStart:16mm,RootHalfWidth:26.5mm,RootWidth:53mm>": {"red": 0.15,"green": 0.025,"blue": 0.012,diff --git a/scripts/export-presentation-scene.py b/scripts/export-presentation-scene.pyindex 085b9a69..a730c3a8 100644--- a/scripts/export-presentation-scene.py+++ b/scripts/export-presentation-scene.py@@ -39,7 +39,7 @@ def object_geometry(obj):tuple(tuple(p.vertices) for p in obj.data.polygons))product_geometry = {o.name: object_geometry(o) for o in products}if kind == 'guitar':- assert len(products) == 107, len(products)+ assert len(products) in (99, 107), len(products)scene.render.engine = 'CYCLES'scene.cycles.samples = 1scene.cycles.device = 'CPU'diff --git a/scripts/inspect-presentation-glb.py b/scripts/inspect-presentation-glb.pyindex cbd45601..cdc3256a 100644--- a/scripts/inspect-presentation-glb.py+++ b/scripts/inspect-presentation-glb.py@@ -67,4 +67,15 @@ scene.render.filepath=str(output/(source.stem+'-fallback.png'))scene.view_settings.view_transform='AgX'bpy.ops.wm.save_as_mainfile(filepath=str(output/(source.stem+'-imported.blend')))bpy.ops.render.render(write_still=True)+if source.stem == 'guitar':+ # Evidence from the imported deliverable, not from a cached source scene.+ for name, position, target, scale in [+ ('bridge-detail', (.30, -.28, .22), (0, -.055, .060), .21),+ ('head-join-detail', (.5, .67, .050), (0, .67, .050), .11),+ ]:+ camera.location = position+ camera.rotation_euler = (Vector(target)-camera.location).to_track_quat('-Z','Y').to_euler()+ camera_data.ortho_scale = scale+ scene.render.filepath = str(output/(source.stem+'-'+name+'.png'))+ bpy.ops.render.render(write_still=True)print(json.dumps({k:v for k,v in report.items() if k not in ('materials','hierarchy')}), flush=True)diff --git a/scripts/qualify-presentation-3d-x0.ps1 b/scripts/qualify-presentation-3d-x0.ps1index d4ef5b79..1a99ef7d 100644--- a/scripts/qualify-presentation-3d-x0.ps1+++ b/scripts/qualify-presentation-3d-x0.ps1@@ -1,6 +1,7 @@[CmdletBinding()]param([string]$OutDir = 'artifacts/local/presentation-3d-x0',+ [string]$DeckName = 'interactive-3d-demo.pptx',[string]$Blender = 'C:/Program Files/Blender Foundation/Blender 5.2/blender.exe')$ErrorActionPreference = 'Stop'@@ -8,9 +9,10 @@ $repoRoot = Split-Path -Parent $PSScriptRootPush-Location $repoRoottry {$out = [IO.Path]::GetFullPath($OutDir)+ if ([IO.Path]::GetFileName($DeckName) -ne $DeckName -or [IO.Path]::GetExtension($DeckName) -ne '.pptx') { throw 'DeckName must be a .pptx filename.' }New-Item -ItemType Directory -Force $out | Out-Null- foreach ($scene in @('artifacts/local/usd-industrial/atlas-hero.blend','artifacts/local/guitar-x0/guitar-studio.blend')) {- if (!(Test-Path -LiteralPath $scene)) { throw "Missing qualified presentation scene: $scene. Run the existing qualify-industrial-atlas.ps1 -Render and qualify-guitar-x0.ps1 -Render first." }+ foreach ($scene in @('artifacts/local/usd-industrial/atlas-hero.blend')) {+ if (!(Test-Path -LiteralPath $scene)) { throw "Missing qualified presentation scene: $scene. Run the existing qualify-industrial-atlas.ps1 -Render first." }}function Invoke-Logged([string]$Program, [string[]]$Arguments, [string]$Log) {& $Program @Arguments *> $Log@@ -20,10 +22,16 @@ try {$cli = 'Aetheris.CLI/bin/Release/net10.0/aetheris.dll'Invoke-Logged 'dotnet' @($cli,'asm','export-glb','fixtures/Canonical/AssemblyInterfaces/IndustrialAtlas/atlas-industrial.firmament',"$out/atlas-display.glb",'--materials','fixtures/Canonical/AssemblyInterfaces/IndustrialAtlas/appearance.json','--state','Shoulder=-75','--state','Elbow=-140','--state','GripLeft=10','--state','GripRight=10','--json') "$out/atlas-display-export.json"Invoke-Logged 'dotnet' @($cli,'asm','export-glb','fixtures/Canonical/AssemblyInterfaces/GuitarX0/guitar.firmasm',"$out/guitar-display.glb",'--materials','fixtures/Canonical/AssemblyInterfaces/GuitarX0/preview-materials.json','--json') "$out/guitar-display-export.json"+ # Rebuild the shaded guitar from current compiled geometry, never a cached+ # studio scene: neck/bridge fixes can otherwise disappear from the deck.+ $guitarRoot = "$out/guitar-source"+ New-Item -ItemType Directory -Force $guitarRoot | Out-Null+ Invoke-Logged 'dotnet' @($cli,'asm','export-usd','fixtures/Canonical/AssemblyInterfaces/GuitarX0/guitar.firmasm',"$guitarRoot/guitar.usda",'--materials','fixtures/Canonical/AssemblyInterfaces/GuitarX0/preview-materials.json','--evidence',"$guitarRoot/display.json",'--json') "$guitarRoot/export.json"+ Invoke-Logged $Blender @('--background','--factory-startup','--python-exit-code','1','--python','scripts/render-guitar-x0.py','--',"$guitarRoot/guitar.usda",$guitarRoot,'--preview','--view=hero') "$guitarRoot/render.log"foreach ($kind in @('atlas','guitar')) {- $scene = if ($kind -eq 'atlas') { 'artifacts/local/usd-industrial/atlas-hero.blend' } else { 'artifacts/local/guitar-x0/guitar-studio.blend' }- Invoke-Logged $Blender @('--background','--python','scripts/export-presentation-scene.py','--',$kind,$scene,"$out/$kind.glb") "$out/$kind-polish.log"- Invoke-Logged $Blender @('--background','--python','scripts/inspect-presentation-glb.py','--',"$out/$kind.glb",$out) "$out/$kind-blender.log"+ $scene = if ($kind -eq 'atlas') { 'artifacts/local/usd-industrial/atlas-hero.blend' } else { "$guitarRoot/guitar-studio.blend" }+ Invoke-Logged $Blender @('--background','--python-exit-code','1','--python','scripts/export-presentation-scene.py','--',$kind,$scene,"$out/$kind.glb") "$out/$kind-polish.log"+ Invoke-Logged $Blender @('--background','--python-exit-code','1','--python','scripts/inspect-presentation-glb.py','--',"$out/$kind.glb",$out) "$out/$kind-blender.log"}$toolsRoot = "$out/tools"Invoke-Logged 'npm' @('install','--prefix',$toolsRoot,'[email protected]') "$out/validator-install.log"@@ -36,7 +44,7 @@ try {}$manifest = "$out/deck.json"$deck | ConvertTo-Json -Depth 20 | Set-Content -LiteralPath $manifest -Encoding utf8- Invoke-Logged 'dotnet' @($cli,'presentation','compile',$manifest,"$out/interactive-3d-demo.pptx",'--json') "$out/deck-compile.json"+ Invoke-Logged 'dotnet' @($cli,'presentation','compile',$manifest,"$out/$DeckName",'--json') "$out/deck-compile.json"$empty = $deck | ConvertTo-Json -Depth 20 | ConvertFrom-Jsonforeach ($slide in $empty.slides) { $slide.models = @() }$empty | ConvertTo-Json -Depth 20 | Set-Content -LiteralPath "$out/deck-without-models.json" -Encoding utf8