Refactor: libcib: clarify pointer arguments in headers

Mark pointer arguments as const where appropriate, and ensure
doxygen blocks use [in] or [in,out] as appropriate.

This is not comprehensive but focuses on functions that have doxygen blocks
in headers under include/ and some functions called by them.