macversiontracker 1.0.1__tar.gz → 1.2.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 (156) hide show
  1. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/PKG-INFO +205 -43
  2. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/README.md +201 -37
  3. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/macversiontracker.egg-info/PKG-INFO +205 -43
  4. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/macversiontracker.egg-info/SOURCES.txt +13 -0
  5. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/macversiontracker.egg-info/requires.txt +2 -4
  6. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/pyproject.toml +10 -11
  7. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_advanced_cache.py +134 -7
  8. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_ai_module.py +24 -0
  9. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_async_homebrew.py +25 -0
  10. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_async_network.py +25 -0
  11. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_async_parity.py +1 -2
  12. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_auto_update_integration_flows.py +5 -5
  13. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_brew_candidates.py +11 -2
  14. macversiontracker-1.2.0/tests/test_cli.py +272 -0
  15. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_cli_auto_updates.py +9 -3
  16. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_export.py +58 -1
  17. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_finder_coverage.py +8 -11
  18. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_finder_new_coverage.py +75 -8
  19. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_homebrew.py +5 -5
  20. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_homebrew_advanced.py +69 -1
  21. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_int_002_recommendation.py +4 -4
  22. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_int_003_matching.py +4 -4
  23. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_int_004_async_parity.py +2 -2
  24. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_integration.py +36 -24
  25. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_macos_integration.py +130 -21
  26. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_main.py +128 -0
  27. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_matcher_coverage.py +31 -5
  28. macversiontracker-1.2.0/tests/test_menubar_app.py +162 -0
  29. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_ml_module.py +23 -16
  30. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_outdated_handlers.py +29 -15
  31. macversiontracker-1.2.0/tests/test_plugins.py +41 -0
  32. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_project_consistency.py +67 -0
  33. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_version_batch.py +21 -0
  34. macversiontracker-1.2.0/tests/test_version_parser.py +467 -0
  35. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/__init__.py +1 -1
  36. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/__main__.py +24 -6
  37. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/advanced_cache.py +118 -34
  38. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/ai/__init__.py +20 -5
  39. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/apps/finder.py +48 -25
  40. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/apps/matcher.py +5 -4
  41. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/async_homebrew.py +18 -4
  42. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/async_network.py +18 -2
  43. macversiontracker-1.2.0/versiontracker/audit/__init__.py +88 -0
  44. macversiontracker-1.2.0/versiontracker/audit/auto_update.py +555 -0
  45. macversiontracker-1.2.0/versiontracker/audit/blocklist.py +154 -0
  46. macversiontracker-1.2.0/versiontracker/audit/discovery.py +378 -0
  47. macversiontracker-1.2.0/versiontracker/audit/homebrew.py +195 -0
  48. macversiontracker-1.2.0/versiontracker/audit/models.py +252 -0
  49. macversiontracker-1.2.0/versiontracker/audit/rendering.py +236 -0
  50. macversiontracker-1.2.0/versiontracker/audit/service.py +185 -0
  51. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/cli.py +95 -4
  52. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/export.py +107 -32
  53. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/__init__.py +4 -0
  54. macversiontracker-1.2.0/versiontracker/handlers/ai_handlers.py +125 -0
  55. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/app_handlers.py +36 -14
  56. macversiontracker-1.2.0/versiontracker/handlers/audit_handlers.py +111 -0
  57. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/backup_handlers.py +2 -1
  58. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/brew_handlers.py +76 -44
  59. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/config_handlers.py +2 -2
  60. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/export_handlers.py +4 -4
  61. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/filter_handlers.py +18 -7
  62. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/macos_handlers.py +1 -1
  63. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/outdated_handlers.py +50 -22
  64. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/setup_handlers.py +26 -17
  65. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/utils_handlers.py +0 -43
  66. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/homebrew.py +3 -3
  67. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/macos_integration.py +25 -81
  68. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/menubar_app.py +24 -31
  69. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/ml/__init__.py +2 -2
  70. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/plugins/__init__.py +3 -4
  71. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/ui.py +11 -0
  72. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/utils.py +43 -0
  73. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/version/batch.py +11 -6
  74. macversiontracker-1.0.1/tests/test_cli.py +0 -137
  75. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/LICENSE +0 -0
  76. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/macversiontracker.egg-info/dependency_links.txt +0 -0
  77. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/macversiontracker.egg-info/entry_points.txt +0 -0
  78. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/macversiontracker.egg-info/top_level.txt +0 -0
  79. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/setup.cfg +0 -0
  80. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_additional_functions.py +0 -0
  81. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_app_store.py +0 -0
  82. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_apps.py +0 -0
  83. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_apps_coverage.py +0 -0
  84. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_apps_extra.py +0 -0
  85. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_apps_new.py +0 -0
  86. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_apps_new_pytest.py +0 -0
  87. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_async_homebrew_coverage.py +0 -0
  88. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_async_integration.py +0 -0
  89. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_auto_update_advanced.py +0 -0
  90. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_auto_update_edge_cases.py +0 -0
  91. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_auto_update_handlers.py +0 -0
  92. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_auto_update_integration.py +0 -0
  93. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_auto_update_rollback.py +0 -0
  94. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_auto_updates.py +0 -0
  95. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_brew_installability.py +0 -0
  96. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_cache.py +0 -0
  97. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_comparator_coverage.py +0 -0
  98. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_config.py +0 -0
  99. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_config_coverage.py +0 -0
  100. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_config_gaps.py +0 -0
  101. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_config_loader.py +0 -0
  102. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_config_save.py +0 -0
  103. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_config_validation_coverage.py +0 -0
  104. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_config_yaml.py +0 -0
  105. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_end_to_end_integration.py +0 -0
  106. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_enhanced_auto_update_handlers.py +0 -0
  107. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_enhanced_matching.py +0 -0
  108. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_enhanced_matching_coverage.py +0 -0
  109. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_exceptions_and_error_codes.py +0 -0
  110. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_int_001_discovery.py +0 -0
  111. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_module_lazy_imports.py +0 -0
  112. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_network_operations.py +0 -0
  113. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_parameterized_edge_cases.py +0 -0
  114. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_parameterized_version.py +0 -0
  115. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_platform_compatibility.py +0 -0
  116. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_profiling.py +0 -0
  117. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_profiling_coverage.py +0 -0
  118. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_ui.py +0 -0
  119. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_ui_enhanced.py +0 -0
  120. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_ui_new.py +0 -0
  121. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_utils.py +0 -0
  122. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_utils_comprehensive.py +0 -0
  123. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_utils_coverage.py +0 -0
  124. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_version.py +0 -0
  125. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_version_comprehensive.py +0 -0
  126. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_version_edge_cases.py +0 -0
  127. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_version_fuzzy.py +0 -0
  128. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_version_homebrew.py +0 -0
  129. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_version_legacy_coverage.py +0 -0
  130. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/tests/test_version_utils.py +0 -0
  131. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/apps/__init__.py +0 -0
  132. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/apps/cache.py +0 -0
  133. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/cache.py +0 -0
  134. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/config.py +0 -0
  135. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/deprecation.py +0 -0
  136. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/enhanced_matching.py +0 -0
  137. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/error_codes.py +0 -0
  138. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/exceptions.py +0 -0
  139. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/experimental/__init__.py +0 -0
  140. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/experimental/analytics.py +0 -0
  141. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/experimental/benchmarks.py +0 -0
  142. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/auto_update_handlers.py +0 -0
  143. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/auto_update_types.py +0 -0
  144. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/enhanced_auto_update_handlers.py +0 -0
  145. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/error_handlers.py +0 -0
  146. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/handlers/ui_handlers.py +0 -0
  147. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/plugins/example_plugins.py +0 -0
  148. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/profiling.py +0 -0
  149. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/py.typed +0 -0
  150. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/version/__init__.py +0 -0
  151. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/version/comparator.py +0 -0
  152. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/version/fuzzy.py +0 -0
  153. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/version/homebrew.py +0 -0
  154. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/version/models.py +0 -0
  155. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/version/parser.py +0 -0
  156. {macversiontracker-1.0.1 → macversiontracker-1.2.0}/versiontracker/version/utils.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: macversiontracker
3
- Version: 1.0.1
3
+ Version: 1.2.0
4
4
  Summary: A command-line tool for tracking and managing applications installed outside of the Mac App Store
5
5
  Author-email: docdyhr <thomas@dyhr.com>
6
6
  License-Expression: MIT
@@ -8,7 +8,7 @@ Project-URL: Homepage, https://github.com/docdyhr/versiontracker
8
8
  Project-URL: Bug Tracker, https://github.com/docdyhr/versiontracker/issues
9
9
  Project-URL: Documentation, https://github.com/docdyhr/versiontracker
10
10
  Project-URL: Source Code, https://github.com/docdyhr/versiontracker
11
- Project-URL: Changelog, https://github.com/docdyhr/versiontracker/blob/master/CHANGELOG.md
11
+ Project-URL: Changelog, https://github.com/docdyhr/versiontracker/blob/main/CHANGELOG.md
12
12
  Project-URL: PyPI, https://pypi.org/project/macversiontracker/
13
13
  Keywords: macos,homebrew,version,tracking,updates,cask
14
14
  Classifier: Development Status :: 5 - Production/Stable
@@ -30,15 +30,14 @@ Requires-Dist: tqdm>=4.65
30
30
  Requires-Dist: psutil>=6.0
31
31
  Requires-Dist: tabulate>=0.9.0
32
32
  Requires-Dist: termcolor>=3.3.0
33
- Requires-Dist: aiohttp>=3.13.4
33
+ Requires-Dist: aiohttp>=3.14.0
34
34
  Provides-Extra: dev
35
35
  Requires-Dist: pytest>=8.0; extra == "dev"
36
36
  Requires-Dist: pytest-cov>=7.0; extra == "dev"
37
37
  Requires-Dist: pytest-timeout>=2.1; extra == "dev"
38
38
  Requires-Dist: pytest-mock>=3.14; extra == "dev"
39
39
  Requires-Dist: pytest-asyncio>=1.0; extra == "dev"
40
- Requires-Dist: black>=26.3.1; extra == "dev"
41
- Requires-Dist: ruff>=0.4; extra == "dev"
40
+ Requires-Dist: ruff==0.16.10; extra == "dev"
42
41
  Requires-Dist: mypy>=1.10; extra == "dev"
43
42
  Requires-Dist: types-PyYAML>=6.0.12; extra == "dev"
44
43
  Requires-Dist: build>=1.0; extra == "dev"
@@ -53,7 +52,6 @@ Requires-Dist: pytest-asyncio>=1.0; extra == "test"
53
52
  Provides-Extra: security
54
53
  Requires-Dist: bandit[toml]>=1.8; extra == "security"
55
54
  Requires-Dist: pip-audit>=2.9; extra == "security"
56
- Requires-Dist: safety>=3.0; extra == "security"
57
55
  Provides-Extra: fuzzy
58
56
  Requires-Dist: rapidfuzz>=3.0; extra == "fuzzy"
59
57
  Provides-Extra: ml
@@ -61,6 +59,17 @@ Requires-Dist: numpy>=1.24.0; extra == "ml"
61
59
  Requires-Dist: scikit-learn>=1.3.0; extra == "ml"
62
60
  Dynamic: license-file
63
61
 
62
+ <!-- markdownlint-disable MD041 -->
63
+ <div align="right">
64
+
65
+ <a href="https://railway.com?referralCode=QhjuBc">
66
+
67
+ <img width="160" src="https://raw.githubusercontent.com/docdyhr/.github/main/assets/railway-corner-v2@2x.png" alt="Deploy on Railway — $20 free credits"> <!-- markdownlint-disable-line MD013 -->
68
+
69
+ </a>
70
+
71
+ </div>
72
+
64
73
  # Versiontracker Update tool for macOS
65
74
 
66
75
  ![Logo](assets/images/logo.png)
@@ -78,31 +87,28 @@ Dynamic: license-file
78
87
 
79
88
  ### 🏗️ Build & CI/CD Pipeline
80
89
 
81
- [![CI Pipeline](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/ci.yml?branch=master&label=CI%20Pipeline&logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml)
82
- [![Lint](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/lint.yml?branch=master&label=Lint&logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/lint.yml)
83
- [![Security](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/security.yml?branch=master&label=Security&logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
84
- [![CodeQL](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/codeql-analysis.yml?branch=master&label=CodeQL&logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/codeql-analysis.yml)
85
- [![Coverage](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/coverage.yml?branch=master&label=Coverage&logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/coverage.yml)
86
- [![Performance](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/performance.yml?branch=master&label=Performance&logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/performance.yml)
90
+ [![CI Pipeline](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/ci.yml?branch=main&label=CI%20Pipeline&logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml)
91
+ [![Lint](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/lint.yml?branch=main&label=Lint&logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/lint.yml)
92
+ [![Security](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/security.yml?branch=main&label=Security&logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
93
+ [![CodeQL](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/codeql-analysis.yml?branch=main&label=CodeQL&logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/codeql-analysis.yml)
94
+ [![Coverage](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/coverage.yml?branch=main&label=Coverage&logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/coverage.yml)
95
+ [![Performance](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/performance.yml?branch=main&label=Performance&logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/performance.yml)
87
96
  [![Release Workflow](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/release.yml?label=Release%20Pipeline&logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/release.yml)
88
97
  [![Release](https://img.shields.io/github/v/release/docdyhr/versiontracker?logo=github&logoColor=white&label=Latest%20Release)](https://github.com/docdyhr/versiontracker/releases/latest)
89
98
  [![PyPI](https://img.shields.io/pypi/v/macversiontracker?logo=pypi&logoColor=white&label=PyPI)](https://pypi.org/project/macversiontracker/)
90
99
 
91
100
  #### 🧪 Test Matrix
92
101
 
93
- | Platform | Python 3.12 | Python 3.13 |
94
- |----------|:-----------:|:-----------:|
95
- | **Ubuntu 22.04** | [![CI](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/ci.yml?branch=master&logo=ubuntu&logoColor=white&label=)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml) | [![CI](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/ci.yml?branch=master&logo=ubuntu&logoColor=white&label=)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml) |
96
- | **macOS Latest** | [![CI](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/ci.yml?branch=master&logo=apple&logoColor=white&label=)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml) | [![CI](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/ci.yml?branch=master&logo=apple&logoColor=white&label=)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml) |
102
+ | Platform | Python 3.12 | Python 3.13 |
103
+ |---------- |:-----------: |:-----------: |
104
+ | **Ubuntu 22.04** | [![CI](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/ci.yml?branch=main&logo=ubuntu&logoColor=white&label=)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml) | [![CI](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/ci.yml?branch=main&logo=ubuntu&logoColor=white&label=)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml) |
105
+ | **macOS Latest** | [![CI](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/ci.yml?branch=main&logo=apple&logoColor=white&label=)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml) | [![CI](https://img.shields.io/github/actions/workflow/status/docdyhr/versiontracker/ci.yml?branch=main&logo=apple&logoColor=white&label=)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml) |
97
106
 
98
107
  ### 🔒 Security & Quality
99
108
 
100
- [![Code Coverage](https://img.shields.io/codecov/c/github/docdyhr/versiontracker/master?logo=codecov&logoColor=white&label=Codecov)](https://codecov.io/gh/docdyhr/versiontracker)
101
- [![Test Coverage](https://img.shields.io/badge/Coverage-86%25-brightgreen?logo=pytest&logoColor=white)](https://github.com/docdyhr/versiontracker)
102
- [![Tests Passing](https://img.shields.io/badge/Tests-2%2C385%20Passing-success?logo=pytest&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml)
109
+ [![Code Coverage](https://img.shields.io/codecov/c/github/docdyhr/versiontracker/main?logo=codecov&logoColor=white&label=Codecov)](https://codecov.io/gh/docdyhr/versiontracker)
103
110
  [![Security: Bandit](https://img.shields.io/badge/Bandit-Passing-success?logo=python&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
104
111
  [![Security: pip-audit](https://img.shields.io/badge/pip--audit-No%20Vulnerabilities-success?logo=python&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
105
- [![Security: Safety](https://img.shields.io/badge/Safety-No%20Vulnerabilities-success?logo=python&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
106
112
 
107
113
  ### 🎨 Code Standards
108
114
 
@@ -118,7 +124,7 @@ Dynamic: license-file
118
124
  [![GitHub pull requests](https://img.shields.io/github/issues-pr/docdyhr/versiontracker?logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/pulls)
119
125
  [![GitHub forks](https://img.shields.io/github/forks/docdyhr/versiontracker?logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/network)
120
126
  [![GitHub stars](https://img.shields.io/github/stars/docdyhr/versiontracker?logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/stargazers)
121
- [![Last Commit](https://img.shields.io/github/last-commit/docdyhr/versiontracker?logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/commits/master)
127
+ [![Last Commit](https://img.shields.io/github/last-commit/docdyhr/versiontracker?logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/commits/main)
122
128
  [![Contributors](https://img.shields.io/github/contributors/docdyhr/versiontracker?logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/graphs/contributors)
123
129
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?logo=opensourceinitiative&logoColor=white)](https://opensource.org/licenses/MIT)
124
130
 
@@ -134,12 +140,13 @@ Dynamic: license-file
134
140
  ---
135
141
 
136
142
  * Name: Versiontracker
137
- * Version: 1.0.0
143
+ * Version: 1.2.0
138
144
  * Programming language: Python 3.12+
139
145
  * Author: thomas
140
146
  * Purpose: CLI versiontracker and update tool for macOS
141
- * Release date: 21. Feb 2022 (Updated: April 2026)
142
- * Code Quality: **70%+ overall test coverage with 2,194+ passing tests**,
147
+ * Release date: 21. Feb 2022
148
+ * Code Quality: **comprehensive automated test suite with high branch coverage**, enforced in CI
149
+ (see the CI Pipeline and Codecov badges above),
143
150
  **all previously identified high & medium complexity issues resolved**
144
151
 
145
152
  ## Quick Start
@@ -160,15 +167,20 @@ versiontracker --recommend
160
167
  # Check for outdated applications
161
168
  versiontracker --check-outdated
162
169
 
170
+ # Audit apps not managed by the App Store, Homebrew, or a local auto-updater
171
+ versiontracker --audit
172
+
173
+ # Ask a natural-language question, routed to a supported action
174
+ versiontracker --ask "which apps need manual updates"
175
+
163
176
  # Show help
164
177
  versiontracker --help
165
178
  ```
166
179
 
167
180
  ## Overview
168
181
 
169
- Versiontracker is a command-line tool for macOS that helps you manage applications
170
- installed outside of the App Store. v1.0.0 is the first production-stable release —
171
- core CLI, config, and Homebrew integration are fully operational.
182
+ Versiontracker is a production-stable command-line tool for macOS that helps you manage applications
183
+ installed outside of the App Store — core CLI, config, and Homebrew integration are fully operational.
172
184
 
173
185
  It identifies applications that aren't managed through Apple's official channels and suggests which ones can be managed
174
186
  using Homebrew casks, making it easier to keep your applications up to date.
@@ -196,6 +208,88 @@ using Homebrew casks, making it easier to keep your applications up to date.
196
208
  * Adaptive rate limiting based on CPU and memory usage
197
209
  * Support for saving and loading query filters
198
210
  * **Auto-updates detection** for Homebrew casks with filtering options
211
+ * **Unmanaged application audit** (`--audit`): identifies apps with no App
212
+ Store, Homebrew, or local auto-update coverage, with full per-signal
213
+ evidence and JSON/YAML/CSV export
214
+ * **Natural-language queries** (`--ask`): ask plain-English questions like
215
+ "which apps need manual updates" and get routed to the matching command;
216
+ unsupported or unclear queries always print a clear message instead of
217
+ guessing
218
+
219
+ ## Advanced Features
220
+
221
+ ### ML-Powered App Matching (optional)
222
+
223
+ VersionTracker includes an optional machine-learning engine that improves
224
+ app-to-cask matching accuracy using TF-IDF embeddings and a logistic regression
225
+ confidence model.
226
+
227
+ **Install the ML extras:**
228
+
229
+ ```bash
230
+ pip install macversiontracker[ml]
231
+ # or via Homebrew tap (installs core only; add ML extras via pip after)
232
+ ```
233
+
234
+ **What it provides** (`versiontracker.ml`):
235
+
236
+ * `MLRecommendationEngine` — semantic similarity matching between installed apps
237
+ and Homebrew casks using TF-IDF + cosine similarity
238
+ * `MatchingConfidenceModel` — scikit-learn classifier that scores each candidate
239
+ match; trained model is cached under `~/.config/versiontracker/ml_models/`
240
+ * `UsageAnalyzer` — records user accept/reject feedback to personalise the
241
+ confidence threshold over time
242
+ * `is_ml_available()` — runtime check; returns `False` gracefully when
243
+ `numpy`/`scikit-learn` are absent
244
+
245
+ ```python
246
+ from versiontracker.ml import is_ml_available, MLRecommendationEngine
247
+
248
+ if is_ml_available():
249
+ engine = MLRecommendationEngine()
250
+ engine.initialize(apps, casks)
251
+ recommendations = engine.get_recommendations(apps, casks)
252
+ ```
253
+
254
+ Without the ML extras the standard fuzzy-matching engine is used automatically
255
+ — there is no degraded behaviour or error.
256
+
257
+ ### Experimental Modules
258
+
259
+ The `versiontracker.experimental` package contains two modules that are
260
+ implemented but not yet wired to a CLI command. Their APIs may change between
261
+ minor versions.
262
+
263
+ **`versiontracker.experimental.analytics`** — SQLite-backed session analytics:
264
+
265
+ ```python
266
+ from versiontracker.experimental.analytics import AnalyticsEngine
267
+
268
+ engine = AnalyticsEngine()
269
+ with engine.session():
270
+ engine.record_event("app_scan_started", {"app_count": 42})
271
+ ```
272
+
273
+ Tracks: session durations, per-command event counts, performance metrics,
274
+ and usage patterns. Data is stored in
275
+ `~/.config/versiontracker/analytics.db`.
276
+
277
+ **`versiontracker.experimental.benchmarks`** — function-level performance
278
+ benchmarking with statistical analysis:
279
+
280
+ ```python
281
+ from versiontracker.experimental.benchmarks import BenchmarkRunner
282
+
283
+ runner = BenchmarkRunner()
284
+ runner.run_all()
285
+ runner.print_report()
286
+ ```
287
+
288
+ Tracks: min/mean/max execution time, memory usage, CPU load per operation.
289
+ Useful for regression detection during development.
290
+
291
+ To promote either module to stable status: wire it to a CLI entry point,
292
+ add ≥ 60% test coverage, and move it out of `experimental/`.
199
293
 
200
294
  ## Requirements
201
295
 
@@ -296,6 +390,12 @@ Export options:
296
390
  --output-file OUTPUT_FILE
297
391
  Specify the output file for export (default: print to stdout)
298
392
 
393
+ Audit options (used with --audit):
394
+ --all Show every audited application, not just those needing attention
395
+ --status {attention,unknown,managed}
396
+ Show only applications in this audit status
397
+ --explain Show full evidence per application instead of a compact table
398
+
299
399
  Configuration options:
300
400
  --generate-config Generate a default configuration file at ~/.config/versiontracker/config.yaml
301
401
  --config-path CONFIG_PATH
@@ -306,7 +406,9 @@ Configuration options:
306
406
  -a, --apps return Apps in Applications/ that is not updated by App Store
307
407
  -b, --brews return installable brews
308
408
  -r, --recommend return recommendations for brew
309
- -o, --outdated check for outdated applications compared to Homebrew versions
409
+ -o, --check-outdated check for outdated applications compared to Homebrew versions
410
+ --audit audit apps not managed by the App Store, Homebrew, or a local auto-updater
411
+ --ask QUERY ask a natural-language question, routed to a supported action
310
412
  -V, --version show program's version number and exit
311
413
  ```
312
414
 
@@ -339,13 +441,55 @@ python3 versiontracker-cli.py --recommend
339
441
  ### Check for outdated applications
340
442
 
341
443
  ```shell
342
- python3 versiontracker-cli.py --outdated
444
+ python3 versiontracker-cli.py --check-outdated
343
445
  ```
344
446
 
345
447
  Or if installed:
346
448
 
347
449
  ```shell
348
- versiontracker --outdated
450
+ versiontracker --check-outdated
451
+ ```
452
+
453
+ ### Audit unmanaged applications
454
+
455
+ Identify user-facing applications that aren't App Store-managed, aren't
456
+ Homebrew-owned, have no confirmed local auto-update path, and aren't
457
+ blocklisted — with full per-signal evidence rather than a bare yes/no.
458
+
459
+ ```shell
460
+ # Default view: applications needing attention or with incomplete evidence
461
+ versiontracker --audit
462
+
463
+ # Show every audited application, including already-managed ones
464
+ versiontracker --audit --all
465
+
466
+ # Show full evidence per application instead of a compact table
467
+ versiontracker --audit --explain
468
+
469
+ # Show only one audit status
470
+ versiontracker --audit --status unknown
471
+
472
+ # Export full evidence as versioned JSON
473
+ versiontracker --audit --export json --output-file audit.json
474
+ ```
475
+
476
+ ### Ask a natural-language question
477
+
478
+ Route a plain-English query to a supported action instead of remembering the
479
+ exact flag. Recognizes a handful of phrasings for auditing, listing apps,
480
+ Homebrew recommendations, and checking for outdated apps; anything it doesn't
481
+ recognize (or isn't confident about) prints a clear message instead of
482
+ guessing.
483
+
484
+ ```shell
485
+ # Routed to --audit
486
+ versiontracker --ask "which apps need manual updates"
487
+
488
+ # Combines with modifier flags exactly like the literal flag would
489
+ versiontracker --ask "which apps need manual updates" --export json
490
+
491
+ # Routed to --apps
492
+ versiontracker --ask "list my applications"
349
493
  ```
350
494
 
351
495
  ### Handle applications with auto-updates
@@ -427,8 +571,8 @@ python -m versiontracker --install-service
427
571
  # Check service status
428
572
  python -m versiontracker --service-status
429
573
 
430
- # Send notification with outdated app results
431
- python -m versiontracker --outdated --notify
574
+ # Check for outdated applications
575
+ python -m versiontracker --check-outdated
432
576
 
433
577
  # Launch menubar application for quick access
434
578
  python -m versiontracker --menubar
@@ -650,11 +794,11 @@ VersionTracker intentionally uses a heavy mocking approach to:
650
794
  2. Deterministically simulate Homebrew and filesystem behaviors
651
795
  3. Keep test execution fast and CI-friendly
652
796
 
653
- Current Coverage Profile:
797
+ Current Coverage Profile (see the Codecov badge above for the live, up-to-date number):
654
798
 
655
- * Reported line coverage: ≈70%+ overall
656
- * Core modules (matcher, finder, config) have 78–98% coverage
657
- * High mock call volume for platform/network code paths ensures behavioral correctness without requiring macOS-specific execution
799
+ * Core modules (matcher, finder, config) carry the highest coverage
800
+ * High mock call volume for platform/network code paths ensures behavioral correctness without
801
+ requiring macOS-specific execution
658
802
 
659
803
  Why Some Coverage Is Lower:
660
804
 
@@ -688,7 +832,7 @@ This strategy favors maintainability, determinism, and clear behavioral guarante
688
832
  VersionTracker uses GitHub Actions for continuous integration and deployment:
689
833
 
690
834
  * **Testing**: Automatically runs the test suite on multiple Python versions
691
- * **Linting**: Ensures code quality with flake8, black, and isort
835
+ * **Linting**: Enforces linting and formatting with Ruff, plus type checking with mypy
692
836
  * **Releases**: Automatically publishes new versions to PyPI when a release is created
693
837
 
694
838
  The CI/CD pipeline helps maintain code quality and ensures that the application is always in a deployable state.
@@ -705,18 +849,37 @@ be managed through Homebrew.
705
849
 
706
850
  ## Project Status
707
851
 
708
- VersionTracker v1.0.0 is production-stable. All critical technical debt has been resolved
852
+ VersionTracker is production-stable. All critical technical debt has been resolved
709
853
  and the tool is fully operational on macOS. Key highlights:
710
854
 
711
- * **v1.0.0 released** — available on PyPI (`pip install macversiontracker`) and Homebrew
712
- * **70%+ test coverage** with 2,194+ passing tests and 0 failing tests
713
- * **Zero high-severity security vulnerabilities**
855
+ * **Actively maintained** — available on PyPI (`pip install macversiontracker`) and Homebrew
856
+ * **Comprehensive automated test suite** with high branch coverage, enforced in CI (see badges above)
857
+ * **Zero high-severity security vulnerabilities** — enforced by the required Security Analysis CI check
714
858
  * **Complete complexity resolution**: all high & medium-priority complex functions refactored
715
859
  * **Async Homebrew API**: install and update candidate checks use async operations by default
716
860
  * **Modular architecture**: dedicated `handlers/`, `version/`, and `apps/` subpackages
717
861
  * **Lazy config initialisation**: no subprocess on import — fast startup
718
862
  * **Signed release artifacts**: distributions signed with Sigstore via GitHub OIDC
719
863
 
864
+ ## Known Limitations
865
+
866
+ * **macOS only** — VersionTracker runs on macOS only; Linux and Windows are not supported.
867
+ * **macOS 10.15 Catalina or later** — older releases are not tested. Tested through macOS Sequoia.
868
+ * **Homebrew required for version checks** — `--check-outdated` and `--recommend` require Homebrew;
869
+ `--apps` works without it.
870
+ * **Apple Silicon vs Intel** — both paths are detected automatically (`/opt/homebrew/bin/brew`
871
+ and `/usr/local/bin/brew`). Mixed-architecture Rosetta environments may need a manual
872
+ `--config-path` with a generated config.
873
+ * **Package managers not yet supported** — MacPorts and Mac App Store (`mas-cli`) integration
874
+ are on the roadmap. See `TODO.md → Future Enhancements`.
875
+ * **ML features require optional dependencies** — the ML matching engine (`versiontracker.ml`)
876
+ needs `numpy` and `scikit-learn`. Install with `pip install macversiontracker[ml]`.
877
+ * **Experimental modules are unstable** — `versiontracker.experimental.analytics` and
878
+ `versiontracker.experimental.benchmarks` are not wired to any CLI command and their APIs
879
+ may change without notice between minor versions.
880
+ * **A small number of tests are skipped in default runs** — ML-dep tests skip without the `[ml]`
881
+ extras; platform-guard tests skip on macOS; a colour test skips in non-TTY environments. All expected.
882
+
720
883
  ## Recent Major Achievements (v1.0.0)
721
884
 
722
885
  * **Production release**: first stable PyPI and Homebrew release with Trusted Publisher OIDC signing
@@ -732,11 +895,10 @@ and the tool is fully operational on macOS. Key highlights:
732
895
  * Add more package managers support (MacPorts, etc.)
733
896
  * Implement automatic update capabilities for Homebrew-manageable applications
734
897
  * Add GUI interface
735
- * Raise test coverage to 85%+ across all core modules
736
898
 
737
899
  ## License
738
900
 
739
- [MIT](https://github.com/docdyhr/versiontracker/blob/master/LICENSE)
901
+ [MIT](https://github.com/docdyhr/versiontracker/blob/main/LICENSE)
740
902
 
741
903
  ### Blocklist Terminology Migration
742
904