@bis-code/study-dash 0.2.0

package/server/dist/dashboard/api.d.ts

@@ -0,0 +1,16 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { CurriculumService } from '../services/curriculum.js';
+import type { QAService } from '../services/qa.js';
+import type { VizService } from '../services/viz.js';
+import type { ExerciseService } from '../services/exercises.js';
+export declare function writeJSON(res: ServerResponse, data: unknown, status?: number): void;
+export declare function parseBody(req: IncomingMessage): Promise<unknown>;
+export declare function extractId(url: string, prefix: string): number | null;
+export declare function handleSubjects(curriculumSvc: CurriculumService): (_req: IncomingMessage, res: ServerResponse) => void;
+export declare function handlePhases(curriculumSvc: CurriculumService): (req: IncomingMessage, res: ServerResponse) => void;
+export declare function handleTopic(curriculumSvc: CurriculumService, qaSvc: QAService): (req: IncomingMessage, res: ServerResponse) => void;
+export declare function handleTopicViz(vizSvc: VizService): (req: IncomingMessage, res: ServerResponse) => void;
+export declare function handleTopicExercises(exerciseSvc: ExerciseService): (req: IncomingMessage, res: ServerResponse) => void;
+export declare function handleRunTests(exerciseSvc: ExerciseService): (req: IncomingMessage, res: ServerResponse) => Promise<void>;
+export declare function handleSubmitQuiz(exerciseSvc: ExerciseService): (req: IncomingMessage, res: ServerResponse) => Promise<void>;
+export declare function handleSearch(qaSvc: QAService): (req: IncomingMessage, res: ServerResponse) => void;

package/server/dist/dashboard/api.js

@@ -0,0 +1,150 @@
+// ── Helpers ────────────────────────────────────────────────────────────────
+export function writeJSON(res, data, status = 200) {
+    res.writeHead(status, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify(data));
+}
+function writeError(res, status, message) {
+    writeJSON(res, { error: message }, status);
+}
+export function parseBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on('data', (chunk) => chunks.push(chunk));
+        req.on('end', () => {
+            try {
+                resolve(JSON.parse(Buffer.concat(chunks).toString()));
+            }
+            catch (err) {
+                reject(new Error('Invalid JSON body'));
+            }
+        });
+        req.on('error', reject);
+    });
+}
+export function extractId(url, prefix) {
+    // e.g. prefix = "/api/topics/" -> extract "42" from "/api/topics/42" or "/api/topics/42/viz"
+    if (!url.startsWith(prefix))
+        return null;
+    const rest = url.slice(prefix.length);
+    const segment = rest.split('/')[0];
+    const num = Number(segment);
+    return Number.isFinite(num) && num > 0 ? num : null;
+}
+// ── Route handlers ─────────────────────────────────────────────────────────
+export function handleSubjects(curriculumSvc) {
+    return (_req, res) => {
+        const subjects = curriculumSvc.listSubjects();
+        const result = subjects.map((s) => ({
+            ...s,
+            progress: curriculumSvc.getProgress(s.id),
+        }));
+        writeJSON(res, result);
+    };
+}
+export function handlePhases(curriculumSvc) {
+    return (req, res) => {
+        const id = extractId(req.url ?? '', '/api/subjects/');
+        if (id === null) {
+            writeError(res, 400, 'Invalid subject ID');
+            return;
+        }
+        const phases = curriculumSvc.getCurriculum(id);
+        writeJSON(res, phases);
+    };
+}
+export function handleTopic(curriculumSvc, qaSvc) {
+    return (req, res) => {
+        const id = extractId(req.url ?? '', '/api/topics/');
+        if (id === null) {
+            writeError(res, 400, 'Invalid topic ID');
+            return;
+        }
+        const topic = curriculumSvc.getTopic(id);
+        if (!topic) {
+            writeError(res, 404, 'Topic not found');
+            return;
+        }
+        const entries = qaSvc.listEntries(id);
+        writeJSON(res, { ...topic, entries });
+    };
+}
+export function handleTopicViz(vizSvc) {
+    return (req, res) => {
+        const id = extractId(req.url ?? '', '/api/topics/');
+        if (id === null) {
+            writeError(res, 400, 'Invalid topic ID');
+            return;
+        }
+        const vizList = vizSvc.listForTopic(id);
+        writeJSON(res, vizList);
+    };
+}
+export function handleTopicExercises(exerciseSvc) {
+    return (req, res) => {
+        const id = extractId(req.url ?? '', '/api/topics/');
+        if (id === null) {
+            writeError(res, 400, 'Invalid topic ID');
+            return;
+        }
+        const exercises = exerciseSvc.listForTopic(id);
+        writeJSON(res, exercises);
+    };
+}
+export function handleRunTests(exerciseSvc) {
+    return async (req, res) => {
+        const id = extractId(req.url ?? '', '/api/exercises/');
+        if (id === null) {
+            writeError(res, 400, 'Invalid exercise ID');
+            return;
+        }
+        try {
+            const results = await exerciseSvc.runTests(id);
+            writeJSON(res, results);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            writeError(res, 500, msg);
+        }
+    };
+}
+export function handleSubmitQuiz(exerciseSvc) {
+    return async (req, res) => {
+        const id = extractId(req.url ?? '', '/api/exercises/');
+        if (id === null) {
+            writeError(res, 400, 'Invalid exercise ID');
+            return;
+        }
+        try {
+            const body = (await parseBody(req));
+            if (!Array.isArray(body?.answers)) {
+                writeError(res, 400, 'Request body must have an "answers" array');
+                return;
+            }
+            const result = exerciseSvc.submitQuiz(id, body.answers);
+            writeJSON(res, result);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            writeError(res, 500, msg);
+        }
+    };
+}
+export function handleSearch(qaSvc) {
+    return (req, res) => {
+        const url = new URL(req.url ?? '', 'http://localhost');
+        const query = url.searchParams.get('q') ?? '';
+        if (!query) {
+            writeJSON(res, []);
+            return;
+        }
+        try {
+            const results = qaSvc.search(query);
+            writeJSON(res, results);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            writeError(res, 500, msg);
+        }
+    };
+}
+//# sourceMappingURL=api.js.map

package/server/dist/dashboard/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/dashboard/api.ts"],"names":[],"mappings":"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"}

package/server/dist/dashboard/server.d.ts

@@ -0,0 +1,21 @@
+import type { CurriculumService } from '../services/curriculum.js';
+import type { QAService } from '../services/qa.js';
+import type { VizService } from '../services/viz.js';
+import type { ExerciseService } from '../services/exercises.js';
+export declare class DashboardServer {
+    private curriculumSvc;
+    private qaSvc;
+    private vizSvc;
+    private exerciseSvc;
+    private port;
+    private sseClients;
+    private httpServer;
+    constructor(curriculumSvc: CurriculumService, qaSvc: QAService, vizSvc: VizService, exerciseSvc: ExerciseService, port: number);
+    start(): void;
+    stop(): void;
+    notify(): void;
+    private handleRequest;
+    private handleSSE;
+    private routeAPI;
+    private serveStatic;
+}

package/server/dist/dashboard/server.js

@@ -0,0 +1,171 @@
+import http from 'node:http';
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { handleSubjects, handlePhases, handleTopic, handleTopicViz, handleTopicExercises, handleRunTests, handleSubmitQuiz, handleSearch, writeJSON, } from './api.js';
+// ── Embedded static content ──
+// At runtime (tsc output), read from disk.
+// In bundle mode, esbuild --loader:.html=text replaces these with inlined strings.
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const staticDir = join(__dirname, 'static');
+function loadStatic(name) {
+    try {
+        return readFileSync(join(staticDir, name), 'utf-8');
+    }
+    catch {
+        return '';
+    }
+}
+const indexHtml = loadStatic('index.html');
+const appJs = loadStatic('app.js');
+const stylesCss = loadStatic('styles.css');
+const STATIC_FILES = {
+    '/': { content: indexHtml, contentType: 'text/html; charset=utf-8' },
+    '/index.html': { content: indexHtml, contentType: 'text/html; charset=utf-8' },
+    '/app.js': { content: appJs, contentType: 'application/javascript; charset=utf-8' },
+    '/styles.css': { content: stylesCss, contentType: 'text/css; charset=utf-8' },
+};
+export class DashboardServer {
+    curriculumSvc;
+    qaSvc;
+    vizSvc;
+    exerciseSvc;
+    port;
+    sseClients = new Set();
+    httpServer = null;
+    constructor(curriculumSvc, qaSvc, vizSvc, exerciseSvc, port) {
+        this.curriculumSvc = curriculumSvc;
+        this.qaSvc = qaSvc;
+        this.vizSvc = vizSvc;
+        this.exerciseSvc = exerciseSvc;
+        this.port = port;
+    }
+    start() {
+        this.httpServer = http.createServer((req, res) => this.handleRequest(req, res));
+        this.httpServer.listen(this.port, '127.0.0.1', () => {
+            console.error(`Dashboard running at http://127.0.0.1:${this.port}`);
+        });
+    }
+    stop() {
+        if (this.httpServer) {
+            this.httpServer.close();
+            this.httpServer = null;
+        }
+    }
+    notify() {
+        const data = JSON.stringify({ type: 'update', ts: new Date().toISOString() });
+        const message = `data: ${data}\n\n`;
+        for (const client of this.sseClients) {
+            client.write(message);
+        }
+    }
+    // ── Request routing ────────────────────────────────────────────────────
+    handleRequest(req, res) {
+        const url = req.url ?? '/';
+        const method = req.method ?? 'GET';
+        // CSRF check for POST requests
+        if (method === 'POST') {
+            const origin = req.headers.origin ?? '';
+            if (origin && !origin.startsWith('http://localhost') && !origin.startsWith('http://127.0.0.1')) {
+                res.writeHead(403, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ error: 'Forbidden: invalid origin' }));
+                return;
+            }
+        }
+        // SSE endpoint
+        if (url === '/api/events' && method === 'GET') {
+            this.handleSSE(req, res);
+            return;
+        }
+        // API routes
+        if (url.startsWith('/api/')) {
+            this.routeAPI(method, url, req, res);
+            return;
+        }
+        // Static files
+        this.serveStatic(url, res);
+    }
+    // ── SSE ────────────────────────────────────────────────────────────────
+    handleSSE(_req, res) {
+        res.writeHead(200, {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache',
+            'Connection': 'keep-alive',
+            'Access-Control-Allow-Origin': '*',
+        });
+        // Send initial connected event
+        const connected = JSON.stringify({ type: 'connected', ts: new Date().toISOString() });
+        res.write(`data: ${connected}\n\n`);
+        this.sseClients.add(res);
+        res.on('close', () => {
+            this.sseClients.delete(res);
+        });
+    }
+    // ── API router ─────────────────────────────────────────────────────────
+    routeAPI(method, url, req, res) {
+        // Strip query string for pattern matching
+        const path = url.split('?')[0];
+        // GET /api/subjects
+        if (method === 'GET' && path === '/api/subjects') {
+            handleSubjects(this.curriculumSvc)(req, res);
+            return;
+        }
+        // GET /api/subjects/:id/phases
+        if (method === 'GET' && /^\/api\/subjects\/\d+\/phases$/.test(path)) {
+            handlePhases(this.curriculumSvc)(req, res);
+            return;
+        }
+        // GET /api/topics/:id/viz
+        if (method === 'GET' && /^\/api\/topics\/\d+\/viz$/.test(path)) {
+            handleTopicViz(this.vizSvc)(req, res);
+            return;
+        }
+        // GET /api/topics/:id/exercises
+        if (method === 'GET' && /^\/api\/topics\/\d+\/exercises$/.test(path)) {
+            handleTopicExercises(this.exerciseSvc)(req, res);
+            return;
+        }
+        // GET /api/topics/:id
+        if (method === 'GET' && /^\/api\/topics\/\d+$/.test(path)) {
+            handleTopic(this.curriculumSvc, this.qaSvc)(req, res);
+            return;
+        }
+        // POST /api/exercises/:id/run
+        if (method === 'POST' && /^\/api\/exercises\/\d+\/run$/.test(path)) {
+            handleRunTests(this.exerciseSvc)(req, res);
+            return;
+        }
+        // POST /api/exercises/:id/submit
+        if (method === 'POST' && /^\/api\/exercises\/\d+\/submit$/.test(path)) {
+            handleSubmitQuiz(this.exerciseSvc)(req, res);
+            return;
+        }
+        // GET /api/search?q=...
+        if (method === 'GET' && path === '/api/search') {
+            handleSearch(this.qaSvc)(req, res);
+            return;
+        }
+        // 404 for unknown API routes
+        writeJSON(res, { error: 'Not found' }, 404);
+    }
+    // ── Static file serving ────────────────────────────────────────────────
+    serveStatic(url, res) {
+        const file = STATIC_FILES[url];
+        if (file) {
+            res.writeHead(200, { 'Content-Type': file.contentType });
+            res.end(file.content);
+            return;
+        }
+        // Fallback: serve index.html for SPA routing
+        const index = STATIC_FILES['/'];
+        if (index) {
+            res.writeHead(200, { 'Content-Type': index.contentType });
+            res.end(index.content);
+            return;
+        }
+        res.writeHead(404, { 'Content-Type': 'text/plain' });
+        res.end('Not found');
+    }
+}
+//# sourceMappingURL=server.js.map

package/server/dist/dashboard/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/dashboard/server.ts"],"names":[],"mappings":"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"}

package/server/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/server/dist/index.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { Database } from './storage/db.js';
+import { FileStore } from './storage/files.js';
+import { CurriculumService } from './services/curriculum.js';
+import { QAService } from './services/qa.js';
+import { VizService } from './services/viz.js';
+import { ExerciseService } from './services/exercises.js';
+import { registerCurriculumTools } from './tools/curriculum.js';
+import { registerQATools } from './tools/qa.js';
+import { registerVizTools } from './tools/viz.js';
+import { registerExerciseTools } from './tools/exercises.js';
+import { DashboardServer } from './dashboard/server.js';
+const fileStore = new FileStore();
+const db = new Database(fileStore.dbPath);
+const sessions = new Map();
+const curriculumSvc = new CurriculumService(db);
+const qaSvc = new QAService(db);
+const vizSvc = new VizService(db);
+const exerciseSvc = new ExerciseService(db, fileStore);
+const port = Number(db.getSetting('dashboard_port') ?? '19282');
+const dashboard = new DashboardServer(curriculumSvc, qaSvc, vizSvc, exerciseSvc, port);
+const notify = () => dashboard.notify();
+const server = new McpServer({ name: 'study-dash', version: '0.1.0' });
+registerCurriculumTools(server, curriculumSvc, sessions, notify);
+registerQATools(server, qaSvc, sessions, notify);
+registerVizTools(server, vizSvc, sessions, notify);
+registerExerciseTools(server, exerciseSvc, sessions, notify);
+dashboard.start();
+async function run() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`study-dash MCP server running, dashboard at http://127.0.0.1:${port}`);
+}
+run().catch((err) => {
+    console.error('Fatal:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/server/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,MAAM,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC;AAClC,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAC1C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC;AAEjD,MAAM,aAAa,GAAG,IAAI,iBAAiB,CAAC,EAAE,CAAC,CAAC;AAChD,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,EAAE,CAAC,CAAC;AAChC,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;AAClC,MAAM,WAAW,GAAG,IAAI,eAAe,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;AAEvD,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,gBAAgB,CAAC,IAAI,OAAO,CAAC,CAAC;AAChE,MAAM,SAAS,GAAG,IAAI,eAAe,CAAC,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;AACvF,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;AAExC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AAEvE,uBAAuB,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AACjE,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AACjD,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AACnD,qBAAqB,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AAE7D,SAAS,CAAC,KAAK,EAAE,CAAC;AAElB,KAAK,UAAU,GAAG;IAChB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,gEAAgE,IAAI,EAAE,CAAC,CAAC;AACxF,CAAC;AAED,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAClB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/server/dist/services/curriculum.d.ts

@@ -0,0 +1,25 @@
+import { Database } from '../storage/db.js';
+import type { Subject, Topic, PhaseWithTopics, ProgressStats } from '../types.js';
+interface PhaseInput {
+    name: string;
+    description: string;
+    topics: Array<{
+        name: string;
+        description: string;
+    }>;
+}
+export declare class CurriculumService {
+    private db;
+    constructor(db: Database);
+    createSubject(name: string, language?: string, source?: Subject['source']): Subject;
+    listSubjects(): Subject[];
+    getSubject(id: number): Subject | undefined;
+    findSubjectByName(name: string): Subject | undefined;
+    importCurriculum(subjectId: number, phases: PhaseInput[]): void;
+    getCurriculum(subjectId: number): PhaseWithTopics[];
+    getProgress(subjectId: number): ProgressStats;
+    setTopicStatus(topicId: number, status: Topic['status']): void;
+    getTopic(id: number): Topic | undefined;
+    findTopic(subjectId: number, name: string): Topic | undefined;
+}
+export {};

package/server/dist/services/curriculum.js

@@ -0,0 +1,110 @@
+function slugify(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+export class CurriculumService {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    // ── Subjects ───────────────────────────────────────────────────────────────
+    createSubject(name, language = '', source = 'manual') {
+        const slug = language && !language.includes(' ') && name.toLowerCase() === language.toLowerCase()
+            ? language.toLowerCase()
+            : slugify(name);
+        const result = this.db.raw
+            .prepare('INSERT INTO subjects (name, slug, language, source) VALUES (?, ?, ?, ?) RETURNING id')
+            .get(name, slug, language, source);
+        return this.getSubject(result.id);
+    }
+    listSubjects() {
+        return this.db.raw
+            .prepare('SELECT * FROM subjects ORDER BY created_at DESC')
+            .all();
+    }
+    getSubject(id) {
+        return this.db.raw
+            .prepare('SELECT * FROM subjects WHERE id = ?')
+            .get(id);
+    }
+    findSubjectByName(name) {
+        return this.db.raw
+            .prepare('SELECT * FROM subjects WHERE lower(name) = lower(?)')
+            .get(name);
+    }
+    // ── Curriculum import ──────────────────────────────────────────────────────
+    importCurriculum(subjectId, phases) {
+        const insertPhase = this.db.raw.prepare('INSERT INTO phases (subject_id, name, description, sort_order) VALUES (?, ?, ?, ?) RETURNING id');
+        const insertTopic = this.db.raw.prepare('INSERT INTO topics (phase_id, name, description, sort_order) VALUES (?, ?, ?, ?)');
+        const run = this.db.raw.transaction(() => {
+            phases.forEach((phase, phaseIdx) => {
+                const phaseRow = insertPhase.get(subjectId, phase.name, phase.description, phaseIdx);
+                phase.topics.forEach((topic, topicIdx) => {
+                    insertTopic.run(phaseRow.id, topic.name, topic.description, topicIdx);
+                });
+            });
+        });
+        run();
+    }
+    getCurriculum(subjectId) {
+        const phases = this.db.raw
+            .prepare('SELECT * FROM phases WHERE subject_id = ? ORDER BY sort_order')
+            .all(subjectId);
+        const getTopics = this.db.raw.prepare('SELECT * FROM topics WHERE phase_id = ? ORDER BY sort_order');
+        return phases.map((phase) => ({
+            ...phase,
+            topics: getTopics.all(phase.id),
+        }));
+    }
+    // ── Progress ───────────────────────────────────────────────────────────────
+    getProgress(subjectId) {
+        const row = this.db.raw
+            .prepare(`WITH subject_topics AS (
+           SELECT t.id, t.status
+           FROM topics t
+           JOIN phases p ON p.id = t.phase_id
+           WHERE p.subject_id = :sid
+         )
+         SELECT
+           COUNT(*)                                                       AS total_topics,
+           SUM(CASE WHEN status = 'done'        THEN 1 ELSE 0 END)       AS done,
+           SUM(CASE WHEN status = 'in_progress' THEN 1 ELSE 0 END)       AS in_progress,
+           SUM(CASE WHEN status = 'todo'        THEN 1 ELSE 0 END)       AS todo,
+           (SELECT COUNT(*) FROM entries        WHERE topic_id IN (SELECT id FROM subject_topics)) AS total_entries,
+           (SELECT COUNT(*) FROM exercises      WHERE topic_id IN (SELECT id FROM subject_topics)) AS total_exercises,
+           (SELECT COUNT(*) FROM visualizations WHERE topic_id IN (SELECT id FROM subject_topics)) AS total_viz
+         FROM subject_topics`)
+            .get({ sid: subjectId });
+        return {
+            total_topics: row?.total_topics ?? 0,
+            done: row?.done ?? 0,
+            in_progress: row?.in_progress ?? 0,
+            todo: row?.todo ?? 0,
+            total_entries: row?.total_entries ?? 0,
+            total_exercises: row?.total_exercises ?? 0,
+            total_viz: row?.total_viz ?? 0,
+        };
+    }
+    // ── Topics ─────────────────────────────────────────────────────────────────
+    setTopicStatus(topicId, status) {
+        this.db.raw
+            .prepare("UPDATE topics SET status = ?, updated_at = datetime('now') WHERE id = ?")
+            .run(status, topicId);
+    }
+    getTopic(id) {
+        return this.db.raw
+            .prepare('SELECT * FROM topics WHERE id = ?')
+            .get(id);
+    }
+    findTopic(subjectId, name) {
+        return this.db.raw
+            .prepare(`SELECT t.* FROM topics t
+         JOIN phases p ON p.id = t.phase_id
+         WHERE p.subject_id = ? AND lower(t.name) = lower(?)
+         LIMIT 1`)
+            .get(subjectId, name);
+    }
+}
+//# sourceMappingURL=curriculum.js.map

package/server/dist/services/curriculum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"curriculum.js","sourceRoot":"","sources":["../../src/services/curriculum.ts"],"names":[],"mappings":"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"}

package/server/dist/services/exercises.d.ts

@@ -0,0 +1,35 @@
+import { Database } from '../storage/db.js';
+import { FileStore } from '../storage/files.js';
+import type { Exercise, ExerciseResult } from '../types.js';
+interface CreateExerciseData {
+    title: string;
+    type: Exercise['type'];
+    description: string;
+    difficulty?: Exercise['difficulty'];
+    est_minutes?: number;
+    source?: Exercise['source'];
+    starter_code?: string;
+    test_content?: string;
+    quiz_json?: string;
+}
+interface QuizSubmitResult {
+    score: number;
+    total: number;
+    passed: boolean;
+    results: Array<{
+        test_name: string;
+        passed: boolean;
+        output: string;
+    }>;
+}
+export declare class ExerciseService {
+    private db;
+    private fileStore;
+    constructor(db: Database, fileStore: FileStore);
+    createExercise(topicId: number, data: CreateExerciseData): Exercise;
+    runTests(exerciseId: number): Promise<ExerciseResult[]>;
+    submitQuiz(exerciseId: number, answers: (number | boolean | string)[]): QuizSubmitResult;
+    listForTopic(topicId: number): Exercise[];
+    private getSubjectForTopic;
+}
+export {};