@noyrax/5d-database-plugin 0.1.8 → 0.1.10-beta.1

package/MCP_SERVER_SETUP.md

@@ -92,6 +92,12 @@ noyrax-5d-database-tool <workspace-root> learning_path <topic>
 
 # Cross Analysis
 noyrax-5d-database-tool <workspace-root> cross_analysis <filePath>
+
+# Gap Analysis (ab Version 0.1.8)
+noyrax-5d-database-tool <workspace-root> gap_analysis [--min-deps N] [--limit N]
+
+# Architecture Mining (ab Version 0.1.8)
+noyrax-5d-database-tool <workspace-root> architecture_mining [filePath]
 ```
 
 ### Semantic-Search-CLI (V-Dimension)
@@ -189,6 +195,10 @@ Der MCP-Server stellt folgende Tools bereit:
 | `query_symbols` | Query Symbols nach path oder symbolId | `path?`, `symbolId?`, `pluginId` |
 | `query_dependencies` | Query Dependencies nach fromModule oder toModule | `fromModule?`, `toModule?`, `pluginId` |
 | `cross_analysis` | Cross-Dimension-Analyse für filePath | `filePath`, `pluginId` |
+| `gap_analysis` | Findet Dokumentationslücken (Module mit vielen Dependencies aber wenigen ADRs) | `pluginId`, `minDependencies?` (default: 5), `limit?` (default: 50) |
+| `architecture_mining` | Leitet Architektur-Entscheidungen aus Code-Struktur ab | `pluginId`, `filePath?` (optional, für spezifische Datei) |
+| `generate_documentation` | Generiert Dokumentation mit Noyrax (scan → validate → generate) | `pluginId` |
+| `check_docs_status` | Prüft ob docs/ existiert und aktuell ist | `pluginId` |
 
 ## Verfügbare Resources
 
@@ -356,4 +366,8 @@ chmod +x out/cli/mcp-server-cli.js
 - Siehe ADR-007 für MCP-Server-Architektur-Details
 - Siehe ADR-028 für Semantic Brain MCP-Tools
 - Siehe ADR-033 für MCP-Server CLI-Integration und System-Kopplung
+- Siehe ADR-034 für Gap Analysis Tool
+- Siehe ADR-035 für Architecture Mining Tool
+
+**Hinweis:** Die Tools `gap_analysis` und `architecture_mining` sind ab Version 0.1.8 verfügbar.
 

package/README.md

@@ -16,6 +16,13 @@ Noyrax (Documentation System) → generiert docs/ → 5D Database Plugin → SQL
 - **5D Database Plugin** liest `docs/` und speichert die Daten in SQLite-Datenbanken
 - **MCP-Server** ermöglicht LLM-Agenten-Zugriff auf die Datenbanken
 
+### Monorepo-Integration
+
+In diesem Workspace sind beide Plugins als Monorepo integriert:
+- `documentation-system-plugin/` - Noyrax Documentation System Plugin
+- `5d-database-plugin/` - 5D Database Plugin
+- `docs/` - Gemeinsam genutzte Dokumentation
+
 Siehe `SETUP_NEW_PROJECT.md` für vollständigen Setup-Workflow.
 
 ## Übersicht
@@ -35,14 +42,39 @@ Das 5D Database Plugin speichert die 5 Dimensionen des Documentation System Plug
 - **Cross-Dimension-Queries** - Verknüpfungen zwischen Dimensionen
 - **MCP-Server Integration** - Systemweiter Zugriff via Model Context Protocol
 - **VS Code UI** - Database Explorer und Status Bar Integration
+- **Monorepo-Integration** - Noyrax und 5D Database Plugin im gleichen Workspace
+- **Workflow-Orchestrierung** - Vollständiger Workflow (Generate Docs → Ingest → Embeddings)
 
 ## Installation
 
-⚠️ **Voraussetzung: Documentation System Plugin (Noyrax) muss installiert sein und `docs/` generiert haben!**
+### Via npm (Recommended for CLI Tools)
 
-Siehe `SETUP_NEW_PROJECT.md` für vollständige Anleitung mit beiden Plugins.
+```bash
+npm install -g @noyrax/5d-database-plugin
+```
+
+**Available CLI Tools:**
+- `noyrax-5d-database` - Ingest documentation
+- `noyrax-5d-database-query` - Query database
+- `noyrax-5d-database-tool` - Use MCP tools directly
+- `noyrax-5d-database-search` - Semantic search
+- `noyrax-5d-database-embedding` - Generate embeddings
+
+**Example:**
+```bash
+# Ingest documentation
+noyrax-5d-database ingest /path/to/workspace
 
-### Schnellstart
+# Query modules
+noyrax-5d-database-query /path/to/workspace modules src/api/user-service.ts
+
+# Semantic search
+noyrax-5d-database-tool /path/to/workspace semantic_discovery "How does authentication work?" 5
+```
+
+### Via VS Code Extension
+
+⚠️ **Voraussetzung: Documentation System Plugin (Noyrax) muss installiert sein und `docs/` generiert haben!**
 
 1. **Documentation System Plugin (Noyrax) installieren** und `docs/` generieren
 2. **5D Database Plugin installieren:**
@@ -53,6 +85,8 @@ Siehe `SETUP_NEW_PROJECT.md` für vollständige Anleitung mit beiden Plugins.
 4. **Extension aktiviert sich automatisch** beim Start
 5. **Ingestion ausführen:** `Ctrl+Shift+P` → "Ingest Documentation"
 
+Siehe `SETUP_NEW_PROJECT.md` für vollständige Anleitung mit beiden Plugins.
+
 ## Verwendung
 
 ### Ingestion
@@ -125,6 +159,8 @@ Der MCP-Server bietet Zugriff auf alle Dimensionen via Model Context Protocol:
   - `query_modules`, `query_symbols`, `query_dependencies`, `cross_analysis`
   - `gap_analysis` - Systematische Dokumentationslücken-Identifikation
   - `architecture_mining` - Rückwirkende Architektur-Entscheidungs-Erkennung aus Code
+  - `generate_documentation` - Dokumentation generieren (Noyrax-Integration)
+  - `check_docs_status` - Prüft ob docs/ existiert und aktuell ist
 
 Siehe `MCP_SERVER_SETUP.md` für detaillierte Setup-Anleitung für LLM-Agenten.
 
@@ -234,6 +270,16 @@ Siehe `CHROMADB_SETUP.md` für ChromaDB-Konfiguration.
 - **`CHROMADB_SETUP.md`** - ChromaDB-Installation und -Konfiguration (Windows)
 - **`docs/adr/`** - Architecture Decision Records (32 ADRs dokumentieren alle Entscheidungen)
 
+## Strategische Vision
+
+- **[`../../VISION.md`](../../VISION.md)** - Vision: Autonome KI-gesteuerte Softwareentwicklung
+- **[`../../INNOVATION_ANALYSIS.md`](../../INNOVATION_ANALYSIS.md)** - Innovations-Analyse: Was macht das System besonders?
+- **[`../../PROBLEM_SOLUTION_MAPPING.md`](../../PROBLEM_SOLUTION_MAPPING.md)** - Problem-Lösung-Mapping
+- **[`../../AI_CODING_IMPLICATIONS.md`](../../AI_CODING_IMPLICATIONS.md)** - AI-Coding Implications
+- **[`../../BUSINESS_IMPACT.md`](../../BUSINESS_IMPACT.md)** - Business Impact: Kosteneinsparungen
+- **[`../../QUALITY_IMPROVEMENT.md`](../../QUALITY_IMPROVEMENT.md)** - Qualitätsverbesserung
+- **[`../../DOMAIN_TRANSFERABILITY.md`](../../DOMAIN_TRANSFERABILITY.md)** - Domänen-Transferfähigkeit
+
 ## License
 
 MIT

package/SETUP_NEW_PROJECT.md

@@ -13,12 +13,42 @@ Die beiden Plugins sind eng gekoppelt:
 - **5D Database Plugin** liest `docs/` und speichert die Daten in SQLite-Datenbanken
 - **MCP-Server** ermöglicht LLM-Agenten-Zugriff auf die Datenbanken
 
+### Monorepo-Integration
+
+In diesem Workspace sind beide Plugins als Monorepo integriert:
+- `documentation-system-plugin/` - Noyrax Documentation System Plugin
+- `5d-database-plugin/` - 5D Database Plugin
+- `docs/` - Gemeinsam genutzte Dokumentation
+
+**Vorteile der Monorepo-Integration:**
+- Beide Plugins im gleichen Workspace
+- Einfache Workflow-Koordination
+- MCP-Server kann auf beide Plugins zugreifen
+- Gemeinsame `docs/` Ordnerstruktur
+
 ## Voraussetzungen
 
 1. **Node.js installiert** (Version 16.x oder höher)
 2. **(Optional) VS Code** für UI-Integration
 3. **Beide Plugins müssen installiert werden** (Noyrax + 5D Database)
 
+### Monorepo-Setup (Dieser Workspace)
+
+Wenn beide Plugins im gleichen Workspace sind (Monorepo):
+
+```bash
+# Workspace-Root: Alle Dependencies installieren
+npm install
+
+# Alle Plugins kompilieren
+npm run compile:all
+
+# Vollständiger Workflow (Generate Docs → Ingest → Embeddings)
+npm run workflow:full
+```
+
+Siehe `README.md` (Workspace-Root) für vollständige Workspace-Dokumentation.
+
 ## Schritt 1: Documentation System Plugin (Noyrax) installieren
 
 ### Option A: VS Code Extension
@@ -69,7 +99,22 @@ noyrax-documentation generate /path/to/your-project
 
 Jetzt installieren wir das 5D Database Plugin, das die generierte Dokumentation in Datenbanken speichert.
 
-### Option A: VS Code Extension
+### Monorepo (Dieser Workspace)
+
+Das 5D Database Plugin ist bereits im Workspace integriert. Ingestion kann via Workspace-Scripts ausgeführt werden:
+
+```bash
+# Dokumentation ingestieren
+npm run db:ingest
+
+# Embeddings generieren
+npm run db:embedding
+
+# Vollständiger Workflow (Generate Docs → Ingest → Embeddings)
+npm run workflow:full
+```
+
+### Option A: VS Code Extension (Separate Plugins)
 
 ```bash
 code --install-extension 5d-database-plugin-0.1.0.vsix
@@ -140,19 +185,148 @@ noyrax-5d-database ingest /path/to/your-project --full
 [Ingest CLI] Ingestion completed successfully
 ```
 
-## Schritt 6: (Optional) MCP-Server für LLM-Agenten konfigurieren
+## Schritt 6: Unified MCP Server Setup
+
+Der Unified MCP Server orchestriert beide Plugins und bietet einen zentralen Zugriff für AI-Agenten (Cursor, VS Code, Claude Desktop).
+
+### Schritt 6.1: MCP Server kompilieren
+
+```bash
+# MCP Server kompilieren
+npm run mcp:build
+
+# Oder direkt
+cd mcp-server
+npm run compile
+```
 
-Wenn du LLM-Agenten (Claude, GPT, Cursor AI) nutzen möchtest, konfiguriere den MCP-Server.
+**Verifikation:**
+```bash
+# Prüfen ob MCP Server kompiliert wurde
+Test-Path mcp-server/out/cli/server-cli.js
+```
 
-Siehe `MCP_SERVER_SETUP.md` für detaillierte Anleitung.
+### Schritt 6.2: MCP Server testen
 
-**Kurzfassung:**
 ```bash
-# MCP-Server starten
-noyrax-5d-database-mcp /path/to/your-project
+# MCP Server starten (für Testing)
+npm run mcp:start .
+
+# Oder direkt
+node mcp-server/out/cli/server-cli.js .
+```
+
+**Erwartete Ausgabe:**
+```
+[UnifiedMcpServer] Initializing...
+[UnifiedMcpServer] Database Plugin available: true
+[UnifiedMcpServer] Documentation Plugin available: true
+[UnifiedMcpServer] Registered 20 tools
+[UnifiedMcpServer] Server ready
+```
+
+### Schritt 6.3: Cursor Konfiguration
+
+Erstellen Sie `.cursor/mcp-config.json` im Workspace-Root:
+
+```json
+{
+  "mcpServers": {
+    "noyrax": {
+      "command": "node",
+      "args": [
+        "${workspaceFolder}/mcp-server/out/cli/server-cli.js",
+        "${workspaceFolder}"
+      ],
+      "env": {
+        "NODE_ENV": "production"
+      }
+    }
+  }
+}
+```
+
+**Nach Konfiguration:**
+1. Cursor vollständig schließen
+2. Cursor neu öffnen
+3. MCP Server sollte automatisch verbinden
+
+**Verifikation:**
+- Öffnen Sie Cursor Chat
+- Fragen Sie: "Was ist das System?" oder "System-Status prüfen"
+- Der AI-Agent sollte über MCP Server Tools zugreifen können
+
+Siehe [mcp-server/INSTALLATION_GUIDE.md](../mcp-server/INSTALLATION_GUIDE.md) für detaillierte Cursor-Konfiguration.
+
+### Schritt 6.4: VS Code Konfiguration
+
+Erstellen Sie `.vscode/settings.json` im Workspace-Root:
+
+```json
+{
+  "mcp.servers": {
+    "noyrax": {
+      "command": "node",
+      "args": [
+        "${workspaceFolder}/mcp-server/out/cli/server-cli.js",
+        "${workspaceFolder}"
+      ],
+      "env": {
+        "NODE_ENV": "production"
+      }
+    }
+  }
+}
 ```
 
-Oder konfiguriere Claude Desktop (siehe `MCP_SERVER_SETUP.md`).
+**Nach Konfiguration:**
+1. `Ctrl+Shift+P` → "Developer: Reload Window"
+2. MCP Server sollte automatisch verbinden
+
+**Verifikation:**
+- Öffnen Sie GitHub Copilot Chat
+- Fragen Sie: "Was ist das System?" oder "System-Status prüfen"
+- Der AI-Agent sollte über MCP Server Tools zugreifen können
+
+Siehe [mcp-server/INSTALLATION_GUIDE.md](../mcp-server/INSTALLATION_GUIDE.md) für detaillierte VS Code-Konfiguration.
+
+### Schritt 6.5: Claude Desktop Konfiguration (Optional)
+
+Falls Sie Claude Desktop nutzen möchten:
+
+**Windows:**
+```
+%APPDATA%\Claude\claude_desktop_config.json
+```
+
+**macOS:**
+```
+~/Library/Application Support/Claude/claude_desktop_config.json
+```
+
+**Linux:**
+```
+~/.config/Claude/claude_desktop_config.json
+```
+
+**Konfiguration:**
+```json
+{
+  "mcpServers": {
+    "noyrax": {
+      "command": "node",
+      "args": [
+        "D:/path/to/workspace/mcp-server/out/cli/server-cli.js",
+        "${workspaceFolder}"
+      ]
+    }
+  }
+}
+```
+
+**Hinweis:** Verwenden Sie absolute Pfade für Claude Desktop.
+
+Siehe [mcp-server/INSTALLATION_GUIDE.md](../mcp-server/INSTALLATION_GUIDE.md) für detaillierte Claude Desktop-Konfiguration.
 
 ## Workflow für Updates
 
@@ -191,7 +365,55 @@ Nach dem Setup solltest du haben:
    - `dependencies.db` (Z-Dimension)
    - `adrs.db` (W-Dimension)
    - `changes.db` (T-Dimension)
-3. ✅ (Optional) `.semantic-brain/` Ordner mit Vektordatenbank (wenn Embeddings generiert wurden)
+   - `vectors.db` (V-Dimension: Embeddings)
+3. ✅ MCP Server kompiliert (`mcp-server/out/cli/server-cli.js` existiert)
+4. ✅ Cursor/VS Code konfiguriert (`.cursor/mcp-config.json` oder `.vscode/settings.json` existiert)
+
+### System-Status prüfen
+
+**Via MCP Server (wenn konfiguriert):**
+
+In Cursor/VS Code Chat:
+```
+System-Status prüfen
+```
+
+Oder nutzen Sie das Tool direkt:
+```
+workflow/check_status
+```
+
+**Via CLI (Fallback):**
+
+```bash
+# System-Übersicht
+node 5d-database-plugin/out/cli/tool-cli.js . system_explanation
+
+# System-Status (falls verfügbar)
+node mcp-server/out/cli/server-cli.js .  # MCP Server starten
+```
+
+### Erste Nutzung
+
+Nach erfolgreicher Installation können Sie die Tools nutzen:
+
+**In Cursor/VS Code Chat:**
+- "Was ist das System?" → Nutzt `system_explanation` Tool
+- "Wie funktioniert X?" → Nutzt `semantic_discovery` Tool
+- "Welche ADRs gibt es?" → Nutzt `query_adrs` Tool
+- "System-Status prüfen" → Nutzt `workflow/check_status` Tool
+
+**Via CLI (Fallback):**
+```bash
+# System-Übersicht
+node 5d-database-plugin/out/cli/tool-cli.js . bootstrap
+
+# Semantic Search
+node 5d-database-plugin/out/cli/tool-cli.js . semantic_discovery "Wie funktioniert X?" 5
+
+# ADR abfragen (korrekte Syntax)
+node 5d-database-plugin/out/cli/query-cli.js . adrs --number 040
+```
 
 ## Troubleshooting
 
@@ -242,19 +464,28 @@ Nach dem Setup solltest du haben:
 
 ## Nächste Schritte
 
-- **MCP-Server Setup:** Siehe `MCP_SERVER_SETUP.md`
+- **MCP-Server Setup:** Siehe [mcp-server/INSTALLATION_GUIDE.md](../mcp-server/INSTALLATION_GUIDE.md) für vollständige Anleitung
 - **Semantic Search:** Siehe `README.md` - Semantic Brain Features
 - **Architektur:** Siehe `docs/adr/` für Architecture Decision Records
+- **Cursor Rules:** Siehe `.cursor/rules/` für AI-Agent Workflows
 
 ## Zusammenfassung
 
 Der Setup-Workflow ist immer derselbe:
 
 ```
-1. Noyrax installieren → docs/ generieren
-2. 5D Database Plugin installieren → docs/ ingestieren
-3. (Optional) MCP-Server konfigurieren → LLM-Agenten nutzen
+1. Dependencies installieren → npm install
+2. Alle Plugins kompilieren → npm run compile:all
+3. Dokumentation generieren → npm run docs:full .
+4. Datenbanken ingestieren → npm run db:ingest .
+5. Embeddings generieren → npm run db:embedding .
+6. MCP Server kompilieren → npm run mcp:build
+7. Cursor/VS Code konfigurieren → .cursor/mcp-config.json oder .vscode/settings.json
+8. System testen → "System-Status prüfen" in Chat
 ```
 
-**Wichtig:** Beide Plugins sind gekoppelt und müssen zusammen verwendet werden!
+**Wichtig:** 
+- Beide Plugins sind gekoppelt und müssen zusammen verwendet werden!
+- Unified MCP Server orchestriert beide Plugins und bietet zentralen Zugriff
+- Siehe [mcp-server/INSTALLATION_GUIDE.md](../mcp-server/INSTALLATION_GUIDE.md) für vollständige Anleitung
 

package/out/api/adr-api.d.ts

@@ -7,16 +7,29 @@ export declare class AdrApi {
     private dbManager;
     constructor(dbManager: MultiDbManager);
     /**
-     * Gets an ADR by ADR number.
+     * Gets an ADR by ADR number with flexible number normalization.
+     * Supports both "1" and "001" formats.
      */
     getAdrByNumber(adrNumber: string, pluginId: string): Promise<Adr | null>;
+    /**
+     * Normalizes an ADR number to generate possible variants for flexible matching.
+     * Returns an array of number variants in order of preference.
+     */
+    private normalizeAdrNumber;
     /**
      * Gets all ADRs for a plugin.
      */
     getAllAdrs(pluginId: string): Promise<Adr[]>;
     /**
-     * Gets ADRs by file path.
+     * Gets ADRs by file path with flexible path normalization.
+     * Supports various path formats (similar to ModuleApi.getModuleByPath).
      */
     getAdrsByFilePath(filePath: string, pluginId: string): Promise<Adr[]>;
+    /**
+     * Normalizes a file path to generate possible variants for flexible matching.
+     * Returns an array of path variants in order of preference.
+     * (Same logic as ModuleApi.normalizeFilePath)
+     */
+    private normalizeFilePath;
 }
 //# sourceMappingURL=adr-api.d.ts.map

package/out/api/adr-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adr-api.d.ts","sourceRoot":"","sources":["../../src/api/adr-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEpC;;GAEG;AACH,qBAAa,MAAM;IACf,OAAO,CAAC,SAAS,CAAiB;gBAEtB,SAAS,EAAE,cAAc;IAIrC;;OAEG;IACU,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAMrF;;OAEG;IACU,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAMzD;;OAEG;IACU,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;CAKrF"}
+{"version":3,"file":"adr-api.d.ts","sourceRoot":"","sources":["../../src/api/adr-api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEpC;;GAEG;AACH,qBAAa,MAAM;IACf,OAAO,CAAC,SAAS,CAAiB;gBAEtB,SAAS,EAAE,cAAc;IAIrC;;;OAGG;IACU,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAwBrF;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAqC1B;;OAEG;IACU,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAMzD;;;OAGG;IACU,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAwBlF;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;CA8B5B"}

package/out/api/adr-api.js

@@ -10,12 +10,60 @@ class AdrApi {
         this.dbManager = dbManager;
     }
     /**
-     * Gets an ADR by ADR number.
+     * Gets an ADR by ADR number with flexible number normalization.
+     * Supports both "1" and "001" formats.
      */
     async getAdrByNumber(adrNumber, pluginId) {
         const db = await this.dbManager.getDatabase('W');
         const repository = new adr_repository_1.AdrRepository(db);
-        return repository.getByAdrNumber(adrNumber, pluginId);
+        // Try exact match first
+        let adr = await repository.getByAdrNumber(adrNumber, pluginId);
+        if (adr) {
+            return adr;
+        }
+        // Normalize ADR number (try with/without leading zeros)
+        const normalizedNumbers = this.normalizeAdrNumber(adrNumber);
+        // Try each normalized variant
+        for (const normalized of normalizedNumbers) {
+            adr = await repository.getByAdrNumber(normalized, pluginId);
+            if (adr) {
+                return adr;
+            }
+        }
+        return null;
+    }
+    /**
+     * Normalizes an ADR number to generate possible variants for flexible matching.
+     * Returns an array of number variants in order of preference.
+     */
+    normalizeAdrNumber(adrNumber) {
+        const variants = [];
+        // Remove any non-numeric prefix/suffix
+        const numericMatch = adrNumber.match(/(\d+)/);
+        if (!numericMatch) {
+            return [adrNumber]; // Return original if no number found
+        }
+        const numericPart = numericMatch[1];
+        const numValue = parseInt(numericPart, 10);
+        // Original
+        variants.push(adrNumber);
+        // With leading zeros (3 digits: "001", "020", "042")
+        const withLeadingZeros = numValue.toString().padStart(3, '0');
+        if (withLeadingZeros !== numericPart) {
+            variants.push(adrNumber.replace(numericPart, withLeadingZeros));
+        }
+        // Without leading zeros (if original had them)
+        if (numericPart !== numValue.toString()) {
+            variants.push(adrNumber.replace(numericPart, numValue.toString()));
+        }
+        // Just the number (if original had prefix/suffix)
+        if (adrNumber !== numericPart) {
+            variants.push(numericPart);
+            variants.push(withLeadingZeros);
+            variants.push(numValue.toString());
+        }
+        // Remove duplicates and return
+        return Array.from(new Set(variants));
     }
     /**
      * Gets all ADRs for a plugin.
@@ -26,12 +74,58 @@ class AdrApi {
         return repository.getAll(pluginId);
     }
     /**
-     * Gets ADRs by file path.
+     * Gets ADRs by file path with flexible path normalization.
+     * Supports various path formats (similar to ModuleApi.getModuleByPath).
      */
     async getAdrsByFilePath(filePath, pluginId) {
         const db = await this.dbManager.getDatabase('W');
         const repository = new adr_repository_1.AdrRepository(db);
-        return repository.findByFilePath(filePath, pluginId);
+        // Try exact match first
+        let adrs = await repository.findByFilePath(filePath, pluginId);
+        if (adrs.length > 0) {
+            return adrs;
+        }
+        // Generate normalized path variants
+        const pathVariants = this.normalizeFilePath(filePath);
+        // Try each variant
+        for (const variant of pathVariants) {
+            adrs = await repository.findByFilePath(variant, pluginId);
+            if (adrs.length > 0) {
+                return adrs;
+            }
+        }
+        return [];
+    }
+    /**
+     * Normalizes a file path to generate possible variants for flexible matching.
+     * Returns an array of path variants in order of preference.
+     * (Same logic as ModuleApi.normalizeFilePath)
+     */
+    normalizeFilePath(filePath) {
+        const variants = [];
+        // Normalize separators to forward slashes
+        let normalized = filePath.replace(/\\/g, '/');
+        variants.push(normalized);
+        // Remove leading slashes
+        const withoutLeadingSlash = normalized.replace(/^\/+/, '');
+        if (withoutLeadingSlash !== normalized) {
+            variants.push(withoutLeadingSlash);
+        }
+        // Remove common plugin prefixes (e.g., "5d-database-plugin/")
+        const pluginPrefixes = ['5d-database-plugin/', 'documentation-system-plugin/', 'mcp-server/'];
+        for (const prefix of pluginPrefixes) {
+            if (normalized.startsWith(prefix)) {
+                const withoutPrefix = normalized.substring(prefix.length);
+                variants.push(withoutPrefix);
+            }
+            // Also try without leading slash
+            if (withoutLeadingSlash.startsWith(prefix)) {
+                const withoutPrefix = withoutLeadingSlash.substring(prefix.length);
+                variants.push(withoutPrefix);
+            }
+        }
+        // Remove duplicates and return
+        return Array.from(new Set(variants));
     }
 }
 exports.AdrApi = AdrApi;

package/out/api/adr-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"adr-api.js","sourceRoot":"","sources":["../../src/api/adr-api.ts"],"names":[],"mappings":";;;AACA,mEAA+D;AAG/D;;GAEG;AACH,MAAa,MAAM;IAGf,YAAY,SAAyB;QACjC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC/B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,cAAc,CAAC,SAAiB,EAAE,QAAgB;QAC3D,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,IAAI,8BAAa,CAAC,EAAE,CAAC,CAAC;QACzC,OAAO,UAAU,CAAC,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,UAAU,CAAC,QAAgB;QACpC,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,IAAI,8BAAa,CAAC,EAAE,CAAC,CAAC;QACzC,OAAO,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,iBAAiB,CAAC,QAAgB,EAAE,QAAgB;QAC7D,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,IAAI,8BAAa,CAAC,EAAE,CAAC,CAAC;QACzC,OAAO,UAAU,CAAC,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACzD,CAAC;CACJ;AAjCD,wBAiCC"}
+{"version":3,"file":"adr-api.js","sourceRoot":"","sources":["../../src/api/adr-api.ts"],"names":[],"mappings":";;;AAEA,mEAA+D;AAG/D;;GAEG;AACH,MAAa,MAAM;IAGf,YAAY,SAAyB;QACjC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,cAAc,CAAC,SAAiB,EAAE,QAAgB;QAC3D,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,IAAI,8BAAa,CAAC,EAAE,CAAC,CAAC;QAEzC,wBAAwB;QACxB,IAAI,GAAG,GAAG,MAAM,UAAU,CAAC,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC/D,IAAI,GAAG,EAAE,CAAC;YACN,OAAO,GAAG,CAAC;QACf,CAAC;QAED,wDAAwD;QACxD,MAAM,iBAAiB,GAAG,IAAI,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;QAE7D,8BAA8B;QAC9B,KAAK,MAAM,UAAU,IAAI,iBAAiB,EAAE,CAAC;YACzC,GAAG,GAAG,MAAM,UAAU,CAAC,cAAc,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YAC5D,IAAI,GAAG,EAAE,CAAC;gBACN,OAAO,GAAG,CAAC;YACf,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;OAGG;IACK,kBAAkB,CAAC,SAAiB;QACxC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,uCAAuC;QACvC,MAAM,YAAY,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,CAAC,YAAY,EAAE,CAAC;YAChB,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,qCAAqC;QAC7D,CAAC;QAED,MAAM,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAE3C,WAAW;QACX,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAEzB,qDAAqD;QACrD,MAAM,gBAAgB,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC9D,IAAI,gBAAgB,KAAK,WAAW,EAAE,CAAC;YACnC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC,CAAC;QACpE,CAAC;QAED,+CAA+C;QAC/C,IAAI,WAAW,KAAK,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC;YACtC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QACvE,CAAC;QAED,kDAAkD;QAClD,IAAI,SAAS,KAAK,WAAW,EAAE,CAAC;YAC5B,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC3B,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YAChC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;QACvC,CAAC;QAED,+BAA+B;QAC/B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,UAAU,CAAC,QAAgB;QACpC,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,IAAI,8BAAa,CAAC,EAAE,CAAC,CAAC;QACzC,OAAO,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,iBAAiB,CAAC,QAAgB,EAAE,QAAgB;QAC7D,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,IAAI,8BAAa,CAAC,EAAE,CAAC,CAAC;QAEzC,wBAAwB;QACxB,IAAI,IAAI,GAAG,MAAM,UAAU,CAAC,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC/D,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,oCAAoC;QACpC,MAAM,YAAY,GAAG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAEtD,mBAAmB;QACnB,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;YACjC,IAAI,GAAG,MAAM,UAAU,CAAC,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAC1D,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClB,OAAO,IAAI,CAAC;YAChB,CAAC;QACL,CAAC;QAED,OAAO,EAAE,CAAC;IACd,CAAC;IAED;;;;OAIG;IACK,iBAAiB,CAAC,QAAgB;QACtC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,0CAA0C;QAC1C,IAAI,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC9C,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAE1B,yBAAyB;QACzB,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC3D,IAAI,mBAAmB,KAAK,UAAU,EAAE,CAAC;YACrC,QAAQ,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACvC,CAAC;QAED,8DAA8D;QAC9D,MAAM,cAAc,GAAG,CAAC,qBAAqB,EAAE,8BAA8B,EAAE,aAAa,CAAC,CAAC;QAC9F,KAAK,MAAM,MAAM,IAAI,cAAc,EAAE,CAAC;YAClC,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAChC,MAAM,aAAa,GAAG,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC1D,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACjC,CAAC;YACD,iCAAiC;YACjC,IAAI,mBAAmB,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzC,MAAM,aAAa,GAAG,mBAAmB,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACnE,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACjC,CAAC;QACL,CAAC;QAED,+BAA+B;QAC/B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IACzC,CAAC;CACJ;AApJD,wBAoJC"}

package/out/api/index.d.ts

@@ -15,6 +15,7 @@ export { BootstrapApi } from './bootstrap-api';
 export { SelfExplanationApi } from './self-explanation-api';
 export { LearningPathApi } from './learning-path-api';
 export { VectorApi } from './vector-api';
+export { IngestionApi } from './ingestion-api';
 export { ContextBuilder } from './context-builder';
 export { MultiDbManager, Dimension } from '../core/multi-db-manager';
 export { IdMapper } from '../core/id-mapper';

package/out/api/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAG9D,YAAY,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAG9D,YAAY,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC"}

package/out/api/index.js

@@ -5,7 +5,7 @@
  * This file exports all APIs that can be used from npm package installations.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DocsPathResolver = exports.IdMapper = exports.MultiDbManager = exports.ContextBuilder = exports.VectorApi = exports.LearningPathApi = exports.SelfExplanationApi = exports.BootstrapApi = exports.SearchApi = exports.SemanticSearchApi = exports.CrossDimensionApi = exports.ChangeApi = exports.AdrApi = exports.DependencyApi = exports.SymbolApi = exports.ModuleApi = void 0;
+exports.DocsPathResolver = exports.IdMapper = exports.MultiDbManager = exports.ContextBuilder = exports.IngestionApi = exports.VectorApi = exports.LearningPathApi = exports.SelfExplanationApi = exports.BootstrapApi = exports.SearchApi = exports.SemanticSearchApi = exports.CrossDimensionApi = exports.ChangeApi = exports.AdrApi = exports.DependencyApi = exports.SymbolApi = exports.ModuleApi = void 0;
 var module_api_1 = require("./module-api");
 Object.defineProperty(exports, "ModuleApi", { enumerable: true, get: function () { return module_api_1.ModuleApi; } });
 var symbol_api_1 = require("./symbol-api");
@@ -30,6 +30,8 @@ var learning_path_api_1 = require("./learning-path-api");
 Object.defineProperty(exports, "LearningPathApi", { enumerable: true, get: function () { return learning_path_api_1.LearningPathApi; } });
 var vector_api_1 = require("./vector-api");
 Object.defineProperty(exports, "VectorApi", { enumerable: true, get: function () { return vector_api_1.VectorApi; } });
+var ingestion_api_1 = require("./ingestion-api");
+Object.defineProperty(exports, "IngestionApi", { enumerable: true, get: function () { return ingestion_api_1.IngestionApi; } });
 var context_builder_1 = require("./context-builder");
 Object.defineProperty(exports, "ContextBuilder", { enumerable: true, get: function () { return context_builder_1.ContextBuilder; } });
 // Core classes needed for API initialization

package/out/api/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,2CAAyC;AAAhC,uGAAA,SAAS,OAAA;AAClB,2CAAyC;AAAhC,uGAAA,SAAS,OAAA;AAClB,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AACtB,qCAAmC;AAA1B,iGAAA,MAAM,OAAA;AACf,2CAAyC;AAAhC,uGAAA,SAAS,OAAA;AAClB,6DAA0D;AAAjD,wHAAA,iBAAiB,OAAA;AAC1B,6DAA0D;AAAjD,wHAAA,iBAAiB,OAAA;AAC1B,2CAAyC;AAAhC,uGAAA,SAAS,OAAA;AAClB,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AACrB,+DAA4D;AAAnD,0HAAA,kBAAkB,OAAA;AAC3B,yDAAsD;AAA7C,oHAAA,eAAe,OAAA;AACxB,2CAAyC;AAAhC,uGAAA,SAAS,OAAA;AAClB,qDAAmD;AAA1C,iHAAA,cAAc,OAAA;AAEvB,6CAA6C;AAC7C,6DAAqE;AAA5D,kHAAA,cAAc,OAAA;AACvB,+CAA6C;AAApC,qGAAA,QAAQ,OAAA;AACjB,iEAA8D;AAArD,sHAAA,gBAAgB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,2CAAyC;AAAhC,uGAAA,SAAS,OAAA;AAClB,2CAAyC;AAAhC,uGAAA,SAAS,OAAA;AAClB,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AACtB,qCAAmC;AAA1B,iGAAA,MAAM,OAAA;AACf,2CAAyC;AAAhC,uGAAA,SAAS,OAAA;AAClB,6DAA0D;AAAjD,wHAAA,iBAAiB,OAAA;AAC1B,6DAA0D;AAAjD,wHAAA,iBAAiB,OAAA;AAC1B,2CAAyC;AAAhC,uGAAA,SAAS,OAAA;AAClB,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AACrB,+DAA4D;AAAnD,0HAAA,kBAAkB,OAAA;AAC3B,yDAAsD;AAA7C,oHAAA,eAAe,OAAA;AACxB,2CAAyC;AAAhC,uGAAA,SAAS,OAAA;AAClB,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AACrB,qDAAmD;AAA1C,iHAAA,cAAc,OAAA;AAEvB,6CAA6C;AAC7C,6DAAqE;AAA5D,kHAAA,cAAc,OAAA;AACvB,+CAA6C;AAApC,qGAAA,QAAQ,OAAA;AACjB,iEAA8D;AAArD,sHAAA,gBAAgB,OAAA"}