Installation

FinDSL gibt es in vier Varianten — wähle die für deinen Anwendungsfall passende:

Variante	Für wen	Bezugsquelle
VS-Code-Extension	Sachbearbeiter:innen, Fachreferent:innen	aus VS Code heraus bzw. .vsix-Datei
IntelliJ-/JetBrains-Plugin	Nutzer:innen von IntelliJ IDEA & Co.	Plugin-.zip (GitHub Releases)
Natives CLI-Binary	Kommandozeile, CI/CD-Pipelines ohne Node	GitHub Releases
npm-Paket (@findsl/cli)	Entwickler:innen mit Node-Toolchain	npm-Registry

Voraussetzungen

• VS-Code-Extension: Visual Studio Code (oder ein kompatibler Editor wie VSCodium/Cursor). Der Sprachserver ist enthalten — kein separates CLI nötig.
• IntelliJ-/JetBrains-Plugin: IntelliJ IDEA (Community oder Ultimate) bzw. eine andere JetBrains-IDE ab Version 2024.2 sowie das LSP4IJ-Plugin. Der native Sprachserver wird beim ersten Start automatisch geladen — kein separates CLI nötig.
• Natives CLI-Binary: keine. Das Binary ist self-contained (enthält die Laufzeit) und läuft ohne Node-Installation.
• npm-Paket: Node.js (aktuelle LTS, mindestens Version 20).

Version

Alle Befehle unten verwenden <version> als Platzhalter. Setze dort die gewünschte Versionsnummer ein — die jeweils aktuelle findest du auf der Releases-Seite.

Aktuelle Vorabversion

FinDSL befindet sich in der Release-Candidate-Phase; aktuell ist 1.2.0. Der GitHub-Alias releases/latest zeigt nicht auf Vorabversionen — verwende daher in den Download-Befehlen die explizite Version (derzeit 1.2.0) von der Releases-Seite, nicht latest.

---

VS-Code-Extension

Der empfohlene Weg für die meisten Anwender:innen — bringt Syntax-Hervorhebung, Hover mit Bezug auf die gesetzliche Quelle, Inlay-Hints für Geldeinheiten und ausführbare Prüffälle direkt in den Editor.

Während der Vorabphase wird die Extension als .vsix-Datei am GitHub-Release ausgeliefert (die öffentlichen Marktplätze akzeptieren keine SemVer-Vorabversionen).

1. Die Datei findsl-<version>.vsix von der Releases-Seite herunterladen.

2. In VS Code installieren — entweder über die Kommandozeile:

   code --install-extension findsl-<version>.vsix

   Oder in VS Code: Befehlspalette (Strg+Umschalt+P / Cmd+Umschalt+P) → „Extensions: VSIX installieren…” → die Datei auswählen.

3. Eine .findsl-Datei öffnen — die Extension aktiviert sich automatisch.

Ab dem stabilen Release

Mit der ersten stabilen Version (1.0.0) erscheint die Extension im Visual Studio Marketplace und auf Open VSX (für VSCodium/Cursor). Dann genügt: Extensions-Ansicht öffnen (Strg+Umschalt+X), nach FinDSL suchen (Herausgeber: findsl), Installieren.

---

IntelliJ-/JetBrains-Plugin

Für IntelliJ IDEA (Community & Ultimate) und alle JetBrains-IDEs ab Version 2024.2. Das Plugin bindet denselben Sprachserver wie die VS-Code-Extension an — über LSP4IJ. Funktionen und Bedienung sind unter IntelliJ-/JetBrains-Plugin beschrieben.

1. LSP4IJ installieren. Das FinDSL-Plugin setzt es zwingend voraus und zieht es bei der Installation aus einer Datei nicht automatisch mit. In der IDE: Settings/Preferences → Plugins → Marketplace, nach LSP4IJ suchen, Install.

2. Die Datei findsl-intellij-<version>.zip von der Releases-Seite herunterladen.

3. Das Plugin aus der Datei installieren: Settings/Preferences → Plugins → ⚙ → „Install Plugin from Disk…” → die .zip auswählen. Anschließend die IDE neu starten.

4. Eine .findsl-Datei öffnen. Beim ersten Mal lädt das Plugin den passenden Sprachserver einmalig vom Release nach (SHA-256-verifiziert, danach aus dem Cache).

Hinter einem Proxy oder im Air-Gap-Netz

Der Download des Sprachservers nutzt die Proxy-Einstellungen der IDE. Ohne Internetzugang lässt sich der Pfad zu einem manuell bereitgestellten Binary unter Settings → FinDSL eintragen — er greift noch vor dem automatischen Download.

Ab dem stabilen Release

Künftig erscheint das Plugin im JetBrains-Marktplatz; dann genügt die Suche nach FinDSL unter Settings → Plugins → Marketplace. Bis dahin wird es als .zip am GitHub-Release ausgeliefert.

---

Natives CLI-Binary

Vorgefertigte, eigenständige Binaries für Linux, macOS und Windows liegen auf der Releases-Seite. Sie enthalten alles Nötige und laufen ohne Node-Installation — ideal für CI/CD und Build-Server.

Linux

# Beispiel: x64
curl -L -o findsl.tar.gz \
  https://github.com/findsl/findsl/releases/download/v<version>/findsl-<version>-linux-x64.tar.gz
tar -xzf findsl.tar.gz
sudo mv findsl-*/findsl /usr/local/bin/
findsl --help

Das Linux-Tarball ist mit dem GPG-Schlüssel der FinDSL-Maintainer signiert — siehe Sicherheit & Signaturen.

macOS

# Beispiel: Apple Silicon (arm64)
curl -L -o findsl.tar.gz \
  https://github.com/findsl/findsl/releases/download/v<version>/findsl-<version>-darwin-arm64.tar.gz
tar -xzf findsl.tar.gz
sudo mv findsl-*/findsl /usr/local/bin/

Die macOS-Binaries sind nicht von Apple notarisiert — beim ersten Start ist ein einmaliger Freischaltschritt nötig. Siehe macOS freischalten.

Windows

1. findsl-<version>-windows-x64.zip von der Releases-Seite herunterladen und entpacken.
2. findsl.exe ausführen. Die Datei ist nicht signiert — siehe Windows freischalten.
3. Optional findsl.exe in einen Ordner im PATH kopieren (z. B. %USERPROFILE%\bin).

---

npm-Paket

Für Entwickler:innen mit Node-Toolchain. Die npm-Pakete sind mit Sigstore-Provenance signiert — die signierte Alternative für alle, die unsignierten Binaries nicht vertrauen wollen.

Global als CLI

npm install -g @findsl/cli
findsl --help

Als Projekt-Abhängigkeit

npm install @findsl/cli
npx findsl --help

Vorabversion über next

Solange nur Vorabversionen veröffentlicht sind, lässt sich die jeweils neueste auch gezielt über den dist-Tag next beziehen: npm install -g @findsl/cli@next.

---

Sicherheit & Signaturen

FinDSL ist ein freies Projekt. Auf kostenpflichtige Code-Signing-Zertifikate für macOS (Apple Developer ID) und Windows (Authenticode) wird bewusst verzichtet — die Integrität lässt sich stattdessen über offene, kostenfreie Verfahren prüfen.

Artefakt	Signatur
npm-Pakete	Sigstore-Provenance (SLSA Level 3)
Linux-Tarball	GPG (detached, .asc)
SHA256SUMS (alle)	GPG-signiert (SHA256SUMS.asc)
macOS-/Windows-Binary	unsigniert — Prüfung über SHA256SUMS

macOS freischalten

Beim ersten Aufruf eines nicht notarisierten Binaries meldet macOS sinngemäß: „Apple konnte nicht verifizieren, dass ‚findsl‘ frei von Schadsoftware ist.” Das ist erwartet. Der Schritt ist einmalig pro Binary.

Terminal

xattr -d com.apple.quarantine /usr/local/bin/findsl
findsl --help

Ohne Terminal

1. Das Binary einmal starten — es wird blockiert.
2. Systemeinstellungen → Datenschutz & Sicherheit öffnen. Ganz unten erscheint „‚findsl‘ wurde blockiert…” → „Trotzdem öffnen”.
3. Beim erneuten Start „Öffnen” bestätigen. macOS merkt sich die Freigabe.

macOS 15 (Sequoia) und neuer

Der frühere Finder-Trick „Rechtsklick → Öffnen” funktioniert ab macOS 15 nicht mehr. Nutze den xattr-Befehl oder den Weg über die Systemeinstellungen.

Windows freischalten

Bei der .exe zeigt SmartScreen: „Der Computer wurde durch Windows geschützt.” Die Datei ist trotzdem ausführbar:

1. Im Dialog „Weitere Informationen” anklicken.
2. „Trotzdem ausführen” wählen.

Integrität prüfen

Jedes Release enthält eine SHA256SUMS-Datei (Prüfsummen aller Artefakte) plus die GPG-signierte SHA256SUMS.asc.

GPG-Signatur (Linux-Tarball)

gpg --keyserver keys.openpgp.org --recv-keys <SCHLÜSSEL_ID>
curl -L -o findsl.tar.gz.asc \
  https://github.com/findsl/findsl/releases/download/v<version>/findsl-<version>-linux-x64.tar.gz.asc
gpg --verify findsl.tar.gz.asc findsl.tar.gz

Prüfsumme (Windows)

Get-FileHash findsl-<version>-windows-x64.zip -Algorithm SHA256
# Den Hash mit dem Eintrag in SHA256SUMS vergleichen.

Herkunft (npm)

# Sigstore-Provenance einsehen (Herkunft: Repo + Commit):
npm view @findsl/cli --json | jq ".dist.attestations"

---

Versionierung

Alle Artefakte werden im Lockstep veröffentlicht: Eine FinDSL-Version X.Y.Z bedeutet, dass @findsl/cli@X.Y.Z, das .vsix und das native Binary exakt zusammenpassen. Versionen zu mischen ist nicht unterstützt.

Nächste Schritte

• Erstes Modul schreiben
• Code & Dokumentation generieren