xc-mcp/dist/tools/persistence/enable.d.ts

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

import type { ToolResult } from '../../types/xcode.js';
/**
 * Enable opt-in persistent state management for learning across server restarts
 *
 * **What it does:**
 * Activates file-based persistence for XC-MCP's intelligent caching systems. Stores usage patterns,
 * build preferences, simulator performance metrics, and cached responses to disk. Enables the system
 * to learn and improve over time, remembering successful configurations across server restarts.
 * Privacy-first design: NO source code, credentials, or personal information is persisted.
 *
 * **Why you'd use it:**
 * - Retain learned build configurations and simulator preferences across restarts
 * - Accelerate repeated workflows by persisting successful operation patterns
 * - Enable team collaboration with shared project-local cache optimizations
 * - Maintain performance insights across CI/CD pipeline runs
 *
 * **Parameters:**
 * - cacheDir (string, optional): Custom directory for cache storage. If omitted, uses intelligent
 *   location selection (XC_MCP_CACHE_DIR env var, XDG cache dir, project-local, user home, or temp)
 *
 * **Returns:**
 * JSON object containing:
 * - success: Whether persistence was enabled
 * - message: Confirmation message
 * - cacheDirectory: Resolved storage location
 * - status: Detailed storage information (disk usage, file count, writability)
 * - privacyNotice: Privacy guarantee about what data is stored
 * - nextSteps: Suggested next actions
 *
 * **Example:**
 * ```typescript
 * // Enable with automatic location selection
 * await persistenceEnableTool({});
 *
 * // Enable with custom cache directory
 * await persistenceEnableTool({cacheDir: "/path/to/cache"});
 *
 * // Returns:
 * // {
 * //   "success": true,
 * //   "cacheDirectory": "/Users/dev/.xc-mcp/cache",
 * //   "privacyNotice": "Only usage patterns, build preferences, and performance metrics...",
 * //   "nextSteps": [
 * //     "State will now persist across server restarts",
 * //     "Use persistence-status to monitor storage usage"
 * //   ]
 * // }
 * ```
 *
 * **Full documentation:** See persistence/enable.md for detailed parameters and examples
 *
 * @param args Tool arguments with optional custom cacheDir
 * @returns Tool result with persistence activation confirmation
 */
export declare function persistenceEnableTool(args: any): Promise<ToolResult>;
export declare const PERSISTENCE_ENABLE_DOCS = "\n# persistence-enable\n\n\uD83D\uDD0B **Enable opt-in persistent state management for learning across server restarts** - Activate persistence.\n\nActivates file-based persistence for XC-MCP's intelligent caching systems. Stores usage patterns, build preferences, simulator performance metrics, and cached responses to disk. Enables the system to learn and improve over time, remembering successful configurations across server restarts. Privacy-first design: NO source code, credentials, or personal information is persisted.\n\n## Advantages\n\n\u2022 Retain learned build configurations and simulator preferences across restarts\n\u2022 Accelerate repeated workflows by persisting successful operation patterns\n\u2022 Enable team collaboration with shared project-local cache optimizations\n\u2022 Maintain performance insights across CI/CD pipeline runs\n\n## Parameters\n\n### Required\n- (None)\n\n### Optional\n- cacheDir (string): Custom directory for cache storage. If omitted, uses intelligent location selection\n\n## Returns\n\n- Tool execution results with persistence activation confirmation\n- Cache directory location (resolved or custom)\n- Storage information and writability status\n- Privacy notice and next steps\n\n## Related Tools\n\n- persistence-disable: Turn off persistence\n- persistence-status: View persistence system status\n\n## Notes\n\n- Tool is auto-registered with MCP server\n- Privacy-first design - only patterns and preferences stored\n- Enables team sharing via project-local cache\n- Automatically selects best cache location if not specified\n";
//# sourceMappingURL=enable.d.ts.map