Skip to content

The representative flag

A preset may declare representative = true. It marks the preset as one of its family’s samples for the per-phase test tier the dev lane runs while implementing a plan. Absent means false.

It does not change what ships, what the preset looks like, or what gates it. The plan-close run and CI render the whole library exactly as before, so the behavioral suite that lets this lane land presets without dev couriering them keeps its full strength. The only thing the flag moves is when a defect in a non-representative preset is noticed: at the close rather than at the phase that caused it.

The floor is gated; staleness is not. A test fails if any family carries fewer than two representatives, naming the family — so the sample cannot decay to nothing as content lands. Nothing checks whether the two are still representative of a family that has grown around them. That is a curation duty at the plan-close cadence, with no gate behind it, and it is said here rather than assumed.

Flipping the flag renames that preset’s generated tests (they carry a rep_ marker so a static nextest filter can select the sample), which is worth knowing before bisecting across a change to it.

Built from a8ce055 at version 0.115.0. This site tracks main and is not versioned per release.