# TinyRustLM Rust Runtime Source Bundle

This durable source note preserves the local Rust/WASM runtime files supplied for the ModelBreeder.com v2.3.0 comparison pass. The raw source files are stored under `docs/tinyrustlm-source/` inside the deployable ZIP so the implementation trail is not lost. The public curriculum uses these files as evidence for a browser-local model-breeding lab path, not as a compiled runtime bundled into the site.

## Runtime themes extracted for site theory

- A strict `.slm` model format with header, tensor directory, tokenizer section, checksums, and supported tensor dtypes.
- A validated adapter-delta pipeline using raw, sparse, and low-rank package formats with model identity checks before application.
- Deterministic local generation with configurable temperature, top-k, top-p, seed, KV cache state, diagnostics, and bounded result buffers.
- Quantized matvec paths for q8_0 and q4_0 plus f32 fallback paths.
- WASM exports that keep browser interactions inside a narrow ABI: allocate, load model, validate adapter, apply adapter, generate, and read diagnostics.
- Native eval-case sidecar generation that turns local test cases into quality-gate evidence.

## Source files and checksums

| File | Bytes | SHA-256 |
|---|---:|---|
| `docs/tinyrustlm-source/model.rs` | 68445 | `2fa2149c17d301271316eae29d214887597c63a313997c61ca5225f785c2373e` |
| `docs/tinyrustlm-source/generate.rs` | 49054 | `5880a713465935ca9937044dcc0f82741d08dc3b248f4a5f04f9e5bfc3207db8` |
| `docs/tinyrustlm-source/adapter.rs` | 19168 | `e45628be16c7758c3a60c190ff866732a03bc442556bd35d81bd183d64b26df6` |
| `docs/tinyrustlm-source/tokenizer.rs` | 17504 | `ab51e0eda9f89e1567d5a3610dd97902390f8e8e9b22283137a089659fb13750` |
| `docs/tinyrustlm-source/eval_runner.rs` | 14645 | `4907408005acfa229c9ba8e2007eb95612fcd07c5f0c3ea17c2ce5b45624ca1a` |
| `docs/tinyrustlm-source/model_format.rs` | 11788 | `b2041c774bb82009a57904a28ebeb5a08bb713fdafcb30c5f83ccc6b4f8289d5` |
| `docs/tinyrustlm-source/diagnostics.rs` | 9646 | `e48b2478938e73afc8f486a6a21c360a864434bdc7efad152ae3c7d7033bea0e` |
| `docs/tinyrustlm-source/sampler.rs` | 6972 | `2fdb1bc4ba798258a4adf2034b3ed931083377e4c276e3d1bf5ac46eec26488f` |
| `docs/tinyrustlm-source/ops.rs` | 6310 | `47d6fedd08b4dc3059f36c3203c13e0eca8f53f2f18dcdc46b20a4a4e5b1028b` |
| `docs/tinyrustlm-source/kv_cache.rs` | 5959 | `0885152e6b189b894da5ce4a2f438b4f1068fab3c96e4709ec8372e0da97edd1` |
| `docs/tinyrustlm-source/quant.rs` | 5721 | `90e9f3103d39d00a75a1ac52756436d745eb0d24de748affe5c3f462b183a914` |
| `docs/tinyrustlm-source/wasm_exports.rs` | 5227 | `fb382f3a85d8232a9fb58aaf9f3f3612722fb578a2f1d327db58e1baf1753185` |
| `docs/tinyrustlm-source/tensor.rs` | 3942 | `611ed2feea28b9e53d415291f9e1962b4eb6d56657437fb61af16e994b710589` |
| `docs/tinyrustlm-source/errors.rs` | 2622 | `93b775552f722b3c7dedd5b6ac36f1e95149d1f52afc8ce8674207bae7deba6a` |
| `docs/tinyrustlm-source/memory.rs` | 1465 | `078bc01720160fb816d5ecff493f4184417d985accf45ec9c5d0f0bc5874fa59` |
| `docs/tinyrustlm-source/lib.rs` | 1383 | `7fdfe094576f7cb4c63847e6594cbf9dfcd4130f48b6ae7ee95426043364d578` |
| `docs/tinyrustlm-source/rope.rs` | 1055 | `8f760bf3b39f72c2270533c4b50f9f5769639ae02c5208b584f836898e73ace6` |

## Implementation boundary

The current ModelBreeder.com package remains a plain PHP research site. The Rust runtime files are preserved as long-term technical source memory and have been used to expand architecture, lab, and tool guidance. They are not executed by the PHP site build, and the site does not ship model weights.