# Jinkendo – Prompt-, Platzhalter- & Workflow-Laufzeit Blueprint **v0.1 · 16.10.2026 · Spezialblueprint 3 nach Release und KI-Gateway · technischer Entwurf V/K** ## 1. Ziel, Geltung und Nachweis Dieser Blueprint spezifiziert die produktlokale Ausführung versionierter Prompts und begrenzter Workflowgraphen: Registrierung, Datenauflösung, Rendering, Entscheidungssignale, Zustandsübergänge, Abbruch und Wiederaufnahme. Primäre Implementierungsreferenz ist Mitai. Modelltransport, Privacy und Maskierung bleiben im bereits beschriebenen KI-Gateway; Identität und Datenraumgrenzen bleiben im Auth-Blueprint. Die Implementierung erfolgt erst in einem gesonderten Coding-Auftrag. Kompatibilitätsgrundlagen: - [Application Foundation A v0.3](C:/Dev/jinkendo-phase3-2-technical-reference-architecture-v0.3-2026-10-16/A_Jinkendo_Technical_Reference_Architecture.md), [Foundation B v0.3](C:/Dev/jinkendo-phase3-2-technical-reference-architecture-v0.3-2026-10-16/B_Implementation_Blueprint_Application_Foundation.md) und [Entscheidungen C v0.3](C:/Dev/jinkendo-phase3-2-technical-reference-architecture-v0.3-2026-10-16/C_Technical_Decisions_Open_Issues.md). - [Auth, Session & Scope](C:/Dev/jinkendo-phase3-3-auth-session-scope-blueprint-2026-10-16/Jinkendo_Auth_Session_Scope_Blueprint.md), [Release, Betrieb & Recovery](C:/Dev/jinkendo-release-betrieb-recovery-blueprint-2026-10-16/Jinkendo_Release_Betrieb_Recovery_Blueprint.md) und [KI-Gateway, Providerzugriff & Privacy](C:/Dev/jinkendo-ki-gateway-provider-privacy-blueprint-2026-10-16/Jinkendo_AI_Gateway_Provider_Privacy_Blueprint.md). - [Phase-3.1-Wissenselemente](C:/Dev/jinkendo-phase3-1-technical-knowledge-inventory-2026-10-15/A01_knowledge_elements.json), insbesondere KI-MIT-08/09/10/11, KI-SHK-07 und ergänzend KI-KAI-11; [Quellenregister](C:/Dev/jinkendo-phase3-1-technical-knowledge-inventory-2026-10-15/sources.json), [Testregister](C:/Dev/jinkendo-phase3-1-technical-knowledge-inventory-2026-10-15/tests.jsonl) und [Guardrailregister](C:/Dev/jinkendo-phase3-1-technical-knowledge-inventory-2026-10-15/guardrails_source_register.jsonl). - Beschlossene ADR-01 bis ADR-14 aus dem [Entscheidungsregister](C:/Dev/jinkendo-architecture-consolidation-phase2-v0.2-2026-10-15/05_Architecture_Decision_Register.md). Der historische Freigabewortlaut dieses Registers wird durch den erklärten Beschlussstatus eingeordnet. ADR-15/16 werden hier nicht entschieden. | Kennzeichen | Bedeutung in diesem Dokument | |---|---| | **V** | Vorgeschlagener technischer Standard für die spätere Umsetzung | | **I** | Gezielte statische Implementierungsreferenz mit benanntem Quellabschnitt | | **T** | Tatsächlich ausgeführte Prüfung mit engem, ausdrücklich benanntem Umfang | | **K** | Noch nicht integrierte oder getestete Kombination | Alle neuen Schnittstellen und Abläufe sind **V/K**. Vorhandene Testdateien sind **I**, kein Nachweis eines bestandenen Laufs. Die Dokumentprüfung am Ende ist ausschließlich T für Dateiintegrität, Verweise und Beispielsyntax. Weder dieser Blueprint noch die Foundation sind dadurch eine produktionsreife Referenzimplementierung. Es entstehen kein zentraler Workflowdienst, keine gemeinsame Fachdatenbank, kein SSO und kein allgemeines Agenten- oder Automatisierungsframework. Ein Produkt ohne Workflows benötigt nur den registrierten Einzelpromptpfad. Bestehende Anwendungen und bisherige Ergebnisverzeichnisse bleiben unverändert; Tsumugu ist keine Implementierungsquelle. ### 1.1 Verbindliche Verträge und technische Defaults | Verbindlicher Architekturvertrag | Technischer Default / begründet anpassbare Wahl | |---|---| | Verifizierter Principal, expliziter Datenraum, aktuelle Objekt-/Capabilityprüfung, Fail-Closed | Konkrete Capabilitynamen und Dateipfade | | Unveränderliche ausführbare Definitionen und eindeutige Versionsbindung je Ausführung | UUIDs für Definitionen, Ganzzahlrevisionen und SHA-256 für unpersönliche Definitionsinhalte | | Registrierte, typisierte Auflösung; fehlende Werte und Fehler unterscheidbar; keine ungeprüften Clientwerte als Fachquellen | Grammatik `{{key}}`, `d`/`x`, konkrete Ausgabeformatierung | | Sicher begrenzter Graph; keine beliebige Codeausführung aus Definitionen | Sequenzieller DAG mit fünf Mitai-Knotentypen, genau einem Endknoten | | Jeder Modellaufruf durch das Gateway; keine automatische Wiederholung ungeklärter externer Wirkung | Produktlokaler DB-Runner ohne Broker, Polling- und Leasewerte | | Aktuelle Rechteprüfung und Ergebnis-/Checkpoint-/Auditwrite in derselben Transaktion; kein Netzwerk in offener UoW | Tabellenaufteilung, technische TTLs und Grenzwerte | | Keine persönlichen Volltexte in technischen Logs, Fehlermeldungen oder Fortschrittsereignissen | Aufbewahrungsfrist für ausdrücklich gespeicherte private Ausführungsergebnisse | | Pflicht-Gates und nachvollziehbare Build-/Quellversionen gemäß ADR-11 | R1 bevorzugt; R2 weiter zulässig; keine neue CI/CD-Infrastruktur | Ein Default darf mit begründetem Produktbedarf angepasst werden. Das erlaubt keine Umgehung der zugehörigen Verträge. Insbesondere ist eine größere Laufzeitgrenze keine Erlaubnis für unbeschränkte Graphen oder automatische Modellretries. ## 2. Vorhandene Mechanismen gezielt wiederverwenden | Quelle I | Übernehmen / adaptieren | Grenze des Nachweises und notwendige Ergänzung V/K | |---|---|---| | Mitai [Modelle](C:/Dev/mitai-jinkendo/backend/workflow_models.py:16), [Graphprüfung](C:/Dev/mitai-jinkendo/backend/workflow_engine.py:67), [Reihenfolge](C:/Dev/mitai-jinkendo/backend/workflow_engine.py:412), KI-MIT-08 | `start`, `analysis`, `logic`, `join`, `end`; DAG, Erreichbarkeit, strukturierte Bedingungen | Zusätzlich doppelte IDs, Knotenschemata, Ports, Dominanz von Referenzen, Grenzen und gebundene Versionen prüfen. Editorpositionen sind keine Laufzeitsemantik. | | Mitai [Executor](C:/Dev/mitai-jinkendo/backend/workflow_executor.py:39), [Analysis](C:/Dev/mitai-jinkendo/backend/workflow_executor.py:278), [Joins](C:/Dev/mitai-jinkendo/backend/workflow_executor.py:558) | Trennung von Knotenausführung, Routing, Signalen und Ergebnisaggregation | Der gelesene Executor verwaltet wesentliche Laufzustände im Speicher und speichert den Gesamtzustand zum Abschluss/Fehler. Das ersetzt keine Checkpoints je Node, Lease oder Crashbehandlung. Der direkte Modellcallback und die dort feste Modellwahl werden durch den Gatewayport ersetzt. | | Mitai [Registry](C:/Dev/mitai-jinkendo/backend/placeholder_registry.py:57), [Duplikatsperre](C:/Dev/mitai-jinkendo/backend/placeholder_registry.py:169), [Registrierungen](C:/Dev/mitai-jinkendo/backend/placeholder_registrations/__init__.py:1), KI-MIT-09/10 | Ein Katalog für Metadaten, Resolver, Picker, Validierung und Export; doppelte Keys als Fehler | Im Foundation-Bootstrap explizit aufbauen und anschließend einfrieren. Keine verteilten Parallelkataloge oder Datenbankzugriffe beim Import. | | Mitai [Rendering](C:/Dev/mitai-jinkendo/backend/prompt_executor.py:18), [Resolver](C:/Dev/mitai-jinkendo/backend/placeholder_resolver.py:1708), [Modifier-Tests](C:/Dev/mitai-jinkendo/backend/tests/test_placeholder_modifier_d.py:98) | `{{key}}`, `{{key|d}}`, `{{key|x}}`, `{{key|d,x}}`; Datenauflösung und Darstellung trennen | Unbekannte Keys nicht als unaufgelösten Text versenden. Keine Legacy-Fehlerstrings als Wert; unbekannte Modifier ablehnen. Nur verwendete und erlaubte Daten materialisieren. | | Mitai [Normalisierung](C:/Dev/mitai-jinkendo/backend/normalization_engine.py:16), [Logik](C:/Dev/mitai-jinkendo/backend/logic_evaluator.py:25), [Joinprüfung](C:/Dev/mitai-jinkendo/backend/join_evaluator.py:142) | Endliche Antwortspektren und deklarative Operatoren; explizite Pfadzusammenführung | Strikte Typen und Dreiwertlogik ergänzen. `unknown`/Fehler ist kein boolesches `false`. `wait_any`/`best_effort` nicht als implizite Sicherheitsfehlerbehandlung übernehmen. | | Mitai [Metadatenstandard](C:/Dev/mitai-jinkendo/.claude/docs/audit/platzhalter/PLACEHOLDER_METADATA_REQUIREMENTS_V2_NORMATIVE.md:1), [Framework](C:/Dev/mitai-jinkendo/.claude/docs/technical/PLACEHOLDER_REGISTRY_FRAMEWORK.md:1), [Evidencehelper](C:/Dev/mitai-jinkendo/backend/placeholder_registrations/_evidence.py:15) | Semantik, Typ, Einheit, Zeitfenster, Herkunft und Fehlwerte als Verträge; Evidence kenntlich machen | `code-derived` beschreibt technische Herkunft. Es beweist weder fachliche Richtigkeit noch aktuelle Gültigkeit einer persönlichen Ableitung. Keine Vorentscheidung von ADR-16. | | Mitai [Promptvalidator](C:/Dev/mitai-jinkendo/backend/prompt_executor.py:116), [Debugwerte](C:/Dev/mitai-jinkendo/backend/workflow_executor.py:1073), KI-MIT-11 | Struktur des Prüf-/Diagnosebedarfs berücksichtigen | Das Schemaargument enthält dort noch eine TODO; `json.loads` allein genügt nicht. Debugtexte und aufgelöste Werte werden nicht in den gemeinsamen Standard kopiert. | | Shinkan [Jobfassade](C:/Dev/shinkan-jinkendo/backend/ai_prompt_job.py:14), [Kontextmodell](C:/Dev/shinkan-jinkendo/backend/ai_prompt_context.py:19), [Laufzeit](C:/Dev/shinkan-jinkendo/backend/ai_prompt_runtime.py:31), KI-SHK-07 | Typisierten Fachkontext getrennt von Promptladung/Rendering und Fassade halten | Ein Modul namens Job ist kein dauerhafter Queuevertrag. Konto-, Club- und Objektzugriff übernimmt der bestehende Auth-/Scope-Vertrag. | | Kairo [Eingabevalidierung](C:/Dev/kairo-jinkendo/backend/prompt_validation.py:48), KI-KAI-11 | Ergänzender Vergleich für registrierte Pflichtwerte und Typen | Unbekannte Keys/Typen werden dort nicht automatisch verweigert; der neue Vertrag tut dies. Keine Aktivierung eingefrorener Kairo-KI-/Workflowfunktionen. | | Kanshō über den [fertigen Gateway-Blueprint](C:/Dev/jinkendo-ki-gateway-provider-privacy-blueprint-2026-10-16/Jinkendo_AI_Gateway_Provider_Privacy_Blueprint.md) | Datenminimierung, lokale Detection, Maskierung, Egress-Gate und kontrollierte Rehydrierung | Hier keine zweite Maskierungslogik. Auch vorherige Modellausgaben werden bei erneutem Versand vollständig durch das Gateway geprüft. | Die Wiederverwendung betrifft lokale Muster und geeignete Algorithmen. Kein Produkt importiert Laufzeitmodule aus einem anderen Repository. Eine gemeinsame Bibliothek wird erst bei zwei konkreten Konsumenten mit stabilem Vertrag und Verantwortung extrahiert. ## 3. Komponenten und Foundation-Anschluss ```text Fachrouter / autorisierte Promptverwaltung -> WorkflowService / PromptService -> DefinitionCompiler + eingefrorene Registries -> ScopeMaterializer -> TypedSnapshot -> TemplateRenderer -> ExecutionRepository + Audit (kurze gemeinsame UoW) -> produktlokaler Runner -> ExecutionContextResolver + AccessPolicy -> Scheduler -> PureNodeHandlers -> ModelGateway.complete(context, GatewayCall) -> bestehende Privacy-/Providerpipeline -> WorkflowResultSink innerhalb Gateway-T3 -> Checkpoint / nächster Zustand / safe Progress ``` | Komponente | Verantwortung | Darf nicht | |---|---|---| | `DefinitionCompiler` | Definitionen/Referenzen prüfen, Platzhalter-Tokenplan und Graphplan erzeugen | Daten auflösen, Provider kontaktieren, Rechte aus dem Graph übernehmen | | `PlaceholderRegistry` | Metadaten und vertrauenswürdige Resolverregistrierung | Benutzerwerte, Session oder globales aktuelles Profil speichern | | `HandlerRegistry` / `ResultSpecRegistry` | Codehandler und Ergebnisverträge mit ID/Revision registrieren | Importpfade oder ausführbaren Code aus DB-/Requeststrings laden | | `ScopeMaterializer` | Benötigte Quellen in einem autorisierten Snapshot mit Versionen auflösen | Erstes/minimales Profil wählen oder Profildaten aller Nutzer einsammeln | | `TemplateRenderer` | Vorcompilierte Tokens einmalig mit typisierten Werten ersetzen | Daten laden, rekursiv rendern, Netzwerk oder Templatescripting ausführen | | `WorkflowService` | Start, Verwaltung, Abbruch, Wiederaufnahme; Berechtigungen, Idempotenz und Audit | Nodeoutputs oder privaten Graphkontext in HTTPfehler schreiben | | `Runner` / `Scheduler` | Dauerhaften Zustand lesen, Lease halten, genau den nächsten freigegebenen Knoten koordinieren | In-Memory-Zustand als dauerhafte Wahrheit oder Lease als Benutzerrecht behandeln | | `WorkflowResultSink` | Validierten Gatewayoutput und Nodecheckpoint atomar in T3 speichern | Direkt mit Provider sprechen oder ungeprüften Output übernehmen | | `ProgressReader` | Gefilterten Status nach aktuellem Zugriff lesen | Modelltokens oder beliebige Debugtexte durchreichen | Verzeichnisdefault innerhalb der Foundation: `app/modules/prompts/{models,registry,compiler,renderer,service,repository,api}.py` und `app/modules/workflows/{models,compiler,scheduler,handlers,runner,context,result_sink,service,repository,api}.py`. Produktresolver liegen im jeweiligen Fachmodul. Kein neues generisches CRUD-, DI- oder Pluginframework. `create_app(settings, providers)` erhält diese Adapter aus `bootstrap`. Reine Registrierung ist DB-/netzfrei; Lifespan verwaltet Pool und Gatewayclients. API und Runner nutzen dieselbe Factory/Adapterzusammensetzung und denselben expliziten Modulbestand. Nicht registrierte Features bleiben geschlossen. Der minimale dauerhafte Runner ist ein eigener Prozess aus dem bestehenden Backendimage mit Einstieg `python -m app.modules.workflows.runner`; er nutzt dieselbe Produktdatenbank und läuft nur, wenn das Produkt Workflows benötigt. Kein Redis, RabbitMQ, Celery, Temporal oder neuer zentraler Dienst als Voraussetzung. Der zusätzliche lokale Prozess ist später Teil des bestehenden Produktbetriebs und muss in dessen Start-/Stop-/Drainablauf eingebunden werden. Dieses Dokument legt keine neuen Container, Deploymentdateien oder CIjobs an. Ein flüchtiges FastAPI-`BackgroundTasks`-Objekt ersetzt ihn nicht. ## 4. Konkrete Python-Verträge Die Beispiele sind Schnittstellen V/K, keine vollständigen Module. `RequestContext`, `ScopeRef`, `ResourceRef` und `Tx` werden aus Phase 3.3 übernommen; Gatewaytypen aus dem vorherigen Blueprint. Gezeigte Importpfade sind konsistent anzupassende Defaults. ```python from dataclasses import dataclass, field from typing import Literal, Protocol from app.core.context import RequestContext, Tx from app.modules.ai.contracts import SourceBinding, RenderedPrompt @dataclass(frozen=True, slots=True) class DefinitionRef: definition_id: str revision: int @dataclass(frozen=True, slots=True) class ResolvedValue: key: str available: bool value_json: str | None = field(repr=False) missing_reason: Literal[ "no_data", "insufficient_data", "not_applicable" ] | None sources: tuple[SourceBinding, ...] @dataclass(frozen=True, slots=True) class MaterializedInput: snapshot_id: str execution_id: str values: tuple[ResolvedValue, ...] = field(repr=False) sources: tuple[SourceBinding, ...] @dataclass(frozen=True, slots=True) class LeaseClaim: execution_id: str worker_id: str fence: int class ScopeMaterializer(Protocol): def load(self, tx: Tx, context: RequestContext, execution_id: str, plan_id: str) -> MaterializedInput: ... class TemplateRenderer(Protocol): def render(self, prompt: DefinitionRef, plan_id: str, materialized: MaterializedInput) -> RenderedPrompt: ... class ExecutionContextResolver(Protocol): def resolve(self, tx: Tx, claim: LeaseClaim) -> RequestContext: ... class WorkflowRunner(Protocol): async def run_claim(self, claim: LeaseClaim) -> None: ... ``` `value_json` ist die begrenzte kanonische JSONdarstellung eines bereits typgeprüften Werts, nicht beliebiger JSONtext aus dem Client. Dies hält das eingefrorene Objekt auch intern unveränderlich; `available=true` kann bei nullablem Vertrag ausdrücklich JSON `null` enthalten. `available=false` hat `value_json=None` und einen erlaubten `missing_reason`. Fehler in Resolver, Datenbank oder Berechtigung sind Exceptions mit sicherem Code, keine Fehlwerte. JSON-`NaN`/Infinity, doppelte Objektkeys, falsche Typen und übergroße Werte werden abgelehnt. `bool` gilt nicht als numerischer Messwert. Der Renderer erhält einen intern erzeugten Plan, kein vom Client frei deserialisiertes `MaterializedInput`. Er prüft die gespeicherte Bindung von Snapshot, Plan, Definition und Ausführung. `RenderedPrompt.sources` umfasst auch sämtliche übernommenen Nodeoutputs; Vorlagenrevision ist die konkrete veröffentlichte Revision, nicht `latest`. `ExecutionContextResolver` ist ein enger interner Adapter gemäß Abschnitt 11. Ein selbst konstruierter `Principal(subject_id=...)` ist keine Identitätsprüfung. Rollen, Capabilities und Entitlements stehen nicht im Snapshot als dauerhafte Autorität. ## 5. Registries und Erweiterungsvertrag ### 5.1 Eine Metadatenquelle für Platzhalter Jeder `PlaceholderSpec` enthält: `key`, `revision`, Beschreibung, `output_spec_id`, atomar/roh/interpretiert/Score/Meta, Einheit, explizites Zeitfenster, Semantik, Fehlwertvertrag, erforderliche Capabilities, erlaubte Scopearten, Quellen-/Feldselektor, Resolver-ID, Herkunft/Evidence je Metadatum, bekannte Grenzen, Deprecation und optionalen Nachfolger. Erklärung/Caption für `|x` und Kurzbeschreibung für `|d` entstehen aus derselben Definition. Beispiele im Katalog sind ausschließlich synthetisch. Ein Key folgt als Default `[a-z][a-z0-9_]{0,63}`. Änderungen an Typ, Semantik, Einheit oder Zeitfenster erhalten eine neue Revision oder einen neuen Nachfolger; bestehende Prompts wechseln nicht stillschweigend. Technisch unbekannte Herkunft wird als unbekannt markiert. Ein produktiv verwendeter Resolver braucht einen ausführbaren Typ-/Quellen-/Zugriffsvertrag; eine bloß unbekannte Beschreibung ist keine Erlaubnis, beliebige Daten zu laden. Fehlwertvorgaben sind pro Promptbindung `required` oder `optional`. Bei `required` verhindert ein zulässiger Fehlwert die Ausführung (`input_unavailable`). Bei `optional` rendert der Renderer eine feste typisierte Fehlwertdarstellung, beispielsweise kanonisches `{"available":false,"reason":"no_data"}`. Kein freies Ersatzprompt aus dem Request, keine erfundene Null oder Nullzahl. Die Kennzeichnung ist Teil des versendeten Inhalts und durchläuft das Gateway. Unberechtigte Quellen werden auch bei `optional` verweigert. ### 5.2 Resolver- und Funktionsregistrierung Vertrauenswürdige Module registrieren im Bootstrap etwa `register_placeholders(registry)` und `register_handlers(registry)`. Doppelte `(id, revision)`, unbekannte Typen oder fehlende Handler verhindern den Start des betroffenen Moduls. Nach Aufbau `freeze()`; APIrequests können keine Pythonfunktionen registrieren. Ein vorhandenes Produkt kann seine Importregistrierungen hinter diesem Adapter weiterverwenden, soweit sie keine DB-/Netzseitenwirkung beim Import besitzen. Ein `HandlerSpec` trägt ID, Revision, erlaubten Knotentyp, Input-/Output-Spec, maximale Ausgabe, Capabilitybedarf und Effektklasse. Im ersten Schnitt gibt es nur `pure` und `model_gateway`. Pure Handler arbeiten auf übergebenen Snapshots, lesen keine DB und führen weder HTTP, E-Mail, Dateien, SQL noch Unterprozesse aus. Fachberechnungen bleiben im vorhandenen Data Layer, werden vom autorisierten Materializer aufgerufen und nicht im Exporter/Template nachgebaut. Die Registry ist damit der Registrierungslayer für neue Funktionen, aber kein universeller Toolzugang. Ein späterer lokaler Fachwrite benötigt einen benannten Serviceport, aktuelle Objektprüfung, Idempotenz und einen gemeinsamen UoW-Vertrag. Externe Aktionen benötigen zusätzlich einen eigenen Wirkungs-/Reconciliationvertrag; sie sind in dieser Laufzeitversion nicht als freier Handler zugelassen. Text aus einer Modellausgabe kann keinen Handler oder seine Rechte auswählen. Picker, Validator, Renderer und Metadatenexport lesen denselben eingefrorenen Katalog. Ein Metadatenexport enthält keine Resolvercallables, Zugangsdaten oder persönlichen Werte. Wertepreview und Metadatenkatalog haben getrennte Rechte-/Responseverträge. ## 6. Prompt- und Workflowversionen ### 6.1 Entwurf, Veröffentlichung und Aktivierung `draft` ist mit `expected_version` bearbeitbar. `publish` prüft das vollständige Paket und erstellt eine **unveränderliche** Revision mit Compilerrevision und Inhaltsdigest. Für generische produktweite Definitionen ist dies SHA-256; für private Definitionsinhalte gilt die geschützte HMAC-/Key-ID-Bindung, kein öffentliches Volltext-Hashorakel. `activate` ändert nur den aktiven Pointer unter erwarteter Pointerversion und Audit; bereits gestartete Ausführungen bleiben gebunden. Ein erfolgreich veröffentlichter Prompt kann dennoch fachlich ungeeignet sein; Publikation ist keine Modellqualitätsbewertung. Promptrevision: geordnete Rollen-/Textbausteine, Placeholderbindings, Frageergänzungen mit IDs/Spektren, `purpose`, `result_spec_id` samt Revision, erlaubte Scopearten und Quellenplan. Keine ProviderURL, Schlüssel oder ungeprüfte Modell-ID. Rollen stammen aus der vertrauenswürdigen Definition; Clientinstruktionen werden als erlaubte Nutzereingabe gebunden, niemals zur System-/Developerrolle hochgestuft. Tools, Bilder und Providerplugins bleiben gemäß Gatewaystandard geschlossen. Workflowrevision: kanonischer Graph, konkrete Promptrevision je `analysis`, Handler-/Placeholder-/ResultSpec-Revisionen, Normalisierungstabellen, Quellenplan, Grenzen und Ausgabevertrag. Inlineprompts aus Mitai sind als eingebettete unveränderliche Promptrevision Teil desselben Pakets zulässig. Ein Slug ist eine Verwaltungshilfe; Auflösung nach `latest` während eines laufenden Knotens ist verboten. Snapshotbindung umfasst Definitionen, Inputs, ausgewählte Quellenfelder und Versionen. Aktuelle Security-, Privacy- und Providerpolicy darf nicht zugunsten einer alten Snapshotpolicy umgangen werden. Ist ein gebundener Stand technisch nicht mehr vorhanden/kompatibel, `definition_unavailable`; ist ein sicherheitsrelevanter Stand geändert, `context_changed`. Kein stilles Upgrade. Eine neue Ausführung kann die aktuelle Kombination ausdrücklich neu binden. ### 6.2 Rechte auf Definitionen Definitionen können produktweit betreiberverwaltet oder scopegebunden sein. Produktweite Definitionen enthalten generische Instruktionen und erlaubte Resolverbezeichner; keine persönlichen Inhalte. Scopegebundene Definitionen und private Freitextentwürfe bleiben in ihrem Datenraum. Verwenden einer freigegebenen Vorlage, Lesen ihres vollständigen Inhalts, Bearbeiten und Aktivieren sind getrennte Capabilities, als Default `prompt.use`, `prompt.read`, `prompt.edit`, `prompt.publish` und entsprechende Workflowrechte. Ein Clubnutzer mit Ausführungsrecht erhält dadurch kein Leserecht auf fremde private Daten oder auf Betreiberkonfiguration. Aktuelle operatorpflichtige Publikations-/Aktivierungsaktionen nutzen MFA-Step-up des Auth-Blueprints. Ein Graph kann weder die eigene Scopeart ändern noch zusätzliche Capabilities erteilen. Löschen einer referenzierten Revision wird durch FK/Serviceprüfung verweigert; Deaktivieren verhindert neue Starts. Ein gesondertes `revoked_at` sperrt auch noch laufende Ausführungen bei Sicherheitsbedarf. Revisionen bleiben für Nachvollziehbarkeit erhalten, solange gebundene Ausführungen sie benötigen. Private Inhalte unterliegen trotzdem dem Lösch-/Retentionvertrag aus Abschnitt 9. ## 7. Datenauflösung und einmaliges Rendering 1. Compiler tokenisiert sämtliche zu rendernden Textfelder einschließlich Frageergänzungen und Ergebnisformatbeschreibungen. Unbekannte Keys, Modifier, doppelte/mehrdeutige Bindungen und Syntaxfehler verhindern Publikation bzw. Ausführung eines Entwurfs. 2. Der Materializer lädt ausschließlich die im Plan verwendeten Fachquellen im verifizierten Scope. Persönliche Profile werden über die eindeutige lokale Account-Profil-Zuordnung ermittelt; kein erstes Profil und kein vom Browser gesetztes `profile_id`. In Clubkontexten müssen Personenbezug und konkrete Objektsichtbarkeit ebenfalls erlaubt sein. Cross-Scope-Komposition ist in diesem Schnitt nicht erlaubt. 3. Kurze Transaktion: Accessprüfung und autorisierte SELECTs auf demselben `tx`; gemeinsamer Snapshot für mehrere Abfragen über gezielt gesetztes `REPEATABLE READ`. Bei Aggregaten bindet der Adapter einen in derselben Transaktion gepflegten Datenraum-/Quellenrevisionszähler, der auch Inserts und Deletes erfasst. Ein `max(updated_at)` oder alleinige Zeilenzahl ist kein belastbarer Versionsnachweis. Fehlt ein verlässlicher Versionsadapter, startet der entsprechende Resolver nicht. 4. Werte streng gegen ihre Specs prüfen, Snapshot mit konkretem UTC-`as_of`, festen Zeitfenstergrenzen und `SourceBinding` speichern. Flüchtige Angaben wie „heute“ werden hier gebunden; Wiederaufnahme berechnet sie nicht neu. Einzelne Berechtigungsfehler, defekte Berechnungen oder fehlende Registryeinträge brechen ab. 5. Renderer ersetzt Tokens aus dem vorcompilierten Plan genau einmal. Eingesetzter Text ist Dateninhalt; darin enthaltene `{{...}}` werden nicht erneut ausgeführt. Nur der originale Template-Tokenplan wird auf vollständige Auflösung geprüft, nicht eine naive Regex über bereits eingesetzte Nutzerdaten. 6. Alle Rollen, festen Instruktionen, Beschreibungen, eigenen Eingaben und ausgewählten Vorgängerausgaben zusammen ergeben den vollständigen `RenderedPrompt`. Anschließend prüft das Gateway die gesamte endgültige Textinventur. Ein früherer Privacycheck des Snapshots ersetzt diesen Schritt nicht. Mitai-kompatible Modifier: `d` fügt Kurzbeschreibung an den Wert; `x` ohne `d` liefert nur Erklärung; `d,x` liefert Wert, Beschreibung, Erklärung. Für reine `x`-Verwendung wird kein persönlicher Messwert materialisiert; der Metadatenzugriff muss erlaubt sein. Fehlende benötigte Beschreibung/Erklärung ist ein Definitionsfehler, kein stilles Weglassen. Unbekannte Modifier werden nicht ignoriert. Schreibweise und Modifierreihenfolge werden im Compiler normalisiert. Kein Jinja2-Environment, `eval`, Python-Formatattributzugriff, Methodenaufruf oder Template-Include im ersten Schnitt. Mitais Endknoten-Templating ist als vorhandener Komfortmechanismus anerkannt; übernommen wird seine Funktion, nicht die unbeschränkte Engine. Endausgaben verwenden eine Liste expliziter `OutputBinding(node_id, field_path, required)` mit fester Textschablone und derselben einmaligen Tokenersetzung. Feldpfade werden gegen das konkrete DTOschema compiliert, niemals gegen Pythonobjektattribute ausgewertet. Ein späterer Import bestehender Jinja-Vorlagen muss die verwendeten Konstrukte ausdrücklich abbilden oder die Vorlage als nicht unterstützt melden. Importierte Markdown-/Freitexte und Modelloutputs bleiben untrusted content. Sie können keine Rollen, Policies, Provider, Quellen oder Handler verändern. Der Vertrag begrenzt Wirkung; er behauptet keine vollständige Verhinderung semantischer Promptinjektion. Im Frontend nur als Text oder durch den bestehenden sicheren Markdown-/HTMLpfad anzeigen; kein `innerHTML` aus Modelltext und kein automatisches URL-/Bildnachladen. ## 8. Graph-, Signal- und Joinsemantik ### 8.1 Publikationsprüfung Veröffentlichen akzeptiert nur: eindeutige Node-/Edge-IDs; vorhandene Endpunkte; genau einen Start ohne Eingang und genau ein Ende ohne Ausgang; keine Zyklen; jeder Knoten vom Start erreichbar und mit Pfad zum Ende; gültige und eindeutige Ports; unterstützte Knotentypen; alle erforderlichen Felder und keine fremden Felder (`extra='forbid'`). Rekursion, Schleifen und dynamische Teilgraphen sind geschlossen. Der strengere Ein-Ende-Default vereinfacht einen eindeutigen finalen Commit; die Bestandsmodelle erlauben mehrere Enden und sind nicht automatisch kompatibel. `start`/`analysis`/`join` aktivieren nach erfolgreichem Abschluss ihre ausgehenden Kanten. Fan-out ist erlaubt, Ausführung bleibt sequenziell. `logic` besitzt genau eine `true`- und eine `false`-Kante, optional eine `uncertain`-Kante; `end` hat keine ausgehende Kante. Mehrfache Eingänge sind nur bei `join` erlaubt, alle anderen Nichtstartknoten besitzen genau einen Eingang. Nicht ausgewählte Kanten werden ausdrücklich `inactive`; nicht besuchte Pfade sind bis zur Entscheidung `unresolved`, niemals stillschweigend `true` oder `skipped`. Compiler prüft Input-/Outputtypen, konkrete Referenzpfade und Abhängigkeiten: Ein erforderlicher Vorgängerwert muss auf jedem Weg zum Konsumenten verfügbar sein (Dominanz-/Pfadprüfung). Ein nur bedingt erreichbarer Wert benötigt einen expliziten optionalen Inputvertrag. Jede Datenreferenz erzeugt zusätzlich eine Ausführungsabhängigkeit; vorwärtsgerichtete/zyklische Abhängigkeiten werden verweigert. Zwei Signale mit gleichem Namen aus verschiedenen Nodes werden über `(node_id, question_id)` unterschieden. ### 8.2 Deterministische Ausführung Der Scheduler besucht den compilierten Graph in stabiler topologischer Ordnung, bei Gleichstand lexikografisch nach Node-ID. Er führt einen Knoten erst aus, wenn alle eingehenden Kanten entschieden und alle Datenabhängigkeiten abgeschlossen sind. Hat ein normaler Knoten keinen aktiven Eingang, wird er `skipped`, seine ausgehenden Kanten werden ebenfalls `inactive`. Skipentscheidungen werden dauerhaft gespeichert; sie hängen nicht von der zufälligen Besuchsreihenfolge eines BFS ab. | Knotentyp | Eingabe / Ausgabe | Wirkung | |---|---|---| | `start` | Gebundene freigegebene Eingabe | Aktiviert Startpfade; kein Modellcall | | `analysis` | Konkrete Promptrevision plus freigegebene Inputs | Genau ein logischer Gatewaycall; typisierter Output und benannte Signale | | `logic` | Geprüfte Signale / erlaubte skalare Felder | Endlicher deklarativer Ausdruck; Routing `true`/`false`/`unknown` | | `join` | Entschiedene eingehende Pfade, getrennte Outputs | Strukturierte Zusammenführung mit expliziter Pfadabdeckung | | `end` | Explizite Outputbindings | Finales Ergebnis samt Vollständigkeit; keine automatische Modellzusammenfassung | Frageergänzungen folgen Mitais Vorrangregel: Nodefragen ersetzen gleichnamige Promptdefaults; zusätzliche IDs ergänzen sie. Die endgültige Liste, Fragetexte, Spektren und Synonyme sind bereits beim Veröffentlichen eindeutig gebunden. Keine Änderung anhand einer Modellantwort. Signale enthalten `question_id`, `status` (`valid`, `normalized`, `unclear`, `invalid`, `not_decidable`), erlaubten Normalwert oder `null`, sowie Normalisierungsrevision. Der Gateway-ResultSpec erlaubt für ein unsicheres Signal ausdrücklich eine unsichere/null-Ausprägung; unerlaubte zusätzliche Felder oder völlig fremde Werte sind dagegen ungültiger Modelloutput. Normalisierung verwendet nur veröffentlichte exakte Werte, eine eindeutige Case-/Whitespace-Regel oder eindeutige Synonymtabellen. Mehrdeutige Synonyme verhindern Publikation; kein weiterer Modellcall zur Interpretation. Logik unterstützt Mitais `eq`, `neq`, `in`, `not_in`, `gt`, `lt`, `gte`, `lte`, `contains`, `and`, `or`, `not` mit streng geprüften Operandentypen und Begrenzung der Tiefe. Keine Truthiness von Strings, keine automatische Zahlkonvertierung. Semantisch unsichere/fehlende Signale ergeben `unknown`. Dreiwertlogik: `false AND unknown = false`, `true AND unknown = unknown`; `true OR unknown = true`, `false OR unknown = unknown`; `NOT unknown = unknown`. Technische Fehler oder fehlende Berechtigung sind keine Dreiwertoperandwerte, sondern stoppen die Ausführung. `unknown` routet nur auf eine ausdrücklich definierte `uncertain`-Kante. Ohne diese pausiert der Lauf als `paused_input`. Resume allein entscheidet das Signal nicht: im ersten Schnitt ist dann eine neue Ausführung mit neuer autorisierter Eingabe nötig. Ein späterer fachlicher Reviewadapter müsste Entscheidung und unveränderte Inputbindung versioniert speichern. `default_path`/`conservative_skip` aus Mitai dürfen nur über einen expliziten Importadapter mit gleichwertig erklärter Fachsemantik übernommen werden; kein allgemeines `except: else`. ### 8.3 Joins und Teilergebnisse Default ist `wait_all` plus `ignore_skipped`: Nach Entscheidung sämtlicher Eingänge müssen alle **aktiven** Pfade erfolgreich sein und mindestens ein aktiver Pfad existieren. Inaktive Zweige zählen nicht als Fehler. Sind sämtliche Eingänge inaktiv, wird der Join selbst übersprungen. `min_paths` ist eine positive veröffentlichte Mindestzahl erfolgreicher aktiver Pfade und kann die Sicherheitsprüfung nicht reduzieren. `wait_any` ist im sequenziellen Default **kein Rennen** und kein vorzeitiger Commit: erst alle Eingänge entscheiden, dann mindestens einen erfolgreichen aktiven Pfad verlangen. `best_effort` darf ausschließlich ausdrücklich als optional markierte fachliche Nodefehler auslassen, sobald alle Eingänge terminal sind. Solche Fehler sind z. B. `input_unavailable` bei einem optionalen Analyseschritt, nicht Gateway-/Privacy-/Autorisierungsfehler. Die zulässigen Codes und Mindestzahl erfolgreicher Pfade stehen im veröffentlichten Vertrag; Default ist keine Fehlerausnahme und `min_paths=1`. `unknown` nach Versand, `paused_auth`, Privacyreview, aktuelle Quellkonflikte und Sicherheitsfehler lassen sich durch keinen Join konsumieren oder in Erfolg umwandeln. Keine Zeitüberschreitung erzeugt automatisch einen Ersatzpfad. Der historische `best_effort.timeout_seconds`-Parameter wird für diesen sequenziellen Schnitt nicht unterstützt und beim Import gemeldet. Zusammenführung erhält je Ursprung `node_id`, Outputref, Status und Coverage. Kein last-write-wins zwischen gleichnamigen Signalen. Ein erlaubtes Teilergebnis trägt `complete=false`, sichere ausgelassene Node-/Reasoncodes und erfüllt weiterhin das konkrete Ausgabe-DTO. Das Endergebnis erhält dann `completed_partial`. Sind nach Routing alle Wege zum Ende inaktiv oder fehlen erforderliche Werte, `failed`/`no_result`; kein leeres `completed`. ## 9. Dauerhafte Datenstrukturen Logische Tabellen in der **jeweiligen Produktdatenbank**; IDs und Scope-FKs folgen dem lokalen Authmodell. Keine gemeinsame Tenant-Fachdatenbank. Migrationen werden später gemäß Foundation separat und transaktional ausgeführt, nie beim Appstart. | Tabelle | Wesentliche Felder / Constraints | |---|---| | `prompt_definitions`, `prompt_revisions` | Owner-/Scopeart oder explizit `product`; Draftversion, aktive Revision/Pointerversion; immutable Revision mit Inhalt, Schemas/Bindings/Compilerrevision/Digest, Publishactor, `revoked_at`; unique `(definition_id, revision)` | | `workflow_definitions`, `workflow_revisions` | Dieselbe Trennung; kanonischer Graph, gebundene Referenzen, Grenzen, Inhaltshash; keine persönlichen Beispielwerte in produktweiten Revisionen | | `workflow_executions` | UUID, `subject_id`, unveränderlicher `scope_kind/scope_id`, Workflowrevision, Status/Reason, `row_version`, Start-/Deadline-/Expiryzeit, aktuelle Autorisierungsbindung `(credential_id, credential_generation)`, Snapshotref, Input-HMAC mit Key-ID, Idempotenzschlüssel, `cancel_requested_at`, Leaseowner/Expiry/Fence, Zähler und optionale `result_ref` | | `workflow_input_snapshots` | Ausführungs-FK, streng begrenzte private kanonische Inputwerte, konkrete SourceBindings/Versionsdigest und Zeitfenster, Delete-/Expiryzustand; Owner/Scope wie Execution | | `workflow_node_runs` | PK `(execution_id, node_id)`; Status, Inputbindung, Start/Ende, Fence, sichere Reasoncodes, Outputref und bei Analyse `call_id`; ein logischer Analysecall pro Node, keine neue ID bei Recovery | | `workflow_edge_states` | PK `(execution_id, edge_id)`, `unresolved/active/inactive`, verursachender Nodecheckpoint; keine impliziten Defaults | | `workflow_outputs` | Ausführungs-/Nodebezug, private immutable Ausgabe mit eigener Outputrevision, Specrevision, SourceBindings, `complete`; nur autorisiert lesbar, nicht Rohproviderantwort oder Chat-/Reasoningdump | | `workflow_events` | Monotone Eventsequenz je Lauf, sichere Zustands-/Reasoncodes, IDs/Zeit; unique `(execution_id, sequence)`; Teil des jeweiligen Commits, keine Volltexte | | bestehendes `ai_calls` / Audit | Gatewayledger und Foundation-Audit weiterverwenden; Call-/Checkpoint-Verknüpfung statt zweitem Providerledger | Alle privaten Lookups filtern bereits im Repository nach Subject/Scope bzw. explizitem Objektzugriffsvertrag; UUIDbesitz genügt nicht. Scope und Execution-ID werden in zusammengesetzten FKs/Unique-Constraints gegen das Vertauschen von Snapshot-, Output- und Nodezeilen abgesichert. Produktweite Vorlagen erzeugen trotzdem ausschließlich scopegebundene Ausführungen. Owner eines Laufs ist im Default der startende Mensch; Clubmitglieder sehen fremde Läufe nur über einen konkret registrierten Fachfreigabevertrag, der hier nicht vorausgesetzt wird. Idempotenz: unique `(subject_id, scope_kind, scope_id, idempotency_key)` für Start. Derselbe Schlüssel mit gleichem serverseitig gebundenem Input liefert denselben Lauf nach aktueller Autorisierung; andere Eingabe liefert 409 `execution_conflict`. Ein Startretry nach Änderung des aktiven Pointers löst eine bereits vorhandene Bindung nicht neu auf. Keys sind begrenzte kanonische UUIDs. HMAC und Key-ID folgen dem Gateway-Keyvertrag, nicht einem öffentlichen Hash persönlicher Eingaben. Privater Input- und Outputspeicher ist hier ausdrücklich erforderlich, damit erfolgreiche Nodes nach einem Crash fortgesetzt werden können. Es ist kein allgemeiner Prompt-/Responsecache: nur benötigte Werte/validierte DTOs, kein komplett gerenderter Prompt, keine rohe Providerantwort oder Pseudonymtabelle. Betriebs-/Backup-/Zugriffsgrenzen entsprechen dem geschützten Produktdatenraum. `repr=False` ist nur zusätzliche Loghygiene, keine Verschlüsselung. Default: private Ausführungsinhalte bis sieben Tage nach terminalem Abschluss, pausierte Läufe höchstens 24 Stunden ohne Fortsetzung; produktbezogene Abweichungen mit Löschkonzept möglich. Ablauf/Löschung storniert den Lauf und entfernt private Snapshots/Outputs nach sicherem Stop. Minimale ID-/Outcome-/Dedup-Tombstones für ungeklärte bzw. referenzierte Calls bleiben gemäß Gatewayvertrag erhalten; Cleanup erteilt niemals eine neue Versanderlaubnis. Fachlich übernommene Ergebnisse werden über einen expliziten Fachservice mit eigener Retention gespeichert, nicht durch stilles Verlassen der Workflowfrist. Referenzierte Definitionsinhalte und personenbezogene Freitexte werden getrennt aufbewahrt; nach zulässiger Löschung privater Inhalte darf nur der technische Nachweis übrig bleiben. Für gelöschte Inhalte gibt es keine Wiederaufnahmegarantie. Export/Backup ist kein Retentions-Bypass; Wiederherstellung beachtet die Sperr- und Invalidierungsregeln des Recovery-Blueprints. ## 10. Zustände, Abbruch und Wiederaufnahme ### 10.1 Execution und Node | Executionzustand | Bedeutung / erlaubter nächster Schritt | |---|---| | `queued` | Start samt Snapshot committed, noch kein aktiver Claim | | `running` | Aktueller Runnerclaim; nächste Node ausschließlich nach aktuellen Prüfungen | | `paused_auth` | Session abgelaufen/erneuert oder frischer MFA-Nachweis nötig; nur explizites Resume desselben Owners mit gültiger Session im selben Scope | | `paused_review` | Gateway verlangt lokale Privacyklärung; nur vorhandener autorisierter Reviewadapter mit exakter Bindung erlaubt Fortsetzen | | `paused_dependency` | Nachweislich unversendete Arbeit durch technische Abhängigkeit blockiert; explizites Resume nach Wiederverfügbarkeit und erneuter Prüfung, keine automatische Generatewiederholung | | `paused_input` | Nicht entscheidbares Fachsignal; keine freie Cliententscheidung, im ersten Schnitt neue Eingabe/neuer Lauf | | `blocked_context` | Quelle/Definition/Policy nicht mehr gebunden oder verfügbar; kein automatisches Neubinden; neuer Lauf nötig | | `paused_unknown` | Mindestens ein Call möglicherweise versendet; keine automatische Wiederholung oder Fortsetzung abhängiger Nodes | | `cancel_requested` | Dauerhafte Abbruchanforderung; keine neuen Dispatchentscheide; bereits laufender Transport kann noch verarbeitet/berechnet werden | | `completed`, `completed_partial` | Finaler erlaubter Output und Abschluss gemeinsam committed | | `cancelled`, `failed`, `expired` | Terminal, keine weiteren Nodes; Grund und bekannte/ungeklärte Callwirkung getrennt erhalten | Nodezustände: `pending`, `running`, `awaiting_review`, `succeeded`, `skipped`, `failed`, `unknown`, `cancelled`. `running` ist kein Versandergebnis; dafür gilt ausschließlich das Gatewayledger. Ein pausierter Lauf lässt die blockierte Node je nach Ursache `pending`, `awaiting_review` oder `unknown`. Erfolgreiche Nodes werden nicht erneut berechnet. Zustandsübergänge erfolgen nur per erwarteter `row_version` und aktuellem Fence, zusammen mit Edgezuständen, Event und Audit in einer UoW. `completed_partial` setzt einen publizierten fachlichen Teilvertrag voraus. Ein fehlgeschlagener Sicherheitscheck wird weder `skipped` noch `completed_partial`. Der endgültige Status kann nicht allein aus „Schleife beendet“ oder der Zahl besuchter Knoten entstehen. ### 10.2 Cancellation Cancel ist ein idempotenter autorisierter POST. Der Service sperrt gemäß Auth-Lockordnung zunächst Account/Session/Scope, dann Execution, prüft Owner/Capability und schreibt `cancel_requested_at`, Status und Audit. Runnerprüfungen und Gateway-T2 konsultieren denselben dauerhaften Zustand. Ein bereits terminaler Lauf bleibt terminal und liefert seinen aktuellen Status. Für dieses Objekt erfolgt keine globale Session-/Tenantänderung. Lokaler Abbruch/Verbindungsabbruch sind verschieden: Schließen des Browserfensters cancelt keinen angenommenen Auftrag. Ein ausdrücklicher Cancel stoppt vor dem nächsten Dispatch, bricht laufendes lokales Await soweit möglich ab und verwirft nachträgliche Inhalte. Nach möglichem Versand bleibt Usage gegebenenfalls `unknown`; `cancelled` behauptet weder Nullkosten noch erfolgreichen Providerabbruch. Die Rückgabe kann zunächst `cancel_requested` sein, endgültig erst nach koordiniertem Stop/Recovery. ### 10.3 Recoveryentscheidung | Persistierter Stand nach Crash/Leaseverlust | Verhalten | |---|---| | Pure Node `running`, keine fremde Wirkung | Neuer Claim darf dieselbe reine Berechnung aus demselben Snapshot erneut ausführen; Commit bleibt per Fence/CAS geschützt | | Analysisnode noch ohne Dispatch, Ledger `prepared`/nachweislich `failed_unsent` | Gleiche Node-/Call-ID; erneute aktuelle Prüfung und vollständige Gatewaypipeline, solange alle Inputbindungen unverändert sind | | `dispatching` oder `unknown`, kein atomarer Ergebnischeckpoint | `paused_unknown`; kein erneutes Generate und keine automatische Ausweichroute | | Ledger `completed` mit erlaubter `result_ref` und erfolgreichem Nodecheckpoint | Vorhandenes Ergebnis nach aktueller Autorisierung weiterverwenden; keine Neugenerierung | | Ledger `completed`, aber Ergebnis nicht gespeichert/gelöscht | `result_unavailable`, Lauf blockiert; keine Rekonstruktion durch kostenlosen Retry behaupten | | Gatewayantwort im RAM, T3 nicht committed | Keine wiederherstellbare Antwort; je Ledger konservativ ungeklärt, nicht automatisch erneut senden | | Snapshot/Definition/Quellenversion oder alte HMAC-Keyversion fehlt | `blocked_context`; vorhandene Call-ID bleibt gesperrt | Ein neuer Lauf nach ungeklärtem Call ist nur eine ausdrückliche Benutzeraktion mit neuer Start-ID und sichtbarem Hinweis auf mögliche zusätzliche Kosten; er löst den alten Call nicht auf. Es gibt keinen pauschalen `/retry`-Endpoint, der intern Node-/Call-IDs austauscht. Wiederaufnahme gibt keine Garantie identischer Modellausgaben; sie verwendet bereits gespeicherte Ergebnisse oder führt bislang nicht versendete Arbeit aus. ### 10.4 Einheitliche Fehlerzuordnung Der Koordinator übernimmt sichere Gateway-Reasoncodes, ohne eine zweite Wirkungsbewertung zu erfinden: `awaiting_review` führt zu `paused_review`; nach möglichem Versand `unknown`/ungeklärte Deadline zu `paused_unknown`. Nachweislich unversendete technische Abhängigkeitsfehler führen zu `paused_dependency`; kein Polling startet dadurch einen neuen Generateversuch. `blocked_context` umfasst Quell-/Definitions-/Policykonflikte. Ungültiger/refusierter Modelloutput führt zu `node=failed` und im Default `execution=failed`, ohne Repaircall. Verweigertes Konto-/Scope-/Objektrecht stoppt den Lauf gemäß Abschnitt 11; ein bereits verworfenes Resultat wird nicht durch späteres Resume wieder freigegeben. `paused_dependency` kann nur mit aktuellen Rechten und unveränderten Bindungen explizit fortgesetzt werden, sofern der Ledger tatsächlich keinen Versand erlaubt bzw. begonnen hat. Gibt es bereits `dispatching`, `unknown`, verworfenen Output oder fehlende gespeicherte Antwort, gilt die konservativere Recoveryregel. Privacyreview setzt einen vorhandenen vertrauenswürdigen Reviewadapter voraus; ohne ihn bleibt die Pause bestehen. `paused_auth` kann nur noch nicht versendete Arbeit oder bereits erfolgreich gecheckpointete Nodes weiterführen. Bestätigte technische Handlerfehler sind terminal, außer der veröffentlichte optionale Fachvertrag erlaubt genau ihren sicheren Fachcode. ## 11. Runner, Sessionbindung und Konkurrenz ### 11.1 Produktlokaler Claim Der Runner beansprucht einen bereiten Lauf per kurzer DB-Transaktion mit Zeilensperre, beispielsweise `FOR UPDATE SKIP LOCKED`, erhöht den monotonen Fence und setzt Leaseowner/-ablauf. Default: ein Runnerprozess mit einer aktiven Ausführung; zusätzliche Prozesse nutzen denselben Claimvertrag. Polling ist nur für fällige `queued`/recoveryfähige Zustände, nicht für pausierte/terminale Läufe. DBzeit bestimmt Ablauf; Heartbeat erneuert die Lease in kurzen separaten Transaktionen. Er verleiht keine Berechtigung und verlängert keine Benutzersession. Keine Connection wird über Modellawaits gehalten; synchrone Psycopg-UoWs laufen im Asyncpfad über die Foundation-Threadbridge. Heartbeat und Modellawait werden koordiniert; bei verlorener Lease stoppt der alte Runner lokale Arbeit und darf keinen weiteren Nodecheckpoint schreiben. Jeder technische Write prüft `(execution_id, worker_id, fence, lease_expires_at > DBzeit)` plus erwartete Zustandsversion. Claim/Leaseverwaltung sperrt nur die Execution und fasst danach keine Account-/Scopezeilen an. Autorisierte Fachphasen halten die Reihenfolge **Account → Session → Datenraum → Mitgliedschaft → Execution → Node/Call → Output/Audit** ein. So entsteht keine inverse Lockordnung zwischen technischem Claim und Accessprüfung. SQLadapter prüfen nach `UPDATE` die tatsächlich geänderte Zeile; kein Ignorieren fehlgeschlagener CAS. ### 11.2 Autorisierung eines dauerhaften Laufs Im ersten Schnitt ist jeder Lauf an die **bestehende lokale Humansession** des Starts gebunden. Gespeichert werden nur interne Session-ID und Generation, keine Cookiebytes, CSRFtokens oder Passwörter. Der interne Contextresolver liest diese Session unter aktuellem Kontostatus, Account-/Sessionepoch, Generation, Idle-/Absolute-Expiry, Sessionmode, MFA und Scopevertrag. Er darf nur an eine existierende Execution/Claimbindung anknüpfen. Er exponiert keine öffentliche „Principal aus User-ID“-API. Der Zugriff auf die Sessionzeile erfolgt hier aufgrund des bereits autorisierten persistierten Auftrags, nicht aufgrund einer ID aus einem neuen Request. Der Runner verlängert `last_seen` nicht und erzeugt keine Session. Nur eine gültige volle Humansession ergibt einen Arbeitscontext. Browserrequests behalten ihren unveränderten Cookie-/CSRF-/Originvertrag. Der interne Adapter ist eine lokale Erweiterung der Authports, kein neuer Anmeldemechanismus und keine allgemeine Delegationsberechtigung. Sessionablauf oder legitime Rotation pausiert den Lauf als `paused_auth`. Ein aktueller Browserrequest desselben Subjects kann ihn im selben Datenraum mit `expected_version` erneut binden, nachdem Konto, Ausführungs-/Quellenrechte, unveränderte Inputs und erforderliches MFA geprüft wurden. Dieser Rebind ersetzt lediglich Session-ID/Generation und wird auditiert; Workflow-, Scope-, Input- und Callidentitäten bleiben unverändert. `paused_unknown`, `blocked_context`, `paused_input` und terminale Läufe werden dadurch nicht freigegeben. Explizites Logout/Widerruf der gebundenen Session, Kontosperre/-löschung oder Entzug der Mitgliedschaft bzw. Fähigkeit stoppt den Lauf; Default terminal `cancelled` mit sicherem Reasoncode. Bereits gestartete Modellwirkung kann weiter ungeklärt bleiben. Eine spätere Wiedererteilung von Rechten weckt solche Läufe nicht automatisch. Konto-/Objektprüfung erfolgt vor jedem Materialisieren, jeder Nodefreigabe, Gateway-T2, Gateway-T3 und jeder Anzeige erneut. Ein Operator kann fremde private Läufe nicht durch seinen Betreiberstatus übernehmen. ### 11.3 Lease, Dispatch und Racegrenze Eine Lease verhindert nicht allein einen doppelten externen Call. Entscheidend ist die Gatewaybindung: stabile Call-ID, unique logische Nodeidentität, atomarer Übergang `prepared -> dispatching` und kein neuer Versand bei `dispatching/unknown`. Gateway-T2 prüft zusätzlich den aktuellen Executionzustand und Fence. Ein neuer Claim kann dadurch nicht die bereits erteilte Sendeberechtigung duplizieren. Dabei persistiert T2 den freigebenden Fence als `dispatch_fence` an der Node-/Callbindung in derselben Transaktion wie den Dispatchintent. Nach diesem Entscheid wird er für diesen Call nicht auf einen neuen Claim umgeschrieben. T3 vergleicht genau diesen gebundenen Fence mit der aktuellen Executionlease; bloß die neueste Fencezahl zu laden und als eigenen Claim auszugeben wäre unsicher. Eine neue Lease darf einen alten unversendeten Pure-/Preparedversuch übernehmen, aber keinen alten Dispatch als ihren eigenen Erfolg bestätigen. Zwischen dem letzten DBentscheid und dem externen Netzwerk besteht weiterhin keine verteilte Transaktion. Ein Cancel, Widerruf oder Leaseverlust direkt nach diesem Entscheid kann bereits freigegebene Bytes nicht zurückholen; der kurze Gateway-Dispatchpermit begrenzt das Fenster. T3 prüft erneut und verwirft dann Inhalte. Es gibt keinen Exactly-once-Anspruch für Netzwerk und Datenbank. Lokal sorgt ein eindeutiger erfolgreicher Checkpoint dafür, dass ein bereits gespeichertes Nodeergebnis nicht doppelt fachlich übernommen wird. ## 12. Analysisnode und Gatewayintegration ### 12.1 Aufnahme und stabile Callbindung Startservice: aktueller Context, `workflow.execute` und konkrete Quellen-/Objektrechte prüfen; veröffentlichte Version und alle Inputs einmalig binden; Snapshot, Execution, Nodes/Edges, Startidempotenz und Audit atomar speichern; erst nach Commit `202 Accepted`. Der Runner darf keine neuen vom Browser gelieferten `variables`, Rollen, Profile oder Graphfragmente nachladen. Vor einer Analysisnode: aktuelle Session-/Scope-/Quellen-/Definitionsprüfung und Lease/CAS in kurzer UoW. Persistente Call-ID wird **vor** jedem möglichen Versand einmalig dem Node zugeordnet. `GatewayCall.execution_id` ist die Execution-UUID, `node_key` die unveränderliche Node-ID. Die serverseitige `purpose`-/ResultSpecbindung stammt aus der veröffentlichten Promptrevision. Ein Resume ändert keine dieser Identitäten. ```python from app.core.context import RequestContext from app.modules.ai.contracts import GatewayCall, ModelGateway, RenderedPrompt async def invoke_analysis(gateway: ModelGateway, context: RequestContext, *, call_id: str, execution_id: str, node_id: str, purpose: str, rendered: RenderedPrompt, result_spec_id: str): call = GatewayCall( call_id=call_id, execution_id=execution_id, node_key=node_id, purpose=purpose, rendered=rendered, result_spec_id=result_spec_id, ) return await gateway.complete(context, call) ``` Die Funktion illustriert ausschließlich den unveränderten Gatewayaufruf; Auflösung, Claim, Ledger und Commitadapter sind verpflichtende vorgelagerte/interne Schritte. Sie ist kein eigenständig sicherer Router oder Ersatz für das vollständige Protokoll. ### 12.2 Checkpoint im bestehenden T3 Eine Lücke zwischen „Gateway erfolgreich“ und späterem Nodewrite würde die Wiederaufnahme unsicher machen. Deshalb wird die im Gateway schon vorgesehene **atomare Fachergebnisablage** hier als `WorkflowResultSink` konkretisiert. Öffentliche Signatur `ModelGateway.complete(context, call)` bleibt unverändert. Der vertrauenswürdige Purposeadapter findet den internen Sink anhand der persistierten Call-/Execution-/Nodebindung; kein Funktionscallback oder Sinkname aus dem HTTPbody. ```python from typing import Protocol from app.core.context import RequestContext, Tx from app.modules.ai.contracts import GatewayCall, ModelResult class WorkflowResultSink(Protocol): def commit_validated(self, tx: Tx, context: RequestContext, call: GatewayCall, result: ModelResult) -> str: """Return private output_ref; caller owns commit and ai_calls finish.""" ... ``` In derselben Gateway-T3-UoW: aktuelle Autorisierung, Quelle und Policy prüfen; gebundenen Dispatchfence gegen aktuelle Lease und Cancelzustand prüfen; validierten/rehydrierten JSONoutput in das konkrete DTO übernehmen; Output + `node=succeeded` + Edge-/Eventcheckpoint + Audit schreiben; `ai_calls=completed` und `result_ref` auf diese Outputzeile setzen. Gateway besitzt Commit; Sink und Repositories committen nicht. Ein Fehler oder verlorener Fence verhindert den gesamten Ergebniscommit. Gateway kann anschließend unter seinem engen technischen Vertrag bekannte Usage/Discardmetadaten abschließen; daraus folgt kein Nodeerfolg. Der Workflow stellt weder `ai_calls=completed` noch Quotenabrechnung eigenmächtig nach. Stürzt der Runner nach T3 vor Rückkehr des Awaits ab, liest der nächste Claim den bereits erfolgreichen Checkpoint. Existiert eine im Gateway gültig gespeicherte Antwort, ist kein zweiter Generate erforderlich. Runtime und Gateway müssen diese Integration durch Transaktions-/Crashprüfungen nachweisen; sie ist bislang K. ### 12.3 Nachfolgeknoten, Privacy und Quoten Nur freigegebene Felder erfolgreicher Vorgänger gelangen in den nächsten Prompt. Jedes übernimmt eine SourceBinding, z. B. `kind='workflow_output'`, `source_id=output_id`, `version=output_revision`, `selected_fields=(...)`; der Quellenadapter prüft Owner, Scope, Execution und ungelöschten Stand. Weder „bereits maskiert“ noch „kam vom Modell“ ist eine Egressfreigabe: nächste Analysisnode durchläuft mit eigener Call-ID die vollständige Privacy-/Providerpipeline neu. Der Runner behandelt modellgenerierte Routing-/Textwerte nicht als Autorität für persönliche Datenzugriffe. Ein Klassifizierungssignal kann einen erlaubten Fachzweig auswählen, aber kein verborgenes Profil, eine neue Quelle oder ein neues Providerprofil hinzufügen. Detektion, Reviewcoverage, Maskierungstoken und Rehydrierung bleiben Eigentum des Gateways; keine Workflow-Pseudonymtabelle. Laufweite Grenzen zählen alle vorgesehenen/beanspruchten Analysisnodes, auch einen später `unknown` gewordenen Call. Zusätzlich nutzt **jeder** Call den `UsageBudgetPort` des Gateway-Blueprints für Reserve, tatsächliche Usage, `release_unsent` oder `mark_unknown`. Keine zweite Abrechnung am Endknoten; keine Rückerstattung allein wegen Cancel oder Workflowfehler. Harte konsum-/kostenabhängige Grenzen bleiben ohne wirksamen Adapter geschlossen. Der spätere Entitlements-/Usage-/Quota-Blueprint konkretisiert dies; hier entsteht kein Billingmodell und kein familienweiter Verbrauchsdienst. ## 13. API, Fehler und Frontend Fachprodukte können ihre eigenen Ausführungsrouten verwenden; folgendes ist der konkrete gemeinsame APIdefault. Alle schreibenden Browserrouten nutzen HttpOnly-/Secure-/SameSite-Session, CSRF/Origin und verifizierte Scopeauswahl aus Phase 3.3. Persönliche Responses und Fehler `Cache-Control: no-store`. IDs sind opaque; `expected_version` ist die fachliche/CAS-Version, keine Templateversionvermutung. | Endpoint unter `/api/v1` | Input / Erfolg | Bedingungen | |---|---|---| | `GET /prompts/placeholders` | Gefilterte Metadaten `{items,next_cursor}` | Keine persönlichen Werte, internen Callables oder Quelltabellendetails für normale Nutzer | | `POST /prompts`, `PATCH /prompts/{id}` | Strenges Draft-DTO; bei PATCH `expected_version`; 201/200 | Bearbeitungsrecht im Definitionsscope; kein frei gewählter Owner | | `POST /prompts/{id}/validate` | Draftversion; 200 mit sicheren strukturierten Diagnosen | Nur statische Prüfung, kein Modellcall; keine resolverinternen Tracebacks | | `POST /prompts/{id}/publish`, `/activate` | Erwartete Draft-/Pointerversion und bekannte Revision; 201/200 | Publish-/Aktivierungsrecht, aktuelles nötiges MFA; Audit | | entsprechende `/workflows`-Routen | Strenges Graph-Draft-/Versions-DTO | Derselbe Verwaltungsvertrag; Konflikte bleiben 409 | | `POST /prompts/{id}/preview` | Konkrete Revision, benannte fachliche Inputs; 200 | Lokales autorisiertes Rendering; keine Provideranfrage, separate `prompt.preview_values`-Berechtigung | | `POST /workflow-executions` | `workflow_id`, optional konkrete veröffentlichte `revision`, registriertes Fachinput-DTO; `Idempotency-Key`; 202 + `Location` | Aktive Revision einmalig serverseitig auflösen; Start nach Commit | | `GET /workflow-executions/{id}` | Status, `version`, sichere Nodezustände, Progress-/Resultref; 200 | Aktueller Owner-/Scope-/Objektzugriff; keine Inputs oder Rohfehler | | `GET /workflow-executions/{id}/result` | Konkretes validiertes Ausgabe-DTO; 200 | Aktueller Ergebnis-/Quellenzugriff, verfügbarer Output; keine automatische Neugenerierung | | `POST /workflow-executions/{id}/cancel` | `expected_version`; 200 aktueller Status | Idempotent gemäß Abschnitt 10; kein Scopewechsel | | `POST /workflow-executions/{id}/resume` | `expected_version`; 202/200 | Nur unterstützte Pauseursache und exakte Bindung; neue aktuelle Humansession des gleichen Subjects | Einzelpromptausführung kann intern als begrenzter `start -> analysis -> end`-Plan mit denselben Call-/Resultatverträgen laufen. Der Benutzer braucht dafür weder einen Workfloweditor noch einen allgemeinen Graphbody. Ein zusätzliches öffentliches Universalendpoint `execute arbitrary graph/variables/model` ist ausgeschlossen. Ein Startresponse enthält nur `{id,status,version}` und Links/Refs nach dem Foundation-DTOvertrag. Node-/Outputendpoints verwenden explizite Whitelists; kein `model_dump()` des gesamten internen Executionobjekts. Previewvolltext darf ausschließlich als private no-store-Response an den berechtigten Benutzer gehen, nie als Audit-/Progresswert. Preview bindet nichts für einen späteren Produktionscall; dieser materialisiert und prüft neu. | HTTP / sicherer Code | Verhalten | |---|---| | 401 `session_required/session_expired` | Aktueller Browserrequest ohne gültige Session; Runner pausiert/stoppt separat | | 403 `capability_required/mfa_required` | Identität bekannt, eigene Aktion unzulässig; kein Modellcall | | 404 `not_found` | Fremde/unsichtbare Definition, Execution, Quelle oder Output; Existenz nicht offenlegen | | 409 `version_conflict/execution_conflict/execution_in_progress` | Versions-/Idempotenzkonflikt; kein automatischer POSTretry | | 409 `context_changed/resume_not_allowed/call_outcome_unknown/result_unavailable` | Bindung nicht fortsetzbar bzw. bereits versendete Wirkung ungeklärt | | 409 `privacy_review_required` | Nur exakte vorhandene lokale Reviewintegration; kein Browserflag als Freigabe | | 422 `definition_invalid/placeholder_unknown/input_invalid/input_unavailable/graph_limit` | Sichere feldbezogene Diagnose; keine Eingabewerte/Providerinhalte im Problemobjekt | | 429 `execution_capacity` | Begrenzt angenommene Queue; sicherer Retryhinweis, kein autonomer Startretry | | 502/503/504 gemäß Gateway | Technischer Provider-/Output-/Abhängigkeits-/Deadlinefehler; mögliche Wirkung separat vermerken | Asynchron auftretende Fehler ändern den gespeicherten Laufstatus; ein `GET` liefert 200 mit sicherem Zustands-/Reasoncode, solange dieses Objekt sichtbar ist. Fehler vor Auftragsannahme nutzen RFC-9457-`application/problem+json` mit Foundationfeldern und `request_id`. Keine SQL-, Regex-, Pfad-, Prompt-, Pydanticinput- oder Providerfehlermeldung ungefiltert durchreichen. Frontenddefault: Statuspolling während sichtbarer Ausführung; optional später sichere SSE-Statusereignisse aus dem persistierten Eventbestand. Nie rohe Modellstreamdeltas. APIclient verwendet den vorhandenen Session-/Scope-Store mit Epoch und Abort: nach Scopewechsel alte Responses, Fortschritte, 401 und Fehler verwerfen; laufende Backendexecution bleibt an ihrem ursprünglichen Scope. Ergebnisanzeige prüft erneut Zugriff. Keine Tokens/Prompts in LocalStorage, ServiceWorker-/PWAcache oder URLparametern. Wiederaufnahme und eine bewusst neue kostenpflichtige Ausführung sind getrennte Nutzeraktionen. ## 14. Wichtige Anti-Patterns - Registryeinträge und `PLACEHOLDER_MAP` parallel pflegen; Export-/GUI-Metadaten unabhängig erfinden; eine neue Metrik außerhalb des Registrierungslayers verstecken. - Alle Profilwerte vorab laden und später „nur das Nötige verwenden“; globale mutable Profilheader; `first profile`, `MIN(club_id)` oder Scopefallback bei Fehlern. - Platzhalter unaufgelöst weiterreichen, Resolverfehler in `"n/a"` umwandeln, `0`, `false`, `null`, leer und fehlend vermischen oder eingesetzten Inhalt erneut als Template interpretieren. - Slug/`latest`, Zeitfenster oder aktive Registry mitten im Lauf neu auflösen; veröffentlichte Definition in-place ändern; unbekannte Handler-/Schematypen tolerieren. - Beliebiges Jinja/Python/SQL/HTTP in Nodes; vom Modell gewählte Toolnamen; `unknown` als `false`; `best_effort` über Autorisierungs-/Privacyfehler. - BFS-Besuchsstatus mit Abhängigkeitsbereitschaft verwechseln; Join vor Entscheidung seiner Eingänge ausführen; Signalnamen unqualifiziert überschreiben. - In-Memory-Queue oder Browser-SSE als dauerhaften Ausführungsnachweis verwenden; nach Neustart alle `running`-Nodes mit neuen Call-IDs starten. - Erfolgreichen Gatewaycall zuerst abschließen und Ergebnischeckpoint später separat committen; eine Lease als Exactly-once-Beweis behandeln. - Automatischer Modellretry, Reparaturcall, Fallbackprovider oder Replay bei Timeout/Cancel/`unknown`; ungeklärte Calls durch Cleanup vergessen. - Abgelaufene Nutzersession durch eine pauschale Serviceidentität ersetzen; Runnerheartbeat als Nutzeraktivität buchen; Operator übernimmt fremde Privatläufe. - Gerenderte Prompts, Signalsätze, Rohantworten oder persönliche Resolverwerte in normale Logs, Fehlerdetails, Profiler, Telemetrie oder Debugpanels schreiben. ## 15. Technische Ausgangswerte Alle Zahlen sind **Defaults**, zusätzlich zu unverändert geltenden Gateway-/Foundationgrenzen. Der jeweils engere Grenzwert gilt. Anpassungen müssen die zugehörigen Speicher-, Deadline-, Queue- und Negativtests mitführen. | Parameter | Default / Bedeutung | |---|---| | Graph | maximal 32 Nodes, 64 Edges, 10 Analysisnodes; keine Schleifen/Subworkflows | | Logik | maximale Tiefe 8, maximal 64 Ausdruckselemente; endliche Spektren bis 32 Werte | | Platzhalter | maximal 128 verschiedene Bindungen pro Ausführung; nur tatsächlich verwendete Werte materialisieren | | Definitions-/Privatdaten | Graphpaket maximal 128 KiB UTF-8; Snapshot maximal 256 KiB; gespeicherte Outputs insgesamt maximal 256 KiB je Lauf | | Gatewayinput | Weiterhin 64 KiB gemäß Gateway; keine Workflowerhöhung dieses Limits, auch wenn Snapshot größer ist | | Laufzeit | maximal 15 Minuten kumulierte aktive Laufzeit; absolute Ausführungsexpiry 24 Stunden ab Start; Ablauf vor neuem Dispatch prüfen | | Einzelnode | Gatewaydeadline weiterhin 90 Sekunden; lokale reine Node maximal 2 Sekunden, Materialisierung durch DB-Statement-/Transaktionsgrenzen begrenzt | | Runner | 1 aktive Execution, sequenzielle Nodes; Queue maximal 16 angenommene wartende Läufe pro Produktinstanz und 2 pro Subject/Scope; Aufnahme transaktional gegen Überschreitung schützen | | Lease | 30 Sekunden, Heartbeat alle 10 Sekunden; Heartbeat im Modellawait unabhängig fortführen; bei Verlust kein neuer Write/Dispatch | | Polling | Runner 1 Sekunde ohne Busyloop, Frontend 2 Sekunden nur bei sichtbarem Lauf; Backoff bei technischen Fehlern | | Nodecheckpoint | Nach jeder Node und jeder Skip-/Routingentscheidung; kein Intervallverlust zugunsten von Performance | | Retention | Private Inhalte 7 Tage nach terminalem Abschluss; pausierte Läufe höchstens bis absoluter Expiry; Minimalledger gemäß Gatewayvertrag | | Ausgabemodus | Gepufferter validierter Text/JSON, keine Rohstreamausgabe; Render-/Graphpreview lokal ohne Provider | Die reine Nodefrist ist kein nachträglicher Timeout um unkontrollierten Pythoncode: zugelassene Handler müssen nach Inputgröße und Algorithmus begrenzt sein, ohne ungebundene Regex-/Rekursionskosten. Fehlt dieser Nachweis, nicht registrieren. Die kumulierte Laufzeit wird an Checkpoints und Heartbeats konservativ fortgeschrieben; nach Crash zählt der beanspruchte Zeitraum, statt das Budget zurückzusetzen. Eine Pause setzt weder Callanzahl noch Deadline zurück. ## 16. Automatisierte Sicherheits- und Negativtests Die folgende Matrix ist ein verbindlicher **Testauftrag V/K**, kein Bericht bestandener Tests. Cursor implementiert die Prüfungen mit synthetischen Daten und deterministischen Fakes. Mindestens zwei Subjects mit persönlichen Räumen, zwei Clubs mit unterschiedlichen Mitgliedschaften, ein Operator ohne private Leserechte, zwei Sessions/Generationen, zwei Workerfences und eine kontrollierte Uhr. Keine produktiven Daten oder echten Providercalls. | ID | Prüfung | Erwartung | |---|---|---| | PW-01 | Doppelte Placeholder-/Handler-ID, unbekannter Resolver-/ResultSpec-Typ | Betroffenes Modul/Publish geschlossen; kein stilles Überschreiben | | PW-02 | Picker, Validator, Renderer und Export für denselben Key | Gleiche Revision/Metadaten; kein separater Parallelkatalog | | PW-03 | Unbekannter Key, Modifier, kaputte Tokenklammer oder überschrittene Grenze | Statischer Fehler; Providerfake zählt null Sends | | PW-04 | `d`, `x`, `d,x`; `x` ohne benötigten Messwert | Exakte Mitaisemantik; reines `x` löst keine persönlichen Werte auf | | PW-05 | `0`, `false`, erlaubtes JSON-null, leerer Wert vs. missing | Werte bleiben typgetreu; nur echte Fehlwerte lösen Missingpolicy aus | | PW-06 | Resolverexception, SQLfehler oder verweigerte Quelle bei optionalem Binding | Abbruch mit sicherem Code; keine Umwandlung in missing/Leertext | | PW-07 | Nutzerdaten enthalten `{{secret}}`, Templatekonstrukte und HTML | Einmaliges Ersetzen, keine zweite Auflösung/Codeausführung; sichere Darstellung | | PW-08 | Versuchte `profile_id`-/Owner-/Scope-/Variableninjektion | DTO verweigert oder Auflösung ignoriert Autoritätsanspruch; kein Fremdzugriff | | PW-09 | Aggregat ändert sich durch Insert/Delete bei gleichem `max(updated_at)` | Verlässlicher Quellenrevisionsadapter erkennt Konflikt; kein Dispatch | | PW-10 | Mehrere Quellabfragen bei konkurrierendem Write | Konsistenter Snapshot oder klarer Konflikt; keine Mischversion | | PW-11 | Doppelte Node-/Edge-ID, dangling Edge, Zyklus, unerreichbare Node, kein Endpfad | Publish verweigert, keine aus Dictüberschreibung abgeleitete Gültigkeit | | PW-12 | Falsche Ports/Knotenfelder, mehrere Enden, Mehrfacheingang ohne Join | Striktes Schema/Compiler verweigert; Importadapter meldet inkompatibel | | PW-13 | Erforderliche Referenz auf nur bedingt verfügbaren/vorwärtsliegenden Output | Dominanz-/Abhängigkeitsprüfung verweigert; optionaler Vertrag explizit nötig | | PW-14 | Gleicher Graph mit geänderter Arrayreihenfolge und mehreren bereiten Pfaden | Gleiche kanonische Reihenfolge/Routing-/Joinergebnisse | | PW-15 | Nicht aktiver Branch mit nachfolgendem Join | Persistenter Skip und entschiedene Kanten; keine vorzeitige BFS-Ausführung | | PW-16 | Normalisierung exakter/Synonym-/mehrdeutiger Werte, falsche Typen | Nur eindeutige registrierte Normalisierung; unsicher bleibt unknown; bool nicht Zahl | | PW-17 | Dreiwertlogik inkl. NOT/AND/OR und fehlender uncertain-Kante | Definierte Wahrheitstabelle; Pause statt stiller Elsepfad | | PW-18 | wait_all, wait_any, best_effort, alle Pfade inaktiv, min_paths | Dokumentierte Coverage; kein leeres completed oder zufälliger Sieger | | PW-19 | Optionaler Fachfehler gegenüber Auth-/Privacy-/Unknownfehler im Join | Nur publizierter Fachfehler auslassbar; Sicherheits-/Unknownfall stoppt | | PW-20 | Aktivierung neuer Prompt-/Workflowrevision während laufender Execution | Alter Lauf bleibt vollständig gebunden, neuer Start nimmt neue Revision | | PW-21 | In-place-Änderung/Revisionslöschung oder unbekannte Compiler-/Handlerrevision | DB-/Servicevertrag verhindert Änderung bzw. blockiert Ausführung | | PW-22 | Gleicher Startkey gleichzeitig, gleicher/anderer Input, aktiver Pointerwechsel | Genau eine Execution; Wiederabruf oder 409; keine neue Bindung für bestehenden Key | | PW-23 | Fremdes Subject/Club versucht Status, Preview, Output, Cancel, Resume | 404/403 nach Vertrag; keine Existenz-/Wert-/Progresslecks | | PW-24 | Operator mit Publishrecht liest private Execution ohne Fachrecht | Verweigert; MFA/Betreiberstatus erteilt kein Privatrecht | | PW-25 | Sessionexpiry/Rotation während Queue/Nodeawait; frischer gleicher Owner resumiert | paused_auth, legitimer Rebind ohne neue Call-ID und ohne verlängerte Sessionaktivität | | PW-26 | Logout, Disable, Membership-/Capabilityentzug während Ausführung | Kein nächster Dispatch; T3/Lesen verweigert; keine automatische Wiederbelebung | | PW-27 | Zwei Worker claimen denselben Lauf, Heartbeatverlust, alter Fence schreibt | Ein gültiger Claim; alter CAS/Checkpoint zurückgewiesen | | PW-28 | Alter Dispatchpermit und neuer Claim konkurrieren | Ledger-CAS verhindert zweiten Send; verbleibende Netzwerkgrenze sichtbar | | PW-29 | Crash nach Startcommit, nach Call-ID, vor Dispatchintent | Wiederaufnahme derselben Execution/Node/Call-ID; bislang unversendete Arbeit darf fortfahren | | PW-30 | Crash nach Dispatchintent, nach Send oder vor T3commit | paused_unknown, exakt kein automatischer zweiter Modellsend | | PW-31 | Crash nach T3commit vor Gatewayrückgabe | Resultref und Nodecheckpoint gemeinsam vorhanden; kein erneuter Send | | PW-32 | Output-, Edge-, Event-, Ledger- oder Auditwrite schlägt in T3 fehl | Gesamter Ergebniscommit rollt zurück; kein falscher Node-/Lauferfolg | | PW-33 | Cancel vor T2, direkt danach und nach Antwort vor T3 | Vor T2 kein Send; danach möglicher Verbrauch, aber keine freigegebene verspätete Ausgabe | | PW-34 | Ungültiges JSON, fremde Felder, unerlaubte Signale, Refusal | Gateway-/ResultSpecfehler, kein reparierender Modellcall | | PW-35 | Klartextname/Token/Injection aus Vorgängerausgabe wird Input nächster Node | Vollständiger neuer Gatewaydurchlauf; keine Umgehung über „bereits geprüft“ | | PW-36 | Ergebnis nur in RAM oder durch Retention gelöscht | result_unavailable, kein versteckter Generate beim GET/Resume | | PW-37 | Callbudget, Queue-, Byte-, Logik-, Zeitlimit und wiederholte Resumeversuche | Grenzen auch nach Crash/Pause wirksam; engeres Gatewaylimit bleibt bestehen | | PW-38 | Unknown/Cancel und Usageadapter | Keine unberechtigte Freigabe von Reservierung; mark_unknown statt Nullverbrauch | | PW-39 | Quellen-/Policyänderung zwischen Rendering, T2 und T3 | Bindung erneut geprüft; kein stilles Rebase oder alter Privacy-Bypass | | PW-40 | Logs, Fehler, Event-/Status-DTO, Telemetrie mit eindeutigen Canarywerten | Keine privaten Input-/Prompt-/Output-/Cookie-/Keywerte enthalten | | PW-41 | Scopewechsel im Frontend bei verspätetem Erfolg/401/Fehler | Alte Epoch komplett verworfen; kein Fremdraumresultat/ungewollter Logout | | PW-42 | Missing CSRF/Origin, fremde Sessiongeneration, ungeprüfter Principal-IDadapter | Geschlossene Browser-/interne Grenze; kein Start/Resume/Providercall | | PW-43 | Restore mit alten Sessions, Leases und dispatching-Calls | Sessioninvalidierung; kein automatisches Aufwecken/Replay; Kontext neu autorisieren | | PW-44 | Cleanup eines ungeklärten/referenzierten Calls und verlorener HMAC-Key | Minimalbindung bleibt gesperrt; keine neue freie Ausführung | | PW-45 | API-/Runnerimport ohne DB-/Providerverfügbarkeit | Keine Importnebenwirkung; getrennt kontrollierte Readiness bleibt geschlossen | DB-Konkurrenz-, Fence-, Snapshot-, FK-, Idempotenz- und Rollbackprüfungen laufen später gegen isoliertes echtes PostgreSQL mit dem Foundationtreiber; SQLite oder alleinige In-Memory-Fakes reichen dafür nicht. Netzwerkadapter als Fake mit sichtbaren Sendzählern und präzisen Crashbarrieren; Transportunsicherheit realistisch simulieren, keine echten Tokens/Providerzugänge. Frontendtests kontrollieren Scopeepoch und Cacheverhalten. Testberichte benennen Fall-IDs, Revision, Umgebung und Ergebnis; übersprungene Tests belegen keine Konformität. Vorhandene Testquellen I dienen als Startpunkt: Mitai [Graphvalidierung](C:/Dev/mitai-jinkendo/tests/backend/test_workflow_engine.py:86), [Executor/Aggregation](C:/Dev/mitai-jinkendo/tests/backend/test_phase2_workflow_executor.py:14), [Branching/Fallback](C:/Dev/mitai-jinkendo/tests/backend/test_phase3_workflow_branching.py:40), [Modifier](C:/Dev/mitai-jinkendo/backend/tests/test_placeholder_modifier_d.py:13) und [Metadatentypen/Herkunft](C:/Dev/mitai-jinkendo/backend/tests/test_placeholder_metadata_v2.py:29). Vor Übernahme tatsächliche Assertions und Fixtureabhängigkeiten prüfen. Namen/Existenz belegen weder die neue Semantik noch einen bestandenen Lauf; in dieser Lieferung werden sie nicht ausgeführt. ## 17. Implementierungsanweisung für Cursor Der spätere Auftrag benennt ein Zielprodukt und dessen benötigten ersten Fachfall. Die folgenden Schritte bilden die vollständige Reihenfolge, ohne jetzt Produktänderungen zu beauftragen: 1. **Verträge anschließen.** Foundation v0.3, Phase-3.3-Auth und KI-Gatewayports prüfen; konkrete lokale Account-/Scope-/Quellen-IDtypen verwenden. Benötigte Module explizit registrieren. Bei fehlendem Auth-/Quellen-/Privacyadapter geschlossen bleiben; kein Dev-Bypass und keine Ersatz-Serviceidentität. 2. **Mitai-Kern adaptieren.** Registry-/Metadatenvertrag, Tokenmodifier, Graphprüfung, Signale und deklarative Logik aus den benannten Quellen isoliert portieren. Legacycallback, Debugvolltexte, permissive Typen und In-Memory-Dauerzustand gezielt ersetzen. Keine parallele neue Promptengine neben dem adaptierten Kern. 3. **Reine Definitionsebene bauen.** Strikte diskriminierte Node-DTOs, immutable Revisionen, Compiler/Tokenplan, Referenz-/Dominanz-/Größenprüfung und eingefrorene Registries. Zuerst PW-01 bis PW-07 sowie PW-11 bis PW-21 mit synthetischen Inputs prüfen. 4. **Lokale Persistenz ergänzen.** Explizite SQLmigrationen und scoped Repositories für die wirklich benötigten Tabellen; Definitions-FKs, Node-/Edgezustände, Idempotenz, HMAC-Keybindung, CAS/Fence und Audit. Migrationen nur im isolierten Qualifikationssystem ausführen. Kein Produkt-DBzugriff aus diesem Blueprintauftrag. 5. **Einen Fachresolver integrieren.** Bestehenden Data Layer und berechtigten Profil-/Clubbezug verwenden; nur benötigte Felder; belastbare SourceBindings auch für Aggregatänderungen. Snapshot-/Missing-/Typ-/Fremdzugriffstests vor echten Modellaufrufen fertigstellen. 6. **Ausführung ohne Provider qualifizieren.** Deterministischer sequenzieller Scheduler, Joins/Skip/Coverage, private Outputs, Start-/Cancel-/Resume-APIs; Runnerprozess aus demselben Image. DB- und Konkurrenzprüfungen mit kontrollierter Uhr und zwei Fences. 7. **Gateway atomar verbinden.** Ein Analysisnode über unverändertes `complete` und internen `WorkflowResultSink`; ResultSpec tatsächlich validieren. Stable IDs und T3checkpoint in derselben UoW. Crashbarrieren vor/nach Dispatch und Commit, null automatische Modellretries. Die ganze Kette zunächst mit Fakegateway/-transport prüfen. 8. **Auth, Privacy und UI nachweisen.** Sessionpause/Rebind, Widerruf, Quelle/Policyänderung, privater Preview, neue Privacyprüfung je Nachfolgenode, Scopeepoch, no-store, Logs und Löschung. Ungeklärte Ausführung bleibt sichtbar ungeklärt. Erst danach erlaubte zusätzliche Graphformen/Fachresolver ergänzen. 9. **Betrieb einbinden.** Runner als Writer in Drain/Shutdown/Restore behandeln: keine neuen Claims, aktuelle lokale Arbeit begrenzt beenden/abbrechen, Leases/Calls konservativ hinterlassen. Wiederhergestellte offene Läufe werden vor einem nächsten Dispatch unter aktueller Session-/Rechtebindung geprüft; alte Sessions/Claims dürfen nichts wiederbeleben. Beide ADR-11-Releasevarianten behalten Pflicht-Gates und menschliche Produktionsfreigabe. 10. **Nachweis abliefern und stoppen.** Betroffene Prüffälle, Source-/Buildversion, tatsächlich ausgeführte Ergebnisse und verbleibende K-Punkte dokumentieren. Keine Migration bestehender Anwendungen, kein Produktivrollout und kein familienweites Paket ohne eigenen konkreten Auftrag. Der nächste Entitlements-/Usage-/Quota-Blueprint wird hier nicht implementiert. Abnahme des ersten implementierten Fachfalls verlangt die End-to-End-Kette **gültige Session + Scope → konkrete immutable Definition → autorisierter Snapshot → einmaliges Rendering → Gateway → atomarer Nodecheckpoint → typisiertes Ergebnis**, einschließlich negativem Fremdzugriff, Widerruf, Cancel und Crash nach möglichem Versand. Ein erfolgreicher Demo-Prompt oder ein Unit-Test der Topologiesortierung genügt nicht. ## 18. Prüfstand dieser Lieferung Diese Lieferung enthält ausschließlich dieses Dokument. Es wurden gezielt die bereits registrierten Mechanismen gelesen; keine vollständige Repository-Neuanalyse, keine Änderungen an Produktrepositories, keine neuen ADRs und keine neue Produktreifebewertung. Es gab keine Provideranfragen, produktiven Datenbankzugriffe, Implementierung, Deploymentänderungen oder umfassenden Testläufe in Bestandsanwendungen. **T – mechanischer Dokumentcheck am 16.10.2026:** 41 lokale Dateiverweise einschließlich angegebener Zeilen auf Existenz/Gültigkeit geprüft; drei Pythonbeispiele erfolgreich als AST geparst; 45 eindeutige und lückenlos nummerierte Prüfspezifikationen erfasst; 22 Quellhashes gegen die Dateien geprüft. Alle 46 zur Kontrolle erfassten Bestandsdateien waren gegenüber dem vor Erstellung aufgenommenen Stand unverändert. Das Ergebnisverzeichnis enthält genau dieses eine Markdowndokument. Kein Pythonbeispiel wurde als Anwendung ausgeführt; insbesondere wurden die 45 Sicherheitsszenarien nicht implementiert oder ausgeführt. Die Quellhashes unten sind weder Test- noch Reifebeweis. ### 18.1 Lokaler Quellstand SHA-256 der gezielt verwendeten Implementierungs- und Testquellen. Pfade sind zusätzlich in Abschnitt 2/16 verlinkt; bestehende Testquellen wurden nicht ausgeführt. | Quelle relativ zu `C:/Dev` | SHA-256 | |---|---| | `mitai-jinkendo/backend/workflow_models.py` | `824d481c2b29a6f43edff4e04c675626b0a117621d929dc947fa269e3ad4840a` | | `mitai-jinkendo/backend/workflow_engine.py` | `482c2b6bb95928476b7db75966026e50b54518402e3daf1f846fd6fd3c910d18` | | `mitai-jinkendo/backend/workflow_executor.py` | `7877bbbfa2374910f97575d2817f59e9b6d3f8f58a7169692f84a8ca1fecec47` | | `mitai-jinkendo/backend/placeholder_registry.py` | `b554bf003ad9954ac60a4edaa728b7fa92e2bcb986efc51ec4a231cc3e76d021` | | `mitai-jinkendo/backend/placeholder_resolver.py` | `c87f7262819a1340380b75f6232d7bebbb2a0ae36809f2756b696a37a36e74ae` | | `mitai-jinkendo/backend/prompt_executor.py` | `7e0e97047fe16d7b5efb92ccbe573b6459c4d32b41931aa9e33d6f00f14028da` | | `mitai-jinkendo/backend/placeholder_registrations/_evidence.py` | `17e613a280befad298c0c87e5a1cf9be3134a00702e31bc4bdc3df7dca5dd387` | | `mitai-jinkendo/backend/placeholder_registrations/__init__.py` | `9887a72b65a110f91380e1a003d927704790202496cf6b7b469196154fae1c70` | | `mitai-jinkendo/backend/normalization_engine.py` | `5d112dd55557d0f7767a64be217c1511e97ea06921c4ab530d8c9d2f888cdece` | | `mitai-jinkendo/backend/logic_evaluator.py` | `bd7fc9cfb46d78a31d427ab7c274226f303b27015890eb9870e8f347d6ce5cf3` | | `mitai-jinkendo/backend/join_evaluator.py` | `36c085ae87cddd4334bb0b464257b771e7a0e6a9b94ceda465435ea112ed6081` | | `mitai-jinkendo/tests/backend/test_workflow_engine.py` | `7cc274960b5eeab351768eb823d9bbdf3e5c633d10f4f52f75a8aaf929db1ab5` | | `mitai-jinkendo/tests/backend/test_phase2_workflow_executor.py` | `6d4e82220350b7d0ae03da54dd16c93163272e5fdeea25ebdd1667fe0200d0fd` | | `mitai-jinkendo/tests/backend/test_phase3_workflow_branching.py` | `15be1726334cf45d6f6f26908b37477991b25a9e9ccd829fc05686837e02a46d` | | `mitai-jinkendo/backend/tests/test_placeholder_modifier_d.py` | `e26b1e4ce07ac4541ced6c3dc1b6cbec17502cd7f65d2451f5553bba48e5da84` | | `mitai-jinkendo/backend/tests/test_placeholder_metadata_v2.py` | `4a1ef9342f5ab18bfa42b3549b56fcaf8a7fc085554e3ded2761626500ebeb65` | | `mitai-jinkendo/.claude/docs/technical/PLACEHOLDER_REGISTRY_FRAMEWORK.md` | `aeee694cb0612ff44cc86d2133ce2883acdfaa9d6b8cffdaa101016c1b51ffa2` | | `mitai-jinkendo/.claude/docs/audit/platzhalter/PLACEHOLDER_METADATA_REQUIREMENTS_V2_NORMATIVE.md` | `6cd5f2963e9dc92ecd07cedaf9c6b2bb01fc55c6260475c3c0c3f4f6e9e5c8f0` | | `shinkan-jinkendo/backend/ai_prompt_job.py` | `64a11272e814ad4372e709d91057af423b668a94f152b5d88f772ea58cc1d9ab` | | `shinkan-jinkendo/backend/ai_prompt_context.py` | `04bcfd13cef2c04b2d3e3bbc0275cc86ca7584490e8c00cb93c21ceb9f7bb79d` | | `shinkan-jinkendo/backend/ai_prompt_runtime.py` | `b1154e2bf30feb25ee9b9d743c98d946f943542a63fe58a7d6748d43be09d24d` | | `kairo-jinkendo/backend/prompt_validation.py` | `359379291badc51b67bd85124b905540ecb332f2fd4c93036da455dbe14662a8` |