german-legal-engine
# German Legal Engine (GLE)
Python-SDK, Kommandozeile und MCP-Server für Recherche und juristische Arbeitshilfen in Deutschland. Der Versionswert `1.0.0` ist vorläufig beibehalten und kein Nachweis einer veröffentlichten oder fachlich abgenommenen Version. Änderungen stehen im [Changelog](CHANGELOG.md); Entwicklung und Abnahme sind in der [Roadmap](ROADMAP.md) und im [Release-Handbuch](docs/RELEASE.md) beschrieben.
## Vorhandener Umfang
- Bundesnormen aus `gesetze-im-internet.de`, Rechtsprechungssuche und Entscheidungsabruf aus Rechtsprechung im Internet und dem bayerischen Portal.
- Ereignisfristen mit Berechnungsschritten; Fristtyp, Zustellung und örtliche Feiertage benötigen eine eigenständige fachliche Prüfung.
- Acht redaktionelle Tatbestandsmodelle: BGB §§ 823 Abs. 1, 280 Abs. 1, 314, 535 Abs. 1 Satz 2, 551 und 626; KSchG § 1; OWiG § 67.
- Musterbasierte Redaktion personenbezogener Daten, unverbindliche Eingangseinschätzung mit optionalem Laya und Zusammenstellung eines Recherchedossiers.
Diese Funktionen waren bereits vor der Release-Basis vorhanden. KMU-Skills etwa für Forderungen oder E-Rechnungen sind geplant und noch nicht implementiert. Die Software erteilt keine fachliche Freigabe für Verträge, Fristen, Schriftsätze oder Compliance.
## Installation aus dem Quellstand
Python ab 3.10; die CI prüft 3.10, 3.11 und 3.12. Eine geprüfte Installation setzt Internetzugang zur Auflösung der Abhängigkeiten voraus.
```sh
python3 -m venv .venv
.venv/bin/python -m pip install .
.venv/bin/gle --version
.venv/bin/gle --help
```
Nur das optionale Extra installiert Laya:
```sh
.venv/bin/python -m pip install '.[laya]'
```
Die optionale Modellinitialisierung kann Gewichte aus einem externen Modellregister herunterladen und lokal speichern. Laufzeit, Modellrevision und Kalibrierung sind nicht allgemein nachgewiesen. Ohne nutzbares Modell wird eine Heuristik verwendet; ihre Werte sind keine validierten Wahrscheinlichkeiten.
## Python und Kommandozeile
```python
from german_legal_engine import LegalEngine, __version__
# Lokale, redaktionelle Arbeitshilfe ohne Portalabruf.
result = LegalEngine.get_subsumption_blueprint("BGB", "823")
if result.get("success"):
print(result["blueprint"]["norm"])
```
```sh
gle norm BGB 823
gle search 'Mietkaution Rückzahlung' --source BUND --limit 3
gle decision 'DOKUMENTKENNUNG_AUS_DER_SUCHE'
gle deadline 2026-10-02 3 wochen --state BY --audit
gle subsume BGB 823
gle triage 'Bitte einen deutschen Kaufvertrag prüfen' --state NW
```
Alle erfolgreichen Fristenrechnungen benötigen weiterhin fachliche Anwendbarkeitsprüfung. Die Fristenrechnung bestimmt die Anwendbarkeit einer gesetzlichen Frist nicht selbst. Beispielsweise muss der Anwender Ereignis, Rechtsgrundlage, Fristtyp und lokale Feiertage vorher klären. Datumserkennung aus Freitext ist keine Festlegung eines Fristbeginns.
**Geändertes CLI-Verhalten:** `gle --version` zeigt die gemeinsame Produktversion. Erfolgreiche Befehle liefern Exitcode 0; Abruf-/Verarbeitungsfehler, fehlende Tatbestandsmodelle und Suchteilausfälle liefern 1; ungültige Eingaben und nicht belastbar berechenbare Fristen liefern 2. Nicht belastbare Triage-Ergebnisse liefern ebenfalls 1; Eskalationsgründe, Redaktionshinweise und Grenzen werden angezeigt. Fehler stehen auf stderr; bei Suchteilausfällen bleiben vorhandene Treffer auf stdout. Ein Aufruf ohne Befehl liefert 2 statt eines scheinbaren Erfolgs. Skripte müssen die Exitcodes beachten. Menschliche Ausgaben sind kein zugesagtes JSON-Format; diese Änderung darf nach einer belegten Veröffentlichung nicht ungeprüft als Patch erscheinen.
## MCP
```sh
german-legal-mcp --transport stdio
german-legal-mcp --version
```
Ein MCP-Host startet den Konsoleneinstieg als Prozess mit `--transport stdio`. Der Client handelt die Protokollversion aus; diese ist unabhängig von der GLE-Produktversion. Das offizielle Python-SDK wird auf die lokal getestete Spanne `mcp>=1.25.0,<1.26.0` begrenzt. SSE ist derzeit nicht abgenommen: `--transport sse` meldet einen deutschen Fehler und Exitcode 2. Die bisherigen Optionen `--host` und `--port` bleiben für diesen gesperrten Transport erkennbar, öffnen aber keinen Server.
Alle acht Werkzeugnamen bleiben bestehen:
| Werkzeug | Ergebnis über MCP |
|---|---|
| `get_norm` | JSON als Text |
| `search_precedents` | JSON als Text |
| `get_decision` | JSON als Text |
| `compute_deadline` | JSON als Text, auch bisheriges `error`-Objekt |
| `get_subsumption_blueprint` | JSON als Text |
| `anonymize_text` | Klartext |
| `triage_mandate` | JSON als Text |
| `prepare_pleading_dossier` | Klartext |
Es gibt keine stille Umstellung auf `structuredContent`. Die öffentliche Server-API des offiziellen SDK übernimmt den Protokollablauf. [Prüfskript](scripts/check_mcp.py) und Vertragstests verwenden den echten SDK-Client mit Initialisierung, Werkzeugauflistung und harmlosen lokalen Werkzeugaufrufen.
## Quellen, Datenflüsse und Grenzen
Die Quellen- und Regelkorrekturen sind im gemeinsamen Quellstand integriert; unabhängige Gesamtprüfung und fachliche Abnahme bleiben offen. Sie begrenzen die tatsächlich benötigten Feiertagsjahre auf Jahre ab 2026; ein früheres Ereignisdatum ist dadurch nicht pauschal ausgeschlossen. Sie weisen entscheidungserheblich ungeklärte Ortsfeiertage zurück: BY am 8./15. August, SN/TH an Fronleichnam. Spätere Rechtsänderungen und einmalige Feiertage sind damit nicht automatisch geprüft. Ungültige Dauer/Bundesländer liefern Eingabefehler. Die geprüften Negativfälle BGB § 823 Abs. 2 und § 280 Abs. 9 ergeben keinen ersatzweisen Blueprint; absatzlose Aufrufe weisen auf den tatsächlich verwendeten Absatz hin. Absatz-/Satzrollen werden in zulässiger Reihenfolge geprüft; wiederholte, widersprüchliche und nicht unterstützte explizite Angaben erhalten keinen Ersatzgraphen. Die tatsächliche Blueprint-Norm bleibt mit der Anfrage abzugleichen.
Portaltexte werden extrahiert und normalisiert. Aufbereiteter Inhalt ist kein beweiskräftiges wortlautidentisches Original; Fundstelle, Dokumentkennung, Abrufzeit und Quellenstatus müssen geprüft werden. Ein aktueller Abruf belegt keinen historischen Rechtsstand. Die Volltextausgaben unterscheiden `text_raw` beziehungsweise `content_raw` vom bereinigten Text, ergänzen `source_url`, `identity_verified` und `text_kind` und setzen `is_official_verbatim=False` für normalisierte Ausgaben. `leitsatz_origin="ungeklärt"` bescheinigt keine amtliche Leitsatzherkunft. Rohtext ist extrahierter Text, kein Original-HTML. Dossiers zeigen die genaue Blueprint-Norm und ihren Umfang; ein nicht verfügbares Tatbestandsmodell wird ausdrücklich benannt. Die HTTP-Kennungen aller drei Quellenmodule übernehmen dieselbe Produktversion wie SDK, CLI und MCP. Portalfehler, fehlende Treffer oder unvollständige Dossiers sind keine Bestätigung, dass kein relevantes Recht existiert.
Norm- und Rechtsprechungsabrufe kontaktieren die genannten externen Portale. Suchbegriffe, Dokumentkennungen und Verbindungsdaten können dort anfallen. Unbereinigte Mandantendaten gehören nicht in Suchanfragen. Die Regex-Redaktion erkennt nur bestimmte Muster und garantiert keine vollständige Anonymisierung. Der verwendete Agenten-Host, optionale Modelle, Protokollierung und eigene Infrastruktur bestimmen weitere Datenflüsse. Details und offene Pflichten stehen in [COMPLIANCE.md](COMPLIANCE.md).
## Prüfung und Entwicklung
```sh
.venv/bin/python -m pip install -e . build
.venv/bin/python scripts/run_tests.py --mode offline
.venv/bin/python scripts/run_tests.py --mode live
.venv/bin/python -m unittest discover -s tests -v
.venv/bin/python -m build
.venv/bin/python scripts/check_packages.py --report /tmp/gle-paketnachweis.json
```
Die vollständige Suite enthält Live-Portaltests. Skips werden mit Grund ausgewiesen und beweisen keinen funktionierenden Abruf. Wheel und sdist werden jeweils in einer frischen virtuellen Umgebung außerhalb des Quellbaums installiert und mit `pip check`, SDK, beiden Konsoleneinstiegen und MCP geprüft. Lokale Ergebnisse ersetzen weder die Python-Matrix noch unabhängige technische und fachliche Abnahme. Siehe [Anweisungen für Beiträge](AGENT_INSTRUCTIONS.md).
Lizenz: [MIT](LICENSE).
TDQS
Scored across 6 tools
search_precedents (case law search) and get_decision (full text by ID) are related but clearly distinct actions, and get_norm cleanly separates statutes from case law. get_subsumption_blueprint and prepare_pleading_dossier both support drafting and could be momentarily confused, but their descriptions differentiate blueprint retrieval from dossier preparation.
All six tools follow a consistent verb_noun snake_case pattern: search_precedents, get_decision, compute_deadline, get_subsumption_blueprint, prepare_pleading_dossier, get_norm. No mixing of conventions.
Six tools is well-scoped for a focused legal engine covering case law, statutes, deadlines, and drafting. Each tool earns its place, though the surface is somewhat lean for the breadth of the legal domain.
The set covers the core legal research and drafting lifecycle: finding precedents, retrieving decisions and norms, computing deadlines, and preparing pleadings. Minor gaps exist (e.g., no explicit citation formatting or update/versioning, appeal lifecycle), but the primary workflows are covered.