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

The --include-subject flag was introduced to the command oras pull to allow users to recursively pull the subject of artifacts. It is currently marked as Preview.

Rationale for Promotion

Over recent releases, the flag --include-subject has demonstrated:

• Functionality completeness – The feature has been used in the core use cases of recursively pull the subject of artifacts
• 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 --include-subject 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.