magector 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Magector Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,627 @@
+# Magector
+
+**Semantic code search engine for Magento 2, powered by ONNX embeddings and HNSW vector search.**
+
+Magector indexes an entire Magento 2 codebase and lets you search it with natural language. Instead of grepping for keywords, ask questions like *"how are checkout totals calculated?"* or *"where is the product price determined?"* and get ranked, relevant results in under 50ms.
+
+[![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)
+[![Magento](https://img.shields.io/badge/magento-2.4.x-blue.svg)](https://magento.com)
+[![Accuracy](https://img.shields.io/badge/accuracy-94.4%25-brightgreen.svg)](#validation)
+[![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](LICENSE)
+
+---
+
+## Why Magector
+
+Magento 2 has **18,000+ source files** across hundreds of modules. Finding the right code is slow:
+
+| Approach | Finds semantic matches | Understands Magento patterns | Speed (18K files) |
+|----------|:---------------------:|:---------------------------:|:-----------------:|
+| `grep` / `ripgrep` | No | No | 100-500ms |
+| IDE search | No | No | 200-1000ms |
+| GitHub search | Partial | No | 500-2000ms |
+| **Magector** | **Yes** | **Yes** | **15-45ms** |
+
+Magector understands that a query about *"payment capture"* should return `Sales/Model/Order/Payment/Operations/CaptureOperation.php`, not just files containing the word "capture".
+
+---
+
+## Features
+
+- **Semantic search** -- find code by meaning, not exact keywords
+- **94.4% accuracy** -- validated with 557 test cases across 50+ categories
+- **ONNX embeddings** -- native 384-dim transformer embeddings via ONNX Runtime for higher quality search
+- **Parallel processing** -- batch embedding with parallel intelligence for faster indexing
+- **Magento-aware** -- understands controllers, plugins, observers, blocks, resolvers, repositories, and 20+ Magento patterns
+- **AST-powered** -- tree-sitter parsing for PHP and JavaScript extracts classes, methods, namespaces, and inheritance
+- **Diff analysis** -- risk scoring and change classification for git commits and staged changes
+- **Complexity analysis** -- cyclomatic complexity, function count, and hotspot detection across modules
+- **Fast** -- 15-45ms queries, batched ONNX embedding with adaptive thread scaling
+- **MCP server** -- 19 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
+
+---
+
+## Architecture
+
+```
+                    ┌──────────────────────────────────────────┐
+                    │              Magector                     │
+                    ├──────────────────┬───────────────────────┤
+                    │   Rust Core      │   Node.js Layer       │
+                    │                  │                       │
+                    │  ┌────────────┐  │  ┌─────────────────┐  │
+                    │  │ Tree-sitter│  │  │  MCP Server     │  │
+                    │  │ AST Parser │  │  │  (19 tools)     │  │
+                    │  │ PHP + JS   │  │  └────────┬────────┘  │
+                    │  └─────┬──────┘  │           │           │
+                    │        │         │  ┌────────┴────────┐  │
+                    │  ┌─────┴──────┐  │  │  CLI Interface  │  │
+                    │  │ Magento    │  │  │  index/search/  │  │
+                    │  │ Pattern    │  │  │  validate       │  │
+                    │  │ Detection  │  │  └─────────────────┘  │
+                    │  └─────┬──────┘  │                       │
+                    │        │         │                       │
+                    │  ┌─────┴──────┐  │                       │
+                    │  │ ONNX       │  │                       │
+                    │  │ Embedder   │  │                       │
+                    │  │ MiniLM-L6  │  │                       │
+                    │  └─────┬──────┘  │                       │
+                    │        │         │                       │
+                    │  ┌─────┴──────┐  │                       │
+                    │  │ HNSW       │  │                       │
+                    │  │ Vector DB  │  │                       │
+                    │  └────────────┘  │                       │
+                    └──────────────────┴───────────────────────┘
+```
+
+### Embedding Pipeline
+
+```
+Source File ──▶ Tree-sitter AST ──▶ Magento Pattern Detection ──▶ Search Text Enrichment
+     │                                                                     │
+     │                                                                     ▼
+     │                                                            ONNX Runtime
+     │                                                            (MiniLM-L6-v2)
+     │                                                                     │
+     │                                                                     ▼
+     │                                                             384-dim embedding
+     │                                                                     │
+     ▼                                                                     ▼
+  Metadata ─────────────────────────────────────────────────────▶ HNSW Index
+  (path, class, namespace, type, methods, patterns)               (17,891 vectors)
+```
+
+### Components
+
+| Component | Technology | Purpose |
+|-----------|-----------|---------|
+| Embeddings | `ort` (ONNX Runtime) | all-MiniLM-L6-v2, 384 dimensions |
+| Vector search | `hnsw_rs` | Approximate nearest neighbor |
+| PHP parsing | `tree-sitter-php` | Class, method, namespace extraction |
+| JS parsing | `tree-sitter-javascript` | AMD/ES6 module detection |
+| Pattern detection | Custom Rust | 20+ Magento-specific patterns |
+| CLI | `clap` | Command-line interface |
+| MCP server | `@modelcontextprotocol/sdk` | AI tool integration |
+
+---
+
+## Quick Start
+
+### Prerequisites
+
+- [Node.js 18+](https://nodejs.org)
+
+### 1. Initialize in Your Magento Project
+
+```bash
+cd /path/to/your/magento2
+npx magector init
+```
+
+This single command:
+- Verifies the Magento project
+- Downloads the ONNX model (~86MB, cached globally in `~/.magector/models/`)
+- Indexes the entire codebase
+- Detects your IDE (Cursor / Claude Code)
+- Writes MCP server configuration
+- Writes IDE rules (`.cursorrules` / `CLAUDE.md`)
+- Adds `magector.db` to `.gitignore`
+
+### 2. Search
+
+```bash
+npx magector search "product price calculation"
+npx magector search "checkout totals collector" -l 20
+```
+
+### 3. Re-index After Changes
+
+```bash
+npx magector index
+```
+
+### 4. IDE Setup Only (Skip Indexing)
+
+```bash
+npx magector setup
+```
+
+---
+
+## CLI Reference
+
+### Rust Core CLI
+
+```
+magector-core <COMMAND>
+
+Commands:
+  index       Index a Magento codebase
+  search      Search the index semantically
+  validate    Run validation suite (downloads Magento if needed)
+  download    Download Magento 2 Open Source
+  stats       Show index statistics
+  embed       Generate embedding for text
+```
+
+#### `index`
+
+```bash
+magector-core index [OPTIONS]
+
+Options:
+  -m, --magento-root <PATH>   Path to Magento root directory
+  -d, --database <PATH>       Index database path [default: ./magector.db]
+  -c, --model-cache <PATH>    Model cache directory [default: ./models]
+  -v, --verbose               Enable verbose output
+```
+
+#### `search`
+
+```bash
+magector-core search <QUERY> [OPTIONS]
+
+Options:
+  -d, --database <PATH>   Index database path [default: ./magector.db]
+  -l, --limit <N>         Number of results [default: 10]
+  -f, --format <FORMAT>   Output format: text, json [default: text]
+```
+
+### Node.js CLI
+
+```bash
+npx magector init [path]        # Full setup: index + IDE config
+npx magector index [path]       # Index (or re-index) Magento codebase
+npx magector search <query>     # Search indexed code
+npx magector stats              # Show indexer statistics
+npx magector setup [path]       # IDE setup only (no indexing)
+npx magector mcp                # Start MCP server
+npx magector help               # Show help
+```
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `MAGENTO_ROOT` | Path to Magento installation | Current directory |
+| `MAGECTOR_DB` | Path to index database | `./magector.db` |
+| `MAGECTOR_BIN` | Path to magector-core binary | Auto-detected |
+| `MAGECTOR_MODELS` | Path to ONNX model directory | `~/.magector/models/` |
+
+---
+
+## MCP Server Tools
+
+The MCP server exposes 19 tools for AI-assisted Magento development:
+
+### Search Tools
+
+| Tool | Description |
+|------|-------------|
+| `magento_search` | Semantic code search with natural language queries |
+| `magento_find_class` | Find PHP class, interface, or trait by name |
+| `magento_find_method` | Find method implementations across the codebase |
+
+### Magento-Specific Finders
+
+| Tool | Description |
+|------|-------------|
+| `magento_find_config` | Find XML configuration files (di.xml, events.xml, etc.) |
+| `magento_find_template` | Find PHTML template files |
+| `magento_find_plugin` | Find interceptor plugins and their targets |
+| `magento_find_observer` | Find event observers |
+| `magento_find_controller` | Find controllers by route or action |
+| `magento_find_block` | Find Block classes |
+| `magento_find_graphql` | Find GraphQL resolvers and schema |
+| `magento_find_api` | Find REST API endpoints and webapi.xml routes |
+| `magento_find_cron` | Find cron job definitions |
+| `magento_find_db_schema` | Find database table definitions |
+
+### Analysis Tools
+
+| Tool | Description |
+|------|-------------|
+| `magento_analyze_diff` | Analyze git diffs for risk scoring and change classification |
+| `magento_complexity` | Analyze code complexity (cyclomatic, function count, lines) |
+
+### Utility Tools
+
+| Tool | Description |
+|------|-------------|
+| `magento_module_structure` | Show module directory structure |
+| `magento_index` | Trigger re-indexing of the codebase |
+| `magento_stats` | View index statistics (ONNX, parallel mode) |
+
+### Query Examples
+
+```
+magento_search("how are checkout totals calculated")
+magento_search("product price with tier pricing and catalog rules")
+magento_find_class("ProductRepositoryInterface")
+magento_find_config("di.xml plugin for ProductRepository")
+magento_find_plugin("save method")
+magento_find_observer("sales_order_place_after")
+magento_find_api("products REST endpoint")
+magento_find_graphql("cart mutation resolver")
+magento_analyze_diff({ commitHash: "abc123" })
+magento_complexity({ module: "Magento_Catalog", threshold: 10 })
+```
+
+---
+
+## Validation
+
+Magector is validated against the complete Magento 2.4.7 codebase with **557 test cases** across **50+ categories**.
+
+### Overall Results
+
+| Metric | Value |
+|--------|-------|
+| **Accuracy** | **94.4%** |
+| Tests passed | 526 / 557 |
+| Index size | 17,891 vectors |
+| Query time | 15-45ms |
+| Indexing time | ~3 minutes |
+
+### Category Performance
+
+**100% accuracy (34 categories):**
+Controllers, Blocks, Observers, GraphQL, API, Shipping, Tax, Payment, EAV, Indexers, Cron, Email, Import, Export, Cache, Queue, Admin, CMS, Promotions, Debugging, Architecture, Order Management, Plugin Advanced, GraphQL Advanced, API Advanced, Admin Advanced, Email Advanced, Cron Advanced, Queue Advanced, Import Advanced, Payment Advanced, URL Rewrite, SEO, Marketing
+
+**90-99% accuracy:**
+Catalog Product (96%), Customer Advanced (95%), Checkout Flow (95%), Shipping Advanced (93.3%), Category (93.3%), Frontend JS (90%), Search (90%)
+
+**Known limitations:**
+- XML configuration file search (di.xml, plugin configs) -- semantic search favors PHP files with richer content
+- Very generic single-word queries -- include more context for better results
+
+### Running Validation
+
+```bash
+# Full validation (downloads Magento, indexes, validates)
+cd rust-core
+cargo run --release -- validate
+
+# Skip indexing (use existing index)
+cargo run --release -- validate -m ./magento2 --skip-index
+
+# Node.js validation suite
+npm run validate
+npm run validate:verbose
+```
+
+---
+
+## Project Structure
+
+```
+magector/
+├── src/                          # Node.js source
+│   ├── cli.js                    # CLI entry point (npx magector <command>)
+│   ├── mcp-server.js             # MCP server (19 tools, delegates to Rust core)
+│   ├── binary.js                 # Platform binary resolver
+│   ├── model.js                  # ONNX model resolver/downloader
+│   ├── init.js                   # Full init command (index + IDE config)
+│   ├── magento-patterns.js       # Magento pattern detection (JS)
+│   ├── templates/                # IDE rules templates
+│   │   ├── cursorrules.js        # .cursorrules content
+│   │   └── claude-md.js          # CLAUDE.md content
+│   └── validation/               # JS validation suite
+│       ├── validator.js
+│       ├── benchmark.js
+│       ├── test-queries.js
+│       ├── test-data-generator.js
+│       └── accuracy-calculator.js
+├── tests/                        # Automated tests
+│   └── mcp-server.test.js        # MCP server tests (Rust core + analysis tools)
+├── platforms/                    # Platform-specific binary packages
+│   ├── darwin-arm64/             # macOS ARM (Apple Silicon)
+│   ├── darwin-x64/               # macOS Intel
+│   ├── linux-x64/                # Linux x64
+│   ├── linux-arm64/              # Linux ARM64
+│   └── win32-x64/                # Windows x64
+├── rust-core/                    # Rust high-performance core
+│   ├── Cargo.toml
+│   ├── src/
+│   │   ├── main.rs               # Rust CLI (index, search, validate)
+│   │   ├── lib.rs                # Library exports
+│   │   ├── indexer.rs             # Core indexing with progress output
+│   │   ├── embedder.rs            # ONNX embedding (MiniLM-L6-v2)
+│   │   ├── vectordb.rs            # HNSW vector database
+│   │   ├── ast.rs                 # Tree-sitter AST (PHP + JS)
+│   │   ├── magento.rs             # Magento pattern detection (Rust)
+│   │   └── validation.rs          # 557 test cases, validation framework
+│   └── models/                   # ONNX model files (auto-downloaded)
+│       ├── all-MiniLM-L6-v2.onnx
+│       └── tokenizer.json
+├── .github/
+│   └── workflows/
+│       └── release.yml           # Cross-compile + publish CI
+├── scripts/
+│   └── setup.sh                  # Claude Code MCP setup script
+├── config/
+│   └── mcp-config.json           # MCP server configuration template
+├── package.json
+├── .gitignore
+├── LICENSE
+└── README.md
+```
+
+---
+
+## How It Works
+
+### 1. Indexing
+
+Magector scans every `.php`, `.js`, `.xml`, `.phtml`, and `.graphqls` file in a Magento codebase:
+
+1. **AST parsing** -- Tree-sitter extracts class names, namespaces, methods, inheritance, and interface implementations from PHP and JavaScript files
+2. **Pattern detection** -- Identifies Magento-specific patterns: controllers, models, repositories, plugins, observers, blocks, GraphQL resolvers, admin grids, cron jobs, and more
+3. **Search text enrichment** -- Combines AST metadata with Magento pattern keywords to create semantically rich text representations
+4. **Embedding** -- ONNX Runtime generates 384-dimensional vectors using all-MiniLM-L6-v2
+5. **Indexing** -- Vectors are stored in an HNSW index for sub-millisecond approximate nearest neighbor search
+
+### 2. Searching
+
+1. Query text is enriched with pattern synonyms (e.g., "controller" adds "action execute http request dispatch")
+2. The enriched query is embedded into the same 384-dimensional vector space
+3. HNSW finds the nearest neighbors by cosine similarity
+4. Results are ranked and returned with file path, class name, Magento type, and relevance score
+
+### 3. MCP Integration
+
+The MCP server delegates all search/index operations to the Rust core binary. Analysis tools (diff, complexity) use ruvector JS modules directly.
+
+```
+Developer: "How does checkout totals calculation work?"
+     │
+     ▼
+AI Assistant ──▶ magento_search("checkout totals collector calculate")
+     │
+     ▼
+MCP Server ──▶ magector-core search (Rust) ──▶ HNSW lookup ──▶ Ranked results
+     │
+     ▼
+Results:
+  1. Quote/Model/Quote/TotalsCollector.php (0.554)
+  2. Quote/Model/Quote/Address/Total/Collector.php (0.524)
+  3. Quote/Model/Quote/Address/Total/Subtotal.php (0.517)
+```
+
+---
+
+## Magento Patterns Detected
+
+Magector understands these Magento 2 architectural patterns:
+
+| Pattern | Detection Method | Example |
+|---------|-----------------|---------|
+| Controller | Path + `execute()` method | `Controller/Adminhtml/Order/View.php` |
+| Model | Path + extends `AbstractModel` | `Model/Product.php` |
+| Repository | Path + implements `RepositoryInterface` | `Model/ProductRepository.php` |
+| Block | Path + extends `AbstractBlock` | `Block/Product/View.php` |
+| Plugin | Path + before/after/around methods | `Plugin/Product/SavePlugin.php` |
+| Observer | Path + implements `ObserverInterface` | `Observer/ProductSaveObserver.php` |
+| GraphQL Resolver | Path + implements `ResolverInterface` | `Model/Resolver/Products.php` |
+| Helper | Path under `Helper/` | `Helper/Data.php` |
+| Cron | Path under `Cron/` | `Cron/CleanExpiredQuotes.php` |
+| Console Command | Path + extends `Command` | `Console/Command/IndexerReindex.php` |
+| Data Provider | Path + `DataProvider` | `Ui/DataProvider/Product/Listing.php` |
+| ViewModel | Path + implements `ArgumentInterface` | `ViewModel/Product/Breadcrumbs.php` |
+| Setup Patch | Path + `Patch/Data` or `Patch/Schema` | `Setup/Patch/Data/AddAttribute.php` |
+| di.xml | Path matching | `etc/di.xml`, `etc/frontend/di.xml` |
+| events.xml | Path matching | `etc/events.xml` |
+| webapi.xml | Path matching | `etc/webapi.xml` |
+| layout XML | Path under `layout/` | `view/frontend/layout/catalog_product_view.xml` |
+| Template | `.phtml` extension | `view/frontend/templates/product/view.phtml` |
+| JavaScript | `.js` with AMD/ES6 detection | `view/frontend/web/js/view/minicart.js` |
+| GraphQL Schema | `.graphqls` extension | `etc/schema.graphqls` |
+
+---
+
+## Configuration
+
+### Cursor IDE Rules
+
+Copy `.cursorrules` to your Magento project root for optimized AI-assisted development. The rules instruct the AI to:
+
+1. Use Magector MCP tools before reading files manually
+2. Write effective semantic queries
+3. Follow Magento development patterns
+4. Interpret search results correctly
+
+### Model Configuration
+
+The ONNX model (`all-MiniLM-L6-v2`) is automatically downloaded on first run to `rust-core/models/`. To use a different location:
+
+```bash
+magector-core index -m /path/to/magento -c /custom/model/path
+```
+
+---
+
+## Development
+
+### Building from Source
+
+```bash
+git clone https://github.com/krejcif/magector.git
+cd magector
+
+# Install Node.js dependencies
+npm install
+
+# Build the Rust core
+cd rust-core
+cargo build --release
+cd ..
+
+# The CLI will automatically find the dev binary at rust-core/target/release/magector-core
+node src/cli.js help
+```
+
+### Building
+
+```bash
+# Rust core
+cd rust-core
+cargo build --release
+
+# Run unit tests
+cargo test
+
+# Run validation
+cargo run --release -- validate
+```
+
+### Testing
+
+```bash
+# Run MCP server auto tests (129 tests, requires indexed codebase)
+npm test
+
+# Run without index (unit + schema tests only)
+npm run test:no-index
+
+# Run Rust unit tests
+cd rust-core && cargo test
+
+# Run Rust validation (557 test cases)
+cd rust-core && cargo run --release -- validate -m ./magento2 --skip-index
+```
+
+### Adding New Magento Patterns
+
+1. Add pattern detection in `rust-core/src/magento.rs`
+2. Add search text enrichment in `rust-core/src/indexer.rs`
+3. Add validation test cases in `rust-core/src/validation.rs`
+4. Rebuild and run validation to verify:
+
+```bash
+cargo build --release
+./target/release/magector-core validate -m ./magento2 --skip-index
+```
+
+### Adding MCP Tools
+
+1. Define the tool schema in `src/mcp-server.js` (ListToolsRequestSchema handler)
+2. Implement the handler in the CallToolRequestSchema handler
+3. Test with Claude Code or the MCP inspector
+
+---
+
+## Technical Details
+
+### Embedding Model
+
+- **Model:** all-MiniLM-L6-v2
+- **Dimensions:** 384
+- **Pooling:** Mean pooling with attention mask
+- **Normalization:** L2 normalized
+- **Runtime:** ONNX Runtime (via `ort` crate)
+
+### Vector Index
+
+- **Algorithm:** HNSW (Hierarchical Navigable Small World)
+- **Library:** `hnsw_rs`
+- **Distance metric:** Cosine similarity
+- **Persistence:** JSON serialization (HNSW + metadata)
+
+### Index Structure
+
+Each indexed file produces a vector entry with metadata:
+
+```rust
+struct IndexMetadata {
+    path: String,
+    file_type: String,          // php, xml, js, template, graphql
+    magento_type: String,       // controller, model, block, plugin, ...
+    class_name: Option<String>,
+    namespace: Option<String>,
+    methods: Vec<String>,
+    search_text: String,        // Enriched searchable text
+    is_controller: bool,
+    is_plugin: bool,
+    is_observer: bool,
+    is_model: bool,
+    is_block: bool,
+    // ... 20+ pattern flags
+}
+```
+
+### Performance Characteristics
+
+| Operation | Time | Notes |
+|-----------|------|-------|
+| Full index (18K files) | ~1 min | Parallel parsing + batched ONNX embedding |
+| Single query | 15-45ms | HNSW approximate nearest neighbor |
+| Embedding generation | ~2ms | ONNX Runtime with CoreML/CUDA |
+| Batch embedding (32) | ~30ms | Batched ONNX inference |
+| Model load | ~500ms | One-time at startup |
+| Index save/load | <1s | Bincode binary serialization |
+
+### Performance Optimizations
+
+- **Batched ONNX embedding** -- 32 texts per inference call (vs. 1-at-a-time), 3-5x faster embedding
+- **Dynamic thread scaling** -- ONNX intra-op threads scale to CPU core count (vs. hardcoded 4)
+- **Thread-local AST parsers** -- each rayon thread gets its own tree-sitter parser (no mutex contention)
+- **Bincode persistence** -- binary serialization replaces JSON (3-5x faster save/load, ~5x smaller files)
+- **Adaptive HNSW capacity** -- pre-sized to actual vector count (no wasted memory)
+- **Parallel HNSW insert** -- batch insert uses hnsw_rs parallel insertion on load and index
+- **Optimized file discovery** -- no symlink following, uses cached DirEntry metadata
+
+---
+
+## Roadmap
+
+- [ ] Hybrid search (semantic + BM25 keyword matching)
+- [ ] Query intent classification (auto-detect "give me XML" vs "give me PHP")
+- [ ] Filtered search by file type at the vector level
+- [ ] Incremental indexing (only re-index changed files)
+- [ ] VSCode extension
+- [ ] Web UI for browsing results
+- [ ] Support for Magento 2 Commerce (B2B, Staging modules)
+
+---
+
+## License
+
+MIT License. See [LICENSE](LICENSE) for details.
+
+---
+
+## Contributing
+
+Contributions are welcome. Please:
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/improvement`)
+3. Add tests for new functionality
+4. Run validation to ensure accuracy doesn't regress
+5. Submit a pull request
+
+---
+
+Built with Rust and Node.js for the Magento community.

package/config/mcp-config.json

@@ -0,0 +1,13 @@
+{
+  "mcpServers": {
+    "magector": {
+      "command": "node",
+      "args": ["src/mcp-server.js"],
+      "cwd": "/Users/file/Code/magector",
+      "env": {
+        "MAGENTO_ROOT": "/path/to/your/magento",
+        "MAGECTOR_DB": "/Users/file/Code/magector/magector.db"
+      }
+    }
+  }
+}