xc-mcp/dist/tools/cache/get-stats.d.ts

MCP server that wraps Xcode command-line tools for iOS/macOS development workflows

import type { ToolResult } from '../../types/xcode.js';
/**
 * Get comprehensive statistics across all XC-MCP cache systems
 *
 * **What it does:**
 * Retrieves detailed statistics from the simulator cache, project cache, and response cache
 * systems. Shows hit rates, entry counts, storage usage, and performance metrics across all
 * caching layers. Essential for monitoring cache effectiveness and identifying optimization
 * opportunities.
 *
 * **Why you'd use it:**
 * - Monitor cache performance and effectiveness across simulator, project, and response caches
 * - Understand cache hit rates to optimize build and test workflows
 * - Track memory usage and identify opportunities to tune cache configurations
 * - Debug performance issues by analyzing cache patterns and expiry times
 *
 * **Parameters:**
 * None required - retrieves statistics from all cache systems automatically
 *
 * **Returns:**
 * JSON object containing:
 * - simulator: SimulatorCache statistics (device usage, boot performance, hit rates)
 * - project: ProjectCache statistics (build configurations, successful patterns)
 * - response: ResponseCache statistics (progressive disclosure entries, token savings)
 * - timestamp: ISO timestamp of when statistics were collected
 *
 * **Example:**
 * ```typescript
 * const stats = await getCacheStatsTool({});
 * // Returns:
 * // {
 * //   "simulator": {
 * //     "totalEntries": 15,
 * //     "hitRate": 0.85,
 * //     "averageBootTime": 12000
 * //   },
 * //   "project": {
 * //     "totalProjects": 3,
 * //     "cachedBuilds": 12
 * //   },
 * //   "response": {
 * //     "totalEntries": 8,
 * //     "byTool": {"xcodebuild-test": 5, "xcodebuild-build": 3}
 * //   }
 * // }
 * ```
 *
 * **Full documentation:** See cache/get-stats.md for detailed parameters and examples
 *
 * @param _args Tool arguments (none required)
 * @returns Tool result with comprehensive cache statistics
 */
export declare function getCacheStatsTool(_args: any): Promise<ToolResult>;
export declare const CACHE_GET_STATS_DOCS = "\n# cache-get-stats\n\n\uD83D\uDCCA **Get comprehensive statistics across all XC-MCP cache systems** - Monitor cache performance and effectiveness.\n\nRetrieves detailed statistics from the simulator cache, project cache, and response cache systems. Shows hit rates, entry counts, storage usage, and performance metrics across all caching layers. Essential for monitoring cache effectiveness and identifying optimization opportunities.\n\n## Advantages\n\n\u2022 Monitor cache performance across all simulator, project, and response caches\n\u2022 Understand cache hit rates to optimize build and test workflows\n\u2022 Track memory usage and identify tuning opportunities\n\u2022 Debug performance issues by analyzing cache patterns\n\n## Parameters\n\n### Required\n- (None - retrieves statistics from all cache systems automatically)\n\n### Optional\n- (None)\n\n## Returns\n\n- Tool execution results with structured cache statistics\n- Statistics for each cache system (simulator, project, response)\n- Hit rates, entry counts, and performance metrics\n- Timestamp of statistics collection\n\n## Related Tools\n\n- cache-set-config: Configure cache retention times\n- cache-get-config: Get current cache configuration\n- cache-clear: Clear cached data\n\n## Notes\n\n- Tool is auto-registered with MCP server\n- Statistics are calculated in real-time\n- Use regularly to monitor cache effectiveness\n- Export statistics for performance analysis across time\n";
//# sourceMappingURL=get-stats.d.ts.map