monash-study-kit 1.11.2__tar.gz → 1.16.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (168) hide show
  1. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/CHANGELOG.md +62 -0
  2. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/PKG-INFO +231 -159
  3. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/PRIVACY.md +10 -0
  4. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/README.md +227 -156
  5. monash_study_kit-1.16.0/README.zh-CN.md +914 -0
  6. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/docs/adr/0001-one-shared-core.md +1 -1
  7. monash_study_kit-1.16.0/docs/adr/0005-local-reliability-and-change-tracking.md +41 -0
  8. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/docs/adr/README.md +1 -0
  9. monash_study_kit-1.16.0/docs/read-reliability-audit-2026-11.md +22 -0
  10. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/docs/releasing.md +1 -1
  11. monash_study_kit-1.16.0/docs/reliability.md +80 -0
  12. monash_study_kit-1.16.0/docs/screenshots/README.md +19 -0
  13. monash_study_kit-1.16.0/docs/screenshots/course-export.png +0 -0
  14. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/pyproject.toml +3 -2
  15. monash_study_kit-1.16.0/scripts/demo_course_export.py +44 -0
  16. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/__init__.py +1 -1
  17. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/attendance.py +51 -26
  18. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/attendance_evidence.py +6 -0
  19. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/attendance_http.py +2 -2
  20. monash_study_kit-1.16.0/src/monash_study_kit/attendance_session.py +103 -0
  21. monash_study_kit-1.16.0/src/monash_study_kit/changes.py +151 -0
  22. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/cli.py +229 -5
  23. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/cli_attendance.py +9 -1
  24. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/content_index.py +25 -8
  25. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/doctor_deep.py +8 -2
  26. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/edsync.py +57 -48
  27. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/export.py +54 -11
  28. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/features.py +9 -4
  29. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/help_menu.py +3 -0
  30. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/jobs.py +117 -48
  31. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/lessons.py +17 -5
  32. monash_study_kit-1.16.0/src/monash_study_kit/local_state.py +52 -0
  33. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/materials_policy.py +1 -1
  34. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/mcp_server.py +147 -27
  35. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/moodlelib.py +85 -6
  36. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/output.py +3 -1
  37. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/paths.py +29 -18
  38. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/remote.py +4 -1
  39. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/service_setup.py +3 -2
  40. monash_study_kit-1.16.0/src/monash_study_kit/session_recovery.py +60 -0
  41. monash_study_kit-1.16.0/src/monash_study_kit/skipped.py +149 -0
  42. monash_study_kit-1.16.0/src/monash_study_kit/submissions.py +182 -0
  43. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/syncer.py +262 -21
  44. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/textextract.py +40 -5
  45. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/todo.py +2 -0
  46. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/update_check.py +13 -4
  47. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_attendance_fast.py +1 -1
  48. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_attendance_parity.py +19 -0
  49. monash_study_kit-1.16.0/tests/test_attendance_session.py +124 -0
  50. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_content_index.py +1 -1
  51. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_doctor_deep.py +1 -1
  52. monash_study_kit-1.16.0/tests/test_download_filters.py +418 -0
  53. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_export_pdf.py +1 -1
  54. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_features.py +6 -0
  55. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_folderpick.py +2 -2
  56. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_mcp.py +16 -1
  57. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_moodle_content.py +11 -4
  58. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_panels.py +3 -3
  59. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_profiles.py +1 -1
  60. monash_study_kit-1.16.0/tests/test_reliability.py +420 -0
  61. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_remote.py +10 -0
  62. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_security.py +2 -2
  63. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_shared_core.py +6 -1
  64. monash_study_kit-1.16.0/tests/test_submissions.py +194 -0
  65. monash_study_kit-1.16.0/tests/test_uninstall.py +32 -0
  66. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_update_check.py +32 -0
  67. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/uv.lock +107 -109
  68. monash_study_kit-1.11.2/README.zh-CN.md +0 -600
  69. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/.github/ISSUE_TEMPLATE/bug_report.yml +0 -0
  70. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/.github/ISSUE_TEMPLATE/config.yml +0 -0
  71. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/.github/ISSUE_TEMPLATE/feature_request.yml +0 -0
  72. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/.github/pull_request_template.md +0 -0
  73. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/.github/workflows/release.yml +0 -0
  74. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/.github/workflows/test.yml +0 -0
  75. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/.gitignore +0 -0
  76. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/CODE_OF_CONDUCT.md +0 -0
  77. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/CONTRIBUTING.md +0 -0
  78. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/LICENSE +0 -0
  79. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/SECURITY.md +0 -0
  80. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/docs/SECURITY-REVIEW-1.5-SCOPE.md +0 -0
  81. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/docs/adr/0002-read-only-public-package.md +0 -0
  82. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/docs/adr/0003-release-from-a-tag.md +0 -0
  83. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/docs/adr/0004-confirmed-mail-and-attendance-actions.md +0 -0
  84. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/docs/gmail-foundation.md +0 -0
  85. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/docs/google-and-attendance-setup.md +0 -0
  86. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/docs/panels-library-remote.md +0 -0
  87. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/docs/screenshots/todo.png +0 -0
  88. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/docs/security.md +0 -0
  89. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/glama.json +0 -0
  90. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/scripts/check_dist.py +0 -0
  91. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/scripts/measure_tokens.py +0 -0
  92. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/scripts/smoke_test.py +0 -0
  93. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/skills/monash-study-kit/SKILL.md +0 -0
  94. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/__main__.py +0 -0
  95. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/attendance_assets/PROVENANCE.md +0 -0
  96. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/attendance_assets/extract-rows.js +0 -0
  97. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/attendance_assets/shared.js +0 -0
  98. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/attendance_auto.py +0 -0
  99. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/browser_login.py +0 -0
  100. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/cdp.py +0 -0
  101. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/claude_setup.py +0 -0
  102. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/cli_ed.py +0 -0
  103. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/cli_gmail.py +0 -0
  104. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/cli_google.py +0 -0
  105. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/cli_profile.py +0 -0
  106. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/clients.py +0 -0
  107. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/doctor.py +0 -0
  108. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/edexport.py +0 -0
  109. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/edlib.py +0 -0
  110. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/edquery.py +0 -0
  111. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/entry.py +0 -0
  112. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/folderpick.py +0 -0
  113. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/gmail.py +0 -0
  114. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/gmail_tools.py +0 -0
  115. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/google_client.json +0 -0
  116. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/google_export.py +0 -0
  117. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/home.py +0 -0
  118. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/htmldom.py +0 -0
  119. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/htmlmd.py +0 -0
  120. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/lesson_reader.py +0 -0
  121. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/library.py +0 -0
  122. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/location.py +0 -0
  123. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/mdhtml.py +0 -0
  124. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/moodle_content.py +0 -0
  125. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/pdfrender.py +0 -0
  126. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/recordings.py +0 -0
  127. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/semester.py +0 -0
  128. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/service_actions.py +0 -0
  129. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/service_jobs.py +0 -0
  130. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/student_services.py +0 -0
  131. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/student_tools.py +0 -0
  132. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/transcribe.py +0 -0
  133. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/ui/panel.html +0 -0
  134. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/webnotes.py +0 -0
  135. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/src/monash_study_kit/widgets.py +0 -0
  136. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/conftest.py +0 -0
  137. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_attendance_browser.py +0 -0
  138. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_cdp.py +0 -0
  139. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_cli.py +0 -0
  140. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_clients.py +0 -0
  141. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_course_export.py +0 -0
  142. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_doctor.py +0 -0
  143. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_ed_auth.py +0 -0
  144. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_ed_export.py +0 -0
  145. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_ed_markdown.py +0 -0
  146. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_ed_query.py +0 -0
  147. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_ed_quiz.py +0 -0
  148. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_ed_tracking.py +0 -0
  149. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_feature_cli.py +0 -0
  150. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_gmail.py +0 -0
  151. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_google_export.py +0 -0
  152. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_help_menu.py +0 -0
  153. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_layout.py +0 -0
  154. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_lesson_reader.py +0 -0
  155. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_library.py +0 -0
  156. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_location.py +0 -0
  157. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_recordings.py +0 -0
  158. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_removed_files.py +0 -0
  159. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_semester.py +0 -0
  160. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_service_setup.py +0 -0
  161. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_setup.py +0 -0
  162. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_skill.py +0 -0
  163. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_student_gmail.py +0 -0
  164. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_student_tools.py +0 -0
  165. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_sync_robustness.py +0 -0
  166. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_todo.py +0 -0
  167. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_webnotes.py +0 -0
  168. {monash_study_kit-1.11.2 → monash_study_kit-1.16.0}/tests/test_without_ed.py +0 -0
@@ -2,6 +2,68 @@
2
2
 
3
3
  Version numbers follow `__version__` in `src/monash_study_kit/__init__.py`: patch for bug fixes, minor for new features.
4
4
 
5
+ ## 1.16.0
6
+
7
+ - Choose what `monash sync` downloads. Files over `max_file_mb` (default 300 MB, `0` for no limit) are saved as links with their size instead of being downloaded. `skip_types` leaves out whole kinds of files: `pdf`, `slides`, `docs`, `sheets`, `archives`, `images`, `audio`, `code`. Skipped files appear in `links.md` and in the export's list of what was not exported; files already downloaded are kept.
8
+ - `monash sync --videos`, `--no-videos`, `--max-mb N` and `--skip-types a,b` change these choices for one sync without touching the settings.
9
+ - Videos are also recognised by the `Content-Type` Moodle returns and by the real file name in `Content-Disposition`, so a recording whose address has no extension is no longer downloaded in full. The size check reads `Content-Length` before writing anything and stops a download that runs past the limit when the server sends no length, leaving no partial file.
10
+ - The same rules now apply to files inside a Moodle folder. Videos inside a folder zip used to be extracted even with `download_videos` off. A folder zip larger than the limit falls back to downloading its files one by one.
11
+ - `monash skipped` lists every file left out by these settings with a stable number, its size and why. `monash skipped --get 3 7` (or part of a file name, or `all`) downloads just those files, ignoring the limit and the kinds left out; a file inside a folder zip is taken from a fresh copy of that zip without touching the other files. `list_files(skipped=true)` gives the same list to the AI.
12
+ - After `monash sync`, the files skipped for the first time are named with their size, together with the commands to get them.
13
+ - Raising the limit or turning videos on now downloads the skipped files on the next sync, including files inside a folder zip that was cached less than seven days ago. Files already downloaded are not downloaded again.
14
+ - The AI app can download skipped files too: `sync_monash_data(get_skipped="3,7")` runs in the background like a sync. `list_files(skipped=true)` tells it to mention the size first.
15
+ - `monash skipped` shows the total size and only lists units you still track (name a unit to see an old one); `--get` checks there is enough free disk space before it starts.
16
+ - A file skipped after reading its response headers is not requested again on later syncs unless the settings now allow it.
17
+ - `monash doctor --deep` no longer reports files skipped by these settings as missing.
18
+ - Fix: `monash sync <unit>`, `monash export --sync` and `monash skipped --get` now take the same sync lock as the background sync. Running one while the AI app was syncing could delete the other's partial downloads.
19
+ - Fix: on Windows, file and folder names such as `CON`, `NUL` or `AUX.pdf` (reserved by Windows) get a `_` in front instead of failing to save.
20
+ - README: new sections on choosing what gets downloaded, partial syncs and reading your submitted work. Usage that was only in the per-release notes moved into the export, attendance and everyday-use sections, and the release notes are now one line per version.
21
+
22
+ ## 1.15.1
23
+
24
+ - `monash update` no longer ends with `ImportError: cannot import name 'update_check'` after a successful update. When uv rebuilt the tool environment for a different Python, the running command could not load that module from the replaced files any more. It is now loaded before the update starts.
25
+
26
+ ## 1.15.0
27
+
28
+ The first release on PyPI since 1.11.2. It also carries everything listed under 1.12.0 to 1.14.0 below, which were merged but never tagged.
29
+
30
+ - `monash uninstall` now revokes the Google Drive and Gmail authorisations of the default account and of every named profile before it deletes the data folder. It used to delete only the local token files, which left the grants active on the Google side. When revoking fails nothing is deleted, and it reminds you to delete the Ed token by hand.
31
+ - README (both languages): requirements, installation, first-time setup and everyday use now come first; per-release notes moved to one "Release notes" section near the end. The heading no longer names 1.11.2 as the current release.
32
+ - FAQ: added `monash: command not found`, a slow first sync, new units after a semester change, an invalid Ed token and removing everything.
33
+
34
+ ## 1.14.0
35
+
36
+ - Add local-only silent attendance SSO recovery (`attendance renew`) and session maintenance with explicit authentication status and a one-hour failure cooldown (`attendance maintain`). A replaced application-state file triggers an immediate recheck. Interactive credentials/MFA remain user-controlled, and IdP state is never exported.
37
+ - Serialize local persistent-profile use, preserve old application state on failed recovery, and stop reporting background authentication failures as successful keepalives.
38
+
39
+ ## 1.13.1
40
+
41
+ - Update optional attendance image processing to Pillow 13. Python 3.10 retains attendance record access but skips image OCR rather than installing vulnerable Pillow 12; image OCR requires Python 3.11+.
42
+
43
+ - Raise the pypdf minimum to 6.21.4 and refresh the lock to 7.1.0, removing known PDF resource-exhaustion advisories affecting the previous locked version.
44
+
45
+ - Add submission read paths to assignment gradebook entries, so marking review can continue directly to the submitted work.
46
+ - Keep complete cached submissions when a download is truncated, classify login-page responses as expired sessions, restrict redirected attachment authorities, and read collapsed online text only inside the submission region.
47
+ - Reject malformed MCP parameters with protocol errors and reject OAuth refresh scope changes without consuming valid refresh tokens. Remote clients now receive submission-reading guidance.
48
+ - Recover safely from malformed settings/status/update-cache JSON and bound the total extracted PowerPoint XML size.
49
+
50
+ ## 1.13.0
51
+
52
+ - Read the signed-in student's or group's submitted assignment attachments, online text and full marking feedback via assignment `read_path` → `read_file`, or `list_moodle_assignments(assignment_id=cmid)`. Add `monash moodle submission <cmid> [--json]` for the same detail.
53
+ - Read PDF, DOCX and PPTX members inside ZIP archives with the existing pagination options. Binary submissions return a private local file path; video transcription is not included.
54
+ - Recheck live assignment access and file membership on every read; keep submission caches outside the course library and exports, bound downloads to 256 MiB, and isolate cookies across redirects. Materials-only profiles cannot read submissions through either CLI or MCP.
55
+
56
+ ## 1.12.0
57
+
58
+ - Distinguish Moodle outages/rate limits from expired sessions, retry safe reads with bounded backoff, and attempt silent session recovery with shared cooldowns. Materials mode skips keepalive and recovery.
59
+ - Merge shared status under cross-process locks and use unique atomic temporary files for status, settings and credentials.
60
+ - Report partial syncs, preserve the last complete-success timestamp and add `monash sync --retry-failed` for failed activities, posts, Lessons and index entries.
61
+ - Mark old search results stale after failed re-extraction; report unreadable files and clear warnings after successful indexing.
62
+ - Track generated directory-export files in a manifest; remove obsolete untouched files while preserving user additions and edits.
63
+ - Add inclusive PDF page ranges and bounded extraction caching to the existing `read_file` MCP tool.
64
+ - Add local course-change history (`monash changes`, also in study todo): materials, assignment instructions, deadline times and teacher replies, with source links and baseline/retention limits.
65
+ - Support IANA timezones such as `Australia/Melbourne`, including daylight saving and Windows timezone data. Existing numeric offsets remain supported.
66
+
5
67
  ## 1.11.2
6
68
 
7
69
  - Windows PDF browser startup retries once with a fresh isolated profile after an early exit or a startup timeout; each failed process is killed if needed and reaped before retry. Partially written port files and transient connection failures are retried within the startup deadline. A final failure explains the Markdown fallback option.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: monash-study-kit
3
- Version: 1.11.2
3
+ Version: 1.16.0
4
4
  Summary: Connect Monash Moodle and Ed to Claude, Codex, Cursor or any local MCP client via a local MCP server and CLI: deadlines, announcements, grades, full-text search over course materials and Ed posts, all on your own machine.
5
5
  Project-URL: Homepage, https://github.com/Waldo0926/monash-study-kit
6
6
  Project-URL: Issues, https://github.com/Waldo0926/monash-study-kit/issues
@@ -20,9 +20,10 @@ Classifier: Programming Language :: Python :: 3.10
20
20
  Classifier: Programming Language :: Python :: 3.13
21
21
  Classifier: Topic :: Education
22
22
  Requires-Python: >=3.10
23
- Requires-Dist: pypdf>=4.0
23
+ Requires-Dist: pypdf>=6.21.4
24
+ Requires-Dist: tzdata; sys_platform == 'win32'
24
25
  Provides-Extra: attendance
25
- Requires-Dist: pillow<13,>=10; extra == 'attendance'
26
+ Requires-Dist: pillow<14,>=13; (python_version >= '3.11') and extra == 'attendance'
26
27
  Requires-Dist: playwright<2,>=1.49; extra == 'attendance'
27
28
  Requires-Dist: truststore<1,>=0.10; extra == 'attendance'
28
29
  Requires-Dist: tzdata; (sys_platform == 'win32') and extra == 'attendance'
@@ -63,99 +64,7 @@ All Moodle and Ed tools are **read-only**: they never submit assignments, attemp
63
64
 
64
65
  Built for Monash Malaysia (times are handled as UTC+8); Australian campuses work too, see the [FAQ](#faq).
65
66
 
66
- ![What monash todo prints: Moodle deadlines, a possibly missed assignment, Ed lessons not started, new course files, announcements and unread replies](docs/screenshots/todo.png)
67
-
68
- The picture is real output of `monash todo` against a database filled with made-up units, files and posts. Your AI app reads the same data through the MCP tools. Guide with more pictures: [docs.secureview.tech/study-kit](https://docs.secureview.tech/study-kit/).
69
-
70
- ---
71
-
72
- For the original v1.1 security review and the [1.5 feature review checklist](docs/SECURITY-REVIEW-1.5-SCOPE.md), see [security documentation](docs/security.md). The earlier review does not automatically certify features added later.
73
-
74
-
75
-
76
- ## Multiple accounts / course materials only (1.10.0)
77
-
78
- Without `--profile`, or with `--profile default`, the existing default account keeps its directory rules and features. Named accounts store separate databases, files, credentials and browser sessions under `<default data home>/profiles/<name>/`. The base still follows `MONASH_KIT_HOME` > `location.json` > the platform default. `default` is reserved; other names must match `[a-z0-9][a-z0-9_-]{0,31}`.
79
-
80
- ```bash
81
- monash --profile alice setup # login and course selection only
82
- monash --profile alice google login # optional; drive.readonly only
83
- monash --profile alice sync
84
- monash --profile=alice export FIT1045 --sync
85
- monash --profile alice mcp # local stdio, materials tools only
86
- monash profile list # manage from the default account
87
- monash profile remove alice # confirm, clear logins, keep materials
88
- monash profile remove alice --all --yes # also remove databases and materials
89
- ```
90
-
91
- `MONASH_KIT_PROFILE=alice` also works; the command-line selection wins. Selection happens before importing service modules; an initialized Python process cannot switch accounts. Named profiles ignore individual directory overrides (`MONASH_KIT_DATA`, `MONASH_KIT_SECRETS`, `MONASH_KIT_FILES`, `MONASH_KIT_ED_DATA`, `MONASH_KIT_ED_TOKEN`, `ED_TOKEN`, and `files_dir`) to avoid sharing the default account's paths or credentials. Directories use mode 700 where supported.
92
-
93
- Named profiles **stay local**: `remote`, `connect`, `setup claude`, and `move` are refused, and `setup` skips AI configuration. Sessions cannot be handed to remote services or AI configuration. Local stdio `mcp` can still be run manually. Profiles move together with the default data home rather than independently.
94
-
95
- Named profiles force `materials_only=true`, even if settings or environment variables request false. The default account starts with false and can enable it with `monash config materials_only true`. While the mode is active, config can inspect this setting but cannot change it. To exit on the default account, temporarily override `MONASH_KIT_MATERIALS_ONLY=false`, then save false; named profiles cannot use this override.
96
-
97
- Materials sync keeps Moodle files, Pages, Books, assignment descriptions and visible grading criteria, folders, linked Google files and Ed Lessons. It still reads Ed course lists to match unit codes, but never syncs discussions or replies. Gmail background sync, attendance reads and keepalive are skipped; Moodle login does not obtain a personal calendar link. `doctor --deep` checks materials and the search index only, skipping deadlines, submission status, grades and posts. Existing cached data is not deleted when enabling the mode.
98
-
99
- Complete command policy in materials mode (refused commands return exit code 1):
100
-
101
- - Allowed: `setup` (login and course selection), `login moodle/ed`, `google login/status/logout`, `sync`, `export`, `courses`, `status`, `doctor`, `open`, `library`, `config`, `grep`, `help`, `mcp`; `ed export/lessons/read/quiz`; `moodle ls/get`; `profile list/remove` from the default account.
102
- - Config cannot change active `materials_only`; named profiles cannot change `files_dir`. `moodle get` only accepts course-resource/file entry points, rejecting grade pages and submission files.
103
- - Refused: all `gmail` and `attendance` commands; `todo`, `due`, `semester`, `media`, `uninstall`, `update`, `connect`, `move`, all `remote`, `setup claude`; `ed courses/threads/search/show/new/following`; `moodle overview/due/calendar/assignments/grades/news/search/find/open/alerts/messages`. New commands require an explicit allowlist entry.
104
-
105
- The MCP tool list is exactly `list_files`, `read_file`, `search_content`, `get_ed_lessons`, `export_ed_lessons`; `use_ed=false` removes the last two. Other tools and their legacy aliases fail when called. Export writes a local zip without changing upstream course data and retains its local-write MCP annotation. Personal study prompts are unavailable. There is no arbitrary Drive browsing or search command/tool: Google exports only follow course links during sync.
106
-
107
- `profile list` checks only credential-file presence and disk usage, never reading or printing credential contents. Removal first revokes the target profile's Drive and Gmail Google OAuth authorizations in order. Any revocation failure stops removal and preserves **every local file** for a retry; an earlier successful remote revocation cannot be undone. Once all revocations succeed, `secrets/`, `browser-profile/` and `attendance-browser/` are removed. Only `--all` removes the complete profile, including materials and databases. The default account and other profiles are untouched; Moodle receives no logout or other request. Ed API tokens have no revocation interface here: manually delete them at [Ed API tokens](https://edstem.org/au/settings/api-tokens).
108
-
109
-
110
- ## 1.9.0: more complete course exports
111
-
112
- Moodle Pages, Book chapters, assignment descriptions and visible rubrics / marking guides are saved as Markdown. Moodle images are stored in course `assets/` by content hash, and internal links to Page, Resource, Folder and Book activities are followed. Folder downloads preserve original names, subdirectories and case, reuse files for seven days, and fall back to individual downloads. Missing notebook images, case mismatches, empty pages and hidden grading criteria are explained in the index.
113
-
114
- Ed Lessons document / code images hosted on `edusercontent.com` are cached locally, deduplicated by content and limited to 200 MB each. Failed images keep their original URL and an error record. Both Ed-only and whole-unit exports include `assets/` with working relative references.
115
-
116
- Google Slides and Docs export as PDF, Sheets as XLSX, and ordinary Drive files retain their format. Only file links found in Moodle and Ed Lessons are processed; Google Forms cannot be exported. Existing exports are reused while the file remains on disk. Successful file links disappear from generated link lists; failures retain their URL and a Chinese reason in the index.
117
-
118
- ```bash
119
- uv tool install --reinstall 'monash-study-kit[gmail]'
120
- monash google login # bundled desktop OAuth client
121
- monash google login --client client.json
122
- monash google status
123
- monash config google_docs_format docx # default: pdf; Google Docs only
124
- monash sync FIT1045 --refresh-google # force Google exports to refresh
125
- monash export FIT1045 --sync --json # sync this Moodle unit, then matching Ed units
126
- monash google logout # revoke first, then remove the local token
127
- ```
128
-
129
- The bundled OAuth client is published but not verified by Google: on first authorization Google shows “Google hasn't verified this app”; choose **Advanced → Go to Monash Student MCP (unsafe)** to continue. Google caps unverified apps at 100 users, and a school-managed account may be blocked by its admins (Google links then stay as links, with the reason in the index). Google classifies `drive.readonly` as a **restricted scope**. It permits reading Drive files; this tool only downloads files linked from courses and does not enumerate your Drive. Google authorization shares the optional `[gmail]` dependency, but uses an independent flow and `secrets/google-drive-token.json` under the data home (`MONASH_KIT_SECRETS` can override the directory). Gmail authorization and `gmail-token.json` are unchanged. Credentials stay in the terminal / browser authorization flow; never paste them into chat.
130
-
131
- Downloads use read-only GET requests. For Drive export-size or administrator restrictions, a fallback tries the existing Google session in the dedicated login browser. Cookies are used only in memory, never logged or separately saved, and redirects outside Google's domains stop. The fallback may still be blocked by policy; failures keep the original link and explain why. Missing authorization points to `monash google login`. Moodle Page, Resource and assignment `view.php` requests still record a view. Normal folder downloads and Book print requests avoid their `view.php`; the individual-file fallback must open the folder page and records a view.
132
-
133
- `monash export <unit>` now exports Markdown body pages, link lists, quizzes and the index as **PDF by default**, alongside the original course files. Install Chrome, Edge or Brave to generate PDFs; if no browser is found, the export falls back to Markdown and explains this in the index and terminal. Use `--format both` to include PDF and Markdown, or `--format md` for Markdown only. For example, `monash config export_format both` saves PDF and Markdown as the default. Synced Markdown stays unchanged on your computer for AI, search and MCP. PDF generation runs offline in a fresh temporary browser profile, embeds only local exported images and omits remote images (keeping their alt text). PDFs are cached under `data/pdf-cache/` (up to 500 MB); `--json` includes `pdf.generated`, `pdf.cached` and `pdf.skipped_reason`. `monash ed export` keeps its existing behavior.
134
-
135
- Every sync checks newly discovered Ed units against tracked Moodle unit codes, including archived units and combined codes such as `FIT1045/FIT1053`; later user tracking choices are preserved. `monash export <unit> --sync` refreshes Moodle first, then the matching Ed Lessons (not forum threads), before exporting; `--refresh-google` also re-exports Google files. Run in a terminal, `monash export` first opens the system folder picker to choose where to save (defaulting to your last choice, else Downloads) and then starts; `--to <folder>` or `--no-ask` skip the dialog. It prints the destination and PDF progress as it goes. Ordinary exports use only local data. The README index includes all omission notes and failed Ed images, plus counts of link lists, remote Markdown images, Google links, successful exports and failures grouped by reason; `--json` exposes the same counts in `statistics`.
136
-
137
- New tests use synthetic HTML / JSON, fake clients and mocked HTTP, with no real account requests. Ed code-challenge workspace downloads still require a real read-only response to establish the interface and are excluded, as are multi-account profiles.
138
-
139
-
140
- ## Two parts, one codebase
141
-
142
- The same core (login, sync, queries) serves two kinds of "users":
143
-
144
- **MCP: the interface for your AI app.** Moodle and Ed both sit behind Okta + MFA, so the AI cannot get in by itself.
145
- The MCP server lets it look things up mid-conversation (tools such as `get_study_todo`, `search_content`, `list_ed_updates`):
146
-
147
- - **Answers come from real data**: deadlines, announcements and grades are fetched live, with sources such as "Workshop 5 Slides, page 25".
148
- - **Both platforms at once**: one "what do I need to do this week" checks Moodle deadlines, unfinished Ed lessons and announcements from both.
149
- - **No manual copying**: no downloading PDFs and re-uploading them. The AI finds the right file and reads only the pages it needs, saving time and usage.
150
- - **Natural follow-ups**: "What does the A2 spec require?" "Explain that week's functor material using the lecture notes."
151
-
152
- **CLI (the `monash` command): the interface for humans.**
153
-
154
- 1. **Things only a person can do**: installation, passing MFA in the login window, pasting the Ed token (tokens should never go through a chat, so they are only entered in the terminal).
155
- 2. **No AI needed**: out of usage or just want a quick look? `monash todo` answers in a second (see [Works without AI usage](#works-without-ai-usage)).
156
- 3. **Troubleshooting and maintenance**: `status`, `sync`, `update`, `uninstall`.
157
-
158
- In short: MCP turns your AI app into a TA who knows your units; the CLI handles setup, login and fallback. Ask in your AI app day to day, open the terminal occasionally.
67
+ **New here?** [Install](#installation) · [First-time setup](#first-time-setup-monash-setup) · [Everyday use](#everyday-use) · [FAQ](#faq)
159
68
 
160
69
  ## Requirements
161
70
 
@@ -165,7 +74,15 @@ In short: MCP turns your AI app into a TA who knows your units; the CLI handles
165
74
 
166
75
  ## Installation
167
76
 
168
- The quickest way is one command, which installs `uv`, the kit and then starts `monash setup` (you can [read the scripts](https://docs.secureview.tech/study-kit/install/) first):
77
+ **Easiest: let your AI do it.** If your AI app can run commands (Claude Code, Codex, Cursor's agent, Gemini CLI), paste this line and it installs everything:
78
+
79
+ ```text
80
+ Read https://docs.secureview.tech/agents/study-kit.md and set up Monash Study Kit on my computer.
81
+ ```
82
+
83
+ You only paste your Ed token and pass Monash MFA yourself, in your own terminal. The AI tells you when. More on this: [let your AI set it up](https://docs.secureview.tech/ai-setup/).
84
+
85
+ Otherwise it is one command, which installs `uv`, the kit and then starts `monash setup` (you can [read the scripts](https://docs.secureview.tech/study-kit/install/) first):
169
86
 
170
87
  ```bash
171
88
  # macOS, in Terminal
@@ -236,36 +153,6 @@ At the end you can choose to sync right away. The first sync downloads all cours
236
153
 
237
154
  Then open your AI app. In Claude Desktop, **"+" → Connectors** in the chat box lists **monash**; leave it switched on. For other apps, `monash connect` shows which ones are connected.
238
155
 
239
- ## What's new in 1.7
240
-
241
- - **Download a whole unit's Ed materials as one zip.** `monash ed export FIT2109` packs the Ed Lessons you have synced into a zip in your Downloads folder: one folder per week with the PDFs, text pages and attachments, a `Links.md` per lesson (reading pages and the original Ed page) and a top-level `README.md` with your progress. `--module "Week 3"` packs one week, `--open` shows the zip in Finder. You can also ask your AI app "zip up my FIT2109 Ed materials", or use the button next to each unit on the `monash library --open` page. It works offline from files already on your computer.
242
- - **Ed files are stored by unit code.** Folders change from numeric ids to `FIT2109/03 Week 3 - Editor-Modern IDE/12 W3 Workshop/01 Workshop 3 Slides.pdf`, in the same order as on Ed. `monash open ed` opens them. The first sync after upgrading moves existing files instead of downloading them again.
243
- - **Files attached inside Ed pages are downloaded too.** Starter-code zips, handouts and other files that Ed hosts inside a lesson page are now downloaded and searchable; single files over 200 MB are skipped. A replaced PDF is downloaded again, and pages removed on Ed are removed locally.
244
- - **The AI sees Ed files when listing materials.** "What materials are there for FIT2109 week 3?" now lists Ed Lessons files through `list_files`, ready to read.
245
-
246
- ## What's new in 1.6
247
-
248
- - **Semester week view.** `monash semester --days 7` puts Moodle deadlines, Ed lessons and replies and cached attendance in one view; `--ics` exports the deadlines as a private calendar file.
249
-
250
- ## What's new in 1.5
251
-
252
- - **School mail (optional).** Ask "anything in my email I need to deal with?" and get recent unread school mail, offline search, whole threads and attachment text. The AI can draft a reply, send a draft or archive mail, and only after you confirm each action.
253
- - **Attendance (optional).** "Which classes this week haven't I checked in to?" and "what's the code for today's workshop?", with each code's source. Reads follow your timetable and take a few seconds without opening a browser. Checked against the Malaysia campus portal.
254
- - **No terminal needed to connect them.** Say "connect my school email" or "connect my attendance" in your AI app; it installs what is missing and opens the sign-in window. No Google Cloud setup either.
255
- - **Remote apps choose.** With `monash remote`, each app you pair ticks which of these it may use.
256
- - **Units without Ed** can turn Ed off: `monash config use_ed false`.
257
-
258
- Details: [Optional: Gmail and attendance](#optional-gmail-and-attendance) and the [changelog](CHANGELOG.md).
259
-
260
- ## What's new in 1.4
261
-
262
- - **Study panels.** In apps that support MCP Apps, "what do I need to do this week", "show my FIT2109 lesson progress" and "help me practise the week 3 quiz" also come with a small panel: deadline cards, lesson progress by module, and quiz questions you can click through. When you finish a quiz, the **交给 AI 批改** button sends your choices back to the chat and the AI explains them from the lesson. Nothing is submitted to Ed. Apps without panels still get the same text answers as before.
263
- - **Find a Moodle activity by name.** "Where is the week 7 workshop on Moodle?" now works through the new `search_moodle_activities` tool. It needs a Moodle login.
264
- - **Browse your files without AI.** `monash library --open` opens a page in your browser with every Moodle and Ed lesson file you have synced. Filter by unit, week or name and download the original. It only listens on `127.0.0.1`, so other devices cannot open it.
265
- - **Optional remote access.** `monash remote serve` lets ChatGPT, or Claude on the web and phone, reach your own data over HTTPS. Use your own server and domain, or try it with a free Cloudflare quick tunnel on your own computer, which needs no account and no domain. Each app pairs with a one-time code from your terminal, and only the 16 read-only query tools are exposed. Nothing starts unless you run it. Steps are on [Host it yourself](https://docs.secureview.tech/study-kit/remote/).
266
-
267
- 1.4.1 adds `library` and `remote` to the summary at the top of `monash --help`. Everyday use on your own computer still needs no server, domain or extra account. Technical notes: [docs/panels-library-remote.md](docs/panels-library-remote.md).
268
-
269
156
  ## Everyday use
270
157
 
271
158
  Just ask in your AI app. While it is open, the tool works in the background:
@@ -294,6 +181,55 @@ monash login
294
181
 
295
182
  While the login is expired, **deadlines still work** (they come from Moodle's calendar subscription link, which needs no login), and Ed features are unaffected.
296
183
 
184
+ ### Choose what gets downloaded
185
+
186
+ `monash sync` downloads every file your units put on Moodle, with two exceptions:
187
+
188
+ - **Videos** uploaded to Moodle are saved as links. To download them: `monash config download_videos true`
189
+ - **Files over 300 MB**, such as a large dataset, are saved as links with their size. Change the limit with `monash config max_file_mb 100`, or set `0` for no limit
190
+
191
+ You can also leave out whole kinds of files:
192
+
193
+ ```bash
194
+ monash config skip_types audio,images
195
+ ```
196
+
197
+ Kinds: `pdf`, `slides`, `docs`, `sheets`, `archives`, `images`, `audio`, `code`. Set it back with `monash config skip_types ""`.
198
+
199
+ To change this for one sync only, without touching your settings:
200
+
201
+ ```bash
202
+ monash sync --videos # this time, download videos too
203
+ monash sync --max-mb 50 --skip-types archives
204
+ ```
205
+
206
+ Videos are recognised by their file name and also by the file type Moodle reports, so a recording whose address has no `.mp4` is still caught. The same rules apply to the files inside a Moodle folder. Files you already have are never deleted when you change these settings.
207
+
208
+ **See what was skipped and get it.** After `monash sync` you get a short list of the files skipped this time. Skipped files also show up as links in each week's `links.md`, and a whole-unit export lists them as not exported. To see all of them with a number:
209
+
210
+ ```bash
211
+ monash skipped # add a unit code for one unit, --videos to list videos too
212
+ ```
213
+
214
+ Each file gets a number, for example `[3] Week 05/Dataset.csv (too big, 512 MB)`. Then get what you need:
215
+
216
+ - **A few files**: `monash skipped --get 3 7`. Part of the file name also works (`monash skipped --get dataset`), and `all` gets every one. These ignore the size limit and the kinds you left out
217
+ - **Many files**: raise the limit and sync again, for example `monash sync --max-mb 2000` or `monash config max_file_mb 0`. Files you already have are not downloaded again, only the skipped ones are
218
+
219
+ In your AI app you can also ask "which files weren't downloaded?" and then say which ones you want; it downloads them in the background. Before a big download it checks there is enough free disk space.
220
+
221
+ ### When a sync only partly works
222
+
223
+ `monash status` says whether the last sync was complete or partial. `monash sync --retry-failed` retries only what failed. `monash changes --days 7` shows what changed in your units since you started syncing: new or replaced files, assignment instructions, deadline times and staff replies on Ed. Everything stays on your computer. When the Moodle login expires, the kit tries to sign back in quietly with its own browser profile and never opens an MFA window in the background; `monash config auto_relogin false` turns that off. If the AI app is syncing in the background, `monash sync FIT2102`, `monash export --sync` and `monash skipped --get` say so and ask you to try again when it's done, so two syncs never write the same folder. Details: [docs/reliability.md](docs/reliability.md).
224
+
225
+ ### Check your work against the marking feedback
226
+
227
+ Ask your AI app something like "read what I submitted for A2 and go through the marking comments one by one". It finds the assignment with `list_moodle_assignments`, then reads its `read_path` with `read_file`: the files you or your group submitted, the online text and the full feedback you can see on Moodle. In a terminal: `monash moodle submission <cmid>`, where cmid is the activity ID from `monash moodle assignments`, not the unit ID.
228
+
229
+ - PDFs can be read page by page, and files inside a ZIP (text, code, PDF, Word, PowerPoint) can be read too
230
+ - Submissions are downloaded with your own Moodle login and kept apart in `data/submissions/`, so they never go into the course library, search or exports. Access is checked again on every read and each download is capped at 256 MiB
231
+ - Materials-only profiles can't read submissions. Videos aren't transcribed and scanned PDFs still need OCR
232
+
297
233
  ### Works without AI usage
298
234
 
299
235
  The CLI doesn't use AI and consumes no usage. Run `monash sync` first, then:
@@ -311,8 +247,125 @@ The CLI doesn't use AI and consumes no usage. Run `monash sync` first, then:
311
247
  The difference is that nobody summarises for you; you get the raw information. Background sync and Moodle session refresh run while your AI app is open, because that is when the MCP server runs:
312
248
  they keep running even if your usage is exhausted; if the app is closed, run `monash sync` before querying and `monash login` if Moodle has expired.
313
249
 
250
+ ## Two parts, one codebase
251
+
252
+ The same core (login, sync, queries) serves two kinds of "users":
253
+
254
+ **MCP: the interface for your AI app.** Moodle and Ed both sit behind Okta + MFA, so the AI cannot get in by itself.
255
+ The MCP server lets it look things up mid-conversation (tools such as `get_study_todo`, `search_content`, `list_ed_updates`):
256
+
257
+ - **Answers come from real data**: deadlines, announcements and grades are fetched live, with sources such as "Workshop 5 Slides, page 25".
258
+ - **Both platforms at once**: one "what do I need to do this week" checks Moodle deadlines, unfinished Ed lessons and announcements from both.
259
+ - **No manual copying**: no downloading PDFs and re-uploading them. The AI finds the right file and reads only the pages it needs, saving time and usage.
260
+ - **Natural follow-ups**: "What does the A2 spec require?" "Explain that week's functor material using the lecture notes."
261
+
262
+ **CLI (the `monash` command): the interface for humans.**
263
+
264
+ 1. **Things only a person can do**: installation, passing MFA in the login window, pasting the Ed token (tokens should never go through a chat, so they are only entered in the terminal).
265
+ 2. **No AI needed**: out of usage or just want a quick look? `monash todo` answers in a second (see [Works without AI usage](#works-without-ai-usage)).
266
+ 3. **Troubleshooting and maintenance**: `status`, `sync`, `update`, `uninstall`.
267
+
268
+ In short: MCP turns your AI app into a TA who knows your units; the CLI handles setup, login and fallback. Ask in your AI app day to day, open the terminal occasionally.
269
+
270
+ ## Export a whole unit's materials
271
+
272
+ Export course materials without an AI app. Install or upgrade, sign in and select your units, then run:
273
+
274
+ ```bash
275
+ uv tool install --upgrade 'monash-study-kit[gmail]'
276
+ monash setup
277
+ monash google login # only for course-linked Google files; separate read-only consent
278
+ monash export FIT1043 --sync --format both --to "./exports"
279
+ ```
280
+
281
+ Replace `FIT1043` with your unit code. Packages include Moodle files, Pages, Books, assignment instructions and visible marking guides, Ed Lessons and accessible Google files; personal submissions, grades, mail and attendance are excluded. The `README` inside the package lists anything left out and why.
282
+
283
+ - **Where it goes**: in a terminal `monash export` first asks for a folder (your last choice, else Downloads). `--to <folder>` or `--no-ask` skips the question
284
+ - **PDF or Markdown**: pages, link lists, quizzes and the index come out as PDF by default, next to the original files. PDFs need Chrome, Edge or Brave; without one it falls back to Markdown and says so. `--format both` gives both, `--format md` Markdown only, and `monash config export_format both` makes that the default. Your synced Markdown stays as it is for the AI and search
285
+ - **Up to date**: `--sync` syncs this unit on Moodle and its Ed Lessons first. Without it the export only uses what is already on your computer
286
+ - **Google files** linked from Moodle or Ed Lessons: run `monash google login` once. Slides and Docs come out as PDF (`monash config google_docs_format docx` for Word), Sheets as XLSX, other Drive files as they are; Google Forms can't be exported. Google shows "this app isn't verified" the first time: choose Advanced, then continue. A school-managed account may be blocked by its admins, and then the links stay links with the reason in the index. Only files your units link to are downloaded, never the rest of your Drive. `monash sync FIT1043 --refresh-google` exports them again, `monash google logout` revokes access
287
+
288
+ ![Actual 1.11.2 offline export and ZIP contents using synthetic course data](docs/screenshots/course-export.png)
289
+
290
+ This screenshot comes from a real `monash export` run against synthetic local data, deliberately including a missing attachment and an unauthorized Google link to demonstrate omissions. No real account or course content is used. Omit `--sync` to export existing local data; sync and export again to retry missing materials. See the [whole-course export guide](https://docs.secureview.tech/study-kit/materials/).
291
+
292
+ ![What monash todo prints: Moodle deadlines, a possibly missed assignment, Ed lessons not started, new course files, announcements and unread replies](docs/screenshots/todo.png)
293
+
294
+ The picture is real output of `monash todo` against a database filled with made-up units, files and posts. Your AI app reads the same data through the MCP tools. Guide with more pictures: [docs.secureview.tech/study-kit](https://docs.secureview.tech/study-kit/).
295
+
296
+ ---
297
+
298
+ For the original v1.1 security review and the [1.5 feature review checklist](docs/SECURITY-REVIEW-1.5-SCOPE.md), see [security documentation](docs/security.md). The earlier review does not automatically certify features added later.
299
+
300
+ ## Optional: Gmail and attendance
301
+
302
+ New in 1.5.0. Both parts are off until you connect them and only run on your own computer.
303
+
304
+ - **School Gmail.** Keeps a private copy of your Monash mailbox. Ask "anything in my email I need to deal with?" and the AI lists recent unread school mail (promotions and social updates left out), searches it offline, reads whole threads and the text of attachments (PDF, Office, images). Reading never marks mail as read.
305
+ - **Attendance.** Reads your classes and check-in status from the attendance portal, so you can ask "which classes this week haven't I checked in to?" or "what's the code for today's FIT2102 workshop?". Codes are looked up in synced Moodle, Ed and school mail and shown with where they came from, for you to check. Only checked against the Malaysia campus portal.
306
+
307
+ If you only want to ask about your inbox in Claude or ChatGPT, their built-in Gmail connectors are the easiest way. The Gmail part here is for linking mail with attendance codes, searching mail and attachments offline, and using it in apps without a Gmail connector such as Codex or Cursor. No Google Cloud setup is needed: the package includes a Google app, and Google will show "this app isn't verified" (click Advanced, then continue). Using your own Google app instead is optional. The step-by-step guide (in Chinese) is [docs/google-and-attendance-setup.md](docs/google-and-attendance-setup.md); what is accessed and stored is in [PRIVACY.md](PRIVACY.md). The easiest way is to ask your AI app: "connect my school email" or "connect my attendance". It installs what is missing, opens the sign-in window on your computer, and you only sign in; nothing is typed in a terminal and no password goes into the chat. The same steps in a terminal:
308
+
309
+ ```bash
310
+ uv tool install --reinstall "monash-study-kit[gmail,attendance]"
311
+ monash gmail login
312
+ monash gmail sync
313
+ monash attendance login
314
+ monash attendance sync
315
+ ```
316
+
317
+ Restart your AI app after logging in. While it is open, mail syncs in the background every 30 minutes (`monash config gmail_sync_minutes`, 0 turns it off); `monash gmail sync` updates it right away. Attendance follows your timetable instead of the clock: once on weekday mornings at 8 and 15 minutes after each class you have not checked in to yet, so nothing runs at night, at weekends or between classes (`monash config attendance_auto_sync false` turns it off). You or the AI can also ask for a read any time. A read is one plain request to the portal (about 5 KB, a few seconds, no browser); if the page ever looks different from what is expected it falls back to one headless browser page. On the Malaysia portal both ways gave the same result for all 15 days the portal offers, and `monash attendance probe` repeats that check on yours. `monash status` and `monash doctor` show both parts once they are on, and `monash update` keeps the extras you installed.
318
+
319
+ Logging in turns everything on in your AI app, including drafting, sending a draft, changing labels (archive, mark as read, star) and checking in to a class. The AI has to show you the full preview first and only runs it after you confirm that exact action; a check-in is only prepared when you say you attended. Mail is never permanently deleted. To keep mail read-only, log in with `monash gmail login --read-only`; to switch an action off, `monash config gmail_manage_enabled false` or `monash config attendance_submit_enabled false`.
320
+
321
+ With `monash remote serve`, each app you pair chooses on the pairing page which of these features it may use. Only features turned on on the server are offered, read-only ones start ticked and the write ones start unticked. So Claude on your phone can have attendance only and ChatGPT mail only, or neither. Apps paired earlier keep Moodle and Ed only until you pair them again, and `monash remote clients` shows what each app has.
322
+
323
+ Each part adds tool descriptions to every conversation: with both logged in it is about 1,900 tokens more (5,132 in total instead of 3,232); without logging in nothing changes.
324
+
325
+ **If the attendance login expires**, `monash attendance maintain` checks it and, when it can, signs back in with the browser profile already on this computer. When Monash wants your password or MFA it reports `needs_login` and you run `monash attendance login` yourself. After a failed try it waits an hour before trying again. `monash attendance renew --timeout 30` tries once by hand. The kit never types your password or MFA, and it can't keep you signed in while the computer is asleep or offline. Reading codes from images needs Python 3.11 or newer.
326
+
327
+ Not verified yet: attendance submission, how long the attendance login lasts, and portals of campuses other than Malaysia.
328
+
329
+ ## Multiple accounts / course materials only
330
+
331
+ A named profile is a separate account with its own login, files, database and browser session, kept in `profiles/<name>/` inside the data folder. It's useful if you have a second Monash account, or want a copy that only holds course materials. Running `monash` without `--profile` uses your normal account as before. Profile names use lowercase letters, numbers, `-` and `_`, and `default` is taken.
332
+
333
+ ```bash
334
+ monash --profile alice setup # sign in and pick units
335
+ monash --profile alice google login # optional, Drive read-only
336
+ monash --profile alice sync
337
+ monash --profile alice export FIT1045 --sync
338
+ monash --profile alice mcp # local MCP with the materials tools only
339
+ monash profile list # run these two from your normal account
340
+ monash profile remove alice # signs out, keeps the files
341
+ monash profile remove alice --all --yes # also deletes files and databases
342
+ ```
343
+
344
+ `MONASH_KIT_PROFILE=alice` works too; `--profile` wins if both are set.
345
+
346
+ **A named profile only handles course materials.** It syncs Moodle files, Pages, Books, assignment instructions and visible marking guides, folders, linked Google files and Ed Lessons. It doesn't sync Ed discussions, mail or attendance, and it doesn't read your deadlines, grades or submissions. It stays on this computer: `remote`, `connect`, `setup claude` and `move` are refused, and setup doesn't add it to your AI apps. It also ignores the `MONASH_KIT_DATA`, `MONASH_KIT_SECRETS`, `MONASH_KIT_FILES`, `MONASH_KIT_ED_DATA`, `MONASH_KIT_ED_TOKEN`, `ED_TOKEN` and `files_dir` overrides, so it can't end up using your normal account's folders or tokens.
347
+
348
+ Your normal account can switch to the same mode with `monash config materials_only true`. To switch back, run once with `MONASH_KIT_MATERIALS_ONLY=false` and save `false`. Data you already synced is kept.
349
+
350
+ **Removing a profile** first revokes its Google Drive and Gmail access. If revoking fails, nothing is deleted so you can try again. After that it deletes the logins (`secrets/`, `browser-profile/`, `attendance-browser/`) and keeps the downloaded files unless you add `--all`. Nothing is sent to Moodle. Ed has no way to revoke a token from here, so delete it on [Ed's API token page](https://edstem.org/au/settings/api-tokens).
351
+
352
+ <details>
353
+ <summary>Exactly which commands and tools work in materials mode</summary>
354
+
355
+ Refused commands exit with code 1.
356
+
357
+ - Allowed: `setup` (sign in and pick units), `login moodle/ed`, `google login/status/logout`, `sync`, `export`, `courses`, `status`, `doctor`, `open`, `library`, `config`, `grep`, `help`, `mcp`, `changes`, `skipped`; `ed export/lessons/read/quiz`; `moodle ls/get`; `profile list/remove` from the normal account
358
+ - `config` can't change `materials_only` while the mode is on, and a named profile can't change `files_dir`. `moodle get` only takes course files, not grade pages or submissions
359
+ - Refused: all `gmail` and `attendance` commands; `todo`, `due`, `semester`, `media`, `uninstall`, `update`, `connect`, `move`, all `remote`, `setup claude`; `ed courses/threads/search/show/new/following`; `moodle overview/due/calendar/assignments/grades/news/search/find/open/alerts/messages`. A new command is refused until it is added to the list
360
+ - MCP tools: only `list_files`, `read_file`, `search_content`, `get_ed_lessons` and `export_ed_lessons` (the last two are gone with `use_ed=false`). Other tools return an error. There is no tool to browse or search your Drive
361
+ - `doctor --deep` only checks materials and the search index
362
+
363
+ </details>
364
+
314
365
  ## Other AI clients
315
366
 
367
+ **ChatGPT:** normal ChatGPT chat (web, desktop app and phone) reaches Study Kit from OpenAI's servers, so it needs [remote mode](https://docs.secureview.tech/study-kit/remote/): an HTTPS address added as an app in developer mode, which needs a paid plan. Add it once and it works on all three. Codex inside the ChatGPT desktop app is different: it runs on your computer and shares `~/.codex/config.toml`, so `monash connect codex` is enough; type `/mcp` in a new Codex chat to check. Step by step: [Use it with ChatGPT](https://docs.secureview.tech/study-kit/chatgpt/).
368
+
316
369
  MCP is an open protocol and `monash mcp` is a standard local (stdio) MCP server, so any client that supports local MCP servers should in principle work.
317
370
  `monash setup` configures Claude Desktop and Claude Code. For the others, run `monash setup` first (login and units), then one command:
318
371
 
@@ -344,7 +397,7 @@ Replace `/full/path/monash` in the examples with your path. **In JSON, Windows b
344
397
  | Windsurf | `~/.codeium/windsurf/mcp_config.json` | Untested |
345
398
  | VS Code (Copilot) | Command Palette → `MCP: Open User Configuration` | Untested |
346
399
  | Gemini CLI | `~/.gemini/settings.json` | Untested |
347
- | ChatGPT, Claude web / mobile app | `monash remote serve` behind your own domain or a Cloudflare quick tunnel | ChatGPT Plus works with the author's domain; see [Host it yourself](https://docs.secureview.tech/study-kit/remote/) |
400
+ | ChatGPT, Claude web / mobile app | `monash remote serve` with a free Cloudflare quick tunnel, a Cloudflare tunnel with a fixed address, or your own server | ChatGPT Plus works with the author's domain; see [Remote mode](https://docs.secureview.tech/study-kit/remote/) |
348
401
 
349
402
  Codex (`~/.codex/config.toml`), or simply run `codex mcp add monash -- /full/path/monash mcp`:
350
403
 
@@ -473,13 +526,17 @@ You can also query directly in the terminal without any AI:
473
526
  | `monash doctor --deep` | Also fetches from Moodle and Ed and cross-checks the tools against a second source: due dates against the calendar feed, the assignment page against the course structure, synced files against Moodle, search against the files on disk, local Ed posts against Ed. Prints only counts, unit codes, dates and activity ids |
474
527
  | `monash todo` | This week: deadlines, possibly missed work, unfinished Ed lessons, announcements, unread replies |
475
528
  | `monash due [FIT2102]` | Deadlines |
529
+ | `monash changes [--days 7]` | What changed in your units: files, assignment instructions, deadline times, staff replies |
476
530
  | `monash grep "monad" [FIT2102]` | Full-text search over course files, course-notes sites, Ed lesson pages and recording transcripts (with page numbers / timestamps) |
477
- | `monash sync` | Sync now |
531
+ | `monash sync [--retry-failed]` | Sync now; `--retry-failed` retries only what failed last time |
532
+ | `monash sync --videos` / `--max-mb N` / `--skip-types a,b` | One sync with different download choices, see [Choose what gets downloaded](#choose-what-gets-downloaded) |
533
+ | `monash skipped [FIT2102] [--get 3 7\|all] [--videos]` | Files left out by the size limit, kinds or videos setting; `--get` downloads the ones you pick |
478
534
  | `monash login` / `monash login ed` | Log in to Moodle / replace the Ed token |
479
535
  | `monash courses` | Re-pick tracked units |
480
536
  | `monash open [ed]` | Open the course-files folder (`ed`: Ed Lessons files) |
481
537
  | `monash library [--open]` | Browse and download synced files in your browser (only on this computer) |
482
538
  | `monash moodle grades [FIT2102]` | Grades and feedback |
539
+ | `monash moodle submission <cmid>` | What you or your group submitted for one assignment, with the full marking feedback |
483
540
  | `monash moodle assignments --missing` | Possibly missed assignments |
484
541
  | `monash moodle news` / `find` / `get` / `messages` / `calendar` | Announcements / find an activity / download one file / messages / calendar subscription link |
485
542
  | `monash ed new` / `following` / `search` / `show FIT2102#42` | Ed updates / new replies to my posts / search / read a post |
@@ -492,6 +549,7 @@ You can also query directly in the terminal without any AI:
492
549
  | `monash remote serve` / `pair` / `clients` / `revoke` | Optional remote MCP for ChatGPT and Claude on the web ([Host it yourself](https://docs.secureview.tech/study-kit/remote/)) |
493
550
  | `monash gmail todo` / `sync` / `search` / `thread` | Optional school Gmail: unread inbox mail / sync / offline search / read a thread ([setup](#optional-gmail-and-attendance)) |
494
551
  | `monash attendance login` / `status` / `sync` / `overview` / `codes` | Optional attendance: log in / status / read the portal / saved classes / find check-in codes |
552
+ | `monash attendance renew` / `maintain` | Try to bring back an expired attendance login with the browser profile already on this computer; stops when a password or MFA is needed |
495
553
  | `monash update` | Update to the latest version |
496
554
 
497
555
  Add `--json` for JSON output (output is JSON automatically when piped; `--text` forces text). Every command has `--help`.
@@ -518,34 +576,7 @@ Then run it manually when needed (it never runs in the background, so it won't s
518
576
  monash media
519
577
  ```
520
578
 
521
- Videos uploaded directly to Moodle aren't downloaded by default either (often hundreds of MB); they are recorded as links. To download them: `monash config download_videos true`.
522
-
523
- ## Optional: Gmail and attendance
524
-
525
- New in 1.5.0. Both parts are off until you connect them and only run on your own computer.
526
-
527
- - **School Gmail.** Keeps a private copy of your Monash mailbox. Ask "anything in my email I need to deal with?" and the AI lists recent unread school mail (promotions and social updates left out), searches it offline, reads whole threads and the text of attachments (PDF, Office, images). Reading never marks mail as read.
528
- - **Attendance.** Reads your classes and check-in status from the attendance portal, so you can ask "which classes this week haven't I checked in to?" or "what's the code for today's FIT2102 workshop?". Codes are looked up in synced Moodle, Ed and school mail and shown with where they came from, for you to check. Only checked against the Malaysia campus portal.
529
-
530
- If you only want to ask about your inbox in Claude or ChatGPT, their built-in Gmail connectors are the easiest way. The Gmail part here is for linking mail with attendance codes, searching mail and attachments offline, and using it in apps without a Gmail connector such as Codex or Cursor. No Google Cloud setup is needed: the package includes a Google app, and Google will show "this app isn't verified" (click Advanced, then continue). Using your own Google app instead is optional. The step-by-step guide (in Chinese) is [docs/google-and-attendance-setup.md](docs/google-and-attendance-setup.md); what is accessed and stored is in [PRIVACY.md](PRIVACY.md). The easiest way is to ask your AI app: "connect my school email" or "connect my attendance". It installs what is missing, opens the sign-in window on your computer, and you only sign in; nothing is typed in a terminal and no password goes into the chat. The same steps in a terminal:
531
-
532
- ```bash
533
- uv tool install --reinstall "monash-study-kit[gmail,attendance]"
534
- monash gmail login
535
- monash gmail sync
536
- monash attendance login
537
- monash attendance sync
538
- ```
539
-
540
- Restart your AI app after logging in. While it is open, mail syncs in the background every 30 minutes (`monash config gmail_sync_minutes`, 0 turns it off); `monash gmail sync` updates it right away. Attendance follows your timetable instead of the clock: once on weekday mornings at 8 and 15 minutes after each class you have not checked in to yet, so nothing runs at night, at weekends or between classes (`monash config attendance_auto_sync false` turns it off). You or the AI can also ask for a read any time. A read is one plain request to the portal (about 5 KB, a few seconds, no browser); if the page ever looks different from what is expected it falls back to one headless browser page. On the Malaysia portal both ways gave the same result for all 15 days the portal offers, and `monash attendance probe` repeats that check on yours. `monash status` and `monash doctor` show both parts once they are on, and `monash update` keeps the extras you installed.
541
-
542
- Logging in turns everything on in your AI app, including drafting, sending a draft, changing labels (archive, mark as read, star) and checking in to a class. The AI has to show you the full preview first and only runs it after you confirm that exact action; a check-in is only prepared when you say you attended. Mail is never permanently deleted. To keep mail read-only, log in with `monash gmail login --read-only`; to switch an action off, `monash config gmail_manage_enabled false` or `monash config attendance_submit_enabled false`.
543
-
544
- With `monash remote serve`, each app you pair chooses on the pairing page which of these features it may use. Only features turned on on the server are offered, read-only ones start ticked and the write ones start unticked. So Claude on your phone can have attendance only and ChatGPT mail only, or neither. Apps paired earlier keep Moodle and Ed only until you pair them again, and `monash remote clients` shows what each app has.
545
-
546
- Each part adds tool descriptions to every conversation: with both logged in it is about 1,900 tokens more (5,132 in total instead of 3,232); without logging in nothing changes.
547
-
548
- Not verified yet: attendance submission, how long the attendance login lasts, and portals of campuses other than Malaysia.
579
+ Videos uploaded directly to Moodle aren't downloaded by default either (often hundreds of MB); they are recorded as links. See [Choose what gets downloaded](#choose-what-gets-downloaded).
549
580
 
550
581
  ## Updating
551
582
 
@@ -587,7 +618,7 @@ That's fine: deadlines, grades, course files, search, mail and attendance work w
587
618
 
588
619
  ### Australian campuses
589
620
 
590
- Moodle shows times in your account's time zone; the default is Malaysia (UTC+8). For Australian campuses: `monash config tz_offset 10` (11 during daylight saving).
621
+ Moodle shows times in your account's time zone; the default is Malaysia (UTC+8). For Australian campuses: `monash config timezone Australia/Melbourne`, which also follows daylight saving. The old `monash config tz_offset 10` still works but does not change with daylight saving.
591
622
 
592
623
  ### Where are Ed "assignment deadlines"?
593
624
 
@@ -599,6 +630,42 @@ Most Ed lessons have no due date; Moodle is the source of truth for deadlines. T
599
630
  Run `monash doctor` and follow the → after each item. If you need help, send the whole output; it contains no tokens, cookies or similar.
600
631
  You can also just tell your AI "monash isn't working" and it will run the same checks. The MCP background log is `mcp.log` in the data directory.
601
632
 
633
+ ### `monash: command not found`
634
+
635
+ Close the terminal and open it again; `uv` adds its tools folder to your PATH only for new windows. Still missing: run `uv tool update-shell`, then reopen the terminal.
636
+
637
+ ### The first sync takes very long
638
+
639
+ The first sync downloads every file of every tracked unit. To get one unit first, run `monash sync FIT1045` (your own unit code). `monash status` shows whether the last sync was complete or partial, and `monash sync --retry-failed` retries only what failed.
640
+
641
+ ### A new semester started and my new units are missing
642
+
643
+ Run `monash courses` and pick the units again, then `monash sync`.
644
+
645
+ ### Ed says the token is invalid
646
+
647
+ You probably deleted the token on Ed's token page. Create a new one there and run `monash login ed` to paste it.
648
+
649
+ ### I want to remove everything
650
+
651
+ `monash uninstall` removes monash from Claude and the other AI apps, then asks whether to delete all data. If you say yes it first revokes the Google authorisations (Drive and Gmail) and deletes nothing when that fails. The Ed token has no revoke API: delete it on Ed's token page. Finish with `uv tool uninstall monash-study-kit`.
652
+
653
+ ## Release notes
654
+
655
+ Newest first. [CHANGELOG.md](CHANGELOG.md) has every change, and how to use each feature is in the sections above.
656
+
657
+ - **1.16**: [choose what gets downloaded](#choose-what-gets-downloaded) with a size limit and kinds of files to leave out, plus `monash skipped` to see and get what was left out
658
+ - **1.15**: `monash uninstall` also revokes Google access; first PyPI release since 1.11.2
659
+ - **1.14**: the [attendance login](#optional-gmail-and-attendance) comes back on its own when it can
660
+ - **1.13**: [check your work against the marking feedback](#check-your-work-against-the-marking-feedback)
661
+ - **1.12**: [partial syncs](#when-a-sync-only-partly-works), `--retry-failed` and `monash changes`
662
+ - **1.11**: Windows fixes for the login window and PDF export
663
+ - **1.9**: [fuller exports](#export-a-whole-units-materials) with Moodle Pages, Books, rubrics, Google files and PDF output
664
+ - **1.7**: `monash ed export` zips a unit's Ed materials by week; Ed files are stored by unit code
665
+ - **1.6**: `monash semester` week view and a private calendar file
666
+ - **1.5**: optional [school Gmail and attendance](#optional-gmail-and-attendance)
667
+ - **1.4**: study panels, `monash library` and [remote mode](#other-ai-clients) for ChatGPT
668
+
602
669
  ## Development
603
670
 
604
671
  ```bash
@@ -616,6 +683,9 @@ Every PR also builds the wheel, checks what went into it (`scripts/check_dist.py
616
683
 
617
684
  ### How it fits together
618
685
 
686
+ <details>
687
+ <summary>Diagram and module list</summary>
688
+
619
689
  ```mermaid
620
690
  flowchart LR
621
691
  Claude["Claude, Codex, Cursor and other local MCP apps"] -- "stdio (JSON-RPC)" --> MCP["mcp_server"]
@@ -653,9 +723,11 @@ flowchart LR
653
723
  | `doctor`, `doctor_deep`, `help_menu`, `update_check`, `claude_setup` | Health check and `--deep` cross-checks, help and preset prompts, new-version notice, adding the server to Claude |
654
724
  | `recordings`, `transcribe` | Optional: lecture recordings to timestamped transcripts (`[media]` extra) |
655
725
 
656
- The only runtime dependency is `pypdf`; everything else (HTTP, SQLite, WebSocket, HTML parsing) uses the standard library.
726
+ Runtime dependencies are `pypdf` and, on Windows, `tzdata`; everything else (HTTP, SQLite, WebSocket, HTML parsing) uses the standard library.
657
727
  Tests run on macOS, Windows and Ubuntu with Python 3.10 and 3.13 in CI, and `ruff` checks for syntax errors, undefined names and unused imports.
658
728
 
729
+ </details>
730
+
659
731
  ## License
660
732
 
661
733
  MIT. This is an independent student-built tool, not affiliated with Monash University, Ed or Anthropic.
@@ -79,3 +79,13 @@ Changes to this policy are published in this file, with the history visible in t
79
79
  - 数据只发给你连接的服务(Moodle、Ed、Google、考勤门户)和你接入的 AI 应用(仅限它代你查询的结果);不用于广告、不出售、不用于训练模型。
80
80
  - 使用 Google API 获取的数据遵守 Google API Services User Data Policy 及其 Limited Use 要求。
81
81
  - 可随时在 <https://myaccount.google.com/permissions> 撤销 Google 授权,删除数据目录即可清除全部本地数据。
82
+
83
+ ## On-demand submitted assignments / 按需读取已交作业
84
+
85
+ In the default profile, assignment submission and feedback tools read only what the signed-in account can access on its current Moodle assignment page. Attachments are downloaded on demand into `data/submissions/`, separate from course files, search indexes, the local course library and course exports. Cached copies remain on the Study Kit host until manually deleted; deleting this directory removes them. AI clients receive the requested extracted document text and visible grading feedback through MCP. Binary-file responses expose a local host path, not a public download URL. Materials-only profiles block these reads, including the `read_file` submission-path route.
86
+
87
+ 默认账号按需读取当前 Moodle 会话有权访问的提交文件和反馈;附件缓存于 `data/submissions/`,不进入课程课件、搜索索引、课程浏览页或整课导出。缓存保留在运行 Study Kit 的机器上,需手动删除此目录清理。通过 MCP 读取时,相关文档正文和可见评分反馈会发送给调用的 AI 客户端;二进制文件返回本地路径,不提供公开下载链接。仅课程资料模式同时封锁直接详情和 `read_file` 的提交路径。
88
+
89
+ ## Attendance recovery
90
+
91
+ Silent attendance recovery reuses the existing isolated browser profile only on the login computer. It does not export IdP/Okta cookies or automate passwords/MFA. Only the application state filtered by the attendance adapter is saved for optional transfer. Authentication status stores timestamps and application-file metadata rather than cookie values. Failed recovery preserves the old application-state file and backs off until the next probe or a replacement file.