magector 2.3.0 → 2.3.1

package/README.md

@@ -2,7 +2,7 @@
 
 **Technology-aware MCP server for Magento 2 and Adobe Commerce with intelligent indexing and search.**
 
-Magector is a Model Context Protocol (MCP) server that deeply understands Magento 2 and Adobe Commerce. It builds a semantic vector index of your entire codebase — 18,000+ files across hundreds of modules — and exposes 28 tools that let AI assistants search, navigate, and understand the code with domain-specific intelligence. Instead of grepping for keywords, your AI asks *"how are checkout totals calculated?"* and gets ranked, relevant results in under 50ms, enriched with Magento pattern detection (plugins, observers, controllers, DI preferences, layout XML, and 20+ more).
+Magector is a Model Context Protocol (MCP) server that deeply understands Magento 2 and Adobe Commerce. It builds a semantic vector index of your entire codebase — 18,000+ files across hundreds of modules — and exposes 34 tools that let AI assistants search, navigate, and understand the code with domain-specific intelligence. Instead of grepping for keywords, your AI asks *"how are checkout totals calculated?"* and gets ranked, relevant results in under 50ms, enriched with Magento pattern detection (plugins, observers, controllers, DI preferences, layout XML, and 20+ more).
 
 [![Rust](https://img.shields.io/badge/rust-1.75+-orange.svg)](https://www.rust-lang.org)
 [![Node.js](https://img.shields.io/badge/node-18+-green.svg)](https://nodejs.org)
@@ -58,7 +58,7 @@ The result: your AI assistant calls one MCP tool and gets ranked, pattern-enrich
 - **Complexity analysis** -- cyclomatic complexity, function count, and hotspot detection across modules
 - **Fast** -- 10-45ms queries via persistent serve process, batched ONNX embedding with adaptive thread scaling
 - **LLM description enrichment** -- generate natural-language descriptions of di.xml files using Claude, stored in SQLite, and prepend them to embedding text so descriptions influence vector search ranking (not just post-retrieval display)
-- **MCP server** -- 28 tools integrating with Claude Code, Cursor, and any MCP-compatible AI tool
+- **MCP server** -- 34 tools integrating with Claude Code, Cursor, and any MCP-compatible AI tool
 - **Clean architecture** -- Rust core handles all indexing/search, Node.js MCP server delegates to it
 
 ---
@@ -70,7 +70,7 @@ flowchart LR
   subgraph node ["Node.js Layer"]
     direction TB
     G["CLI<br/>init · index · search · describe"]
-    E["MCP Server<br/>28 tools · LRU cache"]
+    E["MCP Server<br/>34 tools · LRU cache"]
     F["Persistent Serve Process"]
     G --> F
     E --> F
@@ -369,7 +369,7 @@ npx magector index --force
 
 ## MCP Server Tools
 
-The MCP server exposes 28 tools for AI-assisted Magento 2 and Adobe Commerce development. All search tools return **structured JSON** with file paths, class names, methods, role badges, and content snippets -- enabling AI clients to parse results programmatically and minimize file-read round-trips.
+The MCP server exposes 34 tools for AI-assisted Magento 2 and Adobe Commerce development. All search tools return **structured JSON** with file paths, class names, methods, role badges, and content snippets -- enabling AI clients to parse results programmatically and minimize file-read round-trips.
 
 ### Output Format
 
@@ -432,7 +432,10 @@ All search tools return structured JSON:
 | `magento_trace_flow` | Trace execution flow from an entry point (route, API, GraphQL, event, cron) -- maps controller → plugins → observers → templates in one call |
 | `magento_trace_dependency` | Trace DI graph for a class/interface -- preferences, plugins, virtualTypes, argument overrides (parses all di.xml, no index needed) |
 | `magento_find_event_flow` | Trace complete event chain: dispatchers → observers → handler PHP classes (parses events.xml + vector search) |
+| `magento_find_event_dispatchers` | Find all PHP locations where a specific event is dispatched -- exact grep matching with method context and surrounding code **(v2.3)** |
 | `magento_find_layout` | Find layout XML files by handle or content -- lists blocks, containers, and referenceBlock declarations |
+| `magento_trace_data_flow` | Trace how a data attribute flows: find all setters (magic setter, setData, addData) and getters (magic getter, getData) across PHP and XML **(v2.3)** |
+| `magento_trace_call_chain` | Trace internal method call chain: follows `$this->method()`, `$this->dep->method()`, and `dispatch()` calls to build an execution tree **(v2.2)** |
 
 Auto-detects entry type from pattern (`/V1/...` → API, `snake_case` → event, `camelCase` → GraphQL, `path/segments` → route), or override with `entryType`. Use `depth: "shallow"` (entry + config + plugins) or `depth: "deep"` (adds observers, layout, templates, DI preferences).
 
@@ -442,6 +445,9 @@ Auto-detects entry type from pattern (`/V1/...` → API, `snake_case` → event,
 |------|-------------|
 | `magento_impact_analysis` | Analyze impact of changing a class -- finds use statements, DI references, direct instantiations, and type hints across the codebase |
 | `magento_find_test` | Find PHPUnit tests for a given class/method -- searches Test/ directories for coverage, mocks, and assertions |
+| `magento_find_implementors` | Find all classes implementing a given PHP interface -- scans `implements` keywords and di.xml `<preference>` declarations **(v2.2)** |
+| `magento_find_callers` | Find all call sites of a method across PHP and XML files -- `->method()` and `::method()` calls **(v2.2)** |
+| `magento_find_di_wiring` | Complete DI picture for a class: preferences, plugins, constructor args, virtual types, and argument overrides from di.xml **(v2.2)** |
 
 ### Diagnostics
 
@@ -470,9 +476,22 @@ Auto-detects entry type from pattern (`/V1/...` → API, `snake_case` → event,
 
 - **Hybrid BM25+vector search** -- combines text frequency scoring with semantic vector similarity for better exact class name matches
 - **Query expansion** -- automatically expands queries with Magento domain synonyms (plugin → interceptor, checkout → cart/quote/totals, etc.)
-- **Module filtering** -- `moduleFilter` parameter on `magento_search` to limit results by vendor/module pattern (supports wildcards, e.g., `"Vendor_*"`)
+- **Module filtering** -- `moduleFilter` parameter on `magento_search` to limit results by vendor/module pattern. Accepts a single string or array of strings. Supports wildcards, e.g., `"Vendor_*"` or `["Acme_PaymentGateway", "Acme_FreeShipping"]`
 - **Non-blocking reindex** -- old index stays usable during background rebuild; new index is built to a temp path and swapped in atomically on completion
 
+### Deep Code Analysis (v2.2)
+
+- **`magento_find_implementors`** -- find all classes implementing a PHP interface (PHP `implements` + di.xml `<preference>`)
+- **`magento_find_callers`** -- find all call sites of a method across PHP and XML files
+- **`magento_find_di_wiring`** -- complete DI picture: preferences, plugins, constructor args, virtual types, argument overrides
+- **`magento_trace_call_chain`** -- trace internal method execution chain: `$this->method()`, `$this->dep->method()`, and `dispatch()` calls with event→observer resolution
+
+### Data Flow & Event Tracing (v2.3)
+
+- **`magento_trace_data_flow`** -- trace all setters and getters for a data attribute (magic methods, setData/getData, addData, constants, XML references). Answers "who writes/reads `custom_discounted_price_incl_tax` on `Quote\Address`?"
+- **`magento_find_event_dispatchers`** -- grep-based exact search for all PHP locations dispatching a specific event, with method context and surrounding code. Complements `magento_find_event_flow` with higher precision.
+- **`magento_find_plugin` area context** -- enriched output shows DI area (frontend/adminhtml/global/graphql) and explicit di.xml plugin registrations when `targetClass` is provided
+
 ### Tool Cross-References
 
 Each tool description includes "See also" hints to help AI clients chain tools effectively:
@@ -549,6 +568,12 @@ magento_trace_flow({ entryPoint: "checkout/cart/add", depth: "deep" })
 magento_trace_flow({ entryPoint: "/V1/products" })
 magento_trace_flow({ entryPoint: "placeOrder", entryType: "graphql" })
 magento_trace_flow({ entryPoint: "sales_order_place_after" })
+magento_trace_data_flow({ attributeKey: "custom_discounted_price_incl_tax", modelClass: "Quote\\Address" })
+magento_find_event_dispatchers({ eventName: "custom_discount_rule_validation_before" })
+magento_find_implementors({ interfaceName: "ProductRepositoryInterface" })
+magento_find_callers({ methodName: "collectTotals", className: "TotalsCollector" })
+magento_find_di_wiring({ className: "CartManagementInterface" })
+magento_trace_call_chain({ className: "Magento\\Quote\\Model\\QuoteManagement", methodName: "submit" })
 ```
 
 ---
@@ -629,7 +654,7 @@ cd rust-core && cargo run --release -- validate -m ./magento2 --skip-index
 magector/
 ├── src/                          # Node.js source
 │   ├── cli.js                    # CLI entry point (npx magector <command>)
-│   ├── mcp-server.js             # MCP server (20 tools, structured JSON output)
+│   ├── mcp-server.js             # MCP server (34 tools, structured JSON output)
 │   ├── binary.js                 # Platform binary resolver
 │   ├── model.js                  # ONNX model resolver/downloader
 │   ├── init.js                   # Full init command (index + IDE config)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "magector",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "description": "Semantic code search for Magento 2 — index, search, MCP server",
   "type": "module",
   "main": "src/mcp-server.js",
@@ -33,10 +33,10 @@
     "ruvector": "^0.1.96"
   },
   "optionalDependencies": {
-    "@magector/cli-darwin-arm64": "2.3.0",
-    "@magector/cli-linux-x64": "2.3.0",
-    "@magector/cli-linux-arm64": "2.3.0",
-    "@magector/cli-win32-x64": "2.3.0"
+    "@magector/cli-darwin-arm64": "2.3.1",
+    "@magector/cli-linux-x64": "2.3.1",
+    "@magector/cli-linux-arm64": "2.3.1",
+    "@magector/cli-win32-x64": "2.3.1"
   },
   "keywords": [
     "magento",

package/src/mcp-server.js

@@ -2848,7 +2848,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
               { type: 'string' },
               { type: 'array', items: { type: 'string' } }
             ],
-            description: 'Filter results by vendor/module pattern(s). Accepts a single string or array of strings. Supports wildcards and vendor prefix matching. Uses "/" or "_" interchangeably as separator. Examples: "Vendor_*", ["drmax_paymentrestrictions", "drmax_module-free-shipping"], "Magento_Catalog".'
+            description: 'Filter results by vendor/module pattern(s). Accepts a single string or array of strings. Supports wildcards and vendor prefix matching. Uses "/" or "_" interchangeably as separator. Examples: "Vendor_*", ["Acme_PaymentGateway", "Acme_FreeShipping"], "Magento_Catalog".'
           },
           expand: {
             type: 'boolean',
@@ -3330,7 +3330,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         properties: {
           methodName: {
             type: 'string',
-            description: 'Method name to find callers for. Examples: "execute", "save", "collectTotals", "copySalesRuleIdsFromParentToDrmaxQuote"'
+            description: 'Method name to find callers for. Examples: "execute", "save", "collectTotals", "copySalesRuleIdsFromParentToChildQuote"'
           },
           className: {
             type: 'string',
@@ -3362,7 +3362,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         properties: {
           className: {
             type: 'string',
-            description: 'Full PHP class name (FQCN) to start tracing from. Examples: "DrmaxMarketplace\\OrderSplit\\Model\\CreateOrder\\CreateChildOrder", "Magento\\Quote\\Model\\QuoteManagement"'
+            description: 'Full PHP class name (FQCN) to start tracing from. Examples: "Vendor\\OrderSplit\\Model\\CreateOrder\\CreateChildOrder", "Magento\\Quote\\Model\\QuoteManagement"'
           },
           methodName: {
             type: 'string',
@@ -3379,13 +3379,13 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
     },
     {
       name: 'magento_trace_data_flow',
-      description: 'Trace how a data attribute flows through the Magento codebase: find all PHP files that set (via magic setter, setData, addData) and get (via magic getter, getData) a specific attribute key. Shows which classes write vs read the attribute, in which methods, and whether XML configs reference it. Use this to understand data dependencies — e.g., who sets drmax_discounted_price_incl_tax on Quote\\Address and who reads it.',
+      description: 'Trace how a data attribute flows through the Magento codebase: find all PHP files that set (via magic setter, setData, addData) and get (via magic getter, getData) a specific attribute key. Shows which classes write vs read the attribute, in which methods, and whether XML configs reference it. Use this to understand data dependencies — e.g., who sets custom_discounted_price_incl_tax on Quote\\Address and who reads it.',
       inputSchema: {
         type: 'object',
         properties: {
           attributeKey: {
             type: 'string',
-            description: 'The snake_case data attribute key to trace. Examples: "drmax_discounted_price_incl_tax", "base_grand_total", "drmax_free_shipping_price", "subtotal_with_discount"'
+            description: 'The snake_case data attribute key to trace. Examples: "custom_discounted_price_incl_tax", "base_grand_total", "custom_free_shipping_price", "subtotal_with_discount"'
           },
           modelClass: {
             type: 'string',
@@ -3403,7 +3403,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         properties: {
           eventName: {
             type: 'string',
-            description: 'Magento event name to find dispatchers for. Examples: "sales_order_place_after", "drmax_discount_rule_validation_before", "checkout_cart_add_product_complete"'
+            description: 'Magento event name to find dispatchers for. Examples: "sales_order_place_after", "custom_discount_rule_validation_before", "checkout_cart_add_product_complete"'
           }
         },
         required: ['eventName']

package/src/validation/test-data-generator.js

@@ -1,672 +0,0 @@
-/**
- * Generates synthetic Magento code for validation testing
- */
-
-export const MOCK_MODULES = [
-  'Acme_Catalog',
-  'Acme_Checkout',
-  'Acme_Customer',
-  'Acme_Sales',
-  'Acme_Inventory'
-];
-
-export function generateMockController(moduleName, controllerName, action = 'execute') {
-  const [vendor, module] = moduleName.split('_');
-  return {
-    path: `app/code/${vendor}/${module}/Controller/${controllerName}.php`,
-    content: `<?php
-declare(strict_types=1);
-
-namespace ${vendor}\\${module}\\Controller;
-
-use Magento\\Framework\\App\\Action\\HttpGetActionInterface;
-use Magento\\Framework\\Controller\\ResultFactory;
-use Magento\\Framework\\View\\Result\\Page;
-
-/**
- * ${controllerName} controller action
- */
-class ${controllerName} implements HttpGetActionInterface
-{
-    private ResultFactory \$resultFactory;
-
-    public function __construct(
-        ResultFactory \$resultFactory
-    ) {
-        \$this->resultFactory = \$resultFactory;
-    }
-
-    /**
-     * Execute action
-     * @return Page
-     */
-    public function ${action}(): Page
-    {
-        /** @var Page \$page */
-        \$page = \$this->resultFactory->create(ResultFactory::TYPE_PAGE);
-        return \$page;
-    }
-}
-`,
-    metadata: {
-      type: 'php',
-      magentoType: 'Controller',
-      module: moduleName,
-      className: controllerName,
-      methodName: action,
-      isController: true
-    }
-  };
-}
-
-export function generateMockModel(moduleName, modelName, tableName) {
-  const [vendor, module] = moduleName.split('_');
-  return {
-    path: `app/code/${vendor}/${module}/Model/${modelName}.php`,
-    content: `<?php
-declare(strict_types=1);
-
-namespace ${vendor}\\${module}\\Model;
-
-use Magento\\Framework\\Model\\AbstractModel;
-use ${vendor}\\${module}\\Model\\ResourceModel\\${modelName} as ResourceModel;
-
-/**
- * ${modelName} model
- */
-class ${modelName} extends AbstractModel
-{
-    protected \$_eventPrefix = '${tableName}';
-
-    protected function _construct(): void
-    {
-        \$this->_init(ResourceModel::class);
-    }
-
-    protected function _beforeSave(): AbstractModel
-    {
-        // Custom before save logic
-        return parent::_beforeSave();
-    }
-
-    protected function _afterLoad(): AbstractModel
-    {
-        // Custom after load logic
-        return parent::_afterLoad();
-    }
-
-    public function getName(): ?string
-    {
-        return \$this->getData('name');
-    }
-
-    public function setName(string \$name): self
-    {
-        return \$this->setData('name', \$name);
-    }
-}
-`,
-    metadata: {
-      type: 'php',
-      magentoType: 'Model',
-      module: moduleName,
-      className: modelName,
-      isModel: true,
-      tableName
-    }
-  };
-}
-
-export function generateMockRepository(moduleName, entityName) {
-  const [vendor, module] = moduleName.split('_');
-  return {
-    path: `app/code/${vendor}/${module}/Model/${entityName}Repository.php`,
-    content: `<?php
-declare(strict_types=1);
-
-namespace ${vendor}\\${module}\\Model;
-
-use ${vendor}\\${module}\\Api\\${entityName}RepositoryInterface;
-use ${vendor}\\${module}\\Api\\Data\\${entityName}Interface;
-use ${vendor}\\${module}\\Model\\ResourceModel\\${entityName} as ResourceModel;
-use Magento\\Framework\\Api\\SearchCriteriaInterface;
-use Magento\\Framework\\Api\\SearchResultsInterface;
-use Magento\\Framework\\Exception\\CouldNotSaveException;
-use Magento\\Framework\\Exception\\NoSuchEntityException;
-
-/**
- * ${entityName} repository implementation
- */
-class ${entityName}Repository implements ${entityName}RepositoryInterface
-{
-    private ResourceModel \$resourceModel;
-    private ${entityName}Factory \$${entityName.toLowerCase()}Factory;
-
-    public function __construct(
-        ResourceModel \$resourceModel,
-        ${entityName}Factory \$${entityName.toLowerCase()}Factory
-    ) {
-        \$this->resourceModel = \$resourceModel;
-        \$this->${entityName.toLowerCase()}Factory = \$${entityName.toLowerCase()}Factory;
-    }
-
-    public function getById(int \$id): ${entityName}Interface
-    {
-        \$entity = \$this->${entityName.toLowerCase()}Factory->create();
-        \$this->resourceModel->load(\$entity, \$id);
-        if (!\$entity->getId()) {
-            throw new NoSuchEntityException(__('Entity with id "%1" does not exist.', \$id));
-        }
-        return \$entity;
-    }
-
-    public function save(${entityName}Interface \$entity): ${entityName}Interface
-    {
-        try {
-            \$this->resourceModel->save(\$entity);
-        } catch (\\Exception \$e) {
-            throw new CouldNotSaveException(__(\$e->getMessage()));
-        }
-        return \$entity;
-    }
-
-    public function delete(${entityName}Interface \$entity): bool
-    {
-        \$this->resourceModel->delete(\$entity);
-        return true;
-    }
-
-    public function deleteById(int \$id): bool
-    {
-        return \$this->delete(\$this->getById(\$id));
-    }
-
-    public function getList(SearchCriteriaInterface \$searchCriteria): SearchResultsInterface
-    {
-        // Implementation
-    }
-}
-`,
-    metadata: {
-      type: 'php',
-      magentoType: 'Repository',
-      module: moduleName,
-      className: `${entityName}Repository`,
-      isRepository: true,
-      repositoryMethods: ['getById', 'save', 'delete', 'deleteById', 'getList']
-    }
-  };
-}
-
-export function generateMockPlugin(moduleName, targetClass, targetMethod) {
-  const [vendor, module] = moduleName.split('_');
-  const pluginName = `${targetClass}${targetMethod.charAt(0).toUpperCase() + targetMethod.slice(1)}Plugin`;
-  return {
-    path: `app/code/${vendor}/${module}/Plugin/${pluginName}.php`,
-    content: `<?php
-declare(strict_types=1);
-
-namespace ${vendor}\\${module}\\Plugin;
-
-use ${targetClass.includes('\\') ? targetClass : `Magento\\Framework\\${targetClass}`};
-
-/**
- * Plugin for ${targetClass}::${targetMethod}
- */
-class ${pluginName}
-{
-    /**
-     * Before ${targetMethod}
-     */
-    public function before${targetMethod.charAt(0).toUpperCase() + targetMethod.slice(1)}(
-        ${targetClass.split('\\').pop()} \$subject,
-        ...\$args
-    ): array {
-        // Modify arguments before method execution
-        return \$args;
-    }
-
-    /**
-     * After ${targetMethod}
-     */
-    public function after${targetMethod.charAt(0).toUpperCase() + targetMethod.slice(1)}(
-        ${targetClass.split('\\').pop()} \$subject,
-        \$result
-    ) {
-        // Modify result after method execution
-        return \$result;
-    }
-
-    /**
-     * Around ${targetMethod}
-     */
-    public function around${targetMethod.charAt(0).toUpperCase() + targetMethod.slice(1)}(
-        ${targetClass.split('\\').pop()} \$subject,
-        callable \$proceed,
-        ...\$args
-    ) {
-        // Execute before
-        \$result = \$proceed(...\$args);
-        // Execute after
-        return \$result;
-    }
-}
-`,
-    metadata: {
-      type: 'php',
-      magentoType: 'Plugin',
-      module: moduleName,
-      className: pluginName,
-      isPlugin: true,
-      targetClass,
-      targetMethod,
-      pluginMethods: [
-        { type: 'before', name: `before${targetMethod.charAt(0).toUpperCase() + targetMethod.slice(1)}` },
-        { type: 'after', name: `after${targetMethod.charAt(0).toUpperCase() + targetMethod.slice(1)}` },
-        { type: 'around', name: `around${targetMethod.charAt(0).toUpperCase() + targetMethod.slice(1)}` }
-      ]
-    }
-  };
-}
-
-export function generateMockObserver(moduleName, eventName, observerName) {
-  const [vendor, module] = moduleName.split('_');
-  return {
-    path: `app/code/${vendor}/${module}/Observer/${observerName}.php`,
-    content: `<?php
-declare(strict_types=1);
-
-namespace ${vendor}\\${module}\\Observer;
-
-use Magento\\Framework\\Event\\Observer;
-use Magento\\Framework\\Event\\ObserverInterface;
-use Psr\\Log\\LoggerInterface;
-
-/**
- * Observer for ${eventName} event
- */
-class ${observerName} implements ObserverInterface
-{
-    private LoggerInterface \$logger;
-
-    public function __construct(LoggerInterface \$logger)
-    {
-        \$this->logger = \$logger;
-    }
-
-    /**
-     * Execute observer
-     * @param Observer \$observer
-     * @return void
-     */
-    public function execute(Observer \$observer): void
-    {
-        \$event = \$observer->getEvent();
-        \$this->logger->info('Event ${eventName} triggered');
-        // Observer logic here
-    }
-}
-`,
-    metadata: {
-      type: 'php',
-      magentoType: 'Observer',
-      module: moduleName,
-      className: observerName,
-      isObserver: true,
-      eventName
-    }
-  };
-}
-
-export function generateMockDiXml(moduleName, configs) {
-  const [vendor, module] = moduleName.split('_');
-  let content = `<?xml version="1.0"?>
-<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-        xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/config.xsd">
-`;
-
-  for (const config of configs) {
-    if (config.type === 'preference') {
-      content += `    <preference for="${config.for}" type="${config.implementation}" />\n`;
-    } else if (config.type === 'plugin') {
-      content += `    <type name="${config.target}">
-        <plugin name="${config.name}" type="${config.class}" sortOrder="${config.sortOrder || 10}" />
-    </type>\n`;
-    } else if (config.type === 'virtualType') {
-      content += `    <virtualType name="${config.name}" type="${config.extends}">
-        <arguments>
-            <argument name="${config.argName}" xsi:type="string">${config.argValue}</argument>
-        </arguments>
-    </virtualType>\n`;
-    }
-  }
-
-  content += `</config>`;
-
-  return {
-    path: `app/code/${vendor}/${module}/etc/di.xml`,
-    content,
-    metadata: {
-      type: 'xml',
-      magentoType: 'di.xml',
-      module: moduleName,
-      preferences: configs.filter(c => c.type === 'preference'),
-      plugins: configs.filter(c => c.type === 'plugin'),
-      virtualTypes: configs.filter(c => c.type === 'virtualType')
-    }
-  };
-}
-
-export function generateMockEventsXml(moduleName, events) {
-  const [vendor, module] = moduleName.split('_');
-  let content = `<?xml version="1.0"?>
-<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-        xsi:noNamespaceSchemaLocation="urn:magento:framework:Event/etc/events.xsd">
-`;
-
-  for (const event of events) {
-    content += `    <event name="${event.name}">
-        <observer name="${event.observerName}" instance="${vendor}\\${module}\\Observer\\${event.observerClass}" />
-    </event>\n`;
-  }
-
-  content += `</config>`;
-
-  return {
-    path: `app/code/${vendor}/${module}/etc/events.xml`,
-    content,
-    metadata: {
-      type: 'xml',
-      magentoType: 'events.xml',
-      module: moduleName,
-      events: events.map(e => e.name),
-      observers: events.map(e => ({ name: e.observerName, instance: `${vendor}\\${module}\\Observer\\${e.observerClass}` }))
-    }
-  };
-}
-
-export function generateMockWebApiXml(moduleName, routes) {
-  const [vendor, module] = moduleName.split('_');
-  let content = `<?xml version="1.0"?>
-<routes xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-        xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Webapi:etc/webapi.xsd">
-`;
-
-  for (const route of routes) {
-    content += `    <route url="${route.url}" method="${route.method}">
-        <service class="${vendor}\\${module}\\Api\\${route.serviceClass}" method="${route.serviceMethod}" />
-        <resources>
-            <resource ref="${route.resource || 'anonymous'}" />
-        </resources>
-    </route>\n`;
-  }
-
-  content += `</routes>`;
-
-  return {
-    path: `app/code/${vendor}/${module}/etc/webapi.xml`,
-    content,
-    metadata: {
-      type: 'xml',
-      magentoType: 'webapi.xml',
-      module: moduleName,
-      apiRoutes: routes.map(r => ({ url: r.url, method: r.method })),
-      apiServices: routes.map(r => ({ class: `${vendor}\\${module}\\Api\\${r.serviceClass}`, method: r.serviceMethod }))
-    }
-  };
-}
-
-export function generateMockGraphqlSchema(moduleName, types, queries, mutations) {
-  const [vendor, module] = moduleName.split('_');
-  let content = '';
-
-  for (const type of types) {
-    content += `type ${type.name} ${type.implements ? `implements ${type.implements}` : ''} {
-${type.fields.map(f => `    ${f.name}: ${f.type}`).join('\n')}
-}\n\n`;
-  }
-
-  if (queries.length > 0) {
-    content += `type Query {\n`;
-    for (const q of queries) {
-      content += `    ${q.name}(${q.args || ''}): ${q.returnType} @resolver(class: "${vendor}\\\\${module}\\\\Model\\\\Resolver\\\\${q.resolver}")\n`;
-    }
-    content += `}\n\n`;
-  }
-
-  if (mutations.length > 0) {
-    content += `type Mutation {\n`;
-    for (const m of mutations) {
-      content += `    ${m.name}(${m.args || ''}): ${m.returnType} @resolver(class: "${vendor}\\\\${module}\\\\Model\\\\Resolver\\\\${m.resolver}")\n`;
-    }
-    content += `}\n`;
-  }
-
-  return {
-    path: `app/code/${vendor}/${module}/etc/schema.graphqls`,
-    content,
-    metadata: {
-      type: 'graphql',
-      magentoType: 'graphql_schema',
-      module: moduleName,
-      types: types.map(t => t.name),
-      queries: queries.map(q => q.name),
-      mutations: mutations.map(m => m.name),
-      resolvers: [...queries, ...mutations].map(x => x.resolver)
-    }
-  };
-}
-
-export function generateMockResolver(moduleName, resolverName, queryName) {
-  const [vendor, module] = moduleName.split('_');
-  return {
-    path: `app/code/${vendor}/${module}/Model/Resolver/${resolverName}.php`,
-    content: `<?php
-declare(strict_types=1);
-
-namespace ${vendor}\\${module}\\Model\\Resolver;
-
-use Magento\\Framework\\GraphQl\\Config\\Element\\Field;
-use Magento\\Framework\\GraphQl\\Query\\ResolverInterface;
-use Magento\\Framework\\GraphQl\\Schema\\Type\\ResolveInfo;
-
-/**
- * GraphQL resolver for ${queryName}
- */
-class ${resolverName} implements ResolverInterface
-{
-    /**
-     * @inheritdoc
-     */
-    public function resolve(
-        Field \$field,
-        \$context,
-        ResolveInfo \$info,
-        array \$value = null,
-        array \$args = null
-    ) {
-        // Resolver implementation
-        return [];
-    }
-}
-`,
-    metadata: {
-      type: 'php',
-      magentoType: 'GraphQlResolver',
-      module: moduleName,
-      className: resolverName,
-      isResolver: true,
-      queryName
-    }
-  };
-}
-
-export function generateMockBlock(moduleName, blockName) {
-  const [vendor, module] = moduleName.split('_');
-  return {
-    path: `app/code/${vendor}/${module}/Block/${blockName}.php`,
-    content: `<?php
-declare(strict_types=1);
-
-namespace ${vendor}\\${module}\\Block;
-
-use Magento\\Framework\\View\\Element\\Template;
-use Magento\\Framework\\View\\Element\\Template\\Context;
-
-/**
- * ${blockName} block
- */
-class ${blockName} extends Template
-{
-    protected \$_template = '${vendor}_${module}::${blockName.toLowerCase()}.phtml';
-
-    public function __construct(Context \$context, array \$data = [])
-    {
-        parent::__construct(\$context, \$data);
-    }
-
-    protected function _prepareLayout(): self
-    {
-        parent::_prepareLayout();
-        return \$this;
-    }
-
-    protected function _toHtml(): string
-    {
-        return parent::_toHtml();
-    }
-
-    public function getItems(): array
-    {
-        return [];
-    }
-}
-`,
-    metadata: {
-      type: 'php',
-      magentoType: 'Block',
-      module: moduleName,
-      className: blockName,
-      isBlock: true
-    }
-  };
-}
-
-export function generateMockCronJob(moduleName, cronName, schedule = '0 * * * *') {
-  const [vendor, module] = moduleName.split('_');
-  return {
-    php: {
-      path: `app/code/${vendor}/${module}/Cron/${cronName}.php`,
-      content: `<?php
-declare(strict_types=1);
-
-namespace ${vendor}\\${module}\\Cron;
-
-use Psr\\Log\\LoggerInterface;
-
-/**
- * ${cronName} cron job
- */
-class ${cronName}
-{
-    private LoggerInterface \$logger;
-
-    public function __construct(LoggerInterface \$logger)
-    {
-        \$this->logger = \$logger;
-    }
-
-    public function execute(): void
-    {
-        \$this->logger->info('Cron job ${cronName} executed');
-        // Cron logic here
-    }
-}
-`,
-      metadata: {
-        type: 'php',
-        magentoType: 'Cron',
-        module: moduleName,
-        className: cronName,
-        isCron: true
-      }
-    },
-    xml: {
-      path: `app/code/${vendor}/${module}/etc/crontab.xml`,
-      content: `<?xml version="1.0"?>
-<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-        xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Cron:etc/crontab.xsd">
-    <group id="default">
-        <job name="${vendor.toLowerCase()}_${module.toLowerCase()}_${cronName.toLowerCase()}"
-             instance="${vendor}\\${module}\\Cron\\${cronName}"
-             method="execute">
-            <schedule>${schedule}</schedule>
-        </job>
-    </group>
-</config>`,
-      metadata: {
-        type: 'xml',
-        magentoType: 'crontab.xml',
-        module: moduleName,
-        cronJobs: [{ name: `${vendor.toLowerCase()}_${module.toLowerCase()}_${cronName.toLowerCase()}`, instance: `${vendor}\\${module}\\Cron\\${cronName}` }]
-      }
-    }
-  };
-}
-
-/**
- * Generate a complete mock module with all components
- */
-export function generateCompleteMockModule(moduleName) {
-  const [vendor, module] = moduleName.split('_');
-  const files = [];
-
-  // Controllers
-  files.push(generateMockController(moduleName, 'Index', 'execute'));
-  files.push(generateMockController(moduleName, 'View', 'execute'));
-
-  // Models
-  files.push(generateMockModel(moduleName, 'Item', `${vendor.toLowerCase()}_${module.toLowerCase()}_item`));
-  files.push(generateMockRepository(moduleName, 'Item'));
-
-  // Plugin
-  files.push(generateMockPlugin(moduleName, 'Magento\\Catalog\\Model\\Product', 'getPrice'));
-
-  // Observer
-  files.push(generateMockObserver(moduleName, 'catalog_product_save_after', 'ProductSaveObserver'));
-
-  // Block
-  files.push(generateMockBlock(moduleName, 'ItemList'));
-
-  // DI config
-  files.push(generateMockDiXml(moduleName, [
-    { type: 'preference', for: `${vendor}\\${module}\\Api\\ItemRepositoryInterface`, implementation: `${vendor}\\${module}\\Model\\ItemRepository` },
-    { type: 'plugin', target: 'Magento\\Catalog\\Model\\Product', name: `${vendor.toLowerCase()}_${module.toLowerCase()}_product_price`, class: `${vendor}\\${module}\\Plugin\\ProductGetPricePlugin` }
-  ]));
-
-  // Events
-  files.push(generateMockEventsXml(moduleName, [
-    { name: 'catalog_product_save_after', observerName: `${vendor.toLowerCase()}_product_save`, observerClass: 'ProductSaveObserver' }
-  ]));
-
-  // Web API
-  files.push(generateMockWebApiXml(moduleName, [
-    { url: `/V1/${module.toLowerCase()}/items/:id`, method: 'GET', serviceClass: 'ItemRepositoryInterface', serviceMethod: 'getById' },
-    { url: `/V1/${module.toLowerCase()}/items`, method: 'POST', serviceClass: 'ItemRepositoryInterface', serviceMethod: 'save' }
-  ]));
-
-  // GraphQL
-  files.push(generateMockGraphqlSchema(moduleName,
-    [{ name: `${module}Item`, fields: [{ name: 'id', type: 'Int!' }, { name: 'name', type: 'String' }] }],
-    [{ name: `${module.toLowerCase()}Item`, args: 'id: Int!', returnType: `${module}Item`, resolver: 'ItemResolver' }],
-    [{ name: `create${module}Item`, args: 'input: CreateItemInput!', returnType: `${module}Item`, resolver: 'CreateItemResolver' }]
-  ));
-  files.push(generateMockResolver(moduleName, 'ItemResolver', `${module.toLowerCase()}Item`));
-
-  // Cron
-  const cronJob = generateMockCronJob(moduleName, 'CleanupJob');
-  files.push(cronJob.php);
-  files.push(cronJob.xml);
-
-  return files;
-}

package/src/validation/test-queries.js

@@ -1,326 +0,0 @@
-/**
- * Test queries with expected results for accuracy validation
- */
-
-export const TEST_QUERIES = [
-  // Controller queries
-  {
-    id: 'ctrl-1',
-    query: 'controller execute action',
-    type: 'semantic',
-    expectedTypes: ['Controller'],
-    expectedPatterns: ['controller'],
-    minResults: 1,
-    category: 'controller'
-  },
-  {
-    id: 'ctrl-2',
-    query: 'Index controller',
-    type: 'exact',
-    expectedClasses: ['Index'],
-    expectedTypes: ['Controller'],
-    category: 'controller'
-  },
-
-  // Model queries
-  {
-    id: 'model-1',
-    query: 'model beforeSave afterLoad',
-    type: 'semantic',
-    expectedTypes: ['Model'],
-    expectedPatterns: ['model'],
-    category: 'model'
-  },
-  {
-    id: 'model-2',
-    query: 'AbstractModel extends',
-    type: 'semantic',
-    expectedInContent: ['extends AbstractModel'],
-    category: 'model'
-  },
-
-  // Repository queries
-  {
-    id: 'repo-1',
-    query: 'repository getById save delete',
-    type: 'semantic',
-    expectedTypes: ['Repository'],
-    expectedPatterns: ['repository'],
-    category: 'repository'
-  },
-  {
-    id: 'repo-2',
-    query: 'ItemRepository',
-    type: 'exact',
-    expectedClasses: ['ItemRepository'],
-    category: 'repository'
-  },
-  {
-    id: 'repo-3',
-    query: 'getList SearchCriteria',
-    type: 'semantic',
-    expectedInContent: ['getList', 'SearchCriteria'],
-    category: 'repository'
-  },
-
-  // Plugin queries
-  {
-    id: 'plugin-1',
-    query: 'plugin interceptor before after around',
-    type: 'semantic',
-    expectedTypes: ['Plugin'],
-    expectedPatterns: ['plugin'],
-    category: 'plugin'
-  },
-  {
-    id: 'plugin-2',
-    query: 'beforeGetPrice plugin',
-    type: 'semantic',
-    expectedInContent: ['beforeGetPrice', 'before'],
-    category: 'plugin'
-  },
-  {
-    id: 'plugin-3',
-    query: 'around method interceptor',
-    type: 'semantic',
-    expectedInContent: ['around', 'proceed'],
-    category: 'plugin'
-  },
-
-  // Observer queries
-  {
-    id: 'obs-1',
-    query: 'observer execute event',
-    type: 'semantic',
-    expectedTypes: ['Observer'],
-    expectedPatterns: ['observer'],
-    category: 'observer'
-  },
-  {
-    id: 'obs-2',
-    query: 'catalog_product_save_after observer',
-    type: 'semantic',
-    expectedInContent: ['catalog_product_save_after'],
-    category: 'observer'
-  },
-  {
-    id: 'obs-3',
-    query: 'ObserverInterface implement',
-    type: 'semantic',
-    expectedInContent: ['ObserverInterface'],
-    category: 'observer'
-  },
-
-  // Block queries
-  {
-    id: 'block-1',
-    query: 'block template phtml',
-    type: 'semantic',
-    expectedTypes: ['Block'],
-    expectedPatterns: ['block'],
-    category: 'block'
-  },
-  {
-    id: 'block-2',
-    query: '_toHtml _prepareLayout',
-    type: 'semantic',
-    expectedInContent: ['_toHtml', '_prepareLayout'],
-    category: 'block'
-  },
-
-  // DI.xml queries
-  {
-    id: 'di-1',
-    query: 'preference interface implementation',
-    type: 'semantic',
-    expectedFileTypes: ['xml'],
-    expectedInContent: ['preference'],
-    category: 'di'
-  },
-  {
-    id: 'di-2',
-    query: 'plugin configuration di.xml',
-    type: 'semantic',
-    expectedFileTypes: ['xml'],
-    expectedInContent: ['plugin'],
-    category: 'di'
-  },
-  {
-    id: 'di-3',
-    query: 'virtualType argument',
-    type: 'semantic',
-    expectedInContent: ['virtualType'],
-    category: 'di'
-  },
-
-  // Events.xml queries
-  {
-    id: 'event-1',
-    query: 'event observer configuration',
-    type: 'semantic',
-    expectedFileTypes: ['xml'],
-    expectedInContent: ['event', 'observer'],
-    category: 'events'
-  },
-  {
-    id: 'event-2',
-    query: 'catalog_product_save_after event config',
-    type: 'exact',
-    expectedInContent: ['catalog_product_save_after'],
-    category: 'events'
-  },
-
-  // Web API queries
-  {
-    id: 'api-1',
-    query: 'REST API endpoint route',
-    type: 'semantic',
-    expectedFileTypes: ['xml'],
-    expectedInContent: ['route', 'service'],
-    category: 'webapi'
-  },
-  {
-    id: 'api-2',
-    query: 'GET /V1/items',
-    type: 'semantic',
-    expectedInContent: ['GET', '/V1/'],
-    category: 'webapi'
-  },
-
-  // GraphQL queries
-  {
-    id: 'gql-1',
-    query: 'GraphQL resolver',
-    type: 'semantic',
-    expectedTypes: ['GraphQlResolver'],
-    expectedPatterns: ['graphql_resolver'],
-    category: 'graphql'
-  },
-  {
-    id: 'gql-2',
-    query: 'type Query mutation',
-    type: 'semantic',
-    expectedFileTypes: ['graphql'],
-    expectedInContent: ['type', 'Query'],
-    category: 'graphql'
-  },
-  {
-    id: 'gql-3',
-    query: 'ResolverInterface resolve Field',
-    type: 'semantic',
-    expectedInContent: ['ResolverInterface', 'resolve'],
-    category: 'graphql'
-  },
-
-  // Cron queries
-  {
-    id: 'cron-1',
-    query: 'cron job schedule execute',
-    type: 'semantic',
-    expectedTypes: ['Cron'],
-    category: 'cron'
-  },
-  {
-    id: 'cron-2',
-    query: 'crontab.xml job instance',
-    type: 'semantic',
-    expectedFileTypes: ['xml'],
-    expectedInContent: ['job', 'instance'],
-    category: 'cron'
-  },
-
-  // Cross-cutting queries
-  {
-    id: 'cross-1',
-    query: 'dependency injection constructor',
-    type: 'semantic',
-    expectedInContent: ['__construct'],
-    minResults: 3,
-    category: 'di_pattern'
-  },
-  {
-    id: 'cross-2',
-    query: 'LoggerInterface logging',
-    type: 'semantic',
-    expectedInContent: ['LoggerInterface', 'logger'],
-    category: 'logging'
-  },
-  {
-    id: 'cross-3',
-    query: 'exception handling try catch',
-    type: 'semantic',
-    expectedInContent: ['Exception', 'throw'],
-    category: 'error_handling'
-  },
-
-  // Module-specific queries
-  {
-    id: 'mod-1',
-    query: 'Acme_Catalog module',
-    type: 'module',
-    expectedModule: 'Acme_Catalog',
-    minResults: 3,
-    category: 'module'
-  },
-
-  // Method-specific queries
-  {
-    id: 'method-1',
-    query: 'function getById',
-    type: 'method',
-    expectedMethods: ['getById'],
-    category: 'method'
-  },
-  {
-    id: 'method-2',
-    query: 'save method repository',
-    type: 'method',
-    expectedMethods: ['save'],
-    category: 'method'
-  }
-];
-
-export const QUERY_CATEGORIES = {
-  controller: { weight: 1.0, description: 'Controller action detection' },
-  model: { weight: 1.0, description: 'Model and lifecycle hooks' },
-  repository: { weight: 1.2, description: 'Repository pattern detection' },
-  plugin: { weight: 1.3, description: 'Plugin/interceptor detection' },
-  observer: { weight: 1.2, description: 'Observer pattern detection' },
-  block: { weight: 1.0, description: 'Block class detection' },
-  di: { weight: 1.2, description: 'DI configuration detection' },
-  events: { weight: 1.1, description: 'Event configuration detection' },
-  webapi: { weight: 1.2, description: 'Web API route detection' },
-  graphql: { weight: 1.3, description: 'GraphQL schema/resolver detection' },
-  cron: { weight: 1.0, description: 'Cron job detection' },
-  di_pattern: { weight: 0.8, description: 'DI pattern recognition' },
-  logging: { weight: 0.7, description: 'Logging pattern recognition' },
-  error_handling: { weight: 0.7, description: 'Error handling patterns' },
-  module: { weight: 1.0, description: 'Module filtering' },
-  method: { weight: 1.0, description: 'Method search' }
-};
-
-/**
- * Generate edge case queries for stress testing
- */
-export function generateEdgeCaseQueries() {
-  return [
-    // Very short queries
-    { id: 'edge-1', query: 'save', type: 'short', category: 'edge_short', minResults: 1, expectedMethods: ['save'] },
-    { id: 'edge-2', query: 'get', type: 'short', category: 'edge_short', minResults: 1 },
-
-    // Very long queries
-    { id: 'edge-3', query: 'public function execute action controller', type: 'long', category: 'edge_long', minResults: 1, expectedPatterns: ['controller'] },
-
-    // Technical jargon
-    { id: 'edge-4', query: 'CRUD operations repository interface', type: 'jargon', category: 'edge_jargon', minResults: 1, expectedTypes: ['Repository'] },
-
-    // Magento-specific terms - lower expectations
-    { id: 'edge-5', query: 'service contract API', type: 'magento_specific', category: 'edge_magento', minResults: 1 },
-
-    // Negative queries (should return few/no results)
-    { id: 'edge-6', query: 'wordpress drupal laravel', type: 'negative', category: 'edge_negative', maxResults: 2 },
-
-    // Mixed case
-    { id: 'edge-7', query: 'REPOSITORY getbyid SAVE', type: 'case', category: 'edge_case', minResults: 1, expectedTypes: ['Repository'] }
-  ];
-}