@bldrs-ai/conway 1.325.1034 → 1.327.1045

package/README.md

@@ -177,20 +177,38 @@ Every PR is gated on two checks defined in `.github/workflows/build.yml`:
 
 | Job | What it does |
 |---|---|
-| `build` | `yarn install`, WASM + TS compile (WASM cached on the `conway-geom` submodule SHA), `yarn test`, `yarn lint`. |
-| `run-ifc-regression` | `needs: build`. Reuses the same WASM cache. Runs the regression batch against the pinned `test-models` tag, posts a per-PR comment with `failed.csv` / `errors.csv` / perf summaries, and uploads the candidate npm tarball + `perf.csv` as workflow artifacts. |
+| `build` | `yarn install`, WASM + TS compile (WASM cached on the `conway-geom` submodule SHA), `yarn test`, `yarn lint`, and a Tier-A geometry-digest check of the in-repo `data/` models against committed goldens. |
+| `run-ifc-regression` | `needs: build`. Reuses the same WASM cache. Runs the regression batch against the public `test-models` ref (`TEST_MODELS_REF`, default `main`), pinned per-run to the resolved commit SHA; posts a per-PR comment with the resolved SHA + `failed.csv` / `errors.csv` / perf summaries, and uploads the candidate npm tarball + `perf.csv` as workflow artifacts. |
 
 A merge to `main` re-runs those two jobs and then chains into `auto-publish` (see [Releases](#releases) below).
 
 ## Regression batch
 
-The same batch the regression CI job runs can be invoked locally — see [regression/README.md](regression/README.md) for digest / verbose / batch modes and the catalog of model fixtures. The CI pinned tag is `TEST_MODELS_TAG` near the top of `build.yml`.
+The same batch the regression CI job runs can be invoked locally — see [regression/README.md](regression/README.md) for digest / verbose / batch modes and the catalog of model fixtures. CI tracks `TEST_MODELS_REF` near the top of `build.yml` (default `main`), resolved to a commit SHA per run and recorded in the PR comment + job summary, so each run is reproducible without relying on test-models cutting tags.
+
+### Tier A: in-repo quick-check models (`data/`)
+
+The `build` job also runs a fast, hermetic geometry gate over every `data/*.ifc` model — no `test-models` clone and no token, so it protects every PR including forks. Each model's geometry digest (the same `ifc_regression_main.js -d` digest the batch produces) is diffed against its committed golden `data/<name>.csv`; a mismatch fails `build` with a re-bless hint. The goldens are checked in (generated by CI's pinned EMSDK toolchain), so the gate is **live**.
+
+**Re-blessing an intended change.** Because the correct digest is only knowable from a CI run on the new code, the gate fails first: that same run uploads the recomputed digests as the `tierA-goldens-<run_id>` artifact, so you download it, commit the new `data/<name>.csv`, and push. One PR, but a fail-then-rebless round-trip rather than a single edit. A brand-new `data/*.ifc` model with no golden yet only warns (it doesn't fail) and emits its candidate digest the same way, to bootstrap.
 
 ## Performance benchmarks
 
 **Tier 1 — Conway-only perf in CI (live).** Every regression run emits a `perf.csv` of `parseTimeMs / geometryTimeMs / totalTimeMs / rssMb / heapUsedMb / heapTotalMb` per model. The top-10 slowest are posted in the PR comment; the full CSV is uploaded as a workflow artifact. This piggybacks on the existing regression batch so cost is ~0 extra runner minutes.
 
-**Tier 2 — full headless-three perf (planned, #314).** A `perf-three` job on `push: main` that runs `scripts/benchmark.cjs` against a clone of [headless-three](https://github.com/bldrs-ai/headless-three), installing the candidate Conway tarball as H3's `@bldrs-ai/conway` dep. Captures PNG renders + per-model timings via H3's rendering server, including a parallel job for `test-models-private`. Tracked in #314.
+**Tier 2 — full headless-three perf in CI (live).** Two jobs,
+`perf-three-public` and `perf-three-private`, run on `push: main`
+(`needs: run-ifc-regression`). Each downloads the candidate Conway tarball
+that the regression job packed, clones [headless-three](https://github.com/bldrs-ai/headless-three)
+at a pinned `H3_SHA`, and forces the whole H3 → adapter → conway chain onto
+the candidate via a yarn `resolutions` override (no `yarn link`), then runs
+`scripts/benchmark.cjs` to time every model. The public job posts a
+per-model table to the merge's PR; the private job (`test-models-private`,
+gated on `secrets.TEST_MODELS_PRIVATE_TOKEN`, never on PR events so forks
+can't leak the secret) posts aggregate stats only, so no private model
+names appear in the public thread. Both compute a cross-version delta vs
+the previous `push: main` run (via the `.github/actions/perf-delta`
+composite action) and upload the detail CSV as a workflow artifact.
 
 
 # Releases
@@ -275,38 +293,23 @@ npm dist-tag add @bldrs-ai/conway@<VERSION> stable
 
 # Roadmap
 
-The CI / release pipeline is now continuous, but there are tracked
-follow-ups to deepen its coverage. Big items first.
-
-### #314 — Performance benchmarks in CI
-
-**Tier 1 — Conway-only perf (done):** the regression batch now emits a
-per-model `perf.csv` (parse/geometry/total time + RSS/heap MB),
-piggybacking on the existing run so there's no extra runner cost. Top-10
-slowest models appear in each PR comment; the full CSV uploads as an
-artifact. See "Performance benchmarks" above.
-
-**Tier 2 — full headless-three perf (next):** an end-to-end render-and-time
-job that runs `scripts/benchmark.cjs` against a clone of
-[headless-three](https://github.com/bldrs-ai/headless-three). To avoid the
-local `yarn link` toolchain, the job installs the candidate Conway tarball
-(produced by `run-ifc-regression`) as H3's `@bldrs-ai/conway` dep and pins
-`H3_TAG` in `build.yml`. Gated to `push: main` to keep PR runtime down
-while still exercising every release. A sibling job runs against
-`test-models-private` using `secrets.TEST_MODELS_PRIVATE_TOKEN`, never on
-PR events (so forks can't leak the secret), and uploads results as
-org-scoped artifacts. Delta vs. the previous release lands in the
-auto-publish summary.
-
-### #315 — Bump pinned `TEST_MODELS_TAG`
-
-The regression batch in `build.yml` is pinned to `test-models@0.13.802`.
-If newer stable tags exist, bumping picks up coverage of more recent
-fixtures. The bump itself is a one-line change; the work is triaging
-whatever new diffs appear on a no-op PR run.
-
-### #316 — CI waterfall
-
-Mostly done: `build → run-ifc-regression` is in place and shares the
-WASM cache. The only remaining piece is #314 above (the third leg of
-the waterfall).
+The CI / release pipeline is continuous and complete: `build` gates
+`run-ifc-regression`, which gates the headless-three perf jobs, and every
+green merge to `main` auto-publishes (see [Releases](#releases)). The
+umbrella waterfall (#316) and performance-in-CI (#314) issues are closed.
+The optional follow-ups below remain.
+
+### Headless-three perf on PRs
+
+The `perf-three-public` / `perf-three-private` jobs run on `push: main`
+only — to keep PR wall-time down and to keep the private-models token off
+PR events (forks can't be trusted with it). Running them per-PR, behind a
+gate that withholds the private job from fork PRs, would catch H3
+render-time regressions before merge instead of just after.
+
+### Golden `errors.csv` diffing + regression renders (#288)
+
+Fail a PR when its `errors.csv` diverges from a checked-in golden — "New
+errors detected. Copy errors.csv to golden/errors.csv to accept changes"
+— and attach per-model renders to the regression comment so geometry
+regressions are visible without downloading artifacts.

package/compiled/examples/browser-bundled.cjs

@@ -69608,7 +69608,7 @@ var IfcStepParser = class extends StepParser {
 IfcStepParser.Instance = new IfcStepParser();
 
 // compiled/src/version/version.js
-var versionString = "Conway Web-Ifc Shim v1.325.1034";
+var versionString = "Conway Web-Ifc Shim v1.327.1045";
 
 // compiled/src/statistics/statistics.js
 var Statistics = class {

package/compiled/examples/cli-bundled.cjs

@@ -85869,7 +85869,7 @@ var IfcSceneBuilder = class {
 };
 
 // compiled/src/version/version.js
-var versionString = "Conway Web-Ifc Shim v1.325.1034";
+var versionString = "Conway Web-Ifc Shim v1.327.1045";
 
 // compiled/src/statistics/statistics.js
 var Statistics = class {

package/compiled/examples/validator-bundled.cjs

@@ -69606,7 +69606,7 @@ var IfcStepParser = class extends StepParser {
 IfcStepParser.Instance = new IfcStepParser();
 
 // compiled/src/version/version.js
-var versionString = "Conway Web-Ifc Shim v1.325.1034";
+var versionString = "Conway Web-Ifc Shim v1.327.1045";
 
 // compiled/src/statistics/statistics.js
 var Statistics = class {

package/compiled/src/version/version.js

@@ -1,2 +1,2 @@
-const versionString = 'Conway Web-Ifc Shim v1.325.1034';
+const versionString = 'Conway Web-Ifc Shim v1.327.1045';
 export { versionString };