# User Privacy & System Cleanliness

## What We Install

4runr-os **only installs what's necessary** and **respects your system**:

### ✅ What Gets Installed (Only if Missing)

1. **Rust** (optional)
   - Only if not already installed
   - **User must install manually** (we provide instructions, don't auto-install)
   - Required for building mk3-tui binary

2. **MinGW/MSYS2** (Windows only, optional)
   - Only if MSVC linker not available
   - Only if not already installed
   - Used for Rust GNU toolchain on Windows

3. **mk3-tui Binary**
   - Built from source included in package
   - Only if pre-built binary not available
   - Stored in package directory (not system directories)

### ✅ What We Never Do

- ❌ Never install system-wide software without user consent
- ❌ Never modify system PATH permanently without asking
- ❌ Never download large files unnecessarily
- ❌ Never leave temporary files on your system
- ❌ Never modify registry or system settings
- ❌ Never auto-install Rust (user must do it manually)

### 🧹 Automatic Cleanup

The package automatically cleans up:

1. **Build Artifacts** (after building)
   - Removes Rust debug builds (~200-300MB saved)
   - Removes incremental compilation artifacts
   - Keeps only the final release binary

2. **Old Versions** (during updates)
   - Removes old npm package versions (keeps last 2)
   - Prevents disk space overflow from version history

3. **No Temporary Files**
   - All operations use existing directories
   - No temp files created or left behind

### 📦 Package Contents

The npm package includes:
- ✅ Compiled TypeScript (dist/)
- ✅ Rust source code (for building if needed)
- ✅ Setup scripts (for one-time setup)
- ❌ Build artifacts (excluded via .npmignore)
- ❌ Source TypeScript (excluded - only dist/ included)
- ❌ Development files

### 🔒 What We Touch

**User's System:**
- ✅ npm global install directory (standard npm location)
- ✅ PATH environment variable (session-only, unless user approves permanent)
- ❌ System directories (we never touch system files)
- ❌ Registry/configuration files (Windows)
- ❌ User's home directory (except standard npm locations)

**User's Data:**
- ✅ Configuration file: `~/.4runr/config.json` (for user preferences)
- ❌ User's files or documents (never accessed)
- ❌ Browser data or history (never accessed)
- ❌ Personal information (never collected)

### 🛡️ Privacy Guarantee

- No telemetry or tracking
- No data collection
- No external network calls (except npm registry for updates)
- All operations are local

