exe-watcher 0.2.70 → 0.2.72

package/README.md

@@ -403,6 +403,28 @@ For unfiltered All Time Claude totals, Watcher also reconciles `stats-cache.json
 | `XDG_CONFIG_HOME` | Base directory for Watcher configuration (default: `~/.config`) |
 | `EXE_WATCHER_CACHE_DIR` | Override cache directory (default: `~/.cache/exe-watcher`) |
 
+### Optional analytics and error reporting
+
+Watcher uses our self-hosted PostHog and Sentry through `https://data.odd.community`.
+Basic usage statistics default on after a first-run disclosure. Sanitized error
+diagnostics are a separate, optional choice and default off. Existing opt-outs
+are preserved. In the Mac app, find both controls under the Settings gear. In the CLI:
+
+```sh
+exe-watcher telemetry --usage on --errors on
+exe-watcher telemetry --usage off --errors off
+```
+
+Usage counts participating installations, foreground feature use, active Mac menu
+time, and fixed success/failure outcomes, with numeric app version and coarse
+platform metadata. Recording time is N/A. Errors include only category, class and app version.
+No prompts, usage logs, project names, paths, spend, raw error text, native crash
+dumps, screenshots or replay are sent. Background CLI scans do not count as use.
+`DO_NOT_TRACK=1` or `EXE_WATCHER_TELEMETRY=0` disables collection. Turning a control
+off clears its unsent queue; received reports remain. Our collector receives your
+connection IP but does not forward it to PostHog/Sentry. No project keys are needed.
+See [privacy, retry behavior and operator setup](docs/analytics/README.md).
+
 ---
 
 ## Contributing

package/THIRD_PARTY_NOTICES.md

@@ -35,3 +35,10 @@ SOFTWARE.
 ```
 
 Runtime dependencies and other bundled assets retain their own licenses. This CodeBurn notice does not replace them. Check the applicable upstream notices before importing further code or assets; current CodeBurn includes components with additional third-party terms.
+
+## Odd Core Analytics
+
+The CLI bundles the MIT-licensed `@odd-core/analytics/privacy` implementation.
+The pinned source and artifact hashes are in `vendor/odd-core-analytics/PROVENANCE.json`;
+its full license is included at `vendor/odd-core-analytics/LICENSE`. The native
+Swift adapter follows the same restricted collection protocol.