Files
tsumugu/docs/reference/Jinkendo_Prompt_Placeholder_Workflow_Blueprint.md
T
LarsandCursor d6b70d8f92
Deploy Development / deploy (push) Successful in 28s
Test Suite / pytest-backend (push) Failing after 2m18s
Test Suite / smoke-dev (push) Successful in 0s
Test Suite / frontend-build (push) Successful in 10s
Schließe die Connector-Kapselung ab, damit Paperless, IMAP und weitere Quellen über dieselbe Anbindung laufen.
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-19 15:00:50 +02:00

80 KiB
Raw Blame History

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:

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, Graphprüfung, Reihenfolge, 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, Analysis, Joins 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, Duplikatsperre, Registrierungen, 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, Resolver, Modifier-Tests {{key}}, `{{key d}}, {{key
Mitai Normalisierung, Logik, Joinprüfung 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, Framework, Evidencehelper 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, Debugwerte, 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, Kontextmodell, Laufzeit, 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, 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 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

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.

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.

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.

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, Executor/Aggregation, Branching/Fallback, Modifier und Metadatentypen/Herkunft. 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