Finalize import discovery documentation and audits

internal/engine/glob.go

@@ -31,6 +31,8 @@ func selectGlobImportCandidates(access *filesystemAccess, basePath string, spec
 	for index, segment := range segments {
 		last := index == len(segments)-1
 		literal, patterned := globLiteralSegment(segment)
+		// nextByPath is the set union of candidates reached from each matching
+		// parent at this segment; final exclusions below are set difference.
 		nextByPath := make(map[string]selectedImportCandidate)
 		for _, parent := range candidates {
 			if !patterned {