Add seed tools.

[goodov]

This PR adds seed_tools CLI tool to support seed manipulation stored in per-file format.

Related: brave/brave-browser#33654

[atuchin-m]

Could we pass a param isBrave: boolean = true to make the tools work for Finch seed?

[goodov]

added Options.isChromium to disable the channel modification if set to true.

[atuchin-m]

BTW, does execa have advantages over child_process for our usage?

[goodov]

yes, execa is capable of launching scripts from node_modules (with preferLocal: true) the same way as npx <...> works. This way we don't need to create a custom path like node_modules/bin/... manually.

[goodov]

@atuchin-m @iefremov ptal

[github-actions]

[puLL-Merge] - brave/brave-variations@1026

Description

This PR introduces significant changes to the Brave Variations project, including new tools for managing and validating study files, improved seed generation, and various utility functions. The changes aim to enhance the robustness and functionality of the variations system, particularly in handling study files and generating seed data.

Possible Issues

1. The new seed generation process may produce slightly different output compared to the previous system, which could potentially affect existing studies or experiments.
2. The stricter validation rules might flag issues in existing study files that were previously overlooked.

Security Hotspots

1. The parseStudyArray function in study_json_utils.ts parses JSON input, which could be a potential vector for injection attacks if not properly sanitized.
2. The generateSerialNumber function in create_seed.ts uses MD5 for hashing, which is considered cryptographically weak. While not directly a security risk in this context, using a stronger hash function would be advisable.

Changes

Changes

1. .gitattributes:

   • Added new file to enforce LF line endings and mark binary files.

2. .prettierignore:

   • Added ignore rule for unformatted test data files.

3. package.json:

   • Updated build scripts and dependencies.
   • Added new seed_tools script.

4. seed/serialize.py:

   • Added support for mocking serial numbers.

5. src/base/:

   • Added new utility classes and functions, including DefaultMap, path utilities, and a Result type.

6. src/jest.config.js:

   • Updated configuration to support absolute imports from src/.

7. src/proto/:

   • Added README explaining the use of protobuf-ts and handling of required fields.
   • Added patch file for study.proto to work with protobuf-ts.

8. src/scripts/:

   • Updated existing scripts and added new ones for generating Protobuf TS files.

9. src/seed_tools/:

   • Added new directory with various tools for seed and study management, including:
     • Commands for checking studies, creating seeds, comparing seeds, and splitting seed JSON.
     • Utility functions for study validation, version comparison, and JSON handling.

10. src/test/data/:

    • Added test data for invalid and valid seeds and studies.

These changes significantly enhance the project's capabilities in managing and validating study files, generating seeds, and overall improving the robustness of the variations system.