80 KiB
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, Foundation B v0.3 und Entscheidungen C v0.3.
- Auth, Session & Scope, Release, Betrieb & Recovery und KI-Gateway, Providerzugriff & Privacy.
- Phase-3.1-Wissenselemente, insbesondere KI-MIT-08/09/10/11, KI-SHK-07 und ergänzend KI-KAI-11; Quellenregister, Testregister und Guardrailregister.
- Beschlossene ADR-01 bis ADR-14 aus dem Entscheidungsregister. 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, 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
- 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.
- 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. - Kurze Transaktion: Accessprüfung und autorisierte SELECTs auf demselben
tx; gemeinsamer Snapshot für mehrere Abfragen über gezielt gesetztesREPEATABLE READ. Bei Aggregaten bindet der Adapter einen in derselben Transaktion gepflegten Datenraum-/Quellenrevisionszähler, der auch Inserts und Deletes erfasst. Einmax(updated_at)oder alleinige Zeilenzahl ist kein belastbarer Versionsnachweis. Fehlt ein verlässlicher Versionsadapter, startet der entsprechende Resolver nicht. - Werte streng gegen ihre Specs prüfen, Snapshot mit konkretem UTC-
as_of, festen Zeitfenstergrenzen undSourceBindingspeichern. Flüchtige Angaben wie „heute“ werden hier gebunden; Wiederaufnahme berechnet sie nicht neu. Einzelne Berechtigungsfehler, defekte Berechnungen oder fehlende Registryeinträge brechen ab. - 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. - 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_MAPparallel 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;
unknownalsfalse;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:
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- Gateway atomar verbinden. Ein Analysisnode über unverändertes
completeund internenWorkflowResultSink; 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. - 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.
- 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.
- 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 |