What this PR does / why we need it:

This PR proposes tagging and releasing v1.3.0-beta.4 based on commit 582ae37. Approval from at least 4 of the 6 owners listed below is required:

• @sajayantony
• @shizhMSFT
• @SteveLasker
• @qweeah
• @Wwwsylvia
• @TerryHowe

Please approve on the PR or request changes (with reasoning).

Changelog: v1.3.0-beta.3...582ae37

Draft Release Notes

Experimental Features

• Backup and Restore Commands:
  • oras backup: New command to back up artifacts from registries to local OCI layout directories or tar archives, with support for including referrers via the --include-referrers flag
  • oras restore: New command to restore artifacts from local OCI layout directories or tar archives back to registries, with dry-run mode support via the --dry-run flag (shows what would be restored without making changes)
• Format Support for oras repo Commands: Add --format flag support for oras repo ls and oras repo tags commands with text, json, and go-template output options
• Multi-Platform Index Enhancements: Enhanced oras manifest index command with new capabilities:
  • Support for specifying artifactType on the index
  • Automatically include artifactType in child manifest descriptors
• Tag Listing Enhancements for OCI Layouts: Enable --oci-layout-path flag for oras repo tags command to list full-reference-style tags (e.g., example.registry.com/foo:latest) from OCI layouts

Bug Fixes

• Fix Resursively copying a multi-plarform image might fail when the index manifest has no referrer #1728: oras cp now correctly copies root index when the index has no referrers
• Fix oras discover --format json should show an empty referrers list if no referrer found #1715: oras discover --format json now properly shows referrers field when no referrer is found

Other Changes

• Dependencies: Upgrade Go version to 1.24.5, update dependencies to latest versions including oras-go v2.6.0
• Performance: Optimize recursive copy operations for cases with no child referrers
• User Experience: Improve copy error messages to include error source for better troubleshooting
• Code Quality: Multiple lint fixes, code refactoring, and enhanced test coverage
• LoongArch Architecture Support: Add support for loong64 architecture in releases

Detailed Commits

• bump: tag and release ORAS CLI v1.3.0-beta.3 by @Wwwsylvia in bump: tag and release ORAS CLI v1.3.0-beta.3 #1705
• build: use alpine 3.21.3 by @Wwwsylvia in build: use alpine 3.21.3 #1709
• Add test coverage for discover handler by @TerryHowe in Add test coverage for discover handler #1712
• build(deps): bump golang.org/x/sync from 0.13.0 to 0.14.0 by @dependabot[bot] in build(deps): bump golang.org/x/sync from 0.13.0 to 0.14.0 #1720
• build(deps): bump golang.org/x/term from 0.31.0 to 0.32.0 by @dependabot[bot] in build(deps): bump golang.org/x/term from 0.31.0 to 0.32.0 #1721
• fix: packer decode json lint failure by @TerryHowe in fix: packer decode json lint failure #1688
• build(deps): bump oras.land/oras-go/v2 from 2.5.0 to 2.6.0 in /test/e2e by @dependabot[bot] in build(deps): bump oras.land/oras-go/v2 from 2.5.0 to 2.6.0 in /test/e2e #1724
• build(deps): bump oras.land/oras-go/v2 from 2.5.1-0.20250417082913-f7a6126986d9 to 2.6.0 by @dependabot[bot] in build(deps): bump oras.land/oras-go/v2 from 2.5.1-0.20250417082913-f7a6126986d9 to 2.6.0 #1725
• fix: discover handler errors for lint by @TerryHowe in fix: discover handler errors for lint #1677
• fix: calls to close in tests unchecked for lint by @TerryHowe in fix: calls to close in tests unchecked for lint #1678
• refactor: move different targets to different files by @TerryHowe in refactor: move different targets to different files #1722
• fix: Change receiver name for Remote by @TerryHowe in fix: Change receiver name for Remote #1727
• refactor(perf): optimize cases with no child referrers in recursiveCopy by @qweeah in refactor(perf): optimize cases with no child referrers in recursiveCopy #1729
• fix: lint explicitly ignore various close errors by @TerryHowe in fix: lint explicitly ignore various close errors #1684
• fix: rename interfaces file by @TerryHowe in fix: rename interfaces file #1730
• refactor: rename Target AnnotatedReference method by @TerryHowe in refactor: rename Target AnnotatedReference method #1726
• fix(docs): remove a discover example with -v by @Wwwsylvia in fix(docs): remove a discover example with -v #1742
• fix(lint): ignore returns from test defer calls by @TerryHowe in fix(lint): ignore returns from test defer calls #1734
• fix: discover json format should show referrers field when no referrer is found by @wangxiaoxuan273 in fix: discover json format should show referrers field when no referrer is found #1731
• build(deps): bump github.com/containerd/console from 1.0.4 to 1.0.5 by @dependabot[bot] in build(deps): bump github.com/containerd/console from 1.0.4 to 1.0.5 #1743
• fix: replace slave var for child by @TerryHowe in fix: replace slave var for child #1736
• fix: rename slave to child for cp test by @TerryHowe in fix: rename slave to child for cp test #1738
• docs(spec): artifactType in multi-platform index manifests by @apparentlymart in docs(spec): artifactType in multi-platform index manifests #1696
• docs: add examples for oci-layout-path by @wangxiaoxuan273 in docs: add examples for oci-layout-path #1746
• build(deps): bump golang.org/x/sync from 0.14.0 to 0.15.0 by @dependabot[bot] in build(deps): bump golang.org/x/sync from 0.14.0 to 0.15.0 #1750
• feat: oras manifest index: artifactType for index and child manifest descriptors by @apparentlymart in feat: oras manifest index: artifactType for index and child manifest descriptors #1700
• feat: support --format for oras repo tags by @Wwwsylvia in feat: support --format for oras repo tags #1756
• fix: resolve golangci-lint issues with unchecked error returns and embedded field access by @copilot in fix: resolve golangci-lint issues with unchecked error returns and embedded field access #1755
• build(deps): bump golangci/golangci-lint-action from 6 to 8 by @dependabot[bot] in build(deps): bump golangci/golangci-lint-action from 6 to 8 #1717
• ci: add dependabot support for Dockerfile by @tanyabhatnagar in ci: add dependabot support for Dockerfile #1761
• build(deps): bump library/golang from 1.24.2-alpine to 1.24.4-alpine by @dependabot[bot] in build(deps): bump library/golang from 1.24.2-alpine to 1.24.4-alpine #1764
• build(deps): bump library/alpine from 3.21.3 to 3.22.0 by @dependabot[bot] in build(deps): bump library/alpine from 3.21.3 to 3.22.0 #1765
• docs: backup and restore specification by @TerryHowe in docs: backup and restore specification #1610
• docs(spec): define output formats for oras repo commands by @Wwwsylvia in docs(spec): define output formats for oras repo commands #1763
• feat: support --format for oras repo ls by @Wwwsylvia in feat: support --format for oras repo ls #1758
• fix(tests): fix packer test that failed on Windows by @Wwwsylvia in fix(tests): fix packer test that failed on Windows #1774
• docs: backup and restore to single OCI layout by @TerryHowe in docs: backup and restore to single OCI layout #1775
• test: exclude incompatible test Go OSes by @TerryHowe in test: exclude incompatible test Go OSes #1779
• refactor: ApplyFlags with prefix for Remote and Target by @TerryHowe in refactor: ApplyFlags with prefix for Remote and Target #1733
• build(deps): bump golang.org/x/sync from 0.15.0 to 0.16.0 by @dependabot[bot] in build(deps): bump golang.org/x/sync from 0.15.0 to 0.16.0 #1781
• build(deps): bump golang.org/x/term from 0.32.0 to 0.33.0 by @dependabot[bot] in build(deps): bump golang.org/x/term from 0.32.0 to 0.33.0 #1780
• feat: show repo tags with --oci-layout-path in repo tags command by @wangxiaoxuan273 in feat: show repo tags with --oci-layout-path in repo tags command #1759
• chore(ux): improve copy error message by @Wwwsylvia in chore(ux): improve copy error message #1773
• build(deps): bump library/golang from 1.24.4-alpine to 1.24.5-alpine by @dependabot[bot] in build(deps): bump library/golang from 1.24.4-alpine to 1.24.5-alpine #1782
• fix: oras cp should copy root index when the index has no referrers by @wangxiaoxuan273 in fix: oras cp should copy root index when the index has no referrers #1749
• build(deps): bump github.com/spf13/pflag from 1.0.6 to 1.0.7 by @dependabot[bot] in build(deps): bump github.com/spf13/pflag from 1.0.6 to 1.0.7 #1785
• build(deps): bump library/alpine from 3.22.0 to 3.22.1 by @dependabot[bot] in build(deps): bump library/alpine from 3.22.0 to 3.22.1 #1786
• build: release loong64 by @amazingfate in build: release loong64 #1787
• docs: add scenario doc for Backup and Restore of OCI Artifacts and Images by @FeynmanZhou in docs: add scenario doc for Backup and Restore of OCI Artifacts and Images #1778
• docs: enrich the CLI design of oras backup and oras restore by @FeynmanZhou in docs: enrich the CLI design of oras backup and oras restore #1767
• feat: oras backup to backup artifacts to a directory or a tar by @Wwwsylvia in feat: oras backup to backup artifacts to a directory or a tar #1790
• build(deps): bump github.com/onsi/gomega from 1.37.0 to 1.38.0 in /test/e2e by @dependabot[bot] in build(deps): bump github.com/onsi/gomega from 1.37.0 to 1.38.0 in /test/e2e #1789
• feat: add oras restore command by @Wwwsylvia in feat: add oras restore command #1792
• build(go): upgrade go version and dependencies by @Wwwsylvia in build(go): upgrade go version and dependencies #1796

New Contributors

• @apparentlymart made their first contribution in docs(spec): artifactType in multi-platform index manifests #1696
• @copilot made their first contribution in fix: resolve golangci-lint issues with unchecked error returns and embedded field access #1755
• @tanyabhatnagar made their first contribution in ci: add dependabot support for Dockerfile #1761
• @amazingfate made their first contribution in build: release loong64 #1787

Full Changelog: v1.3.0-beta.3...v1.3.0-beta.4