feat(brain): Anhaenge an Memory-Eintraege (Stufe A — Backend)

Pro Memory koennen jetzt Dateien (Bilder, PDFs, Sound, ...) angehaengt
werden. Use-Case: Stefan sagt "ich hab eine Cessna 172" und pinnt
gleich ein Foto dran — ARIA sieht spaeter neben dem Memory auch die
visuelle Referenz (Stufe E = Multi-Modal-Pipeline).

Stufe A baut nur den Backend-Layer; UI kommt in Stufe B (Diagnostic)
und C (App). Anhaenge werden in Stufe A nur via HTTP-API gepflegt
(curl), ARIA selbst kann sie noch nicht hochladen — sinnvoll erst
wenn die Vision-Pipeline (Stufe E) steht.

Komponenten:

- memory_attachments.py: neuer Storage-Helper. Layout
  /shared/memory-attachments/<memory-id>/<safe-filename>.
  Filename-Sanitization (kein Path-Traversal), Limit 20 MB
  konfigurierbar, save/list/delete/read_bytes + delete_all fuer
  Cleanup beim Memory-Delete.

- vector_store.py: MemoryPoint.attachments (List[dict]) — Metadaten
  {name, mime, size, path} im Qdrant-Payload damit Suche/Anzeige
  sie ohne Filesystem-Lookup kennt.

- main.py:
  - MemoryIn akzeptiert attachments-Liste (fuer Restore-Faelle)
  - MemoryOut liefert attachments
  - GET    /memory/{id}/attachments              → Liste vom FS
  - POST   /memory/{id}/attachments              → Base64-Upload,
            schreibt FS + updated Payload-Liste
  - DELETE /memory/{id}/attachments/{filename}   → FS + Payload-Eintrag weg
  - GET    /memory/{id}/attachments/{filename}   → Bytes mit MIME serve
  - /memory/delete cleanup: ruft attachments.delete_all damit kein
    Verzeichnis verwaist

Smoke-Test nach Brain-Rebuild (Stefan auf VM):
  # Memory-ID rauspicken
  ID=$(curl -s "$ARIA_BRAIN_URL/memory/list?type=fact" | python3 -c "import sys,json;print(json.load(sys.stdin)[0]['id'])")
  # Bild als Base64 hochladen
  B64=$(base64 -w0 /pfad/zu/foto.jpg)
  curl -s -X POST "$ARIA_BRAIN_URL/memory/$ID/attachments" \
    -H 'Content-Type: application/json' \
    -d "{\"name\":\"foto.jpg\",\"data_base64\":\"$B64\"}" | jq
  # Liste anzeigen
  curl -s "$ARIA_BRAIN_URL/memory/$ID/attachments" | jq
  # Datei wieder laden
  curl -s "$ARIA_BRAIN_URL/memory/$ID/attachments/foto.jpg" -o /tmp/back.jpg

Stufe B (Diagnostic-UI) folgt sobald A getestet ist.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

aria-brain/memory_attachments.py

@@ -0,0 +1,137 @@
+"""
+Anhaenge fuer Memory-Eintraege.
+
+Storage-Layout:
+    /shared/memory-attachments/<memory-id>/<original-name>
+
+Eine flache Ordnerstruktur pro Memory — bei Memory-Delete loescht main.py
+das ganze Verzeichnis. Anhang-Metadaten (name, mime, size, path) liegen
+zusaetzlich im Qdrant-Payload des Memory-Punkts damit die Listen/Suche
+sie ohne Filesystem-Lookup zeigen kann.
+
+Anhaenge sind erstmal nur ueber die Diagnostic-UI hochladbar — ARIA
+selbst hat in Stufe A kein Tool zum Upload.
+"""
+
+from __future__ import annotations
+
+import base64
+import logging
+import mimetypes
+import os
+import re
+import shutil
+from pathlib import Path
+from typing import List, Optional
+
+logger = logging.getLogger(__name__)
+
+ROOT = Path(os.environ.get("MEMORY_ATTACHMENTS_DIR", "/shared/memory-attachments"))
+MAX_BYTES = int(os.environ.get("MEMORY_ATTACHMENT_MAX_BYTES", str(20 * 1024 * 1024)))  # 20 MB
+SAFE_NAME_RE = re.compile(r"[^A-Za-z0-9._\-]")
+
+
+def _safe_filename(name: str) -> str:
+    """Macht aus einem User-Namen einen filesystem-sicheren String —
+    zerlegt Pfadteile, schneidet Sonderzeichen weg, kuerzt auf 120 Zeichen."""
+    base = Path(name).name or "datei"
+    base = SAFE_NAME_RE.sub("_", base).strip("._-") or "datei"
+    return base[:120]
+
+
+def memory_dir(memory_id: str) -> Path:
+    return ROOT / memory_id
+
+
+def list_attachments(memory_id: str) -> List[dict]:
+    """Liest die Anhaenge fuer eine Memory aus dem Filesystem.
+    Returns [{name, mime, size, path}, ...] — leer wenn nichts da.
+    Source of Truth ist Qdrant-Payload; diese Funktion ist nur fuer
+    Diagnostic-Endpoints wenn Stefan direkt das FS prueft."""
+    d = memory_dir(memory_id)
+    if not d.is_dir():
+        return []
+    out = []
+    for f in sorted(d.iterdir()):
+        if not f.is_file():
+            continue
+        out.append(_file_meta(memory_id, f))
+    return out
+
+
+def _file_meta(memory_id: str, f: Path) -> dict:
+    try:
+        size = f.stat().st_size
+    except Exception:
+        size = 0
+    mime = mimetypes.guess_type(f.name)[0] or "application/octet-stream"
+    return {
+        "name": f.name,
+        "mime": mime,
+        "size": size,
+        "path": str(f),  # absoluter Pfad im Container
+    }
+
+
+def save_attachment(memory_id: str, filename: str, data: bytes) -> dict:
+    """Schreibt einen Anhang ins FS und gibt seine Metadaten zurueck.
+    Ueberschreibt eine bestehende Datei mit gleichem Namen."""
+    if not memory_id:
+        raise ValueError("memory_id ist Pflicht")
+    if len(data) > MAX_BYTES:
+        raise ValueError(f"Anhang zu gross ({len(data)} > {MAX_BYTES} Byte)")
+    safe = _safe_filename(filename)
+    d = memory_dir(memory_id)
+    d.mkdir(parents=True, exist_ok=True)
+    target = d / safe
+    target.write_bytes(data)
+    logger.info("[mem-att] %s -> %s (%d Byte)", memory_id, safe, len(data))
+    return _file_meta(memory_id, target)
+
+
+def save_from_base64(memory_id: str, filename: str, b64: str) -> dict:
+    """Convenience fuer Base64-Uploads (Diagnostic schickt Files so)."""
+    try:
+        data = base64.b64decode(b64, validate=False)
+    except Exception as exc:
+        raise ValueError(f"Base64-Decode fehlgeschlagen: {exc}") from exc
+    return save_attachment(memory_id, filename, data)
+
+
+def delete_attachment(memory_id: str, filename: str) -> bool:
+    """Loescht eine einzelne Anhang-Datei. Returns True wenn was weg ist."""
+    safe = _safe_filename(filename)
+    target = memory_dir(memory_id) / safe
+    if not target.is_file():
+        return False
+    try:
+        target.unlink()
+        logger.info("[mem-att] %s/%s geloescht", memory_id, safe)
+        return True
+    except Exception as exc:
+        logger.warning("[mem-att] Loeschen fehlgeschlagen: %s", exc)
+        return False
+
+
+def delete_all(memory_id: str) -> int:
+    """Loescht das komplette Memory-Verzeichnis. Wird beim Memory-Delete
+    in main.py gerufen damit nichts verwaist."""
+    d = memory_dir(memory_id)
+    if not d.is_dir():
+        return 0
+    count = sum(1 for _ in d.iterdir() if _.is_file())
+    try:
+        shutil.rmtree(d)
+        logger.info("[mem-att] %s komplett entfernt (%d Files)", memory_id, count)
+    except Exception as exc:
+        logger.warning("[mem-att] rmtree fehlgeschlagen: %s", exc)
+    return count
+
+
+def read_bytes(memory_id: str, filename: str) -> Optional[bytes]:
+    """Liefert die rohen Bytes einer Datei zurueck — fuer Download/Serve."""
+    safe = _safe_filename(filename)
+    target = memory_dir(memory_id) / safe
+    if not target.is_file():
+        return None
+    return target.read_bytes()