feat: add react and nextjs analyzers

Upstream the React and Next.js analyzer work from issue #2 and the aolin480 fork through the existing registry surfaces with focused tests and docs updates.

Author: PatrickSys

CONTRIBUTING.md

@@ -22,6 +22,8 @@ See [README.md](./README.md) for configuration with Claude Desktop, VS Code, Cur
 src/
   analyzers/
     angular/     # Angular-specific analysis
+    nextjs/      # Next.js routes, metadata, and client/server detection
+    react/       # React components, hooks, and context patterns
     generic/     # Fallback for non-Angular files
   core/
     indexer.ts   # Scans files, creates chunks
@@ -34,8 +36,6 @@ src/
 
 ## What Would Help
 
-**React analyzer** - Biggest gap right now. Look at `src/analyzers/angular/index.ts` for the pattern. Needs to detect components, hooks, context usage, etc.
-
 **Vue analyzer** - Same deal. Detect components, composables, Pinia stores.
 
 **Better search ranking** - The hybrid search in `src/core/search.ts` could use tuning. Currently uses RRF to combine semantic and keyword scores.
@@ -44,9 +44,9 @@ src/
 
 ## Adding a Framework Analyzer
 
-1. Create `src/analyzers/react/index.ts`
+1. Create `src/analyzers/<framework>/index.ts`
 2. Implement `FrameworkAnalyzer` interface
-3. Register in `src/index.ts`
+3. Register in `src/index.ts`, `src/cli.ts`, and `src/lib.ts`
 
 The interface is straightforward:
 

README.md

@@ -145,7 +145,7 @@ If you get `selection_required`, retry with one of the paths from `availableProj
 
 ## Language Support
 
-10 languages with full symbol extraction via Tree-sitter: TypeScript, JavaScript, Python, Java, Kotlin, C, C++, C#, Go, Rust. 30+ languages with indexing and retrieval coverage, including PHP, Ruby, Swift, Scala, Shell, and config formats. Angular has a dedicated analyzer; everything else uses the Generic analyzer with AST-aligned chunking when a grammar is available.
+10 languages with full symbol extraction via Tree-sitter: TypeScript, JavaScript, Python, Java, Kotlin, C, C++, C#, Go, Rust. 30+ languages with indexing and retrieval coverage, including PHP, Ruby, Swift, Scala, Shell, and config formats. Angular, React, and Next.js have dedicated analyzers; everything else uses the Generic analyzer with AST-aligned chunking when a grammar is available.
 
 ## Configuration
 
@@ -156,6 +156,9 @@ If you get `selection_required`, retry with one of the paths from `availableProj
 | `CODEBASE_ROOT` | — | Bootstrap root for CLI and single-project MCP clients |
 | `CODEBASE_CONTEXT_DEBUG` | — | Set to `1` for verbose logging |
 | `EMBEDDING_MODEL` | `Xenova/bge-small-en-v1.5` | Local embedding model override |
+| `CODEBASE_CONTEXT_HTTP` | — | Set to `1` to start in HTTP mode (same as `--http` flag) |
+| `CODEBASE_CONTEXT_PORT` | `3100` | HTTP server port override (same as `--port`; ignored in stdio mode) |
+| `CODEBASE_CONTEXT_CONFIG_PATH` | `~/.codebase-context/config.json` | Override the server config file path |
 
 ## Performance
 

docs/capabilities.md

@@ -269,6 +269,8 @@ Impact is 2-hop transitive: direct importers (hop 1) and their importers (hop 2)
 ## Analyzers
 
 - **Angular**: signals, standalone components, control flow syntax, lifecycle hooks, DI patterns, component metadata
+- **React**: function/class components, custom hooks, context usage, memoization, Suspense, ecosystem signal extraction
+- **Next.js**: App Router and Pages Router detection, route/API classification, route paths, `"use client"`, metadata exports
 - **Generic**: 30+ have indexing/retrieval coverage including PHP, Ruby, Swift, Scala, Shell, config/markup., 10 languages have full symbol extraction (Tree-sitter: TypeScript, JavaScript, Python, Java, Kotlin, C, C++, C#, Go, Rust). 
 
 Notes:
@@ -291,6 +293,6 @@ Reproducible evaluation is shipped as a CLI entrypoint backed by shared scoring/
 
 - **Symbol refs are not a call-graph.** `get_symbol_references` counts identifier-node occurrences in the AST (comments/strings excluded via Tree-sitter). It does not distinguish call sites from type annotations, variable assignments, or imports. Full call-site-specific analysis (`call_expression` nodes only) is a roadmap item.
 - **Impact is 2-hop max.** `computeImpactCandidates` walks direct importers then their importers. Full BFS reachability is on the roadmap.
-- **Angular is the only framework with a rich dedicated analyzer.** All other languages go through the Generic analyzer (30+ languages, chunking + import graph, no framework-specific signal extraction).
+- **Angular, React, and Next.js have dedicated analyzers.** All other languages go through the Generic analyzer (30+ languages, chunking + import graph, no framework-specific signal extraction).
 - **Default embedding model is `bge-small-en-v1.5` (512-token context).** Granite (8192 context) is opt-in via `EMBEDDING_MODEL`. OpenAI is opt-in via `EMBEDDING_PROVIDER=openai` — sends code externally.
 - **Patterns are file-level frequency counts.** Not semantic clustering. Rising/Declining trend is derived from git commit recency for files using each pattern, not from usage semantics.

package.json

@@ -18,6 +18,14 @@
       "import": "./dist/analyzers/angular/index.js",
       "types": "./dist/analyzers/angular/index.d.ts"
     },
+    "./analyzers/react": {
+      "import": "./dist/analyzers/react/index.js",
+      "types": "./dist/analyzers/react/index.d.ts"
+    },
+    "./analyzers/nextjs": {
+      "import": "./dist/analyzers/nextjs/index.js",
+      "types": "./dist/analyzers/nextjs/index.d.ts"
+    },
     "./analyzers/generic": {
       "import": "./dist/analyzers/generic/index.js",
       "types": "./dist/analyzers/generic/index.d.ts"

src/analyzers/angular/index.ts

@@ -25,6 +25,7 @@ import {
   KEYWORD_INDEX_FILENAME
 } from '../../constants/codebase-context.js';
 import { registerComplementaryPatterns } from '../../patterns/semantics.js';
+import { isFileNotFoundError } from '../shared/metadata.js';
 
 interface AngularInput {
   name: string;
@@ -911,7 +912,7 @@ export class AngularAnalyzer implements FrameworkAnalyzer {
         ...packageJson.devDependencies
       };
 
-      const angularVersion = allDeps['@angular/core']?.replace(/[\^~]/, '') || 'unknown';
+      const angularCoreVersion = allDeps['@angular/core'];
 
       // Detect state management
       const stateManagement: string[] = [];
@@ -931,15 +932,17 @@ export class AngularAnalyzer implements FrameworkAnalyzer {
       if (allDeps['karma']) testingFrameworks.push('Karma');
       if (allDeps['jest']) testingFrameworks.push('Jest');
 
-      metadata.framework = {
-        name: 'Angular',
-        version: angularVersion,
-        type: 'angular',
-        variant: 'unknown', // Will be determined during analysis
-        stateManagement,
-        uiLibraries,
-        testingFrameworks
-      };
+      if (angularCoreVersion) {
+        metadata.framework = {
+          name: 'Angular',
+          version: angularCoreVersion.replace(/[\^~]/, ''),
+          type: 'angular',
+          variant: 'unknown', // Will be determined during analysis
+          stateManagement,
+          uiLibraries,
+          testingFrameworks
+        };
+      }
 
       // Convert dependencies
       metadata.dependencies = Object.entries(allDeps).map(([name, version]) => ({
@@ -948,7 +951,9 @@ export class AngularAnalyzer implements FrameworkAnalyzer {
         category: this.categorizeDependency(name)
       }));
     } catch (error) {
-      console.warn('Failed to read Angular project metadata:', error);
+      if (!isFileNotFoundError(error)) {
+        console.warn('Failed to read Angular project metadata:', error);
+      }
     }
 
     // Calculate statistics from existing index if available
@@ -966,8 +971,6 @@ export class AngularAnalyzer implements FrameworkAnalyzer {
       const chunks =
         parsedObj && Array.isArray(parsedObj.chunks) ? (parsedObj.chunks as IndexChunk[]) : null;
       if (Array.isArray(chunks) && chunks.length > 0) {
-        console.error(`Loading statistics from ${indexPath}: ${chunks.length} chunks`);
-
         metadata.statistics.totalFiles = new Set(chunks.map((c) => c.filePath)).size;
         metadata.statistics.totalLines = chunks.reduce(
           (sum, c) => sum + ((c.endLine ?? 0) - (c.startLine ?? 0) + 1),
@@ -1005,8 +1008,9 @@ export class AngularAnalyzer implements FrameworkAnalyzer {
         metadata.architecture.layers = layerCounts;
       }
     } catch (error) {
-      // Index doesn't exist yet, keep statistics at 0
-      console.warn('Failed to calculate statistics from index:', error);
+      if (!isFileNotFoundError(error)) {
+        console.warn('Failed to calculate statistics from index:', error);
+      }
     }
 
     return metadata;