macversiontracker 1.1.0__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.1.0 → macversiontracker-1.2.0}/PKG-INFO +60 -38
  2. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/README.md +57 -33
  3. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/macversiontracker.egg-info/PKG-INFO +60 -38
  4. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/macversiontracker.egg-info/SOURCES.txt +2 -0
  5. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/macversiontracker.egg-info/requires.txt +1 -3
  6. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/pyproject.toml +9 -10
  7. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_advanced_cache.py +134 -7
  8. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_ai_module.py +24 -0
  9. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_async_homebrew.py +25 -0
  10. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_async_network.py +25 -0
  11. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_async_parity.py +1 -2
  12. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_auto_update_integration_flows.py +5 -5
  13. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_brew_candidates.py +11 -2
  14. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_cli.py +85 -0
  15. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_cli_auto_updates.py +6 -3
  16. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_export.py +58 -1
  17. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_finder_coverage.py +8 -11
  18. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_finder_new_coverage.py +75 -8
  19. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_homebrew.py +5 -5
  20. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_homebrew_advanced.py +69 -1
  21. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_int_002_recommendation.py +4 -4
  22. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_int_003_matching.py +4 -4
  23. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_int_004_async_parity.py +2 -2
  24. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_integration.py +1 -0
  25. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_macos_integration.py +130 -21
  26. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_main.py +75 -1
  27. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_matcher_coverage.py +17 -2
  28. macversiontracker-1.2.0/tests/test_menubar_app.py +162 -0
  29. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_ml_module.py +23 -16
  30. {macversiontracker-1.1.0 → 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.1.0 → macversiontracker-1.2.0}/tests/test_project_consistency.py +67 -0
  33. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_version_batch.py +21 -0
  34. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/__init__.py +1 -1
  35. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/__main__.py +10 -5
  36. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/advanced_cache.py +118 -34
  37. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/ai/__init__.py +20 -5
  38. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/apps/finder.py +48 -25
  39. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/apps/matcher.py +5 -4
  40. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/async_homebrew.py +18 -4
  41. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/async_network.py +18 -2
  42. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/cli.py +68 -4
  43. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/export.py +107 -32
  44. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/__init__.py +2 -0
  45. macversiontracker-1.2.0/versiontracker/handlers/ai_handlers.py +125 -0
  46. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/app_handlers.py +34 -13
  47. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/backup_handlers.py +2 -1
  48. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/brew_handlers.py +76 -44
  49. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/export_handlers.py +4 -4
  50. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/filter_handlers.py +17 -6
  51. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/macos_handlers.py +1 -1
  52. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/outdated_handlers.py +50 -22
  53. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/setup_handlers.py +21 -13
  54. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/utils_handlers.py +0 -43
  55. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/homebrew.py +3 -3
  56. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/macos_integration.py +25 -86
  57. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/menubar_app.py +22 -29
  58. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/ml/__init__.py +2 -2
  59. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/plugins/__init__.py +3 -4
  60. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/utils.py +43 -0
  61. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/version/batch.py +11 -6
  62. macversiontracker-1.1.0/tests/test_menubar_app.py +0 -57
  63. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/LICENSE +0 -0
  64. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/macversiontracker.egg-info/dependency_links.txt +0 -0
  65. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/macversiontracker.egg-info/entry_points.txt +0 -0
  66. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/macversiontracker.egg-info/top_level.txt +0 -0
  67. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/setup.cfg +0 -0
  68. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_additional_functions.py +0 -0
  69. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_app_store.py +0 -0
  70. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_apps.py +0 -0
  71. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_apps_coverage.py +0 -0
  72. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_apps_extra.py +0 -0
  73. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_apps_new.py +0 -0
  74. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_apps_new_pytest.py +0 -0
  75. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_async_homebrew_coverage.py +0 -0
  76. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_async_integration.py +0 -0
  77. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_auto_update_advanced.py +0 -0
  78. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_auto_update_edge_cases.py +0 -0
  79. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_auto_update_handlers.py +0 -0
  80. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_auto_update_integration.py +0 -0
  81. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_auto_update_rollback.py +0 -0
  82. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_auto_updates.py +0 -0
  83. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_brew_installability.py +0 -0
  84. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_cache.py +0 -0
  85. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_comparator_coverage.py +0 -0
  86. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_config.py +0 -0
  87. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_config_coverage.py +0 -0
  88. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_config_gaps.py +0 -0
  89. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_config_loader.py +0 -0
  90. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_config_save.py +0 -0
  91. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_config_validation_coverage.py +0 -0
  92. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_config_yaml.py +0 -0
  93. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_end_to_end_integration.py +0 -0
  94. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_enhanced_auto_update_handlers.py +0 -0
  95. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_enhanced_matching.py +0 -0
  96. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_enhanced_matching_coverage.py +0 -0
  97. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_exceptions_and_error_codes.py +0 -0
  98. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_int_001_discovery.py +0 -0
  99. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_module_lazy_imports.py +0 -0
  100. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_network_operations.py +0 -0
  101. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_parameterized_edge_cases.py +0 -0
  102. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_parameterized_version.py +0 -0
  103. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_platform_compatibility.py +0 -0
  104. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_profiling.py +0 -0
  105. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_profiling_coverage.py +0 -0
  106. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_ui.py +0 -0
  107. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_ui_enhanced.py +0 -0
  108. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_ui_new.py +0 -0
  109. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_utils.py +0 -0
  110. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_utils_comprehensive.py +0 -0
  111. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_utils_coverage.py +0 -0
  112. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_version.py +0 -0
  113. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_version_comprehensive.py +0 -0
  114. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_version_edge_cases.py +0 -0
  115. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_version_fuzzy.py +0 -0
  116. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_version_homebrew.py +0 -0
  117. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_version_legacy_coverage.py +0 -0
  118. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_version_parser.py +0 -0
  119. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/tests/test_version_utils.py +0 -0
  120. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/apps/__init__.py +0 -0
  121. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/apps/cache.py +0 -0
  122. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/audit/__init__.py +0 -0
  123. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/audit/auto_update.py +0 -0
  124. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/audit/blocklist.py +0 -0
  125. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/audit/discovery.py +0 -0
  126. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/audit/homebrew.py +0 -0
  127. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/audit/models.py +0 -0
  128. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/audit/rendering.py +0 -0
  129. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/audit/service.py +0 -0
  130. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/cache.py +0 -0
  131. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/config.py +0 -0
  132. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/deprecation.py +0 -0
  133. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/enhanced_matching.py +0 -0
  134. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/error_codes.py +0 -0
  135. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/exceptions.py +0 -0
  136. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/experimental/__init__.py +0 -0
  137. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/experimental/analytics.py +0 -0
  138. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/experimental/benchmarks.py +0 -0
  139. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/audit_handlers.py +0 -0
  140. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/auto_update_handlers.py +0 -0
  141. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/auto_update_types.py +0 -0
  142. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/config_handlers.py +0 -0
  143. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/enhanced_auto_update_handlers.py +0 -0
  144. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/error_handlers.py +0 -0
  145. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/handlers/ui_handlers.py +0 -0
  146. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/plugins/example_plugins.py +0 -0
  147. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/profiling.py +0 -0
  148. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/py.typed +0 -0
  149. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/ui.py +0 -0
  150. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/version/__init__.py +0 -0
  151. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/version/comparator.py +0 -0
  152. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/version/fuzzy.py +0 -0
  153. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/version/homebrew.py +0 -0
  154. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/version/models.py +0 -0
  155. {macversiontracker-1.1.0 → macversiontracker-1.2.0}/versiontracker/version/parser.py +0 -0
  156. {macversiontracker-1.1.0 → 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.1.0
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
@@ -37,8 +37,7 @@ 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.16.0; 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
@@ -89,31 +87,28 @@ Dynamic: license-file
89
87
 
90
88
  ### 🏗️ Build & CI/CD Pipeline
91
89
 
92
- [![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)
93
- [![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)
94
- [![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)
95
- [![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)
96
- [![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)
97
- [![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)
98
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)
99
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)
100
98
  [![PyPI](https://img.shields.io/pypi/v/macversiontracker?logo=pypi&logoColor=white&label=PyPI)](https://pypi.org/project/macversiontracker/)
101
99
 
102
100
  #### 🧪 Test Matrix
103
101
 
104
- | Platform | Python 3.12 | Python 3.13 |
105
- |----------|:-----------:|:-----------:|
106
- | **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) |
107
- | **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) |
108
106
 
109
107
  ### 🔒 Security & Quality
110
108
 
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)
112
- [![Test Coverage](https://img.shields.io/badge/Coverage-86%25-brightgreen?logo=pytest&logoColor=white)](https://github.com/docdyhr/versiontracker)
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)
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)
114
110
  [![Security: Bandit](https://img.shields.io/badge/Bandit-Passing-success?logo=python&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
115
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)
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)
117
112
 
118
113
  ### 🎨 Code Standards
119
114
 
@@ -129,7 +124,7 @@ Dynamic: license-file
129
124
  [![GitHub pull requests](https://img.shields.io/github/issues-pr/docdyhr/versiontracker?logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/pulls)
130
125
  [![GitHub forks](https://img.shields.io/github/forks/docdyhr/versiontracker?logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/network)
131
126
  [![GitHub stars](https://img.shields.io/github/stars/docdyhr/versiontracker?logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/stargazers)
132
- [![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)
133
128
  [![Contributors](https://img.shields.io/github/contributors/docdyhr/versiontracker?logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/graphs/contributors)
134
129
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?logo=opensourceinitiative&logoColor=white)](https://opensource.org/licenses/MIT)
135
130
 
@@ -145,12 +140,13 @@ Dynamic: license-file
145
140
  ---
146
141
 
147
142
  * Name: Versiontracker
148
- * Version: 1.0.0
143
+ * Version: 1.2.0
149
144
  * Programming language: Python 3.12+
150
145
  * Author: thomas
151
146
  * Purpose: CLI versiontracker and update tool for macOS
152
- * Release date: 21. Feb 2022 (Updated: April 2026)
153
- * Code Quality: **86% overall test coverage with 2,477 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),
154
150
  **all previously identified high & medium complexity issues resolved**
155
151
 
156
152
  ## Quick Start
@@ -174,15 +170,17 @@ versiontracker --check-outdated
174
170
  # Audit apps not managed by the App Store, Homebrew, or a local auto-updater
175
171
  versiontracker --audit
176
172
 
173
+ # Ask a natural-language question, routed to a supported action
174
+ versiontracker --ask "which apps need manual updates"
175
+
177
176
  # Show help
178
177
  versiontracker --help
179
178
  ```
180
179
 
181
180
  ## Overview
182
181
 
183
- Versiontracker is a command-line tool for macOS that helps you manage applications
184
- installed outside of the App Store. v1.0.0 is the first production-stable release —
185
- 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.
186
184
 
187
185
  It identifies applications that aren't managed through Apple's official channels and suggests which ones can be managed
188
186
  using Homebrew casks, making it easier to keep your applications up to date.
@@ -213,6 +211,10 @@ using Homebrew casks, making it easier to keep your applications up to date.
213
211
  * **Unmanaged application audit** (`--audit`): identifies apps with no App
214
212
  Store, Homebrew, or local auto-update coverage, with full per-signal
215
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
216
218
 
217
219
  ## Advanced Features
218
220
 
@@ -406,6 +408,7 @@ Configuration options:
406
408
  -r, --recommend return recommendations for brew
407
409
  -o, --check-outdated check for outdated applications compared to Homebrew versions
408
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
409
412
  -V, --version show program's version number and exit
410
413
  ```
411
414
 
@@ -470,6 +473,25 @@ versiontracker --audit --status unknown
470
473
  versiontracker --audit --export json --output-file audit.json
471
474
  ```
472
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"
493
+ ```
494
+
473
495
  ### Handle applications with auto-updates
474
496
 
475
497
  ```shell
@@ -772,11 +794,11 @@ VersionTracker intentionally uses a heavy mocking approach to:
772
794
  2. Deterministically simulate Homebrew and filesystem behaviors
773
795
  3. Keep test execution fast and CI-friendly
774
796
 
775
- Current Coverage Profile:
797
+ Current Coverage Profile (see the Codecov badge above for the live, up-to-date number):
776
798
 
777
- * Reported line coverage: ≈86% overall
778
- * Core modules (matcher, finder, config) have 78–98% coverage
779
- * 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
780
802
 
781
803
  Why Some Coverage Is Lower:
782
804
 
@@ -810,7 +832,7 @@ This strategy favors maintainability, determinism, and clear behavioral guarante
810
832
  VersionTracker uses GitHub Actions for continuous integration and deployment:
811
833
 
812
834
  * **Testing**: Automatically runs the test suite on multiple Python versions
813
- * **Linting**: Ensures code quality with flake8, black, and isort
835
+ * **Linting**: Enforces linting and formatting with Ruff, plus type checking with mypy
814
836
  * **Releases**: Automatically publishes new versions to PyPI when a release is created
815
837
 
816
838
  The CI/CD pipeline helps maintain code quality and ensures that the application is always in a deployable state.
@@ -827,12 +849,12 @@ be managed through Homebrew.
827
849
 
828
850
  ## Project Status
829
851
 
830
- 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
831
853
  and the tool is fully operational on macOS. Key highlights:
832
854
 
833
- * **v1.0.0 released** — available on PyPI (`pip install macversiontracker`) and Homebrew
834
- * **86% test coverage** with 2,477 passing tests and 0 failing tests
835
- * **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
836
858
  * **Complete complexity resolution**: all high & medium-priority complex functions refactored
837
859
  * **Async Homebrew API**: install and update candidate checks use async operations by default
838
860
  * **Modular architecture**: dedicated `handlers/`, `version/`, and `apps/` subpackages
@@ -855,8 +877,8 @@ and the tool is fully operational on macOS. Key highlights:
855
877
  * **Experimental modules are unstable** — `versiontracker.experimental.analytics` and
856
878
  `versiontracker.experimental.benchmarks` are not wired to any CLI command and their APIs
857
879
  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.
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.
860
882
 
861
883
  ## Recent Major Achievements (v1.0.0)
862
884
 
@@ -876,7 +898,7 @@ and the tool is fully operational on macOS. Key highlights:
876
898
 
877
899
  ## License
878
900
 
879
- [MIT](https://github.com/docdyhr/versiontracker/blob/master/LICENSE)
901
+ [MIT](https://github.com/docdyhr/versiontracker/blob/main/LICENSE)
880
902
 
881
903
  ### Blocklist Terminology Migration
882
904
 
@@ -26,31 +26,28 @@
26
26
 
27
27
  ### 🏗️ Build & CI/CD Pipeline
28
28
 
29
- [![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)
30
- [![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)
31
- [![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)
32
- [![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)
33
- [![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)
34
- [![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)
29
+ [![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)
30
+ [![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)
31
+ [![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)
32
+ [![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)
33
+ [![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)
34
+ [![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)
35
35
  [![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)
36
36
  [![Release](https://img.shields.io/github/v/release/docdyhr/versiontracker?logo=github&logoColor=white&label=Latest%20Release)](https://github.com/docdyhr/versiontracker/releases/latest)
37
37
  [![PyPI](https://img.shields.io/pypi/v/macversiontracker?logo=pypi&logoColor=white&label=PyPI)](https://pypi.org/project/macversiontracker/)
38
38
 
39
39
  #### 🧪 Test Matrix
40
40
 
41
- | Platform | Python 3.12 | Python 3.13 |
42
- |----------|:-----------:|:-----------:|
43
- | **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) |
44
- | **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) |
41
+ | Platform | Python 3.12 | Python 3.13 |
42
+ |---------- |:-----------: |:-----------: |
43
+ | **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) |
44
+ | **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) |
45
45
 
46
46
  ### 🔒 Security & Quality
47
47
 
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)
49
- [![Test Coverage](https://img.shields.io/badge/Coverage-86%25-brightgreen?logo=pytest&logoColor=white)](https://github.com/docdyhr/versiontracker)
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)
48
+ [![Code Coverage](https://img.shields.io/codecov/c/github/docdyhr/versiontracker/main?logo=codecov&logoColor=white&label=Codecov)](https://codecov.io/gh/docdyhr/versiontracker)
51
49
  [![Security: Bandit](https://img.shields.io/badge/Bandit-Passing-success?logo=python&logoColor=white)](https://github.com/docdyhr/versiontracker/actions/workflows/security.yml)
52
50
  [![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)
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)
54
51
 
55
52
  ### 🎨 Code Standards
56
53
 
@@ -66,7 +63,7 @@
66
63
  [![GitHub pull requests](https://img.shields.io/github/issues-pr/docdyhr/versiontracker?logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/pulls)
67
64
  [![GitHub forks](https://img.shields.io/github/forks/docdyhr/versiontracker?logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/network)
68
65
  [![GitHub stars](https://img.shields.io/github/stars/docdyhr/versiontracker?logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/stargazers)
69
- [![Last Commit](https://img.shields.io/github/last-commit/docdyhr/versiontracker?logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/commits/master)
66
+ [![Last Commit](https://img.shields.io/github/last-commit/docdyhr/versiontracker?logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/commits/main)
70
67
  [![Contributors](https://img.shields.io/github/contributors/docdyhr/versiontracker?logo=github&logoColor=white)](https://github.com/docdyhr/versiontracker/graphs/contributors)
71
68
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?logo=opensourceinitiative&logoColor=white)](https://opensource.org/licenses/MIT)
72
69
 
@@ -82,12 +79,13 @@
82
79
  ---
83
80
 
84
81
  * Name: Versiontracker
85
- * Version: 1.0.0
82
+ * Version: 1.2.0
86
83
  * Programming language: Python 3.12+
87
84
  * Author: thomas
88
85
  * Purpose: CLI versiontracker and update tool for macOS
89
- * Release date: 21. Feb 2022 (Updated: April 2026)
90
- * Code Quality: **86% overall test coverage with 2,477 passing tests**,
86
+ * Release date: 21. Feb 2022
87
+ * Code Quality: **comprehensive automated test suite with high branch coverage**, enforced in CI
88
+ (see the CI Pipeline and Codecov badges above),
91
89
  **all previously identified high & medium complexity issues resolved**
92
90
 
93
91
  ## Quick Start
@@ -111,15 +109,17 @@ versiontracker --check-outdated
111
109
  # Audit apps not managed by the App Store, Homebrew, or a local auto-updater
112
110
  versiontracker --audit
113
111
 
112
+ # Ask a natural-language question, routed to a supported action
113
+ versiontracker --ask "which apps need manual updates"
114
+
114
115
  # Show help
115
116
  versiontracker --help
116
117
  ```
117
118
 
118
119
  ## Overview
119
120
 
120
- Versiontracker is a command-line tool for macOS that helps you manage applications
121
- installed outside of the App Store. v1.0.0 is the first production-stable release —
122
- core CLI, config, and Homebrew integration are fully operational.
121
+ Versiontracker is a production-stable command-line tool for macOS that helps you manage applications
122
+ installed outside of the App Store — core CLI, config, and Homebrew integration are fully operational.
123
123
 
124
124
  It identifies applications that aren't managed through Apple's official channels and suggests which ones can be managed
125
125
  using Homebrew casks, making it easier to keep your applications up to date.
@@ -150,6 +150,10 @@ using Homebrew casks, making it easier to keep your applications up to date.
150
150
  * **Unmanaged application audit** (`--audit`): identifies apps with no App
151
151
  Store, Homebrew, or local auto-update coverage, with full per-signal
152
152
  evidence and JSON/YAML/CSV export
153
+ * **Natural-language queries** (`--ask`): ask plain-English questions like
154
+ "which apps need manual updates" and get routed to the matching command;
155
+ unsupported or unclear queries always print a clear message instead of
156
+ guessing
153
157
 
154
158
  ## Advanced Features
155
159
 
@@ -343,6 +347,7 @@ Configuration options:
343
347
  -r, --recommend return recommendations for brew
344
348
  -o, --check-outdated check for outdated applications compared to Homebrew versions
345
349
  --audit audit apps not managed by the App Store, Homebrew, or a local auto-updater
350
+ --ask QUERY ask a natural-language question, routed to a supported action
346
351
  -V, --version show program's version number and exit
347
352
  ```
348
353
 
@@ -407,6 +412,25 @@ versiontracker --audit --status unknown
407
412
  versiontracker --audit --export json --output-file audit.json
408
413
  ```
409
414
 
415
+ ### Ask a natural-language question
416
+
417
+ Route a plain-English query to a supported action instead of remembering the
418
+ exact flag. Recognizes a handful of phrasings for auditing, listing apps,
419
+ Homebrew recommendations, and checking for outdated apps; anything it doesn't
420
+ recognize (or isn't confident about) prints a clear message instead of
421
+ guessing.
422
+
423
+ ```shell
424
+ # Routed to --audit
425
+ versiontracker --ask "which apps need manual updates"
426
+
427
+ # Combines with modifier flags exactly like the literal flag would
428
+ versiontracker --ask "which apps need manual updates" --export json
429
+
430
+ # Routed to --apps
431
+ versiontracker --ask "list my applications"
432
+ ```
433
+
410
434
  ### Handle applications with auto-updates
411
435
 
412
436
  ```shell
@@ -709,11 +733,11 @@ VersionTracker intentionally uses a heavy mocking approach to:
709
733
  2. Deterministically simulate Homebrew and filesystem behaviors
710
734
  3. Keep test execution fast and CI-friendly
711
735
 
712
- Current Coverage Profile:
736
+ Current Coverage Profile (see the Codecov badge above for the live, up-to-date number):
713
737
 
714
- * Reported line coverage: ≈86% overall
715
- * Core modules (matcher, finder, config) have 78–98% coverage
716
- * High mock call volume for platform/network code paths ensures behavioral correctness without requiring macOS-specific execution
738
+ * Core modules (matcher, finder, config) carry the highest coverage
739
+ * High mock call volume for platform/network code paths ensures behavioral correctness without
740
+ requiring macOS-specific execution
717
741
 
718
742
  Why Some Coverage Is Lower:
719
743
 
@@ -747,7 +771,7 @@ This strategy favors maintainability, determinism, and clear behavioral guarante
747
771
  VersionTracker uses GitHub Actions for continuous integration and deployment:
748
772
 
749
773
  * **Testing**: Automatically runs the test suite on multiple Python versions
750
- * **Linting**: Ensures code quality with flake8, black, and isort
774
+ * **Linting**: Enforces linting and formatting with Ruff, plus type checking with mypy
751
775
  * **Releases**: Automatically publishes new versions to PyPI when a release is created
752
776
 
753
777
  The CI/CD pipeline helps maintain code quality and ensures that the application is always in a deployable state.
@@ -764,12 +788,12 @@ be managed through Homebrew.
764
788
 
765
789
  ## Project Status
766
790
 
767
- VersionTracker v1.0.0 is production-stable. All critical technical debt has been resolved
791
+ VersionTracker is production-stable. All critical technical debt has been resolved
768
792
  and the tool is fully operational on macOS. Key highlights:
769
793
 
770
- * **v1.0.0 released** — available on PyPI (`pip install macversiontracker`) and Homebrew
771
- * **86% test coverage** with 2,477 passing tests and 0 failing tests
772
- * **Zero high-severity security vulnerabilities**
794
+ * **Actively maintained** — available on PyPI (`pip install macversiontracker`) and Homebrew
795
+ * **Comprehensive automated test suite** with high branch coverage, enforced in CI (see badges above)
796
+ * **Zero high-severity security vulnerabilities** — enforced by the required Security Analysis CI check
773
797
  * **Complete complexity resolution**: all high & medium-priority complex functions refactored
774
798
  * **Async Homebrew API**: install and update candidate checks use async operations by default
775
799
  * **Modular architecture**: dedicated `handlers/`, `version/`, and `apps/` subpackages
@@ -792,8 +816,8 @@ and the tool is fully operational on macOS. Key highlights:
792
816
  * **Experimental modules are unstable** — `versiontracker.experimental.analytics` and
793
817
  `versiontracker.experimental.benchmarks` are not wired to any CLI command and their APIs
794
818
  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.
819
+ * **A small number of tests are skipped in default runs** — ML-dep tests skip without the `[ml]`
820
+ extras; platform-guard tests skip on macOS; a colour test skips in non-TTY environments. All expected.
797
821
 
798
822
  ## Recent Major Achievements (v1.0.0)
799
823
 
@@ -813,7 +837,7 @@ and the tool is fully operational on macOS. Key highlights:
813
837
 
814
838
  ## License
815
839
 
816
- [MIT](https://github.com/docdyhr/versiontracker/blob/master/LICENSE)
840
+ [MIT](https://github.com/docdyhr/versiontracker/blob/main/LICENSE)
817
841
 
818
842
  ### Blocklist Terminology Migration
819
843