Update code comments

hexstate_requantize.py

@@ -1,15 +1,27 @@
 #!/usr/bin/env python3
 """
-HExState GGUF Re-Quantizer — GGUF-to-GGUF Q2_K quantization.
+HexState GGUF Re-Quantizer — GGUF-to-GGUF HPC quantization.
 
 Reads a source GGUF (F16/BF16/F32), copies all metadata verbatim,
-and re-quantizes eligible weight tensors to Q2_K using numpy.
+and re-quantizes eligible weight tensors using the HExState HPC engine
+(Shor-optimized Griffiths-Niu measurement via libhexstate_q2k.so).
 
-This bypasses the tokenizer parsing problem entirely — the source GGUF
-(from llama.cpp's convert_hf_to_gguf.py) has correct metadata.
+Quantization tiers:
+  - Attention Q/K/V/O + DeltaNet SSM projections → Q4_0 (HPC-optimized)
+  - FFN / MLP weight matrices                    → Q2_K (HPC-optimized)
+  - Embeddings, norms, biases, LM head           → kept at source precision
+
+Falls back to a pure numpy Q2_K implementation if the C library is not built.
 
 Usage:
-    python3 hexstate_requantize.py input.gguf output.gguf
+    python3 hexstate_requantize.py input.gguf output.gguf [options]
+
+Options:
+    --config <file>     Load HuggingFace config.json for arch detection
+    --imatrix <file>    Importance matrix for calibrated quantization
+    --keep-metadata     Preserve all GGUF metadata as-is
+    --q2all             Force all eligible tensors to Q2_K
+    --quantize-none     Skip quantization (passthrough)
 """
 
 import struct