@jamestesting888/tum-mcp 0.9.0 → 0.9.1

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changes
 
+## 0.9.1 — 2026-10-27
+
+- Make Audio Notes an optional `audio-notes` extension. Keep five base skills,
+  preserve existing audio files, and describe all extensions in a compact README table.
+
+- Use one compact terminal layout for help, connection status, extensions,
+  skills and permissions. Keep automation output available through `--json`.
+- Give setup, install and uninstall matching status-aware pickers. Uninstall
+  offers full package removal through All. Keep named commands for scripts and
+  show optional workflow state through status, connect and doctor; remove the
+  separate extensions command group. Studocu browser sign-in stays unverified.
+- Include TUMonline connection and permission status in doctor. Default checks
+  do not read credentials or create policy files; live checks verify identity
+  without fetching studies or grades.
+- Make unverified status dots blue, ready/enabled green, action needed amber,
+  failures red and inactive states muted. Preserve labels with color disabled.
+
 ## 0.9.0 — 2026-10-26
 
 - Add read-only TUMonline study, public catalog and partial curriculum-position

package/README.md

@@ -13,12 +13,12 @@ Requires **Node.js 22.14+**, a Chromium browser and your TUM account.
 
 ```sh
 npm install --global @jamestesting888/tum-mcp@latest
-tum-mcp setup --client codex
+tum-mcp setup
 tum-mcp connect
 tum-mcp doctor
 ```
 
-Choose `codex`, `claude`, `cursor`, `antigravity` or `generic` as the client.
+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
@@ -40,7 +40,6 @@ 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.” |
-| `audio-notes` | “Turn the prepared lessons into audio notes.” |
 | `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.
@@ -55,28 +54,21 @@ account policy with `tum-mcp manage tumonline`.
 
 ## Optional extensions
 
-Install only the workflows you need, then reload your client:
+Run `tum-mcp install` to choose extensions, then reload your client.
 
-```sh
-tum-mcp install lecture          # Prepare Lecture + TUM-Live tools and local ASR
-tum-mcp install lecture --no-asr # Use captions/imported WebVTT instead
-tum-mcp install studocu         # Supplementary Studocu collection workflow
-tum-mcp extensions status
-```
-
-**Lecture Notes** captures the professor's extra explanations, examples and
-caveats, with timestamp links. It starts with transcripts and lecture materials;
-only critical visuals need recording frames. Local recognition uses Apple Silicon
-acceleration or a separate CPU runtime on supported hosts.
-[Lecture Notes and recognizer requirements](docs/lecture-notes.md).
+| 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. |
+| `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. |
 
-**Studocu** adds public search and reviewed import of permitted original PDFs you
-save in your browser. Search coverage is incomplete; browser credentials stay out
-of the integration. These supplementary materials remain for personal use and
-cannot be included in published sites. [Studocu workflow](docs/study.md#studocu-materials).
+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.
 
-Remove either extension with `tum-mcp uninstall lecture` or
-`tum-mcp uninstall studocu`. Notes, evidence and customizations are preserved.
+[Lecture and recognition](docs/lecture-notes.md) ·
+[Studocu collection](docs/study.md#studocu-materials) · [Setup details](docs/setup.md)
 
 ## Privacy, updates and removal
 

package/docs/development.md

@@ -40,7 +40,7 @@ Each layer owns a different failure boundary:
 | Unit | Parsing, policy, malformed input and failure branches with synthetic collaborators |
 | Integration | Real files, CLI/MCP, transactions, HTTP confinement and isolated project updates |
 | Installed consumer | Actual npm/wheel contents, managed runtime and complete browser workflows |
-| Public upgrade | Earlier published versions, repair, ownership conflicts and removal |
+| Public upgrade | Published 0.9.0, repair, ownership conflicts and removal |
 | Native platform | OS credential/ACL behavior; WSL Windows browser transport on both engines |
 
 Study integration fixtures build the private rich regression fixture once, then copy it into a fresh
@@ -59,8 +59,9 @@ CI runs macOS, Windows and Linux, plus both distribution engines on WSL 3.x.
 Consumer checks install the actual npm artifact, discover tools, build a study
 site and test available Chromium browsers with temporary profiles and synthetic
 pages. WSL verifies Windows browser transport. No live account is used.
-Upgrade checks cover public 0.8.0 and 0.8.1, client refresh, customized-file conflicts,
-failed preparation, runtime repair and removal that preserves work/credentials.
+Upgrade checks start from public 0.9.0 and cover all five clients, optional-extension
+retention, customized-file conflicts, failed preparation, runtime repair and
+removal that preserves work/credentials. Earlier releases are outside this matrix.
 The package-lifecycle check uses a local synthetic registry and real isolated
 global npm prefixes to verify downloads, backend validation, replacement,
 failure ordering and one-command removal. It does not publish a test release.
@@ -143,7 +144,7 @@ check keyboard navigation, reduced motion, source links and retained progress.
 
 ## Optional Lecture extension
 
-Base setup exposes six workflows and no `tum_live_*` tools. `install lecture`
+Base setup exposes five 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
@@ -152,7 +153,7 @@ and package artifacts. `lecture_processing/` owns bounded media/ASR evidence;
 and figures used by the static app. See [the workflow guide](lecture-notes.md).
 
 Use `skills validate --all` to check the packaged optional workflow without installing
-it; default validation checks the selected six/seven. Activation statistics remain
+it; default validation checks the selected workflows. Activation statistics remain
 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

package/docs/lecture-notes.md

@@ -9,7 +9,7 @@ tum-mcp install lecture --no-asr
 ```
 
 Restart the coding client to load Prepare Lecture and the three TUM-Live metadata
-tools. Base setup keeps its six skills and existing services. Removing the option
+tools. Base setup keeps its five skills and existing services. Removing the option
 with `tum-mcp uninstall lecture` preserves course notes, evidence, sessions,
 model caches and customizations. Reinstalling can reuse them.
 

package/docs/setup.md

@@ -19,30 +19,59 @@ tum-mcp doctor
 tum-mcp --help
 ```
 
-Use `--client claude`, `cursor`, `antigravity`, or `generic` for another client.
+Run `tum-mcp setup` to choose clients interactively, or pass `--client claude`,
+`cursor`, `antigravity`, or `generic` directly. Existing registrations have status dots.
 Codex needs the plugin enabled and a restart when prompted. Cursor and
-Antigravity setup installs all six base skills and MCP configuration; restart each
+Antigravity setup installs all five base skills and MCP configuration; restart each
 client afterward. Existing MCP-only setups gain the skills through `tum-mcp update`
 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 extensions status`
-reports the local selection; `tum-mcp extensions remove studocu` disables it and
+extension adds the `sync-studocu` skill and its tools. `tum-mcp status`
+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.
 Setup preserves unrelated settings and refuses to
 replace customized entries. It does not authenticate or fetch courses.
 
+Audio Notes is optional: use `tum-mcp install audio-notes`. It adds the
+`audio-notes` skill for prepared Study content; synthesis is set up when used.
+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.
+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
+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`.
+
+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
+`uninstall NAME`. Named client/extension arguments remain suitable for scripts.
+Data-oriented course authoring commands retain JSON output.
+
 ## Connect
 
 Run **`tum-mcp connect`**, with no arguments, in an interactive terminal:
 
-1. Use up/down to move and Space to select Moodle, Artemis, Zulip and/or TUMonline.
+1. Use up/down to move and Space to select services. Installed Lecture adds TUM-Live;
+   installed Studocu adds Studocu.
 2. Press Enter. If several browsers are installed, choose one and press Enter.
 3. Complete TUM sign-in/MFA in the opened window. Only selected service tabs open.
 4. Return to the terminal for the saved-connection result.
 
-The services use the same temporary-browser sign-in and encrypted session storage flow.
+Campus services use temporary-browser sign-in and encrypted session storage.
+Studocu opens your own default browser (the Windows browser from WSL); sign in
+there. Its browser session is neither copied nor claimed as verified.
 No API key or native credential-store prompt is needed. A temporary browser
 profile keeps the connection separate from your everyday browser. Ctrl+C closes it and preserves
 connections that already completed. A dumb terminal uses numbered prompts.
@@ -167,6 +196,7 @@ the npm package and all managed registrations:
 
 ```sh
 tum-mcp uninstall
+# Choose All to remove TUM MCP and its managed client setup.
 ```
 
 Custom edits and user-added files are preserved. Codex's local source/catalog

package/docs/study.md

@@ -1,9 +1,14 @@
 # Course study projects
 
-Six base skills cover source reading, course sync, Study preparation, Exercises preparation, audio and publishing.
+Five base skills cover source reading, course sync, Study preparation, Exercises
+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 `sync-studocu` skill collects selected student-uploaded material separately.
+The optional `audio-notes` skill turns prepared lessons into spoken tracks; install
+it with `tum-mcp install audio-notes`.
 
 ## Studocu materials
 
@@ -32,13 +37,10 @@ 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.
-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.
 
 ## Publish a study website
 
-The optional `publish-course` skill makes a prepared site accessible from a phone
+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,
@@ -312,6 +314,7 @@ is a no-op. Do not create `app/` alongside an existing `study/` by hand.
 
 ## Create and maintain audio notes
 
+Install the optional workflow with `tum-mcp install audio-notes`.
 Use `prepare-study` to author the interactive course, then ask `audio-notes` to
 convert that prepared content into spoken lessons. For example:
 

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
-six local course workflows.
+five base course workflows and three optional extensions.
 
 ## Current capabilities
 
@@ -225,9 +225,11 @@ 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 shipped pack contains six skills: `read-content`, `sync-course`,
-`prepare-study`, `prepare-exercises`, `audio-notes` and `publish-course`. Website-specific retrieval
-guidance is loaded from references within read-content. Teaching, schema and design contracts live
+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.
 Audio Notes converts prepared content into category tracks and maintains coverage,
 scripts, voice settings, candidates and archives under the course's `audio/` root.
@@ -246,7 +248,7 @@ routing quality is a separate evaluation from structural and discovery checks.
 Claude's invocation metadata follows each workflow's selected policy; automatic
 selection is enabled by default and never grants permission for a mutation.
 
-`setup --client cursor` writes `~/.cursor/mcp.json` and installs all six skills
+`setup --client cursor` writes `~/.cursor/mcp.json` and installs the active skills
 under `~/.cursor/skills/`.
 `setup --client antigravity` installs the same skills under `~/.gemini/config/skills/`
 and writes `~/.gemini/config/mcp_config.json`; an existing

package/npm/backend/manifest.json

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

package/npm/package-manager.mjs

@@ -72,7 +72,7 @@ async function operate(job) {
     const staging = join(job.temporary, 'prepared');
     runNpm(job.npm, ['install', '--prefix', staging, '--global=false', archive], true);
     const prepared = join(staging, 'node_modules', packageName);
-    runLauncher(prepared, ['setup'], true);
+    runLauncher(prepared, ['setup', '--runtime-only'], true);
     // Only a healthy prepared release may replace the user's npm installation.
     runNpm(job.npm, ['install', ...scope, job.target.global ? archive : `${packageName}@${latest}`]);
     if (JSON.parse(readFileSync(join(job.root, 'package.json'), 'utf8')).version !== latest) throw new Error('npm did not install the selected version; client activation was stopped.');

package/npm/tum-mcp.mjs

@@ -4,61 +4,88 @@ import { readFileSync } from 'node:fs';
 import { parseArgs } from 'node:util';
 import { acquireSetupLock, currentPython, dataRoot, ensureRuntime, removeRuntimeFiles } from './runtime.mjs';
 import { managePackage } from './package-manager.mjs';
+import { printHelp } from './ui.mjs';
 
 let args = process.argv.slice(2);
 const version = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version;
 try {
-  if (args.length === 0 || (args.length === 1 && ['--help', '-h'].includes(args[0]))) {
-    console.log(`TUM MCP ${version}
-Usage: tum-mcp COMMAND [OPTIONS]
-
-  setup       Configure your coding client and managed runtime
-  install     Install an optional extension: lecture or studocu
-  connect     Sign in to selected campus services
-  status      Show saved connections
-  discover    List accessible courses or channels
-  doctor      Check installation and authentication
-  update      Update the package and configured clients
-  uninstall   Remove managed setup and the npm package
-  logout      Remove one saved connection
-  serve       Run the MCP server over stdio
-  version     Show the installed version
-  skills      Manage local workflow skills
-  extensions  Manage optional extensions
-  studocu     Manage selected Studocu materials
-  study       Prepare, preview and publish a course app
-
-Use --help for options, for example: tum-mcp study build --help
-Run setup to provision the managed backend, then connect to sign in.
-Reads use your campus account permissions; no local scope selection is needed.`);
+  const wantsHelp = args.length === 0 || args.some(arg => ['--help', '-h'].includes(arg));
+  const helpPython = wantsHelp ? currentPython() : null;
+  if (helpPython) {
+    const forwarded = args.length ? args.filter(arg => !['--local', '--keep-package'].includes(arg)) : ['--help'];
+    const env = { ...process.env }; delete env.PYTHONPATH; delete env.PYTHONHOME;
+    const child = spawnSync(helpPython, ['-I', '-m', 'tum_mcp', ...forwarded], { env, stdio: 'inherit', shell: false });
+    if (child.error) throw new Error('Managed backend could not start; run setup again.');
+    process.exitCode = child.status ?? 1;
+  } else if (args.length === 0 || (args.length === 1 && ['--help', '-h'].includes(args[0]))) {
+    printHelp(version, 'Campus tools and local study workflows.', 'tum-mcp [OPTIONS] COMMAND [ARGS]...', [
+      ['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.'],
+        ['install', 'Choose optional Lecture, Studocu or Audio Notes workflows.'],
+        ['uninstall', 'Choose extensions or All to remove TUM MCP.'],
+        ['manage', 'Manage TUMonline permissions.'],
+        ['skills', 'Inspect and validate workflow skills.'],
+        ['study', 'Prepare, preview and publish a course app.'],
+        ['lecture', 'Prepare lecture recording evidence (optional extension).'],
+        ['studocu', 'Collect selected supplementary materials (optional extension).'],
+        ['discover', 'List accessible courses or channels.'],
+        ['update', 'Update the package and configured clients.'],
+        ['logout', 'Remove one saved connection.'],
+        ['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.']]],
+    ]);
   } else if (['--version', 'version'].includes(args[0])) {
     console.log(version);
   } else if (args[0] === 'install' && args.some(arg => ['--help', '-h'].includes(arg))) {
-    console.log('Usage: tum-mcp install lecture [--asr|--no-asr] | tum-mcp install studocu\nInstall an optional Lecture or Studocu workflow and its tools. Lecture recognition dependencies are isolated; models load on demand.');
-  } else if (['setup', 'update', 'uninstall'].includes(args[0]) && !['lecture', 'studocu'].includes(args[1]) && args.some(arg => ['--help', '-h'].includes(arg))) {
+    printHelp(version, 'Choose optional workflows to install, or provide their names.', 'tum-mcp install [lecture|studocu|audio-notes]... [OPTIONS]', [
+      ['Options', [['--asr / --no-asr', 'Provision isolated lecture recognition; models load on demand.'], ['--json', 'Print machine-readable results.'], ['-h, --help', 'Show this help.']]],
+    ]);
+  } else if (['setup', 'update', 'uninstall'].includes(args[0]) && args.some(arg => ['--help', '-h'].includes(arg))) {
     const help = {
-      update: 'Usage: tum-mcp update [--local]\nInstall the latest npm release and refresh configured clients.\n--local refreshes this installed version without contacting npm.',
-      setup: 'Usage: tum-mcp setup [--client codex|claude|cursor|antigravity|generic] [--host local|windows]\nProvision the managed runtime and register explicitly selected clients.',
-      uninstall: 'Usage: tum-mcp uninstall [--all] [--purge-runtime] [--forget-credentials]\nRemove managed client setup and this npm installation. Saved data is retained by default.\n--client NAME removes one client only. --keep-package keeps npm installed.',
+      update: {
+        description: 'Install the latest npm release and refresh configured clients.',
+        usage: 'tum-mcp update [OPTIONS]',
+        options: [['--local', 'Refresh the installed version without contacting npm.']],
+      },
+      setup: {
+        description: 'Prepare the runtime and choose coding clients to configure.',
+        usage: 'tum-mcp setup [OPTIONS]',
+        options: [['--client NAME', 'Choose codex, claude, cursor, antigravity or generic; repeat as needed.'], ['--host local|windows', 'Choose the client host; windows is for WSL registrations.']],
+      },
+      uninstall: {
+        description: 'Remove managed setup while retaining saved user data by default.',
+        usage: 'tum-mcp uninstall [lecture|studocu|audio-notes]... [OPTIONS]',
+        options: [['(no arguments)', 'Choose extensions or All in the interactive picker.'], ['--client NAME', 'Remove one client registration.'], ['--host local|windows', 'Choose the client host.'], ['--purge-runtime', 'Remove verified runtimes when All is selected.'], ['--forget-credentials', 'Forget saved credentials when All is selected.']],
+      },
     };
-    console.log(help[args[0]]);
+    const selected = help[args[0]];
+    printHelp(version, selected.description, selected.usage, [
+      ['Options', [...selected.options, ['-h, --help', 'Show this help.']]],
+    ]);
   } else {
-    if (args[0] === 'install' && !['lecture', 'studocu'].includes(args[1])) throw new Error('Usage: tum-mcp install lecture [--asr|--no-asr] | tum-mcp install studocu.');
+    const hasExtension = args.slice(1).some(arg => ['lecture', 'studocu', 'audio-notes'].includes(arg));
     let packageAction = args[0] === 'update';
     if (args[0] === 'update') {
       if (args.length > 2 || (args.length === 2 && args[1] !== '--local')) throw new Error('Usage: tum-mcp update [--local]. Use --help for details.');
       if (args[1] === '--local') { packageAction = false; args = ['update']; }
     }
-    if (args[0] === 'uninstall' && !['lecture', 'studocu'].includes(args[1])) {
+    if (args[0] === 'uninstall' && !hasExtension) {
       const { values } = parseArgs({ args: args.slice(1), options: {
         all: { type: 'boolean' }, client: { type: 'string' }, host: { type: 'string' },
-        'keep-package': { type: 'boolean' }, 'purge-runtime': { type: 'boolean' }, 'forget-credentials': { type: 'boolean' },
+        'keep-package': { type: 'boolean' }, 'purge-runtime': { type: 'boolean' }, 'forget-credentials': { type: 'boolean' }, json: { type: 'boolean' },
       } });
       if (values.host && !['local', 'windows'].includes(values.host)) throw new Error('Choose --host local or windows.');
       if (values.client !== undefined && !['codex', 'claude', 'cursor', 'antigravity', 'generic'].includes(values.client)) throw new Error('Choose a supported --client name.');
       if (values.client && (values.all || values['purge-runtime'] || values['forget-credentials'])) throw new Error('Client-only removal cannot use --all or data/runtime cleanup options.');
-      if (!values.client && !values.all) args.push('--all');
-      packageAction = !values.client && !values['keep-package'];
+      if (values.all && values.json) throw new Error('--json requires named extensions.');
+      if (values['keep-package'] && !values.all && !values.client) throw new Error('Use --client for registration-only removal.');
+      packageAction = Boolean(values.all) && !values['keep-package'];
       args = args.filter(arg => arg !== '--keep-package');
     }
     if (packageAction) {
@@ -69,12 +96,15 @@ Reads use your campus account permissions; no local scope selection is needed.`)
       if (!python) throw new Error('SETUP_REQUIRED: Run tum-mcp setup first.');
       const forwarded = args;
       const env = { ...process.env, TUM_MCP_NPM_LAUNCHER: '1' }; delete env.PYTHONPATH; delete env.PYTHONHOME;
-      const purge = args[0] === 'uninstall' && args.includes('--purge-runtime');
+      const purge = args[0] === 'uninstall' && args.includes('--purge-runtime') && args.includes('--all');
       const release = purge ? await acquireSetupLock() : null;
       try {
         const child = spawnSync(python, ['-I', '-m', 'tum_mcp', ...forwarded], { env, stdio: 'inherit', shell: false });
         if (child.error) throw new Error('Managed backend could not start; run setup again.');
         process.exitCode = child.status ?? (child.signal === 'SIGINT' ? 130 : 1);
+        if (args[0] === 'uninstall' && child.status === 20) {
+          process.exitCode = await managePackage('uninstall', [...args.slice(1), '--all'], dataRoot());
+        }
         if (purge && child.status === 0) await removeRuntimeFiles();
       } finally { if (release) await release(); }
     }

package/npm/ui.mjs

@@ -0,0 +1,51 @@
+// Bootstrap help stays available before Python setup; installed help uses the backend.
+const color = process.stdout.isTTY && !('NO_COLOR' in process.env) && process.env.TERM !== 'dumb';
+const width = Math.min(Number(process.env.COLUMNS) || process.stdout.columns || 80, 100);
+const styled = (text, code) => color ? `\x1b[${code}m${text}\x1b[0m` : text;
+
+function line(text, indent = '') {
+  const available = Math.max(16, width - indent.length);
+  let remaining = text;
+  while (remaining.length > available) {
+    const space = remaining.lastIndexOf(' ', available);
+    const end = space > 0 ? space : available;
+    console.log(indent + remaining.slice(0, end));
+    remaining = remaining.slice(end).trimStart();
+  }
+  console.log(indent + remaining);
+}
+
+export function printHelp(version, description, usage, sections = []) {
+  console.log(`${styled('TUM MCP', '1')}  Help  ${styled(version, '2')}`);
+  line(description);
+  console.log();
+  line('Usage');
+  line(usage, '  ');
+  console.log();
+  for (const [title, rows] of sections) {
+    console.log(styled(title, '1'));
+    const labelWidth = Math.max(...rows.map(([label]) => label.length)) + 2;
+    for (const [label, detail] of rows) {
+      if (width < 70 || labelWidth > width / 2) {
+        line(label);
+        line(detail, '  ');
+      } else {
+        const prefix = label.padEnd(labelWidth);
+        const available = Math.max(16, width - prefix.length);
+        const words = detail.split(' ');
+        let row = '';
+        let first = true;
+        for (const word of words) {
+          if (row && row.length + word.length + 1 > available) {
+            console.log((first ? prefix : ' '.repeat(labelWidth)) + row);
+            first = false;
+            row = '';
+          }
+          row += (row ? ' ' : '') + word;
+        }
+        console.log((first ? prefix : ' '.repeat(labelWidth)) + row);
+      }
+    }
+    console.log();
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jamestesting888/tum-mcp",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Read-only TUM campus tools and source-backed study, exercise and lecture workflows",
   "license": "MIT",
   "type": "module",
@@ -12,6 +12,7 @@
   },
   "files": [
     "npm/tum-mcp.mjs",
+    "npm/ui.mjs",
     "npm/runtime.mjs",
     "npm/download.mjs",
     "npm/lock.mjs",