@noyrax/documentation-system-plugin 1.0.4-beta.1

package/docs/system/DEPENDENCY_GRAPH.md

@@ -0,0 +1,368 @@
+```mermaid
+graph TD
+    N0["../cache/ast-cache"]
+    N1["../cache/dependencies-cache"]
+    N2["../cache/output-cache"]
+    N3["../cache/signature-cache"]
+    N4["../constants.js"]
+    N5["../core/consolidation"]
+    N6["../core/git"]
+    N7["../core/scanner"]
+    N8["../core/signature-formatter"]
+    N9["../core/symbol-classifier"]
+    N10["../core/symbols"]
+    N11["../drift/index"]
+    N12["../generator/change-report"]
+    N13["../generator/dependency-graph"]
+    N14["../generator/index"]
+    N15["../index/index"]
+    N16["../logging/index"]
+    N17["../parsers/dependencies"]
+    N18["../parsers/json-yaml"]
+    N19["../parsers/python"]
+    N20["../parsers/ts-js"]
+    N21["../parsers/types"]
+    N22["../types.js"]
+    N23["../validator/index"]
+    N24["./adr-linker"]
+    N25["./cache/ast-cache"]
+    N26["./cache/dependencies-cache"]
+    N27["./cache/output-cache"]
+    N28["./cache/signature-cache"]
+    N29["./cli/init.js"]
+    N30["./cli/update.js"]
+    N31["./constants.js"]
+    N32["./core/async"]
+    N33["./core/consolidation"]
+    N34["./core/git"]
+    N35["./core/scanner"]
+    N36["./drift/index"]
+    N37["./generator/change-report"]
+    N38["./generator/dependency-graph"]
+    N39["./generator/index"]
+    N40["./index/index"]
+    N41["./init.js"]
+    N42["./language-detection"]
+    N43["./mcp/server.js"]
+    N44["./mcp/types.js"]
+    N45["./module-doc"]
+    N46["./parsers/dependencies"]
+    N47["./parsers/json-yaml"]
+    N48["./parsers/python"]
+    N49["./parsers/ts-js"]
+    N50["./parsers/types"]
+    N51["./resources/docs.js"]
+    N52["./signature-matching"]
+    N53["./status"]
+    N54["./symbols"]
+    N55["./tools/drift.js"]
+    N56["./tools/impact.js"]
+    N57["./tools/scan.js"]
+    N58["./tools/validate.js"]
+    N59["./tools/verify-adrs.js"]
+    N60["./types"]
+    N61["./types.js"]
+    N62["./ui/commands-provider"]
+    N63["./ui/status-bar"]
+    N64["./update.js"]
+    N65["./validator/index"]
+    N66["./validator/status"]
+    N67["_jest/globals"]
+    N68["_modelcontextprotocol/sdk/server"]
+    N69["_modelcontextprotocol/sdk/server/mcp.js"]
+    N70["_modelcontextprotocol/sdk/server/stdio.js"]
+    N71["_modelcontextprotocol/sdk/types.js"]
+    N72["child_process"]
+    N73["commander"]
+    N74["crypto"]
+    N75["fs"]
+    N76["ignore"]
+    N77["mcp/src/resources/docs.ts"]
+    N78["mcp/src/server.ts"]
+    N79["mcp/src/tools/drift.ts"]
+    N80["mcp/src/tools/impact.ts"]
+    N81["mcp/src/tools/scan.ts"]
+    N82["mcp/src/tools/validate.ts"]
+    N83["mcp/src/tools/verify-adrs.ts"]
+    N84["node_child_process"]
+    N85["node_fs"]
+    N86["node_fs/promises"]
+    N87["node_path"]
+    N88["node_readline"]
+    N89["node_url"]
+    N90["node_util"]
+    N91["os"]
+    N92["packages/doc-system-agent/src/cli/index.ts"]
+    N93["packages/doc-system-agent/src/cli/init.ts"]
+    N94["packages/doc-system-agent/src/cli/update.ts"]
+    N95["packages/doc-system-agent/src/index.ts"]
+    N96["packages/doc-system-agent/src/mcp/resources/docs.ts"]
+    N97["packages/doc-system-agent/src/mcp/server.ts"]
+    N98["packages/doc-system-agent/src/mcp/tools/drift.ts"]
+    N99["packages/doc-system-agent/src/mcp/tools/impact.ts"]
+    N100["packages/doc-system-agent/src/mcp/tools/scan.ts"]
+    N101["packages/doc-system-agent/src/mcp/tools/validate.ts"]
+    N102["packages/doc-system-agent/src/mcp/tools/verify-adrs.ts"]
+    N103["path"]
+    N104["src/__tests__/determinism.test.ts"]
+    N105["src/__tests__/parser-symbol-types.test.ts"]
+    N106["src/__tests__/setup.ts"]
+    N107["src/__tests__/signature-formatter.test.ts"]
+    N108["src/__tests__/snapshot-doc-generation.test.ts"]
+    N109["src/__tests__/symbol-classifier.test.ts"]
+    N110["src/cache/ast-cache.ts"]
+    N111["src/cache/dependencies-cache.ts"]
+    N112["src/cache/output-cache.ts"]
+    N113["src/cache/signature-cache.ts"]
+    N114["src/cli/generate-cli.ts"]
+    N115["src/cli/scan-cli.ts"]
+    N116["src/cli/validate-cli.ts"]
+    N117["src/core/consolidation.ts"]
+    N118["src/core/git.ts"]
+    N119["src/core/scanner.ts"]
+    N120["src/core/signature-formatter.ts"]
+    N121["src/core/symbol-classifier.ts"]
+    N122["src/core/symbols.ts"]
+    N123["src/drift/index.ts"]
+    N124["src/extension.ts"]
+    N125["src/generator/adr-linker.ts"]
+    N126["src/generator/dependency-graph.ts"]
+    N127["src/generator/index.ts"]
+    N128["src/generator/module-doc.ts"]
+    N129["src/index/index.ts"]
+    N130["src/parsers/dependencies.ts"]
+    N131["src/parsers/json-yaml.ts"]
+    N132["src/parsers/python.ts"]
+    N133["src/parsers/ts-js.ts"]
+    N134["src/ui/commands-provider.ts"]
+    N135["src/ui/status-bar.ts"]
+    N136["src/validator/index.ts"]
+    N137["src/validator/signature-matching.ts"]
+    N138["tree-sitter"]
+    N139["tree-sitter-python"]
+    N140["ts-morph"]
+    N141["vscode"]
+    N142["yaml"]
+
+    N100 --> N22
+    N100 --> N84
+    N100 --> N90
+    N101 --> N22
+    N101 --> N84
+    N101 --> N90
+    N102 --> N84
+    N102 --> N90
+    N104 --> N10
+    N104 --> N103
+    N104 --> N14
+    N104 --> N15
+    N104 --> N17
+    N104 --> N20
+    N104 --> N7
+    N104 --> N75
+    N104 --> N91
+    N105 --> N18
+    N105 --> N20
+    N105 --> N8
+    N106 --> N67
+    N107 --> N21
+    N107 --> N8
+    N108 --> N103
+    N108 --> N14
+    N108 --> N15
+    N108 --> N20
+    N108 --> N21
+    N108 --> N5
+    N108 --> N75
+    N108 --> N91
+    N109 --> N21
+    N109 --> N9
+    N110 --> N103
+    N110 --> N74
+    N110 --> N75
+    N111 --> N103
+    N111 --> N75
+    N112 --> N103
+    N112 --> N74
+    N112 --> N75
+    N113 --> N103
+    N113 --> N75
+    N114 --> N0
+    N114 --> N1
+    N114 --> N103
+    N114 --> N11
+    N114 --> N12
+    N114 --> N13
+    N114 --> N14
+    N114 --> N15
+    N114 --> N17
+    N114 --> N18
+    N114 --> N19
+    N114 --> N2
+    N114 --> N20
+    N114 --> N21
+    N114 --> N3
+    N114 --> N5
+    N114 --> N6
+    N114 --> N7
+    N114 --> N75
+    N115 --> N103
+    N115 --> N18
+    N115 --> N19
+    N115 --> N20
+    N115 --> N21
+    N115 --> N7
+    N115 --> N75
+    N116 --> N103
+    N116 --> N15
+    N116 --> N18
+    N116 --> N19
+    N116 --> N20
+    N116 --> N21
+    N116 --> N23
+    N116 --> N7
+    N116 --> N75
+    N117 --> N1
+    N117 --> N17
+    N117 --> N21
+    N117 --> N54
+    N118 --> N72
+    N119 --> N16
+    N119 --> N42
+    N119 --> N76
+    N119 --> N85
+    N119 --> N87
+    N120 --> N21
+    N121 --> N21
+    N122 --> N21
+    N122 --> N74
+    N123 --> N10
+    N123 --> N21
+    N123 --> N3
+    N124 --> N103
+    N124 --> N141
+    N124 --> N25
+    N124 --> N26
+    N124 --> N27
+    N124 --> N28
+    N124 --> N32
+    N124 --> N33
+    N124 --> N34
+    N124 --> N35
+    N124 --> N36
+    N124 --> N37
+    N124 --> N38
+    N124 --> N39
+    N124 --> N40
+    N124 --> N46
+    N124 --> N47
+    N124 --> N48
+    N124 --> N49
+    N124 --> N50
+    N124 --> N62
+    N124 --> N63
+    N124 --> N65
+    N124 --> N66
+    N124 --> N75
+    N125 --> N85
+    N125 --> N87
+    N126 --> N17
+    N127 --> N21
+    N127 --> N24
+    N127 --> N45
+    N127 --> N85
+    N127 --> N87
+    N128 --> N21
+    N128 --> N24
+    N128 --> N8
+    N128 --> N9
+    N129 --> N1
+    N129 --> N10
+    N129 --> N103
+    N129 --> N21
+    N129 --> N75
+    N130 --> N140
+    N131 --> N103
+    N131 --> N142
+    N131 --> N60
+    N132 --> N103
+    N132 --> N138
+    N132 --> N139
+    N132 --> N60
+    N133 --> N103
+    N133 --> N140
+    N133 --> N60
+    N134 --> N141
+    N135 --> N141
+    N136 --> N103
+    N136 --> N16
+    N136 --> N21
+    N136 --> N52
+    N136 --> N53
+    N136 --> N75
+    N137 --> N21
+    N137 --> N8
+    N137 --> N9
+    N77 --> N86
+    N77 --> N87
+    N78 --> N51
+    N78 --> N55
+    N78 --> N56
+    N78 --> N57
+    N78 --> N58
+    N78 --> N59
+    N78 --> N68
+    N78 --> N70
+    N78 --> N71
+    N79 --> N84
+    N79 --> N86
+    N79 --> N87
+    N79 --> N90
+    N80 --> N85
+    N80 --> N87
+    N80 --> N88
+    N81 --> N84
+    N81 --> N90
+    N82 --> N84
+    N82 --> N90
+    N83 --> N84
+    N83 --> N90
+    N92 --> N4
+    N92 --> N41
+    N92 --> N64
+    N92 --> N73
+    N93 --> N4
+    N93 --> N86
+    N93 --> N87
+    N93 --> N89
+    N94 --> N4
+    N94 --> N86
+    N94 --> N87
+    N94 --> N89
+    N95 --> N29
+    N95 --> N30
+    N95 --> N31
+    N95 --> N43
+    N95 --> N44
+    N96 --> N86
+    N96 --> N87
+    N97 --> N51
+    N97 --> N55
+    N97 --> N56
+    N97 --> N57
+    N97 --> N58
+    N97 --> N59
+    N97 --> N61
+    N97 --> N69
+    N97 --> N70
+    N97 --> N71
+    N98 --> N22
+    N98 --> N84
+    N98 --> N86
+    N98 --> N87
+    N98 --> N90
+    N99 --> N22
+    N99 --> N85
+    N99 --> N87
+    N99 --> N88
+```

package/docs/system/NAVIGATION_SPACE_ANALYSIS.md

@@ -0,0 +1,244 @@
+# Mehrdimensionaler Navigationsraum - Analyse
+
+**Zweck:** Analyse, ob das aktuelle System als mehrdimensionaler Navigationsraum für KI-Agenten funktioniert
+
+## Frage
+
+> "Das Ziel war es, die ADRs als Wissensquelle zu nutzen und die docs/modules, docs/index und docs/system als Koordinaten zu sehen, damit sich ein Agent oder eine KI in einem mehrdimensionalen Raum bewegen kann. Funktioniert das momentan auf dem aktuellen Systemstand?"
+
+## Antwort: ✅ JA, mit Einschränkungen
+
+### Was funktioniert
+
+#### 1. Koordinaten-System existiert ✅ (ADR-024)
+
+Das Documentation-System-Plugin generiert bereits ein **funktionierendes Koordinaten-System** mit 5 Dimensionen:
+
+| Dimension | Artefakt | Status | Zugriff |
+|-----------|----------|--------|---------|
+| **Modul-Raum (X)** | `docs/modules/*.md` | ✅ 71 Module | `docs://modules/{path}` |
+| **Symbol-Raum (Y)** | `docs/index/symbols.jsonl` | ✅ 445 Zeilen | `docs://index/symbols.jsonl` |
+| **Beziehungs-Raum (Z)** | `docs/system/DEPENDENCY_GRAPH.md` | ✅ 127 Knoten | `docs://system/graph` |
+| **Wissens-Raum (W)** | `docs/adr/*.md` | ✅ 26 ADRs | `docs://adr/{name}` |
+| **Zeit-Raum (T)** | `docs/system/CHANGE_REPORT.md` | ✅ Implementiert | `docs://system/changes` |
+
+**Zeit-Dimension (T):**
+- Change Report zeigt neu hinzugefügte/geänderte Symbole
+- Dependency-Änderungen werden erfasst
+- Ermöglicht Änderungsmuster zu erkennen
+- Integration mit Database Plugin (ADR-034): Change-Records in Workspace-DB
+
+#### 2. MCP-Server ermöglicht Agent-Zugriff ✅ (ADR-025)
+
+Der MCP-Server (`mcp/` und `packages/doc-system-agent/`) bietet strukturierte Zugriffe:
+
+**Resources (99 insgesamt):**
+- 4 System-Resources: `graph`, `dependencies`, `changes`, `symbols.jsonl`
+- 71 Modul-Resources: `docs://modules/{path}`
+- 24 ADR-Resources: `docs://adr/{name}`
+
+**Tools:**
+```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: '...' })
+```
+
+#### 3. Database Plugin persistiert Koordinaten ✅
+
+Der Database Plugin liest die `docs/` Artefakte und persistiert sie in SQLite (Hybrid-Architektur, ADR-035):
+- **Registry-DB**: Plugin-Registrierungen (global)
+- **Workspace-DB**: Workspace-spezifische Daten
+  - Symbole mit Metadaten
+  - Dependencies mit Beziehungen
+  - Snapshots für Zeitvergleiche
+  - **ADR-Verknüpfungen** (neu, ADR-034)
+  - **Change-Records** (neu, ADR-034)
+
+#### 4. Semantic Brain Plugin berechnet Intelligence 🔄
+
+Das Semantic Brain Plugin transformiert die Rohdaten in semantische Strukturen:
+- Graph mit Nodes & Edges
+- Embeddings für Similarity
+- Centrality-Metriken
+
+**Einschränkung:** APIs fehlen noch für direkten Agent-Zugriff
+
+### Was noch fehlt
+
+#### 1. Semantic Brain APIs ❌
+
+Die Semantic Brain APIs (`graph-api.ts`, `similarity-api.ts`, etc.) sind noch nicht implementiert, daher können Agenten noch nicht direkt:
+- Graph-Nachbarschaften abrufen
+- Ähnliche Symbole finden
+- Semantische Suche durchführen
+
+#### 2. Context/RAG Plugin ❌
+
+Das Context/RAG Plugin, das die semantischen Daten für AI-Agenten aufbereitet, ist noch nicht implementiert.
+
+#### 3. Bidirektionale ADR-Verknüpfung ✅ (ADR-034)
+
+ADR-034 implementiert vollständige ADR-Verknüpfungen:
+- ✅ Module → ADR: `getAdrsForModule(moduleFilePath)` - Welche ADRs betreffen ein Modul?
+- ✅ ADR → Module: `getModulesForAdr(adrId)` - Welche Module betreffen ein ADR?
+- ✅ Persistiert in Workspace-DB (`adr_relations` Tabelle)
+
+## Funktionsweise
+
+### Beispiel: Agent möchte Parser-Module verstehen
+
+```typescript
+// 1. Modul-Raum: Parser-Module finden
+const parserModules = await listModuleDocs()
+  .then(files => files.filter(f => f.includes('parser')));
+
+// 2. Symbol-Raum: Symbole in Parser-Modulen analysieren
+const symbols = await readDocsResource('docs://index/symbols.jsonl')
+  .then(content => content.split('\n')
+    .map(line => JSON.parse(line))
+    .filter(s => parserModules.some(m => s.path.includes(m))));
+
+// 3. Beziehungs-Raum: Dependencies verstehen
+const graph = await readDocsResource('docs://system/graph');
+// Mermaid-Graph zeigt: parser → core → symbols
+
+// 4. Wissens-Raum: Architektur-Entscheidungen lesen
+// Via MCP-Server (ADR-023): ADR-Links direkt in Modul-Doku
+const adrs = await readDocsResource('docs://modules/src__parsers__ts-js.ts.md')
+  .then(content => {
+    // ADR-Links extrahieren (ADR-023)
+    const adrMatches = content.match(/\[ADR-\d+.*?\]\(.*?\)/g);
+    return adrMatches || [];
+  });
+// Oder via Database Plugin (ADR-034):
+const adrs = await databaseApi.getAdrsForModule('src/parsers/ts-js.ts');
+
+// 5. Zeit-Raum: Änderungen analysieren (Change Report)
+// Via MCP-Server:
+const changeReport = await readDocsResource('docs://system/changes');
+// Via Database Plugin (ADR-034):
+const changes = await databaseApi.getRecentChanges(snapshotId);
+const addedSymbols = await databaseApi.getChangesByType(snapshotId, 'added');
+const fileChanges = await databaseApi.getChangesForFile('src/parsers/ts-js.ts');
+
+// 6. Impact-Analyse: Was würde eine Änderung beeinflussen?
+const impact = await analyzeImpact({
+  file: 'src/parsers/ts-js.ts',
+  symbol: 'TsJsParser'
+});
+// Zeigt: directDependents, transitiveDependents, impactLevel
+```
+
+### Beispiel: Semantische Suche (geplant)
+
+```typescript
+// Mit Semantic Brain APIs (noch zu implementieren):
+const similar = await semanticBrain.findSimilarNodes({
+  nodeId: 'parser-ts-js',
+  similarityTypes: ['structural', 'semantic'],
+  minSimilarity: 0.7,
+  limit: 10
+});
+
+// Mit Context/RAG Plugin (geplant):
+const context = await ragEngine.assembleContext({
+  query: 'How do parsers work?',
+  scope: { filePaths: ['src/parsers/**'] },
+  intent: 'explanation'
+});
+```
+
+## Fazit
+
+### ✅ Funktioniert bereits
+
+1. **Koordinaten-System** - Alle 5 Dimensionen existieren (ADR-024)
+   - Modul-Raum (X), Symbol-Raum (Y), Beziehungs-Raum (Z), Wissens-Raum (W), Zeit-Raum (T)
+2. **MCP-Server Zugriff** - 99 Resources für strukturierte APIs (ADR-025)
+   - CLI-Bridge-Pattern für Scan/Validate
+   - Dynamisches Laden von Modulen und ADRs
+3. **Impact-Analyse** - Dependency-Traversierung funktioniert
+4. **ADR-Verknüpfung** - ✅ Vollständig implementiert (ADR-023, ADR-034)
+   - Module → ADR: Automatisch in Modul-Doku eingefügt (ADR-023)
+   - Module → ADR: `getAdrsForModule()` via Database Plugin (ADR-034)
+   - ADR → Module: `getModulesForAdr()` via Database Plugin (ADR-034)
+5. **Change-Records** - ✅ Implementiert (ADR-034)
+   - Symbol-Änderungen (added/modified/removed)
+   - Change-Report-Integration
+   - Zeit-Dimension für Änderungsmuster
+6. **Hybrid-Datenbank-Architektur** - ✅ Implementiert (ADR-035)
+   - Registry-DB für Plugin-Registrierungen
+   - Workspace-DB für Plugin-Daten
+   - Automatische Migration
+7. **Semantische Features** - ✅ Implementiert (ADR-020, ADR-021, ADR-022)
+   - SignatureFormatter: Zentrale Signatur-Formatierung
+   - SymbolClassifier: Rollenbasierte Doku-Tiefe und Validierung
+   - Semantisches Rendering: Klassen und Konstanten strukturiert
+8. **Reality-Driven Development** - ✅ Implementiert (ADR-026)
+   - Verification-Scripts: Architektur, ADRs, Imports
+   - Pre-Commit Hooks und CI/CD Integration
+   - Evidence-basierte Claims
+
+### 🔄 In Arbeit
+
+1. **Semantic Brain APIs** - Graph- und Similarity-Zugriff fehlt noch
+
+### ❌ Noch nicht implementiert
+
+1. **Context/RAG Plugin** - AI-Agent Integration fehlt
+2. **Semantische Suche** - Ähnlichkeits-basierte Navigation fehlt
+
+## Empfehlung
+
+Das System **funktioniert bereits** als mehrdimensionaler Navigationsraum für **grundlegende und erweiterte Navigation**:
+
+- ✅ Modul-Navigation (docs/modules) - Mit ADR-Links und semantischem Rendering
+- ✅ Symbol-Navigation (docs/index/symbols.jsonl) - Mit Dependencies
+- ✅ Dependency-Navigation (docs/system/DEPENDENCY_GRAPH.md) - 127 Knoten
+- ✅ Wissens-Navigation (docs/adr) - 26 ADRs automatisch verknüpft
+- ✅ Zeit-Navigation (docs/system/CHANGE_REPORT.md) - Änderungsmuster erkennbar
+- ✅ MCP-Server-Integration - 99 Resources für strukturierten Zugriff
+- ✅ Semantische Klassifizierung - Rollenbasierte Doku-Tiefe und Validierung
+- ✅ Reality-Driven Development - Verification-Loops verhindern Halluzinationen
+
+Für **erweiterte semantische Navigation** müssen noch implementiert werden:
+
+- 🔄 Semantic Brain APIs - Graph- und Similarity-Zugriff fehlt noch
+- ❌ Context/RAG Plugin - AI-Agent Integration fehlt
+
+**Priorität:** Semantic Brain APIs implementieren, damit Agenten Graph- und Similarity-Zugriff haben.
+
+---
+
+**Referenzen:**
+- Systemanalyse: `docs/system/SYSTEM_ANALYSIS.md` - Umfassende Systemanalyse mit Diagrammen
+- Plugin-Ecosystem Status: `docs/system/PLUGIN_ECOSYSTEM_STATUS.md`
+- MVP-Pläne Update Guide: `docs/system/MVP_PLANS_UPDATE_GUIDE.md`
+- ADR-020: `docs/adr/020-api-doc-tiefe-und-signatureformatter.md` - SignatureFormatter
+- ADR-021: `docs/adr/021-semantic-api-docs-and-symbol-classifier.md` - SymbolClassifier
+- ADR-022: `docs/adr/022-semantic-class-and-constants-rendering.md` - Semantisches Rendering
+- ADR-023: `docs/adr/023-adr-verknuepfung-modul-doku.md` - ADR-Linking
+- ADR-024: `docs/adr/024-cursor-rules-mehrdimensionaler-raum.md` - Mehrdimensionaler Raum
+- ADR-025: `docs/adr/025-mcp-tools-scan-validate-cli-bridge.md` - MCP-Server CLI-Bridge
+- ADR-026: `docs/adr/026-reality-driven-development-system.md` - Reality-Driven Development
+- ADR-034: `docs/adr/034-adr-change-integration.md` (Database Plugin: ADR- und Change-Integration)
+- ADR-035: `docs/adr/035-hybrid-database-architecture.md` (Database Plugin: Hybrid-Datenbank-Architektur)
+

package/docs/system/NPX_CACHE_FIX.md

@@ -0,0 +1,85 @@
+# NPX Cache Problem - Lösung
+
+**Problem:** `npx @noyrax/cli update-rules` gibt "unknown command" zurück, obwohl der Command existiert.
+
+## Ursache
+
+NPX verwendet eine **gecachte Version** des Packages aus dem npm-Cache. Wenn das Package lokal aktualisiert wurde, aber noch nicht auf npm veröffentlicht wurde, verwendet npx die alte Version.
+
+## Lösungen
+
+### Lösung 1: NPX Cache leeren
+
+```bash
+# NPX Cache leeren
+npx clear-npx-cache
+
+# Oder manuell
+rm -rf ~/.npm/_npx
+```
+
+Dann erneut versuchen:
+```bash
+npx @noyrax/cli update-rules
+```
+
+### Lösung 2: Lokales Package verwenden (für Entwicklung)
+
+Wenn das Package lokal gebaut wurde, aber noch nicht veröffentlicht:
+
+```bash
+# Im documentation-system-plugin Verzeichnis
+cd packages/doc-system-agent
+npm link
+
+# Im database-plugin Verzeichnis
+cd D:\Extensions\database-plugin
+npm link @noyrax/cli
+
+# Dann verwenden
+npx @noyrax/cli update-rules
+```
+
+### Lösung 3: Direktes Ausführen (wenn lokal verfügbar)
+
+```bash
+# Wenn das Package lokal gebaut wurde
+node D:\Extensions\documentation-system-plugin\packages\doc-system-agent\dist\cli\index.js update-rules
+```
+
+### Lösung 4: Package-Version erzwingen
+
+```bash
+# Spezifische Version verwenden
+npx @noyrax/cli@1.1.0 update-rules
+
+# Oder neueste Version erzwingen
+npx -y @noyrax/cli@latest update-rules
+```
+
+## Verifizierung
+
+Prüfe, welche Version npx verwendet:
+
+```bash
+# Version prüfen
+npx @noyrax/cli info
+
+# Sollte zeigen:
+# Package-Version: 1.1.0
+# Rules-Version: 2
+```
+
+Wenn noch Version 1.0.0 angezeigt wird, verwendet npx eine alte Version.
+
+## Empfehlung
+
+Für lokale Entwicklung:
+1. Package lokal linken (`npm link`)
+2. Oder direkt aus dem dist-Verzeichnis ausführen
+
+Für Produktion:
+1. Package auf npm veröffentlichen
+2. NPX Cache leeren
+3. Dann `npx @noyrax/cli update-rules` verwenden
+