"""``hermes insights`` subcommand parser."""

from __future__ import annotations

from typing import Callable


def build_insights_parser(subparsers, *, cmd_insights: Callable) -> None:
    """Attach the ``insights`` subcommand to ``subparsers``."""
    insights_parser = subparsers.add_parser(
        "insights", help="Show usage insights and analytics",
        description="Analyze session history to show token usage, costs, tool patterns, and activity trends",
    )
    insights_parser.add_argument(
        "--days", type=int, default=30, help="Number of days to analyze (default: 30)")
    insights_parser.add_argument(
        "--source", help="Filter by platform (cli, telegram, discord, etc.)")
    insights_parser.set_defaults(func=cmd_insights)