* create initial migrator directory structure

* add class to read in csv ranges file

* rework of MetadataReader class to be more scalable

* add initial MetadataReader test

* changes based on PR comments

* rename regionCode -> countryCode / testFile updates

* updates to MetadataReader based on pr comments

* use Truth8 for clearer tests

* code cleanup

* tests updated

* creation of command line entry point

* additon of schema to read recipes.csv files

* creation of migration job class

* use picoli api to retrieve user arguments

* add methods to check for possible migrations

* additon of comments to classes

* addition of tests for classes

* custom recipe file constructors to allow for tests

* code cleanup

* newline

* reformat comments and add examples to descriptions

* include migration factory,comma separated ->  one number per line text files

* test updates

* keep raw number range input by using map

* use immutable map

* change tests naming convention

* test for valid migration job instantiations

* use immutable builder

* add class description for factory class

* comment space

* add copyright info

* addition of migration logic and utils class

* addition of tests for migration logic and utils class

* change method names

* use exclusivity check to ensure either file or number is inputted

* update comments and make MigrationJob constructor package private

* minor comment change

* cleanup from merge

* use digitsequence to represent numbers instead of rangespecification

* update exception tests

* refactor intersect methods

* use Auto_Value instead of maps

* minor, tweek print message

* fix null pointer

* add copyright

* change range columns back to private

* regionCode -> countryCode

* add validation to migrations as well as MigrationReport

* fix MigrationJob tests

* updates based on PR comments

* write to file

* updates based on PR comments

* add testing for validation work

* include recipes/metadata in maven and read as input streams

* allow custom recipes from users

* add lenient export flag

* show used recipes after a migration process

* updates based on PR

* ammend printed string

* updates based on PR comments

* javadoc parameter description

* test lenient export

* nit, remove fullstop not consistent with other text

* updates based on PR comments

* change lenientExport to exportInvalidMigrations

* initial file structure

* licensing

* attempt to link migrator package

* newlines added

* create basic UI page

* resolve merge conflict

* perform single number migration

* ammend grammar

* updates based on pr

* sentence including what happens with invalid numbers

* read file from form and output donut chart

* intial work for migration report modals

* add formatting spaces

* display modal with correlating numbers

* updates based on PR

* update conflicting merge

* allow users to download migrated numbers

* change variable nums

* updates based on PR

* remove fullstop bug

* change factory to take in CsvTable instead of file path for custom recipe

* add custom recipe file uploads for migrations

* add comments

* add md file

* updates based on PR comments

* add recipes csv file along with test to ensure all recipe validity

* optimize imports

* updates based on PR

* add links to file bugs

* do not allow migrations for large country ranges in servlet

* updates based upon PR

* add documentation links

* use issue tracker link instead of buganizer

* Commiting metadata zip file to Migrator tool.

* Readme fix

* Moving metadata.zip file to its API and updating READMEs accordingly

* Removing zip file so we add it later when code is ready

* Adding metadata.zip file

Co-authored-by: Tomiwa Oke <toke@google.com>
Co-authored-by: Aravind <penmetsaa@google.com>
Co-authored-by: brittanyroesch <brroesch@gmail.com>

PiperOrigin-RevId: 319856719

Co-authored-by: The libphonenumber Team <noreply@google.com>