sfcc-dev-mcp 1.0.15 → 1.0.19

package/docs-site/utils/toolsData.ts

@@ -1,116 +0,0 @@
-// Centralized metadata for MCP tools. Used by ToolsPage for dynamic rendering.
-// Keeps descriptive, param, and example prompt info in one place for reuse.
-
-export type ToolMode = 'docs' | 'full' | 'both';
-export interface ToolParam {
-  name: string;
-  required?: boolean;
-  description: string;
-}
-export interface ToolMeta {
-  id: string; // unique id also used as anchor
-  name: string; // tool name as exposed to MCP
-  category: string;
-  mode: ToolMode; // availability
-  description: string;
-  params?: ToolParam[];
-  examples?: string[]; // example AI prompts or usage
-  tags?: string[];
-  popular?: boolean; // mark for quick actions
-}
-
-// Helper for brevity
-const p = (name: string, description: string, required = true): ToolParam => ({ name, description, required });
-
-export const TOOL_CATEGORIES = [
-  'Documentation',
-  'Best Practices',
-  'SFRA Docs',
-  'Cartridge Generation',
-  'Log Analysis',
-  'System Objects',
-  'Code Versions'
-] as const;
-
-export const tools: ToolMeta[] = [
-  // Documentation (SFCC classes)
-  {
-    id: 'get-sfcc-class-info',
-    name: 'get_sfcc_class_info',
-    category: 'Documentation',
-    mode: 'both',
-    description: 'Detailed information about an SFCC class with filtering and search capabilities: properties, methods, descriptions.',
-    params: [
-      p('className', "SFCC class (e.g. 'Catalog' or 'dw.catalog.Catalog')"), 
-      p('expand', 'Include referenced type details (boolean)', false),
-      p('includeDescription', 'Include class description (boolean, default: true)', false),
-      p('includeConstants', 'Include class constants (boolean, default: true)', false),
-      p('includeProperties', 'Include class properties (boolean, default: true)', false),
-      p('includeMethods', 'Include class methods (boolean, default: true)', false),
-      p('includeInheritance', 'Include inheritance info (boolean, default: true)', false),
-      p('search', 'Filter results by search term (string)', false)
-    ],
-    examples: [
-      'Show methods and properties on dw.catalog.Product',
-      'Show only methods for dw.system.Status class',
-      'Search for "get" methods in dw.catalog.Product',
-      'Show dw.order.Order class without description or constants',
-      'Find "name" related properties and methods in dw.catalog.Product'
-    ],
-    tags: ['api','classes','introspection','filtering','search'],
-    popular: true
-  },
-  { id: 'search-sfcc-classes', name: 'search_sfcc_classes', category: 'Documentation', mode: 'both', description: 'Search SFCC classes by partial name (single word).', params: [p('query', 'Search term (single word)')], examples: ['Find classes related to price','Search for catalog classes'], tags: ['search'], popular: true },
-  { id: 'search-sfcc-methods', name: 'search_sfcc_methods', category: 'Documentation', mode: 'both', description: 'Search methods across all SFCC classes.', params: [p('methodName', 'Method name (single word)')], examples: ['Find get methods on system objects','Search for commit methods'], tags: ['methods','search'] },
-  { id: 'list-sfcc-classes', name: 'list_sfcc_classes', category: 'Documentation', mode: 'both', description: 'List of all available SFCC classes.', examples: ['List all available SFCC classes'] },
-  { id: 'get-sfcc-class-documentation', name: 'get_sfcc_class_documentation', category: 'Documentation', mode: 'both', description: 'Raw markdown documentation for an SFCC class.', params: [p('className','Exact class name')], examples: ['Get raw docs for dw.system.Logger'] },
-
-  // Best Practices
-  { id: 'get-available-best-practice-guides', name: 'get_available_best_practice_guides', category: 'Best Practices', mode: 'both', description: 'List all best practice guides.', examples: ['List available best practice guides'] },
-  { id: 'get-best-practice-guide', name: 'get_best_practice_guide', category: 'Best Practices', mode: 'both', description: 'Full best practice guide content.', params: [p('guideName','Guide name (cartridge_creation, sfra_client_side_js, sfra_scss, security, performance, etc.)')], examples: ['Open the performance best practice guide'], tags: ['guides'] },
-  { id: 'search-best-practices', name: 'search_best_practices', category: 'Best Practices', mode: 'both', description: 'Search within all best practice guides.', params: [p('query','Search term')], examples: ['Search best practices for caching'], tags: ['search'] },
-  { id: 'get-hook-reference', name: 'get_hook_reference', category: 'Best Practices', mode: 'both', description: 'Hook reference tables for OCAPI or SCAPI.', params: [p('guideName','ocapi_hooks | scapi_hooks')], examples: ['List SCAPI hooks for product'] },
-
-  // SFRA Docs
-  { id: 'get-available-sfra-documents', name: 'get_available_sfra_documents', category: 'SFRA Docs', mode: 'both', description: 'List all SFRA documents and models.', examples: ['List SFRA docs categories'] },
-  { id: 'get-sfra-document', name: 'get_sfra_document', category: 'SFRA Docs', mode: 'both', description: 'Full SFRA document (server, request, cart, product-full etc.).', params: [p('documentName','SFRA document name')], examples: ['Show the server module SFRA docs'] },
-  { id: 'search-sfra-documentation', name: 'search_sfra_documentation', category: 'SFRA Docs', mode: 'both', description: 'Search across SFRA docs.', params: [p('query','Search term')], examples: ['Search SFRA docs for middleware'], tags: ['search'] },
-  { id: 'get-sfra-categories', name: 'get_sfra_categories', category: 'SFRA Docs', mode: 'both', description: 'List SFRA document categories with counts.' },
-  { id: 'get-sfra-documents-by-category', name: 'get_sfra_documents_by_category', category: 'SFRA Docs', mode: 'both', description: 'Get SFRA documents for a category.', params: [p('category','core|product|order|customer|pricing|store|other')], examples: ['List all order category SFRA docs'] },
-
-  // Cartridge Generation
-  { id: 'generate-cartridge-structure', name: 'generate_cartridge_structure', category: 'Cartridge Generation', mode: 'both', description: 'Generate cartridge directory structure.', params: [p('cartridgeName','Name of cartridge'), p('targetPath','Target path (optional)', false), p('fullProjectSetup','Include project scaffolding (boolean)', false)], examples: ['Generate cartridge named plugin_demo'], tags: ['scaffold'], popular: true },
-
-  // Log Analysis (Full Mode)
-  { id: 'get-latest-error', name: 'get_latest_error', category: 'Log Analysis', mode: 'full', description: 'Fetch latest error log entries.', params: [p('date','YYYYMMDD (optional defaults today)', false), p('limit','Number of entries', false)], examples: ['Show last 5 error log entries'], tags: ['logs','errors'], popular: true },
-  { id: 'get-latest-warn', name: 'get_latest_warn', category: 'Log Analysis', mode: 'full', description: 'Fetch latest warn log entries.', params: [p('date','YYYYMMDD', false), p('limit','Entries', false)] },
-  { id: 'get-latest-info', name: 'get_latest_info', category: 'Log Analysis', mode: 'full', description: 'Fetch latest info log entries.', params: [p('date','YYYYMMDD', false), p('limit','Entries', false)] },
-  { id: 'get-latest-debug', name: 'get_latest_debug', category: 'Log Analysis', mode: 'full', description: 'Fetch latest debug log entries.', params: [p('date','YYYYMMDD', false), p('limit','Entries', false)] },
-  { id: 'search-logs', name: 'search_logs', category: 'Log Analysis', mode: 'full', description: 'Search across logs for a pattern.', params: [p('pattern','Search string'), p('date','YYYYMMDD', false), p('limit','Entries', false), p('logLevel','error|warn|info|debug', false)], examples: ['Search logs for OCAPI 500 errors'], tags: ['search'] },
-  { id: 'summarize-logs', name: 'summarize_logs', category: 'Log Analysis', mode: 'full', description: 'High level log activity summary.', params: [p('date','YYYYMMDD', false)], examples: ['Summarize today\'s logs'] },
-  { id: 'list-log-files', name: 'list_log_files', category: 'Log Analysis', mode: 'full', description: 'List available log files with metadata.', examples: ['List available log files'] },
-  { id: 'get-log-file-contents', name: 'get_log_file_contents', category: 'Log Analysis', mode: 'full', description: 'Fetch specific log file contents.', params: [p('filename','File name'), p('maxBytes','Max bytes', false), p('tailOnly','Tail only boolean', false)], examples: ['Show tail of error log'] },
-  { id: 'get-latest-job-log-files', name: 'get_latest_job_log_files', category: 'Log Analysis', mode: 'full', description: 'List latest job log files.', params: [p('limit','Number of files', false)], examples: ['List latest 3 job log files'] },
-  { id: 'get-job-log-entries', name: 'get_job_log_entries', category: 'Log Analysis', mode: 'full', description: 'Get job log entries filtered by level.', params: [p('jobName','Job name', false), p('level','error|warn|info|debug|all', false), p('limit','Entries', false)], examples: ['Get last 10 job log entries'] },
-  { id: 'search-job-logs', name: 'search_job_logs', category: 'Log Analysis', mode: 'full', description: 'Search job logs for pattern.', params: [p('pattern','Search string'), p('jobName','Job name', false), p('limit','Entries', false), p('level','error|warn|info|debug|all', false)], examples: ['Search job logs for timeout'] },
-  { id: 'search-job-logs-by-name', name: 'search_job_logs_by_name', category: 'Log Analysis', mode: 'full', description: 'Find job log files by job name.', params: [p('jobName','Partial job name'), p('limit','Files', false)], examples: ['Find job logs for OrderExport'] },
-  { id: 'get-job-execution-summary', name: 'get_job_execution_summary', category: 'Log Analysis', mode: 'full', description: 'Execution summary for specific job.', params: [p('jobName','Job name')], examples: ['Summarize last execution of DailyFeed job'] },
-
-  // System Objects
-  { id: 'get-system-object-definitions', name: 'get_system_object_definitions', category: 'System Objects', mode: 'full', description: 'All system object definitions with pagination support.', params: [p('start','Start index', false), p('count','Max count', false), p('select','Property selector', false)], examples: ['List system object definitions', 'Get first 10 system objects', 'Get system objects starting from index 5'], tags: ['objects'], popular: true },
-  { id: 'get-system-object-definition', name: 'get_system_object_definition', category: 'System Objects', mode: 'full', description: 'Specific system object metadata.', params: [p('objectType','Object type e.g. Product')], examples: ['Get definition for Product object'] },
-  { id: 'search-system-object-attribute-definitions', name: 'search_system_object_attribute_definitions', category: 'System Objects', mode: 'full', description: 'Search attributes for a system object.', params: [p('objectType','System object type'), p('searchRequest','Search request body')], examples: ['Search Product attributes for inventory fields'] },
-  { id: 'search-system-object-attribute-groups', name: 'search_system_object_attribute_groups', category: 'System Objects', mode: 'full', description: 'Search attribute groups for a system object.', params: [p('objectType','System object type'), p('searchRequest','Search request body')], examples: ['List attribute groups for Product object'] },
-  { id: 'search-site-preferences', name: 'search_site_preferences', category: 'System Objects', mode: 'full', description: 'Search site preferences within a group.', params: [p('groupId','Preference group ID'), p('searchRequest','Search request body')], examples: ['Search site preferences in SitePreferencesMarketing group'] },
-  { id: 'search-custom-object-attribute-definitions', name: 'search_custom_object_attribute_definitions', category: 'System Objects', mode: 'full', description: 'Search custom object attributes.', params: [p('objectType','Custom object type'), p('searchRequest','Search request body')], examples: ['Search custom object attributes for Global_String'] },
-
-  // Code Versions
-  { id: 'get-code-versions', name: 'get_code_versions', category: 'Code Versions', mode: 'full', description: 'List all code versions.', examples: ['List available code versions'], popular: true },
-  { id: 'activate-code-version', name: 'activate_code_version', category: 'Code Versions', mode: 'full', description: 'Activate a specific code version.', params: [p('codeVersionId','ID of code version')], examples: ['Activate code version int_2025_09'] }
-];
-
-export const popularTools = tools.filter(t => t.popular);
-export const categoriesWithCounts = TOOL_CATEGORIES.map(cat => ({
-  name: cat,
-  count: tools.filter(t => t.category === cat).length
-}));

package/docs-site/vite.config.ts

@@ -1,63 +0,0 @@
-import path from 'path';
-import { defineConfig, loadEnv } from 'vite';
-
-export default defineConfig(({ mode }) => {
-    const env = loadEnv(mode, '.', '');
-    return {
-      base: '/',
-      build: {
-        target: 'es2018',
-        cssCodeSplit: true,
-        rollupOptions: {
-          output: {
-            manualChunks: (id) => {
-              if (id.includes('node_modules')) {
-                if (id.includes('react')) {
-                  return 'vendor';
-                }
-                if (id.includes('prism')) {
-                  return 'prism';
-                }
-                return 'vendor';
-              }
-            },
-            chunkFileNames: 'assets/[name]-[hash].js',
-            entryFileNames: 'assets/[name]-[hash].js',
-            assetFileNames: 'assets/[name]-[hash].[ext]'
-          },
-        },
-        minify: 'esbuild',
-        sourcemap: false,
-        reportCompressedSize: false,
-        chunkSizeWarningLimit: 1000
-      },
-      esbuild: {
-        drop: mode === 'production' ? ['console', 'debugger'] : [],
-      },
-      css: {
-        postcss: './postcss.config.js',
-        devSourcemap: false
-      },
-      define: {
-        'process.env.API_KEY': JSON.stringify(env.GEMINI_API_KEY),
-        'process.env.GEMINI_API_KEY': JSON.stringify(env.GEMINI_API_KEY)
-      },
-      resolve: {
-        alias: {
-          '@': path.resolve(__dirname, '.'),
-        }
-      },
-      // Performance optimizations
-      optimizeDeps: {
-        include: ['react', 'react-dom', 'react-router-dom'],
-        exclude: []
-      },
-      // SSG specific configuration
-      ssgOptions: {
-        script: 'async',
-        dirStyle: 'nested',
-        includeAllRoutes: true,
-        format: 'esm'
-      },
-    };
-});

package/src/clients/best-practices-client.ts

@@ -1,332 +0,0 @@
-/**
- * SFCC Best Practices Client
- *
- * Provides access to SFCC development best practices documentation including
- * cartridge creation, ISML templates, job framework, LocalServiceRegistry,
- * OCAPI hooks, SCAPI hooks, SCAPI custom endpoints, SFRA controllers, and SFRA models.
- */
-
-import * as fs from 'fs/promises';
-import * as path from 'path';
-import { PathResolver } from '../utils/path-resolver.js';
-import { CacheManager } from '../utils/cache.js';
-import { Logger } from '../utils/logger.js';
-
-export interface BestPracticeGuide {
-  title: string;
-  description: string;
-  sections: string[];
-  content: string;
-}
-
-/**
- * Client for accessing SFCC best practices documentation
- */
-export class SFCCBestPracticesClient {
-  private cache: CacheManager;
-  private docsPath: string;
-  private logger: Logger;
-
-  constructor() {
-    this.cache = new CacheManager();
-    this.docsPath = PathResolver.getBestPracticesPath();
-    this.logger = Logger.getChildLogger('BestPracticesClient');
-  }
-
-  /**
-   * Get all available best practice guides
-   */
-  async getAvailableGuides(): Promise<Array<{name: string; title: string; description: string}>> {
-    const cacheKey = 'best-practices:available-guides';
-    const cached = this.cache.getSearchResults(cacheKey);
-    if (cached) {return cached;}
-
-    const guides = [
-      {
-        name: 'cartridge_creation',
-        title: 'Cartridge Creation Best Practices',
-        description: 'Instructions and best practices for creating, configuring, and deploying custom SFRA cartridges',
-      },
-      {
-        name: 'isml_templates',
-        title: 'ISML Templates Best Practices',
-        description: 'Comprehensive best practices for developing ISML templates within the SFRA framework, including security, performance, and maintainability guidelines',
-      },
-      {
-        name: 'job_framework',
-        title: 'Job Framework Best Practices',
-        description: 'Comprehensive guide for developing custom jobs in the SFCC Job Framework, covering both task-oriented and chunk-oriented approaches with performance optimization and debugging strategies',
-      },
-      {
-        name: 'localserviceregistry',
-        title: 'LocalServiceRegistry Best Practices',
-        description: 'Comprehensive guide for creating server-to-server integrations in SFCC using dw.svc.LocalServiceRegistry, including configuration patterns, callback implementation, OAuth flows, and reusable service module patterns',
-      },
-      {
-        name: 'ocapi_hooks',
-        title: 'OCAPI Hooks Best Practices',
-        description: 'Best practices for implementing OCAPI hooks in Salesforce B2C Commerce Cloud',
-      },
-      {
-        name: 'scapi_hooks',
-        title: 'SCAPI Hooks Best Practices',
-        description: 'Essential best practices for implementing SCAPI hooks with AI development assistance',
-      },
-      {
-        name: 'scapi_custom_endpoint',
-        title: 'Custom SCAPI Endpoint Best Practices',
-        description: 'Best practices for creating custom SCAPI endpoints in B2C Commerce Cloud',
-      },
-      {
-        name: 'sfra_controllers',
-        title: 'SFRA Controllers Best Practices',
-        description: 'Best practices and code patterns for developing SFRA controllers',
-      },
-      {
-        name: 'sfra_models',
-        title: 'SFRA Models Best Practices',
-        description: 'Best practices for developing SFRA models in Salesforce B2C Commerce Cloud',
-      },
-      {
-        name: 'sfra_client_side_js',
-        title: 'SFRA Client-Side JavaScript Best Practices',
-        description: 'Comprehensive patterns for architecting, extending, validating, and optimizing client-side JavaScript in SFRA storefronts using jQuery',
-      },
-      {
-        name: 'sfra_scss',
-        title: 'SFRA SCSS Best Practices',
-        description: 'Implementation-focused SCSS override strategies for SFRA storefronts covering cartridge overlays, theming tokens, responsive mixins, and plugin extension guardrails',
-      },
-      {
-        name: 'performance',
-        title: 'Performance and Stability Best Practices',
-        description: 'Comprehensive performance optimization strategies, coding standards, and stability guidelines for SFCC development including caching, index-friendly APIs, and job development',
-      },
-      {
-        name: 'security',
-        title: 'Security Best Practices',
-        description: 'Comprehensive security best practices for SFCC development covering SFRA Controllers, OCAPI/SCAPI Hooks, and Custom SCAPI Endpoints with OWASP compliance guidelines',
-      },
-    ];
-
-    this.cache.setSearchResults(cacheKey, guides);
-    return guides;
-  }
-
-  /**
-   * Get a specific best practice guide
-   */
-  async getBestPracticeGuide(guideName: string): Promise<BestPracticeGuide | null> {
-    const cacheKey = `best-practices:guide:${guideName}`;
-    const cached = this.cache.getFileContent(cacheKey);
-    if (cached) {return JSON.parse(cached);}
-
-    try {
-      // Enhanced security validation - validate guideName before path construction
-      if (!guideName || typeof guideName !== 'string') {
-        throw new Error('Invalid guide name: must be a non-empty string');
-      }
-
-      // Prevent null bytes and dangerous characters in the guide name itself
-      if (guideName.includes('\0') || guideName.includes('\x00')) {
-        throw new Error('Invalid guide name: contains null bytes');
-      }
-
-      // Prevent path traversal sequences in the guide name
-      if (guideName.includes('..') || guideName.includes('/') || guideName.includes('\\')) {
-        throw new Error('Invalid guide name: contains path traversal sequences');
-      }
-
-      // Only allow alphanumeric characters, underscores, and hyphens
-      if (!/^[a-zA-Z0-9_-]+$/.test(guideName)) {
-        throw new Error('Invalid guide name: contains invalid characters');
-      }
-
-      const filePath = path.join(this.docsPath, `${guideName}.md`);
-
-      // Additional security validation - ensure the resolved path is within the docs directory
-      const resolvedPath = path.resolve(filePath);
-      const resolvedDocsPath = path.resolve(this.docsPath);
-
-      if (!resolvedPath.startsWith(resolvedDocsPath)) {
-        throw new Error('Invalid guide name: path outside allowed directory');
-      }
-
-      // Ensure the file still ends with .md after path resolution
-      if (!resolvedPath.toLowerCase().endsWith('.md')) {
-        throw new Error('Invalid guide name: must reference a markdown file');
-      }
-
-      const content = await fs.readFile(resolvedPath, 'utf-8');
-
-      // Basic content validation
-      if (!content.trim()) {
-        throw new Error(`Empty best practice guide: ${guideName}`);
-      }
-
-      // Check for binary content
-      if (content.includes('\0')) {
-        throw new Error(`Invalid content in best practice guide: ${guideName}`);
-      }
-
-      const lines = content.split('\n');
-      const title = lines.find(line => line.startsWith('#'))?.replace('#', '').trim() ?? guideName;
-
-      // Extract sections (## headers)
-      const sections = lines
-        .filter(line => line.startsWith('##'))
-        .map(line => line.replace('##', '').trim());
-
-      // Extract description (first paragraph after title)
-      const descriptionStart = lines.findIndex(line => line.startsWith('#')) + 1;
-      const descriptionEnd = lines.findIndex((line, index) =>
-        index > descriptionStart && (line.startsWith('#') || line.trim() === ''));
-      const description = lines
-        .slice(descriptionStart, descriptionEnd > -1 ? descriptionEnd : descriptionStart + 3)
-        .join(' ')
-        .trim();
-
-      const guide: BestPracticeGuide = {
-        title,
-        description,
-        sections,
-        content,
-      };
-
-      this.cache.setFileContent(cacheKey, JSON.stringify(guide));
-      return guide;
-    } catch (error) {
-      this.logger.error(`Error reading best practice guide ${guideName}:`, error);
-      return null;
-    }
-  }
-
-  /**
-   * Search across all best practices for specific terms
-   */
-  async searchBestPractices(query: string): Promise<Array<{
-    guide: string;
-    title: string;
-    matches: Array<{section: string; content: string}>;
-  }>> {
-    const cacheKey = `best-practices:search:${query.toLowerCase()}`;
-    const cached = this.cache.getSearchResults(cacheKey);
-    if (cached) {return cached;}
-
-    const guides = await this.getAvailableGuides();
-    const results = [];
-
-    for (const guide of guides) {
-      const guideContent = await this.getBestPracticeGuide(guide.name);
-      if (!guideContent) {continue;}
-
-      const matches = [];
-      const lines = guideContent.content.split('\n');
-      let currentSection = '';
-
-      for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
-
-        if (line.startsWith('##')) {
-          currentSection = line.replace('##', '').trim();
-        }
-
-        if (line.toLowerCase().includes(query.toLowerCase())) {
-          // Get context around the match
-          const start = Math.max(0, i - 2);
-          const end = Math.min(lines.length, i + 3);
-          const context = lines.slice(start, end).join('\n');
-
-          matches.push({
-            section: currentSection || 'Introduction',
-            content: context,
-          });
-        }
-      }
-
-      if (matches.length > 0) {
-        results.push({
-          guide: guide.name,
-          title: guide.title,
-          matches,
-        });
-      }
-    }
-
-    this.cache.setSearchResults(cacheKey, results);
-    return results;
-  }
-
-  /**
-   * Get hook reference tables for OCAPI/SCAPI hooks
-   */
-  async getHookReference(guideName: string): Promise<Array<{
-    category: string;
-    hooks: Array<{endpoint: string; hookPoints: string[]; signature?: string}>;
-  }>> {
-    if (!guideName.includes('hooks')) {return [];}
-
-    const cacheKey = `best-practices:hook-reference:${guideName}`;
-    const cached = this.cache.getSearchResults(cacheKey);
-    if (cached) {return cached;}
-
-    const guide = await this.getBestPracticeGuide(guideName);
-    if (!guide) {return [];}
-
-    const reference = [];
-    const lines = guide.content.split('\n');
-    let currentCategory = '';
-    let inTable = false;
-    let hooks: Array<{endpoint: string; hookPoints: string[]; signature?: string}> = [];
-
-    for (const line of lines) {
-      // Look for hook reference sections
-      if (line.match(/^###?\s+(Shop API Hooks|Data API Hooks|Shopper.*Hooks|.*API Hooks)/i)) {
-        if (currentCategory && hooks.length > 0) {
-          reference.push({ category: currentCategory, hooks: [...hooks] });
-        }
-        currentCategory = line.replace(/^#+\s*/, '');
-        hooks = [];
-        inTable = false;
-      }
-
-      // Detect table headers
-      if (line.includes('API Endpoint') && line.includes('Hook')) {
-        inTable = true;
-        continue;
-      }
-
-      // Skip separator line
-      if (line.match(/^\|[\s\-|]+\|$/)) {
-        continue;
-      }
-
-      // Parse table rows
-      if (inTable && line.startsWith('|') && !line.includes('**')) {
-        const parts = line.split('|').map(p => p.trim()).filter(p => p);
-        if (parts.length >= 2) {
-          const endpoint = parts[0].replace(/`/g, '');
-          const hookPoints = parts[1].split(',').map(h => h.replace(/`/g, '').trim());
-          const signature = parts[2] ? parts[2].replace(/`/g, '') : undefined;
-
-          if (endpoint && hookPoints.length > 0) {
-            hooks.push({ endpoint, hookPoints, signature });
-          }
-        }
-      }
-
-      // End table when we hit a new section
-      if (inTable && line.startsWith('#')) {
-        inTable = false;
-      }
-    }
-
-    // Add last category
-    if (currentCategory && hooks.length > 0) {
-      reference.push({ category: currentCategory, hooks });
-    }
-
-    this.cache.setSearchResults(cacheKey, reference);
-    return reference;
-  }
-}