Hier ist das SL5 Aura Dev-Cheatsheet (Compact):

  1. Pfad: config/maps/plugins/<name>/de-DE/ (Sprachordner ist Pflicht).

  2. Timing:

    • FUZZY_MAP_pre.py = Vor LanguageTool (Raw Input, Commands, Speed).

    • FUZZY_MAP.py = Nach LanguageTool (Korrigierter Text).

  3. Action: Tuple muss 'on_match_exec': [CONFIG_DIR / 'script.py'] nutzen.

    • Ziel-Script benötigt: def execute(match_data):.

  4. Override: 'skip_list': ['LanguageTool', 'LT_SKIP_RATIO_THRESHOLD'] erzwingt Ausführung bei unsicherem Input.

  5. Hook: def on_reload(): in der Map für Wartungsaufgaben nach Hot-Reload.

📜 SL5 Aura Developer Standard (10.12.’25 18:34 Wed)

1. Directory Structure (Mandatory)

  • Plugins müssen in einem Sprach-Unterordner liegen.

  • ✅ Richtig: config/maps/plugins/my_plugin/de-DE/FUZZY_MAP_pre.py

  • ❌ Falsch: config/maps/plugins/my_plugin/FUZZY_MAP_pre.py

2. File Naming (Pipeline Control)

  • FUZZY_MAP_pre.py: Pre-Processing. Läuft vor LanguageTool. (Pflicht für Systemkommandos, Raw-Inputs, schnelle Reaktionen).

  • FUZZY_MAP.py: Post-Processing. Läuft nach LanguageTool (für korrigierten Text).

3. Execution Pattern (Standard)

  • Nutzung von on_match_exec für die Ausführung von Skripten.

  • Beispiel: 'on_match_exec': [CONFIG_DIR / 'my_script.py']

  • Das Skript muss eine def execute(match_data): Funktion haben.

4. Safety Override

  • Um Sicherheitschecks bei unsicheren Inputs zu umgehen:

  • 'skip_list': ['LanguageTool', 'LT_SKIP_RATIO_THRESHOLD'] im Rule-Tuple hinzufügen.

5. Lifecycle Hooks

  • def on_reload(): im Map-File definieren, um nach einem Hot-Reload Wartungsaufgaben (wie secure_packer.py via Daisy-Chain) zu starten.

Erweiterte Regel-Attribute

Zusätzlich zu search und replace können Regeln durch weitere Attribute gesteuert werden:

1. only_in_windows (Fenster-Filter)

Trotz des Namens ist dieses Attribut betriebssystemunabhängig. Es dient dazu, die Ausführung einer Regel auf bestimmte aktive Fenster zu beschränken.

  • Typ: Liste von Strings oder Regex-Mustern.

  • Funktion: Die Regel wird nur angewendet, wenn der Titel des aktuell aktiven Fensters eines der Muster in der Liste enthält.

  • Beispiel:

    (
    '|', 
    r'\b(pipe|treib symbol)\b', 
    75, 
    {
        'command_flags': re.IGNORECASE,
        'only_in_windows': ['Konsole', 'konsole', 'Terminal', 'Console']
    }
),

    In diesem Beispiel wird das Wort “pipe” nur dann durch das Symbol “|” ersetzt, wenn der Benutzer sich in einem Terminal-Fenster befindet.

2. on_match_exec (Dynamische Skripte)

Wie bereits erwähnt, erlaubt dieses Attribut die Ausführung externer Python-Logik.

  • Syntax: 'on_match_exec': [CONFIG_DIR / 'script.py']

  • Nutzen: Ideal für API-Abfragen, Datei-Operationen oder komplexe Textersetzungen, die über einfaches Regex hinausgehen.