🔥 REFACTOR: Implement FrameworkEnricher pattern for PHP

- Introduce FrameworkEnricher interface in core PHP analyzer
- Isolate Laravel and WordPress specific analysis into enricher.go
- Resolve plugin overhead with blank imports on run/test files
- Maintain lazy-loading decoupled structure to prevent import cycles

Author: doITmagic

internal/daemon/run.go

@@ -27,6 +27,8 @@ import (
 	_ "github.com/doITmagic/rag-code-mcp/pkg/parser/html"
 	_ "github.com/doITmagic/rag-code-mcp/pkg/parser/javascript"
 	_ "github.com/doITmagic/rag-code-mcp/pkg/parser/php"
+	_ "github.com/doITmagic/rag-code-mcp/pkg/parser/php/laravel"
+	_ "github.com/doITmagic/rag-code-mcp/pkg/parser/php/wordpress"
 	_ "github.com/doITmagic/rag-code-mcp/pkg/parser/python"
 	"github.com/doITmagic/rag-code-mcp/pkg/storage"
 	"github.com/modelcontextprotocol/go-sdk/mcp"

internal/service/tools/tests/tools_suite_test.go

@@ -4,7 +4,10 @@ import (
 	"testing"
 
 	_ "github.com/doITmagic/rag-code-mcp/pkg/parser/go"
+	_ "github.com/doITmagic/rag-code-mcp/pkg/parser/javascript"
 	_ "github.com/doITmagic/rag-code-mcp/pkg/parser/php"
+	_ "github.com/doITmagic/rag-code-mcp/pkg/parser/php/laravel"
+	_ "github.com/doITmagic/rag-code-mcp/pkg/parser/php/wordpress"
 	_ "github.com/doITmagic/rag-code-mcp/pkg/parser/python"
 
 	. "github.com/onsi/ginkgo/v2"

pkg/parser/php/laravel/enricher.go

@@ -0,0 +1,46 @@
+package laravel
+
+import (
+	"github.com/doITmagic/rag-code-mcp/pkg/parser/php"
+)
+
+// Enricher implements the php.FrameworkEnricher interface for Laravel analysis
+type Enricher struct {
+	adapter *Adapter
+}
+
+func init() {
+	php.RegisterEnricher(&Enricher{
+		adapter: NewAdapter(),
+	})
+}
+
+// IsApplicable checks if the parsed paths correspond to a Laravel project
+func (e *Enricher) IsApplicable(ca *php.CodeAnalyzer, paths []string) bool {
+	return ca.IsLaravelProject()
+}
+
+// Enrich receives the base PHP chunks and analyzed packages and returns chunks merged with Laravel specifics
+func (e *Enricher) Enrich(ca *php.CodeAnalyzer, packages []*php.PackageInfo, paths []string, chunks []php.CodeChunk) []php.CodeChunk {
+	// Run Laravel-specific package analysis for Controllers and Eloquent Models
+	for _, pkg := range packages {
+		analyzer := NewAnalyzer(pkg)
+		info := analyzer.Analyze()
+
+		// Enrich existing chunks with Laravel context (table, fillable, api routes)
+		e.adapter.enrichChunks(chunks, info)
+	}
+
+	// Analyze Routes (these are handled separately since they are mostly top level closures inside routes/)
+	routeFiles := e.adapter.findRouteFiles(paths)
+	if len(routeFiles) > 0 {
+		routeAnalyzer := NewRouteAnalyzer()
+		routes, err := routeAnalyzer.Analyze(routeFiles)
+		if err == nil {
+			routeChunks := e.adapter.convertRoutesToChunks(routes)
+			chunks = append(chunks, routeChunks...)
+		}
+	}
+
+	return chunks
+}

pkg/parser/php/php_analyzer.go

@@ -10,6 +10,19 @@ import (
 	pkgParser "github.com/doITmagic/rag-code-mcp/pkg/parser"
 )
 
+// FrameworkEnricher defines an interface for adding framework-specific parsing (e.g., Laravel, WordPress).
+type FrameworkEnricher interface {
+	IsApplicable(ca *CodeAnalyzer, paths []string) bool
+	Enrich(ca *CodeAnalyzer, packages []*PackageInfo, paths []string, chunks []CodeChunk) []CodeChunk
+}
+
+var enrichers []FrameworkEnricher
+
+// RegisterEnricher adds a framework-specific enricher to the PHP parser.
+func RegisterEnricher(e FrameworkEnricher) {
+	enrichers = append(enrichers, e)
+}
+
 func init() {
 	pkgParser.Register(NewAnalyzer())
 }
@@ -38,11 +51,22 @@ func (a *Analyzer) CanHandle(filePath string) bool {
 
 // Analyze extracts symbols from a file or directory.
 func (a *Analyzer) Analyze(ctx context.Context, path string) (*pkgParser.Result, error) {
-	chunks, err := a.codeAnalyzer.AnalyzePaths([]string{path})
+	paths := []string{path}
+	chunks, err := a.codeAnalyzer.AnalyzePaths(paths)
 	if err != nil {
 		return nil, err
 	}
 
+	// Fetch packages analyzed by the core PHP parser
+	packages := a.codeAnalyzer.GetPackages()
+
+	// Run all registered framework enrichers
+	for _, enricher := range enrichers {
+		if enricher.IsApplicable(a.codeAnalyzer, paths) {
+			chunks = enricher.Enrich(a.codeAnalyzer, packages, paths, chunks)
+		}
+	}
+
 	// If no symbols found and the file is in a routes/ directory,
 	// try extracting Route::* calls as symbols (Laravel convention).
 	if len(chunks) == 0 && isRouteFile(path) {

pkg/parser/php/wordpress/enricher.go

@@ -0,0 +1,33 @@
+package wordpress
+
+import "github.com/doITmagic/rag-code-mcp/pkg/parser/php"
+
+// Enricher implements the php.FrameworkEnricher interface for WordPress analysis
+type Enricher struct {
+	analyzer *Analyzer
+}
+
+func init() {
+	php.RegisterEnricher(&Enricher{
+		analyzer: NewAnalyzer(),
+	})
+}
+
+// IsApplicable checks if the parsed paths correspond to a WordPress project
+func (e *Enricher) IsApplicable(ca *php.CodeAnalyzer, paths []string) bool {
+	return IsWordPressProject(paths)
+}
+
+// Enrich receives the base PHP chunks and analyzed packages and returns chunks merged with WordPress specifics
+func (e *Enricher) Enrich(ca *php.CodeAnalyzer, packages []*php.PackageInfo, paths []string, chunks []php.CodeChunk) []php.CodeChunk {
+	// Reusing logic from wordpress.Analyzer
+	wpInfo := e.analyzer.analyzeWordPress(packages, paths)
+
+	// Enrich existing basic PHP chunks with WP info (e.g. marking Widgets)
+	e.analyzer.enrichChunks(chunks, wpInfo)
+
+	// Extract new specific chunks like Hooks, Blocks, Shortcodes, CPTs
+	wpChunks := e.analyzer.convertToChunks(wpInfo)
+	
+	return append(chunks, wpChunks...)
+}