Function caches_document 

pub fn caches_document(
    reports: &[CacheReport],
    registered_repositories: Option<usize>,
    containers: &[EngineReport],
) -> Value

The document emitted by devp caches --json.

clear_command is the one field an agent can act on, and it is the only place in this contract that carries a command dev-prune will not run itself: these caches are shared by every project on the machine, so clearing one is a human’s decision. note is present only where there is a cost beyond time. registered_repositories is the denominator behind every dependents field, and is present only when there was a registry to count — a consumer that finds it absent knows the counts are missing because nothing could be counted, not because nothing uses these caches.