@noyrax/documentation-system-plugin 1.0.4-beta.2 → 1.0.4-beta.4

package/docs/adr/006-parser-variable-type-extraction.md

@@ -1,33 +0,0 @@
-# 006 – Parser: Präzisere Typableitung für Variablen (v1.0.3)
-
-- Status: Accepted
-- Datum: 2025-10-02
-- Version: 1.0.3
-
-## Kontext
-In generierten Modul-Dokumentationen wurden Variablen-Typen teils als `any` oder `{}` ausgewiesen, obwohl der Code präzisere Typen wie `Set<string>` oder `string[]` definiert (z.B. in `src/core/scanner.ts`: `DEFAULT_EXCLUDES`, `BACKUP_DIR_NAMES`, `BACKUP_FILE_SUFFIXES`).
-
-## Entscheidung
-Der TypeScript-Parser (`TsJsParser`) liest Variablen-Typen nun bevorzugt aus dem `TypeNode` und fällt nur bei Bedarf auf `getType()` zurück. Der Typstring wird deterministisch normalisiert.
-
-## Änderungen
-- Datei `src/parsers/ts-js.ts`:
-  - Für Top-Level-Variablen: `decl.getTypeNode()?.getText()` → Normalisierung → Fallback `decl.getType().getText()`.
-  - Einheitliche Normalisierung von Typstrings (Whitespace, import("...").-Präfixe).
-
-## Auswirkungen
-- Doku zeigt korrekte Typen, z.B.:
-  - `BACKUP_DIR_NAMES: Set<string>`
-  - `BACKUP_FILE_SUFFIXES: string[]`
-  - `DEFAULT_EXCLUDES: Set<string>`
-- Erhöhte Qualität und Nachvollziehbarkeit der generierten Dokumentation.
-
-## Rollout
-- Bestandteil der Version 1.0.3 (VSIX).
-- Nach Update: „Docs: Generate Documentation“ ausführen.
-
-## Risiken
-- Keine funktionalen Risiken. Minimal erhöhte String-Sensitivität bei exotischen Typen.
-
-## Alternativen
-- Beibehalten der bisherigen (ungenaueren) Typableitung: verworfen zugunsten präziser Doku.

package/docs/adr/007-ts-parser-load-libs-for-accurate-types.md

@@ -1,31 +0,0 @@
-# 007 – TS-Parser lädt Standard-Libs für präzise Typinferenz (v1.0.2)
-
-- Status: Accepted
-- Datum: 2025-10-02
-- Version: 1.0.2
-
-## Kontext
-Variablen-Typen wurden in der Doku teils als `any` oder `{}` dargestellt, obwohl der Code präzise Typen nutzt (z.B. `Set<string>`, `string[]`). Ohne geladene Standard-Libs war die Typinferenz des TypeScript-Checkers unvollständig.
-
-## Entscheidung
-Der `TsJsParser` lädt nun Standardbibliotheken und führt keine Dependency-Resolution-Skippings mehr durch. Das aktiviert eine vollständige Typinferenz für JS/TS (inkl. `Set`, `Map`, Promise, Arrays).
-
-## Änderungen
-- `src/parsers/ts-js.ts` (Projekt-Setup):
-  - `skipFileDependencyResolution: false`
-  - `skipLoadingLibFiles: false`
-  - `compilerOptions.lib: ["ES2020"]`
-
-## Auswirkungen
-- Doku spiegelt exakte Variablen-Typen wider (z.B. `Set<string>`, `string[]`).
-- Validator kann Variablen-Signaturen belastbar abgleichen.
-
-## Rollout
-- Bestandteil der v1.0.2 VSIX-Neuinstallation.
-- Nach Installation: „Docs: Generate Documentation“, dann „Docs: Validate Documentation“.
-
-## Risiken
-- Leicht längere Parse-Zeit durch geladene Libs; im MVP tolerierbar.
-
-## Alternativen
-- Heuristische Ableitung aus Initializern: verworfen zugunsten Checker-basierter, robuster Typen.

package/docs/adr/008-dependencies-cache-phase1.md

@@ -1,133 +0,0 @@
-# ADR 008: Dependencies-Cache für additive Generierung (Phase 1.1)
-
-**Status:** Implementiert  
-**Datum:** 2025-10-06  
-**Kontext:** ADDITIVE_DOCUMENTATION_PLAN.md, Abschnitt 7, Phase 1
-
-## Kontext und Problemstellung
-
-Beim zweiten Generierungslauf werden unveränderte Dateien durch AST-Cache und Git-Diff-Optimierung übersprungen. Diese Dateien liefern keine Dependencies im aktuellen Lauf, wodurch `allDependencies` nur die Dependencies der aktuell geparsten Dateien enthält.
-
-**Resultat:**
-- `docs/system/DEPENDENCY_GRAPH.md` wird aus reduziertem Snapshot neu geschrieben
-- `docs/system/DEPENDENCIES.md` wird aus reduziertem Snapshot neu geschrieben
-- Artefakte "schrumpfen" zwischen Läufen
-
-**Betroffene Code-Stelle:**
-```typescript
-// src/extension.ts:139-174
-const unchanged = astMap.get(f.repositoryRelativePath) === fileHash;
-if (unchanged) {
-    return { symbols: [], dependencies: [] }; // ⚠️ Dependencies fehlen!
-}
-```
-
-## Entscheidung
-
-Einführung eines persistenten **Dependencies-Cache** analog zu den bestehenden Cache-Modulen (`ast-cache.ts`, `signature-cache.ts`, `output-cache.ts`).
-
-### Neues Modul: `src/cache/dependencies-cache.ts`
-
-**Schema:**
-```typescript
-interface DependenciesCacheData {
-    version: 1;
-    entries: DependencyCacheEntry[];
-}
-
-interface DependencyCacheEntry {
-    from: string;      // repo-relative path
-    to: string;        // import path
-    type: 'import' | 'export' | 'require';
-    symbols?: string[]; // sorted
-}
-```
-
-**Funktionen:**
-- `loadDependenciesCache(file: string): DependenciesCacheData | null`
-- `saveDependenciesCache(dir: string, data: DependenciesCacheData): void`
-
-**Datei:** `docs/.cache/dependencies.json`
-
-**Sortierung (deterministisch):**
-1. `from` (ascending)
-2. `to` (ascending)
-3. `type` (ascending)
-4. `symbols` (ascending, joined)
-
-### Design-Konsistenz mit bestehenden Cache-Modulen
-
-Das Modul folgt exakt dem Muster von:
-- `src/cache/ast-cache.ts` (Schema, load/save)
-- `src/cache/signature-cache.ts` (Versionierung, null-Fallback)
-- `src/cache/output-cache.ts` (Sortierung, deterministisches JSON)
-
-**Gelesene Abhängigkeiten aus `docs/system/DEPENDENCIES.md`:**
-- `fs` (existsSync, readFileSync, writeFileSync, mkdirSync)
-- `path` (join)
-- Keine zusätzlichen Dependencies
-
-## Auswirkungen
-
-### Positiv
-- ✅ **Keine schrumpfenden Abhängigkeiten:** Dependencies werden persistent gehalten und in Union mit neuen Kanten gemerged (Phase 1.2)
-- ✅ **Deterministisch:** Sortierung garantiert identische Ausgabe bei gleicher Eingabe
-- ✅ **Konsistent:** Folgt etabliertem Cache-Muster; keine neuen Paradigmen
-- ✅ **Robust:** null-Fallback bei fehlendem/korruptem Cache; Vollparse greift
-
-### Neutral
-- Cache-Datei wird zusätzlich geschrieben (~1-10 KB je nach Projekt)
-- Keine Performance-Verschlechterung; nur I/O beim Laden/Schreiben
-
-### Risiken und Mitigation
-- **Risiko:** Cache-Korruption führt zu fehlerhaftem Merge
-  - **Mitigation:** Strikte Validierung (`version === 1`, `Array.isArray(entries)`); null-Fallback erzwingt Vollparse
-- **Risiko:** Cache wächst unbegrenzt bei großen Repos
-  - **Mitigation:** Gelöschte Dateien werden in Phase 1.2 (consolidation) aus dem Cache entfernt
-
-## Alternativen
-
-### Alternative 1: Dependencies aus bestehendem Index rekonstruieren
-- `docs/index/symbols.jsonl` enthält bereits Dependencies pro Datei
-- **Verworfen:** Index ist Symbol-zentriert; nicht ideal für Dependency-Rekonstruktion; separater Cache ist klarer
-
-### Alternative 2: Dependencies bei jedem Lauf neu extrahieren (kein Cache)
-- Vollparse aller Dateien, auch unveränderter
-- **Verworfen:** Performance-Einbußen; widerspricht inkrementeller Strategie
-
-### Alternative 3: Dependencies in AST-Cache integrieren
-- `ast-cache.json` erweitern um Dependencies
-- **Verworfen:** Mischt Verantwortlichkeiten; AST-Hash ist Änderungs-Detektor, nicht Daten-Cache
-
-## Nächste Schritte
-
-1. ✅ **Phase 1.1 abgeschlossen:** `dependencies-cache.ts` erstellt
-2. ⏭️ **Phase 1.2:** `src/core/consolidation.ts` erstellen mit `buildDependenciesUnion()`
-3. ⏭️ **Phase 1.3:** Integration in `src/extension.ts`
-4. ⏭️ **Phase 1.4:** Unit-Tests und Zweilauf-Test
-
-## Referenzen
-
-- **Plan:** `ADDITIVE_DOCUMENTATION_PLAN.md`, Abschnitt 5.1, 7 (Phase 1)
-- **Bestehende Cache-Module:**
-  - `docs/modules/src__cache__ast-cache.ts.md`
-  - `docs/modules/src__cache__signature-cache.ts.md`
-  - `docs/modules/src__cache__output-cache.ts.md`
-- **Dependencies-Dokumentation:** `docs/system/DEPENDENCIES.md`, Zeilen 14-33
-- **Cursor-Regeln:** `.cursor/rules/architecture-guardrails.mdc`, Abschnitt 0 (Wissensbasis)
-
-## Implementierung
-
-**Datei:** `src/cache/dependencies-cache.ts`
-
-**Zeilen Code:** 61  
-**Abhängigkeiten:** `fs`, `path` (Standard-Module)  
-**Exports:** 3 (2 Interfaces, 2 Funktionen)
-
-**Qualität:**
-- ✅ Keine Linter-Fehler
-- ✅ Strikte Typisierung
-- ✅ Deterministisch (sortierte Ausgabe)
-- ✅ Robustheit (try-catch, null-Fallback)
-
-

package/docs/adr/009-consolidation-union-logic-phase1-2.md

@@ -1,147 +0,0 @@
-# ADR 009: Union-Logik für Dependencies und Symbole (Phase 1.2)
-
-**Status:** Implementiert  
-**Datum:** 2025-10-06  
-**Kontext:** ADDITIVE_DOCUMENTATION_PLAN.md, Abschnitt 7, Phase 1, Aufgabe 2
-
-## Kontext und Problemstellung
-
-Nach Einführung des Dependencies-Cache (ADR 008) benötigen wir die **Union-Bildung**, um aus neuen und gecachten Dependencies bzw. Symbolen konsolidierte Gesamtmengen zu erzeugen.
-
-**Problem:**
-- Unveränderte Dateien liefern im aktuellen Lauf keine Dependencies/Symbole
-- Systemartefakte werden aus reduziertem Snapshot neu geschrieben
-- Index schrumpft zwischen Läufen
-
-**Ziel:**
-- Dependencies = Union aus "neu extrahiert" ∪ "gecachte"
-- Symbole = Union aus "neu geparst" ∪ "aus Index"
-- Nie "schrumpfen", außer bei Git-Deletion
-
-## Entscheidung
-
-Neues Modul `src/core/consolidation.ts` mit zwei Hauptfunktionen:
-
-### 1. `buildDependenciesUnion()`
-
-**Signatur:**
-```typescript
-buildDependenciesUnion(
-    dependenciesNew: ModuleDependency[],
-    dependenciesCachePrev: DependencyCacheEntry[],
-    parsedFiles: Set<string>,
-    deletedFiles: Set<string>
-): DependencyCacheEntry[]
-```
-
-**Algorithmus (gemäß ADDITIVE_DOCUMENTATION_PLAN.md, Abschnitt 6.2):**
-1. Für geparste Dateien: neue Dependencies übernehmen
-2. Für nicht-geparste, nicht-gelöschte Dateien: alte Dependencies aus Cache behalten
-3. Deduplizieren nach Schlüssel `(from, to, type, symbols_sorted)`
-4. Sortieren: `from` → `to` → `type` → `symbols`
-
-**Hilfsfunktionen (Cognitive Complexity reduziert):**
-- `buildPreviousDependenciesMap()`: Map aus Cache-Einträgen
-- `buildUnionMap()`: Union-Bildung
-- `deduplicateAndSortDependencies()`: Deduplikation und Sortierung
-
-### 2. `buildSymbolsUnion()`
-
-**Signatur:**
-```typescript
-buildSymbolsUnion(
-    symbolsNew: ParsedSymbol[],
-    symbolsPrev: ParsedSymbol[],
-    parsedFiles: Set<string>,
-    deletedFiles: Set<string>
-): ParsedSymbol[]
-```
-
-**Algorithmus (gemäß ADDITIVE_DOCUMENTATION_PLAN.md, Abschnitt 6.3):**
-1. Für geparste Dateien: neue Symbole übernehmen
-2. Für nicht-geparste, nicht-gelöschte Dateien: alte Symbole behalten
-3. Identifikation via `makeStableSymbolId()`
-
-## Gelesene Abhängigkeiten aus Dokumentation
-
-**docs/modules/src__core__symbols.ts.md:**
-- `makeStableSymbolId(symbol: ParsedSymbol): string` - für Symbol-Identifikation
-
-**docs/modules/src__parsers__types.ts.md:**
-- `interface ParsedSymbol` - Symbol-Struktur
-- `filePath`, `fullyQualifiedName`, `kind`, `signature`
-
-**docs/modules/src__parsers__dependencies.ts.md:**
-- `interface ModuleDependency` - Dependency-Struktur
-- `from`, `to`, `type`, `symbols`
-
-**docs/system/DEPENDENCIES.md:**
-- Bestehende Imports: `crypto`, `fs`, `path` (aus Cache-Modulen)
-- Keine zirkulären Abhängigkeiten: core → parsers → types
-
-## Auswirkungen
-
-### Positiv
-- ✅ **Union-Bildung deterministisch:** Gleiche Eingabe → gleiche Ausgabe
-- ✅ **Keine schrumpfenden Artefakte:** Dependencies/Symbole bleiben erhalten
-- ✅ **Cognitive Complexity reduziert:** Hauptfunktionen < 15, Helper-Funktionen extrahiert
-- ✅ **Linter-konform:** Alle Warnungen behoben (localeCompare für sort)
-- ✅ **Klare Verantwortlichkeiten:** Ein Modul für Union-Bildung
-
-### Neutral
-- Zusätzliche Funktion in `src/core/` (bestehende Struktur)
-- ~155 Zeilen Code
-
-### Risiken und Mitigation
-- **Risiko:** Performance bei großen Repos (viele Symbole/Dependencies)
-  - **Mitigation:** Map-basierte Deduplikation (O(n) statt O(n²)); deterministisches Sortieren nur einmal am Ende
-- **Risiko:** Fehlerhafte Union bei korrupten Daten
-  - **Mitigation:** null-Fallbacks in Phase 1.3 (extension.ts); leere Arrays als Default
-
-## Design-Entscheidungen
-
-### Alternative 1: Union-Logik direkt in extension.ts
-- **Verworfen:** Verletzt Single Responsibility; extension.ts wird zu groß
-
-### Alternative 2: Union in cache-Modulen implementieren
-- **Verworfen:** Cache-Module sind nur für Persistenz zuständig; Union ist Datenverarbeitung
-
-### Alternative 3: Separate Module für Dependencies-Union und Symbols-Union
-- **Verworfen:** Beide Funktionen folgen gleichem Muster; Konsolidierung in einem Modul ist kohärenter
-
-## Nächste Schritte
-
-1. ✅ **Phase 1.1 abgeschlossen:** `dependencies-cache.ts`
-2. ✅ **Phase 1.2 abgeschlossen:** `consolidation.ts`
-3. ⏭️ **Phase 1.3:** Integration in `src/extension.ts` (Union-Logik nach Parse, vor Artefakt-Generierung)
-4. ⏭️ **Phase 1.4:** Unit-Tests für `buildDependenciesUnion()` und `buildSymbolsUnion()`
-
-## Referenzen
-
-- **Plan:** `ADDITIVE_DOCUMENTATION_PLAN.md`, Abschnitt 6.2-6.3, 7 (Phase 1)
-- **ADR 008:** Dependencies-Cache-Einführung
-- **Dokumentation:**
-  - `docs/modules/src__core__symbols.ts.md`
-  - `docs/modules/src__parsers__types.ts.md`
-  - `docs/modules/src__parsers__dependencies.ts.md`
-  - `docs/system/DEPENDENCIES.md`
-- **Cursor-Regeln:** `.cursor/rules/architecture-guardrails.mdc`, Abschnitt 0
-
-## Implementierung
-
-**Datei:** `src/core/consolidation.ts`
-
-**Zeilen Code:** 155  
-**Exports:** 2 öffentliche Funktionen, 3 private Helper  
-**Abhängigkeiten:**
-- `../cache/dependencies-cache` (DependencyCacheEntry)
-- `../parsers/dependencies` (ModuleDependency)
-- `../parsers/types` (ParsedSymbol)
-- `./symbols` (makeStableSymbolId)
-
-**Qualität:**
-- ✅ Keine Linter-Fehler
-- ✅ Cognitive Complexity < 15 (durch Helper-Funktionen)
-- ✅ Strikte Typisierung
-- ✅ Deterministisch (sortiert mit localeCompare)
-

package/docs/adr/010-extension-union-integration-phase1-3-and-phase2.md

@@ -1,179 +0,0 @@
-# ADR 010: Integration Union-Logik in extension.ts (Phase 1.3 + Phase 2)
-
-**Status:** Implementiert  
-**Datum:** 2025-10-06  
-**Kontext:** ADDITIVE_DOCUMENTATION_PLAN.md, Abschnitt 7, Phase 1 Aufgabe 3 + Phase 2
-
-## Kontext und Problemstellung
-
-Nach Einführung von Dependencies-Cache (ADR 008) und Union-Logik (ADR 009) muss die Pipeline in `src/extension.ts` angepasst werden:
-
-**Bisheriger Ablauf:**
-1. Parse → `allSymbols`, `allDependencies`
-2. Generierung/Index/System-Docs direkt aus `allSymbols`/`allDependencies`
-3. **Problem:** Unveränderte Dateien liefern keine Dependencies/Symbole → Artefakte schrumpfen
-
-**Gewünschter Ablauf (gemäß Plan):**
-1. Parse → `allSymbols`, `allDependencies` (nur geparste Dateien)
-2. **Union-Bildung:** Merge mit Cache/Index → `symbolsUnion`, `dependenciesUnion`
-3. Generierung/Index/System-Docs aus `symbolsUnion`/`dependenciesUnion`
-4. Dependencies-Cache speichern
-
-## Entscheidung
-
-### Integration in `src/extension.ts` nach Zeile 250 (nach Fallbacks)
-
-**Neue Imports:**
-```typescript
-import { loadDependenciesCache, saveDependenciesCache } from './cache/dependencies-cache';
-import { buildDependenciesUnion, buildSymbolsUnion } from './core/consolidation';
-```
-
-**Union-Bildung (Zeilen 252-310):**
-
-1. **Dependencies-Union:**
-   ```typescript
-   const depCacheFile = path.join(cacheDir, 'dependencies.json');
-   const depCachePrev = loadDependenciesCache(depCacheFile);
-   const parsedFiles = new Set(scanned.map(f => f.repositoryRelativePath));
-   const deletedFilesFromGit = new Set<string>(); // Für jetzt leer
-   
-   const dependenciesUnion = buildDependenciesUnion(
-       allDependencies,
-       depCachePrev?.entries ?? [],
-       parsedFiles,
-       deletedFilesFromGit
-   );
-   ```
-
-2. **Symbol-Union:**
-   ```typescript
-   // Index laden und zu ParsedSymbol[] rekonstruieren
-   const indexFile = path.join(workspaceRoot, config.outputPath, 'index', 'symbols.jsonl');
-   let symbolsPrev: ParsedSymbol[] = []; // Aus Index rekonstruiert
-   
-   const symbolsUnion = buildSymbolsUnion(
-       allSymbols,
-       symbolsPrev,
-       parsedFiles,
-       deletedFilesFromGit
-   );
-   ```
-
-**Verwendung der Union (ab Zeile 316):**
-- `generatePerFileDocs(symbolsUnion)` statt `allSymbols`
-- `buildIndexFromSymbols(symbolsUnion, dependenciesUnion)` statt `allSymbols, allDependencies`
-- `generateMermaidGraph(dependenciesUnion)` statt `allDependencies`
-- `generateDependencyOverview(dependenciesUnion)` statt `allDependencies`
-- `computeCacheEntries(symbolsUnion)` statt `allSymbols`
-
-**Dependencies-Cache speichern (Zeile 354):**
-```typescript
-if (dependenciesUnion.length > 0) {
-    saveDependenciesCache(cacheDir, { version: 1, entries: dependenciesUnion });
-}
-```
-
-## Gelesene Abhängigkeiten aus Dokumentation
-
-**docs/modules/src__extension.ts.md:**
-- `generateDocumentationTs()` - Hauptfunktion für Generierung
-
-**docs/modules/src__core__git.ts.md:**
-- `getChangedFiles(repoRoot: string): Set<string> | null` - Git-Diff
-
-**docs/modules/src__index__index.ts.md:**
-- `buildIndexFromSymbols(symbols, dependencies)` - Index-Erzeugung
-- `writeJsonlIndex(rows, outFile)` - Index schreiben
-
-**docs/system/DEPENDENCIES.md:**
-- Bestätigung: keine zirkulären Abhängigkeiten durch neue Imports
-
-## Auswirkungen
-
-### Positiv
-- ✅ **Phase 1 komplett abgeschlossen:** Dependencies-Cache, Union-Logik, Integration
-- ✅ **Phase 2 komplett abgeschlossen:** Systemartefakte und Index aus Union
-- ✅ **Keine schrumpfenden Artefakte mehr:** Dependencies/Symbole bleiben erhalten
-- ✅ **Logging transparent:** `[union]` zeigt neu/gecacht/Union-Anzahl
-- ✅ **Rückwärtskompatibel:** Bei fehlendem Cache/Index funktioniert Vollparse
-- ✅ **Deterministisch:** Union-Funktionen garantieren stabile Sortierung
-
-### Neutral
-- ~60 Zeilen zusätzlicher Code in `extension.ts`
-- Dependencies-Cache wird zusätzlich geschrieben (nach Systemartefakten)
-
-### Trade-offs
-- **Index-Rekonstruktion vereinfacht:** 
-  - Aus `symbols.jsonl` wird `ParsedSymbol` rekonstruiert
-  - `language` fehlt im Index → `'unknown'`
-  - `signature` wird vereinfacht (nur Name, keine Parameter/ReturnType)
-  - **Mitigation:** Funktioniert für Union-Bildung (Key ist `symbol_id` oder `(path, kind, name)`)
-  - **Zukünftige Verbesserung:** Vollständigere Signatur-Persistierung im Index (optional)
-
-## Risiken und Mitigation
-
-- **Risiko:** Index-Rekonstruktion zu vereinfacht für korrekte Union
-  - **Mitigation:** `makeStableSymbolId()` nutzt Pfad+Name+Kind; ausreichend für Deduplikation
-  - **Test:** Phase 1.4 wird Zweilauf-Test durchführen
-
-- **Risiko:** Git-Deletion-Tracking noch nicht implementiert
-  - **Status:** `deletedFilesFromGit` ist leer; kein Problem, da nicht-geparste Dateien einfach beibehalten werden
-  - **Zukünftige Erweiterung:** Git-Status auswerten für explizite Deletion
-
-## Design-Entscheidungen
-
-### Alternative 1: Union vor den Fallbacks
-- **Verworfen:** Fallbacks könnten Union-Daten überschreiben; unsauber
-
-### Alternative 2: Dependencies direkt in Index persistieren (kein separater Cache)
-- **Verworfen:** Index ist Symbol-zentriert; separater Dependencies-Cache ist klarer (ADR 009)
-
-### Alternative 3: Vollständige Signatur-Rekonstruktion aus Index
-- **Verworfen:** Index enthält nicht alle Signatur-Details; würde Breaking Change erfordern
-- **Gewählt:** Vereinfachte Rekonstruktion reicht für Union; stabil via `symbol_id`
-
-## Nächste Schritte
-
-1. ✅ **Phase 1.1-1.3 + Phase 2 abgeschlossen**
-2. ⏭️ **Phase 1.4:** Unit-Tests für dependencies-cache, consolidation; Zweilauf-Test
-3. ⏭️ **Phase 3:** Modul-Dokumente mit Änderungs-Kommentaren
-
-## Referenzen
-
-- **Plan:** `ADDITIVE_DOCUMENTATION_PLAN.md`, Abschnitt 6.2-6.5, 7 (Phase 1.3 + Phase 2)
-- **ADR 008:** Dependencies-Cache
-- **ADR 009:** Union-Logik (Consolidation)
-- **Dokumentation:**
-  - `docs/modules/src__extension.ts.md`
-  - `docs/modules/src__core__git.ts.md`
-  - `docs/modules/src__index__index.ts.md`
-  - `docs/system/DEPENDENCIES.md`
-- **Cursor-Regeln:** `.cursor/rules/architecture-guardrails.mdc`, Abschnitt 0
-
-## Implementierung
-
-**Datei:** `src/extension.ts`
-
-**Geänderte Zeilen:** ~80 (Union-Block + Verwendungen)  
-**Neue Imports:** 2 (dependencies-cache, consolidation)  
-**Neue Variablen:** `dependenciesUnion`, `symbolsUnion`, `parsedFiles`, `deletedFilesFromGit`, `symbolsPrev`
-
-**Qualität:**
-- ✅ Linter-Fehler minimal (vorhandene Cognitive Complexity unverändert; unused imports entfernt)
-- ✅ Rückwärtskompatibel (Fallback auf leere Arrays)
-- ✅ Logging transparent
-- ✅ Dependencies-Cache deterministisch gespeichert
-
-**Logging-Output (Beispiel):**
-```
-[union] Dependencies: 12 neu + 458 gecacht → 470 Union
-[union] Symbole: 45 neu + 210 gecacht → 255 Union
-[generate] Gescannt: 15, Symbole: 255, Dependencies: 470, Dateien: 29, Dauer: 1234ms
-```
-
-
-
-
-
-