Files
tsumugu/docs/reference/Jinkendo_AI_Gateway_Provider_Privacy_Blueprint.md
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

75 KiB
Raw Permalink Blame History

Jinkendo – KI-Gateway, Providerzugriff & Privacy Blueprint

v0.1 · 16.10.2026 · Spezial-Blueprint 2 nach Phase 3.3 · technischer Entwurf, keine Implementierung

1. Geltung und Nachweis

Dieser Blueprint beschreibt den produktlokalen Übergang von autorisiertem Anwendungskontext zu einem KI-Modell und zurück. Er konkretisiert Providerrollen, Datenminimierung, vollständige Egressprüfung, Maskierung, Transport, Antwortvalidierung und Fehlerbehandlung. Primäres Vorbild ist Kanshōs Privacy Gateway. Mitais Prompt-/Platzhalter-/Workflow-System bleibt die primäre vorgelagerte Laufzeit; dessen eigener Spezial-Blueprint folgt gesondert.

Grundlage sind Referenzarchitektur A v0.3, Foundation B v0.3, Entscheidungen C v0.3, Auth-/Session-/Scope-Blueprint und Release-/Betrieb-/Recovery-Blueprint.

Beschlossene ADRs bleiben maßgeblich, besonders ADR-02/04/09/10/12/13/14. ADR-09 erlaubt produktbezogen lokale Verarbeitung oder autorisierte minimierte Weitergabe an geeignete Anbieter. Er erteilt keine pauschale Providerfreigabe und schwächt Kanshōs eigene Privacy-Invarianten nicht ab. Dieser Blueprint trifft keine neue rechtliche Bewertung und aktiviert keinen Anbieter.

Nachweis: V = vorgeschlagene technische Ausgestaltung; I = vorhandene statisch nachgelesene Implementierungsreferenz; T = tatsächlich bestandener Test mit Stand, Umfang und Umgebung; K = noch nicht integrierte/getestete Kombination. Dieses Dokument samt Code-/Payloadbeispielen ist V/K. Produktquellen und Testassertionen sind I; es wurden keine Anwendungstests oder Modellaufrufe ausgeführt. Keine Produktionsreife und keine vollständige semantische Erkennung werden behauptet.

Es entstehen keine gemeinsame KI-Plattform, zentrale Tenant-Datenbank, SSO-, Billing- oder Worker-Infrastruktur. Bestehende Anwendungen bleiben unverändert. Die tatsächliche spätere Umsetzung betrifft nur ein ausdrücklich benanntes Zielrepository.

1.1 Verträge und Defaults

Verbindlicher Vertrag Bevorzugter technischer Default
Nur aktuell autorisierte Daten aus dem expliziten Scope, für registrierten Zweck Produktlokaler ModelGateway; pro Anfrage materialisierter unveränderlicher Kontext
Class-A-/Local-only-Inhalte verlassen ihre erlaubte Vertrauenszone nicht Externe Generate-Aufrufe mit Klasse A verweigern; B minimieren/maskieren; C kontrolliert generisch
Persönlicher Egress durchläuft die vollständige Pipeline; kein Direktaufruf oder Ausfallbypass Kanshō-Manifest, lokale semantische Detection, bestätigte Registry und Prüfung des endgültigen Payloads
Detect, Generate und Tools sind getrennte Empfänger-/Zweckverträge Lokaler explizit registrierter Detect-Endpunkt; externer Generate-Adapter nur bei geeigneter Route
Kein ungeprüftes Downgrade, kein Export lokaler Mappings oder Sessiondaten Kein automatischer Modell-/Providerfallback, kein Remote-Klartext-Detect im neuen Standard
Anbieterfähigkeit wird belegt und technisch erzwungen, nicht aus einem Boolean geraten Versionierte Providerprofile und Policybelege; OpenRouter als vorhandener Adapterkandidat
Kein Netzaufruf in offener Fachtransaktion; Audit und fachlicher Ergebniswrite atomar Drei kurze DB-Phasen um lokale Verarbeitung/HTTP herum
Antwort bleibt untrusted; keine selbstständigen Tools/DBwrites Vollständig gepufferte Text-/JSONantwort; lokale Validierung und Rehydration
Ressourcen und Mehrfachausführung begrenzt; unbekannte Kosten nicht null Ein Generate-Versuch pro Call; persistente lokale Call-ID/Idempotenz; Verbrauchsport für nächsten Blueprint

Timeouts, Größen, Dateinamen, Transportadapter und Chunkgrößen sind begründet anpassbare Defaults. Datenraum-/Privacy-/Releaseverträge bleiben bestehen. Eine begründete lokale Anpassung mit passenden Tests erfordert keinen neuen ADR oder zusätzlichen allgemeinen Freigabezyklus.

2. Vorhandene Mechanismen und gezielte Anpassung

Ausgangspunkt sind Phase-3.1-Wissenselemente, Quellen, Tests und Kanshōs führende Guardrails. Nachgelesen wurden gezielt die relevanten Funktionen; keine neue Gesamtanalyse der Repositories.

Referenz I Wiederverwenden Erforderliche Zielanpassung V/K
Kanshō KI-KAN-09: Gateway, Maskierung, Pre-Egress-Gate Reihenfolge vor Modellaufruf, requestbezogenes Manifest, spanbasierte Ersetzungen und lokale Rückübersetzung Alle tatsächlich versandten Nachrichten/Felder erfassen; keine nachträglichen ungescannten Ergänzungen; Snapshot-/Payloadbindung für vorab geprüfte Mappings
Kanshō: Manifesttypen, Antwortprüfung Aktive Ersetzungen, Alias-/Oberflächenformtrennung und interne Prüffassung Mappings nur im lokalen Callkontext; ausschließlich tatsächlich ausgegebene/aktive Tokens rehydrieren, keine fremden/inaktiven Tokens nachschlagen
Kanshō KI-KAN-10: Providerrollen, Transport, Profilprüfung Getrennte Detect-/Generate-Konfiguration, kleiner HTTP-Adapter, Usage/Finishreason Keine pauschale Vertrauensannahme für private IPs/.local; keine ZDR-Zusage aus lokalem Default; exakte Endpunkt-/Routenprüfung; keine Providerfehlertexte an Clients
Kanshō KI-KAN-11: Kontextaufbau, Budgetprüfung Zweckbezogene Materialisierung und explizite Größen-/Kontextgrenze Zugriffs- und Quellenrevisionen binden; Zeichenschätzung nicht als exakten Tokenizer oder Privacybeweis behandeln
Mitai KI-MIT-09/10: Promptausführung, Modellcallback Übergabepunkt nach vollständiger Platzhalterauflösung/Frageergänzung Callback ruft ausschließlich Gateway auf; keine direkte Providerclosure, aufgelösten Werte/Promptvolltexte nicht automatisch debuggen; JSONschema tatsächlich validieren statt nur JSON parsen
Shinkan KI-SHK-08: REST-Client, Textblöcke Kleiner Adapter statt zusätzlichem Agentenframework; bekannte Textvarianten Refusal/Tool-/Reasoningblöcke unterscheiden; unbekannte Formen verweigern; keine Raw-HTTP-/Providerfehlerschnipsel weiterreichen
Kairo KI-KAI-14: Secretreferenzprüfung Konfiguration ohne rohe Secretwerte Produktlokaler Providerprofiladapter, keine eigene zweite Connection innerhalb der Fach-UoW übernehmen

Kanshō dokumentiert ausdrücklich, dass technische Detectionabdeckung keine semantische Vollständigkeitsgarantie ist und neue unbekannte Identitäten ungelöste Fälle erzeugen können. Guardrails 22.2. Bestehende Remote-Detect-/Lernmodusübergänge sind produktlokal dokumentierte Ausnahmen; der neue Standard übernimmt sie nicht automatisch. Er ändert sie im Bestand auch nicht. Kein KANSHO_ALLOW_REMOTE_DETECT- oder Fake-Provider-Runtimeflag wird als allgemeiner Familienmechanismus eingeführt.

3. Komponenten und Schnitt zur Prompt-/Workflow-Laufzeit

Fachroute → Fachservice / ContextMaterializer → Prompt-/Workflow-Renderer
  → ModelGateway
      → PurposePolicy / aktuelle Accessprüfung
      → vollständige Textinventur / Minimierung / Detect / Registry
      → MaskingManifest / finale Payloadprüfung / DispatchPermit
      → genau ein registrierter ProviderTransport
      → Envelope-/Inhalts-/Schema-/Privacyprüfung / lokale Rehydration
  → frische Autorisierung / Fachservice-Ergebniswrite oder sichere Ausgabe
Baustein Aufgabe
modules/ai_gateway/service.py Gesamtablauf und Phasensteuerung; keine Prompt-DB-/Workflowengine neu entwickeln
contracts.py, policies.py Typisierte Calls/Ergebnisse, Zweck-/Datenklassen-/Ausgabeverträge
privacy/inventory.py Alle endgültigen Textkanäle und kontrollierten technischen Felder erfassen
privacy/detect.py, mask.py, response.py Kanshō-Mechanismen angepasst an unveränderliche Calls und vollständige Abdeckung
profiles.py, routing.py Aktuelle Profil-/Policyrevision, Empfängerrolle, Eignung und Capabilityprüfung
transports/openrouter.py, optional local_detect.py Protokolladapter mit strengem Endpoint, Secretinjektion und begrenztem HTTP
repository.py Callledger und Audit auf explizitem Transaktionshandle
Fach-/Promptadapter Scoped Quellen materialisieren, Vorlage rendern, Outputtyp registrieren; Gateway konsumieren

create_app(settings, providers)/Lifespan der Foundation verdrahten diese Adapter. Nur Transportmodule dürfen Modell-HTTP ausführen. Direkte Provider-SDK-/HTTP-Aufrufe in Renderern, Feature-Routern, Diagnosen, Lern-/Precomputejobs oder Workflownodes sind kein zulässiger zweiter KI-Pfad. Andere fachliche HTTP-Integrationen werden dadurch nicht zu Modelladaptern erklärt.

Mitai liefert nach Auflösung aller Variablen und Augmentierungen RenderedPrompt, nicht bereits einen externen Call. Das Gateway darf vor Versand keinen fachlichen Promptteil auslassen. Ergebnis-/Formatinstruktionen werden vor der vollständigen Egressinventur ergänzt. Der nachfolgende Workflow-Blueprint muss dieselben DTOs und Fehler-/Idempotenzverträge verwenden. Jeder Modellnode und jeder erneute Aufruf erhält eine eigene Call-ID und durchläuft erneut das Gateway; eine alte Maskierungsfreigabe gilt nicht für neue Nodeinputs.

Erster Implementierungsschnitt: Textnachrichten, keine externen Tools/Plugins, keine Bilder/Audio-/Dateiuploads oder Remote-URLs, keine autonomen Agenten. Nicht registrierte Modalitäten werden verweigert. Spätere Erweiterungen benötigen denselben Empfänger-, Inhalts-, Test- und Datenschutzvertrag; sie werden nicht durch dict[str, Any] still akzeptiert.

4. Datenklassen, Identität und Quellenvertrag

RequestContext kommt unverändert aus Phase 3.3: geprüfter Principal, expliziter Scope und Request-ID. profile_id, Rollen, Policyklasse, Provider-URL und privacy_checked=true aus einem Browserbody sind keine Autorität. Ein Fachzweck ist in einer immutable Registry registriert und bestimmt Mindestschutz, erlaubte Quellen, Modellprofil und Ausgabeschema serverseitig.

Klasse Anwendung im Gateway
A / Local only Externer Generate verweigert; Geheimnisse, vollständige Identityregistry/Mapping und nicht erforderliche Rohdaten gehören nicht in den externen Kontext. Ein lokaler Fachfallback ist eine eigene registrierte Funktion.
B / persönlicher Kontext Nur notwendige autorisierte Daten, vollständige lokale Detection/Registry-/Maskierungsprüfung, geeignete externe Route. Pseudonymisierung ist keine behauptete Anonymisierung.
C / generischer Kontext Nur tatsächlich nicht persönliche freigegebene Inhalte. Gemeinsamer Gateway-/Endpoint-/Fehlerpfad bleibt bestehen; C ist kein Umbenennen persönlicher Daten.

Materialisierung klassifiziert Quellen/Felder anhand des Produktvertrags. Enthält eine Anfrage erforderliche Local-only-Bestandteile, darf sie nicht durch bloße Gesamtkennzeichnung B/C passieren. A-Felder müssen vor externem Rendering begründet ausgeschlossen sein; sonst Blockade. Bekannter Personenbezug in vermeintlichem C führt zur strengeren B-Prüfung, sofern für den Zweck zugelassen, andernfalls Ablehnung. Fehlende/unklare Klassifikation wird nicht C.

Im ersten Schnitt ist C auf registrierte generische Vorlagen-/Katalogquellen begrenzt. Freier Usertext, persönliche Historie oder materialisierte Personendaten sind mindestens B; ein generischer Zweckname stuft sie nicht herunter. Ein lokaler vorgelagerter ForbiddenContentGuard verweigert bekannte Secrets, Private-Keyblöcke, credentialhaltige URLs/DSNs und als Local-only definierte direkte Identifikatorfelder vor Weiterverarbeitung. Dafür werden konkrete Struktur-/Secretregeln verwendet, keine Food-/Namensheuristiken als Ersatz für semantische Detection. Auch diese Prüfung behauptet keine vollständige Erkennung unbekannter Geheimnisse in beliebigem Freitext.

SourceBinding enthält lokal Objekttyp/-ID, erwartete Version, Owner-/Scopebindung und ausgewählte Felder. Alle Quellen werden mit derselben AccessPolicy und scoped Repositoryabfragen geladen, einschließlich RAG-/Graph-/Memory-/Toolresultatquellen. Öffentlicher/globaler Katalog ist eine ausdrücklich erlaubte Quellenart, kein Join auf fremde private Daten. Bereits erzeugter Modelltext bleibt untrusted Eingabe und erhält keine höhere Anweisungspriorität.

Der Dispatcher lädt niemals „alle Profile“ als Kontext. Minimierung ist eine Produktfeld-/Quellenauswahl, kein bloßes strip() oder pauschales Abschneiden. Bei Budgetüberschreitung wird abgebrochen oder im Fachadapter ein ausdrücklich anderer kompakter Kontext neu erzeugt; dieser durchläuft erneut die gesamte Pipeline. Keine unsichtbare providerseitige Kontextkompression.

5. Python-Verträge und lokale Identitäten

Illustrative Schnittstellen V/K. Importpfade für RequestContext, ScopeRef und Foundation-UoW werden im Zielprojekt aus den vorhandenen Verträgen übernommen. Inhalte sind im Speicher vertraulich, auch wenn repr=False ihre versehentliche Repräsentation reduziert.

from dataclasses import dataclass, field
from typing import Literal, Protocol
from app.core.context import RequestContext

@dataclass(frozen=True, slots=True)
class SourceBinding:
    kind: str
    source_id: str
    version: str
    selected_fields: tuple[str, ...]

@dataclass(frozen=True, slots=True)
class PromptMessage:
    role: Literal["system", "developer", "user", "assistant", "tool"]
    content: str = field(repr=False)

@dataclass(frozen=True, slots=True)
class RenderedPrompt:
    template_id: str
    template_revision: str
    messages: tuple[PromptMessage, ...] = field(repr=False)
    sources: tuple[SourceBinding, ...]

@dataclass(frozen=True, slots=True)
class GatewayCall:
    call_id: str
    execution_id: str
    node_key: str
    purpose: str
    rendered: RenderedPrompt = field(repr=False)
    result_spec_id: str

@dataclass(frozen=True, slots=True)
class UsageReport:
    input_tokens: int | None
    output_tokens: int | None
    reported_cost: str | None
    currency: str | None
    status: Literal["reported", "estimated", "unknown"]

@dataclass(frozen=True, slots=True)
class ModelResult:
    call_id: str
    content: str = field(repr=False)
    result_spec_id: str
    usage: UsageReport

class ModelGateway(Protocol):
    async def complete(self, context: RequestContext,
                       call: GatewayCall) -> ModelResult: ...

Ein RenderedPrompt ist ein internes Ergebnis des autorisierten Render-/Materialisierungsadapters, kein frei deserialisiertes APIobjekt. purpose, ResultSpec und Vorlagenrevision werden gegen registrierte serverseitige Definitionen geprüft. ResultSpec legt text oder ein konkretes Pydanticmodell, maximale Länge, erlaubte Werte und rehydrierbare Textpfade fest. ModelResult.content ist bei JSON eine validierte kanonische JSONzeichenkette; Fachadapter erhält anschließend das explizite lokale DTO. Keine rohen Providerdicts.

Providertransport erhält weder RequestContext noch SourceBinding oder Manifest. Er bekommt eine interne SealedEgress-Struktur: Call-ID, registrierte Route-/Profil-/Policyrevision, unveränderliche Bodybytes, Bytehash, Größenlimit, Deadline und eine kurzlebige interne DispatchPermit. Diese Objekte werden ausschließlich durch die Gatewaypipeline erstellt, nicht aus einem Clientflag. Sie sind lokale Programmgrenzen, kein Kryptografiebeweis gegen kompromittierten Servercode.

Hier bezeichnet SealedEgress den Generate-Ausgang. Die vorgelagerte lokale Detection verwendet einen getrennten typisierten LocalDetectInput(call_id,inventory_revision,text_fields) und LocalDetectTransport: nur nach T1/ForbiddenContentGuard, nur zum eligible lokalen Detectprofil, ohne Registry-/Rehydrationstabelle und ohne externe Generate-Permit. Der lokale Detectadapter validiert Ziel, Größen, Rolle und Antwortschema, bevor er Coverage liefert. Er kann keine Generate-Route auswählen. So entsteht kein zirkuläres „vor Detection bereits vollständig maskiert“-Erfordernis und kein als Detect getarnter externer Klartextpfad.

Der kleine Detect-Port präzisiert die Rückgabe. Coveragebereiche werden lokal vom Adapter aus tatsächlich erfolgreich verarbeiteten Chunks aufgebaut, nicht aus einer Modellbehauptung übernommen. Spans werden am exakt gebundenen Text validiert.

@dataclass(frozen=True, slots=True)
class TextField:
    path: str
    revision: str
    text: str = field(repr=False)

@dataclass(frozen=True, slots=True)
class LocalDetectInput:
    call_id: str
    inventory_revision: str
    text_fields: tuple[TextField, ...] = field(repr=False)

@dataclass(frozen=True, slots=True)
class DetectedSpan:
    field_path: str
    start: int
    end: int
    observed: str = field(repr=False)
    entity_type: Literal["PERSON", "PLACE", "ORG", "PROJECT"]

@dataclass(frozen=True, slots=True)
class DetectionCoverage:
    inventory_revision: str
    detector_profile_revision: str
    processed_ranges: tuple[tuple[str, int, int], ...]
    spans: tuple[DetectedSpan, ...] = field(repr=False)

class SemanticDetector(Protocol):
    async def detect(self, request: LocalDetectInput) -> DetectionCoverage: ...

Die lokale MaskingManifest-Variante übernimmt Kanshōs aktive Ersetzungen, Typen, Vorkommen und Rehydrationstabelle, ergänzt aber zwingend Call-ID, Subject/Scope-Namespace, genaue Inventur-/Payloadrevision, Detection-/Registry-/Reviewrevision und technische Coverage. Keine dieser Zuordnungen wird in externe Metadaten oder globale mutable Variablen gelegt. Gleichzeitige A-/B-Calls besitzen getrennte Manifeste; kein globales last_trace als Quelle persönlicher Ergebnisse.

6. Providerprofile, Trust Zones und Eignung

Ein Profil ist produktlokal versioniert und enthält ausschließlich Konfiguration/Secretreferenzen. Konkrete erforderliche Felder:

Gruppe Felder / Regel
Identität profile_id, revision, adapter_kind, Rolle `detect
Ziel Exakte erlaubte Scheme/Host/Port/Path-Kombination, TLS-/CAprofil, explizite Netzwerk-/Adressgrenze, trust_zone_id
Modell Registrierte Modell-ID, erlaubte Rollen/Modalitäten, Contextwindow/Tokenizer bzw. Schätzverfahren, Ausgabegrenze, unterstützte Formate
Privacy Policy-ID/-revision, erlaubte Zwecke/Datenklassen, erforderlicher ZDR-/No-training-/Region-/Loggingzustand, Belegreferenzen und checked_at/valid_until
Adapter Erzwungene Requestparameter, erlaubte Upstreamprovider/Endpoints, Redirect-/Retry-/Transformverhalten, Transportlimitprofil
Secret Ausschließlich credential_ref; Rohwert nur im Secret-/Transportadapter, nicht im Profil-Response oder Log

Ein Boolean zdr=true ohne Beleg/Adapterfähigkeit reicht nicht. Eignung erfordert passende aktuelle Policy, dokumentierte tatsächliche Account-/Endpointkonfiguration und technische Erzwingbarkeit der geforderten Einschränkungen. Unbekannt/abgelaufen → Route nicht eligible. Default für erneute technische Belegprüfung sieben Tage und bei Profil-/Provideränderung; lokale Gründe können andere Fristen verlangen. Dies ist ein veränderbarer technischer Prüfzyklus, keine neue Familienfreigabe.

Aktuelle Bedingungen des konkret gewählten Empfängers sind gemäß ADR-09 vor realer persönlicher Nutzung zu prüfen. Diese Lieferung aktiviert keinen Provider und liest keine Account-/Keyeinstellungen. Tests verwenden synthetische Profile/Keys. Fehlt ein realer Beleg, bleibt der betreffende Pfad geschlossen; andere Appfunktionen können weiterlaufen.

6.1 Detect, Generate und lokale Empfänger

Detect: bevorzugt ein bereits vorhandener lokaler, ausdrücklich registrierter semantischer Detector. Er sieht nur den für Detection notwendigen finalen Text, keine vollständige Identityregistry, Sessioncredentials oder DBsecrets. Bestätigte lokale Identitäten werden im Gateway angewendet. Eine lokale IP oder .local beweist keine Vertrauenszone: Betreiber-/Zugriffs-/Logginggrenze, konkretes Ziel und Netzweg müssen zum Profil passen.

Generate: nur maskierter/minimierter B-Kontext bzw. kontrolliertes C, passendes Modell und Providerpolicy. Kein derselbe Key als stiller Fallback zwischen Rollen. Tools/Websuche/Embeddings/Transkription: eigene spätere Zweck-/Empfängerpfade; im ersten Schnitt nicht aktiviert. OpenRouter-ZDR ist keine Freigabe aller zusätzlich einschaltbaren Tools.

Neuer Standard: kein externer Klartext-Detect, auch nicht allein wegen APP_ENV=development. Persönliche Development-/Testdaten bleiben persönlich; CI arbeitet synthetisch. Kanshōs ausdrücklich beschriebene Übergänge bleiben dortige Bestandsregeln und werden im Reuseadapter als Abweichung dokumentiert. Es entsteht kein neuer Runtime-„Privacy aus“-Schalter und kein notwendiger neuer Detectdienst in diesem Auftrag. Ohne vorhandenen geeigneten Detect-/Reviewadapter bleibt B-Egress geschlossen.

6.2 Endpunkt- und Secretgrenze

Keine URL, Base-URL, Proxyadresse oder Callbackadresse aus Fach-/Browserinput. Nur registrierte Adapterziele; HTTPS mit Zertifikatsprüfung extern, HTTP ausschließlich für explizit erlaubte kontrollierte lokale Empfänger. Keine Userinfo/Secrets in URLs, keine frei wählbaren Header, keine Redirects. openrouter.ai wird exakt geprüft; ein Anzeigename oder endswith('openrouter.ai') ist keine Zielautorität.

DNS-Auflösung und tatsächlicher Verbindungsweg müssen die registrierte Zielgrenze einhalten. Netzwerkregeln des vorhandenen Containers/Hosts begrenzen den Adapter zusätzlich; DNS-Rebinding auf Loopback/Metadata-/fremde private Ziele darf kein neues Ziel öffnen. Eine pauschale Freigabe aller RFC1918-/Link-local-Adressen ist ausgeschlossen. Erforderliche lokale Adressen werden ausdrücklich registriert. Kann ein Adapter seine Verbindungsgrenze nicht gewährleisten, wird er nicht als eligible markiert.

HTTPX verwendet trust_env=False, keine impliziten Proxy-/CAumgebungswechsel, und ein ausdrücklich konfiguriertes TLS-/CAprofil. Client wird im Lifespan wiederverwendet und geschlossen; Keys werden nur für das konkrete legitime Authheaderziel injiziert. Provider-APIkeys sind notwendige Transportcredentials dieses Empfängers, keine erlaubten Modellkontextfelder. App-/DB-/Sessionsecrets und Mappingdaten gehen niemals in Payload, Attribution oder URL. HTTPX Umgebungsvariablen.

6.3 Konkreter OpenRouter-Adapter

OpenRouter ist ein vorhandener Adapterkandidat, kein Architekturzwang. Für entsprechend freigegebenen B-Egress setzt der Adapter insbesondere:

{
  "model": "registered-model-id",
  "messages": [{"role": "user", "content": "Freigegebener maskierter Text"}],
  "max_tokens": 2048,
  "stream": false,
  "provider": {
    "only": ["registered-upstream-slug"],
    "allow_fallbacks": false,
    "require_parameters": true,
    "data_collection": "deny",
    "zdr": true
  }
}

Platzhalter-IDs werden aus dem passenden eligible Profil eingesetzt; keine aktuelle Modell-/Providerempfehlung oder bereits erteilte Freigabe. Keine Modellfallbackliste, Auto-Router, Tools, Plugins oder dynamischen Presets. Providerseitige Kontextkompression/zusätzliche Transformation ist für persönliche Payloads nicht zugelassen; die konkrete Deaktivierung muss der eingesetzte Adapter nachweisen. Der Gatewayadapter setzt Filter selbst; ein Renderer darf sie nicht überschreiben.

Die Parameter only, allow_fallbacks, require_parameters und data_collection werden in der OpenRouter-Routingdokumentation beschrieben. Bei fehlender geeigneter Route wird abgebrochen. Ein Providername allein belegt keine verlangte Region; wenn Region verpflichtend ist, braucht das Profil einen passenden tatsächlich erzwingbaren Endpoint-/Routingnachweis.

provider.zdr=true ist separat erforderlich; ein lokaler No-training-Boolean bzw. data_collection allein wird nicht als vollständiger Retentionsnachweis dargestellt. OpenRouter beschreibt ZDR für Inferenzrouting, weist Tools/Plugins eigene Policies zu und zählt bestimmte In-memory-Caches nicht als Retention. Daher bleibt die konkret benötigte Schutzwirkung zu prüfen. OpenRouter ZDR. Das sind begrenzte technische Gegenprüfungen, keine Aussage, jeder aktuelle Endpoint erfülle Jinkendos Anforderungen.

7. Ablauf und sichere Transaktionsgrenzen

7.1 Phase T1: autorisierte Aufnahme

In einer kurzen Foundation-UoW: aktuelle Session/Principal, Scope, Fachcapability und gegebenenfalls Entitlement prüfen; alle ausgewählten Quellen samt Version/Owner-/Scopegrenze materialisieren; unveränderlichen lokalen Snapshot erzeugen. Call-ID/Idempotenz registrieren und sicheren Auditmetadatensatz schreiben. Kein Modell-/Detector-/HTTP-Aufruf in dieser Transaktion. Der Renderer verarbeitet nur diesen autorisierten Snapshot und freigegebene Vorlagen-/Formatinstruktionen.

Die Berechtigung wird nicht aus den später vom Renderer eingetragenen SourceBinding-Strings geglaubt. Der Materialisierungsadapter erzeugt und bindet sie serverseitig. Nicht benötigte Felder werden vor Rendering ausgeschlossen. Eine nachträglich hinzugefügte Quelle verlangt erneute autorisierte Aufnahme.

7.2 Lokale Verarbeitung ohne offene DB-Transaktion

Vollständige Vorlage inklusive System-/Developer-/Historien-/Userteilen und statischem Outputvertrag fertigstellen. Inventur/Minimierung/Budgetprüfung durchführen. Für B den gesamten endgültigen Text lokal untersuchen, bestätigte eigene Registry ergänzen, offene Konflikte behandeln, requestbezogen maskieren. Payload einschließlich Adapterparameter fertigstellen und final validieren/sealen. Reihenfolge und Bindung stehen in Abschnitt 8/9.

Ein Reviewbedarf wird als privacy_review_required an den Fachadapter zurückgegeben. Generate wurde dann nicht aufgerufen. Vorhandene lokale Reviewmechanismen dürfen verwendet werden; fehlt ein geeigneter Adapter, bleibt dieser Fall geschlossen. Dieser Blueprint baut kein neues allgemeines Reviewportal und verlangt keine pauschale Bestätigung jeder Anfrage.

7.3 Phase T2: aktueller Dispatchentscheid

Unmittelbar vor Transport erneut unter kurzer UoW prüfen: aktueller Principal/Sessionsgeneration/Kontostatus, Scope/Mitgliedschaft, Fachrecht, alle Quellenversionen, Vorlagenrevision, aktive Policy-/Registry-/Providerprofilrevision und gegebenenfalls genau gebundene Reviewentscheidung. Weicht benötigter Kontext ab, context_changed statt Versand eines alten Snapshots. Keine stillschweigende Neuzusammenstellung nach der Privacyprüfung.

Bei Erfolg Dispatchintent samt Call-/Payload-/Routenbindung und erforderlichem Audit committen; kurzlebige interne Permit erzeugen, Default zwei Sekunden bis Beginn des Sendens. Hat das Warten auf Transportkapazität diese Frist überschritten, erneute T2-Prüfung vor Senden. Wiederholungen dieser kurzen lokalen Prüfung sind keine weiteren Modellversuche. Widerruf vor dem Dispatchentscheid sperrt den Call.

Zwischen DBcommit und externem Netzwerk besteht keine verteilte Transaktion. Eine Sperre unmittelbar nach dem Dispatchentscheid kann bereits freigegebene Bytes nicht zuverlässig zurückholen. Der Vertrag benennt deshalb diesen Autorisierungszeitpunkt, bindet den exakten Snapshot, hält das Zeitfenster klein und prüft nachher erneut. Es wird keine unmögliche Atomarität mit dem Provider behauptet.

7.4 Transport und Phase T3

Genau ein Generate-Versuch mit den geprüften Bytes; Antwort begrenzt einlesen, validieren und lokal rehydrieren. Danach erneut aktuelles Konto/Scope/Objekt-/Ausgaberecht prüfen. Bei Entzug oder Quellenkonflikt keine persönliche Antwort anzeigen oder als Fachergebnis speichern. Verbrauchs-/Fehlermetadaten des bereits erfolgten Aufrufs dürfen der Server unter eigenem engen Auditvertrag abschließen; sie geben keine Fachrechte zurück.

Wenn ein Fachergebnis gespeichert wird, verwenden Ausgaberecht, erwartete Objektversion, Ergebniswrite, Callabschluss und Audit dieselbe Foundation-Transaktion. Erst nach Commit Erfolg zurückgeben. Für reine Anzeige erhält T3 einen atomaren Metadatenabschluss plus aktuelle Lesefreigabe; das Ergebnis lebt nur im Antwortspeicher. Ein danach erfolgter Scopewechsel wird zusätzlich durch die Frontend-epoch abgefangen.

Fachservice/Workflow hält über den Gatewayawait keine DB-UoW offen. Der Gateway-HTTPpfad ist tatsächlich asynchron (httpx.AsyncClient); synchrone Psycopg-UoWs laufen über klar abgegrenzte Threadbridge-Funktionen, beispielsweise anyio.to_thread.run_sync. Kein blockierender SQLaufruf direkt im Eventloop und keine Connection über await weiterreichen. Abbruch beendet lokale Arbeit/Transport soweit möglich; ein bereits angestoßener Providercall kann trotzdem verarbeitet/berechnet worden sein.

8. Vollständige Detection und Maskierung

8.1 Inventur vor Detection

Der Adapter definiert eine geschlossene Payloadschema-Version. Für den ersten Schnitt enthält sie Modell-ID, erlaubte Textnachrichten, begrenzte numerische Parameter, Streamflag, kontrollierte Providerfilter und gegebenenfalls einen registrierten statischen Outputschema-Vertrag. Keine frei ergänzbaren metadata, user, Promptsuffixe, Plugins oder Tools.

Die Textinventur enumeriert alle endgültigen Nachrichtentexte: System, gegebenenfalls unterstützter Developerkanal, User, frühere Assistanttexte sowie jeder neu zusammengesetzte Kontext/Formattext. Tooltexte und weitere Felder sind entweder ausdrücklich unterstützt und vollständig inventarisiert oder verweigert; unbekannte Kanäle werden nicht ignoriert. Statische JSONschemabeschreibungen sind ebenfalls im Textinventar. Technische Schlüssel/Modell-/Provider-IDs stammen ausschließlich aus einer kontrollierten nicht persönlichen Registry; keine dynamischen persönlichen JSONkeys oder Schemas vom Browser. Externe $ref-/URLauflösung ist nicht erlaubt.

Inventareintrag: stabiler lokaler Feldpfad, Textrevision, lokale Quellenbindung, UTF-8-Bytegröße und Coveragebereiche. Derselbe Textstand wird für Detection und Maskierung verwendet. Unicode-/Zeilenendenaufbereitung findet, falls überhaupt nötig, vor dieser Bindung statt. Danach keine Normalisierung, die Spans verschiebt.

8.2 Semantische Detection, Registry und Review

Kanshōs requestbezogene Span-/Registrytrennung wird übernommen. Jeder notwendige Detect-Chunk muss tatsächlich erfolgreich verarbeitet und sein Ergebnis lokal am Originaltext geerdet sein: Feldpfad, Start/Ende als Python-Codepointindizes, beobachteter Text und Typ passen exakt. Schemafehler, abgeschnittene Antwort, Lücken oder Timeout verweigern B-Generate. Überlappende Chunks werden mit lokalen Offsets zusammengeführt; Randfälle dürfen weder verschwinden noch doppelt Identitäten bestätigen.

PERSON, PLACE, ORG, PROJECT sind die vorhandenen Ausgangstypen. Erweiterung nur bei konkretem Produktbedarf. Bestätigte eigene Identitäten/Aliase bleiben lokale Autorität. Ein Detect-Ergebnis erzeugt keine dauerhaft bestätigte Identität. Homonyme werden pro Vorkommen behandelt; keine neuen globalen Food-/Wetter-/Großschreibungswortlisten und kein Regexfallback, der einen semantischen Detectausfall als erfolgreich ausgibt.

coverage_complete=true bedeutet ausschließlich vollständige technische Verarbeitung des gebundenen Inventars. semantic_identity_guaranteed=false bleibt ausdrücklich erhalten. Ein Nulltreffer beweist nicht Identitätsfreiheit. Bekannte offene Konflikte oder erforderliche unbestätigte Entscheidungen blockieren bis zur gebundenen lokalen Klärung. Falls die konkrete Produktpolicy darüber hinaus eine geprüfte vollständige Freigabe persönlicher Eingabe verlangt, muss dieser Review-/Prüfadapter vorhanden sein; ein Fake „alles sicher“ ist unzulässig. Diese Grenze wird nicht durch neue Heuristiken verdeckt.

Vorab berechnete Treffer/Reviews sind nur wiederverwendbar, wenn Subject/Scope, sämtliche Feld-/Payloadrevisionen, Quellen, Registry-/Detector-/Policyrevision und Ablauf exakt passen. Ein Boolean full_detection_coverage=true aus dem Aufrufer reicht nicht. Ein bloßer Review des letzten Nutzersatzes deckt nicht automatisch Systemtext, Historie, RAG und spätere Renderergänzungen ab. Nicht abgedeckte Felder durchlaufen weiterhin Detection. Ändert sich die Vorlage oder ein nachgelagerter Nodeinput, gilt der alte Nachweis nicht.

8.3 Pseudonyme und lokales Manifest

Spanersetzungen aus Kanshō werden von hinten nach vorne auf den gebundenen Text angewandt. Überlappungen werden deterministisch aufgelöst oder als unklar verweigert; bestätigte Alias-/Identitätsregeln bleiben getrennt von unbestätigten Treffern. Nur tatsächlich eingesetzte Ersetzungen werden aktiv. Der Manifestnamespace ist mindestens Produkt + Scope + Subject + Call; ein Token aus B wird nie über A aufgelöst.

Vorhandenes Syntaxmuster [[PERSON:01]] bleibt als lokaler Adapterdefault möglich. Tokens sind innerhalb des Calls konsistent. Bestätigte lokale Identität kann intern über Calls stabil sein; extern wird standardmäßig pro Call neu zugeordnet, damit kein globales Personenkennzeichen entsteht. Kontextübergreifende stabile externe Pseudonyme sind keine Foundationpflicht. Aliase enthalten keine zusätzlichen Krankheiten, Herkunfts- oder Beziehungsinformationen.

Untrusted Eingabe darf die reservierte Identitätstokensyntax nicht selbst als Mappingbefehl einschleusen. Default: entsprechende rohe Tokens in neuen Quell-/Usertexten mit reserved_identity_syntax verweigern. Ein später tatsächlich benötigter Literaladapter kann sie eindeutig getrennt kodieren und muss getestet sein; kein stilles Verschlucken legitimen Inhalts. Vertrauenswürdige Vorlagen erzeugen konkrete aktive Tokens nur über den Manifestadapter.

Rehydrationstabelle enthält nur autorisierte aktive Tokens des Calls, nicht die ganze Profilregistry. Bestätigte Aliase können kanonisch, unbestätigte Requesttreffer in beobachteter Schreibweise rehydriert werden, entsprechend Kanshō. Kein Provider, Debugclient oder fremder Scope erhält diese Tabelle. Standardlebensdauer ist die Anfrage; nach Abschluss/Abbruch Referenzen freigeben. Persistente Quelldaten/Registries bleiben lokale Produktdaten und werden nicht als temporäre Diagnose gelöscht.

9. Finales Egress-Gate und unveränderlicher Transport

Nach Maskierung werden alle erlaubten Provider-/Formatparameter ergänzt, ein striktes endgültiges Payloadschema validiert und sämtliche ausgehenden Textfelder gegen das Manifest geprüft. Bekannte zu maskierende Identitätsvorkommen müssen ersetzt, technische Felder kontrolliert, Class-A-Felder entfernt und alle notwendigen Coverage-/Reviewbindungen gültig sein. Fehlender Beleg oder eine nicht unterstützte Zusatzoption sperrt den Versand.

Der Registry-Safety-Net-Adapter prüft die erwarteten zu schützenden Vorkommen im vollständigen Inventar, nicht ausschließlich bereits erfolgreich als manifest.replacements eingetragene Treffer. Eine zuvor ausgelassene bekannte Identität darf nicht dadurch unsichtbar werden, dass sie nie als aktive Ersetzung registriert wurde. Vorkommensbezogene Homonym-/Reviewregeln bleiben dabei bestehen; unbekannte semantisch übersehene Identitäten werden weiterhin nicht als garantiert erkannt dargestellt.

Serialisierung: deterministische JSONbytes in UTF-8, ensure_ascii=False, kompakte Separatoren, stabile Schlüsselreihenfolge, allow_nan=False; ungültige Surrogate oder nicht erlaubte Werte verweigern. Der interne Bytehash bindet genau diese Bytes an Route/Profil/Policy/Manifest/Call. Der Transport sendet content=sealed.body mit festem JSON-Content-Type, nicht erneut json=<veränderliches dict>. Keine SDK-/Middleware, die anschließend Promptteile/Tools/Metadaten anhängt.

Die einzige anschließende Ergänzung sind kontrollierte Transportheader, insbesondere der für genau diesen Empfänger benötigte Provider-Authheader. Keine Principal-/Profil-IDs, Cookie-/Sessionheader, freie Useragentzusätze oder rohe Quellnamen als Attribution. Request-ID/Call-ID bleibt lokal, sofern kein explizit geprüfter Transportvertrag eine nicht persönliche Korrelation benötigt. Finaler Endpoint und tatsächlicher Verbindungsweg sind Teil des Gates.

Vor .send verlangt der Adapter gültige Permit, passende Profil-/Policyrevision, Hash/Größe und freie Kapazität. Re-Rendering oder Änderung an Body, Schema, Modell, Route, Schlüsselzuordnung oder Prompt nach dem Gate macht den Seal ungültig. Ein Sendversuch konsumiert die interne Permit. Ein zweiter Generate benötigt eine neue explizite Callentscheidung; der Workflow kann nicht dieselbe Permit beliebig wiederverwenden.

Secretreferenzen liefern eine begrenzte Credentialversion zusätzlich zum Rohwert; die Version ist an die Route/Permit gebunden, der Rohwert bleibt nur im Transport. Eine zwischenzeitlich geänderte Zuordnung darf nicht denselben geprüften Call an ein anderes Konto/Ziel schicken. Der interne Status sent_or_unknown und ein begrenzter Providerrequestbezug können lokal gespeichert werden; ein möglicherweise vom Provider gelieferter Freitextbezug wird nicht ungeprüft als ID übernommen.

Eine spätere Antwortprüfung kann einen bereits erfolgten Datenversand nicht rückgängig machen. Deshalb müssen Canary-/Wiretests den tatsächlichen Adapterausgang untersuchen und nicht nur prüfen, dass eine Maskierungsfunktion aufgerufen wurde.

10. Transportgrenzen, Abbruch und Wiederholungen

10.1 Ressourcenprofil

Einstellung Technischer Ausgangswert
Gesamter Gatewaylauf einschließlich Detect/Queue/Generate 90 Sekunden monotone Deadline; Fachzwecke dürfen begründet andere begrenzte Werte wählen
HTTP connect / pool / write / read inactivity 5 / 2 / 10 / 30 Sekunden, jeweils zusätzlich zur verbleibenden Gesamtdauer
Parallelität Zwei Gatewayläufe je Backendprozess, begrenzte Warteschlange 16; voller Eingang 503
Eingabepayload Maximal 64 KiB UTF-8 über sämtliche Textteile; Modellkontext zusätzlich prüfen
Detect-Chunks Default 4.000 Codepoints mit begrenzter Überlappung 200; maximal 32 Chunks; vollständige Coverage Pflicht
Ausgabe Default maximal 2.048 Outputtokens; tatsächliches Modellprofil und Zweck können kleinere Grenzen setzen
Providerresponse Maximal 2 MiB decodierte Bodybytes und begrenzte Message-/Textlänge; Chunks zählen statt erst unbeschränkt .json() zu laden
Idempotenz-/Callmetadaten Default sieben Tage, an produktbezogene Audit-/Abrechnungszwecke anpassen

HTTPX unterscheidet Connect-/Read-/Write-/Pooltimeouts; Readtimeout ist eine Inaktivitätsgrenze pro empfangenem Chunk und keine Gesamtlaufzeit. Die zusätzliche monotone Deadline wird z. B. mit anyio.fail_after umgesetzt; Netzwerkressourcen werden bei Abbruch geschlossen. HTTPX Timeouts. Ein langsamer kontinuierlicher Bytestrom darf das Gesamtbudget nicht unbegrenzt verlängern.

Connectionpool und Admissionlimit sind explizit begrenzt. Bei mehreren Prozessen werden Limits budgetiert; ein Prozesslimit ist keine zugesicherte globale Kontenquote. Tokenbudget nutzt Modellprofil, reservierte Ausgabe und Sicherheitsmarge. Wenn nur eine konservative Zeichenschätzung verfügbar ist, wird sie so bezeichnet; unbekanntes Modellfenster oder Grenzverletzung führt zu lokalem Abbruch, nicht zu blindem Versand. Automatische Kürzung/Kompression nach dem Egress-Gate ist verboten.

10.2 Fehlerzustand und Kostenunsicherheit

Kein automatischer Generate-Retry, Reparaturprompt oder Modell-/Providerwechsel. Das gilt für 429/5xx, ungültiges JSON, Refusal, Verbindungsabbruch und Antwortvalidierungsfehler. Die erste erzeugte Antwort bleibt nicht durch eine heimliche zweite ersetzt. Eine bewusst angeforderte neue fachliche Ausführung erhält eine neue Call-ID und durchläuft Autorisierung/Privacy/Budget erneut.

not_sent ist nur zulässig, wenn der eigene Adapter sicher keinen Sendversuch begonnen hat. Nach Eintritt in den Transport ist bei Timeout/Abbruch der konservative Zustand sent_or_unknown, sofern kein engerer Nachweis existiert. Eine Exception oder Clientdisconnect bedeutet nicht „Provider hat nichts verarbeitet/keine Kosten“. Der Adapter speichert bekannte Usage, ansonsten unknown; keine erfundene Nullbuchung oder stille Freigabe einer möglichen Verbrauchsreservierung.

Bekannte HTTP-429-Antwort wird in ein sicheres begrenztes Retry-After übersetzt; der Client erhält keine automatische Wiederholungsanweisung für denselben Write. SDK-/Transportretrys werden ausdrücklich deaktiviert (Default null); kein versteckter HTTPTransport(retries=...) oder aus Providerbibliotheken übernommener Retry. Reine lokale T2-Neuprüfung und spätere lesende Statusabfrage sind davon getrennt.

11. Antwortvalidierung, JSON und Streaming

  1. Envelope streng prüfen: HTTPstatus, Content-Type, Bodylimit, eine erwartete Choice, bekannte Contentblöcke und Finishreason. Unbekanntes Format, versteckte Toolcalls oder finish_reason=length bei erforderlichem vollständigem Ergebnis werden nicht als erfolgreiches Fachresultat behandelt. Refusal ist ein eigenes Ergebnis/Fehlercode, kein normaler Textblock.
  2. Reasoning-/Thinking-/Toolblöcke werden nicht als sichtbarer Text ausgegeben oder in spätere Prompts übernommen. Nur ausdrücklich unterstützte Textblocktypen normalisieren; keine generische Rekursion durch alle Dictionarywerte.
  3. Für JSON: vollständige strikte JSONsyntax und das registrierte Pydantic-Ausgabemodell einschließlich Grenzen/Enums/extra='forbid' tatsächlich validieren. Kein bloßes json.loads(schema_ignored) und kein automatischer Repaircall. Default keine Markdown-Codefenceheuristik; ein bewusst benötigter Wrapperadapter ist eine getestete begrenzte Variante.
  4. Privacy-/Tokenintegrität prüfen. Unbekannte, fremde oder inaktive Identitätstokens verweigern; keine freie Registryauflösung. Erkennbare unzulässige Identitätsvermutung/PII gemäß Produktpolicy blockiert die Antwort, ohne erneuten Generate. Homonyme bleiben vorkommensbezogen, keine globale Wortersetzung.
  5. Nur bekannte aktive Tokens lokal rehydrieren. Eine interne normalisierte Prüffassung ist nicht die sichtbare Fassung. Akzeptierter modellseitiger Klartext behält seine Oberflächenform; nach Demasking keine semantische/grammatische Umschreibung des Journaltextes. Das folgt Kanshōs bestehender Trennung. JSONkeys, IDs, URLs, Datum-/Zahlenwerte oder später gedachte Toolargumente werden nicht unkontrolliert rehydriert; ResultSpec nennt erlaubte Textpfade.
  6. Nach Rehydration erneut Ausgabelänge/JSONschema/zulässige Struktur prüfen und gemäß T3 autorisieren. Fachliche Plausibilität gehört zum konkreten Fachadapter; „valides JSON“ beweist weder Wahrheit noch aktuelle Gültigkeit. Kein Vorgriff auf ADR-16.

Das Gateway validiert untrusted Ausgabe und verleiht ihr keine Befehlsgewalt. Quellen-/Modellanweisungen können weder Datenklasse, Endpoint, Scope, Zugriffspolitik noch Toolrechte erweitern. HTML/Markdown wird im Frontend nach vorhandenem sicherem Renderingvertrag behandelt; kein rohes dangerouslySetInnerHTML aus Modelltext. Links werden nicht serverseitig automatisch besucht.

Auch der Browser darf keine modellseitigen Remote-Bilder, eingebetteten Inhalte oder Linkpreview-/Prefetchrequests automatisch laden. Default ist sichere Textdarstellung bzw. ein Renderer mit registrierten internen Medienreferenzen; aktive URLschemata werden verweigert. Identitätstokens in URLs/Markdown-Linkzielen werden nicht zu privaten Klartext-URLs rehydriert. Ein Modell darf lokale Demaskierung nicht in eine spätere Browserausleitung verwandeln.

Streamingdefault: stream=false; vollständiges Ergebnis puffern und erst nach Validierung/Demaskierung freigeben. Falls ein konkretes Produkt Upstream-SSE benötigt, wird es begrenzt gesammelt und erst das vollständige geprüfte Ergebnis ausgegeben. Kein persönlicher Rohdelta-/Reasoningstream an Browser oder DebugUI. Fortschrittsanzeigen dürfen reine sichere Phasenereignisse senden, aber keine ungeprüften Tokens. Ein späteres echtes inkrementelles Freigabeverfahren braucht einen eigenen nachgewiesenen Vertrag; es wird hier nicht als bereits sicher angenommen.

Verbindung zum Browser bei Scopewechsel/Logout schließen, alte Ergebnisse/Fehler nach epoch verwerfen. Der Caller setzt für lange KI-Operationen bewusst größere begrenzte Zeitbudgets, Default Client 105 Sekunden/Proxy 110 Sekunden bei Gatewaydeadline 90; der allgemeine Foundation-15-Sekunden-Default wird nicht global entfernt. Produktlokale längere Jobs sind Gegenstand des folgenden Workflowblueprints, kein neuer Worker in diesem Dokument.

12. Callledger, Idempotenz, Audit und Quotenport

Persistente lokale Metadaten verhindern unbemerkte doppelte Generate-Ausführung. Logischer Datensatz ai_calls:

Feldgruppe Inhalt
Identität/Owner call_id UUID PK, subject_id, scope_kind, scope_id, execution_id, node_key, purpose; Owner-/Scopefilter bei jedem Lookup
Inputbindung Vorlagen-/ResultSpec-/Policy-/Profilrevisionen, Quellenversionsdigest und HMAC-Fingerprint der vollständigen semantischen Eingabe; keine Promptvolltexte
Zustand prepared, awaiting_review, dispatching, validated, completed, blocked, failed_unsent, unknown, rejected_output, discarded_after_revoke
Versand/Nachweis dispatch_decided_at, Beginn/Ende, sicherer Outcome-/Reasoncode, bekannte Modell-/Routen-ID, Technik-/Reviewcoverage und Maskierungszähler
Ergebnis/Verbrauch Optional erlaubte fachliche result_ref, validierter Usage-/Kostenzustand, optional späterer Reservierungsbezug; keine generelle Providerresponseablage

Ein Unique-Constraint über Subject + Scope + execution_id/node_key bindet eine logische Ausführung. IDs sind begrenzt/validiert und nicht frei als Pfade verwendbar. Gleicher Schlüssel mit anderer Eingabe → 409 call_conflict. Während Dispatch oder bei unknown wird kein zweiter Call gestartet. awaiting_review kann nur mit derselben aktuellen Inputbindung und legitimer lokaler Reviewentscheidung fortgesetzt werden; inhaltlich geänderte Anfrage ist eine neue Ausführung. Keine HTTPbody-Flags als Freigabe.

Fingerprints werden mit einem separaten produktlokalen AI_FINGERPRINT_KEY als HMAC berechnet, damit gespeicherte Hashes kurzer persönlicher Texte kein einfaches Wörterbuchorakel bilden. Rohes Payload-SHA dient nur intern zur unmittelbaren Bytebindung und wird nicht als öffentlicher Debugwert persistiert. Fingerprint bindet Subject/Scope/Zweck, Input-/Vorlagen-/Quellen-/Policy-/Profilstand und Ergebnisformat, nicht die Cookiegeneration; spätere legitime Sessionerneuerung erzeugt keine neue logische Facheingabe. Aktuelle Autorisierung bleibt trotzdem bei jedem Lookup Pflicht.

Der Ledger speichert die Fingerprint-Key-ID; benötigte alte Keyversionen bleiben über die Idempotenz-/Aufbewahrungsfrist verfügbar bzw. werden kontrolliert migriert. Fehlt nach Rotation/Restore eine benötigte Version, wird ein bestehender unbekannter Call nicht als neue freie Ausführung behandelt. Der Recovery-Schlüsselvertrag aus dem vorherigen Blueprint umfasst diesen Bedarf, ohne den Key in Datenarchiv oder Logs zu schreiben.

Schema/Fremdschlüssel nutzen die lokalen Account-/Scope-IDtypen der Zielanwendung; für einen neuen Foundationaufbau die in Phase 3.3 vorgesehenen Konten. Kein universeller Tenantstore. Callabschluss/Ergebniswrite/Audit committen zusammen. Netzcall und DB können nicht atomar sein: Prozessabbruch nach Dispatchintent wird konservativ als ungeklärter Aufruf behandelt, nie automatisch erneut gesendet. Nach Neustart sind offene dispatching-Zeilen zu klären bzw. unknown; ein Ablaufdatum erteilt keine neue Generate-Erlaubnis.

Die siebentägige Standardretention betrifft abgeschlossene ungebundene Metadaten. Laufende/ungeklärte Calls und durch Fach-/Workflowausführungen referenzierte Call-IDs behalten mindestens ihren gesperrten Idempotenz-/Outcometombstone; Cleanup darf sie nicht zu unbekannten „neuen“ Ausführungen machen. Für abgeschlossene Calls außerhalb des ausdrücklich zugesicherten Idempotenzfensters wird keine unbegrenzte Wiederabrufgarantie behauptet. Eine bewusst neue Generierung verwendet eine neue Ausführungs-ID.

Ein bereits abgeschlossenes persistiertes Fachergebnis kann nach aktueller Autorisierung per result_ref erneut gelesen werden. Bei reiner Anzeige ohne gespeichertes Resultat gibt es keinen langlebigen Antwortcache; Wiederabruf desselben Calls liefert result_unavailable, keine kostenpflichtige Neugenerierung. Der Fachauftrag kann ausdrücklich eine neue Ausführung anfordern. Keine personenbezogenen globalen Antwort-/Promptcaches.

12.1 Auditgrenzen und Speicherung

Pflichtmetadaten: Call-/Request-ID, lokale Subject-/Scopebindung, Zweck, verwendete Profil-/Policy-/Vorlagenrevision, lokale Dispatchentscheidung, Coverageart, semantic_identity_guaranteed=false, Zähler/Größen/Dauer, bekannter Usagezustand, Ausgabestatus und sicherer Reasoncode. Keine echten Labels, Aliase, Mappings, Cookie-/Provider-/DBsecrets, System-/Userpromptvolltexte oder Modellantworten in Log/APM/Exceptions/DebugUI. Providerfehlertexte können Eingaben spiegeln und werden daher nicht durch bloßes Abschneiden sicher.

Der Gateway speichert standardmäßig keine Rohprompts, Rohantworten oder Manifestmappings. Fachlich bewusst bewahrte Originalquellen und akzeptierte Ergebnisse bleiben normale lokale Produktdaten mit eigener Autorisierung/Retention; Kanshōs Quellbewahrung wird dadurch nicht abgeschafft. Diagnoseberechtigung ist keine pauschale Freigabe privater Texte. Tests dürfen Wirebodies ausschließlich mit synthetischen Inhalten und für den Testlauf aufzeichnen.

Fehlt der erforderliche Auditspeicher vor Dispatch, kein Versand. Scheitert der Abschluss nach möglichem Versand, wird kein zweiter Call zur „Reparatur“ erzeugt; Fehler und späterer Reconcile bleiben sichtbar. Das Release-/Recoveryverfahren aus dem vorherigen Blueprint muss auch Callledger und ungeklärte Zustände erhalten; Restore macht alte dispatching-Zeilen nicht erneut ausführbar.

12.2 Anschluss an Entitlements und Verbrauch

EntitlementPolicy ist zusätzlich zur AccessPolicy erforderlich, soweit das Produkt die Funktion begrenzt. Für spätere harte Kontingente gilt der kleine lokale Port:

@dataclass(frozen=True, slots=True)
class BudgetEnvelope:
    call_count: int
    upper_input_tokens: int | None
    upper_output_tokens: int | None
    maximum_cost: str | None
    cost_basis_revision: str | None

class UsageBudgetPort(Protocol):
    def reserve(self, tx: object, context: RequestContext,
                call_id: str, upper_bound: BudgetEnvelope) -> str: ...
    def settle(self, tx: object, reservation_id: str,
               actual: UsageReport) -> None: ...
    def mark_unknown(self, tx: object, reservation_id: str) -> None: ...
    def release_unsent(self, tx: object, reservation_id: str) -> None: ...

Dieser Port ist noch keine Billing-/Quotenimplementierung. Der folgende Entitlements-/Quota-Blueprint konkretisiert Atomarität, Perioden und Buchungsregeln. Ein Produkt ohne harte Quoten braucht nur die technischen Limits und Usageerfassung; es darf deshalb keine zugesicherte Kontingentgarantie behaupten. Ein Produkt mit harter Grenze bleibt ohne passenden echten Adapter geschlossen. Mitais heutiges „nach Erfolg hochzählen“ wird nicht als sichere parallele Reservierung oder Abrechnung unbekannter Ergebnisse ausgegeben. Fehlende Usage ist unknown, nicht kostenfrei.

Eine Schätzung ist keine zugesicherte Obergrenze. Der Adapter erhält im BudgetEnvelope nur tatsächlich belastbare obere Schranken, ansonsten None; er darf eine verpflichtende harte Token-/Kostengrenze dann nicht durch einen Schätzwert freigeben. Die Generate-Callanzahl kann für diesen Schnitt eindeutig mit eins begrenzt werden. Detect-/Toolverbräuche erhalten gegebenenfalls eigene Budgetzwecke und werden nicht unsichtbar in einen Generateerfolg eingerechnet.

13. Fach-API, Fehler und Frontendanschluss

Es entsteht kein öffentliches „beliebigen Prompt an beliebige URL senden“-API. Fachmodule registrieren konkrete Operationen mit festem Zweck, ResultSpec und serverseitiger Quellenauflösung. Beispiel: POST /api/v1/<feature>/{resource_id}/generate mit {expected_version, instruction?}; Session, CSRF/Origin und Scopeheader folgen Phase 3.3. instruction ist begrenzter untrusted Eingabetext und Bestandteil der Privacyinventur, keine übergeordnete Policy.

Idempotency-Key ist eine begrenzte kanonische UUID des Fachauftrags; node_key setzt der Server. Die Call-ID wird serverseitig erzeugt. Bodyfelder wie provider_url, api_key, data_class, profile_id, privacy_checked, precomputed_mappings, tools und frei gewählte model-IDs sind im Fach-DTO nicht erlaubt. Ein zugelassener Modellwunsch wäre höchstens ein registrierter serverseitig erneut geprüfter Variantenbezeichner.

FastAPI-Anschluss als Illustration V/K; das eigentliche Fachmodul implementiert den benannten Service. Synchrone DBphasen liegen innerhalb dessen expliziter Threadbridge, der Gatewayawait enthält keine offene DBverbindung:

from typing import Annotated
from uuid import UUID
from fastapi import APIRouter, Depends, Header, Request
from pydantic import BaseModel, ConfigDict, Field
from app.api.dependencies import scoped_context
from app.core.context import RequestContext

class GenerateInput(BaseModel):
    model_config = ConfigDict(extra="forbid", strict=True)
    expected_version: int = Field(ge=1)
    instruction: str | None = Field(default=None, max_length=2000)

class GenerateOutput(BaseModel):
    call_id: str
    content: str

router = APIRouter(prefix="/api/v1/feature")

@router.post("/{resource_id}/generate", response_model=GenerateOutput)
async def generate(
    resource_id: str, body: GenerateInput, request: Request,
    context: Annotated[RequestContext, Depends(scoped_context)],
    idempotency_key: Annotated[UUID, Header(alias="Idempotency-Key")],
):
    return await request.app.state.providers.feature_service.generate(
        context, resource_id, body, str(idempotency_key),
    )

Eine optionale reine Statusroute GET /api/v1/ai/calls/{call_id} liefert nur call_id,status,usage_status,result_ref? nach aktuellem Recht und Subject-/Scopefilter. Fremder oder unsichtbarer Call: 404. Sie gibt keine Prompts/Manifestlabels/Providerfehler zurück und löst keinen neuen Modellaufruf aus. Ein Review-/Fortsetzungsendpunkt ist produktlokal; er verwendet einen serverseitig gebundenen kurzlebigen Reviewbeleg, nicht confirmed=true aus dem Client. Er ändert keinen bestehenden Datenstand ohne den entsprechenden Fach-/CSRF-/Versionsvertrag.

HTTP / stabiler Code Bedeutung und Wirkung
401 session_invalid Kein aktueller Principal; kein Dispatch oder keine Ergebnisfreigabe
403 capability_denied, scope_forbidden, ai_policy_denied Zugriff/Zweck/Datenklasse/Privacy nicht erlaubt; keine Daten nach außen
404 not_found Fachquelle/Call fremd, unsichtbar oder fehlend
409 context_changed, call_conflict, call_in_progress, call_outcome_unknown, result_unavailable Kontext oder Ausführungszustand benötigt bewusste neue Entscheidung; kein automatischer Callretry
409 privacy_review_required Generate noch nicht gesendet; Produkt kann seinen bestehenden lokalen Reviewpfad öffnen
422 validation_failed, prompt_budget_exceeded, reserved_identity_syntax, unsupported_modality Eingabe/Format/Limit vor Versand verweigert
429 ai_rate_limited Explizites Kontolimit bzw. sichere normalisierte Providerbegrenzung; Retry-After begrenzt, keine automatische Mutation
502 provider_invalid_response, output_invalid, model_refused Upstreamantwort/ResultSpec/Integrität nicht nutzbar; kein Repaircall
503 ai_unavailable, privacy_detection_unavailable, ai_busy, policy_unavailable Fehlende Pflichtadapter/Eignung/Kapazität; keine unsichere Fallbackroute
504 ai_deadline_exceeded Zeitlimit; Outcome kann bereits sent_or_unknown sein, kein Erfolg/keine Nullkostenbehauptung

RFC-9457-Problemformat mit sicheren Maschinen-/Requestcodes gemäß Foundation. Insbesondere keine Rohwerte in Feldfehlern, keine Unknown-Tokenlabels oder Providerantwortschnipsel in detail. Für alle persönlichen Erfolgs-/Fehler-/Statusantworten Cache-Control: no-store. Fach-DTOs nennen keine Authcredentials oder Backendproviderprofile.

Frontend nutzt zentralen Cookie-/CSRF-/Scopeclient, setzt begrenzten KI-Timeout ausdrücklich, zeigt sichere Phasen-/Fehlermeldungen und verwirft alte Resultate/Fehler nach epoch. Ein 403/503 ist kein Logout; ein 504 löst keinen automatischen zweiten Generate aus. Kein persönliches Ergebnis im Service Worker, LocalStorage oder gemeinsamem Modellcache. Ausgabe wird mit dem jeweiligen sicheren Text-/Markdown-/Rich-Textadapter angezeigt.

14. Automatisierte Negativ- und Sicherheitsprüfungen

Die Matrix ist ein Testauftrag, kein Ergebnisbericht. Verwendet werden synthetische Personen-/Orgdaten, eigene Call-/Providerprofile, Fakedetectoren, Wire-Capture-Transport und isoliertes echtes PostgreSQL mit begrenzter Runtime-Rolle. Keine realen Providerkeys, privaten Textbestände oder Live-Modellaufrufe. Testfakes werden nur über Testproviderverdrahtung bereitgestellt; der Runtimeaufbau kann sie nicht per Flag auswählen.

Canaries erscheinen in jedem erlaubten Textkanal: System-/Developertext soweit unterstützt, User, Historie, Kontext/RAG, Registryalias und JSONschemabeschreibung. Unbekannte Zusatzfelder/Modalitäten erhalten eigene Ablehnungstests. Tests prüfen die an den Providertransport übergebenen endgültigen Bytes und alle erlaubten Transportmetadaten. Nicht nur den Aufruf einer Maskierungsfunktion mocken. Synthetische Wireaufzeichnung bleibt lokal im Test; keine Produktionsdebugfunktion daraus ableiten.

ID / Suite Testfall Zwingende Assertions
A01 test_gateway_access.py Keine/abgelaufene Session, falscher Scope, fremdes Profil/Objekt, fehlende Capability 401/403/404 vor jedem Detect-/Generatezugriff auf fremde Inhalte; keine Cross-Profilequelle
A02 Gemischte eigene/fremde RAG-/Eltern-/Memoryquellen Jede Quelle scoped geprüft; keine fremden Inhalte/Counts in Kontext, Wire oder Fehler
A03 Sitzung/Mitgliedschaft/Recht nach T1 entzogen, Quelle/Vorlage geändert T2 verhindert alten Dispatch; kein unverifizierter Neuaufbau
A04 Rechte-/Objektänderung während Generate Keine unautorisierte Anzeige/Fachspeicherung; Callusage sicher abgeschlossen, kein zweiter Call
A05 Class A, unbekannte Klasse, persönlicher Text als C, vom Client behauptete Klasse Local-only extern nie gesendet; C nicht als Bypass; Klassifikation serverseitig
A06 Bekannter Providerkey/Private-Keyblock oder credentialhaltige URL im Input ForbiddenContentGuard blockiert vor Detect/Generate; keine Secretwerte in Fehlern oder Logs
I01 test_egress_inventory.py Canaries in sämtlichen Textkanälen und statischer Schema-/Formatinstruktion Vollständige Inventur/Maskierung/Prüfung; erwarteter endgültiger Body ohne zu schützenden Canaryklartext
I02 Aufgelöster Platzhalter/Frageergänzung erst nach Nutzertextreview Alte Coverage reicht nicht; fehlende finale Felder neu prüfen oder blockieren
I03 Geänderte Template-/Source-/Registry-/Policyrevision bei precomputed Mappings/Review Alte Belege zurückweisen; bloßes full_detection_coverage=true reicht nicht
I04 Abgeschnittener/fehlender Detectchunk, UTF-8-/Unicodeoffset, Randüberlappung Coverage-/Spangrounding korrekt; kein Generate bei technischer Lücke; kein stilles Truncation
I05 Detect-Timeout, Nulltreffer, ungültiges Detectschema, unbekannter Typ Ausfall blockiert; Nulltreffer nicht als semantische Garantie; keine Heuristik-/Wortlistenrettung
M01 test_masking.py Vorkommensbezogener Homonymfall, Alias, überlappende Namen, Projektname Nur passende geerdete Spans; bestätigte/unbestätigte Herkunft getrennt; kein globales Ersetzen aller gleichen Wörter
M02 Zwei parallele Subjects/Scopes mit gleich aussehenden Tokens Getrennte Manifeste/Antworten, keine globalen Traces oder Cross-Profile-Rehydration
M03 Inaktives Mapping, fremder/erratener Token, reservierte Syntax aus Userquelle Nur tatsächlich aktive eigene Tokens auflösbar; Injection/unknown Token verweigert
M04 Bekannter Alias vs. unbestätigter Treffer, akzeptierter Modellklartext Kanonisch/beobachtet korrekt; Prüffassung nicht sichtbare Ausgabe; keine grammatische Umformung
P01 test_provider_policy.py Fehlendes/abgelaufenes Eignungsdokument, Boolean-ZDR ohne Beleg, ungeeignete Region/Endpoint Nicht eligible, keine Generierung; keine pauschale Providerfreigabe
P02 OpenRouter-Payload, ungeeigneter Fallback, nur data_collection gesetzt Gültiger vollständiger Profilvertrag setzt erforderliche Filter; kein Modell-/Providerfallback oder unerlaubter Transform
P03 URL aus Userinput, Suffixtrick, Redirect, DNS-Rebinding, Metadata-/fremde interne IP Vor bzw. am Connect verweigert; kein Secret an fremdes Ziel; private IP allein ist keine Vertrauenszone
P04 Impliziter Proxy/CA aus Umgebung, falsches Zertifikat, fremder Authheader trust_env=False/explizite CA wirksam; falsches TLS abgelehnt; nur richtiger Profilkey am Ziel
P05 Remote-Klartext-Detect per Devmodus/Flag, Fakeprovider im Runtimeaufbau Kein Standardbypass; ungeeigneter B-Pfad geschlossen; Tests injecten Fakes ausschließlich lokal
P06 LocalDetectInput gegen Generate-/externes Detectprofil oder mit Registrydaten Typ-/Rollen-/Trust-Zone-Grenze verweigert; lokaler Detect erhält nur erlaubte Textfelder
T01 test_transport.py Body/Modell/Profil/Policy nach Seal verändert, abgelaufene Permit Kein Versand; Bytehash-/Revisions-/Zeitbindung greift
T02 Genau ein erlaubter Send, danach erneute Permitverwendung Keine zweite Sendung; Wirebytes entsprechen finaler Prüfung, keine nachträglichen SDKfelder
T03 Connect-/Pool-/Read-/Writefehler, langsam kontinuierlicher Stream Einzel-/Gesamtlaufzeitgrenzen; Ressourcen frei; nach möglichem Versand Outcome unknown statt kostenfrei
T04 429/5xx, ungültiges JSON, Refusal, Disconnect nach Providerannahme Kein versteckter Retry/Repaircall; sichere Fehler; keine Behauptung „Provider hat abgebrochen“
T05 Queue/Pool voll, mehrere Prozesse, riesige Input-/Responsebody Begrenzte Ablehnung und gemessene Limits; keine Poolumgehung oder unbeschränkte .json()-Allokation
O01 test_model_output.py Falsche Envelope/Choice/Finishreason, Reasoning/Toolblocks Nur erlaubte Formate; keine versteckten Tools/Reasoninginhalte in Ergebnis/Historie
O02 Valides JSON mit falschem Schema/extra Feldern/NaN/Grenzwerten Lokales striktes ResultSpec tatsächlich geprüft; keine TODO-Schemaannahme oder Repairgenerierung
O03 Unbekannter/inaktiver Token, unzulässige Identitätsvermutung Ausgabe verworfen, keine fremde Lookupauflösung; Egress nicht nachträglich als ungeschehen erklärt
O04 Rehydration in JSONtext gegenüber Keys/IDs/Zahlen/URLs Nur erlaubte Textpfade; Schema nach Rehydration nochmals gültig
O05 Persönlicher Upstreamdelta-/Fehlerstream vor Validierung Kein Rohdelta an Browser/Debug; begrenztes Puffern bzw. Ablehnung, nur sichere Fortschrittsereignisse
O06 Modellantwort mit Remote-Bild/HTML/aktivem Link oder Identitätstoken in URL Kein automatisches Browser-/Serverfetch und keine private Rehydration in Linkziele; sicherer Renderer
C01 test_gateway_calls.py Parallele gleiche Idempotenz, geänderter Fingerprint, alter Scope Ein Send höchstens, 409 bei Konflikt; jeder Lookup aktuell autorisiert
C02 Prozessabbruch vor/nach Dispatchintent bzw. nach Ergebnis, vor Abschlusscommit Keine automatische erneute Sendung; unknown/persistierte Resultreferenz korrekt
C03 Metadaten-/Auditfehler vor Dispatch vs. danach Vorher kein Versand; nachher sichtbarer ungeklärter Zustand, keine Erfolgsausgabe oder heimliche Wiederholung
C04 Usage fehlt, echte Nullusage, abgeschätzte statt oberer Budgetgrenze Unknown von null getrennt; harte Quoten nicht durch unbewiesene Schätzung freigeben
C05 Restore alter offener Calls, Fingerprintkeywechsel Alte dispatching/unknown Calls werden nicht automatisch ausführbar; Idempotenz-/Key-ID-Vertrag bleibt nachvollziehbar
L01 test_ai_diagnostics.py Providerfehler enthält Canary/Prompt/Key, Exception/Repr/Log/APM Keine sensitiven Spiegelungen in HTTP/Logs/DTOs; Maskierungszähler statt Labels
L02 Debugberechtigung, gespeicherte Fachquelle, temporäres Mapping Debug exportiert keine Volltexte/Mapping; Fachquellbewahrung unverändert; Callmapping nur lokal
F01 Frontend-/APItests Fehlende CSRF/Scope, fremde Call-ID, extra Providerbodyfelder Phase-3.3-/DTO-Verträge wirksam; keine generische freie Proxyroute
F02 Scopewechsel/Logout mit verspäteter KIantwort/401/504 epoch verwirft alte Antworten/Fehler; kein Autoretry, 403/503 kein Logout

14.1 Anschluss an vorhandene Testquellen I

  • Kanshō Manifestfälle: aktive/inaktive Mappings, Homonyme, Alias-/Prüffassung und Rehydration übernehmen; um komplette Payload-/Scoped-/Wirebindung erweitern.
  • Kanshō Span-/Pre-Egress-Test: Spangrounding, Überlappung und Blockade vor Provider als Ausgangsfälle.
  • Kanshō Detectionverträge: Fakes belegen Schema/Fail-Closed-Verhalten, ausdrücklich keine Livequalität.
  • Kanshō verwendet einen eigenen pytest-Collector, der Testskripte über main() als je einen Fall sammelt. Eine Testdatei oder gefundene Hilfsfunktion beweist deshalb weder einzelne pytest-Coverage noch Erfolg. Im neuen Zielaufbau diese Fälle als einzeln benannte native pytest-Tests mit konkreter Pflichtcollection anlegen; Bestandscollector nicht pauschal kopieren.

Integrationstests verwenden echten isolierten PostgreSQLzustand nach dem Releaseblueprint. Reine Transformationen laufen ohne DB/Netz, Transporttests mit Fake-/Wireadapter. Nach Einführung eines tatsächlichen lokalen Detectors ist eine separate synthetische Qualitätsauswertung mit benanntem Modell/Stand nötig; sie wird nicht aus Mocktest-Erfolg abgeleitet. Reale persönliche Providererprobung ist nicht Teil dieser Lieferung oder Pflicht-CI.

15. Implementierungsauftrag für Cursor und nachfolgende Blueprints

Dieser Abschnitt wird hier nicht ausgeführt. Der spätere Auftrag benennt das Zielrepository und die erste tatsächliche KI-Funktion. Ohne konkrete Zielfunktion keine bestehende App als allgemeines Gatewayframework umbauen.

  1. Foundation v0.3, Phase-3.3-Kontext/Access/UoW und Releaseblueprint beibehalten. Lokales Gatewaymodul mit explizitem Composition Root/Ports aufbauen; keine Cross-Repoimporte oder neue zentrale Inferenzplattform.
  2. Kanshōs Maskierungsmanifest, Span-/Alias-/Registryregeln und Pre-Egress-Reihenfolge gezielt übertragen. Aktuelle Source-/Profil-/Policy-/Inventurbindung und Callisolation ergänzen. Vorhandene Globaldiagnose, Fake-Runtimeflags und pauschale Local-URL-Vertrauensprüfung nicht übernehmen.
  3. Den einen Fachzweck mit erlaubten Quellen/Feldern, B/C-Regel, Vorlage und lokalem ResultSpec registrieren. Scoped Materialisierung über vorhandene Repositories; keine neue Prompt-/Workflowengine. Mitais späteren Adapter an RenderedPrompt/ModelGateway.complete binden.
  4. Echte lokale Detect-/Reviewadapter und Profil-/Secret-/Eligibilityadapter anbinden, soweit vorhanden. Für Tests ausschließlich synthetische Fakes. Fehlende reale Eignung/Detection lässt persönlichen Egress geschlossen und wird als offen dokumentiert; keine echten Keys/privaten Texte zu „Smokezwecken“ verwenden. Kein neuer Detectdienst wird automatisch installiert.
  5. Payloadinventur, technische Coverage, Spangrounding, aktive Manifestmaske und den finalen Byte-Seal implementieren. Unbekannte Zusatzfelder, Klasse A, reservierte Tokeninjektion und ungeklärte Konflikte sperren. Keine ungescannten Format-/Systemtexte nachreichen.
  6. Async-HTTPadapter im Lifespan mit expliziten Endpunkten/TLS/Proxygrenzen, null Retries, Pool-/Admission-/Bodylimits und monotoner Gesamtdauer implementieren. Synchrone DBphasen in getrennten Threadbridge-UoWs; kein SQL-/HTTPmix in einer offenen Transaktion. OpenRouterparameter nur bei tatsächlich entsprechend eligible Profil verwenden.
  7. Callledger/Uniqueconstraints und T1/T2/T3 mit aktuellem Recht, Quellen-/Profilrevision, Dispatchintent, Audit und konservativem unknown-Zustand implementieren. Ergebniswrite atomar mit fachlichem Audit. Reviewfortsetzung exakt binden; keinen booleschen Clientnachweis akzeptieren.
  8. Envelope-, JSON-/Pydantic-, Token-/Privacyprüfung und lokale Rehydration implementieren. Kein Live-Rohstream oder Repaircall. Akzeptierten Journaltext nicht nachträglich umschreiben. Usage unbekannt korrekt erhalten, Quotenport nur bei realer Anforderung verdrahten.
  9. Fachrouter/Statusroute mit Auth-/CSRF-/Scope-/Idempotenzvertrag und sicheren Problemcodes anbinden. Zentralen Frontendclient/epoch beibehalten, begrenzten KI-Timeout lokal setzen, Ausgabe sicher rendern; keine persönlichen Webcaches oder Providerkeys im Frontend.
  10. Native Tests aus Abschnitt 14 tatsächlich sammeln/ausführen, Wirecanaries über alle Kanäle und negative Nebenpfade prüfen. In beiden Releasevarianten blockieren fehlende/rote KI-Pflicht-Gates vor Produktion. Produktionsmodus ebenfalls isoliert mit synthetischen Profilen prüfen; kein Devflag lockert Privacy. Ergebnisbericht nennt Commit, Image-/Policy-/Profil-/Detectorstand, Tests/Umgebung und offene Adapter. Nur tatsächliche bestandene Tests als T kennzeichnen.

Der nächste Prompt-/Platzhalter-/Workflow-Blueprint konkretisiert Vorlagenversionierung, Registrierungen, Graph-/Nodezustände und Wiederaufnahme. Er konsumiert diesen Gatewayvertrag; jeder Modellnode erhält ihn, ohne Privacy und Providertransport nochmals zu erfinden. Der anschließende Entitlements-/Verbrauch-/Quota-Blueprint konkretisiert Reservierung/Abrechnung, insbesondere parallele und unbekannte Ergebnisse. Beide werden durch dieses Dokument nicht automatisch gestartet.

Abnahme eines späteren ersten vertikalen Slices: autorisierte synthetische Quelle → vollständig gerenderter Prompt → lokale Detection/Maskierung → nachweislich geprüfte Wirebytes zum Fakeprovider → valides maskiertes Ergebnis → nur eigene lokale Rehydration → aktuell autorisierte Ausgabe/atomarer Fachwrite. Cross-Scope-Daten, Direct-HTTP-Bypass, unbekannter Outcome und ungültige Antwort müssen dabei sichtbar verweigert werden. Ein grüner Slice bleibt ein begrenzter Integrationsnachweis, keine universelle Detektions-/Produktreifezusage.

16. Prüfstand dieser Lieferung

Erstellt wurde ausschließlich dieses neue Blueprintdokument. Produktrepos, Foundation, Auth- und Releaseblueprint blieben unverändert. Keine Codeimplementierung, Modell-/Live-APIaufrufe, produktiven Credentials/Datenbanken, privaten Testtexte, Paketinstallationen, Migrationen, Deployments oder Anwendungstestläufe.

Dokumentprüfung umfasst lokale Referenzen/Zeilen, Python-/JSONbeispielsyntax und Konsistenz von Context-/Provider-/Payload-/Call-/Fehler-/Testverträgen. Das ist kein T-Nachweis für die geplante Lösung. Technische Providerdetails wurden begrenzt gegen offizielle OpenRouter-/HTTPX-Dokumentation geprüft; konkrete Account-/Endpointbedingungen und lokale Detectorqualität wurden nicht erhoben oder freigegeben.

16.1 Lokaler Quellstand

Lesestand 16.10.2026. Hashes über vollständige Dateien; Git-HEAD allein ist kein Beleg eines sauberen Checkouts.

  • Kansho: Git-HEAD 89d149684eab9211d6ef21181d018de097a61783
  • shinkan-jinkendo: Git-HEAD f10c28e5cdcef52cc44e953a8494b4bbe35b77fe
  • mitai-jinkendo: Git-HEAD 95453d548a2113555cd7e8f01fbbf267cbe34f3f
  • kairo-jinkendo: Git-HEAD ea0aa18b8dd9a55f663a996d74e63b7e3ee0dc16
Gezielt verwendete Produktquelle SHA-256
Kansho/backend/privacy_gateway.py 0e729287b6a87ba1a8ef92c6dce27cc3c3e1e829b6958130e59b4e90ff2a3d74
Kansho/backend/providers.py 86b6924d680ce8fe35e723f82226ac5c76bb7abe900fbdec1c20250de7af069f
Kansho/backend/provider_settings.py c38b352b289bbe6cce46d5d8482f26aabc4af8e29b8e3e6cd8f16460f98a122f
Kansho/backend/engine.py 79b86c6ff69ff87ea4e02c26203ac39beebccf2cce7078ed246ae73971488159
Kansho/backend/context_builder.py 712cb720267b57ac7fe471d7ec2a7cb25d9cd41cf8a19d63a8b083599c96586a
Kansho/backend/prompt_budget.py b95a36a6cd9e0ee704cd88b495bf9475230cdf5f0a2cb711458f27382af2be78
Kansho/backend/tests/test_privacy_manifest.py b48e16b901668efcd31f1534575400836cd3f68e5bd658d711ac7429c23526c5
Kansho/backend/tests/test_privacy_response_integrity.py b98035d558007b84c268b6d1b03e28d5b3b35f1984f821b6bbce9e9e84e6ae38
Kansho/backend/tests/test_privacy_detect.py 7b1043509fbe173f02e6ef050e2527a7adb27919dfbc1265832533e5c9d50347
Kansho/docs/architecture/functional/guardrails.md deadd95b5019fe807026616f6ff74a2467d9d951702c032573d59f27c125dc4b
Kansho/docs/architecture/technical/privacy_gateway.md 496c8661f645b8935edc8ce46214cfda3becca2588125eae345a7a860d9a07c5
shinkan-jinkendo/backend/openrouter_chat.py 606941440d7a7dd0a971cc0606e4ed8a5ad07f0b454374dc25dab8dd5c8a149a
mitai-jinkendo/backend/prompt_executor.py 7e0e97047fe16d7b5efb92ccbe573b6459c4d32b41931aa9e33d6f00f14028da
kairo-jinkendo/backend/config_service.py 5d4f4b75216fe5915874ee9db1776354bdf91f233286f29ea71ff112e2f5555e
Kansho/backend/tests/conftest.py 15c8a860538203e2dd63ee459b187cfb9fb586585e32a4c665ed74646c3f5ed8
Kansho/backend/pytest.ini cb919d485cff5f19a829ec584bf12019b4d7b6c4eb03e9254d690416b6e38a94

Ende dieses Blueprintauftrags. Keine Implementierung und kein weiterer Blueprint werden automatisch gestartet.