Finalize import discovery documentation and audits

records.go

@@ -212,6 +212,9 @@ type SourceInfo struct {
 	VersionCheck *SourceVersionCheck
 	// ImportSelections records completed optional declarations that selected no
 	// sources, in declaration order. Paths are local to this declaring source.
+	// Each record identifies the declaration mapping, selector, and empty outcome;
+	// it does not list candidates or explain why a path was absent. Result, error,
+	// and callback snapshots detach these records and their paths.
 	ImportSelections []ImportSelection
 }