quant-codec-core 0.1.0-alpha.1

Shared codec/profile/shape/eval traits and typed IDs for governed compression experiments
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

# Changelog

All notable changes to `quant-codec-core` are documented here.

## [Unreleased]

## [0.1.0-alpha.1] — 2026-06-02

First crates.io release.

### Added

- `CodecId(String)` — typed identifier for codecs. Validates non-empty.
- `CodecProfileDigest([u8; 32])` — 256-bit profile digest.
- `ArtifactDigest([u8; 32])` — 256-bit artifact digest.
- `ModelFingerprint(String)` — typed model identifier.
- `TokenizerFingerprint(String)` — typed tokenizer identifier.
- `KvRole` — `Key` or `Value` discriminator.
- `DType` — `F32`, `F16`, `BF16`, `I8`, `U8`, `PackedBits`.
- `KvLayout` — `LayersHeadsTokensDim`, `LayersTokensHeadsDim`,
  or a runtime-specific string.
- `LayerId(u32)`, `HeadId(u32)`, `TokenSpan { start, end }` — addressing
  primitives.
- `KvTensorShape` — the canonical KV-cache shape struct.
- `CodecProfile` trait — `codec_id`, `codec_version`,
  `profile_digest`, `fixed_rate_bits`, `block_dim`, `is_lossy`.
- `VectorCodec` trait — `encode_block`, `decode_block`.
- `KvCacheCodec` trait — `encode_kv_cache`, `decode_slice`.
- `EvalReport` — quality metrics: mse, cosine_similarity,
  max_abs_error, bytes_exact, bytes_encoded, passed, notes.

### Lints

- `#![forbid(unsafe_code)]`.
- `cargo clippy --all-targets -- -D warnings` clean.

### Test coverage

- 12 unit tests in `src/`.
- All shape validation invariants tested.
- Digest stability tested across runs.
- Serde round-trip for all public types.
- Trait mock compile test.

[Unreleased]: https://github.com/RecursiveIntell/Libraries/tree/main/poly-kv/crates/quant-codec-core/compare/quant-codec-core-v0.1.0-alpha.1...HEAD
[0.1.0-alpha.1]: https://github.com/RecursiveIntell/Libraries/tree/main/poly-kv/crates/quant-codec-core/releases/tag/quant-codec-core-v0.1.0-alpha.1