nah, the agents jump around files anyways.

I’ve been doing the least amount of unit tests possible and doing debug asserts instead.

Normally I would put as many invariants in the types as possible, then tests cover the rest. I'm curious how you do this/what you use it for though. Would be cool if you had any examples.

It’s about the best possible documentation.

It isn't documentation. It is example code, in the best case. That shit belongs in other files, not in the main file. There is also a reason why literate programming never took off in general. Good luck getting anything done when 80% (conservatively) of the stuff you have to scroll through contributes nothing to the actual execution of the program and might actually be giving you false impressions of how things need to be done.

I have yet to see a single Rust file where the test comes before source and takes 80% of the file content.

Probably because all the tests are trivial, and people have the bias to not add all the testing that is needed inline with the code.