Что должен возвращать метод `set` при установке нового или обновлении существующего ключа?

Для стандартного Map метод set возвращает сам Map и при вставке, и при обновлении, позволяя цепочки вызовов.

У пользовательского кеша контракт может быть другим: например, void или признак вставки. Без названия реализации нельзя назначить единственно правильный вариант; важно сохранять одинаковую семантику и документировать, влияет ли обновление на порядок.