module Noir::CLI::CacheCommand

Overview

noir cache <info|clear|purge>

Managed resource: the on-disk LLM response cache.

Defined in:

cli/commands/cache.cr

Constant Summary

ACTION_ARITY = {"info" => 0, "clear" => 0, "purge" => 1}

Positionals each action accepts after the action word. .purge takes <days>; the rest take none. Used to reject surplus argv rather than dropping it, which matters most for .clear: an unrecognized flag used to sail straight through to a real, irreversible wipe.

ACTIONS = ["info", "clear", "purge"] of ::String

MAX_PURGE_DAYS = 36500

Upper bound on noir cache purge <days>. 100 years is well past any realistic cache retention horizon; the actual reason for the cap is Crystal's Time.utc - <days>.days arithmetic, which raises ArgumentError: Invalid time: seconds out of range for values that push the resulting Time past the supported range. 100 years stays comfortably inside the Time bounds.

Class Method Summary

• .clear(io : IO = STDOUT)
• .flag?(arg : String) : Bool

  A leading - marks an option — except on a bare negative number, which is a plausible (if invalid) purge <days> value.

• .format_age(t : Time) : String

  Public for the same reason as .format_bytes.

• .format_bytes(bytes : Int64) : String

  Public so the unit ladder (B/KB/MB/GB) can be exercised directly, matching the testability philosophy the rest of this module follows.

• .orphan_note(outcome : LLM::Cache::DeleteOutcome) : String

  Reclaimed temp files are reported apart from the entry count so "Removed N cache entries" keeps meaning N usable cached responses.

• .parse_argv(argv : Array(String)) : Parsed
• .parse_days(arg : String | Nil) : Int32 | Nil

  Returns days when arg is a positive integer within the representable Time range, nil otherwise.

• .print_help(io : IO = STDOUT)
• .print_info(io : IO = STDOUT)
• .purge(rest : Array(String), io : IO = STDOUT)
• .run(argv : Array(String))
• .usage_for(action : String) : String

  Single-line usage for one action, used in surplus-argument errors.

Class Method Detail