Third revision: web search, MCP sign-in, exams, intelligent UI, clarifying questions
All checks were successful
Verify and publish V2 container / build-and-push (push) Successful in 1m0s

- Built-in Parallel web search (keyless; optional sign-in for higher limits and research)
  with its own settings page; OAuth sign-in (RFC 9728/8414/7591, PKCE, RFC 8707) for any
  MCP server, with token refresh and pre-registered client support
- Friendly tool steps (icon, name, status; details on click) and ids stripped from results;
  per-chat tool switches; taller thinking box
- Exams within classes: exam tabs, scoped lists, uploads, imports and Generate; exam-only
  material for generation; class setting for what the groups are called
- Assistant can ask clarifying questions in an inline form before generating
- OpenUI blocks (charts, questions, flashcards, inputs) in assistant, Explain and share chats
- Explain beside the quiz on wide screens, grounded in the cited source pages
- Quiz results: percentage ring coloured by score band, rainbow at 100
- Share links: assistant button like the owner's, hidden during quizzes; documents readable
  in the browser
- Live draft and library updates over server-sent events

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Elijah 2026-11-15 20:30:00 -07:00
parent 60cf2322f7
commit c595e0ff2c
54 changed files with 4710 additions and 387 deletions

View file

@ -112,10 +112,33 @@ Tests: `tests/revision2.test.ts` (mock MCP server over Streamable HTTP and SSE,
instructions in prompts, exam length, calculation allowance, topic merging, message part order,
previews, share-link AI scope and rate limits).
## 2026-11-15: third revision (owner's 13-item list, plus exams and clarifying questions)
Built-in Parallel web search (keyless, optional sign-in) with its own settings page; OAuth for
every MCP server (`server/ai/mcpAuth.ts`); friendly tool steps (`web/src/features/ToolSteps.tsx`,
`server/ai/activity.ts`) with ids stripped from results; thinking box 50% taller; per-chat
tool switches; share-link assistant button matches the owner's and hides during a quiz or
deck; share-link documents readable in the browser (original or text, page by page); live
updates over SSE (`GET /api/events`, drafts and library); quiz results show a % ring
coloured by band (rainbow at 100, green 93–99, blue 85–92, yellow 77–84, red below 77);
Explain opens beside the quiz on wide screens and reads the cited source pages;
OpenUI blocks in all chats; exams within classes (migration 5 adds `classes.group_label` and
`conversations.settings`); assistant clarifying questions (`ask_user`,
`web/src/features/AskCard.tsx`).
Item 13 (beta container losing its data on update): the code keeps the database and secret key
in `/data`, and compose.yaml mounts `${STUDY_DATA_DIR:-./data-v2}:/data`. Data is lost only when
the container runs without that mount (the image's `VOLUME` then gives each new container a new
anonymous volume). Map `/data` to a host path in the Unraid template.
Tests: `tests/revision3.test.ts` (web search, OAuth with a mock authorization server, live
events, cited pages, shared document text, genui prompt, clarifying questions, exam-scoped
generation).
## Verification status
Baseline: 162 tests passed, TypeScript passed and production web/server builds passed.
Added six regression tests. Full `npm run check` passes: **208 tests** (2026-11-15; 181 on 2026-11-12), TypeScript
Added six regression tests. Full `npm run check` passes: **247 tests** (third revision, 2026-11-15; 208 after the second, 181 on 2026-11-12), TypeScript
and both production builds. The Docker `test` stage runs the same 181 tests on Node 24. Tests were run with loopback access for the mock provider.
The earlier agent manually exercised quiz completion/results, flashcards, streak effects,