Once it was labeled “the dirtiest harbor in America,” but decades of court-ordered cleanup have returned Boston Harbor to a premier fishing destination.