@bis-code/study-dash 0.2.0

package/server/dist/services/exercises.js

@@ -0,0 +1,215 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+function slugify(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+function extensionForLanguage(language) {
+    switch (language) {
+        case 'go':
+            return '.go';
+        case 'python':
+            return '.py';
+        case 'rust':
+            return '.rs';
+        case 'javascript':
+        case 'typescript':
+            return '.ts';
+        default:
+            return '.txt';
+    }
+}
+export class ExerciseService {
+    db;
+    fileStore;
+    constructor(db, fileStore) {
+        this.db = db;
+        this.fileStore = fileStore;
+    }
+    createExercise(topicId, data) {
+        const { title, type, description, difficulty = 'medium', est_minutes = 0, source = 'ai', starter_code = '', test_content = '', quiz_json = '{}', } = data;
+        const result = this.db.raw
+            .prepare(`INSERT INTO exercises
+         (topic_id, title, type, description, difficulty, est_minutes, source, starter_code, test_content, quiz_json)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+         RETURNING id`)
+            .get(topicId, title, type, description, difficulty, est_minutes, source, starter_code, test_content, quiz_json);
+        const exerciseId = result.id;
+        // Write files for coding/project exercises with starter code
+        if ((type === 'coding' || type === 'project') && (starter_code || test_content)) {
+            const subject = this.getSubjectForTopic(topicId);
+            if (subject) {
+                const exerciseSlug = slugify(title);
+                const ext = extensionForLanguage(subject.language);
+                const files = {};
+                if (starter_code) {
+                    files[`main${ext}`] = starter_code;
+                }
+                if (test_content) {
+                    files[`main_test${ext}`] = test_content;
+                }
+                files['README.md'] = `# ${title}\n\n${description}`;
+                const filePath = this.fileStore.writeExerciseFiles(subject.slug, exerciseSlug, files);
+                this.db.raw
+                    .prepare('UPDATE exercises SET file_path = ? WHERE id = ?')
+                    .run(filePath, exerciseId);
+            }
+        }
+        return this.db.raw
+            .prepare('SELECT * FROM exercises WHERE id = ?')
+            .get(exerciseId);
+    }
+    async runTests(exerciseId) {
+        const exercise = this.db.raw
+            .prepare('SELECT * FROM exercises WHERE id = ?')
+            .get(exerciseId);
+        if (!exercise)
+            throw new Error(`Exercise ${exerciseId} not found`);
+        if (!exercise.file_path)
+            throw new Error(`Exercise ${exerciseId} has no file_path`);
+        const subject = this.getSubjectForTopic(exercise.topic_id);
+        if (!subject)
+            throw new Error(`No subject found for exercise ${exerciseId}`);
+        const commandMap = {
+            go: { command: 'go', args: ['test', '-json', '-count=1', './...'] },
+            python: { command: 'python3', args: ['-m', 'pytest', '--tb=short', '-q', '.'] },
+            rust: { command: 'cargo', args: ['test'] },
+            javascript: { command: 'npx', args: ['vitest', 'run'] },
+            typescript: { command: 'npx', args: ['vitest', 'run'] },
+        };
+        const config = commandMap[subject.language];
+        if (!config)
+            throw new Error(`Unsupported language: ${subject.language}`);
+        let stdout = '';
+        let stderr = '';
+        let exitCode = 0;
+        try {
+            const result = await execFileAsync(config.command, config.args, {
+                cwd: exercise.file_path,
+                timeout: 60_000,
+            });
+            stdout = result.stdout;
+            stderr = result.stderr;
+        }
+        catch (err) {
+            const execErr = err;
+            stdout = execErr.stdout ?? '';
+            stderr = execErr.stderr ?? '';
+            exitCode = execErr.code ?? 1;
+        }
+        // Parse results
+        const results = [];
+        if (subject.language === 'go') {
+            // Parse Go JSON test output
+            for (const line of stdout.split('\n')) {
+                if (!line.trim())
+                    continue;
+                try {
+                    const event = JSON.parse(line);
+                    if (event.Action === 'pass' && event.Test) {
+                        results.push({ test_name: event.Test, passed: true, output: '' });
+                    }
+                    else if (event.Action === 'fail' && event.Test) {
+                        results.push({ test_name: event.Test, passed: false, output: event.Output ?? '' });
+                    }
+                }
+                catch {
+                    // Skip non-JSON lines
+                }
+            }
+        }
+        // Fallback: if no per-test results parsed, use overall result
+        if (results.length === 0) {
+            results.push({
+                test_name: 'all',
+                passed: exitCode === 0,
+                output: stdout + stderr,
+            });
+        }
+        // Clear old results
+        this.db.raw
+            .prepare('DELETE FROM exercise_results WHERE exercise_id = ?')
+            .run(exerciseId);
+        // Insert new results
+        const insertResult = this.db.raw.prepare('INSERT INTO exercise_results (exercise_id, test_name, passed, output) VALUES (?, ?, ?, ?)');
+        for (const r of results) {
+            insertResult.run(exerciseId, r.test_name, r.passed ? 1 : 0, r.output);
+        }
+        // Update exercise status
+        const allPassed = results.every((r) => r.passed);
+        this.db.raw
+            .prepare('UPDATE exercises SET status = ? WHERE id = ?')
+            .run(allPassed ? 'passed' : 'failed', exerciseId);
+        return this.db.raw
+            .prepare('SELECT * FROM exercise_results WHERE exercise_id = ?')
+            .all(exerciseId);
+    }
+    submitQuiz(exerciseId, answers) {
+        const exercise = this.db.raw
+            .prepare('SELECT * FROM exercises WHERE id = ?')
+            .get(exerciseId);
+        if (!exercise)
+            throw new Error(`Exercise ${exerciseId} not found`);
+        const payload = JSON.parse(exercise.quiz_json);
+        const questions = payload.questions;
+        let correct = 0;
+        const results = [];
+        for (let i = 0; i < questions.length; i++) {
+            const q = questions[i];
+            const answer = answers[i];
+            let isCorrect = false;
+            switch (q.type) {
+                case 'multiple_choice':
+                    isCorrect = answer === q.correct;
+                    break;
+                case 'true_false':
+                    isCorrect = answer === q.correct;
+                    break;
+                case 'fill_in':
+                    isCorrect =
+                        String(answer).toLowerCase().trim() === String(q.correct).toLowerCase().trim();
+                    break;
+            }
+            if (isCorrect)
+                correct++;
+            results.push({
+                test_name: `Q${i + 1}: ${q.text}`,
+                passed: isCorrect,
+                output: isCorrect ? 'Correct' : `Wrong. Expected: ${q.correct}, Got: ${answer}`,
+            });
+        }
+        const score = questions.length > 0 ? correct / questions.length : 0;
+        const passed = score >= 0.7;
+        // Clear old results
+        this.db.raw
+            .prepare('DELETE FROM exercise_results WHERE exercise_id = ?')
+            .run(exerciseId);
+        // Insert per-question results
+        const insertResult = this.db.raw.prepare('INSERT INTO exercise_results (exercise_id, test_name, passed, output) VALUES (?, ?, ?, ?)');
+        for (const r of results) {
+            insertResult.run(exerciseId, r.test_name, r.passed ? 1 : 0, r.output);
+        }
+        // Update exercise status
+        this.db.raw
+            .prepare('UPDATE exercises SET status = ? WHERE id = ?')
+            .run(passed ? 'passed' : 'failed', exerciseId);
+        return { score, total: questions.length, passed, results };
+    }
+    listForTopic(topicId) {
+        return this.db.raw
+            .prepare('SELECT * FROM exercises WHERE topic_id = ? ORDER BY created_at ASC, id ASC')
+            .all(topicId);
+    }
+    getSubjectForTopic(topicId) {
+        return this.db.raw
+            .prepare(`SELECT s.* FROM subjects s
+         JOIN phases p ON p.subject_id = s.id
+         JOIN topics t ON t.phase_id = p.id
+         WHERE t.id = ?`)
+            .get(topicId);
+    }
+}
+//# sourceMappingURL=exercises.js.map

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

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

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

@@ -0,0 +1,15 @@
+import { Database } from '../storage/db.js';
+import type { Entry } from '../types.js';
+export declare class QAService {
+    private db;
+    constructor(db: Database);
+    logEntry(topicId: number, kind: Entry['kind'], content: string, sessionId?: string, questionId?: number): Entry;
+    listEntries(topicId: number): Entry[];
+    search(query: string): {
+        id: number;
+        topic_id: number;
+        kind: string;
+        content: string;
+        created_at: string;
+    }[];
+}

package/server/dist/services/qa.js

@@ -0,0 +1,30 @@
+export class QAService {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    logEntry(topicId, kind, content, sessionId, questionId) {
+        const result = this.db.raw
+            .prepare('INSERT INTO entries (topic_id, kind, content, session_id, question_id) VALUES (?, ?, ?, ?, ?) RETURNING id')
+            .get(topicId, kind, content, sessionId ?? '', questionId ?? null);
+        return this.db.raw
+            .prepare('SELECT * FROM entries WHERE id = ?')
+            .get(result.id);
+    }
+    listEntries(topicId) {
+        return this.db.raw
+            .prepare('SELECT * FROM entries WHERE topic_id = ? ORDER BY created_at ASC')
+            .all(topicId);
+    }
+    search(query) {
+        return this.db.raw
+            .prepare(`SELECT e.id, e.topic_id, e.kind, e.content, e.created_at
+         FROM entries e
+         JOIN entries_fts ON entries_fts.rowid = e.id
+         WHERE entries_fts MATCH ?
+         ORDER BY e.created_at ASC
+         LIMIT 50`)
+            .all(query);
+    }
+}
+//# sourceMappingURL=qa.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"qa.js","sourceRoot":"","sources":["../../src/services/qa.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,SAAS;IACA;IAApB,YAAoB,EAAY;QAAZ,OAAE,GAAF,EAAE,CAAU;IAAG,CAAC;IAEpC,QAAQ,CACN,OAAe,EACf,IAAmB,EACnB,OAAe,EACf,SAAkB,EAClB,UAAmB;QAEnB,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG;aACvB,OAAO,CAIN,4GAA4G,CAC7G;aACA,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,IAAI,EAAE,EAAE,UAAU,IAAI,IAAI,CAAC,CAAC;QAEpE,OAAO,IAAI,CAAC,EAAE,CAAC,GAAG;aACf,OAAO,CAAkB,oCAAoC,CAAC;aAC9D,GAAG,CAAC,MAAO,CAAC,EAAE,CAAE,CAAC;IACtB,CAAC;IAED,WAAW,CAAC,OAAe;QACzB,OAAO,IAAI,CAAC,EAAE,CAAC,GAAG;aACf,OAAO,CACN,kEAAkE,CACnE;aACA,GAAG,CAAC,OAAO,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,CAAC,KAAa;QAClB,OAAO,IAAI,CAAC,EAAE,CAAC,GAAG;aACf,OAAO,CAIN;;;;;kBAKU,CACX;aACA,GAAG,CAAC,KAAK,CAAC,CAAC;IAChB,CAAC;CACF"}

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

@@ -0,0 +1,8 @@
+import { Database } from '../storage/db.js';
+import type { Visualization, VizStep } from '../types.js';
+export declare class VizService {
+    private db;
+    constructor(db: Database);
+    create(topicId: number, title: string, steps: VizStep[]): Visualization;
+    listForTopic(topicId: number): Visualization[];
+}

package/server/dist/services/viz.js

@@ -0,0 +1,21 @@
+export class VizService {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    create(topicId, title, steps) {
+        const stepsJson = JSON.stringify(steps);
+        const result = this.db.raw
+            .prepare('INSERT INTO visualizations (topic_id, title, steps_json) VALUES (?, ?, ?) RETURNING id')
+            .get(topicId, title, stepsJson);
+        return this.db.raw
+            .prepare('SELECT * FROM visualizations WHERE id = ?')
+            .get(result.id);
+    }
+    listForTopic(topicId) {
+        return this.db.raw
+            .prepare('SELECT * FROM visualizations WHERE topic_id = ? ORDER BY created_at DESC, id DESC')
+            .all(topicId);
+    }
+}
+//# sourceMappingURL=viz.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"viz.js","sourceRoot":"","sources":["../../src/services/viz.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,UAAU;IACD;IAApB,YAAoB,EAAY;QAAZ,OAAE,GAAF,EAAE,CAAU;IAAG,CAAC;IAEpC,MAAM,CAAC,OAAe,EAAE,KAAa,EAAE,KAAgB;QACrD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAExC,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG;aACvB,OAAO,CACN,wFAAwF,CACzF;aACA,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;QAElC,OAAO,IAAI,CAAC,EAAE,CAAC,GAAG;aACf,OAAO,CAA0B,2CAA2C,CAAC;aAC7E,GAAG,CAAC,MAAO,CAAC,EAAE,CAAE,CAAC;IACtB,CAAC;IAED,YAAY,CAAC,OAAe;QAC1B,OAAO,IAAI,CAAC,EAAE,CAAC,GAAG;aACf,OAAO,CACN,mFAAmF,CACpF;aACA,GAAG,CAAC,OAAO,CAAC,CAAC;IAClB,CAAC;CACF"}

package/server/dist/storage/db.d.ts

@@ -0,0 +1,11 @@
+import BetterSqlite3 from 'better-sqlite3';
+export declare class Database {
+    private db;
+    constructor(dbPath: string);
+    getSetting(key: string): string | undefined;
+    setSetting(key: string, value: string): void;
+    listTables(): string[];
+    /** Expose the raw better-sqlite3 handle for advanced operations. */
+    get raw(): BetterSqlite3.Database;
+    close(): void;
+}

package/server/dist/storage/db.js

@@ -0,0 +1,51 @@
+import BetterSqlite3 from 'better-sqlite3';
+import { schema, migrations } from './schema.js';
+export class Database {
+    db;
+    constructor(dbPath) {
+        this.db = new BetterSqlite3(dbPath);
+        // Performance + integrity PRAGMAs
+        this.db.pragma('journal_mode=WAL');
+        this.db.pragma('foreign_keys=ON');
+        // Apply schema (all CREATE IF NOT EXISTS — safe to re-run)
+        this.db.exec(schema);
+        // Seed defaults on first initialisation
+        const currentVersion = this.getSetting('schema_version');
+        if (!currentVersion) {
+            this.setSetting('schema_version', '1');
+            this.setSetting('auto_viz', 'true');
+            this.setSetting('dashboard_port', '19282');
+        }
+        // Run any pending migrations beyond the baseline
+        const versionNum = parseInt(this.getSetting('schema_version') ?? '1', 10);
+        for (let i = versionNum - 1; i < migrations.length; i++) {
+            this.db.exec(migrations[i]);
+            this.setSetting('schema_version', String(i + 2));
+        }
+    }
+    getSetting(key) {
+        const row = this.db
+            .prepare('SELECT value FROM settings WHERE key = ?')
+            .get(key);
+        return row?.value;
+    }
+    setSetting(key, value) {
+        this.db
+            .prepare('INSERT INTO settings (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value')
+            .run(key, value);
+    }
+    listTables() {
+        const allRows = this.db
+            .prepare("SELECT name FROM sqlite_master WHERE type IN ('table')")
+            .all();
+        return allRows.map((r) => r.name);
+    }
+    /** Expose the raw better-sqlite3 handle for advanced operations. */
+    get raw() {
+        return this.db;
+    }
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=db.js.map

package/server/dist/storage/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../../src/storage/db.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,OAAO,QAAQ;IACX,EAAE,CAAyB;IAEnC,YAAY,MAAc;QACxB,IAAI,CAAC,EAAE,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QAEpC,kCAAkC;QAClC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;QACnC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAElC,2DAA2D;QAC3D,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAErB,wCAAwC;QACxC,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;QACzD,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,IAAI,CAAC,UAAU,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;YACvC,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACpC,IAAI,CAAC,UAAU,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;QAC7C,CAAC;QAED,iDAAiD;QACjD,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;QAC1E,KAAK,IAAI,CAAC,GAAG,UAAU,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxD,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5B,IAAI,CAAC,UAAU,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,UAAU,CAAC,GAAW;QACpB,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE;aAChB,OAAO,CAA8B,0CAA0C,CAAC;aAChF,GAAG,CAAC,GAAG,CAAC,CAAC;QACZ,OAAO,GAAG,EAAE,KAAK,CAAC;IACpB,CAAC;IAED,UAAU,CAAC,GAAW,EAAE,KAAa;QACnC,IAAI,CAAC,EAAE;aACJ,OAAO,CAAC,uGAAuG,CAAC;aAChH,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACrB,CAAC;IAED,UAAU;QACR,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE;aACpB,OAAO,CAAuB,wDAAwD,CAAC;aACvF,GAAG,EAAE,CAAC;QACT,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,oEAAoE;IACpE,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;CACF"}

package/server/dist/storage/files.d.ts

@@ -0,0 +1,10 @@
+export declare class FileStore {
+    private baseDir;
+    constructor(baseDir?: string);
+    get exercisesDir(): string;
+    get dataDir(): string;
+    get dbPath(): string;
+    writeExerciseFiles(subjectSlug: string, exerciseSlug: string, files: Record<string, string>): string;
+    exerciseExists(subjectSlug: string, exerciseSlug: string): boolean;
+    readFile(path: string): string;
+}

package/server/dist/storage/files.js

@@ -0,0 +1,34 @@
+import { mkdirSync, writeFileSync, existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+export class FileStore {
+    baseDir;
+    constructor(baseDir) {
+        this.baseDir = baseDir ?? join(homedir(), '.claude', 'learn');
+        mkdirSync(join(this.baseDir, 'exercises'), { recursive: true });
+    }
+    get exercisesDir() {
+        return join(this.baseDir, 'exercises');
+    }
+    get dataDir() {
+        return this.baseDir;
+    }
+    get dbPath() {
+        return join(this.baseDir, 'data.db');
+    }
+    writeExerciseFiles(subjectSlug, exerciseSlug, files) {
+        const dir = join(this.exercisesDir, subjectSlug, exerciseSlug);
+        mkdirSync(dir, { recursive: true });
+        for (const [name, content] of Object.entries(files)) {
+            writeFileSync(join(dir, name), content, 'utf-8');
+        }
+        return dir;
+    }
+    exerciseExists(subjectSlug, exerciseSlug) {
+        return existsSync(join(this.exercisesDir, subjectSlug, exerciseSlug));
+    }
+    readFile(path) {
+        return readFileSync(path, 'utf-8');
+    }
+}
+//# sourceMappingURL=files.js.map

package/server/dist/storage/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/storage/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,MAAM,OAAO,SAAS;IACZ,OAAO,CAAS;IAExB,YAAY,OAAgB;QAC1B,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAC9D,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACvC,CAAC;IAED,kBAAkB,CAAC,WAAmB,EAAE,YAAoB,EAAE,KAA6B;QACzF,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;QAC/D,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpC,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACpD,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,cAAc,CAAC,WAAmB,EAAE,YAAoB;QACtD,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,QAAQ,CAAC,IAAY;QACnB,OAAO,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;CACF"}

package/server/dist/storage/schema.d.ts

@@ -0,0 +1,3 @@
+export declare const schema = "\nPRAGMA foreign_keys=ON;\n\nCREATE TABLE IF NOT EXISTS subjects (\n  id         INTEGER PRIMARY KEY AUTOINCREMENT,\n  name       TEXT    NOT NULL,\n  slug       TEXT    NOT NULL UNIQUE,\n  language   TEXT    NOT NULL DEFAULT '',\n  source     TEXT    NOT NULL DEFAULT 'manual'\n               CHECK (source IN ('manual','roadmap','pdf')),\n  created_at TEXT    NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE TABLE IF NOT EXISTS phases (\n  id          INTEGER PRIMARY KEY AUTOINCREMENT,\n  subject_id  INTEGER NOT NULL REFERENCES subjects(id) ON DELETE CASCADE,\n  name        TEXT    NOT NULL,\n  description TEXT    NOT NULL DEFAULT '',\n  sort_order  INTEGER NOT NULL DEFAULT 0\n);\n\nCREATE INDEX IF NOT EXISTS idx_phases_subject ON phases(subject_id);\n\nCREATE TABLE IF NOT EXISTS topics (\n  id          INTEGER PRIMARY KEY AUTOINCREMENT,\n  phase_id    INTEGER NOT NULL REFERENCES phases(id) ON DELETE CASCADE,\n  name        TEXT    NOT NULL,\n  description TEXT    NOT NULL DEFAULT '',\n  sort_order  INTEGER NOT NULL DEFAULT 0,\n  status      TEXT    NOT NULL DEFAULT 'todo'\n                CHECK (status IN ('todo','in_progress','done')),\n  updated_at  TEXT    NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE INDEX IF NOT EXISTS idx_topics_phase  ON topics(phase_id);\nCREATE INDEX IF NOT EXISTS idx_topics_status ON topics(status);\n\nCREATE TABLE IF NOT EXISTS entries (\n  id          INTEGER PRIMARY KEY AUTOINCREMENT,\n  topic_id    INTEGER NOT NULL REFERENCES topics(id) ON DELETE CASCADE,\n  kind        TEXT    NOT NULL CHECK (kind IN ('question','answer','note')),\n  content     TEXT    NOT NULL DEFAULT '',\n  session_id  TEXT    NOT NULL DEFAULT '',\n  question_id INTEGER REFERENCES entries(id) ON DELETE SET NULL,\n  created_at  TEXT    NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE INDEX IF NOT EXISTS idx_entries_topic   ON entries(topic_id);\nCREATE INDEX IF NOT EXISTS idx_entries_session ON entries(session_id);\n\nCREATE TABLE IF NOT EXISTS visualizations (\n  id         INTEGER PRIMARY KEY AUTOINCREMENT,\n  topic_id   INTEGER NOT NULL REFERENCES topics(id) ON DELETE CASCADE,\n  title      TEXT    NOT NULL DEFAULT '',\n  steps_json TEXT    NOT NULL DEFAULT '[]',\n  created_at TEXT    NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE INDEX IF NOT EXISTS idx_viz_topic ON visualizations(topic_id);\n\nCREATE TABLE IF NOT EXISTS exercises (\n  id           INTEGER PRIMARY KEY AUTOINCREMENT,\n  topic_id     INTEGER NOT NULL REFERENCES topics(id) ON DELETE CASCADE,\n  title        TEXT    NOT NULL DEFAULT '',\n  type         TEXT    NOT NULL DEFAULT 'coding'\n                 CHECK (type IN ('coding','quiz','project','assignment')),\n  description  TEXT    NOT NULL DEFAULT '',\n  difficulty   TEXT    NOT NULL DEFAULT 'medium'\n                 CHECK (difficulty IN ('easy','medium','hard')),\n  est_minutes  INTEGER NOT NULL DEFAULT 0,\n  source       TEXT    NOT NULL DEFAULT 'ai'\n                 CHECK (source IN ('ai','pdf_import')),\n  starter_code TEXT    NOT NULL DEFAULT '',\n  test_content TEXT    NOT NULL DEFAULT '',\n  quiz_json    TEXT    NOT NULL DEFAULT '{}',\n  file_path    TEXT    NOT NULL DEFAULT '',\n  status       TEXT    NOT NULL DEFAULT 'pending'\n                 CHECK (status IN ('pending','in_progress','passed','failed')),\n  created_at   TEXT    NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE INDEX IF NOT EXISTS idx_exercises_topic  ON exercises(topic_id);\nCREATE INDEX IF NOT EXISTS idx_exercises_status ON exercises(status);\n\nCREATE TABLE IF NOT EXISTS exercise_results (\n  id          INTEGER PRIMARY KEY AUTOINCREMENT,\n  exercise_id INTEGER NOT NULL REFERENCES exercises(id) ON DELETE CASCADE,\n  test_name   TEXT    NOT NULL DEFAULT '',\n  passed      INTEGER NOT NULL DEFAULT 0,\n  output      TEXT    NOT NULL DEFAULT '',\n  ran_at      TEXT    NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE INDEX IF NOT EXISTS idx_results_exercise ON exercise_results(exercise_id);\n\nCREATE TABLE IF NOT EXISTS settings (\n  key   TEXT PRIMARY KEY,\n  value TEXT NOT NULL DEFAULT ''\n);\n\n-- FTS5 virtual table for full-text search over entries\nCREATE VIRTUAL TABLE IF NOT EXISTS entries_fts\n  USING fts5(content, content='entries', content_rowid='id');\n\n-- Sync triggers: keep entries_fts up to date with entries\nCREATE TRIGGER IF NOT EXISTS entries_ai\n  AFTER INSERT ON entries BEGIN\n    INSERT INTO entries_fts(rowid, content) VALUES (new.id, new.content);\n  END;\n\nCREATE TRIGGER IF NOT EXISTS entries_ad\n  AFTER DELETE ON entries BEGIN\n    INSERT INTO entries_fts(entries_fts, rowid, content)\n      VALUES ('delete', old.id, old.content);\n  END;\n\nCREATE TRIGGER IF NOT EXISTS entries_au\n  AFTER UPDATE ON entries BEGIN\n    INSERT INTO entries_fts(entries_fts, rowid, content)\n      VALUES ('delete', old.id, old.content);\n    INSERT INTO entries_fts(rowid, content) VALUES (new.id, new.content);\n  END;\n";
+/** Future migrations appended here in order (v1 is baseline — empty). */
+export declare const migrations: string[];

package/server/dist/storage/schema.js

@@ -0,0 +1,126 @@
+export const schema = `
+PRAGMA foreign_keys=ON;
+
+CREATE TABLE IF NOT EXISTS subjects (
+  id         INTEGER PRIMARY KEY AUTOINCREMENT,
+  name       TEXT    NOT NULL,
+  slug       TEXT    NOT NULL UNIQUE,
+  language   TEXT    NOT NULL DEFAULT '',
+  source     TEXT    NOT NULL DEFAULT 'manual'
+               CHECK (source IN ('manual','roadmap','pdf')),
+  created_at TEXT    NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS phases (
+  id          INTEGER PRIMARY KEY AUTOINCREMENT,
+  subject_id  INTEGER NOT NULL REFERENCES subjects(id) ON DELETE CASCADE,
+  name        TEXT    NOT NULL,
+  description TEXT    NOT NULL DEFAULT '',
+  sort_order  INTEGER NOT NULL DEFAULT 0
+);
+
+CREATE INDEX IF NOT EXISTS idx_phases_subject ON phases(subject_id);
+
+CREATE TABLE IF NOT EXISTS topics (
+  id          INTEGER PRIMARY KEY AUTOINCREMENT,
+  phase_id    INTEGER NOT NULL REFERENCES phases(id) ON DELETE CASCADE,
+  name        TEXT    NOT NULL,
+  description TEXT    NOT NULL DEFAULT '',
+  sort_order  INTEGER NOT NULL DEFAULT 0,
+  status      TEXT    NOT NULL DEFAULT 'todo'
+                CHECK (status IN ('todo','in_progress','done')),
+  updated_at  TEXT    NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_topics_phase  ON topics(phase_id);
+CREATE INDEX IF NOT EXISTS idx_topics_status ON topics(status);
+
+CREATE TABLE IF NOT EXISTS entries (
+  id          INTEGER PRIMARY KEY AUTOINCREMENT,
+  topic_id    INTEGER NOT NULL REFERENCES topics(id) ON DELETE CASCADE,
+  kind        TEXT    NOT NULL CHECK (kind IN ('question','answer','note')),
+  content     TEXT    NOT NULL DEFAULT '',
+  session_id  TEXT    NOT NULL DEFAULT '',
+  question_id INTEGER REFERENCES entries(id) ON DELETE SET NULL,
+  created_at  TEXT    NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_entries_topic   ON entries(topic_id);
+CREATE INDEX IF NOT EXISTS idx_entries_session ON entries(session_id);
+
+CREATE TABLE IF NOT EXISTS visualizations (
+  id         INTEGER PRIMARY KEY AUTOINCREMENT,
+  topic_id   INTEGER NOT NULL REFERENCES topics(id) ON DELETE CASCADE,
+  title      TEXT    NOT NULL DEFAULT '',
+  steps_json TEXT    NOT NULL DEFAULT '[]',
+  created_at TEXT    NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_viz_topic ON visualizations(topic_id);
+
+CREATE TABLE IF NOT EXISTS exercises (
+  id           INTEGER PRIMARY KEY AUTOINCREMENT,
+  topic_id     INTEGER NOT NULL REFERENCES topics(id) ON DELETE CASCADE,
+  title        TEXT    NOT NULL DEFAULT '',
+  type         TEXT    NOT NULL DEFAULT 'coding'
+                 CHECK (type IN ('coding','quiz','project','assignment')),
+  description  TEXT    NOT NULL DEFAULT '',
+  difficulty   TEXT    NOT NULL DEFAULT 'medium'
+                 CHECK (difficulty IN ('easy','medium','hard')),
+  est_minutes  INTEGER NOT NULL DEFAULT 0,
+  source       TEXT    NOT NULL DEFAULT 'ai'
+                 CHECK (source IN ('ai','pdf_import')),
+  starter_code TEXT    NOT NULL DEFAULT '',
+  test_content TEXT    NOT NULL DEFAULT '',
+  quiz_json    TEXT    NOT NULL DEFAULT '{}',
+  file_path    TEXT    NOT NULL DEFAULT '',
+  status       TEXT    NOT NULL DEFAULT 'pending'
+                 CHECK (status IN ('pending','in_progress','passed','failed')),
+  created_at   TEXT    NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_exercises_topic  ON exercises(topic_id);
+CREATE INDEX IF NOT EXISTS idx_exercises_status ON exercises(status);
+
+CREATE TABLE IF NOT EXISTS exercise_results (
+  id          INTEGER PRIMARY KEY AUTOINCREMENT,
+  exercise_id INTEGER NOT NULL REFERENCES exercises(id) ON DELETE CASCADE,
+  test_name   TEXT    NOT NULL DEFAULT '',
+  passed      INTEGER NOT NULL DEFAULT 0,
+  output      TEXT    NOT NULL DEFAULT '',
+  ran_at      TEXT    NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_results_exercise ON exercise_results(exercise_id);
+
+CREATE TABLE IF NOT EXISTS settings (
+  key   TEXT PRIMARY KEY,
+  value TEXT NOT NULL DEFAULT ''
+);
+
+-- FTS5 virtual table for full-text search over entries
+CREATE VIRTUAL TABLE IF NOT EXISTS entries_fts
+  USING fts5(content, content='entries', content_rowid='id');
+
+-- Sync triggers: keep entries_fts up to date with entries
+CREATE TRIGGER IF NOT EXISTS entries_ai
+  AFTER INSERT ON entries BEGIN
+    INSERT INTO entries_fts(rowid, content) VALUES (new.id, new.content);
+  END;
+
+CREATE TRIGGER IF NOT EXISTS entries_ad
+  AFTER DELETE ON entries BEGIN
+    INSERT INTO entries_fts(entries_fts, rowid, content)
+      VALUES ('delete', old.id, old.content);
+  END;
+
+CREATE TRIGGER IF NOT EXISTS entries_au
+  AFTER UPDATE ON entries BEGIN
+    INSERT INTO entries_fts(entries_fts, rowid, content)
+      VALUES ('delete', old.id, old.content);
+    INSERT INTO entries_fts(rowid, content) VALUES (new.id, new.content);
+  END;
+`;
+/** Future migrations appended here in order (v1 is baseline — empty). */
+export const migrations = [];
+//# sourceMappingURL=schema.js.map

package/server/dist/storage/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/storage/schema.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0HrB,CAAC;AAEF,yEAAyE;AACzE,MAAM,CAAC,MAAM,UAAU,GAAa,EAAE,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { CurriculumService } from '../services/curriculum.js';
+import type { SessionState } from '../types.js';
+export declare function registerCurriculumTools(server: McpServer, svc: CurriculumService, sessions: Map<string, SessionState>, notify: () => void): void;