codebase-context 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 PatrickSys
+
+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,74 @@
+# codebase-context
+
+**AI coding agents don't know your codebase. This MCP fixes that.**
+
+Your team has internal libraries, naming conventions, and patterns that external AI models have never seen. This MCP server gives AI assistants real-time visibility into your codebase: which libraries your team actually uses, how often, and where to find canonical examples.
+
+## Quick Start
+
+Add this to your MCP client config (Claude Desktop, VS Code, Cursor, etc.).
+
+```json
+"mcpServers": {
+  "codebase-context": {
+    "command": "npx",
+    "args": ["codebase-context", "/path/to/your/project"]
+  }
+}
+```
+
+## What You Get
+
+- **Internal library discovery** → `@mycompany/ui-toolkit`: 847 uses vs `primeng`: 3 uses
+- **Pattern frequencies** → `inject()`: 97%, `constructor()`: 3%
+- **Golden file examples** → Real implementations showing all patterns together
+- **Testing conventions** → `Jest`: 74%, `Playwright`: 6%
+- **Framework patterns** → Angular signals, standalone components, etc.
+
+## How It Works
+
+When generating code, the agent checks your patterns first:
+
+| Without MCP | With MCP |
+|-------------|----------|
+| Uses `constructor(private svc: Service)` | Uses `inject()` (97% team adoption) |
+| Suggests `primeng/button` directly | Uses `@codeblue/prime` wrapper |
+| Generic Jest setup | Your team's actual test utilities |
+
+### Tip: Auto-invoke in your rules
+
+Add this to your `.cursorrules`, `CLAUDE.md`, or `AGENTS.md`:
+
+```
+When generating or reviewing code, use codebase-context tools to check team patterns first.
+```
+
+Now the agent checks patterns automatically instead of waiting for you to ask.
+
+## Tools
+
+| Tool | Purpose |
+|------|---------|
+| `search_codebase` | Semantic + keyword hybrid search |
+| `get_component_usage` | Find where a library/component is used |
+| `get_team_patterns` | Pattern frequencies + canonical examples |
+| `get_codebase_metadata` | Project structure overview |
+| `get_style_guide` | Query style guide rules |
+| `refresh_index` | Re-index the codebase |
+
+## Configuration
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `EMBEDDING_PROVIDER` | `transformers` | `openai` (fast, cloud) or `transformers` (local, private) |
+| `OPENAI_API_KEY` | - | Required if provider is `openai` |
+
+## Links
+
+- 📄 [Motivation](./MOTIVATION.md) — Why this exists, research, learnings
+- 📋 [Changelog](./CHANGELOG.md) — Version history
+- 🤝 [Contributing](./CONTRIBUTING.md) — How to add analyzers
+
+## License
+
+MIT

package/dist/analyzers/angular/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Angular Analyzer - Comprehensive Angular-specific code analysis
+ * Understands components, services, directives, pipes, modules, guards, interceptors, etc.
+ * Detects state management patterns, architectural layers, and Angular-specific patterns
+ */
+import { FrameworkAnalyzer, AnalysisResult, CodebaseMetadata, CodeChunk } from "../../types/index.js";
+export declare class AngularAnalyzer implements FrameworkAnalyzer {
+    readonly name = "angular";
+    readonly version = "1.0.0";
+    readonly supportedExtensions: string[];
+    readonly priority = 100;
+    private angularPatterns;
+    private stateManagementPatterns;
+    private modernAngularPatterns;
+    canAnalyze(filePath: string, content?: string): boolean;
+    analyze(filePath: string, content: string): Promise<AnalysisResult>;
+    private analyzeTypeScriptFile;
+    /**
+     * Detect Angular v17+ modern patterns in the code
+     */
+    private detectModernAngularPatterns;
+    private extractAngularComponent;
+    private extractDecoratorMetadata;
+    private extractLifecycleHooks;
+    private extractInjectedServices;
+    private extractInputs;
+    private extractOutputs;
+    private analyzeTemplateFile;
+    private analyzeStyleFile;
+    private detectStateManagement;
+    private determineLayer;
+    private categorizeDependency;
+    detectCodebaseMetadata(rootPath: string): Promise<CodebaseMetadata>;
+    /**
+     * Generate Angular-specific summary for a code chunk
+     */
+    summarize(chunk: CodeChunk): string;
+    private extractLifecycleMethods;
+    private extractPublicMethods;
+    private detectGuardType;
+    private extractFirstComment;
+    private extractFirstLine;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/analyzers/angular/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analyzers/angular/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,SAAS,EAOV,MAAM,sBAAsB,CAAC;AAI9B,qBAAa,eAAgB,YAAW,iBAAiB;IACvD,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,mBAAmB,WAQ1B;IACF,QAAQ,CAAC,QAAQ,OAAO;IAExB,OAAO,CAAC,eAAe,CAarB;IAEF,OAAO,CAAC,uBAAuB,CAO7B;IAEF,OAAO,CAAC,qBAAqB,CAa3B;IAEF,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO;IAuBjD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;YA0B3D,qBAAqB;IA+NnC;;OAEG;IACH,OAAO,CAAC,2BAA2B;YAcrB,uBAAuB;IAsHrC,OAAO,CAAC,wBAAwB;IAgChC,OAAO,CAAC,qBAAqB;IA2B7B,OAAO,CAAC,uBAAuB;IA0B/B,OAAO,CAAC,aAAa;IA8CrB,OAAO,CAAC,cAAc;YA6CR,mBAAmB;YAyCnB,gBAAgB;IA8B9B,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,cAAc;IAkEtB,OAAO,CAAC,oBAAoB;IAmCtB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAmKzE;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM;IAkFnC,OAAO,CAAC,uBAAuB;IAY/B,OAAO,CAAC,oBAAoB;IAU5B,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,mBAAmB;IAK3B,OAAO,CAAC,gBAAgB;CAMzB"}