feat!: migrate to plugin v2

[scolladon]

Explain Your Changes

---

This Pull Request introduces significant updates as part of the migration to sfdx-git-delta v6. The changes align with Salesforce CLI v2 architecture and modern best practices. Below are the key updates:

• Created a Migration Guide:
  A detailed guide has been written to assist users in migrating to the latest version, outlining key differences and steps for a smooth transition.

• Upgraded to Salesforce Plugin v2 Architecture:
  Migrated the plugin to the sf plugin v2 architecture, benefiting from a more modular and efficient framework, improved performance, and compatibility with the latest CLI innovations.

• Updated file and dir Attribute Naming:
  Changed the file and directory parameters to comply with Salesforce CLI naming conventions.
  See Design Guidelines for Flags.

  • Explanation of Changes: The old parameters are now deprecated, with warnings logged upon usage. Aliases have been created for backward compatibility. The deprecation is set for Winter '26.

• Removed success: true in JSON Output:
  Simplified the JSON response by removing redundant success: true flags. The status attribute now provides sufficient information.

• Deprecated Obsolete outputError Handling:
  Error output has been reworked to follow updated CLI error-handling patterns, ensuring a cleaner and more consistent experience.

• Fixed apiVersion Attribute:
  Corrected an issue with the apiVersion parameter for better accuracy in version handling.

• Refactored JSON Output (--json):
  JSON output has been refactored to merge seamlessly with the new output structure and remove duplication, improving readability and consistency.

• Switched to Module-Type Export:
  The plugin now exports as an ESM module, removing CommonJS support. This change eliminates esmInteroperability issues and aligns with modern JavaScript module standards.

• Updated CI Scripts:
  Continuous Integration (CI) scripts have been updated to use the new sf CLI format to ensure smooth automation and testing processes.

• Updated Contribution Guide:
  The Contributing Guide has been updated to reflect changes to the new structure and tools. New contributors can easily adapt to the latest development workflows and toolbelt.

• Dropped Backward Compatibility with sfdx/cli:
  There is no backward compatibility with sfdx/cli as it is now deprecated. Users must transition to salesforce/cli.

• Migrated Back to npm:
  The plugin now uses npm as the default package manager, streamlining dependency management and build processes.

---

These changes ensure that sfdx-git-delta remains aligned with the latest Salesforce CLI guidelines, offering a more efficient, modern, and user-friendly experience.

Does this close any currently open issues?

---

closes #619 closes #906 closes #415 closes #924 closes #936

[codecov[bot]]

Codecov Report

All modified and coverable lines are covered by tests :white_check_mark:

Project coverage is 100.00%. Comparing base (4cf1a7d) to head (f390f75).

Additional details and impacted files

```diff @@ Coverage Diff @@ ## main #924 +/- ## ========================================= Coverage 100.00% 100.00% ========================================= Files 40 44 +4 Lines 1030 1002 -28 Branches 104 103 -1 ========================================= - Hits 1030 1002 -28 ```

:umbrella: View full report in Codecov by Sentry.
:loudspeaker: Have feedback on the report? Share it here.

[scolladon]

Need to wait for this issue https://github.com/kaelzhang/node-ignore/issues/96 to be fixed

[codeclimate[bot]]

Code Climate has analyzed commit f390f751 and detected 0 issues on this pull request.

View more on Code Climate.

[github-actions[bot]]

Published under dev-924 npm channel.

$ sf plugins install sfdx-git-delta@dev-924