Build Integrity Report
Permalink:
https://hvtracker.net/spec/build-report/v0.1
1. Purpose
The build integrity report provides a machine-readable summary of each HVTracker data pipeline run. It answers: "What exactly was generated, from what source, how many succeeded, and what failed?"
If HVTracker is to serve as a trust registry, its own data pipeline must be transparent. This report is the self-audit.
2. Endpoint
GET /data/build_report.json
Generated during every cron run by fetch_and_build.py. Refreshes daily at 06:00 UTC alongside all other data endpoints.
3. Fields
| Field | Type | Description |
|---|---|---|
generated_at | string (ISO 8601) | Timestamp when the report was generated |
data_timestamp | string | Human-readable timestamp shown on the leaderboard |
schema_version | string | Data schema version (e.g. "v0.1") |
methodology_version | string | Methodology version (e.g. "v2.0") |
configured_agents | integer | Total entries in agents.json (active + legacy) |
active_agents | integer | Successfully fetched and scored agents |
legacy_agents | integer | Legacy agents (inactive ≥365 days, rendered separately) |
total_generated | integer | Total agent profile pages generated (active + legacy) |
categories | object | Map of category name → agent count |
warnings | array | Eligibility violations (criterion, repo, detail) |
warning_count | integer | Number of eligibility warnings |
failed_fetches | array | Repos that could not be fetched (404, rate limit, etc.) |
missing_repos_count | integer | Count of failed fetches |
package_failures | array | Repos with configured package but no download data |
package_failure_count | integer | Count of package lookup failures |
scorecard_unavailable_count | integer | Agents without OSSF Scorecard data |
fingerprint_agents | array | Repos with fingerprint-based action tracking configured |
fingerprint_agent_count | integer | Count of fingerprint-tracked agents |
4. Usage
Consumers can use this report to:
- Monitor pipeline health (failed fetch count trending up = API issue)
- Verify data freshness (compare
generated_atagainst expectations) - Audit signal coverage (scorecard unavailable count, package failures)
- Track growth (configured vs active agents over time)
This report is public. It is part of HVTracker's commitment to transparent data sourcing.