@noyrax/5d-database-plugin 0.1.0

package/QUICK_START.md

@@ -0,0 +1,316 @@
+# Quick Start - 5D Database Plugin
+
+## Systemkontext
+
+Das 5D Database Plugin ist Teil eines **5-dimensionalen Navigationsraums**:
+
+| Dimension | Artefakt | Funktion |
+|-----------|----------|----------|
+| **X (Modules)** | `docs/modules/*.md` | API-Dokumentation pro Datei |
+| **Y (Symbols)** | `docs/index/symbols.jsonl` | Symbole mit Dependencies |
+| **Z (Dependencies)** | `docs/system/DEPENDENCY_GRAPH.md` | Modul-Abhängigkeiten |
+| **W (ADRs)** | `docs/adr/*.md` | Architektur-Entscheidungen |
+| **T (Changes)** | `docs/system/CHANGE_REPORT.md` | Änderungen über die Zeit |
+
+Die Extension findet `docs/` automatisch in Workspace-Folders und Parent-Directories (siehe ADR-010).
+
+## Setup (einmalig)
+
+### 1. Dependencies installieren
+```bash
+cd 5d-database-plugin
+npm install
+```
+
+### 2. Extension kompilieren
+```bash
+npm run compile
+```
+
+**Wichtig:** Nach jeder Code-Änderung muss neu kompiliert werden:
+```bash
+npm run compile
+```
+
+Oder im Watch-Mode (kompiliert automatisch bei Änderungen):
+```bash
+npm run watch
+```
+
+## Produktives Testen (empfohlen)
+
+**Warum produktives Testen?**
+- Echte Daten aus `docs/` werden verwendet
+- Echte SQLite-Datenbanken werden erstellt
+- Keine komplizierte Debug-Konfiguration nötig
+- Extension funktioniert wie im produktiven Einsatz
+
+### Schritt 1: Extension lokal installieren
+
+#### Option A: Via VS Code UI (empfohlen)
+
+1. **Extension kompilieren:**
+   ```bash
+   cd 5d-database-plugin
+   npm run compile
+   ```
+
+2. **Extension installieren:**
+   - Öffne VS Code
+   - `Ctrl+Shift+X` → Extensions Panel
+   - Klicke auf "..." (mehr Optionen) → "Install from VSIX..."
+   - Wähle den `5d-database-plugin` Ordner (oder eine `.vsix` Datei, falls vorhanden)
+
+3. **VS Code neu laden:**
+   - `Ctrl+Shift+P` → "Developer: Reload Window"
+
+#### Option B: Via Command Line
+
+1. **Extension kompilieren:**
+   ```bash
+   cd 5d-database-plugin
+   npm run compile
+   ```
+
+2. **Extension installieren:**
+   ```bash
+   code --install-extension .
+   ```
+   (Führe den Befehl im `5d-database-plugin` Ordner aus)
+
+3. **VS Code neu laden:**
+   - `Ctrl+Shift+P` → "Developer: Reload Window"
+
+### Schritt 2: VS Code im Root-Ordner öffnen
+
+**Wichtig:** VS Code muss im Root-Ordner geöffnet sein, wo `docs/` liegt:
+
+```bash
+# Im Root-Ordner öffnen
+cd "D:\Datenbank für Noyrax"
+code .
+```
+
+Oder öffne VS Code manuell im Ordner `Datenbank für Noyrax/` (wo `docs/` liegt).
+
+### Schritt 3: Extension testen
+
+1. **Extension aktiviert sich automatisch:**
+   - Extension aktiviert sich beim Start (`onStartupFinished`)
+   - Du solltest sehen: "5D Database Plugin activated"
+   - Status Bar zeigt: `$(database) 5D DB`
+
+2. **Output-Channel prüfen:**
+   - `Ctrl+Shift+P` → "Output: Show Output Channel"
+   - Wähle "5D Database Plugin"
+   - Prüfe die Logs:
+     - "Using workspace root: ..."
+     - "Found docs/ directory: ..." (oder Warnung, wenn nicht gefunden)
+     - "Database migrations completed"
+     - "=== 5D Database Plugin Activation Completed Successfully ==="
+
+3. **Commands testen:**
+   - `Ctrl+Shift+P` → "Ingest Documentation" (Command: `5d-database.ingest`)
+   - Oder: Klicke auf Status Bar Icon (`$(database) 5D DB`)
+
+4. **Database Explorer prüfen:**
+   - Sidebar → "5D Database Explorer"
+   - Sollte alle 5 Dimensionen anzeigen:
+     - X: Modules
+     - Y: Symbols
+     - Z: Dependencies
+     - W: ADRs
+     - T: Changes
+
+### Was passiert bei der Aktivierung?
+
+1. **Extension wird geladen:**
+   - VS Code lädt `out/extension.js`
+   - `activate()` Funktion wird aufgerufen
+
+2. **Workspace wird erkannt:**
+   - Extension prüft Workspace-Folders
+   - Falls kein Workspace: Fallback auf Storage-Path
+   - Logs zeigen: "Using workspace root: ..."
+
+3. **docs/ wird gesucht:**
+   - Extension sucht in Workspace-Folders (alphabetisch sortiert)
+   - Sucht in Parent-Directories (bis zu 5 Ebenen)
+   - Zeigt Warnung, wenn nicht gefunden
+   - Logs zeigen: "Found docs/ directory: ..." oder "WARNING: docs/ directory not found"
+
+4. **Datenbanken werden initialisiert:**
+   - Migrationen werden ausgeführt
+   - 5 SQLite-Datenbanken werden erstellt (falls nicht vorhanden) in `.database-plugin/`:
+     - `modules.db` (X-Dimension)
+     - `symbols.db` (Y-Dimension)
+     - `dependencies.db` (Z-Dimension)
+     - `adrs.db` (W-Dimension)
+     - `changes.db` (T-Dimension)
+   - Logs zeigen: "Database migrations completed"
+
+5. **UI wird registriert:**
+   - Status Bar Provider
+   - Database Explorer Provider
+   - Commands werden registriert
+   - Logs zeigen: "Registering UI components..." und "Registering commands..."
+
+6. **Aktivierung abgeschlossen:**
+   - Info-Message: "5D Database Plugin activated"
+   - Output-Channel zeigt: "=== 5D Database Plugin Activation Completed Successfully ==="
+
+## CLI-Tool (Alternative)
+
+Das CLI-Tool kann **ohne VS Code Extension** verwendet werden, z.B. für CI/CD oder Automatisierung.
+
+### Verwendung
+
+```bash
+# Inkrementelle Ingestion (Standard)
+node out/cli/ingest-cli.js "D:\Datenbank für Noyrax"
+
+# Vollständige Ingestion (alle Daten neu laden)
+node out/cli/ingest-cli.js "D:\Datenbank für Noyrax" --full
+```
+
+### Was macht das CLI-Tool?
+
+1. **Datenbanken initialisieren:**
+   - Führt Migrationen aus
+   - Erstellt 5 SQLite-Datenbanken in `.database-plugin/`
+
+2. **Dokumentation ingestieren:**
+   - Liest alle 5 Dimensionen aus `docs/`:
+     - X: `docs/modules/*.md`
+     - Y: `docs/index/symbols.jsonl`
+     - Z: `docs/system/DEPENDENCY_GRAPH.md`
+     - W: `docs/adr/*.md`
+     - T: `docs/system/CHANGE_REPORT.md`
+
+3. **Hash-basierte Änderungserkennung:**
+   - Inkrementeller Modus: Nur geänderte Dateien werden neu ingestiert
+   - Vollständiger Modus: Alle Dateien werden neu ingestiert
+
+### Vorteile
+
+- ✅ Funktioniert ohne VS Code
+- ✅ Nützlich für CI/CD-Pipelines
+- ✅ Automatisierung möglich
+- ✅ Kann in Scripts eingebunden werden
+
+## Debug-Modus (optional, nur für Extension-Entwicklung)
+
+**Hinweis:** Debug-Modus ist nur für die Entwicklung der Extension selbst gedacht. Für produktives Testen verwende die lokale Installation (siehe oben).
+
+### Voraussetzungen
+
+- VS Code muss im Extension-Ordner (`5d-database-plugin/`) geöffnet sein
+- Debug-Konfiguration (`5d-database-plugin/.vscode/launch.json`) muss vorhanden sein
+
+### Verwendung
+
+1. **VS Code im Extension-Ordner öffnen:**
+   ```bash
+   cd 5d-database-plugin
+   code .
+   ```
+
+2. **Extension starten:**
+   - Drücke `F5` oder öffne Debug-Panel (`Ctrl+Shift+D`)
+   - Wähle die Konfiguration **"Run Extension"**
+   - Die Extension wird automatisch kompiliert (preLaunchTask)
+   - Extension Development Host öffnet sich
+
+3. **Im Extension Development Host:**
+   - Öffne den Root-Ordner manuell: `File` → `Open Folder...` → `D:\Datenbank für Noyrax`
+   - Extension aktiviert sich automatisch
+   - Teste die Extension
+
+**Wichtig:** Der Debug-Modus ist nicht zuverlässig für produktives Testen, da der Root-Ordner nicht automatisch geöffnet wird. Verwende stattdessen die lokale Installation.
+
+## Troubleshooting
+
+### Extension aktiviert sich nicht
+
+1. **Prüfe Kompilierung:**
+   - Existiert `out/extension.js`?
+   - Führe `npm run compile` aus und prüfe auf Fehler
+
+2. **Prüfe Output-Channel:**
+   - `Ctrl+Shift+P` → "Output: Show Output Channel" → "5D Database Plugin"
+   - Suche nach Fehlermeldungen
+   - Detaillierte Logs zeigen jeden Schritt der Aktivierung
+
+3. **Prüfe Developer Tools:**
+   - `Help` → `Toggle Developer Tools`
+   - Console-Tab → Suche nach Fehlern
+
+4. **Prüfe Extension-Status:**
+   - `Ctrl+Shift+P` → "Extensions: Show Installed Extensions"
+   - Suche nach "5D Database Plugin"
+   - Prüfe ob Extension aktiviert ist
+
+### Commands sind nicht verfügbar
+
+1. **Extension wurde aktiviert?**
+   - Prüfe Output-Channel "5D Database Plugin"
+   - Sollte "Activation Completed Successfully" zeigen
+
+2. **Workspace-Ordner korrekt?**
+   - VS Code muss im Root-Ordner geöffnet sein (wo `docs/` liegt)
+   - Extension sucht automatisch nach `docs/` in Workspace und Parent-Directories
+
+3. **Extension neu laden:**
+   - `Ctrl+Shift+P` → "Developer: Reload Window"
+
+### docs/ wird nicht gefunden
+
+1. **Workspace-Ordner prüfen:**
+   - VS Code muss im Root-Ordner geöffnet sein
+   - `docs/` sollte im Root-Ordner liegen
+
+2. **Output-Channel prüfen:**
+   - Extension zeigt Warnung, wenn `docs/` nicht gefunden wird
+   - Ingestion wird übersprungen, aber Extension funktioniert trotzdem
+   - Logs zeigen: "WARNING: docs/ directory not found in workspace folders or parent directories."
+
+3. **Manuell prüfen:**
+   - Prüfe ob `docs/` Verzeichnis existiert
+   - Extension sucht in Workspace-Folders und bis zu 5 Parent-Directories
+   - Prüfe die Logs im Output-Channel für Details
+
+### Datenbank-Fehler
+
+1. **Prüfe Datenbank-Verzeichnis:**
+   - Datenbanken werden in `.database-plugin/` erstellt
+   - Prüfe ob Verzeichnis existiert und beschreibbar ist
+
+2. **Prüfe Migrationen:**
+   - Output-Channel zeigt: "Database migrations completed"
+   - Falls Fehler: Prüfe Logs für Details
+
+3. **Datenbanken zurücksetzen:**
+   - Lösche `.database-plugin/` Verzeichnis
+   - Extension erstellt Datenbanken neu beim nächsten Start
+
+## Workflow für Entwicklung
+
+1. **Code ändern** in `src/`
+2. **Kompilieren:** `npm run compile` (oder `npm run watch`)
+3. **Extension neu laden:** `Ctrl+Shift+P` → "Developer: Reload Window"
+4. **Extension testen** im Root-Ordner (wo `docs/` liegt)
+
+## Wichtige Dateien
+
+- `src/extension.ts` - Extension Entry Point
+- `package.json` - Extension Manifest (Commands, Views)
+- `out/extension.js` - Kompilierte Extension (muss existieren!)
+- `src/cli/ingest-cli.ts` - CLI-Tool für Ingestion
+- `src/core/docs-path-resolver.ts` - Automatische docs/ Erkennung
+- `tsconfig.json` - TypeScript Konfiguration
+
+## Verwandte Dokumentation
+
+- **ADR-008**: Phase 1.8 - VS Code Extension & UI
+- **ADR-010**: Multi-Level Docs Path Resolution
+- **README.md**: Vollständige Dokumentation der Extension

package/README.md

@@ -0,0 +1,240 @@
+# 5D Database Plugin + Semantic Brain
+
+**Semantic Brain für LLM-Agenten** - Eine intelligente Wissensbasis, die es AI-Agenten ermöglicht, Code-Systeme zu verstehen, **OHNE dass sie diese vorher kennen müssen**.
+
+VS Code Extension für 5-dimensionale Datenbank-Speicherung der Dokumentations-System-Daten mit semantischer Suche.
+
+## ⚠️ WICHTIG: System-Kopplung
+
+**Das Documentation System Plugin (Noyrax) und das 5D Database Plugin MÜSSEN gekoppelt werden - sie funktionieren nur gemeinsam!**
+
+```
+Noyrax (Documentation System) → generiert docs/ → 5D Database Plugin → SQLite-DBs → MCP-Server → LLM-Agenten
+```
+
+- **Noyrax** generiert die `docs/` Ordnerstruktur mit allen 5 Dimensionen
+- **5D Database Plugin** liest `docs/` und speichert die Daten in SQLite-Datenbanken
+- **MCP-Server** ermöglicht LLM-Agenten-Zugriff auf die Datenbanken
+
+Siehe `SETUP_NEW_PROJECT.md` für vollständigen Setup-Workflow.
+
+## Übersicht
+
+Das 5D Database Plugin speichert die 5 Dimensionen des Documentation System Plugins in separaten SQLite-Datenbanken:
+
+- **X-Dimension (Modules)**: Modul-Dokumentation aus `docs/modules/*.md`
+- **Y-Dimension (Symbols)**: Symbol-Index aus `docs/index/symbols.jsonl`
+- **Z-Dimension (Dependencies)**: Dependency-Graph aus `docs/system/DEPENDENCY_GRAPH.md`
+- **W-Dimension (ADRs)**: Architecture Decision Records aus `docs/adr/*.md`
+- **T-Dimension (Changes)**: Change Reports aus `docs/system/CHANGE_REPORT.md`
+
+## Features
+
+- **5 separate SQLite-Datenbanken** - Eine pro Dimension für optimale Performance
+- **Hash-basierte Änderungserkennung** - Inkrementelle Updates nur bei Änderungen
+- **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
+
+## Installation
+
+⚠️ **Voraussetzung: Documentation System Plugin (Noyrax) muss installiert sein und `docs/` generiert haben!**
+
+Siehe `SETUP_NEW_PROJECT.md` für vollständige Anleitung mit beiden Plugins.
+
+### Schnellstart
+
+1. **Documentation System Plugin (Noyrax) installieren** und `docs/` generieren
+2. **5D Database Plugin installieren:**
+   ```bash
+   code --install-extension 5d-database-plugin-0.1.0.vsix
+   ```
+3. **Workspace öffnen** (muss `docs/` enthalten)
+4. **Extension aktiviert sich automatisch** beim Start
+5. **Ingestion ausführen:** `Ctrl+Shift+P` → "Ingest Documentation"
+
+## Verwendung
+
+### Ingestion
+
+Die Dokumentation wird automatisch beim ersten Start oder manuell via Command ingestiert:
+
+- **Command**: `5d-database.ingest` - Ingestiert alle Dimensionen
+- **CLI**: `node out/cli/ingest-cli.js <workspace-root> [--full]`
+- **npm**: `noyrax-5d-database ingest <workspace-root> [--full]`
+
+### CLI-Tools für direkten Zugriff
+
+Für AI-Agenten und Entwickler stehen CLI-Tools für direkten Datenbank-Zugriff zur Verfügung:
+
+- **Ingest-CLI**: `noyrax-5d-database ingest` - Vollständige Ingestion (5D + V-Dimension)
+- **Embedding-CLI**: `noyrax-5d-database-embedding` - Embedding-Pipeline manuell ausführen (nur V-Dimension)
+- **Query-CLI**: `noyrax-5d-database-query` - Datenbank-Queries (Modules, Symbols, Dependencies, ADRs, Changes)
+- **Tool-CLI**: `noyrax-5d-database-tool` - MCP-Tools direkt nutzen (bootstrap, semantic_discovery, system_explanation, learning_path, cross_analysis, gap_analysis, architecture_mining)
+- **Search-CLI**: `noyrax-5d-database-search` - Semantic Search über V-Dimension
+- **MCP-Server**: `noyrax-5d-database-mcp` - MCP-Server für externe LLM-Agenten
+
+**Hinweis:** Die Embedding-Pipeline wird automatisch bei der Ingestion ausgeführt, kann aber auch manuell via `noyrax-5d-database-embedding` ausgeführt werden (z.B. wenn ChromaDB nachträglich gestartet wurde).
+
+**Gap Analysis Tool:**
+
+Das `gap_analysis` Tool identifiziert systematisch Dokumentationslücken:
+
+```bash
+# Finde Module mit vielen Dependencies aber ohne/wenigen ADRs
+noyrax-5d-database-tool <workspace-root> gap_analysis
+
+# Mit Parametern
+noyrax-5d-database-tool <workspace-root> gap_analysis --min-deps 5 --limit 20
+```
+
+Das Tool analysiert alle Module, berechnet Gap-Scores basierend auf Dependency-Count und ADR-Count, und gibt priorisierte Empfehlungen zurück. Siehe `docs/adr/034-gap-analysis-tool.md` für Details.
+
+**Architecture Mining Tool:**
+
+Das `architecture_mining` Tool leitet rückwirkend Architektur-Entscheidungen aus dem Code ab:
+
+```bash
+# Analysiere gesamtes System für Architektur-Patterns
+noyrax-5d-database-tool <workspace-root> architecture_mining
+
+# Analysiere spezifische Datei
+noyrax-5d-database-tool <workspace-root> architecture_mining <filePath>
+```
+
+Das Tool nutzt die **5D-Datenbanken (Semantic Brain)** - nicht den Code direkt:
+- **X-Dimension (Modules)**: Modul-Pfade, Dateinamen, Struktur
+- **Y-Dimension (Symbols)**: Symbol-Namen, Klassen-Namen
+- **Z-Dimension (Dependencies)**: Dependency-Graph
+- **W-Dimension (ADRs)**: Bestehende ADRs zum Vergleich
+
+Es erkennt Patterns wie Repository Pattern, API Layer, Builder Pattern, Factory Pattern, Service Layer und Layered Architecture. Siehe `docs/adr/035-architecture-mining-tool.md` für Details.
+
+Siehe `MCP_SERVER_SETUP.md` für detaillierte Anleitung.
+
+### MCP-Server (für LLM-Agenten)
+
+Der MCP-Server bietet Zugriff auf alle Dimensionen via Model Context Protocol:
+
+- **Resources**: `db://modules/{pluginId}`, `db://symbols/{pluginId}`, etc.
+- **Tools**: 
+  - `bootstrap` - First-Contact für Agenten ohne Vorwissen
+  - `semantic_discovery` - Semantic Search in natürlicher Sprache
+  - `system_explanation` - System-Übersicht, Entry Points, Architecture ADRs
+  - `learning_path` - Geführte Lernpfade
+  - `query_modules`, `query_symbols`, `query_dependencies`, `cross_analysis`
+  - `gap_analysis` - Systematische Dokumentationslücken-Identifikation
+  - `architecture_mining` - Rückwirkende Architektur-Entscheidungs-Erkennung aus Code
+
+Siehe `MCP_SERVER_SETUP.md` für detaillierte Setup-Anleitung für LLM-Agenten.
+
+### Database Explorer
+
+Der Database Explorer zeigt alle 5 Dimensionen in der VS Code Sidebar:
+- X: Modules
+- Y: Symbols
+- Z: Dependencies
+- W: ADRs
+- T: Changes
+
+## Architektur
+
+### Datenbank-Schema
+
+Jede Dimension hat ihre eigene SQLite-Datenbank:
+- `{workspace}/.database-plugin/modules.db` - X-Dimension
+- `{workspace}/.database-plugin/symbols.db` - Y-Dimension
+- `{workspace}/.database-plugin/dependencies.db` - Z-Dimension
+- `{workspace}/.database-plugin/adrs.db` - W-Dimension
+- `{workspace}/.database-plugin/changes.db` - T-Dimension
+- `{workspace}/.database-plugin/vectors.db` - V-Dimension (Embeddings für Semantic Search)
+
+### ID-Strategie
+
+- **Internal IDs**: UUID v4 für Primärschlüssel
+- **External IDs**: Fachliche IDs (symbol_id, adr_number, etc.)
+- **ID-Mapping**: Tabellen für External-ID → Internal-ID Übersetzung
+
+### Cross-Dimension-Referenzen
+
+- Symbol-ID → Modul-ID Auflösung
+- ADR → File-Path Verknüpfungen
+- Dependency → Symbol Evidence Links
+
+## Entwicklung
+
+### Build
+
+```bash
+npm install
+npm run compile
+```
+
+### Tests
+
+```bash
+npm test
+npm run test:coverage
+```
+
+### Projektstruktur
+
+```
+5d-database-plugin/
+├── src/
+│   ├── api/              # API-Layer pro Dimension
+│   ├── core/             # Multi-DB-Manager, Migration, ID-Mapper
+│   ├── ingestors/        # Ingestion-Module pro Dimension
+│   ├── models/           # TypeScript-Modelle
+│   ├── repositories/     # Repository-Layer pro Dimension
+│   ├── services/         # Cross-Dimension-Services
+│   ├── validators/       # Konsistenz- und Integritäts-Validierung
+│   ├── mcp/              # MCP-Server Integration
+│   ├── ui/               # VS Code UI-Komponenten
+│   └── extension.ts      # Extension Entry Point
+├── schemas/sqlite/       # SQL-Schema-Migrationen
+└── __tests__/            # Tests
+```
+
+## Phase 2: Semantic Brain - ✅ IMPLEMENTIERT
+
+Das Semantic Brain ist vollständig implementiert und bietet:
+
+- ✅ **V-Dimension** - Vektordatenbank für Embeddings
+- ✅ **Embedding System** - OpenAI-Integration für Embedding-Generierung
+- ✅ **Semantic Search API** - Vector Similarity Search über alle Dimensionen
+- ✅ **Importance Scoring** - PageRank und Betweenness Centrality
+- ✅ **Navigation Metadata** - Entry Points und Clusters
+- ✅ **Self-Understanding** - Bootstrap API, Self-Explanation API, Learning Paths
+- ✅ **Deterministic Context Builder** - Strukturierter Kontext ohne KI-Generierung
+- ✅ **MCP-Server Integration** - Vollständige Integration für LLM-Agenten
+
+### Vektordatenbank
+
+- **SQLite VSS** für macOS/Linux (native Extension)
+- **ChromaDB** für Windows (HTTP-Server)
+- **Platform-Detection** - Automatische Auswahl der besten Lösung
+- **Graceful Degradation** - Fallback auf Cosine Similarity wenn keine verfügbar
+
+Siehe `CHROMADB_SETUP.md` für ChromaDB-Konfiguration.
+
+## Kernfunktionalität für LLM-Agenten
+
+1. **Semantic Discovery**: Natürliche Sprache → relevante Code-Entitäten finden
+2. **Deterministic Navigation**: Strukturierter Kontext aus Fakten (keine KI-Halluzinationen)
+3. **Self-Understanding**: System erklärt sich selbst (Bootstrap API, Self-Explanation API)
+4. **Learning Paths**: Geführte Pfade zum Erlernen des Systems
+5. **Cross-Dimension Intelligence**: Verknüpfungen zwischen allen Dimensionen
+
+## Dokumentation
+
+- **`SETUP_NEW_PROJECT.md`** - Vollständiger Setup-Workflow für neue Projekte (gekoppelt mit Noyrax)
+- **`MCP_SERVER_SETUP.md`** - MCP-Server-Konfiguration für LLM-Agenten (Claude Desktop, etc.)
+- **`QUICK_START.md`** - Schnellstart-Anleitung für Entwickler
+- **`CHROMADB_SETUP.md`** - ChromaDB-Installation und -Konfiguration (Windows)
+- **`docs/adr/`** - Architecture Decision Records (32 ADRs dokumentieren alle Entscheidungen)
+
+## License
+
+MIT
+