feat: lazy shape store, native IFC pipeline, in-browser conversion, viewer mesh tools

.forgejo/workflows/build.yaml

@@ -314,26 +314,29 @@ jobs:
 
           # Docs image is a Sphinx static site (deploy/Dockerfile.docs)
           # that also bundles the paradoc-backed FEA verification report.
-          # Rebuild on docs/**, the report source tree, pixi env files,
-          # the Dockerfile, or the workflow itself. Fast = only the doc
-          # sources changed (re-run fea-doc + sphinx on the env base);
-          # env/Dockerfile/workflow changes need the full build.
+          # It is by far the slowest image to build, so it is OPT-IN: it
+          # builds only when the head commit message carries a ``[docs]``
+          # marker, regardless of what changed. Viewer/worker builds are
+          # unaffected. Works for push and workflow_dispatch (GITHUB_SHA is
+          # the branch tip either way; fetch-depth:0 above makes the message
+          # available).
           docs=false
           docs_full=false
-          if match_scope "$DOCS_CHANGED" '^docs/' || \
-             match_scope "$DOCS_CHANGED" '^src/ada/' || \
-             match_scope "$DOCS_CHANGED" '^pixi\.(toml|lock)$' || \
-             match_scope "$DOCS_CHANGED" '^pyproject\.toml$' || \
-             match_scope "$DOCS_CHANGED" '^verification/' || \
-             match_scope "$DOCS_CHANGED" '^deploy/Dockerfile\.docs(-fast)?$' || \
-             match_scope "$DOCS_CHANGED" '^\.forgejo/workflows/build\.yaml$'; then
+          COMMIT_MSG=$(git log -1 --format=%B "$GITHUB_SHA" 2>/dev/null || echo "")
+          if printf '%s' "$COMMIT_MSG" | grep -qiF '[docs]'; then
             docs=true
-          fi
-          if match_scope "$DOCS_CHANGED" '^pixi\.(toml|lock)$' || \
-             match_scope "$DOCS_CHANGED" '^pyproject\.toml$' || \
-             match_scope "$DOCS_CHANGED" '^deploy/Dockerfile\.docs$' || \
-             match_scope "$DOCS_CHANGED" '^\.forgejo/workflows/build\.yaml$'; then
-            docs_full=true
+            # Fast build (re-run fea-doc + sphinx on the cached env base)
+            # unless the pixi env / Dockerfile / workflow changed — those
+            # need a full rebuild off a fresh env base.
+            if match_scope "$DOCS_CHANGED" '^pixi\.(toml|lock)$' || \
+               match_scope "$DOCS_CHANGED" '^pyproject\.toml$' || \
+               match_scope "$DOCS_CHANGED" '^deploy/Dockerfile\.docs$' || \
+               match_scope "$DOCS_CHANGED" '^\.forgejo/workflows/build\.yaml$'; then
+              docs_full=true
+            fi
+            echo "[docs] present in the head commit message — building docs (full=$docs_full)."
+          else
+            echo "docs build is opt-in — add [docs] to the head commit message to build it. Skipping."
           fi
 
           {

.gitattributes

@@ -1,2 +1,3 @@
 # SCM syntax highlighting
 pixi.lock linguist-language=YAML linguist-generated=true
+files/ifc_files/beam-standard-case-gz.ifc binary

.github/workflows/ci-pages.yml

@@ -50,7 +50,7 @@ jobs:
         with:
           fetch-depth: 0 # otherwise, you will fail to push refs to dest repo
 
-      - uses: prefix-dev/setup-pixi@v0.9.6 # https://github.com/prefix-dev/setup-pixi
+      - uses: prefix-dev/setup-pixi@v0.10.0 # https://github.com/prefix-dev/setup-pixi
         with:
           pixi-version: v0.68.0
           environments: docs

.github/workflows/main-profiling.yml

@@ -27,7 +27,7 @@ jobs:
           fetch-depth: 0
 
       - name: Setup Pixi
-        uses: prefix-dev/setup-pixi@v0.9.6
+        uses: prefix-dev/setup-pixi@v0.10.0
         with:
           pixi-version: v0.68.0
           environments: profile

.github/workflows/pr-profiling.yml

@@ -29,7 +29,7 @@ jobs:
           persist-credentials: false
 
       - name: Setup Pixi
-        uses: prefix-dev/setup-pixi@v0.9.6
+        uses: prefix-dev/setup-pixi@v0.10.0
         with:
           pixi-version: v0.68.0
           environments: profile

.github/workflows/pr-tests.yml

@@ -19,7 +19,7 @@ jobs:
             with:
               ref: ${{ github.event.pull_request.head.sha || github.ref }}
 
-          - uses: prefix-dev/setup-pixi@v0.9.6 # https://github.com/prefix-dev/setup-pixi
+          - uses: prefix-dev/setup-pixi@v0.10.0 # https://github.com/prefix-dev/setup-pixi
             with:
               pixi-version: v0.68.0
               cache: true
@@ -41,7 +41,7 @@ jobs:
           with:
             ref: ${{ github.event.pull_request.head.sha || github.ref }}
 
-        - uses: prefix-dev/setup-pixi@v0.9.6
+        - uses: prefix-dev/setup-pixi@v0.10.0
           with:
             pixi-version: v0.68.0
             environments: tests

.github/workflows/test.yml

@@ -19,7 +19,7 @@ jobs:
         with:
           ref: ${{ github.event.pull_request.head.sha || github.ref }}
 
-      - uses: prefix-dev/setup-pixi@v0.9.6 # https://github.com/prefix-dev/setup-pixi
+      - uses: prefix-dev/setup-pixi@v0.10.0 # https://github.com/prefix-dev/setup-pixi
         with:
           pixi-version: v0.68.0
           environments: tests
@@ -39,7 +39,7 @@ jobs:
         with:
           ref: ${{ github.event.pull_request.head.sha || github.ref }}
 
-      - uses: prefix-dev/setup-pixi@v0.9.6
+      - uses: prefix-dev/setup-pixi@v0.10.0
         with:
           pixi-version: v0.68.0
           environments: >-
@@ -64,7 +64,7 @@ jobs:
         with:
           ref: ${{ github.event.pull_request.head.sha || github.ref }}
 
-      - uses: prefix-dev/setup-pixi@v0.9.6
+      - uses: prefix-dev/setup-pixi@v0.10.0
         with:
           pixi-version: v0.68.0
           environments: >-
@@ -85,7 +85,7 @@ jobs:
         with:
           ref: ${{ github.event.pull_request.head.sha || github.ref }}
 
-      - uses: prefix-dev/setup-pixi@v0.9.6
+      - uses: prefix-dev/setup-pixi@v0.10.0
         with:
           pixi-version: v0.68.0
           environments: >-
@@ -122,7 +122,7 @@ jobs:
         with:
           ref: ${{ github.event.pull_request.head.sha || github.ref }}
 
-      - uses: prefix-dev/setup-pixi@v0.9.6
+      - uses: prefix-dev/setup-pixi@v0.10.0
         with:
           pixi-version: v0.68.0
           environments: >-

deploy/Dockerfile.viewer

@@ -47,10 +47,11 @@ RUN npm run build:serve
 COPY --from=adacpp-wheel /out/ /build/dist/wheels/
 COPY --from=adapy-wheel  /out/ /build/dist/wheels/
 
-# The no-pyodide STEP->GLB embind module (adacpp_step_glb.js + .wasm) ships in the same adacpp base
-# image under /out/wasm/, so the copy above lands it at dist/wheels/wasm/. Promote it to /wasm/ — where
-# the in-browser "Load STEP" converter (LocalStepLoader -> stepConverter.worker) fetches it. Guarded so
-# the build still works against older base images that predate the module.
+# The no-pyodide embind modules (adacpp_step_glb / adacpp_ifc_glb / adacpp_brep_writer / adacpp_glb_diff
+# .js + .wasm) ship in the same adacpp base image under /out/wasm/, so the copy above lands them at
+# dist/wheels/wasm/. Promote the whole dir to /wasm/ — where the in-browser converters (cadGlbConverter
+# / brepWriterConverter workers) and the diff utility fetch them. Guarded + globbed so the build works
+# against older base images that predate any given module.
 RUN mkdir -p /build/dist/wasm && \
     if [ -d /build/dist/wheels/wasm ]; then \
         mv /build/dist/wheels/wasm/* /build/dist/wasm/ && rmdir /build/dist/wheels/wasm; \

deploy/Dockerfile.worker

@@ -6,6 +6,14 @@
 # (the build runner has no egress to Ubuntu mirrors). The conda env
 # itself dominates final image size, so a multi-stage trim wouldn't
 # meaningfully shrink things.
+#
+# Rebuild marker (bump to re-pull the ADACPP_BRANCH overlay fresh):
+#   2026-07-13d — adacpp feat/lazy-shape-store @ 826e347: tessellate linear-extrusion (tabulated
+#   cylinder) faces — the surface is semi-infinite along its axis, so the swept-profile inverter no
+#   longer clamps v to the vector magnitude (which dropped faces) and stays on one profile fold
+#   (removes over-filled/beyond-limits artifacts). Still carries the dropped-face health counter,
+#   IFC linear placement + opening voids, the bogus-SI-prefix guard (empty tanks), GLB-spill RAM
+#   buffering, tls model_scale fix, tri-count logging, parent malloc_trim.
 
 ARG PIXI_VERSION=0.68.0
 # CI passes --build-arg IMAGE_TAG=sha-XXXXXXX so the worker can publish
@@ -19,9 +27,11 @@ ARG IMAGE_TAG=dev
 # CI stages the branch source into ./adacpp-src (clone) or an empty dir, and passes the branch
 # name so the builder stage below knows whether to build. Built with adacpp's own pinned env
 # (occt ==7.9.3), which matches what the released ada-cpp links → ABI-compatible .so.
-# The feat/ngeom-alignment-sweep overlay HEAD carries: alignment fixed-reference swept solid
-# (SweepN), the step_parity single-parse fan-out (STEP parity), and incremental meshopt in the
-# native GLB writer (halves peak RSS on large merged GLBs — fixes the STEP→GLB OOM).
+# The feat/lazy-shape-store overlay HEAD carries: the z=0 face-set plane-fit (IfcFacetedBrep /
+# Triangulated- + PolygonalFaceSet no longer render as a flat sheet), parallel native IFC→GLB,
+# a B-spline-weighted LPT cost estimate + per-solid audit instrumentation (spearman_est_ms/tris),
+# the NAUO-gate fix for the crane STEP→GLB regression, and a moderate 4 MB malloc mmap/trim that
+# trims streaming-tessellation peak RSS.
 ARG ADACPP_BRANCH=""
 
 # ---- optional adacpp-branch overlay (gated by ADACPP_BRANCH) -----------------------

deploy/helm/adapy-viewer/templates/_helpers.tpl

@@ -202,6 +202,33 @@ spec:
           {{- with $w.resources }}
           resources: {{- toYaml . | nindent 12 }}
           {{- end }}
+          # Liveness: the worker touches /tmp/worker-alive on every JetStream pull-loop iteration
+          # (<=5s when idle) and on conversion progress (~2s). If the pull loop stalls — the durable
+          # consumer wedges after a NATS restart, leaving the pod "Running" but no longer fetching
+          # (num_waiting=0) — the file goes stale and k8s restarts the pod, instead of it sitting
+          # silently broken while jobs pile up unconsumed.
+          #
+          # This heartbeat probe ONLY works on pools running the adapy worker image, which writes the
+          # file. Capability pools that run a foreign image (abaqus, weld-gen) never write it, so the
+          # probe would fail every time and SIGKILL-crashloop them. Hence it is OPT-IN: emitted only
+          # when the pool sets `heartbeatLiveness: true` (the adapy worker default) or supplies its own
+          # `livenessProbe:`. Pools that do neither get no liveness probe.
+          {{- if or $w.livenessProbe $w.heartbeatLiveness }}
+          livenessProbe:
+            {{- with $w.livenessProbe }}
+            {{- toYaml . | nindent 12 }}
+            {{- else }}
+            exec:
+              command:
+                - sh
+                - -c
+                - 'test $(( $(date +%s) - $(stat -c %Y /tmp/worker-alive 2>/dev/null || echo 0) )) -lt 120'
+            initialDelaySeconds: 120
+            periodSeconds: 30
+            failureThreshold: 4
+            timeoutSeconds: 5
+            {{- end }}
+          {{- end }}
           {{- with $w.securityContext }}
           securityContext: {{- toYaml . | nindent 12 }}
           {{- end }}

deploy/helm/adapy-viewer/values.yaml

@@ -49,6 +49,11 @@ strategy:
 worker:
   enabled: true
   replicaCount: 1
+  # This pool runs the adapy worker image, which writes /tmp/worker-alive on
+  # every pull-loop iteration, so the heartbeat livenessProbe applies (restarts
+  # a wedged pull loop). Capability pools on foreign images must leave this
+  # unset — see the livenessProbe note in _helpers.tpl.
+  heartbeatLiveness: true
   image:
     repository: ghcr.io/krande/adapy-viewer-worker
     tag: ""

files/ifc_files/bath-csg-solid.ifc

@@ -0,0 +1,70 @@
+ISO-10303-21;
+HEADER;
+FILE_DESCRIPTION(('ViewDefinition [NotAssigned]'),'2;1');
+FILE_NAME(
+/* name */ 'bath-csg-solid.ifc',
+/* time_stamp */ '2016-02-04T08:47:55',
+/* author */ ('redacted'),
+/* organization */ ('redacted'),
+/* preprocessor_version */ 'redacted',
+/* originating_system */ 'redacted - redacted - 3.14159',
+/* authorization */ 'None');
+
+FILE_SCHEMA (('IFC4X3_ADD2'));
+ENDSEC;
+
+DATA;
+/* general entities required for all IFC data sets, defining the context for the exchange */
+#1= IFCGEOMETRICREPRESENTATIONCONTEXT($,'Model',3,0.0001,#3,$);
+#2= IFCCARTESIANPOINT((0.0,0.0,0.0));
+#3= IFCAXIS2PLACEMENT3D(#2,$,$);
+#4= IFCGEOMETRICREPRESENTATIONSUBCONTEXT('Axis','Model',*,*,*,*,#1,$,.MODEL_VIEW.,$);
+#5= IFCGEOMETRICREPRESENTATIONSUBCONTEXT('Body','Model',*,*,*,*,#1,$,.MODEL_VIEW.,$);
+/* defines the default building (as required as the minimum spatial element)  */
+#50= IFCBUILDING('39t4Pu3nTC4ekXYRIHJB9W',#56,'IfcBuilding',$,$,$,$,$,$,$,$,$);
+#51= IFCPERSONANDORGANIZATION(#52,#53,$);
+#52= IFCPERSON('redacted','redacted',$,$,$,$,$,$);
+#53= IFCORGANIZATION($,'redacted',$,$,$);
+#54= IFCAPPLICATION(#55,'redacted','redacted','redacted');
+#55= IFCORGANIZATION($,'redacted',$,$,$);
+#56= IFCOWNERHISTORY(#51,#54,$,.ADDED.,1454575675,$,$,1454575675);
+#57= IFCRELCONTAINEDINSPATIALSTRUCTURE('3Sa3dTJGn0H8TQIGiuGQd5',#56,'Building','Building Container for Elements',(#225),#50);
+#58= IFCAXIS2PLACEMENT3D(#2,$,$);
+#100= IFCPROJECT('0$WU4A9R19$vKWO$AdOnKA',#56,'IfcProject',$,$,$,$,(#1),#101);
+#101= IFCUNITASSIGNMENT((#102,#103,#104));
+#102= IFCSIUNIT(*,.LENGTHUNIT.,.MILLI.,.METRE.);
+#103= IFCSIUNIT(*,.PLANEANGLEUNIT.,$,.RADIAN.);
+#104= IFCSIUNIT(*,.TIMEUNIT.,$,.SECOND.);
+#105= IFCRELAGGREGATES('091a6ewbvCMQ2Vyiqspa7a',#56,'Project Container','Project Container for Buildings',#100,(#50));
+#200= IFCBLOCK(#201,2000.0,800.0,800.0);
+#201= IFCAXIS2PLACEMENT3D(#2,$,$);
+#202= IFCROUNDEDRECTANGLEPROFILEDEF(.AREA.,'VoidProfile',$,1800.0,600.0,200.0);
+#203= IFCAXIS2PLACEMENT3D(#204,$,$);
+#204= IFCCARTESIANPOINT((1000.0,400.0,100.0));
+#205= IFCDIRECTION((0.0,0.0,1.0));
+#206= IFCEXTRUDEDAREASOLID(#202,#203,#205,700.0);
+#207= IFCBOOLEANRESULT(.DIFFERENCE.,#200,#206);
+#208= IFCCSGSOLID(#207);
+#209= IFCREPRESENTATIONMAP(#210,#211);
+#210= IFCAXIS2PLACEMENT3D(#2,$,$);
+#211= IFCSHAPEREPRESENTATION(#5,'Body','SolidModel',(#208));
+#212= IFCMATERIAL('Ceramic',$,$);
+#213= IFCRELASSOCIATESMATERIAL('0Pkhszwjv1qRMYyCFg9fjB',#56,'MatAssoc','Material Associates',(#214),#212);
+#214= IFCSANITARYTERMINALTYPE('1HarmwaPv3OeJSXpaoPKpg',#56,'Bath',$,$,$,(#209),$,$,.BATH.);
+#215= IFCRELDEFINESBYTYPE('1lO$X3e3j9lfVMhNy4MzKB',#56,$,$,(#225),#214);
+#216= IFCRELDECLARES('1acQrDhur9399Xqs2jQs4t',#56,$,$,#100,(#214));
+#217= IFCDIRECTION((1.0,0.0,0.0));
+#218= IFCDIRECTION((0.0,1.0,0.0));
+#219= IFCCARTESIANPOINT((0.0,0.0,0.0));
+#220= IFCCARTESIANTRANSFORMATIONOPERATOR3D(#217,#218,#219,1.0,#221);
+#221= IFCDIRECTION((0.0,0.0,1.0));
+#222= IFCMAPPEDITEM(#209,#220);
+#223= IFCSHAPEREPRESENTATION(#5,'Body','MappedRepresentation',(#222));
+#224= IFCPRODUCTDEFINITIONSHAPE($,$,(#223));
+#225= IFCSANITARYTERMINAL('3$$o7C03j0KQeLnoj018fc',#56,$,$,$,#227,#224,$,$);
+#226= IFCAXIS2PLACEMENT3D(#2,$,$);
+#227= IFCLOCALPLACEMENT($,#226);
+ENDSEC;
+
+END-ISO-10303-21;
+

files/ifc_files/beam-extruded-solid.ifc

@@ -0,0 +1,50 @@
+ISO-10303-21;
+HEADER;
+FILE_DESCRIPTION(('ViewDefinition [NotAssigned]'),'2;1');
+FILE_NAME(
+/* name */ 'beam-extruded-solid.ifc',
+/* time_stamp */ '2016-02-04T08:11:04',
+/* author */ ('redacted'),
+/* organization */ ('redacted'),
+/* preprocessor_version */ 'redacted',
+/* originating_system */ 'redacted - redacted - 3.14159',
+/* authorization */ 'None');
+
+FILE_SCHEMA (('IFC4X3_ADD2'));
+ENDSEC;
+
+DATA;
+/* general entities required for all IFC data sets, defining the context for the exchange */
+#1= IFCGEOMETRICREPRESENTATIONCONTEXT($,'Model',3,0.0001,#3,$);
+#2= IFCCARTESIANPOINT((0.0,0.0,0.0));
+#3= IFCAXIS2PLACEMENT3D(#2,$,$);
+#4= IFCGEOMETRICREPRESENTATIONSUBCONTEXT('Axis','Model',*,*,*,*,#1,$,.MODEL_VIEW.,$);
+#5= IFCGEOMETRICREPRESENTATIONSUBCONTEXT('Body','Model',*,*,*,*,#1,$,.MODEL_VIEW.,$);
+/* defines the default building (as required as the minimum spatial element)  */
+#50= IFCBUILDING('39t4Pu3nTC4ekXYRIHJB9W',$,'IfcBuilding',$,$,$,$,$,$,$,$,$);
+#51= IFCRELCONTAINEDINSPATIALSTRUCTURE('3Sa3dTJGn0H8TQIGiuGQd5',$,'Building','Building Container for Elements',(#211),#50);
+#52= IFCAXIS2PLACEMENT3D(#2,$,$);
+#100= IFCPROJECT('0$WU4A9R19$vKWO$AdOnKA',$,'IfcProject',$,$,$,$,(#1),#101);
+#101= IFCUNITASSIGNMENT((#102,#103,#104));
+#102= IFCSIUNIT(*,.LENGTHUNIT.,.MILLI.,.METRE.);
+#103= IFCSIUNIT(*,.PLANEANGLEUNIT.,$,.RADIAN.);
+#104= IFCSIUNIT(*,.TIMEUNIT.,$,.SECOND.);
+#105= IFCRELAGGREGATES('091a6ewbvCMQ2Vyiqspa7a',$,'Project Container','Project Container for Buildings',#100,(#50));
+#200= IFCCARTESIANPOINTLIST2D(((2.8,-79.5),(2.8,79.5),(6.31471899999999,87.985281),(14.8,91.5),(50.0,91.5),(50.0,100.0),(-50.0,100.0),(-50.0,91.5),(-14.8,91.5),(-6.31471899999997,87.985281),(-2.79999999999999,79.5),(-2.8,-79.5),(-6.31471899999999,-87.985281),(-14.8,-91.5),(-50.0,-91.5),(-50.0,-100.0),(50.0,-100.0),(50.0,-91.5),(14.8,-91.5),(6.31471899999997,-87.985281)),$);
+#201= IFCINDEXEDPOLYCURVE(#200,(IFCLINEINDEX((1,2)),IFCARCINDEX((2,3,4)),IFCLINEINDEX((4,5,6,7,8,9)),IFCARCINDEX((9,10,11)),IFCLINEINDEX((11,12)),IFCARCINDEX((12,13,14)),IFCLINEINDEX((14,15,16,17,18,19)),IFCARCINDEX((19,20,1))),.F.);
+#202= IFCARBITRARYCLOSEDPROFILEDEF(.AREA.,'IPE200',#201);
+#203= IFCCARTESIANPOINT((0.0,0.0,0.0));
+#204= IFCDIRECTION((0.0,1.0,0.0));
+#205= IFCDIRECTION((1.0,0.0,0.0));
+#206= IFCAXIS2PLACEMENT3D(#203,#204,#205);
+#207= IFCDIRECTION((0.0,0.0,1.0));
+#208= IFCEXTRUDEDAREASOLID(#202,#206,#207,1000.0);
+#209= IFCSHAPEREPRESENTATION(#5,'Body','SweptSolid',(#208));
+#210= IFCPRODUCTDEFINITIONSHAPE($,$,(#209));
+#211= IFCBEAM('0EF5_zZRv0pQPddeofU3KT',$,'ExampleBeamName','ExampleBeamDescription',$,#213,#210,'Tag',$);
+#212= IFCAXIS2PLACEMENT3D(#2,$,$);
+#213= IFCLOCALPLACEMENT($,#212);
+ENDSEC;
+
+END-ISO-10303-21;
+