Skip to content

Commit 891b080

Browse files
committed
docs: add QMCB columnar pipeline reference to architecture page, update test count to 780+
Architecture page was missing mention of the QMCB zero-copy wire format used for inter-DO communication. Added cross-link to columnar-format page in the query flow section. Updated test count from 735+ to 780+ to reflect current state.
1 parent 3f3c20b commit 891b080

File tree

1 file changed

+4
-2
lines changed

1 file changed

+4
-2
lines changed

docs/src/content/docs/architecture.mdx

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -53,9 +53,11 @@ One per fragment — scales with data, no hard cap. Each scans its assigned frag
5353
- Coalesced R2 range reads
5454
- Prefetch next page while decoding current
5555
- WASM SIMD decode + filter
56-
5. **QueryDO** merges partial results via k-way merge (or hierarchical reduction for large fan-outs)
56+
5. **QueryDO** merges partial results via columnar k-way merge (or hierarchical reduction for large fan-outs)
5757
6. **Response** returned as JSON or streaming columnar format
5858

59+
Data flows between DOs as **QMCB (QueryMode Columnar Binary)** — a zero-copy columnar wire format transferred via structured clone over Worker RPC. This eliminates JSON serialization of millions of rows between DOs. See [Columnar Format](/querymode/columnar-format/) for the wire format details.
60+
5961
## Mental model: biological cells, not a brain
6062

6163
Every Fragment DO runs the same WASM binary — like cells sharing the same DNA. No cell knows the whole organism. No central brain directs them. They activate on signal, do their work, and go dormant.
@@ -269,6 +271,6 @@ Tests run in two runtimes:
269271
|---------|------|-------|
270272
| **workerd** (real CF Workers) | Operators, DOs, decode, format parsing ||
271273
| **Node** | DuckDB conformance (1M-5M rows), fixture files, SQL, infra ||
272-
| **Total** | All runtimes | **735+ tests** |
274+
| **Total** | All runtimes | **780+ tests** |
273275

274276
Conformance tests validate every operator against DuckDB at scale. CI benchmarks compare QueryMode vs DuckDB on every push.

0 commit comments

Comments
 (0)