Sync docs from superdb-mcp

Author: superdb-mcp-sync

_build/expert-guide.md

@@ -3,8 +3,8 @@ title: "Expert Guide"
 description: "Expert guide for SuperDB queries and data transformations. Covers syntax, patterns, and best practices."
 layout: default
 nav_order: 2
-superdb_version: "0.2.0"
-last_updated: "2026-01-31"
+superdb_version: "0.3.0"
+last_updated: "2026-03-27"
 ---
 
 # SuperDB Expert Guide

_build/tutorials/bash_to_sup.md

@@ -4,7 +4,7 @@ description: "Getting raw text safely from Bash into SuperDB without manual esca
 layout: default
 nav_order: 1
 parent: Tutorials
-superdb_version: "0.2.0"
+superdb_version: "0.3.0"
 last_updated: "2026-02-17"
 ---
 

_build/tutorials/chess-tiebreaks.md

@@ -4,7 +4,7 @@ description: "End-to-end tutorial parsing PGN chess data to find tie-break games
 layout: default
 nav_order: 2
 parent: Tutorials
-superdb_version: "0.2.0"
+superdb_version: "0.3.0"
 last_updated: "2026-02-15"
 ---
 

_build/tutorials/fork_for_window.md

@@ -4,7 +4,7 @@ description: "Using fork as a workaround for window functions to do per-group se
 layout: default
 nav_order: 3
 parent: Tutorials
-superdb_version: "0.2.0"
+superdb_version: "0.3.0"
 last_updated: "2026-02-20"
 ---
 

_build/tutorials/grok.md

@@ -4,7 +4,7 @@ description: "Tutorial on using the grok function for text parsing in SuperDB."
 layout: default
 nav_order: 4
 parent: Tutorials
-superdb_version: "0.2.0"
+superdb_version: "0.3.0"
 last_updated: "2026-02-15"
 ---
 

_build/tutorials/joins.md

@@ -4,7 +4,7 @@ description: "Examples of outer joins, anti joins, and full outer joins in Super
 layout: default
 nav_order: 5
 parent: Tutorials
-superdb_version: "0.2.0"
+superdb_version: "0.3.0"
 last_updated: "2026-02-15"
 ---
 

_build/tutorials/subqueries.md

@@ -4,7 +4,7 @@ description: "Examples of correlated subqueries and derived table patterns in Su
 layout: default
 nav_order: 6
 parent: Tutorials
-superdb_version: "0.2.0"
+superdb_version: "0.3.0"
 last_updated: "2026-02-15"
 ---
 

_build/tutorials/sup_to_bash.md

@@ -4,7 +4,7 @@ description: "Optimizing SuperDB output into Bash variables efficiently."
 layout: default
 nav_order: 7
 parent: Tutorials
-superdb_version: "0.2.0"
+superdb_version: "0.3.0"
 last_updated: "2026-02-15"
 ---
 

_build/tutorials/unnest.md

@@ -4,7 +4,7 @@ description: "Guide to the unnest operator including nested unnest...into patter
 layout: default
 nav_order: 8
 parent: Tutorials
-superdb_version: "0.2.0"
+superdb_version: "0.3.0"
 last_updated: "2026-02-15"
 ---
 

_build/upgrade-guide.md

@@ -3,13 +3,13 @@ title: "Upgrade Guide"
 description: "Migration guide from zq to SuperDB. Covers all breaking changes and syntax updates."
 layout: default
 nav_order: 3
-superdb_version: "0.2.0"
-last_updated: "2026-01-31"
+superdb_version: "0.3.0"
+last_updated: "2026-03-27"
 ---
 
 # Upgrading zq to super
 
-SuperDB Version 0.2.0
+SuperDB Version 0.3.0
 
 This guide covers all breaking changes between zq and the current SuperDB
 release.
@@ -47,6 +47,9 @@ This table covers ALL breaking changes. Complex items reference detailed section
 | String concat    | `"a" + "b"`                 | `f'{a}{b}'`, `a \|\| b`, or `concat`     |
 | count type       | returns `uint64`            | returns `int64`                          |
 | Dynamic from     | `from pool`                 | `from f'{pool}'` (see section)           |
+| BSUP format      | BSUP v1                     | BSUP v2 (v1 no longer readable)          |
+| collect/union    | preserves all errors        | drops `error("quiet")` values            |
+| concat/f-strings | errors propagate            | `null` values ignored                    |
 
 ## CLI Changes
 
@@ -438,6 +441,41 @@ super -s -c "values 1,2,3 | aggregate cnt:=count() | typeof(cnt)"
 <int64>
 ```
 
+## Changes in v0.3.0
+
+### BSUP v2 format (breaking)
+
+As of v0.3.0, the BSUP binary format has been advanced to v2. `super` will no
+longer read BSUP v1 format as input. If you have valuable data stored in BSUP v1
+files, convert them using a v0.2.0 binary before upgrading:
+
+```bash
+# Convert v1 BSUP to SUP (using old binary), then back to v2 BSUP (using new binary)
+super-0.2.0 -s data.bsup > data.sup
+super -f bsup data.sup > data-v2.bsup
+```
+
+### collect and union drop quiet errors
+
+In `collect` and `union` aggregate functions, `error("quiet")` values are now
+dropped. `error("missing")` values are still preserved.
+
+### null values ignored in concat and f-strings
+
+The `concat` function and f-string interpolation now silently ignore `null`
+values instead of propagating them.
+
+### New features in v0.3.0
+
+- **`debug` operator** — new operator for debugging pipelines
+- **`infer` operator** — new operator for type inference
+- **`defuse` function** — new function for error handling
+- **`unblend` function** — new function for type separation
+- **`db vacate` command** — new command to vacate database pools
+- **Optional fields in record expressions** — record fields can now be marked optional
+- **Fusion types** — new type system feature
+- **Named types in `upcast` function**
+
 ## Formatting Conventions
 
 When performing upgrades, follow these formatting conventions for consistency: