v0.8.0

Supervised metric-loss extension for otuformer finetune.

Added

• Four explicit --loss modes: arcface (default), supcon, subcenter-arcface, subcenter-arcface-compact.
• Loss-aware CLI preflight: unknown or inapplicable flags fail before any output directory or log file is created.
• New options: --subcenters (K, 2-8, both Sub-center modes), --compact-weight (cap fixed at 0.5), --supcon-temperature, --trace-batch-ids.
• Per-epoch logs/loss_diagnostics.finetune.csv and optional logs/batch_ids.finetune.jsonl.
• Checkpoint provenance: seed, source/SSL checkpoint SHA-256, canonical training-manifest SHA-256, optimizer layout, and prototype weight-decay rule.

Changed

• New v0.8.0 ArcFace runs give L2-normalized prototypes zero weight decay. At the default learning rate and weight decay the results are numerically identical to v0.7.x, because the old decay only rescaled the prototype norm.
• Every run log starts with the package version and a best-effort commit of the checkout.
• One shared CLI command formatter renders boolean flags without a value.

Fixed

• Legacy --resume keeps its saved optimizer semantics and rejects conflicting loss/K/weight/temperature settings before creating output.
• SupCon skips unusable batches and fails an epoch with no usable signal instead of saving a checkpoint trained on an empty signal.