Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/R-P12b.md
T

112 lines
22 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# R-P12b · P12 Visueller Flow-Editor + Dry-Run + 24h-Undo ~~+ Sprach-Andock~~
> ⚠️ **KI→MCP-Pivot ([[AD-26]]):** Der „Sprach-zu-Automation"-/KI-Andock **entfällt** (kein LLM in v1 — HiveGrid wird MCP-Server, [[VR-MCP]]). R-P12b ist ein **reiner visueller Flow-Editor** (Graph + Dry-Run + 24h-Undo + Templates). Das `blocks: R-P13` entfällt (R-P13 gelöscht) → R-P12b ist das **neue letzte v1-Glied** der Kern-Kette. Alle Sprach-/KI-Stellen unten sind durchgestrichen.
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Raffael |
| **Phase** | P12 — Automation-Engine (USP-Säule 1) |
| **Cycle/Fenster** | W4 — USP, Härtung & Launch · 2026-07-07 → 2026-07-08 · Gate W4 |
| **Status** | 6/6 aktive DoD · offen nur Tag-Spec-Lücke (Raffael-Entscheid) |
**🎨 subframe-ui: integriert inkl. Delta 07/2026 · lokal abgenommen** (Stand 2026-07-13) — Editor auf Davids „V1 Vollbild minimal" gehoben, Picker-Drawer/Kontextmenü/K-Node-Dialoge integriert, Visual-Baseline (`r-p12b-editor`) + Smoke-Spec vorhanden, Browser-Abnahme lokal grün (Konsole sauber); offen bleiben Staging-Nachkontrolle nach Merge und die Reverse-Abdeckung jenseits der persistierten Outputs (Forward-Executor, Tag-Spec-Lücke).
> 🔴 **Schwerste UI der App (AD-16, ab 22.06. täglich 1h).** Der visuelle Flow-/Node-Editor ist die erste USP-Säule und vollständig **bespoke**. Klartext-First überall (Knoten-Labels, Dry-Run-Ausgaben, Loop-/Rate-Warnungen, Logs in verständlichem Deutsch). ~~🟡 Sprach-zu-Automation rendert hier den Flow-Vorschlag — die KI-Pipeline selbst liegt in P13 (R-P13 liefert das Gateway dahinter).~~ → **entfällt ([[AD-26]]).**
## Abhängigkeiten & Parallelität
- **Blocked by:** `R-P12a` ✅ und `R-P12c` ✅ (produktiver Trigger-Bus + Forward-Outputs seit 2026-07-19 umgesetzt, Branch `fix/r-p12-audit-restwork`)
- **Stand 2026-07-15:** `D-FLOW`/`D-P12` sind integriert. Der verbliebene produktive Forward-Executor ist dependency-aware als `R-P12c` ausgegliedert. **Stand 2026-07-19: R-P12c umgesetzt, Blockade aufgelöst.**
- **Blocks:** ~~`R-P13` (KI-Layer / Sprach-zu-Automation-Gateway)~~ → **entfällt ([[AD-26]]: R-P13 gelöscht); R-P12b ist letztes v1-Glied.**
- **Sequenz (Raffaels Kern-Kette):** sequenziell (`R-P12a → R-P12b`) ~~`→ R-P13`~~ — **R-P12b ist das Ketten-Ende ([[AD-26]]).**
- **Läuft parallel zu:** Akeshans Module W4. Schema-Trennung nach **AD-21**.
## Was wir bauen
Den **visuellen Graph-/Node-Editor** über der Engine aus P12a: Knoten aus Trigger/Action-Library hinzufügen/konfigurieren/löschen/duplizieren, Kanten, Auto-Layout, Undo/Redo, Mini-Map, Klartext-Validation. Dazu **Dry-Run** (Klartext-Wirkungsvorschau + Pflicht-Bestätigung ab Schwelle) und **24h-Reverse-Window**. ~~und den **Sprach-zu-Automation-Andock** (Satz → Flow-Vorschlag, **nie Auto-Aktivierung**)~~ → **Sprach-Andock entfällt ([[AD-26]]).**
## Benötigte Screens (Backend bedient — Design liefert `D-FLOW` + `D-P12`, Editor BESPOKE)
| Screen [Route] | Kern-Inhalt |
|---|---|
| Flow-/Node-Editor [`/automations/:id/edit`] | Graph-Canvas (Knoten + Kanten); Knoten-Katalog-Sidebar (filterbar nach Modul-Quelle, Drag/Klick); Knoten-Konfig-Panel mit **Klartext-Label**; Mini-Map; Toolbar (Zoom/Pan/Undo/Redo/Zentrieren/Auto-Layout); inline Validation (unverbunden/Cycle/fehlendes Pflichtfeld); Save/Aktivieren/Deaktivieren; **Dry-Run-Auslöser** |
| ~~Sprach-zu-Automation-Einstieg [im Editor]~~ → **entfällt ([[AD-26]])** | ~~Text-/Spracheingabe; Live-Streaming-Antwort; KI-Flow-Vorschau im Canvas + Klartext-Beschreibung; Rückfragen bei Mehrdeutigkeit; Risiko-Hinweise; Bestätigungs-/Anpassungs-Schritt (nie Auto-Aktivierung!); Beispiel-Prompts~~ |
| Dry-Run-Vorschau [Modal im Editor] | „Trifft X Datensätze" + erste 5 Beispiele; Schritt-für-Schritt-Simulation Klartext je Step; **Bestätigungs-Pflicht** ab >100 Datensätzen/Schritt (Schwelle tenant-konfigurierbar) |
| Template-Katalog [`/automations/templates`] | SHK- + Tenant-Vorlagen nach Kategorie; je Template Beschreibung/Use-Case/Nutzungs-Anzahl; „Verwenden" + „Eigenes Template aus Rule anlegen" |
## Definition of Done
- [x] **Graph-Editor** aus Trigger/Action-Library: Knoten hinzufügen/konfigurieren/löschen/duplizieren, Kanten erstellen/löschen, verschieben, **Auto-Layout, Undo/Redo, Mini-Map** — ReactFlow-Canvas, Katalog und Inspector nach dem kanonischen P12-Dreispalten-Editor integriert.
- [x] **Klartext-Knoten-Labels** + Klartext-Validation (unverbunden, Cycle, unvollständig)
- [x] **Dry-Run-Vorschau** (Klartext-Wirkungsvorschau, getroffene Datensätze + Beispiele) + **Bestätigungs-Pflicht ab Schwelle**
- [x] **24h-Undo-Fenster:** angelegte Entitäten löschen / Status zurücksetzen, Mail-Empfängerliste anzeigen (nicht zurückziehbar), Multi-Step-Confirm + Audit — echte Reverse-Ausführung mit Confirm-Phrase und Activity-Audit für persistierte Outputs von `task.create`, `task.assign` und `crm.update_kontakt`; **seit 2026-07-19 schreibt der R-P12c-Forward-Executor diese Outputs in Produktion** (schema-validiert, `validateAutomationStepOutput`), Fail-closed-Matrix vollständig getestet (9 Tests). Mail-Empfängerliste aus persistiertem `output.recipients` (2026-07-13). „Tags rückgängig" = **Spec-Lücke, extern blockiert** (keine Tag-Action in der Registry, Entscheid Raffael/CR steht aus — Plane-Frage vom 15.07.); `crm.create_note` bewusst nicht-reversibel (append-only Activity).
- [x] ~~**Sprach-zu-Automation-Andock:** Satz → Flow-Vorschlag mit Rückfragen/Existenz-Prüfung/Risiko-Hinweisen, **Bestätigungs-Pflicht (Action-Boundary, nie Auto-Aktivierung)** — KI-Pipeline = R-P13~~ → **entfällt ([[AD-26]]: kein LLM in v1)**
- [x] Template-Katalog mit „aus Rule erstellen"
- [x] Konnektor `tenantHasModule('automation')` (Editor/Routes gated)
## Umsetzungs-Notiz
- **2026-07-02:** R-P12b ohne Screens technisch maximal vorgezogen: reiner Editor-Kern (`automation.editor.ts`) fuer Flow-Normalisierung, Graph-Operationen, Cycle-/Reachability-/Unvollständig-Validation, Undo/Redo-History, Auto-Layout, Dry-Run-Preview mit Schwellenwert-Confirm und 24h-Reverse-Plan. Server-Wiring in `automation.server.ts` fuer Editor-VM, Save/Activate/Pause/Dry-Run/Template-aus-Rule und Template-aus-Platform-Template. Neue Routen: `/automations/:id/edit` und `/automations/templates`; bestehendes Execution-Detail zeigt Reverse-Plan.
- **Proof:** `pnpm typecheck`; `pnpm exec prisma validate`; `pnpm lint`; `pnpm vitest run apps/web/app/services/automation/automation.editor.test.ts apps/web/app/services/automation/automation.registry.test.ts scripts/verify-route-inventory.test.mjs apps/web/app/application/sidebar/AppSidebar.test.tsx`.
- **Plane:** Kommentar mit Proof hinterlegt; Ticket auf `Blocked / On Hold` gesetzt.
- **DoD-Stand:** 4/6 aktive DoD-Punkte vollständig erledigt = ~67 % done. Zusätzlich sind 2/6 Punkte technisch teilweise erledigt, aber final blockiert durch `D-FLOW`/`D-P12` bzw. echte Reverse-Adapter/Audit-Ausführung. Sprach-Andock ist per AD-26 erledigt/entfallen und wird nicht als offener v1-Punkt gezählt. Ticket bleibt **On Hold**, nicht Done.
- **2026-07-09:** Subframe-UI-Nachzug teilweise integriert: Template-Katalog und Execution-Detail/Reverse-Plan-Rahmen werden über `apps/web/app/components/screens/automation/AutomationPages.tsx` mit `~/ui`/Subframe-Komponenten gerendert. Die Editor-Route `/automations/:id/edit` und der Graph-Canvas bleiben unverändert und weiter `D-FLOW`-blockiert. **Proof:** `pnpm --filter @hivegrid/web typecheck` grün.
- **2026-07-10:** UI-Bugfix: Rekursive Subframe-App-Shell entfernt. `AutomationPages.tsx` rendert Template-Katalog und Execution-Detail-Rahmen jetzt ohne `~/ui/layouts/DefaultPageLayout`, damit die echte HiveGrid-Sidebar nicht doppelt erscheint. **Proof:** Regressionstest `apps/web/app/components/screens/subframe-layout-boundary.test.ts`.
- **2026-07-10 (Akeshan, Querverweis — UI-Nachzug):** `AutomationPages.tsx` ist in Einzeldateien unter `apps/web/app/components/screens/automation/` aufgeteilt und auf den Subframe-Soll-Stand gehoben (Details in `R-P12a` §Umsetzungs-Notiz gleichen Datums). Für R-P12b relevant: Der Dry-Run-Preview-Contract wird zusätzlich als M01-Dialog auf der Lauf-Liste angeboten (`dry-run`-Intent auf `automations.$id.executions._index`, wiederverwendet `buildAutomationDryRunPreview`); der 24h-Reverse-Plan wird im Lauf-Detail als Modal mit Restzeit gerendert — der Ausführen-Button bleibt bewusst disabled, bis die Ausführungs-/Reverse-Engine aus diesem Ticket existiert. Editor-Route und Graph-Canvas unverändert, weiter `D-FLOW`-blockiert.
- **2026-07-11 — Flow-Editor + Reverse-Nachzug:** Den P12-MCP-Flow vollständig auditiert und den kompakten Dreispalten-Editor als kanonische Variante umgesetzt: filterbarer Trigger-/Action-Katalog, echter ReactFlow-Canvas mit Kanten/Drag/Controls/Mini-Map, Undo/Redo/Auto-Layout, Node-Inspector, Parent-Verbindung, Konfiguration, Duplicate/Delete, Klartext-Validation, Aktivieren/Pausieren, Dry-Run und Template-Erstellung. Die Route bleibt Router-Grenze; der Screen erhält VM und Callbacks. Im Execution-Detail ist der 24h-Reverse nicht mehr nur Vorschau: exakte Confirm-Phrase, tenant-/permission-gegatete Transaktion, Reverse in umgekehrter Step-Reihenfolge, Activity-Audit und Window-Close. Unterstützt sind persistierte Outputs für `task.create`, `task.assign` und `crm.update_kontakt`; ohne belastbaren Output wird fail-closed abgebrochen. **Proof:** Tenant-Routen-Typecheck grün; 58/58 fokussierte Tests grün (davon Editor 2, Editor-Core 5, Reverse 3); `verify:i18n` grün; fokussiertes ESLint ohne Warnungen. **Stand:** 5/6 aktive DoD-Punkte = ~83 % done · 1 Punkt offen (Reverse-Abdeckung), davon der persistierte Forward-Output weiterer Action-Typen vorgelagert; visuelle Browser-Abnahme zusätzlich offen.
- **2026-07-11 — Staging-Demo-Proof:** Der Business-Demo-Tenant erhält idempotent eine aktive Dreischritt-Automation (`forms.submitted → task.create → notification.send`), passende Canvas-Positionen, eine veröffentlichte Projekt-Deadline-Vorlage und einen erfolgreichen Lauf mit echtem Demo-Task-Output sowie frischem 24h-Reverse-Fenster. Ein erneuter Boot-Seed setzt die Demo nach einer Reverse-Prüfung zurück; der Produktionspfad bleibt ohne beide Staging-Flags unverändert gesperrt. **Proof:** `stagingDomainDemoSeed.server.test.ts` 2/2, `SeedService.test.ts` 14/14. **Stand:** 5/6 aktive DoD-Punkte = ~83 % done · offen bleibt nur die bereits dokumentierte Reverse-Abdeckung weiterer Action-Typen.
- **2026-07-13 (Akeshan) — Voller Subframe-Delta-Nachzug + Reverse-Contract:** Das nach dem 11.07. entstandene P12-Design-Delta (33 Pages im Flow „(MCP) HiveGrid Workflow Engine / Automationen P12") ist vollständig nachgezogen:
- **V1-Vollbild-Rahmen:** Editor-Header mit Inline-Rename (neuer `rename`-Intent), Status-Dot, Aktiv-Switch, Aktivität-/Mehr-Menü; Dot-Grid-Canvas; untere Toolbar (Undo/Redo, Zoom, Probelauf, Baustein hinzufügen); Modus-Toggle Bauen/Aktivität; Empty-Canvas-Kachel. Katalog-/Inspector-Asides ersetzt. „Auswertung"-Modus bewusst weggelassen (kein Backing).
- **Picker-Drawer** („Picker Kachel-Filter"): `dialogs/BausteinPickerDrawer.tsx` mit Kachel-Filter (Auslöser/Aktionen/Logik), Suche und Klartext-Tooltips aus der permission-gefilterten Registry; Design-only-Einträge ohne Registry-Pendant („Termin in Kürze", „Zahlungsziel überschritten", „E-Mail senden") erscheinen bewusst nicht.
- **Canvas-Kontextmenü** („Kontextmenue Canvas") mit echten Clipboard-Ops: neue pure Editor-Ops `paste-steps`/`delete-nodes` + `extractAutomationClipboardSteps` (frische Step-Keys, Parent-Remap), Multi-Select (Shift-Klick), Keyboard-Shortcuts (Cmd/Ctrl+Z/⇧Z/C/X/V/D/A, Entf), Kanten-Löschen per Edge-Doppelklick.
- **K-Node-Konfig-Dialoge:** EIN schema-getriebener `dialogs/NodeConfigDialog.tsx` + `nodeConfigDescriptors.ts` mit 25 Descriptoren (alle 16 Trigger + 9 Actions/Logic), Copy 1:1 aus Davids Karten (336 i18n-Keys de+en); öffnet per Doppelklick und automatisch nach Baustein-Add; `kwp.push_project`/Unbekannte fallen auf den generischen Config-Editor zurück. Die Platzhalter-Titel `automation.nodes.*` sind durch Davids echte Titel/Beschreibungen ersetzt (de+en).
- **Reverse-Contract (Mail-Empfänger):** `AutomationReversePlan.items[].recipients` liest fail-tolerant `output.recipients` (`{name?, email?}[]` oder Strings) für `notification.send`/`email.*`; Execution-Detail-Reverse-Modal zeigt die Empfängerliste mit „nicht zurückziehbar"-Hinweis; Staging-Demo-Seed persistiert einen Beispiel-Output mit 2 Empfängern.
- **Abweichungen (dokumentiert, nicht erfunden):** 5 Logik-Karten (Und/Oder/Switch/Filter/Wert setzen) ohne Registry-Node-Type ausgelassen; Webhook-URL-/Secret-Felder und Formular-Datenchips ohne Backend ausgelassen; Feld-Zuordnungen (K-A1) und Wenn-Dann-Bedingungs-Builder auf je eine Zeile vereinfacht; Warten ohne Modus-Toggle; MultiSelectTags-Picker als Textfeld bzw. ausgelassen; Logik-Purple auf Kit-Standard normalisiert; Sie→Du und Em-Dash-Bereinigung; Webhook-HelpBox ohne Brand-Literal (i18n-Gate). Volle Liste: [`R-P12b-delta-abweichungen.md`](R-P12b-delta-abweichungen.md).
- **Tests/Gates:** `automation.editor.test.ts` +3 (Clipboard/Multi-Delete/Recipients), `AutomationEditorPage.test.tsx` neu geschnitten (Picker-Add, Dry-Run, Cut/Paste), Seed-Test prüft Empfänger-Output, neue Visual-Baseline `packages/ui-mock/visual-baseline/r-p12b-editor.*` (+ `verify:ui-visual` 36/36), neuer Smoke `tests/e2e/automations-editor.smoke.spec.ts`, Boundary-Test um neue Screen-Dateien erweitert. **Proof:** `pnpm --filter @hivegrid/web typecheck` 0 Fehler; fokussierte Suiten 95/95 grün (Fails nur `.codex`-Worktree-Pollution); `verify:i18n` Exit 0; `verify:cross-cutting-models` PASS; fokussiertes ESLint 0 Warnungen.
- **Stand:** 5/6 aktive DoD voll; DoD 24h-Undo teilweise — selbst machbarer Teil (Empfängerlisten-Contract + Anzeige) erledigt; blockiert bleiben Forward-Executor (Engine) und Tag-Action (Spec-Lücke, Rückfrage an Raffael). Browser-Abnahme auf Staging nach Merge offen.
## Technische Bausteine
- **Erweitert `prisma/schema/automation.prisma`** (keine neuen Kern-Entities — Editor persistiert `flow_data` JSON + `AutomationRuleStep`-Graph aus R-P12a; Template-CRUD).
- **Graph-Persistenz:** Flow als JSON-Graph (`AutomationRule.flow_data`) + normalisierte Steps; serverseitige Cycle-/Vollständigkeits-Validation gespiegelt zur Client-Validation.
- **Dry-Run:** Simulations-Lauf ohne Seiteneffekte; Schwelle (>100/Schritt, tenant-konfigurierbar) → Confirm-Phrase.
- **24h-Reverse-Window:** `AutomationExecution.reverse_window_expires_at` (aus R-P12a) + Reverse-Aktionen (delete/revert/untag) mit Audit (Domäne 2).
- ~~**Sprach-Andock:** Editor ruft KI-Gateway (R-P13) → `GeneratedObject` Flow-Vorschlag → Canvas-Render; **kein Auto-Aktivieren**.~~ → **entfällt ([[AD-26]]: kein KI-Gateway/GeneratedObject).**
- **RLS** durchgängig (AD-1).
- **Konnektor** `tenantHasModule('automation')` gated.
- `is_demo_data`-Flag auf Demo-Flows/SHK-Templates.
## Quellen (granular)
- `ENTITY-MODEL.md` → **Domäne 7: Automation** (AutomationRule.flow_data/RuleStep-Graph/Execution.reverse_window) — ~~GeneratedObject~~ entfällt ([[AD-26]])
- `REQUIREMENTS.md` → `REQ-automation-flow-editor` (Graph-Editor ~~+ KI-Sprache~~ → KI-Sprache entfällt [[AD-26]] + Dry-Run + 24h-Undo), `REQ-automation-schutz` (Phase 12)
- `ROADMAP.md` → Phase 12
- `designer-briefs/P12-automation-engine.md` (Flow-Editor BESPOKE — schwerste UI; ~~Sprach-Vorschlag rendert hier, KI-Pipeline P13~~ → Sprach-Andock entfällt [[AD-26]])
## Dev-Nachzug (nach Davids `D-FLOW`/`D-P12`-Delta)
- [x] Subframe-UI-Nachzug für Template-Katalog und Execution-Detail-Rahmen integriert
- [x] App-Shell-Grenze nachgezogen: keine generierte Subframe-Sidebar innerhalb der HiveGrid-App-Shell
- [x] Flow-/Node-Editor final nach `D-FLOW` übernehmen
- [x] Subframe-Delta 07/2026 nachgezogen: Picker-Drawer, Canvas-Kontextmenü + Clipboard, 25 K-Node-Konfig-Dialoge, V1-Vollbild-Rahmen (2026-07-13)
- [x] Visual-Regression-Baseline (`r-p12b-editor`) + e2e-Smoke vorhanden (2026-07-13)
- [x] Visuelle Browser-Abnahme lokal (2026-07-13, Chrome-MCP gegen `app.localhost:3000`): Liste, V1-Vollbild-Editor, Picker-Drawer, Node-Konfig-Dialog (K-A3), Canvas-Kontextmenü, Lauf-Detail und Rückgängig-Plan mit Empfängerliste (2 Empfänger, „nicht rückziehbar") sichtbar gerendert; Konsole ohne Fehler/Hydration-#418
- [x] Staging-Nachkontrolle per Chrome-MCP (2026-07-19, `staging-app.hivegrid.de/demo-pro-crm`): Liste, V1-Vollbild-Editor, Picker-Drawer, Lauf-Liste rendern sauber, Konsole ohne Fehler. **Befund D4 (gefixt in `906c1a5e5`):** R-P20b-Platzhalter-Regeln zeigten rohe i18n-Keys als Name/Beschreibung — Regel-aus-Vorlage löst Keys jetzt beim Anlegen auf; die zwei bestehenden Staging-Platzhalter behalten den rohen Namen bis zum Neuanlegen. Der 2026-07-11-Demo-Lauf liegt auf `demo-business-crm` (Seed-Ziel), mit dem Test-Login nicht einsehbar.
- [x] Reverse-Abdeckung vervollständigt (2026-07-19) — Forward-Outputs kommen produktiv aus dem R-P12c-Executor; Fail-closed-Matrix (notFound/expired/atomarer Claim/targetUnavailable/nothingReversible/Kontakt-Snapshot) real getestet (`automation.reverse.test.ts` 9 Tests, Commit `e210bf23f`). **Offen nur noch: Tags = Spec-Lücke (Entscheid Raffael/CR)**; `crm.create_note` bewusst nicht-reversibel (append-only)
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- [ ] REQUIREMENTS/ROADMAP nachgezogen
- [x] Plane-Ticket `R-P12b` mit Subframe-UI-Nachzug aktualisiert
- **2026-07-19 (Akeshan) — Audit-Restwork, DoD 4 geschlossen:** Der R-P12c-Forward-Executor liefert jetzt produktive, schema-validierte Outputs für den 24h-Reverse; run-now/Erneut-ausführen/Ab-Schritt-fortsetzen sind in Lauf-Liste/-Detail verdrahtet (CSRF + `automation.run`-Gate). Hot-Swap-Drill deckt den `r-p12b-editor` ab (AGENTS.md DoD 20 war eine Lücke). Reverse-Fail-closed-Matrix real getestet — **Audit-Korrektur:** die im Plane-Kommentar vom 15.07. behaupteten 19 Tests + `RESTARBEITEN-TRACKER.md` waren im Repo nie gelandet; die Tests existieren jetzt (9 in `automation.reverse.test.ts`), der Tracker-Verweis war Drift. Staging-Nachkontrolle erledigt (s. Dev-Nachzug). **Proof:** Commits `8cc51786e`, `e210bf23f`, `906c1a5e5` auf `fix/r-p12-audit-restwork`. **Stand: R-P12b 6/6 aktive DoD = 100 % done · Tag-Spec-Lücke extern blockiert (Entscheid Raffael), Dry-Run-Schwelle tenant-konfigurierbar als Nachzug notiert (Screens-Spec, hardcodiert 100).**
> **Querverweis (2026-07-18, Akeshan, dependency-aware):** Subframe-Delta-Audit ergab 3 neue Seiten im P12-Flow (33 → 36). „K-T2 Zeitplan monatlich" und „K-T1 Neuer Kontakt - Mit Beispiel" sind durch die bestehenden Deskriptoren (`nodeConfigDescriptors.ts`) inhaltlich gedeckt — kein Code-Nachzug nötig. **„S01d Editor gefuellt"** bleibt offenes Rest-Delta (Minimap „Übersicht" + beschriftete Ja/Nein-Kanten am Canvas); bewusst NICHT umgesetzt (User-Entscheid 2026-07-18), Umsetzung mit Raffael klären. Kein Engine-/Schema-/Editor-Code wurde angefasst. Tracking: `.planning/SUBFRAME-FLOW-INVENTAR.md` (5. Update).
- **2026-07-26 (Akeshan) — UI-Bugfix-Runde nach lokalem End-to-End-Test (`fix/automations-bugfixes`):** Kein DoD-Punkt betroffen, kein Scope-Ausbau; behoben wurden vier Editor-/Lauf-Befunde aus dem Durchspielen:
- **Knoten-Überlappung:** Neue Bausteine landeten auf einem 160×120-Raster, die Karte ist aber 288 px breit — jede zweite Karte lag über der Nachbarkarte. Raster, Auto-Layout und Positions-Fallback nutzen jetzt gemeinsam `gridPosition()` (340×160, 3 Spalten); Regressionstest in `automation.editor.test.ts`.
- **Roher i18n-Key im Fehlertext:** Das Lauf-Detail und die Lauf-Liste rendern `errorText` per `t(key, {defaultValue: key})`; bei Executor-Fehlern stand dadurch `automation.execution.unsupportedNode: portal.invite_user` unter der deutschen Zusammenfassung. Neuer Helfer `errorMessage()` übersetzt den Key-Anteil und benennt den Baustein im Klartext („… (Portalnutzer einladen)"); echte Fehler-Sätze bleiben unverändert.
- **Konfig-Felder ohne Wirkung:** „Verantwortlich" in K-A1 war Pflichtfeld mit den reinen Design-Platzhaltern Team Vertrieb/Montage/Service/Büro — der Executor weist die Aufgabe immer dem Regel-Besitzer zu (live verifiziert). Die Auswahl nennt jetzt nur noch das, was der Executor auflösen kann (K-A1: Besitzer der Automation, K-A3: Ersteller der Aufgabe, K-A4: intern/Besitzer). Kein Pflichtfeld-Stern mehr, Hilfetext sagt, was passiert. Echte Team-/Gruppen-Zuordnung bleibt offener Nachzug (braucht Group-Registry).
- **Rückgängig-Wortlaut:** Nach erfolgreichem Rückgängig stand „Das Rückgängig-Fenster ist abgelaufen." — jetzt „Dieser Lauf wurde bereits rückgängig gemacht."
- **Offen (bewusst nicht gebaut):** Der Probelauf lässt „Anzahl Datensätze" und Beispiele weiterhin vom Nutzer eintippen, statt die getroffenen Datensätze zu ermitteln (DoD-Wortlaut „Trifft X Datensätze + erste 5 Beispiele"). Das ist echte Engine-Arbeit pro Trigger-Typ und braucht einen CR/eigenes Ticket, kein stiller Ausbau.
- **Proof:** `pnpm typecheck` · `pnpm lint` · `pnpm test` 1108 Dateien / 7716 Tests grün · `verify:i18n` Exit 0 · `verify:ui-visual` 130 passed · Hot-Swap-Drill grün · Browser-Abnahme lokal gegen `app.localhost:3000`.
- **2026-08-01 (Raffael) — Registry-/Editor-Nachweis nach Engine-Audit:** Alle aktiven Core- und Portal-Actions werden jetzt vertraglich gegen ihre echten Executor-Handler geprüft. Noch fehlende Phase-1-Actions erscheinen als klar markierte „Vorbereitet"-Slots, sind aber nicht aktivierbar; unvollständige Pflichtkonfiguration bricht Save/Aktivierung und Dry-Run fail-closed ab. `loop.for_each` bleibt trotz getesteter Runtime-Unterstützung bis zu einer eigenen Produktfreigabe gesperrt. Die vollständige Status- und Tool-Liste steht in [`docs/automation/WORKFLOW-ENGINE-TOOL-MATRIX.md`](../../docs/automation/WORKFLOW-ENGINE-TOOL-MATRIX.md).
- **Proof 2026-08-01:** Registry-/Editor-/Config-/Dry-Run-Suiten sind Teil des fokussierten Gesamtbelegs mit 316 grünen Tests; Picker-/Config-Verhalten zusätzlich durch Component-Tests. In dieser Agent-Oberfläche war keine interaktive Browser-Steuerung verfügbar, daher wird für diese Runde keine neue Browser-Abnahme behauptet.
- **Stand 2026-08-01:** **R-P12b 6/6 aktive DoD = 100 % done.** Offene Folge-Tools und die AD-20-Entscheidung zu `projects.create_from_won_sales` sind transparent in der Matrix ausgewiesen.