humhub: Hinweis auf Emoji-Ersetzung bei :) in Fachtext (0.4.1)

'(0.0.0.0 und ::)' wurde in einem Schraubraum-Post zu einem Smiley.
IPv6-Adressen, Ports und Pfade vor Klammern in Backticks setzen.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

.claude-plugin/marketplace.json

@@ -33,10 +33,25 @@
       "source": "./plugins/mediawiki",
       "description": "MediaWiki-Seiten/Templates lesen, rendern und schreiben via wiki.py (Instanzen wiki & devwiki; Zugangsdaten lokal)."
     },
+    {
+      "name": "redmine",
+      "source": "./plugins/redmine",
+      "description": "Redmine via REST-API: Projekte, Tickets, Versionen und News auflisten, anzeigen, anlegen, aktualisieren und kommentieren via redmine.py (API-Key lokal)."
+    },
     {
       "name": "grill-me",
       "source": "./plugins/grill-me",
       "description": "Löchert dich gnadenlos mit Fragen zu einem Plan, einer Entscheidung oder Idee, bis ein gemeinsames Verständnis steht."
+    },
+    {
+      "name": "einfaches-technisches-deutsch",
+      "source": "./plugins/einfaches-technisches-deutsch",
+      "description": "Antworten in einfachem technischem Deutsch (nach ASD-STE100, ins Deutsche übertragen): Aktiv, kurze Sätze, ein Gedanke pro Satz — Technik bleibt exakt."
+    },
+    {
+      "name": "klare-sprache",
+      "source": "./plugins/klare-sprache",
+      "description": "Texte in klarer, verständlicher Sprache nach ISO 24495-1:2023 (Plain Language): zielgruppenorientiert — finden, verstehen, nutzen."
     }
   ]
 }

.gitignore

@@ -0,0 +1,6 @@
+# Python
+__pycache__/
+*.py[cod]
+
+# lokale Umgebungs-/Secret-Dateien
+.env

README.md

@@ -79,9 +79,10 @@ natürlicher klingen. Basiert auf Wikipedias „Signs of AI writing".
 
 ### humhub
 
-HumHub (humhub.inmedias.it) über die REST-API: Wiki-Seiten und Posts auflisten,
+HumHub (humhub.inmedias.it) über die REST-API: Wiki-Seiten, Posts und Umfragen auflisten,
 anzeigen, anlegen und aktualisieren — via mitgelieferter, self-contained
-`humhub.py` (`wiki-list/get/update/create`, `post-list/create/update`).
+`humhub.py` (`wiki-list/get/update/create`, `post-list/create/update`,
+`poll-list/create`).
 
 - Voraussetzung: `HUMHUB_API_TOKEN` als Umgebungsvariable bzw. dotenv-Datei
   (kein Token im Plugin). Token nur als berechtigter Benutzer unter
@@ -107,6 +108,22 @@ self-contained `wiki.py` (`fetch`/`render`/`search`/`update`). Instanzen `wiki`
 /plugin install mediawiki@inmedias-claude-plugins
 ```
 
+### redmine
+
+Redmine (redmine.inmedias.it) über die REST-API: Projekte, Tickets, Versionen
+und News auflisten, anzeigen, anlegen, aktualisieren und kommentieren — via
+mitgelieferter, self-contained `redmine.py` (`me`/`projects`/`issues`/`show`/
+`create`/`update`/`comment`/`news`/`versions`/`meta`). Namen (Projekt/Tracker/
+Status/Priorität/Version) werden auf IDs aufgelöst.
+
+- Voraussetzung: `REDMINE_URL` und persönlicher `REDMINE_API_KEY` als
+  Umgebungsvariable bzw. dotenv-Datei (kein Key im Plugin). API-Key unter
+  https://redmine.inmedias.it/my/account.
+
+```bash
+/plugin install redmine@inmedias-claude-plugins
+```
+
 ### grill-me
 
 Löchert dich gnadenlos mit Fragen zu einem Plan, einer Entscheidung oder Idee —
@@ -123,6 +140,37 @@ nach deiner Bestätigung.
 /plugin install grill-me@inmedias-claude-plugins
 ```
 
+### einfaches-technisches-deutsch
+
+Setzt einen festen Schreibstil für Antworten: nach ASD-STE100 (Simplified
+Technical English), ins Deutsche übertragen. Aktiv, Sätze mit höchstens 20
+Wörtern, ein Gedanke pro Satz, gleiche Wörter für gleiche Dinge. Technische
+Angaben (Pfade, Befehle, Zahlen, Preise) bleiben exakt.
+
+- Kein Setup, keine Zugangsdaten. Auslösen mit „schreib einfacher", „einfaches
+  Deutsch", „STE" o. ä.; gilt dann für die weitere Sitzung.
+
+```bash
+/plugin install einfaches-technisches-deutsch@inmedias-claude-plugins
+```
+
+### klare-sprache
+
+Schreibt oder überarbeitet Texte in klarer, verständlicher Sprache nach
+ISO 24495-1:2023 (Plain Language). Anders als `einfaches-technisches-deutsch`
+kein starres Regelwerk, sondern zielgruppen- und prozessorientiert: Die Leser
+sollen leicht **finden**, **verstehen** und **nutzen** können. Vier Prinzipien
+(relevant, auffindbar, verständlich, nutzbar) mit Checkliste; technische Angaben
+bleiben exakt.
+
+- Kein Setup, keine Zugangsdaten. Auslösen mit „klare Sprache", „verständlich
+  schreiben", „ISO 24495" o. ä. Ohne bekannte Zielgruppe fragt der Skill zuerst
+  nach.
+
+```bash
+/plugin install klare-sprache@inmedias-claude-plugins
+```
+
 ## Updates
 
 ```bash

plugins/einfaches-technisches-deutsch/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "einfaches-technisches-deutsch",
+  "version": "0.1.0",
+  "description": "Antworten in einfachem technischem Deutsch schreiben (nach ASD-STE100, ins Deutsche übertragen): Aktiv, kurze Sätze, ein Gedanke pro Satz — Technik bleibt exakt.",
+  "author": {
+    "name": "inmedias.it"
+  }
+}

plugins/einfaches-technisches-deutsch/skills/einfaches-technisches-deutsch/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: einfaches-technisches-deutsch
+description: Antworten in einfachem technischem Deutsch schreiben (nach ASD-STE100 Simplified Technical English, ins Deutsche übertragen). Use when the user asks to write clearly/simply, mentions "einfache Sprache", "einfaches Deutsch", "vereinfachtes technisches Deutsch", "verständlich schreiben", "schreib einfacher", "STE", "Simplified Technical English", or wants replies that stay short and precise.
+version: 0.1.0
+---
+
+# Einfaches technisches Deutsch
+
+Dieser Skill setzt einen festen Schreibstil. Der Stil folgt ASD-STE100
+(Simplified Technical English) und ist ins Deutsche übertragen. Ziel: Antworten
+bleiben kurz, klar und eindeutig.
+
+## Wann anwenden
+
+Wende den Stil an, sobald der Nutzer ihn verlangt. Er gilt dann für alle
+weiteren Antworten in der Sitzung, bis der Nutzer ihn wieder abschaltet.
+
+Der Nutzer kann den Stil auch dauerhaft wollen. In dem Fall speichere die Regel
+im Memory und wende sie in jeder Sitzung an.
+
+## Die Regeln
+
+Halte dich an diese Regeln:
+
+- Ich schreibe im Aktiv.
+- Ich schreibe Sätze mit höchstens 20 Wörtern.
+- Ich schreibe einen Gedanken pro Satz.
+- Ich nutze einfache Zeitformen: Präsens, Präteritum und Futur.
+- Ich nutze dasselbe Wort für dieselbe Sache.
+- Ich nutze keine Redewendungen, keinen Slang und keinen unnötigen Jargon.
+- Ich schreibe Absätze mit höchstens 6 Sätzen.
+
+## Technische Angaben bleiben exakt
+
+Der Stil vereinfacht die Sprache, nicht die Technik. Technische Angaben bleiben
+unverändert. Das gilt für Dateipfade, Funktionsnamen, Spaltennamen, Befehle,
+Preise und Zahlen.
+
+Beispiel: Ich schreibe `workers/updatePricing.php` und `4.855 €` vollständig aus.
+
+## Vorgehen
+
+1. Bestätige kurz, dass du den Stil ab jetzt nutzt.
+2. Schreibe die Antwort direkt im Stil. Die Antwort ist zugleich das Beispiel.
+3. Prüfe vor dem Senden: Aktiv, kurze Sätze, ein Gedanke pro Satz, gleiche
+   Wörter, exakte Technik.
+4. Will der Nutzer den Stil dauerhaft, lege ein Memory an.
+
+## Grenzen
+
+Der Stil gilt für Fließtext. Er gilt nicht für Code, Log-Ausgaben,
+Fehlermeldungen oder Zitate. Diese gibst du unverändert wieder.

plugins/humhub/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "humhub",
-  "version": "0.1.0",
-  "description": "HumHub via REST-API: Wiki-Seiten und Posts auflisten, anzeigen, anlegen und aktualisieren (humhub.py).",
+  "version": "0.4.1",
+  "description": "HumHub via REST-API: Wiki-Seiten, Posts, Umfragen und Kommentare auflisten, anzeigen, anlegen und aktualisieren (humhub.py).",
   "author": {
     "name": "inmedias.it"
   }

plugins/humhub/skills/humhub/SKILL.md

@@ -1,13 +1,13 @@
 ---
 name: humhub
-description: HumHub Wiki-Seiten und Posts lesen/erstellen/aktualisieren via REST-API. Use when the user mentions "HumHub", "Space", "Wiki-Seite in HumHub" or "Post/Beitrag".
-version: 0.1.0
+description: HumHub Wiki-Seiten, Posts und Umfragen lesen/erstellen/aktualisieren via REST-API. Use when the user mentions "HumHub", "Space", "Wiki-Seite in HumHub", "Post/Beitrag" or "Umfrage/Poll".
+version: 0.2.0
 ---
 
 # HumHub (humhub.py)
 
 Interagiert mit HumHub (https://humhub.inmedias.it) über die REST-API:
-Wiki-Seiten und Posts auflisten, anzeigen, anlegen und aktualisieren — über die
+Wiki-Seiten, Posts und Umfragen auflisten, anzeigen, anlegen und aktualisieren — über die
 mitgelieferte, self-contained `humhub.py`.
 
 ## Ausführen
@@ -59,12 +59,110 @@ werden nicht committet).
 ./humhub.py post-update <id> [datei|-]
 ```
 
+### Umfragen
+
+```bash
+./humhub.py poll-list   <container_id> [--limit N]
+./humhub.py poll-create <container_id> "<frage>" --answers "A|B|C" \
+    [--file beschreibung.md] [--anonymous] [--multiple] [--hide-results]
+```
+
+Antwortoptionen mit `|` trennen, mindestens zwei. Der Beschreibungstext kommt
+wie überall aus einer Datei oder `-`; Markdown ist erlaubt. Ohne `--anonymous`
+ist sichtbar, wer wie gestimmt hat — bei Anmeldungen mit begrenzten Plätzen ist
+das der Sinn der Sache.
+
+Zwei Eigenheiten der Polls-API, die zu `HTTP 500 "Internal error while save a
+poll!"` führen, wenn man dem Muster der Post-API folgt: die Felder gehören
+unter den Yii-Formnamen **`Poll`** (nicht `data`), und die Optionen heißen beim
+Anlegen **`newAnswers`** (beim Lesen `answers`). Beim Lesen ist `limit` Pflicht
+und nicht Komfort — ohne Begrenzung antwortet die Instanz ab ~25 Umfragen
+ebenfalls mit 500. Ein fehlgeschlagener POST legt nichts an; vor einem zweiten
+Versuch trotzdem mit `poll-list` prüfen.
+
+### Kommentare
+
+```bash
+./humhub.py comment-list   <content-id|perma-url>            # Kommentare eines Inhalts
+./humhub.py comment-create <content-id|perma-url> [datei|-]  # Kommentar schreiben
+```
+
+Beide nehmen wie `fetch` eine **Content-ID** oder Perma-URL (nicht die Post-/
+Wiki-Seiten-ID) und lösen das Zielobjekt selbst auf — funktioniert für Posts
+und Wiki-Seiten.
+
+### Direktnachrichten
+
+```bash
+./humhub.py mail-send  <empfaenger> "<betreff>" [datei|-]          # Probelauf
+./humhub.py mail-send  <empfaenger> "<betreff>" [datei|-] --send   # senden
+./humhub.py mail-send  https://humhub.inmedias.it/u/serge/ "Betreff" entwurf.md
+./humhub.py mail-send  jan.stobbe,26 "Betreff" - --send
+./humhub.py mail-reply <konversations-id> [datei|-]
+./humhub.py mail-user-remove <konversations-id> <empfaenger>
+```
+
+Empfänger sind Benutzername, Profil-URL oder numerische ID; mehrere mit Komma.
+**Ohne `--send` wird nichts gesendet**, sondern nur aufgelöst und angezeigt,
+wer die Nachricht bekäme — der Probelauf ist der Default.
+
+**`recipient` will GUIDs, keine User-IDs.** `mail-send` löst jede Angabe
+deshalb bis zur GUID auf (`/user/<id>` liefert sie, die Benutzerliste je nach
+Fassung nicht). Mit numerischen IDs antwortet die API `400 Validation failed`
+und „Du kannst keine Nachricht ohne Empfänger senden!" — die Meldung klingt
+nach einem leeren Feld, obwohl das Feld gefüllt ist, und weist damit in die
+falsche Richtung.
+
+`mail-reply` hängt einen Beitrag an eine bestehende Konversation
+(`POST /mail/<id>/entry`). Die ID steht in der URL der Konversation:
+`…/mail/mail/index?id=35`.
+
+**Eine Fehlzustellung lässt sich nicht löschen.** `DELETE /mail/<id>` gibt es
+in dieser API-Version nicht (404, Route unbekannt), und über die Oberfläche
+kommt man auch nicht dran. Das einzige Gegenmittel ist
+`mail-user-remove`, das einen Teilnehmer wieder aus der Konversation nimmt
+(`DELETE /mail/<id>/user/<userid>`). Ob der Empfänger vorher schon eine
+Benachrichtigung bekommen hat, bleibt dabei offen.
+
+**Deshalb prüft `mail-send` nach dem Versand die Teilnehmerliste.** Eine
+falsche Kennung in `recipient` führt nicht verlässlich zu einer
+Fehlermeldung: am 25.09.2026 hat die API einen Versand mit numerischen IDs
+mit `HTTP 200` quittiert und die Nachricht an einen **anderen** Benutzer
+zugestellt. Der Befehl gibt deshalb aus, wer die Konversation tatsächlich
+bekommen hat, und nennt bei einer Abweichung das `mail-user-remove`-Kommando.
+Die Teilnehmerliste kann direkt nach dem Anlegen unvollständig sein — im
+Zweifel noch einmal nachsehen, bevor man daraus einen Schluss zieht.
+
+Zwei Routen, zwei Kennungen: `POST /mail` will die **GUID**,
+`DELETE /mail/<id>/user/<userid>` die **numerische ID**. Beides ist im
+Skript gekapselt, `mail-user-remove` nimmt wie alle Befehle Benutzername,
+Profil-URL oder ID.
+
+**Slug ≠ Benutzername.** Zur Profil-URL `/u/serge/` gehört der Benutzername
+`Serge`, und `get-by-username` unterscheidet Groß-/Kleinschreibung. Wer den
+Slug einsetzt, bekommt sonst `User not found!`. `mail-send` fängt das ab: erst
+`get-by-username`, dann ein Durchlauf der Benutzerliste, der Benutzername und
+Slug ohne Rücksicht auf Groß-/Kleinschreibung vergleicht.
+
+Zum Lesen von Konversationen gibt es bewusst keinen Befehl — Nachrichten
+anderer gehören nicht ungefragt in einen Modellkontext. Auch `mail-reply`
+holt den Verlauf nicht ab, sondern prüft nur, ob die Konversation erreichbar
+ist.
+
 Inhalte (Markdown) aus Datei oder `-` (stdin) übergeben — nicht als langes
 Shell-Argument (Sonderzeichen). `container_id` akzeptiert eine numerische
 Container-ID, einen **Space-Slug** oder eine **Space-URL** (`resolve_container`
 löst Slug/URL selbst auf). Passende Container per `space-list` ermitteln, Seiten
 per `wiki-list` / `post-list`.
 
+**HumHub macht aus Zeichenfolgen wie `:)` Emojis — auch mitten im Fachtext.**
+Am 08.10.2026 wurde aus „(0.0.0.0 und ::)“ ein „(0.0.0.0 und :😃“: der zweite
+Doppelpunkt der IPv6-Adresse `::` bildete mit der schließenden Klammer ein
+Smiley. Betroffen sind typisch IPv6-Adressen (`::`, `::1`, `[::]:3306`),
+Portangaben und Pfade direkt vor `)` oder `(`. **Solche Werte immer in
+Backticks setzen** — in Inline-Code ersetzt HumHub nichts. Vor dem Absenden
+den Text außerhalb von Backticks auf `:)`, `:(`, `;)`, `:D`, `:P` prüfen.
+
 ## Zugangsdaten
 
 `humhub.py` bringt **keinen** Token mit. Jede/r hinterlegt ein eigenes

plugins/humhub/skills/humhub/humhub.py

@@ -212,6 +212,61 @@ def cmd_post_create(args: argparse.Namespace) -> None:
         print(f"Topics: {', '.join(saved_topics)}")
 
 
+def cmd_poll_list(args: argparse.Namespace) -> None:
+    session, _ = get_session()
+    container_id = resolve_container(session, args.container_id)
+    # limit ist Pflicht, nicht Komfort: ohne Begrenzung antwortet die Instanz
+    # bei vielen Umfragen mit HTTP 500 statt mit einer Liste.
+    data = api_get(session, f"/polls/container/{container_id}?limit={args.limit}")
+    results = data.get("results", [])
+    if not results:
+        print("(keine Umfragen)")
+        return
+    for poll in results:
+        antworten = [a.get("answer", "") for a in poll.get("answers", [])]
+        zu = " [geschlossen]" if poll.get("closed") else ""
+        print(f"ID {poll.get('id')}{zu}: {poll.get('question', '')}")
+        print(f"    {' | '.join(antworten)}")
+
+
+def cmd_poll_create(args: argparse.Namespace) -> None:
+    """Umfrage anlegen.
+
+    Zwei Abweichungen von der Post-API, die beide mit HTTP 500
+    ("Internal error while save a poll!") enden, wenn man sie übersieht:
+
+      * Der Controller macht `$poll->load(Yii::$app->request->post())` — Yii
+        erwartet die Felder deshalb unter dem Formnamen **`Poll`**, nicht unter
+        `data` wie bei Posts und Wiki-Seiten.
+      * Die Optionen heißen beim Anlegen **`newAnswers`**; `answers` ist die
+        Leseform und wird beim POST ignoriert.
+
+    Quelle: humhub/polls, controllers/rest/PollsController.php + models/Poll.php.
+    Pflicht sind `question` und mindestens zwei Antworten.
+    """
+    session, _ = get_session()
+    container_id = resolve_container(session, args.container_id)
+    antworten = [a.strip() for a in args.answers.split("|") if a.strip()]
+    if len(antworten) < 2:
+        sys.exit("Error: mindestens zwei Antwortoptionen nötig "
+                 "(--answers 'Ja|Nein').")
+    beschreibung = read_file(args.file) if args.file else ""
+
+    payload = {"Poll": {
+        "question": args.question,
+        "description": beschreibung,
+        "newAnswers": antworten,
+        "anonymous": 1 if args.anonymous else 0,
+        "allow_multiple": 1 if args.multiple else 0,
+        "show_result_after_close": 1 if args.hide_results else 0,
+        "is_random": 0,
+    }}
+    data = api_post(session, f"/polls/container/{container_id}", payload)
+    print(f"Umfrage erstellt (ID {data.get('id')}): {data.get('question')}")
+    print("Optionen: " + " | ".join(a.get("answer", "")
+                                    for a in data.get("answers", [])))
+
+
 def cmd_post_update(args: argparse.Namespace) -> None:
     session, _ = get_session()
     message = read_file(args.file)
@@ -251,6 +306,211 @@ def cmd_space_list(args: argparse.Namespace) -> None:
         print("(keine Spaces gefunden)")
 
 
+# ── Comment commands ─────────────────────────────────────────────────────────
+
+def cmd_comment_list(args: argparse.Namespace) -> None:
+    session, _ = get_session()
+    content_id = parse_content_ref(args.ref)
+    data = api_get(session, f"/comment/content/{content_id}")
+    results = data.get("results", data if isinstance(data, list) else [])
+    if not results:
+        print("(keine Kommentare)")
+        return
+    for c in results:
+        cid = c.get("id")
+        author = (c.get("createdBy") or {}).get("display_name", "?")
+        created = c.get("createdAt", "")
+        msg = (c.get("message") or "").replace("\n", " ")[:100]
+        print(f"ID {cid:>5}  [{created}] {author}: {msg}")
+
+
+def cmd_comment_create(args: argparse.Namespace) -> None:
+    session, _ = get_session()
+    content_id = parse_content_ref(args.ref)
+    message = read_file(args.file)
+
+    envelope = api_get(session, f"/content/{content_id}")
+    meta = envelope.get("metadata", {})
+    model = meta.get("object_model", "")
+    object_id = meta.get("object_id")
+    if not model or not object_id:
+        sys.exit(f"Error: Content {content_id} nicht auflösbar (object_model/object_id fehlen)")
+
+    payload = {
+        "objectModel": model,
+        "objectId": object_id,
+        "Comment": {"message": message},
+    }
+    data = api_post(session, "/comment", payload)
+    cid = data.get("id")
+    short_model = model.split("\\")[-1]
+    print(f"Kommentar erstellt (ID {cid}) auf {short_model} {object_id}")
+    print(f"Perma: https://humhub.inmedias.it/content/perma?id={content_id}")
+
+
+# ── Mail (Direktnachrichten) ─────────────────────────────────────────────────
+
+def user_guid(session: requests.Session, user: dict) -> str:
+    """GUID eines Benutzers, notfalls über /user/<id> nachgeladen.
+
+    Die Benutzerliste liefert die GUID je nach Fassung nicht mit.
+    """
+    guid = user.get("guid") or (user.get("account") or {}).get("guid")
+    if guid:
+        return str(guid)
+    uid = user.get("id") or (user.get("account") or {}).get("id")
+    return str(api_get(session, f"/user/{uid}")["guid"])
+
+
+def resolve_user_info(session: requests.Session, value: str) -> dict:
+    """Benutzerdatensatz zu numerischer ID, Benutzername oder Profil-URL.
+
+    Slug und Benutzername sind nicht dasselbe: zu https://…/u/serge/ gehört der
+    Benutzername "Serge". `get-by-username` kennt nur den Benutzernamen und
+    unterscheidet Groß-/Kleinschreibung — deshalb der Fallback über die
+    Benutzerliste, der auch den Slug vergleicht.
+    """
+    value = value.strip()
+    if value.isdigit():
+        return api_get(session, f"/user/{int(value)}")
+    name = value
+    if "/" in value:
+        teile = [t for t in urlparse(value).path.split("/") if t]
+        if teile:
+            name = teile[-1]
+
+    r = session.get(f"{BASE_URL}/user/get-by-username",
+                    params={"username": name})
+    if r.ok:
+        return r.json()
+
+    page = 1
+    while True:
+        data = api_get(session, f"/user?limit=50&page={page}")
+        results = data.get("results", [])
+        for u in results:
+            username = (u.get("account") or {}).get("username", "")
+            slug_teile = [t for t in urlparse(u.get("url", "")).path.split("/") if t]
+            slug = slug_teile[-1] if slug_teile else ""
+            if name.lower() in (username.lower(), slug.lower()):
+                return u
+        if len(results) < 50:
+            break
+        page += 1
+    sys.exit(f"Error: Benutzer {value!r} nicht gefunden")
+
+
+def resolve_user(session: requests.Session, value: str) -> str:
+    """Resolve a user ID, username, or profile URL (…/u/<slug>/) to a user GUID.
+
+    **GUID, nicht ID.** `POST /mail` nimmt als `recipient` ausschließlich
+    GUIDs an; mit numerischen IDs antwortet die API `400 Validation failed`
+    und „Du kannst keine Nachricht ohne Empfänger senden!" — eine Meldung,
+    die nach einem leeren Feld klingt, obwohl das Feld gefüllt ist.
+    """
+    return user_guid(session, resolve_user_info(session, value))
+
+
+def mail_teilnehmer(session: requests.Session, conv_id: int) -> list[dict]:
+    """Teilnehmer einer Konversation. Leere Liste, wenn nicht lesbar."""
+    r = session.get(f"{BASE_URL}/mail/{conv_id}/users")
+    if not r.ok:
+        return []
+    daten = r.json()
+    return daten if isinstance(daten, list) else daten.get("results", [])
+
+
+def eigene_guid(session: requests.Session) -> str:
+    """GUID des eigenen Kontos, leer wenn nicht ermittelbar."""
+    r = session.get(f"{BASE_URL}/user/me")
+    return str(r.json().get("guid", "")) if r.ok else ""
+
+
+def cmd_mail_send(args: argparse.Namespace) -> None:
+    session, _ = get_session()
+    leute = [resolve_user_info(session, teil)
+             for teil in args.to.split(",") if teil.strip()]
+    if not leute:
+        sys.exit("Error: kein Empfänger angegeben")
+    guids = [user_guid(session, u) for u in leute]
+    namen = {g: u.get("display_name", "?") for g, u in zip(guids, leute)}
+    for g in guids:
+        print(f"Empfänger: {namen[g]} ({g})")
+    if not args.send:
+        print("PROBELAUF — nichts gesendet. Mit --send abschicken.")
+        return
+
+    message = read_file(args.file)
+    data = api_post(session, "/mail", {
+        "title": args.title,
+        "message": message,
+        "recipient": guids,
+    })
+    conv_id = data.get("id")
+    print(f"Nachricht gesendet (Konversation {conv_id})")
+
+    # Gegenprobe. Am 25.09.2026 hat die API eine Nachricht mit numerischen IDs
+    # in `recipient` mit HTTP 200 quittiert und sie an einen *anderen*
+    # Benutzer zugestellt — sie meldet einen falschen Empfaenger also nicht
+    # zwingend als Fehler. Deshalb nach jedem Versand nachsehen, wer die
+    # Konversation tatsaechlich bekommen hat. Loeschen laesst sie sich nicht
+    # (`DELETE /mail/<id>` gibt es nicht), nur Teilnehmer entfernen.
+    teilnehmer = mail_teilnehmer(session, conv_id)
+    if not teilnehmer:
+        print("ACHTUNG: Teilnehmerliste nicht lesbar — Zustellung nicht geprüft.")
+        return
+    print("Teilnehmer laut Server:")
+    for u in teilnehmer:
+        print(f"  {u.get('display_name')} ({u.get('guid')})")
+    drin = {str(u.get("guid")) for u in teilnehmer}
+    ich = eigene_guid(session)
+    fehlend = [g for g in guids if g not in drin]
+    fremd = [u for u in teilnehmer
+             if str(u.get("guid")) not in guids and str(u.get("guid")) != ich]
+    if fehlend:
+        print("ACHTUNG: nicht zugestellt an " +
+              ", ".join(f"{namen[g]} ({g})" for g in fehlend))
+    if fremd:
+        print("ACHTUNG: unerwartete Teilnehmer — entfernen mit:")
+        for u in fremd:
+            print(f"  ./humhub.py mail-user-remove {conv_id} {u.get('id')}")
+
+
+def cmd_mail_user_remove(args: argparse.Namespace) -> None:
+    """Nimmt einen Teilnehmer aus einer Konversation.
+
+    Der einzige Weg, eine Fehlzustellung zurueckzunehmen: die Konversation
+    selbst laesst sich weder ueber die API noch ueber die Oberflaeche
+    loeschen. Anders als beim Versand will diese Route die **numerische ID**,
+    nicht die GUID.
+    """
+    session, _ = get_session()
+    user = resolve_user_info(session, args.user)
+    uid = user.get("id")
+    r = session.delete(f"{BASE_URL}/mail/{args.id}/user/{uid}")
+    if not r.ok:
+        sys.exit(f"Error {r.status_code}: {r.text[:200]}")
+    print(f"{user.get('display_name')} (ID {uid}) aus Konversation "
+          f"{args.id} entfernt. Verbleibend:")
+    for u in mail_teilnehmer(session, args.id):
+        print(f"  {u.get('display_name')} ({u.get('guid')})")
+
+
+def cmd_mail_reply(args: argparse.Namespace) -> None:
+    """Antwortet in einer bestehenden Konversation.
+
+    Bewusst ohne Lesebefehl: der Text der Konversation wird nicht abgerufen,
+    nur ihre Erreichbarkeit geprueft.
+    """
+    session, _ = get_session()
+    message = read_file(args.file)
+    r = session.get(f"{BASE_URL}/mail/{args.id}")
+    if not r.ok:
+        sys.exit(f"Error {r.status_code}: Konversation {args.id} nicht erreichbar")
+    data = api_post(session, f"/mail/{args.id}/entry", {"message": message})
+    print(f"Antwort geschrieben (Eintrag {data.get('id')}) in Konversation {args.id}")
+
+
 # ── Fetch (perma-/content-id-agnostisch) ─────────────────────────────────────
 
 def parse_content_ref(ref: str) -> int:
@@ -405,6 +665,39 @@ def main() -> None:
     p.add_argument("--topics", default=None, help="Komma-getrennte Topic-Namen")
     p.set_defaults(func=cmd_post_create)
 
+    # comment-list
+    p = sub.add_parser("comment-list", help="Kommentare eines Inhalts auflisten")
+    p.add_argument("ref", help="Content-ID oder Perma-Link (…/content/perma?id=NNNN)")
+    p.set_defaults(func=cmd_comment_list)
+
+    # comment-create
+    p = sub.add_parser("comment-create", help="Kommentar auf einen Inhalt (Post/Wiki-Seite) schreiben")
+    p.add_argument("ref", help="Content-ID oder Perma-Link (…/content/perma?id=NNNN)")
+    p.add_argument("file", help="Markdown-Datei oder '-' für stdin")
+    p.set_defaults(func=cmd_comment_create)
+
+    # mail-send
+    p = sub.add_parser("mail-send", help="Direktnachricht an Benutzer senden")
+    p.add_argument("to", help="Benutzername, Profil-URL oder ID; mehrere mit Komma")
+    p.add_argument("title", help="Betreff")
+    p.add_argument("file", help="Markdown-Datei oder '-' für stdin")
+    p.add_argument("--send", action="store_true",
+                   help="wirklich senden (ohne: Probelauf mit Empfängernamen)")
+    p.set_defaults(func=cmd_mail_send)
+
+    # mail-user-remove
+    p = sub.add_parser("mail-user-remove",
+                       help="Teilnehmer aus einer Konversation entfernen (Fehlzustellung)")
+    p.add_argument("id", type=int, help="Konversations-ID")
+    p.add_argument("user", help="Benutzername, Profil-URL oder ID")
+    p.set_defaults(func=cmd_mail_user_remove)
+
+    # mail-reply
+    p = sub.add_parser("mail-reply", help="In einer bestehenden Konversation antworten")
+    p.add_argument("id", type=int, help="Konversations-ID (aus /mail/mail/index?id=NN)")
+    p.add_argument("file", help="Markdown-Datei oder '-' für stdin")
+    p.set_defaults(func=cmd_mail_reply)
+
     # post-update
     p = sub.add_parser("post-update", help="Post aktualisieren")
     p.add_argument("id", type=int, help="Post-ID")
@@ -412,6 +705,27 @@ def main() -> None:
     p.add_argument("--topics", default=None, help="Komma-getrennte Topic-Namen (ersetzt bestehende)")
     p.set_defaults(func=cmd_post_update)
 
+    # poll-list
+    p = sub.add_parser("poll-list", help="Umfragen eines Containers auflisten")
+    p.add_argument("container_id", help="Space-Slug, URL oder numerische Container-ID")
+    p.add_argument("--limit", type=int, default=10, help="Max. Anzahl (Standard: 10)")
+    p.set_defaults(func=cmd_poll_list)
+
+    # poll-create
+    p = sub.add_parser("poll-create", help="Neue Umfrage anlegen")
+    p.add_argument("container_id", help="Space-Slug, URL oder numerische Container-ID")
+    p.add_argument("question", help="Die Frage (Pflicht)")
+    p.add_argument("--answers", required=True,
+                   help="Antwortoptionen, mit | getrennt: 'Ja|Nein|Vielleicht' "
+                        "(mindestens zwei)")
+    p.add_argument("--file", default=None,
+                   help="Markdown-Datei mit dem Beschreibungstext, '-' für stdin")
+    p.add_argument("--anonymous", action="store_true", help="anonyme Abstimmung")
+    p.add_argument("--multiple", action="store_true", help="Mehrfachauswahl erlauben")
+    p.add_argument("--hide-results", action="store_true",
+                   help="Ergebnis erst nach Ende der Umfrage zeigen")
+    p.set_defaults(func=cmd_poll_create)
+
     args = parser.parse_args()
     args.func(args)
 

plugins/klare-sprache/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "klare-sprache",
+  "version": "0.1.0",
+  "description": "Texte in klarer, verständlicher Sprache nach ISO 24495-1:2023 (Plain Language) schreiben oder überarbeiten: zielgruppen- und prozessorientiert — finden, verstehen, nutzen.",
+  "author": {
+    "name": "inmedias.it"
+  }
+}

plugins/klare-sprache/skills/klare-sprache/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: klare-sprache
+description: Texte in klarer, verständlicher Sprache nach ISO 24495-1:2023 (Plain Language) schreiben oder überarbeiten. Use when the user asks for clear/plain/accessible language, mentions "klare Sprache", "verständlich schreiben", "plain language", "ISO 24495", "bürgernah", "leicht verständlich", "an die Zielgruppe anpassen", or wants a text a specific audience can easily find, understand, and use.
+version: 0.1.0
+---
+
+# Klare Sprache (ISO 24495-1:2023)
+
+Dieser Skill schreibt und überarbeitet Texte nach den Leitprinzipien der
+ISO 24495-1:2023 („Plain language — Part 1"). Ziel: Die vorgesehenen Leser
+finden leicht, was sie brauchen, verstehen es und können danach handeln.
+
+Anders als starre Regelwerke (Wortlisten, feste Satzlängen) ist ISO 24495-1
+**prinzipien- und prozessorientiert**. Der Maßstab ist nicht „einfach an sich",
+sondern **passend für die konkrete Zielgruppe und ihren Zweck**.
+
+## Wann anwenden
+
+Wende den Skill an, wenn der Nutzer einen Text verständlich für eine bestimmte
+Zielgruppe braucht (Kunden-Doku, Anleitungen, Formulare, Briefe, Web-Texte,
+Bescheide). Für einen festen, normierten Schreibstil in der internen Technik-
+Doku passt eher [[einfaches-technisches-deutsch]].
+
+## Kerndefinition
+
+Ein Text ist in klarer Sprache, wenn Wortwahl, Struktur und Gestaltung so klar
+sind, dass die vorgesehenen Leser leicht
+
+1. **finden**, was sie brauchen,
+2. **verstehen**, was sie finden, und
+3. **nutzen** können, was sie verstanden haben.
+
+## Ablauf
+
+1. **Zielgruppe und Zweck klären.** Wer liest? Welches Vorwissen? Was soll die
+   Person danach wissen oder tun? Ist das unklar, frage kurz nach — ohne
+   Zielgruppe lässt sich „klar" nicht beurteilen.
+2. **Schreiben/Überarbeiten** nach den vier Prinzipien (unten).
+3. **Prüfen** gegen die Checkliste; wenn möglich, aus Lesersicht gegenlesen.
+4. **Kurz zurückmelden**, welche Zielgruppe angenommen wurde und was geändert
+   wurde.
+
+## Die vier Prinzipien mit Checkliste
+
+### 1. Relevant — Leser bekommen, was sie brauchen
+- Inhalt an Zielgruppe und Zweck ausrichten.
+- Vorwissen und Bedarf der Leser berücksichtigen.
+- Unnötiges weglassen; das Wichtigste zuerst.
+
+### 2. Auffindbar — Leser finden es leicht
+- Logische, erwartbare Reihenfolge.
+- Aussagekräftige Überschriften und Zwischenüberschriften.
+- Gliederung, Listen, Hervorhebungen; klares Layout und Navigation.
+
+### 3. Verständlich — Leser verstehen es beim ersten Lesen
+- Gebräuchliche Wörter; Fachbegriffe und Abkürzungen erklären oder ersetzen.
+- Kurze, klar gebaute Sätze; ein Gedanke pro Satz.
+- Aktiv statt Passiv; die Leser direkt ansprechen.
+- Beispiele, wo sie helfen.
+
+### 4. Nutzbar — Leser können danach handeln
+- Handlungsschritte klar und in der richtigen Reihenfolge.
+- Sagen, wer was tun muss.
+- Den Text an einer echten Aufgabe prüfen und überarbeiten.
+
+## Technische Angaben bleiben exakt
+
+Klarheit betrifft die Sprache, nicht die Fakten. Dateipfade, Befehle,
+Funktions- und Feldnamen, Preise, Zahlen und Fristen bleiben unverändert.
+
+## Grenzen
+
+- Der Skill setzt die **Prinzipien** der Norm um; er gibt nicht den geschützten
+  Normtext wieder und bescheinigt keine formale Konformität.
+- Gilt für Fließtext und Struktur, nicht für Code, Log-Ausgaben oder Zitate.
+- Ohne bekannte Zielgruppe zuerst nachfragen.

plugins/mediawiki/skills/mediawiki/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: mediawiki
-description: MediaWiki-Seiten und -Templates lesen, rendern und schreiben. Use when editing/fetching wiki pages (wiki.inmedias.it, devwiki.inmedias.it) or when the user mentions "wiki", "Vorlage/Template", "Kundenseite".
-version: 0.1.0
+description: MediaWiki-Seiten und -Templates lesen, rendern, schreiben und deren Parser-Cache leeren. Use when editing/fetching wiki pages (wiki.inmedias.it, devwiki.inmedias.it) or when the user mentions "wiki", "Vorlage/Template", "Kundenseite", or when a page shows stale API data.
+version: 0.2.0
 ---
 
 # MediaWiki (wiki.py)
@@ -37,6 +37,8 @@ oder anderen direkten Server-Eingriffen. Reine Lese-/Render-Checks
 ./wiki.py -w devwiki search "Suchbegriff" [-n <namespace>]        # Titelsuche
 ./wiki.py -w devwiki update "Kunde:Beispiel GmbH" datei.wiki --summary "..."   # speichern
 ./wiki.py -w wiki    update "Titel" -    --summary "..."          # Inhalt von stdin
+./wiki.py -w wiki    purge  "Titel" ["Titel 2" ...] [--links]     # Parser-Cache leeren
+./wiki.py -w wiki    upload /pfad/bild.png bild.png --description "..."        # Datei hochladen
 ```
 
 Tipp: Beim Schreiben den Inhalt aus einer Datei (`datei.wiki`) oder `-` (stdin)
@@ -57,6 +59,27 @@ dann `.env` im aktuellen Verzeichnis, dann bereits gesetzte Env-Variablen). Sieh
 
 Es empfiehlt sich ein eigener Bot-/Service-Account mit den nötigen Schreibrechten.
 
+## Seiten, die ihre Daten aus einer API holen
+
+Vorlagen mit `#get_web_data` (External Data) werden **nicht** bei jedem
+Seitenaufruf ausgeführt. MediaWiki liefert die Seite aus dem Parser-Cache und
+fragt die API gar nicht erst an. Ändern sich die Daten hinter der API, zeigt
+die Seite weiter beliebig alte Werte — ohne Fehlermeldung, ohne dass es
+jemandem auffällt.
+
+Deshalb gehört nach jedem Datenupload ein Purge:
+
+```bash
+./wiki.py -w wiki purge "Nextcloud (Hosting)"
+```
+
+`--links` schaltet zusätzlich `forcelinkupdate` ein (langsamer, aktualisiert
+die Linktabellen) — für reine Datenaktualisierungen nicht nötig.
+
+Das betrifft auch die Fehlersuche: Wer nach einer Änderung `render` aufruft und
+die alten Werte sieht, hat meist nicht die Daten kaputt, sondern nur den Cache
+vor sich. Erst purgen, dann urteilen.
+
 ## Hinweise
 - `search` liefert Titel; `render` ist nützlich, um vor/nach dem Schreiben das
   Ergebnis zu prüfen, ohne die Seite im Browser zu öffnen.

plugins/mediawiki/skills/mediawiki/wiki.py

@@ -110,6 +110,25 @@ def cmd_render(args: argparse.Namespace) -> None:
     print(result["parse"]["text"]["*"], end="")
 
 
+def cmd_purge(args: argparse.Namespace) -> None:
+    """Parser-Cache einer oder mehrerer Seiten leeren.
+
+    Noetig fuer Seiten, die ihre Daten per #get_web_data aus einer API holen:
+    MediaWiki rendert sonst aus dem Parser-Cache weiter und fragt die API gar
+    nicht erst an - die Seite zeigt dann beliebig alte Werte, ohne dass das
+    irgendwo auffaellt.
+    """
+    site = get_site(args.wiki)
+    result = site.api("purge", titles="|".join(args.titles),
+                      forcelinkupdate=1 if args.links else None)
+    for entry in result.get("purge", []):
+        title = entry.get("title", "?")
+        if "missing" in entry:
+            print(f"Error: page '{title}' does not exist", file=sys.stderr)
+        else:
+            print(f"Purged '{title}'")
+
+
 def cmd_upload(args: argparse.Namespace) -> None:
     path = Path(args.file_path)
     if not path.exists():
@@ -161,6 +180,12 @@ def main() -> None:
     render_p.add_argument("title", help="Page title")
     render_p.set_defaults(func=cmd_render)
 
+    purge_p = sub.add_parser("purge", help="Clear the parser cache of one or more pages")
+    purge_p.add_argument("titles", nargs="+", help="Page title(s)")
+    purge_p.add_argument("--links", action="store_true",
+                         help="Also run forcelinkupdate (slower, updates link tables)")
+    purge_p.set_defaults(func=cmd_purge)
+
     upload_p = sub.add_parser("upload", help="Upload a local file to the wiki file store")
     upload_p.add_argument("file_path", help="Absolute path to the local file")
     upload_p.add_argument("wiki_filename", help="Target filename on the wiki (without 'File:' prefix)")

plugins/redmine/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "redmine",
+  "version": "0.2.0",
+  "description": "Redmine via REST-API: Projekte/Tickets/Versionen/News auflisten, anlegen, aktualisieren, kommentieren (redmine.py).",
+  "author": {
+    "name": "inmedias.it"
+  }
+}

plugins/redmine/skills/redmine/.env.example

@@ -0,0 +1,5 @@
+# Redmine REST-API — Zugangsdaten (Kopie nach .env, Werte eintragen)
+# API-Key: https://redmine.inmedias.it/my/account  → rechts "API-Zugriffsschlüssel"
+
+REDMINE_URL=https://redmine.inmedias.it
+REDMINE_API_KEY=

plugins/redmine/skills/redmine/SKILL.md

@@ -0,0 +1,119 @@
+---
+name: redmine
+description: Redmine-Projekte, -Tickets, -Versionen und -News lesen/anlegen/aktualisieren via REST-API. Use when the user mentions "Redmine", "Ticket", "Issue in Redmine", "Meilenstein/Milestone/Version", "Projektstand/News" or die Projekte "pg-wissen"/"devops".
+version: 0.2.0
+---
+
+# Redmine (redmine.py)
+
+Interagiert mit Redmine (https://redmine.inmedias.it) über die REST-API:
+Projekte, Tickets, Versionen und News auflisten, anzeigen, anlegen,
+aktualisieren und kommentieren - über die mitgelieferte, self-contained
+`redmine.py`. Namen werden auf IDs aufgelöst (Projekt, Tracker, Status,
+Priorität, Version).
+
+## Ausführen
+
+`redmine.py` ist ein eigenständiges `uv run --script` (Inline-Deps: `requests`,
+`python-dotenv`). Aus dem Skill-Verzeichnis:
+
+```bash
+./redmine.py <befehl> ...
+```
+
+`--json` (vor dem Befehl) gibt jeweils die Rohdaten aus.
+
+### Kontext & Stammdaten
+
+```bash
+./redmine.py me                       # aktueller Benutzer (id, admin?, mail)
+./redmine.py projects                 # sichtbare Projekte (id, identifier, name)
+./redmine.py meta trackers            # Stammdaten: trackers | statuses | priorities
+```
+
+### Tickets auflisten / anzeigen
+
+```bash
+./redmine.py issues --project pg-wissen                # offene Tickets (Default)
+./redmine.py issues --project pg-wissen --status '*'   # alle (open|closed|*|Status-ID)
+./redmine.py issues --assigned me --sort priority:desc
+./redmine.py issues --query "Wiki" --limit 20          # Volltext im Betreff (~-Suche)
+./redmine.py show 290 [--notes]                        # Ticket (optional mit Journalen)
+```
+
+### Anlegen / Aktualisieren / Kommentieren
+
+`--project` und `--subject` sind bei `create` Pflicht. Beschreibung inline
+(`--description`) oder aus Datei/stdin (`--description-file -`) übergeben - nicht
+als langes Shell-Argument (Sonderzeichen). Weitere Felder: `--tracker`,
+`--status`, `--priority`, `--assigned me`, `--parent <id>`, `--version <name|id>`,
+`--done <0-100>`.
+
+```bash
+./redmine.py create --project pg-wissen --subject "Titel" \
+    --tracker Feature --description-file - < body.md
+./redmine.py update 290 --status Erledigt --done 100 --notes "erledigt"
+./redmine.py comment 290 "kurzer Kommentar"
+```
+
+### Versionen (Meilensteine)
+
+Versionen tragen die grobe Reihenfolge und speisen die Roadmap-Ansicht.
+
+```bash
+./redmine.py versions --project devops                        # auflisten
+./redmine.py versions --project devops --name "Phase 1" \
+    --due 2026-10-15 --description "Was in dieser Phase zu tun ist"
+./redmine.py create --project devops --subject "Schritt" --version "Phase 1"
+./redmine.py update 350 --version 23                          # ohne --project: ID
+```
+
+Ein Versionsname lässt sich nur mit `--project` auflösen, weil Versionen zu
+einem Projekt gehören. Bei `update` ist `--project` meist nicht angegeben -
+dort die Versions-ID verwenden.
+
+Anlegen erfordert das Recht *manage_versions*.
+
+### News (Projektstand, Ankündigungen)
+
+```bash
+./redmine.py news --project devops                            # auflisten
+./redmine.py news --project devops --title "Kurzer Titel" \
+    --summary "Eine Zeile für die Übersicht" \
+    --description-file text.md
+./redmine.py news --id 1 --description-file korrigiert.md     # ändern
+```
+
+Zwei Eigenheiten der Redmine-API:
+
+- **Der Titel darf höchstens 60 Zeichen haben**, sonst HTTP 422. `redmine.py`
+  prüft das vorab.
+- Die Antwort beim Anlegen enthält **keine News-ID**; der Befehl gibt deshalb
+  die Projekt-URL aus statt eines toten Direktlinks. Ändern per `--id` geht
+  trotzdem (`PUT /news/{id}.json`).
+
+Format ist Markdown, wie bei Tickets.
+
+## Zugangsdaten
+
+`redmine.py` bringt **keinen** Schlüssel mit. Jede/r hinterlegt einen eigenen
+API-Key als Umgebungsvariable oder in einer dotenv-Datei (Reihenfolge:
+`~/.config/dokumentierer/.env`, dann Datei im Arbeitsverzeichnis, dann bereits
+gesetzte Env-Variablen). Siehe `.env.example`:
+
+- `REDMINE_URL` — Basis-URL (z.B. `https://redmine.inmedias.it`)
+- `REDMINE_API_KEY` — persönlicher API-Zugriffsschlüssel unter
+  https://redmine.inmedias.it/my/account (rechts „API-Zugriffsschlüssel"). Fehlt
+  der Schlüssel dort, ist der REST-Webservice noch nicht aktiviert
+  (Administration → Konfiguration → API).
+
+## Hinweise
+
+- Schreibzugriff nur in Projekten mit „Add/Edit issues"-Recht; ein Nicht-Admin
+  kann keine Tickets in fremden Projekten ändern.
+- **Ticket-Beziehungen** (`blocks`, `relates`, `precedes`) deckt `redmine.py`
+  nicht ab - dafür `POST /issues/<id>/relations.json`. Ein Ticket kann nicht mit
+  einem eigenen Unterticket verknüpft werden (HTTP 422).
+- Die Priorität eines Elterntickets leitet Redmine aus den Unteraufgaben ab;
+  ein von Hand gesetzter Wert wird überschrieben. Abschaltbar unter
+  Administration → Konfiguration → „Attribute übergeordneter Tickets".

plugins/redmine/skills/redmine/redmine.py

@@ -0,0 +1,403 @@
+#!/usr/bin/env -S uv run --script
+# /// script
+# requires-python = ">=3.11"
+# dependencies = [
+#   "requests",
+#   "python-dotenv",
+# ]
+# ///
+"""CLI für Redmine via REST-API: Projekte/Tickets auflisten, anlegen, aktualisieren, kommentieren.
+
+Zugangsdaten aus .env: REDMINE_URL, REDMINE_API_KEY.
+
+Beispiele:
+    uv run redmine.py me
+    uv run redmine.py projects
+    uv run redmine.py issues --project pg-wissen --status open
+    uv run redmine.py show 42 --notes
+    uv run redmine.py create --project pg-wissen --subject "Titel" --description - < body.md
+    uv run redmine.py update 42 --status Erledigt --notes "gefixt"
+    uv run redmine.py comment 42 "kurzer Kommentar"
+    uv run redmine.py meta trackers
+    uv run redmine.py versions --project devops
+    uv run redmine.py versions --project devops --name "Phase 1" --due 2026-10-15
+    uv run redmine.py create --project devops --subject "Titel" --version "Phase 1"
+    uv run redmine.py news --project devops
+    uv run redmine.py news --project devops --title "Kurz" --description-file text.md
+    uv run redmine.py news --id 1 --description-file korrigiert.md
+"""
+
+import argparse
+import json
+import os
+import sys
+from pathlib import Path
+
+import requests
+from dotenv import load_dotenv
+
+
+def session() -> tuple[requests.Session, str]:
+    load_dotenv(Path.home() / ".config/dokumentierer/.env")
+    load_dotenv()  # CWD/Projektverzeichnis
+    url = os.environ.get("REDMINE_URL", "").rstrip("/")
+    key = os.environ.get("REDMINE_API_KEY", "")
+    if not url or not key:
+        sys.exit("Fehler: REDMINE_URL und/oder REDMINE_API_KEY fehlen in der .env")
+    s = requests.Session()
+    s.headers.update({"X-Redmine-API-Key": key, "Content-Type": "application/json"})
+    s.base = url
+    return s, url
+
+
+def api(s, method: str, path: str, **kw) -> dict:
+    r = s.request(method, f"{s.base}{path}", **kw)
+    if not r.ok:
+        sys.exit(f"Fehler {r.status_code} bei {method} {path}: {r.text[:400]}")
+    if r.status_code == 204 or not r.content:
+        return {}
+    return r.json()
+
+
+def paged(s, path: str, root: str, params: dict | None = None, cap: int = 1000) -> list:
+    """Alle Seiten einer Redmine-Collection einsammeln."""
+    params = dict(params or {})
+    out, offset = [], 0
+    while True:
+        params.update({"limit": 100, "offset": offset})
+        d = api(s, "GET", path, params=params)
+        items = d.get(root, [])
+        out += items
+        total = d.get("total_count", len(out))
+        offset += len(items)
+        if not items or offset >= total or len(out) >= cap:
+            break
+    return out
+
+
+# ---- Auflösen von Namen/Identifiern auf IDs -----------------------------------
+
+def resolve_project(s, value: str) -> int:
+    if value.isdigit():
+        return int(value)
+    for p in paged(s, "/projects.json", "projects"):
+        if value in (p.get("identifier"), p.get("name")):
+            return p["id"]
+    sys.exit(f"Projekt nicht gefunden: {value}")
+
+
+def resolve_enum(s, path: str, root: str, value: str, label: str) -> int:
+    if value.isdigit():
+        return int(value)
+    items = api(s, "GET", path).get(root, [])
+    for it in items:
+        if it.get("name", "").lower() == value.lower():
+            return it["id"]
+    names = ", ".join(i.get("name", "") for i in items)
+    sys.exit(f"{label} nicht gefunden: {value}  (verfügbar: {names})")
+
+
+def resolve_assigned(s, value: str) -> int:
+    if value in ("me", "@me"):
+        return api(s, "GET", "/users/current.json")["user"]["id"]
+    if value.isdigit():
+        return int(value)
+    sys.exit("--assigned erwartet 'me' oder eine numerische User-ID")
+
+
+def read_text(value: str | None, file: str | None) -> str | None:
+    if file is not None:
+        return sys.stdin.read() if file == "-" else Path(file).read_text(encoding="utf-8")
+    return value
+
+
+# ---- Befehle ------------------------------------------------------------------
+
+def cmd_me(s, a):
+    u = api(s, "GET", "/users/current.json")["user"]
+    if a.json:
+        return print(json.dumps(u, ensure_ascii=False, indent=2))
+    print(f"{u['login']}  (id={u['id']}, {u.get('firstname','')} {u.get('lastname','')}, "
+          f"admin={u.get('admin', False)}, mail={u.get('mail','?')})")
+
+
+def cmd_projects(s, a):
+    ps = paged(s, "/projects.json", "projects")
+    if a.json:
+        return print(json.dumps(ps, ensure_ascii=False, indent=2))
+    for p in sorted(ps, key=lambda x: x["id"]):
+        print(f"#{p['id']:>3}  {p['identifier']:<32}  {p['name']}")
+    print(f"— {len(ps)} Projekte")
+
+
+def cmd_issues(s, a):
+    params = {"status_id": a.status, "sort": a.sort}
+    if a.project:
+        params["project_id"] = resolve_project(s, a.project)
+    if a.assigned:
+        params["assigned_to_id"] = resolve_assigned(s, a.assigned)
+    if a.query:
+        params["subject"] = "~" + a.query
+    issues = paged(s, "/issues.json", "issues", params, cap=a.limit)[: a.limit]
+    if a.json:
+        return print(json.dumps(issues, ensure_ascii=False, indent=2))
+    for i in issues:
+        who = (i.get("assigned_to") or {}).get("name", "—")
+        print(f"#{i['id']:>5}  [{i['status']['name']:<12}] {i['tracker']['name']:<8} "
+              f"{i['subject'][:70]:<70}  ({who})")
+    print(f"— {len(issues)} Tickets")
+
+
+def cmd_show(s, a):
+    inc = "journals,attachments,relations,children" if a.notes else "attachments,relations"
+    i = api(s, "GET", f"/issues/{a.id}.json", params={"include": inc})["issue"]
+    if a.json:
+        return print(json.dumps(i, ensure_ascii=False, indent=2))
+    print(f"#{i['id']}  {i['subject']}")
+    print(f"  Projekt : {i['project']['name']}")
+    print(f"  Status  : {i['status']['name']}  |  Tracker: {i['tracker']['name']}  |  "
+          f"Priorität: {i['priority']['name']}")
+    print(f"  Autor   : {i['author']['name']}  |  Zugewiesen: {(i.get('assigned_to') or {}).get('name','—')}")
+    print(f"  Erstellt: {i.get('created_on','')}  |  Aktualisiert: {i.get('updated_on','')}")
+    if i.get("description"):
+        print("  ---\n" + "\n".join("  " + ln for ln in i["description"].splitlines()))
+    if a.notes:
+        for j in i.get("journals", []):
+            if j.get("notes"):
+                print(f"  --- {j['user']['name']} @ {j.get('created_on','')}:\n"
+                      + "\n".join("    " + ln for ln in j["notes"].splitlines()))
+
+
+def resolve_version(s, project, wert: str) -> int:
+    """Version über Name oder ID auflösen.
+
+    Ein Name lässt sich nur mit `--project` auflösen, weil Versionen zu einem
+    Projekt gehören. Beim Ändern eines Tickets ist `--project` aber meist
+    nicht angegeben - dort ist die Versions-ID anzugeben.
+    """
+    if str(wert).isdigit():
+        return int(wert)
+    if not project:
+        sys.exit("--version mit Namen braucht --project (oder gib die Versions-ID an)")
+    pid = resolve_project(s, project)
+    for v in api(s, "GET", f"/projects/{pid}/versions.json").get("versions", []):
+        if v["name"].lower() == str(wert).lower():
+            return v["id"]
+    sys.exit(f"Version '{wert}' nicht in Projekt {pid} gefunden")
+
+
+def cmd_versions(s, a):
+    """Versionen eines Projekts auflisten oder anlegen."""
+    pid = resolve_project(s, a.project)
+    if a.name:
+        f = {"name": a.name}
+        if a.due:
+            f["due_date"] = a.due
+        if a.description:
+            f["description"] = a.description
+        v = api(s, "POST", f"/projects/{pid}/versions.json",
+                data=json.dumps({"version": f}))["version"]
+        return print(f"Angelegt: Version #{v['id']}  {v['name']}")
+    items = api(s, "GET", f"/projects/{pid}/versions.json").get("versions", [])
+    if a.json:
+        return print(json.dumps(items, ensure_ascii=False, indent=2))
+    if not items:
+        return print("— keine Versionen")
+    for v in items:
+        print(f"#{v['id']:>4}  {v['status']:<8} {v.get('due_date') or '—':<12} {v['name']}")
+
+
+def build_issue_fields(s, a) -> dict:
+    f = {}
+    if getattr(a, "project", None):
+        f["project_id"] = resolve_project(s, a.project)
+    if getattr(a, "subject", None) is not None:
+        f["subject"] = a.subject
+    desc = read_text(getattr(a, "description", None), getattr(a, "description_file", None))
+    if desc is not None:
+        f["description"] = desc
+    if getattr(a, "tracker", None):
+        f["tracker_id"] = resolve_enum(s, "/trackers.json", "trackers", a.tracker, "Tracker")
+    if getattr(a, "status", None):
+        f["status_id"] = resolve_enum(s, "/issue_statuses.json", "issue_statuses", a.status, "Status")
+    if getattr(a, "priority", None):
+        f["priority_id"] = resolve_enum(s, "/enumerations/issue_priorities.json",
+                                        "issue_priorities", a.priority, "Priorität")
+    if getattr(a, "assigned", None):
+        f["assigned_to_id"] = resolve_assigned(s, a.assigned)
+    if getattr(a, "parent", None):
+        f["parent_issue_id"] = int(a.parent)
+    if getattr(a, "version", None):
+        f["fixed_version_id"] = resolve_version(s, getattr(a, "project", None), a.version)
+    if getattr(a, "done", None) is not None:
+        f["done_ratio"] = int(a.done)
+    if getattr(a, "notes", None):
+        f["notes"] = a.notes
+    return f
+
+
+def cmd_create(s, a):
+    fields = build_issue_fields(s, a)
+    if "project_id" not in fields or "subject" not in fields:
+        sys.exit("create: --project und --subject sind Pflicht")
+    res = api(s, "POST", "/issues.json", data=json.dumps({"issue": fields}))
+    i = res["issue"]
+    print(f"Angelegt: #{i['id']}  {i['subject']}  -> {s.base}/issues/{i['id']}")
+
+
+def cmd_update(s, a):
+    fields = build_issue_fields(s, a)
+    if not fields:
+        sys.exit("update: nichts zu ändern angegeben")
+    api(s, "PUT", f"/issues/{a.id}.json", data=json.dumps({"issue": fields}))
+    print(f"Aktualisiert: #{a.id}  ({', '.join(fields)})")
+
+
+def cmd_comment(s, a):
+    api(s, "PUT", f"/issues/{a.id}.json", data=json.dumps({"issue": {"notes": a.text}}))
+    print(f"Kommentar an #{a.id} hinzugefügt.")
+
+
+def cmd_news(s, a):
+    """News lesen, anlegen oder ändern.
+
+    Drei Betriebsarten, unterschieden an den Angaben:
+        ohne --id, ohne --title   auflisten
+        --title                   anlegen (--project ist Pflicht)
+        --id                      ändern (PUT, antwortet mit 204)
+
+    Der Titel darf höchstens 60 Zeichen haben; darüber antwortet Redmine
+    mit HTTP 422. Geprüft wird das hier schon vorab, damit der Fehler beim
+    Aufruf steht und nicht im Serverprotokoll.
+    """
+    if getattr(a, "id", None):
+        fields = {}
+        if a.title:
+            fields["title"] = a.title
+        if a.summary is not None:
+            fields["summary"] = a.summary
+        body = read_text(a.description, a.description_file)
+        if body is not None:
+            fields["description"] = body
+        if not fields:
+            sys.exit("news: nichts zu ändern angegeben")
+        if len(fields.get("title", "")) > 60:
+            sys.exit("news: Titel darf höchstens 60 Zeichen haben")
+        api(s, "PUT", f"/news/{a.id}.json", data=json.dumps({"news": fields}))
+        return print(f"Geändert: News #{a.id}  ({', '.join(fields)})  -> {s.base}/news/{a.id}")
+
+    if a.title is None:
+        pid = resolve_project(s, a.project) if a.project else None
+        path = f"/projects/{pid}/news.json" if pid else "/news.json"
+        items = api(s, "GET", path, params={"limit": a.limit}).get("news", [])
+        if a.json:
+            return print(json.dumps(items, ensure_ascii=False, indent=2))
+        if not items:
+            return print("— keine News")
+        for n in items:
+            print(f"#{n['id']:>4}  {n.get('created_on', '')[:10]}  {n['title']}")
+        return
+
+    if not a.project:
+        sys.exit("news: zum Anlegen ist --project Pflicht")
+    if len(a.title) > 60:
+        sys.exit("news: Titel darf höchstens 60 Zeichen haben")
+    body = read_text(a.description, a.description_file)
+    if body is None:
+        sys.exit("news: --description oder --description-file angeben")
+    pid = resolve_project(s, a.project)
+    fields = {"title": a.title, "description": body}
+    if a.summary:
+        fields["summary"] = a.summary
+    res = api(s, "POST", f"/projects/{pid}/news.json", data=json.dumps({"news": fields}))
+    n = res.get("news", {})
+    if n.get("id"):
+        print(f"Angelegt: News #{n['id']}  {n.get('title', '')}  -> {s.base}/news/{n['id']}")
+    else:
+        print(f"Angelegt in Projekt {pid} -> {s.base}/projects/{pid}/news")
+
+
+def cmd_meta(s, a):
+    spec = {
+        "trackers": ("/trackers.json", "trackers"),
+        "statuses": ("/issue_statuses.json", "issue_statuses"),
+        "priorities": ("/enumerations/issue_priorities.json", "issue_priorities"),
+    }[a.kind]
+    items = api(s, "GET", spec[0]).get(spec[1], [])
+    if a.json:
+        return print(json.dumps(items, ensure_ascii=False, indent=2))
+    for it in items:
+        extra = " (default)" if it.get("is_default") else ""
+        print(f"#{it['id']:>3}  {it['name']}{extra}")
+
+
+def main():
+    p = argparse.ArgumentParser(description="Redmine REST-API CLI")
+    p.add_argument("--json", action="store_true", help="Rohdaten als JSON ausgeben")
+    sub = p.add_subparsers(dest="cmd", required=True)
+
+    sub.add_parser("me", help="Aktuellen Benutzer anzeigen")
+    sub.add_parser("projects", help="Projekte auflisten")
+
+    pi = sub.add_parser("issues", help="Tickets auflisten")
+    pi.add_argument("--project", help="Projekt (ID, Identifier oder Name)")
+    pi.add_argument("--status", default="open", help="open (Default) | closed | * | Status-ID")
+    pi.add_argument("--assigned", help="me | User-ID")
+    pi.add_argument("--query", help="Volltext im Betreff (~-Suche)")
+    pi.add_argument("--sort", default="updated_on:desc", help="z.B. updated_on:desc, priority:desc")
+    pi.add_argument("--limit", type=int, default=50)
+
+    ps = sub.add_parser("show", help="Ticket anzeigen")
+    ps.add_argument("id")
+    ps.add_argument("--notes", action="store_true", help="Journale/Kommentare mit anzeigen")
+
+    for name, help_ in (("create", "Ticket anlegen"), ("update", "Ticket aktualisieren")):
+        c = sub.add_parser(name, help=help_)
+        if name == "update":
+            c.add_argument("id")
+        c.add_argument("--project", help="Projekt (ID/Identifier/Name)" + (" [Pflicht]" if name == "create" else ""))
+        c.add_argument("--subject")
+        c.add_argument("--description", help="Beschreibungstext")
+        c.add_argument("--description-file", help="Datei oder '-' für stdin")
+        c.add_argument("--tracker", help="Tracker (Name oder ID)")
+        c.add_argument("--status", help="Status (Name oder ID)")
+        c.add_argument("--priority", help="Priorität (Name oder ID)")
+        c.add_argument("--assigned", help="me | User-ID")
+        c.add_argument("--parent", help="übergeordnetes Ticket (ID)")
+        c.add_argument("--version", help="Zielversion (Name oder ID)")
+        c.add_argument("--done", type=int, help="Fortschritt in %% (0-100)")
+        if name == "update":
+            c.add_argument("--notes", help="Kommentar zur Änderung")
+
+    pc = sub.add_parser("comment", help="Kommentar an ein Ticket hängen")
+    pc.add_argument("id"); pc.add_argument("text")
+
+    pn = sub.add_parser("news", help="News lesen, anlegen oder ändern")
+    pn.add_argument("--project", help="Projekt (ID/Identifier/Name); zum Anlegen Pflicht")
+    pn.add_argument("--id", help="News-ID - gesetzt heißt: ändern")
+    pn.add_argument("--title", help="Titel (max. 60 Zeichen); gesetzt heißt: anlegen statt auflisten")
+    pn.add_argument("--summary", help="Kurzfassung (optional, erscheint in der Übersicht)")
+    pn.add_argument("--description", help="Text")
+    pn.add_argument("--description-file", help="Datei oder '-' für stdin")
+    pn.add_argument("--limit", type=int, default=25)
+
+    pv = sub.add_parser("versions", help="Versionen auflisten oder anlegen")
+    pv.add_argument("--project", required=True, help="Projekt (ID/Identifier/Name)")
+    pv.add_argument("--name", help="Name - gesetzt heißt: anlegen statt auflisten")
+    pv.add_argument("--due", help="Fälligkeitsdatum (YYYY-MM-DD)")
+    pv.add_argument("--description", help="Beschreibung")
+
+    pm = sub.add_parser("meta", help="Stammdaten auflisten")
+    pm.add_argument("kind", choices=["trackers", "statuses", "priorities"])
+
+    a = p.parse_args()
+    s, _ = session()
+    {
+        "me": cmd_me, "projects": cmd_projects, "issues": cmd_issues, "show": cmd_show,
+        "create": cmd_create, "update": cmd_update, "comment": cmd_comment,
+        "news": cmd_news, "versions": cmd_versions, "meta": cmd_meta,
+    }[a.cmd](s, a)
+
+
+if __name__ == "__main__":
+    main()