I still have my reservations about zref-clever [1], but so far the things that I thought were bugs have been resolved by me learning more how to use it. I find the documentation very hard to read, in the particular way of something written by an expert that is trying but still overestimating the reader's background. (Insert xkcd experts overestimate average familiarity [2].) But, documentation that I can *eventually* use to solve my problem is so SOOOO much better than nothing.
[1]: https://github.com/gusbrs/zref-clever
[2]: https://xkcd.com/2501/