| Version | Supported |
|---|---|
| 1.0.x | ✅ |
Report vulnerabilities by opening a GitHub Issue with the label security.
Do not submit via email or public channels. We'll respond within 48 hours with a triage plan and expected fix timeline.
- No telemetry. Regtrace never phones home, collects usage stats, or sends analytics.
- Deterministic metrics (format, factuality shallow mode, tone fallback, regression) run locally. No data leaves your machine.
- LLM-judged metrics (factuality deep mode, tone with LLM) send response text to the configured provider's API endpoint. You control the provider and model.
- API keys are read from
.envor environment variables — never stored in config files, golden sets, or run records.
- Releases are built by GitHub Actions from tagged commits. The workflow is defined in
.github/workflows/release.yml. - Binaries are self-contained (Bun
--compileoutput). No runtime dependencies, no npm install on target machines. - Verify download integrity by comparing against the SHA in the release notes.
.envfiles are loaded from the working directory. Keep them out of version control (.gitignoreis created byregtrace init).- Config files (
regtrace.config.yaml) are validated against Zod schemas at startup. Malformed configs produce clear error messages and refuse to run.
- Use dedicated API keys with minimum required permissions for each LLM provider.
- Run in CI with
--format jsonfor machine-readable pass/fail output. - Pin your judge provider version to avoid unexpected behavior from model updates.