docs: overhaul README to clarify wrapper nature and add telemetry disclosure (#28)

* chore(deps): lock file maintenance (#16)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): lock file maintenance (#17)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>

* chore(deps): lock file maintenance (#21)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: Michael <michael.l.dangelo@gmail.com>

* chore(deps): lock file maintenance (#23)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: Michael <michael.l.dangelo@gmail.com>

* chore(deps): lock file maintenance (#24)

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: Michael <michael.l.dangelo@gmail.com>

* docs: overhaul README to clarify wrapper nature and add telemetry disclosure

- Reframe repo as a thin pip wrapper pointing to promptfoo/promptfoo
  as the source of truth for all features and documentation
- Add telemetry disclosure section documenting what is collected,
  where it goes, and how to disable it (PROMPTFOO_DISABLE_TELEMETRY=1)
- Update version pinning docs now that PROMPTFOO_VERSION is implemented
- Simplify structure: less marketing copy, more actionable guidance
- Direct users to the main project for features/bugs

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* docs: add telemetry disclosure, fix contributing links, minor cleanup

- Add telemetry section documenting what is collected and how to
  opt out (PROMPTFOO_DISABLE_TELEMETRY=1)
- Update contributing section to split wrapper issues (here) vs.
  promptfoo features/bugs (promptfoo/promptfoo) and link to CONTRIBUTING.md
- Remove unnecessary version pin from requirements.txt example
- Fix bare nodejs.org URL to markdown link

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

---------

Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: 3 people

README.md

@@ -142,7 +142,7 @@ poetry run promptfoo eval
 ### With requirements.txt
 
 ```bash
-echo "promptfoo>=0.2.0" >> requirements.txt
+echo "promptfoo" >> requirements.txt
 pip install -r requirements.txt
 promptfoo eval
 ```
@@ -180,7 +180,7 @@ The wrapper needs Node.js to run. Install it:
 
 - **macOS**: `brew install node`
 - **Ubuntu/Debian**: `sudo apt install nodejs npm`
-- **Windows**: Download from https://nodejs.org/
+- **Windows**: Download from [nodejs.org](https://nodejs.org/)
 - **Any OS**: Use [nvm](https://github.com/nvm-sh/nvm)
 
 ### Slow First Run
@@ -210,14 +210,25 @@ Or install a specific version globally:
 npm install -g promptfoo@0.95.0
 ```
 
+### Telemetry
+
+This wrapper collects anonymous usage telemetry to help improve the package, mirroring the telemetry in the main promptfoo project.
+
+**What is collected:** A random anonymous user ID, wrapper version, Python version, and whether you're running in CI. If you've previously logged into promptfoo and your email is stored in `~/.promptfoo/promptfoo.yaml`, that is also sent.
+
+**To opt out:**
+
+```bash
+export PROMPTFOO_DISABLE_TELEMETRY=1
+```
+
 ## Contributing
 
-We welcome contributions! Check out our [contributing guide](https://www.promptfoo.dev/docs/contributing/) to get started.
+**For promptfoo features, docs, and bugs:** contribute to [promptfoo/promptfoo](https://github.com/promptfoo/promptfoo).
 
-Join our [Discord community](https://discord.gg/promptfoo) for help and discussion.
+**For pip wrapper issues** (installation, Python shim, CI integration): open issues here. See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup.
 
-**For wrapper-specific issues**: Report them in this repository
-**For promptfoo features/bugs**: Report in the [main project](https://github.com/promptfoo/promptfoo)
+Join our [Discord community](https://discord.gg/promptfoo) for help and discussion.
 
 <a href="https://github.com/promptfoo/promptfoo/graphs/contributors">
   <img src="https://contrib.rocks/image?repo=promptfoo/promptfoo" />