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
47
48
49
50
51
52
53
54
55
56
57
58
59
//! `hf2q` foundation module — types and traits shared by both the
//! convert pipeline and the inference/serve pipeline.
//!
//! This module is the in-place precursor to the planned `hf2q-core`
//! crate (workspace v0.1.0 split). It exists so that every type or
//! trait crossing the convert ↔ serve boundary lives in exactly one
//! place, with no circular module dependencies.
//!
//! ## Boundary rule
//!
//! Anything referenced by **both** `crate::{quantize, backends, input,
//! calibrate, quality, models, intelligence}` (the future
//! `hf2q-convert` set) **and** `crate::{inference, serve}` (the future
//! `hf2q-serve` set) lives here. Anything specific to one side stays
//! in its current module.
//!
//! Cyclic dependencies (notably `calibrate` ↔ `inference` around DWQ
//! activation capture) are resolved by extracting the *trait* into
//! this module while the concrete implementations stay in their
//! respective sides.
//!
//! ## Planned submodules
//!
//! Substeps fill these in sequentially; each leaves a `#[deprecated]`
//! re-export shim at the old path so in-flight branches still compile
//! until the workspace split removes the shims.
//!
//! - `provenance/` — GGUF metadata key constants, source-bundle
//! sha256, `SourceShard` (was `src/serve/{provenance,cache}`).
//! - `integrity` — `ShardIntegrity`, `verify_shard`, `verify_repo`
//! (was `src/input/integrity`).
//! - `hardware` — `HardwareProfile`, `HardwareProfiler`,
//! `lookup_memory_bandwidth_gbs` (was `src/intelligence/hardware`).
//! - `traits::activation_capture` — `ActivationCapture` trait,
//! `LayerActivations`, `MockActivationCapture` (was
//! `src/inference/models/qwen35/activation_capture`).
//! - `mlx_linear` — `MlxAffineLinear`, `MlxAffineLinearBytes` (was
//! `src/calibrate/mlx_safetensors_loader`).
//! - `kernel_parity` — `assert_kernel_equivalence` debug helper (was
//! `src/quality/kernel_parity`).
//!
//! `src/backends/chat_templates.rs` does NOT move here; it lands in
//! `src/serve/chat_templates.rs` (serve-only concern; only consumer is
//! `src/serve/mod.rs`).
// B1.2 landed: provenance keys + Provenance enum + detect + sha256 file
// helpers. `SourceShard` + `compute_source_bundle_sha256` deferred to
// B1.3 (alongside `integrity` migration — SourceShard's `from_integrity`
// adapter depends on ShardIntegrity from `src/input/integrity`).