Summary

This PR adds support for the --subscription and --excluded-assets arguments to darc vmr forwardflow and darc vmr backflow operations, allowing users to simulate subscription behavior for VMR code flow operations. This brings consistency with the existing darc update-dependencies --subscription functionality.

Problem

Previously, when running VMR codeflow operations, there was no way to simulate how a subscription would behave. Additionally, excluded assets from subscriptions were not being utilized (left as empty arrays), as indicated by TODO comments in the code referencing issue #5313.

Solution

Added subscription support to the codeflow operations by:

1. Adding --subscription option to CodeFlowCommandLineOptions (shared by both forwardflow and backflow)
2. Adding --excluded-assets option to CodeFlowCommandLineOptions that can be used standalone or to override subscription's excluded assets
3. Implementing subscription metadata fetching in CodeFlowOperation base class that:
   • Validates the subscription ID and ensures it's source-enabled (VMR codeflow)
   • Fetches subscription metadata from the Build Asset Registry (BAR)
   • Extracts excluded assets from the subscription and stores them in _options.ExcludedAssets (can be overridden by command-line argument)
   • Determines the latest build from the subscription's source repository and channel (or uses a specific build if --build is provided)
   • Sets the build ID automatically for the codeflow operation
4. Storing excluded assets in options instead of passing them as method parameters, following the same pattern as other options like --build
5. Adding comprehensive validation to prevent conflicting options (only --subscription with --ref is prevented; --build and --excluded-assets can be used with --subscription)

Usage

# Forward flow using a subscription (uses latest build and subscription's excluded assets)
darc vmr forwardflow --subscription 12345678-1234-1234-1234-123456789abc /path/to/vmr

# Backflow using a subscription with a specific build
darc vmr backflow --subscription 12345678-1234-1234-1234-123456789abc --build 12345 /path/to/repo

# Forward flow with custom excluded assets (overrides subscription's excluded assets)
darc vmr forwardflow --subscription 12345678-1234-1234-1234-123456789abc --excluded-assets "System.Text.*;Newtonsoft.*" /path/to/vmr

# Forward flow with excluded assets only (no subscription)
darc vmr forwardflow --excluded-assets "System.Text.*;Newtonsoft.*" /path/to/vmr

When --subscription is provided, the tool automatically:

• Fetches subscription metadata from BAR
• Uses the latest build from the subscription's channel (unless --build is specified)
• Applies the subscription's excluded assets during the flow (unless --excluded-assets is specified)
• Logs subscription details for visibility

Benefits

• Easier Testing: Users can test subscription behavior without triggering actual subscription runs
• Better Debugging: Simplifies debugging subscription issues by allowing manual reproduction
• Flexible Build Selection: Allows combining --subscription with --build to use a specific build with the subscription's excluded assets
• Flexible Asset Exclusion: Allows combining --subscription with --excluded-assets to override subscription settings, or use --excluded-assets independently
• Proper Asset Exclusion: Subscription excluded assets are now properly utilized instead of being ignored
• Consistency: Provides consistent behavior with darc update-dependencies --subscription, where options can be overridden via command-line arguments

Changes

• Modified 4 files
• All existing tests pass (117 passed, 1 skipped)
• No breaking changes

Fixes #5313

Fixes #5388

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.