# How it works

This shelf is for contributors who want to know how Bookclerk is built:
the crates, the job queue, the storage limits, and how every plugin is
confined. It assumes you can read Rust.

## Pages on this shelf

- [Architecture](/docs/internals/architecture/index.md): how the pieces fit.
- [Discovery design](/docs/internals/discovery/index.md): how suggestions are found and ranked.
- [Embedding model benchmarks](/docs/internals/embedding-benchmarks/index.md): how candidate
  models match taste across languages, and what they cost to run.
- [Embedding model packs](/docs/internals/model-packs/index.md): how a model is stored on
  disk, how the `embedder` plugin runs it, and how it was checked.
- [Durable job queue](/docs/internals/jobs/index.md): admission, leases and crash recovery.
- [Bounded storage](/docs/internals/storage-bounds/index.md): size caps, streams, paged scans
  and checkpoints.
- [The guest jail](/docs/internals/guest-jail/index.md): why plugins run as jailed processes,
  and how each platform confines them.
- [workerd bridge](/docs/internals/workerd-bridge/index.md): the wire between the launcher and
  a plugin isolate.
- [Node API and the live socket](/docs/internals/node-api/index.md): how hosts of one library
  talk, and how the web app hears about changes.
- [One TLS backend](/docs/internals/tls/index.md): the one crypto provider every TLS connection
  uses, and where it is set.
- [Windows AppContainer](/docs/internals/windows-appcontainer/index.md): confinement notes for
  Windows.
- [Rust crates](/docs/internals/crates/index.md): the reference for every workspace
  crate, from its doc comments (generated).

## Next steps

- [Contribute](/docs/contributing/index.md): build, test and send a change.
- [Design decisions](/docs/adr/index.md): why things are the way they are.
