{
  "id": "get_click_monitor_report",
  "mcp_tool": "get_click_monitor_report",
  "status": "approved",
  "source_system": "cake",
  "environment": ["staging", "prod"],
  "sharded": true,
  "shard_schema": "Shorty",
  "shard_view_prefix": "validate_click_monitor",
  "connections": {
    "shorty": "cake_shorty_ro"
  },
  "objects": [
    "Shorty.validate_click_monitor_*"
  ],
  "parameters": {
    "group_by": { "type": "enum", "required": false, "default": "affiliate", "values": ["affiliate", "campaign"] },
    "sort_by": { "type": "enum", "required": false, "default": "entries", "values": ["entries", "unique_clicks"] },
    "sort_dir": { "type": "enum", "required": false, "default": "desc", "values": ["asc", "desc"] },
    "event_type": { "type": "string", "required": false },
    "affiliate_id": { "type": "string", "required": false },
    "campaign_id": { "type": "int", "required": false },
    "date_from": { "type": "date", "required": false },
    "date_to": { "type": "date", "required": false },
    "limit": { "type": "int", "required": false, "default": 50 }
  },
  "constraints": {
    "max_window_days": 31,
    "default_window_days": 7,
    "max_rows": 100,
    "timeout_ms": 60000
  },
  "allow_fields": [
    "affiliate_id",
    "campaign_id",
    "entries",
    "unique_clicks",
    "first_event_at",
    "last_event_at"
  ],
  "deny_fields": ["id", "subid", "q", "page_url", "page_title", "document_referrer", "user_agent", "ip_address", "dump"],
  "post_processing": [
    "Expand Shorty.validate_click_monitor_YYYYMMDD day TABLES (not lucos_ro views) for the requested date window. Shard probe uses information_schema.TABLES so base tables are visible.",
    "Default projection is event_timestamp, aff, cmp, clickid. Do not select event_type unless the caller filters by it — some day tables omit that column.",
    "Aggregate by affiliate (aff) or campaign (cmp). event_type filter is optional and only projected when set.",
    "entries is COUNT(*); unique_clicks is COUNT(DISTINCT clickid).",
    "Campaign id is parsed from cmp only when numeric; non-numeric cmp rows are ignored for campaign grouping."
  ],
  "notes": "Monitor-grain ranking tool for affiliate/campaign click-monitor activity. Shards are Shorty BASE TABLEs named validate_click_monitor_YYYYMMDD (harvested as tableType=BASE TABLE), not lucos_ro_* views. Some shards omit event_type; default ranking does not select it. Distinct from whale click totals in get_advertiser_report/get_campaign_performance_report."
}