Matrix Bot Konsolidierung, Voice Support & Manalink PWA

Intensiver Tag (und Nacht!) mit 52 Commits - der Fokus lag auf der Konsolidierung der Matrix Bot Infrastruktur:

• @manacore/matrix-bot-common - Neues Shared Package für alle 19 Matrix Bots
• Voice Support - 4-Phasen-Implementierung für Voice Input/Output im mana-mana-bot
• Manalink PWA - Rebrand des Matrix Web Clients mit PWA-Support
• Telegram Removal - Migration zu Matrix-only Strategie
• mana-media MVP - Unified Media Processing Platform
• Docker Restructure - Neues Port-Schema und Naming Convention

@manacore/matrix-bot-common

Neues Shared Package, das gemeinsame Funktionalität für alle Matrix Bots bereitstellt.

Komponenten

packages/matrix-bot-common/
├── src/
│   ├── base/
│   │   └── BaseMatrixService.ts      # Abstrakte Basisklasse
│   ├── health/
│   │   └── HealthController.ts       # Shared Health Endpoint
│   ├── utils/
│   │   ├── KeywordCommandDetector.ts # Command Detection ohne !
│   │   └── UserListMapper.ts         # User-Formatierung
│   └── index.ts
└── package.json

BaseMatrixService

Abstrakte Basisklasse mit Matrix-Verbindungslogik:

export abstract class BaseMatrixService implements OnModuleInit {
	protected client: MatrixClient;

	async onModuleInit() {
		this.client = new MatrixClient(this.config.homeserverUrl, this.config.accessToken);
		await this.client.start();
		this.client.on('room.message', this.handleMessage.bind(this));
	}

	protected abstract handleMessage(roomId: string, event: any): Promise<void>;
}

KeywordCommandDetector

Erkennt natürlichsprachliche Befehle ohne !-Prefix:

const detector = new KeywordCommandDetector({
	keywords: ['todo', 'aufgabe', 'task'],
	patterns: [/(?:erinnere mich|remind me)/i],
});

// "Füge Einkaufen zur Todo-Liste" → detected
// "Was steht auf meiner Aufgabenliste?" → detected

Migration

Alle 19 Matrix Bots wurden migriert:

Voice Support für matrix-mana-bot

4-Phasen-Implementierung von Voice Input/Output.

Phase 1: Voice Input

// Sprachnachrichten via mana-stt transkribieren
async handleVoiceMessage(event: MatrixEvent): Promise<string> {
  const audioUrl = event.content.url;
  const audioBuffer = await this.downloadMedia(audioUrl);
  const transcription = await this.sttClient.transcribe(audioBuffer);
  return transcription.text;
}

Phase 2: Voice Output (TTS)

// Text-zu-Sprache für Antworten
async sendVoiceReply(roomId: string, text: string): Promise<void> {
  const audioBuffer = await this.ttsClient.synthesize(text, {
    voice: 'de-DE-FlorianNeural',
    speed: 1.0,
  });
  await this.client.sendAudio(roomId, audioBuffer, 'response.mp3');
}

Phase 3: Smart Voice Formatting

Intelligente Aufbereitung von Text für Sprachausgabe:

Phase 4: Persistent Voice Preferences

// User-Präferenzen in Redis speichern
interface VoicePreferences {
	enabled: boolean;
	voice: string;
	speed: number;
	autoTranscribe: boolean;
}

await this.redis.hset(`voice:${userId}`, preferences);

Manalink PWA

Rebrand des Matrix Web Clients zu “Manalink” mit PWA-Support.

PWA-Features

Manifest

{
	"name": "Manalink",
	"short_name": "Manalink",
	"description": "ManaCore Matrix Client",
	"start_url": "/",
	"display": "standalone",
	"theme_color": "#6366f1",
	"background_color": "#0f172a"
}

UX-Änderungen

• SSO als primärer Login (manueller Login versteckt)
• Vereinfachte Login-Seite
• Dark Mode als Default

Telegram Removal

Strategische Entscheidung: Fokus auf Matrix als einzige Chat-Plattform.

Entfernte Services

services/
├── telegram-ollama-bot/        # ENTFERNT
├── telegram-project-doc-bot/   # ENTFERNT
├── telegram-nutriphi-bot/      # ENTFERNT
├── telegram-todo-bot/          # ENTFERNT
└── telegram-zitare-bot/        # ENTFERNT

Begründung

mana-media MVP

Unified Media Processing Platform für alle ManaCore Apps.

Features

services/mana-media/
├── src/
│   ├── processing/
│   │   ├── image.service.ts     # Resize, Crop, Format
│   │   ├── video.service.ts     # Transcode, Thumbnail
│   │   └── audio.service.ts     # Convert, Normalize
│   ├── storage/
│   │   └── s3.service.ts        # MinIO/S3 Storage
│   └── metadata/
│       └── exif.service.ts      # EXIF Extraction
└── Dockerfile

API Endpoints

Docker Restructure

Neue Port-Schema und Naming Convention für alle Services.

Port Ranges

Naming Convention

# Vorher
container_name: chat-backend
container_name: todo-backend

# Nachher
container_name: mana-chat-backend
container_name: mana-todo-backend

Bot Services Consolidation

Konsolidierung von SessionService und TranscriptionService.

@manacore/bot-services Updates

// Vorher: In jedem Bot
class SessionService {
	private sessions = new Map();
}

// Nachher: Shared Package
import { SessionService } from '@manacore/bot-services';

Shared Services

Model Comparison Feature

Neues Feature im LLM Playground für Modellvergleiche.

UI

// Gleichzeitig mehrere Modelle abfragen
const models = ['gemma3:4b', 'llama3.2:3b', 'mistral:7b'];
const responses = await Promise.all(models.map((model) => llmClient.chat(model, prompt)));

Metriken

Grafana & Prometheus Fixes

Zahlreiche Fixes für das Monitoring-System.

Fixes

Bugfixes

Zusammenfassung

Nächste Schritte

1. Matrix E2EE aktivieren
2. Voice Preferences UI im Manalink Client
3. mana-media mit NutriPhi integrieren
4. Matrix Bots CI/CD Pipeline