Promote "--recursive" from Preview to Stable

[FeynmanZhou]

This issue is related to the proposal of promoting maturity of experimental and preview feature commands and flags #1771

The --recursive flag was introduced to the command oras copy to allow users to recursively copy the artifact and its referrer artifacts. It is currently marked as Preview.

Rationale for Promotion

Over recent releases, the flag --recursive has demonstrated:

• Functionality completeness – The feature has been used in the core use cases of specifying certain platform of the image
• Stability – syntax and output structure have remained consistent over multiple releases.
• Low maintenance overhead – No major breaking changes or regressions reported in recent cycles.

Given its maturity and stability, promoting --recursive to Stable will encourage broader adoption while signaling to users that the feature is nearing full stabilization.

Next Steps

• Update the feature mark from Preview to Stable in CLI documentation and help text.
• Communicate the change in release notes for ORAS v1.3.0.

If you agree with this proposal, please vote on this issue with your comments. Thanks

[shizhMSFT]

I still want to hold this --recursive flag as the multi-arch scenarios are not stable yet. Also, should we re-consider changing the flag name? like --include-referrers? We can still keep the shorthand -r anyway.

[Wwwsylvia]

should we re-consider changing the flag name? like --include-referrers?

Is it considered as a breaking change?

[shizhMSFT]

Is it considered as a breaking change?

Yes, it is breaking but it is OK since it is Preview.