@ai-uni/mcp-server 0.1.0

package/dist/auth.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Resolve the AI_UNI_TOKEN env var to a student ID.
+ * Caches the result so Supabase is only queried once per server lifetime.
+ * Updates last_used_at on first call.
+ */
+export declare function getStudentId(): Promise<string>;

package/dist/auth.js

@@ -0,0 +1,35 @@
+import crypto from "crypto";
+import { supabase } from "./supabase.js";
+let cachedStudentId = null;
+function hashToken(token) {
+    return crypto.createHash("sha256").update(token).digest("hex");
+}
+/**
+ * Resolve the AI_UNI_TOKEN env var to a student ID.
+ * Caches the result so Supabase is only queried once per server lifetime.
+ * Updates last_used_at on first call.
+ */
+export async function getStudentId() {
+    if (cachedStudentId)
+        return cachedStudentId;
+    const token = process.env.AI_UNI_TOKEN;
+    if (!token) {
+        throw new Error("AI_UNI_TOKEN environment variable is not set");
+    }
+    const hash = hashToken(token);
+    const { data, error } = await supabase
+        .from("api_tokens")
+        .select("student_id")
+        .eq("token_hash", hash)
+        .single();
+    if (error || !data) {
+        throw new Error("Invalid API token — check your AI_UNI_TOKEN");
+    }
+    // Update last_used_at
+    await supabase
+        .from("api_tokens")
+        .update({ last_used_at: new Date().toISOString() })
+        .eq("token_hash", hash);
+    cachedStudentId = data.student_id;
+    return cachedStudentId;
+}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,341 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { supabase } from "./supabase.js";
+import { getStudentId } from "./auth.js";
+const server = new McpServer({
+    name: "aiuni-mcp",
+    version: "0.1.0",
+});
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function textResult(text) {
+    return { content: [{ type: "text", text }] };
+}
+function jsonResult(data) {
+    return textResult(JSON.stringify(data, null, 2));
+}
+function errorResult(msg) {
+    return { content: [{ type: "text", text: `Error: ${msg}` }], isError: true };
+}
+/** Get the next incomplete session for a student across their enrollments. */
+async function findNextSession(studentId) {
+    // Get all enrollments
+    const { data: enrollments } = await supabase
+        .from("enrollments")
+        .select("course_id, courses(code, title, total_sessions)")
+        .eq("student_id", studentId)
+        .order("started_at", { ascending: true });
+    if (!enrollments?.length)
+        return null;
+    for (const enrollment of enrollments) {
+        const course = enrollment.courses;
+        // Get all sessions for this course, ordered
+        const { data: sessions } = await supabase
+            .from("sessions")
+            .select("id, sequence_num, title")
+            .eq("course_id", enrollment.course_id)
+            .order("sequence_num", { ascending: true });
+        if (!sessions?.length)
+            continue;
+        // Get completed/in-progress session IDs
+        const { data: progress } = await supabase
+            .from("session_progress")
+            .select("session_id, status")
+            .eq("student_id", studentId)
+            .in("session_id", sessions.map((s) => s.id));
+        const completedIds = new Set((progress ?? [])
+            .filter((p) => p.status === "completed")
+            .map((p) => p.session_id));
+        // Find first non-completed session
+        for (const session of sessions) {
+            if (!completedIds.has(session.id)) {
+                return {
+                    session_id: session.id,
+                    course_code: course.code,
+                    course_title: course.title,
+                    sequence_num: session.sequence_num,
+                    total_sessions: course.total_sessions,
+                    session_title: session.title,
+                };
+            }
+        }
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Tool: get_student_context
+// ---------------------------------------------------------------------------
+server.tool("get_student_context", "Returns the student's profile, enrollments, course progress, and next assignment. Call this at the start of every tutoring session.", {}, async () => {
+    try {
+        const studentId = await getStudentId();
+        // Student profile
+        const { data: student } = await supabase
+            .from("students")
+            .select("id, name, email, onboarding_complete, role, created_at")
+            .eq("id", studentId)
+            .single();
+        if (!student)
+            return errorResult("Student not found");
+        // Enrollments with course info
+        const { data: enrollments } = await supabase
+            .from("enrollments")
+            .select("course_id, started_at, courses(code, title, total_sessions)")
+            .eq("student_id", studentId);
+        // All progress
+        const { data: allProgress } = await supabase
+            .from("session_progress")
+            .select("session_id, status, completed_at, sessions(sequence_num, title, course_id)")
+            .eq("student_id", studentId);
+        // Build per-course progress summary
+        const courseProgress = (enrollments ?? []).map((e) => {
+            const course = e.courses;
+            const courseSessionProgress = (allProgress ?? []).filter((p) => {
+                const sess = p.sessions;
+                return sess?.course_id === e.course_id;
+            });
+            const completed = courseSessionProgress.filter((p) => p.status === "completed").length;
+            return {
+                course_code: course.code,
+                course_title: course.title,
+                total_sessions: course.total_sessions,
+                completed_sessions: completed,
+                in_progress: courseSessionProgress.filter((p) => p.status === "in_progress").length,
+            };
+        });
+        // Next assignment
+        const next = await findNextSession(studentId);
+        return jsonResult({
+            student: {
+                name: student.name,
+                email: student.email,
+                onboarding_complete: student.onboarding_complete,
+                member_since: student.created_at,
+            },
+            courses: courseProgress,
+            next_assignment: next
+                ? {
+                    session_id: next.session_id,
+                    course: `${next.course_code}: ${next.course_title}`,
+                    session: `Session ${next.sequence_num}: ${next.session_title}`,
+                    progress: `${next.sequence_num - 1}/${next.total_sessions} completed`,
+                }
+                : null,
+        });
+    }
+    catch (err) {
+        return errorResult(err.message);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool: get_current_assignment
+// ---------------------------------------------------------------------------
+server.tool("get_current_assignment", "Returns the full session brief for the student's current (next incomplete) assignment, including overview, learning objectives, topics, and exercise details.", {}, async () => {
+    try {
+        const studentId = await getStudentId();
+        const next = await findNextSession(studentId);
+        if (!next) {
+            return textResult("All sessions completed! The student has finished all enrolled courses.");
+        }
+        // Get full session data
+        const { data: session } = await supabase
+            .from("sessions")
+            .select("id, sequence_num, title, brief_json, hints_json")
+            .eq("id", next.session_id)
+            .single();
+        if (!session)
+            return errorResult("Session not found");
+        // Check if there's existing progress (in_progress)
+        const { data: progress } = await supabase
+            .from("session_progress")
+            .select("status, notes, session_notes")
+            .eq("student_id", studentId)
+            .eq("session_id", session.id)
+            .single();
+        return jsonResult({
+            session_id: session.id,
+            course: `${next.course_code}: ${next.course_title}`,
+            session_number: session.sequence_num,
+            total_sessions: next.total_sessions,
+            title: session.title,
+            brief: session.brief_json,
+            tutor_guidance: session.hints_json,
+            current_status: progress?.status ?? "not_started",
+            existing_notes: progress?.session_notes ?? [],
+        });
+    }
+    catch (err) {
+        return errorResult(err.message);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool: get_rubric
+// ---------------------------------------------------------------------------
+server.tool("get_rubric", "Returns the evaluation rubric and acceptance criteria for a specific session.", {
+    session_id: z.string().describe("Session UUID to get rubric for"),
+}, async ({ session_id }) => {
+    try {
+        await getStudentId(); // auth check
+        const { data: session } = await supabase
+            .from("sessions")
+            .select("id, sequence_num, title, rubric_json, brief_json")
+            .eq("id", session_id)
+            .single();
+        if (!session)
+            return errorResult("Session not found");
+        // Extract exercise info from brief for context
+        const exercise = session.brief_json?.exercise;
+        return jsonResult({
+            session_id: session.id,
+            session_number: session.sequence_num,
+            title: session.title,
+            rubric: session.rubric_json,
+            exercise_summary: exercise ?? null,
+        });
+    }
+    catch (err) {
+        return errorResult(err.message);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool: submit_session_complete
+// ---------------------------------------------------------------------------
+server.tool("submit_session_complete", "Marks a session as completed. Optionally stores an artifact URL, artifact text, and notes. Use this when the student has met all acceptance criteria.", {
+    session_id: z.string().describe("Session UUID to mark complete"),
+    artifact_url: z.string().optional().describe("URL to the student's submitted work"),
+    artifact_text: z.string().optional().describe("Pasted text of the student's work"),
+    notes: z.string().optional().describe("Tutor summary of the session"),
+}, async ({ session_id, artifact_url, artifact_text, notes }) => {
+    try {
+        const studentId = await getStudentId();
+        // Verify session exists
+        const { data: session } = await supabase
+            .from("sessions")
+            .select("id, sequence_num, title, course_id")
+            .eq("id", session_id)
+            .single();
+        if (!session)
+            return errorResult("Session not found");
+        // Upsert progress
+        const { error } = await supabase.from("session_progress").upsert({
+            student_id: studentId,
+            session_id: session_id,
+            status: "completed",
+            completed_at: new Date().toISOString(),
+            artifact_url: artifact_url ?? null,
+            artifact_text: artifact_text ?? null,
+            notes: notes ?? null,
+        }, { onConflict: "student_id,session_id" });
+        if (error)
+            return errorResult(`Failed to update progress: ${error.message}`);
+        // Find what's next
+        const next = await findNextSession(studentId);
+        return jsonResult({
+            success: true,
+            completed: {
+                session_number: session.sequence_num,
+                title: session.title,
+            },
+            next_assignment: next
+                ? {
+                    session_id: next.session_id,
+                    session: `Session ${next.sequence_num}: ${next.session_title}`,
+                    course: `${next.course_code}: ${next.course_title}`,
+                }
+                : "All sessions complete! 🎓",
+        });
+    }
+    catch (err) {
+        return errorResult(err.message);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool: get_next_assignment
+// ---------------------------------------------------------------------------
+server.tool("get_next_assignment", "Returns the next incomplete session for the student. Use this after completing a session or to check what's coming up.", {}, async () => {
+    try {
+        const studentId = await getStudentId();
+        const next = await findNextSession(studentId);
+        if (!next) {
+            return textResult("All sessions completed! The student has finished all enrolled courses. 🎓");
+        }
+        // Get the full brief for the next session
+        const { data: session } = await supabase
+            .from("sessions")
+            .select("id, sequence_num, title, brief_json")
+            .eq("id", next.session_id)
+            .single();
+        return jsonResult({
+            session_id: next.session_id,
+            course: `${next.course_code}: ${next.course_title}`,
+            session_number: next.sequence_num,
+            total_sessions: next.total_sessions,
+            title: next.session_title,
+            overview: session?.brief_json?.overview ?? null,
+        });
+    }
+    catch (err) {
+        return errorResult(err.message);
+    }
+});
+// ---------------------------------------------------------------------------
+// Tool: save_session_note
+// ---------------------------------------------------------------------------
+server.tool("save_session_note", "Saves a tutor observation or note during a session. Notes are appended to the session's note log and persist across conversations. Use this to record student strengths, struggles, or key moments.", {
+    session_id: z.string().describe("Session UUID"),
+    topic: z.string().describe("Note category (e.g. 'strength', 'struggle', 'insight', 'feedback')"),
+    note: z.string().describe("The note content"),
+}, async ({ session_id, topic, note }) => {
+    try {
+        const studentId = await getStudentId();
+        // Ensure progress row exists (create as in_progress if not)
+        const { data: existing } = await supabase
+            .from("session_progress")
+            .select("id, session_notes, status")
+            .eq("student_id", studentId)
+            .eq("session_id", session_id)
+            .single();
+        const newNote = {
+            topic,
+            note,
+            timestamp: new Date().toISOString(),
+        };
+        if (existing) {
+            const currentNotes = existing.session_notes ?? [];
+            const { error } = await supabase
+                .from("session_progress")
+                .update({ session_notes: [...currentNotes, newNote] })
+                .eq("id", existing.id);
+            if (error)
+                return errorResult(`Failed to save note: ${error.message}`);
+        }
+        else {
+            // Create progress row as in_progress
+            const { error } = await supabase.from("session_progress").insert({
+                student_id: studentId,
+                session_id: session_id,
+                status: "in_progress",
+                session_notes: [newNote],
+            });
+            if (error)
+                return errorResult(`Failed to save note: ${error.message}`);
+        }
+        return jsonResult({
+            success: true,
+            note_saved: { topic, note },
+        });
+    }
+    catch (err) {
+        return errorResult(err.message);
+    }
+});
+// ---------------------------------------------------------------------------
+// Start server
+// ---------------------------------------------------------------------------
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch(console.error);

package/dist/supabase.d.ts

@@ -0,0 +1 @@
+export declare const supabase: import("@supabase/supabase-js").SupabaseClient<any, "public", "public", any, any>;

package/dist/supabase.js

@@ -0,0 +1,6 @@
+import { createClient } from "@supabase/supabase-js";
+const DEFAULT_URL = "https://kirwyicyoyogjrsautvl.supabase.co";
+const DEFAULT_ANON_KEY = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6Imtpcnd5aWN5b3lvZ2pyc2F1dHZsIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NzI4MjkwOTIsImV4cCI6MjA4ODQwNTA5Mn0.vkNhemuocxkg5jIPGIljsl2hYxp5ONhXSGKmdHCIlAI";
+const url = process.env.SUPABASE_URL ?? DEFAULT_URL;
+const key = process.env.SUPABASE_ANON_KEY ?? DEFAULT_ANON_KEY;
+export const supabase = createClient(url, key);

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@ai-uni/mcp-server",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "ai-uni-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc && node -e \"const f=require('fs');const p='dist/index.js';const c=f.readFileSync(p,'utf8');if(!c.startsWith('#!'))f.writeFileSync(p,'#!/usr/bin/env node\\n'+c)\"",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch"
+  },
+  "license": "ISC",
+  "description": "AI Uni MCP server for Claude Desktop integration",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@supabase/supabase-js": "^2.98.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.5",
+    "typescript": "^5.9.3"
+  }
+}

package/prompts/session-panel.html

@@ -0,0 +1,574 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>AI Uni — Session Panel</title>
+<style>
+  @import url('https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;500;600&family=IBM+Plex+Sans:ital,wght@0,300;0,400;0,500;1,300&display=swap');
+
+  :root {
+    --bg: #0d0f0e;
+    --surface: #131614;
+    --surface2: #181c19;
+    --border: #232825;
+    --border-hi: #2d3530;
+    --green: #4ade80;
+    --green-dim: #163324;
+    --green-glow: rgba(74,222,128,0.08);
+    --text: #dde8e1;
+    --dim: #6b7d72;
+    --muted: #323d36;
+    --blue: #7ab8f5;
+    --blue-dim: #172233;
+  }
+
+  * { box-sizing: border-box; margin: 0; padding: 0; }
+
+  body {
+    background: var(--bg);
+    color: var(--text);
+    font-family: 'IBM Plex Sans', sans-serif;
+    font-size: 13px;
+    min-height: 100vh;
+    padding: 18px 16px 24px;
+    width: 320px;
+    max-width: 320px;
+  }
+
+  .hd {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    margin-bottom: 14px;
+  }
+
+  .brand {
+    font-family: 'IBM Plex Mono', monospace;
+    font-size: 12px;
+    font-weight: 600;
+    color: var(--dim);
+    letter-spacing: 0.04em;
+  }
+  .brand em { color: var(--green); font-style: normal; }
+
+  .session-badge {
+    font-family: 'IBM Plex Mono', monospace;
+    font-size: 10px;
+    color: var(--dim);
+    background: var(--surface2);
+    border: 1px solid var(--border);
+    border-radius: 4px;
+    padding: 3px 8px;
+  }
+
+  .status {
+    background: var(--surface);
+    border: 1px solid var(--border);
+    border-radius: 7px;
+    padding: 11px 13px;
+    margin-bottom: 16px;
+    display: flex;
+    align-items: center;
+  }
+
+  .stu-name {
+    font-size: 13px;
+    font-weight: 500;
+    color: var(--text);
+    margin-bottom: 1px;
+  }
+
+  .stu-sub {
+    font-family: 'IBM Plex Mono', monospace;
+    font-size: 10px;
+    color: var(--dim);
+  }
+
+  .status-right {
+    margin-left: auto;
+    display: flex;
+    flex-direction: column;
+    align-items: flex-end;
+    gap: 5px;
+  }
+
+  .prog-wrap {
+    display: flex;
+    align-items: center;
+    gap: 7px;
+  }
+
+  .prog-track {
+    width: 72px;
+    height: 3px;
+    background: var(--muted);
+    border-radius: 2px;
+    overflow: hidden;
+  }
+
+  .prog-fill {
+    height: 100%;
+    background: var(--green);
+    border-radius: 2px;
+    width: 10%;
+  }
+
+  .prog-text {
+    font-family: 'IBM Plex Mono', monospace;
+    font-size: 10px;
+    color: var(--dim);
+    white-space: nowrap;
+  }
+
+  .state-pill {
+    font-family: 'IBM Plex Mono', monospace;
+    font-size: 9px;
+    font-weight: 600;
+    letter-spacing: 0.08em;
+    text-transform: uppercase;
+    padding: 2px 7px;
+    border-radius: 10px;
+    background: var(--green-dim);
+    color: var(--green);
+    display: flex;
+    align-items: center;
+    gap: 4px;
+  }
+
+  .dot {
+    width: 5px; height: 5px;
+    border-radius: 50%;
+    background: var(--green);
+    animation: blink 2s ease-in-out infinite;
+  }
+
+  @keyframes blink { 0%,100%{opacity:1} 50%{opacity:.3} }
+
+  .sec { margin-bottom: 12px; }
+
+  .sec-label {
+    font-family: 'IBM Plex Mono', monospace;
+    font-size: 9px;
+    font-weight: 600;
+    text-transform: uppercase;
+    letter-spacing: 0.12em;
+    color: var(--muted);
+    margin-bottom: 5px;
+    padding-left: 2px;
+  }
+
+  .cmd-list {
+    display: flex;
+    flex-direction: column;
+    gap: 2px;
+  }
+
+  .cmd {
+    display: flex;
+    flex-direction: column;
+    border-radius: 6px;
+    border: 1px solid transparent;
+    background: transparent;
+    transition: background 0.12s, border-color 0.12s;
+    overflow: hidden;
+  }
+
+  .cmd-row {
+    display: flex;
+    align-items: center;
+  }
+
+  .cmd.hi {
+    background: var(--green-glow);
+    border-color: var(--green-dim);
+  }
+
+  .cmd.open {
+    background: var(--surface2);
+    border-color: var(--border-hi);
+  }
+
+  .cmd.hi.open {
+    background: rgba(74,222,128,0.11);
+    border-color: rgba(74,222,128,0.3);
+  }
+
+  .cmd-inner {
+    flex: 1;
+    padding: 10px 10px;
+  }
+
+  .cmd-label {
+    font-size: 14px;
+    color: var(--text);
+  }
+
+  .cmd.hi .cmd-label {
+    font-weight: 500;
+    color: var(--green);
+  }
+
+  /* tooltip — click toggled */
+  .cmd-tip {
+    display: none;
+    left: 0; right: 0;
+    background: #19211e;
+    border-top: 1px solid var(--border-hi);
+    padding: 10px 12px 11px;
+    margin: 0 -1px;
+  }
+
+  .cmd.open .cmd-tip { display: block; }
+
+  .tip-text {
+    font-size: 12px;
+    color: var(--dim);
+    line-height: 1.5;
+    margin-bottom: 7px;
+  }
+
+  .tip-tools {
+    display: flex;
+    gap: 4px;
+    flex-wrap: wrap;
+  }
+
+  .tip-tool {
+    font-family: 'IBM Plex Mono', monospace;
+    font-size: 10px;
+    padding: 2px 6px;
+    background: var(--blue-dim);
+    color: var(--blue);
+    border-radius: 3px;
+  }
+
+  /* info toggle button */
+  .info-btn {
+    flex-shrink: 0;
+    width: 32px;
+    height: 32px;
+    margin: 0 4px 0 0;
+    background: transparent;
+    border: 1px solid transparent;
+    border-radius: 4px;
+    color: var(--muted);
+    cursor: pointer;
+    font-size: 14px;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    transition: all 0.12s;
+    position: relative;
+    z-index: 20;
+  }
+
+  .info-btn:hover, .cmd.open .info-btn {
+    color: var(--dim);
+    border-color: var(--border-hi);
+    background: var(--surface2);
+  }
+
+  .copy-btn {
+    flex-shrink: 0;
+    font-family: 'IBM Plex Mono', monospace;
+    font-size: 15px;
+    font-weight: 500;
+    padding: 10px 18px;
+    margin: 6px 6px 6px 0;
+    background: transparent;
+    border: 1px solid var(--border-hi);
+    border-radius: 6px;
+    color: var(--dim);
+    cursor: pointer;
+    white-space: nowrap;
+    transition: all 0.12s;
+    position: relative;
+    z-index: 20;
+    min-width: 72px;
+    text-align: center;
+  }
+
+  .copy-btn:active {
+    transform: scale(0.96);
+  }
+
+  .copy-btn:hover {
+    background: var(--muted);
+    color: var(--text);
+    border-color: var(--dim);
+  }
+
+  .copy-btn.ok {
+    background: var(--green-dim);
+    border-color: var(--green);
+    color: var(--green);
+  }
+
+  .cmd.hi .copy-btn {
+    border-color: rgba(74,222,128,0.35);
+    color: var(--green);
+  }
+
+  .div {
+    height: 1px;
+    background: var(--border);
+    margin: 4px 0 12px;
+  }
+
+  .foot {
+    margin-top: 4px;
+    position: relative;
+  }
+
+  .webapp-btn {
+    display: block;
+    width: 100%;
+    padding: 14px;
+    background: var(--surface);
+    border: 1px solid var(--border);
+    border-radius: 6px;
+    color: var(--dim);
+    font-family: 'IBM Plex Sans', sans-serif;
+    font-size: 15px;
+    font-weight: 500;
+    text-align: center;
+    cursor: pointer;
+    transition: background 0.12s, border-color 0.12s, color 0.12s;
+    text-decoration: none;
+  }
+
+  .webapp-btn:active {
+    transform: scale(0.98);
+  }
+
+  .webapp-btn:hover, .webapp-btn.open {
+    background: var(--surface2);
+    border-color: var(--border-hi);
+    color: var(--text);
+  }
+
+  .webapp-tip {
+    display: none;
+    background: #19211e;
+    border: 1px solid var(--border-hi);
+    border-top: none;
+    border-radius: 0 0 6px 6px;
+    padding: 10px 12px;
+    font-size: 12px;
+    color: var(--dim);
+    line-height: 1.5;
+    margin-top: -1px;
+  }
+
+  .webapp-wrap.open .webapp-tip { display: block; }
+  .webapp-wrap.open .webapp-btn {
+    border-radius: 6px 6px 0 0;
+    border-color: var(--border-hi);
+    background: var(--surface2);
+    color: var(--text);
+  }
+</style>
+</head>
+<body>
+
+<div class="hd">
+  <div class="brand">ai<em>-uni</em></div>
+  <div class="session-badge">CORE-01 · S1 of 10</div>
+</div>
+
+<div class="status">
+  <div>
+    <div class="stu-name">Jon</div>
+    <div class="stu-sub">AI Fluency &nbsp;·&nbsp; Session 1</div>
+  </div>
+  <div class="status-right">
+    <div class="state-pill"><div class="dot"></div>In progress</div>
+    <div class="prog-wrap">
+      <div class="prog-track"><div class="prog-fill"></div></div>
+      <div class="prog-text">1 / 10</div>
+    </div>
+  </div>
+</div>
+
+<!-- Starting out -->
+<div class="sec">
+  <div class="sec-label">Starting out</div>
+  <div class="cmd-list">
+
+    <div class="cmd hi">
+      <div class="cmd-row">
+        <div class="cmd-inner"><div class="cmd-label">Let's go</div></div>
+        <button class="info-btn" onclick="tog(this)">?</button>
+        <button class="copy-btn" onclick="cp(this,`Let's go`)">Copy</button>
+      </div>
+      <div class="cmd-tip">
+        <div class="tip-text">Opens your session. Claude checks where you are and picks up in context — or starts fresh if this is session 1.</div>
+        <div class="tip-tools"><span class="tip-tool">get_student_context</span><span class="tip-tool">get_current_assignment</span></div>
+      </div>
+    </div>
+
+    <div class="cmd">
+      <div class="cmd-row">
+        <div class="cmd-inner"><div class="cmd-label">Pick up where I left off</div></div>
+        <button class="info-btn" onclick="tog(this)">?</button>
+        <button class="copy-btn" onclick="cp(this,`Pick up where I left off`)">Copy</button>
+      </div>
+      <div class="cmd-tip">
+        <div class="tip-text">Restores your last saved note. Use this if you closed Claude mid-session and are returning.</div>
+        <div class="tip-tools"><span class="tip-tool">get_student_context</span></div>
+      </div>
+    </div>
+
+  </div>
+</div>
+
+<div class="div"></div>
+
+<!-- Mid session -->
+<div class="sec">
+  <div class="sec-label">Mid session</div>
+  <div class="cmd-list">
+
+    <div class="cmd">
+      <div class="cmd-row">
+        <div class="cmd-inner"><div class="cmd-label">What's my exercise?</div></div>
+        <button class="info-btn" onclick="tog(this)">?</button>
+        <button class="copy-btn" onclick="cp(this,`What's my exercise?`)">Copy</button>
+      </div>
+      <div class="cmd-tip">
+        <div class="tip-text">Shows the full exercise, format, and what done looks like. Pull this up before you start working.</div>
+        <div class="tip-tools"><span class="tip-tool">get_current_assignment</span></div>
+      </div>
+    </div>
+
+    <div class="cmd">
+      <div class="cmd-row">
+        <div class="cmd-inner"><div class="cmd-label">How will this be graded?</div></div>
+        <button class="info-btn" onclick="tog(this)">?</button>
+        <button class="copy-btn" onclick="cp(this,`How will this be graded?`)">Copy</button>
+      </div>
+      <div class="cmd-tip">
+        <div class="tip-text">Shows the exact rubric. Know these before you submit — Claude evaluates against each criterion specifically.</div>
+        <div class="tip-tools"><span class="tip-tool">get_rubric</span></div>
+      </div>
+    </div>
+
+    <div class="cmd">
+      <div class="cmd-row">
+        <div class="cmd-inner"><div class="cmd-label">Save and stop</div></div>
+        <button class="info-btn" onclick="tog(this)">?</button>
+        <button class="copy-btn" onclick="cp(this,`Save and stop for now`)">Copy</button>
+      </div>
+      <div class="cmd-tip">
+        <div class="tip-text">Saves a note so you can resume here later. Always do this before closing Claude mid-session.</div>
+        <div class="tip-tools"><span class="tip-tool">save_session_note</span></div>
+      </div>
+    </div>
+
+  </div>
+</div>
+
+<div class="div"></div>
+
+<!-- Wrapping up -->
+<div class="sec">
+  <div class="sec-label">Wrapping up</div>
+  <div class="cmd-list">
+
+    <div class="cmd">
+      <div class="cmd-row">
+        <div class="cmd-inner"><div class="cmd-label">Check my work</div></div>
+        <button class="info-btn" onclick="tog(this)">?</button>
+        <button class="copy-btn" onclick="cp(this,`Check my work against the rubric`)">Copy</button>
+      </div>
+      <div class="cmd-tip">
+        <div class="tip-text">Claude reviews your work against the rubric and gives specific feedback. Do this before marking complete.</div>
+        <div class="tip-tools"><span class="tip-tool">get_rubric</span></div>
+      </div>
+    </div>
+
+    <div class="cmd hi">
+      <div class="cmd-row">
+        <div class="cmd-inner"><div class="cmd-label">Mark complete</div></div>
+        <button class="info-btn" onclick="tog(this)">?</button>
+        <button class="copy-btn" onclick="cp(this,`Mark this session complete`)">Copy</button>
+      </div>
+      <div class="cmd-tip">
+        <div class="tip-text">Records completion and unlocks your next session. Only after Claude confirms your work passes. Then confirm in the web app.</div>
+        <div class="tip-tools"><span class="tip-tool">submit_session_complete</span><span class="tip-tool">get_next_assignment</span></div>
+      </div>
+    </div>
+
+  </div>
+</div>
+
+<div class="div"></div>
+
+<!-- Between sessions -->
+<div class="sec">
+  <div class="sec-label">Between sessions</div>
+  <div class="cmd-list">
+
+    <div class="cmd">
+      <div class="cmd-row">
+        <div class="cmd-inner"><div class="cmd-label">What's next?</div></div>
+        <button class="info-btn" onclick="tog(this)">?</button>
+        <button class="copy-btn" onclick="cp(this,`What's next?`)">Copy</button>
+      </div>
+      <div class="cmd-tip">
+        <div class="tip-text">Previews your next session without advancing. Good for planning.</div>
+        <div class="tip-tools"><span class="tip-tool">get_next_assignment</span></div>
+      </div>
+    </div>
+
+    <div class="cmd">
+      <div class="cmd-row">
+        <div class="cmd-inner"><div class="cmd-label">My progress</div></div>
+        <button class="info-btn" onclick="tog(this)">?</button>
+        <button class="copy-btn" onclick="cp(this,`Show my full course progress`)">Copy</button>
+      </div>
+      <div class="cmd-tip">
+        <div class="tip-text">All sessions — done, active, upcoming — with your notes. Should match the web app.</div>
+        <div class="tip-tools"><span class="tip-tool">get_student_context</span></div>
+      </div>
+    </div>
+
+  </div>
+</div>
+
+<div class="foot">
+  <div class="webapp-wrap" id="webappWrap">
+    <a class="webapp-btn" href="https://app.ai-uni.tech" target="_blank" onclick="togWebapp(event)">
+      Open web app
+    </a>
+    <div class="webapp-tip">Check session status, confirm completions, and view your portfolio. If a session isn't marked done here, record it from the app — you don't need Claude for that.</div>
+  </div>
+</div>
+
+<script>
+function tog(infoBtn) {
+  const cmd = infoBtn.closest('.cmd');
+  cmd.classList.toggle('open');
+}
+
+function togWebapp(e) {
+  const wrap = document.getElementById('webappWrap');
+  if (wrap.classList.contains('open')) {
+    return;
+  }
+  e.preventDefault();
+  wrap.classList.add('open');
+}
+
+function cp(btn, text) {
+  navigator.clipboard.writeText(text).then(() => {
+    const p = btn.textContent;
+    btn.textContent = '✓';
+    btn.classList.add('ok');
+    setTimeout(() => { btn.textContent = p; btn.classList.remove('ok'); }, 1400);
+  });
+}
+</script>
+</body>
+</html>

package/prompts/tutor-system.md

@@ -0,0 +1,95 @@
+# AI Uni Tutor — System Prompt
+
+*Paste this into your Claude Desktop Project instructions for AI Uni.*
+
+---
+
+You are the AI Uni tutor — a Socratic learning partner for students in AI Uni, a structured college alternative for the AI economy. You teach through questions and dialogue, not lectures. You have access to the student's curriculum, progress, and assignments through MCP tools.
+
+## First Action (Every Conversation)
+
+**Before saying anything**, call `get_student_context`. This tells you who the student is, what courses they're enrolled in, where they are in the curriculum, and what's next. Never skip this step.
+
+After reviewing context, greet the student by name and summarize where they are:
+- If they have a session in progress, offer to pick up where they left off.
+- If they're starting a new session, call `get_current_assignment` and introduce it.
+- If all sessions are complete, congratulate them and discuss what they've learned.
+
+## Teaching Method: Socratic Dialogue
+
+You are a tutor, not a textbook. Your job is to help students *think*, not to deliver information.
+
+**Do:**
+- Ask questions that lead to understanding: "What do you think would happen if...?" "Why might that approach cause problems?" "How would you explain this to someone who's never seen it?"
+- Start with what the student already knows and build from there.
+- Give the student space to struggle productively before offering help.
+- When a student is stuck, ask a simpler question that points toward the answer — don't give it away.
+- Celebrate genuine understanding, not just correct answers.
+- Use concrete examples from the student's interests or prior work.
+
+**Don't:**
+- Lecture for more than 2-3 sentences at a time. If you're explaining for a paragraph, stop and ask a question instead.
+- Give away answers. If a student asks "what's the answer?", respond with a question that helps them find it.
+- Be condescending. These are motivated adults who chose this path. Treat them as capable.
+- Use jargon without checking understanding. If you introduce a term, make sure the student can define it back to you.
+- Rush. If a student needs more time on a concept, spend more time. The curriculum adapts to them, not the other way around.
+
+## Session Flow
+
+A typical tutoring session follows this arc:
+
+1. **Context check** — Call `get_student_context`. Greet the student. Summarize their position.
+2. **Assignment intro** — Call `get_current_assignment`. Walk through the session's learning objectives and topics. Ask what the student already knows about the subject.
+3. **Guided exploration** — Work through each topic using Socratic questioning. After each major concept, call `save_session_note` to record the student's understanding, strengths, or struggles.
+4. **Exercise** — When the student is ready, present the session's exercise. Guide them through it without doing it for them.
+5. **Evaluation** — When the student believes they're done, call `get_rubric` to get the acceptance criteria. Evaluate their work against each criterion honestly. If they haven't met a criterion, explain what's missing and help them get there.
+6. **Completion** — Only when all acceptance criteria are clearly met, call `submit_session_complete` with a summary of what the student accomplished. Then call `get_next_assignment` to preview what's coming.
+
+## Using Your Tools
+
+You have six MCP tools. Use them proactively — don't wait for the student to ask.
+
+| Tool | When to Use |
+|------|-------------|
+| `get_student_context` | Start of every conversation. No exceptions. |
+| `get_current_assignment` | After context check, to load the session brief. |
+| `get_rubric` | Before evaluating student work. Never evaluate without it. |
+| `submit_session_complete` | Only when all acceptance criteria are met. Never premature. |
+| `get_next_assignment` | After completing a session, or when student asks what's ahead. |
+| `save_session_note` | After each topic block, when you notice a strength or struggle, or when the student has an insight. These notes persist across conversations — they're how future sessions know what happened. |
+
+**save_session_note is critical.** Students may close the conversation and come back later. Your notes are the only continuity between conversations. Write notes that would help a different tutor pick up exactly where you left off. Include:
+- What topics were covered and how well the student understood them
+- What part of the exercise was reached
+- Any misconceptions that surfaced
+- The student's confidence level and engagement
+
+## Tone and Style
+
+- **Direct and honest.** Don't sugarcoat. If the work isn't good enough, say so — then help fix it.
+- **Warm but professional.** You're a mentor, not a friend. Encouraging without being patronizing.
+- **Concise.** Students are here to learn, not to read essays. Keep explanations tight.
+- **Adaptive.** Match the student's communication style. Some want formal, some want casual. Mirror what they give you.
+- **Patient.** Never express frustration. If a student is struggling, that's useful information — adjust your approach.
+
+## What You Don't Do
+
+- **Don't do the student's work.** Guide, question, hint — but the student must produce the output. If they paste code they want you to write, ask them to try first.
+- **Don't grade on a curve.** The acceptance criteria are the standard. Met or not met.
+- **Don't go off-curriculum.** If a student wants to explore a tangent, briefly address it, then bring them back to the session objectives.
+- **Don't make up information.** If you're unsure about something technical, say so. Better to be honest than confidently wrong.
+- **Don't mark sessions complete prematurely.** A student saying "I think I'm done" is not the same as meeting all acceptance criteria. Always check the rubric.
+
+## Handling Common Situations
+
+**Student is lost:** Back up. Ask what they *do* understand. Find the gap and fill it with questions, not lectures.
+
+**Student wants to skip ahead:** Explain that each session builds on the last. Ask them to demonstrate understanding of the current material — if they truly know it, the session will go quickly.
+
+**Student is frustrated:** Acknowledge it. "This is genuinely difficult — that's normal." Then simplify: break the problem into smaller pieces.
+
+**Student submits incomplete work:** Call `get_rubric`, point to the specific criteria not met, and help them address each one.
+
+**Student hasn't been here in a while:** Check `get_student_context` for session notes from last time. Summarize what was covered and ask what they remember. Quick recap, then continue.
+
+**Student asks about AI Uni itself (pricing, other courses, etc.):** You're the tutor, not the sales team. Direct them to aiuni.tech for program information. Stay focused on their learning.