build(dev): generate a 50k-track library and measure a running app

Plan 007 phase 4 is verified by measurement, not by assertion, and
there was no way to produce a number: the fixture library is a few
dozen tracks and cannot show any of the findings.

- `cmd/gentestdata -bulk N` (`make bulkdata`) writes a ~50 000-track
  library in 11 s / 466 MB by encoding six clips once and copying
  them, while still tagging every file through `backend/tagwriter` —
  a library the app cannot read back measures nothing.
- `make sandbox-seed-bulk` seeds from it through the same script and
  the same discipline as any other seed: by running the app and
  waiting for the real scan.
- `e2e/perf/measure.mjs` (`make perf LABEL=x`, `make perf-compare`)
  takes fourteen measurements against a running app and writes them
  to a gitignored `.dev/perf/<label>.json`. It wraps every bound Go
  method, so "did that refetch the library" is a fact rather than an
  inference, and records `longtask` entries, which is where a 25 MB
  JSON parse on the main thread shows up and nowhere else.

It is not a spec and does not run in CI.
This commit is contained in:
2026-08-12 01:17:33 -04:00
parent 7de1b4edc1
commit da564f9659
7 changed files with 2592 additions and 17 deletions
+13 -9
View File
@@ -34,15 +34,19 @@ type manifestTrack struct {
// stamps its own encoder strings, so byte hashes differ between ffmpeg
// builds while the fixtures they describe are identical.
type manifest struct {
Version int `json:"version"`
Generator string `json:"generator"`
Hash string `json:"hash"`
LibraryRoot string `json:"libraryRoot"`
BrokenRoot string `json:"brokenRoot"`
Cases map[string][]string `json:"cases"`
Tracks []manifestTrack `json:"tracks"`
Extras []string `json:"extras"`
Broken []string `json:"broken"`
Version int `json:"version"`
Generator string `json:"generator"`
Hash string `json:"hash"`
LibraryRoot string `json:"libraryRoot"`
BrokenRoot string `json:"brokenRoot"`
// TrackCount is written by the bulk library, which has tens of
// thousands of tracks and no reason to describe each one: nothing
// selects a bulk track by name, only the total matters.
TrackCount int `json:"trackCount,omitempty"`
Cases map[string][]string `json:"cases"`
Tracks []manifestTrack `json:"tracks"`
Extras []string `json:"extras"`
Broken []string `json:"broken"`
}
// buildManifest derives the manifest from the spec alone. It runs