Documentation Index
Fetch the complete documentation index at: https://docs.bitfield.so/llms.txt
Use this file to discover all available pages before exploring further.
Proof
Warm and cold paths.
Benchmark numbers only mean something when the measured job is named.
The categories
Warm local read = the needed data is already local, the operating system already has the needed file pages ready, and Bitfield knows where to read.Cold local read = the data is local, but the machine still has setup or fetch work to do before the bytes are ready.Content address lookup = Bitfield first resolves the content identity, then reads the bytes.Durable batch write = Bitfield records a batch of writes in the durable write path, then the benchmark divides the batch cost across the written items.Runtime call = app code asks a Bitfield target to do work through Runtime Kit.Network command = a request crosses the network before the app gets an answer.Why the split matters
These jobs are different:| Job | What is included | What is not included |
|---|---|---|
| Warm local read | Local bytes, warm pages, known read shape. | Cold disk fetch, network trip, general database request. |
| Cold local read | Local storage fetch or setup work. | Network trip unless the benchmark says network. |
| Content address lookup | Identity resolution before reading. | Exact-position read with no lookup. |
| Durable batch write | Saved-write work for a batch. | One isolated write measured as its own wall-clock event. |
| Runtime call | Runtime Kit request and reply shape. | Raw storage read cost by itself. |
| Network command | The networked command path. | Local read path by itself. |
The current public rows
Warm local read.The data is local and warm, so Bitfield can read known local bytes without sending a request to a separate database process.
Content address lookup.Bitfield first resolves the data fingerprint, then reads the bytes.
Durable batch write.The measured work includes the saved-write contract for a batch, then divides the batch cost across written items.
Batched write ceiling.This is a ceiling number for a full batch. It is not the same thing as every saved write.