feat(ai): P1.3 `IDataSource`-Interface + Adapter für Mails, Listen, Notizen #441

New issue

Closed

opened 2026-06-06 16:28:53 +02:00 by pm-bot · 1 comment

pm-bot commented

2026-06-06 16:28:53 +02:00

Collaborator

Phase-1-Sub-Issue zu #122 (Decision Record 2026-06-06).

Ziel

Abstraktes IDataSource-Interface in @mrrmlab/shared-types (oder neuer Package @mrrmlab/ai-core) definieren — Folge-Effekt 6 aus #438: damit Day-Planner (#360), Wissensbasis (#258), Urlaubs-Modul (#323) später ohne Pipeline-Umbau plugbar sind.

Scope

TypeScript-Interface:

interface IDataSource {
  readonly sourceType: string;                       // 'mail' | 'shopping-list' | 'note' | ...
  extractChunks(sourceId: string): Promise<Chunk[]>; // Text-Splitting + Metadaten
  getIndexKey(sourceId: string): string;             // stabile ID für Vec-Tabelle
  subscribeToUpdates(): Observable<UpdateEvent>;     // Re-Indexing-Trigger
}
interface Chunk { text: string; metadata: Record<string, unknown>; }
interface UpdateEvent { sourceId: string; kind: 'created'|'updated'|'deleted'; }

Drei Adapter-Implementierungen:
- MailDataSource — liest aus bestehender Mail-DB-Tabelle, chunked nach Mail-Body (z.B. ~500 char Splits).
- ShoppingListDataSource — chunked nach Listen-Item-Gruppen.
- NoteDataSource — chunked nach Note-Body (Markdown-Sections).
Re-Indexing-Trigger: TanStack-Query-Cache-Invalidation als subscribeToUpdates-Quelle (oder Drizzle-Subscriber-Pattern).

Akzeptanzkriterien

Interface in @mrrmlab/shared-types (oder neuem Package) exportiert.
Drei Adapter implementiert + Vitest-Suite je Adapter mit mocked DB-Daten.
DataSource-Registry-Pattern: dataSources.register(adapter) für spätere Erweiterung.
Update-Event-Stream funktional verifiziert (Insert→Event, Update→Event, Delete→Event).

Out-of-Scope

Konkrete Indexierung (P1.4)
Suche (P1.5)
Web-Implementation der Adapter (folgt in Web-Sub-Epic)

Phase-1-Sub-Issue zu #122 (Decision Record 2026-06-06). ## Ziel Abstraktes `IDataSource`-Interface in `@mrrmlab/shared-types` (oder neuer Package `@mrrmlab/ai-core`) definieren — Folge-Effekt 6 aus #438: damit Day-Planner (#360), Wissensbasis (#258), Urlaubs-Modul (#323) später ohne Pipeline-Umbau plugbar sind. ## Scope - TypeScript-Interface: ```ts interface IDataSource { readonly sourceType: string; // 'mail' | 'shopping-list' | 'note' | ... extractChunks(sourceId: string): Promise<Chunk[]>; // Text-Splitting + Metadaten getIndexKey(sourceId: string): string; // stabile ID für Vec-Tabelle subscribeToUpdates(): Observable<UpdateEvent>; // Re-Indexing-Trigger } interface Chunk { text: string; metadata: Record<string, unknown>; } interface UpdateEvent { sourceId: string; kind: 'created'|'updated'|'deleted'; } ``` - Drei Adapter-Implementierungen: - `MailDataSource` — liest aus bestehender Mail-DB-Tabelle, chunked nach Mail-Body (z.B. ~500 char Splits). - `ShoppingListDataSource` — chunked nach Listen-Item-Gruppen. - `NoteDataSource` — chunked nach Note-Body (Markdown-Sections). - Re-Indexing-Trigger: TanStack-Query-Cache-Invalidation als `subscribeToUpdates`-Quelle (oder Drizzle-Subscriber-Pattern). ## Akzeptanzkriterien - [ ] Interface in `@mrrmlab/shared-types` (oder neuem Package) exportiert. - [ ] Drei Adapter implementiert + Vitest-Suite je Adapter mit mocked DB-Daten. - [ ] DataSource-Registry-Pattern: `dataSources.register(adapter)` für spätere Erweiterung. - [ ] Update-Event-Stream funktional verifiziert (Insert→Event, Update→Event, Delete→Event). ## Out-of-Scope - Konkrete Indexierung (P1.4) - Suche (P1.5) - Web-Implementation der Adapter (folgt in Web-Sub-Epic)

pm-bot added the

labels

2026-06-06 16:28:53 +02:00

pm-bot referenced this issue

2026-06-06 16:29:07 +02:00

[Epic] Persönlicher KI-Assistent — Privacy-First On-Device Architektur #122

admin-mrrm referenced this issue from a commit

2026-06-06 17:06:22 +02:00

feat(shared-types,mobile): IDataSource interface + 3 Adapter — P1.3 / #441

pm-bot referenced this issue

2026-06-06 17:50:44 +02:00

feat(mobile): wire up AI-foundation Phase 1 (#122) #444

pm-bot commented

2026-06-06 17:57:31 +02:00

Author

Collaborator

Implementation komplett — integriert in PR #444 (wireup/ai-foundation-phase1). Device-Pass läuft am übergeordneten Epic #122. Issue wird geschlossen.

Implementation komplett — integriert in PR #444 (`wireup/ai-foundation-phase1`). Device-Pass läuft am übergeordneten Epic #122. Issue wird geschlossen.

pm-bot closed this issue

2026-06-06 17:57:32 +02:00

~~pm-bot referenced this issue 2026-06-08 19:42:20 +02:00~~

feat(api): gate X-Dev-User bypass on ALLOW_DEV_USER_HEADER env #446

pm-bot referenced this issue

2026-06-08 22:42:27 +02:00

Portfolio-Status KW 2026-W23 #436

pm-bot referenced this issue

2026-06-08 22:45:21 +02:00

[Epic] Persönlicher KI-Assistent — Privacy-First On-Device Architektur #122