@noyrax/documentation-system-plugin 1.0.4-beta.3 → 1.0.4-beta.5

package/docs/system/NPX_LOCAL_USAGE.md

@@ -1,66 +0,0 @@
-# NPX lokale Version verwenden
-
-**Problem:** NPX verwendet eine alte Version aus dem npm-Cache (z. B. 1.1.0), obwohl lokal bereits eine neuere Version (z. B. 1.2.0) verfügbar ist.
-
-## Lösung: Lokale Version direkt verwenden
-
-Bis das Package auf npm veröffentlicht wurde, kann die lokale Version direkt verwendet werden:
-
-### Windows (PowerShell)
-
-```powershell
-# Update-Rules mit lokaler Version
-node D:\Extensions\documentation-system-plugin\packages\doc-system-agent\dist\cli\index.js update-rules --verbose
-
-# Info mit lokaler Version
-node D:\Extensions\documentation-system-plugin\packages\doc-system-agent\dist\cli\index.js info
-
-# Init mit lokaler Version
-node D:\Extensions\documentation-system-plugin\packages\doc-system-agent\dist\cli\index.js init --verbose
-```
-
-### Alternative: npm link (für Entwicklung)
-
-```bash
-# Im documentation-system-plugin Verzeichnis
-cd D:\Extensions\documentation-system-plugin\packages\doc-system-agent
-npm link
-
-# Im database-plugin Verzeichnis
-cd D:\Extensions\database-plugin
-npm link @noyrax/cli
-
-# Dann funktioniert npx
-npx @noyrax/cli update-rules
-```
-
-### Alternative: NPX Cache leeren
-
-```bash
-# NPX Cache leeren
-npx clear-npx-cache
-
-# Dann erneut versuchen (mit expliziter Versionsangabe)
-npx @noyrax/cli@1.2.0 update-rules
-```
-
-## Verifizierung
-
-Nach dem Update prüfen:
-
-```bash
-# Version prüfen
-node D:\Extensions\documentation-system-plugin\packages\doc-system-agent\dist\cli\index.js info
-
-# Sollte (beispielhaft) zeigen:
-# Package-Version: 1.2.0
-# Rules-Version: 2
-# `002-system-context.mdc` sollte in der Liste sein
-```
-
-## Warum funktioniert npx nicht?
-
-NPX verwendet eine **gecachte Version** aus dem npm-Cache. Wenn das Package lokal aktualisiert wurde, aber noch nicht auf npm veröffentlicht wurde, verwendet npx die alte Version.
-
-**Lösung:** Lokale Version direkt verwenden oder npm link nutzen.
-

package/docs/system/PLUGIN_ECOSYSTEM_STATUS.md

@@ -1,465 +0,0 @@
-# Plugin-Ecosystem Status
-
-**Stand:** 2025-01-XX  
-**Zweck:** Dokumentation des aktuellen Implementierungsstands der Plugin-Architektur
-
-## Übersicht
-
-Das Documentation-System-Plugin ist Teil eines modularen Plugin-Ecosystems mit drei Hauptkomponenten:
-
-```
-Documentation-System-Plugin (Basis)
-    ↓ generiert docs/
-Database Plugin ✅ KOMPLETT
-    ↓ persistiert in SQLite
-Semantic Brain Plugin 🔄 FAST FERTIG
-    ↓ Graph & Embeddings
-Context/RAG Plugin 📋 GEPLANT
-    ↓ AI-Agent Integration
-```
-
----
-
-## 1. Documentation-System-Plugin
-
-**Pfad:** `d:\Extensions\documentation-system-plugin`  
-**Status:** ✅ Produktiv
-
-### Neue Features (ADR-020 bis ADR-026)
-
-- **SignatureFormatter** (ADR-020): Zentrale Signatur-Formatierung für Generator und Validator
-- **SymbolClassifier** (ADR-021): Semantische Klassifizierung (visibility, role, priority)
-- **Semantisches Rendering** (ADR-022): Klassen und Konstanten strukturiert darstellen
-- **ADR-Linking** (ADR-023): Automatische ADR-Verknüpfung mit Modulen
-- **Mehrdimensionaler Navigationsraum** (ADR-024): 5 Dimensionen für KI-Agenten
-- **MCP-Server CLI-Bridge** (ADR-025): CLI-Tools für MCP-Server-Integration
-- **Reality-Driven Development** (ADR-026): Verification-Loops verhindern Halluzinationen
-
-### Generierte Artefakte
-
-- **`docs/modules/*.md`** - 68 Modul-Dokumentationen mit API-Signaturen (inkl. ADR-Links, semantisches Rendering)
-- **`docs/index/symbols.jsonl`** - Symbol-Index mit Dependencies (435 Zeilen)
-- **`docs/system/DEPENDENCY_GRAPH.md`** - Mermaid-Graph mit 127 Knoten
-- **`docs/system/DEPENDENCIES.md`** - Import-Übersicht pro Modul
-- **`docs/system/CHANGE_REPORT.md`** - Änderungsprotokoll (Zeit-Dimension)
-- **`docs/adr/*.md`** - 29 ADRs mit automatischer Modul-Verknüpfung (ADR-023)
-
-### MCP-Server Integration (ADR-025)
-
-Der MCP-Server (`mcp/` und `packages/doc-system-agent/`) ermöglicht Agent-Zugriff:
-
-**Resources (99 insgesamt):**
-- `docs://modules/{path}` - Modul-Dokumentation (71 Resources)
-- `docs://system/graph` - Dependency-Graph
-- `docs://system/dependencies` - Dependency-Übersicht
-- `docs://system/changes` - Change Report (Zeit-Dimension)
-- `docs://adr/{name}` - ADRs (24 Resources)
-- `docs://index/symbols.jsonl` - Symbol-Index
-
-**Tools:**
-- `validation/runScan` - Scan via CLI-Bridge (`npm run scan:cli`)
-- `validation/runValidate` - Validate via CLI-Bridge (`npm run validate:cli`)
-- `validation/runDriftCheck` - Drift-Check
-- `validation/analyzeImpact` - Impact-Analyse via Symbol-Index
-
-### Core-Komponenten
-
-- **SignatureFormatter** (`src/core/signature-formatter.ts`): `formatForDoc()`, `compare()`, `normalize()`
-- **SymbolClassifier** (`src/core/symbol-classifier.ts`): `classifySymbol()` - Liefert `visibility`, `role`, `priority`
-- **AdrLinker** (`src/generator/adr-linker.ts`): `getRelevantAdrs()`, `getAdrMetadata()`
-
-### Verification-Scripts (ADR-026)
-
-- `scripts/verify-architecture.js` - Architektur-Regeln prüfen
-- `scripts/verify-adrs.js` - ADR-Claims gegen Code prüfen
-- `scripts/verify-imports.js` - Import-Verfügbarkeit prüfen
-- Integration: Pre-Commit Hook, GitHub Actions, VS Code Tasks
-
----
-
-## 2. Database Plugin
-
-**Pfad:** `d:\Extensions\database-plugin`  
-**Status:** ✅ KOMPLETT  
-**MVP-Plan:** `MVP_PLAN database.md`  
-**Architektur:** Hybrid-Datenbank (Registry-DB + Workspace-DB, ADR-035)
-
-### Implementierte Komponenten
-
-#### Core (4 Dateien)
-- ✅ `database-manager.ts` - SQLite-Verbindungs-Management (Registry + Workspace)
-- ✅ `migration-manager.ts` - Schema-Migrationen (beide DB-Typen)
-- ✅ `query-builder.ts` - SQL Query Builder
-- ✅ `data-migration.ts` - Migration von zentraler DB zu Hybrid (ADR-035)
-
-#### Models (7 Dateien)
-- ✅ `plugin.ts` - Plugin-Metadaten
-- ✅ `snapshot.ts` - Snapshot-Verwaltung
-- ✅ `symbol.ts` - Symbol-Rohdaten
-- ✅ `dependency.ts` - Dependency-Rohdaten
-- ✅ `file.ts` - Datei-Metadaten
-- ✅ `adr-relation.ts` - ADR-Verknüpfungen (ADR-034)
-- ✅ `change-record.ts` - Change-Records (ADR-034)
-
-#### Repositories (7 Dateien)
-- ✅ `base-repository.ts` - Basis-Repository Pattern (mit DB-Typ-Support)
-- ✅ `plugin-repository.ts` - Plugin CRUD (Registry-DB)
-- ✅ `symbol-repository.ts` - Symbol CRUD (Workspace-DB)
-- ✅ `dependency-repository.ts` - Dependency CRUD (Workspace-DB)
-- ✅ `snapshot-repository.ts` - Snapshot CRUD (Workspace-DB)
-- ✅ `adr-relation-repository.ts` - ADR-Relations CRUD (Workspace-DB, ADR-034)
-- ✅ `change-record-repository.ts` - Change-Records CRUD (Workspace-DB, ADR-034)
-
-#### APIs (7 Dateien)
-- ✅ `plugin-api.ts` - Plugin-Abfragen (Registry-DB)
-- ✅ `symbol-api.ts` - Symbol-Abfragen (Workspace-DB)
-- ✅ `dependency-api.ts` - Dependency-Abfragen (Workspace-DB)
-- ✅ `search-api.ts` - Basis-Suche
-- ✅ `snapshot-api.ts` - Snapshot-Management (Workspace-DB)
-- ✅ `adr-api.ts` - ADR-Relations Abfragen (Workspace-DB, ADR-034)
-- ✅ `change-api.ts` - Change-Records Abfragen (Workspace-DB, ADR-034)
-
-#### Ingestors (5 Dateien)
-- ✅ `docs-ingestor.ts` - docs/ Ordner Parser
-- ✅ `jsonl-ingestor.ts` - JSONL Index Parser
-- ✅ `markdown-ingestor.ts` - Markdown Dokumentation (inkl. ADR-Extraktion)
-- ✅ `batch-ingestor.ts` - Batch-Processing
-- ✅ `change-report-ingestor.ts` - CHANGE_REPORT.md Parser (ADR-034)
-
-#### Validators (3 Dateien)
-- ✅ `schema-validator.ts` - Schema-Konsistenz
-- ✅ `integrity-validator.ts` - Referentielle Integrität
-- ✅ `consistency-validator.ts` - Daten-Konsistenz
-
-#### Cache (3 Dateien)
-- ✅ `query-cache.ts` - Query-Result Caching
-- ✅ `ingestion-cache.ts` - Ingestion-Status Cache
-- ✅ `metadata-cache.ts` - Metadaten Cache
-
-#### UI (3 Dateien)
-- ✅ `database-explorer.ts` - TreeView für DB-Inhalt
-- ✅ `commands.ts` - VSCode Commands
-- ✅ `status-provider.ts` - Status-Anzeige
-
-#### Tests
-- ✅ Integration Tests: `end-to-end-ingestion.test.ts`
-- ✅ Unit Tests: 26 Test-Dateien für alle Komponenten
-
-#### Dokumentation
-- ✅ **35 ADRs** dokumentieren die komplette Implementierung
-- Wichtig: ADR-034 (ADR- und Change-Integration), ADR-035 (Hybrid-Datenbank-Architektur)
-
-### Hybrid-Datenbank-Architektur (ADR-035)
-
-Das Plugin verwendet eine **Hybrid-Architektur** mit zwei separaten Datenbanken:
-
-**Registry-DB** (`~/.vscode/globalStorage/database-plugin/registry.db`):
-- Globale Plugin-Registrierungen (`plugins` Tabelle)
-- Zentrale Verwaltung aller registrierten Plugins
-- Schema-Versionierung (`schema_metadata` Tabelle)
-
-**Workspace-DB** (`{workspace}/.database/data.db`):
-- Workspace-spezifische Plugin-Daten
-- `snapshots`, `raw_symbols`, `raw_dependencies`
-- `adr_relations`, `change_records` (neu, ADR-034)
-- Jedes Workspace hat seine eigene Datenbank
-
-**Vorteile:**
-- Isolierung von Plugin-Daten pro Workspace
-- Bessere Skalierbarkeit bei vielen Plugins
-- Einfacheres Backup und Migration
-- Cross-Workspace Queries nur über Registry-DB möglich
-
-**Migration:** Automatische Migration von zentraler `plugins.db` zu Hybrid-Architektur bei Extension-Aktivierung (`src/core/data-migration.ts`).
-
-### Kommunikation mit Documentation-System-Plugin
-
-Der `DocsIngestor` (`src/ingestors/docs-ingestor.ts`) liest die generierten `docs/` Artefakte:
-- Parst `docs/modules/*.md` für Modul-Metadaten (inkl. ADR-Verknüpfungen)
-- Liest `docs/index/symbols.jsonl` für Symbol-Daten
-- Extrahiert Dependencies aus `docs/system/DEPENDENCIES.md`
-- Verarbeitet `docs/system/CHANGE_REPORT.md` via `ChangeReportIngestor` (ADR-034)
-
-### Neue APIs für abhängige Module
-
-**ADR-API** (`src/api/adr-api.ts`):
-- `getAdrsForModule(moduleFilePath, snapshotId?)` - ADRs für Modul abrufen
-- `getModulesForAdr(adrId, snapshotId?)` - Module für ADR abrufen
-- `getAllAdrRelations(pluginId, filters?)` - Alle ADR-Relations abrufen
-
-**Change-API** (`src/api/change-api.ts`):
-- `getRecentChanges(snapshotId)` - Änderungen für Snapshot abrufen
-- `getChangesByType(snapshotId, changeType)` - Änderungen nach Typ filtern
-- `getChangesForFile(filePath, snapshotId?)` - Änderungen für Datei abrufen
-
-**Workspace-DB Zugriff:**
-- Abhängige Module müssen Workspace-DB initialisieren vor Datenzugriff
-- Cross-Workspace Queries nur über Registry-DB möglich
-- Siehe `src/core/database-manager.ts` → `initializeWorkspace()` für Details
-
----
-
-## 3. Semantic Brain Plugin
-
-**Pfad:** `d:\Extensions\semantic-brain-plugin`  
-**Status:** 🔄 FAST FERTIG  
-**MVP-Plan:** `MVP_PLAN semantic brain.md`
-
-### Implementierte Komponenten
-
-#### Core (3 Dateien)
-- ✅ `brain-manager.ts` - Hauptsteuerung
-- ✅ `database-client.ts` - Client für Database Plugin
-- ✅ `graph-manager.ts` - Graph-Operationen
-- ❌ `embedding-manager.ts` - FEHLT (geplant)
-
-#### Graph Layer
-
-**Models (3 Dateien)**
-- ✅ `semantic-node.ts` - Knoten (Symbole, Module)
-- ✅ `semantic-edge.ts` - Kanten (Beziehungen)
-- ✅ `graph-cluster.ts` - Cluster/Communities
-
-**Builders (1 Datei)**
-- ✅ `symbol-graph-builder.ts` - Symbol-Abhängigkeiten
-- ❌ `module-graph-builder.ts` - FEHLT (geplant)
-- ❌ `cross-plugin-graph-builder.ts` - FEHLT (geplant)
-
-**Analyzers (3 Dateien)**
-- ✅ `centrality-analyzer.ts` - Zentralitäts-Metriken
-- ✅ `community-detector.ts` - Community-Detection
-- ✅ `path-analyzer.ts` - Pfad-Analysen
-- ❌ `influence-analyzer.ts` - FEHLT (geplant)
-
-**Exporters (2 Dateien)**
-- ✅ `mermaid-exporter.ts` - Mermaid Diagramme
-- ✅ `graphml-exporter.ts` - GraphML für Gephi
-- ❌ `cytoscape-exporter.ts` - FEHLT (geplant)
-
-**Infrastructure**
-- ✅ `graph-store.ts` - In-Memory Graph Database
-
-#### Vector Layer
-
-**Models (3 Dateien)**
-- ✅ `symbol-embedding.ts` - Symbol-Embeddings
-- ✅ `document-embedding.ts` - Dokument-Embeddings
-- ✅ `similarity-score.ts` - Ähnlichkeits-Scores
-
-**Embedders (3 Dateien)**
-- ✅ `code-embedder.ts` - Code-spezifische Embeddings
-- ✅ `text-embedder.ts` - Text/Doku-Embeddings
-- ✅ `hybrid-embedder.ts` - Kombinierte Embeddings
-
-**Similarity (2 Dateien)**
-- ✅ `cosine-similarity.ts` - Cosinus-Ähnlichkeit
-- ✅ `semantic-similarity.ts` - Semantische Ähnlichkeit
-- ❌ `structural-similarity.ts` - FEHLT (geplant)
-
-**Indexes**
-- ❌ `faiss-index.ts` - FEHLT (Dependency installiert, aber nicht implementiert)
-- ❌ `annoy-index.ts` - FEHLT (Dependency installiert, aber nicht implementiert)
-
-#### Fehlende Komponenten
-
-**Scoring-Algorithmen** (0 von 4)
-- ❌ `importance-scorer.ts` - FEHLT
-- ❌ `complexity-scorer.ts` - FEHLT
-- ❌ `coupling-scorer.ts` - FEHLT
-- ❌ `quality-scorer.ts` - FEHLT
-
-**Cache** (0 von 3)
-- ❌ `graph-cache.ts` - FEHLT
-- ❌ `vector-cache.ts` - FEHLT
-- ❌ `computation-cache.ts` - FEHLT
-
-**APIs** (0 von 4)
-- ❌ `graph-api.ts` - FEHLT
-- ❌ `similarity-api.ts` - FEHLT
-- ❌ `recommendation-api.ts` - FEHLT
-- ❌ `analytics-api.ts` - FEHLT
-
-**UI** (0 von 3)
-- ❌ `graph-visualizer.ts` - FEHLT
-- ❌ `similarity-explorer.ts` - FEHLT
-- ❌ `semantic-search.ts` - FEHLT
-
-**Extension**
-- ❌ `extension.ts` - FEHLT (Commands in package.json definiert, aber keine Implementierung)
-
-### Kommunikation mit Database Plugin
-
-Der `DatabaseClient` implementiert `IDatabaseClient`:
-- `getSymbols(pluginId)` - Symbole vom Database Plugin abrufen
-- `getDependencies(pluginId)` - Dependencies abrufen
-- `getPluginIds()` - Verfügbare Plugins
-
-### Dependencies
-
-- ✅ `faiss-node` - Installiert, aber noch nicht genutzt
-- ✅ `annoy` - Installiert, aber noch nicht genutzt
-- ✅ `ml-matrix` - Installiert
-- ✅ `graph-theory` - Installiert
-
-### Dokumentation
-
-- ✅ **11 ADRs** dokumentieren die Architektur
-
----
-
-## 4. Context/RAG Plugin
-
-**Pfad:** `d:\Extensions\context-rag-plugin` (noch nicht erstellt)  
-**Status:** 📋 GEPLANT  
-**MVP-Plan:** `MVP_PLAN RAG context.md`
-
-### Geplante Komponenten
-
-- Agent-Bridge für AI-Agent-System Integration
-- Context-Assembly mit semantischen Daten
-- Multi-Provider RAG (OpenAI, Anthropic, lokale Modelle)
-- Agent-Enhanced RAG mit spezialisierten Agenten
-
----
-
-## Koordinaten-System für KI-Agenten
-
-### Mehrdimensionaler Navigationsraum (ADR-024)
-
-Das Documentation-System-Plugin generiert ein **Koordinaten-System** mit 5 Dimensionen, das KI-Agenten ermöglicht, sich im Code-Raum zu bewegen:
-
-| Dimension | Artefakt | Funktion | Zugriff |
-|-----------|----------|----------|---------|
-| **Modul-Raum (X)** | `docs/modules/*.md` | API-Dokumentation pro Datei | `docs://modules/{path}` |
-| **Symbol-Raum (Y)** | `docs/index/symbols.jsonl` | Symbole mit Dependencies | `docs://index/symbols.jsonl` |
-| **Beziehungs-Raum (Z)** | `docs/system/DEPENDENCY_GRAPH.md` | Modul-Abhängigkeiten | `docs://system/graph` |
-| **Wissens-Raum (W)** | `docs/adr/*.md` | Architektur-Entscheidungen (Landkarte) | `docs://adr/{name}` |
-| **Zeit-Raum (T)** | `docs/system/CHANGE_REPORT.md` | Änderungen über die Zeit | `docs://system/changes` |
-
-**MCP-Server-Integration:**
-- 99 Resources verfügbar (4 System, 71 Module, 24 ADRs)
-- Strukturierter Zugriff via `docs://` URIs
-- Tools: `validation/runScan`, `validation/runValidate`, `validation/runDriftCheck`, `validation/analyzeImpact`
-
-### Agent-Navigation
-
-**Via MCP-Server (ADR-025):**
-```typescript
-// Modul-Dokumentation lesen
-readDocsResource('docs://modules/src__parsers__ts-js.ts.md')
-
-// Dependency-Graph abrufen
-readDocsResource('docs://system/graph')
-
-// Change Report abrufen (Zeit-Dimension)
-readDocsResource('docs://system/changes')
-
-// ADRs lesen
-readDocsResource('docs://adr/020-api-doc-tiefe-und-signatureformatter.md')
-
-// Impact-Analyse durchführen
-analyzeImpact({ file: 'src/parsers/ts-js.ts', symbol: 'TsJsParser' })
-
-// Scan via CLI-Bridge
-runScan({ workspaceRoot: '...' })
-
-// Validate via CLI-Bridge
-runValidate({ workspaceRoot: '...' })
-```
-
-**Via Database Plugin (Hybrid-Architektur, ADR-035):**
-```typescript
-// Workspace-DB initialisieren (wichtig!)
-initializeWorkspace(workspaceRoot)
-
-// Symbole abrufen (Workspace-DB)
-getSymbols(pluginId)
-
-// Dependencies abrufen (Workspace-DB)
-getDependencies(pluginId)
-
-// ADR-Verknüpfungen abrufen (Workspace-DB, ADR-034)
-getAdrsForModule(moduleFilePath, snapshotId?)
-getModulesForAdr(adrId, snapshotId?)
-
-// Change-Records abrufen (Workspace-DB, ADR-034)
-getRecentChanges(snapshotId)
-getChangesByType(snapshotId, changeType)
-getChangesForFile(filePath, snapshotId?)
-
-// Suche durchführen
-searchSymbols({ name: 'Parser', kind: 'class' })
-```
-
-**Via Semantic Brain Plugin (geplant):**
-```typescript
-// Graph-Nachbarschaft abrufen (APIs fehlen noch)
-getNeighborhood({ nodeId: '...', depth: 2 })
-
-// Ähnliche Symbole finden (APIs fehlen noch)
-findSimilarNodes({ nodeId: '...', minSimilarity: 0.7 })
-
-// Semantische Suche (APIs fehlen noch)
-semanticSearch({ query: 'parser implementation' })
-```
-
----
-
-## Nächste Schritte
-
-### 1. Semantic Brain Plugin fertigstellen
-
-**Priorität: Hoch**
-
-1. **Scoring-Algorithmen** implementieren
-   - `importance-scorer.ts`
-   - `complexity-scorer.ts`
-   - `coupling-scorer.ts`
-   - `quality-scorer.ts`
-
-2. **APIs** implementieren
-   - `graph-api.ts`
-   - `similarity-api.ts`
-   - `recommendation-api.ts`
-   - `analytics-api.ts`
-
-3. **Extension** implementieren
-   - `extension.ts` mit Command-Handlern
-   - UI-Komponenten für Graph-Visualisierung
-
-4. **Cache** implementieren
-   - `graph-cache.ts`
-   - `vector-cache.ts`
-   - `computation-cache.ts`
-
-### 2. Context/RAG Plugin starten
-
-**Priorität: Mittel**
-
-Gemäß `MVP_PLAN RAG context.md`:
-- Agent-Bridge für AI-Agent-System
-- Context-Assembly mit Semantic Brain Daten
-- Multi-Provider RAG
-
-### 3. Integration testen
-
-**Priorität: Hoch**
-
-- End-to-End Tests: Documentation-System → Database → Semantic Brain
-- Performance-Tests für große Codebases
-- Cross-Plugin Dependency-Analysis
-
----
-
-## Referenzen
-
-- **Database Plugin MVP-Plan:** `d:\Extensions\database-plugin\MVP_PLAN.md`
-- **Semantic Brain MVP-Plan:** `d:\Extensions\semantic-brain-plugin\MVP_PLAN.md`
-- **RAG Context MVP-Plan:** `MVP_PLAN RAG context.md` (im Documentation-System-Plugin)
-- **Database Plugin ADRs:** `d:\Extensions\database-plugin\docs\adr\`
-- **Semantic Brain ADRs:** `d:\Extensions\semantic-brain-plugin\docs\adr\`
-
----
-
-*Diese Dokumentation wird aktualisiert, sobald neue Komponenten implementiert werden.*
-