(** Command-line interface for cache management

    This module provides Cmdliner-based CLI tools for managing the cache,
    including listing entries, expiring old data, managing flags, and
    viewing statistics.

    The commands are parameterized by an Eio filesystem, allowing the
    calling application to control the Eio environment. *)

(** {1 Command Builders} *)

(** Create get command with given filesystem and app name *)
val get_cmd : app_name:string -> Eio.Fs.dir_ty Eio.Path.t -> Eio.Flow.source_ty Eio.Resource.t -> unit Cmdliner.Cmd.t

(** Create put command with given filesystem and app name *)
val put_cmd : app_name:string -> Eio.Fs.dir_ty Eio.Path.t -> Eio.Flow.source_ty Eio.Resource.t -> unit Cmdliner.Cmd.t

(** Create list command with given filesystem and app name *)
val list_cmd : app_name:string -> Eio.Fs.dir_ty Eio.Path.t -> Eio.Flow.source_ty Eio.Resource.t -> unit Cmdliner.Cmd.t

(** Create expire command with given filesystem and app name *)
val expire_cmd : app_name:string -> Eio.Fs.dir_ty Eio.Path.t -> Eio.Flow.source_ty Eio.Resource.t -> unit Cmdliner.Cmd.t

(** Create clear command with given filesystem and app name *)
val clear_cmd : app_name:string -> Eio.Fs.dir_ty Eio.Path.t -> Eio.Flow.source_ty Eio.Resource.t -> unit Cmdliner.Cmd.t

(** Create flag management command with given filesystem and app name *)
val flag_cmd : app_name:string -> Eio.Fs.dir_ty Eio.Path.t -> Eio.Flow.source_ty Eio.Resource.t -> unit Cmdliner.Cmd.t

(** Create statistics command with given filesystem and app name *)
val stats_cmd : app_name:string -> Eio.Fs.dir_ty Eio.Path.t -> Eio.Flow.source_ty Eio.Resource.t -> unit Cmdliner.Cmd.t

(** Create delete command with given filesystem and app name *)
val delete_cmd : app_name:string -> Eio.Fs.dir_ty Eio.Path.t -> Eio.Flow.source_ty Eio.Resource.t -> unit Cmdliner.Cmd.t

(** Create exists command with given filesystem and app name *)
val exists_cmd : app_name:string -> Eio.Fs.dir_ty Eio.Path.t -> Eio.Flow.source_ty Eio.Resource.t -> unit Cmdliner.Cmd.t

(** {1 Command Groups} *)

(** Create all cache commands for the given filesystem, stdin and app name *)
val make_commands : app_name:string -> Eio.Fs.dir_ty Eio.Path.t -> Eio.Flow.source_ty Eio.Resource.t -> unit Cmdliner.Cmd.t list

(** Create main command group containing all cache subcommands *)
val make_cmd : app_name:string -> Eio.Fs.dir_ty Eio.Path.t -> Eio.Flow.source_ty Eio.Resource.t -> unit Cmdliner.Cmd.t