@studious-lms/server 1.9.0 → 1.12.0

package/tests/unit/services/studentProgress.test.ts

@@ -31,6 +31,9 @@ import {
   chatAboutStudentProgress,
   dismissStudentRecommendation,
   getClassProgressRecommendations,
+  getStudentProgressFocus,
+  getStudentProgressForecast,
+  getStudentProgressInsights,
   getStudentProgressRecommendations,
 } from "../../../src/services/studentProgress.js";
 
@@ -221,7 +224,10 @@ describe("studentProgress service", () => {
       ],
     });
 
-    const result = await getClassProgressRecommendations("teacher-1", "class-1");
+    const result = await getClassProgressRecommendations(
+      "teacher-1",
+      "class-1",
+    );
 
     expect(result.class).toMatchObject({
       id: "class-1",
@@ -297,7 +303,9 @@ describe("studentProgress service", () => {
     });
 
     expect(result.isFallback).toBe(true);
-    expect(result.message).toContain("Student One's current overall grade is 60%.");
+    expect(result.message).toContain(
+      "Student One's current overall grade is 60%.",
+    );
     expect(result.message).toContain("1 assignment appears overdue.");
     expect(result.message).toContain("1 graded assignment is below 70%.");
     expect(logger.error).toHaveBeenCalled();
@@ -340,6 +348,164 @@ describe("studentProgress service", () => {
     expect(result.recommendations).toHaveLength(0);
   });
 
+  test("generates structured student insights from progress context", async () => {
+    isTeacherInClass.mockResolvedValue(true);
+    inference.mockResolvedValue({
+      summary:
+        "Student One is at 72% with a steady trajectory. Fractions Test is a strength, while Missing Quiz needs attention.",
+      strengths: [
+        { label: "Fraction fluency", evidence: "Fractions Test scored 84%." },
+        { label: "Quiz recovery", evidence: "Retake Review improved to 78%." },
+      ],
+      growth: [
+        { label: "Missing work", evidence: "Missing Quiz is overdue." },
+        { label: "Test precision", evidence: "Unit Test scored 62%." },
+      ],
+      talkingPoints: [
+        "What helped you on Fractions Test?",
+        "What blocked Missing Quiz?",
+        "Which review format would help this week?",
+      ],
+    });
+    prismaMocks.class.findUnique.mockResolvedValue({
+      id: "class-1",
+      name: "Algebra",
+      subject: "Math",
+    });
+    prismaMocks.user.findFirst.mockResolvedValue({
+      id: "student-1",
+      username: "student1",
+      profile: { displayName: "Student One" },
+    });
+    prismaMocks.submission.findMany.mockResolvedValue([
+      createSubmission({
+        id: "graded-submission",
+        gradeReceived: 84,
+        submitted: true,
+        returned: true,
+        submittedAt: daysFromNow(-4),
+        assignment: {
+          id: "graded-assignment",
+          title: "Fractions Test",
+          dueDate: daysFromNow(-5),
+          type: "TEST",
+        },
+      }),
+    ]);
+
+    const result = await getStudentProgressInsights(
+      "teacher-1",
+      "class-1",
+      "student-1",
+    );
+
+    expect(result.strengths[0]?.label).toBe("Fraction fluency");
+    expect(inference).toHaveBeenCalledWith(
+      expect.arrayContaining([
+        expect.objectContaining({ role: "system" }),
+        expect.objectContaining({
+          role: "user",
+          content: expect.stringContaining("Fractions Test"),
+        }),
+      ]),
+      expect.any(Object),
+      expect.objectContaining({
+        reason: "student_progress_insights",
+        metadata: {
+          viewerId: "teacher-1",
+          classId: "class-1",
+          studentId: "student-1",
+        },
+      }),
+    );
+  });
+
+  test("generates a structured student forecast", async () => {
+    isTeacherInClass.mockResolvedValue(false);
+    inference.mockResolvedValue({
+      forecastLow: 62,
+      forecastHigh: 74,
+      risk: "watch",
+      reason:
+        "Recent low score and one missing assignment create moderate risk.",
+    });
+    prismaMocks.class.findUnique.mockResolvedValue({
+      id: "class-1",
+      name: "Algebra",
+      subject: "Math",
+    });
+    prismaMocks.user.findFirst.mockResolvedValue({
+      id: "student-1",
+      username: "student1",
+      profile: { displayName: "Student One" },
+    });
+    prismaMocks.submission.findMany.mockResolvedValue([
+      createSubmission({
+        gradeReceived: 62,
+        submitted: true,
+        returned: true,
+        submittedAt: daysFromNow(-2),
+        assignment: { title: "Unit Test", dueDate: daysFromNow(-3) },
+      }),
+    ]);
+
+    const result = await getStudentProgressForecast(
+      "student-1",
+      "class-1",
+      "student-1",
+    );
+
+    expect(result).toMatchObject({
+      forecastLow: 62,
+      forecastHigh: 74,
+      risk: "watch",
+    });
+    expect(inference).toHaveBeenCalledWith(
+      expect.any(Array),
+      expect.any(Object),
+      expect.objectContaining({ reason: "student_progress_forecast" }),
+    );
+  });
+
+  test("generates student-facing weekly focus items", async () => {
+    isTeacherInClass.mockResolvedValue(false);
+    inference.mockResolvedValue({
+      focusItems: [
+        "Finish Missing Quiz make-up.",
+        "Review Unit Test mistakes.",
+        "Ask for help on fractions.",
+      ],
+    });
+    prismaMocks.class.findUnique.mockResolvedValue({
+      id: "class-1",
+      name: "Algebra",
+      subject: "Math",
+    });
+    prismaMocks.user.findFirst.mockResolvedValue({
+      id: "student-1",
+      username: "student1",
+      profile: { displayName: "Student One" },
+    });
+    prismaMocks.submission.findMany.mockResolvedValue([
+      createSubmission({
+        assignment: { title: "Missing Quiz", dueDate: daysFromNow(-2) },
+      }),
+    ]);
+
+    const result = await getStudentProgressFocus(
+      "student-1",
+      "class-1",
+      "student-1",
+    );
+
+    expect(result.focusItems).toHaveLength(3);
+    expect(inference).toHaveBeenCalledWith(
+      expect.any(Array),
+      expect.any(Object),
+      expect.objectContaining({ reason: "student_progress_focus" }),
+    );
+  });
+
   test("allows teachers to dismiss a recommendation", async () => {
     isTeacherInClass.mockResolvedValue(true);
     prismaMocks.submission.findFirst.mockResolvedValue({ id: "submission-1" });