feat: explain-permissions v1.1.0 — kanonische Quelle im Sammel-Repos (az-fleet-imn)

Erstes Plugin im neuen Sammel-Repos opencode-plugins: Baseline-Import der Solo-Datei von der lokalen Linux-Kiste (SHA-256-verifiziert identisch) plus README mit Zweck, Env-Variablen, Audit-Log-Anzeige und Neustart-Hinweis. Repo-Struktur: ein Ordner pro Plugin, pro-Plugin-Tags <name>/v<version>.
2026-09-17 15:15:21 +02:00
commit 321a3f91b8
3 changed files with 498 additions and 0 deletions
@@ -0,0 +1,47 @@
+# opencode-plugins — kanonische Plugin-Sammlung für opencode
+
+Dieses Repo ist die **eine Wahrheitsquelle** für opencode-Plugins der AZ-Gruppe.
+Es ist ein reines Content-Repo: hier leben nur die Plugin-Dateien plus ihre
+Doku — die Technik, die sie ausliefert, gehört in das Fleet-Repo `az-fleet`.
+
+Das Repos ist **anonym lesbar** (kein Token für Pulls nötig), Schreiben läuft
+über die Organisation AZ-Intec-GmbH.
+
+## Enthaltene Plugins
+
+| Plugin | Zweck | Version |
+|---|---|---|
+| [`explain-permissions/`](explain-permissions/) | Erklärt jeden freigabepflichtigen Tool-Call laienverständlich (Was/Folgen/Risiko), Desktop-Notification + Audit-Log | v1.1.0 |
+
+## Struktur & Konventionen
+
+```
+opencode-plugins/
+└── <plugin-name>/
+    ├── <plugin-name>.js      # die Plugin-Datei (genau eine pro Plugin)
+    └── README.md             # Doku: Zweck, Env-Variablen, Logs, Neustart-Hinweis
+```
+
+- **Ein Ordner pro Plugin**, Name = Plugin-Name (kebab-case, keine Umlaute).
+- Version steht in `PLUGIN_VERSION` im Dateikopf des Plugins.
+- **Tags sind pro Plugin benamst**: `<plugin-name>/v<version>` — z. B.
+  `explain-permissions/v1.1.0`. So kollidieren Versionen verschiedener Plugins
+  nie. Ein Tag markiert immer exakt den Plugin-Stand bei Freigabe.
+- Neue Plugins: Ordner anlegen, in der Tabelle oben eintragen, Commit + Tag.
+
+## Bezug
+
+### Lokale Workstation (Checkout + Symlink)
+
+```bash
+git clone https://git.az-gruppe.com/AZ-Intec-GmbH/opencode-plugins.git ~/p/AZ/opencode-plugins
+ln -sf ~/p/AZ/opencode-plugins/<plugin-name>/<plugin-name>.js ~/.config/opencode/plugins/<plugin-name>.js
+```
+
+Danach opencode **neu starten**. Wichtig: nur EINE Datei dieses Namens im
+Plugin-Ordner — sonst lädt opencode das Plugin doppelt.
+
+### Fleet (`az-fleet`)
+
+Pin auf einen Tag (`<plugin-name>/v<version>`) oder `main`; anonymes
+`git clone` über HTTPS reicht.