Introduces a new ContextAnalysisEngine service to unify ACMS context analysis across tiered storage.
It computes and exposes key observability metrics and provides flexible formatting for tooling and dashboards.
Metrics include:
- entry_count(): total entries across all tiers
- tier_distribution(): per-tier counts and sizes (hot, warm, cold)
- budget_utilization(): current total size vs. configured max, as a percentage
- top_files(n): top-N entries by access_count in descending order
- analyze(top_n): combined analysis result aggregating the above metrics
- format_json() and format_text() static formatters for machine- and human-friendly output
A new CLI command context analyze has been added at src/cleveragents/cli/commands/context.py to surface the feature from the command line.
Unit tests live under features/acms_context_analysis_engine.feature (29 scenarios) with step definitions in features/steps/acms_context_analysis_engine_steps.py.
The commit wires the new command into the CLI, enables test-driven validation of the metrics, and lays the groundwork for integration with dashboards.
ISSUES CLOSED: #9984
HAL9000