perf: optimize WASIX PGlite runtime benchmarks

Align the WASIX asset build with the audited PGlite source path and make the release asset profile performance-oriented by default.

Add native Postgres and exact PGlite benchmark diagnostics, remove the spinlock-disabling build flag, refresh generated assets/AOT artifacts, and document the current performance findings and remaining optimization work.

Author: f0rr0

.gitmodules

@@ -5,7 +5,7 @@
 [submodule "assets/checkouts/postgres-pglite"]
 	path = assets/checkouts/postgres-pglite
 	url = https://github.com/electric-sql/postgres-pglite
-	branch = REL_17_5_WASM-pglite-builder
+	branch = REL_17_5-pglite
 [submodule "assets/checkouts/pglite"]
 	path = assets/checkouts/pglite
 	url = https://github.com/electric-sql/pglite.git

Cargo.lock

@@ -52,15 +52,15 @@ extensions = [
 
 [package.metadata.pglite-oxide.assets]
 postgres-version = "17.5"
-postgres-pglite-branch = "REL_17_5_WASM-pglite-builder"
+postgres-pglite-branch = "REL_17_5-pglite"
 pglite-build-repo = "electric-sql/pglite-build"
 pglite-build-branch = "portable"
 pglite-build-commit = "c195113dbaf09488f8d5eeb2db91dacd123b74d0"
-pglite-npm-version-checked = "0.4.4"
-runtime-archive-sha256 = "acb15508381101bcb5a25ef58d7150b2aa4fc6c4f79da2329e6876a7f1db2265"
-pglite-wasix-sha256 = "8043b5b330722c02ef4f36b491cceec8d12e524b800f291594f44cc9e27e264e"
+pglite-npm-version-checked = "0.4.5"
+runtime-archive-sha256 = "bbfd28372315c3e39e990513ae36bae56cc20a02b23dd4853542ec1c87ab8db0"
+pglite-wasix-sha256 = "70e81997f3425efcf32b4053a0dff70295c100b0ba7f3887288a267b4488daa9"
 pgdata-template-archive-sha256 = "a0a91f4fbd0428787ce78b351ee84f0c33f9ce8578448701b0f6080f7d8b052e"
-pg-dump-wasix-sha256 = "30ff71f1dd82b164ce2a4f595018217f3de7f946c297f0deba0f66f51127193e"
+pg-dump-wasix-sha256 = "879ef78363f4913fbc35ddc7d9de91812fd21e54bdd450cb527b4ba1746cd04f"
 
 [dependencies]
 anyhow = "1"
@@ -75,6 +75,8 @@ regex = "1"
 tempfile = "3"
 hex = "0.4"
 sha2 = "0.10"
+dunce = "1"
+filetime = "0.2"
 pglite-oxide-assets = { version = "=0.3.0", path = "crates/assets", optional = true }
 tokio = { version = "1", features = ["rt-multi-thread"] }
 wasmer = { version = "7.2.0-alpha.2", default-features = false, features = [

Cargo.toml

@@ -23,9 +23,9 @@ The crate targets PostgreSQL 17.x PGlite builds and Rust 1.92+.
 cargo add pglite-oxide serde_json
 ```
 
-Default features include bundled runtime assets and cache warming hooks.
-Size-sensitive builds can opt out with `default-features = false` and provide
-runtime assets explicitly.
+Default features include bundled runtime assets, extension support, and cache
+warming hooks. Size-sensitive builds can opt out with `default-features = false`
+and provide runtime assets explicitly.
 
 ## Direct Embedded API
 
@@ -97,24 +97,25 @@ Use the printed URL with your normal Postgres client library.
 
 ## How It Works
 
-`pglite-oxide` is moving to a WASIX dynamic-linking asset pipeline. CI owns the
-expensive work: building PGlite, extension side modules, `pg_dump`, and
-target-specific Wasmer LLVM AOT artifacts. Application code gets a small API,
-preload hooks, and package-managed assets.
+`pglite-oxide` runs PGlite/Postgres from packaged WASIX runtime assets and loads
+precompiled Wasmer artifacts for the host target. Application code gets a small
+Rust API, optional preload hooks, and a local Postgres server mode for existing
+client libraries.
 
-The pgvector path is staged in that pipeline and will become public only after
-the Rust runtime passes `CREATE EXTENSION vector`, vector insert, and distance
-query smoke tests.
+Bundled SQL extensions are installed on demand. `pgvector` and `pg_trgm` are
+available through the `extensions` API.
 
 ## Docs
 
 - [Usage guide](https://github.com/f0rr0/pglite-oxide/blob/main/docs/USAGE.md)
 - [Extensions](https://github.com/f0rr0/pglite-oxide/blob/main/docs/EXTENSIONS.md)
-- [Runtime and performance notes](https://github.com/f0rr0/pglite-oxide/blob/main/docs/RUNTIME.md)
-- [Performance plan](https://github.com/f0rr0/pglite-oxide/blob/main/docs/PERFORMANCE.md)
-- [pg_dump status](https://github.com/f0rr0/pglite-oxide/blob/main/docs/PG_DUMP.md)
+- [Runtime](https://github.com/f0rr0/pglite-oxide/blob/main/docs/RUNTIME.md)
+- [Performance](https://github.com/f0rr0/pglite-oxide/blob/main/docs/PERFORMANCE.md)
+- [pg_dump](https://github.com/f0rr0/pglite-oxide/blob/main/docs/PG_DUMP.md)
 - [Tauri usage](https://github.com/f0rr0/pglite-oxide/blob/main/docs/TAURI.md)
 - [Tauri SQLx profiler example](https://github.com/f0rr0/pglite-oxide/blob/main/examples/tauri-sqlx-vanilla)
 - [Development guide](https://github.com/f0rr0/pglite-oxide/blob/main/docs/DEVELOPMENT.md)
 - [Runtime asset provenance](https://github.com/f0rr0/pglite-oxide/blob/main/docs/ASSETS.md)
 - [Release process](https://github.com/f0rr0/pglite-oxide/blob/main/docs/RELEASE.md)
+- [Completed implementation work](https://github.com/f0rr0/pglite-oxide/blob/main/docs/DONE.md)
+- [Implementation backlog](https://github.com/f0rr0/pglite-oxide/blob/main/docs/TODO.md)