Wie XMemo funktioniert

Vereinfachte Architektur: Die 7-Stufen-Memory-Pipeline

XMemo verarbeitet Agenten-Erinnerungen über eine 7-Stufen-Pipeline (Capture → Scope → Retrieve → Rerank → Assemble → Govern → Consolidate). Jede Stufe erfüllt eine dedizierte Aufgabe, um sicherzustellen, dass Speicheroperationen schnell, präzise, isoliert und verifizierbar bleiben:

• Capture: Empfängt Schreib- und Aktualisierungsanfragen von KI-Clients über Standard-Model-Context-Protocol- (MCP) oder REST-APIs und bereinigt sensible Daten, bevor etwas gespeichert wird. Was das für Sie bedeutet: Ihre Agenten können Notizen, Entscheidungen und Präferenzen automatisch über Standard-Tools speichern, ohne Geheimnisse oder personenbezogene Daten preiszugeben.
• Scope: Löst den Identitätskontext des Aufrufers auf und setzt strikte Mandantengrenzen über Benutzer-, Sitzungs-, Agenten- und Workspace-Ebenen durch. Was das für Sie bedeutet: Jeder Agent greift nur auf Speicher innerhalb seiner autorisierten Grenzen zu, wodurch persönliche und Teamdaten sicher getrennt bleiben.
• Retrieve: Durchsucht gespeicherte Erinnerungen mit einer hybriden Retrieval-Engine, die semantische Vektor-Embeddings mit exakter Keyword-Suche kombiniert. Was das für Sie bedeutet: Ihr Agent ruft die richtigen Fakten ab, egal ob nach thematischer Bedeutung gesucht oder nach einem exakten Begriff geforscht wird.
• Rerank: Bewertet und gewichtet Kandidaten-Erinnerungen anhand von semantischer Relevanz, Aktualität und Wichtigkeitsgewichtung. Was das für Sie bedeutet: Ihr Agent erhält den relevantesten und aktuellsten Kontext statt veralteter oder unbedeutender Gesprächsfragmente.
• Assemble: Packt abgerufene Erinnerungen in prompt-fähigen Kontext und hält dabei strikt vorgegebene Token- und Byte-Budgets ein. Was das für Sie bedeutet: Injizierter Kontext überfüllt niemals das Kontextfenster Ihres Modells und verursacht keine unerwarteten Token-Kosten.
• Govern: Erfasst operative Audit-Protokolle, verfolgt den Versionsverlauf (memory_versions) und wendet Verschlüsselungsumschläge an, wenn der Keyguard-/Vault-Modus aktiv ist. Was das für Sie bedeutet: Jede Speicheränderung ist nachvollziehbar, überprüfbar und wiederherstellbar mit lückenloser Audit-Verantwortung.
• Consolidate: Zeigt eine Vorschau der Speicherkonsolidierung (Dream) an, um kürzliche episodische Interaktionen zu strukturierten Kandidaten-Erkenntnissen zu synthetisieren, wobei vor dem Speichern eine menschliche Bestätigung erforderlich ist. Was das für Sie bedeutet: Nützliche Erkenntnisse werden für Ihre Überprüfung vorbereitet, ohne automatische unerwartete Mutationen oder eine Verlangsamung interaktiver Agenten-Chats.

Architektur-Interna / Evidenz

Verbindliche Details zur Architekturimplementierung, Ausführungsspuren und empirische Verträge, die direkt an der XMemo-Codebasis überprüft wurden. In den folgenden Abschnitten werden die konkrete Laufzeitkomposition, isolierte Subsystemgrenzen und formale Verifikationsmatrizen dokumentiert.

Architekturinvarianten und Kernprinzipien

XMemo erzwingt nicht verhandelbare Architekturinvarianten, die öffentliche Clientschnittstellen von der internen Ausführung trennen. Funktionen sind an Codebelege gebunden und vertrauliche Daten sind vor Klartext-Offenlegung geschützt.

• Keine Offenlegung von Klartext-Geheimnissen: Konfigurationsdateien, Protokolle und Diagnoseantworten enthalten niemals unverschlüsselte Bearer-Tokens oder Verbindungszeichenfolgen.
• Verifizierte Quellherkunft: Jede persistierte Erinnerung, Version und jedes Zitat trägt unveränderliche Metadaten und Prüfprotokolle.
• Deterministische Token- und Byte-Budgets: Die Kontextinjektion hält Aufrufergrenzen strikt ein und verhindert LLM-Kontextüberläufe.
• Plan- und Feature-Gate-Grenzen: Multi-Tenant-BYODB, verteilte Synchronisierung und Hintergrund-Dream-Scheduling sind durch explizite Arbeitsbereichskonfigurationen, Feature-Flags und Plangrenzen geschützt.

Server-Zusammensetzung und Lebenszyklus-Topologie

Die Serverinitialisierung entkoppelt die Bereitstellungszeit von den Laufzeitausführungsspuren. Clients binden den Server nicht direkt ein; der Starlette-Server bindet FastMCP ein und passt ihn über den MemoryOSMcpMountAdapter an.

• Step 1 [HOST_COMPOSITION]: Starlette/FastAPI-Hostserver bindet FastMCP-ASGI-App unter /mcp ein — Relation: SERVER_MOUNTS_APP — Subsystem: ASGI-Server-Mount — Grenze: Öffentlicher HTTP-Ingress.
• Step 2 [MOUNT_ADAPTER]: mount_streamable_mcp kapselt streamable_http_app in MemoryOSMcpMountAdapter für CORS und Scope-Umschreibung — Relation: ADAPTS_ASGI_APP — Subsystem: Streamfähiger Protokolladapter — Grenze: Protokollbrücke.
• Step 3 [AUTH_REGISTRATION]: install_mcp_tool_surface registriert _call_tool_with_oauth_errors als Tool-Handler — Relation: REGISTERS_TOOL_WRAPPER — Subsystem: Identitäts- und Tool-Dispatch-Gate — Grenze: Authentifizierte Tool-Oberfläche.

+---------------------------------------------------------------------------------------------------+
| [DEPLOYMENT-TIME SERVER COMPOSITION & TOPOLOGY: 2 INDEPENDENT BRANCHES]                           |
|                                                                                                   |
| [BRANCH 1: SERVER ASGI MOUNT BRANCH]                                                              |
|  +-------------------------------------------------------+                                        |
|  | Host ASGI Server (Starlette / FastAPI)                | [PUBLIC_BOUNDARY]                      |
|  | Role: FastMCP Host Ingress Gateway                    | [PUBLIC_BOUNDARY]                      |
|  +-------------------------------------------------------+                                        |
|                             |                                                                     |
|                             | Relation: SERVER_MOUNTS_APP                                         |
|                             | Status: [PUBLIC_BOUNDARY (VERIFIED)]                                |
|                             v                                                                     |
|  +-------------------------------------------------------+                                        |
|  | mount_streamable_mcp                                  | [INTERNAL_SUBSYSTEM]                   |
|  | Role: Streamable HTTP Application Adapter             | [INTERNAL_SUBSYSTEM]                   |
|  +-------------------------------------------------------+                                        |
|                             |                                                                     |
|                             | Relation: ADAPTS_ASGI_APP                                           |
|                             | Status: [INTERNAL_SUBSYSTEM (VERIFIED)]                             |
|                             v                                                                     |
|  +-------------------------------------------------------+                                        |
|  | MemoryOSMcpMountAdapter                               | [PUBLIC_BOUNDARY]                      |
|  | Role: ASGI Protocol Bridge & Connection Handler       | [PUBLIC_BOUNDARY]                      |
|  +-------------------------------------------------------+                                        |
|                                                                                                   |
| [BRANCH 2: TOOL SURFACE REGISTRATION BRANCH]                                                      |
|  +-------------------------------------------------------+                                        |
|  | install_mcp_tool_surface                              | [INTERNAL_SUBSYSTEM]                   |
|  | Role: MCP Tool Surface Registration Pipeline          | [INTERNAL_SUBSYSTEM]                   |
|  +-------------------------------------------------------+                                        |
|                             |                                                                     |
|                             | Relation: REGISTERS_TOOL_WRAPPER                                    |
|                             | Status: [INTERNAL_SUBSYSTEM (VERIFIED)]                             |
|                             v                                                                     |
|  +-------------------------------------------------------+                                        |
|  | FastMCP Tool Ingress Wrapper (_call_tool_with_oauth)  | [PUBLIC_BOUNDARY]                      |
|  | Role: Authenticated Tool Invocation & Error Handler   | [PUBLIC_BOUNDARY]                      |
|  +-------------------------------------------------------+                                        |
+---------------------------------------------------------------------------------------------------+

Laufzeit-Ausführungsspuren

Zur Laufzeit durchlaufen Clientanfragen vier isolierte und deterministische Abläufe, die strengen Aufrufbeziehungen und expliziten Architekturgrenzen-Klassifizierungen folgen:

• OP_REMEMBER_WRITE [Erinnern / Schreibablauf: 13 Schritte]: Externer Client [PUBLIC_INGRESS] -> MemoryOSMcpMountAdapter [TRANSPORT_ADAPTER] -> FastMCP-ASGI-Dispatch -> Tool-Auth-Gate -> remember-Tool -> Setup-Prüfgate -> PII-Bereinigungsumschlag -> Sicherheitsumschlag (Verschlüsselung bei aktivem Keyguard-/Vault-Modus) -> Persistenz-Engine. Verifizierte 13 Schritte über Protokolleingang, Autorisierung und Persistenz.
• OP_RECALL_READ [Abrufen / Leseablauf: 12 Schritte]: Externer Client [PUBLIC_INGRESS] -> MemoryOSMcpMountAdapter [TRANSPORT_ADAPTER] -> FastMCP-ASGI-Dispatch -> Tool-Auth-Gate -> recall-Tool -> BoundSpace-Mandantenisolation -> Hybride Abruf-Engine -> Semantischer Reranker -> Kontextbudget-Assembler -> Öffentlicher Zitat-Formatierer. Verifizierte 12 Schritte über Abruf, Isolation und Budget.
• OP_UPDATE_VERSION [Aktualisieren / Versionsablauf: 13 Schritte]: Externer Client [PUBLIC_INGRESS] -> MemoryOSMcpMountAdapter [TRANSPORT_ADAPTER] -> FastMCP-ASGI-Dispatch -> Tool-Auth-Gate -> update_memory-Tool -> Setup-Prüfgate -> PII-Bereinigungsumschlag -> Sicherheitsumschlag (Verschlüsselung bei aktivem Keyguard-/Vault-Modus) -> Persistenz-Engine -> Versionsverlaufs-DAG-Controller. Verifizierte 13 Schritte über Validierung, Aktualisierung und DAG.
• OP_FORGET_LIFECYCLE [Vergessen / Lebenszyklusablauf: 11 Schritte]: Externer Client [PUBLIC_INGRESS] -> MemoryOSMcpMountAdapter [TRANSPORT_ADAPTER] -> FastMCP-ASGI-Dispatch -> Tool-Auth-Gate -> forget-Tool -> Setup-Prüfgate -> Soft-Tombstone-Persistenz -> Hintergrund-Aufbewahrungs-Daemon -> Suchmaschinen-Ausschlussfilter. Verifizierte 11 Schritte über Löschung und Aufbewahrung.

+------------------------------------------------------------------------------------------------------------------------+
| [RUNTIME EXECUTION TRACES: 4 CANONICAL OPERATION FLOW DIAGRAMS]                                                        |
|                                                                                                                        |
| 1. OP_REMEMBER_WRITE [WRITE INGRESS FLOW: 13 STEPS]                                                                    |
|     Step 1:   External Client --[CLIENT_REQUESTS_ENDPOINT]--> MemoryOSMcpMountAdapter                                  |
|              Boundary: Public Ingress Gateway [PUBLIC_BOUNDARY]                                                        |
|     Step 2:   MemoryOSMcpMountAdapter --[DELEGATES_ASGI_REQUEST]--> FastMCP.streamable_http_app                        |
|              Boundary: ASGI Streamable Mount Adapter [INTERNAL_SUBSYSTEM]                                              |
|     Step 3:   FastMCP --[DISPATCHES_TOOL_INVOCATION]--> _call_tool_with_oauth_errors                                   |
|              Boundary: Tool Surface Ingress Gate [INTERNAL_SUBSYSTEM]                                                  |
|     Step 4:   _call_tool_with_oauth_errors --[DISPATCHES_TOOL]--> remember tool                                        |
|              Boundary: MCP Tool Dispatch Handler [PUBLIC_BOUNDARY]                                                     |
|     Step 5:   remember tool --[CALLS]--> Identity Context Resolver                                                     |
|              Boundary: Identity & Authentication Context [INTERNAL_SUBSYSTEM]                                          |
|     Step 6:   remember tool --[CALLS]--> Workspace Setup Gate                                                          |
|              Boundary: Workspace Initialization Gate [INTERNAL_SUBSYSTEM]                                              |
|     Step 7:   Workspace Setup Gate --[CALLS]--> Initialization Validator                                               |
|              Boundary: Setup Verification Gate [INTERNAL_SUBSYSTEM]                                                    |
|     Step 8:   remember tool --[CALLS]--> Write Preparation Pipeline                                                    |
|              Boundary: Memory Write Preparation [INTERNAL_SUBSYSTEM]                                                   |
|     Step 9:   Write Preparation Pipeline --[CALLS]--> PII Sanitization Envelope                                        |
|              Boundary: Sensitive Data Redaction [INTERNAL_SUBSYSTEM]                                                   |
|     Step 10:  Write Preparation Pipeline --[CALLS]--> Security Envelope (encryption when keyguard/vault mode is active)|
|              Boundary: Cryptographic Security Envelope [INTERNAL_SUBSYSTEM]                                            |
|     Step 11:  remember tool --[CALLS]--> Tenant Isolation Envelope                                                     |
|              Boundary: Multi-Tenant Workspace Binding [INTERNAL_SUBSYSTEM]                                             |
|     Step 12:  remember tool --[CALLS]--> Memory Manager Core Engine                                                    |
|              Boundary: Core Memory Management [INTERNAL_SUBSYSTEM]                                                     |
|     Step 13:  Memory Manager Core Engine --[CALLS]--> Persistence Storage Engine                                       |
|              Boundary: Persistent Storage Engine [INTERNAL_SUBSYSTEM]                                                  |
|                                                                                                                        |
| 2. OP_RECALL_READ [READ RETRIEVAL FLOW: 12 STEPS]                                                                      |
|     Step 1:   External Client --[CLIENT_REQUESTS_ENDPOINT]--> MemoryOSMcpMountAdapter                                  |
|              Boundary: Public Ingress Gateway [PUBLIC_BOUNDARY]                                                        |
|     Step 2:   MemoryOSMcpMountAdapter --[DELEGATES_ASGI_REQUEST]--> FastMCP.streamable_http_app                        |
|              Boundary: ASGI Streamable Mount Adapter [INTERNAL_SUBSYSTEM]                                              |
|     Step 3:   FastMCP --[DISPATCHES_TOOL_INVOCATION]--> _call_tool_with_oauth_errors                                   |
|              Boundary: Tool Surface Ingress Gate [INTERNAL_SUBSYSTEM]                                                  |
|     Step 4:   _call_tool_with_oauth_errors --[DISPATCHES_TOOL]--> recall tool                                          |
|              Boundary: MCP Tool Dispatch Handler [PUBLIC_BOUNDARY]                                                     |
|     Step 5:   recall tool --[CALLS]--> Search Memory Implementation                                                    |
|              Boundary: Search Query Coordinator [INTERNAL_SUBSYSTEM]                                                   |
|     Step 6:   Search Memory Implementation --[CALLS]--> Identity Context Resolver                                      |
|              Boundary: Identity & Authentication Context [INTERNAL_SUBSYSTEM]                                          |
|     Step 7:   Search Memory Implementation --[CALLS]--> BoundSpace Multi-Tenant Isolation                              |
|              Boundary: Scope Isolation Boundary [INTERNAL_SUBSYSTEM]                                                   |
|     Step 8:   Search Memory Implementation --[CALLS]--> Memory Manager Search Service                                  |
|              Boundary: Core Search Controller [INTERNAL_SUBSYSTEM]                                                     |
|     Step 9:   Memory Manager Search Service --[CALLS]--> Hybrid Retrieval Engine                                       |
|              Boundary: Hybrid Vector & Text Retrieval [INTERNAL_SUBSYSTEM]                                             |
|     Step 10:  Hybrid Retrieval Engine --[CALLS]--> Semantic Relevance Reranker                                         |
|              Boundary: Candidate Scorer & Reranker [INTERNAL_SUBSYSTEM]                                                |
|     Step 11:  Hybrid Retrieval Engine --[CALLS]--> Response Budget Assembler                                           |
|              Boundary: Token & Byte Budget Manager [INTERNAL_SUBSYSTEM]                                                |
|     Step 12:  Response Budget Assembler --[CALLS]--> Public Citation & Receipt Formatter                               |
|              Boundary: Provenance Citation Formatter [PUBLIC_BOUNDARY]                                                 |
|                                                                                                                        |
| 3. OP_UPDATE_VERSION [VERSIONING & CORRECTION FLOW: 13 STEPS]                                                          |
|     Step 1:   External Client --[CLIENT_REQUESTS_ENDPOINT]--> MemoryOSMcpMountAdapter                                  |
|              Boundary: Public Ingress Gateway [PUBLIC_BOUNDARY]                                                        |
|     Step 2:   MemoryOSMcpMountAdapter --[DELEGATES_ASGI_REQUEST]--> FastMCP.streamable_http_app                        |
|              Boundary: ASGI Streamable Mount Adapter [INTERNAL_SUBSYSTEM]                                              |
|     Step 3:   FastMCP --[DISPATCHES_TOOL_INVOCATION]--> _call_tool_with_oauth_errors                                   |
|              Boundary: Tool Surface Ingress Gate [INTERNAL_SUBSYSTEM]                                                  |
|     Step 4:   _call_tool_with_oauth_errors --[DISPATCHES_TOOL]--> update_memory tool                                   |
|              Boundary: MCP Tool Dispatch Handler [PUBLIC_BOUNDARY]                                                     |
|     Step 5:   update_memory tool --[CALLS]--> Identity Context Resolver                                                |
|              Boundary: Identity & Authentication Context [INTERNAL_SUBSYSTEM]                                          |
|     Step 6:   update_memory tool --[CALLS]--> Workspace Setup Gate                                                     |
|              Boundary: Workspace Initialization Gate [INTERNAL_SUBSYSTEM]                                              |
|     Step 7:   update_memory tool --[CALLS]--> Scope Validation Gate                                                    |
|              Boundary: Workspace Scope Boundary [INTERNAL_SUBSYSTEM]                                                   |
|     Step 8:   update_memory tool --[CALLS]--> Write Preparation Pipeline                                               |
|              Boundary: Memory Write Preparation [INTERNAL_SUBSYSTEM]                                                   |
|     Step 9:   Write Preparation Pipeline --[CALLS]--> PII Sanitization Envelope                                        |
|              Boundary: Sensitive Data Redaction [INTERNAL_SUBSYSTEM]                                                   |
|     Step 10:  update_memory tool --[CALLS]--> Tenant Isolation Envelope                                                |
|              Boundary: Multi-Tenant Workspace Binding [INTERNAL_SUBSYSTEM]                                             |
|     Step 11:  update_memory tool --[CALLS]--> Memory Manager Core Engine                                               |
|              Boundary: Core Memory Management [INTERNAL_SUBSYSTEM]                                                     |
|     Step 12:  Memory Manager Core Engine --[CALLS]--> Persistence Storage Engine                                       |
|              Boundary: Persistent Storage Engine [INTERNAL_SUBSYSTEM]                                                  |
|     Step 13:  Persistence Storage Engine --[CALLS]--> Immutable Version DAG Controller                                 |
|              Boundary: Version DAG Supersession Engine [INTERNAL_SUBSYSTEM]                                            |
|                                                                                                                        |
| 4. OP_FORGET_LIFECYCLE [RETENTION & LIFECYCLE FLOW: 11 STEPS]                                                          |
|     Step 1:   External Client --[CLIENT_REQUESTS_ENDPOINT]--> MemoryOSMcpMountAdapter                                  |
|              Boundary: Public Ingress Gateway [PUBLIC_BOUNDARY]                                                        |
|     Step 2:   MemoryOSMcpMountAdapter --[DELEGATES_ASGI_REQUEST]--> FastMCP.streamable_http_app                        |
|              Boundary: ASGI Streamable Mount Adapter [INTERNAL_SUBSYSTEM]                                              |
|     Step 3:   FastMCP --[DISPATCHES_TOOL_INVOCATION]--> _call_tool_with_oauth_errors                                   |
|              Boundary: Tool Surface Ingress Gate [INTERNAL_SUBSYSTEM]                                                  |
|     Step 4:   _call_tool_with_oauth_errors --[DISPATCHES_TOOL]--> forget tool                                          |
|              Boundary: MCP Tool Dispatch Handler [PUBLIC_BOUNDARY]                                                     |
|     Step 5:   forget tool --[CALLS]--> Identity Context Resolver                                                       |
|              Boundary: Identity & Authentication Context [INTERNAL_SUBSYSTEM]                                          |
|     Step 6:   forget tool --[CALLS]--> Workspace Setup Gate                                                            |
|              Boundary: Workspace Initialization Gate [INTERNAL_SUBSYSTEM]                                              |
|     Step 7:   forget tool --[CALLS]--> Memory Manager Core Engine                                                      |
|              Boundary: Core Memory Management [INTERNAL_SUBSYSTEM]                                                     |
|     Step 8:   Memory Manager Core Engine --[CALLS]--> Persistence Storage Engine                                       |
|              Boundary: Persistence Tombstone Engine [INTERNAL_SUBSYSTEM]                                               |
|     Step 9:   Background Lifecycle Daemon --[BATCH_POLICY_EVALUATION]--> Retention Policy Evaluator                    |
|              Boundary: Archive Policy Evaluation [INTERNAL_SUBSYSTEM]                                                  |
|     Step 10:  Background Lifecycle Daemon --[BATCH_POLICY_EVALUATION]--> Importance Decay Evaluator                    |
|              Boundary: Importance Decay Engine [INTERNAL_SUBSYSTEM]                                                    |
|     Step 11:  Hybrid Retrieval Engine --[EXCLUDES_AT_QUERY]--> Database Storage Engine                                 |
|              Boundary: Query-Time Tombstone Filter [INTERNAL_SUBSYSTEM]                                                |
+------------------------------------------------------------------------------------------------------------------------+

Subsystem-Dekomposition und Grenzübergangsklassifizierung

Das System gliedert sich in zehn verifizierte Subsystemknoten, von denen jeder eine strenge Grenzklassifizierung (PUBLIC_BOUNDARY oder INTERNAL_SUBSYSTEM) und einen empirischen Nachweisstatus (SOURCE_BACKED_PUBLIC_CONTRACT / VERIFIED, CONCEPTUAL_DELEGATED oder NOT_VERIFIED) trägt:

• NODE_1_CLIENT_AGENT_LAYER: Client- und Agenten-Ökosystem (@xmemo/client, Claude Desktop, Cursor, Codex) — Klassifizierung: [PUBLIC_BOUNDARY] — Nachweisstatus: [SOURCE_BACKED_PUBLIC_CONTRACT (VERIFIED)].
• NODE_2_TRANSPORT_ADAPTER: MCP-Transport- und Protokolladapter (MemoryOSMcpMountAdapter, mount_streamable_mcp) — Klassifizierung: [PUBLIC_BOUNDARY] — Nachweisstatus: [SOURCE_BACKED_PUBLIC_CONTRACT (VERIFIED)].
• NODE_3_IDENTITY_AUTH_GATE: Identitäts- und Autorisierungs-Gateway (_call_tool_with_oauth_errors, install_mcp_tool_surface) — Klassifizierung: [PUBLIC_BOUNDARY] — Nachweisstatus: [SOURCE_BACKED_PUBLIC_CONTRACT (VERIFIED)].
• NODE_4_SANITIZATION_ENVELOPE: PII-Bereinigung und Tresorumschlag (sanitize_server_write, enforce_memory_write_envelope) — Klassifizierung: [INTERNAL_SUBSYSTEM] — Nachweisstatus: [SOURCE_BACKED_PUBLIC_CONTRACT (VERIFIED)].
• NODE_5_SCOPE_ISOLATION_GUARD: Scope- und Mandanten-Isolationswächter (BoundSpace, assert_requested_team_matches_bound_space) — Klassifizierung: [INTERNAL_SUBSYSTEM] — Nachweisstatus: [SOURCE_BACKED_PUBLIC_CONTRACT (VERIFIED)].
• NODE_6_SEARCH_TEMPORAL_PARSER: Such- und Temporal-Abfrage-Parser (TemporalQuerySpec, extract_temporal_context) — Klassifizierung: [INTERNAL_SUBSYSTEM] — Nachweisstatus: [SOURCE_BACKED_PUBLIC_CONTRACT (VERIFIED)].
• NODE_7_CANDIDATE_SCORER: Kandidaten-Bewerter und Reranker (SearchEngine.rerank_recall_results) — Klassifizierung: [INTERNAL_SUBSYSTEM] — Nachweisstatus: [SOURCE_BACKED_PUBLIC_CONTRACT (VERIFIED)].
• NODE_8_VERSION_LIFECYCLE_ENGINE: Versions- und Lebenszyklus-Controller (VersionController.superseded_snapshot) — Klassifizierung: [INTERNAL_SUBSYSTEM] — Nachweisstatus: [SOURCE_BACKED_PUBLIC_CONTRACT (VERIFIED)].
• NODE_9_CONTEXT_BUDGET_ASSEMBLER: Kontextbudget-Assembler (_apply_recall_response_budget) — Klassifizierung: [INTERNAL_SUBSYSTEM] — Nachweisstatus: [SOURCE_BACKED_PUBLIC_CONTRACT (VERIFIED)].
• NODE_10_PUBLIC_RECEIPT_CITATION: Öffentlicher Beleg- und Zitat-Formatierer (_public_recall_meta) — Klassifizierung: [PUBLIC_BOUNDARY] — Nachweisstatus: [SOURCE_BACKED_PUBLIC_CONTRACT (VERIFIED)].

Grenze zwischen Open Source und verwaltetem Cloud-Service

Öffentliche Architekturaussagen werden anhand des Codevertrags bewertet und streng als VERIFIED oder NOT_VERIFIED eingestuft:

• STMT_01_PROVENANCE_ATTRIBUTION [VERIFIED]: XMemo erfasst operative Audit-Protokolle, behält den Versionsverlauf (memory_versions) bei und wendet Verschlüsselungsumschläge an, wenn der Keyguard-/Vault-Modus aktiviert ist. Architektur: Kryptografischer Sicherheitsumschlag.
• STMT_02_CROSS_CLIENT_CONTINUITY [VERIFIED]: Erfasste Erinnerungen sind über Standard-JSON-RPC sofort auf jedem MCP-konformen Client verfügbar. Architektur: Streamfähiger FastMCP-ASGI-Adapter.
• STMT_03_REALTIME_CORRECTION [VERIFIED]: Faktenaktualisierungen behalten eine unveränderliche Versionshistorie bei und ersetzen frühere widersprüchliche Erinnerungen. Architektur: Unveränderlicher Versions-DAG-Controller.
• STMT_04_TOKEN_BUDGET_GUARANTEE [VERIFIED]: Die Kontextinjektion hält die vom Aufrufer vorgegebenen Token- und Byte-Budgets strikt ein. Architektur: Deterministischer Token-Budget-Assembler.
• STMT_05_ZERO_TOKEN_EXPOSURE [VERIFIED]: Nicht authentifizierte Anfragen werden am Gateway sofort abgewiesen, ohne Tokens preiszugeben. Architektur: Ingress-Authentifizierung und Scope-Isolations-Gate.
• STMT_06_BACKEND_OPEN_SOURCE_CLAIM [NOT_VERIFIED]: Die Behauptung eines 100%igen Open-Source-Backends wird WIDERLEGT. Nur Client-Pakete (@xmemo/client) und lokale MCP-Adapter sind Open Source. Die mandantenfähige Cloud-Infrastruktur ist proprietär.
• STMT_07_AUTONOMOUS_CONSENSUS_CLAIM [NOT_VERIFIED]: Autonomer organisationsübergreifender Konsens wird WIDERLEGT. Mandantenisolierung wird über BoundSpace strikt durchgesetzt; keine automatische Zusammenführung.
• STMT_08_ZERO_LATENCY_REPLICATION_CLAIM [NOT_VERIFIED]: Die Behauptung einer globalen Replikation mit Null-Latenz wird WIDERLEGT. Die Suche verwendet lokale Vektorindizes; Null-Latenz wird nicht garantiert.

Reproduzierbarer Architektur-Lebenszyklus-Walkthrough (Synthetisches A/B-Beispiel)

Ein schrittweiser, überprüfbarer Lebenszyklus-Walkthrough, der das anwendungsübergreifende Teilen von Erinnerungen, Mandantenisolierung, Benutzerkorrektur in Echtzeit und unveränderliche Herkunftsnachverfolgung anhand streng synthetischer Demodaten demonstriert:

• Step 1 [AGENT_A_WRITE]: Agent A (ide-assistant-alpha) schreibt synthetische Präferenz über remember tool in den Gültigkeitsbereich project:synthetic-demo — Payload: {'formatting': 'tabs', 'indent': 4} — Claim: [STMT_01_PROVENANCE_ATTRIBUTION] & [STMT_02_CROSS_CLIENT_CONTINUITY] — Receipt: mem-synth-pref-001@v1, digest sha256:7f83b165 — Status: [SOURCE_BACKED_PUBLIC_CONTRACT (VERIFIED)] — Boundary: [DEMO_DATA: SYNTHETIC].
• Step 2 [AGENT_B_RECALL]: Agent B (terminal-assistant-beta) ruft Präferenz innerhalb des autorisierten Bereichs project:synthetic-demo über recall tool ab — Query: 'code formatting indent' — Claim: [STMT_02_CROSS_CLIENT_CONTINUITY] & [STMT_04_TOKEN_BUDGET_GUARANTEE] — Receipt: mem-synth-pref-001@v1 cited, score 0.94, bounded budget — Status: [SOURCE_BACKED_PUBLIC_CONTRACT (VERIFIED)] — Boundary: [DEMO_DATA: SYNTHETIC].
• Step 3 [UNAUTHORIZED_DENIAL]: Nicht autorisierter Agent (rogue-guest-gamma) versucht mandantenübergreifenden Zugriff auf project:synthetic-demo ohne gültige Anmeldedaten — Gate: Scope Isolation & Auth Gateway — Claim: [STMT_05_ZERO_TOKEN_EXPOSURE] — Outcome: AUTH_SCOPE_DENIED (HTTP 403), zero data leakage, zero storage mutation verified by database snapshot byte equality — Status: [SOURCE_BACKED_PUBLIC_CONTRACT (VERIFIED)] — Boundary: [DEMO_DATA: SYNTHETIC].
• Step 4 [USER_CORRECTION]: Benutzer korrigiert Formatierungsstandard über update_memory tool — Payload: {'formatting': 'spaces', 'indent': 2}, reason: 'team style guide update' — Controller: Version DAG Controller — Claim: [STMT_03_REALTIME_CORRECTION] — Receipt: mem-synth-pref-001@v2, supersedes v1, parent_digest sha256:7f83b165 — Status: [SOURCE_BACKED_PUBLIC_CONTRACT (VERIFIED)] — Boundary: [DEMO_DATA: SYNTHETIC].
• Step 5 [LATER_RECALL_V2]: Nachfolgende Abfrage wählt automatisch die aktualisierte Version 2 aus, während SearchEngine die ersetzte Version 1 strikt ausschließt — Query: 'indentation preference' — Claim: [STMT_03_REALTIME_CORRECTION] & [STMT_04_TOKEN_BUDGET_GUARANTEE] — Outcome: Active recall context injects only v2 (spaces, 2) — Status: [SOURCE_BACKED_PUBLIC_CONTRACT (VERIFIED)] — Boundary: [DEMO_DATA: SYNTHETIC].
• Step 6 [PROVENANCE_DAG]: Audit-Inspektion des Versionsverlaufs über Version Controller — Chain: v1 (initial write by ide-assistant-alpha) -> v2 (superseded_by user correction) — Claim: [STMT_01_PROVENANCE_ATTRIBUTION] — Verification: Versionsverlauf und übergeordnete Zeiger vollständig einsehbar — Status: [SOURCE_BACKED_PUBLIC_CONTRACT (VERIFIED)] — Boundary: [DEMO_DATA: SYNTHETIC].
• Step 7 [STATE_RESET]: Zurücksetzbare Sandbox-Steuerelemente stellen den synthetischen Bereich project:synthetic-demo auf den sauberen Ausgangszustand zurück — Action: Deterministischer Abbau und Bereinigung — Claim: [STMT_05_ZERO_TOKEN_EXPOSURE] — Receipt: reset_status CLEARED, 0 residual rows, zero persistent side effects — Status: [SOURCE_BACKED_PUBLIC_CONTRACT (VERIFIED)] — Boundary: [DEMO_DATA: SYNTHETIC].
• Boundary Notice [NOT_VERIFIED]: Cloud-Abrechnungspipelines für mehrere Mandanten [STMT_06_BACKEND_OPEN_SOURCE_CLAIM], autonomer Konsens zwischen Organisationen [STMT_07_AUTONOMOUS_CONSENSUS_CLAIM] und globale Replikation ohne Latenz [STMT_08_ZERO_LATENCY_REPLICATION_CLAIM] sind [NOT_VERIFIED] und von diesem lokalen Open-Source-Durchlauf ausgeschlossen.

+------------------------------------------------------------------------------------------------------------------------+
| [REPRODUCIBLE ARCHITECTURE LIFECYCLE WALKTHROUGH: SYNTHETIC A/B PREFERENCE SHARING & CORRECTION]                       |
|                                                                                                                        |
|  Agent A (IDE)               XMemo Gateway & Engines            Agent B (CLI)              Unauthorized Agent (Guest)  |
|  [ide-assistant-alpha]       [FastMCP / Storage / Scope]        [terminal-assistant-beta]  [rogue-guest-gamma]         |
|         |                               |                              |                              |                |
|  (1) remember(pref: tabs, 4)            |                              |                              |                |
|  -------------------------------------> |                              |                              |                |
|         |                          [Write v1, Hash: 7f83b1]            |                              |                |
|  <------------------------------------- |                              |                              |                |
|    Receipt: mem-001@v1                  |                              |                              |                |
|         |                               |      (2) recall(pref)        |                              |                |
|         |                               | <--------------------------- |                              |                |
|         |                               |  [Scope Match: synth-demo]   |                              |                |
|         |                               | ---------------------------> |                              |                |
|         |                               |   Citation: mem-001@v1       |                              |                |
|         |                               |                              |   (3) recall(foreign tenant) |                |
|         |                               | <---------------------------------------------------------- |                |
|         |                               |                          [BoundSpace Check: MISMATCH]       |                |
|         |                               | ----------------------------------------------------------> |                |
|         |                               |                          DENIED: AUTH_SCOPE_DENIED (Zero Mutation)           |
|         |                               |                              |                              |                |
|  (4) update_memory(pref: spaces, 2)     |                              |                              |                |
|  -------------------------------------> |                              |                              |                |
|         |                          [Write v2, parent: v1]              |                              |                |
|  <------------------------------------- |                              |                              |                |
|    Receipt: mem-001@v2 (supersedes v1)  |                              |                              |                |
|         |                               |      (5) recall(pref)        |                              |                |
|         |                               | <--------------------------- |                              |                |
|         |                               |  [Exclude v1, Select v2]     |                              |                |
|         |                               | ---------------------------> |                              |                |
|         |                               |   Citation: mem-001@v2       |                              |                |
|         |                               |                              |                              |                |
|  (6) inspect_provenance(mem-001)        |                              |                              |                |
|  -------------------------------------> |                              |                              |                |
|  <------------------------------------- |                              |                              |                |
|    DAG: v1 (Hash: 7f83) -> v2 (Hash: 4d82)                             |                              |                |
|         |                               |                              |                              |                |
|  (7) reset_synthetic_state()            |                              |                              |                |
|  -------------------------------------> | [Purge demo scope]           |                              |                |
|  <------------------------------------- | 0 residual rows              |                              |                |
+------------------------------------------------------------------------------------------------------------------------+

Vertiefte Konzepte und Sicherheitsnavigation

Erkunden Sie spezifische Architekturbereiche in unserer Dokumentation zu Konzepten und Sicherheit:

• Speicherdatenmodell (/docs/concepts/memory-model): Entitätsstrukturen, semantische Kategorien, Wichtigkeitswerte und Repräsentationsschichten.
• Herkunft und Zurechnung (/docs/concepts/provenance-attribution): Prüfprotokolle und Aufruferzurechnung.
• Projekt-Speicherräume (/docs/concepts/projects): Verifizierte Projektzuordnung durch Workspace-Pfad-Routing und persönliche Projektgrenzenisolierung.
• Dream- und Speicherkonsolidierung (/docs/concepts/dream-reflection): Konsolidierung der Kandidatenvorschau, explizite Zielüberprüfung und Wartungsrichtlinien.
• Externe Wissensdatenbanken (/docs/concepts/knowledge-bases): Dokumentenindizierung, Chunking-Strategien und Referenzzitate.
• Datengrenze und Sicherheit (/docs/security/data-boundary): Umfassende Abgrenzung zwischen selbst gehosteten Funktionen und Cloud-SaaS-Diensten.