feat(apps): create Hono compute servers for Context, ManaDeck, Questions

Context (Port 3020): AI text generation with document context
ManaDeck (Port 3009): AI deck/card generation + image-to-cards
Questions (Port 3011): Web research via mana-search (3 depth levels)

All use @manacore/shared-hono for auth and credits. ~100-140 LOC each.

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

apps/context/apps/server/package.json

@@ -0,0 +1,19 @@
+{
+	"name": "@context/server",
+	"version": "0.1.0",
+	"private": true,
+	"type": "module",
+	"scripts": {
+		"dev": "bun run --watch src/index.ts",
+		"start": "bun run src/index.ts"
+	},
+	"dependencies": {
+		"@manacore/shared-hono": "workspace:*",
+		"hono": "^4.7.0",
+		"drizzle-orm": "^0.38.3",
+		"postgres": "^3.4.5"
+	},
+	"devDependencies": {
+		"typescript": "^5.9.3"
+	}
+}

apps/context/apps/server/src/index.ts

@@ -0,0 +1,94 @@
+/**
+ * Context Hono Server — AI text generation + token management
+ *
+ * CRUD for spaces/documents handled by mana-sync.
+ */
+
+import { Hono } from 'hono';
+import { cors } from 'hono/cors';
+import { authMiddleware, healthRoute, errorHandler, notFoundHandler } from '@manacore/shared-hono';
+import { consumeCredits, validateCredits } from '@manacore/shared-hono/credits';
+
+const PORT = parseInt(process.env.PORT || '3020', 10);
+const LLM_URL = process.env.MANA_LLM_URL || 'http://localhost:3025';
+const CORS_ORIGINS = (process.env.CORS_ORIGINS || 'http://localhost:5192').split(',');
+
+const app = new Hono();
+
+app.onError(errorHandler);
+app.notFound(notFoundHandler);
+app.use('*', cors({ origin: CORS_ORIGINS, credentials: true }));
+app.route('/health', healthRoute('context-server'));
+app.use('/api/*', authMiddleware());
+
+// ─── AI Generation (server-only: mana-llm) ──────────────────
+
+app.post('/api/v1/ai/generate', async (c) => {
+	const userId = c.get('userId');
+	const { prompt, documents, model, maxTokens } = await c.req.json();
+
+	if (!prompt) return c.json({ error: 'prompt required' }, 400);
+
+	// Validate credits
+	const validation = await validateCredits(userId, 'AI_CONTEXT_GENERATE', 5);
+	if (!validation.hasCredits) {
+		return c.json(
+			{ error: 'Insufficient credits', required: 5, available: validation.availableCredits },
+			402
+		);
+	}
+
+	try {
+		// Build messages with document context
+		const messages: Array<{ role: string; content: string }> = [];
+
+		if (documents?.length) {
+			const contextText = documents
+				.map((d: { title: string; content: string }) => `--- ${d.title} ---\n${d.content}`)
+				.join('\n\n');
+			messages.push({
+				role: 'system',
+				content: `Verwende diese Dokumente als Kontext:\n\n${contextText}`,
+			});
+		}
+
+		messages.push({ role: 'user', content: prompt });
+
+		const res = await fetch(`${LLM_URL}/api/v1/chat/completions`, {
+			method: 'POST',
+			headers: { 'Content-Type': 'application/json' },
+			body: JSON.stringify({
+				messages,
+				model: model || 'gemma3:4b',
+				max_tokens: maxTokens || 2000,
+			}),
+		});
+
+		if (!res.ok) return c.json({ error: 'AI generation failed' }, 502);
+
+		const data = await res.json();
+		const content = data.choices?.[0]?.message?.content || '';
+		const tokensUsed = data.usage?.total_tokens || 0;
+
+		// Consume credits
+		await consumeCredits(userId, 'AI_CONTEXT_GENERATE', 5, `AI generation (${tokensUsed} tokens)`);
+
+		return c.json({ content, tokensUsed, model: model || 'gemma3:4b' });
+	} catch (_err) {
+		return c.json({ error: 'Generation failed' }, 500);
+	}
+});
+
+app.post('/api/v1/ai/estimate', async (c) => {
+	const { prompt, documents } = await c.req.json();
+	const charCount =
+		(prompt?.length || 0) +
+		(documents || []).reduce(
+			(sum: number, d: { content: string }) => sum + (d.content?.length || 0),
+			0
+		);
+	const estimatedTokens = Math.ceil(charCount / 4);
+	return c.json({ estimatedTokens, estimatedCost: 5 });
+});
+
+export default { port: PORT, fetch: app.fetch };

apps/context/apps/server/tsconfig.json

@@ -0,0 +1,11 @@
+{
+	"compilerOptions": {
+		"target": "ESNext",
+		"module": "ESNext",
+		"moduleResolution": "bundler",
+		"strict": true,
+		"esModuleInterop": true,
+		"skipLibCheck": true
+	},
+	"include": ["src/**/*.ts"]
+}