@jamestesting888/tum-mcp 0.14.1 → 0.15.0

package/CHANGELOG.md

@@ -1,5 +1,66 @@
 # Changes
 
+## 0.15.0 — 2026-10-31
+
+- The managed block in a course project's `AGENTS.md` is now an agent guide. It tells the
+  agent that it works for a student of the course, which skill handles which kind of
+  request (and how to answer "what should I do now?" with a dated plan), how to read short
+  requests such as "this week" or "the exam", where each kind of course information lives,
+  and how to answer as a tutor. `study sync` and `study upgrade` replace an outdated guide
+  and keep the student's own text; an edited guide is kept and reported.
+- `tum-mcp study find PROJECT "words"` lists the pages of stored sources that mention every
+  word, with a snippet each, and names the sources it could not search. Without words it
+  lists every source with its key, title, file and status.
+- New course handbooks have a Conventions section for the textbook, notation, terms and
+  answer format the course expects.
+- Agents look at the slide and sheet pages they rely on instead of trusting extracted text,
+  which drops figures and scrambles tables and formulas. `study text --images` renders up to
+  12 pages to PNGs for hosts that cannot open PDFs (such as Codex), and `study find` and
+  `study text` name the PDF file so hosts that can (such as Claude Code) open the page
+  directly. The agent guide, the skills and the Moodle and Artemis read tools say so; the
+  unused PDF page reader in the extraction worker became this renderer.
+- One unreadable page no longer fails a whole PDF. When pypdf rejects a page (for example a
+  slide beyond its parsing limits) or the whole file (a damaged cross-reference table), PDFium
+  reads it instead; a page neither can read is listed as needing a visual check. This covers
+  `study text`, `study find`, `study import` and Moodle and Artemis material text. `study find`
+  also matches words printed with ligatures, so "first" finds "first".
+- Course content can use heading levels 1 to 3 in Study, Exercises, Exam and Lecture.
+  A block without a title continues the section above it, so a table or answer frame
+  no longer needs a heading of its own. The page outline nests subsections.
+- A multi-part exercise shows one guide per part. The Guide, Solution and "Try another"
+  buttons share one row under the problem, and the redundant list of part numbers is gone.
+- `study report` flags a flat Study outline of four or more units, multi-part exercises that
+  share one guide, and exercise passages that set assumptions or sources apart.
+- review-course also scores organization and redundancy for each unit and exercise, and the
+  course as a whole: the order of its units and groups, what repeats across units and
+  workspaces, and, when Exercises, Exam or Lecture sit beside Study, how they
+  link to the passages that teach what they need (integration). `study report --section
+  structure` prints a course map and flags terms used before they are taught, odd groups,
+  repeated passages and practice, and missing links. Each lost point names its rubric
+  check, and the report counts the checks that fail most. An existing `review.json` still
+  loads and lists the dimensions it lacks.
+- PDF text extraction works for agents running in a macOS sandbox such as Codex's
+  `workspace-write`: its memory limit no longer needs to list every process on the machine,
+  which the sandbox forbids, so `study text` no longer fails on uncached PDFs there.
+- The skills group Study units by lecture, fold assumptions into the problem statement,
+  give verdicts with the source's definitions, cover every presented part of the chosen
+  sheet, and take the newest sheet stamped for the current semester when no release date
+  is shown.
+- Campus tools that only read from Moodle, Artemis or Zulip and save local files or
+  checkpoints (`moodle_download_material`, `moodle_refresh`, `artemis_get_attachment`,
+  `zulip_save_checkpoint`) are now marked read-only, so agents that ask before
+  non-read-only tools no longer prompt for downloads. Sign-in, sign-out and cache
+  clearing keep their warnings.
+- `tum-mcp doctor --live` saves each campus check with its time, and `doctor` and the
+  `login` selector show that result for 12 hours instead of "Not verified". Signing in
+  again or logging out clears it; only the result, its time and file metadata are stored.
+
+## 0.14.2 — 2026-10-30
+
+- TUMonline login keeps its browser open when an unauthenticated session refresh
+  returns an empty HTTP 204, allowing sign-in to finish instead of reporting
+  `INVALID_RESPONSE`.
+
 ## 0.14.1 — 2026-10-30
 
 - TUMonline login keeps waiting while sign-in is incomplete. An empty HTTP 200
@@ -26,7 +87,7 @@
 - Drawings keep 12 px text on a phone: graphs and UML diagrams shrink only that far and
   scroll sideways beyond it; plots redraw at their real width.
 - `tum-mcp study visuals PROJECT` measures every drawn visual of lessons, practice
-  questions, exercise steps and Exam Prep at 390, 600 and 1280 px (lines through nodes,
+  questions, exercise steps and Exam at 390, 600 and 1280 px (lines through nodes,
   clashing labels, small or clipped text, drawings that differ from their block), writes
   contact sheets to `.tum-mcp/visuals/` and records the result; `study report` gains a
   render section that lists missing, stale and failing checks.
@@ -65,8 +126,8 @@
   graph. **Compare** is now the only reveal: hints stop after the last one, a step
   without a check is compared too, and an explanation may not repeat its model answer.
 - **Review** beside a prerequisite opens that Study passage next to the exercise without
-  losing your place; a unit links its Lecture Notes, the exercises that build on it and
-  the Exam Prep patterns that cite it, and Lecture Notes link back. In the local
+  losing your place; a unit links its Lecture, the exercises that build on it and
+  the Exam patterns that cite it, and Lecture link back. In the local
   preview, a citation opens the stored course file at the cited page.
 - A new `review-course` skill scores each Study unit and exercise from 1 to 3 on
   correctness, clarity, cognitive load, representation, practice and coverage, saves the
@@ -99,11 +160,11 @@
 
 ## 0.11.0 — 2026-10-28
 
-- Add the base `prepare-exams` workflow and the local **Exam Prep** workspace: a
+- Add the base `prepare-exams` workflow and the local **Exam** 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.
+  blueprint and novelty checks are derived by code. Exam 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,
@@ -131,7 +192,7 @@
 - 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
+  or told students to compare (such as the Exam 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.
@@ -190,9 +251,9 @@
 - Improve detail: readable graph edges, fitted phone diagram labels, word-wrapped
   boxes, no dark-mode flash, steady flashcard layout, labelled reset and in-app
   confirmation for deleting comments, and neutral page copy on published sites.
-- Lecture Notes: recording times open from the sources of each passage and figure
+- Lecture: recording times open from the sources of each passage and figure
   instead of appearing in the text, and the sidebar lists lectures only.
-- Add a Contents button to Study, Exercises and Lecture Notes. It lists the page's
+- Add a Contents button to Study, Exercises and Lecture. It lists the page's
   headings and follows your reading; wide screens can keep it docked beside the
   text. The home resume button shows a play icon with the topic name.
 - Keep queued Contents updates from a previous view from hiding the current
@@ -227,7 +288,7 @@
   `tum-mcp install studocu`. Preserve originals, course bindings and recovery
   history; supplementary personal-use sources are excluded from publication.
 - Add optional `tum-mcp install lecture` and Prepare Lecture for timestamped
-  Lecture Notes in the existing course app. Prefer transcripts and supplied
+  Lecture in the existing course app. Prefer transcripts and supplied
   materials, skip whole-silent recordings, preserve original-time coverage and
   request only critical video frames. Publication remains an explicit opt-in.
 - Support isolated, pinned CPU recognition on Windows x64, Intel Mac and supported

package/README.md

@@ -51,7 +51,7 @@ Run `tum-mcp install` to choose extensions, then reload your client.
 
 | Extension | Skill added | What it offers |
 | --- | --- | --- |
-| `lecture` | `prepare-lecture` | Lecture Notes with the professor's extra explanations, timestamps and selected critical visuals. Prefers transcripts and slides; local recognition is optional. |
+| `lecture` | `prepare-lecture` | Lecture with the professor's extra explanations, timestamps and selected critical visuals. Prefers transcripts and slides; local recognition is optional. |
 | `audio-notes` | `audio-notes` | Turn prepared Study lessons into concise audio tracks, with resumable generation and coverage tracking. Voice setup happens when used. |
 | `video-notes` | `video-notes` | Turn prepared Study topics into short narrated, animated explainers that play inside the local app, with checked sync, captions and layout. The render runtime installs when first used. |
 
@@ -69,11 +69,11 @@ After initialization, a course project looks something like this:
 course/
   AGENTS.md                 Course instructions and inventory
   materials/                Course content, exams, exercises and other sources
-  app/                      Study, Exercises, Exam Prep and optional Lecture Notes website
+  app/                      Study, Exercises, Exam and optional Lecture 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
+    exam.json               Exam: cheatsheet, exam patterns, practice exams (local only)
+    lectures.json           Optional: Lecture
     lecture-assets/         Optional: selected lecture figures
   .tum-mcp/                 Private course state, comments and lecture evidence
   audio/                    Optional: scripts, tracks and chapters for Audio Notes

package/docs/development.md

@@ -28,6 +28,41 @@ Set `TUM_MOODLE_SYSTEM_KEYRING=1` for a unique synthetic native-store round trip
 The ordinary campus runtime uses encrypted local files and owner-restricted keys.
 Set `TUM_MCP_BROWSER_INTEGRATION=1` to include the real HTTP static-export browser
 check locally; CI enables it. Set environment variables using your shell's syntax.
+Consumer checks default to full study journeys on every discovered browser.
+CI sets `TUM_MCP_STUDY_BROWSER_JOURNEYS=primary`: the first browser on each desktop
+OS and WSL engine runs the full installed study journey; every additional browser
+runs a short installed UI check. All browsers retain real pipe transport, synthetic
+cookie and encrypted-session checks. The shorter journey covers module loading,
+content/flashcard/practice views, saved progress after reload, keyboard navigation,
+theme switching and phone/desktop overflow under a project URL prefix. Consumer
+JSON names each browser's `studyCoverage` and records `studySeconds`. Unset the
+variable or use `all` for a browser-specific investigation; other values fail
+before consumer installation.
+
+Owned loopback browsers use `launch_loopback_browser`, including local visual
+checks and Windows browsers launched through WSL. On Windows it disables
+Chromium's `TcpPortRandomizationWin`, which can fail local module requests with
+`ERR_NO_BUFFER_SPACE` even when socket resources are available
+([upstream issue](https://issuetracker.google.com/issues/572515601)). The launcher
+reads and preserves Playwright's default disabled features before adding this
+opt-out. A native browser regression checks the effective arguments, and installed
+consumer checks verify that the option reaches Windows browsers through WSL.
+
+The broad checkout study journey runs on Linux. macOS and Windows deselect only
+`tests/integration/test_study_browser.py::test_study_website_journeys_pass_in_the_checkout`;
+their full installed journeys still exercise that fixture. Other source tests and
+native checks keep their existing coverage. Package builds, upgrades and lifecycle
+tests continue in all five environments. Ruff lint/format runs once on Linux, after dependency
+installation. The existing five exact-revision GitHub checks remain required.
+
+During development, run affected tests and focused regressions. Reuse applicable
+passing results instead of running a complete local suite immediately before the
+same required CI suite. Full integration/release coverage may come from that
+exact-revision CI run; a local pass never substitutes for pending or failed native
+checks. Relevant source, test, dependency or environment changes invalidate earlier
+results. `AGENTS.md` is local and ignored; this tracked document carries the policy
+to other checkouts.
+
 Verbose test IDs, immediate first-failure output, slowest-test timings and a stack
 dump after 60 seconds make a stalled boundary visible. The dump is diagnostic;
 it does not skip a slow test or extend the CI deadline.
@@ -108,7 +143,7 @@ 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/exam_*.py` | Exam 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 |
@@ -139,7 +174,11 @@ regressions. The preparation skills describe content and point to the app instea
 of restating its styling, so app changes need no skill edits unless an authored field
 or its meaning changes. Remove a template file by moving it to
 `RETIRED_TEMPLATE_FILES`: builds then delete unedited copies and publication removes
-them from managed sites. The shipped component preview is deliberately minimal;
+them from managed sites. The shipped component preview demonstrates the three
+heading levels, untitled continuations and guides placed beneath their own exercise
+parts using validated `part_blocks` anchors. Include the optional Lecture
+workspace with `tum-mcp study demo PROJECT --lectures` after selecting the Lecture
+extension. The preview remains deliberately minimal;
 richer learning pilots live in `tests/fixtures/course_app/`. Local agent notes and
 screenshots belong in ignored `docs/local/` or `.omo/`. Keep real course projects,
 session files, databases, downloads and environment files out of artifacts.
@@ -183,3 +222,20 @@ unmeasured until genuine fresh-session trial records exist. Default tests use
 synthetic media and course data. `test:consumer` and `test:upgrade` exercise optional
 install/update/export/removal from an actual local npm artifact. Never publish or
 stage npm as a test.
+
+## Explore maintenance boundary
+
+`ExploreMaterial` uses existing safe blocks and its own versioned sources. Empty
+`Unit.explore` is omitted for legacy serialization; `unit_revision` excludes it to
+preserve core progress. Full teaching/render reviews include it. The private ledger
+records source-backed enrichment classification and separate pending work; classification
+changes invalidate course-review structure identity. Default global definitions,
+prerequisite maps, Revision and audio/video inputs stay core-only.
+
+`explore.mjs` is a packaged template asset. Routes, tab sets, reading outlines and
+comments must be checked with and without optional items. Explore anchors use comment
+schema v4 without rewriting legacy files on read. Keep export source/asset closure
+complete while removing private paths and classification reasons. Extend the existing
+installed browser journey, rather than adding a platform matrix. Focused regressions
+live in `test_study_explore.py` and `test_study_explore_browser.py`; run them plus affected
+study/course-app/exercise tests and installation/migration checks for integration.

package/docs/lecture-notes.md

@@ -1,4 +1,4 @@
-# Lecture Notes
+# Lecture
 
 Install the optional extension only when needed:
 
@@ -13,14 +13,14 @@ tools. Base setup keeps its five skills and existing services. Removing the opti
 with `tum-mcp uninstall lecture` preserves course notes, evidence, sessions,
 model caches and customizations. Reinstalling can reuse them.
 
-Ask: “Prepare Lecture Notes from this recording and these slides, focusing on
-what the professor explains beyond the material.” It adds Lecture Notes to the
+Ask: “Prepare Lecture from this recording and these slides, focusing on
+what the professor explains beyond the material.” It adds Lecture to the
 same course app, alongside Study and Exercises. Notes have coherent explanations,
 examples, important qualifications, formulas and selective source images. The
 sources of each passage and figure open the recording at the measured time, so the
 text carries no timestamps, and the Contents button lists the lecture's sections. Attribution
 review stays private, so the reading flow is clean.
-Lecture Notes has no quizzes or flashcards; broader teaching/practice stays in Study.
+Lecture has no quizzes or flashcards; broader teaching/practice stays in Study.
 
 ## Processing order and cost
 
@@ -136,12 +136,13 @@ receipt/image updates. Local comments support `--view lectures --lecture KEY`.
 
 Open with `tum-mcp study` from the course folder. For a credential-free synthetic
 preview after installing the extension, use `tum-mcp study demo PROJECT --lectures`.
-The default demo still has only Study and Exercises. Synthetic teaching/timestamps
+The default demo includes Study, Exercises and Exam. The Lecture option
+adds a synthetic recording, source image and nested heading examples. Synthetic teaching/timestamps
 exercise the product and do not establish real lecture accuracy.
 
 ## Publication
 
-Lecture Notes is excluded from publication by default, including old saved
+Lecture is excluded from publication by default, including old saved
 configurations. After reviewing public exposure, use the existing publish-course
 workflow with `--include-lectures`; Exercises has a separate choice. Exclusion
 removes lecture text, lecture-only sources/math and referenced images from exports,

package/docs/study.md

@@ -4,8 +4,8 @@ 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
-`tum-mcp install lecture`. See [Lecture Notes](lecture-notes.md).
+The optional `prepare-lecture` skill adds a Lecture workspace; install it with
+`tum-mcp install lecture`. See [Lecture](lecture-notes.md).
 The optional `audio-notes` skill turns prepared lessons into spoken tracks; install
 it with `tum-mcp install audio-notes`. The optional `video-notes` skill turns prepared
 topics into short narrated explainer videos; install it with `tum-mcp install video-notes`.
@@ -29,7 +29,7 @@ retrieved source is recorded as a gap rather than an empty course.
 
 ```text
 pse-ws26/
-  AGENTS.md                 Course knowledge and current inventory
+  AGENTS.md                 Managed agent guide, then your own rules
   materials/
     content/                Lectures, slides and reading
     exams/                  Available revision material
@@ -39,17 +39,26 @@ 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, Exam Prep and optional Lecture Notes website
+  app/                      Shared Study, Exercises, Exam and optional Lecture website
     content.json            Optional source-backed Study content
     exercises.json          Optional prepared exercise guidance
-    exam.json               Optional Exam Prep content (local only)
+    exam.json               Optional Exam content (local only)
   audio/                    Optional category audio derived from the prepared website
   videos/                   Optional explainer videos derived from the prepared website
 ```
 
-`AGENTS.md` retains user rules and points agents to `.tum-mcp/course.md`. That short
-handbook explains the course's goals, lectures/tutorials, weekly work and platforms,
-assessment/bonus conditions, communication and preparation map. Claims carry source
+`AGENTS.md` starts with a managed agent guide; keep your own rules and standing
+preferences outside it. The guide tells the agent that it works for a student of this
+course, which skill handles which kind of request, how to read short requests such as
+"this week" or "the exam", where each kind of course information lives, and how to
+answer as a tutor: from the course's own sources and notation, with the next step
+before a full solution. `study sync` and `study upgrade` replace an outdated guide and
+keep the rest of the file; an edited guide is kept and reported for review.
+
+The guide sends the agent to `.tum-mcp/course.md` first. That short handbook explains
+the course's goals, lectures/tutorials, weekly work and platforms, assessment/bonus
+conditions, conventions (textbook, notation, answer format), communication and
+preparation map. Claims carry source
 links/locators and checked dates; unknowns and conflicting announcements stay visible.
 Detailed source content remains in materials/. All TUM MCP course state, plans and
 agent notes live under .tum-mcp/.
@@ -68,7 +77,8 @@ comments, publication settings and the full old root instructions as
 `.tum-mcp/legacy-AGENTS.md`. Course identity, materials and browser progress stay the
 same. Existing legacy state remains readable until upgrade; two state folders are
 a conflict to reconcile, never silently merged. This differs from the web-folder
-upgrade below.
+upgrade below. In a project that already uses `.tum-mcp/`, `study upgrade` only
+refreshes the agent guide in `AGENTS.md`.
 
 ## State-based workflow
 
@@ -136,7 +146,7 @@ until you choose) and can focus on cards marked Again and questions you missed.
 question you missed stays there after **Try again**; it leaves once you answer it
 correctly from a fresh start. Revision reuses the original items and progress, so
 changing the topic selection never clears results, and it remembers your selection
-for this course. A unit's header links the Lecture Notes, exercises and Exam Prep
+for this course. A unit's header links the Lecture, exercises and Exam
 patterns that build on it. In the local preview, a citation opens the stored course
 file at the cited page. Formulas and inline
 notation such as `\(v_i\)` compile locally to native MathML; code and dollar signs
@@ -150,18 +160,36 @@ and reported, so the agent must review compatibility when extending them.
 
 ```sh
 tum-mcp study inspect ./pse-ws26
+tum-mcp study find ./pse-ws26 "observer pattern"   # stored pages that mention every word
+tum-mcp study text ./pse-ws26 --key KEY --pages 3-5 --images   # page text plus a PNG of each page
 tum-mcp study build ./pse-ws26
-tum-mcp study report ./pse-ws26   # review flags and what the sources leave uncovered
+tum-mcp study report ./pse-ws26   # review flags, the course map and what the sources leave uncovered
 tum-mcp study visuals ./pse-ws26  # measure every drawn visual and draw contact sheets
 ```
 
+Slide text finds and quotes a page, but it drops figures and scrambles tables and
+formulas, so the agent looks at every slide or sheet page it relies on. Hosts that
+display PDFs, such as Claude Code, open the page directly; for the others, such as
+Codex, `study text --images` renders up to 12 pages to PNGs under `.tum-mcp/cache/`,
+once per file version, without Poppler or any other system tool.
+
 The agent records what each lecture states students should learn, and which sheet
 problems are prepared, in `.tum-mcp/coverage.json`. `study report` lists outcomes
 that are not yet taught, sources not yet read and problems still pending, so a request
 to cover a whole course is judged against the course's own outcomes.
 
-`study visuals` opens every lesson, practice question, exercise step and Exam Prep
-visual in an installed Chrome, Edge or Chromium at phone (390 px), narrow (600 px) and
+The Study overview shows known core gaps under **Not prepared yet**, including outcomes
+that are partly prepared. Unknown source coverage and optional reading backlog stay
+in the local agent report. They do not create learner-facing panels or count as prepared.
+The core list updates on build after the agent reviews and updates the ledger; it does
+not track the student's progress. Exercises uses the same expandable presentation for
+pending sheets. Hosted Study queues include
+only sources referenced by the published Study units; the local coverage report keeps
+the full preparation inventory.
+
+`study visuals` opens every lesson, practice question, exercise step and Exam
+visual, including exercise Solution, Compare and transfer-answer blocks, in an installed
+Chrome, Edge or Chromium at phone (390 px), narrow (600 px) and
 desktop (1280 px) width. It reports lines through nodes, labels that overlap or sit on a
 line, text under 12 px, clipped text and drawings that differ from their block, writes
 contact sheets to `.tum-mcp/visuals/` and records the result in
@@ -169,15 +197,29 @@ contact sheets to `.tum-mcp/visuals/` and records the result in
 and `study report` lists items whose check is missing, stale or failing.
 
 Ask `review-course` to score the lessons and exercises the way a student meets them.
-It reads each item in five passes (logic, text, visuals, interaction and intuition) and
-gives each unit and exercise 1 to 3 points for correctness, clarity, cognitive load,
-representation, practice, coverage and intuition. Each drawn visual gets its own score
-from the contact sheets for fidelity, form, layout, legibility, focus and convention,
-calibrated against a gallery of rated examples (`study visuals --gallery`). The agent
-names what costs each point, saves the scores in `.tum-mcp/review.json`, then fixes the
-findings and scores again.
-Editing a unit or exercise makes its score stale, so `study report` lists what needs a
-new review and what is still below the bar. The scores are not shown in the app.
+It reads each item in six passes (logic, text, visuals, interaction, intuition and
+structure) and gives each unit and exercise 1 to 3 points for correctness, clarity,
+cognitive load, representation, practice, coverage, intuition, organization and
+redundancy. Each drawn visual gets its own score from the contact sheets for fidelity,
+form, layout, legibility, focus and convention, calibrated against a gallery of rated
+examples (`study visuals --gallery`). A course pass then scores the course as a whole:
+the order of its units and groups, what repeats across units and workspaces, and, when
+Exercises, Exam or Lecture are prepared beside Study, how well they link to
+the passages that teach what they need. `study report --section structure` gives that
+pass a course map and flags terms used before they are taught, odd groups, repeated
+passages and practice, and missing links. The agent names the rubric check behind each
+lost point, saves the scores in `.tum-mcp/review.json`, then fixes the findings and
+scores again.
+Editing a unit or exercise makes its score stale, and so does changing the course's
+units, groups or links for the course score, so `study report` lists what needs a new
+review and what is still below the bar. A scorecard saved under an earlier rubric still
+loads; the report lists the dimensions it lacks. The scores are not shown in the app.
+
+Workspace profiles keep the shared dimensions but tailor their evidence: exercise
+reviews preserve released statements and assess each part's guide and answer rather
+than requiring a second lesson. Exam checks distinguish cheatsheets, patterns and papers;
+Lecture checks recording fidelity and added explanation without requiring quizzes.
+Exam and Lecture findings currently belong to the course pass, not separate item scores.
 
 ## Preview the app
 
@@ -201,7 +243,7 @@ locally. Nothing is published by these commands.
 
 ## Passage comments
 
-Select text in Content, Flashcards, Practice, Exercises or Lecture Notes, then click
+Select text in Content, Flashcards, Practice, Exercises or Lecture, then click
 **Comment** to record what is unclear. You can also use Ctrl/Command+Alt+M after
 selecting text. The local preview saves notes in `.tum-mcp/comments.json`, separately
 from learning progress. Click a numbered marker or highlighted text to open its notes
@@ -223,13 +265,16 @@ 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, open the
-solution directly (one short answer per part, as a table, graph, formula or code), or
-open **Guidance** for the exercise's goals and one step at a time with optional hints.
+Each sub-question keeps its statement, supporting blocks, Guide and Solution together.
+Shared givens come first. Work on paper, open that question's Solution directly (as a
+table, graph, formula or code), or use its guide for one step at a time with optional
+hints. Solutions open independently and reveal only their own question's answer;
+shared solution notes appear once after the questions.
 Multiple-choice steps are checked; for every other step you work on paper and press
 **Compare**, the one place that shows the answer, its reasoning and a hint for the
 likeliest mistake. **Review** beside a prerequisite opens the Study passage next to
-the exercise without losing your place. A sheet whose problems are not all prepared
+the exercise on desktop, or as a full-page view on mobile. Closing it returns to the
+same step and scroll position. A sheet whose problems are not all prepared
 says which ones are still missing. 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
@@ -245,7 +290,7 @@ 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,
+Ask `prepare-exams` to build the **Exam** workspace from the course's past exams,
 exercises and materials. Past exams come from `materials/exams` (Moodle) or files you hold yourself:
 
 ```bash
@@ -270,7 +315,7 @@ different places count once.
 
 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
+Statistics such as "seen in 4 of 6 exams" are history, never a prediction. Exam
 always stays local: it is never published.
 
 Existing `study/` projects continue to work. New projects use `app/`. To upgrade a
@@ -311,7 +356,7 @@ Study is the default hosted workspace, including for old settings. Exercise
 statements, hints and full solutions need explicit `--include-exercises` on the
 publish command after reviewing their public exposure. `--exclude-exercises`
 removes Exercises from subsequent eligible exports, using the same repository and URL. An
-Exercises-only site also requires explicit inclusion. Lecture Notes separately requires
+Exercises-only site also requires explicit inclusion. Lecture separately requires
 `--include-lectures`; old settings default to exclusion. `--exclude-lectures` also removes
 previously managed lecture images. A notes-only export with notes excluded is refused.
 
@@ -492,7 +537,7 @@ Imported files stay private: they are never published.
 
 The shared course app is packaged in `bundled/course_app/site/`, separately from the
 skill instructions. It owns layout, styling and interaction for Study, Exercises and
-Lecture Notes. Agents author only course content; `study build` installs the app,
+Lecture. Agents author only course content; `study build` installs the app,
 preserves customized files and checks sources, so courses gain app improvements
 without rewriting content. `tum-mcp study template` shows the bundled files and
 their combined revision for reproducible development.
@@ -505,8 +550,10 @@ tum-mcp study serve ./component-preview
 ```
 
 The demo creates one small Study unit and one exercise covering prose, code, tables,
-formulas, graphs, UML diagrams, a flowchart, plots, cards and response controls. It is a format
-reference, not necessarily a good teaching or question-authoring example; actual
+formulas, graphs, UML diagrams, a flowchart, plots, cards and response controls.
+It also includes pending Study topics and exercise sheets, plus private report examples
+of unknown coverage and optional backlog. It is a
+format reference, not necessarily a good teaching or question-authoring example; actual
 course authoring follows reviewed sources and the preparation skills. Rich learning
 pilots stay in private test fixtures. It uses no campus account, and an existing
 edited demo is preserved.
@@ -527,3 +574,20 @@ Import paths are confined to the snapshot directory. Data is stored under the
 bound project; credentials and unrelated personal records must never enter it.
 Keep real course projects private and out of package artifacts. Uninstalling the
 package preserves projects; remove your own project directory separately when wanted.
+
+## Optional Explore reading
+
+Prepared topics can include an **Explore** tab after Practice for useful supporting
+context and further reading. It appears only when that topic has authored material
+and opens directly on the reading. Core Content stays sufficient for the course tasks.
+Explore has no required completion, cards, questions or minutes, and Continue/Next
+keeps the core learning sequence.
+
+Authors classify passages against course outcomes and task dependencies, using the
+bundled prepare-study `references/explore.md` policy and private coverage ledger.
+Core gaps, optional backlog and unrecorded coverage remain separate in agent reports;
+only known core gaps appear on the learner overview. Optional items
+carry their own source versions and stable keyed blocks. Changes still need source,
+teaching and visual review but preserve saved core practice progress. Local passage
+comments remain item-scoped; published sites include optional reading with Study and
+exclude private comments/classification reasons. `study demo PROJECT` shows an example.

package/docs/tum-mcp.md

@@ -191,7 +191,13 @@ The tools resolve one exact mapping; ambiguity never grants broader access.
 
 `doctor` reads local configuration and checks runtime prerequisites. It does not
 open a browser, contact campus services, decrypt sessions, or read native stores.
-Saved sessions are **Not verified** until checked. Git and Docker are not
+Saved sessions are **Not verified** until checked. Live campus results are saved
+locally with a timestamp and reused by `doctor` and the `login` selector for
+12 hours. Expiry means verification is stale, not that the session is disconnected.
+A fresh live check replaces the previous result, including failures. Replacing
+credentials or logging out invalidates their saved verification. Only the result,
+timestamp and file metadata are recorded, not credentials or campus responses.
+Git and Docker are not
 prerequisites. Client registration is distinguished
 from activation; the host must confirm a running MCP connection after setup.
 
@@ -208,7 +214,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
-and `prepare-exams` builds a local Exam Prep workspace in the same app. See the
+and `prepare-exams` builds a local Exam 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

package/npm/backend/manifest.json

@@ -1,5 +1,5 @@
 {
-  "wheel": "tum_mcp-0.14.1-py3-none-any.whl",
-  "wheelSha256": "d634fd64fe6d6c058866a4b952e901c6eadb55809cca531f123bd144959294e0",
+  "wheel": "tum_mcp-0.15.0-py3-none-any.whl",
+  "wheelSha256": "5b63831a3518b0896ec1cd6722faea01cf856c71c2ffde8aab703b30f3fe49ae",
   "requirementsSha256": "39a401b6e606d3292eb91b8fe9ef60367d4852f203eb409dc52f38b76e513ccf"
 }

package/package.json

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