Nomad changes

.ai-rulez/context/crate-structure.md

@@ -0,0 +1,36 @@
+---
+priority: high
+---
+
+# Crate Structure
+
+Version source of truth: root `Cargo.toml` `[workspace.package] version`.
+
+## Workspace crates (`crates/`)
+
+- `kreuzberg` — core library: extraction engine, MIME detection, plugin system, OCR, chunking, embeddings, API/MCP server
+- `kreuzberg-cli` — CLI binary; thin wrapper over core with `cli` feature set
+- `kreuzberg-ffi` — C FFI layer (`#[no_mangle] extern "C"`); opaque handles, cbindgen headers; used by Go, Java, C# bindings
+- `kreuzberg-node` — NAPI-RS Node.js/TypeScript bindings
+- `kreuzberg-py` — PyO3 Python bindings
+- `kreuzberg-php` — ext-php-rs PHP bindings
+- `kreuzberg-wasm` — wasm-bindgen WASM bindings; uses `wasm-target` feature set
+- `kreuzberg-paddle-ocr` — PaddleOCR via ONNX Runtime; not available on WASM or Windows
+- `kreuzberg-tesseract` — Rust bindings for Tesseract OCR
+
+## Out-of-workspace bindings (`packages/`)
+
+- `packages/python/` — PyPI (maturin + PyO3)
+- `packages/typescript/` — npm type declarations
+- `packages/ruby/` — RubyGems (Magnus); native ext compiled by `rake`
+- `packages/php/` — Composer (ext-php-rs)
+- `packages/go/v5/` — Go module; cgo over kreuzberg-ffi
+- `packages/java/` — Maven; Foreign Function & Memory API over kreuzberg-ffi
+- `packages/csharp/` — NuGet; P/Invoke over kreuzberg-ffi
+- `packages/elixir/` — Hex; Rustler NIF (workspace member at `packages/elixir/native/kreuzberg_rustler`)
+- `packages/r/` — CRAN; extendr (excluded from workspace)
+
+## Tools (`tools/`)
+
+- `tools/e2e-generator` — reads JSON fixtures, generates runnable test suites per language into `e2e/`
+- `tools/benchmark-harness` — criterion-based benchmark runner