noyrax-doc-cli 1.0.0

package/LOCAL_USAGE.md

@@ -0,0 +1,205 @@
+# Lokale Verwendung von @noyrax/doc-cli
+
+Da das Package noch nicht in npm veröffentlicht ist, gibt es mehrere Möglichkeiten, es lokal zu verwenden:
+
+## Option 1: npm link (Empfohlen für Entwicklung)
+
+### Schritt 1: Package verlinken
+
+```bash
+# Im noyrax-doc-cli Verzeichnis
+cd noyrax-doc-cli
+npm link
+```
+
+### Schritt 2: In Ihrem Projekt verwenden
+
+```bash
+# In Ihrem Projekt-Verzeichnis
+cd /path/to/your/project
+
+# Package verlinken
+npm link @noyrax/doc-cli
+
+# noyrax Package installieren (falls noch nicht vorhanden)
+npm install noyrax
+
+# Jetzt können Sie die Commands verwenden
+noyrax-scan
+noyrax-validate
+noyrax-verify-all
+```
+
+## Option 2: Direkter Pfad (ohne npm link)
+
+### In package.json Ihres Projekts
+
+```json
+{
+  "devDependencies": {
+    "@noyrax/doc-cli": "file:../noyrax-doc-cli",
+    "noyrax": "^1.0.4"
+  }
+}
+```
+
+Dann:
+```bash
+npm install
+noyrax-scan
+```
+
+## Option 3: Direkt mit node aufrufen
+
+Sie können die Scripts auch direkt mit node aufrufen:
+
+```bash
+# Von Ihrem Projekt-Verzeichnis aus
+node ../noyrax-doc-cli/bin/noyrax-scan.js
+node ../noyrax-doc-cli/bin/noyrax-validate.js
+```
+
+## Option 4: Relative Pfade in package.json Scripts
+
+```json
+{
+  "scripts": {
+    "docs:scan": "node ../noyrax-doc-cli/bin/noyrax-scan.js",
+    "docs:validate": "node ../noyrax-doc-cli/bin/noyrax-validate.js",
+    "docs:verify": "node ../noyrax-doc-cli/bin/noyrax-verify-all.js"
+  }
+}
+```
+
+## Option 5: Globale Installation (nicht empfohlen)
+
+```bash
+# Im noyrax-doc-cli Verzeichnis
+cd noyrax-doc-cli
+npm install -g .
+
+# Jetzt überall verfügbar
+noyrax-scan
+```
+
+## Empfohlener Workflow für lokale Entwicklung
+
+### 1. Setup einmalig
+
+```bash
+# Im noyrax-doc-cli Verzeichnis
+cd noyrax-doc-cli
+npm link
+```
+
+### 2. In jedem neuen Projekt
+
+```bash
+# In Ihrem Projekt
+npm link @noyrax/doc-cli
+npm install noyrax
+
+# Commands verwenden
+noyrax-scan
+noyrax-validate
+```
+
+### 3. Unlink (wenn nicht mehr benötigt)
+
+```bash
+# Im Projekt
+npm unlink @noyrax/doc-cli
+
+# Im noyrax-doc-cli Verzeichnis (optional)
+npm unlink
+```
+
+## Wichtige Hinweise
+
+### noyrax Package muss kompiliert sein
+
+Das `noyrax` Package muss kompiliert sein, damit die CLI-Scripts funktionieren:
+
+```bash
+# Im noyrax Package-Verzeichnis
+cd documentation-system-plugin
+npm run compile
+```
+
+### Pfad-Anpassung für lokale Entwicklung
+
+Falls Sie das Package in einem anderen Verzeichnis haben, müssen Sie die Pfade in den bin-Scripts anpassen. Die Scripts suchen automatisch nach:
+1. `node_modules/noyrax` (wenn als npm-Package installiert)
+2. Relativer Pfad `../documentation-system-plugin` (für lokale Entwicklung)
+
+## Testen der Installation
+
+```bash
+# Prüfen ob Commands verfügbar sind
+which noyrax-scan  # Linux/Mac
+where noyrax-scan  # Windows
+
+# Oder direkt testen
+noyrax-scan --help  # Sollte Fehler zeigen, aber Command wird gefunden
+```
+
+## Fehlerbehebung
+
+### "Could not find noyrax package"
+
+**Problem:** Das noyrax Package wird nicht gefunden.
+
+**Lösung 1:** Relativen Pfad prüfen
+```bash
+# Prüfen ob documentation-system-plugin existiert
+ls ../documentation-system-plugin/package.json
+```
+
+**Lösung 2:** noyrax installieren
+```bash
+npm install noyrax
+```
+
+### "Script not found"
+
+**Problem:** Das noyrax Package ist nicht kompiliert.
+
+**Lösung:**
+```bash
+cd documentation-system-plugin
+npm run compile
+```
+
+### "Command not found" (nach npm link)
+
+**Problem:** npm link wurde nicht korrekt ausgeführt.
+
+**Lösung:**
+```bash
+# Im noyrax-doc-cli Verzeichnis
+npm link
+
+# Im Projekt-Verzeichnis
+npm link @noyrax/doc-cli
+
+# Prüfen
+npm list -g --depth=0 | grep noyrax
+```
+
+## Für die Veröffentlichung
+
+Wenn Sie das Package später in npm veröffentlichen möchten:
+
+```bash
+# 1. Version setzen
+npm version patch  # oder minor, major
+
+# 2. Veröffentlichen
+npm publish --access public
+
+# 3. Dann können andere es installieren mit:
+npm install -D @noyrax/doc-cli noyrax
+```
+
+**Hinweis:** Sie benötigen einen npm-Account und müssen dem `@noyrax` Scope beitreten.
+

package/PUBLISH_INSTRUCTIONS.md

@@ -0,0 +1,68 @@
+# Anleitung: Package veröffentlichen mit Granular Access Token
+
+Da npm für Scoped Packages (`@noyrax/*`) 2FA oder einen Granular Access Token mit "Bypass 2FA" erfordert, hier die Anleitung:
+
+## Schritt 1: Granular Access Token erstellen
+
+1. Gehen Sie zu: https://www.npmjs.com/settings/benjaminbehrens/tokens
+2. Klicken Sie auf **"Generate New Token"** → **"Granular Access Token"**
+3. Konfigurieren Sie den Token:
+   - **Token Name**: z.B. "doc-cli-publish"
+   - **Expiration**: Wählen Sie eine Ablaufzeit (z.B. "90 days" oder "No expiration")
+   - **Package Access**: 
+     - Wählen Sie **"Select packages"**
+     - Wählen Sie **`@noyrax/doc-cli`** (oder `@noyrax/*` für alle Packages)
+   - **Permissions**: 
+     - ✅ **"Read and Publish"** aktivieren
+   - **Bypass 2FA**: 
+     - ✅ **"Bypass 2FA"** aktivieren (wichtig!)
+4. Klicken Sie auf **"Generate Token"**
+5. **Kopieren Sie den Token sofort** (er wird nur einmal angezeigt!)
+
+## Schritt 2: Token konfigurieren
+
+```bash
+# Token setzen (ersetzt <IHR_TOKEN> mit dem kopierten Token)
+npm config set //registry.npmjs.org/:_authToken <IHR_TOKEN>
+```
+
+**Oder temporär für einen Befehl:**
+```bash
+npm publish --access public --//registry.npmjs.org/:_authToken=<IHR_TOKEN>
+```
+
+## Schritt 3: Package veröffentlichen
+
+```bash
+cd noyrax-doc-cli
+npm publish --access public
+```
+
+## Alternative: Package ohne Scope veröffentlichen
+
+Falls Sie keinen Granular Access Token erstellen können, können Sie das Package auch ohne Scope veröffentlichen:
+
+1. In `package.json` den Namen ändern:
+   ```json
+   {
+     "name": "noyrax-doc-cli"  // statt "@noyrax/doc-cli"
+   }
+   ```
+
+2. Dann veröffentlichen:
+   ```bash
+   npm publish
+   ```
+
+**Nachteil:** Das Package wäre dann unter `noyrax-doc-cli` statt `@noyrax/doc-cli` verfügbar.
+
+## Verifikation
+
+Nach der Veröffentlichung können Sie prüfen:
+```bash
+npm view @noyrax/doc-cli
+```
+
+Oder im Browser:
+https://www.npmjs.com/package/@noyrax/doc-cli
+

package/README.md

@@ -0,0 +1,233 @@
+# @noyrax/doc-cli
+
+Standalone CLI für Noyrax Documentation System - Scan, Validate, Generate, Verify
+
+## Überblick
+
+Dieses Package stellt alle CLI-Befehle des Noyrax Documentation System als eigenständige, installierbare Commands zur Verfügung. Es nutzt nur das `noyrax` (documentation-system-plugin) Package als Dependency und funktioniert ohne Database- oder Semantic-Brain-Plugins.
+
+## Installation
+
+```bash
+npm install -D @noyrax/doc-cli noyrax
+```
+
+**Wichtig:** Das `noyrax` Package muss ebenfalls installiert sein, da es als Peer-Dependency verwendet wird.
+
+## Verfügbare Commands
+
+### Dokumentations-Generierung
+
+#### `noyrax-scan`
+Führt einen vollständigen Scan durch und generiert die Dokumentation.
+
+```bash
+noyrax-scan
+```
+
+**Funktionalität:**
+- Scannt das Projekt nach TypeScript/JavaScript/Python-Dateien
+- Extrahiert Symbole (Funktionen, Klassen, Interfaces, etc.)
+- Generiert Modul-Dokumentation in `docs/modules/`
+- Erstellt Symbol-Index in `docs/index/symbols.jsonl`
+- Generiert Dependency-Graph in `docs/system/DEPENDENCY_GRAPH.md`
+- Erstellt Change Report in `docs/system/CHANGE_REPORT.md`
+
+#### `noyrax-generate`
+Generiert nur die Dokumentation (ohne Scan).
+
+```bash
+noyrax-generate
+```
+
+**Verwendung:** Wenn bereits gescannt wurde und nur die Dokumentation aktualisiert werden soll.
+
+### Validierung
+
+#### `noyrax-validate`
+Validiert die Dokumentation gegen den Code.
+
+```bash
+noyrax-validate
+```
+
+**Funktionalität:**
+- Prüft Signatur-Übereinstimmung zwischen Code und Dokumentation
+- Prüft Coverage (welche Symbole sind dokumentiert)
+- Erkennt veraltete Dokumentation
+- Gibt Exit-Code zurück:
+  - `0` = Alles valide
+  - `1` = Warnungen (z.B. fehlende Docs)
+  - `2` = Fehler (z.B. Signatur-Mismatch)
+
+### Verification
+
+#### `noyrax-verify-adrs`
+Prüft ADR-Claims gegen den Code.
+
+```bash
+noyrax-verify-adrs
+```
+
+**Funktionalität:**
+- Prüft, ob in ADRs erwähnte Dateien existieren
+- Prüft, ob in ADRs erwähnte Funktionen existieren
+- Erkennt veraltete ADR-Claims
+
+**Optionen:**
+```bash
+noyrax-verify-adrs --verbose  # Ausführliche Ausgabe mit Warnungen
+```
+
+#### `noyrax-verify-architecture`
+Prüft Architektur-Regeln.
+
+```bash
+noyrax-verify-architecture
+```
+
+**Funktionalität:**
+- Prüft Import-Richtungen
+- Erkennt zirkuläre Abhängigkeiten
+- Validiert Modul-Struktur
+
+#### `noyrax-verify-imports`
+Prüft Import-Verfügbarkeit.
+
+```bash
+noyrax-verify-imports
+```
+
+**Funktionalität:**
+- Prüft, ob alle Imports verfügbar sind
+- Erkennt fehlende Dependencies
+- Validiert Import-Pfade
+
+#### `noyrax-verify-all`
+Führt alle Verification-Checks aus.
+
+```bash
+noyrax-verify-all
+```
+
+**Funktionalität:**
+- Führt `verify-architecture`, `verify-adrs` und `verify-imports` nacheinander aus
+- Gibt Exit-Code `1` zurück, wenn ein Check fehlschlägt
+
+## Workflow-Integration
+
+### Standard-Workflow
+
+```bash
+# 1. Dokumentation generieren
+noyrax-scan
+
+# 2. Dokumentation validieren
+noyrax-validate
+
+# 3. Verification-Checks
+noyrax-verify-all
+```
+
+### In package.json Scripts
+
+```json
+{
+  "scripts": {
+    "docs:scan": "noyrax-scan",
+    "docs:validate": "noyrax-validate",
+    "docs:verify": "noyrax-verify-all",
+    "docs:full": "noyrax-scan && noyrax-validate && noyrax-verify-all"
+  }
+}
+```
+
+Dann können Sie verwenden:
+```bash
+npm run docs:scan
+npm run docs:validate
+npm run docs:verify
+npm run docs:full
+```
+
+### Mit npx (ohne Installation)
+
+```bash
+npx @noyrax/doc-cli noyrax-scan
+npx @noyrax/doc-cli noyrax-validate
+npx @noyrax/doc-cli noyrax-verify-all
+```
+
+## Cursor Rules Integration
+
+Die CLI-Befehle sind in den Cursor Rules dokumentiert:
+
+- **`001-pre-check.mdc`**: Verification-Commands Quick-Reference
+- **`026-reality-driven-verification.mdc`**: Build-Verification Commands
+
+Die Cursor Rules unterstützen beide Varianten:
+1. **Standalone CLI** (`noyrax-scan`, `noyrax-validate`, etc.) - für neue Projekte
+2. **Lokale Scripts** (`npm run scan:cli`, etc.) - für Projekte mit documentation-system-plugin
+
+## Voraussetzungen
+
+- Node.js >= 18.0.0
+- TypeScript >= 4.9.0 oder >= 5.0.0
+- Das `noyrax` Package muss installiert und kompiliert sein
+
+## Fehlerbehebung
+
+### "Could not find noyrax package"
+
+**Lösung:** Installieren Sie das `noyrax` Package:
+```bash
+npm install noyrax
+```
+
+### "Script not found"
+
+**Lösung:** Stellen Sie sicher, dass das `noyrax` Package kompiliert ist:
+```bash
+cd node_modules/noyrax
+npm run compile
+```
+
+### "Command not found"
+
+**Lösung:** Stellen Sie sicher, dass `@noyrax/doc-cli` installiert ist:
+```bash
+npm install -D @noyrax/doc-cli
+```
+
+Oder verwenden Sie `npx`:
+```bash
+npx noyrax-scan
+```
+
+## Vorteile
+
+1. **Eigenständig**: Nur Doku-Plugin als Dependency, keine Database/Semantic-Brain
+2. **Einfache Installation**: `npm install -D @noyrax/doc-cli noyrax`
+3. **Konsistente Commands**: Gleiche Befehle in allen Projekten
+4. **Cursor Rules Integration**: Dokumentiert in den Rules
+5. **Keine Abhängigkeiten**: Funktioniert ohne VS Code Extension
+
+## Unterschied zu lokalen Scripts
+
+| Aspekt | Standalone CLI | Lokale Scripts |
+|--------|----------------|----------------|
+| **Installation** | `npm install -D @noyrax/doc-cli` | Teil von `noyrax` Package |
+| **Verwendung** | `noyrax-scan` | `npm run scan:cli` |
+| **Abhängigkeiten** | Nur `noyrax` | Vollständiges Plugin-Ecosystem |
+| **Verfügbarkeit** | In jedem Projekt | Nur in Projekten mit `noyrax` |
+
+## Weitere Informationen
+
+- [Noyrax Documentation](https://noyrax.dev)
+- [GitHub Repository](https://github.com/noyrax/noyrax)
+- [Cursor Rules](https://github.com/noyrax/noyrax/tree/main/documentation-system-plugin/packages/doc-system-agent/templates/cursor-rules)
+
+## Lizenz
+
+MIT
+

package/USAGE.md

@@ -0,0 +1,350 @@
+# Verwendung von @noyrax/doc-cli
+
+## Schnellstart
+
+### 1. Installation
+
+In einem neuen Projekt:
+
+```bash
+# Package installieren
+npm install -D @noyrax/doc-cli noyrax
+
+# Oder mit npx (ohne Installation)
+npx @noyrax/doc-cli noyrax-scan
+```
+
+**Wichtig:** Das `noyrax` Package muss ebenfalls installiert sein, da es als Peer-Dependency verwendet wird.
+
+### 2. Erste Verwendung
+
+```bash
+# Dokumentation generieren
+npx noyrax-scan
+
+# Dokumentation validieren
+npx noyrax-validate
+
+# Alle Checks ausführen
+npx noyrax-verify-all
+```
+
+## Verwendungs-Szenarien
+
+### Szenario 1: Lokale Entwicklung (mit npm link)
+
+Wenn Sie das Package lokal entwickeln:
+
+```bash
+# Im noyrax-doc-cli Verzeichnis
+cd noyrax-doc-cli
+npm link
+
+# In Ihrem Projekt
+cd /path/to/your/project
+npm link @noyrax/doc-cli
+npm install noyrax
+
+# Jetzt können Sie die Commands verwenden
+noyrax-scan
+noyrax-validate
+```
+
+### Szenario 2: Als npm Package (nach Veröffentlichung)
+
+```bash
+# Installation
+npm install -D @noyrax/doc-cli noyrax
+
+# Verwendung
+npx noyrax-scan
+npx noyrax-validate
+npx noyrax-verify-all
+```
+
+### Szenario 3: In package.json Scripts
+
+Fügen Sie die Commands zu Ihren `package.json` Scripts hinzu:
+
+```json
+{
+  "scripts": {
+    "docs:scan": "noyrax-scan",
+    "docs:validate": "noyrax-validate",
+    "docs:verify": "noyrax-verify-all",
+    "docs:full": "noyrax-scan && noyrax-validate && noyrax-verify-all",
+    "precommit": "noyrax-validate && noyrax-verify-all"
+  }
+}
+```
+
+Dann können Sie verwenden:
+```bash
+npm run docs:scan
+npm run docs:validate
+npm run docs:verify
+npm run docs:full
+```
+
+### Szenario 4: In CI/CD Pipelines
+
+```yaml
+# GitHub Actions Beispiel
+- name: Generate Documentation
+  run: npx noyrax-scan
+
+- name: Validate Documentation
+  run: npx noyrax-validate
+
+- name: Verify All
+  run: npx noyrax-verify-all
+```
+
+## Verfügbare Commands im Detail
+
+### Dokumentations-Generierung
+
+#### `noyrax-scan`
+Vollständiger Scan und Generierung der Dokumentation.
+
+```bash
+noyrax-scan
+```
+
+**Was passiert:**
+1. Scannt `src/` nach TypeScript/JavaScript/Python-Dateien
+2. Extrahiert alle Symbole (Funktionen, Klassen, Interfaces, etc.)
+3. Generiert Modul-Dokumentation in `docs/modules/`
+4. Erstellt Symbol-Index in `docs/index/symbols.jsonl`
+5. Generiert Dependency-Graph in `docs/system/DEPENDENCY_GRAPH.md`
+6. Erstellt Change Report in `docs/system/CHANGE_REPORT.md`
+
+**Output:**
+- `docs/modules/*.md` - API-Dokumentation pro Datei
+- `docs/index/symbols.jsonl` - Symbol-Index
+- `docs/system/DEPENDENCY_GRAPH.md` - Mermaid-Graph
+- `docs/system/DEPENDENCIES.md` - Dependency-Übersicht
+- `docs/system/CHANGE_REPORT.md` - Änderungshistorie
+
+#### `noyrax-generate`
+Nur Generierung (ohne Scan).
+
+```bash
+noyrax-generate
+```
+
+**Verwendung:** Wenn bereits gescannt wurde und nur die Dokumentation aktualisiert werden soll.
+
+### Validierung
+
+#### `noyrax-validate`
+Validiert die Dokumentation gegen den Code.
+
+```bash
+noyrax-validate
+```
+
+**Was passiert:**
+1. Prüft Signatur-Übereinstimmung zwischen Code und Docs
+2. Prüft Coverage (welche Symbole sind dokumentiert)
+3. Erkennt veraltete Dokumentation
+
+**Exit-Codes:**
+- `0` = Alles valide ✅
+- `1` = Warnungen (z.B. fehlende Docs) ⚠️
+- `2` = Fehler (z.B. Signatur-Mismatch) ❌
+
+### Verification
+
+#### `noyrax-verify-adrs`
+Prüft ADR-Claims gegen den Code.
+
+```bash
+noyrax-verify-adrs
+noyrax-verify-adrs --verbose  # Ausführliche Ausgabe
+```
+
+**Was passiert:**
+- Prüft, ob in ADRs erwähnte Dateien existieren
+- Prüft, ob in ADRs erwähnte Funktionen existieren
+- Erkennt veraltete ADR-Claims
+
+#### `noyrax-verify-architecture`
+Prüft Architektur-Regeln.
+
+```bash
+noyrax-verify-architecture
+```
+
+**Was passiert:**
+- Prüft Import-Richtungen
+- Erkennt zirkuläre Abhängigkeiten
+- Validiert Modul-Struktur
+
+#### `noyrax-verify-imports`
+Prüft Import-Verfügbarkeit.
+
+```bash
+noyrax-verify-imports
+```
+
+**Was passiert:**
+- Prüft, ob alle Imports verfügbar sind
+- Erkennt fehlende Dependencies
+- Validiert Import-Pfade
+
+#### `noyrax-verify-all`
+Führt alle Verification-Checks aus.
+
+```bash
+noyrax-verify-all
+```
+
+**Was passiert:**
+- Führt `verify-architecture`, `verify-adrs` und `verify-imports` nacheinander aus
+- Gibt Exit-Code `1` zurück, wenn ein Check fehlschlägt
+
+## Typischer Workflow
+
+### Nach Code-Änderungen
+
+```bash
+# 1. Dokumentation aktualisieren
+noyrax-scan
+
+# 2. Dokumentation validieren
+noyrax-validate
+
+# 3. Alle Checks ausführen
+noyrax-verify-all
+```
+
+### Vor Commit
+
+```bash
+# Schneller Check
+noyrax-validate && noyrax-verify-all
+```
+
+### In package.json
+
+```json
+{
+  "scripts": {
+    "precommit": "noyrax-validate && noyrax-verify-all",
+    "docs": "noyrax-scan && noyrax-validate"
+  }
+}
+```
+
+## Integration mit Cursor Rules
+
+Die Commands sind automatisch in den Cursor Rules dokumentiert. Wenn Sie die Cursor Rules in Ihrem Projekt verwenden, werden die Commands automatisch erkannt:
+
+**In `001-pre-check.mdc`:**
+```markdown
+### Standalone CLI (nach Installation von @noyrax/doc-cli)
+noyrax-scan
+noyrax-validate
+noyrax-verify-all
+```
+
+**Der AI-Agent wird diese Commands automatisch verwenden, wenn:**
+- Das Package installiert ist
+- Die Cursor Rules aktiv sind
+- Der Agent Dokumentation generieren/validieren soll
+
+## Fehlerbehebung
+
+### "Could not find noyrax package"
+
+**Problem:** Das `noyrax` Package ist nicht installiert.
+
+**Lösung:**
+```bash
+npm install noyrax
+```
+
+### "Script not found"
+
+**Problem:** Das `noyrax` Package ist nicht kompiliert.
+
+**Lösung:**
+```bash
+cd node_modules/noyrax
+npm run compile
+cd ../..
+```
+
+### "Command not found"
+
+**Problem:** `@noyrax/doc-cli` ist nicht installiert oder nicht im PATH.
+
+**Lösung 1:** Mit npx verwenden
+```bash
+npx noyrax-scan
+```
+
+**Lösung 2:** Lokal installieren
+```bash
+npm install -D @noyrax/doc-cli
+```
+
+**Lösung 3:** Global installieren (nicht empfohlen)
+```bash
+npm install -g @noyrax/doc-cli
+```
+
+## Beispiel-Projekt
+
+### Minimales Setup
+
+```json
+{
+  "name": "my-project",
+  "version": "1.0.0",
+  "scripts": {
+    "docs:scan": "noyrax-scan",
+    "docs:validate": "noyrax-validate",
+    "docs:verify": "noyrax-verify-all"
+  },
+  "devDependencies": {
+    "@noyrax/doc-cli": "^1.0.0",
+    "noyrax": "^1.0.4",
+    "typescript": "^5.0.0"
+  }
+}
+```
+
+### Verwendung
+
+```bash
+# Installation
+npm install
+
+# Dokumentation generieren
+npm run docs:scan
+
+# Dokumentation validieren
+npm run docs:validate
+
+# Alle Checks
+npm run docs:verify
+```
+
+## Unterschied zu lokalen Scripts
+
+| Aspekt | Standalone CLI | Lokale Scripts |
+|--------|----------------|----------------|
+| **Installation** | `npm install -D @noyrax/doc-cli` | Teil von `noyrax` Package |
+| **Verwendung** | `noyrax-scan` | `npm run scan:cli` |
+| **Abhängigkeiten** | Nur `noyrax` | Vollständiges Plugin-Ecosystem |
+| **Verfügbarkeit** | In jedem Projekt | Nur in Projekten mit `noyrax` |
+| **CI/CD** | Einfach (npx) | Benötigt vollständiges Setup |
+
+## Weitere Informationen
+
+- [README.md](./README.md) - Vollständige Dokumentation
+- [Noyrax Documentation](https://noyrax.dev)
+- [Cursor Rules](https://github.com/noyrax/noyrax/tree/main/documentation-system-plugin/packages/doc-system-agent/templates/cursor-rules)
+

package/bin/noyrax-generate.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+
+/**
+ * CLI Wrapper für noyrax-generate
+ * Ruft generate-cli.js aus dem documentation-system-plugin auf
+ */
+
+const { execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+// Finde documentation-system-plugin
+function findPluginPath() {
+  try {
+    const pluginPath = require.resolve('noyrax/package.json');
+    return path.dirname(pluginPath);
+  } catch (e) {
+    const possiblePaths = [
+      path.join(process.cwd(), 'node_modules', 'noyrax'),
+      path.join(__dirname, '..', 'node_modules', 'noyrax'),
+      path.join(__dirname, '..', '..', 'documentation-system-plugin')
+    ];
+    
+    for (const possiblePath of possiblePaths) {
+      if (fs.existsSync(path.join(possiblePath, 'package.json'))) {
+        return possiblePath;
+      }
+    }
+    
+    throw new Error('Could not find noyrax package. Please install it: npm install noyrax');
+  }
+}
+
+try {
+  const pluginDir = findPluginPath();
+  const generateScript = path.join(pluginDir, 'out', 'cli', 'generate-cli.js');
+  
+  if (!fs.existsSync(generateScript)) {
+    throw new Error(`Generate script not found at ${generateScript}. Please ensure noyrax is compiled.`);
+  }
+  
+  execSync(`node "${generateScript}"`, {
+    stdio: 'inherit',
+    cwd: process.cwd(),
+    env: process.env
+  });
+} catch (error) {
+  console.error('Error running noyrax-generate:', error.message);
+  process.exit(1);
+}
+

package/bin/noyrax-scan.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+
+/**
+ * CLI Wrapper für noyrax-scan
+ * Ruft scan-cli.js aus dem documentation-system-plugin auf
+ */
+
+const { execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+// Finde documentation-system-plugin
+function findPluginPath() {
+  // Versuche zuerst über require.resolve (wenn als npm-Package installiert)
+  try {
+    const pluginPath = require.resolve('noyrax/package.json');
+    return path.dirname(pluginPath);
+  } catch (e) {
+    // Fallback: Suche in node_modules relativ zum aktuellen Verzeichnis
+    const possiblePaths = [
+      path.join(process.cwd(), 'node_modules', 'noyrax'),
+      path.join(__dirname, '..', 'node_modules', 'noyrax'),
+      path.join(__dirname, '..', '..', 'documentation-system-plugin')
+    ];
+    
+    for (const possiblePath of possiblePaths) {
+      if (fs.existsSync(path.join(possiblePath, 'package.json'))) {
+        return possiblePath;
+      }
+    }
+    
+    throw new Error('Could not find noyrax package. Please install it: npm install noyrax');
+  }
+}
+
+try {
+  const pluginDir = findPluginPath();
+  const scanScript = path.join(pluginDir, 'out', 'cli', 'scan-cli.js');
+  
+  if (!fs.existsSync(scanScript)) {
+    throw new Error(`Scan script not found at ${scanScript}. Please ensure noyrax is compiled.`);
+  }
+  
+  execSync(`node "${scanScript}"`, {
+    stdio: 'inherit',
+    cwd: process.cwd(),
+    env: process.env
+  });
+} catch (error) {
+  console.error('Error running noyrax-scan:', error.message);
+  process.exit(1);
+}
+

package/bin/noyrax-validate.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+
+/**
+ * CLI Wrapper für noyrax-validate
+ * Ruft validate-cli.js aus dem documentation-system-plugin auf
+ */
+
+const { execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+// Finde documentation-system-plugin
+function findPluginPath() {
+  try {
+    const pluginPath = require.resolve('noyrax/package.json');
+    return path.dirname(pluginPath);
+  } catch (e) {
+    const possiblePaths = [
+      path.join(process.cwd(), 'node_modules', 'noyrax'),
+      path.join(__dirname, '..', 'node_modules', 'noyrax'),
+      path.join(__dirname, '..', '..', 'documentation-system-plugin')
+    ];
+    
+    for (const possiblePath of possiblePaths) {
+      if (fs.existsSync(path.join(possiblePath, 'package.json'))) {
+        return possiblePath;
+      }
+    }
+    
+    throw new Error('Could not find noyrax package. Please install it: npm install noyrax');
+  }
+}
+
+try {
+  const pluginDir = findPluginPath();
+  const validateScript = path.join(pluginDir, 'out', 'cli', 'validate-cli.js');
+  
+  if (!fs.existsSync(validateScript)) {
+    throw new Error(`Validate script not found at ${validateScript}. Please ensure noyrax is compiled.`);
+  }
+  
+  execSync(`node "${validateScript}"`, {
+    stdio: 'inherit',
+    cwd: process.cwd(),
+    env: process.env
+  });
+} catch (error) {
+  console.error('Error running noyrax-validate:', error.message);
+  process.exit(1);
+}
+

package/bin/noyrax-verify-adrs.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+
+/**
+ * CLI Wrapper für noyrax-verify-adrs
+ * Ruft verify-adrs.js aus dem documentation-system-plugin auf
+ */
+
+const { execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+// Finde documentation-system-plugin
+function findPluginPath() {
+  try {
+    const pluginPath = require.resolve('noyrax/package.json');
+    return path.dirname(pluginPath);
+  } catch (e) {
+    const possiblePaths = [
+      path.join(process.cwd(), 'node_modules', 'noyrax'),
+      path.join(__dirname, '..', 'node_modules', 'noyrax'),
+      path.join(__dirname, '..', '..', 'documentation-system-plugin')
+    ];
+    
+    for (const possiblePath of possiblePaths) {
+      if (fs.existsSync(path.join(possiblePath, 'package.json'))) {
+        return possiblePath;
+      }
+    }
+    
+    throw new Error('Could not find noyrax package. Please install it: npm install noyrax');
+  }
+}
+
+try {
+  const pluginDir = findPluginPath();
+  const verifyScript = path.join(pluginDir, 'scripts', 'verify-adrs.js');
+  
+  if (!fs.existsSync(verifyScript)) {
+    throw new Error(`Verify ADRs script not found at ${verifyScript}. Please ensure noyrax is compiled.`);
+  }
+  
+  // Übertrage alle Argumente
+  const args = process.argv.slice(2).join(' ');
+  
+  execSync(`node "${verifyScript}" ${args}`, {
+    stdio: 'inherit',
+    cwd: process.cwd(),
+    env: process.env
+  });
+} catch (error) {
+  console.error('Error running noyrax-verify-adrs:', error.message);
+  process.exit(1);
+}
+

package/bin/noyrax-verify-all.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+
+/**
+ * CLI Wrapper für noyrax-verify-all
+ * Führt alle Verification-Scripts aus: verify-architecture, verify-adrs, verify-imports
+ */
+
+const { execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+// Finde documentation-system-plugin
+function findPluginPath() {
+  try {
+    const pluginPath = require.resolve('noyrax/package.json');
+    return path.dirname(pluginPath);
+  } catch (e) {
+    const possiblePaths = [
+      path.join(process.cwd(), 'node_modules', 'noyrax'),
+      path.join(__dirname, '..', 'node_modules', 'noyrax'),
+      path.join(__dirname, '..', '..', 'documentation-system-plugin')
+    ];
+    
+    for (const possiblePath of possiblePaths) {
+      if (fs.existsSync(path.join(possiblePath, 'package.json'))) {
+        return possiblePath;
+      }
+    }
+    
+    throw new Error('Could not find noyrax package. Please install it: npm install noyrax');
+  }
+}
+
+try {
+  const pluginDir = findPluginPath();
+  const scriptsDir = path.join(pluginDir, 'scripts');
+  
+  const scripts = [
+    'verify-architecture.js',
+    'verify-adrs.js',
+    'verify-imports.js'
+  ];
+  
+  let hasErrors = false;
+  
+  for (const script of scripts) {
+    const scriptPath = path.join(scriptsDir, script);
+    
+    if (!fs.existsSync(scriptPath)) {
+      console.warn(`Warning: ${script} not found at ${scriptPath}. Skipping.`);
+      continue;
+    }
+    
+    console.log(`\nRunning ${script}...`);
+    try {
+      execSync(`node "${scriptPath}"`, {
+        stdio: 'inherit',
+        cwd: process.cwd(),
+        env: process.env
+      });
+    } catch (error) {
+      console.error(`Error in ${script}:`, error.message);
+      hasErrors = true;
+    }
+  }
+  
+  if (hasErrors) {
+    console.error('\nSome verification checks failed.');
+    process.exit(1);
+  } else {
+    console.log('\nAll verification checks passed.');
+  }
+} catch (error) {
+  console.error('Error running noyrax-verify-all:', error.message);
+  process.exit(1);
+}
+

package/bin/noyrax-verify-architecture.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+
+/**
+ * CLI Wrapper für noyrax-verify-architecture
+ * Ruft verify-architecture.js aus dem documentation-system-plugin auf
+ */
+
+const { execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+// Finde documentation-system-plugin
+function findPluginPath() {
+  try {
+    const pluginPath = require.resolve('noyrax/package.json');
+    return path.dirname(pluginPath);
+  } catch (e) {
+    const possiblePaths = [
+      path.join(process.cwd(), 'node_modules', 'noyrax'),
+      path.join(__dirname, '..', 'node_modules', 'noyrax'),
+      path.join(__dirname, '..', '..', 'documentation-system-plugin')
+    ];
+    
+    for (const possiblePath of possiblePaths) {
+      if (fs.existsSync(path.join(possiblePath, 'package.json'))) {
+        return possiblePath;
+      }
+    }
+    
+    throw new Error('Could not find noyrax package. Please install it: npm install noyrax');
+  }
+}
+
+try {
+  const pluginDir = findPluginPath();
+  const verifyScript = path.join(pluginDir, 'scripts', 'verify-architecture.js');
+  
+  if (!fs.existsSync(verifyScript)) {
+    throw new Error(`Verify architecture script not found at ${verifyScript}. Please ensure noyrax is compiled.`);
+  }
+  
+  // Übertrage alle Argumente
+  const args = process.argv.slice(2).join(' ');
+  
+  execSync(`node "${verifyScript}" ${args}`, {
+    stdio: 'inherit',
+    cwd: process.cwd(),
+    env: process.env
+  });
+} catch (error) {
+  console.error('Error running noyrax-verify-architecture:', error.message);
+  process.exit(1);
+}
+

package/bin/noyrax-verify-imports.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+
+/**
+ * CLI Wrapper für noyrax-verify-imports
+ * Ruft verify-imports.js aus dem documentation-system-plugin auf
+ */
+
+const { execSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+// Finde documentation-system-plugin
+function findPluginPath() {
+  try {
+    const pluginPath = require.resolve('noyrax/package.json');
+    return path.dirname(pluginPath);
+  } catch (e) {
+    const possiblePaths = [
+      path.join(process.cwd(), 'node_modules', 'noyrax'),
+      path.join(__dirname, '..', 'node_modules', 'noyrax'),
+      path.join(__dirname, '..', '..', 'documentation-system-plugin')
+    ];
+    
+    for (const possiblePath of possiblePaths) {
+      if (fs.existsSync(path.join(possiblePath, 'package.json'))) {
+        return possiblePath;
+      }
+    }
+    
+    throw new Error('Could not find noyrax package. Please install it: npm install noyrax');
+  }
+}
+
+try {
+  const pluginDir = findPluginPath();
+  const verifyScript = path.join(pluginDir, 'scripts', 'verify-imports.js');
+  
+  if (!fs.existsSync(verifyScript)) {
+    throw new Error(`Verify imports script not found at ${verifyScript}. Please ensure noyrax is compiled.`);
+  }
+  
+  // Übertrage alle Argumente
+  const args = process.argv.slice(2).join(' ');
+  
+  execSync(`node "${verifyScript}" ${args}`, {
+    stdio: 'inherit',
+    cwd: process.cwd(),
+    env: process.env
+  });
+} catch (error) {
+  console.error('Error running noyrax-verify-imports:', error.message);
+  process.exit(1);
+}
+

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "noyrax-doc-cli",
+  "version": "1.0.0",
+  "description": "Standalone CLI für Noyrax Documentation System - Scan, Validate, Generate, Verify",
+  "type": "commonjs",
+  "main": "index.js",
+  "bin": {
+    "noyrax-scan": "bin/noyrax-scan.js",
+    "noyrax-validate": "bin/noyrax-validate.js",
+    "noyrax-generate": "bin/noyrax-generate.js",
+    "noyrax-verify-adrs": "bin/noyrax-verify-adrs.js",
+    "noyrax-verify-architecture": "bin/noyrax-verify-architecture.js",
+    "noyrax-verify-imports": "bin/noyrax-verify-imports.js",
+    "noyrax-verify-all": "bin/noyrax-verify-all.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "dependencies": {},
+  "peerDependencies": {
+    "noyrax": "*",
+    "typescript": "^4.9.0 || ^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "noyrax",
+    "documentation",
+    "cli",
+    "scan",
+    "validate",
+    "verify",
+    "docs-as-code"
+  ],
+  "author": "Benjamin Behrens <contact@noyrax.dev>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/noyrax/noyrax.git"
+  },
+  "homepage": "https://noyrax.dev",
+  "bugs": {
+    "url": "https://github.com/noyrax/noyrax/issues"
+  }
+}