Second revision: MCP servers, shared-link AI, flashcard modes, document previews
All checks were successful
Verify and publish V2 container / build-and-push (push) Successful in 30s

Generation
- Every quiz is NCLEX style; "Practice exam" writes 50 questions.
- Calculation questions only when the material involves calculations (max 5 per exam).
- Broad topics: the class's topics are listed in the prompt, a quick grouping call maps
  narrow labels onto broad ones, and leftover variants are merged.
- Exact select-all count per batch; option order shuffled.
- Python check: at most 3 runs, fixed problems count as passed, cosmetic remarks ignored.

Assistant
- Text, tool steps and cards appear in the order they happen, with paragraph breaks
  between steps.
- Optional thinking box: fixed height, follows the newest text, can be scrolled back.
- "+" opens a material picker listing recent items; items can be dragged in from class
  pages; shorter placeholder.

MCP servers
- Streamable HTTP client; encrypted headers.
- Per-server instructions and switches for chat, Explain, generation and the quiz check.
- Settings UI.

Share links
- Optional "Explain this" and "Ask about this material" per link, off by default.
- Items are loaded on the server and checked against the share; no tools; rate-limited.
- Migration 4 stores the switches.

Study and documents
- Standard flashcard mode (optionally repeat missed cards until known) next to spaced
  repetition.
- Streak visuals restyled in the app palette.
- Side by side / Original document views, with sandboxed previews of Word and PowerPoint
  files.

Other
- Built-in embedding model baked into the image; sharp stubbed if it cannot load; real
  load error shown in Settings.
- Python runner blocks network and process modules in JavaScript too.
- "View questions and answers" removed from the quiz start screen.
- Docs updated.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Elijah 2026-11-15 15:48:54 -07:00
parent 5ea61c882c
commit 031f7bec31
45 changed files with 2918 additions and 397 deletions

View file

@ -85,6 +85,32 @@ turns, follow-up turns, tagged quiz to flashcards, an answer finishing after dis
errors in Usage. Docker image builds; ONNX Runtime and the embedding model run in the container.
The image grew to about 1.3 GB because of ONNX Runtime.
## 2026-11-15: second revision (owner's 19-item list)
Quiz generation: all quizzes NCLEX; "Practice exam" = 50 questions; calculation questions only
when the source mentions calculations (max 5 in an exam); broad topics (prompted, plus
`consolidateTopics` merging narrower labels); option order shuffled. The Python check uses at
most 3 runs and ignores cosmetic remarks. Assistant: text, tool steps and cards stream in the
order they happen (`MessagePart`), paragraphs are separated between steps, optional "Show
thinking" box (persisted, fixed height, follows the newest text), "+" opens a material picker
(no more flashing "@"), library items can be dragged into the panel, shorter placeholder.
"View questions and answers" removed from the quiz start screen. Built-in embedding model baked
into the image (`scripts/fetch-embedding-model.mjs`, `LOCAL_MODELS_DIR`), sharp stubbed when its
native binary will not load, and the real load error shown in Settings. Python runner also blocks
network and process modules in JavaScript (Node 24's permission model does not block network).
New: MCP servers with per-server instructions and per-area switches (`server/ai/mcp.ts`,
`runChatWithMcp` in `service.ts`); per-share AI switches (migration 4, `shares.ai`;
`POST /api/public/:token/explain|chat`, rate-limited, no tools); flashcard Standard mode with
"repeat missed cards until known" next to Spaced repetition on the deck page; streak visuals
restyled in the app palette (marker highlighter, accent bar, mono numerals); document Side by
side / Original view with generated previews for Word and PowerPoint. Item 13 (pictures in
PowerPoint files) was verified only: they are not read; see docs/AI.md.
Tests: `tests/revision2.test.ts` (mock MCP server over Streamable HTTP and SSE, area switches,
instructions in prompts, exam length, calculation allowance, topic merging, message part order,
previews, share-link AI scope and rate limits).
## Verification status
Baseline: 162 tests passed, TypeScript passed and production web/server builds passed.