feat(hipblaslt): replay a managed tuning cache (HIPBLASLT_TUNING_MODE=cache)

projects/hipblaslt/CHANGELOG.md

@@ -23,6 +23,7 @@ Full documentation for hipBLASLt is available at [rocm.docs.amd.com/projects/hip
 * Complex CGEMM/ZGEMM support for gfx1250.
 * `TENSILE_FIXED_WGMXCCSPLITK` environment variable to override the split-K work-group XCC mapping factor for StreamK GEMMs.
 * `HIPBLASLT_MATRIX_LAYOUT_OFFSET` matrix-layout attribute for 64-bit element offsets into sub-matrices in General Batched GEMM (`batch_mode=1`), along with `hipblaslt-bench` `batch_offset_a/b/c/d` arguments; nonzero offsets require `HIPBLASLT_BATCH_MODE_POINTER_ARRAY` and are rejected for sub-byte MX types (`HIP_R_6F_E2M3`, `HIP_R_6F_E3M2`, `HIP_R_4F_E2M1`) with `HIPBLAS_STATUS_NOT_SUPPORTED`.
+* Opt-in runtime tuning cache, off by default. `HIPBLASLT_TUNING_MODE=cache` with `HIPBLASLT_TUNING_CACHE_PATH=<file>` replays a tuning file, validating each entry as `HIPBLASLT_TUNING_OVERRIDE_FILE` does. Unlike the override file, it also serves `hipblasLtMatmul` calls that pass no `algo`, and it reports what it loaded and a closing summary of how many problems it served without needing a log level. An explicit `algo` always launches as given. With a tuning mode set, `HIPBLASLT_TUNING_OVERRIDE_FILE` is ignored. A process in a secure execution context ignores both variables.
 
 ### Changed
 
@@ -90,6 +91,7 @@ Full documentation for hipBLASLt is available at [rocm.docs.amd.com/projects/hip
 * A tuning file row cut short, for example when the disk fills while `hipblaslt-bench` appends it, could be replayed with a truncated `solution_index`. A row whose cells do not line up with its header is now ignored.
 * `GemmInstance::getSolutionName()` in `hipblaslt_ext` crashed for a RocRoller solution. It looked the encoded RocRoller index up in the Tensile library and dereferenced the null result. It now returns the RocRoller short name, as `hipblaslt_ext::getSolutionNameFromAlgo()` already did.
 * The logger's destructor called `close()` on the log file, which throws out of a destructor and terminates the process at exit when the log file has failed, for example on a full disk. Reproducible with `HIPBLASLT_LOG_LEVEL=4` and a failing `HIPBLASLT_LOG_FILE`.
+* `hipblasLtMatmul` with no `algo` could return success for a GEMM that never launched. Its status already held the result of choosing the algorithm, and an exception thrown after that returned it unchanged instead of an error.
 
 ## hipBLASLt 1.4.1 for ROCm 7.14