add-feature

add-feature

Add a new feature to Code-Index-MCP following the plugin-based architecture.

Feature: $ARGUMENTS[0] (Type: $ARGUMENTS[1])

1. Planning Phase

• Define feature scope and requirements
• Determine if it's a new plugin, core feature, or utility
• Identify dependencies (Tree-sitter grammars, external libraries)
• Plan integration with existing components

2. Architecture Design

For New Language Plugin:

mcp_server/
├── plugins/
│   └── $ARGUMENTS[0]_plugin/
│       ├── __init__.py
│       ├── plugin.py           # Implements IPlugin interface
│       ├── AGENTS.md          # AI agent configuration
│       └── CLAUDE.md          # Points to AGENTS.md for instructions

For Core Feature:

mcp_server/
├── $ARGUMENTS[0].py           # Core implementation
├── utils/
│   └── $ARGUMENTS[0]_helper.py # Supporting utilities
└── tests/
    └── test_$ARGUMENTS[0].py  # Unit tests

3. Plugin Implementation Template

# mcp_server/plugins/$ARGUMENTS[0]_plugin/plugin.py
from pathlib import Path
from typing import Iterable

from ...plugin_base import (
    IPlugin, IndexShard, SymbolDef, 
    Reference, SearchResult, SearchOpts
)
from ...utils.treesitter_wrapper import TreeSitterWrapper

class Plugin(IPlugin):
    lang = "$ARGUMENTS[0]"
    
    def __init__(self) -> None:
        self._ts = TreeSitterWrapper()
        # Initialize language-specific components
    
    def supports(self, path: str | Path) -> bool:
        """Check if file extension matches plugin."""
        return Path(path).suffix in {".ext", ".extension"}
    
    def indexFile(self, path: str | Path, content: str) -> IndexShard:
        """Parse and index file content."""
        # Implementation using tree-sitter
        pass
    
    def getDefinition(self, symbol: str) -> SymbolDef | None:
        """Find symbol definition."""
        pass
    
    def findReferences(self, symbol: str) -> Iterable[Reference]:
        """Find all references to symbol."""
        pass
    
    def search(self, query: str, opts: SearchOpts | None = None) -> Iterable[SearchResult]:
        """Search for code patterns."""
        pass