@jamestesting888/tum-mcp 0.9.1 → 0.9.3

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # Changes
 
+## 0.9.3 — 2026-10-27
+
+- Simplify the README setup and extension guidance.
+
+## 0.9.2 — 2026-10-27
+
+- Combine connection status, extension status and health checks in `doctor`.
+  Show only installed or configured clients, including in the setup picker.
+- Rename campus sign-in to `login`, paired with `logout`. Keep `connect` and
+  `status` as hidden compatibility aliases, including the previous status JSON.
+- Make the course app consistent across Study and Exercises: one choice style,
+  feedback panel, counter format, arrow controls and disclosure chevron. Revision
+  covers all topics until you choose, and review links open the view with items.
+- Show exercise goals in Guidance, sheet summaries and due dates in the list, Mark
+  reviewed at the end with a visible finish, and a link to the next exercise.
+- 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
+  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
+  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
+  page's outline after navigation.
+- Remove unused serif font files. Builds delete unedited copies and publication
+  removes them from managed sites; edited copies are kept.
+- Base the study skills on the app: they describe content and checks and point to
+  the bundled app instead of restating its styling.
+
 ## 0.9.1 — 2026-10-27
 
 - Make Audio Notes an optional `audio-notes` extension. Keep five base skills,

package/README.md

@@ -14,20 +14,10 @@ Requires **Node.js 22.14+**, a Chromium browser and your TUM account.
 ```sh
 npm install --global @jamestesting888/tum-mcp@latest
 tum-mcp setup
-tum-mcp connect
+tum-mcp login
 tum-mcp doctor
 ```
 
-Select `codex`, `claude`, `cursor`, `antigravity` or `generic`, or pass `--client NAME`.
-Follow the activation/restart instructions. In `connect`, select services with
-**Space**, then **Enter**, and complete sign-in/MFA in the browser. Never paste
-credentials into chat. Setup supplies its own Python runtime; Git, Docker and a
-native keyring are unnecessary.
-
-Works on macOS, Windows, glibc Linux x86_64/ARM64 and WSL. For a Windows client
-using a WSL backend, add `--host windows` to setup.
-[Browser and platform details](docs/setup.md).
-
 ## Read and study
 
 Ask your agent to explain course material, find announcements or catch up on a
@@ -62,10 +52,8 @@ Run `tum-mcp install` to choose extensions, then reload your client.
 | `studocu` | `sync-studocu` | Search and collect selected supplementary PDFs saved in your browser. Personal use only; excluded from published sites. |
 | `audio-notes` | `audio-notes` | Turn prepared Study lessons into concise audio tracks, with resumable generation and coverage tracking. Voice setup happens when used. |
 
-Use `tum-mcp status` to see installed workflows and `tum-mcp uninstall` to remove
-them. Named commands also work, such as `tum-mcp install audio-notes` and
-`tum-mcp uninstall lecture`. Existing notes, audio and customizations are retained.
-Audio Notes needs no additional campus sign-in. Studocu uses your own browser.
+Use `tum-mcp doctor` to see installed workflows and `tum-mcp uninstall` to remove
+them.
 
 [Lecture and recognition](docs/lecture-notes.md) ·
 [Studocu collection](docs/study.md#studocu-materials) · [Setup details](docs/setup.md)

package/docs/development.md

@@ -127,10 +127,15 @@ native MathML; legacy MathML remains accepted. Unit `path` labels group the outl
 without changing learning-progress revisions. Shared modules render all units;
 content changes do not require a framework or per-unit HTML.
 
-Shared renderer assets live in `src/tum_mcp/bundled/course_app/site/`. The shipped
-component preview is deliberately minimal; richer learning pilots live in
-`tests/fixtures/course_app/`. The distributed design/teaching/verification contracts live under
-`src/tum_mcp/bundled/skills/prepare-study/references/`. Local agent notes and
+Shared renderer assets live in `src/tum_mcp/bundled/course_app/site/`; they are the
+source of truth for layout, styling and interaction. Design tokens sit at the top of
+`styles.css`, and the owned-browser fixtures in `tests/integration/` hold the UI
+regressions. The preparation skills describe content and point to the app instead
+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;
+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.
 

package/docs/lecture-notes.md

@@ -16,8 +16,10 @@ 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
 same course app, alongside Study and Exercises. Notes have coherent explanations,
-examples, important qualifications, formulas, selective source images and direct
-timestamp access. Attribution review stays private, so the reading flow is clean.
+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.
 
 ## Processing order and cost

package/docs/setup.md

@@ -14,7 +14,7 @@ Linux needs a graphical desktop for native browser sign-in; WSL can use Windows.
 ```sh
 npm install --global @jamestesting888/tum-mcp@latest
 tum-mcp setup --client codex
-tum-mcp connect
+tum-mcp login
 tum-mcp doctor
 tum-mcp --help
 ```
@@ -27,7 +27,7 @@ client afterward. Existing MCP-only setups gain the skills through `tum-mcp upda
 or another setup run. Generic setup writes configuration for manual installation.
 
 Studocu is optional: run `tum-mcp install studocu`, then reload the client. The
-extension adds the `sync-studocu` skill and its tools. `tum-mcp status`
+extension adds the `sync-studocu` skill and its tools. `tum-mcp doctor`
 reports the local selection; `tum-mcp uninstall studocu` disables it and
 preserves course materials and customized files. Generic clients use
 `tum-mcp skills export DESTINATION` to install the active pack manually.
@@ -40,14 +40,17 @@ Existing course audio is retained when the extension is disabled.
 
 ## Terminal output
 
-`tum-mcp status` shows saved connections and optional workflows;
-`tum-mcp doctor` also checks clients and prerequisites, including TUMonline.
+`tum-mcp doctor` is the overview for saved connections, optional extensions,
+client setup and runtime health, including TUMonline. Client rows appear only
+for installed clients or existing TUM MCP registrations; unrelated config
+folders do not count as installations. Setup detects the same clients and
+also offers Generic. Use `--client NAME` for an undetected or nonstandard install.
 Green dots mean ready or enabled, blue means not verified, amber means action
 needed, red means failed, and muted dots mean inactive. Every dot has a text
 label. `NO_COLOR` disables color; narrow terminals use stacked rows.
 
 Bare `tum-mcp setup`, `tum-mcp install` and `tum-mcp uninstall` share the same
-keyboard controls as connect. Nothing is preselected; Ctrl+C cancels. Uninstall
+keyboard controls as login. Nothing is preselected; Ctrl+C cancels. Uninstall
 also offers **All — TUM MCP**, which removes the package and managed client setup.
 Personal notes, sessions and customized files are retained. Scripts can name one or both:
 `tum-mcp uninstall lecture studocu --json`.
@@ -55,13 +58,19 @@ Personal notes, sessions and customized files are retained. Scripts can name one
 Use `--json` for machine-readable status, named extension removal/installation,
 skill listing/validation, lecture runtime status or TUMonline permissions.
 The default human output changed in 0.9.1; scripts that parsed those commands
-must add `--json`. The former `extensions` group is removed; use `status` and
+must add `--json`. The former `extensions` group is removed; use `doctor` and
 `uninstall NAME`. Named client/extension arguments remain suitable for scripts.
 Data-oriented course authoring commands retain JSON output.
 
-## Connect
+`login` replaces `connect`, and `doctor` replaces the separate status screen.
+The old command names remain hidden compatibility aliases. `status --json`
+retains its previous configuration format; new integrations should use `doctor --json`.
 
-Run **`tum-mcp connect`**, with no arguments, in an interactive terminal:
+<a id="connect"></a>
+
+## Login
+
+Run **`tum-mcp login`**, with no arguments, in an interactive terminal:
 
 1. Use up/down to move and Space to select services. Installed Lecture adds TUM-Live;
    installed Studocu adds Studocu.
@@ -79,11 +88,11 @@ connections that already completed. A dumb terminal uses numbered prompts.
 Chrome, Edge, Brave, Chromium, Vivaldi and Opera are detected in their standard
 locations. Selected preview channels and Opera GX are detected where installed.
 For another Chromium build, set `TUM_MCP_BROWSER` to its executable path before
-running connect. Compatible builds must allow Playwright automation. Safari and
+running login. Compatible builds must allow Playwright automation. Safari and
 Firefox are not supported.
 
 After sign-in, Artemis and Zulip can read content available to your campus account.
-No local course/channel grants are required. Your agent uses status/discover and
+No local course/channel grants are required. Your agent uses MCP status/discovery and
 course metadata to find relevant current-semester material, then makes bounded reads.
 An account ID identifies a saved service connection; it is not your TUM login.
 TUMonline additionally has a local policy: `tum-mcp manage tumonline --show`
@@ -105,7 +114,7 @@ Both engines have dedicated CI checks on the current WSL 3.x runner image.
 ```sh
 npm install --global @jamestesting888/tum-mcp@latest
 tum-mcp setup --client cursor --host windows
-tum-mcp connect
+tum-mcp login
 tum-mcp doctor
 ```
 
@@ -144,7 +153,7 @@ browser discovery still requires functioning interop.
   `gh auth login --hostname github.com` interactively on the agent's execution host.
   The [publishing workflow](study.md#publish-a-study-website) uses private repositories
   with public Pages websites and requires an eligible paid GitHub plan.
-- An expired session uses the same `tum-mcp connect` selector. Reconnecting the
+- An expired session uses the same `tum-mcp login` selector. Reconnecting the
   same identity preserves saved preferences.
 - If no browser appears, check its installation or `TUM_MCP_BROWSER`. A managed
   or incompatible Chromium build may prevent automation; try another browser.

package/docs/study.md

@@ -10,98 +10,6 @@ The optional `sync-studocu` skill collects selected student-uploaded material se
 The optional `audio-notes` skill turns prepared lessons into spoken tracks; install
 it with `tum-mcp install audio-notes`.
 
-## Studocu materials
-
-Install the optional extension with `tum-mcp install studocu` and reload your
-client. Ask `sync-studocu` to collect materials for a course project. It can
-initialize a Studocu-only project with a verified course and semester.
-Search is anonymous and bounded; a limited result set is not a complete inventory.
-`tum-mcp studocu connect` explains how to sign in to Studocu in your own browser.
-The extension cannot infer account entitlement or download original files through
-the public MCP. Save an original that your account permits in the browser.
-
-The skill records a reviewed selection with `tum-mcp studocu plan PROJECT
---selection FILE` and tracks it with `tum-mcp studocu status PROJECT --json`.
-Import a selected original with `tum-mcp studocu import PROJECT --document-id ID
---file FILE`. The document-to-file association is user-selected. Originals go to
-`materials/studocu/summaries`, `materials/studocu/exams` (including mocks and
-solutions), or `materials/studocu/other`. Files remain local and retain their
-original bytes. Consult the skill's collection reference for the selection schema.
-Exact matches in the same group, type and known year share one original through
-a private alias. Each selected document retains its own source identity and URL.
-Changing a document's classification or refreshing its original separates aliases
-when they no longer match; previous versions remain in private history.
-When an existing selection is planned again, unchanged duplicate originals are
-consolidated. Edited or missing files are preserved for review.
-
-Local study material can cite student uploads. Publishing rejects included
-Studocu-backed sources; this source check cannot identify uncited copied text or
-replace a review of the published content.
-
-## Publish a study website
-
-The `publish-course` skill makes a prepared site accessible from a phone
-or another computer. Its GitHub repository is private; the Pages website is
-public. An eligible paid GitHub plan is required for Pages from private repositories.
-This workflow does not provide private website access. Review lesson text,
-quotations and source links for the intended public audience before publishing.
-
-Install GitHub CLI on the execution host and run `gh auth login --hostname github.com`.
-`tum-mcp doctor` checks CLI availability without network access; `doctor --live`
-also verifies GitHub authentication. It does not publish anything, open sign-in
-automatically, extract tokens, or change Git credential settings.
-
-```sh
-# Preview the chosen name and hosting requirements without GitHub mutations.
-tum-mcp study publish --project PROJECT
-# After choosing public website content; the repository stays private.
-tum-mcp study publish --project PROJECT --public-site
-# Optional account/name override on first setup:
-tum-mcp study publish --project PROJECT --public-site --repository OWNER/NAME
-```
-
-Names use `study-<course>-<semester>` in lowercase with hyphens. A collision gets
-a stable course suffix; existing repositories are never made public. Settings in
-`.tum-mcp/github.json` bind updates to that course, semester and repository. A
-failed setup retries the same saved repository rather than creating duplicates.
-
-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
-`--include-lectures`; old settings default to exclusion. `--exclude-lectures` also removes
-previously managed lecture images. A notes-only export with notes excluded is refused.
-
-Only the selected generated website renderer and data are uploaded. Downloaded
-originals, credentials, AGENTS.md, study inventory, passage comments, progress,
-audio and arbitrary files stay local. Git itself is not required: the publisher
-uses authenticated GitHub API calls through `gh`. Local publication settings do
-not contain credentials.
-
-After setup, successful `tum-mcp study build PROJECT` commands update that same
-repository automatically. Unchanged verified exports require no network calls
-or commits. The study skills finish related edits in one build. Remote edits
-are preserved for review; the publisher never force-pushes.
-
-```sh
-tum-mcp study publish status PROJECT
-tum-mcp study publish sync PROJECT       # retry pending/failed deployment
-tum-mcp study publish pause PROJECT      # pause future automatic uploads
-tum-mcp study publish resume PROJECT
-tum-mcp study build PROJECT --local-only # skip uploading this build
-```
-
-Uploads are verified against the Pages build and GitHub checks for the exact
-commit. Pending deployment exits with code 2 and is resumable; a successful
-repository update alone is not a deployed site. Authentication, plan or network
-failures preserve the local build. Polling has a budget of at most 60 seconds,
-in addition to bounded API requests.
-The `tum-mcp study` launcher prints local, hosted and repository URLs, plus pending
-or paused status. Study progress remains per browser; passage comments require
-the local preview and are disabled in the hosted export. Device synchronization
-and offline support are not included.
-
 ## Start with one course
 
 Use `sync-course` for both initial setup and later source updates. For a new project,
@@ -192,63 +100,31 @@ restores files when possible and reports any remaining conflict.
 
 ## Prepare the website
 
-Ask `prepare-study` to create or extend the Study workspace in `app/`. Units follow the course's
-lecture/week sequence when useful, or use consistent topics. For a single course, use a flat list or one category level followed by topics,
-including several topics in one week. Every unit has:
+Ask `prepare-study` to create or extend the Study workspace in `app/`. The agent
+writes `app/content.json` from your stored course material, and `tum-mcp study build`
+installs the shared course app and checks every cited source. Units follow the
+course's lecture or week sequence when useful, or consistent topics, with at most
+one category level. Every unit has:
 
-- A concise explanation with source links, assumptions and worked examples.
-- Editable LaTeX formulas and inline variables, diagrams, code or comparison tables where they explain the concept.
-- Flip cards with arrow navigation, Space to flip and 1/2 for Again/Got it.
-- Practice questions with exactly four options, one justified answer and feedback for every option.
+- Content: a short lesson with objectives, source links, assumptions and worked
+  examples, using formulas, tables, code, diagrams or line graphs where they help.
+- Flashcards for recall. On a keyboard, arrows move, Space flips and 1/2 rate a card.
+- Practice questions with plausible options and feedback for every option.
 
 The agent uses stored material first, so local content edits work offline. Ask for
 an upstream refresh when you want new course content; an existing check is reused
-within the same request. Unchanged units and reviewed material are retained.
-
-The skill audits objective coverage, technical accuracy and distractors. Its
-STE-inspired English uses short, direct sentences while retaining necessary terms
-and conditions. The design contract uses TUM blue/navy with quiet reading surfaces,
-local fonts, light/dark themes, keyboard navigation and a phone layout. The outline
-collapses using a midpoint boundary arrow revealed on hover or keyboard focus;
-touch screens keep a visible control. On phones it opens a viewport overlay from
-any reading position, with its own scroll and Escape to close. Theme stays in the
-outline; the reset icon is on the course home. A Next link follows the active
-activity at the end of each view.
-
-Revision combines flashcards and practice from topics you select. Open Revision in
-the outline, choose topics and collapse the checklist when ready. It reuses the
-course's categories; selecting a category includes all its topics, and a mixed
-checkbox shows a partly selected category. Revision reuses the
-original items, sources and progress; selecting or removing topics never clears
-your results. The topic selection is remembered locally for this course.
-
-The topic picker and its nested categories collapse independently. You can select a
-whole category while it is closed; its count and mixed state reflect the selection.
-At End of set, outlined question rows include a Review action and chevron. Click
-one to review it in a popup. Closing the popup returns
-you to the same results row without changing progress.
-
-The website uses Atkinson Hyperlegible Next for headings, explanations and controls.
-Code and mathematical notation retain their specialist fonts. Equations adapt to
-their container and keep local horizontal scrolling for indivisible wide expressions.
-Use `\(v_i\)` in teaching text for inline variables and short expressions (JSON:
-`"Use \\(v_i\\)."`). They compile locally to native MathML, including in tables,
-glossaries, cards, questions and feedback. Code and dollar signs stay literal.
-
-Select text in Content, Flashcards or Practice, 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 passage marker or highlighted text to open its notes beside the quote.
-Markers sit beside section headings or the current card/question position.
-Notes can be edited, resolved or reopened; changed passages retain their original quotes.
-Revision notes retain their original topic and card/question identity.
-
-Tell your agent: **“Address the open comments in this study project.”** The skill
-reads the notes, checks the cited material, improves the affected explanation and
-verifies the result before recording a resolution. Notes and status changes sync
-automatically while the preview is open. Your draft is kept if a note changes
-elsewhere; choose Use latest or Keep mine before saving. Reload after the agent
-rebuilds the teaching content.
+within the same request. Unchanged units and reviewed material are retained. The
+skill audits objective coverage, technical accuracy and distractors, and writes in
+short, direct sentences that keep necessary terms and conditions.
+
+The course home introduces the course, resumes where you left off and lists topics
+with progress. Each view ends with a Next link through cards and practice to the
+next unit. Revision pools cards and questions from the topics you choose (all topics
+until you choose) and can focus on cards marked Again and questions you missed. It
+reuses the original items and progress, so changing the topic selection never clears
+results, and it remembers your selection for this course. Formulas and inline
+notation such as `\(v_i\)` compile locally to native MathML; code and dollar signs
+stay literal. The app has light and dark themes and a phone layout.
 
 Content lives in `app/content.json`; shared renderer modules and CSS keep the
 site extensible. Source hashes identify affected units. A stale source stops a
@@ -261,6 +137,8 @@ tum-mcp study inspect ./pse-ws26
 tum-mcp study build ./pse-ws26
 ```
 
+## Preview the app
+
 From the course project folder, launch the prepared app with:
 
 ```sh
@@ -279,25 +157,39 @@ same-origin endpoint. It makes no campus requests.
 No course credentials are copied into the website. Browser storage holds progress
 locally. Nothing is published by these commands.
 
+## Passage comments
+
+Select text in Content, Flashcards, Practice, Exercises or Lecture Notes, 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
+beside the quote. Notes can be edited, resolved or reopened; changed passages retain
+their original quotes, and Revision notes keep their original topic and item.
+
+Tell your agent: **“Address the open comments in this study project.”** The skill
+reads the notes, checks the cited material, improves the affected explanation and
+verifies the result before recording a resolution. Notes and status changes sync
+automatically while the preview is open. Your draft is kept if a note changes
+elsewhere; choose Use latest or Keep mine before saving. Reload after the agent
+rebuilds the teaching content.
+
 ## Prepare weekly exercises
 
 Ask `prepare-exercises` to prepare released weekly sheets in the same app. Study
-and Exercises can be prepared in either order. When both exist, a selector at the bottom of the sidebar
-switches workspaces and remembers the current place. On phones it lives inside the
-open course outline; there is no second switch in the reading area. Exercises are
-listed directly under sheets, optionally grouped by category.
-
-The original statement and subparts come first. Students can solve on paper, mark
-an exercise Reviewed, reveal a worked solution directly, or open **Guidance**.
-Prepared guidance offers one conceptual step, requested hints and specific repair
-feedback. Numeric checks state units/tolerance; choice checks have four options.
-Fillable tables check numeric cells and explicit text variants individually. Graph
-questions support node/edge selections and ordered paths with a visible diagram.
-Line graphs allow sample-point placement, coordinate edits and keyboard adjustment.
-Long math and programming work use saved writing areas and prepared rubrics; code
-is never executed, and symbolic work, proofs and programs are not automatically
-graded. Arbitrary graph drawing can use paper and rubric comparison. Typing, hints and step-by-step guidance are optional. Reviewed records an
-action, not mastery or an assessment result.
+and Exercises can be prepared in either order. When both exist, the workspace selector
+at the bottom of the outline switches between them and remembers your place; on phones
+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
@@ -312,6 +204,70 @@ learning revisions, comments, settings and personal files, and stops on customiz
 generated files, an occupied backup or two layouts. Repeating a completed upgrade
 is a no-op. Do not create `app/` alongside an existing `study/` by hand.
 
+## Publish a study website
+
+The `publish-course` skill makes a prepared site accessible from a phone
+or another computer. Its GitHub repository is private; the Pages website is
+public. An eligible paid GitHub plan is required for Pages from private repositories.
+This workflow does not provide private website access. Review lesson text,
+quotations and source links for the intended public audience before publishing.
+
+Install GitHub CLI on the execution host and run `gh auth login --hostname github.com`.
+`tum-mcp doctor` checks CLI availability without network access; `doctor --live`
+also verifies GitHub authentication. It does not publish anything, open sign-in
+automatically, extract tokens, or change Git credential settings.
+
+```sh
+# Preview the chosen name and hosting requirements without GitHub mutations.
+tum-mcp study publish --project PROJECT
+# After choosing public website content; the repository stays private.
+tum-mcp study publish --project PROJECT --public-site
+# Optional account/name override on first setup:
+tum-mcp study publish --project PROJECT --public-site --repository OWNER/NAME
+```
+
+Names use `study-<course>-<semester>` in lowercase with hyphens. A collision gets
+a stable course suffix; existing repositories are never made public. Settings in
+`.tum-mcp/github.json` bind updates to that course, semester and repository. A
+failed setup retries the same saved repository rather than creating duplicates.
+
+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
+`--include-lectures`; old settings default to exclusion. `--exclude-lectures` also removes
+previously managed lecture images. A notes-only export with notes excluded is refused.
+
+Only the selected generated website renderer and data are uploaded. Downloaded
+originals, credentials, AGENTS.md, study inventory, passage comments, progress,
+audio and arbitrary files stay local. Git itself is not required: the publisher
+uses authenticated GitHub API calls through `gh`. Local publication settings do
+not contain credentials.
+
+After setup, successful `tum-mcp study build PROJECT` commands update that same
+repository automatically. Unchanged verified exports require no network calls
+or commits. The study skills finish related edits in one build. Remote edits
+are preserved for review; the publisher never force-pushes.
+
+```sh
+tum-mcp study publish status PROJECT
+tum-mcp study publish sync PROJECT       # retry pending/failed deployment
+tum-mcp study publish pause PROJECT      # pause future automatic uploads
+tum-mcp study publish resume PROJECT
+tum-mcp study build PROJECT --local-only # skip uploading this build
+```
+
+Uploads are verified against the Pages build and GitHub checks for the exact
+commit. Pending deployment exits with code 2 and is resumable; a successful
+repository update alone is not a deployed site. Authentication, plan or network
+failures preserve the local build. Polling has a budget of at most 60 seconds,
+in addition to bounded API requests.
+The `tum-mcp study` launcher prints local, hosted and repository URLs, plus pending
+or paused status. Study progress remains per browser; passage comments require
+the local preview and are disabled in the hosted export. Device synchronization
+and offline support are not included.
+
 ## Create and maintain audio notes
 
 Install the optional workflow with `tum-mcp install audio-notes`.
@@ -383,30 +339,56 @@ for the updated study website”** to reconcile added, changed, removed or moved
 material with the previous verified coverage. This is an agent skill, not a new
 `tum-mcp study` CLI subcommand or a built-in speech service.
 
-## Packaged app template
+## Studocu materials
+
+Install the optional extension with `tum-mcp install studocu` and reload your
+client. Ask `sync-studocu` to collect materials for a course project. It can
+initialize a Studocu-only project with a verified course and semester.
+Search is anonymous and bounded; a limited result set is not a complete inventory.
+`tum-mcp studocu login` explains how to sign in to Studocu in your own browser.
+The extension cannot infer account entitlement or download original files through
+the public MCP. Save an original that your account permits in the browser.
+
+The skill records a reviewed selection with `tum-mcp studocu plan PROJECT
+--selection FILE` and tracks it with `tum-mcp studocu status PROJECT --json`.
+Import a selected original with `tum-mcp studocu import PROJECT --document-id ID
+--file FILE`. The document-to-file association is user-selected. Originals go to
+`materials/studocu/summaries`, `materials/studocu/exams` (including mocks and
+solutions), or `materials/studocu/other`. Files remain local and retain their
+original bytes. Consult the skill's collection reference for the selection schema.
+Exact matches in the same group, type and known year share one original through
+a private alias. Each selected document retains its own source identity and URL.
+Changing a document's classification or refreshing its original separates aliases
+when they no longer match; previous versions remain in private history.
+When an existing selection is planned again, unchanged duplicate originals are
+consolidated. Edited or missing files are preserved for review.
+
+Local study material can cite student uploads. Publishing rejects included
+Studocu-backed sources; this source check cannot identify uncited copied text or
+replace a review of the published content.
 
-The shared web-app template is packaged in `bundled/course_app/site/`, separately from skill instructions.
-It includes the shell, navigation, flip cards, practice, diagrams and styling.
-Agents author course content in `app/content.json`; `study build` installs the
-shared template, preserves customized files and checks sources. This keeps new
-course sites consistent without rebuilding the interface. `tum-mcp study template`
-shows the bundled files and their combined revision for reproducible development.
+## The course app
 
-## Try the component template
+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,
+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.
 
-After installing a locally built development artifact:
+To see every component with synthetic data:
 
 ```sh
 tum-mcp study demo ./component-preview
 tum-mcp study serve ./component-preview
 ```
 
-This creates one small Study unit and one exercise covering prose, code, tables,
-formulas, graph/process diagrams, cards and response controls. It is a reusable
-component template, 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. An existing edited demo is preserved.
+The demo creates one small Study unit and one exercise covering prose, code, tables,
+formulas, graph/process diagrams, cards and response controls. 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.
 
 ## Local helper inputs
 

package/docs/tum-mcp.md

@@ -96,15 +96,15 @@ browser onboarding. See [setup](setup.md) for browser choices and WSL.
 ## Connections and read access
 
 ```sh
-tum-mcp connect
-tum-mcp status
+tum-mcp login
+tum-mcp doctor
 tum-mcp discover artemis ACCOUNT_ID
 tum-mcp discover zulip ACCOUNT_ID
 tum-mcp --help
 tum-mcp study build --help
 ```
 
-`connect` takes no arguments or connection options. Move with up/down, toggle
+`login` takes no arguments or connection options. Move with up/down, toggle
 services with Space, and press Enter. Choose a browser when more than one is
 installed. Only selected tabs open in one temporary browser context. Moodle,
 Artemis, Zulip and TUMonline all follow this flow.
@@ -152,7 +152,7 @@ the command offers a numbered text prompt instead.
 When multiple accounts exist, add `--account ACCOUNT_ID`. Reconnecting preserves
 the policy. `tum-mcp manage tumonline --disconnect` removes the local TUMonline
 credential and retains the policy; it does not revoke remote sessions. An expired
-session requires `tum-mcp connect` again. If the policy is missing or corrupt, use
+session requires `tum-mcp login` again. If the policy is missing or corrupt, use
 `tum-mcp manage tumonline --account ACCOUNT_ID --disconnect` to remove that saved
 session without resetting permissions or affecting other providers.
 
@@ -229,8 +229,8 @@ The base pack contains five skills: `read-content`, `sync-course`,
 `prepare-study`, `prepare-exercises` and `publish-course`. Optional extensions add
 `prepare-lecture`, `sync-studocu` and `audio-notes`; choose them with `tum-mcp install`.
 Website-specific retrieval guidance is loaded from references within read-content.
-Teaching, schema and design contracts live
-with prepare-study; the renderer and synthetic example ship as reusable assets.
+Teaching and content guidance lives with prepare-study; the course app and its
+synthetic example ship as reusable assets and define the site's design.
 Audio Notes converts prepared content into category tracks and maintains coverage,
 scripts, voice settings, candidates and archives under the course's `audio/` root.
 Publish Course uses host GitHub CLI authentication to create a private repository
@@ -320,4 +320,4 @@ course material, local agent notes and screenshots stay under ignored local path
 Maintainer checks include a reviewed tarball inventory, integrity checks and an
 isolated consumer install. Never publish or stage npm packages as a test. Registry
 publication is an explicit maintainer action.
-`tum-mcp status` reports registry state as `not_checked`; it reads local configuration.
+`tum-mcp doctor` reads local configuration and does not check the npm registry.

package/npm/backend/manifest.json

@@ -1,5 +1,5 @@
 {
-  "wheel": "tum_mcp-0.9.1-py3-none-any.whl",
-  "wheelSha256": "69d65afa35c27518f03c95e47ddfc23cc77a3d442853804fcb58c2e78b539fe0",
+  "wheel": "tum_mcp-0.9.3-py3-none-any.whl",
+  "wheelSha256": "15601cbdc8b931a64a58eac7aca0be0b4bc7c1df63d11f267d11599d48b29ec2",
   "requirementsSha256": "39a401b6e606d3292eb91b8fe9ef60367d4852f203eb409dc52f38b76e513ccf"
 }

package/npm/tum-mcp.mjs

@@ -22,9 +22,8 @@ try {
       ['Options', [['--version', 'Show the installed version.'], ['-h, --help', 'Show this help.']]],
       ['Commands', [
         ['setup', 'Configure your coding client and managed runtime.'],
-        ['connect', 'Sign in to selected campus services.'],
-        ['status', 'Show saved connections and optional workflows.'],
-        ['doctor', 'Check installation and authentication.'],
+        ['login', 'Sign in to selected campus services.'],
+        ['doctor', 'Show connections, extensions and relevant client/runtime health.'],
         ['install', 'Choose optional Lecture, Studocu or Audio Notes workflows.'],
         ['uninstall', 'Choose extensions or All to remove TUM MCP.'],
         ['manage', 'Manage TUMonline permissions.'],
@@ -38,7 +37,7 @@ try {
         ['serve', 'Run the MCP server over stdio.'],
         ['version', 'Show the installed version.'],
       ]],
-      ['Get started', [['tum-mcp setup --client codex', 'Prepare the backend and a client.'], ['tum-mcp connect', 'Choose services and sign in.']]],
+      ['Get started', [['tum-mcp setup --client codex', 'Prepare the backend and a client.'], ['tum-mcp login', 'Choose services and sign in.']]],
     ]);
   } else if (['--version', 'version'].includes(args[0])) {
     console.log(version);

package/package.json

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