@jamestesting888/tum-mcp 0.10.0 → 0.11.0

package/CHANGELOG.md

@@ -1,5 +1,51 @@
 # Changes
 
+## 0.11.0 — 2026-10-28
+
+- Add the base `prepare-exams` workflow and the local **Exam Prep** workspace: a
+  cheatsheet with a semester map you can pan, zoom and open full screen, exam patterns
+  with solving workflows and a worked practice question each, guided past papers, and
+  practice exams with a solution under every question. Statistics, map layout,
+  blueprint and novelty checks are derived by code. Exam Prep is never published.
+- Add `tum-mcp study exam-report`, `study text` (page text extracted once per file),
+  `study import` (private local files such as past exams you hold) and
+  `study duplicates` (identical and near-duplicate copies across Moodle, Artemis,
+  Studocu and local files); `study inspect` lists identical copies.
+- Students answer on paper. Only multiple-choice answers are checked; every other step
+  offers Compare, which shows one answer, its explanation and a hint for the likeliest
+  mistake. Exercises no longer show answer boxes, review buttons or status lines;
+  finishing an exercise marks it completed in the outline.
+- Exercises gain code-writing steps that open the function skeleton in an editor and
+  show the model answer as code, numbered code blocks and distilled practice for large
+  programming tasks; prepare-exercises documents how to distil Artemis programming
+  exercises. Text and numeric checks hold a single answer, and authors are told to give
+  every question the context its answers use.
+- Authored questions must show code, a diagram, a formula, a table or a plot beside
+  their text, and their first sentence says what the student produces. A new `uml`
+  block draws UML class, sequence and state diagrams in every workspace, and
+  `` `code` `` in text renders as inline code.
+- Code is syntax-highlighted in blocks, editors and model answers. A new `files` block
+  shows a small project with a file tree, tabs and editable files kept in the browser;
+  steps point at file lines with an "Open in files" jump, code-writing steps edit
+  the project file they point at, and the file tree folds away. Distilled exercises no
+  longer carry concept tags. Code blocks can carry a step-by-step walkthrough, and
+  prepare-study asks for examples shown as a diagram or walkthrough, not only told.
+- Right-click (or Shift+F10) any sidebar entry to mark it completed.
+- A page whose sections all cite the same sources shows one citation beside its title
+  line, and a cheatsheet section whose entries share sources cites them once; exam
+  pages mention past exams only when there are some. Lines that only described a page
+  or told students to compare (such as the Exam Prep summary) are gone, and the skills
+  ask for text that teaches.
+- A new `tree` block draws hierarchies such as file structures, object trees and call
+  trees with icons, connector lines and optional notes.
+- Cheatsheet entries show their recognition cue and pitfall as labelled rows with icons;
+  the semester map has an icon toolbar and an in-canvas legend.
+- Give every skill a Codex display name, so Codex no longer shows "Tum MCP:" prefixes.
+- Pages no longer wait for the local video index; the video panel appears once it loads,
+  so a slow preview server cannot drop it.
+- Pages no longer over-scroll: hidden labels cannot stretch the page, and the space that
+  keeps step arrows in place goes once you scroll back up.
+
 ## 0.10.0 — 2026-10-27
 
 - Add the optional `video-notes` extension (`tum-mcp install video-notes`): short

package/README.md

@@ -30,6 +30,7 @@ submissions, posting and exercise execution are unavailable.
 | `sync-course` | “Set up a project for this course and collect its materials.” |
 | `prepare-study` | “Build lessons, flashcards and practice in a study website.” |
 | `prepare-exercises` | “Add guided exercises from this week's released sheet.” |
+| `prepare-exams` | “Make a cheatsheet and practice exams from the past papers.” |
 | `publish-course` | “Publish my reviewed study site for phone access.” |
 
 Each project holds one course. Run `tum-mcp study` in its folder to open the app.
@@ -69,9 +70,10 @@ course/
   AGENTS.md                 Course instructions and inventory
   materials/                Course content, exams, exercises and other sources
     studocu/                Optional: summaries/, exams/ and other/ PDFs
-  app/                      Study, Exercises and optional Lecture Notes website
+  app/                      Study, Exercises, Exam Prep and optional Lecture Notes website
     content.json            Study lessons, flashcards and practice
     exercises.json          Guided exercise content
+    exam.json               Exam Prep: cheatsheet, exam patterns, practice exams (local only)
     lectures.json           Optional: Lecture Notes
     lecture-assets/         Optional: selected lecture figures
   .tum-mcp/                 Private course state, comments and lecture evidence

package/docs/development.md

@@ -109,6 +109,8 @@ tag and artifact integrity before pushing the release documentation.
 | `src/tum_mcp/client_*.py` | Host-specific configuration and managed skill installation |
 | `src/tum_mcp/study_*.py` | Course snapshots, teaching, build, preview and project-local passage comments |
 | `src/tum_mcp/bundled/skills/` | Canonical versioned source of reading, study, audio and video skills and their references/assets |
+| `src/tum_mcp/exam_*.py` | Exam Prep contracts, derived statistics, report and map layout; never published |
+| `src/tum_mcp/study_text.py`, `study_import.py`, `study_duplicates.py` | Page-text cache, private local imports and cross-provider duplicate reports |
 | `src/tum_mcp/video_*.py`, `bundled/video_runtime/` | Video Notes contracts, lint, media checks, orchestration and the isolated render worker |
 | `npm/` | Private-runtime installation, updates, integrity and cleanup |
 | `tests/` | Synthetic backend, package and owned-browser checks |
@@ -168,7 +170,7 @@ playback tests also run WebKit when Playwright's WebKit is installed.
 
 ## Optional Lecture extension
 
-Base setup exposes five workflows and no `tum_live_*` tools. `install lecture`
+Base setup exposes six workflows and no `tum_live_*` tools. `install lecture`
 records explicit selection, refreshes managed clients and provisions the optional
 recognizer only when requested/supported. `--no-asr` keeps captions/imported WebVTT.
 Heavy recognition dependencies and model weights stay outside the base environment

package/docs/study.md

@@ -1,7 +1,7 @@
 # Course study projects
 
-Five base skills cover source reading, course sync, Study preparation, Exercises
-preparation and publishing. They run in your local agent, using the connected
+Six base skills cover source reading, course sync, Study preparation, Exercises
+preparation, exam preparation and publishing. They run in your local agent, using the connected
 MCP tools to read course sources. The CLI validates and stores the resulting local
 files; it does not run an AI model.
 The optional `prepare-lecture` skill adds a Lecture Notes workspace; install it with
@@ -40,9 +40,10 @@ pse-ws26/
     course.md               Cited course structure, logistics, rules and unknowns
     state.json              Course binding, source versions and coverage
     notes/                  Detailed course/agent notes when needed
-  app/                      Shared Study, Exercises and optional Lecture Notes website
+  app/                      Shared Study, Exercises, Exam Prep and optional Lecture Notes website
     content.json            Optional source-backed Study content
     exercises.json          Optional prepared exercise guidance
+    exam.json               Optional Exam Prep content (local only)
   audio/                    Optional category audio derived from the prepared website
   videos/                   Optional explainer videos derived from the prepared website
 ```
@@ -183,22 +184,54 @@ at the bottom of the outline switches between them and remembers your place; on
 it sits inside the open outline. The exercise list groups exercises by sheet and shows
 each sheet's summary and due date when the sources provide them.
 
-Each exercise shows the original statement and subparts first. Work on paper or in
-the app, open the worked solution directly, or open **Guidance** for the exercise's
-goals and one step at a time with optional hints and specific feedback. Checks cover
-numbers with units and tolerance, multiple choice, fillable tables, graph selections
-and paths, and plotted sample points. Long math and programming work use saved drafts
-and prepared rubrics; code is never executed, and symbolic work, proofs and programs
-are not graded automatically. Mark an exercise reviewed when you are done; Reviewed
-records an action, not mastery or an assessment result. A Next link leads to the
-following exercise.
-
-Drafts and assistance stay in this browser. Editing a checked answer clears its
-verdict. Semantic changes start fresh progress for only that exercise, while retaining older
+Each exercise shows the original statement and subparts first. Work on paper, open the
+worked solution directly, or open **Guidance** for the exercise's goals and one step at
+a time with optional hints. Multiple-choice steps are checked; for every other step you
+work on paper and press **Compare** to see the answer, its explanation and a hint for
+the likeliest mistake. Code steps open the function skeleton in a small editor and
+show the model answer as code; code is never run, and nothing is graded by keywords.
+Finishing the last step marks the exercise completed in the outline; you can also
+right-click any entry to mark it. A Next link leads to the following exercise. Large
+programming exercises can come with small distilled practice exercises that train one
+idea each and link back to the original.
+
+Choices, code drafts, hints and completion marks stay in this browser. Changing a
+checked choice clears its verdict. Semantic changes start fresh progress for only that exercise, while retaining older
 browser records; source-hash review alone preserves progress.
 Reset on each workspace home affects only that workspace. Exercise passage comments
 use the existing private comment service; hosted exports do not expose it.
 
+## Prepare for exams
+
+Ask `prepare-exams` to build the **Exam Prep** workspace from the course's past exams,
+exercises and materials. Past exams come from `materials/exams` (Moodle),
+`materials/studocu/exams` (Studocu) or files you hold yourself:
+
+```bash
+tum-mcp study import ./pse-ws26 --file "Klausur WS23.pdf" --kind exam --title "Endterm WS23/24"
+tum-mcp study duplicates ./pse-ws26 --near   # identical and likely duplicate copies
+tum-mcp study exam-report ./pse-ws26         # what the agent reads before authoring
+```
+
+Imported files stay private and survive campus syncs. Copies of the same exam from
+different places count once.
+
+- **Cheatsheet**: a semester map of the exam-relevant ideas and one-line entries with
+  formulas, triggers and pitfalls; open an entry for details. The map can be dragged,
+  zoomed and opened full screen.
+- **Exam patterns**: recurring question types with recognition cues, a solving workflow,
+  answer template, marking points, a worked practice that applies each workflow step,
+  and drills whose answers you can open at any time.
+- **Practice exams**: work through real past papers question by question with
+  guidance, or read a whole paper and open each question's solution to check yourself;
+  forecast practice exams follow the real exam's length and weighting with new
+  variants and untested topics.
+
+Right-click any entry in the sidebar, in any workspace, to mark it as completed.
+
+Statistics such as "seen in 4 of 6 exams" are history, never a prediction. Exam Prep
+always stays local: it is never published.
+
 Existing `study/` projects continue to work. New projects use `app/`. To upgrade a
 verified legacy layout explicitly, run `tum-mcp study build PROJECT --upgrade-layout`.
 It keeps the original tree at `.tum-mcp/layout-backup/`, preserves the course identity,

package/docs/tum-mcp.md

@@ -2,7 +2,7 @@
 
 Package: `@jamestesting888/tum-mcp`, CLI: `tum-mcp`, backend: Python 3.13.
 The package combines read-only course retrieval, managed client installation and
-five base course workflows and three optional extensions.
+six base course workflows and four optional extensions.
 
 ## Current capabilities
 
@@ -208,7 +208,7 @@ in JSON for troubleshooting. Default diagnostics do not create state folders.
 uses read-only local status to initialize an explicitly chosen available course or
 reconcile an existing project. Incomplete state is preserved for recovery.
 `prepare-study` authors lessons; `prepare-exercises` authors guided released sheets
-in the same local app. See the
+and `prepare-exams` builds a local Exam Prep workspace in the same app. See the
 [study guide](study.md) for examples, state structure and helper commands.
 
 One project holds one course. Source revisions, coverage and course knowledge
@@ -225,8 +225,8 @@ writing files with activation.
 
 The Codex adapter uses a contained Node launcher to pin the managed Python in
 isolated mode; portable stdio manifests require a bare or contained executable.
-The base pack contains five skills: `read-content`, `sync-course`,
-`prepare-study`, `prepare-exercises` and `publish-course`. Optional extensions add
+The base pack contains six skills: `read-content`, `sync-course`,
+`prepare-study`, `prepare-exercises`, `prepare-exams` and `publish-course`. Optional extensions add
 `prepare-lecture`, `sync-studocu`, `audio-notes` and `video-notes`; choose them with
 `tum-mcp install`.
 Website-specific retrieval guidance is loaded from references within read-content.

package/npm/backend/manifest.json

@@ -1,5 +1,5 @@
 {
-  "wheel": "tum_mcp-0.10.0-py3-none-any.whl",
-  "wheelSha256": "69a13997a3c5630f411e0237f33f7b59224b56d96bbcea07f263b939df1a5eff",
+  "wheel": "tum_mcp-0.11.0-py3-none-any.whl",
+  "wheelSha256": "0706ba3855ca5cba44e7ab9d46474129a92f3b7e902f4f610e2273f4c31e2975",
   "requirementsSha256": "39a401b6e606d3292eb91b8fe9ef60367d4852f203eb409dc52f38b76e513ccf"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jamestesting888/tum-mcp",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Read-only TUM campus tools and source-backed study, exercise and lecture workflows",
   "license": "MIT",
   "type": "module",