activity-driver 1.0.0__tar.gz

activity_driver-1.0.0/LICENSE

@@ -0,0 +1,11 @@
+PROPRIETARY LICENSE
+
+Copyright (c) 2024 Coty Engineering
+
+This software is proprietary and confidential. All rights reserved.
+
+Permission is hereby granted to Coty employees and authorized contractors to use this software internally for business purposes only.
+
+Redistribution, modification, or use outside of Coty Engineering is strictly prohibited without written consent from Coty Engineering management.
+
+THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.

activity_driver-1.0.0/MANIFEST.in

@@ -0,0 +1,5 @@
+include README.md
+include LICENSE
+include requirements.txt
+recursive-include src *.py
+recursive-include scripts *.sh

activity_driver-1.0.0/PKG-INFO

@@ -0,0 +1,315 @@
+Metadata-Version: 2.4
+Name: activity-driver
+Version: 1.0.0
+Summary: Simulates realistic user activity for Prohance tracking on macOS
+Home-page: https://github.com/coty/activity-driver
+Author: Coty Engineering
+Author-email: Coty Engineering <engineering@coty.com>
+License: Proprietary
+Project-URL: Homepage, https://github.com/coty/activity-driver
+Project-URL: Documentation, https://github.com/coty/activity-driver#readme
+Project-URL: Bug Reports, https://github.com/coty/activity-driver/issues
+Project-URL: Repository, https://github.com/coty/activity-driver.git
+Keywords: activity,driver,prohance,automation,macOS,productivity
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: System :: Monitoring
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyautogui>=0.9.54
+Requires-Dist: pyobjc-framework-Quartz>=9.0; sys_platform == "darwin"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=3.0; extra == "dev"
+Requires-Dist: black>=22.0; extra == "dev"
+Requires-Dist: flake8>=4.0; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# Activity Driver
+
+Simulates realistic user activity (browser, file, HID mouse/keyboard events) for Prohance tracking on macOS. Prevents macOS idle sleep and auto-logout via `caffeinate`. Includes a live dashboard at **http://localhost:3006**.
+
+## Overview
+
+**Activity Driver** is a Python library designed to keep your Prohance tracking active by simulating realistic work activity. It includes:
+
+- **Activity Driver** — Core event simulation engine (browser, file, HID events)
+- **HID Events** — Real OS-level HID event generation via macOS Quartz
+- **Daily Report** — Live HTML dashboard showing activity metrics
+- **Launcher** — Orchestrates Activity Driver + Daily Report together
+
+---
+
+## Installation
+
+### System-Wide Install (Recommended)
+
+```bash
+pip install /path/to/activity-driver
+```
+
+Or install from GitHub:
+
+```bash
+pip install git+https://github.com/coty/activity-driver.git
+```
+
+### Development Install (editable)
+
+```bash
+pip install -e /path/to/activity-driver
+```
+
+### Verify Installation
+
+```bash
+python -c "import activity_driver; print(activity_driver.__version__)"
+```
+
+---
+
+## Quick Start
+
+### Run All Components (Driver + Dashboard)
+
+```bash
+activity-launcher
+```
+
+This will:
+1. Start the Activity Driver in the background
+2. Start the Daily Report dashboard on http://localhost:3006
+3. Auto-open your browser to the dashboard
+
+**Stop with Ctrl-C**
+
+### Run Individual Components
+
+**Activity Driver only:**
+```bash
+activity-driver
+```
+
+**Daily Report only (on custom port):**
+```bash
+activity-report 8080
+```
+
+**From Python:**
+```python
+from activity_driver.activity_driver import main
+main()
+```
+
+---
+
+## Configuration
+
+During installation (`bash scripts/setup.sh`), you'll be asked for:
+
+1. **Productive Domains** — URLs where you work (e.g., GitHub, Jira, Confluence)
+2. **Chrome Profile** — Which Chrome profile to use (find at `chrome://version`)
+
+Settings are saved to `~/.config/activity-driver/config.json` and automatically used by the driver.
+
+### Manage Configuration Anytime
+
+```bash
+activity-config show        # Display current config
+activity-config domains     # Edit productive URLs
+activity-config profile     # Change Chrome profile
+activity-config reset       # Reset to defaults
+```
+
+For detailed configuration guide: [CONFIG.md](CONFIG.md)
+
+---
+
+## Customization
+
+## Permissions
+
+### Accessibility (Optional)
+
+For keyboard clicks to work, grant Accessibility permission:
+
+1. **System Settings → Security & Privacy → Privacy → Accessibility**
+2. Add your Python interpreter or terminal app
+3. Restart the driver
+
+**Without Accessibility:** Mouse movement and scroll events still work, which is sufficient for Prohance.
+
+### Chrome Profile Access
+
+The driver must be able to open Chrome. Ensure your profile is accessible in `/Users/$USER/Library/Application\ Support/Google/Chrome/`
+
+---
+
+## Dashboard Features
+
+The live dashboard at `http://localhost:3006` shows:
+
+- **Total events** — Total activity count for today/yesterday
+- **Event breakdown** — Browser (unique/repeated), file writes, app switches
+- **Top URLs** — Most frequently visited domains
+- **Hourly activity** — Bar chart of events per hour
+- **Active window** — First and last activity timestamps
+- **Auto-purge** — Logs older than 2 days are automatically removed
+
+Dashboard auto-refreshes every 30 seconds.
+
+---
+
+## Technical Details
+
+### HID Event Generation
+
+Real OS-level events via macOS Quartz API:
+
+| Event | Permission | Recognized by Prohance |
+|-------|-----------|----------------------|
+| Mouse move | ✅ NO Accessibility | ✅ Yes (resets HIDIdleTime) |
+| Scroll wheel | ✅ NO Accessibility | ✅ Yes |
+| Click | ⚠️ Accessibility required | ✅ Yes |
+| Keyboard | ⚠️ Accessibility required | ✅ Yes |
+
+Without Accessibility, mouse + scroll events are sufficient to reset Prohance idle timers.
+
+### Idle Prevention
+
+- **Heartbeat** — `caffeinate -u` runs every 25 seconds to assert user activity
+- **Anti-idle** — Guaranteed lightweight event every 90 seconds during reads
+- **No gaps** — Events spaced to ensure continuous activity detection
+
+### Log Format
+
+Events are stored in `.session_data` as JSON:
+
+```json
+{
+  "ts": "2026-06-18T14:23:45",
+  "date": "2026-06-18",
+  "hour": 14,
+  "type": "BROWSER",
+  "label": "repeated",
+  "detail": "https://coty-my.sharepoint.com/shared"
+}
+```
+
+**Retention:** 2 days (auto-purged)
+
+---
+
+## Troubleshooting
+
+### "WARNING: Quartz not available"
+
+Install the required dependency:
+
+```bash
+pip install pyobjc-framework-Quartz
+```
+
+### Dashboard not loading
+
+Check the port isn't in use:
+
+```bash
+lsof -i :3006
+```
+
+Use a custom port:
+
+```bash
+activity-report 8080
+```
+
+### Chrome not opening URLs
+
+1. Verify Chrome is installed at `/Applications/Google Chrome.app`
+2. Check your Chrome profile name at `chrome://version`
+3. Update `CHROME_PROFILE` in the driver config
+
+### Accessibility permission missing
+
+Grant Accessibility permission in **System Settings → Security & Privacy → Privacy**
+
+---
+
+## Development
+
+### Install for Development
+
+```bash
+pip install -e ".[dev]"
+```
+
+### Run Tests
+
+```bash
+pytest -v
+pytest --cov=src/activity_driver
+```
+
+### Code Style
+
+Format with Black:
+
+```bash
+black src/
+```
+
+Lint with Flake8:
+
+```bash
+flake8 src/
+```
+
+---
+
+## Uninstall
+
+```bash
+pip uninstall activity-driver
+```
+
+---
+
+## License
+
+Proprietary — Coty Engineering. All rights reserved.
+
+---
+
+## Support
+
+For issues, feature requests, or questions:
+
+- **GitHub Issues:** https://github.com/coty/activity-driver/issues
+- **Email:** engineering@coty.com
+
+---
+
+## Version History
+
+### 1.0.0 (2026-06-18)
+
+- Initial release
+- Activity Driver core engine
+- HID event generation (Quartz)
+- Daily Report dashboard
+- Launcher orchestrator
+- macOS LaunchAgent support (via setup.sh)

activity_driver-1.0.0/README.md

@@ -0,0 +1,275 @@
+# Activity Driver
+
+Simulates realistic user activity (browser, file, HID mouse/keyboard events) for Prohance tracking on macOS. Prevents macOS idle sleep and auto-logout via `caffeinate`. Includes a live dashboard at **http://localhost:3006**.
+
+## Overview
+
+**Activity Driver** is a Python library designed to keep your Prohance tracking active by simulating realistic work activity. It includes:
+
+- **Activity Driver** — Core event simulation engine (browser, file, HID events)
+- **HID Events** — Real OS-level HID event generation via macOS Quartz
+- **Daily Report** — Live HTML dashboard showing activity metrics
+- **Launcher** — Orchestrates Activity Driver + Daily Report together
+
+---
+
+## Installation
+
+### System-Wide Install (Recommended)
+
+```bash
+pip install /path/to/activity-driver
+```
+
+Or install from GitHub:
+
+```bash
+pip install git+https://github.com/coty/activity-driver.git
+```
+
+### Development Install (editable)
+
+```bash
+pip install -e /path/to/activity-driver
+```
+
+### Verify Installation
+
+```bash
+python -c "import activity_driver; print(activity_driver.__version__)"
+```
+
+---
+
+## Quick Start
+
+### Run All Components (Driver + Dashboard)
+
+```bash
+activity-launcher
+```
+
+This will:
+1. Start the Activity Driver in the background
+2. Start the Daily Report dashboard on http://localhost:3006
+3. Auto-open your browser to the dashboard
+
+**Stop with Ctrl-C**
+
+### Run Individual Components
+
+**Activity Driver only:**
+```bash
+activity-driver
+```
+
+**Daily Report only (on custom port):**
+```bash
+activity-report 8080
+```
+
+**From Python:**
+```python
+from activity_driver.activity_driver import main
+main()
+```
+
+---
+
+## Configuration
+
+During installation (`bash scripts/setup.sh`), you'll be asked for:
+
+1. **Productive Domains** — URLs where you work (e.g., GitHub, Jira, Confluence)
+2. **Chrome Profile** — Which Chrome profile to use (find at `chrome://version`)
+
+Settings are saved to `~/.config/activity-driver/config.json` and automatically used by the driver.
+
+### Manage Configuration Anytime
+
+```bash
+activity-config show        # Display current config
+activity-config domains     # Edit productive URLs
+activity-config profile     # Change Chrome profile
+activity-config reset       # Reset to defaults
+```
+
+For detailed configuration guide: [CONFIG.md](CONFIG.md)
+
+---
+
+## Customization
+
+## Permissions
+
+### Accessibility (Optional)
+
+For keyboard clicks to work, grant Accessibility permission:
+
+1. **System Settings → Security & Privacy → Privacy → Accessibility**
+2. Add your Python interpreter or terminal app
+3. Restart the driver
+
+**Without Accessibility:** Mouse movement and scroll events still work, which is sufficient for Prohance.
+
+### Chrome Profile Access
+
+The driver must be able to open Chrome. Ensure your profile is accessible in `/Users/$USER/Library/Application\ Support/Google/Chrome/`
+
+---
+
+## Dashboard Features
+
+The live dashboard at `http://localhost:3006` shows:
+
+- **Total events** — Total activity count for today/yesterday
+- **Event breakdown** — Browser (unique/repeated), file writes, app switches
+- **Top URLs** — Most frequently visited domains
+- **Hourly activity** — Bar chart of events per hour
+- **Active window** — First and last activity timestamps
+- **Auto-purge** — Logs older than 2 days are automatically removed
+
+Dashboard auto-refreshes every 30 seconds.
+
+---
+
+## Technical Details
+
+### HID Event Generation
+
+Real OS-level events via macOS Quartz API:
+
+| Event | Permission | Recognized by Prohance |
+|-------|-----------|----------------------|
+| Mouse move | ✅ NO Accessibility | ✅ Yes (resets HIDIdleTime) |
+| Scroll wheel | ✅ NO Accessibility | ✅ Yes |
+| Click | ⚠️ Accessibility required | ✅ Yes |
+| Keyboard | ⚠️ Accessibility required | ✅ Yes |
+
+Without Accessibility, mouse + scroll events are sufficient to reset Prohance idle timers.
+
+### Idle Prevention
+
+- **Heartbeat** — `caffeinate -u` runs every 25 seconds to assert user activity
+- **Anti-idle** — Guaranteed lightweight event every 90 seconds during reads
+- **No gaps** — Events spaced to ensure continuous activity detection
+
+### Log Format
+
+Events are stored in `.session_data` as JSON:
+
+```json
+{
+  "ts": "2026-06-18T14:23:45",
+  "date": "2026-06-18",
+  "hour": 14,
+  "type": "BROWSER",
+  "label": "repeated",
+  "detail": "https://coty-my.sharepoint.com/shared"
+}
+```
+
+**Retention:** 2 days (auto-purged)
+
+---
+
+## Troubleshooting
+
+### "WARNING: Quartz not available"
+
+Install the required dependency:
+
+```bash
+pip install pyobjc-framework-Quartz
+```
+
+### Dashboard not loading
+
+Check the port isn't in use:
+
+```bash
+lsof -i :3006
+```
+
+Use a custom port:
+
+```bash
+activity-report 8080
+```
+
+### Chrome not opening URLs
+
+1. Verify Chrome is installed at `/Applications/Google Chrome.app`
+2. Check your Chrome profile name at `chrome://version`
+3. Update `CHROME_PROFILE` in the driver config
+
+### Accessibility permission missing
+
+Grant Accessibility permission in **System Settings → Security & Privacy → Privacy**
+
+---
+
+## Development
+
+### Install for Development
+
+```bash
+pip install -e ".[dev]"
+```
+
+### Run Tests
+
+```bash
+pytest -v
+pytest --cov=src/activity_driver
+```
+
+### Code Style
+
+Format with Black:
+
+```bash
+black src/
+```
+
+Lint with Flake8:
+
+```bash
+flake8 src/
+```
+
+---
+
+## Uninstall
+
+```bash
+pip uninstall activity-driver
+```
+
+---
+
+## License
+
+Proprietary — Coty Engineering. All rights reserved.
+
+---
+
+## Support
+
+For issues, feature requests, or questions:
+
+- **GitHub Issues:** https://github.com/coty/activity-driver/issues
+- **Email:** engineering@coty.com
+
+---
+
+## Version History
+
+### 1.0.0 (2026-06-18)
+
+- Initial release
+- Activity Driver core engine
+- HID event generation (Quartz)
+- Daily Report dashboard
+- Launcher orchestrator
+- macOS LaunchAgent support (via setup.sh)

activity_driver-1.0.0/pyproject.toml

@@ -0,0 +1,69 @@
+[build-system]
+requires = ["setuptools>=45", "wheel", "setuptools_scm[toml]>=6.2"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "activity-driver"
+version = "1.0.0"
+description = "Simulates realistic user activity for Prohance tracking on macOS"
+readme = "README.md"
+requires-python = ">=3.9"
+license = {text = "Proprietary"}
+authors = [
+    {name = "Coty Engineering", email = "engineering@coty.com"}
+]
+keywords = ["activity", "driver", "prohance", "automation", "macOS", "productivity"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: System Administrators",
+    "License :: Other/Proprietary License",
+    "Operating System :: MacOS",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: System :: Monitoring",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "pyautogui>=0.9.54",
+    "pyobjc-framework-Quartz>=9.0; sys_platform == 'darwin'",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-cov>=3.0",
+    "black>=22.0",
+    "flake8>=4.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/coty/activity-driver"
+Documentation = "https://github.com/coty/activity-driver#readme"
+"Bug Reports" = "https://github.com/coty/activity-driver/issues"
+Repository = "https://github.com/coty/activity-driver.git"
+
+[project.scripts]
+activity-driver = "activity_driver.activity_driver:main"
+activity-report = "activity_driver.daily_report:main"
+activity-launcher = "activity_driver.launcher:main"
+activity-config = "activity_driver.config:cli_main"
+
+[tool.setuptools]
+zip-safe = false
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.black]
+line-length = 100
+target-version = ['py39', 'py310', 'py311', 'py312']
+
+[tool.isort]
+profile = "black"
+line_length = 100
+python_version = "39"

activity_driver-1.0.0/requirements.txt

@@ -0,0 +1,19 @@
+# ──────────────────────────────────────────────
+#  Prohance Activity Simulator — Dependencies
+#  Python >= 3.9
+# ──────────────────────────────────────────────
+
+# GUI automation (keyboard typing + mouse movement)
+# Requires macOS Accessibility permission:
+#   System Preferences → Security & Privacy → Privacy → Accessibility
+pyautogui>=0.9.54
+
+# macOS native HID event generation (REAL user input, not synthetic)
+# Generates actual OS-level keyboard/mouse events recognized by Prohance
+pyobjc-framework-Quartz>=9.0; sys_platform == "darwin"
+
+# Optional: structured logging (swap print() for richer output)
+# loguru>=0.7.2
+
+# Optional: rich terminal output / progress display
+# rich>=13.0.0