i just found my previous answer here, which i probably should have put in the design doc (and will now): https://github.com/pantsbuild/pants/pull/16755#discussion_r965159142