feat(library): add Bibliothek module — books/movies/series/comics log

M1 skeleton for a new media-consumption module. Single-table design with a `kind: 'book' | 'movie' | 'series' | 'comic'` discriminator and a discriminated `details` union for kind-specific fields (pages / runtime / episode tracker / issue count). Shared kern: status, rating, review, favourites, times counter, completedAt — which enables cross-media queries like a year-in-review. Dexie migration v26 was already registered in module-registry.ts / database.ts via the preceding wetter commit (62aac6dfd); this commit adds the actual module code, encryption registry entry, app-icon, MANA_APPS entry, Kreativität & Medien category row, and the module plan at docs/plans/library-module.md. Encrypted fields (via ENCRYPTION_REGISTRY): title, originalTitle, creators, review, tags Plaintext (intentional): kind, status, year, rating, genres, completedAt, isFavorite, times, externalIds, details — all needed for the tab filter, status chips, Jahresrückblick range-scan, and progress UIs. Product decisions (frozen in the plan): - audiobooks = kind='book' with details.format='audio' - manga = kind='comic' (no sub-discriminator) - metadata lookup (M7) lands as an endpoint in apps/api, not a standalone service Guest seed ships one example per kind (Dune, Arrival, Severance, Saga) so first-run users immediately see what the module does. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-14 22:21:10 +02:00 · 2026-04-17 03:49:01 +02:00 · 2026-04-17 03:49:01 +02:00 · 8c6502d0ff
commit 8c6502d0ff
parent 62aac6dfdb
14 changed files with 996 additions and 2 deletions
--- a/apps/mana/apps/web/src/lib/data/crypto/registry.ts
+++ b/apps/mana/apps/web/src/lib/data/crypto/registry.ts
@ -518,6 +518,25 @@ export const ENCRYPTION_REGISTRY: Record<string, EncryptionConfig> = {
 	// and belong under encryption. Policy + budgets + state are pure
 	// structural fields.
 	agents: { enabled: true, fields: ['systemPrompt', 'memory'] },
+
+	// ─── Library ─────────────────────────────────────────────
+	// Reading / watching log with a kind discriminator (book / movie /
+	// series / comic) in one table. User-typed text (title, original
+	// title, creators, review, tags) is encrypted; structural fields
+	// (kind, status, year, rating, completedAt, genres, isFavorite,
+	// times, externalIds, details) stay plaintext — they drive the
+	// tab filter, the status chips, the Jahresrückblick query, and
+	// the episode/page progress UI.
+	//
+	// `details` is the discriminated union and sometimes carries
+	// free-text (publisher, director). Those are factual metadata,
+	// not user-typed reflection, so they ship plaintext alongside the
+	// other structural fields. If a future feature adds free-text
+	// notes *inside* details, add that specific path here.
+	libraryEntries: {
+		enabled: true,
+		fields: ['title', 'originalTitle', 'creators', 'review', 'tags'],
+	},
 };

 /**
--- a/apps/mana/apps/web/src/lib/modules/library/ListView.svelte
+++ b/apps/mana/apps/web/src/lib/modules/library/ListView.svelte
@ -0,0 +1,120 @@
+<!--
+  Library — ListView (M1 skeleton)
+  Minimal placeholder that lists all entries grouped by kind. The full
+  grid + KindTabs + DetailView land in M2.
+-->
+<script lang="ts">
+	import { useAllEntries, groupByKind } from './queries';
+	import { KIND_LABELS, STATUS_LABELS } from './constants';
+	import type { LibraryKind } from './types';
+
+	const entries$ = useAllEntries();
+	const entries = $derived(entries$.value);
+	const grouped = $derived(groupByKind(entries));
+
+	const KIND_ORDER: LibraryKind[] = ['book', 'movie', 'series', 'comic'];
+</script>
+
+<div class="library-shell">
+	<header class="library-header">
+		<h1>Bibliothek</h1>
+		<p class="muted">Bücher, Filme, Serien und Comics — alles an einem Ort.</p>
+	</header>
+
+	{#if entries$.loading}
+		<p class="muted">Lädt…</p>
+	{:else}
+		{#each KIND_ORDER as kind (kind)}
+			{@const list = grouped[kind]}
+			<section class="kind-section">
+				<h2>
+					{KIND_LABELS[kind].emoji}
+					{KIND_LABELS[kind].de}
+					<span class="count">({list.length})</span>
+				</h2>
+				{#if list.length === 0}
+					<p class="muted">Noch keine Einträge.</p>
+				{:else}
+					<ul class="entry-list">
+						{#each list as entry (entry.id)}
+							<li class="entry-row">
+								<span class="entry-title">{entry.title}</span>
+								{#if entry.year}
+									<span class="muted"> · {entry.year}</span>
+								{/if}
+								<span class="badge">{STATUS_LABELS[entry.status].de}</span>
+								{#if entry.rating != null}
+									<span class="rating">{entry.rating.toFixed(1)} ★</span>
+								{/if}
+							</li>
+						{/each}
+					</ul>
+				{/if}
+			</section>
+		{/each}
+	{/if}
+</div>
+
+<style>
+	.library-shell {
+		max-width: 960px;
+		margin: 0 auto;
+		padding: 1.5rem;
+	}
+	.library-header {
+		margin-bottom: 2rem;
+	}
+	.library-header h1 {
+		margin: 0 0 0.25rem 0;
+		font-size: 1.75rem;
+	}
+	.muted {
+		color: var(--color-text-muted, #64748b);
+		font-size: 0.875rem;
+	}
+	.kind-section {
+		margin-bottom: 2rem;
+	}
+	.kind-section h2 {
+		font-size: 1.1rem;
+		margin: 0 0 0.75rem 0;
+		display: flex;
+		align-items: baseline;
+		gap: 0.5rem;
+	}
+	.count {
+		color: var(--color-text-muted, #64748b);
+		font-weight: normal;
+		font-size: 0.9rem;
+	}
+	.entry-list {
+		list-style: none;
+		padding: 0;
+		margin: 0;
+		display: flex;
+		flex-direction: column;
+		gap: 0.25rem;
+	}
+	.entry-row {
+		padding: 0.5rem 0.75rem;
+		border-radius: 0.5rem;
+		background: var(--color-surface, rgba(0, 0, 0, 0.03));
+		display: flex;
+		align-items: center;
+		gap: 0.5rem;
+	}
+	.entry-title {
+		font-weight: 500;
+	}
+	.badge {
+		margin-left: auto;
+		font-size: 0.75rem;
+		padding: 0.15rem 0.5rem;
+		border-radius: 999px;
+		background: var(--color-surface-muted, rgba(0, 0, 0, 0.06));
+	}
+	.rating {
+		font-size: 0.8rem;
+		color: #f59e0b;
+	}
+</style>
--- a/apps/mana/apps/web/src/lib/modules/library/collections.ts
+++ b/apps/mana/apps/web/src/lib/modules/library/collections.ts
@ -0,0 +1,110 @@
+/**
+ * Library module — Dexie accessors and guest seed.
+ *
+ * Table name: `libraryEntries` (single-table design with `kind` discriminator).
+ */
+
+import { db } from '$lib/data/database';
+import type { LocalLibraryEntry } from './types';
+
+export const libraryEntryTable = db.table<LocalLibraryEntry>('libraryEntries');
+
+// ─── Guest Seed ────────────────────────────────────────────
+//
+// One entry per kind so first-run users immediately see what the module is
+// for without needing to create anything. Content is the kind of thing a
+// curious user would recognise.
+
+export const LIBRARY_GUEST_SEED = {
+	libraryEntries: [
+		{
+			id: 'demo-book-dune',
+			kind: 'book' as const,
+			status: 'completed' as const,
+			title: 'Dune',
+			originalTitle: 'Dune',
+			creators: ['Frank Herbert'],
+			year: 1965,
+			coverUrl: null,
+			coverMediaId: null,
+			rating: 4.5,
+			review: null,
+			tags: ['klassiker'],
+			genres: ['Sci-Fi'],
+			startedAt: null,
+			completedAt: '2026-01-15',
+			isFavorite: true,
+			times: 1,
+			externalIds: null,
+			details: { kind: 'book' as const, pages: 688, format: 'paperback' as const },
+		},
+		{
+			id: 'demo-movie-arrival',
+			kind: 'movie' as const,
+			status: 'completed' as const,
+			title: 'Arrival',
+			originalTitle: null,
+			creators: ['Denis Villeneuve'],
+			year: 2016,
+			coverUrl: null,
+			coverMediaId: null,
+			rating: 4,
+			review: null,
+			tags: [],
+			genres: ['Sci-Fi', 'Drama'],
+			startedAt: null,
+			completedAt: '2026-02-08',
+			isFavorite: false,
+			times: 1,
+			externalIds: null,
+			details: { kind: 'movie' as const, runtimeMin: 116, director: 'Denis Villeneuve' },
+		},
+		{
+			id: 'demo-series-severance',
+			kind: 'series' as const,
+			status: 'active' as const,
+			title: 'Severance',
+			originalTitle: null,
+			creators: ['Dan Erickson'],
+			year: 2022,
+			coverUrl: null,
+			coverMediaId: null,
+			rating: null,
+			review: null,
+			tags: [],
+			genres: ['Sci-Fi', 'Thriller'],
+			startedAt: '2026-03-01',
+			completedAt: null,
+			isFavorite: false,
+			times: 0,
+			externalIds: null,
+			details: { kind: 'series' as const, totalSeasons: 2, totalEpisodes: 19, watched: [] },
+		},
+		{
+			id: 'demo-comic-saga',
+			kind: 'comic' as const,
+			status: 'active' as const,
+			title: 'Saga',
+			originalTitle: null,
+			creators: ['Brian K. Vaughan', 'Fiona Staples'],
+			year: 2012,
+			coverUrl: null,
+			coverMediaId: null,
+			rating: null,
+			review: null,
+			tags: [],
+			genres: ['Sci-Fi', 'Fantasy'],
+			startedAt: null,
+			completedAt: null,
+			isFavorite: false,
+			times: 0,
+			externalIds: null,
+			details: {
+				kind: 'comic' as const,
+				currentIssue: 12,
+				publisher: 'Image Comics',
+				isOngoing: true,
+			},
+		},
+	],
+};
--- a/apps/mana/apps/web/src/lib/modules/library/constants.ts
+++ b/apps/mana/apps/web/src/lib/modules/library/constants.ts
@ -0,0 +1,48 @@
+import type { LibraryKind, LibraryStatus, BookFormat } from './types';
+
+export const KIND_LABELS: Record<LibraryKind, { de: string; en: string; emoji: string }> = {
+	book: { de: 'Bücher', en: 'Books', emoji: '📚' },
+	movie: { de: 'Filme', en: 'Movies', emoji: '🎬' },
+	series: { de: 'Serien', en: 'Series', emoji: '📺' },
+	comic: { de: 'Comics', en: 'Comics', emoji: '💥' },
+};
+
+export const STATUS_LABELS: Record<LibraryStatus, { de: string; en: string }> = {
+	planned: { de: 'Geplant', en: 'Planned' },
+	active: { de: 'Läuft', en: 'In progress' },
+	completed: { de: 'Fertig', en: 'Completed' },
+	paused: { de: 'Pausiert', en: 'Paused' },
+	dropped: { de: 'Abgebrochen', en: 'Dropped' },
+};
+
+export const STATUS_COLORS: Record<LibraryStatus, string> = {
+	planned: '#64748b',
+	active: '#3b82f6',
+	completed: '#22c55e',
+	paused: '#f59e0b',
+	dropped: '#ef4444',
+};
+
+export const BOOK_FORMAT_LABELS: Record<BookFormat, { de: string; en: string }> = {
+	hardcover: { de: 'Hardcover', en: 'Hardcover' },
+	paperback: { de: 'Taschenbuch', en: 'Paperback' },
+	ebook: { de: 'E-Book', en: 'E-Book' },
+	audio: { de: 'Hörbuch', en: 'Audiobook' },
+};
+
+export const DEFAULT_GENRES = [
+	'Sci-Fi',
+	'Fantasy',
+	'Thriller',
+	'Krimi',
+	'Romanze',
+	'Drama',
+	'Komödie',
+	'Horror',
+	'Biografie',
+	'Sachbuch',
+	'Action',
+	'Animation',
+	'Dokumentation',
+	'Historisch',
+];
--- a/apps/mana/apps/web/src/lib/modules/library/index.ts
+++ b/apps/mana/apps/web/src/lib/modules/library/index.ts
@ -0,0 +1,42 @@
+/**
+ * Library module — barrel exports.
+ */
+
+export { libraryEntriesStore } from './stores/entries.svelte';
+
+export {
+	useAllEntries,
+	toLibraryEntry,
+	filterByKind,
+	filterByStatus,
+	searchEntries,
+	groupByKind,
+	computeStats,
+} from './queries';
+
+export { libraryEntryTable, LIBRARY_GUEST_SEED } from './collections';
+
+export {
+	KIND_LABELS,
+	STATUS_LABELS,
+	STATUS_COLORS,
+	BOOK_FORMAT_LABELS,
+	DEFAULT_GENRES,
+} from './constants';
+
+export type {
+	LocalLibraryEntry,
+	LibraryEntry,
+	LibraryKind,
+	LibraryStatus,
+	LibraryDetails,
+	BookDetails,
+	MovieDetails,
+	SeriesDetails,
+	ComicDetails,
+	BookFormat,
+	WatchedEpisode,
+	LibraryExternalIds,
+} from './types';
+
+export type { LibraryStats } from './queries';
--- a/apps/mana/apps/web/src/lib/modules/library/module.config.ts
+++ b/apps/mana/apps/web/src/lib/modules/library/module.config.ts
@ -0,0 +1,6 @@
+import type { ModuleConfig } from '$lib/data/module-registry';
+
+export const libraryModuleConfig: ModuleConfig = {
+	appId: 'library',
+	tables: [{ name: 'libraryEntries' }],
+};
--- a/apps/mana/apps/web/src/lib/modules/library/queries.ts
+++ b/apps/mana/apps/web/src/lib/modules/library/queries.ts
@ -0,0 +1,112 @@
+/**
+ * Reactive queries and pure helpers for the Library module.
+ */
+
+import { useLiveQueryWithDefault } from '@mana/local-store/svelte';
+import { decryptRecords } from '$lib/data/crypto';
+import { db } from '$lib/data/database';
+import type { LocalLibraryEntry, LibraryEntry, LibraryKind, LibraryStatus } from './types';
+
+// ─── Type Converter ──────────────────────────────────────
+
+export function toLibraryEntry(local: LocalLibraryEntry): LibraryEntry {
+	const now = new Date().toISOString();
+	return {
+		id: local.id,
+		kind: local.kind,
+		status: local.status,
+		title: local.title,
+		originalTitle: local.originalTitle ?? null,
+		creators: local.creators ?? [],
+		year: local.year ?? null,
+		coverUrl: local.coverUrl ?? null,
+		coverMediaId: local.coverMediaId ?? null,
+		rating: local.rating ?? null,
+		review: local.review ?? null,
+		tags: local.tags ?? [],
+		genres: local.genres ?? [],
+		startedAt: local.startedAt ?? null,
+		completedAt: local.completedAt ?? null,
+		isFavorite: local.isFavorite ?? false,
+		times: local.times ?? 0,
+		externalIds: local.externalIds ?? null,
+		details: local.details,
+		createdAt: local.createdAt ?? now,
+		updatedAt: local.updatedAt ?? now,
+	};
+}
+
+// ─── Live Queries ─────────────────────────────────────────
+
+export function useAllEntries() {
+	return useLiveQueryWithDefault(async () => {
+		const locals = await db.table<LocalLibraryEntry>('libraryEntries').toArray();
+		const visible = locals.filter((e) => !e.deletedAt);
+		const decrypted = await decryptRecords('libraryEntries', visible);
+		return decrypted.map(toLibraryEntry);
+	}, [] as LibraryEntry[]);
+}
+
+// ─── Pure Helpers ─────────────────────────────────────────
+
+export function filterByKind(entries: LibraryEntry[], kind: LibraryKind): LibraryEntry[] {
+	return entries.filter((e) => e.kind === kind);
+}
+
+export function filterByStatus(entries: LibraryEntry[], status: LibraryStatus): LibraryEntry[] {
+	return entries.filter((e) => e.status === status);
+}
+
+export function searchEntries(entries: LibraryEntry[], query: string): LibraryEntry[] {
+	const lower = query.toLowerCase();
+	return entries.filter(
+		(e) =>
+			e.title.toLowerCase().includes(lower) ||
+			(e.originalTitle?.toLowerCase().includes(lower) ?? false) ||
+			e.creators.some((c) => c.toLowerCase().includes(lower))
+	);
+}
+
+export function groupByKind(entries: LibraryEntry[]): Record<LibraryKind, LibraryEntry[]> {
+	const out: Record<LibraryKind, LibraryEntry[]> = {
+		book: [],
+		movie: [],
+		series: [],
+		comic: [],
+	};
+	for (const e of entries) out[e.kind].push(e);
+	return out;
+}
+
+export interface LibraryStats {
+	totalByKind: Record<LibraryKind, number>;
+	completedThisYear: number;
+	currentlyActive: number;
+	avgRating: number | null;
+}
+
+export function computeStats(entries: LibraryEntry[], year: number): LibraryStats {
+	const totalByKind: Record<LibraryKind, number> = { book: 0, movie: 0, series: 0, comic: 0 };
+	let completedThisYear = 0;
+	let currentlyActive = 0;
+	let ratingSum = 0;
+	let ratingCount = 0;
+	const yearPrefix = String(year);
+
+	for (const e of entries) {
+		totalByKind[e.kind]++;
+		if (e.status === 'active') currentlyActive++;
+		if (e.status === 'completed' && e.completedAt?.startsWith(yearPrefix)) completedThisYear++;
+		if (typeof e.rating === 'number') {
+			ratingSum += e.rating;
+			ratingCount++;
+		}
+	}
+
+	return {
+		totalByKind,
+		completedThisYear,
+		currentlyActive,
+		avgRating: ratingCount > 0 ? ratingSum / ratingCount : null,
+	};
+}
--- a/apps/mana/apps/web/src/lib/modules/library/stores/entries.svelte.ts
+++ b/apps/mana/apps/web/src/lib/modules/library/stores/entries.svelte.ts
@ -0,0 +1,171 @@
+/**
+ * Library entries store — mutation-only service.
+ *
+ * All reads happen via the liveQuery helpers in queries.ts. Writes go through
+ * this store so the encryption step + event emission are consistent.
+ */
+
+import { encryptRecord } from '$lib/data/crypto';
+import { emitDomainEvent } from '$lib/data/events';
+import { libraryEntryTable } from '../collections';
+import { toLibraryEntry } from '../queries';
+import type {
+	LocalLibraryEntry,
+	LibraryKind,
+	LibraryStatus,
+	LibraryDetails,
+	LibraryExternalIds,
+} from '../types';
+
+function defaultDetails(kind: LibraryKind): LibraryDetails {
+	switch (kind) {
+		case 'book':
+			return { kind: 'book' };
+		case 'movie':
+			return { kind: 'movie' };
+		case 'series':
+			return { kind: 'series', watched: [] };
+		case 'comic':
+			return { kind: 'comic' };
+	}
+}
+
+export interface CreateEntryInput {
+	kind: LibraryKind;
+	title: string;
+	originalTitle?: string | null;
+	creators?: string[];
+	year?: number | null;
+	coverUrl?: string | null;
+	coverMediaId?: string | null;
+	status?: LibraryStatus;
+	rating?: number | null;
+	review?: string | null;
+	tags?: string[];
+	genres?: string[];
+	startedAt?: string | null;
+	completedAt?: string | null;
+	isFavorite?: boolean;
+	externalIds?: LibraryExternalIds | null;
+	details?: LibraryDetails;
+}
+
+export const libraryEntriesStore = {
+	async createEntry(input: CreateEntryInput) {
+		const details = input.details ?? defaultDetails(input.kind);
+		if (details.kind !== input.kind) {
+			throw new Error(
+				`[library] details.kind "${details.kind}" does not match entry.kind "${input.kind}"`
+			);
+		}
+		const newLocal: LocalLibraryEntry = {
+			id: crypto.randomUUID(),
+			kind: input.kind,
+			status: input.status ?? 'planned',
+			title: input.title,
+			originalTitle: input.originalTitle ?? null,
+			creators: input.creators ?? [],
+			year: input.year ?? null,
+			coverUrl: input.coverUrl ?? null,
+			coverMediaId: input.coverMediaId ?? null,
+			rating: input.rating ?? null,
+			review: input.review ?? null,
+			tags: input.tags ?? [],
+			genres: input.genres ?? [],
+			startedAt: input.startedAt ?? null,
+			completedAt: input.completedAt ?? null,
+			isFavorite: input.isFavorite ?? false,
+			times: 0,
+			externalIds: input.externalIds ?? null,
+			details,
+		};
+		const snapshot = toLibraryEntry({ ...newLocal });
+		await encryptRecord('libraryEntries', newLocal);
+		await libraryEntryTable.add(newLocal);
+		emitDomainEvent('LibraryEntryCreated', 'library', 'libraryEntries', newLocal.id, {
+			entryId: newLocal.id,
+			kind: input.kind,
+			title: input.title,
+		});
+		return snapshot;
+	},
+
+	async updateEntry(
+		id: string,
+		patch: Partial<
+			Pick<
+				LocalLibraryEntry,
+				| 'title'
+				| 'originalTitle'
+				| 'creators'
+				| 'year'
+				| 'coverUrl'
+				| 'coverMediaId'
+				| 'status'
+				| 'rating'
+				| 'review'
+				| 'tags'
+				| 'genres'
+				| 'startedAt'
+				| 'completedAt'
+				| 'isFavorite'
+				| 'externalIds'
+				| 'details'
+				| 'times'
+			>
+		>
+	) {
+		const wrapped = { ...patch } as Record<string, unknown>;
+		await encryptRecord('libraryEntries', wrapped);
+		await libraryEntryTable.update(id, {
+			...wrapped,
+			updatedAt: new Date().toISOString(),
+		});
+	},
+
+	async setStatus(id: string, status: LibraryStatus) {
+		const existing = await libraryEntryTable.get(id);
+		if (!existing) return;
+		const nowDate = new Date().toISOString().slice(0, 10);
+		const patch: Partial<LocalLibraryEntry> = { status };
+		if (status === 'active' && !existing.startedAt) patch.startedAt = nowDate;
+		if (status === 'completed') {
+			if (!existing.completedAt) patch.completedAt = nowDate;
+			patch.times = (existing.times ?? 0) + 1;
+		}
+		await libraryEntryTable.update(id, {
+			...patch,
+			updatedAt: new Date().toISOString(),
+		});
+		if (status === 'completed') {
+			emitDomainEvent('LibraryEntryCompleted', 'library', 'libraryEntries', id, {
+				entryId: id,
+				kind: existing.kind,
+			});
+		}
+	},
+
+	async rate(id: string, rating: number | null) {
+		await libraryEntryTable.update(id, {
+			rating,
+			updatedAt: new Date().toISOString(),
+		});
+	},
+
+	async toggleFavorite(id: string) {
+		const existing = await libraryEntryTable.get(id);
+		if (!existing) return;
+		await libraryEntryTable.update(id, {
+			isFavorite: !existing.isFavorite,
+			updatedAt: new Date().toISOString(),
+		});
+	},
+
+	async deleteEntry(id: string) {
+		await libraryEntryTable.update(id, {
+			deletedAt: new Date().toISOString(),
+			updatedAt: new Date().toISOString(),
+		});
+		emitDomainEvent('LibraryEntryDeleted', 'library', 'libraryEntries', id, { entryId: id });
+	},
+};
--- a/apps/mana/apps/web/src/lib/modules/library/types.ts
+++ b/apps/mana/apps/web/src/lib/modules/library/types.ts
@ -0,0 +1,112 @@
+/**
+ * Library module types — a single module tracking books, movies, series, comics
+ * the user has consumed (or plans to). Kind-specific metadata lives in the
+ * discriminated `details` union so we keep one table + one route while still
+ * giving each medium its own shape.
+ */
+
+import type { BaseRecord } from '@mana/local-store';
+
+// ─── Discriminators & Enums ──────────────────────────────
+
+export type LibraryKind = 'book' | 'movie' | 'series' | 'comic';
+
+export type LibraryStatus = 'planned' | 'active' | 'completed' | 'paused' | 'dropped';
+
+export type BookFormat = 'hardcover' | 'paperback' | 'ebook' | 'audio';
+
+// ─── Kind-specific Details ───────────────────────────────
+
+export interface BookDetails {
+	kind: 'book';
+	pages?: number | null;
+	currentPage?: number | null;
+	format?: BookFormat | null;
+}
+
+export interface MovieDetails {
+	kind: 'movie';
+	runtimeMin?: number | null;
+	director?: string | null;
+}
+
+export interface WatchedEpisode {
+	season: number;
+	episode: number;
+	watchedAt?: string | null;
+}
+
+export interface SeriesDetails {
+	kind: 'series';
+	totalSeasons?: number | null;
+	totalEpisodes?: number | null;
+	watched?: WatchedEpisode[];
+}
+
+export interface ComicDetails {
+	kind: 'comic';
+	issueCount?: number | null;
+	currentIssue?: number | null;
+	publisher?: string | null;
+	isOngoing?: boolean;
+}
+
+export type LibraryDetails = BookDetails | MovieDetails | SeriesDetails | ComicDetails;
+
+// ─── External Metadata IDs ───────────────────────────────
+
+export interface LibraryExternalIds {
+	isbn?: string | null;
+	tmdbId?: string | null;
+	openLibraryId?: string | null;
+	comicVineId?: string | null;
+}
+
+// ─── Local Record (Dexie) ────────────────────────────────
+
+export interface LocalLibraryEntry extends BaseRecord {
+	kind: LibraryKind;
+	status: LibraryStatus;
+	title: string;
+	originalTitle?: string | null;
+	creators: string[];
+	year?: number | null;
+	coverUrl?: string | null;
+	coverMediaId?: string | null;
+	rating?: number | null;
+	review?: string | null;
+	tags: string[];
+	genres: string[];
+	startedAt?: string | null;
+	completedAt?: string | null;
+	isFavorite: boolean;
+	times: number;
+	externalIds?: LibraryExternalIds | null;
+	details: LibraryDetails;
+}
+
+// ─── Domain Type (plaintext, for UI) ─────────────────────
+
+export interface LibraryEntry {
+	id: string;
+	kind: LibraryKind;
+	status: LibraryStatus;
+	title: string;
+	originalTitle: string | null;
+	creators: string[];
+	year: number | null;
+	coverUrl: string | null;
+	coverMediaId: string | null;
+	rating: number | null;
+	review: string | null;
+	tags: string[];
+	genres: string[];
+	startedAt: string | null;
+	completedAt: string | null;
+	isFavorite: boolean;
+	times: number;
+	externalIds: LibraryExternalIds | null;
+	details: LibraryDetails;
+	createdAt: string;
+	updatedAt: string;
+}
--- a/apps/mana/apps/web/src/routes/(app)/library/+page.svelte
+++ b/apps/mana/apps/web/src/routes/(app)/library/+page.svelte
@ -0,0 +1,9 @@
+<script lang="ts">
+	import ListView from '$lib/modules/library/ListView.svelte';
+</script>
+
+<svelte:head>
+	<title>Bibliothek - Mana</title>
+</svelte:head>
+
+<ListView />
--- a/docs/MODULE_REGISTRY.md
+++ b/docs/MODULE_REGISTRY.md
@ -1,6 +1,6 @@
 # Mana Module Registry

-Alle 72 Module der Mana-App (`apps/mana/apps/web/src/lib/modules/`).
+Alle 73 Module der Mana-App (`apps/mana/apps/web/src/lib/modules/`).

 ---

@ -33,7 +33,7 @@ Alle 72 Module der Mana-App (`apps/mana/apps/web/src/lib/modules/`).
 | `mood` | Mood | Stimmungs-Tracking mehrmals täglich mit Kontext und Mustern |
 | `moodlit` | Moodlit | Beruhigende Ambient-Beleuchtung mit animierten Farbverläufen |

-## Kreativität & Medien (7)
+## Kreativität & Medien (8)

 | Modul | Name | Beschreibung |
 |---|---|---|
@ -43,6 +43,7 @@ Alle 72 Module der Mana-App (`apps/mana/apps/web/src/lib/modules/`).
 | `presi` | Presi | Präsentationen mit AI-Design-Vorschlägen |
 | `cards` | Cards | AI-generierte Flashcards mit Spaced Repetition |
 | `recipes` | Rezepte | Rezepte sammeln mit Zutaten und Schritten |
+| `library` | Bibliothek | Bücher, Filme, Serien, Comics — Status, Rating, Fortschritt |
 | `storage` | Storage | Cloud-Storage mit Ordnern, Versionierung und Sharing |

 ## Wissen & Lernen (7)
--- a/docs/plans/library-module.md
+++ b/docs/plans/library-module.md
@ -0,0 +1,221 @@
+# Library — Module Plan
+
+## Status (2026-04-17)
+
+**M1 Skelett: DONE.** Modul registriert, Dexie v26 angelegt, Encryption-Registry
+eingetragen, Route `/library` mountet einen minimalen Listen-View. Guest-Seed mit
+je einem Eintrag pro `kind` (Dune, Arrival, Severance, Saga) vorhanden.
+Nächster Schritt: M2 (volles CRUD + Form + Grid + DetailView).
+
+Vor M2 entschieden:
+- Audiobooks: `kind='book'` mit `details.format='audio'` (nicht eigener `kind`).
+- Manga: in `kind='comic'` ohne Sub-Typ (bis Bedarf für Chapters vs. Issues auftaucht).
+- Metadata-Lookup (M7): Endpoint in `apps/api` (`/api/v1/library/lookup?kind=...&q=...`),
+  kein eigener Service — Extraktion erst bei Crawler-artigem Bedarf.
+
+---
+
+## Ziel
+
+## Ziel
+
+Ein einziges Modul, mit dem der Nutzer **konsumierte Medien** festhält: Bücher, Filme, Serien, Comics. Kernfrage: *"Habe ich das schon gesehen/gelesen? Wann? Wie fand ich's?"*
+
+Nicht im Scope: Streaming-Integration, Kauf-Tracking, Leseplan-Automatisierung. Kein Ersatz für Goodreads/Letterboxd — eher privates Log mit Rating und Fortschritt.
+
+## Abgrenzung
+
+- **Kein `inventory`**: dort geht's um Besitz (Seriennummer, Garantie, Standort). Hier geht's um Konsum — ein Buch, das man aus der Bibliothek ausgeliehen und gelesen hat, gehört hierher, nicht in `inventory`.
+- **Kein `music`**: Musik hat eigene Primitive (Playlists, Projekte). Soundtracks landen weiter in `music/`.
+- **Kein `photos`/`picture`**: Fotos und AI-Bilder bleiben getrennt.
+- **Cross-Link zu `goals`**: "Lese 20 Bücher 2026" bleibt im Ziel-Modul, liest aber `library.completedAt` über die bestehende Cross-Module-Mechanik.
+
+## Entscheidung: ein Modul, vier Typen
+
+Ein Modul `library` mit Diskriminator `kind: 'book' | 'movie' | 'series' | 'comic'`. Geteiltes Kern-Schema; typ-spezifische Felder in `details: jsonb`. Begründung:
+
+- Ein Sync-Endpoint, eine Encryption-Registry-Zeile, eine Route, ein Settings-Panel
+- Quer-Abfragen ("Jahresrückblick über alles") fallen gratis ab
+- Konsistenz mit `inventory` (auch ein Typ-übergreifendes "Sammlung"-Modul)
+- UI kann trotzdem Tabs pro Typ zeigen und typ-spezifische Listenansichten/Detail-Views laden
+
+Der Tradeoff: pro Typ hat man kein eigenes Launcher-Icon. Falls das später wichtig wird, kann ein Typ als eigenes Modul mit Alias auf dieselbe Tabelle ausgegliedert werden — das Schema muss dafür nicht brechen.
+
+## Modul-Struktur
+
+```
+apps/mana/apps/web/src/lib/modules/library/
+├── types.ts                    # LocalLibraryEntry, LibraryEntry, Kind, Status, kind-spezifische Detail-Typen
+├── collections.ts              # libraryEntries-Table + Guest-Seed (1 Buch, 1 Film, 1 Serie, 1 Comic)
+├── queries.ts                  # useAllEntries, useEntriesByKind, useEntry(id), useStats
+├── stores/
+│   └── entries.svelte.ts       # createEntry, updateEntry, setStatus, rate, bumpProgress, deleteEntry
+├── components/
+│   ├── EntryCard.svelte        # kompakter Listeneintrag (Cover + Titel + Rating + Status-Badge)
+│   ├── EntryForm.svelte        # Create/Edit — rendert typ-spezifische Felder aus details
+│   ├── KindTabs.svelte         # Filter-Tabs (Alle | Bücher | Filme | Serien | Comics)
+│   ├── RatingStars.svelte      # 0–5 Sterne
+│   ├── StatusBadge.svelte      # geplant / läuft / fertig / abgebrochen
+│   ├── EpisodeTracker.svelte   # nur für kind='series': Staffel/Episode checkliste
+│   └── CoverImage.svelte       # lazy-load, Fallback-Platzhalter pro Typ
+├── views/
+│   ├── GridView.svelte         # Cover-Grid (Default)
+│   ├── ListView.svelte         # Kompakte Liste mit Filterung
+│   └── DetailView.svelte       # Einzelansicht inkl. Review + Re-Watches/Re-Reads
+├── tools.ts                    # AI-Tools (später — siehe AI-Integration)
+├── constants.ts                # KIND_LABELS, STATUS_LABELS, DEFAULT_TAGS
+├── ListView.svelte             # Modul-Root-View (komponiert KindTabs + GridView)
+├── module.config.ts            # { appId: 'library', tables: [{ name: 'libraryEntries' }] }
+└── index.ts                    # Re-Exports
+```
+
+## Daten-Schema
+
+### `LocalLibraryEntry` (Dexie)
+
+```typescript
+export type LibraryKind = 'book' | 'movie' | 'series' | 'comic';
+export type LibraryStatus = 'planned' | 'active' | 'completed' | 'dropped' | 'paused';
+
+export interface LocalLibraryEntry extends BaseRecord {
+  kind: LibraryKind;                         // plaintext — Discriminator, filterbar
+  status: LibraryStatus;                      // plaintext — filterbar
+  title: string;                              // encrypted
+  originalTitle?: string | null;              // encrypted (z.B. engl. Original)
+  creators: string[];                         // encrypted — Autor / Regie / Showrunner / Zeichner
+  year?: number | null;                       // plaintext
+  coverUrl?: string | null;                   // plaintext (externe URL) ODER
+  coverMediaId?: string | null;               // plaintext (Referenz in uload/media)
+  rating?: number | null;                     // plaintext — 0..5, Schritt 0.5
+  review?: string | null;                     // encrypted — Freitext
+  tags: string[];                             // encrypted
+  genres: string[];                           // plaintext — "Sci-Fi", "Thriller"...
+  startedAt?: string | null;                  // plaintext ISO-Datum
+  completedAt?: string | null;                // plaintext — für Jahresrückblick / Ziele
+  isFavorite: boolean;                        // plaintext
+  times: number;                              // plaintext — Zähler "Re-Reads / Re-Watches"
+  externalIds?: {                             // plaintext — für spätere Metadata-Sync
+    isbn?: string;
+    tmdbId?: string;
+    openLibraryId?: string;
+    comicVineId?: string;
+  } | null;
+  details: LibraryDetails;                    // typ-spezifische Felder — siehe unten
+}
+```
+
+### `details` pro `kind`
+
+Diskriminierte Union, damit TypeScript Typ-Sicherheit gibt:
+
+```typescript
+export type LibraryDetails =
+  | { kind: 'book';   pages?: number; currentPage?: number; format?: 'hardcover' | 'paperback' | 'ebook' | 'audio' }
+  | { kind: 'movie';  runtimeMin?: number; director?: string }
+  | { kind: 'series'; totalSeasons?: number; totalEpisodes?: number; watched?: Array<{ season: number; episode: number; watchedAt?: string }> }
+  | { kind: 'comic';  issueCount?: number; currentIssue?: number; publisher?: string; isOngoing?: boolean };
+```
+
+Die `details` bleiben **plaintext** — keine sensiblen Daten drin (Seiten-Zahlen, Episoden-Zähler). Falls sich das ändert (z.B. Spoiler-lastige Episoden-Notizen), Feld nachziehen.
+
+### Encryption-Registry
+
+`apps/mana/apps/web/src/lib/data/crypto/registry.ts` — neuer Eintrag:
+
+```typescript
+libraryEntries: {
+  fields: ['title', 'originalTitle', 'creators', 'review', 'tags'],
+  version: 1,
+},
+```
+
+## Routing
+
+```
+apps/mana/apps/web/src/routes/(app)/library/
+├── +page.svelte                # Grid mit KindTabs
+├── [kind]/+page.svelte         # Deep-Link: /library/books, /library/movies, ...
+└── entry/[id]/+page.svelte     # DetailView
+```
+
+## UI-Konzept
+
+### Landing (`/library`)
+
+- **Top**: `KindTabs` (Alle | Bücher | Filme | Serien | Comics) mit Count-Badges
+- **Sekundärleiste**: Status-Filter-Chips (Geplant | Läuft | Fertig), Sort (Zuletzt fertig | Rating | Titel), Favoriten-Toggle
+- **Grid**: Cover-Kacheln mit Titel + Rating + Status-Badge; Click → DetailView
+- **FAB**: "+" öffnet `EntryForm` mit Typ-Vorauswahl basierend auf aktivem Tab
+
+### EntryForm
+
+- Zuerst `kind` wählen (wenn nicht vorgegeben)
+- Kern-Felder (Titel, Jahr, Creators, Cover, Status, Rating, Tags, Review) sind identisch
+- Unter "Details"-Accordion erscheinen typ-spezifische Felder aus `details`
+- Cover: entweder URL einfügen oder Upload via bestehende `uload`-Infrastruktur → `coverMediaId`
+- Optional (Phase 2): "Vorschlag abrufen" → OpenLibrary/TMDB lookup → füllt Metadaten + Cover vor
+
+### DetailView
+
+- Cover links, Metadaten rechts
+- Unten: Review (Markdown, encrypted), Tags, Status-Verlauf
+- Für `kind='series'`: eingebetteter `EpisodeTracker` (Staffeln ausklappbar, Episoden abhakbar, Fortschritts-Balken)
+- Für `kind='book'`: Seiten-Slider zum Fortschritt, "Buch fertig"-Button setzt `completedAt` + `times++`
+- Unten: "Nochmal gelesen/gesehen"-Button → `times++` und `startedAt`/`completedAt` reset (alte Instanz in `notes` im Activity-Log)
+
+## Stats / Jahresrückblick
+
+`queries.ts` liefert:
+
+- `useStats()` → `{ totalByKind, completedThisYear, avgRating, topGenres, currentlyActive }`
+- `useStreak(kind)` → "X Bücher in Folge fertig gemacht" (optional)
+
+Diese Daten kann der Dashboard-Widget-Grid anzeigen (vgl. `drink`/`habits`).
+
+## Registrierung (Checklist)
+
+1. `apps/mana/apps/web/src/lib/modules/library/module.config.ts` anlegen
+2. Config in `apps/mana/apps/web/src/lib/data/module-registry.ts` importieren + in `MODULE_CONFIGS` aufnehmen
+3. Dexie-Schema-Migration: in `apps/mana/apps/web/src/lib/data/database.ts` neue `db.version(N+1).stores({ libraryEntries: 'id, kind, status, userId, completedAt' })` hinzufügen (NICHT bestehende Versionen ändern)
+4. Encryption-Registry-Eintrag (siehe oben)
+5. Routes unter `(app)/library/` anlegen
+6. App-Eintrag in `packages/shared-branding/src/mana-apps.ts`:
+   ```typescript
+   { id: 'library', name: 'Bibliothek', description: {...}, icon: APP_ICONS.library, color: '#a855f7', status: 'development', requiredTier: 'guest' }
+   ```
+7. Icon in `packages/shared-branding/src/app-icons.ts` (SVG as data URL)
+8. `docs/MODULE_REGISTRY.md` unter "Kreativität & Medien" ergänzen
+9. Guest-Seed in `collections.ts` (1 Eintrag pro `kind`, damit neue Nutzer sofort was sehen)
+10. Vitest-Tests für store-Mutationen + encryption roundtrip
+
+## AI-Integration (Phase 2)
+
+Nachdem das Modul steht, Tools in `tools.ts` registrieren und in `@mana/shared-ai/src/policy/proposable-tools.ts` aufnehmen:
+
+| Tool | Policy | Beschreibung |
+|------|--------|--------------|
+| `list_library_entries` | auto | Liefert Einträge gefiltert nach `kind`/`status`, read-only |
+| `create_library_entry` | propose | User muss jeden neuen Eintrag bestätigen |
+| `complete_library_entry` | propose | Status → `completed`, `completedAt` = heute |
+| `rate_library_entry` | propose | Rating setzen |
+
+Missionen wie *"Trage meine letzten 5 gesehenen Filme ein"* können dann über den Runner laufen.
+
+## Offene Fragen
+
+- **Externe Metadata-Quellen**: OpenLibrary (Bücher, frei) + TMDB (Filme/Serien, API-Key nötig) + Comic Vine (Comics, API-Key nötig). Lohnt sich ein neuer `services/mana-metadata`-Service, der die Quellen proxyed, oder reicht ein Endpoint in `apps/api`? Vorschlag: **Endpoint in `apps/api`** zuerst (`/api/v1/library/lookup?kind=...&q=...`), service-Extraktion nur wenn's Crawler-artig wird.
+- **Goodreads/Letterboxd-Import**: Phase 3. CSV-Upload reicht fürs erste, später GoodReads-API (sobald die offen ist) oder Screen-Scraping via mana-crawler.
+- **Serien-Episoden**: in `details.watched` als flaches Array reicht für die meisten Fälle. Falls detaillierte Episoden-Metadaten (Titel, Runtime) benötigt werden, TMDB-Sync in Phase 2 nachziehen.
+- **Audiobooks**: als `kind='book'` mit `details.format='audio'` oder als eigener `kind='audiobook'`? **Vorschlag**: format-Feld. Kernlogik bleibt "Buch".
+- **Manga**: in `kind='comic'` einordnen oder separat? **Vorschlag**: comic. Falls Manga-spezifische Features (Chapters statt Issues) wichtig werden, `details` um ein Manga-Variant erweitern.
+
+## Reihenfolge (Milestones)
+
+1. **M1 — Skelett [DONE 2026-04-17]**: types, collections, module.config, Registry-Eintrag, Dexie-Migration (v26), leere Route. *Ziel: App zeigt leeres Modul an, nichts crasht.*
+2. **M2 — CRUD**: entries-Store, EntryForm, GridView, DetailView. Manuelles Anlegen/Editieren funktioniert für alle 4 `kind`s. Cover via URL.
+3. **M3 — Fortschritt**: Status-Wechsel, Rating, times-Counter, Episode-Tracker für Serien, Seiten-Slider für Bücher. Guest-Seed komplett.
+4. **M4 — Cover-Upload**: Integration mit `uload`. Encryption-Registry final.
+5. **M5 — Stats + Dashboard-Widget**: useStats, kleiner Widget für Dashboard.
+6. **M6 — AI-Tools**: list/create/complete/rate Tools, Shared-AI-Policy.
+7. **M7 — Metadata-Lookup**: `/api/v1/library/lookup` gegen OpenLibrary + TMDB.
+8. **M8 — Import**: CSV-Upload (Goodreads/Letterboxd-Export-Formate).
--- a/packages/shared-branding/src/app-icons.ts
+++ b/packages/shared-branding/src/app-icons.ts
@ -222,6 +222,12 @@ export const APP_ICONS = {
 		// Sky-blue gradient for the weather theme.
 		`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100"><defs><linearGradient id="wt" x1="0%" y1="0%" x2="100%" y2="100%"><stop offset="0%" style="stop-color:#38bdf8"/><stop offset="100%" style="stop-color:#0284c7"/></linearGradient></defs><rect width="100" height="100" rx="22" fill="url(#wt)"/><circle cx="62" cy="32" r="14" fill="white" fill-opacity="0.9"/><line x1="62" y1="12" x2="62" y2="18" stroke="white" stroke-width="2.5" stroke-linecap="round" opacity="0.7"/><line x1="62" y1="46" x2="62" y2="52" stroke="white" stroke-width="2.5" stroke-linecap="round" opacity="0.5"/><line x1="42" y1="32" x2="48" y2="32" stroke="white" stroke-width="2.5" stroke-linecap="round" opacity="0.7"/><line x1="76" y1="32" x2="82" y2="32" stroke="white" stroke-width="2.5" stroke-linecap="round" opacity="0.7"/><line x1="48" y1="18" x2="52" y2="22" stroke="white" stroke-width="2.5" stroke-linecap="round" opacity="0.6"/><line x1="76" y1="18" x2="72" y2="22" stroke="white" stroke-width="2.5" stroke-linecap="round" opacity="0.6"/><path d="M28 56a14 14 0 0 1 14-14h0a14 14 0 0 1 13 9 10 10 0 0 1 11 10 10 10 0 0 1-10 10H30a10 10 0 0 1-10-10 10 10 0 0 1 8-5z" fill="white" fill-opacity="0.95"/><line x1="34" y1="76" x2="30" y2="84" stroke="white" stroke-width="2.5" stroke-linecap="round" opacity="0.7"/><line x1="46" y1="76" x2="42" y2="84" stroke="white" stroke-width="2.5" stroke-linecap="round" opacity="0.7"/><line x1="58" y1="76" x2="54" y2="84" stroke="white" stroke-width="2.5" stroke-linecap="round" opacity="0.7"/></svg>`
 	),
+	library: svgToDataUrl(
+		// Stack of books (left) + a book with a spine/pages motif (right) — the
+		// "Bibliothek" theme covering books/movies/series/comics. Purple→fuchsia
+		// gradient sits next to music/photos/picture in the Kreativität & Medien row.
+		`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100"><defs><linearGradient id="lb" x1="0%" y1="0%" x2="100%" y2="100%"><stop offset="0%" style="stop-color:#a855f7"/><stop offset="100%" style="stop-color:#d946ef"/></linearGradient></defs><rect width="100" height="100" rx="22" fill="url(#lb)"/><rect x="22" y="28" width="10" height="44" rx="2" fill="white" fill-opacity="0.95"/><rect x="34" y="24" width="10" height="48" rx="2" fill="white" fill-opacity="0.8"/><rect x="46" y="30" width="10" height="42" rx="2" fill="white" fill-opacity="0.95"/><rect x="58" y="28" width="22" height="44" rx="3" fill="white"/><rect x="62" y="34" width="4" height="4" fill="#a855f7"/><rect x="72" y="34" width="4" height="4" fill="#a855f7"/><rect x="62" y="44" width="4" height="4" fill="#a855f7"/><rect x="72" y="44" width="4" height="4" fill="#a855f7"/><rect x="62" y="54" width="4" height="4" fill="#a855f7"/><rect x="72" y="54" width="4" height="4" fill="#a855f7"/><rect x="62" y="64" width="4" height="4" fill="#a855f7"/><rect x="72" y="64" width="4" height="4" fill="#a855f7"/><rect x="20" y="74" width="62" height="4" rx="2" fill="white" fill-opacity="0.5"/></svg>`
+	),
 } as const;

 export type AppIconId = keyof typeof APP_ICONS;
--- a/packages/shared-branding/src/mana-apps.ts
+++ b/packages/shared-branding/src/mana-apps.ts
@ -986,6 +986,23 @@ export const MANA_APPS: ManaApp[] = [
 		status: 'development',
 		requiredTier: 'guest',
 	},
+	{
+		id: 'library',
+		name: 'Bibliothek',
+		description: {
+			de: 'Bücher, Filme, Serien, Comics',
+			en: 'Books, Movies, Series, Comics',
+		},
+		longDescription: {
+			de: 'Protokolliere was du liest und schaust — Bücher, Filme, Serien, Comics. Mit Status, Rating, Fortschritt und Jahresrückblick.',
+			en: 'Log what you read and watch — books, movies, series, comics. With status, rating, progress tracking and year-in-review.',
+		},
+		icon: APP_ICONS.library,
+		color: '#a855f7',
+		comingSoon: false,
+		status: 'development',
+		requiredTier: 'guest',
+	},
 ];

 /**