macversiontracker 1.0.1__tar.gz → 1.1.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 (153) hide show
  1. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/PKG-INFO +153 -13
  2. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/README.md +150 -10
  3. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/macversiontracker.egg-info/PKG-INFO +153 -13
  4. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/macversiontracker.egg-info/SOURCES.txt +11 -0
  5. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/macversiontracker.egg-info/requires.txt +2 -2
  6. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/pyproject.toml +3 -3
  7. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_cli.py +50 -0
  8. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_cli_auto_updates.py +3 -0
  9. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_integration.py +35 -24
  10. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_main.py +54 -0
  11. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_matcher_coverage.py +16 -5
  12. macversiontracker-1.1.0/tests/test_menubar_app.py +57 -0
  13. macversiontracker-1.1.0/tests/test_version_parser.py +467 -0
  14. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/__init__.py +1 -1
  15. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/__main__.py +14 -1
  16. macversiontracker-1.1.0/versiontracker/audit/__init__.py +88 -0
  17. macversiontracker-1.1.0/versiontracker/audit/auto_update.py +555 -0
  18. macversiontracker-1.1.0/versiontracker/audit/blocklist.py +154 -0
  19. macversiontracker-1.1.0/versiontracker/audit/discovery.py +378 -0
  20. macversiontracker-1.1.0/versiontracker/audit/homebrew.py +195 -0
  21. macversiontracker-1.1.0/versiontracker/audit/models.py +252 -0
  22. macversiontracker-1.1.0/versiontracker/audit/rendering.py +236 -0
  23. macversiontracker-1.1.0/versiontracker/audit/service.py +185 -0
  24. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/cli.py +27 -0
  25. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/handlers/__init__.py +2 -0
  26. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/handlers/app_handlers.py +2 -1
  27. macversiontracker-1.1.0/versiontracker/handlers/audit_handlers.py +111 -0
  28. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/handlers/config_handlers.py +2 -2
  29. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/handlers/filter_handlers.py +1 -1
  30. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/handlers/macos_handlers.py +1 -1
  31. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/handlers/setup_handlers.py +5 -4
  32. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/macos_integration.py +7 -2
  33. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/menubar_app.py +2 -2
  34. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/ui.py +11 -0
  35. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/LICENSE +0 -0
  36. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/macversiontracker.egg-info/dependency_links.txt +0 -0
  37. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/macversiontracker.egg-info/entry_points.txt +0 -0
  38. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/macversiontracker.egg-info/top_level.txt +0 -0
  39. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/setup.cfg +0 -0
  40. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_additional_functions.py +0 -0
  41. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_advanced_cache.py +0 -0
  42. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_ai_module.py +0 -0
  43. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_app_store.py +0 -0
  44. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_apps.py +0 -0
  45. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_apps_coverage.py +0 -0
  46. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_apps_extra.py +0 -0
  47. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_apps_new.py +0 -0
  48. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_apps_new_pytest.py +0 -0
  49. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_async_homebrew.py +0 -0
  50. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_async_homebrew_coverage.py +0 -0
  51. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_async_integration.py +0 -0
  52. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_async_network.py +0 -0
  53. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_async_parity.py +0 -0
  54. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_auto_update_advanced.py +0 -0
  55. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_auto_update_edge_cases.py +0 -0
  56. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_auto_update_handlers.py +0 -0
  57. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_auto_update_integration.py +0 -0
  58. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_auto_update_integration_flows.py +0 -0
  59. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_auto_update_rollback.py +0 -0
  60. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_auto_updates.py +0 -0
  61. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_brew_candidates.py +0 -0
  62. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_brew_installability.py +0 -0
  63. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_cache.py +0 -0
  64. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_comparator_coverage.py +0 -0
  65. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_config.py +0 -0
  66. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_config_coverage.py +0 -0
  67. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_config_gaps.py +0 -0
  68. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_config_loader.py +0 -0
  69. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_config_save.py +0 -0
  70. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_config_validation_coverage.py +0 -0
  71. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_config_yaml.py +0 -0
  72. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_end_to_end_integration.py +0 -0
  73. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_enhanced_auto_update_handlers.py +0 -0
  74. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_enhanced_matching.py +0 -0
  75. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_enhanced_matching_coverage.py +0 -0
  76. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_exceptions_and_error_codes.py +0 -0
  77. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_export.py +0 -0
  78. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_finder_coverage.py +0 -0
  79. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_finder_new_coverage.py +0 -0
  80. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_homebrew.py +0 -0
  81. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_homebrew_advanced.py +0 -0
  82. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_int_001_discovery.py +0 -0
  83. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_int_002_recommendation.py +0 -0
  84. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_int_003_matching.py +0 -0
  85. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_int_004_async_parity.py +0 -0
  86. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_macos_integration.py +0 -0
  87. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_ml_module.py +0 -0
  88. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_module_lazy_imports.py +0 -0
  89. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_network_operations.py +0 -0
  90. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_outdated_handlers.py +0 -0
  91. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_parameterized_edge_cases.py +0 -0
  92. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_parameterized_version.py +0 -0
  93. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_platform_compatibility.py +0 -0
  94. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_profiling.py +0 -0
  95. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_profiling_coverage.py +0 -0
  96. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_project_consistency.py +0 -0
  97. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_ui.py +0 -0
  98. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_ui_enhanced.py +0 -0
  99. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_ui_new.py +0 -0
  100. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_utils.py +0 -0
  101. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_utils_comprehensive.py +0 -0
  102. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_utils_coverage.py +0 -0
  103. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_version.py +0 -0
  104. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_version_batch.py +0 -0
  105. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_version_comprehensive.py +0 -0
  106. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_version_edge_cases.py +0 -0
  107. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_version_fuzzy.py +0 -0
  108. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_version_homebrew.py +0 -0
  109. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_version_legacy_coverage.py +0 -0
  110. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/tests/test_version_utils.py +0 -0
  111. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/advanced_cache.py +0 -0
  112. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/ai/__init__.py +0 -0
  113. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/apps/__init__.py +0 -0
  114. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/apps/cache.py +0 -0
  115. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/apps/finder.py +0 -0
  116. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/apps/matcher.py +0 -0
  117. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/async_homebrew.py +0 -0
  118. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/async_network.py +0 -0
  119. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/cache.py +0 -0
  120. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/config.py +0 -0
  121. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/deprecation.py +0 -0
  122. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/enhanced_matching.py +0 -0
  123. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/error_codes.py +0 -0
  124. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/exceptions.py +0 -0
  125. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/experimental/__init__.py +0 -0
  126. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/experimental/analytics.py +0 -0
  127. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/experimental/benchmarks.py +0 -0
  128. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/export.py +0 -0
  129. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/handlers/auto_update_handlers.py +0 -0
  130. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/handlers/auto_update_types.py +0 -0
  131. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/handlers/backup_handlers.py +0 -0
  132. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/handlers/brew_handlers.py +0 -0
  133. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/handlers/enhanced_auto_update_handlers.py +0 -0
  134. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/handlers/error_handlers.py +0 -0
  135. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/handlers/export_handlers.py +0 -0
  136. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/handlers/outdated_handlers.py +0 -0
  137. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/handlers/ui_handlers.py +0 -0
  138. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/handlers/utils_handlers.py +0 -0
  139. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/homebrew.py +0 -0
  140. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/ml/__init__.py +0 -0
  141. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/plugins/__init__.py +0 -0
  142. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/plugins/example_plugins.py +0 -0
  143. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/profiling.py +0 -0
  144. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/py.typed +0 -0
  145. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/utils.py +0 -0
  146. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/version/__init__.py +0 -0
  147. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/version/batch.py +0 -0
  148. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/version/comparator.py +0 -0
  149. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/version/fuzzy.py +0 -0
  150. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/version/homebrew.py +0 -0
  151. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/version/models.py +0 -0
  152. {macversiontracker-1.0.1 → macversiontracker-1.1.0}/versiontracker/version/parser.py +0 -0
  153. {macversiontracker-1.0.1 → macversiontracker-1.1.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.1.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
@@ -30,7 +30,7 @@ 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"
@@ -38,7 +38,7 @@ 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
40
  Requires-Dist: black>=26.3.1; extra == "dev"
41
- Requires-Dist: ruff>=0.4; extra == "dev"
41
+ Requires-Dist: ruff==0.16.0; extra == "dev"
42
42
  Requires-Dist: mypy>=1.10; extra == "dev"
43
43
  Requires-Dist: types-PyYAML>=6.0.12; extra == "dev"
44
44
  Requires-Dist: build>=1.0; extra == "dev"
@@ -61,6 +61,17 @@ Requires-Dist: numpy>=1.24.0; extra == "ml"
61
61
  Requires-Dist: scikit-learn>=1.3.0; extra == "ml"
62
62
  Dynamic: license-file
63
63
 
64
+ <!-- markdownlint-disable MD041 -->
65
+ <div align="right">
66
+
67
+ <a href="https://railway.com?referralCode=QhjuBc">
68
+
69
+ <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 -->
70
+
71
+ </a>
72
+
73
+ </div>
74
+
64
75
  # Versiontracker Update tool for macOS
65
76
 
66
77
  ![Logo](assets/images/logo.png)
@@ -99,7 +110,7 @@ Dynamic: license-file
99
110
 
100
111
  [![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
112
  [![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)
113
+ [![Tests Passing](https://img.shields.io/badge/Tests-2%2C477%20Passing-success?logo=pytest&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml)
103
114
  [![Security: Bandit](https://img.shields.io/badge/Bandit-Passing-success?logo=python&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
104
115
  [![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
116
  [![Security: Safety](https://img.shields.io/badge/Safety-No%20Vulnerabilities-success?logo=python&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
@@ -139,7 +150,7 @@ Dynamic: license-file
139
150
  * Author: thomas
140
151
  * Purpose: CLI versiontracker and update tool for macOS
141
152
  * Release date: 21. Feb 2022 (Updated: April 2026)
142
- * Code Quality: **70%+ overall test coverage with 2,194+ passing tests**,
153
+ * Code Quality: **86% overall test coverage with 2,477 passing tests**,
143
154
  **all previously identified high & medium complexity issues resolved**
144
155
 
145
156
  ## Quick Start
@@ -160,6 +171,9 @@ versiontracker --recommend
160
171
  # Check for outdated applications
161
172
  versiontracker --check-outdated
162
173
 
174
+ # Audit apps not managed by the App Store, Homebrew, or a local auto-updater
175
+ versiontracker --audit
176
+
163
177
  # Show help
164
178
  versiontracker --help
165
179
  ```
@@ -196,6 +210,84 @@ using Homebrew casks, making it easier to keep your applications up to date.
196
210
  * Adaptive rate limiting based on CPU and memory usage
197
211
  * Support for saving and loading query filters
198
212
  * **Auto-updates detection** for Homebrew casks with filtering options
213
+ * **Unmanaged application audit** (`--audit`): identifies apps with no App
214
+ Store, Homebrew, or local auto-update coverage, with full per-signal
215
+ evidence and JSON/YAML/CSV export
216
+
217
+ ## Advanced Features
218
+
219
+ ### ML-Powered App Matching (optional)
220
+
221
+ VersionTracker includes an optional machine-learning engine that improves
222
+ app-to-cask matching accuracy using TF-IDF embeddings and a logistic regression
223
+ confidence model.
224
+
225
+ **Install the ML extras:**
226
+
227
+ ```bash
228
+ pip install macversiontracker[ml]
229
+ # or via Homebrew tap (installs core only; add ML extras via pip after)
230
+ ```
231
+
232
+ **What it provides** (`versiontracker.ml`):
233
+
234
+ * `MLRecommendationEngine` — semantic similarity matching between installed apps
235
+ and Homebrew casks using TF-IDF + cosine similarity
236
+ * `MatchingConfidenceModel` — scikit-learn classifier that scores each candidate
237
+ match; trained model is cached under `~/.config/versiontracker/ml_models/`
238
+ * `UsageAnalyzer` — records user accept/reject feedback to personalise the
239
+ confidence threshold over time
240
+ * `is_ml_available()` — runtime check; returns `False` gracefully when
241
+ `numpy`/`scikit-learn` are absent
242
+
243
+ ```python
244
+ from versiontracker.ml import is_ml_available, MLRecommendationEngine
245
+
246
+ if is_ml_available():
247
+ engine = MLRecommendationEngine()
248
+ engine.initialize(apps, casks)
249
+ recommendations = engine.get_recommendations(apps, casks)
250
+ ```
251
+
252
+ Without the ML extras the standard fuzzy-matching engine is used automatically
253
+ — there is no degraded behaviour or error.
254
+
255
+ ### Experimental Modules
256
+
257
+ The `versiontracker.experimental` package contains two modules that are
258
+ implemented but not yet wired to a CLI command. Their APIs may change between
259
+ minor versions.
260
+
261
+ **`versiontracker.experimental.analytics`** — SQLite-backed session analytics:
262
+
263
+ ```python
264
+ from versiontracker.experimental.analytics import AnalyticsEngine
265
+
266
+ engine = AnalyticsEngine()
267
+ with engine.session():
268
+ engine.record_event("app_scan_started", {"app_count": 42})
269
+ ```
270
+
271
+ Tracks: session durations, per-command event counts, performance metrics,
272
+ and usage patterns. Data is stored in
273
+ `~/.config/versiontracker/analytics.db`.
274
+
275
+ **`versiontracker.experimental.benchmarks`** — function-level performance
276
+ benchmarking with statistical analysis:
277
+
278
+ ```python
279
+ from versiontracker.experimental.benchmarks import BenchmarkRunner
280
+
281
+ runner = BenchmarkRunner()
282
+ runner.run_all()
283
+ runner.print_report()
284
+ ```
285
+
286
+ Tracks: min/mean/max execution time, memory usage, CPU load per operation.
287
+ Useful for regression detection during development.
288
+
289
+ To promote either module to stable status: wire it to a CLI entry point,
290
+ add ≥ 60% test coverage, and move it out of `experimental/`.
199
291
 
200
292
  ## Requirements
201
293
 
@@ -296,6 +388,12 @@ Export options:
296
388
  --output-file OUTPUT_FILE
297
389
  Specify the output file for export (default: print to stdout)
298
390
 
391
+ Audit options (used with --audit):
392
+ --all Show every audited application, not just those needing attention
393
+ --status {attention,unknown,managed}
394
+ Show only applications in this audit status
395
+ --explain Show full evidence per application instead of a compact table
396
+
299
397
  Configuration options:
300
398
  --generate-config Generate a default configuration file at ~/.config/versiontracker/config.yaml
301
399
  --config-path CONFIG_PATH
@@ -306,7 +404,8 @@ Configuration options:
306
404
  -a, --apps return Apps in Applications/ that is not updated by App Store
307
405
  -b, --brews return installable brews
308
406
  -r, --recommend return recommendations for brew
309
- -o, --outdated check for outdated applications compared to Homebrew versions
407
+ -o, --check-outdated check for outdated applications compared to Homebrew versions
408
+ --audit audit apps not managed by the App Store, Homebrew, or a local auto-updater
310
409
  -V, --version show program's version number and exit
311
410
  ```
312
411
 
@@ -339,13 +438,36 @@ python3 versiontracker-cli.py --recommend
339
438
  ### Check for outdated applications
340
439
 
341
440
  ```shell
342
- python3 versiontracker-cli.py --outdated
441
+ python3 versiontracker-cli.py --check-outdated
343
442
  ```
344
443
 
345
444
  Or if installed:
346
445
 
347
446
  ```shell
348
- versiontracker --outdated
447
+ versiontracker --check-outdated
448
+ ```
449
+
450
+ ### Audit unmanaged applications
451
+
452
+ Identify user-facing applications that aren't App Store-managed, aren't
453
+ Homebrew-owned, have no confirmed local auto-update path, and aren't
454
+ blocklisted — with full per-signal evidence rather than a bare yes/no.
455
+
456
+ ```shell
457
+ # Default view: applications needing attention or with incomplete evidence
458
+ versiontracker --audit
459
+
460
+ # Show every audited application, including already-managed ones
461
+ versiontracker --audit --all
462
+
463
+ # Show full evidence per application instead of a compact table
464
+ versiontracker --audit --explain
465
+
466
+ # Show only one audit status
467
+ versiontracker --audit --status unknown
468
+
469
+ # Export full evidence as versioned JSON
470
+ versiontracker --audit --export json --output-file audit.json
349
471
  ```
350
472
 
351
473
  ### Handle applications with auto-updates
@@ -427,8 +549,8 @@ python -m versiontracker --install-service
427
549
  # Check service status
428
550
  python -m versiontracker --service-status
429
551
 
430
- # Send notification with outdated app results
431
- python -m versiontracker --outdated --notify
552
+ # Check for outdated applications
553
+ python -m versiontracker --check-outdated
432
554
 
433
555
  # Launch menubar application for quick access
434
556
  python -m versiontracker --menubar
@@ -652,7 +774,7 @@ VersionTracker intentionally uses a heavy mocking approach to:
652
774
 
653
775
  Current Coverage Profile:
654
776
 
655
- * Reported line coverage: ≈70%+ overall
777
+ * Reported line coverage: ≈86% overall
656
778
  * Core modules (matcher, finder, config) have 78–98% coverage
657
779
  * High mock call volume for platform/network code paths ensures behavioral correctness without requiring macOS-specific execution
658
780
 
@@ -709,7 +831,7 @@ VersionTracker v1.0.0 is production-stable. All critical technical debt has been
709
831
  and the tool is fully operational on macOS. Key highlights:
710
832
 
711
833
  * **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
834
+ * **86% test coverage** with 2,477 passing tests and 0 failing tests
713
835
  * **Zero high-severity security vulnerabilities**
714
836
  * **Complete complexity resolution**: all high & medium-priority complex functions refactored
715
837
  * **Async Homebrew API**: install and update candidate checks use async operations by default
@@ -717,6 +839,25 @@ and the tool is fully operational on macOS. Key highlights:
717
839
  * **Lazy config initialisation**: no subprocess on import — fast startup
718
840
  * **Signed release artifacts**: distributions signed with Sigstore via GitHub OIDC
719
841
 
842
+ ## Known Limitations
843
+
844
+ * **macOS only** — VersionTracker runs on macOS only; Linux and Windows are not supported.
845
+ * **macOS 10.15 Catalina or later** — older releases are not tested. Tested through macOS Sequoia.
846
+ * **Homebrew required for version checks** — `--check-outdated` and `--recommend` require Homebrew;
847
+ `--apps` works without it.
848
+ * **Apple Silicon vs Intel** — both paths are detected automatically (`/opt/homebrew/bin/brew`
849
+ and `/usr/local/bin/brew`). Mixed-architecture Rosetta environments may need a manual
850
+ `--config-path` with a generated config.
851
+ * **Package managers not yet supported** — MacPorts and Mac App Store (`mas-cli`) integration
852
+ are on the roadmap. See `TODO.md → Future Enhancements`.
853
+ * **ML features require optional dependencies** — the ML matching engine (`versiontracker.ml`)
854
+ needs `numpy` and `scikit-learn`. Install with `pip install macversiontracker[ml]`.
855
+ * **Experimental modules are unstable** — `versiontracker.experimental.analytics` and
856
+ `versiontracker.experimental.benchmarks` are not wired to any CLI command and their APIs
857
+ may change without notice between minor versions.
858
+ * **16 tests skipped in default runs** — 13 ML-dep tests skip without the `[ml]` extras;
859
+ 2 platform-guard tests skip on macOS; 1 colour test skips in non-TTY environments. All expected.
860
+
720
861
  ## Recent Major Achievements (v1.0.0)
721
862
 
722
863
  * **Production release**: first stable PyPI and Homebrew release with Trusted Publisher OIDC signing
@@ -732,7 +873,6 @@ and the tool is fully operational on macOS. Key highlights:
732
873
  * Add more package managers support (MacPorts, etc.)
733
874
  * Implement automatic update capabilities for Homebrew-manageable applications
734
875
  * Add GUI interface
735
- * Raise test coverage to 85%+ across all core modules
736
876
 
737
877
  ## License
738
878
 
@@ -1,3 +1,14 @@
1
+ <!-- markdownlint-disable MD041 -->
2
+ <div align="right">
3
+
4
+ <a href="https://railway.com?referralCode=QhjuBc">
5
+
6
+ <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 -->
7
+
8
+ </a>
9
+
10
+ </div>
11
+
1
12
  # Versiontracker Update tool for macOS
2
13
 
3
14
  ![Logo](assets/images/logo.png)
@@ -36,7 +47,7 @@
36
47
 
37
48
  [![Code Coverage](https://img.shields.io/codecov/c/github/docdyhr/versiontracker/master?logo=codecov&logoColor=white&label=Codecov)](https://codecov.io/gh/docdyhr/versiontracker)
38
49
  [![Test Coverage](https://img.shields.io/badge/Coverage-86%25-brightgreen?logo=pytest&logoColor=white)](https://github.com/docdyhr/versiontracker)
39
- [![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)
50
+ [![Tests Passing](https://img.shields.io/badge/Tests-2%2C477%20Passing-success?logo=pytest&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/ci.yml)
40
51
  [![Security: Bandit](https://img.shields.io/badge/Bandit-Passing-success?logo=python&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
41
52
  [![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)
42
53
  [![Security: Safety](https://img.shields.io/badge/Safety-No%20Vulnerabilities-success?logo=python&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
@@ -76,7 +87,7 @@
76
87
  * Author: thomas
77
88
  * Purpose: CLI versiontracker and update tool for macOS
78
89
  * Release date: 21. Feb 2022 (Updated: April 2026)
79
- * Code Quality: **70%+ overall test coverage with 2,194+ passing tests**,
90
+ * Code Quality: **86% overall test coverage with 2,477 passing tests**,
80
91
  **all previously identified high & medium complexity issues resolved**
81
92
 
82
93
  ## Quick Start
@@ -97,6 +108,9 @@ versiontracker --recommend
97
108
  # Check for outdated applications
98
109
  versiontracker --check-outdated
99
110
 
111
+ # Audit apps not managed by the App Store, Homebrew, or a local auto-updater
112
+ versiontracker --audit
113
+
100
114
  # Show help
101
115
  versiontracker --help
102
116
  ```
@@ -133,6 +147,84 @@ using Homebrew casks, making it easier to keep your applications up to date.
133
147
  * Adaptive rate limiting based on CPU and memory usage
134
148
  * Support for saving and loading query filters
135
149
  * **Auto-updates detection** for Homebrew casks with filtering options
150
+ * **Unmanaged application audit** (`--audit`): identifies apps with no App
151
+ Store, Homebrew, or local auto-update coverage, with full per-signal
152
+ evidence and JSON/YAML/CSV export
153
+
154
+ ## Advanced Features
155
+
156
+ ### ML-Powered App Matching (optional)
157
+
158
+ VersionTracker includes an optional machine-learning engine that improves
159
+ app-to-cask matching accuracy using TF-IDF embeddings and a logistic regression
160
+ confidence model.
161
+
162
+ **Install the ML extras:**
163
+
164
+ ```bash
165
+ pip install macversiontracker[ml]
166
+ # or via Homebrew tap (installs core only; add ML extras via pip after)
167
+ ```
168
+
169
+ **What it provides** (`versiontracker.ml`):
170
+
171
+ * `MLRecommendationEngine` — semantic similarity matching between installed apps
172
+ and Homebrew casks using TF-IDF + cosine similarity
173
+ * `MatchingConfidenceModel` — scikit-learn classifier that scores each candidate
174
+ match; trained model is cached under `~/.config/versiontracker/ml_models/`
175
+ * `UsageAnalyzer` — records user accept/reject feedback to personalise the
176
+ confidence threshold over time
177
+ * `is_ml_available()` — runtime check; returns `False` gracefully when
178
+ `numpy`/`scikit-learn` are absent
179
+
180
+ ```python
181
+ from versiontracker.ml import is_ml_available, MLRecommendationEngine
182
+
183
+ if is_ml_available():
184
+ engine = MLRecommendationEngine()
185
+ engine.initialize(apps, casks)
186
+ recommendations = engine.get_recommendations(apps, casks)
187
+ ```
188
+
189
+ Without the ML extras the standard fuzzy-matching engine is used automatically
190
+ — there is no degraded behaviour or error.
191
+
192
+ ### Experimental Modules
193
+
194
+ The `versiontracker.experimental` package contains two modules that are
195
+ implemented but not yet wired to a CLI command. Their APIs may change between
196
+ minor versions.
197
+
198
+ **`versiontracker.experimental.analytics`** — SQLite-backed session analytics:
199
+
200
+ ```python
201
+ from versiontracker.experimental.analytics import AnalyticsEngine
202
+
203
+ engine = AnalyticsEngine()
204
+ with engine.session():
205
+ engine.record_event("app_scan_started", {"app_count": 42})
206
+ ```
207
+
208
+ Tracks: session durations, per-command event counts, performance metrics,
209
+ and usage patterns. Data is stored in
210
+ `~/.config/versiontracker/analytics.db`.
211
+
212
+ **`versiontracker.experimental.benchmarks`** — function-level performance
213
+ benchmarking with statistical analysis:
214
+
215
+ ```python
216
+ from versiontracker.experimental.benchmarks import BenchmarkRunner
217
+
218
+ runner = BenchmarkRunner()
219
+ runner.run_all()
220
+ runner.print_report()
221
+ ```
222
+
223
+ Tracks: min/mean/max execution time, memory usage, CPU load per operation.
224
+ Useful for regression detection during development.
225
+
226
+ To promote either module to stable status: wire it to a CLI entry point,
227
+ add ≥ 60% test coverage, and move it out of `experimental/`.
136
228
 
137
229
  ## Requirements
138
230
 
@@ -233,6 +325,12 @@ Export options:
233
325
  --output-file OUTPUT_FILE
234
326
  Specify the output file for export (default: print to stdout)
235
327
 
328
+ Audit options (used with --audit):
329
+ --all Show every audited application, not just those needing attention
330
+ --status {attention,unknown,managed}
331
+ Show only applications in this audit status
332
+ --explain Show full evidence per application instead of a compact table
333
+
236
334
  Configuration options:
237
335
  --generate-config Generate a default configuration file at ~/.config/versiontracker/config.yaml
238
336
  --config-path CONFIG_PATH
@@ -243,7 +341,8 @@ Configuration options:
243
341
  -a, --apps return Apps in Applications/ that is not updated by App Store
244
342
  -b, --brews return installable brews
245
343
  -r, --recommend return recommendations for brew
246
- -o, --outdated check for outdated applications compared to Homebrew versions
344
+ -o, --check-outdated check for outdated applications compared to Homebrew versions
345
+ --audit audit apps not managed by the App Store, Homebrew, or a local auto-updater
247
346
  -V, --version show program's version number and exit
248
347
  ```
249
348
 
@@ -276,13 +375,36 @@ python3 versiontracker-cli.py --recommend
276
375
  ### Check for outdated applications
277
376
 
278
377
  ```shell
279
- python3 versiontracker-cli.py --outdated
378
+ python3 versiontracker-cli.py --check-outdated
280
379
  ```
281
380
 
282
381
  Or if installed:
283
382
 
284
383
  ```shell
285
- versiontracker --outdated
384
+ versiontracker --check-outdated
385
+ ```
386
+
387
+ ### Audit unmanaged applications
388
+
389
+ Identify user-facing applications that aren't App Store-managed, aren't
390
+ Homebrew-owned, have no confirmed local auto-update path, and aren't
391
+ blocklisted — with full per-signal evidence rather than a bare yes/no.
392
+
393
+ ```shell
394
+ # Default view: applications needing attention or with incomplete evidence
395
+ versiontracker --audit
396
+
397
+ # Show every audited application, including already-managed ones
398
+ versiontracker --audit --all
399
+
400
+ # Show full evidence per application instead of a compact table
401
+ versiontracker --audit --explain
402
+
403
+ # Show only one audit status
404
+ versiontracker --audit --status unknown
405
+
406
+ # Export full evidence as versioned JSON
407
+ versiontracker --audit --export json --output-file audit.json
286
408
  ```
287
409
 
288
410
  ### Handle applications with auto-updates
@@ -364,8 +486,8 @@ python -m versiontracker --install-service
364
486
  # Check service status
365
487
  python -m versiontracker --service-status
366
488
 
367
- # Send notification with outdated app results
368
- python -m versiontracker --outdated --notify
489
+ # Check for outdated applications
490
+ python -m versiontracker --check-outdated
369
491
 
370
492
  # Launch menubar application for quick access
371
493
  python -m versiontracker --menubar
@@ -589,7 +711,7 @@ VersionTracker intentionally uses a heavy mocking approach to:
589
711
 
590
712
  Current Coverage Profile:
591
713
 
592
- * Reported line coverage: ≈70%+ overall
714
+ * Reported line coverage: ≈86% overall
593
715
  * Core modules (matcher, finder, config) have 78–98% coverage
594
716
  * High mock call volume for platform/network code paths ensures behavioral correctness without requiring macOS-specific execution
595
717
 
@@ -646,7 +768,7 @@ VersionTracker v1.0.0 is production-stable. All critical technical debt has been
646
768
  and the tool is fully operational on macOS. Key highlights:
647
769
 
648
770
  * **v1.0.0 released** — available on PyPI (`pip install macversiontracker`) and Homebrew
649
- * **70%+ test coverage** with 2,194+ passing tests and 0 failing tests
771
+ * **86% test coverage** with 2,477 passing tests and 0 failing tests
650
772
  * **Zero high-severity security vulnerabilities**
651
773
  * **Complete complexity resolution**: all high & medium-priority complex functions refactored
652
774
  * **Async Homebrew API**: install and update candidate checks use async operations by default
@@ -654,6 +776,25 @@ and the tool is fully operational on macOS. Key highlights:
654
776
  * **Lazy config initialisation**: no subprocess on import — fast startup
655
777
  * **Signed release artifacts**: distributions signed with Sigstore via GitHub OIDC
656
778
 
779
+ ## Known Limitations
780
+
781
+ * **macOS only** — VersionTracker runs on macOS only; Linux and Windows are not supported.
782
+ * **macOS 10.15 Catalina or later** — older releases are not tested. Tested through macOS Sequoia.
783
+ * **Homebrew required for version checks** — `--check-outdated` and `--recommend` require Homebrew;
784
+ `--apps` works without it.
785
+ * **Apple Silicon vs Intel** — both paths are detected automatically (`/opt/homebrew/bin/brew`
786
+ and `/usr/local/bin/brew`). Mixed-architecture Rosetta environments may need a manual
787
+ `--config-path` with a generated config.
788
+ * **Package managers not yet supported** — MacPorts and Mac App Store (`mas-cli`) integration
789
+ are on the roadmap. See `TODO.md → Future Enhancements`.
790
+ * **ML features require optional dependencies** — the ML matching engine (`versiontracker.ml`)
791
+ needs `numpy` and `scikit-learn`. Install with `pip install macversiontracker[ml]`.
792
+ * **Experimental modules are unstable** — `versiontracker.experimental.analytics` and
793
+ `versiontracker.experimental.benchmarks` are not wired to any CLI command and their APIs
794
+ may change without notice between minor versions.
795
+ * **16 tests skipped in default runs** — 13 ML-dep tests skip without the `[ml]` extras;
796
+ 2 platform-guard tests skip on macOS; 1 colour test skips in non-TTY environments. All expected.
797
+
657
798
  ## Recent Major Achievements (v1.0.0)
658
799
 
659
800
  * **Production release**: first stable PyPI and Homebrew release with Trusted Publisher OIDC signing
@@ -669,7 +810,6 @@ and the tool is fully operational on macOS. Key highlights:
669
810
  * Add more package managers support (MacPorts, etc.)
670
811
  * Implement automatic update capabilities for Homebrew-manageable applications
671
812
  * Add GUI interface
672
- * Raise test coverage to 85%+ across all core modules
673
813
 
674
814
  ## License
675
815