feat(kontext): singleton markdown doc with inline editor

New Mana module "Kontext" — one editable markdown document per user,
displayed as a workbench page. Toggle between rendered preview and a
raw textarea editor (Cmd/Ctrl+E); debounced autosave 500 ms.

Content is encrypted at rest (new `kontextDoc` table, singleton row).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Till JS 2026-04-14 20:46:04 +02:00
parent bb278fb3cf
commit 2fb2bb60fb
11 changed files with 433 additions and 0 deletions

View file

@ -66,6 +66,7 @@ import {
ChatCircleDots,
CreditCard,
SquaresFour,
Scroll,
} from '@mana/shared-icons';
// ── Apps with entity capabilities ───────────────────────────
@ -519,6 +520,16 @@ registerApp({
paramKey: 'conversationId',
});
registerApp({
id: 'kontext',
name: 'Kontext',
color: '#A78B6F',
icon: Scroll,
views: {
list: { load: () => import('$lib/modules/kontext/KontextView.svelte') },
},
});
registerApp({
id: 'context',
name: 'Context',

View file

@ -466,6 +466,11 @@ export const ENCRYPTION_REGISTRY: Record<string, EncryptionConfig> = {
// and pattern detection. Settings are structural only.
moodEntries: { enabled: true, fields: ['withWhom', 'notes'] },
moodSettings: { enabled: false, fields: [] },
// ─── Kontext ─────────────────────────────────────────────
// Singleton markdown document ("Was soll Mana über dich wissen?").
// Free-form user text — encrypt the content, leave the fixed id plaintext.
kontextDoc: { enabled: true, fields: ['content'] },
};
/**

View file

@ -494,6 +494,12 @@ db.version(16).stores({
_byokKeys: 'id, provider, isDefault, [provider+isDefault]',
});
// v17 — Kontext module: a single user-authored markdown document keyed by
// the fixed id 'singleton'. No indexes beyond the primary key.
db.version(17).stores({
kontextDoc: 'id',
});
// ─── Sync Routing ──────────────────────────────────────────
// SYNC_APP_MAP, TABLE_TO_SYNC_NAME, TABLE_TO_APP, SYNC_NAME_TO_TABLE,
// toSyncName() and fromSyncName() are now derived from per-module

View file

@ -95,6 +95,7 @@ import { mailModuleConfig } from '$lib/modules/mail/module.config';
import { meditateModuleConfig } from '$lib/modules/meditate/module.config';
import { sleepModuleConfig } from '$lib/modules/sleep/module.config';
import { moodModuleConfig } from '$lib/modules/mood/module.config';
import { kontextModuleConfig } from '$lib/modules/kontext/module.config';
export const MODULE_CONFIGS: readonly ModuleConfig[] = [
manaCoreConfig,
@ -145,6 +146,7 @@ export const MODULE_CONFIGS: readonly ModuleConfig[] = [
meditateModuleConfig,
sleepModuleConfig,
moodModuleConfig,
kontextModuleConfig,
];
// ─── Derived Maps ──────────────────────────────────────────

View file

@ -0,0 +1,302 @@
<!--
Kontext — Singleton Markdown Document.
View/Edit toggle, debounced autosave, Cmd/Ctrl+E switches mode.
-->
<script lang="ts">
import { onMount } from 'svelte';
import { marked } from 'marked';
import { useKontextDoc } from './queries';
import { kontextStore } from './stores/kontext.svelte';
import { PencilSimple, Eye } from '@mana/shared-icons';
const PLACEHOLDER = 'Was soll Mana über dich wissen?';
const SAVE_DEBOUNCE_MS = 500;
let doc$ = useKontextDoc();
let doc = $derived(doc$.value);
let mode = $state<'view' | 'edit'>('view');
let draft = $state('');
let saveState = $state<'idle' | 'pending' | 'saved'>('idle');
let initialized = $state(false);
let saveTimer: ReturnType<typeof setTimeout> | null = null;
let savedTimer: ReturnType<typeof setTimeout> | null = null;
onMount(() => {
void kontextStore.ensureDoc();
});
// Seed the draft from the live doc once (or when switching into edit
// mode and the content changed externally while we weren't editing).
$effect(() => {
if (!doc) return;
if (!initialized) {
draft = doc.content;
initialized = true;
if (!doc.content) mode = 'edit';
}
});
function scheduleSave() {
saveState = 'pending';
if (saveTimer) clearTimeout(saveTimer);
saveTimer = setTimeout(flush, SAVE_DEBOUNCE_MS);
}
async function flush() {
if (saveTimer) {
clearTimeout(saveTimer);
saveTimer = null;
}
const next = draft;
if (doc && next === doc.content) {
saveState = 'idle';
return;
}
await kontextStore.setContent(next);
saveState = 'saved';
if (savedTimer) clearTimeout(savedTimer);
savedTimer = setTimeout(() => {
if (saveState === 'saved') saveState = 'idle';
}, 1500);
}
async function toggleMode() {
if (mode === 'edit') {
await flush();
mode = 'view';
} else {
if (doc) draft = doc.content;
mode = 'edit';
}
}
function handleKeydown(e: KeyboardEvent) {
if ((e.metaKey || e.ctrlKey) && e.key.toLowerCase() === 'e') {
e.preventDefault();
void toggleMode();
}
}
let renderedHtml = $derived.by(() => {
const source = doc?.content ?? '';
if (!source.trim()) return '';
try {
return marked.parse(source, { async: false }) as string;
} catch {
return '';
}
});
</script>
<svelte:window onkeydown={handleKeydown} />
<div class="app-view">
<header class="bar">
<div class="status">
{#if saveState === 'pending'}
<span class="status-text">Speichert…</span>
{:else if saveState === 'saved'}
<span class="status-text saved">Gespeichert</span>
{/if}
</div>
<button class="mode-btn" onclick={toggleMode} title="Cmd/Ctrl + E">
{#if mode === 'view'}
<PencilSimple size={14} />
<span>Bearbeiten</span>
{:else}
<Eye size={14} />
<span>Ansicht</span>
{/if}
</button>
</header>
{#if mode === 'edit'}
<textarea
class="editor"
bind:value={draft}
oninput={scheduleSave}
onblur={flush}
placeholder={PLACEHOLDER}
></textarea>
{:else if renderedHtml}
<!-- eslint-disable-next-line svelte/no-at-html-tags -->
<article class="prose">{@html renderedHtml}</article>
{:else}
<button class="empty" onclick={() => (mode = 'edit')}>
<span>{PLACEHOLDER}</span>
<span class="hint">Klicken zum Bearbeiten</span>
</button>
{/if}
</div>
<style>
.app-view {
display: flex;
flex-direction: column;
gap: 0.75rem;
padding: 1rem;
height: 100%;
min-height: 0;
}
.bar {
display: flex;
align-items: center;
justify-content: space-between;
gap: 0.5rem;
}
.status {
min-height: 1rem;
}
.status-text {
font-size: 0.6875rem;
color: hsl(var(--color-muted-foreground));
}
.status-text.saved {
color: hsl(var(--color-success, var(--color-primary)));
}
.mode-btn {
display: inline-flex;
align-items: center;
gap: 0.375rem;
padding: 0.25rem 0.5rem;
border: 1px solid hsl(var(--color-border));
border-radius: 0.375rem;
background: transparent;
color: hsl(var(--color-foreground));
font-size: 0.75rem;
cursor: pointer;
transition:
background 0.15s,
border-color 0.15s;
}
.mode-btn:hover {
background: hsl(var(--color-surface-hover));
border-color: hsl(var(--color-ring));
}
.editor {
flex: 1;
min-height: 0;
width: 100%;
background: transparent;
border: 1px solid hsl(var(--color-border));
border-radius: 0.5rem;
padding: 0.75rem 0.875rem;
font-family:
ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', monospace;
font-size: 0.8125rem;
line-height: 1.55;
color: hsl(var(--color-foreground));
resize: none;
outline: none;
}
.editor:focus {
border-color: hsl(var(--color-ring));
}
.editor::placeholder {
color: hsl(var(--color-muted-foreground));
}
.empty {
flex: 1;
display: flex;
flex-direction: column;
align-items: center;
justify-content: center;
gap: 0.375rem;
background: transparent;
border: 1px dashed hsl(var(--color-border));
border-radius: 0.5rem;
color: hsl(var(--color-muted-foreground));
font-size: 0.875rem;
cursor: text;
}
.empty:hover {
border-color: hsl(var(--color-ring));
color: hsl(var(--color-foreground));
}
.empty .hint {
font-size: 0.6875rem;
opacity: 0.75;
}
.prose {
flex: 1;
overflow-y: auto;
color: hsl(var(--color-foreground));
font-size: 0.875rem;
line-height: 1.6;
padding-right: 0.25rem;
}
.prose :global(h1),
.prose :global(h2),
.prose :global(h3),
.prose :global(h4) {
margin: 1.25em 0 0.5em;
font-weight: 600;
line-height: 1.3;
}
.prose :global(h1) {
font-size: 1.375rem;
}
.prose :global(h2) {
font-size: 1.15rem;
}
.prose :global(h3) {
font-size: 1rem;
}
.prose :global(p) {
margin: 0.5em 0;
}
.prose :global(ul),
.prose :global(ol) {
margin: 0.5em 0;
padding-left: 1.25rem;
}
.prose :global(li) {
margin: 0.125em 0;
}
.prose :global(code) {
font-family:
ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', monospace;
font-size: 0.8125em;
padding: 0.1em 0.35em;
border-radius: 0.25rem;
background: hsl(var(--color-muted) / 0.5);
}
.prose :global(pre) {
padding: 0.75rem 0.875rem;
border-radius: 0.5rem;
background: hsl(var(--color-muted) / 0.5);
overflow-x: auto;
font-size: 0.8125em;
line-height: 1.5;
}
.prose :global(pre code) {
background: transparent;
padding: 0;
}
.prose :global(blockquote) {
margin: 0.75em 0;
padding: 0.25em 0.75em;
border-left: 3px solid hsl(var(--color-border));
color: hsl(var(--color-muted-foreground));
}
.prose :global(a) {
color: hsl(var(--color-primary));
text-decoration: underline;
text-underline-offset: 2px;
}
.prose :global(hr) {
border: none;
border-top: 1px solid hsl(var(--color-border));
margin: 1.25em 0;
}
.prose :global(strong) {
font-weight: 600;
}
</style>

View file

@ -0,0 +1,8 @@
/**
* Kontext module Dexie table accessor for the singleton document.
*/
import { db } from '$lib/data/database';
import type { LocalKontextDoc } from './types';
export const kontextDocTable = db.table<LocalKontextDoc>('kontextDoc');

View file

@ -0,0 +1,9 @@
/**
* Kontext module barrel exports.
*/
export { kontextStore } from './stores/kontext.svelte';
export { useKontextDoc, toKontextDoc } from './queries';
export { kontextDocTable } from './collections';
export { KONTEXT_SINGLETON_ID } from './types';
export type { LocalKontextDoc, KontextDoc } from './types';

View file

@ -0,0 +1,6 @@
import type { ModuleConfig } from '$lib/data/module-registry';
export const kontextModuleConfig: ModuleConfig = {
appId: 'kontext',
tables: [{ name: 'kontextDoc' }],
};

View file

@ -0,0 +1,32 @@
/**
* Kontext module reactive query for the singleton document.
*
* Content is encrypted at rest. Returns null until first write; the
* view calls kontextStore.ensureDoc() on mount to materialise the row.
*/
import { useLiveQueryWithDefault } from '@mana/local-store/svelte';
import { db } from '$lib/data/database';
import { decryptRecords } from '$lib/data/crypto';
import { KONTEXT_SINGLETON_ID, type KontextDoc, type LocalKontextDoc } from './types';
export function toKontextDoc(local: LocalKontextDoc): KontextDoc {
return {
id: local.id,
content: local.content ?? '',
createdAt: local.createdAt ?? new Date().toISOString(),
updatedAt: local.updatedAt ?? new Date().toISOString(),
};
}
export function useKontextDoc() {
return useLiveQueryWithDefault(
async () => {
const local = await db.table<LocalKontextDoc>('kontextDoc').get(KONTEXT_SINGLETON_ID);
if (!local || local.deletedAt) return null;
const [decrypted] = await decryptRecords('kontextDoc', [local]);
return decrypted ? toKontextDoc(decrypted) : null;
},
null as KontextDoc | null
);
}

View file

@ -0,0 +1,33 @@
/**
* Kontext Store singleton markdown document.
*
* `content` is encrypted at rest. The whole module is one row keyed by
* a fixed id so there's no list/detail just read/write.
*/
import { kontextDocTable } from '../collections';
import { encryptRecord } from '$lib/data/crypto';
import { KONTEXT_SINGLETON_ID, type LocalKontextDoc } from '../types';
export const kontextStore = {
async ensureDoc(): Promise<void> {
const existing = await kontextDocTable.get(KONTEXT_SINGLETON_ID);
if (existing) return;
const newLocal: LocalKontextDoc = {
id: KONTEXT_SINGLETON_ID,
content: '',
};
await encryptRecord('kontextDoc', newLocal);
await kontextDocTable.add(newLocal);
},
async setContent(content: string): Promise<void> {
await this.ensureDoc();
const diff: Partial<LocalKontextDoc> = {
content,
updatedAt: new Date().toISOString(),
};
await encryptRecord('kontextDoc', diff);
await kontextDocTable.update(KONTEXT_SINGLETON_ID, diff);
},
};

View file

@ -0,0 +1,19 @@
/**
* Kontext module types Singleton markdown document.
*/
import type { BaseRecord } from '@mana/local-store';
export const KONTEXT_SINGLETON_ID = 'singleton' as const;
export interface LocalKontextDoc extends BaseRecord {
id: typeof KONTEXT_SINGLETON_ID;
content: string;
}
export interface KontextDoc {
id: string;
content: string;
createdAt: string;
updatedAt: string;
}